Claude Code Router: запуск Claude Code с другими моделями и случаи, когда проще использовать шлюз

Что делает Claude Code Router

Claude Code Router от musistudio, часто сокращаемый до CCR, описывает себя как «локальный шлюз моделей и уровень управления для агентов программирования». Он предоставляет стабильную локальную конечную точку для Claude Code и других клиентов, а также учётные данные провайдеров, правила маршрутизации, повторные попытки, упорядоченные резервные варианты и журналы запросов.

В v3.1.1 README указывает поддержку форматов OpenAI Chat и Responses, Anthropic Messages, а также Gemini Generate Content и Interactions. Именно адаптация протоколов позволяет запускать Claude Code с другими моделями через CCR.

CCR распространяется по лицензии MIT с указанием авторских прав musistudio за 2025 год и предоставляется «КАК ЕСТЬ». Разрешение на использование ПО не делает выполнение запросов к моделям у провайдеров бесплатным. Тарифы и лимиты провайдеров остаются отдельными условиями; прежние цены провайдеров и лимиты OpenCode Go в долларах не проверены на дату этой публикации.

Рассматриваемый выпуск Claude Code Router 3.1

Версия 3.1.1 выпущена 16 сентября 2026 года. В ней добавлена полноценная поддержка локального импорта OpenCode Go, отображаются отдельные неудачные попытки обращения к шлюзу и исправлен расчёт стоимости использования моделей, выбираемых маршрутизацией.

В этом выпуске также поддерживается --daemon для start и serve, исправлен обработчик тела журнала в интерфейсе Docker, а также доступны сборки для macOS на Apple Silicon и Intel, установщик для Windows и AppImage для Linux. Для описанной ниже настройки используются дистрибутив npm и документация, закреплённая за v3.1.1.

Установите CCR и подключите Claude Code

Для дистрибутива npm требуется Node.js 22 или новее. Руководство по CLI для закреплённой версии описывает следующие команды:

npm install -g @musistudio/claude-code-router
ccr --help
ccr ui

Для запуска без открытия браузера:

ccr ui --no-open

У интерфейса управления и шлюза моделей разные адреса по умолчанию:

Чёткое понимание этих ролей помогает определить, на каком этапе произошёл сбой подключения. Работающая страница управления сама по себе не подтверждает, что шлюз моделей принял свою конфигурацию.

Добавьте провайдера и клиентский ключ

Откройте Провайдеры → Добавить провайдера, выберите предустановленный вариант или Другая / пользовательская конечная точка APIи введите адрес конечной точки и ключ API. CCR определяет протоколы и модели; Расширенные настройки позволяют выбрать протокол вручную.

Используйте Проверить подключение для проверки провайдера. При этом отправляется реальный запрос, поэтому могут расходоваться токены или часть лимита запросов провайдера.

Создайте клиентский ключ CCR для Ключи API для запросов к моделям. Этот ключ отличается от токена интерфейса управления/RPC: рассматривайте клиентский доступ и доступ к управлению как отдельные параметры настройки.

Создайте профиль Claude Code

В разделе Настройка агентовсоздайте включённый профиль для Claude Code, выберите модель, например Provider/model, и сохраните его. Для профиля с именем «Claude Code - Work» выполните запуск командой:

ccr "Claude Code - Work"

Команды запуска, созданные настольным приложением, используют ccr-app. Руководство по профилям Claude Code различает две области применения:

• Только при запуске из CCR применяет конфигурацию при запуске через CCR.
• По умолчанию в системе также влияет на прямой запуск Claude Code.

Профили поддерживают переопределения для Fable, Opus, Sonnet и Haiku. Проверьте активный выбор с помощью /model, затем просмотрите в CCR Журналы запросов , чтобы увидеть запросы, проходящие через шлюз. Держите руководстве по моделям Claude Code под рукой, когда планируете этот выбор.

Настройте маршрутизацию, повторные попытки и резервные варианты

Правила маршрутизации CCR могут анализировать request.header и request.bodyи перезаписывать request.body.model. Это позволяет управлять выбором модели на основе входящего запроса, помимо модели, выбранной в профиле агента.

