Подключение QCode к 9router

Добавьте QCode.cc как кастомного провайдера в 9router — локальный мульти-провайдерный маршрутизатор — для межпровайдерного фолбэка и единого управления

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

9router — это локальный мульти-провайдерный прокси-маршрутизатор для ИИ: он поднимает на вашей машине OpenAI-совместимый сервис (по умолчанию http://localhost:20128/v1), перехватывает запросы от таких инструментов, как Claude Code, Cursor, Cline, Codex, и пересылает их к нескольким провайдерам моделей согласно вашим правилам (включая автоматический фолбэк / переключение при исчерпании квоты / сжатие вывода для экономии токенов и т. д.). Концептуально это похоже на собственный CCR от QCode — разница в том, что 9router работает на вашей собственной машине и управляется вами.

Конкретные функции, порты и интерфейс смотрите в официальном репозитории 9router; эта статья описывает только «как добавить QCode».

Когда это нужно¶

• Прямое подключение к QCode проще: если вы используете только QCode, просто укажите BASE_URL вашего инструмента на api.qcode.cc — 9router не нужен.
• Когда 9router уместен: если вы хотите совмещать QCode с другими провайдерами (подписки, бонусные лимиты, собственные развёртывания и т. д.) и вам нужны единая точка входа, автоматический фолбэк, межпровайдерное переключение или сжатие токенов, вы можете зарегистрировать QCode как одного из провайдеров 9router (в качестве основного или резервного уровня).

Добавить QCode как провайдера¶

1. Запустите 9router согласно его документации и откройте локальную консоль (по умолчанию http://localhost:20128).

2. В разделе Providers (Провайдеры) добавьте кастомного / OpenAI-совместимого (Compatible Node) провайдера:

3. Endpoint / Base URL:

   • Чат (семейство GPT): https://api.qcode.cc/openai/v1
   • Чат (семейство Claude, если 9router поддерживает узлы протокола Anthropic): https://api.qcode.cc/api
   • Изображения (опционально): https://api.qcode.cc/qcode-img/v1 (см. примечание ниже)
   • В материковом Китае замените домен на asia.qcode.cc (ближайшая азиатская точка доступа).
4. API Key: ваш QCode API Key (начинается с cr_).
5. Модели / алиасы: регистрируйте по необходимости claude-opus-5, claude-sonnet-5, gpt-6-sol, gpt-5.6-terra и т. д. (4.x, например claude-sonnet-4-6, по-прежнему в продаже).
6. Поместите этого провайдера QCode в вашу цепочку tier / fallback (например, как основной или как резервный уровень после исчерпания квоты у других провайдеров).
7. Подключите ваши инструменты (Claude Code / Cursor / Cline и т. д.) к локальной точке входа 9router http://localhost:20128/v1 — после этого 9router сам решает, когда маршрутизировать на QCode.

Прямое подключение к QCode vs через 9router¶

Примечания¶

• Только локально: 9router работает локально, и его конфигурация не разделяется между участниками команды.
• Маршрутизация изображений требует собственной проверки: 9router открывает /v1/images/generations, но «вызов QCode gpt-image-2 через 9router» не протестирован и может потребовать дополнительной настройки; если нужна надёжность, направляйте изображения через прямое подключение image-2.
• Квоты определяет панель QCode: статистика 9router не равна фактической квоте вашего аккаунта QCode (суточные лимиты на каждый Key и т. д. определяются панелью QCode / probe.qcode.cc).
• Соответствие протокола и пути: /openai/v1 использует протокол OpenAI, /api использует протокол Anthropic, а /qcode-img/v1 — для изображений; подробнее см. Точки подключения и форматы API.

Установка и локальная точка входа (по официальному README 9router)¶

По состоянию на 2026-10-15 быстрый старт в официальном README 9router такой: установить командой npm install -g 9router, запустить командой 9router; панель по умолчанию открывается на http://localhost:20128. В подключаемом инструменте укажите Endpoint http://localhost:20128/v1, а API Key скопируйте из панели 9router. В README также сказано, что поддерживаются пользовательские OpenAI- и Anthropic-совместимые эндпоинты — именно так добавляется QCode.

Ключевые параметры¶

Частые ошибки и диагностика¶

Сначала обратитесь к QCode напрямую через curl (раздел 5 в Эндпоинты и форматы API), чтобы убедиться в ключе и пути, и только потом разбирайтесь с уровнем 9router — так выйдет вдвое меньше лишних итераций.

Часто задаваемые вопросы¶

Нужен ли 9router, если я пользуюсь только QCode?¶

Нет. Если вы используете только QCode, проще направить BASE_URL инструмента прямо на api.qcode.cc (из материкового Китая — asia.qcode.cc): на один локальный прокси меньше и на одно место для ошибок меньше.

Почему стоимость в 9router отличается от счёта QCode?¶

Цифры в 9router — его собственная оценка по выбранным маршрутам. QCode тарифицирует по токенам, цены по моделям указаны на qcode.cc/models, а реальные списания смотрите в панели QCode.

Может ли Claude Code использовать модели Claude через 9router?¶

Только если 9router поддерживает узел с протоколом Anthropic и адрес QCode /api настроен именно как такой узел. При наличии лишь OpenAI-совместимого узла модели Claude отклоняются. Точный интерфейс описан в официальном репозитории 9router.

Как убедиться, что запросы через 9router действительно доходят до QCode?¶

Введите свой ключ cr_ на probe.qcode.cc: если видны модель и токены запроса, он дошёл. Если нет, проверьте, входит ли provider QCode в цепочку tier / fallback 9router и не стоит ли он слишком далеко.

Один API Key работает с двумя протоколами (Anthropic / OpenAI), как при прямом подключении, так и через маршрутизатор вроде 9router. Узнайте о ценах QCode.cc.

Enterprise →