Codex · основной раздел

Codex с нашим API

Настройте один provider для Codex CLI, Codex App, VS Code и Cursor. Установщик сохранит существующие MCP, sandbox и пользовательские параметры.

Начать установку Настроить вручную Открыть статистику

Один API, разные клиенты

Ключ определяет доступные модели, а конфигурация клиента определяет протокол запроса. Поэтому универсальность строится через совместимые API-адаптеры, а не через обещание, что любой model ID запустится в любом клиенте без проверки.

Клиент	Протокол	Как подключается	Статус
Codex CLI	Responses API	`model_providers.crs`	готово
Codex App	Responses API	общий `~/.codex`	готово
VS Code / Cursor	Responses API	Codex extension и общий конфиг	готово
Claude Code	Messages API	отдельный раздел	готово

Какая модель в каком клиенте

Шлюз транслирует протоколы, поэтому модель не привязана к «родному» клиенту. Доступные ID определяются ключом — актуальный список вернет GET /v1/models.

Сценарий	Пример модели	Клиенты
GPT по умолчанию	`gpt-5.4`	Codex CLI / App / IDE
Claude в Claude Code	`claude-sonnet-5`, `claude-opus-4-8`	Claude Code CLI / IDE
Claude в Codex	`claude-sonnet-5` через `-m` или `config.toml`	Codex CLI / App / IDE

Базовый URL для Codex

https://bridge.gptclaudegemini.xyz/ используется Codex-клиентами через Responses API. Для обычных OpenAI-compatible интеграций смотрите отдельный раздел Route API.

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

Скачайте установщик, просмотрите файл и запустите его. Ключ вводится скрыто и не попадает в историю команд.

Подготовьте ключ

Используйте выданный ключ формата sk-xxxxxxxxxx. Не добавляйте его в URL, командную строку или публичный файл проекта.

Запустите установщик

PowerShell

Invoke-WebRequest https://docs.gptclaudegemini.xyz/install.ps1 -OutFile .\ccg-codex-install.ps1
Get-Content .\ccg-codex-install.ps1
powershell -ExecutionPolicy Bypass -File .\ccg-codex-install.ps1

Terminal

curl -fsSL https://docs.gptclaudegemini.xyz/install.sh -o ccg-codex-install.sh
less ccg-codex-install.sh
bash ccg-codex-install.sh

Перезапустите клиент

Закройте и снова откройте терминал, Codex App или IDE. Затем проверьте конфигурацию:
Terminal
```
codex --version
codex
```

Что делает установщик

Скрипт рассчитан и на чистую установку, и на уже настроенный Codex.

Проверяет наличие Codex CLI и ставит его, если команда отсутствует.
Создает ~/.codex и резервную копию существующего config.toml.
Обновляет только top-level model settings и таблицу [model_providers.crs].
Сохраняет MCP servers, sandbox, approvals, skills и остальные пользовательские настройки.
Записывает ключ в ~/.codex/.env, не печатает его и ограничивает права файла на macOS/Linux.
Не создает и не заменяет auth.json: для custom provider он не нужен.

Предварительный просмотр

Dry run не запрашивает ключ, ничего не устанавливает и не меняет файлы.

PowerShell

.\ccg-codex-install.ps1 -DryRun

Terminal

bash ccg-codex-install.sh --dry-run

Резервная копия обязательна

Если config.toml уже существует, рядом появится файл вида config.toml.bak.20260718010101. Установщик не удаляет старые копии.

Ручная настройка

Используйте этот путь, если не хотите запускать установщик или настраиваете управляемое окружение.

1. Установите Codex CLI

npm

npm install -g @openai/codex
codex --version

Подойдет актуальная LTS-версия Node.js. Если CLI уже установлен, обновите его командой codex update.

2. Добавьте provider в config.toml

Файл находится в ~/.codex/config.toml. Если в нем уже есть MCP или permissions, не заменяйте весь файл: обновите top-level строки и добавьте таблицу provider.

~/.codex/config.toml

model_provider = "crs"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "CCG API"
base_url = "https://bridge.gptclaudegemini.xyz/"
wire_api = "responses"
requires_openai_auth = false
env_key = "CRS_OAI_KEY"

3. Сохраните ключ в .env

Создайте ~/.codex/.env. Этот файл работает и для клиентов, которые не наследуют environment variables из терминала.

~/.codex/.env

CRS_OAI_KEY="sk-xxxxxxxxxx"

Не добавляйте секрет в config.toml

env_key содержит только имя переменной. Сам ключ хранится отдельно в .env и не должен попадать в Git.

4. Перезапустите Codex

Полностью перезапустите CLI, App или IDE extension. В CLI команда /status должна показать provider crs.

Выбор модели

Модель по умолчанию задается в config.toml. Для одного запуска ее можно переопределить флагом -m.

Terminal

codex -m gpt-5.6-terra
codex -m MODEL_ID_FROM_YOUR_PLAN -C /path/to/project

Model ID должен быть доступен ключу

