Содержание
- 1. «Диагностические команды», которые стоит запустить первыми
- 2. Авторизация и вход
- 3. Использование и лимиты запросов (самое частое)
- 4. Контекст и токены
- 5. Сервер и модель
- 6. Установка, PATH и обновление
- 7. Сеть и прокси
- 8. MCP (подключённые серверы)
- 9. Разрешения и инструменты
- 10. Прочее (thinking / изображения-PDF / IDE)
- 11. Шпаргалка «ошибка → исправление»
- Итоги
- FAQ
Вы работаете в Claude Code, и он внезапно останавливается с ошибкой — «войдите снова», «лимит запросов», «слишком длинный промпт», «MCP не подключается». Разновидностей так много, что гуглить каждую утомительно. Эта статья — практический справочник, который каталогизирует ошибки, чаще всего встречающиеся в Claude Code, с причиной и командой для запуска по каждой из них.
Сразу к сути: для большинства ошибок запуск claude doctor (полная диагностика), /status (ваша текущая авторизация) и /context (разбивка контекста) в первую очередь сузит круг причин. А самые частые сводятся к четырём семействам: ① использование/лимиты запросов, ② переполнение контекста, ③ истёкшая авторизация, ④ сбои подключения MCP. Ниже каждая категория выстроена по схеме «симптом → причина → команда исправления». Добавьте в закладки и переходите к нужному разделу, когда застряли.
Если сомневаетесь — эти 3 команды
— большинство ошибок начинается с изоляции причины
Четыре семейства: ① использование/лимиты запросов ② переполнение контекста ③ истёкшая авторизация ④ сбой подключения MCP.
И незаметно, но «обновление до последней версии» claude update устраняет множество багов.
* Команды и исправления здесь основаны на официальной документации Claude Code (по состоянию на 2026). Claude Code обновляется быстро, и названия команд и формулировки сообщений могут меняться. Проверяйте актуальное состояние через claude doctor и официальную документацию.
1. «Диагностические команды», которые стоит запустить первыми
Прежде чем погружаться в конкретные ошибки, знание диагностических команд, которые помогают изолировать причину, позволяет быстро локализовать большинство проблем.
| Команда | Что показывает / делает |
|---|---|
claude doctor | Полная проверка установки, настроек, серверов MCP, использования контекста |
/status | Текущий активный метод авторизации (Pro / Max / Team / API-ключ) |
/context | Разбивка контекста (системный промпт, история, файлы, инструменты MCP) |
/usage | Текущие лимиты плана и время сброса |
/permissions | Список правил разрешений (allow/deny) и их источники |
/mcp | Статус подключения серверов MCP и количество доступных инструментов |
/feedback | Сообщить о баге в Anthropic вместе с журналом беседы |
2. Авторизация и вход
Семейство «всё работало и вдруг просит войти». Классическая ловушка — API-ключ из переменной окружения переопределяет вашу подписку.
| Симптом | Причина | Исправление |
|---|---|---|
| Not logged in / Please run /login | Нет действительных учётных данных (истёкший токен и т. п.) | /login. Если повторяется, проверьте системные часы и блокировку Keychain |
| Invalid API key | Остался устаревший ANTHROPIC_API_KEY | env | grep ANTHROPIC → unset ANTHROPIC_API_KEY → /login |
| OAuth token revoked / expired | Выход выполнен в другом месте / отключено администратором | /logout → /login. Подозревайте также рассинхрон часов |
| This organization has been disabled | API-ключ из отключённой организации переопределяет | Удалите ключ из профиля оболочки (.zshrc и т. п.) → /login → подтвердите через /status |
| 403 Forbidden (after login) | Истёкшая подписка / отсутствует роль / вмешательство прокси | Проверьте подписку и роль в Console. Для прокси задайте HTTPS_PROXY |
Правило: API-ключ из переменной окружения имеет приоритет над входом по подписке. Если вы задали ANTHROPIC_API_KEY для CI-задачи и забыли о нём, ваш личный план Pro/Max будет проигнорирован. Проверить «какие учётные данные активны» через /status в первую очередь — верный ход.
3. Использование и лимиты запросов (самое частое)
Самая частая жалоба в Claude Code. Claude Code потребляет в 10-100 раз больше токенов, чем чат (многоходовые беседы, огромные контексты, циклы вызова инструментов), поэтому вы упираетесь в лимиты быстрее, чем кажется обоснованным.
3 шага, когда вы «упёрлись в лимит»
/usage для лимитов и времени сброса, /status для учётных данных/model для более лёгкой модели, /compact для сжатия истории, отключите неиспользуемые MCP
Примечание: «Server is temporarily limiting requests» — это кратковременное серверное ограничение, а не лимит вашего плана. Просто подождите и повторите.
Не путайте с лимитами плана (сессионными/недельными).
Дополнительно: «429 / Request rejected» — это превышение частоты запросов на вашем API-ключе или в рабочем пространстве. «Credit balance is too low» — исчерпан предоплаченный баланс Console (пополните в биллинге или переключитесь на подписку). Учтите, что примерно в марте 2026 года пользователи Max сообщали о необычно быстром расходовании их 5-часовых окон в техническом медиа и в issues официального репозитория (предполагаемый баг). Если это повторяется, обновитесь до последней версии, измеряйте через /usage и при необходимости отправьте /feedback. О системной экономии токенов см. экономию токенов ИИ и экономию токенов в Claude Code.
4. Контекст и токены
Появляется, когда вы работаете с длинными совещаниями или огромными файлами.
| Симптом | Причина | Исправление |
|---|---|---|
| Prompt is too long | Беседа + файлы превышают окно контекста | /compact (суммаризация), /clear (сброс), /context для просмотра разбивки, отключите неиспользуемые MCP через /mcp |
| Error during compaction: Conversation too long | Недостаточно свободного места для результата сжатия | Дважды Esc, чтобы отмотать несколько ходов, затем /compact. Если всё ещё застряли — /clear |
| Auto-compact is thrashing | Огромный вывод сразу после сжатия снова заполняет контекст | Читайте большие файлы по диапазонам строк / /compact keep only <focus> / перенесите в субагента |
Хитрость в том, чтобы никогда не читать огромный файл целиком. Передавайте логи и данные небольшими кусками по диапазонам строк. Понимание идеи окна контекста делает этот класс ошибок гораздо более редким.
5. Сервер и модель
| Симптом | Причина | Исправление |
|---|---|---|
| 500 Internal server error | Временный сбой на стороне Anthropic | Проверьте status.claude.com → повторите через 1 мин |
| 529 Overloaded (repeated) | API временно перегружен | Подождите несколько минут. Переключите модель через /model, чтобы распределить нагрузку |
| Request timed out | Нет ответа в течение стандартных 10 мин | Разбейте задачу. На медленном канале повысьте API_TIMEOUT_MS |
| model not found / no access | Неверное имя модели или её нет в вашем плане | /model для повторного выбора. Проверьте устаревшую переменную окружения ANTHROPIC_MODEL |
| Opus is not available with Pro plan | Выбранной модели нет в вашем плане | /model на доступную. После смены плана — /logout→/login |
6. Установка, PATH и обновление
| Симптом | Причина | Исправление |
|---|---|---|
| command not found: claude | Каталог установки не в PATH | Добавьте ~/.local/bin (Win: %USERPROFILE%\.local\bin) в PATH |
| Install fails (HTML error, etc.) | Прокси / региональная блокировка | Homebrew brew install --cask claude-code / WinGet winget install Anthropic.ClaudeCode |
| TLS / SSL certificate verification failed | TLS-инспекция корпоративного прокси / отсутствует CA | Укажите NODE_EXTRA_CA_CERTS=/path/ca.pem. НИКОГДА не задавайте NODE_TLS_REJECT_UNAUTHORIZED=0 |
| Multiple claude installations found | Дубликаты npm/Homebrew/native | Оставьте один, например npm uninstall -g @anthropic-ai/claude-code |
| Баги из старой версии | Не обновлено | claude update (главное исправление, устраняющее множество багов) |
7. Сеть и прокси
Часто встречается в корпоративных сетях и VPN. Сначала проверьте доступность через curl -I https://api.anthropic.com.
| Симптом | Причина | Исправление |
|---|---|---|
| Unable to connect / ECONNREFUSED / ETIMEDOUT | Нет сети / блокировка VPN / прокси не задан | Задайте HTTPS_PROXY=http://proxy:8080. Попросите IT разрешить api.anthropic.com |
| SSL certificate verification failed (corporate) | Самоподписанный перехватывающий сертификат | Получите CA-бандл у IT и задайте NODE_EXTRA_CA_CERTS |
| 403 host_not_allowed (cloud runs) | Вне белого списка облачного окружения | Установите сетевой доступ в Custom и разрешите целевой домен |
8. MCP (подключённые серверы)
С этим вы сталкиваетесь, когда начинаете использовать серверы MCP. Сначала проверьте статус через /mcp.
| Симптом | Причина | Исправление |
|---|---|---|
| Server failed to connect / Pending approval | Сервер упал / недоступен / нужна авторизация | /mcp для статуса. stdio: проверьте, что команда существует и исполняема; HTTP: проверьте URL/заголовки авторизации |
| Tool not found | Подключён, но инструменты не доступны / неверное имя | /mcp для подтверждения количества инструментов, claude mcp get <name> для проверки состояния |
| Reconnection attempts exhausted | Сервер HTTP/SSE недоступен после 5 повторов | Убедитесь, что сервер работает, выполните ручное переподключение в /mcp. Для stdio перезапустите claude |
| MCP server timeout | Запуск >5с и т. п. | MCP_TIMEOUT=10000 claude (мс). Для отдельного сервера: "timeout" в .mcp.json |
9. Разрешения и инструменты
Семейство «спросил разрешение даже в режиме обхода». Ключевой момент: правила deny имеют приоритет над allow и bypass.
| Симптом | Причина | Исправление |
|---|---|---|
| Спрашивает разрешение даже в режиме bypass | Правила deny побеждают; опасные операции всегда запрашивают подтверждение (предохранитель) | Проверьте и скорректируйте правила deny в /permissions |
| Tool execution denied by PreToolUse hook | Хук заблокировал её с кодом выхода 2 | Проверьте хук в .claude/settings.json. Смотрите вывод через claude --debug |
О том, почему bypass всё равно останавливается, см. почему он спрашивает разрешение даже в режиме обхода; о безопасном проектировании разрешений см. режимы разрешений и безопасность.
10. Прочее (thinking / изображения-PDF / IDE)
- thinking blocks cannot be modified (400): известный баг, когда блоки расширенного мышления повреждаются в истории. Дважды Esc → /rewind, иначе новая сессия и
claude update. Подробности: ошибка 400 thinking blocks. - Could not check the pull request status: проблема подключения к GitHub (часто авторизация
gh). Начните сgh auth status. Подробности: ошибка проверки статуса PR. - Image was too large / PDF too large: изображения свыше 8000px по длинной стороне, PDF свыше 100 страниц / 32 МБ отклоняются. Дважды Esc, чтобы удалить вложение; измените размер или читайте по диапазонам строк. Ссылайтесь на большие файлы по пути, а не вставляйте их.
- Расширение VS Code не подключается: убедитесь, что
claude --versionработает в терминале VS Code. Проверьте PATH, перезапустите VS Code, переустановите расширение.
11. Шпаргалка «ошибка → исправление»
| Когда это происходит | Попробуйте сначала это |
|---|---|
| Причина неизвестна / общий случай | claude doctor → /status → /context |
| Внезапно просит войти | /status → (если устаревший ключ) unset ANTHROPIC_API_KEY → /login |
| Упёрлись в лимит запросов | /usage → /model легче → /compact → подождите |
| Prompt is too long | /compact → /clear → читайте большие файлы по диапазонам строк |
| 500/529/тайм-аут | Проверьте status.claude.com → немного подождите → /model |
| command not found: claude | Добавьте ~/.local/bin в PATH |
| Не подключается (корпоративная сеть) | curl -I https://api.anthropic.com → HTTPS_PROXY/NODE_EXTRA_CA_CERTS |
| MCP не подключается | /mcp → проверьте URL/права/команду → MCP_TIMEOUT |
| Запрашивает даже в bypass | /permissions для проверки правил deny |
| Просто хочу, чтобы заработало | claude update (последняя версия исправляет многое) |
Итоги
У Claude Code много ошибок, но первый ход — изолировать причину тремя командами: claude doctor / /status / /context — и это снова сдвигает с места большинство проблем. Самые частые — это четыре семейства: использование/лимиты запросов, переполнение контекста, истёкшая авторизация, сбой подключения MCP — с /usage, /compact, /login и /mcp в качестве первоочередных исправлений.
А легко упускаемый, но сильнейший ход — поддержание актуальности через claude update. Claude Code обновляется быстро, и прошлые баги (например, 400 у thinking blocks) часто исчезают просто за счёт повышения версии. «Застряли — сначала три диагностические команды; если не исправилось — обновитесь до последней версии». Держитесь этого шаблона, и вы перестанете терять время на ошибках.
По теме: ошибка 400 thinking blocks, ошибка проверки статуса PR, экономия токенов в Claude Code, почему он спрашивает разрешение в режиме обхода и что такое MCP.
FAQ
Q. Появилась ошибка — что делать в первую очередь?
A. Запустите claude doctor. Он проверяет установку, настройки, MCP и контекст за один раз. Затем посмотрите /status (текущая авторизация) и /context (что съедает контекст), и обычно вы сможете понять, в чём проблема — в авторизации, контексте или подключении.
Q. Я быстро упираюсь в лимиты запросов. Что помогает?
A. Claude Code потребляет в 10-100 раз больше токенов, чем чат, поэтому вы упираетесь в них раньше, чем ожидаете. Проверьте лимиты и время сброса через /usage, переключитесь на более лёгкую модель через /model, сожмите историю через /compact и отключите неиспользуемые MCP. Если этого недостаточно, рассмотрите более высокий план (Max и т. п.) или дополнительные кредиты.
Q. Пишет «Invalid API key», хотя ключ должен быть верным.
A. Классическая причина — устаревшая переменная окружения ANTHROPIC_API_KEY, переопределяющая вашу подписку. Проверьте через env | grep ANTHROPIC, выполните unset ANTHROPIC_API_KEY (удалите её также из профиля оболочки), затем /login и подтвердите через /status.
Q. Не подключается в моей корпоративной сети.
A. Сначала проверьте доступность через curl -I https://api.anthropic.com. Для прокси задайте HTTPS_PROXY; для TLS-инспекции укажите NODE_EXTRA_CA_CERTS на CA-сертификат. Не используйте NODE_TLS_REJECT_UNAUTHORIZED=0 — это опасно. Правильный путь — попросить IT разрешить api.anthropic.com.
Q. Ничего из того, что я пробую, не работает — последнее средство?
A. Обновитесь до последней версии через claude update. Claude Code обновляется быстро, и известные баги часто исчезают просто за счёт повышения версии. Если по-прежнему не работает, отправьте отчёт через /feedback (включает журнал беседы) в Anthropic.
