Guida Claude Code: installazione e primo task da zero

Questa guida Claude Code ti porta da zero alla prima sessione funzionante: un comando di installazione, l’accesso con il tuo account Claude, un primo task nel tuo progetto e il file CLAUDE.md, grazie al quale l’agente ricorda le regole del progetto. Ti servono un terminale, un qualsiasi progetto con del codice e un piano Claude a pagamento (Pro, Max, Team o Enterprise) oppure un account Claude Console con crediti API. Il tutto richiede un quarto d’ora.

Scrivo da utente: gestisco questo sito con Claude Code, dal codice alla pubblicazione degli articoli. Tutti i comandi qui sotto vengono dalla documentazione ufficiale.

Che cos’è Claude Code

Claude Code è l’agente di programmazione di Anthropic e funziona nel terminale. A differenza di una chat, non si limita a rispondere: legge i file del repository, li modifica, esegue comandi, scrive test e fa commit. Tu descrivi cosa vuoi ottenere e Claude cerca da solo i file giusti e propone le modifiche.

Lo stesso motore funziona anche fuori dal terminale: in VS Code e JetBrains, nell’app desktop, nel browser su claude.ai/code e nell’app mobile. In questa guida resto sul terminale, perché è lì che si vede di più.

Guida Claude Code: installazione con un solo comando

Il metodo consigliato è l’installer nativo, che si aggiorna da solo in background.

macOS, Linux e 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

L’installer non mostra l’avanzamento. Quando ha finito, apri una nuova finestra del terminale e controlla:

claude --version

Se vedi un numero di versione seguito da (Claude Code), funziona tutto. Un messaggio che dice che claude non è riconosciuto di solito significa che la cartella di installazione manca dal PATH; la documentazione ha una sezione apposita.

Alternative: brew install --cask claude-code su macOS e winget install Anthropic.ClaudeCode su Windows. Questi due metodi non si aggiornano da soli. Su Windows senza WSL conviene installare Git for Windows, così Claude ha accesso a Bash.

Accesso e prima sessione

Entra nella cartella del progetto e avvia l’agente:

cd /percorso/del/progetto
claude

Al primo avvio Claude Code ti chiede di accedere dal browser. Accedi con un account Claude (piano Pro, Max, Team o Enterprise) oppure con un account Claude Console, cioè accesso all’API con crediti prepagati. Le credenziali vengono salvate, quindi lo fai una volta sola. Se hai impostato la variabile ANTHROPIC_API_KEY, Claude ti chiede se usarla e salta l’accesso.

Dopo l’accesso vedrai un prompt con il numero di versione, il nome del modello e la cartella di lavoro. Scrivi /help per vedere i comandi disponibili.

Il primo task

Comincia con delle domande, prima di lasciare che l’agente cambi qualcosa. Claude legge i file da solo, non devi incollarli:

cosa fa questo progetto?
dov'è il punto di ingresso principale?
spiega la struttura delle cartelle

Poi una piccola modifica:

aggiungi una funzione hello world al file principale

Claude trova il file giusto e mostra un diff. Se chiede il permesso, approva. Su cosa l’agente deve chiedere lo decide la modalità dei permessi, che cambi con Shift+Tab. Nelle versioni più recenti la modalità predefinita è quella auto, in cui un modello classificatore separato controlla le azioni e blocca solo quelle rischiose.

Anche Git lo gestisci a parole:

quali file ho modificato?
fai un commit con un messaggio descrittivo
crea un branch feature/quickstart

CLAUDE.md, la memoria del progetto

Ogni sessione parte con il contesto vuoto. Per non dover spiegare ogni volta come si compila il progetto e quali convenzioni usate, scrivilo in un file CLAUDE.md nella radice del repository. Claude lo legge all’inizio di ogni conversazione.

Il modo più rapido per iniziare è il comando /init: Claude analizza il repository e genera un file con i comandi di build, i test e le convenzioni che scopre da solo. Poi aggiungi quello che dal codice non si ricava.

Cosa conviene tenerci secondo la documentazione:

• comandi che Claude non indovinerà (build, test, lint),
• regole di stile diverse da quelle predefinite,
• etichetta del repository (nomi dei branch, convenzioni per le PR),
• decisioni architetturali e trappole specifiche del progetto.

Cosa non scriverci: quello che Claude ricava da solo dal codice e i luoghi comuni tipo «scrivi codice pulito». La documentazione consiglia di tenere il file sotto le 200 righe. I file più lunghi consumano contesto e vengono rispettati peggio.

Qualche dato che ti risparmierà ricerche:

• ~/.claude/CLAUDE.md contiene le tue regole personali per tutti i progetti, ./CLAUDE.md le regole del progetto condivise con il team e ./CLAUDE.local.md le note private per un certo repository (aggiungilo a .gitignore).
• Il file può includere altri file con la sintassi @percorso/del/file.
• Se il repository ha già un AGENTS.md per altri agenti, Claude Code leggerà quello al posto di CLAUDE.md.
• /context mostra quali file di memoria sono stati caricati.

Comandi che vale la pena conoscere

Comando	Cosa fa
claude	avvia una sessione interattiva
claude "task"	parte subito con una prima istruzione
claude -p "domanda"	una singola richiesta senza sessione, risultato nel terminale
claude -c	riprende l’ultima conversazione in questa cartella
claude -r	sceglie una conversazione precedente da riprendere
/init	genera un CLAUDE.md iniziale
/clear	pulisce il contesto tra task non collegati
/compact	riassume la conversazione per liberare contesto
/rewind (o due volte Esc)	riporta la conversazione e le modifiche ai file a un punto scelto
/permissions	elenco degli strumenti fidati, meno richieste di permesso
Shift+Tab	cambia la modalità dei permessi, inclusa la modalità piano
/exit	esci

La modalità -p è particolarmente utile negli script: cat error.log | claude -p "spiega questo errore" manda il file direttamente al modello.

Cinque abitudini che fanno la differenza

Quasi tutti i consigli delle best practice ufficiali si riducono a un limite: la finestra di contesto si riempie in fretta e, man mano, la qualità cala.

1. Prima esplorare e pianificare, poi scrivere codice. Per le modifiche più grandi attiva la modalità piano (Shift+Tab finché non compare plan mode on). Claude legge i file e propone un piano, ma non cambia nulla finché non lo approvi. Per le correzioni di una riga il piano è un sovraccarico inutile.
2. Sii specifico. Invece di «sistema il bug del login», scrivi qual è il sintomo, dove probabilmente sta la causa e cosa vuol dire «sistemato». Indica i file con @nome-file.
3. Dai all’agente un modo per verificare il lavoro. Test, build, lint o uno screenshot da confrontare. Senza, «sembra fatto» è l’unico segnale, e il tester diventi tu.
4. Pulisci il contesto. /clear tra task non collegati. Se hai già corretto Claude due volte sulla stessa cosa, ricomincia con un prompt migliore.
5. Torna indietro senza paura. Ogni prompt crea un checkpoint. Quando un esperimento non va, /rewind ripristina conversazione e file. Non sostituisce git, ma invoglia a tentativi più audaci.

Domande frequenti

Claude Code è gratuito?

No. La documentazione richiede un piano Claude a pagamento (Pro, Max, Team o Enterprise) oppure un account Claude Console, in cui paghi i token API. I prezzi aggiornati dei piani sono su claude.com/pricing.

Claude Code funziona su Windows?

Sì, in modo nativo (PowerShell o CMD) e in WSL. Su Windows nativo conviene avere Git for Windows, perché così l’agente usa Bash; senza, usa PowerShell.

Devo per forza usare il terminale?

No. Lo stesso agente è disponibile come estensione per VS Code e JetBrains, come app desktop e come versione browser. I file CLAUDE.md, le impostazioni e i server MCP funzionano allo stesso modo su tutte queste superfici.

In cosa Claude Code è diverso dalla chat di Claude?

La chat risponde alle domande. Claude Code lavora nel tuo repository: legge e modifica file, esegue comandi e test, fa commit e apre pull request. Riceve quindi un compito, non una domanda.