Документация ChatGPT
Русский
Связаться goolvyouyou@gmail.com

Команды для разработчиков

Команды для разработчиков

Справочник по командам и слеш-командам для приложения ChatGPT для компьютера, Codex CLI и расширения Codex для IDE.

Команды в веб-версии ChatGPT

В веб-версии ChatGPT есть собственное меню команд в поле ввода. Введите /, чтобы увидеть действия, доступные в текущем чате. Это меню не предоставляет набор команд приложения ChatGPT для компьютера или CLI; слеш-команды Codex, подкоманды CLI и флаги из этого справочника неприменимы к веб-версии ChatGPT.

Команды приложения ChatGPT для компьютера

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

На странице Слеш-команды описаны команды, доступные из поля ввода приложения, включая /feedback, /goal, /init, /mcp, /plan, /review и /status.

Справочник по командам Codex CLI

Как пользоваться этим справочником

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

Глобальные флаги

Ключ Тип / значения Подробности
--add-dir path Предоставить дополнительные права на запись в каталоги наряду с основной рабочей областью. Повторите для нескольких путей.
--ask-for-approval, -a untrusted | on-request | never Определить, когда Codex должен приостанавливать работу и запрашивать подтверждение пользователя перед выполнением команды.
--cd, -C path Задать рабочий каталог агента до начала обработки запроса.
--config, -c key=value Переопределить значения конфигурации. По возможности значения разбираются как TOML; в противном случае используется строковый литерал.
--dangerously-bypass-approvals-and-sandbox, --yolo boolean Выполнять все команды без подтверждений и песочницы. Используйте только во внешней защищённой среде.
--dangerously-bypass-hook-trust boolean Запустить включённые хуки без требования сохранённого доверия к ним для этого запуска. Предназначено только для автоматизации, в которой источники хуков уже проверяются.
--disable feature Принудительно отключить флаг функции (преобразуется в -c features.<name>=false). Можно указывать несколько раз.
--enable feature Принудительно включить флаг функции (преобразуется в -c features.<name>=true). Можно указывать несколько раз.
--image, -i path[,path...] Прикрепить один или несколько файлов изображений к исходному запросу. Разделите несколько путей запятыми или укажите флаг несколько раз.
--local-provider lmstudio | ollama Выбрать локального провайдера для использования с --oss, переопределив oss_provider для этого запуска.
--model, -m string Переопределить модель, заданную в конфигурации (например, gpt-5.6-terra).
--no-alt-screen boolean Отключить режим альтернативного экрана для TUI (переопределяет tui.alternate_screen для этого запуска).
--oss boolean Использовать локального провайдера модели с открытым исходным кодом. Codex использует --local-provider, настроенный oss_provider либо предлагает выбрать между LM Studio и Ollama.
--profile, -p string Наложить $CODEX_HOME/profile-name.config.toml поверх базовой пользовательской конфигурации.
--remote ws://host:port | wss://host:port | unix:// | unix://PATH Подключиться к удалённой конечной точке app-server через WebSocket или сокет Unix. Поддерживается для codex, codex resume, codex fork, codex archive, codex delete и codex unarchive; другие подкоманды отклоняют удалённый режим.
--remote-auth-token-env ENV_VAR Считать bearer-токен из этой переменной среды и отправить его при подключении с --remote. Требует --remote; токены отправляются только по URL wss:// или доступным только локально URL ws://.
--sandbox, -s read-only | workspace-write | danger-full-access Выбрать политику песочницы для команд оболочки, сгенерированных моделью.
--search boolean Включить веб-поиск в реальном времени (задаёт web_search = "live" вместо значения по умолчанию "cached").
--strict-config boolean Выдать ошибку, если config.toml содержит поля, которые эта версия Codex не распознаёт. Поддерживается командами среды выполнения, такими как codex, exec, review, resume, fork, app-server, mcp-server и exec-server.
PROMPT string Необязательная текстовая инструкция для начала сеанса. Не указывайте её, чтобы запустить TUI без предварительно заполненного сообщения.

Эти параметры применяются к базовой команде codex. Большинство из них передаётся командам; исключения описаны в примечаниях выше или в справке соответствующей команды. Для передаваемых флагов следуйте справке соответствующей команды. Например, codex exec --oss ... применяет --oss к exec.

Обзор команд

Ключ Зрелость Подробности
codex Стабильная Запустить терминальный интерфейс. Принимает указанные выше глобальные флаги, а также необязательный запрос или прикреплённые изображения.
codex app Стабильная Запустить приложение ChatGPT для компьютера в macOS или Windows. В macOS Codex может открыть путь к рабочей области; в Windows Codex выводит путь, который нужно открыть.
codex app-server Экспериментальная Запустить Codex app server для локальной разработки или отладки через stdio, WebSocket либо сокет Unix.
codex apply Стабильная Применить к локальному рабочему дереву последний diff, созданный облачным чатом Codex. Псевдоним: codex a.
codex archive Стабильная Архивировать сохранённый интерактивный сеанс по его идентификатору или имени.
codex cloud Экспериментальная Просматривать или выполнять облачные чаты Codex из терминала, не открывая TUI. Псевдоним: codex cloud-tasks.
codex completion Стабильная Создать сценарии автодополнения команд оболочки для Bash, Zsh, Fish или PowerShell.
codex debug app-server send-message-v2 Экспериментальная Отладить app-server, отправив одно сообщение V2 через встроенный тестовый клиент.
codex debug models Экспериментальная Вывести необработанный каталог моделей, доступный Codex, с возможностью просмотреть только встроенный каталог.
codex debug prompt-input Экспериментальная Представить видимый модели список входных данных запроса в формате JSON, при необходимости добавив запрос и изображения.
codex delete Стабильная Безвозвратно удалить сохранённый интерактивный сеанс по его идентификатору или имени.
codex doctor Стабильная Создать диагностический отчёт о проблемах с локальной установкой, конфигурацией, аутентификацией, средой выполнения, Git, терминалом, app-server и перечнем тредов.
codex exec Стабильная Запустить Codex неинтерактивно. Псевдоним: codex e. Передавать результаты в stdout или JSONL и при необходимости возобновлять предыдущие сеансы.
codex execpolicy Экспериментальная Проверить файлы правил execpolicy и узнать, будет ли команда разрешена, потребует подтверждения или будет заблокирована.
codex features Стабильная Вывести список флагов функций, а также включать или отключать их с сохранением в config.toml.
codex fork Стабильная Ответвить предыдущий интерактивный сеанс в новый чат, сохранив исходную расшифровку.
codex login Стабильная Аутентифицировать Codex с помощью ChatGPT OAuth, аутентификации устройства, API key или токена доступа, переданного через stdin.
codex logout Стабильная Удалить сохранённые учётные данные аутентификации.
codex mcp Стабильная Управлять серверами Model Context Protocol (просматривать список, добавлять, удалять, аутентифицировать).
codex mcp-server Устаревшая Устаревший интерфейс для запуска Codex в качестве MCP-сервера через stdio. Вместо него используйте Codex app server. Чтобы вызывать Codex из Claude Code, используйте плагин Codex для Claude Code.
codex plugin Стабильная Устанавливать, просматривать и удалять плагины из настроенных источников маркетплейсов.
codex plugin marketplace Стабильная Добавлять, просматривать, обновлять или удалять маркетплейсы плагинов из Git или локальных источников.
codex remote-control Экспериментальная Запускать удалённое управление локальным app-server или управлять им, а также создавать краткосрочный код сопряжения.
codex resume Стабильная Продолжить предыдущий интерактивный сеанс по идентификатору или возобновить последний чат.
codex review Стабильная Выполнить неинтерактивную проверку незакоммиченных изменений, diff относительно базовой ветки, коммит или пользовательские инструкции по проверке.
codex sandbox Стабильная Выполнять произвольные команды в предоставляемых Codex песочницах macOS, Linux или Windows.
codex unarchive Стабильная Восстановить архивированный интерактивный сеанс по его идентификатору или имени.
codex update Стабильная Проверить наличие обновления Codex CLI и применить его, если установленный выпуск поддерживает самообновление.

