Claude Code per principianti: installa, accedi ed esegui il tuo primo compito

Molte persone incontrano Claude Code come qualsiasi strumento nuovo: aprono un terminale, si sentono perse e tornano a incollare codice in una chat. Funziona, ma si perde proprio ciò che rende Claude Code diverso. Non ha bisogno che tu incolli nulla.

Questa guida ti porta da zero a un primo compito completato. Installerai lo strumento, accederai, farai domande su un progetto vero, farai una piccola modifica e imparerai i pochi comandi che coprono gran parte della tua prima settimana.

Cos'è davvero Claude Code

Claude Code è un assistente che gira nel tuo terminale, nella cartella del tuo progetto. Quando gli dai un compito, lavora in un ciclo a tre fasi: raccoglie il contesto, agisce e verifica il risultato. Ripete il ciclo finché il compito non è finito, e puoi interromperlo in qualsiasi momento.

La differenza rispetto a una chat sono gli strumenti. Una chat sa rispondere solo con testo. Claude Code può leggere i tuoi file, modificarli, cercare nel progetto, eseguire comandi come la suite di test e usare git. Ogni risultato alimenta la decisione successiva.

Supponi di chiedergli di correggere i test che falliscono. In genere eseguirà i test per vedere cosa non va, leggerà l'output degli errori, cercherà i file coinvolti, li leggerà, li modificherà e rieseguirà i test. Tu hai scritto una frase. Lui ha fatto sei passaggi.

Se stai ancora decidendo se Claude Code sia lo strumento giusto per ciò che devi fare, leggi prima Claude Code, progetti o chat: come scegliere. Questa guida presuppone che tu abbia già deciso.

Prima di iniziare

Ti servono tre cose, e nessuna è difficile da ottenere.

Claude Code non fa parte del piano gratuito di Claude, quindi serve uno di questi account. Se non hai mai aperto un terminale, la guida ufficiale al terminale mostra come aprirlo e incollare un comando. Bastano circa due minuti.

Passo 1: installa Claude Code

Ci sono diversi modi per installarlo. L'installer nativo è quello consigliato, perché si aggiorna da solo in background.

Scegli il comando adatto al tuo sistema, incollalo nel terminale e premi Invio. L'installer non mostra alcun avanzamento durante il download, quindi non pensare che si sia bloccato.

Su Linux puoi anche installare con apt, dnf o apk su Debian, Fedora, RHEL e Alpine. Su Windows nativo si consiglia Git for Windows, così Claude Code può usare lo strumento Bash. Senza, Claude Code usa PowerShell. Se usi WSL, Git for Windows non serve.

Verifica che abbia funzionato

Quando l'installer termina, apri una nuova finestra del terminale. È importante: la vecchia finestra non conosce ancora il nuovo programma. Poi esegui il comando della versione.

$ claude --version2.1.283 (Claude Code)

Se la shell dice che claude non è stato trovato o non è riconosciuto, la cartella di installazione non è ancora nel tuo PATH. Nella maggior parte dei casi basta chiudere e riaprire il terminale. Se non basta, la pagina ufficiale di risoluzione dei problemi di installazione associa ogni messaggio di errore alla sua soluzione.

Passo 2: avvia la prima sessione

Vai nella cartella del tuo progetto e digita il nome del programma.

$ cd ~/projects/my-website$ claude

La prima volta Claude Code ti chiede di accedere. Con un abbonamento Claude o un account Console apre il browser, approvi l'accesso lì e torni al terminale. Le credenziali vengono salvate, quindi non dovrai rifarlo.

Puoi accedere in uno di questi modi:

• Con un account Claude Pro, Max, Team o Enterprise, la via consigliata.
• Con un account Claude Console. Al primo accesso viene creato automaticamente un workspace "Claude Code", così puoi tenere traccia dei costi.
• Con Amazon Bedrock, Google Cloud o Microsoft Foundry, per chi ha l'accesso fornito così dalla propria azienda.

Se hai impostato la variabile d'ambiente ANTHROPIC_API_KEY e approvi la chiave quando richiesto, Claude Code salta il passaggio di accesso.

Una volta dentro, vedi un prompt con la versione, il modello attuale e la cartella in cui stai lavorando. Digita /help per elencare i comandi, /resume per riprendere una conversazione precedente, oppure /login più tardi se devi cambiare account.

Passo 3: fai domande prima di cambiare qualcosa

I tuoi primi prompt non devono modificare nulla. Le domande sono il modo più sicuro per vedere come Claude Code legge il tuo progetto, e ti mostrano cosa sa già.

Claude legge i file che gli servono e risponde. Non devi aggiungere file a mano: li trova da solo. Continua con domande più mirate, una alla volta:

> what does this project do?Reading package.json, README.md, src/ ...Questo è un sito di marketing statico creato con Next.js. Le pagine stanno in src/app, i componenti condivisi in src/components e i contenuti nella cartella content/.

Puoi anche fare domande a Claude Code su se stesso. Domande come "what can Claude Code do?" o "how do I create custom skills in Claude Code?" ricevono risposte vere, perché conosce la propria documentazione.

Dentro Claude Tutorial

Chiedere prima di agire è un'abitudine da costruire

Far spiegare all'assistente ciò che vede prima di chiedere modifiche è la stessa disciplina che l'app insegna per ogni tipo di lavoro, non solo per il codice.

In arrivo

Scarica suApp Store

DISPONIBILE SUGoogle Play

Passo 4: fai la tua prima modifica

Ora chiedi qualcosa di piccolo e facile da annullare.

