一句话定位两者都把代码库转成知识图谱、并集成进 AI Coding AgentClaude Code / Cursor / Codex / Gemini CLI 等但设计哲学截然不同CodeGraph “给 Agent 用的确定性索引”——快、省、准、零 token 成本让 AI 更高效地改代码。Understand-Anything “给人看的可教学图谱”——可视化、语义丰富、有业务视角让人和 AI 一起理解代码。关键认知Graphs that work vs Graphs that teachCodeGraph README 的哲学是“fewer tokens, fewer tool calls, 100% local”——图谱是给 Agent 用的工具核心是减少 grep/Read 调用、给外科手术式上下文。Understand-Anything README 标语是“Graphs that teach graphs that impress”——图谱是给人看的核心是quietly teaches you how every piece fits together目标是 onboarding、项目理解、可视化。二、仓库元数据对比2026-07-08维度CodeGraphUnderstand-Anything仓库colbymchenry/codegraphEgonex-AI/Understand-Anything原Lum1104Stars58.5k71.9kForks3.6k6k最新版本v1.3.026 个 releasev2.7.37 个 release最近提交2026-07-0713 小时前2026-07-08今天Contributors4748主语言TypeScript 93% / JS 4.5% / Shell 1.8%TypeScript 71% / JS 16% / Python 9% / Astro 2.4%许可证MITMIT原作者colbymchenryYuxiang Lin (Lum1104)现归 Egonex三、技术架构对比本质差异这是两者最关键的区别所在。CodeGraph —— 纯确定性、100% 本地、零 LLM提取方式tree-sitter 解析 AST → 语言专属查询提取节点函数/类/方法和边calls/imports/extends/implements→ 存入本地 SQLite.codegraph/codegraph.db FTS5 全文搜索存储SQLite 单文件纯本地无 API key无外部服务同步文件 watcher 用原生 OS 事件FSEvents/inotify/ReadDirectoryChangesW2 秒 debounce 增量同步零配置自动保持新鲜跨语言桥接手工实现的启发式规则——Swift↔ObjCobjc桥接、React Native legacy bridge / TurboModules / Fabric、Expo Modules DSL跨语言边打provenance:heuristic标记Agent 能看出这条边怎么来的可复现相同输入 → 相同输出每次都一样Understand-Anything —— Tree-sitter LLM 混合提取方式tree-sitter 做确定性结构提取imports/exports/函数类定义/调用点/继承LLM 做语义提取自然语言摘要、标签、架构层归属、业务域映射、导览、语言概念存储JSON 文件.understand-anything/knowledge-graph.json可 commit 到仓库共享大文件10MB建议 git-lfs多 Agent Pipeline6-7 个专门 Agent 协作project-scanner发现文件/语言/框架file-analyzer提取函数/类/导入并行5 并发20-30 文件/批architecture-analyzer识别架构层tour-builder生成学习导览graph-reviewer校验图完整性默认内联--review走完整 LLM 审查domain-analyzer提取业务域/流程/步骤article-analyzer分析 wiki 知识库同步默认增量只重分析改动文件--auto-update走 post-commit hook 在每次提交时打补丁可复现性结构边可复现语义部分依赖 LLM不可完全复现架构对比表维度CodeGraphUnderstand-Anything结构提取tree-sittertree-sitter语义提取❌ 无✅ LLM存储SQLite FTS5JSON 文件运行时依赖自包含二进制bundled runtime无需 Node需 Node 22 / pnpm 10需 LLM同步机制文件 watcher 原生 OS 事件实时增量默认增量重跑--auto-updatepost-commit hook可复现完全可复现结构可复现语义不可跨语言桥接手工启发式Swift↔ObjC、RN bridge、Expo依赖 tree-sitter 通用能力四、给 Agent 的集成方式对比维度CodeGraphUnderstand-Anything集成形态MCP ServerCLI 自带运行时无需 NodeClaude Code 插件 slash commands暴露给 Agent 的工具默认只暴露1 个codegraph_explore一个强工具优于一堆窄工具的设计哲学其他 7 个node/search/callers/callees/impact/files/status默认隐藏用CODEGRAPH_MCP_TOOLS环境变量启用slash commands/understand、/understand-dashboard、/understand-chat、/understand-diff、/understand-explain、/understand-onboard、/understand-domain、/understand-knowledgeAgent 能否直接调✅ 是MCP 工具直接调Agent 无需 prompt 触发❌ 否依赖 slash command 显式触发或人对话引导安装方式curl ... install.sh或npx colbymchenry/codegraphcodegraph install自动配置各 Agent 的 MCPcodegraph init建图Claude Code/plugin marketplace add Egonex-AI/Understand-Anything/plugin install understand-anything其他平台install.sh platform支持的 AgentClaude Code / Cursor / Codex CLI / opencode / Hermes / Gemini CLI / Antigravity / Kiro8 个Claude Code / Cursor / VS Code Copilot / Copilot CLI / Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi / Vibe / Hermes / Cline / KIMI / Trae / Nanobot / Kiro17 个更多五、功能能力对比能力CodeGraphUnderstand-Anything符号级精准上下文入口点 相关符号 源码✅ 强项codegraph_explore一次调用返回✅ 通过/understand-chat问答调用路径追踪含动态分派回调、React re-render、接口→实现✅ 强项codegraph_trace跨动态分派跳⚠️ 依赖 LLM 推理非确定性影响面分析blast radius✅codegraph_impact/affected可接git diff --name-only | codegraph affected --stdin✅/understand-diff交互式可视化 Dashboard❌ 无纯 Agent 工具✅核心卖点可缩放/搜索/点击的 web dashboard按架构层着色支持 persona 自适应初级/PM/高级用户业务域映射domains/flows/steps❌ 无✅/understand-domain新人 onboarding 导览❌ 无✅/understand-onboard自动生成依赖顺序的学习导览知识库/wiki 分析❌ 无✅/understand-knowledge分析 Karpathy-pattern LLM wiki语言概念讲解泛型/闭包/装饰器等 12 种❌ 无✅ 在上下文中讲解多语言支持✅20 语言全覆盖TS/JS/ArkTS/Python/Go/Rust/Java/C#/VB.NET/PHP/Ruby/C/C/CUDA/ObjC/Metal/Swift/Kotlin/Scala/Dart/Lua/Luau/R/Nix/Erlang/CFML/COBOL/Solidity/Terraform/Svelte/Vue/Astro/Liquid/Pascal⚠️ README 未明确列语言清单依赖 tree-sitter 通用能力框架路由识别✅ 17 个框架Django/Flask/FastAPI/Express/NestJS/Laravel/Drupal/Rails/Spring/Play/Gin/chi/Axum/ASP.NET/Vapor/React Router/SvelteKit/Vue Router/Astro❌ 未提及全文搜索✅ FTS5✅ 模糊 语义搜索团队共享图谱⚠️ 可共享.codegraph/但通常不入库✅ 设计为 commit 到仓库共享推荐 git-lfs图谱可读性❌ 给机器读的 SQLite✅ JSON web dashboard给人读六、成本与隐私对比维度CodeGraphUnderstand-AnythingToken 消耗零纯本地 tree-sitter SQLite无 LLM 调用高首次/understand全量分析消耗大量 tokenREADME 明确建议跑在 token 订阅或本地模型上外部依赖无自包含二进制bundled runtime需要 LLM可用 Ollama 本地模型降本隐私✅ 100% 本地无数据离开机器⚠️ 语义部分代码会发到 LLM本地模型可规避遥测有匿名遥测可codegraph telemetry off关闭未明确提及适合的代码库规模小到超大通用benchmark 在 110 文件到 10k 文件都测过官方明确更适合大型代码库/Monorepo/企业项目小项目 LLM 成本不划算七、CodeGraph Benchmark 证据CodeGraph README 给出了严格的 benchmark7 个真实开源代码库每 arm 4 次取中位数2026-06-02 在 Opus 4.8 上重新验证代码库语言/规模工具调用速度文件读取Token成本VS CodeTS · ~10k 文件-81%11%0 vs 9-64%-18%ExcalidrawTS · ~640-40%27%0 vs 7-25%evenDjangoPython · ~3k-77%13%0 vs 9-60%-8%TokioRust · ~790-57%18%0 vs 8-38%evenOkHttpJava · ~645-50%31%0 vs 4-54%-25%GinGo · ~110-44%24%1 vs 6-23%-19%AlamofireSwift · ~110-58%33%0 vs 9-64%-40%通用结论每个代码库、每个规模都赢——工具调用减少 40-81%速度提升 11-33%文件读取降到接近 0。Understand-Anything 未在 README 给出量化 benchmark更侧重定性卖点教学、onboarding、可视化。八、适用场景建议选 CodeGraph 当你要让 AI Agent 在写代码/改代码时自动、频繁用图谱减少 grep/Read 调用在意确定性、可复现、零 token 成本项目跨多语言、多框架需要框架路由识别团队不想维护 LLM 调用成本选 Understand-Anything 当你要给人新人/PM/非工程师可视化探索代码库需要业务域映射、onboarding 导览、知识库分析这些理解层能力接受 LLM token 成本或愿意配本地模型Ollama想把图谱 commit 到仓库做 docs-as-code、PR review 辅助团队有预算跑 token 订阅两者并非互斥CodeGraph 擅长日常 Agent 工作流的精准上下文Understand-Anything 擅长项目理解 / onboarding / 可视化痛点是Agent 老在 grep 浪费 token → 用 CodeGraph痛点是新人看不懂这个 20 万行项目 → 用 Understand-Anything九、几个坑Understand-Anything 首次/understand烧 token全量分析整个代码库大项目消耗显著README 自己都建议跑在订阅或本地模型上。后续增量才省钱。CodeGraph 的一个工具哲学默认只暴露codegraph_explore想用codegraph_callers/impact等要手动开CODEGRAPH_MCP_TOOLS环境变量——有些 Agent 教程没提这个会以为只有 explore。Understand-Anything 仓库重定向原作者Lum1104已迁到Egonex-AI组织老教程里的 clone 地址会自动重定向但 issue/PR 要去新地址。CodeGraph 跨语言桥接是启发式Swift↔ObjC、RN bridge 等边打provenance:heuristic标记不是 100% 精确Agent 能看到但不该盲信。Understand-Anything 语义部分不可复现依赖 LLM同一段代码两次分析可能出不同摘要——做 CI 校验时只信结构边别拿语义摘要做断言。两者都支持 Claude Code但集成形态不同CodeGraph 走 MCP serverAgent 自动调Understand-Anything 走插件 slash command人显式触发——别混用安装方式。十、官方链接清单CodeGraph仓库https://github.com/colbymchenry/codegraph官网https://colbymchenry.github.io/codegraph/安装curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | shnpmnpx colbymchenry/codegraphUnderstand-Anything仓库https://github.com/Egonex-AI/Understand-AnythingClaude Code 安装/plugin marketplace add Egonex-AI/Understand-Anything→/plugin install understand-anything其他平台curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s platform支持平台gemini / codex / opencode / pi / openclaw / antigravity / vibe / vscode / hermes / cline / kimi / trae / nanobot / kiro