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

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

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 Modellanbieter 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: 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, Aktionsguthaben, 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 (der nahegelegene Zugangspunkt in Asien).
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-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.

Installation und lokaler Endpunkt (laut offizieller 9router-README)¶

Stand 2026-10-15 lautet der Schnellstart in der offiziellen 9router-README: mit npm install -g 9router installieren, mit 9router starten; das Dashboard öffnet sich standardmäßig unter http://localhost:20128. Im anzubindenden Tool tragen Sie als Endpoint http://localhost:20128/v1 ein und kopieren den API Key aus dem 9router-Dashboard. Die README nennt außerdem benutzerdefinierte OpenAI- und Anthropic-kompatible Endpunkte als unterstützt – so wird QCode hinzugefügt.

Wichtige Einstellungen¶

Häufige Fehler und Fehlersuche¶

Prüfen Sie zuerst per curl direkt gegen QCode (Abschnitt 5 in Endpunkte und API-Formate), ob Schlüssel und Pfad stimmen, und suchen Sie erst danach auf der 9router-Ebene. Das spart viel Hin und Her.

FAQ¶

Brauche ich 9router, wenn ich nur QCode nutze?¶

Nein. Wer nur QCode nutzt, richtet die BASE_URL des Tools direkt auf api.qcode.cc (in Festlandchina asia.qcode.cc). Das ist einfacher: ein lokaler Proxy weniger und eine Fehlerquelle weniger.

Warum weichen die Kosten in 9router von meiner QCode-Abrechnung ab?¶

Die Zahlen in 9router sind eigene Schätzungen anhand seiner Routing-Entscheidungen. QCode rechnet pro Token ab, die Preise je Modell stehen unter qcode.cc/models; maßgeblich ist das QCode-Dashboard.

Kann Claude Code über 9router Claude-Modelle nutzen?¶

Nur wenn 9router einen Knoten mit Anthropic-Protokoll unterstützt und Sie die QCode-Adresse /api als einen solchen Knoten eingerichtet haben. Mit einem rein OpenAI-kompatiblen Knoten werden Claude-Modelle abgelehnt. Die genaue Oberfläche beschreibt das offizielle 9router-Repository.

Wie prüfe ich, dass Anfragen über 9router wirklich bei QCode ankommen?¶

Geben Sie Ihren cr_-Schlüssel auf probe.qcode.cc ein; sind Modell und Tokens der Anfrage zu sehen, ist sie angekommen. Falls nicht, prüfen Sie, ob der QCode-Provider in der tier-/Fallback-Kette von 9router steht und früh genug platziert ist.

Ein API-Key funktioniert über zwei Protokolle (Anthropic / OpenAI), ob Sie sich direkt verbinden oder über einen Router wie 9router. Mehr zu den QCode.cc-Preisen.

Enterprise →