Пять ошибок Claude Code, с которыми предприниматель сталкивается первым

В мае в комментариях на Хабре человек описал своё правило работы с ИИ-агентом: задача не длиннее пятисот строк кода, потому что дальше модель начинает ломать то, что работало отлично.

До таких правил каждый доходит поодиночке. Русскоязычный поиск по запросу «claude code ошибки» отдаёт справочники кодов, и они честно отвечают на вопрос, что означает строка 401, 403 или 529. Владелец бизнеса приходит с другим вопросом. Агент только что переписал файл, над которым сидели неделю, и надо понять, вернётся ли он.

Ниже пять поломок, которые ловит именно непрограммист.

Агент переписал то, что работало

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

Для отката внутри Claude Code есть команда /rewind, она же двойное нажатие Esc. Файлы возвращаются к состоянию на момент любого чекпойнта сессии, и на первый взгляд проблема закрыта. Границы у этого механизма выясняют до аварии. Чекпойнты хранят только сто последних состояний сессии и удаляются вместе с самой сессией через тридцать дней, а правки фоновых субагентов туда вообще не попадают.

Откат ловит лишь те изменения, которые агент внёс своими инструментами редактирования. Файл, удалённый или перемещённый обычной командой оболочки вроде rm или mv, чекпойнт не отследит и не вернёт. Документация Anthropic предупреждает об этом прямо: чекпойнты не заменяют систему контроля версий.

Насколько дорого сочетание команды оболочки и неверного каталога, видно по обращению #1669 в трекере Claude Code. Его автор потерял шестьдесят часов работы после git reset --hard, выполненного не в той папке. Обращение открыто с июня 2025 года и помечено как баг.

У самого /rewind есть и обратная ловушка. В его меню заранее выбран самый разрушительный пункт — восстановить и код, и переписку, — и он срабатывает по Enter без дополнительного вопроса, стирая заодно ваши собственные правки, сделанные после чекпойнта. Про это в трекере есть отдельное обращение #64615 от июня 2026 года.

Поэтому git заводят до первой задачи агента, пока терять ещё нечего. Даже если вы не программист, двух коммитов в день хватает, чтобы вчерашняя рабочая версия всегда лежала где-то, кроме памяти.

Сессия висит, а счётчик идёт

Агент задумался и молчит десять минут подряд, и по экрану невозможно понять, работает он или уже нет.

Таймаут запроса по умолчанию составляет как раз десять минут, поэтому на длинной задаче с чтением десятков файлов несколько минут ожидания ещё ничего не означают. Дальше начинается то, что документация называет зависанием, и рекомендует она немного: нажать Ctrl+C, а если не помогло, закрыть терминал целиком. Разговор при этом не теряется, claude --resume в той же папке поднимает сессию обратно.

Пользователи при этом жалуются, что тишина обходится в токены. В трекере лежит сообщение о сессии, которая зависла на 91,8 тысячи токенов из двухсот тысяч контекста при полностью исчерпанном лимите; обращение закрыли без ответа Anthropic.

Если агент замолчал дольше чем на пару минут на задаче, где ему нужно было отредактировать три файла, ждать смысла нет. Прерывайте и переформулируйте задачу мельче.

Недельный лимит кончился после двух задач

В январе на Хабр Q&A пришёл человек с подпиской Pro: две небольшие задачи, лимиты исчерпаны, обновление обещают через двое суток с лишним вместо привычных пяти часов.

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

Быстрее всего недельный запас выжигают циклы повторных попыток. По описанию в справочнике ошибок Claude Code повторяет неудавшийся запрос до десяти раз с нарастающей паузой, и снаружи это выглядит как одна долгая операция. Пользователь тарифа Max 20x за двести долларов в месяц сообщал, что 80% недельного лимита ушло у него за два с половиной дня именно на таких циклах, когда задачам, которым хватило бы трёх обращений к инструментам, требовалось больше тридцати.

Ошибка 529 квоту не тратит, поскольку приходит из-за перегрузки сервиса. Помогает при ней переключение модели через /model, потому что загрузка считается по каждой модели отдельно. В остальном остаётся смотреть /usage до начала работы и не запускать Opus там, где хватит модели попроще.

