> ## 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.

# ACP 集成

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

<div className="code-docs">
  `mcode acp` 把 MiniMax Code 作为 Agent Client Protocol server 运行，适合接入支持 ACP 的编辑器和 Agent 宿主。

  ## ACP

  ### 启动

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

  ACP server 通过 stdin/stdout 通信。stdout 只用于协议消息，日志和诊断写入 stderr；不要向进程直接输入自然语言，也不要让包装脚本把日志混入 stdout。

  ### 编辑器配置

  支持自定义 Agent server 的编辑器可以使用以下形式：

  ```json theme={null}
  {
    "agent_servers": {
      "minimax-code": {
        "type": "custom",
        "command": "mcode",
        "args": ["acp"],
        "env": {}
      }
    }
  }
  ```

  如果编辑器找不到 `mcode`，将 `command` 改为可执行文件的绝对路径，并重启编辑器刷新 `PATH`。

  ### ACP 能力边界

  ACP 宿主可以承接：

  * Agent 回复、推理和工具状态；
  * 文件位置和 Diff 展示；
  * 权限确认和问题选择；
  * 取消运行；
  * 模型和 Plan 能力等控制项。

  具体界面和可用控制项取决于 ACP 客户端。认证仍由 `mcode login` 或 `mcode acp login --region <region>` 管理。

  ## 何时使用 ACP

  | 需求 | 推荐入口 |
  | - | - |
  | 在编辑器中展示 Agent 回复、Diff 和权限请求 | ACP |
  | 由宿主承接问题选择、取消和模型控制 | ACP |
  | 只想在终端完成一次任务 | `mcode` 或 `mcode exec` |
</div>