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. Tastaturkürzel

Allgemeine Steuerung

Schnellpräfixe

Mehrzeilige Eingabe

Die Tastenbelegung lässt sich über /keybindings anpassen (gespeichert in ~/.claude/keybindings.json).

5. Konfigurationsdateien

Rangfolge (von der höchsten zur niedrigsten Priorität)

Der erste Treffer gilt. Unternehmenseinstellungen lassen sich nicht umgehen.

6. Settings.json-Referenz

Wichtige Einstellungen mit Typen und Beispielen. Fügen Sie sie in eine beliebige Einstellungsdatei aus der obigen Rangfolge 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
  },
  "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 einsegmentige allow-Regel dir/** nur mit <cwd>/dir überein — nicht mehr mit beliebigen dir/-Verzeichnissen im gesamten Verzeichnisbaum; verwenden Sie Edit(**/src/**), um Übereinstimmungen in beliebiger Tiefe zu erzielen. deny-/ask-Regeln behalten den Abgleich in beliebiger Tiefe bei, und 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 im vollständigen Leitfaden unter Vertiefung des Konfigurationssystems.

7. CLAUDE.md-Kurzreferenz

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

Speicherorte:

AGENTS.md (v2.1.277+): In einem Projekt ohne CLAUDE.md liest Claude Code stattdessen AGENTS.md – ändern Sie dieses Verhalten unter „Projektanweisungen“ in /config (noch nicht für Bedrock/Vertex/Foundry verfügbar).

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

Gestalten Sie die Datei übersichtlich. Dichter Fließtext verbraucht in jeder Sitzung unnötig Kontext-Tokens. 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 Einträge zum automatischen Speicher hinzuzufügen, ohne CLAUDE.md zu bearbeiten: # Always use TypeScript strict mode - CLAUDE.md-Dateien in Unterverzeichnissen werden geladen, wenn Claude Dateien in diesem Verzeichnis liest - Vom Team gemeinsam genutzte Regeln gehören zur modularen Organisation in .claude/rules/*.md

8. Berechtigungsmodi

Der Auto-Modus (v2.1.85+) ist seit dem 14. August 2026 der standardmäßige Berechtigungsmodus für neue Sitzungen in Pro-, Max- und Team-Tarifen (ein selbst festgelegter defaultMode bleibt bestehen, bis Sie die einmalige Aufforderung zum Wechsel bestätigen; disableAutoMode deaktiviert den Modus unternehmensweit). Er ist der empfohlene Ersatz für --dangerously-skip-permissions. Schreibgeschützte Vorgänge und Dateiänderungen werden automatisch genehmigt; seit v2.1.281, als die Klassifikatorprüfung auf den Server verlagert wurde, warten auch schreibgeschützte Vorgänge und Sandbox-Shell-Befehle auf diese Prüfung und werden blockiert, wenn der Klassifikator sie beanstandet. Benutzerdefinierte allow-/deny-Regeln werden zuerst ausgewertet. Alles andere wird dem Sicherheitsklassifikator vorgelegt. Standardmäßig automatisch blockiert werden: curl | bash, erzwungene Pushes auf main, Produktionsbereitstellungen, massenhafte Cloud-Löschungen, IAM-Änderungen und das externe Versenden vertraulicher Daten.¹

Sicherungsmechanismus: Nach 3 aufeinanderfolgenden oder insgesamt 20 Blockierungen in einer Sitzung wird der Auto-Modus pausiert und wieder auf manuelle Rückfragen umgestellt.

Gefährliche rm-Befehle in unbeaufsichtigten Modi (v2.1.281): Im Auto-Modus und bei --dangerously-skip-permissions wartet die Rückfrage für gefährliche rm-Befehle 2 Minuten und lehnt den Befehl anschließend mit einem Hinweis zur Umformulierung ab, damit die Sitzung fortgesetzt werden kann. Ein rekursiver rm-Befehl, dessen Ziel ausschließlich aus der Ausgabe einer Befehlssubstitution besteht, etwa rm -rf "$(pwd)", fragt nun selbst bei einer Bash-allow-Regel nach.

# 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 je nach 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-lastige Workflows v2.1.149 oder neuer; diese Version behebt die Umgehung von Berechtigungen durch den integrierten Befehl cd, den Abgleich von Präfix-/Platzhalter-allow-Regeln sowie die Nachverfolgung veralteter Verzeichnisvariablen.

