Questa guida fornisce tutorial passo-passo per flussi di lavoro comuni con Claude Code. Ogni tutorial include istruzioni chiare, comandi di esempio e best practice per aiutarti a ottenere il massimo da Claude Code.

​
Indice

​
Riprendere conversazioni precedenti

​
Continua il tuo lavoro senza interruzioni

Quando utilizzarlo: Hai lavorato a un’attività con Claude Code e hai bisogno di continuare da dove hai lasciato in una sessione successiva. Claude Code offre due opzioni per riprendere conversazioni precedenti:
  • --continue per continuare automaticamente la conversazione più recente
  • --resume per visualizzare un selettore di conversazioni
1

Continuare la conversazione più recente

claude --continue
Questo riprende immediatamente la tua conversazione più recente senza alcun prompt.
2

Continuare in modalità non interattiva

claude --continue --print "Continua con il mio compito"
Usa --print con --continue per riprendere la conversazione più recente in modalità non interattiva, perfetta per script o automazione.
3

Mostrare il selettore di conversazioni

claude --resume
Questo visualizza un selettore interattivo di conversazioni che mostra:
  • Ora di inizio della conversazione
  • Prompt iniziale o riepilogo della conversazione
  • Conteggio dei messaggi
Usa i tasti freccia per navigare e premi Invio per selezionare una conversazione.
Come funziona:
  1. Archiviazione delle conversazioni: Tutte le conversazioni vengono automaticamente salvate localmente con la loro cronologia completa dei messaggi
  2. Deserializzazione dei messaggi: Quando si riprende, l’intera cronologia dei messaggi viene ripristinata per mantenere il contesto
  3. Stato degli strumenti: L’utilizzo degli strumenti e i risultati della conversazione precedente vengono conservati
  4. Ripristino del contesto: La conversazione riprende con tutto il contesto precedente intatto
Suggerimenti:
  • La cronologia delle conversazioni è memorizzata localmente sul tuo computer
  • Usa --continue per accedere rapidamente alla tua conversazione più recente
  • Usa --resume quando devi selezionare una specifica conversazione passata
  • Quando riprendi, vedrai l’intera cronologia della conversazione prima di continuare
  • La conversazione ripresa inizia con lo stesso modello e configurazione dell’originale
Esempi: 
# Continuare la conversazione più recente
claude --continue

# Continuare la conversazione più recente con un prompt specifico
claude --continue --print "Mostrami i nostri progressi"

# Mostrare il selettore di conversazioni
claude --resume

# Continuare la conversazione più recente in modalità non interattiva
claude --continue --print "Esegui nuovamente i test"

​
Comprendere nuove basi di codice

​
Ottenere una rapida panoramica della base di codice

Quando utilizzarlo: Ti sei appena unito a un nuovo progetto e hai bisogno di comprenderne rapidamente la struttura.
1

Navigare alla directory principale del progetto

cd /percorso/del/progetto
2

Avviare Claude Code

claude
3

Chiedere una panoramica di alto livello

> dammi una panoramica di questa base di codice
4

Approfondire componenti specifici

> spiega i principali pattern architetturali utilizzati qui 

> quali sono i modelli di dati chiave?

> come viene gestita l'autenticazione?
Suggerimenti:
  • Inizia con domande ampie, poi concentrati su aree specifiche
  • Chiedi informazioni sulle convenzioni di codifica e sui pattern utilizzati nel progetto
  • Richiedi un glossario dei termini specifici del progetto

​
Trovare codice rilevante

Quando utilizzarlo: Hai bisogno di localizzare codice relativo a una specifica funzionalità.
1

Chiedi a Claude di trovare file rilevanti

> trova i file che gestiscono l'autenticazione degli utenti
2

Ottenere contesto su come interagiscono i componenti

> come lavorano insieme questi file di autenticazione?
3

Comprendere il flusso di esecuzione

> traccia il processo di login dal front-end al database
Suggerimenti:
  • Sii specifico su ciò che stai cercando
  • Utilizza il linguaggio di dominio del progetto

​
Risolvere bug in modo efficiente

​
Diagnosticare messaggi di errore

Quando utilizzarlo: Hai incontrato un messaggio di errore e hai bisogno di trovare e correggere la sua origine.
1

Condividere l'errore con Claude

> Sto vedendo un errore quando eseguo npm test
2

