Claude Code Skills in Codex nutzen

Wenn das Claude-Code-Token-Kontingent zur Neige geht und die Billing-Periode noch Tage entfernt ist, stehst Du vor einer konkreten Frage: Kannst Du OpenAI Codex im selben Projekt weiterverwenden, in dem schon eine CLAUDE.md und eigene Skills liegen? Die Antwort ist ja, aber mit zwei kleinen Vorbehalten. Skills sind dank eines gemeinsamen offenen Standards portierbar, und die CLAUDE.md braucht nur eine einzige Konfigurationszeile, damit Codex sie findet.

Was der Agent-Skills-Standard bedeutet

Anthropic hat das SKILL.md-Format ursprünglich für Claude Code entwickelt und dann Anfang 2026 als offenen Standard unter dem Namen „Agent Skills” veröffentlicht. OpenAI Codex CLI, Gemini CLI, GitHub Copilot, Cursor und über dreißig weitere Tools haben sich seitdem darauf geeinigt. Die Spezifikation ist einfach gehalten: Ein Skill ist ein Ordner mit einer SKILL.md, die mindestens ein name- und ein description-Feld im YAML-Frontmatter enthält, gefolgt von den eigentlichen Anweisungen als Markdown.

Das bedeutet in der Praxis, dass ein Skill, den Du für Claude Code geschrieben hast, auch in Codex läuft. Claude-Code-spezifische Frontmatter-Felder wie context: fork (startet einen Subagenten) oder disable-model-invocation: true werden von Codex einfach ignoriert, ohne dass der Skill abbricht. Du verlierst diese Spezialfeatures, aber die Kernanweisungen bleiben vollständig wirksam.

Skills aus .claude/skills/ in Codex verfügbar machen

Claude Code sucht Skills standardmäßig in .claude/skills/. Codex sucht sie in .agents/skills/. Du hast zwei Möglichkeiten, das zu lösen.

Die schnellste ist, Codex direkt auf das bestehende Verzeichnis zu zeigen. Lege ~/.codex/config.toml an oder öffne sie, falls sie bereits existiert, und trage jeden Skill-Pfad ein:

[skills]
config = [
  { path = ".claude/skills/artikel-review", enabled = true },
  { path = ".claude/skills/sonoya-artikel", enabled = true }
]

Ersetze die Pfade durch Deine eigenen Skill-Ordner. Codex liest sie beim nächsten Start.

Alternativ kopierst Du den kompletten Ordner einmalig:

cp -r .claude/skills .agents/skills

Die erste Variante ist sinnvoller, wenn Du das Projekt weiterhin parallel mit beiden Tools nutzen willst, weil Du die Skills nur an einem Ort pflegst. Die zweite eignet sich, wenn Du bei Codex bleiben und eine saubere Trennung haben möchtest.

Die CLAUDE.md lädt Codex nicht automatisch

Das ist der einzige Punkt, der wirklich eine Anpassung erfordert: Codex liest standardmäßig AGENTS.md, nicht CLAUDE.md. Wenn das Projektwissen in einer CLAUDE.md liegt, sieht Codex sie schlicht nicht.

Der einfachste Fix ist eine einmalige Konfiguration in ~/.codex/config.toml:

project_doc_fallback_filenames = ["CLAUDE.md", "claude.md"]

Diese Zeile weist Codex an, nach AGENTS.md zu suchen, und greift auf CLAUDE.md zurück, wenn sie fehlt. Du musst nichts umbenennen, und beide Tools lesen weiterhin ihre jeweils eigene Datei.

Wenn Du lieber eine vollständige Trennung möchtest, erstellst Du einen Symlink im Projektverzeichnis:

ln -s CLAUDE.md AGENTS.md

Ein Symlink hält beide Namen synchron, ohne dass Inhalte doppelt gepflegt werden müssen.

Größenlimit beachten: Codex verarbeitet Projektdokumentation bis zu einem Standardlimit von 32 KiB. Sehr umfangreiche CLAUDE.md-Dateien werden nach dieser Grenze abgeschnitten. Claude Code selbst kommt am besten mit Dateien unter etwa 2.500 Wörtern aus, sodass dies in den meisten Projekten kein Problem darstellt.

