CodeGraph 安装：零配置接入 AI Agent 的本地代码知识图谱，工具调用直降 88%-平芜编程栈

CodeGraph 安装：零配置接入 AI Agent 的本地代码知识图谱，工具调用直降 88%

【免费下载链接】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

让助手回答"这个调用是怎么跨文件走通的"，它得先翻遍全库：几十次 grep 加十几个文件逐个读，token 花掉大半还未必找全。CodeGraph 安装就是治这个的——它是跑在本地 SQLite 上的代码知识图谱，符号、调用边、依赖关系预先建好，一次查询直达上下文，全程不到 5 分钟。

装上之后差多少

指标	用前	用后
工具调用次数	最多43次	2次
回答耗时	2 分 42 秒	45 秒
单次成本	$2.43	$0.54

数据来自官方在 7 个真实开源仓库上的 A/B 实测。装完只需记住一件事：改完代码索引自动同步，永远不会过期。

环境与平台速查

平台	架构	安装方式
macOS	x64 / arm64	Shell 脚本或 npm
Linux	x64 / arm64	Shell 脚本或 npm
Windows	x64 / arm64	PowerShell 脚本或 npm

💡 发行版是自带 Node 运行时的自包含构建，无需另装 Node.js、无需编译；索引数据库全部存在项目根目录的.codegraph/里，不出本机。

部署流程

阶段一：落地 CLI

这一步把codegraph命令装进 PATH。macOS / Linux 用 Shell 脚本，Windows 用 PowerShell 脚本：

# macOS / Linux curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh

# Windows (PowerShell) irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex

已有 Node 环境？等价地用 npm 装：

npm i -g @colbymchenry/codegraph

⚠️ 不做会失败：装完不打开新终端，脚本不会刷新当前 shell 的 PATH，直接敲codegraph就是 command not found。

阶段二：接入 Agent

在新终端运行安装器，把 CodeGraph 的 MCP 服务器（模型上下文协议，让助手调用本地工具的标准接口）写进你用的 Agent 配置：

codegraph install

会自动检测并配置 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro 与 GitHub Copilot（VS Code / Copilot CLI / JetBrains）。脚本化或 CI 场景：

codegraph install --target=cursor,claude --yes # 指定目标 codegraph install --yes --init # 顺手初始化当前项目

⚠️ 不做会失败：装完不重启 Agent，MCP 服务不会加载，查询照旧走 grep 老路。另外它只接线不建索引，索引是下一步的事。

阶段三：初始化项目

进入项目目录，一条命令完成建目录 + 建图谱：

cd your-project codegraph init

2.7 万文件的 Swift 编译器仓库首次索引约100 秒；之后单文件编辑重同步约4 秒。

💡 省时间的技巧：全局install一次覆盖所有项目，init每个项目只跑一次。

阶段四：确认自动同步

自动同步默认开启，不用配置。原生文件监听（macOS FSEvents / Linux inotify / Windows ReadDirectoryChangesW）捕获增删改，2 秒防抖窗口把批量编辑合并成一次同步：

codegraph status

保存文件后监听器约 300ms 内触发，只同步改动部分——4400 文件的项目约0.3 秒。Agent 每次连接还会做快速对账，补上离线期间的改动。

⚠️ 不做会失败：沙箱等禁用监听的环境，要手动跑codegraph sync，否则图谱停在你最后一次同步的位置。

验收自检

运行codegraph version：打印版本号（如 1.6.0）即成功；打印 not found 说明 PATH 没生效，回阶段一开新终端。
项目里跑codegraph status：应看到节点 / 边 / 文件统计，且Journal:为wal；提示未初始化则先补codegraph init。
在 Agent 会话里问一个架构问题：它应直接返回源码与调用路径，不再逐个读文件；若还在翻文件，重启 Agent 让 MCP 生效。
随便改一个源文件，等几秒再跑codegraph status：无Pending sync残留，说明自动同步在跑。