Zum Hauptinhalt springen
Roo Code kommuniziert mit Modellen über Anbieterprofile, die Sie in seinem Einstellungspanel konfigurieren. Fügen Sie einen Anbieter OpenAI Compatible hinzu, setzen Sie die Base URL auf https://api.tokios.com/v1, den API Key auf Ihren sk-tok-…-Schlüssel und die Model ID auf den Deployment-Namen, den Sie in der Tokios-Konsole registriert haben. 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-Installation
  • Ein registrierter Modell-Deployment-Name — siehe Modell registrieren
  • Ein Tokios-API-Schlüssel (sk-tok-…) — siehe API-Schlüssel
  • Die Roo Code-Erweiterung in VS Code installiert

Den Anbieter OpenAI Compatible konfigurieren

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

Setzen Sie Base URL auf:
3

Fügen Sie Ihren API-Schlüssel hinzu

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

Legen Sie die Modell-ID fest

Setzen Sie Model ID auf den öffentlichen Deployment-Namen, den Sie im Tab Models registriert haben — zum Beispiel gemma-tunnel. Das ist nicht die lokale Modell-ID, die Ihr Backend (Ollama, llama.cpp, vLLM oder LM Studio) verwendet.
Ersetzen Sie gemma-tunnel durch Ihren eigenen Deployment-Namen und sk-tok-YOUR_KEY durch Ihren eigenen Schlüssel. Commiten Sie niemals einen von beiden in eine freigegebene Einstellungsdatei.

Ein Modell mit Tool-Calling-Unterstützung wählen

Roo Code ist auf natives Tool-Calling 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 umwandeln — es wiederholt stattdessen und bleibt in einer Schleife hängen, anstatt Fortschritte zu erzielen. Tokios leitet die Tool-Calling-Struktur in einer Anfrage direkt an Ihr Backend weiter; ob Tool-Calling tatsächlich funktioniert, 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-Calling-Unterstützung bedient wird. Siehe Ein lokales Modell wählen für Informationen zum Vergleichen von Modellen für Agenten-Workloads.
Ein Modell ohne natives Tool-Calling funktioniert nicht mit Roo Code, auch wenn es für einfaches Chatten über dasselbe Deployment gut funktionieren mag. Wenn Roo Code scheinbar beim Wiederholen desselben Schritts hängen 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 im Tab Keys.
Der Schlüssel ist gültig, aber nicht für das Deployment in Model ID freigegeben, oder das Konto ist gesperrt. Überprüfen Sie die zulässigen Modell-Muster des Schlüssels im Tab Keys.
Der Wert Model ID stimmt mit keinem registrierten Deployment überein. Stellen Sie sicher, dass er exakt mit dem öffentlichen Namen im Tab Models übereinstimmt — nicht mit Ihrer lokalen Modell-ID von Ollama/llama.cpp/vLLM/LM Studio.
Der Connector für dieses Deployment ist offline oder hat sein Nebenläufigkeitslimit erreicht. Überprüfen Sie den Tab Connectors — 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 kein natives Tool-Calling unterstützt. Siehe Ein Modell mit Tool-Calling-Unterstützung wählen oben.

Nächste Schritte

Ein lokales Modell wählen

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

Kompatible Clients

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