Сведения о командах

codex (интерактивный режим)

Запуск codex без подкоманды открывает интерактивный терминальный интерфейс (TUI). Агент принимает указанные выше глобальные флаги, а также прикреплённые изображения. По умолчанию веб-поиск работает в режиме кэша; используйте --search, чтобы переключиться на просмотр в реальном времени. Для удобной локальной работы используйте --sandbox workspace-write --ask-for-approval on-request.

Используйте --remote ws://host:port или --remote wss://host:port, чтобы подключить TUI к app server, запущенному с помощью codex app-server --listen ws://IP:PORT. Для локального сокета Unix используйте --remote unix:// для сокета по умолчанию или --remote unix://PATH для явного пути. Добавьте --remote-auth-token-env <ENV_VAR>, если сервер требует bearer-токен для аутентификации WebSocket.

codex app-server

Запустить Codex app server локально. Он предназначен главным образом для разработки и отладки и может измениться без предварительного уведомления.

Ключ Тип / значения Подробности
--analytics-default-enabled boolean По умолчанию включает аналитику для собственных клиентов app-server, если пользователь не отключил её в конфигурации.
--listen stdio:// | ws://IP:PORT | unix:// | unix://PATH | off URL прослушивателя транспорта. Используйте stdio:// для JSONL, ws://IP:PORT для конечной точки TCP WebSocket, unix:// для сокета Unix по умолчанию, unix://PATH для пользовательского сокета Unix или off, чтобы отключить локальный транспорт.
--stdio boolean Использовать транспорт stdio. Эквивалентно --listen stdio:// и несовместимо с --listen.
--ws-audience string Ожидаемое утверждение aud для подписанных bearer-токенов. Требует --ws-auth signed-bearer-token.
--ws-auth capability-token | signed-bearer-token Режим аутентификации для клиентов app-server по WebSocket. Если не указан, аутентификация WebSocket отключена; при запуске выводится предупреждение для нелокальных прослушивателей.
--ws-issuer string Ожидаемое утверждение iss для подписанных bearer-токенов. Требует --ws-auth signed-bearer-token.
--ws-max-clock-skew-seconds number Допустимое расхождение часов при проверке утверждений exp и nbf подписанного bearer-токена. Требует --ws-auth signed-bearer-token.
--ws-shared-secret-file absolute path Файл с общим секретом HMAC, используемым для проверки подписанных JWT bearer-токенов. Обязателен с --ws-auth signed-bearer-token.
--ws-token-file absolute path Файл с общим токеном возможностей. Используйте с --ws-auth capability-token, если вместо него не указан --ws-token-sha256.
--ws-token-sha256 hexadecimal SHA-256 digest Ожидаемый хеш SHA-256 для аутентификации по токену возможностей. Используйте вместо --ws-token-file, если токен клиента поступает из другого источника.

codex app-server --listen stdio:// сохраняет поведение по умолчанию — JSONL через stdio, а codex app-server --stdio служит псевдонимом этого транспорта. --listen ws://IP:PORT включает транспорт WebSocket для клиентов app-server. Сервер принимает URL прослушивания ws://; используйте завершение TLS или безопасный прокси, когда клиенты подключаются через wss://. Используйте --listen unix://, чтобы принимать рукопожатия WebSocket на стандартном сокете Unix Codex, или --listen unix:///absolute/path.sock, чтобы выбрать путь к сокету. Если вы создаёте схемы для клиентских привязок, добавьте --experimental, чтобы включить защищённые флагами поля и методы.

Добавьте --code-mode-host wss://code-mode.example.com/host, чтобы подключить app-server к удалённому хосту Code Mode вместо запуска локального хоста. Это исходящее подключение отделено от --listen и используется всеми тредами в процессе app-server. Используйте ws:// только для localhost или хоста, доступного через SSH-перенаправление.

codex remote-control

Запустите codex remote-control, чтобы начать удалённое управление в основном процессе. Используйте codex remote-control start, чтобы запустить локальный демон app-server с включённым удалённым управлением, и codex remote-control stop, чтобы остановить его. Управляемые клиенты удалённого управления и удалённые рабочие процессы SSH используют эти команды; они не заменяют codex app-server --listen при создании локального клиента протокола.

После запуска демона используйте codex remote-control pair, чтобы создать и вывести краткосрочный код ручного сопряжения. Добавьте --json к любой команде удалённого управления для машиночитаемого вывода. Для pair ответ JSON содержит pairingCode, manualPairingCode, environmentId и expiresAt.

codex app

Запустить приложение ChatGPT для компьютера из терминала в macOS или Windows. В macOS Codex может открыть определённый путь к рабочей области; в Windows Codex выводит путь, который нужно открыть.

Ключ Тип / значения Подробности
--download-url url Расширенное переопределение URL установщика приложения ChatGPT для компьютера, используемого при установке.
PATH path Путь к рабочей области для приложения ChatGPT для компьютера. В macOS Codex открывает этот путь; в Windows Codex выводит его.

codex app открывает установленное приложение ChatGPT для компьютера или запускает установщик, если приложение отсутствует. В macOS Codex открывает указанный путь к рабочей области; в Windows после установки он выводит путь, который нужно открыть.

codex debug app-server send-message-v2

Отправить одно сообщение через поток тредов и ходов V2 app-server с помощью встроенного тестового клиента app-server.

Ключ Тип / значения Подробности
USER_MESSAGE string Текст сообщения, отправляемого в app-server через встроенный поток тестового клиента V2.

Этот отладочный поток инициализируется с experimentalApi: true, запускает тред, отправляет ход и транслирует уведомления сервера. Используйте его для локального воспроизведения и изучения поведения протокола app-server.

codex debug models

Вывести необработанный каталог моделей, доступный Codex, в формате JSON.

Ключ Тип / значения Подробности
--bundled boolean Пропустить обновление и вывести только каталог моделей, встроенный в текущий бинарный файл Codex.

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

codex debug prompt-input

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

Ключ Тип / значения Подробности
--image, -i path[,path...] Прикрепить одно или несколько изображений к пользовательскому запросу. Разделите несколько путей запятыми или укажите флаг несколько раз.
PROMPT string Необязательный пользовательский запрос, добавляемый после контекста сеанса.

codex apply

Применить к локальному репозиторию последний diff из облачного чата Codex. Необходимо пройти аутентификацию и иметь доступ к чату.

Ключ Тип / значения Подробности
TASK_ID string Идентификатор облачного чата Codex, diff которого нужно применить.

Codex выводит изменённые файлы и завершает работу с ненулевым кодом, если git apply завершается неудачно (например, из-за конфликтов).

codex review

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

Ключ Тип / значения Подробности
--base branch Проверить изменения относительно указанной базовой ветки.
--commit SHA Проверить изменения, внесённые указанным коммитом.
--strict-config boolean Выдать ошибку, если config.toml содержит поля, которые эта версия Codex не распознаёт.
--title string Задать заголовок коммита, отображаемый в сводке проверки. Требует --commit.
--uncommitted boolean Проверить индексированные, неиндексированные и неотслеживаемые изменения.
PROMPT string | - (read stdin) Пользовательские инструкции по проверке. Используйте -, чтобы считать инструкции из stdin.

--uncommitted, --base, --commit и пользовательский PROMPT несовместимы друг с другом. Используйте --title только с --commit.

codex archive и codex unarchive

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

codex archive <SESSION>
codex unarchive <SESSION>
Ключ Тип / значения Подробности
--remote ws://host:port | wss://host:port | unix:// | unix://PATH Подключиться к удалённой конечной точке app-server перед изменением состояния архива.
--remote-auth-token-env ENV_VAR Считать bearer-токен из этой переменной среды, когда --remote требует аутентификации.
SESSION session ID | session name Сохранённый сеанс, который нужно архивировать или восстановить. Идентификаторы сеансов имеют приоритет над именами.

codex delete

Безвозвратно удалить сохранённый интерактивный сеанс по его идентификатору или имени. Используйте это только в том случае, если хотите удалить расшифровку, а не скрыть её из списков активных сеансов.

