Skip to main content
Roo Code kommuniziert mit Modellen über Anbieterprofile, die Sie in seinem Einstellungspanel konfigurieren. Fügen Sie einen OpenAI Compatible-Anbieter hinzu, legen Sie den Base URL auf https://api.tokios.com/v1 fest, den API Key auf Ihren sk-tok-…-Schlüssel und den Model ID auf den in der Tokios-Konsole registrierten Deployment-Namen. Roo Code sendet dann Anfragen an Ihr lokales Modell über den Connector, unabhängig davon, wo sich dieser Rechner befindet.

​
Voraussetzungen

  • Ein laufender Tokios-Connector, der mit Ihrem lokalen Modell gekoppelt ist — siehe Connector Install
  • Ein registrierter Modell-Deployment-Name — siehe Register a Model
  • Ein Tokios API-Schlüssel (sk-tok-…) — siehe API Keys
  • Die Roo Code-Erweiterung ist in VS Code installiert

​
Konfigurieren Sie den OpenAI-kompatiblen Anbieter

1

Öffnen Sie die Anbieter-Einstellungen von Roo Code

Öffnen Sie das Roo Code-Panel in VS Code und gehen Sie zu dessen Einstellungen. Wählen Sie OpenAI Compatible als API-Anbieter.
2

Legen Sie die Basis-URL fest

Legen Sie Base URL fest auf:
3

Fügen Sie Ihren API-Schlüssel hinzu

Fügen Sie Ihren sk-tok-…-Schlüssel in das API Key-Feld ein. Roo Code sendet ihn bei jeder Anfrage als Bearer-Token.
4

Legen Sie die Modell-ID fest

Legen Sie Model ID auf den öffentlichen Bereitstellungsname fest, den Sie im Models-Tab registriert haben — zum Beispiel gemma-tunnel. Dies ist nicht die lokale Modell-ID, die Ihr Backend (Ollama, llama.cpp, vLLM oder LM Studio) verwendet.
Ersetzen Sie gemma-tunnel durch Ihren eigenen Bereitstellungsname und sk-tok-YOUR_KEY durch Ihren eigenen Schlüssel. Übertragen Sie niemals eines von beiden in eine freigegebene Konfigurationsdatei.

​
Wählen Sie ein Modell, das Tool-Aufrufe unterstützt

Roo Code ist auf native Tool-Aufrufe angewiesen, um Dateien zu lesen, Befehle auszuführen und Änderungen in Ihrem Projekt anzuwenden. Wenn das zugrunde liegende Modell keine nativen Tool-Aufrufe unterstützt, kann Roo Code seine Antworten nicht in Tool-Aktionen parsen — es wiederholt stattdessen und bleibt in einer Schleife, anstatt Fortschritte zu erzielen. Tokios leitet die Tool-Aufruf-Struktur in einer Anfrage direkt an Ihr Backend weiter; ob Tool-Aufrufe tatsächlich funktionieren, hängt ausschließlich vom Modell ab, das Sie ausführen, nicht von Tokios oder dem Connector. Bevor Sie sich für echte Arbeiten auf Roo Code verlassen, bestätigen Sie, dass Ihre Bereitstellung von einem Modell mit nativer Tool-Aufruf-Unterstützung gestützt wird. Siehe Wählen Sie ein lokales Modell für Informationen zum Vergleichen von Modellen für Agenten-Workloads.
Ein Modell ohne native Tool-Aufrufe funktioniert nicht mit Roo Code, auch wenn es für einfaches Chatting über dieselbe Bereitstellung gut funktionieren mag. Wenn Roo Code scheinbar beim Wiederholen desselben Schritts stecken bleibt, ist dies das Erste, was Sie überprüfen sollten.

​
Fehlerbehebung

Der von Roo Code gesendete API-Schlüssel fehlt, ist fehlerhaft formatiert oder wurde widerrufen. Stellen Sie sicher, dass Sie den vollständigen sk-tok-…-Schlüssel ohne zusätzliche Leerzeichen eingefügt haben, und überprüfen Sie seinen Status auf der Keys-Registerkarte.
Der Schlüssel ist gültig, aber nicht für die Bereitstellung in Model ID freigegeben, oder das Konto ist gesperrt. Überprüfen Sie die zulässigen Modellmuster des Schlüssels auf der Keys-Registerkarte.
Der Model ID-Wert stimmt mit keiner registrierten Bereitstellung überein. Stellen Sie sicher, dass er exakt mit dem öffentlichen Namen auf der Models-Registerkarte übereinstimmt — nicht mit Ihrer lokalen Modell-ID von Ollama/llama.cpp/vLLM/LM Studio.
Der Connector für diese Bereitstellung ist offline oder hat sein gleichzeitiges Verarbeitungslimit erreicht. Überprüfen Sie die Connectors-Registerkarte — der Connector muss als Online angezeigt werden.
Dies ist normalerweise kein Tokios-Fehler — es ist ein Zeichen dafür, dass das Modell hinter Ihrer Bereitstellung keine native Tool-Aufrufe unterstützt. Siehe Wählen Sie ein Modell, das Tool-Aufrufe unterstützt oben.

​
Nächste Schritte

Wählen Sie ein lokales Modell

Vergleichen Sie Modelle und Backends für Coding-Agent-Workloads wie Roo Code.

Kompatible Clients

Siehe Basis-URL- und Schlüsselkonfiguration für andere OpenAI- und Anthropic-kompatible Clients.