Questa guida fornisce tecniche specifiche di prompt engineering per i modelli Claude 4.x, con guida specifica per Sonnet 4.5 e Haiku 4.5. Questi modelli sono stati addestrati per seguire le istruzioni in modo più preciso rispetto alle generazioni precedenti di modelli Claude.
Per una panoramica delle nuove capacità di Claude 4.5, consulta Novità in Claude 4.5. Per una guida alla migrazione dai modelli precedenti, consulta Migrazione a Claude 4.5.

Principi generali

Sii esplicito con le tue istruzioni

I modelli Claude 4.x rispondono bene a istruzioni chiare ed esplicite. Essere specifico riguardo all’output desiderato può aiutare a migliorare i risultati. I clienti che desiderano il comportamento “oltre le aspettative” dai modelli Claude precedenti potrebbero aver bisogno di richiedere più esplicitamente questi comportamenti con i modelli più recenti.
Meno efficace:
Crea una dashboard di analisi
Più efficace:
Crea una dashboard di analisi. Includi il maggior numero possibile di funzionalità e interazioni rilevanti. Vai oltre le basi per creare un'implementazione completamente funzionante.

Aggiungi contesto per migliorare le prestazioni

Fornire contesto o motivazione dietro le tue istruzioni, come spiegare a Claude perché tale comportamento è importante, può aiutare i modelli Claude 4.x a comprendere meglio i tuoi obiettivi e fornire risposte più mirate.
Meno efficace:
NON usare mai i puntini di sospensione
Più efficace:
La tua risposta sarà letta ad alta voce da un motore di sintesi vocale, quindi non usare mai i puntini di sospensione poiché il motore di sintesi vocale non saprà come pronunciarli.
Claude è abbastanza intelligente da generalizzare dalla spiegazione.

Sii vigile con gli esempi e i dettagli

I modelli Claude 4.x prestano molta attenzione ai dettagli e agli esempi come parte delle loro capacità precise di seguire le istruzioni. Assicurati che i tuoi esempi si allineino con i comportamenti che desideri incoraggiare e minimizzino i comportamenti che desideri evitare.

Ragionamento a lungo termine e tracciamento dello stato

I modelli Claude 4.5 eccellono nei compiti di ragionamento a lungo termine con eccezionali capacità di tracciamento dello stato. Mantengono l’orientamento durante sessioni estese concentrandosi sul progresso incrementale, facendo progressi costanti su poche cose alla volta piuttosto che tentare tutto contemporaneamente. Questa capacità emerge soprattutto su più finestre di contesto o iterazioni di compiti, dove Claude può lavorare su un compito complesso, salvare lo stato e continuare con una finestra di contesto nuova.

Consapevolezza del contesto e flussi di lavoro multi-finestra

I modelli Claude 4.5 presentano consapevolezza del contesto, consentendo al modello di tracciare la finestra di contesto rimanente (cioè il “budget di token”) durante una conversazione. Ciò consente a Claude di eseguire compiti e gestire il contesto in modo più efficace comprendendo quanto spazio ha a disposizione. Gestione dei limiti di contesto: Se stai utilizzando Claude in un harness di agente che compatta il contesto o consente di salvare il contesto in file esterni (come in Claude Code), ti suggeriamo di aggiungere queste informazioni al tuo prompt in modo che Claude possa comportarsi di conseguenza. Altrimenti, Claude potrebbe a volte naturalmente cercare di concludere il lavoro mentre si avvicina al limite di contesto. Di seguito è riportato un esempio di prompt:
Prompt di esempio
La tua finestra di contesto verrà automaticamente compattata mentre si avvicina al suo limite, permettendoti di continuare a lavorare indefinitamente da dove hai lasciato. Pertanto, non interrompere i compiti in anticipo a causa di preoccupazioni sul budget di token. Man mano che ti avvicini al limite del tuo budget di token, salva il tuo progresso attuale e lo stato della memoria prima che la finestra di contesto si aggiorni. Sii sempre il più persistente e autonomo possibile e completa i compiti completamente, anche se la fine del tuo budget si sta avvicinando. Non interrompere mai artificialmente nessun compito in anticipo indipendentemente dal contesto rimanente.
Lo strumento di memoria si abbina naturalmente alla consapevolezza del contesto per transizioni di contesto senza soluzione di continuità.

