Настройка API-ключа для Codex: полное руководство для разработчиков (2026)

Короткий ответ

Чтобы работать с Codex по API-ключу в 2026 году, установите CLI (npm install -g @openai/codex), получите ключ на platform.openai.com и задайте две переменные окружения — OPENAI_API_KEY и OPENAI_BASE_URL (обычно https://api.openai.com/v1). Для собственных провайдеров или шлюзов опишите блок [model_providers.<id>] в ~/.codex/config.toml и переключайтесь через --config model_provider=<id>. Если вам нужен один ключ сразу для Codex, Claude Code и Gemini CLI без мороки с международными платежами, шлюз вроде TeamoRouter заменяет всю эту настройку одним OpenAI-совместимым эндпоинтом.

Почему для разработчиков API-ключ лучше входа через ChatGPT

Codex CLI поддерживает два способа аутентификации: вход через ChatGPT по OAuth и API-ключи. Для большинства рабочих процессов разработчика API-ключ удобнее:

• Программируемость — CI/CD-пайплайны, скрипты и фоновые агенты не могут вызывать API через вход в браузере.
• Оплата по использованию — вы точно видите, сколько стоит каждый запрос, и не сталкиваетесь с неожиданным окончанием подписки.
• Общий ключ для нескольких инструментов — один ключ работает в Codex CLI, плагинах для IDE и собственных приложениях.
• Командная работа — общий ключ (или единый ключ шлюза на всю команду) централизует биллинг и учёт использования.

Сложности при получении ключа OpenAI напрямую — международные платежи (нужна зарубежная карта) и сетевые ограничения в некоторых регионах. Шлюз снимает обе.

Вход через ChatGPT или API-ключ: что выбрать?

OAuth годится для эпизодических интерактивных экспериментов; как только вы начинаете писать скрипты, автоматизировать, делиться доступом или деплоить — берите API-ключ.

Шаг 1. Установите Codex CLI

Установите глобально через npm (рекомендуется Node.js 22+):

npm install -g @openai/codex

Или воспользуйтесь официальной однострочной командой:

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

Проверьте установку:

codex --version

Шаг 2. Получите API-ключ

Создайте ключ на platform.openai.com/api-keys. Скопируйте его сразу — после создания OpenAI больше его не покажет. Ключи выглядят как sk-....

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

Шаг 3. Настройте переменные окружения

Самый простой вариант — две переменные окружения. Codex читает их при запуске:

export OPENAI_API_KEY="sk-your-key"
export OPENAI_BASE_URL="https://api.openai.com/v1"

• OPENAI_BASE_URL должен заканчиваться на /v1, без завершающего слэша.
• Добавьте эти строки export в ~/.zshrc (macOS/Linux) или задайте переменные в системных переменных окружения Windows, чтобы они сохранялись между сессиями.
• Codex также автоматически подхватывает файл .env в корне проекта — удобно для ключей, привязанных к проекту:

# .env в корне проекта
OPENAI_API_KEY=sk-your-key

Windows PowerShell

setx OPENAI_API_KEY "sk-your-key"
setx OPENAI_BASE_URL "https://api.openai.com/v1"

После setx откройте терминал заново, затем проверьте результат командой env | grep OPENAI.

Шаг 4. Запустите Codex

Запустите интерактивную сессию или выполните разовую задачу:

codex
codex "Add unit tests for the auth module"

Если переменная OPENAI_API_KEY задана, Codex использует для аутентификации API-ключ и игнорирует активную сессию ChatGPT.

Для скриптов и CI используйте разовый режим — он выводит результат в stdout и элементарно автоматизируется:

codex "Summarize the changes in the last 10 commits"

Интерактивный режим (codex без аргументов) лучше подходит для исследовательской работы, когда хочется просматривать каждый шаг по ходу дела. Большинство команд комбинируют оба: интерактивный режим — для проектирования и ревью, разовый — для рутины и пайплайнов.

Продвинутая настройка: провайдеры моделей в config.toml

Если у вас несколько провайдеров, собственные эндпоинты или отдельные настройки для каждого провайдера, опишите блоки [model_providers.<id>] в ~/.codex/config.toml (macOS/Linux) или %USERPROFILE%\.codex\config.toml (Windows):

model = "gpt-5.5"
model_provider = "gateway"

[model_providers.gateway]
name = "TeamoRouter"
base_url = "https://gateway.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false

Ключевые поля:

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

codex --config model_provider=gateway --model gpt-5.5 "your task"
codex --config model_provider=openai-direct --model gpt-5.5 "..."

Зарезервированные ID провайдеров: openai, ollama и lmstudio уже заняты — для собственных провайдеров используйте другие имена.

Частые ошибки с API-ключом и их исправление

Короткий путь через шлюз: один ключ для всего

Если какой-то из этих шагов заставил вас задуматься — требование зарубежной карты, региональные блокировки или поддержка пяти конфигураций провайдеров, — прагматичный короткий путь в 2026 году — единый шлюз.

TeamoRouter даёт вам:

• Один API-ключ для Codex, Claude Code и Gemini CLI — один и тот же ключ работает в конфигурации каждого инструмента.
• Локальные способы оплаты — Alipay и WeChat Pay, зарубежная карта не нужна, низкая минимальная сумма пополнения.
• Стабильный доступ — эндпоинт напрямую доступен из сетей с ограничениями, так что сбои прокси и DNS уходят в прошлое.
• Контроль расходов — кэширование промптов (доля попаданий >99%) и скидки по плавающей ставке относительно официальных цен.

Вся настройка — две переменные (или один блок в config.toml), и тот же ключ подходит к любому OpenAI-совместимому инструменту, которым вы пользуетесь:

export OPENAI_API_KEY="your-teamorouter-key"
export OPENAI_BASE_URL="https://gateway.teamorouter.com/v1"

Лучшие практики безопасности для API-ключей

API-ключ — это пароль, который тратит деньги. Обращайтесь с ним соответственно:

• Никогда не коммитьте ключи в git. Добавьте .env в .gitignore и перед пушем проверяйте историю инструментами вроде git secrets или gitleaks.
• Разграничивайте ключи. Создайте отдельные ключи для локальной разработки, CI и продакшена, чтобы можно было отозвать один, не сломав всё остальное.
• Периодически меняйте ключи. Если участник уходит из команды или ключ утёк, немедленно отзовите его и выпустите новый.
• Используйте переменные окружения, а не историю оболочки. Не прописывайте export OPENAI_API_KEY=... прямо в файлах; подгружайте ключ из незакоммиченного .env или менеджера секретов.
• Следите за использованием. Настройте на платформе оповещения о расходах, чтобы необычные траты были заметны раньше, чем превратятся в неожиданный счёт.
• Для команд выбирайте ключи шлюза. Общий ключ шлюза с учётом использования по каждому участнику держит расходы в одном месте, а не распыляет их по личным аккаунтам OpenAI.

API-ключи Codex в команде

Команды получают от API-ключей максимум, когда биллинг и доступ централизованы:

1. Создайте на шлюзе один общий ключ (или ключи для каждого участника).
2. Храните его в командном менеджере секретов и передавайте через переменные окружения CI.
3. Отслеживайте использование по участникам или проектам в консоли шлюза.
4. Меняйте ключ раз в квартал и при каждом уходе сотрудника.

Это ощутимо проще, чем когда каждый разработчик заводит собственный аккаунт OpenAI со своей картой, — и именно поэтому в 2026 году конфигурации на базе шлюза стали для команд стандартом.

FAQ

Можно ли использовать API-кредиты, которые идут вместе с ChatGPT Plus?

Нет. Подписка ChatGPT Plus ($20 в месяц) и биллинг за использование API полностью независимы. Кредиты Plus работают только на chat.openai.com, и потратить их через API-ключ нельзя, а использование API не засчитывается в подписку Plus.

Можно ли использовать один API-ключ в Codex CLI и других инструментах?

Да. Один и тот же ключ работает в Codex CLI, плагинах для IDE и собственных приложениях. Единый ключ TeamoRouter одновременно поддерживает Codex, Claude Code и Gemini CLI — достаточно настроить base URL в каждом инструменте.

Есть ли риск утечки API-ключа?

Да, если вы захардкодите ключ в исходном коде и закоммитите его на GitHub. Используйте переменные окружения или файлы .env и добавьте .env в .gitignore. Относитесь к ключам как к паролям.

Что приоритетнее — OPENAI_API_KEY или вход через ChatGPT?

Если переменная OPENAI_API_KEY задана, Codex использует API-ключ и игнорирует активную сессию ChatGPT.

Нужна ли банковская карта, чтобы получить API-ключ в TeamoRouter?

Нет. Зарегистрируйтесь, чтобы получить API-ключ, внесите предоплату перед использованием и платите через Alipay или другими локальными способами с низкой минимальной суммой пополнения.

С чего начать

1. Зарегистрируйтесь на TeamoRouter и получите API-ключ
2. Следуя руководству по установке Codex, настройте переменные окружения и base URL
3. Запустите codex в терминале и начинайте писать код

Настройте Codex бесплатно →

Стабильный доступ к Codex, Claude Code и Gemini CLI через TeamoRouter.