Cerchi una guida a «Codex» e ne trovi dieci che non descrivono lo stesso oggetto: una parla di un modello da chiamare via API, un'altra di un'app, un'altra ancora di un comando da lanciare nel terminale. Prima di installare qualcosa ti serve una mappa, e la mappa va datata, perché questo prodotto cambia più in fretta delle guide che lo raccontano. La risposta, letta il 13 novembre 2026 sulla documentazione ufficiale, è questa: Codex è un agente di programmazione di OpenAI, che legge il tuo codice, lo modifica, esegue comandi e ti restituisce un risultato da rivedere. Lo raggiungi da più punti d'ingresso (le app ChatGPT, il terminale, l'editor, il cloud) e ti autentichi con un account ChatGPT oppure con una chiave API. La scelta dell'accesso conta più di quanto sembri, perché con la chiave API la pagina dei prezzi esclude le funzioni cloud. La CLI è open source con licenza Apache-2.0; l'estensione per l'editor e il cloud no.
Metodo e limiti. Non sono affiliato a OpenAI. Non ho installato né eseguito la CLI di Codex e non ho chiamato alcun modello: ciò che accade dentro lo strumento lo riferisco dalla documentazione, non lo garantisco per esperienza. Le pagine ufficiali elencate in fondo sono state lette il 2026-11-13. Gli script di questo articolo sono miei, non toccano Codex, e ognuno è stato eseguito due volte con la stessa uscita (Python 3.14 su Linux).
Un nome, quattro significati: perché le guide si contraddicono
La pagina Deprecations dell'API OpenAI elenca, con data di chiusura 23 marzo 2023 (data di avviso 20 marzo), i modelli code-davinci-002 (riga etichettata «Codex models»), code-davinci-001, code-cushman-002 e code-cushman-001. Chi legge oggi un tutorial che gli chiede di chiamare quei nomi sta leggendo qualcosa che non funziona più. Il repository openai/codex su GitHub risulta creato il 13 aprile 2025 (campo created_at dell'API di GitHub): è la casa dell'agente di cui parla questa serie. Non ho una fonte primaria per le date di annuncio dei singoli prodotti, quindi non le scrivo.
- Un modello dell'API. I nomi
code-davinci-*ecode-cushman-*, ritirati nel 2023. Se una guida parla ditemperatureemax_tokens, descrive questo. - Un agente da terminale. La CLI
codex, installabile con una riga di shell, con npm o con Homebrew, che lavora nella cartella del tuo progetto. - Una famiglia di superfici. Lo stesso agente raggiungibile da app desktop e mobile, web, estensione per l'IDE e cloud, più SDK e modalità non interattiva per gli script.
- Un suffisso nel nome di un modello. Identificatori come
gpt-5.3-codex, che la pagina dei modelli indica come già deprecato in Codex con l'accesso ChatGPT.
Il criterio per orientarti è la data della guida e il comando che mostra. Un tutorial con parametri di campionamento e una chiave API in uno script Python parla del primo significato; uno con npm install -g @openai/codex parla del secondo; uno con schermate dell'app parla del terzo. Se incontri un nome di modello con codex dentro, non assumere che esista ancora: controllalo sulla pagina Models. Un segnale pratico di quanto cambi il terreno: l'indirizzo developers.openai.com/codex oggi rimanda a learn.chatgpt.com/docs (l'ho verificato seguendo il rimando con curl -L), perché la documentazione di Codex vive dentro quella di ChatGPT. Se i tuoi segnalibri puntano al vecchio indirizzo, aggiornali.
Dove gira il lavoro: le superfici
Conviene ragionare per luogo di esecuzione, non per nome del prodotto. La tabella riassume ciò che le pagine ufficiali dicono di ciascun punto d'ingresso; la colonna di destra è mia sintesi, e dove la fonte tace lo scrivo.
| Superficie | Dove esegue | Quando ha senso (mia sintesi) |
|---|---|---|
| CLI | Sul tuo computer, nel repository in cui la avvii | Lavori da terminale e vuoi vedere i comandi mentre passano |
| Estensione per l'IDE | Sul tuo computer, dentro l'editor, con i file aperti e le selezioni come contesto | Vuoi restare nell'editor; per lavori lunghi la pagina rimanda a Codex sul web |
| App ChatGPT per desktop | Ogni chat si sceglie fra Local e Worktree (entrambe sul tuo computer) e Cloud | Vuoi decidere caso per caso e isolare le modifiche in un worktree Git |
| Mobile | Nel cloud oppure su un computer collegato: dal telefono avvii, guidi e approvi | Segui un lavoro già avviato senza tornare alla scrivania |
| Cloud | In un ambiente remoto, con file di lavoro propri per ogni compito | Compiti lunghi o paralleli che non vuoi tenere sul portatile |
SDK, codex exec, GitHub Action | Dove li lanci tu: script, CI, eventi di GitHub | Automazione ripetibile (parte 6 della serie) |
Il compromesso di fondo è fra controllo e continuità. Locale significa che vedi ogni comando e che i file restano sulla tua macchina, ma il lavoro si ferma quando spegni il computer. Cloud significa che ogni compito ha il proprio spazio di lavoro e può proseguire mentre il computer dorme, come dice la pagina del cloud, ma in cambio il compito vede solo ciò che l'ambiente remoto contiene: la pagina degli ambienti avverte che i file locali, i processi in esecuzione, gli accessi del browser e la VPN non vengono trasferiti automaticamente. Un esempio: se il test che devi far passare richiede un database raggiungibile solo dalla VPN aziendale, un compito nel cloud fallirà per ragioni che non hanno nulla a che vedere con il codice.
Che cosa è aperto e che cosa no
La pagina Open Source di Codex ha una tabella dei componenti, che riporto per intero nelle parti che contano per decidere.
| Componente | Stato secondo la pagina |
|---|---|
| CLI | Aperta, in openai/codex («the primary home for Codex open-source development») |
| SDK e App Server | I sorgenti stanno nello stesso repository |
| Skill e plugin | Repository dedicati: openai/skills e openai/plugins |
| Ambiente cloud universale | La base usata dal cloud è aperta: openai/codex-universal |
| Estensione per l'IDE | Non open source |
| Codex cloud | Non open source |
Che cosa ne ricavi: puoi leggere il codice dell'agente che gira sul tuo computer, segnalare problemi e riprodurli, ma non puoi proporre correzioni con una pull request, perché la pagina precisa che il repository accetta contributi sotto forma di segnalazioni e non accetta codice esterno. Il pezzo che esegue nel cloud, invece, non è ispezionabile. La licenza della CLI l'ho letta dall'API di GitHub, che per openai/codex riporta Apache-2.0.
Account ChatGPT o chiave API: la scelta che fai per prima
La pagina Authentication dice che l'app desktop, la CLI e l'estensione per l'IDE accettano entrambi i metodi per il lavoro locale, mentre Codex cloud richiede l'accesso con ChatGPT. Dice anche una cosa che si perde facilmente: il metodo di accesso decide anche quali controlli amministrativi e quali regole sui dati si applicano. Le conseguenze pratiche sono due.
- Accesso con ChatGPT. L'uso segue i permessi del tuo workspace, i ruoli (RBAC) e, per Enterprise, le impostazioni di conservazione e residenza dei dati. Il consumo ricade sulle quote del piano, a finestre di cinque ore più eventuali limiti settimanali, e si accede anche alle funzioni cloud.
- Chiave API. L'uso segue le impostazioni di conservazione e condivisione dei dati della tua organizzazione API, e si paga ai prezzi dell'API. La scheda della chiave API nella pagina dei prezzi elenca CLI, SDK ed estensione per l'IDE, e dichiara «No cloud-based features»; la disponibilità dei modelli segue quelli che la tua chiave può usare.
Il discrimine non è solo il costo ma il perimetro. Chi lavora su codice soggetto a vincoli contrattuali deve sapere con quale delle due regole sui dati sta lavorando, e quella scelta si fa all'accesso, non dopo. Chi automatizza in CI ha un motivo in più per la chiave API: la scheda la descrive come adatta all'automazione in ambienti condivisi.
Per rendere esplicito che cosa la documentazione afferma e che cosa tace, ho scritto una piccola tabella a tre valori. Ogni cella proviene dalle pagine Pricing e Authentication; dove la pagina non nomina la superficie il valore è «nd» (non dichiarato) e non viene mai trasformato in un «sì» per comodità. La funzione verdetto risponde alla domanda «con questo accesso, ho ciò che mi serve?» distinguendo tre casi: escluso, da verificare, coperto. La seconda funzione dello stesso file, versione, serve a confrontare la tua versione della CLI con il minimo che la pagina dei modelli richiede per GPT-6.1 Terra (0.159.0): una pre-release come 0.170.0-alpha.4 viene ordinata dopo la 0.159.0, perché si confronta prima la parte numerica.
"""Tabella a tre valori: la documentazione di Codex dice si', no, oppure tace.
Ogni cella e' copiata da una pagina ufficiale (vedi FONTE); dove la pagina
non nomina la superficie il valore e' ND (non dichiarato), mai un si' ipotizzato.
"""
SI, NO, ND = "si", "no", "nd"
SUPERFICI = ("desktop", "web", "cli", "ide", "cloud", "sdk")
# FONTE: pagina Pricing (schede dei piani) e pagina Authentication, consultate il 2026-11-13.
ACCESSI = {
"Free/Go": dict(desktop=SI, web=ND, cli=ND, ide=ND, cloud=ND, sdk=ND),
"Plus/Pro": dict(desktop=ND, web=SI, cli=SI, ide=SI, cloud=SI, sdk=ND),
"Business": dict(desktop=SI, web=ND, cli=ND, ide=ND, cloud=SI, sdk=ND),
"Chiave API": dict(desktop=ND, web=ND, cli=SI, ide=SI, cloud=NO, sdk=SI),
}
def verdetto(accesso, bisogni):
celle = ACCESSI[accesso]
manca = [s for s in bisogni if celle[s] == NO]
incerte = [s for s in bisogni if celle[s] == ND]
if manca:
return "ESCLUSO (la pagina dice no): " + ", ".join(manca)
if incerte:
return "DA VERIFICARE (la pagina tace): " + ", ".join(incerte)
return "COPERTO dalla pagina"
def versione(testo):
"""'0.170.0-alpha.4' -> ((0, 170, 0), 0): una pre-release precede la stabile."""
base, _, pre = testo.partition("-")
return tuple(int(p) for p in base.split(".")), (0 if pre else 1)
# FONTE: pagina Models: GPT-6.1 Terra richiede Codex CLI 0.159.0 o successivo.
MINIMO_TERRA = versione("0.159.0")
if __name__ == "__main__":
for bisogni in (("cli", "cloud"), ("cli", "sdk"), ("cli", "ide")):
print("bisogni:", "+".join(bisogni))
for nome in ACCESSI:
print(f" {nome:<11} {verdetto(nome, bisogni)}")
for installata in ("0.158.9", "0.159.0", "0.167.2", "0.170.0-alpha.4"):
ok = versione(installata) >= MINIMO_TERRA
print(f"CLI {installata:<16} Terra: {'ok' if ok else 'troppo vecchia'}")
# Comando: python3 -I scegli_accesso.py
# Output:
# bisogni: cli+cloud
# Free/Go DA VERIFICARE (la pagina tace): cli, cloud
# Plus/Pro COPERTO dalla pagina
# Business DA VERIFICARE (la pagina tace): cli
# Chiave API ESCLUSO (la pagina dice no): cloud
# bisogni: cli+sdk
# Free/Go DA VERIFICARE (la pagina tace): cli, sdk
# Plus/Pro DA VERIFICARE (la pagina tace): sdk
# Business DA VERIFICARE (la pagina tace): cli, sdk
# Chiave API COPERTO dalla pagina
# bisogni: cli+ide
# Free/Go DA VERIFICARE (la pagina tace): cli, ide
# Plus/Pro COPERTO dalla pagina
# Business DA VERIFICARE (la pagina tace): cli, ide
# Chiave API COPERTO dalla pagina
# CLI 0.158.9 Terra: troppo vecchia
# CLI 0.159.0 Terra: ok
# CLI 0.167.2 Terra: ok
# CLI 0.170.0-alpha.4 Terra: ok
Leggi l'uscita così. Per CLI più cloud, soltanto Plus e Pro sono «coperti» dalle pagine; la chiave API è esclusa perché la scheda dice no; Free, Go e Business risultano «da verificare» perché la scheda non nomina la CLI. Per CLI più SDK vale l'opposto: la chiave API è l'unica combinazione coperta, perché la scheda dei piani ChatGPT non cita l'SDK. È un limite di questo script, dichiarato nel commento: copre soltanto ciò che due pagine dicono, e le pagine cambiano. Prima di comprare, riapri la pagina dei prezzi: lo script ti dice dove cercare, non sostituisce la lettura.
Piani e prezzi, come elencati il 13 novembre 2026
Fonte: la pagina Pricing. I prezzi sono in dollari statunitensi, come scritti dalla pagina; non riporto importi in euro né imposte, che la pagina non dettaglia.
| Piano | Prezzo dichiarato | Che cosa elenca la pagina |
|---|---|---|
| Free | $0 al mese | Compiti rapidi; GPT-6 Luna a velocità Standard nell'app desktop, «subject to rollout» |
| Go | $8 al mese | Compiti leggeri; stesso modello di Free |
| Plus | $20 al mese | Codex su web, CLI, estensione IDE e iOS; integrazioni cloud come revisione automatica e Slack; GPT-6.1 Sol e GPT-6 Luna; crediti ChatGPT |
| Pro | Da $100 al mese | Livelli da $100, $200 o $500; la modalità Ultrafast è sul livello da $500 |
| Business | $20 per utente al mese (almeno 2 utenti, fatturazione annuale); $25 con fatturazione mensile | Workspace dedicato, SAML SSO, MFA, crediti; la pagina dichiara nessun addestramento sui dati aziendali per impostazione predefinita |
| Enterprise ed Edu | Contatto commerciale | SCIM, EKM, controllo degli accessi per ruolo, Compliance API, controlli su conservazione e residenza dei dati |
| Chiave API | A consumo, secondo il listino API | CLI, SDK ed estensione IDE; nessuna funzione cloud |
Due letture da non sbagliare. La prima: i limiti non sono espressi in dollari ma in messaggi locali ogni cinque ore. Per Plus la pagina riporta stime, e precisa che non sono limiti fissi: per GPT-6.1 Sol da 15 a 160 messaggi, per GPT-6 Luna da 350 a 3.000, con possibili limiti settimanali e con i compiti cloud che possono consumare di più. L'ampiezza di quegli intervalli è il dato: un compito grande con molto contesto consuma molto più di una funzione piccola, e la lunghezza del prompt da sola non lo prevede. Per Pro la pagina scrive che al momento non c'è un limite a cinque ore. La seconda: la modalità Fast consuma 2,5 volte la quota inclusa rispetto a Standard sullo stesso modello, secondo la tabella della pagina, e le modalità Ultrafast, per i due modelli che la tabella elenca, 8 volte; se ti accorgi che la quota finisce presto, controlla prima la velocità e il modello scelti, poi il piano.
Se raggiungi il limite nel mezzo di un turno, la pagina dice che l'agente può continuare quel turno, entro limiti di uso corretto; chi ha Plus o Pro può comprare crediti. Il consiglio che ne ricavo, e che è mio e non della documentazione, è di guardare il cruscotto d'uso per un paio di settimane prima di decidere se salire di piano: la pagina stessa suggerisce di controllarlo ogni una o due settimane.
Quale versione stai guardando
La CLI cambia a ritmo quasi quotidiano, e il modo giusto di dirlo è misurarlo. Lo script che segue legge l'elenco pubblico delle release di openai/codex (API di GitHub, sola lettura, nessuna chiave) e separa le stabili dalle pre-release. L'uscita cambia a ogni rilascio: è la misura di oggi, e chiunque può rifarla con lo stesso script. Il campo che conta è prerelease, che l'API espone per ogni elemento; il filtro sulle prime trenta voci ti dice quante sono davvero stabili.
"""Quale versione della CLI di Codex e' l'ultima stabile, e quale e' solo una pre-release?
Legge l'elenco pubblico delle release del repository (API di GitHub, sola lettura,
nessuna chiave) e stampa tag e data. L'uscita cambia a ogni rilascio: e' la misura di oggi.
"""
import json, urllib.request
URL = "https://api.github.com/repos/openai/codex/releases?per_page=30"
richiesta = urllib.request.Request(URL, headers={"User-Agent": "controllo-versione"})
with urllib.request.urlopen(richiesta, timeout=30) as risposta:
release = json.load(risposta)
stabili = [r for r in release if not r["prerelease"]]
prerelease = [r for r in release if r["prerelease"]]
print("ultima stabile :", stabili[0]["tag_name"], stabili[0]["published_at"][:10])
print("ultima prerelease:", prerelease[0]["tag_name"], prerelease[0]["published_at"][:10])
print("release lette :", len(release), "- di cui stabili:", len(stabili))
# Comando: python3 -I ultima_stabile.py
# Output:
# ultima stabile : rust-v0.168.0 2026-11-13
# ultima prerelease: rust-v0.170.0-alpha.4 2026-11-12
# release lette : 30 - di cui stabili: 4
Lo vedi nell'uscita: nelle ultime trenta release le stabili sono quattro, il resto sono versioni alpha. I tag hanno il prefisso rust-v. Per te significa che «l'ultima versione» è ambigua, e che due colleghi possono trovarsi con comandi diversi se uno ha installato una pre-release. Annota la versione che usi, scrivila nella documentazione interna del team e, prima di copiare un'opzione da una guida, controllala con codex --help e con la pagina di riferimento dei comandi.
Anche i modelli ruotano, e la pagina Models lo mostra con date. GPT-5.5 è stato ritirato da Codex per chi accede con ChatGPT il 14 ottobre 2026 (le sessioni con chiave API non sono toccate); gpt-5.4 e gpt-5.4-mini il 31 agosto 2026; GPT-5.3-Codex-Spark il 14 settembre 2026. Se uno script o un file di configurazione seleziona uno di questi nomi, va aggiornato. Un'incoerenza che segnalo senza risolverla: la pagina Deprecations indica come sostituti nomi della serie 5.6 (per esempio gpt-5.6-sol), mentre le pagine di Codex usano gpt-6.1-sol; per Codex vale la pagina Models.
Quando Codex non è la scelta giusta
- Il codice non deve lasciare la tua macchina. Anche con la CLI in locale, il lavoro di ragionamento passa da un modello, e la sandbox protegge il tuo filesystem, non la riservatezza dei prompt. Leggi le regole sui dati del metodo di accesso che usi, e per codice con vincoli contrattuali parti dal piano Business o Enterprise.
- Il tuo team usa già un altro agente. Il costo di cambiare (regole scritte, abitudini, procedure di revisione) spesso supera la differenza fra strumenti, e questa è una valutazione mia, non un dato.
- Il compito non è verificabile. Un agente rende dove puoi dire come si controlla il risultato: un test che passa, un comando che esce con zero. Per decisioni di progetto ancora da prendere serve prima una conversazione tua.
Il filo comune è che Codex è utile in proporzione a quanto puoi verificare ciò che produce. Dove la verifica manca, o dove i dati non possono uscire, il problema è a monte dello strumento e nessuna impostazione lo risolve.
Domande frequenti
Codex è ancora un modello di OpenAI?
No, nel senso in cui lo era un tempo. I modelli code-davinci-* e code-cushman-* sono stati ritirati il 23 marzo 2023 secondo la pagina Deprecations. Oggi Codex indica un agente di programmazione con più superfici, che usa i modelli elencati dalla pagina Models; nei nomi di alcuni modelli compare ancora il suffisso codex.
Posso usare Codex senza abbonamento ChatGPT?
Sì, in due modi che la pagina dei prezzi elenca. Il piano Free include l'app desktop con GPT-6 Luna, soggetto a rollout. Con una chiave API usi CLI, SDK ed estensione per l'IDE e paghi ai prezzi dell'API, ma senza funzioni cloud. Per CLI con i piani gratuiti la pagina non dice nulla, quindi verificalo prima di contarci.
Il software della CLI è gratuito?
Il codice è aperto con licenza Apache-2.0 e lo installi senza pagare il software. L'uso però consuma la quota del tuo piano oppure i crediti API, e questo è ciò che costa davvero.
Che cosa sai fare adesso
Sai distinguere i quattro significati del nome, scegliere fra superficie locale e cloud in base a dove devono stare i file, decidere fra account ChatGPT e chiave API con in mano la differenza sulle regole dei dati, e controllare quale versione della CLI stai usando. Il resto della serie è pensato in questo ordine, ma ogni parte si legge da sola.
- Questa mappa del prodotto.
- Installazione e primo lavoro, con un controllo di perimetro sulle modifiche.
- Sandbox e approvazioni, con una tabella eseguibile delle due manopole.
- AGENTS.md e config.toml, con un validatore di forma.
- Modelli, ragionamento e costi.
- Codex exec e SDK per l'automazione.
- Cloud, subagenti, skill e MCP.
- Il confronto con Claude Code, Copilot e Cursor.
L'ordine è quello di una progressione: prima l'accesso e il perimetro, poi le regole stabili, poi i costi e solo alla fine l'automazione e la delega, che amplificano gli errori di configurazione fatti prima. Se arrivi da un altro strumento, ho scritto anche del flusso di lavoro con Claude Code, della guida a Cursor e di GitHub Copilot.
Che cosa non ho verificato
Non ho installato né lanciato la CLI per questa serie, quindi non ho misurato velocità, qualità del codice prodotto né consumo reale di quota: dove trovi un criterio di scelta, è un criterio da applicare al tuo codice, non un risultato mio. Non ho verificato la disponibilità per paese, né se i prezzi in dollari di questa pagina corrispondano a quelli che vedrai al momento dell'acquisto, e non ho aperto le pagine di Business ed Enterprise oltre alla scheda dei prezzi. Le date di annuncio dei prodotti restano fuori perché non ho una fonte primaria.
Fonti
- Pricing - piani, prezzi in dollari, limiti a cinque ore, modalità Fast e Ultrafast, scheda della chiave API; consultata il 2026-11-13
- Authentication - i due metodi di accesso, il cloud solo con ChatGPT, regole sui dati per metodo; consultata il 2026-11-13
- Models - ritiri di GPT-5.5, GPT-5.4 e Spark; GPT-6.1 Terra richiede la CLI 0.159.0 o successiva; consultata il 2026-11-13
- Open Source - quali componenti sono aperti, cosa accetta il repository; consultata il 2026-11-13
- Codex environments - Local, Worktree e Cloud; ciò che non viene trasferito al cloud; consultata il 2026-11-13
- Codex Cloud - compiti con spazio di lavoro proprio, esecuzione con il computer a riposo; consultata il 2026-11-13
- Deprecations (API OpenAI) - la chiusura dei modelli Codex del 23 marzo 2023; consultata il 2026-11-13
- Release di openai/codex - tag e date delle versioni; la fonte è il comando
ultima_stabile.pyriportato sopra, eseguito il 2026-11-13
Gli script sono stati eseguiti con Python 3.14 su Linux, due volte, con la stessa uscita; la CLI di Codex non è stata installata né eseguita. I prezzi e i limiti cambiano: la data di ogni consultazione è quella indicata.
Commenti
Caricamento commenti...
Accedi per commentare