Costruisci il tuo Agente AI con Claude Code: guida pratica in 10 minuti (Zero Codice)

Arriva sempre quel momento. Apri il portatile, guardi la lista delle cose da fare e provi una fitta di stanchezza. Le attività sono esattamente le stesse di sette giorni fa: cercare informazioni sparse, riordinare appunti, sistemare report noiosi e riscrivere le stesse istruzioni al computer per l’ennesima volta. Non è un lavoro difficile, è un lavoro meccanico. Ti ruba energie mentali e tempo prezioso.

Fino a poco tempo fa, per liberarti di questa ruota del criceto l’unica strada era imparare a programmare, passando notti a litigare con script Python, server, API e debugging. Oggi la situazione è cambiata. Esistono strumenti che ti permettono di costruire un assistente digitale su misura, capace di seguire le tue regole e alleggerirti la giornata, anche se non hai mai scritto una riga di codice in vita tua.

Mettiamo da parte le esagerazioni e le finte promesse da social network, e guardiamo ai fatti. In questa guida per La Scienza dei Dati, vedremo come usare Claude Code per configurare un sistema che lavora per te, in modo concreto e realistico.

Prima di iniziare: cos’è davvero un agente AI?

La parola “agente” è diventata una delle più abusate di questo 2026. Sui social capita spesso di vedere narrazioni molto ottimistiche sugli agenti AI completamente autonomi che gestiscono l’azienda e fatturano milioni mentre voi bevete un mojito in spiaggia.

La realtà è molto meno spettacolare, ma infinitamente più utile.

Nel senso pratico e tecnico del termine, un agente AI non è una mente senziente, ma un sistema configurato per eseguire attività secondo regole definite, interagendo con il tuo ambiente (i tuoi file, il tuo browser, i tuoi documenti). Può raccogliere informazioni, sintetizzare dati, creare bozze e, soprattutto, mantenere un contesto operativo coerente.

La differenza rispetto a un normale ChatGPT o Claude su interfaccia web è enorme: un chatbot risponde a richieste isolate e poi dimentica; un agente segue un processo integrato nel tuo spazio di lavoro.

Reality check: “senza codice” non significa “senza apprendimento”

Quando si parla di Claude Code, spesso si sente dire che basta un click per avere un dipendente digitale. Zero codice non significa zero complessità. Significa, piuttosto, meno attrito tecnico.

Non dovrai configurare server AWS, ma dovrai comunque capire come strutturare istruzioni efficaci (prompt engineering), definire workflow precisi, fare test, correggere errori e migliorare il sistema. Il livello di difficoltà è paragonabile all’ottimizzazione di un processo aziendale: devi sapere cosa vuoi ottenere prima di chiedere alla macchina di farlo.

1. Installare Claude Code: la base del sistema

Il primo passo per trasformare l’AI in un collaboratore operativo è l’installazione. Claude Code non è solo un’interfaccia web, ma un tool che “vive” nel tuo computer.

• Terminale (macOS, Linux, WSL): Questa è la soluzione più diretta e potente, ideale per chi gestisce dati o lavora con directory strutturate. Per installarlo, avendo Node.js già presente sul sistema, ti basta aprire il terminale e digitare un singolo comando:

  npm install -g @anthropic-ai/claude-code

• App Desktop: La scelta più semplice per chi preferisce un’interfaccia grafica e non vuole vedere la riga di comando.

• Estensione per Editor: Se usi VS Code o Cursor, integrare Claude direttamente nell’ambiente dove scrivi o analizzi dati lo rende una presenza costante e invisibile nel tuo workflow.

Prendiamo Giulia, che gestisce il nostro blog di divulgazione su data science e intelligenza artificiale. Ogni lunedì Giulia perde tre ore della sua vita a fare copia-incolla tra schede del browser e fogli di testo per cercare trend, un’operazione che deprime la sua creatività prima ancora di iniziare a scrivere. Installa Claude Code tramite terminale con un solo obiettivo: ridurre il tempo di ricerca preliminare. Niente fantascienza, solo un problema da risolvere.

2. Creare il contesto: il file CLAUDE.md