codex delete <SESSION>
codex delete <SESSION_UUID> --force
Ключ Тип / значения Подробности
--force boolean Удалить без запроса подтверждения. Аргумент сеанса должен быть UUID; имена по-прежнему требуют интерактивного подтверждения.
--remote ws://host:port | wss://host:port | unix:// | unix://PATH Подключиться к удалённой конечной точке app-server перед удалением сеанса.
--remote-auth-token-env ENV_VAR Считать bearer-токен из этой переменной среды, когда --remote требует аутентификации.
SESSION session ID | session name Сохранённый сеанс, который нужно удалить. Идентификаторы сеансов имеют приоритет над именами.

Используйте --force только с UUID сеанса. Именованные сеансы по-прежнему требуют подтверждения, чтобы Codex не удалил повторяющееся или неоднозначное имя без запроса.

codex cloud

Работать с облачными чатами Codex из терминала. Команда по умолчанию открывает интерактивный список выбора; codex cloud exec отправляет задачу напрямую, а codex cloud list возвращает недавние чаты для сценариев или быстрого просмотра.

Ключ Тип / значения Подробности
--attempts 1-4 Число попыток ассистента (выбор лучшей из N), которые должен выполнить Codex cloud.
--env ENV_ID Идентификатор целевой среды Codex cloud (обязателен). Используйте codex cloud, чтобы вывести доступные варианты.
QUERY string Запрос задачи. Если он не указан, Codex интерактивно запрашивает подробности.

Для аутентификации используются те же учётные данные, что и в основном CLI. Codex завершает работу с ненулевым кодом, если отправить задачу не удалось.

codex cloud list

Вывести недавние облачные чаты с необязательной фильтрацией и постраничным выводом.

Ключ Тип / значения Подробности
--cursor string Курсор постраничного вывода, возвращённый предыдущим запросом.
--env ENV_ID Фильтровать задачи по идентификатору среды.
--json boolean Выводить машиночитаемый JSON вместо обычного текста.
--limit 1-20 Максимальное количество возвращаемых задач.

В обычном текстовом выводе сначала печатается URL задачи, а затем сведения о состоянии. Используйте --json для автоматизации. Полезная нагрузка JSON содержит массив tasks и необязательное значение cursor. Каждая задача содержит id, url, title, status, updated_at, environment_id, environment_label, summary, is_review и attempt_total.

codex completion

Создать сценарии автодополнения команд оболочки и перенаправить вывод в нужное место, например codex completion zsh > "${fpath[1]}/_codex".

Ключ Тип / значения Подробности
SHELL bash | zsh | fish | power-shell | elvish Оболочка, для которой нужно создать автодополнения. Результат выводится в stdout.

codex doctor

Создать локальный диагностический отчёт перед обращением в службу поддержки или при исследовании неполадок в установке Codex. Отчёт проверяет состояние установки, конфигурации, аутентификации, среды выполнения, Git, терминала, app-server и перечня тредов.

Ключ Тип / значения Подробности
--all boolean Разворачивать длинные списки в подробном удобочитаемом отчёте.
--ascii boolean Использовать метки состояния и разделители ASCII в удобочитаемом выводе.
--json boolean Вывести обезличенный машиночитаемый отчёт для поддержки.
--no-color boolean Отключить цвета ANSI в удобочитаемом выводе.
--summary boolean Показывать только сгруппированные строки проверок и итоговую сводку количества.

codex features

Управлять флагами функций, хранящимися в $CODEX_HOME/config.toml. Команды enable и disable сохраняют изменения, чтобы они применялись к будущим сеансам. Подкоманда features не принимает --profile.

Ключ Тип / значения Подробности
Disable subcommand codex features disable <feature> Отключить флаг функции с сохранением в $CODEX_HOME/config.toml.
Enable subcommand codex features enable <feature> Включить флаг функции с сохранением в $CODEX_HOME/config.toml.
List subcommand codex features list Показать известные флаги функций, стадии их зрелости и фактическое состояние.

codex exec

Используйте codex exec (или краткую форму codex e) для запуска в сценариях или CI, который должен завершиться без взаимодействия с пользователем.

Ключ Тип / значения Подробности
--cd, -C path Задать корневой каталог рабочей области перед выполнением задачи.
--color always | never | auto Управлять цветом ANSI в stdout.
--dangerously-bypass-approvals-and-sandbox, --yolo boolean Обойти запросы подтверждения и песочницу. Опасно — используйте только в изолированном средстве запуска.
--dangerously-bypass-hook-trust boolean Запустить включённые хуки без требования сохранённого доверия к ним для этого запуска. Предназначено только для автоматизации, в которой источники хуков уже проверяются.
--ephemeral boolean Запустить без сохранения файлов развёртывания сеанса на диск.
--full-auto boolean Устаревший флаг совместимости. Предпочтительнее --sandbox workspace-write; при использовании этого флага Codex выводит предупреждение.
--ignore-rules boolean Не загружать для этого запуска пользовательские или проектные файлы execpolicy .rules.
--ignore-user-config boolean Не загружать $CODEX_HOME/config.toml. Для аутентификации по-прежнему используется CODEX_HOME.
--image, -i path[,path...] Прикрепить изображения к первому сообщению. Можно указывать несколько раз; поддерживаются списки с разделением запятыми.
--json, --experimental-json boolean Выводить события JSON, разделённые переводами строк, вместо форматированного текста.
--local-provider lmstudio | ollama Выбрать локального провайдера для использования с --oss, переопределив oss_provider для этого запуска.
--model, -m string Переопределить настроенную модель для этого запуска.
--oss boolean Использовать локального провайдера с открытым исходным кодом. Codex использует --local-provider или настроенный oss_provider и завершает работу с ошибкой, если не задан ни один из них.
--output-last-message, -o path Записать итоговое сообщение ассистента в файл. Полезно для последующей обработки в сценариях.
--output-schema path Файл JSON Schema, описывающий ожидаемую структуру итогового ответа. Codex проверяет выходные данные инструмента по этой схеме.
--profile, -p string Наложить $CODEX_HOME/profile-name.config.toml поверх базовой пользовательской конфигурации.
--sandbox, -s read-only | workspace-write | danger-full-access Политика песочницы для команд, сгенерированных моделью. По умолчанию берётся из конфигурации.
--skip-git-repo-check boolean Разрешить запуск вне репозитория Git (полезно для разовых каталогов).
-c, --config key=value Встроенное переопределение конфигурации для неинтерактивного запуска (можно указывать несколько раз).
PROMPT string | - (read stdin) Исходная инструкция для задачи. Используйте -, чтобы передать запрос из stdin.
Resume subcommand codex exec resume [SESSION_ID] Возобновить сеанс exec по идентификатору или добавить --last, чтобы продолжить последний сеанс из текущего рабочего каталога. Добавьте --all, чтобы учитывать сеансы из любых каталогов. Принимает необязательный последующий запрос.

По умолчанию Codex выводит форматированный текст. Добавьте --json, чтобы получать события JSON, разделённые переводами строк (по одному на каждое изменение состояния). Необязательная подкоманда resume позволяет продолжать неинтерактивные задачи. Используйте --last, чтобы выбрать последний сеанс из текущего рабочего каталога, или добавьте --all для поиска по всем сеансам:

Ключ Тип / значения Подробности
--all boolean Учитывать сеансы вне текущего рабочего каталога при выборе последнего сеанса.
--image, -i path[,path...] Прикрепить одно или несколько изображений к последующему запросу. Разделите несколько путей запятыми или укажите флаг несколько раз.
--last boolean Возобновить последний чат из текущего рабочего каталога.
PROMPT string | - (read stdin) Необязательная последующая инструкция, отправляемая сразу после возобновления.
SESSION_ID uuid | session name Возобновить указанный сеанс. Не указывайте и используйте --last, чтобы продолжить последний сеанс.

codex execpolicy

Проверяйте файлы правил execpolicy перед сохранением. codex execpolicy check принимает один или несколько флагов --rules (например, файлы в ~/.codex/rules) и выводит JSON с самым строгим решением и всеми совпавшими правилами. Добавьте --pretty, чтобы отформатировать вывод. Команда execpolicy сейчас находится на этапе предварительной версии.

