Claude Code Router: установка и безопасная настройка в 2026

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

Что именно устанавливается

CCR не является продуктом Anthropic. Исходный код, установочные пакеты и документация находятся в репозитории musistudio/claude-code-router. Проект принимает запросы локально, выбирает настроенного провайдера и передаёт ответ обратно Claude Code.

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

Правило выбора: не ставьте роутер ради абстрактной экономии. Сначала назовите модель, провайдера и тип задач, которые должны идти по отдельному маршруту.

Что подготовить до запуска

Нужны работающий Claude Code, учётная запись выбранного поставщика моделей и отдельный ключ для его API, если провайдер требует ключ. Для npm-варианта текущая документация CCR указывает Node.js 22 или новее. У проекта также есть настольное приложение и Docker-вариант, а способы установки различаются по управлению и хранению конфигурации. Сверяйте их по официальной инструкции CCR.

• Настольное приложение CCR подходит для ежедневной работы на одном компьютере и управления через интерфейс.
• npm CLI подходит для терминала, SSH и запуска под системным менеджером процессов.
• Docker подходит для постоянного сервера, но требует отдельной защиты сети, данных и резервных копий.
• Без ясного требования к маршрутизации используйте Claude Code напрямую.

Если главная задача состоит только в выборе модели внутри Claude Code, сначала проверьте доступные варианты по разбору моделей Claude Code. Роутер оправдан, когда нужен другой совместимый API или явное правило выбора провайдера.

Как установить npm-версию и открыть управление

Ниже минимальный путь для macOS, Linux или Windows с настроенным Node.js. Команды устанавливают пакет проекта и открывают локальный интерфейс. Не вставляйте ключ провайдера в командную строку: он попадёт в историю оболочки.

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

В актуальной документации CCR интерфейс управления для npm-варианта по умолчанию использует локальный адрес с портом 3458, а шлюз моделей локальный адрес с портом 3456. Это разные поверхности. Доступный интерфейс ещё не доказывает, что шлюз готов принимать модельные запросы.

1. Откройте интерфейс, который напечатала команда ccr ui, и убедитесь, что адрес начинается с 127.0.0.1.
2. Добавьте одного провайдера и только одну модель для первой проверки.
3. Создайте отдельный клиентский ключ CCR. Не путайте его с ключом внешнего провайдера.
4. Запустите Server в интерфейсе и проверьте состояние Running.
5. Включите один профиль или активируйте переменные только в текущем окне терминала.
6. Запустите безопасную тестовую задачу в отдельной папке без секретов и проверьте запись в Logs.

По теме: Claude overloaded: что значит ошибка и как восстановить работу

Как подключить Claude Code к локальному шлюзу

CCR запускает настроенный профиль сам. В актуальном CCR 3.x включённый профиль Claude Code запускайте из интерфейса Agent Config либо командой ccr <profile-name-or-id> cli; этот путь применим в Bash, Zsh, CMD и PowerShell. Старый способ с выводом переменных окружения и eval в текущей документации отсутствует, поэтому здесь его не используйте. Выполняйте запуск профиля в отдельном окне терминала, чтобы легко вернуться к прямому подключению.

ccr start
ccr "<profile-name-or-id>" cli
claude

Claude Code официально поддерживает ANTHROPIC_BASE_URL для направления запросов через прокси или шлюз. На стороннем адресе поиск MCP-инструментов отключается по умолчанию, если шлюз не передаёт нужные блоки. Это ограничение описано в справочнике переменных Claude Code. Не включайте функции наугад, сначала проверьте совместимость своего провайдера.

Anthropic отдельно документирует подключение корпоративного LLM-шлюза и предупреждает, что пользователь отвечает за совместимость, аутентификацию и доступность такого слоя. Схема переменных и моделей есть в официальном руководстве Anthropic по LLM gateway.

Как проверить, что маршрут действительно работает

Проверка должна подтвердить весь путь, а не только открытие интерфейса. Используйте пустой тестовый каталог и задачу без конфиденциальных файлов. Сначала проверьте процесс и здоровье шлюза, затем один ответ модели, после этого запись о выбранном провайдере в Logs.

• Команда ccr --help выполняется и показывает установленный клиент.
• Server имеет состояние Running.
• Запрос к /health на адресе шлюза отвечает успешно после настройки провайдера.
• В Logs видны запрошенная и фактически выбранная модель, провайдер и успешный статус.
• Claude Code отвечает в тестовой папке, а после закрытия временной оболочки возвращается к прежнему способу подключения.

Для первого теста попросите агента прочитать один безобидный текстовый файл и вернуть его имя, не разрешая запись. Затем переходите к рабочему проекту и настройте права по руководству по Claude Code permissions.

По теме: Claude Code environment variables: настройка переменных в 2026

Диагностика по симптому

Если UI открывается, а модель не отвечает, проверьте по порядку: запущен ли шлюз, есть ли выбранная модель, создан ли клиентский ключ CCR, совпадает ли протокол провайдера, затем посмотрите сообщение в Logs. Не заменяйте несколько настроек одновременно, иначе причина останется неизвестной.

• 404 или отказ соединения: проверьте, что используете порт шлюза, а не порт интерфейса управления.
• 401 или 403: проверьте тип ключа и заголовок, но не печатайте значение ключа в чат или журнал.
• Модель не найдена: скопируйте точный идентификатор из кабинета провайдера и сохраните его в списке моделей CCR.
• Ответ без инструментов: провайдер или преобразователь может не поддерживать формат Claude Code.
• После перезапуска вернулось прямое подключение: активация была временной, запустите профиль CCR или настройте контролируемый постоянный запуск.

Ограничения и безопасный выход

Каждый дополнительный шлюз получает доступ к передаваемому контексту. Не отправляйте через неизвестный сервис исходники с ключами, персональными данными или закрытой логикой. Держите интерфейс на 127.0.0.1, если удалённый доступ не является осознанной задачей. Полный адрес управления может содержать токен, поэтому относитесь к нему как к паролю.

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

Частые вопросы о Claude Code Router

Claude Code Router официальный?

Нет. Это сторонний проект с открытым исходным кодом. Официальным остаётся Claude Code от Anthropic.

Можно ли использовать CCR без ключа провайдера?

Это зависит от выбранного провайдера и его способа авторизации. Не копируйте чужие токены и не объединяйте личные подписки нескольких людей.

Почему интерфейс работает, а шлюз отвечает ошибкой?

Интерфейс и модельный шлюз используют разные локальные адреса. Кроме того, шлюз без провайдера, модели и клиентского ключа ещё не готов к запросам.

Когда CCR не подходит?

Когда вам нужен только официальный Claude Code, нет времени обслуживать ещё один процесс или правила компании запрещают передачу кода стороннему провайдеру.