Tutorial

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
• Comprendere nuove basi di codice
• Risolvere bug in modo efficiente
• Refactoring del codice
• Lavorare con i test
• Creare pull request
• Gestire la documentazione
• Lavorare con le immagini
• Utilizzare il pensiero esteso
• Configurare la memoria del progetto
• Configurare il Model Context Protocol (MCP)
• Usare Claude come utility unix
• Creare comandi slash personalizzati
• Eseguire sessioni parallele di Claude Code con Git worktrees

​

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

claude --continue

claude --continue --print "Continua con il mio compito"

claude --resume

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.

cd /percorso/del/progetto 

claude 

> dammi una panoramica di questa base di codice 

> 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à.

> trova i file che gestiscono l'autenticazione degli utenti 

> come lavorano insieme questi file di autenticazione? 

> 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.

> Sto vedendo un errore quando eseguo npm test 

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

> 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.

> trova utilizzi di API deprecate nella nostra base di codice 

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

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

> 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.

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

> aggiungi test per il servizio di notifica 

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

> 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.

> riassumi le modifiche che ho apportato al modulo di autenticazione 

> crea una pr 

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

> 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.

> trova funzioni senza commenti JSDoc appropriati nel modulo auth 

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

> migliora la documentazione generata con più contesto ed esempi 

> 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.

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

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

> 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.

> 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. 

> 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.

​

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.

> /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.

​

Configurare server MCP

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

# 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

# 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

# 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.

# 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

# Aggiungere un server con ambito di progetto
claude mcp add shared-server -s project /percorso/del/server

{
  "mcpServers": {
    "shared-server": {
      "command": "/percorso/del/server",
      "args": [],
      "env": {}
    }
  }
}

# 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.

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

# 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.

# 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"}}'

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 global per aggiungere il server alla tua configurazione globale 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.

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

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 global per aggiungere server alla tua configurazione globale
• 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.

# Sintassi di base
claude mcp serve

{
  "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:

// 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.

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.

cat data.txt | claude -p 'riassumi questi dati' --output-format text > summary.txt

cat code.py | claude -p 'analizza questo codice per bug' --output-format json > analysis.json

cat log.txt | claude -p 'analizza questo file di log per errori' --output-format stream-json

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.

mkdir -p .claude/commands

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

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.

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 

claude > /project:fix-issue 123 

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.

mkdir -p ~/.claude/commands 

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

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.

# 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

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

# Eseguire Claude Code in questo ambiente isolato
claude

cd ../project-bugfix
claude

# 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