安装Node.js

访问Node.js官网（https://nodejs.org/）下载并安装LTS版本。安装后，在终端运行 `node --version` 和 `npm --version` 确认安装成功。

如果你已经安装过，可以跳过此步。

体验Web界面（最快上手）

在浏览器中打开 https://gitnexus.vercel.app。这是了解GitNexus核心功能最直接的方式。你可以尝试拖入一个GitHub仓库URL或本地的ZIP代码压缩包，观察它如何生成知识图谱并与代码对话。

首次体验建议选择一个文件数量较少（如个人小项目）的仓库，避免浏览器内存限制。

安装GitNexus CLI

在终端中运行命令：`npm install -g gitnexus`。安装完成后，运行 `gitnexus --version` 或 `gitnexus --help` 验证安装。

如果遇到权限问题，可以尝试使用 `sudo`（Mac/Linux）或以管理员身份运行终端（Windows）。

索引你的第一个代码库

进入一个你想分析的本地Git仓库目录，或者使用 `git clone` 克隆一个公开仓库。在该仓库根目录下，运行 `npx gitnexus index`。此命令会分析代码并构建本地知识图谱数据库。

第一次运行可能会下载一些依赖（如Tree-sitter），请耐心等待。完成后会生成 `AGENTS.md` 等文件。

运行本地MCP服务

在终端中运行 `gitnexus serve`。这将启动一个本地服务器，为AI编辑器提供代码图谱数据。保持此终端运行。

注意终端输出的地址（通常是 http://localhost:3000）。Web UI的“Bridge mode”可以连接到此服务。

运行自动配置

在终端中运行 `npx gitnexus setup`。此命令会尝试自动检测你已安装的编辑器（如Cursor、Claude Code）并配置MCP。

只需运行一次。如果自动配置失败，可以参考下一步进行手动配置。

（可选）手动配置Claude Code

如果自动配置未生效，在Claude Code中，打开设置（Settings），搜索“MCP”，找到配置MCP服务器的部分。添加一个新的服务器配置，名称填“GitNexus”，命令行填写 `npx gitnexus serve`。

具体路径可能因编辑器版本而异，请参考项目README中的代码块示例。

验证集成

在已配置的AI编辑器（如Claude Code）中，打开一个已被GitNexus索引过的项目。尝试向AI提问关于代码架构、依赖关系的问题，观察AI是否能够调用GitNexus的工具（如 `listrepos`, `query`）来获取更准确的答案。

可以尝试提问：“这个项目的主要模块有哪些？”或“修改这个函数会影响到哪些其他地方？”

学习MCP工具

回顾README中“What Your AI Agent Gets”部分的7个工具表格。理解每个工具（如 `query`, `impact`, `detectchanges`）的用途。尝试在AI对话中明确请求使用这些工具。

例如，你可以对AI说：“请使用GitNexus的 `impact` 工具分析一下我刚刚修改的这段代码的影响范围。”

访问上下文资源

在AI编辑器中，尝试打开或引用README中“Resources for instant context”列出的URI，如 `gitnexus://repos` 或 `gitnexus://repo/{项目名}/clusters`。这些是AI可以读取的静态上下文文件。

这些资源文件在你运行 `npx gitnexus index` 时已生成在项目目录中。

连接Web UI与本地服务（Bridge Mode）

确保 `gitnexus serve` 正在运行。然后在Web UI (gitnexus.vercel.app) 中，它应该能自动检测到本地服务器。此时，你可以在Web UI中浏览所有已通过CLI索引的本地仓库，无需再次上传。

这结合了CLI的本地处理能力和Web UI的可视化优势，是推荐的工作流。