Ключ Тип / значения Подробности
--pretty boolean Красиво отформатировать результат JSON.
--rules, -r path (repeatable) Путь к файлу правил execpolicy, который нужно проверить. Укажите несколько флагов, чтобы объединить правила из разных файлов.
COMMAND... var-args Команда, которую нужно проверить по указанным политикам.

codex login

Аутентифицировать CLI с помощью учётной записи ChatGPT, API key или токена доступа. Если флаги не указаны, Codex открывает браузер для потока ChatGPT OAuth.

Ключ Тип / значения Подробности
--device-auth boolean Использовать поток кода устройства OAuth вместо открытия окна браузера.
--with-access-token boolean Считать токен доступа из stdin (например, printenv CODEX_ACCESS_TOKEN | codex login --with-access-token).
--with-api-key boolean Считать API key из stdin (например, printenv OPENAI_API_KEY | codex login --with-api-key).
status subcommand codex login status Вывести активный режим аутентификации и завершить работу с кодом 0, если вход выполнен.

codex login status завершается с 0 при наличии учётных данных, что удобно в сценариях автоматизации.

codex logout

Удалить сохранённые учётные данные как для API key, так и для аутентификации ChatGPT. У этой команды нет флагов.

codex mcp

Управлять записями серверов Model Context Protocol, хранящимися в ~/.codex/config.toml.

Ключ Тип / значения Подробности
add <name> -- <command...> | --url <value> Зарегистрировать сервер с помощью команды запуска stdio или потокового URL HTTP. Поддерживает --env KEY=VALUE для транспортов stdio.
get <name> --json Показать конфигурацию определённого сервера. --json выводит необработанную запись конфигурации.
list --json Вывести настроенные MCP-серверы. Добавьте --json для машиночитаемого вывода.
login <name> --scopes scope1,scope2 Начать вход через OAuth для потокового HTTP-сервера (только для серверов, поддерживающих OAuth).
logout <name> Удалить сохранённые учётные данные OAuth для потокового HTTP-сервера.
remove <name> Удалить сохранённое определение MCP-сервера.

Подкоманда add поддерживает как stdio, так и потоковый HTTP-транспорт:

Ключ Тип / значения Подробности
--bearer-token-env-var ENV_VAR Переменная среды, значение которой отправляется как bearer-токен при подключении к потоковому HTTP-серверу.
--env KEY=VALUE repeatable Присваивания переменных среды, применяемые при запуске stdio-сервера.
--oauth-client-id CLIENT_ID Идентификатор клиента OAuth для потокового HTTP MCP-сервера. Требует --url.
--oauth-resource RESOURCE Параметр ресурса OAuth, включаемый при входе для потокового HTTP MCP-сервера. Требует --url.
--url https://… Зарегистрировать потоковый HTTP-сервер вместо stdio. Несовместимо с COMMAND....
COMMAND... stdio transport Исполняемый файл и аргументы для запуска MCP-сервера. Укажите после --.

Действия OAuth (login, logout) работают только с потоковыми HTTP-серверами (и только если сервер поддерживает OAuth).

codex plugin

Устанавливать, просматривать и удалять плагины из настроенных маркетплейсов.

Ключ Тип / значения Подробности
add <plugin[@marketplace]> [--marketplace, -m NAME] [--json] Установить плагин из настроенного маркетплейса. Используйте --marketplace или -m, если в аргументе плагина отсутствует @marketplace.
list [--marketplace, -m NAME] [--available --json] [--json] Вывести установленные плагины. При использовании --json вывод содержит массивы installed и available; --available включает неустановленные плагины маркетплейса и требует --json.
marketplace Управлять настроенными источниками маркетплейсов. См. описание codex plugin marketplace ниже.
remove <plugin[@marketplace]> [--marketplace, -m NAME] [--json] Удалить установленный плагин из локальной конфигурации и кэша. Используйте --json для удобного для автоматизации вывода.

codex plugin add --json выводит pluginId, name, marketplaceName, version, installedPath и authPolicy. codex plugin list --json выводит массивы installed и available. Записи содержат pluginId, name, marketplaceName, version, installed, enabled, source, installPolicy, authPolicy и, если доступно, marketplaceSource с типом и значением настроенного источника маркетплейса. codex plugin remove --json выводит pluginId, name и marketplaceName.

codex plugin marketplace

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

Ключ Тип / значения Подробности
add <source> [--ref REF] [--sparse PATH] [--json] Установить маркетплейс плагинов из сокращённой записи GitHub, URL Git, URL SSH или локального корневого каталога маркетплейса. --sparse поддерживается только для источников Git и может указываться несколько раз.
list [--json] Показать маркетплейсы плагинов, которые сейчас учитывает Codex, и корневой путь каждого из них.
remove <marketplace-name> [--json] Удалить настроенный маркетплейс плагинов.
upgrade [marketplace-name] [--json] Обновить один настроенный маркетплейс Git или все настроенные маркетплейсы Git, если имя не указано.

codex plugin marketplace add принимает сокращённые записи GitHub, такие как owner/repo или owner/repo@ref, URL Git по HTTP или HTTPS, URL Git по SSH и локальные корневые каталоги маркетплейсов. Используйте --ref, чтобы закрепить ссылку Git, и повторите --sparse PATH, чтобы использовать разреженное извлечение для репозиториев маркетплейсов на основе Git.

codex plugin marketplace list выводит имена и корневые каталоги маркетплейсов в области действия, включая неявно обнаруженные маркетплейсы по умолчанию и настроенные снимки маркетплейсов.

Добавьте --json к командам добавления, просмотра, обновления или удаления маркетплейса для удобного для автоматизации вывода. JSON при добавлении маркетплейса содержит marketplaceName, installedRoot и alreadyAdded; JSON списка содержит массив marketplaces с name, root и необязательным marketplaceSource; JSON обновления содержит selectedMarketplaces, upgradedRoots и errors; JSON удаления содержит marketplaceName и installedRoot.

codex mcp-server

Для существующих интеграций команда запускает Codex в качестве MCP-сервера через stdio, чтобы к нему могли подключаться другие инструменты. Она наследует глобальные переопределения конфигурации и завершает работу, когда нижестоящий клиент закрывает соединение.

codex resume

Продолжить интерактивный сеанс по идентификатору или возобновить последний чат. codex resume ограничивает --last текущим рабочим каталогом, если не передан --all. Команда принимает те же глобальные флаги, что и codex, включая переопределения модели и песочницы.

Если текущий рабочий каталог отличается от сохранённого каталога сеанса, Codex спрашивает, какой каталог использовать. Задайте для tui.resume_cwd значение "current" или "session", чтобы повторно использовать этот выбор без запроса. Явное переопределение --cd (-C) имеет приоритет над tui.resume_cwd.

Ключ Тип / значения Подробности
--all boolean Учитывать сеансы вне текущего рабочего каталога при выборе последнего сеанса.
--include-non-interactive boolean Включать неинтерактивные сеансы в список выбора и выбор --last.
--last boolean Пропустить список выбора и возобновить последний чат из текущего рабочего каталога.
SESSION_ID uuid | session name Возобновить указанный сеанс. Не указывайте и используйте --last, чтобы продолжить последний сеанс.

codex fork

Ответвить предыдущий интерактивный сеанс в новый чат. По умолчанию codex fork открывает список выбора сеансов; добавьте --last, чтобы вместо этого ответвить последний сеанс.

Если текущий и сохранённый каталоги сеанса различаются, codex fork использует тот же запрос рабочего каталога и параметр tui.resume_cwd, что и codex resume.

Ключ Тип / значения Подробности
--all boolean Показывать в списке выбора сеансы за пределами текущего рабочего каталога.
--last boolean Пропустить список выбора и автоматически ответвить последний чат.
SESSION_ID uuid Ответвить указанный сеанс. Не указывайте и используйте --last, чтобы ответвить последний сеанс.

codex sandbox

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

