CodeGraph 安装教程不装 Node.js5 分钟把 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 编程工具的本地代码知识图谱它预先建好整个仓库的符号、调用边与依赖关系图Agent 一次查询就能拿到精准上下文而不是靠 grep 和逐个读文件。这篇 CodeGraph 安装教程带你走完从装 CLI、接入 Claude Code / Cursor / Codex 等 Agent到在真实项目里跑通索引的全部流程。只要你熟悉基本终端操作全程大约 5 分钟索引 100% 本地运行、无需 API 密钥。装完 CodeGraph 之后Agent 的工作方式会怎么变以前 Agent 回答某段逻辑怎么工作要先 grep、再 ls、再逐个 Read花掉大量工具调用和 token 后才开始真正干活。接上 CodeGraph 后它直接查图一次调用返回相关源码原文、符号间的调用路径、以及改动的波及范围。官方在 7 个真实开源仓库上的复测7 种语言、每臂 4 次取中位数工具调用次数平均减少88%最多 43 次降到 1–4 次回答速度平均快53%token 消耗平均少62%成本平均省44%7 个仓库中 Agent 的文件读取次数全部降为 0之后你或 Agent 每次保存文件文件监听器会在几秒内自动把改动同步进图谱不需要再手动重建索引。开始之前平台、架构与前置条件所有发行版都是自包含构建内置 Node 运行时无需安装 Node.js、无需编译网络能访问安装包的下载地址即可索引数据存在项目本地的.codegraph/目录不离开你的机器平台架构安装方式macOSx64 / arm64Shell 脚本 或 npmLinuxx64 / arm64Shell 脚本 或 npmWindowsx64 / arm64PowerShell 脚本 或 npm获取 CodeGraph CLI不装 Node 怎么装按你的系统选一条命令执行即可。安装脚本会自动识别操作系统和 CPU 架构下载对应构建。macOS / LinuxTerminalcurl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh装到~/.codegraph并在~/.local/bin创建codegraph启动链接。WindowsPowerShellirm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex逻辑与 Shell 脚本一致自动下载对应 Windows 构建。已有 Node.js走 npmnpm i -g colbymchenry/codegraph包自带运行时任意 Node 版本均可无原生编译步骤。⚠️ 安装脚本不会修改当前 Shell 的环境变量请打开一个新终端再做下一步否则提示找不到codegraph命令。接入你的 AI 工具一条命令配好 MCP在新终端里运行codegraph install这一步才是把 CodeGraph 真正接进你的 Agent它自动检测已安装的 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro 和 GitHub CopilotVS Code / CLI / JetBrains把 CodeGraph 的 MCP 服务器写进各自的配置。注意它只接线、不建索引——代码图谱是下一步codegraph init的事。脚本化或 CI 环境用非交互参数codegraph install --yes --targetcursor,claude怎么验证生效重启你的 Agent问一个结构性问题比如登录流程是怎么走的。Agent 调用了codegraph_explore而不是满屏 grep就说明 MCP 已接上。 也可以npx colbymchenry/codegraph跳过安装直接跑安装器。在真实项目里跑起来一条命令建好索引进入任意一个项目目录cd your-project codegraph initcodegraph init同时创建本地.codegraph/目录并构建完整图谱。一次全局安装覆盖所有项目每个项目只需init一次。算成功的三个信号项目里出现了.codegraph/目录含codegraph.dbcodegraph status能列出文件、符号等统计且没有待同步条目随便改一个文件并保存几秒后再看状态图谱已包含改动解析跑在 Rust 内核上源码在codegraph-kernel/量级参考2.7 万文件的 Swift 编译器仓库首次索引约 100 秒之后单文件编辑的重新同步约 4 秒。日常怎么用从场景到命令想搞清楚某个模块怎么工作codegraph explore How does a request reach the database?一次返回相关源码、调用路径和影响范围改一个符号前评估波及面codegraph impact SymbolName改完代码要知道该跑哪些测试codegraph affected src/utils.ts也可用git diff --name-only | codegraph affected --stdin查谁调用了某个函数codegraph callers SymbolName查索引状态、升级版本codegraph status、codegraph upgrade不想上报匿名使用统计就codegraph telemetry off卡住了怎么办现象 → 原因 → 处理codegraph: command not found→ 安装脚本不改当前 Shell → 打开新终端macOS/Linux 再确认~/.local/bin在PATH中提示 CodeGraph not initialized → 项目还没建过索引 → 在项目目录先跑codegraph init索引速度慢 → 大目录没被排除 →node_modules、dist等默认已排除其他大目录写进.gitignore或codegraph.json的excludeMCP 报database is locked→ 0.9 之前的旧版没有内置运行时 → 重装最新版项目若放在 WSL2 的/mnt/c下移到 Linux 原生文件系统Windows 与 WSL2 共用一个仓库 → 两边不能共用同一个.codegraph→ Windows 侧设置CODEGRAPH_DIR.codegraph-win各建各的索引卸载与重置改主意也简单codegraph uninstall会把 CodeGraph 从所有配置过的 Agent 中移除并删掉 CLI删除前先展示清单加--keep-cli则只摘 Agent 配置单个项目的索引用codegraph uninit删除。想继续往下看工作原理how-it-works.md 讲了图谱如何解析、符号如何跨文件关联CLI 参考cli.md 列出了全部命令和参数。装完这一个下午之后每次让 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辅助生成（AIGC），仅供参考