QCode mit 9router verwenden

Fügen Sie QCode.cc als benutzerdefinierten Anbieter in 9router hinzu, einem lokalen Multi-Provider-Router für anbieterübergreifendes Fallback und einheitliche Verwaltung

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; 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:

3. 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.
4. API Key: Ihr QCode API-Key (beginnt mit cr_).
5. 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).
6. 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).
7. 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¶

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.
• 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).
• 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.

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.