Ecco la traduzione in italiano del testo fornito, seguendo tutte le linee guida specificate.
La maggior parte delle persone che usano Claude Code stanno trascurando l'unico file che l'AI legge sempre prima di iniziare qualsiasi attività.
Questo file si chiama "CLAUDE.md".
La documentazione ufficiale di Anthropic afferma chiaramente: se un file CLAUDE.md esiste nella cartella, Claude Code lo caricherà sempre prima di iniziare a lavorare, anche se non glielo chiedi.
In altre parole, ciò che scrivi qui cambia il comportamento iniziale dell'AI al 100%. Mentre devi riscrivere i prompt ogni volta, CLAUDE.md funziona in ogni conversazione una volta scritto.
La leva è su un livello completamente diverso.
Al contrario, a meno che tu non organizzi questo file, non importa quanto perfezioni i tuoi prompt, i benefici saranno quasi nulli. L'AI devierà ogni volta. Dovrai rispiegare le premesse ogni volta. Anche per lo stesso compito, la qualità varierà di giorno in giorno. La causa non è il modello o la tua abilità con i prompt, è questo file.
Oggi ti svelerò esattamente "cosa e come scrivere" in CLAUDE.md, inclusi esempi copia-incolla.
Per chi ha prestazioni scadenti, CLAUDE.md è solo un "promemoria"
Ad essere sincero, all'inizio ho faticato anche io.
Per un po' su X, c'erano molti articoli che dicevano "il contenuto delle cartelle è importante" o "CLAUDE.md è importante". Li ho visti e ho aperto le mie cartelle.
Il contenuto era un disastro.
Non sapevo cosa fosse dove. Dati simili erano sparsi ovunque. L'AI non riusciva a trovare la conoscenza di cui aveva bisogno, e ogni volta che generava un output, non era la risposta che volevo.
CLAUDE.md era uguale. Le regole su dove salvare cosa non erano definitive. Non capivo nemmeno cosa fosse CLAUDE.md in primo luogo. Quindi, continuavo ad aggiungere istruzioni dall'alto man mano che mi venivano in mente.
Di conseguenza, è cresciuto fino a 300 o 400 righe. Ha superato facilmente le 200 righe.
Si consiglia di mantenere CLAUDE.md al massimo 200 righe.
Un CLAUDE.md troppo lungo diventa un "testo lungo in cui l'AI non sa cosa sia importante."
In questo stato, l'AI rilegge l'intero file ogni volta e cerca di indovinare: "Allora, quale parte si applica a questo compito?" Quando si tratta di indovinare, l'incoerenza segue. Naturalmente.
CLAUDE.md non è un "blocco note". È una "mappa per il giudizio" a cui l'AI fa riferimento ogni volta. Cambiare la tua percezione di questo è metà della battaglia.
Scrivi solo queste 5 cose in CLAUDE.md
Non devi complicare le cose. Un centro di comando solido contiene invariabilmente questi cinque elementi:
- ① Regole di priorità: La dichiarazione principale da seguire prima di qualsiasi output
- ② Tabella di routing Parola Chiave → Posizione: Quali lavori vanno dove
- ③ Albero decisionale per le posizioni: Come giudicare gli elementi non nella tabella
- ④ Gestione delle attività: Come e dove registrare ciò che deve essere fatto
- ⑤ Gestione delle informazioni riservate: Tracciare il limite su ciò che non deve essere condiviso
Quando questi cinque sono a posto, l'AI smette di "indovinare" e inizia a "fare riferimento". La radice dell'incoerenza scompare.
Ora, vediamo come scrivere ciascuno con esempi reali.
Impostazione ① Dichiara le "Regole di priorità" all'inizio
La prima cosa da scrivere è una dichiarazione per fissare la mossa iniziale dell'AI. È un avvertimento: "Prima di pensare, segui prima le regole qui sotto."
▼ Esempio di scrittura
Priorità: Prima di produrre o salvare qualsiasi cosa, controlla sempre le regole qui sotto prima di agire. Le posizioni devono essere decise usando la "Tabella delle parole chiave" e l'"Albero decisionale" qui sotto. Se non riesci a decidere, non procedere da solo; fai una domanda.
Solo posizionando questo all'inizio, l'AI smette di "muovere semplicemente le mani". Inizia a controllare le regole ogni volta prima di agire. Questo fissa il punto di partenza.
Impostazione ② Includi una tabella di mappatura "Parola Chiave → Posizione"
La prossima cosa più efficace è una tabella di distribuzione del lavoro. Collega "se arriva questa richiesta, mettila qui/cerca qui" usando parole chiave.
▼ Esempio di scrittura
Parola Chiave → Posizione ・Blog/Articoli → Pubblicazione/Blog/ ・Spese/Ricevute → Contabilità/Giustificativi/ ・Verbali/Note Riunioni → Registri/Verbali/
Il trucco è scriverlo esattamente con le parole che usi normalmente. L'AI guarda le parole nella tabella e può scegliere la posizione senza esitazione.
Il suggerimento per l'asse di distribuzione è di tagliare per "funzione (compito)" piuttosto che per "business". In questo modo, anche se i business o i prodotti aumentano, la tabella non si romperà.
Impostazione ③ Includi un "Albero decisionale" per quando è perso ← Questo è il più efficace
Dei cinque, questo ha l'impatto maggiore. Come gestire le cose non nella tabella o le cose ambigue.
Sia gli umani che l'AI si fermano quando sono persi. Deviano perché sono persi. Quindi, elimina semplicemente lo spazio per l'esitazione. Lascia che seguano un percorso SÌ/NO dall'alto.
▼ Esempio di scrittura
Prima di salvare, segui questi passaggi in ordine: D1. Sono informazioni riservate (chiavi API/password)? → SÌ: Vai a .env. Fine. D2. Sono dati grezzi appena scaricati dall'esterno? → SÌ: Vai a Assets/. D3. Di che lavoro si tratta? → Vai a uno tra: Pubblicazione / Vendite / Contabilità / Registri. → Se alla fine non è possibile determinare una singola posizione, non procedere; fai esattamente 2 domande.
Quindi, come cambia il comportamento prima e dopo l'aggiunta di un albero decisionale? Nello specifico, in due modi.
Cambiamento 1: Esegue la stessa azione per la stessa richiesta ogni volta.
Claude Code opera sulla probabilità. Non ricorda la conversazione precedente quando la chat cambia. Quindi senza un albero decisionale, anche per la stessa richiesta di "salva il verbale", fluttua.
Senza un albero decisionale:
- 1ª volta → Salvato in Meeting/
- 2ª volta → Memo/Verbali/
- 3ª volta → Per qualche motivo, la cartella Assets
Con un albero decisionale:
- Ogni volta segue lo stesso percorso: D1→D2→D3 → Sempre lo stesso posto
Il comportamento cambia da "fluttuazione probabilistica" a una "procedura fissa". Riproducibilità significa che puoi costruirci sopra.
Cambiamento 2: Smette di commettere errori con eccessiva sicurezza quando è perso.
Il comportamento più spaventoso dell'AI è "essere sicura di sé ma sbagliata". Come gettare una registrazione video e i verbali che ne derivano nello stesso posto.
- Forzare il passaggio indovinando → ❌
- Fermarsi e controllare con 2 domande → ✓
L'ultima riga è sottilmente efficace. Solo scrivendo "Se non riesci a decidere, non avere fretta, chiedi", riduci strutturalmente la produzione in serie di risultati fuori bersaglio.
Più l'AI è intelligente, meglio si comporta quando le viene dato un "modello" piuttosto che la libertà totale.
Impostazione ④ e ⑤ Gestione delle attività e Riservatezza
I restanti due possono essere brevi. Ma devi scriverli.
④ Fissa "dove e come lasciare" le attività. Senza questo, le cose da fare si disperdono ad ogni conversazione.
▼ Esempio di scrittura
Gestione delle attività ・Consolida tutte le cose da fare in un unico file "tasks.md". ・Quando finite, non cancellare; sposta in "Completato" e lascia un risultato di 1 riga.
⑤ Scrivi chiaramente i confini per le informazioni riservate. Questa è la linea di salvataggio per la prevenzione degli incidenti.
▼ Esempio di scrittura
Informazioni riservate ・Scrivi chiavi API/password solo in .env. ・Non incollarle mai in chat, codice o registri.
Con questi due, le attività non si disperdono e le cose che non dovrebbero uscire rimangono dentro. Funzionano come i tuoi due scudi difensivi.
Mantieni CLAUDE.md "sotto le 200 righe". Se trabocca, spostalo in un altro file.
Alcuni di voi potrebbero aver capito che se scrivi tutto in CLAUDE.md, diventerà sempre più lungo.
È corretto. Questo è importante. Se rendi CLAUDE.md troppo lungo, in realtà diventa meno efficace. Poiché l'AI lo legge dall'inizio alla fine ogni volta, se è troppo lungo, il senso di "cosa è importante" si diluisce.
La linea guida è sotto le 200 righe.
Se non ci sta, sposta le regole dettagliate in un file separato (es. "regole_dettaglio.md"). Poi, all'inizio di CLAUDE.md, dai istruzioni su "quando leggerlo".
▼ Esempio di scrittura (Basta aggiungere una riga alla dichiarazione iniziale)
Priorità: Prima di produrre/salvare, segui sempre le regole qui sotto. Leggi "regole_dettaglio.md" solo quando scrivi un post per il blog.
Il trucco qui è aggiungere una condizione come "solo quando..." piuttosto che "leggi sempre". In questo modo, l'AI non aprirà quel file per attività non correlate, ma per le attività necessarie, andrà su "CLAUDE.md → regole_dettaglio.md".
Questo mantiene il corpo principale snello permettendoti comunque di aggiungere tutte le regole dettagliate che vuoi. Il punto è renderlo un sistema on-demand.
CLAUDE.md è l'"Ingresso e Comandante", e i dettagli sono "File separati su chiamata". Se ricordi questa divisione dei ruoli, le tue regole non crolleranno, non importa quanto aumentino.
Ad essere onesti, non diventerà una bestia diversa in un colpo solo
Sarò onesto qui.
Ho riorganizzato un caos di 300-400 righe in 5 blocchi. Dopodiché, la prima cosa che ho provato non è stato un "cambiamento drammatico".
Prima di tutto, ha semplicemente smesso di perdersi. Tutto qui.
Il mondo non cambia in un colpo solo. Entra in azione gradualmente. Restituisce lo stesso movimento per la stessa richiesta, i risultati fuori bersaglio diminuiscono e la conoscenza si accumula. Prima che tu te ne accorga, si muove come una bestia diversa. È così che funziona.
Se ti aspetti una magia appariscente, rimarrai deluso. Ma la riproducibilità si accumulerà sicuramente.
Riepilogo: Per chi pensa che fare tutto sia una seccatura
Non pensarci troppo. Quello che devi fare oggi è aprire il tuo CLAUDE.md (o crearne uno se non ce l'hai). Tutto qui.
Per chi trova una seccatura fare tutto, ecco l'elenco delle priorità con stime di tempo:
- Primi 5 minuti: Scrivi 3 domande per ③ Albero decisionale (Impatto maggiore)
- +7 minuti: Aggiungi ① Regole di priorità e ② Tabella di routing
- +3 minuti: Aggiungi ④ Attività e ⑤ Limiti di riservatezza
Totale 15 minuti. Questo li allineerà nell'ordine ①→②→③→④→⑤. Se sembra che supererà le 200 righe, sposta i dettagli in un file separato e fallo leggere dall'inizio. Tutto qui.
Non devi riempirlo eccessivamente. Organizzalo e basta. Solo con questo, lo stesso Claude Code che stavi usando ieri inizierà a muoversi come qualcosa di completamente diverso.
Le persone che vogliono migliorare le prestazioni di Claude Code cercano sempre tecniche di prompt. Ma la vera leva è più a monte. È il singolo file che l'AI legge per primo ogni volta.
La differenza tra il top 5% e il restante 95% non è talento o abilità con i prompt. È solo se hanno organizzato un file CLAUDE.md o lo hanno lasciato stare.
Inizia copiando e incollando le 3 domande dell'albero decisionale da questo articolo.
Finalmente
Finalmente, lasciami confessare una cosa.
Le slides che di solito pubblico sono tutte fatte dall'AI. Non ho più una singola slide fatta a mano.
E oggi, sto regalando l'AI che può realizzarle con la stessa identica qualità.
Se hai letto fin qui, probabilmente hai già capito. Tutto ciò di cui ho parlato in questo articolo si riduce a una cosa:
"Non far perdere l'AI."
L'AI non fallisce perché la sua capacità è bassa. Fallisce perché è persa.
Dalle un contesto. Progetta le istruzioni. Non lasciare spazio all'AI per chiedersi cosa fare. In altre parole, addestrala come una segretaria. In questo articolo, l'abbiamo fatto con Claude Code.
Quello che sto per distribuire è un ChatGPT GPTs. Solo per essere chiari: il testo principale parlava di Claude Code, e questo è un ChatGPT GPTs. Gli strumenti sono diversi.
Ma la radice è la stessa. Ciò che serve non è la tecnologia. È solo un design che non fa perdere l'AI.
Questo GPTs è un prodotto finito che spinge quella filosofia al limite nella singola area della "creazione di slides". Ho già finito tutto il lavoro di progettazione del contesto.
Lo garantisco. Tutto quello che devi fare è digitare il tema. Dopodiché, il GPTs meticolosamente progettato produrrà slides senza esitazione.
L'articolo che ha introdotto per primo questo GPTs ha registrato 400.000 impressioni. Ecco quante persone hanno reagito, dicendo "questo è diverso".
https://x.com/masaki_aihack/status/2068646555524223366
E per un periodo di tempo limitato, sto regalando un pacchetto di "20 bonus" incluso questo GPTs.
Il modo per riceverlo è semplice. Inizia unendoti alla chat LINE aperta qui sotto.
Sarò onesto: questo GPTs non è stato finito in un colpo solo. Ho fallito più di 50 volte. Ci è voluta una settimana per arrivare finalmente a un punto in cui "chiunque può usarlo". Sto regalando quel manuale così com'è.
Lascia che lo dica ancora una volta. Ciò che serve non è la tecnologia. È solo l'ingegno di non far perdere l'AI.
Perché non porre fine oggi alla stanchezza di creare slides?
