Agent Skills, MCP-Server oder Regeldateien?

Agent Skills vs. MCP-Server vs. Regeldateien: die kurze Antwort

Agent Skills, MCP-Server und Regeldateien stellen einem Coding-Agent Wissen bereit. Entscheiden Sie anhand der Funktion des Wissens. MCP (Model Context Protocol) eignet sich für Daten, die beim nächsten Abruf anders sein können. Ein Skill beschreibt einen Ablauf, den Sie heute dokumentieren könnten und der in sechs Wochen noch korrekt wäre. Eine Regeldatei enthält die wenigen Vorgaben, die in jeder Sitzung gelten müssen.

Diese Entscheidung hat einen Preis: Kontext. Jedes Token für eine Anweisung, die der Agent nicht benötigt, steht für den Code, den er liest, nicht zur Verfügung. Außerdem bezahlen Sie dieses Token bei jeder Anfrage erneut, weil das gesamte Kontextfenster mit jeder Anfrage erneut übertragen wird. Die entscheidende Frage lautet daher nicht, welcher Mechanismus die Aufgabe erledigen kann. In den meisten Fällen können das alle drei. Entscheidend ist, welcher Mechanismus im Leerlauf die geringsten Kosten verursacht.

Was jedes Element kostet, bevor Sie es verwenden

Die drei Elemente werden zu unterschiedlichen Zeitpunkten geladen. Genau darin liegt der entscheidende Unterschied.

Eine Regeldatei wird beim Start vollständig geladen, in jeder Sitzung und unabhängig davon, ob ihr Inhalt relevant ist. Claude Code liest CLAUDE.md zu Beginn jeder Unterhaltung und lädt die Datei unabhängig von ihrer Länge vollständig. Das dokumentierte Ziel sind weniger als 200 Zeilen pro Datei, weil eine längere Datei mehr Kontext verbraucht und ihre Vorgaben außerdem weniger zuverlässig befolgt werden. Beide Effekte verstärken sich gegenseitig. Deshalb ist eine Regeldatei mit 900 Zeilen schlimmer als nutzlos.

Ein Skill wird in zwei Stufen geladen. Beim Start gelangt nur die description-Zeile aus dem SKILL.md-Frontmatter jedes Skills in den Kontext. Dadurch weiß das Modell, dass der Skill existiert und ungefähr, wann er gilt. Der Inhalt wird geladen, wenn der Skill aufgerufen wird. Ein Referenzdokument mit 400 Zeilen kostet Sie daher fast nichts, bis es benötigt wird.

Ein MCP-Server war früher das teuerste Element. Genau hier sind die meisten Vergleiche, die Sie heute lesen, veraltet. In aktuellen Versionen von Claude Code ist die Tool-Suche standardmäßig aktiviert. Zu Beginn der Sitzung werden nur die Toolnamen und das Instructions-Feld des Servers geladen. Die vollständigen JSON-Schemas (JavaScript Object Notation) werden erst geladen, wenn Claude danach sucht. Das Hinzufügen eines Servers kostet daher nicht mehr im Voraus Tausende von Tokens. Es kostet weiterhin etwas. In Konfigurationen mit deaktivierter Tool-Suche wird jedoch weiterhin alles im Voraus geladen.

[
  {
    "label": "Rules file, 200 lines",
    "at_startup": "2,500",
    "after_use": "2,500"
  },
  {
    "label": "Skill, 12 KB body",
    "at_startup": 40,
    "after_use": "3,000"
  },
  {
    "label": "MCP server, tool search on",
    "at_startup": 500,
    "after_use": "3,200"
  },
  {
    "label": "MCP server, tool search off",
    "at_startup": "4,500",
    "after_use": "4,500"
  }
]

