☰
MiniMax M Plan与H3视频模型:Claude Code和Cursor免密接入指南
2026/10/8 10:52:42 网站建设 项目流程

MiniMax 这波动作挺大,Token Plan 直接退役,换成了 M Plan,全模态额度变成一本账;H3 视频模型也解禁了,视频创作者终于能摸到 H3 Director 的导演级镜头控制。我这两天把 Claude Code 和 Cursor 都接到了 MiniMax 上,密钥只在系统里写了一次,两个工具同时复用,流程非常顺,实测下来很稳。这篇就把 M Plan 的账怎么算、H3 提示词到底写多少字、以及两个 AI 编程工具免密打通的具体配置,完整拆给你。

1. 从 Token Plan 到 M Plan:为什么全模态额度大一统是刚需

1.1 Token Plan 时代的"三本账"痛点

我算是 MiniMax 的老用户了,Token Plan 时期最烦的就是额度分池。当时文本、图像、视频分别占用各自的额度池子,每个月要盯三个数字:文本池还剩多少 token,视频时长还剩多少秒,图像生成还剩多少次。日常用 API 做自动化的人,往往文本额度消耗特别快;而做视频创作的同事,视频额度永远是第一个见底的。两边池子互不通用,每到了月底,总有一个池子剩一大堆,另一个池子已经透支。

这种设计有点像老式手机套餐,通话分钟、短信条数、流量分开算,表面上看起来很"精细",实际用起来特别别扭。你做一次多模态工作流,可能文本、图像、视频都有消耗,却要分别核算、分别控制,稍不注意就超了。个人用还能忍,团队协作就是灾难——每个人都在问"视频额度还剩多少""文本池够不够跑今天的批量任务",管理员一天到晚在对账。

Token Plan 退役这件事,本质上就是 MiniMax 意识到:真正的大模型工作流早就不是单一模态了。一个 AI 应用可能要先用文本模型起草脚本,再用视频模型生成素材,中间还可能穿插图像生成、语音合成。如果每个模态都是独立账本,用户就要被迫去理解"为什么我视频额度没了,但文本额度还很充裕"这种毫无意义的账目问题。

1.2 M Plan 的全模态统一池到底怎么算

M Plan 的核心变化,就是把原来的多池额度合并成一个总池。文本、图像、视频、语音这些不同模态的消耗,统一从同一个月度额度里扣。对用户来说,不再需要关心"这次生成用了视频额度还是文本额度",只要关注一个总数就行。

这套设计的聪明之处在于它贴合真实使用习惯。比如我用 Claude Code 跑批量代码审查,消耗的是文本类额度;转头用 H3 生成一条 5 秒的视频素材,用的是视频类额度。以前这两个动作要分开记账,现在就是同一个池子里的两笔开销,额度管理一下子清爽了。配合 M Plan 额度大一统的还有一个关键点:H3 视频模型解禁。之前视频模型要么是单独购买、要么是白名单限制,现在订阅 M Plan 就能直接用,门槛降了一大截。

选型上我的建议是这样的:如果你是轻度 API 用户,每天调几十次文本接口,偶尔生成几张图,那按量付费或者小档位订阅就够了;但如果你同时跑代码智能体、批量文本处理、视频素材生成,直接上 M Plan 的中高档位更划算,因为它把多模态额度拉通之后,几乎不会出现某个模态额度浪费的情况。额度利用率越高,订阅模式就越值回票价。

注意:Token Plan 已经退役,旧链接和旧套餐不会再续费。如果你是老用户,控制台里的额度会自动迁移到新体系下,建议第一时间去确认自己的剩余额度和结算周期,别让旧套餐的残留额度影响新订阅的衔接。

2. H3 视频解禁第一课:提示词写多长、镜头怎么控、显存不够怎么办

2.1 H3 和 H3 Director 到底是什么定位

