stdout/stderr 分离——MMX-CLI 为 Agent 设计的输出隔离架构
MMX-CLI 是首个将 stdout 专门留给 Agent 可解析的纯数据、stderr 留给人类可读提示信息的命令行工具。启动时追加 --quiet 与 --output json，stdout 仅输出文件路径或 JSON 结构体，进度条、模型状态等 ANSI 转义字符全部划归 stderr——Agent 拿到的结果是干净的，不受彩色字符和交互式界面干扰。据腾讯网2026年4月报道，这一设计专为解决“普通 CLI 给 Agent 用时输出混入噪音”的问题而生。你需要理解这个分流的边界：--quiet 切断的是人类友好的渲染层，但错误信息仍然通过 stderr 和退出码双重传递，不会静默丢失。
语义化退出码与非阻塞异步任务控制
Agent 不需要解析英文报错字符串就能判断故障类型——这是 MMX-CLI 退出码体系的核心价值。鉴权失败、参数错误、超时、网络异常各自对应独立的数字退出码，Agent 仅读取 $? 即可决定重试还是终止。结合 --async 标志，长耗时视频生成或大模型推理可一键转为后台任务，避免 Agent 进程阻塞等待；参数缺失时 CLI 直接以非零码退出而非挂起等待 stdin 输入。这一组合消除了传统 CLI 在非交互式环境中的两大死穴：blocking-wait 和需人工解读的错误输出。具体退出码映射如下（据腾讯网2026年4月报道的分类）：
- 1：鉴权失败（API Key 无效或过期）
- 2：参数错误（缺少必填参数或格式非法）
- 3：超时（任务执行超时）
- 4：网络异常（连接失败或 DNS 解析错误）
全模态模型端点与输入输出格式速查
MMX-CLI 将 MiniMax 旗下五条模型线的调用统一为单一 CLI 入口。你需要知道每个端点接受的输入格式、输出格式和底层模型名称，才能正确构造调用命令。据新浪网2026年2月报道，API 支持的模型线包括 M2-her/M2.1（文本）、Speech 2.6（语音）、Hailuo 2.3（视频）、Music 2.5（音乐）以及图像模型；2026年6月 M3 上线后成为文本和编程任务的新主力。以下为各模态的调用参数与格式约束：
| 特性维度 | 文本（M3 / M2-her / M2.1） | 语音合成（Speech 2.6） | 视频生成（Hailuo 2.3） | 音乐创作（Music 2.5） | 图像生成 |
|---|---|---|---|---|---|
| 输入格式 | --message 字符串或 JSON 消息数组 |
--text 字符串或文件 |
--prompt 文本描述 |
--prompt 文本风格描述 + 可选歌词 |
--prompt 文本描述 |
| 输出格式 | 流式文本或 JSON | MP3/WAV 文件或流式音频 | MP4 文件 + 任务 ID | MP3 文件 | JPEG/PNG 文件 |
| 备注 | 支持多轮对话、系统提示词 | 30+ 音色，支持语速音量控制 | 异步模式推荐，可指定首帧 | 支持纯音乐模式 | 支持宽高比和批量生成 |
Token Plan 计费体系——从29元到49元，以及按 Token 计费的代价
截至2026年6月，MMX-CLI 必须绑定 Token Plan 订阅才能使用，不存在免费 tier。据腾讯网2026年4月报道，初期分档为 Starter 29元/月、Plus 49元/月、Max 119元/月，以及极速版 Plus 98元/月、Max 199元/月、Ultra 899元/月。但36氪2026年6月10日报道确认：6月1日起 MiniMax 已将计费模式从按次切换为按 Token，Starter 直接跳至 49元/月，同等任务 Token 消耗远超预期——有开发者测算，过去每月消耗30-50亿 Token 仅需49元，现在同样的量约需175元，涨幅达257%。
- 中外定价双轨制：上下文小于512K时，国内输入价 2.1元/百万 tokens，国外仅 0.3美元/百万 tokens（约2.04元人民币）。
- M3 模型 API 官方定价：输入 0.22美元/百万 token、输出 0.88美元/百万 token（据 php 中文网2026年6月9日数据）。
- 周限额约束：调价风波后，新用户默认受周限额约束，老用户保留无周限额特权（据36氪2026年6月报道）。
如果你用 MMX-CLI 跑长上下文 Agent 任务，单次 100K+ token 的对话会以远超预期的速度耗尽月额度——这是从按次时代迁移过来的开发者最容易踩的坑。
两行命令接入 Claude Code 与 OpenClaw
MMX-CLI 的核心集成卖点是无需编写 MCP Server——安装和首次调用压缩到两行命令。据腾讯网2026年4月9日报道，安装后 Agent 在 Claude Code 和 OpenClaw 环境中可直接通过 CLI 子命令调用 MiniMax 全模态模型。你需要完成的配置步骤：
- 安装技能：在终端运行
npx skills add MiniMax-AI/cli -y -g，将 MMX-CLI 注册为 Agent 可调用的技能。 - 认证授权：使用
mmx auth login–api-keysk-xxxxx绑定你的 API Key（需先订阅 Token Plan）。 - 区域切换（国内用户）：执行
mmx config set–keyregion–valuecn以接入国内 API 端点。 - 验证：运行
mmx text chat–message"hello"确认返回结果正常。
对于 OpenClaw 用户，安装后可直接在对话中以自然语言触发命令，无需额外编写任何适配代码。
长上下文任务中 Token 燃烧速度远超预期的隐性陷阱
MMX-CLI 将 Token Plan 作为唯一准入机制，意味着任何 Agent 调用都从你的月配额中扣除。但新用户最容易误判的是长上下文任务的真实 Token 消耗——M3 支持 1M 上下文，一次 100K 输入 + 多轮 Agent 反馈循环的任务，输出 Token 往往是输入的 3-5 倍。按 M3 输出价 0.88美元/百万 token 计算，单次复杂 Agent 任务轻松消耗数美元等值额度。再加上周限额机制（据36氪2026年6月报道，MiniMax 在调价风波后为老用户保留了无周限额特权，新用户默认受周限额约束），你可能会在周三就发现 Agent 因额度耗尽而静默失败——stdout 不会给你警告，只有非零退出码和 stderr 中的配额耗尽信息。这一限制在架构层面没有绕过方式，是每个将 MMX-CLI 接入生产级 Agent 流水线的开发者最终必须面对的上限。
参考资料
- 界面新闻 (2026-04-09) — 报道 MMX-CLI 发布及核心定位。
- 腾讯网 (2026-04-09) — 详解输出隔离、退出码及异步任务设计。
- 36氪 (2026-06-10) — 披露 Token Plan 调价风波、周限额及中外双轨定价。
- 网易 (2026-04-09) — 同步报道 MMX-CLI 发布及功能概览。
