Roo Code Einrichtung
QCode.cc in der Roo Code VS Code Extension nutzen: Anthropic-Anbieter wählen, benutzerdefinierte Base-URL aktivieren – schon funktioniert Claude
Brauchen Sie einen API-Key? Registrieren →Endpunkte & Base-URLs →
Auf dieser Seite
⚠️ Projekt archiviert: das GitHub-Repository RooCodeInc/Roo-Code ist seit dem 2026-05-15 archiviert (nur lesbar) – keine weiteren Updates oder Fixes mehr. Die nachfolgende Konfiguration funktioniert weiterhin für bestehende Installationen und dient als Referenz; für eine aktiv gepflegte Alternative erwägen Sie den Wechsel zu Kilo Code oder Cline.
Letzte Verifizierung: 2026-09-18 · 📄 Gemäß offizieller Doku (Archivstatus über die GitHub-API geprüft; Roo Code veröffentlicht keine Releases mehr)
Auf einen Blick¶
| Punkt | Details |
|---|---|
| Nutzbare Modelle | Claude ✅ (Anthropic-Anbieter + benutzerdefinierte Base-URL) · GPT ✅ · Chinesische Modelle ✅ (OpenAI Compatible) · Gemini ❌ |
| Protokoll & Base URL | Anthropic: https://api.qcode.cc/api · OpenAI: https://api.qcode.cc/openai/v1 |
| Konfigurationsort | Einstellungsfeld der VS Code Extension (API Provider / Base-URL-Checkbox) |
| Offizielle Doku | Roo Code Repository |
Roo Code ist eine Open-Source-KI-Coding-Erweiterung für VS Code, geforkt von Cline; Kilo Code wiederum wurde von Roo Code geforkt – alle drei teilen nahezu identische Einstellungsdialoge, sodass diese Seite auf alle drei übertragbar ist.
Welches Protokoll¶
| Gewünschtes Modell | API Provider | Base URL |
|---|---|---|
| Claude | Anthropic |
https://api.qcode.cc/api |
| GPT / die vier chinesischen Modellfamilien | OpenAI Compatible |
https://api.qcode.cc/openai/v1 |
🔴 Verwenden Sie nicht OpenAI Compatible für Claude – der QCode-OpenAI-Endpunkt lehnt Claude-Modelle mit model_not_available_on_endpoint ab. Siehe Endpunkte & API-Pfade.
Installation¶
Suchen Sie im VS Code Marketplace nach Roo Code, oder folgen Sie den Anweisungen im Projekt-Repository.
Claude konfigurieren (Anthropic-Anbieter)¶
- Öffnen Sie Settings (Zahnrad-Symbol) in der Roo-Code-Seitenleiste
- Stellen Sie API Provider auf Anthropic
- Tragen Sie Ihren QCode-API-Key (beginnt mit
cr_) unter API Key ein - Aktivieren Sie Use custom base URL und geben Sie
https://api.qcode.cc/apiein - Wählen Sie
claude-sonnet-5(oder eine andere verfügbare ID) im Modellauswahlmenü - Speichern Sie, und senden Sie eine Nachricht im Chatfenster, um die Verbindung zu bestätigen
Aus dem chinesischen Festland tauschen Sie den Host gegen
https://asia.qcode.cc/api(Asien-Knoten, nächstgelegener von Korea / Taiwan / Hongkong); der API-Key bleibt unverändert. Kein abschließender Schrägstrich in der Base URL – die Extension ergänzt/v1/messagesselbst, und ein zusätzlicher Schrägstrich erzeugt einen 404-Fehler.
GPT und chinesische Modelle konfigurieren (OpenAI Compatible)¶
- Stellen Sie API Provider auf OpenAI Compatible
- Base URL:
https://api.qcode.cc/openai/v1 - API Key: derselbe
cr_-Schlüssel - Model ID:
gpt-6-sol,gpt-5.6-terraoder eine chinesische Modell-ID wieglm-5.2
Konnektivität prüfen¶
Überprüfen Sie den Endpunkt und API-Key zunächst per curl, damit Sie wissen, ob Sie die Oberfläche der Extension debuggen müssen:
KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
-H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
JSON mit content bedeutet, dass der Endpunkt einwandfrei arbeitet; falls die Extension dennoch fehlschlägt, liegt das Problem in deren Einstellungen.
Fehlerbehebung¶
| Symptom | Ursache | Lösung |
|---|---|---|
model_not_available_on_endpoint |
Zugriff auf Claude über OpenAI Compatible | Wechseln Sie zum Anthropic-Anbieter mit /api |
Invalid API key |
Falscher Schlüssel oder versehentliche Leerzeichen | Prüfen Sie das cr_-Präfix und entfernen Sie Leerzeichen |
| 404 | Abschließender Schrägstrich in der Base URL oder falscher Pfad | Vergleichen Sie mit der Tabelle oben |
| Ihre Modell-ID fehlt im Dropdown | Nicht in der eingebauten Liste der Extension | Geben Sie die Modell-ID im Feld für benutzerdefinierte Modell-IDs ein |
Einstellungen im Überblick¶
| Einstellung (Roo-Code-Oberfläche) | Eintrag | Hinweis |
|---|---|---|
| API Provider | Anthropic (Claude) oder OpenAI Compatible (GPT, chinesische Modelle) |
Legt das Protokoll fest; eine falsche Wahl wird direkt abgelehnt |
| API Key | Ihr QCode-Schlüssel mit Präfix cr_ |
Derselbe Schlüssel funktioniert mit beiden Providern |
| Use custom base URL | Aktivieren und https://api.qcode.cc/api eintragen |
Nur beim Provider Anthropic nötig; in Festlandchina asia.qcode.cc |
| Base URL (OpenAI Compatible) | https://api.qcode.cc/openai/v1 |
Ohne abschließenden Schrägstrich |
| Model / Model ID | z. B. claude-sonnet-5, gpt-6-sol, glm-5.2 |
Fehlt das Modell in der Auswahlliste, im benutzerdefinierten Feld eintippen |
Weitere Fehlersuche¶
Klären Sie zuerst, ob das Problem am Endpunkt oder an der Konfiguration in der Oberfläche liegt: Liefert der curl-Befehl aus dem Abschnitt „Konnektivität prüfen“ eine Antwort, ist QCode in Ordnung. Danach der Reihe nach:
- Zuerst Kleinigkeiten ausschließen: Ein Leerzeichen um den Schlüssel oder ein abschließender Schrägstrich an der Base URL sind die häufigsten Ursachen; korrigieren, speichern und eine Testnachricht senden.
- Einstellungen von Anthropic und OpenAI Compatible vermischt: Nach einem Provider-Wechsel Base URL und Schlüssel erneut prüfen.
- Das gewünschte Modell wird abgelehnt: Claude geht nur über den Provider Anthropic, GPT und chinesische Modelle nur über OpenAI Compatible; siehe die maßgebliche Tabelle in Endpunkte und API-Formate.
- Anfragen tauchen auf QCode-Seite nicht auf: Schlüssel auf probe.qcode.cc eingeben und prüfen, ob Anfragen ankommen; ohne Einträge wurde nichts gesendet – dann die Base URL in der Erweiterung prüfen.
FAQ¶
Roo Code ist archiviert. Kann ich es weiter nutzen?¶
Ja, aber es gibt keine Updates und Korrekturen mehr. Stand 2026-10-15 zeigt die GitHub-API das Repository RooCodeInc/Roo-Code als archiviert (schreibgeschützt), der letzte Push war am 2026-05-15. Bestehende Installationen verbinden sich mit den Einstellungen dieser Seite weiterhin mit QCode; für ein weiter gepflegtes Tool wechseln Sie zu Kilo Code oder Cline, deren Einrichtung nahezu identisch ist.
Kann ich in Roo Code GPT nutzen?¶
Ja. Wählen Sie als API Provider OpenAI Compatible, tragen Sie als Base URL https://api.qcode.cc/openai/v1 ein und als Model ID gpt-6-sol oder gpt-5.6-terra.
Warum geht Claude nicht über OpenAI Compatible?¶
Der OpenAI-Endpunkt von QCode akzeptiert keine Claude-Modelle und antwortet mit model_not_available_on_endpoint. Diese Prüfung erfolgt vor der Authentifizierung und bedeutet daher: falsches Protokoll gewählt, nicht: Schlüssel defekt. Für Claude den Provider Anthropic verwenden.
Welche Domain nutze ich in Festlandchina?¶
Empfohlen wird asia.qcode.cc (beim Provider Anthropic https://asia.qcode.cc/api); bei Instabilität zurück zu api.qcode.cc. Alle drei Domains verwenden denselben Schlüssel.
Worin unterscheidet sich die Einrichtung von Cline und Kilo Code?¶
Die Oberflächen sind sehr ähnlich: Roo Code wurde von Cline abgeleitet, Kilo Code von Roo Code. Protokoll, Base URL und Schlüssel werden gleich eingetragen; nur einzelne Menübezeichnungen weichen ab.
Weiterführende Links¶
- Endpunkte & API-Pfade — Tabelle Protokoll × Modellfamilie
- Kilo Code Einrichtung — nachgelagerter Fork, nahezu identische Einrichtung
- Cline Integration — ursprüngliches Projekt
- Chinesische Modelle
Mit QCode starten
Ein API-Key für Claude Code, Codex und mehr – Abrechnung pro Token, Preise je Modell auf qcode.cc/models