SpyBara
Go Premium

troubleshoot-install.md 2026-06-09 06:34 UTC to 2026-06-10 23:57 UTC

123 added, 43 removed.

2026
Tue 30 23:02 Mon 29 23:02 Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

Устранение неполадок при установке и входе

Исправьте ошибки command not found, PATH, разрешений, сети и аутентификации при установке или входе в Claude Code.

Если установка не удалась или вы не можете войти, найдите вашу ошибку ниже. Для проблем во время выполнения после того, как Claude Code работает, см. Troubleshooting. Для проблем конфигурации, таких как неприменение параметров или неработающие hooks, см. Debug your configuration.

Найдите вашу ошибку

Сопоставьте сообщение об ошибке или симптом, который вы видите, с исправлением:

Что вы видите Решение
command not found: claude или 'claude' is not recognized Исправьте ваш PATH
syntax error near unexpected token '<' Install script returns HTML
curl: (22) The requested URL returned error: 403 Install script returned 403
curl: (23) или curl: (56) Failure writing output to destination Проверьте подключение или используйте альтернативный установщик
Killed во время установки на Linux Добавьте пространство подкачки для серверов с низкой памятью
TLS connect error или SSL/TLS secure channel Обновите сертификаты CA
Failed to fetch version или невозможно достичь сервера загрузки Проверьте параметры сети и прокси
irm is not recognized или && is not valid Используйте правильную команду для вашей оболочки
'bash' is not recognized as the name of a cmdlet Используйте команду установщика Windows
Claude Code on Windows requires either Git for Windows (for bash) or PowerShell Установите оболочку
Claude Code does not support 32-bit Windows Откройте Windows PowerShell, а не запись x86
The process cannot access the file ... because it is being used by another process Очистите папку загрузок и повторите попытку
Error loading shared library Неправильный вариант двоичного файла для вашей системы
Illegal instruction Несоответствие архитектуры или набора инструкций процессора
cannot execute binary file: Exec format error в WSL WSL1 native-binary regression
Установщик PowerShell завершается, но claude не найден или показывает старую версию Перезагрузите терминал и проверьте PATH
dyld: cannot load, dyld: Symbol not found или Abort trap на macOS Несовместимость двоичного файла
Invoke-Expression: Missing argument in parameter list Install script returns HTML
App unavailable in region Claude Code недоступен в вашей стране. См. поддерживаемые страны.
unable to get local issuer certificate Настройте корпоративные сертификаты CA
OAuth error или 403 Forbidden Исправьте аутентификацию
Could not load the default credentials или Could not load credentials from any providers Bedrock, Vertex или Foundry credentials
ChainedTokenCredential authentication failed или CredentialUnavailableError Bedrock, Vertex или Foundry credentials
API Error: 500, 529 Overloaded, 429 или другие ошибки 4xx и 5xx, не указанные выше См. справочник ошибок

Если вашей проблемы нет в списке, выполните диагностические проверки ниже, чтобы сузить причину.

Запустите диагностические проверки

Проверьте подключение к сети

Установщик загружает с downloads.claude.ai. Убедитесь, что вы можете его достичь:

curl -sI https://downloads.claude.ai/claude-code-releases/latest

Строка HTTP/2 200 означает, что вы достигли сервера. Если вы видите отсутствие вывода, Could not resolve host или timeout соединения, ваша сеть блокирует соединение. Распространённые причины:

  • Корпоративные брандмауэры или прокси, блокирующие downloads.claude.ai
  • Региональные ограничения сети: попробуйте VPN или альтернативную сеть
  • Проблемы TLS/SSL: обновите сертификаты CA вашей системы или проверьте, настроен ли HTTPS_PROXY

Если вы находитесь за корпоративным прокси, установите HTTPS_PROXY и HTTP_PROXY на адрес вашего прокси перед установкой. Попросите URL прокси у вашей IT-команды, если вы его не знаете, или проверьте параметры прокси вашего браузера.

Этот пример устанавливает обе переменные прокси, а затем запускает установщик через ваш прокси:

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

Проверьте ваш PATH

