Skip to main content
MiniMax Code CLI 是面向终端和代码仓库的 Agent 入口。它把同一套 Runtime 能力暴露给交互式 TUI、一次性任务和编辑器协议。

CLI 能做什么

三种入口

交互式 TUI

适合需要观察工具调用、回答问题、审阅修改和持续推进的任务。任务运行时按 Enter 指导当前响应,按 Alt+Enter 排队后续消息;也可以用 /steer <message> 明确指导内容。

Headless

不启动 TUI,适合 Shell、CI、批处理和评测。机器输出写入 stdout,诊断写入 stderr;详见 Headless 与 CI。

ACP

通过 stdin/stdout 运行 Agent Client Protocol server。编辑器负责展示回复、工具状态、权限请求和问题选择;详见 ACP 集成。

一个完整的 CLI 闭环

1

进入并初始化仓库

在项目目录运行 mcode;首次接入可以运行 mcode init . 生成或更新 AGENTS.md。
2

选择模型和权限

使用 /model 选择模型,使用 /plan 和 /permission 设置规划与工具权限。
3

执行并审阅

让 Agent 读取、修改和验证代码;在关键操作处确认权限,检查 Diff 和测试结果。
4

恢复或自动化

用 mcode --continue 恢复 Session,或将同一任务改写成 mcode exec 脚本接入 CI。

文档导航

快速开始

安装 CLI、登录账号并完成第一个终端任务。

工作流

学习 TUI 的仓库协作、Session、Goal、Plan 和恢复方式。

配置与模型

配置数据目录、Provider、API Key、模型、代理、Skills、MCP 和 Plugin。

Headless 与 CI

掌握 stdin、附件、结构化输出、事件流、超时和退出码。

ACP 集成

将 CLI 接入支持 Agent Client Protocol 的编辑器和 Agent 宿主。

命令参考

查看顶层命令、参数和可复制的调用示例。

安全与权限

了解权限模式、密钥保护和自动化环境的安全基线。

常见问题

排查安装、登录、配置、终端和运行时问题。

在主任务运行时追问

从 0.3.2 起,使用 /btw [问题] 或 /side [问题] 可以开启临时侧会话。它继承主会话最近一个已提交边界的上下文,主任务继续运行。
侧会话保留当前工具权限,但任何具备修改能力的工具都必须经你明确确认后执行,包括 Full access 模式。侧会话输入框底部会显示主任务状态,方便发现主任务已完成或正在等待审批。临时侧会话不出现在 /sessions 或 /resume 中;切换到其他 Session 时会自动清理。快捷键是否可用取决于终端模拟器及其配置。

查看状态和额度

在 TUI 中运行 /status,可以查看运行版本、当前目录、模型、权限、账号与套餐、指令文件来源,以及 Default/Plan 模式和待生效的切换。已登录账号还会显示可用的 5 小时与每周额度摘要,包括剩余比例和重置倒计时;使用 /usage 查看详细用量。状态面板会自动换行显示长路径。账号信息加载中或查询失败时,仍可查看本地配置。

与桌面端的边界

CLI 不依赖 Electron 或桌面端 IPC,重点是终端、仓库、脚本、CI 和 ACP。Browser、Computer Use、桌面面板和桌面快捷键等宿主能力,只有当前运行环境显式提供时才会出现;桌面端图形界面请查看对应的桌面端文档。