Come padroneggiare Codex nel 2026 (Corso per sviluppatori)

Ho usato Claude Code per 12 mesi. Poi sono passato a Codex per 30 giorni.

Ecco cosa ho scoperto

Cos'è realmente Codex nel 2026

Molti pensano ancora che Codex sia un semplice autocompletamento intelligente. Non lo è.

Codex è una piattaforma completa per lo sviluppo software agentico. Legge il tuo codebase, scrive e testa codice, revisiona le pull request, controlla il tuo Mac desktop, naviga sul web, genera immagini, pianifica attività ricorrenti e ricorda le tue preferenze tra una sessione e l'altra.
Il cambio di mentalità richiesto è significativo. Smetti di essere la persona che scrive codice. Diventi la persona che revisiona il codice scritto da un team di sviluppatori junior che non dorme mai.

La maggior parte degli sviluppatori installa Codex, invia prompt brevi per due settimane, ottiene risultati mediocri e si arrende. Non configurano mai AGENTS.md.

Non scrivono mai una Skill. Non usano mai sub-agenti. Usano il 5% della superficie e giudicano lo strumento su quel 5%.

Questo corso copre l'altro 95%.

Le cinque superfici

Prima di installare qualsiasi cosa, capisci dove vive Codex. La superficie che scegli determina quanto da vicino segui il suo lavoro e dove viene eseguito il codice.

CLI è per flussi di lavoro scriptati, attività singole e automazione headless. Il tuo codice non lascia mai la tua macchina a meno che tu non lo invii. Open source, costruito in Rust, funziona su macOS, Windows e Linux.

Estensione IDE è per modifiche interattive con contesto di file preciso. Si installa in VS Code, Cursor, Windsurf o JetBrains. Usa la tua autenticazione CLI senza un login separato.

App desktop è la casa dei flussi di lavoro multi-thread, del browser integrato, di Computer Use, della modalità Goal, degli Appshot e delle Automazioni. Lanciata su macOS a febbraio 2026 e su Windows il 4 marzo 2026.

Cloud è per attività asincrone in background, PR parallele e lavoro mentre dormi. Le attività vengono eseguite in container sandbox pre-caricati con il tuo repo GitHub. Niente blocca la tua macchina locale.

Browser integrato e Computer Use è per la verifica UI, iterazione frontend e test end-to-end. Codex apre il tuo server di sviluppo locale, interagisce con esso, cattura screenshot del risultato e verifica che le modifiche al codice abbiano prodotto l'output visivo corretto.

Un flusso di lavoro reale utilizza più superfici:

CLI per attività scriptate
IDE per lavoro interattivo sulle funzionalità
Cloud per attività parallele che non devi monitorare
App per attività guidate da obiettivi e a lunga esecuzione

Il fattore principale nella scelta di una superficie è quanto da vicino vuoi seguire il lavoro dell'agente. Se vuoi monitorare le modifiche mentre vengono apportate, CLI o IDE mantengono il lavoro sulla tua macchina e davanti a te. Se preferisci delegare una sessione più lunga e revisionare alla fine, Cloud è la scelta giusta.

Il modello mentale: Agente, non autocompletamento

Con le superfici chiare, il prossimo cambiamento è capire l'unità di lavoro.

L'unità di lavoro è un'attività, non un turno. L'output è una PR, non una risposta in chat.

Pensa meno "scrivi una funzione che faccia X" e più "implementa la funzionalità Y, ecco i vincoli, esegui i test quando hai finito".

Ogni attività di Codex segue lo stesso ciclo interno. Codex legge la tua attività e il contesto, produce un piano interno, esegue passo dopo passo e verifica il proprio lavoro.

Smetti di pensare a Codex come a un assistente di programmazione. Inizia a pensarlo come a un team di sviluppatori junior che istruisci al mattino e revisioni al pomeriggio.

Un esempio reale di questo in pratica: gli sviluppatori di WorkOS ora mettono in coda quattro o cinque attività di Codex prima di prendere il caffè del mattino. Quando tornano a sedersi, trovano due o tre PR completate in attesa di revisione, gestendo il lavoro di manutenzione che un tempo consumava dal 30 al 40 percento della loro giornata.

I modelli attuali a partire da maggio 2026:

GPT-5.5 (predefinito) — gestisce la maggior parte delle attività, stessa latenza di prima ma significativamente meno token per lo stesso lavoro
GPT-5.3-Codex — progettato appositamente per esecuzioni autonome lunghe, grandi refactoring e fan-out parallelo sul cloud; 25% più veloce del precedente specialista Codex
GPT-5.5 Pro — ragionamento più elevato; solo piani Pro, Business ed Enterprise
Codex Mini — permanentemente gratuito su ChatGPT Free; adatto per imparare

Lascia Codex su GPT-5.5 per impostazione predefinita. Passa a GPT-5.3-Codex per grandi attività agentiche in cui Codex funziona in autonomia per molto tempo.

Per iniziare: La tua prima sessione reale

