Wenn Sie noch Roo Code-Installationen warten, ist die Roo Code OpenAI-kompatible API-Route hauptsächlich eine Konfigurationsoberfläche: Anbietertyp, Basis-URL, API-Schlüssel und Modell-ID. Das Produktionsrisiko ist der Teil, der leicht übersehen wird. Die Anbieterdokumentation von Roo Code erfordert für diesen Pfad native Tool-Aufrufe im OpenAI-Stil, sodass eine einfache Chat-Antwort kein ausreichender Nachweis für einen Coding-Agent-Workflow ist.
Diese Anleitung zeigt, wie bestehende Roo Code-Konfigurationen über Flatkey für Entwickler, KI-Produktteams, Automatisierungsentwickler, Plattform-Ingenieure, Finanzverantwortliche und Beschaffungsprüfer geroutet werden. Sie behandelt den aktuellen Vorbehalt bei Roo Code, die Validierung der Flatkey-Basis-URL, exakte Modell-Aliase, den Preflight für native Tool-Aufrufe, Roo Code-Einstellungen, die Nutzungsüberprüfung und das Rollback.
Quellenhinweis: Dies wurde am 29. Juni 2026 mit der offiziellen Roo Code-Dokumentations-Homepage, der offiziellen Roo Code OpenAI Compatible-Anbieterdokumentation, live geschalteten öffentlichen Flatkey-Seiten und einem authentifizierten Flatkey-Gateway-Smoke-Test abgeglichen. Auf der Dokumentations-Homepage von Roo Code steht, dass die Roo Code-Erweiterung am 15. Mai 2026 eingestellt wurde. Betrachten Sie dies also als Einrichtungsanleitung für bestehende Installationen, archivierte Konfigurationen oder eine Migrationsüberprüfung und nicht als Empfehlung zur Standardisierung einer neuen Einführung, ohne die Verfügbarkeit der Erweiterung zu prüfen.
Schnelle Antwort: Einrichtung der Roo Code OpenAI-kompatiblen API
Für eine Einrichtung der Roo Code OpenAI-kompatiblen API mit Flatkey wählen Sie OpenAI Compatible als API-Anbieter, fügen Sie eine aktuelle Flatkey-Basis-URL ein, verwenden Sie einen Flatkey-API-Schlüssel und geben Sie einen exakten Flatkey-Modell-Alias ein, der OpenAI-kompatiblen Chat und native Tool-Aufrufe unterstützt. Überprüfen Sie dann die Route mit einer kleinen curl-Anfrage, bevor Sie ihr in einem Code-Arbeitsbereich vertrauen.
| Roo Code-Feld | Flatkey-Wert | Überprüfung |
|---|---|---|
| API-Anbieter | OpenAI Compatible | Verwenden Sie diesen Anbieter für Flatkey, nicht den offiziellen OpenAI-Anbieter. |
| Basis-URL | Die aktuelle Flatkey-Anbieter-Basis-URL für Ihr Konto, z. B. https://router.flatkey.ai/v1, wenn dies der verifizierte Wert ist |
Fügen Sie nur die Basis-URL ein. Fügen Sie nicht den vollständigen /chat/completions-Endpunkt in Roo Code ein. |
| API-Schlüssel | Ein Flatkey-Schlüssel, der dem richtigen Benutzer, Team oder der richtigen Umgebung gehört | Mischen Sie keine Upstream-Anbieterschlüssel mit der Flatkey-Basis-URL. |
| Modell-ID | Der exakte Flatkey-Modell-Alias, der für diesen Schlüssel aktiviert ist | Bestätigen Sie, dass der Alias den OpenAI-Chat-Endpunkt und native Tool-Aufrufe unterstützt, bevor Sie ihn für Programmieraufgaben verwenden. |
| Validierung | Kleiner Chat- plus Tool-Aufruf-Smoke-Test, dann eine sichere Roo Code-Eingabeaufforderung | Überprüfen Sie die Flatkey-Nutzung nach dem Test, damit Finanz- und Plattformverantwortliche die Route abgleichen können. |
Der kürzeste sichere Weg ist: Flatkey-Transport nachweisen, Modell-Alias nachweisen, native Tool-Aufrufe nachweisen, dann die Roo Code-Einstellungen speichern. Der Rest dieser Anleitung zur Roo Code OpenAI-kompatiblen API macht daraus eine wiederholbare Checkliste.
Was die aktuelle Roo Code-Dokumentation bestätigt
Die Roo Code-Dokumentations-Homepage enthält derzeit eine Warnung zur Einstellung der Erweiterung. Das ist für die Planung wichtig. Wenn Ihr Team eine bestehende Roo Code-Installation verwendet, sind die folgenden Konfigurationsdetails weiterhin für die Wartung und Migrationsüberprüfung nützlich. Wenn Ihr Team einen neuen Standard-Programmierassistenten auswählt, überprüfen Sie zuerst den Status der Erweiterung, des Marktplatzes und des Forks, bevor Sie Roo Code einer größeren Gruppe zuweisen.
Die Anbieterseite für Roo Code OpenAI Compatible dokumentiert drei Hauptwerte für diese Anbieterklasse: Basis-URL, API-Schlüssel und Modell-ID. Dort steht auch, dass OpenAI Compatible als API-Anbieter ausgewählt werden soll. Die Basis-URL ist der Anbieter-Endpunkt und ausdrücklich nicht die offizielle OpenAI-API-URL, wenn Sie einen nicht mit OpenAI kompatiblen Anbieter verwenden.
Die wichtige Roo-spezifische Einschränkung ist der Tool-Aufruf. Auf derselben Anbieterseite steht, dass Roo Code ausschließlich native Tool-Aufrufe verwendet und kein XML-basiertes Fallback hat. Dort steht auch, dass das ausgewählte Modell OpenAI-kompatible Tool-Aufrufe unterstützen muss. Für eine Route der Roo Code OpenAI-kompatiblen API durch Flatkey bedeutet das, dass der Modell-Alias nicht allein durch die Generierung von einfachem Text validiert werden kann.
Flatkey-Werte, die vor dem Öffnen von Roo Code zu bestätigen sind
1. Bestätigen Sie die Basis-URL für Ihr Konto
Die am 29. Juni 2026 überprüfte Homepage von Flatkey hat den Titel One API gateway for production AI teams und eine Meta-Beschreibung, die besagt, dass Flatkey den Modellzugriff, das Routing, die Abrechnung, die Nutzungsanalyse und die Betriebskontrollen vereinheitlicht. Öffentliche Beispiele auf der Homepage umfassen Chat-Vervollständigungen im OpenAI-Stil. Eine authentifizierte Laufzeitprüfung für diesen Artikel verwendete https://router.flatkey.ai/v1 und gab eine gültige Modellliste zurück.
Da öffentliche Beispiele und kontospezifische Routen sich im Laufe der Zeit ändern können, kopieren Sie die aktuelle Flatkey-Basis-URL vor der Produktion aus Ihrer Konsole, Ihren Dokumenten oder Ihrer Arbeitsumgebung. In Roo Code sollte die Basis-URL die Anbieterbasis sein, nicht /v1/chat/completions.
2. Bestätigen Sie den Modell-Alias und die Tool-Unterstützung
Auf der am 29. Juni 2026 überprüften Preisseite von Flatkey heißt es, dass serverseitig gerenderte Preise für 635 KI-Modelle von 23 Anbietern veröffentlicht werden. Die Endpunkt-Map umfasst /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations und /v1/video/generations. Dies ist ein Nachweis für den Katalog und die Endpunkte, aber keine Garantie dafür, dass jeder Flatkey-Schlüssel jedes Modell aufrufen kann.
Wählen Sie für eine Roo Code OpenAI-kompatible API-Einrichtung einen für das Konto sichtbaren Modell-Alias, der OpenAI-kompatible Chat- und Tool-Aufrufe unterstützt. Die authentifizierte Überprüfung für diesen Artikel ergab 56 für das Konto sichtbare Modelle, und eine winzige Tool-Aufruf-Anfrage mit gpt-5.4-mini gab HTTP 200 mit finish_reason: tool_calls und Nutzungsmetadaten zurück. Betrachten Sie dies als veralteten Routennachweis für das getestete Konto, nicht als dauerhafte Empfehlung für jeden Flatkey-Workspace.
3. Schlüsselbesitz und Nutzungsüberprüfung bestätigen
Roo Code kann auf einen Code-Workspace einwirken, daher ist der Schlüsselbesitz wichtig. Verwenden Sie einen Flatkey-Schlüssel, der auf den Entwickler, das Team oder die Umgebung beschränkt ist, die das Risiko trägt. Dokumentieren Sie, wer den Schlüssel rotieren kann, welcher Modell-Alias zulässig ist, welche Endpunkt-Familie erwartet wird und wo das Nutzungsprotokoll nach dem ersten Prompt überprüft wird.
Schritt-für-Schritt: Roo Code mit Flatkey konfigurieren
- Prüfen Sie, ob es sich um eine bestehende Roo Code-Installation handelt. Da die offizielle Dokumentation derzeit die Abschaltung der Erweiterung erwähnt, gehen Sie nicht davon aus, dass eine neue Installation aus dem Marketplace verfügbar ist.
- Öffnen Sie die Anbieter-Einstellungen von Roo Code. Gehen Sie in der bestehenden Erweiterungskonfiguration zum Bereich für den Modellanbieter oder die API-Konfiguration.
- Wählen Sie OpenAI Compatible. Verwenden Sie den von Roo Code dokumentierten Anbietertyp für nicht-OpenAI-kompatible Endpunkte.
- Basis-URL festlegen. Geben Sie die verifizierte Flatkey-Basis-URL ein, zum Beispiel
https://router.flatkey.ai/v1, wenn dies der aktuell funktionierende Wert für Ihr Konto ist. - Fügen Sie den Flatkey-API-Schlüssel ein. Halten Sie ihn von Repository-Dateien, Issue-Kommentaren, Screenshots und Prompts fern.
- Modell-ID festlegen. Geben Sie den exakten Flatkey-Modell-Alias ein. Verwenden Sie keinen generischen Namen einer Anbieterfamilie, es sei denn, Flatkey stellt genau diesen Alias für Ihren Schlüssel bereit.
- Führen Sie den nachstehenden curl-Preflight-Check aus. Ein einfacher Chat ist nützlich, aber Roo Code erfordert native Tool-Aufrufe, also fügen Sie ein Tool-Schema in den Test ein.
- Führen Sie einen sicheren Roo Code-Prompt aus. Verwenden Sie einen Wegwerf-Workspace oder eine nicht-destruktive Aufgabe, bevor Sie Roo Code auf Produktions-Repositories anwenden.
- Überprüfen Sie die Flatkey-Nutzung. Bestätigen Sie Zeitstempel, Schlüsselbesitzer, Modell-Alias, Token-Verbrauch, Status und Kostentransparenz.
- Dokumentieren Sie das Rollback. Speichern Sie die vorherigen Anbieter-Einstellungen, den Modell-Alias und den Besitzer, bevor Sie weitere Entwickler bitten, umzusteigen.
Vorlage für den Preflight-Check nativer Tool-Aufrufe
Der sicherste Weg, eine Roo Code OpenAI-kompatible API-Einrichtung zu debuggen, besteht darin, die Flatkey-Route zuerst außerhalb von Roo Code zu testen. Diese Vorlage verifiziert den Chat-Endpunkt und fordert das Modell auf, einen Tool-Aufruf im OpenAI-Stil zurückzugeben.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://router.flatkey.ai/v1"
export FLATKEY_ROO_MODEL="replace-with-tool-capable-flatkey-model"
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_ROO_MODEL"'",
"messages": [
{
"role": "user",
"content": "Rufe route_check mit dem Status ok auf und füge keine Prosa hinzu."
}
],
"tools": [
{
"type": "function",
"function": {
"name": "route_check",
"description": "Gibt den Status des Routing-Smoke-Tests zurück.",
"parameters": {
"type": "object",
"properties": {
"status": { "type": "string" }
},
"required": ["status"]
}
}
}
],
"tool_choice": {
"type": "function",
"function": { "name": "route_check" }
},
"max_tokens": 64
}'Eine fehlerfreie Antwort sollte eine Assistentennachricht mit tool_calls enthalten. Wenn diese Anfrage fehlschlägt, korrigieren Sie den Flatkey-Schlüssel, die Basis-URL, den Modell-Alias oder die Modellfähigkeit, bevor Sie die Roo Code-Einstellungen ändern. Wenn sie erfolgreich ist, aber Roo Code fehlschlägt, konzentrieren Sie sich auf die gespeicherten Roo Code-Felder, den lokalen Netzwerkzugriff, den Zustand der Erweiterung oder die exakte Modell-ID, die in den Anbieter-Einstellungen eingegeben wurde.
Fehlermodi, die zuerst zu debuggen sind
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Ungültiger API-Schlüssel | Der Schlüssel wurde falsch kopiert, rotiert, auf eine andere Umgebung beschränkt oder gehört zu einem Upstream-Anbieter anstelle von Flatkey. | Verwenden Sie einen neuen Flatkey-Schlüssel, testen Sie ihn mit curl und fügen Sie denselben Schlüssel dann in Roo Code ein. |
| Verbindungsfehler | Falsche Basis-URL, der vollständige Endpunktpfad wurde in das Feld für die Basis-URL eingefügt, blockierter Netzwerkpfad oder lokales Proxy-Problem. | Überprüfen Sie die Basis-URL des Anbieters vom selben Computer aus und testen Sie /chat/completions erneut. |
| Modell nicht gefunden | Die Roo Code Modell-ID stimmt nicht mit einem für den Schlüssel aktivierten Flatkey-Alias überein. | Kopieren Sie den genauen Alias aus der Flatkey-Preisliste, dem Katalog oder der im Konto sichtbaren Modellliste. |
| Fehler beim Tool-Aufruf | Das ausgewählte Modell kann Chats beantworten, unterstützt aber keine OpenAI-kompatiblen nativen Tool-Aufrufe. | Wechseln Sie zu einem tool-fähigen Modell-Alias und führen Sie den Preflight-Check erneut aus, bevor Sie Roo Code verwenden. |
| Erweiterung nicht verfügbar | Der aktuelle Distributionsstatus von Roo Code unterstützt den geplanten Installations- oder Update-Pfad nicht. | Behandeln Sie das Setup als Legacy-Wartung und wählen Sie einen aktiven Coding-Agent-Workflow für neue Rollouts. |
| Nutzung kann nicht abgeglichen werden | Das Team hat den Schlüsselbesitzer, den Modell-Alias, den Roo Code-Benutzer, die Umgebung oder den Zeitstempel nicht aufgezeichnet. | Fügen Sie eine Runbook-Zeile hinzu, bevor Sie die Route auf weitere Entwickler ausweiten. |
Bestehende Installation oder neuer Standard?
Die Route über die Roo Code OpenAI-kompatible API kann nützlich sein, aber die Ankündigung zur Einstellung der Erweiterung ändert die Entscheidung. Verwenden Sie diese Tabelle, bevor Sie ein Team bitten, sich darauf zu verlassen.
| Situation | Empfohlene Maßnahme | Warum es wichtig ist |
|---|---|---|
| Bestehende Roo Code-Installation, die noch von einem Entwickler verwendet wird | Dokumentieren Sie die Flatkey-Route, testen Sie Tool-Aufrufe und behalten Sie die Rollback-Möglichkeit bei. | Die Wartung kann fortgesetzt werden, während das Team die Migration oder den Ersatz plant. |
| Neues teamweites Rollout eines Coding-Agents | Überprüfen Sie zuerst die aktuelle Verfügbarkeit der Erweiterung und vergleichen Sie dann aktive Alternativen. | Eine eingestellte Erweiterung kann Risiken für Support, Sicherheit und Onboarding schaffen. |
| Standardisierung des Tool-Integrationsclusters | Verwenden Sie denselben Flatkey-Schlüssel, dieselbe Basis-URL, denselben Modell-Alias und dasselbe Nutzungsprotokollmuster für alle Tools. | Konsistenz erleichtert die Abrechnung, das Debugging und die Überprüfung der Beschaffung. |
Produktions-Runbook für Roo Code plus Flatkey
Bevor weitere Entwickler die Route über die Roo Code OpenAI-kompatible API nutzen, halten Sie die betrieblichen Fakten schriftlich fest, die Support und Kostenüberprüfung ermöglichen.
| Runbook-Feld | Dies aufzeichnen |
|---|---|
| Roo Code-Umfang | Bestehende lokale Installation, Team-Image, archiviertes Profil oder reiner Migrationstest. |
| Flatkey-Schlüssel | Besitzer, Umgebung, Rotationsdatum und Widerrufsbesitzer. |
| Basis-URL | Die genaue Basis-URL des Anbieters, die in Roo Code gespeichert ist, und das Datum der Überprüfung. |
| Modell-Alias | Roo Code Modell-ID, Flatkey-Modell-Alias, Endpunktfamilie und Ergebnis des nativen Tool-Aufrufs. |
| Smoke-Test | HTTP-Status, Beendigungsgrund, Gesamtnutzung und ob tool_calls erschienen sind. |
| Nutzungsüberprüfung | Wo Plattform- und Finanzverantwortliche das Anfragevolumen, die Kosten und unerwartete Modelländerungen überprüfen. |
| Rollback | Vorherige Anbieterkonfiguration, vorheriger Modell-Alias und wer ihn wiederherstellen kann. |
Interner Migrationspfad
Wenn Ihr Team OpenAI-kompatible Tool-Konfigurationen auf Flatkey standardisiert, halten Sie dieses Setup mit dem Rest des Integrationsclusters abgestimmt. Verwenden Sie den Migrationsleitfaden für OpenAI-kompatible APIs als Basis-URL und Rollback-Hub. Für ein anderes Desktop-Client-Muster vergleichen Sie den Einrichtungsleitfaden für die Cherry Studio API. Für das Routing von Coding-Agents auf Entwicklerrechnern lesen Sie den Leitfaden für cc-switch Claude Code.
Nachdem der erste sichere Roo Code-Prompt funktioniert, überprüfen Sie die aktuelle Preisseite für Flatkey-Modelle und holen Sie sich dann einen Schlüssel für jeden separaten Benutzer, jedes Team oder jede Umgebungsgrenze.
FAQ
Unterstützt Roo Code noch OpenAI-kompatible Anbieter?
Die Dokumentation für den Roo Code OpenAI Compatible-Anbieter beschreibt weiterhin die Anbieterfelder: API-Anbieter, Basis-URL, API-Schlüssel und Modell-ID. Auf der Startseite der Dokumentation steht auch, dass die Roo Code-Erweiterung am 15. Mai 2026 eingestellt wurde. Überprüfen Sie also Ihren Installationspfad vor einem neuen Rollout.
Welche Basis-URL sollte ich für den Roo Code OpenAI-kompatiblen API-Anbieter verwenden?
Verwenden Sie die aktuelle Flatkey-Anbieter-Basis-URL für Ihr Konto. Die authentifizierten Flatkey-Prüfungen in diesem Artikel verwendeten https://router.flatkey.ai/v1, während sich öffentliche Beispiele ändern können. Fügen Sie in Roo Code nur die Basis-URL ein, nicht den vollständigen Chat-Completions-Endpunkt.
Warum ist der native Tool-Aufruf erforderlich?
Die Anbieterdokumentation von Roo Code besagt, dass der native Tool-Aufruf das einzige unterstützte Tool-Protokoll für OpenAI-kompatible Anbieter ist. Ein Modell, das einfache Chat-Anfragen beantworten, aber keine Tool-Aufrufe im OpenAI-Stil erzeugen kann, ist für eine zuverlässige Roo Code-Einrichtung nicht ausreichend.
Sollte die Modell-ID exakt mit dem Flatkey-Modellalias übereinstimmen?
Ja. Verwenden Sie den exakten Flatkey-Alias, den Ihr Schlüssel aufrufen kann, und überprüfen Sie ihn mit einem Smoke-Test für Tool-Aufrufe. Die Namen von Modellfamilien, Marketingnamen von Anbietern und Gateway-Aliase können sich unterscheiden.
Kann ich diese Anleitung für neue Roo Code-Bereitstellungen verwenden?
Verwenden Sie sie erst, nachdem Sie die aktuelle Verfügbarkeit von Roo Code überprüft haben. Die Flatkey-Routing-Prüfungen sind weiterhin nützlich, aber die Ankündigung zur Einstellung von Roo Code bedeutet, dass neue teamweite Bereitstellungen eine explizite Entscheidung des Produktsupports erfordern.
Fazit
Eine sichere Einrichtung der Roo Code OpenAI-kompatiblen API über Flatkey sollte mehr als nur eine erfolgreiche Chat-Antwort nachweisen. Bestätigen Sie die aktuelle Basis-URL, verwenden Sie einen Flatkey-eigenen Schlüssel, wählen Sie einen exakten Modellalias, testen Sie native Tool-Aufrufe und überprüfen Sie die Sichtbarkeit der Nutzung, bevor Sie Roo Code Zugriff auf echte Code-Arbeit geben. Wenn die Route für einen anderen Benutzer oder eine andere Umgebung bereit ist, holen Sie sich einen Schlüssel und bewahren Sie die Rollback-Zeile neben den Einrichtungsanweisungen auf.
