Claude Code Spickzettel: Dein umfassender Anfänger-Leitfaden für Entwickler

Wenn Sie sich mit Claude Code, dem leistungsstarken KI-gestützten Programmierassistenten von Anthropic, beschäftigen, ist eine klare Referenz unerlässlich. Dieses Claude Code Cheatsheet richtet sich an Entwickler, die einen praktischen, anfängerfreundlichen Leitfaden suchen, der Einrichtung, Workflows, Konfiguration und fortgeschrittene Tipps abdeckt. Am Ende werden Sie sich sicherer fühlen, Claude Code in Ihrer lokalen Umgebung oder als Teil Ihrer CI/CD-Prozesse zu verwenden.

Was ist Claude Code?

Claude Code ist ein CLI-basiertes KI-Codierungstool von Anthropic. Es ermöglicht Entwicklern, Code mit den fortschrittlichen Modellen von Claude zu generieren, zu refaktorieren, zu testen und zu dokumentieren. Anstatt einer einfachen Chat-Oberfläche verhält sich Claude Code wie eine KI-IDE: Es versteht Ihre Repository-Struktur, wendet in Konfigurationsdateien definierte Schutzmechanismen an, kann Bash-Befehle ausführen und lässt sich in Git-Workflows integrieren.

Claude Code installieren:

# MacOS/Linux:
curl -fsSL https://claude.ai/install.sh | bash

# Windows:
irm https://claude.ai/install.ps1 | iex

# NPM:
npm install -g @anthropic-ai/claude-code

# Homebrew:
brew install --cask claude-code

Claude Code verwenden:

cd your-project
claude

Schlüsselkomponenten von Claude Code – Ihr Cheatsheet

Hier sind die wesentlichen Bausteine und Funktionen, die Sie kennen sollten, wenn Sie mit Claude Code beginnen:

1. CLAUDE.md – Agenten-Manifest

• Die Datei CLAUDE.md ist die „Verfassung“ für Ihren Agenten: Sie definiert, wie Claude sich in Ihrem Repository verhält.
• Verwenden Sie sie zur Dokumentation genehmigter Tools, gängiger Workflows und Einschränkungen.
• Bewährte Methode: Halten Sie sie kurz, konzentrieren Sie sich auf die wichtigsten Schutzmechanismen und vermeiden Sie das Einbetten sehr großer Dokumente.

# MyProject CLAUDE.md

## Project Overview
This is a Node.js + Express REST API for a task management application.

## Technology Stack
- Backend: Node.js (ES6), Express
- Database: PostgreSQL
- Testing: Jest
- Linting & Style: ESLint, Prettier

## Development Commands
- `npm install` — Install dependencies
- `npm run dev` — Start development server
- `npm run test` — Run all tests
- `npm run lint` — Run linter

## Coding Standards
- Use 2-space indentation.
- Always use `async / await` instead of `.then()` chains.
- Functions must have JSDoc comments.
- Prefer composition over inheritance.

## Git Workflow
- Feature branches must follow this pattern: `feature/FOO`
- Use `git rebase` instead of `merge` for updating branches.
- When committing: write descriptive commit messages that follow the Conventional Commits format.

## File Structure Guidance
- `src/` — Your main application code
- `tests/` — Test files
- `scripts/` — Utility or setup scripts
- `migrations/` — Database migrations

## Known Issues / Workarounds
- `db.connect()` sometimes times out; in that case, retry twice.
- For large JSON payloads, use streaming to avoid memory issues.

## Memory / Style Preferences
- Always ask for clarification if the request is ambiguous.
- Do not generate new `.md` files unless explicitly instructed.
- Include a `co-authored-by Claude` line in generated commits.

2. Kontextverwaltung

a. Verwenden Sie /context, um die Token-Nutzung Ihrer aktuellen Claude-Sitzung zu überprüfen.

b. Befehle zum Neustarten oder Verkleinern des Kontexts:

• /clear + /catchup: Löscht die gesamte Konversation und lädt dann Dateien von einem Commit oder Branch neu.
• Ein „Dokumentieren & Leeren“-Workflow: Lassen Sie Claude seinen Plan in eine Markdown-Datei schreiben, den Speicher leeren und dann aus dieser Datei neu laden.

3. Slash-Befehle

• Slash-Befehle sind Verknüpfungen zu vordefinierten Prompts.
• Beispiele:

• Halten Sie Slash-Befehle minimal und fokussiert; verlassen Sie sich nicht für jede Aufgabe auf sie.

4. Plan-Modus

• Verwenden Sie den Planungsmodus, wenn Sie komplexe Aufgaben beginnen. Claude erstellt einen Plan, bevor er Code schreibt.
• Sie können diesen Plan dann überprüfen, bearbeiten oder genehmigen, bevor Sie Claude zur Ausführung auffordern.
• Ideal für umfangreiche Feature-Arbeiten, Refactoring oder architektonische Änderungen.