Il percorso più veloce per una sessione funzionante di Codex segue cinque passaggi. Dimentica il tutorial fizzbuzz. Inizia su un codebase reale.

Passaggio 1: Installa la CLI.

Passaggio 2: Apri un progetto reale.

Naviga in un repository a basso rischio che già conosci. Questo è importante.

Codex funziona meglio quando riesci a riconoscere l'output e a cogliere gli errori. Lavorare su un codebase sconosciuto nella prima sessione produce risultati imprevedibili.

Accedi con il tuo account ChatGPT quando richiesto. Il tuo browser si apre automaticamente. Fai clic su Continua e torna al terminale.

Passaggio 3: Esegui `/init` prima di fare qualsiasi altra cosa.

Questo singolo comando è ciò che la maggior parte dei tutorial salta. Codex esegue una scansione della tua directory e della cronologia Git, identifica linguaggi, framework, comandi di build e comandi di test, e crea un file AGENTS.md popolato con ciò che trova.

Revisiona il file generato, modifica eventuali errori e fai il commit. Ogni futura sessione di Codex su questo progetto lo leggerà automaticamente.

Passaggio 4: Dai a Codex un'attività di orientamento.

Chiedigli di spiegare il codebase prima di dargli qualcosa da modificare. Questo aumenta la tua fiducia nel contesto che ha caricato:

Leggi l'output. Se descrive accuratamente il tuo codebase reale, ha il contesto necessario. Se è vago o errato, il tuo AGENTS.md ha bisogno di più dettagli.

Passaggio 5: Dagli un piccolo compito reale. Scegli qualcosa di concreto e delimitato.

Questa è la forma corretta di un prompt per Codex: contesto di file specifico, risultato atteso, vincoli e un passaggio di verifica definito. Revisiona il diff che restituisce. Ora stai usando Codex correttamente.

Passaggio 6: Installa l'app desktop. Scarica dal sito web di OpenAI. Accedi con lo stesso account ChatGPT.

Passaggio 7: Installa l'estensione IDE. Cerca "OpenAI Codex" nel pannello delle estensioni del tuo editor. Legge automaticamente la tua autenticazione CLI.

Passaggio 8: Connetti GitHub. Vai su Impostazioni all'interno dell'app Codex e connetti il tuo account GitHub. Collega almeno un repository prima di usare le attività cloud.

Dove si trovano le cose:

~/.codex/config.toml : configurazione principale: modalità di approvazione, modalità sandbox, server MCP, modelli predefiniti
~/.codex/AGENTS.md : AGENTS.md personale, si applica a tutti i progetti
<progetto>/AGENTS.md : istruzioni a livello di progetto
<progetto>/.agents/skills/ : Skill a livello di progetto
<progetto>/.codex/config.toml : configurazione con ambito di progetto (solo progetti fidati)

AGENTS.md: Il file più importante del tuo repo

Ora che hai una sessione funzionante, il passo successivo è fare in modo che ogni sessione futura inizi con la stessa qualità. Ecco cosa fa AGENTS.md.

AGENTS.md è il singolo file che separa output mediocri di Codex da output costanti e di alta qualità.
È un semplice file Markdown nella radice del tuo repo. Ogni volta che una sessione di Codex inizia sul tuo progetto, l'agente lo legge automaticamente prima di fare qualsiasi altra cosa.
È uno standard aperto. Codex, Cursor, Gemini CLI, Windsurf e GitHub Copilot lo leggono tutti. Scrivilo una volta e ogni agente nella tua toolchain legge la stessa fonte di verità.

Ordine di risoluzione: Codex legge ~/.codex/AGENTS.md (livello home, tutti i progetti) più <progetto>/AGENTS.md (livello progetto). I file AGENTS.override.md hanno priorità a ciascun livello. Il limite combinato è 32 KiB.

Cosa includere:

Stack, framework, versioni dei linguaggi, gestore di pacchetti
Comandi esatti di build, test e sviluppo; copiabili, non "esegui i soliti test"
Convenzioni sulla struttura dei file e regole di denominazione
Regole di stile e pattern
Zone vietate: cosa non toccare
Requisiti di pubblicazione: CI, convenzioni PR, meccanismo di deploy

Cosa non includere:

Segreti o credenziali (il file è in controllo versione)
Indicazioni vaghe ("scrivi codice pulito" non significa nulla per un agente)
Documentazione che duplica il tuo README

Mantienilo sotto le 500 parole. Il gonfiore spinge il contesto utile fuori dalla memoria di lavoro del modello.

Un template funzionante:

Verifica che Codex lo stia leggendo: chiedi riassumi le istruzioni correnti che hai caricato
Per grandi monorepo, posiziona file AGENTS.md aggiuntivi all'interno delle sottodirectory.
Un file in packages/api/AGENTS.md ha la precedenza sul file radice per le attività all'interno di quel pacchetto.
Esegui codex trust . per abilitare un .codex/config.toml a livello di progetto. Questo impedisce a un repo clonato dannoso di configurare Codex alle tue spalle.

