CURSOR BYOK

Cursor SSY Key

把 Cursor IDE 变成胜算云 BYOK 客户端。本地 MITM 代理拦截 Cursor 流量,接入胜算云 API Key,即可用胜算云模型替代 Cursor 官方订阅,无需登录 Cursor 账号、无需 Pro 会员。

API 端点
BASE URL复制
https://router.shengsuanyun.com/api/v1
认证方式Bearer YOUR_API_KEY
本地代理监听127.0.0.1:18080
第 1 步

下载安装包

按你的操作系统选择对应安装包下载。当前为首发版本,建议始终使用最新包。

Windows(x64 · .exe 安装包):下载

macOS Apple Silicon(M1/M2/M3/M4 · .dmg):下载

Linux(x86-64 · .deb 安装包):下载 · tar.gz 免安装版

提示:三平台现在都是安装包形式,更稳定。Windows 双击 .exe 按向导安装;macOS 双击 .dmg 把应用拖入 Applications;Linux 用 sudo dpkg -i 安装 .deb,或下载 tar.gz 免安装版。
第 2 步

安装与获取 API Key

Windows:双击下载的 .exe 安装包,按向导完成安装(自动创建开始菜单 / 桌面快捷方式、卸载器)。若 SmartScreen 拦截,点击「更多信息 → 仍要运行」。

macOS:双击下载的 .dmg,在弹出的窗口里把 cursor-ssykey.app 拖入右侧的 Applications 文件夹,然后从启动台打开即可。

首次打开若提示「已损坏 / 无法验证开发者」,执行一次放行:

BASH
复制
xattr -cr /Applications/cursor-ssykey.app

安装完成后可推出(弹出)挂载的 dmg 磁盘,并删除 dmg 安装包。

Linux:推荐用 .deb 安装包(自动处理依赖与桌面入口):

BASH
复制
sudo dpkg -i cursor-ssykey-linux-amd64.deb
sudo apt-get install -f   # 自动补齐 webkit2gtk 等依赖

或下载 .tar.gz 免安装版,手动装依赖后解压运行:

BASH
复制
sudo apt install -y libwebkit2gtk-4.1-0 libgtk-3-0 libayatana-appindicator3-1
tar xzf cursor-ssykey-linux-amd64.tar.gz
chmod +x cursor-ssykey && ./cursor-ssykey

获取胜算云 API Key:https://console.shengsuanyun.com/user/keys

安装与获取 API Key
第 3 步

安装 CA 证书

1

打开 cursor-ssykey,默认进入「概览」页。

2

在「证书状态」区域点击「安装证书」。应用会生成一个本地 MITM CA 并写入系统信任存储。

3

Windows / macOS 会弹系统授权窗口,按提示确认;Linux 需手动将 CA 导入浏览器信任存储。

4

证书状态变为「已安装」即成功。这一步是 MITM 拦截 Cursor 流量的前提。

为什么需要证书? Cursor 走 HTTPS 与官方通信,本地代理必须用自签 CA 才能解密流量并改写到胜算云。该 CA 仅用于本机 Cursor 流量,不会上传、不会影响其他应用。
安装 CA 证书
第 4 步

配置胜算云模型

切换到「模型」页,这是最关键的一步。

1

在「API Key」处填入胜算云 Key,或点「获取密钥」跳转控制台领取。

2

在「模型选择」点「刷新」,应用会实时从胜算云拉取可用模型列表。

3

从下拉框选择一个模型(不支持路由的模型会灰显标注「不支持」)。

4

在「接口选择」里手动选择该模型支持的传输接口:

chat/completions — OpenAI 兼容(多数模型,GPT-5 / DeepSeek / Qwen 等)

messages — Anthropic 兼容(Claude 系列等)

responses — OpenAI Responses(Codex / Research 类模型,部分模型仅此接口可用)

务必手动选接口:应用不会自动猜传输通道。不选或选错会导致「missing base url」或 405 错误。推荐优先选择 messages 接口,对工具调用兼容性更好;不支持 messages 的模型再选 chat/completions
5

(可选)在「高级参数」设置推理强度、服务等级、最大输出 token、思考预算等。

6

点「保存并测试」,向胜算云发一次最小推理请求验证连通性,状态显示「正常」即配置成功。

模型配置:Key / 模型 / 接口 / 测试
第 5 步

启动服务

配置好模型后,回到「概览」页,点击右上角的「启动服务」即可。启动时会自动完成 Cursor 配置(系统代理指向 127.0.0.1:18080、关闭 SSL 校验、强制 HTTP/1.1 等),无需手动应用。

服务状态变为「运行中」即就绪,本地代理开始拦截并转发 Cursor 流量到胜算云。

停止 / 还原:点「停止服务」可关闭代理;如需恢复 Cursor 原始设置,点「还原配置」。
启动服务
第 6 步

在 Cursor 中使用

1

打开 Cursor IDE(确保 cursor-ssykey 服务处于「运行中」)。

2

在 Cursor 的模型选择器中,会出现你配置的胜算云模型。

3

选中该模型,正常发起对话 / Agent / 代码补全即可。流量会经本地代理转打到胜算云。

4

用量可在 cursor-ssykey 的「统计」页查看(token 用量、会话数、近 7 天趋势)。

重要:一切切换模型 / 接口的操作都在 cursor-ssykey 里进行。在 Cursor 中保持默认设置即可,不要在 Cursor 里手动改模型参数,否则可能与本地代理冲突。
小技巧:cursor-ssykey 关闭窗口默认询问「退出 / 最小化到托盘」。选「最小化到托盘」可让代理后台常驻,Cursor 随时可用。
在 Cursor 中选择模型对话
第 7 步

常见问题

报「missing base url」? 没有在「接口选择」里选接口,或选了不支持的接口。回到模型页选一个 chat/completions / messages / responses 再「保存并测试」。

报 405 Not Allowed? 接口路径不对。请确认用的是本页提供最新版安装包(旧版 Anthropic 走 /v1/messages 会 405,新版已修正为 /api/v1/messages)。

对话报 token 超限(Input length exceeds…)? 对话历史过长。应用已内置 20 万 token 自动截断,若仍超限,在 Cursor 里新建会话或清理历史。

证书不信任 / 浏览器报错? 在概览页先「卸载证书」再「安装证书」重新写入,或重启应用。

支持哪些模型? 胜算云全部可路由模型,详见模型列表。仅音频接口的模型暂不支持。

第 8 步

更多资源

SSY AI 助手基于胜算云 API 提供服务
👋 你好!我是 SSY AI 助手,可以帮你解答关于 cursor-ssykey 与胜算云 API 的各种问题。