Если установка прошла успешно, но вы получаете ошибку command not found или not recognized при запуске claude, директория установки не находится в вашем PATH. Ваша оболочка ищет программы в директориях, указанных в PATH, и установщик размещает claude в ~/.local/bin/claude на macOS/Linux или %USERPROFILE%\.local\bin\claude.exe на Windows.

Проверьте, находится ли директория установки в вашем PATH, перечислив записи PATH и фильтруя по local/bin:

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

Если это выводит /Users/you/.local/bin или /home/you/.local/bin, директория находится в вашем PATH и вы можете перейти к Проверьте наличие конфликтующих установок. Если вывода нет, добавьте её в конфигурацию вашей оболочки.

Для Zsh, по умолчанию на macOS:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Для Bash, по умолчанию на большинстве дистрибутивов Linux:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Или закройте и снова откройте ваш терминал.

Для других оболочек, таких как fish или Nushell, добавьте ~/.local/bin в ваш PATH, используя синтаксис конфигурации вашей оболочки, а затем перезагрузите ваш терминал.

Проверьте, что исправление сработало:

claude --version

Проверьте наличие конфликтующих установок

Несколько установок Claude Code могут вызвать несоответствия версий или неожиданное поведение. Проверьте, что установлено:

Перечислите все бинарные файлы claude, найденные в вашем PATH:

which -a claude

Если это ничего не выводит, claude ещё не находится в вашем PATH. Вернитесь к Проверьте ваш PATH.

Проверьте три места, откуда может поступить бинарный файл claude. ~/.local/bin/claude — это встроенный установщик, ~/.claude/local/ — это устаревшая локальная установка npm, созданная старыми версиями Claude Code, и список глобального npm показывает установку -g:

ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

npm -g ls @anthropic-ai/claude-code 2>/dev/null

Если вы найдёте несколько установок, оставьте только одну. Встроенная установка в ~/.local/bin/claude на macOS/Linux или %USERPROFILE%\.local\bin\claude.exe на Windows рекомендуется. Удалите лишние:

Удалите глобальную установку npm:

npm uninstall -g @anthropic-ai/claude-code

Удалите устаревшую локальную установку npm:

rm -rf ~/.claude/local

На Windows используйте PowerShell:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local"

Удалите установку Homebrew на macOS. Если вы установили кэш claude-code@latest, замените это имя:

brew uninstall --cask claude-code

Удалите установку WinGet на Windows:

winget uninstall Anthropic.ClaudeCode

Проверьте разрешения директорий

Установщику нужен доступ на запись в ~/.local/bin/ и ~/.claude/ на macOS и Linux. На Windows место установки находится под %USERPROFILE%, которое по умолчанию доступно для записи вашим пользователем, поэтому этот раздел редко применяется там.

Проверьте, доступны ли директории для записи:

test -w ~/.local/bin && echo "writable" || echo "not writable"
test -w ~/.claude && echo "writable" || echo "not writable"

Если какая-либо директория недоступна для записи, создайте директорию установки и установите вашего пользователя в качестве владельца:

sudo mkdir -p ~/.local/bin
sudo chown -R $(whoami) ~/.local

Проверьте, работает ли бинарный файл

Если claude --version выводит версию, но claude падает или зависает при запуске, запустите эти проверки, чтобы сузить причину. Если claude --version говорит command not found, сначала перейдите к Проверьте ваш PATH; команды ниже предполагают, что claude находится в вашем PATH.

Подтвердите, что бинарный файл существует и исполняемый:

ls -la "$(command -v claude)"

На Windows используйте PowerShell:

Get-Command claude | Select-Object Source

На Linux проверьте отсутствующие общие библиотеки. Если ldd показывает отсутствующие библиотеки, вам может потребоваться установить системные пакеты. На Alpine Linux и других дистрибутивах на основе musl см. Alpine Linux setup.

ldd "$(command -v claude)" | grep "not found"

Подтвердите, что бинарный файл может выполняться:

claude --version

Распространённые проблемы установки

Это наиболее часто встречающиеся проблемы установки и их решения.

Install script returns HTML instead of a shell script

При запуске команды установки вы можете увидеть одну из этих ошибок:

bash: line 1: syntax error near unexpected token `<'
bash: line 1: `<!DOCTYPE html>'

На PowerShell та же проблема выглядит как:

Invoke-Expression: Missing argument in parameter list.

В зависимости от того, как был маршрутизирован запрос, вы можете вместо этого увидеть 403 без HTML-тела:

curl: (22) The requested URL returned error: 403

Всё это означает, что URL установки вернул HTML-страницу или статус ошибки вместо скрипта установки. Если HTML-страница говорит "App unavailable in region", Claude Code недоступен в вашей стране. См. supported countries.

Простой 403 без тела часто имеет ту же причину, но это также может быть вызвано корпоративным прокси или брандмауэром, блокирующим загрузку. Если вы находитесь в поддерживаемой стране и всё ещё видите 403, пройдите через Check network connectivity перед попыткой альтернативных установщиков ниже, так как они достигают тех же хостов.

В противном случае это может произойти из-за проблем с сетью, региональной маршрутизации или временного сбоя сервиса.

Решения:

  1. Используйте альтернативный метод установки:

    На macOS установите через Homebrew:

    brew install --cask claude-code

    На Windows установите через WinGet:

    winget install Anthropic.ClaudeCode

  2. Повторите попытку через несколько минут: проблема часто временная. Подождите и попробуйте исходную команду снова.

`command not found: claude` after installation

Установка завершилась, но claude не работает. Точная ошибка варьируется в зависимости от платформы:

Платформа Сообщение об ошибке
macOS zsh: command not found: claude
Linux bash: claude: command not found
Windows CMD 'claude' is not recognized as an internal or external command
PowerShell claude : The term 'claude' is not recognized as the name of a cmdlet

Это означает, что директория установки не находится в пути поиска вашей оболочки. См. Verify your PATH для исправления на каждой платформе.

`curl: (56) Failure writing output to destination`

Команда curl ... | bash загружает скрипт и передаёт его в Bash для выполнения. Эта ошибка и связанная с ней curl: (23) Failure writing output to destination означают, что Bash не получил полный скрипт. Код выхода 56 указывает, что сама загрузка была прервана, а код выхода 23 указывает, что curl не смог записать полученное в канал, обычно потому что Bash завершился рано.

Решения:

  1. Проверьте стабильность сети: бинарные файлы Claude Code размещены на downloads.claude.ai. Проверьте, что вы можете его достичь:

    curl -sI https://downloads.claude.ai/claude-code-releases/latest

    Строка HTTP/2 200 означает, что вы достигли сервера и исходный сбой был вероятно временным; повторите команду установки. Если вы видите Could not resolve host или timeout соединения, ваша сеть блокирует загрузку.

  2. Попробуйте альтернативный метод установки:

    На macOS:

    brew install --cask claude-code

    На Windows:

    winget install Anthropic.ClaudeCode

TLS or SSL connection errors

Ошибки вроде curl: (35) TLS connect error, schannel: next InitializeSecurityContext failed или PowerShell's Could not establish trust relationship for the SSL/TLS secure channel указывают на сбои TLS handshake.

Решения:

  1. Обновите сертификаты CA вашей системы:

    На Ubuntu/Debian:

    sudo apt-get update && sudo apt-get install ca-certificates

    На macOS системный curl использует хранилище доверия Keychain; обновление самого macOS обновляет корневые сертификаты.

  2. На Windows включите TLS 1.2 в PowerShell перед запуском установщика:

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

  3. Проверьте помехи прокси или брандмауэра: корпоративные прокси, выполняющие TLS inspection, могут вызвать эти ошибки, включая unable to get local issuer certificate и SELF_SIGNED_CERT_IN_CHAIN. Для шага установки укажите curl на ваш корпоративный пакет CA с --cacert:

    curl --cacert /path/to/corporate-ca.pem -fsSL https://claude.ai/install.sh | bash

    Для самого Claude Code после установки установите NODE_EXTRA_CA_CERTS так, чтобы запросы API доверяли тому же пакету:

    export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem

    Попросите файл сертификата у вашей IT-команды, если у вас его нет. Вы также можете попробовать на прямом соединении, чтобы подтвердить, что прокси является причиной.

  4. На Windows обойдите проверки отзыва сертификатов, если вы видите CRYPT_E_NO_REVOCATION_CHECK (0x80092012) или CRYPT_E_REVOCATION_OFFLINE (0x80092013). Они означают, что curl достиг сервера, но ваша сеть блокирует поиск отзыва сертификата, что распространено за корпоративными брандмауэрами. Добавьте --ssl-revoke-best-effort к команде установки:

    curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

    Или установите с winget install Anthropic.ClaudeCode, что полностью избегает curl.

