Questo Claude Code tutorial ti porta da zero al primo lavoro vero: si installa con un solo comando da terminale, si accede con un account Claude a pagamento, si apre una cartella di progetto e si scrive a Claude cosa fare, come a un collega. Il resto è imparare a dosare i permessi e a lasciargli delle istruzioni fisse. I passaggi qui sotto seguono la documentazione ufficiale di Anthropic, consultata l’11 novembre 2026, e i prezzi la pagina dei piani consultata il 16 novembre 2026.
In breve
- Serve un account Claude Pro, Max, Ultra, Team o Enterprise, oppure un account Console o un provider cloud supportato: il piano gratuito di claude.ai non include Claude Code.
- Il piano più economico che lo include è Pro: 20 $ al mese, oppure 17 $ al mese con abbonamento annuale (200 $ l’anno).
- L’installazione consigliata è quella nativa, un comando per sistema operativo; si verifica con
claude --version. - Si parte scrivendo
claudedentro la cartella del progetto: al primo avvio si fa il login dal browser. - With
Shift+Tabcambi la modalità di permesso; la modalità Plan fa leggere e proporre senza modificare nulla. - Le istruzioni che vuoi sempre valide vanno in un file CLAUDE.md.
I numeri da sapere prima di cominciare
Secondo la pagina di setup di Anthropic (11 novembre 2026) e la pagina dei piani (16 novembre 2026), questi sono i valori che contano all’avvio:
- 20 $ al mese per Pro (17 $ al mese con fatturazione annuale da 200 $), 100 $ al mese per Max, con 5 volte l’utilizzo di Pro, e 200 $ al mese per Ultra, con 10 volte l’utilizzo di Pro su base settimanale. Tutti e tre includono Claude Code.
- 4 GB di RAM come minimo, su processore x64 o ARM64.
- macOS 13.0 o successivo, Windows 10 versione 1809 o successivo, Ubuntu 20.04 o successivo, Debian 10 o successivo, Alpine 3.19 o successivo.
- Node.js 22 o successivo, solo se scegli l’installazione con npm; l’installazione nativa non lo richiede.
- 6 modalità di permesso, da Manual a Bypass permissions.
- Circa 1 settimana di ritardo per il canale di aggiornamento «stable» rispetto a «latest».
- 5 tipi di account a pagamento supportati: Pro, Max, Ultra, Team ed Enterprise.
Claude Code come si installa
Apri un terminale e incolla il comando del tuo sistema.
| Sistema | Comando (installazione nativa) |
|---|---|
| macOS, Linux, WSL | curl -fsSL https://claude.ai/install.sh | bash |
| Windows PowerShell | irm https://claude.ai/install.ps1 | iex |
| Windows CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| Homebrew (macOS) | brew install --cask claude-code |
| WinGet (Windows) | winget install Anthropic.ClaudeCode |
Il comando non mostra una barra di avanzamento mentre scarica: aspetta che finisca, apri una nuova finestra del terminale e lancia claude --version. Se stampa un numero di versione seguito da «(Claude Code)», è installato. Per una diagnosi più completa c’è claude doctor.
Due dettagli che cambiano la manutenzione: l’installazione nativa si aggiorna da sola in background, mentre Homebrew e WinGet no (si aggiorna a mano con brew upgrade claude-code or winget upgrade Anthropic.ClaudeCode). Su Windows nativo, Git for Windows è consigliato perché Claude Code possa usare lo strumento Bash; senza, usa PowerShell.
Claude Code come iniziare: login e primo avvio
Entra nella cartella del progetto e scrivi claude. Al primo avvio ti chiede di accedere: segui le istruzioni nel browser con il tuo account Claude (o Console). Le credenziali restano salvate e non devi rifarlo. Dentro la sessione, /help mostra i comandi disponibili e /login serve a cambiare account.
cd /percorso/del/tuo/progetto
claudeSe non hai mai usato il terminale, Anthropic ha anche una guida dedicata, e Claude Code esiste pure come app desktop, in VS Code e in JetBrains: il motore è lo stesso.
Claude Code come si usa: le prime richieste
Non devi passargli i file a mano: Claude Code legge il progetto quando serve. Comincia con domande di sola lettura, per vedere se ha capito dove si trova:
- what does this project do? (a cosa serve questo progetto)
- where is the main entry point? (dov’è il punto d’ingresso)
- explain the folder structure (spiegami la struttura delle cartelle)
Si può scrivere anche in italiano: gli esempi della documentazione sono in inglese, ma quello che conta è descrivere l’obiettivo. Poi passa a un cambiamento piccolo, per esempio aggiungere una funzione di prova. Claude Code ti mostra la modifica e, se la modalità lo prevede, ti chiede il permesso prima di scriverla.
La regola che la documentazione ripete è la stessa che vale con qualsiasi collega: sii specifico. «Correggi il bug» è vago; «correggi il bug per cui l’utente vede una pagina bianca dopo aver sbagliato la password» è un lavoro. Per compiti lunghi, elenca i passaggi numerati.
Le modalità di permesso, spiegate
Il punto che più cambia l’esperienza è quanto Claude può fare senza chiederti. Si cambia in ogni momento con Shift+Tab. Le modalità documentate da Anthropic:
| Modalità | Cosa fa senza chiedere |
|---|---|
Manual (default) | Solo letture; chiede prima di quasi ogni modifica, comando o accesso di rete |
| Accept edits | Letture, modifiche ai file e comandi comuni sul filesystem nelle cartelle di lavoro |
| Plan | Solo letture ed esplorazione; nessuna modifica finché non approvi un piano |
| Auto | Tutto, con un secondo modello che controlla le azioni in background |
| Don’t ask | Solo gli strumenti già approvati; il resto viene negato |
| Bypass permissions | Tutto, pensata solo per container o macchine virtuali isolate |
Da principiante, parti in Manual e usa Plan quando il lavoro è grosso: Claude studia il progetto, scrive un piano, e solo dopo la tua approvazione cambia i file. Puoi entrarci con Shift+Tab, con il prefisso /plan su una richiesta o avviando claude --permission-mode plan. Modificare il piano prima di approvarlo si fa con Ctrl+G.
Comandi da ricordare
| Comando | Cosa fa |
|---|---|
claude | Apre la sessione interattiva |
claude "compito" | Apre la sessione con una richiesta iniziale |
claude -p "domanda" | Risposta singola, poi esce |
claude -c | Riprende l’ultima conversazione nella cartella |
claude -r | Riprende una conversazione precedente |
/clear | Nuova conversazione (la vecchia si ritrova con /resume) |
/exit | Esce da Claude Code |
Come ricordargli le regole: il file CLAUDE.md
Ogni sessione parte con la finestra di contesto vuota. Per non ripetere ogni volta le stesse indicazioni, la documentazione prevede il file CLAUDE.md: istruzioni scritte da te, caricate all’inizio di ogni sessione. Claude le tratta come contesto, non come regole imposte: più sono specifiche e concise, più le segue con coerenza. Se hai bisogno di un divieto che valga sempre, la documentazione indica un hook PreToolUse, non una frase nel file. Esiste anche una memoria automatica, in cui è Claude a prendere appunti dalle tue correzioni.
La mia esperienza, in parole: uso Claude Code ogni giorno dentro un sistema di agenti AI con controlli automatici e test, e la lezione che ripeto è che il file di istruzioni deve restare corto e concreto, perché ogni riga in più è una riga che pesa su ogni sessione.
Errori da evitare all’inizio
- Partire in una modalità troppo permissiva. Meglio Manual o Plan finché non capisci cosa tocca.
- Richieste vaghe. Obiettivo, file o comportamento atteso: più sono precisi, meno giri a vuoto.
- Dimenticare di verificare. Quando Claude dice «fatto», guarda il risultato: lancia i test, apri la pagina.
- Cartella sbagliata. Claude lavora dove lo avvii: controlla il percorso prima di scrivere
claude.
FAQ
Claude Code è gratis?
No. Serve un account Claude Pro (20 $ al mese, 17 $ con fatturazione annuale), Max (100 $ al mese), Ultra (200 $ al mese), Team o Enterprise, oppure un account Console con crediti prepagati o un provider cloud supportato. Il piano gratuito di claude.ai non include Claude Code, come scrive la documentazione. Per i costi reali c’è l’articolo su abbonamento e risparmio di token.
Claude Code funziona su Windows?
Sì, in modo nativo da PowerShell o CMD, oppure dentro WSL. Su Windows nativo conviene installare Git for Windows; la modalità sandbox è supportata solo su WSL 2.
Devo saper programmare per usarlo?
Aiuta capire cosa sta facendo, ma il metodo è descrivere un obiettivo in linguaggio naturale. Se vuoi il quadro prima del tutorial, leggi cos’è Claude Code spiegato a un imprenditore.
Claude Code o Codex?
Dipende dal lavoro e dagli strumenti che usi già: il confronto è in Claude Code vs Codex.
Cosa imparare dopo il primo avvio?
Le istruzioni persistenti, i permessi e il collegamento a strumenti esterni. Per un percorso ordinato c’è cosa imparare prima e cosa dopo; se lavori con le note, come collegare Obsidian a Claude.
Fonti
- Claude Code, Quickstart, documentazione Anthropic, consultata l’11 novembre 2026.
- Claude Code, Advanced setup, documentazione Anthropic, consultata l’11 novembre 2026.
- Claude Code, Permission modes, documentazione Anthropic, consultata l’11 novembre 2026.
- Claude Code, How Claude remembers your project, documentazione Anthropic, consultata l’11 novembre 2026.
- Claude, Pricing, pagina dei piani Anthropic, consultata il 16 novembre 2026.
Se vuoi portare Claude Code dentro il lavoro della tua azienda, ne parliamo in una call: dove nasce il Company Brain.