Codex CLI — AI-агент от OpenAI для терминала: читает проект, правит файлы, запускает команды. Своих провайдеров Codex подключает через config.toml, поэтому с Hubris в нём работают не только модели OpenAI, но и Claude, DeepSeek, Gemini и остальные модели каталога.

Требования

macOS, Linux или Windows
Node.js 22+ для установки через npm
Аккаунт на hubris.pw и API-ключ из раздела Ключи

Установка

npm install -g @openai/codex
codex --version

Другие способы (Homebrew, готовые сборки) описаны в README Codex.

Подключение к Hubris

Codex читает настройки из ~/.codex/config.toml (на Windows %USERPROFILE%\.codex\config.toml). Добавьте в файл провайдера Hubris и сделайте его основным:

model = "openai/gpt-5.1-codex"
model_provider = "hubris"

[model_providers.hubris]
name = "Hubris"
base_url = "https://api.hubris.pw/v1"
env_key = "HUBRIS_API_KEY"
wire_api = "responses"

wire_api = "responses" означает, что Codex ходит в Hubris по Responses API, как в OpenAI. Hubris принимает такие запросы для всех текстовых моделей каталога, не только для моделей OpenAI.

Сам ключ в файл не пишется: env_key — имя переменной окружения, из которой Codex его прочитает.

export HUBRIS_API_KEY="sk-gw-..."

На Windows в PowerShell: $env:HUBRIS_API_KEY = "sk-gw-...".

Проверить подключение без интерфейса можно одним запросом:

codex exec "Ответь одним словом: ок"

В начале ответа Codex печатает provider: hubris и имя модели, в конце — ответ модели.

Если в config.toml уже есть ваши настройки (MCP-серверы, плагины), не удаляйте их: model, model_provider и секция [model_providers.hubris] дописываются рядом.

Выбор модели

Модель указывается её ID из каталога, с префиксом разработчика:

codex -m anthropic/claude-sonnet-5
codex exec -m deepseek/deepseek-v4.1-flash "Найди в проекте неиспользуемые функции"

Для моделей не от OpenAI Codex пишет предупреждение Model metadata for … not found. Defaulting to fallback metadata. Оно значит только, что Codex не знает размер контекста этой модели, работа продолжается.

Права агента на Windows

По умолчанию codex exec работает в режиме «только чтение»: агент видит проект, но файлы не меняет. Разрешить правки только внутри папки проекта можно флагом -s workspace-write. На Windows для этого режима нужна ещё одна строка в config.toml, иначе Codex молча остаётся в режиме «только чтение» и агент отвечает, что запись запрещена:

[windows]
sandbox = "unelevated"

Решение проблем

`401` или «Неверный API-ключ»

Переменная из env_key (в примере HUBRIS_API_KEY) должна быть задана в той же оболочке, из которой запущен Codex, и начинаться с sk-gw-.
После правки переменных окружения перезапустите терминал.

Запрос ушёл в OpenAI, а не в Hubris

В начале ответа codex exec должно быть provider: hubris. Если там openai, в config.toml не задан model_provider = "hubris" или правка сделана не в том файле. Путь к папке настроек меняет переменная CODEX_HOME.

Модель не найдена

ID модели должен совпадать с каталогом символ в символ, вместе с префиксом разработчика: anthropic/claude-sonnet-5, а не claude-sonnet-5.

Codex ждёт ввода и ничего не делает

codex exec, запущенный из скрипта, дочитывает стандартный ввод, прежде чем отправить запрос. Если ввод не нужен, перенаправьте его: codex exec "…" < /dev/null.

Проверено на Codex CLI 0.144.5 (Windows), 28 сентября 2026.

Что дальше

Каталог моделей — ID и цены всех моделей.
Управление API-ключами — отдельный ключ с лимитом под Codex.
Расходы — стоимость каждого запроса агента.
OpenCode и Claude Code — другие терминальные агенты.

Обновлено: 28 сентября 2026 г.

ID	Когда подходит
`openai/gpt-5.1-codex`	модель OpenAI, обученная именно под Codex
`anthropic/claude-sonnet-5`	сложные правки в большом проекте
`deepseek/deepseek-v4.1-flash`	повседневные задачи, в разы дешевле

Codex CLI