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

Installieren Sie eine bestimmte Version:

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

Überprüfen Sie die Installation:

claude doctor

Authentifizieren Sie sich:

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

2. CLI Flags

3. Slash Commands

Benutzerdefinierte Befehle: Erstellen Sie .claude/commands/my-command.md (Projekt) oder ~/.claude/commands/my-command.md (persönlich) und rufen Sie den Befehl mit /my-command auf. Befehle unterstützen YAML frontmatter für Beschreibung, erlaubte Tools, Modellüberschreibung und Argumentinterpolation über $ARGUMENTS oder positionale Argumente $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

Schnelle Präfixe

Mehrzeilige Eingabe

Tastenbelegungen können über /keybindings angepasst werden (gespeichert in ~/.claude/keybindings.json).

5. Konfigurationsdateien

Prioritätshierarchie (höchste bis niedrigste)

Der erste Treffer gewinnt. Enterprise-Einstellungen können nicht umgangen werden.

6. Settings.json-Referenz

Wichtige Einstellungen mit Typen und Beispielen. Platzieren Sie sie in einer beliebigen Einstellungsdatei aus der obigen Hierarchie.

{
  "$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 Präfix-Matching. Bash(npm run test:*) erlaubt npm run test, npm run test:unit usw. Dateimuster verwenden glob-Syntax: Edit(src/**).

Neue Schlüssel (v2.1.118+):

Das vollständige Einstellungsschema finden Sie im vollständigen Leitfaden unter Configuration Deep Dive.

7. CLAUDE.md-Kurzreferenz

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

Speicherorte:

Was hineingehört:

# 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 gut scannbar. Dichte Prosa verschwendet in jeder Sitzung Kontexttokens. Nutzen Sie Aufzählungen, Tabellen und kurze Codeblöcke. Vermeiden Sie lange Absätze — Claude liest CLAUDE.md zu Beginn jeder Sitzung, deshalb kostet jedes Wort Kontext.

Profitipps: - Nutzen Sie das Präfix # im REPL, um Dinge zur Auto-Memory hinzuzufügen, ohne CLAUDE.md zu bearbeiten: # Always use TypeScript strict mode - CLAUDE.md in Unterordnern wird geladen, wenn Claude Dateien in diesem Ordner liest - Teamweit geteilte Regeln gehören für eine modulare Organisation in .claude/rules/*.md

8. Berechtigungsmodi

Auto Mode (v2.1.85+) ist der empfohlene Ersatz für --dangerously-skip-permissions. Schreibgeschützte Aktionen und Dateiänderungen werden automatisch genehmigt. Benutzerdefinierte Allow-/Deny-Regeln werden zuerst ausgewertet. Alles andere geht an den Sicherheits-Classifier. Standardmäßig automatisch blockiert: curl | bash, Force-Push auf main, Produktionsdeployments, massenhafte Cloud-Löschungen, IAM-Änderungen, externes Senden sensibler Daten.¹

Circuit Breaker: 3 aufeinanderfolgende Blockierungen oder insgesamt 20 in einer Sitzung pausieren zurück zur manuellen Nachfrage.

# Enable at startup
claude --enable-auto-mode

# Cycle during session
Shift+Tab    # default -> acceptEdits -> auto -> plan

Automatische PowerShell-Genehmigung (v2.1.119+): PowerShell-Toolbefehle werden im Berechtigungsmodus genauso automatisch genehmigt wie Bash-Befehle. Allow-Regeln wie PowerShell(Get-*:*) umgehen Nachfragen für schreibgeschützte Vorgänge.

9. Hook-Events

| InstructionsLoaded | CLAUDE.md geladen | Nein | | ConfigChange | Config-Datei ändert sich während der Sitzung | Ja | | WorktreeCreate | Worktree wird erstellt | Ja | | WorktreeRemove | Worktree wird entfernt | Nein | | PreCompact | Vor der Kontextkompaktierung | Nein | | PostCompact | Nach der Kontextkompaktierung | Nein | | Elicitation | MCP fordert strukturierte Eingabe an | Ja | | ElicitationResult | Benutzer antwortet auf MCP-Dialog | Ja | | StopFailure | Turn endet wegen API-Fehler | Nein | | PermissionRequest | Berechtigungsdialog wird angezeigt | Ja | | PermissionDenied | Auto Mode verweigert eine Aktion (v2.1.88+) | Nein | | CwdChanged | Arbeitsverzeichnis ändert sich (v2.1.83+) | Nein | | FileChanged | Überwachte Datei wurde extern geändert (v2.1.83+) | Nein | | TaskCreated | Neue Aufgabe erstellt (v2.1.84+) | Nein | | TeammateIdle | Agent-Teammitglied ist inaktiv | Ja | | TaskCompleted | Aufgabe als abgeschlossen markiert | Ja |

Das vollständige Hook-Protokoll (Input-/Output-JSON, Matcher, Exit Codes) finden Sie im vollständigen Guide unter Hooks Deep Dive.

10. Hook-Konfiguration

Hooks liegen in settings.json oder einer dedizierten 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:

Async hooks laufen im Hintergrund, ohne zu blockieren: Fügen Sie dem Hook-Objekt "async": true hinzu.²

Hook-Output-/Input-Felder:

• duration_ms im Hook-Input von PostToolUse / PostToolUseFailure (v2.1.119+) — Toolausführungszeit ohne Berechtigungsnachfragen und PreToolUse hooks.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) — ersetzt die Toolausgabe 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+) — setzt den Sitzungstitel aus einem UserPromptSubmit hook.
• args: string[] bei command hooks (v2.1.139+) — übergibt strukturiertes argv ohne Shell-Quoting.
• continueOnBlock bei PostToolUse hooks (v2.1.139+) — gibt den Blockierungsgrund an Claude zurück und setzt den Turn fort.
• subagent_type im Agent-Hook-Input (v2.1.140+) — identifiziert, welcher Agent-Typ läuft.

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

