Cursor助手：在 Cursor 使用其他模型

它解决什么问题#

Cursor 自带的模型列表是平台侧的，想用自己在别处买到的额度、或者公司内网提供的兼容端点，通常只能放弃 Agent 那一套工具链。cursor-byok 的思路是在你本机插一层网关：Cursor 以为自己在跟官方后端说话，实际请求被本地服务改写协议后转发到你配置的上游，同时完整保留 Agent 工具调用、Skills 与 MCP 能力。

它是运行在本机的服务，API Key、模型配置和应用设置都存在本地；最新版本 v1.0.1（2026-09-20），原生支持 Windows。

能力清单#

接入五步#

1. 下载并安装对应系统的最新版本；
2. 启动 cursor-byok，打开 Cursor 配置，按提示初始化本地 CA（证书颁发机构）；
3. 在模型设置里填写服务地址、API Key 和模型名称，保存并运行测试；
4. 确认测试通过后，保持 cursor-byok 处于运行状态；
5. 完全退出并重新启动 Cursor，新开一个对话，在模型列表里手动选择已配置的模型。

协议别选错#

每个模型配置都是一条独立的上游通道，可以单独设协议、凭据和生成参数：

数据边界#

请求链路是：Cursor 客户端（Agent 请求与工具结果）→ cursor-byok 本地服务（协议适配与转发）→ 你配置的模型 API。

也就是说密钥和配置不出本机，但模型请求内容仍然会发送给你选择的上游服务商，该遵守的隐私政策和计费规则一条都不会少。把它当成本机的路由层，而不是隐私沙箱。

适合谁#

• 手上已有 API 额度或自建兼容端点，不想被平台内置模型列表限制；
• 需要在 Cursor 里跑 MCP、Skills 和工具调用，同时又要换模型来源；
• 想看清每次对话的 Token 消耗、缓存命中率和费用估算。

反过来说，它多了一层本地服务和自签 CA，排查问题时会比纯官方链路多几个环节；如果你根本不需要自定义模型，就没有引入它的理由。