Агентный цикл, инструменты и управление контекстом

Чтобы эффективно работать с Claude Code, нужно понимать три ресурса: контекст, инструменты и обратную связь от среды.

Краткий ответ

Чтобы эффективно работать с Claude Code, нужно понимать три ресурса: контекст, инструменты и обратную связь от среды. Агент не «знает весь репозиторий заранее» — он последовательно находит и читает нужное, а результаты инструментов становятся основанием для следующего шага.

Три фазы агентного цикла

Сбор контекста отвечает на вопрос «что происходит?». Действие меняет состояние: редактирует файл, запускает команду или обращается к сервису. Проверка сопоставляет фактический результат с целью. Фазы могут повторяться много раз и не всегда строго отделены.

Хороший запрос облегчает цикл: задаёт область поиска, ожидаемое поведение и способ проверки.

Встроенные инструменты

Claude Code использует отдельные инструменты для чтения и редактирования файлов, поиска по именам и содержимому, выполнения Bash-команд, web-поиска и оркестрации. Разрешения назначаются инструментам, а не абстрактному «ответу модели».

Чтение не равно выполнению. Текст в README или на веб-странице может содержать вредоносную инструкцию; агент должен воспринимать его как данные, а не как новое распоряжение пользователя.

Что занимает контекст

В контекст входят диалог, прочитанные файлы, результаты команд, CLAUDE.md, auto memory, системные инструкции и загруженные Skills. При заполнении окна Claude Code сначала очищает старые результаты инструментов, затем может компактно пересказать разговор.

Команда /context показывает, что расходует окно. Устойчивые правила нужно вынести в CLAUDE.md, длинные исследования — подагенту, а повторяемую процедуру — в Skill.

Как не перегружать сеанс

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

Упражнение: наблюдение за циклом

Дайте агенту задачу только на чтение:

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

После ответа попросите:

1. назвать использованные инструменты; 2. отделить факты из файлов от предположений; 3. указать, какой тест подтвердил бы понимание; 4. показать через /context, какие данные заняли окно.

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

Claude Code читает все файлы при запуске?

Нет. Он получает базовый контекст и читает проектные файлы по мере необходимости. CLAUDE.md из применимой области загружается по правилам памяти проекта.

Почему длинный сеанс начинает забывать детали?

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

Нужно ли вручную указывать каждый инструмент?

Обычно нет: агент выбирает инструменты по задаче. Пользователь задаёт цель и ограничения, а правила permissions определяют допустимые действия.

Что важно запомнить

Каждый результат инструмента меняет доступный агенту контекст.
Проверка — часть цикла, а не необязательное завершение.
/context помогает обнаружить перегрузку окна.
Контекст следует организовывать, а не бесконечно накапливать.

https://yadro-code.ru/lessons/without-university/claude-code-workflows/claude-code-03