В настройке резервных вариантов используется mode, modelsи retryCount. Доступны три режима: off, retryи model-chain.

Различие между условиями повторной попытки и перехода к резервной модели имеет значение. Ответ, не допускающий повторной попытки, всё же может допускать переход к резервной модели.

Проверьте, какая модель фактически обработала запрос

Цепочка моделей может изменить модель, которая в итоге обработает запрос. Журналы CCR показывают конечного провайдера и модель, поэтому используйте их для проверки неожиданного поведения или расхода ресурсов.

Начните с профиля, для которого вы можете определить провайдера и модель. Добавляйте правила маршрутизации и резервные модели осознанно, затем проверяйте конечную точку назначения после проверки их работы. Так проще связать изменения в ответах или характере затрат с настройками маршрутизации.

Версия 3.1.1 также отображает отдельные неудачные попытки обращения к шлюзу. Эти записи помогают отличить успешный итоговый ответ от предшествовавших ему попыток.

Используйте импорт OpenCode Go в v3.1.1

В выпуске musistudio Claude Code Router v3.1.1 добавлена полноценная поддержка локального импорта OpenCode Go. Интеграция разделяет Zen, обозначенный как opencode, и Go, обозначенный как opencode-go, включая их учётные данные и пересекающиеся идентификаторы моделей.

Средство импорта считывает конфигурацию OpenCode, auth.jsonи кешированные метаданные моделей. OPENCODE_API_KEY применяется к обоим сервисам; OPENCODE_GO_API_KEY задаёт переопределение специально для Go. При обнаружении модели фильтруются по протоколу, а кэшированные метаданные сверяются с актуальными результатами /models .

Почему важен заголовок сессии

В PR интеграции OpenCode Go указывает, что запросы к https://opencode.ai/zen/go/v1 требуют x-opencode-session. Без него конечная точка возвращает 400 MissingSessionID.

CCR выбирает значение сессии в следующем порядке: явно заданная конфигурация, явно заданный заголовок клиента, заголовки сессии Claude, metadata.user_id, и наконец стабильное резервное значение для процесса. Заголовок добавляется только для официальной конечной точки Go.

Это объясняет, почему для Go может быть недостаточно указать только конечную точку и учётные данные. Требование к сессии — часть интеграции с провайдером.

Обновление списка моделей и просмотр лимитов использования

Если импорт Go недоступен, подключите OpenCode Go в OpenCode, обновите локальный кэш моделей и повторите сканирование в CCR.

CCR получает данные об использовании из GET https://opencode.ai/zen/go/v1/usage и показывает оставшуюся долю лимита в процентах для пятичасового, недельного и месячного периодов. В закреплённой документации не указаны лимиты в долларах. Эти значения следует понимать как оставшуюся долю лимита для указанных периодов; они не определяют денежный баланс.

Поэтапная диагностика подключения

Материалы CCR по устранению неполадок охватывают обход маршрутизации, ошибки аутентификации, отсутствующие модели, неожиданный выбор модели, скачки расходов, тайм-ауты и отсутствующие трассировки агентов. Полезно последовательно проследить путь запроса от конфигурации запуска до конечного провайдера.

Claude Code обходит CCR

Убедитесь, что нужный профиль Agent Config включён и запуск выполнен через него. Если для профиля задано Только при запуске из CCR , его конфигурация применяется только к запускам через CCR; на прямые запуски она влияет, когда выбрано По умолчанию в системе .

Используйте /model и журналы запросов CCR вместе, чтобы проверить настройку. справочнике CLI Claude Code содержит более подробную справочную информацию о работе с клиентом.

Ошибки аутентификации или отсутствующие модели

При ошибках 401/403 проверьте учётные данные на каждом соответствующем уровне: API-ключ провайдера, клиентский ключ CCR для запросов к моделям и отдельный токен управления. Эти учётные данные выполняют разные функции.

При model not foundпроверьте обнаруженные модели, выбранный протокол и выбор провайдера и модели в профиле. Если используется OpenCode Go и импорт недоступен, обновите локальный кэш и повторите сканирование.

Ошибки запуска и тайм-ауты

