Come chiedere bene a Claude Code: richieste che funzionano
Claude Code legge i file da solo: non serve descrivergli la cartella. Serve dirgli ciò che non può vedere e come capirà di aver finito.
Di Gennaro Napoletano · 7 minuti di lettura
Scritto con l'aiuto dell'AI, riletto da Gennaro Napoletano.

In breve
A Claude Code conviene dire ciò che non può trovare da solo: l’obiettivo, i vincoli e il motivo. La parte più utile è la prova: un controllo che dà riuscito o fallito, così corregge da solo prima di fermarsi. Se dopo due correzioni è ancora sbagliato, conviene ripartire da capo con una richiesta migliore.
Che cosa serve dire a Claude Code, e che cosa no?
Claude Code è lo strumento di Anthropic che lavora direttamente sui tuoi file e lancia comandi. Comincia ogni compito leggendo ciò che trova: per questo non serve spiegargli com’è fatta la cartella. La documentazione lo dice in modo netto: scrivi solo ciò che non può scoprire leggendo.
| Da dire | Da non dire |
|---|---|
| Che cosa vuoi ottenere, e per chi | L’elenco dei file e delle cartelle |
| I vincoli: che cosa non deve toccare | Come si scrive il linguaggio che usi |
| Una decisione già presa, con il motivo | Regole che il codice mostra già |
| Come capirà che il lavoro è finito | Frasi di cortesia e premesse lunghe |
Un esempio inventato. Richiesta debole: «Sistema il file dei prodotti». Richiesta buona: «Nel file catalogo.csv alcuni costi usano il punto e altri la virgola. Portali tutti alla virgola, senza cambiare altre colonne. Alla fine conta le righe prima e dopo: devono essere uguali».
Quando non sai ancora bene che cosa vuoi, non serve risolverlo prima. Chiedi di farti domande: «Voglio un controllo dei margini sul catalogo, ma non ci ho ancora pensato bene. Fammi domande finché non puoi scrivere le specifiche». Per le decisioni più grosse esiste anche la modalità Plan: Claude studia e propone, senza modificare nulla.
Perché dargli una prova da lanciare?
Perché senza una prova si ferma quando il lavoro sembra finito, e il controllo resta a te. Se invece ha qualcosa che risponde riuscito o fallito, può chiudere il cerchio: modifica, lancia la prova, legge l’errore e riprova.
| Lavoro | Prova da chiedere |
|---|---|
| Riscrivere i titoli di un feed | Nessun titolo oltre 150 caratteri, stesso numero di ID |
| Unire due file di vendite | Il totale finale coincide con la somma dei due |
| Calcolare il margine | Rifare a mano il conto su tre prodotti e confrontarlo |
| Correggere una pagina | Aprirla nel browser e controllare gli errori |
Una prova vale solo se può fallire. «Ho controllato, funziona» non è una prova, e nemmeno un conteggio che non può che tornare. Chiedi di mostrarti l’esito del comando, non il suo riassunto. Sui numeri è ancora più importante: la guida su il margine di contribuzione mostra quante cose possono entrare in un conto che sembra semplice.
Ricontrollato l’8 novembre 2026 su Claude Code 2.1.319.

