Интеграция Codex с пользовательскими моделями CodingPlanX

Настройте OpenAI Codex CLI с использованием вашего API-ключа CodingPlanX.ai.

Руководство по интеграции Codex

CodingPlanX.ai поддерживает не только Claude Code, но и OpenAI Codex CLI. После покупки плана Claude Code и Codex используют общую квоту плана, что дает вам гибкость в выборе предпочитаемого инструмента.

Установка Codex CLI

npm install -g @openai/codex

Проверьте установку:

codex --version

Последняя версия: v0.114.0 (11.03.2026), включающая систему Skills, движок Hooks и многое другое.

Доступные модели

Вы можете получить доступ к следующим моделям Codex/GPT через CodingPlanX.ai:

Все модели используют общую квоту плана CodingPlanX.ai совместно с Claude Code.

Обзор конфигурации

Codex CLI требует два конфигурационных файла:

• ~/.codex/config.toml - Конфигурация сервиса
• ~/.codex/auth.json - Конфигурация аутентификации

---

Настройка для Windows

Шаг 1: Создание каталога конфигурации

mkdir %HOMEPATH%\.codex

Шаг 2: Создание config.toml

Создайте конфигурационный файл по пути ~/.codex/config.toml:

model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"

Шаг 3: Создание auth.json

Создайте файл аутентификации по пути ~/.codex/auth.json:

{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}

Замените cr_xxxxxxxxxx на ваш API-ключ CodingPlanX.ai.

Шаг 4: Настройка переменных окружения (Необязательно)

Если вы предпочитаете указывать ключ через переменные окружения:

# Временная настройка
$env:CRS_OAI_KEY = "cr_xxxxxxxxxx"

# Постоянная настройка
[System.Environment]::SetEnvironmentVariable("CRS_OAI_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)

Затем установите OPENAI_API_KEY в значение null в вашем файле auth.json.

---

Настройка для macOS

Шаг 1: Создание каталога конфигурации

mkdir -p ~/.codex

Шаг 2: Создание config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

Шаг 3: Создание auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

Замените cr_xxxxxxxxxx на ваш API-ключ CodingPlanX.ai.

Шаг 4: Настройка переменных окружения (Необязательно)

Если вы предпочитаете указывать ключ через переменные окружения:

# Временная настройка
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# Постоянная настройка
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Затем установите OPENAI_API_KEY в значение null в вашем файле auth.json.

---

Настройка для Linux

Шаг 1: Создание каталога конфигурации

mkdir -p ~/.codex

Шаг 2: Создание config.toml

cat > ~/.codex/config.toml << 'EOF'
model_provider = "crs"
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "crs"
base_url = "https://api.codingplanx.ai/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "CRS_OAI_KEY"
EOF

Шаг 3: Создание auth.json

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "cr_xxxxxxxxxx"
}
EOF

Замените cr_xxxxxxxxxx на ваш API-ключ CodingPlanX.ai.

Шаг 4: Настройка переменных окружения (Необязательно)

Если вы предпочитаете указывать ключ через переменные окружения:

# Временная настройка
export CRS_OAI_KEY="cr_xxxxxxxxxx"

# Постоянная настройка (Bash)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.bashrc
source ~/.bashrc

# Постоянная настройка (Zsh)
echo 'export CRS_OAI_KEY="cr_xxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Затем установите OPENAI_API_KEY в значение null в вашем файле auth.json.

---

Проверка конфигурации

После настройки запустите Codex CLI для проверки:

codex

Признаки успешной настройки

• Codex запускается нормально и подключается к сервису.
• Вы можете генерировать код и получать ответы от ИИ.
• Сетевые запросы правильно маршрутизируются через прокси CodingPlanX.ai.

Частые вопросы / Устранение неполадок

Файл конфигурации не найден

Проблема: Codex сообщает, что не может найти конфигурационный файл.

Решение:

1. Проверьте правильность пути к конфигурации.
2. Убедитесь, что каталог ~/.codex/ существует.
3. Убедитесь в наличии файлов config.toml и auth.json.

Ошибка аутентификации по API-ключу

Проблема: Недопустимая переменная окружения или неверный API-ключ.

Решение:

1. Проверьте, правильно ли установлена переменная окружения CRS_OAI_KEY.
2. Проверьте формат вашего API-ключа (начинается с cr_).
3. Убедитесь, что срок действия ключа не истек, проверив Консоль.

Проблемы с сетевым подключением

Проблема: Не удается подключиться к сервисам CodingPlanX.ai.

Решение:

1. Проверьте подключение к интернету.
2. Убедитесь, что base_url правильно установлен на https://api.codingplanx.ai/v1.