Claude Code Spickzettel: Befehle, Konfiguration und Tastenkürzel

Jedes CLI-Flag, Slash-Command, Tastaturkürzel, jeden Konfigurationsschlüssel, jedes Hook-Event und jede Umgebungsvariable an einem Ort. Ausführliche Erklärungen finden Sie im vollständigen Claude Code-Guide. Für die erstmalige Einrichtung siehe den Quickstart.

1. Installation

Drei Installationsmethoden in der empfohlenen Reihenfolge.

# Native binary (recommended)
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew (macOS)
brew install --cask claude-code

# NPM (deprecated — migrate with `claude install`)
npm install -g @anthropic-ai/claude-code

Eine bestimmte Version installieren:

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Installation überprüfen:

claude doctor
claude --version

Authentifizieren:

claude auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. CLI-Flags

In v2.1.212 hinzugefügter Unterbefehl: claude auto-mode reset setzt Ihren Auto-Mode-Status über das Terminal zurück; mit --yes überspringen Sie die Bestätigungsabfrage.⁷

3. Slash Commands

Benutzerdefinierte Befehle: Erstellen Sie .claude/commands/my-command.md (Projekt) oder ~/.claude/commands/my-command.md (persönlich) und rufen Sie die Datei mit /my-command auf. Befehle unterstützen YAML-Frontmatter für Beschreibung, zulässige Tools, Modellüberschreibung und Argumentinterpolation über $ARGUMENTS oder die Positionsparameter $1, $2.

---
description: Fix a GitHub issue
allowed-tools: Read, Edit, Bash(git:*)
model: opus
argument-hint: [issue-number]
---

Fix GitHub issue #$ARGUMENTS following our coding standards.

Verwendung: /fix-issue 123

4. Tastenkombinationen

Allgemeine Steuerung

Schnellpräfixe

Mehrzeilige Eingabe

Tastenbelegungen lassen sich über /keybindings anpassen (gespeichert in ~/.claude/keybindings.json).

5. Konfigurationsdateien

Rangfolge (höchste bis niedrigste Priorität)

Der erste Treffer gilt. Unternehmenseinstellungen können nicht umgangen werden.

6. Settings.json-Referenz