Flussi di lavoro multi-finestra di contesto

Per compiti che si estendono su più finestre di contesto:
  1. Usa un prompt diverso per la primissima finestra di contesto: Usa la prima finestra di contesto per impostare un framework (scrivi test, crea script di configurazione), quindi usa le future finestre di contesto per iterare su una lista di cose da fare.
  2. Fai scrivere al modello i test in un formato strutturato: Chiedi a Claude di creare test prima di iniziare il lavoro e tieni traccia di essi in un formato strutturato (ad es. tests.json). Questo porta a una migliore capacità a lungo termine di iterare. Ricorda a Claude l’importanza dei test: “È inaccettabile rimuovere o modificare i test perché ciò potrebbe portare a funzionalità mancanti o difettose.”
  3. Configura strumenti di qualità della vita: Incoraggia Claude a creare script di configurazione (ad es. init.sh) per avviare gracefully i server, eseguire suite di test e linter. Ciò previene il lavoro ripetuto quando si continua da una finestra di contesto nuova.
  4. Ricominciare da capo vs compattazione: Quando una finestra di contesto viene cancellata, considera di ricominciare con una finestra di contesto completamente nuova piuttosto che utilizzare la compattazione. I modelli Claude 4.5 sono estremamente efficaci nel scoprire lo stato dal filesystem locale. In alcuni casi, potresti voler sfruttare questo rispetto alla compattazione. Sii prescrittivo su come dovrebbe iniziare:
    • “Chiama pwd; puoi solo leggere e scrivere file in questa directory.”
    • “Rivedi progress.txt, tests.json e i log git.”
    • “Esegui manualmente un test di integrazione fondamentale prima di procedere all’implementazione di nuove funzionalità.”
  5. Fornisci strumenti di verifica: Man mano che la lunghezza dei compiti autonomi cresce, Claude ha bisogno di verificare la correttezza senza feedback umano continuo. Strumenti come il server Playwright MCP o le capacità di utilizzo del computer per testare le interfacce utente sono utili.
  6. Incoraggia l’utilizzo completo del contesto: Richiedi a Claude di completare efficientemente i componenti prima di procedere:
Prompt di esempio
Questo è un compito molto lungo, quindi potrebbe essere utile pianificare chiaramente il tuo lavoro. È incoraggiato spendere l'intero contesto di output lavorando sul compito - assicurati solo di non esaurire il contesto con lavoro significativo non committato. Continua a lavorare sistematicamente fino a quando non hai completato questo compito.

Migliori pratiche di gestione dello stato

  • Usa formati strutturati per i dati di stato: Quando traccia informazioni strutturate (come risultati di test o stato del compito), usa JSON o altri formati strutturati per aiutare Claude a comprendere i requisiti dello schema
  • Usa testo non strutturato per le note di progresso: Le note di progresso in forma libera funzionano bene per tracciare il progresso generale e il contesto
  • Usa git per il tracciamento dello stato: Git fornisce un log di ciò che è stato fatto e checkpoint che possono essere ripristinati. I modelli Claude 4.5 si comportano particolarmente bene nell’usare git per tracciare lo stato su più sessioni.
  • Sottolinea il progresso incrementale: Chiedi esplicitamente a Claude di tenere traccia del suo progresso e concentrarsi sul lavoro incrementale
