Cursor 接入教程

Cursor 需切换到 Editor 窗口、安装 CodePass VSIX 插件并启用 Patch。按下面 8 步完成接入，约 3 分钟。

接入前须知

- **开发工具**：Cursor - **配置入口**：CodePass 插件面板 - **接入字段**：登录邮箱、128 位 Token - **额度消耗**：Composer 池 + 共用 API 额度池 **视频教程（推荐）**：若你更习惯边看边操作，可先观看「Cursor 完整接入视频教程」（约 3 分钟），再对照下方文字步骤完成配置。视频与本文步骤一一对应，涵盖窗口切换、插件安装、登录启用 Patch、网络检查与测试调用全流程。

从 Agent 窗口切换到 Editor 窗口

Cursor 默认打开的是 Agent 窗口（全屏对话界面）。安装插件需要在 Editor 窗口中操作。 选择菜单 **File → Open Editor Window**，或在右上角直接点击 **Editor Windows**，也可以使用快捷键直接打开一个新的 Editor 窗口： - **Windows**：`Ctrl + Shift + N` - **macOS**：`⌘ + Shift + N`

打开扩展中心

在 Editor 窗口的活动栏中，点击「扩展」图标（四方块图标）打开扩展面板，或使用快捷键： - **Windows**：`Ctrl + Shift + X` - **macOS**：`⌘ + Shift + X` 后续将在这里安装 CodePass 插件。

下载并安装 CodePass 插件

1. 在 CodePass 用户中心或插件下载页下载最新 `.vsix` 文件。 2. 将 `.vsix` 拖入 Cursor 窗口完成安装（也可在扩展面板使用 **Install from VSIX**）。 3. 安装后请**完全退出并重启 Cursor**（不是只关窗口），侧栏才会出现 CodePass 插件入口。

在用户中心复制接入凭证

1. 打开 CodePass 用户中心仪表盘。 2. 展开 **Cursor 接入**卡片。 3. 复制**登录邮箱**与 **128 位 Token**。 Token 较长，请用复制按钮，**不要手打**。

在插件面板登录 CodePass

1. 在 Cursor 侧栏打开 CodePass 插件。 2. 使用 CodePass 账户**邮箱和密码**登录。 3. 登录成功后插件会完成环境自检，并显示「一键启用 CodePass」或「开始使用」按钮。 环境自检通常包括：Cursor 安装路径、插件版本、网络、Patch 状态等。

一键启用 Patch

1. 在 **CURSOR 补丁**区域点击「开始使用」。 2. 插件会写入本地凭证、注入 `workbench.js` patch，并配置出口节点。 3. 启用过程中**请勿关闭 Cursor**；完成后按提示**完全退出并重新打开 Cursor**。 4. 重启后确认 Patch 状态为「**已启用**」，即可无感切换。

测试 AI 调用

1. 在 Cursor 中打开任意项目。 2. 使用 Chat 或 Composer 提问。 3. 能正常回答且插件主面板显示额度变化，说明接入成功。

故障检测

启用 Patch 并重启 Cursor 后，建议最后做一次故障检测，确认是否接入成功： 1. 在 Cursor 侧栏打开 CodePass 插件，进入「**故障检测**」。 2. 点击「**开始检测**」，等待各项检测完成。 3. 确认 **Cursor 补丁**、Worker API、网络连通等关键项均为通过。 若检测提示异常（如 HTTP/1.1 降级、本地代理冲突、补丁未生效等），请对照 「Cursor 接入常见问题」 逐项排查。