Das sind Schätzwerte und keine Messungen von Ihrem Rechner. Sie basieren auf dem Umfang des Textes, den der jeweilige Mechanismus lädt, bei ungefähr vier Zeichen pro Token: Eine Regeldatei mit 200 Zeilen umfasst etwa 10 KB Markdown, eine Skill-Beschreibung etwa 160 Zeichen, und ein Server mit zwölf Tools enthält etwa 18 KB Schemas plus einen Instructions-Block mit 2 KB. Claude Code kürzt jede Tool-Beschreibung und jedes Instructions-Feld eines Servers auf 2 KB. Für diesen Teil gibt es daher eine Obergrenze. Im nächsten Abschnitt erfahren Sie, wie Sie stattdessen Ihre eigenen tatsächlichen Werte ermitteln.

Lesen Sie die ersten beiden Zeilen gemeinsam. Die Regeldatei kostet 2,500 Tokens in einer Sitzung, in der sie niemand benötigt. Der Skill kostet in derselben Sitzung 40 Tokens und in der Sitzung, in der er verwendet wird, 3,000. Das geschieht in einer von zehn Sitzungen. Die letzten beiden Zeilen betreffen denselben Server zweimal, jeweils mit aktivierter und deaktivierter Tool-Suche: 500 Tokens gegenüber 4,500. Dieser Unterschied ist der Grund, warum sich alte Hinweise zur Aufblähung des MCP-Kontexts weiterhin halten.

Die Tool-Suche erfordert ein Modell, das tool_reference-Blöcke unterstützt. Im August 2026 sind das Claude Sonnet 4.5, Haiku 4.5, Opus 4.5 und spätere Versionen. Claude Code deaktiviert die Funktion, wenn ANTHROPIC_BASE_URL auf einen Host verweist, der nicht zum Hersteller gehört, weil die meisten Proxys diese Blöcke nicht weiterleiten. Mit ENABLE_TOOL_SEARCH steuern Sie die Funktion: false lädt jedes Schema im Voraus, true verschiebt alle Schemas, und auto lädt die Schemas nur dann im Voraus, wenn sie zusammen in 10% des Kontextfensters Platz finden.

# Load schemas up front only if they fit in 5% of the window
ENABLE_TOOL_SEARCH=auto:5 claude

Die entscheidende Frage lautet: Ändern sich die Daten zwischen den Aufrufen?

Stellen Sie diese Frage zuerst, weil sie eine Option unmittelbar ausschließt. Wenn der Agent etwas lesen oder schreiben muss, das beim nächsten Zugriff anders sein kann, benötigen Sie einen Server. Ein Issue-Tracker, eine Datenbank, ein Monitoring-Dashboard oder Ihre eigene interne API (application programming interface). Das Aufschreiben hilft nicht, weil die Information veraltet ist, sobald jemand anderes den Datensatz bearbeitet.

Wenn die Antwort auch in sechs Wochen noch korrekt wäre, ohne dass sie jemand pflegt, benötigen Sie eine Skill. Eine Checkliste für Releases. Eine Migrationsprozedur. Der Aufbau Ihrer Fehlermeldungen. Die Vorgaben dieses Repositorys für das Schreiben von Tests. Eine Skill ist eine Datei in git. Sie hat keinen Port, keinen Prozess und keinen anderen Fehlerzustand als den, falsch zu sein. Das kann eine Codeprüfung erkennen.

Wenn es sich um eine einzelne Tatsache handelt, die für Arbeiten gelten muss, an die Sie noch nicht gedacht haben, tragen Sie sie in die Regeldatei ein. Run make lint before committing. Never push to main. Handlers live in src/api/handlers/. Eine Zeile pro Eintrag. Sobald ein Eintrag zu einer Folge von Schritten anwächst, ist er keine Tatsache mehr, sondern eine Prozedur, und sollte in eine Skill verschoben werden.

Wenn eine Regeldatei ausreicht