La CLI in dettaglio

Con AGENTS.md configurato, la prossima cosa da padroneggiare è la CLI stessa. La maggior parte degli utenti scrive solo codex e perde i comandi che la rendono veramente potente.

Ci sono quattro comandi che coprono il 95% dell'uso quotidiano reale.

codex apre la modalità interattiva per esplorazione, iterazione e conversazione bidirezionale con il tuo codebase.

codex exec "<attività>" esegue Codex in modo non interattivo. Trasmette l'output su stdout e termina al completamento. Questo è lo strumento potente per tutto ciò che è scriptabile:

Collega exec a git hook, pipeline CI e cron job. È il mattone fondamentale per tutto ciò che è automatizzato.

codex resume --last riprende esattamente da dove avevi lasciato. Ogni sessione viene salvata:

codex cloud gestisce le attività asincrone sul cloud, trattate nella sezione Cloud più avanti.

Flag utili:

--json : flusso di eventi JSONL per il piping ad altri strumenti
--model <nome> : seleziona GPT-5.5 o GPT-5.3-Codex
--reasoning <livello> : basso, medio o alto
--search : consente la ricerca web durante l'attività
-C <dir> : esegui in una directory di lavoro diversa
--sandbox <modalità> : sovrascrive la modalità sandbox per questa sessione
--approval <politica> : sovrascrive la politica di approvazione per questa sessione

Sandbox e approvazioni

La CLI ti dà potere. La sandbox controlla quanto di quel potere Codex può esercitare senza chiedere. Impostarla correttamente mantiene il flusso di lavoro veloce senza creare rischi.

La sandbox è il confine che controlla cosa Codex può e non può fare. Impostarla correttamente previene sorprese.

Le tre modalità sandbox:

workspace-write (predefinita) : lettura e scrittura all'interno del workspace, comandi di routine, nessuna rete a meno che non sia consentita. Usala quasi sempre.
read-only : sola lettura, nessuna scrittura, nessuna shell. Usala per revisione del codice ed esplorazione.
danger-full-access : nessuna restrizione. Usala quasi mai. Riservata ad automazioni testate e verificate.

Le due politiche di approvazione:

untrusted — chiede prima di ogni comando non fidato. Usala quando stai imparando o in un progetto sconosciuto.
on-request (predefinita) — approva automaticamente i comandi sandbox di routine, chiede prima di qualsiasi cosa che rompa il confine della sandbox.

auto_review è un sub-agente revisore che approva o rifiuta automaticamente in base al tuo AGENTS.md.

Abilitalo con approvals_reviewer = "auto_review" in config. Funziona bene per attività asincrone lunghe e modalità Goal in cui non vuoi supervisionare ogni passo.

Aggiungi i comandi che ti chiedono costantemente approvazione. Non aggiungere mai nulla di distruttivo.

Come scrivere prompt efficaci per Codex

Sandbox configurata, sessioni in esecuzione. La prossima leva è la qualità del prompt, che ha un impatto maggiore sull'output di qualsiasi altra variabile.

La singola leva più grande sulla qualità dell'output di Codex è la struttura del prompt. Prompt vaghi producono codice vago.

Il framework: Spiega, Mostra, Descrivi, Ricorda.

Spiega il risultato che vuoi, non il metodo
Mostra input di esempio e output attesi
Descrivi le API, le librerie e i pattern da utilizzare
Ricorda le convenzioni da AGENTS.md

Non tutti e quattro sono necessari ogni volta. Una piccola correzione di bug potrebbe aver bisogno solo di Spiega e Ricorda. Una nuova funzionalità di solito vuole tutti e quattro.

La regola del singolo cambiamento: Codex funziona molto meglio su una cosa che su cinque. "Correggi il bug di autenticazione, aggiungi test, refactoring del repo utente e aggiorna il README" è un lancio di moneta. Lo stesso lavoro suddiviso in quattro prompt è affidabile.
Richiedi prima un piano per qualsiasi cosa non banale: "produci prima un piano, non scrivere codice finché non lo approvo". Trenta secondi a revisionare un piano battono trenta minuti a fare il debug di un'implementazione sbagliata.
Specifica esplicitamente il comportamento in caso di fallimento. Lasciato a se stesso, Codex farà passare i test con ogni mezzo necessario:

Limita il contesto esplicitamente. Nomina file specifici da leggere. "Non leggere o modificare nient'altro. Se hai bisogno di informazioni da altrove, chiedimi."

Livelli di sforzo di ragionamento:

Basso : modifiche banali, formattazione, refactoring semplici
Medio (predefinito) : la maggior parte del lavoro su funzionalità e correzioni di bug
Alto : decisioni architetturali, debug difficili, grandi refactoring multi-file

Modalità Goal

Una volta che i prompt per attività singole sembrano naturali, il livello successivo è dare a Codex un obiettivo plurigiornaliero e lasciare che sequenzi il lavoro da solo.

La modalità Goal è per lavori troppo grandi per essere istruiti attività per attività, ma abbastanza coerenti per un singolo obiettivo. È diventata stabile a maggio 2026.

