让 Claude Code 改一个函数，它改完了，却顺手把另外三个依赖这个函数的地方弄坏了；让 Cursor 重构一段逻辑，它没注意到有一条调用链正好经过这里。原因通常只有一个：AI 不知道你的代码库长什么样，它看到的只是当前打开的几个文件。
GitNexus 是一个开源工具，把代码库索引成知识图谱，每个函数、每条依赖、每条调用链都在图上，再通过 MCP 交给 AI 编程工具使用。它给自己的定位是“Like DeepWiki, but deeper”。那么两者到底差在哪，什么时候该用哪个？
本文适合在中大型项目里用 Claude Code、Codex、Cursor 改代码的开发者。下面先对比 GitNexus 和 DeepWiki 的用途，再讲 GitNexus 的两种用法、安装与 MCP 配置、核心工具、编辑器支持和使用限制。
GitNexus 与 DeepWiki 的核心区别
- DeepWiki 帮你理解代码：生成文档、解释逻辑、回答问题，本质上是把代码翻译成人话；
- GitNexus 帮你分析代码：追踪依赖、调用链和执行流程，建成一张关系图，本质上是把代码变成结构化数据。
打个比方：DeepWiki 给你讲一遍这座城市的历史和风土人情，GitNexus 给你画一张地图，每条路、每个路口、每栋建筑之间的连接都标出来。要做城市规划（重构代码），光知道历史不够，得看地图。
| 对比项 | GitNexus | DeepWiki |
|---|---|---|
| 主要用途 | 分析依赖、调用链、改动影响范围 | 理解仓库、生成说明文档 |
| 产出形式 | 知识图谱 + MCP 工具 | 文档与问答 |
| 适合场景 | 重构、改公共函数、评估改动风险 | 上手陌生仓库、了解整体设计 |
| 接入 AI 编程工具 | 通过 MCP 直接给 Claude Code、Codex 等调用 | 以阅读为主 |
两者并不冲突：先用文档类工具了解项目，再用 GitNexus 在动手前查清影响范围。
GitNexus 的两种用法
| CLI + MCP | Web UI | |
|---|---|---|
| 适合 | 日常开发 | 快速探索 |
| 安装 | npm install -g gitnexus | 不用安装，打开 gitnexus.vercel.app |
| 使用方式 | 本地索引，通过 MCP 接入 AI 编辑器 | 拖入 GitHub 仓库或 ZIP，生成可视化图谱，可以和代码对话 |
| 隐私 | 数据都在本地 | 数据在浏览器内处理 |
两种模式可以打通：本地用 CLI 索引后运行 gitnexus serve，Web UI 会自动连接本地数据，不用重复导入。
安装与 MCP 配置
在项目根目录执行：
npx gitnexus analyze
这一条命令会索引整个代码库的依赖和调用链、自动安装 Agent Skills、注册 Claude Code Hooks，并生成 AGENTS.md 和 CLAUDE.md 上下文文件。
官方 README 目前推荐接着运行 npx gitnexus setup，自动为编辑器写入 MCP 配置。也可以按原文的方式手动添加：
# Claude Code
claude mcp add gitnexus -- npx -y gitnexus@latest mcp
# Codex
codex mcp add gitnexus -- npx -y gitnexus@latest mcp
# Cursor：编辑 ~/.cursor/mcp.json
{
"mcpServers": {
"gitnexus": {
"command": "npx",
"args": ["-y", "gitnexus@latest", "mcp"]
}
}
}
官方还提醒：冷缓存下用 npx 启动 MCP 可能超过 Claude Code 默认约 30 秒的 MCP 超时，先全局安装（npm i -g gitnexus）再运行 gitnexus setup 会写入绝对路径，启动更快。如果 Claude Code 连 MCP 之前就有问题，可以先按接入 AIGoCode 后的四步核对确认工具本身连通。
GitNexus 的核心 MCP 工具
原文介绍了 7 个工具，官方 README 现在已经扩展到 19 个（17 个单仓库工具 + 2 个仓库组工具），最常用的仍是这几个：
- query：混合搜索（BM25 + 语义），按流程分组返回结果；
- context：给一个函数名或类名，返回它的 360 度视图：谁调用了它、它调用了谁、属于哪个模块；
- impact：影响范围分析，改一个函数会波及哪些文件、置信度多少，分层展示；
- detect_changes：读取 git diff，把改动的行映射到受影响的调用链；
- rename：跨文件协调重命名，默认先预览；
- list_repos：列出已索引的仓库；
- cypher：直接执行图查询语句，适合高级用户。
最实用的是 impact 和 detect_changes：改代码之前先问“改这里会影响什么”，AI 把影响范围列出来，再动手。
编辑器支持情况
| 编辑器 | MCP | Skills | Hooks | 支持程度 |
|---|---|---|---|---|
| Claude Code | ✅ | ✅ | ✅ | 完整支持 |
| Cursor | ✅ | ✅ | — | MCP + Skills |
| Codex | ✅ | ✅ | — | MCP + Skills |
| Windsurf | ✅ | — | — | 仅 MCP |
| OpenCode | ✅ | ✅ | — | MCP + Skills |
（表格为原文发布时的情况。）Claude Code 支持最深：除了 MCP 工具和 Agent Skills，还有 PreToolUse Hook 在搜索时自动注入图谱上下文，PostToolUse Hook 在提交后自动重新索引。
其他常用命令
gitnexus setup # 一次性配置所有编辑器的 MCP
gitnexus analyze --force # 强制重新索引
gitnexus serve # 启动本地服务，给 Web UI 用
gitnexus list # 列出已索引的仓库
gitnexus status # 查看当前仓库索引状态
gitnexus wiki # 从知识图谱自动生成项目文档
gitnexus clean # 删除当前仓库索引
gitnexus wiki 可以从知识图谱生成整个项目的文档，支持自定义大模型，相当于在 GitNexus 里补上了一部分 DeepWiki 式的能力。
使用限制
- 许可证：GitNexus 采用 PolyForm Noncommercial 许可，非商业使用免费，公司项目商用前要先确认授权条款；
- 大仓库索引吃内存：官方说明索引过程受内存限制，大型仓库需要更多内存；
- 图谱需要保持新鲜：改动多了要重新
analyze，否则 AI 拿到的是过期结构。
总结
如果你的需求是“看懂项目”，DeepWiki 这类文档工具更直接；如果是“改对代码”，尤其是重构和改公共函数，GitNexus 的知识图谱和 impact、detect_changes 更有用。两者可以配合：先理解，再分析，最后动手。
想在 Claude Code 或 Codex 里试 GitNexus，可以先通过 AIGoCode 接入工具，再按上面的步骤配好 MCP。
参考链接
- GitNexus GitHub 仓库：https://github.com/abhigyanpatwari/GitNexus
- GitNexus Web UI：https://gitnexus.vercel.app
- DeepWiki：https://deepwiki.com