Ecco cosa succede al 99% degli utenti di Claude.
Si iscrivono. Apri la chat. Scrivono una domanda. Ricevono una risposta. Lo rifanno il giorno dopo. E il giorno ancora dopo.
Niente memoria. Niente contesto. Nessun sistema. Ricominciare da zero a ogni sessione.
Pagano 20 dollari al mese per un motore di ricerca con una grammatica migliore.
Nel frattempo, Boris Cherny, il creatore di Claude Code, lancia migliaia di agenti durante la notte dal suo telefono. I lead di ingegneria di Anthropic hanno detto a Dario Amodei che non scrivono più codice. Claude Cowork è stato costruito in una settimana e mezza da Claude stesso.
La differenza non è l'intelligenza. Non è l'accesso. Tu hai lo stesso modello che hanno loro.
La differenza è un file. Si chiama claude-md.
Cos'è davvero CLAUDE-MD
Un file di testo semplice nella root di qualsiasi cartella di progetto. Ogni volta che Claude Code apre quella cartella, legge prima questo file. Prima del tuo codice. Prima del tuo prompt. Prima di qualsiasi altra cosa.
Pensalo come un manuale di regole.
Scrivi le regole una volta sola. Claude le segue in ogni sessione, in ogni task, in ogni agente che avvii. Non dimentica. Non deraglia.
Senza claude-md, Claude è uno sconosciuto intelligente a cui rispieghi tutto ogni mattina.
Con claude-md, Claude è un impiegato che ha letto il manuale il primo giorno e non ha mai bisogno che gli venga ripetuto.
Perché questo cambia tutto
Molti pensano che il divario di competenze nell'IA sia il prompt engineering. Non lo è. I prompt sono conversazioni. Le conversazioni finiscono. Il contesto scompare.
claude-md è infrastruttura. Persiste. Si accumula.
Diciamo che sei un creatore di contenuti. Senza claude-md, ogni sessione inizia allo stesso modo: "Scrivimi un post sull'IA. Rendilo incisivo. Niente fronzoli." Lo scrivi ogni volta. A volte Claude ti dà roba aziendale perché ti sei dimenticato di dire "niente parole d'ordine".
Con claude-md, lo scrivi una volta:
Sei il mio stratega dei contenuti.
Il mio stile: diretto, specifico, zero fronzoli.
Paragrafi brevi. Affermazioni audaci supportate da numeri.
Non usare mai: leva, utilizzare, rivoluzionario, approfondimento.
Lunghezza predefinita: sotto le 250 parole, salvo diversa indicazione.
Quando dico "bozza", produci un pezzo completo, non uno schema.
Quando dico "modifica", taglia senza pietà.
Ogni sessione eredita automaticamente queste regole. Non ti ripeti mai. Claude non dimentica mai.
Questa è la differenza tra uno strumento e un sistema.
Come costruire il tuo CLAUDE-MD in 15 minuti
Non hai bisogno di Claude Code. Inizia con i Progetti Claude su claude.ai, stesso concetto con un nome diverso – Prompt di Sistema del Progetto.
Per la massima potenza, crea un file claude-md nella tua cartella di progetto con cinque sezioni:
Sezione 1 – Ruolo
Dì a Claude cosa deve essere. Non "assistente utile." Sii specifico.
Sei il mio analista di ricerca sugli investimenti.
Non sei un chatbot. Sei un operatore di flussi di lavoro.
Sezione 2 – Stile
Sii conciso. Niente preamboli. Punti elenco meglio dei paragrafi.
Numeri specifici meglio di affermazioni vaghe.
Sezione 3 – Vincoli
Non inventare mai dati.
Non riformattare mai file senza chiedere.
Non fare mai commit di codice senza aver eseguito i test.
Sezione 4 – Flusso di lavoro
Quando inserisco un file in raw/, elaboralo:
- 1. Leggilo
- 2. Identifica l'argomento
- 3. Scrivi un riepilogo con i punti chiave
- 4. Archivialo correttamente
- 5. Aggiorna l'indice
Sezione 5 – Qualità
Prima di fornire qualsiasi output:
- - Verifica che le affermazioni includano le fonti
- - Controlla che la formattazione corrisponda ai template
- - Rimuovi le frasi di riempimento
Cinque sezioni. Quindici minuti. Salva il file.
L'effetto cumulativo
Settimana 1: Claude smette di dare output generici. Ogni risposta corrisponde al tuo stile e ai tuoi vincoli.
Settimana 2: Aggiungi regole man mano che noti schemi. Il tuo claude-md passa da 10 a 40 righe.
Settimana 3: Diversi file claude-md per diversi progetti. Contenuti. Ricerca. Codice. Ognuno rende Claude uno specialista.
Settimana 4: Smetti di pensare a Claude come a un chatbot. Gli affidi compiti e te ne vai. L'output corrisponde ai tuoi standard perché gli standard sono nel manuale.
Ecco cosa ha capito Boris Cherny mesi fa. I suoi agenti non sono più intelligenti del tuo Claude. Hanno solo istruzioni migliori.
La gerarchia che molti fraintendono
La gente pensa: prompt migliori → risultati migliori
Il percorso reale: migliore configurazione del sistema → prompt migliori → risultati drasticamente migliori
claude-md è la configurazione del sistema. Senza di essa, stai ottimizzando i prompt su niente. Con essa, anche un prompt pigro produce buoni risultati perché le regole sono già in atto.
La configurazione richiede 15 minuti. L'effetto cumulativo è permanente.
Seguimi e iscriviti al mio canale Telegram:
