ИИ-агент сказал «готово», а не работает: что делать

Что получишь

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

Я сама программированию не училась, десять лет работала бухгалтером. За июль и август 2026 собрала с Claude несколько сайтов с приёмом оплат и телеграм-ботов. Так что урок написан для таких же людей: тех, кто строит руками агента и в коде не разбирается.

Почему он так делает

Тут нет вранья в человеческом смысле. В документации Claude Code это объясняют просто: Claude останавливается, когда работа выглядит сделанной. Если у него нет способа проверить результат, «выглядит сделанным» остаётся единственным сигналом. И проверять тогда приходится тебе: каждая ошибка ждёт, пока ты её заметишь.

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

Из этих двух причин и растёт всё, что дальше.

Что нужно до старта

Если Claude Code ещё не стоит на компьютере, вот установка по шагам

• агент, с которым ты строишь. Чаще всего это Claude Code, он входит в Claude Pro: $20 в месяц помесячно или $17 при оплате за год (claude.com/pricing, проверено 03.10.2026). Советы ниже подходят и для обычного чата Claude, и для других агентов
• из России Claude открывается только через VPN, российская карта к оплате не подходит
• то, что не работает, открытое перед глазами: сайт в браузере, бот в Телеграме
• десять минут спокойствия. Ругаться на агента бесполезно, он от этого не начинает работать лучше

Шаги

Шаг 1. Собери улики

Самое бесполезное, что можно написать: «не работает». Агент начнёт угадывать и починит что-нибудь другое. Ему нужно три вещи: что ты сделала, что ожидала и что увидела.

Ты написал, что всё готово, но это не работает. Вот что я вижу:

Что я сделала: [например: открыла сайт, нажала кнопку «Оплатить»]
Что ожидала: [например: откроется страница оплаты]
Что увидела: [например: ничего не происходит / белый экран / текст ошибки]
Текст ошибки целиком: [скопируй всё, что написано красным, или приложи скриншот]

Не исправляй пока ничего. Сначала объясни, почему это может происходить, и назови две-три вероятные причины.

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

Скриншот можно просто вставить в окно Claude. Ошибку из консоли браузера тоже: нажми F12, вкладка Console, скопируй красные строки.

Шаг 2. Попроси доказательства вместо слов

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

Прежде чем писать «готово», покажи доказательства:
1. Какую команду или проверку ты запустил.
2. Что она вернула, целиком.
3. Если это страница сайта, открой её и сделай скриншот.
Если проверить сам не можешь, так и скажи и напиши, что мне нажать, чтобы проверить.

Эту просьбу можно один раз положить в правила проекта, и он будет делать так всегда. Как это сделать, в шаге 6.

Шаг 3. Дай ему способ проверить себя

Главный совет из официальных рекомендаций по Claude Code: дай агенту проверку, которую он может запустить сам. Тесты, сборку, скриншот для сравнения. Тогда он делает работу, запускает проверку, читает результат и правит, пока проверка не пройдёт. Без тебя.

Для того, кто не пишет код, проверка выглядит как описание: что делаю и что должно получиться.

Вот как я пойму, что всё работает:
1. Пишу боту /start, он отвечает приветствием и показывает две кнопки.
2. Нажимаю «Записаться», бот спрашивает имя.
3. Пишу имя, бот присылает ссылку на оплату.

Напиши проверку, которая проходит эти три шага сама, запусти её и правь код, пока все три шага не пройдут. Покажи результат проверки.

Для сайта то же самое: «открываю главную, вижу заголовок и кнопку, нажимаю кнопку, попадаю на форму». Если у тебя Claude в Chrome, попроси открыть страницу в браузере, сделать скриншот и сравнить с тем, что ты хотела.

Шаг 4. Требуй причину, а заплатки запрещай

Бывает, агент «чинит» ошибку так, что она просто перестаёт показываться. Ошибки не видно, а кнопка всё равно не работает. В рекомендациях Anthropic есть пример такой просьбы, вот она по-русски:

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

Шаг 5. Две неудачные попытки, и начинай чистый разговор

Если ты поправила агента два раза по одному и тому же, а лучше не стало, разговор уже забит неудачными попытками. Документация Claude Code советует в этом месте очистить контекст командой /clear и начать заново, с запросом точнее. Чистая сессия с хорошим запросом почти всегда работает лучше длинной, где накопились исправления.

Перед очисткой попроси сводку, чтобы не потерять то, что выяснили:

Напиши короткую сводку для нового разговора:
1. Что мы строим, одной фразой.
2. Что сейчас не работает и как это проверить.
3. Что уже пробовали и почему не помогло.
4. Какие файлы трогали.

Сохрани сводку, введи /clear и вставь её в новый разговор первым сообщением. В обычном чате claude.ai то же самое: просто открой новый чат.

Шаг 6. Научись откатываться

В Claude Code есть кнопки, которые спасают нервы:

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

Тут есть подвох. По документации, откат помнит только те изменения, которые Claude сделал своими инструментами правки файлов. Если он что-то менял командами в терминале, откат этого не вернёт. Поэтому, как только что-то заработало, сохраняй рабочую версию:

Сейчас всё работает. Сохрани эту версию в git с понятным описанием, что именно работает.

Дальше, если всё сломается, всегда можно вернуться к этому месту.

Шаг 7. Чтобы в следующий раз было меньше «готово»

План до кода. Для задачи побольше включи режим планирования: в Claude Code нажимай Shift+Tab, пока внизу не появится plan mode. В нём агент читает файлы и отвечает на вопросы, ничего не меняя. Прочитай план, поправь, потом разреши делать. Для мелочи вроде «поменяй цвет кнопки» план не нужен.

Правила проекта. В Claude Code есть файл CLAUDE.md, его агент читает в начале каждого разговора. Команда /init создаёт его сама. Допиши туда пару строк:

# Как работать
- Прежде чем написать «готово», запусти проверку и покажи её результат.
- Если не можешь проверить сам, напиши, что мне нажать для проверки.
- Ошибки не прячь, исправляй причину.
- Когда что-то заработало, предложи сохранить версию в git.

Держи файл коротким. В документации предупреждают: если правил слишком много, агент начинает пропускать половину.

Где обычно ломается

У агента работает, у тебя нет. Он проверил у себя, а на твоём сайте лежит старая версия: не залили изменения на хостинг или браузер показывает старую страницу из памяти. Спроси: «Изменения уже на сервере или только у тебя?» Страницу открой заново с Ctrl+F5.

Не вставлены ключи. Бот или оплата требуют токен или ключ, а агент поставил вместо него заглушку и честно написал «готово». Спроси прямо: «Какие ключи и пароли нужны, чтобы это заработало, и куда их вставить?» Ключи вставляй сама в файл с настройками, в чат их не пиши.

Ошибку спрятали. Красного текста больше нет, а кнопка молчит. Значит, ошибку заглушили. Возвращайся к шагу 4.

Длинный разговор, агент забыл договорённости. Часа через два работы он вдруг делает то, о чём просили не делать. Это переполнился контекст. Сводка, /clear, новый разговор, шаг 5.

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

Что дальше

Когда понимаешь, почему агент говорит «готово» раньше времени, работать с ним становится спокойнее: меньше ругани, больше проверок. Если хочется разобраться с Claude с самого начала, по порядку и без кода, для этого есть «Claude с нуля, 7 уроков». Там как раз то, что обычно узнаёшь методом тыка, разложено по шагам

Источники

1. https://code.claude.com/docs/en/best-practices
2. https://code.claude.com/docs/en/checkpointing
3. https://code.claude.com/docs/en/memory
4. https://claude.com/pricing

Ещё уроки