Vai al contenuto principale
Questa pagina raccoglie brevi ricette per lo sviluppo quotidiano. Per una guida di livello superiore sulla formulazione di prompt e la gestione del contesto, vedi Best practices. Questa pagina copre:

​
Ricette di prompt

Questi sono modelli di prompt per compiti quotidiani come esplorare codice non familiare, eseguire il debug, effettuare refactoring, scrivere test e creare PR. Ognuno funziona su qualsiasi superficie di Claude Code; adatta la formulazione al tuo progetto.

​
Comprendere nuove basi di codice

Per configurare Claude Code in un monorepo o in una base di codice di grandi dimensioni, vedi Monorepos e repository di grandi dimensioni.

​
Ottenere una rapida panoramica della base di codice

Supponiamo che tu abbia appena aderito a un nuovo progetto e debba comprendere rapidamente la sua struttura.
1

Navigare alla directory radice del progetto

2

Avviare Claude Code

3

Chiedere una panoramica di alto livello

4

Approfondire componenti specifici

Suggerimenti:
  • Inizia con domande ampie, quindi restringi a aree specifiche
  • Chiedi informazioni sulle convenzioni di codifica e sui modelli utilizzati nel progetto
  • Richiedi un glossario di termini specifici del progetto

​
Trovare codice rilevante

Supponiamo che tu debba individuare il codice relativo a una funzionalità o funzione specifica.
1

Chiedere a Claude di trovare file rilevanti

2

Ottenere contesto su come i componenti interagiscono

3

Comprendere il flusso di esecuzione

Suggerimenti:
  • Sii specifico su ciò che stai cercando
  • Usa il linguaggio del dominio dal progetto
  • Installa un plugin di code intelligence per il tuo linguaggio per dare a Claude una navigazione precisa “go to definition” e “find references”

​
Correggere bug in modo efficiente

Supponiamo che tu abbia riscontrato un messaggio di errore e debba trovare e correggere la sua fonte.
1

Condividere l'errore con Claude

2

Chiedere raccomandazioni per la correzione

3

Applicare la correzione

Suggerimenti:
  • Comunica a Claude il comando per riprodurre il problema e ottenere una stack trace
  • Menziona eventuali passaggi per riprodurre l’errore
  • Fai sapere a Claude se l’errore è intermittente o coerente

​
Effettuare refactoring del codice

Supponiamo che tu debba aggiornare il codice precedente per utilizzare modelli e pratiche moderne.
1

Identificare il codice legacy per il refactoring

2

Ottenere raccomandazioni per il refactoring

3

Applicare le modifiche in modo sicuro

4

Verificare il refactoring

Suggerimenti:
  • Chiedi a Claude di spiegare i vantaggi dell’approccio moderno
  • Richiedi che le modifiche mantengano la compatibilità all’indietro quando necessario
  • Effettua il refactoring in piccoli incrementi testabili

​
Lavorare con i test

Supponiamo che tu debba aggiungere test per il codice non coperto.
1

Identificare il codice non testato

2

Generare lo scaffolding dei test

3

Aggiungere casi di test significativi

4

Eseguire e verificare i test

Claude può generare test che seguono i modelli e le convenzioni esistenti del tuo progetto. Quando chiedi test, sii specifico sul comportamento che desideri verificare. Claude esamina i tuoi file di test esistenti per abbinare lo stile, i framework e i modelli di asserzione già in uso. Per una copertura completa, chiedi a Claude di identificare i casi limite che potresti aver perso. Claude può analizzare i tuoi percorsi di codice e suggerire test per condizioni di errore, valori limite e input inaspettati che sono facili da trascurare.

​
Creare pull request

Puoi creare pull request chiedendo direttamente a Claude (“create a pr for my changes”), oppure guidare Claude attraverso i passaggi:
1

Riassumere le tue modifiche

2

Generare una pull request

3

Rivedere e affinare

Quando crei una PR utilizzando gh pr create, la sessione viene automaticamente collegata a quella PR. Per tornare a essa in seguito, esegui claude --from-pr 123, sostituendo 123 con il numero della PR, o incolla l’URL della PR nel selettore /resume.
Rivedi la PR generata da Claude prima di inviarla e chiedi a Claude di evidenziare i rischi potenziali o le considerazioni.

​
Gestire la documentazione

Supponiamo che tu debba aggiungere o aggiornare la documentazione per il tuo codice.
1

Identificare il codice non documentato

2

Generare la documentazione

3

Rivedere e migliorare

4

Verificare la documentazione

Suggerimenti:
  • Specifica lo stile di documentazione che desideri (JSDoc, docstrings, ecc.)
  • Chiedi esempi nella documentazione
  • Richiedi documentazione per API pubbliche, interfacce e logica complessa

​
Lavorare in note e cartelle non di codice

Claude Code funziona in qualsiasi directory. Eseguilo all’interno di un vault di note, una cartella di documentazione o qualsiasi raccolta di file markdown per cercare, modificare e riorganizzare il contenuto nello stesso modo in cui faresti con il codice. La directory .claude/ e CLAUDE.md si trovano insieme alle directory di configurazione di altri strumenti senza conflitti. Claude legge i file freschi ad ogni chiamata dello strumento, quindi vede le modifiche che fai in un’altra applicazione la prossima volta che legge quel file.

​
Lavorare con le immagini

Supponiamo che tu debba lavorare con immagini nella tua base di codice e desideri l’aiuto di Claude nell’analizzare il contenuto dell’immagine.
1

Aggiungere un'immagine alla conversazione

