Codex CLI
Подключение Codex CLI от OpenAI к Hubris через config.toml. GPT, Claude, DeepSeek и другие модели каталога в агенте, оплата в рублях.
Codex CLI — AI-агент от OpenAI для терминала: читает проект, правит файлы, запускает команды. Своих провайдеров Codex подключает через config.toml, поэтому с Hubris в нём работают не только модели OpenAI, но и Claude, DeepSeek, Gemini и остальные модели каталога.
Что понадобится
- Codex CLI.
- Ключ Hubris. Как его получить: Пространства и ключи.
Подключение к Hubris
-
Откройте файл
config.tomlиз папки.codex. На Windows это%USERPROFILE%\.codex\config.toml, на macOS и Linux~/.codex/config.toml. Если файла нет, создайте его. -
Вставьте в файл текст ниже и сохраните файл. Сам ключ сюда не пишется:
env_keyговорит Codex, из какой переменной его взять.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"
-
В терминале задайте ключ. Вместо
sk-gw-...подставьте свой.В PowerShell на Windows:
$env:HUBRIS_API_KEY = "sk-gw-..."На macOS и Linux:
export HUBRIS_API_KEY="sk-gw-..." -
В том же терминале задайте вопрос. На снимке выбрана недорогая модель, без
-mCodex возьмёт модель из файла.codex exec -m deepseek/deepseek-v4.1-flash "Сколько будет 2+2? Ответь одним словом."
Если в 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 не знает размер контекста этой модели, работа продолжается.
Рекомендуемые модели
| ID | Когда подходит |
|---|---|
openai/gpt-5.1-codex | модель OpenAI, обученная именно под Codex |
anthropic/claude-sonnet-5 | сложные правки в большом проекте |
deepseek/deepseek-v4.1-flash | повседневные задачи, в разы дешевле |
Одна задача агента складывается из нескольких запросов к модели. Первый запрос в сессии самый дорогой: 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.
Что дальше
- ChatGPT Desktop — те же настройки в приложении для компьютера.
- Каталог моделей — ID и цены всех моделей.
- Управление API-ключами — отдельный ключ с лимитом под Codex.
- Расходы — стоимость каждого запроса агента.
- OpenCode и Claude Code — другие терминальные агенты.
Обновлено:
