Основные концепции Codex

Перед использованием Codex очень важно понять несколько основных концепций. Эти концепции составляют основу работы Codex.


Промпт

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

Рабочий цикл промпта

После отправки промпта Codex работает в следующем цикле:

  1. Вызвать языковую модель, чтобы понять задачу
  2. Выполнить операции, указанные в выводе модели (чтение файлов, редактирование кода, выполнение команд)
  3. Передать результаты операций обратно модели
  4. Повторять цикл, пока задача не будет выполнена или вы не отмените её.

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

Принципы эффективных промптов

ПринципОписаниеПример
Включайте шаги проверкиCodex выдаёт более качественный результат, когда может проверить свою работу"Напишите функцию, включая тестовые случаи, проверяющие обработку пустого списка"
Разбивайте сложные задачиНебольшие задачи легче тестировать и проверять"Шаг 1: создайте модель; после завершения сообщите мне, прежде чем переходить к шагу 2"
Предоставляйте контекстСсылайтесь на соответствующие файлы и изображения"Ориентируйтесь на стиль src/auth.py, чтобы реализовать аналогичную функциональность"

Codex показывает лучшие результаты при работе с небольшими, сфокусированными задачами. Большие задачи следует разбивать на небольшие шаги и выполнять поэтапно.


Поток

Поток — это сессия одной задачи: ваши запросы, а также полученные выходные данные модели и вызовы инструментов.

Типы потоков

TypeСреда выполненияХарактеристики
Локальный потокВаша машина (внутри песочницы)Может читать/записывать файлы, использовать существующие инструменты и выполнять команды
Облачный потокИзолированная облачная средаКлонировать репозиторий и запускать, подходит для параллельных задач, делегирования с разных устройств

Правила использования потоков

Запущенные потоки могут выполняться параллельно, но учтите:

  • Избегайте одновременного изменения одного файла двумя потоками
  • Поток можно возобновить позже, продолжив с другим запросом
  • Длительно выполняющиеся задачи могут автоматически сжимать контекст

Контекст

Когда вы отправляете запрос, он включает контекст, который Codex может использовать, — ссылки на соответствующие файлы и изображения.

Источники контекста

  • Расширение IDE: автоматически включает список открытых файлов и выделенные диапазоны текста
  • Ручное указание: укажите пути к файлам в запросе или прикрепите изображения
  • История беседы: содержимое предыдущей беседы в ветке

Контекстное окно

Вся информация в ветке должна помещаться в контекстное окно модели.

Codex отслеживает и сообщает оставшееся пространство. Вы получите уведомление при приближении к лимиту.

Автоматическое сжатие

Для длительных задач Codex может автоматически сжимать контекст.

Механизм сжатия обобщает релевантную информацию, отбрасывает менее важные детали и освобождает место для продолжения обработки.

Управление контекстом

# Начните новый сеанс, чтобы освободить контекст
/новый

# Просмотр текущего использования контекста
/status

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


Песочница

Песочница — это механизм безопасности Codex для изоляции, который предотвращает случайное изменение файлов за пределами рабочей области.

Режимы песочницы

ModeИзменение файловДоступ к сетиСценарии использования
Только для чтенияЗапрещеноЗапрещеноАнализ только для чтения, проверка кода
Запись в рабочей областиТолько рабочая областьЗапрещеноПовседневная разработка (по умолчанию)
Полный доступРазрешеноРазрешеноПолностью доверенная среда (используйте с осторожностью)

Механизм одобрения

Некоторые операции требуют вашего подтверждения перед выполнением:

  • Выполнение команд оболочки (особенно rm, kill и т. д.)
  • Изменение или удаление файлов
  • Доступ к конфиденциальным каталогам (например, ~/.ssh/, /etc/)
  • Сетевые запросы

Настройка режима песочницы

# Переключение режима песочницы в CLI
codex --sandbox workspace-write

# Или укажите в промпте
"Проанализируйте этот код, не изменяйте никакие файлы"

Песочница — это первая линия защиты в политике безопасности Codex, гарантирующая, что операции ИИ не выходят за ожидаемые рамки.


Политика одобрения

Политика одобрения определяет, требуется ли подтверждение перед выполнением операций Codex.

Типы политик

ПолитикаОписаниеПоведение
askСпрашивать каждый разЗапрашивать подтверждение перед чувствительными операциями (по умолчанию)
approveАвтоодобрениеВыполнять автоматически, подтверждение не требуется (используйте с осторожностью)
denyАвтоотклонениеОтклонять все операции, которые могут иметь побочные эффекты

Настроить политику одобрения

# ~/.codex/config.toml

approval_policy = "ask"

Итог

После понимания этих основных концепций вы сможете эффективнее использовать Codex:

  • Запрос: чётко опишите задачу, включая шаги проверки
  • Поток: Управляйте сессиями задач, обращайте внимание на правила параллелизма
  • Контекст: Предоставляйте релевантный контекст, следите за использованием окна
  • Песочница: Разберитесь в механизмах безопасности, выберите подходящий режим

Часто задаваемые вопросы

Вопрос: следует ли писать промпты на китайском или английском?

Codex поддерживает несколько языков, но обычно лучше всего работает английский. При использовании китайского убедитесь, что описание достаточно подробное и понятное.

Вопрос: как посмотреть текущий статус потока?

Используйте/statusкоманда для просмотра ID потока, использования контекста и информации о конфигурации.

Вопрос: что делать, если окно контекста заполнено?

Начните новую сессию (/new) или позвольте Codex автоматически сжать историю.

Вопрос: можно ли динамически переключать режим песочницы?

Вы можете указать его при запуске CLI или задать значение по умолчанию в файле конфигурации.

Другие расширения