So migrierst du 2026 von Claude Code zu Codex: eine Schritt-für-Schritt-Anleitung

Ailoot-Dokumentation: API, Schlüssel und Einrichtung.

Warum braucht man das Codex-Migrationstool überhaupt?#

OpenAI fügte die Funktion Anfang Juni 2026 zu Codex hinzu. Im offiziellen Changelog heißt es knapp:

Mit anderen Worten: Wenn du die Codex App zum ersten Mal startest oder in den Einstellungen eines bereits laufenden Clients, startet ein Assistent, der die lokalen Konfigurationen eines anderen Agenten ausliest. Claude Code und Claude Cowork werden derzeit unterstützt.

Warum OpenAI das tut, ist klar. Nachdem Sites gestartet und die Codex App im Mai–Juni 2026 aktualisiert wurde, erhielt Codex alles, worin Claude Code OpenAI zuvor voraus war: ein Terminal, Plugins, lange Sitzungen und Orchestrierung. Die Migration beseitigt die letzte Hürde für Teams, die Claude Code bereits in ihren Stack integriert haben: „Unterstützte Einstellungen lassen sich importieren und anschließend gegen das Ausgangsinventar prüfen.“

Warum du das brauchen könntest, ist weniger eindeutig. Ich habe beide direkt im Leitfaden Codex vs. Claude Code verglichen: Claude ist bei langen Architekturgesprächen und im Plan-Modus weiterhin voraus, während Codex bei autonomen Aufgaben und parallelen PRs schneller ist. Wenn du dich für einen vollständigen Wechsel entschieden hast, lies weiter. Wenn du eine Kombination erwägst, sind vielleicht die Muster für die Zusammenarbeit relevanter.

Was überträgt das Migrationstool automatisch?#

Ich gehe die Gruppen durch und erkläre genau, was mit den einzelnen Bestandteilen von ~/.claude geschieht.

1. Anweisungen und Kontext. CLAUDE.md-Dateien – die globale Datei in ~/.claude/ und Projektdateien in Repositories – werden ins Format AGENTS.md umgewandelt. Die globale Datei landet unter ~/.codex/AGENTS.md; Projektdateien bleiben im Stammverzeichnis des Repositorys und in dessen Unterordnern. Das Format AGENTS.md ist im Wesentlichen dieselbe Art Markdown-Datei mit Regeln; die Unterschiede sind hauptsächlich kosmetisch – Abschnittsnamen und einige spezifische Direktiven. Ich habe erklärt, was AGENTS.md ist und warum Codex es braucht.

2. Skills. Der Ordner ~/.claude/skills/ wird vollständig durchsucht; jeder Skill wird an die Codex-Struktur angepasst und unter $HOME/.agents/skills abgelegt. Projekt-Skills aus .claude/skills/ in einem Repository werden nach .agents/skills verschoben. Das Format SKILL.md mit Frontmatter wird nahezu unverändert übertragen. Verwendet ein Skill Claude-spezifische Auslöser, wird er zur Prüfung markiert.

3. MCP-Server. Die Konfiguration .mcp.json (sowohl global als auch auf Projektebene) wird ins Codex-Format importiert. Servernamen, Startbefehle und Pfade bleiben erhalten. Nicht übertragen werden Tokens und Umgebungsvariablen. Aus Sicherheitsgründen bittet Codex dich erneut um API-Schlüssel und Passwörter, damit diese während der Migration nicht offengelegt werden. Das ist eine einmalige Aufgabe: Öffne in der Codex App den MCP-Bereich und gib die Tokens ein, die du bereits in deinem Passwortmanager hast.

4. Hooks. Das ist die komplizierte Gruppe. Hooks mit deterministischer Logik (blockieren rm -rf, bei Pfaden mit schlüsselähnlichen Zugangsdaten warnen, Nachweise aufzeichnen) werden vollständig übertragen. Hooks mit Auslösern, für die es in Codex kein Äquivalent gibt (zum Beispiel bestimmte Claude-Code-Lifecycle-Ereignisse), werden zur „manuellen Prüfung“ markiert und nicht automatisch aktiviert. Als Bezugspunkt habe ich ausführlich erklärt, wie Hooks in Claude Code funktionieren – Codex hat weniger Typen.

5. Sitzungsverlauf. Bis zu den letzten 30 Tagen Claude-Code-Aktivität werden als Referenz importiert. Das bedeutet nicht, dass du „genau dort weitermachst, wo du aufgehört hast“, aber deine früheren Unterhaltungen werden in Codex sichtbar sein, damit du den Projektkontext schnell wieder in Erinnerung rufen kannst, ohne alles noch einmal erklären zu müssen.

Das Migrationstool unterscheidet nicht zwischen aktiven Dateien und experimentellen Artefakten – es überträgt alles. Nach der Migration ist es sinnvoll, manuell aufzuräumen und alles zu entfernen, was du in den letzten sechs Monaten nicht verwendet hast.

Was wird NICHT übertragen und warum?#

Ich gehe jede Gruppe aus der Perspektive „Was ist nach der Migration zu tun?“ durch.