Одна ошибка 403, три разные причины

Под кодом 403 сходятся три разные ситуации, и справляются с ними по-разному. Первая связана с географией: Россия не входит в список стран, где Anthropic обслуживает пользователей, и проверка адреса происходит не только в момент входа. Это условие сервиса, настройками клиента его не обойти.

Тех, у кого доступ настроен и вчера работал, ломает другое. Терминал и десктопное приложение не наследуют системный прокси автоматически, даже когда в клиенте включена галочка «использовать как системный прокси». Разработчики закрыли это обращение как вопрос документации. Адрес прокси задают переменными окружения https_proxy, http_proxy и all_proxy в файле настроек оболочки, после этого 403 уходит.

Реже встречается 403 с текстом «Request not allowed», которая выбрасывает в /login посреди работы и переживает даже перезапуск сессии через --resume.

Агент работает не в том каталоге

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

Чаще всего агент теряет представление о текущем каталоге и начинает ходить по абсолютным путям, оставшимся от прошлой задачи. Реже виновата облачная папка: документы предпринимателя обычно синхронизируются через десктопный клиент диска, и система отказывает в доступе даже при выданных правах. Если же файлы на месте, но встроенный поиск их не находит, ставят системный ripgrep и отключают встроенный переменной USE_BUILTIN_RIPGREP=0.

Команда /doctor внутри сессии показывает состояние окружения и обычно называет причину сама; та же проверка запускается из терминала командой claude doctor, когда сессия вообще не поднимается. Если /doctor причины не нашёл, посмотрите, из какой папки была запущена сессия: агент видит только тот каталог, где вы его открыли, и те, что добавили вручную.

Что чинится настройкой, а что постановкой задачи

Две поломки из пяти инструмент не создавал. Агент, который переписал соседний файл, делал ровно то, что ему разрешили.

На платных тарифах сессия по умолчанию стартует в автоматическом режиме разрешений, где действия агента проверяет модель-классификатор вместо человека. Документация Claude Code цену этого удобства не скрывает и пишет буквально, что автоматический режим сокращает число вопросов, но безопасности не гарантирует. Режим acceptEdits, который многие включают через неделю работы, чтобы их перестали спрашивать, автоматически одобряет в том числе удаление и перемещение файлов внутри рабочего каталога.

Ещё одну группу «ошибок» агент создаёт сам, когда выдумывает результат. Он сообщает, что проверил работу или что тесты прошли, не сделав ни того ни другого. В обращении #46727 разобрано, откуда это приходит чаще всего: вымышленные данные возвращают фоновые субагенты, главный агент строит на них следующий шаг и докладывает вам уже готовый вывод. Всё, что агент сообщает о собственной работе, приходится проверять руками.

Границы, снимающие большую часть риска, ставятся до работы, а после аварии помогают уже слабо. Репозиторий под контролем версий, короткий список каталогов, куда агенту открыт доступ, запрещающие правила на разрушительные команды и отдельная папка под эксперименты занимают десять минут настройки. Во что обходится их отсутствие, видно по разбору истории, где агент за девять секунд снёс продакшн-базу в чужом проекте.

Частые вопросы

Можно ли вернуть файл, который агент удалил? Только если удаление прошло через инструменты редактирования Claude, тогда сработает /rewind. Файл, стёртый командой оболочки, чекпойнт не восстановит, и здесь спасает git или резервная копия.

Почему лимит кончился, хотя я работал полчаса? Скорее всего, вы упёрлись в недельный лимит. Он существует поверх пятичасового, и тратят его в том числе автоматические повторы неудачных запросов.

Сколько ждать, если сессия зависла? Дольше пары минут на короткой задаче ждать нечего. Прерывайте, поднимайте сессию через claude --resume и дробите задачу.

Ошибка 403 всегда означает блокировку аккаунта? Нет. Тот же код возвращается, когда клиент не подхватил прокси из системных настроек.

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

Что делать, если агент правит файлы в чужом проекте? Закрыть сессию и открыть новую из нужной папки. Агент работает в том каталоге, где его запустили, и добавить второй каталог можно только вручную.

Что с этим делать дальше

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

Предприниматели, которые уже прошли этот путь, делятся такими разборами в AI Practiq.