Интерактивный режим

Зачем это изучать

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

Команда codex без дополнительных слов открывает полноэкранное текстовое окно внутри терминала. Такое окно называется TUI. В нём видны:

• история ваших сообщений и ответов Codex;
• поле для нового сообщения;
• строка состояния с моделью и доступными правами;
• вопросы о разрешении действий.

Проще говоря, это чат с Codex внутри терминала:

codex

Попробуйте сейчас

Запустите codex, отправьте «Ничего не меняй. Покажи текущую папку и объясни, что в ней находится», затем выполните /status. Так вы сразу увидите и ответ, и настройки сеанса.

Первое сообщение можно передать сразу:

codex "Найди причину ошибки. Пока ничего не меняй."

Как приложить изображение

Укажите путь к файлу изображения:

codex --image ./bug.png "Сопоставь ошибку на снимке экрана с кодом"

./bug.png означает файл bug.png в папке, из которой вы запускаете команду. Самый простой вариант — заранее скопировать изображение в рабочую папку проекта. Если файл лежит в другом месте, укажите полный путь к нему. Codex должен иметь право прочитать эту папку.

Полезные параметры запуска

Дополнительный параметр команды называется флагом.

Флаг	Простое назначение
-C, --cd <DIR>	Работать в указанной папке вместо текущей
-m, --model <MODEL>	Выбрать модель только для этого запуска
-i, --image <FILE>...	Добавить одно или несколько изображений к первому сообщению
-s, --sandbox <MODE>	Задать границы доступа к файлам и сети
-a, --ask-for-approval <POLICY>	Задать, когда Codex должен спросить разрешение
--add-dir <DIR>	Разрешить запись ещё в одну конкретную папку
--search	Разрешить загрузку свежих страниц из интернета для этого запуска
-c key=value	Временно изменить одну настройку из config.toml
-p, --profile <NAME>	Подключить именованный набор дополнительных настроек
--no-alt-screen	Оставлять текст диалога в обычной истории терминала после выхода
--strict-config	Остановить запуск, если Codex не узнаёт настройку в config.toml

Значения режима доступа:

Значение	Что означает
read-only	Только чтение; файлы менять нельзя
workspace-write	Разрешена запись внутри рабочей папки
danger-full-access	Обычное файловое ограничение Codex отключено; только для уже изолированной среды

Значения политики вопросов:

Значение	Что означает
untrusted	Без вопроса выполняются только заранее доверенные безопасные команды
on-request	Codex сам просит дополнительные права, когда они нужны
never	Codex не задаёт вопросов; запрещённое действие завершается ошибкой

config.toml — текстовый файл постоянных настроек Codex. Профиль — отдельный именованный файл только с отличиями для конкретного сценария, например для проверки без записи. По умолчанию личные файлы Codex находятся в папке ~/.codex; подробности есть в руководстве по конфигурации.

Продолжить или разветвить диалог

codex resume              # выбрать сохранённый сеанс
codex resume --last       # продолжить последний сеанс в текущей папке
codex resume --all        # показать сеансы из всех папок
codex fork                # выбрать сеанс и создать отдельное продолжение
codex fork --last         # разветвить последний сеанс

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

Управление сохранёнными сеансами

codex archive <SESSION>
codex unarchive <SESSION>
codex delete <SESSION>

Архивирование убирает сеанс из основного списка, но позволяет вернуть его. delete безвозвратно удаляет запись диалога. SESSION — имя или уникальный идентификатор сеанса. Перед удалением проверьте идентификатор; дополнительный флаг --force отключает повторный вопрос, но не создаёт резервную копию.

Сообщение во время работы

Один запрос и работа Codex над ним называются ходом диалога. Пока Codex работает:

• Enter обычно направляет новое сообщение в текущий ход — например, чтобы исправить направление;
• Tab ставит сообщение в очередь и отправит его после завершения текущего хода;
• Esc прерывает текущую операцию;
• /ps показывает команды, которые продолжают работать в фоне.

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

Выход

Используйте /quit, /exit или Ctrl+C. Перед выходом откройте /diff и проверьте изменения. Сохранённый диалог не сохраняет состояние файлов в истории Git автоматически.

Куда дальше

Освойте команды с косой чертой, затем прочитайте права и безопасность. Полная карта терминальных команд находится на отдельной странице.

Внешние источники ↗

• Все флаги Codex CLI