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

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

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

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

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

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

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

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

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

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

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

Обзор команд

Подробное описание команд

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

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

Используйте --remote ws://host:port или --remote wss://host:port, чтобы подключить TUI к серверу приложений, запущенному с помощью 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 локально. Он предназначен преимущественно для разработки и отладки и может измениться без предупреждения.

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 выводит путь, который нужно открыть.

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

codex debug app-server send-message-v2

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

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

codex debug models

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

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

codex debug prompt-input

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

codex apply

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

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

codex review

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

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

codex archive и codex unarchive

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

codex archive <SESSION>
codex unarchive <SESSION>

codex delete

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

codex delete <SESSION>
codex delete <SESSION_UUID> --force

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

codex cloud

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

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

codex cloud list

Показать последние облачные чаты с необязательной фильтрацией и пагинацией.

В обычном текстовом выводе печатается 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".

codex doctor

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

codex features

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

codex exec

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

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

codex execpolicy

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

codex login

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

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

codex logout

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

codex mcp

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

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

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

codex plugin

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

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 может просматривать и из которых может устанавливать плагины.

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.

codex fork

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

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

codex sandbox

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

macOS seatbelt

Linux Landlock

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 CLI: установка, обновления и краткие рекомендации.
• Основы конфигурации: сохранение значений по умолчанию, например модели и провайдера.
• Расширенная конфигурация: профили, провайдеры, настройка песочницы и интеграции.
• AGENTS.md: концептуальный обзор возможностей агентов Codex и рекомендаций по работе с ними.

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

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

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

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

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

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

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

/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 Предложи план миграции этого сервиса).
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 с помощью /import

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

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

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

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

Очистка терминала и запуск нового чата с помощью /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, enforce_residency и 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 клонирует текущий чат в новый чат с новым ID, оставляя исходную расшифровку неизменной, чтобы вы могли параллельно изучить альтернативный подход.

Если нужно ответвить сохранённый сеанс вместо текущего, выполните 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 суммирует найденные в рабочем дереве проблемы, уделяя основное внимание изменениям поведения и отсутствующим тестам. Используется модель текущего сеанса, если review_model не задана в config.toml.

Вывод списка инструментов 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. Выберите значок карандаша, затем введите нужное сочетание клавиш.

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

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

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

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

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

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