macOS seatbelt
Ключ Тип / значения Подробности
--allow-unix-socket path Разрешить команде в песочнице привязывать или подключать сокеты Unix, расположенные по этому пути. Повторите, чтобы разрешить несколько путей.
--cd, -C DIR Рабочий каталог для разрешения профиля и выполнения команды. Требует --permission-profile.
--config, -c key=value Передать переопределения конфигурации в запуск в песочнице (можно указывать несколько раз).
--include-managed-config boolean Включить управляемые требования при разрешении явно заданного профиля разрешений. Требует --permission-profile.
--log-denials boolean Перехватывать отказы песочницы macOS с помощью log stream во время выполнения команды и выводить их после завершения.
--permission-profile, -P NAME Применить именованный профиль разрешений из активного стека конфигурации.
--profile, -p NAME Наложить $CODEX_HOME/NAME.config.toml поверх базовой пользовательской конфигурации.
COMMAND... var-args Команда оболочки для выполнения под управлением macOS Seatbelt. Всё после -- передаётся дальше.
Linux Landlock
Ключ Тип / значения Подробности
--cd, -C DIR Рабочий каталог для разрешения профиля и выполнения команды. Требует --permission-profile.
--config, -c key=value Переопределения конфигурации, применяемые перед запуском песочницы (можно указывать несколько раз).
--include-managed-config boolean Включить управляемые требования при разрешении явно заданного профиля разрешений. Требует --permission-profile.
--permission-profile, -P NAME Применить именованный профиль разрешений из активного стека конфигурации.
--profile, -p NAME Наложить $CODEX_HOME/NAME.config.toml поверх базовой пользовательской конфигурации.
COMMAND... var-args Команда для выполнения под управлением Landlock + seccomp. Укажите исполняемый файл после --.
Windows
Ключ Тип / значения Подробности
--cd, -C DIR Рабочий каталог для разрешения профиля и выполнения команды. Требует --permission-profile.
--config, -c key=value Переопределения конфигурации, применяемые перед запуском песочницы (можно указывать несколько раз).
--include-managed-config boolean Включить управляемые требования при разрешении явно заданного профиля разрешений. Требует --permission-profile.
--permission-profile, -P NAME Применить именованный профиль разрешений из активного стека конфигурации.
--profile, -p NAME Наложить $CODEX_HOME/NAME.config.toml поверх базовой пользовательской конфигурации.
COMMAND... var-args Команда для выполнения во встроенной песочнице Windows. Укажите исполняемый файл после --.

codex update

Проверить наличие обновления Codex CLI и применить его, если установленный выпуск поддерживает самообновление. Отладочные сборки выводят сообщение о необходимости установить сборку выпуска.

Сочетания флагов и рекомендации по безопасности

  • Используйте --sandbox workspace-write для автономной локальной работы, которая может выполняться в пределах рабочей области, и избегайте --dangerously-bypass-approvals-and-sandbox, если вы не находитесь в выделенной виртуальной машине с песочницей.
  • Если нужно предоставить Codex доступ на запись в дополнительные каталоги, предпочтительнее использовать --add-dir, а не принудительно включать --sandbox danger-full-access.
  • Сочетайте --json с --output-last-message в CI, чтобы получать машиночитаемые сведения о ходе выполнения и итоговую сводку на естественном языке.

Интерактивные сочетания клавиш

  • Введите @, чтобы найти файл в рабочей области и добавить его путь в запрос.
  • Нажмите Up или Down, чтобы восстановить историю черновиков.
  • Нажмите Ctrl+R, чтобы выполнить поиск в истории запросов, затем нажмите Enter, чтобы использовать совпадение, или Esc, чтобы отменить поиск.
  • Нажмите Ctrl+O или выполните /copy, чтобы скопировать последний завершённый вывод Codex.
  • Добавьте ! в начало строки, чтобы выполнить локальную команду оболочки с текущими настройками подтверждения и песочницы.
  • Пока Codex работает, нажмите Tab, чтобы поставить последующий запрос, слеш-команду или команду оболочки в очередь на следующий ход.
  • Пока Codex работает, нажмите Enter, чтобы добавить новые инструкции в текущий ход.
  • При пустом поле ввода дважды нажмите Esc, чтобы отредактировать предыдущее сообщение пользователя и ответвить чат с этой точки.
  • Нажмите Ctrl+C или выполните /exit, чтобы закрыть сеанс.

Связанные ресурсы

Слеш-команды позволяют быстро управлять Codex с клавиатуры. Введите / в поле ввода, чтобы открыть всплывающее меню слеш-команд, выберите команду, и Codex выполнит такие действия, как переключение модели, изменение разрешений или свёртывание длинных чатов, не покидая терминал.

В этом руководстве показано, как:

  • Найти подходящую встроенную слеш-команду для задачи
  • Управлять активным сеансом с помощью таких команд, как /model, /fast, /personality, /permissions, /approve, /raw, /agent и /status

Слеш-команды Codex CLI

Встроенные слеш-команды

В состав Codex входят следующие команды. Откройте всплывающее меню слеш-команд и начните вводить имя команды, чтобы отфильтровать список.

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

