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

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

Зачем через VTOP Ai

Из России без VPN. Запросы идут на api.daaj.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
Ключ VTOP Ai
Создайте ключ в панели ключей — он начинается с sk-VTOP Ai-.
Файл ~/.codex/config.toml
config.toml
```
model_provider = "VTOP Ai"
model_reasoning_effort = "high"
model = "gpt-5.6-sol"

[model_providers.VTOP Ai]
name = "VTOP Ai"
base_url = "https://api.daaj.ru/v1"

[model_providers.VTOP Ai.auth]
command = "sh"
args = ["-c", "echo $vtop_api_key"]
```
На Windows вместо блока auth с sh:
Windows auth
```
[model_providers.VTOP Ai.auth]
command = "powershell"
args = ["-NoProfile", "-Command", "Write-Output $env:vtop_api_key"]
```
Почему не env_key
Простой env_key = "vtop_api_key" тоже авторизует, но Codex не подтянет каталог моделей. Не-OpenAI модели покажут предупреждение «Unknown model». Предпочитайте блок auth с командой.
Переменная окружения
Команда в auth читает $vtop_api_key — задайте её до запуска Codex.
Профиль оболочки
```
# ~/.zshrc, ~/.bashrc или ~/.config/fish/config.fish
export vtop_api_key="sk-VTOP Ai-xxx"
```
На Windows — пользовательская переменная, потом полный перезапуск Codex (включая десктопное приложение: оно не видит переменные, заданные только в одном терминале):
Windows
```
setx vtop_api_key "sk-VTOP Ai-xxx"
```
Запуск
Терминал
```
cd /path/to/your/project
codex
```
Запросы идут через VTOP Ai. История ключа — панель.

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

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

Поле	Смысл	Пример
`model_provider`	Провайдер запросов	`"VTOP Ai"`
`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.VTOP Ai

model_provider = "VTOP Ai"
model_reasoning_effort = "high"
model = "gpt-5.6-sol"

[model_providers.VTOP Ai]
name = "VTOP Ai"
base_url = "https://api.daaj.ru/v1"

[model_providers.VTOP Ai.auth]
command = "sh"
args = ["-c", "echo $vtop_api_key"]

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

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

projects

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

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

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

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

Ошибки авторизации. vtop_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.
Приватность. VTOP Ai не логирует исходный код промптов.