Crush + JoinGonka Gateway: Charm-Agent auf Modellen des Gonka-Netzwerks

Schritt 1: Crush installieren. Die offiziellen Wege aus der README des Projekts:

# Homebrew
brew install charmbracelet/tap/crush

# npm
npm install -g @charmland/crush

# Arch Linux
yay -S crush-bin

# Windows
winget install charmbracelet.crush

# Go
go install github.com/charmbracelet/crush@latest

Dort sind auch die Paket-Repositories für Debian, Ubuntu, Fedora und RHEL, Nix und Scoop beschrieben, und auf der Release-Seite liegen fertige Binaries. Zur Überprüfung — crush --version, als Antwort kommt eine Zeile wie crush version v0.96.1.

Schritt 2: Schlüssel holen. Registriere dich auf gate.joingonka.ai/register, bestätige die Adresse und erstelle einen Schlüssel mit dem Präfix jg- im Bereich „API-Schlüssel“. Ein Schlüssel und ein Guthaben gelten für alle Modelle des Netzwerks.

Schritt 3: Installer starten.

npx @joingonka/setup --tool crush

Der Installer fragt nach dem Schlüssel — er wird nicht als Kommandozeilenargument übergeben, damit er nicht in der Shell-History landet — und erledigt vier Dinge:

• Er trägt den Anbieter joingonka in ~/.config/crush/crush.json ein: Typ openai-compat, Gateway-Adresse, Schlüssel als Literal und drei Modelle des Netzwerks mit Kontextfenstern, Antwort-Obergrenzen und Preisen pro Million Token, die er zum Installationszeitpunkt live vom Gateway bezieht — daraus berechnet Crush die Kosten der Sitzung. Die Datei erhält die Rechte 600;
• Er weist die Modelle zu: im Slot large — DeepSeek V4 Flash, im small — MiniMax M2.7, während GLM-5.3 Flash in der Liste für die manuelle Auswahl bleibt. Das tut er nur, wenn der Slot large leer ist oder auf unser Modell zeigt, das aus dem Netzwerk entfernt wurde; eine fremde Auswahl bleibt bestehen, und in der Ausgabe erscheint ein Hinweis, wie man umschaltet;
• Er prüft, dass die Auswahl wirksam wird: Das Modell aus der Crush-Oberfläche wird in der Statusdatei gehalten, und diese überschreibt die Konfiguration — dazu der Abschnitt über large und small;
• Er erstellt eine Sicherungskopie, lässt die übrigen Anbieter und Einstellungen unverändert und schließt mit einer Live-Anfrage an das Gateway ab, um Schlüssel, Adresse und Modell sofort zu testen.

Ein anderes Modell legt das Flag --model mit der Abkürzung deepseek, glm oder minimax fest; ein explizit angegebenes Modell wird immer geschrieben. Nicht standardmäßige Verzeichnisse berücksichtigt der Installer genauso wie Crush selbst: CRUSH_GLOBAL_CONFIG für die Konfiguration, CRUSH_GLOBAL_DATA für die Statusdatei sowie XDG_CONFIG_HOME und XDG_DATA_HOME. Für Server und Skripte gibt es einen Modus ohne Rückfragen, in dem der Schlüssel aus einer Umgebungsvariable stammt:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool crush --model glm --non-interactive

Das Hauptformat von Crush ist inzwischen crushrc, doch der Installer schreibt crush.json: Das verstehen alle Versionen. Wenn du bereits eine crushrc hast, führt Crush beide Dateien zusammen, bei übereinstimmenden Schlüsseln gewinnt crushrc, und der Installer rührt sie nicht an.

