Основные концепции Codex
Перед использованием Codex очень важно понять несколько основных концепций. Эти концепции составляют основу работы Codex.
Промпт
Вы взаимодействуете с Codex, отправляя промпты и описывая задачу, которую хотите, чтобы он выполнил.
Рабочий цикл промпта
После отправки промпта Codex работает в следующем цикле:
- Вызвать языковую модель, чтобы понять задачу
- Выполнить операции, указанные в выводе модели (чтение файлов, редактирование кода, выполнение команд)
- Передать результаты операций обратно модели
- Повторять цикл, пока задача не будет выполнена или вы не отмените её.
Codex использует режим работыAgent loop— модель выводит инструкции для действий, результаты передаются обратно модели, и цикл повторяется, пока задача не будет выполнена.
Принципы эффективных промптов
| Принцип | Описание | Пример |
|---|---|---|
| Включайте шаги проверки | Codex выдаёт более качественный результат, когда может проверить свою работу | "Напишите функцию, включая тестовые случаи, проверяющие обработку пустого списка" |
| Разбивайте сложные задачи | Небольшие задачи легче тестировать и проверять | "Шаг 1: создайте модель; после завершения сообщите мне, прежде чем переходить к шагу 2" |
| Предоставляйте контекст | Ссылайтесь на соответствующие файлы и изображения | "Ориентируйтесь на стиль src/auth.py, чтобы реализовать аналогичную функциональность" |
Codex показывает лучшие результаты при работе с небольшими, сфокусированными задачами. Большие задачи следует разбивать на небольшие шаги и выполнять поэтапно.
Поток
Поток — это сессия одной задачи: ваши запросы, а также полученные выходные данные модели и вызовы инструментов.
Типы потоков
| Type | Среда выполнения | Характеристики |
|---|---|---|
| Локальный поток | Ваша машина (внутри песочницы) | Может читать/записывать файлы, использовать существующие инструменты и выполнять команды |
| Облачный поток | Изолированная облачная среда | Клонировать репозиторий и запускать, подходит для параллельных задач, делегирования с разных устройств |
Правила использования потоков
Запущенные потоки могут выполняться параллельно, но учтите:
- Избегайте одновременного изменения одного файла двумя потоками
- Поток можно возобновить позже, продолжив с другим запросом
- Длительно выполняющиеся задачи могут автоматически сжимать контекст
Контекст
Когда вы отправляете запрос, он включает контекст, который Codex может использовать, — ссылки на соответствующие файлы и изображения.
Источники контекста
- Расширение IDE: автоматически включает список открытых файлов и выделенные диапазоны текста
- Ручное указание: укажите пути к файлам в запросе или прикрепите изображения
- История беседы: содержимое предыдущей беседы в ветке
Контекстное окно
Вся информация в ветке должна помещаться в контекстное окно модели.
Codex отслеживает и сообщает оставшееся пространство. Вы получите уведомление при приближении к лимиту.
Автоматическое сжатие
Для длительных задач Codex может автоматически сжимать контекст.
Механизм сжатия обобщает релевантную информацию, отбрасывает менее важные детали и освобождает место для продолжения обработки.
Управление контекстом
/новый
# Просмотр текущего использования контекста
/status
Когда Codex сообщает о высоком использовании контекста, рассмотрите возможность начать новую сессию или сократить количество исторических сообщений.
Песочница
Песочница — это механизм безопасности Codex для изоляции, который предотвращает случайное изменение файлов за пределами рабочей области.
Режимы песочницы
| Mode | Изменение файлов | Доступ к сети | Сценарии использования |
|---|---|---|---|
| Только для чтения | Запрещено | Запрещено | Анализ только для чтения, проверка кода |
| Запись в рабочей области | Только рабочая область | Запрещено | Повседневная разработка (по умолчанию) |
| Полный доступ | Разрешено | Разрешено | Полностью доверенная среда (используйте с осторожностью) |
Механизм одобрения
Некоторые операции требуют вашего подтверждения перед выполнением:
- Выполнение команд оболочки (особенно rm, kill и т. д.)
- Изменение или удаление файлов
- Доступ к конфиденциальным каталогам (например, ~/.ssh/, /etc/)
- Сетевые запросы
Настройка режима песочницы
codex --sandbox workspace-write
# Или укажите в промпте
"Проанализируйте этот код, не изменяйте никакие файлы"
Песочница — это первая линия защиты в политике безопасности Codex, гарантирующая, что операции ИИ не выходят за ожидаемые рамки.
Политика одобрения
Политика одобрения определяет, требуется ли подтверждение перед выполнением операций Codex.
Типы политик
| Политика | Описание | Поведение |
|---|---|---|
ask | Спрашивать каждый раз | Запрашивать подтверждение перед чувствительными операциями (по умолчанию) |
approve | Автоодобрение | Выполнять автоматически, подтверждение не требуется (используйте с осторожностью) |
deny | Автоотклонение | Отклонять все операции, которые могут иметь побочные эффекты |
Настроить политику одобрения
approval_policy = "ask"
Итог
После понимания этих основных концепций вы сможете эффективнее использовать Codex:
- Запрос: чётко опишите задачу, включая шаги проверки
- Поток: Управляйте сессиями задач, обращайте внимание на правила параллелизма
- Контекст: Предоставляйте релевантный контекст, следите за использованием окна
- Песочница: Разберитесь в механизмах безопасности, выберите подходящий режим
Часто задаваемые вопросы
Вопрос: следует ли писать промпты на китайском или английском?
Codex поддерживает несколько языков, но обычно лучше всего работает английский. При использовании китайского убедитесь, что описание достаточно подробное и понятное.
Вопрос: как посмотреть текущий статус потока?
Используйте/statusкоманда для просмотра ID потока, использования контекста и информации о конфигурации.
Вопрос: что делать, если окно контекста заполнено?
Начните новую сессию (/new) или позвольте Codex автоматически сжать историю.
Вопрос: можно ли динамически переключать режим песочницы?
Вы можете указать его при запуске CLI или задать значение по умолчанию в файле конфигурации.
Другие расширения