Skip to main content
MiniMax Code CLI 是 MiniMax Code 面向开发者工作流的终端入口。它与桌面客户端互为补充：客户端适合图形化任务管理和结果查看，CLI 更贴近代码仓库、终端、脚本、CI 与编辑器。

​
三种使用方式

交互式 TUI

使用 mcode 在终端中探索代码、持续对话、审阅工具调用和管理 Session。

Headless

使用 mcode exec 执行一次任务，并把结构化结果交给脚本、CI 或评测流程。

ACP

使用 mcode acp 通过标准输入输出接入支持 Agent Client Protocol 的编辑器和客户端。

​
交互式 TUI

​
从理解仓库开始

MCode 会基于当前工作区读取项目规则、目录结构、相关实现和可用脚本。mcode init . 或 /init 可以分析仓库，并生成或更新 AGENTS.md，让项目约定随代码一起维护。一个典型任务会经历：
1

理解上下文

阅读项目约定、相关实现和测试入口，确定真正的修改范围。
2

执行修改

使用文件、搜索和终端工具完成代码或文档变更；关键权限与选择由你确认。
3

验证结果

运行相关测试或检查，处理失败，并汇总改动、证据和剩余风险。

​
核心能力

​
Headless：脚本与 CI

mcode exec 不启动 TUI，适合自动化、批处理和可复现评测。
常用参数：机器输出写入 stdout，诊断信息写入 stderr。只有显式使用 --input - 时才会读取标准输入，避免 CI 意外等待输入。

​
ACP：接入编辑器

mcode acp 把 MCode 作为 ACP v1 Agent server 运行，通过 stdin/stdout 传输 NDJSON。它不需要额外启动 HTTP 服务，也不要求编辑器安装 MCode 专用插件。以 Zed 为例，在 External Agents 中添加：
接入后，Assistant 回复、Thinking、工具状态、文件位置和 Diff 可以投影到编辑器；权限确认、问题选择和取消也沿同一条 ACP 任务流处理。如果编辑器找不到 mcode，将 command 改为可执行文件的绝对路径。
mcode acp 的 stdout 只用于 ACP 协议消息。不要直接向它输入自然语言，也不要让包装脚本把日志写入 stdout。

​
命令概览

使用 mcode <command> --help 查看当前版本的完整参数合同。

​
能力边界

  • CLI 不依赖 Electron 或桌面端 IPC。Browser、Computer Use 等宿主能力只有在运行环境显式提供时才能使用。
  • 图片显示、链接点击、系统剪贴板和快捷键最终受终端模拟器及其配置影响；图片粘贴优先使用 Ctrl+V。
  • TUI、Headless 与 ACP 面向不同交互场景。ACP 客户端只会看到协议当前明确支持的命令和输入类型。