Если пользоваться Claude Code постоянно, застревать вы будете обязательно. Эта глава — не словарь ошибок. Она нужна, чтобы вы усвоили порядок локализации, ведущий от симптома вниз к причине.
Имея этот порядок, вы сможете отнести к нужной категории даже ошибку, которую видите впервые. Статью про конкретное решение читают уже после.
Что сделать до того, как искать текст ошибки
Застряв, большинство сразу ищет текст ошибки. Это тоже работает, но почти всегда быстрее сначала проверить три вещи.
Если работало, причина не в окружении, а в последнем изменении. Удлинившийся разговор, добавленная настройка, смена сети.
Каждый раз — настройки или окружение. Иногда — загруженность или канал, и нередко причина вообще не на вашей стороне.
На запуске, в момент отправки указания или посреди ответа. Место остановки почти определяет категорию.
Сильнее всего работает CHECK 3. Если понять, на каком месте цикла сбор → действие → проверка из главы 1 всё встало, круг кандидатов сужается разом.
Разложить по пяти категориям
Ошибки Claude Code делятся на пять групп по тому, где сидит причина. Сначала определите свою.
Запускается?
Нет → проблема самого приложения (см. дополнение ниже)
Да
↓
Указание отправляется?
Нет, отклоняется → 1. Аутентификация
Да
↓
Ответ приходит?
Нет, не доходит / обрывается → 2. Соединение
Пишет «лимит» → 3. Лимиты использования
Пишет «слишком длинно» → 4. Контекст
Да
↓
Падает там, где задействован внешний инструмент → 5. Инструменты и расширения
Сделайте по этой развилке ставку и идите в соответствующий раздел ниже. У каждой категории своя форма решения, поэтому смешивать их — верный способ потерять полдня.
1. Аутентификация: вас не признают
Симптом: вам сообщают, что вы не вошли, либо отклоняют учётные данные как недействительные. Отличительная черта — всё встаёт до отправки указания.
Истёк срок сессии / вошли под другим аккаунтом / перепутаны API-ключ и подписка / корпоративная сеть режет трафик аутентификации
Войти заново → проверить, под каким аккаунтом вы вошли → попробовать другой канал (например, раздачу с телефона). Если помогло третье, это категория 2
Эта категория с высокой вероятностью лечится повторным входом, и именно поэтому, когда не помогло, в неё продолжают закапываться. Не вышло с двух попыток — подозревайте категорию 2. Трафик аутентификации тоже идёт через сеть.
2. Соединение: не доходит или обрывается
Самая недопонимаемая категория. Виноваты вовсе не обязательно ваши настройки.
Симптомы делятся на три вида.
Прокси, TLS, блокировка корпоративной сетью. Проблема на стороне окружения, и её видно при переходе на другой канал.
Сервис перегружен. Правильный ответ — подождать, а от ковыряния в настройках останутся одни побочные эффекты.
Соединение падает во время длинного ответа. Иногда перестаёт воспроизводиться, если разбивать вывод на короткие части.
У каждого есть своя статья: устранение ошибок сети, прокси и TLS, ошибки 529 Overloaded и 500 и Connection closed mid-response.
Не пытайтесь лечить перегрузку настройками. Если в попытке воспроизвести «иногда падает» поменять настройки в десяти местах, станет непонятно, вы починили или время само всё решило. Сначала выждите и повторите, чтобы понять, случается ли это каждый раз.
3. Лимиты использования: квота израсходована
Категория, где вам сообщают, что лимит достигнут. Это не ошибка, а так задумано, поэтому чинить надо не настройки, а манеру работы.
Здесь важно усвоить, что квота не одна. Отдельно существуют квота на коротком периоде и квота на более длинном. Даже когда одна восстановилась, при исчерпанной второй всё останется стоять. «Только что отпустило и снова встало» — обычно как раз про это.
Подробности собраны в статьях что делать при usage limit reached и правда о раннем сбросе недельного лимита, где недельная квота проверялась на практике. О том, как уменьшить сам расход, — глава 7.
4. Контекст: слишком длинный ввод
Категория, где вам отказывают со словами «слишком длинно». Считайте, что это разговор про контекстное окно из главы 1, проявившийся как симптом.
Свернуть историю либо оборвать и начать заново. Базовое правило — сворачивать на стыке работ.
Не вставляйте целиком огромные файлы и логи. Отдавайте только нужный фрагмент или дайте найти его самому.
Про устранение симптома — Prompt is too long: причины и решения, а про то, когда именно сворачивать, — Стоит ли запускать /compact вручную.
Отдельно бывают случаи, когда вывод останавливают как нарушающий правила. К длине это отношения не имеет, так что не путайте: это другой вид.
5. Инструменты и расширения: подключённое не работает
Категория, которая возникает после добавления MCP-серверов или внешних инструментов. Локализуется просто: смотрим, помогает ли отключение.
Отключить все расширения
→ помогло : причина в расширениях. возвращаем по одному и находим виновника
→ не помогло: расширения ни при чём. возвращаемся к категориям 1-4
Когда стало ясно, что дело в расширении, — в статью Ошибки подключения MCP: причины и решения. Почти всегда это либо формат конфигурации, либо путь в команде запуска, либо разрешения.
И не подозревайте здесь ум самого Claude. Если расширение не подключено, Claude ведёт себя так, будто такого инструмента не существует. «Я же сказал, а он не делает» очень часто оказывается вопросом подключения.
Дополнение: само приложение не запускается
Если вы пользуетесь не терминальной версией, а настольным приложением, всё может встать ещё до того, как дело дойдёт до Claude Code. Это не относится ни к одной из пяти категорий, поэтому в схему локализации не вошло.
Разновидность, требующая восстановления в Windows, разобрана в статье «Не удаётся открыть это приложение»: как восстановить Claude Desktop в Windows, а разновидность с зависанием на отрисовке — в статье почему зависает на GPU process gone и что делать.
Пять ходов, если всё равно не выбраться
Когда категория не определяется или определилась, но не чинится. Пробуйте сверху вниз: они расставлены от самых дешёвых.
Всё, что идёт от контекста, на этом и заканчивается. Самый дешёвый ход.
Перегрузка и лимиты решаются одним этим. Настройки не трогать.
Если помогло, причина точно в сети на стороне окружения.
Локализация категории 5. Возвращать по одному. Возврат скопом бессмыслен.
Повторить то же в пустом каталоге. Не воспроизводится — причина на стороне проекта.
Меняйте по одному за раз. В тупике от нервов хочется поменять сразу несколько вещей, но тогда вы так и не узнаете, что именно сработало, и при следующем таком же симптоме начнёте с нуля. Выяснить один сработавший ход в долгую несравнимо дешевле.
Если удобнее искать по самому тексту ошибки, указателем послужит статья частые ошибки и способы их устранения.
Итоги
- До поиска текста ошибки посмотрите на три вещи: «работало ли только что», «каждый раз ли», «где именно встало»
- Причины делятся на пять категорий: аутентификация, соединение, лимиты использования, контекст, инструменты. Не смешивайте их
- При перегрузке и лимитах правильный ответ — подождать. От ковыряния в настройках останутся одни побочные эффекты
- Квота не одна. Короткий и длинный период существуют отдельно, поэтому после восстановления всё может встать снова
- Категория расширений локализуется одним движением: помогает ли отключить всё. Возвращать — по одному
- Если не выбраться, пять ходов от дешёвого к дорогому. И менять по одному за раз
Научившись выбираться из тупиков, вы подходите к вопросу «насколько отдавать». Переходите к главе 5 «Разрешения и безопасность».