Chiedere suggerimenti per la correzione

> suggerisci alcuni modi per correggere il @ts-ignore in user.ts
3

Applicare la correzione

> aggiorna user.ts per aggiungere il controllo null che hai suggerito
Suggerimenti:
  • Comunica 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

​
Modernizzare codice legacy

Quando utilizzarlo: Hai bisogno di aggiornare codice vecchio per utilizzare pattern e pratiche moderne.
1

Identificare il codice legacy per il refactoring

> trova utilizzi di API deprecate nella nostra base di codice
2

Ottenere raccomandazioni per il refactoring

> suggerisci come fare il refactoring di utils.js per utilizzare funzionalità JavaScript moderne
3

Applicare le modifiche in sicurezza

> fai il refactoring di utils.js per utilizzare funzionalità ES2024 mantenendo lo stesso comportamento
4

Verificare il refactoring

> esegui i test per il codice sottoposto a refactoring
Suggerimenti:
  • Chiedi a Claude di spiegare i vantaggi dell’approccio moderno
  • Richiedi che le modifiche mantengano la compatibilità con le versioni precedenti quando necessario
  • Esegui il refactoring in piccoli incrementi testabili

​
Lavorare con i test

​
Aggiungere copertura dei test

Quando utilizzarlo: Hai bisogno di aggiungere test per codice non coperto.
1

Identificare codice non testato

> trova funzioni in NotificationsService.swift che non sono coperte da test
2

Generare l'impalcatura dei test

> aggiungi test per il servizio di notifica
3

Aggiungere casi di test significativi

> aggiungi casi di test per condizioni limite nel servizio di notifica
4

Eseguire e verificare i test

> esegui i nuovi test e correggi eventuali fallimenti
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

​
Generare PR complete

Quando utilizzarlo: Hai bisogno di creare una pull request ben documentata per le tue modifiche.
1

Riassumere le tue modifiche

> riassumi le modifiche che ho apportato al modulo di autenticazione
2

Generare una PR con Claude

> crea una pr
3

Rivedere e perfezionare

> migliora la descrizione della PR con più contesto sui miglioramenti di sicurezza
4

Aggiungere dettagli sui test

> aggiungi informazioni su come queste modifiche sono state testate
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

​
Generare documentazione del codice

Quando utilizzarlo: Hai bisogno di aggiungere o aggiornare la documentazione per il tuo codice.
1

Identificare codice non documentato

> trova funzioni senza commenti JSDoc appropriati nel modulo auth
2

Generare documentazione

> aggiungi commenti JSDoc alle funzioni non documentate in auth.js
3

Rivedere e migliorare

> migliora la documentazione generata con più contesto ed esempi
4

Verificare la documentazione

> controlla se la documentazione segue gli standard del nostro progetto
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 con le immagini

​
Analizzare immagini e screenshot

Quando utilizzarlo: Hai bisogno di lavorare con immagini nella tua base di codice o ottenere l’aiuto di Claude per analizzare il contenuto delle immagini.
1

Aggiungere un'immagine alla conversazione

Puoi utilizzare uno di questi metodi:
  1. Trascinare e rilasciare un’immagine nella finestra di Claude Code
  2. Copiare un’immagine e incollarla nella CLI con cmd+v (su Mac)
  3. Fornire un percorso dell’immagine claude “Analizza questa immagine: /percorso/della/tua/immagine.png”
2

Chiedere a Claude di analizzare l'immagine

> Cosa mostra questa immagine? 
> Descrivi gli elementi dell'interfaccia utente in questo screenshot 
> Ci sono elementi problematici in questo diagramma?
3

Utilizzare immagini per il contesto

> Ecco uno screenshot dell'errore. Cosa lo sta causando? 
> Questo è il nostro schema di database attuale. Come dovremmo modificarlo per la nuova funzionalità?
4

Ottenere suggerimenti di codice dal contenuto visivo

> Genera CSS per corrispondere a questo mockup di design 
> Quale struttura HTML ricreerebbe questo componente?
Suggerimenti:
  • Utilizza 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

​
Utilizzare il pensiero esteso

​
Sfruttare il pensiero esteso di Claude per compiti complessi

Quando utilizzarlo: Quando lavori su decisioni architetturali complesse, bug impegnativi o pianificazione di implementazioni multi-step che richiedono un ragionamento approfondito.
1

