Ошибки и проблемы Claude Code: диагностика и решения
Собрали типичные ошибки, с которыми сталкиваются пользователи Claude Code, и проверенные способы их решения.
Быстрая диагностика
# Первое что нужно сделать при любой проблеме:
claude doctor
# Показывает: версию, API-ключ, конфигурацию, MCP-серверыОшибки авторизации и доступа
| Ошибка | Причина | Решение |
|---|---|---|
403 Forbidden |
Российский IP, аккаунт заблокирован или подписка истекла | Включите VPN, проверьте подписку на claude.ai. Для России — API-прокси сервис. |
401 Unauthorized |
Неверный или просроченный API-ключ | Сгенерируйте новый ключ в console.anthropic.com, обновите переменную окружения. |
| Authentication fails / browser won't open | Удалённый сервер, WSL — нет браузера | export ANTHROPIC_API_KEY=sk-ant-... — авторизация через ключ. |
| Account banned / suspended | Подключение с российского IP, нарушение ToS | Обратитесь в поддержку Anthropic. Для предотвращения — всегда используйте стабильный VPN с одним IP. |
Ошибки установки
| Ошибка | Решение |
|---|---|
command not found: claude |
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc |
EACCES permission error |
Никогда не используйте sudo npm. Переустановите через nvm: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash && nvm install 22 |
| Node.js version too old | nvm install 22 && nvm use 22 |
claude code download failed |
Проверьте интернет-соединение и прокси. Попробуйте нативный инсталлятор вместо npm. |
Windows: git bash path ошибка |
Используйте нативный PowerShell-инсталлятор или WSL2 вместо Git Bash. |
Ошибки API и лимиты
| Ошибка | Причина | Решение |
|---|---|---|
rate limit reached |
Исчерпан пул токенов в 5-часовом окне | Подождите до сброса окна. Проверьте /usage. Рассмотрите план Max. |
api error 500 |
Временный сбой на серверах Anthropic | Проверьте статус: status.anthropic.com. Подождите и повторите. |
context length exceeded |
Проект слишком большой для одного контекста | Добавьте .claudeignore, сузьте задачу, используйте /clear для сброса контекста. |
Проблемы с памятью (Memory)
Claude Code может «забывать» контекст между сессиями. Решение:
# CLAUDE.md — постоянный контекст (читается каждую сессию)
# Добавьте в корень проекта
# Сбросить текущий контекст сессии
/clear
# Посмотреть что Claude держит в памяти
/memoryПроблемы с MCP-серверами
# Проверить статус MCP-серверов
claude mcp list
# Перезапустить MCP-сервер
claude mcp restart <название>
# Удалить и добавить заново
claude mcp remove <название>
claude mcp add <название> -- <команда>Статус серверов Anthropic
При массовых сбоях проверьте status.anthropic.com — там отображаются инциденты в реальном времени. Для мониторинга можно использовать Downdetector.
Полный сброс
npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude ~/.npm/_cacache
npm cache clean --force
npm install -g @anthropic-ai/claude-code
claude doctor← Claude Code — главная · → Проблемы доступа из России · → Лимиты и rate limit
Полный справочник ошибок
| Сообщение об ошибке | Категория | Быстрое решение |
|---|---|---|
claude: command not found | Установка | Открыть новый терминал или source ~/.zshrc |
EACCES permission denied | Установка | npm config set prefix ~/.npm-global |
Node version not supported | Установка | Обновить Node.js: nvm install --lts |
Invalid API key | Авторизация | Пересоздать ключ в консоли Anthropic |
OAuth token revoked / expired | Авторизация | Выполнить /login |
Claude Opus is not available with Pro | Подписка | Opus требует Max план |
You've hit your session/weekly limit | Лимиты | Подождать сброса 5-часового окна |
Request rejected (429) | Лимиты | Снизить частоту запросов, использовать /compact |
Prompt is too long | Контекст | Использовать /clear или .claudeignore |
Unable to connect to API | Сеть | Проверить прокси: HTTPS_PROXY |
SSL certificate verification failed | Сеть/Корпорат. | NODE_EXTRA_CA_CERTS=/path/to/ca.pem |
Context window exceeded | Контекст | /clear для сброса контекста |
Авторизация на headless-сервере (без браузера)
Стандартная OAuth авторизация требует браузера. На VPS или в CI/CD используйте API-ключ:
# Способ 1: переменная окружения
export ANTHROPIC_API_KEY="sk-ant-..."
claude # работает без браузера
# Способ 2: перенос OAuth-токена с рабочей машины
# На локальной машине (уже авторизованной):
cat ~/.claude.json # скопируйте содержимое
# На сервере создайте тот же файл:
nano ~/.claude.json # вставьте скопированное
# Создайте файл-флаг для пропуска онбординга:
echo '{"onboarding_complete": true}' > ~/.claude/onboarding_completeПроблема с правами ~/.claude
Частая причина постоянных разлогинов — папка ~/.claude принадлежит root (если когда-то устанавливали с sudo):
# Диагностика
ls -la ~/.claude
# Исправление прав
sudo chown -R $USER:$USER ~/.claude
chmod 700 ~/.claudeКорпоративный прокси и SSL-перехват
В корпоративных сетях трафик часто проходит через SSL-прокси с собственным сертификатом. Claude Code это ломает:
# Добавить корпоративный сертификат
export NODE_EXTRA_CA_CERTS="/path/to/corporate-ca.pem"
# Добавить в ~/.zshrc или ~/.bashrc чтобы работало всегда
echo 'export NODE_EXTRA_CA_CERTS="/path/to/corp-ca.pem"' >> ~/.zshrcVPN и аккаунтные баны: что реально происходит
Тема, которую обсуждают в каждом русскоязычном сообществе Claude Code. Многие сталкивались: работал через VPN, аккаунт заблокировали. Давайте разберёмся что к чему.
Anthropic ограничивает доступ из России на уровне регионов — это официальная позиция компании. Это не техническая ошибка, это политика. Значит, работа через VPN технически нарушает условия использования. Большинство людей это игнорируют — и работает. Но есть сценарии, которые резко повышают риск бана:
- Нестабильный VPN с частой сменой IP — каждый новый IP выглядит как новая попытка обойти ограничения
- Корпоративный VPN — один IP на сотни пользователей; если кто-то на этом IP нарушил ToS, под удар попадают все
- Выход без VPN хотя бы раз — Anthropic видит российский IP в истории аккаунта
- Оплата российской картой через иностранный сервис — несоответствие платёжного адреса и IP
Что работает надёжно: стабильный VPN с одним выделенным IP (не shared), последовательное использование, оплата иностранной картой с соответствующим адресом. Многие используют VPS в Европе как прокси-сервер.
Когда лимиты заканчиваются не в нужный момент
Ситуация, которую все знают: середина важной задачи, Claude пишет что достиг лимита. Что делать:
- Переключитесь на более лёгкую модель — внутри сессии напишите
/model sonnetили/model haiku. Haiku справляется с 60-70% рутинных задач и потребляет кратно меньше токенов. - Продолжайте с контекстом — напишите Claude краткое резюме где остановились: "мы рефакторили UserService, уже переписали методы find() и save(), осталось update() и delete()". Claude подхватит.
- Используйте /compact — сжатие истории сессии освобождает место в контексте без потери ключевых выводов.
- Параллельная сессия — если первая упёрлась в лимит, откройте вторую с новым контекстом. Оба пула токенов независимы.
Ошибки которые на самом деле не ошибки
Несколько ситуаций, которые пугают новичков, но являются нормальным поведением:
Не ошибка инструмента — это неточная формулировка задачи. Попробуйте добавить конкретику: "в файле X, функции Y, не трогая Z".
При сложных задачах это нормально. Нажмите Enter на пустой строке — это включит режим extended thinking и скажет Claude что ждёте обдумывания.
Контекст заполняется. Используйте /compact — это сожмёт историю в резюме и освободит место.
Это настройка безопасности по умолчанию. Для автономной работы: Shift+Tab для Plan Mode, или явно напишите "выполни без запроса подтверждений".