Модуль 3 · Основы работы · урок 11 из 15
Контекст: упоминания файлов, картинки, сжатие
Контекстное окно — всё, что модель видит в данный момент: инструкции, ваши сообщения, прочитанные файлы, вывод команд. Окно ограничено, и чем больше в нём лишнего, тем хуже агент держит в голове важное. Ниже о том, как давать агенту ровно тот контекст, который нужен, и следить, чтобы окно не зарастало мусором.
Что занимает окно
Ещё до вашего первого сообщения в окне лежат системные инструкции, описание инструментов, правила песочницы, содержимое AGENTS.md и сведения об окружении. Если подключены MCP-серверы, добавляются описания их инструментов.
Дальше окно растёт с каждым шагом агента. Чтение большого файла с фикстурами, полный лог тестов, вывод composer show: каждое такое действие добавляет тысячи токенов. Поэтому один и тот же агент ведёт себя по-разному в свежей сессии и в сессии, где уже разобрали три бага.
Посмотреть, сколько окна осталось, можно командой:
/statusОна показывает текущую модель, режим прав, доступные каталоги, расход токенов и оставшуюся ёмкость контекста. Заглядывайте в неё, когда агент начинает путаться или забывать сказанное.
Упоминания файлов
Дешевле всего дать агенту контекст, если сразу указать файл и не ждать, пока он найдёт его сам.
- Наберите
@в поле ввода и начните печатать имя, и Codex найдёт файл в рабочем каталоге и вставит путь в сообщение. - Команда
/mentionприкрепляет файл к чату, и последующие ходы опираются на него напрямую:
/mention plugins/acme/crm/classes/LeadSender.phpТак вы экономите контекст, потому что агент не перебирает десятки файлов в поисках нужного. Растёт и точность: агент начинает с того места, которое вы считаете главным.
Картинки
Для вёрстки, визуальных багов и схем картинка понятнее любого описания. В CLI есть два способа её передать:
- вставить изображение прямо в поле ввода;
- передать файл при запуске флагом
--image(короткая форма-i):
codex -i bug-mobile-menu.png "На iPhone SE меню перекрывает логотип. Найди причину в стилях шапки и исправь, не меняя десктопную версию"
codex --image layout.png,current.png "Сравни макет с текущей страницей и перечисли расхождения в отступах и шрифтах"Поддерживаются распространённые форматы, включая PNG и JPEG. В десктопном приложении и IDE картинку можно перетащить в поле ввода с зажатым Shift.
Документация советует не полагаться только на изображение: напишите, что на нём смотреть, на какую область обратить внимание и какой результат нужен. Если картинок несколько, подпишите, какая из них что. Подробно о работе с макетами рассказывает урок «Вёрстка по макету».
Логи и ошибки
Ошибку вставляйте дословно: в пересказе теряются детали, по которым агент найдёт причину. Лишнее при этом обрезайте:
- из стек-трейса оставьте сообщение и верхние кадры из вашего кода, сотня строк фреймворка агенту не нужна;
- из лога берите строки вокруг ошибки, а не весь файл за сутки;
- большой лог лучше положить в файл и попросить агента найти в нём нужное через
grep.
Сжатие истории
Когда окно подходит к пределу, Codex автоматически сжимает историю: заменяет старые шаги сжатым представлением и так освобождает место. Сжатие можно запустить и вручную:
/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 мин на рабочем месте- В начале сессии наберите
/statusи запишите остаток контекста. Поработайте над задачей полчаса и проверьте снова. Что съело больше всего? - Сделайте скриншот любой страницы вашего проекта с мелким визуальным дефектом и передайте его через
codex -iс описанием, что исправить. - Посреди работы задайте побочный вопрос через
/sideи вернитесь в основной чат.
Коротко
- Окно ограничено, и в нём лежит всё: инструкции, файлы, вывод команд.
/statusпоказывает оставшуюся ёмкость контекста.@и/mentionдёшево и точно указывают файлы; картинки передают вставкой или через--image.- Ошибки вставляйте дословно, но без лишних сотен строк.
- Codex сжимает историю сам, вручную это делает
/compact. Постоянные правила держите в AGENTS.md. - Одна сессия — одна задача:
/newдля новой темы,/sideдля побочного вопроса.