Codex CLI с пользовательским провайдером: config.toml, модели GPT и Claude, расширение для IDE и исправления

Codex читает один файл, ~/.codex/config.toml, общий для CLI, codex exec и расширения для IDE. Пользовательский провайдер в этом файле направляет Codex на этот шлюз, где одна и та же конфигурация позволяет запускать модели GPT и Claude. Текущие версии Codex работают только с Responses API (wire_api = "responses"), поэтому старые руководства, в которых используется wire_api = "chat" больше не работают.

Установите Codex

# macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# or with a package manager
npm install -g @openai/codex
brew install --cask codex

codex --version

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Расширение Codex для VS Code, Cursor и Windsurf устанавливается из магазина расширений редактора и использует тот же ~/.codex/config.toml что и CLI, поэтому всё описанное ниже относится к обоим вариантам.

Используйте ключ из нужной группы

Ключ шлюза относится к одной группе, и эта группа определяет, какие модели можно вызывать с помощью ключа. Для моделей GPT создайте ключ в группе **Codex** в панели управления. Для моделей Claude подойдёт любой ключ Claude с оплатой по мере использования. Для ключа из безлимитной группы нужен активный тариф; без него каждый запрос завершается ошибкой No active subscription found for this group.

export AIPRIME_CODEX_KEY=key_from_the_codex_group    # GPT models
export AIPRIME_CLAUDE_KEY=key_from_a_claude_group    # Claude models

setx AIPRIME_CODEX_KEY "key_from_the_codex_group"
setx AIPRIME_CLAUDE_KEY "key_from_a_claude_group"
# open a new terminal afterwards

config.toml для моделей GPT

model_provider = "aiprime"
model = "gpt-6-astra"
model_reasoning_effort = "high"

[model_providers.aiprime]
name = "AI Prime Tech"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIME_CODEX_KEY"
wire_api = "responses"
supports_websockets = false

Запускайте Codex с моделями Claude

Шлюз принимает запросы Responses API для моделей Claude и преобразует их, поэтому Codex может работать и с Claude. Добавьте второго провайдера, использующего ваш ключ Claude, а затем профиль для переключения на него.

[model_providers.aiprime_claude]
name = "AI Prime Tech (Claude)"
base_url = "https://aiprimetech.io/v1"
env_key = "AIPRIME_CLAUDE_KEY"
wire_api = "responses"
supports_websockets = false

model_provider = "aiprime_claude"
model = "claude-sonnet-5"
model_reasoning_effort = "high"

codex --profile claude
codex exec --profile claude "review the last commit for bugs"

Начиная с Codex 0.134.0 профиль хранится в отдельном файле, ~/.codex/<name>.config.toml, с ключами на верхнем уровне; [profiles.<name>] таблицы внутри config.toml больше не читаются. Профили и провайдеры можно задавать только в пользовательской конфигурации: файл проекта .codex/config.toml игнорирует model_provider и model_providers.

Модели и интенсивность рассуждений

model_reasoning_effort принимает low, medium, high, xhigh или max, в зависимости от модели. Не задавайте none: эти модели отклоняют это значение с ошибкой 'none' is not supported. review_model задаёт другую модель для /review если это нужно. В панели управления отображаются все модели, доступные группе вашего ключа.

Расширение для IDE и codex exec

Расширение для IDE читает тот же config.toml, но env_key берётся из собственного окружения редактора. Редактор, запущенный из Dock или меню «Пуск», не видит переменные, экспортированные в .bashrc, и тогда Codex завершается с ошибкой Invalid API key хотя CLI работает. Задайте переменную на уровне системы (в Windows setx делает это) или запустите редактор из терминала, например code ..

codex exec выполняет одну задачу без интерактивного интерфейса, что подходит для скриптов и CI. Используются те же конфигурация и профили:

codex exec "write unit tests for utils.py"
codex exec --profile claude "summarise the changes on this branch"
codex login status        # which authentication method is active

Повторные попытки и тайм-ауты

У каждого провайдера свои настройки повторных запросов и потоковой передачи. По умолчанию выполняется 4 повторных попыток запроса, 5 повторных подключений к потоку, а тайм-аут бездействия каждого потока составляет 5 мин. Длительные этапы рассуждений могут какое-то время не выдавать данных, поэтому увеличение тайм-аута бездействия помогает при высоких уровнях интенсивности рассуждений.

[model_providers.aiprime]
# ...settings from above...
request_max_retries = 6
stream_max_retries = 8
stream_idle_timeout_ms = 600000

Устранение неполадок: ошибки, с которыми сталкиваются пользователи Codex

Ниже приведены ошибки, которые действительно возникают у клиентов Codex при работе с этим шлюзом, начиная с самых распространённых.

Сравниваете Codex с Claude Code, прежде чем выбрать один из них? См. Claude Code и Codex: сравнение.

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.