Коды ошибок Claude Code: диагностика

Частая причина: Каталог установки не добавлен в PATH, или текущая оболочка ещё не перечитала конфигурацию.

Решение: Откройте новый терминал или добавьте каталог установки Claude Code в PATH и перезагрузите конфигурацию оболочки.

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

Частая причина: Версия Node ниже официальных требований, или WSL вызывает Node со стороны Windows.

Решение: Обновите Node или используйте официальный нативный установщик. В WSL проверьте командами which node / which npm, что пути ведут в среду Linux.

node -v
which node
which npm

Частая причина: Глобальный каталог npm принадлежит root, или прошлая установка через sudo нарушила права доступа.

Решение: Не устанавливайте Claude Code через sudo. Перенесите префикс npm в каталог пользователя или используйте нативный установщик.

npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

Частая причина: OAuth-коллбэк из браузера не доходит до локального CLI — часто при удалённом SSH, в devcontainer, за строгим межсетевым экраном или при блокировке коллбэков на localhost.

Решение: Убедитесь, что браузер и CLI на одной машине могут связаться друг с другом. При необходимости выйдите из аккаунта, перезапустите Claude Code и пройдите аутентификацию заново.

/logout
# 关闭 Claude Code 后重新运行
claude

Частая причина: Корпоративный прокси или шлюз безопасности подставляет самоподписанный CA, которому Node по умолчанию не доверяет.

Решение: Запросите у IT-отдела корпоративный CA bundle и укажите его через NODE_EXTRA_CA_CERTS.

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

Частая причина: Переменные прокси заданы неверно, протокол прокси не поддерживается, NO_PROXY перекрывает целевой домен, или доступ блокирует корпоративный межсетевой экран.

Решение: Claude Code использует стандартные переменные окружения HTTP/HTTPS-прокси; по документации SOCKS-прокси не поддерживаются. Сначала повторите проверку с HTTPS_PROXY.

export HTTPS_PROXY=http://proxy.example.com:8080
echo $HTTPS_PROXY
echo $NO_PROXY

Частая причина: В организации не включён Claude Code, корпоративный allowlist не содержит текущий выход, действуют ограничения аккаунта, региона или политики, либо прокси отклоняется.

Решение: Для личных аккаунтов сначала проверьте поддерживаемые регионы и статус аккаунта; для корпоративных попросите администратора проверить права Claude Code, SSO, IP allowlist и правила межсетевого экрана.

Частая причина: Слишком частые запросы, слишком высокий параллелизм, либо достигнут лимит частоты запросов тарифа аккаунта или организации.

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

Частая причина: API-ключ взят из другой оболочки, ключ Console конфликтует с OAuth-сеансом, или организация требует вход через SSO.

Решение: Проверьте, задан ли ANTHROPIC_API_KEY в текущей оболочке. Корпоративным аккаунтам следует входить через Console/SSO так, как требует администратор.

echo $ANTHROPIC_API_KEY