Scope-Steuerung:

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

Beispiel für Projekt-.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 hat inzwischen 100 Millionen monatliche Downloads und mehr als 3.000 indexierte Server.³ Transporttypen, Elicitation und Tool-Search-Konfiguration finden Sie im vollständigen Guide im MCP-Abschnitt.

alwaysLoad (v2.1.121+): Nehmen Sie einen vertrauenswürdigen Server aus der Tool-Search-Verzögerung aus. Alle seine Tools werden beim Sitzungsstart geladen, ohne ToolSearch-Roundtrip:

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

Auto-retry (v2.1.121+): MCP-Server, die beim Start einen Fehler ausgeben, werden bis zu 3-mal erneut versucht, bevor sie als getrennt markiert werden.

SDK mcp_authenticate redirectUri (v2.1.121+): Erforderlich zum Abschließen von OAuth bei benutzerdefinierten URI-Schemas — Desktop-Apps und claude.ai-Connector-Flows.

11.5. Plugin-CLI-Befehle

12. Subagent-Typen

Claude delegiert 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

Custom 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 laufen.⁴

claude agents öffnet in aktuellen Versionen Agent View: eine Research-Preview-Oberfläche für laufende, blockierte und abgeschlossene Claude Code-Sitzungen. Verwenden Sie sie zur Überwachung, nicht als Nachweis dafür, dass die Arbeit Qualitätsprüfungen bestanden hat.⁶

Custom agent frontmatter-Felder:

Beispiel für einen Custom agent (.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. Environment Variables

Authentifizierung und API

Modellkonfiguration

Cloud-Anbieter

Verhaltenssteuerung

Tool-Konfiguration

Netzwerk und Proxy

Die vollständige Liste finden Sie unter Environment Variables im vollständigen Guide.

14. Kostenreferenz

Preise pro 1 Million Tokens (Stand April 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 nach Plan (Claude Code mit Stand 16. April 2026):

• Max, Team Premium → Opus 4.7
• Pro, Team Standard, Enterprise, Anthropic API → Sonnet 4.6 (Enterprise + API wechseln am 23. April 2026 zu Opus 4.7)
• Bedrock, Vertex, Foundry → Sonnet 4.5 (neuere Version über ANTHROPIC_DEFAULT_OPUS_MODEL pinnen)

Opus 4.7 erfordert Claude Code v2.1.111 oder höher. Es nutzt ausschließlich adaptives Reasoning (keine festen Thinking-Budgets). Das neue Aufwandsniveau xhigh ist der Standard für Coding-/agentische Workloads auf Opus 4.7.

Modelle während einer Sitzung wechseln:

/model opus       # Switch to Opus (resolves to 4.7 on API, 4.6 on Bedrock/Vertex/Foundry)
/model sonnet     # Switch to Sonnet 4.6
/model haiku      # Switch to Haiku 4.5
/effort xhigh     # Opus 4.7 only — recommended for coding/agentic

Entscheidungsregel: Einfache Exploration geht an Haiku. Kostenbewusstes tägliches Coding geht an Sonnet. Schwieriges Reasoning, Architektur, agentische Schleifen und Sicherheitsanalysen gehen an Opus. Verwenden Sie opusplan für komplexes Refactoring (Opus plant, Sonnet führt aus).

15. Wichtige Dateipfade

16. Änderungsprotokoll

17. Referenzen

Diese Kurzreferenz ist der Schnellnachschlage-Begleiter zum vollständigen Claude Code CLI guide. Einrichtungsanleitungen finden Sie im Claude Code quickstart. Speziell für iOS- und macOS-Projekte finden Sie weitere Informationen im iOS Agent Development guide, in den XcodeBuildMCP integration patterns und in der Apple Ecosystem Series. Zuletzt aktualisiert am 13. Mai 2026.