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

# Computer Use

> 在交互式 TUI 中让 MiniMax Code 操作 macOS / Windows 电脑上的应用。

Computer Use 让 MiniMax Code 在交互式 TUI 中直接操作电脑上的应用：移动鼠标、点击、输入，并在需要时读取屏幕内容。它支持 macOS 和 Windows，需要在图形登录会话中运行 TUI。桌面端的用法请查看 [电脑操控](https://agent.minimaxi.com/docs/code/desktop/computer-use.md)。

## 使用前准备

1. 安装并启用官方 Computer Use 插件：

```bash theme={null}
mcode plugin add computer-use@official
mcode plugin enable computer-use@official
```

2. 在空闲的交互式 TUI 中检查组件和权限状态：

```text theme={null}
/computer-use status
```

3. macOS 上如果缺少系统权限，运行下面的命令为 `MiniMax Computer Use` 请求授权，并按系统提示完成：

```text theme={null}
/computer-use permissions
```

启用插件不会自动请求系统授权，需要单独执行授权命令。

## 在会话中启用

### 通过 @ 选择

在 TUI 输入框中输入 `@`，选择官方 Computer Use 插件并发送消息，当前会话即可使用 Computer Use。之后在这个会话里继续发消息，无需再次 `@`。

TUI 不沿用桌面端的「默认在对话中启用电脑操控」设置，每个会话需要单独选择。

### 启动时直接开始任务

使用 `--computer-use` 启动交互式 TUI，会为会话选择 Computer Use 并自动提交第一条任务：

```bash theme={null}
mcode --computer-use "打开浏览器，搜索今天的天气"
mcode --computer-use --session <session-id> "继续刚才的任务"
mcode --computer-use --continue "检查刚才的操作结果"
```

* 必须带非空的任务文本，可以和 `--model` 一起使用
* 启动前会检查插件已安装并启用、组件和系统权限已就绪；任一项未就绪时直接报错退出，不会提交任务
* 这个参数不会安装插件、不会请求系统授权，也不会改变全局默认设置
* 需要可交互的终端，不能和不带 ID 的 `--session`（会话选择界面）一起使用

如果提示插件未安装或未启用，先执行上面的 `mcode plugin add` 和 `mcode plugin enable`。

### 取消启用

禁用或卸载 Computer Use 插件会取消会话中的选择，重新启用后需要再次 `@`。

## 停止 Computer Use

取消当前操作或退出 TUI，都会释放对电脑的控制。

## 不支持的场景

* Linux
* `mcode exec` 等 Headless 运行、ACP、定时任务和子任务
* 桌面端和 TUI 同时控制同一台电脑：同一时间只能有一方使用 Computer Use，另一方会提示电脑正在被占用，需要等当前操作结束

> [!WARNING]
>
> Computer Use 会代替你点击和输入。运行期间请留意屏幕；涉及提交、发送、删除等操作时，建议在指令中写明预期结果。