Guida rapida
Benvenuto in Claude Code!
Questa guida rapida ti permetterà di utilizzare l'assistenza alla codifica basata su IA in pochi minuti. Alla fine, comprenderai come utilizzare Claude Code per le attività di sviluppo comuni.
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
To install Claude Code, use one of the following methods:
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
If you see The token '&&' is not a valid statement separator, you're in PowerShell, not CMD. If you see 'irm' is not recognized as an internal or external command, you're in CMD, not PowerShell. Your prompt shows PS C:\ when you're in PowerShell and C:\ without the PS when you're in CMD.
Git for Windows is recommended on native Windows so Claude Code can use the Bash tool. If Git for Windows is not installed, Claude Code uses PowerShell as the shell tool instead. WSL setups do not need Git for Windows.
Native installations automatically update in the background to keep you on the latest version.
brew install --cask claude-code
Homebrew offers two casks. claude-code tracks the stable release channel, which is typically about a week behind and skips releases with major regressions. claude-code@latest tracks the latest channel and receives new versions as soon as they ship.
Homebrew installations do not auto-update. Run brew upgrade claude-code or brew upgrade claude-code@latest, depending on which cask you installed, to get the latest features and security fixes.
winget install Anthropic.ClaudeCode
WinGet installations do not auto-update. Run winget upgrade Anthropic.ClaudeCode periodically to get the latest features and security fixes.
You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.
Passaggio 2: Accedi al tuo account
Claude Code richiede un account per essere utilizzato. Quando avvii una sessione interattiva con il comando claude, dovrai effettuare l'accesso:
claude
# Ti verrà chiesto di effettuare l'accesso al primo utilizzo
/login
# Segui i prompt per accedere con il tuo account
Puoi accedere utilizzando uno di questi tipi di account:
- 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 Vertex AI o Microsoft Foundry (provider cloud aziendali)
Una volta effettuato l'accesso, le tue credenziali vengono archiviate e non dovrai accedere di nuovo. Per cambiare account in seguito, utilizza il comando /login.
Passaggio 3: Avvia la tua prima sessione
Apri il tuo terminale in qualsiasi directory del progetto e avvia Claude Code:
cd /path/to/your/project
claude
Vedrai la schermata di benvenuto di Claude Code con le informazioni della tua sessione, le conversazioni recenti e gli ultimi aggiornamenti. Digita /help per i comandi disponibili o /resume per continuare una conversazione precedente.
Dopo aver effettuato l'accesso (Passaggio 2), le tue credenziali vengono archiviate sul tuo sistema. Scopri di più in Gestione delle credenziali.
Passaggio 4: Fai la tua prima domanda
Iniziamo con la comprensione della tua base di codice. Prova uno di questi comandi:
cosa fa questo progetto?
Claude analizzerà i tuoi file e fornirà un riepilogo. Puoi anche fare domande più specifiche:
quali tecnologie utilizza questo progetto?
dov'è il punto di ingresso principale?
spiega la struttura delle cartelle
Puoi anche chiedere a Claude informazioni sulle sue stesse capacità:
cosa può fare Claude Code?
come creo skill personalizzate in Claude Code?
Claude Code può funzionare con Docker?
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:
aggiungi una funzione hello world al file principale
Claude Code farà:
- Trovare il file appropriato
- Mostrarti le modifiche proposte
- Chiedere la tua approvazione
- Effettuare la modifica
Claude Code chiede sempre il permesso prima di modificare i file. Puoi approvare i singoli cambiamenti o abilitare la modalità "Accetta tutto" per una sessione.
Passaggio 6: Usa Git con Claude Code
Claude Code rende le operazioni Git conversazionali:
quali file ho modificato?
esegui il commit delle mie modifiche con un messaggio descrittivo
Puoi anche richiedere operazioni Git più complesse:
crea un nuovo branch chiamato feature/quickstart
mostrami gli ultimi 5 commit
aiutami a risolvere i conflitti di merge
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:
aggiungi la convalida dell'input al modulo di registrazione dell'utente
O correggi i problemi esistenti:
c'è un bug in cui gli utenti possono inviare moduli vuoti - correggilo
Claude Code farà:
- 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 codice
refactorizza il modulo di autenticazione per utilizzare async/await invece di callback
Scrivi test
scrivi unit test per le funzioni della calcolatrice
Aggiorna la documentazione
aggiorna il README con le istruzioni di installazione
Revisione del codice
rivedi le mie modifiche e suggerisci miglioramenti
Parla a Claude come faresti con un collega utile. Descrivi quello che vuoi ottenere e ti aiuterà a raggiungerlo.
Comandi essenziali
Ecco i comandi più importanti per l'uso quotidiano:
| Comando | Cosa fa | Esempio |
|---|---|---|
claude |
Avvia la modalità interattiva | claude |
claude "task" |
Esegui un'attività una tantum | claude "fix the build error" |
claude -p "query" |
Esegui una query una tantum, quindi esci | claude -p "explain this function" |
claude -c |
Continua la conversazione più recente nella directory corrente | claude -c |
claude -r |
Riprendi una conversazione precedente | claude -r |
/clear |
Cancella la cronologia della conversazione | /clear |
/help |
Mostra i comandi disponibili | /help |
exit o Ctrl+D |
Esci da Claude Code | exit |
Vedi il riferimento CLI per un elenco completo dei comandi.
Suggerimenti professionali per i principianti
Per ulteriori informazioni, vedi best practices e flussi di lavoro comuni.
Prova: "correggi il bug di accesso in cui gli utenti vedono una schermata vuota dopo aver inserito credenziali errate"
Usa istruzioni passo dopo passo
Suddividi i compiti complessi in passaggi:
1. crea una nuova tabella di database per i profili utente
2. crea un endpoint API per ottenere e aggiornare i profili utente
3. costruisci una pagina web che consenta agli utenti di visualizzare e modificare le loro informazioni
Lascia che Claude esplori prima
Prima di apportare modifiche, lascia che Claude comprenda il tuo codice:
analizza lo schema del database
costruisci una dashboard che mostra i prodotti che vengono restituiti più frequentemente dai nostri clienti nel Regno Unito
Risparmia tempo con le scorciatoie
- Digita
/per vedere tutti i comandi e le skills - 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:
Comprendi il loop agentico, gli strumenti integrati e come Claude Code interagisce con il tuo progetto
Ottieni risultati migliori con prompt efficaci e configurazione del progetto
Guide passo dopo passo per attività comuni
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
- Community: Unisciti al nostro Discord per suggerimenti e supporto