Puoi utilizzare uno di questi metodi:
  1. Trascina e rilascia un’immagine nella finestra di Claude Code
  2. Copia un’immagine e incollala nella CLI con Ctrl+V. Su macOS, Cmd+V funziona anche in iTerm2.
  3. Fornisci un percorso di immagine a Claude. Ad esempio, “Analyze this image: /path/to/your/image.png”
2

Chiedere a Claude di analizzare l'immagine

3

Utilizzare le immagini per il contesto

4

Ottenere suggerimenti di codice dal contenuto visivo

Suggerimenti:
  • Usa le immagini quando le descrizioni di testo sarebbero poco chiare o ingombranti
  • Includi screenshot di errori, design dell’interfaccia utente o diagrammi per un contesto migliore
  • Puoi lavorare con più immagini in una conversazione
  • L’analisi delle immagini funziona con diagrammi, screenshot, mockup e altro
  • Quando Claude fa riferimento a immagini (ad esempio, [Image #1]), Cmd+Click (Mac) o Ctrl+Click (Windows/Linux) il collegamento per aprire l’immagine nel tuo visualizzatore predefinito

​
Fare riferimento a file e directory

Usa @ per includere rapidamente file o directory senza aspettare che Claude li legga.
1

Fare riferimento a un singolo file

Questo include il contenuto completo del file nella conversazione.
2

Fare riferimento a una directory

Questo fornisce un elenco di directory con informazioni sui file.
3

Fare riferimento alle risorse MCP

Questo recupera i dati dai server MCP connessi utilizzando il formato @server:resource. Vedi risorse MCP per i dettagli.
Suggerimenti:
  • I percorsi dei file possono essere relativi o assoluti
  • I riferimenti ai file @ aggiungono CLAUDE.md nella directory del file e nelle directory padre al contesto
  • I riferimenti alle directory mostrano elenchi di file, non contenuti
  • Puoi fare riferimento a più file in un singolo messaggio (ad esempio, “@file1.js and @file2.js”)

​
Eseguire Claude su una pianificazione

Supponiamo che tu voglia che Claude gestisca un’attività automaticamente su base ricorrente, come rivedere le PR aperte ogni mattina, controllare le dipendenze settimanalmente o verificare i fallimenti di CI durante la notte. Scegli un’opzione di pianificazione in base a dove desideri che l’attività venga eseguita:
Quando scrivi prompt per attività pianificate, sii esplicito su cosa significhi il successo e cosa fare con i risultati. L’attività viene eseguita autonomamente, quindi non può fare domande di chiarimento. Ad esempio: “Review open PRs labeled needs-review, leave inline comments on any issues, and post a summary in the #eng-reviews Slack channel.”

​
Chiedere a Claude delle sue capacità

Claude ha accesso integrato alla sua documentazione e può rispondere a domande sulle sue stesse funzionalità e limitazioni.

​
Domande di esempio

Claude fornisce risposte basate sulla documentazione a queste domande. Per dimostrazioni pratiche, esegui /powerup per lezioni interattive con demo animate, o fai riferimento alle sezioni di flusso di lavoro specifiche sopra.
Suggerimenti:
  • Claude ha sempre accesso alla documentazione più recente di Claude Code, indipendentemente dalla versione che stai utilizzando
  • Fai domande specifiche per ottenere risposte dettagliate
  • Claude può spiegare funzionalità complesse come integrazione MCP, configurazioni aziendali e flussi di lavoro avanzati

​
Riprendere conversazioni precedenti

Quando un’attività dura più sessioni, riprendi da dove hai lasciato invece di rispiegare il contesto. Claude Code salva ogni conversazione localmente.
Questo riprende la sessione più recente nella directory corrente; se non ce n’è ancora una, stampa No conversation found to continue ed esce. Usa claude --resume per scegliere da un elenco, o /resume da una sessione in esecuzione. Vedi Gestire le sessioni per denominazione, branching e il riferimento completo del selettore.

​
Eseguire sessioni parallele con worktrees

Lavora su una funzionalità in un terminale mentre Claude corregge un bug in un altro, senza che le modifiche si scontrino. Ogni worktree è un checkout separato sul suo ramo.
Esegui lo stesso comando con un nome diverso in un secondo terminale per avviare una sessione parallela isolata. Vedi Worktrees per pulizia, .worktreeinclude e supporto VCS non-git. Per monitorare sessioni parallele da uno schermo invece di terminali separati, vedi agenti in background.

​
Pianificare prima di modificare

Per le modifiche che desideri rivedere prima che tocchino il disco, passa a plan mode. Claude legge i file e propone un piano ma non apporta modifiche finché non approvi.
Puoi anche premere Shift+Tab durante una sessione per attivare/disattivare plan mode. Vedi Plan mode per il flusso di approvazione e la modifica del piano nell’editor di testo.

​
Delegare la ricerca ai subagent

Esplorare una base di codice grande riempie il tuo contesto con letture di file. Delega l’esplorazione in modo che solo i risultati tornino indietro.
Il subagent legge i file nel suo proprio contesto e segnala un riassunto. Vedi Subagent per definire agenti personalizzati con i loro strumenti e prompt.

​
Inviare Claude negli script

Esegui Claude in modo non interattivo per CI, hook pre-commit o elaborazione batch. Stdin e stdout funzionano come qualsiasi strumento Unix.
Vedi Modalità non interattiva per formati di output, flag di autorizzazione e modelli fan-out.

​
Passaggi successivi

Best practices

Modelli per ottenere il massimo da Claude Code

Gestire le sessioni

Riprendere, denominare e dirammare conversazioni

Worktrees

Eseguire sessioni parallele isolate

Estendere Claude Code

Aggiungere skills, hooks, MCP, subagent e plugin