La tua prima attività con Codex
In questa pagina
Aggiornato il 3 novembre 2026 in base al riferimento dei comandi di Codex (CLI 0.166.0): le opzioni
--show-diffe--applynon esistono. In locale, Codex modifica i file direttamente all’interno della sua sandbox; rivedi le modifiche usando/diffogit diff. Il comando dell’estensione “Codex: New Task” è stato sostituito da Codex: Open Codex Sidebar. Fonti: Developer commands · Codex IDE extension.
Avvia la tua prima attività
Il tuo account è configurato, GitHub è connesso e AGENTS.md è al suo posto: è il momento di vedere l’agente in azione. Ecco una regola d’oro per ogni livello di competenza: inizia con un’attività di cui conosci già la risposta corretta. Non imparerai molto guardando Codex risolvere un problema che non sai valutare, ma imparerai tantissimo osservandolo operare su un terreno familiare.
Da Codex Cloud
Sul web o nell’app desktop, scegli Work in › Cloud, seleziona l’ambiente pubblicato per il tuo repository (Lezione 2) e digita la tua attività nel campo di input. Qualcosa di volutamente modesto funziona perfettamente.
Task: "Add a .gitignore file suitable for a Node.js/TypeScript
project if one doesn't already exist."
Questa formulazione include una condizione—“if one doesn’t already exist”—che è esattamente ciò che la rende interessante da osservare. In Codex Cloud, l’attività viene eseguita nell’ambiente che hai pubblicato per questo repository: Codex verifica se esiste un .gitignore, controlla che copra Node.js e TypeScript se presente, crea o aggiorna il file secondo necessità e ti mostra il risultato come diff. Il log di esecuzione viene trasmesso in tempo reale: è qui che vedrai se l’agente ha rispettato la condizione o sovrascritto il tuo file esistente.
Dall’IDE
Apri il tuo progetto in VS Code (o Cursor, Windsurf) e avvia Codex tramite la sua icona o la Tavolozza dei Comandi:
Ctrl+Shift+P → "Codex: Open Codex Sidebar"
Quindi formula una richiesta che sfrutti il contesto locale nominando il file specifico:
"Add email validation to the contact form
in src/components/ContactForm.tsx"
L’estensione visualizza un riepilogo e le righe modificate a fianco del codice; mantieni le modifiche che desideri e chiedi approfondimenti all’interno della stessa conversazione. La documentazione consiglia di creare un checkpoint Git prima e dopo l’attività, così da poter tornare indietro se necessario.
Dalla CLI
# Navigate to the project directory
cd my-project
# Start a session with an initial instruction
codex "Add a README.md with the project description, installation instructions, and available commands"
In locale, Codex modifica i file direttamente nella tua directory di lavoro, entro i limiti della sandbox e della politica di approvazione: chiede il permesso prima di intraprendere azioni che lo richiedono. Per rivedere cosa è cambiato prima del commit, digita /diff nella sessione: il comando visualizza il diff di Git, inclusi i file non tracciati. /review chiede a Codex di rivedere il tuo albero di lavoro stesso. Per l’uso scriptato, codex exec esegue la stessa attività senza interazione (Lezione 14): in quel caso, spetta a Git e alla tua pipeline decidere cosa mantenere.
Anatomia di un risultato di Codex
Indipendentemente dal punto di ingresso, un’attività completata restituisce sempre gli stessi quattro elementi. Rivedili in questo ordine: il diff dice cosa è cambiato, il log dice perché, i test dicono se è sicuro e le azioni ti restituiscono il controllo.
| Elemento fornito | Cosa contiene |
|---|---|
| Diff delle modifiche | Ogni riga aggiunta, modificata o eliminata, file per file |
| Log di esecuzione | Tutti i passaggi: file letti, comandi eseguiti, ragionamento dell’agente |
| Risultati dei test | Se esistono test, Codex li esegue per verificare che nulla sia rotto |
| Azioni disponibili | Approvare, modificare, creare una PR o rieseguire con istruzioni diverse |
I principianti spesso trascurano il log di esecuzione, eppure è l’elemento che ti insegna come formulare le tue attività. Vedendo quali file Codex ha aperto prima di prendere una decisione, scopri cosa stava cercando ma non ha trovato—spesso una convenzione che avrebbe dovuto essere in AGENTS.md.
Scrivere buone istruzioni
La qualità del risultato dipende direttamente dalla qualità delle istruzioni, e il divario tra le due formulazioni seguenti è molto più ampio del divario tra due modelli.
"Improve the code"
"In src/lib/auth.ts, replace manual JWT handling
with the jose library. Keep the same public interface
(signToken, verifyToken). Update the corresponding tests."
La seconda versione funziona perché risponde a quattro domande che l’agente si pone comunque. Specifica i file coinvolti, risparmiandogli di esplorare e colpire la posizione sbagliata. Definisce il risultato atteso—comportamento, interfaccia, formato—così sa quando fermarsi. Imposta dei vincoli, qui preservando l’interfaccia pubblica, il che gli impedisce di “migliorare” le cose rompendo i chiamanti; altrove potrebbe essere “non rompere i test”. E quando la posta in gioco lo giustifica, aggiunge il contesto aziendale: specificare “questo è un modulo di pagamento, la sicurezza è critica” cambia genuinamente i suoi compromessi.
Per fare tuo questo metodo, prendi un progetto esistente e concatena tre attività di natura diversa: un’analisi senza modifiche, “List all TypeScript files that lack associated tests”; una generazione mirata, “Generate a unit test for this file”; una correzione a scope limitato, “Fix ESLint warnings in src/utils/”. Per ognuna, nota cosa avresti dovuto specificare fin dall’inizio: questa lista di rimpianti è la tua prima bozza di AGENTS.md.
Punti chiave
- Avvia le tue prime attività con richieste semplici e mirate
- Codex fornisce un log di esecuzione completo per ogni attività
- La qualità del risultato dipende dalla precisione delle tue istruzioni
- Mantieni sempre il controllo: approva, modifica o rifiuta
- Inizia con attività a basso rischio prima di passare a modifiche critiche