Come usare Codex di OpenAI: dal primo incarico a un risultato verificato

Codex è l’agente di programmazione di OpenAI. Può esaminare un progetto, modificarne i file ed eseguire controlli con gli strumenti disponibili. Tu descrivi il risultato desiderato, poi verifichi le modifiche: la nuova funzione deve fare ciò che hai chiesto, i dati devono essere corretti e il resto del progetto deve continuare a funzionare.

In questa guida costruiremo un calcolatore del costo di un laboratorio. Potrai verificarne i risultati a mano, senza saper programmare. Le cifre sono inventate per l’esercizio: sostituiscile con quelle reali prima di usarlo per un’attività.

Quali compiti affidare a Codex

Parti da un compito di cui sai riconoscere il risultato corretto. Calcolare un prezzo con una formula precisa è verificabile; «migliora il sito» lascia troppe decisioni in sospeso.

• Aggiungere un calcolatore, un filtro del catalogo o l’indice di un articolo.
• Capire perché un pulsante non risponde o un modulo accetta dati sbagliati.
• Trovare i testi di un sito e spiegare come avviare il progetto.
• Scrivere uno script per controllare i link o sistemare un’esportazione, provandolo prima su una copia dei dati.

Per discutere un’idea o rivedere un paragrafo può bastare una chat. Codex serve quando il lavoro richiede modifiche ai file. Ciò a cui può accedere dipende dall’ambiente, dagli strumenti e dai permessi disponibili.

App, editor o terminale: da dove iniziare

Se sei alle prime armi, comincia dall’app. La guida ufficiale attuale indica di installare l’app desktop ChatGPT, scegliere Codex dal menu dei prodotti e aprire la cartella del progetto. Le immagini di guide meno recenti potrebbero mostrare un’interfaccia diversa.

• Installazione e primo avvio: istruzioni ufficiali

• App desktop: per seguire il compito e lavorare con i file locali.
• Estensione dell’editor: se usi già un editor compatibile e vuoi vedere le modifiche accanto al codice.
• Codex CLI: per lavorare nel terminale. Non serve per l’esercizio di questa guida.

• Installare Codex in un editor compatibile

• Fonte dell’immagine: documentazione ufficiale di OpenAI

• Installare e avviare Codex CLI

Serve un abbonamento a pagamento?

Alla data della verifica, OpenAI include l’accesso a Codex nei piani ChatGPT, anche Free. Sono previsti limiti d’uso e i modelli disponibili dipendono dal piano. L’uso con una chiave API viene fatturato separatamente.

Prova qualche incarico concreto con il tuo account prima di scegliere un piano più costoso. Per prezzi e limiti aggiornati consulta OpenAI: una cifra riportata in un articolo può diventare obsoleta.

• Piani e limiti di Codex

Primo progetto: un calcolatore di prezzi

Prepara la cartella e i dati

Crea una cartella chiamata workshop-calculator e aprila come progetto. Se modifichi un sito esistente, salva prima lo stato attuale in Git o fai una copia della cartella. Qui servono una quota fissa, un prezzo a persona e il numero ammesso di partecipanti.

Controlla la cartella selezionata e i permessi. L’esercizio richiede soltanto modifiche nel progetto. Se Codex chiede di installare programmi o accedere a servizi esterni, verifica il motivo: la richiesta seguente non prevede dipendenze esterne.

• Permessi e controlli di accesso

Specifica regole e risultati attesi

Crea in questa cartella un calcolatore del prezzo di un laboratorio.

Tariffe di esempio: quota fissa di 120 € più 35 € a partecipante.
Accetta solo numeri interi da 1 a 12 partecipanti.
Totale = 120 + 35 × partecipanti.

Inserisci un campo per il numero, il totale e la spiegazione della formula.
Mostra un errore chiaro per campo vuoto, numero decimale, 0 o 13.
Nascondi il totale precedente quando il valore non è valido.

Usa HTML, CSS e JavaScript senza librerie esterne.
Salva la pagina come index.html. Deve aprirsi senza server né internet
e funzionare su telefono e con la tastiera.
Non aggiungere pagamenti, raccolta di contatti, analisi o recensioni inventate.

Verifica: 1 partecipante = 155 €, 4 = 260 €, 12 = 540 €.
Spiega come aprire la pagina, quali controlli hai eseguito
e quali restano da fare manualmente.

