CodeGraph 安装教程：一行命令部署本地代码知识图谱

CodeGraph 安装教程一行命令部署本地代码知识图谱【免费下载链接】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 助手查一个跨文件的 bug它通常先 grep 两遍、再逐个读文件工具调用堆了又堆又慢又烧钱。CodeGraph 把整库的符号、调用边和依赖预先建成一张图一次查询就能拿到精准上下文。这份 CodeGraph 安装教程从拿到 CLI 到给项目建图照着敲完即可。值不值先看清这组实测数据官方在 7 个真实开源项目上的结论接入 CodeGraph 后Agent 的工具调用和 token 消耗都明显下降。对比项没有 CodeGraph接入 CodeGraph工具调用次数最高 43 次减少 88%响应速度基线平均快 53%Token 用量基线减少 62%单次提问成本基线平均省 44%读取文件数最多 19 个降到 0而且你保存文件后图谱会自动跟上索引不会过期不用手动维护。安装前自检确认机器在支持范围内三个桌面平台都提供自包含构建内置 Node 运行时装它之前不用先装 Node.js只要网络能访问安装包下载地址即可。平台支持架构安装渠道macOSIntel (x64) / Apple Silicon (arm64)Shell 脚本或 npmLinuxx64 / arm64Shell 脚本或 npmWindowsx64 / arm64PowerShell 脚本或 npm索引数据全部保存在项目里的.codegraph/目录中不离开你的机器。安装流程三个环节整个流程就三件事拿 CLI、把 Agent 接上、给项目建图。一行命令装好 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.js 的话走 npm 也一样npm i -g colbymchenry/codegraph脚本会把程序装到~/.codegraph并在~/.local/bin建一个codegraph链接。⚠️ 安装脚本不会修改当前 Shell 的环境变量。打开一个新终端再执行下一步否则会提示找不到codegraph命令。MCP 自动接入你的 AI这一步只负责把你机器上的 Agent 接进 CodeGraph不碰代码codegraph install它会检测本机已安装的 Agent 并写入各自的 MCP 配置覆盖 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro 以及 GitHub CopilotVS Code / CLI / JetBrains。跑完后重启 AgentMCP 服务才生效。脚本化或 CI 场景可以带上参数说明见 CLI 参考codegraph install --yes codegraph install --targetcursor,claude --yes给项目建索引codegraph init一条命令同时完成建目录和建图每个项目跑一次即可cd your-project codegraph init官方给过一个量级参考数万文件的 Swift 编译器仓库首次索引约 100 秒。Agent 检测到项目里有.codegraph/目录就会自动启用 CodeGraph 工具不用再做任何配置。自动同步默认开启原生文件监听macOS FSEvents / Linux inotify / Windows ReadDirectoryChangesW捕获每次改动2 秒防抖把批量编辑合并成一次同步Agent 每次连接时还会再对账一次。30 秒验证是否装对两条命令就能确认codegraph version codegraph status判断标准很简单version能打出具体版本号、status显示当前项目的索引统计且没有卡在待同步文件上就说明装好了。日常速查装完之后日常就靠这几条命令命令用途codegraph explore 问题一次返回相关源码、调用路径和影响范围codegraph impact 符号改动前分析受影响的代码codegraph affected 文件找出受改动的测试文件codegraph status查看索引统计与待同步文件codegraph upgrade一键升级到最新版codegraph uninstall从各 Agent 移除配置并卸载 CLIcodegraph uninit删除当前项目的.codegraph/索引踩坑速查高频问题基本都在下面这张表里对号入座即可现象原因解法codegraph: command not found当前终端没刷新 PATH打开新终端确认~/.local/bin在PATH中提示 CodeGraph not initialized该项目还没建过索引在项目目录跑codegraph init索引速度慢大目录没被排除确认node_modules、dist已排除gitignore 的默认排除加--quiet减少输出MCP 报database is locked0.9 之前的老版本没有内置运行时或网络盘上 WAL 失效重装最新版把项目含.codegraph/移到本地磁盘WSL2 与 Windows 共用仓库互相锁死两侧指向同一个.codegraph/Windows 侧设CODEGRAPH_DIR.codegraph-win两边各用独立索引回到三个环节一行命令装 CLI、codegraph install接上 Agent、每个项目codegraph init建图之后的同步全自动。想弄清符号是怎么跨文件串起来的可以翻 工作原理 和 知识图谱概念 两篇文档。【免费下载链接】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），仅供参考