Iniziare con Claude Code
Impara come installare, autenticare e iniziare a utilizzare Claude Code.
Verifica i requisiti di sistema
- Sistemi operativi: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows tramite WSL
- Hardware: 4GB RAM minimo
- Software:
- Rete: Connessione Internet richiesta per l’autenticazione e l’elaborazione AI
- Posizione: Disponibile solo nei paesi supportati
Risoluzione dei problemi di installazione WSL
Attualmente, Claude Code non funziona direttamente in Windows e richiede invece WSL. Se riscontri problemi in WSL:
-
Problemi di rilevamento OS/piattaforma: Se ricevi un errore durante l’installazione, WSL potrebbe utilizzare
npm
di Windows. Prova:- Esegui
npm config set os linux
prima dell’installazione - Installa con
npm install -g @anthropic-ai/claude-code --force --no-os-check
(NON utilizzaresudo
)
- Esegui
-
Errori Node non trovato: Se vedi
exec: node: not found
quando eseguiclaude
, il tuo ambiente WSL potrebbe utilizzare un’installazione Windows di Node.js. Puoi confermarlo conwhich npm
ewhich node
, che dovrebbero puntare a percorsi Linux che iniziano con/usr/
piuttosto che/mnt/c/
. Per risolvere questo, prova a installare Node tramite il gestore di pacchetti della tua distribuzione Linux o tramitenvm
.
Installa e autentica
Installa Claude Code
Install NodeJS 18+, then run:
Do NOT use sudo npm install -g
as this can lead to permission issues and
security risks. If you encounter permission errors, see configure Claude
Code for recommended solutions.
Naviga al tuo progetto
bash cd your-project-directory
Avvia Claude Code
bash claude
Completa l'autenticazione
Claude Code offre multiple opzioni di autenticazione: 1. Console Anthropic: L’opzione predefinita. Connettiti tramite la Console Anthropic e completa il processo OAuth. Richiede fatturazione attiva su console.anthropic.com. 2. App Claude (con piano Pro o Max): Iscriviti al piano Pro o Max di Claude per un abbonamento unificato che include sia Claude Code che l’interfaccia web. Ottieni più valore allo stesso prezzo gestendo il tuo account in un unico posto. Accedi con il tuo account Claude.ai. Durante il lancio, scegli l’opzione che corrisponde al tuo tipo di abbonamento. 3. Piattaforme enterprise: Configura Claude Code per utilizzare Amazon Bedrock o Google Vertex AI per distribuzioni enterprise con la tua infrastruttura cloud esistente.
Inizializza il tuo progetto
Per gli utenti alle prime armi, raccomandiamo:
Avvia Claude Code
bash claude
Esegui un comando semplice
bash summarize this project
Genera una guida progetto CLAUDE.md
bash /init
Committa il file CLAUDE.md generato
Chiedi a Claude di committare il file CLAUDE.md generato nel tuo repository.