Claude Code zu Codex wechseln: CLAUDE.md, MCP-Server und Berechtigungen umziehen

Du willst von Claude Code zu Codex wechseln, ohne dein ganzes Projekt-Setup neu aufzubauen? Seit Version 0.140 der Codex CLI gibt es dafür den Befehl /import. Er holt deine MCP-Server samt Zugangsdaten, Subagenten, Plugins und bis zu 30 Tage Chatverlauf nach OpenAIs Terminal-Agent. Deine CLAUDE.md wird dabei wortgleich zu einer AGENTS.md kopiert. Eigene Skills und Berechtigungseinstellungen bleiben Handarbeit. Diesen Ablauf habe ich am eigenen Setup durchgespielt, mit allen Zahlen.

Der häufigste Auslöser für den Gedanken ist ein neuer Modell-Launch. Anfang September 2026 kamen kurz hintereinander OpenAIs GPT-6 Astra und Claude Fable 5.1 heraus, beide als neues Spitzenmodell beworben. Welches im Alltag besser passt, klären wir im direkten Vergleich von Claude und ChatGPT. Dieser Guide beantwortet die praktische Frage dahinter: Wie viel von deiner Konfiguration kannst du mitnehmen, wenn du dich umentscheidest?

Was solltest du vor dem Wechsel von Claude Code zu Codex wissen?

Für wen ist der Guide gedacht? Für Solo-Selbstständige und kleine Teams, die Claude Code im Alltag nutzen und Codex ernsthaft testen wollen. Vorweg das wichtigste Ergebnis: Der /import-Befehl nimmt dir das Neu-Eintragen der MCP-Server samt Zugangsdaten und den Chat-Verlauf ab. Deine CLAUDE.md landet als wortgleiche Kopie. Eigene Skills und Berechtigungseinstellungen richtest du danach von Hand ein.

Was ist der Unterschied zwischen CLAUDE.md und AGENTS.md?

AGENTS.md ist ein offener Standard für Projektanweisungen an KI-Coding-Agenten. Neben Codex lesen ihn auch Cursor, Jules, Amp, Factory und weitere Werkzeuge. Claude Code nutzt stattdessen CLAUDE.md. Codex liest deine CLAUDE.md nicht, es sei denn, du sagst es ihm ausdrücklich. Der Kern des Umzugs ist deshalb ein simples Kopieren. In meinem Test hat Codex die AGENTS.md Zeichen für Zeichen aus der CLAUDE.md übernommen und nichts umformuliert, auch nicht die Claude-spezifischen Stellen.

Codex sucht Anweisungen in dieser Reihenfolge: zuerst die globale ~/.codex/AGENTS.md, dann jede Ebene vom Git-Wurzelverzeichnis bis zum aktuellen Ordner. Alle gefundenen Dateien werden aneinandergehängt, die spezifischste zuletzt. Dateien näher am Arbeitsverzeichnis überschreiben also allgemeinere Vorgaben. Das Prinzip kennst du aus Claude Codes verschachtelten CLAUDE.md-Dateien. Nur der Dateiname ändert sich.

Zwei Auswege gibt es. Du hebst das Limit in der config.toml an, etwa auf project_doc_max_bytes = 65536 für 64 KiB. Das kostet bei jedem Lauf Tokens. Oder du teilst die Anweisungen bewusst auf mehrere verschachtelte AGENTS.md auf, damit pro Ordner nur die wirklich relevante Anleitung geladen wird. Die deutschsprachige AGENTS.md-Referenz von Pexon Consulting empfiehlt zusätzlich, pro Konvention ein Codebeispiel statt drei Absätze Prosa zu schreiben. Agenten kopieren Muster zuverlässiger, als sie Beschreibungen interpretieren.

Bei meinem Umzug war die Grenze kein Thema. Die erzeugte AGENTS.md kam auf 9641 Bytes, weit unter 32 KiB, und war vollständig. Relevant wird die Marke erst bei sehr umfangreichen oder stark verschachtelten Regelwerken. Und wichtig: Zusammengefasst werden nur die Instruktionsdateien, also die AGENTS.md-Ebenen, keine beliebige Markdown-Datei im Projekt.

Welches Claude-Code-Feature entspricht welchem in Codex?

Fast jedes Konzept aus Claude Code hat inzwischen ein Gegenstück in Codex. Nur der Ort und die Syntax der Konfiguration unterscheiden sich. Diese Tabelle ist der schnellste Weg, dein Setup gedanklich zu übersetzen.

Wie ziehst du dein Setup mit dem /import-Befehl um?

Der /import-Befehl ist der offiziell dokumentierte Weg. Er bringt dein Setup von Claude Code, dem Terminal-Agenten von Anthropic, in einem Durchlauf nach Codex. Deine bestehende Claude-Code-Installation bleibt dabei unangetastet.

Mein Import im Detail: Jeder Lauf dauerte zwischen fünf und zehn Sekunden und meldete null Fehler. Wichtig war der Startordner. Mein erster Versuch lief aus einem leeren Ordner. Von dort kamen nur die globalen Dinge, ohne meine Projektregeln. Erst der Lauf aus dem echten Projektordner brachte alles.

