Claude Code · интеграция

Claude Code с нашим API

Подключите Claude Code CLI, расширение VS Code и desktop-приложение к вашему ключу через один файл настроек. Установщик сохранит hooks, permissions и MCP servers.

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

Один конфиг, все клиенты Claude Code

Claude Code использует протокол Anthropic Messages API. Все варианты клиента читают пользовательский ~/.claude/settings.json, поэтому настройка выполняется один раз.

Клиент	Протокол	Как подключается	Статус
Claude Code CLI	Messages API	`~/.claude/settings.json`	готово
VS Code / Cursor extension	Messages API	общий `~/.claude`	готово
Claude Code desktop	Messages API	общий `~/.claude`	готово

Базовый URL для Claude Code

https://bridge.gptclaudegemini.xyz принимает запросы Messages API на /v1/messages. Нужен ключ с доступом к Claude-моделям. Для Codex-клиентов используйте раздел Codex.

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

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

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

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

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

PowerShell

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

Terminal

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

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

Закройте и снова откройте терминал или IDE. Затем проверьте:
Terminal
```
claude --version
claude
```
Внутри сессии команда /status должна показать ваш base URL.

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

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

Проверяет наличие Claude Code и ставит его, если команда отсутствует.
Создает ~/.claude и резервную копию существующего settings.json.
Обновляет только блок env: ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, API_TIMEOUT_MS и переменные модели.
Сохраняет hooks, permissions, MCP servers и остальные пользовательские настройки.
Не печатает ключ и ограничивает права файла на macOS/Linux.

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

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

PowerShell

.\ccg-claude-install.ps1 -DryRun

Terminal

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

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

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

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

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

1. Установите Claude Code

npm

npm install -g @anthropic-ai/claude-code
claude --version

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

2. Добавьте env в settings.json

Файл находится в ~/.claude/settings.json. Если в нем уже есть hooks или permissions, не заменяйте весь файл: добавьте или обновите только блок env.

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://bridge.gptclaudegemini.xyz",
    "API_TIMEOUT_MS": "600000"
  }
}

Файл содержит секрет

В отличие от Codex, ключ хранится внутри settings.json. Не коммитьте файл в Git и ограничьте права: chmod 600 ~/.claude/settings.json на macOS/Linux.

3. Перезапустите Claude Code

Полностью перезапустите CLI или IDE. Внутри сессии /status должен показать base URL bridge.gptclaudegemini.xyz.

Выбор модели

По умолчанию Claude Code сам выбирает модель по «слотам» Opus / Sonnet / Haiku. Каждый слот можно переопределить переменной в блоке env.

~/.claude/settings.json → env

"ANTHROPIC_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"

Внутри сессии модель можно сменить командой /model. Доступные model ID зависят от вашего ключа и продукта:

Terminal

curl https://bridge.gptclaudegemini.xyz/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

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

Ключ с Claude-доступом видит только Claude-модели. Если нужного ID нет в списке, обратитесь к вашему тарифу или в поддержку.

Совместно с Codex

Claude Code и Codex настраиваются независимо и не конфликтуют: разные файлы конфигурации, разные протоколы, один сервис статистики.

	Claude Code	Codex
Конфигурация	`~/.claude/settings.json`	`~/.codex/config.toml` + `.env`
Протокол	Anthropic Messages API	OpenAI Responses API
Base URL	`https://bridge.gptclaudegemini.xyz`	`https://bridge.gptclaudegemini.xyz/`
Ключ	с доступом к Claude-моделям	с доступом к GPT-моделям

Claude-модели в Codex

Codex-клиенты могут работать и с Claude-моделями: укажите Claude-ключ в ~/.codex/.env и claude-модель в config.toml — шлюз транслирует Responses API в Messages API автоматически. Подробнее в разделе Codex.

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

Claude Code просит логин Anthropic или использует старый аккаунт

Если ранее выполнялся вход в аккаунт Anthropic, выполните /logout внутри сессии, затем перезапустите claude. При заданном ANTHROPIC_AUTH_TOKEN вход через браузер не требуется.

Настройки не применяются

Проверьте JSON-валидность ~/.claude/settings.json (лишняя запятая ломает весь файл), затем полностью перезапустите клиент. Команда /status показывает активный base URL.

Ошибка 401 или 403

Проверьте, что ключ скопирован целиком и имеет доступ к Claude-моделям. Ключи только с GPT-доступом не работают на /v1/messages.

Первый запрос упал с 5xx, повтор прошел

При недоступности одного upstream шлюз автоматически переключается на резервный, но первая попытка может вернуть ошибку. Просто повторите запрос; если ошибка стабильна, проверьте статистику или напишите в поддержку.

IDE-расширение не видит настройки

Расширения читают тот же ~/.claude/settings.json, но применяют его после полного перезапуска IDE (Reload Window в VS Code).

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

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

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

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

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

