在 Cursor 和 Trae 里配 MiniMax：两种接法与官方警告
数据截至 2026-08，价格与限额以各官网为准。本文只讲计费与接入机制，不列具体价格数字。
这两个工具的接法不一样，坑也不在同一个地方。 Cursor 走的是 OpenAI 兼容协议，你要在设置里勾上「Override OpenAI Base URL」，把调用地址指到 MiniMax，再手动添加一个名叫 MiniMax-M3 的自定义模型；MiniMax 官方文档在这一页连挂了三个警告框，其中最要命的一条是：这个 Override 是全局设置，一开就会作用到 Cursor 里所有已配置的 API Key，包括 Cursor 自带模型用的 Anthropic / GPT Key。Trae 的路径短得多——官方文档说 TRAE 中国版内置了 MiniMax-M3 模型，可以直接选用；要用自己的 Key，就在模型页签里添加模型、服务商选 MiniMax-CN。另外别忘了最前面那一步：MiniMax 的订阅 Key 和按量计费 API Key 是两把不同的 Key，官方明确说它们不可互换，填错了在哪个工具里都跑不通。
先把 Key 的类型分清楚
MiniMax 官方在 Token Plan 概要页写得很直白：每位用户在所属的每个团队中都有一把专属的订阅 Key，这把 Key 用于 Token Plan 订阅套餐和已购积分，并且订阅 Key 与按量计费 API Key 不可互换。另一把 Key 到底是干什么用的，定义不在概要页，而在常见问题页——那里把「Token Plan 的 API Key 和开放平台普通的 API Key 可以混用吗」单列成一条，答案先是干脆的「不可以」，接着分两行给出各自的口径：订阅 Key 用于套餐内 Token Plan 额度和已购积分，已有按量计费价格的 API 端点会按对应按量计费价格扣减套餐内额度；而普通开放平台 API Key 用于按量付费访问标准开放平台 API 接口，按实际 token 消耗量计费，消耗账户余额。两把 Key 对应的记账对象根本不是同一个池子，所以在打开工具设置之前，先想清楚你这次要走的是套餐额度还是账户余额，再去对应的页面取 Key。
还有一个容易让人懵的设计：官方说订阅 Key 可以在团队尚未购买 Token Plan 席位或积分时就存在，在这种状态下它暂时没有可用的付费资源；等用户被分配了席位或获得积分使用权限之后，同一把 Key 才能真正用上这些资源。也就是说，你能在控制台看到一把 Key、能把它复制出来、填进 Cursor 或 Trae，这三件事都成功了，并不代表这把 Key 背后已经有资源。配置阶段就报权限类错误的时候，先回控制台确认资源分配状态，比在工具设置里来回改参数更省时间。
订阅 Key 的位置官方也给了：账户管理里的 Token Plan 页面。快速接入页还顺带提了一句保存建议——妥善保存 API Key，建议将其导出为环境变量或保存到配置文件。这句话和下面 Cursor 那一步的警告正好配成一对：环境变量确实方便，但同一套变量留在系统里没清掉，官方把它放在了所有配置步骤之前——Cursor 页的第一个警告框就是它；「其他工具」页里 Kilo Code、Grok CLI、Droid 三个条目也各自挂了一条同类警告，其中 Kilo Code 和 Droid 那两条还点明了原因是环境变量会覆盖配置。同一条提醒在官方文档里反复出现，本身就说明了它的分量。
Cursor：从清环境变量开始
MiniMax 官方 Cursor 接入页的第一个警告框标题就是「使用前请先清除 OpenAI 环境变量」，点名要清的是 OPENAI_API_KEY 和 OPENAI_BASE_URL 这两个，理由是避免影响 MiniMax API 的正常使用。这一步别跳。
清干净之后，官方给的步骤是这样的：
- 点左侧栏的 Models，进入模型配置页面；
- 展开 API Keys 部分，勾选 Override OpenAI Base URL，在下方输入 MiniMax 的调用地址
https://api.minimaxi.com/v1； - 在 OpenAI API Key 输入框里填入从 MiniMax 开放平台获取的 API Key；
- 点 OpenAI API Key 栏右侧的按钮，在弹出窗口中点 Enable OpenAI API Key 完成设置验证；
- 回到 Models 板块，点 View All Models，再点 Add Custom Model；
- 输入模型名称 MiniMax-M3，点 Add；
- 启用刚添加的模型，然后在聊天面板中选中它。
第 6 步官方专门加了一条注记：模型名称需严格输入 MiniMax-M3，注意大小写，与 MiniMax 文档中保持一致。自定义模型这种输入框不会给你纠错提示，大小写写歪了，请求发出去才会失败。
非高级会员配不了自定义模型
官方的第二个警告框说的是资格问题：Cursor 仅支持订阅高级会员及以上的用户配置自定义模型。文档还把非会员配置时会看到的报错原文贴了出来——The model MiniMax-M3 does not work with your current plan or api key。这条报错的措辞有点误导，它把 plan 和 api key 并列在一起，很容易让人以为是 MiniMax 的 Key 有问题，从而跑去反复重置 Key。看到这句先去确认 Cursor 账户的订阅档位，别把时间浪费在 Key 上。
Override 是全局的，会波及 Cursor 自带模型
第三个警告框标题写的是「已知问题」。官方说明：开启 Override OpenAI Base URL 后会作用到 Cursor 中所有已配置的 API Key，包括 Cursor 自带模型用的 Anthropic / GPT Key；Cursor 官方已确认此问题——当你设置 base URL 时，所有 API Key 都会受影响。文档同时给了当前的处理办法：如果开启 Override 后 Cursor 自带的 Claude / GPT 模型停止工作，请在不使用 MiniMax 时关闭 Override；Cursor 目前不支持按模型设置不同 base URL，这一点在 Cursor 社区还挂着一个 open feature request。
这个设计有点反直觉，也直接影响你怎么用 Cursor：想同时留着自带模型和 MiniMax 随时切换，按现在的机制做不到，只能在两套之间来回开关这个勾。如果你的日常工作流强依赖 Cursor 自带模型，把 MiniMax 放在别的工具里可能更省心。
Tab 补全不受自定义 Key 影响
还有一条注记很值得单独拎出来，因为它决定了你能省下多少：官方说 Cursor Tab 自动补全无法由 MiniMax 驱动，Tab 是 Cursor Pro 自带能力，始终使用 Cursor 自家模型，不受你的自定义 API Key 影响；自定义模型仅在 Chat / Composer / Edit 等模式下生效。换句话说，配了 MiniMax 之后，Cursor 的补全体验和账单归属都不变，变的只是对话与编辑这几个入口。
模型不返回任何内容时的官方处置
文档最后给了一条排查建议：如果出现模型没有返回任何内容的问题，可尝试将 Cursor 中的 Network 设置更改为 HTTP/1.0。这是官方页面上唯一一条针对「配好了但没输出」的处置办法，遇到这个症状先试它。
Trae：内置模型和自定义模型是两条路
MiniMax 官方 TRAE 接入页把流程分成了两段。第一段是安装：从 TRAE 官网下载安装，首次启动按指引完成初始设置，登录账号，然后——官方原话是「TRAE 中国版内置了 MiniMax-M3 模型，你可以直接选用」。这一条对只想试试效果的人很关键：你根本不需要 Key，也不需要碰任何 base URL。
第二段才是自定义模型。官方说 TRAE 还支持通过 API Key 接入自定义模型，步骤是：在 AI 对话框右上角点设置图标，选模型页签，点「+ 添加模型」按钮，服务商选 MiniMax-CN，模型选 MiniMax-M3，填入从 MiniMax 开放平台获取的 API Key，最后点「添加模型」。
这里 Trae 的做法和 Cursor 有个实质差别：官方注记说，TRAE 将调用服务商的接口来检测 API Key 是否有效，可能的结果有两种——连接成功则该自定义模型被添加；连接失败则在添加模型窗口中展示错误信息和服务商返回的错误日志，你可以参考这些信息排查问题。也就是说 Trae 在添加环节就替你把 Key 验过一遍，并且把上游返回的原始错误露出来。这比配完才发现不通要好排查得多——出错时先读那段服务商日志，它通常已经把问题指清楚了。
另外，从官方给的操作路径看，Trae 走的是「在模型页签里添加一条服务商 + 模型的记录」，Cursor 那个 Override 则是勾在设置层面的一个开关。值得留意的是，Trae 那一页里没有任何与「会波及自带模型」对应的全局副作用警告，官方也没有就此给出说明——所以别把 Cursor 上那条已知问题的结论平移到 Trae 上，反过来也一样，两页的警告各归各页。
换成别的工具时抄哪几个值
MiniMax 官方的「其他工具」页给了一份通用配置参考，适用于任何支持自定义 Base URL + API Key 的工具。官方同时提供两种兼容协议：OpenAI 兼容协议的 Base URL 是 https://api.minimaxi.com/v1，provider 一栏选 OpenAI Compatible（有的工具叫 Custom 或 OpenAI-format）；Anthropic 兼容协议的 Base URL 是 https://api.minimaxi.com/anthropic，provider 选 Anthropic Compatible（有的工具叫 Claude 或 Custom Anthropic）。两种协议的 Model ID 都填 MiniMax-M3。
该选哪种，官方也给了判断口径：Claude Code 风格、为 Anthropic 设计的 TUI 或 CLI 走 Anthropic 兼容，常见环境变量是 ANTHROPIC_BASE_URL 加 ANTHROPIC_AUTH_TOKEN；Cursor、Continue、Aider 这类 OpenAI 格式的 IDE 插件走 OpenAI 兼容，常见环境变量是 OPENAI_BASE_URL 加 OPENAI_API_KEY；两种都支持的工具官方推荐选 Anthropic 兼容，理由写的是享受 prompt cache 优势。想深入这一侧，可以对着用 Anthropic SDK 接入 MiniMax 的官方推荐接法再看一遍。
顺带说一句：那一页里好几个工具的接入说明都带着「先清空环境变量」的警告，清的对象随协议而变——OpenAI 侧清 OPENAI_API_KEY 和 OPENAI_BASE_URL，Anthropic 侧清 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL。这类环境变量的优先级往往高于工具自己的配置文件，所以它才会反复出现在官方警告里。
配完之后，额度怎么看
官方在常见问题里明确回答过一个跟本文直接相关的问题：是否可以同时在多个工具中使用同一订阅套餐？可以，但额度是共享的，所有工具的使用会消耗同一套餐额度。所以 Cursor 和 Trae 同时配上并不等于额度翻倍。
查用量有两条路：一是访问控制台的套餐用量页面，查看套餐、额度、积分和用量情况；二是用 API 查询，官方给的示例是对 https://www.minimaxi.com/v1/token_plan/remains 发请求，请求头带 Authorization: Bearer <API Key>。想接进自己的监控看板，用后面这条。
额度触顶之后官方列了四条路：用已购积分自动补充支付；升级订阅套餐，官方说升级后立即生效；把工具里的订阅 Key 换成普通开放平台 API Key，切到按实际 token 用量计费、从账户余额扣；或者等额度窗口重置——官方说套餐内额度受固定的小时级窗口和周窗口控制，未使用完的额度不会结转到下一个计费周期，具体窗口长度与档位差异以官方文档和定价页为准。
还有一句定位说明值得注意：官方在「Token Plan 有哪些使用限制？是否适合生产环境」这一条里写的是，Token Plan 面向个人开发者的交互式使用场景，生产环境建议使用按量付费。Cursor 和 Trae 恰好都属于交互式场景，所以订阅 Key 是对路的；但如果你顺手把同一把 Key 塞进 CI 或批处理脚本，就偏离官方给的定位了。限流侧的通用应对思路可以看API 限流 RPM 与 TPM 怎么读。
最容易栽的三个坑
第一是环境变量残留。官方在 Cursor 页把它放在所有步骤之前，不是随口一提。
第二是 Override 的全局性。它不是「给 MiniMax 单独开一条通道」，而是把整个 Cursor 的 OpenAI base URL 改掉，副作用会落到你原本好好的自带模型上；官方给的解法就是不用的时候关掉。
第三是 Key 类型和资源状态。订阅 Key 与按量计费 Key 不互换，而且订阅 Key 可能在还没有可用资源时就已经存在。这两条叠在一起，会让「Key 明明复制对了却用不了」显得很莫名其妙——先查资源，再查工具设置。
最后提醒一句：官方给的保存建议是把 API Key 导出为环境变量或保存到配置文件，但这句话并没有指明保存在哪一层。多工具接入的实际形态是同一把 Key 同时落在系统环境变量、IDE 设置和项目目录里的配置文件三个地方，所以在把它写进任何一个跟着仓库走的文件之前，先确认这个文件不会被提交上去。这一侧的具体做法见API Key 安全管理清单。如果你打算把现有工具链整体切到 MiniMax，换厂商前的迁移检查清单可以当成对照表用。