Название клиента не ограничивает бренд модели само по себе, но backend обязан поддерживать Responses API и инструменты, которые ожидает Codex. Список доступных ID зависит от продукта и выданного ключа.

Claude-модели в Codex

С ключом, имеющим доступ к Claude-моделям, Codex CLI, App и IDE работают и с Claude: укажите claude-модель (например claude-sonnet-5) в config.toml или флагом -m — шлюз транслирует Responses API в Anthropic-формат автоматически. Актуальный список ID вернет GET https://bridge.gptclaudegemini.xyz/v1/models с вашим ключом. Настройка Claude Code описана в отдельном разделе.

CLI, Codex App и IDE

Все три варианта читают пользовательский ~/.codex/config.toml. Поэтому отдельный ключ для каждого клиента не требуется.

Terminal

Codex CLI

Запускайте codex в папке проекта или передайте путь через -C.

Desktop

Codex App

После настройки полностью закройте и откройте приложение, чтобы оно перечитало .env.

Editor

VS Code / Cursor

Установите официальное Codex extension и выполните Reload Window после изменения конфигурации.

Примеры запуска

codex
codex -C "D:\cursor\my-project"
codex -C "/Users/me/projects/my-project"

Не включайте полный доступ без необходимости

Начните со стандартных permissions. Флаги обхода sandbox подходят только для доверенных проектов и осознанного сценария.

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

Codex сообщает, что CRS_OAI_KEY отсутствует

Проверьте путь ~/.codex/.env, имя CRS_OAI_KEY и перезапустите клиент. На macOS/Linux задайте права chmod 600 ~/.codex/.env.

Ошибка account/read failed during TUI bootstrap

Проверьте, что в [model_providers.crs] указано requires_openai_auth = false. После изменения полностью перезапустите Codex.

CLI работает, а App или IDE не видит ключ

App и IDE могут не наследовать переменные shell. Храните значение в ~/.codex/.env, затем полностью перезапустите приложение или выполните Reload Window в редакторе.

После установки пропали мои MCP или sandbox settings

Новый установщик сохраняет эти секции. Восстановите предыдущую версию из config.toml.bak.TIMESTAMP, затем повторите установку актуальным скриптом. Не используйте старый установщик Route API для Codex provider.

Модель не найдена или недоступна

Проверьте точный model ID и доступ вашего ключа. Сначала верните модель по умолчанию gpt-5.4, затем запросите актуальный список для вашего продукта.

Статистика и ключ

Статистика открывается на отдельном сервисе. Для поиска используйте полный токен; в интерфейсе отображается только маскированная часть ключа.

Открыть статистику

Секрет не хранится на странице документации

Этот сайт статический: здесь нет формы ввода ключа, базы токенов или server-side логики авторизации.

Codex · primary guide

Use Codex with our API

Configure one provider for Codex CLI, Codex App, VS Code, and Cursor. The installer preserves your existing MCP, sandbox, and user settings.

Start installation Configure manually Open usage

One API, multiple clients

Your key controls model access while each client determines the request protocol. Portability comes from compatible API adapters, not from assuming every model ID works in every client without verification.

Client	Protocol	Connection	Status
Codex CLI	Responses API	`model_providers.crs`	ready
Codex App	Responses API	shared `~/.codex`	ready
VS Code / Cursor	Responses API	Codex extension and shared config	ready
Claude Code	Messages API	dedicated guide	ready

Which model in which client

The gateway translates protocols, so a model is not tied to its "native" client. Available IDs are determined by your key — GET /v1/models returns the current list.

Scenario	Example model	Clients
Default GPT	`gpt-5.4`	Codex CLI / App / IDE
Claude in Claude Code	`claude-sonnet-5`, `claude-opus-4-8`	Claude Code CLI / IDE
Claude in Codex	`claude-sonnet-5` via `-m` or `config.toml`	Codex CLI / App / IDE

Codex base URL

https://bridge.gptclaudegemini.xyz/ serves Codex clients over the Responses API. For regular OpenAI-compatible integrations, see the separate Route API guide.

Quickstart

Download the installer, inspect it, and run it. The key prompt is hidden, so the key does not enter your shell history.

Prepare your key
Use the issued key in the form sk-xxxxxxxxxx. Do not place it in a URL, command line, or public project file.

Run the installer

PowerShell

Invoke-WebRequest https://docs.gptclaudegemini.xyz/install.ps1 -OutFile .\ccg-codex-install.ps1
Get-Content .\ccg-codex-install.ps1
powershell -ExecutionPolicy Bypass -File .\ccg-codex-install.ps1

Terminal

curl -fsSL https://docs.gptclaudegemini.xyz/install.sh -o ccg-codex-install.sh
less ccg-codex-install.sh
bash ccg-codex-install.sh

Restart the client
Close and reopen your terminal, Codex App, or IDE. Then verify the setup:
Terminal
```
codex --version
codex
```

What the installer changes

The script supports both clean installs and existing Codex setups.