Gestisci un Goal in esecuzione con questi comandi:

codex goal status : visualizza i Goal attivi e il loro progresso
codex goal logs <id> : ispeziona ciò che Codex ha fatto finora
codex goal pause <id> : interrompi l'esecuzione e attendi il tuo input
codex goal resume <id> : continua da dove si era interrotto
codex goal cancel <id> : ferma e cancella il Goal

Inizia con Goal delimitati. "Al massimo 5 PR" finché non ti fidi di come Codex interpreta i tuoi obiettivi. Un Goal fuori controllo che fa con sicurezza la cosa sbagliata è il peggior risultato possibile.

Limita sempre con: numero massimo di PR, numero massimo di righe di codice per PR, gate CI tra PR e condizioni di arresto chiare. Fai una pausa su qualsiasi decisione architetturale non coperta in AGENTS.md. Fai una pausa su qualsiasi modifica alle API che rompe la compatibilità.

Skill: Flussi di lavoro riutilizzabili

La modalità Goal gestisce le grandi iniziative. Le Skill gestiscono i micro-flussi di lavoro ricorrenti che compaiono in ogni progetto. Se ti ritrovi a ripetere le stesse istruzioni tra sessioni, questo è il segnale per scrivere una Skill.

Una Skill è un flusso di lavoro riutilizzabile impacchettato come directory: istruzioni in un file SKILL.md, più risorse e script opzionali.

Codex scopre le Skill per nome e descrizione. Carica le istruzioni complete solo quando un'attività attiva la Skill. Puoi avere 50 Skill con costo di contesto zero finché una non viene attivata.

Dove vivono le Skill:

Personale : $HOME/.agents/skills/ : trasversale ai progetti, riflette il tuo modo di lavorare indipendentemente dal repo
Team : .agents/skills/ all'interno del repo : specifiche del progetto, versionate, condivise con i collaboratori

Il formato `SKILL.md`:

Le tre Skill che ogni utente esperto dovrebbe scrivere per primo:

open-pr è il flusso di lavoro PR standard: controlla il branch, fai push, crea la PR con un corpo strutturato, applica etichette e richiedi revisione. La Skill più usata nel lavoro quotidiano.
new-feature legge il PRD e AGENTS.md, identifica i componenti esistenti da riutilizzare, produce un piano, attende l'approvazione, implementa, testa e apre una PR tramite la Skill open-pr. Se qualcosa nel PRD è ambiguo, chiede prima di generare codice.
investigate è la Skill diagnostica senza correzione. Conferma la riproduzione, legge i percorsi di codice pertinenti, forma un'ipotesi ("Credo che X accada perché Y") e produce l'ipotesi e un piano di validazione in Markdown. Non implementa una correzione. L'output è comprensione, non codice.

La Skill investigate è importante perché Codex salterà sempre l'analisi delle cause profonde se glielo permetti. Passerà direttamente a una correzione, e spesso quella correzione sarà sbagliata. Imporre prima investigate-first è il singolo miglioramento più grande per la qualità dell'output di debug.

Verifica che le tue Skill siano caricate: elenco delle skill disponibili

Sub-agenti e parallelismo

Le Skill gestiscono i tuoi flussi di lavoro ripetibili. I sub-agenti gestiscono quelli paralleli. La distinzione è importante perché il parallelismo fatto male crea più problemi di quanti ne risolva.

Un sub-agente è un'istanza agente separata e isolata. Viene eseguito nel proprio contesto, restituisce un riepilogo e il suo contesto viene scartato. È diverso da una Skill, che viene eseguita nel contesto dell'agente principale.

Tre pattern in cui i sub-agenti sono lo strumento giusto:

Esplorazione : lancia un sub-agente per leggere 30 file e riassumerli; la lettura avviene nel suo contesto, non nel tuo
Implementazione parallela : cinque funzionalità indipendenti come cinque sub-agenti concorrenti, ciascuno con il proprio contesto e piano
Verifica : un sub-agente revisore nuovo non è influenzato dall'aver appena scritto il codice

I sub-agenti personalizzati sono definiti in `.codex/agents/<nome>.md`:

L'indirizzamento dei sub-agenti è stato rilasciato a marzo 2026. Parla con un sub-agente in esecuzione usando il nickname con @<nickname>.
Utile quando molti sono in esecuzione in parallelo e vuoi reindirizzarne uno senza disturbare gli altri.
Il pattern fan-out: lancia N sub-agenti in parallelo su attività indipendenti e riunisci i risultati.
Cinque attività vengono completate nel tempo della più lenta. Regola pratica: se un'attività richiede meno di 30 secondi nel contesto principale, eseguila lì.

L'app desktop: Codex per tutto

Sub-agenti e Skill funzionano altrettanto bene su CLI, estensione IDE e app desktop. Ma l'app desktop è dove vivono le funzionalità che non hanno un equivalente CLI.

