Агентный кодинг в Claude Code: самопроверка, plan mode и CLAUDE.md

В Claude Code одно контекстное окно держит весь диалог, каждый прочитанный файл и вывод команд — за сессию дебага легко набегают десятки тысяч токенов, и ближе к потолку агент чаще «забывает» старые указания. Anthropic собрала рабочие паттерны: самопроверка, plan mode и короткий проектный конфиг.

Контекст — главный лимит

Чем ближе окно к потолку, тем больше ошибок и провалов по ранним инструкциям. Следить за заполнением удобно через кастомную строку статуса. Лишнее в сессию не тащат: ссылки на документацию вместо простыней, узкие промпты вместо «почини всё».

Проверка вместо «выглядит готово»

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

• в одном промпте — «напиши функцию, прогони тесты и чини до зелёного»;
• через /goal — отдельный оценщик перепроверяет условие после каждого хода;
• Stop hook — скрипт блокирует завершение хода, пока проверка не прошла; после 8 блокировок подряд Claude Code всё равно закроет ход;
• verification subagent — вторая модель пытается опровергнуть результат, а не подтвердить его.

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

Сначала разведка, потом код

Рекомендуемый цикл из четырёх фаз: Explore в plan mode (читать без правок), Plan (детальный план, Ctrl+G открывает его в редакторе), Implement (код по плану с тестами), Commit (коммит и PR). Plan mode окупается при нескольких файлах или незнакомом коде; опечатку или одну строку в логе — сразу в работу.

Промпты и окружение

Точность бьёт догадки: указывай файл и сценарий, ссылайся на паттерн в кодовой базе, вставляй текст ошибки и критерий «исправлено». Файлы — через @, картинки — вставкой, логи — пайпом cat error.log | claude.

Стартовый CLAUDE.md генерируют командой /init, потом режут до того, без чего агент ошибается — команды сборки, стиль, правила тестов. Раздутый файл — типичная причина, почему правила игнорируются; загрузку проверяют через /context. Дополнительные инструкции подключают импортом @path/to/file, доменные сценарии выносят в skills.

Источник: Claude Code: Best practices for agentic coding.