Source: https://aiprimetech.io/it/claude-code/install/ [Home](/it/) › [Claude Code](/it/claude-code/) › Installazione [Panoramica](/it/claude-code/)[Installazione](/it/claude-code/install/)[riferimento della CLI](/it/claude-code/cli/)[Prezzi e limiti](/it/claude-code/pricing/)[Agent SDK](/it/claude-code/sdk/)[Skill e plugin](/it/claude-code/skills/)[GitHub](/it/claude-code/github/)[Web, desktop e IDE](/it/claude-code/web-and-desktop/)[Modelli](/it/claude-code/models/)[Errori](/it/claude-code/errors/)[È open source?](/it/claude-code/open-source/)[Tutorial](/it/claude-code/tutorial/)[Per studenti](/it/claude-code/for-students/)[Automazione QA](/it/claude-code/qa-automation/)[Confronto con Cursor](/it/claude-code/vs-cursor/)[Confronto con Codex e OpenCode](/it/claude-code/vs-codex/)[Subagenti](/it/claude-code/subagents/)[Hook](/it/claude-code/hooks/)[MCP](/it/claude-code/mcp/)[Ecosistema](/it/claude-code/ecosystem/)[VS Code](/it/claude-code/vscode/)[OpenRouter](/it/claude-code/openrouter/)[Limiti di frequenza](/it/claude-code/rate-limits/)[Guida in cinese](/claude-code/zh/) Ultimo aggiornamento: 11 ottobre 2026 # Come installare Claude Code Esistono tre metodi supportati per installare Claude Code su un computer. Scegline uno; tutti rendono disponibile lo stesso comando claude . ## TLDR - npm: npm install -g @anthropic-ai/claude-code (richiede Node.js 18 o successivo). - Installer nativo: un comando curl (macOS/Linux) o una riga PowerShell (Windows), senza bisogno di Node. - Verifica con claude --version, poi imposta ANTHROPIC_BASE_URL e ANTHROPIC_API_KEY per usare questo gateway. ## 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. ## Provalo prima gratuitamente I nuovi account ricevono $5 di credito API gratuito con il codice CLAUDECODE — abbastanza per una serata con Claude Code su Sonnet — poi crediti pari a 7.69231× il valore nominale. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Crea un account con il codice CLAUDECODE](/register?promo=CLAUDECODE) ## Domande frequenti Serve Node.js per installare Claude Code? Solo per l'installazione tramite npm. Il programma di installazione nativo (curl su macOS/Linux, PowerShell su Windows) e l'app desktop non richiedono Node.Claude Code funziona su Windows? Sì, in modo nativo in PowerShell o Git Bash e all'interno di WSL. WSL è consigliato per i progetti strutturati per Unix.Posso installare Claude Code senza un abbonamento a Claude? Sì. L'installazione è gratuita; autenticati con una chiave API anziché con /login. Una chiave del gateway di questo sito funziona come sostituto diretto. ## Esegui Claude Code sul gateway Stessi modelli, due variabili d'ambiente, crediti pari a 7.69231× il valore nominale — oppure un piano illimitato a tariffa fissa. Nuovi account: $5 di credito API gratuito con il codice CLAUDECODE.[Ottieni una chiave API](/register?promo=CLAUDECODE) [Scopri i piani illimitati](/it/plans/) 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. ## Altre guide su Claude Code [Claude Code: la guida completa](/it/claude-code/)[Documentazione della CLI di Claude Code: comandi e flag](/it/claude-code/cli/)[Prezzi e limiti di Claude Code, spiegati](/it/claude-code/pricing/)[L'SDK di Claude Code, ora Claude Agent SDK](/it/claude-code/sdk/)[Skill e plugin di Claude Code](/it/claude-code/skills/)[Claude Code in GitHub: App, Action e @claude](/it/claude-code/github/)[Claude Code ha un'interfaccia web? Le versioni web, desktop e per IDE spiegate](/it/claude-code/web-and-desktop/)[Quale modello usa Claude Code e come cambiarlo](/it/claude-code/models/)[Errori di Claude Code e come risolverli](/it/claude-code/errors/)[Claude Code è open source?](/it/claude-code/open-source/)[Tutorial di Claude Code: la tua prima sessione reale](/it/claude-code/tutorial/)[Claude per studenti: Claude Code, l'API e ciò che offre davvero il settore education](/it/claude-code/for-students/)[Come usare Claude Code per l'automazione QA](/it/claude-code/qa-automation/)[Claude Code e Cursor a confronto: quale scegliere, quando — e come usarli entrambi](/it/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: confronto tra gli agenti da terminale](/it/claude-code/vs-codex/)[Subagenti di Claude Code: come funzionano, come definirli e team di agenti](/it/claude-code/subagents/)[Hook di Claude Code: controllo deterministico su ciò che fa l'agente](/it/claude-code/hooks/)[MCP in Claude Code: connessione ai server, ambiti, MCP remoto ed esempi concreti](/it/claude-code/mcp/)[L'ecosistema Claude Code: router, framework, plugin e gli elenchi che li raccolgono](/it/claude-code/ecosystem/)[Claude Code in VS Code: l'estensione, l'uso dal terminale e gli errori](/it/claude-code/vscode/)[Come usare OpenRouter in Claude Code (e quando evitarlo)](/it/claude-code/openrouter/)[Errore di limite di frequenza di Claude: cosa significa "Errore API: limite di frequenza raggiunto" e come risolverlo](/it/claude-code/rate-limits/)[Come usare Claude Code: dall'installazione all'uso quotidiano](/claude-code/zh/)