H3 是 MiniMax 的视频生成主力模型,跟传统"单镜头动画生成"不太一样的是,它把导演思维做进了提示词系统里。H3 Director 是这套体系里的"导演模式",你可以直接在提示词里指定机位、镜头运动、景别切换、人物走位,模型会按照你的调度生成画面,而不是纯粹靠运气抽卡。

简单类比一下:普通视频模型像是个手艺不错的摄影师,你告诉他"拍一只猫",他拍出来什么全凭发挥;H3 Director 相当于你请了个执行导演,你可以说"从左侧低机位推近,35mm 定焦,猫从窗台跳下时镜头跟随,背景虚化带暖色侧逆光",它就会按这套语言去执行。这是 H3 和市面上很多视频模型拉开差距的地方。

现在支持的视频时长,短片段一般做到 5 秒左右,长一点也能往一分钟方向走。5 秒适合做动态素材、转场、短视频封面动态化;一分钟的长视频就需要更完整的分镜规划了。我实测下来的感受是,H3 对"指令明确度"非常敏感——你在提示词里给的信息越像分镜脚本,它输出的镜头逻辑就越稳;如果只给一句"一只猫在窗台上",那出来的画面会很安全,但没有任何导演味。

2.2 5 秒视频的提示词写多少字才够

这是被问得最多的问题。很多人以为提示词越长越好,实际上 H3 对长度的要求是"够用就好、重点前置"。以生成 5 秒视频为例,我反复调了几十次之后,经验范围是 150 到 300 个中文字符。少于 100 字,画面元素太模糊,模型只能猜着来;超过 400 字,模型反而容易丢失前面的主体信息,后半段的细节可能渲染得很弱。

推荐把提示词拆成六个模块来写:主体、动作、场景、镜头、光影、风格。这是我常用的模板结构,你也可以直接抄:

主体:一个穿米色风衣的年轻女性,长发,神情平静 动作:从雨中的街角转过身,目光看向镜头,发梢轻轻甩动 场景:夜晚的东京街道,霓虹灯招牌亮着,地面湿漉漉反射灯光 镜头:中景,机位从右向左缓慢横移,35mm 定焦,浅景深 光影:暖色与冷色霓虹形成对比光,面部有淡淡的轮廓光 风格:胶片电影质感,轻微颗粒感,色彩偏青橙调

这样的结构写出来通常在 180 字到 250 字之间,正好落在 5 秒视频的甜区。核心技巧是把主体和动作放在前两句,让模型第一时间锁定主角是谁、在做什么;镜头和风格放在后面,作为画质和调度增强。如果你想做一分钟的长视频,不要企图一条提示词搞定。一分钟视频建议写出完整的分镜脚本,每个镜头单独准备一条 50 到 100 字的描述,再统一管理场景风格锚点,比如"全片保持青橙色调、胶片颗粒",这样拼接起来风格才不会跳。

生成时长方面,H3 的平台界面通常有 5 秒、10 秒之类的档位。我个人的经验是,先用 5 秒档把单个镜头跑通,确认画面构图和运动符合预期,再拼接成长视频。一条提示词直接生成一分钟,失败后重试的成本太高了,不如分镜逐条生成,最后用剪辑软件拼接,这样每一段的成功率都更高。

2.3 显卡优化与本地部署的现实问题

关于 H3 能不能本地跑,我踩过的坑不算少。社区里讨论比较多的显卡优化话题,集中在 20 系显卡上。20 系显卡显存大多是 6GB 到 8GB,而视频生成模型对显存的要求非常高,直接跑标准参数几乎必爆显存。有人通过量化权重、降低生成分辨率、启用 memory efficient 这类显存优化开关,把 20 系显卡勉强跑起来,但速度非常感人,生成一段 5 秒视频可能要等上很久,而且画质会损失不少。