Che cosa può fare Claude per chi vende online
Legge file, scrive formule e cerca fonti, ma i tuoi costi non li conosce. La pagina spiega dove aiuta davvero e dove serve un controllo sui numeri.
Come si raddrizza un lavoro che prende la strada sbagliata?
Guardando il primo minuto. Nessuna impostazione sostituisce questo: la documentazione consiglia di restare lì all’inizio e di intervenire appena Claude si allontana da ciò che volevi.
- Esc lo ferma e tiene ciò che ha fatto fino a quel punto.
- /rewind, oppure Esc due volte a casella vuota, torna a un punto precedente: file, conversazione o tutti e due. Copre però solo i file modificati con i suoi strumenti di scrittura, non quelli cambiati da un comando del terminale: non sostituisce git.
- /clear ricomincia da una conversazione vuota.
- /btw fa una domanda al volo senza aggiungerla alla storia.
La regola da ricordare: dopo due correzioni sulla stessa cosa, non scriverne una terza. A quel punto la conversazione contiene due tentativi sbagliati che Claude continua a rileggere. Meglio /clear e una sola richiesta nuova, che contiene ciò che hai imparato.
Un compito alla volta, o tutto insieme?
Uno alla volta, finché i pezzi dipendono l’uno dall’altro. Tre lavori diversi nella stessa conversazione si pagano tre volte, perché ogni richiesta manda l’intera storia: il motivo è spiegato nella guida su modelli, contesto e costi.
Quando il lavoro è grande, conviene farlo in passaggi che si possono controllare: prima il piano, poi un gruppo piccolo, poi il resto. Lo stesso principio vale per i titoli di un catalogo, come spiega l’articolo su come accorciare e arricchire i titoli con l’AI: un lotto, un controllo, poi il lotto dopo.
Se invece i pezzi sono davvero indipendenti, si possono far lavorare insieme più agenti: quando conviene, e quando costa più di quanto fa risparmiare, è nella guida sui sotto-agenti.
Ciò che ripeti spesso non va riscritto ogni volta. Una preferenza che vale sempre va nel file di istruzioni del progetto, come spiega la guida su come si scrive il CLAUDE.md; una procedura che si ripete uguale diventa una skill.
A che cosa serve a chi ha un e-commerce?
Soprattutto ai lavori su file che oggi si fanno a mano o non si fanno: ripulire un catalogo, confrontare due esportazioni, cercare i prodotti senza costo, preparare un feed supplementare, controllare l’esportazione di un contenitore di Google Tag Manager.
Non conosce però i tuoi costi né i tuoi margini finché non glieli dai, e non si collega da solo ai tuoi account. Sui conti la responsabilità resta di chi li usa: un modello può sbagliare una formula con la stessa sicurezza con cui ne scrive una giusta.
Che cosa può fare per chi vende online, che cosa no e come passargli i dati è raccontato nella pagina su Claude per e-commerce. Attenzione anche a che cosa gli dai: chiavi, password e dati dei clienti non vanno scritti nei file che legge.
Domande frequenti
Devo saper programmare per usare Claude Code?
No, per i lavori su file basta saper descrivere il risultato e controllare l’esito. Serve però capire che cosa sta facendo: lancia comandi e modifica file davvero, e va usato con un backup o con git.
Quanto deve essere lunga una richiesta?
Il minimo che contiene obiettivo, vincoli e prova. Una richiesta lunga non è migliore se ripete ciò che Claude può leggere da solo.
Che cosa faccio se continua a sbagliare?
Dopo due correzioni usa /clear e riscrivi la richiesta con ciò che hai imparato. Una terza correzione aggiunge solo altri tentativi sbagliati alla conversazione.
Può modificare i miei file senza chiedere?
Dipende dalla modalità dei permessi. In Manual chiede, in Plan non modifica nulla, in Auto procede con un controllo automatico. Le regole di divieto valgono in ogni modalità.
Fonti

Gennaro Napoletano
Esperto di digital analytics e Google Tag Manager, da oltre 15 anni lavora sui dati degli e-commerce. Nel 2023 Google lo ha invitato nella sua sede di Dublino per i risultati di alcuni e-commerce gestiti da lui. Ha realizzato il portale di marginalità per e-commerce e aiuta aziende e agenzie a fidarsi dei propri numeri. Scopri chi è.
Continua a leggere
CLAUDE.md: che cos’è e come si scrive un file che funziona
Il file di istruzioni di Claude Code: dove metterlo, che cosa scriverci, quanto può essere lungo e perché una regola scritta lì non è ancora un divieto.
Errori comuni di Claude Code: da dove partire e come risolverli
Istruzioni ignorate, skill che non partono, limiti raggiunti, ripristini falliti, server MCP che non rispondono: i comandi per capire che cosa succede.
Claude Code: come scegliere il modello e spendere meno
Quale modello e quale impegno scegliere, che cos’è il contesto, quando usare /clear o /compact e dove si vede il consumo di Claude Code.
Dai file ai tuoi numeri
Che cosa può fare Claude per chi vende online
Legge file, scrive formule e cerca fonti, ma i tuoi costi non li conosce. Ecco dove aiuta davvero, dove no e come passargli i dati.