Obiettivo: In circa 15 minuti, installerai Claude Code, effettuerai l'accesso e completerai il tuo primo cambiamento assistito dall'IA. Questa guida copre solo ciò che è necessario nel primo giorno; i link a materiale più approfondito si trovano alla fine.
Passaggio 1: Installa Claude Code (2 minuti)
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 permessi dei file in seguito.
Verifica l'installazione:
claude --version
Passaggio 2: Accedi (2 minuti)
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 |
Posti Claude Enterprise | 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)
cd path/to/your/project claude
Claude Code legge i tuoi file su richiesta, quindi non c'è nulla da caricare o allegare. Semplicemente avvialo dall'interno del repository su cui desideri lavorare.
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 Maiusc+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 installato Claude Code, autenticato, effettuato una modifica e configurato la memoria del progetto. Quando sei pronto ad andare oltre, la documentazione ufficiale copre memoria e CLAUDE.md, comandi slash e scorciatoie della modalità interattiva in profondità.
Se hai riscontrato problemi durante l'installazione o l'accesso, consulta la guida alla risoluzione dei problemi.