← Все гайды

Вдвоём · Гайды

Claude Code не работает: разбор частых ошибок

⏱ 5-6 минут чтения 🛠 Для новичков 🧩 5 ситуаций
1
частое

«App unavailable in your region»

Это не поломка установки. Claude Code установлен верно, вопрос в доступе к аккаунту из России.

Работает без VPN у большинства, но не у всех: зависит от провайдера и текущей блокировки. Три честных варианта: попробовать без VPN, поставить свой VPN-сервер с иностранной картой, платить за токены напрямую через console.anthropic.com.

Подробный разбор всех трёх вариантов, с плюсами и минусами каждого: в гайде «С нуля до работающего Claude Code», станция 5.
2
временное

Лимит сообщений исчерпан

Не бан и не ошибка, обычное ограничение тарифа.

Claude Code
You've reached your usage limit
Limit resets in 2h 14m

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

3
по существу

Агент сделал не то, что нужно

Самая частая причина: задача была сформулирована слишком широко.

  1. Не пытайся чинить руками поверх того, что сломал агент, сначала попроси его вернуть как было: «отмени последнее изменение»
  2. Переформулируй задачу конкретнее: что именно должно получиться, а не общее направление
  3. Для важных рабочих версий используй git: тогда «откатить» можно одной командой, а не искать вручную, что изменилось
Частая ошибкаПросить исправить ошибку, не показав саму ошибку. Скопируй точный текст сообщения из терминала, агент чинит по нему быстрее и точнее, чем по пересказу своими словами.
4
техническое

«Команда не найдена»

node, npm или claude не найдены, хотя вроде бы всё установил.

Терминал
claude
'claude' is not recognized as an internal or external command

Почти всегда решается перезапуском терминала (или всего компьютера): после установки системе нужно заново подхватить путь к новой программе. Если не помогло, переустанови по инструкции ещё раз, это безопасно и не сломает уже сделанное.

5
реальный случай

Антивирус удаляет файлы Claude Code

С нами так было по-настоящему, не выдумка для примера.

Kaspersky System Watcher в какой-то момент помечал файл node.exe как ложную угрозу («PDM:Trojan.Win32.Generic») и тихо удалял его прямо во время установки пакетов. Со стороны выглядело как необъяснимая поломка: всё вроде поставили, а через минуту команды снова «не найдены».

Как понялиПроверили карантин антивируса, файл был там. Решение: на время установки пакетов ставить защиту на паузу, затем включать обратно. Не выключать антивирус насовсем, только точечно на пару минут установки.

Быстрая шпаргалка

Что видишьЧто делать
App unavailable in your regionНе баг установки, вопрос доступа: см. станцию 1
Usage limit reachedПодожди, лимит обновляется каждые несколько часов
Агент сломал рабочий кодПопроси отменить последнее изменение, затем переформулируй задачу точнее
Команда не найдена после установкиПерезапусти терминал или весь компьютер
Файлы пропадают без причиныПроверь карантин антивируса
Ничего не помоглоОпиши шаг и точный текст ошибки нашему боту, разберёмся вместе