Подключение приложений и агентов для программирования
Выберите сценарий подключения, укажите 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
Настройки для подключения к CostRouter
Настроить
Codex
Настройки для подключения к CostRouter
Установить Codex
Установите инструмент или убедитесь, что текущая версия запускается корректно.
Установить Codex
npm install -g @openai/codex
codex --versionСкопируйте одну команду и проверьте подключение
Команда задаёт 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"'Сохранение настроек
Сохраните адрес провайдера и 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-ключ для каждого инструмента.
- Выберите доступную модель в каталоге.
- Перезапустите инструмент и проверьте запрос в журнале.
Claude Code
Настройки для подключения к CostRouter
Настроить
Claude Code
Настройки для подключения к CostRouter
Установить Claude Code
Установите инструмент или убедитесь, что текущая версия запускается корректно.
Установить Claude Code
npm install -g @anthropic-ai/claude-code
claude --versionСкопируйте одну команду и проверьте подключение
Выполните команду целиком. Она задаст Base URL и API-ключ в текущем сеансе терминала, не меняя файлы конфигурации. После закрытия терминала значения сбросятся.
Текущий терминал (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-ключ для каждого инструмента.
- Выберите доступную модель в каталоге.
- Перезапустите инструмент и проверьте запрос в журнале.
Gemini CLI
Настройки для подключения к CostRouter
Настроить
Gemini CLI
Настройки для подключения к CostRouter
Установить Gemini CLI
Установите инструмент или убедитесь, что текущая версия запускается корректно.
Установить Gemini CLI
npm install -g @google/gemini-cli
gemini --versionСкопируйте одну команду и проверьте подключение
Выполните команду целиком. Она задаст 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Сохранение настроек
Сохраните значения в файле конфигурации инструмента, чтобы они применялись и после перезапуска.
~/.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
Настройки для подключения к CostRouter
Настроить
Cursor
Настройки для подключения к CostRouter
Установить Cursor
Установите инструмент или убедитесь, что текущая версия запускается корректно.
Установить Cursor
cursor .Скопируйте одну команду и проверьте подключение
Переменные передаются только текущему экземпляру Cursor и процессам проекта. Возможность настроить встроенного агента зависит от версии Cursor.
Текущий терминал (zsh / bash)
export OPENAI_API_KEY="YOUR_COSTROUTER_API_KEY" \
OPENAI_BASE_URL="https://costrouter.ai/v1" && \
cursor .Сохранение настроек
Сохраните значения в файле .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 один раз.
Продакшен
Перед запуском
Контролируйте доступ и расходы по мере роста трафика.
- Создавайте отдельный API-ключ для каждого приложения, окружения или агента.
- Настройте лимит, срок действия, доступные модели и список разрешённых IP-адресов.
- Проверяйте журнал запросов после настройки и смены модели.
- Загружайте секреты из окружения или менеджера секретов.