Zum Inhalt springen
Kostenlos registrieren
Coding Agents einrichten

Cline einrichten: API Key, Base URL und Modelle

Installiere Cline, konfiguriere BetterToken Base URL und API Key, wähle ein kompatibles Anbietermodell und behebe häufige Fehler. Praktische Hinweise.

Um Cline mit BetterToken zu verbinden, benötigst du einen API Key. Gib die unten angegebene Base URL ein und wähle eine aktuelle Modell-ID aus dem model plaza. Ähnliche Oberflächen findest du auch bei Roo Code, Kilo Code und MonkeyCode.

Wichtige Einstellungen

FeldWert
API KeyBetterToken API Key verwenden
Base URLhttps://bettertoken.ai/v1
ModellEine aktuelle Modell-ID aus dem model plaza

Voraussetzungen

Registrieren und BetterToken API Key erhalten

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Weitere Voraussetzungen

  • VS Code ist installiert

Installation

Cline installieren

Öffne VS Code, suche im Erweiterungs-Marktplatz nach Cline und installiere die Erweiterung.

Manuelle Konfiguration

Nimm diese Einstellungen in der Cline-Oberfläche vor. Du musst keine Konfigurationsdatei bearbeiten.

FeldWert
API KeyBetterToken API Key verwenden
Base URLhttps://bettertoken.ai/v1
ModellEine aktuelle Modell-ID aus dem model plaza

Konfiguration

Widersprüchliche Umgebungsvariablen entfernen

Terminal-Fenster
unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Cline-Konfiguration öffnen

Klicke in der Cline-Seitenleiste auf Use your own API key.

API-Anbieter konfigurieren

Fülle folgende Felder aus:

  • API Provider → OpenAI Compatible
  • Base URL → https://bettertoken.ai/v1
  • API Key → dein BetterToken API Key
  • Model → eine Modell-ID eines unterstützten Anbieters aus dem model plaza

Verwende unter Model Configuration die bestätigten Kontext- und Ausgabelimits des ausgewählten Modells. Aktiviere Bild- oder Computer-Use-Funktionen nur, wenn Modell und Endpunkt sie unterstützen. Siehe die Provider-Einstellungen von Cline.

Zusätzliche Header nur bei ausdrücklicher Anforderung konfigurieren

Die offizielle Anleitung von Cline für OpenAI-kompatible Verbindungen konzentriert sich auf Base URL, API Key und Modell-ID. Für die Verbindung mit BetterToken benötigst du normalerweise keinen zusätzlichen User-Agent.

Wenn du außerdem ein eigenes Gateway, Tenant-Routing, Observability oder eine Caching-Schicht verwendest, füge Header nur gemäß der offiziellen Dokumentation dieses Upstream-Dienstes hinzu.

Konfiguration speichern

Klicke auf Done.

Cline neu starten

Starte nach dem Speichern VS Code neu oder lade die Cline-Erweiterung erneut, damit die neuen Einstellungen wirksam werden.

Verbindung prüfen

Nutze Verify in den Provider-Einstellungen, um die Verbindung zu prüfen.

Sende einen kurzen Testprompt. Wenn das Tool ohne Authentifizierungs- oder Modell-ID-Fehler antwortet, funktioniert die Verbindung. Starte das Tool nach einer Konfigurationsänderung vollständig neu.

Cline CLI

Installiere das offizielle Cline CLI getrennt von der VS-Code-Erweiterung. Im macOS-Test mit einem GPT-Modell verarbeitete Cline CLI 3.0.73 Textanfragen und Datei-Leseaufrufe.

Ersetze YOUR_API_KEY durch deinen BetterToken API Key und YOUR_MODEL_ID durch eine exakte ID aus der model plaza und melde dich an:

Terminal-Fenster
cline auth --provider openai --apikey YOUR_API_KEY --baseurl https://bettertoken.ai/v1 --modelid YOUR_MODEL_ID

Führe einen nicht-interaktiven Texttest aus:

Terminal-Fenster
cline --json --retries 2 --timeout 170 --provider openai --model YOUR_MODEL_ID "Reply with only: OK"

Prüfe, ob die finale Antwort OK enthält. Im Test wurde --provider openai als openai-compatible erfasst; der Befehlszeilenwert unterscheidet sich vom IDE-Menüeintrag OpenAI Compatible. Verwende bei --data-dir für beide Befehle dasselbe Konfigurationsverzeichnis.

Modelle wechseln

Öffne die Modellauswahl oder ändere das Feld Model in der Konfiguration. Verwende die genaue Modell-ID aus dem model plaza und starte danach die aktuelle Sitzung neu.

Häufige Fehler

FehlerPrüfen
401 oder UnauthorizedPrüfe den BetterToken API Key und entferne Leerzeichen am Anfang oder Ende.
404Prüfe die Base URL und hänge keinen bestimmten Endpunktpfad an.
model not foundKopiere eine aktuelle Modell-ID aus dem model plaza.
Änderungen werden nicht angewendetSpeichere die Konfiguration und starte das Tool vollständig neu.

Technische Details

Protokoll, Endpunkt und interne Anbieterfelder

Diese Konfiguration verwendet https://bettertoken.ai/v1. Das Tool hängt den OpenAI-kompatiblen Endpunktpfad an. Füge weder /chat/completions noch /responses hinzu, sofern ein bestimmtes Feld dies nicht ausdrücklich verlangt.