Flussi di lavoro comuni
Impara i flussi di lavoro comuni con Claude Code.
Ogni attività in questo documento include istruzioni chiare, comandi di esempio e best practice per aiutarti a ottenere il massimo da Claude Code.
Comprendere nuove basi di codice
Ottenere una panoramica rapida della base di codice
Supponiamo che tu ti sia appena unito a un nuovo progetto e abbia bisogno di comprendere rapidamente la sua struttura.
Naviga alla directory radice del progetto
Avvia Claude Code
Chiedi una panoramica ad alto livello
Approfondisci componenti specifici
Suggerimenti:
- Inizia con domande ampie, poi restringi ad aree specifiche
- Chiedi delle convenzioni di codifica e dei pattern utilizzati nel progetto
- Richiedi un glossario dei termini specifici del progetto
Trovare codice rilevante
Supponiamo che tu abbia bisogno di localizzare codice relativo a una funzionalità o caratteristica specifica.
Chiedi a Claude di trovare i file rilevanti
Ottieni il contesto su come interagiscono i componenti
Comprendi il flusso di esecuzione
Suggerimenti:
- Sii specifico su quello che stai cercando
- Usa il linguaggio del dominio del progetto
Correggere bug in modo efficiente
Supponiamo che tu abbia riscontrato un messaggio di errore e abbia bisogno di trovare e correggere la sua origine.
Condividi l'errore con Claude
Chiedi raccomandazioni per la correzione
Applica la correzione
Suggerimenti:
- Dì a Claude il comando per riprodurre il problema e ottenere uno stack trace
- Menziona eventuali passaggi per riprodurre l’errore
- Fai sapere a Claude se l’errore è intermittente o costante
Refactoring del codice
Supponiamo che tu abbia bisogno di aggiornare codice vecchio per utilizzare pattern e pratiche moderne.
Identifica codice legacy per il refactoring
Ottieni raccomandazioni per il refactoring
Applica le modifiche in sicurezza
Verifica il refactoring
Suggerimenti:
- Chiedi a Claude di spiegare i benefici dell’approccio moderno
- Richiedi che le modifiche mantengano la compatibilità all’indietro quando necessario
- Fai il refactoring in piccoli incrementi testabili
Utilizzare subagenti specializzati
Supponiamo che tu voglia utilizzare subagenti AI specializzati per gestire compiti specifici in modo più efficace.
Visualizza i subagenti disponibili
Questo mostra tutti i subagenti disponibili e ti permette di crearne di nuovi.
Usa i subagenti automaticamente
Claude Code delegherà automaticamente i compiti appropriati ai subagenti specializzati:
Richiedi esplicitamente subagenti specifici
Crea subagenti personalizzati per il tuo flusso di lavoro
Poi seleziona “Crea nuovo subagente” e segui le istruzioni per definire:
- Tipo di subagente (es.
api-designer
,performance-optimizer
) - Quando utilizzarlo
- A quali strumenti può accedere
- Il suo prompt di sistema specializzato
Suggerimenti:
- Crea subagenti specifici per il progetto in
.claude/agents/
per la condivisione del team - Usa campi
description
descrittivi per abilitare la delega automatica - Limita l’accesso agli strumenti a quello che ogni subagente effettivamente necessita
- Controlla la documentazione sui subagenti per esempi dettagliati
Lavorare con i test
Supponiamo che tu abbia bisogno di aggiungere test per codice non coperto.
Identifica codice non testato
Genera la struttura dei test
Aggiungi casi di test significativi
Esegui e verifica i test
Suggerimenti:
- Chiedi test che coprano casi limite e condizioni di errore
- Richiedi sia test unitari che di integrazione quando appropriato
- Fai spiegare a Claude la strategia di testing
Creare pull request
Supponiamo che tu abbia bisogno di creare una pull request ben documentata per le tue modifiche.
Riassumi le tue modifiche
Genera una PR con Claude
Rivedi e perfeziona
Aggiungi dettagli sui test
Suggerimenti:
- Chiedi direttamente a Claude di creare una PR per te
- Rivedi la PR generata da Claude prima di inviarla
- Chiedi a Claude di evidenziare potenziali rischi o considerazioni
Gestire la documentazione
Supponiamo che tu abbia bisogno di aggiungere o aggiornare la documentazione per il tuo codice.
Identifica codice non documentato
Genera documentazione
Rivedi e migliora
Verifica la documentazione
Suggerimenti:
- Specifica lo stile di documentazione che vuoi (JSDoc, docstrings, ecc.)
- Chiedi esempi nella documentazione
- Richiedi documentazione per API pubbliche, interfacce e logica complessa
Lavorare con le immagini
Supponiamo che tu abbia bisogno di lavorare con immagini nella tua base di codice e vuoi l’aiuto di Claude per analizzare il contenuto delle immagini.
Aggiungi 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 dell’immagine a Claude. Es., “Analizza questa immagine: /path/to/your/image.png”
Chiedi a Claude di analizzare l'immagine
Usa le immagini per il contesto
Ottieni suggerimenti di codice dal contenuto visivo
Suggerimenti:
- Usa le immagini quando le descrizioni testuali sarebbero poco chiare o ingombranti
- Includi screenshot di errori, design UI 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
Riferimenti a file e directory
Usa @ per includere rapidamente file o directory senza aspettare che Claude li legga.
Riferimento a un singolo file
Questo include il contenuto completo del file nella conversazione.
Riferimento a una directory
Questo fornisce un elenco della directory con informazioni sui file.
Riferimento a risorse MCP
Questo recupera dati dai server MCP connessi utilizzando il formato @server:resource. Vedi risorse MCP per dettagli.
Suggerimenti:
- I percorsi dei file possono essere relativi o assoluti
- I riferimenti @ 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 riferire più file in un singolo messaggio (es., “@file1.js e @file2.js”)
Utilizzare il pensiero esteso
Supponiamo che tu stia lavorando su decisioni architetturali complesse, bug difficili o pianificando implementazioni multi-step che richiedono ragionamento profondo.
Fornisci contesto e chiedi a Claude di pensare
Claude raccoglierà informazioni rilevanti dalla tua base di codice e userà il pensiero esteso, che sarà visibile nell’interfaccia.
Affina il pensiero con prompt di follow-up
Suggerimenti per ottenere il massimo valore dal pensiero esteso:
Il pensiero esteso è più prezioso per compiti complessi come:
- Pianificare cambiamenti architetturali complessi
- Debug di problemi intricati
- Creare piani di implementazione per nuove funzionalità
- Comprendere basi di codice complesse
- Valutare compromessi tra diversi approcci
Il modo in cui richiedi il pensiero risulta in diversi livelli di profondità del pensiero:
- “pensa” attiva il pensiero esteso di base
- frasi intensificanti come “pensa di più”, “pensa molto”, “pensa più intensamente”, o “pensa più a lungo” attivano un pensiero più profondo
Per più suggerimenti sui prompt del pensiero esteso, vedi Suggerimenti per il pensiero esteso.
Claude mostrerà il suo processo di pensiero come testo grigio in corsivo sopra la risposta.
Riprendere conversazioni precedenti
Supponiamo che tu abbia lavorato su un compito con Claude Code e abbia bisogno di continuare da dove avevi lasciato in una sessione successiva.
Claude Code fornisce due opzioni per riprendere conversazioni precedenti:
--continue
per continuare automaticamente la conversazione più recente--resume
per visualizzare un selettore di conversazioni
Continua la conversazione più recente
Questo riprende immediatamente la tua conversazione più recente senza alcun prompt.
Continua in modalità non interattiva
Usa --print
con --continue
per riprendere la conversazione più recente in modalità non interattiva, perfetto per script o automazione.
Mostra selettore di conversazioni
Questo visualizza un selettore di conversazioni interattivo che mostra:
- Ora di inizio della conversazione
- Prompt iniziale o riassunto della conversazione
- Conteggio messaggi
Usa i tasti freccia per navigare e premi Invio per selezionare una conversazione.
Suggerimenti:
- La cronologia delle conversazioni è memorizzata localmente sulla tua macchina
- Usa
--continue
per accesso rapido alla tua conversazione più recente - Usa
--resume
quando hai bisogno di selezionare una conversazione passata specifica - Quando riprendi, vedrai l’intera cronologia della conversazione prima di continuare
- La conversazione ripresa inizia con lo stesso modello e configurazione dell’originale
Come funziona:
- Memorizzazione Conversazioni: Tutte le conversazioni sono automaticamente salvate localmente con la loro cronologia completa dei messaggi
- Deserializzazione Messaggi: Quando riprendi, l’intera cronologia dei messaggi viene ripristinata per mantenere il contesto
- Stato Strumenti: L’uso degli strumenti e i risultati dalla conversazione precedente sono preservati
- Ripristino Contesto: La conversazione riprende con tutto il contesto precedente intatto
Esempi:
Eseguire sessioni Claude Code parallele con Git worktree
Supponiamo che tu abbia bisogno di lavorare su più compiti simultaneamente con completo isolamento del codice tra le istanze di Claude Code.
Comprendi i Git worktree
I Git worktree ti permettono di fare checkout di più branch dallo stesso repository in directory separate. Ogni worktree ha la sua directory di lavoro con file isolati, condividendo la stessa cronologia Git. Scopri di più nella documentazione ufficiale Git worktree.
Crea un nuovo worktree
Questo crea una nuova directory con una copia di lavoro separata del tuo repository.
Esegui Claude Code in ogni worktree
Esegui Claude in un altro worktree
Gestisci i tuoi worktree
Suggerimenti:
- Ogni worktree ha il suo stato di file indipendente, rendendolo perfetto per sessioni Claude Code parallele
- Le modifiche fatte in un worktree non influenzeranno gli altri, prevenendo interferenze tra istanze Claude
- Tutti i worktree condividono la stessa cronologia Git e connessioni remote
- Per compiti di lunga durata, puoi avere Claude che lavora in un worktree mentre continui lo sviluppo in un altro
- Usa nomi di directory descrittivi per identificare facilmente per quale compito è ogni worktree
- Ricorda di inizializzare il tuo ambiente di sviluppo in ogni nuovo worktree secondo la configurazione del tuo progetto. A seconda del tuo stack, questo potrebbe includere:
- Progetti JavaScript: Eseguire installazione dipendenze (
npm install
,yarn
) - Progetti Python: Configurare ambienti virtuali o installare con package manager
- Altri linguaggi: Seguire il processo di configurazione standard del tuo progetto
- Progetti JavaScript: Eseguire installazione dipendenze (
Utilizzare Claude come utility in stile unix
Aggiungere Claude al tuo processo di verifica
Supponiamo che tu voglia utilizzare Claude Code come linter o revisore di codice.
Aggiungi Claude al tuo script di build:
Suggerimenti:
- Usa Claude per revisione automatica del codice nella tua pipeline CI/CD
- Personalizza il prompt per controllare problemi specifici rilevanti per il tuo progetto
- Considera di creare più script per diversi tipi di verifica
Pipe in, pipe out
Supponiamo che tu voglia inviare dati a Claude tramite pipe e ottenere dati in un formato strutturato.
Invia dati attraverso Claude tramite pipe:
Suggerimenti:
- Usa le pipe per integrare Claude negli script shell esistenti
- Combina con altri strumenti Unix per flussi di lavoro potenti
- Considera di usare —output-format per output strutturato
Controllare il formato di output
Supponiamo che tu abbia bisogno dell’output di Claude in un formato specifico, specialmente quando integri Claude Code in script o altri strumenti.
Usa formato testo (predefinito)
Questo restituisce solo la risposta in testo semplice di Claude (comportamento predefinito).
Usa formato JSON
Questo restituisce un array JSON di messaggi con metadati inclusi costo e durata.
Usa formato JSON streaming
Questo restituisce una serie di oggetti JSON in tempo reale mentre Claude elabora la richiesta. Ogni messaggio è un oggetto JSON valido, ma l’intero output non è JSON valido se concatenato.
Suggerimenti:
- Usa
--output-format text
per integrazioni semplici dove hai bisogno solo della risposta di Claude - Usa
--output-format json
quando hai bisogno del log completo della conversazione - Usa
--output-format stream-json
per output in tempo reale di ogni turno di conversazione
Creare com andi slash personalizzati
Claude Code supporta comandi slash personalizzati che puoi creare per eseguire rapidamente prompt o compiti specifici.
Per maggiori dettagli, vedi la pagina di riferimento Comandi slash.
Creare comandi specifici per il progetto
Supponiamo che tu voglia creare comandi slash riutilizzabili per il tuo progetto che tutti i membri del team possano utilizzare.
Crea una directory comandi nel tuo progetto
Crea un file Markdown per ogni comando
Usa il tuo comando personalizzato in Claude Code
Suggerimenti:
- I nomi dei comandi derivano dal nome del file (es.,
optimize.md
diventa/optimize
) - Puoi organizzare i comandi in sottodirectory (es.,
.claude/commands/frontend/component.md
crea/component
con “(project:frontend)” mostrato nella descrizione) - I comandi di progetto sono disponibili a tutti coloro che clonano il repository
- Il contenuto del file Markdown diventa il prompt inviato a Claude quando il comando viene invocato
Aggiungere argomenti ai comandi con $ARGUMENTS
Supponiamo che tu voglia creare comandi slash flessibili che possano accettare input aggiuntivo dagli utenti.
Crea un file comando con il placeholder $ARGUMENTS
Usa il comando con un numero di problema
Nella tua sessione Claude, usa il comando con argomenti.
Questo sostituirà $ARGUMENTS con “123” nel prompt.
Suggerimenti:
- Il placeholder $ARGUMENTS viene sostituito con qualsiasi testo che segue il comando
- Puoi posizionare $ARGUMENTS ovunque nel tuo template di comando
- Altre applicazioni utili: generare casi di test per funzioni specifiche, creare documentazione per componenti, rivedere codice in file particolari, o tradurre contenuto in linguaggi specificati
Creare comandi slash personali
Supponiamo che tu voglia creare comandi slash personali che funzionino in tutti i tuoi progetti.
Crea una directory comandi nella tua cartella home
Crea un file Markdown per ogni comando
Usa il tuo comando personalizzato personale
Suggerimenti:
- I comandi personali mostrano “(user)” nella loro descrizione quando elencati con
/help
- I comandi personali sono disponibili solo per te e non condivisi con il tuo team
- I comandi personali funzionano in tutti i tuoi progetti
- Puoi usarli per flussi di lavoro consistenti attraverso diverse basi di codice
Chiedere a Claude delle sue capacità
Claude ha accesso integrato alla sua documentazione e può rispondere a domande sulle sue funzionalità e limitazioni.
Domande di esempio
Claude fornisce risposte basate sulla documentazione a queste domande. Per esempi eseguibili e dimostrazioni pratiche, fai riferimento alle sezioni specifiche dei flussi di lavoro 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 enterprise e flussi di lavoro avanzati
Prossimi passi
Implementazione di riferimento Claude Code
Clona la nostra implementazione di riferimento del container di sviluppo.