15Assicurati di avere:15Assicurati di avere:
16 16
17* Un terminale o un prompt dei comandi aperto17* Un terminale o un prompt dei comandi aperto
18 * Se non hai mai utilizzato il terminale prima, consulta la [guida del terminale](/it/terminal-guide)18 * Se non hai mai utilizzato il terminale prima, consulta la [guida del terminale](/docs/it/terminal-guide)
19* Un progetto di codice con cui lavorare19* Un progetto di codice con cui lavorare
20* Un [abbonamento Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team o Enterprise), un account [Claude Console](https://console.anthropic.com/) o accesso tramite un [provider cloud supportato](/it/third-party-integrations)20* Un [abbonamento Claude](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_prereq) (Pro, Max, Team o Enterprise), un account [Claude Console](https://platform.claude.com/) o accesso tramite un [provider cloud supportato](/docs/it/third-party-integrations)
21 21
22<Note>22<Note>
23 Questa guida copre il CLI del terminale. Claude Code è disponibile anche sul [web](https://claude.ai/code), come [app desktop](/it/desktop), in [VS Code](/it/vs-code) e [IDE JetBrains](/it/jetbrains), in [Slack](/it/slack) e in CI/CD con [GitHub Actions](/it/github-actions) e [GitLab](/it/gitlab-ci-cd). Vedi [tutte le interfacce](/it/overview#use-claude-code-everywhere).23 Questa guida copre il CLI del terminale. Claude Code è disponibile anche sul [web](https://claude.ai/code), come [app desktop](/docs/it/desktop), in [VS Code](/docs/it/vs-code) e [IDE JetBrains](/docs/it/jetbrains), in [Slack](/docs/it/slack) e in CI/CD con [GitHub Actions](/docs/it/github-actions) e [GitLab](/docs/it/gitlab-ci-cd). Vedi [tutte le interfacce](/docs/it/overview#use-claude-code-everywhere).
24</Note>24</Note>
25 25
26<h2 id="step-1-install-claude-code">26<h2 id="step-1-install-claude-code">
33 <Tab title="Native Install (Recommended)">33 <Tab title="Native Install (Recommended)">
34 **macOS, Linux, WSL:**34 **macOS, Linux, WSL:**
35 35
36 ```bash theme={null}36 ```bash theme={null} theme={null} theme={null} theme={null}
37 curl -fsSL https://claude.ai/install.sh | bash37 curl -fsSL https://claude.ai/install.sh | bash
38 ```38 ```
39 39
40 **Windows PowerShell:**40 **Windows PowerShell:**
41 41
42 ```powershell theme={null}42 ```powershell theme={null} theme={null} theme={null} theme={null}
43 irm https://claude.ai/install.ps1 | iex43 irm https://claude.ai/install.ps1 | iex
44 ```44 ```
45 45
46 **Windows CMD:**46 **Windows CMD:**
47 47
48 ```batch theme={null}48 ```batch theme={null} theme={null} theme={null} theme={null}
49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd49 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
50 ```50 ```
51 51
52 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.52 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.
53 53
54 If the install command fails with `syntax error near unexpected token '<'`, a `403`, or another curl error, see [Troubleshoot installation](/en/troubleshoot-install#find-your-error) to match the error to a fix and for alternative install methods.54 If the install command fails with `syntax error near unexpected token '<'`, a `403`, or another curl error, see [Troubleshoot installation](/docs/en/troubleshoot-install#find-your-error) to match the error to a fix and for alternative install methods.
55 55
56 [Git for Windows](https://git-scm.com/downloads/win) 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.56 [Git for Windows](https://git-scm.com/downloads/win) 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.
57 57
61 </Tab>61 </Tab>
62 62
63 <Tab title="Homebrew">63 <Tab title="Homebrew">
64 ```bash theme={null}64 ```bash theme={null} theme={null} theme={null} theme={null}
65 brew install --cask claude-code65 brew install --cask claude-code
66 ```66 ```
67 67
73 </Tab>73 </Tab>
74 74
75 <Tab title="WinGet">75 <Tab title="WinGet">
76 ```powershell theme={null}76 ```powershell theme={null} theme={null} theme={null} theme={null}
77 winget install Anthropic.ClaudeCode77 winget install Anthropic.ClaudeCode
78 ```78 ```
79 79
83 </Tab>83 </Tab>
84</Tabs>84</Tabs>
85 85
86You can also install with [apt, dnf, or apk](/en/setup#install-with-linux-package-managers) on Debian, Fedora, RHEL, and Alpine.86You can also install with [apt, dnf, or apk](/docs/en/setup#install-with-linux-package-managers) on Debian, Fedora, RHEL, and Alpine.
87
88Per confermare che l'installazione ha funzionato, esegui:
89
90```bash theme={null}
91claude --version
92```
93
94Il comando stampa un numero di versione seguito da `(Claude Code)`.
87 95
88<h2 id="step-2-log-in-to-your-account">96<h2 id="step-2-log-in-to-your-account">
89 Passaggio 2: Accedi al tuo account97 Passaggio 2: Accedi al tuo account
95claude103claude
96```104```
97 105
98Per gli account Claude subscription o Console, segui i prompt per completare l'autenticazione nel tuo browser. Per cambiare account in seguito o effettuare nuovamente l'autenticazione, digita `/login` all'interno della sessione in esecuzione:106Per 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:
99 107
100```text theme={null}108```text wrap theme={null}
101/login109/login
102```110```
103 111
104Puoi accedere utilizzando uno di questi tipi di account:112Puoi accedere utilizzando uno di questi tipi di account:
105 113
106* [Claude Pro, Max, Team o Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (consigliato)114* [Claude Pro, Max, Team o Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login) (consigliato)
107* [Claude Console](https://console.anthropic.com/) (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.115* [Claude Console](https://platform.claude.com/) (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.
108* [Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry](/it/third-party-integrations) (provider cloud aziendali)116* [Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry](/docs/it/third-party-integrations) (provider cloud aziendali)
109* Un [gateway di app Claude](/it/claude-apps-gateway) 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 aziendale117* Un [gateway di app Claude](/docs/it/claude-apps-gateway) 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
110 118
111Una volta effettuato l'accesso, le tue credenziali vengono archiviate e non dovrai accedere di nuovo.119Una volta effettuato l'accesso, le tue credenziali vengono archiviate e non dovrai accedere di nuovo. Scopri di più in [Gestione delle credenziali](/docs/it/authentication#credential-management).
112 120
113<h2 id="step-3-start-your-first-session">121<h2 id="step-3-start-your-first-session">
114 Passaggio 3: Avvia la tua prima sessione122 Passaggio 3: Avvia la tua prima sessione
121claude129claude
122```130```
123 131
124Vedrai 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.132Sostituisci `/path/to/your/project` con il percorso del progetto su cui desideri lavorare.
125 133
126<Tip>134Vedrai 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.
127 Dopo aver effettuato l'accesso (Passaggio 2), le tue credenziali vengono archiviate sul tuo sistema. Scopri di più in [Gestione delle credenziali](/it/authentication#credential-management).
128</Tip>
129 135
130<h2 id="step-4-ask-your-first-question">136<h2 id="step-4-ask-your-first-question">
131 Passaggio 4: Fai la tua prima domanda137 Passaggio 4: Fai la tua prima domanda
133 139
134Iniziamo con la comprensione della tua base di codice. Prova uno di questi comandi:140Iniziamo con la comprensione della tua base di codice. Prova uno di questi comandi:
135 141
136```text theme={null}142```text wrap theme={null}
137cosa fa questo progetto?143cosa fa questo progetto?
138```144```
139 145
140Claude analizzerà i tuoi file e fornirà un riepilogo. Puoi anche fare domande più specifiche:146Claude analizzerà i tuoi file e fornirà un riepilogo. Puoi anche fare domande più specifiche:
141 147
142```text theme={null}148```text wrap theme={null}
143quali tecnologie utilizza questo progetto?149quali tecnologie utilizza questo progetto?
144```150```
145 151
146```text theme={null}152```text wrap theme={null}
147dov'è il punto di ingresso principale?153dov'è il punto di ingresso principale?
148```154```
149 155
150```text theme={null}156```text wrap theme={null}
151spiega la struttura delle cartelle157spiega la struttura delle cartelle
152```158```
153 159
154Puoi anche chiedere a Claude informazioni sulle sue stesse capacità:160Puoi anche chiedere a Claude informazioni sulle sue stesse capacità:
155 161
156```text theme={null}162```text wrap theme={null}
157cosa può fare Claude Code?163cosa può fare Claude Code?
158```164```
159 165
160```text theme={null}166```text wrap theme={null}
161come creo skill personalizzate in Claude Code?167come creo skill personalizzate in Claude Code?
162```168```
163 169
164```text theme={null}170```text wrap theme={null}
165Claude Code può funzionare con Docker?171Claude Code può funzionare con Docker?
166```172```
167 173
175 181
176Ora facciamo in modo che Claude Code faccia un po' di codifica vera. Prova un'attività semplice:182Ora facciamo in modo che Claude Code faccia un po' di codifica vera. Prova un'attività semplice:
177 183
178```text theme={null}184```text wrap theme={null}
179aggiungi una funzione hello world al file principale185aggiungi una funzione hello world al file principale
180```186```
181 187
182Claude Code farà:188Claude Code trova il file appropriato e ti mostra la modifica. Se chiede prima di apportare la modifica, seleziona **Sì** per approvare.
183 189
1841. Trovare il file appropriato190La modalità Auto è la [modalità di autorizzazione iniziale integrata](/docs/it/permission-modes#eliminate-prompts-with-auto-mode) 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](/docs/it/env-vars#first-session-after-an-install-or-upgrade).
1852. Mostrarti le modifiche proposte
1863. Chiedere la tua approvazione
1874. Effettuare la modifica
188 191
189<Note>192<Note>
190 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.193 Le vostre impostazioni o la vostra organizzazione possono impostare una modalità di autorizzazione iniziale diversa. [Quale modalità di autorizzazione una sessione inizia](/docs/it/permission-modes#which-mode-a-session-starts-in) elenca cosa lo fa. Premete `Shift+Tab` in qualsiasi momento per cambiare la modalità di autorizzazione della sessione in cui vi trovate.
191</Note>194</Note>
192 195
193<h2 id="step-6-use-git-with-claude-code">196<h2 id="step-6-use-git-with-claude-code">
196 199
197Claude Code rende le operazioni Git conversazionali:200Claude Code rende le operazioni Git conversazionali:
198 201
199```text theme={null}202```text wrap theme={null}
200quali file ho modificato?203quali file ho modificato?
201```204```
202 205
203```text theme={null}206```text wrap theme={null}
204esegui il commit delle mie modifiche con un messaggio descrittivo207esegui il commit delle mie modifiche con un messaggio descrittivo
205```208```
206 209
207Puoi anche richiedere operazioni Git più complesse:210Puoi anche richiedere operazioni Git più complesse:
208 211
209```text theme={null}212```text wrap theme={null}
210crea un nuovo branch chiamato feature/quickstart213crea un nuovo branch chiamato feature/quickstart
211```214```
212 215
213```text theme={null}216```text wrap theme={null}
214mostrami gli ultimi 5 commit217mostrami gli ultimi 5 commit
215```218```
216 219
217```text theme={null}220```text wrap theme={null}
218aiutami a risolvere i conflitti di merge221aiutami a risolvere i conflitti di merge
219```222```
220 223
226 229
227Descrivi quello che vuoi in linguaggio naturale:230Descrivi quello che vuoi in linguaggio naturale:
228 231
229```text theme={null}232```text wrap theme={null}
230aggiungi la convalida dell'input al modulo di registrazione dell'utente233aggiungi la convalida dell'input al modulo di registrazione dell'utente
231```234```
232 235
233O correggi i problemi esistenti:236O correggi i problemi esistenti:
234 237
235```text theme={null}238```text wrap theme={null}
236c'è un bug in cui gli utenti possono inviare moduli vuoti - correggilo239c'è un bug in cui gli utenti possono inviare moduli vuoti - correggilo
237```240```
238 241
251 254
252**Refactoring del codice**255**Refactoring del codice**
253 256
254```text theme={null}257```text wrap theme={null}
255refactorizza il modulo di autenticazione per utilizzare async/await invece di callback258refactorizza il modulo di autenticazione per utilizzare async/await invece di callback
256```259```
257 260
258**Scrivi test**261**Scrivi test**
259 262
260```text theme={null}263```text wrap theme={null}
261scrivi unit test per le funzioni della calcolatrice264scrivi unit test per le funzioni della calcolatrice
262```265```
263 266
264**Aggiorna la documentazione**267**Aggiorna la documentazione**
265 268
266```text theme={null}269```text wrap theme={null}
267aggiorna il README con le istruzioni di installazione270aggiorna il README con le istruzioni di installazione
268```271```
269 272
270**Revisione del codice**273**Revisione del codice**
271 274
272```text theme={null}275```text wrap theme={null}
273rivedi le mie modifiche e suggerisci miglioramenti276rivedi le mie modifiche e suggerisci miglioramenti
274```277```
275 278
288| Comando | Cosa fa | Esempio |291| Comando | Cosa fa | Esempio |
289| ------------------- | -------------------------------------------------------------- | ----------------------------------- |292| ------------------- | -------------------------------------------------------------- | ----------------------------------- |
290| `claude` | Avvia la modalità interattiva | `claude` |293| `claude` | Avvia la modalità interattiva | `claude` |
291| `claude "task"` | Esegui un'attività una tantum | `claude "fix the build error"` |294| `claude "task"` | Avvia la modalità interattiva con un prompt iniziale | `claude "fix the build error"` |
292| `claude -p "query"` | Esegui una query una tantum, quindi esci | `claude -p "explain this function"` |295| `claude -p "query"` | Esegui una query una tantum, quindi esci | `claude -p "explain this function"` |
293| `claude -c` | Continua la conversazione più recente nella directory corrente | `claude -c` |296| `claude -c` | Continua la conversazione più recente nella directory corrente | `claude -c` |
294| `claude -r` | Riprendi una conversazione precedente | `claude -r` |297| `claude -r` | Riprendi una conversazione precedente | `claude -r` |
296**Comandi di sessione**299**Comandi di sessione**
297 300
298| Comando | Cosa fa | Esempio |301| Comando | Cosa fa | Esempio |
299| ---------------- | ------------------------------------------ | -------- |302| -------------------------- | ------------------------------------------ | -------- |
300| `/clear` | Cancella la cronologia della conversazione | `/clear` |303| `/clear` | Cancella la cronologia della conversazione | `/clear` |
301| `/help` | Mostra i comandi disponibili | `/help` |304| `/help` | Mostra i comandi disponibili | `/help` |
302| `/exit` o Ctrl+D | Esci da Claude Code | `/exit` |305| `/exit` o Ctrl+D due volte | Esci da Claude Code | `/exit` |
303 306
304Vedi il [riferimento CLI](/it/cli-reference) per l'elenco completo dei comandi shell e il [riferimento comandi](/it/commands) per l'elenco completo dei comandi di sessione.307Vedi il [riferimento CLI](/docs/it/cli-reference) per l'elenco completo dei comandi shell e il [riferimento comandi](/docs/it/commands) per l'elenco completo dei comandi di sessione.
305 308
306<h2 id="pro-tips-for-beginners">309<h2 id="pro-tips-for-beginners">
307 Suggerimenti professionali per i principianti310 Suggerimenti professionali per i principianti
308</h2>311</h2>
309 312
310Per ulteriori informazioni, vedi [best practices](/it/best-practices) e [flussi di lavoro comuni](/it/common-workflows).313Per ulteriori informazioni, vedi [best practices](/docs/it/best-practices) e [flussi di lavoro comuni](/docs/it/common-workflows).
311 314
312<AccordionGroup>315<AccordionGroup>
313 <Accordion title="Sii specifico con le tue richieste">316 <Accordion title="Sii specifico con le tue richieste">
319 <Accordion title="Usa istruzioni passo dopo passo">322 <Accordion title="Usa istruzioni passo dopo passo">
320 Suddividi i compiti complessi in passaggi:323 Suddividi i compiti complessi in passaggi:
321 324
322 ```text theme={null}325 ```text wrap theme={null}
323 1. crea una nuova tabella di database per i profili utente326 1. crea una nuova tabella di database per i profili utente
324 2. crea un endpoint API per ottenere e aggiornare i profili utente327 2. crea un endpoint API per ottenere e aggiornare i profili utente
325 3. costruisci una pagina web che consenta agli utenti di visualizzare e modificare le loro informazioni328 3. costruisci una pagina web che consenta agli utenti di visualizzare e modificare le loro informazioni
329 <Accordion title="Lascia che Claude esplori prima">332 <Accordion title="Lascia che Claude esplori prima">
330 Prima di apportare modifiche, lascia che Claude comprenda il tuo codice:333 Prima di apportare modifiche, lascia che Claude comprenda il tuo codice:
331 334
332 ```text theme={null}335 ```text wrap theme={null}
333 analizza lo schema del database336 analizza lo schema del database
334 ```337 ```
335 338
336 ```text theme={null}339 ```text wrap theme={null}
337 costruisci una dashboard che mostra i prodotti che vengono restituiti più frequentemente dai nostri clienti nel Regno Unito340 costruisci una dashboard che mostra i prodotti che vengono restituiti più frequentemente dai nostri clienti nel Regno Unito
338 ```341 ```
339 </Accordion>342 </Accordion>
340 343
341 <Accordion title="Risparmia tempo con le scorciatoie">344 <Accordion title="Risparmia tempo con le scorciatoie">
342 * Digita `/` per vedere tutti i comandi e le skills345 * Digita `/` per vedere tutti i comandi e le skills disponibili
343 * Usa Tab per il completamento dei comandi346 * Usa Tab per il completamento dei comandi
344 * Premi ↑ per la cronologia dei comandi347 * Premi ↑ per la cronologia dei comandi
345 * Premi `Shift+Tab` per ciclo tra le modalità di autorizzazione348 * Premi `Shift+Tab` per ciclo tra le modalità di autorizzazione
353Ora che hai imparato le nozioni di base, esplora funzionalità più avanzate:356Ora che hai imparato le nozioni di base, esplora funzionalità più avanzate:
354 357
355<CardGroup cols={2}>358<CardGroup cols={2}>
356 <Card title="Come funziona Claude Code" icon="microchip" href="/it/how-claude-code-works">359 <Card title="Come funziona Claude Code" icon="microchip" href="/docs/it/how-claude-code-works">
357 Comprendi il loop agentico, gli strumenti integrati e come Claude Code interagisce con il tuo progetto360 Comprendi il loop agentico, gli strumenti integrati e come Claude Code interagisce con il tuo progetto
358 </Card>361 </Card>
359 362
360 <Card title="Best practices" icon="star" href="/it/best-practices">363 <Card title="Best practices" icon="star" href="/docs/it/best-practices">
361 Ottieni risultati migliori con prompt efficaci e configurazione del progetto364 Ottieni risultati migliori con prompt efficaci e configurazione del progetto
362 </Card>365 </Card>
363 366
364 <Card title="Flussi di lavoro comuni" icon="graduation-cap" href="/it/common-workflows">367 <Card title="Flussi di lavoro comuni" icon="graduation-cap" href="/docs/it/common-workflows">
365 Guide passo dopo passo per attività comuni368 Guide passo dopo passo per attività comuni
366 </Card>369 </Card>
367 370
368 <Card title="Estendi Claude Code" icon="puzzle-piece" href="/it/features-overview">371 <Card title="Estendi Claude Code" icon="puzzle-piece" href="/docs/it/features-overview">
369 Personalizza con CLAUDE.md, skills, hooks, MCP e altro372 Personalizza con CLAUDE.md, skills, hooks, MCP e altro
370 </Card>373 </Card>
371</CardGroup>374</CardGroup>