一、方案概述本文介绍在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?pwd5555 提取码: 55553.2 文件清单网盘内包含全平台安装包与对应 BYOK 中转工具Windows 客户端CursorUserSetup-x64-3.7.21(cursor安装包).exeWindows 版 BYOKcursor-byok-0.0.33-windows-amd64.zipLinux 版 BYOKcursor-byok-0.0.33-linux-amd64.tar.gzmacOS 苹果芯片版 BYOKcursor-byok-0.0.33-macos-arm64.tar.gzmacOS 英特尔芯片版 BYOKcursor-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 DeepSeekAPI Base URLhttps://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示例模型 IDglm-5.16.3 阿里百炼接口地址https://token-plan.cn-beijing.maas.aliyuncs.com示例模型 IDqwen3.7-max推荐上下文窗口2560006.4 小米 Mimo接入类型Anthropic 协议接口地址https://token-plan-cn.xiaomimimo.com示例模型 IDmimo-v2.5-pro七、Cursor 内自定义模型配置图形界面全平台通用7.1 调出配置入口启动 Cursor选择免账号方式进入主界面打开命令面板Windows / Linux快捷键Ctrl Shift PmacOS快捷键Cmd Shift P在搜索框输入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 兼容协议的国内大模型。