夜雨聆风一行命令，让你的 AI 编程助手效率翻倍——CodeGraph 安装配置完全指南
用 Claude Code 写代码时间长了，有个特别明显的感受——
每次你问它"用户登录流程是怎么实现的"，它都会愣半天。不是因为它不知道，而是它得一通猛操作：启动 Explore 子代理 → grep 搜关键词 → glob 找文件 → 一个个 Read 读内容。
整个过程看着 token 哗啦啦地烧，你心里也疼。
特别是大项目。VS Code 那种上万文件的代码库，光探索阶段就能烧掉大半预算。有时候一个简单的架构问题，AI 生成的探索报告比答案还长。
不是 Claude Code 不行，是它每次见你的代码库都像"第一次见"——从零开始摸索。
CodeGraph 就是解决这个问题的。
CodeGraph 到底是什么？
一句话：给你的代码库建一张知识图谱，让 AI 直接查，不用挨个翻文件。
它把你的项目提前扫描一遍，把符号关系、调用链、代码结构都存进本地的 SQLite 数据库。AI 助手需要了解代码的时候，直接查图谱就行，不用 grep、glob、Read 那一套暴力操作。
项目地址：colbymchenry/codegraph
上线不到两周，GitHub 已经 28k+ Star，2.4 万收藏。
效果有多猛？
数据说话。开发者在 7 个真实开源项目上做了对比测试（用 Claude Opus 4.7，每个仓库跑 4 次取中位数）：
| 指标 | 提升幅度 |
|---|---|
| 成本 | 降低 35% |
| Token 消耗 | 减少 57% |
| 速度 | 提升 46% |
| 工具调用次数 | 减少 71% |
具体项目更夸张：
• VS Code（TypeScript，约 10,000 文件）：工具调用减少 85%，token 减少 78%
• Tokio（Rust，约 790 文件）：成本降低 82%，工具调用减少 92%
• Excalidraw（TypeScript，约 640 文件）：成本降低 52%，工具调用减少 96%
说白了，以前 AI 要调用 23 次工具、处理 140 万 token 才能回答的问题，现在 7 次调用、39 万 token 搞定。
安装：真的就一行命令
方式一：一键脚本（推荐，无需 Node.js）
CodeGraph 自带运行时，不用管 Node.js 版本，不用解决依赖冲突。
macOS / Linux：
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
Windows（PowerShell）：
irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex
方式二：npm 安装（Node.js ≥ 18）
npm install -g @colbymchenry/codegraph
或者零安装直接跑：
npx @colbymchenry/codegraph
验证安装
新开一个终端窗口，运行：
codegraph --version
看到版本号就说明装好了。
接入 AI 助手：交互式配置
安装完成后，运行：
codegraph install
**
安装程序会自动检测你装了哪些 AI 工具，支持：
- **Claude Code**
- **Cursor**
- **Codex CLI**
- **OpenCode**
- **Hermes Agent**
- **Gemini CLI**
- **Antigravity**
- **Kiro**
然后它会问你几个问题：
1. 要把 CodeGraph 加到 PATH 吗？（选 Yes，这样 AI 助手才能启动 MCP 服务器）
2. 全局配置（所有项目生效）还是仅当前项目？
3. 为哪些 AI 助手写入配置？
选完之后，它会自动把 MCP 服务器配置和指令文件写到对应位置。
### 非交互式安装（适合脚本/CI）
```bash
# 自动检测，全局安装
codegraph install --yes
# 指定目标工具
codegraph install --target=cursor,claude --yes
# 仅当前项目
codegraph install --target=auto --location=local
# 只看不改（打印配置片段）
codegraph install --print-config codex
日常使用：三步走
第一步：初始化项目
进入你的项目目录，建知识图谱：
cd your-project
codegraph init -i
这会在项目根目录创建 .codegraph/ 文件夹，并完成首次全量索引。
索引速度取决于项目大小。中等项目（几百个文件）一般几秒到几十秒搞定。VS Code 那种万级文件的项目，首次建图可能需要几分钟。
第二步：日常增量同步
你写完代码后，跑一下：
codegraph sync
CodeGraph 用操作系统原生文件监听（macOS 的 FSEvents、Linux 的 inotify），改了哪些文件它一清二楚，只重新索引变化的部分。延迟通常在秒级。
第三步：直接问 AI
现在你可以在 Claude Code / Cursor 里直接问架构问题了：
"用户认证流程是怎么工作的？" "哪些地方调用了 deleteUser 方法？" "重构 UserModel 会影响哪些文件？"
AI 会通过 CodeGraph 的 MCP 接口直接查图谱，不用启动 Explore 子代理去扫文件。
常用命令速查
| 命令 | 干什么 |
|---|---|
codegraph init -i |
初始化项目并建索引 |
codegraph sync |
增量同步变更 |
codegraph status |
查看索引状态（文件数、符号数、边数） |
codegraph index --force |
强制重建索引 |
codegraph query <关键词> |
搜索符号 |
codegraph callers <符号> |
查谁调用了这个符号 |
codegraph callees <符号> |
查这个符号调用了谁 |
codegraph impact <符号> |
分析变更影响范围 |
codegraph serve --mcp |
手动启动 MCP 服务器 |
codegraph upgrade |
升级到最新版 |
codegraph uninstall |
从所有工具中移除 |
支持的语言和框架
20+ 种语言： TypeScript、JavaScript、Python、Go、Rust、Java、C#、PHP、Ruby、C、C++、Swift、Kotlin、Dart、Lua、Svelte、Liquid、Pascal/Delphi……
14 种框架路由感知： Express、Django、Flask、FastAPI、Laravel、Rails、Spring、Gin、Axum、ASP.NET、React Router、SvelteKit、Vue/Nuxt、Cargo Workspaces。
这意味着你问"这个 URL 对应的处理函数在哪"，它能直接给你答案——因为它知道路由文件和处理函数之间的映射关系。
几个要注意的地方
1. 小项目没必要上。
如果你就写了个几十行的小脚本，CodeGraph 属于杀鸡用牛刀。它适合的是几百文件以上的中型项目，或者那种你接手别人代码、需要快速理解架构的场景。
2. 首次建图要等。
大项目第一次 codegraph init -i 需要扫描整个代码库，可能需要几分钟。别慌，后面的 codegraph sync 都是增量更新，秒级完成。
3. 切换分支后建议重建。
如果你 git checkout 切到了差异很大的分支，跑一下 codegraph index --force 重建索引，避免旧数据干扰。
4. 100% 本地，不用担心代码泄露。
所有索引数据都在你机器上的 SQLite 数据库里，不需要 API key，不需要联网。对代码安全有要求的公司和团队可以放心用。
总结
CodeGraph 做的事情很聚焦：让 AI 编程助手不再"盲人摸象"。
它不改变你现有的工作流，不让你学新工具。你只需要装一次、配置一次，然后像往常一样跟 Claude Code / Cursor 对话就行。
区别是：AI 回答更快了、token 花更少了、你不用看着它反复读同一个文件干着急了。
一行命令的事，试试呗。
curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
