一、方案概述

本文介绍在 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 核心使用规则

1. 仅使用 Cursor 免费基础版，无需订阅 Pro 会员；
2. 支持免账号登录运行 Cursor 客户端；
3. BYOK 为中转服务，必须保持后台常驻，中断后模型调用将失效。

三、资源下载

3.1 统一下载地址

百度网盘：https://pan.baidu.com/s/1uOY1JKUy-iFW98ENiRFv8Q?pwd=5555 提取码: 5555

3.2 文件清单

网盘内包含全平台安装包与对应 BYOK 中转工具：

1. Windows 客户端：CursorUserSetup-x64-3.7.21(cursor安装包).exe
2. Windows 版 BYOK：cursor-byok-0.0.33-windows-amd64.zip
3. Linux 版 BYOK：cursor-byok-0.0.33-linux-amd64.tar.gz
4. macOS 苹果芯片版 BYOK：cursor-byok-0.0.33-macos-arm64.tar.gz
5. macOS 英特尔芯片版 BYOK：cursor-byok-0.0.33-macos-amd64.tar.gz

四、Cursor 客户端安装（Windows 为例）

1. 双击运行 CursorUserSetup-x64-3.7.21(cursor安装包).exe 安装程序；
2. 按照安装向导执行，可自定义安装路径，建议安装至非系统分区；
3. 安装完成后取消 “立即启动” 选项，暂时关闭安装程序，优先部署 BYOK 工具。

Linux、macOS 平台可参照对应系统常规软件安装流程操作。

五、BYOK 中转工具部署（核心步骤）

BYOK 是连接 Cursor 与国内大模型 API 的中转服务，所有自定义模型调用均依赖该工具。

1. 根据自身操作系统，解压对应版本的 BYOK 压缩包至纯英文路径（禁止中文、空格、特殊字符）；
2. 检查解压目录内文件完整性，确保主程序与依赖文件齐全；
3. 启动运行：
   • Windows：双击目录内可执行程序，弹出运行窗口后保持后台常驻，不要关闭；
   • Linux /macOS：进入解压目录，在终端执行启动命令，保持终端窗口运行。
4. 工具启动后可查看服务状态、接口统计、缓存、调用数据等信息。

六、国内大模型前置准备

该配置方式为通用方案，兼容 DeepSeek、智谱 AI、阿里百炼、小米 Mimo 等主流国内大模型。

6.1 账号与 API Key 获取

1. 打开对应大模型官方网站，完成账号注册并登录；
2. 进入开发者控制台 / API 管理页面，创建并复制 API Key；
3. 多数平台新用户提供体验额度，正式使用可按需充值，调用费用遵循平台官方计费规则。

6.2 关键参数整理

配置前提前记录两项核心参数，参数以各平台官方文档为准：

1. API Base URL：模型接口基础地址；
2. 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 调出配置入口

1. 启动 Cursor，选择免账号方式进入主界面：
2. 打开命令面板：
   • Windows / Linux：快捷键 Ctrl + Shift + P
   • macOS：快捷键 Cmd + Shift + P
   • 
3. 在搜索框输入 Change Model，选择 Configure Custom Model（配置自定义模型）。

7.2 填写模型配置项

在模型编辑页面逐项填写参数，各字段说明如下：

• 显示名称：自定义模型别名（如 DeepSeek、智谱 GLM，用于界面展示）；
• 模型标识：填写对应平台 Model ID；
• 接口地址：填写 API Base URL；
• 访问密钥：粘贴已获取的 API Key；
• 上下文窗口：可按需求填写，留空则使用默认值；
• 最大输出 Token：按需设置，留空使用默认值；
• 推理强度：默认选择 “中”；
• 接口端点：常规填写 /v1/chat/completions；
• 额外参数、自定义请求头：无特殊需求可留空。

7.3 保存与测试

1. 参数填写完毕后，点击「保存并测试」；
2. 测试通过后，刷新 Cursor 模型列表，即可选中并使用已配置的大模型；
3. 补充说明：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 模型无响应、请求超时

1. 检查 BYOK 中转工具是否正常运行，确保进程未关闭；
2. 核对 API 地址、API Key、Model ID，清除多余空格与非法字符；
3. 测试本地网络，确认可正常访问大模型官方接口。

10.2 401 密钥认证失败

1. 检查 API Key 是否完整复制，避免字符缺失；
2. 登录模型后台，查看密钥状态、账号剩余额度；
3. 销毁旧密钥，重新生成并替换配置。

10.3 接口返回 404 错误

原因为 API Base URL 填写错误，逐字对照官方文档修正接口地址。

10.4 Cursor / BYOK 程序启动闪退

1. 检查安装、解压路径，路径中不能包含中文、空格、特殊字符；
2. Windows 系统可右键程序，选择「以管理员身份运行」；
3. 若文件损坏，重新下载压缩包解压部署。

十一、补充说明

1. 授权说明：本方案全程使用 Cursor 免费版，无需付费订阅 Pro，也可跳过账号登录步骤；
2. 费用划分：大模型调用产生的 Token 费用、流量费用，由对应模型平台收取，与 Cursor、BYOK 工具无关；
3. 版本更新：后续 BYOK 或 Cursor 发布新版本，直接替换对应程序文件即可完成升级；
4. 兼容性：该配置逻辑为通用标准，可适配绝大多数采用 OpenAI / Anthropic 兼容协议的国内大模型。