Claude Code: работа с coding-агентом4. Контекст под контролем
Граница этапа: continue, clear, compact, handoff или subagent
Засчитывается, когда отвечены все вопросы квиза
Вы закончили реализацию и хотите, чтобы её посмотрел другой агент — скажем, Codex. /compact тут не поможет: резюме останется внутри этой session Claude Code. Попросить Codex просто прочитать код — он увидит diff, но не узнает ни о решениях, ни о баге, который вы нашли по дороге. Нужен способ вынести контекст наружу. А заодно — правило, когда что выбирать.
Зачем это нужно
Работа с агентом сама собой делится на этапы: допрос, реализация, QA. Между этапами — граница, и на ней вы решаете, что делать с контекстом. Ошибка в любую сторону стоит дорого: выбросите нужное — агент потеряет причины решений; потащите лишнее — работа уйдёт из smart zone.
Как это устроено
На границе у вас пять вариантов.
- Continue — остаться в текущей session.
- Clear —
/clear: новый разговор с пустым контекстом. - Compact —
/compactс инструкцией: пересказ вместо разговора (см. 4.8). - Handoff — записать пересказ session в Markdown-файл и передать куда угодно.
- Subagent — отдать задачу subagent-у: он работает в собственном context window и возвращает только итог.
Handoff — не встроенная команда Claude Code, а skill /handoff из учебного репозитория. Его инструкция в одну фразу: написать документ, который пересказывает разговор так, чтобы свежий агент продолжил работу, и сохранить его во временный каталог ОС, а не в проект. Файл переносим: его можно скормить Codex, агенту в другом репозитории, коллеге. Во временном каталоге он не засоряет проект и исчезает, когда ОС чистит этот каталог. В новой session вы подключаете его через @ и путь к файлу — так Claude Code сразу включает содержимое файла в контекст.
Чем handoff отличается от compaction: compaction работает только внутри одной session Claude Code, handoff — где угодно. Зато compaction проще: не нужно ни файла, ни ручной передачи.
Выбирать помогают четыре вопроса по порядку; первый ответ «да» даёт решение, а если везде «нет» — остаётся compact:
- Можно продолжать? Да, если следующий этап опирается на этот разговор как на первоисточник и места хватает. После допроса на 30 тысячах токенов реализация идёт в той же session.
- Контекст больше не нужен? Тогда
/clear: это мгновенно и даёт больше всего места. Но если в контексте есть причины решений, очистка их уничтожит. - Нужно передать наружу? Другому агенту, в другой каталог, коллеге — или отложить побочный баг, найденный посреди фичи, в отдельную session. Тогда handoff.
- Задачу можно сделать AFK, без вашего участия? Например, автоматическое ревью только что написанного кода. Тогда subagent: он прочитает всё, что нужно, в собственном окне, а в основную session вернёт только итог.
Если на все четыре — нет, выбирайте compact. Это вариант по умолчанию.
Вопросы не механические: где кончается «места хватает», решаете вы. Но привычка останавливаться на каждой границе и задавать их по порядку важнее точных порогов.
Практика
Откройте session, в которой вы уже что-то сделали в Cadence, и посмотрите /context. Ответьте на четыре вопроса для следующей задачи, которую собирались делать. Затем попробуйте subagent для четвёртого вопроса:
Use a subagent to review the uncommitted changes for bugs and report back a short list.
Сравните /context до и после: в основной session прибавился только отчёт, а не все прочитанные subagent-ом файлы.
Подводные камни
- Handoff без цели. Как и
/compact, skill пишет пересказ моделью. Передавайте причину:/handoff pass to Codex to review— иначе в файл попадёт не то. - Clear «на всякий случай». Если следующему этапу нужны причины решений,
/clearих уничтожит, а восстановить их из кода не выйдет. - Subagent для работы, где нужны вы. Subagent возвращается с итогом, а не с вопросами по ходу. Если задача требует ваших решений, она не AFK.
Вывод: на каждой границе этапа задайте четыре вопроса по порядку — и контекст будет решением, а не случайностью.
Проверь себя
Вы закончили допрос, контекст занят на 30 тысяч токенов, дальше реализация. Что выбрать?
Этап закончился, и всё, что в нём исследовали и решили, следующей задаче не нужно. Что выбрать?
После реализации контекст занят на 150 тысяч токенов. Дальше — автоматическое ревью, в котором вы не участвуете. Что выбрать?
Вы написали фичу в Claude Code и хотите отдать её на ревью Codex вместе с решениями и найденным багом. Как перенести контекст?
/clear
и дать Codex самому изучить репозиторий
notes.md
в корне проекта и закоммитить
Источники
- Anthropic, Create custom subagents
- Anthropic, Commands
- Anthropic, Common workflows
- Anthropic, Explore the context window
- По мотивам AI Coding Crash Course, AI Hero: «Handing Off», «Clear, Compact, Handoff, Or Subagent»
Текст подготовлен с помощью LLM и может содержать неточности.