9. Hook-Events

| InstructionsLoaded | CLAUDE.md wurde geladen | Nein | | ConfigChange | Die Konfigurationsdatei wird während der Sitzung geändert | Ja | | DirectoryAdded | /add-dir oder SDK register_repo_root fügt während der Sitzung ein Arbeitsverzeichnis hinzu (v2.1.219+) | Nein | | WorktreeCreate | Ein Worktree wird erstellt | Ja | | WorktreeRemove | Ein Worktree wird entfernt | Nein | | PreCompact | Vor der Kontextkomprimierung | Nein | | PostCompact | Nach der Kontextkomprimierung | Nein | | Elicitation | MCP fordert strukturierte Eingaben an | Ja | | ElicitationResult | Der Benutzer antwortet auf den MCP-Dialog | Ja | | StopFailure | Der Turn endet aufgrund eines API-Fehlers | Nein | | PermissionRequest | Ein Berechtigungsdialog wird angezeigt | Ja | | PermissionDenied | Der automatische Modus verweigert eine Aktion (v2.1.88+) | Nein | | CwdChanged | Das Arbeitsverzeichnis wird geändert (v2.1.83+) | Nein | | FileChanged | Eine überwachte Datei wird extern geändert (v2.1.83+) | Nein | | TaskCreated | Eine neue Aufgabe wird erstellt (v2.1.84+) | Nein | | TeammateIdle | Ein Mitglied des Agententeams ist inaktiv | Ja | | TaskCompleted | Eine Aufgabe wird als abgeschlossen markiert | Ja |

Das vollständige Hook-Protokoll (Eingabe-/Ausgabe-JSON, Matcher und Exit-Codes) finden Sie unter Hooks im Detail im vollständigen Leitfaden.

10. Hook-Konfiguration

Hooks befinden sich in settings.json oder einer eigenen hooks.json. Minimales Beispiel:

{
  "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.²

Ausgabe-/Eingabefelder von Hooks:

• duration_ms in der Hook-Eingabe von PostToolUse / PostToolUseFailure (v2.1.119+) – Ausführungszeit des Tools ohne Berechtigungsabfragen und PreToolUse-Hooks.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) – ersetzt die Tool-Ausgabe für jedes Tool (v2.1.118 führte dies nur 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+) – gibt den Grund für die Blockierung an Claude zurück und setzt den Turn fort.
• subagent_type in der Hook-Eingabe eines Agenten (v2.1.140+) – gibt an, welcher Agententyp ausgeführt wird.
• terminalSequence in der JSON-Ausgabe eines Hooks (v2.1.141+) – gibt Terminal-Steuersequenzen für Benachrichtigungen, Fenstertitel und Signaltöne aus.

11. MCP-Schnelleinrichtung

Fügen Sie mit einem einzigen Befehl einen MCP-Server 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

Geltungsbereich festlegen:

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

Beispiel für eine .mcp.json im Projekt:

{
  "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 Tool Search aus. Alle seine Tools werden beim Sitzungsstart geladen, ohne zusätzlichen 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 automatisch an subagents. Sie können diese 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 die Agent View: eine als Forschungsvorschau verfügbare Betriebsansicht für laufende, blockierte und abgeschlossene Claude Code-Sitzungen. Mit claude agents --cwd <path> begrenzen Sie die Ansicht auf ein Verzeichnis (v2.1.141+). v2.1.142 ergänzt Dispatch-Flags für Hintergrundsitzungen, während v2.1.143 diese Flags einheitlich auf das Dashboard und Hintergrundsitzungen anwendet: --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 diese mit bg; v2.1.145 ergänzt claude agents --json, Zähler für Sitzungen, die auf Eingaben warten, sowie Korrekturen am Antwortbereich der Agent View; v2.1.147 ergänzt angeheftete Hintergrundsitzungen, die auch bei Inaktivität aktiv bleiben und für Aktualisierungen an Ort und Stelle neu gestartet werden. Verwenden Sie die Agent View zur Überwachung, nicht als Nachweis dafür, dass die Arbeit die Qualitätsprüfungen bestanden hat.⁶

Frontmatter-Felder für benutzerdefinierte 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 Token (Stand: September 2026).⁵

Eine typische Sitzung verbraucht 50K–200K Eingabe-Token und 10K–50K Ausgabe-Token. Haiku-Sitzung: $0.10–$0.45. Opus-5.5-Sitzung: $0.40–$1.80.

Standardmodell in Claude Code (nach Tarif): Seit v2.1.280 (22. September 2026) ist Opus in jedem Tarif Standard – Pro und Team Standard wurden von Sonnet auf Opus umgestellt und damit an Max, Team Premium und Enterprise angeglichen – und das standardmäßige Opus-Modell ist Opus 5.5 (claude-opus-5-5), auf das nun der Alias opus verweist. Die Aufteilung aus v2.1.251 (Opus 5 in den Premiumtarifen, Sonnet 5 in Pro/Team Standard) und Sonnet 5 als Standard für alle Tarife seit v2.1.197 sind damit Geschichte. Administratoren können einen organisationsweiten Standard festlegen, der in /model als „Org default“ angezeigt wird (ab v2.1.196). Claude Platform auf AWS, Amazon Bedrock und die Agent Platform von Google Cloud verwenden ebenfalls standardmäßig Opus 5.5; Microsoft Foundry ist die einzige Ausnahme (standardmäßig Sonnet 4.5 und der einzige Ort, an dem opus auf Opus 4.6 verweist) – legen Sie ein bestimmtes Modell über ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL fest.

Opus 5.5, Sonnet 5, Opus 5, Opus 4.8, Fable 5 und Fable 5.1 verwenden ausschließlich adaptives Reasoning (keine festen thinking-Budgets), mit /effort xhigh für besonders anspruchsvolle Programmier- und Agentenaufgaben. effort steht bei allen standardmäßig auf high, außer bei Opus 5.5, dessen Standardwert medium ist – und seit v2.1.280 wird eine effort-Stufe, die Sie gespeichert haben, bevor /effort modellspezifisch wurde, nicht mehr auf neu veröffentlichte Modelle wie Opus 5.5 übertragen. Das Modell beginnt daher mit seinem eigenen Standardwert, bis Sie eine Stufe auswählen. Bei Opus 5.5 und den Fable-Modellen lässt sich thinking nicht deaktivieren (MAX_THINKING_TOKENS=0 hat dort keine Wirkung). Inkompatible Änderungen von Opus 5 gegenüber Opus 4.8: Bei Anfragen ohne thinking-Feld ist thinking standardmäßig aktiviert, und thinking: {type: "disabled"} führt bei effort xhigh oder max zu einem 400-Fehler.

Fast mode (/fast) gilt für Opus 5.5, Opus 5 und Opus 4.8, wobei Opus 5.5 seit v2.1.280 Standard ist – $8 / $40 pro MTok bei Opus 5.5, $10 / $50 bei Opus 5 und 4.8 (jeweils das 2-Fache des Grundpreises) für bis zu 2,5-mal so viele Ausgabe-Token pro Sekunde. Opus 4.7 wurde entfernt: claude-opus-4-7 + speed: "fast" führt nun zu einem Fehler, statt auf die Standardgeschwindigkeit zurückzufallen. Research Preview, nur für Claude API und Abonnements (nicht für Bedrock/Vertex/Foundry oder Claude Platform auf AWS); ein Geschwindigkeitswechsel invalidiert den Prompt-Cache. Seit v2.1.271 funktioniert Fast mode auch in Claude Code Remote-Sitzungen (Cloud- und selbst gehostete Runner): Die Fast-mode-Einstellung des Hosts oder das während der Sitzung eingegebene /fast gilt überall dort, wo Ihre Organisation dies zulässt.

Modelle während einer Sitzung wechseln:

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

Entscheidungsregel: Verwenden Sie Haiku für einfache Erkundungen. Nutzen Sie Sonnet für kostenbewusstes Programmieren im Alltag. Setzen Sie Opus für anspruchsvolles Reasoning, Architektur, Agentenschleifen und Sicherheitsanalysen ein. Verwenden Sie opusplan für komplexe Refaktorierungen (Opus plant, Sonnet führt aus).

15. Wichtige Dateispeicherorte

16. Änderungsprotokoll

17. Quellen

Dieser Spickzettel dient als Nachschlagewerk zum vollständigen Leitfaden zu Claude Code CLI. Eine schrittweise Einführung in die 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 Ecosystem Series. Zuletzt aktualisiert am 17. Juli 2026.