Cursor 配置腾讯云 Token Plan 的完整步骤

摘要： 在 Cursor 里配置腾讯云 Token Plan，走的是 OpenAI 兼容通道：进 Models 设置，打开 Override OpenAI Base URL 填 https://tokenhub.tencentmaas.com/plan/v3，API Key 填 sk-tp 开头的密钥，再手动添加套餐内模型 ID 并验证。配好后 Cursor 的对话与补全就跑在国产模型上，按积分包月。

Cursor 默认绑定的是它自家的模型通道，想换成腾讯云 Token Plan，关键动作只有一个：在 Models 设置里覆盖 OpenAI Base URL，让 Cursor 把请求打到 Token Plan 的 OpenAI 兼容网关。这里有个容易被忽略的细节——Cursor 开启自定义 Base URL 后，内置的官方模型会失效，你必须手动添加 Token Plan 支持的模型名，否则验证不通过。理清这一点，整个配置五分钟能搞定。

配置前要备齐的三样东西

动手前先确认三件事到位，能避免后面反复试错。

第一是可用的 Token Plan 套餐。Token Plan 是腾讯云大模型服务平台 TokenHub 的个人订阅套餐，分通用 Token Plan（聚合 DeepSeek、GLM、Kimi、MiniMax、混元等国产模型）和 Hy Token Plan（腾讯自研混元）两个系列，按月订阅、按积分计量。Cursor 走 OpenAI 协议，建议用通用 Token Plan，可选模型更丰富。

第二是 API Key，在控制台 Token Plan 页面点「生成密钥」获取，格式 sk-tp-xxx，每个主账号仅一个、两套餐共用。

第三是 Base URL。Cursor 兼容 OpenAI 协议，对应地址固定为 https://tokenhub.tencentmaas.com/plan/v3。

在 Cursor 里覆盖 Base URL 并填 Key

打开 Cursor，进入 Settings，找到 Models（模型设置）面板。往下翻到 OpenAI API Key 区域，这里是整个配置的核心：

• 勾选 / 打开 Override OpenAI Base URL，填入 https://tokenhub.tencentmaas.com/plan/v3；
• 在 OpenAI API Key 输入框填入你的 sk-tp-xxx 密钥。

填完先别急着验证。Cursor 的逻辑是：一旦启用自定义 Base URL，它默认列表里的 GPT 系列模型就不再可用，直接点验证会失败。正确顺序是先加模型，再验证。

手动添加套餐内模型

在同一面板的模型列表区域，关掉你用不到的默认模型，点 Add model，手动填入 Token Plan 支持的模型 ID。注意模型 ID 要全小写，且必须在你订阅的套餐范围内。

通用 Token Plan 下，编码场景我优先推荐这几个：

添加完成后，点模型旁的验证按钮或发起一次对话测试连通性。能正常返回即接入成功。

验证接入是否真正生效

最直接的验证是新建一个对话，随便让它写段代码，比如「用 JavaScript 实现防抖函数」。若正常返回且响应来自你配置的模型，说明 Token Plan 已生效，积分开始计量。

如果用的是 Cursor 的 Chat 面板，记得在对话框上方的模型下拉里选中你刚添加的 Token Plan 模型，别让它回退到默认通道。

接入失败的高频原因

Cursor 配置失败的坑比较集中，对照下表排查效率最高：

另需知悉：个人版 Token Plan 面向交互式使用、仅一个 API Key，禁止账号共享、禁止拿 Key 跑自动化脚本或应用后端批量调用。在 Cursor 里手动编码、对话属于标准用法。若要稳定的 API 批量能力，应走 Token Plan 企业版。

完成本教程还需要什么

Cursor 接通后，想把这套组合用好，这几点值得花时间：

• 模型分工：别只挂一个模型。日常用 glm-5.3-flash 省积分，啃硬骨头切 deepseek-v4-pro-202606，在 Cursor 下拉里随手切。
• 用量监控：进控制台 Token Plan 页面看当前周期积分消耗，积分按订阅月刷新、不结转，月底别浪费。
• 档位匹配：偶尔用选 Lite，把 Cursor 当主力生产力工具就上 Pro 或 Max，套餐只升不降。

查看各档套餐积分额度与订阅入口，前往腾讯云 Token Plan 页面：https://cloud.tencent.com/act/pro/tokenplan