Regeldateien werden aus mehreren Speicherorten geladen, vom allgemeinsten zum spezifischsten: einer verwalteten Richtliniendatei, Ihrer persönlichen ~/.claude/CLAUDE.md, der ./CLAUDE.md oder ./.claude/CLAUDE.md des Projekts und einer von Git ignorierten ./CLAUDE.local.md. Alle gefundenen Dateien werden aneinandergehängt, statt sich gegenseitig zu überschreiben. Dateien in der Nähe Ihres Arbeitsverzeichnisses werden zuletzt gelesen.

Claude Code liest CLAUDE.md, nicht AGENTS.md. Wenn Ihr Repository bereits eine AGENTS.md für andere Tools enthält, sollten Sie keine zwei Kopien pflegen, die auseinanderlaufen können.

ln -s AGENTS.md CLAUDE.md

Der symbolische Link gibt bei Erfolg nichts aus. Starten Sie eine Sitzung, führen Sie /context aus und prüfen Sie, ob CLAUDE.md unter Memory files angezeigt wird. Wenn die Datei dort nicht aufgeführt ist, hat der Agent sie noch nie gesehen. Eine andere Formulierung hilft dann nicht. Wenn Sie zusätzlich Claude-spezifische Zeilen benötigen, verwenden Sie stattdessen die Importform und setzen Sie diese Zeilen unter den Import.

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

Hier gibt es eine wichtige Falle. @path-Imports sparen keinen Kontext. Die importierte Datei wird beim Start zusammen mit der Datei erweitert und geladen, die auf sie verweist, und zwar bis zu einer Tiefe von vier Ebenen. Wenn Sie eine Regeldatei mit 600 Zeilen in sechs Imports aufteilen, wird sie für Menschen übersichtlicher. Die Token-Kosten ändern sich dadurch jedoch exakt um nichts. Die Konventionen hinter AGENTS.md und dem für Menschen gedachten Gegenstück sollten Sie lesen, bevor Sie sich für eine Struktur entscheiden.

Die Kosten lassen sich mit .claude/rules/ und einem Feld paths reduzieren. Eine Regeldatei mit paths-Frontmatter wird nur geladen, wenn der Agent eine Datei verarbeitet, die einem der Muster entspricht.

---
paths:
  - "src/api/**/*.ts"
---

# API rules

- Every endpoint validates its input.
- Use the standard error response shape.

Eine Regel ohne Feld paths wird beim Start mit derselben Priorität wie .claude/CLAUDE.md geladen. Das übliche Muster besteht daher aus kurzen, bedingungslosen Regeln sowie einer paths-Liste für alles, was nur innerhalb eines bestimmten Verzeichnisses relevant ist.

Wenn Sie eine Fähigkeit benötigen

Eine Fähigkeit ist ein Verzeichnis mit einer SKILL.md darin. Persönliche Fähigkeiten liegen unter ~/.claude/skills/<name>/SKILL.md und gelten für jedes Projekt auf Ihrem Rechner. Projektfähigkeiten liegen unter .claude/skills/<name>/SKILL.md, werden mit dem Repository versioniert und können wie jede andere Datei in einem Pull Request geprüft werden.

mkdir -p ~/.claude/skills/summarize-changes

---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

Run `git status` and `git diff` against the merge base.
Group the changes by intent, not by file.
Call out anything touching auth, migrations or deletions.

Die description ist der einzige Teil dieser Datei, der bereits vor der Ausführung der Fähigkeit im Kontext steht. Sie erfüllt daher zwei Aufgaben. Sie beschreibt, was die Fähigkeit tut, und legt fest, wann sie verwendet werden soll. Eine Beschreibung wie „Unterstützt bei Deployments“ bietet dem Modell keinen konkreten Ansatzpunkt für eine Anfrage. Die Fähigkeit wird dann unbemerkt nie aktiviert, und Sie kommen zu dem Schluss, dass Fähigkeiten nicht funktionieren.

