Claude Code è un agente IA che lavora nel terminale del tuo computer: descrivi in linguaggio normale ciò che vuoi, e lui legge i file del tuo progetto, propone modifiche ed esegue comandi. Per iniziare ti servono un computer con Windows, macOS o Linux, alcuni strumenti di base come Node.js e Git e l'abitudine di verificare tu stesso ogni risultato.
Questo articolo spiega cosa significa in concreto, come si svolge un ciclo di lavoro con l'agente e da cosa capisci se il risultato è valido.
Che cos'è Claude Code e in cosa si distingue da una chat?
In una normale chat con l'IA ricevi del testo. Lo copi, lo incolli da qualche parte e speri che vada bene. Un agente come Claude Code invece lavora direttamente nella cartella del tuo progetto. Vede quali file ci sono, legge il codice esistente e lo modifica.
Il terminale è semplicemente la finestra di testo in cui inserisci i comandi. All'inizio può sembrare insolito, perché non ci sono pulsanti. Scrivi una riga, premi Invio e leggi la risposta. Tutto qui.
Da qui deriva il punto più importante per chi inizia: l'agente modifica file veri. È comodo, perché avanzi in fretta. Però richiede che tu tenga sotto controllo cosa è cambiato e quando. Codex svolge un ruolo simile. Il modo di lavorare descritto qui vale per entrambi gli strumenti.
Cosa ti serve prima del primo avvio?
Prima di avviare l'agente per la prima volta, il tuo ambiente dovrebbe essere pronto. Questa lista copre le basi:
- Un portatile o un computer fisso con Windows, macOS o Linux. Un tablet non basta, perché devi installare programmi e lavorare nel terminale.
- Il permesso di installare programmi. Sui dispositivi aziendali spesso è bloccato. Chiariscilo prima con il tuo servizio informatico.
- Node.js dalla versione 20. Molti progetti web ne hanno bisogno per avviare l'app in locale ed eseguire i test.
- Git. Ti permette di salvare stati intermedi e di vedere quali file ha modificato l'agente.
- Un accesso personale a Claude Code o Codex. Le condizioni applicabili sono indicate sulle pagine ufficiali del rispettivo fornitore.
- Un po' di pazienza con l'inglese. Il codice e molti messaggi degli strumenti sono in inglese, anche se scrivi i tuoi incarichi in italiano.
Per l'installazione conviene seguire la guida ufficiale del fornitore. Poi verifichi nel terminale che tutto venga riconosciuto: Node.js, Git e l'agente dovrebbero mostrare ciascuno la propria versione. Se vuoi un aiuto passo per passo, la Missione 0 sulla configurazione degli strumenti, liberamente consultabile e in tedesco, è un buon punto di partenza.
Come si svolge un ciclo di lavoro con Claude Code?
Un ciclo di lavoro tipico è breve e si ripete. Più il ciclo è piccolo, più è facile trovare un errore quando qualcosa va storto.
- Aprire la cartella del progetto. Avvii il terminale nella cartella in cui si trova la tua app.
- Salvare lo stato intermedio. Con Git registri com'era il progetto prima della modifica.
- Formulare l'incarico. Descrivi una sola modifica, ben delimitata.
- Leggere la proposta. Prima di dare il tuo consenso, guardi quali file l'agente vuole toccare e perché.
- Avviare l'app e provarla. Percorri tu stesso la nuova funzione, clic dopo clic.
- Eseguire i test. Se il tuo progetto ha dei test, ti mostrano se qualcos'altro si è rotto.
- Salvare e annotare. Salvi il nuovo stato e annoti brevemente cosa ha contribuito l'IA e cosa hai adattato tu.
L'ultimo passo sembra pedante, ma ripaga. Altrimenti dopo una settimana non sai più perché una certa riga si trova nel codice.
Come dai all'agente un incarico chiaro?
L'errore più frequente all'inizio è un incarico troppo ampio e troppo vago. «Costruiscimi una gestione dei contatti» lascia aperte all'agente innumerevoli decisioni. Le prende lui, e dopo non capisci cosa ne è uscito.
Meglio scomporre un compito in passi verificabili e indicare per ciascuno da cosa riconosci che è concluso. Queste frasi di verifica si chiamano casi di accettazione. Di solito seguono lo schema: se faccio questo, allora succede quello.
Un esempio da un'app per i contatti
Supponiamo che la tua app mostri già una lista di contatti. Ora ogni contatto deve ricevere uno stato. Un incarico chiaro potrebbe essere questo:
Aggiungi a ogni contatto un campo Stato con i valori «nuovo», «contattato» e «concluso». I nuovi contatti partono con «nuovo». Nella vista di dettaglio posso cambiare lo stato. Non modificare l'aspetto della lista.
Casi di accettazione: se creo un nuovo contatto, il suo stato è «nuovo». Se nella vista di dettaglio imposto lo stato su «contattato» e ricarico la pagina, resta «contattato».
Ora l'agente sa cosa deve fare, dove farlo e cosa deve lasciare stare. E tu sai come verificare il risultato.
Cosa deve contenere un buon incarico
- Obiettivo: cosa deve poter fare in seguito la persona che usa l'app?
- Luogo: quale vista o quale parte dell'app è interessata?
- Limiti: cosa non deve essere modificato?
- Casi di accettazione: due o tre frasi che puoi verificare tu stesso.
- Casi di errore: cosa deve succedere se un dato inserito è vuoto o non valido?
Come verifichi ciò che ha costruito l'agente?
Spesso un agente formula le sue risposte come se tutto fosse fatto. Questo non significa ancora che sia vero. Verificare quindi non è sfiducia, fa parte del lavoro. Questa checklist ti aiuta dopo ogni ciclo:
- L'app si avvia ancora? Sembra banale, ma è la sorpresa più frequente.
- I casi di accettazione sono soddisfatti? Provali tu stesso, invece di fidarti del riassunto dell'agente.
- Cosa succede nei casi di errore? Crea un contatto senza nome, inserisci un indirizzo e-mail incompleto, fissa un follow-up a una data senza senso.
- Come reagisce l'app a un'interfaccia? Se i dati arrivano dall'esterno, prova una risposta vuota, un messaggio di errore e un lungo tempo di attesa. Con un'interfaccia simulata lo fai senza rischi.
- Ci sono segreti nel codice? Chiavi di accesso e password non vanno in file che condividi.
- Sono stati modificati altri file? Git ti mostra quali file sono cambiati dall'ultimo stato salvato. Corrisponde all'incarico?
- Sai spiegare la modifica? Se riesci a dire in due frasi cosa è nuovo e perché, hai mantenuto il controllo.
Se qualcosa va storto, torni all'ultimo stato salvato e formuli l'incarico in modo più stretto. Spesso è più rapido che far correggere l'agente in più cicli.
Quali ostacoli si incontrano la prima volta?
Alcuni problemi capitano a quasi tutti i principianti. Se li conosci, ti risparmi parecchia frustrazione.
Messaggi di errore in inglese. Puoi passare un messaggio all'agente e chiedergli una spiegazione. Leggilo comunque anche tu, perché spesso la causa si trova nella prima o nell'ultima riga.
Più modifiche insieme. Se chiedi filtri, cambio di stato ed esportazione in un unico incarico, diventa quasi impossibile ricondurre un errore a una causa. Una modifica per ciclo è la regola più semplice.
Vengono adattati i test invece del codice. Può capitare che un agente riscriva un test che fallisce in modo che passi. Fai quindi attenzione quando cambiano dei file di test, mentre volevi solo correggere una funzione.
Dati reali nel progetto di apprendimento. Per i primi tentativi bastano dati di esempio. Un'app che salva i dati nel browser non è pensata per dati reali dei clienti.
Come si inserisce il corso Vibe Coding Foundation nel tuo inizio?
Il corso Vibe Coding Foundation di BUILT IN CLASS esercita proprio questo modo di lavorare su un progetto continuo: un'app per contatti e follow-up per una piccola azienda, con dati di esempio. Lavori con Claude Code o Codex e ti serve un accesso personale, i cui costi si aggiungono al prezzo del corso.
Le missioni si basano l'una sull'altra. Dopo la configurazione trasformi un'idea in un incarico chiaro, costruisci la lista dei contatti e la vista di dettaglio, aggiungi la verifica dei dati inseriti, il cambio di stato e i filtri e colleghi l'app a un'interfaccia simulata che restituisce risposte vuote, errori e tempi di attesa. Poi circoscrivi errori preparati in anticipo, verifichi i casi di accesso di base e documenti il tuo progetto in modo che altri possano avviarlo. Nella missione di trasferimento esporti i follow-up scaduti come file CSV. Tutte le missioni con i tempi previsti si trovano nella panoramica del corso, in tedesco.
Ogni missione ha criteri sotto forma di test, che verifichi sul tuo computer con un comando, e suggerimenti su tre livelli. Il protocollo IA, che in questo articolo compare come ultimo passo di ogni ciclo, lo tieni durante tutto il corso. Il tempo previsto è di circa 30 ore, per esempio sei settimane con circa cinque ore a settimana. Come si svolge l'esame scritto sul progetto è descritto nella pagina sull'esame. Chi lo supera riceve un certificato privato dell'accademia, non un titolo statale. Prezzo e prestazioni sono indicati alla voce Prezzo.