# OpenAI Codex: installazione, accesso e primi passi
> Codex di OpenAI: l’applicazione agente, i metodi di installazione, le interfacce, i modelli, i piani, le autorizzazioni e le condizioni di accesso regionale.
Source: https://ailoot.ai/blog/it/openai-codex-install/
Canonical: https://ailoot.ai/blog/it/openai-codex-install/
Language: it
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-080
Revision: sha256-3879855b003fa24ceafc8f2474cb8c181ee6efc317545ae09c0a206af8ac0424
La parola “Codex” nei risultati di ricerca indica tre cose diverse e, di solito, chi la cerca per la prima volta non capisce cosa ha trovato. C’era un modello Codex, ritirato nel 2023; oggi il nome appartiene a un programma agente, e nella mischia ci sono un’altra dozzina di prodotti con lo stesso nome.
Qui parlo di un solo Codex: l’agente di programmazione di OpenAI. Cosa fa, dove funziona, quanto costa, come installarlo in cinque minuti e cosa dice OpenAI sui Paesi. È tutto basato sulla documentazione ufficiale, con link per ogni dato alla fine.
Altri materiali sulla configurazione degli strumenti sono nella [documentazione Ailoot](https://ailoot.ai/docs/).
[Guide Ailoot](https://ailoot.ai/docs/)
Attenzione
Questo materiale è solo a scopo informativo. Non sono un avvocato e non fornisco consulenza legale.
## Che cos’è OpenAI Codex?
Punto chiave
Codex è un agente di programmazione di OpenAI. Legge il progetto, modifica i file ed esegue comandi secondo i permessi attivi e la politica di approvazione; alcune azioni consentite avvengono senza una richiesta separata. Funziona nel terminale, nell’editor, nell’app ChatGPT, nel browser e nel cloud. È incluso in tutti i piani ChatGPT, compreso quello gratuito.
Confrontalo con una normale chat. In chat copi un pezzo di codice, lo incolli, ottieni una risposta e poi la copi di nuovo. Un agente funziona diversamente: descrivi un’attività in linguaggio naturale e lui apre i file pertinenti nella cartella del progetto, apporta modifiche, esegue controlli e ti mostra il risultato.
OpenAI lo descrive in una riga nel suo repository:
Codex CLI è un agente di programmazione di OpenAI che viene eseguito localmente sul tuo computer.
— OpenAI, https://github.com/openai/codex
Localmente significa che il programma viene scaricato sulla tua macchina, dove può vedere i tuoi file ed eseguire comandi nella tua cartella. Solo la richiesta al modello viene inviata al cloud.
Il codice open source è su GitHub con licenza Apache-2.0. Al 1° agosto 2026, il repository ha 103.000 stelle e l’ultima versione, 0.146.0, è stata pubblicata il 29 luglio. Gli aggiornamenti escono quasi ogni giorno, quindi molto probabilmente la tua versione sarà già diversa.
## In cosa Codex nel 2026 è diverso dal vecchio Codex che è stato ritirato?
Punto chiave
Sono due prodotti diversi con lo stesso nome. Il vecchio Codex era una famiglia di modelli `code-davinci` e `code-cushman` che funzionavano all’interno di GitHub Copilot e sono stati ritirati il 23 marzo 2023. Il nuovo Codex è apparso nell’aprile 2025 ed è diventato un agente anziché un modello. L’unica cosa che hanno in comune è il nome.
Spesso vengono confusi perché entrambi i prodotti sono ufficiali e provengono da OpenAI. A distinguerli sono le date.
Il primo era una famiglia di modelli: `code-davinci-001`, `code-davinci-002`, `code-cushman-001`, `code-cushman-002`. Facevano una sola cosa: completare il codice per te, e alimentavano la prima versione di GitHub Copilot. Nell’elenco dei modelli ritirati di OpenAI, tutti e quattro compaiono su una sola riga: annunciati il 20 marzo 2023, ritirati il 23 marzo, con `gpt-4o` come sostituto consigliato.
Il secondo è un programma che si installa sul computer. Il pacchetto `@openai/codex` è comparso nel registro npm il 16 aprile 2025. Il modello al suo interno viene sostituito nel tempo con uno più recente, mentre il programma rimane lo stesso.
| Caratteristica | Versione precedente al 2023 | Versione attuale |
|----|----|----|
| Che cos’è | una famiglia di modelli API | un programma agente sul computer |
| Come veniva usato | completamento del codice nell’editor | descrivi un’attività e l’agente la svolge |
| Dove funzionava | all’interno di GitHub Copilot e nell’API | terminale, editor, app, browser, cloud |
| Stato | ritirato il 23 marzo 2023 | aggiornato quasi ogni giorno |
Qualsiasi istruzione su Codex precedente all’aprile 2025 descrive un prodotto ritirato. Se trovi materiale che definisce Codex un modello e suggerisce di richiamarlo tramite `code-davinci-002`, chiudilo.
## Dove funziona Codex: nel terminale, nell’editor, nel browser o nell’app?
Punto chiave
Codex funziona in cinque ambienti, ma dietro alle diverse interfacce c’è lo stesso agente. La CLI viene eseguita nel terminale, l’estensione si integra con un editor, una modalità separata è disponibile nell’app ChatGPT per macOS e Windows, ChatGPT nel browser risponde a domande rapide e Codex Cloud esegue attività in container isolati di OpenAI.
Non devi scegliere tra un ambiente e l’altro. L’accesso è lo stesso, così come l’account. Cambia solo il luogo in cui ti è più comodo lavorare.
| Dove funziona | Dove viene eseguito | A cosa serve |
|----|----|----|
| CLI | terminale sul tuo computer | modificare un progetto, eseguire comandi, lavorare con gli script |
| Estensione per editor | VS Code, Cursor, Windsurf, Xcode, JetBrains | modificare accanto al file aperto, vedere le modifiche sul posto |
| App ChatGPT | macOS e Windows | attività lunghe, lavorare con file al di fuori del terminale |
| ChatGPT nel browser | qualsiasi computer, senza installazione | una domanda rapida di programmazione quando non hai un terminale a portata di mano |
| Cloud | container di OpenAI, accesso da chatgpt.com/codex | attività in parallelo, avvio di attività da GitHub, Linear, Slack |
L’estensione funziona diversamente con Xcode e JetBrains rispetto agli altri editor:
Scegli il tuo editor. VS Code e gli editor compatibili usano l’estensione Codex; Xcode e JetBrains hanno le proprie integrazioni.
— Documentazione Codex, https://learn.chatgpt.com/docs/codex/ide
Il cloud funziona diversamente dagli altri quattro ambienti. L’attività viene inviata a un container OpenAI, dove viene estratta una copia del repository da GitHub. L’agente lavora senza usare il tuo computer e, in seguito, puoi esaminare il risultato e decidere se integrare le modifiche nella tua copia. La configurazione richiede tre passaggi: collegare GitHub, creare un ambiente con le dipendenze necessarie e assegnare un’attività.
Se accedi con una chiave API, funzionano il terminale, l’editor e l’app. Il cloud non è disponibile con una chiave, così come le funzioni ad esso collegate, per esempio la revisione automatica del codice e l’avvio di attività da Slack. Per usarle devi accedere con un account ChatGPT.
## Quale modello viene eseguito dentro Codex?
Punto chiave
La famiglia GPT-5.6 comprende tre modelli: Sol per le attività complesse, Terra per il lavoro quotidiano e Luna per le attività rapide e ripetitive. Puoi cambiare modello con `/model` e regolare anche il livello di ragionamento. GPT-5.4 e GPT-5.4 mini lasceranno Codex il 31 agosto 2026 e saranno sostituiti rispettivamente da Terra e Luna.
OpenAI riassume così:
Codex offre tre modelli GPT-5.6: Sol per l’esplorazione approfondita e l’attenzione ai dettagli, Terra come modello versatile per il lavoro quotidiano e Luna per le attività semplici e ripetitive. Se non sai quale scegliere, inizia con Sol.
— Documentazione Codex, https://learn.chatgpt.com/docs/models
Accanto al modello c’è un secondo controllo: il livello di ragionamento. Ha quattro impostazioni: **Low** (chiamata **Light** nell’app e nell’editor), **Medium**, **High** e **Extra High**. OpenAI consiglia di usare il livello più basso che consente di ottenere il risultato desiderato e di aumentarlo quando un’attività richiede pianificazione.
Al di sopra ci sono altre due modalità. Max concede al modello più tempo per un’attività. Ultra suddivide il lavoro in parti e le assegna a subagenti in parallelo. La documentazione afferma chiaramente che la maggior parte delle attività non richiede né l’una né l’altra.
C’è anche un’opzione separata, `gpt-5.3-codex-spark`: una versione di ricerca per iterazioni rapide, disponibile solo con il piano Pro.
Scegliere il modello e il livello di ragionamento è già **context engineering**: decidi quanto deve ragionare l’agente e quali informazioni portare nell’attività. La combinazione si basa su tre pilastri: **clone AI** (la tua metodologia all’interno dell’agente), **Second Brain** (la struttura delle conoscenze sul progetto) e **context engineering**. Senza questa combinazione, l’agente AI inizia a inventare cose.
[Guide Ailoot](https://ailoot.ai/docs/)
## Quanto costa Codex e cosa comprendono i piani?
Punto chiave
Codex è incluso in tutti i piani ChatGPT, compreso quello gratuito. Free costa 0 dollari, Go 8, Plus 20, Pro parte da 100 e Business costa 20 per postazione con fatturazione annuale. Non c’è un abbonamento Codex separato: paghi ChatGPT e Codex è incluso. Puoi anche accedere con una chiave API e pagare i token man mano che li usi.
Ho verificato i prezzi sulla pagina ufficiale dei prezzi il 1° agosto 2026.
| Piano | Prezzo mensile | Cosa comprende |
|----|----|----|
| Free | \$0 | Codex per attività brevi |
| Go | \$8 | Codex per attività leggere |
| Plus | \$20 | Codex nel terminale, nell’editor, sul web e su iOS, con la famiglia GPT-5.6 |
| Pro | da \$100 | limiti 5 volte superiori a Plus; il piano da \$200 offre limiti 20 volte superiori |
| Business | \$20 per postazione con fatturazione annuale | almeno 2 postazioni, spazio di lavoro condiviso, accesso unico |
| Enterprise e Edu | su richiesta | elaborazione prioritaria, registri di controllo, controlli di conservazione dei dati |
| Chiave API | per token | terminale, editor e SDK, senza funzioni cloud |
Con la fatturazione mensile, Business costa \$25 per postazione anziché \$20.
Passiamo ai limiti. OpenAI non indica un solo numero fisso:
Il numero di messaggi che puoi inviare dipende dal modello scelto, dalle dimensioni e dalla complessità delle attività e dal fatto che le esegui in locale o nel cloud.
— Documentazione Codex, https://learn.chatgpt.com/docs/pricing
Invece di un solo numero, OpenAI pubblica un intervallo: quanti messaggi puoi inviare nell’arco di cinque ore lavorando sul tuo computer. I dati sono gli stessi per Plus e Business:
| Modello | Messaggi ogni 5 ore |
|---------------|----------------------|
| GPT-5.6 Sol | 10-100 |
| GPT-5.6 Terra | 25-200 |
| GPT-5.6 Luna | 250-2 000 |
| GPT-5.5 | 15-80 |
| GPT-5.4 | 20-100 |
| GPT-5.4 mini | 60-350 |
Con il piano Pro da $100, tutti i valori sono moltiplicati per cinque; con quello da $200, per venti. Oltre alla finestra di cinque ore, OpenAI menziona anche limiti settimanali, ma non ne pubblica i valori specifici.
L’intervallo di dieci volte per un singolo modello ha una spiegazione semplice. Un messaggio può consumare l’uno o il dieci percento della disponibilità giornaliera: conta la quantità di lavoro svolto, mentre il numero di richieste ha poca importanza. In [Limiti di Claude Pro e Max](https://ailoot.ai/blog/it/claude-pro-max-usage-limits/) ho spiegato in dettaglio come vengono usati i token, con Claude come esempio: il meccanismo è esattamente lo stesso.
Quando esaurisci il limite, hai tre opzioni: acquistare crediti aggiuntivi senza cambiare piano, passare a un modello più leggero oppure avviare una sessione con una chiave API e pagare i token man mano che li usi.
## Quali restrizioni regionali si applicano a Codex?
Punto chiave
Il programma può essere scaricato ed eseguito ovunque, ma senza un account OpenAI è inutile, e la restrizione si applica all’account stesso. Il controllo del Paese avviene all’accesso e restituisce un codice 403. Non esiste un metodo ufficiale per aggirarlo e non ne illustrerò uno.
OpenAI pubblica l’elenco ufficiale dei Paesi e territori supportati. La Bielorussia non è nell’elenco. Kazakistan, Armenia, Georgia, Turchia, Serbia e Ucraina sono presenti.
La formulazione riportata sulla stessa pagina:
L’accesso ai nostri servizi, o la fornitura di accesso agli stessi, al di fuori dei Paesi e territori elencati di seguito può comportare la sospensione o la chiusura dell’account.
— OpenAI, https://developers.openai.com/api/docs/supported-countries
Installare ed eseguire il programma è una cosa; accedere al modello è un’altra. Il controllo del Paese avviene all’accesso: sia l’accesso tramite ChatGPT sia quello con una chiave API richiedono un account OpenAI.
Le segnalazioni su GitHub mostrano l’aspetto di un rifiuto legato al Paese. Nel gennaio 2026, uno sviluppatore venezuelano ha scritto che usava Codex 0.88.0 in PowerShell e riceveva lo stesso errore a ogni tentativo:
```json
{
"error": {
"code": "unsupported_country_region_territory",
"message": "Country, region, or territory not supported",
"type": "request_forbidden"
}
}
```
Il codice `unsupported_country_region_territory` e lo stato 403 indicano un rifiuto legato al Paese. Se lo vedi, significa che non hai sbagliato nulla durante l’installazione e che Node non c’entra.
C’è un secondo ostacolo che non viene affatto descritto nella documentazione, ma che nella pratica si presenta spesso: la verifica del numero di telefono. La segnalazione “La verifica del numero di telefono non funziona” ha 206 commenti; una seconda, relativa a un vecchio numero non più accessibile e impossibile da sostituire, è aperta da giugno 2026 e ha 71 commenti. La storia è sempre la stessa: ChatGPT funziona nel browser con lo stesso account, ma Codex chiede la verifica del telefono e non c’è modo di aggirarla. OpenAI non pubblica un elenco dei Paesi i cui numeri di telefono accetta, quindi non c’è modo di verificare in anticipo se il tuo è accettato.
Non tratterò metodi alternativi: questo articolo spiega come funziona lo strumento.
Anche Anthropic pubblica il proprio elenco dei Paesi supportati e il funzionamento è lo stesso. I materiali che presentano uno strumento come «consentito» e l’altro come «bloccato» fuorviano i lettori: dal punto di vista formale, si trovano nella stessa situazione. Entrambi gli elenchi possono cambiare, quindi controlla le versioni aggiornate.
## Come installare Codex: istruzioni passo passo
Punto chiave
L’installazione richiede cinque minuti. Su macOS e Linux, usa un solo comando con il programma di installazione ufficiale; su Windows, usa PowerShell. Sono disponibili anche npm e Homebrew. Poi esegui `codex` nella cartella del progetto, accedi tramite il browser e puoi assegnargli la prima attività. Su Linux e WSL2, installa prima bubblewrap.
La parte tecnica comincia qui, per chi ha già un account OpenAI attivo.
1. ### Installa il programma
Scegli il metodo adatto al tuo sistema. In seguito, usa lo stesso metodo per aggiornare il programma alla versione più recente.
2. ### Apri la cartella del progetto
L’agente lavora nella cartella da cui lo hai avviato. Raggiungila prima di eseguire il primo comando.
3. ### Accedi al tuo account
La prima volta che esegui `codex`, ti verrà proposto di accedere. Si aprirà il browser e, dopo l’accesso, tornerai al terminale.
4. ### Assegnagli la prima attività
Descrivi in linguaggio naturale ciò di cui hai bisogno. Inizia con qualcosa di innocuo, per esempio chiedigli di descrivere il progetto.
Comando di installazione per macOS e Linux:
```bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
Su Windows, usa lo stesso programma di installazione tramite PowerShell:
```powershell
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```
Se hai già Node, puoi installarlo tramite npm:
```bash
npm install -g @openai/codex
```
Homebrew funziona su macOS. Assicurati di usare `--cask`; senza, installerai la cosa sbagliata:
```bash
brew install --cask codex
```
Attenzione
Controlla il nome del pacchetto prima di installarlo tramite npm. Ho verificato il registro: dal 1° ottobre 2011, il nome `codex` senza prefisso è occupato dal pacchetto di qualcun altro. È un generatore di siti statici e la versione più recente è la 0.2.3. Si installa senza mostrare messaggi e non funziona. Il nome corretto è `@openai/codex`: il simbolo @, il nome dell’azienda e una barra.
Su Linux e WSL2, la sandbox si basa su bubblewrap, che devi installare in anticipo:
```bash
sudo apt install bubblewrap
```
Su Fedora e sistemi correlati, usa `sudo dnf install bubblewrap`. Inoltre, WSL versione 1 era supportato fino alla versione 0.114; a partire dalla 0.115, la sandbox è passata a bubblewrap e WSL1 non ha più funzionato. Su Windows, invece, tutto funziona anche senza WSL, usando la sandbox integrata.
## Cosa fare al primo avvio?
Punto chiave
I brevi comandi slash funzionano durante una sessione. Inizia con `/status`, che mostra il modello, la politica di approvazione e le cartelle di lavoro. Poi prova `/permissions` per vedere cosa può fare l’agente. `/model` cambia modello, `/init` crea un file che descrive il progetto e `/review` esamina le modifiche senza modificare file.
Per iniziare, vai nella cartella del progetto e digita `codex`: si aprirà una sessione. Poi descrivi l’attività in linguaggio naturale, senza sintassi speciale.
Cinque comandi per i primi minuti:
1. `/status` - il modello, la politica di approvazione e le cartelle che l’agente considera la propria area di lavoro.
2. `/permissions` - la modalità di accesso attuale e come passare da una modalità all’altra.
3. `/model` - cambia il modello e il livello di ragionamento.
4. `/init` - crea un file `AGENTS.md` che descrive il progetto; ne parleremo nella prossima sezione.
5. `/review` - una revisione separata delle modifiche, senza modificare file.
Oltre al semplice `codex`, ci sono tre comandi utili per il terminale:
```bash
codex resume # torna alla conversazione precedente in questa cartella
codex exec "fix the tests" # esecuzione singola senza dialogo, per gli script
codex --image screenshot.png # allega un’immagine all’attività
```
Sia nella documentazione del terminale sia in quella dell’estensione, OpenAI ripete lo stesso consiglio: esegui un commit prima e dopo un’attività. L’agente modifica i file da solo e vuoi poter annullare le modifiche con un solo comando fin dal primo giorno.
## Come spieghi il tuo progetto a Codex con AGENTS.md?
Punto chiave
AGENTS.md è un file di testo nella radice del progetto, dove puoi scrivere regole con parole tue: come eseguire i test, quale gestore di pacchetti usare e cosa non toccare. L’agente lo legge prima di iniziare il lavoro. C’è un file globale nella cartella home e ci sono file a livello di progetto; le regole dei due livelli si applicano insieme. La dimensione totale è limitata a 32 kilobyte.
L’ordine è rigoroso e la documentazione lo afferma nella primissima riga della sezione:
Codex legge i file AGENTS.md prima di iniziare qualsiasi attività.
— Documentazione Codex, https://learn.chatgpt.com/docs/agent-configuration/agents-md
Per prima cosa, Codex legge il file globale `~/.codex/AGENTS.md`, dove inserisci le abitudini valide per tutti i tuoi progetti. Poi legge i file presenti nel progetto: un file per cartella, dalla radice del repository fino alla cartella corrente. Li combina dall’alto verso il basso e un file più vicino prevale su uno più distante. Per esempio, una regola in `services/payments` ha la precedenza su una regola generale nella radice.
Un file semplice ha questo aspetto:
```markdown
# AGENTS.md
## Come lavorare con questo progetto
- Esegui i test con `npm test`; non eseguirli un file alla volta.
- Installa i pacchetti con pnpm.
- Chiedimi prima di aggiungere una nuova dipendenza di produzione.
- Non toccare affatto la cartella `legacy/`.
```
Il limite è di 32 kilobyte per i file combinati. Superato quel limite, i file successivi semplicemente non vengono aggiunti e non ricevi alcun avviso. Un file AGENTS.md troppo grande consuma inoltre il limite a ogni esecuzione, perché il file intero viene inserito nel contesto.
Se conosci `CLAUDE.md`, il funzionamento ti sembrerà familiare: è la stessa tecnica con un nome diverso. Il file delle regole del progetto è la base di un **Second Brain**: l’agente apprende informazioni sul tuo lavoro prima ancora che tu abbia la possibilità di spiegargli qualcosa. Ho descritto come usare entrambi i file in un progetto in [AGENTS.md e CLAUDE.md insieme](https://ailoot.ai/blog/it/agents-md-claude-md-one-instruction-file/).
## Cosa fa Codex da solo e per cosa richiede approvazione?
Punto chiave
Ci sono due impostazioni indipendenti. La sandbox determina dove l’agente può scrivere e se può accedere alla rete. La politica di approvazione determina quando si ferma e chiede. Per impostazione predefinita, in una cartella git l’agente modifica da solo i file nella cartella di lavoro e richiede l’approvazione solo per uscirne o accedere alla rete.
Queste due impostazioni vengono spesso confuse, quindi OpenAI ne spiega la differenza in una riga:
Cambiare chi esamina una richiesta non amplia la sandbox.
— Documentazione Codex, https://learn.chatgpt.com/docs/permission-modes
Impostare la revisione automatica lascia invariati i confini della cartella di lavoro. L’automazione elimina solo i clic: non cambia le autorizzazioni dell’agente.
L’app e l’editor hanno tre modalità di accesso. **Ask for approval** è sempre disponibile ed è la modalità iniziale consigliata. **Approve for me** e **Full access** devono prima essere abilitate nelle impostazioni.
Il terminale segue una logica propria: il programma controlla la cartella e propone un insieme di autorizzazioni adatto.
| Situazione | Cosa suggerisce il programma | Cosa significa |
|----|----|----|
| Cartella sotto controllo git | `Auto` | modifica da solo i file nella cartella di lavoro; serve approvazione per uscirne o accedere alla rete |
| Cartella senza git | `read-only` | legge e risponde, ma non apporta modifiche |
| Codex Cloud | container OpenAI | le dipendenze vengono installate durante la configurazione; poi il lavoro procede senza accesso alla rete |
In modalità locale l’accesso alla rete è disattivato per impostazione predefinita. L’agente esegue comandi che ha ideato da solo, e nessuno vorrebbe consentirgli di raggiungere Internet per impostazione predefinita.
Anche all’interno della cartella di lavoro, in ogni modalità l’agente può leggere solo alcune posizioni: `.git`, `.agents` e `.codex`. Usa `/status` per vedere quali cartelle l’agente considera attualmente la propria area di lavoro.
C’è anche la modalità di accesso completo, attivabile con il flag `--dangerously-bypass-approvals-and-sandbox`. La documentazione la definisce a rischio più elevato e la contrassegna come “non consigliata”. Il nome del flag dice tutto; non ho altro da aggiungere.
## Codex o Claude Code: quale scegliere?
Punto chiave
Entrambi gli strumenti sono costruiti allo stesso modo: un agente nel terminale, un’estensione per editor, un’app e il cloud. Differiscono per modelli, prezzo iniziale e dettagli come il nome del file delle regole di progetto. L’opzione meno costosa per Codex parte da zero; quella per Claude Code da 17 dollari.
| Caratteristica | Codex | Claude Code |
|----|----|----|
| Fornitore | OpenAI | Anthropic |
| Modelli | GPT-5.6: Sol, Terra, Luna | Opus, Sonnet, Haiku |
| File delle regole di progetto | `AGENTS.md` | `CLAUDE.md` |
| Accesso | account ChatGPT o chiave API | abbonamento Claude o fatturazione Console |
| Opzione meno costosa | Free a \$0, Go a \$8 | Pro a \$17 con fatturazione annuale |
| Dove funziona | terminale, editor, app, web, cloud | terminale, editor, app, web |
| Sandbox | rete disattivata per impostazione predefinita, scrittura nella cartella di lavoro | modalità di autorizzazione configurabili |
| Elenco dei Paesi supportati | pubblicato da OpenAI | pubblicato da Anthropic |
La differenza tra gli strumenti è minore di quanto si possa dedurre dalle discussioni online. Entrambi leggono il progetto e modificano i file da soli, chiedendo prima di uscire dalla cartella.
Per iniziare, è più semplice considerare cosa paghi già. Se hai un abbonamento ChatGPT, Codex è già incluso e non devi pagare a parte. Ho realizzato un confronto dettagliato con misurazioni in un articolo dedicato a [Codex e Claude Code a confronto](https://ailoot.ai/blog/it/codex-vs-claude-code-choice/); se vuoi trasferire le impostazioni di lavoro da uno all’altro, c’è una [guida alla migrazione](https://ailoot.ai/blog/it/migrate-claude-code-to-codex/).
## Quali sono i problemi più comuni al primo avvio?
Punto chiave
Cinque problemi tipici: è stato installato il pacchetto npm sbagliato, bubblewrap non è installato su Linux, l’accesso viene negato per il Paese al momento dell’autenticazione, viene richiesta la verifica del numero di telefono oppure i limiti di utilizzo si esauriscono inaspettatamente.
Questo elenco si basa sulle segnalazioni nel repository del progetto. Non ci sono supposizioni: ogni elemento deriva dall’esperienza di qualcuno che ci si è imbattuto.
1. **È stato installato il pacchetto sbagliato.** `npm install -g codex` senza prefisso installa un generatore di siti statici del 2011. Il pacchetto corretto è `@openai/codex`.
2. **bubblewrap non è installato.** Senza bubblewrap su Linux e WSL2, la sandbox non si avvia. Codex passa alla propria alternativa integrata e segnala il problema all’avvio. Basta installarlo con un comando.
3. **Accesso negato per il Paese.** Il codice `unsupported_country_region_territory` e lo stato 403 compaiono al momento dell’autenticazione. Non dipende dall’installazione.
4. **Viene richiesta la verifica del telefono.** Non succede a tutti e il problema non è descritto nella documentazione. Non esiste un metodo ufficiale per sostituire un numero a cui non si ha più accesso; la segnalazione è aperta da giugno 2026.
5. **I limiti di utilizzo si esauriscono prima del previsto.** La segnalazione “I token si esauriscono molto rapidamente” è la più discussa dell’intero repository, con 627 commenti. Può essere utile passare a un modello più leggero e ridurre il livello di ragionamento.
La lingua dell’interfaccia non influisce sul lavoro dell’agente: non è necessario che la lingua dell’attività coincida con quella dell’interfaccia.
## Cosa fare dopo
Punto chiave
Installa il programma e apri un progetto, poi controlla `/status` e `/permissions` prima di assegnare attività. Scegli e verifica l’accesso in sola lettura se vuoi soltanto una descrizione dei file. La modalità Auto può modificare la cartella di lavoro senza chiedere conferma a ogni cambiamento; un prompt apparentemente innocuo o l’assenza di Git non garantiscono sola lettura. Poi aggiungi un AGENTS.md con tre regole e confronta le risposte.
La prima ora con un agente è sempre dedicata alla stessa cosa: capire fin dove può spingersi da solo. Puoi scoprirlo solo con il tuo progetto; un esempio nella documentazione non te lo dirà.
Ecco l’ordine che consiglio per iniziare:
1. Installa il programma e accedi a un account OpenAI attivo.
2. Apri una cartella di progetto reale ed esegui `codex`.
3. Controlla `/status` e `/permissions`, seleziona esplicitamente sola lettura per una semplice ispezione e verifica la modalità attiva prima di chiedere come sia organizzato il progetto.
4. Crea un commit e assegnagli la prima attività di modifica.
5. Scrivi un file `AGENTS.md` di tre righe e confronta le risposte dell’agente prima e dopo.
### Fonti
- [Codex CLI: installazione e primo avvio](https://learn.chatgpt.com/docs/codex/cli) - Documentazione ufficiale OpenAI
- [Estensione Codex per editor](https://learn.chatgpt.com/docs/codex/ide) - elenco degli editor supportati
- [Codex Cloud](https://learn.chatgpt.com/docs/cloud) - attività in ambienti isolati
- [Modelli Codex](https://learn.chatgpt.com/docs/models) - GPT-5.6 Sol, Terra, Luna e date di ritiro dei modelli precedenti
- [Piani e limiti Codex](https://learn.chatgpt.com/docs/pricing) - prezzi dei piani e numero di messaggi disponibili ogni cinque ore
- [Metodi di accesso](https://learn.chatgpt.com/docs/auth) - account ChatGPT e chiave API
- [Sandbox e approvazioni](https://learn.chatgpt.com/docs/sandboxing) - modalità di accesso, bubblewrap su Linux
- [Autorizzazioni e sicurezza dell’agente](https://learn.chatgpt.com/docs/agent-approvals-security) - percorsi protetti, flag pericoloso, suggerimenti predefiniti
- [Modalità di autorizzazione](https://learn.chatgpt.com/docs/permission-modes) - Ask for approval, Approve for me, Full access
- [AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md) - come l’agente legge le regole del progetto
- [Paesi e territori supportati](https://developers.openai.com/api/docs/supported-countries) - elenco ufficiale di OpenAI
- [Modelli OpenAI ritirati](https://developers.openai.com/api/docs/deprecations) - data del ritiro del vecchio Codex
- [Repository openai/codex](https://github.com/openai/codex) - codice open source, segnalazioni degli utenti, release
- [Pacchetto @openai/codex nel registro npm](https://registry.npmjs.org/@openai/codex) - versioni e date di pubblicazione
- [Release di Codex su GitHub](https://github.com/openai/codex/releases) - numeri di versione e date di pubblicazione
**Clone AI + Second Brain + Context Engineering**: trovi altri materiali su come lavorare con gli strumenti nella [documentazione Ailoot](https://ailoot.ai/docs/).
[Guide Ailoot](https://ailoot.ai/docs/)
[Vai ad Ailoot](https://ailoot.ai/)
## Domande frequenti
### Codex chiederà conferma prima di ogni modifica ai file?
No. Nel flusso Auto descritto, le modifiche consentite nella cartella di lavoro possono avvenire senza conferma individuale. Controlla /status e /permissions prima della prima attività e seleziona esplicitamente sola lettura quando vuoi soltanto una spiegazione.
### Perché l’installazione riesce ma l’accesso fallisce con un errore regionale?
Installazione della CLI e accesso ai modelli sono passaggi separati. Un 403 con unsupported_country_region_territory riguarda l’accesso dell’account, non Node o l’installer. Confronta la regione dell’account con le informazioni OpenAI sui paesi supportati.
## Ailoot · L’azienda e il suo portafoglio di progetti
Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.
L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.
Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.