CodeGraph 安装指南3 条命令、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 读代码别再靠 grep 了。大多数 Agent 现在理解代码的方式是逐个文件翻、正则搜关键字慢且烧 token。CodeGraph 的做法相反它先把整个仓库的符号、调用边、依赖关系建成一张本地知识图谱Agent 一次查询就能拿到精准上下文全程 100% 本地运行、无需 API 密钥。官方在 7 个真实开源项目上的实测结果指标无 CodeGraph有 CodeGraph工具调用次数最多 43 次减少88%回答问题速度基线平均快53%Token 消耗基线少62%成本基线平均省44%文件读取次数最多 19 个文件0 次承诺很具体装好并接入只需要3 条命令从第一条命令执行到图谱可查5 分钟内完成之后零维护——索引自动同步你只管写代码。装好 CLI 并验证版本本节解决机器上能不能装、装完怎么确认的问题。先确认支持范围。所有发行版都是自包含构建内置 Node 运行时无需安装 Node.js、无需编译只要网络能访问安装包下载地址即可平台架构安装方式macOSIntel (x64) / Apple Silicon (arm64)Shell 脚本 或 npmLinuxx64 / arm64Shell 脚本 或 npmWindowsx64 / arm64PowerShell 脚本 或 npm安装脚本会自动识别操作系统和 CPU 架构下载对应构建。macOS 和 Linux 用这条命令脚本详见 安装脚本curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh程序会装到~/.codegraph并在~/.local/bin创建codegraph启动链接。Windows 在 PowerShell 中执行脚本逻辑一致见 安装脚本irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex机器上已有 Node.js 的话也可以直接用 npm 装npm i -g colbymchenry/codegraph⚠️ 安装脚本不会修改当前 Shell 的环境变量。请打开一个新终端再执行下面的验证命令否则会出现codegraph: command not found。验证只需一条命令确认版本号正常输出即代表装好了codegraph version一条命令把 MCP 接入你的 Agent本节解决Agent 怎么用上 CodeGraph的问题。在新终端里运行安装器它会把 CodeGraph 的 MCP 服务器写进你正在用的 Agentcodegraph install安装器自动检测并配置Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro以及 GitHub CopilotVS Code / Copilot CLI / JetBrains IDE完成后重启 Agent 使 MCP 服务生效。这一步只接 Agent不索引任何代码。脚本化或 CI 环境需要非交互参数时codegraph install --yes # 自动检测全局安装 codegraph install --targetcursor,claude --yes # 指定目标 codegraph install --yes --init # 顺便初始化当前项目各参数完整说明见 CLI 参考。构建第一张代码图谱然后忘记它本节解决项目图谱怎么建、之后要不要手动同步的问题。每个项目跑一次 init 即可cd your-project codegraph 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安装脚本不改当前 Shell 环境变量打开新终端确认~/.local/bin在PATH中macOS/Linux提示 CodeGraph not initialized项目还没建过索引在项目目录里跑codegraph init索引速度慢大目录未被排除或输出过多node_modules、dist默认已排除用--quiet减少输出MCP 提示 database is locked老版本0.9 之前缺内置运行时WSL2 项目在/mnt/c等 Windows 盘上锁行为异常重装获取内置运行时WSL2 建议把项目移到 Linux 原生文件系统WSL2 与 Windows 共用一个仓库两侧索引锁互相冲突Windows 侧设置环境变量CODEGRAPH_DIR.codegraph-win各自建独立索引更多细节见官方 故障排查文档。想撤命令也是现成的反悔只需一条命令会从所有已配置的 Agent 中移除 CodeGraph 配置并删除 CLI 本体删除前先展示清单codegraph uninstall # 完整卸载 codegraph uninstall --keep-cli # 只移除 Agent 配置保留 CLI codegraph uninit # 删除单个项目的 .codegraph/ 索引收尾回顾一遍一行命令装好 CLIcodegraph install接入 Agentcodegraph init建好图谱自动同步接管剩下的事——3 条命令5 分钟之后零维护。工具调用减少 88%、文件读取降为零这笔账算得过来。想深挖图谱如何解析、符号如何跨文件关联看 工作原理 和 知识图谱概念 两篇文档。【免费下载链接】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），仅供参考