L'aggiornamento del 16 aprile 2026 "Codex for (almost) everything" ha trasformato l'app desktop da strumento di programmazione a una vera e propria workstation per sviluppatori.

Computer Use

Codex opera sul tuo Mac: clicca, digita, scorre, apre app, naviga nei menu e funziona al tuo fianco senza rubare il focus del cursore.

L'uso killer è la verifica comportamentale. I test unitari passano ma l'UI è ancora rotta.
Computer Use colma questo divario permettendo a Codex di aprire il server di sviluppo, cliccare attraverso il flusso pertinente e fare uno screenshot del risultato.
Per attivarlo, vai su Impostazioni Codex, Computer Use, Installa. Concedi le autorizzazioni per Registrazione schermo e Accessibilità quando macOS lo richiede. Invocalo da qualsiasi prompt:

Computer Use bloccato consente a Codex di continuare a operare sulle app desktop dopo che lo schermo è bloccato. Abilitalo in Impostazioni sotto Computer Use. Avvia un'attività prima di andare a letto, blocca la macchina, rivedi i risultati al mattino.

Appshot

Premi Comando-Comando e la finestra macOS più in primo piano va direttamente nel tuo thread di Codex.

Codex cattura lo screenshot, il testo visibile e il testo di accessibilità; spesso includendo contenuti scorr fuori schermo.

Senza Appshot: vedi un errore, passa a Codex, scrivi una domanda, fai uno screenshot, trascinalo, scrivi più contesto. Mezzo minuto di attrito.
Con Appshot: vedi l'errore, premi Comando-Comando, fai la tua domanda. Cinque secondi.

Se hai interagito con un thread di Codex negli ultimi 60 secondi, l'Appshot va in quella conversazione.

Altrimenti apre un nuovo thread. Più Appshot in una sessione si impilano in un thread. Richiede le autorizzazioni per Registrazione schermo e Accessibilità.

Il browser integrato

Il browser integrato è un browser nativo agentico, non un'anteprima di pagina. Apre il tuo server di sviluppo locale, clicca, compila moduli, ispeziona lo stato del DOM, cattura screenshot e verifica che la patch appena scritta abbia risolto il bug visivo.

Apri un server di sviluppo locale al suo interno, poi aggiungi commenti in linguaggio naturale direttamente sugli elementi renderizzati.
Scrivi "rendi questo pulsante 20 pixel più alto" sull'elemento, e Codex esegue la modifica nel tuo codebase e ricarica la pagina.
Il browser integrato fornisce accesso diretto al DOM senza sovraccarico di gestione delle finestre ed è sandbox rispetto al tuo browser reale.

Memoria

La memoria consente a Codex di mantenere il contesto tra le sessioni.

Dopo ogni sessione, Codex riassume l'interazione e la scrive in ~/.codex/memories/.
Alla sessione successiva, legge quei file prima di caricare il tuo prompt.
Codex impara il formato dei tuoi messaggi di commit preferiti, i framework di test, i pattern architetturali e gli errori commessi la volta precedente; senza che tu ripeta nessuno di quei contesti.
Abilitala in Impostazioni, o aggiungi memories = true sotto [features] in config.toml.

L'ecosistema di oltre 90 plugin

I plugin sono bundle curati di Skill, MCP e integrazioni. Installa con codex plugins install <nome>.

Principali categorie di plugin:

Project management : Linear, JIRA, GitHub
CI/CD : CircleCI, Vercel, GitHub Actions
Database : Neon, Postgres, PlanetScale
Qualità del codice : Sentry, CodeRabbit
Produttività : Notion, Remotion

Installa solo per gli strumenti che usi quotidianamente. Definisci l'ambito per progetto quando possibile. Esegui una revisione trimestrale. Ogni plugin costa token di contesto, che tu lo usi o no.

Codex Cloud: Lavoro asincrono su larga scala

L'app desktop alimenta il tuo lavoro locale e interattivo. Cloud è ciò a cui ricorri quando il lavoro è troppo grande per una singola sessione interattiva o quando vuoi che più attività vengano eseguite in parallelo mentre ti concentri su altro.

Codex Cloud è la funzionalità che trasforma Codex da un assistente di programmazione veloce in un team di sviluppatori junior che scala orizzontalmente.

Invia un'attività, Codex avvia una sandbox pre-caricata con il tuo repo, lavora, esegue test e apre una PR. Niente blocca la tua macchina locale.

Invio di una singola attività:

Attività parallele; il pattern principale:

Venti minuti dopo, quattro PR sono aperte. Revisiona, triage, unisci.

Fan-out CSV ti permette di inviare un file di attività e Codex le distribuisce come agenti cloud paralleli con monitoraggio del progresso:

codex cloud sfoglia le attività attive e completate. codex cloud apply <id-attività> recupera le modifiche localmente prima di unire.

Integrazione GitHub

Le attività cloud arrivano nel tuo repo come PR. L'integrazione GitHub determina come quelle PR vengono revisionate e come Codex si integra nella tua pipeline CI/CD esistente.

Codex e GitHub si integrano a tre livelli: ambienti repository, revisioni delle pull request e codex-action per CI/CD.

Gli ambienti repository sono la base. Collega un repository GitHub in Impostazioni Codex e le attività cloud cloneranno il repo, eseguiranno le attività in un contenitore sandbox e invieranno il risultato come branch o PR. AGENTS.md viene letto automaticamente per ogni attività cloud.

Le revisioni delle pull request funzionano in due modi:

Menziona @codex review in qualsiasi commento di una PR. Codex reagisce con un'emoji di occhi per confermare la ricezione, quindi pubblica una revisione strutturata incentrata sui problemi seri, verificata rispetto al tuo AGENTS.md.
Attiva le Revisioni automatiche per fare in modo che Codex pubblichi su ogni nuova PR senza un trigger manuale.

Dopo che Codex ha pubblicato una revisione, chiedigli di correggere i problemi segnalati direttamente nel thread di commento della PR. Fa il commit della correzione sullo stesso branch e aggiorna la PR.

codex-action è un'azione GitHub ufficiale che esegue la CLI di Codex all'interno della tua pipeline CI/CD su qualsiasi trigger: push, pianificazione, creazione di issue o apertura di PR. Questo è il modo consigliato per integrare Codex in pipeline completamente automatizzate in cui nessun umano è presente.

Automazioni: Lavoro senza supervisione

L'integrazione GitHub gestisce ciò che accade quando un umano apre una PR. Le automazioni gestiscono ciò che accade quando non è necessario il coinvolgimento umano.

Le automazioni sono attività Codex pianificate eseguite in worktree dedicati. Impostale dal pannello Automazioni: nome, progetto, prompt, pianificazione e ambiente di esecuzione.

Il riutilizzo dei thread è stato rilasciato ad aprile 2026. Le automazioni possono riutilizzare un thread tra le esecuzioni, accumulando contesto e diventando più intelligenti nel tempo.

Tre automazioni di base che ogni progetto dovrebbe avere:

Revisione settimanale delle dipendenze (lunedì alle 6:00): Esegui pnpm outdated e pnpm audit. Segnala risultati critici, maggiori e minori. Auto-PR per aggiornamenti minori e patch sicuri. Non toccare aggiornamenti critici o maggiori; richiedono decisioni umane.
Triage giornaliero di Sentry (giorni feriali alle 8:00): Recupera gli errori delle ultime 24 ore raggruppati per impronta. Per ogni gruppo con 3 o più occorrenze, identifica il file e la riga, legge il codice pertinente e identifica la causa principale. Pubblica un rapporto di triage. Solo diagnosi, nessuna correzione.
Pulizia settimanale delle PR in stallo (venerdì alle 17:00): Elenca le PR aperte da più di 7 giorni. Per ciascuna, determina se è in attesa di te, in attesa di revisione o è diventata obsoleta, e pubblica un commento di sollecito. Non chiudere o unire nulla.

Elimina qualsiasi automazione il cui output smette di essere letto. Una buona automazione ti fa risparmiare un'attività ricorrente che faresti comunque, produce un singolo output scansionabile e non intraprende azioni distruttive senza supervisione.

Integrazione MCP

Le automazioni funzionano con ciò che è nel tuo repo. I server MCP estendono Codex per lavorare con tutto ciò che è al di fuori.

MCP (Model Context Protocol) è lo standard aperto alla base dei plugin. Usa un plugin quando esiste. Usa MCP grezzo per integrazioni personalizzate con strumenti interni.

STDIO : Codex avvia un processo locale e comunica tramite stdin/stdout. Copre il 95% dell'uso individuale.
HTTP Streamable : Codex si connette a un endpoint di rete. Utilizzato per MCP di team ospitati.

Aggiunta di un server MCP grezzo:

O direttamente in ~/.codex/config.toml:

Configura le approvazioni per ogni strumento: approva automaticamente le letture, chiedi conferma prima delle scritture. Ogni server MCP aggiunge le definizioni degli strumenti al contesto di Codex, consumando token e diluendo l'attenzione. Abilita solo ciò che usi realmente.

Docker MCP Toolkit connette Codex a oltre 220 server pre-costruiti con un solo comando: docker mcp-client configure codex

App Mobile

I server MCP estendono ciò che Codex può raggiungere. L'app mobile estende dove puoi raggiungere Codex.

Il 14 maggio 2026, Codex è arrivato nell'app mobile di ChatGPT su iOS e Android.

Codex Mobile è una superficie di controllo remoto e monitoraggio, non un editor di codice. Il caso d'uso tipico è controllare un'attività cloud a lunga esecuzione o una sessione Goal mode dal telefono mentre sei lontano dalla scrivania.

Dal tuo telefono puoi:

Guardare le esecuzioni in tempo reale su laptop, devbox o ambienti remoti connessi
Sfogliare i thread e saltare tra attività parallele
Esaminare i diff prima che vengano unificati in un branch
Approvare o rifiutare i comandi che Codex vuole eseguire sul tuo hardware
Cambiare modello a metà attività se ne serve uno più potente
Avviare nuove attività da un prompt fresco o direttamente da una issue GitHub
Commentare su una pull request aperta da Codex

