Um Crush, den Coding-Agent von Charm, zu nutzen, installierst du ihn mit brew install charmbracelet/tap/crush (oder per npm, winget und anderen Wegen), startest crush in einem Projekt, drückst Ctrl+L, wählst ein Modell, fügst einen API-Key ein oder meldest dich an und beschreibst dann die Aufgabe. Crush fragt nach, bevor es Tools ausführt, und seit Version 0.88 liegen die Einstellungen in einer crushrc-Datei statt in crush.json.
Diese Anleitung beschreibt Crush mit Stand November 2026 (Version 0.101): Installation, Anbieter und lokale Modelle, die Oberfläche, Freigaben, crush run, Sitzungen, Konfiguration, Kontextdateien, MCP und Kosten.
Was Crush ist
Crush ist ein Coding-Agent fürs Terminal von Charm, dem Team hinter Bubble Tea und anderen Terminal-Tools, und das merkt man: Die Oberfläche gehört zu den ausgefeiltesten in dieser Kategorie. Crush arbeitet mit fast jedem Modell: Anthropic, OpenAI, Gemini, OpenRouter, Groq, xAI, Bedrock, Vertex, Azure, lokale Modelle und Charms eigener Dienst Hyper. Das Modell lässt sich mitten in einer Sitzung wechseln, ohne dass der Kontext verloren geht.
Crush steht noch vor Version 1.0 und bringt etwa einmal pro Woche eine neue Minor-Version heraus, dazwischen gibt es Nightly-Builds. Die Lizenz ist FSL-1.1-MIT: Der Quellcode ist öffentlich und jede Version wird später MIT-lizenziert, heute ist es aber keine Open-Source-Lizenz im Sinne der OSI.
Schritt 1: installieren
brew install charmbracelet/tap/crush # macOS and Linux
npm install -g @charmland/crush # any platform with Node
winget install charmbracelet.crush # Windows
go install github.com/charmbracelet/crush@latest
Außerdem gibt es Pakete für Arch (yay -S crush), Nix, FreeBSD und Scoop sowie apt- und yum-Repositorys unter repo.charm.sh. Crush läuft unter macOS, Linux, Windows (PowerShell und WSL) und den BSDs.
Schritt 2: ein Modell wählen
cd my-project
crush
Drücke Ctrl+L, um die Modellauswahl zu öffnen, wähle einen Anbieter und füge dessen Key ein. Crush liest Keys auch aus der Umgebung, etwa ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY oder OPENROUTER_API_KEY. Wenn du statt eines Keys ein Abo nutzen willst, führe crush login mit copilot, openai (ein ChatGPT-Plan), grok oder hyper aus.
Für ein lokales Modell fügst du in deiner Konfiguration einen Anbieter hinzu (Schritt 6):
provider add ollama --type ollama --base-url "http://localhost:11434/v1/"
Seine Modellliste bezieht Crush aus Catwalk, einem Community-Katalog, der sich selbst aktualisiert; crush models zeigt, was verfügbar ist, und crush update-providers lädt die Liste neu.
Schritt 3: in einer Sitzung arbeiten
Beschreibe die Aufgabe in eigenen Worten. Diese Tasten lohnen sich zuerst:
Ctrl+P(oder/) öffnet die Befehlspalette: Sitzung zusammenfassen, Projekt initialisieren, MCP-Server und Skills an- oder ausschalten, Theme wechseln.Ctrl+Lwechselt das Modell;Ctrl+Nstartet eine neue Sitzung undCtrl+Slistet die Sitzungen auf.@erwähnt eine Datei;Ctrl+Ffügt eine Datei oder ein Bild hinzu;Ctrl+Vfügt ein Bild ein.Shift+Tabschaltet durch die Modi, darunter den Plan-Modus, in dem Crush die Schritte ausarbeitet, bevor es etwas ändert.Ctrl+Oöffnet deinen Editor für eine lange Nachricht;Ctrl+Gzeigt die Hilfe;Ctrl+Cbeendet Crush.
Schritt 4: Freigaben und Yolo-Modus
Crush fragt vor jedem Tool-Aufruf nach. Im Dialog erlaubt a den Aufruf einmal, s erlaubt das Tool für den Rest der Sitzung, d lehnt ab und t zeigt den Diff. Rein lesende Befehle wie ls oder git status laufen ohne Rückfrage.
Damit Crush bei Tools, denen du vertraust, nicht mehr fragt, erlaubst du sie in der Konfiguration; um ein Tool ganz auszublenden, verbietest du es:
permissions allow view ls grep edit
permissions deny bash
crush --yolo (oder -y, oder Ctrl+Y in einer Sitzung) überspringt die Rückfragen, blockiert aber weiterhin Befehle, die Crush als gefährlich einstuft. -yy schaltet den Sysadmin-Modus ein, der auch diese erlaubt. Beides gehört in Container und Wegwerf-Rechner.
Schritt 5: crush run für Einmal-Aufgaben
crush run "add a unit test for the price formatter"
git diff | crush run "review this diff for bugs"
cat README.md | crush run "tighten the wording" > README.new.md
-m wählt das Modell (provider/model), -q blendet den Spinner aus, und -s <id> oder -C setzt eine Sitzung fort. crush run hat keine JSON-Ausgabe; wenn du strukturierte Ergebnisse brauchst, verlange das Format im Prompt und prüfe es.
Schritt 6: crushrc und Konfiguration
Seit Version 0.88 liest Crush seine Einstellungen aus einer crushrc-Datei: einem Bash-Skript mit Crush-Befehlen, das Crushs eigener Interpreter ausführt, damit es sich unter Windows genauso verhält. Crush sucht im Projekt nach .crushrc oder crushrc und global nach ~/.config/crush/crushrc und führt zusammen, was es findet, wobei das Projekt Vorrang hat. Ein kleines Beispiel:
model large anthropic/claude-sonnet-5-5
model small anthropic/claude-haiku-5-5
permissions allow view ls grep
mcp add docs --type http --url https://example.com/mcp
lsp add go --command gopls
crush.json und .crush.json funktionieren weiterhin, gelten aber als veraltet und bekommen keine neuen Funktionen. crush dirs zeigt, wo Crush Konfiguration und Daten ablegt.
Eine Warnung: Eine crushrc ist Code. Alles in $(...) wird beim Start von Crush ausgeführt, also lies die Datei, bevor du Crush in einem fremden Repository startest.
Schritt 7: AGENTS.md, MCP und LSP
Kontextdateien. Crush liest AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md, .cursorrules und .github/copilot-instructions.md ohne jede Einrichtung, dazu ~/.config/crush/CRUSH.md für alle Projekte. Initialize Project in der Befehlspalette schaut sich das Repository an und schreibt daraus eine AGENTS.md. Was hineingehört, erklärt unsere Anleitung zu CLAUDE.md und AGENTS.md.
MCP. Crush unterstützt stdio-, HTTP- und SSE-Server, auch mit OAuth-Anmeldung. Du fügst sie mit mcp add in crushrc hinzu und schaltest sie in der Palette an oder aus.
LSP. Language Server liefern Crush dieselben Diagnosen, die auch dein Editor sieht. Füge einen mit lsp add hinzu oder lass option auto-lsp sie einrichten.
Was Crush kostet (Stand November 2026)
| Option | Preis | Hinweise |
|---|---|---|
| Crush | Kostenlos | Eigene Keys oder lokale Modelle mitbringen |
| Hyper nach Verbrauch | Ab 5 $ Prepaid | Von Charm gehostete Open-Weight-Modelle |
| Hyper-Monatspläne | 10 $ bis 200 $ im Monat | Wöchentliche Credits mit rollierendem 5-Stunden-Fenster |
| Eigener Key | Preis deines Anbieters | Anthropic, OpenAI, Gemini, OpenRouter und mehr |
Crush sendet standardmäßig pseudonyme Nutzungsmetriken; mit CRUSH_DISABLE_METRICS=1 oder DO_NOT_TRACK=1 schaltest du sie ab.
Häufige Stolperfallen
- Anleitungen für crush.json folgen. Die meisten Tutorials von vor August 2026 zeigen nur JSON. Das funktioniert noch, aber neue Optionen kommen in
crushrc. - Yolo hat sich in v0.100 geändert.
--yoloblockiert gefährliche Befehle jetzt, statt nachzufragen; Skripte, die sich auf das alte Verhalten verlassen haben, brauchen eventuell-yy. - Commit-Trailer. Crush hängt standardmäßig einen
Assisted-by-Trailer an Commits. Ändern lässt sich das mitoption attribution-trailer-style. - Zwischenablage unter Linux. Kopieren und Einfügen brauchen
wl-copyoderxclip/xsel. - Wo die Logs liegen.
crush logs --tail 50zeigt, was schiefgelaufen ist; die Logs liegen im Ordner.crushdes Projekts.
Crush neben anderen CLIs in AgentVera ausführen
Wenn Crush dein einziger Agent ist, reicht dir seine eigene Oberfläche vielleicht völlig. Schwieriger wird es, wenn Crush neben Claude Code, Codex oder Gemini CLI im selben Projekt läuft. AgentVera ist eine Desktop-App, die diese CLIs nebeneinander in echten Terminals ausführt, mit deinen eigenen Installationen und Keys. Die Crush-Unterstützung funktioniert so:
- Eine Sitzung pro Agent. AgentVera findet die Sitzung, die Crush anlegt, über
crush session list --jsonund öffnet sie bei späteren Starts mit--session <id>wieder, sodass die Unterhaltung einen Neustart der App übersteht. - Ein Konto pro Agent. Jedes Crush-Konto unter Einstellungen → Konten bekommt einen eigenen Datenordner und ein eigenes
crush login, und du kannst Keys für Anthropic, OpenAI, OpenRouter oder Gemini hinzufügen. - MCP und Konflikte. Server aus dem MCP-Manager von AgentVera erreichen Crush über dessen Konfiguration, und AgentVera fügt einen eigenen Hook hinzu, um zu sehen, welche Dateien jeder Agent anfasst.
- Bereiche und Review. Führe Crush im Raster des Workspace neben anderen Agenten aus und prüfe ihre Änderungen mit dem Code-Review.
Der kostenlose Plan führt 2 Agenten gleichzeitig aus und umfasst MCP, Git, Docker, SSH, Code-Review und Token-Einsparungen. Pro kostet 9,99 $ im Monat und hat kein Agentenlimit; wenn du noch nie eine Testphase hattest, schaltet deine erste Anmeldung in der App Pro für 7 Tage frei, ohne Karte. Zum Ausprobieren: AgentVera herunterladen.
Fazit
Der Start mit Crush braucht zwei Schritte: installieren und crush ausführen, dann mit Ctrl+L ein Modell wählen. Danach stecken die wichtigen Einstellungen in crushrc: welche Tools ohne Rückfrage laufen dürfen, welche Modelle für große und kleine Aufgaben zum Einsatz kommen und welche MCP- und Language-Server geladen werden. Halte eine AGENTS.md im Projekt, und Crush folgt ihr wie die meisten anderen Agenten auch.
Quellen: Crush auf GitHub, Konfigurationsdoku, Releases, Lizenz, Hyper.