Fornire contesto e chiedere a Claude di pensare

> Ho bisogno di implementare un nuovo sistema di autenticazione utilizzando OAuth2 per la nostra API. Pensa profondamente al miglior approccio per implementarlo nella nostra base di codice.
Claude raccoglierà informazioni rilevanti dalla tua base di codice e utilizzerà il pensiero esteso, che sarà visibile nell’interfaccia.
2

Perfezionare il pensiero con prompt di follow-up

> pensa alle potenziali vulnerabilità di sicurezza in questo approccio 
> pensa più a fondo ai casi limite che dovremmo gestire
Suggerimenti per ottenere il massimo valore dal pensiero esteso: Il pensiero esteso è più prezioso per compiti complessi come:
  • Pianificare modifiche architetturali complesse
  • Debuggare problemi intricati
  • Creare piani di implementazione per nuove funzionalità
  • Comprendere basi di codice complesse
  • Valutare compromessi tra approcci diversi
Il modo in cui richiedi il pensiero porta a vari livelli di profondità di 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 ulteriori suggerimenti sul prompt per il pensiero esteso, vedi Suggerimenti per il pensiero esteso.
Claude mostrerà il suo processo di pensiero come testo grigio in corsivo sopra la risposta.

​
Configurare la memoria del progetto

​
Creare un file CLAUDE.md efficace

Quando utilizzarlo: Vuoi configurare un file CLAUDE.md per memorizzare informazioni importanti sul progetto, convenzioni e comandi utilizzati frequentemente.
1

Inizializzare un CLAUDE.md per la tua base di codice

> /init
Suggerimenti:
  • Includi comandi utilizzati frequentemente (build, test, lint) per evitare ricerche ripetute
  • Documenta le preferenze di stile del codice e le convenzioni di denominazione
  • Aggiungi importanti pattern architetturali specifici per il tuo progetto
  • I ricordi in CLAUDE.md possono essere utilizzati sia per istruzioni condivise con il tuo team che per le tue preferenze individuali. Per maggiori dettagli, vedi Gestire la memoria di Claude.

​
Configurare il Model Context Protocol (MCP)

Model Context Protocol (MCP) è un protocollo aperto che consente agli LLM di accedere a strumenti esterni e fonti di dati. Per maggiori dettagli, consulta la documentazione MCP.
Utilizza server MCP di terze parti a tuo rischio. Assicurati di fidarti dei server MCP, e fai particolare attenzione quando utilizzi server MCP che comunicano con internet, poiché questi possono esporti al rischio di iniezione di prompt.

​
Configurare server MCP

Quando utilizzarlo: Vuoi migliorare le capacità di Claude collegandolo a strumenti specializzati e server esterni utilizzando il Model Context Protocol.
1

Aggiungere un server MCP Stdio

# Sintassi di base
claude mcp add <nome> <comando> [args...]

# Esempio: Aggiungere un server locale
claude mcp add my-server -e API_KEY=123 -- /percorso/del/server arg1 arg2
2

Aggiungere un server MCP SSE

# Sintassi di base
claude mcp add --transport sse <nome> <url>

# Esempio: Aggiungere un server SSE
claude mcp add --transport sse sse-server https://example.com/sse-endpoint
3

Gestire i tuoi server MCP

# Elencare tutti i server configurati
claude mcp list

# Ottenere dettagli per un server specifico
claude mcp get my-server

# Rimuovere un server
claude mcp remove my-server
Suggerimenti:
  • Utilizza il flag -s o --scope per specificare dove viene memorizzata la configurazione:
    • local (predefinito): Disponibile solo per te nel progetto corrente (era chiamato project nelle versioni precedenti)
    • project: Condiviso con tutti nel progetto tramite il file .mcp.json
    • user: Disponibile per te in tutti i progetti (era chiamato global nelle versioni precedenti)
  • Imposta variabili d’ambiente con i flag -e o --env (es. -e CHIAVE=valore)
  • Configura il timeout di avvio del server MCP utilizzando la variabile d’ambiente MCP_TIMEOUT (es. MCP_TIMEOUT=10000 claude imposta un timeout di 10 secondi)
  • Controlla lo stato del server MCP in qualsiasi momento utilizzando il comando /mcp all’interno di Claude Code
  • MCP segue un’architettura client-server dove Claude Code (il client) può connettersi a più server specializzati

