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

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

Сценарий 1

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

Продолжайте работать с совместимым SDK или HTTP-клиентом. Замените только Base URL, API-ключ и 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-ключа. Замените YOUR_COSTROUTER_API_KEY своим ключом, укажите ID модели и запустите инструмент командами из примера.

Codex

Codex

Настройки для подключения к CostRouter

Настроить
1

Установить Codex

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

Установить Codex

npm install -g @openai/codex
codex --version
2
Сначала проверьте подключение

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

Команда задаёт API-ключ в текущем сеансе терминала и запускает 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"'
3

Сохранение настроек

Сохраните адрес провайдера и API-ключ в 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-ключ для каждого инструмента.
  • Выберите доступную модель в каталоге.
  • Перезапустите инструмент и проверьте запрос в журнале.
Antigravity

Claude Code

Настройки для подключения к CostRouter

Настроить
1

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

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

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

npm install -g @anthropic-ai/claude-code
claude --version
2
Сначала проверьте подключение

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

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

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

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

Сохранение настроек

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

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://costrouter.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_COSTROUTER_API_KEY"
  }
}
  • Создайте отдельный API-ключ для каждого инструмента.
  • Выберите доступную модель в каталоге.
  • Перезапустите инструмент и проверьте запрос в журнале.
Gemini

Gemini CLI

Настройки для подключения к CostRouter

Настроить
1

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

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

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

npm install -g @google/gemini-cli
gemini --version
2
Сначала проверьте подключение

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

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

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

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

Сохранение настроек

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

~/.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-ключ для каждого инструмента.
  • Выберите доступную модель в каталоге.
  • Перезапустите инструмент и проверьте запрос в журнале.
Cursor

Cursor

Настройки для подключения к CostRouter

Настроить
1

Установить Cursor

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

Установить Cursor

cursor .
2
Сначала проверьте подключение

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

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

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

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

Сохранение настроек

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

.env

OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY"
OPENAI_BASE_URL="https://costrouter.ai/v1"
  • Создайте отдельный API-ключ для каждого инструмента.
  • Выберите доступную модель в каталоге.
  • Перезапустите инструмент и проверьте запрос в журнале.

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

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

Скачать cc-switch

Продакшен

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

Контролируйте доступ и расходы по мере роста трафика.

  • Создавайте отдельный API-ключ для каждого приложения, окружения или агента.
  • Настройте лимит, срок действия, доступные модели и список разрешённых IP-адресов.
  • Проверяйте журнал запросов после настройки и смены модели.
  • Загружайте секреты из окружения или менеджера секретов.
Подключение ИИ-приложений и агентов для программирования | CostRouter