Flussi di lavoro comuni
Guide passo dopo passo per esplorare basi di codice, correggere bug, effettuare refactoring, testare e altri compiti quotidiani con Claude Code.
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 per esplorare il codice, correggere bug, effettuare refactoring, testare, PR e documentazione
- Riprendere conversazioni precedenti in modo che un'attività possa durare più sessioni
- Eseguire sessioni parallele con worktrees in modo che le modifiche simultanee non si scontrino
- Pianificare prima di modificare per rivedere le modifiche prima che tocchino il disco
- Delegare la ricerca ai subagent per mantenere il tuo contesto principale pulito
- Inviare Claude negli script per CI e elaborazione batch
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.
Navigare alla directory radice del progetto
cd /path/to/project
Avviare Claude Code
claude
Chiedere una panoramica di alto livello
give me an overview of this codebase
Approfondire componenti specifici
explain the main architecture patterns used here
what are the key data models?
how is authentication handled?
Trovare codice rilevante
Supponiamo che tu debba individuare il codice relativo a una funzionalità o funzione specifica.
Chiedere a Claude di trovare file rilevanti
find the files that handle user authentication
Ottenere contesto su come i componenti interagiscono
how do these authentication files work together?
Comprendere il flusso di esecuzione
trace the login process from front-end to database
Correggere bug in modo efficiente
Supponiamo che tu abbia riscontrato un messaggio di errore e debba trovare e correggere la sua fonte.
Condividere l'errore con Claude
I'm seeing an error when I run npm test
Chiedere raccomandazioni per la correzione
suggest a few ways to fix the @ts-ignore in user.ts
Applicare la correzione
update user.ts to add the null check you suggested
Effettuare refactoring del codice
Supponiamo che tu debba aggiornare il codice precedente per utilizzare modelli e pratiche moderne.
Identificare il codice legacy per il refactoring
find deprecated API usage in our codebase
Ottenere raccomandazioni per il refactoring
suggest how to refactor utils.js to use modern JavaScript features
Applicare le modifiche in modo sicuro
refactor utils.js to use ES2024 features while maintaining the same behavior
Verificare il refactoring
run tests for the refactored code
Lavorare con i test
Supponiamo che tu debba aggiungere test per il codice non coperto.
Identificare il codice non testato
find functions in NotificationsService.swift that are not covered by tests
Generare lo scaffolding dei test
add tests for the notification service
Aggiungere casi di test significativi
add test cases for edge conditions in the notification service
Eseguire e verificare i test
run the new tests and fix any failures
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:
Riassumere le tue modifiche
summarize the changes I've made to the authentication module
Generare una pull request
create a pr
Rivedere e affinare
enhance the PR description with more context about the security improvements
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 <number> o incolla l'URL della PR nel selettore /resume.
Gestire la documentazione
Supponiamo che tu debba aggiungere o aggiornare la documentazione per il tuo codice.
Identificare il codice non documentato
find functions without proper JSDoc comments in the auth module
Generare la documentazione
add JSDoc comments to the undocumented functions in auth.js
Rivedere e migliorare
improve the generated documentation with more context and examples
Verificare la documentazione
check if the documentation follows our project standards
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.
Aggiungere un'immagine alla conversazione
Puoi utilizzare uno di questi metodi:
- Trascina e rilascia un'immagine nella finestra di Claude Code
- Copia un'immagine e incollala nella CLI con ctrl+v (Non usare cmd+v)
- Fornisci un percorso di immagine a Claude. Ad esempio, "Analyze this image: /path/to/your/image.png"
Chiedere a Claude di analizzare l'immagine
What does this image show?
Describe the UI elements in this screenshot
Are there any problematic elements in this diagram?
Utilizzare le immagini per il contesto
Here's a screenshot of the error. What's causing it?
This is our current database schema. How should we modify it for the new feature?
Ottenere suggerimenti di codice dal contenuto visivo
Generate CSS to match this design mockup
What HTML structure would recreate this component?
Fare riferimento a file e directory
Usa @ per includere rapidamente file o directory senza aspettare che Claude li legga.
Fare riferimento a un singolo file
Explain the logic in @src/utils/auth.js
Questo include il contenuto completo del file nella conversazione.
Fare riferimento a una directory
What's the structure of @src/components?
Questo fornisce un elenco di directory con informazioni sui file.
Fare riferimento alle risorse MCP
Show me the data from @github:repos/owner/repo/issues
Questo recupera i dati dai server MCP connessi utilizzando il formato @server:resource. Vedi risorse MCP per i dettagli.
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:
| Opzione | Dove viene eseguita | Migliore per |
|---|---|---|
| Routines | Infrastruttura gestita da Anthropic | Attività che dovrebbero essere eseguite anche quando il tuo computer è spento. Possono anche attivarsi su chiamate API o eventi GitHub oltre a una pianificazione. Configura su claude.ai/code/routines. |
| Attività pianificate desktop | La tua macchina, tramite l'app desktop | Attività che hanno bisogno di accesso diretto a file locali, strumenti o modifiche non sottoposte a commit. |
| GitHub Actions | La tua pipeline CI | Attività legate a eventi del repository come PR aperte, o pianificazioni cron che dovrebbero vivere insieme alla tua configurazione del flusso di lavoro. |
/loop |
La sessione CLI corrente | Polling rapido mentre una sessione è aperta. Le attività si fermano quando inizi una nuova conversazione; --resume e --continue ripristinano quelle non scadute. |
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
can Claude Code create pull requests?
how does Claude Code handle permissions?
what skills are available?
how do I use MCP with Claude Code?
how do I configure Claude Code for Amazon Bedrock?
what are the limitations of Claude Code?
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.
claude --continue
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.
claude --worktree feature-auth
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.
claude --permission-mode plan
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.
use a subagent to investigate how our auth system handles token refresh
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.
git log --oneline -20 | claude -p "summarize these recent commits"
Vedi Modalità non interattiva per formati di output, flag di autorizzazione e modelli fan-out.