Prima di iniziare
Che cosa ti serve.
Un account ChatGPT
Devi riuscire ad accedere all’app e ad aprire Codex con il tuo account. La disponibilità dipende dall’account o dallo spazio di lavoro che stai usando.
L’app desktop
Installa l’app ChatGPT per Windows o macOS, accedi e verifica che Codex possa aprire una cartella del computer.
Il pacchetto MAIOS
Scarica lo ZIP preparato alla fine del Form. Conserva il file originale finché non hai verificato la cartella estratta.
Una cartella nuova
Non mescolare il primo avvio con un progetto già aperto. Crea una cartella vuota dedicata al pacchetto.
La guida ufficiale OpenAI all’app desktop descrive l’installazione, l’accesso con l’account ChatGPT, l’apertura di una cartella e l’avvio di una nuova chat Codex.
Percorso più semplice
Scarica ed estrai il pacchetto.
- In P5 seleziona Scarica il Pacchetto Setup AI e attendi che il browser completi il download.
- Crea una cartella nuova con un nome riconoscibile, per esempio
Progetto-MAIOS. - Apri il file ZIP e scegli Estrai tutto. Come destinazione indica la cartella appena creata.
- Apri la cartella estratta e controlla che contenga almeno
AGENTS.md,START_HERE.mdeCODEX_SETUP.md.
Codex deve aprire la cartella estratta. Vedere i file nell’anteprima dello ZIP non equivale ad averli estratti.
Se preferisci essere guidato
Puoi chiedere a Codex di estrarre il file.
Metti lo ZIP in una cartella nuova, apri quella cartella in Codex e invia questo messaggio:
In questa cartella c’è il pacchetto MAIOS in formato ZIP. Estrailo in una nuova sottocartella, verifica che contenga AGENTS.md e START_HERE.md e fermati prima di eseguire script o modificare altri file.
Se la tua app dispone dell’accesso al browser o al computer, puoi anche chiederle di aiutarti con il download dalla pagina P5 già aperta. Codex potrebbe chiedere una conferma oppure indicarti il clic da fare: il download del pacchetto nasce dallo stato del Form e non va sostituito con un indirizzo inventato.
Nell’app desktop
Apri la cartella estratta in Codex.
- Avvia l’app desktop e accedi con il tuo account ChatGPT.
- Scegli di aprire una cartella e seleziona la cartella che contiene direttamente
AGENTS.mdeSTART_HERE.md. - Avvia una nuova chat Codex in quella cartella.
Se vedi soltanto un altro file ZIP o una cartella con lo stesso nome, probabilmente sei un livello troppo in alto. Entra nella cartella che mostra i file del progetto.
Prima conversazione
Scrivi un solo messaggio.
Leggi START_HERE.md e inizia dal contesto già raccolto.
Codex leggerà anche le istruzioni della cartella, ricostruirà ciò che il Form ha già definito e individuerà il primo punto ancora da chiarire. Non serve incollare di nuovo tutto il progetto.
Se vuoi prima controllare ciò che ha compreso, aggiungi in un secondo messaggio:
Prima di modificare file, spiegami in parole semplici che cosa è già configurato, che cosa manca e quale primo risultato possiamo verificare.
Durante il dialogo
Come proseguire senza competenze tecniche.
- Rispondi con i fatti che conosci. Se non sai una risposta, scrivi “non lo so ancora”: è un’informazione valida.
- Chiedi esempi. Puoi scrivere “Fammi un esempio riferito alla mia attività” oppure “Spiegalo senza termini tecnici”.
- Inizia con materiale sintetico o anonimizzato. Collega dati e servizi reali soltanto dopo aver compreso il primo test e i suoi confini.
- Verifica un risultato per volta. Chiedi che cosa sarà prodotto, come lo controllerai e che cosa non verrà ancora fatto.
- Conferma gli effetti esterni. Invii, pubblicazioni, account, integrazioni e modifiche a sistemi reali richiedono un’autorizzazione separata.
Il pacchetto scaricato, estratto o aperto non dimostra che un servizio sia installato, attivo o pubblicato. La conversazione serve a completare e verificare la configurazione prima degli effetti reali.
Messaggi pronti
Tre esempi per continuare.
Non so ancora che cosa costruire
Parti dalle informazioni già raccolte e mostrami due possibilità concrete per la mia attività. Spiega quale primo risultato potrei verificare senza collegare dati reali.
Ho un’attività o un’azienda
Usiamo un caso sintetico simile al mio lavoro. Fammi una domanda per volta e aiutami a definire persone, fonti e criterio di verifica.
Voglio sviluppare un’applicazione
Mostrami lo stato iniziale del progetto e proponi il prototipo più piccolo che verifica la funzione principale. Non installare dipendenze finché non mi hai spiegato il piano.
Ripresa e controllo
Se qualcosa non funziona.
Codex dice che non trova START_HERE.md
Controlla di aver estratto lo ZIP e di aver aperto la cartella che contiene direttamente START_HERE.md. Se necessario scrivi: Verifica in quale cartella stai lavorando e mostrami i file di primo livello senza modificare nulla.
Codex mi chiede di ripetere tutto il Form
Scrivi: Il contesto è già nel pacchetto. Leggi project/PROJECT_BRIEF.md, project/CURRENT_STATE.md e setup/CONTEXT_REPORT.md, poi chiedimi soltanto ciò che manca davvero.
Non capisco una domanda
Scrivi: Spiegami perché questa informazione cambia il progetto e fammi un esempio semplice. Se posso rimandarla, segnala che è ancora da definire.
Voglio riprendere in una nuova chat
Apri una nuova chat Codex sulla stessa cartella e scrivi: Riprendi il progetto dal punto salvato. Codex deve rileggere lo stato dei file, non ricostruire il lavoro soltanto dalla conversazione precedente.