MCP-Tokens und API-Schlüssel. Das ist der vorhersehbarste Teil. Nach dem Scan zeigt Codex dir eine Liste aller MCP-Server, die es in Claude gefunden hat. Für jeden Server bittet es um Schlüssel und Tokens. Am einfachsten ist es, den Passwortmanager bereitzuhalten und alle Server in einem Durchgang abzuarbeiten. Danach funktioniert MCP in Codex und Claude Code identisch. Prüfe die Befehls- und Verbindungsparameter des von dir gewählten MCP-Servers anhand seiner Dokumentation.

Slash-Befehle /name. In Claude Code bist du es gewohnt, einen Skill mit /skill-name aufzurufen. In Codex ist der kanonische Aufruf anders: $skill-name. Ein häufiger Migrationsfehler ist, /name-Befehle als Beweis dafür zu werten, dass Skills geladen wurden.

Teste nach der Migration einige wichtige Skills mit $skill-name in Codex. Wenn sie funktionieren, war die Migration tatsächlich erfolgreich. Verlass dich nicht auf das Häkchen „Skills migriert“ im Assistenten – überprüfe es, indem du sie aufrufst.

Hooks ohne Codex-Äquivalent. Wenn du einen Hook für bestimmte Claude-Code-Ereignisse hattest – zum Beispiel bei pre-tool-use für eine bestimmte Werkzeugkombination –, gibt es diesen Auslöser möglicherweise in Codex nicht. Das Migrationstool markiert solche Hooks und lässt sie inaktiv. Du musst entscheiden, ob du sie für ein Codex-Äquivalent umschreibst, entfernst oder in Claude Code belässt (falls du beide parallel ausführst). Eine gute Faustregel: Übertrage nur deterministische Hooks; alles andere ist ein Grund, die Leiter im neuen Tool nicht zu duplizieren.

Teamabläufe auf Basis von Subagenten. Ich habe erklärt, was Subagenten in Claude Code sind und wie man verschachtelte Subagenten verwendet. In Codex werden Subagenten über Profile und Rollen organisiert (siehe unten). Wenn du in Claude eine komplexe Pipeline mit mehreren Subagenten in einer Kette hattest, musst du sie rund um das Codex-Profilkonzept neu schreiben. Das Migrationstool markiert solche Setups mit „erfordert architektonische Überarbeitung“.

Umfangreiche, Claude-spezifische CLAUDE.md-Dateien. Wenn eine Datei auf 2.000–3.000 Zeilen mit Abschnitten für jedes Projekt angewachsen ist, akzeptiert Codex sie möglicherweise, aber das ist keine gute Vorgehensweise. AGENTS.md ist dafür gedacht, kompakt und verteilt zu sein: globale Regeln in ~/.codex/AGENTS.md, projektspezifische Regeln im Stammverzeichnis des Repositorys und eng gefasste Überschreibungen in Unterordnern. Lass CLAUDE.md nach der Migration nicht als „riesige Anweisungsdatei“ bestehen, sondern teile sie auf die Ebenen auf. Ich habe erklärt, wie man CLAUDE.md richtig konfiguriert; derselbe Ansatz gilt für AGENTS.md.

Schritt für Schritt: 4 Aktionen in der Codex App#

Hier ist die konkrete Checkliste.

1. Schritt 1: Aktualisiere die Codex App auf Version 26.608 oder höher

   Das Migrationstool erschien in Version 26.608 (veröffentlicht am 9. Juni 2026). Öffne unter macOS die Codex App und suche nach Updates. Mach dasselbe unter Windows. Wenn du die Codex CLI ausführst, stelle sicher, dass sie mit der aktuellen App kompatibel ist. Ohne die neueste Version erscheint „Setup eines anderen Agenten importieren“ nicht in den Einstellungen.

2. Schritt 2: Starte den Import in den Einstellungen

   Öffne in der Codex App die Einstellungen und suche nach „Setup eines anderen Agenten importieren“. Wenn du die Codex App gerade erst installiert hast, bietet der Assistent die Migration während des Onboardings an. Nach dem Start durchsucht der Assistent das Dateisystem: ~/.claude/ und Repositories mit CLAUDE.md oder .claude/. Der Scan dauert je nach Anzahl der Dateien zwischen 30 Sekunden und mehreren Minuten.

3. Schritt 3: Bestätige den Migrationsplan

   Nach dem Scan zeigt Codex eine Bestandsaufnahme an: wie viele Skills gefunden wurden, wie viele MCP-Server, wie viele CLAUDE.md-Dateien gefunden wurden, welche Hooks für die Migration infrage kommen und wie viele Tage Sitzungsverlauf verfügbar sind. Du kannst alle Gruppen abwählen, die du nicht übertragen möchtest. Standardmäßig ist alles ausgewählt, was Codex als sicher importierbar einstuft.

4. Schritt 4: Warte auf den Abschluss und gib Tokens ein

   Der Import dauert 1–5 Minuten. Wenn er abgeschlossen ist, öffnet Codex ein Folgefenster: „Das konnte ich nicht automatisch übertragen; prüfe es manuell.“ Normalerweise ist dies eine Liste von MCP-Servern, die Tokens benötigen. Öffne deinen Passwortmanager und gib die Schlüssel in das Codex-Formular ein. Danach ist der Hauptteil der Migration abgeschlossen.

