Codex CLI

Codex CLI verbindet sich über Pathrule CLI oder die VS Code-Erweiterung mit deinem Pathrule-Workspace. Die Integration besteht aus drei Teilen: den nativen Hooks von Codex, einer begleitenden AGENTS.md im Stammverzeichnis des Workspace und denselben MCP-Tools, die auch die anderen Clients nutzen. Neben Claude Code ist Codex einer der beiden Clients, die Pathrule über einen Prompt-Submit-Hook erreicht.

Diese Seite zeigt, was für die Integration in dein Projekt geschrieben wird, worin sie sich von den Abläufen bei Claude Code und Cursor unterscheidet und wie du sie überprüfst.

Was Pathrule schreibt

Wenn du Pathrule in Codex CLI installierst, bekommst du:

• Einen MCP-Server-Eintrag in ~/.codex/config.toml, damit der Assistent pathrule_*-Tools aufrufen kann. Deine anderen Server in dieser Datei bleiben unverändert.
• .codex/hooks.json im Projekt. Die Hook-Registrierungen werden zusammengeführt, sodass selbst hinzugefügte Hooks erhalten bleiben.
• Einen markierten Block in der .codex/config.toml des Projekts, der die Hooks von Codex aktiviert. Der Rest der Datei gehört dir und bleibt unangetastet.
• AGENTS.md im Stammverzeichnis des Workspace. Bei installiertem Hook besteht der Pathrule-Anteil daran aus einem kurzen Hinweis, dass Pathrule aktiv ist und über den Hook ausgeliefert wird.
• Materialisierte Skills in .agents/skills/<name>/SKILL.md, damit Codex sie über ihren Namen aufrufen kann.

AGENTS.md ist für Codex das Gegenstück zu CLAUDE.md. Ist der Codex-Hook installiert, kommt das Protokoll über den SessionStart-Hook statt über die Datei, und das pfadbezogene Wissen kommt über die Prompt- und Tool-Hooks. Es werden also weder eine Kopie des Protokolls noch Wissensdateien in deinen Verzeichnisbaum geschrieben. Ohne Hook enthält AGENTS.md das vollständige Protokoll und die Workspace-Übersicht, und Pathrule legt in jedem Verzeichnis mit zugeordnetem Wissen eine eigene AGENTS.md an, die Codex lädt, sobald die Arbeit dieses Verzeichnis betrifft.

Hook-Abdeckung

Der Hook-Vertrag von Codex ähnelt dem von Claude Code. Pathrule registriert Hooks für Session-Start, Prompt-Submit, Pre-Tool, Post-Tool und Stop:

• Session-Start liefert einmal pro Session die Workspace-Metadaten, das Protokoll und deinen Team-Kontext.
• Prompt-Submit grenzt den Turn mit den Regeln und Memories ein, die zum Prompt passen, die stärksten Memories im vollen Wortlaut.
• Pre-Tool ergänzt die Namen dessen, was für den Pfad gilt, den der Patch oder Befehl berührt, und prüft Regeln mit einem freigegebenen Blockiermuster, bevor ein Patch angewendet wird.
• Post-Tool hält das Ergebnis fest.
• Stop erlaubt einer freigegebenen Pflichtprüfung, den Turn offenzuhalten, bis ihr Befehl erfolgreich durchgelaufen ist.

Die wesentlichen Unterschiede zu Claude Code liegen bei den Tools: Codex nutzt sein apply_patch-Format (mit *** Update File:-Markern) statt getrennter Edit- und Write-Tools, und es gibt keinen Read-Hook. Das gemeinsame Hook-Skript von Pathrule versteht apply_patch, ordnet die betroffenen Pfade wieder den Knoten im Workspace zu und behandelt einen Patch als Bearbeitung. Eine Regel mit freigegebenem Blockiermuster stoppt einen passenden Patch daher, bevor er angewendet wird. Ein von einem Assistenten vorgeschlagenes Blockiermuster wird erst durchgesetzt, wenn eine Person es freigegeben hat.

Die eigentliche Arbeit steckt in der Inhaltsschicht, nicht im Client. Dieselben Memories, Regeln und Skills bedienen daher Codex und jeden anderen Client.