Версия 3.1.1 увеличивает время ожидания принятия конфигурации шлюзом с пяти до 30 секунд. Это устраняет ситуации, когда интерфейс управления запускается, но шлюз не запускается из-за нагрузки на хост, особенно в Windows.

CCR_GATEWAY_CONFIG_TIMEOUT_MS переопределяет тайм-аут. При недопустимых значениях или значениях меньше 1,000 миллисекунд используется значение по умолчанию.

Конфигурация хранится в ~/.claude-code-router на macOS/Linux и в %APPDATA%\claude-code-router на Windows. К соответствующим файлам относятся config.sqlite, сгенерированный gateway.config.jsonи service.json. Команды сервиса включают ccr start, ccr stop, а для запуска на переднем плане — ccr serve.

Когда облачный шлюз проще

CCR подходит для рабочих процессов, которым нужны локальное управление провайдерами, маршрутизация на основе запросов, пулы учётных данных или явно заданные цепочки резервных вариантов. Облачный шлюз может сократить число шагов локальной настройки, если ваша ближайшая цель — подключить Claude Code к вышестоящему сервису.

В объявлении OpenRouter от 4 августа 2026 года описаны следующие настройки подключения:

ANTHROPIC_BASE_URL=https://openrouter.ai/api
ANTHROPIC_AUTH_TOKEN=<openrouter-api-key>
ANTHROPIC_API_KEY=

В объявлении также указаны дополнительные настройки моделей и функций. Эти три переменные задают параметры подключения, а не полную конфигурацию для любой модели. OpenRouter предупреждает, что большинство открытых моделей не поддерживают поиск инструментов, поэтому настройки различаются в зависимости от модели.

Его Ori CLI автоматизирует настройку с помощью:

ori login
ori claude

Те же рабочие процессы можно выполнять через API-шлюз, например AI Prime Tech — независимый сервис, не связанный с Anthropic или OpenAI; см. руководство по использование Claude Code с ключом API.

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

Основные выводы

• Claude Code Router подключает Claude Code и другие клиенты к провайдерам через стабильную локальную конечную точку с адаптацией протоколов.
• Для дистрибутива npm требуется Node.js 22+, а интерфейс управления и шлюз моделей по умолчанию используют разные порты.
• Область действия Agent Config определяет, применяется ли профиль только к запускам через CCR или также к прямым запускам.
• Резервные варианты могут изменить модель, обслуживающую запрос; проверяйте конечного провайдера и модель в журналах запросов.
• В v3.1.1 добавлен импорт OpenCode Go с отдельными учётными данными и обработкой обязательного заголовка сессии.
• Облачный шлюз может упростить локальную настройку, если вам не нужны локальные средства управления маршрутизацией CCR.

Частые вопросы

Бесплатен ли Claude Code Router?

Claude Code Router распространяется по лицензии MIT, которая разрешает использование программного обеспечения. Это не означает, что выполнение запросов у вышестоящих провайдеров бесплатно; прежние цены провайдеров и лимиты OpenCode Go в долларах здесь не проверяются.

Можно ли использовать Claude Code с другими моделями через CCR?

Да. CCR обеспечивает адаптацию протоколов и выбор провайдера и модели, а его профили Claude Code позволяют выбрать модель, например Provider/model. Поддерживаемые форматы вышестоящих сервисов включают OpenAI Chat/Responses, Anthropic Messages и Gemini Generate Content/Interactions.

Что изменилось в Claude Code Router 3.1.1?

Версия v3.1.1, выпущенная 16 сентября 2026 года, добавляет полноценный локальный импорт OpenCode Go, отображение отдельных неудачных попыток и исправленный расчёт стоимости использования моделей, выбранных маршрутизацией. Она также увеличивает время ожидания принятия конфигурации шлюзом до 30 секунд и поддерживает --daemon для start и serve.

Почему OpenCode Go возвращает MissingSessionID?

Официальная конечная точка OpenCode Go требует заголовок x-opencode-session и возвращает 400 MissingSessionID при его отсутствии. Интеграция Go в CCR выбирает значение сессии в установленном порядке приоритетов и добавляет заголовок только для официальной конечной точки Go.