Интеграция

Кодинг-агенты

BasicRouter работает с кодинг-агентами и инструментами AI-разработки, которые поддерживают OpenAI-совместимые или Anthropic-совместимые конечные точки API. Используйте псевдонимы маршрутизации, такие как mwf/coding-auto, чтобы BasicRouter мог маршрутизировать запросы к лучшей доступной кодинг-модели без необходимости разработчикам менять конфигурацию инструмента.

Универсальная настройка, совместимая с OpenAI

Используйте эту настройку для Cursor, Codex, Hermes, OpenClaw, Continue, Aider, Cline, агентов на базе LangChain, агентов на базе LlamaIndex и пользовательских OpenAI-совместимых сред выполнения агентов.

export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"

Универсальная настройка, совместимая с Anthropic

Используйте эту настройку для клиентов, совместимых с Claude, и инструментов, ожидающих формат Anthropic Messages.

export ANTHROPIC_BASE_URL="https://api.basicrouter.ai/api/anthropic"
export ANTHROPIC_API_KEY="$BASICROUTER_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"

Сценарий использования	Рекомендуемый псевдоним	Требования
Общее программирование	`mwf/coding-auto`	Вызов инструментов, потоковая передача, сильные способности к программированию.
Быстрый кодинг-чат	`mwf/coding-fast`	Низкая задержка и потоковая передача.
Анализ больших репозиториев	`mwf/coding-long`	Длинный контекст и стабильный вывод.
Помощник в программировании с ограниченным бюджетом	`mwf/low-cost`	Более низкая цена и приемлемое качество кодинга.
Скриншоты UI / визуальный кодинг	`mwf/vision-chat`	Ввод изображений и текстовый вывод.

Краткое руководство по Cursor

Используйте конечную точку, совместимую с OpenAI.

Base URL: https://api.basicrouter.ai/api/v1
API Key:  BASICROUTER_API_KEY
Model:    mwf/coding-auto

Рекомендуемые шаги:

Откройте настройки Cursor.
Добавьте или включите конфигурацию OpenAI-совместимого API-ключа.
Установите переопределение базового URL OpenAI на https://api.basicrouter.ai/api/v1.
Добавьте пользовательскую модель, например mwf/coding-auto, mwf/coding-fast или mwf/coding-long.
Используйте модель с поддержкой потоковой передачи и вызова инструментов для наилучшего поведения агента.

Устранение неполадок:

Проблема	Рекомендованное решение
Модель не отображается	Добавьте имя модели вручную как пользовательскую модель.
Сбой вызова инструментов	Используйте модель с `tool_calling: true` на странице «Модели».
Потоковая передача прервана	Повторите с экспоненциальной задержкой или используйте псевдоним маршрутизации с резервом.
Ошибка 401	Проверьте API-ключ и базовый URL.
Ошибка модели 404	Убедитесь, что модель включена для аккаунта.

Краткое руководство по Claude Code

Используйте Anthropic-совместимую конечную точку шлюза.

export ANTHROPIC_BASE_URL="https://api.basicrouter.ai/api/anthropic"
export ANTHROPIC_API_KEY="$BASICROUTER_API_KEY"
export ANTHROPIC_MODEL="mwf/coding-auto"

BasicRouter поддерживает этот Anthropic-совместимый путь для совместимости с Claude Code и Anthropic SDK:

POST /api/v1/messages

Рекомендуемые требования:

Требование	Причина
Формат запроса, совместимый с Anthropic Messages	Claude Code ожидает сообщения в стиле Anthropic.
Поддержка потоковой передачи	Claude Code полагается на UX потоковой передачи.
Поддержка вызова инструментов	Требуется для агентных кодинг-рабочих процессов.
Длинный контекст	Полезно для задач на уровне репозитория.
Стабильный резерв	Полезно для длительных кодинг-сессий.

Краткое руководство по Codex

Используйте BasicRouter как пользовательского OpenAI-совместимого провайдера моделей.

Пример конфигурации провайдера:

[model_providers.basicrouter]
name = "BasicRouter"
base_url = "https://api.basicrouter.ai/api/v1"
env_key = "BASICROUTER_API_KEY"
wire_api = "responses"

model_provider = "basicrouter"
model = "mwf/coding-auto"

Переменная окружения:

export BASICROUTER_API_KEY="br_xxx"

Рекомендуемые модели:

Модель	Сценарий использования
`mwf/coding-auto`	Модель кодинг-агента по умолчанию.
`mwf/coding-long`	Контекст больших репозиториев.
`mwf/coding-fast`	Быстрая итерация и небольшие изменения.

Устранение неполадок:

Проблема	Рекомендованное решение
Ошибка авторизации	Убедитесь, что `env_key` указывает на `BASICROUTER_API_KEY`.
Модель не найдена	Добавьте псевдоним в консоли BasicRouter или используйте прямой ID модели.
Ошибка Responses API	Используйте `wire_api = "responses"` только для моделей и конечных точек, поддерживающих Responses.
Модель только для Chat Completions	Переключитесь на wire API, совместимый с чатом, если клиент поддерживает это.

Краткое руководство по Hermes

Используйте OpenAI-совместимую конечную точку, если только ваше развертывание Hermes не настроено для другого протокола.

export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"

Рекомендуемая политика моделей:

Рабочая нагрузка Hermes	Модель
Общая генерация кода	`mwf/coding-auto`
Выполнение задач с низкой задержкой	`mwf/coding-fast`
Сканирование репозитория с длинным контекстом	`mwf/coding-long`
Фоновые задачи с ограниченным бюджетом	`mwf/low-cost`

Краткое руководство по OpenClaw

Используйте OpenAI-совместимую конечную точку для конфигурации среды выполнения агента в стиле OpenAI.

export OPENAI_BASE_URL="https://api.basicrouter.ai/api/v1"
export OPENAI_API_KEY="$BASICROUTER_API_KEY"
export OPENAI_MODEL="mwf/coding-auto"

Если OpenClaw поддерживает нескольких провайдеров, настройте BasicRouter как OpenAI-совместимого провайдера и используйте псевдонимы маршрутизации BasicRouter для выбора модели.

{
  "provider": "openai-compatible",
  "base_url": "https://api.basicrouter.ai/api/v1",
  "api_key_env": "BASICROUTER_API_KEY",
  "model": "mwf/coding-auto"
}

Контрольный список совместимости агента

Возможность	Требуется для
Потоковая передача	Хороший UX в терминале/редакторе.
Вызов инструментов	Агентный кодинг, редактирование файлов, выполнение команд.
Длинный контекст	Большие репозитории и многофайловые изменения.
Структурированные выводы	Планирование, декомпозиция задач, автоматизированные рабочие процессы.
Ввод изображений	Анализ скриншотов UI и рабочие процессы «дизайн в код».
Резерв	Стабильность в продакшене и длительные задачи.