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/codegraph让 AI 助手逐文件翻仓库token 和耐心都在白白消耗。CodeGraph 预先建好整库的代码知识图谱Agent 一次查询就能拿到精准上下文。本文带你完成 CodeGraph 安装从装 CLI、接入 Agent 到给项目建图谱macOS、Linux、Windows 全平台适用。值不值得装先算一笔账Agent 平时靠 grep 加逐个打开文件来理解代码一个问题打出去的工具调用和 token 预算都很可观。CodeGraph 把整库的符号、调用边、依赖关系提前算好Agent 用一次查询换精准上下文。官方在 7 个真实开源项目上的实测指标基线使用 CodeGraph 后工具调用次数最多 43 次减少88%回答速度基线平均快53%Token 消耗基线少62%成本基线平均省44%文件读取次数最多 19 个文件0 装完之后图谱随代码自动保持同步索引不会过期这笔投入只需做一次。动手前 30 秒自检开始之前四个问题快速过一遍答案都清楚就可以动手哪些平台能装macOSIntel x64 / Apple Silicon arm64、Linuxx64 / arm64、Windowsx64 / arm64。安装脚本会自动识别操作系统和 CPU 架构下载对应构建。要 Node.js 吗不要。无需安装 Node.js、无需编译——所有发行版都是自包含构建内置 Node 运行时。环境有什么要求只需网络能访问安装包下载地址即可。数据存在哪索引全部保存在项目本地.codegraph/目录100% 本地运行无需 API 密钥数据不会离开你的机器。挑一条安装路线默认推荐一行脚本脚本自动识别 OS 与架构下载对应构建。环境里已有 Node.js 的话可以改走 npm 路线。路线 A · macOS / Linux 安装命令curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh脚本把程序装到~/.codegraph并在~/.local/bin创建codegraph启动链接。脚本内容见 install.sh。路线 A · Windows 安装命令irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex逻辑与 Shell 脚本一致见 install.ps1。路线 B已有 Node.js 走 npm 安装npm i -g colbymchenry/codegraph⚠️ 安装脚本不会修改当前 Shell 的环境变量。下一步操作前打开一个新终端否则找不到codegraph命令。装完先验证先开新终端安装脚本没有改写当前 Shell 的环境再跑两条命令确认 CLI 可用codegraph version codegraph statusversion显示已安装的版本号status显示索引统计与待同步文件数。如果当前所在目录还没有项目status可能提示项目未初始化——这是正常状态后面建图谱时会处理好。此刻只需确认命令有正常响应就可以继续接入 Agent。把 Agent 接进来在新终端执行安装器它会把 CodeGraph 的 MCP 服务器接入你正在用的 Agentcodegraph install安装器自动检测并配置Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro以及 GitHub CopilotVS Code / Copilot CLI / JetBrains IDE。配置完成后重启你的 AgentMCP 服务即生效。脚本化或 CI 场景用非交互参数含义如下参数说明--yes跳过交互确认自动检测目标并全局安装--targetcursor,claude指定要配置的目标 Agent逗号分隔--init顺便初始化当前项目组合示例codegraph install --targetcursor,claude --yes全部参数说明见 CLI 参考。给项目建图谱每个项目执行一次即可全局安装覆盖所有项目。进入项目目录cd your-project再执行初始化构建代码知识图谱codegraph initcodegraph init一步完成两件事创建本地.codegraph/目录 构建完整的代码图谱。首次索引耗时参考数万文件的 Swift 编译器仓库约 100 秒之后单文件编辑的重新同步只需约 4 秒。索引建好后Agent 检测到项目里存在.codegraph/目录就会自动使用 CodeGraph 工具无需任何额外设置。之后它自己会同步自动同步默认开启无需任何配置靠三条机制原生文件监听macOS FSEvents / Linux inotify / Windows ReadDirectoryChangesW捕获每次文件增删改防抖窗口默认 2 秒把批量编辑合并为一次同步Agent 每次连接时做一次快速对账补上离线期间的改动。你或 Agent 保存文件后几秒内图谱就是最新的不再需要手动同步。随时用这两条命令确认状态codegraph status codegraph version日常高频命令装好后最常打出去的几条命令用途codegraph explore 问题一次返回相关源码 调用路径 影响范围codegraph impact 符号改动前分析受影响的代码codegraph affected src/xx.ts找出受改动的测试文件codegraph upgrade一键升级到最新版本codegraph telemetry off关闭匿名使用统计也可用DO_NOT_TRACK1完整命令列表见 快速上手指南。报错时照这里对看到codegraph: command not found→ 先打开新终端仍不行就确认~/.local/bin在PATH中macOS/Linux。看到 CodeGraph not initialized → 先在项目目录里跑一次codegraph init。看到索引构建慢 → 确认node_modules、dist等大目录被排除默认已排除加--quiet可精简输出。看到 MCP 报database is locked→ 0.9 之前的老版本需要重装获取内置运行时WSL2 中项目放在/mnt/c等 Windows 盘时建议移到 Linux 原生文件系统。看到 WSL2 与 Windows 共用一个仓库 → 双方各建独立索引给 Windows 侧设置环境变量CODEGRAPH_DIR.codegraph-win避免锁冲突。更多细节见 故障排查。想退出用完想撤三个动作各一条命令。uninstall会从所有已配置的 Agent 中移除 CodeGraph 配置并删除 CLI 本体删除前先展示清单可直接执行codegraph uninstall只移除 Agent 配置、保留 CLIcodegraph uninstall --keep-cli只删除单个项目的.codegraph/索引之后重新init可再建codegraph uninit清单式收尾收工前逐条过一遍新终端里codegraph version有正常响应codegraph install已把 MCP 接入你的 Agent 并重启生效每个项目跑过codegraph init.codegraph/图谱已建立自动同步默认开启图谱随代码变化跟进熟记explore/impact/affected三条日常命令想继续了解图谱如何解析、符号如何跨文件关联可读 工作原理 与 知识图谱概念。【免费下载链接】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），仅供参考