Claude Code Tutorials

Dieser Leitfaden bietet Schritt-für-Schritt-Tutorials für gängige Workflows mit Claude Code. Jedes Tutorial enthält klare Anweisungen, Beispielbefehle und Best Practices, die Ihnen helfen, das Beste aus Claude Code herauszuholen.

​

Inhaltsverzeichnis

• Neue Codebasen verstehen
• Bugs effizient beheben
• Code refaktorieren
• Mit Tests arbeiten
• Pull Requests erstellen
• Dokumentation handhaben
• Mit Bildern arbeiten
• Erweitertes Denken nutzen
• Projekt-Memory einrichten
• Model Context Protocol (MCP) einrichten
• Claude als Unix-ähnliches Dienstprogramm verwenden
• Benutzerdefinierte Slash-Befehle erstellen

​

Neue Codebasen verstehen

​

Einen schnellen Überblick über die Codebasis erhalten

Wann verwenden: Sie sind gerade einem neuen Projekt beigetreten und müssen dessen Struktur schnell verstehen.

cd /path/to/project

claude

> give me an overview of this codebase

> explain the main architecture patterns used here

> what are the key data models?

> how is authentication handled?

Tipps:

• Beginnen Sie mit breiten Fragen und konzentrieren Sie sich dann auf spezifische Bereiche
• Fragen Sie nach Coding-Konventionen und Mustern, die im Projekt verwendet werden
• Bitten Sie um ein Glossar projektspezifischer Begriffe

​

Relevanten Code finden

Wann verwenden: Sie müssen Code finden, der sich auf eine bestimmte Funktion oder Funktionalität bezieht.

> find the files that handle user authentication

> how do these authentication files work together?

> trace the login process from front-end to database

Tipps:

• Seien Sie präzise bei dem, was Sie suchen
• Verwenden Sie die Domänensprache aus dem Projekt

​

Bugs effizient beheben

​

Fehlermeldungen diagnostizieren

Wann verwenden: Sie sind auf eine Fehlermeldung gestoßen und müssen deren Quelle finden und beheben.

> I'm seeing an error when I run npm test

> suggest a few ways to fix the @ts-ignore in user.ts

> update user.ts to add the null check you suggested

Tipps:

• Teilen Sie Claude den Befehl mit, um den Fehler zu reproduzieren und einen Stack Trace zu erhalten
• Erwähnen Sie alle Schritte zur Reproduktion des Fehlers
• Lassen Sie Claude wissen, ob der Fehler intermittierend oder konstant auftritt

​

Code refaktorieren

​

Legacy-Code modernisieren

Wann verwenden: Sie müssen alten Code aktualisieren, um moderne Muster und Praktiken zu verwenden.

> find deprecated API usage in our codebase

> suggest how to refactor utils.js to use modern JavaScript features

> refactor utils.js to use ES2024 features while maintaining the same behavior

> run tests for the refactored code

Tipps:

• Bitten Sie Claude, die Vorteile des modernen Ansatzes zu erklären
• Fordern Sie bei Bedarf die Aufrechterhaltung der Abwärtskompatibilität
• Führen Sie Refactoring in kleinen, testbaren Schritten durch

​

Mit Tests arbeiten

​

Testabdeckung hinzufügen

Wann verwenden: Sie müssen Tests für nicht abgedeckten Code hinzufügen.

> find functions in NotificationsService.swift that are not covered by tests

> add tests for the notification service

> add test cases for edge conditions in the notification service

> run the new tests and fix any failures

Tipps:

• Fragen Sie nach Tests, die Randfälle und Fehlerbedingungen abdecken
• Fordern Sie bei Bedarf sowohl Unit- als auch Integrationstests an
• Lassen Sie sich von Claude die Teststrategie erklären

​

Pull Requests erstellen

​

Umfassende PRs generieren

Wann verwenden: Sie müssen einen gut dokumentierten Pull Request für Ihre Änderungen erstellen.

> summarize the changes I've made to the authentication module

> create a pr

> enhance the PR description with more context about the security improvements

> add information about how these changes were tested

Tipps:

• Bitten Sie Claude direkt darum, einen PR für Sie zu erstellen
• Überprüfen Sie den von Claude generierten PR vor dem Einreichen
• Bitten Sie Claude, potenzielle Risiken oder Überlegungen hervorzuheben

​

Dokumentation handhaben

​

Code-Dokumentation generieren

Wann verwenden: Sie müssen Dokumentation für Ihren Code hinzufügen oder aktualisieren.

> find functions without proper JSDoc comments in the auth module

> add JSDoc comments to the undocumented functions in auth.js

> improve the generated documentation with more context and examples

