Claude Code è un agente da riga di comando che funziona nel tuo terminale, legge il tuo repository, modifica i file, esegue comandi e richiede conferma prima di eseguire azioni potenzialmente distruttive. È progettato per assistere in ogni fase del ciclo di vita dello sviluppo software, dall'esplorazione di una codebase sconosciuta alla distribuzione e manutenzione del codice in produzione.
La tabella sottostante riassume dove Claude Code si inserisce nel ciclo di vita dello sviluppo. Il resto di questo articolo illustra i dieci compiti per cui gli sviluppatori lo utilizzano più frequentemente, con un prompt di esempio e il risultato atteso per ciascuno.
1. Scopri | 2. Progetta | 3. Costruisci | 4. Distribuisci | 5. Supporto e scalabilità |
Esplora la codebase e la cronologia | Pianifica il progetto | Implementa il codice | Automatizza CI/CD | Esegui il debug degli errori |
Cerca nella documentazione | Sviluppa specifiche tecniche | Scrivi ed esegui test | Configura gli ambienti | Refactoring su larga scala |
Onboarding e apprendimento | Definisci l'architettura | Crea commit e PR | Gestisci le distribuzioni | Monitora l'utilizzo e le prestazioni |
Come utilizzare questa guida
Ogni caso d'uso sottostante include quando utilizzarlo, un prompt di esempio e il risultato atteso. Non è richiesta alcuna configurazione per nessuno di essi, ad eccezione del §9 (integrazione del tracker dei problemi), che richiede una configurazione MCP connector una sola volta.
I casi d'uso sono ordinati approssimativamente in base a quando la maggior parte degli sviluppatori li incontra. Seleziona quello che corrisponde al tuo compito attuale.
Casi d'uso
1. Correggi un test non riuscito
Quando utilizzare: Un test non riesce e la causa non è immediatamente ovvia. Utilizzalo per far sì che Claude Code individui la causa principale e proponga una correzione senza che tu debba identificare il file di origine per primo.
Prompt di esempio:
> the tests in tests/auth.test.ts are failing, can you figure out why and fix them
Risultato atteso: Claude Code legge il file di test, traccia il percorso del codice attraverso i moduli in fase di test, identifica la mancata corrispondenza e propone una modifica. Dopo che approvi la modifica, esegue nuovamente la suite di test per confermare la correzione.
2. Comprendi il codice sconosciuto
Quando utilizzare: Devi comprendere come funziona un modulo, una funzione o un sottosistema prima di apportare modifiche, ad esempio quando erediti il codice o esamini un'area sconosciuta.
Prompt di esempio:
> walk me through how the payment retry logic works
Risultato atteso: Claude Code individua i file rilevanti, legge l'implementazione e spiega il flusso di controllo in linguaggio semplice: punti di ingresso, rami decisionali, casi limite e come il codice si connette al resto del sistema. Poni domande di follow-up (ad esempio, "dove viene impostato X") per approfondire.
3. Trova dove accade qualcosa
Quando utilizzare: Conosci un comportamento che esiste nella codebase ma non riesci a individuarlo tramite nome file o semplice ricerca di testo.
Prompt di esempio:
> where do we validate email addresses in this codebase? I want to add a new rule
Risultato atteso: Claude Code cerca nel repository, apre i file candidati e restituisce percorsi di file e numeri di riga con contesto circostante sufficiente per identificare la corrispondenza corretta. Se esistono più posizioni, indica quale è la fonte di verità.
4. Triage di un errore o stack trace
Quando utilizzare: Hai un errore di runtime, uno stack trace o un output di log e devi mapparlo al codice responsabile.
Prompt di esempio:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> getting this in production:<br />
TypeError: Cannot read properties of undefined (reading 'sessionId')<br />
at validateSession (src/auth/session.ts:47)<br /> at middleware
(src/auth/middleware.ts:12)<br /> what's going on?</td> </tr> </tbody>
</table>
Risultato atteso: Claude Code legge i file a cui si fa riferimento nella traccia, spiega cosa non è definito e perché, e propone una correzione. Per gli errori senza uno stack trace pulito, incolla qualsiasi output di log disponibile e Claude Code ricostruirà l'errore dal contesto.
5. Refactor con un piano
Quando utilizzare: Una modifica si estende su più file e desideri rivedere l'ambito completo prima che vengano apportate modifiche.
Prerequisito: Premi Shift+Tab finché l'indicatore di modalità non mostra "plan."
Prompt di esempio:
> refactor the auth module to use the new session store instead of SessionCache
Risultato atteso: Claude Code analizza il codice e produce un piano numerato che elenca ogni file che modificherà e la modifica in ciascuno. Puoi approvare il piano così com'è o modificarlo (ad esempio, "non toccare la rotta di logout"). Nessun file viene modificato finché non approvi.
Riferimento: Autorizzazioni
6. Scrivi test per il codice esistente
Quando usare: Un file sorgente manca di copertura, oppure hai bisogno di test aggiuntivi per casi limite che corrispondono alle convenzioni di test esistenti del tuo progetto.
Prompt di esempio:
> add tests for @src/billing/invoice.ts — cover the edge cases around partial refunds. match the style of the existing tests in tests/billing/
Risultato atteso: Claude Code legge sia il file sorgente che la directory di test di riferimento, genera un nuovo file di test nello stile esistente ed lo esegue per confermare che i test passano. Se rimangono lacune di copertura evidenti, le segnala e chiede se affrontarle.
7. Rivedi una pull request
Quando usare: Hai bisogno di revisionare o riassumere una PR, in particolare in un'area della codebase che non conosci bene.
Prerequisito: GitHub CLI autenticato (esegui gh auth login una volta).
Prompt di esempio:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /pr-comments
https://github.com/acme/api/pull/4471<br /> > is the error handling
solid?</td> </tr> </tbody> </table>
Risultato atteso: Claude Code recupera il diff, i commenti di revisione e lo stato CI, quindi legge i file modificati nel loro contesto completo del repository. Può produrre una revisione mirata, bozze di commenti di revisione, verificare una preoccupazione specifica o riassumere la PR.
8. Onboard in un nuovo repository
Quando usare: Stai lavorando in un repository per la prima volta e hai bisogno di una panoramica strutturata della sua architettura, comandi di build e convenzioni.
Prompt di esempio:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> /init<br /> > give me a tour of this
codebase — where's the entry point, how is it structured, what should I
read first</td> </tr> </tbody> </table>
Risultato atteso: /init scansiona il progetto e scrive un file CLAUDE.md che riassume i comandi di build, l'architettura e le convenzioni. Il prompt di tour successivo produce una procedura guidata della struttura del progetto. Il contesto del progetto rimane caricato per il resto della sessione.
Riferimento: Memory e CLAUDE.md
9. Lavora su un problema da inizio a fine
Quando usare: Vuoi leggere un ticket, implementare la correzione e convalidarla in una singola conversazione senza cambiare strumenti.
Prerequisito: Issue tracker connesso tramite MCP (configurazione .mcp.json una tantum).
Prompt di esempio:
<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>> what's the top-priority issue assigned
to me?<br /> > go ahead and fix it</td> </tr> </tbody> </table>
Risultato atteso: Claude Code interroga l'issue tracker, legge il ticket, individua il codice rilevante, propone una correzione ed esegue i test. La sessione termina con un diff revisionabile e il contesto necessario per chiudere il ticket.
Riferimento: MCP
10. Trasforma un'attività ricorrente in un comando slash
Quando usare: Ripeti regolarmente lo stesso prompt multi-step (controlli pre-commit, riassunti standup, descrizioni PR, note di rilascio) e vuoi renderlo riutilizzabile per l'intero team.
Prompt di esempio:
> make me a /ship command that runs the tests, runs the linter, looks at git diff, and drafts a conventional-commit message — then shows me the message without committing
Risultato atteso: Claude Code scrive un file markdown in .claude/commands/. Il comando /ship è disponibile immediatamente, senza riavvio richiesto, ed è condiviso con chiunque cloni il repository.
Riferimento: Comandi slash
Appendice: Riferimento rapido
# | Caso d'uso | Prompt di esempio |
1 | Correggi un test non riuscito |
|
2 | Comprendi codice sconosciuto |
|
3 | Trova dove accade qualcosa |
|
4 | Triage di un errore | Incolla lo stack trace, quindi chiedi: |
5 | Refactor con un piano | Shift+Tab → modalità piano → descrivi il refactor |
6 | Scrivi test |
|
7 | Rivedi una PR |
|
8 | Accedi a un repository |
|
9 | Lavora su un problema da inizio a fine |
|
10 | Crea un comando slash |
|
Appendice: Directory delle risorse
Risorsa | Collegamento |
Guida rapida | |
Flussi di lavoro comuni | |
Autorizzazioni | |
Memoria e | |
Connettori MCP | |
Comandi slash |
Per dettagli su /init, riferimenti @, modalità di autorizzazione, competenze, MCP e hook, vedi code.claude.com/docs. Claude Code si aggiorna frequentemente—verifica i dettagli specifici della versione su code.claude.com/docs prima di distribuire internamente.