Codex CLI — терминальный агент OpenAI, написанный на Rust. Он работает в песочнице, умеет читать и править файлы в проекте, запускать команды и подключать внешние инструменты через MCP. Исходный код открыт под лицензией Apache-2.0, поэтому сборка и поведение прозрачны.
Ключевой момент для работы через Vtop AI: Codex разговаривает на протоколах OpenAI — Responses или Chat Completions. Наш публичный шлюз принимает OpenAI Chat Completions на пути /v1/chat/completions, поэтому Codex подключается к нему напрямую: в config.toml описывается свой провайдер с wire_api = "chat", и переходник не нужен.
Инструмент
- Тип: Терминал
- Разработчик: OpenAI
- Лицензия: Apache-2.0
- Протокол: OpenAI Responses / Chat Completions
- Свой адрес API: Да, но только OpenAI-совместимый адрес
Подключение к Vtop AI
- Напрямую: да, через OpenAI-совместимый вход
- Способ: model_providers.<id> в config.toml: base_url + env_key + wire_api = "chat"
- Раздел: ключи API
В конфигурации Codex провайдеры описываются секциями model_providers: у каждой секции есть base_url (адрес), env_key (имя переменной с ключом) и wire_api — выбор протокола, responses или chat. Если подменять нужно только встроенного провайдера OpenAI, есть короткая настройка openai_base_url.
Этот механизм рассчитан на совместимые по протоколу сервисы: прокси, маршрутизаторы и региональные адреса OpenAI. Шлюз Vtop AI — как раз такой сервис: он принимает запросы формата OpenAI Chat Completions, поэтому подставляется в base_url наравне с прокси.
Практический вывод: Codex CLI работает с Vtop AI напрямую — нужен только ключ из кабинета и секция провайдера в конфигурации. Агенты на Anthropic-протоколе (Claude Code, Cline, Zed и другие) подключаются к тому же ключу, просто через другой путь.
Как подключить
Настройка хранится в файле config.toml в каталоге Codex. Провайдер описывается секцией вида [model_providers.<имя>] с полями base_url, env_key и wire_api, а выбор провайдера задаётся ключом model_provider.
Через шлюз Vtop AI настройка такая: адрес провайдера — https://vtop-ai.site/v1, ключ — в переменной окружения, wire_api — "chat". Протокол Responses шлюз не принимает, поэтому выбирать нужно именно chat completions.
Если Codex по какой-то причине не подходит, у того же ключа работают Claude Code, Cline, Roo Code, Kilo Code и Zed — они говорят на Anthropic-протоколе.
| Переменная | Что означает |
|---|---|
OPENAI_API_KEY | имя переменной задаётся в поле env_key; сам ключ хранится в окружении |
openai_base_url / base_url | адрес провайдера, задаётся в config.toml |
wire_api | протокол обмена: responses или chat |
Сильные и слабые стороны
Что хорошо
- Открытый исходный код (Apache-2.0) и понятная конфигурация провайдеров.
- Написана на Rust: быстрый старт и низкое потребление памяти.
- Песочница для команд снижает риск случайной порчи проекта.
На что обратить внимание
- Не поддерживает протокол Anthropic Messages — подключение идёт через OpenAI-совместимый вход шлюза.
- Протокол Responses шлюз не принимает: в конфигурации выбирается wire_api = "chat".
- Конфигурация хранится в отдельном файле и не переносится между машинами автоматически.
Сравнение с другими агентами
Та же задача, но разными инструментами — так выглядит выбор между харнессами. Подробный разбор каждого — по ссылке в таблице.
| Агент | Тип | Лицензия | Подключение к Vtop AI |
|---|---|---|---|
| Codex CLI — этот агент | Терминал | Apache-2.0 | model_providers в config.toml: base_url + wire_api = "chat" |
| 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, и шлюз Vtop AI принимает OpenAI Chat Completions на пути /v1/chat/completions. В конфигурации описывается свой провайдер с этим адресом и wire_api = "chat" — переходник не нужен.
Что такое wire_api?
Это поле в конфигурации Codex, которое выбирает протокол обмена с провайдером: responses или chat. Оба относятся к семейству OpenAI, протокола Anthropic среди значений нет.
Есть ли агенты на OpenAI-протоколе, которые работают с Vtop AI?
Да, и Codex CLI — как раз такой агент: он подключается к шлюзу через OpenAI-совместимый вход. Так же напрямую работает Aider (поле --openai-api-base) и агенты на Anthropic-протоколе: Claude Code, Cline, Roo Code, Kilo Code, Zed, Crush, OpenCode, Goose.
Нужен ли переходник для Codex CLI?
Нет. Шлюз принимает тот протокол, на котором говорит Codex, поэтому переходник только добавил бы лишнее звено в цепочку.