Anpassung

Durch Anpassungen sorgen Sie dafür, dass Codex so arbeitet wie Ihr Team.

In Codex besteht die Anpassung aus mehreren Ebenen, die zusammenwirken:

• Projektvorgaben (AGENTS.md) für dauerhafte Anweisungen
• Erinnerungen für nützlichen Kontext aus früheren Arbeiten
• Skills für wiederverwendbare Arbeitsabläufe und Fachwissen
• MCP für den Zugriff auf externe Tools und gemeinsam genutzte Systeme
• Subagenten zum Delegieren von Aufgaben an spezialisierte Subagenten

Diese Elemente ergänzen einander, statt miteinander zu konkurrieren. AGENTS.md prägt das Verhalten, Erinnerungen bewahren lokalen Kontext für künftige Arbeiten, Skills bündeln wiederholbare Prozesse und MCP verbindet Codex mit Systemen außerhalb des lokalen Arbeitsbereichs.

AGENTS-Vorgaben

AGENTS.md stellt Codex dauerhafte Projektvorgaben bereit, die zusammen mit Ihrem Repository weitergegeben werden und gelten, bevor der Agent mit der Arbeit beginnt. Halten Sie die Datei knapp.

Verwenden Sie sie für Regeln, die Codex in einem Repository immer befolgen soll, beispielsweise:

• Befehle zum Erstellen und Testen
• Anforderungen an Reviews
• Repository-spezifische Konventionen
• Verzeichnisspezifische Anweisungen

Wenn der Agent falsche Annahmen über Ihre Codebasis trifft, korrigieren Sie diese in AGENTS.md und bitten Sie den Agenten, AGENTS.md zu aktualisieren, damit die Korrektur dauerhaft erhalten bleibt. Betrachten Sie dies als Rückkopplungsschleife.

Wann Sie AGENTS.md aktualisieren sollten

• Wiederholte Fehler: Wenn der Agent wiederholt denselben Fehler macht, fügen Sie eine Regel hinzu.
• Zu viel Leseaufwand: Wenn er die richtigen Dateien findet, aber zu viele Dokumente liest, ergänzen Sie Navigationsvorgaben (welche Verzeichnisse/Dateien priorisiert werden sollen).
• Wiederkehrendes PR-Feedback: Wenn Sie dasselbe Feedback mehrfach geben, halten Sie es als Regel fest.
• In GitHub: Markieren Sie in einem Pull-Request-Kommentar @codex mit einer Anfrage (zum Beispiel @codex add this to AGENTS.md), um die Aktualisierung an einen Cloud-Chat zu delegieren.
• Drift-Prüfungen automatisieren: Verwenden Sie geplante Aufgaben, um wiederkehrende Prüfungen (zum Beispiel täglich) auszuführen, die Lücken in den Vorgaben erkennen und Ergänzungen für AGENTS.md vorschlagen.

Kombinieren Sie AGENTS.md mit Infrastruktur, die diese Regeln durchsetzt: Pre-Commit-Hooks, Linter und Typprüfer erkennen Probleme, bevor Sie sie sehen, sodass das System wiederkehrende Fehler immer besser verhindern kann.

Codex kann Vorgaben aus mehreren Speicherorten laden: aus einer globalen Datei in Ihrem Codex-Stammverzeichnis (für Sie als Entwickler) und aus Repository-spezifischen Dateien, die Teams einchecken können. Dateien, die näher am Arbeitsverzeichnis liegen, haben Vorrang. Verwenden Sie die globale Datei, um festzulegen, wie Codex mit Ihnen kommuniziert (zum Beispiel Review-Stil, Ausführlichkeit und Standardvorgaben), und beschränken Sie Repository-Dateien auf Regeln für das Team und die Codebasis.

<FileTree class="mt-4" tree={[ { name: "~/.codex/", open: true, children: [ { name: "AGENTS.md", comment: "Global (für Sie als Entwickler)" }, ], }, { name: "repo-root/", open: true, children: [ { name: "AGENTS.md", comment: "Repository-spezifisch (für Ihr Team)" }, ], }, ]} />

Benutzerdefinierte Anweisungen mit AGENTS.md

Skills

Skills stellen Codex wiederverwendbare Fähigkeiten für wiederholbare Arbeitsabläufe bereit. Skills eignen sich häufig am besten für wiederverwendbare Arbeitsabläufe, da sie umfangreichere Anweisungen, Skripte und Referenzen unterstützen und zugleich aufgabenübergreifend wiederverwendbar bleiben. Skills werden geladen und sind für den Agenten sichtbar (zumindest ihre Metadaten), sodass Codex sie selbstständig entdecken und auswählen kann. Dadurch bleiben umfangreiche Arbeitsabläufe verfügbar, ohne den Kontext von Anfang an aufzublähen.

Verwenden Sie Skill-Ordner, um Arbeitsabläufe lokal zu erstellen und weiterzuentwickeln. Wenn für den Arbeitsablauf bereits ein Plugin existiert, installieren Sie es zuerst, um eine bewährte Konfiguration wiederzuverwenden. Wenn Sie Ihren eigenen Arbeitsablauf teamübergreifend verteilen oder mit Konnektoren bündeln möchten, verpacken Sie ihn als Plugin. Skills bleiben das Erstellungsformat; Plugins sind die installierbare Verteilungseinheit.

Ein Skill besteht üblicherweise aus einer SKILL.md-Datei sowie optionalen Skripten, Referenzen und Assets.

