> ## Documentation Index
> Fetch the complete documentation index at: https://agent.minimaxi.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 能力总览

> 了解 MiniMax Code CLI 的入口、核心能力和文档导航。

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

## CLI 能做什么

| 能力 | 你可以做什么 | 深入文档 |
| - | - | - |
| 仓库协作 | 读取项目规则、搜索和修改文件、运行命令、查看 Diff、执行测试 | [工作流](https://agent.minimaxi.com/docs/cli/workflows.md) |
| 多轮任务 | 创建、恢复、分叉、回退、压缩和导出 Session | [工作流](https://agent.minimaxi.com/docs/cli/workflows.md) |
| 计划与权限 | 先规划再执行；控制工具操作的确认策略 | [安全与权限](https://agent.minimaxi.com/docs/cli/security.md) |
| 模型与 Provider | 使用 Token Plan、MiniMax API Key 或兼容 Provider | [配置与模型](https://agent.minimaxi.com/docs/cli/configuration.md) |
| Skills、MCP 与 Plugin | 发现能力、连接工具、安装和管理 Plugin | [配置与模型](https://agent.minimaxi.com/docs/cli/configuration.md) |
| 自动化 | 从 stdin 提交任务，读取 JSON/事件流，控制超时和步数 | [Headless 与 CI](https://agent.minimaxi.com/docs/cli/automation.md) |
| 编辑器集成 | 通过 ACP stdio 接入编辑器或其他 Agent 宿主 | [ACP 集成](https://agent.minimaxi.com/docs/cli/integrations.md) |
| 临时侧会话 | 主任务运行时使用 `/btw` 或 `/side` 基于已有上下文追问 | [工作流](https://agent.minimaxi.com/docs/cli/workflows.md) |

## 三种入口

### 交互式 TUI

```bash theme={null}
mcode
mcode "检查失败的测试并修复"
```

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

### Headless

```bash theme={null}
mcode exec --output-format json "运行最小测试集"
```

不启动 TUI，适合 Shell、CI、批处理和评测。机器输出写入 stdout，诊断写入 stderr；详见 [Headless 与 CI](https://agent.minimaxi.com/docs/cli/automation.md)。

### ACP

```bash theme={null}
mcode acp
```

通过 stdin/stdout 运行 Agent Client Protocol server。编辑器负责展示回复、工具状态、权限请求和问题选择；详见 [ACP 集成](https://agent.minimaxi.com/docs/cli/integrations.md)。

## 一个完整的 CLI 闭环

**1. 进入并初始化仓库**

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

**2. 选择模型和权限**

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

**3. 执行并审阅**

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

**4. 恢复或自动化**

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

## 文档导航

> [card] [快速开始](https://agent.minimaxi.com/docs/cli/quick-start.md)
>
> 安装 CLI、登录账号并完成第一个终端任务。

> [card] [工作流](https://agent.minimaxi.com/docs/cli/workflows.md)
>
> 学习 TUI 的仓库协作、Session、Goal、Plan 和恢复方式。

> [card] [配置与模型](https://agent.minimaxi.com/docs/cli/configuration.md)
>
> 配置数据目录、Provider、API Key、模型、代理、Skills、MCP 和 Plugin。

> [card] [Headless 与 CI](https://agent.minimaxi.com/docs/cli/automation.md)
>
> 掌握 stdin、附件、结构化输出、事件流、超时和退出码。

> [card] [ACP 集成](https://agent.minimaxi.com/docs/cli/integrations.md)
>
> 将 CLI 接入支持 Agent Client Protocol 的编辑器和 Agent 宿主。

> [card] [Computer Use](https://agent.minimaxi.com/docs/cli/computer-use.md)
>
> 在交互式 TUI 中让 Agent 操作 macOS / Windows 电脑上的应用。

> [card] [命令参考](https://agent.minimaxi.com/docs/cli/reference.md)
>
> 查看顶层命令、参数和可复制的调用示例。

> [card] [安全与权限](https://agent.minimaxi.com/docs/cli/security.md)
>
> 了解权限模式、密钥保护和自动化环境的安全基线。

> [card] [常见问题](https://agent.minimaxi.com/docs/cli/faq.md)
>
> 排查安装、登录、配置、终端和运行时问题。

## 在主任务运行时追问

从 0.3.2 起，使用 `/btw [问题]` 或 `/side [问题]` 可以开启临时侧会话。它继承主会话最近一个已提交边界的上下文，主任务继续运行。

```text theme={null}
/btw 为什么这里选择这个实现？
```

侧会话保留当前工具权限，但任何具备修改能力的工具都必须经你明确确认后执行，包括 Full access 模式。侧会话输入框底部会显示主任务状态，方便发现主任务已完成或正在等待审批。

| 操作 | 效果 |
| - | - |
| `Ctrl+/` | 切换主会话和侧会话视图，双方继续运行 |
| 侧会话中的 `/parent` | 返回主视图，保留侧会话 |
| 侧会话的空输入框中按 `Ctrl+C` | 关闭并丢弃侧会话 |
| 主视图中再次执行 `/btw` | 丢弃旧侧会话，从当前边界重新开始 |

临时侧会话不出现在 `/sessions` 或 `/resume` 中；切换到其他 Session 时会自动清理。快捷键是否可用取决于终端模拟器及其配置。

## 查看状态和额度

在 TUI 中运行 `/status`，可以查看运行版本、当前目录、模型、权限、账号与套餐、指令文件来源，以及 Default/Plan 模式和待生效的切换。已登录账号还会显示可用的 5 小时与每周额度摘要，包括剩余比例和重置倒计时；使用 `/usage` 查看详细用量。

状态面板会自动换行显示长路径。账号信息加载中或查询失败时，仍可查看本地配置。

## 与桌面端的边界

CLI 不依赖 Electron 或桌面端 IPC，重点是终端、仓库、脚本、CI 和 ACP。交互式 TUI 在 macOS 和 Windows 上可以通过官方插件使用 [Computer Use](https://agent.minimaxi.com/docs/cli/computer-use.md)；Browser、桌面面板和桌面快捷键属于桌面端能力，请查看对应的桌面端文档。