Настройка Codex CLI

Codex — терминальный AI-агент для программирования с открытым исходным кодом от OpenAI. Это руководство показывает, как направить его на Claudexia API.

Что такое Codex?

Codex CLI поддерживает пользовательских провайдеров моделей через файл config.toml. Настроив Claudexia как провайдера, вы можете направлять запросы Codex через единый API Claudexia и использовать как GPT, так и Claude модели из одного агента.

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

Шаг 1: Установка Codex CLI

Установите Codex глобально через npm:

bash

npm install -g @openai/codex

Шаг 2: Получите API-ключ Claudexia

Зарегистрируйтесь или войдите в личный кабинет Claudexia.
Откройте Личный кабинет > API-ключи и создайте новый ключ.
Скопируйте ключ — он будет использоваться как переменная окружения CODEX_KEY.

Шаг 3: Настройка Codex для Claudexia

Codex читает конфигурацию из ~/.codex/config.toml. Создайте или отредактируйте этот файл со следующей конфигурацией:

toml (~/.codex/config.toml)

model_provider = "claudexia"
model_reasoning_effort = "medium"
model = "gpt-5.5"

[model_providers.claudexia]
name = "claudexia"
base_url = "https://api.claudexia.tech/v1"
env_key = "CODEX_KEY"

Шаг 4: Установите API-ключ

Экспортируйте ключ в профиль вашей оболочки, чтобы Codex мог его прочитать:

bash

# Add to ~/.zshrc, ~/.bashrc, or ~/.config/fish/config.fish
export CODEX_KEY="YOUR-KEY"

Шаг 5: Запуск Codex

Перейдите в директорию вашего проекта и запустите Codex в терминальном режиме:

bash

cd /path/to/your/project
codex

Или запустите версию настольного приложения:

bash

codex app

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

Основные настройки внутри ~/.codex/config.toml:

Настройка	Описание	Пример
`model_provider`	Имя провайдера, используемого для запросов к моделям.	`"claudexia"`
`model`	ID модели для отправки в Claudexia.	`"gpt-5.5"`
`model_reasoning_effort`	Уровень усилий рассуждения для моделей Codex.	`"low"`, `"medium"`, `"high"`
`base_url`	Endpoint API Claudexia. Используйте OpenAI-совместимый базовый URL с /v1.	`https://api.claudexia.tech/v1`
`env_key`	Имя переменной окружения, из которой Codex читает API-ключ.	`CODEX_KEY`

Важно: Для Codex базовый URL должен включать /v1 — Codex использует OpenAI-совместимый endpoint.

Windows (PowerShell)

powershell

npm install -g @openai/codex
$env:CODEX_KEY = "YOUR-KEY"
codex

Создайте файл конфигурации в вашем профиле пользователя:

powershell

New-Item -ItemType Directory -Force "$HOME\.codex" | Out-Null
notepad "$HOME\.codex\config.toml"

Решение проблем

Ошибки аутентификации

Убедитесь, что CODEX_KEY экспортирован в той же оболочке, где вы запускаете codex. Выполните echo $CODEX_KEY для проверки. Ключ должен быть действителен и активен в разделе Личный кабинет > API-ключи.

Модель не найдена

Сверьте ID модели со страницей Моделей. Codex передаёт значение из model напрямую в Claudexia, поэтому оно должно точно совпадать с одним из доступных ID (например, gpt-5.5, а не gpt5.5).

404 / неожиданный ответ

Codex требует OpenAI-совместимый endpoint — base_url должен заканчиваться на /v1. Проверьте, что вы случайно не удалили /v1 из config.toml.

OpenCode

API Key Configuration