一、方案概述
本文介绍在Cursor 免费版中对接 DeepSeek、智谱、阿里百炼、小米 Mimo 等国内大模型的完整流程。整套方案依托 BYOK 中转工具实现,无需开通 Cursor Pro 付费会员,也可免账号登录使用,适配代码编写、问题排查、逻辑分析等开发场景。
Cursor 原生默认调用境外模型,存在 Token 消耗快、网络不稳定等问题;通过本方案接入国内大模型 API,可提升访问稳定性、降低使用成本。
二、版本与基础规则
2.1 工具版本
当前使用配套工具版本:cursor-byok v0.0.33历史版本迭代说明:
- v0.0.31:新增 GPT 5.5 图像生成相关能力;
- v0.0.21:优化助手自举逻辑,提升整体运行稳定性。
2.2 核心使用规则
- 仅使用 Cursor 免费基础版,无需订阅 Pro 会员;
- 支持免账号登录运行 Cursor 客户端;
- BYOK 为中转服务,必须保持后台常驻,中断后模型调用将失效。
三、资源下载
3.1 统一下载地址
百度网盘:https://pan.baidu.com/s/1uOY1JKUy-iFW98ENiRFv8Q?pwd=5555 提取码: 5555
3.2 文件清单
网盘内包含全平台安装包与对应 BYOK 中转工具:
- Windows 客户端:
CursorUserSetup-x64-3.7.21(cursor安装包).exe - Windows 版 BYOK:
cursor-byok-0.0.33-windows-amd64.zip - Linux 版 BYOK:
cursor-byok-0.0.33-linux-amd64.tar.gz - macOS 苹果芯片版 BYOK:
cursor-byok-0.0.33-macos-arm64.tar.gz - macOS 英特尔芯片版 BYOK:
cursor-byok-0.0.33-macos-amd64.tar.gz
四、Cursor 客户端安装(Windows 为例)
- 双击运行
CursorUserSetup-x64-3.7.21(cursor安装包).exe安装程序; - 按照安装向导执行,可自定义安装路径,建议安装至非系统分区;
- 安装完成后取消 “立即启动” 选项,暂时关闭安装程序,优先部署 BYOK 工具。
Linux、macOS 平台可参照对应系统常规软件安装流程操作。
五、BYOK 中转工具部署(核心步骤)
BYOK 是连接 Cursor 与国内大模型 API 的中转服务,所有自定义模型调用均依赖该工具。
- 根据自身操作系统,解压对应版本的 BYOK 压缩包至纯英文路径(禁止中文、空格、特殊字符);
- 检查解压目录内文件完整性,确保主程序与依赖文件齐全;
- 启动运行:
- Windows:双击目录内可执行程序,弹出运行窗口后保持后台常驻,不要关闭;
- Linux /macOS:进入解压目录,在终端执行启动命令,保持终端窗口运行。
- 工具启动后可查看服务状态、接口统计、缓存、调用数据等信息。
六、国内大模型前置准备
该配置方式为通用方案,兼容 DeepSeek、智谱 AI、阿里百炼、小米 Mimo 等主流国内大模型。
6.1 账号与 API Key 获取
- 打开对应大模型官方网站,完成账号注册并登录;
- 进入开发者控制台 / API 管理页面,创建并复制
API Key; - 多数平台新用户提供体验额度,正式使用可按需充值,调用费用遵循平台官方计费规则。
6.2 关键参数整理
配置前提前记录两项核心参数,参数以各平台官方文档为准:
- API Base URL:模型接口基础地址;
- Model ID:模型唯一标识名称。
6.3 主流模型参考参数
6.1 DeepSeek
- API Base URL:
https://api.deepseek.com - 可用模型:
deepseek-v4-flash、deepseek-v4-pro - 补充说明:原
deepseek-chat、deepseek-reasoner将于 2026/07/24 停用。
6.2 智谱 GLM
- 接口地址:
https://open.bigmodel.cn/api/anthropic - 示例模型 ID:
glm-5.1
6.3 阿里百炼
- 接口地址:
https://token-plan.cn-beijing.maas.aliyuncs.com - 示例模型 ID:
qwen3.7-max - 推荐上下文窗口:256000
6.4 小米 Mimo
- 接入类型:Anthropic 协议
- 接口地址:
https://token-plan-cn.xiaomimimo.com - 示例模型 ID:
mimo-v2.5-pro
七、Cursor 内自定义模型配置(图形界面,全平台通用)
7.1 调出配置入口
- 启动 Cursor,选择免账号方式进入主界面:
- 打开命令面板:
- Windows / Linux:快捷键
Ctrl + Shift + P - macOS:快捷键
Cmd + Shift + P
- Windows / Linux:快捷键
- 在搜索框输入
Change Model,选择Configure Custom Model(配置自定义模型)。
7.2 填写模型配置项
在模型编辑页面逐项填写参数,各字段说明如下:
- 显示名称:自定义模型别名(如 DeepSeek、智谱 GLM,用于界面展示);
- 模型标识:填写对应平台 Model ID;
- 接口地址:填写 API Base URL;
- 访问密钥:粘贴已获取的 API Key;
- 上下文窗口:可按需求填写,留空则使用默认值;
- 最大输出 Token:按需设置,留空使用默认值;
- 推理强度:默认选择 “中”;
- 接口端点:常规填写
/v1/chat/completions; - 额外参数、自定义请求头:无特殊需求可留空。
7.3 保存与测试
- 参数填写完毕后,点击「保存并测试」;
- 测试通过后,刷新 Cursor 模型列表,即可选中并使用已配置的大模型;
- 补充说明:Cursor 官方对话与自定义模型对话上下文相互独立,无法接续会话,新建对话即可正常使用。
八、进阶功能使用技巧
8.1 浏览器与 MCP 工具配置
进入 Cursor 设置 → Tools & MCPs 面板,可管理 MCP 服务、浏览器自动化权限;支持配置工具自动运行规则、域名白名单等参数,按需开启对应功能即可。
8.2 子代理模型设置
进入Agents相关设置页面,可单独配置子代理使用的模型,支持继承主模型或单独指定模型。
九、使用技巧
9.1Cursor内部的浏览器和MCP怎么用 ?
按照下图配置:
9.2如何设置子代理的模型?
格式:
9.3GLM智谱官方 CodePlan
接口地址 https://open.bigmodel.cn/api/anthropic
格式:
9.4小米 mimo 模型
推荐接入方式为 Anthropic
格式:
十、常见问题排查
10.1 模型无响应、请求超时
- 检查 BYOK 中转工具是否正常运行,确保进程未关闭;
- 核对 API 地址、API Key、Model ID,清除多余空格与非法字符;
- 测试本地网络,确认可正常访问大模型官方接口。
10.2 401 密钥认证失败
- 检查 API Key 是否完整复制,避免字符缺失;
- 登录模型后台,查看密钥状态、账号剩余额度;
- 销毁旧密钥,重新生成并替换配置。
10.3 接口返回 404 错误
原因为 API Base URL 填写错误,逐字对照官方文档修正接口地址。
10.4 Cursor / BYOK 程序启动闪退
- 检查安装、解压路径,路径中不能包含中文、空格、特殊字符;
- Windows 系统可右键程序,选择「以管理员身份运行」;
- 若文件损坏,重新下载压缩包解压部署。
十一、补充说明
- 授权说明:本方案全程使用 Cursor 免费版,无需付费订阅 Pro,也可跳过账号登录步骤;
- 费用划分:大模型调用产生的 Token 费用、流量费用,由对应模型平台收取,与 Cursor、BYOK 工具无关;
- 版本更新:后续 BYOK 或 Cursor 发布新版本,直接替换对应程序文件即可完成升级;
- 兼容性:该配置逻辑为通用标准,可适配绝大多数采用 OpenAI / Anthropic 兼容协议的国内大模型。