`Failed to fetch version from downloads.claude.ai`

Установщик не смог достичь сервера загрузки. Это обычно означает, что downloads.claude.ai заблокирован в вашей сети.

Решения:

  1. Проверьте подключение напрямую:

    curl -sI https://downloads.claude.ai/claude-code-releases/latest

  2. Если за прокси, установите HTTPS_PROXY так, чтобы установщик мог маршрутизировать через него. См. proxy configuration для деталей.

    export HTTPS_PROXY=http://proxy.example.com:8080
curl -fsSL https://claude.ai/install.sh | bash

  3. Если в ограниченной сети, попробуйте другую сеть или VPN, или используйте альтернативный метод установки:

    На macOS:

    brew install --cask claude-code

    На Windows:

    winget install Anthropic.ClaudeCode

Wrong install command on Windows

Если вы видите 'irm' is not recognized, The token '&&' is not valid или 'bash' is not recognized as the name of a cmdlet, вы скопировали команду установки для другой оболочки или операционной системы.

  • irm не распознан: вы находитесь в CMD, а не PowerShell. У вас есть два варианта:

    Откройте PowerShell, поиск "PowerShell" в меню Start, затем запустите исходную команду установки:

    irm https://claude.ai/install.ps1 | iex

    Или оставайтесь в CMD и используйте вместо этого установщик CMD:

    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

  • && не действителен: вы находитесь в PowerShell, но запустили команду установщика CMD. Используйте установщик PowerShell:

    irm https://claude.ai/install.ps1 | iex

  • bash не распознан: вы запустили установщик macOS/Linux на Windows. Используйте вместо этого установщик PowerShell:

    irm https://claude.ai/install.ps1 | iex

`The process cannot access the file` during Windows install

Если установщик PowerShell не удаётся с Failed to download binary: The process cannot access the file ... because it is being used by another process, установщик не смог записать в %USERPROFILE%\.claude\downloads. Это обычно означает, что предыдущая попытка установки всё ещё работает, или антивирусное программное обеспечение сканирует частично загруженный бинарный файл в этой папке.

Закройте любые другие окна PowerShell, запускающие установщик, и дождитесь завершения сканирования антивирусом. Затем удалите папку загрузок и запустите установщик снова:

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

Install killed on low-memory Linux servers

Если вы видите Killed во время установки на VPS или облачном экземпляре:

Setting up Claude Code...
Installing Claude Code native build latest...
bash: line 142: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}

Убийца OOM Linux завершил процесс, потому что система исчерпала память. Claude Code требует по крайней мере 4 ГБ доступной оперативной памяти.

Решения:

  1. Добавьте пространство подкачки, если ваш сервер имеет ограниченную оперативную память. Подкачка использует дисковое пространство как переполнение памяти, позволяя установке завершиться даже при низкой физической оперативной памяти.

    Создайте файл подкачки размером 2 ГБ и включите его:

    sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

    Затем повторите установку:

    curl -fsSL https://claude.ai/install.sh | bash

  2. Закройте другие процессы, чтобы освободить память перед установкой.

  3. Используйте больший экземпляр, если возможно. Claude Code требует по крайней мере 4 ГБ оперативной памяти.

Install hangs in Docker

При установке Claude Code в контейнер Docker установка от root в / может вызвать зависания.

Решения:

  1. Установите рабочую директорию перед запуском установщика. При запуске из / установщик сканирует всю файловую систему, что вызывает чрезмерное использование памяти. Установка WORKDIR ограничивает сканирование небольшой директорией:

    WORKDIR /tmp