Per configurarlo, aggiorna ChatGPT alla versione del 13 maggio 2026 o successiva, accedi con lo stesso account desktop e assicurati che almeno un ambiente cloud sia configurato in Impostazioni, sotto Codex, Ambienti. Mobile eredita automaticamente tutti i thread esistenti e gli host connessi.

Il ciclo pratico che questo abilita: avvia una sessione Goal mode la mattina prima di uscire di casa, controlla i progressi durante il tragitto, approva una decisione in sospeso dal telefono e arriva in ufficio con le prime due PR già aperte.

Estensione Chrome

L'app mobile estende la tua portata. L'estensione Chrome estende la portata di Codex a qualsiasi sito web in cui hai già effettuato l'accesso.

Ciò significa che può accedere a servizi autenticati: LinkedIn, Salesforce, Gmail, Workday e qualsiasi strumento interno che richieda il login.
Installala andando su Plugin nell'app desktop Codex, aggiungendo il plugin Chrome e seguendo la configurazione guidata.
L'estensione mostra lo stato Connesso quando è attiva. Invocala da qualsiasi thread di Codex:

Codex può controllare multiple schede Chrome tramite sotto-agenti attraverso diversi thread, ogni scheda isolata.

Un grande vantaggio rispetto all'automazione del browser headless: l'estensione Chrome può accedere agli strumenti di sviluppo web. Codex può ispezionare il DOM, leggere gli errori della console e diagnosticare problemi di runtime in una sessione live del browser. Funziona sia su macOS che su Windows.

Il Codex SDK

L'estensione Chrome gestisce l'automazione del browser. L'SDK gestisce l'automazione programmatica; l'incorporamento di Codex come infrastruttura all'interno delle tue applicazioni e pipeline.

Il Codex SDK fornisce agli sviluppatori il controllo programmatico su Codex dalle loro applicazioni e pipeline CI.

Installa l'SDK JavaScript:

Utilizzo base:

Richiama run() di nuovo sullo stesso thread per continuare la conversazione. Riprendi un thread salvato con codex.resumeThread(threadId).
L'SDK Python usa from codex_app_server import Codex. Passa un nome di modello all'avvio: thread = codex.thread_start(model="gpt-5.5").
L'SDK è attualmente sperimentale e richiede un'installazione locale del CLI di Codex.
Comunica con il server dell'app locale tramite JSON-RPC; controlla lo stesso agente con cui interagisci nell'app desktop.

Verifica: Come Fidarsi Davvero dell'Output di Codex

Tutte le superfici sopra menzionate producono output. La verifica è ciò che determina quanto di quell'output puoi effettivamente spedire.

La generazione è un problema risolto. La verifica è il collo di bottiglia.

Cinque PR cloud parallele significano cinque possibilità di introdurre un bug. Senza un livello di verifica, la tua produttività è limitata dalla velocità con cui leggi le PR.

Il problema centrale è la sicofania. Il modello che ha scritto il codice è portato a pensare che sia corretto. Chiedigli di rivedere il proprio lavoro e nella maggior parte dei casi otterrai un pollice in su.

Due soluzioni strutturali:

auto_review (in-Codex) è il sotto-agente revisore integrato di Codex. Contesto nuovo, nessun investimento nell'output precedente, molto più propenso a segnalare veri problemi.
La verifica cross-provider (gold standard) significa che Codex scrive e Claude Code revisiona. La verifica cross-provider coglie i punti ciechi specifici di una famiglia di modelli. Questa è l'abitudine di verifica minima vitale per il codice di produzione.

L'uso del Computer per la verifica comportamentale colma il divario tra "i test passano" e "la cosa funziona davvero." Fai aprire a Codex il server di sviluppo, clicca sul flusso pertinente, fai uno screenshot del risultato e confrontalo con il tuo PRD.

L'abitudine minima vitale su ogni PR: esegui una revisione automatizzata con un modello diverso prima di aprire tu stesso il diff. Leggi prima il riepilogo della revisione. Apri il diff solo quando la revisione è pulita; poi leggi per gusto, non per correttezza. Per le modifiche all'interfaccia utente, guarda lo screenshot.

Ricette: Pattern Testati sul Campo

Con le abitudini di verifica in atto, ecco i modelli end-to-end per le attività che gli sviluppatori eseguono più spesso con Codex.

