Roo Code Einrichtung

QCode.cc in der Roo Code VS Code Extension nutzen: Anthropic-Anbieter wählen, benutzerdefinierte Base-URL aktivieren – schon funktioniert Claude

⚠️ 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¶

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¶

🔴 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)¶

1. Öffnen Sie Settings (Zahnrad-Symbol) in der Roo-Code-Seitenleiste
2. Stellen Sie API Provider auf Anthropic
3. Tragen Sie Ihren QCode-API-Key (beginnt mit cr_) unter API Key ein
4. Aktivieren Sie Use custom base URL und geben Sie https://api.qcode.cc/api ein
5. Wählen Sie claude-sonnet-5 (oder eine andere verfügbare ID) im Modellauswahlmenü
6. 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/messages selbst, und ein zusätzlicher Schrägstrich erzeugt einen 404-Fehler.

GPT und chinesische Modelle konfigurieren (OpenAI Compatible)¶

1. Stellen Sie API Provider auf OpenAI Compatible
2. Base URL: https://api.qcode.cc/openai/v1
3. API Key: derselbe cr_-Schlüssel
4. Model ID: gpt-6-sol, gpt-5.6-terra oder eine chinesische Modell-ID wie glm-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¶

Weiterführende Links¶

• Endpunkte & API-Pfade — Tabelle Protokoll × Modellfamilie
• Kilo Code Einrichtung — nachgelagerter Fork, nahezu identische Einrichtung
• Cline Integration — ursprüngliches Projekt
• Chinesische Modelle