Il maggiordomo che dimentica ogni mattina
Nella nostra puntata precedente, abbiamo discusso l’equilibrio tra delega e conferma. Oggi desidero presentarle un modo ancora più comodo di lavorare con il suo maggiordomo — impartire le regole di casa a Claude Code attraverso CLAUDE.md.
Mi permetta di dipingere un quadro.
Immagini di dover spiegare ogni mattina al suo nuovo maggiordomo: “In questa dimora rispondiamo sempre in italiano”, “Non deve mai effettuare un commit senza la mia approvazione”, “Qui usiamo bun, non npm — è così che si fanno le cose in questa casa.”
Piuttosto inefficiente, non le sembra?
Che cos’è CLAUDE.md?
CLAUDE.md è un file markdown collocato nella directory radice del suo progetto. Ogni volta che Claude Code avvia una nuova sessione, legge questo file automaticamente.
In altre parole, lo scriva una volta, e il suo maggiordomo seguirà quelle istruzioni naturalmente — senza bisogno di essere ricordato ogni volta.
Lo pensi come una pergamena delle regole di casa, custodita permanentemente negli alloggi del maggiordomo.
CLAUDE.md funziona su tre livelli
In realtà, non è necessario limitarsi a un unico CLAUDE.md per progetto. La portata delle sue istruzioni varia a seconda del punto in cui il file viene collocato.
| Posizione | Percorso | Portata |
|---|---|---|
| Globale | ~/.claude/CLAUDE.md | Tutti i progetti |
| Progetto | {root del progetto}/CLAUDE.md | Solo quel progetto |
| Sottodirectory | {qualsiasi directory}/CLAUDE.md | Quella directory e le sue sottodirectory |
All’inizio di ogni sessione, tutti i file applicabili vengono letti e uniti insieme.
La mia raccomandazione per distinguere il loro utilizzo: nel CLAUDE.md globale inserisca le preferenze universali — “rispondere sempre in italiano”, “non fare mai commit senza approvazione”. Riservi al CLAUDE.md del progetto le regole specifiche — “usare bun in questo progetto”, “fare deploy su Firebase”. In questo modo, le sue aspettative fondamentali vengono rispettate in ogni progetto, e le istruzioni particolari di ciascuno vengono anch’esse riflesse.
Un esempio di regole di casa: il contenuto di CLAUDE.md
Ogni dimora ha le proprie consuetudini. Ecco alcuni esempi per ispirarsi:
# Regole del Progetto
## Lingua e Comunicazione
- Rispondere sempre in italiano
- I termini tecnici possono restare in inglese, ma le spiegazioni devono essere in italiano
## Codice e Sviluppo
- Utilizzare bun come gestore di pacchetti (mai npm)
- Ottenere sempre l'approvazione del padrone prima di eseguire un commit
- Non modificare il codice senza prima scrivere i test
## Azioni Vietate
- Non eseguire mai il deploy in produzione in modo unilaterale
- Confermare sempre prima di eliminare qualsiasi file
- Non aggiungere dipendenze a package.json senza approvazione
## Stile
- Commenti del codice in italiano
- Nomi di funzioni e variabili in camelCase inglese
Una volta scritto questo, ogni volta che Sebastiano apre il suo progetto, queste regole sono impresse nella sua memoria prima che inizi qualsiasi lavoro.
Perché questo è così potente
Claude Code è un maggiordomo di grande capacità. Tuttavia, i ricordi delle conversazioni passate non si trasferiscono alle nuove sessioni.
Anche se ieri gli ha indicato di “usare bun”, il giorno dopo non ne avrà alcun ricordo. Ripetere le stesse istruzioni ad ogni sessione è inefficiente sia per il padrone che per il maggiordomo.
CLAUDE.md risolve questo problema alla radice.
Particolarmente prezioso per i padroni che usano Claush su mobile
Per coloro che impiegano il loro maggiordomo tramite l’app Claush su smartphone, CLAUDE.md è particolarmente prezioso.
Digitare lo stesso lungo preambolo su uno schermo piccolo, sessione dopo sessione, è un onere considerevole. Con CLAUDE.md in atto, è sufficiente comunicare la questione del momento.
“Sebastiano, per favore corregga il bug nella schermata di accesso.”
È tutto. Il suo maggiordomo saprà utilizzare bun, rispondere in italiano, chiedere conferma prima di fare commit, scrivere i test e procedere di conseguenza.
Come configurarlo
L’installazione è di una semplicità elegante.
- Crei un file chiamato
CLAUDE.mdnella directory radice del suo progetto - Scriva le regole della sua casa al suo interno
- È tutto
my-project/
├── CLAUDE.md ← Le regole di casa vanno qui
├── src/
├── package.json
└── ...
Dalla sessione successiva, Claude Code leggerà questo file automaticamente e si comporterà secondo le sue regole stabilite.
Le regole di casa sono destinate a crescere
Non è necessario scrivere regole perfette fin dall’inizio.
Man mano che lavora con il suo maggiordomo, ogni volta che si ritrova a ripetere la stessa cosa, la aggiunga semplicemente a CLAUDE.md — un’istruzione alla volta. Questo è ciò che significa veramente “coltivare” un maggiordomo.
La comprensione silenziosa tra padrone e maggiordomo si costruisce attraverso questa attenta accumulazione.
Il riassunto del suo maggiordomo
- CLAUDE.md è il file delle “regole di casa”, collocato nella radice del progetto
- Il suo maggiordomo segue queste istruzioni automaticamente — nessun promemoria necessario
- Particolarmente efficace per gli utenti mobili — basta enunciare la questione
- Inizi in modo semplice e lasci che le regole crescano nel tempo
Caro padrone, la prego umilmente di impartire le regole di casa al suo maggiordomo. Una volta in atto, sarò in grado di rispondere alle sue aspettative prima ancora che venga pronunciata una singola parola.
Nella nostra prossima puntata, parleremo di “la gestione della cronologia e del contesto.”
Trovi il suo maggiordomo sul suo iPhone sul Sito Ufficiale di Claush.