Implementare una funzionalità: usa l'abilità new-feature. Leggi il PRD e AGENTS.md. Prima pianifica, poi attendi l'approvazione. Test per il percorso felice e un caso di errore. Se qualcosa è ambiguo, chiedi prima di generare codice.
Correggere un bug: usa prima l'abilità investigate. Solo diagnosi. Output dei passaggi di riproduzione, ipotesi della causa principale e un piano di validazione. Non correggere finché non è confermato.
Refactoring: elenca tutte le posizioni con grep. Output del piano di migrazione. Attendi l'approvazione. Tutti i test esistenti devono passare senza modifiche. Se un test necessita di aggiornamenti, il test è sbagliato; fermati e segnalo. Una PR.
Integrazione di terze parti: incapsula in /lib/integrations/[nome].ts. Aggiungi le variabili d'ambiente a .env.example. Nessuna interfaccia utente in questa PR. Apri come bozza per test manuali contro il servizio esterno.
Backfill dei test: output del piano di test che copra i casi felici, limite e di errore. Attendi l'approvazione. Tutti i test devono passare con il codice di produzione esistente. Non modificare il codice di produzione.
Aggiornamento delle dipendenze: leggi le note di rilascio tra le versioni. Elenca le modifiche di rottura. Attendi l'approvazione. Aggiorna e applica le modifiche al codice. Esegui i test fino a quando non sono puliti.
Iniziativa Goal mode: delimita con un numero massimo di PR, un numero massimo di righe di codice per PR, un gate CI tra le PR e chiare condizioni di arresto. Metti in pausa sulle decisioni architetturali non presenti in AGENTS.md. Metti in pausa su qualsiasi modifica alle API che comporti rottura.

Errori Comuni

Questi pattern coprono i successi più comuni. La sezione seguente copre gli errori più comuni; i dieci sbagli che spiegano la maggior parte delle brutte esperienze con Codex.

Attività vaghe. Nomina risultati, file e vincoli specifici. Se non puoi essere specifico, l'attività non è pronta per essere affidata.

Nessun AGENTS.md. Scrivine uno. Anche uno brutto è meglio di niente.

Saltare la pianificazione. "Produci prima un piano" per qualsiasi cosa non banale.

Prompt multi-attività. Un'attività per prompt. Usa sotto-agenti o attività cloud per il lavoro parallelo.

Iniziare con accesso completo e pericoloso. workspace-write e on-request è l'impostazione predefinita giusta per tutto tranne le automazioni testate.

Troppi MCP e plugin. Mantieni l'elenco snello. Disabilita ciò che non usi attivamente.

Auto-revisione. Usa auto_review o uno strumento completamente diverso. Il modello che ha scritto il codice è parziale a suo favore.

Fidarsi della compilazione riuscita come correttezza. Includi la verifica comportamentale. Usa Computer Use per le modifiche all'interfaccia utente.

Eccessiva parallelizzazione. Parallelizza solo il lavoro indipendente. I file condivisi devono essere serializzati.

Goal senza limiti. Numero massimo di PR, numero massimo di righe di codice, tempo massimo, condizioni di arresto chiare. La modalità Goal è più utile con il guinzaglio che daresti a uno sviluppatore junior.

Cheat Sheet di Riferimento Rapido

Comandi CLI:

Percorsi dei file chiave:

Configurazione globale: ~/.codex/config.toml
AGENTS.md globale: ~/.codex/AGENTS.md
AGENTS.md del progetto: <repo-root>/AGENTS.md
File di override: AGENTS.override.md
Memorie: ~/.codex/memories/
Abilità (personali): $HOME/.agents/skills/
Abilità (team): .agents/skills/ all'interno del repo
Sotto-agenti: .codex/agents/<nome>.md

La struttura del prompt in quattro parti:

Racconta : il risultato, non il metodo
Mostra : input di esempio e output attesi
Descrivi : le API, le librerie e i pattern da utilizzare
Ricorda : le convenzioni da AGENTS.md

Conclusione

Dopo 12 mesi di utilizzo di Claude, il punto di rottura non è stata una singola giornata negativa. È stato l'accumulo di limiti di frequenza, attriti nel flusso di lavoro e un'esperienza dell'app desktop che continuava a intralciare.

Quella frustrazione è ciò che ha spinto il passaggio a Codex.

Negli ultimi 90 giorni, addentrarsi nell'ecosistema OpenAI ha chiarito una cosa: Codex sembra più completo come ambiente di lavoro per flussi di lavoro seri per sviluppatori.
Il modello agentico è più forte, le superfici circostanti sono più ampie e il sistema è più facile da fidarsi una volta che AGENTS.md, Abilità, Cloud e cicli di verifica sono in atto.
Questo non significa che Claude Code non abbia valore. Significa che i compromessi hanno smesso di avere senso.

Se Claude Code funziona ancora per il tuo flusso di lavoro, continua a usarlo. Ma se sei stanco dei limiti di frequenza, delle sessioni fragili e degli strumenti che sembrano lottare contro il tuo processo, Codex è ora abbastanza buono da giustificare un cambio serio.

Questo articolo è stato scritto per rendere quel cambio più facile.

Spero che ti sia piaciuto e che inizi a creare ❤️

Disclaimer

Questo articolo è stato scritto dall'autore basandosi sui suoi appunti, ricerche ed esperienze personali, e modificato da un modello AI (Sonnet 4.6).

L'immagine di anteprima è stata presa da Pinterest e modificata usando l'AI.