> ## 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 的入口、核心能力和文档导航。

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

  ## CLI 能做什么

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

  ## 三种入口

  ### 交互式 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](/docs/cli/automation)。

  ### ACP

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

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

  ## 一个完整的 CLI 闭环

  <Steps>
    <Step title="进入并初始化仓库">
      在项目目录运行 `mcode`；首次接入可以运行 `mcode init .` 生成或更新 `AGENTS.md`。
    </Step>

    <Step title="选择模型和权限">
      使用 `/model` 选择模型，使用 `/plan` 和 `/permission` 设置规划与工具权限。
    </Step>

    <Step title="执行并审阅">
      让 Agent 读取、修改和验证代码；在关键操作处确认权限，检查 Diff 和测试结果。
    </Step>

    <Step title="恢复或自动化">
      用 `mcode --continue` 恢复 Session，或将同一任务改写成 `mcode exec` 脚本接入 CI。
    </Step>
  </Steps>

  ## 文档导航

  <CardGroup cols={2}>
    <Card title="快速开始" icon="rocket" href="/docs/cli/quick-start">
      安装 CLI、登录账号并完成第一个终端任务。
    </Card>

    <Card title="工作流" icon="workflow" href="/docs/cli/workflows">
      学习 TUI 的仓库协作、Session、Goal、Plan 和恢复方式。
    </Card>

    <Card title="配置与模型" icon="settings" href="/docs/cli/configuration">
      配置数据目录、Provider、API Key、模型、代理、Skills、MCP 和 Plugin。
    </Card>

    <Card title="Headless 与 CI" icon="play" href="/docs/cli/automation">
      掌握 stdin、附件、结构化输出、事件流、超时和退出码。
    </Card>

    <Card title="ACP 集成" icon="plug" href="/docs/cli/integrations">
      将 CLI 接入支持 Agent Client Protocol 的编辑器和 Agent 宿主。
    </Card>

    <Card title="命令参考" icon="terminal" href="/docs/cli/reference">
      查看顶层命令、参数和可复制的调用示例。
    </Card>

    <Card title="安全与权限" icon="shield-check" href="/docs/cli/security">
      了解权限模式、密钥保护和自动化环境的安全基线。
    </Card>

    <Card title="常见问题" icon="circle-help" href="/docs/cli/faq">
      排查安装、登录、配置、终端和运行时问题。
    </Card>
  </CardGroup>

  ## 在主任务运行时追问

  从 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。Browser、Computer Use、桌面面板和桌面快捷键等宿主能力，只有当前运行环境显式提供时才会出现；桌面端图形界面请查看对应的桌面端文档。
</div>