Se vuoi essere il tuo stesso capo, dovresti ritagliarti 30 minuti per te.
Perché oggi ti spiegherò come costruire un agente AI veramente funzionale in un solo pomeriggio, senza alcuna conoscenza di programmazione.
Non confondere ciò che sto per dirti con un Chatbot. Un chatbot aspetta una domanda e dà una risposta. Un agente funziona diversamente: gli dai un obiettivo, e lui stabilisce i passaggi da solo, legge file, esegue comandi e continua autonomamente fino al completamento del lavoro. Non gestisci ogni sua mossa; tracci solo la rotta.
Questa differenza è importante perché non scriverai più prompt uno per uno. Mentre ti dedichi ad altro, il lavoro procede da solo.
COSA SERVE?
Ecco tutto ciò di cui hai bisogno prima dell'installazione:
- Un piano Claude a pagamento (Pro, $20/mese, include Claude Code)
- Mac (macOS), Windows o Linux
- Internet
- 30-45 minuti di tempo libero
Non è richiesta alcuna conoscenza di programmazione. Ogni comando è scritto per intero; ti basterà copiare-incollare e premere Invio.
Non ci sono costi aggiuntivi. Non spenderai un centesimo oltre l'abbonamento.
INSTALLAZIONE: APPLICAZIONE DESKTOP, NESSUN TERMINALE
Il modo più semplice per un principiante è l'applicazione desktop. Mette tutto il potere di Claude Code nelle tue mani senza dover imparare il terminale.
Scarica l'applicazione desktop adatta al tuo sistema operativo tramite claude.ai. Su Mac, apri il file .dmg e trascina Claude nella cartella Applicazioni; su Windows, esegui il programma di installazione. Apri l'applicazione, accedi con il tuo account e clicca sulla scheda Code in alto al centro.
Se la scheda Code richiede un upgrade del piano, significa che il tuo piano attuale non include Claude Code. Se richiede un login online, completa l'accesso e riavvia l'applicazione. In entrambi i casi, ti ritroverai in uno spazio di lavoro vuoto.
Il successo a questo punto significa: una casella di prompt vuota, una scheda Code attiva e nessun messaggio di errore. Tutto ciò che costruirai d'ora in poi vivrà in quest'area.
COSA COSTRUIREMO?
Costruiremo un agente singolo e chiaro; procederemo con lo stesso agente fino alla fine dell'articolo.
Il suo compito è questo: leggerà i file di testo in una cartella, troverà quelli con titoli mancanti e scriverà un report chiamato missing-titles.txt che elenca i file da sistemare per te.
Un compito piccolo ma reale. Include le tre cose fondamentali che un agente dovrebbe fare: leggere file, prendere decisioni e scrivere output. Ed è abbastanza semplice da permetterti di verificare con i tuoi occhi se funziona o meno.
PASSO 1: IMPOSTARE LA CARTELLA DI LAVORO
Crea una cartella chiamata my-agent sul tuo desktop. L'agente lavorerà qui; potrà vedere e toccare solo l'interno di questa cartella, quindi tutto rimane al sicuro.
All'interno di my-agent, crea una seconda cartella chiamata articles. L'agente cercherà qui i file da controllare.
Crea quattro file di testo semplici all'interno di articles: post-one.txt, post-two.txt, post-three.txt, post-four.txt. Aprilne due e scrivi questo all'inizio:
Title: My Article
Lascia gli altri due completamente vuoti. Il compito dell'agente è esattamente trovare questi ultimi.
La struttura della tua cartella dovrebbe essere my-agent/articles/, contenente quattro file .txt, due con titolo e due senza.
PASSO 2: SCRIVERE IL FILE DI ISTRUZIONI CLAUDE.md
CLAUDE.md è un file di testo semplice che Claude Code legge all'inizio di ogni sessione. Pensalo come le istruzioni fisse del tuo agente, una descrizione del lavoro che non dimentica mai.
All'interno della cartella my-agent (non dentro articles), crea un nuovo file chiamato CLAUDE.md. Aprilo con qualsiasi editor di testo—Blocco note su Windows, TextEdit su Mac—e incolla esattamente questo:
# My File Check Agent ## Il Tuo Compito Controlla ogni file .txt nella cartella /articles.
## Cosa Cercare Un file valido inizia con questa riga: Title: Se la prima riga non inizia con "Title:", il titolo del file è mancante.
## Cosa Fare 1. Leggi ogni file .txt dentro /articles uno per uno. 2. Annota quali file hanno titoli mancanti. 3. Crea un file chiamato missing-titles.txt nella cartella principale. 4. Scrivi in questo file ogni nome di file che non ha superato il controllo, uno per riga. 5. Se tutti i file sono validi, scrivi "All files have titles." in missing-titles.txt.
## Cosa Non Fare Non modificare nessun file articolo. Solo leggere. Scrivere solo nel file missing-titles.txt.
Salvalo. Questo è l'intero cervello del tuo agente. Claude Code lo leggerà prima di qualsiasi altra cosa.
Il file my-agent/CLAUDE.md è stato creato e contiene le istruzioni sopra, tutto qui.
PASSO 3: PUNTARE CLAUDE CODE ALLA CARTELLA
Apri l'applicazione desktop Claude Code, clicca sull'icona della cartella o sull'opzione "Open folder" e vai alla cartella my-agent. Selezionala e conferma.
Claude Code leggerà automaticamente il tuo file CLAUDE.md. Non vedrai alcun messaggio di conferma; questo avviene silenziosamente in background ogni volta che apri una cartella.
Se stai usando un terminale, aprilo ed esegui questo comando:
cd ~/Desktop/my-agent claude
Il comando cd significa "cambia directory"; ti sposta all'interno della cartella my-agent. Digitare claude avvia la sessione da quella cartella.
PASSO 4: ESECUZIONE DELL'AGENTE
Digita esattamente questo nella casella del prompt in fondo all'interfaccia di Claude Code:
Leggi ogni file .txt nella cartella articles. Trova qualsiasi file a cui manchi una riga Title all'inizio. Scrivi i risultati in missing-titles.txt come indicato in CLAUDE.md.
Premi Invio. E guarda.
Claude Code ti mostrerà tutto ciò che fa mentre lavora: quale file legge, cosa trova in ciascuno e cosa scrive. Questa trasparenza è intenzionale. Puoi vedere ogni azione prima che accada e fermarla se qualcosa sembra strano.
Claude legge i quattro file, rileva i due senza titolo e crea il file missing-titles.txt nella tua cartella my-agent. Quando lo apri, dovresti vedere i due nomi dei file scritti uno sotto l'altro.
ERRORE PIÙ COMUNE: L'AGENTE DICE "FATTO" MA IL FILE È VUOTO
Questo di solito accade quando l'agente crea il file missing-titles.txt ma non scrive nulla al suo interno. Il motivo è quasi sempre che l'istruzione in CLAUDE.md è troppo vaga.
Soluzione: Apri CLAUDE.md e rendi le istruzioni di output più concrete. Invece di "Elenca i file", scrivi "scrivi ogni nome di file sulla propria riga, per esempio: post-two.txt." Inserire un esempio concreto nell'istruzione rende l'output concreto ogni volta.
Se l'agente scrive il nome del file sbagliato o ne salta uno, assicurati che i tuoi file articolo abbiano davvero l'estensione .txt, non .txt.txt. Questo accade spesso su Windows quando le estensioni dei file sono nascoste. Attiva "mostra estensioni file" dalle impostazioni di Esplora file e controlla.
PASSO 5: VERIFICARE ED ESPANDERE
Apri il file missing-titles.txt e verifica che quei due file che hai lasciato vuoti siano elencati. Se è corretto, significa che il tuo agente ha funzionato correttamente dall'inizio alla fine.
Ora hai un agente funzionante. Vive in my-agent, prende le sue istruzioni da CLAUDE.md e puoi eseguirlo di nuovo con lo stesso prompt quando inserisci nuovi file nella cartella articles.
Il prossimo passo logico: aggiorna CLAUDE.md e fai in modo che controlli anche se ogni file è più lungo di cinque righe. Aggiungi questo sotto l'intestazione "Cosa Cercare":
**Un file valido contiene anche contenuto più lungo di 5 righe. Se un file è lungo 5 righe o meno, segnalo anche come "troppo corto" accanto al controllo del titolo.**
Esegui di nuovo l'agente con lo stesso prompt. Ora controllerà due cose invece di una; non hai apportato modifiche al tuo prompt, è cambiato solo il file di istruzioni.
COSA HAI FATTO E PERCHÉ È IMPORTANTE?
Hai costruito un agente che legge file, prende decisioni, scrive output e fa tutto questo senza che tu supervisioni ogni passaggio. Questo è lo schema di base per ogni agente più avanzato che costruirai d'ora in poi.
La parte che scala è CLAUDE.md. Ogni nuova regola, nuovo controllo e nuovo formato di output che aggiungi lì cambia ciò che l'agente fa, senza che tu cambi il modo in cui lo esegui. Il prompt rimane lo stesso, l'istruzione si evolve.
Passi naturali da qui: controllare più tipi di file, scrivere il report in un formato diverso come CSV, o far sì che il controllo si ripeta automaticamente a intervalli regolari.
Congratulazioni, hai fatto il primo passo; il resto è nelle tue mani, proporzionale alla tua immaginazione.
Agisci prima che il divario si allarghi.
Non dimenticare di salvare e condividere, e supporta commentando.