RUN curl -fsSL https://claude.ai/install.sh | bash

  2. Увеличьте лимиты памяти Docker, если используете Docker Desktop:

    docker build --memory=4g .

Claude Desktop overrides the `claude` command on Windows

Если вы установили старую версию Claude Desktop, она может зарегистрировать Claude.exe в директории WindowsApps, которая имеет приоритет PATH над Claude Code CLI. Запуск claude открывает приложение Desktop вместо CLI.

Обновите Claude Desktop до последней версии, чтобы исправить эту проблему.

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

Git for Windows является опциональным. Claude Code использует PowerShell tool при отсутствии Git Bash, поэтому эта ошибка означает, что ни одна оболочка не была найдена.

Если PowerShell отсутствует в вашем PATH, его местоположение по умолчанию — C:\Windows\System32\WindowsPowerShell\v1.0\. Добавьте эту директорию в ваш PATH, или установите PowerShell 7, который предоставляет pwsh.

Чтобы вместо этого установить Git for Windows, загрузите его с git-scm.com/downloads/win. Во время установки выберите "Add to PATH." Перезагрузите ваш терминал после установки. Установка его включает инструмент Bash, полезный при работе со скриптами и инструментами на основе Bash.

Если Git уже установлен, но Claude Code не может его найти, установите путь в вашем settings.json file:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Если ваш Git установлен где-то ещё, найдите путь, запустив where.exe git в PowerShell и используйте путь bin\bash.exe из этой директории.

Claude Code does not support 32-bit Windows

Windows включает две записи PowerShell в меню Start: Windows PowerShell и Windows PowerShell (x86). Запись x86 запускается как 32-битный процесс и вызывает эту ошибку даже на 64-битной машине. Чтобы проверить, в каком случае вы находитесь, запустите это в том же окне, которое произвело ошибку:

[Environment]::Is64BitOperatingSystem

Если это выводит True, ваша операционная система в порядке. Закройте окно, откройте Windows PowerShell без суффикса x86 и запустите команду установки снова.

Если это выводит False, вы находитесь на 32-битном издании Windows. Claude Code требует 64-битную операционную систему. См. system requirements.

Linux musl or glibc binary mismatch

Если вы видите ошибки об отсутствующих общих библиотеках вроде libstdc++.so.6 или libgcc_s.so.1 после установки, установщик мог загрузить неправильный вариант бинарного файла для вашей системы.

Error loading shared library libstdc++.so.6: No such file or directory

Это может произойти на системах на основе glibc, которые имеют установленные пакеты кросс-компиляции musl, вызывая установщик неправильно определить систему как musl.

Решения:

  1. Проверьте, какой libc использует ваша система:

    ldd --version 2>&1 | head -1

    Вывод, упоминающий GNU libc или GLIBC, означает glibc. Вывод, упоминающий musl, означает musl.

  2. Если вы на glibc, но получили бинарный файл musl, удалите установку и переустановите. Вы также можете вручную загрузить правильный бинарный файл, используя манифест в https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json. Подайте GitHub issue с выводом ldd --version и ls /lib/libc.musl*.

  3. Если вы действительно на musl, такой как Alpine Linux, установите требуемые пакеты:

    apk add libgcc libstdc++ ripgrep

`Illegal instruction`

Если запуск claude или установщика выводит Illegal instruction, встроенный бинарный файл использует инструкции CPU, которые ваш процессор не поддерживает. Есть две отдельные причины.

Несоответствие архитектуры. Установщик загрузил неправильный бинарный файл, например x86 на ARM-сервере. Проверьте с uname -m на macOS или Linux, или $env:PROCESSOR_ARCHITECTURE в PowerShell. Если результат не совпадает с полученным вами бинарным файлом, подайте GitHub issue с выводом.

Отсутствующий набор инструкций AVX. Если ваша архитектура правильная, но вы всё ещё видите Illegal instruction, ваш CPU вероятно не имеет AVX или другой инструкции, которую требует бинарный файл. Это влияет примерно на процессоры Intel и AMD до 2013 года, и виртуальные машины, где гипервизор не передаёт AVX гостю.

