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 生态的重要补充。希望本文对大家有帮助,感兴趣的话,可以关注我。今天就分享到这里。

参考

名称地址
快速开始https://agent.minimax.cn/docs/cli/quick-start
配置与模型https://agent.minimax.cn/docs/cli/configuration
Headless 与 CIhttps://agent.minimax.cn/docs/cli/automation
命令参考https://agent.minimax.cn/docs/cli/reference
工作流https://agent.minimax.cn/docs/cli/workflows