Lade Freunde ein und erhalte 1 Monat Pro gratisSo funktioniert’s

Crush nutzen: Schritt-für-Schritt-Anleitung für Charms Coding-Agent

Crush nutzen, Charms Coding-Agent fürs Terminal: installieren, Anbieter oder lokales Modell wählen, Tools freigeben, crush run, Sitzungen fortsetzen, crushrc anlegen.

Solviera Teknoloji 7 Min. Lesezeit

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+L wechselt das Modell; Ctrl+N startet eine neue Sitzung und Ctrl+S listet die Sitzungen auf.
  • @ erwähnt eine Datei; Ctrl+F fügt eine Datei oder ein Bild hinzu; Ctrl+V fügt ein Bild ein.
  • Shift+Tab schaltet 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+G zeigt die Hilfe; Ctrl+C beendet 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)

OptionPreisHinweise
CrushKostenlosEigene Keys oder lokale Modelle mitbringen
Hyper nach VerbrauchAb 5 $ PrepaidVon Charm gehostete Open-Weight-Modelle
Hyper-Monatspläne10 $ bis 200 $ im MonatWöchentliche Credits mit rollierendem 5-Stunden-Fenster
Eigener KeyPreis deines AnbietersAnthropic, 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. --yolo blockiert 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 mit option attribution-trailer-style.
  • Zwischenablage unter Linux. Kopieren und Einfügen brauchen wl-copy oder xclip/xsel.
  • Wo die Logs liegen. crush logs --tail 50 zeigt, was schiefgelaufen ist; die Logs liegen im Ordner .crush des 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 --json und ö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.

Häufige Fragen

Ist Crush kostenlos?

Crush selbst kostet nichts: Du bringst eigene API-Keys oder ein lokales Modell mit. Charm verkauft zusätzlich Hyper, einen gehosteten Anbieter für Open-Weight-Modelle, mit Monatsplänen von 10 $ bis 200 $ oder Prepaid-Guthaben ab 5 $ (Stand November 2026). Crush steht unter FSL-1.1-MIT, einer Source-Available-Lizenz, deren Versionen später zu MIT werden.

Funktioniert Crush mit lokalen Modellen?

Ja. Füge in crushrc einen Ollama-, LM-Studio-, llama.cpp- oder LiteLLM-Anbieter hinzu, zum Beispiel provider add ollama --type ollama --base-url "http://localhost:11434/v1/", und Crush erkennt dessen Modelle.

Wie setze ich eine Crush-Sitzung fort?

crush -C (oder --continue) öffnet die letzte Sitzung im Projekt wieder, crush -s <id> eine bestimmte. crush session list zeigt alle an, und beim Beenden gibt Crush den Befehl zum Fortsetzen aus.

Liest Crush CLAUDE.md oder AGENTS.md?

Beides. Crush liest AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md, .cursorrules und .github/copilot-instructions.md, sofern vorhanden. Initialize Project in der Befehlspalette schreibt dir eine AGENTS.md.

Was macht crush --yolo?

Es überspringt die Rückfragen, blockiert aber weiterhin Befehle, die Crush als gefährlich einstuft. -yy (Sysadmin-Modus) erlaubt auch diese. Nutze beides nur in Wegwerf-Umgebungen.

Hol deine Agenten an einen Tisch.

Lade AgentVera kostenlos herunter; deine installierten CLIs sind sofort startklar.

Weitere Beiträge