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

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

> Конкретные функции, порты и интерфейс смотрите в [официальном репозитории 9router](https://github.com/decolua/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)** провайдера:
   - **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` для меньшей задержки.
   - **API Key**: ваш QCode API Key (начинается с `cr_`).
   - **Модели / алиасы**: регистрируйте по необходимости `claude-opus-5`, `claude-sonnet-5`, `gpt-5.5`, `gpt-5.4`, `gpt-5.6-terra` и т. д. (4.x, например `claude-sonnet-4-6`, по-прежнему в продаже).
3. Поместите этого провайдера QCode в вашу **цепочку tier / fallback** (например, как основной или как резервный уровень после исчерпания квоты у других провайдеров).
4. Подключите ваши инструменты (Claude Code / Cursor / Cline и т. д.) к локальной точке входа 9router `http://localhost:20128/v1` — после этого 9router сам решает, когда маршрутизировать на QCode.

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

| | Прямое QCode | Через 9router |
|---|---|---|
| Сложность настройки | Низкая (один BASE_URL) | Средняя (нужно настроить provider / tier / алиасы) |
| Мульти-провайдерный фолбэк | Нет | Есть (QCode может быть основным или резервным) |
| Командный доступ | Да (облачный сервис) | Нет (9router только локальный; конфиг не общий между участниками) |
| Статистика использования | Точная через панель QCode [probe.qcode.cc](https://probe.qcode.cc) | 9router отражает только свои собственные выборы маршрутизации; квоты по-прежнему определяет панель QCode |
| Стабильность | Прямое подключение самое стабильное | Один дополнительный локальный прокси-слой |

## Примечания

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

---

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