Tutorial di Claude Code

Questa guida fornisce tutorial passo-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

• Comprendere nuove basi di codice
• Correggere bug in modo efficiente
• Refactoring del codice
• Lavorare con i test
• Creare pull request
• Gestire la documentazione
• Utilizzare flussi di lavoro git avanzati
• Lavorare con le immagini
• Configurare la memoria del progetto
• Usare Claude come utility unix
• Configurare il Model Context Protocol (MCP)

​

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 /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 generali, 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 il codice pertinente

Quando utilizzarlo: Devi localizzare il codice relativo a una specifica funzionalità.

> trova i file che gestiscono l'autenticazione utente

> 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
• Usa il linguaggio del dominio del progetto

​

Correggere bug in modo efficiente

​

Diagnosticare messaggi di errore

Quando utilizzarlo: 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 il codice legacy

Quando utilizzarlo: 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 sottoposto a refactoring

Suggerimenti:

• Chiedi a Claude di spiegare i benefici dell’approccio moderno
• Richiedi che le modifiche mantengano la compatibilità all’indietro quando necessario
• Esegui il refactoring in piccoli incrementi testabili

​

Lavorare con i test

​

Aggiungere copertura dei test

Quando utilizzarlo: 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 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: Devi creare una pull request ben documentata per le tue modifiche.

> riassumi le modifiche che ho fatto 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 utilizzarlo: 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 utilizzarlo: Devi lavorare con immagini nella tua base di codice o ottenere l’aiuto di Claude nell’analizzare il contenuto delle immagini.

# 1. Trascina e rilascia un'immagine nella finestra di Claude Code

# 2. Copia un'immagine e incollala nella CLI con ctrl+v

# 3. Fornisci un percorso dell'immagine
$ claude
> Analizza questa immagine: /path/to/your/image.png

> 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

​

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 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 pattern architetturali importanti specifici per il tuo progetto
• Puoi aggiungere file CLAUDE.md alla cartella in cui esegui Claude, nelle directory padre (Claude li legge automaticamente) o nelle directory figlie (Claude li include su richiesta)

​

Usare Claude come utility unix

​

Aggiungere Claude al tuo processo di verifica

Quando utilizzarlo: Vuoi utilizzare 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 ai refusi. riporta il nome del file e il numero di riga su una riga, e una descrizione del problema sulla seconda riga. non restituire altro testo.'"
    }
}

​

Pipe in, pipe out

Quando utilizzarlo: Vuoi inviare dati a Claude 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

​

Configurare il Model Context Protocol (MCP)

Model Context Protocol (MCP) è un protocollo aperto che permette agli LLM di accedere a strumenti e fonti di dati esterni. Per maggiori dettagli, consulta la documentazione MCP.

​

Configurare server MCP

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

# Sintassi base
$ claude mcp add <nome> <comando> [argomenti...]

# Esempio: Aggiungere un server locale
$ claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2

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

• Usa il flag -s o --scope con project (predefinito) o global per specificare dove viene memorizzata la configurazione
• Imposta variabili d’ambiente con i flag -e o --env (es. -e CHIAVE=valore)
• MCP segue un’architettura client-server dove Claude Code (il client) può connettersi a più server specializzati

​

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 /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"

# Nella tua sessione Claude, puoi chiedere informazioni sul tuo database
$ claude
> 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 necessari

​

Prossimi passi