Übernommen wurde nach beiden Läufen:

In meinen Läufen tauchten diese Kategorien auf: Instruktionen, MCP-Server, Subagenten, Plugins, Chats. Die Dokumentation nennt zusätzlich Skills und Hooks. Meine eigenen Skills kamen nicht mit, Hooks hatte ich keine. Meine Berechtigungsregeln aus settings.json kamen ebenfalls nicht an, was auch logisch ist: Codex hat keine direkte Entsprechung zu Claudes Berechtigungs-Kaskade. Die AGENTS.md selbst war eine exakte Kopie meiner CLAUDE.md, vollständig, nichts abgeschnitten. Auch die Claude-Code-spezifischen Regeln übernahm Codex unverändert, etwa Pfad-Vorgaben, die „Claude“ ansprechen, und Verweise auf meine Skill-Ordner. Die passt du danach selbst an.

Kannst du direkt nach dem Import arbeiten? Fast. Deine Projektregeln greifen sofort, die AGENTS.md liegt im Ordner und Codex liest sie. Die MCP-Server sind mit Zugangsdaten da und funktionieren. Was fehlt, sind deine eigenen Skills und deine Berechtigungseinstellungen. Und ein Punkt, der leicht übersehen wird: Codex liest nur den Ordner, aus dem du es startest. Um mit deinen echten Projektdateien zu arbeiten, startest du codex im Projektordner, nicht in einem frischen Verzeichnis. Deine übrigen Markdown-Dateien, etwa ein Memory-Verzeichnis, hat der Import nicht angefasst. Die liegen unverändert im Projektordner und Codex kann sie lesen wie Claude Code. Es fehlt nur das automatische Einlesen beim Start. Wenn deine AGENTS.md eine Anweisung wie „lies zu Beginn die Datei X“ enthält, folgt Codex ihr trotzdem.

Wie leitest du AGENTS.md manuell aus CLAUDE.md ab?

Weil /import die Datei ohnehin nur wortgleich kopiert, ist der manuelle Weg für die reinen Instruktionen gleichwertig. Ein Kopierbefehl im Projektordner reicht.

Die eigentliche Arbeit kommt danach, bei beiden Wegen gleich: Claude-spezifische Anweisungen anpassen. In meiner Datei betraf das Pfad- und Verhaltensregeln, die wörtlich „Claude“ ansprechen, Verweise auf meine Skill-Ordner unter claude-skills/, die Namen eigener Slash-Commands und ein Konverter-Skript, das nur in meinem Claude-Setup existiert. Das ist kein großer Block, aber er steht verstreut über die ganze Datei.

Willst du CLAUDE.md und AGENTS.md dauerhaft synchron halten statt einmal zu kopieren, drehst du das Verhältnis um. AGENTS.md wird die eigentliche Quelle, CLAUDE.md bekommt nur eine Importzeile an den Anfang.

Claude Code löst die @-Zeile automatisch auf und liest den kompletten Inhalt von AGENTS.md mit, plus deine Claude-eigenen Ergänzungen darunter. Diese Importzeile reist mit dem Repository, greift also für jeden Claude-Code-Nutzer im Team.

Und die MCP-Server? Der /import-Befehl nimmt sie komplett mit, in den Abschnitt [mcp_servers.name] der config.toml. Bei meinen sieben Servern standen nach dem Import Befehl, Argumente und Zugangsdaten drin. Ich musste nichts nachtragen. Das Protokoll ist identisch zu Claude Code. Nur der Ort der Konfiguration ändert sich. Server mit eigener WebSocket- oder SSE-Anbindung oder besonderen Headern können laut Dokumentation eine erneute Anmeldung brauchen.

Wie funktionieren Berechtigungen und Sandbox in Codex?

Codex trennt zwei Einstellungen, die in Claude Codes settings.json vermischt sind. approval_policy regelt, wann Codex vor einem Befehl nachfragt. sandbox_mode regelt, was der Agent überhaupt anfassen darf.

Für den Alltag empfiehlt sich on-request zusammen mit workspace-write. Das reicht für flüssiges Arbeiten und zeigt dir trotzdem jeden Versuch, den Projektordner zu verlassen. Eine Minimal-config.toml sieht so aus:

Für feinere Kontrolle gibt es die experimentellen .rules-Dateien im Ordner ~/.codex/rules/, das grobe Gegenstück zu Claude Codes settings.local.json. Sie nutzen die Sprache Starlark. Eine Regel sieht so aus:

Erlaubte Entscheidungen sind allow, prompt und forbidden. Treffen mehrere Regeln zu, gewinnt die strengste.

Was kommt beim Umzug nicht sauber mit?

Der /import-Befehl deckt heute deutlich mehr ab als noch vor einem halben Jahr. Subagenten und Plugins wandern automatisch mit. Zwei Dinge bleiben trotzdem Handarbeit, ein drittes hängt von deinem Setup ab.

