# QCode mit 9router verwenden

[9router](https://github.com/decolua/9router) ist ein **lokaler Multi-Provider-KI-Routing-Proxy**: Er stellt einen OpenAI-kompatiblen Dienst auf Ihrem eigenen Rechner bereit (Standard `http://localhost:20128/v1`), übernimmt Anfragen von Tools wie Claude Code, Cursor, Cline und Codex und leitet sie gemäß Ihren Regeln an mehrere Upstream-Anbieter weiter (einschließlich automatisches Fallback / Umschaltung bei erschöpftem Kontingent / Ausgabe-Komprimierung zur Token-Ersparnis usw.). Konzeptionell ist er mit QCodes eigenem CCR vergleichbar — der Unterschied ist, dass 9router auf **Ihrem eigenen Rechner** läuft und von Ihnen verwaltet wird.

> Die genauen Funktionen, Ports und die UI entnehmen Sie bitte dem [9router-Repository](https://github.com/decolua/9router); dieser Artikel behandelt ausschließlich „Wie füge ich QCode hinzu“.

## Wann Sie es brauchen

- **Die direkte Anbindung an QCode ist einfacher und stabiler**: Wenn Sie nur QCode nutzen, richten Sie einfach die BASE_URL Ihres Tools auf `api.qcode.cc` — Sie brauchen dann keinen 9router.
- **Wann 9router sinnvoll ist**: Wenn Sie QCode mit anderen Anbietern (Abos, Freiguthaben, Self-Hosting usw.) **kombinieren** möchten und eine einheitliche Einstiegsmöglichkeit, automatisches Fallback, anbieterübergreifendes Umschalten oder Token-Komprimierung benötigen, können Sie QCode als einen der Anbieter von 9router registrieren (als primären Anbieter oder als Fallback-Ebene).

## QCode als Anbieter hinzufügen

1. Starten Sie 9router gemäß dessen Dokumentation und öffnen Sie die lokale Konsole (Standard `http://localhost:20128`).
2. Fügen Sie unter **Providers** einen **benutzerdefinierten / OpenAI-kompatiblen Anbieter (Compatible Node)** hinzu:
   - **Endpoint / Base URL**:
     - Chat (GPT-Familie): `https://api.qcode.cc/openai/v1`
     - Chat (Claude-Familie, sofern 9router Anthropic-Protokollknoten unterstützt): `https://api.qcode.cc/api`
     - Bild (optional): `https://api.qcode.cc/qcode-img/v1` (siehe Hinweis unten)
     - In Festlandchina ersetzen Sie die Domain durch `asia.qcode.cc` für geringere Latenz.
   - **API Key**: Ihr QCode API-Key (beginnt mit `cr_`).
   - **Modelle / Aliase**: Registrieren Sie bei Bedarf `claude-opus-5`, `claude-sonnet-5`, `gpt-6-sol`, `gpt-6-luna`, `gpt-5.6-terra` usw. (Modelle der 4.x-Reihe wie `claude-sonnet-4-6` sind weiterhin erhältlich).
3. Nehmen Sie diesen QCode-Anbieter in Ihre **Stufen- / Fallback-Kette** auf (z. B. als primären Anbieter oder als Fallback-Ebene, sobald bei anderen Anbietern das Kontingent erschöpft ist).
4. Richten Sie Ihre Tools (Claude Code / Cursor / Cline usw.) auf den lokalen Einstiegspunkt von 9router `http://localhost:20128/v1` — ab dann entscheidet 9router, wann an QCode weitergeleitet wird.

## Direktes QCode vs. über 9router

| | Direktes QCode | Über 9router |
|---|---|---|
| Konfigurationsaufwand | Gering (eine BASE_URL) | Mittel (Anbieter / Stufen / Aliase einrichten) |
| Multi-Provider-Fallback | Keines | Ja (QCode kann primär oder Fallback sein) |
| Team-Nutzung | Ja (Cloud-Dienst) | Nein (9router ist nur lokal; Konfiguration wird nicht zwischen Teammitgliedern geteilt) |
| Nutzungsstatistik | Genau über QCode-Dashboard [probe.qcode.cc](https://probe.qcode.cc) | 9router spiegelt nur eigene Routing-Entscheidungen wider; Kontingente richten sich weiterhin nach dem QCode-Dashboard |
| Stabilität | Direkt am stabilsten | Eine zusätzliche lokale Proxy-Ebene |

## Hinweise

- **Nur lokal**: 9router läuft lokal, und seine Konfiguration wird nicht zwischen Teammitgliedern geteilt.
- **Bild-Routing erfordert eigene Tests**: 9router stellt `/v1/images/generations` bereit, aber „QCodes `gpt-image-2` über 9router aufrufen“ ist **ungetestet** und erfordert möglicherweise zusätzliche Konfiguration; wenn Sie Zuverlässigkeit benötigen, leiten Sie Bildanfragen direkt über [image-2](/docs/usage/image-2).
- **Kontingente richten sich nach dem QCode-Dashboard**: Die Statistik von 9router entspricht nicht Ihrem tatsächlichen QCode-Kontingent (tägliche Limits pro Key usw. richten sich nach dem QCode-Dashboard / [probe.qcode.cc](https://probe.qcode.cc)).
- **Protokoll-zu-Pfad-Zuordnung**: `/openai/v1` verwendet das OpenAI-Protokoll, `/api` das Anthropic-Protokoll und `/qcode-img/v1` ist für Bilder gedacht — siehe [Endpoints und API-Formate](/docs/getting-started/endpoints-and-api-paths).

---

> Ein API-Key funktioniert über drei Protokolle (Anthropic / OpenAI / Gemini), ob Sie sich direkt verbinden oder über einen Router wie 9router. Mehr zu den [QCode.cc-Preisen](https://qcode.cc/pricing).