Codex CLI: принципы работы и отличия от App и Web
Узнайте, что такое Codex CLI, как он работает в локальном терминале и чем отличается от Codex App и Codex Web. С настройкой, примерами и устранением ошибок.
Codex CLI — это локальный command-line coding agent от OpenAI. Он запускается в терминале, работает с выбранным workspace, читает и изменяет файлы, выполняет команды и применяет ваши sandbox и approval settings. В отличие от Codex App, его основной интерфейс — терминал; в отличие от Codex Web, он работает в локальной среде, а не в browser или remote runtime.
Короткий ответ
Он полезен, когда вы хотите, чтобы агент помогал с правками кода, code review, исправлением тестов, скриптами и многошаговыми инженерными задачами внутри локального репозитория.
Codex CLI отличается от обычного диалога в ChatGPT. Он не только предлагает код, но и работает с текущей директорией, инструкциями проекта, результатами инструментов и локальными разрешениями.
CLI, App и Web: краткое сравнение
| Вариант | Где работает | Когда выбрать |
|---|---|---|
| Codex CLI | В локальном терминале и workspace | Нужны команды, файлы и настройка через config.toml |
| Codex App | В desktop application | Нужны графические сессии, plugins или Remote Control |
| Codex Web | В browser или remote environment | Задача должна выполняться в облачной или удаленной среде |
Для подробного сравнения откройте Codex CLI, Codex App и Codex Web: в чем разница?.
Когда это важно
- Вы впервые устанавливаете
@openai/codex - Вы сравниваете Codex CLI, Codex App и Codex Web
- Вы хотите, чтобы агент редактировал файлы в локальном проекте
- Вам нужно настроить custom API provider, Base URL или модель
- Вы хотите понять sandbox, approval и
AGENTS.md
Основные понятия
| Понятие | Значение |
|---|---|
| Codex CLI | Codex coding agent в локальном терминале |
| Workspace | Директория, которую Codex может читать, искать и изменять |
config.toml | Локальный конфиг Codex для моделей, providers, sandbox, approvals и другого поведения |
AGENTS.md | Проектный файл инструкций с правилами репозитория и договоренностями по работе |
| Sandbox | Локальная граница безопасности для файловой системы, сети и команд |
| Approval | Политика, которая определяет, какие действия требуют подтверждения |
Рекомендуемый workflow
- Запускайте Codex CLI в директории проекта, который хотите изменить.
- Сначала попросите его прочитать релевантные файлы или инструкции, а не сразу делать широкие правки.
- Для сложной задачи попросите план перед изменением файлов.
- Выбирайте sandbox и approval по риску задачи.
- Постоянные правила проекта храните в
AGENTS.md, а разовые требования оставляйте в текущем диалоге.
Если вы используете сторонний API provider, важны поля model_provider, base_url, wire_api и model в config.toml. Codex и другие OpenAI-compatible tools обычно используют OpenAI-compatible endpoint, в этой документации это https://bettertoken.ai/v1.
Частые ошибки
- Воспринимать Codex CLI как обычный chat-only assistant.
- Считать, что Codex CLI, Codex App и Codex Web работают в одной среде.
- Менять только
model, но не настраивать соответствующий provider и Base URL. - Ослаблять sandbox и approval без тестов, code review или границ команд.
- Смешивать OpenAI-compatible и Anthropic-compatible Base URL.
О BetterToken
Если вы используете custom OpenAI-compatible provider, BetterToken может быть model API layer для Codex CLI. Он отвечает за API Key, Base URL, model routing, баланс и записи расхода.
BetterToken не заменяет локальный sandbox Codex CLI, approvals, AGENTS.md или политику выполнения команд.
Для общего доступа к Codex API и вариантов использования на сайте BetterToken смотрите страницу Codex API. Эта FAQ посвящена самому Codex CLI и его локальному workflow.
Связанные материалы
- Настройка Codex с BetterToken
- Codex CLI, Codex App и Codex Web: в чем разница?
- Как настроить Codex CLI config.toml
- OpenAI-compatible API и Anthropic-compatible API