> check if the documentation follows our project standards

Tipps:

• Geben Sie den gewünschten Dokumentationsstil an (JSDoc, Docstrings, etc.)
• Bitten Sie um Beispiele in der Dokumentation
• Fordern Sie Dokumentation für öffentliche APIs, Schnittstellen und komplexe Logik an

​

Mit Bildern arbeiten

​

Bilder und Screenshots analysieren

Wann verwenden: Sie müssen mit Bildern in Ihrer Codebasis arbeiten oder Claudes Hilfe bei der Analyse von Bildinhalten erhalten.

# 1. Ein Bild per Drag & Drop in das Claude Code-Fenster ziehen
# 2. Ein Bild kopieren und mit Strg+V in die CLI einfügen
# 3. Einen Bildpfad angeben
claude "Analyze this image: /path/to/your/image.png"

> What does this image show?
> Describe the UI elements in this screenshot
> Are there any problematic elements in this diagram?

> Here's a screenshot of the error. What's causing it?
> This is our current database schema. How should we modify it for the new feature?

> Generate CSS to match this design mockup
> What HTML structure would recreate this component?

Tipps:

• Verwenden Sie Bilder, wenn Textbeschreibungen unklar oder umständlich wären
• Fügen Sie Screenshots von Fehlern, UI-Designs oder Diagrammen für besseren Kontext hinzu
• Sie können mit mehreren Bildern in einer Konversation arbeiten
• Die Bildanalyse funktioniert mit Diagrammen, Screenshots, Mockups und mehr

​

Erweitertes Denken nutzen

​

Claudes erweitertes Denken für komplexe Aufgaben nutzen

Wann verwenden: Wenn Sie an komplexen Architekturentscheidungen, schwierigen Bugs oder der Planung mehrstufiger Implementierungen arbeiten, die tiefgehendes Nachdenken erfordern.

> I need to implement a new authentication system using OAuth2 for our API. Think deeply about the best approach for implementing this in our codebase.

> think about potential security vulnerabilities in this approach
> think harder about edge cases we should handle

Tipps, um den größten Nutzen aus erweitertem Denken zu ziehen:

Erweitertes Denken ist am wertvollsten für komplexe Aufgaben wie:

• Planung komplexer Architekturänderungen
• Debugging komplizierter Probleme
• Erstellung von Implementierungsplänen für neue Funktionen
• Verständnis komplexer Codebasen
• Bewertung von Kompromissen zwischen verschiedenen Ansätzen

Die Art, wie Sie zum Denken auffordern, führt zu unterschiedlichen Denktiefen:

• “think” löst grundlegendes erweitertes Denken aus
• Verstärkende Phrasen wie “think more”, “think a lot”, “think harder” oder “think longer” lösen tieferes Denken aus

Weitere Tipps zum erweiterten Denken finden Sie unter Tipps zum erweiterten Denken.

​

Projekt-Memory einrichten

​

Eine effektive CLAUDE.md-Datei erstellen

Wann verwenden: Sie möchten eine CLAUDE.md-Datei einrichten, um wichtige Projektinformationen, Konventionen und häufig verwendete Befehle zu speichern.

> /init

Tipps:

• Fügen Sie häufig verwendete Befehle hinzu (Build, Test, Lint), um wiederholte Suchen zu vermeiden
• Dokumentieren Sie Code-Stil-Präferenzen und Namenskonventionen
• Fügen Sie wichtige Architekturmuster hinzu, die spezifisch für Ihr Projekt sind
• Sie können CLAUDE.md-Dateien an folgenden Orten hinzufügen:
  • Im Ordner, in dem Sie Claude ausführen: Automatisch zu Gesprächen hinzugefügt, die Sie in diesem Ordner starten
  • Unterverzeichnisse: Claude lädt diese bei Bedarf
  • ~/.claude/CLAUDE.md: Benutzerspezifische Einstellungen, die Sie nicht in die Versionskontrolle aufnehmen möchten

​

Model Context Protocol (MCP) einrichten

Model Context Protocol (MCP) ist ein offenes Protokoll, das es LLMs ermöglicht, auf externe Tools und Datenquellen zuzugreifen. Weitere Details finden Sie in der MCP-Dokumentation.

​

MCP-Server konfigurieren

Wann verwenden: Sie möchten Claudes Fähigkeiten erweitern, indem Sie es mit spezialisierten Tools und externen Servern über das Model Context Protocol verbinden.

# Grundlegende Syntax
claude mcp add <name> <command> [args...]

# Beispiel: Einen lokalen Server hinzufügen
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2

# Alle konfigurierten Server auflisten
claude mcp list

