Claude Code Router: нужен ли он, если шлюз понимает Anthropic-формат

Claude Code Router появился ради простой цели: заставить Claude Code работать с моделями, которые не умеют формат Anthropic. Если вы ищете «claude code router», скорее всего, хотите запустить Claude Code на Qwen, GLM или DeepSeek. Часто для этого роутер не нужен: шлюз Zukko принимает Anthropic-формат для любых своих моделей. Ниже разбираем, что делает роутер сейчас, как обойтись без него и когда он всё же полезен.

Описание роутера сверено с README проекта musistudio/claude-code-router (версия 3.1.3 на момент проверки), поведение Claude Code — с официальной документацией на 18 октября 2026. Цены Zukko даны на ту же дату.

Что такое Claude Code Router сегодня

Раньше роутер был небольшой утилитой с конфигурационным файлом. По README, сегодня это локальный шлюз и панель управления для агентов: одно приложение, у которого Claude Code, Codex, OpenCode, Kilo Code и другие агенты берут единый локальный адрес, а провайдеры, модели и правила маршрутизации настраиваются в одном месте. Установка двумя способами: десктопное приложение или npm-пакет (нужен Node.js 22 или новее):

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

Дальше по README порядок такой: в разделе Providers добавляете провайдера (пресет или свой адрес), выбираете протокол и модели; в разделе Server запускаете локальный шлюз (по умолчанию http://127.0.0.1:3456); в разделе Agent Config выбираете Claude Code, нужную модель и применяете профиль. Веб-интерфейс из ccr ui открывается на http://127.0.0.1:3458.

Предупреждение: в интернете много инструкций по старому роутеру с ручным редактированием конфигурационного файла. Названия разделов и ключей в них могут не совпадать с текущей версией, поэтому опирайтесь на README и документацию проекта.

Что роутер даёт по описанию проекта: маршрутизацию по условиям (заголовки и тело запроса), повторы и список запасных моделей, пулы ключей, журнал запросов с токенами и оценкой стоимости, отдельные клиентские ключи с локальными лимитами.

Claude Code Router нужен, если провайдер не понимает Anthropic-формат

Claude Code говорит на формате Anthropic (/v1/messages). Многие поставщики моделей отдают только OpenAI-формат (/v1/chat/completions). Между ними нужен переводчик, и роутер как раз такой. Если ваш шлюз уже принимает Anthropic-формат для всех моделей, переводчик не нужен.

В Zukko любую модель можно вызывать в любом формате. Поэтому Claude Code направляется на шлюз напрямую:

export ANTHROPIC_BASE_URL=https://api.zukko.pro
export ANTHROPIC_AUTH_TOKEN=fetch_ваш_ключ
export ANTHROPIC_MODEL=glm-5.3-flash
claude

Адрес без /v1, потому что Claude Code добавляет путь сам. Ключ передаётся через ANTHROPIC_AUTH_TOKEN. Подробности — в инструкции по Claude Code↗ и в сравнении форматов Anthropic или OpenAI↗.

Claude Code и Qwen API

Для «claude code qwen api» меняется только имя модели. В каталоге есть qwen3.8-max (вход 0.088, выход 0.238 доллара за 1M токенов, контекст 1M, картинки на вход поддерживаются, индекс силы 45) и дешёвая qwen3.8-flash (0.038 / 0.075, контекст 1M, индекс 40):

export ANTHROPIC_MODEL=qwen3.8-max
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4.1-flash

Claude Code использует не одну модель, а несколько слотов. По документации Claude Code это ANTHROPIC_MODEL (модель сессии), а также ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL и ANTHROPIC_DEFAULT_HAIKU_MODEL (псевдонимы и фоновые задачи). Переключаться между моделями во время работы можно командой /model. Эти же переменные можно положить в блок env файла ~/.claude/settings.json. Про выбор по слотам: какую модель выбрать для Claude Code↗.

Две оговорки

Поддержка. В документации Claude Code о шлюзах прямо сказано, что Anthropic не поддерживает маршрутизацию Claude Code на модели, отличные от Claude, через какие-либо шлюзы. Технически это работает, но поведение инструментов и качество проверяйте на своих задачах. Мы не утверждаем, что другая модель справится с агентной работой так же.

Окно контекста. Для id, которые не начинаются с claude-, Claude Code не знает реального окна контекста. По документации, для незнакомого id он предполагает окно 200K, предупреждает об этом при запуске и сжимает историю по этой границе. Для GLM с окном 128K укажите реальный размер в переменной окружения:

export CLAUDE_CODE_MAX_CONTEXT_TOKENS=128000

Для моделей Zukko с окном 1M (Qwen, DeepSeek, большинство остальных) задайте значение 1000000, иначе история будет сжиматься уже на 200K.

Claude Code OpenRouter и другие агрегаторы

Запрос «claude code openrouter» ищут те, кто уже работает через агрегатор. Принцип у всех одинаков: Claude Code нужен Anthropic-совместимый адрес и токен, а какие модели доступны и как они тарифицируются, определяет сервис. Детали OpenRouter берите из его документации. Сравнение подходов — в статье Zukko против OpenRouter↗.

Когда роутер всё же полезен

Если одной переменной не хватает, роутер оправдан. Типичные случаи:

• нужны правила: длинный контекст на одну модель, фоновые задачи на дешёвую, и всё это автоматически;
• нужен список запасных моделей на случай ошибок поставщика;
• вы одновременно используете несколько агентов (Claude Code, Codex, OpenCode) и хотите один локальный адрес;
• нужен локальный журнал с токенами и оценкой стоимости;
• у провайдера только OpenAI-формат.

Без роутера вы получаете меньше движущихся частей: нет локального процесса, который нужно держать запущенным, и нет второго места, где ломается конфигурация. Часть задач закрывают сами ключи Zukko: у каждого свои дневной и месячный лимит в долларах, список разрешённых моделей (allowed_models), а история расходов видна в кабинете, раздел «Использование».

Роутер и Zukko вместе

Если вы всё же ставите роутер, шлюз Zukko подключается к нему как обычный провайдер. Протокол выбирайте так:

• OpenAI Chat с адресом https://api.zukko.pro/v1 подходит для всех моделей, но Claude в OpenAI-формате не получает скидку за кэш;
• Anthropic Messages сохраняет кэш для Claude; адрес указывайте по правилу для клиентов, которые добавляют /v1 сами, то есть https://api.zukko.pro. Если проверка подключения в роутере вернёт 404, проверьте этот суффикс по документации проекта.

Чем это грозит по деньгам, видно на примере. Цены на 18 октября 2026: claude-sonnet-5-5 стоит 0.4 за вход, 2 за выход, 0.05 за чтение кэша и 0.5 за запись, доллары за 1M токенов. Сессия: 300K свежих токенов входа, 2M прочитано из кэша, 100K записано в кэш, 40K токенов выхода.

• Anthropic-формат: 0.3 × 0.4 + 2 × 0.05 + 0.1 × 0.5 + 0.04 × 2 = 0.12 + 0.10 + 0.05 + 0.08 = $0.35;
• OpenAI-формат (весь вход по цене входа): (0.3 + 2 + 0.1) × 0.4 + 0.04 × 2 = 0.96 + 0.08 = $1.04.

Доли кэша зависят от вашей сессии. Для сравнения, тот же объём (2.4M входа и 40K выхода) на glm-5.3-flash стоит 2.4 × 0.04 + 0.04 × 0.04 = $0.0976. Для GPT-моделей чтение кэша видно в обоих форматах.

Как выбрать

1. Нужен Claude Code на одной-двух моделях Zukko: задайте переменные окружения, роутер не нужен.
2. Нужны условия маршрутизации, запасные модели и общий журнал: ставьте роутер и подключайте Zukko как провайдера.
3. Работаете с Claude и важен кэш: Anthropic-формат напрямую или протокол Anthropic Messages в роутере.
4. В любом случае проверьте модель на своих задачах и заведите отдельный ключ с дневным лимитом.

Для Claude Code на любой из моделей нужен один ключ fetch_... из кабинета↗. Баланс пополняется через СБП (платёжная страница добавляет 8,5% сверху), картой MasterCard или криптой.

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

Нужен ли claude-code-router, чтобы запустить Claude Code на GLM или Qwen через Zukko?

Нет. Шлюз принимает Anthropic-формат для любых моделей: достаточно ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN и нужного id в ANTHROPIC_MODEL.

Что произойдёт, если указать адрес с /v1 для Claude Code?

Claude Code сам добавляет путь, и запросы пойдут на /v1/v1/messages с ошибкой 404. Для Claude Code и Anthropic SDK адрес https://api.zukko.pro без /v1.

Будут ли другие модели работать в Claude Code так же хорошо, как Claude?

Неизвестно заранее. Anthropic такую схему не поддерживает, а модели по-разному вызывают инструменты. Проверьте на реальной задаче и сравните стоимость.

Какие модели можно подставлять?

Любую из GET https://api.zukko.pro/v1/models: например claude-sonnet-5-5, claude-opus-5-5, gpt-6.1-sol, qwen3.8-max, glm-5.3-flash, deepseek-v4.1-flash.