Die strikte Weigerung, den branchenüblichen Standard AGENTS.md zu verwenden, führt dazu, dass Claude Code ein „Sperrverbot“ ausgelöst hat: Anthropic hat endlich reagiert, aber die Entwickler sind noch verärgerter.

Wenn alle KI-Programmierwerkzeuge sich an Branchenstandards annähern, geht Claude Code von Anthropic einen ganz eigenen Weg. Es weigert sich, das AGENTS.md-Format zu unterstützen, das von mehr als 60.000 Open-Source-Projekten verwendet wird, und hält hartnäckig an dem eigenen CLAUDE.md fest.

Diese „Eigenwilligkeit“ ist nun auf Granit gestoßen. Der globale E-Commerce-Riese Shopify-CEO Tobi Lütke hat öffentlich gedroht: Entweder unterstützt Claude Code AGENTS.md, oder Claude Code wird innerhalb von Shopify vollständig deaktiviert.

Ein durch eine Datei ausgelöster Deaktivierungsstreit 

Shopify-CEO Tobi Lütke ist der Meinung, dass die Weigerung von Claude Code, AGENTS.md zu lesen, große Entwicklerteams eine vermeidbare „Komplexitätssteuer“ zahlen lässt.

„Ich überlege, Claude Code bei Shopify zu deaktivieren, bis sie ihre Meinung ändern und bereit sind, Dateien wie AGENTS.md, .agents/skills und andere zu lesen“, schrieb Lütke auf X.

Das scheint nur ein kleiner Streit um die Konfigurationsmethode von KI-Programmierwerkzeugen zu sein, aber in einer großen Entwicklungsorganisation wie Shopify entwickelt sich ein einziger Formatunterschied schnell zu einem Problem der Plattformtechnik.

Bei Shopify pflegen Tausende von Entwicklern gemeinsam eine riesige monolithische Codebasis (Monorepo), verwenden aber unterschiedliche KI-Programmierwerkzeuge. Jeder Agent muss je nach dem aktuell bearbeiteten Code die Projektanweisungen im entsprechenden Verzeichnis lesen. Sobald ein Werkzeug nicht die gleichen Anweisungen wie die anderen Werkzeuge liest, folgen die Agenten, die von Entwicklern verwendet werden, möglicherweise unterschiedlichen Regeln.

Lütke erklärte anschließend in einem weiteren Beitrag: „AGENTS.md und CLAUDE.md wirken beide rekursiv entlang des Verzeichnisbaums. Wenn Tausende von Entwicklern gemeinsam ein Monorepo pflegen, wird unvermeidlich ein Verzeichnis eine der beiden Dateien verpassen, was dazu führt, dass ein Teil der Entwickler Agenten verwenden, denen ein Teil der „Denkfähigkeit“ fehlt.“

Shopify hat diese Unterschiede bereits durch automatisierte Mechanismen ausgeglichen, aber Lütke ist der Meinung, dass die Ingenieure des Unternehmens überhaupt keine zusätzliche Energie dafür aufwenden sollten.

„Wir haben dieses Problem mit Automatisierung gelöst, aber das ist eine dumme Komplexitätssteuer, die überhaupt nicht gezahlt werden sollte“, schrieb er.

In den letzten zwölf Monaten haben Entwickler Anthropic ständig dazu aufgefordert, AGENTS.md zu unterstützen. Die im August 2025 eingereichte wichtigste Funktionsanfrage hat bereits fast 5000 Likes von GitHub-Benutzern erhalten und ist zu einer der am stärksten nachgefragten Kompatibilitätsanforderungen in der Claude Code-Community geworden. Allerdings wurden die zugehörigen Issues nacheinander ohne ausreichende Beantwortung der Bedenken der Community geschlossen. „Keine Reparatur geplant“ wurde die Antwort von Anthropic an Tausende von Entwicklern.

Entwickler haben die Anforderung anschließend auf das rekursive Laden erweitert, das für große Codebasen am wichtigsten ist: Claude Code soll automatisch AGENTS.md im Stammverzeichnis und in allen Unterverzeichnissen suchen, Dateien, die dem aktuell bearbeiteten Code am nächsten liegen, vorrangig wirken lassen und gleichzeitig anzeigen, welche Anweisungen für die aktuelle Aufgabe gelesen wurden. Auf diese Weise kann das Stammverzeichnis globale Regeln speichern, und Unterprojekte definieren ihre eigenen Build-Befehle, Teststandards und Betriebsgrenzen, ohne dass das Team eine Kopie von CLAUDE.md im gesamten Verzeichnisbaum duplizieren muss. Diese Anfrage wurde schließlich ebenfalls geschlossen und als „derzeit keine Pläne“ markiert.

