diff --git a/README.md b/README.md index 239f0b9..09ace64 100644 --- a/README.md +++ b/README.md @@ -1,34 +1,157 @@ -# Claude Code: Arbeit fortsetzen nach /exit +# Claude Code: Kurzreferenz -## Am einfachsten: `--continue` +## Session Management + +### Arbeit fortsetzen nach /exit + +**Am einfachsten: `--continue`** ```bash claude --continue ``` Lädt automatisch die **letzte Konversation** im aktuellen Verzeichnis wieder. -## Gezielt eine Session auswählen: `--resume` +**Gezielt eine Session auswählen: `--resume`** ```bash claude --resume # Interaktive Auswahl aller Sessions claude --resume mein-feature # Nach Name suchen ``` -## Bevor du `/exit` machst: Session benennen -Innerhalb der Session: +**Bevor du `/exit` machst: Session benennen** ``` /rename mein-feature-step-3 ``` Damit findest du die Session später leicht wieder. -## CLAUDE.md als "Gedächtnis" +### CLAUDE.md als "Gedächtnis" + Claude Code liest bei jeder Session die CLAUDE.md. Mit `/memory` kannst du dort den aktuellen Stand notieren (z.B. "Aktuell arbeite ich an X, nächster Schritt ist Y, Blocker ist Z"). Beim Wiederaufnehmen liest Claude das automatisch. +**Wo CLAUDE.md gespeichert wird (Scopes):** + +| Ort | Nutzen | +|-----|--------| +| `./CLAUDE.md` | Projekt-weit, im Git geteilt | +| `./CLAUDE.local.md` | Nur du, nicht in Git | +| `~/.claude/CLAUDE.md` | Global für alle Projekte | + +## Nützliche Slash-Commands + +| Befehl | Funktion | +|--------|----------| +| `/memory` | CLAUDE.md bearbeiten (Notizen für nächste Session) | +| `/rename ` | Session benennen | +| `/resume` | Session-Picker innerhalb einer Session | +| `/cost` | Token-Nutzung und Kosten der Session anzeigen | +| `/compact` | Kontext komprimieren wenn er voll wird | +| `/model` | Zwischen Sonnet / Opus wechseln | +| `/clear` | Konversation löschen (neuer Start) | +| `/config` | Settings bearbeiten | +| `/doctor` | Diagnose bei Problemen | +| `/plan` | Plan-Modus aktivieren (erkundet erst, bevor Code geschrieben wird) | + +## Tastenkombinationen + +| Taste | Funktion | +|-------|----------| +| `Esc+Esc` | Letzte Änderungen rückgängig machen | +| `Shift+Tab` | Permission-Modus umschalten (Plan / Auto / Normal) | +| `Ctrl+B` | Laufenden Befehl in den Hintergrund schieben | +| `Ctrl+C` | Input oder Generierung abbrechen | +| `Ctrl+L` | Terminal löschen (behält History) | +| `\` + `Enter` | Mehrzeilige Eingabe | + +## CLI-Flags + +| Flag | Nutzen | Beispiel | +|------|--------|---------| +| `--continue` / `-c` | Letzte Session fortsetzen | `claude -c` | +| `--resume` | Session auswählen | `claude --resume mein-feature` | +| `--model` | Modell setzen | `claude --model sonnet` | +| `-p "Frage"` | Nicht-interaktiv, nur Antwort | `claude -p "Was macht diese Funktion?"` | +| `--verbose` | Detaillierte Ausgaben | `claude --verbose` | +| `--permission-mode` | Permission Level | `claude --permission-mode plan` | + ## Kurzreferenz -| Was | Wie | -|------------------------------|------------------------------| -| Letzte Session fortsetzen | `claude --continue` | -| Bestimmte Session laden | `claude --resume ` | -| Session benennen | `/rename ` | -| Notizen für nächste Session | `/memory` | +| Was | Wie | +|-----|-----| +| Letzte Session fortsetzen | `claude --continue` | +| Bestimmte Session laden | `claude --resume ` | +| Session benennen | `/rename ` | +| Notizen für nächste Session | `/memory` | +| Kosten checken | `/cost` | +| Modell wechseln | `/model` | +| Änderungen rückgängig | `Esc+Esc` | Die Konversationshistorie wird automatisch gespeichert. Nur die Berechtigungen (z.B. für Dateizugriffe) müssen beim Fortsetzen erneut bestätigt werden. + +--- + +## Superpowers Plugin installieren + +Superpowers ist ein Plugin das bewährte Skills für Claude Code bereitstellt (TDD, Debugging, Brainstorming, Code-Review, etc.). Benötigt Claude Code 2.0.13+. + +```bash +/plugin marketplace add obra/superpowers-marketplace +/plugin install superpowers@superpowers-marketplace +``` + +**Wichtige Skills nach Installation:** + +| Skill | Funktion | +|-------|----------| +| `/superpowers:brainstorming` | Interaktive Ideenfindung vor Implementierung | +| `/superpowers:write-plan` | Implementierungsplan erstellen | +| `/superpowers:execute-plan` | Plan in Batches ausführen | +| `/superpowers:test-driven-development` | TDD-Methodik | +| `/superpowers:systematic-debugging` | Methodischer Debugging-Prozess | +| `/superpowers:code-reviewer` | Code-Review nach Implementierung | +| `/superpowers:subagent-driven-development` | Parallele Task-Ausführung | +| `/superpowers:verification-before-completion` | Prüfung vor Commit/PR | + +**Links:** +- [GitHub - obra/superpowers](https://github.com/obra/superpowers) +- [Marketplace](https://github.com/obra/superpowers-marketplace) + +--- + +## MCP-Server (Model Context Protocol) + +MCP-Server erweitern Claude Code um externe Tools (GitHub, Datenbanken, APIs, etc.). + +### Server hinzufügen + +```bash +# HTTP-Server (Remote) +claude mcp add --transport http + +# Stdio-Server (Lokal via npx) +claude mcp add --transport stdio -- npx + +# JSON-Konfiguration (für Header, Auth etc.) +claude mcp add-json '{"type":"http","url":"https://...","headers":{"Authorization":"Bearer TOKEN"}}' +``` + +### Scopes + +| Scope | Wo gespeichert | Geteilt | +|-------|---------------|---------| +| `--scope local` (default) | `.mcp.json` | Nein | +| `--scope project` | `.mcp.json` (Git) | Ja, mit Team | +| `--scope user` | `~/.claude.json` | Nein, alle Projekte | + +### Verwaltung + +```bash +claude mcp list # Alle Server anzeigen +claude mcp get # Details eines Servers +claude mcp remove # Server entfernen +/mcp # Im Chat: Status + Authentifizierung +``` + +### Beispiel: GitHub MCP-Server + +```bash +claude mcp add --transport http github https://api.githubcopilot.com/mcp/ +``` +Danach im Chat `/mcp` → Authenticate.