Roo Code einrichten: API Key, Base URL und Modelle
Installiere Roo Code, konfiguriere BetterToken Base URL und API Key, wähle ein verfügbares Modell und behebe häufige Fehler. Praktische Hinweise.
Um Roo Code mit BetterToken zu verbinden, bereite einen API Key vor, trage die unten angezeigte Base URL ein und wähle eine aktuelle Model ID aus der model plaza.
Wichtige Einstellungen
| Feld | Wert |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | Eine aktuelle Model ID aus der model plaza |
Voraussetzungen
- Die aktuelle Version des Tools ist installiert
- Ein BetterToken API Key: Registriere dich und erhalte einen
- Eine Model ID aus der model plaza
Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.
Zusätzliche Anforderungen
- VS Code ist installiert
Installation
Roo Code installieren
Öffne VS Code, suche im Erweiterungs-Marktplatz nach Roo Code und installiere es.
Manuelle Einrichtung
Führe diese Einrichtung in der Roo-Code-Einstellungsoberfläche durch. Du musst keine Konfigurationsdatei bearbeiten.
| Feld | Wert |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | Eine aktuelle Model ID aus der model plaza |
Einrichtung
Konfligierende Umgebungsvariablen löschen
unset OPENAI_API_KEYunset OPENAI_BASE_URLRoo-Code-Einstellungen öffnen
Öffne den Bereich Settings von Roo Code.
API-Provider konfigurieren
Trage Folgendes ein:
- API Provider →
OpenAI Compatible - Base URL →
https://bettertoken.ai/v1 - API Key → dein BetterToken API Key
- Model → eine Model ID aus der model plaza
Zusätzliche Header nur konfigurieren, wenn die offizielle Dokumentation sie ausdrücklich verlangt
Die geprüfte offizielle Roo-Code-Dokumentation behandelt OpenAI-kompatible oder eigene API-Einrichtungen, nennt aber keinen zusätzlichen User-Agent als erforderlichen BetterToken-Schritt.
Wenn du zusätzlich ein eigenes Gateway, Tenant-Routing, Observability oder eine Caching-Schicht verwendest, füge Header nur entsprechend der offiziellen Dokumentation dieses Upstream-Dienstes hinzu.
Speichern und verwenden
Klicke auf Save und Done und wähle dann das konfigurierte Modell aus.
Roo Code neu starten
Starte nach dem Speichern der Konfiguration VS Code neu oder lade die Roo-Code-Erweiterung neu, bevor du das konfigurierte Modell auswählst.
Verbindung überprüfen
Sende eine kurze Testanweisung. Wenn das Tool ohne Authentifizierungs- oder Model-ID-Fehler antwortet, funktioniert die Verbindung. Starte das Tool nach einer Konfigurationsänderung vollständig neu.
Bitte Roo Code anschließend, eine Projektdatei zu lesen und zusammenzufassen. Prüfe, ob es das Dateilesewerkzeug tatsächlich ausführt und das Ergebnis verwendet. Eine reine Textantwort bestätigt nicht, dass Agenten-Tools funktionieren.
Modelle wechseln
Öffne die Modellauswahl oder ändere das Feld Model in der Konfiguration. Verwende die genaue Model ID aus der model plaza und starte dann die aktuelle Sitzung neu.
Häufige Fehler
| Fehler | Prüfung |
|---|---|
401 oder Unauthorized | Prüfe den BetterToken API Key und entferne vorangestellte oder nachgestellte Leerzeichen. |
404 | Prüfe die Base URL und hänge keinen bestimmten Endpunktpfad an. |
model not found | Kopiere eine aktuelle Model ID aus der model plaza. |
| Änderungen werden nicht übernommen | Speichere die Konfiguration und starte das Tool vollständig neu. |
- OpenAI-kompatible API und Anthropic-kompatible API: Unterschiede
- MCP vs API Key and Base URL
- Was sind model_provider, base_url und wire_api?
- OpenAI-kompatible API in Cline konfigurieren
- Alle unterstützten Tools vergleichen
- API-Fehler, Statuscodes und Ratenbegrenzungen
Technische Details
Protokoll, Endpunkt und interne Provider-Felder
Diese Einrichtung verwendet https://bettertoken.ai/v1. Das Tool hängt den OpenAI-kompatiblen Endpunktpfad an. Füge /chat/completions oder /responses nicht hinzu, sofern ein bestimmtes Feld dies nicht ausdrücklich verlangt.
