Come scrivere un prompt efficace per Claude: la guida pratica

Molti consigli su Claude ruotano intorno a un trucco: metti tutto dentro tag XML, perché è stato addestrato per questo. Non è esatto. La documentazione di Anthropic precisa che non esistono tag canonici con cui Claude sarebbe stato addestrato in modo specifico, e una sua guida recente spiega che titoli chiari e frasi esplicite bastano nella maggior parte dei casi.

I tag hanno la loro utilità, ci arriviamo. Ma se il tuo prompt dà risultati scadenti, la causa si trova di rado nell'impaginazione. Si trova in ciò che hai dimenticato di dire.

Il test del collega che arriva stamattina

Anthropic propone un'immagine utile: tratta Claude come un dipendente brillante ma appena arrivato, che non conosce le tue abitudini né il tuo mestiere. E un test semplice: mostra il tuo prompt a un collega che non sa niente dell'argomento. Se lui non sa che cosa fare, nemmeno Claude lo sa.

Prendi la responsabile di un'associazione che scrive: «Riassumi questa domanda di finanziamento.» Un collega chiederebbe subito per chi, a quale scopo e di che lunghezza. Claude tirerà a indovinare e restituirà un riassunto neutro che non servirà a nessuno in particolare.

La versione corretta sta in poche righe:

Leggerai la domanda di finanziamento in allegato. Verrà presentata martedì al nostro consiglio direttivo, composto da volontari che non hanno letto la domanda e hanno cinque minuti per decidere se la inviamo.

Scrivi una nota di mezza pagina che permetta loro di decidere:
- che cosa finanzierebbe il contributo e il suo importo
- che cosa si impegna a fare l'associazione in cambio
- le condizioni difficili da rispettare per noi
- i documenti che ci mancano, se ne mancano

Scrivi con frasi brevi, senza linguaggio burocratico. Se un'informazione non compare nella domanda, dillo invece di supporla.

Il fatto che sia una nota per il consiglio, il tempo di lettura e la decisione da prendere danno a Claude tutto ciò che mancava. Ora può selezionare il contenuto della domanda in base a ciò che conta per quei lettori.

Claude tende anche a restare entro ciò che gli viene chiesto. Anthropic lo dice chiaramente: se vuoi che vada oltre lo stretto necessario, chiedilo in modo esplicito. Se vuoi tre piste alternative o una critica del tuo piano, scrivilo. Non contare sul fatto che lo faccia da solo.

Spiega perché chiedi una cosa

È uno dei riflessi più redditizi con Claude. Un'istruzione da sola viene applicata alla lettera. Un'istruzione accompagnata dalla sua ragione viene applicata con discernimento, anche ai casi che non avevi previsto.

Senza ragione: «Niente puntini di sospensione.»

Con la ragione, sul modello dell'esempio di Anthropic: «Questo testo sarà letto ad alta voce da una sintesi vocale, che non sa pronunciare i puntini di sospensione.»

Nel secondo caso Claude capisce l'esigenza reale e può evitare anche abbreviazioni, simboli o parentesi lette male, che non avevi menzionato.

Un esempio tratto da un altro mestiere. Una maestra di quinta elementare chiede un testo di lettura. L'istruzione «frasi brevi» produce frasi spezzettate. Se scrive «due alunni della mia classe sono dislessici e si scoraggiano davanti alle frasi con più proposizioni», Claude ha di che regolare la sintassi senza rompere il ritmo della storia.

Quando puoi, formula le istruzioni anche in positivo. Anthropic consiglia di descrivere ciò che vuoi piuttosto che ciò che rifiuti: «Scrivi in paragrafi continui» dà un bersaglio, mentre «niente elenchi» ne toglie soltanto uno. Quando ti serve un divieto, tienilo, ma fallo seguire da ciò che bisogna fare al suo posto.

Quando i tag XML servono e quando farne a meno

Un tag XML è un'etichetta attorno a un pezzo di testo: <appunti> all'inizio, </appunti> alla fine. Scegli i nomi che vuoi, anche in italiano se preferisci. I tag servono a una cosa sola: separare senza ambiguità le tue istruzioni dal contenuto da elaborare.

