Du kannst Codex an die Arbeitsweise deines Teams anpassen.
Dafür greifen in Codex mehrere Ebenen ineinander:
- Projektanweisungen (
AGENTS.md) für Regeln, die dauerhaft gelten - Erinnerungen für nützlichen Kontext aus früheren Aufgaben
- Skills für wiederverwendbare Arbeitsabläufe und Fachwissen
- MCP für den Zugriff auf externe Tools und gemeinsam genutzte Systeme
- Subagenten, an die du je nach Spezialisierung Aufgaben delegieren kannst
Die Ebenen ergänzen sich. AGENTS.md gibt vor, wie Codex vorgeht. Erinnerungen bewahren lokalen Kontext für spätere Aufgaben. Skills bündeln wiederkehrende Abläufe, und MCP verbindet Codex mit Systemen außerhalb deines lokalen Workspace.
Projektanweisungen mit AGENTS.md
AGENTS.md gehört zu deinem Repository und gibt Codex dauerhafte Projektanweisungen, die schon gelten, bevor der Agent mit der Arbeit beginnt. Halte die Datei kurz.
Lege darin fest, welche Regeln Codex bei jeder Aufgabe im Repository befolgen soll. Dazu gehören zum Beispiel:
- Build- und Testbefehle
- Erwartungen an Reviews
- Konventionen des Repositorys
- Anweisungen für einzelne Verzeichnisse
Wenn der Agent von falschen Annahmen über deine Codebasis ausgeht, stelle den Sachverhalt in AGENTS.md klar. Bitte den Agenten bei jeder solchen Korrektur, AGENTS.md zu aktualisieren. So fließt dein Feedback dauerhaft in die Projektanweisungen ein.
So aktualisierst du AGENTS.md: Beginne mit den wichtigsten Anweisungen. Formuliere wiederkehrende Review-Kommentare als Regeln und lege jede Anweisung möglichst nah an den Dateien ab, für die sie gilt. Wenn du etwas korrigierst, bitte den Agenten, AGENTS.md zu aktualisieren. So gilt die Korrektur auch in künftigen Sitzungen.
Wann du AGENTS.md aktualisieren solltest
- Wiederholte Fehler: Wenn der Agent denselben Fehler mehrfach macht, ergänze eine Regel.
- Zu viele gelesene Dokumente: Wenn der Agent die richtigen Dateien findet, aber zu viele Dokumente liest, gib an, welche Verzeichnisse oder Dateien er zuerst lesen soll.
- Wiederkehrendes Feedback zu Pull Requests: Wenn du denselben Hinweis mehrmals gibst, halte ihn als Regel fest.
- Projektanweisungen automatisch prüfen: Richte geplante Aufgaben ein, die regelmäßig (zum Beispiel täglich) nach Lücken in den Anweisungen suchen und Ergänzungen für
AGENTS.mdvorschlagen.
Ergänze AGENTS.md durch Tools, die diese Regeln durchsetzen. Pre-Commit-Hooks, Linter und Typprüfer erkennen Probleme, bevor du sie bemerkst. So lassen sich wiederkehrende Fehler mit der Zeit besser verhindern.
Codex kann Anweisungen aus mehreren Quellen laden: aus einer globalen Datei in deinem Codex-Home-Verzeichnis für deine eigene Entwicklungsarbeit und aus Dateien, die dein Team im jeweiligen Repository einchecken kann. Dateien, die näher am Arbeitsverzeichnis liegen, haben Vorrang. Lege in der globalen Datei fest, wie Codex mit dir kommuniziert, etwa wie es Reviews formuliert, wie ausführlich es antwortet und welche Standardeinstellungen gelten. Beschränke die Dateien im Repository auf Regeln für das Team und die Codebasis.
-
~/.codex/
- AGENTS.md Global (für deine eigene Entwicklungsarbeit)
-
-
repo-root/
- AGENTS.md Für dieses Repository (für dein Team)
-
Eigene Anweisungen mit AGENTS.md
Skills
Mit Skills erhält Codex Funktionen, die es für wiederkehrende Arbeitsabläufe nutzen kann. Skills eignen sich dafür oft am besten: Sie können ausführliche Anweisungen, Skripte und Referenzmaterial enthalten und lassen sich für unterschiedliche Aufgaben einsetzen. Codex lädt mindestens die Metadaten der Skills. Der Agent kann passende Skills dadurch selbst finden und auswählen. So stehen auch umfangreiche Arbeitsabläufe zur Verfügung, ohne dass Codex gleich zu Beginn alle Details in den Kontext laden muss.
In Skill-Ordnern kannst du Arbeitsabläufe lokal erstellen und weiterentwickeln. Gibt es für einen Ablauf bereits ein Plugin, installiere es zuerst. So kannst du ein bewährtes Setup übernehmen. Wenn du deinen eigenen Ablauf mehreren Teams zur Verfügung stellen oder mit Konnektoren bündeln möchtest, verpacke ihn als Plugin. Den Ablauf beschreibst du weiterhin als Skill. Das Plugin ist das Paket, das andere installieren können.
Ein Skill besteht in der Regel aus einer Datei namens SKILL.md. Optional kommen Skripte, Referenzmaterial und weitere Ressourcen hinzu.
-
my-skill/
- SKILL.md Erforderlich: Anweisungen und Metadaten
- scripts/ Optional: ausführbarer Code
- references/ Optional: Dokumentation
- assets/ Optional: Vorlagen und Ressourcen
-
Das Skill-Verzeichnis kann einen Ordner namens scripts/ mit CLI-Skripten enthalten. Codex ruft sie im jeweiligen Arbeitsablauf auf, etwa um Ausgangsdaten einzuspielen oder Prüfungen auszuführen. Wenn der Ablauf externe Systeme wie Issue-Tracker, Designtools oder Dokumentationsserver benötigt, kombiniere 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. Führe `git add .` nicht aus. Merke Dateien, die demselben Zweck dienen, gemeinsam für einen Commit vor.
2. Teile die Änderungen in separate Commits auf: feat → test → docs → refactor → chore.
3. Beschreibe in jeder Commit-Nachricht knapp, welche Änderungen der Commit umfasst.
4. Beschränke jeden Commit auf einen Zweck, damit er sich leicht überprüfen lässt.
Nutze Skills für:
- Wiederkehrende Arbeitsabläufe (Release-Schritte, regelmäßige Reviews, Aktualisierungen der Dokumentation)
- Fachwissen deines Teams
- Verfahren, die Beispiele, Referenzmaterial oder Hilfsskripte erfordern
Skills können global für deine eigene Entwicklungsarbeit in deinem Benutzerverzeichnis liegen oder für dein Team unter .agents/skills im Repository eingecheckt sein. Lege Skills in .agents/skills ab, wenn der Ablauf für dieses Projekt gilt. Nutze dein Benutzerverzeichnis für Skills, die dir in allen Repositorys zur Verfügung stehen sollen.
| Ebene | Global | Repository |
|---|---|---|
| AGENTS | ~/.codex/AGENTS.md |
AGENTS.md im Stammverzeichnis des Repositorys oder in Unterverzeichnissen |
| Skills | ~/.agents/skills |
.agents/skills im Repository |
Codex lädt die Inhalte von Skills schrittweise:
- Zuerst nutzt Codex die Metadaten (
name,description), um passende Skills zu finden. - Erst wenn ein Skill ausgewählt ist, lädt Codex
SKILL.md. - Codex liest Referenzmaterial und führt Skripte nur bei Bedarf aus.
Du kannst Skills ausdrücklich aufrufen. Codex kann einen Skill auch selbst auswählen, wenn die Aufgabe zu seiner Beschreibung passt. Je klarer die Beschreibung ist, desto zuverlässiger erkennt Codex, wann es den Skill einsetzen soll.
MCP
MCP (Model Context Protocol) ist der Standard, um Codex mit externen Tools und Kontextquellen zu verbinden. Es eignet sich besonders für extern gehostete Systeme wie Figma, Linear oder GitHub sowie für interne Wissensdienste, auf die dein Team angewiesen ist.
Nutze MCP, wenn Codex Funktionen außerhalb des lokalen Repositorys benötigt, etwa Zugriff auf Issue-Tracker, Designtools, Browser oder gemeinsam genutzte Dokumentationssysteme.
Die Rollen kannst du dir so vorstellen:
- Host: Codex
- Client: die MCP-Verbindung innerhalb von Codex
- Server: das externe Tool oder die externe Kontextquelle
MCP-Server können Folgendes bereitstellen:
- Tools (Aktionen)
- Ressourcen (lesbare Daten)
- Prompts (wiederverwendbare Prompt-Vorlagen)
Anhand dieser Unterscheidung kannst du einschätzen, welchen Systemen du vertrauen musst und welche Aktionen sie ermöglichen. Manche Server liefern vor allem Kontext, andere ermöglichen weitreichende Eingriffe.
In der Praxis ist MCP oft in Kombination mit Skills am nützlichsten:
- Ein Skill legt den Ablauf fest und gibt an, welche MCP-Tools Codex verwenden soll.
Subagenten
Du kannst Agenten mit unterschiedlichen Rollen erstellen und ihnen vorgeben, wie sie ihre Tools einsetzen sollen. Ein Agent kann beispielsweise Tests mit bestimmten Befehlen und Konfigurationen ausführen. Ein anderer hat Zugriff auf MCP-Server, die zur Fehlersuche Protokolle aus dem Produktivbetrieb abrufen. Jeder Subagent konzentriert sich auf seine Aufgabe und nutzt die passenden Tools dafür.
Skills und MCP kombinieren
Skills definieren wiederkehrende Arbeitsabläufe. MCP verbindet diese Abläufe mit externen Tools und Systemen.
Wenn ein Skill MCP benötigt, gib diese Abhängigkeit in agents/openai.yaml an. So kann Codex sie automatisch installieren und anbinden (siehe Skills erstellen).
Nächster Schritt
Gehe in dieser Reihenfolge vor:
- Lege eigene Anweisungen mit AGENTS.md fest, damit Codex die Konventionen deines Repositorys einhält. Ergänze Pre-Commit-Hooks und Linter, die diese Regeln durchsetzen.
- Installiere ein Plugin, wenn es bereits einen wiederverwendbaren Ablauf gibt. Erstelle andernfalls einen Skill und verpacke ihn als Plugin, wenn du ihn teilen möchtest.
- Nutze MCP, wenn deine Abläufe externe Systeme benötigen (Linear, GitHub, Dokumentationsserver, Designtools).
- Setze Subagenten ein, sobald du Aufgaben mit vielen Zwischenausgaben oder spezialisierte Aufgaben delegieren möchtest.