Как настроить Codex CLI на Tokenator API

Что получится в итоге

После настройки Codex CLI перестаёт обращаться к своему стандартному провайдеру и отправляет все запросы в Tokenator. Оплата идёт токенами вашего ключа, а список доступных моделей задаётся ключом, а не инструментом.

Требования и поддерживаемые ОС

• Windows 10/11, macOS 12+ или современный Linux с 64-битной архитектурой.
• Доступ в интернет к домену Tokenator по HTTPS.
• API-ключ Tokenator вида sk-your-tokenator-key.

Для установки через npm нужен Node.js LTS. У Codex CLI есть и отдельные бинарные сборки, устанавливать Node в этом случае не обязательно.

Установка Codex CLI

npm install -g @openai/codex

brew install --cask codex

После установки один раз запустите codex, чтобы создался каталог ~/.codex.

Настройка Tokenator

1. Зарегистрируйтесь в личном кабинете и купите пакет токенов.
2. Ключ появится в кабинете сразу после подтверждения оплаты — копировать его нужно целиком, вместе с префиксом.
3. В примерах ниже вместо настоящего ключа стоит плейсхолдер sk-your-tokenator-key. Не публикуйте настоящий ключ в репозиториях и скриншотах.

Конфигурация для Windows

model = "gpt-5.5"
model_provider = "tokenator"

[model_providers.tokenator]
name = "Tokenator"
base_url = "https://api.tokenator.top/v1"
env_key = "TOKENATOR_API_KEY"
wire_api = "responses"

$env:TOKENATOR_API_KEY = "sk-your-tokenator-key"
codex

setx TOKENATOR_API_KEY "sk-your-tokenator-key"

Идентификатор провайдера не должен совпадать с зарезервированными (openai, ollama, lmstudio) — поэтому в примере он назван tokenator. Ключ в файл не записывается: env_key указывает, из какой переменной окружения его взять.

Конфигурация для macOS и Linux

model = "gpt-5.5"
model_provider = "tokenator"

[model_providers.tokenator]
name = "Tokenator"
base_url = "https://api.tokenator.top/v1"
env_key = "TOKENATOR_API_KEY"
wire_api = "responses"

export TOKENATOR_API_KEY="sk-your-tokenator-key"
codex

Идентификатор провайдера не должен совпадать с зарезервированными (openai, ollama, lmstudio) — поэтому в примере он назван tokenator. Ключ в файл не записывается: env_key указывает, из какой переменной окружения его взять.

Первый запрос

Перед запуском инструмента полезно убедиться, что ключ и модель рабочие. Один запрос curl отвечает на оба вопроса сразу.

curl https://api.tokenator.top/v1/chat/completions \
  -H "Authorization: Bearer sk-your-tokenator-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "ping"}]
  }'

cd /path/to/project
codex

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

Переключение моделей

Модель меняется в config.toml полем model — либо на запуск, флагом codex -m <model-id>.

Примеры ID моделей, доступных сейчас:

• claude-haiku-4-5
• claude-opus-4-6
• claude-opus-4-7
• claude-sonnet-4-6
• gpt-5.5
• deepseek-v4-flash

Актуальные ID и характеристики — в каталоге AI-моделей; там же видно, какие модели сейчас доступны. Выбрать между близкими вариантами помогает сравнение моделей.

Настройка reasoning

Codex CLI передаёт уровень усилий рассуждения в самом запросе — в конфиге это model_reasoning_effort. Значение уходит в апстрим как есть; если модель его не поддерживает, оно игнорируется без ошибки.

Reasoning оплачивается как output-токены, поэтому высокий уровень заметно увеличивает расход.

Частые ошибки и способы исправления

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

Читайте дальше