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 实测。装完只需记住一件事改完代码索引自动同步永远不会过期。环境与平台速查平台架构安装方式macOSx64 / arm64Shell 脚本 或 npmLinuxx64 / arm64Shell 脚本 或 npmWindowsx64 / arm64PowerShell 脚本 或 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 CopilotVS Code / Copilot CLI / JetBrains。脚本化或 CI 场景codegraph install --targetcursor,claude --yes # 指定目标 codegraph install --yes --init # 顺手初始化当前项目⚠️ 不做会失败装完不重启 AgentMCP 服务不会加载查询照旧走 grep 老路。另外它只接线不建索引索引是下一步的事。阶段三初始化项目进入项目目录一条命令完成建目录 建图谱cd your-project codegraph init2.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残留说明自动同步在跑。避坑清单codegraph: command not found—— 安装脚本只改 PATH 配置不改当前 shell → 打开新终端再执行后续命令。提示 CodeGraph not initialized—— 项目没跑过codegraph init→ 在该项目目录补跑一次即可。WSL2 与 Windows 共用一个仓库报锁冲突—— 两边指向同一个.codegraph/会互踩 → 各建独立索引Windows 侧设环境变量CODEGRAPH_DIR.codegraph-winWSL 保持默认。网络盘上 database is locked—— 跨系统文件系统的 SQLite 锁不可靠 →codegraph status看Journal:不是wal就把项目挪到本地磁盘。MCP 调用报 Transport closedCLI 却一切正常—— 多为 WSL2 中项目放在/mnt/c等 Windows 盘 → 给 MCP 环境加CODEGRAPH_NO_DAEMON1或把项目挪到 Linux 原生文件系统。收尾装 CLI开新终端一键接入 Agent项目跑 init自动同步零维护。工具调用直降88%平均快53%单次成本省44%。想深入细节安装文档、CLI 参考。【免费下载链接】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),仅供参考