Skip to main content
Codex CLI от OpenAI — это ИИ-ассистент для программирования, работающий в терминале. Установив две переменные окружения, вы можете направлять запросы Codex CLI через Flatkey для использования совместимых моделей GPT, Claude, Gemini и других текстовых моделей, когда они доступны через Flatkey.

​
Предварительные требования

  • Установленный Codex CLI: npm install -g @openai/codex
  • Аккаунт Flatkey с API-ключом — получить здесь

​
Настройка

Установите следующие переменные окружения перед запуском Codex CLI:
Или добавьте их в профиль вашей оболочки (~/.bashrc, ~/.zshrc), чтобы сделать настройку постоянной:
~/.zshrc

​
Настройка с помощью CC Switch

CC Switch — это сторонний десктопный менеджер конфигураций для ИИ-ассистентов программирования. Это не продукт Flatkey, и Flatkey не является встроенным пресетом. Приведённые ниже шаги соответствуют текущему интерфейсу CC Switch. Ручной способ через OPENAI_BASE_URL и OPENAI_API_KEY, описанный выше, и CC Switch — это альтернативные способы настройки Codex. Для чистого теста CC Switch снимите только устаревшие значения OPENAI_BASE_URL или OPENAI_API_KEY, указывающие на другого провайдера или ключ. Значения, унаследованные вашей оболочкой, могут переопределить или конфликтовать с провайдером, который вы активируете в CC Switch.

​
1. Установите CC Switch

Загрузите CC Switch с ccswitch.io или из его официального репозитория GitHub. Установите его для вашей операционной системы, затем откройте приложение.

​
2. Откройте панель провайдера Codex

Выберите Codex в CC Switch. Это откроет панель провайдера, которая управляет конфигурацией, используемой новыми сессиями Codex. Откройте панель провайдера Codex и выберите кнопку добавления провайдера в CC Switch

​
3. Добавьте Flatkey как пользовательского провайдера

Выберите Custom Provider и добавьте провайдера со следующими значениями: Введите актуальные поля провайдера Flatkey в CC Switch
Относитесь к своему API-ключу как к конфиденциальной информации. Не включайте его в скриншоты, экспортированные или общедоступные конфигурации провайдера. Если он был скомпрометирован, отзовите или замените ключ в Flatkey, а затем обновите его в CC Switch.
Flatkey нативно поддерживает Responses API. Local Routing в CC Switch для этой настройки не требуется, поэтому оставьте его отключённым.

​
4. Настройте модель

Найдите Flatkey в панели провайдера Codex в CC Switch, затем нажмите Edit. Чтобы изменить модель, используемую новыми сессиями Codex, установите Default Model на точный ID модели из каталога моделей Flatkey. Не используйте отображаемое имя и не угадывайте ID. Например, вы можете ввести любую из следующих текстовых моделей в поле Default Model в CC Switch:
Чтобы добавить или изменить другие модели в CC Switch и отобразить их в меню /model Codex CLI, используйте Model Mapping:
  1. Нажмите Fetch Models, чтобы загрузить доступные модели из Flatkey. Если нужной модели нет, нажмите Add Model.
  2. Отредактируйте Menu Display Name сопоставления. Это метка, отображаемая в меню /model.
  3. Установите Actual Request Model на точный ID из каталога моделей, например claude-sonnet-4-6 или gemini-2.5-flash. Codex отправляет этот ID в запросах, а не метку меню.
Model Mapping управляет записью в меню /model и соответствующим ID запроса. Это не заставляет несовместимую модель работать с Codex. После изменения сопоставления выполните шаги ниже, чтобы сохранить провайдера и перезапустить Codex, прежде чем обновлённый список моделей вступит в силу. После сохранения и активации Flatkey новые сессии Codex будут использовать Default Model, заданную в CC Switch. Чтобы переопределить её только для одной команды, передайте тот же точный ID:
Выбирайте текстовую модель, которая доступна через Flatkey и совместима с форматом запросов Codex. Не используйте с Codex CLI модели для генерации изображений, аудио или эмбеддингов. После отправки запроса используйте журналы использования Flatkey как достоверный источник информации о фактически использованной модели. Получите или добавьте другие модели и настройте их сопоставления моделей для Codex CLI

​
5. Сохраните и активируйте Flatkey

Сохраните провайдера, затем активируйте Flatkey в панели провайдера Codex. Убедитесь, что Flatkey является активным провайдером, прежде чем запускать Codex. Убедитесь, что провайдер Flatkey Codex используется

​
6. Перезапустите и проверьте

Завершите существующую сессию Codex и её процесс. Закройте именно то окно или вкладку терминала, в котором запускался Codex, а не другие несвязанные терминалы. Откройте новый терминал, который не наследует устаревшие значения OPENAI_BASE_URL или OPENAI_API_KEY. Перейдите в небольшую или пустую директорию и запустите новую сессию Codex. Введите /model, убедитесь, что добавленная или изменённая модель отображается, и выберите нужную модель. Затем отправьте минимальный запрос. Проверьте новую сессию Codex CLI с минимальным ответом OK Затем откройте журналы использования Flatkey и подтвердите фактический запрос. Проверьте его модель, количество входных и выходных токенов, задержку и стоимость.
Запрос агента может включать системные подсказки, определения инструментов, историю переписки, файлы и результаты команд. Используйте небольшой контекст для проверок подключения, чтобы количество токенов и стоимость было легко отследить.

​
Переключение обратно на другого провайдера

Откройте панель провайдера Codex в CC Switch, выберите нужного провайдера и активируйте его. Завершите существующие сессии и процессы Codex, затем откройте новый терминал, который не наследует устаревшие значения OPENAI_BASE_URL или OPENAI_API_KEY. Запустите новую сессию.

​
Устранение неполадок CC Switch

​
Запуск Codex CLI

После установки переменных окружения используйте Codex как обычно:
или в интерактивном режиме:
Все запросы направляются через Flatkey и оплачиваются с вашего предоплаченного баланса по сниженным тарифам Flatkey.

​
Проверка ручной настройки переменных окружения

Этот раздел относится только к ручному способу с OPENAI_BASE_URL и OPENAI_API_KEY. Если вы настроили Codex через CC Switch, следуйте инструкциям в разделе Перезапустите и проверьте выше. Для ручного способа выполните команду Codex и проверьте журналы использования. Вы должны увидеть залогированный запрос с указанием модели и количества токенов. Если запрос не появляется, убедитесь, что обе переменные корректно установлены в текущей сессии оболочки.
Используйте уровень пополнения $200 для получения наилучшей эффективной ставки при интенсивном использовании Codex — суммарный бонус снижает стоимость до 50% от официальных цен на GPT.

​
Устранение неполадок ручной настройки переменных окружения

Приведённая ниже таблица относится только к ручному способу с OPENAI_BASE_URL и OPENAI_API_KEY. Если вы настроили Codex через CC Switch, используйте раздел Устранение неполадок CC Switch выше.