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

Если установка не удалась или вы не можете войти, найдите вашу ошибку ниже. Для проблем во время выполнения после того, как 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, или `Installation was killed before it could finish (exit code 137)`	Освободите память или добавьте пространство подкачки
`Raw mode is not supported` во время установки	Повторно запустите установщик
`TLS connect error` или `SSL/TLS secure channel`	Обновите сертификаты CA
`Failed to fetch version` или невозможно достичь сервера загрузки	Проверьте параметры сети и прокси
`irm is not recognized` или `&& is not valid`	Используйте правильную команду для вашей оболочки
`Cask 'claude-code' is unavailable: No Cask with this name exists`	Обновите Homebrew
`'bash' is not recognized as the name of a cmdlet`	Используйте команду установщика Windows
`A parameter cannot be found that matches parameter name 'fsSL'`	Используйте команду установщика 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: Symbol not found`, `dyld: cannot load` или `Abort trap` на macOS	Несовместимость двоичного файла
`claude update` зависает после `Checking for updates`, или `claude doctor` зависает без вывода	Переместите каталог по пути конфигурации оболочки
`Invoke-Expression` или `iex` ошибки парсинга цитирования HTML-тегов или CSS, или `ParserError` с `ParseException`	Install script returns HTML
`running scripts is disabled on this system` или `PSSecurityException`	Разрешите npm shims запускаться
`Error: claude native binary not installed`	Завершите установку npm
`npm error code ENOTEMPTY` во время обновления или переустановки	Удалите оставшийся каталог пакета
На Windows команда установки выводит текст скрипта и ничего не устанавливается	Запустите полную команду установки
`App unavailable in region`	Claude Code недоступен в вашей стране. См. поддерживаемые страны.
`unable to get local issuer certificate`	Настройте корпоративные сертификаты CA
`OAuth error` или `403 Forbidden`	Исправьте аутентификацию
`Unable to connect to Anthropic services` во время установки	См. Unable to connect to Anthropic services в справочнике ошибок
`Could not load the default credentials` или `Could not load credentials from any providers`	Учетные данные Amazon Bedrock, Google Cloud’s Agent Platform или Microsoft Foundry
`ChainedTokenCredential authentication failed` или `CredentialUnavailableError`	Учетные данные Amazon Bedrock, Google Cloud’s Agent Platform или Microsoft Foundry
`API Error: 500`, `529 Overloaded`, `429` или другие ошибки 4xx и 5xx, не указанные выше	См. справочник ошибок

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

Если вы предпочитаете полностью избежать терминала, Claude Code Desktop app позволяет вам установить и использовать Claude Code через графический интерфейс. Загрузите его для macOS или Windows и начните кодировать без какой-либо настройки командной строки. На Linux установите приложение с помощью apt, следуя инструкциям по установке Linux.

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

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

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

macOS/Linux
Windows PowerShell

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

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

PowerShell создаёт псевдоним curl на Invoke-WebRequest, который отклоняет флаги -sI, поэтому вызовите curl.exe явно.

Вы достигли сервера, если первая строка показывает статус 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-команды, если вы его не знаете, или проверьте параметры прокси вашего браузера. Этот пример устанавливает обе переменные прокси, а затем запускает установщик через ваш прокси:

macOS/Linux
Windows PowerShell

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.

Расширение VS Code не размещает claude в этом месте. Оно содержит приватную копию CLI внутри директории расширения для своей собственной панели чата и не добавляет её в PATH. Если вы установили только расширение, ~/.local/bin/claude не будет существовать. Запустите автономную установку, чтобы использовать claude из терминала, а затем продолжите ниже.

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

macOS/Linux
Windows PowerShell
Windows CMD

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

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

Если вывода нет, добавьте директорию установки в ваш User PATH:

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

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

claude --version

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

Если вывода нет, откройте System Settings, перейдите в Environment Variables и добавьте %USERPROFILE%\.local\bin в вашу переменную User PATH. Перезагрузите ваш терминал.Проверьте, что исправление сработало:

claude --version

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

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

macOS/Linux
Windows PowerShell

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

which -a claude

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

ls -la ~/.local/bin/claude

Встроенная установка показывает символическую ссылку в ~/.local/share/claude/versions/. Скрипт или символическая ссылка, которую вы создали сами в этом пути, — это пользовательский запускатель, который автоматическое обновление оставляет на месте.Если какая-либо команда ls выводит No such file or directory, это не ошибка. Это означает, что ничего не установлено в этом месте, поэтому переходите к следующей проверке.

ls -la ~/.claude/local/

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

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

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:

macOS/Linux
Windows PowerShell

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. Подтвердите, что бинарный файл существует и исполняемый:

macOS/Linux
Windows PowerShell

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, пройдите через Проверка подключения к сети перед попыткой альтернативных установщиков ниже, так как они достигают тех же хостов. В противном случае это может произойти из-за проблем с сетью, региональной маршрутизации или временного сбоя сервиса. Решения:

Используйте альтернативный метод установки: На macOS установите через Homebrew:
brew install --cask claude-code
На Windows установите через WinGet:
winget install Anthropic.ClaudeCode
Затем запустите claude --version для подтверждения: команда выводит номер версии, такой как 2.1.211 (Claude Code). Если оболочка сообщает, что claude не найден, откройте новое окно терминала и повторите попытку: сессия, из которой вы установили, сохраняет свой старый PATH.
Повторите попытку через несколько минут: проблема часто временная. Подождите и попробуйте исходную команду снова.

`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`

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

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

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

Проверьте стабильность сети: бинарные файлы Claude Code размещены на downloads.claude.ai. Проверьте, что вы можете его достичь:
curl -sI https://downloads.claude.ai/claude-code-releases/latest
Строка HTTP/2 200 означает, что вы достигли сервера и исходный сбой был вероятно временным; повторите команду установки. Другие результаты указывают на причину:
- 403: обычно прокси или сетевой фильтр, блокирующий хост, или Claude Code недоступен в вашем регионе
- 5xx: обычно временная проблема сервиса; подождите несколько минут и повторите попытку
- Could not resolve host или timeout соединения: ваша сеть блокирует загрузку
Попробуйте альтернативный метод установки: На macOS:
brew install --cask claude-code
На Windows:
winget install Anthropic.ClaudeCode
Затем запустите claude --version для подтверждения: команда выводит номер версии, такой как 2.1.211 (Claude Code). Если оболочка сообщает, что claude не найден, откройте новое окно терминала и повторите попытку: сессия, из которой вы установили, сохраняет свой старый PATH.

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. Решения:

Обновите сертификаты CA вашей системы: На Ubuntu/Debian:
sudo apt-get update && sudo apt-get install ca-certificates
На macOS системный curl использует хранилище доверия Keychain; обновление самого macOS обновляет корневые сертификаты.

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

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

Проверьте помехи прокси или брандмауэра: корпоративные прокси, выполняющие 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
Установщик PowerShell загружается через .NET, который проверяет TLS в хранилище сертификатов Windows. Попросите вашу IT-команду добавить сертификат CA прокси в хранилище Windows, если его там ещё нет, затем запустите установщик:
irm https://claude.ai/install.ps1 | iex
Для самого Claude Code после установки установите NODE_EXTRA_CA_CERTS так, чтобы запросы API доверяли тому же пакету:
- macOS/Linux
- Windows PowerShell
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem
$env:NODE_EXTRA_CA_CERTS = 'C:\path\to\corporate-ca.pem'
Попросите файл сертификата у вашей IT-команды, если у вас его нет. Вы также можете попробовать на прямом соединении, чтобы подтвердить, что прокси является причиной.
На 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 valid, 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, который запускает загруженный текст напрямую. Решения:

Разрешите локально созданные скрипты для вашего пользователя, затем повторите попытку:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Вызовите launcher .cmd вместо этого: npm.cmd и claude.cmd делают то же самое, и политика их не охватывает.
Используйте установщик 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 требует больше. См. системные требования. Решения:

Добавьте пространство подкачки, если ваш сервер имеет ограниченную оперативную память. Подкачка использует дисковое пространство как переполнение памяти, позволяя установке завершиться даже при низкой физической оперативной памяти. Создайте файл подкачки размером 2 ГБ и включите его:
sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile
Затем повторите установку:
curl -fsSL https://claude.ai/install.sh | bash
Закройте другие процессы, чтобы освободить память перед установкой.
Используйте больший экземпляр, если возможно. Claude Code требует по крайней мере 4 ГБ оперативной памяти.

Install hangs in Docker

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

Установите рабочую директорию перед запуском установщика. При запуске из / установщик сканирует всю файловую систему, что вызывает чрезмерное использование памяти. Установка WORKDIR ограничивает сканирование небольшой директорией:
WORKDIR /tmp RUN curl -fsSL https://claude.ai/install.sh | bash
Увеличьте лимиты памяти 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 последнего выпуска даже когда вы просите его установить более старую версию. Переустановите команду для вашей платформы:

macOS/Linux
Windows PowerShell

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 в этом порядке:

Местоположения установки по умолчанию C:\Program Files\Git и C:\Program Files (x86)\Git.
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. Решения:

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

Решения:

Проверьте вашу версию macOS: Claude Code требует macOS 13.0 или позже. Откройте меню Apple и выберите About This Mac, чтобы проверить вашу версию.
Обновите 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"

Избегайте отключения импорта Windows PATH через appendWindowsPath = false, так как это нарушает возможность вызывать исполняемые файлы Windows из WSL. Аналогично, избегайте удаления Node.js из Windows, если вы используете его для разработки Windows.

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, удалите директории, которые называет ошибка вместо этого:

macOS/Linux
Windows PowerShell

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

Затем удалите любые оставшиеся временные директории. Если zsh выводит no matches found, их не было для удаления:

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

Запустите /logout, чтобы полностью выйти
Закройте Claude Code
Перезагрузитесь с 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, отображаемый в терминале, и откройте его в вашем локальном браузере вместо этого.

Если вы видите 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 для полного порядка разрешения. Чтобы использовать вашу подписку вместо этого, отмените установку переменной окружения и удалите её из вашего профиля оболочки:

macOS/Linux
Windows PowerShell

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, чтобы подтвердить, какой метод аутентификации активен. Когда 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:

Проверьте доступ Keychain

Запустите claude doctor, чтобы проверить доступ Keychain. Когда Keychain отклоняет запись, отчёт содержит предупреждение, которое начинается с macOS Keychain is not writable, за которым следует предложенное исправление. Когда отчёт не содержит предупреждение Keychain, Keychain доступен для записи и вы можете перейти к последнему шагу.

Разблокируйте Keychain

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

Введите пароль Keychain, когда команда его запросит, затем запустите claude doctor снова. Когда разблокировка сработала, отчёт больше не содержит предупреждение Keychain.

Пересинхронизируйте пароль Keychain, если разблокировка не помогает

Откройте Keychain Access, выберите keychain login и выберите Edit > Change Password for Keychain “login”, чтобы пересинхронизировать его с паролем вашей учётной записи. Затем запустите claude doctor снова. Переходите к следующему шагу, когда отчёт больше не содержит предупреждение Keychain.

Выйдите и войдите снова

Когда Keychain снова доступен для записи, Claude Code перемещает учётные данные обратно при следующей записи учётных данных. Чтобы сделать это сейчас, запустите /logout и затем /login. Выход удаляет все сохранённые учётные данные, включая содержимое открытого текстового файла, сохранённые входы MCP сервера и значения секретов плагина, поэтому ожидайте повторной авторизации MCP серверов и повторного ввода секретов плагина после этого. Вход снова сохраняет ваш вход в Keychain.

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

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

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

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

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

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

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

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

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

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

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

​Install script returns HTML instead of a shell script

​command not found: claude after installation

​curl: (56) Failure writing output to destination

​Homebrew cask unavailable or outdated

​TLS or SSL connection errors

​Failed to fetch version from downloads.claude.ai

​Wrong install command on Windows

​running scripts is disabled on this system

​The process cannot access the file during Windows install

​Install killed on low-memory Linux servers

​Install hangs in Docker

​Raw mode is not supported during install

​claude update or claude doctor hangs

​Claude Desktop overrides the claude command on Windows

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

​Claude Code does not support 32-bit Windows

​Linux musl or glibc binary mismatch

​Illegal instruction

​dyld: cannot load on macOS

​Exec format error on WSL1

​npm install errors in WSL

​Permission errors during installation

​Native binary not found after npm install

​npm ENOTEMPTY error during update or reinstall

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

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

​OAuth error: Invalid code

​403 Forbidden after login

​This organization has been disabled with an active subscription

​OAuth login fails in WSL2, SSH, or containers

​Not logged in or token expired

​Bedrock, Agent Platform, or Foundry credentials not loading

​Still stuck

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

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

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

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

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

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

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

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

Install script returns HTML instead of a shell script

`command not found: claude` after installation

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

Homebrew cask unavailable or outdated

TLS or SSL connection errors

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

Wrong install command on Windows

`running scripts is disabled on this system`

`The process cannot access the file` during Windows install

Install killed on low-memory Linux servers

Install hangs in Docker

`Raw mode is not supported` during install

`claude update` or `claude doctor` hangs

Claude Desktop overrides the `claude` command on Windows

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

Claude Code does not support 32-bit Windows

Linux musl or glibc binary mismatch

`Illegal instruction`

`dyld: cannot load` on macOS

`Exec format error` on WSL1

npm install errors in WSL

Permission errors during installation

Native binary not found after npm install

npm `ENOTEMPTY` error during update or reinstall

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

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

OAuth error: Invalid code

403 Forbidden after login

This organization has been disabled with an active subscription

OAuth login fails in WSL2, SSH, or containers

Not logged in or token expired

Bedrock, Agent Platform, or Foundry credentials not loading

Still stuck