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

Passaggio 1: Installa Claude Code

Per installare Claude Code, utilizza uno dei seguenti metodi:

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

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

brew install --cask claude-code

winget install Anthropic.ClaudeCode

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: Accedi al tuo account

Claude Code richiede un account per essere utilizzato. Avvia una sessione interattiva con il comando claude e ti verrà chiesto di effettuare l'accesso al primo utilizzo:

claude

Per gli account Claude subscription o Console, segui i prompt per completare l'autenticazione nel tuo browser. Se hai impostato la variabile di ambiente 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:

/login

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 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 /login si apre direttamente sulla schermata Cloud gateway per consentire l'accesso con SSO aziendale

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

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

Sostituisci /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:

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?

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 trova il file appropriato e ti mostra la modifica. Se chiede prima di apportare la modifica, seleziona Sì per approvare.

La modalità Auto è la modalità di autorizzazione iniziale integrata per le sessioni di terminale interattive sui piani Pro, Max e Team: un classificatore esamina le azioni invece di voi, e Claude modifica la maggior parte dei file ed esegue la maggior parte dei comandi senza chiedere. Su altri piani, la modalità Manual è la modalità di autorizzazione iniziale integrata. Per la sessione che avviate subito dopo l'installazione, vedere Prima sessione dopo un'installazione o un aggiornamento.

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

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

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.

Prova: "correggi il bug di accesso in cui gli utenti vedono una schermata vuota dopo aver inserito credenziali errate"

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

analizza lo schema del database

costruisci una dashboard che mostra i prodotti che vengono restituiti più frequentemente dai nostri clienti nel Regno Unito

Cosa fare dopo?

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

Ottenere aiuto

• In Claude Code: Digita /help o 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