# Details für einen bestimmten Server abrufen
claude mcp get my-server

# Einen Server entfernen
claude mcp remove my-server

Tipps:

• Verwenden Sie die -s oder --scope Flag, um anzugeben, wo die Konfiguration gespeichert wird:
  • local (Standard): Nur für Sie im aktuellen Projekt verfügbar (wurde in älteren Versionen project genannt)
  • project: Mit allen im Projekt über die .mcp.json-Datei geteilt
  • user: Für Sie in allen Projekten verfügbar (wurde in älteren Versionen global genannt)
• Setzen Sie Umgebungsvariablen mit -e oder --env Flags (z.B. -e KEY=value)
• Konfigurieren Sie das MCP-Server-Startup-Timeout mit der MCP_TIMEOUT-Umgebungsvariable (z.B. setzt MCP_TIMEOUT=10000 claude ein 10-Sekunden-Timeout)
• Überprüfen Sie den MCP-Server-Status jederzeit mit dem /mcp-Befehl in Claude Code
• MCP folgt einer Client-Server-Architektur, bei der sich Claude Code (der Client) mit mehreren spezialisierten Servern verbinden kann

​

MCP-Server-Scopes verstehen

Wann verwenden: Sie möchten verstehen, wie verschiedene MCP-Scopes funktionieren und wie Sie Server mit Ihrem Team teilen können.

# Einen lokal-scoped Server hinzufügen (Standard)
claude mcp add my-private-server /path/to/server

# Lokalen Scope explizit angeben
claude mcp add my-private-server -s local /path/to/server

# Einen projekt-scoped Server hinzufügen
claude mcp add shared-server -s project /path/to/server

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

# Einen Benutzer-Server hinzufügen
claude mcp add my-user-server -s user /path/to/server

Tipps:

• Lokal-scoped Server haben Vorrang vor projekt-scoped und benutzer-scoped Servern mit demselben Namen
• Projekt-scoped Server (in .mcp.json) haben Vorrang vor benutzer-scoped Servern mit demselben Namen
• Bevor projekt-scoped Server aus .mcp.json verwendet werden, wird Claude Code Sie aus Sicherheitsgründen um Zustimmung bitten
• Die .mcp.json-Datei ist dafür gedacht, in die Versionskontrolle aufgenommen zu werden, um MCP-Server mit Ihrem Team zu teilen
• Projekt-scoped Server machen es einfach sicherzustellen, dass jeder in Ihrem Team Zugriff auf dieselben MCP-Tools hat
• Wenn Sie Ihre Auswahl für aktivierte oder deaktivierte projekt-scoped Server zurücksetzen müssen, verwenden Sie den Befehl claude mcp reset-project-choices

​

Mit einem Postgres MCP-Server verbinden

Wann verwenden: Sie möchten Claude schreibgeschützten Zugriff auf eine PostgreSQL-Datenbank für Abfragen und Schema-Inspektion geben.

claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

# In Ihrer Claude-Sitzung können Sie Fragen über Ihre Datenbank stellen

> describe the schema of our users table
> what are the most recent orders in the system?
> show me the relationship between customers and invoices

Tipps:

• Der Postgres MCP-Server bietet aus Sicherheitsgründen schreibgeschützten Zugriff
• Claude kann Ihnen helfen, Datenbankstrukturen zu erkunden und analytische Abfragen durchzuführen
• Sie können dies nutzen, um Datenbankschemata in unbekannten Projekten schnell zu verstehen
• Stellen Sie sicher, dass Ihr Verbindungsstring geeignete Anmeldeinformationen mit minimalen erforderlichen Berechtigungen verwendet

​

MCP-Server aus JSON-Konfiguration hinzufügen

Wann verwenden: Sie haben eine JSON-Konfiguration für einen einzelnen MCP-Server, den Sie zu Claude Code hinzufügen möchten.

# Grundlegende Syntax
claude mcp add-json <name> '<json>'

# Beispiel: Einen stdio-Server mit JSON-Konfiguration hinzufügen
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get weather-api

Tipps:

• Stellen Sie sicher, dass das JSON in Ihrer Shell richtig escaped ist
• Das JSON muss dem MCP-Server-Konfig

urationsschema entsprechen

• Sie können -s global verwenden, um den Server zu Ihrer globalen Konfiguration statt zur projektspezifischen hinzuzufügen

​

MCP-Server aus Claude Desktop importieren

Wann verwenden: Sie haben bereits MCP-Server in Claude Desktop konfiguriert und möchten dieselben Server in Claude Code verwenden, ohne sie manuell neu zu konfigurieren.

# Grundlegende Syntax
claude mcp add-from-claude-desktop