说句实在话,如果你是普通内容创作者或者开发者,我不建议本地部署 H3。本地推理的复杂度不在于"能不能跑",而在于驱动、算子适配、显存管理这一大堆工程问题。AMD 显卡走 ROCm 路线有部分可用方案,但也存在算子兼容问题;国产加速卡那边,有用户在海光 K100 这类设备上做过测试,速度受驱动和算子适配影响很大,目前没有稳定的结论,需要自己动手折腾。想在本地跑的人,建议先确认自己的卡支持哪些精度和量化方式,再从社区拉一套已调好的推理方案试跑,不要自己从零编译,那是个无底洞。

注意:视频模型的本地推理和云端 API 是两条路线。本地跑适合对数据隐私要求极高、且愿意折腾显卡的玩家;普通人走 M Plan 云端接口更快更稳,H3 真正的价值在"提示词调度视频内容"上,别把精力浪费在显卡驱动上。

3. 手把手免密接入:让 Claude Code 和 Cursor 共用一套 MiniMax 额度

3.1 为什么"免密打通"值得做

Claude Code 是终端里的 AI 助手,适合批量文件操作、web 搜索、命令行任务流;Cursor 是编辑器里的 AI 队友,写代码、看 diff、做重构都离不开。两者的定位完全不一样,我一个项目里经常是两个都开:写业务逻辑切到 Cursor,跑批处理任务、改配置、查日志就回到终端里叫 Claude Code。

如果分别在两个工具里填 API Key,问题就来了:密钥分散在多个配置文件里,换一次 Key 要改两个地方,漏改一个就开始报 401 认证失败。更麻烦的是,Cursor 的配置文件是跟项目走的,密钥如果写进项目级配置,稍不注意就会跟着代码仓库泄露出去。

"免密"的本质,是让两个工具共用同一套系统级环境变量。Claude Code 和 Cursor 都兼容 Anthropic API 的接入格式,只要 MiniMax 开放平台提供了兼容端点,你就可以把 Base URL、API Key、模型名三个参数写到系统环境变量里。两个工具启动时自动继承,不需要在各自的设置界面里重复粘贴密钥。这就是免密打通的真正含义:不是没有密钥,而是密钥只存一处、全局生效。

3.2 Claude Code 安装配置,含 Windows 和 Ubuntu

Claude Code 的安装门槛很低,前置条件就一个:Node.js 18 以上版本。装好 Node 之后,打开终端执行全局安装:

npm install -g @anthropic-ai/claude-code

装完在终端里输入claude就能启动。macOS 和 Linux 用户注意一下 npm 全局目录的权限,如果遇到 EACCES 权限报错,说明你当前的用户对 npm 全局目录没有写权限,用sudo安装或者调整 npm 全局目录所有者都可以解决。Windows 用户推荐用官方桌面版安装包,或者直接用 npm 装命令行版,在 PowerShell 里跑也很方便。

Ubuntu 上配置 Claude Code 有个很关键的坑:如果你用的是 nvm 或 fnm 这类 Node 版本管理器,全局命令的实际路径是跟着当前 Node 版本走的。换 Node 版本后claude --version会提示命令找不到,属于正常现象,重新执行一次全局安装或者在当前版本下重链即可。

在 VS Code 里使用 Claude Code,你有两种选择。第一种最直接,打开 VS Code 集成终端,直接运行claude,它就在终端里以交互模式跑起来了,能帮你批量读文件、改代码、执行命令,所有操作都有记录。第二种是安装官方的 Claude Code 扩展,在侧边栏获得一个图形对话面板,快捷键触发,适合不想离开编辑器的人。扩展本质上是包了一层界面,底层还是同一个 CLI 工具,配置方式完全一致。

接下来是关键的环境变量配置。以 macOS/Linux 为例,编辑你的 shell 配置文件:

export ANTHROPIC_BASE_URL="你的_MiniMax_兼容Endpoint" export ANTHROPIC_AUTH_TOKEN="你的_MiniMax_API_Key" export ANTHROPIC_MODEL="你的_MiniMax_模型ID"