​
Comprendere gli ambiti dei server MCP

Quando utilizzarlo: Vuoi capire come funzionano i diversi ambiti MCP e come condividere server con il tuo team.
1

Server MCP con ambito locale

L’ambito predefinito (local) memorizza le configurazioni del server MCP nelle impostazioni utente specifiche del progetto. Questi server sono disponibili solo per te mentre lavori nel progetto corrente.
# Aggiungere un server con ambito locale (predefinito)
claude mcp add my-private-server /percorso/del/server

# Specificare esplicitamente l'ambito locale
claude mcp add my-private-server -s local /percorso/del/server
2

Server MCP con ambito di progetto (.mcp.json)

I server con ambito di progetto sono memorizzati in un file .mcp.json nella radice del tuo progetto. Questo file dovrebbe essere inserito nel controllo versione per condividere i server con il tuo team.
# Aggiungere un server con ambito di progetto
claude mcp add shared-server -s project /percorso/del/server
Questo crea o aggiorna un file .mcp.json con la seguente struttura:
{
  "mcpServers": {
    "shared-server": {
      "command": "/percorso/del/server",
      "args": [],
      "env": {}
    }
  }
}
3

Server MCP con ambito utente

I server con ambito utente sono disponibili per te in tutti i progetti sul tuo computer e sono privati per te.
# Aggiungere un server utente
claude mcp add my-user-server -s user /percorso/del/server
Suggerimenti:
  • I server con ambito locale hanno la precedenza sui server con ambito di progetto e utente con lo stesso nome
  • I server con ambito di progetto (in .mcp.json) hanno la precedenza sui server con ambito utente con lo stesso nome
  • Prima di utilizzare server con ambito di progetto da .mcp.json, Claude Code ti chiederà di approvarli per motivi di sicurezza
  • Il file .mcp.json è destinato a essere inserito nel controllo versione per condividere server MCP con il tuo team
  • I server con ambito di progetto rendono facile garantire che tutti nel tuo team abbiano accesso agli stessi strumenti MCP
  • Se hai bisogno di reimpostare le tue scelte per quali server con ambito di progetto sono abilitati o disabilitati, usa il comando claude mcp reset-project-choices

​
Connettersi a un server MCP Postgres

Quando utilizzarlo: Vuoi dare a Claude accesso in sola lettura a un database PostgreSQL per query e ispezione dello schema.
1

Aggiungere il server MCP Postgres

claude mcp add postgres-server /percorso/del/postgres-mcp-server --connection-string "postgresql://utente:password@localhost:5432/miobd"
2

Interrogare il tuo database con Claude

# Nella tua sessione Claude, puoi chiedere informazioni sul tuo database

> descrivi lo schema della nostra tabella utenti
> quali sono gli ordini più recenti nel sistema?
> mostrami la relazione tra clienti e fatture
Suggerimenti:
  • Il server MCP Postgres fornisce accesso in sola lettura per sicurezza
  • Claude può aiutarti a esplorare la struttura del database ed eseguire query analitiche
  • Puoi utilizzarlo per comprendere rapidamente gli schemi di database in progetti non familiari
  • Assicurati che la tua stringa di connessione utilizzi credenziali appropriate con le autorizzazioni minime richieste

​
Aggiungere server MCP da configurazione JSON

Quando utilizzarlo: Hai una configurazione JSON per un singolo server MCP che vuoi aggiungere a Claude Code.
1

Aggiungere un server MCP da JSON

# Sintassi di base
claude mcp add-json <nome> '<json>'

# Esempio: Aggiungere un server stdio con configurazione JSON
claude mcp add-json weather-api '{"type":"stdio","command":"/percorso/del/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'
2

Verificare che il server sia stato aggiunto

claude mcp get weather-api
Suggerimenti:
  • Assicurati che il JSON sia correttamente escapato nella tua shell
  • Il JSON deve essere conforme allo schema di configurazione del server MCP
  • Puoi usare -s user per aggiungere il server alla tua configurazione utente invece che a quella specifica del progetto

​
Importare server MCP da Claude Desktop

Quando utilizzarlo: Hai già configurato server MCP in Claude Desktop e vuoi utilizzare gli stessi server in Claude Code senza doverli riconfigurare manualmente.
1