<FileTree class="mt-4" tree={[ { name: "my-skill/", open: true, children: [ { name: "SKILL.md", comment: "Erforderlich: Anweisungen + Metadaten" }, { name: "scripts/", comment: "Optional: ausführbarer Code" }, { name: "references/", comment: "Optional: Dokumentation" }, { name: "assets/", comment: "Optional: Vorlagen, Ressourcen" }, ], }, ]} />

Das Skill-Verzeichnis kann einen scripts/-Ordner mit CLI-Skripten enthalten, die Codex im Rahmen des Arbeitsablaufs aufruft (zum Beispiel zum Erzeugen von Ausgangsdaten oder zum Ausführen von Validierungen). Wenn der Arbeitsablauf externe Systeme benötigt (Issue-Tracker, Design-Tools, Dokumentationsserver), kombinieren Sie den Skill mit MCP.

Beispiel für SKILL.md:

---
name: commit
description: Stage and commit changes in semantic groups. Use when the user wants to commit, organize commits, or clean up a branch before pushing.
---

1. Do not run `git add .`. Stage files in logical groups by purpose.
2. Group into separate commits: feat → test → docs → refactor → chore.
3. Write concise commit messages that match the change scope.
4. Keep each commit focused and reviewable.

Verwenden Sie Skills für:

• Wiederholbare Arbeitsabläufe (Release-Schritte, Review-Routinen, Dokumentationsaktualisierungen)
• Teamspezifisches Fachwissen
• Verfahren, die Beispiele, Referenzen oder Hilfsskripte benötigen

Skills können global (in Ihrem Benutzerverzeichnis, für Sie als Entwickler) oder Repository-spezifisch (in .agents/skills eingecheckt, für Ihr Team) sein. Legen Sie Repository-Skills in .agents/skills ab, wenn der Arbeitsablauf für dieses Projekt gilt; verwenden Sie Ihr Benutzerverzeichnis für Skills, die Sie Repository-übergreifend einsetzen möchten.

Codex verwendet für Skills eine schrittweise Offenlegung:

• Es beginnt zur Erkennung mit Metadaten (name, description)
• Es lädt SKILL.md nur, wenn ein Skill ausgewählt wurde
• Es liest Referenzen oder führt Skripte nur bei Bedarf aus

Skills können ausdrücklich aufgerufen werden. Codex kann sie außerdem selbstständig auswählen, wenn die Aufgabe zur Skill-Beschreibung passt. Klare Skill-Beschreibungen erhöhen die Zuverlässigkeit der Auslösung.

Skills erstellen

MCP

MCP (Model Context Protocol) ist die Standardmethode, um Codex mit externen Tools und Kontextanbietern zu verbinden. Es ist besonders nützlich für extern gehostete Systeme wie Figma, Linear, GitHub oder interne Wissensdienste, auf die Ihr Team angewiesen ist.

Verwenden Sie MCP, wenn Codex Funktionen benötigt, die außerhalb des lokalen Repositorys verfügbar sind, etwa Issue-Tracker, Design-Tools, Browser oder gemeinsam genutzte Dokumentationssysteme.

Eine mögliche Betrachtungsweise:

• Host: Codex
• Client: die MCP-Verbindung innerhalb von Codex
• Server: das externe Tool oder der Kontextanbieter

MCP-Server können Folgendes bereitstellen:

• Tools (Aktionen)
• Ressourcen (lesbare Daten)
• Prompts (wiederverwendbare Prompt-Vorlagen)

Diese Trennung erleichtert es Ihnen, Vertrauens- und Funktionsgrenzen nachzuvollziehen. Einige Server stellen hauptsächlich Kontext bereit, während andere leistungsstarke Aktionen ermöglichen.

In der Praxis ist MCP häufig am nützlichsten, wenn es mit Skills kombiniert wird:

• Ein Skill definiert den Arbeitsablauf und benennt die zu verwendenden MCP-Tools

Model Context Protocol

Subagenten

Sie können verschiedene Agenten mit unterschiedlichen Rollen erstellen und sie anweisen, Tools unterschiedlich einzusetzen. Beispielsweise könnte ein Agent bestimmte Testbefehle und Konfigurationen ausführen, während ein anderer über MCP-Server verfügt, die Produktionsprotokolle zur Fehlerbehebung abrufen. Jeder Subagent bleibt auf seine Aufgabe fokussiert und verwendet die dafür geeigneten Tools.

Subagenten

Skills und MCP gemeinsam verwenden

Durch die Kombination von Skills und MCP fügt sich alles zusammen: Skills definieren wiederholbare Arbeitsabläufe, und MCP verbindet sie mit externen Tools und Systemen. Wenn ein Skill von MCP abhängt, deklarieren Sie diese Abhängigkeit in agents/openai.yaml, damit Codex sie automatisch installieren und einbinden kann (siehe Skills erstellen).

Nächster Schritt

Gehen Sie in dieser Reihenfolge vor:

1. Richten Sie benutzerdefinierte Anweisungen mit AGENTS.md ein, damit Codex die Konventionen Ihres Repositorys befolgt. Fügen Sie Pre-Commit-Hooks und Linter hinzu, um diese Regeln durchzusetzen.
2. Installieren Sie ein Plugin, wenn bereits ein wiederverwendbarer Arbeitsablauf verfügbar ist. Erstellen Sie andernfalls einen Skill und verpacken Sie ihn als Plugin, wenn Sie ihn weitergeben möchten.
3. Verwenden Sie MCP, wenn Arbeitsabläufe externe Systeme benötigen (Linear, GitHub, Dokumentationsserver, Design-Tools).
4. Verwenden Sie Subagenten, wenn Sie umfangreiche oder spezialisierte Aufgaben an Subagenten delegieren möchten.