@minimax-ai/code

MiniMax Code

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

快速开始

需要 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。

鼠标与 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，因此可以安全地用于非交互环境。

初始化代码库

mcode init .

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

Provider 与 Plugin

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

# 浏览可用 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。

ACP 集成

mcode acp

该命令通过 stdin/stdout 启动 Agent Client Protocol server，供支持 ACP 的编辑器或 Agent 客户端连接。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
mcode plugin ...	浏览和管理 Plugin
mcode acp	启动 ACP stdio server
mcode update	检查并安装更新

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

网络代理

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 始终绕过代理。

常见问题

mcode: command not found

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

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

Node.js 版本不受支持

当前支持 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