Der Verzeichnisname wird zum Befehl. Das obige Beispiel ergibt daher /summarize-changes. Bei einer persönlichen oder projektbezogenen Fähigkeit legt das Frontmatter name nur die Anzeigenbezeichnung in Auflistungen fest.

Sobald eine Fähigkeit aufgerufen wird, wird ihr gerenderter Inhalt als einzelne Nachricht in die Konversation eingefügt und bleibt dort für den Rest der Sitzung. Claude Code liest die Datei in späteren Nachrichten nicht erneut ein. Formulieren Sie daher dauerhafte Anweisungen statt einmaliger Arbeitsschritte. Halten Sie den Inhalt außerdem kompakt, weil ab diesem Zeitpunkt jede Zeile bei jeder Anfrage erneut Kosten verursacht. Nach der automatischen Kontextkomprimierung fügt Claude Code den jeweils letzten Aufruf jeder Fähigkeit erneut an. Dabei werden die ersten 5.000 Tokens jeder Fähigkeit innerhalb eines gemeinsamen Budgets von 25.000 Tokens beibehalten. Wenn Sie in einer Sitzung mehrere große Fähigkeiten aufrufen, werden die ältesten vollständig entfernt. Deshalb kann es so wirken, als wäre eine Fähigkeit nach einer langen Konversation nicht mehr relevant. Rufen Sie sie erneut auf, wird sie wieder eingefügt. Wenn dasselbe Verfahren für mehrere Codebasen gilt, verwenden Sie eine Fähigkeit für mehrere Repositories gemeinsam, statt die Datei zu kopieren.

Wenn Sie einen MCP-Server benötigen

Das Hinzufügen erfolgt mit einem einzigen Befehl. Der Transport legt seine Form fest.

# Remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Remote HTTP server behind a bearer token
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# Local stdio server: everything after -- is passed through untouched
claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

-- ist wichtig. Bei einem stdio-Server trennt es die eigenen Optionen von Claude Code von der Befehlszeile, die Ihren Server startet. Wenn Sie es weglassen, wird ein --port 8080, das für den Server bestimmt ist, als Option für claude mcp add ausgewertet. claude mcp add weist es dann zurück.

claude mcp list
claude mcp get notion

claude mcp add bestätigt den Vorgang mit einer Zeile Added .... Das zeigt nur, dass die Konfiguration auf die Festplatte geschrieben wurde. claude mcp list zeigt den tatsächlichen Zustand an, weil der Befehl neben jedem Server einen Status ausgibt: ✔ Connected, ! Needs authentication oder ✘ Failed to connect. Ein Fehlerstatus bedeutet, dass Claude Code diesen Server nicht erreichen konnte. Die Liste selbst ist dadurch nicht fehlerhaft. Innerhalb einer Sitzung liefert /mcp dieselbe Ansicht für jeden Server sowie die Anzahl der Tools.

Jeder Aufruf eines MCP-Servers steht für sich und enthält alle benötigten Informationen. Das ist der Grund, warum sich ein MCP-Server nicht an Ihre vorherige Anfrage erinnert. Diese Designentscheidung hat eine Konsequenz, die Sie übernehmen müssen: Jeder Zustand, der erhalten bleiben soll, muss hinter dem Server in einer Datenbank oder Datei gespeichert werden. Diese Komponente müssen Sie nun betreiben.

Ein MCP-Server ist ein Prozess, den Sie betreiben müssen

Hier wird ein Aufwand nicht berücksichtigt, den die Anbietervergleiche auslassen. Ein Skill ist eine Datei. Ein MCP-Server ist Software, die irgendwo ausgeführt wird. Wenn dieser Ort Ihr VPS (virtual private server) ist, sind Sie für dessen Verfügbarkeit verantwortlich.

