Obiettivo: In circa 15 minuti, aprirai Claude Code, effettuerai l'accesso e completerai il tuo primo cambiamento assistito dall'IA. Questa guida copre solo ciò di cui hai bisogno nel primo giorno; i link a materiale più approfondito si trovano alla fine.
Passaggio 1: Apri Claude Code (2 minuti)
Consigliato: Scarica Claude Desktop, accedi con il tuo piano a pagamento e apri la scheda "Code". Claude Desktop include Claude Code, quindi non c'è nient'altro da installare. Segui il desktop quickstart nella documentazione di Claude Code per la tua prima sessione, quindi passa al Passaggio 3.
Per utilizzare il terminale, scegli il comando che corrisponde al tuo computer e incollalo in un terminale.
La tua configurazione | Comando |
macOS / Linux / WSL | `curl -fsSL https://claude.ai/install.sh |
Windows (PowerShell) | |
Homebrew |
|
npm (Node 18+) |
|
Suggerimento: Non eseguire l'installazione npm con sudo, poiché ciò causa problemi di autorizzazione dei file in seguito.
Verifica l'installazione:
claude --version
Passaggio 2: Accedi (2 minuti)
Se stai utilizzando Claude Desktop, sei già connesso e Claude Code utilizza lo stesso account. Passa al Passaggio 3.
Nel terminale, il modo in cui ti autentichi dipende da come la tua organizzazione ha fornito l'accesso. Scegli uno dei seguenti:
Se la tua organizzazione utilizza… | Fai questo |
Un piano Claude a pagamento | Esegui |
Una chiave API della console Anthropic | Esegui |
Amazon Bedrock | Esegui |
Google Vertex AI | Esegui |
Se non sei sicuro di quale metodo si applica, verifica con il tuo amministratore o prova prima /login, che è l'impostazione predefinita per la maggior parte delle organizzazioni.
Passaggio 3: Apri un progetto (1 minuto)
In Claude Desktop, avvia una nuova sessione nella scheda "Code" e scegli la cartella per il repository su cui desideri lavorare. Nel terminale, avvia Claude Code dall'interno del repository:
cd path/to/your/project
claude
Claude Code legge i tuoi file su richiesta, quindi non c'è nulla da caricare o allegare.
Passaggio 4: Comprendi l'unica regola di sicurezza (1 minuto)
Claude chiederà sempre prima di modificare un file o eseguire un comando. Quando propone una modifica, vedrai un diff e tre scelte:
Sì — applica questa singola modifica.
Sì, e non chiedere più per le modifiche — approva automaticamente le modifiche ai file per il resto della sessione.
No — rifiuta la modifica e spiega perché.
Puoi premere Shift+Tab in qualsiasi momento per passare tra le modalità (Piano → Accetta modifiche → predefinito). Se una modifica produce un risultato inaspettato, la tua cronologia git rimane intatta fino a quando non esegui il commit, quindi git checkout la annullerà.
Passaggio 5: Cinque cose da provare per primo
Copia e incolla questi nel prompt uno alla volta. Ogni esempio dimostra una diversa capacità principale.
1. Orientati
Give me a 5-bullet summary of what this codebase does and where the entry point is.
Perché è utile: Mostra come Claude esplora i file da solo, senza essere indirizzato a percorsi specifici.
2. Trova qualcosa
Where is user authentication handled? Show me the file and the key function.
Perché è utile: È spesso più veloce di grep quando non conosci il simbolo o il nome file esatto.
3. Fai una modifica sicura
Add a docstring to the function <name> in <file>. Keep it to 2 lines.
Perché è utile: Ti permette di esercitarti a rivedere e approvare un diff su una modifica a basso rischio.
4. Correggi qualcosa di reale
This test is failing: <paste the error>. Find the cause and fix it.
Perché è utile: Questo è il flusso di lavoro principale: descrivi il sintomo e Claude indaga e propone una correzione.
5. Lascia che gestisca git
Stage my changes and write a commit message that follows our existing style.
Perché è utile: Claude può eseguire git per tuo conto (con approvazione) e corrisponderà alle convenzioni di commit esistenti del tuo repository.
Passaggio 6: Prima di finire per il giorno
Esegui questo una volta per progetto:
/init
Questo genera un file CLAUDE.md nella radice del tuo progetto che acquisisce le convenzioni del tuo codebase. Claude lo legge automaticamente all'inizio di ogni sessione, quindi le risposte future saranno già personalizzate per il tuo progetto. È il singolo passaggio di configurazione di più alto valore che puoi intraprendere.
Passaggi successivi
Hai ora aperto Claude Code, effettuato l'accesso, fatto una modifica e configurato la memoria del progetto. Quando sei pronto ad andare oltre, la documentazione ufficiale copre memoria e CLAUDE.md, comandi integrati e scorciatoie della modalità interattiva in profondità.
Se hai riscontrato problemi durante l'installazione o l'accesso, consulta la guida alla risoluzione dei problemi.
