agents-md: Claude Code AGENTS.md als Projektanweisungen laden
Lädt AGENTS.md als Projektanweisungen, wie CLAUDE.md, mit vier Modi in /config.
Berechtigungen
- Fängt Tool-Aufrufe abSieht jeden Tool-Aufruf von Claude (tool.call / tool.check) und könnte ihn blockieren oder verändern.
- Verändert die OberflächeZeichnet in die Oberfläche von Claude Code: Leisten, Bereiche, Statustext, Toasts (ui.render / $.ui.*).
- getestet mit
- v2.1.310
- zuletzt getestet
- erfordert
- Claude Code ≥ 2.1.287
- Oberflächen
- keine
- Quelle
- Anthropic (anthropics)
In Claude Code installieren:
git clone https://github.com/anthropics/claude-code
claude --plugin-dir ./claude-code/mods/agents-mdWas macht diese Mod?
agents-md ist eine Mod von Anthropic (anthropics/claude-code), die Claude Code AGENTS.md-Unterstützung gibt. Viele Repositories halten ihre Agent-Anweisungen in AGENTS.md, während Claude Code CLAUDE.md liest. Die Mod reicht AGENTS.md-Dateien als Projektanweisungsdateien an Claude Code weiter, sodass das Modell sie an derselben Stelle und im selben Rahmen sieht wie eine CLAUDE.md.
Eine Option, instructionFiles, bestimmt, was geladen wird:
claude-md: nurCLAUDE.md, wie Claude Code es heute tut. Die Mod fügt nichts hinzu.claude-md-or-agents-md(Standard): Ein Projekt ohne eigeneCLAUDE.mdbekommt stattdessen seineAGENTS.md-Dateien.claude-md-and-agents-md: JedeAGENTS.mdwird nebenCLAUDE.mdgeladen.managed-only: Die Anweisungsdateien des Projekts und deine eigenen entfallen; die verwalteteCLAUDE.mdder Organisation und der Speicher bleiben.
Die Dateien werden von der Wurzel des Dateisystems bis zum Arbeitsverzeichnis gesucht; AGENTS.md und .claude/AGENTS.md zählen beide. Liest Claude eine Datei in einem Unterverzeichnis, wird die AGENTS.md dieses Verzeichnisses an das Ergebnis gehängt, so wie Claude Code es bei einer verschachtelten CLAUDE.md tut. Die Mod zeichnet nichts auf den Bildschirm; ihre Wirkung liegt in dem, was das Modell weiß.
Demo
Die Aufnahme startet Claude Code mit geladener Mod im kleinen Demoprojekt. Vor dem Clip schreibt eine versteckte Setup-Zeile eine kurze AGENTS.md ins Projekt (zwei Regeln: Commit-Nachrichten beginnen mit der Ticket-ID wie DEMO-123, und vor jedem Commit läuft npm test). Das Projekt hat keine CLAUDE.md. Im Clip fragen wir: „Without reading any file: what does my AGENTS.md say about commit messages? One sentence.“ Claude antwortet nach etwa zwei Sekunden und ohne Tool-Aufruf, dass Commit-Nachrichten mit der Ticket-ID wie DEMO-123 beginnen, weil die Datei schon in seinem Kontext lag.
Installation
Nutze eine der Methoden im Installationsblock; sie installieren aus dem Repository anthropics/claude-code. Das Repository hat keine marketplace.json, die dieses Plugin aufführt, daher nutzt der Block das Repository selbst als Quelle. Der Standardmodus braucht keine Einrichtung: Starte eine Sitzung in einem Projekt mit AGENTS.md und ohne CLAUDE.md.
$ install agents-md
Erfordert Claude Code ≥ 2.1.287
Wird aus dem Marketplace des Autors installiert: anthropics/claude-code
1.Ohne Installation ausprobieren
git clone https://github.com/anthropics/claude-code claude --plugin-dir ./claude-code/mods/agents-mdLädt die Mod nur für eine Sitzung. An deinen Einstellungen wird nichts geändert.
So funktioniert es
hooks/register.ts ist das einzige Modul in hooks/hooks.json; alles andere unter hooks/ sind kleine Hilfsmodule, die es importiert. In den beiden Lademodi erhält ein prompt.context-Hook die Anweisungsdateien, die Claude Code geladen hat, sucht mit $.fs.ancestors nach oben nach AGENTS.md und antwortet mit der Liste plus den neuen Dateien als project-Dateien. So sieht die Suche aus, aus hooks/register.ts:
const found = isClaudeProject
? NONE
: await $.fs.ancestors({ names: Names.AGENTS_NAMES }).catch(() => {
isWalkFailed = true
return NONE
})
const added = Files.unseenFiles(Files.filesOf(found), handed)unseenFiles lässt eine Datei weg, deren Pfad Claude Code schon hält oder deren Text dem einer übergebenen Projektdatei gleicht (etwa eine CLAUDE.md, die per Symlink auf AGENTS.md zeigt). Ein tool.call-Hook auf Read lässt das Lesen zuerst enden und hängt dann bei einer Datei unter der Projektwurzel die AGENTS.md der Verzeichnisse zwischen Wurzel und Datei als Contents of <path>: an, einmal pro Agent-Schleife. Ein agent.spawn-Hook für Forks kopiert die beim Elternteil schon gelieferte Menge, damit ein Fork dieselben Dateien nicht doppelt bekommt.
Anpassen
Die Option ist die Zeile „Project instructions“ in /config, eine Auswahl über die vier Werte. Von Hand setzt du sie in den Benutzereinstellungen, in --settings oder in verwalteten Einstellungen (die .claude/settings.json eines Projekts wird für Plugin-Optionen nicht gelesen):
{
"pluginConfigs": {
"agents-md@builtin": {
"options": { "instructionFiles": "claude-md-and-agents-md" }
}
}
}Mit claude --plugin-dir mods/agents-md heißt derselbe Eintrag "agents-md". Der alte Schlüssel projectInstructions wird noch beachtet, bis instructionFiles auf einen Nicht-Standardwert gesetzt ist. Das README des Autors nennt acht Stellen, an denen sich AGENTS.md weiter von CLAUDE.md unterscheidet, zum Beispiel liefern --add-dir-Verzeichnisse keine AGENTS.md, und /memory kennt die Dateien nicht.
Berechtigungen & Sicherheit
Wir haben jede Datei gelesen, die das Plugin ausführen kann: plugin.json, hooks/hooks.json, hooks/register.ts, alle importierten Hilfsmodule unter hooks/ und die Tests. Es gibt kein package.json, kein Installationsskript, keine Binärdatei und keinen gebündelten Code, und die Quellen enthalten keine Nicht-ASCII-Zeichen.
- Liest Dateien.
$.fs.ancestorsliestAGENTS.mdund.claude/AGENTS.mdden Baum aufwärts (und sucht nachCLAUDE.md,.claude/CLAUDE.md,CLAUDE.local.md). Ihr Text geht als Projektanweisung an das Modell; eineAGENTS.md, der du nicht traust, kann Claude also steuern, wie es eineCLAUDE.mdkann. - Liest Umgebungsvariablen.
HOME,USERPROFILE,CLAUDE_CODE_SIMPLEundCLAUDE_CODE_DISABLE_ATTACHMENTS, nur um~-Pfade aufzulösen und Anhänge zu überspringen, wo Claude Code nichts anhängt. Umgebungsvariablen schreibt sie nicht. - Fängt Tool-Aufrufe ab. Der
tool.call-Hook aufReadund deragent.spawn-Hook für Forks warten auf den Aufruf und geben sein Ergebnis zurück; nur nach erfolgreichem Lesen fügen sie Kontext hinzu. Sie lehnen nie einen Aufruf ab.claude plugin validatevermerkt, dass beiden Hooks ein.catchfehlt. - Telemetrie. Sie ruft
$.telemetry.logund$.telemetry.markmit Zählern und festen Auswahlwerten auf (Modus, Datei- und Importanzahl, Gesamtlänge, ein paar Flags). Laut README enthalten sie keinen Pfad und keinen Text und werden verworfen, wo Anthropics Telemetrie-Plugin fehlt. Dieses Plugin haben wir nicht geprüft. - Kein Netzwerk, keine Prozesse, kein Schreiben, keine Daemons. Die Mod nutzt kein
fetch, keine Shell, kein$.fs-Schreiben und keinen Hintergrundtimer. Sie schreibt nur eine Debug-Logzeile über$.ui.log:no CLAUDE.md found; AGENTS.md loaded: <paths>. - Lizenz. Die
LICENSE.mddes Repositorys lautet „© Anthropic PBC. All rights reserved“, die Nutzung unterliegt Anthropics Commercial Terms. Die Seite ist daherredistributable: false; wir verlinken den Code und spiegeln ihn nicht.
claude plugin validate meldete keine Fehler. Es gab nur die nicht blockierende Warnung „kein Icon“ für das Plugin-Verzeichnis, die beiden .catch-Hinweise von oben und den Rat, dass dem README eine Installationszeile fehlt. Die 5 Tests des Autors liefen auf Claude Code 2.1.310 durch.
- Fängt Tool-Aufrufe ab
- Sieht jeden Tool-Aufruf von Claude (tool.call / tool.check) und könnte ihn blockieren oder verändern.
- Verändert die Oberfläche
- Zeichnet in die Oberfläche von Claude Code: Leisten, Bereiche, Statustext, Toasts (ui.render / $.ui.*).
Kompatibilität & Fehlerbehebung
Geprüft mit Claude Code 2.1.310 unter macOS (validate, Tests und Demo-Aufnahme). Das README beschreibt es als eingebautes Plugin (agents-md@builtin); eine Claude-Code-Version, die es mitbringt, lädt es womöglich schon. /plugin listet eingebaute Plugins auf, dort lässt es sich abschalten. Wird deine AGENTS.md nicht geladen:
- Suche zwischen Wurzel und Arbeitsverzeichnis nach
CLAUDE.md,.claude/CLAUDE.mdoderCLAUDE.local.md. Im Standardmodus lässt jede davon die Mod zurücktreten. - Prüfe, dass die Option in
/confignichtclaude-mdodermanaged-onlyist. - Bei
--bare- oder--safe-mode-Läufen oder gesetztemCLAUDE_CODE_DISABLE_CLAUDE_MDSlädt Claude Code keine Anweisungsdateien; mitCLAUDE_CODE_DISABLE_ATTACHMENTSentfallen verschachtelte Anhänge. - Auf einem Thin Client findet die Mod nichts, weil die Workspace-Dateien dort entfernt liegen.
- Nach einer Änderung der Option kommen die neuen Dateien mit dem nächsten Kontext, den Claude Code baut: der nächste Turn,
/clearoder eine Kompaktierung.
FAQ
- Liest Claude Code AGENTS.md auch ohne diese Mod?
- Laut README der Mod lädt die Engine nur CLAUDE.md, und das Plugin ergänzt AGENTS.md. Steht die Option auf claude-md, fügt das Plugin nichts hinzu, und CLAUDE.md wird wie gewohnt geladen.
- Was passiert, wenn mein Projekt CLAUDE.md und AGENTS.md hat?
- Im Standardmodus claude-md-or-agents-md hält sich die Mod heraus, sobald zwischen Wurzel und Arbeitsverzeichnis eine CLAUDE.md, .claude/CLAUDE.md oder CLAUDE.local.md liegt. Bei claude-md-and-agents-md lädt sie beide und überspringt eine AGENTS.md, die CLAUDE.md schon importiert oder verlinkt.
- Schickt sie den Text meiner AGENTS.md irgendwohin?
- Der Code stellt keine Netzwerkanfragen und führt keine Befehle aus. Er übergibt nur Zähler (Dateianzahl, Importanzahl, Gesamtlänge, Modus) an ein Telemetrie-Objekt. Laut README gibt es diese Zeilen nur, wo Anthropics Telemetrie-Plugin installiert ist, und sie enthalten weder Pfad noch Dateitext.
- Wie ändere ich den Modus?
- Öffne /config und wähle einen Wert in der Zeile „Project instructions“, oder setze instructionFiles unter pluginConfigs in deinen Benutzereinstellungen. Die Änderung lädt das Modul neu, und der nächste Kontext der Engine nutzt den neuen Modus.
- Kann ich den Code in meinem eigenen Plugin verwenden?
- Nicht durch Kopieren. Die LICENSE.md des Repositorys sagt „All rights reserved“ und verweist auf Anthropics Commercial Terms. Diese Seite verlinkt deshalb nur auf den Code und spiegelt ihn nicht.
# Ähnliche Mods
EmpfohlenContext Inspector
Zeigt, was das Claude-Code-Kontextfenster füllt, wie viel davon Verschwendung ist und was die Kompaktierung behielt.
- Statuszeile
- Bereich
- Toast
- Schreibt Dateien
- Fängt Tool-Aufrufe ab
- Liest deine Prompts
- Verändert die Oberfläche
- Fügt Befehle/Tools hinzu
getestet mit v2.1.303
Mehr in Timer, Todos, Standups.