Главная → Руководства → Codex со своим API: настройка config.toml для Codex CLI и десктопного Codex

Codex со своим API: настройка config.toml для Codex CLI и десктопного Codex

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

Конфигурация

Добавьте провайдера в config.toml и сделайте его провайдером по умолчанию:

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

Важны три детали. base_url заканчивается на /v1, потому что Codex сам дописывает /responses. wire_api = "responses" заставляет Codex использовать Responses API, которую поддерживает этот шлюз. А env_key — это имя переменной окружения, а не сам ключ.

Где лежит файл

• macOS / Linux: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

Если папки и файла нет, создайте их. Десктопное приложение Codex читает тот же файл, что и инструмент командной строки, так что одна правка действует на оба. Если не хотите править TOML вручную, его может записать CC Switch — см. руководство по десктопным приложениям.

Как задать ключ, чтобы Codex его увидел

macOS / Linux — добавьте в профиль оболочки:

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows — сохраните для своей учётной записи:

setx APICLAN_API_KEY "sk-your-key"

Именно здесь ломается большинство настроек. Переменная, заданная через export или $env:, существует только в этом терминале; десктопное приложение, запущенное из Dock или меню «Пуск», её не видит. setx в Windows сохраняет её навсегда, но читают её только программы, запущенные после этого, — полностью закройте Codex и откройте снова.

Выбор модели и уровня рассуждений

Поменяйте model в конфигурации или переключитесь в сессии командой /model:

Модель	Подходит для
gpt-6.1-sol, gpt-5.6-terra	Повседневный код, правки, тесты — самая дешёвая за вызов
gpt-5.6-sol	Когда промпты настроены под GPT-5.6
gpt-6-astra	Сложные задачи, где лучший ответ стоит пятикратной цены

model_reasoning_effort принимает low, medium, high и xhigh. Чем выше уровень, тем больше текста: на gpt-5.6-sol здесь медианный вызов при high вернул 373 токена вывода, а при medium — 139, в 2,7 раза меньше; всё тарифицируется как вывод. Начинайте с medium. Цены — в руководстве по ценам API OpenAI.

Как выглядит трафик Codex здесь

За последние 30 дней 87% всех вызовов GPT на этом шлюзе пришли из Codex, все через /v1/responses в потоковом режиме. Медианный вызов:

• нёс около 67 000 токенов контекста, 86% из кэша
• длился 14 секунд, первый токен — через 10
• вернул 214 токенов вывода

Четыре самые частые ошибки

• 401 Unauthorized → Codex не видит APICLAN_API_KEY. Задайте её, как описано выше, и полностью перезапустите Codex. echo $APICLAN_API_KEY в том же окружении должен вывести ключ.
• 404 или HTML-страница → в base_url нет /v1 или он указан дважды.
• model not found → имя модели написано с ошибкой, или ваш ключ относится к группе без этой модели. Ориентируйтесь на список из GET https://apiclan.us/v1/models.
• stream disconnected или тайм-аут на длинных задачах → слишком долгое рассуждение превышает терпение прокси. Смените base_url на https://api.apiclan.us/v1 — он обходит 100-секундный лимит.

Claude Code следует обратному правилу — без /v1; подробнее в руководстве по base URL для Claude Code.

Начните пользоваться

Без подписки, без ежемесячного минимума, без звонков с продавцами. Пополните баланс в USDT и платите только за использованное — 1 USDT даёт 2 кредита баланса API.

Прочитать быстрый старт за 30 секунд

Язык: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

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