// 01 MMX-CLI 是什么
来历与背景
MMX-CLI 是 MiniMax AI 官方开源的命令行工具，项目地址为 MiniMax-AI/cli，主要用于在终端或 AI Agent 中调用 MiniMax 的多模态生成能力。官方文档将它描述为“让 Agent 助手用上 MiniMax”的工具，面向已经使用 MiniMax Token Plan、MiniMax API 或希望把多模态能力接入 Claude Code、OpenClaw、Cursor、TRAE、OpenCode 等 Agent 工具的开发者与高级用户。
从 GitHub 仓库信息看，MMX-CLI 采用 MIT License，主要使用 TypeScript 开发。它不是一个面向普通用户的网页创作平台，而是 MiniMax 多模态能力的命令行入口和 Agent 集成层。
它解决的问题
MiniMax 本身提供文本、图像、视频、语音、音乐等模型能力，但如果开发者或 Agent 每次都直接对接 API，就需要处理鉴权、区域、参数、文件输出、异步任务和不同模型接口。MMX-CLI 的价值在于把这些复杂调用封装成统一命令，让用户在终端里直接生成内容，也让 AI Agent 可以通过 Skill 更准确地调用 MiniMax 能力。
它尤其适合“AI 助手需要调用外部多模态工具”的场景。例如让 Agent 生成视频、合成语音、制作音乐、生成图片或执行联网搜索时，不必临时查 API 文档，而是通过 mmx 命令完成。
核心能力
- 文本生成：支持命令行对话、流式输出、系统提示词和结构化输出等基础文本能力。
- 图像生成：可通过文字提示生成图片，并支持比例和输出文件管理。
- 视频生成：可调用 MiniMax 视频模型生成短视频，适合 Agent 自动生成素材。
- 语音合成：支持文本转语音，并可输出音频文件。
- 音乐生成：可根据提示词生成音乐，适合内容创作与自动化素材生产。
- 视觉理解：支持对本地图片、图片 URL 或文件 ID 进行描述与理解。
- 搜索能力：提供 mmx search 命令，可用于查询信息并输出结果。
- 双区域支持：API Key 登录时可自动探测国内与海外服务区域，也可以手动设置 region。
- Agent Skill 接入：官方建议通过 npx skills add MiniMax-AI/cli 安装 Skill，让 Agent 调用更稳定。
如何使用
- 在本地安装 Node.js 环境。
- 通过 npm install -g mmx-cli 全局安装 MMX-CLI。
- 执行 mmx --version 验证安装是否成功。
- 使用 mmx auth login --api-key sk-xxxxx 配置 MiniMax API Key。
- 执行 mmx quota 查看 Token Plan 余额和可用资源。
- 如需在 Agent 中使用，可执行 npx skills add MiniMax-AI/cli -y -g 安装官方 Skill。
- 之后即可使用 mmx text、mmx image、mmx video、mmx speech、mmx music、mmx vision、mmx search 等命令。
典型使用场景
在 AI Agent 工作流中，MMX-CLI 可以作为多模态能力扩展层。例如用户让 Claude Code 或 OpenClaw “生成一段产品介绍视频并配音”，Agent 可以调用 mmx video 和 mmx speech 完成素材生成。
在内容生产场景中，创作者可以用命令行批量生成图片、音乐、语音和视频素材，适合短视频、播客、营销素材和自动化内容流水线。
在开发集成场景中，团队可以把 MMX-CLI 放进脚本、CI 或内部工具中，用统一命令调用 MiniMax 能力，而不是分别维护多个 API 请求脚本。
与同类工具的差异
MMX-CLI 与普通网页端 AI 工具不同，它不强调可视化界面，而是强调终端调用、脚本化和 Agent 友好。相比直接写 API，它降低了参数配置和认证成本；相比单一模型 CLI，它覆盖文本、图片、视频、语音、音乐、视觉理解和搜索等多个模态。
它与 OpenAI CLI、Gemini CLI 等工具的差异在于模型生态不同：MMX-CLI 更适合已经使用 MiniMax Token Plan 或希望调用海螺视频、MiniMax Speech、Music、Image 等能力的用户。
价格与使用成本
MMX-CLI 本身是开源命令行工具，没有独立软件订阅价格。实际成本来自 MiniMax Token Plan 或 API 调用费用。用户如果只是安装 CLI，不会产生模型费用；一旦调用视频、语音、音乐、图像或文本模型，就会按 MiniMax 平台对应规则消耗额度。
真实优势与局限
MMX-CLI 的优势是官方维护、安装简单、能力覆盖广，并且对 Agent 使用场景做了专门适配。它适合开发者、自动化内容团队和正在搭建 AI Agent 工作流的人。
局限也很明确：它依赖 MiniMax 平台账号、API Key 或 Token Plan；普通非技术用户可能不习惯命令行；不同生成任务的质量、速度和成本仍取决于底层 MiniMax 模型与额度规则。整体来看，MMX-CLI 更适合作为 MiniMax 多模态能力的工程化入口，而不是面向大众的一站式创作界面。
// 02 核心 功能
- 核心定位MiniMax AI 官方开源的命令行工具，适合“AI 助手需要调用外部多模态工具”的场景。
- 分类索引当前归档在 最近收录AI、AI Agent / 智能体，方便和同频工具横向比较。
- 能力标签关联标签包括 命令行工具、调用外部多模态工具。
- 使用入口已记录可访问入口，可通过本页主按钮跳转。
// 03 使用 场景
- 快速判断是否适合当前任务结合 最近收录AI、AI Agent / 智能体 定位和 命令行工具、调用外部多模态工具 标签，先判断它是否匹配你的工作流。
- 横向比较同类工具从相同分类和标签继续探索替代工具，减少只看单个产品带来的选择偏差。
- 沉淀工具选型资料把官网入口、平台、版本和 NavXD 标签合并成一页，适合做选型记录或团队分享。
