CodeGraph：给 Coding Agent 一张代码地图

💡 核心一句话：CodeGraph 把代码库预先索引成本地知识图谱，让编程智能体先查「代码地图」，再决定读哪些文件——少翻文件、少烧 Token、改得更准。开源地址：https://github.com/colbymchenry/codegraph ｜ 本文据同名讲解视频整理，配图重新绘制。文章目录🚀 快速上手 · 安装与使用一、开篇 · 为什么值得聊二、痛点 · Agent 为什么会「迷路」三、核心思路 · 把「认路」变成工程索引四、工作机制 · 四步：抽取 / 存储 / 解析 / 同步① 抽取（Extract）② 存储（Store）③ 解析 / 连接（Resolve）④ 同步（Sync）五、MCP 工具层 · 先查关系，再读源码六、和普通代码搜索的区别七、官方最新 Benchmark八、语言与框架支持九、安装与接入（两层心智）十、本地优先与数据边界十一、生态定位 · 它补哪一块十二、它会改变什么（4 点）十三、边界与局限十四、为什么此刻火 · 适合哪些项目十五、下一步 · Agent 工程的工作流十六、一句话收尾🚀 快速上手 · 安装与使用三步走：① 装 CLI → ② 接入 Agent → ③ 项目里建索引；之后 Agent 会自动「先查图，再读源码」。无需 API key，索引只存本机。① 安装 CLI（任选其一）# macOS / Linuxcurl-fsSLhttps://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh|sh# Windows PowerShellirm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1|iex# 有 Node 环境：npx 零安装 或 全局安装npx @colbymchenry/codegraphnpmi-g@colbymchenry/codegraph② 接入你的 Agent（装好后记得重启Claude Code / Cursor / Codex CLI 等）npx @colbymchenry/codegraph# 交互式，自动检测已装的 AI 助手codegraphinstall--yes# 非交互：自动检测 + 全局安装codegraphinstall--target=cursor,claude--yes# 指定目标codegraphinstall--target=auto--location=local# 装到项目本地③ 在项目里建索引cdyour-project codegraph init-i# 构建知识图谱，生成 .codegraph/ 目录看到.codegraph/目录后，Agent 即自动调用 CodeGraph 工具。管理命令：codegraph uninit移除项目索引、codegraph uninstall