Erst als Shopify-CEO Tobi Lütke öffentlich ankündigte, Claude Code im Unternehmen zu deaktivieren, reagierte Anthropic, das fast ein Jahr lang geschwiegen hatte, endlich.

Wie viele „nutzlose“ Skripte mussten Entwickler für die Kompatibilität schreiben?

Da die Fähigkeiten von Programmieragenten immer stärker werden, benötigen Entwicklungsteams auch eine Möglichkeit, Projektanweisungen langfristig zu speichern. Dateien wie AGENTS.md und CLAUDE.md sind vor diesem Hintergrund entstanden.

Entwickler können Inhalte wie Build-Befehle, Testanforderungen und Codierungsstandards direkt in die Anweisungsdateien im Code-Repository schreiben. Wenn der Agent arbeitet, liest er diese Informationen automatisch, ohne dass Entwickler jedes Mal alles neu erklären müssen. Das Problem besteht darin, dass verschiedene Programmierwerkzeuge bisher kein einheitliches Dateiformat übernommen haben.

OpenAI hat im August 2025 AGENTS.md eingeführt, um Programmieragenten Anweisungen auf Projektebene zu übermitteln. Bis Dezember desselben Jahres gab OpenAI an, dass mehr als 60.000 Open-Source-Projekte und Agent-Frameworks dieses Format verwendet haben. Zu den Werkzeugen, die es unterstützen, gehören Codex, Cursor, Gemini CLI, GitHub Copilot, Jules und VS Code. Anschließend übergab OpenAI dieses Format an die Agentic AI Foundation unter der Linux Foundation.

Claude Code hat einen anderen Weg eingeschlagen. Es verwendet CLAUDE.md zum Speichern von Projektanweisungen und kann CLAUDE.md in verschiedenen Verzeichnissen des Repositories lesen, wenn es Code verarbeitet. Derzeit liest es AGENTS.md nicht nativ, obwohl Entwickler Anthropic mehrfach dazu aufgefordert haben, diese Funktion hinzuzufügen.

Anthropic bietet einige Umgehungslösungen an, z. B. das Importieren von AGENTS.md über CLAUDE.md oder das Erstellen von symbolischen Links für die Dateien.

Der Entwickler Ian Nuttall hat einen ziemlich komplexen Prompt geteilt, der Claude auf Mac dazu bringt, einen automatischen Kompatibilitätsmechanismus einzurichten: Es sucht rekursiv nach allen AGENTS.md, erstellt einen symbolischen Link von CLAUDE.md, der auf sie im selben Verzeichnis verweist, überwacht neue Dateien kontinuierlich mit fswatch, richtet einen launchd-Agent ein, der automatisch beim Systemstart ausgeführt wird, und fügt die generierte CLAUDE.md zur globalen Git-Ignorierliste hinzu, um versehentliches Einreichen zu vermeiden.

Diese Lösung scheint das Kompatibilitätsproblem zu lösen, bestätigt aber genau die von Lütke genannte „Komplexitätssteuer“: Damit Claude Code AGENTS.md lesen kann, das andere Mainstream-Werkzeuge bereits nativ unterstützen, müssen Entwickler zusätzlich Suchskripte, Dateiüberwachung, Konfigurationen für den automatischen Start und Git-Konfigurationen pflegen und sicherstellen, dass dieser Mechanismus auf allen Geräten der Teammitglieder konsistent ist.

Aber nicht jeder kann diese Aufgabe meistern. Einige Nutzer haben viele Methoden ausprobiert, um Claude Code dazu zu bringen, die AGENTS.md-Datei zu lesen, aber Claude Code hat nie reagiert, sodass sie schließlich zu Cursor wechseln mussten.

Außerdem muss das Team in großen Codebasen sicherstellen, dass die Anweisungen, die in verschiedenen Verzeichnissen verteilt sind und für unterschiedliche Werkzeuge bestimmt sind, immer synchron bleiben.

Denn in großen Codebasen können Projektanweisungen im gesamten Verzeichnisbaum verteilt sein. Wenn ein Agent Code an verschiedenen Stellen verarbeitet, muss er unterschiedliche Anforderungen in den entsprechenden Verzeichnissen einhalten. Claude Code realisiert diesen Mechanismus über CLAUDE.md: Wenn es Code in einem bestimmten Verzeichnis verarbeitet, liest es die zugehörige Anweisungsdatei für dieses Verzeichnis.

