Guide
Cursor 接入教程
Cursor 需切换到 Editor 窗口、安装 CodePass VSIX 插件并启用 Patch。按下面 8 步完成接入，约 3 分钟。
从 Agent 窗口切换到 Editor 窗口
Cursor 默认打开的是 Agent 窗口（全屏对话界面）。安装插件需要在 Editor 窗口中操作。选择菜单 File - Open Editor Window，或在右上角直接点击 Editor Windows，也可以使用快捷键（Windows：Ctrl + Shift + N；macOS：⌘ + Shift + N）直接打开一个新的 Editor 窗口。
切换到 Editor 窗口
展示通过 File - Open Editor Window 菜单、右上角 Editor Windows 入口或快捷键（Windows：Ctrl + Shift + N；macOS：⌘ + Shift + N）从 Agent 窗口切换到 Editor 窗口。
找到并打开扩展中心
在 Editor 窗口的活动栏中，点击「扩展」图标（四方块图标）打开扩展面板，或使用快捷键（Windows：Ctrl + Shift + X；macOS：⌘ + Shift + X）。后续将在这里安装 CodePass 插件。
打开扩展中心
在 Editor 窗口活动栏点击四方块「扩展」图标（或按快捷键 Windows：Ctrl + Shift + X；macOS：⌘ + Shift + X）打开扩展面板。
下载并安装 CodePass 插件
在用户中心或本页，拖入 Cursor 窗口完成安装。安装后请完全退出并重启 Cursor，侧栏才会出现 CodePass 插件入口。
下载 VSIX 并拖入 Cursor 安装
展示用户中心「下载插件」按钮，以及将 codepass-v0.4.x.vsix 拖入 Cursor 窗口时的安装提示。安装完成后需完全退出 Cursor 再重新打开。
在用户中心复制接入凭证
打开 CodePass 用户中心仪表盘，展开 Cursor 接入卡片，复制登录邮箱与 128 位 Token。Token 较长，请用复制按钮，不要手打。
用户中心 Cursor 接入卡片
框选 Cursor 插件卡片，并标注「下载插件」按钮、登录邮箱字段、128 位 Token 及复制按钮。
在插件面板登录 CodePass
在 Cursor 侧栏打开 CodePass 插件，使用 CodePass 账户邮箱和密码登录。登录成功后插件会完成环境自检，并显示「一键启用 CodePass」按钮。
CodePass 插件登录页
展示插件侧栏登录界面：邮箱、密码输入框与登录按钮；登录后可见环境自检列表（Cursor 安装路径、插件版本、网络、Patch 状态等）。
一键启用 Patch
点击「开始使用」。插件会写入本地凭证、注入 workbench.js patch，并配置出口节点。启用过程中请勿关闭 Cursor；完成后按提示重启即可无感切换。
点击「开始使用」启用 Patch
登录后在 CURSOR 补丁区域点击「开始使用」，插件会写入本地凭证、注入 workbench.js patch，并配置出口节点。
启用成功并重启 Cursor
启用完成后按提示重启 Cursor，Patch 状态变为「已启用」，即可无感切换账号。
检查网络设置
在使用前最后做一次检查，确保插件能正常运行。在 Cursor 右上角点击齿轮图标，打开 Cursor 设置；在左侧设置菜单中找到 Network，把 HTTP Compatibility Mode 修改为 HTTP/2。
打开 Cursor 设置
在 Cursor 右上角点击齿轮图标，点击打开 Cursor 设置。
将 HTTP Compatibility Mode 改为 HTTP/2
在左侧设置菜单中找到 Network，把 HTTP Compatibility Mode 修改为 HTTP/2。
测试 AI 调用
在 Cursor 中打开任意项目，使用 Chat 或 Composer 提问。能正常回答且插件主面板显示额度变化，说明接入成功。经济模型走 Composer 池，标准及以上模型走共用 API 额度池。
Cursor Chat 测试成功
展示 Cursor Chat 中提问「帮我看一下这个项目的入口文件在哪里」并收到正常回答；侧栏插件面板可见 API 额度或 Composer 使用情况更新。
常见问题
接入或使用过程中遇到报错，可先对照以下情况排查。