Команда Назначение Когда использовать
/permissions Настроить, что Codex может делать без предварительного запроса. Смягчить или ужесточить требования к подтверждению во время сеанса, например переключиться между Auto и Read Only.
/ide Добавить открытые файлы, текущее выделение и другой контекст IDE. Добавить контекст редактора в следующий запрос, не объясняя повторно, что открыто в IDE.
/keymap Переназначить сочетания клавиш TUI. Просмотреть и сохранить пользовательские сочетания клавиш в config.toml.
/vim Включить или выключить режим Vim в редакторе запросов. Переключиться между обычным режимом/режимом вставки Vim и стандартным режимом редактирования запросов.
/setup-default-sandbox Настроить изолированную среду агента с повышенными правами (только для Windows). Заменить ограниченную изолированную среду Windows после того, как Codex предложит настройку среды с повышенными правами.
/sandbox-add-read-dir Предоставить изолированной среде доступ на чтение дополнительного каталога (только для Windows). Разрешить выполнение команд, которым нужно читать данные по абсолютному пути к каталогу за пределами текущих доступных для чтения корневых каталогов.
/agent, /subagents Переключить активную ветку агента. Просмотреть или продолжить работу в ветке порождённого субагента.
/apps Просмотреть приложения (коннекторы) и вставить их в запрос. Прикрепить приложение как $app-slug, прежде чем просить Codex использовать его.
/plugins Просмотреть установленные и доступные для обнаружения плагины. Изучить инструменты плагинов, установить предложенные плагины или управлять доступностью плагинов.
/hooks Просмотреть обработчики событий жизненного цикла и управлять ими. Проверить настроенные обработчики, назначить доверенными новые или изменённые обработчики либо отключить неуправляемые обработчики до их запуска.
/clear Очистить терминал и начать новый чат. Одновременно сбросить видимый интерфейс и контекст чата, чтобы начать заново.
/rename Переименовать текущий чат. Присвоить сохранённому сеансу узнаваемое имя, не выходя из TUI.
/archive Архивировать текущий сеанс и выйти из Codex. Удалить текущий сеанс из списков активных сеансов, не удаляя его расшифровку.
/delete Безвозвратно удалить текущий сеанс и выйти из Codex. Удалить расшифровку и дочерние сеансы, если архивации недостаточно.
/compact Суммировать видимый чат, чтобы освободить токены. Использовать после продолжительной работы, чтобы Codex сохранил ключевые моменты, не переполняя окно контекста.
/copy Скопировать последний завершённый вывод Codex. Получить текст последнего готового ответа или плана без ручного выделения. Также можно нажать Ctrl+O.
/diff Показать различия Git, включая файлы, которые Git ещё не отслеживает. Проверить правки Codex перед фиксацией изменений или запуском тестов.
/exit Выйти из CLI (аналогично /quit). Альтернативное написание; обе команды завершают сеанс.
/experimental Включить или выключить экспериментальные функции. Включить такие параметры, как Network proxy или Prevent sleep while running.
/approve Разрешить одну повторную попытку после недавнего отказа автоматической проверки. Повторить команду или действие, отклонённое автоматической проверкой.
/memories Настроить использование и создание воспоминаний. Включить или выключить добавление либо создание воспоминаний, не выходя из TUI.
/skills Просматривать и использовать навыки. Улучшить поведение для конкретной задачи, выбрав подходящий локальный навык.
/import Импортировать настройки, проекты и чаты Claude Code или Cursor. Перенести поддерживаемые артефакты внешних агентов в конфигурацию и локальные файлы Codex.
/feedback Отправить журналы разработчикам Codex. Сообщить о проблемах или передать диагностические данные службе поддержки.
/init Создать каркас AGENTS.md в текущем каталоге. Зафиксировать постоянные инструкции для репозитория или подкаталога, в котором вы работаете.
/logout Выйти из учётной записи Codex. Удалить локальные учётные данные при работе на общем компьютере.
/mcp Показать настроенные инструменты Model Context Protocol (MCP). Проверить, какие внешние инструменты Codex может вызывать во время сеанса; добавьте verbose для просмотра сведений о серверах.
/mention Прикрепить файл к чату. Указать Codex конкретные файлы или папки для последующей проверки.
/model Выбрать активную модель (и глубину рассуждений, если она доступна). Переключиться между такими моделями, как gpt-5.6-luna и gpt-5.6-terra, перед выполнением задачи.
/fast Включить или выключить уровень обслуживания Fast, если он присутствует в каталоге моделей. Включить или выключить уровень Fast для текущей модели и сохранить выбор.
/plan Переключиться в режим планирования и при необходимости отправить запрос. Попросить Codex предложить план выполнения до начала реализации.
/goal Задать, изменить, приостановить, возобновить, просмотреть или удалить цель задачи. Задать Codex постоянную цель для отслеживания во время выполнения более крупной задачи.
/personality Выбрать стиль общения для ответов. Сделать ответы Codex более краткими, подробными или ориентированными на совместную работу, не изменяя инструкции.
/ps Показать фоновые терминалы и их недавний вывод. Проверить длительно выполняющиеся команды, не покидая основную расшифровку.
/stop Остановить все фоновые терминалы. Отменить работу в фоновых терминалах, запущенную текущим сеансом.
/fork Ответвить текущий чат в новый чат. Создать ответвление активного сеанса для изучения нового подхода без потери текущей расшифровки.
/app Продолжить текущий сеанс в настольном приложении ChatGPT. Перейти из TUI в настольное приложение на macOS или Windows.
/side, /btw Начать временный дополнительный чат. Задать уточняющий вопрос, не нарушая расшифровку основного чата.
/raw Включить или выключить режим неформатированной прокрутки. Упростить форматирование выделения и копирования в терминале при просмотре длинного вывода.
/resume Возобновить сохранённый чат из списка сеансов. Продолжить работу из предыдущего сеанса CLI, не начиная заново.
/new Начать новый чат в том же сеансе CLI. Сбросить контекст чата, не выходя из CLI, чтобы отправить новый запрос в том же репозитории.
/quit Выйти из CLI. Немедленно покинуть сеанс.
/review Попросить Codex проверить рабочее дерево. Запустить после завершения работы Codex или когда требуется дополнительная проверка локальных изменений.
/status Показать конфигурацию сеанса и расход токенов. Проверить активную модель, политику подтверждений, доступные для записи корневые каталоги и оставшуюся ёмкость контекста.
/usage Просмотреть расход токенов учётной записи или использовать сброс ограничения частоты. Проверить дневную, недельную или совокупную активность токенов ChatGPT непосредственно из TUI.
/debug-config Вывести диагностику слоёв конфигурации и требований. Отладить приоритет и требования политик, включая экспериментальные сетевые ограничения.
/statusline Интерактивно настроить поля строки состояния TUI. Выбрать и изменить порядок элементов нижней панели (модель/контекст/ограничения/git/токены/сеанс) и сохранить их в config.toml.
/title Интерактивно настроить поля заголовка окна или вкладки терминала. Выбрать и изменить порядок таких элементов заголовка, как проект, состояние, ветка обсуждения, ветка Git, модель и ход выполнения задачи.
/theme Выбрать тему подсветки синтаксиса. Предварительно просмотреть и сохранить тему подсветки синтаксиса терминала.
/pets, /pet Выбрать или скрыть терминального питомца. Персонализировать TUI с помощью встроенного или собственного фонового питомца.

/quit и /exit завершают работу CLI. Используйте их только после сохранения или фиксации всех важных изменений.

Используйте /permissions, чтобы настроить, что Codex может делать без предварительного запроса. Используйте /approve только для повторной попытки выполнить недавнее действие, которое было отклонено автоматической проверкой.

Управление сеансом с помощью команд с косой чертой

Следующие рабочие процессы позволяют не сбиваться с курса, не перезапуская Codex.

Выбор активной модели с помощью /model

  1. Запустите Codex и откройте редактор запросов.
  2. Введите /model и нажмите Enter.
  3. Выберите во всплывающем окне модель, например gpt-5.6-luna или gpt-5.6-terra.

Ожидаемый результат: Codex подтвердит новую модель в расшифровке. Выполните /status, чтобы проверить изменение.

Переключение режима Fast с помощью /fast

  1. Введите /fast, чтобы включить уровень обслуживания Fast для текущей модели.
  2. Введите /fast ещё раз, чтобы выключить его.

Ожидаемый результат: Codex переключит уровень и сохранит выбор. В нижней панели TUI также можно отобразить элемент строки состояния режима Fast с помощью /statusline.

Команды уровня Fast зависят от каталога. Если текущая модель не заявляет о поддержке уровня Fast, Codex не покажет /fast.

Выбор стиля общения с помощью /personality

Используйте /personality, чтобы изменить манеру общения Codex, не переписывая запрос.

  1. В активном чате введите /personality и нажмите Enter.
  2. Выберите стиль во всплывающем окне.

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

Codex поддерживает варианты личности friendly, pragmatic и none. Используйте none, чтобы отключить инструкции личности.

Если активная модель не поддерживает инструкции для конкретных личностей, Codex скрывает эту команду.

Переключение в режим планирования с помощью /plan

  1. Введите /plan и нажмите Enter, чтобы переключить активный чат в режим планирования.
  2. Необязательно: укажите текст запроса прямо в команде (например, /plan Propose a migration plan for this service).
  3. При использовании аргументов /plan в строке можно вставлять содержимое или прикреплять изображения.

Ожидаемый результат: Codex перейдёт в режим планирования и использует необязательный встроенный запрос как первый запрос на составление плана.

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

Задание или просмотр цели задачи с помощью /goal

  1. Введите /goal <objective>, чтобы задать цель, например /goal Finish the migration and keep tests green.
  2. Введите /goal, чтобы просмотреть текущую цель.
  3. Используйте /goal edit, чтобы изменить цель. Используйте /goal pause, /goal resume или /goal clear, чтобы приостановить, возобновить или удалить её.

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

Текст цели не должен быть пустым и может содержать не более 4 000 символов. Для более длинных инструкций сохраните сведения в файле и укажите этот файл в цели.

Переключение экспериментальных функций с помощью /experimental

  1. Введите /experimental и нажмите Enter.
  2. Переключите нужные функции (например, Network proxy или Prevent sleep while running), а затем перезапустите Codex, если появится соответствующий запрос.

Ожидаемый результат: Codex сохранит выбранные функции в конфигурации и применит их после перезапуска.

Подтверждение отказа автоматической проверки с помощью /approve

Используйте /approve, если автоматическая проверка отклонила недавнее действие и вы хотите, чтобы Codex повторил его один раз.

  1. Введите /approve.
  2. Подтвердите повторную попытку, когда Codex покажет соответствующее отклонённое действие.

Ожидаемый результат: Codex один раз повторит отклонённое действие в соответствии с текущей политикой сеанса.

Настройка воспоминаний с помощью /memories

  1. Введите /memories.
  2. Выберите, должен ли Codex использовать существующие воспоминания, создавать новые или не использовать воспоминания.

Ожидаемый результат: Codex обновит соответствующие настройки воспоминаний для будущих сеансов.

Использование навыков с помощью /skills

  1. Введите /skills.
  2. Выберите навык, который должен применить Codex.

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