5. Subagenten & Aufgaben-Delegation

• Claude Code unterstützt Subagenten, wodurch Sie Teile der Arbeit an „Klone“ des Hauptagenten delegieren können.
• Shrivu bevorzugt eine „Master-Klon“-Architektur: Der Hauptagent erzeugt Klone über Task(...), anstatt starre spezialisierte Subagenten zu verwenden.
• Dies bewahrt die Flexibilität und vermeidet gleichzeitig die Fragmentierung des Kontexts.
• Greifen Sie auf die Subagenten von Claude Code mit dem Slash-Befehl zu: /agents.

6. Claude Skills vs. MCP – Was ist der Unterschied?

a. Claude Skills sind vorgefertigte „Module“, die Claude beibringen, wie bestimmte Aufgaben ausgeführt werden. Sie sind in Markdown oder Code geschrieben und werden nur bei Bedarf geladen. Sie können Skills verwenden, um Workflows zu definieren, z. B. das Formatieren von Berichten, das Zusammenfassen von Daten oder das Durchsetzen des Teamstils.

b. Das Model Context Protocol (MCP) hingegen ist ein Protokoll zur Verbindung von Claude mit externen Daten und Tools – wie Datenbanken, Ihrer Codebasis oder Geschäftssystemen. Es ist wie ein „universeller Adapter“, der es Claude ermöglicht, auf externe Ressourcen zuzugreifen und mit ihnen zu interagieren, ohne benutzerdefinierte Integrationen für jedes Tool.

c. Hauptunterschiede:

1. Zweck:

• Skills kodieren prozedurales Wissen.
• MCP handhabt die Tool- und Datenkonnektivität.

2. Token-Effizienz:

• Skills werden nur bei Bedarf geladen und verbrauchen relativ wenige Token.
• MCP-Tooldefinitionen können erheblichen Token-Platz beanspruchen, wenn viele aktiviert sind.

d. Anwendungsfall:

• Verwenden Sie Skills, um Claude domänenspezifische Workflows beizubringen (z. B. „Beim Schreiben von Statusberichten immer X, Y, Z einfügen“).
• Verwenden Sie MCP, wenn Claude Daten lesen/schreiben, APIs aufrufen oder auf externe Systeme wie Git oder eine Datenbank zugreifen muss.

In der Praxis funktionieren die beiden am besten zusammen: MCP gibt Claude Zugriff auf Ihre Daten, und Skills lehren Claude, wie diese Daten auf strukturierte, wiederholbare Weise verwendet werden.

6. Hooks

a. Hooks sind Ihre Möglichkeit, Regeln automatisch durchzusetzen.

b. Zwei gängige Typen:

• Block-at-submit: Zum Beispiel kann ein PreToolUse-Hook git commit blockieren, es sei denn, die Tests sind bestanden.
• Hinweis-Hooks: Nicht-blockierend; sie geben Anleitungen oder Vorschläge, ohne die Ausführung zu stoppen.

c. Vermeiden Sie „Block-at-write“-Hooks – es ist stabiler, Claude seinen Plan abschließen zu lassen und dann zu validieren.

# Example Hook in .claude/settings.toml

[[hooks]]
# The event that triggers the hook.
event = "PostToolUse"

# (Optional) Conditions for the hook to run.
[hooks.matcher]
tool_name = "edit_file"
file_paths = ["*.py", "api/**/*.py"]

# The shell command to execute.
command = "ruff check --fix $CLAUDE_FILE_PATHS && black $CLAUDE_FILE_PATHS"

# (Optional) Whether to run the command in the background.
run_in_background = false 

7. CLI SDK

• Das Claude Code SDK ermöglicht es Ihnen, Claude-Interaktionen zu skripten: nützlich für die Stapelverarbeitung, den Aufbau interner Tools oder das Prototyping von Agenten.
• Verwenden Sie es, um parallele Refactorings durchzuführen, Code aus Vorlagen zu generieren oder als leichtgewichtigen Agenten in CI/CD-Workflows.

Installation:

# Typescript:
npm install @anthropic-ai/claude-agent-sdk

# Python:
pip install claude-agent-sdk

8. Claude Code GitHub Actions (GHA)

• Sie können Claude Code direkt in GitHub Actions integrieren.
• Verwenden Sie es, um Pull-Requests automatisch zu generieren, Code-Standards durchzusetzen oder CLAUDE.md-gesteuerte Prüfungen als Teil Ihrer CI-Pipeline auszuführen.
• Da Protokolle gespeichert werden, können Sie das Agentenverhalten überprüfen und Ihre CLAUDE.md-Datei im Laufe der Zeit verbessern.