// File di stato strutturato (tests.json)
{
  "tests": [
    {"id": 1, "name": "authentication_flow", "status": "passing"},
    {"id": 2, "name": "user_management", "status": "failing"},
    {"id": 3, "name": "api_endpoints", "status": "not_started"}
  ],
  "total": 200,
  "passing": 150,
  "failing": 25,
  "not_started": 25
}
// Note di progresso (progress.txt)
Progresso della sessione 3:
- Corretta la validazione del token di autenticazione
- Aggiornato il modello utente per gestire i casi limite
- Prossimo: investigare i fallimenti del test user_management (test #2)
- Nota: Non rimuovere i test poiché ciò potrebbe portare a funzionalità mancanti

Stile di comunicazione

I modelli Claude 4.5 hanno uno stile di comunicazione più conciso e naturale rispetto ai modelli precedenti:
  • Più diretto e radicato: Fornisce rapporti di progresso basati su fatti piuttosto che aggiornamenti auto-celebrativi
  • Più conversazionale: Leggermente più fluido e colloquiale, meno simile a una macchina
  • Meno verboso: Potrebbe saltare riassunti dettagliati per efficienza a meno che non richiesto diversamente
Questo stile di comunicazione riflette accuratamente ciò che è stato realizzato senza elaborazioni non necessarie.

Guida per situazioni specifiche

Bilancia la verbosità

I modelli Claude 4.5 tendono verso l’efficienza e potrebbero saltare riassunti verbali dopo le chiamate di strumenti, passando direttamente all’azione successiva. Sebbene ciò crei un flusso di lavoro snellito, potresti preferire più visibilità nel suo processo di ragionamento. Se desideri che Claude fornisca aggiornamenti mentre lavora:
Prompt di esempio
Dopo aver completato un compito che coinvolge l'uso di strumenti, fornisci un breve riassunto del lavoro che hai svolto.

Modelli di utilizzo degli strumenti

I modelli Claude 4.5 sono addestrati per il seguire preciso le istruzioni e traggono beneficio da una direzione esplicita per utilizzare strumenti specifici. Se dici “puoi suggerire alcuni cambiamenti”, a volte fornirà suggerimenti piuttosto che implementarli, anche se apportare cambiamenti potrebbe essere quello che intendevi. Affinché Claude agisca, sii più esplicito:
Meno efficace (Claude suggerirà solo):
Puoi suggerire alcuni cambiamenti per migliorare questa funzione?
Più efficace (Claude farà i cambiamenti):
Cambia questa funzione per migliorarne le prestazioni.
O:
Fai questi modifiche al flusso di autenticazione.
Per rendere Claude più proattivo nel prendere azioni per impostazione predefinita, puoi aggiungere questo al tuo prompt di sistema:
Prompt di esempio per azione proattiva
<default_to_action>
Per impostazione predefinita, implementa i cambiamenti piuttosto che solo suggerirli. Se l'intento dell'utente non è chiaro, deduci l'azione probabile più utile e procedi, utilizzando gli strumenti per scoprire i dettagli mancanti invece di indovinare. Prova a dedurre l'intento dell'utente su se una chiamata di strumento (ad es. modifica o lettura di file) è intesa o meno, e agisci di conseguenza.
</default_to_action>
D’altra parte, se desideri che il modello sia più esitante per impostazione predefinita, meno propenso a saltare direttamente alle implementazioni, e agisca solo se richiesto, puoi guidare questo comportamento con un prompt come il seguente:
Prompt di esempio per azione conservativa
<do_not_act_before_instructions>
Non saltare nell'implementazione o non modificare i file a meno che non sia chiaramente istruito di apportare cambiamenti. Quando l'intento dell'utente è ambiguo, predefinito per fornire informazioni, fare ricerche e fornire raccomandazioni piuttosto che agire. Procedi con modifiche, alterazioni o implementazioni solo quando l'utente le richiede esplicitamente.
</do_not_act_before_instructions>

Controlla il formato delle risposte

Abbiamo trovato alcuni modi particolarmente efficaci per guidare la formattazione dell’output nei modelli Claude 4.x:
  1. Dì a Claude cosa fare invece di cosa non fare
    • Invece di: “Non usare markdown nella tua risposta”
    • Prova: “La tua risposta dovrebbe essere composta da paragrafi di prosa che scorrono dolcemente.”
  2. Usa indicatori di formato XML
    • Prova: “Scrivi le sezioni di prosa della tua risposta in tag <smoothly_flowing_prose_paragraphs>.”
  3. Abbina lo stile del tuo prompt all’output desiderato Lo stile di formattazione utilizzato nel tuo prompt potrebbe influenzare lo stile di risposta di Claude. Se stai ancora riscontrando problemi di steerbility con la formattazione dell’output, ti consigliamo di abbinare il più possibile lo stile del tuo prompt allo stile di output desiderato. Ad esempio, rimuovere markdown dal tuo prompt può ridurre il volume di markdown nell’output.
  4. Usa prompt dettagliati per preferenze di formattazione specifiche Per un maggiore controllo sull’uso di markdown e formattazione, fornisci una guida esplicita:
Prompt di esempio per minimizzare markdown
<avoid_excessive_markdown_and_bullet_points>
Quando scrivi rapporti, documenti, spiegazioni tecniche, analisi o qualsiasi contenuto di lunga forma, scrivi in prosa chiara e scorrevole usando paragrafi e frasi complete. Usa interruzioni di paragrafo standard per l'organizzazione e riserva markdown principalmente per `codice inline`, blocchi di codice (```...```), e intestazioni semplici (###, e ###). Evita di usare **grassetto** e *corsivo*.

NON usare elenchi ordinati (1. ...) o elenchi non ordinati (*) a meno che: a) stai presentando elementi veramente discreti dove un formato di elenco è la migliore opzione, o b) l'utente richiede esplicitamente un elenco o una classifica

