OpenAI Codex CLI — нативный терминальный агент программирования от OpenAI, который анализирует кодовые базы, редактирует файлы, запускает тесты, интегрируется с удалёнными задачами Codex Cloud и подключается к внешним инструментам через MCP прямо из командной строки.
Эта шпаргалка охватывает подкоманды и флаги Codex CLI, политики песочницы и подтверждений, интерактивные слэш-команды TUI, горячие клавиши и конфигурацию config.toml / AGENTS.md.
🔗 Связанные шпаргалки: Сравнение терминальных AI-агентов CLI · Шпаргалка по Claude Code CLI · Шпаргалка по Antigravity CLI (agy) · Архитектура и среда исполнения AI Agent Harness
1. Установка, аутентификация и основные команды CLI
1.1 Установка и аутентификация
| Действие | Команда | Примечания |
|---|---|---|
| Глобальная установка через npm | npm install -g @openai/codex |
Стандартная кроссплатформенная установка |
| Официальный скрипт установки | curl -fsSL https://chatgpt.com/codex/install.sh | sh |
Однострочный установщик для macOS / Linux |
| Вход через браузер | codex login |
Аутентификация через аккаунт ChatGPT Plus / Pro / Team |
| Аутентификация по API-ключу | export OPENAI_API_KEY="sk-..." |
Идеально для headless CI или контейнерных сред |
1.2 Подкоманды CLI и глобальные флаги
| Команда / Флаг | Описание | Пример использования |
|---|---|---|
codex |
Запустить интерактивный TUI в текущем каталоге | codex |
codex "prompt" |
Начать интерактивную сессию с начальным промптом | codex "Debug 500 timeout errors on login" |
codex exec / codex e |
Неинтерактивное (headless) выполнение для скриптов и CI | codex exec "Run all unit tests and fix failures" |
codex exec --json |
Потоковый вывод структурированных JSON-логов рассуждений и правок файлов | codex exec --json "Refactor utils" > run.jsonl |
codex review |
Неинтерактивное код-ревью по текущему Git diff | codex review |
codex resume |
Открыть выбор сессии (хранятся в ~/.codex/sessions/) |
codex resume / codex resume --last / codex resume <id> |
codex apply / codex a |
Применить в локальном рабочем пространстве диффы из задач Codex Cloud | codex apply <task_id> |
codex cloud |
Просмотр или управление удалёнными задачами Codex Cloud | codex cloud |
codex mcp |
Управление интеграциями серверов Model Context Protocol (MCP) | codex mcp list / codex mcp add <name> ... |
-m, --model <name> |
Указать используемую модель для сессии или запуска | codex -m gpt-6.1-sol |
--strict-config |
Строгая проверка синтаксиса и ключей config.toml |
codex --strict-config |
2. Матрица политик песочницы (Sandbox) и подтверждений
Codex CLI разделяет права на два независимых слоя: к чему среда имеет доступ (--sandbox) и когда запрашивать подтверждение пользователя (--ask-for-approval).
| Флаг | Допустимые значения | Поведение и рекомендуемое применение |
|---|---|---|
--sandbox <mode>(алиас -s) |
read-only |
Только чтение: анализ и поиск по коду без изменения файлов |
workspace-write |
Запись в рабочую область (рекомендуется по умолчанию): правки разрешены только внутри рабочего дерева | |
danger-full-access |
Полный доступ без ограничений: полный доступ к ФС и системе (только в изолированных контейнерах) | |
--ask-for-approval <policy> |
on-request |
Рекомендуется по умолчанию: модель запрашивает подтверждение перед рискованными действиями |
on-failure |
Эскалация только при сбое (используйте on-request, если важны запросы на повышение прав песочницы) |
|
never |
Полностью тихий режим: никогда не спрашивать интерактивно (для CI и автоматических пайплайнов) |
⚠️ Уведомление об устаревших и удалённых флагах:
- Флаг
--full-autoобъявлен устаревшим (deprecated) начиная сv0.128.0. Задавайте политики песочницы и подтверждений явно:codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"- Политика подтверждений
untrustedбыла удалена вv0.149.0; обновите конфигурации наon-request.
3. Интерактивные слэш-команды в TUI
Введите / в интерактивной строке codex TUI для управления контекстом, правами и рабочими процессами:
3.1 Контекст, модели и права доступа
| Команда | Функция | Примечания и применение |
|---|---|---|
/init |
Сгенерировать стартовый AGENTS.md под репозиторий |
Рекомендуемый первый шаг в новом проекте |
/status |
Проверить активную модель, права доступа и расход токенов | Отслеживание оставшегося объёма контекста |
/model |
Интерактивно переключить модель и уровень Reasoning Effort | Настройка глубины рассуждений без перезапуска |
/permissions |
Изменить режим песочницы и политику подтверждений в ходе сессии | Усиление или ослабление ограничений по ситуации |
/mcp |
Проверить и настроить подключённые MCP-серверы | Проверка связи с внешними инструментами и БД |
3.2 Инженерные процессы и управление сессией
| Команда | Функция | Примечания и применение |
|---|---|---|
/plan |
Составить и согласовать план реализации до правки файлов | Выравнивание архитектуры перед крупным рефакторингом |
/review |
Провести разностороннее ревью незакоммиченных изменений | Выявление багов, пограничных случаев и угроз безопасности |
/diff |
Просмотреть текущие незакоммиченные изменения файлов | Построчная проверка диффов перед принятием |
/fork |
Разветвить ветку диалога в отдельную контрольную точку | Проверка альтернативного подхода без засорения основного контекста |
/compact |
Сжать историю диалога для освобождения контекстного окна | Защита от деградации в длинных многоходовых сессиях |
/copy |
Скопировать последний завершённый ответ в буфер обмена | Быстрое извлечение патчей или сводок |
/title |
Переименовать текущую ветку диалога | Упрощает поиск сессий в codex resume |
/statusline / /theme |
Настроить элементы строки статуса внизу или цветовую тему TUI | Персонализация отображения в терминале |
/prompts:<name> |
Вызвать пользовательский Markdown-шаблон промпта | Выполняет файл ~/.codex/prompts/<name>.md |
4. Горячие клавиши терминала и синтаксис ввода
| Сочетание / Синтаксис | Действие | Эффект и сценарий |
|---|---|---|
@<path> |
Нечёткая ссылка на файл | Подставляет содержимое файла в контекст (напр., @src/auth.ts) |
!<command> |
Локальная shell-команда в строке | Выполняет shell-команды в рамках активных правил песочницы (напр., !npm test) |
Tab |
Поставить следующий промпт в очередь | Ставит в очередь следующий промпт, слэш-команду или !-команду во время работы Codex |
Enter |
Прервать / скорректировать на ходу | Вводит дополнительные указания, пока агент активно отвечает |
Ctrl + G |
Открыть внешний редактор | Набирайте многострочные промпты в $VISUAL / $EDITOR (Vim, VS Code и др.) |
Ctrl + R |
Поиск по истории промптов | Обратный поиск по ранее отправленным запросам |
Ctrl + L |
Очистить и перерисовать экран | Очищает визуальный шум в терминале, сохраняя состояние диалога |
Ctrl + O |
Скопировать последний вывод | Эквивалент команды /copy |
Ctrl + X |
Открыть меню клавиатуры | Доступ к раскладкам горячих клавиш и расширениям |
Ctrl + C |
Отмена / Выход | Прерывает активную задачу или завершает сессию Codex |
5. Конфигурационные файлы и иерархия памяти (config.toml и AGENTS.md)
Настройки уровня проекта переопределяют глобальные значения пользователя по умолчанию:
| Уровень | Глобальная область (все репо) | Область проекта (текущее репо) | Назначение |
|---|---|---|---|
| Базовая конфигурация | ~/.codex/config.toml |
.codex/config.toml |
Модель по умолчанию, песочница, политика подтверждений, доступ в сеть, MCP |
| Инструкции агенту | ~/.codex/AGENTS.md |
./AGENTS.md (корень репо) |
Команды сборки и тестов, стандарты кода, архитектурные правила |
| Пользовательские промпты | ~/.codex/prompts/*.md |
— | Переиспользуемые шаблоны для слэш-команд /prompts:<name> |
| Логи сессий | ~/.codex/sessions/ |
— | Постоянные журналы сессий, восстанавливаемые через codex resume |
Минимальный рекомендуемый ~/.codex/config.toml
# Модель по умолчанию
model = "gpt-6.1-sol"
# Режим песочницы и политика подтверждений по умолчанию
sandbox_mode = "workspace-write"
approval_policy = "on-request"
# По умолчанию ограничить исходящий сетевой доступ внутри песочницы
network_access = false