Guide pratiche

Come installare e iniziare con Claude Code: guida passo passo

Requisiti, installazione su macOS, Linux e Windows, prima sessione, piani e integrazione con VS Code o JetBrains: Claude Code secondo la documentazione ufficiale di Anthropic.

Di Audryk · 20 ottobre 2026

• Guide pratiche
• Agenti di programmazione
• #guide
• #Claude Code

Claude Code è l'agente di codice di Anthropic: legge il vostro progetto, propone modifiche ed esegue comandi dal terminale, da un IDE, dall'app desktop o dal web. Questa guida segue la documentazione ufficiale; ogni comando è stato verificato rispetto a essa il 2026-10-20. Per cifre di utilizzo e piani, vedere la pagina dello strumento Claude Code.

Prima di iniziare

• Sistemi operativi: macOS 13.0 o successivo, Windows 10 1809 o successivo (o Windows Server 2019), Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+ (Anthropic).
• Hardware: almeno 4 GB di RAM, processore x64 o ARM64. È necessaria una connessione a internet.
• Shell: Bash, Zsh, PowerShell o CMD.
• Paese: Claude Code è offerto solo nei paesi supportati da Anthropic.
• Account: un abbonamento Claude Pro, Max, Team o Enterprise, oppure un account Claude Console (API con crediti prepagati). Il piano gratuito di claude.ai non include Claude Code. Sono supportati anche Amazon Bedrock, Google Cloud e Microsoft Foundry.

Installare Claude Code

L'installer nativo è il metodo raccomandato da Anthropic; 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 alcun avanzamento durante il download. Poi aprite un nuovo terminale. Esistono due alternative, senza aggiornamenti automatici per impostazione predefinita:

brew install --cask claude-code

winget install Anthropic.ClaudeCode

Il cask Homebrew claude-code segue il canale stabile (circa una settimana di ritardo, saltando le release con regressioni gravi); claude-code@latest riceve ogni release non appena viene pubblicata. Sono disponibili anche repository apt, dnf e apk firmati per Debian, Fedora, RHEL e Alpine.

Con npm: il pacchetto richiede Node.js 22 o successivo e installa lo stesso binario nativo. Anthropic sconsiglia sudo npm install -g (problemi di permessi e rischi per la sicurezza).

npm install -g @anthropic-ai/claude-code

Note su Windows

Claude Code gira nativamente su Windows o all'interno di WSL. L'installazione nativa non richiede diritti di amministratore. Git for Windows è facoltativo: se presente, Claude Code usa Git Bash per il suo strumento Bash; altrimenti usa PowerShell. Il sandboxing (esecuzione isolata dei comandi) è supportato solo con WSL 2. In WSL, installate e avviate claude dal terminale Linux, non da PowerShell.

Verificare l'installazione

claude --version

Il comando stampa un numero di versione seguito da «(Claude Code)». Se la shell dice che claude non è stato trovato, la directory di installazione non è ancora nel PATH. Per un controllo più completo, senza avviare una sessione:

claude doctor

La prima sessione

Spostatevi in un progetto e avviate l'agente:

cd /path/to/your/project
claude

Al primo utilizzo, Claude Code apre il browser per l'accesso; le credenziali vengono poi memorizzate. Se la variabile d'ambiente ANTHROPIC_API_KEY è impostata e la approvate, il passaggio di accesso viene saltato. Con un account Console, viene creato automaticamente uno spazio di lavoro «Claude Code» per il monitoraggio dei costi.

Iniziate con domande semplici, per esempio:

what does this project do?

Poi una piccola modifica. Claude Code mostra la modifica e chiede l'approvazione in base alla modalità di permessi della sessione; Shift+Tab scorre le modalità.

add a hello world function to the main file

Comandi essenziali, dalla guida rapida di Anthropic:

• claude "task" avvia una sessione con un prompt iniziale (ad es. claude "fix the build error"); claude -p "query" risponde una volta, poi esce;
• claude -c riprende la conversazione più recente nella directory corrente; claude -r permette di sceglierne una più vecchia;
• all'interno di una sessione: /help elenca i comandi, /resume riprende una conversazione, /login cambia account, /clear cancella la cronologia, /exit (o Ctrl+D due volte) esce.

Costi e piani

Claude Code è incluso nei piani a pagamento di Claude (Anthropic, verificato il 2026-10-20):

• Pro: 17 $/mese fatturati annualmente (200 $ in anticipo), 20 $ fatturati mensilmente;
• Max: da 100 $/mese, con un utilizzo 5 o 20 volte quello di Pro;
• Team: postazione standard a 20 $/mese fatturati annualmente (25 $ mensili), postazione Premium a 100 $ (125 $ mensili), da 2 a 150 persone;
• Enterprise: 20 $ per postazione al mese fatturati annualmente, più il consumo alle tariffe API, minimo 20 postazioni.

Con un account Console, l'utilizzo è fatturato per token. Anthropic afferma che, nelle sue implementazioni aziendali, il costo medio è di circa 13 $ per sviluppatore per giorno attivo e 150-250 $ per sviluppatore al mese, restando sotto i 30 $ per giorno attivo per il 90% degli utenti (Anthropic). Il comando /usage mostra il consumo della sessione; per gli abbonati Pro e Max l'utilizzo è incluso nel piano. Per confrontare questi piani con altri agenti, vedere la nostra guida Scegliere un agente di codice in base al budget.

Integrare Claude Code con il vostro IDE

VS Code e Cursor: l'estensione ufficiale richiede VS Code 1.94.0 o successivo e un account Claude o Console a pagamento, senza bisogno di chiave API (Anthropic). Aprite la vista Estensioni (Cmd+Shift+X su Mac, Ctrl+Shift+X su Windows e Linux), cercate «Claude Code» e installate. L'estensione include una propria copia della CLI; per eseguire claude nel terminale integrato, installate anche la CLI. Altri fork di VS Code (Devin Desktop, Kiro) usano il registro Open VSX.

JetBrains (IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand): il plugin non include la CLI. Installate prima la CLI, poi il plugin Claude Code dal JetBrains Marketplace e riavviate l'IDE (Anthropic). Eseguite claude nel terminale integrato, oppure digitate /ide in una sessione avviata da un terminale esterno. Cmd+Esc (Mac) o Ctrl+Esc (Windows e Linux) apre Claude Code dall'editor.

Aggiornare e disinstallare

Le installazioni native si aggiornano da sole. Per aggiornare subito:

claude update

Con Homebrew: brew upgrade claude-code; con WinGet: winget upgrade Anthropic.ClaudeCode. Per rimuovere un'installazione nativa su macOS, Linux o WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Per andare oltre

• Collegare Claude Code ai vostri strumenti: Come configurare un server MCP.
• Confrontare: Claude Code, Codex o GitHub Copilot, Claude Code vs Codex, alternative a Claude Code.
• Vocabolario: agente di codice e finestra di contesto nel glossario.

Fonti

• Claude Code Docs: Advanced setup, verificato il 2026-10-20
• Claude Code Docs: Quickstart, verificato il 2026-10-20
• Claude Code Docs: Manage costs effectively, verificato il 2026-10-20
• Claude Code Docs: Use Claude Code in VS Code, verificato il 2026-10-20
• Claude Code Docs: JetBrains IDEs, verificato il 2026-10-20
• Anthropic: Claude pricing, verificato il 2026-10-20

In sintesi: Claude Code si installa con un solo comando su macOS, Linux e Windows, ma richiede un piano Claude a pagamento o un account Console; l'estensione per VS Code include la CLI, il plugin JetBrains no.

Avete notato un errore in questo articolo? Segnalatelo · La nostra politica sulle correzioni