Configurazione dell'ambiente Windows per Claude Code

Requisiti di sistema Windows

• Windows 10 o versione successiva
• Privilegi di amministratore (per installare software)
• Almeno 2GB di spazio libero su disco

Installazione di Node.js

Metodo 1: Pacchetto di installazione ufficiale (Consigliato)

node --version
npm --version

Metodo 2: Utilizzo di Chocolatey

# Installare Chocolatey (se non installato)
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

# Installare Node.js
choco install nodejs

Metodo 3: Utilizzo di Winget

winget install OpenJS.NodeJS

Configurazione delle variabili d'ambiente

Configurazione temporanea (valida per la sessione corrente)

set ANTHROPIC_BASE_URL=https://i7dc.com/api
set ANTHROPIC_AUTH_TOKEN=你的key
cd your-project-folder
claude

$env:ANTHROPIC_BASE_URL="https://i7dc.com/api"
$env:ANTHROPIC_AUTH_TOKEN="你的key"
cd your-project-folder
claude

Configurazione permanente (Consigliato)

# Impostare le variabili d'ambiente per l'utente corrente
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://i7dc.com/api", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的key", "User")

# Verificare l'impostazione
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")

Configurazione di Windows Terminal (Consigliato)

Per una migliore esperienza d'uso, si consiglia di installare Windows Terminal:

# Installare tramite Microsoft Store
winget install Microsoft.WindowsTerminal

# O installare tramite gestore di pacchetti
choco install microsoft-windows-terminal

Configurazione del profilo di avvio di Windows Terminal

1. Aprire Windows Terminal
2. Premere Ctrl + , per aprire le impostazioni
3. Nel menu a sinistra selezionare "Profili" → "Aggiungi nuovo profilo"
4. Configurare come segue:
   • Nome: Claude Code
   • Riga di comando: powershell.exe
   • Directory di avvio: 你的项目目录
   • Aggiungere variabili d'ambiente nelle impostazioni avanzate

Risoluzione dei problemi comuni

Problema 1: Comando node non riconosciuto

Soluzione:

# Controllare la variabile d'ambiente PATH
echo %PATH%

# Aggiungere manualmente Node.js a PATH (temporaneo)
set PATH=%PATH%;C:\Program Files\nodejs

Problema 2: Installazione npm lenta

Soluzione:

# Utilizzare un mirror locale
npm config set registry https://registry.npmmirror.com

Problema 3: Limitazione dei criteri di esecuzione di PowerShell

Soluzione:

# Consentire temporaneamente l'esecuzione di script
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# Impostazione permanente (richiede privilegi di amministratore)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

Problema 4: Firewall blocca la connessione

Soluzione:

1. Aprire le impostazioni del Firewall di Windows
2. Fare clic su "Consenti app o funzionalità attraverso Windows Firewall"
3. Trovare Node.js e selezionare le reti "Privata" e "Pubblica"

Verifica della configurazione

Dopo aver completato la configurazione, riavviare il Prompt dei comandi o PowerShell ed eseguire i seguenti comandi per verificare:

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
claude --version

Se vengono visualizzati i valori corretti delle variabili d'ambiente e le informazioni sulla versione, la configurazione è riuscita!

Prossimi passi

Dopo aver completato la configurazione dell'ambiente, puoi:

1. Eseguire claude in qualsiasi directory di progetto per iniziare a usarlo
2. Scegliere il tema che preferisci
3. Confermare l'avviso di sicurezza e considerare attendibile la directory di lavoro
4. Iniziare a collaborare con il tuo partner di programmazione AI!🚀