Checks for Codex CLI and installs it when the command is missing.
Creates ~/.codex and backs up an existing config.toml.
Updates only top-level model settings and [model_providers.crs].
Preserves MCP servers, sandbox, approvals, skills, and all other user settings.
Writes the key to ~/.codex/.env, never prints it, and restricts file permissions on macOS/Linux.
Does not create or replace auth.json; a custom provider does not require it.

Preview changes

Dry run does not request a key, install software, or modify files.

PowerShell

.\ccg-codex-install.ps1 -DryRun

Terminal

bash ccg-codex-install.sh --dry-run

Backups are mandatory

If config.toml exists, the installer creates a sibling such as config.toml.bak.20260718010101. It never deletes older backups.

Manual setup

Use this path if you do not want to run the installer or you manage a controlled environment.

1. Install Codex CLI

npm

npm install -g @openai/codex
codex --version

Use a current Node.js LTS release. If Codex is already installed, update it with codex update.

2. Add the provider to config.toml

The file is ~/.codex/config.toml. If it already contains MCP or permission settings, do not replace the whole file. Update the top-level lines and add the provider table.

~/.codex/config.toml

model_provider = "crs"
model = "gpt-5.4"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.crs]
name = "CCG API"
base_url = "https://bridge.gptclaudegemini.xyz/"
wire_api = "responses"
requires_openai_auth = false
env_key = "CRS_OAI_KEY"

3. Store the key in .env

Create ~/.codex/.env. This file also supports clients that do not inherit environment variables from your shell.

~/.codex/.env

CRS_OAI_KEY="sk-xxxxxxxxxx"

Do not place the secret in config.toml

env_key contains only the variable name. The key stays in .env and must never be committed to Git.

4. Restart Codex

Fully restart the CLI, App, or IDE extension. In the CLI, /status should report the crs provider.

Choose a model

Set the default in config.toml. Override it for one run with -m.

Terminal

codex -m gpt-5.6-terra
codex -m MODEL_ID_FROM_YOUR_PLAN -C /path/to/project

The key must allow the model ID

A client does not inherently restrict the model brand, but the backend must support the Responses API and the tools Codex expects. Available IDs depend on your product and key.

Claude models in Codex

With a key that has Claude model access, Codex CLI, App, and IDE also run Claude: set a claude model (for example claude-sonnet-5) in config.toml or via the -m flag — the gateway translates the Responses API to the Anthropic format automatically. Get the current ID list from GET https://bridge.gptclaudegemini.xyz/v1/models with your key. Claude Code setup lives in a dedicated guide.

CLI, Codex App, and IDE

All three read the user-level ~/.codex/config.toml, so you do not need a separate key for each client.

Terminal

Codex CLI

Run codex in your project directory or pass the path through -C.

Desktop

Codex App

After setup, fully close and reopen the app so it reloads .env.

Editor

VS Code / Cursor

Install the official Codex extension and run Reload Window after configuration changes.

Launch examples

codex
codex -C "D:\cursor\my-project"
codex -C "/Users/me/projects/my-project"

Do not enable full access by default

Start with standard permissions. Sandbox bypass flags are appropriate only for trusted projects and an intentional workflow.

Troubleshooting

Codex says CRS_OAI_KEY is missing

Check ~/.codex/.env, the exact CRS_OAI_KEY name, and restart the client. On macOS/Linux, run chmod 600 ~/.codex/.env.

account/read failed during TUI bootstrap

Make sure [model_providers.crs] contains requires_openai_auth = false. Then fully restart Codex.

The CLI works, but App or IDE cannot see the key

App and IDE processes may not inherit shell variables. Store the value in ~/.codex/.env, then fully restart the app or run Reload Window in the editor.

My MCP or sandbox settings disappeared

The new installer preserves these sections. Restore the previous version from config.toml.bak.TIMESTAMP, then rerun the current installer. Do not use the old Route API installer for this Codex provider.

The model is missing or unavailable

Verify the exact model ID and key access. First return to the default gpt-5.4, then request the current model list for your product.

Usage and keys

Usage lives in a separate service. Search with the complete token; the interface displays only a masked part of the key.

Open usage

This documentation page stores no secret

The site is static. It has no key form, token database, or server-side authentication logic.

Один API, разные клиенты

Какая модель в каком клиенте

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

Подготовьте ключ

Запустите установщик

Перезапустите клиент

Что делает установщик

Предварительный просмотр

Ручная настройка

1. Установите Codex CLI

2. Добавьте provider в config.toml

3. Сохраните ключ в .env

4. Перезапустите Codex

Выбор модели

CLI, Codex App и IDE

Codex CLI

Codex App

VS Code / Cursor

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

Статистика и ключ

One API, multiple clients

Which model in which client

Quickstart

Prepare your key

Run the installer

Restart the client

What the installer changes

Preview changes

Manual setup

1. Install Codex CLI

2. Add the provider to config.toml

3. Store the key in .env

4. Restart Codex

Choose a model

CLI, Codex App, and IDE

Codex CLI

Codex App

VS Code / Cursor

Troubleshooting

Usage and keys