# 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.