раздел 10 · подстраница 6

Что делать когда сломалось

Claude Code - живой инструмент с регулярными апдейтами, иногда что-то ломается. Этот список покрывает 90% типовых проблем. Если ваш баг здесь не нашёлся - в конце ссылка на issues, куда нести.

Claude не отвечает / висит на "thinking"

Признак: после промпта индикатор крутится дольше минуты, ответа нет.

Что делать:

  1. Нажмите Esc - прервёт текущий запрос.
  2. Проверьте сеть: curl -I https://api.anthropic.com/v1/messages. Если 403/timeout - блокировки/прокси. Из России включите HTTPS-прокси.
  3. Перезапустите Claude (Ctrl+C, потом claude).
  4. Проверьте статус API: status.anthropic.com.

Потерял контекст / Claude забыл, о чём говорили

Признак: Claude отвечает невпопад, ссылается на несуществующие файлы, забывает свои же предыдущие инструкции.

Что делать:

  1. /resume - выбрать прошлую сессию из списка. Контекст восстановится.
  2. Если /resume не помог - сессия была сброшена. Перечитайте git diff и кратко пересоберите контекст в первом сообщении новой сессии.

Чтобы реже терять:

  • В длинных сессиях делайте /compact каждые 1-2 часа
  • Важные решения записывайте в CLAUDE.md или NOTES.md проекта

Claude не видит файл

Признак: пишет "файл не найден" / "не могу прочитать" на файл, который точно существует.

Чек-лист:

  1. .gitignore - Claude по умолчанию игнорирует игнорируемое git'ом. Проверьте git check-ignore <path>. Если нужно - явно укажите @<path> в промпте, это переопределяет.
  2. Симлинки - не всегда отрабатывают. Передайте абсолютный путь после realpath.
  3. Права доступа - ls -la <file>. Если read-only для текущего юзера - нужны права.
  4. Кейс - на macOS файловая система case-insensitive, но git case-sensitive. Component.tsx и component.tsx могут различаться.

Самый надёжный способ - @<path/to/file> в промпте. Это явное упоминание, Claude обязательно прочитает.

MCP-сервер не отвечает

Признак: при попытке использовать MCP-инструмент - таймаут или "tool not available".

Что делать:

# Список подключённых MCP
claude mcp list

# Перезапустить конкретный MCP
claude mcp remove <name>
claude mcp add <name> ...

# Полный сброс
rm -rf ~/.claude/mcp-cache

Если MCP-сервер - сторонний npm-пакет, проверьте, что он запускается отдельно:

npx -y @<vendor>/<mcp-server> --help

Если падает там - проблема не в Claude, а в самом MCP.

Долгие сборки / непонятно, что Claude делает

Признак: Claude запустил какую-то длинную операцию, прогресса не видно.

Что делать:

claude --debug

Запустите Claude с флагом --debug - в stderr полетят детальные логи всех tool-вызовов. Сразу видно, где он застрял.

Альтернатива - в активной сессии:

> что ты сейчас делаешь? покажи статус

Иногда Claude отчитается, что ждёт долгую команду или висит на сети.

Bash-команда сломала систему / удалила лишнее

Признак: Claude выполнил что-то, что не должен был.

Что делать:

  1. Не паникуйте: git status - что точно изменилось?
  2. git stash или git reset --hard HEAD - откат локальных правок.
  3. Файлы вне репо: восстановление из Time Machine / снэпшотов / бэкапа.
  4. Включите plan mode и режим разрешений default - не позволяйте bypass-permissions для незнакомых задач.

Профилактика - всегда работайте в git, всегда коммитьте чекпоинты.

"Rate limit exceeded"

Признак: API возвращает 429.

Что делать:

  • На API-ключе: подождать минуту, лимиты сбрасываются. Если повторяется - повысить лимит в console.anthropic.com.
  • На подписке Pro/Max: значит закончилась дневная квота. Альтернатив две - ждать (часы) или временно переключиться на API-ключ.

"Permission denied" при правке файла

Признак: Claude хочет править файл, но получает ошибку.

Проверка:

ls -la <file>
# права? владелец?

Если файл создан под root (например, через docker) - chown на текущего юзера. Если иммутабельный (на macOS) - снять флаг через chflags nouchg.

Curl/sed зависает в Bash-вызовах

Известная проблема - некоторые интерактивные команды (curl без -s, less, htop) висят, потому что нет TTY. Claude об этом знает, но иногда забывает.

Профилактика:

  • В bash-командах всегда -s для curl, cat вместо less
  • В CLAUDE.md проекта явно укажите: "никогда не используй интерактивные команды без флага -s или эквивалента"

Куда жаловаться

Если ничего из этого не помогло:

  1. Проверьте уже зарепорченное: github.com/anthropics/claude-code/issues - возможно ваш баг уже найден и обходится известным workaround'ом.
  2. Создайте новый issue с шагами воспроизведения, версией (claude --version), ОС, и логом из --debug.
  3. Discord-сообщество: discord.gg/anthropic - быстрые ответы по типовым вопросам.

Антипаттерны

  • Молча терпеть. Если Claude месяц подряд глючит на одной и той же операции - заведите issue, иначе никто не починит.
  • Делать rm -rf ~/.claude "для надёжности". Снесёте свой CLAUDE.md и историю.
  • Винить Claude, когда виноват MCP/сетевой прокси. Сначала проверьте, что без MCP всё работает.

Полезные ссылки