Per una domanda semplice non metterli. Per un testo breve da riformulare, basta un titolo o un'andata a capo. Diventano utili quando il tuo prompt mescola più tipi di contenuto, soprattutto quando i documenti da elaborare contengono a loro volta testo che somiglia a un'istruzione. È il caso dell'e-mail di un cliente che dice «la prego di rispondere entro venerdì»: non vuoi che Claude scambi quella frase per un'istruzione rivolta a lui.

Ecco un caso in cui sono giustificati, per un condomino del consiglio di condominio che deve confrontare dei preventivi:

<contesto>
Faccio parte del consiglio di condominio di un edificio di 24 unità. Dobbiamo rifare l'impermeabilizzazione del lastrico solare. Il voto ci sarà alla prossima assemblea condominiale e i condòmini vorranno capire la differenza di prezzo.
</contesto>

<preventivi>
<preventivo_1 azienda="[NOME 1]">
[INCOLLA IL PREVENTIVO]
</preventivo_1>
<preventivo_2 azienda="[NOME 2]">
[INCOLLA IL PREVENTIVO]
</preventivo_2>
<preventivo_3 azienda="[NOME 3]">
[INCOLLA IL PREVENTIVO]
</preventivo_3>
</preventivi>

<istruzioni>
1. Prepara una tabella che confronti ciò che ogni preventivo include davvero: lavorazioni, materiali, garanzie, tempi, condizioni di pagamento.
2. Segnala ciò che compare in un preventivo e manca negli altri, senza concludere che si tratti di una dimenticanza.
3. Elenca le domande da porre a ogni azienda prima del voto.
Non raccomandare nessuna azienda. Se un elemento non è precisato in un preventivo, scrivi «non specificato».
</istruzioni>

I dati sono messi prima delle istruzioni, e il motivo sta nella sezione successiva.

Con i documenti lunghi, metti la richiesta alla fine

Per i contenuti lunghi, la documentazione di Anthropic raccomanda di collocare i documenti in cima al prompt e la domanda in fondo, e di marcare con tag ogni documento quando ce n'è più di uno, indicandone la fonte. Una guida più generale aggiunge di tenere le informazioni più importanti all'inizio o alla fine, e di spezzare i compiti grossi: il modello lavora meglio su un perimetro netto.

Non chiedere tutto in una volta nemmeno qui. Per un rapporto di 60 pagine, comincia facendo estrarre i passaggi che riguardano la tua domanda, con la loro pagina o sezione, poi fai ragionare Claude su quegli estratti. Potrai controllare il primo passaggio, cosa impossibile se tutto arriva fuso in una sintesi. L'articolo sui documenti lunghi approfondisce questo lavoro in due tempi.

Claude può anche sbagliarsi su un documento che gli hai dato: attribuire male una cifra, leggere troppo in fretta una tabella proveniente da un PDF. Per tutto ciò che impegna denaro o una decisione, chiedi la citazione esatta del passaggio che giustifica ogni affermazione e controllala nell'originale. Questo riflesso vale per tutti gli assistenti, compreso questo, ed è spiegato nella guida su come verificare una risposta dell'IA.

Mostra un esempio prima di aggiungere regole

Anthropic mette gli esempi tra i mezzi più affidabili per orientare formato, tono e struttura. Una sua guida consiglia di cominciare con un solo esempio e di aggiungerne se i risultati restano irregolari; la sua documentazione tecnica cita piuttosto da tre a cinque esempi per gli usi più esigenti. Tieni a mente questo: parti in piccolo e aumenta se serve.

Scegli bene i tuoi esempi, perché Claude vi presta grande attenzione e può riprodurne perfino i difetti. Se il tuo esempio contiene una formula vuota, la ritroverai ovunque. Variali anche: con tre esempi che cominciano allo stesso modo, otterrai lo stesso inizio su tutti i testi.

Per uno sviluppatore che vuole riscontri regolari nelle revisioni del codice, il prompt combina quindi formato, esempio e motivazione:

Fai la revisione del diff qui sotto. Sono solo su questo progetto e correggerò io stesso le tue osservazioni stasera: voglio quindi soltanto ciò che può rompersi in produzione, non questioni di gusto.

<diff>
[INCOLLA IL DIFF]
</diff>

Per ogni problema, usa questo formato:

<esempio>
**File:** carrello.py, riga 42
**Rischio:** se il carrello è vuoto, `prezzo_totale` non è definito e la pagina va in errore.
**Scenario:** un cliente toglie l'ultimo articolo e poi ricarica la pagina.
**Correzione proposta:** inizializzare `prezzo_totale = 0` prima del ciclo.
</esempio>

Ordina i problemi dal più grave al meno grave. Se non ne trovi nessuno serio, dillo e fermati lì: non inventare osservazioni per riempire. Segnala ciò che non hai potuto valutare senza vedere il resto del codice.

La frase «dillo e fermati lì» conta. Senza questa via d'uscita, qualunque assistente a cui si chiedono dei problemi tende a trovarne.

Sui ruoli, il consiglio di Anthropic è misurato: una frase può bastare a orientare il tono, ma un ruolo molto pesante apporta di rado qualcosa e può limitare l'utilità della risposta. Spesso è più efficace precisare direttamente il punto di vista atteso. «Analizza questo budget dal punto di vista di una responsabile prudente che rifiuta qualsiasi scoperto» vale più di tre righe sui suoi anni di esperienza.

Metti le istruzioni al posto giusto in Claude

I menu e i nomi cambiano e dipendono dal tuo piano, quindi verifica nello strumento nel momento in cui leggi questo articolo. Ecco la logica generale.

Per le skill, cura la descrizione più di tutto il resto: secondo la documentazione di Anthropic, Claude legge soltanto il nome e la descrizione prima di decidere se caricare la skill. «Aiuto per i preventivi» si attiverà male. «Da usare quando chiedo di preparare o rileggere un preventivo di idraulica» si attiverà molto meglio.

Lo stesso principio di ambito vale per le tue istruzioni. Il profilo riceve ciò che è sempre vero, un progetto riceve ciò che riguarda una pratica, una skill riceve ciò che descrive una procedura. Metti tutto nel profilo e le tue conversazioni di ogni giorno porteranno un peso inutile. L'articolo sulle istruzioni di sistema aiuta a fare ordine.

La memoria si riempie con l'uso, e puoi consultarla e modificarla. Una conversazione in incognito non viene usata per migliorare Claude, anche se quell'impostazione è attiva nei tuoi parametri di privacy: guarda queste opzioni prima di incollare qualsiasi cosa di sensibile e consulta le condizioni del tuo piano.

Claude, inoltre, non produce foto o illustrazioni come fanno i generatori di immagini. Sa creare schemi, grafici e contenuti visivi interattivi, e sa analizzare le immagini che gli invii. Se la tua esigenza riguarda l'immagine, il confronto ChatGPT, Claude o Gemini ti orienterà.

Fagli rileggere il tuo prompt, non solo il tuo testo

Prima di lanciare un prompt importante, chiedi a Claude di mettersi al posto di chi lo esegue. Spesso evita diversi tentativi:

Ecco un prompt che userò regolarmente:

<prompt_da_rileggere>
[INCOLLA IL TUO PROMPT]
</prompt_da_rileggere>

Non eseguirlo. Dimmi:
1. Che cosa avresti capito male o dovuto supporre
2. Le informazioni mancanti per svolgere bene il lavoro
3. Il caso reale in cui questo prompt darebbe il risultato peggiore
Poi proponi una versione corretta, segnalando ogni modifica e il suo motivo.

Anthropic propone anche strumenti di questo tipo nella sua console per sviluppatori, ma questo prompt funziona nell'applicazione normale. Rileggi comunque i suoi suggerimenti con occhio critico: un prompt più lungo non è necessariamente migliore, e il tuo mestiere lo conosci meglio di lui.

Prova subito sul prompt che usi di più. Aggiungi una frase che spieghi a che cosa serve il risultato e chi lo leggerà, poi confronta con la tua versione abituale.