Cos’è Codex e come funziona

Codex è l’agente di programmazione di OpenAI. Riceve un obiettivo scritto in linguaggio naturale, legge il progetto, modifica i file, esegue i comandi in una sandbox e consegna un diff da revisionare. Si può usare dal terminale, dall’app desktop di ChatGPT, da un’estensione IDE o dal cloud, con lo stesso account e in gran parte con la stessa configurazione.

La differenza rispetto a un assistente che completa la riga successiva sta nel ruolo assegnato: non si scrive più codice riga per riga, ma si assegna un lavoro e si controlla il risultato.

Obiettivi del guide

Questa guida segue l’ordine in cui è realmente necessario usare Codex: dall’installazione al primo diff, fino agli script di automazione. I fatti provengono dalla documentazione ufficiale e dal repository openai/codex. I prompt e gli esempi sono modelli da adattare ai propri file.

Installazione e configurazione

La CLI si installa con un unico comando e, al primo avvio, richiede di accedere con l’account ChatGPT. Codex è incluso nelle offerte ChatGPT da Free a Enterprise e può anche essere usato con una chiave API.

Esistono quattro metodi di installazione:

    • macOS/Linux: curl -fsSL https://chatgpt.com/codex/install.sh | sh
    • Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
    • npm: npm install -g @openai/codex
    • Homebrew: brew install --cask codex

Una volta installata, si avvia con codex nella cartella del progetto. Al primo avvio, si sceglie “Sign in with ChatGPT” o altri metodi di autenticazione. Per diagnosticare problemi, codex doctor controlla installazione e autenticazione, mentre codex --version mostra la versione corrente.

Superfici disponibili

Codex non è un singolo programma, ma cinque superfici che parlano allo stesso motore. La scelta dipende dal contesto di lavoro e dal grado di controllo richiesto:

    • CLI: Terminale (macOS, Linux, Windows). Ideale per lavoro quotidiano e script.
    • Applicazione desktop: Spazio Codex in ChatGPT. Permette più conversazioni in parallelo e diff con un click.
    • Estensione IDE: Compatibile con editor come VS Code. Un agente accanto al codice che si sta leggendo.
    • Cloud: Ambienti remoti collegati a GitHub. Per task lunghi che continuano con il computer spento.
    • Revisione su GitHub: Commenti nei pull request per una seconda lettura automatica prima della fusione.

Scegliere e cambiare modello

Il modello si imposta con /model nella CLI o tramite il selettore nell’app. La documentazione attuale elenca GPT‑6.1 Sol, GPT‑6.1 Terra, GPT‑6 Astra e GPT‑6 Luna; GPT‑5.5 è stato rimosso il 14 ottobre 2026. Per capire il rapporto qualità‑costo, consultare gli articoli su GPT‑6.1 Terra e consumo di quota di Sol. Nota importante: ChatGPT Work e Codex condividono lo stesso consumo di crediti.

Per una panoramica completa di modelli, offerte e prezzi, vedere il guida completo di OpenAI e ChatGPT. La documentazione di Codex è su learn.chatgpt.com; gli indirizzi precedenti developers.openai.com/codex ora reindirizzano.

Prompt di partenza

Per testare Codex senza rischi, occorre un piccolo progetto già sotto Git con una task auto‑verificabile. Esempio: un modulo scadenze.py che calcola la scadenza di una fattura (data di emissione più 30 giorni o fine mese) e un test che fallisce nei mesi con 31 giorni.

Prompt efficace (primo‑prompt.txt):

Il repository contiene il modulo scadenze.py con i suoi test. Un test fallisce. Trova la causa e correggila con la minima modifica possibile. Hai terminato quando tutti i test passano e nessun altro file è stato toccato. Alla fine, spiegami in tre righe cosa hai cambiato e perché.

Questo approccio descrive il risultato e il criterio di completamento, lasciando a Codex l’investigazione.

Gestire versioni e diff

Codex lavora sui file reali del progetto, quindi il vero filtro di sicurezza è Git. Prima di ogni sessione, il worktree deve essere pulito e deve esserci un commit di partenza.

git status                # worktree pulito?

git switch -c prova-codex # branch temporaneo


codex                     # avvia sessione interattiva


git diff                  # visualizza le modifiche riga per riga


git diff --stat           # numero di file modificati


git restore .             # annulla tutto e ricomincia


git add -p && git commit  # conserva solo le parti corrette

Due buone pratiche evitano quasi tutti i problemi: leggere sempre il diff prima dei test e lavorare su una branch per ogni tentativo, così il rollback è una semplice comando.

Per una revisione non interattiva, la CLI offre codex review, mentre /review è disponibile all’interno della sessione.

Sandbox e approvazioni

L’autonomia di Codex si regola con due impostazioni indipendenti: la sandbox definisce cosa l’agente può toccare, mentre la politica di approvazione stabilisce quando deve chiedere conferma.

ImpostazioneValoriCosa controlla
Sandbox (--sandbox)read-only, workspace-write, danger-full-accessPerimetro tecnico delle azioni (OS)
Approvazioni (-a)on-request, neverSe l’agente chiede permesso prima di eseguire un comando

Il comportamento predefinito è prudente: approval: never e sandbox: read-only. L’agente gira con la rete disattivata per impostazione predefinita. Si può modificare al volo con /permissions o al lancio con i flag corrispondenti.

Costi e licenze

I crediti acquistati formano un unico saldo per ChatGPT, Codex, Word, Excel e PowerPoint, una volta esaurito l’uso incluso nel piano. La licenza prevede costi per esecuzione e punti di rottura; per dettagli vedere il “guida su ciò che si può davvero fare con l’automazione senza codice”.

OpenAI ha dovuto ripensare il controllo di versione: con Pando ha mantenuto Git e ricostruito solo il backend in 10 settimane con l’aiuto di Codex.

Le permissioni su un agente che agisce in produzione sono critiche: il caso di un server riavviato e di un fstab riscritto dimostra il costo di una singola istruzione che supera il limite di sicurezza.

Automazione avanzata

Una volta compresa la gestione di sandbox e approvazioni, è possibile costruire script di automazione che eseguono operazioni complesse, come aggiornamenti di configurazioni su più repository, generazione di report o deployment continui, sempre mantenendo il controllo tramite Git e le revisioni manuali.

In sintesi, Codex offre un approccio potente e sicuro alla programmazione assistita: definisci l’obiettivo, lascia che l’agente investighi e modifichi, revisiona il diff, e conferma o annulla. Con le pratiche di versionamento, sandboxing e approvazione illustrate, è possibile integrare Codex in flussi di lavoro quotidiani e in scenari di automazione su larga scala.