Importare server da Claude Desktop

# Sintassi di base 
claude mcp add-from-claude-desktop
2

Selezionare quali server importare

Dopo aver eseguito il comando, vedrai una finestra di dialogo interattiva che ti permette di selezionare quali server vuoi importare.
3

Verificare che i server siano stati importati

claude mcp list
Suggerimenti:
  • Questa funzionalità funziona solo su macOS e Windows Subsystem for Linux (WSL)
  • Legge il file di configurazione di Claude Desktop dalla sua posizione standard su quelle piattaforme
  • Usa il flag -s user per aggiungere server alla tua configurazione utente
  • I server importati avranno gli stessi nomi di quelli in Claude Desktop
  • Se esistono già server con gli stessi nomi, riceveranno un suffisso numerico (es. server_1)

​
Usare Claude Code come server MCP

Quando utilizzarlo: Vuoi utilizzare Claude Code stesso come server MCP a cui altre applicazioni possono connettersi, fornendo loro gli strumenti e le capacità di Claude.
1

Avviare Claude come server MCP

# Sintassi di base
claude mcp serve
2

Connettersi da un'altra applicazione

Puoi connetterti al server MCP di Claude Code da qualsiasi client MCP, come Claude Desktop. Se stai utilizzando Claude Desktop, puoi aggiungere il server MCP di Claude Code utilizzando questa configurazione:
{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}
Suggerimenti:
  • Il server fornisce accesso agli strumenti di Claude come View, Edit, LS, ecc.
  • In Claude Desktop, prova a chiedere a Claude di leggere file in una directory, fare modifiche e altro.
  • Nota che questo server MCP sta semplicemente esponendo gli strumenti di Claude Code al tuo client MCP, quindi il tuo client è responsabile dell’implementazione della conferma dell’utente per le singole chiamate agli strumenti.

​
Usare Claude come utility unix

​
Aggiungere Claude al tuo processo di verifica

Quando utilizzarlo: Vuoi utilizzare Claude Code come linter o revisore di codice. Passi:
1

Aggiungere Claude al tuo script di build

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'sei un linter. per favore guarda le modifiche rispetto a main e segnala eventuali problemi relativi a errori di battitura. riporta il nome del file e il numero di riga su una riga, e una descrizione del problema sulla seconda riga. non restituire nessun altro testo.'"
    }
}

​
Pipe in, pipe out

Quando utilizzarlo: Vuoi inviare dati a Claude tramite pipe e ricevere dati in un formato strutturato.
1

Inviare dati attraverso Claude tramite pipe

cat build-error.txt | claude -p 'spiega in modo conciso la causa principale di questo errore di build' > output.txt

​
Controllare il formato di output

Quando utilizzarlo: Hai bisogno dell’output di Claude in un formato specifico, specialmente quando integri Claude Code in script o altri strumenti.
1

Utilizzare il formato testo (predefinito)

cat data.txt | claude -p 'riassumi questi dati' --output-format text > summary.txt
Questo produce solo la risposta in testo semplice di Claude (comportamento predefinito).
2

Utilizzare il formato JSON

cat code.py | claude -p 'analizza questo codice per bug' --output-format json > analysis.json
Questo produce un array JSON di messaggi con metadati inclusi costo e durata.
3

Utilizzare il formato JSON in streaming

cat log.txt | claude -p 'analizza questo file di log per errori' --output-format stream-json
Questo produce 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 solo bisogno della risposta di Claude
  • Usa --output-format json quando hai bisogno del log completo della conversazione
  • Usa --output-format stream-json per l’output in tempo reale di ogni turno di conversazione

​
Creare comandi slash personalizzati

Claude Code supporta comandi slash personalizzati che puoi creare per eseguire rapidamente prompt o attività specifiche.

​
Creare comandi specifici per il progetto

Quando utilizzarlo: Vuoi creare comandi slash riutilizzabili per il tuo progetto che tutti i membri del team possono utilizzare.
1

Creare una directory dei comandi nel tuo progetto

mkdir -p .claude/commands
2

Creare un file Markdown per ogni comando

echo "Analizza le prestazioni di questo codice e suggerisci tre ottimizzazioni specifiche:" > .claude/commands/optimize.md
3

Utilizzare il tuo comando personalizzato in Claude Code

