model-relay — плагин
Плагин переключает модель отдельно для каждого окна Claude Code, отправляет субагентов к другим провайдерам и ловит лимит 429.
- 110 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Плагин пропускает весь трафик Claude Code через локальный процесс и правит `~/.claude/settings.json` после подтверждения.
- После переключения или автоперехода история диалога и код уходят стороннему провайдеру с другими условиями хранения данных.
- Ключи запасных провайдеров берутся из окружения процесса Claude Code.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/model-relayОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Плагин пропускает весь трафик Claude Code через локальный процесс и правит `~/.claude/settings.json` после подтверждения.
- После переключения или автоперехода история диалога и код уходят стороннему провайдеру с другими условиями хранения данных.
- Ключи запасных провайдеров берутся из окружения процесса Claude Code.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
`model-relay` запускает на `127.0.0.1:8950` легкий локальный маршрутизатор запросов Claude Code. Команда `/provider` открывает панель над строкой ввода: модель меняется только в текущем окне, остальные окна остаются на прежней. Субагента отправляют к другому провайдеру через `model-relay:<имя>`, а псевдоним `haiku` перенаправляют глобально командой `/provider alias haiku <имя>`. Когда Claude отвечает лимитом 429 или провайдер дает сбой, цепочка `failover.chain` передает запрос резервному провайдеру и закрепляет его только за этим окном. Режим локального HTTPS-прокси `/provider rc on` сохраняет работу Remote Control. Провайдер должен принимать формат Anthropic `/v1/messages`.
Для кого. Пользователям Claude Code с подпиской и запасными конечными точками: z.ai, DeepSeek, Kimi, MiniMax, OpenRouter или шлюзом на своем компьютере.
Подходит, если
- Одно окно терминала нужно перевести на другую модель, не трогая остальные.
- Лимит Claude кончился посреди задачи, и запрос уходит к запасному провайдеру.
- Субагент для поиска работает на дешевой модели, а основной чат остается на Opus.
- Нужен Remote Control вместе с пользовательским адресом API.
Не подходит, если
- Нужен общий прокси на всю организацию: README советует LiteLLM.
- Провайдер понимает только OpenAI Chat Completions, а локального переводчика нет.
- Сеть выпускает трафик лишь через корпоративный прокси: внешний прокси не поддерживается.
Пример запроса к агенту
Переключи это окно на резервного провайдера и проверь связь командой `/provider doctor --ping`.Ограничения
Нужны Node.js 20 или новее и Claude Code 2.1.287 или новее. Обновление с версии 0.6 и ранее требует переноса настроек в `~/.claude/model-relay.json` формата 2 и перезапуска маршрутизатора: одного обновления плагина мало. Возврат на Claude в середине сессии заново отправляет всю историю, потому что кеш промптов между провайдерами не переносится. Ключи запасных провайдеров читаются из окружения процесса Claude Code, а не из уже открытого шелла. Плагин рассчитан на одного пользователя на локальной машине.
Как отключить. Удалите плагин средствами Claude Code, остановите маршрутизатор и верните прежние значения в `~/.claude/settings.json`. Файл `~/.claude/model-relay.json` и ключи провайдеров очистите отдельно.
Частые вопросы
Как переключить только одно окно?
Введите `/provider` и выберите модель на панели над строкой ввода. Выбор действует в текущем окне, а новые окна стартуют с Claude.
Что происходит при лимите 429?
Если `failover.chain` задана, запрос уходит резервному провайдеру, и он закрепляется за окном. Пустая цепочка возвращает 429 как есть.
Сохранится ли Remote Control?
Да, для этого включают режим локального HTTPS-прокси командой `/provider rc on`. Пользовательский `ANTHROPIC_BASE_URL` сам по себе его ломает.
Подойдет ли провайдер с форматом OpenAI?
Только через локальный переводчик: провайдер должен принимать формат Anthropic `/v1/messages`. Переводчик можно запускать под присмотром поля `providers.<имя>.launch`.
Как проверить настройку?
Выполните `/provider doctor --ping`. Команда покажет `Config OK`, список провайдеров и результат пробного запроса к каждому из них.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныЛокальный шлюз для Claude Code, Codex, OpenCode и других агентов: выбор провайдера моделей, маршрутизация, резервные модели и логи
Clother переключает Claude Code между провайдерами одной командой: Z.AI, Kimi, DeepSeek, OpenRouter и локальные модели.
Хуки читают каждый запрос до модели и сначала просят черновик у бесплатной или локальной модели, чтобы беречь квоту Claude.
Плагин Claude Code, который задает один вопрос сразу нескольким моделям и показывает их ответы рядом с разбором согласий и расхождений
CLI router выбирает для задачи агента, модель и уровень усилий по остатку квот подписок и запускает его в панели Herdr.
Локальный шлюз для Claude Code: выбранные модели уходят к OpenAI, Kimi, DeepSeek, Gemini и другим, остальное идет в Anthropic
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| model-relay (эта карточка) | нет | 110 | |
| Claude Code Router | нет | 38 127 | общий маршрутизатор запросов Claude Code; `model-relay` меняет модель отдельно для каждого окна и ловит лимит 429 |
| CC Switch | нет | 153 939 | переключает конфигурации провайдеров приложением; `model-relay` работает как плагин внутри окна Claude Code |
Коротко о README
Плагин не использует внешний облачный прокси: маршрутизатор работает на localhost. Конфигурация лежит в `~/.claude/model-relay.json`, статус окна пишется в `model-relay-status/<id сессии>` для статусной строки.