Amiga
Оглавление курса · урок 11 из 15

Модуль 3 · Основы работы · урок 11 из 15

Контекст: упоминания файлов, картинки, сжатие

Контекстное окно — всё, что модель видит в данный момент: инструкции, ваши сообщения, прочитанные файлы, вывод команд. Окно ограничено, и чем больше в нём лишнего, тем хуже агент держит в голове важное. Ниже о том, как давать агенту ровно тот контекст, который нужен, и следить, чтобы окно не зарастало мусором.

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

Ещё до вашего первого сообщения в окне лежат системные инструкции, описание инструментов, правила песочницы, содержимое AGENTS.md и сведения об окружении. Если подключены MCP-серверы, добавляются описания их инструментов.

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

Посмотреть, сколько окна осталось, можно командой:

text
/status

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

Упоминания файлов

Дешевле всего дать агенту контекст, если сразу указать файл и не ждать, пока он найдёт его сам.

  • Наберите @ в поле ввода и начните печатать имя, и Codex найдёт файл в рабочем каталоге и вставит путь в сообщение.
  • Команда /mention прикрепляет файл к чату, и последующие ходы опираются на него напрямую:
text
/mention plugins/acme/crm/classes/LeadSender.php

Так вы экономите контекст, потому что агент не перебирает десятки файлов в поисках нужного. Растёт и точность: агент начинает с того места, которое вы считаете главным.

Картинки

Для вёрстки, визуальных багов и схем картинка понятнее любого описания. В CLI есть два способа её передать:

  • вставить изображение прямо в поле ввода;
  • передать файл при запуске флагом --image (короткая форма -i):
bash
codex -i bug-mobile-menu.png "На iPhone SE меню перекрывает логотип. Найди причину в стилях шапки и исправь, не меняя десктопную версию"
codex --image layout.png,current.png "Сравни макет с текущей страницей и перечисли расхождения в отступах и шрифтах"

Поддерживаются распространённые форматы, включая PNG и JPEG. В десктопном приложении и IDE картинку можно перетащить в поле ввода с зажатым Shift.

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

Логи и ошибки

Ошибку вставляйте дословно: в пересказе теряются детали, по которым агент найдёт причину. Лишнее при этом обрезайте:

  • из стек-трейса оставьте сообщение и верхние кадры из вашего кода, сотня строк фреймворка агенту не нужна;
  • из лога берите строки вокруг ошибки, а не весь файл за сутки;
  • большой лог лучше положить в файл и попросить агента найти в нём нужное через grep.

Сжатие истории

Когда окно подходит к пределу, Codex автоматически сжимает историю: заменяет старые шаги сжатым представлением и так освобождает место. Сжатие можно запустить и вручную:

text
/compact

Команда заменяет ранние ходы кратким изложением и сохраняет в нём главные детали. Удобный момент для неё — между этапами одной задачи, например когда причину бага уже нашли и дальше будет исправление.

При сжатии часть деталей всегда теряется, поэтому:

  • постоянные правила держите в AGENTS.md, а не в переписке (урок «AGENTS.md»);
  • если задача длинная, фиксируйте важные промежуточные выводы в файле, например в заметке с планом или в описании задачи;
  • порог автоматического сжатия настраивается ключом model_auto_compact_token_limit в config.toml, но для начала оставьте значение по умолчанию.

Если нужно просто вспомнить, о чём шла речь, не сжимая контекст, есть команда /recap. Она даёт краткое изложение разговора.

Одна сессия — одна задача

Главное в управлении контекстом — привычка. Документация Codex рекомендует держать один чат на одну связную единицу работы и называет ошибкой один чат на весь проект: контекст раздувается, и результаты со временем ухудшаются.

На практике это выглядит так:

  • для новой несвязанной задачи откройте новый чат: /new (в той же CLI-сессии) или /clear (заодно очистит экран);
  • побочный вопрос посреди работы задайте через /side, откроется временный чат, отдельный от основного, а основной продолжит работу;
  • если задача та же, но хочется попробовать другой подход, используйте /fork (урок «Сессии»).

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

Что ещё раздувает контекст

  • Размытые задачи. «Разберись, как тут всё устроено» запускает чтение десятков файлов. Сужайте задачу до сценария или модуля.
  • Лишние MCP-серверы. Каждый подключённый сервер добавляет описания своих инструментов. Отключайте те, что не нужны в этом проекте, подробнее об этом в уроке «MCP».
  • Длинный AGENTS.md. Он загружается в каждую сессию, поэтому детали для частных случаев выносите в отдельные документы, на которые AGENTS.md ссылается.
  • Повторные исправления. После двух-трёх неудачных попыток окно заполнено неудачными вариантами. Чистая сессия с уточнённой постановкой обычно работает лучше.

Попробуйте сами

10–15 мин на рабочем месте
  1. В начале сессии наберите /status и запишите остаток контекста. Поработайте над задачей полчаса и проверьте снова. Что съело больше всего?
  2. Сделайте скриншот любой страницы вашего проекта с мелким визуальным дефектом и передайте его через codex -i с описанием, что исправить.
  3. Посреди работы задайте побочный вопрос через /side и вернитесь в основной чат.

Коротко

  • Окно ограничено, и в нём лежит всё: инструкции, файлы, вывод команд.
  • /status показывает оставшуюся ёмкость контекста.
  • @ и /mention дёшево и точно указывают файлы; картинки передают вставкой или через --image.
  • Ошибки вставляйте дословно, но без лишних сотен строк.
  • Codex сжимает историю сам, вручную это делает /compact. Постоянные правила держите в AGENTS.md.
  • Одна сессия — одна задача: /new для новой темы, /side для побочного вопроса.
Отметка хранится только в вашем браузере
Хотите связаться с владельцем
компании напрямую?
Дмитрий Тарасов
Дмитрий Тарасов
СЕО

НАПИСАТЬ

Написать в MAX