Codex CLI — терминальный агент OpenAI, написанный на Rust. Он работает в песочнице, умеет читать и править файлы в проекте, запускать команды и подключать внешние инструменты через MCP. Исходный код открыт под лицензией Apache-2.0, поэтому сборка и поведение прозрачны.
Ключевой момент для работы через Vtop AI: Codex разговаривает на протоколах OpenAI — Responses или Chat Completions. Наш публичный шлюз реализует Anthropic Messages API, поэтому напрямую Codex к нему не подключится: между ними нужен переходник, который переводит форматы запросов.
Инструмент
- Тип: Терминал
- Разработчик: OpenAI
- Лицензия: Apache-2.0
- Протокол: OpenAI Responses / Chat Completions
- Свой адрес API: Да, но только OpenAI-совместимый адрес
Подключение к Vtop AI
- Напрямую: нет
- Способ: model_providers.<id> в config.toml: base_url + env_key + wire_api
- Раздел: ключи API
В конфигурации Codex провайдеры описываются секциями model_providers: у каждой секции есть base_url (адрес), env_key (имя переменной с ключом) и wire_api — выбор протокола, responses или chat. Если подменять нужно только встроенного провайдера OpenAI, есть короткая настройка openai_base_url.
Этот механизм рассчитан на совместимые по протоколу сервисы: прокси, маршрутизаторы и региональные адреса OpenAI. Anthropic Messages в списке протоколов Codex нет — форматы запросов и ответов у OpenAI и Anthropic различаются, включая описание инструментов и потоковую передачу.
Практический вывод: если вы хотите работать именно с Codex, выбирайте между прямым подключением к OpenAI и переходником. Наш шлюз при этом остаётся удобным для агентов, которые говорят на Anthropic-протоколе, — их в этом разделе большинство.
Как подключить
Настройка хранится в файле config.toml в каталоге Codex. Провайдер описывается секцией вида [model_providers.<имя>] с полями base_url, env_key и wire_api, а выбор провайдера задаётся ключом model_provider.
Через шлюз Vtop AI Codex напрямую работать не будет: наш адрес принимает Anthropic Messages на /v1/messages, а Codex отправляет запросы в формате OpenAI. Для связки потребуется отдельный сервис-переводчик — мы его не предоставляем.
Если для задачи подходит любой агент, посмотрите в сторону Claude Code, Cline, Roo Code, Kilo Code или Zed: они говорят на Anthropic-протоколе и подключаются к ключу Vtop AI без прослоек.
| Переменная | Что означает |
|---|---|
OPENAI_API_KEY | имя переменной задаётся в поле env_key; сам ключ хранится в окружении |
openai_base_url / base_url | адрес провайдера, задаётся в config.toml |
wire_api | протокол обмена: responses или chat |
Сильные и слабые стороны
Что хорошо
- Открытый исходный код (Apache-2.0) и понятная конфигурация провайдеров.
- Написана на Rust: быстрый старт и низкое потребление памяти.
- Песочница для команд снижает риск случайной порчи проекта.
На что обратить внимание
- Не поддерживает протокол Anthropic Messages — к шлюзу Vtop AI напрямую не подключить.
- Для работы через сторонний шлюз нужен переходник, который придётся поддерживать.
- Конфигурация хранится в отдельном файле и не переносится между машинами автоматически.
Сравнение с другими агентами
Та же задача, но разными инструментами — так выглядит выбор между харнессами. Подробный разбор каждого — по ссылке в таблице.
| Агент | Тип | Лицензия | Подключение к Vtop AI |
|---|---|---|---|
| Codex CLI — этот агент | Терминал | Apache-2.0 | напрямую не подключается |
| Claude Code | Терминал | Проприетарный (репозиторий — только документация и трекер) | ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN |
| Gemini CLI | Терминал | Apache-2.0 | напрямую не подключается |
| Crush | Терминал | FSL-1.1-MIT (через два года — MIT) | crush provider add … --type anthropic --base-url |
| OpenCode | Терминал | MIT | provider.anthropic.options.baseURL в opencode.json |
Сравнение всех 14 агентов
Полная таблица подборки — на странице раздела: тип, лицензия, протокол и способ подключения к Vtop AI.
Смотрите также
Частые вопросы
Можно ли подключить Codex CLI к Vtop AI напрямую?
Нет. Codex общается на протоколах OpenAI (Responses или Chat Completions), а шлюз Vtop AI принимает запросы формата Anthropic Messages. Форматы различаются, поэтому нужен переходник.
Что такое wire_api?
Это поле в конфигурации Codex, которое выбирает протокол обмена с провайдером: responses или chat. Оба относятся к семейству OpenAI, протокола Anthropic среди значений нет.
Есть ли агенты на OpenAI-протоколе, которые работают с Vtop AI?
Наш шлюз рассчитан на Anthropic-протокол, поэтому надёжнее выбирать агента, который его поддерживает: Claude Code, Cline, Roo Code, Kilo Code, Zed, Crush, OpenCode, Goose.
Стоит ли ставить переходник ради Codex?
Это дополнительный сервис в цепочке: его нужно развернуть, обновлять и следить за совместимостью форматов. Если отдельного требования к Codex нет, проще взять агента с нативной поддержкой Anthropic-протокола.