Punti Chiave
- Nativo del terminale, non un chatbot: Claude Code viene eseguito direttamente sui tuoi file locali, indicizza l'intera struttura del progetto e opera attraverso un sistema di permessi in cui approvi ogni modifica ai file e l'esecuzione di ogni comando.
- Plan Mode per attività complesse: Dì a Claude di pianificare il suo approccio prima di apportare modifiche: analizza il problema, delinea i passaggi, mostra il ragionamento e attende la tua approvazione prima dell'esecuzione.
- Sonnet per l'80%, Opus per il 20%: Usa Sonnet 4.6 per le attività quotidiane (veloce, economico); passa a Opus 4.6 per refactoring complessi multi-file, decisioni architetturali o Agent Teams.
- CLAUDE.md aumenta la coerenza: Crea un file CLAUDE.md specifico per il progetto con convenzioni di codifica, preferenze per il tech stack e requisiti di test che Claude legge automaticamente in ogni sessione.
Tutorial Claude Code per Principianti: Guida Completa per Iniziare
Claude Code è l'assistente alla programmazione basato su AI che vive nel tuo terminale.
Sviluppato da Anthropic, si connette direttamente alla tua codebase, comprende la struttura del tuo progetto e scrive codice reale sulla tua macchina — il tutto tramite conversazioni in linguaggio naturale. Dalla sua disponibilità generale nel maggio 2025, Claude Code è diventato uno degli strumenti di sviluppo AI più adottati, contribuendo al raggiungimento da parte di Anthropic di oltre 1 miliardo di dollari di entrate annualizzate entro novembre 2025.
Questo tutorial ti porterà da zero alla produttività. Non è richiesta alcuna esperienza precedente con strumenti di AI.
Indice dei contenuti
- Che cos'è Claude Code?
- Prerequisiti e installazione
- La tua prima sessione
- Riferimento ai comandi essenziali
- Plan Mode: pensa prima di programmare
- Configurazione di CLAUDE.md
- Esempi di workflow nel mondo reale
- Scegliere tra Sonnet 4.6 e Opus 4.6
- Suggerimenti per ottenere il massimo da Claude Code
Che cos'è Claude Code?
Claude Code è l'assistente alla programmazione AI nativo del terminale di Anthropic. A differenza dei chatbot basati su browser o delle estensioni IDE, viene eseguito direttamente all'interno del terminale e opera sui file locali.
Ecco cosa lo rende diverso:
- Consapevolezza profonda della codebase — Claude indicizza l'intero progetto e comprende la relazione tra i file
- Ragionamento interattivo — mostra il suo processo di pensiero e chiede il tuo input nei momenti decisionali
- Esecuzione locale — modifica file ed esegue comandi sulla tua macchina, non in una sandbox remota
- Sistema di permessi — ogni modifica ai file e ogni esecuzione di comandi richiede la tua approvazione
Claude Code è alimentato da Claude Opus 4.6 e Claude Sonnet 4.6, i modelli più avanzati di Anthropic. Supporta una context window standard da 200K, con una beta da 1M token disponibile su Opus 4.6.
"Claude Code non è un chatbot. È un agente di programmazione che comunica attraverso la conversazione."
Prerequisiti e installazione
Di cosa hai bisogno
Prima di installare, assicurati di avere:
- Un abbonamento a Claude — Claude Pro ($20/mese) come minimo
- Un'applicazione terminale — Terminal.app (macOS), il tuo terminale Linux preferito o Windows Terminal
- Un sistema operativo supportato — macOS, Linux o Windows 11
- Node.js — richiesto per il metodo di installazione tramite npm
Passaggio 1: Installa Claude Code
Apri il terminale ed esegui:
npm install -g @anthropic-ai/claude-code
In alternativa, puoi installarlo tramite lo script ufficiale:
curl -fsSL https://claude.ai/install.sh | sh
Passaggio 2: Verifica l'installazione
claude --version
Dovresti vedere stampato il numero della versione corrente. Se ricevi un errore "command not found", assicurati che la directory bin di Node.js sia nel tuo PATH.
Passaggio 3: Vai al tuo progetto
Claude Code funziona meglio se avviato dalla root del tuo progetto:
cd ~/projects/my-app
claude
Tutto qui. Claude scansionerà il tuo progetto e sarai pronto per iniziare.
La tua prima sessione
Quando avvii claude per la prima volta all'interno di un progetto, ecco cosa succede:
- Claude indicizza i file e la struttura del tuo progetto
- Apre un prompt interattivo in cui scrivi in linguaggio naturale
- Fai domande o fornisci istruzioni e Claude risponde con codice, modifiche o spiegazioni
Una prima semplice interazione
Prova a iniziare con qualcosa di simile:
> What does this project do? Summarize the tech stack and folder structure.
Claude scansionerà i tuoi file e ti fornirà una suddivisione strutturata del tuo progetto — i framework, gli entry point, i moduli chiave.
Prosegui con un compito reale:
> Add input validation to the signup form. Email should be validated and password needs at least 8 characters.
Claude farà quanto segue:
- Trovare il componente del form pertinente
- Mostrarti il suo piano per le modifiche
- Chiedere il tuo permesso prima di modificare qualsiasi file
- Applicare le modifiche e confermare cosa è stato cambiato
Mantieni sempre il controllo. Nulla accade senza la tua approvazione.
Riferimento ai comandi essenziali
Questi sono i comandi che userai più spesso all'interno di una sessione di Claude Code:
| Comando | Cosa fa |
|---|---|
claude | Inizia una nuova sessione di Claude Code |
/help | Mostra tutti i comandi disponibili |
/plan | Entra in Plan Mode — Claude pianifica prima di eseguire |
/clear | Pulisce il contesto della conversazione e ricomincia da capo |
/cost | Mostra l'utilizzo dei tokens e i costi stimati per la sessione |
/compact | Comprime la conversazione per risparmiare spazio nella context window |
Non è necessario memorizzare i comandi slash per essere produttivi. La maggior parte delle volte, scrivi semplicemente la tua richiesta in linguaggio naturale e Claude capisce il resto.
Plan Mode: pensa prima di programmare
Plan Mode è una delle funzionalità più importanti di Claude Code, specialmente per i principianti.
Quando entri in Plan Mode con /plan, Claude cambia il suo comportamento:
- Analizza il problema — legge i file rilevanti, traccia le dipendenze, identifica le aree interessate
- Delinea un piano passo dopo passo — cosa cambierà, in quale ordine e perché
- Mostra il suo ragionamento — vedi come Claude ragiona sul problema
- Aspetta la tua approvazione — nulla viene eseguito finché non dai il via libera
Quando usare Plan Mode
- Refactoring complesso — rinominare un modulo importato in dozzine di file
- Funzionalità multi-file — aggiungere un nuovo endpoint API che coinvolge route, controller, modelli e test
- Codebase sconosciute — quando vuoi capire l'impatto prima di apportare modifiche
- Apprendimento — leggere il ragionamento di Claude ti aiuta a capire meglio la tua stessa codebase
Esempio: Plan Mode in azione
> /plan
> Refactor the authentication module to use JWT tokens instead of session cookies.
Claude risponderà con qualcosa di simile:
Ecco il mio piano:
- Aggiornare
auth/middleware.jsper verificare i token JWT invece di controllare lo store di sessione- Modificare
auth/login.jsper generare e restituire un JWT al login riuscito- Aggiornare
auth/logout.jsper gestire l'invalidazione del token- Regolare il client API in
frontend/src/api.jsper inviare i token nell'header Authorization- Aggiornare 3 file di test per utilizzare fixture di autenticazione basate su JWT
Posso procedere?
Tu esamini, fai domande, modifichi il piano se necessario e poi approvi.
Configurazione di CLAUDE.md
CLAUDE.md è un file speciale che Claude legge automaticamente all'inizio di ogni sessione. Pensalo come un file di configurazione su come Claude dovrebbe comportarsi nel tuo progetto.
Crea il tuo CLAUDE.md
Posizionalo nella root del tuo progetto:
# Progetto: My SaaS App
## Tech Stack
- Next.js 14 con App Router
- TypeScript (strict mode)
- Tailwind CSS
- PostgreSQL con Prisma ORM
## Convenzioni di codifica
- Usa componenti funzionali con hook (nessun componente a classe)
- Tutte le funzioni devono avere tipi di ritorno TypeScript
- Usa export nominati, non export predefiniti
- Scrivi test per tutte le nuove funzioni di utilità
## Testing
- Esegui i test con: npm run test
- Usa Vitest per i unit test
- I file di test vanno nelle directory __tests__ accanto ai file sorgente
## Git
- Conventional commits: feat(), fix(), refactor()
- Crea sempre un nuovo branch per le funzionalità
Perché CLAUDE.md è importante
Senza CLAUDE.md, Claude fa delle ipotesi ragionevoli sulle tue convenzioni. Con esso, Claude segue i tuoi standard esatti fin dal primo prompt. Questo è particolarmente prezioso nei team in cui la coerenza è fondamentale.
Esempi di workflow nel mondo reale
Debug di un problema in produzione
> Users are reporting that the dashboard takes 15 seconds to load.
> Check the API calls on the dashboard page and identify any performance bottlenecks.
Claude traccerà il componente della dashboard, troverà le chiamate API, verificherà la presenza di query N+1 o indici mancanti e suggerirà correzioni specifiche.
Aggiunta di una nuova funzionalità
> Add a dark mode toggle to the app. It should persist the user's preference
> in localStorage and apply on page load without a flash of unstyled content.
Claude identificherà dove aggiungere il componente del selettore, configurerà il contesto del tema, aggiungerà la logica del localStorage e gestirà correttamente il rendering iniziale.
Refactoring di codice legacy
> /plan
> This file uses callback-based async patterns. Refactor it to use async/await
> while keeping the same external API.
Claude pianifica il refactoring, mostra quali funzioni cambiano e conferma che nulla si rompa esternamente prima di procedere.
Integrazione con Git
Claude Code funziona direttamente con Git. Puoi chiedergli di:
> Create a new branch called feat/dark-mode, commit the changes we just made,
> and open a pull request with a description of what was changed.
Claude creerà il branch, aggiungerà i file all'area di stage, scriverà un messaggio di commit e userà la GitHub CLI per aprire una PR — il tutto all'interno della tua sessione di terminale.
Scegliere tra Sonnet 4.6 e Opus 4.6
Claude Code ti dà accesso a due modelli. Scegliere quello giusto ti fa risparmiare tempo e denaro.
| Sonnet 4.6 | Opus 4.6 | |
|---|---|---|
| Velocità | Veloce | Più lento |
| Costo (API) | $3 / $15 per 1M tokens | $15 / $75 per 1M tokens |
| Ideale per | La maggior parte delle attività quotidiane | Architetture complesse, refactoring multi-file |
| Context window | 200K tokens | 200K standard, 1M beta |
| Agent Teams | Non disponibile | Disponibile (solo Opus) |
La regola dell'80/20
Usa Sonnet 4.6 per circa l'80% del tuo lavoro: scrivere funzioni, correggere bug, aggiungere funzionalità, scrivere test, spiegare il codice. È veloce, economico e più che capace.
Passa a Opus 4.6 per il 20% più difficile: refactoring su larga scala su molti file, decisioni architetturali complesse, Agent Teams per il lavoro parallelo o quando hai bisogno della context window da 1M di token per analizzare una codebase di grandi dimensioni.
Suggerimenti per ottenere il massimo da Claude Code
1. Inizia ogni progetto con il contesto. Prima di immergerti nelle attività, chiedi a Claude di riassumere cosa fa il progetto. Questo aiuta Claude a costruire un modello mentale accurato e si traduce in un codice migliore fin dal primo prompt.
> What does this project do? Walk me through the architecture.
2. Usa Plan Mode per qualsiasi cosa complessa.
Se un'attività tocca più di due file, usa /plan. Il costo iniziale della pianificazione ti risparmia modifiche errate che sono più difficili da annullare.
3. Sii specifico nelle tue richieste.
Invece di "rendi il codice migliore", prova con "esegui il refactoring della funzione processPayment per gestire gli addebiti Stripe falliti e riprova fino a 3 volte con un backoff esponenziale".
4. Usa /compact quando raggiungi i limiti di contesto.
Le sessioni lunghe accumulano contesto. Quando Claude inizia a perdere traccia delle conversazioni precedenti, esegui /compact per comprimere la cronologia e liberare spazio.
5. Crea e mantieni il tuo CLAUDE.md.
Questa è la singola azione a più alto rendimento che puoi fare. Un buon CLAUDE.md elimina le correzioni ripetitive e mantiene Claude allineato con gli standard del tuo team.
6. Esamina i diff prima di approvare. Il sistema di permessi di Claude esiste per una ragione. Leggi le modifiche proposte, specialmente per codebase sconosciute. Claude è potente ma non infallibile.
7. Usa l'integrazione Git per workflow puliti. Lascia che Claude gestisca le parti meccaniche di Git — creazione di branch, commit, scrittura di descrizioni di PR — così puoi concentrarti sulla revisione delle modifiche effettive al codice.
8. Concatena le attività in una singola sessione. Claude ricorda il contesto all'interno di una sessione. Dopo aver costruito una funzionalità, prosegui immediatamente con "ora scrivi i test per ciò che abbiamo appena aggiunto" — Claude già conosce il codice.
Cosa fare dopo?
Ora hai tutto ciò di cui hai bisogno per iniziare a usare Claude Code in modo produttivo. La curva di apprendimento è breve: la maggior parte degli sviluppatori trova il proprio ritmo entro le prime sessioni.
Man mano che prendi confidenza, esplora queste funzionalità più avanzate:
- Agent Teams — avvia più istanze di Claude per il lavoro parallelo su progetti di grandi dimensioni (solo Opus 4.6)
- Context window da 1M di token — analizza codebase enormi in una singola sessione (Opus 4.6 beta)
- Comandi slash personalizzati — automatizza workflow ripetitivi con comandi specifici del progetto
- Integrazione CI/CD — esegui Claude Code come parte della tua pipeline di build e review
Il terminale è il luogo in cui gli sviluppatori vivono già. Claude Code ti incontra lì e ti rende più veloce.
Articoli Correlati
- Migliore AI per la programmazione nel 2026: 10 strumenti classificati in base alle prestazioni nel mondo reale
- Claude Opus 4.6 Agent Teams: Come configurare agenti di programmazione AI paralleli (Tutorial 2026)
- Guida OpenAI Frontier: Piattaforma di agenti AI aziendali per la creazione di collaboratori AI (2026)