Wichtige Einstellungen mit Typen und Beispielen. Fügen Sie sie in eine beliebige Einstellungsdatei aus der oben beschriebenen Hierarchie ein.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Read", "Glob", "Grep", "Bash(npm run:*)", "Bash(git:*)", "Edit(src/**)"],
    "deny": ["Read(.env*)", "Bash(rm -rf:*)", "Bash(sudo:*)"],
    "ask": ["WebFetch", "Bash(docker:*)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared-lib"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "hooks": {},
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30,
  "respectGitignore": true,
  "showTurnDuration": true,
  "language": "en",
  "autoMemoryDirectory": ".claude/memory",
  "plansDirectory": ".claude/plans"
}

Syntax für Berechtigungsregeln: Tool(pattern:*) ermöglicht einen Präfixabgleich. Bash(npm run test:*) erlaubt npm run test, npm run test:unit usw. Dateimuster verwenden die Glob-Syntax: Edit(src/**). Seit v2.1.214 stimmt eine allow-Regel mit einem einzelnen Segment wie dir/** nur mit <cwd>/dir überein – nicht mehr mit jedem beliebigen dir/ im Verzeichnisbaum. Verwenden Sie Edit(**/src/**), um Verzeichnisse in jeder Tiefe abzugleichen. deny-/ask-Regeln behalten den tiefenunabhängigen Abgleich bei; für if:-Bedingungen von hooks gilt dieselbe Beschränkung auf das aktuelle Arbeitsverzeichnis.

Neue Schlüssel (v2.1.118+):

Das vollständige Einstellungsschema finden Sie unter Detaillierte Erläuterung der Konfiguration im vollständigen Leitfaden.

7. CLAUDE.md-Kurzreferenz

CLAUDE.md ist die Anweisungsdatei Ihres Projekts. Claude liest sie zu Beginn jeder Sitzung.

Speicherorte:

Empfohlene Inhalte:

# Project Name

## Stack
- Backend: FastAPI, Python 3.11+
- Frontend: HTMX + Alpine.js + Bootstrap 5

## Commands
- Dev: `uvicorn app.main:app --reload --port 8000`
- Test: `python -m pytest -v`
- Lint: `ruff check .`

## Conventions
- Conventional commits: feat:, fix:, docs:, refactor:
- Never force push to main
- Always activate venv before Python commands

## Key Files
- app/main.py — FastAPI app and routes
- app/models.py — SQLAlchemy models

Halten Sie die Datei übersichtlich. Dichte Fließtexte verbrauchen in jeder Sitzung unnötig Kontext-Token. Verwenden Sie Aufzählungspunkte, Tabellen und kurze Codeblöcke. Vermeiden Sie lange Absätze – Claude liest CLAUDE.md zu Beginn jeder Sitzung, sodass jedes Wort Kontext beansprucht.

Profi-Tipps: - Verwenden Sie im REPL das Präfix #, um Inhalte zum automatischen Speicher hinzuzufügen, ohne CLAUDE.md zu bearbeiten: # Always use TypeScript strict mode - CLAUDE.md-Dateien in Unterverzeichnissen werden geladen, sobald Claude Dateien im jeweiligen Verzeichnis liest - Gemeinsam genutzte Teamregeln gehören zur modularen Organisation in .claude/rules/*.md

8. Berechtigungsmodi

Auto Mode (v2.1.85+) ist der empfohlene Ersatz für --dangerously-skip-permissions. Schreibgeschützte Vorgänge und Dateibearbeitungen werden automatisch genehmigt. Benutzerdefinierte allow-/deny-Regeln werden zuerst ausgewertet. Alles Weitere wird an den Sicherheitsklassifikator übergeben. Standardmäßig automatisch blockiert werden: curl | bash, Force-Pushes auf main, Produktionsbereitstellungen, massenhafte Cloud-Löschvorgänge, IAM-Änderungen und das externe Übermitteln vertraulicher Daten.¹

Schutzschalter: Nach 3 aufeinanderfolgenden oder insgesamt 20 Blockierungen innerhalb einer Sitzung wird wieder auf manuelle Rückfragen umgestellt.

# Enable at startup (--enable-auto-mode was removed in v2.1.111)
claude --permission-mode auto

# Cycle during session
Shift+Tab    # Manual (aka default) -> acceptEdits -> auto -> plan

Automatische PowerShell-Genehmigung (v2.1.119+): PowerShell-Toolbefehle werden im Berechtigungsmodus ebenso automatisch genehmigt wie Bash-Befehle. allow-Regeln wie PowerShell(Get-*:*) umgehen Rückfragen bei schreibgeschützten Vorgängen. Verwenden Sie für PowerShell-intensive Workflows v2.1.149 oder neuer; diese Version behebt das Umgehen von Berechtigungen durch den integrierten cd-Befehl, den Abgleich von allow-Regeln mit Präfixen und Platzhaltern sowie die Nachverfolgung veralteter Verzeichnisvariablen.

9. Hook-Ereignisse

| InstructionsLoaded | Wenn CLAUDE.md geladen wurde | Nein | | ConfigChange | Wenn sich eine Konfigurationsdatei während der Sitzung ändert | Ja | | DirectoryAdded | Wenn /add-dir oder SDK register_repo_root während einer Sitzung ein Arbeitsverzeichnis hinzufügt (v2.1.219+) | Nein | | WorktreeCreate | Beim Erstellen eines Worktrees | Ja | | WorktreeRemove | Beim Entfernen eines Worktrees | Nein | | PreCompact | Vor der Kontextkomprimierung | Nein | | PostCompact | Nach der Kontextkomprimierung | Nein | | Elicitation | Wenn MCP strukturierte Eingaben anfordert | Ja | | ElicitationResult | Wenn der Benutzer auf den MCP-Dialog antwortet | Ja | | StopFailure | Wenn ein Durchlauf aufgrund eines API-Fehlers endet | Nein | | PermissionRequest | Wenn ein Berechtigungsdialog angezeigt wird | Ja | | PermissionDenied | Wenn Auto Mode eine Aktion ablehnt (v2.1.88+) | Nein | | CwdChanged | Wenn sich das Arbeitsverzeichnis ändert (v2.1.83+) | Nein | | FileChanged | Wenn eine überwachte Datei extern geändert wird (v2.1.83+) | Nein | | TaskCreated | Wenn eine neue Aufgabe erstellt wird (v2.1.84+) | Nein | | TeammateIdle | Wenn ein Mitglied des agent-Teams inaktiv wird | Ja | | TaskCompleted | Wenn eine Aufgabe als abgeschlossen markiert wird | Ja |

Das vollständige Hook-Protokoll (Eingabe-/Ausgabe-JSON, Matcher, Exit-Codes) finden Sie unter Detaillierte Erläuterung der hooks im vollständigen Leitfaden.

10. Hook-Konfiguration

hooks befinden sich in settings.json oder in einer separaten hooks.json. Minimalbeispiel:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ]
  }
}

Matcher-Syntax:

Exit-Codes:

Asynchrone hooks werden im Hintergrund ausgeführt, ohne zu blockieren: Fügen Sie dem Hook-Objekt "async": true hinzu.²

Hook-Ausgabe-/Eingabefelder:

• duration_ms in der Hook-Eingabe von PostToolUse / PostToolUseFailure (v2.1.119+) – Ausführungszeit des Tools ohne Berechtigungsrückfragen und PreToolUse-hooks.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) – ersetzt die Tool-Ausgabe für jedes Tool (v2.1.118 führte dies ausschließlich für MCP ein; v2.1.121 erweitert es auf alle Tools).
• hookSpecificOutput.sessionTitle (v2.1.96+) – legt den Sitzungstitel über einen UserPromptSubmit-hook fest.
• args: string[] bei Befehls-hooks (v2.1.139+) – übergibt strukturierte argv-Werte ohne Shell-Quoting.
• continueOnBlock bei PostToolUse-hooks (v2.1.139+) – übergibt den Blockierungsgrund an Claude und setzt den Durchlauf fort.
• subagent_type in der agent-Hook-Eingabe (v2.1.140+) – gibt an, welcher agent-Typ ausgeführt wird.
• terminalSequence in der Hook-JSON-Ausgabe (v2.1.141+) – gibt Terminal-Steuersequenzen für Benachrichtigungen, Fenstertitel und Signaltöne aus.

11. MCP-Schnelleinrichtung

Fügen Sie einen MCP-Server mit einem einzigen Befehl hinzu:

# Remote HTTP server (recommended)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Remote with auth header
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer $TOKEN"

# Local stdio server
claude mcp add --transport stdio postgres \
  --env "DATABASE_URL=postgresql://user:pass@localhost/db" \
  -- npx -y @anthropic-ai/mcp-server-postgres

Gültigkeitsbereich festlegen:

claude mcp add --scope project ...   # Team-shared (.mcp.json)
claude mcp add --scope user ...      # Personal (~/.claude.json)

Beispiel für eine projektbezogene .mcp.json:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

MCP verzeichnet inzwischen 100 Millionen monatliche Downloads und mehr als 3.000 indexierte Server.³ Informationen zu Transporttypen, Elicitation und der Konfiguration der Tool-Suche finden Sie im vollständigen Leitfaden im Abschnitt zu MCP.

alwaysLoad (v2.1.121+): Nehmen Sie einen vertrauenswürdigen Server von der Zurückstellung durch die Tool-Suche aus. Alle zugehörigen Tools werden beim Sitzungsstart geladen, ohne ToolSearch-Roundtrip:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "alwaysLoad": true
    }
  }
}

Automatische Wiederholungsversuche (v2.1.121+): MCP-Server, bei denen während des Starts ein Fehler auftritt, werden bis zu 3-mal erneut gestartet, bevor sie als getrennt markiert werden.

SDK mcp_authenticate redirectUri (v2.1.121+): Erforderlich, um OAuth mit benutzerdefinierten URI-Schemata abzuschließen – für Desktop-Apps und Connector-Abläufe auf claude.ai.

11.5. Plugin-CLI-Befehle

12. Subagent-Typen

Claude delegiert Aufgaben automatisch an subagents. Sie können sie auch ausdrücklich anfordern:

> Use the explore agent to find all auth-related files
> Have a subagent analyze the database schema

Benutzerdefinierte subagents werden in .claude/agents/ (Projekt) oder ~/.claude/agents/ (persönlich) als Markdown-Dateien mit YAML-Frontmatter definiert. Bis zu 10 subagents können parallel ausgeführt werden.⁴

claude agents öffnet in aktuellen Versionen Agent View: eine als Forschungsvorschau verfügbare Betriebsansicht für laufende, blockierte und abgeschlossene Claude Code-Sitzungen. Mit claude agents --cwd <path> beschränken Sie die Ansicht auf ein Verzeichnis (v2.1.141+). v2.1.142 ergänzt Dispatch-Flags für Hintergrundsitzungen, und v2.1.143 wendet diese Flags einheitlich auf das Dashboard und Hintergrundsitzungen an: --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort und --dangerously-skip-permissions. v2.1.144 ergänzt die Unterstützung von /resume für Hintergrundsitzungen und kennzeichnet sie mit bg; v2.1.145 ergänzt claude agents --json, Registerkartenzähler für Sitzungen, die auf Eingaben warten, sowie Korrekturen am Antwortbereich von Agent View; v2.1.147 ergänzt angeheftete Hintergrundsitzungen, die auch im Leerlauf aktiv bleiben und für Aktualisierungen an Ort und Stelle neu gestartet werden. Verwenden Sie Agent View zur Überwachung, nicht als Nachweis dafür, dass die Arbeit die Qualitätsprüfungen bestanden hat.⁶

Frontmatter-Felder benutzerdefinierter Agenten:

Beispiel für einen benutzerdefinierten Agenten (.claude/agents/security-reviewer.md):

---
name: security-reviewer
description: Expert security code reviewer. Use PROACTIVELY after code changes to auth or data handling.
tools: Read, Grep, Glob, Bash
model: opus
permissionMode: plan
---

You are a senior security engineer. Analyze for OWASP Top 10 vulnerabilities,
secrets, hardcoded credentials, and SQL injection. Report findings with severity
levels and remediation steps.

13. Umgebungsvariablen

Authentifizierung und API

Modellkonfiguration

Cloud-Anbieter

Verhaltenssteuerung

Tool-Konfiguration

Netzwerk und Proxy

Die vollständige Liste finden Sie unter Umgebungsvariablen im vollständigen Leitfaden.

14. Kostenübersicht

Preise pro 1 Million Tokens (Stand: Juli 2026).⁵

Eine typische Sitzung verbraucht 50K–200K Eingabe-Tokens und 10K–50K Ausgabe-Tokens. Haiku-Sitzung: $0.10–$0.45. Opus-Sitzung: $0.50–$2.25.

Standardmodell in Claude Code (seit v2.1.197, 30. Juni 2026): Sonnet 5 für alle neuen Sitzungen — nativer 1M-Kontext und Einführungspreise von $2/$10 bis zum 31. August — während Opus nur einen Befehl /model opus entfernt ist (seit v2.1.219 verweist dieser Alias auf Opus 5). Administratoren können ein organisationsweites Standardmodell festlegen, das in /model als „Org default“ angezeigt wird (v2.1.196+); bei Bedrock/Vertex/Foundry lässt sich ein bestimmtes Modell über ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL festlegen.

Sonnet 5, Opus 5, Opus 4.8 und Fable 5 verwenden ausschließlich adaptives Reasoning ohne feste Denkbudgets. effort ist bei allen standardmäßig auf high gesetzt; für besonders anspruchsvolle Programmier- und agentische Aufgaben steht /effort xhigh zur Verfügung. Breaking Changes in Opus 5 gegenüber Opus 4.8: Das Denken ist bei Anfragen ohne thinking-Feld standardmäßig aktiviert, und thinking: {type: "disabled"} führt mit dem Aufwand xhigh oder max zu einem Fehler 400.

Fast mode (/fast) gilt seit v2.1.219 nur für Opus 5 und Opus 4.8 — $10/$50 pro MTok (2× Basispreis) für eine bis zu 2,5-fache Ausgabe-Token-Geschwindigkeit pro Sekunde. Opus 4.7 wurde entfernt: claude-opus-4-7 + speed: "fast" verursacht jetzt einen Fehler, statt auf die Standardgeschwindigkeit zurückzufallen. Forschungsvorschau, nur Claude API (nicht Bedrock/Vertex/Foundry); ein Geschwindigkeitswechsel macht den Prompt-Cache ungültig.

Modelle während einer Sitzung wechseln:

/model opus       # Switch to Opus 5 (v2.1.219+)
/model sonnet     # Switch to Sonnet 5 (the default)
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5 (tier above Opus)
/effort xhigh     # Recommended for the hardest coding/agentic work

Entscheidungsregel: Verwenden Sie Haiku für einfache Erkundungen. Für kostensensibles tägliches Programmieren eignet sich Sonnet. Setzen Sie Opus für anspruchsvolles Reasoning, Architektur, agentische Schleifen und Sicherheitsanalysen ein. Verwenden Sie opusplan für komplexe Refactorings (Opus plant, Sonnet führt aus).

15. Wichtige Dateispeicherorte

16. Änderungsprotokoll

17. Quellen

Dieser Spickzettel ist die Schnellreferenz zum vollständigen Leitfaden zu Claude Code CLI. Schritt-für-Schritt-Anleitungen zur Einrichtung finden Sie im Schnellstart für Claude Code. Speziell für iOS- und macOS-Projekte empfehlen sich der Leitfaden zur iOS-Agentenentwicklung, die Integrationsmuster für XcodeBuildMCP und die Apple-Ökosystem-Reihe. Zuletzt aktualisiert am 17. Juli 2026.