MiniMax Code

MiniMax Code 是运行在终端里的 Coding Agent。它可以理解代码库、修改文件、执行命令和测试，并把每次工作保存在可继续的 Session 中。你可以在完整的交互界面里协作，也可以通过 mcode exec 接入脚本和 CI。

正式版本的用户可见变化见 CHANGELOG.md。

快速开始

需要 Node.js 22.19+（Node 22）或 Node.js 24–26。

npm install -g @minimax-ai/code
mcode login
cd your-project
mcode

进入 TUI 后，直接描述目标即可：

帮我定位登录接口偶发 500 的原因，修复后运行相关测试

也可以把任务直接放在启动命令后：

mcode "解释这个项目的架构，并指出最值得先处理的技术债"

它能做什么

| 能力 | 你可以这样用 | | ---------- | -------------------------------------------------------------------- | | 理解代码库 | 追踪调用链、解释架构、定位错误和影响范围 | | 修改与验证 | 编辑文件、执行命令、补测试，并汇总真实验证结果 | | 持续协作 | 保存 Session，继续上次工作，在运行中 Queue 后续任务或 steer 当前方向 | | 安全控制 | 在 Ask、Auto 和 Full access 等权限模式间选择，敏感操作先确认 | | Plan Mode | 先生成并审阅计划，再决定是否进入实现 | | 文件与图片 | 在 TUI 中引用文件、粘贴图片，为任务补充现场信息 | | Providers | 使用 MiniMax 登录态，或配置自己的模型 Provider 和 API Key | | Plugins | 浏览、安装和管理 MiniMax Code Plugin，扩展 Agent 能力 | | 自动化 | 使用 Headless JSON 输出、JSON Schema 和 ACP 接入其他工具 |

常用工作流

交互式开发

# 在当前目录开始一个新任务
mcode

# 带着第一条任务进入 TUI
mcode "修复当前失败的单元测试"

# 继续当前 workspace 最近的 Session
mcode --continue

# 浏览或打开指定 Session
mcode --session
mcode --session <session-id>

运行中的 response 不会挡住下一步输入：后续消息会立即显示在 Queue 中，并在当前 response 结束后按顺序执行。需要立刻纠正当前方向时，可以在 TUI 中使用 Ctrl+X steer；Composer 有文字时 steer 当前 Draft，Composer 为空时 steer Queue 中第一条等待消息。

鼠标与 Plan Review

在支持 alternate-screen 的交互式终端中，可以使用鼠标滚轮或 PgUp / PgDn 浏览 TUI 历史；滚轮每次移动三行。拖选后的文本高亮会跟随原文本，原文离开可见区域或无法唯一定位时会清除，不会错绑到同一屏幕坐标的新内容。

Plan Review 会保持决策区可见，长计划支持滚轮和 PgUp / PgDn 浏览，也可以直接单击可见决策项。非 TTY、dumb terminal 与 Termux 使用终端原生 scrollback，不接管这些鼠标交互。

单次执行与 CI

mcode exec 不启动 TUI，适合脚本、流水线和结构化输出：

# 执行一次任务
mcode exec "分析失败测试并给出修复"

# 指定代码库并附加日志
mcode exec --cwd ./repo --file error.log "定位这次构建失败"

# 输出机器可读 JSON
mcode exec --output-format json "总结本次变更"

# 继续已有 Session
mcode exec --continue --cwd ./repo "继续修复剩余问题"

mcode exec 的结果写入 stdout，诊断信息写入 stderr。只有显式传入 --input - 时才会读取 stdin，因此可以安全地用于非交互环境。json 与 stream-json 的最终 exec.result 会在可解析时携带实际 providerId、modelId 和可选 variant，方便用量与成本工具把 Token 归因到正确模型；模型目录查询失败时会省略这个可选字段，不影响任务结果。

初始化代码库

mcode init .

该命令会分析当前代码库，并通过 Runtime 提供的 init Skill 生成或完善 AGENTS.md。

Provider 与 Plugin

/provider（或直接运行 mcode provider）负责查看模型来源，并管理 MiniMax 的两种凭据：

• ↑↓ 浏览，space 在 MiniMax OAuth（Token Plan）与 MiniMax API Key 之间切换，t 测试连通性， esc 关闭。
• e 编辑高亮的 MiniMax 行：API Key 行打开掩码输入，已保存的 Key 也可随时替换；OAuth 行直接拉起与 /login 相同的登录流程。面板会先关闭，登录完成后手动运行 /provider 重新打开。
• ● 只表示当前生效的 MiniMax 凭据来源，全列表唯一。自定义 Provider 不参与这个标记——它们用 ○ Enabled / – Disabled 表示启用状态。
• 自定义 Provider 只读但可查看：选中后展示启用状态、API 格式、Key 掩码、模型数量、Base URL 和模型列表。新增、编辑、删除和启用/停用在桌面端设置面板完成；无头与自动化场景使用下面的 mcode provider add / mcode provider remove。
• 被停用的 Provider 显示为 – Disabled，其模型不会出现在 /model 中。

# 打开只读 Provider 面板，并切换 MiniMax OAuth / API Key 来源
mcode provider