• Eigene Skills: In meinen Läufen tauchten sie im Import nicht auf. Codex nutzt zwar dasselbe SKILL.md-Format, die Skills legst du in Codex aber neu an.
• Claude-spezifische Syntax: Feste Aufrufe für Claude-eigene Tools oder Verweise auf Claude-Slash-Commands in deiner CLAUDE.md versteht Codex nicht. Diese Zeilen passt du von Hand an.
• Hooks: Die Doku führt Hooks als Teil des Imports. Mein Setup hatte keine, das konnte ich nicht prüfen. Wenn du komplexe Hook-Ketten nutzt, rechne mit Nacharbeit, weil das Codex-Format von Claude Codes Hooks abweicht.

Läuft Codex auch in der Cloud wie Claude Code Cloud?

Ja, das Gegenstück heißt codex cloud exec. Du schickst eine Aufgabe an eine Cloud-Umgebung. Der Agent arbeitet dort asynchron und liefert am Ende einen Diff zurück.

Zur Steuerung gibt es codex cloud status, codex cloud list, codex cloud diff und codex cloud apply. Mit --attempts 3 lässt Codex drei unabhängige Läufe für dasselbe Problem rechnen, bis zu vier sind möglich. Du übernimmst danach den besten. Ein echtes Live-Mitverfolgen wie bei Claude Code Cloud gibt es nicht. Das Feature ist eher für lange Aufgaben über Nacht gedacht. Und es braucht mindestens den ChatGPT-Plus-Plan für 20 US-Dollar. Der kostenlose Plan deckt nur lokale Läufe ab.

Wo bleibt Claude Code im Vorteil, wo Codex?

Ein Umzug ist keine Einbahnstraße zum besseren Tool. Beide Seiten haben klare Stärken, unabhängig davon, welches Modell gerade in den Benchmarks führt.

Und dein Chatverlauf bei claude.ai?

Der Umzug der Terminal-Konfiguration ist die eine Hälfte. Wer daneben auch bei claude.ai im Chat arbeitet, fragt sich, ob die Gespräche mitkommen. Kurze Antwort: Ein reiner Chat-Export bringt wenig. Einzelne Claude-Gespräche als JSON zu exportieren und woanders hochzuladen, hilft im Alltag kaum.

Anders sieht es beim Memory aus. Für den Weg von einem anderen KI-Tool zu Claude gibt es eine offizielle Seite, claude.com/import-memory. Sie liefert einen fertigen Prompt, den du in deinem alten Chat absendest, etwa bei ChatGPT oder Gemini, und übernimmt die Ausgabe in wenigen Minuten. In die andere Richtung, von Claude zu ChatGPT, gibt es keinen nativen Import. Dort hilft ein Kombinations-Prompt, der deinen Export mit den gespeicherten Erinnerungen zu einer Markdown-Datei verdichtet. Mehr dazu im direkten Vergleich von Claude und ChatGPT.

Musst du dich entscheiden, oder geht beides parallel?

Ein vollständiger Wechsel ist keine Voraussetzung. Claude Code und Codex schreiben in getrennte Ordner, ~/.claude/ und ~/.codex/. Sie stören sich nicht. CLAUDE.md und AGENTS.md können über die @-Importzeile nebeneinander im selben Projekt liegen.

Sinnvoll ist ein zwei- bis dreiwöchiger Parallelbetrieb, bevor du dich festlegst. Bearbeite dieselbe Aufgabe testweise in beiden Tools. Vergleiche Zeitaufwand, Ergebnisqualität und wie oft du nacharbeiten musst. Danach entscheidest du mit Daten statt aus dem Bauch. Wer tiefer in die Unterschiede einsteigen will, findet sie in unserem Vergleich Claude Code gegen Cursor und in der Claude Code Anleitung für Einsteiger. Einen Überblick über das gesamte Claude-Ökosystem gibt unsere Themenseite.

Welcher Umzugsweg passt zu deinem Fall?

Wähle deine Ausgangslage, die passende Kurz-Checkliste erscheint darunter.

Wie unterscheiden sich die Umzugswege im Überblick?

Fazit: Für wen lohnt der Wechsel zu Codex?

Der Wechsel von Claude Code zu Codex ist heute kein Bruch mehr. Der /import-Befehl nimmt dir das Neu-Eintragen der MCP-Server und den Chat-Verlauf ab. Die verbleibende Handarbeit betrifft eigene Skills, die Berechtigungsregeln und die Claude-spezifischen Zeilen in deiner CLAUDE.md.

Ob es sich lohnt, hängt weniger am Modell als an deinem Arbeitsstil. Für dich, wenn du ohnehin mehrere KI-Coding-Tools nutzt, den offenen AGENTS.md-Standard schätzt oder Best-of-N-Läufe in der Cloud brauchst. Eher bei Claude Code bleiben, wenn du stark auf ein großes eigenes Skill-Set setzt. Am risikoärmsten ist der zwei- bis dreiwöchige Parallelbetrieb. Beide Konten laufen weiter. Du vergleichst an echten Aufgaben und entscheidest danach.

Häufige Fragen zum Wechsel von Claude Code zu Codex