Импорт настроек Claude Code или Cursor с помощью /import

  1. Введите /import.
  2. Выберите Claude Code или Cursor.
  3. Выберите настройки, файлы проекта или недавние чаты, которые нужно перенести.

Ожидаемый результат: Codex откроет средство выбора для импорта из внешнего агента и импортирует выбранные поддерживаемые артефакты в конфигурацию и локальные файлы Codex. При поиске сеансов учитывается до 50 чатов за последние 30 дней.

Запускайте /import из локального сеанса TUI. Команда недоступна во время выполнения задачи, в удалённых сеансах и при подключении к локальному демону сервера приложений.

Описание рабочего процесса в настольном приложении и поддерживаемых типов артефактов см. в разделе Импорт из другого агента.

Очистка терминала и создание нового чата с помощью /clear

  1. Введите /clear и нажмите Enter.

Ожидаемый результат: Codex очистит терминал, сбросит видимую расшифровку и запустит новый чат в том же сеансе CLI.

Чтобы присвоить новому чату имя при создании, выполните /clear release prep.

В отличие от Ctrl+L, /clear запускает новый чат.

Ctrl+L только очищает окно терминала и сохраняет текущий чат. Codex отключает оба действия во время выполнения задачи.

Архивация текущего сеанса с помощью /archive

  1. Введите /archive и нажмите Enter.
  2. Подтвердите архивацию текущего сеанса и выход из Codex.

Ожидаемый результат: Codex архивирует текущий сеанс и закроет интерактивный TUI. Codex сохранит расшифровку сеанса локально; впоследствии её можно восстановить с помощью codex unarchive <SESSION>.

/archive недоступна во время выполнения задачи.

Удаление текущего сеанса с помощью /delete

  1. Введите /delete и нажмите Enter.
  2. Подтвердите удаление текущего сеанса и выход из Codex.

Ожидаемый результат: Codex удалит расшифровку текущего сеанса и закроет интерактивный TUI. Удаление необратимо; также удаляются порождённые дочерние сеансы.

/delete недоступна во время выполнения чата и в дополнительном чате.

Обновление разрешений с помощью /permissions

  1. Введите /permissions и нажмите Enter.
  2. Выберите подходящий для вас набор разрешений, например Auto для автономной работы или Read Only для проверки правок. Если активны именованные профили разрешений, средство выбора также отображает настроенные пользовательские профили и их описания.

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

Добавление контекста IDE с помощью /ide

  1. Введите /ide.
  2. При необходимости добавьте текст в той же строке, чтобы пояснить, что Codex должен сделать с текущим выделением IDE или открытыми файлами.

Ожидаемый результат: Codex добавит доступный контекст IDE в следующий запрос.

Переключение режима Vim с помощью /vim

  1. Введите /vim.
  2. Продолжите редактирование в редакторе запросов.

Ожидаемый результат: Codex переключит режим Vim редактора запросов для текущего сеанса. Чтобы режим Vim по умолчанию использовался в новых сеансах, задайте tui.vim_mode_default = true в config.toml.

Настройка изолированной среды Windows с повышенными правами с помощью /setup-default-sandbox

Эта команда появляется только в Windows, когда Codex использует ограниченную изолированную среду с ограниченным токеном доступа.

  1. Введите /setup-default-sandbox.
  2. Выполните настройку с правами администратора.

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

Копирование последнего ответа с помощью /copy

  1. Введите /copy и нажмите Enter.

Ожидаемый результат: Codex скопирует последний завершённый вывод Codex в буфер обмена.

Если ход ещё выполняется, /copy использует последний завершённый вывод вместо выполняемого ответа. Команда недоступна до появления первого завершённого вывода Codex и сразу после отката.

Также можно нажать Ctrl+O в основном TUI, чтобы скопировать последний завершённый ответ, не открывая меню команд с косой чертой.

Переключение неформатированной прокрутки с помощью /raw

  1. Введите /raw, /raw on или /raw off.

Ожидаемый результат: Codex переключит режим неформатированной прокрутки, упрощающий выделение и копирование в терминале. Также можно использовать стандартное сочетание Alt+R или сохранить этот режим по умолчанию с помощью tui.raw_output_mode = true.

Предоставление изолированной среде доступа на чтение с помощью /sandbox-add-read-dir

Эта команда доступна только при нативном запуске CLI в Windows.

  1. Введите /sandbox-add-read-dir C:\absolute\directory\path и нажмите Enter.
  2. Убедитесь, что путь указывает на существующий каталог и является абсолютным.

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

Проверка сеанса с помощью /status

  1. В любом чате введите /status.
  2. Просмотрите активную модель, политику подтверждения, доступные для записи корневые каталоги и текущий расход токенов. При удалённом подключении TUI вывод также содержит удалённый адрес и версию сервера.

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

Просмотр расхода ресурсов учётной записи с помощью /usage

  1. Введите /usage, чтобы открыть меню использования.
  2. Выберите просмотр активности токенов или использование доступного заработанного сброса лимита.
  3. Чтобы сразу открыть активность токенов, введите /usage daily, /usage weekly или /usage cumulative.

Ожидаемый результат: Codex откроет действия с использованием ресурсов или покажет активность токенов учётной записи для выбранного представления. Если в сеансе нет авторизации учётной записи службы Codex, Codex попросит войти.

Проверка слоёв конфигурации с помощью /debug-config

  1. Введите /debug-config.
  2. Просмотрите порядок слоёв конфигурации (от низшего приоритета к высшему), их состояние включения/выключения и источники политик.

Ожидаемый результат: Codex выведет диагностику слоёв и такие сведения о политиках, как allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules и experimental_network, если они настроены.

Используйте этот вывод, чтобы выяснить, почему действующая настройка отличается от config.toml.

Настройка элементов нижней панели с помощью /statusline

  1. Введите /statusline.
  2. С помощью средства выбора включите или выключите элементы, измените их порядок и подтвердите выбор.

Ожидаемый результат: Строка состояния нижней панели немедленно обновится, а настройки будут сохранены в tui.status_line в config.toml.

Среди доступных элементов строки состояния — модель, модель+рассуждения, статистика контекста, ограничения частоты, ветка git, счётчики токенов, идентификатор сеанса, текущий каталог/корневой каталог проекта и версия Codex.

Настройка элементов заголовка терминала с помощью /title

  1. Введите /title.
  2. С помощью средства выбора включите или выключите элементы, измените их порядок и подтвердите выбор.

Ожидаемый результат: Заголовок окна или вкладки терминала немедленно обновится, а настройки будут сохранены в tui.terminal_title в config.toml.

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

Выбор темы синтаксиса с помощью /theme

  1. Введите /theme.
  2. Предварительно просмотрите тему в средстве выбора и подтвердите выбор.

Ожидаемый результат: Codex обновит подсветку синтаксиса и сохранит выбор в tui.theme в config.toml.

Выбор терминального питомца с помощью /pets

  1. Введите /pets (или /pet), чтобы открыть средство выбора питомца.
  2. Выберите встроенного или собственного питомца либо отключите питомцев.

Ожидаемый результат: Codex отобразит выбранного фонового питомца в поддерживаемых терминалах и сохранит выбор. Чтобы скрыть его, также можно ввести /pets off.

Переназначение сочетаний клавиш TUI с помощью /keymap

Используйте /keymap, чтобы просматривать, изменять и сохранять назначения сочетаний клавиш TUI.

  1. Введите /keymap.
  2. Выберите контекст сочетания клавиш и действие, которое хотите изменить.
  3. Введите новое сочетание или удалите существующее.

Ожидаемый результат: Codex обновит активную раскладку клавиш и запишет пользовательское сочетание в tui.keymap в config.toml.

В сочетаниях клавиш используются такие названия, как ctrl-a, shift-enter и page-down. Контекстные сочетания переопределяют tui.keymap.global; пустой список сочетаний отменяет привязку действия.

Проверка фоновых терминалов с помощью /ps

  1. Введите /ps.
  2. Просмотрите список фоновых терминалов и их состояние.

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

Фоновые терминалы появляются при использовании unified_exec; в противном случае список может быть пуст.

