CodeGraph 安装三大平台完整指南5 分钟接入 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/codegraphCodeGraph 是面向 AI 编程助手的本地代码知识图谱工具。完成 CodeGraph 安装与上手后Claude Code、Cursor、Codex 等助手一次查询就能拿到相关源码、调用路径和影响范围替代逐文件 grep。装完后索引随代码变更自动同步。全程约 5 分钟。CodeGraph 值不值得装装前后对比官方在 7 个真实开源仓库、4 次取中位数的实测数据Claude Opus 4.82026-08 复测指标无 CodeGraph有 CodeGraph工具调用次数最高 43 次平均减少88%回答速度基线平均快53%Token 消耗基线少62%成本基线平均省44%文件读取最高 19 个文件7 个仓库均为0 次注意一个代价CodeGraph 返回的内容更密集会话结束后残留在上下文窗口里的检索内容比纯读文件方式多VS Code 上约 67k vs 18k token。长会话 小窗口时留意这一点。安装 CodeGraph 前的平台自查平台架构安装方式macOSx64 / arm64Shell 安装脚本 或 npmLinuxx64 / arm64Shell 安装脚本 或 npmWindowsx64 / arm64PowerShell 安装脚本 或 npm前置条件所有发行版都是自包含构建内置 Node 运行时无需安装 Node.js、无需编译已有 Node 也能用 npm 装。只需网络能访问安装包下载地址索引数据全部存本地.codegraph/目录SQLite代码和路径不会外传。匿名使用统计默认在不需要就装完执行codegraph telemetry off或设DO_NOT_TRACK1。安装并接入 CodeGraph免 Node.js 安装 CodeGraph CLImacOS / LinuxTerminalcurl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | shWindowsPowerShellirm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex脚本自动识别系统架构把程序装到~/.codegraph并在~/.local/bin创建codegraph启动链接。已有 Node 的替代方式npm i -g colbymchenry/codegraph⚠️ 安装脚本不会改当前 Shell 的环境变量开一个新终端再执行下一步否则会提示命令找不到。把 AI 助手接入 CodeGraph在新终端运行安装器它会检测本机已装的助手并逐个写入 MCP 配置Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro以及 GitHub CopilotVS Code / Copilot CLI / JetBrains IDE。codegraph install脚本化或 CI 环境用非交互参数codegraph install --yes # 自动检测全局安装 codegraph install --targetcursor,claude --yes # 指定目标 codegraph install --yes --init # 顺手初始化当前项目⚠️ 这一步只接 Agent、不索引任何代码写配置后要重启你的 AgentMCP 服务才会加载。用 codegraph init 建项目代码图谱cd your-project codegraph initcodegraph init一步两件事创建.codegraph/目录 构建完整图谱。官方数据27k 文件的 Swift 编译器仓库首次索引约 100 秒日常单文件编辑的重新同步约 4 秒。Agent 看到项目里存在.codegraph/就会自动使用 CodeGraph 工具无需额外设置。自动同步接管免手动维护自动同步默认开启原生文件监听macOS FSEvents / Linux inotify / Windows ReadDirectoryChangesW捕获每次文件增删改防抖窗口默认2 秒把连续编辑合并为一次同步Agent 每次连接 MCP 时做一次快速对账补上离线期间的改动。随时用codegraph status确认索引统计有未同步文件时它会列出文件名和编辑时间。CodeGraph 日常命令速查命令用途codegraph explore 问题一次返回相关源码 调用路径 影响范围codegraph impact 符号改动前分析该符号影响到的代码codegraph affected src/xx.ts找出受本次改动影响的测试文件codegraph status查看索引统计与待同步文件codegraph upgrade升级到最新版本--check只查不升codegraph telemetry off关闭匿名使用统计一个典型工作流重构某个模块前先跑codegraph impact OrderService.processPayment看调用方分布再在 CI 里用git diff --name-only | codegraph affected --stdin让测试只跑受影响的文件省掉全量回归。CodeGraph 踩坑速查与卸载重置codegraph: command not found安装脚本不改当前 Shell开一个新终端macOS/Linux 还要确认~/.local/bin在PATH里。提示 CodeGraph not initialized该项目还没建过索引先在项目目录里运行codegraph init。索引速度慢node_modules、dist等大目录默认已排除还有其他噪音目录就写进.gitignore或项目根codegraph.json的exclude加--quiet减少输出开销。MCP 报database is locked多半是 0.9 之前的老安装缺内置运行时重装即可再看codegraph status的Journal是否为wal不是的话把项目连同.codegraph/移到本地磁盘。WSL2 里项目在/mnt/c等 Windows 盘MCP 可能报Transport closed在 MCP 环境设CODEGRAPH_NO_DAEMON1或把项目挪到 Linux 原生文件系统Windows 和 WSL 共用一个仓库时给 Windows 侧设CODEGRAPH_DIR.codegraph-win两边各用独立索引避免锁冲突。退出同样直接codegraph uninstall # 完整卸载先展示清单再删除 codegraph uninstall --keep-cli # 只移除 Agent 配置保留 CLI codegraph uninit # 删除当前项目的 .codegraph/ 索引更多细节看仓库内文档安装文档、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），仅供参考