Подключение приложений и агентов для кода

Выберите сценарий, укажите Base URL и API Key CostRouter, затем проверьте первый запрос в журнале использования.

Сценарий 1

Подключите AI-приложение

Сохраните совместимый SDK или HTTP-клиент. Замените только Base URL, API Key и ID модели.

Рекомендуемый первый шаг

Первый рабочий запрос

Пример curl

curl -X POST "https://costrouter.ai/v1/chat/completions" \
  -H "Authorization: Bearer YOUR_COSTROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-luna",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: CostRouter connected"
      }
    ],
    "stream": false
  }'

Три значения для настройки

Base URL: https://costrouter.ai/v1
Авторизация: Bearer YOUR_COSTROUTER_API_KEY
Модель: скопируйте точный ID из каталога

Сценарий 2

Настройте агента для кода

В каждой конфигурации указаны Base URL и переменная окружения, в которой передаётся API Key. Замените YOUR_COSTROUTER_API_KEY и идентификатор модели, затем запустите инструмент командами из примера.

Codex

Совместимая с CostRouter настройка

Настроить

Установить Codex

Установите инструмент или убедитесь, что текущая версия запускается корректно.

Установить Codex

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

Рекомендуем сначала проверить

Скопируйте одну команду и проверьте подключение

Команда экспортирует API Key в текущий терминал, а затем запускает Codex с временным провайдером CostRouter. Файл config.toml не изменяется, а значения сбросятся после закрытия терминала.

Текущий терминал (zsh / bash)

export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" && \
codex \
  -c 'model_provider="costrouter"' \
  -c 'model="gpt-5.6-luna"' \
  -c 'model_providers.costrouter.name="CostRouter"' \
  -c 'model_providers.costrouter.wire_api="responses"' \
  -c 'model_providers.costrouter.env_key="OPENAI_API_KEY"' \
  -c 'model_providers.costrouter.base_url="https://costrouter.ai/v1"'

Постоянная настройка

Сохраните адрес провайдера и API Key в config.toml, чтобы следующие сессии Codex загружали их автоматически. Ключ хранится на устройстве в открытом виде: используйте этот вариант только на личном компьютере и защитите файл.

~/.codex/config.toml

model_provider = "costrouter"
model = "gpt-5.6-luna"

[model_providers.costrouter]
name = "CostRouter"
wire_api = "responses"
base_url = "https://costrouter.ai/v1"
experimental_bearer_token = "YOUR_COSTROUTER_API_KEY"

Используйте отдельный API Key для инструмента.
Выберите доступную модель в каталоге.
Перезапустите инструмент и проверьте запрос в журнале.

Claude Code

Совместимая с CostRouter настройка

Настроить

Установить Claude Code

Установите инструмент или убедитесь, что текущая версия запускается корректно.

Установить Claude Code

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

Рекомендуем сначала проверить

Скопируйте одну команду и проверьте подключение

Запустите команду целиком. Она экспортирует Base URL и API Key в текущий терминал, не изменяя файлы конфигурации. Значения сбросятся после закрытия этого терминала.

Текущий терминал (zsh / bash)

export ANTHROPIC_BASE_URL="https://costrouter.ai" \
  ANTHROPIC_AUTH_TOKEN="YOUR_COSTROUTER_API_KEY" && \
claude

Постоянная настройка

Сохраните значения в файле конфигурации инструмента, чтобы они применялись и после перезапуска.

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://costrouter.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_COSTROUTER_API_KEY"
  }
}

Используйте отдельный API Key для инструмента.
Выберите доступную модель в каталоге.
Перезапустите инструмент и проверьте запрос в журнале.

Gemini CLI

Совместимая с CostRouter настройка

Настроить

Установить Gemini CLI

Установите инструмент или убедитесь, что текущая версия запускается корректно.

Установить Gemini CLI

npm install -g @google/gemini-cli
gemini --version

Рекомендуем сначала проверить

Скопируйте одну команду и проверьте подключение

Текущий терминал (zsh / bash)

export GOOGLE_GEMINI_BASE_URL="https://costrouter.ai" \
  GEMINI_API_KEY="YOUR_COSTROUTER_API_KEY" \
  GEMINI_MODEL="gemini-available-model-id" && \
gemini

Постоянная настройка

Сохраните значения в файле конфигурации инструмента, чтобы они применялись и после перезапуска.

~/.gemini/settings.json

{
  "env": {
    "GOOGLE_GEMINI_BASE_URL": "https://costrouter.ai",
    "GEMINI_API_KEY": "YOUR_COSTROUTER_API_KEY",
    "GEMINI_MODEL": "gemini-available-model-id"
  }
}

Используйте отдельный API Key для инструмента.
Выберите доступную модель в каталоге.
Перезапустите инструмент и проверьте запрос в журнале.

Cursor

Совместимая с CostRouter настройка

Настроить

Установить Cursor

Установите инструмент или убедитесь, что текущая версия запускается корректно.

Установить Cursor

cursor .

Рекомендуем сначала проверить

Скопируйте одну команду и проверьте подключение

Переменные передаются только этому запуску Cursor и процессам проекта. Возможность управлять встроенным Agent по-прежнему зависит от версии Cursor.

Текущий терминал (zsh / bash)

export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" \
  OPENAI_BASE_URL="https://costrouter.ai/v1" && \
cursor .

Постоянная настройка

Сохраните значения в файле .env проекта для кода и скриптов, запускаемых в Cursor. Поддержка пользовательского Base URL встроенным Agent зависит от установленной версии.

.env

OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY"
OPENAI_BASE_URL="https://costrouter.ai/v1"

Используйте отдельный API Key для инструмента.
Выберите доступную модель в каталоге.
Перезапустите инструмент и проверьте запрос в журнале.

Управление локальными профилями агентов

cc-switch сохраняет и переключает локальные профили провайдеров. Добавьте Base URL и API Key CostRouter один раз.

Скачать cc-switch

Продакшен

Перед запуском

Сохраняйте контроль доступа и прозрачность расходов при росте трафика.

Отдельный Key для каждого приложения, окружения или агента.
Настройте лимиты, срок действия, модели и список IP.
Проверяйте журналы после настройки и смены модели.
Загружайте секреты из окружения или менеджера секретов.

Подключите AI-приложение

Первый рабочий запрос

Три значения для настройки

Настройте агента для кода

Codex

Установить Codex

Скопируйте одну команду и проверьте подключение

Постоянная настройка

Claude Code

Установить Claude Code

Скопируйте одну команду и проверьте подключение

Постоянная настройка

Gemini CLI

Установить Gemini CLI

Скопируйте одну команду и проверьте подключение

Постоянная настройка

Cursor

Установить Cursor

Скопируйте одну команду и проверьте подключение

Постоянная настройка

Управление локальными профилями агентов

Перед запуском

Связаться с нами