💡 核心一句话: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