Der Wechsel in der Praxis

Falls Du Codex CLI noch nicht installiert hast, richtest Du es über npm ein (Node.js 22 oder neuer ist Voraussetzung):

npm install -g @openai/codex

Dann benötigst Du einen API-Key von OpenAI, den Du als Umgebungsvariable setzt:

export OPENAI_API_KEY=sk-...

Anschließend startest Du Codex im Projektverzeichnis:

codex

Codex liest beim Start zuerst die Projektdokumentation, dann die konfigurierten Skills-Ordner. Du siehst in der Ausgabe, welche Skills geladen wurden, bevor die erste Eingabeaufforderung erscheint.

Was sich spürbar anders verhält

Der offensichtlichste Unterschied ist das Modell: Codex nutzt GPT-5.5, nicht Claude. Das Reasoning-Verhalten unterscheidet sich messbar, besonders bei komplexen Mehrdatei-Refactorings. Codex ist dabei deutlich knapper: Bei identischen Aufgaben produziert GPT-5.5 laut Vergleichen aus 2026 rund 72 Prozent weniger Output-Tokens als Opus 4.7. Wer an die ausführlichen Erklärungen und Rückfragen von Claude Code gewöhnt ist, findet Codex zunächst wortkarg.

Das hat aber einen direkten Vorteil für das Token-Budget: Der Standardkontext von Codex liegt bei 256.000 Tokens, und typische Sessions halten erheblich länger als unter Claude Code, das bei gleichen Aufgaben etwa viermal so viele Tokens verbraucht. Genau das ist ja der Grund, warum Du wechselst.

Für Skills gilt: Je stärker ein Skill Claude-spezifische Features wie Subagenten-Ausführung oder dynamische Kontextinjektion nutzt, desto weniger vollständig läuft er in Codex. Ein Skill, der nur Markdown-Anweisungen und optionale Skripte enthält, verhält sich dagegen nahezu identisch.

Wo der Wechsel seine Grenzen hat

Ein Projekt mit einfachen SKILL.md-Dateien und einer informationsreichen CLAUDE.md ist in wenigen Minuten auf Codex übertragbar. Projektwissen und Konventionen bleiben erhalten.

Schwieriger wird es bei Projekten, die stark auf Claude-Code-spezifische Features setzen: Hooks in .claude/settings.json, Subagenten-Skills mit context: fork, oder MCP-Server-Konfigurationen, die Claude Code fest verdrahtet hat. Codex hat zwar ein eigenes MCP-System, aber die Konfiguration ist nicht kompatibel und muss separat angelegt werden. Wer solche Setups betreibt, sollte den Wechsel auf einem Testprojekt ausprobieren, bevor er mitten in einer kritischen Session wechselt.

Für die meisten Alltagsworkflows dagegen, ob Artikel schreiben, Code-Reviews, Deployment-Checklisten oder Dokumentation, funktioniert der Umstieg reibungslos.

Fazit

Claude Code Skills sind dank des Agent-Skills-Standards portierbar, und die CLAUDE.md braucht für Codex nur eine einzige Konfigurationszeile. Der eigentliche Unterschied liegt nicht in den Projektdateien, sondern im Modellverhalten: Codex arbeitet token-sparender und kürzer in der Ausgabe, dafür deutlich effizienter beim Budget. Wer beim nächsten Token-Engpass nicht auf die Billing-Periode warten will, richtet die config.toml am besten jetzt ein, bevor der Notfall eintritt.

Falls Du Claude Code noch nicht eingerichtet hast, hilft Dir die Anleitung: Claude Code auf dem Mac installieren & nutzen als Einstieg. Wie sich Claude Fable 5 von seinem Vorgänger abhebt und wie Du das Token-Budget grundsätzlich streckst, steht unter Claude Fable 5: Features, Mythos 5 und Token-Spar-Tipps.