MiniMax 刚更新了 M3.1 Flash 模型,配套推出一项限时权益:所有订阅用户均可在 MiniMax Code 内不限量使用 M3.1 Flash,截止 2026 年 10 月 25 日 23:59(UTC+8)。
此前在 OpenRouter、OpenCode 榜单上以匿名身份 “Space Bunny” 出现、累计处理超过 200 万亿 Token 的那个模型,官方确认就是 M3.1 Flash 的早期版本。
趁活动还在,我也体验了一下 MiniMax Code 的 CLI 版本。本文记录完整的安装、登录和使用流程。
安装
我使用 npm 手动安装 CLI 版本。安装前需先自行安装 Node.js,版本要求:
- Node.js
22.19.0及以上的 22.x 版本 - Node.js 24、25 或 26
Node 23 被排除在外,官方 postinstall 脚本里给出的原因是 “Node 23 has no prebuilt SQLite runtime for this MCode release”——没有对应的预编译 SQLite 运行时。
先配置 ~/.npmrc 放行 postinstall 安装脚本:
allow-scripts=@minimax-ai/code,better-sqlite3
然后安装 mcode:
npm install -g @minimax-ai/code
登录
中国大陆账号直接登录:
mcode login
Global 账号加 --region:
mcode login --region global
登录会拉起浏览器完成授权。如果是无头环境或者 SSH 远程,加 --no-browser 会直接把授权链接打印到终端:
mcode login --no-browser
登录完成后,在 TUI 里执行 /status 可以查看账号、模型和运行状态。退出登录用 mcode logout。
如果你打算用 API Key ,可以用 mcode provider 输入配置。
使用
进入项目目录,启动 TUI:
cd /path/to/your/project
mcode
也可以在启动时直接把第一条任务带进去:
mcode "检查当前项目中失败的测试,修复后运行相关测试"
完整的开发闭环包括:1. 建立上下文;2. 规划范围;3.执行修改;4.验证与留档。详见官方工作流文档。
其他使用方法,可以直接在 mcode 中提问。
常用命令
MiniMax Code 有三种入口:交互式 TUI、Headless 一次性任务和 ACP 服务端,常用命令如下:
| 命令 | 用途 |
|---|---|
mcode [prompt] | 交互式 TUI,探索仓库、持续对话、审阅修改、处理权限确认 |
mcode exec [prompt] | Headless 模式,单次执行,适合 Shell、CI、批处理和评测 |
mcode acp | 以 Agent Client Protocol 服务端运行,接入支持 ACP 的编辑器或客户端 |
mcode init [dir] | 分析代码库并生成 AGENTS.md |
mcode login / mcode logout | 登录 / 退出 |
mcode update | 检查并安装更新 |
mcode provider | 管理模型 Provider 和 API Key |
mcode plugin | 管理 MiniMax Code Plugins |
mcode -c | 继续当前工作区最近的 Session |
mcode --session [id] | 打开 Session 管理器,或按 id 打开指定 Session |
mcode -m <provider/model> | 为当前 Session 单独指定模型 |
TUI 快捷键
进入 mcode 后,输入 /help 可以查看当前版本完整的命令和快捷键。
| 操作 | 用途 |
|---|---|
Enter | 发送消息;任务运行中用于 steer 当前响应 |
Alt+Enter | 任务运行中将后续消息加入 Queue |
Shift+Enter | 在输入框中换行 |
@ | 引用工作区中的文件或目录 |
Ctrl+V | 粘贴剪贴板中的图片或视频文件 |
Shift+Tab | 切换 Plan Mode |
Alt+M | 切换 Ask / Auto / Full access 权限模式 |
Esc | 关闭当前面板,或中断正在运行的任务 |
需要注意:和其他 Agent 工具不同 mcode 的 Plan Mode 只控制规划流程,不改变工具权限。如果需要控制权限,则需要切换权限模式。
用 /model 切换思考强度
mcode 目前没有直接快捷键来切换思考强度。需要通过 /model 打开模型选择器调整。目前的模型支持状况已经嵌入TUI的页面选项:
- M3 仅支持开启和关闭 Thinking,不支持设置 Effort Level。
- M3.1-Flash 仅支持调整 Effort Level,不支持关闭 Thinking。
具体操作说明如下:
| 按键 | 作用 |
|---|---|
← / → | 调整 Thinking / Effort Level |
Tab / Shift+Tab | 在模型支持的多个上下文容量之间切换(例如 512K 和 1M) |
Enter | 应用到当前会话,同时把模型、上下文和 effort 保存为默认值 |
Esc | 放弃本次调整 |
设置后,当前的模型和 Effort Level 会同步显示在状态栏和 /status 里。
改完重启生效,新会话继承这个档位;已有会话保留自己选过的档位。
Headless 里可以给单次任务指定强度:
mcode exec --effort high "规划这次迁移"
这个 CLI 工具目前还在发展中,Github 开源。是目前 Agent 生态的重要补充。希望本文对大家有帮助,感兴趣的话,可以关注我。今天就分享到这里。