Claude Code не работает? Чек-лист: симптом → решение

Когда Claude Code не работает, причина почти всегда одна из пяти: сбой на серверах, зависшая сессия, проблема со входом, исчерпанный лимит или переполненный разговор. Этот чек-лист ведёт вас от симптома к решению — и не требует понимать ни одной строчки кода.

Я Евгений, и я видел десятки нетехнарей, которые при первой ошибке решали, что сломали что-то дорогое. Спойлер: почти никогда. Ошибки в Claude Code приходят с командами восстановления, и порядок проверки важнее технических навыков. Идём по порядку.

1Как проверить, что Claude Code вообще работает?

Диагностики две, и выбор зависит от того, запускается ли Claude. Если запускается — наберите /doctor внутри сессии: он за один проход проверит установку, настройки, MCP-серверы и заполненность контекста. Если `claude` вообще не стартует — запустите доктора из обычного терминала. И прежде чем винить свой компьютер, загляните на status.claude.com: если там сбой, никакие перезапуски не помогут.

claude doctor

2Как починить Claude Code, если он завис?

Сначала нажмите Ctrl+C, чтобы отменить текущую операцию. Если не помогло — закройте терминал целиком. Звучит радикально, но это официальная рекомендация, и вы ничего не теряете: разговор сохранён на диске. Если Claude не завис, а тормозит (вентиляторы воют, ноутбук горячий) — выполните /compact, чтобы ужать разговор, или перезапустите через `claude --safe-mode` и проверьте, не виноват ли какой-нибудь плагин.

claude --resume

3Как активировать Claude Code, если он не пускает внутрь?

«Not logged in», «OAuth token has expired», «Invalid API key» — всё это значит, что Claude не может подтвердить, кто вы. Стандартное лечение — /login. Если ошибка возвращается в той же сессии, сначала /logout, чтобы полностью стереть сохранённый токен, потом снова /login. Коварный случай: забытый API-ключ в окружении может тихо перебивать вашу подписку — выполните /status и посмотрите, какие учётные данные реально используются, потому что переменные окружения всегда побеждают /login.

4Как сделать, чтобы Claude Code работал без постоянных ошибок?

У трёх частых раздражителей три скучных лекарства, и каждый — это отдельный симптом со своей командой, так что их стоит различать, а не воспринимать любое сообщение как одну и ту же катастрофу.

«You've hit your session limit»

Это значит, что лимит тарифа исчерпан — это не ошибка, и ничего не сломано. Выполните /usage, чтобы увидеть точное время сброса лимита, и идите пить чай. Разговор сохранён: после сброса вернитесь командой claude --continue и продолжите с того же места.

«529 Overloaded»

Это значит, что серверы заняты у всех, а не только у вас. Поскольку нагрузка считается по каждой модели отдельно, самый быстрый обходной путь — выполнить /model и переключиться на другую. Если заняты все — подождите минуту: Claude уже сделал несколько повторов, прежде чем показать вам это.

«Prompt is too long»

Это значит, что разговор перерос память Claude. Выполните /compact, чтобы ужать чат до сути, или /clear, чтобы начать с чистого листа — старый чат остаётся доступен через /resume, так что /clear ничего не теряет.

Поиск не находит файлы

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

5А если ошибок нет, но ответы стали хуже?

На это попадаются все. Claude Code не подменяет версию модели втихую — ухудшение ответов обычно означает состояние разговора. Проверьте три вещи: /model (вы на той модели, на которой думаете?), /context (не забита ли память под завязку?) и не зациклился ли чат на ранней неудачной попытке. Лучший трюк из документации: вместо того чтобы поправлять Claude в той же ветке, нажмите Esc дважды или выполните /rewind — откатитесь до неудачного хода и переформулируйте. Исправление на месте оставляет провал в памяти и тянет за собой следующие ответы.

API Error: 500 Internal server error  -> на стороне сервера, повторите через минуту
API Error: Repeated 529 Overloaded    -> перегрузка, смените модель или подождите
Request timed out                     -> повторите; большие задачи дробите
Server is temporarily limiting...     -> короткий троттлинг, не ваш лимит

Сохраните эту страницу, и в следующий раз, когда Claude Code закапризничает, пройдите чек-лист сверху вниз до того, как паниковать. По моему опыту, пункты с первого по четвёртый закрывают 90% случаев у новичков, а оставшиеся 10% — ровно то, для чего придуман /feedback. Вы ничего не ломаете. Вы отлаживаете — а значит, официально уже один из нас.