Roo Code mit eigener API verbinden: Base URL, Key und Modell (2026)

Roo Code ist ein verbreiteter Coding-Agent für VS Code. Er unterstützt mehrere Modi, die Zuweisung unterschiedlicher Modelle pro Modus und benutzerdefinierte OpenAI-kompatible Provider. Für Teams lohnt sich der Anschluss an ein einheitliches Gateway: Der Zugriffspfad bleibt fest, die Abrechnung läuft zentral, und Budgets lassen sich pro Projekt begrenzen.

Zuerst eine wichtige Änderung: Laut Ankündigung im Roo-Code-Repository hat Roo Code Inc. die Roo-Code-Erweiterung am 15. Mai 2026 eingestellt; das Hauptrepository wurde am selben Tag archiviert, die letzte Version ist v3.54.0. Der Community-Fork Zoo Code führt die Entwicklung fort und behält den Großteil der bisherigen Konfigurationswege bei. Dieser Artikel konzentriert sich auf Zoo Code und kennzeichnet Unterschiede zur alten Roo-Code-Version.

Hinweis: Roo Code ist eine Marke von Roo Code, Inc.; Zoo Code ist ein Community-Fork; VS Code ist eine Marke der Microsoft Corporation; OpenAI ist eine Marke von OpenAI, Inc. Dieser Artikel dient nur der technischen Erläuterung; es besteht keine Zugehörigkeits- oder Kooperationsbeziehung zu den genannten Stellen. Projektstatus, Oberfläche und Menüs richten sich nach den Repository-Ankündigungen und der aktuellen Dokumentation.

1. Zuerst prüfen: Roo Code oder Zoo Code?

Panel und Provider-Konfiguration ähneln sich stark, der Wartungsstatus unterscheidet sich jedoch:

Roo Code: Die Erweiterungs-ID lautet RooVeterinaryInc.roo-cline; das Hauptrepository wurde am 15. Mai 2026 archiviert, die Erweiterung wird nicht mehr aktualisiert. Bereits installierte Versionen laufen möglicherweise weiter, erhalten aber keine Fehlerbehebungen und keine Anpassungen an neue Modelle.
Zoo Code: ein aus der Roo-Code-Community hervorgegangener Fork unter Apache-2.0, veröffentlicht im VS Code Marketplace als ZooCodeOrganization.zoo-code, Dokumentation unter docs.zoocode.dev. Die Modi Code, Architect, Ask und Debug werden fortgeführt.
Das bisherige Roo-Code-Einstellungsverzeichnis, .roomodes und .rooignore bleiben erhalten; bei der Migration lassen sie sich meist weiterverwenden. Die genauen Schritte stehen in der Migrationsdokumentation von Zoo Code.
Für eine einheitliche Teamkonfiguration prüfen Sie zuerst, ob alle dieselbe Erweiterung installiert haben. Die gleichzeitige Nutzung von altem Roo Code und Zoo Code kann zu abweichenden Menüs und Einstellungen führen.

2. Key, Base URL und Modell vorbereiten

Vor dem Start benötigen Sie drei Dinge: einen API-Key, eine OpenAI-kompatible Adresse und eine exakte Modell-ID.

Öffnen Sie die Registrierungsseite des ZSQH AI Gateway, registrieren Sie sich und melden Sie sich in der Konsole an.
Rufen Sie „API-Keys“ auf, legen Sie einen neuen Key an und benennen Sie ihn nach dem Zweck, etwa zoo-code-arbeitsrechner.
Legen Sie ein Ausgabenlimit und ein Ablaufdatum fest. Auch bei privaten Konten empfiehlt sich das, um ungewöhnlichen Verbrauch zu begrenzen.
Kopieren Sie den Key und speichern Sie ihn im Passwortmanager. Die Konsole zeigt ihn üblicherweise nur einmal vollständig an.
Öffnen Sie die Modellpreise und notieren Sie die gewünschte Modell-ID. Preise und Modelle ändern sich; maßgeblich ist die aktuelle Anzeige.