Überprüfe anschließend das Ergebnis. Öffne ein Projekt, an dem du üblicherweise in Claude Code gearbeitet hast, und prüfe Folgendes:

• cat ~/.codex/AGENTS.md — Sind deine globalen Regeln dort vorhanden?
• Führe einen beliebigen Skill aus: $skill-name. Er sollte geladen werden.
• Öffne .mcp.json im Projekt und prüfe, ob die erforderlichen Server laufen.
• Starte eine Unterhaltung, die deiner typischen Arbeitsweise entspricht. Codex zeigt dir, welche importierten Hooks es nicht verwenden kann; das sind konkrete manuelle Inventareinträge; ein fester Restanteil ist nicht belegt.

Hooks und Subagenten: Codex-Äquivalente und was umgeschrieben werden muss#

Hooks. In Claude Code kannst du an jedes Lifecycle-Ereignis einen Shell-Befehl hängen (pre-tool-use, post-tool-use, on-error, on-context-load und so weiter). Codex hat eine kleinere Auswahl an Ereignissen: Es kann vor der Ausführung prüfen, Nachweise aufzeichnen und gefährliche Befehle blockieren. Wenn du einen pre-tool-use-Hook hattest, der eine bestimmte Kombination filterte, musst du ihn in Codex in eine allgemeine Prüfung vor der Ausführung einbetten oder entfernen. Ich habe die Architektur der Claude-Code-Hooks ausführlich erklärt; wenn du sie intensiv genutzt hast, liste jeden Auslöser samt benötigtem Effekt auf. Bestimme ein unterstütztes Äquivalent und prüfe es vor der Aktivierung.

Subagenten. In Claude Code ist ein Subagent ein separater Kontext mit eigenem System-Prompt, der über einen /command oder aus der Hauptunterhaltung gestartet wird. Codex hat mit Profilen ein ähnliches Konzept: Du kannst ein Profil mit bestimmten Skills, Berechtigungen und einer Genehmigungsrichtlinie definieren. Profile lösen ungefähr dasselbe Problem – sie isolieren den Kontext für eine bestimmte Aufgabenklasse –, aber über Einstellungen statt über einen ausdrücklichen Agentenaufruf.

Was das in der Praxis bedeutet:

• Wenn du einen „security-reviewer“-Subagenten mit eigenem Prompt hattest, erstelle in Codex ein security-review-Profil mit den erforderlichen Berechtigungen und höherem Reasoning-Aufwand.
• Wenn du einen „feature-developer“-Subagenten hattest, ist das einfach standardmäßig ein Arbeitsprofil; nichts Besonderes ist erforderlich.
• Wenn du verschachtelte Subagenten verwendet hast, funktioniert das in Codex nicht eins zu eins; überdenke den Ablauf mithilfe einer Profilkette oder expliziter Skills.

Das Migrationstool versucht, Profile mit den Namen deiner Subagenten zu erstellen, und markiert, welche Auslöser nicht übertragen wurden. Der Aufwand hängt von Rollenanzahl, Auslösern, Berechtigungen und Abhängigkeiten ab. Teste jede benötigte Pipeline, bevor du sie als migriert betrachtest.

Wann du vollständig migrieren und wann du beide Tools behalten solltest#

Ein einfacher Entscheidungsfilter:

Ein vollständiger Wechsel zu Codex lohnt sich, wenn:

• Du hauptsächlich autonome PRs und parallele Aufgaben erledigst.
• Dein GitHub-Workflow tief integriert ist und der Codex Cloud Agent 80 % der Arbeit erledigt.
• Du nicht viel Zeit mit Architekturgesprächen und dem Plan-Modus verbringst.
• Du lieber für ein Tool als für zwei bezahlen möchtest.

Claude Code und Codex gemeinsam behalten, wenn:

• Du den Plan-Modus regelmäßig für lange Architekturentscheidungen verwendest.
• Du parallele Arbeit brauchst: Codex läuft in der Cloud an einer Aufgabe, während Claude Code den Kontext für eine andere hält.
• Du viele einmalige Hacks und Mikroprojekte erledigst, bei denen der Plan-Modus übertrieben ist.
• Du eine komplexe Subagenten-Pipeline hast, die nicht an einem Abend umgeschrieben werden kann.

Ich persönlich nutze beide: Claude Code führt das lange Gespräch, während Codex „N Fehler parallel beheben“ oder „einen PR prüfen“ übernimmt. Mehr dazu, wie das funktioniert, habe ich im Leitfaden zur Zusammenarbeit mit Claude Code und Codex erklärt.

Das Wichtigste, was ich zur Migration sagen würde: Das Migrationstool beseitigt die technische Hürde für den Wechsel, beantwortet aber nicht die Frage, ob du überhaupt wechseln musst. Entscheide zuerst, welche Art von Arbeit du erledigst. Dann wähle das Tool.

Wenn du über Ailoot auf neuronale Netze zugreifen möchtest, wirf einen Blick auf Ailoot.