Skills, CLAUDE.md, Subagenten, Hooks oder MCP – wann man was verwendet
Claude Code hat fünf Anpassungsebenen. CLAUDE.md, Skills, Sub-Agents, Hooks und MCP-Server. Wählen Sie die falsche und Sie erhalten einen Skill, der nie ausgelöst wird, einen Hook, der die Arbeit eines Sub-Agents erledigt, oder ein CLAUDE.md, das so aufgebläht ist, dass es die Hälfte Ihres Kontexts verbraucht, bevor Sie überhaupt tippen.
Hier ist, wo jeder seinen Platz hat.
CLAUDE.md
Wird in jeder Konversation geladen. Verwenden Sie es für Regeln, die niemals übersprungen werden sollen, wie z. B. „TypeScript-Strict-Mode“ oder „niemals das Datenbankschema ändern“.
Wenn eine Regel nur manchmal wichtig ist, gehört sie hier nicht hin. Sie zahlen für jeden Prompt Token dafür.
Anthropic's Faustregel besagt, dass CLAUDE.md unter 200 Zeilen bleiben sollte. Fragen Sie sich für jede Zeile, ob deren Entfernung Claude tatsächlich zu Fehlern verleiten würde. Wenn nicht, streichen Sie sie. Ein aufgeblähtes CLAUDE.md lässt Claude nicht mehr Regeln befolgen, sondern dazu führen, dass Claude die Hälfte davon ignoriert, weil die wichtigen Regeln im Rauschen untergehen.
Wenn es über 200 Zeilen hinauswächst, ist die offizielle Empfehlung, Referenzinhalte in Skills zu verschieben oder in .claude/rules/-Dateien aufzuteilen, die nur geladen werden, wenn Claude an passenden Pfaden arbeitet.
Skills
Markdown-Dateien, die Claude automatisch lädt, wenn eine Anfrage mit der Beschreibung in ihrem Frontmatter übereinstimmt. Der richtige Ort für PR-Review-Checklisten, Release-Prozeduren, bibliotheksspezifische Konventionen, alles Aufgabenspezifische.
Die Beschreibung muss zwei Dinge abdecken: was der Skill tut und wann er verwendet werden soll. Lassen Sie das „Wann“ weg und Claude lädt den Skill nie, egal wie gut der Inhalt ist. Stellen Sie den wichtigsten Anwendungsfall an erste Stelle, da die Beschreibung in der Skill-Liste auf 1.536 Zeichen begrenzt ist.
Der Inhalt hat seine eigene Grenze. Anthropic empfiehlt, SKILL.md unter 500 Zeilen zu halten und lange Referenzmaterialien in separate Dateien zu verschieben, auf die der Skill verweist. Sobald ein Skill geladen ist, bleibt sein Inhalt für den Rest der Sitzung im Kontext, sodass jede Zeile wiederkehrende Token-Kosten verursacht.
Sub-Agents
Laufen in ihrem eigenen Kontextfenster. Sie übergeben einem eine Aufgabe, er arbeitet unabhängig mit seinem eigenen Token-Budget, und Sie erhalten das Ergebnis zurück.
Am besten für parallele Recherchen, die Isolierung von „schmutziger“ Arbeit oder Aufgaben, die Tools benötigen, die Sie nicht in Ihrer Hauptsitzung haben möchten. Die Koordination mehrerer gleichzeitig erfordert etwas Sorgfalt, da sie keinen gemeinsamen Zustand haben.
Sub-Agents können auch Skills verwenden, aber Sie müssen sie explizit mit dem skills Frontmatter-Feld verdrahten. Im Gegensatz zur Hauptsitzung werden Skill-Beschreibungen nicht automatisch in den Sub-Agent geladen, sodass die Auslösung durch Übereinstimmung der Beschreibung nicht von selbst geschieht.
Hooks
CLAUDE.md-Anweisungen sind ratsam, Claude entscheidet, ob er ihnen folgt. Hooks sind deterministisch. Das Ereignis tritt ein, der Hook wird ausgeführt, es gibt keine Beurteilung. Sie sind die einzigen der fünf, die das Modell vollständig umgehen.
Die Ereignisse, in die die meisten Leute eingreifen, sind PreToolUse (Validierung oder Blockierung eines Tool-Aufrufs, bevor er ausgeführt wird), PostToolUse (Reaktion nach einem Tool-Aufruf, z. B. Linting von Dateien, die Claude gerade bearbeitet hat), UserPromptSubmit (Abfangen dessen, was an Claude gesendet wird) und SessionStart (Laden des Kontexts einmal pro Sitzung).
Deshalb sind Hooks der richtige Ort für Guardrails. „Niemals .env bearbeiten“ in CLAUDE.md oder einem Skill ist eine Anfrage. Ein PreToolUse-Hook, der die Bearbeitung blockiert, ist eine Durchsetzung.
Wenn Ihre Regel lautet: „Führe X jedes Mal aus, wenn Claude Y tut“, ist das ein Hook. Linter, Formatierer, Validatoren, Audit-Protokollierung.
MCP-Server
Die anderen vier formen, wie Claude denkt. MCP gibt Claude neue Dinge zu tun, wie die Kommunikation mit APIs, Datenbanken oder internen Systemen. Manchmal reicht eine CLI, manchmal braucht man tatsächlich einen MCP-Server.
Wie sie sich kombinieren
- CLAUDE.md für harte Regeln
- Skills für Prozeduren und Domänenwissen
- Sub-Agents für delegierte Arbeit
- Hooks für automatische Nebeneffekte
- MCP-Server für die Außenwelt
Die Falle ist, alles in Skills zu kippen. Eine Einschränkung, die immer gilt, gehört immer noch in CLAUDE.md. Ein Nebeneffekt beim Speichern einer Datei gehört immer noch in einen Hook.
Für die Langfassung bietet Anthropic den kostenlosen Kurs „Introduction to Agent Skills“ auf Skilljar, der das gesamte Regelwerk abdeckt, und das Dreiminuten-Video behandelt es in der Zeit, die man zum Kaffee kochen braucht.