Come installare Claude Code

Node.js per Claude Code: quale versione usare e come farne a meno

Il metodo npm richiede Node.js 18 o successivo: node -v per verificare; nvm (nvm install --lts) per correggere. Una versione obsoleta di Node è la causa più comune del mancato avvio dopo una nuova installazione. Se Node non fa parte dei tuoi strumenti di sviluppo, puoi farne a meno: l'installer nativo riportato di seguito include un eseguibile autonomo e si aggiorna automaticamente.

Opzione 1 — npm (qualsiasi sistema operativo con Node.js 18 o successivo)

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

Se npm install -g non riesce e restituisce EACCES su macOS o Linux, non usare sudo: correggi invece il prefisso di npm: npm config set prefix ~/.npm-global e aggiungi ~/.npm-global/bin al tuo PATH. Su Windows, esegui l'installazione da un normale terminale, senza privilegi di amministratore.

Opzione 2 — installer nativo per Mac, Linux e Windows (senza Node.js)

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD (the one-liner people search for)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Installare Claude Code su Linux e Ubuntu

Su Ubuntu, Debian, Fedora o qualsiasi distribuzione: l'installer nativo (curl -fsSL https://claude.ai/install.sh | bash) inserisce nella tua directory home un eseguibile che si aggiorna automaticamente e non richiede né privilegi di root né Node.js. Se preferisci npm, installa prima Node 18 o successivo da NodeSource o nvm — la versione di Node fornita da apt su Ubuntu è solitamente troppo vecchia — poi npm install -g @anthropic-ai/claude-code. Su un server accessibile solo da terminale o in un container, l'eseguibile nativo è la scelta migliore; aggiungi le due variabili del gateway a ~/.bashrc e funzionerà tramite SSH esattamente come in locale.

La versione nativa si aggiorna automaticamente ed evita i conflitti tra versioni di Node. È la scelta migliore sui computer in cui Node non fa già parte degli strumenti di sviluppo.

Opzione 3 — app desktop o estensione per IDE

L'app desktop di Claude include Claude Code, mentre le estensioni per VS Code e JetBrains installano la CLI al primo utilizzo. Consulta la guida per web, desktop e IDE per sapere cosa puoi e non puoi fare in ciascuna interfaccia.

Note per Windows

Claude Code funziona nativamente su Windows 10/11 (PowerShell o Git Bash) e all'interno di WSL. WSL offre un'esperienza più fluida per i progetti che presuppongono una shell Unix. Se claude non viene trovato dopo un'installazione con npm su Windows, apri un nuovo terminale per rileggere PATH, oppure controlla npm config get prefix e aggiungi la relativa cartella bin .

Eseguire Claude Code senza effettuare l'accesso: autenticazione con una chiave API

Esegui claude e scegli /login per accedere con un abbonamento Claude Pro/Max, oppure salta del tutto l'accesso. Con ANTHROPIC_API_KEY (o ANTHROPIC_AUTH_TOKEN) impostato, Claude Code non mostra mai la schermata di accesso e viene eseguito localmente usando l'endpoint indicato da ANTHROPIC_BASE_URL; questo gli permette anche di funzionare su computer che non possono aprire un browser. Per questo gateway, usa il metodo con chiave:

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key   # or ANTHROPIC_AUTH_TOKEN
claude

Inserisci queste due righe in ~/.zshrc, ~/.bashrc o nel tuo profilo PowerShell, così saranno disponibili in ogni nuovo terminale. All'interno di Claude Code, /status mostra quali endpoint e chiave sono attivi.

Come aggiornare e disinstallare Claude Code

claude update                      # native / self-update
npm update -g @anthropic-ai/claude-code   # npm install
npm uninstall -g @anthropic-ai/claude-code

Se l'installazione è riuscita ma Claude Code non si avvia

• command not found → PATH: apri una nuova shell oppure aggiungi la directory bin globale di npm.
• Node version errori → è richiesto Node.js 18 o successivo; node -v per verificare, oppure passa all'installer nativo.
• Si blocca al primo avvio → proxy aziendale; imposta HTTPS_PROXY, oppure l'URL di base del gateway se la tua rete blocca api.anthropic.com.
• 401 / chiave non valida → la chiave deve essere una chiave del gateway quando ANTHROPIC_BASE_URL punta qui; una chiave della console Anthropic verrà rifiutata.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Domande frequenti

AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.