Настройка Codex с BetterToken

Для подключения Codex к BetterToken нужен custom model provider и API Key. base_url должен быть https://www.bettertoken.ai/v1, протокол — OpenAI Responses.

Требования

Установленный Node.js
API Key BetterToken (зарегистрироваться (https://www.bettertoken.ai/register))

Перед настройкой очистите OpenAI-related переменные окружения, чтобы они не переопределили config.toml или auth.json.Очистите:

OPENAI_API_KEY
OPENAI_BASE_URL

macOS / Linux:

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Windows PowerShell:

Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", $null, "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", $null, "User")

Установка Codex

npm install -g @openai/codex

Настройка

Автоматическая настройка
Настройка через CC Switch
Ручная настройка

Можно запустить автоматический скрипт BetterToken. Он записывает только provider-конфигурацию BetterToken и не заменяет предварительные требования выше. Скрипту нужен Node.js. Если API Key или модель не переданы явно, скрипт запросит их интерактивно, когда это поддерживается.Выберите шаг для своей ОС. Нужен только один вариант.

macOS / Linux

curl -fsSL https://www.bettertoken.ai/install-codex-provider.sh | bash

Windows

iwr https://www.bettertoken.ai/install-codex-provider.ps1 -OutFile "$env:TEMP\install-codex-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1"

Скопируйте model ID из model plaza

Откройте model plaza (https://www.bettertoken.ai/pricing) BetterToken и скопируйте актуальный ID модели из Codex group. Ниже замените все YOUR_CODEX_MODEL_ID на это значение.

Проверьте расположение конфигов

Для ручной настройки нужны файлы Codex config.toml и auth.json.

Система	`config.toml`	`auth.json`
macOS / Linux	`~/.codex/config.toml`	`~/.codex/auth.json`
Windows	`C:\Users\YOUR_USER\.codex\config.toml`	`C:\Users\YOUR_USER\.codex\auth.json`

Отредактируйте config.toml Codex

Откройте config.toml. Создайте его, если файла нет.

Этот блок применим только при ручном редактировании ~/.codex/config.toml. Если вы настраиваете Codex через CC Switch, точно следуйте инструкции CC Switch и не заменяйте конфигурацию, которой управляет CC Switch.

Добавьте:

model_provider = "bettertoken"
model = "YOUR_CODEX_MODEL_ID"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

Запишите auth.json Codex

Откройте auth.json. Создайте его, если файла нет.Запишите содержимое ниже, заменив YOUR_API_KEY на API Key BetterToken:

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

Перезапустите Codex в терминале

После изменения config.toml или auth.json остановите текущий процесс Codex и запустите его в новой terminal session.

Запустите Codex

codex

Справочник параметров

Параметр	Описание
`model_provider`	ID provider по умолчанию. Должен совпадать с `bettertoken` в `[model_providers.bettertoken]`
`model`	ID модели, которую Codex использует после запуска. Берите модель из Codex group в model plaza
`model_reasoning_effort`	Усилие reasoning. Используйте `low`, `medium` или `high` по необходимости
`disable_response_storage`	Отключает сохранение response. Оставьте `true`
`name`	Отображаемое имя provider. Можно оставить `BetterToken`
`base_url`	Endpoint BetterToken для Codex / OpenAI-compatible protocol. Должен включать `/v1`
`wire_api`	Протокол API, который использует Codex. Оставьте `responses`
`requires_openai_auth`	Указывает Codex читать API Key из OpenAI auth file. Оставьте `true`

Конфигурация 1M context

Если вы используете long-context модель из Codex group, оставьте эти две настройки:

model_context_window = 1000000
model_auto_compact_token_limit = 900000

Параметр	Назначение
`model_context_window`	Задает доступное context window в `1,000,000` токенов
`model_auto_compact_token_limit`	Запускает compaction до жесткого лимита контекста и снижает риск исчерпания context

Если конфигурацию пишет CC Switch, предпочитайте сгенерированный им файл. Редактируйте эти значения вручную только для manual setup или troubleshooting.

Проверка

После запуска отправьте тестовое сообщение. Обычный ответ означает, что подключение работает. Если что-то не работает, проверьте:

base_url равен https://www.bettertoken.ai/v1
wire_api остается responses
model — это ID модели из Codex group
OPENAI_API_KEY в ~/.codex/auth.json — ваш API Key BetterToken
Старые переменные OPENAI_API_KEY или OPENAI_BASE_URL не мешают настройке

​Требования

​Установка Codex

​Настройка

​Справочник параметров

​Конфигурация 1M context

​Проверка

Требования

Установка Codex

Настройка

Справочник параметров

Конфигурация 1M context

Проверка