Zum Inhalt springen
claudemods

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

In Claude Code installieren:

git clone https://github.com/anthropics/claude-code
claude --plugin-dir ./claude-code/mods/agents-md
Alle Installationswege ↓

Was 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: nur CLAUDE.md, wie Claude Code es heute tut. Die Mod fügt nichts hinzu.
  • claude-md-or-agents-md (Standard): Ein Projekt ohne eigene CLAUDE.md bekommt stattdessen seine AGENTS.md-Dateien.
  • claude-md-and-agents-md: Jede AGENTS.md wird neben CLAUDE.md geladen.
  • managed-only: Die Anweisungsdateien des Projekts und deine eigenen entfallen; die verwaltete CLAUDE.md der 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. 1.Ohne Installation ausprobieren

    git clone https://github.com/anthropics/claude-code
    claude --plugin-dir ./claude-code/mods/agents-md

    Lä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.ancestors liest AGENTS.md und .claude/AGENTS.md den Baum aufwärts (und sucht nach CLAUDE.md, .claude/CLAUDE.md, CLAUDE.local.md). Ihr Text geht als Projektanweisung an das Modell; eine AGENTS.md, der du nicht traust, kann Claude also steuern, wie es eine CLAUDE.md kann.
  • Liest Umgebungsvariablen. HOME, USERPROFILE, CLAUDE_CODE_SIMPLE und CLAUDE_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 auf Read und der agent.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 validate vermerkt, dass beiden Hooks ein .catch fehlt.
  • Telemetrie. Sie ruft $.telemetry.log und $.telemetry.mark mit 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.md des Repositorys lautet „© Anthropic PBC. All rights reserved“, die Nutzung unterliegt Anthropics Commercial Terms. Die Seite ist daher redistributable: 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.md oder CLAUDE.local.md. Im Standardmodus lässt jede davon die Mod zurücktreten.
  • Prüfe, dass die Option in /config nicht claude-md oder managed-only ist.
  • Bei --bare- oder --safe-mode-Läufen oder gesetztem CLAUDE_CODE_DISABLE_CLAUDE_MDS lädt Claude Code keine Anweisungsdateien; mit CLAUDE_CODE_DISABLE_ATTACHMENTS entfallen 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, /clear oder 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.
Context Inspector in Claude CodeEmpfohlen

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