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

URL: https://agentvera.dev/de/blog/how-to-use-crush/ · Veröffentlicht: 2026-11-17

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

**Kurz gesagt:**

- Installieren: brew install charmbracelet/tap/crush, npm install -g @charmland/crush oder winget install charmbracelet.crush. Dann crush im Projekt starten, mit Ctrl+L ein Modell wählen, Key einfügen oder anmelden.
- Crush fragt vor Tool-Aufrufen nach und lässt dich ein Tool für die ganze Sitzung freigeben. crush run erledigt Einmal-Aufgaben und Eingaben per Pipe; crush -C oder crush -s <id> setzt eine Sitzung fort.
- Seit v0.88 steckt die Konfiguration in einer crushrc-Datei (Bash mit Crush-Befehlen); crush.json funktioniert noch, gilt aber als veraltet. AGENTS.md, CRUSH.md und CLAUDE.md liest Crush von selbst.

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](https://github.com/charmbracelet "Charm auf GitHub"), 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

```bash
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

```bash
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):

```bash
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:

```bash
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

```bash
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:

```bash
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](/de/blog/claude-md-agents-md/ "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.** `--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](/de/ "AgentVera") ist eine Desktop-App, die diese CLIs nebeneinander in echten Terminals ausführt, mit deinen eigenen Installationen und Keys. Die [Crush-Unterstützung](/de/agents/crush/ "Crush in AgentVera") 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](/de/features/mcp-manager/ "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](/de/features/workspace/ "Workspace") neben anderen Agenten aus und prüfe ihre Änderungen mit dem [Code-Review](/de/features/code-review/ "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](/de/download/ "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](https://github.com/charmbracelet/crush "Crush-README"), [Konfigurationsdoku](https://github.com/charmbracelet/crush/tree/main/docs/config "Crush-Konfiguration"), [Releases](https://github.com/charmbracelet/crush/releases "Crush-Releases"), [Lizenz](https://github.com/charmbracelet/crush/blob/main/LICENSE.md "Crush-Lizenz"), [Hyper](https://hyper.charm.land "Hyper von Charm").

## 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.

---

**Über AgentVera.** AgentVera ist eine Desktop-App für macOS, Windows und Linux, entwickelt von Solviera Teknoloji. Sie führt 18 KI-Coding-Agenten (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) nebeneinander aus, pro Projekt, in echten Terminals mit den eigenen CLI-Installationen und Logins des Nutzers. Der kostenlose Plan führt 2 Agenten gleichzeitig aus. Download: https://agentvera.dev/de/download/ · Preise: https://agentvera.dev/de/pricing/