9. Einstellungen & Konfiguration

a. In settings.json können Sie Folgendes konfigurieren:

• Proxy (HTTPS_PROXY) – nützlich zum Debuggen von CLI-Traffic.
• Timeouts (MCP_TOOL_TIMEOUT, BASH_MAX_TIMEOUT_MS) – erhöhen Sie diese, wenn Sie lange Aufgaben ausführen.
• API-Schlüssel (ANTHROPIC_API_KEY) – verwenden Sie Ihren Schlüssel von Anthropic oder ein Hilfsskript.
• Berechtigungen – steuern Sie, welche Systemtools Claude Code ausführen darf.

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Read(~/.zshrc)"
    ],
    "deny": [
      "Bash(curl:*)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp"
  },
  "companyAnnouncements": [
    "Willkommen bei Acme Corp! Lesen Sie unsere Code-Richtlinien unter docs.acme.com",
    "Erinnerung: Code-Reviews für alle PRs erforderlich",
    "Neue Sicherheitsrichtlinie in Kraft"
  ]
}

Erweiterte Funktionen & Produktivitätstipps

1. Modellwechsel: Wählen Sie Claude 4 Sonnet oder Opus je nach Ihrer Aufgabe. Sonnet ist schnell und kosteneffizient; Opus ist leistungsfähiger für komplexe, dateiübergreifende Änderungen.
2. Denkmodi (Cheat): Einige Benutzer stellen Claudes Denkmodus auf think, think hard, think harder oder ultrathink ein, um die Tiefe seiner Überlegungen anzupassen.
3. Benutzerdefinierte Befehle: Definieren Sie wiederverwendbare Slash-Befehle in .claude/commands mit dynamischen Platzhaltern ($argument). Ideal zum Testen, Erstellen oder Überprüfen.
4. Sitzungsverlauf: Verwenden Sie claude --resume oder claude --continue, um ältere Sitzungen fortzusetzen. Claude speichert den gesamten Sitzungsverlauf lokal.
5. Feedback-Schleife: Überprüfen Sie das Agentenverhalten über GitHub Action-Protokolle oder historische Sitzungsdaten und aktualisieren Sie Ihre CLAUDE.md, um Missverständnisse zu beheben oder bessere Schutzmechanismen durchzusetzen.

Häufig gestellte Fragen (FAQ)

F1. Was ist der Zweck von CLAUDE.md?
Antw: CLAUDE.md fungiert als Manifest des Agenten. Es definiert Regeln, Tools und Konventionen, denen Claude Code folgen soll. Es hilft, das Verhalten in Ihrem Repository zu standardisieren.

F2. Sollte ich Subagenten oder nur einfache Aufgaben verwenden?
Antw: Verwenden Sie Subagenten, wenn Sie strikte modulare Workflows wünschen. Viele finden jedoch das Master-Klon-Muster (mit Task(...)) flexibler – Sie behalten den Kontext bei, während Sie Unteraufgaben delegieren.

F3. Wie starte ich eine Claude-Sitzung neu, ohne alles zu verlieren?
Antw: Verwenden Sie /clear, um den Chat zurückzusetzen, und dann /catchup, um Dateien von Ihrem Git-Branch zu laden, damit Claude wieder den vollständigen Kontext hat.

F4. Was sind Hooks und warum brauche ich sie?
Antw: Hooks erzwingen Regeln oder Prüfungen, wenn Claude Arbeit committet. Zum Beispiel kann ein Block-at-submit-Hook sicherstellen, dass Tests bestanden werden, bevor ein Git-Commit erlaubt ist.

F5. Wie kann ich Claude Code in CI/CD integrieren?
Antw: Verwenden Sie die Claude Code GitHub Action, um Aufgaben auszuführen, Code zu validieren, Pull-Requests zu generieren oder Ihre CLAUDE.md-Schutzmechanismen in automatisierten Pipelines durchzusetzen.

Fazit

Dieses Claude Code Cheatsheet bietet Ihnen einen praktischen, strukturierten Überblick darüber, wie Sie Claude Code effektiv nutzen können. Vom Schreiben einer gut durchdachten CLAUDE.md-Datei bis hin zur Nutzung von Slash-Befehlen, Subagenten, Hooks und CI-Integration – diese Muster bilden eine solide Grundlage für die Verwendung von Claude Code als zuverlässigen KI-gestützten Entwicklungspartner.

Durch die Beherrschung dieser Funktionen können neue Entwickler schnell eingearbeitet werden, und erfahrenere Ingenieure können ihre Workflows optimieren, Schutzmechanismen durchsetzen und die durch Claude unterstützte Produktivität skalieren. Claude Code ist mehr als nur ein Code-Generierungstool – es ist ein programmierbares, agentisches System, das sich an die Bedürfnisse Ihres Teams anpasst.