AITUNNEL ⚡ Codex CLI — документация AITUNNEL

Codex CLI говорит на OpenAI Chat Completions — отдельный прокси не ставится. Агент заточен под модели OpenAI (инструменты, reasoning). Другие модели из каталога можно подставить, но агентные задачи на них часто слабее.

Зачем через AITUNNEL

Из России без VPN. Запросы идут на api.aitunnel.ru. Аккаунт OpenAI не нужен.
Оплата в рублях, бюджет на ключе, расход в панели.
Запасные модели и провайдер. Если апстрим не ответил — fallback и выбор провайдера.
Любая модель из каталога. Поменяйте model в config.toml: gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna. Слаг со слешем уходит в OpenRouter.

Быстрый старт

Установка
Инструкция Codex CLI. Через npm нужен Node.js 18+.
npm install -g @openai/codex
Ключ AITUNNEL
Создайте ключ в панели ключей — он начинается с sk-aitunnel-.

Файл ~/.codex/config.toml

config.toml

model_provider = "aitunnel"
model_reasoning_effort = "high"
model = "gpt-5.6-sol"

[model_providers.aitunnel]
name = "aitunnel"
base_url = "https://api.aitunnel.ru/v1"

[model_providers.aitunnel.auth]
command = "sh"
args = ["-c", "echo $AITUNNEL_API_KEY"]

На Windows вместо блока auth с sh:

Windows auth

[model_providers.aitunnel.auth]
command = "powershell"
args = ["-NoProfile", "-Command", "Write-Output $env:AITUNNEL_API_KEY"]

Почему не env_key

Простой env_key = "AITUNNEL_API_KEY" тоже авторизует, но Codex не подтянет каталог моделей. Не-OpenAI модели покажут предупреждение «Unknown model». Предпочитайте блок auth с командой.

Переменная окружения
Команда в auth читает $AITUNNEL_API_KEY — задайте её до запуска Codex.
Профиль оболочки
```
# ~/.zshrc, ~/.bashrc или ~/.config/fish/config.fish
export AITUNNEL_API_KEY="sk-aitunnel-xxx"
```
На Windows — пользовательская переменная, потом полный перезапуск Codex (включая десктопное приложение: оно не видит переменные, заданные только в одном терминале):
Windows
```
setx AITUNNEL_API_KEY "sk-aitunnel-xxx"
```
Запуск
Терминал
```
cd /path/to/your/project
codex
```
Запросы идут через AITUNNEL. История ключа — панель.

Справка по конфигу

Основные поля

Поле	Смысл	Пример
`model_provider`	Провайдер запросов	`"aitunnel"`
`model`	ID из каталога	`gpt-5.6-sol`
`model_reasoning_effort`	Уровень рассуждений	`low`, `medium`, `high`, `xhigh`, `max`
`show_raw_agent_reasoning`	Показывать reasoning в UI	`true` / `false`
`personality`	Пресет характера агента	`pragmatic`, `helpful`

Подробнее про reasoning — токены рассуждений.

Блок провайдера

model_providers.aitunnel

model_provider = "aitunnel"
model_reasoning_effort = "high"
model = "gpt-5.6-sol"

[model_providers.aitunnel]
name = "aitunnel"
base_url = "https://api.aitunnel.ru/v1"

[model_providers.aitunnel.auth]
command = "sh"
args = ["-c", "echo $AITUNNEL_API_KEY"]

base_url — https://api.aitunnel.ru/v1. Со слэшем /v1: Codex сам ходит в /chat/completions.
auth.command / auth.args — команда, которой Codex достаёт ключ. Здесь это echo $AITUNNEL_API_KEY. Именно командный auth запускает обновление каталога, и не-OpenAI модели получают нормальные метаданные. На Windows — command = "powershell" и Write-Output $env:AITUNNEL_API_KEY: sh там нет.

env_key

Простой env_key = "AITUNNEL_API_KEY" тоже авторизует, но каталог не подтянется.

Доверие проектам

projects

[projects."/path/to/trusted/project"]
trust_level = "trusted"

[projects."/path/to/untrusted/project"]
trust_level = "untrusted"

trusted — полный доступ (команды, правки файлов).
untrusted — ограниченный доступ.

Устранение неполадок

Ошибки авторизации. AITUNNEL_API_KEY задан и ключ живой. Проверьте в панели ключей. 401 с «Missing Authentication header» — команда auth не отработала. На Windows: вариант PowerShell выше, переменная задана через setx, Codex полностью перезапущен.
Model not found. ID как в каталоге: gpt-5.6-sol, не openai/gpt-5.6-sol и не ~openai/gpt-latest.
«Unknown model». Скорее всего стоит env_key вместо командного auth.
Приватность. AITUNNEL не логирует исходный код промптов.