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

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

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

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-4-8, claude-sonnet-4-6, gpt-5.5, gpt-5.4, gpt-5.3-codex и т. д.
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.

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