Source: https://claudetutorial.com/guides/it-it/claude-code-per-principianti-installa-accedi-primo-compito [Torna a Guide](https://claudetutorial.com/guides/it-it) Builder # Claude Code per principianti: installa, accedi ed esegui il tuo primo compito 27 ottobre 2026 15 min di lettura --- 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. > In una chat porti tu il progetto a Claude. In Claude Code è Claude a entrare nel tuo progetto. 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. Claude sceglie la fase successiva in base a ciò che ha trovato nel passaggio precedente. Puoi intervenire 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. Non solo per il codice dei programmatori Tutto ciò che puoi fare dalla riga di comando, Claude Code può aiutarti a farlo: scrivere documentazione, eseguire build, cercare file, ricercare un argomento. Il codice è il suo punto di forza, ma la cartella in cui lavora può contenere qualsiasi progetto. 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](https://claudetutorial.com/guides/it-it/claude-code-progetti-o-chat-quale-usare). Questa guida presuppone che tu abbia già deciso. ## Prima di iniziare Ti servono tre cose, e nessuna è difficile da ottenere. - Un terminale. Su Mac è l'app Terminale, su Windows è PowerShell o CMD, su Linux è quello che usi già. - Una cartella con dentro un progetto. Per una prima sessione va bene qualsiasi cosa: un sito web, uno script, una cartella di documenti. Un progetto vero insegna più di uno vuoto. - Un modo per accedere: un abbonamento Claude Pro, Max, Team o Enterprise, un account Claude Console (accesso API con crediti prepagati) oppure l'accesso tramite un fornitore cloud supportato. 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. | Il tuo sistema | Comando | Si aggiorna da solo? | | --- | --- | --- | | macOS, Linux, WSL | `curl -fsSL https://claude.ai/install.sh \| bash` | Sì | | Windows PowerShell | `irm https://claude.ai/install.ps1 \| iex` | Sì | | Windows CMD | `curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd` | Sì | | Homebrew (Mac) | `brew install --cask claude-code` | No, esegui `brew upgrade claude-code` | | WinGet (Windows) | `winget install Anthropic.ClaudeCode` | No, esegui `winget upgrade Anthropic.ClaudeCode` | 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. PowerShell e CMD non sono la stessa cosa Se il prompt inizia con `PS C:\`, sei in PowerShell. Se mostra `C:\` senza `PS`, sei in CMD. Incollare il comando di CMD in PowerShell produce l'errore `The token '&&' is not a valid statement separator`. Incollare il comando di PowerShell in CMD produce `'irm' is not recognized as an internal or external command`. In entrambi i casi significa solo che hai scelto la riga sbagliata. 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. Terminale ``` $ claude --version2.1.283 (Claude Code) ``` Qualsiasi numero di versione seguito da (Claude Code) significa che l'installazione è riuscita. Il tuo numero sarà diverso. 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. Terminale ``` $ cd ~/projects/my-website$ claude ``` Sostituisci il percorso con la cartella del tuo progetto. 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. Parti sempre dalla cartella del progetto Claude Code considera la cartella da cui lo avvii come la sua directory di lavoro. Avvialo dentro il tuo progetto, non nella cartella home, altrimenti non avrà nulla di rilevante da leggere. ## 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à. Prompt > what does this project do? 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: Prompt > what technologies does this project use? Prompt > where is the main entry point? Prompt > explain the folder structure my-website ``` > 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/. ``` Uno schizzo di sessione. La formulazione esatta e i file che legge saranno diversi nel tuo progetto. 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 [DISPONIBILE SU Google Play](https://play.google.com/store/apps/details?id=com.claudetutorial.mobile) ## Passo 4: fai la tua prima modifica Ora chiedi qualcosa di piccolo e facile da annullare. Prompt > add a hello world function to the main file 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](https://claudetutorial.com/guides/it-it/modalita-permessi-claude-code-e-modalita-plan-spiegate), copre tutte le modalità e quando usare ciascuna. Puoi annullare le modifiche ai file Prima di modificare un file, Claude ne salva un'istantanea. Se qualcosa va storto, premi `Esc` due volte per tornare indietro, oppure chiedi a Claude di annullare la modifica. Le istantanee coprono solo i file, non cose come database o deployment, e lavorano insieme a git senza sostituirlo. ## 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. 1. Guarda a che punto sei Chiedi `what files have I changed?` per ottenere un riepilogo chiaro della tua directory di lavoro. 2. Salva il tuo lavoro Chiedi `commit my changes with a descriptive message`. Claude legge il diff e scrive il messaggio. 3. Crea un ramo Chiedi `create a new branch called feature/quickstart` prima di iniziare qualcosa di più grande, così il ramo principale resta pulito. 4. Consulta la cronologia Chiedi `show me the last 5 commits` quando devi ricordare cosa è successo di recente. 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. | Invece di | Prova | | --- | --- | | `fix the bug` | `fix the login bug where users see a blank screen after entering wrong credentials` | | `add validation` | `add input validation to the user registration form, and show an error under the field that failed` | | `make it faster` | `the product list takes 4 seconds to load. Find out why and tell me before you change anything` | 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. Prompt > 1. create a new database table for user profiles 2. create an API endpoint to get and update user profiles 3. build a page where a user can see and edit their profile 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. | Nella shell | Cosa fa | | --- | --- | | `claude` | Avvia una sessione interattiva | | `claude "fix the build error"` | Avvia una sessione con un primo prompt già scritto | | `claude -p "explain this function"` | Risponde a una sola domanda ed esce | | `claude -c` | Continua la conversazione più recente in questa cartella | | `claude -r` | Ti fa scegliere una conversazione precedente da riprendere | | Dentro una sessione | Cosa fa | | --- | --- | | `/help` | Elenca i comandi disponibili | | `/clear` | Cancella la cronologia della conversazione, un inizio pulito per un nuovo compito | | `/resume` | Continua una conversazione precedente | | `/exit` o `Ctrl+D` due volte | Esce da Claude Code | 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. | Cosa vedi | Cosa significa e cosa fare | | --- | --- | | `claude: command not found` | La cartella di installazione non è ancora nel tuo PATH. Apri prima una nuova finestra del terminale. Se continua a fallire, consulta la pagina ufficiale di risoluzione dei problemi per il tuo sistema. | | `syntax error near unexpected token '<'` o un `403` durante l'installazione | Il download è stato bloccato o reindirizzato, spesso da una rete o da un proxy. La pagina di risoluzione dei problemi elenca altri metodi di installazione, come Homebrew o WinGet. | | Ti chiede di accedere ogni volta | Dovresti accedere una sola volta. Esegui `/login` nella sessione e ripeti il passaggio nel browser, usando ogni volta lo stesso tipo di account. | | Risponde riguardo al progetto sbagliato | L'hai avviato dalla cartella sbagliata. Esci con `/exit`, spostati nel tuo progetto con `cd` e avvia di nuovo `claude`. | 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](https://claudetutorial.com/guides/it-it/claude-md-spiegato-insegna-il-tuo-progetto-a-claude-code), ti mostra come. ## La tua checklist del primo giorno - `claude --version` stampa un numero in una finestra di terminale nuova - Hai avviato `claude` dalla cartella del tuo progetto e hai effettuato l'accesso - Hai fatto almeno tre domande sul progetto prima di cambiare qualcosa - Hai approvato una piccola modifica, letto il cambiamento e sai che `Esc` due volte annulla le modifiche ai file - Sai dove la barra di stato mostra la modalità di permessi e come cambiarla con `Shift+Tab` ## Continua a leggere - [Le modalità di permessi di Claude Code e la modalità Plan, spiegate](https://claudetutorial.com/guides/it-it/modalita-permessi-claude-code-e-modalita-plan-spiegate) per decidere quanto Claude Code può fare senza chiedere. - [CLAUDE.md spiegato: insegna il tuo progetto a Claude Code una volta sola](https://claudetutorial.com/guides/it-it/claude-md-spiegato-insegna-il-tuo-progetto-a-claude-code) per smettere di ripetere le stesse istruzioni a ogni sessione. - [Buone pratiche per Claude Code: abitudini che migliorano i risultati](https://claudetutorial.com/guides/it-it/buone-pratiche-claude-code-abitudini-per-risultati-migliori) per prompt, controlli e gestione del contesto. - [Come fare modifiche su più file con Claude Code](https://claudetutorial.com/guides/it-it/come-fare-modifiche-su-piu-file-con-claude-code) per la tua prima modifica che tocca molti file. - [Collegare Claude ai tuoi dati e strumenti con MCP](https://claudetutorial.com/guides/it-it/come-collegare-claude-ai-tuoi-dati-con-mcp) per andare oltre la tua cartella.