CodeGraph 安装教程：工具调用减少 88%，让 AI 助手不再翻遍整个仓库（100% 本地完整指南）

CodeGraph 安装教程工具调用减少 88%让 AI 助手不再翻遍整个仓库100% 本地完整指南【免费下载链接】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 助手这个功能是怎么实现的它开始逐个打开十几个文件、连发几十次搜索一轮 token 烧掉了大半真正干活反而没开始。CodeGraph 是一个本地代码知识图谱工具把整个仓库的符号、调用关系和依赖预先索引成一张可查询的图助手一次查询就能拿到精准上下文。这篇教程带你完成 CodeGraph 安装与上手装好 CLI、接上助手、给项目建图几分钟就能跑通。装上 CodeGraph 后你的助手会发生什么变化它先把整个仓库解析成一张存在本地 SQLite 里的知识图谱可以理解为所有函数、类、调用边、依赖关系组成的索引图落在项目根目录的.codegraph/文件夹里。数据 100% 留在你的机器上不需要任何 API 密钥。官方在 7 个真实开源项目VS Code、Tokio、Django 等上做了 4 轮取中位数的实测指标没有 CodeGraph有 CodeGraph响应速度基线平均快 53%最高 3.6 倍工具调用次数最多 43 次平均减少 88%Token 消耗基线平均少 62%文件读取次数最多 19 个文件0 次成本基线平均省 44%它支持哪些平台需要装 Node 吗不用。每个发行版都是自包含构建内置了 Node 运行时免安装 Node、免编译平台架构安装方式macOSx64Intel/ arm64Apple SiliconShell 脚本 或 npmLinuxx64 / arm64Shell 脚本 或 npmWindowsx64 / arm64PowerShell 脚本 或 npm 只要网络能下载安装包即可装完后索引数据全部保存在本地.codegraph/目录不会离开你的机器。安装 CodeGraph CLI每个平台一行命令macOS / Linux 用户在终端执行curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh脚本会自动识别操作系统和架构、下载对应构建程序落在~/.codegraph并把codegraph命令挂到~/.local/bin下。Windows 用户在 PowerShell 执行逻辑相同irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex本机已有 Node.js 的话也可以直接走 npm任意版本都能用npm i -g colbymchenry/codegraph⚠️ 安装脚本不会修改当前终端的环境变量。执行下一步之前先打开一个新终端否则codegraph命令找不到。把 CodeGraph 接进你常用的 AI 助手在新终端运行codegraph install安装器会自动检测本机装过的助手——Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity、Kiro以及 GitHub CopilotVS Code / Copilot CLI / JetBrains IDE逐个写入 MCP 服务器助手调用外部工具的通用协议配置。注意这一步只负责接线不会索引任何代码。配完后重启助手MCP 服务才会加载。在脚本或 CI 里跑用非交互参数codegraph install --yes --init自动检测、全局安装并顺手给当前项目构建索引。更多参数指定目标、只装到当前项目等见 CLI 参考。让项目被读懂给当前项目建图每个项目跑一次即可cd your-projectcodegraph initcodegraph init一条命令同时做两件事创建本地.codegraph/目录并构建完整的代码图谱。首次建图看仓库规模——两万七千个文件的 Swift 编译器仓库大约 100 秒。建图完成后助手只要检测到项目里有.codegraph/目录就会自动改用 CodeGraph 工具不需要额外配置。建完图之后同步是自动的别再手动跑自动同步默认开启不需要任何配置原生文件监听macOS FSEvents / Linux inotify / Windows ReadDirectoryChangesW捕获每次文件增删改默认 2 秒的防抖窗口把连串编辑合并成一次同步助手重新连接时还会做一次快速对账补上离线期间的改动。也就是说你或助手保存文件几秒后图谱就是最新的——单文件编辑的重新同步只需约 4 秒。日常高频操作速查命令用途codegraph explore 问题一次返回相关源码 调用路径 影响范围codegraph impact 符号改动前分析哪些代码会被波及codegraph affected src/xx.ts找出受此改动影响的测试文件codegraph status查看索引统计和待同步文件codegraph sync手动增量更新监听被禁用的边缘场景才需要codegraph upgrade一键升级到最新版本codegraph telemetry off关闭匿名使用统计安装时会先询问codegraph uninstall从所有助手移除配置并删除 CLI加--keep-cli保留 CLIcodegraph uninit删除当前项目的.codegraph/索引常见报错怎么处理codegraph: command not found→ 原因安装脚本不会改动当前 Shell 的环境变量。 → 解法打开一个新终端macOS / Linux 下确认~/.local/bin在PATH里。提示 CodeGraph not initialized→ 原因当前项目目录还没执行过codegraph init。 → 解法回到项目根目录补跑一次codegraph init。MCP 报database is locked→ 原因0.9 之前的老版本或该文件系统开不了 WAL 模式WSL2 的/mnt/c等 Windows 盘上常见。 → 解法重装最新版用codegraph status看Journal是否为wal不是就把项目连同.codegraph/挪到本地磁盘。索引速度比预期慢→ 原因node_modules、dist之类的大目录进了索引默认已排除一般是特殊.gitignore情况。 → 解法默认排除列表通常够用输出太多时加--quiet减少开销。WSL2 与 Windows 共用一个仓库出现Transport closed→ 原因共享后台服务在 WSL2 与 Windows 文件系统交界处不稳定。 → 解法两边各建独立索引例如 Windows 侧设CODEGRAPH_DIR.codegraph-win或把项目挪到 Linux 原生路径下。接下来看什么记住三件事就够了CLI 一行命令装好codegraph install把助手接上每个项目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），仅供参考