---
# System prepended metadata

title: Claude Code – Vollständige Dokumentation

---

# Claude Code – Dokumentation & Anleitung
> Stand: Februar 2026 | Quellen: anthropic.com/news/skills (Okt 2025), alexop.dev (Dez 2025), docs.claude.com

---

## Übersicht: Das Customization-Stack

| Mechanismus | Trigger | Scope | Dateipfad |
|---|---|---|---|
| **CLAUDE.md** | Automatisch, jede Session | Immer aktiv | `CLAUDE.md` oder `.claude/CLAUDE.md` |
| **Slash Commands** | Manuell `/befehl` | On-demand | `.claude/commands/*.md` |
| **Subagents** | Per `Task`-Tool oder automatisch | Eigenes Context-Window | `.claude/agents/*.md` |
| **Skills** | Auto-discovery durch Claude | Aufgabenbasiert | `~/.claude/skills/<n>/SKILL.md` |
| **Hooks** | Event-basiert | Systemweit | `.claude/settings.json` |

---

## 1. CLAUDE.md – Projektgedächtnis

Wird **automatisch in jede Session geladen**. Funktioniert als persistente Projektanweisung.

### Dateipfade
```
project-root/
├── CLAUDE.md                    # Projektebene – immer geladen
├── .claude/
│   └── CLAUDE.md               # Alternative Projektebene
├── src/
│   └── CLAUDE.md               # Lazy – nur wenn Claude in src/ arbeitet
└── tests/
    └── CLAUDE.md               # Lazy – nur wenn Claude in tests/ arbeitet
```

Nested CLAUDE.md-Dateien werden **lazy geladen** – nur wenn Claude Dateien im jeweiligen Verzeichnis liest. Hält den Haupt-Context schlank.

### Template
```markdown
# Projektname

## Stack
- Technologien, Frameworks, Versionen

## Code-Konventionen
- Sprache, Namenskonvention, Stil

## Kritische Regeln
1. Was Claude nie tun soll
2. Pflichtschritte vor bestimmten Aktionen

## Externe Dokumentation
- Welche Docs vor bestimmten Aufgaben geholt werden sollen

## Häufige Fallstricke
- Bekannte Fehlerquellen im Projekt
```

### Trade-offs
**Vorteile:** Kein Aufwand, immer aktiv, via Git teamweit teilbar  
**Nachteile:** Context Drift in langen Sessions – Claude kann frühe Instruktionen deprioritisieren

---

## 2. Slash Commands – Manuelle Makros

Gespeicherte Prompts, aufrufbar mit `/befehlsname [argumente]`.

### Dateipfad
```
.claude/commands/
├── mein-command.md
└── anderer-command.md
```

### Frontmatter
```yaml
---
description: Wird für Auto-Discovery genutzt (Claude schlägt Command vor)
allowed-tools: Read, Grep, Glob, WebFetch, Bash, Task, Write
---
```

### Beispiel: Einfacher Command
```markdown
---
description: Analysiert eine Datei und gibt Verbesserungsvorschläge
allowed-tools: Read, Grep
---

Analysiere die folgende Datei: $ARGUMENTS

Prüfe auf:
1. Code-Qualität
2. Potenzielle Bugs
3. Verbesserungsmöglichkeiten

Gib strukturiertes Feedback mit KRITISCH / WARNUNG / INFO.
```

### Verwendung
```bash
/mein-command ./src/myfile.ts
```

`$ARGUMENTS` nimmt alles entgegen, was nach dem Command eingegeben wird.

### Orchestrierung: Command mit parallelen Subagents
```markdown
---
allowed-tools: Task, WebSearch, Read, Write
---
Recherchiere $ARGUMENTS. Starte parallel:
1. Task (subagent_type: general-purpose): Web-Recherche und Dokumentation
2. Task (subagent_type: Explore): Codebase nach ähnlichen Patterns durchsuchen

Schreibe Ergebnis nach docs/research/<datum>-<thema>.md
```

---

## 3. Subagents – Spezialisierte Unteragenten

Separate Claude-Instanzen mit **eigenem Context-Window**. Claude delegiert eine Aufgabe und bekommt nur das Ergebnis – der Haupt-Context bleibt sauber.

### Dateipfad
```
.claude/agents/
├── code-reviewer.md
├── documentation-writer.md
└── security-checker.md
```

### Wann Subagents nutzen?
- Viel Kontext-Lärm (viele Dateien lesen, Web-Suche)
- Parallele Aufgaben
- Plan-Mode: Claude startet automatisch `Explore`-Subagents für Codebase-Scanning

### Async-Modus
`Ctrl + B` – Subagent in den Hintergrund schicken und parallel weiterarbeiten

### Beispiel: Code Reviewer Agent
```markdown
# Code Reviewer

Du bist spezialisiert auf Code-Reviews mit Fokus auf Sicherheit und Wartbarkeit.

## Fokus
- Security-Schwachstellen
- Performance-Probleme
- Code-Duplizierung
- Fehlende Error-Handling

## Output-Format
- RISIKO-LEVEL: KRITISCH / HOCH / MITTEL / NIEDRIG
- Betroffene Zeile(n)
- Konkreter Lösungsvorschlag
```

### Eingebaute Subagent-Typen
| Typ | Verwendung |
|---|---|
| `general-purpose` | Allgemeine Aufgaben, Web-Suche |
| `Explore` | Codebase-Scanning, File-Discovery |
| `claude-code-guide` | Offizielle Claude Code Dokumentation abrufen |