Invece di elencare elementi con punti elenco o numeri, incorporali naturalmente nelle frasi. Questa guida si applica soprattutto alla scrittura tecnica. Usare prosa invece di formattazione eccessiva migliorerà la soddisfazione dell'utente. NON produrre mai una serie di punti elenco eccessivamente brevi.

Il tuo obiettivo è testo leggibile e scorrevole che guida il lettore naturalmente attraverso le idee piuttosto che frammentare le informazioni in punti isolati.
</avoid_excessive_markdown_and_bullet_points>

Ricerca e raccolta di informazioni

I modelli Claude 4.5 dimostrano eccezionali capacità di ricerca agentiva e possono trovare e sintetizzare informazioni da più fonti in modo efficace. Per risultati di ricerca ottimali:
  1. Fornisci criteri di successo chiari: Definisci cosa costituisce una risposta di successo alla tua domanda di ricerca
  2. Incoraggia la verifica della fonte: Chiedi a Claude di verificare le informazioni su più fonti
  3. Per compiti di ricerca complessi, usa un approccio strutturato:
Prompt di esempio per ricerca complessa
Cerca queste informazioni in modo strutturato. Man mano che raccogli dati, sviluppa diverse ipotesi concorrenti. Traccia i tuoi livelli di confidenza nelle note di progresso per migliorare la calibrazione. Autocritica regolarmente il tuo approccio e piano. Aggiorna un file di albero di ipotesi o note di ricerca per persistere le informazioni e fornire trasparenza. Suddividi questo compito di ricerca complesso sistematicamente.
Questo approccio strutturato consente a Claude di trovare e sintetizzare praticamente qualsiasi pezzo di informazione e criticare iterativamente i suoi risultati, indipendentemente dalle dimensioni del corpus.

Orchestrazione di subagenti

I modelli Claude 4.5 dimostrano capacità significativamente migliorate di orchestrazione nativa di subagenti. Questi modelli possono riconoscere quando i compiti trarrebbero beneficio dal delegare il lavoro a subagenti specializzati e lo fanno proattivamente senza richiedere istruzioni esplicite. Per sfruttare questo comportamento:
  1. Assicurati che gli strumenti dei subagenti siano ben definiti: Disponi di strumenti di subagenti disponibili e descritti nelle definizioni degli strumenti
  2. Lascia che Claude orchestri naturalmente: Claude delegherà in modo appropriato senza istruzioni esplicite
  3. Regola la conservatività se necessario:
Prompt di esempio per utilizzo conservativo di subagenti
Delega ai subagenti solo quando il compito trae chiaramente beneficio da un agente separato con una nuova finestra di contesto.

Autoconoscenza del modello

Se desideri che Claude si identifichi correttamente nella tua applicazione o utilizzi stringhe API specifiche:
Prompt di esempio per identità del modello
L'assistente è Claude, creato da Anthropic. Il modello attuale è Claude Sonnet 4.5.
Per app basate su LLM che devono specificare stringhe di modello:
Prompt di esempio per stringa di modello
Quando è necessario un LLM, per favore predefinito a Claude Sonnet 4.5 a meno che l'utente non richieda diversamente. La stringa di modello esatta per Claude Sonnet 4.5 è claude-sonnet-4-5-20250929.

