Команды терминала
Это карта команд, доступных из shell. Точный набор зависит от версии и feature flags, поэтому локальная проверка всегда имеет приоритет:
codex --version
codex --help
codex help <COMMAND>
codex <COMMAND> --helpСтраница сверена с официальным Command line options и codex-cli 0.144.6 20 июля 2026 года.
Основные команды
| Команда | Что делает | Частый пример |
|---|---|---|
codex [PROMPT] | Запускает интерактивный TUI | codex "Проверь проект" |
codex exec / codex e | Выполняет задачу без TUI | codex exec --json "Проверь API" |
codex review | Запускает non-interactive code review | codex review --uncommitted |
codex login | Вход через ChatGPT, device flow, API key или access token | codex login |
codex logout | Удаляет сохранённые credentials | codex logout |
codex resume | Продолжает сохранённый сеанс | codex resume --last |
codex fork | Ветвит сохранённый сеанс в новый чат | codex fork --last |
codex archive | Архивирует сеанс | codex archive <SESSION> |
codex unarchive | Возвращает сеанс из архива | codex unarchive <SESSION> |
codex delete | Безвозвратно удаляет сеанс | codex delete <SESSION> |
codex apply / codex a | Применяет diff cloud-задачи через git apply | codex apply <TASK_ID> |
codex completion | Генерирует shell completion | codex completion zsh |
codex update | Запускает поддерживаемое сборкой самообновление | codex update |
codex doctor | Диагностирует установку, конфиг, auth и runtime | codex doctor --summary |
codex features | Показывает и меняет feature flags | codex features list |
codex sandbox | Запускает произвольную команду в sandbox Codex | codex sandbox -- pwd |
codex mcp | Управляет MCP-серверами | codex mcp list |
codex mcp-server | Запускает сам Codex как MCP server по stdio | codex mcp-server |
codex plugin | Управляет плагинами и marketplaces | codex plugin list |
codex help | Показывает общую или вложенную справку | codex help mcp add |
Команды интеграции с ChatGPT и cloud
| Команда | Статус | Назначение |
|---|---|---|
codex app [PATH] | Stable, зависит от платформы/сборки | Открывает ChatGPT desktop app для рабочей папки на macOS/Windows |
codex cloud | Experimental | Создаёт и просматривает Codex cloud-задачи из терминала |
codex remote-control | Experimental | Управляет локальным app-server daemon и выдаёт короткий pairing code |
Если codex app отсутствует в codex --help, используйте /app внутри TUI или откройте папку в desktop app вручную. Для веб-интерфейса основным путём остаётся chatgpt.com: CLI-вход не запускает web UI автоматически.
Команды разработки и диагностики
| Команда | Статус | Назначение |
|---|---|---|
codex app-server | Experimental | Запускает protocol server по stdio, WebSocket или Unix socket |
codex exec-server | Experimental, зависит от сборки | Запускает отдельный exec-server service |
codex execpolicy | Experimental, зависит от сборки | Проверяет, разрешит ли .rules конкретную команду |
codex debug models | Experimental | Печатает каталог моделей в JSON |
codex debug prompt-input | Experimental | Показывает model-visible prompt input в JSON |
codex debug app-server ... | Experimental | Отлаживает protocol flow app-server |
Эти команды предназначены для интеграций и отладки самого Codex. Для обычной разработки они не нужны, а их интерфейс может меняться.
Вложенные команды
codex exec
codex exec resume продолжить non-interactive сеанс
codex exec review выполнить review из exec-режимаКлючевые флаги: --json, -o/--output-last-message, --output-schema, --ephemeral, --skip-git-repo-check, --ignore-user-config, --ignore-rules. Подробнее — Автоматизация.
codex review
codex review --uncommitted
codex review --base main
codex review --commit <SHA> --title "Название изменения"
codex review "Проверь только auth и обработку ошибок"Цели --uncommitted, --base, --commit и произвольный prompt взаимоисключающие.
codex mcp
| Подкоманда | Назначение |
|---|---|
list | Список серверов |
get <NAME> | Конфигурация одного сервера |
add <NAME> ... | Добавить stdio- или HTTP-сервер |
remove <NAME> | Удалить сервер из конфигурации |
login <NAME> | Пройти OAuth для поддерживаемого HTTP MCP |
logout <NAME> | Удалить OAuth credentials MCP |
codex plugin
| Подкоманда | Назначение |
|---|---|
add <PLUGIN> | Установить plugin из настроенного marketplace |
list | Показать доступные и установленные plugins |
remove <PLUGIN> | Удалить plugin из конфига и кэша |
marketplace add | Добавить локальный или Git marketplace |
marketplace list | Показать sources и их roots |
marketplace upgrade | Обновить Git snapshots |
marketplace remove | Удалить source по имени |
codex cloud
| Подкоманда | Назначение |
|---|---|
exec | Отправить новую cloud-задачу без TUI |
status | Проверить статус задачи |
list | Показать cloud-задачи |
diff | Напечатать unified diff |
apply | Применить diff локально |
Это экспериментальный terminal client к cloud-задачам. Перед применением всегда просматривайте diff.
codex features
list список flags, стадий и эффективных значений
enable <FEATURE> включить flag в config.toml
disable <FEATURE> выключить flag в config.tomlcodex remote-control
start запустить app-server daemon с remote control
stop остановить daemon
pair создать короткоживущий pairing codecodex app-server
daemon управление долговечным локальным daemon
proxy прокси stdio к control socket
generate-ts сгенерировать TypeScript bindings
generate-json-schema сгенерировать JSON Schema протоколаУ daemon есть bootstrap, start, restart, stop, version, enable-remote-control и disable-remote-control.
Глобальные флаги
| Флаг | Значение |
|---|---|
-C, --cd <DIR> | Рабочий корень |
--add-dir <DIR> | Дополнительный writable root; можно повторять |
-m, --model <MODEL> | Модель для запуска |
--oss | Локальный open-source provider |
--local-provider <lmstudio|ollama> | Provider для --oss |
-p, --profile <NAME> | Именованный конфигурационный профиль |
-c, --config key=value | Разовое TOML-переопределение |
--enable/--disable <FEATURE> | Разово включить или выключить feature |
--strict-config | Ошибка на неизвестных ключах |
-s, --sandbox <MODE> | Политика sandbox |
-a, --ask-for-approval <POLICY> | Политика подтверждений |
-i, --image <FILE>... | Изображения к первому prompt |
--search | Live web search |
--no-alt-screen | Inline TUI со scrollback |
--remote <ADDR> | Подключение TUI к app-server endpoint |
--remote-auth-token-env <ENV_VAR> | Имя переменной с bearer token для remote |
-h, --help | Справка |
-V, --version | Версия |
Аварийный флаг
--dangerously-bypass-approvals-and-sandbox (также встречается как --yolo) отключает и approvals, и sandbox. Используйте его только внутри внешне изолированной одноразовой среды. Для повседневной работы он не нужен.