Ein stdio-Server ist der einfache Fall. Claude Code startet ihn beim Beginn der Sitzung als untergeordneten Prozess. Beim Ende der Sitzung wird er beendet. Sie müssen nichts überwachen und keine Aktualisierungen nach einem eigenen Zeitplan einspielen. Ein entfernter HTTP-Server ist ein dauerhaft laufender Dienst. Er benötigt alles, was jeder dauerhaft laufende Dienst benötigt.

[Unit]
Description=Notes MCP server
After=network-online.target
Wants=network-online.target

[Service]
User=mcp
WorkingDirectory=/srv/notes-mcp
ExecStart=/usr/bin/node /srv/notes-mcp/dist/server.js
Environment=PORT=8931
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now notes-mcp
systemctl is-active notes-mcp
journalctl -u notes-mcp -n 50 --no-pager

systemctl is-active sollte active ausgeben. Gibt es stattdessen failed aus, enthält das Journal den Grund. Beim ersten Start ist fast immer eine fehlende Umgebungsvariable oder ein Port die Ursache, den bereits ein anderer Prozess verwendet. Restart=on-failure ist hier nicht optional, da sich ein abgestürzter MCP-Server nicht selbst meldet. Sie erfahren davon erst, wenn der Agent Ihnen mitteilt, dass er Ihren Issue-Tracker nicht lesen kann.

Binden Sie den Prozess an 127.0.0.1 und schalten Sie einen Reverse Proxy mit TLS (transport layer security) davor. Ein MCP-Server, der auf Ihre Datenbank zugreift und ohne Authentifizierung an einem öffentlichen Port antwortet, ist eine Datenbank, die Sie veröffentlicht haben. Einen MCP-Server auf einem VPS betreiben behandelt die Konfiguration des Proxys, des Zertifikats und der Firewall ausführlich.

Ermitteln Sie anschließend den wiederkehrenden Aufwand realistisch. Der Dienst erhält Sicherheitsaktualisierungen nach seinem eigenen Zeitplan, unabhängig vom Agenten, der mit ihm kommuniziert. Sein OAuth-Token läuft ab, und claude mcp list beginnt zu einem ungünstigen Zeitpunkt mit der Ausgabe von ! Needs authentication. Die Zugangsdaten liegen in einer Konfigurationsdatei oder einem Authorization-Header. Daher müssen Sie sie genauso sorgfältig schützen wie jedes andere Geheimnis. Das ist ein eigenes Thema: Geheimnisse außerhalb der Reichweite eines AI-Agenten halten. Bei einem Skill gibt es diesen Aufwand nicht.

Vergleichen Sie diesen Aufwand mit der Alternative, bevor Sie den Server einrichten. Wenn sich die Daten hinter dem geplanten Server ungefähr einmal pro Quartal ändern, ist ein Skill, der dem Agenten erklärt, wo er suchen muss und was die Felder bedeuten, günstiger als ein Dienst, den Sie dauerhaft betreiben müssen.

So messen Sie Ihre eigenen Kontextkosten

Schätzen Sie nicht. Führen Sie /context innerhalb einer Sitzung aus. Der Befehl gibt die Aufschlüsselung beim Start aus: System-Prompt, Speicherdateien, Tools und MCP-Server, jeweils mit ihrem Token-Gewicht.

Prüfen Sie zwei Punkte. Stellen Sie unter Memory files sicher, dass jede erwartete Regeldatei aufgeführt ist. Eine fehlende Datei ist für den Agenten unsichtbar. Das ist daher der erste Punkt, den Sie prüfen sollten, wenn Anweisungen ignoriert werden. Sehen Sie sich anschließend an, wie viele Ressourcen Ihre Server verbrauchen. Wenn ein Server, den Sie zweimal im Monat verwenden, zu den größten Einträgen in dieser Liste gehört, deaktivieren Sie ihn in /mcp. Aktivieren Sie ihn für Sitzungen, die ihn benötigen, wieder. Die Konfiguration bleibt in jedem Fall erhalten.

