Claude Code завис или не отвечает: как найти причину

Если Claude Code завис, долго думает или не отвечает, сначала выясни, на каком этапе остановилась работа: запуск программы, запрос к модели, ожидание подтверждения, выполнение команды или подключение MCP. От этого зависит следующий шаг. Ниже — порядок диагностики без переустановки всего окружения и учебный пример команды, которая превышает время ожидания.

Определи, что именно ожидает Claude Code

Посмотри последнюю видимую строку и состояние процесса. Агент может ожидать разрешения на команду или ответ инструмента. Само время ожидания ещё не показывает причину.

Запиши команду запуска, версию, момент возникновения проблемы и короткий текст ошибки. Не публикуй содержимое приватных логов целиком: для диагностики обычно достаточно сообщения и обезличенной последовательности действий.

Если агент отвечает, но созданный сайт или программа работают неправильно, начни с поиска ошибки в проекте. Здесь мы разбираем работу самого Claude Code и его инструментов.

Проверь установку и состояние окружения

Официальная документация Claude Code по устранению проблем описывает диагностику установки и настроек. В рабочей сессии доступна команда /doctor. Если интерактивная сессия не запускается, проверь CLI:

claude --version
claude doctor

Прочитай результат перед исправлением. Если отсутствует программа или путь, решай эту конкретную проблему по документации своей платформы. При ошибке сервиса проверь официальную страницу состояния Claude. Повторная установка не покажет, обработал ли провайдер запрос.

Название команды и возможности могут зависеть от установленной версии. Если команда отсутствует, начни с claude --help и справки соответствующей версии. В этом материале команды сверены с официальной документацией 6 октября 2026 года; запуск самого Claude CLI в среде подготовки статьи не проверялся.

Если зависла команда или hook

В официальной справке по hooks описаны обработчики событий рабочего процесса. Один из вариантов hook — команда, которая запускается при событии. Если она ждёт ввод, обращается к недоступному адресу или выполняется слишком долго, ожидание может выглядеть как остановка агента. По последней строке выясни, какая команда стартовала, и проверь её отдельно в безопасной учебной папке.

Для объяснения используем простой локальный пример. Он относится к выполнению команды и не воспроизводит сбой сервиса Claude:

import subprocess
import sys

try:
    subprocess.run(
        [sys.executable, "-c", "import time; time.sleep(30)"],
        timeout=1,
        check=True,
    )
except subprocess.TimeoutExpired:
    print("Команда превысила лимит одной секунды")

В проверке учебная команда превысила лимит и вызвала TimeoutExpired. После замены её на короткую команду print('ready') выполнение закончилось в том же лимите. Здесь известна причина ожидания: программа специально спит 30 секунд. Для реального hook потребуется проверить его код, входные данные и обращение к внешним сервисам.

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

Если проблема связана с MCP или настройками проекта

В открытой сессии /mcp помогает проверить состояние подключённых серверов; действия описаны в справке по MCP. Если проблема возникает после одного инструмента, сохрани его название и короткую ошибку. Проверь, повторяется ли она на простом разрешённом чтении. Это позволяет отделить общий запуск Claude Code от одного подключения.

В справочнике CLI также описан claude --safe-mode для диагностического запуска без пользовательских расширений, MCP, hooks и других настроек. Используй его как временный способ сравнить поведение. Если в таком запуске простой запрос выполняется, проверяй изменённые настройки по одной, сохраняя исходную конфигурацию. Успешная проверка в этом режиме сама по себе не подтверждает исправление обычного рабочего сценария.

Постоянные правила проекта удобно держать в CLAUDE.md. Для диагностики сравни актуальные правила, настройки и последние изменения. Не удаляй файл целиком ради проверки одной команды.

Если работа замедлилась в длинной сессии

Когда проблема появилась после большого объёма диалога, документация рекомендует уменьшить контекст, в том числе через /compact. Перед этим зафиксируй задачу, изменённые файлы и выполненные проверки, чтобы продолжение оставалось понятным.

Если большое потребление ресурсов связано с проектом, проверь объём файлов и генерируемые каталоги. Список исключений должен соответствовать проекту: исключение нужных исходников ухудшит работу агента. Простой запрос в небольшой учебной папке поможет получить точку сравнения.

Повторяй исходный сценарий после каждого исправления. Признаки результата: CLI запускается, короткий запрос получает ответ, проблемная команда завершается, а рабочая задача проходит свою проверку. Сохрани версию и способ исправления рядом с проектом.

Для первого полного цикла разработки есть практикум Claude Code, для сохранения изменений — основы Git. На корпоративном обучении «Автомато» можно выстроить такой порядок диагностики для команды и согласованного окружения.