Разработчики, работающие с Claude Code, наверняка сталкивались с такой картиной: в терминале появляется строка «Symbioting… (3m 12s · ↓ 5.7k tokens)», индикатор выполнения замирает, и в течение нескольких минут не появляется никаких новых данных. Вы пробуете отправить сообщение «Ты здесь?», и, к удивлению, Claude мгновенно оживает и продолжает выполнять задачу.
Этот странный опыт «зависания с последующим воскрешением» кажется магией, но на самом деле он вызван наложением нескольких проблем: потокового протокола Anthropic, механизмов тайм-аута и управления контекстным окном. В этой статье, основанной на официальной документации по устранению неполадок Claude Code и данных из GitHub Issues #25979, #24688, #39718, #25286, #25539, #51659, мы разберем реальные причины зависаний и предложим 7 способов восстановления и 5 стратегий профилактики.
Ценность материала: после прочтения вы поймете, что скрывается за каждым глаголом в индикаторе загрузки, почему отправка сообщения иногда «оживляет» процесс, когда необходимо принудительно завершать работу через Ctrl+C и как свести частоту зависаний практически к нулю.
Полный разбор индикаторов состояния Claude Code
Чтобы разобраться с проблемой «зависания», первым делом нужно научиться читать строку состояния, которую Claude Code выводит в терминале. Информация в примере Symbioting… (3m 12s · ↓ 5.7k tokens) — это структурированные данные, где каждая часть имеет свое значение.
| Поле | Пример значения | Значение |
|---|---|---|
| Глагол спиннера | Symbioting… |
Описание текущего этапа (антропоморфное), можно настроить с версии 2.1.23 |
| Время ожидания | 3m 12s |
Общее время, прошедшее с начала текущего этапа |
| Направление потока | ↓ или ↑ |
↓ означает получение данных от API, ↑ означает отправку |
| Счетчик токенов | 5.7k tokens |
Количество токенов, загруженных/отправленных на данный момент |
В Claude Code встроено 187 стандартных глаголов для спиннера, таких как Befuddling, Ruminating, Accomplishing или Symbioting. Они нужны лишь для того, чтобы сделать ожидание более «живым», и не несут никакой технической нагрузки. Начиная с версии 2.1.23, появилась настройка spinnerVerbs, и сообщество уже создало более 1900 пользовательских наборов глаголов.
Ключ к пониманию того, действительно ли Claude Code завис, заключается не в глаголе, а в двух вещах: растет ли время ожидания и изменяется ли счетчик токенов. Если через 30 секунд после отметки «3m 12s» время меняется на «3m 42s», а счетчик токенов замер на 5.7k, можно с уверенностью сказать, что потоковый ответ остановился.
Если вы используете Claude API через сервис-прокси API, такой как APIYI (apiyi.com), значения полей в строке состояния будут идентичны официальным, поэтому вы можете использовать ту же методику диагностики для поиска проблем.
6 основных причин, почему Claude Code «зависает»
Понимание индикаторов состояния помогает точно определить причину проблемы. Ниже приведены 6 основных причин, отсортированных по частоте возникновения; они покрывают более 90% реальных случаев, описанных в трекере GitHub Issues.
Причина 1: Тихий разрыв потоковой передачи API
Это самая частая и скрытая причина, соответствующая GitHub Issue #25979. HTTP-клиент Claude Code не имеет механизма read timeout. Если вышестоящий API перестает отправлять пакеты в процессе передачи, процесс зависает в состоянии ядра epoll_wait, ожидая новых данных. Индикатор (spinner) в интерфейсе продолжает вращаться, но счетчик токенов не растет. Типичные причины: сетевые задержки при работе через границу, мультиплексирование tmux, обрывы SSH-соединений и т.д.
Причина 2: Сброс соединения из-за слишком большого payload при вызове инструментов
Соответствует Issue #39718. Когда модель дает команду Claude Code выполнить инструмент, генерирующий огромный объем вывода (например, Write для файла на сотни тысяч строк), ОС принудительно сбрасывает (reset) HTTP-соединение, если в течение 5 минут не было передачи полезных данных. Claude Code не перехватывает эту ошибку, поэтому в интерфейсе продолжает отображаться spinner. Такие зависания обычно происходят ровно через 5 минут.
Причина 3: «Трэшинг» автоматического сжатия (thrashing)
Когда контекстное окно Claude Code почти заполнено, запускается процесс автосжатия. Если огромный файл или вывод инструмента после сжатия сразу же считывается обратно в контекст, это вызывает циклическое сжатие, и в итоге система останавливается с сообщением Autocompact is thrashing. До появления этого сообщения интерфейс выглядит так, будто приложение зависло.
Причина 4: Использование контекстного окна более 80%
В официальной документации указано, что при заполнении контекста более чем на 80% время отклика значительно увеличивается, что в некоторых сценариях выглядит как длительное отсутствие ответа. Признак этого «ложного зависания» — счетчик токенов продолжает медленно расти, но скорость роста в разы ниже нормальной.
Причина 5: Ошибки в настройках, вызывающие «замирание» при запуске
Соответствует Issue #31049, #29652 и др. Например, если параметр enableAllProjectMcpServers: true заставляет загружать множество локальных MCP-серверов или в additionalDirectories указан некорректный префикс пути вроде //C:/, Claude Code может зависнуть при запуске. Обычно это происходит в первые секунды открытия новой сессии.
Причина 6: Зависание строки состояния (ответ получен, но UI не обновился)
Соответствует Issue #25539. В некоторых версиях Claude уже вернул полный результат, но spinner в терминале не исчез и продолжает крутиться. Если вы нажмете Enter или отправите новое сообщение, Claude немедленно начнет работу — он не завис, просто интерфейс «обманывает» вас.
При диагностике сначала проверяйте, растет ли счетчик токенов. Если вы используете APIYI (apiyi.com) в качестве сервиса-прокси для API Claude, вы можете заглянуть в логи платформы, чтобы проверить, вернул ли запрос статус 200 OK, и сопоставить это с состоянием в интерфейсе Claude Code.
Почему одно сообщение может «оживить» Claude Code
Многие пользователи заметили своего рода «инженерное чудо»: Claude Code зависает на 3 минуты, но стоит отправить сообщение вроде «Ты здесь?» или просто нажать Enter, как он тут же продолжает выполнять задачу. Этот феномен можно объяснить на уровне протоколов.
Первый случай — это «зависший» статус (причина 6). Claude на самом деле уже завершил ответ, но интерфейс не убрал индикатор загрузки (spinner). В этот момент ваше новое сообщение напрямую обрабатывается как следующий промпт, что выглядит как «оживление», хотя по сути это просто продолжение работы.
Второй случай — задержка потокового ответа (причина 1). Когда Claude Code получает новый ввод, он принудительно закрывает текущее состояние ожидания, очищает незавершенный запрос и начинает новый HTTP-запрос. Новый запрос отправляется вместе с полной историей сессии, и модель продолжает ответ с того места, где остановилась, поэтому внешне это выглядит так, будто он «продолжил работу».
Третий случай — MCP-сервер или вызов инструмента зависли в ожидании ответа от нижестоящего звена. Новое сообщение заставляет Claude Code принять решение о новом вызове инструмента, что косвенно позволяет обойти зависший запрос.
Важно подчеркнуть: отправка сообщения — это не панацея. Если зависание вызвано тем, что фоновый процесс перешел в состояние «мертвого ожидания» (например, поздняя стадия причины 2), сообщение просто попадет в очередь ввода, но не будет обработано. В таком случае поможет только Ctrl+C или закрытие терминала. При использовании сервиса-прокси API APIYI (apiyi.com) вероятность «оживления» через сообщение выше, так как такие платформы обычно сбрасывают соединения по таймауту быстрее, чем официальные эндпоинты.
7 способов восстановления при зависании Claude Code
Разным причинам соответствуют разные методы восстановления. В таблице ниже 7 наиболее эффективных способов отсортированы по степени «инвазивности» — от легких к радикальным.
| Метод | Команда | Причина | Потеря контекста |
|---|---|---|---|
| Отправить сообщение | Ввод текста | 1 / 6 | Нет |
| Прервать операцию | Ctrl+C |
1 / 2 / 3 | Нет |
| Диагностика | /doctor |
Любая | Нет |
| Сжать контекст | /compact |
3 / 4 | Часть истории в резюме |
| Очистить сессию | /clear |
4 (критично) | Да |
| Перезапуск терминала | claude --resume |
1 / 2 (критично) | Нет |
| Принудительное завершение | kill -9 <pid> |
1 / 2 (невосстановимо) | Текущий шаг |
Рекомендуемый порядок действий: «от простого к сложному». Сначала попробуйте нажать Enter или отправить любое сообщение; если не помогло — используйте Ctrl+C для отмены текущего шага; если терминал совсем не реагирует, закройте его и используйте claude --resume, чтобы восстановить сессию.
/doctor — это официальная команда диагностики от Anthropic. Она проверяет установку, файлы настроек, список MCP-серверов, использование контекстного окна и другие ключевые показатели, после чего обычно дает конкретные рекомендации по исправлению. Если в выводе указано Context: 87%, почти наверняка причина в нехватке контекста (причина 4), и команда /compact сразу поможет.
Для длительных задач рекомендуем заранее добавить в рабочий процесс регулярное использование /compact, чтобы удерживать контекст ниже 60%. Кроме того, при вызове Claude через платформу APIYI (apiyi.com) можно выделить отдельные квоты для основного процесса Claude Code и MCP-серверов, что упростит поиск источника проблем.
5 лучших практик по предотвращению зависаний Claude Code
Поиск неисправностей — это лишь «тушение пожаров», а по-настоящему стабильный рабочий процесс строится на профилактике. Эти 5 практик, основанные на анализе первопричин из множества GitHub Issue, помогут свести вероятность зависаний практически к нулю.
-
Поблочное чтение больших файлов. Прямое чтение файлов размером более 1 МБ почти наверняка создаст избыточную нагрузку на контекстное окно. Используйте двухэтапный подход: сначала
ls -la, чтобы узнать размер, а затем чтение черезReadс параметрамиoffset/limit. Это поможет избежать первопричины №4. -
Делегирование сложных задач субагентам. Субагенты Claude Code имеют собственное контекстное окно. Перекладывая на них генерацию большого количества файлов или пакетную правку кода, вы предотвращаете переполнение основного контекста.
-
Отключение подозрительных MCP-серверов. Каждый добавленный MCP-сервер повышает риск «зависания» при запуске. Оставьте в настройках только те, которыми пользуетесь ежедневно — это значительно снизит вероятность возникновения первопричины №5.
-
Настройка таймаутов модели и чтения. Проверенный метод сообщества — установка
STREAM_READ_TIMEOUT_MSна 120 секунд и использование внешнего процесса-сторожа (watchdog), который автоматически перезапускает Claude Code, если JSONL-поток перестал обновляться. Это крайне эффективно против первопричины №1. -
Использование стабильных API-каналов. Трансграничные вызовы, домашние интернет-провайдеры и использование tmux могут увеличивать вероятность разрывов потока. Простой способ — использовать агрегированные сервисы-прокси API, такие как APIYI (apiyi.com), для вызова моделей серии Claude. Это позволяет направлять TCP-соединения через стабильные узлы, что снижает частоту возникновения первопричины №1.
Команды, внедрившие эти 5 правил, отмечают, что количество зависаний сократилось с 5–10 раз в неделю до менее чем одного, а среднее время восстановления уменьшилось с 5–10 минут до нескольких секунд.
Часто задаваемые вопросы
Q1: Означает ли смена глаголов в спиннере, что Claude выполняет разные действия?
Нет. 187 стандартных глаголов — это просто случайные антропоморфные фразы, которые никак не связаны с реальным состоянием Claude. Чтобы понять, что происходит, смотрите на счетчик токенов и время ожидания.
Q2: Теряется ли контекст после нажатия Ctrl+C?
Нет. Ctrl+C отменяет только текущую незавершенную итерацию, весь сеанс сохраняется. Если Claude Code не реагирует на Ctrl+C, нажмите еще раз или закройте терминал, а затем восстановите сессию командой claude --resume.
Q3: Часто ли Claude Code зависает при работе из РФ?
Трансграничные сети — одна из главных причин разрыва потока. Рекомендуется использовать агрегированные сервисы-прокси API, такие как APIYI (apiyi.com), для вызова моделей Claude. Стабильные узлы прокси поддерживают долгоживущие соединения с Anthropic, что значительно снижает вероятность зависаний для разработчиков.
Q4: Что делать, если я вижу сообщение `Autocompact is thrashing`?
Немедленно остановите текущую задачу и используйте команду с фокусом, например /compact keep only the plan and the diff, чтобы очистить контекст от больших объемов исходных данных. Если это не помогло, начните новый сеанс или используйте субагента для чтения больших файлов.
Q5: Можно ли изменить глаголы в спиннере самостоятельно?
Да. Добавьте поле spinnerVerbs в файл ~/.claude/settings.json. Режимы могут быть default, append или replace в сочетании с массивом строк. В сообществе доступны готовые наборы из 88 тем и более 1900 глаголов.
Итоги
Суть «зависаний» Claude Code кроется в наложении проблем трех подсистем: протокола потоковой передачи, управления контекстом и интеграции MCP в граничных сценариях. Если разобраться в 4 полях индикатора состояния, запомнить 6 основных причин и 7 способов восстановления, то «необъяснимая магия» превратится в понятные технические сбои.
На практике рекомендуем довести методы восстановления до автоматизма: сначала отправьте сообщение, затем нажмите Ctrl+C, выполните /doctor и, в крайнем случае, перезапустите терминал с помощью claude --resume. В сочетании со стабильным сервисом-прокси API и пятью профилактическими мерами (удержание контекста ниже 80%, делегирование работы с большими файлами subagent-ам и использование стабильных каналов через APIYI apiyi.com) вы сможете самостоятельно устранять большинство зависаний за считанные секунды.
Автор: Техническая команда APIYI
Связь: Получите доступ ко всей линейке моделей Claude и стабильному сервису-прокси для Claude Code через APIYI apiyi.com
Дата обновления: 13.05.2026
