In breve: Understand Anything è un plugin gratuito di Claude Code che legge un progetto e lo trasforma in una mappa su cui clicchi. Ogni file, funzione e classe diventa un punto della mappa, con le sue connessioni e una spiegazione in parole semplici. Serve quando entri in un progetto che non conosci e non sai da dove cominciare.
Questa è la pagina che ti ho promesso nel video. Il plugin originale è Egonex-AI/Understand-Anything su GitHub: al 31 ottobre 2026 ha oltre 89.000 stelle, che sono salvataggi di chi lo segue e non download. La licenza è MIT e l'ultima versione è la 2.9.0.
Cosa fa
Il README parte da una situazione che conosci: sei appena entrato in un team, il progetto ha 200.000 righe di codice, da dove si comincia? Il plugin la risolve con una catena di agenti. Uno scopre i file e riconosce linguaggi e strumenti, altri leggono funzioni, classi e dipendenze, un altro individua i livelli del progetto, un altro prepara dei percorsi guidati. Il risultato è una mappa, salvata come file dentro il progetto.
Poi la apri in una pagina web interattiva. I punti sono colorati per livello (interfaccia, servizi, dati e così via), li cerchi per nome o per significato, per esempio "quali parti gestiscono il login?", e cliccando su uno vedi il suo codice, i collegamenti con il resto e una spiegazione in linguaggio semplice.
Una parte del lavoro non dipende dal modello. Le connessioni tra i file vengono ricavate dal codice con un'analisi che dà sempre lo stesso risultato, mentre le spiegazioni le scrive il modello. Per questo le spiegazioni vanno lette come un aiuto e non come la verità: se una cosa conta, apri il codice e controlla.
A chi serve
A chi eredita un progetto scritto da altri, a chi entra in un team nuovo, e a chi deve capire un progetto generato da un agente AI senza avere scritto una riga. Serve anche a chi non sviluppa ma deve ragionare sul progetto, per esempio un responsabile di prodotto che vuole sapere quali parti ne risentono se cambia una funzione.
Non serve per un progetto piccolo che hai scritto tu e conosci a memoria. La mappa ripaga quando il progetto è abbastanza grande da non starti in testa.
Come si installa
Dentro Claude Code, due comandi:
/plugin marketplace add Egonex-AI/Understand-Anything
/plugin install understand-anything
Poi apri la cartella del progetto da capire e lancia l'analisi:
/understand
Il plugin scansiona il progetto e salva la mappa nel file .ua/knowledge-graph.json. Quando ha finito, apri la mappa:
/understand-dashboard
Si apre la pagina interattiva nel browser. Se usi un altro strumento al posto di Claude Code, il README spiega come installarlo su Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode e altri.
Le tre cose che ci fai
Clicchi sulla mappa. Scegli un punto e ottieni il codice, le relazioni con il resto del progetto e la spiegazione in parole semplici. Per un file o una funzione precisa puoi anche chiedere:
/understand-explain src/auth/login.ts
Fai domande al progetto. Il comando è /understand-chat, e l'esempio del README è questo:
/understand-chat How does the payment flow work?
In italiano sarebbe "come funziona il flusso di pagamento?": chiedi del progetto come chiederesti a un collega che lo conosce.
Controlli cosa tocca una modifica prima di farla. Il comando è:
/understand-diff
Il README lo descrive così: vedi quali parti del sistema sono toccate dalle tue modifiche prima di fare il commit. Ti evita le sorprese del tipo "ho cambiato una cosa qui e si è rotta una cosa là".
Per chi deve far entrare qualcuno in squadra c'è anche /understand-onboard, che prepara una guida per i nuovi arrivati.
Condividere la mappa con la squadra
La mappa è un file JSON. Se lo salvi nel repository insieme al codice (tutto quello che sta in .ua/ tranne le cartelle di lavoro intermediate/ e diff-overlay.json), i colleghi non devono rifare l'analisi. Per aprirla non servono Claude Code, né un modello, né una chiave: basta Node.js dalla versione 18 e un comando, che il README riporta così:
npx https://github.com/Egonex-AI/Understand-Anything/releases/latest/download/understand-anything-viewer.tgz /percorso/del/progetto
Per tenere la mappa aggiornata a ogni commit esiste l'opzione /understand --auto-update, che aggiorna la mappa in automatico dopo ogni commit, con un hook di git.
Quanto costa
Il plugin è gratis, con licenza MIT. Il costo vero è l'uso del modello che costruisce la mappa. Il README avvisa che la prima analisi legge tutto il progetto e su un progetto grande può consumare molti token: consiglia di farla con un abbonamento o con un modello in locale, per esempio tramite Ollama. Le analisi dopo la prima sono incrementali, rileggono solo i file cambiati e costano molto meno. Per i progetti enormi puoi limitare il lavoro a una cartella:
/understand src/frontend
I limiti, senza giri di parole
La prima analisi di un progetto grande consuma parecchio, e il README non indica quanto tempo ci mette: non aspettarti una mappa in un minuto. Le spiegazioni escono in inglese di default. Con l'opzione --language puoi scegliere un'altra lingua, ma l'elenco nel README comprende inglese, cinese, giapponese, coreano, russo e vietnamita, e non l'italiano. Al primo avvio, se scrivi a Claude in una lingua diversa dall'inglese, il plugin ti chiede in che lingua generare le spiegazioni: prova e verifica il risultato.
Il resto lo sa chi usa un agente da un po': la mappa è costruita da un modello, quindi può sbagliare, e ti aiuta a orientarti, non a fidarti. Per vedere la mappa all'opera senza installare niente c'è la demo interattiva sul sito del progetto.
Prima di installare un plugin conviene controllare cosa contiene, e come farlo l'ho scritto in controllare una skill di Claude Code prima di installarla. Se cerchi altri plugin, ci sono i tre plugin ufficiali di Anthropic.
Vai a Understand Anything su GitHub →
Domande frequenti
Understand Anything è gratis?
Il plugin sì: ha licenza MIT e il README non parla di piani a pagamento. Ma la mappa la costruisce il modello che usi, quindi la prima analisi di un progetto grande consuma parecchio del tuo abbonamento a Claude o della tua chiave API. Il README consiglia di lanciarla con un abbonamento o con un modello in locale.
Quanto consuma Understand Anything?
Dipende dalla dimensione del progetto. La prima analisi legge tutto il progetto e secondo il README può consumare molto sui progetti grandi. Le analisi successive sono incrementali: rileggono solo i file cambiati e costano molto meno. Per i progetti enormi puoi limitare l'analisi a una cartella, per esempio con /understand src/frontend.
Understand Anything funziona solo con Claude Code?
No. È nato come plugin di Claude Code, ma il README elenca anche Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode e altri. Con Claude Code si installa con due comandi, per gli altri il README indica il metodo di ciascuno. Su Codex i comandi iniziano con il simbolo del dollaro invece della barra.
Posso vedere come funziona senza installare niente?
Sì. Sul sito del progetto c'è una demo interattiva che si apre nel browser senza account: puoi spostare la mappa, ingrandirla, cercare e cliccare sui punti. È la strada più veloce per capire se ti serve prima di installare il plugin.