Codex CLI через AI Gateway — настройка провайдера

Codex CLI — терминальный агент OpenAI для разработки: понимает контекст проекта, редактирует файлы, запускает команды и тесты, работает с git. По умолчанию он ходит в API OpenAI напрямую — из России это требует VPN и валютной карты. Через AI Gateway достаточно описать кастомный провайдера в ~/.codex/config.toml и положить ключ в переменную окружения — дальше Codex работает с любой моделью из каталога.

Установка

npm install -g @openai/codex

Подключение к AI Gateway

1. 1
   Создайте API-ключ

   В кабинете AI Gateway создайте ключ — формат sk-aigate-…. Отдельный ключ на проект упрощает контроль расхода.

2. 2
   Положите ключ в переменную окружения

   Добавьте в ~/.bashrc / ~/.zshrc, чтобы Codex не хранил ключ в конфиге открытым текстом:

   bash Копировать

   export AIGATE_API_KEY="sk-aigate-ваш_ключ"

3. 3
   Опишите провайдера в config.toml

   Откройте ~/.codex/config.toml и добавьте блок провайдера AI Gateway. Ключ env_key указывает, из какой переменной окружения брать ключ:

   toml Копировать

   [model_providers.aigate]
   name = "AI Gateway"
   base_url = "https://ai-gatewey.ru/v1"
   env_key = "AIGATE_API_KEY"

4. 4
   Выберите провайдера и модель

   Там же, в корне config.toml, укажите провайдера по умолчанию и модель — код из каталога AI Gateway:

   toml Копировать

   model_provider = "aigate"
   model = "openai/gpt-5.3-codex"

5. 5
   Запустите и проверьте

   Выполните codex в каталоге проекта и отправьте первый запрос. Если агент отвечает — расход уже виден в кабинете AI Gateway в реальном времени.

Модели для Codex CLI

Codex CLI заточен под кодинг-модели OpenAI: gpt-5.3-codex — баланс цены и качества для повседневной работы, gpt-5.1-codex-max — сложные задачи и большие рефакторинги. Через AI Gateway доступны и другие провайдеры, например claude-sonnet-5:

Частые вопросы