Блог

Подключаем DeepSeek V4 Pro к Codex: настройка через config.toml

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

Codex работает по протоколу OpenAI, но переменную OPENAI_BASE_URL не читает: адрес указывается в ~/.codex/config.toml:

toml
# ~/.codex/config.toml (Codex не читает OPENAI_BASE_URL — адрес указывается здесь)
model_provider = "teamorouter"
model = "deepseek-v4-pro"

[model_providers.teamorouter]
name = "TeamoRouter"
base_url = "https://api.teamorouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
bash
export OPENAI_API_KEY="sk-teamo-your-key"

Модель — deepseek-v4-pro (платная) или deepseek-v4-pro-free (бесплатная, 200 запросов в день). Ниже — настройка по умолчанию и через профили.

config.toml: самый простой путь

Собственный эндпоинт Codex берёт только из model_providers в config.toml (см. выше), а ключ — из переменной, указанной в env_key. Добавьте export OPENAI_API_KEY=... в профиль оболочки (~/.zshrc / ~/.bashrc), и каждый запрос Codex пойдёт в TeamoRouter. Затем укажите модель:

bash
codex --model deepseek-v4-pro-free "Introduce yourself in one sentence"

Обратите внимание: base_url включает /v1 — Codex обращается к Responses API OpenAI, которому это нужно.

Профили: маршрутизация по задачам

Если вы не хотите переводить на DeepSeek весь Codex, используйте профиль — он даёт точный контроль. В ~/.codex/config.toml:

toml
# блок `[model_providers.teamorouter]` — из примера выше
[profiles.teamorouter-pro-free]
model_provider = "teamorouter"
model = "deepseek-v4-pro-free"

Затем:

bash
codex --profile teamorouter-pro-free "Refactor src/services/reporting.py to remove duplicate branches"

Так профиль GPT-5.6 по умолчанию остаётся рядом с профилем DeepSeek, и вы маршрутизируете по задачам: тяжёлая работа — на штатном GPT в Codex, ежедневная частая работа — на дешёвом DeepSeek V4.

Бесплатный V4 Pro внутри Codex

deepseek-v4-pro-free даёт 200 бесплатных запросов в день; вот на что их хватает в Codex:

  • Повседневные правки: изменение в одном файле стоит 3–5 запросов, так что 200 хватит на дюжину с лишним;
  • Длинные агентные циклы: многошаговый рефакторинг стоит 10–20 запросов, так что 200 хватит на 3–5 трудных задач;
  • Квота исчерпана: смените ID модели на deepseek-v4-pro (единый тариф $1.74/$3.48, без лимита на аккаунт).

Для лёгкой работы (объяснения, сообщения коммитов) используйте deepseek-v4-flash-free (тоже 200 в день), а бесплатную квоту Pro приберегите для трудных задач.

Частые ошибки

Codex возвращает 404 или не может подключиться?

Либо в base_url не хватает /v1, либо задан только OPENAI_BASE_URL без config.toml (Codex эту переменную не читает). Эндпоинт должен быть https://api.teamorouter.com/v1 и прописан в ~/.codex/config.toml.

Ошибка авторизации 401?

OPENAI_API_KEY не применился, либо ключ скопирован не полностью. Выполните echo $OPENAI_API_KEY и убедитесь, что ключ начинается с sk-teamo- и не содержит пробелов.

Не получается переключить модель в Codex?

Убедитесь, что название модели написано строчными буквами с разделителями - (deepseek-v4-pro-free). Актуальный список можно получить через curl .../v1/models.

Конфликтуют ли профили с переменными окружения?

Явно указанные в профиле base_url / api_key имеют приоритет над переменными окружения — идеально для схемы «по умолчанию GPT, отдельные задачи — на DeepSeek».

Работают ли рассуждения V4 Pro в Codex?

Да. V4 Pro работает по OpenAI-совместимому протоколу, и рассуждения передаются насквозь; дополнительная настройка Codex не нужна.

Получите ключ в TeamoRouter — и две переменные окружения подключат DeepSeek V4 Pro к Codex.

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.