Das ist der Schlüssel zum von Lütke genannten Fall: Wenn in einem Verzeichnis AGENTS.md vorhanden ist, das von anderen Werkzeugen gelesen werden soll, aber keine entsprechende CLAUDE.md für Claude Code vorbereitet wurde, arbeiten Entwickler, die Claude Code verwenden, möglicherweise ohne den gleichen Kontext.

Shopify ist nicht das einzige Unternehmen, das auf dieses Problem stößt. Eine Studie aus dem Jahr 2026, die 2926 GitHub-Code-Repositories untersucht hat, ergab, dass Kontextdateien bereits die häufigste Methode sind, mit der Entwickler Programmieragenten Anweisungen übermitteln, und AGENTS.md wurde bereits von vielen Werkzeugen übernommen.

Shopify hat einen automatisierten Mechanismus aufgebaut, um diese Unterschiede zu behandeln. Da Unternehmen immer mehr Programmieragenten in dasselbe Code-Repository einführen, wird die Sicherstellung, dass alle Werkzeuge die gleichen Anweisungen lesen und die gleichen Regeln einhalten, zu einer neuen Aufgabe für das Plattformteam.

Streit eskaliert: Die Antwort von Anthropic erzürnt Entwickler

Thariq, Mitglied des Claude Code Teams, antwortete darauf, dass sie die Anpassbarkeit von Claude Code verbessern und es Entwicklern in Zukunft einfacher machen werden, AGENTS.md zu verwenden oder andere Systemprompts zu ändern.

Derzeit muss man noch @AGENTS.md in CLAUDE.md schreiben, damit es AGENTS.md importiert. Dieser Schritt könnte in Zukunft vereinfacht werden, aber diese Antwort hat nicht klar angegeben, ob AGENTS.md standardmäßig erkannt wird, wie es bei Werkzeugen wie Codex und Cursor der Fall ist.

Er erklärte gleichzeitig einen Teil der Gründe, warum Anthropic an der vorhandenen Lösung festhält: Das Team ist der Meinung, dass der Kontext und die Anweisungen, die verschiedene Modelle benötigen, nicht vollständig identisch sind.

Thariq hat zuvor mitgeteilt, dass Anthropic etwa 80 % der Systemprompts von Claude Code für die neueste Generation des Claude 5-Modells entfernt hat. Daher bevorzugt Anthropic es, Systemprompts, Fähigkeiten und CLAUDE.md entsprechend den Modelleigenschaften anzupassen, anstatt direkt einen Satz von modellübergreifenden allgemeinen Projektanweisungen zu übernehmen.

Ein Entwickler widersprach sofort, dass er normalerweise fünf Modelle verwendet und andere Mitwirkende des Code-Repositories noch mehr Modelle nutzen. Wenn jedes Modell eine separat optimierte Anweisungsdatei benötigt, müsste ein Projekt gleichzeitig 17 AGENTS.md-Dateien pflegen und diese kontinuierlich neu bewerten und umschreiben, wenn die Modelle alle paar Wochen aktualisiert werden?

„Niemand wird das tun“, meinte er. Entwickler von Mainstream-Harness können die Anpassung für verschiedene Modelle innerhalb des Produkts vornehmen, so wie Claude Code es bereits getan hat, aber sie sollten diese Wartungskosten nicht auf normale Entwickler abwälzen.

Nach der Logik „jedes Modell benötigt eine eigene Anweisungsdatei“ müsste ein Team, das nur Claude verwendet, möglicherweise eine Reihe von Dateien wie CLAUDE_FABLE_5.md, CLAUDE_OPUS_5.md, CLAUDE_OPUS_4_8.md und mehr pflegen.

Jedes Mal, wenn das Modell aktualisiert wird, muss das Unternehmen eine große Anzahl von Tokens für die Neubewertung aufwenden und sogar ein Team einrichten, das sich ausschließlich um die Pflege dieser Markdown-Dateien kümmert.

„Anthropic weigert sich erneut, Branchenstandards wie AGENTS.md zu befolgen und besteht darauf, dass CLAUDE.md anders sein muss.“

Mehrere Nutzer sind ebenfalls der Meinung, dass dies rein ein Problem der Produktkultur von Anthropic ist. Die Weigerung von Anthropic, allgemein anerkannte Branchenvereinbarungen wie AGENTS.md zu befolgen und CLAUDE.md einen Sonderstatus zu verleihen, vermittelt die Haltung „nur wir kennen die beste Lösung“: Die Vorgehensweise von OpenAI ist falsch, die Vorgehensweise der Open-Source-Community ist ebenfalls falsch, und nur Anthropic weiß, wie Modelle Anweisungen erhalten sollen.