Commands and Configuration Cheatsheet
📚 Навигация по серии: Предыдущая статья 〔34 Комплексная практика〕 провела вас через весь жизненный цикл разработки фичи в проекте с использованием Codex. В этой главе мы собрали все команды, флаги и конфигурационные ключи из предыдущих тридцати статей в одну краткую справочную шпаргалку. В следующей статье 〔36 Лучшие практики〕 мы подведем итог и поговорим о принципах эффективного использования Codex.
Признаюсь честно: в первые два месяца использования Codex у меня на компьютере лежал файл codex-notes.txt, куда я в хаотичном порядке записывал параметры вроде «вывод в формате JSON — это --json» или «сохранение отчета — это -o». Проблема была в том, что из-за плохого структурирования я тратил много времени на поиск нужного флага codex exec: сначала искал в заметках, потом в истории терминала через history | grep codex, а иногда просто открывал документацию в браузере. То, что должно было занимать секунды, отнимало минуты.
Еще сложнее было с файлом конфигурации. Например, мне нужно было временно отключить доступ к сети для песочницы. Я помнил, что параметр начинается со строки sandbox_workspace_write, но как именно пишется ключ — network или net_access? Приходилось подбирать параметры в config.toml наугад до тех пор, пока Codex не запустился без ошибок. Это подтолкнуло меня к решению: собрать все часто используемые команды и настройки в одну шпаргалку, чтобы не тратить время на поиски.
Эта статья — готовый справочник. Мы опускаем теоретическое описание (оно было приведено в соответствующих главах) и фокусируемся только на быстром доступе к параметрам.
Прочитав эту статью, вы получите:
- Единую шпаргалку по установке, авторизации, ключам запуска CLI, командам чата и параметрам
config.toml - Таблицы соответствия уровней песочницы, моделей и интенсивности рассуждений
- Справочник по работе с MCP-серверами, под-агентами и Skills
- Инструкцию по проверке работы команд на локальной машине
⚠️ Имена флагов и параметров конфигураций соответствуют официальной документации. Версии моделей и значения по умолчанию зависят от вашей локальной среды, проверяйте их в выводе справки
codex --helpи файлеconfig.toml. Текущая версия утилиты выводится командойcodex --version. Экспериментальные функции снабжены соответствующими пометками.
01 Установка и авторизация
Список команд для развертывания окружения и настройки прав доступа.
Для установки и авторизации в условиях сетевых ограничений может потребоваться настройка прокси-серверов.
| Задача | Команда | Платформа / Примечание |
|---|---|---|
| Установка (скрипт) | curl -fsSL https://chatgpt.com/codex/install.sh | sh | macOS / Linux |
| Установка (PowerShell) | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" | Windows |
| Установка через npm | npm install -g @openai/codex | Все платформы (требуется Node.js) |
| Установка через Homebrew | brew install --cask codex | macOS |
| Обновление утилиты | codex update | При поддержке автообновления дистрибутивом |
| Авторизация (в браузере) | codex login | Стандартный способ через OAuth ChatGPT |
| Авторизация (код устройства) | codex login --device-auth | Для серверов без браузера (например, по SSH) |
| Авторизация по API-ключу | printenv OPENAI_API_KEY | codex login --with-api-key | Чтение ключа из стандартного ввода |
| Статус авторизации | codex login status | Возвращает код 0 при успешном входе |
| Выход из аккаунта | codex logout | Удаление локальных учетных данных |
| Диагностика окружения | codex doctor | Самопроверка установки, сети, Git и авторизации |
💡 Резюме в одном предложении: Запустите
codex doctorдля проверки окружения после установки и убедитесь в успешной авторизации черезcodex login status.
02 Команды и флаги запуска Codex CLI
Основной блок параметров запуска командной строки. Параметры состоят из системной команды и флагов настройки поведения.
Системные команды CLI
| Команда | Назначение | Статус |
|---|---|---|
codex | Запуск интерактивного текстового интерфейса (TUI) | Стабильно |
codex exec | Неинтерактивный запуск одной задачи (короткая форма codex e) | Стабильно |
codex resume | Восстановление предыдущей интерактивной сессии | Стабильно |
codex fork | Создание ответвления сессии с сохранением исходной ветки | Стабильно |
codex apply | Применение облачного патча к локальным файлам (короткая форма codex a) | Стабильно |
codex mcp | Управление серверами MCP (список, добавление, удаление, вход) | Экспериментально |
codex features | Просмотр и переключение флагов возможностей | Стабильно |
codex completion | Генерация скриптов автодополнения для терминала | Стабильно |
Общие флаги запуска (для большинства команд)
| Флаг | Назначение | Описание / Значения |
|---|---|---|
--model / -m | Разовый выбор модели | Например, -m gpt-5.5 |
--image / -i | Прикрепить изображение к первому запросу | Пути через запятую или повторением флага -i |
--cd / -C | Смена рабочей папки перед запуском | Путь к целевому каталогу |
--sandbox / -s | Выбор режима песочницы | read-only, workspace-write, danger-full-access |
--ask-for-approval / -a | Выбор политики подтверждений | untrusted, on-request, never |
--search | Активация поиска в сети | Режимы live (прямой поиск) или cached (по умолчанию) |
--add-dir | Добавить папку в список разрешенных на запись | Предотвращает запуск полного доступа к диску |
--profile / -p | Использование профиля настроек | Накладывается поверх глобальной конфигурации |
--config / -c | Разовое переопределение параметра | -c key=value в формате TOML |
--yolo | Отключение песочницы и подтверждений | Опасно, используйте только в изоляторах |
Флаги неинтерактивного режима codex exec
Используются при написании скриптов и автоматизации в CI/CD.
| Флаг | Назначение |
|---|---|
PROMPT со значением - | Чтение текста инструкции из stdin (например, cat prompt.txt | codex exec -) |
--json | Переключение вывода stdout в формат JSONL для jq-парсинга |
--output-last-message / -o | Запись итогового ответа в файл с дублированием в stdout |
--output-schema | Передача JSON Schema для структурирования ответа |
--skip-git-repo-check | Разрешение запуска в папках без Git |
--ephemeral | Запуск без сохранения логов сессии на диске |
--full-auto | Устаревший флаг, заменяйте его на --sandbox workspace-write |
codex exec resume --last | Продолжение последней неинтерактивной сессии |
💡 Резюме в одном предложении: Флаги
-m(модель),-s(песочница),-a(подтверждения) и-o/--json(вывод) покрывают большинство задач настройки запуска CLI.
03 Команды чата (внутри интерактивного TUI)
Команды вводятся внутри сессии чата после символа /.
| Команда | Назначение |
|---|---|
/model | Смена модели и настройка интенсивности рассуждений |
/status | Просмотр активной модели, лимитов контекста и разрешенных папок |
/compact | Сжатие истории диалога для освобождения памяти сессии |
/diff | Просмотр изменений в репозитории (включая неструктурированные файлы) |
/permissions | Настройка прав выполнения команд без подтверждений пользователя |
/review | Запуск локального ревью кода текущей папки |
/init | Создание шаблона файла AGENTS.md в корне проекта |
/mcp | Список доступных инструментов подключенных серверов MCP |
/skills | Просмотр и активация локальных сценариев Skills |
/agent | Переключение контекстов между запущенными под-агентами |
/fast | Переключение службы Fast (команды on, off, status) |
/new | Открытие нового диалога в рамках текущего процесса CLI |
/clear | Очистка экрана консоли и запуск нового диалога |
/quit или /exit | Завершение работы CLI |
Команда /fast доступна только для моделей, поддерживающих приоритет обработки запросов на стороне серверов OpenAI.
💡 Резюме в одном предложении: Команды
/model(модель),/status(статус),/compact(сжатие) и/diff(изменения) являются основными командами управления ходом сессии чата.
04 Ключи конфигурационного файла config.toml
Параметры прописываются в глобальном файле ~/.codex/config.toml для фиксации настроек по умолчанию.
| Ключ | Назначение | Значения |
|---|---|---|
model | Модель по умолчанию | "gpt-5.5" |
model_reasoning_effort | Интенсивность рассуждений | minimal, low, medium, high, xhigh |
model_reasoning_summary | Вывод хода рассуждений | auto, concise, detailed, none |
service_tier | Класс обслуживания запросов | flex, fast (требует флага fast_mode) |
sandbox_mode | Режим песочницы по умолчанию | read-only, workspace-write, danger-full-access |
sandbox_workspace_write.network_access | Разрешение сети для записи | true или false |
sandbox_workspace_write.writable_roots | Список дополнительных папок записи | ["/path/a", "/path/b"] |
approval_policy | Политика подтверждений | untrusted, on-request, never |
web_search | Режим поиска информации в сети | disabled, cached, live (по умолчанию cached) |
review_model | Модель для запуска /review | Имя модели (по умолчанию — текущая модель сессии) |
model_instructions_file | Файл пользовательских инструкций | Путь к файлу правил |
Пример готового файла config.toml:
model = "gpt-5.5"
model_reasoning_effort = "medium"
sandbox_mode = "workspace-write"
approval_policy = "on-request"
[sandbox_workspace_write]
network_access = false💡 Резюме в одном предложении: Укажите ключи
model,model_reasoning_effort,sandbox_modeиapproval_policyв файлеconfig.tomlдля фиксации поведения ИИ при каждом запуске.
05 Режимы песочницы и подтверждений
Матрица настроек безопасности выполнения команд.
Режим песочницы (sandbox_mode) | Описание ограничений | Сфера применения |
|---|---|---|
read-only | Доступ к файлам только на чтение | Анализ кода, составление отчетов |
workspace-write | Запись разрешена только в рабочей папке проекта | Локальная разработка (рекомендуется) |
danger-full-access | Доступ ко всей файловой системе компьютера | Запуск в изолированных контейнерах CI |
Уровень подтверждений (approval_policy) | Логика запросов |
|---|---|
untrusted | Запрос подтверждения для всех небезопасных команд |
on-request | Запрос подтверждения только при выходе за границы песочницы |
never | Выполнение команд без подтверждений (для фоновых задач) |
Рекомендуемая конфигурация для безопасной локальной работы:
codex --sandbox workspace-write --ask-for-approval on-requestИспользуйте флаг --add-dir вместо переключения песочницы в режим danger-full-access при необходимости дать ИИ доступ к внешней папке. Устаревший флаг --full-auto заменяйте на --sandbox workspace-write.
💡 Резюме в одном предложении: Используйте режим «
workspace-write+on-request» для повседневной работы, переключаясь наneverв скриптах CI и подключая внешние папки через--add-dir.
06 Модели и интенсивность рассуждений
Характеристики моделей и интенсивности рассуждений ИИ.
| Модель | Класс | Оптимальные задачи |
|---|---|---|
gpt-5.5 | Флагман | Системный рефакторинг, архитектура, поиск багов |
gpt-5.4-mini | Легкая | Рутинные исправления, написание тестов, под-агенты |
gpt-5.3-codex-spark | Быстрая | Интерактивные сессии, быстрый диалог |
Устаревшие модели gpt-5.2 и gpt-5.3-codex использовать не рекомендуется.
Выбор интенсивности рассуждений (model_reasoning_effort):
| Уровень | Описание | Типичные сценарии |
|---|---|---|
minimal | Без дополнительного анализа | Автозаполнение строк, простые ответы |
low | Краткий анализ | Мелкие исправления |
medium | Сбалансированный режим | Большинство задач кодинга (по умолчанию) |
high | Детальный анализ | Написание сложных алгоритмов |
xhigh | Максимальный анализ | Системная отладка, криптография |
💡 Резюме в одном предложении: Для большинства задач подходит связка «флагман +
medium», с переходом наmini+lowдля рутины и активациейhighпри решении сложных алгоритмических проблем.
07 Управление MCP, под-агентами и Skills
Параметры запуска дополнительных программных интерфейсов.
| Инструмент | Команда / Секция TOML | Применение |
|---|---|---|
| MCP (управление) | codex mcp list / codex mcp add <имя> ... | Управление серверами в консоли, список инструментов в чате по /mcp |
| MCP (авторизация) | codex mcp login <имя> | Авторизация OAuth на серверах HTTP |
| MCP (настройка) | Блок [mcp_servers.<имя>] в TOML | Описание параметров запуска сервера |
| Под-агенты | Раздел [agents] в TOML | Настройка лимитов потоков (max_threads), переключение в чате по /agent |
| Skills | Команда /skills в чате | Вызов и просмотр сценариев. Подключение через [[skills.config]] |
Раздел codex mcp находится в статусе экспериментального функционала, сверяйте параметры с выводом справки codex mcp --help.
💡 Резюме в одном предложении: Используйте команды
codex mcpдля управления серверами, настройки под-агентов в блоке[agents]файла конфигурации и команду/skillsв чате для запуска Skills.
08 Практический тест: проверка параметров
Проверим статус авторизации и работоспособность команд в терминале.
Шаг 1: Проверка статуса авторизации
codex login statusОжидаемый результат: Возврат кода 0 при успешном входе.
Шаг 2: Тестовый запуск неинтерактивного режима
Запустите команду записи отчета в файл в режиме «только чтение»:
codex exec --sandbox read-only -o /tmp/codex-check.txt "Is current directory a Git repository?"(На Windows замените /tmp/ на путь к вашей временной папке).
Ожидаемый результат: Текст ответа выведется на экран и запишется в файл /tmp/codex-check.txt.
Шаг 3: Вызов справки CLI
Проверьте список поддерживаемых параметров утилиты:
codex exec --helpОжидаемый результат: Вывод списка флагов сборки. Справка --help содержит наиболее актуальные данные по параметрам вашей версии CLI.
💡 Резюме в одном предложении: Выполните последовательно команды
login status,codex exec -oиexec --helpдля проверки работоспособности окружения и актуальности флагов CLI.
Итоги
Мы собрали ключевые команды, параметры настроек и флаги безопасности Codex в единую шпаргалку.
Для быстрого доступа используйте подразделы:
- Раздел 01 — для установки и настройки авторизации.
- Раздел 02 — для выбора флагов командной строки CLI.
- Раздел 03 — для вызова команд со слэшем в чате.
- Раздел 04 — для прописывания настроек в
config.toml. - Разделы 05 и 06 — для выбора параметров песочницы и моделей ИИ.
- Раздел 07 — для управления MCP, под-агентами и Skills.
Сохраните этот справочник для быстрого поиска параметров при работе с проектами.
В следующей статье 36 · Лучшие практики мы поговорим о методах эффективного использования Codex. Мы разберем подходы к организации совместной работы ИИ и человека, правила гигиены кода и способы минимизации ошибок при проектировании сложных систем.