Claude Code · integration

Use Claude Code with our API

Connect Claude Code CLI, the VS Code extension, and the desktop app to your key through one settings file. The installer preserves hooks, permissions, and MCP servers.

Start installation Configure manually Open usage

One config, every Claude Code client

Claude Code speaks the Anthropic Messages API. Every client variant reads the user-level ~/.claude/settings.json, so you configure once.

Client	Protocol	Connection	Status
Claude Code CLI	Messages API	`~/.claude/settings.json`	ready
VS Code / Cursor extension	Messages API	shared `~/.claude`	ready
Claude Code desktop	Messages API	shared `~/.claude`	ready

Claude Code base URL

https://bridge.gptclaudegemini.xyz accepts Messages API requests on /v1/messages. You need a key with Claude model access. For Codex clients, see the Codex 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 with Claude model access. Do not place it in a URL, command line, or public project file.

Run the installer

PowerShell

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

Terminal

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

Restart the client
Close and reopen your terminal or IDE. Then verify:
Terminal
```
claude --version
claude
```
Inside a session, /status should report your base URL.

What the installer changes

The script supports both clean installs and existing Claude Code setups.

Checks for Claude Code and installs it when the command is missing.
Creates ~/.claude and backs up an existing settings.json.
Updates only the env block: ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL, API_TIMEOUT_MS, and model variables.
Preserves hooks, permissions, MCP servers, and all other user settings.
Never prints the key and restricts file permissions on macOS/Linux.

Preview changes

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

PowerShell

.\ccg-claude-install.ps1 -DryRun

Terminal

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

Backups are mandatory

If settings.json exists, the installer creates a sibling such as settings.json.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 Claude Code

npm

npm install -g @anthropic-ai/claude-code
claude --version

Use a current Node.js LTS release. If Claude Code is already installed, update it with claude update.

2. Add env to settings.json

The file is ~/.claude/settings.json. If it already contains hooks or permissions, do not replace the whole file. Add or update only the env block.

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://bridge.gptclaudegemini.xyz",
    "API_TIMEOUT_MS": "600000"
  }
}

This file contains a secret

Unlike Codex, the key lives inside settings.json. Never commit the file to Git and restrict permissions: chmod 600 ~/.claude/settings.json on macOS/Linux.

3. Restart Claude Code

Fully restart the CLI or IDE. Inside a session, /status should report the bridge.gptclaudegemini.xyz base URL.

Choose a model

By default, Claude Code picks models by Opus / Sonnet / Haiku slots. Each slot can be overridden with a variable in the env block.

~/.claude/settings.json → env

"ANTHROPIC_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"

Inside a session, switch models with /model. Available model IDs depend on your key and product:

Terminal

curl https://bridge.gptclaudegemini.xyz/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

The key must allow the model ID

A key with Claude access lists only Claude models. If the ID you need is missing, check your plan or contact support.

Alongside Codex

Claude Code and Codex are configured independently and never conflict: separate config files, separate protocols, one usage service.

	Claude Code	Codex
Configuration	`~/.claude/settings.json`	`~/.codex/config.toml` + `.env`
Protocol	Anthropic Messages API	OpenAI Responses API
Base URL	`https://bridge.gptclaudegemini.xyz`	`https://bridge.gptclaudegemini.xyz/`
Key	with Claude model access	with GPT model access

Claude models in Codex

Codex clients can also run Claude models: put a Claude key into ~/.codex/.env and a claude model into config.toml — the gateway translates the Responses API to the Messages API automatically. See the Codex guide.

Troubleshooting

Claude Code asks for an Anthropic login or uses an old account

If you previously signed in to an Anthropic account, run /logout inside a session, then restart claude. With ANTHROPIC_AUTH_TOKEN set, no browser login is required.

Settings are not applied

Validate the JSON in ~/.claude/settings.json (a stray comma breaks the whole file), then fully restart the client. The /status command shows the active base URL.

401 or 403 errors

Make sure the key is copied in full and has Claude model access. Keys with GPT-only access do not work on /v1/messages.

The first request failed with 5xx, but the retry worked

When one upstream is unavailable, the gateway fails over automatically, but the first attempt can return an error. Simply retry; if the error persists, check usage or contact support.

The IDE extension ignores the settings

Extensions read the same ~/.claude/settings.json but apply it only after a full IDE restart (Reload Window in VS Code).

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.

Один конфиг, все клиенты Claude Code

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

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

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

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

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

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

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

1. Установите Claude Code

2. Добавьте env в settings.json

3. Перезапустите Claude Code

Выбор модели

Совместно с Codex

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

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

One config, every Claude Code client

Quickstart

Prepare your key

Run the installer

Restart the client

What the installer changes

Preview changes

Manual setup

1. Install Claude Code

2. Add env to settings.json

3. Restart Claude Code

Choose a model

Alongside Codex

Troubleshooting

Usage and keys