快速开始 - MiniMax Agent 文档

MiniMax Code CLI 把 MiniMax Code 带进终端和代码仓库。本页从一键安装开始，带你登录账号、启动交互式 TUI，并完成第一个任务。

一键安装

安装器会优先复用兼容的 Node.js；本机没有兼容版本时，会在用户目录中安装独立运行时。整个过程不需要 sudo 或管理员权限。

curl -fsSL https://filecdn.minimax.chat/public/install.sh | bash

在 PowerShell 中运行：

irm https://filecdn.minimax.chat/public/install.ps1 | iex

安装完成后，重新打开终端并确认命令可用：

mcode --version
mcode --help

一键安装支持 macOS、Windows、常见 Linux 发行版和 WSL，暂不支持 Alpine / musl Linux。

进入需要处理的项目目录，再启动交互式 TUI：

cd /path/to/your/project
mcode

也可以在启动时直接提交任务：

mcode "检查当前项目中失败的测试，修复后运行相关测试验证"

第一次进入仓库时，可以先生成或更新项目指导：

mcode init .

MCode 会读取目录结构、项目规则、相关实现和可用脚本，再围绕目标推进修改与验证。描述任务时，建议同时说明期望结果、修改边界和验证方式。

# 继续当前工作区最近的 Session
mcode --continue

# 打开 Session 管理器
mcode --session

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

TUI 内也可以使用 /sessions [query] 搜索、恢复和管理 Session。

操作	用途
`Enter`	发送消息；任务运行中继续发送会加入等待队列
`Shift+Enter`	在输入框中换行
`@`	引用工作区中的文件或目录
`Ctrl+V`	粘贴剪贴板中的图片或视频文件
`Shift+Tab`	在 Default 与 Plan Mode 之间切换
`Alt+M`	在 Ask、Auto、Full access 权限模式之间切换
`Ctrl+O`	展开或收起 Thinking、工具输出与 Diff
`Ctrl+T`	展开或收起完整 Todo 列表
`PgUp` / `PgDn`	浏览对话历史；`End` 返回最新位置
`Esc`	关闭当前面板，或中断正在运行的任务

了解交互式 TUI、Headless、ACP、Provider、Skills、MCP 与 Plugin。

排查安装、登录、PATH、终端兼容与自动化输出问题。