Остановка фоновых терминалов с помощью /stop

  1. Введите /stop.
  2. Подтвердите действие, если Codex запросит подтверждение перед остановкой указанных терминалов.

Ожидаемый результат: Codex остановит все фоновые терминалы текущего сеанса. /clean по-прежнему доступна как псевдоним для /stop.

Сокращение расшифровок с помощью /compact

  1. После продолжительного диалога введите /compact.
  2. Подтвердите действие, когда Codex предложит суммировать предшествующую часть чата.

Ожидаемый результат: Codex заменит предыдущие ходы краткой сводкой, освободив контекст и сохранив важные сведения.

Проверка изменений с помощью /diff

  1. Введите /diff, чтобы просмотреть различия Git.
  2. Прокрутите вывод внутри CLI, чтобы проверить изменения и добавленные файлы.

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

Выделение файлов с помощью /mention

  1. Введите /mention и путь, например /mention src/lib/api.ts.
  2. Выберите подходящий результат во всплывающем окне.

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

Создание нового чата с помощью /new

  1. Введите /new и нажмите Enter.

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

Чтобы присвоить новому чату имя при создании, выполните /new bug bash.

В отличие от /clear, /new сначала не очищает текущее окно терминала.

Переименование текущего чата с помощью /rename

  1. Введите /rename <name> или /rename, чтобы открыть запрос имени.
  2. Введите короткое имя, которое поможет впоследствии найти чат.

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

Возобновление сохранённого чата с помощью /resume

  1. Введите /resume и нажмите Enter.
  2. Выберите нужный сеанс в средстве выбора сохранённых сеансов.

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

Ответвление текущего чата с помощью /fork

  1. Введите /fork и нажмите Enter.

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

Чтобы ответвить сохранённый, а не текущий сеанс, выполните codex fork в терминале и откройте средство выбора сеансов.

Продолжение работы в настольном приложении с помощью /app

В macOS и Windows введите /app, чтобы открыть текущий сеанс в настольном приложении ChatGPT. Если приложение не установлено или не запущено, Codex покажет сообщение об ошибке с просьбой установить или запустить его.

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

Создание дополнительного чата с помощью /side

Используйте /side, чтобы создать временное ответвление текущего чата, не покидая основной чат.

  1. Введите /side, чтобы открыть дополнительный чат.
  2. При необходимости добавьте текст в той же строке, например /side Check whether this plan has an obvious risk.
  3. Вернитесь в родительский чат после завершения целевого отступления.

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

/side недоступна внутри другого дополнительного чата и в режиме проверки.

Создание AGENTS.md с помощью /init

  1. Выполните /init в каталоге, где Codex должен искать постоянные инструкции.
  2. Проверьте созданный AGENTS.md, а затем измените его в соответствии с правилами репозитория.

Ожидаемый результат: Codex создаст каркас AGENTS.md, который можно доработать и зафиксировать для будущих сеансов.

Запрос проверки рабочего дерева с помощью /review

  1. Введите /review.
  2. Затем введите /diff, если хотите просмотреть точные изменения файлов.

Ожидаемый результат: Codex суммирует обнаруженные в рабочем дереве проблемы, уделяя особое внимание изменениям поведения и отсутствующим тестам. Используется модель текущего сеанса, если только в config.toml не задано review_model.

Вывод списка инструментов MCP с помощью /mcp

  1. Введите /mcp.
  2. Просмотрите список доступных серверов и инструментов MCP.

Ожидаемый результат: Вы увидите настроенные инструменты Model Context Protocol (MCP), которые Codex может вызывать в этом сеансе.

Используйте /mcp verbose, чтобы добавить подробную диагностику серверов. Если передать что-либо, кроме verbose, Codex покажет справку по использованию команды.

Просмотр приложений с помощью /apps

  1. Введите /apps.
  2. Выберите приложение из списка.

Ожидаемый результат: Codex вставит упоминание приложения в редактор запросов как $app-slug, чтобы вы могли сразу попросить Codex использовать его.

Просмотр плагинов с помощью /plugins

  1. Введите /plugins.
  2. Выберите вкладку магазина, а затем плагин, чтобы изучить его возможности или доступные действия.

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

Просмотр обработчиков событий жизненного цикла и управление ими с помощью /hooks

  1. Введите /hooks.
  2. Выберите событие жизненного цикла, чтобы проверить соответствующие обработчики.
  3. При необходимости назначьте неуправляемые обработчики доверенными, отключите или снова включите их.

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

Переключение веток агентов с помощью /agent

  1. Введите /agent или /subagents и нажмите Enter.
  2. Выберите нужную ветку в средстве выбора.

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

Отправка отзыва с помощью /feedback

  1. Введите /feedback и нажмите Enter.
  2. Следуйте указаниям, чтобы приложить журналы или диагностические данные.

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

Выход из учётной записи с помощью /logout

  1. Введите /logout и нажмите Enter.

Ожидаемый результат: Codex удалит локальные учётные данные текущего пользовательского сеанса.

Выход из CLI с помощью /quit или /exit

  1. Введите /quit (или /exit) и нажмите Enter.

Ожидаемый результат: Codex немедленно завершит работу. Сначала сохраните или зафиксируйте все важные изменения.

Команды расширения IDE

Используйте эти команды для управления Codex из палитры команд VS Code. Им также можно назначить сочетания клавиш.

Назначение сочетания клавиш

Чтобы назначить или изменить сочетание клавиш для команды Codex:

  1. Откройте палитру команд (Cmd+Shift+P в macOS или Ctrl+Shift+P в Windows/Linux).
  2. Выполните команду Preferences: Open Keyboard Shortcuts.
  3. Найдите Codex или идентификатор команды (например, chatgpt.newChat).
  4. Нажмите значок карандаша и введите нужное сочетание клавиш.

Команды расширения

Команда Сочетание клавиш по умолчанию Описание
chatgpt.addToThread - Добавить выделенный диапазон текста как контекст текущего чата
chatgpt.addFileToThread - Добавить весь файл как контекст текущего чата
chatgpt.newChat macOS: Cmd+N
Windows/Linux: Ctrl+N		 Создать новый чат
chatgpt.newCodexPanel - Создать новую панель Codex
chatgpt.openCommandMenu - Открыть меню команд Codex
chatgpt.openSidebar - Открыть боковую панель Codex

Команды расширения IDE с косой чертой

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

Использование команды с косой чертой

  1. В редакторе запросов Codex введите /.
  2. Выберите команду из списка или продолжайте вводить текст для фильтрации (например, /status).
  3. Нажмите Enter.

Доступные команды с косой чертой

Команда с косой чертой Описание
/approve Разрешить одну повторную попытку после недавнего отказа автоматической проверки, когда она активна.
/cloud Запустить чат в облаке, если доступно облачное выполнение.
/cloud-environment Выбрать облачное окружение для чата.
/compact Сжать контекст текущего чата.
/fast Включить или выключить предоставляемый каталогом уровень обслуживания Fast, если он доступен.
/feedback Открыть диалог отправки отзыва с возможностью приложить журналы.
/fork Скопировать локальный чат в новый локальный чат.
/goal Задать постоянную цель, к которой будет стремиться Codex.
/ide-context Включить или выключить автоматический контекст IDE.
/init Создать каркас AGENTS.md для текущего проекта.
/local Запустить чат в локальном рабочем пространстве.
/mcp Открыть состояние MCP для просмотра подключённых серверов.
/memories Настроить возможность использования или создания воспоминаний в чате, когда доступна функция Memories.
/model Выбрать модель для текущего чата.
/personality Выбрать манеру ответов Codex, когда текущая модель поддерживает личности.
/plan Переключить режим планирования для многоэтапного планирования.
/project Выбрать проект для новых чатов.
/reasoning Выбрать глубину рассуждений для текущего чата.
/review Запустить режим проверки кода для проверки незафиксированных изменений или сравнения с базовой веткой.
/side Начать временный дополнительный чат, не прерывая основной чат.
/status Показать идентификатор чата, использование контекста и ограничения частоты.
/worktree Запустить чат в новом рабочем дереве Git.