Superfici: App Desktop, Cloud, IDE e CLI
In questa pagina
Lezione riscritta il 3 novembre 2026 sulla base delle pagine Codex CLI, Estensione IDE di Codex, Codex Cloud e del riferimento ai comandi CLI. La versione precedente istruiva gli utenti a installare un pacchetto npm inesistente (
@openai/codex-cli) e citava un flag--interactiveche non esiste; le opzioni sono state verificate rispetto alla CLI 0.166.0. Fonti: Codex CLI · Estensione IDE di Codex · Codex Cloud.
Un Agente, Più Superfici
Codex non è una singola applicazione; è un agente accessibile attraverso diverse superfici, ciascuna adattata a uno specifico contesto di lavoro. L’agente rimane lo stesso; ciò che cambia è dove opera—la tua macchina locale o il cloud—il contesto a cui ha accesso e come tieni traccia dell’esecuzione. Scegliere la superficie giusta spesso fa più differenza nel tuo flusso di lavoro quotidiano rispetto alla scelta di un modello specifico.
L’App Desktop di ChatGPT
L’app desktop di ChatGPT per macOS, Windows e Linux è il punto di ingresso più completo. Accedi con il tuo account ChatGPT, apri una cartella o un progetto, quindi seleziona Codex dal menu di ChatGPT per lo sviluppo software. L’agente lavora quindi sui file in quella cartella utilizzando i tuoi strumenti di sviluppo locali. Questa è la superficie per sessioni lunghe e progetti locali. È anche da qui che avvii il lavoro basato sul cloud, proprio come puoi fare dall’interfaccia web.
Codex Cloud
Per le attività che devono essere eseguite in remoto, Codex Cloud esegue il lavoro in un ambiente che configuri una volta sola. Sul web o nell’app desktop, scegli Lavora in › Cloud, quindi Seleziona ambiente e Crea ambiente. Seleziona i tuoi repository GitHub; Codex ispeziona il progetto, installa dipendenze e strumenti, testa il flusso di lavoro e ti richiede eventuali permessi di accesso mancanti. Una volta pubblicato l’ambiente, ogni attività ottiene il proprio spazio di lavoro e continua a funzionare anche quando il tuo computer va in sospensione. Esamini i file modificati e i risultati dei test, richiedi correzioni, quindi esegui il commit o apri una pull request—dal web, dal dispositivo mobile o dall’app desktop.
Questa è la superficie per lavori di lunga durata che avvii prima di una riunione: una migrazione di framework, un refactoring esteso o più attività parallele sullo stesso ambiente.
L’Estensione IDE
L’estensione Codex si installa in Visual Studio Code ed editor compatibili come Cursor, Windsurf e VS Code Insiders. Xcode e gli IDE JetBrains offrono le proprie integrazioni native di Codex. Una volta connesso, apri Codex tramite la sua icona (o in VS Code e derivati, tramite la Tavolozza dei Comandi: Codex: Open Codex Sidebar; in JetBrains, apri AI Chat e seleziona Codex).
Il suo vantaggio è il contesto immediato: file aperti, selezioni correnti e conversazioni recenti vengono inseriti direttamente nel tuo prompt e le modifiche appaiono fianco a fianco con il tuo codice. Questa è la superficie per le attività quotidiane: generare test per la funzione corrente, spiegare un blocco di codice ereditato o correggere un errore appena visualizzato nel terminale integrato. Quando un’attività diventa troppo grande, puoi delegarla al cloud dall’editor e tornare ai risultati in seguito. La documentazione consiglia di creare checkpoint Git prima e dopo un’attività, in modo da poter tornare indietro se necessario.
La CLI
La CLI è rivolta agli sviluppatori che vivono nel terminale. La documentazione offre quattro metodi di installazione:
# macOS e Linux: installer standalone
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# npm
npm install -g @openai/codex
# Homebrew
brew install --cask codex
Su Windows, esegui l’installer standalone da PowerShell: powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex".
Eseguendo codex senza argomenti in una cartella di progetto si apre l’interfaccia terminale interattiva. Al primo avvio, ti verrà chiesto di accedere con il tuo account ChatGPT o con un altro metodo.
# Apri una sessione interattiva
codex
# Apri una sessione con un prompt iniziale
codex "Aggiungi la validazione dell'email al modulo di registrazione"
# Seleziona un modello
codex --model gpt-6.1-sol "Refattorizza il modulo di pagamento"
Il suo vero valore emerge quando vai oltre l’uso manuale. codex exec (alias codex e) esegue un’attività senza interazione, rendendola ideale per script e pipeline. Quando lo stdin viene reindirizzato e viene fornito anche un prompt, codex exec aggiunge il contenuto ricevuto al prompt all’interno di un blocco <stdin>. Questo ti permette di concatenare comandi che producono elenchi di file.
# Trova i file senza test e chiedi a Codex di generarli
find src/ -name "*.ts" -not -name "*.test.ts" | codex exec "Genera i test mancanti per questi file"
Quale Superficie Scegliere?
| Situazione | Superficie Consigliata | Perché |
|---|---|---|
| Migrazione di framework | Codex Cloud | Attività di lunga durata, ambiente preparato, lavoro parallelo |
| Refactoring di un file aperto | Estensione IDE | Contesto locale immediato, revisione affiancata |
| Progetto locale, sessione lunga | App Desktop | Cartella aperta, strumenti di sviluppo |
| Script di automazione | CLI (codex exec) | Integrazione nella pipeline |
| Generazione rapida di test | Estensione IDE | I risultati appaiono nell’editor |
In pratica, la maggior parte degli sviluppatori combina queste superfici nell’arco di una singola settimana. Le sessioni di accesso sono condivise: la CLI e l’estensione riutilizzano le stesse credenziali memorizzate nella cache. E tutte le superfici leggono lo stesso file AGENTS.md, il file di istruzioni trattato nella prossima lezione.
Punti chiave
- Codex è accessibile tramite l’app desktop di ChatGPT, Codex Cloud, l’estensione IDE e la CLI
- L’app desktop e l’estensione lavorano in locale; Codex Cloud esegue le attività in ambienti pubblicati
- L’estensione si installa in VS Code e derivati; Xcode e JetBrains hanno le proprie integrazioni
- Installa la CLI tramite l’installer standalone,
npm install -g @openai/codexo Homebrew; usacodex execper l’automazione - Tutte le superfici leggono lo stesso file
AGENTS.md