Claude Code /insights: capire il tuo workflow

Che cosa fa /insights

/insights è un comando integrato di Claude Code. La reference ufficiale lo descrive come un report che analizza le sessioni Claude Code, includendo aree di progetto, pattern di interazione e punti di attrito. In pratica aiuta a guardare il tuo uso dell'agente da fuori, invece di giudicarlo solo dall'ultima sessione riuscita o fallita.

• Mostra su quali aree di progetto lavori più spesso.
• Evidenzia pattern di interazione: task chiusi, sessioni lunghe, richieste interrotte o ripetute.
• Aiuta a capire quali strumenti, skill, comandi o MCP usi davvero.
• Può suggerire miglioramenti a CLAUDE.md, skill, hook o abitudini di prompt.

Quando vale la pena lanciarlo

Usalo quando Claude Code è già parte del tuo lavoro quotidiano. Se lo apri una volta al mese, il report avrà poco da dire. Se invece lo usi per refactor, debug, contenuti, review o automazioni, /insights può mostrarti dove l'agente ti sta aiutando e dove stai creando attrito senza accorgertene.

• Dopo una settimana intensa di lavoro con Claude Code.
• Prima di ripulire CLAUDE.md o creare nuove skill.
• Quando hai la sensazione di spendere troppi token per arrivare al risultato.
• Quando vuoi capire se i tuoi MCP, hook o comandi custom vengono usati davvero.

Come leggere il report senza farsi distrarre

Il rischio è trattare /insights come una pagina di statistiche. Il report diventa utile solo se lo leggi come una retrospettiva operativa: quali passaggi si ripetono, quali task si bloccano, quali istruzioni mancano e quali comportamenti dell'agente vuoi rendere più prevedibili.

• Cerca attriti ripetuti, non episodi isolati.
• Se un problema torna spesso, trasformalo in istruzione, skill, script o verifica.
• Se un tool compare poco, chiediti se è inutile o solo descritto male.
• Se molte sessioni si fermano prima della fine, migliora la definizione di done.

Cosa cambiare dopo /insights

La parte più importante arriva dopo il report. Un buon esito non è avere più dati su come lavori: è ridurre i punti in cui Claude deve indovinare. Puoi aggiornare istruzioni di progetto, creare skill mirate, migliorare prompt ricorrenti, limitare tool inutili o rendere più chiari i comandi di verifica.

• CLAUDE.md: regole sempre valide, comandi standard e vincoli del progetto.
• Skill: procedure ripetute che non devono occupare ogni sessione.
• Hook: controlli meccanici da eseguire in momenti precisi.
• MCP: integrazioni utili solo se il trigger e il risultato sono chiari.
• /goal: task lunghi con criteri di completamento espliciti.

Differenza con /goal, /usage e /status

/insights non sostituisce gli altri comandi. /goal serve a far lavorare Claude verso un obiettivo nella sessione corrente. /usage mostra costi, limiti e attività. /status mostra lo stato della sessione, versione, modello, account e connettività. /insights è diverso: guarda al modo in cui usi Claude Code nel tempo e ti aiuta a migliorare il sistema di lavoro.

• /goal: guida l'agente verso un risultato verificabile.
• /usage: controlla consumo, limiti e statistiche di attività.
• /status: controlla configurazione, stato operativo e dettagli della sessione.
• /insights: trova pattern e attriti nel tuo modo di usare l'agente.

E in Codex?

Nelle reference ufficiali di Codex app e CLI non c'è un comando documentato che faccia lo stesso lavoro di /insights. Codex ha però pezzi utili per costruire una retrospettiva simile: thread search, /status, /usage, memories, AGENTS.md, skill e review periodiche delle sessioni o dei branch prodotti.

• Usa /status e /usage per stato operativo, contesto, limiti e consumo.
• Usa memories solo come supporto locale, non come fonte obbligatoria di regole di team.
• Metti le regole stabili in AGENTS.md, non nei ricordi o nella chat.
• Trasforma procedure ripetute in skill di repository quando devono valere per più persone.

La regola pratica

Lancia /insights quando vuoi migliorare il modo in cui collabori con Claude Code, non quando vuoi risolvere un singolo problema. Se il report ti dà una lista di suggerimenti, non applicarli tutti. Parti da uno: il punto che torna più spesso, costa più tempo o produce più errori. Poi verifica se il lavoro diventa più breve e più prevedibile.

• Un insight utile deve diventare una modifica concreta al workflow.
• Se non sai cosa cambiare, parti da prompt iniziali e definizione di done.
• Se lavori in team, porta le regole condivise in documentazione o skill versionate.

Domande frequenti