Claude Code зависает, застревает или перестаёт отвечать: как выяснить, где он застрял, и выйти из этого состояния

Где он застрял? Изучите экран, затем процесс

# in the session
Esc            # cancel the current tool or turn
Ctrl+C (twice) # abort the turn / exit
# from another terminal
ps aux | grep -E "claude|node" | grep -v grep     # child processes still running?
top -o cpu       # is claude spinning or idle?
claude --debug   # next time: timestamps for every request and tool call
claude -c        # resume the last session after a kill

Низкая загрузка CPU при зависшем запросе означает ожидание чего-то внешнего: сетевого потока, сервера MCP, дочернего процесса или невидимого вам запроса. Максимальная загрузка CPU означает внутреннюю работу: разбор огромного результата инструмента, перебор вариантов в регулярном выражении, загрузку большого сеанса. Постоянный рост потребления памяти означает, что результат инструмента или файл сеанса целиком загружается в память.

Известные причины из трекера

• `/rewind` зависает, `Ctrl+C` игнорируется, требуется `kill -9` (#53011, 21 реакций, в сессиях любого размера на сборках 2.1.1xx). Инженер Anthropic не смог воспроизвести проблему на 2.1.233, поэтому сначала обновитесь; на старой сборке завершите процесс и возобновите сессию с помощью claude -c вместо отката.
• Сессии Remote Control зависают во время выполнения, и только локальный `Esc` возвращает их к работе (#51267, открыта). Любой инструмент или подпроцесс, который блокирует выполнение, замораживает всю удалённую сессию без возможности отмены удалённо; делайте такие сессии короткими и избегайте инструментов, которые могут запрашивать ввод.
• Запрос аутентификации MCP зависает на `Enter` (#42707, открыта). Пройдите аутентификацию на сервере с помощью отдельной команды claude mcp или браузера, затем перезапустите сессию.
• `grep` через встроенный механизм поиска поглощает всю память (#54394): в нативных сборках каждый вызов оболочки grep выполняется внутри процесса claude с собственной кучей V8; регулярное выражение с возвратами на длинной минифицированной строке раздувает потребление памяти до гигабайтов, и механизм завершения процессов при нехватке памяти уничтожает вместе с ним всю сессию — как на WSL2, так и на Linux. Избегайте регулярных выражений с неограниченным перебором при поиске в минифицированных файлах, исключайте результаты сборки и node_modules, либо установите системный ripgrep и вызывайте его явно.
• Бесконечный цикл повторных попыток при `400 thinking blocks cannot be modified` (#63231) — история разговора некорректна, и каждая повторная попытка завершается той же ошибкой. /rewind до состояния перед этим ходом или /clear; см. руководство по 400.
• **Облачные / запланированные запуски застревают на этапе *Настройка облачного контейнера*** (#53691, #54528) — проблема на стороне сервиса; локально ничего исправлять не нужно, отмените запуск и проверьте status.claude.com.
• Возобновление большой сессии занимает минуты — при запуске заново воспроизводится история сессии. Возобновляйте конкретную нужную сессию (claude -r), а не самую большую, и позволяйте сжатию сокращать огромные истории.

Зависание при запуске

Пустой экран сразу после claude без приглашения к вводу обычно означает, что первый вызов API не возвращает ответ: переменная прокси указывает на неработающий прокси, мешают VPN или DNS либо недоступен ANTHROPIC_BASE_URL. Выполните проверку с помощью curl из руководства по ошибкам подключения, затем claude doctor. Если запуск медленный, но приглашение к вводу всё же появляется, причина в запуске серверов MCP; claude mcp list и удалите те, которые превышают время ожидания.

Дочерние процессы, которые никогда не завершаются

Инструмент оболочки, который открывает редактор, ждёт пароль, непрерывно читает журнал или запускает сервер разработки, не возвращает управление, и ход ждёт его завершения. Попросите агента запускать серверы в фоновом режиме и добавлять --no-pager, -y или < /dev/null там, где команда может запросить ввод. Если это уже произошло, Esc отменяет выполнение инструмента; если дочерний процесс игнорирует отмену, завершите его по PID из другого терминала, и ход продолжится с сообщением об ошибке.

Высокое потребление памяти и CPU

• Результаты работы инструментов хранятся в памяти и на диске в течение сессии; чтение файла размером 200 МБ создаёт сессию размером 200 МБ. Читайте только нужные части.
• Множество параллельных субагентов многократно увеличивает все затраты; CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY=2 на маломощных компьютерах.
• Эмуляторы терминала с медленной отрисовкой (некоторые консоли Windows, удалённый tmux по каналу с низкой пропускной способностью) создают впечатление, что потоковый вывод завис; claude --debug показывает, продолжают ли поступать токены.
• Если потребление памяти растёт во время простоя, проверьте, не остались ли процессы claude от аварийно завершённых сессий IDE, и завершите их (процесс завершился с кодом 1 описывает случай с оставшимися процессами в Windows).

Когда причина в API, а не в клиенте

Если сессия на каждом ходе зависает в одном и том же месте, показывает небольшой индикатор загрузки, а затем строку о повторной попытке, причина в медленном или обрывающемся соединении с API, а не в ошибке клиента: 529 — перегрузка, ограничение запросов на стороне сервера или сброс соединения. При работе через шлюз (ANTHROPIC_BASE_URL=https://aiprimetech.io) запросы с перегруженной учётной записи вышестоящего провайдера переключаются на другую, что сокращает именно такие задержки.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза.