📦 CodeGraph + Codex 安装指南
Windows · 仅使用 npm · 每条命令单独复制
0 前置条件：检查 Node.js 与 npm
在 CMD 或 PowerShell 中运行以下命令，确认已安装 Node.js 和 npm：
node -v && npm -v
如果提示“不是内部或外部命令”，请先到
Node.js 官网 下载 LTS 版本安装（npm 会自动安装）。
1 全局安装 CodeGraph
以管理员身份打开终端（CMD / PowerShell），执行：
npm i -g @colbymchenry/codegraph
⚠️ 若报错 EPERM 或权限不足，请右键终端选择 “以管理员身份运行” 后重试。
2 验证安装
重新打开一个终端（或关闭当前终端再打开），确认 CLI 工具可用：
codegraph --version
如果提示“不是内部或外部命令”，请将 C:\Users\你的用户名\AppData\Roaming\npm 添加到系统环境变量 Path 中，然后重启终端。
3 将 CodeGraph 接入 Codex（自动配置 MCP）
运行以下命令，它会自动检测你电脑上的 Codex 并完成插件配置：
codegraph install
看到 “Installed successfully” 即表示接入完成。
4 在项目中初始化代码图索引
切换到你的项目根目录（例如 D:\my-project），然后构建索引：
cd your-project
codegraph init -i
🔹 -i 参数会立即构建初始代码关系图。如果项目较大，可能需要几秒钟。
🔹 请将 your-project 替换为你的实际项目路径。
✓ 收尾与验证
打开 Codex 并加载你的项目，直接提问代码结构或函数调用关系，CodeGraph 会自动利用构建好的图来回答。
💡 你使用的 cc-switch 切换的 DeepSeek V4 是对话模型，与 CodeGraph 的代码图检索互不冲突，两者配合效果更佳。
⨯ 如何卸载（备用）
如果之后需要移除，依次执行以下两条命令：
codegraph uninstall
npm uninstall -g @colbymchenry/codegraph