claude mcp list

Tipps:

• Diese Funktion funktioniert nur unter macOS und Windows Subsystem for Linux (WSL)
• Sie liest die Claude Desktop-Konfigurationsdatei von ihrem Standardspeicherort auf diesen Plattformen
• Verwenden Sie die -s global Flag, um Server zu Ihrer globalen Konfiguration hinzuzufügen
• Importierte Server haben dieselben Namen wie in Claude Desktop
• Wenn Server mit denselben Namen bereits existieren, erhalten sie ein numerisches Suffix (z.B. server_1)

​

Claude Code als MCP-Server verwenden

Wann verwenden: Sie möchten Claude Code selbst als MCP-Server verwenden, mit dem sich andere Anwendungen verbinden können, um Zugriff auf Claudes Tools und Fähigkeiten zu erhalten.

# Grundlegende Syntax
claude mcp serve

{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}

Tipps:

• Der Server bietet Zugriff auf Claudes Tools wie View, Edit, LS, etc.
• In Claude Desktop können Sie Claude bitten, Dateien in einem Verzeichnis zu lesen, Änderungen vorzunehmen und mehr
• Beachten Sie, dass dieser MCP-Server einfach die Tools von Claude Code für Ihren MCP-Client verfügbar macht, sodass Ihr eigener Client für die Implementierung der Benutzerbestätigung für einzelne Tool-Aufrufe verantwortlich ist

​

Claude als Unix-ähnliches Dienstprogramm verwenden

​

Claude zu Ihrem Verifizierungsprozess hinzufügen

Wann verwenden: Sie möchten Claude Code als Linter oder Code-Reviewer verwenden.

Schritte:

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}

​

Ein- und Ausgabe über Pipes

Wann verwenden: Sie möchten Daten in Claude einleiten und strukturierte Daten zurückerhalten.

cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

​

Benutzerdefinierte Slash-Befehle erstellen

Claude Code unterstützt benutzerdefinierte Slash-Befehle, die Sie erstellen können, um schnell bestimmte Prompts oder Aufgaben auszuführen.

​

Projektspezifische Befehle erstellen

Wann verwenden: Sie möchten wiederverwendbare Slash-Befehle für Ihr Projekt erstellen, die alle Teammitglieder nutzen können.

mkdir -p .claude/commands

echo "Analyze the performance of this code and suggest three specific optimizations:" > .claude/commands/optimize.md

claude
> /project:optimize

Tipps:

• Befehlsnamen werden vom Dateinamen abgeleitet (z.B. wird optimize.md zu /project:optimize)
• Sie können Befehle in Unterverzeichnissen organisieren (z.B. wird .claude/commands/frontend/component.md zu /project:frontend:component)
• Projektbefehle sind für jeden verfügbar, der das Repository klont
• Der Inhalt der Markdown-Datei wird zum Prompt, der an Claude gesendet wird, wenn der Befehl aufgerufen wird

​

Befehlsargumente mit $ARGUMENTS hinzufügen

Wann verwenden: Sie möchten flexible Slash-Befehle erstellen, die zusätzliche Eingaben von Benutzern akzeptieren können.

echo "Find and fix issue #$ARGUMENTS. Follow these steps:
1. Understand the issue described in the ticket
2. Locate the relevant code in our codebase
3. Implement a solution that addresses the root cause
4. Add appropriate tests
5. Prepare a concise PR description" > .claude/commands/fix-issue.md

claude
> /project:fix-issue 123

Tipps:

• Der $ARGUMENTS-Platzhalter wird durch beliebigen Text ersetzt, der dem Befehl folgt
• Sie können $ARGUMENTS überall in Ihrer Befehlsvorlage positionieren
• Andere nützliche Anwendungen: Testfälle für bestimmte Funktionen generieren, Dokumentation für Komponenten erstellen, Code in bestimmten Dateien überprüfen oder Inhalte in bestimmte Sprachen übersetzen

​

Persönliche Slash-Befehle erstellen

Wann verwenden: Sie möchten persönliche Slash-Befehle erstellen, die in allen Ihren Projekten funktionieren.

mkdir -p ~/.claude/commands

echo "Review this code for security vulnerabilities, focusing on:" > ~/.claude/commands/security-review.md

claude
> /user:security-review

Tipps:

• Persönliche Befehle haben das Präfix /user: statt /project:
• Persönliche Befehle sind nur für Sie verfügbar und werden nicht mit Ihrem Team geteilt
• Persönliche Befehle funktionieren in allen Ihren Projekten
• Sie können diese für konsistente Workflows über verschiedene Codebasen hinweg verwenden

​

Nächste Schritte