1. 从 Token Plan 到 M Plan这次额度体系到底改了什么MiniMax 把原来的 Token Plan 直接送进历史换成了全新的 M Plan这件事在开发者圈子里炸开锅的原因其实很朴素——过去我们按 token 计费文本、语音、视频各算各的账一个项目跑下来光是对账就够头疼。M Plan 的核心变化是把全模态额度统一成一套计量单位文本对话、语音合成、视频生成全部从同一个池子里扣这对做多模态应用的团队来说省掉的不只是钱更是心智负担。我先把这次调整的关键点摆出来方便你判断要不要迁移维度Token Plan旧M Plan新计量方式按 token 分别计费全模态统一额度视频能力H3 视频受限H3 视频解禁适用场景纯文本为主文本语音视频混合对账复杂度高需分模态统计低单一额度池所谓“全模态额度大一统”说白了就是你买一份额度写代码调文本模型、生成语音、跑视频分镜扣的都是同一本账。以前做视频类应用最怕的就是视频额度单独算成本不可控现在这个顾虑基本消失了。H3 视频解禁是另一个重头戏。之前 H3 的视频生成能力在部分套餐里是锁着的现在 M Plan 直接放开意味着你可以用同一套 API Key 去调视频生成接口做分镜、做短视频素材、做动态演示不用再单独申请权限。对做内容自动化的朋友来说这个变化直接打开了新的玩法。至于 Claude Code 和 Cursor 的打通这是本文要手把手带你落地的部分。核心思路很简单把 MiniMax 的 API 端点配置成兼容 OpenAI 协议的接口然后让 Claude Code 和 Cursor 都指向这个端点。这样你在两个工具里都能用上 MiniMax 的模型能力而且共用同一个 Key免去反复切换的麻烦。注意配置前先确认你的 M Plan 已经开通并且拿到了有效的 API Key。Key 的权限范围决定了你能调哪些模态视频权限需要单独确认是否已解禁。2. 动手前的环境盘点与 Key 获取2.1 你需要准备什么在开始配置之前先把家底摸清楚。我列一个清单你对照着检查一个可用的 MiniMax 账号且已开通 M Plan从控制台生成的 API Key注意保存页面刷新后不再显示完整 Key本地开发环境Windows 10/11、macOS 或 Ubuntu 都行目标工具Claude CodeVS Code 插件或 CLI、Cursor基础命令行操作能力会改配置文件如果你是在 Windows 10 上部署建议先把 Node.js 环境装好Claude Code 的 CLI 版本依赖 Node 运行时。Ubuntu 用户一般自带 Python 和 Node问题不大。2.2 API Key 的获取与权限确认登录 MiniMax 控制台找到 API Key 管理页面新建一个 Key。这里有个细节很多人会忽略新建 Key 的时候要勾选你需要的模态权限。如果你只勾了文本后面调视频接口会直接报权限错误排查半天以为是配置问题其实是 Key 权限不够。拿到 Key 之后先别急着往工具里填用 curl 测一下连通性curl -X POST https://api.minimax.chat/v1/text/chatcompletion_v2 \ -H Authorization: Bearer 你的API_KEY \ -H Content-Type: application/json \ -d { model: abab6.5s-chat, messages: [{role: user, content: ping}] }返回正常就说明 Key 有效、网络通、权限对。这一步能帮你排除掉后面 80% 的“配置了但没反应”的问题。提示Key 不要硬编码在代码里提交到仓库。用环境变量或者本地配置文件管理这是基本的安全习惯。2.3 为什么选择兼容 OpenAI 协议的方式接入Claude Code 和 Cursor 这两个工具原生支持自定义模型端点而且大多遵循 OpenAI 的 API 格式。MiniMax 提供了兼容 OpenAI 协议的接口这就意味着我们不需要写任何适配层直接把 base_url 和 api_key 换掉就行。这个选择背后的逻辑是适配层越少出问题的环节越少。你不需要维护一个中间代理服务不需要处理协议转换的边界情况工具本身就能直接对话。实测下来这种直连方式延迟最低也最稳定。3. 手把手打通 Claude Code3.1 Claude Code 的安装Claude Code 有两种用法VS Code 插件版和 CLI 版。我建议两个都装插件版适合日常写代码时随手调用CLI 版适合脚本化和批量处理。VS Code 插件安装很简单在扩展市场搜索 Claude Code点安装就行。CLI 版用 npm 装npm install -g anthropic-ai/claude-code装完之后验证一下claude --version能输出版本号就说明装好了。如果提示命令找不到检查一下 npm 的全局 bin 目录有没有加到 PATH 里这是 Windows 用户最常踩的坑。3.2 配置 MiniMax 作为后端模型Claude Code 默认走的是 Anthropic 自己的服务我们要把它指向 MiniMax。配置方式是通过环境变量export ANTHROPIC_BASE_URLhttps://api.minimax.chat/v1 export ANTHROPIC_API_KEY你的MiniMax_API_KEY export ANTHROPIC_MODELabab6.5s-chatWindows 用户用 set 或者直接在系统环境变量里配set ANTHROPIC_BASE_URLhttps://api.minimax.chat/v1 set ANTHROPIC_API_KEY你的MiniMax_API_KEY set ANTHROPIC_MODELabab6.5s-chat配完之后重启终端让环境变量生效。然后在项目目录下运行claude如果能看到交互界面并且能正常对话说明打通了。注意环境变量的名字必须是 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY这是 Claude Code 读取配置的固定键名写错了它读不到。3.3 VS Code 里的配置细节如果你用的是 VS Code 插件版配置入口在设置里搜索 Claude Code找到模型配置项把 base URL 和 API Key 填进去。这里有个小技巧插件版和 CLI 版读的是同一套环境变量所以你在终端配好了插件版一般也能直接用。但如果你遇到插件版不生效的情况检查一下 VS Code 是不是从终端启动的。macOS 上从 Dock 启动的 VS Code 读不到终端的环境变量需要用code .命令从终端启动或者直接在插件的设置界面手动填配置。3.4 让 Claude Code 执行终端命令Claude Code 有个很实用的能力是直接执行终端命令。配置好之后你可以在对话里让它跑测试、装依赖、查日志。这个功能默认是开启的但有些版本需要手动确认权限。实测下来这个功能在重构和调试场景下特别省事。比如你让它“跑一下测试看看哪里挂了”它会自己执行命令、读输出、定位问题然后给你修改建议。整个流程不用你手动复制粘贴。4. Cursor 的接入与中文设置4.1 Cursor 下载与安装Cursor 的下载直接去官网拿安装包Windows、macOS、Linux 都有。安装过程没什么好说的一路下一步。首次启动会让你登录或者跳过跳过也能用基础功能。装完之后第一件事是设置中文界面和中文回复这个对英文不好的朋友很关键。4.2 Cursor 设置中文界面Cursor 基于 VS Code 内核所以汉化方式和 VS Code 一样。按 CtrlShiftPmacOS 是 CmdShiftP打开命令面板输入 “Configure Display Language”选择 “中文简体”然后重启。如果列表里没有中文选项需要先装语言包。在扩展市场搜索 “Chinese”安装中文语言包再重复上面的步骤。4.3 让 Cursor 用中文回复界面汉化只是第一步你还需要让 AI 用中文回复你。这个在 Cursor 的设置里找 “Rules for AI” 或者 “Custom Instructions”填入请始终使用中文回复我代码注释也用中文。这样每次对话它都会用中文。如果你希望更精细地控制可以在项目根目录建一个.cursorrules文件把语言要求写进去这样只对当前项目生效。4.4 配置 MiniMax 作为 Cursor 的模型Cursor 支持自定义模型端点。打开设置找到 Models 选项卡在 OpenAI API Key 那一栏填入 MiniMax 的 Key然后在 Override OpenAI Base URL 里填https://api.minimax.chat/v1填完之后点 Verify如果显示验证通过就可以在模型列表里选自定义模型了。这里有个坑要注意Cursor 有时候会缓存旧的配置改完之后如果没生效重启一下 Cursor。另外如果你同时配了多个模型记得在对话时手动切换到 MiniMax 的那个。提示Cursor 的免费额度有限接入自己的 API Key 之后走的是你自己的额度不受 Cursor 免费额度限制。这对重度用户来说是个省钱的路子。5. H3 视频能力的实战用法5.1 H3 视频解禁意味着什么H3 视频解禁之后你可以用 M Plan 的额度直接调视频生成接口。这对做短视频、做动态演示、做分镜预览的场景来说等于多了一个低成本的生产工具。以前做视频素材要么用专门的视频生成服务单独付费要么自己剪辑。现在文本、语音、视频都在一个额度池里你可以用同一套 Key 跑完整的内容生产流水线先用文本模型写脚本再用语音模型配音最后用视频模型生成画面。5.2 分镜提示词怎么写视频生成的质量七成看提示词。H3 的分镜提示词我总结了一个结构主体描述画面里有什么人物、物体、场景动作描述主体在做什么动作的幅度和节奏镜头描述景别远景/中景/特写、运镜推拉摇移风格描述写实/动画/电影感色调和光线举个例子你要生成一个“咖啡师拉花”的 5 秒视频提示词可以这样写中景镜头一位咖啡师在木质吧台前专注地拉花手部动作流畅 奶泡在咖啡表面形成心形图案暖色调光线从侧面打来 背景虚化电影感质感5秒时长。关于“生成 5 秒视频提示词需要多少字”实测下来 50 到 100 字比较合适。太短信息不够画面容易跑偏太长模型抓不住重点反而稀释了核心描述。5.3 本地部署的注意事项如果你打算在本地部署 H3 相关能力显存是第一个要看的指标。视频生成对显存的要求比文本高一个量级具体需求取决于分辨率和时长。建议先从小分辨率、短时长跑通流程再逐步往上加。Windows 10 部署的话驱动和 CUDA 版本要对齐版本不匹配是最常见的报错来源。Ubuntu 下相对省心但也要注意 Python 环境和依赖包的版本冲突。6. 常见问题与排查速查配置过程中遇到的问题我整理成了一张速查表方便你对照排查现象可能原因解决方向报错 no api key for providerKey 没配或环境变量没生效检查环境变量名和终端重启401 未授权Key 无效或权限不足重新生成 Key确认模态权限连接超时网络或端点地址错误检查 base URL 拼写Cursor 验证不通过Base URL 格式问题确认结尾没有多余斜杠Claude Code 无响应模型名不对换成有效的模型标识视频接口报权限错误Key 没勾视频权限重新生成 Key 并勾选关于 “llm-deepseek: no api key for provider route” 这类报错本质是工具在找某个 provider 的 Key 但没找到。如果你用的是 MiniMax确保工具配置里指向的是 MiniMax 的端点而不是残留的 DeepSeek 配置。清理掉旧的 provider 配置只保留你要用的那个。另一个高频问题是 Cursor 注册时手机号怎么填。这个按界面提示填就行注意区号选择正确。如果收不到验证码检查一下手机号有没有输错或者换个时间段再试。7. 我踩过的坑和几条实用建议第一个坑是环境变量的作用域。我在终端配好了结果 VS Code 里死活不生效折腾半天才发现 VS Code 是从 Dock 启动的读不到终端的环境变量。后来改成从终端用code .启动问题直接消失。这个坑在 macOS 上特别常见。第二个坑是 Key 的权限。我第一次生成 Key 的时候只勾了文本后面调语音接口一直报权限错误以为是接口地址写错了查了半天文档才发现是 Key 的问题。所以生成 Key 的时候把你需要的模态权限一次性勾全省得后面返工。第三个坑是 Cursor 的配置缓存。改完 base URL 之后没重启一直用的还是旧配置表现就是“改了没反应”。后来养成习惯改完配置先重启工具再测试。关于额度管理我的建议是给不同的项目用不同的 Key。这样一方面方便统计各项目的消耗另一方面某个 Key 泄露了也不影响其他项目。M Plan 的统一额度池虽然方便但如果不做区分月底对账的时候你会不知道钱花在哪了。最后说一个提效的小技巧把常用的模型配置写成脚本。比如你经常在 Claude Code 和 Cursor 之间切换可以写一个 shell 脚本一键切换环境变量。这样不用每次手动改减少出错概率。#!/bin/bash # switch-to-minimax.sh export ANTHROPIC_BASE_URLhttps://api.minimax.chat/v1 export ANTHROPIC_API_KEY你的Key export ANTHROPIC_MODELabab6.5s-chat echo 已切换到 MiniMax 配置每次开新终端的时候 source 一下这个脚本配置就到位了。这个习惯帮我省了不少重复劳动也避免了手滑写错 Key 的情况。