Alles, was das Installationsprogramm tut, lässt sich auch von Hand schreiben. Hier eine funktionierende ~/.config/crush/crush.json — diese Datei haben wir durch das Gateway geschickt:

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "joingonka": {
      "name": "JoinGonka (Gonka)",
      "type": "openai-compat",
      "base_url": "https://gate.joingonka.ai/v1",
      "api_key": "jg-your-key",
      "models": [
        { "id": "deepseek-ai/DeepSeek-V4-Flash-0731", "name": "DeepSeek V4 Flash (Gonka)",
          "context_window": 380000, "default_max_tokens": 32768,
          "can_reason": true, "supports_attachments": false },
        { "id": "MiniMaxAI/MiniMax-M2.7", "name": "MiniMax M2.7 (Gonka)",
          "context_window": 200000, "default_max_tokens": 8192,
          "can_reason": false, "supports_attachments": false },
        { "id": "zai-org/GLM-5.3-Flash", "name": "GLM-5.3 Flash (Gonka)",
          "context_window": 390000, "default_max_tokens": 8192,
          "can_reason": true, "supports_attachments": false }
      ]
    }
  },
  "models": {
    "large": { "provider": "joingonka", "model": "deepseek-ai/DeepSeek-V4-Flash-0731" },
    "small": { "provider": "joingonka", "model": "MiniMaxAI/MiniMax-M2.7" }
  }
}

Crush akzeptiert nur striktes JSON: ein Kommentar oder ein hängendes Komma — und es startet nicht. Die Preisfelder (cost_per_1m_in, cost_per_1m_out und zwei Felder für den Cache) braucht nur der Kosten-Zähler: das Installationsprogramm trägt dort den aktuellen Preis des Gateways ein; ohne sie läuft Crush trotzdem und zeigt Null an — nur der Editor mit dem Schema aus $schema markiert sie als Pflichtfelder.

Derselbe Anbieter im crushrc-Format — das ist gewöhnliches Bash mit den eingebauten Crush-Befehlen. Die Datei ~/.config/crush/crushrc:

provider add joingonka \
  --name "JoinGonka (Gonka)" \
  --type openai-compat \
  --base-url "https://gate.joingonka.ai/v1" \
  --api-key "${JOINGONKA_API_KEY:?set JOINGONKA_API_KEY}"

model add joingonka/deepseek-ai/DeepSeek-V4-Flash-0731 \
  --name "DeepSeek V4 Flash (Gonka)" \
  --context-window 380000 --default-max-tokens 32768 --can-reason true

model add joingonka/MiniMaxAI/MiniMax-M2.7 \
  --name "MiniMax M2.7 (Gonka)" \
  --context-window 200000 --default-max-tokens 8192

model add joingonka/zai-org/GLM-5.3-Flash \
  --name "GLM-5.3 Flash (Gonka)" \
  --context-window 390000 --default-max-tokens 8192 --can-reason true

model large joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
model small joingonka/MiniMaxAI/MiniMax-M2.7

Das Modell wird hier in der Form provider/model-id angegeben: vor dem ersten Schrägstrich der Name des Anbieters, danach die Netzwerk-ID unverändert. Die Form ${JOINGONKA_API_KEY:?…} hält den Schlüssel aus der Datei heraus, doch ohne exportierte Variable startet Crush nicht — ein Fehler beim Start ist besser als Anfragen mit leerem Schlüssel.

In Crush wird nicht ein einziges Modell für alles ausgewählt, sondern jeweils eines für zwei Slots:

Das dritte Modell im Netzwerk, das schlussfolgernde GLM-5.3 Flash, wird für komplexe Logik gewählt, wobei zu beachten ist, dass sein Antwortlimit 8192 beträgt und ein Teil davon für den Schlussfolgerungsprozess reserviert ist – Details dazu im Modell-Review. Für einen einzelnen Start wird das Modell mit seinem vollständigen Namen angegeben: crush run -m joingonka/zai-org/GLM-5.3-Flash "…". Alle verfügbaren Namen werden durch crush models joingonka ausgegeben.

