> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Настройка Codex с BetterToken
> Подключите BetterToken к Codex через /v1 и OpenAI Responses.
Для подключения 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:
```bash theme={null}
unset OPENAI_API_KEY
unset OPENAI_BASE_URL
```
Windows PowerShell:
```powershell theme={null}
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
```bash theme={null}
npm install -g @openai/codex
```
## Настройка
Можно запустить автоматический скрипт BetterToken. Он записывает только provider-конфигурацию BetterToken и не заменяет предварительные требования выше. Скрипту нужен `Node.js`. Если API Key или модель не переданы явно, скрипт запросит их интерактивно, когда это поддерживается.
Выберите шаг для своей ОС. Нужен только один вариант.
```bash theme={null}
curl -fsSL https://www.bettertoken.ai/install-codex-provider.sh | bash
```
```powershell theme={null}
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"
```
Этот путь описан в [инструкции CC Switch](/ru/ai-tools/cc-switch#codex-cli).
Перейдите сразу к [вкладке Codex в инструкции CC Switch](/ru/ai-tools/cc-switch#codex-cli).
После настройки в CC Switch вернитесь на эту страницу, чтобы проверить запуск и остальные примечания.
Откройте 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 через CC Switch, точно следуйте [инструкции CC Switch](/ru/ai-tools/cc-switch#codex-cli) и не заменяйте конфигурацию, которой управляет CC Switch.
Добавьте:
```toml theme={null}
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`. Создайте его, если файла нет.
Запишите содержимое ниже, заменив `YOUR_API_KEY` на API Key BetterToken:
```json theme={null}
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}
```
После изменения `config.toml` или `auth.json` остановите текущий процесс Codex и запустите его в новой terminal session.
```bash theme={null}
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**, оставьте эти две настройки:
```toml theme={null}
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.
## Проверка
После запуска отправьте тестовое сообщение. Обычный ответ означает, что подключение работает.
Если что-то не работает, проверьте:
1. `base_url` равен `https://www.bettertoken.ai/v1`
2. `wire_api` остается `responses`
3. `model` — это ID модели из **Codex group**
4. `OPENAI_API_KEY` в `~/.codex/auth.json` — ваш API Key BetterToken
5. Старые переменные `OPENAI_API_KEY` или `OPENAI_BASE_URL` не мешают настройке