---

## 4. Skills – Auto-Discovery Capabilities

Ordner mit Instruktionen, Scripts und Ressourcen. Claude **lädt einen Skill automatisch**, wenn die Beschreibung zur aktuellen Aufgabe passt. Eingeführt Oktober 2025.

Skills funktionieren identisch in Claude.ai, Claude Code und API.

### Struktur
```
~/.claude/skills/
└── mein-skill/
    ├── SKILL.md              # Haupt-Instruktionen (Pflicht)
    ├── scripts/              # Executable Scripts
    ├── templates/            # Vorlagen
    └── references/           # Referenz-Dokumentation
```

### SKILL.md Aufbau
```markdown
---
name: skill-name
description: >
  Wann dieser Skill geladen werden soll. Trigger-Phrasen einfügen.
  Beispiel: "Verwende wenn der User nach X fragt oder Y macht."
---

# Skill-Titel

## Workflow
1. Schritt 1
2. Schritt 2
3. Schritt 3

## Verfügbare Scripts
- `scripts/script.sh` – Beschreibung

## Output-Format
Wie das Ergebnis aussehen soll
```

### Skill erstellen (interaktiv)
```bash
/skill-creator
```
Claude fragt nach dem Workflow, generiert Ordnerstruktur und SKILL.md automatisch.

### Skills aus Marketplace installieren
```bash
/plugin marketplace add <author>/<repo>
/plugin install <skill-name>@<marketplace>
```

### Vergleich: Slash Command vs. Skill
| | Slash Command | Skill |
|---|---|---|
| Trigger | Manuell `/befehl` | Auto-Discovery |
| Supporting-Files | Nein (single file) | Ja (ganzer Ordner) |
| Discovery | Terminal-Autocomplete | Claude entscheidet |
| Komplexität | Niedrig | Höher |

---

## 5. Hooks – Event-basierte Automatisierung

Bash-Befehle, die bei bestimmten Claude Code Events ausgeführt werden.

### Konfiguration: `.claude/settings.json`
```json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{
          "type": "command",
          "command": "echo \"$(date): Bash ausgeführt\" >> ~/.claude/audit.log"
        }]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Write",
        "hooks": [{
          "type": "command",
          "command": "git add -A"
        }]
      }
    ],
    "Stop": [{
      "type": "command",
      "command": "osascript -e 'display notification \"Claude fertig\" with title \"Claude Code\"'"
    }]
  }
}
```

### Verfügbare Events
| Event | Zeitpunkt |
|---|---|
| `PreToolUse` | Vor jedem Tool-Aufruf |
| `PostToolUse` | Nach jedem Tool-Aufruf |
| `Stop` | Wenn Claude fertig ist oder Input braucht |
| `WorktreeCreate` | Bei Git-Worktree-Erstellung |
| `WorktreeRemove` | Bei Git-Worktree-Löschung |

---

## 6. Vollständige Ordnerstruktur

```
project-root/
├── CLAUDE.md                          # Immer geladen
│
├── .claude/
│   ├── CLAUDE.md                      # Alternative Hauptdatei
│   ├── settings.json                  # Hooks, Permissions, Config
│   │
│   ├── commands/                      # Slash Commands
│   │   ├── review.md                  # /review
│   │   └── research.md                # /research
│   │
│   ├── agents/                        # Subagent-Definitionen
│   │   ├── code-reviewer.md
│   │   └── documentation-writer.md
│   │
│   └── rules/                         # Auto-geladene Regeln (nach Glob)
│       └── coding-standards.md
│
├── src/
│   └── CLAUDE.md                      # Lazy – src/-Kontext
│
└── tests/
    └── CLAUDE.md                      # Lazy – test/-Kontext
```

---

## 7. Entscheidungsmatrix

| Situation | Empfehlung |
|---|---|
| Immer gültige Projektregeln | **CLAUDE.md** |
| Aufgabe auf expliziten Abruf | **Slash Command** |
| Viele Dateien lesen / Web-Recherche | **Subagent** (Context schützen) |
| Spezialisierter Workflow mit Supporting-Files | **Skill** |
| Reaktion auf Events / Datei-Änderungen | **Hook** |
| Parallelisierung mehrerer Aufgaben | **Subagents via Task-Tool** |

---

## 8. Wichtige CLI-Befehle

```bash
# Installation
npm install -g @anthropic-ai/claude-code

# Start
claude

# Skill interaktiv erstellen
/skill-creator

# Plugin installieren
/plugin marketplace add <author>/<repo>
/plugin install <name>@<marketplace>

# Subagent in Hintergrund schicken
Ctrl + B

# Langen Context komprimieren
/compact
```

---

## 9. Quellen

| Quelle | URL | Datum |
|---|---|---|
| Agent Skills Announcement (Anthropic) | https://www.anthropic.com/news/skills | Okt 2025 |
| Claude Code Docs (offiziell) | https://docs.claude.com/en/docs/claude-code/overview | Aktuell |
| Customization-Guide (alexop.dev) | https://alexop.dev/posts/claude-code-customization-guide-claudemd-skills-subagents/ | Dez 2025 |
| Common Workflows | https://code.claude.com/docs/en/common-workflows | Aktuell |
| Awesome Claude Code (Community) | https://github.com/hesreallyhim/awesome-claude-code | Aktuell |

> **Hinweis:** Hooks-Syntax aus Community-Dokumentation – für finale Implementierung `docs.claude.com` verifizieren.