CLI-интерфейс Codex - это сумма глобальных флагов, команд и их собственных опций, и полный набор всегда шире любой статической таблицы. Самый точный источник - codex --help и --help конкретной команды: он отражает именно вашу версию, тогда как записанный список устаревает. Этот справочник даёт карту наиболее употребимых флагов и команд по группам; exact semantics и зрелость каждого пункта определяет официальная страница CLI reference, с которой сверяются перед тем, как строить на флаге рабочий процесс.
Глобальные флаги задают границы и контекст запуска. Ключевые из них уже встречались в книге: --sandbox выбирает режим песочницы, --ask-for-approval - политику подтверждений, --profile применяет именованный профиль, --add-dir расширяет доступ к каталогу, --cd задаёт рабочий каталог, -c даёт разовое переопределение config. Именно эти флаги чаще всего определяют, что агент может и как себя ведёт, поэтому их понимают в первую очередь, а не заучивают редкие опции.
Команды покрывают разные режимы работы. exec - неинтерактивный запуск для скриптов и CI; review - обзор изменений; mcp add и mcp list - управление MCP-серверами; mcp-server и app-server - роль Codex как сервера; login и logout - вход; execpolicy check - проверка правил; remote-control - экспериментальное удалённое управление. Каждая команда - это отдельный режим со своим набором опций, и её поведение уточняют через её собственный --help.
Полезно один раз свести ключевые флаги и команды в таблицу, чтобы выбирать по назначению. Ниже - карта по группам. Пользоваться ей стоит с общей оговоркой справочника: наличие флага здесь не гарантирует его присутствия в вашей версии, а редкие и экспериментальные опции особенно стоит сверять с официальной документацией. Быстро меняющиеся флаги проверяют командой, а не памятью, прежде чем закладывать их в автоматизацию.
| Группа | Флаг / команда | Назначение |
|---|---|---|
| Границы | --sandbox / --ask-for-approval | Режим песочницы / политика подтверждений |
| --add-dir / --cd | Доп. каталог / рабочий каталог | |
| Config | --profile / -c key=value / --strict-config | Профиль / разовое переопределение / строгая проверка |
| Ввод | --search / --image | Live web search / изображение в prompt |
|---|
| Неинтерактив | exec / --json / --output-schema | Запуск без TUI / события / structured output |
|---|
| Обзор | review / review --uncommitted | Обзор изменений / незакоммиченного |
|---|
| MCP | mcp add / mcp list / mcp-server | Клиент MCP / список / Codex как сервер |
|---|
| Сервер | app-server / --ws-auth | Протокольный хост / auth транспорта |
|---|
| Вход/диагностика | login / logout / doctor | Управление входом / проверка установки |
|---|
| Удалённо | --remote / remote-control | Удалённый хост / экспериментальное управление |
|---|