保存后source ~/.zshrc(或~/.bashrc)让它立即生效。Windows PowerShell 用户可以用:

$env:ANTHROPIC_BASE_URL="你的_MiniMax_兼容Endpoint" $env:ANTHROPIC_AUTH_TOKEN="你的_MiniMax_API_Key" $env:ANTHROPIC_MODEL="你的_MiniMax_模型ID"

这是临时生效,关掉终端就没了。想永久生效,用系统环境变量设置界面,或者setx ANTHROPIC_BASE_URL "你的地址"命令。设置完记得重开终端让变量真正加载。

我个人的习惯是,先把环境变量写进 shell 配置文件,然后启动claude直接问一句"你当前连接的是什么模型",如果它答上来,说明链路通了。这一步能帮你排除 90% 的配置错误。

3.3 Cursor 的设置:注册、中文、自定义模型

Cursor 的注册环节,很多人卡在手机号上。它是支持用手机号验证的,但填写时一定要注意国家/地区代码。作为一个国内用户,我填的是 +86,然后接 11 位手机号,不要在前面加 0,不要带空格或横杠。有些浏览器或者输入框会自动给号码加括号,或者在开头插入一段占位符,这说明它已经帮你识别了国家码,你只需要把剩余号码填完,别重复写一遍 +86。注册时别用临时邮箱或一次性手机号,这类账号很容易触发风控,轻则收不到验证码,重则直接被封。

Cursor 设置中文要分两层理解。如果你想要中文界面,直接在扩展市场装"Chinese (Simplified) Language Pack for Visual Studio Code"这个官方语言包,装完在设置里选择 language,重启就生效了。但更多人问的"Cursor 中文设置",其实是希望 AI 用中文回复。这个不靠界面语言,而是靠规则配置:在 Cursor Settings 的 Rules 里加一条"Always reply in Simplified Chinese.",或者项目根目录建一个 .cursorrules 文件,里面写同样的要求。AI 就会优先用中文跟你交流,代码注释和对话都会变中文。

接下来是接入 MiniMax。Cursor 就是 VS Code 的分支,所以它的模型配置兼容 Anthropic 格式。在 Cursor Settings 里找到 Models,添加一个自定义模型,填入模型 ID,并把 Base URL 指向 MiniMax 的兼容端点。关键一步是认证:如果你已经在系统环境变量里配好了 ANTHROPIC_AUTH_TOKEN,Cursor 会直接继承,不用在界面里再填一次。如果没生效,检查 Cursor 是否继承了终端环境变量,必要时在 Cursor 的 Environment Variables 配置里手动补一份。

提示:环境变量修改后,Cursor 必须完全重启,从终端启动cursor来继承新的变量,别只关窗口。很多用户配置完报 401,多半是因为 Cursor 没真正重启,还在用旧的空环境变量。

3.4 打通后的实际工作流长什么样

配置完成后,我的日常流程是这样的:在 Cursor 里写代码,AI 补全、审查、重构都用 MiniMax 模型跑,消耗 M Plan 额度;需要批量处理文件或者让智能体在终端里连续执行多步操作时,切到 Claude Code,它同样读取同一套环境变量,用的是同一个账号的同一份额度。两个工具之间不需要来回粘贴密钥,换 API Key 只需要改系统环境变量一处,两个工具下次启动全部生效。

还有一个小场景我觉得特别值:Claude Code 擅长跑多步任务,比如"扫描这个仓库里所有测试文件,找出断言写得不够严格的,列出改造方案"。这种任务在 Cursor 里做不方便,但在终端里给 Claude Code 一个指令,它自己会一项项执行。而 Cursor 更擅长的是你在写代码过程中随时提问、随时补全。两者互补性很强,衔接又顺,用起来非常丝滑。

4. 常见问题与排查技巧实录:这些坑我替你先踩过了

