Claude Code und Codex auf Deutsch betreiben
CLAUDE.md und AGENTS.md, die wirklich tragen
Auf den geprüften Dokumentationsseiten beider Werkzeuge gibt es keine Locale- oder Sprachumschaltung – es gibt Anweisungsdateien. Claude Code liest CLAUDE.md zu Beginn jeder Session; Codex baut eine Anweisungskette aus AGENTS.md-Dateien. Deutsche Antworten sind damit etwas, das Sie einmal aufschreiben, nicht etwas, das Sie wegdrehen.
Aktualisiert 2026-10-01
Vier Mechaniken, über die das Ergebnis entscheidet
Wann CLAUDE.md gelesen wird
Die Memory-Seite von Claude Code hält fest, dass diese Dateien als schlichter Text geschrieben werden und Claude sie zu Beginn jeder Session liest.
Wie der Text ankommt
Derselbe Text hält fest, dass CLAUDE.md-Inhalt als user message nach dem system prompt ankommt und nicht als Teil des system prompts.
Wie Codex Anweisungen liest
Codex dokumentiert AGENTS.md, um "Give Codex extra instructions and context for your project", und bildet eine Kette von der globalen Datei bis ins Arbeitsverzeichnis.
Angabe zur Länge
Der Rat aus den Claude-Code-Docs: "Target under 200 lines per CLAUDE.md file." – "Longer files consume more context and reduce adherence."
Warum die Sprachregel aufgeschrieben werden muss
Beide Werkzeuge behandeln Anweisungsdateien als Kontext und nicht als erzwungene Konfiguration – die Dokumentation von Claude Code sagt das wörtlich. Eine Regel, die Deutsch als Antwortsprache verlangt, verhält sich damit wie jede andere Konvention: Sie trägt, wenn sie kurz, explizit und weit oben steht, und sie verwässert, wenn die Datei aus Prosa-Wänden besteht. Das belastbare Muster ist: eine Sprachregel, ein Geltungsbereich für Bezeichner, ein Ort für Ausnahmen.
Was deutsche Teams zuerst falsch machen
Drei wiederkehrende Fehler: die Regel in einem Kommentar verstecken (Block-Kommentare in CLAUDE.md werden vor der Übergabe entfernt), die Code-Sprache nicht festlegen und damit umbenannte Bezeichner riskieren, und die Datei über die Grenze wachsen lassen, oberhalb der Anweisungen noch befolgt werden. Alle drei sind dokumentiertes Verhalten, kein Stadtmythos.
Die drei Dateien, die zählen
Persönliche Vorlieben über alle Projekte hinweg – der natürliche Ort für die Anweisung, auf Deutsch zu erklären.
Vom Team geteilte Anweisungen für das Repository, eingecheckt und reviewed wie Code.
Die Projektanweisungsdatei von Codex, entdeckt von der Wurzel des Repository bis zum Arbeitsverzeichnis.
Dokumentiert vs. eigener Test
Dokumentiert
CLAUDE.md-Dateien geben dauerhafte Anweisungen und werden zu Beginn jeder Session gelesen; sie können andere Dateien mit @path/to/import einbinden; Block-Kommentare werden vor der Übergabe entfernt; der Inhalt kommt als user message nach dem system prompt; die Docs empfehlen unter 200 Zeilen und warnen, dass längere Dateien die Befolgung senken; Claude Code liest AGENTS.md nur, wenn oberhalb des Arbeitsverzeichnisses kein CLAUDE.md existiert, sofern Sie es nicht anders einstellen. Codex dokumentiert AGENTS.md als Projektanweisung, führt Dateien von der Repository-Wurzel zum Arbeitsverzeichnis zusammen, wobei näher gelegene vorgehen, überspringt leere Dateien und stoppt bei der durch project_doc_max_bytes definierten Größe.
Nicht dokumentiert – selbst testen
Auf den geprüften Seiten von Claude Code und Codex erscheint kein Sprach- oder Locale-Schalter; deshalb verspricht hier niemand eine Einstellung, die Deutsch einschaltet. Wie zuverlässig ein Modell Deutsch über lange tool-lastige Sessions hält, was es mit ß und Umlauten in Bezeichnern macht, und ob Ihre eigene Dateireihenfolge wirklich lädt, was Sie meinen – drei Fragen, die Sie mit /context und einer kurzen Aufgabe klären, nicht diese Seite.
Zwei Dateien, zwei Aufgaben
CLAUDE.md – Verhalten
Die Claude-Code-Docs sagen es klar: die Docs trennen technische Durchsetzung (settings) von Verhaltensvorgaben (CLAUDE.md); Sprache, Ton und erst-erklären-dann-patchen gehören hierher.
AGENTS.md – Projekt-Kontext für Codex
Codex liest AGENTS.md als Anweisung und Kontext für das Projekt, wobei Dateien näher am Arbeitsverzeichnis frühere Vorgaben übersteuern – derselbe Ort, um die deutsche Konvention je Repository einmal hinzuschreiben.
Ein deutsches CLAUDE.md zum Einfügen
Kurz und eindeutig halten. Empfohlener Block: "Sprache: Antworte in Erklärungen, Plänen und Review-Kommentaren auf Deutsch. Code, Bezeichner, Dateinamen, Commit-Messages und Testnamen bleiben auf Englisch. Keine Umlaute in Bezeichnern – ae/oe/ue/ss verwenden. Halte jede Erklärung unter 10 Sätzen, bevor du fragst." Datei als UTF-8 speichern, in einer Session /context ausführen und die Datei unter Memory files wiederfinden, dann eine echte Aufgabe geben und prüfen, ob das Deutsch die Tool-Aufrufe überlebt hat.
Bei QCode
Anweisungsdateien reisen mit dem CLI, nicht mit dem Endpoint: Welches Modell Sie auch aufrufen, CLAUDE.md und AGENTS.md liest das Werkzeug, bevor die Anfrage geht. QCodes Seiten beschreiben, wie Claude Code über ANTHROPIC_BASE_URL auf die Anthropic-kompatible API zeigt und wie ein QCode-Profil in ~/.codex/config.toml gehört, und verweisen für die Modelle auf die live geführte Liste /models – Modellwechsel unter derselben Anweisungsdatei sind der Normalfall, und die deutschen Regeln gelten weiter.
FAQ
Gibt es eine Spracheinstellung?
Auf den geprüften Seiten nicht – weder die Settings- noch die Umgebungsvariablen-Referenz von Claude Code nennen eine Antwort- oder Locale-Sprache, und Codex' Anweisungsseiten ebenso nicht. Dokumentiert sind Anweisungsdateien; die Sprache wird also aufgeschrieben statt konfiguriert.
Wohin mit der Regel, damit sie immer gilt?
In die persönliche Datei: Claude Code dokumentiert ~/.claude/CLAUDE.md als persönliche Vorlieben für alle Projekte und ./CLAUDE.md als team-geteilte Anweisungen des Projekts. Sprachregel in die persönliche Datei, Konventionen des Repositorys in die Projektdatei.
Funktioniert Deutsch in CLAUDE.md überhaupt?
Die Datei ist Markdown in schlichtem Text, und die Docs beschreiben das Lesen zu Session-Beginn ohne Aussage zur Natürlichen Sprache – deutscher Text ist damit einfach Inhalt. Entschiedend sind Länge und Platzierung: die Docs empfehlen unter 200 Zeilen und warnen vor sinkender Befolgung bei längeren Dateien.
Müssen Bezeichner und Commits auch deutsch sein?
Das ist eine Konvention, keine Hersteller-Tatsache – aber schreiben Sie sie ausdrücklich fest. Sonst entscheidet das Modell je Aufgabe, und der übliche Ausgang sind deutsche Bezeichner in einem englisch benannten Codebase. Umlaute aus Bezeichnern zu halten erspart außerdem Transliteration und Kodierungsprobleme flussabwärts.
Was bricht still?
Zwei dokumentierte Verhaltensweisen: Block-Kommentare in CLAUDE.md werden vor der Übergabe an das Modell entfernt, eine versteckte Regel kommt also nie an. Und Claude Code liest AGENTS.md nur, wenn oberhalb des Arbeitsverzeichnisses kein CLAUDE.md liegt – eine übrig gelassene AGENTS.md kann deshalb ignoriert werden.
Bleibt Deutsch, wenn ein Relay ein anderes Modell liefert?
Die Anweisungsdatei wird vom CLI vor der Anfrage gelesen und hängt damit nicht an einem Modell. Ob ein konkretes Modell Deutsch konsistent befolgt, ist Ihr eigener Test – die Docs sagen ausdrücklich, dass diese Dateien Kontext sind und keine erzwungene Konfiguration.
Quellen
Claude Code: die Memory-Seite („How Claude remembers your project"), die Settings-Seite und die Umgebungsvariablen-Referenz auf code.claude.com, abgerufen am 2026-10-01. Codex: die AGENTS.md- und CLI-Dokumentation von developers.openai.com, am selben Tag. QCode-Angaben stammen aus den eigenen QCode-Seiten. Wo die Docs schweigen, sagt diese Seite, dass sie schweigen.
Eine Anweisungsdatei, Deutsch ab der ersten Session
Sprachregel einmal aufschreiben, mit /context verifizieren, dann über die Modelle testen, die Sie tatsächlich aufrufen.
Verwandte Themen
CLAUDE.md Best Practices
Aufbau, Länge und was in die Datei gehört.
AGENTS-Spezifikation: der Guide
Suchreihenfolge und Vorrang über den Baum hinweg.
Claude-Code-Guide
Installation, Sessions und die Settings-Scopes.
Die Dokumentation beider Herstellerwerkzeuge ändert sich; jedes zitierte Verhalten wurde am 2026-10-01 auf den offiziellen Seiten gelesen. Modellverhalten bei deutscher Ausgabe ist keine Herstellerzusage – prüfen Sie es in Ihrem Repository.