Ein Remote-Server kann außerdem einen Status wie cached 2h ago · connects on first use · 5 tools melden. Das bedeutet, dass Claude Code die Tool-Liste aus einer vorherigen Sitzung gelesen hat, anstatt beim Start eine Verbindung herzustellen. Die Verbindung wird beim ersten Aufruf eines Tools hergestellt. Die Tools sind ab Ihrer ersten Nachricht verfügbar. Sie müssen daher nichts ändern. Setzen Sie MCP_DISCOVERY_CACHE=0, wenn sich jeder Server bereits beim Start verbinden soll. Einen Gesamtüberblick bietet das Verwalten des Claude-Code-Kontextfensters. Welche Kosten diese Tokens tatsächlich verursachen setzt die Zahlen in Geldbeträge um.

Warum wird mein Skill nie ausgelöst?

Die häufigste Ursache ist description. Das ist der einzige Text im Kontext, bevor der Skill ausgeführt wird. Wenn darin die Situation nicht genannt wird, gibt es keine Übereinstimmung. Schreiben Sie den Auslöser in den Satz: „Use when the user asks what changed, wants a commit message, or asks to review their diff.“ Vage Beschreibungen schlagen stillschweigend fehl. Dadurch bleibt das Problem schwer erkennbar.

Die zweite Ursache ist ein Tippfehler im Frontmatter. Dieser Fehler wird deutlich gemeldet. Ein unbekannter Schlüssel wird direkt abgelehnt:

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

Die dritte Ursache ist der Speicherort. Projektskills werden aus .claude/skills/ in Ihrem Arbeitsverzeichnis und aus jedem übergeordneten Verzeichnis bis zur Repository-Root geladen. Skills in verschachtelten Verzeichnissen unterhalb des Verzeichnisses, in dem Sie gestartet haben, werden beim Start nicht geladen. Sie erscheinen erst, wenn der Agent zum ersten Mal eine Datei in diesem Unterverzeichnis liest oder bearbeitet. Bis dahin werden sie bei der Autovervollständigung nicht angezeigt und können nicht namentlich aufgerufen werden.

Das MCP-Gegenstück zu diesem stillen Fehler ist ein .mcp.json-Eintrag mit einem url und ohne type. Claude Code behandelt jeden Eintrag ohne type als stdio-Server. Daher überspringt es den Eintrag und meldet:

MCP server "notes" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry

Alle drei zusammen verwenden

Diese Mechanismen konkurrieren nicht um denselben Platz. Eine funktionierende Konfiguration verwendet jeden Mechanismus dort, wo er wenig Aufwand verursacht. Die Rules-Datei enthält einige wenige Zeilen, die überall gelten. Skills enthalten die Abläufe und werden nur geladen, wenn sie relevant sind. Ein MCP-Server, gelegentlich auch zwei, stellt die Verbindung zu den Systemen her, deren Inhalte Sie nicht im Voraus kennen können. Wenn Sie sich noch ein mentales Modell des ersten Mechanismus aufbauen, erläutert was ein Agent-Skill tatsächlich ist das Format im Detail.

Ein Test klärt die meisten Fragen zur richtigen Zuordnung. Löschen Sie den betreffenden Inhalt, starten Sie eine neue Sitzung und geben Sie dem Agenten die Aufgabe. Wenn der Agent lediglich langsamer ist, gehört der Inhalt in einen Skill. Wenn der Agent selbstsicher falsche Antworten liefert, gehört der Inhalt in die Rules-Datei. Wenn der Agent die Informationen überhaupt nicht abrufen kann, benötigen Sie den Server. Dann brauchen Sie außerdem einen Plan, wie Sie diesen Server dauerhaft betreiben.

FAQ

Soll ich eine Skill-Datei schreiben oder einen MCP-Server bereitstellen?

