Coding Agents einrichten

Crush einrichten: API Key, Base URL und Modelle

Crush installieren und BetterToken in crushrc mit API Key und Base URL einrichten. Modell auswählen und den Fehler No providers configured beheben.

Verbinde Crush über einen openai-compat-Provider in crushrc mit BetterToken. In einem macOS-Test mit einem GPT-Modell verarbeitete Crush 0.98.2 alle drei Textanfragen nach einem Kaltstart sowie einen Datei-Leseaufruf über /v1/chat/completions.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key, über `--api-key` übergeben
Base URL	`https://bettertoken.ai/v1`, über `--base-url` übergeben
Modell	`bettertoken/YOUR_MODEL_ID`
Anbietertyp	`openai-compat`
Konfigurationsdatei	`~/.config/crush/crushrc`

Voraussetzungen

Homebrew für den folgenden Installationsbefehl
Ein BetterToken API Key: Registrieren und Key erhalten
Eine Model ID und das dazugehörige Kontextlimit aus der model plaza

Installation

Verwende den Homebrew-Befehl aus dem offiziellen Crush-Repository:

brew install charmbracelet/tap/crush
crush --version

Manuelle Einrichtung

Setze deinen BetterToken API Key im Terminal, in dem Crush ausgeführt wird:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Erstelle ~/.config/crush/crushrc im empfohlenen Bash-Konfigurationsformat. Ersetze jedes YOUR_MODEL_ID und setze --context-window auf das dokumentierte Limit des gewählten Modells. 128000 im Beispiel ist eine Client-Angabe und kein bestätigtes BetterToken-Modelllimit.

provider add bettertoken --type openai-compat --base-url "https://bettertoken.ai/v1" --api-key "$BETTERTOKEN_API_KEY"
model add bettertoken/YOUR_MODEL_ID --name "YOUR_MODEL_ID" --context-window 128000
model large bettertoken/YOUR_MODEL_ID
model small bettertoken/YOUR_MODEL_ID
permissions allow view

Speichere diese Befehle in crushrc; Crush führt sie beim Start aus. permissions allow view erlaubt das Datei-Anzeige-Tool. Das ältere JSON-Konfigurationsformat gilt upstream als veraltet, funktioniert aber weiterhin; auch seine Textanfrage war im Test erfolgreich.

Verbindung prüfen

Führe den Befehl im selben Terminal aus deinem Projekt heraus aus:

crush run "Reply with only: OK"

Prüfe, ob die finale Antwort OK lautet. Teste den Dateizugriff, indem du Crush eine bekannte Datei in deinem Projekt lesen lässt. Prüfe das Ergebnis des view-Tools und die finale Antwort.

Modell wechseln

Füge mit model add ein weiteres Modell hinzu, aktualisiere die Auswahl für model large und model small in crushrc und starte einen neuen Lauf.

Häufige Fehler

Symptom	Prüfung
`No providers configured`	Crush meldet dies vor dem Senden einer Anfrage, wenn kein verwendbarer Provider geladen ist. Prüfe Speicherort und Inhalt von `crushrc`, einschließlich einer Projektkonfiguration, die die Datei überschreiben kann.
`401`	Exportiere `BETTERTOKEN_API_KEY` vor dem Start von Crush und prüfe den Wert.
Keine expliziten Modelle in der Konfiguration	Mit einem allein konfigurierten Provider entdeckte Crush im Test Modelle über `/v1/models`. Explizite `model add`-Einträge legen fest, welches Modell dieses Beispiel verwendet.
Dateizugriff erfordert Genehmigung	Prüfe `permissions allow view` in der geladenen Konfiguration.

Weiterführende Links

Technische Details

Der getestete openai-compat-Provider sendete Generierungsanfragen an /v1/chat/completions. Wenn explizite Modelle fehlten, erfolgte die Modellerkennung über /v1/models.