Что такое Codex
Codex — это агентский инструмент для разработки от OpenAI, работающий на модели GPT-5.3-Codex. Codex существует в трёх формах:
- Codex CLI — терминальный инструмент (open-source), работает локально. Код не покидает вашу машину
- Codex Web — облачный агент в интерфейсе ChatGPT, выполняет задачи в изолированном sandbox
- Codex IDE Extension — расширение для VS Code и JetBrains
В этом гайде мы сосредоточимся на Codex CLI — терминальном инструменте, аналогичном Claude Code.
Подписка и цены
Codex доступен через подписку ChatGPT или API.
Подписки ChatGPT
| План | Цена | Доступ к Codex | Лимиты |
|---|---|---|---|
| ChatGPT Plus | $20/мес | Codex Web + CLI | 160 сообщений/3 часа (GPT-5.2) |
| ChatGPT Pro | $200/мес | Приоритет, unlimited (fair use) | Полный доступ |
| ChatGPT Business | $25/user/мес | Командное пространство, админка | Командные фичи |
| ChatGPT Enterprise | Индивидуально | Расширенная безопасность, SSO | Под запрос |
API-токены
Для разработчиков доступна оплата по токенам через API:
| Модель | Вход (за 1M токенов) | Выход (за 1M токенов) |
|---|---|---|
| gpt-5.1-codex-mini | $0.25 | $2.00 |
API-ключ создаётся на platform.openai.com.
Установка
npm i -g @openai/codex
После установки авторизуйтесь:
codex --login
Откроется браузер для входа через аккаунт ChatGPT. Альтернативно, можно задать API-ключ через переменную окружения:
export OPENAI_API_KEY="sk-..."
Конфигурация
Codex использует TOML-конфиги на двух уровнях:
- Пользовательский:
~/.codex/config.toml— глобальные настройки - Проектный:
.codex/config.toml— настройки для конкретного проекта (переопределяют глобальные)
Основные параметры
Выбор модели
model = "gpt-5.3-codex"
Доступные модели: gpt-5.2, gpt-5-codex, gpt-5.1-codex-mini и другие.
Политика подтверждений
approval_policy = "on-failure"
| Значение | Описание |
|---|---|
untrusted | Запрос подтверждения на каждое действие |
on-failure | Автоматическое выполнение, подтверждение при ошибке |
on-request | Автоматическое выполнение, подтверждение по запросу агента |
never | Полная автономия (без подтверждений) |
Режим песочницы
sandbox_mode = "workspace-write"
| Значение | Описание |
|---|---|
read-only | Только чтение файлов |
workspace-write | Запись только в рабочую директорию |
danger-full-access | Полный доступ к файловой системе |
Уровень размышлений
model_reasoning_effort = "high"
Варианты: minimal, low, medium, high, xhigh. Влияет на глубину анализа и потребление токенов.
Личность модели
Поддерживается не во всех моделях.
model_personality = "pragmatic"
Варианты: none, friendly, pragmatic.
Веб-поиск
web_search = "cached"
Варианты: disabled, cached, live.
MCP-серверы
Codex поддерживает MCP (Model Context Protocol) серверы для расширения возможностей:
[mcp_servers.my-server]
command = "npx"
args = ["-y", "@my/mcp-server"]
env = { API_KEY = "xxx" }
Переменные окружения
[shell_environment_policy]
SOME_VAR = "inject"
SECRET_VAR = "block"
AGENTS.md
Файл AGENTS.md в корне проекта — аналог CLAUDE.md для Claude Code. Содержит инструкции для агента: стиль кода, правила, зависимости, структуру проекта.
Feature flags
[feature_flags]
shell_snapshot = true
unified_exec = true
request_rule = true
Ключевые возможности
Интерактивный режим
Запустите codex в терминале и общайтесь с агентом на естественном языке. Codex читает ваш проект, предлагает изменения, выполняет команды.
Работа с изображениями
Codex принимает изображения на вход — скриншоты UI, диаграммы, макеты:
codex "реализуй этот макет" --image mockup.png
Ревью кода
codex "проверь последний коммит на ошибки и уязвимости"
Облачные задачи (Codex Web)
Через интерфейс ChatGPT можно запускать долгие задачи в облачном sandbox: рефакторинг, миграции, генерация тестов. Результат — PR в GitHub.
Скриптинг и SDK
Codex можно использовать в скриптах через SDK:
codex -q "добавь типы ко всем функциям в src/" --approval-mode full-auto
Slash-команды
В интерактивном режиме доступны команды:
/help— справка/model— сменить модель/approval— сменить политику подтверждений/mcp— управление MCP-серверами/history— история диалога
Настройка для Omni Router
Если у вас есть подписка ChatGPT Plus или Pro, вы можете использовать её через Omni Router для доступа к /v1/responses endpoint.
Шаги подключения
- Откройте Telegram-бота Omni Router
- Выберите команду добавления Codex-провайдера
- Пройдите OAuth-авторизацию через аккаунт ChatGPT
- Получите
prx_токен
Настройка Codex CLI
Создайте или отредактируйте ~/.codex/config.toml:
api_base_url = "https://your-omni-router-url/v1"
И задайте токен:
export OPENAI_API_KEY="prx_ваш_токен"
Теперь Codex CLI будет работать через Omni Router, используя вашу подписку ChatGPT.
Omni Router маршрутизирует запросы Codex на
/v1/responsesendpoint, отдельно от Claude Code (/v1/messages). Один прокси — два инструмента.
Claude Code vs Codex: сравнение
| Claude Code | Codex CLI | |
|---|---|---|
| Разработчик | Anthropic | OpenAI |
| Модель | Claude Sonnet/Opus | GPT-5.3-Codex, GPT-5.2 |
| Подписка | Claude Pro $20, Max $100–200 | ChatGPT Plus $20, Pro $200 |
| Open-source | Нет | Да (Apache 2.0) |
| Конфиг | CLAUDE.md, settings.json | AGENTS.md, config.toml |
| Подтверждения | 3 режима | 4 режима |
| MCP | Поддержка | Поддержка |
| IDE | VS Code, JetBrains | VS Code, JetBrains |
| Облачный режим | Нет | Да (Codex Web) |
Оба инструмента можно использовать через Omni Router одновременно — с разными prx_ токенами.
Итог
Codex CLI — серьёзный инструмент для AI-кодинга, особенно если у вас уже есть подписка ChatGPT. Open-source код, гибкая конфигурация, поддержка MCP — всё для продуктивной работы.
Через Omni Router вы можете использовать и Claude Code, и Codex одновременно, переключаясь между ними в зависимости от задачи.