Tutorial

Questa guida fornisce tutorial passo dopo passo per i 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
• Correggere 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 usarlo: Hai lavorato su un’attività con Claude Code e devi continuare da dove ti eri fermato in una sessione successiva.

Claude Code fornisce due opzioni per riprendere le 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: Durante la ripresa, viene ripristinata l’intera cronologia dei messaggi per mantenere il contesto
3. Stato degli strumenti: L’utilizzo degli strumenti e i risultati della conversazione precedente vengono preservati
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:

# Continua la conversazione più recente
claude --continue

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

# Mostra il selettore di conversazioni
claude --resume

# Continua 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 usarlo: Ti sei appena unito a un nuovo progetto e hai bisogno di comprenderne rapidamente la struttura.

cd /path/to/project 

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 i pattern utilizzati nel progetto
• Richiedi un glossario dei termini specifici del progetto

​

Trovare codice rilevante

Quando usarlo: Devi localizzare il 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 cosa stai cercando
• Usa il linguaggio di dominio del progetto

​

Correggere bug in modo efficiente

​

Diagnosticare messaggi di errore

Quando usarlo: Hai incontrato un messaggio di errore e devi 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 usarlo: Devi aggiornare il vecchio codice per utilizzare pattern e pratiche moderne.

> trova l'utilizzo 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 le funzionalità ES2024 mantenendo lo stesso comportamento 

> esegui i test per il codice refactorizzato 

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

​

Lavorare con i test

​

Aggiungere copertura dei test

Quando usarlo: Devi 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 le 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 usarlo: Devi 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 della sicurezza 

> aggiungi informazioni su come sono state testate queste modifiche 

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 usarlo: Devi 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 usarlo: Devi 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 UI in questo screenshot 
> Ci sono elementi problematici in questo diagramma? 

> Ecco uno screenshot dell'errore. Cosa lo sta causando? 
> Questo è il nostro schema 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:

• Usa le immagini quando le descrizioni testuali sarebbero poco chiare o ingombranti
• Includi screenshot di errori, design UI o diagrammi per un migliore contesto
• Puoi lavorare con più immagini in una conversazione
• L’analisi delle immagini funziona con diagrammi, screenshot, mockup e altro

​

Utilizzare il pensiero esteso

​

Sfrutta il pensiero esteso di Claude per compiti complessi

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

> Ho bisogno di implementare un nuovo sistema di autenticazione usando OAuth2 per la nostra API. Pensa approfonditamente 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 solleciti il pensiero risulta in vari livelli di profondità di pensiero:

• “pensa” attiva il pensiero esteso di base
• frasi intensificanti come “pensa di più”, “pensa molto”, “pensa più duramente” o “pensa più a lungo” attivano un pensiero più profondo

Per ulteriori suggerimenti sul prompt del pensiero esteso, vedi Suggerimenti per il pensiero esteso.

​

Configurare la memoria del progetto

​

Creare un file CLAUDE.md efficace

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

> /init 

Suggerimenti:

• Includi comandi frequentemente utilizzati (build, test, lint) per evitare ricerche ripetute
• Documenta le preferenze di stile del codice e le convenzioni di denominazione
• Aggiungi importanti pattern architetturali specifici del tuo progetto
• Le memorie CLAUDE.md possono essere utilizzate 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 e fonti di dati esterni. Per maggiori dettagli, vedi la documentazione MCP.

​

Configurare server MCP

Quando usarlo: Vuoi migliorare le capacità di Claude connettendolo 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 -- /path/to/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

# Elenca tutti i server configurati
claude mcp list

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

# Rimuovi un server
claude mcp remove my-server

Suggerimenti:

• Usa il flag -s o --scope per specificare dove viene memorizzata la configurazione:
  • local (predefinito): Disponibile solo per te nel progetto corrente (si chiamava project nelle versioni precedenti)
  • project: Condiviso con tutti nel progetto tramite file .mcp.json
  • user: Disponibile per te in tutti i progetti (si chiamava global nelle versioni precedenti)
• Imposta variabili d’ambiente con i flag -e o --env (es. -e KEY=value)
• Configura il timeout di avvio del server MCP usando 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 usando 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 scope dei server MCP

Quando usarlo: Vuoi capire come funzionano i diversi scope MCP e come condividere i server con il tuo team.

