接手老项目时，20 万行代码库、层层嵌套的文件夹、过期的文档，是开发者的共同痛点。AI 编程助手同样面临这个问题：Claude Code、Cursor、Codex 接到任务后先调用 ls、grep、read 反复扫描文件，还没开始干活就已经消耗大量 Token。
Understand-Anything 项目在 GitHub 一周新增 26,685 颗星，直接霸榜。它的核心功能是将整个代码库转换为可交互的知识图谱，让 AI 和开发者都能快速理解项目结构。
核心功能
Understand-Anything 不是传统的架构图绘制工具，而是可交互、可搜索、可对话的动态图谱。每个文件、函数、类都是图谱上的节点，点击即可查看其在项目中的角色和依赖关系。
项目的定位很明确：不是用复杂的图谱炫技，而是帮助用户理解代码各部分如何组合在一起。
场景一：新人入职看代码
刚进入新团队，面对庞大的代码库，传统方式是看 README（可能已过期）、问同事（可能记不清）、自己 grep 瞎翻。
使用 Understand-Anything，执行一条命令：
/understand --language zh多智能体流水线自动扫描整个项目，提取文件、函数、类的依赖关系，生成知识图谱。随后打开仪表盘：
/understand-dashboard浏览器弹出交互式界面，整个代码库的架构一览无余。
工具还会自动生成引导式导览——按依赖关系排序，提示先看什么、再看什么，无需自己猜测学习顺序。
场景二：给 AI 编程助手省 Token
这是最实用的场景。使用 Claude Code 或 Cursor 时，每次让 AI 改功能，它先得 ls、grep、read 一通扫描。代码库越大，消耗的 Token 越多，有时光扫描就花掉一半 Token 预算。
Understand-Anything 在 Claude Code、Cursor 中作为插件运行，知识图谱已建好，AI 直接读图谱，Token 消耗可削减一半以上。
支持的平台包括：
- Claude Code（原生插件）
- Cursor（自动发现）
- VS Code + Copilot
- Codex、Gemini CLI、OpenClaw 等
100% 本地运行，代码不出本机，企业项目也可放心使用。
场景三：改代码前看影响范围
修改底层函数导致多个模块崩溃是常见问题。使用 Understand-Anything：
/understand-diff工具会提示这次改动会影响哪些模块、哪些调用链，提交前查看可避免不少问题。
场景四：了解业务逻辑
Understand-Anything 提供领域视图（Domain View），将代码映射到真实业务流程上——领域、流程、步骤用水平图谱展示，产品经理和初级开发都能看懂。
工具还支持角色自适应 UI：初级开发者、产品经理、高级工程师看到的细节层级不同。
场景五：找代码
想查找某个功能但不知道函数名时，可直接提问：
/understand-chat 哪些部分处理了用户认证？基于知识图谱回答，无需记忆精确函数名。也可在仪表盘内模糊搜索，按名称或语义查询。
安装方式
三种方式，选择适合的即可。
Claude Code（推荐）
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything安装完成后重启 Claude Code。
一键脚本
macOS / Linux：
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bashWindows（PowerShell）：
iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex支持 gemini、codex、opencode、vscode、cline 等十几个平台。
Cursor（最省事）
Cursor 克隆仓库时会自动发现插件，直接在 Cursor 中打开即可。如自动发现未生效，打开 Cursor Settings → Plugins，粘贴 https://github.com/Lum1104/Understand-Anything 添加。
核心命令
安装完成后，几个核心命令：
- /understand：分析代码库，生成知识图谱到 .understand-anything/knowledge-graph.json。后续默认只更新改过的文件（增量更新）
- /understand-dashboard：打开交互式 Web 界面，按架构层级颜色编码，可搜索可点击
- /understand-chat：基于图谱提问，比直接问 Claude Code 更快更准
- /understand-diff：分析改动影响范围，提交前查看
- /understand-onboard：为新同事生成入职指南
- /understand-explain：深入解释某个文件
- /understand-domain：提取业务领域知识
亮点特性
中文支持：添加 --language zh 参数后，图谱描述、UI 标签、导览解释全部中文，国内开发者无需阅读英文文档。
团队共享：图谱本质是 JSON 文件，提交到 git 后，团队成员 clone 代码库即可直接使用 /understand-dashboard，无需每人从头扫描。
增量更新：修改文件后再次运行 /understand 只会重新分析改动部分，无需全量扫描，大型代码库也可流畅运行。
多平台支持：Claude Code、Cursor、VS Code、Codex、Gemini CLI、n8n 等十几个平台均可安装。
总结
Understand-Anything 解决了代码理解的痛点。特别是为 AI 编程助手节省 Token 方面，日常使用 Claude Code 或 Cursor 的开发者装上后能明显感受到响应速度提升——毕竟无需每次从头扫描文件。
新人入职场景同样刚需。理解代码结构的时间可从一周缩短至两天。