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

# WebUI

> 在本机启动 MiniMax Code Web，用浏览器下指令、看进度、批权限。

> [!NOTE]
>
> WebUI 是社区项目，由 [贾晓源（@Fectivnfy112357）](https://github.com/Fectivnfy112357) 开发并维护，现已在 GitHub 开源：[mcode-webui/minimax-code](https://github.com/mcode-webui/minimax-code)。第一方代码默认采用 MIT 许可，第三方组件保留各自的许可，详见仓库的 [License status](https://github.com/mcode-webui/minimax-code/blob/main/LICENSE-STATUS.md)。感谢贾晓源为 MiniMax Code 社区做出的贡献！

> [!TIP]
>
> **0.1.8 已发布**：优化 turn 渲染效率，大幅提升 UI 线程性能；修复大量 bug，重组底层模块，更轻、更快。

MiniMax Code Web 是 MiniMax Code 的浏览器客户端。你在浏览器里打开本机地址下指令，Agent 在本机进程里执行：读文件、跑命令、改代码、开浏览器、审批权限，都发生在你自己的机器上。

WebUI 和桌面端、终端客户端是同级的，不是某个客户端的网页外壳。三者实现同一套会话协议，账号、会话历史、技能、插件、记忆和定时任务在哪边打开都一样。

> [!NOTE]
>
> WebUI 仍在迭代，界面文案以你机器上的实际版本为准。安装、配置与已知限制以 [GitHub 仓库](https://github.com/mcode-webui/minimax-code) 的 README 为准；问题和建议请提到 [WebUI Issues](https://github.com/mcode-webui/minimax-code/issues)。

## 适合做什么

| 场景 | 说明 |
| - | - |
| 远程开发 | 笔记本上跑 WebUI，在浏览器里下指令、看进度、批权限 |
| 长任务盯梢 | 让 Agent 跑长流程，随时在浏览器里看变更、终端输出和子任务 |
| 审阅变更 | 在工作区面板直接看 diff，逐文件审阅、撤销或回退某一轮改动 |
| 定时自动化 | 在「定时任务」里排计划，到点自动执行，结果写回会话 |
| 手机协同 | 配对手机端后，用手机补指令、批权限、查进度 |
| 多入口同源 | 桌面端、终端、浏览器共享账号、技能、插件、记忆与定时任务 |

## 安装与启动

先安装支持的 Node.js 版本：22.19+（22.x）、24.2+（24.x）、25 或 26，然后运行：

```bash theme={null}
npm install --global @minimax-webui/minimax-code
mcode-webui
```

使用 npm 12 及以上版本时，需要显式允许原生依赖的安装脚本：

```bash theme={null}
npm install --global @minimax-webui/minimax-code --allow-scripts=better-sqlite3,bufferutil,node-pty,utf-8-validate
```

服务默认监听 `http://127.0.0.1:2233/`，在交互式终端启动时会自动打开默认浏览器。使用期间保持进程运行，按 Ctrl+C 停止。需要换端口时设置环境变量 `WEBUI_SERVER_PORT`。

查看版本和帮助（不会启动服务）：

```bash theme={null}
mcode-webui --version
mcode-webui --help
```

WebUI 使用独立的 npm 包和启动命令 `mcode-webui`；CLI 安装器安装的是 `mcode`，两者互不替代。想从源码构建，参考仓库 README 的 [Build from source](https://github.com/mcode-webui/minimax-code#build-from-source)。

### 卸载

先按 Ctrl+C 停止服务，再用安装时的同一个 npm 卸载：

```bash theme={null}
npm uninstall --global @minimax-webui/minimax-code
```

卸载不会删除数据目录。删除数据前先备份账号配置和会话，并确认没有其他 CLI 或 WebUI 共用这个目录。

## 打开页面

如果浏览器没有自动打开，访问终端打印的地址（默认 `http://127.0.0.1:2233/`）。地址里带有这次启动生成的访问凭据，页面用它连接本机的 WebSocket 服务。

![WebUI 首页工作台](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/01-home.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=93c0e7bdef709ffe2d027393484ef903)

## 创建第一个任务

1. 点首页的「选择文件夹」，选中要改的项目目录。没选目录的会话会归到「未选项目」下。
2. 在输入框写下目标，例如「把这个仓库跑起来并修掉失败的测试」。
3. 点发送。Agent 会在这个目录里读文件、跑命令；遇到需要授权的操作会弹出确认，在输入框上方点批准即可。

## 核心工作流

### 工作模式

在「设置 → 通用 → 模式」中切换：

| 模式 | 特点 | 适合 |
| - | - | - |
| 适用于编程开发 | 保留技术细节与开发工具 | 写代码、改项目、跑测试、调页面 |
| 适用于日常工作 | 能力相同，少一些技术细节 | 文档、研究、表格、日常办公自动化 |

![设置（通用）](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/08-settings.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=cf228e80b195719ba412e595b4fdd4fc)

### 项目与会话

会话按项目目录分组。选定目录后，Agent 才能读到其中的文件、命令和变更。

左侧导航栏有新建、导入会话、工作区入口（插件、定时任务、应用、远程）、置顶和项目分组，底部是账号与设置。

| 操作 | 说明 |
| - | - |
| 导入会话 | 从会话文件导入历史记录 |
| 置顶 | 把重要会话固定在导航栏上方 |
| 归档 | 收起不常用的会话，可在「已归档任务」里找回 |
| 搜索 | 按关键词找历史会话或执行命令 |
| 快速导航 | 在长对话里跳回某一轮 |

### 权限确认

输入区左下角是权限开关：

| 模式 | 行为 |
| - | - |
| 请求批准（默认） | 写文件、跑命令、对外操作前逐条询问 |
| 完全访问权限 | 不再逐条询问，适合已经信任的环境 |

Agent 需要澄清时会发问卷，需要授权时会弹确认卡片，两者都在对话里直接回答。

### 代码审查

有三种方式：

* 输入 `/` 调出 `code-review` 指令，审查整个仓库。
* 在回复里的改动卡片上点「Review」，查看这一轮的 diff。
* 在工作区面板的「变更」标签里按文件审阅全部改动，可以撤销或回退某一轮。

![对话区与改动卡片](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/06-transcript.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=fbe61dc769a576b3ed238c413aba5509)

桌面端的划词评论和回复反馈在 WebUI 里暂不可用，反馈可以直接写在对话里。

## 工作区面板

工作区面板在对话右侧，是一排标签。每个标签是固定的位置，内容可以原地替换：在新标签页里打开网页，再跳到别的网页，仍然是同一个标签。

| 标签 | 作用 |
| - | - |
| 查看文件 | 浏览工作区文件树、预览文件内容 |
| 变更 | 当前改动集，逐文件 diff、审阅与回退 |
| 终端 | 在项目目录里开终端 |
| 画布 | 无限画布，图片、视频、文本节点可以自由排布和连线 |
| 网页 | 内置浏览器打开的页面，可前进后退 |
| 应用 | 已安装 Mini App 的页面 |

新标签页上有五个入口：变更、终端、画布、应用、查看文件，另有一个地址栏可以直接输入网址。

![工作区面板](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/07-workspace-panel.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=c2a847b381bb2d90d68b7073a384b7cf)

### 内置浏览器

Browser Use 可以用隔离的 Chromium，也可以配对 Chrome / Edge 扩展。配对后 Agent 可以直接操作真实浏览器页面；是否可用取决于所选模型服务和配置。

### 外观与快捷键

「设置 → 通用 → 外观」可切换浅色、深色或跟随系统；个性化页提供主题设置；快捷键页可以查看并重新绑定输入区快捷键。

## Agent 能力

* **目标（Goal）**：用 `/目标` 给 Agent 设一个可验证的终局目标，它会持续推进，直到达标或遇到阻塞。
* **Agent Team 与自定义 Agent**：团队模式让多个 Agent 分工执行、互相校验。在插件管理里可以为某个插件指定执行 Agent。
* **Mini App**：「应用」列出本机可用的 Mini App，点击后在右侧标签里打开。
* **插件与技能**：「插件」入口有插件和技能两个页签，插件按分类浏览，卡片上显示安装状态，也支持从 GitHub 仓库导入插件。
* **MCP 服务**：在插件管理里接入外部工具和数据源，支持本地 stdio 和远程 HTTP 两种传输，HTTP 可以配置请求头、参数等。
* **记忆**：在设置里维护记忆和全局指令。记忆保存长期偏好和项目约定，全局指令对所有会话生效。

![插件与技能目录](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/02-plugins.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=76d416165ab464f6d9f0982b37f04b49)

![Mini App 应用列表](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/04-mini-apps.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=ec34061342bb4ff5b04867c6deb25152)

## 自动化与远程

### 定时任务

任务到点自动执行，结果写回对应会话。内置四个模板：

| 模板 | 说明 |
| - | - |
| 每日工作总结 | 一天结束时回顾项目进展与待办 |
| 每周计划整理 | 每周开始时梳理本周重点 |
| 定时检查项目 | 周期检查代码变化并汇总要关注的内容 |
| 一次性提醒 | 为某件事创建一个定时任务 |

编辑时可以填写名称、请求内容和执行 Agent，列表里能看到待执行的任务和历史运行记录。

![定时任务](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/03-schedule.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=b587533d6e6906ddebcb4bb976688079)

### 远程控制与 IM

「远程」页有两个页签：

* **远程控制**：与手机端配对。配对码只用一次，不落盘，也不回传浏览器。服务重启后会自动重连，手机端不用重新配对。
* **接入 IM**：把飞书、微信等 IM 通道绑定到本机 Agent，之后可以在聊天里下任务、看结果、批权限。通道状态和消息过滤规则也在这里管理。

![远程控制与 IM 接入](https://mintcdn.com/agent-cn/lmKirFnhjCzOR10O/images/cli/webui/05-remote.png?fit=max\&auto=format\&n=lmKirFnhjCzOR10O\&q=85\&s=0a7ba447d8bd6a75e1623dc69e152c09)

## 模型与账户

* **用量**：「设置 → 用量与模型」展示 5 小时限额、周限额、视频限额等配额，以及上下文窗口的使用情况。账户菜单里有每日签到，连续签到可以累积积分。
* **模型**：可以用 MiniMax 账号模型、官方 MiniMax API，也可以在「设置 → 用量与模型 → 自定义模型」里添加服务商，填写接口地址和 API Key 后选择模型。支持 `openai-completions`、`openai-responses`、`anthropic-messages` 等 API 格式。

## 与桌面端的差异

| 能力 | WebUI | 说明 |
| - | - | - |
| 端云任务接力 | 不支持 | 云端会话与交接是桌面端能力 |
| 划词评论 / 回复反馈 | 不支持 | 桌面端能力 |
| 变更图谱 | 不支持 | 桌面端工作区面板提供提交历史与分支关系 |
| 快捷小窗 | 不适用 | 桌面端提供 |
| 应用自更新 | 不适用 | 通过 npm 包升级 |
| 电脑操控 | 以插件提供 | 插件市场里的「电脑操控」 |
| 语音输入 | 暂不可用 | 语音设置页目前禁用 |
| 数据目录迁移 | 不支持 | 只展示位置 |
| 网页标签命名 | 仅隔离浏览器 | Edge / Chrome 页面不能命名 |

### 已知限制

* 部分服务只在桌面端可用，WebUI 里会隐藏对应入口。
* 进度面板在窗口宽度小于 1080px 时不可用。
* 侧栏折叠后不显示导航项。

## 常见问题

**页面一直显示「正在加载项目和会话」？**

多半是服务没就绪或连接被拒。看一下左下角状态条的连接标识；刷新页面会重新获取一份凭据。

**Agent 说没有可用模型？**

在「设置 → 用量与模型」里确认模型源和凭据。

**找不到某个功能？**

部分能力需要开关。在「设置 → 浏览器」或插件、MCP 页面确认授权和启用状态。

**能从别的机器访问吗？**

服务默认只监听回环地址。要在局域网内访问，启动时设置 `WEBUI_HOST=0.0.0.0`（可同时设 `WEBUI_OPEN_BROWSER=0`），再打开终端打印的局域网地址（带本次启动的凭据）。远程使用 Mini App 时，共享的 Mini App 端口也需要可达。此时项目文件夹和终端都在运行服务的机器上。不要把服务直接暴露到公网。

**和终端客户端能共用账号吗？**

能。数据目录 `~/.minimax`（可用 `MINIMAX_DATA_DIR` 指定）与 CLI 共享同一份登录状态、技能和插件。

## 速查

| 项目 | 值 |
| - | - |
| 启动命令 | `mcode-webui` |
| 默认地址 | `http://127.0.0.1:2233/` |
| npm 包 | `@minimax-webui/minimax-code` |
| Node.js | 22.19+（22.x）、24.2+（24.x）、25、26 |
| 监听地址 | `WEBUI_HOST`，默认 `127.0.0.1` |
| 端口覆盖 | `WEBUI_SERVER_PORT`，默认 `2233` |
| Mini App 端口 | `WEBUI_MINIAPP_PORT`，默认 `49152` |
| 自动打开浏览器 | `WEBUI_OPEN_BROWSER`，设为 `0` 关闭 |
| 数据目录 | `~/.minimax`（可用 `MINIMAX_DATA_DIR` 指定） |
| 源码与反馈 | [mcode-webui/minimax-code](https://github.com/mcode-webui/minimax-code)（MIT） |