claude > /project:optimize
Suggerimenti:
  • I nomi dei comandi derivano dal nome del file (es. optimize.md diventa /project:optimize)
  • Puoi organizzare i comandi in sottodirectory (es. .claude/commands/frontend/component.md diventa /project:frontend:component)
  • I comandi di progetto sono disponibili per 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

Quando utilizzarlo: Vuoi creare comandi slash flessibili che possono accettare input aggiuntivi dagli utenti.
1

Creare un file di comando con il segnaposto $ARGUMENTS

echo "Trova e correggi il problema #$ARGUMENTS. Segui questi passaggi: 1.
Comprendi il problema descritto nel ticket 2. Individua il codice rilevante nella
nostra base di codice 3. Implementa una soluzione che affronti la causa principale 4. Aggiungi
test appropriati 5. Prepara una descrizione concisa della PR" >
.claude/commands/fix-issue.md
2

Utilizzare il comando con un numero di problema

claude > /project:fix-issue 123
Questo sostituirà $ARGUMENTS con “123” nel prompt.
Suggerimenti:
  • Il segnaposto $ARGUMENTS viene sostituito con qualsiasi testo che segue il comando
  • Puoi posizionare $ARGUMENTS ovunque nel tuo modello di comando
  • Altre applicazioni utili: generare casi di test per funzioni specifiche, creare documentazione per componenti, rivedere codice in file particolari o tradurre contenuti in lingue specificate

​
Creare comandi slash personali

Quando utilizzarlo: Vuoi creare comandi slash personali che funzionano in tutti i tuoi progetti.
1

Creare una directory dei comandi nella tua cartella home

mkdir -p ~/.claude/commands
2

Creare un file Markdown per ogni comando

echo "Rivedi questo codice per vulnerabilità di sicurezza, concentrandoti su:" >
~/.claude/commands/security-review.md
3

Utilizzare il tuo comando personalizzato personale

claude > /user:security-review
Suggerimenti:
  • I comandi personali hanno il prefisso /user: invece di /project:
  • I comandi personali sono disponibili solo per te e non sono condivisi con il tuo team
  • I comandi personali funzionano in tutti i tuoi progetti
  • Puoi utilizzarli per flussi di lavoro coerenti tra diverse basi di codice

​
Eseguire sessioni parallele di Claude Code con Git worktrees

​
Utilizzare worktrees per ambienti di codifica isolati

Quando utilizzarlo: Hai bisogno di lavorare su più attività contemporaneamente con completo isolamento del codice tra istanze di Claude Code.
1

Comprendere Git worktrees

Git worktrees ti permette di estrarre più branch dallo stesso repository in directory separate. Ogni worktree ha la propria directory di lavoro con file isolati, mentre condivide la stessa cronologia Git. Scopri di più nella documentazione ufficiale di Git worktree.
2

Creare un nuovo worktree

# Creare un nuovo worktree con un nuovo branch 
git worktree add ../project-feature-a -b feature-a

# Oppure creare un worktree con un branch esistente
git worktree add ../project-bugfix bugfix-123
Questo crea una nuova directory con una copia di lavoro separata del tuo repository.
3

Eseguire Claude Code in ogni worktree

# Navigare al tuo worktree 
cd ../project-feature-a

# Eseguire Claude Code in questo ambiente isolato
claude
4

In un altro terminale:
cd ../project-bugfix
claude
5

Gestire i tuoi worktrees

# Elencare tutti i worktrees
git worktree list

# Rimuovere un worktree quando hai finito
git worktree remove ../project-feature-a
Suggerimenti:
  • Ogni worktree ha il proprio stato di file indipendente, rendendolo perfetto per sessioni parallele di Claude Code
  • Le modifiche apportate in un worktree non influenzeranno gli altri, impedendo alle istanze di Claude di interferire tra loro
  • Tutti i worktrees condividono la stessa cronologia Git e connessioni remote
  • Per attività 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 attività è ciascun 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 l’installazione delle dipendenze (npm install, yarn)
    • Progetti Python: Configurare ambienti virtuali o installare con gestori di pacchetti
    • Altri linguaggi: Seguire il processo di configurazione standard del tuo progetto

​
Prossimi passi

Implementazione di riferimento di Claude Code

Clona la nostra implementazione di riferimento del container di sviluppo.