Uno dei limiti classici degli assistenti AI è l’amnesia. Ogni nuova chat ricomincia da zero. Devi rispiegare il tono, reimpostare l’obiettivo, ricordargli le tue preferenze.

Claude Code introduce una soluzione brillante nella sua semplicità: il file CLAUDE.md.

Si tratta di un normale file di testo Markdown che devi salvare nella root (cartella principale) del tuo progetto. Ogni volta che avvii Claude Code in quella cartella, lui leggerà automaticamente questo file prima di fare qualsiasi cosa, assorbendo le tue direttive.

Ecco un esempio pratico e realistico per il blog di Giulia:

# RUOLO
Sei l'assistente editoriale per un blog italiano di Data Science e AI.

# TONO DI VOCE
Chiaro, concreto, tecnico ma accessibile. Evita il tono accademico noioso.

# REGOLE EDITORIALI
- Evita sempre gergo tecnico non spiegato (es. se citi RAG, spiega cos'è).
- Usa esempi pratici legati al mondo aziendale o della ricerca.
- Formatta i testi in Markdown pulito, usando bold per i concetti chiave.

# PAROLE DA EVITARE ASSOLUTAMENTE
- "Rivoluzionario"
- "Game changer"
- "Disruption"
- "Nel vasto mondo di..."

Questo passaggio trasforma un modello linguistico generico (che parla come un robot) in un sistema calibrato millimetricamente sul tuo stile.

3. Cosa è nativo e cosa va configurato?

Per evitare frustrazioni, è vitale capire cosa il tool fa da solo e cosa devi costruirgli attorno. Claude Code non nasce come “agenzia autonoma”, lo diventa se imposti i giusti paletti.

4. Dare memoria persistente al sistema

Come visto nella tabella, la memoria “infinita” non è nativa. Se correggi un comportamento a voce, domani l’AI potrebbe dimenticarlo. Con Claude Code puoi però simulare una memoria persistente strutturata.

Se durante il lavoro noti che l’AI fa un errore ricorrente (ad esempio, usa elenchi puntati dove tu preferisci testo narrativo), puoi semplicemente dirgli:

“Claude, da oggi non usare mai elenchi puntati nelle parti narrative. Salva questa preferenza nel file CLAUDE.md sotto la sezione REGOLE.”

Se gli concedi permessi in scrittura e il workflow è configurato correttamente, Claude può aggiornare automaticamente il file di contesto.. Non è memoria umana, è un manuale operativo che si auto-aggiorna in base ai tuoi feedback, garantendo nel tempo zero ripetizioni e consistenza assoluta.

5. Costruire “Skill” riutilizzabili

Invece di riscrivere un prompt lunghissimo ogni lunedì, puoi creare delle procedure standard, vere e proprie “Skill”. Operativamente, il modo migliore per farlo senza programmare è creare una cartella chiamata skills nel tuo progetto, e dentro inserirvi dei file di testo (es. ricerca_trend.txt, sintesi_paper.txt).

Esempio di file ricerca_trend.txt:

Obiettivo: Analizzare le fonti fornite e restituire un report strutturato.

1. Identifica i 3 trend principali.

2. Estrai un insight per ogni trend.

3. Proponi un angolo editoriale critico per il pubblico italiano.

Quando Giulia inizia a lavorare, le basta aprire Claude Code e scrivere: “Esegui la procedura descritta in skills/ricerca_trend.txt sui documenti scaricati oggi”.

Questo elimina il lavoro ripetitivo della delega. Diventa un’esecuzione a comando di un workflow rodato.

6. Automazione delle Routine: Creare un’Abitudine Digitale

Spesso si rischia di confondere una “Skill” con una “Routine”. Se la skill è la capacità tecnica di eseguire un compito (ad esempio, saper estrarre dati da un file PDF), la routine è il processo sistematico che stabilisce quando, in quale ordine e con quale frequenza queste capacità devono essere attivate.

Nello scenario no-code, trasformare le tue abitudini in routine per l’agente AI significa creare un binario fisso e automatico. Non devi più pensare a cosa chiedere ogni mattina; l’agente sa già cosa fare non appena rileva un determinato trigger.

Per Giulia, la routine del lunedì mattina si traduce in un file chiamato routine_inizio_settimana.md salvato nella cartella del progetto.

Al suo interno, le istruzioni sono puramente procedurali e sequenziali:

# ROUTINE DI INIZIO SETTIMANA
Esegui questi passaggi in ordine ogni volta che viene attivata questa routine:

1. Controlla la cartella `/input` per verificare la presenza di nuovi articoli salvati negli ultimi 7 giorni.
2. Se ci sono nuovi file, applica la skill `skills/ricerca_trend.txt` per estrarre i temi caldi.
3. Prendi l'output generato e usalo per aggiornare il file principale `calendario_editoriale.md`, inserendo le nuove idee in fondo alla tabella.
4. Crea un file di log chiamato `completato_[DATA].txt` con un brevissimo riassunto delle attività svolte per informarmi della fine del processo.

Il vero trucco no-code per rendere questo meccanismo immediato è l’uso degli alias del terminale (scorciatoie veloci).

Senza saper programmare, puoi impostare una parola chiave nel tuo computer in modo che, digitando semplicemente avvia-giornata, il terminale apra Claude Code e gli dia in pasto direttamente il file della routine.

Mentre tu ti allontani dalla scrivania per prendere un caffè, l’agente si sveglia, analizza la directory, applica il contesto globale, esegue le tre fasi di elaborazione e ti fa trovare il calendario aggiornato al tuo ritorno. La routine elimina la fatica mentale di dover guidare l’AI passo dopo passo.

Approfondimento (facoltativo): automatizzare l’avvio con un alias

Per chi si definisce “no-code”, la parola terminale può mettere ansia. In realtà, creare un alias (una scorciatoia) è l’equivalente digitale di impostare una scelta rapida sulla tastiera dello smartphone. Non stai programmando: stai solo dicendo al tuo computer: “Quando digito questa parola corta, tu esegui questo comando lungo”.

Ecco come fare, passo dopo passo, sia su Mac (macOS) che su Windows.

Su macOS (e Linux)

Il Mac usa un file nascosto nella tua cartella utente che si chiama .zshrc. È la lista delle impostazioni del tuo terminale. Per aggiungere la tua scorciatoia senza toccare una riga di codice complessa, segui questi passaggi:

1. Apri il Terminale

Puoi cercarlo con Spotlight (Cmd + Spazio) digitando “Terminale”.

2. Aggiungi l’alias con un comando copia-incolla

Immaginiamo che la cartella del tuo progetto si trovi in Documenti/Blog. Vogliamo fare in modo che digitando avvia-giornata, il Mac apra quella cartella e avvii la routine di Claude Code.

Incolla questo comando nel terminale e premi Invio (sostituisci il percorso della cartella con il tuo):

echo "alias avvia-giornata='cd ~/Documenti/Blog && claude --execute routine_inizio_settimana.md'" >> ~/.zshrc

Cosa fa questo comando?

• echo “…” >> ~/.zshrc prende il testo tra virgolette e lo scrive in fondo al file delle impostazioni.

• cd ~/Documenti/Blog dice al computer di spostarsi nella cartella corretta.

• && claude –execute… dice di avviare immediatamente Claude Code eseguendo il file della tua routine.

3. Attiva la modifica

Per fare in modo che il terminale digerisca la novità senza dover riavviare il Mac, digita questo ultimo comando:

source ~/.zshrc

Fatto. Da adesso in poi, ogni lunedì ti basterà aprire il terminale, digitare avvia-giornata e guardare Claude che lavora al posto tuo.

Su Windows (Prompt dei comandi / PowerShell)

Su Windows il modo più pulito e “no-code” per fare la stessa cosa senza impazzire con i file di configurazione di PowerShell è creare un piccolissimo file Batch (.bat). Tecnicamente non è un alias del terminale, ma l’effetto pratico è identico: un’icona su cui fare doppio click per lanciare l’agente.

1. Apri il Blocco Note (Notepad)

Apri il classico Blocco Note di Windows.

2. Incolla le istruzioni

Scrivi queste tre righe, personalizzando il percorso della cartella in cui si trova il tuo progetto (es. C:\Utenti\Giulia\Documenti\Blog):

@echo off
cd "C:\Utenti\Giulia\Documenti\Blog"
claude --execute routine_inizio_settimana.md
pause

Cosa significano?

• @echo off serve solo a tenere pulita la schermata.

• cd “…” sposta Windows nella cartella del blog.

• claude –execute… lancia la routine di Claude Code.

• pause evita che la finestra si chiuda di colpo alla fine, così puoi leggere il report di Claude.

La sintassi può variare in base alla versione del tool: consulta sempre la documentazione aggiornata di Claude Code

3. Salva sul Desktop come “.bat”

• Vai su File > Salva con nome.

• Scegli come destinazione il tuo Desktop.

• In Salva come, seleziona “Tutti i file (.)” (fondamentale, altrimenti creerà un file di testo inutile).

• Nome del file: avvia-giornata.bat.

Da questo momento, il lunedì mattina non dovrai nemmeno aprire il terminale. Ti basterà fare doppio click sull’icona avvia-giornata sul tuo Desktop per attivare il tuo agente AI mentre vai a prenderti il caffè.

7. Creare piccoli team di agenti AI (Workflow Modulari)

Una volta padroneggiate le routine e le skill singole, il passo successivo è concatenarle. Non pensare a entità coscienti che parlano tra loro, pensa a workflow modulari specializzati, simili alle fasi di una catena di montaggio intellettuale.

Puoi organizzare il tuo lavoro chiedendo a Claude di agire in sequenza assumendo “cappelli” diversi all’interno della stessa routine:

• Fase 1 (Il Ricercatore): “Leggi i paper nella cartella /fonti ed estrai solo i dati statistici rilevanti nel file dati_grezzi.md”

• Fase 2 (Lo Scrittore): “Usa i dati in dati_grezzi.md per scrivere una prima bozza dell’articolo, seguendo le direttive del CLAUDE.md”

• Fase 3 (Il Revisore): “Agisci da editor severo. Leggi la bozza e segnalami se ho usato un tono troppo entusiastico o se ci sono fallacie logiche.”

Dividere i task riduce drasticamente le “allucinazioni” (invenzioni di dati) dell’AI, perché il modello si concentra su un’operazione piccola e definita alla volta.

8. Cosa succede quando l’AI sbaglia?

Domanda fondamentale per chi lavora con i dati: l’AI sbaglierà. Sempre. La resilienza del tuo sistema non si misura dalla perfezione iniziale, ma da come gestisce l’errore.

La regola d’oro dei workflow agentici è Human-in-the-loop (l’umano nel ciclo). Costruisci sistemi dove l’AI si ferma in momenti chiave.

Invece di chiedere: “Scrivi l’intero articolo e pubblicalo”, inserisci nella tua routine un comando di stop:

“Prepara l’outline, salvalo e fermati. Attendi la mia approvazione per procedere alla scrittura”.

Gli agenti migliori non sono quelli che lavorano da soli nel buio. Sono quelli configurati per fare il lavoro pesante e poi restituirti il controllo per la decisione finale e il controllo qualità.

Conclusione: Il Vantaggio è il Tempo Recuperato

Gli agenti AI sono strumenti potentissimi nella sintesi, nell’organizzazione, nella gestione dei volumi e nella velocità operativa. Restano però deboli (se non totalmente inadeguati) nell’intuizione strategica, nel giudizio complesso e nella vera creatività originale.

L’AI può preparare i dati grezzi, ma la direzione analitica resta umana. Può strutturare un report in cinque secondi, ma la decisione strategica spetta a te.

Non cercare di costruire il “mega agente definitivo” il primo giorno. Inizia creando la tua cartella, scrivi il tuo file CLAUDE.md, automatizza una singola routine noiosa del tuo lunedì mattina. Migliora il processo la settimana successiva.

L’AI non prenderà magicamente il tuo posto di lavoro. Ma un professionista che sa delegare la noia a questi sistemi prenderà, senza dubbio, il posto di chi si ostina testardamente a fare tutto a mano. La tecnologia ora è alla portata di tutti, senza bisogno di scrivere codice.

La scelta di usarla, da oggi, è solo tua.