4.1 问题速查表

我把自己实际踩过、以及社区里高频出现的问题整理了一下,做成一个速查表,方便你直接对号入座:

现象可能原因解决方案
Claude Code 启动时报错或命令找不到Node.js 版本过低、npm 全局路径权限不对升级 Node.js 到 18 以上;检查 npm 全局目录权限,必要时重装
环境变量配置了但不生效终端没有重新加载配置、Cursor 没完全重启执行source重新加载,或者彻底退出 Cursor 后从终端启动
Cursor 请求模型返回 401API Key 没被 Cursor 继承、填错 Key检查系统环境变量是否正确,确认 Cursor 完全重启;必要时在 Cursor 设置里手动验证密钥
Cursor 响应速度很慢模型选择过重、慢速额度排队、请求上下文过长切换轻量模型;避开高峰时段;精简 .cursorrules 规则,减少每轮携带的上下文量
H3 生成的 5 秒视频画面太"平"提示词缺少镜头、光影和风格描述按前文六模块模板重写提示词,重点补齐镜头和光影信息
H3 本地跑爆显存显卡显存不足,参数未优化开启 memory efficient 类优化开关,降低分辨率,或者改用云端 API
.cursorrules 里的规则不生效文件位置放错、文件名大小写不对放到项目根目录,命名为.cursorrules,重启 Cursor
项目提示词泄露风险.cursorrules 被提交进公开仓库检查 git 是否跟踪该文件,敏感信息务必用环境变量而不是写进规则文件

4.2 几个值得单独说的细节

关于 Claude Code 不登录能不能用其他模型,这个问的人很多。Claude Code 默认启动时会引导你登录 Anthropic 账号,但如果你已经配置了 ANTHROPIC_AUTH_TOKEN 环境变量,它多数情况下会直接走 API Key 认证,不再要求交互式登录。也就是说,你完全可以只接 MiniMax 的兼容端点,用自己的 Key,不碰 Anthropic 账号。启动时如果还是被要求登录,先检查环境变量是否真的加载了,用echo $ANTHROPIC_AUTH_TOKEN确认一下。

Cursor 响应速度慢这个事,除了网络延迟,还有一个容易被忽略的原因:规则文件太大。很多人把几十条产品需求全塞进 .cursorrules 里,导致每一轮对话都要把这么长的上下文发给模型,响应时间自然飙升。我实测下来,规则文件控制在 10 到 20 行内,每行一个明确约束,效果最好。规则太多不仅慢,而且模型容易"顾此失彼"。

H3 视频生成这块,还有一个很实用的排查技巧:如果你发现生成的画面里主体的脸崩了或者运动幅度不自然,优先检查提示词里是否出现了相互矛盾的空间描述,比如"镜头从左向右移动"和"角色从右向左走来"在同一个镜头里同时出现。模型会产生空间冲突。后期我把提示词统一成单一视角原则——一个镜头只允许一个明确的主运动方向,出图稳定性提高非常明显。

Cursor 免费额度的问题也顺带说一句:新账号都有一定免费额度,但用完了会开始限速排队,体感很不好。建议如果你日常依赖 AI 编程,直接把 MiniMax M Plan 的额度接进来,让 Cursor 走自己的 API Key,不占用 Cursor 免费层,也不影响响应速度。

我在实际使用中最大的体会是,这套方案省下来的不只是配置时间,更重要的是把"额度焦虑"从工作流里剔除了。以前每次跑视频生成之前都要确认额度够不够,每个工具各配各的密钥,心虚得很。现在一本 M Plan,一套环境变量,Claude Code 和 Cursor 想切就切,H3 的视频额度用完看总池就行。如果你也是多工具并用的重度用户,建议把环境变量模板写进团队的 onboarding 文档里,新同事拿到电脑,source 一下配置文件就能开工,比在编辑器里一个个填 Key 靠谱太多了。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询