На VPS или VM запустите grep -m1 -ow avx /proc/cpuinfo; пустой результат означает, что AVX недоступен гостю.

Встроенного обходного пути нет; отслеживайте issue #50384 для статуса и включайте модель вашего CPU из grep -m1 "model name" /proc/cpuinfo на Linux или sysctl -n machdep.cpu.brand_string на macOS при сообщении.

Альтернативные методы установки загружают тот же встроенный бинарный файл и не разрешат ни одну из причин.

`dyld: cannot load` on macOS

Если вы видите dyld: cannot load, dyld: Symbol not found или Abort trap: 6 во время установки, бинарный файл несовместим с вашей версией macOS или оборудованием.

dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)
Abort trap: 6

Ошибка Symbol not found, которая ссылается на libicucore, также указывает, что ваша версия macOS старше, чем поддерживает бинарный файл:

dyld: Symbol not found: _ubrk_clone
  Referenced from: claude-darwin-x64 (which was built for Mac OS X 13.0)
  Expected in: /usr/lib/libicucore.A.dylib

Решения:

  1. Проверьте вашу версию macOS: Claude Code требует macOS 13.0 или позже. Откройте меню Apple и выберите About This Mac, чтобы проверить вашу версию.

  2. Обновите macOS, если вы на старой версии. Бинарный файл использует команды загрузки и системные библиотеки, которые старые версии macOS не поддерживают. Альтернативные методы установки, такие как Homebrew, загружают тот же бинарный файл и не разрешат эту ошибку.

`Exec format error` on WSL1

Если запуск claude в WSL выводит cannot execute binary file: Exec format error, вы находитесь на WSL1 и попадаете в известную регрессию встроенного бинарного файла, отслеживаемую в issue #38788. Заголовки программы бинарного файла изменились таким образом, что загрузчик WSL1 не может обработать.

Самое чистое исправление — преобразовать ваш дистрибутив в WSL2 из PowerShell:

wsl --set-version <DistroName> 2

Если вам нужно оставаться на WSL1, вызовите бинарный файл через динамический компоновщик. Добавьте эту функцию в ~/.bashrc внутри WSL, заменив путь, если ваша домашняя директория отличается:

claude() {
  /lib64/ld-linux-x86-64.so.2 "$(readlink -f "$HOME/.local/bin/claude")" "$@"
}

Затем запустите source ~/.bashrc и повторите claude.

npm install errors in WSL

Эти проблемы применяются, если вы установили Claude Code с npm install -g внутри WSL. Если вы использовали native installer, пропустите этот раздел.

Проблемы обнаружения ОС или платформы. Если npm сообщает о несоответствии платформы во время установки, WSL вероятно выбирает Windows npm. Сначала запустите npm config set os linux, затем установите с npm install -g @anthropic-ai/claude-code --force. Не используйте sudo.

exec: node: not found при запуске claude. Ваша среда WSL вероятно использует установку Node.js для Windows. Подтвердите с which npm и which node: пути, начинающиеся с /mnt/c/, — это бинарные файлы Windows, в то время как пути Linux начинаются с /usr/. Чтобы исправить это, установите Node через менеджер пакетов вашего дистрибутива Linux или через nvm.

Конфликты версий nvm. Если у вас установлен nvm как в WSL, так и в Windows, переключение версий Node в WSL может сломаться, потому что WSL импортирует Windows PATH по умолчанию и Windows nvm имеет приоритет. Наиболее распространённая причина — что nvm не загружен в вашу оболочку. Добавьте загрузчик nvm в ~/.bashrc или ~/.zshrc:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

Или загрузите его в вашу текущую сессию:

source ~/.nvm/nvm.sh

Если nvm загружен, но пути Windows всё ещё имеют приоритет, явно добавьте ваш путь Linux Node:

export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

Permission errors during installation

Если встроенный установщик не удаётся с ошибками разрешений, целевая директория может быть недоступна для записи. См. Check directory permissions.

Если вы ранее установили с npm и получаете ошибки разрешений, специфичные для npm, переключитесь на встроенный установщик:

curl -fsSL https://claude.ai/install.sh | bash

Native binary not found after npm install

Пакет npm @anthropic-ai/claude-code получает встроенный бинарный файл через зависимость, специфичную для платформы, такую как @anthropic-ai/claude-code-darwin-arm64. Если запуск claude после установки выводит Could not find native binary package "@anthropic-ai/claude-code-<platform>", проверьте следующие причины:

  • Опциональные зависимости отключены. Удалите --omit=optional из вашей команды npm install, --no-optional из pnpm или --ignore-optional из yarn, и проверьте, что .npmrc не устанавливает optional=false. Затем переустановите. Встроенный бинарный файл доставляется только как опциональная зависимость, поэтому нет JavaScript fallback, если он пропущен.
  • Неподдерживаемая платформа. Предварительно собранные бинарные файлы опубликованы для darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 и win32-arm64. Claude Code не поставляет бинарный файл для других платформ; см. system requirements.
  • Корпоративное зеркало npm отсутствуют пакеты платформы. Убедитесь, что ваш реестр зеркалирует все восемь пакетов @anthropic-ai/claude-code-* платформы в дополнение к мета-пакету.

Установка с --ignore-scripts не вызывает эту ошибку. Шаг postinstall, который связывает бинарный файл на место, пропускается, поэтому Claude Code возвращается к обёртке, которая находит и порождает бинарный файл платформы при каждом запуске. Это работает, но запускается медленнее; переустановите со скриптами, включёнными для прямого выполнения.

Вход и аутентификация

Эти разделы решают проблемы входа, ошибки OAuth и проблемы с токенами.

Сброс вашего входа

Когда вход не удаётся и причина не очевидна, чистая повторная аутентификация разрешает большинство случаев:

  1. Запустите /logout, чтобы полностью выйти
  2. Закройте Claude Code
  3. Перезагрузитесь с claude и завершите процесс аутентификации снова

Если браузер не открывается автоматически во время входа, нажмите c, чтобы скопировать URL OAuth в буфер обмена, затем вставьте его в браузер вручную. Это также работает, когда URL переносится на несколько строк в узком или SSH терминале и не может быть нажат напрямую.

OAuth error: Invalid code

Если вы видите OAuth error: Invalid code. Please make sure the full code was copied, код входа истёк или был усечён во время копирования-вставки.

Решения:

  • Нажмите Enter, чтобы повторить и завершить вход быстро после открытия браузера
  • Введите c, чтобы скопировать полный URL, если браузер не открывается автоматически
  • Если используете удалённую/SSH сессию, браузер может открыться на неправильной машине. Скопируйте URL, отображаемый в терминале, и откройте его в вашем локальном браузере вместо этого.

403 Forbidden after login

Если вы видите API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}} после входа:

  • Пользователи Claude Pro/Max: проверьте, что ваша подписка активна на claude.ai/settings
  • Пользователи Anthropic Console: подтвердите, что ваша учётная запись имеет роль "Claude Code" или "Developer". Администраторы назначают это в Anthropic Console под Settings → Members.
  • За прокси: корпоративные прокси могут помешать запросам API. См. network configuration для настройки прокси.

This organization has been disabled with an active subscription

Если вы видите API Error: 400 ... "This organization has been disabled" несмотря на активную подписку Claude, переменная окружения ANTHROPIC_API_KEY переопределяет вашу подписку. Это обычно происходит, когда старый API ключ от предыдущего работодателя или проекта всё ещё установлен в вашем профиле оболочки.

Когда ANTHROPIC_API_KEY присутствует и вы его одобрили, Claude Code использует этот ключ вместо учётных данных OAuth вашей подписки. В неинтерактивном режиме с флагом -p ключ всегда используется, когда присутствует. См. authentication precedence для полного порядка разрешения.

Чтобы использовать вашу подписку вместо этого, отмените установку переменной окружения и удалите её из вашего профиля оболочки:

unset ANTHROPIC_API_KEY
claude

