Codex CLI

Codex CLI si collega al tuo workspace Pathrule tramite Pathrule CLI o l'estensione per VS Code. L'integrazione è composta da tre parti: gli hook nativi di Codex, un file AGENTS.md di accompagnamento nella radice del workspace e gli stessi strumenti MCP usati dagli altri client. Insieme a Claude Code, Codex è uno dei due client che Pathrule raggiunge con un hook all'invio del prompt.

In questa pagina trovi cosa viene scritto nel tuo progetto per l'integrazione, in cosa si differenzia dai flussi di Claude Code e Cursor e come verificarla.

Cosa scrive Pathrule

Quando installi Pathrule in Codex CLI, ottieni:

• Una voce del server MCP in ~/.codex/config.toml, così l'assistente può chiamare gli strumenti pathrule_*. Gli altri server presenti nel file restano come sono.
• .codex/hooks.json nel progetto. Contiene le registrazioni degli hook, unite in modo da conservare gli hook che hai aggiunto tu.
• Un blocco contrassegnato nel file .codex/config.toml del progetto che attiva gli hook di Codex. Il resto del file è tuo e non viene toccato.
• AGENTS.md nella radice del workspace. Con l'hook installato, la parte di Pathrule è una breve nota che indica che Pathrule è attivo e viene fornito dall'hook.
• Skill materializzate in .agents/skills/<name>/SKILL.md, così Codex può richiamarle per nome.

AGENTS.md è per Codex l'equivalente di CLAUDE.md. Quando l'hook di Codex è installato, il protocollo viaggia con l'hook SessionStart anziché nel file, e la conoscenza legata ai percorsi arriva tramite gli hook del prompt e degli strumenti, quindi nel tuo albero non viene scritta alcuna copia del protocollo né file di conoscenza. Senza l'hook, AGENTS.md contiene il protocollo completo e la panoramica del workspace, e Pathrule aggiunge un AGENTS.md in ogni directory a cui è associata della conoscenza, che Codex carica quando il lavoro entra in quella directory.

Copertura degli hook

Il contratto degli hook di Codex è simile a quello di Claude Code. Pathrule registra hook di avvio sessione, invio del prompt, pre-tool, post-tool e arresto:

• Avvio sessione fornisce i metadati del workspace, il protocollo e il contesto del tuo team una volta per sessione.
• Invio del prompt delimita il turno con le regole e le memorie pertinenti al prompt, con le memorie più rilevanti in versione completa.
• Pre-strumento aggiunge i nomi di ciò che si applica al percorso toccato dalla patch o dal comando, e verifica le regole con un pattern di blocco approvato prima che la patch venga applicata.
• Post-strumento registra l'esito.
• Arresto permette a un controllo obbligatorio approvato di tenere aperto il turno finché il suo comando non è andato a buon fine.

Le differenze principali rispetto a Claude Code riguardano gli strumenti: Codex usa il suo formato apply_patch (con marcatori *** Update File:) invece di strumenti Edit e Write separati, e non esiste un hook Read. Lo script di hook condiviso di Pathrule comprende apply_patch, risolve i percorsi interessati nei nodi del workspace e tratta una patch come una modifica, quindi una regola con un pattern di blocco approvato ferma una patch corrispondente prima che venga applicata. Un pattern di blocco proposto da un assistente non viene applicato finché una persona non l'ha approvato.

L'investimento sta nel livello dei contenuti, non nel client, quindi le stesse memorie, regole e skill servono Codex e ogni altro client.

Isolamento per client

Codex convive con Claude Code e Cursor sulla stessa macchina. Puoi installarne uno, due o tutti e tre. Condividono lo stesso workspace Pathrule, lo stesso server MCP e lo stesso albero dei contenuti. Le configurazioni lette da ciascun client sono indipendenti.

Installazione

Tramite Pathrule CLI:

pathrule setup

Eseguilo nella cartella del progetto e scegli Codex quando ti chiede quali strumenti di IA usi. Il setup ti fa accedere a Pathrule Cloud se necessario, collega la cartella a un workspace, installa la voce MCP, memorizza la tua scelta per questa cartella e scrive i file di Codex. Esegui invece pathrule setup --local per usare Pathrule senza account; in quel caso la conoscenza resta su questa macchina.

Per collegare i singoli pezzi a mano in una cartella già collegata:

pathrule install codex
pathrule sync
pathrule doctor

pathrule install codex aggiunge la voce MCP a ~/.codex/config.toml. pathrule sync installa lo script di hook e scrive i file di progetto per gli strumenti di IA scelti per questa cartella oppure, se non ne è stato scelto nessuno, per quelli che rileva nella cartella.

Tramite l'estensione per VS Code, scegli Codex in Connect AI Clients. L'estensione scrive la stessa voce MCP e la stessa configurazione degli hook tramite la CLI inclusa.

Remote MCP

Codex può collegarsi anche all'endpoint ospitato, senza alcuna installazione locale:

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

Poi completa l'accesso OAuth con il tuo account Pathrule. Remote MCP fornisce a Codex solo gli strumenti MCP: non installa hook, non scrive file locali e non ha una modalità locale. Consulta Pathrule Remote MCP.

Verifica

Apri Codex CLI in una directory che hai collegato a un workspace. I metadati di sessione di Pathrule dovrebbero arrivare all'avvio della sessione, e l'assistente dovrebbe poter chiamare pathrule_get_context sulla tua directory di lavoro.

Esegui un prompt semplice che tocchi un percorso con dei contenuti. Le regole e le memorie pertinenti dovrebbero arrivare insieme al prompt, e l'assistente può approfondire tramite MCP. Se non arriva nulla, esegui:

pathrule doctor

Il doctor è in sola lettura. Riporta il tuo accesso, il workspace e se questa cartella è collegata, se la voce MCP di Pathrule è installata per Codex e per ciascun altro client, e quali file gestiti da Pathrule si trovano nella cartella e chi li ha scritti. Aggiungi --json per il report completo, che segnala anche una voce MCP che punta a un runtime non più esistente. pathrule repair riscrive una voce obsoleta, reinstalla lo script di hook e la configurazione degli hook, risincronizza AGENTS.md ed esegue di nuovo il doctor.

Cosa resta uguale

Il livello dei contenuti è identico per tutti i client.

• La stessa memoria che arriva a Claude Code tramite l'hook arriva a Codex tramite i suoi hook e gli strumenti MCP.
• Una regola con un pattern di blocco approvato blocca una patch corrispondente su Codex esattamente come blocca una modifica su Claude Code.
• Una skill si può richiamare per nome.

Se il tuo team scrive contenuti per un assistente, li ricevono tutti gli assistenti.

Cosa leggere dopo

• Claude Code per l'integrazione gemella con hook nativi.
• Cursor per l'integrazione con Cursor.
• Riferimento degli strumenti MCP per tutti gli strumenti che Codex può chiamare.