ARTICOLO DEL BLOG

Claude Code tutorial: dall’installazione al primo lavoro, passo passo

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 claude dentro la cartella del progetto: al primo avvio si fa il login dal browser.
  • Con Shift+Tab cambi 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.

SistemaComando (installazione nativa)
macOS, Linux, WSLcurl -fsSL https://claude.ai/install.sh | bash
Windows PowerShellirm https://claude.ai/install.ps1 | iex
Windows CMDcurl -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 o 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
claude

Se 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 editsLetture, modifiche ai file e comandi comuni sul filesystem nelle cartelle di lavoro
PlanSolo letture ed esplorazione; nessuna modifica finché non approvi un piano
AutoTutto, con un secondo modello che controlla le azioni in background
Don’t askSolo gli strumenti già approvati; il resto viene negato
Bypass permissionsTutto, 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

ComandoCosa fa
claudeApre la sessione interattiva
claude "compito"Apre la sessione con una richiesta iniziale
claude -p "domanda"Risposta singola, poi esce
claude -cRiprende l’ultima conversazione nella cartella
claude -rRiprende una conversazione precedente
/clearNuova conversazione (la vecchia si ritrova con /resume)
/exitEsce 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.

Domande frequenti

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

Se vuoi portare Claude Code dentro il lavoro della tua azienda, ne parliamo in una call: dove nasce il Company Brain.

Vuoi applicarlo alla tua azienda?In 30 minuti guardiamo da dove partire e cosa conviene fare per primo.
Prenota la call gratuita →

ESPLORA I MIEI SERVIZI

Soluzioni digitali su misura per te.

Personalizzo ogni soluzione digitale per rispondere perfettamente alle tue esigenze. Con il mio servizio Full-Stack Marketing, posiziono il tuo brand online rendendolo funzionante e operativo in una settimana!

DIGITAL MARKETING Blog

Strategie SEO e AI per il Business.

Scopri le ultime tendenze e strategie di digital marketing, SEO e intelligenza artificiale. Consigli pratici per far crescere il tuo business online.