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

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

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

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

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

claude doctor

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

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

claude --resume

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

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

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

У трёх частых раздражителей три скучных лекарства. «You've hit your session limit» — лимит тарифа исчерпан: /usage покажет, когда он сбросится, идите пить чай. «529 Overloaded» — серверы заняты у всех, а не только у вас: выполните /model и переключите модель, нагрузка считается по каждой модели отдельно. «Prompt is too long» — разговор перерос память Claude: /compact ужмёт его в выжимку, а /clear начнёт с чистого листа (старый чат остаётся доступен через /resume).

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

На это попадаются все. 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. Вы ничего не ломаете. Вы отлаживаете — а значит, официально уже один из нас.