Entscheiden Sie anhand der Frage, ob sich die Informationen zwischen zwei Aufrufen ändern. Muss der Agent den aktuellen Status lesen, den jemand anderes bearbeiten kann, etwa einen Issue-Tracker, eine Datenbank oder ein Dashboard, benötigen Sie einen MCP-Server. Alles, was Sie dokumentieren, ist veraltet, sobald sich der Datensatz ändert. Wenn Sie die Antwort einmal dokumentieren könnten und sie auch in sechs Wochen noch korrekt wäre, schreiben Sie eine Skill-Datei. Die Skill-Datei liegt als Datei in git vor. Sie benötigt keinen laufenden Prozess, keinen zu öffnenden Port und keinen Patch-Zeitplan. Daher ist sie immer dann die kostengünstigere Option, wenn sie überhaupt möglich ist.

Füllen MCP-Server weiterhin mein Kontextfenster?

Deutlich weniger als früher. In aktuellen Versionen von Claude Code ist die Tool-Suche standardmäßig aktiviert. Zu Beginn der Sitzung werden daher nur die Tool-Namen und das Anweisungsfeld des Servers geladen. Die vollständigen Schemata werden abgerufen, wenn Claude danach sucht. Eine vollständige Vorab-Ladung findet weiterhin statt, wenn die Tool-Suche deaktiviert ist: mit ENABLE_TOOL_SEARCH=false, mit ANTHROPIC_BASE_URL, das auf einen Proxy verweist, der nicht vom Hersteller betrieben wird, oder bei einem Modell, das älter als die Generation Claude 4.5 ist. Führen Sie /context aus, um zu prüfen, welche Situation vorliegt. Die Zahlen in älteren Vergleichsartikeln setzen eine Vorab-Ladung voraus.

Liest Claude Code AGENTS.md?

Nein. Claude Code liest CLAUDE.md. Wenn Ihr Repository bereits eine AGENTS.md für andere Agents enthält, verweisen Sie jeweils auf die andere Datei, statt zwei Kopien zu pflegen. Führen Sie ln -s AGENTS.md CLAUDE.md für einen einfachen symbolischen Link aus. Alternativ setzen Sie @AGENTS.md in die erste Zeile einer CLAUDE.md und fügen darunter Claude-spezifische Anweisungen ein. Starten Sie anschließend eine Sitzung und führen Sie /context aus, um zu bestätigen, dass CLAUDE.md unter Memory files angezeigt wird.

Warum hatte meine Skill-Datei ab der Mitte einer Sitzung keine Wirkung mehr?

Die übliche Ursache ist die automatische Kompaktierung. Wenn die Unterhaltung zusammengefasst wird, bindet Claude Code den jeweils letzten Aufruf jeder Skill-Datei erneut ein. Dabei werden von jeder Skill-Datei die ersten 5,000 Tokens berücksichtigt, innerhalb eines gemeinsamen Budgets von 25,000 Tokens für alle Skill-Dateien. Dieses Budget wird beginnend mit der zuletzt aufgerufenen Skill-Datei gefüllt. Wenn Sie mehrere große Skill-Dateien aufgerufen haben, werden ältere Skill-Dateien vollständig entfernt. Rufen Sie die Skill-Datei erneut auf, um ihren vollständigen Inhalt wiederherzustellen.

Wie verhindere ich, dass eine lange Regeldatei in jeder Sitzung geladen wird?

Verschieben Sie die Teile, die nur gelegentlich relevant sind, in .claude/rules/-Dateien mit einem paths-Feld im Frontmatter. Dadurch wird jede Datei erst geladen, wenn der Agent eine passende Datei bearbeitet. Das Aufteilen der Datei in @path-Importe hilft nicht, da importierte Dateien beim Start zusammen mit der Datei erweitert und geladen werden, die auf sie verweist. Alles, was ein mehrstufiges Verfahren und keine dauerhaft geltende Information ist, sollte stattdessen zu einer Skill-Datei werden. Der Inhalt einer Skill-Datei verursacht keine Kosten, solange sie nicht aufgerufen wird.