Claude Code trova il file giusto e ti mostra la modifica che vuole fare. A seconda delle impostazioni, può chiedere prima la tua approvazione. In quel caso leggi ciò che propone e scegli Yes.

Quel prompt è volutamente minuscolo. Lo scopo di questo passo non è la funzione, ma vedere una volta l'intero ciclo: chiedi, Claude trova il file, mostra la modifica, tu approvi e il file cambia.

Ciò che Claude Code può fare senza chiedere dipende dalla modalità di permessi della sessione. Premi Shift+Tab in qualsiasi momento per passare da una modalità all'altra. Le versioni più recenti avviano le sessioni interattive del terminale in modalità auto, dove un controllo in background blocca le azioni rischiose invece di chiederti conferma per ciascuna, mentre le versioni più vecchie o altre configurazioni chiedono più spesso. Guarda la barra di stato per sapere in quale modalità ti trovi. La prossima guida, Le modalità di permessi di Claude Code e la modalità Plan, spiegate, copre tutte le modalità e quando usare ciascuna.

Passo 5: usa git parlandoci

Se il tuo progetto usa git, puoi gestirlo a voce, in conversazione. Tutte queste richieste funzionano così come sono scritte.

Anche quando ti fidi, leggi il messaggio di commit e il diff prima di accettare. Sei tu il revisore di tutto ciò che Claude Code produce.

Passo 6: correggi un bug o aggiungi una funzionalità

I compiti veri vanno meglio con dettagli veri. Confronta questi due modi di chiedere la stessa correzione.

Le versioni migliori indicano il sintomo, il punto e come si presenta il lavoro finito. Claude Code sa trovare i file da solo, quindi non devi elencarli, ma non può leggerti nel pensiero per capire a quale problema ti riferisci.

Per i lavori più grandi, dividi il compito in passaggi con un elenco numerato.

E quando non conosci ancora il codice, lascia che Claude esplori prima: chiedigli di analizzare lo schema del database, o come funziona il checkout, prima di chiedergli di cambiare l'uno o l'altro. Pochi minuti di lettura di solito evitano una modifica sbagliata.

I comandi che userai ogni giorno

Alcuni comandi si eseguono nella shell, prima che Claude Code parta, altri dentro una sessione.

Alcuni tasti fanno risparmiare molto tempo. Digita / per vedere tutti i comandi e le competenze (skills) che hai. Premi Tab per completare un comando, ↑ per richiamare i prompt precedenti e Shift+Tab per cambiare la modalità di permessi. Premi Esc per fermare subito Claude se va nella direzione sbagliata.

Quando il primo giorno va storto

Questi sono i problemi in cui ci si imbatte più spesso, con il significato di ciascuno.

Quando niente di tutto questo corrisponde, chiedi a Claude Code stesso. Scrivi qualcosa come "how do I fix this error?" incollando il messaggio. Il comando /doctor esegue anche un controllo della configurazione che diagnostica i problemi di installazione e impostazione.

Non sei obbligato a usare il terminale

Il terminale è la casa originale di Claude Code, e tutto ciò che hai letto vale lì. Lo stesso assistente è disponibile anche come app desktop, dentro gli editor VS Code e JetBrains, sul web su claude.ai/code, in Slack e in pipeline automatizzate con GitHub Actions e GitLab. L'interfaccia cambia il modo in cui lo vedi e gli parli. Il ciclo di raccolta del contesto, azione e verifica è lo stesso ovunque.

Domande frequenti

Claude Code è gratuito?

No. Richiede un abbonamento Claude Pro, Max, Team o Enterprise, un account Claude Console con crediti API o l'accesso tramite un fornitore cloud supportato. Il piano gratuito di Claude non lo include.

Devo saper programmare per usare Claude Code?

Ti serve un progetto da dargli, e più capisci il progetto, meglio riesci a giudicare il suo lavoro. Non devi scrivere il codice tu stesso. I principianti ottengono di più dall'abitudine di partire dalle domande del Passo 3: chiedi a Claude di spiegare prima di chiedergli di cambiare.

È sicuro lasciargli modificare i miei file?

Controlli ciò che può fare senza chiedere tramite la modalità di permessi, e le modifiche ai file si annullano con Esc due volte. Tratta il suo output come la pull request di un collega: leggi il diff prima del commit. Tieni il progetto in git, così ogni modifica è facile da rivedere o annullare.

Che differenza c'è tra Claude Code e Claude in una chat?

Una chat risponde con testo su ciò che incolli. Claude Code lavora dentro il tuo progetto: legge i file da solo, li modifica, esegue comandi e controlla il proprio lavoro. Usa la chat per pensare, usa Claude Code per fare.

Claude Code ricorda il mio progetto da una sessione all'altra?

Ogni sessione parte con un contesto nuovo. Per portare conoscenza da una sessione all'altra la scrivi in un file chiamato CLAUDE.md, e Claude Code tiene anche appunti propri sulle tue preferenze. La guida successiva a quella prossima, CLAUDE.md spiegato, ti mostra come.

La tua checklist del primo giorno

Continua a leggere

• Le modalità di permessi di Claude Code e la modalità Plan, spiegate per decidere quanto Claude Code può fare senza chiedere.
• CLAUDE.md spiegato: insegna il tuo progetto a Claude Code una volta sola per smettere di ripetere le stesse istruzioni a ogni sessione.
• Buone pratiche per Claude Code: abitudini che migliorano i risultati per prompt, controlli e gestione del contesto.
• Come fare modifiche su più file con Claude Code per la tua prima modifica che tocca molti file.
• Collegare Claude ai tuoi dati e strumenti con MCP per andare oltre la tua cartella.