CodeGraph安装指南三平台一键部署与 Agent 快速接入【免费下载链接】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你让 Claude Code 帮你追一条跨文件的调用链它开始 grep、再读一个文件、再 grep——十几轮工具调用过去token 账单先跳了上下文还可能拿不准。CodeGraph 解决的就是这件事一次安装把整个仓库的符号、调用边和依赖关系预先建成本地代码知识图谱Agent 一次查询就能拿到精准上下文并且 100% 本地运行、不需要任何 API 密钥。接入之后一次回答能省多少先说结论官方在 7 个真实开源项目上的实测里接入 CodeGraph 后速度、token、成本、调用量四项全面下降文件读取直接归零。维度不用 CodeGraph接入 CodeGraph 后回答速度基线平均快 53%Token 消耗基线少 62%单题成本基线平均省 44%工具调用次数最多 43 次减少 88%文件读取次数最多 19 个文件0 次除了省还有两个附带收益图谱随代码改动自动同步索引不会过期所有数据留在本机.codegraph/目录不离开你的机器。先确认机器条件自包含构建三平台通用所有发行版都是自包含构建——内置 Node 运行时不用装 Node.js、不用编译。你只需要网络能访问安装包下载地址。平台架构安装路线macOSx64 / arm64Shell 脚本 或 npmLinuxx64 / arm64Shell 脚本 或 npmWindowsx64 / arm64PowerShell 脚本 或 npm把 CLI 装到本机脚本或 npm 二选一两条路线结果一样装完都能直接敲codegraph。路线一一键安装脚本。脚本会自动识别操作系统和 CPU 架构、下载对应构建把程序装进~/.codegraph并在~/.local/bin创建codegraph启动链接# macOS / LinuxTerminal curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh# WindowsPowerShell irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex路线二机器上已有 Node.js 的话走 npm 更简单等价于装一个自包含的全局包npm i -g colbymchenry/codegraph⚠️ 两条路线都不会修改当前 Shell 的环境变量。装完请打开一个新终端再继续否则找不到codegraph命令。接入 Agent 并给项目建图CLI 装好只是第一步真正让 Agent用上图谱要两件事把 MCP 服务接进 Agent再给项目建一次图。在新终端里运行安装器它会自动检测本机在用的 Agent 并逐个写入 MCP 配置——支持 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro以及 GitHub CopilotVS Code / Copilot CLI / JetBrains IDE完成后重启 Agent 即生效codegraph install在脚本化或 CI 场景下可以加参数跳过交互codegraph install --yes # 自动检测全局安装 codegraph install --targetcursor,claude --yes # 只配置指定目标 codegraph install --yes --init # 顺带初始化当前项目接着回到你自己的项目目录跑一次codegraph init它会创建本地.codegraph/目录并同步构建完整图谱——一条命令两件事。量级参考数万文件的 Swift 编译器仓库首次索引约 100 秒。此后 Agent 每次进入项目发现.codegraph/存在就会自动改用 CodeGraph 工具不再需要你做任何设置。装完怎么确认两条状态命令索引构建完成后用下面两条命令确认一切就绪——status看索引统计和待同步文件version看已安装版本codegraph status codegraph version 反悔也简单codegraph uninstall会从所有已配置的 Agent 中移除配置并删除 CLI 本体删除前先展示清单codegraph uninstall --keep-cli只移除 Agent 配置单个项目的索引用codegraph uninit删。文件改了图谱自己跟着变自动同步默认开启不需要任何配置。它的逻辑分三层底层用原生文件监听macOS FSEvents / Linux inotify / Windows ReadDirectoryChangesW捕获每一次文件增删改中间用一个默认 2 秒的防抖窗口把连续批量编辑合并成一次同步最后Agent 每次连接时还会做一次快速对账把离线期间漏掉的改动补上。环节它在做什么捕获原生文件监听盯着每次文件增删改合并2 秒防抖窗口把批量编辑合成一次同步对账Agent 连接时快速核对补上离线改动也就是说你或 Agent 保存文件后几秒内图谱就是最新的从此没有手动同步这个概念。单文件编辑后的重新同步实测约 4 秒。日常高频命令速查装好后你最高频接触的就是这几条命令作用codegraph explore 问题一次返回相关源码 调用路径 影响范围codegraph impact 符号改动前分析受影响的代码codegraph affected src/xx.ts找出受本次改动影响的测试文件codegraph upgrade一键升级到最新版本codegraph telemetry off关闭匿名使用统计也支持环境变量DO_NOT_TRACK1三个最常见的故障按现象排查现象codegraph: command not found。原因安装脚本不会改动当前 Shell 的PATH你多半还停在旧终端。 解决打开一个新终端再试仍不行就确认~/.local/bin已在PATH中。现象提示 CodeGraph not initialized。原因当前项目还没有.codegraph/目录图谱没建。 解决在项目根目录跑一次codegraph init。现象MCP 报 database is locked。原因0.9 之前的老版本没有内置运行时需要重装获取新版本WSL2 中项目放在/mnt/c等 Windows 盘上也会加重锁竞争。 解决重装最新版把项目移到 Linux 原生文件系统。WSL2 与 Windows 共用同一仓库时给 Windows 侧设置环境变量CODEGRAPH_DIR.codegraph-win让双方各建独立索引避免冲突。想继续深挖安装只是开始图谱内部如何解析、符号如何跨文件关联可以接着读两篇官方文档工作原理 与 知识图谱概念。【免费下载链接】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），仅供参考 CodeGraph安装指南：三平台一键部署与 Agent 快速接入
CodeGraph安装指南三平台一键部署与 Agent 快速接入【免费下载链接】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你让 Claude Code 帮你追一条跨文件的调用链它开始 grep、再读一个文件、再 grep——十几轮工具调用过去token 账单先跳了上下文还可能拿不准。CodeGraph 解决的就是这件事一次安装把整个仓库的符号、调用边和依赖关系预先建成本地代码知识图谱Agent 一次查询就能拿到精准上下文并且 100% 本地运行、不需要任何 API 密钥。接入之后一次回答能省多少先说结论官方在 7 个真实开源项目上的实测里接入 CodeGraph 后速度、token、成本、调用量四项全面下降文件读取直接归零。维度不用 CodeGraph接入 CodeGraph 后回答速度基线平均快 53%Token 消耗基线少 62%单题成本基线平均省 44%工具调用次数最多 43 次减少 88%文件读取次数最多 19 个文件0 次除了省还有两个附带收益图谱随代码改动自动同步索引不会过期所有数据留在本机.codegraph/目录不离开你的机器。先确认机器条件自包含构建三平台通用所有发行版都是自包含构建——内置 Node 运行时不用装 Node.js、不用编译。你只需要网络能访问安装包下载地址。平台架构安装路线macOSx64 / arm64Shell 脚本 或 npmLinuxx64 / arm64Shell 脚本 或 npmWindowsx64 / arm64PowerShell 脚本 或 npm把 CLI 装到本机脚本或 npm 二选一两条路线结果一样装完都能直接敲codegraph。路线一一键安装脚本。脚本会自动识别操作系统和 CPU 架构、下载对应构建把程序装进~/.codegraph并在~/.local/bin创建codegraph启动链接# macOS / LinuxTerminal curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh# WindowsPowerShell irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex路线二机器上已有 Node.js 的话走 npm 更简单等价于装一个自包含的全局包npm i -g colbymchenry/codegraph⚠️ 两条路线都不会修改当前 Shell 的环境变量。装完请打开一个新终端再继续否则找不到codegraph命令。接入 Agent 并给项目建图CLI 装好只是第一步真正让 Agent用上图谱要两件事把 MCP 服务接进 Agent再给项目建一次图。在新终端里运行安装器它会自动检测本机在用的 Agent 并逐个写入 MCP 配置——支持 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro以及 GitHub CopilotVS Code / Copilot CLI / JetBrains IDE完成后重启 Agent 即生效codegraph install在脚本化或 CI 场景下可以加参数跳过交互codegraph install --yes # 自动检测全局安装 codegraph install --targetcursor,claude --yes # 只配置指定目标 codegraph install --yes --init # 顺带初始化当前项目接着回到你自己的项目目录跑一次codegraph init它会创建本地.codegraph/目录并同步构建完整图谱——一条命令两件事。量级参考数万文件的 Swift 编译器仓库首次索引约 100 秒。此后 Agent 每次进入项目发现.codegraph/存在就会自动改用 CodeGraph 工具不再需要你做任何设置。装完怎么确认两条状态命令索引构建完成后用下面两条命令确认一切就绪——status看索引统计和待同步文件version看已安装版本codegraph status codegraph version 反悔也简单codegraph uninstall会从所有已配置的 Agent 中移除配置并删除 CLI 本体删除前先展示清单codegraph uninstall --keep-cli只移除 Agent 配置单个项目的索引用codegraph uninit删。文件改了图谱自己跟着变自动同步默认开启不需要任何配置。它的逻辑分三层底层用原生文件监听macOS FSEvents / Linux inotify / Windows ReadDirectoryChangesW捕获每一次文件增删改中间用一个默认 2 秒的防抖窗口把连续批量编辑合并成一次同步最后Agent 每次连接时还会做一次快速对账把离线期间漏掉的改动补上。环节它在做什么捕获原生文件监听盯着每次文件增删改合并2 秒防抖窗口把批量编辑合成一次同步对账Agent 连接时快速核对补上离线改动也就是说你或 Agent 保存文件后几秒内图谱就是最新的从此没有手动同步这个概念。单文件编辑后的重新同步实测约 4 秒。日常高频命令速查装好后你最高频接触的就是这几条命令作用codegraph explore 问题一次返回相关源码 调用路径 影响范围codegraph impact 符号改动前分析受影响的代码codegraph affected src/xx.ts找出受本次改动影响的测试文件codegraph upgrade一键升级到最新版本codegraph telemetry off关闭匿名使用统计也支持环境变量DO_NOT_TRACK1三个最常见的故障按现象排查现象codegraph: command not found。原因安装脚本不会改动当前 Shell 的PATH你多半还停在旧终端。 解决打开一个新终端再试仍不行就确认~/.local/bin已在PATH中。现象提示 CodeGraph not initialized。原因当前项目还没有.codegraph/目录图谱没建。 解决在项目根目录跑一次codegraph init。现象MCP 报 database is locked。原因0.9 之前的老版本没有内置运行时需要重装获取新版本WSL2 中项目放在/mnt/c等 Windows 盘上也会加重锁竞争。 解决重装最新版把项目移到 Linux 原生文件系统。WSL2 与 Windows 共用同一仓库时给 Windows 侧设置环境变量CODEGRAPH_DIR.codegraph-win让双方各建独立索引避免冲突。想继续深挖安装只是开始图谱内部如何解析、符号如何跨文件关联可以接着读两篇官方文档工作原理 与 知识图谱概念。【免费下载链接】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），仅供参考