• Apri il calcolatore di esempio e prova i valori

Apri la pagina e controlla i calcoli

Apri index.html nel browser e prova 1, 4 e 12 partecipanti. Poi svuota il campo: il vecchio prezzo non deve restare visibile come risultato valido. Il resoconto dell’agente aiuta, ma non sostituisce questa prova.

1. Prova 0, 13, un decimale e il campo vuoto: il messaggio deve spiegare cosa correggere.
2. Restringi la finestra alle dimensioni di un telefono. Non dovrebbe servire lo scorrimento orizzontale.
3. Passa da un controllo all’altro con Tab. Un bordo o un altro indicatore deve mostrare quale elemento è selezionato, e il calcolatore deve funzionare senza mouse.
4. Ricarica e ripeti il calcolo: i dati precedenti non devono influenzare il risultato.

Hai un prototipo locale, ancora senza indirizzo pubblico. Se in seguito lo colleghi a un pagamento, il server dovrà verificare il prezzo in modo indipendente: il visitatore può modificare i calcoli eseguiti nel proprio browser.

Come chiedere una correzione precisa

Descrivi le azioni, l’errore osservato e il comportamento atteso. Per esempio:

Inserisco 4 e vedo 260 €. Svuoto il campo, ma il totale rimane.
A campo vuoto mostra «Inserisci il numero di partecipanti» e nascondi il totale.
Mantieni formula, intervallo 1–12 e aspetto della pagina.
Prova 4 → vuoto → 1 e 12 → 13 → 12.
Spiega la causa e come hai verificato la correzione.

Continua nello stesso compito fino ad approvare il calcolatore. Se una modifica peggiora il risultato, confronta i file con la versione salvata. Senza una cronologia, chiedere di tornare indietro non garantisce un ripristino esatto.

Lavorare su un sito esistente

Chiedi prima a Codex di esaminare la parte del progetto interessata. Un sito esistente può già avere componenti riutilizzabili, stili e controlli che non sono visibili in uno screenshot. È utile conoscerli prima di modificare i file.

Individua come vengono costruiti gli articoli del blog, senza cambiare file.
Spiega da dove arrivano titoli, testi, metadati e link delle lingue.
Elenca i file da modificare per aggiungere un articolo
e i comandi di verifica già presenti.

Poi richiedi una modifica circoscritta. Integrare il calcolatore nello stile del sito e aggiungere pagamenti sono compiti diversi, con criteri di verifica diversi.

Salvare le regole in AGENTS.md

Codex legge le istruzioni AGENTS.md prima di lavorare. Usa il file per i requisiti duraturi: avvio del progetto, fonti dei contenuti e controlli da eseguire.

# Regole del progetto

Calcolatore per laboratori. I prezzi sono di esempio.
Aprire index.html senza server né librerie esterne.
Cambiare formula e intervallo solo su richiesta esplicita.
Nascondere il totale se il valore non è valido.
Verificare 1, 4, 12, 0, 13, un decimale e il campo vuoto dopo le modifiche.
Distinguere i controlli eseguiti da quelli che non è stato possibile eseguire.

Lascia le richieste occasionali nella conversazione. Aggiorna le regole quando cambiano i requisiti, per evitare che istruzioni vecchie guidino i lavori successivi.

• Come Codex trova e applica AGENTS.md

Problemi frequenti e passi successivi

• C’è un piano ma mancano i file: verifica progetto e permessi di scrittura, poi chiedi l’implementazione.
• Il progetto non si avvia: fornisci l’errore esatto e il metodo di avvio prima di chiedere modifiche alle dipendenze.
• Funziona un solo esempio: aggiungi valori limite e dati non validi.
• Compaiono prezzi o fatti inventati: indica la fonte corretta e fai controllare anche gli altri testi.
• Il limite è esaurito: conserva i file e controlla nell’account quando e come puoi proseguire.

Prima di pubblicare, verifica anche testi, link, moduli e impostazioni per la ricerca. Per il seguito possono esserti utili queste guide:

• SEO e GEO: il ruolo di ciascuno

• llms.txt: organizzare l’accesso ai contenuti

Informazioni sul prodotto e documentazione verificate il 6 settembre 2026. Il calcolatore è un esercizio, non un caso cliente né una promessa di risultato con una sola richiesta.