SpyBara
Go Premium

quickstart.md 2026-10-06 23:59 UTC to 2026-10-07 20:01 UTC

This page contains 76 additions and 110 deletions.

2026
Tue 6 23:59 Wed 7 20:57

Guida rapida

Installa Claude Code nel tuo terminale, accedi e usa la CLI per esplorare il tuo codebase e apportare la tua prima modifica al codice.

Questa guida rapida tratta Claude Code nel tuo terminale: l'installazione della CLI, l'accesso dalla tua prima sessione e il suo utilizzo per le attività di sviluppo comuni nel tuo progetto.

Prima di iniziare

Assicurati di avere:

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.

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Su Windows, il tuo prompt mostra PS C:\ quando sei in PowerShell e C:\ senza il PS quando sei in CMD.

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

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.

Se il comando di installazione non riesce con syntax error near unexpected token '<', un 403 o qualsiasi altro errore, consulta Risoluzione dei problemi di installazione 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.

Puoi anche installare con apt, dnf, o apk su Debian, Fedora, RHEL e Alpine.

Per confermare che l'installazione ha funzionato, esegui:

claude --version

Il comando stampa un numero di versione seguito da (Claude Code).

Passaggio 2: Avvia la tua prima sessione

Apri il terminale in qualsiasi directory di progetto e avvia Claude Code:

cd /path/to/your/project
claude

Sostituisci /path/to/your/project con il percorso del progetto su cui vuoi lavorare.

Al primo utilizzo, Claude Code ti chiede di accedere. Per gli abbonamenti Claude o gli account Console, segui le istruzioni per completare l'autenticazione nel browser. Se hai impostato la variabile d'ambiente ANTHROPIC_API_KEY e approvi la chiave quando Claude Code ti chiede se usarla, Claude Code salta la richiesta di accesso.

Puoi accedere con uno qualsiasi di questi tipi di account:

Una volta effettuato l'accesso, le tue credenziali vengono memorizzate e non dovrai accedere di nuovo. Scopri di più in Gestione delle credenziali.

Viene visualizzato il prompt di Claude Code, con la versione, il modello corrente e la directory di lavoro mostrati sopra di esso. Digita /help per i comandi disponibili oppure /resume per continuare una conversazione precedente. Per cambiare account in seguito o ripetere l'autenticazione, digita /login all'interno della sessione in esecuzione.

Passaggio 3: Fai la tua prima domanda

Prova uno di questi comandi:

what does this project do?

Claude analizzerà i tuoi file e fornirà un riepilogo. Puoi anche fare domande più specifiche:

what technologies does this project use?

where is the main entry point?

explain the folder structure

Puoi anche chiedere a Claude informazioni sulle sue capacità:

what can Claude Code do?

how do I create custom skills in Claude Code?

can Claude Code work with Docker?

Passaggio 4: Apporta la tua prima modifica al codice

Prova un'attività semplice:

add a hello world function to the main file

Claude Code trova il file appropriato e ti mostra la modifica. Se ti chiede conferma prima di apportare la modifica, seleziona Yes per approvarla.

La modalità di permesso della sessione stabilisce quali azioni Claude può eseguire senza chiederti prima conferma. Premi Shift+Tab in qualsiasi momento per cambiare la modalità di permesso della sessione in cui ti trovi.

Passaggio 5: Usa Git con Claude Code

Claude Code rende le operazioni Git conversazionali:

what files have I changed?

commit my changes with a descriptive message

Puoi anche chiedere operazioni Git più complesse:

create a new branch called feature/quickstart

show me the last 5 commits

help me resolve merge conflicts

Passaggio 6: Correggi un bug o aggiungi una funzionalità

Descrivi ciò che desideri in linguaggio naturale:

add input validation to the user registration form

Oppure correggi problemi esistenti:

there's a bug where users can submit empty forms - fix it

Passaggio 7: Prova altri workflow comuni

Ci sono diversi modi per lavorare con Claude:

Refactoring del codice

refactor the authentication module to use async/await instead of callbacks

Scrivere test

write unit tests for the calculator functions

Aggiornare la documentazione

update the README with installation instructions

Code review

review my changes and suggest improvements

Comandi 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

Comando Cosa fa Esempio
claude Avvia la modalità interattiva claude
claude "task" Avvia la modalità interattiva con un prompt iniziale 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

Comandi di sessione

Comando Cosa fa Esempio
/clear Cancella la cronologia della conversazione /clear
/help Mostra i comandi disponibili /help
/exit o Ctrl+D due volte Esci da Claude Code /exit

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.

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

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 disponibili
  • Usa Tab per il completamento dei comandi
  • Premi ↑ per la cronologia dei comandi
  • Premi Shift+Tab per ciclo tra le modalità di autorizzazione

Cosa fare dopo?

Ora che hai imparato le nozioni di base, esplora funzionalità più avanzate:

Consulta la configurazione avanzata per le opzioni di installazione, gli aggiornamenti manuali o le istruzioni di disinstallazione.

Ottenere aiuto

  • In Claude Code: digita /help o fai una domanda del tipo "come faccio a..."
  • Documentazione: sfoglia le altre guide su questo sito
  • Corsi: Segui Claude Code 101 e altri corsi gratuiti a tuo ritmo su Claude Academy
  • Community: Unisciti al server Discord per suggerimenti e supporto