用 Graph 给 Coding Agent 建代码地图：项目提速实测

用 Graph 做一个预约排期应用，第一次构建用了 39 分钟，占约 31% 的上下文；没用 Graph 时用了 47 分钟，占约 35%。功能差不多。

真正明显的差别出现在后面。项目已经有一张地图，再改整套落地页，任务不到 2 分钟就完成了。原因很简单：Agent 不用每次从文件堆里重新找路。

Agent 为什么总要先搜索

你给 Coding Agent 一个任务，它不能只看这一句话就改代码，而是要先知道相关代码在哪里。

默认流程通常是：搜索关键词，读搜索结果，打开某个文件，再读附近代码。如果还没定位清楚，就继续搜索。每走一轮，前面的对话和工具输出也会跟着回到模型上下文里。

这会带来两个问题：上下文越堆越长，模型越慢；工具调用越多，额度消耗越快。

向量搜索能按相似意思找代码，但它不一定知道代码之间怎么连接。创建账号和删除账号都可能和「账号」相似，实际却是两个方向。代码项目需要的是关系，不只是相似度。

Graph 的地图里有什么

Graph 会读取项目代码，把识别出的部件登记为节点，再把部件之间的调用关系登记为边。

你可以把它想成一张交通图：节点是地点，边是道路。Agent 想改一个节点时，还能顺着边看见哪些地方可能受到影响。

这张图会保存成 JSON 文件，并提供浏览器查看器。代码变了，Graph 会在回答任务前检查变化，只更新受影响的部分。这个更新过程不需要再调用模型。

Graph 还有一个可选步骤：让模型为项目生成解释页面，说明每个部分做什么、彼此怎么配合。它更像说明书，不是地图本身。只要你先把关系图建好，Agent 就已经能少打开很多无关文件。

安装和初始化

安装流程可以按这条线走。

1. 安装 Graph

到项目官网复制安装命令。你也可以复制针对当前 Coding Agent 的 setup prompt，直接交给 Agent 执行。字幕没有给出固定命令，所以建议以官网当前版本为准。

2. 在项目目录执行 init

注意目录。init 要在你真正工作的项目文件夹里执行，因为它会把项目说明和 Agent 需要的文件写入当前目录。

执行时，Graph 会询问你使用哪一个 Coding Agent。选完以后，项目里通常会出现 Graph skill，并安装几类 hooks：会话开始时告诉模型怎么用地图；收到提示时附上匹配位置；文件被修改后更新地图。

3. 给已有项目执行 build

如果项目已经有代码，在同一个目录执行 build，让 Graph 扫描现有文件并生成地图。

如果是空文件夹，没有内容可映射。等项目先写出代码，再建图。

CLI 和 MCP 怎么选

安装后两种方式都能用。

CLI 模式会根据你的提示词猜匹配位置，并把最多 3 个位置附到每条消息上。它更快，但有时会把 Agent 暂时用不到的位置也带进去。

MCP 模式则由 Agent 在真正需要时询问 Graph。测试显示，MCP 版本答对的次数略多，CLI 版本速度更快。

如果你更在意响应速度，先用 CLI；如果你想让 Agent 自己决定什么时候查图，可以试 MCP。两种方式不是二选一的产品安装，Graph 会一起提供。

你需要提前知道的坑

Graph 只映射代码。

项目里的 PRD、需求说明、学习记录和其他上下文文件，仍然会按 Coding Agent 原来的方式读取。你不能因为装了 Graph，就以为所有项目资料都已经被整理好。

另外，第一轮构建的差距可能没有想象中大。第一次构建只从 47 分钟降到 39 分钟，真正的优势是在地图形成后，反复修改同一个项目时逐渐出现。

所以比较合理的用法是：在一个已经进入持续迭代的项目里安装它，先测一次原始任务，再测一次跨文件修改。看工具调用、耗时和上下文占用有没有变化。数据对你自己的项目有用，宣传数字只能当参考——类似的经验分享，在 云栈社区 还有很多。