CodeGraph初体验在VS Code源码库上1次调用回答架构问题的实录【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraphCodeGraph是一个 100% 本地运行的预建代码知识图谱工具它提前把整个代码库的符号、调用关系和依赖解析成一张图代码一变就自动同步并通过 MCP 接入 Claude Code、Cursor、Codex、Gemini 等 AI 编程代理——让你问一个架构问题一次调用就拿到答案更少 token、更少工具调用。本文记录我在约 1.1 万个文件的 VS Code 源码库上用 CodeGraph 回答「扩展宿主进程如何与主进程通信」这个架构问题的完整实录和实测数据。 快速上手3 步完成安装与初始化CodeGraph 自带运行时不需要本地装 Node.js 编译环境。第 1 步安装 CLInpm i -g colbymchenry/codegraph也可以先git clone https://gitcode.com/GitHub_Trending/co0degr/codegraph克隆仓库自行构建。第 2 步连接你的 AI 代理codegraph install它会自动检测机器上已安装的 Claude Code、Cursor、Codex CLI、Gemini、Kiro、GitHub Copilot 等代理并写好各自的 MCP 服务配置。多代理适配逻辑位于 installer/targets/ 目录下的目标文件与registry.ts中。第 3 步初始化项目cd vscode codegraph init一条命令即在项目根目录创建.codegraph/索引并构建完整图谱。之后文件一有改动文件监听器会自动增量同步见下文无需手动再跑任何命令。⏱ 提示VS Code 级别的巨型仓库首次建图需要一点时间普通项目通常几十秒内完成。 实战实录在 VS Code 源码库上问一个架构问题问题正是官方基准使用的同一题“扩展宿主Extension Host如何与主进程通信”没有 CodeGraph 时代理的标准动作是ls找目录 →grep关键词 → 逐个Read文件 → 再 grep 跳转……在 VS Code 这种规模的库里实测中位数需要28 次工具调用、读 12 个文件、耗时 2 分 10 秒。开启 CodeGraph 后我只看到2 次调用codegraph_explore为主0 次文件读取58 秒拿到答案。答案里直接包含相关符号的原文源码按文件分组、带行号、符号之间的调用路径含动态分发跳转、以及改动影响半径摘要。指标无 CodeGraph有 CodeGraph提升工具调用次数28293% 更少文件读取次数120归零耗时2m 10s58s快 2.2×Token 消耗670k155k少 77%成本$1.80$0.53省 71%数据来自 4 次运行取中位数的受控基准详见 docs/benchmarks/ 目录。 一次调用为什么能回答架构问题CodeGraph 的流水线是「提取 → 存储 → 解析 → 同步」四层提取原生 Rust 解析内核源码在 codegraph-kernel/src/按语言拆分模块对 20 语言做 AST 级结构提取产出节点函数、类、方法和边调用、导入、继承存储全部写入本地 SQLite含 FTS5 全文索引核心 Schema 见 src/db/schema.sql解析把函数调用解析到定义、导入解析到源文件并覆盖框架路由、回调、React 重渲染、接口→实现等 grep 追不上的动态跳转查询MCP 侧只暴露一个强工具codegraph_explore——一次调用返回「相关符号原文 调用路径 影响半径」。工具定义在 src/mcp/tools.ts返回给代理的使用指引在 src/mcp/server-instructions.ts。关键设计图谱是提前建好的确定性结构来自 AST而非 LLM 摘要所以查询是毫秒级的图检索而不是现场爬文件。代理不再「探索」而是「提问」。 自动同步图谱永远不会过期这是 CodeGraph 最省心的部分——文件保存后约 2 秒的防抖窗口内原生 OS 文件事件inotify / FSEvents触发增量同步只处理真正变化的文件而不是重扫整个仓库。4400 文件的项目单次同步约 0.3 秒Swift 编译器这种 2.7 万文件的大仓也只需约 0.4 秒。同步策略与防抖参数见 src/sync/watch-policy.ts 和 src/sync/watcher.ts。在同步间隙提问也不怕工具返回会带上过期的文件标注staleness banner提示代理直接读该文件获取最新内容。随时可用codegraph status查看是否有待同步项。 实测结论与使用建议官方在 7 个真实开源仓库VS Code、Excalidraw、Django、Tokio、OkHttp、Gin、Alamofire上做了严格 A/B两臂都禁用了 CLI、每臂 4 次取中位数结论高度一致——有图谱的一侧全部 0 文件读取工具调用平均少 88%耗时平均快 53%。三点实用建议直接问别委派子代理实测显示配好 CodeGraph 后代理 6/6 次都选择在主会话直接回答上下文占用与仓库规模基本无关VS Code 约 47k和 1/16 规模的仓库几乎一样长会话注意上下文残留explore 返回的是高密度原文载荷答完后会留在窗口里VS Code 上约 67k token 残留跑超长会话时给上下文窗口留点余量零配置即用node_modules、dist、.gitignore内容默认全部跳过图谱里只有你自己的代码。 小结亮点说明⚡ 一次调用架构问题 2 次调用 0 文件读取答完 本地优先纯 SQLite无 API Key数据不出机器 自动保鲜文件改动即增量同步无需手动 re-index 多代理Claude Code / Cursor / Codex / Gemini / Copilot 一键接入如果你也在用 AI 代理啃大型代码库CodeGraph 值得花 5 分钟试一下——装一次codegraph init每个项目跑一次然后就可以体感「问一句、答一答」的新工作方式了。【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考