Claude Code: l'agente di programmazione nel terminale
Come installare e usare Claude Code: CLAUDE.md, modalità piano, permessi, sub-agenti, hook e i flussi di lavoro per sviluppare più in fretta e con più qualità.
Claude Code è l'agente di programmazione di Anthropic. Vive nel terminale (e in IDE e app desktop), legge il tuo progetto, modifica file, esegue comandi e test e lavora a obiettivi interi, non solo a righe di codice.
Installazione di base
Segui le istruzioni ufficiali di Anthropic per il tuo sistema. Poi, dentro la cartella del progetto:
cd mio-progetto
claudeAlla prima esecuzione accedi con il tuo account. Da quel momento descrivi i compiti in linguaggio naturale.
I concetti chiave
| Concetto | Cosa fa |
|---|---|
| CLAUDE.md | File con istruzioni permanenti sul progetto (comandi, convenzioni, architettura) |
| Modalità piano | Claude esplora e propone un piano senza modificare nulla finché non approvi |
| Permessi | Decidi cosa può fare da solo (leggere, modificare, eseguire comandi) |
| Sub-agenti | Assistenti specializzati per sotto-compiti (es. revisione, ricerca) |
| Hook | Comandi automatici al verificarsi di eventi (es. formattare dopo ogni modifica) |
| MCP | Collega strumenti esterni (database, issue tracker) |
| Skills / comandi | Procedure riutilizzabili richiamabili con /nome |
Il file CLAUDE.md
Mettilo nella radice del progetto: è la memoria che Claude legge a ogni sessione.
# Progetto Acme API
## Comandi
- Installa: npm install
- Test: npm test
- Lint: npm run lint
## Convenzioni
- TypeScript strict, niente `any`
- Ogni funzione pubblica ha un test
- Commit in italiano, stile convenzionale
## Architettura
- src/routes: endpoint HTTP
- src/services: logica di businessFlusso di lavoro che funziona
- Spiega l'obiettivo e il perché, non solo il cosa.
- Per modifiche non banali usa la modalità piano e rivedi il piano.
- Fai un compito per volta e committa spesso.
- Chiedi sempre di eseguire i test e correggere gli errori.
- Fai revisionare il diff a Claude stesso o a un sub-agente prima di unire.
Voglio aggiungere l'autenticazione con token JWT all'API. Prima esplora il codice esistente e proponi un piano in passi. Non modificare nulla finché non approvo. Indica file coinvolti, rischi e test da scrivere.Buone pratiche
- Verifica: dai a Claude modo di controllarsi (test, lint, build).
- Contesto pulito: usa
/cleartra compiti diversi. - Sicurezza: non concedere permessi larghi su cartelle sensibili; non incollare chiavi segrete.
- Revisione umana: leggi sempre ciò che entra nel codice.
Quando usarlo
Refactoring estesi, migrazioni, scrittura di test, debugging di errori complessi, esplorazione di codebase sconosciute, automazione di attività ripetitive di sviluppo.
Per l'approccio generale vedi vibe coding e Cursor.