Проверьте ~/.zshrc, ~/.bashrc или ~/.profile на строки export ANTHROPIC_API_KEY=... и удалите их, чтобы сделать изменение постоянным. На Windows проверьте ваш профиль PowerShell в $PROFILE и ваши переменные окружения User на ANTHROPIC_API_KEY. Запустите /status внутри Claude Code, чтобы подтвердить, какой метод аутентификации активен.

OAuth login fails in WSL2, SSH, or containers

Когда Claude Code работает в WSL2, на удалённой машине через SSH или внутри контейнера, браузер обычно открывается на другом хосте и его перенаправление не может достичь локального сервера обратного вызова Claude Code. После того как вы войдёте, браузер показывает код входа вместо автоматического перенаправления обратно. Вставьте этот код в терминал в приглашение Paste code here if prompted, чтобы завершить вход.

Если браузер вообще не открывается из WSL2, установите переменную окружения BROWSER на путь вашего браузера Windows:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Или нажмите c на интерактивном приглашении входа, чтобы скопировать URL OAuth, или скопируйте URL, который печатает claude auth login, и откройте его в браузере на вашей локальной машине.

Если вставка кода в интерактивное приглашение ничего не делает, привязка вставки вашего терминала вероятно не достигает поля ввода. Попробуйте альтернативное сочетание клавиш вставки вашего терминала, часто правый клик или Shift+Insert в Windows Terminal, или используйте claude auth login вместо этого, который читает вставленный код из стандартного ввода:

claude auth login

Этот fallback также применяется на нативном Windows или любом терминале, где вставка в интерактивное приглашение не удаётся.

Not logged in or token expired

Если Claude Code предлагает вам войти снова после сессии, ваш токен OAuth может истечь.

Запустите /login, чтобы повторно аутентифицироваться. Если это происходит часто, проверьте, что ваши системные часы точны, так как валидация токена зависит от правильных временных меток.

На macOS вход также может не удаться, когда Keychain заблокирован или его пароль не синхронизирован с паролем вашей учётной записи, что предотвращает Claude Code от сохранения учётных данных. Запустите claude doctor, чтобы проверить доступ Keychain. Чтобы разблокировать Keychain вручную, запустите security unlock-keychain ~/Library/Keychains/login.keychain-db. Если разблокировка не помогает, откройте Keychain Access, выберите keychain login и выберите Edit > Change Password for Keychain "login", чтобы пересинхронизировать его с паролем вашей учётной записи.

Bedrock, Vertex, or Foundry credentials not loading

Если вы настроили Claude Code для использования облачного провайдера и видите Could not load credentials from any providers на Bedrock, Could not load the default credentials на Vertex или ChainedTokenCredential authentication failed на Foundry, ваш CLI облачного провайдера вероятно не аутентифицирован в текущей оболочке.

Для Bedrock подтвердите, что ваши учётные данные AWS действительны:

aws sts get-caller-identity

Для Vertex AI подтвердите, что ANTHROPIC_VERTEX_PROJECT_ID и CLOUD_ML_REGION установлены в вашей оболочке, затем установите учётные данные приложения по умолчанию:

gcloud auth application-default login

Для Microsoft Foundry подтвердите, что ANTHROPIC_FOUNDRY_API_KEY установлен, или войдите с Azure CLI, чтобы цепь учётных данных по умолчанию могла найти вашу учётную запись:

az login

Если учётные данные работают в вашем терминале, но не в расширении VS Code или JetBrains, процесс IDE вероятно не унаследовал вашу среду оболочки. Установите переменные окружения провайдера в собственных параметрах IDE или запустите IDE из терминала, где они уже экспортированы.

См. Amazon Bedrock, Google Vertex AI или Microsoft Foundry для полной настройки провайдера.

Still stuck

Если ничего из вышеперечисленного не разрешает вашу проблему:

  1. Проверьте GitHub repository на известные проблемы или откройте новую с вашей операционной системой, командой установки, которую вы запустили, и полным выводом ошибки
  2. Если claude --version работает, но что-то ещё не так, запустите claude doctor для автоматического диагностического отчёта
  3. Если вы можете запустить сессию, используйте /feedback внутри Claude Code, чтобы сообщить о проблеме