Workbranch › Guide

Come iniziare con Claude Code

Claude Code è l'assistente di programmazione di Anthropic che legge il tuo progetto, modifica i file ed esegue comandi dal terminale. Questa guida ti porta dall'installazione a una prima sessione funzionante, più il file che migliora ogni sessione successiva.

Aggiornato 30 ottobre 2026

I comandi qui sotto sono stati verificati sulla documentazione di Claude Code di Anthropic a ottobre 2026.

Quali piani includono Claude Code

Passo 1: installa

1. Apri un terminale. Su Windows, PowerShell mostra PS C:\ nel prompt; CMD mostra solo C:\.
2. Esegui il comando per il tuo sistema:
   • 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
3. Attendi. L'installer non mostra una barra di avanzamento durante il download.
4. Apri una nuova finestra del terminale ed esegui claude --version. Dovresti vedere un numero di versione seguito da (Claude Code).

Preferisci un gestore di pacchetti? Funzionano anche brew install --cask claude-code su Mac o winget install Anthropic.ClaudeCode su Windows. Su Windows nativo è consigliato installare Git for Windows, così Claude Code può usare Bash; senza, ripiega su PowerShell.

Passo 2: avvia la prima sessione in un progetto

1. Entra nel tuo progetto: cd /path/to/your/project.
2. Scrivi claude e premi Invio.
3. Al primo utilizzo, segui le indicazioni per accedere tramite il browser. Le credenziali vengono salvate, quindi lo fai una volta sola. In seguito usa /login per cambiare account.
4. Fai una domanda per orientarti, come cosa fa questo progetto? o dov'è il punto di ingresso principale?. Claude legge i file che gli servono; non devi incollare il codice.
5. Prova una piccola modifica, per esempio aggiungi la validazione dei dati al modulo di registrazione. Claude mostra la modifica e chiede prima di applicarla; scegli Yes per approvare.

Claude Code gestisce anche Git in linguaggio naturale: quali file ho modificato? o fai il commit delle mie modifiche con un messaggio descrittivo.

Passo 3: dai a Claude le regole del progetto con CLAUDE.md

Ogni sessione parte con un contesto vuoto. Un file CLAUDE.md viene caricato all'inizio di ognuna, quindi è il posto dove mettere ciò che Claude deve sempre sapere: comandi di build e di test, convenzioni, cose da evitare.

1. In una sessione, esegui /init. Claude esamina il tuo codice e scrive un CLAUDE.md iniziale con i comandi e le convenzioni che trova. Se il file esiste già, suggerisce miglioramenti invece di sovrascriverlo.
2. Apri il file e aggiungi ciò che Claude non poteva scoprire da solo, come "esegui il linter prima di fare commit".
3. Fai il commit del file così anche le sessioni dei tuoi colleghi ricevono le stesse istruzioni.

Anthropic consiglia di tenere ogni file sotto le 200 righe circa: i file più lunghi occupano più contesto e vengono seguiti con meno affidabilità. Puoi includere altri file con @path/to/file.

I primi comandi da imparare

• claude "task" avvia una sessione con la prima istruzione già inserita.
• claude -p "query" risponde una volta ed esce.
• claude -c riprende l'ultima sessione in questa cartella; claude -r ne sceglie una più vecchia. Approfondisci in come riprendere una sessione di Claude Code.
• /help elenca i comandi, /clear ricomincia da zero, /exit (o Ctrl+D due volte) esce.
• Scrivi / per vedere i comandi e le skill disponibili.

Buono a sapersi

• Utilizzo: su Pro e Max, Claude Code e la chat di Claude condividono gli stessi limiti di cinque ore e settimanali. Se è impostata e approvata una variabile d'ambiente ANTHROPIC_API_KEY, Claude Code usa quella chiave e fattura alle tariffe dell'API; esegui /login per passare al tuo abbonamento.
• Permessi: la modalità di permessi decide cosa Claude può fare senza chiedere. Premi Shift+Tab per scorrere le modalità.
• CLAUDE.md è una guida, non un blocco: Claude lo tratta come contesto. Le istruzioni brevi e specifiche sono quelle seguite con più costanza.

Se qualcosa non funziona

• claude non viene trovato dopo l'installazione: apri un nuovo terminale. Se continua a non funzionare, la cartella di installazione non è ancora nel PATH; la pagina di risoluzione dei problemi di Anthropic spiega come sistemarlo.
• The token '&&' is not a valid statement separator: sei in PowerShell; usa il comando per PowerShell. 'irm' is not recognized significa che sei in CMD.
• Il comando di installazione fallisce con un errore 403 o di sintassi: consulta la pagina di Anthropic sulla risoluzione dei problemi di installazione per metodi alternativi.
• L'accesso va in loop o usa l'account sbagliato: esegui /login dentro una sessione per accedere di nuovo.

Workbranch per Claude Code

Se segui il lavoro dei progetti in Workbranch, il suo plugin per Claude Code mostra cosa è ancora aperto quando una sessione parte in una cartella collegata a un progetto, e puoi dire "save this to Workbranch" (salva in Workbranch) per archiviare per argomento attività, decisioni e domande aperte della sessione. I dettagli sono nella pagina Workbranch per Claude.

Fonti

• Use Claude Code with your Pro or Max plan (Claude Help Center, verificato il 2026-10-30)
• Quickstart (Claude Code Docs, verificato il 2026-10-30)
• How Claude remembers your project (Claude Code Docs, verificato il 2026-10-30)

Domande frequenti