Guida all'Installazione e all'Uso di Claude Code - Configurazione dell'Assistente di Programmazione AI

Claude Code è un potente assistente di programmazione AI che ti permette di collaborare con l'intelligenza artificiale direttamente dal tuo terminale. Questa guida ti accompagnerà attraverso il processo di installazione e configurazione.

Requisiti di Sistema#

Prima di installare Claude Code, assicurati che il tuo sistema soddisfi questi requisiti:

• Node.js: Versione 18.0 o superiore
• Sistema Operativo: macOS, Linux o Windows (consigliato WSL)

Avvio Rapido#

Passaggio 1: Installa Node.js#

Se hai già installato Node.js 18.0 o superiore, puoi saltare questo passaggio.

Ubuntu / Debian#

# Install Node.js LTS version
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -
sudo apt-get install -y nodejs

# Verify installation
node --version

macOS#

# Install Xcode command line tools
sudo xcode-select --install

# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install Node.js via Homebrew
brew install node

# Verify installation
node --version

Passaggio 2: Installa Claude Code#

Installa Claude Code globalmente usando npm:

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

# Verify installation
claude --version

Passaggio 3: Configura l'Accesso API#

Per usare Claude Code con Crazyrouter API ti servono due elementi di configurazione:

Impostazioni consigliate per il token:

• Nome: Qualsiasi nome descrittivo
• Quota: Imposta su illimitata per lo sviluppo
• Gruppo: Seleziona "Claude Code" o "Official Claude 3+"
• Altre opzioni: Mantieni le impostazioni predefinite

Passaggio 4: Avvia Claude Code#

Linux / macOS#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Windows PowerShell#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
$env:ANTHROPIC_BASE_URL = "https://crazyrouter.com/"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-token-here"
$env:API_TIMEOUT_MS = "300000"

# Launch Claude Code
claude

Windows CMD#

# Navigate to your project directory
cd your-project-folder

# Set environment variables
set ANTHROPIC_BASE_URL=https://crazyrouter.com/
set ANTHROPIC_AUTH_TOKEN=sk-your-token-here
set API_TIMEOUT_MS=300000

# Launch Claude Code
claude

Passaggio 5: Configurazione al Primo Avvio#

Dopo aver avviato Claude Code per la prima volta, vedrai questi passaggi di configurazione:

1. Select Theme - Scegli il tema di colori che preferisci e premi Invio
2. Safety Notice - Leggi e conferma l'avviso di sicurezza
3. Terminal Configuration - Usa la configurazione predefinita o personalizza
4. Working Directory Trust - Considera attendibile la directory corrente per consentire l'accesso ai file

Congratulazioni! Ora sei pronto per iniziare a programmare con il tuo partner di programmazione AI.

Configurazione Permanente (Opzionale)#

Per evitare di impostare le variabili d'ambiente ogni volta, aggiungile al profilo della tua shell:

Bash (~/.bashrc o ~/.bash_profile)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Zsh (~/.zshrc)#

export ANTHROPIC_AUTH_TOKEN=sk-your-token-here
export ANTHROPIC_BASE_URL=https://crazyrouter.com/
export API_TIMEOUT_MS=300000

Dopo averle aggiunte, ricarica la shell:

source ~/.bashrc  # or source ~/.zshrc

Domande Frequenti#

Errore "Invalid API Key"#

Se vedi "Invalid API Key - Please run /login", controlla che:

• ANTHROPIC_AUTH_TOKEN sia impostato correttamente (inizi con sk-)
• ANTHROPIC_BASE_URL sia impostato su https://crazyrouter.com/
• Riavvii il terminale dopo aver impostato le variabili d'ambiente

Stato "Offline"#

Claude Code verifica lo stato della rete collegandosi a Google. La visualizzazione di "offline" non influisce sul normale utilizzo: indica solo l'impossibilità di collegarsi ai server di Google.

Errori di Web Fetch#

Claude Code esegue controlli di sicurezza prima di accedere alle pagine web. Assicurati che:

• La connessione a Internet sia stabile
• Usi, se necessario, un proxy globale

Errori Persistenti di "Fetch Failed"#

Questo può essere causato da problemi di rete. Prova a:

1. Uscire da Claude Code (Ctrl+C)
2. Eseguire di nuovo il comando claude
3. Se il problema persiste, riprova più tardi

Errori API#

Se riscontri errori API:

• Esci da Claude Code (Ctrl+C)
• Attendi un momento e riavvia
• Controlla la quota del tuo token nella dashboard

Note Importanti#

• Crazyrouter fornisce inoltro diretto ai servizi ufficiali di Claude Code
• Mantieni il tuo token API al sicuro e non condividerlo mai pubblicamente
• Monitora il tuo utilizzo nella dashboard per evitare addebiti imprevisti

Prezzi#

Claude Code utilizza i modelli Claude con i seguenti prezzi su Crazyrouter:

Tutti i prezzi includono uno sconto del 45% rispetto alle tariffe ufficiali.

Risorse Correlate#

• Pagina Prezzi di Crazyrouter
• Documentazione Ufficiale di Claude Code
• Sito Ufficiale Node.js

Hai bisogno di aiuto? Contatta il supporto o consulta la documentazione di Crazyrouter per maggiori informazioni.