- 适用对象
- 想快速了解工具定位、核心功能和上手路径的中文用户
- 核对日期
- 2026-11-07
本页目录
本指南综合了 10 篇公众号文章(2026-08-26 ~ 11-06)。文中的 [1]~[10] 对应文末「参考原文」,每张图下方注明出处。素材之间说法不一致、或已经过时的地方,用 ⚠️ 标出。
这款产品改得很快:8~9 月的素材还在讲「Token Plan(Plus / Max / Ultra)」,10 月中旬官方已经换成「M Plan(Go / Explore / Build)」,默认模型也从 M3 换成了 M3.1 Flash。所以安装、套餐、API Key、接入其他工具这几部分,以 2026-11-07 查到的官方文档为准,标 [官N]。
一、定位:它是什么,适合谁
MiniMax Code 是 MiniMax 出的 AI Agent 应用,用的是 MiniMax 自家的 M 系列模型。它把对话、本地项目文件夹(工作区)、终端、内置浏览器、技能、插件、记忆和定时任务放在同一个工作环境里,你用大白话说要做什么,它自己读文件、改代码、跑命令、开浏览器测试,最后把改动(diff)、终端日志和成品留在同一个任务里给你验收 [2][4]。
名字里有 Code,但它不只写代码。素材 [1] 用它查资料出研报、把 1000 多条记账 Excel 做成 PPT、做网页小工具、生图和做视频;素材 [9] 用它从零做了两款带过场 CG 的横版游戏和一个 3D 宣传站;素材 [10] 用它通过 ADB 改造了家里的 TCL 电视。
它有五个入口 [官17][2]:
| 入口 | 是什么 | 最适合 |
|---|---|---|
| 桌面端(macOS / Windows) | 图形界面,功能最全:工作区、Files / Changes / Terminal 面板、内置浏览器、画布、Goal、Agent Team、定时任务、远程控制 | 绝大多数人,尤其不写代码的人 |
命令行 CLI(mcode) | 终端里的 TUI,外加 Headless(mcode exec)和 ACP 服务端 | 程序员、脚本、CI、接编辑器 |
WebUI(mcode-webui) | 在本机起一个只监听 127.0.0.1 的网页版客户端,Agent 仍在本机执行 | 远程开发机、在浏览器里盯长任务 [官29] |
| 网页端(云端) | 浏览器打开就用,任务在云端跑 | 在线调研、内容生成;不能直接改你电脑上的文件 [官17] |
| 手机 App(iOS / Android) | 看进度、补指令、批权限,遥控桌面端任务 | 出门在外 [官17][2] |
适合谁
想找「一个工具干完所有事」的新手:素材 [1] 认为它门槛低、功能广、审美在线,每天签到还送积分,可以放心试错。
程序员:本地仓库修 bug、加功能、跑测试、提交,Headless 模式能放进 CI [6][7]。
内容创作者:同一个任务里能生图(图生图)、首尾帧生视频、合并视频,H3 视频模型自带音效 [1][9]。
已经订阅了 M Plan、想在 Claude Code / Codex / Cursor 里用 MiniMax 模型的人:同一份订阅可以拿 Key 接到别的工具 [官10]。
不太适合谁
一定要用 Claude、GPT 这类海外顶级模型的人。MiniMax Code 支持自带 Key 接别家模型(见第四节),但主打的还是自家模型。
没有版本控制、看不懂测试结果的重要项目:素材 [7] 建议这种情况先别让 Agent 自动改。
需要 Linux 桌面端的人:桌面端只有 macOS 和 Windows,Linux 只能用 CLI 或 WebUI [官1][官2]。
和同类工具比
| MiniMax Code | Claude Code | Codex | Kimi Code 等国产 Agent | |
|---|---|---|---|---|
| 出品方 / 默认模型 | MiniMax / M3.1 Flash | Anthropic / Claude | OpenAI / GPT | 各家自研模型 |
| 入口 | 桌面、CLI、WebUI、网页、手机 | 桌面、CLI、IDE 插件、网页、手机 | 桌面、CLI、IDE 插件、网页 | 多为 CLI + 插件 |
| 多模态生成 | 内置生图、TTS、音乐、H3 视频,画布里直接剪 | 不内置生成 | 内置生图 | 各家不一 |
| 订阅起步价(国内) | ¥49/月(Go)[官15] | 需海外订阅 | 需海外订阅 | 各家不一 |
| 接其他模型 | 支持 BYOK(Anthropic / OpenAI / Gemini 格式)[官4][官27] | 改环境变量 | 改 config.toml | 各家不一 |
| 开源 | CLI 以 MIT 协议开源 [5][官3] | 否 | CLI 开源 | 各家不一 |
素材 [2] 提醒:MiniMax Code 是 MiniMax 的一个产品,和 MiniMax 开放平台(platform.minimaxi.com,做 API 和套餐)、MiniMax CLI(
mmx,调多模态能力的命令行)是三样东西,别搞混 [2][5][官23]。
二、准备与安装
0. 先选路线:你属于哪种情况
| 你的情况 | 推荐路线 | 看哪几步 |
|---|---|---|
| 不写代码,想让它查资料、做 PPT、做网页、做视频 | 桌面端 | 第 1、2 步 → 第三节 |
| Mac 用户,习惯 Homebrew | 桌面端用 brew 装 | 第 1、2 步 |
| 程序员,习惯终端 | CLI(一键脚本) | 第 1、3、5 步 |
| Linux / WSL / 远程开发机 | CLI 或 WebUI | 第 1、3、4 步 |
| 已经订阅 M Plan,想在 Claude Code / Codex / Cursor 里用 MiniMax 模型 | 拿订阅 Key 接到别的工具 | 第 1 步 → 第四节「11. 把 MiniMax 模型接到其他工具」 |
| 有别家模型的 API Key,想在 MiniMax Code 里用 | BYOK | 第 2 或 3 步 → 第四节「10. 在 MiniMax Code 里接入其他模型」 |
| 在海外,或者买的是国际版 | 海外版客户端 + --region global | 第 1 步「国内版和国际版」 |
1. 账号与费用
1.1 国内版和国际版是两套,先选对
MiniMax 的国内站和海外站账号、套餐、支付方式都分开。素材 [5] 的作者一开始在国际版买了 Plus(约 150 元/月),后来才发现国内版只要 49 元,而且国际版的 CLI 在国内网络下他一直用不了,最后建议「大家还是买国内版」。
| 国内版 | 国际版 | |
|---|---|---|
| 开放平台 / 买套餐 | platform.minimaxi.com(会跳转到 platform.minimax.cn) | platform.minimax.io |
| 客户端下载 | code.minimax.cn/about(旧地址 agent.minimaxi.com/download 仍可用) | code.minimax.io/about |
| 模型接口地址 | https://api.minimax.cn/... | https://api.minimax.io/... |
| CLI 登录 | mcode login | mcode login --region global |
| 付款方式 | 支付宝、微信、银联 | Stripe、信用卡 |
| 计费货币 | 人民币 | 美元 |
来源:官方文档 [官1][官2][官18][官22],付款方式和货币来自素材 [5]。
1.2 M Plan 订阅(2026-11-07 的官方口径)
M Plan 是现在的订阅套餐,10 月中旬上线,接替了原来的 Token Plan。它覆盖文本、图像、音频、视频生成,一份订阅在 MiniMax Code 和其他 AI 工具里共用 [官10][官14]。
| 档位 | 月付价格(国内) | 额度(相对 Go) | 文本模型 | 视频模型 H3 | 官方给的使用参考 |
|---|---|---|---|---|---|
| Go | ¥49/月 | 1 倍 | M3.1 Flash | 不可用 | 简单调研、轻量写作、小范围改代码 |
| Explore | ¥119/月 | 3 倍 | M3.1 Flash | 可用 | 每天用,日常编程、写作、资料整理 |
| Build | ¥469/月 | 12 倍 | M3.1 Flash | 可用 | 高频用,长上下文、复杂编程、大量多模态创作 |
来源:档位与额度 [官10][官11];价格来自官方的首月五折活动页(活动已于 2026-10-14 结束,页面列出的「原价」即上表)[官15]。三档都含图像与音频生成、网络搜索和多模态理解 [官11]。
年付:只付 10 个月的钱,相当于省 2 个月 [官11]。
海外版价格:官方海外文档没有列出 M Plan 的美元价格,本指南未核实。素材 [2] 8 月写的旧 Token Plan 海外价是 $20 / $50 / $120。
首月五折:上线活动已经结束,以后不定期推出 [官15]。
升级:随时可以升,未用完的部分按剩余时间折算抵扣,只补差价;暂不支持降级 [官16]。
自动续费:支付宝付款会自动开通自动扣款,素材 [5] 提醒记得按需关掉。官方说明:在「套餐详情 → 管理订阅」里关闭;关闭后无法重新开启,想继续用只能重新购买 [官16]。
1.3 额度怎么算
两个窗口:非视频模型(文本、图像、音频)同时受「5 小时窗口」和「周窗口」限制;视频模型只受周窗口限制。两个窗口都从你第一次使用时开始计时,到点自动恢复,不是每天零点重置。比如 10:00 首次使用,即使 12:00 就用完了,也要等到 15:00 才恢复 [官12]。
不结转:没用完的额度不会累积到下一个窗口,也不会带到下一个计费周期 [官12]。
消耗快慢:视频远比文本费;对话越长、读进来的文件越多、思考深度越高,越费额度 [官11]。素材 [9] 做两个小游戏加一个宣传站,用掉了 Build 档周额度的 12%,主要花在 H3 出视频上。
额度还有却被限流:额度和请求速率(RPM / TPM)是分开算的,短时间请求太多或高峰期动态限流,都可能暂时调不通,一般 1 分钟左右恢复 [官11][官12]。
查用量:MiniMax Code 的「设置 → 用量与模型」;网页上的套餐用量页;装了 MiniMax CLI 的话运行
mmx quota[官11][官26]。
图源:[2] 猿小猴子《主流 Agent 之「MiniMax Code」介绍》(8 月截图,当时套餐还叫 Token Plan)
1.4 积分:签到送的和花钱买的
积分是另一套「钱包」,可以在套餐额度用完后接着用,也可以不订阅单独买 [官11]。
每日签到:打开 MiniMax Code 签到,每天 400 积分;连续第 4 天、第 7 天各 1000 积分;一周累计约 4000 积分。签到积分到账后 30 天内有效 [官26][2]。
积分包:单独购买,1 年内有效。素材 [1] 截图里的价格是 ¥30 = 4,489 积分、¥150 = 22,460 积分、¥500 = 74,900 积分。只买积分包、不订阅的话,享受不到 M Plan 会员权益(更多云端项目、定时任务、网站发布额度,自定义域名、去水印等)[官11][1]。
扣费顺序:先扣套餐内额度,超出后再扣积分;按积分到期时间先后扣 [官11]。
花多少:素材 [1] 做一个「中午吃什么」抽签网页(生成加修改)花了 673 积分,约 4.5 元;做一条 5 秒 2K 视频花了 663 积分,约 4.4 元。
图源:[1] 栗子的赛博畅想《MiniMax Code 保姆级使用指南!》
⚠️ 积分怎么折算成钱,说法不一:素材 [2] 引用 8 月的官方文档写「1000 积分 = ¥7」;素材 [1] 的截图里积分包是 ¥30 买 4,489 积分,折合约 ¥6.7 / 千积分,她自己估的「673 积分 ≈ 4.5 元」也是按这个算的。两者差得不多,实际以你购买时的页面为准。另外素材 [4] 说「按 Token 额度计费,不是叫积分」,这不准确:官方现在是「M Plan 额度」和「积分」两套并存 [官11][官26]。
1.5 两种 Key,千万别混
| 订阅 Key | 按量计费 API Key | |
|---|---|---|
| 从哪拿 | 套餐详情页面,前缀一般是 sk-cp- | 开放平台「接口密钥 → 创建新的 API Key」 |
| 扣什么 | M Plan 额度和积分包,不扣账户余额 | 账户余额(要先充值) |
| 用在哪 | 接到 Claude Code、Codex、Cursor 等工具,个人交互式使用 | 生产环境、套餐不覆盖的资源 |
| 在 MiniMax Code 里需要吗 | 不需要,登录账号就自动用 M Plan | 想按量付费时才配 |
来源:[官11][官13][官24],素材 [2] 也提醒过两种 Key 不能混用。
只在 MiniMax Code 里用的话,不用碰任何 Key:订阅后用同一个账号登录 MiniMax Code 就行 [官13][官17]。
「为什么订阅了还在扣余额?」——十有八九是工具里填的是按量计费 Key,换成订阅 Key 就好 [官11]。
订阅 Key 可以在你买席位之前就存在,有了 M Plan 或积分后才能真正调用 [官24]。
图源:[2] 猿小猴子《主流 Agent 之「MiniMax Code」介绍》(8 月截图,当时还是 Token Plan,档位规格已过时)
⚠️ Token Plan 已经改名 M Plan,旧教程里的套餐全部过时:素材 [2](8 月)、[4](9 月)、[5](9 月)讲的是 Token Plan 的 Plus / Max / Ultra,覆盖 M3 / M2.7,素材 [2] 还写了「Plus 3~4 个 Agent 并发」之类的规格。官方现在的说法是:M Plan 上线后 Token Plan 停售,价格和文本额度不变(¥49 / ¥119 / ¥469),档位改叫 Go / Explore / Build,文本模型统一为 M3.1 Flash,Explore 和 Build 新增 H3 视频 [官10][官14]。老用户不用做任何操作,保持自动续费就按原价原权益续;也可以升级到 M Plan(Plus 可升 Go / Explore / Build,Max 可升 Explore / Build,Ultra 只能升 Build),升级后不能切回,Token Plan 的历史优惠(如 ∞ 限额、150% 周额度)也不再保留 [官14]。下图是 8 月下载页上的旧套餐,只作参考:
图源:[2] 猿小猴子《主流 Agent 之「MiniMax Code」介绍》
⚠️ 素材 [6] 写的「所有订阅用户在 MiniMax Code 内不限量使用 M3.1 Flash」是限时活动,已在 2026-10-25 23:59 结束。素材 [1] 截图里的模型名
M3.1-Flash-Preview也已下线,旧名字的请求会由MiniMax-M3.1-Flash接管 [官10]。
2. 桌面端(最简单)
系统要求 [官1]
| 平台 | 要求 |
|---|---|
| macOS | macOS 12 Monterey 及以上;Apple 芯片(M 系列)选 arm64,Intel 芯片选 x64 |
| Windows | Windows 10 及以上 |
| 账号 | MiniMax 账号(国内版和海外版分开) |
⚠️ 素材 [2](8 月)写的是 macOS 11 Big Sur 及以上,官方现在要求 macOS 12,11 已不受支持 [官1]。
方式 A:下载安装包(Windows 和 Mac 都可以)
打开下载页:国内版 code.minimax.cn/about,海外版 code.minimax.io/about [官1]。素材里的 agent.minimaxi.com/download [2][4]、agent.minimax.cn/download [5][官17] 也能用。
选和你电脑匹配的安装包。Mac 不知道是什么芯片:点左上角苹果菜单 → 关于本机,看「芯片」那一行。
macOS:打开 .dmg,把 MiniMax Code 拖进「应用程序」,从「应用程序」里启动。第一次打开会提示「是从互联网下载的 App」,点「打开」。
Windows:运行安装程序,按提示点下一步。
启动后用 MiniMax 账号登录,订阅了 M Plan 就用订阅时的那个账号 [官17]。
图源:[2] 猿小猴子《主流 Agent 之「MiniMax Code」介绍》
方式 B:用 Homebrew 装(只限 macOS) [官1]
# 国内版
brew install --cask minimax-ai/tap/minimax-code
# 海外版
brew install --cask minimax-ai/tap/minimax-code --language=en
# 以后更新
brew upgrade --cask minimax-ai/tap/minimax-code不传 --language 默认装国内版;命令会自动添加 tap,不用先 brew tap;选过的地区会被记住,之后 brew upgrade 沿用同一版本 [官1]。
安装遇到问题怎么办 [官1]
| 提示 | 怎么办 |
|---|---|
| macOS「这个版本不能与此版本的 macOS 配合使用」 | 系统低于 12,或者芯片版本下错了。先升级系统,再重新下对应芯片的包 |
| macOS「已损坏,无法打开」 | 把应用移到废纸篓(只删应用,别删数据目录),用浏览器重新下载官方安装包。不要用终端改签名或关系统安全检查 |
| macOS「无法验证开发者」 | 确认安装包来自官方后:系统设置 → 隐私与安全性 → 找到 MiniMax Code 点「仍要打开」。macOS 12 在「系统偏好设置 → 安全性与隐私 → 通用」 |
| macOS「包含恶意软件」或被移到废纸篓 | 不要点「仍要打开」,重新下载当前官方包再试;仍被拦就截图反馈。曾有旧版本因签名证书问题被拦截,官方已重新签名(GitHub Issue #95) |
| Windows「Windows 已保护你的电脑」 | 这是 SmartScreen 信誉检查。点「更多信息」核对发布者,确认可信后点「仍要运行」 |
| Windows 安装包被杀毒软件隔离 | 去 Windows 安全中心 → 病毒和威胁防护 → 保护历史记录,截图后反馈,别直接关防护 |
Windows 点登录打不开浏览器(0x800401F5 或 nodefaultbrowser) | 设置 → 应用 → 默认应用,给 Edge / Chrome 设一个默认浏览器 |
| 双击没反应、闪退、「服务启动失败」 | 重启电脑再试;旧版本就重新下载安装;不要手动删本地配置和会话数据;Windows 可在「事件查看器 → Windows 日志 → 应用程序」找错误 |
装不上也打不开的,直接去 GitHub 提 Issue,问题类型选 Startup / install / update;Issue 是公开的,记得把截图里的账号、密钥遮住 [官1]。
更新与反馈:有新版本应用会提示;也可以在设置里的通用设置手动检查更新。左下角小铃铛是站内信,版本更新和活动都在这里 [官28]。Windows 桌面端支持自定义数据目录 [官28]。
3. 命令行 CLI(mcode)完整安装
CLI 在 2026-09-18 以 MIT 协议开源(v0.4.12),源码在 github.com/MiniMax-AI/minimax-code [5]。截至 2026-11-07,仓库 README 里提到的 npm 版本已到 0.6.x [官3]。
系统要求 [官2][官3][官5]
一键安装脚本:会自己准备兼容的 Node.js,不需要 sudo 或管理员权限;不支持 Alpine / musl Linux。
npm 手动安装:Node.js 22.x 要 22.19.0 及以上,或者 Node.js 24、25、26。Node 23 不行,官方安装脚本给的原因是 Node 23 没有对应的预编译 SQLite 运行时 [6]。README 写的是 24.x 要 24.2 以上 [官3]。
网络要能访问 MiniMax 文件 CDN、npm registry 和 Node.js 下载源,有些原生依赖还会访问 GitHub [官5]。
第一步:打开终端
macOS:打开「终端」或 iTerm2。
Windows:开始菜单搜「PowerShell」。行首有
PS C:\的是 PowerShell;只有C:\的是 CMD,下面的 Windows 命令要在 PowerShell 里跑。Linux / WSL:打开系统终端。
第二步:运行安装命令(选一种)
| 方式 | 命令 |
|---|---|
| macOS / Linux / WSL(官方推荐) | curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash |
| Windows PowerShell(官方推荐) | irm https://filecdn.minimax.chat/public/install.ps1 | iex |
| npm(已有兼容 Node.js) | 见下方 |
| Windows CMD | 官方没有给 CMD 命令,请改用 PowerShell |
来源:[官2][官3],素材 [2][5][7] 给的也是这两条一键命令。
npm 安装要放行两个包的安装脚本(@minimax-ai/code 和 better-sqlite3),否则 SQLite 依赖装不上。官方 README 给的完整命令是 [官3]:
npm install -g @minimax-ai/code@latest --registry=https://registry.npmjs.org/ --ignore-scripts=false --include=optional --allow-scripts=@minimax-ai/code,better-sqlite3素材 [6] 的做法是先在 ~/.npmrc 里加一行 allow-scripts=@minimax-ai/code,better-sqlite3,再运行 npm install -g @minimax-ai/code。两种写法目的一样,以 README 的命令为准。
装到了哪里 [官3]
安装目录:
~/.minimax-code(Windows 是%USERPROFILE%\.minimax-code),放 CLI 程序和运行时。想换位置,安装前设置MCODEINSTALLDIR。数据目录:
~/.minimax,放登录状态、Provider 配置、缓存、会话、日志、插件和技能。用MINIMAXDATADIR可以改;旧变量MAVISDATADIR仍兼容,两个都设时以MINIMAXDATADIR为准 [官4]。两个目录是分开的:卸载程序不等于删掉会话,素材 [7] 也提醒过这一点。
第三步:检查有没有装好
关掉终端,重新打开一个。素材 [5] 在 Mac 上是先运行
source ~/.zshrc让 PATH 生效。运行
mcode --version,打印出版本号就装好了;再运行mcode --help,能列出命令列表才算过关 [官2][7]。
图源:[5] 新叶的生信笔记《MiniMax Code CLI 安装与配置》
提示
mcode: command not found:先重开终端;还不行就检查安装目录或 npm 全局目录有没有加进 PATH。Windows 上已经打开的 VS Code 会保留旧的环境变量,要完全退出 VS Code 再打开 [官5]。
第四步:登录
mcode login # 中国大陆账号
mcode login --region global # Global 国际版账号
mcode login --no-browser # 无图形界面 / SSH 远程:把授权链接直接打印到终端
mcode logout # 退出登录来源:[官2][官4][6]。
登录会拉起浏览器授权,完成后回到终端,运行
mcode进入 TUI,输入/status查看账号、模型和运行状态 [官2]。WSL / 远程开发机打不开浏览器:Debian / Ubuntu 先装
xdg-utils(sudo apt install -y xdg-utils);SSH 远程时,保持mcode login运行,在本机另开终端转发回调端口ssh -N -L <端口>:127.0.0.1:<端口> <开发机>。端口每次可能不同,看登录输出 [官5]。浏览器登录了但 localhost 回调页打不开:保持原登录命令运行,从浏览器地址栏复制完整回调 URL,在另一个终端运行
curl '回调URL',一定要用单引号包住。回调 URL 里有临时凭证,别分享、别截图 [官5]。只用 API Key、不登录账号也可以,见第四节第 10 小节。素材 [7] 建议第一天只选一种(登录或自带模型),免得登录问题和模型连通问题搅在一起。
第五步:更新与卸载 [官3][官5]
更新:
mcode update,完成后重启当前的 mcode 进程。npm 装的卸载:
npm uninstall -g @minimax-ai/code。一键脚本装的卸载(脚本没有卸载参数,要手动删):
关掉所有 mcode 会话,包括编辑器里接的。
macOS / Linux:
rm -rf -- "$HOME/.minimax-code";Windows PowerShell:Remove-Item -LiteralPath "$env:USERPROFILE\.minimax-code" -Recurse -Force。删掉安装器加进 PATH 的那几行(标记是
# MiniMax Code CLI);Windows 去用户环境变量里删 Path 条目。
想把会话和配置也清掉,再删数据目录
~/.minimax(Windows%USERPROFILE%\.minimax)。删了就找不回来,先备份;桌面端和 CLI 可能共用这份数据。
代理设置:CLI 支持 HTTPPROXY、HTTPSPROXY、ALLPROXY、NOPROXY(大小写都行),localhost、127.0.0.1、::1 始终不走代理,保证登录回调能用 [官4]。买的是国内套餐就别开代理登录。
4. WebUI 和网页端
WebUI:在本机起一个网页客户端,Agent 仍在你自己的电脑上跑,账号、会话、技能、插件、记忆和定时任务和桌面端、CLI 共用 [官29]。
npm install -g @minimax-webui/minimax-code --allow-scripts=better-sqlite3,node-pty,bufferutil,utf-8-validate
mcode-webui启动后浏览器打开 http://127.0.0.1:2233/;换端口设 WEBUISERVERPORT。它只监听本机回环地址,不能直接对外网开放 [官29]。官方说 WebUI 还在迭代,界面以实际版本为准。
网页端:国内版打开 agent.minimax.cn 登录就能用,任务在云端跑,适合调研、写作、整理资料;要改电脑上的项目文件就用桌面端 [官17]。
⚠️ 素材 [4] 说「网页版直接开 code.minimax.io」,这是海外版地址,国内用户用 agent.minimax.cn [官17]。素材 [2] 说「MiniMax Code 和 MiniMax Agent(agent.minimaxi.com)不是同一个产品」,这是 8 月的情况;现在官方把 agent.minimax.cn 写成「MiniMax Code 网页端」,两者已经合到一起 [官17]。
5. CLI 常用命令速查
| 命令 | 作用 |
|---|---|
mcode / mcode "任务" | 启动交互式 TUI;带上引号里的话就直接把第一条任务发出去 [6] |
mcode exec "任务" | Headless 模式,跑一次就退出,适合脚本和 CI(见第四节第 8 小节) |
mcode acp | 作为 Agent Client Protocol 服务端运行,接入支持 ACP 的编辑器(见第四节第 9 小节) |
mcode init [目录] | 分析代码库,生成或更新 AGENTS.md |
mcode -c / mcode --continue | 继续当前工作区最近的会话 |
mcode --session [id] | 打开会话管理器,或按 id 打开某个会话 |
mcode -m <provider/model> | 给当前会话单独指定模型 [6] |
mcode --tui-mode fullscreen | 全屏 TUI(默认 regular) |
mcode login / logout / update | 登录 / 退出 / 更新 |
mcode provider ... | 管理模型 Provider 和 API Key |
mcode plugin ... | 管理插件 |
来源:[官6][6]。本机实际支持的参数以 mcode --help 和 mcode <命令> --help 为准。
三、上手流程:跑通第一个任务
先用桌面端跑一遍,再看 CLI 怎么做。
1. 认识桌面端首页
左边栏从上到下是:新建任务、搜索、插件、定时任务、网站、连接手机、远程控制,下面是项目分组的历史任务和 Agent 团队。中间是输入框,下面一排是常用场景(视频生成、编程开发、文档办公、内容创作、问问 MCode)[2]。
图源:[2] 猿小猴子《主流 Agent 之「MiniMax Code」介绍》
素材 [3] 的说法很好记:左边是任务,中间说话,右边验收,底下才是输入框。输入框里有几样东西开工前要看一眼:
授权方式(输入框左下):桌面端有「主动询问 / 智能授权 / 始终授权」三档 [3],第一次用选「主动询问」(见第五节)。
模型(输入框右下):一般保持默认就行。
选择文件夹(输入框下方):就是「工作区」。不选的话,它只能陪你聊天,问十句也只能聊十句,还会回你「我无法访问文件」[3]。
@和/:输入@可以引用插件、子 Agent、文件和文件夹;输入/打开命令菜单,调用技能 [1][2][3]。
2. 先选模式:Coding 还是 Work
第一次打开时先决定主要用途,以后随时能改:设置 → 通用 → 模式 [2]。
| 模式 | 适合 | 界面 |
|---|---|---|
| 适用于编程开发(Coding) | 开发新功能、修 bug、跑测试、审 diff、调网页 | 保留工作区、Files / Changes / Terminal、内置浏览器 |
| 适用于日常工作(Work) | 文档、研究、表格、内容创作、日常自动化 | 能力一样,隐藏一些技术细节,聚焦进度和交付 |
来源:[2][官29]。
图源:[2] 猿小猴子《主流 Agent 之「MiniMax Code」介绍》
3. 跑第一个任务:把一个文件夹的 Excel 做成 PPT [1]
素材 [1] 用自己一整年的记账流水做演示,步骤是:
新建一个任务,点输入框下面的文件夹图标 → 选择新项目 → 选中存放账单的整个文件夹。不用一条条发,它能读文件夹里所有内容。
输入一句大白话:「帮我把今年的账单整理一下,并给出复盘和建议,最终生成一份 PPT。」
它先清洗 1000 多条数据(作者故意掺了脏数据,它也找出来了),花了不少时间校验修正,然后才做 PPT。
做完在右侧结果区验收,不满意直接接着说一句。
图源:[1] 栗子的赛博畅想《MiniMax Code 保姆级使用指南!》
第一次用,建议像素材 [1] 一样拿一个复制出来的练手文件夹试,别直接用重要文件。
4. 再跑一个:做个小网页,并让它自己测试修改 [1]
输入:「帮我做一个『中午吃什么』的美食盲盒抽签工具」,把饮食偏好和忌口一起写进去,再说一句「动画做得好玩一点」。
大约 10 分钟做好,它还自己补了「今日运势」和抽签记录,这些都是作者没提的。
有一种玩法看不懂?直接说「第二种抽签模式我没看懂,按我的理解改成……」。
修改时它会在右侧内置浏览器里自己点网页测试,鼠标不用动。两分钟改完。
图源:[1] 栗子的赛博畅想《MiniMax Code 保姆级使用指南!》
5. 程序员版:在已有项目里改代码、跑测试、提交
切到 Coding 模式,绑定项目文件夹(点「打开项目」),描述目标,看它拆解的方案,确认权限,实时看 diff,在内置浏览器里预览,有问题接着说 [2]。下图是官方团队自己用 MiniMax Code 改它自身代码的截图:改完跑相关单测(24/24 通过),确认那 30 个失败是原本就有的环境问题,最后写 changelog 并提交 [4]。
图源:[4] 黄禅宗《MiniMax Code AI编程助手:下载、使用、额度一篇讲清(建议收藏)》
写任务的公式:最终交付物 + 验收证据 + 边界条件 [2]。代码任务写清技术栈、限制和验收方式(测试通过、性能指标、兼容性);研究任务写清输出格式、信息来源和时间范围。素材 [3] 的上手清单写法是「要什么 + 材料 + 格式 + 别碰什么」。
6. CLI 版:先让它修一个测试(素材 [7] 的三步法)
素材 [7] 的思路是:第一次别展示功能,只拿到「复现失败 → 修实现 → 跑测试」这条能核对的证据链。
准备:复制一个小项目,或新建一个测试仓库;先
git status,别在有未提交改动的主仓库里试。进入并开工:
cd /path/to/your/project
mcode init . # 可选:先生成 AGENTS.md,记录项目约定 [官8]
mcode第一条任务同时写结果、边界和验收,例如:
读取 clamp.mjs 和 clamp.test.mjs;先运行 node --test 复现失败,只改实现不改测试,修复后再次运行测试并汇报 diff。验收:任务结束后自己跑
git diff --stat和git diff,确认它没顺手改配置或测试。
过关标准:看到失败被复现、相关实现被修改、同一测试重新通过,并且 diff 只落在你允许的范围里 [7]。
官方工作流文档给的首轮提示也类似:「先阅读项目规则和相关测试,说明失败原因;确认方案后修复,并运行最小相关测试。」[官8]
7. 新手的使用顺序建议
先跑通一遍,比看懂七个名词更重要 [3]。
拿不准改动范围,先开「计划」,看完方案再执行 [3]。
活变固定了,再装技能、连插件;出门在外再配 Bot [3]。
先用小任务试:整理一份资料、做一个 PPT 初稿、做一个简单网页,先出初稿再慢慢改 [1]。
四、核心功能与进阶
1. 工作区:小而准
工作区就是你给任务选的本地文件夹,选了以后它才能在里面读文件、跑命令、生成产物 [2][3]。
只选和任务相关的目录,工作区越小越准,它越容易找对代码、跑对命令 [2]。
用
@文件名点名某个文件,让它聚焦 [2]。CLI 里用
/add-dir <路径>再加一个可读写的目录 [官8]。「加速索引」开关(设置 → 通用):开了以后会给工作区建语义索引,加快搜代码 [2 图]。
2. Files / Changes / Terminal 和内置浏览器
右边是验收区,素材 [2] 叫它「证据链面板」:
| 面板 | 用来干什么 |
|---|---|
| Files | 看交付物、预览结果;Windows 上能直接预览 DOCX / XLSX / PPTX |
| Changes | 按文件审 diff,决定接受还是继续改 |
| Terminal | 看命令执行过程和输出(测试、构建、本地服务) |
| 内置浏览器 | 打开网页或 HTML 产物,多 Tab、移动端预览、能看到 Agent 操作网页的轨迹 |
来源:[2]。
素材 [9] 的用法值得学:在内置浏览器里预览宣传站,发现正文字太小,直接在右边框选那块文字让它改,它就换了黑体并给导航加了滚动高亮。改完对话里会显示 +1440 -1157 这样的改动行数,旁边就是「查看文件」「撤销」「审查」按钮。
对话里还能划词评论 / 引用:选中一段文字、代码或表格,加引用和评论,下一条指令会一起带上 [2]。
3. 画布:生图、改图、做视频 [1]
MiniMax Code 有一张「无限画布」,素材、灵感和生成结果都摊在上面 [官·文档索引]。素材 [1] 的完整做视频流程:
生分镜图:「帮我生成 3 张风格不一样的分镜图:一个 30 岁左右的女性,坐在电脑前……比例 16:9」,3 分钟左右出图。
图生视频:在对话里点中意的那张图上的「画布」,进入画布后点上方「添加到对话」,再说「用这张图生成 1 个 5 秒的动态视频」。5 秒 2K 视频花了 663 积分。
做长一点:把第一张图加到对话,让它生成风格一致的第二张(图生图);在画布里把两张图都加到对话,用首尾帧生成一段 8 秒视频;最后让它把 5 秒和 8 秒合并成 13 秒。
图源:[1] 栗子的赛博畅想《MiniMax Code 保姆级使用指南!》
视频用的是 MiniMax H3,能直接生成音效(机器轰鸣、火焰声)[9]。Go 档不含视频模型,要 Explore 或 Build [官10]。
素材 [9] 做游戏时角色形象从像素小人、对话插画到 H3 动态大片都保持一致(红围巾、护目镜)。他的经验:生成带枪的动作图时宽度会变,默认按中心对齐人物会左右晃,让它改成按脚底位置对齐就稳了。
4. 插件市场
插件让它够得着外部的数据和系统。点左边栏「插件」进入市场 [2]。
图源:[2] 猿小猴子《主流 Agent 之「MiniMax Code」介绍》
首批插件有恒生金融数据库、企查查、EverMe、北大法宝、Office 三件套,后来加了 WPS 金山文档、企业微信 [2][3]。素材 [1] 用的是同花顺 iFinD 金融数据查询插件,问内存为什么涨价,它一直调 iFinD 数据库,出的报告把涨价逻辑拆成五层,数字都标了出处。
一个插件里可能有三种东西 [2][3]:Skill(领域知识和流程,一份 SKILL.md)、MCP(不需要 MiniMax 代管授权的工具和数据源)、App(要登录授权的账号连接,走 Connector 流程)。
像企查查这种要登录授权的插件,装之前看清它要什么权限 [3]。
素材 [3] 的建议:第一批插件先别急着装,等真有查工商、查法条、读写 Office 的需求再装。
CLI 里管理插件:
mcode plugin list --available看可装的,mcode plugin add <插件>@official安装,enable/disable/remove管理,mcode plugin marketplace upgrade刷新源 [官4]。
图源:[1] 栗子的赛博畅想《MiniMax Code 保姆级使用指南!》(截图里的 M3.1-Flash-Preview 已下线)
5. 技能(Skill)
把你们的标准做法写成它每次都照做的说明书,形态就是一个文件夹,里面放一份 SKILL.md [3]。
插件市场下半部分就是官方技能,比如演示文稿生成器、Word 文档工具、行业研究报告、图像创作工具 [2 图]。素材 [9] 提到 PPT 方面也有几个官方 Skill。
用
/菜单调用技能,CLI 里/skills [关键词]查看已装技能 [3][官4]。开放生态:素材 [9] 在 MiniMax Code 里装了开源的 REA(Reverse Engineer Anything)去逆向分析两款商业游戏的瓦片、动画和视差背景规格。
零基础起步:先抄一个现成的改。官方开源了团队自用的技能集 github.com/MiniMax-AI/mcode-stack,素材 [3] 说把某个技能目录拷进
~/.agents/skills/就能用。素材 [3] 认为插件和技能先学技能:纯文本写一份,就能让每次输出都符合标准。
⚠️ 技能目录
~/.agents/skills/是素材 [3] 的说法,本指南查阅的官方 CLI 配置文档没有写明这个路径(只说技能和插件存在数据目录~/.minimax下)[官4],未核实,以你本机实际情况为准。
6. 记忆、项目规则文件
记忆:它会主动识别长期有用的信息(沟通偏好、工作习惯、项目约定、解决问题的经验),后面的任务按需调用 [2]。你也可以直接告诉它,比如「项目永远用 TypeScript,缩进 2 空格,注释用中文」[2]。一次性状态、临时日志、密钥、过期细节不要存进记忆 [2]。
项目规则:CLI 读工作区里的
AGENTS.md;mcode init .会分析目录结构、已有规则和脚本,生成或更新它 [官4][官8]。
⚠️ 素材 [2] 建议「在项目根目录写 CLAUDE.md,Agent 每次自动读取」。官方 CLI 文档写的项目规则文件是
AGENTS.md,没有提 CLAUDE.md [官4][官8];桌面端是否读 CLAUDE.md,本指南没查到官方说法,未核实。稳妥做法是写AGENTS.md。
7. 计划、目标(Goal)、Agent Team
计划(Plan Mode):先出方案再动手。不知道会牵动几个文件、任务偏大要重构、或者你不熟悉这个项目时,一定要开 [3]。
CLI:
Shift+Tab切换,或/plan on、/plan off、/plan status、/plan view(看最近的计划)[官8]。Plan Mode 只管「先规划还是直接做」,不改变权限。进入执行阶段后,仍按当前权限模式确认 [6][官7]。
目标(Goal):普通提问管「下一步做什么」,目标管「终点算不算成立」。没达标就继续往下做,直到达标、卡住,或者你叫停 [3][2]。
入口:从
/命令菜单或+菜单里选「目标 / Goal」;直接打/goal进不去 [3][2]。适合:问题定位、迁移重构、指标优化、研究交付这类「终点清楚、路径不清楚」的事 [2]。
代价:会连续跑很多轮,用量明显高;目标写得含糊(比如「优化一下」)可能原地空转。开跑前想清楚验收证据,设好运行时间、尝试次数或用量上限 [2][3]。
素材 [9] 的用法:不堆条条框框,用 Goal 设一个结果导向的目标——「使用 pptx skill,不要问我有什么要求,利用你已有的美术素材,制作一份你觉得可以直接拿下投资人百万投资的游戏 PPT 路演材料」,它自己跑了 43 分钟。
图源:[9] 甲木未来派《我用 MiniMax Code 从 0-1 用 AI 搓了两款 CG 游戏,绝了!》
Agent Team:按任务复杂度拉几个专家 Agent 分工协作,你只要描述目标,它负责拆解、分配、跟踪和汇总 [2]。左边栏能看到 UI 操作者、代码审查员、QA、全栈工程师、调研员、Explore、Verifier、Worker 等角色 [2 图]。做小玩意用不太到,知道有这功能就行 [4]。
图源:[2] 猿小猴子《主流 Agent 之「MiniMax Code」介绍》
自定义 Agent:可以设名称头像、描述、行为指令、默认工作目录、绑定 IM 渠道。比如「代码审查专员」专跑 Review,「周报助手」绑定定时任务 [2]。
Code Review:内置 Review 指令会读 diff,从正确性、安全性、可维护性检查,适合提交前初审;关键改动还是要配合测试和人工判断 [2]。
8. 定时任务、远程控制、IM Bot
定时任务:日报、周报、定期检查、信息整理。设名称、指令、执行的 Agent、时间和会话模式,到点跑完结果回到对应会话。电脑要醒着、MiniMax Code 要开着、任务要启用,否则不会执行;页面上有「保持唤醒」开关 [2][官28]。
远程控制:左边栏「远程控制 / 连接手机」,用手机 MiniMax App 连上,项目文件、终端、运行环境都还在电脑上,手机只当遥控器:看进度、补指令、批权限 [2]。截图里写着要求移动端 App 4.15.0 及以上 [2 图]。
IM 连接(Bot):在「设置 → 助理设置」里接微信、飞书、Telegram、Lark,Telegram 要填 Bot Token [2][3]。长任务可以在 IM 里看进度,发
/stop中断 [2]。素材 [3] 提醒两条边界:群里人多,权限确认会被别人看到甚至代点,敏感操作别放群里;桌面端要一直开着,电脑睡了就没人干活。
9. CLI 进阶:TUI 快捷键、思考强度、Headless、ACP、SDK
TUI 快捷键 [6][官5]
| 按键 | 作用 |
|---|---|
Enter | 发送;任务运行中按它是调整(steer)当前响应 |
Alt+Enter | 任务运行中把后续消息排进队列 |
Shift+Enter | 换行 |
@ | 引用工作区里的文件或目录 |
Ctrl+V | 粘贴剪贴板里的图片或视频(SSH 远程一般读不到本机剪贴板,改用 @ 或 --file) |
Shift+Tab | 切换 Plan Mode |
Alt+M | 在 Ask / Auto / Full access 权限模式之间切换 |
Esc | 关面板,或中断正在跑的任务;空输入框按两次 Esc 编辑上一条消息 |
/help | 看当前版本的全部命令和快捷键 |
常用斜杠命令:/status(账号、模型、运行状态)、/model(选模型和思考强度)、/doctor(查配置)、/context(看上下文占用)、/compact(压缩长对话)、/sessions(找历史会话)、/export [路径.md](导出留档)、/skills、/mcp、/statusline(自定义状态栏显示上下文)[官4][官5][官7]。
思考强度怎么调:mcode 没有直接切换思考强度的快捷键,要在 /model 打开的模型选择器里调 [6]:
| 按键 | 作用 |
|---|---|
← / → | 调 Thinking 开关或 Effort 档位 |
Tab / Shift+Tab | 在模型支持的上下文容量之间切换(如 512K 和 1M) |
Enter | 应用到当前会话,同时存为默认值 |
Esc | 放弃这次调整 |
M3.1 Flash 只能调档位(low / medium / high / xhigh / max),思考关不掉;M3 只能开关思考,不能调档位 [6][官18]。改完新会话继承这个档位,已有会话保留自己选过的 [6]。Headless 单次指定:mcode exec --effort high "规划这次迁移" [6]。
Headless(mcode exec):不启动 TUI,跑一次就退出,适合 Shell、CI、批处理 [官5]。
mcode exec --cwd ./repo --output-format json "运行最小测试集并修复失败项"
cat task.txt | mcode exec --input -| 参数 | 作用 |
|---|---|
--cwd <路径> | 工作区目录,CI 里一定要显式写 |
--file <路径> | 附件,可多次传,最多 10 个、合计不超过 100 MB |
--model <provider/model[#variant]> | 本次用的模型 |
--effort <档位> | 本次思考强度 |
--permission smart|full|off | 权限策略,默认 smart(相当于 TUI 的 Auto);不支持 ask,因为没人能点确认 |
--timeout 2m / --max-steps <数> | 超时和最大步数 |
--output-format text|json|stream-json | 输出格式;脚本要看 JSON 里的 status |
--output-schema <schema> | 要求最终回答符合 JSON Schema |
-o <路径> | 成功后把最终消息写入文件 |
--continue / --session <id> | 接着已有会话跑 |
退出码:0 成功,2 参数错误,3 配置错误,4 任务失败,6 超时,7 超过步数限制,70 内部错误,130 被取消,141 broken pipe。脚本要同时看退出码和 JSON 的 status [官5][官6]。遇到需要人工回答的问卷或权限请求,Headless 会直接失败,要回到 TUI 或 ACP 处理 [官5]。
ACP:接入编辑器:mcode acp 以 Agent Client Protocol 服务端运行,编辑器里能显示 Agent 回复、diff、权限请求,支持取消和切模型 [官9]。支持自定义 Agent server 的编辑器(素材 [2] 提到 Zed)这样配:
{
"agent_servers": {
"minimax-code": {
"type": "custom",
"command": "mcode",
"args": ["acp"],
"env": {}
}
}
}编辑器找不到 mcode 时,把 command 改成可执行文件的绝对路径,再重启编辑器。ACP 的 stdout 只走协议消息,别往里输自然语言,包装脚本也别把日志写进 stdout。登录用 mcode login 或 mcode acp login --region cn|global [官9][官5]。
SDK 和 Computer Use:官方还提供 TypeScript SDK(@minimax-ai/code-sdk)和 Python SDK(minimax-code-sdk)来程序化驱动本机 MiniMax Code;交互式 TUI 在 macOS 和 Windows 上能通过官方插件使用 Computer Use,Headless、ACP 不支持 [官·文档索引][官5]。本指南没有展开这两部分。
10. 在 MiniMax Code 里接入其他模型 / API Key 配置
MiniMax Code 默认用你登录账号的 M Plan。还有两种用法:配自己的 MiniMax 按量计费 API Key;或者 BYOK(Bring Your Own Key),接 DeepSeek、Kimi、OpenAI、Gemini 等任何兼容服务。
10.1 桌面端:用自己的 MiniMax API Key [官27][2]
去开放平台「接口密钥 → 创建新的 API Key」拿按量计费 Key,并在「账户管理 → 余额」充值 [官24]。
打开 MiniMax Code 的「设置 → 用量与模型」,选 MiniMax API,填 Key 保存。
用连接测试确认能通。
10.2 桌面端:BYOK 自定义模型 [官27]
「设置 → 用量与模型」顶部切到「自定义模型」,点添加模型。
搜索选预设供应商,只填 API Key,接口地址和格式会自动带出;列表里没有的,选「其他」,自己填提供商名称、接口地址、API Key、API 格式,需要的话还能加自定义 Headers [2 图]。
填模型 ID,或点「自动获取」从供应商返回的模型列表里选。模型 ID 要和供应商文档一字不差。
点模型旁边的检测按钮做连通检测,再保存。保存不会自动测试,也不会切换当前任务的模型。
回到输入框,在模型菜单里选刚加的模型;支持思考参数的模型可以在参数菜单里调。
图源:[2] 猿小猴子《主流 Agent 之「MiniMax Code」介绍》
| 按钮 | 作用 |
|---|---|
| 自动获取 | 读供应商的模型列表供你选,不保存配置 |
| 连通检测 | 用当前填的信息测这个模型能不能响应 |
| 保存 | 保存配置,不自动测试、不切换当前任务的模型 |
来源:[官27]。 官方还有一篇「Agent 的 BYOK 模型配置指南」,可以让 Agent 帮你改配置文件并用 curl 验证真实回复(macOS 和 Windows 都有)[官27]。
10.3 CLI:mcode provider 配置 [官4][官6]
CLI 的 Key 只从环境变量读,不会打印出来。
用 MiniMax API Key:
macOS / Linux:
export MCODE_PROVIDER_API_KEY="你的 MiniMax API Key"
mcode provider set-minimax-keyWindows PowerShell:
$env:MCODE_PROVIDER_API_KEY = "你的 MiniMax API Key"
mcode provider set-minimax-key想换回 M Plan:mcode provider use token-plan;切到 API Key:mcode provider use api-key [官6]。也可以在 config.yaml 里写 minimaxModelSource: tokenplan 或 minimaxapi_key [官4]。
添加 OpenAI / Anthropic / Gemini 兼容服务:
export MCODE_PROVIDER_API_KEY="兼容服务的 API Key"
mcode provider add \
--name "我的兼容服务" \
--base-url "https://api.example.com/v1" \
--api-format openai-completions \
--model "model-id" \
--useWindows PowerShell 把行尾的 \ 换成反引号 `,或者写成一行。
| 参数 | 说明 |
|---|---|
--name | 显示名称,必填 |
--base-url | 接口地址,必填 |
--api-format | anthropic-messages、openai-completions、openai-responses、google-generative-ai 四选一。Gemini 只填域名时会自动补 /v1beta |
--model | 模型 ID,可以重复写多个,至少一个 |
--api-key-env | 换一个环境变量名读 Key(默认 MCODEPROVIDERAPI_KEY)。接多家时建议每家一个变量名 |
--use | 把第一个模型设成默认 |
管理命令:
mcode provider list # 列出 Provider(Key 脱敏显示)
mcode provider list --json
mcode provider test <provider-id> --model <model-id> # 测连接
mcode provider remove <provider-id> --yes # 删除必须带 --yesMiniMax 登录账号这个 Provider 由 mcode login 管,不能用 provider test 测 [官4]。
10.4 配置文件 config.yaml
位置:~/.minimax/config.yaml(改过数据目录的话在 <数据目录>/config.yaml)[官4]。
defaultModel: "provider-id/model-id"
defaultModelVariant: standard
permissionMode: auto
minimaxModelSource: token_plan| 字段 | 可选值 | 作用 |
|---|---|---|
defaultModel | provider/model,可加 #variant | 默认模型 |
defaultModelVariant | 供应商支持的变体 | 默认变体 |
permissionMode | default、auto、bypassPermissions、off | 默认权限模式 |
minimaxModelSource | tokenplan、minimaxapi_key | MiniMax 凭证来源 |
配置分三层:命令行参数(如 mcode exec --model)只管这一次;config.yaml 是全局默认;Key 用 mcode provider 管 [官4]。官方文档只列了这四个字段,完整 schema 没有公开。
10.5 常用接口地址
| 服务 | 协议 | 接口地址 |
|---|---|---|
| MiniMax 国内 | Anthropic 兼容 | https://api.minimax.cn/anthropic |
| MiniMax 国内 | OpenAI 兼容 | https://api.minimax.cn/v1 |
| MiniMax 国际 | Anthropic 兼容 | https://api.minimax.io/anthropic |
| MiniMax 国际 | OpenAI 兼容 | https://api.minimax.io/v1 |
| 其他平台 | 看对方文档 | 例如 DeepSeek、Kimi、智谱、阿里云百炼的地址见 工具指南/编程/Claude Code/指南.md 第四节 8.3 |
来源:[官22][官24],查阅日期 2026-11-07。模型名请直接从平台文档复制。
10.6 配完怎么验证
桌面端:模型旁的连通检测通过 → 新建任务选这个模型 → 发一句「你好」。
CLI:
mcode provider test <id> --model <模型>→ 进 TUI 输入/status和/model确认 → 发一句话。测试通过只说明文字请求成功;图片、视频输入能力还要按实际场景再试 [官27]。
10.7 常见报错对照
| 现象 | 可能原因 | 怎么办 |
|---|---|---|
| 连接测试失败 | Base URL、Key、模型名写错,或 API 格式选错 | 逐项核对,自定义供应商重点看 API 格式 [官28] |
| 登录了官方模型还是不可用 | 没登录、地区不对、凭证来源设错 | mcode login,/status 看账号,确认 minimaxModelSource 和你的登录方式一致 [官4][官5] |
| 国际版账号在国内用不了 CLI | 网络 | 素材 [5] 的经验是国际版需要代理、CLI 一直不通,换国内版账号 |
| 401 | Key 无效、Key 和地区不匹配、订阅 Key 和按量 Key 用反 | 国内 Key 用 .cn 地址,国际 Key 用 .io 地址 [官11] |
| 订阅了还在扣余额 | 填的是按量计费 Key | 换订阅 Key [官11] |
| 额度还有却报限流 | RPM / TPM 速率限制或高峰期动态限流 | 降低频率和并发,约 1 分钟后重试 [官11] |
| 自带模型连通了但任务效果怪 | 上下文上限、输出上限、API 格式和服务实际情况不符 | 按真实服务填写;素材 [7] 提醒连通失败不要靠反复重装解决 |
10.8 换模型以后哪些功能受影响
自定义模型的可用性、上下文长度、多模态支持和费用都由供应商决定 [官27]。
生图、TTS、H3 视频这些多模态能力依赖 MiniMax 自家模型;换成别家文本模型后,这部分能不能照常调用、怎么计费,官方没有明确说明,未核实。
0.4.5 起,自带联网搜索的模型直接用内置搜索,不再走单独的搜索 MCP [官4]。
11. 把 MiniMax 模型接到其他工具(Claude Code、Codex、Cursor 等)
订阅了 M Plan 后,可以拿订阅 Key 把 MiniMax-M3.1-Flash 接到其他 AI 工具里。所有工具共享同一份 M Plan 额度 [官10][官12]。
11.1 万能字段表
工具支持哪种协议就选哪种,两种都支持的优先 Anthropic 兼容(能用上 prompt cache)[官22]:
| 字段 | OpenAI 兼容 | Anthropic 兼容 |
|---|---|---|
| Provider | OpenAI Compatible(有的叫 Custom、OpenAI-format) | Anthropic Compatible(有的叫 Claude、Custom Anthropic) |
| Base URL(国内) | https://api.minimax.cn/v1 | https://api.minimax.cn/anthropic |
| Base URL(国际) | https://api.minimax.io/v1 | https://api.minimax.io/anthropic |
| API Key | 订阅 Key(sk-cp- 开头) | 同左 |
| Model ID | MiniMax-M3.1-Flash | 同左 |
11.2 一键配置向导(最省事)
npx -y mmx-cli@latest agent setup需要 Node.js 18 以上。在列表里选工具(Claude Code、Codex、OpenCode、Oh My Pi、Grok CLI 等),没装的话向导会帮你跑官方安装脚本,然后自动改配置文件 [官18][官19][官20][官23]。运行前关掉要配置的工具和正在打开它配置文件的编辑器,免得旧内容把新写入的覆盖掉 [官19]。
11.3 Claude Code [官18]
先清掉冲突的环境变量(它们优先级高于配置文件,会覆盖 MiniMax 设置):
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL如果 ~/.bashrc 或 ~/.zshrc 里 export 过这两个变量,把那几行也删掉。Windows 去「系统 → 高级系统设置 → 环境变量」里看有没有。
手动配置:编辑 ~/.claude/settings.json(Windows 是 C:\Users\你的用户名\.claude\settings.json),把 <MINIMAXAPIKEY> 换成订阅 Key。国际版把地址换成 https://api.minimax.io/anthropic:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.minimax.cn/anthropic",
"ANTHROPIC_AUTH_TOKEN": "<MINIMAX_API_KEY>",
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "524288",
"CLAUDE_CODE_EFFORT_LEVEL": "max",
"ANTHROPIC_MODEL": "MiniMax-M3.1-Flash[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3.1-Flash[1m]",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3.1-Flash[1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3.1-Flash[1m]"
}
}再在 ~/.claude.json(Windows C:\Users\你的用户名\.claude.json)里加上 "hasCompletedOnboarding": true,跳过官方登录引导。然后进项目目录运行 claude,选「信任此文件夹」。
用 cc-switch:macOS / Linux brew tap farion1231/ccswitch && brew install --cask cc-switch,Windows 去 GitHub Releases 下载。点右上角 +,选预设的 MiniMax,填订阅 Key,所有模型名改成 MiniMax-M3.1-Flash,勾选「声明支持1M」,在 env 里加上 CLAUDECODEAUTOCOMPACTWINDOW 和 CLAUDECODEEFFORT_LEVEL 两项,保存后点「启用」,同样要加 hasCompletedOnboarding [官18]。
验证:启动 claude,输入 /status,ANTHROPICBASEURL 应指向 api.minimax.cn/anthropic;输入 /model,当前模型应是 MiniMax-M3.1-Flash [官18]。
思考深度 [官18]:
M3.1 Flash 默认开思考且关不掉,档位
low、medium、high、xhigh、max。MAXTHINKINGTOKENS=0、"alwaysThinkingEnabled": false对它无效。默认档位由
CLAUDECODEEFFORT_LEVEL决定,不设就是high。会话中用
/effort low切换,或启动时claude --effort <档位>。设了CLAUDECODEEFFORT_LEVEL时/effort不生效,想在会话里切就先删掉这个变量。有些 Claude Code 版本会把
xhigh降成high发出去,要更深就用max。
为什么是 512K:M3.1 Flash 最高支持 1M 上下文。官方用 ProgramBench 测了 200 个任务,512K 和 1M 窗口表现接近,512K 平均每任务 token 少 18.5%,费用低约 20%。日常编程建议 512K,需要长期记住大量代码细节再用 1M [官19]。
想联网搜索,再配官方的「网络搜索 MCP」[官18]。
11.4 Codex [官19]
建议用 Codex CLI 0.146.0 以上。手动配置:编辑 ~/.codex/config.toml:
model = "MiniMax-M3.1-Flash"
model_provider = "minimax"
model_context_window = 524288
preferred_auth_method = "apikey"
forced_login_method = "api"
[model_providers.minimax]
name = "MiniMax"
base_url = "https://api.minimax.cn/v1"
experimental_bearer_token = "<MINIMAX_API_KEY>"
wire_api = "responses"重启 Codex 即可。想在 /model 里显示思考档位,还要配一份模型能力目录(modelcatalogjson),官方文档给了完整 JSON。注意不要在档位里加 {"effort": "none"},M3.1 Flash 一定会思考,选 none 会返回 400 [官19]。
11.5 OpenCode [官20]
curl -fsSL https://opencode.ai/install | bash # 或 npm i -g opencode-ai
opencode auth login选 provider 时搜索 MiniMax Token Plan (minimaxi.com),填订阅 Key,运行 opencode 后选 MiniMax-M3.1-Flash。版本太旧列表里没有这个模型的话,在 ~/.config/opencode/opencode.json 的 provider.minimax-cn-coding-plan.models 下手动加,limit 里的 context(524288)和 output(131072)两项都必须填,缺一项会启动失败。用 CC Switch 等工具改成 Anthropic 协议时,Base URL 要写 https://api.minimax.cn/anthropic/v1(带 /v1)[官20]。
11.6 Cursor [官21]
先清掉
OPENAIAPIKEY、OPENAIBASEURL环境变量。Cursor 设置 → Models → API Keys:勾选 Override OpenAI Base URL,填
https://api.minimax.cn/v1;在 OpenAI API Key 里填订阅 Key,打开 Use OpenAI API Key 并确认。模型列表底部 Add Custom Model,严格输入
MiniMax-M3.1-Flash,启用后在聊天面板选它。
限制:只有 Cursor 付费会员能配自定义模型;Override Base URL 是全局的,开了以后 Cursor 自带的 Claude / GPT 可能失效,不用 MiniMax 时要关掉;Tab 补全始终用 Cursor 自家模型。没有回复的话,在 Browser & Network 里把 HTTP Compatibility Mode 改成 HTTP/1.0 试试 [官21]。
11.7 其他工具速查 [官22]
| 工具 | 怎么配 |
|---|---|
| TRAE | AI 对话框右上角设置 → 模型 → 添加模型,服务商选 MiniMax-CN,模型选 MiniMax-M3.1-Flash,填订阅 Key |
| Kilo Code(VS Code 插件) | 先清 ANTHROPIC_* 变量;Settings 里 API Provider 选 MiniMax,Entrypoint 选 api.minimax.cn |
| Cherry Studio / Chatbox | 添加 provider 搜 MiniMax,选 MiniMax CN,填 Key 后点检查 |
| Zed | LLM Provider → Add Provider → OpenAI,填 https://api.minimax.cn/v1;保存后要再输一次 Key 回车确认 |
| Xcode 26+ | Settings → Intelligence → Add a Model Provider:URL 填 https://api.minimax.cn(不带路径),Header 改成 Authorization,Key 写 Bearer sk-cp-...(中间一个空格) |
| Qwen Code | 启动 qwen → Third-party Providers → MiniMax API Key → 区域选 China |
| Droid | ~/.factory/settings.json 的 customModels 里加 Anthropic 协议的模型 |
| Dify | 设置 → 模型供应商 → 装 Minimax 插件,API Base 填 https://api.minimax.cn/anthropic,Group ID 留空 |
| Open WebUI / LangChain / OpenHands / nanobot | 用 OpenAI 兼容地址 https://api.minimax.cn/v1 |
11.8 MiniMax CLI(mmx):把多模态能力给别的 Agent 用 [官23]
mmx 是 MiniMax 开放平台的命令行工具,和 MiniMax Code 的 mcode 是两回事。它让 Claude Code、OpenClaw 这类 Agent 也能调 MiniMax 的生图、视频、语音、视觉理解和联网搜索。
npm install -g mmx-cli # 需要 Node.js 18+
mmx auth login --api-key sk-xxxxx # 填订阅 Key,会按 Key 自动识别区域
mmx quota # 能看到 M Plan 用量就说明配好了
npx skills add MiniMax-AI/cli -y -g # 可选:装官方 SKILL,让 Agent 会用 mmx常用命令:mmx text chat、mmx image generate --prompt "..." --aspect-ratio 16:9、mmx video generate、mmx speech synthesize --text "..." --out voiceover.mp3、mmx vision describe、mmx search query [官23]。报 401 多半是区域没识别对,手动指定 mmx config set --key region --value cn(国际版 global),再用 mmx auth status 确认;国内套餐登录时尽量别开代理 [官11]。
⚠️ 素材 [5] 把
mmx config set --key region --value global/cn放在 MiniMax Code 的配置表里,容易让人以为这是mcode的命令。其实这是 MiniMax CLI(mmx)的命令;MiniMax Code CLI 切国际版用的是mcode login --region global[官4][官11]。
11.9 第三方方案:mcode-gateway(素材 [8],非官方)
素材 [8] 的作者写了一个个人项目 mcode-gateway:用 Spring Boot 把本机的 mcode-tools 命令行包成带 Token 鉴权的 HTTP 接口,提供生图、看图、搜图、ASR、TTS、音乐、视频生成等 15 个工具,供脚本或团队里的其他人调用。要点:
不是官方产品,不含文本对话接口。
它不持有 MiniMax API Key,走的是本机已登录客户端的鉴权,所以 MiniMax Code 客户端必须一直开着,客户端一退出就报
requires MCODEAUTHPROVIDER=shared-broker。作者观察到「没走账户余额扣费」,但他明确说这不等于免费,视频类会扣积分,以自己的账单为准。
下载地址是阿里云盘分享链接,不是代码仓库,来源无法核实。用之前自己评估安全性和是否符合 MiniMax 用户协议。本指南只介绍思路,不建议在不清楚的情况下部署到公网。
五、避坑与注意
1. 权限怎么选
它在这些操作前会问你:读工作区以外的文件、修改或删除文件、执行命令、用可能对外产生影响的工具(发消息、上传、提交)、处理从远程控制或 IM 发来的操作 [官28][3]。
图源:[3] AI生活Happy《一张图看懂 MiniMax Code:七个关键概念》
| 场景 | 桌面端 | CLI TUI | Headless | config.yaml |
|---|---|---|---|---|
| 每一步都问 | 主动询问 | Ask(/permission ask) | 不支持 | default |
| 常规操作自动、风险高时问 | 智能授权 | Auto(/permission auto) | smart(默认) | auto |
| 跳过常规确认 | 始终授权 | Full access(/permission full) | full | bypassPermissions |
| 关闭权限模式 | — | Off | off | off |
来源:桌面端叫法 [3];CLI [官4][官7]。/permission status 查看当前模式,Alt+M 切换。
新项目先保守;熟悉的低风险重复操作再降低确认频率;删除、覆盖、上传、发消息永远留人工确认 [官28][2][3]。
全部放开的风险不是「它会干坏事」,而是出事后你说不清它做了哪一步。放宽前先确认自己能从日志和 diff 里复核 [3]。
Full access/off只在隔离的工作区(容器、虚拟机、临时副本)里用 [官7]。CI 里:显式写
--cwd、设--timeout和--max-steps、stdout 和 stderr 分开存 [官7]。
2. 别让 Key 泄露
不要把 API Key、订阅 Key 写进对话、仓库、
AGENTS.md、插件包、截图或 CI 日志 [官7][2]。桌面端只在设置里的安全入口填 Key [官27]。CLI 用环境变量传 Key,它不会打印出来 [官4]。
登录回调 URL 里有临时凭证,别分享 [官5]。
提 GitHub Issue 前把截图里的账号和密钥遮住 [官1]。
记忆里也别存密钥 [2]。
3. 其他常见问题
| 问题 | 怎么办 |
|---|---|
| 「我无法访问文件」 | 没选工作区,先回去选文件夹 [3] |
| 定时任务没执行 | 电脑要醒着、应用要开着、任务要启用 [官28] |
| Goal 一直跑停不下来 | 目标写得太含糊;设运行时间、次数或用量上限 [2][3] |
输入 /goal 没反应 | 要从 / 菜单或 + 菜单里选 Goal [3] |
| 额度掉得快 | 简单任务调低思考深度、适时开新会话、只引入需要的文件 [官11];少生视频 |
| 一口气改了十几个文件 | 任务写清文件范围、禁止项和验证命令;先开 Plan 看方案 [7][3] |
| 网页里生成的视频播到一半杂兵还在打 | 素材 [9] 的经验:直接告诉它「放动画时全场暂停」 |
Windows PowerShell 5.1 里 curl -F 'args={...}' 引号被吃掉 | 把参数写进文件,用 -F "args=<args.json" [8] |
4. 改设备、跑脚本这类有风险的事
素材 [10] 用 MiniMax Code 通过 ADB 改造 TCL 电视:先让它读型号、固件和已装软件并备份改动前状态,只用 disable-user 禁用 22 个包、不卸载系统应用,保留回滚脚本,最后重启复核。中间还遇到厂商签名校验、SELinux 和 Windows 中文路径问题。作者提醒两点:改完一定关掉 ADB 调试,否则同一局域网的设备都可能连上;这类改造类似刷机,有人改到开不了机,动手前自己评估风险。
5. 素材之间矛盾或过时的地方
⚠️ 套餐:Token Plan(Plus / Max / Ultra,覆盖 M3 / M2.7)已停售,换成 M Plan(Go / Explore / Build,文本模型 M3.1 Flash)。素材 [2][4][5] 和截图里的套餐信息都过时了,详见第二节 1.5 [官10][官14]。
⚠️ 模型:素材 [1][6] 里的
M3.1-Flash-Preview已下线;素材 [5] 写 M3 是「当前技术旗舰」,现在 M Plan 的文本模型只有 M3.1 Flash [官10]。M3 走按量计费仍可用 [官25]。⚠️ macOS 版本:素材 [2] 写 macOS 11,官方现要求 macOS 12 [官1]。
⚠️ 下载和网页地址:素材里出现过 agent.minimaxi.com/download、agent.minimax.cn/download、code.minimax.io 三种。现在官方下载页是 code.minimax.cn/about(国内)和 code.minimax.io/about(海外),旧地址会跳转;code.minimax.io 是海外版,素材 [4] 写成网页版通用地址不准确 [官1][官17]。
⚠️ npm 安装写法:素材 [6] 用
~/.npmrc放行脚本,官方 README 用命令行参数--allow-scripts=...,以 README 为准 [官3]。⚠️ CLI 版本:素材 [5][7] 是 0.4.12(素材 [7] 还提到 v0.5.0 标签),截至 2026-11-07 README 已到 0.6.x,命令以
mcode --help为准 [官3]。⚠️ 项目规则文件:素材 [2] 说用 CLAUDE.md,官方 CLI 用的是 AGENTS.md;桌面端是否读 CLAUDE.md 未核实 [官4][官8]。
⚠️ 区域设置命令:素材 [5] 把
mmx config set --key region和 MiniMax Code 混在一起,那是 MiniMax CLI 的命令 [官11]。⚠️ 「按 Token 额度计费,不叫积分」:素材 [4] 的说法不准确,官方是额度和积分两套并存 [官11][官26]。素材 [4] 文末还有 YesApi Pro 的广告。
⚠️ 「MiniMax Code 2.0」「底层从 OpenCode 升级到 Pi Agent 架构」:这是素材 [9](11-06)的说法,本指南查阅的官方文档里没有看到对应说明,未核实。素材 [5] 的截图里桌面端 Agent 自称「Mavis」,CLI 也兼容
MAVISDATADIR变量 [官4],说明产品内部经历过改名,但具体架构以官方更新日志为准。⚠️ MCP 配置:素材 [2] 说 v3.0.66 起 MCP Servers 有独立的配置入口(插件管理 → MCP Servers,可以用表单或 JSON 添加、测试),本地配置文件常见位置是
~/.minimax/mcp.json,支持 stdio、http、streamable-http、sse。配置文件路径本指南没有在官方文档里核实。素材 [2] 给的 Playwright 示例:
{
"mcpServers": {
"playwright": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@playwright/mcp", "--browser", "chromium"],
"enabled": true,
"description": "Playwright browser automation"
}
}
}远程 MCP 要用 Token 的,用环境变量注入,别写死在配置里 [2]。
六、参考原文
| # | 标题(链接) | 公众号 | 发布 | 用到的内容 | 用图 |
|---|---|---|---|---|---|
| 1 | MiniMax Code 保姆级使用指南! | 栗子的赛博畅想 | 2026-10-14 | 插件查资料、文件夹做 PPT、做网页并自测修改、画布生图做视频、积分花费 | 09、10、11、12、13 |
| 2 | 主流 Agent 之「MiniMax Code」介绍 | 猿小猴子 | 2026-08-26 | 定位、官方链接、安装、模式、面板、Goal、Agent Team、插件形态、MCP、定时任务、旧 Token Plan(已过时) | 01、02、03、04、05、06、07、15、16 |
| 3 | 一张图看懂 MiniMax Code:七个关键概念 | AI生活Happy | 2026-11-04 | 工作区、权限三档叫法、插件、技能、目标、计划、Bot、上手清单 | 17 |
| 4 | MiniMax Code AI编程助手:下载、使用、额度一篇讲清(建议收藏) | 黄禅宗 | 2026-09-18 | 入口、三步上手、Agent Team(文末为 YesApi Pro 推广,未采用;额度说法有误,见 ⚠️) | 14 |
| 5 | MiniMax Code CLI 安装与配置 | 新叶的生信笔记 | 2026-09-19 | CLI 一键安装与验证、国内版国际版对比、买错国际版的经验 | 08 |
| 6 | MiniMax Code CLI 版本安装指南 | 王帅Blog | 2026-10-20 | npm 安装与 Node 版本、登录参数、命令表、TUI 快捷键、/model 调思考强度 | — |
| 7 | MiniMax Code CLI 装完不敢跑?跟做 3 步先让它修一个测试 | 班后进化论 | 2026-09-20 | 修一个测试的三步法、验收标准、踩坑提醒 | — |
| 8 | Token Plan 吃灰了?把 MiniMax Code 的多模态能力,变成你自己的一套 HTTP 接口 | 我的数字小宇宙 | 2026-10-18 | 第三方 mcode-gateway 的思路与限制(个人项目,网盘分发,只作介绍,不推荐直接部署) | — |
| 9 | 我用 MiniMax Code 从 0-1 用 AI 搓了两款 CG 游戏,绝了! | 甲木未来派 | 2026-11-06 | REA 逆向、H3 过场 CG、内置浏览器框选修改、Goal 用法、Build 额度消耗(架构说法未核实) | 18 |
| 10 | 我用 MiniMax Code 改造了一台 TCL 电视,又把过程做成了一条代码视频 | 小米的未来日常 | 2026-10-27 | ADB 改设备的备份、复核和安全提醒 | — |
官方文档补充(2026-11-07 查阅)
| 编号 | 页面(链接) | 用到的内容 |
|---|---|---|
| 官1 | MiniMax Code:下载与安装 | 下载地址、系统要求、Homebrew、安装报错排查 |
| 官2 | MiniMax Code CLI:快速开始 | 一键安装命令、Node 要求、验证、登录 |
| 官3 | GitHub:MiniMax-AI/minimax-code README | npm 完整命令、安装目录与数据目录、卸载、当前版本 |
| 官4 | CLI:配置与模型 | config.yaml、Provider 与 API Key、代理、插件命令 |
| 官5 | CLI:常见问题 | PATH、远程登录、Headless 参数与退出码、ACP、更新卸载 |
| 官6 | CLI:命令参考 | 全部顶层命令、provider use、退出码 |
| 官7 | CLI:安全与权限 | Ask / Auto / Full access / Off、Headless 权限、凭证保护 |
| 官8 | CLI:工作流 | mcode init、AGENTS.md、Plan Mode 命令、/add-dir |
| 官9 | CLI:ACP 集成 | 编辑器 agent_servers 配置、ACP 边界 |
| 官10 | M Plan 概览 | Go / Explore / Build、可用模型、Preview 下线 |
| 官11 | M Plan 常见问题 | 年付、额度消耗、积分包、两种 Key、401 与 region |
| 官12 | M Plan 用量说明 | 5 小时窗口与周窗口、限流 |
| 官13 | M Plan 开通订阅 | 订阅 Key 获取、只用 MiniMax Code 无需配 Key |
| 官14 | Token Plan 老用户说明 | Token Plan 停售、升级对应关系 |
| 官15 | M Plan 月付首月五折(已结束) | 三档原价 ¥49 / ¥119 / ¥469 |
| 官16 | M Plan 升级与取消 | 升级抵扣、不支持降级、自动续费关闭后不能重开 |
| 官17 | M Plan:在 MiniMax Code 中使用 | 桌面、移动、网页、CLI 四个入口 |
| 官18 | M Plan:Claude Code 接入(海外版 platform.minimax.io) | settings.json 配置、清环境变量、cc-switch、验证、思考深度 |
| 官19 | M Plan:Codex 接入 | config.toml、模型目录、512K 测试数据 |
| 官20 | M Plan:OpenCode 接入 | opencode auth login、limit 配置、Anthropic 协议地址 |
| 官21 | M Plan:Cursor 接入 | Override Base URL、Add Custom Model、已知限制 |
| 官22 | M Plan:其他工具 | 通用字段表、TRAE、Zed、Xcode 等工具配置 |
| 官23 | M Plan:MiniMax CLI(mmx) | mmx 安装登录、SKILL、命令一览 |
| 官24 | 开放平台:前置准备 | 按量 Key 与订阅 Key 获取、各系统环境变量设置 |
| 官25 | 开放平台:定价概览 | 按量计费价格(M3.1 Flash、M3) |
| 官26 | MiniMax Code:M Plan 与积分 | 每日签到规则、用量页 |
| 官27 | MiniMax Code:MiniMax API 密钥、自定义模型 / BYOK | 桌面端配 Key、BYOK 步骤与按钮说明 |
| 官28 | MiniMax Code:权限与安全确认、常见问题、应用更新与问题反馈 | 权限确认的操作类型、定时任务不执行、连接测试失败、更新 |
| 官29 | MiniMax Code CLI:WebUI | WebUI 安装启动、端口、两种工作模式 |
| 官·文档索引 | MiniMax Code 文档索引 llms.txt | 无限画布、SDK、Computer Use 等页面的存在与简介 |
图片清单
| 文件 | 内容 | 来源 |
|---|---|---|
| images/01-下载页与旧套餐价格.png | 8 月的下载页,底部是旧 Token Plan 价格 | [2] 第 53 张 |
| images/02-macOS首次打开确认.png | macOS 首次打开确认弹窗 | [2] 第 55 张 |
| images/03-桌面端首页.png | 桌面端首页与左边栏 | [2] 第 71 张 |
| images/04-设置通用与模式.png | 设置 → 通用里的 Coding / Work 模式 | [2] 第 60 张 |
| images/05-开放平台订阅Key.png | 开放平台套餐详情里的订阅 Key | [2] 第 61 张 |
| images/06-用量与模型页.png | 用量与模型:5 小时、周、视频限额 | [2] 第 62 张 |
| images/07-自定义模型弹窗.png | BYOK 自定义模型弹窗与 API 格式 | [2] 第 63 张 |
| images/08-CLI版本与帮助.jpg | mcode --version 与 --help 输出(原文件扩展名 .webp,实为 JPEG,已改) | [5] 第 3 张 |
| images/09-选择工作区文件夹.png | 选择账单文件夹作为工作区 | [1] 第 8 张 |
| images/10-插件与模型选择.png | 选中同花顺插件提问 | [1] 第 4 张 |
| images/11-内置浏览器自测网页.png | 内置浏览器里自动点击测试 | [1] 第 15 张 |
| images/12-画布添加到对话.png | 画布与「添加到对话」 | [1] 第 20 张 |
| images/13-积分包价格.png | 积分包价格 | [1] 第 16 张 |
| images/14-改代码跑测试并提交.png | 改代码、跑单测、提交 | [4] 第 1 张 |
| images/15-AgentTeam面板.png | 右侧 Agent Team 面板 | [2] 第 64 张 |
| images/16-插件市场.png | 插件市场与官方技能 | [2] 第 70 张 |
| images/17-权限五类动作.png | 权限确认的五类动作与三档叫法 | [3] 第 6 张 |
| images/18-Goal目标任务.png | 用 Goal 让它自己做路演 PPT | [9] 第 31 张 |