Die drei Angaben sehen so aus:

API Provider: OpenAI Compatible
Base URL:     https://ai.zhongshangqihang.com/v1
API Key:      sk-... (in der Konsole erstellt, nur im Passwortmanager gespeichert)
Model:        Modell-ID laut aktueller Anzeige auf der Modellpreisseite

Die Base URL ist die OpenAI-kompatible Adresse und endet auf /v1. Tragen Sie nicht die Anthropic-Stamm-Adresse ein und ergänzen Sie nicht selbst /chat/completions, sonst entstehen doppelte Pfade und 404-Fehler.

3. Erweiterung in VS Code installieren

Zoo Code setzt VS Code 1.84.0 oder höher voraus. Installation:

VS Code öffnen und mit Cmd/Ctrl + Shift + X die Erweiterungsansicht aufrufen.
Nach Zoo Code suchen und den Eintrag des Publishers ZooCodeOrg installieren.
Wird noch die alte Roo-Code-Version verwendet, nach Roo Code suchen, Publisher RooVeterinaryInc; beachten Sie, dass sie nicht mehr gewartet wird.
Nach der Installation VS Code wie aufgefordert neu laden. In der Aktivitätsleiste erscheint das Symbol, über das sich das Panel öffnen lässt.
In Editoren ohne Marketplace wie VSCodium oder Windsurf über Open VSX nach der gleichnamigen Erweiterung suchen oder die VSIX-Datei aus den Releases herunterladen und manuell installieren.
Erscheint das Symbol nach der Installation nicht, VS Code neu starten, prüfen, ob die Erweiterung aktiviert ist, und unter View → Output den Ausgabekanal der Erweiterung kontrollieren.

4. OpenAI Compatible Provider konfigurieren

Öffnen Sie das Einstellungspanel der Erweiterung und wählen Sie im Dropdown API Provider den Eintrag OpenAI Compatible. Diese Option ist für kompatible Dienste außerhalb der offiziellen OpenAI-Adresse gedacht und nicht mit dem eingebauten OpenAI-Provider identisch.

Auszufüllende und zu prüfende Felder:

Base URL: https://ai.zhongshangqihang.com/v1 eintragen, ohne /chat/completions.
API Key: den in der Konsole erstellten Key einfügen, ohne Leerzeichen oder Zeilenumbrüche.
Model: die Modell-ID eintragen, nicht den Anzeigenamen und keine Notiz.
Model Configuration: bei Bedarf Context Window, Max Output Tokens, Image Support, Computer Use sowie Eingabe-/Ausgabepreise ausfüllen. Die Preisfelder beeinflussen nur die Kostenanzeige der Oberfläche, nicht die tatsächliche Abrechnung; bei Unsicherheit leer lassen.
Tool-Aufrufe: Der OpenAI-Compatible-Provider von Zoo Code und Roo Code unterstützt nur native OpenAI-Tool-Aufrufe, ohne XML-Fallback. Das gewählte Modell muss OpenAI-kompatibles Function Calling unterstützen; sonst funktioniert normaler Chat möglicherweise, aber der Agent scheitert beim Lesen oder Schreiben von Dateien.

Implementiert das Gateway nur einen Teil der Tool-Protokolle, testen Sie zuerst einen normalen Chat und dann das Lesen einer kleinen Datei. Starten Sie nicht sofort mit einem Refactoring über mehrere Dateien, da sich die Fehlerursache sonst kaum eingrenzen lässt.

5. Modelle und Modi zuweisen

Roo Code und Zoo Code unterstützen mehrere Modi und erlauben pro Modus ein eigenes Modell. So lassen sich Kosten und Fähigkeiten ausbalancieren:

Modus oder Szenario	Empfohlene Stufe	Konfigurationshinweis
Code: alltägliche Codeänderungen	Haupt-Coding-Modell	Muss Tool-Aufrufe unterstützen; Kontextfenster korrekt eintragen
Architect: Lösungsdesign	Leistungsfähiges Modell	Kontext darf größer sein, Kosten beachten
Ask: Erklärungen und Fragen	Leichtes, schnelles Modell	Ohne Tool-Nutzung genügt eine günstige Stufe
Debug: Fehlersuche	Haupt- oder leistungsfähiges Modell	Ausreichende Ausgabelänge lassen, um Abschneiden zu vermeiden
Orchestrator: Multi-Task-Orchestrierung	Modell mit stabilen Tool-Aufrufen	Rückfallmodell einrichten, um bei Ausfall zu wechseln

Für jeden Modus empfiehlt sich ein Rückfallmodell. Ist das Hauptmodell gedrosselt oder nicht verfügbar, ist der Wechsel zu einem Ersatzmodell mit demselben Protokoll und denselben Tool-Fähigkeiten stabiler als wiederholtes Retrying. Verfügbarkeit und Preise entnehmen Sie den Modellpreisen.

6. Prüfen, ob die Konfiguration greift

Eine Antwort im Panel genügt nicht – sie kann von einem anderen Modus stammen. Prüfen Sie in dieser Reihenfolge:

Eine neue Aufgabe anlegen, damit der bisherige Kontext nicht stört.
Ausdrücklich das gerade konfigurierte Modell auswählen, nicht das Standard-Routing.
Eine kurze Anfrage senden, etwa die Erklärung eines Codeblocks unter zehn Zeilen.
Das Gateway-Request-Log prüfen und bestätigen, dass ein Eintrag mit gleicher Zeit, gleichem Modell und gleichem Key existiert.
Das Modell eine kleine Datei lesen lassen, um die Tool-Aufrufkette zu prüfen.
Fehlt der Eintrag im Log, erreicht die Anfrage das Gateway nicht; kehren Sie zu Base URL und Provider zurück.

Häufige Fehler lassen sich so zuordnen:

Invalid API Key: Key falsch, deaktiviert, Guthaben aufgebraucht oder im falschen Provider-Feld.
Model Not Found: Modell-ID falsch geschrieben oder für das aktuelle Konto nicht freigeschaltet.
Connection Errors: Base URL nicht erreichbar oder Probleme mit Proxy, TLS, Firewall.
Fehler bei Tool-Aufrufen: Modell unterstützt keine nativen Tool-Aufrufe, oder das Gateway implementiert nur einen Teil der Protokolle.
Ergebnis weicht ab: zuerst prüfen, welches Modell der aktuelle Modus verwendet, dann Prompt und Kontext kontrollieren.

Die Dokumentation beider Projekte orientiert sich vor allem an Fehlermeldungen und nennt keinen eigenen Verify-Button. Die tatsächliche Anfrage entscheidet; erfolgreiches Speichern bedeutet nicht automatisch, dass alles funktioniert.

7. Berechtigungen und automatische Freigabe

Ein Coding-Agent kann Dateien lesen und schreiben sowie Befehle ausführen; die Rechteverwaltung ist wichtiger als die Modellwahl. Das Menü Auto-Approve befindet sich neben dem Chat-Eingabefeld und enthält den Hauptschalter Enabled sowie Kategorien wie Read, Write, Execute, Browser und MCP.

Empfohlener sicherer Ausgangspunkt:

Zuerst nur Read aktivieren und prüfen, ob der Lesebereich den Erwartungen entspricht.
Write zunächst ausschalten; bei Bedarf einschalten und die Schreibverzögerung auf mindestens 1000 Millisekunden setzen.
Execute mit Allowlist und Denylist betreiben, nicht mit * alle Befehle freigeben.
Lesen und Schreiben außerhalb des Arbeitsbereichs sowie das Bearbeiten geschützter Dateien deaktivieren.
In Produktions-Repositories, Verzeichnissen mit Schlüsseln und Kundenordnern keine automatische Freigabe aktivieren.
Automatische Freigabe überspringt Bestätigungen und kann Datenverlust oder Dateischäden verursachen; besonders die Befehlsausführung ist riskant.

Das Befehlsbeispiel in der Roo-Code-Dokumentation verwendet das Präfix roo-cline.:

{
  "roo-cline.allowedCommands": ["git status", "npm run", "python -m pytest"],
  "roo-cline.deniedCommands": ["git push", "npm publish", "rm", "sudo"]
}

Zoo Code behält die bisherigen Einstellungsgewohnheiten bei, Schlüsselnamen und Menüpositionen können sich jedoch ändern; maßgeblich ist die Einstellungsseite. Die Allowlist gleicht nach Präfix ab, Deny-Regeln haben Vorrang; Befehle mit gefährlichen Ersetzungen werden auch bei passendem Präfix blockiert.

8. Sicherheitscheckliste

Ein Zweck, ein Key; nicht geräte- oder projektübergreifend wiederverwenden.
Ausgabenlimit und Ablaufdatum setzen, regelmäßig rotieren; bei Verdacht auf Offenlegung zuerst deaktivieren, dann untersuchen.
Den Key nicht in Code, .env, .vscode/settings.json oder Commits schreiben.
Mit .rooignore Dateien wie .env, Zugangsdaten, Build-Artefakte und Logs ausschließen, damit sie seltener gelesen werden.
In nicht vertrauenswürdigen Repositories keine automatische Freigabe aktivieren; zuerst prüfen, ob der Arbeitsbereich vertrauenswürdig ist.
Änderungen des Agenten und Terminalbefehle kontrollieren; vor wichtigen Aktionen committen oder einen Checkpoint anlegen.
Im Team einheitlich über das Gateway gehen, jedem eine eigene Key geben und Request-Logs behalten, um Auditing und Offboarding zu erleichtern.
Beachten Sie, dass Code und Prompts das Gerät verlassen; Teams mit Datenaufbewahrungsanforderungen sollten vorher eine Bewertung durchführen.

Häufige Fragen

Lässt sich Roo Code noch verwenden?

Laut Repository-Ankündigung wurde die Roo-Code-Erweiterung am 15. Mai 2026 eingestellt und das Hauptrepository archiviert. Installierte Versionen laufen möglicherweise weiter, erhalten aber keine Fehlerbehebungen und keine Anpassungen an neue Modelle. Für neue Projekte empfiehlt sich direkt der Community-Fork Zoo Code.

Sind die Konfigurationsschritte bei Roo Code und Zoo Code gleich?

Weitgehend ja: OpenAI Compatible wählen und Base URL, Key und Modell eintragen. Einzelne Menünamen und Einstellungsschlüssel können abweichen; maßgeblich sind die aktuelle Einstellungsseite und docs.zoocode.dev.

Gehört in die Base URL die Stammadresse oder `/v1`?

Für das OpenAI-kompatible Protokoll reicht die Angabe bis /v1, zum Beispiel https://ai.zhongshangqihang.com/v1. /chat/completions nicht anhängen, sonst entsteht ein doppelter Pfad.

Was tun bei „Invalid API Key“ oder „Model Not Found“?

Zuerst prüfen, ob der Key im OpenAI-Compatible-Formular steht und Base URL und Key zur selben Umgebung gehören; dann die Authentifizierung über /v1/models testen. Model Not Found bedeutet meist eine falsch geschriebene oder nicht freigeschaltete Modell-ID.

Warum schlagen Tool-Aufrufe fehl?

Der OpenAI-Compatible-Provider unterstützt nur native Tool-Aufrufe, ohne XML-Fallback. Modell oder Gateway müssen OpenAI-kompatibles Function Calling unterstützen; sonst funktioniert der Chat, aber das Lesen und Schreiben von Dateien scheitert. Testen Sie ein anderes Modell mit Tool-Unterstützung.

Nächste Schritte

Registrieren Sie sich zunächst beim ZSQH AI Gateway, legen Sie einen Key nur für Zoo Code an und tragen Sie Base URL und Modell wie beschrieben ein. Nach einem erfolgreichen normalen Chat und dem Lesen einer kleinen Datei passen Sie die Hauptmodelle und Limits der einzelnen Modi anhand der Modellpreise an.