routatic-proxy CLI
Локальный CLI-прокси для Claude Code: переводит запросы между API поставщиков и выбирает модель по правилам маршрутизации
- 979 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Прокси обрабатывает код и сообщения клиента вместе с учетными данными API
- Резервные маршруты могут направлять контекст другим поставщикам и расходовать их оплачиваемый доступ
Установка
- Работает в
Ручная установка
brew tap routatic/tap
brew install routatic-proxyУстановка для macOS и Linux. После нее создайте конфигурацию через `routatic-proxy init`; доступ к API поставщиков настраивается отдельно.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Прокси обрабатывает код и сообщения клиента вместе с учетными данными API
- Резервные маршруты могут направлять контекст другим поставщикам и расходовать их оплачиваемый доступ
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
routatic-proxy принимает запросы Claude Code и передает их настроенному поставщику моделей. Он преобразует формат сообщений и вызовов инструментов между поддерживаемыми API. Интерфейсом остается Claude Code, а отвечает модель выбранного сервиса. Вы задаете в конфигурации модели для разных запросов и порядок запасных подключений. Если основной вызов не удался, прокси может обратиться к следующему варианту. Правила можно менять без постоянного перезапуска службы. CLI запускает только прокси либо прокси с панелью состояния. Команды `validate` и `models` проверяют настройки и показывают каталог моделей. Можно использовать API OpenCode Go и OpenCode Zen. Для них, AWS Bedrock и OpenRouter нужны собственные учетные данные.
Для кого. Для разработчиков, которым нужно управлять несколькими модельными подключениями Claude Code через одну локальную конфигурацию.
Подходит, если
- Разные типы задач нужно направлять к заранее выбранным моделям
- Для доступного API нужна резервная цепочка на случай ошибки отдельного поставщика
- Нужно проверить настройки до запуска и увидеть состояние прокси в локальной панели
- Настройки поставщиков требуется менять в одном месте для нескольких рабочих запусков клиента
Не подходит, если
- Политика организации разрешает только прямое соединение клиента с одним поставщиком
- Нужны гарантированно одинаковые ответы и возможности инструментов у всех подключенных моделей
- У вас нет доступа к API выбранных поставщиков и вы ожидаете получить его вместе с программой
Пример запроса к агенту
Подготовь routatic-proxy для моих модельных API. Покажи конфигурацию маршрутов, проверь ее и оставь службу доступной только локально. Ключи введу самостоятельно.Ограничения
Для каждого провайдера нужны свои учетные данные и доступ к API; установка прокси не дает доступа к модели. Смена модели может изменить ответ и вызовы инструментов, а переключение после начала потока — повторить уже полученный текст. Прокси получает ключи и содержимое запросов; при смене маршрута тот же код может уйти другому оператору. Встроенный updater заменяет бинарник без подтверждения и проверки контрольной суммы; пакетную установку обновляйте средствами ее менеджера.
Как отключить. Выполните `routatic-proxy stop`, затем уберите адрес прокси из конфигурации Claude Code и восстановите нужное подключение клиента. Если включали автозапуск, отключите его отдельно. Пакет удаляйте своим менеджером установки.
Частые вопросы
Чем `start` отличается от `serve`?
Команда `routatic-proxy start` запускает также панель состояния. `routatic-proxy serve` поднимает только прокси. Обе команды могут работать в фоновом режиме.
Где слушают локальные службы?
Прокси по умолчанию использует `127.0.0.1:3456`, панель — `127.0.0.1:3445`. Адрес и порт прокси настраиваются. Панель появляется в режиме `start`.
Как направить Claude Code на локальный прокси?
После запуска прокси выполните `export ANTHROPIC_BASE_URL=http://127.0.0.1:3456` и `export ANTHROPIC_AUTH_TOKEN=unused` в терминале, где затем запустите `claude`. Это пример для стандартного локального порта. `unused` служит заполнителем; настоящий ключ поставщика настраивают в прокси.
Можно ли сохранить привычный выбор модели в клиенте?
Да. Настройка `respect_requested_model` позволяет учитывать имя, переданное Claude Code. Для конкретных имен есть `model_overrides`, которые связывают клиентский выбор с выбранным подключением.
Как обновлять установку через менеджер пакетов?
Используйте его штатное обновление, например `brew upgrade routatic-proxy`. Отдельный встроенный механизм обновления предназначен для самостоятельных бинарников. Для RPM и Docker предусмотрены свои способы обновления.
Можно ли открыть прокси другим машинам?
Только после настройки адреса прослушивания и проверки входящих запросов. Стандартный локальный адрес сам по себе не защищает удаленную конфигурацию. Лицензия кода AGPL-3.0.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальный шлюз для Claude Code, Codex, OpenCode и других агентов: выбор провайдера моделей, маршрутизация, резервные модели и логи
CCS
CCS - Claude Codex Switch
CLI для переключения Claude Code между аккаунтами, провайдерами и локальными моделями без правки конфигов
CLI brick запускает локальный маршрутизатор моделей перед Claude Code или Codex и отправляет каждый запрос на подходящую модель.
CLI на Go переключает профили Claude Code одной командой: настройки, CLAUDE.md и MCP-серверы меняются разом и с бэкапом.
Плагин Claude Code, который задает один вопрос сразу нескольким моделям и показывает их ответы рядом с разбором согласий и расхождений
CLI подключает сторонние модели к оркестрации Claude Code: воркфлоу, команды агентов и сабагенты на DeepSeek, GLM, Kimi, Qwen или подписке Codex
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| routatic-proxy (эта карточка) | нет | 979 | |
| CC Switch | нет | 152 294 | переключает настройки поставщиков в графическом интерфейсе; routatic-proxy сам обрабатывает запросы и резервные маршруты |
| LLMstudio | нет | 390 | CLI запускает прокси к языковым моделям и отдельный сервис учета запросов для отладки приложений на нескольких провайдерах. |
Коротко о README
Для старых установок сохранен псевдоним `oc-go-cc` и совместимость с прежними переменными окружения. Есть варианты поставки через Homebrew, Scoop и Docker. Графическая оболочка и фоновая служба используют тот же прокси.