Prima di iniziare
Assicurati di avere:- Un terminale o un prompt dei comandi aperto
- Se non hai mai utilizzato il terminale prima, consulta la guida del terminale
- Un progetto di codice con cui lavorare
- Un abbonamento Claude (Pro, Max, Team o Enterprise), un account Claude Console o accesso tramite un provider cloud supportato
Questa guida copre il CLI del terminale. Claude Code è disponibile anche sul web, come app desktop, in VS Code e IDE JetBrains, in Slack e in CI/CD con GitHub Actions e GitLab. Vedi tutte le interfacce.
Passaggio 1: Installa Claude Code
Per installare Claude Code, apri un terminale ed esegui il comando per il tuo sistema. Se non hai mai utilizzato un terminale prima, la guida al terminale mostra come aprirne uno e incollare il comando.- Installazione nativa (consigliata)
- Homebrew
- WinGet
macOS, Linux, WSL:Windows PowerShell:Windows CMD:Quando il programma di installazione termina, apri una nuova finestra del terminale ed esegui
claude --version. Un’installazione funzionante stampa un numero di versione. Se la tua shell dice che claude non è trovato o non è riconosciuto, la directory di installazione non è ancora nel tuo PATH: vedi Correggi il tuo PATH.Se vedi The token '&&' is not a valid statement separator, sei in PowerShell, non in CMD. Se vedi 'irm' is not recognized as an internal or external command, sei in CMD, non in PowerShell. Il tuo prompt mostra PS C:\ quando sei in PowerShell e C:\ senza il PS quando sei in CMD.Se il comando di installazione non riesce con syntax error near unexpected token '<', un 403, o un altro errore curl, consulta Troubleshoot installation per abbinare l’errore a una soluzione e per metodi di installazione alternativi.Git for Windows è consigliato su Windows nativo in modo che Claude Code possa utilizzare lo strumento Bash. Se Git for Windows non è installato, Claude Code utilizza PowerShell come strumento shell. Le configurazioni WSL non necessitano di Git for Windows.Le installazioni native si aggiornano automaticamente in background per mantenerti sulla versione più recente.
(Claude Code).
Passaggio 2: Accedi al tuo account
Claude Code richiede un account per essere utilizzato. Avvia una sessione interattiva con il comandoclaude e ti verrà chiesto di effettuare l’accesso al primo utilizzo:
ANTHROPIC_API_KEY, Claude Code salta il prompt di accesso e ti chiede invece di approvare la chiave. Per cambiare account in seguito o effettuare nuovamente l’autenticazione, digita /login all’interno della sessione in esecuzione:
- Claude Pro, Max, Team o Enterprise (consigliato)
- Claude Console (accesso API con crediti prepagati). Al primo accesso, uno spazio di lavoro “Claude Code” viene creato automaticamente nella Console per il tracciamento centralizzato dei costi.
- Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry (provider cloud aziendali)
- Un gateway di app Claude auto-ospitato, se la tua organizzazione ne esegue uno: il tuo amministratore pre-configura l’URL del gateway, e
/loginsi apre direttamente sulla schermata Cloud gateway per consentire l’accesso con SSO aziendale
Passaggio 3: Avvia la tua prima sessione
Apri il tuo terminale in qualsiasi directory del progetto e avvia Claude Code:/path/to/your/project con il percorso del progetto su cui desideri lavorare.
Vedrai il prompt di Claude Code con la versione, il modello attuale e la directory di lavoro mostrati sopra. Digita /help per i comandi disponibili o /resume per continuare una conversazione precedente.
Passaggio 4: Fai la tua prima domanda
Iniziamo con la comprensione della tua base di codice. Prova uno di questi comandi:Claude Code legge i file del tuo progetto secondo le necessità. Non devi aggiungere manualmente il contesto.
Passaggio 5: Fai il tuo primo cambio di codice
Ora facciamo in modo che Claude Code faccia un po’ di codifica vera. Prova un’attività semplice:Le vostre impostazioni o la vostra organizzazione possono impostare una modalità di autorizzazione iniziale diversa. Quale modalità di autorizzazione una sessione inizia elenca cosa lo fa. Premete
Shift+Tab in qualsiasi momento per cambiare la modalità di autorizzazione della sessione in cui vi trovate.Passaggio 6: Usa Git con Claude Code
Claude Code rende le operazioni Git conversazionali:Passaggio 7: Correggi un bug o aggiungi una funzionalità
Claude è abile nel debug e nell’implementazione di funzionalità. Descrivi quello che vuoi in linguaggio naturale:- Individuare il codice rilevante
- Comprendere il contesto
- Implementare una soluzione
- Eseguire i test se disponibili
Passaggio 8: Prova altri flussi di lavoro comuni
Ci sono diversi modi per lavorare con Claude: Refactoring del codiceComandi essenziali
Ecco i comandi più importanti per l’uso quotidiano. I comandi shell vengono eseguiti dal vostro terminale per avviare o riprendere Claude Code. I comandi di sessione vengono eseguiti all’interno di Claude Code dopo l’avvio. Comandi shell
Comandi di sessione
Vedi il riferimento CLI per l’elenco completo dei comandi shell e il riferimento comandi per l’elenco completo dei comandi di sessione.
Suggerimenti professionali per i principianti
Per ulteriori informazioni, vedi best practices e flussi di lavoro comuni.Sii specifico con le tue richieste
Sii specifico con le tue richieste
Invece di: “correggi il bug”Prova: “correggi il bug di accesso in cui gli utenti vedono una schermata vuota dopo aver inserito credenziali errate”
Usa istruzioni passo dopo passo
Usa istruzioni passo dopo passo
Suddividi i compiti complessi in passaggi:
Lascia che Claude esplori prima
Lascia che Claude esplori prima
Prima di apportare modifiche, lascia che Claude comprenda il tuo codice:
Risparmia tempo con le scorciatoie
Risparmia tempo con le scorciatoie
- Digita
/per vedere tutti i comandi e le skills disponibili - Usa Tab per il completamento dei comandi
- Premi ↑ per la cronologia dei comandi
- Premi
Shift+Tabper ciclo tra le modalità di autorizzazione
Cosa fare dopo?
Ora che hai imparato le nozioni di base, esplora funzionalità più avanzate:Come funziona Claude Code
Comprendi il loop agentico, gli strumenti integrati e come Claude Code interagisce con il tuo progetto
Best practices
Ottieni risultati migliori con prompt efficaci e configurazione del progetto
Flussi di lavoro comuni
Guide passo dopo passo per attività comuni
Estendi Claude Code
Personalizza con CLAUDE.md, skills, hooks, MCP e altro
Ottenere aiuto
- In Claude Code: Digita
/helpo chiedi “come faccio a…” - Documentazione: Sei qui! Sfoglia altre guide
- Corsi: Segui Claude Code 101 e altri corsi gratuiti a tuo ritmo su Claude Academy
- Community: Unisciti al nostro Discord per suggerimenti e supporto