Isolation pro Client

Codex läuft auf demselben Rechner problemlos neben Claude Code und Cursor. Du kannst einen, zwei oder alle drei installieren. Sie teilen sich denselben Pathrule-Workspace, denselben MCP-Server und denselben Inhaltsbaum. Die Konfigurationen, die jeder Client liest, sind voneinander unabhängig.

Installation

Über Pathrule CLI:

pathrule setup

Führe den Befehl im Projektordner aus und wähle Codex, wenn nach deinen KI-Tools gefragt wird. Setup meldet dich bei Bedarf bei Pathrule Cloud an, verknüpft den Ordner mit einem Workspace, installiert den MCP-Eintrag, merkt sich deine Auswahl für diesen Ordner und schreibt die Codex-Dateien. Mit pathrule setup --local nutzt du Pathrule stattdessen ohne Konto; das Wissen bleibt dann auf diesem Rechner.

So richtest du die einzelnen Teile in einem bereits verknüpften Ordner von Hand ein:

pathrule install codex
pathrule sync
pathrule doctor

pathrule install codex ergänzt den MCP-Eintrag in ~/.codex/config.toml. pathrule sync installiert das Hook-Skript und schreibt die Projektdateien für die KI-Tools, die für diesen Ordner gewählt wurden, oder, falls keine gewählt wurden, für die im Ordner erkannten.

In der VS Code-Erweiterung wählst du Codex unter Connect AI Clients. Die Erweiterung schreibt über ihre mitgelieferte CLI denselben MCP-Eintrag und dieselbe Hook-Konfiguration.

Remote MCP

Codex kann sich auch ohne lokale Installation mit dem gehosteten Endpunkt verbinden:

codex mcp add pathrule --url https://cloud.pathrule.io/mcp

Schließe danach die OAuth-Anmeldung mit deinem Pathrule-Konto ab. Über Remote MCP bekommt Codex ausschließlich die MCP-Tools: Es werden keine Hooks installiert, keine lokalen Dateien geschrieben, und es gibt keinen lokalen Modus. Siehe Pathrule Remote MCP.

Überprüfen

Öffne Codex CLI in einem Verzeichnis, das du mit einem Workspace verknüpft hast. Die Pathrule-Session-Metadaten sollten beim Session-Start ankommen, und der Assistent sollte pathrule_get_context für dein Arbeitsverzeichnis aufrufen können.

Schick einen einfachen Prompt, der einen Pfad mit Inhalten berührt. Die passenden Regeln und Memories sollten mit dem Prompt ankommen, und über MCP kann der Assistent tiefer einsteigen. Kommt nichts an, führe Folgendes aus:

pathrule doctor

Der Doctor liest nur. Er meldet deine Anmeldung, deinen Workspace und ob dieser Ordner verknüpft ist, ob der Pathrule-MCP-Eintrag für Codex und jeden anderen Client installiert ist und welche von Pathrule verwalteten Dateien im Ordner liegen und wer sie geschrieben hat. Mit --json erhältst du den vollständigen Bericht, der außerdem einen MCP-Eintrag markiert, der auf eine nicht mehr vorhandene Runtime zeigt. pathrule repair schreibt einen veralteten Eintrag neu, installiert Hook-Skript und Hook-Konfiguration erneut, synchronisiert AGENTS.md neu und führt den Doctor noch einmal aus.

Was gleich bleibt

Die Inhaltsschicht ist für alle Clients identisch.

• Dieselbe Memory, die Claude Code über den Hook erreicht, erreicht Codex über dessen eigene Hooks und die MCP-Tools.
• Eine Regel mit freigegebenem Blockiermuster blockiert bei Codex einen passenden Patch genauso wie bei Claude Code eine Bearbeitung.
• Ein Skill lässt sich über seinen Namen aufrufen.

Was dein Team für einen Assistenten schreibt, bekommt jeder Assistent.

Weiterlesen

• Claude Code für die verwandte Integration mit nativen Hooks.
• Cursor für die Cursor-Integration.
• MCP-Tools-Referenz für alle Tools, die Codex aufrufen kann.