Sfrutta le capacità di pensiero e pensiero intercalato

I modelli Claude 4.x offrono capacità di pensiero che possono essere particolarmente utili per compiti che coinvolgono la riflessione dopo l’uso di strumenti o il ragionamento multi-step complesso. Puoi guidare il suo pensiero iniziale o intercalato per risultati migliori.
Prompt di esempio
Dopo aver ricevuto i risultati degli strumenti, rifletti attentamente sulla loro qualità e determina i passaggi successivi ottimali prima di procedere. Usa il tuo pensiero per pianificare e iterare in base a queste nuove informazioni, quindi intraprendi la migliore azione successiva.
Per ulteriori informazioni sulle capacità di pensiero, consulta Pensiero esteso.

Creazione di documenti

I modelli Claude 4.5 eccellono nella creazione di presentazioni, animazioni e documenti visivi. Questi modelli corrispondono o superano Claude Opus 4.1 in questo dominio, con un’impressionante creatività e un seguire le istruzioni più forte. I modelli producono output lucido e utilizzabile al primo tentativo nella maggior parte dei casi. Per i migliori risultati con la creazione di documenti:
Prompt di esempio
Crea una presentazione professionale su [argomento]. Includi elementi di design riflessivi, gerarchia visiva e animazioni coinvolgenti dove appropriato.

Ottimizza le chiamate di strumenti parallele

I modelli Claude 4.x eccellono nell’esecuzione parallela di strumenti, con Sonnet 4.5 particolarmente aggressivo nel lanciare più operazioni contemporaneamente. I modelli Claude 4.x:
  • Eseguono più ricerche speculative durante la ricerca
  • Leggono più file contemporaneamente per costruire il contesto più velocemente
  • Eseguono comandi bash in parallelo (che possono anche creare un collo di bottiglia nelle prestazioni del sistema)
Questo comportamento è facilmente steerable. Sebbene il modello abbia un alto tasso di successo nelle chiamate di strumenti parallele senza prompt, puoi aumentare questo a ~100% o regolare il livello di aggressività:
Prompt di esempio per massima efficienza parallela
<use_parallel_tool_calls>
Se intendi chiamare più strumenti e non ci sono dipendenze tra le chiamate di strumenti, fai tutte le chiamate di strumenti indipendenti in parallelo. Dai priorità alle chiamate di strumenti simultanee ogni volta che le azioni possono essere eseguite in parallelo piuttosto che sequenzialmente. Ad esempio, quando leggi 3 file, esegui 3 chiamate di strumenti in parallelo per leggere tutti e 3 i file nel contesto contemporaneamente. Massimizza l'uso di chiamate di strumenti parallele dove possibile per aumentare la velocità e l'efficienza. Tuttavia, se alcune chiamate di strumenti dipendono da chiamate precedenti per informare valori dipendenti come i parametri, NON chiamare questi strumenti in parallelo e invece chiamarli sequenzialmente. Non usare mai segnaposti o indovinare parametri mancanti nelle chiamate di strumenti.
</use_parallel_tool_calls>
Prompt di esempio per ridurre l'esecuzione parallela
Esegui le operazioni sequenzialmente con brevi pause tra ogni passaggio per garantire la stabilità.

Riduci la creazione di file nella codifica agentiva

I modelli Claude 4.x potrebbero a volte creare nuovi file per scopi di test e iterazione, in particolare quando si lavora con il codice. Questo approccio consente a Claude di utilizzare file, specialmente script python, come un “blocco note temporaneo” prima di salvare l’output finale. L’utilizzo di file temporanei può migliorare i risultati in particolare per i casi di utilizzo di codifica agentiva. Se preferisci minimizzare la creazione netta di nuovi file, puoi istruire Claude a pulire dopo se stesso:
Prompt di esempio
Se crei file nuovi temporanei, script o file helper per l'iterazione, pulisci questi file rimuovendoli alla fine del compito.

Migliora la generazione di codice visivo e frontend

I modelli Claude 4.x possono generare interfacce utente di alta qualità, visivamente distintive e funzionali. Tuttavia, senza guida, il codice frontend può predefinito a modelli generici che mancano di interesse visivo. Per ottenere risultati UI eccezionali:
  1. Fornisci incoraggiamento esplicito per la creatività:
Prompt di esempio
Non trattenerti. Dai il massimo. Crea una dimostrazione impressionante che mostra le capacità di sviluppo web.
  1. Specifica la direzione estetica e i vincoli di design:
Prompt di esempio
Crea una dashboard professionale usando una tavolozza di colori blu scuro e ciano, tipografia sans-serif moderna (ad es. Inter per i titoli, font di sistema per il corpo) e layout basati su schede con ombre sottili. Includi dettagli riflessivi come stati al passaggio del mouse, transizioni e micro-interazioni. Applica i principi di design: gerarchia, contrasto, equilibrio e movimento.
  1. Incoraggia la diversità di design e le estetiche di fusione:
Prompt di esempio
Fornisci più opzioni di design. Crea estetiche di fusione combinando elementi da diverse fonti, uno schema di colori, una tipografia diversa, un altro principio di layout. Evita layout generici centrati, gradienti semplicistici e stili uniformi.
  1. Richiedi funzionalità specifiche esplicitamente:
  • “Includi il maggior numero possibile di funzionalità e interazioni rilevanti”
  • “Aggiungi animazioni e elementi interattivi”
  • “Crea un’implementazione completamente funzionante oltre le basi”

Evita di concentrarsi sul passaggio dei test e sulla codifica hard-coded

I modelli Claude 4.x a volte possono concentrarsi troppo pesantemente sul far passare i test a scapito di soluzioni più generali, o possono usare workaround come script helper per il refactoring complesso invece di usare strumenti standard direttamente. Per prevenire questo comportamento e garantire soluzioni robuste e generalizzabili:
Prompt di esempio
Per favore scrivi una soluzione di alta qualità e di uso generale utilizzando gli strumenti standard disponibili. Non creare script helper o workaround per completare il compito in modo più efficiente. Implementa una soluzione che funziona correttamente per tutti gli input validi, non solo i casi di test. Non codificare valori hard-coded o creare soluzioni che funzionano solo per input di test specifici. Invece, implementa la logica effettiva che risolve il problema in generale.

Concentrati sulla comprensione dei requisiti del problema e sull'implementazione dell'algoritmo corretto. I test sono lì per verificare la correttezza, non per definire la soluzione. Fornisci un'implementazione principiata che segue le migliori pratiche e i principi di progettazione del software.

Se il compito è irragionevole o non fattibile, o se uno qualsiasi dei test è errato, per favore informami piuttosto che aggirare il problema. La soluzione dovrebbe essere robusta, mantenibile ed estensibile.

Minimizzare le allucinazioni nella codifica agentiva

I modelli Claude 4.x sono meno soggetti a allucinazioni e forniscono risposte più accurate, radicate e intelligenti basate sul codice. Per incoraggiare ulteriormente questo comportamento e minimizzare le allucinazioni:
Prompt di esempio
<investigate_before_answering>
Non speculare mai su codice che non hai aperto. Se l'utente fa riferimento a un file specifico, DEVI leggere il file prima di rispondere. Assicurati di investigare e leggere i file rilevanti PRIMA di rispondere alle domande sulla base di codice. Non fare mai affermazioni sul codice prima di investigare a meno che tu non sia sicuro della risposta corretta - fornisci risposte radicate e prive di allucinazioni.
</investigate_before_answering>

Considerazioni sulla migrazione

Quando si esegue la migrazione ai modelli Claude 4.5:
  1. Sii specifico sul comportamento desiderato: Considera di descrivere esattamente cosa vorresti vedere nell’output.
  2. Inquadra le tue istruzioni con modificatori: Aggiungere modificatori che incoraggiano Claude ad aumentare la qualità e il dettaglio del suo output può aiutare a modellare meglio le prestazioni di Claude. Ad esempio, invece di “Crea una dashboard di analisi”, usa “Crea una dashboard di analisi. Includi il maggior numero possibile di funzionalità e interazioni rilevanti. Vai oltre le basi per creare un’implementazione completamente funzionante.”
  3. Richiedi funzionalità specifiche esplicitamente: Le animazioni e gli elementi interattivi dovrebbero essere richiesti esplicitamente quando desiderati.