5 分钟装好 CodeGraph 并接入 AI 助手完整指南【免费下载链接】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 一行行 grep 你的仓库、逐个读文件找调用链token 烧得飞快答案还常常差一层。CodeGraph 的做法相反先把整个仓库的符号、调用边、依赖关系建成语义级知识图谱AI 助手查一次图谱就能拿到精准上下文而不再自己翻文件。30 秒速览装完能得到什么一次安装所有助手受益Claude Code、Cursor、Codex、opencode、Gemini、GitHub Copilot 等 9 类助手自动接上同一个 MCP 服务。纯本地运行无需 API 密钥无需外部服务索引全部落在项目里的.codegraph/目录。零配置免 Node安装包自带运行时不编译、不装依赖。装完基本不用管文件一改图谱自动同步不存在索引过期。耗时CLI 安装 助手接入约 2 分钟单个项目首次建图视仓库大小量级见下文。官方在 7 个真实开源仓库上的实测均值数据来自 README 的 2026-08 复测指标无 CodeGraph有 CodeGraph工具调用次数最多 43 次少 88%Token 消耗基线少 62%回答耗时基线平均快 53%成本基线平均省 44%文件读取次数最多 19 个文件7 个仓库全部 0 次选一条安装路线脚本还是 npm所有发行版都是自包含构建内置 Node 运行时三大平台 x64 与 arm64 全覆盖平台架构推荐路线macOSx64 / arm64Shell 脚本 或 npmLinuxx64 / arm64Shell 脚本 或 npmWindowsx64 / arm64PowerShell 脚本 或 npm选择建议机器上没有 Node、或者不想污染全局环境走一键脚本已经有 Node 且习惯npm i -g管理工具走 npm 路线两条路装出来功能一致。动手 · 把 CLI 跑起来macOS / LinuxTerminalcurl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | shWindowsPowerShellirm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex已有 Node用 npm 装对版本无要求npm i -g colbymchenry/codegraph脚本会把程序装到~/.codegraph并在~/.local/bin创建codegraph启动链接。⚠️ 安装脚本不会修改当前 Shell 的环境变量。打开一个新终端再执行下一步否则找不到codegraph命令。新终端里跑这条输出版本号如1.6.0即为安装成功codegraph version接上你的 AI 助手一条命令配置 MCPcodegraph install安装器会自动检测并写入各助手的 MCP 配置Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro以及 GitHub CopilotVS Code / Copilot CLI / JetBrains IDE并顺带在对应助手的说明文件里写入 CodeGraph 小节。这一步只接助手、不建索引接完重启你的 Agent让 MCP 服务生效。CI 或脚本化场景可用非交互参数codegraph install --yes # 自动检测全局安装 codegraph install --targetcursor,claude --yes # 指定目标 codegraph install --print-config codex # 只打印配置片段不写文件让项目被读懂每个项目初始化一次cd your-project codegraph initcodegraph init一步完成两件事创建本地.codegraph/目录 构建完整代码图谱。量级参考官方实测2.7 万文件的 Swift 编译器仓库首次建图约 100 秒建好之后单文件编辑的再同步约 4 秒日常保存触发的同步通常在 1 秒以内。全局的codegraph install覆盖所有项目codegraph init每个项目跑一次即可。Agent 检测到项目里存在.codegraph/目录就会自动使用 CodeGraph 工具无需额外设置。验收清单确认装对了✅codegraph version输出版本号✅ 项目根目录生成了.codegraph/目录✅codegraph status显示索引统计且 Journal 模式为wal✅ 重启 Agent 后MCP 工具中出现codegraph_explore等工具✅ 随便问 Agent 一个跨文件调用链问题它直接查图谱回答不再逐个读文件日常与进阶高频命令速查命令用途codegraph explore 问题一次返回相关源码 调用路径 影响范围codegraph impact 符号改动前分析受影响代码codegraph affected src/xx.ts找出受改动的测试文件codegraph sync手动增量同步正常情况不需要codegraph status查看索引统计与待同步文件codegraph upgrade一键升级到最新版--check仅检查codegraph telemetry off关闭匿名使用统计自动同步默认开启机制是三层原生文件监听macOS FSEvents / Linux inotify / Windows ReadDirectoryChangesW捕获每次增删改防抖窗口默认 2 秒可用CODEGRAPH_WATCH_DEBOUNCE_MS调整把批量编辑合并成一次同步Agent 每次重连时再做一次快速对账补上离线期间的改动。防抖窗口内若文件未入索引MCP 响应会带陈旧文件横幅提示 Agent 直接读文件兜底——所以装完你只需要知道一件事图谱自己跟着代码走。卡住了 · 对症下药现象原因解法codegraph: command not found安装脚本不改变当前 Shell打开新终端确认~/.local/bin在PATH中提示 CodeGraph not initialized项目没跑过初始化项目目录里执行codegraph init索引速度慢大目录未被排除、输出开销node_modules/dist默认已排除codegraph index --quiet减少输出MCP 报database is locked0.9 之前老版本或文件系统不支持 WAL网络盘、WSL2/mnt重装获取内置运行时把项目连同.codegraph/移到本地磁盘MCP 报Transport closedWSL2项目在/mnt/c跨 OS 边界的本地 socket 不可靠环境变量设CODEGRAPH_NO_DAEMON1走进程内服务或把项目移到 Linux 原生文件系统Windows 与 WSL 共用一个仓库两边锁冲突Windows 侧设CODEGRAPH_DIR.codegraph-win各自独立索引反悔也简单codegraph uninstall从所有已配置的助手移除配置并删除 CLI删除前会先展示清单--keep-cli只移除助手配置单个项目的索引用codegraph uninit删。更多细节见 官方故障排查文档 与 CLI 完整参考。想搞懂图谱如何解析、符号如何跨文件关联读这两篇工作原理 与 知识图谱概念。装完的下一个 5 分钟够你让 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
5 分钟装好 CodeGraph 并接入 AI 助手：完整指南
5 分钟装好 CodeGraph 并接入 AI 助手完整指南【免费下载链接】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 一行行 grep 你的仓库、逐个读文件找调用链token 烧得飞快答案还常常差一层。CodeGraph 的做法相反先把整个仓库的符号、调用边、依赖关系建成语义级知识图谱AI 助手查一次图谱就能拿到精准上下文而不再自己翻文件。30 秒速览装完能得到什么一次安装所有助手受益Claude Code、Cursor、Codex、opencode、Gemini、GitHub Copilot 等 9 类助手自动接上同一个 MCP 服务。纯本地运行无需 API 密钥无需外部服务索引全部落在项目里的.codegraph/目录。零配置免 Node安装包自带运行时不编译、不装依赖。装完基本不用管文件一改图谱自动同步不存在索引过期。耗时CLI 安装 助手接入约 2 分钟单个项目首次建图视仓库大小量级见下文。官方在 7 个真实开源仓库上的实测均值数据来自 README 的 2026-08 复测指标无 CodeGraph有 CodeGraph工具调用次数最多 43 次少 88%Token 消耗基线少 62%回答耗时基线平均快 53%成本基线平均省 44%文件读取次数最多 19 个文件7 个仓库全部 0 次选一条安装路线脚本还是 npm所有发行版都是自包含构建内置 Node 运行时三大平台 x64 与 arm64 全覆盖平台架构推荐路线macOSx64 / arm64Shell 脚本 或 npmLinuxx64 / arm64Shell 脚本 或 npmWindowsx64 / arm64PowerShell 脚本 或 npm选择建议机器上没有 Node、或者不想污染全局环境走一键脚本已经有 Node 且习惯npm i -g管理工具走 npm 路线两条路装出来功能一致。动手 · 把 CLI 跑起来macOS / LinuxTerminalcurl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | shWindowsPowerShellirm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex已有 Node用 npm 装对版本无要求npm i -g colbymchenry/codegraph脚本会把程序装到~/.codegraph并在~/.local/bin创建codegraph启动链接。⚠️ 安装脚本不会修改当前 Shell 的环境变量。打开一个新终端再执行下一步否则找不到codegraph命令。新终端里跑这条输出版本号如1.6.0即为安装成功codegraph version接上你的 AI 助手一条命令配置 MCPcodegraph install安装器会自动检测并写入各助手的 MCP 配置Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro以及 GitHub CopilotVS Code / Copilot CLI / JetBrains IDE并顺带在对应助手的说明文件里写入 CodeGraph 小节。这一步只接助手、不建索引接完重启你的 Agent让 MCP 服务生效。CI 或脚本化场景可用非交互参数codegraph install --yes # 自动检测全局安装 codegraph install --targetcursor,claude --yes # 指定目标 codegraph install --print-config codex # 只打印配置片段不写文件让项目被读懂每个项目初始化一次cd your-project codegraph initcodegraph init一步完成两件事创建本地.codegraph/目录 构建完整代码图谱。量级参考官方实测2.7 万文件的 Swift 编译器仓库首次建图约 100 秒建好之后单文件编辑的再同步约 4 秒日常保存触发的同步通常在 1 秒以内。全局的codegraph install覆盖所有项目codegraph init每个项目跑一次即可。Agent 检测到项目里存在.codegraph/目录就会自动使用 CodeGraph 工具无需额外设置。验收清单确认装对了✅codegraph version输出版本号✅ 项目根目录生成了.codegraph/目录✅codegraph status显示索引统计且 Journal 模式为wal✅ 重启 Agent 后MCP 工具中出现codegraph_explore等工具✅ 随便问 Agent 一个跨文件调用链问题它直接查图谱回答不再逐个读文件日常与进阶高频命令速查命令用途codegraph explore 问题一次返回相关源码 调用路径 影响范围codegraph impact 符号改动前分析受影响代码codegraph affected src/xx.ts找出受改动的测试文件codegraph sync手动增量同步正常情况不需要codegraph status查看索引统计与待同步文件codegraph upgrade一键升级到最新版--check仅检查codegraph telemetry off关闭匿名使用统计自动同步默认开启机制是三层原生文件监听macOS FSEvents / Linux inotify / Windows ReadDirectoryChangesW捕获每次增删改防抖窗口默认 2 秒可用CODEGRAPH_WATCH_DEBOUNCE_MS调整把批量编辑合并成一次同步Agent 每次重连时再做一次快速对账补上离线期间的改动。防抖窗口内若文件未入索引MCP 响应会带陈旧文件横幅提示 Agent 直接读文件兜底——所以装完你只需要知道一件事图谱自己跟着代码走。卡住了 · 对症下药现象原因解法codegraph: command not found安装脚本不改变当前 Shell打开新终端确认~/.local/bin在PATH中提示 CodeGraph not initialized项目没跑过初始化项目目录里执行codegraph init索引速度慢大目录未被排除、输出开销node_modules/dist默认已排除codegraph index --quiet减少输出MCP 报database is locked0.9 之前老版本或文件系统不支持 WAL网络盘、WSL2/mnt重装获取内置运行时把项目连同.codegraph/移到本地磁盘MCP 报Transport closedWSL2项目在/mnt/c跨 OS 边界的本地 socket 不可靠环境变量设CODEGRAPH_NO_DAEMON1走进程内服务或把项目移到 Linux 原生文件系统Windows 与 WSL 共用一个仓库两边锁冲突Windows 侧设CODEGRAPH_DIR.codegraph-win各自独立索引反悔也简单codegraph uninstall从所有已配置的助手移除配置并删除 CLI删除前会先展示清单--keep-cli只移除助手配置单个项目的索引用codegraph uninit删。更多细节见 官方故障排查文档 与 CLI 完整参考。想搞懂图谱如何解析、符号如何跨文件关联读这两篇工作原理 与 知识图谱概念。装完的下一个 5 分钟够你让 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
