Устранение неполадок при установке и входе
Исправьте ошибки command not found, PATH, разрешений, сети и аутентификации при установке или входе в Claude Code.
Если установка не удалась или вы не можете войти, найдите вашу ошибку ниже. Для проблем во время выполнения после того, как Claude Code работает, см. Troubleshooting. Для проблем конфигурации, таких как неприменение параметров или неработающие hooks, см. Debug your configuration.
Найдите вашу ошибку
Сопоставьте сообщение об ошибке или симптом, который вы видите, с исправлением:
| Что вы видите | Решение |
|---|---|
command not found: claude или 'claude' is not recognized |
Исправьте ваш PATH |
syntax error near unexpected token '<' |
Install script returns HTML |
curl: (22) The requested URL returned error: 403 |
Install script returned 403 |
curl: (23) или curl: (56) Failure writing output to destination |
Проверьте подключение или используйте альтернативный установщик |
Killed во время установки на Linux, или 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. Убедитесь, что вы можете его достичь:
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-команды, если вы его не знаете, или проверьте параметры прокси вашего браузера.
Этот пример устанавливает обе переменные прокси, а затем запускает установщик через ваш прокси:
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:
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 могут вызвать несоответствия версий или неожиданное поведение. Проверьте, что установлено:
Перечислите все бинарные файлы 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:
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, пройдите через Проверка подключения к сети перед попыткой альтернативных установщиков ниже, так как они достигают тех же хостов.
В противном случае это может произойти из-за проблем с сетью, региональной маршрутизации или временного сбоя сервиса.
Решения:
-
Используйте альтернативный метод установки:
На 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: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 доверяли тому же пакету: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/Linuxcurl -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 последнего выпуска даже когда вы просите его установить более старую версию. Переустановите команду для вашей платформы:
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, удалите директории, которые называет ошибка вместо этого:
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, отображаемый в терминале, и откройте его в вашем локальном браузере вместо этого.
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:
Проверьте доступ 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.