# 查看和测试 Provider
mcode provider list
mcode provider test <provider-id>

# 非交互切换 MiniMax 凭据来源
mcode provider use token-plan
mcode provider use api-key

# 无头/自动化场景管理自定义 Provider（交互式面板不提供这些操作）
# API Key 从环境变量读取，默认 MCODE_PROVIDER_API_KEY，可用 --api-key-env 指定
mcode provider add --name <name> --base-url <url> --model <model-id>
mcode provider remove <provider-id> --yes

# 浏览可用 Plugin
mcode plugin list --available

# 安装、启用或停用 Plugin
mcode plugin add <plugin-id>
mcode plugin enable <plugin-id>
mcode plugin disable <plugin-id>

直接运行 mcode plugin 会打开交互式 Plugin manager。

模型与推理强度

在 TUI 中运行 /model 选择模型：

• 模型按 Provider 分组显示；输入文字即可实时过滤 Provider ID/名称、模型 ID/显示名、variant 和 provider/model。
• ↑↓ 切换模型，enter 应用，esc 取消；输入框支持退格、删除和左右移动光标。
• 模型配置了推理强度（think effort）时，←/→ 在 low / medium / high 等档位间移动，两端不循环；未显式选择过的会话使用中位档，与 Runtime 的默认行为一致。
• 模型只支持 Thinking 开关时，←/→ 切换 On / Off；模型同时提供推理强度时只显示 effort，none / off 等关闭档位直接表示 Thinking Off，不再额外显示一套 On / Off。
• 档位在按下 enter 前只是草稿。推理强度按会话保存，状态栏和 /status 会显示当前档位。尚未创建会话时选择的档位会在会话开始后自动生效。

[V] 机读状态协议

新 TUI 统一使用 @minimax-ai/code 构建和发布，不再生成独立的 @minimax-ai/code-vela bundle，也没有构建期 mode 概念。需要机器可读状态的宿主，在 ~/.minimax/config.yaml 的 tui.statusLine 里显式列出 build-mode 项即可开启（别名 status-protocol / vela 同样识别），默认不开启。开启后该行只输出无 ANSI 的 机器契约：

[V] seq=<base36> state=<state> session=<ref|none> turn=<ref|none> request=<ref|none> agents=<active>/<total>

state 只取 ready / run / perm / ask / plan / done / fail / cancel / error。启动、重连、重试、压缩、停止中和交互提交中统一投影为 run；blocked 投影为 fail，但精确结果仍保留在 ExecResultV1。终态 done / fail / cancel 必带 turn，error 是不归属 turn 的致命协议或会话错误。三个 ref 都是固定 6 位的 opaque base36 token，不暴露 Runtime id。Agent Team 计数通过 Runtime snapshot 与全局 SSE 事件对账维护。自动化只读取这条状态行，不扫描 pane 的正文或弹窗。完整行最大为 86 列；评测 tmux 请至少提供 86 列（Ludus 默认远大于此）。详见 状态栏配置指南。

ACP 集成

mcode acp

该命令通过 stdin/stdout 启动 Agent Client Protocol server，供支持 ACP 的编辑器或 Agent 客户端连接。支持列举、加载、恢复和关闭持久化 Session，Client 重启或 ACP 进程退出后可以继续原对话。stdout 会完整保留给协议消息，不要把它当作普通交互命令运行。

命令速查

| 命令 | 用途 | | ------------------------ | -------------------------------------- | | mcode [prompt] | 启动交互式 TUI | | mcode --continue | 继续当前 workspace 最近的 Session | | mcode --session [id] | 浏览或打开 Session | | mcode exec [prompt] | 执行一次 Headless 任务 | | mcode init [directory] | 分析项目并生成 AGENTS.md | | mcode login / logout | 管理 MiniMax 登录态 | | mcode provider ... | 管理 Provider、API Key 与 MiniMax 来源 | | mcode plugin ... | 浏览和管理 Plugin | | mcode acp | 启动 ACP stdio server | | mcode update | 检查并安装更新 |

运行 mcode --help 或 mcode <command> --help 查看当前版本的完整参数。

在 TUI 中使用 /export 将当前 Session 导出为 Markdown：

/export
/export ./session.md

导出完成后会显示可点击的本地文件链接；不支持终端超链接时仍会显示文件路径。

网络代理

MiniMax Code 自动读取 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 和 NO_PROXY，也兼容对应的小写变量：

export HTTPS_PROXY=http://127.0.0.1:7890
mcode

localhost、127.0.0.1 和 ::1 始终绕过代理。

常见问题

确认全局 npm bin 目录已加入 PATH，然后运行：

npm list -g @minimax-ai/code --depth=0
npm prefix -g

当前支持 Node.js >=22.19 <23 或 >=24 <27。Node 23 不在支持范围内。切换版本后重新安装包：

node --version
npm install -g @minimax-ai/code

先检查版本、登录态和 Provider：

mcode --version
mcode login
mcode provider list
mcode provider test <provider-id>

更新与卸载

# 检查并安装更新
mcode update

# 卸载
npm uninstall -g @minimax-ai/code

License

MIT