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

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

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

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

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

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

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

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

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

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

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

Вы достигли сервера, если первая строка показывает статус 200. Вы видите HTTP/2 200 на macOS и Linux, и HTTP/1.1 200 OK из curl.exe, включённого в Windows. Другие результаты указывают на причину:

• 403: обычно прокси или сетевой фильтр, блокирующий хост, или Claude Code недоступен в вашем регионе
• 5xx: обычно временная проблема с сервисом; подождите несколько минут и повторите попытку

Если вы не видите вывода, 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

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

Проверьте ваш 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"

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

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

claude --version

$env:PATH -split ';' | Select-String '\.local\\bin'

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

claude --version

echo %PATH% | findstr /i "local\bin"

claude --version

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

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

which -a claude

ls -la ~/.local/bin/claude

ls -la ~/.claude/local/

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

where.exe claude

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

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

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

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

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

rm -rf ~/.claude/local

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)"

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 та же проблема выглядит как ошибки парсинга, указывающие на возвращённую страницу, с iex, пытающимся запустить HTML и CSS как PowerShell:

iex : At line:1 char:2310
+ ... igin="anonymous"/><script type="text/javascript">!function(o,c){var n ...
Missing argument in parameter list.
...

Формулировка варьируется в зависимости от версии PowerShell и языка системы: вы можете увидеть Missing expression after unary operator '--' или ParserError с ParseException вместо этого. HTML-теги или CSS в цитируемом тексте идентифицируют этот сбой. Если вы загружаете с -OutFile install.ps1 вместо этого, сохранённый файл — это та же веб-страница, поэтому это тоже не помогает.

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

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

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

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

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

Решения:

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

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

   brew install --cask claude-code
   

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

   winget install Anthropic.ClaudeCode
   

   Затем запустите claude --version для подтверждения: команда выводит номер версии, такой как 2.1.211 (Claude Code). Если оболочка сообщает, что claude не найден, откройте новое окно терминала и повторите попытку: сессия, из которой вы установили, сохраняет свой старый PATH.

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

`command not found: claude` after installation

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

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

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

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

Проверьте, что вы можете достичь downloads.claude.ai с проверкой в Проверка подключения к сети. Если вы достигли сервера, исходный сбой был вероятно временным; повторите команду установки. Вы также можете попробовать альтернативный метод установки.

Homebrew cask unavailable or outdated

Homebrew сообщает Error: Cask 'claude-code' is unavailable: No Cask with this name exists, когда ваша локальная копия индекса Homebrew cask предшествует публикации cask. Обновите индекс и повторите попытку:

brew update
brew install --cask claude-code

Если Homebrew устанавливает более старую версию Claude Code, чем вы ожидаете, обычно причина в том же устаревшем индексе. Cask claude-code отслеживает стабильный канал и обычно отстаёт на неделю от последнего выпуска; для самой новой версии запустите вместо этого brew install --cask claude-code@latest. См. Настройка канала выпуска для различия между двумя cask.

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:

   macOS/Linux Windows PowerShell

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

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

   macOS/Linux Windows PowerShell

   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 достиг сервера, но ваша сеть блокирует поиск отзыва сертификата, что распространено за корпоративными брандмауэрами. Если команда, которая не удаётся, — это curl, который загружает install.cmd, переустановите её из Command Prompt с добавленным --ssl-revoke-best-effort:

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

   Когда собственные загрузки скрипта попадают на те же ошибки, он переустанавливает их с проверкой отзыва best-effort автоматически, поэтому флаг нужен только на команде, которую вы запускаете сами. Проверка best-effort допускает недостижимый сервер отзыва, но всё ещё отклоняет сертификат, который известен как отозванный, соответствуя тому, как браузеры обрабатывают отзыв. Вы также можете полностью избежать проверки отзыва curl, запустив установщик PowerShell из PowerShell, который загружается через .NET и не падает, когда сервер отзыва недоступен:

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

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

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

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

Wrong install command on Windows

Если вы видите 'irm' is not recognized, The token '&&' is not a valid statement separator, A parameter cannot be found that matches parameter name 'fsSL' или '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
  

• A parameter cannot be found that matches parameter name 'fsSL': вы запустили установщик macOS/Linux curl -fsSL ... | bash в Windows PowerShell, где curl является псевдонимом для Invoke-WebRequest и отклоняет флаги -fsSL. Используйте вместо этого установщик PowerShell:

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

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

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

• Команда выводит текст скрипта вместо установки: вы запустили половину загрузки команды без части, которая её выполняет. irm https://claude.ai/install.ps1 само по себе выводит загруженный скрипт в терминал. Передайте его в iex для запуска:

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

  В CMD curl -fsSL https://claude.ai/install.cmd без -o выводит пакетный скрипт вместо его сохранения. Запустите полную команду:

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

Какой бы установщик вы ни использовали, подтвердите, что он сработал: откройте новый терминал и запустите claude --version, который выводит номер версии, такой как 2.1.211 (Claude Code).

`running scripts is disabled on this system`

Установка или запуск Claude Code через npm на Windows может не удаться с SecurityError:

npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
...
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException

Та же ошибка называет claude.ps1, когда вы запускаете claude после установки npm. Политика выполнения PowerShell блокирует скрипты .ps1 launcher, которые npm создаёт для своих команд. Политика применяется к файлам скриптов, поэтому она не влияет на установщик PowerShell irm https://claude.ai/install.ps1 | iex, который запускает загруженный текст напрямую.

Решения:

1. Разрешите локально созданные скрипты для вашего пользователя, затем повторите попытку:

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

2. Вызовите launcher .cmd вместо этого: npm.cmd и claude.cmd делают то же самое, и политика их не охватывает.
3. Используйте установщик PowerShell вместо npm. Он устанавливает бинарный файл, а не скрипт .ps1.

`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 во время установки обычно означает, что убийца Linux out-of-memory (OOM) завершил шаг claude install, потому что система исчерпала свободную память. Это распространено на небольших VPS и облачных экземплярах. Скрипт установки сообщает причину и выходит с кодом 137. В этом примере номер строки и ID процесса варьируются в зависимости от выпуска и запуска:

Setting up Claude Code...
bash: line 183: 34803 Killed    "$binary_path" install ${TARGET:+"$TARGET"}
Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

Установка требует примерно 512 МБ свободной памяти, а запуск Claude Code требует больше. См. системные требования.

Решения:

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 Desktop, поэтому откройте Settings > Resources в Docker Desktop, поднимите лимит памяти и переустановите сборку.

`Raw mode is not supported` during install

Когда параметры, управляемые сервером вашей организации включают изменения, которые требуют одобрения безопасности, версии Claude Code до 2.1.246 пытаются показать диалог одобрения во время claude install. Диалог требует терминал на stdin. Когда установщик запускает claude install из канала, как curl -fsSL https://claude.ai/install.sh | bash делает, stdin — это канал, а не терминал, поэтому установка не удаётся с ошибкой, содержащей Raw mode is not supported.

Claude Code v2.1.246 и позже не показывают диалог во время claude install или claude update. Команда запускается с параметрами, которые вы в последний раз одобрили, и Claude Code показывает диалог в вашей следующей интерактивной сессии. Если конфигурация запуска вашей организации ждёт выборки параметров, такая как когда она устанавливает forceRemoteSettingsRefresh, диалог всё ещё появляется во время этих команд, и запуск установки из канала всё ещё не удаётся.

В каждой другой конфигурации переустановка установщика преодолевает эту ошибку, потому что скрипт запускает команду install последнего выпуска даже когда вы просите его установить более старую версию. Переустановите команду для вашей платформы:

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

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

claude --version выводит версию, которую переустановка установила.

`claude update` or `claude doctor` hangs

claude update и claude doctor сканируют ваши файлы конфигурации оболочки на предмет устаревшего псевдонима claude: ~/.zshrc, ~/.bashrc и ~/.config/fish/config.fish, плюс на macOS первый из ~/.bash_profile, ~/.bash_login или ~/.profile, который существует. Если вы установили ZDOTDIR, файл Zsh — это $ZDOTDIR/.zshrc вместо этого. Когда один из этих путей — это директория, Claude Code пропускает его и обе команды завершаются нормально. До v2.1.214 директория в одном из этих путей заставляла обе команды зависать и оставляла раздел System diagnostics в /status пустым. claude doctor зависал без вывода; claude update зависал сразу после вывода Checking for updates.

Если вы попали на зависание на более ранней версии, найдите директорию. В выводе этой команды строка, начинающаяся с d, отмечает этот путь как директорию. Строка No such file or directory означает, что ничего не существует в этом пути и не является причиной:

ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

Переместите директорию в сторону, или обновитесь до v2.1.214 или позже. Так как claude update зависает на затронутых версиях, обновитесь, переустановив скрипт установки вместо этого.

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 при отсутствии 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 не может его найти, сравните его местоположение с местами, которые Claude Code проверяет. Когда CLAUDE_CODE_GIT_BASH_PATH не установлен, Claude Code ищет bash.exe в этом порядке:

1. Местоположения установки по умолчанию C:\Program Files\Git и C:\Program Files (x86)\Git.
2. git на вашем PATH, используя bin\bash.exe из этой установки Git.

На шаге 2 Claude Code пропускает git, который находится в папке, из которой вы запустили Claude Code, или ниже её в пути, который содержит node_modules или папку виртуального окружения, такую как .venv или env, например C:\dev\env\myproject\Git, когда вы запустили из C:\dev\env\myproject. Это предотвращает запуск Claude Code исполняемого файла, который проект поместил туда. Если ваш Git находится в месте, подобном этому, укажите CLAUDE_CODE_GIT_BASH_PATH на него.

Чтобы указать Claude Code на конкретную установку Git, найдите её, запустив where.exe git в PowerShell, затем установите путь bin\bash.exe из этой установки как CLAUDE_CODE_GIT_BASH_PATH в вашем файле settings.json:

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

Если CLAUDE_CODE_GIT_BASH_PATH установлен на правильный путь и файл существует, но Claude Code всё ещё не использует его, сначала проверьте имя файла. Claude Code принимает только файл с именем bash.exe, sh.exe, bash или sh; с любым другим именем, таким как launcher git-bash.exe Git for Windows, он игнорирует переменную и автоматически определяет Git Bash, как если бы она была не установлена, логируя предупреждение, видимое с --debug. Путь, который не существует, получает тот же fallback и предупреждение. До v2.1.219 Claude Code использовал любой существующий файл как оболочку без проверки его имени и выходил при запуске с Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path, когда путь не существовал.

Если имя файла правильное, программное обеспечение безопасности конечной точки, такое как AppLocker, политики ограничения программного обеспечения Group Policy или агенты EDR, могут вмешиваться. Попросите вашу IT-команду добавить в список разрешений claude.exe и процессы, которые он порождает, включая cmd.exe и 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-битную операционную систему. См. системные требования.

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
   

   На Alpine ripgrep находится в репозитории community. Если apk сообщает, что пакет отсутствует, см. Alpine Linux setup.

`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: Symbol not found, dyld: cannot load или Abort trap: 6 во время установки, бинарный файл несовместим с вашей версией macOS или оборудованием.

Ошибка 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

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

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

Решения:

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. Если вы использовали встроенный установщик, пропустите этот раздел.

Проблемы обнаружения ОС или платформы. Если 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

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

Если вы ранее установили с 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. npm затем запускает скрипт postinstall пакета, который копирует этот бинарный файл на место как команду claude; до его запуска claude — это скрипт-заполнитель. Если либо загрузка, либо шаг postinstall пропущены, заполнитель остаётся на месте, и запуск claude на macOS и Linux выводит:

Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

Run the postinstall manually (adjust path for local vs global install):
  node node_modules/@anthropic-ai/claude-code/install.cjs

Or reinstall without --ignore-scripts / --omit=optional.

На Windows bin/claude.exe — это тот же скрипт-заполнитель оболочки, а не реальный исполняемый файл, поэтому PowerShell и CMD сообщают, что они не могут запустить файл вместо вывода этого сообщения.

Проверьте следующие причины:

• Опциональные зависимости отключены. Удалите --omit=optional из вашей команды npm install, --no-optional из pnpm или --ignore-optional из yarn, и проверьте, что .npmrc не устанавливает optional=false. Затем переустановите. Встроенный бинарный файл доставляется только как опциональная зависимость, поэтому нет JavaScript fallback, если он пропущен, и запуск install.cjs снова не может поместить бинарный файл, который никогда не был загружен.
• Скрипты установки отключены. --ignore-scripts и некоторые конфигурации pnpm пропускают шаг postinstall, но всё ещё загружают пакет платформы. Запустите node node_modules/@anthropic-ai/claude-code/install.cjs, как предлагает сообщение, или переустановите без флага. Если postinstall вообще не может запуститься в вашей среде, node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs находит загруженный пакет и запускает его, за счёт дополнительного процесса Node при каждом запуске. Если обёртка вместо этого выводит Could not find native binary package, пакет платформы никогда не был загружен, поэтому сначала исправьте причину опциональных зависимостей выше.
• Неподдерживаемая платформа. Предварительно собранные бинарные файлы опубликованы для darwin-arm64, darwin-x64, linux-x64, linux-arm64, linux-x64-musl, linux-arm64-musl, win32-x64 и win32-arm64. Claude Code не поставляет бинарный файл для других платформ; см. системные требования. На FreeBSD установщик сообщает платформу как неподдерживаемую. До v2.1.205 он рассматривал FreeBSD как Linux и загружал бинарный файл, который не мог работать.
• Корпоративное зеркало npm отсутствуют пакеты платформы. Убедитесь, что ваш реестр зеркалирует все восемь пакетов @anthropic-ai/claude-code-* платформы в дополнение к мета-пакету.

npm `ENOTEMPTY` error during update or reinstall

Когда вы запускаете npm install -g @anthropic-ai/claude-code над существующей установкой, npm может не удаться при перемещении старого директория пакета в сторону:

npm error code ENOTEMPTY
npm error syscall rename
npm error path /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/claude-code
npm error dest /home/you/.nvm/versions/node/v22.13.1/lib/node_modules/@anthropic-ai/.claude-code-tVWAnUUt
npm error errno -39
npm error ENOTEMPTY: directory not empty, rename '...'

Строка npm error path называет директорию, которую npm не смог переместить. Удалите эту директорию и любые оставшиеся директории .claude-code-* рядом с ней, которые более ранние прерванные запуски могут оставить позади. Команды ниже находят вашу глобальную директорию пакета с npm root -g; если директория, которую называет строка npm error path, не находится под директорией, которую выводит npm root -g, например потому что вы переключили версии Node с nvm, удалите директории, которые называет ошибка вместо этого:

rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"

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

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

Подтвердите с claude --version, который выводит номер версии, такой как 2.1.211 (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

Remove-Item Env: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, чтобы повторно аутентифицироваться. Если это происходит часто, проверьте, что ваши системные часы точны, так как валидация токена зависит от правильных временных меток.

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

На macOS Claude Code сохраняет учётные данные в Keychain входа. Когда Keychain отклоняет запись, например когда он заблокирован в SSH сессии или его пароль не синхронизирован с паролем вашей учётной записи, Claude Code сохраняет ваш вход в открытый текстовый файл ~/.claude/.credentials.json вместо этого. Вход в Console, который создаёт API ключ, не удаётся до тех пор, пока Keychain снова не станет доступным для записи.

Чтобы сделать Keychain доступным для записи снова и переместить ваш вход обратно в зашифрованный Keychain:

security unlock-keychain ~/Library/Keychains/login.keychain-db

Bedrock, Agent Platform, or Foundry credentials not loading

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

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

aws sts get-caller-identity

Для Google Cloud's Agent Platform подтвердите, что 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 Cloud's Agent Platform или Microsoft Foundry для полной настройки провайдера.

Still stuck

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

1. Проверьте GitHub repository на известные проблемы или откройте новую с вашей операционной системой, командой установки, которую вы запустили, и полным выводом ошибки
2. Если claude --version работает, но что-то ещё не так, запустите claude doctor для автоматического диагностического отчёта
3. Если вы можете запустить сессию, используйте /feedback внутри Claude Code, чтобы сообщить о проблеме
4. Если проблема связана с вашей учётной записью, а не с установкой, например с циклом входа, неузнанной подпиской или отключённой организацией, свяжитесь с поддержкой Anthropic: войдите на claude.ai (пользователи Console: platform.claude.com), нажмите на ваши инициалы в нижнем левом углу и выберите Get help. Полный процесс см. в разделе How to get support.