# Aggiungi un server con scope locale (predefinito)
claude mcp add my-private-server /path/to/server

# Specifica esplicitamente lo scope locale
claude mcp add my-private-server -s local /path/to/server

# Aggiungi un server con scope di progetto
claude mcp add shared-server -s project /path/to/server

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

# Aggiungi un server utente
claude mcp add my-user-server -s user /path/to/server

Suggerimenti:

• I server con scope locale hanno la precedenza sui server con scope di progetto e utente con lo stesso nome
• I server con scope di progetto (in .mcp.json) hanno la precedenza sui server con scope utente con lo stesso nome
• Prima di utilizzare i server con scope di progetto da .mcp.json, Claude Code ti chiederà di appro

varli per sicurezza

• Il file .mcp.json è destinato ad essere inserito nel controllo versione per condividere i server MCP con il tuo team
• I server con scope di progetto rendono facile assicurarsi che tutti nel tuo team abbiano accesso agli stessi strumenti MCP
• Se hai bisogno di reimpostare le tue scelte per quali server con scope di progetto sono abilitati o disabilitati, usa il comando claude mcp reset-project-choices

​

Connettere a un server MCP Postgres

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

claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

# Nella tua sessione Claude, puoi chiedere del tuo database

> descrivi lo schema della nostra tabella users
> 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 usarlo per comprendere rapidamente gli schemi del database in progetti non familiari
• Assicurati che la tua stringa di connessione utilizzi credenziali appropriate con i permessi minimi richiesti

​

Aggiungere server MCP da configurazione JSON

Quando usarlo: 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":"/path/to/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 usarlo: Hai già configurato server MCP in Claude Desktop e vuoi usare gli stessi server in Claude Code senza riconfigurarli 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 che hanno 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 usarlo: Vuoi usare 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 utente per le singole chiamate agli strumenti

​

Usare Claude come utility unix

​

Aggiungere Claude al tuo processo di verifica

Quando usarlo: Vuoi usare Claude Code come linter o revisore di codice.

Passaggi:

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'sei un linter. per favore guarda le modifiche rispetto al 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 usarlo: Vuoi inviare dati a Claude tramite pipe e ricevere dati in un formato strutturato.

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

​

Controllare il formato di output

Quando usarlo: 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 della conversazione

​

Creare comandi slash personalizzati

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

​

Creare comandi specifici del progetto

Quando usarlo: Vuoi creare comandi slash riutilizzabili per il tuo progetto che tutti i membri del team possono usare.

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 del 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 usarlo: Vuoi creare comandi slash flessibili che possono accettare input aggiuntivi dagli utenti.

echo "Trova e correggi l'issue #$ARGUMENTS. Segui questi passaggi: 1.
Comprendi il problema descritto nel ticket 2. Localizza 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 template 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 usarlo: 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 usarli per flussi di lavoro coerenti tra diverse basi di codice

​

Eseguire sessioni parallele di Claude Code con Git worktrees

​

Usare worktrees per ambienti di codifica isolati

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

# Crea un nuovo worktree con un nuovo branch git worktree add
../project-feature-a feature-a # Oppure crea un worktree con un branch esistente
git worktree add ../project-bugfix bugfix-123 

# Naviga nel tuo worktree 
cd ../project-feature-a # Esegui Claude Code in questo ambiente isolato claude 

cd ../project-bugfix claude

# Elenca tutti i worktrees git worktree list # Rimuovi un worktree quando hai finito
git worktree remove ../project-feature-a 

Suggerimenti:

• Ogni worktree ha il proprio stato dei file indipendente, rendendolo perfetto per sessioni parallele di Claude Code
• Le modifiche fatte in un worktree non influenzano gli altri, impedendo alle istanze di Claude di interferire tra loro
• Tutti i worktrees condividono la stessa storia Git e connessioni remote
• Per attività di lunga durata, puoi far lavorare Claude in un worktree mentre continui lo sviluppo in un altro
• Usa nomi di directory descrittivi per identificare facilmente per quale attività è ogni worktree
• Ricorda di inizializzare il tuo ambiente di sviluppo in ogni nuovo worktree secondo il setup 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 setup standard del tuo progetto

​

Prossimi passi