Statusdatei. Das Modell, das im Interface über ctrl+l ausgewählt wurde, speichert Crush nicht in crush.json, sondern in einer maschinellen Statusdatei: ~/.local/share/crush/crush.json, unter Windows %LOCALAPPDATA%\crush\crush.json. Diese Datei hat Vorrang vor der Benutzerkonfiguration und der crushrc: Crush liest sie in der Reihenfolge /etc/crush/crush.json → ~/.config/crush/crush.json → ~/.config/crush/crushrc → Statusdatei, wobei jeder nachfolgende Eintrag den vorherigen überschreibt. Höher priorisiert sind nur Projekteinstellungen – crush.json oder crushrc im jeweiligen Projektverzeichnis. Wo die Dateien auf Ihrem System liegen, zeigt crush dirs an.

In unserem Testdurchlauf haben wir die Modellauswahl geöffnet – der Provider „JoinGonka (Gonka)“ ist dort mit dem Status „✓ Configured“ markiert – und MiniMax M2.7 ausgewählt. Crush antwortete mit „Large model changed to MiniMax M2.7 (Gonka)“ und schrieb in die Statusdatei:

{"models":{"large":{"model":"MiniMaxAI/MiniMax-M2.7","provider":"joingonka","max_tokens":8192}}, …}

Nun hat dieses Modell Vorrang gegenüber dem, was in crush.json steht. Das Installationsprogramm erkennt diese Situation und verhält sich unterschiedlich:

• ohne --model: Die Statusdatei wird nicht geändert – dies ist Ihre aktive Wahl –, aber es erfolgt eine direkte Warnung, mit welchem Modell Crush tatsächlich gestartet wird: Heads-up: Crush will still start with joingonka/MiniMaxAI/MiniMax-M2.7, not joingonka/deepseek-ai/DeepSeek-V4-Flash-0731. Das gleiche passiert, wenn im Interface GLM-5.3 Flash oder das Modell eines anderen Providers ausgewählt ist;
• mit explizitem --model: Es wird genau ein Eintrag in der Statusdatei korrigiert – models.large –, nachdem eine Sicherungskopie erstellt wurde, und es wird dokumentiert, was vorher war und was neu ist. Andernfalls würde das Flag wirkungslos bleiben. Nach einem solchen Start wurde Crush in unserem Durchlauf mit dem im Flag angegebenen Modell geöffnet.

Stellen Sie zunächst sicher, dass Crush den Anbieter sieht:

crush models joingonka

Zur Antwort kommen drei Zeilen:

joingonka/MiniMaxAI/MiniMax-M2.7
joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
joingonka/zai-org/GLM-5.3-Flash

Dann ein einmaliger Durchlauf ohne Oberfläche. Legen Sie eine Datei mit einem offensichtlichen Fehler in das Projektverzeichnis und bitten Sie darum, ihn zu finden:

crush run -q "Read calc.py and tell me in one sentence whether it has a bug."

Der Agent soll selbst das Datei-Lesetool aufrufen und sachlich antworten, mit Zeilennummer. In unserem Durchlauf fanden alle drei Modelle des Netzwerks den Fehler, die Aufgabe dauerte 20-40 Sekunden. Das Flag -q verbirgt den Warteindikator. Im Modus crush run werden alle Tool-Aufrufe automatisch genehmigt, starten Sie ihn also in Ihrem Projekt. In der normalen Oberfläche (Befehl crush) ist das aktive Modell in der Statuszeile sichtbar: ◇ DeepSeek V4 Flash (Gonka) via JoinGonka (Gonka). Sitzungen und das Protokoll speichert Crush im Verzeichnis .crush des Projekts, das durch eine eigene .gitignore vor git geschützt ist; das Protokoll gibt crush logs aus. Von der Seite des Gateways ist die Anfrage im Konto sichtbar: Bereich „Nutzung“, Aufschlüsselung „Nach Modellen“ und „Nach Schlüsseln“.

Wenn etwas schiefgelaufen ist, lässt sich die Diagnose meist direkt aus der Meldung ablesen:

Ein Agent verbraucht Token anders als ein Chat: Crush fügt jeder Ihrer Phrasen einen System-Prompt und Beschreibungen seiner Tools hinzu, und eine Aufgabe erfordert normalerweise mehrere Schritte. In unserem Testlauf enthielt jede Anfrage an das Modell etwa 11,5 Tausend Eingabe-Token, und die Aufgabe „Datei lesen und Fehler finden“ beanspruchte zwei bis drei Anfragen und 23-35 Tausend Token, wobei fast alles Input war. Daher ist der Preis pro Token hier entscheidend.

Über das JoinGonka Gateway kosten Token $0.0069 pro Million beim Input und $0.021 pro Million beim Output – der Preis ist für alle Netzwerk-Modelle gleich und wird auf dieser Seite aus einer Live-Quelle übernommen.

Die Schätzungen in der rechten Spalte basieren auf den Preisen vom September 2026. Zum Vergleich – wie man generell in Crush für Modelle bezahlen kann:

Der Kostenrechner im Interface von Crush basiert auf den Preisfeldern in der Konfiguration. Dort wird der Gateway-Preis zum Zeitpunkt der Installation hinterlegt; da der Dollarpreis im Netzwerk mit dem GNK-Kurs schwankt, dient der Rechner nur als Orientierung. Der genaue Verbrauch und das Guthaben finden sich im Benutzerbereich unter „Nutzung“ und „Billing“. Warum standardmäßig DeepSeek V4 Flash für den Large-Slot gewählt wird, wird ausführlich im Modell-Review erläutert.

Berechtigungen. In der Crush-Oberfläche wird standardmäßig vor dem Aufruf eines Tools um Erlaubnis gefragt. Das Flag --yolo schaltet alle Rückfragen auf einmal ab, während gezielt vertrauenswürdige Tools in der Konfiguration aufgelistet werden:

# crushrc
permissions allow view ls grep

# crush.json
"permissions": { "allowed_tools": ["view", "ls", "grep"] }

Zur Erinnerung: crush run genehmigt alles selbst. Das ist eine Eigenschaft von Crush und hängt nicht vom Modellanbieter ab.

Request-Timeout. Crush bricht eine Anfrage ab, wenn längere Zeit kein einziges Antwortfragment vom Modell eintrifft: in Version 0.96.1 sind das zwei Minuten Stille (die Dokumentation nennt 60 Sekunden, doch im Code und in unserem Test sind es zwei Minuten). Die Dienst-Pings, mit denen das Gateway die Verbindung hält, setzen diesen Zähler nicht zurück — wir haben das auf einem lokalen Teststand überprüft. Das Gateway selbst wartet zu Stoßzeiten bis zu 150 Sekunden auf das erste Token aus dem Netzwerk, daher sollte man den Puffer erhöhen:

# crushrc
option request-timeout 300

# crush.json
"options": { "request_timeout": 300 }

Signaturen in Commits. Commits und Pull Requests, die Crush erstellt, erhalten standardmäßig die Zeile Assisted-by: Crush:<model> und den Zusatz Generated with Crush. Falls das nicht gewünscht ist:

# crushrc
option attribution-trailer-style none
option attribution-generated-with false

# crush.json
"options": { "attribution": { "trailer_style": "none", "generated_with": false } }

Metriken. Crush sendet pseudonyme Nutzungsstatistiken an die Entwickler — nur Metadaten, ohne Prompts und Antworten. Deaktiviert wird das über die Variable CRUSH_DISABLE_METRICS=1 oder DO_NOT_TRACK=1. Das Gateway seinerseits speichert keine Prompt- und Antwortinhalte — in der Statistik bleiben nur Verbrauchsaggregate.

Konfiguration ist Code. Sowohl crushrc als auch crush.json führt Crush mit den Rechten Ihrer Shell aus: $(…) im Schlüsselfeld wird beim Laden ausgeführt, und das projektbezogene crushrc greift, sobald Sie Crush in diesem Verzeichnis öffnen. Starten Sie den Agenten nicht in einem fremden Repository, ohne dessen Konfigurationen gelesen zu haben.