快速上手

从下载页下载 MXterm Pro。Mac 上得到的是 DMG，在 Apple silicon 和 Intel 上都原生运行，需要 macOS 10.15 或更高版本。Windows 电脑上，下载页提供适用于 x64 的 Windows 10 或 11 安装包，没有 ARM64 版本。本页其余内容是对照 macOS 版核实的，已知 Windows 上有差异的地方会另外说明。

在网站上点下载按钮后，会弹出 Install in three steps 窗口，显示你所选文件的安装步骤。步骤和下面的一样。

1. 打开下载好的 DMG。
2. 把 MXterm Pro 拖进应用程序。
3. 从“应用程序”里打开 MXterm Pro。
4. 如果 macOS 询问是否打开从互联网下载的应用，选择打开。

在 macOS 上，应用使用 Apple Developer ID 签名，并已通过 Apple 公证。

在 Windows 上：

1. 运行下载的 .exe。
2. 如果 Windows SmartScreen 显示Windows 已保护你的电脑，点更多信息，再点仍要运行。安装包尚未签名，所以 Windows 会把发布者显示为“未知发布者”。
3. 按安装程序的提示完成安装。

应用第一次打开时，会出现一个共六页、标题为欢迎使用 MXterm Pro的导览。点下一步逐页查看，点跳过导览关闭。导览标题栏里的语言菜单列出应用提供的所有语言，选一种，导览和应用都会切换过去。导览只会自动弹出一次，关闭后不再出现；想重看，可以在 logo 菜单的欢迎导览里重放。

导览后面，窗口里只有一个标签页 New Tab，显示创建工作区页面。界面语言取系统语言列表中第一个应用提供的语言；列表里一个都没有时用英文；之前选过的语言会保留。应用提供 English、Tiếng Việt、简体中文、日本語、한국어、Español、Français、Türkçe、Bahasa Indonesia、Português (Brasil) 和 Deutsch。之后可以在设置里更改，每种语言都以它自己的名称列出。

工作区是一个标签页，里面是一组终端分屏，全都从同一个文件夹启动。创建之前不会运行任何东西。

1. 在工作目录下输入路径，或点浏览。默认从你的主目录开始，之前用过的文件夹列在最近下面。
2. 在终端数量下选 1、2、4、6、8、9、10、12、16 或 20。下方预览显示你将得到的网格。布局可在横向（网格）和纵向（一排高列，分屏左右并排）之间切换。纵向提供 1 到 6 个分屏，选了它不提供的数量，会落到比它小的最大一档。
3. 在 AI Agent 下，用 − 和 + 按钮设置每种 Agent 运行在几个分屏里。列表依次是 Claude Code、Codex、Grok 和 Gemini CLI，然后是 Terminal (Plain Shell) 这一行，再是 OMP；其他 Agent 排在后面，已安装的在前。应用找不到其 CLI 的 Agent 会标着未安装，并带一个安装按钮，点它会打开该 Agent 的安装指南；MXterm Pro 从不替你执行安装。Cursor Agent 对应的 CLI 是 cursor-agent。应用还在检查时，或检查失败时（会出现重试链接），所有 Agent 都无法勾选，每个分屏都是普通 shell。
4. 没有分配 Agent 的分屏运行普通 shell。Terminal (Plain Shell) 这一行可以选择使用哪种 shell，并明确设置普通分屏的数量。
5. 看一遍预览下方的三个选项（见下表），然后点创建工作区，或按 Cmd+Enter（Windows 上是 Ctrl+Enter）。

创建工作区页面始终提供 Claude Code、Codex、OpenCode、GitHub Copilot、Qwen Code、Amp、Gemini CLI、Cursor Agent、Antigravity、OMP (Oh My Pi) 和 Grok。其他 Agent，如 Aider、Goose、Kimi Code 和 Devin，只有在 MXterm Pro 在你的机器上找到它们的 CLI 之后才会出现。创建工作区页面一开始是 2 个终端，只会把你已安装的 Agent 放进去。装了 Claude Code 和 Codex 时，建议各一个。否则由列表中前两个已安装的 Agent 分摊分屏，第一个拿一半（向上取整）；只装了一个 Agent 时，它拿一半，其余是普通 shell；一个都没装，则每个分屏都是普通 shell。点创建工作区时，页面会记住这次的选择（Agent、普通终端、布局和分屏数），下次从它开始，并按你选的分屏数等比缩放；记住的 Agent 如果已不再安装，就变成普通 shell。创建工作区之前，请检查 AI Agent 那几行。

如果该文件夹里已有 Agent 会话，文件夹输入框下方会出现恢复会话列表。勾选一个会话，就会在它自己的分屏里重新打开。一个工作区最多 20 个分屏，所以勾到这个数量就不能再勾了。你勾选的会话优先于“恢复之前的会话”选项，只对它自己的分屏生效。

如果该文件夹是还没有任何提交的 git 仓库，在 git worktree 中隔离特性 会先把一个空的 .gitkeep 提交为 Initial commit，因为 worktree 需要一个提交作为起点。文件夹里的其他内容都不会被暂存或提交。

标签页足够宽时，创建工作区页面分两列：左边是工作目录，右边是终端。不够宽时，比如侧边栏和右侧面板都打开，两列会合并成一列。

想进一步了解 Agent 和 worktree 的用法，可以去看 Agent 与 Control Room（原名 War Room）。

Bypass Mode 会让 Agent 跳过批准提示，直接运行命令、修改文件，不先问你。默认关闭，你不打开它就不会生效：默认情况下，Agent 会停下来问你。

如果你用过早期版本，创建工作区页面会显示一条通知，直到你关掉它或改动该选项：绕过模式现已默认关闭。Agent 在运行命令或编辑文件前会先询问。你可以通过下方开关重新开启。如果你已经自己勾选或取消勾选过这个选项，你自己的选择会保留。

打开方法：

1. 打开创建工作区页面：按 Cmd+T（Windows 上是 Ctrl+T），或点标签栏末尾的 + 并选择新建标签页。
2. 勾选启用绕过模式（自动批准 CLI 权限）。

Bypass Mode 会添加每个受支持 Agent 自己的跳过批准参数，MXterm Pro 知道其中 14 个 Agent 的参数。其他 Agent，包括 OpenCode、GitHub Copilot、Amp、Cursor Agent、Antigravity 和 OMP，无论 Bypass Mode 开或关，都用普通命令启动。

这个选择一改就保存。之后启动的每个 Agent 分屏都遵循它，包括下次启动应用时重新打开的分屏。创建工作区页面里的这个选项，就是基于参数的绕过的开关。Goose 没有参数，所以它的自动模式是一个环境变量，只在设置里提供。

• 新建标签页：按 Cmd+T（Ctrl+T）。标签页打开后停在创建工作区页面，在你创建工作区之前不会启动任何 shell。点标签栏末尾的 + 会改为打开一个菜单，见下一条；它的第一行新建标签页和 Cmd+T 作用相同。
• + 菜单：顶部是搜索框，输入内容会筛选文件夹和 Agent，按 Enter 打开第一个匹配项。新建终端打开一个标签页，里面是一个普通 shell：当前标签页是有文件夹的本地标签页时，在它的文件夹里；否则在你最近用过的文件夹里；再不然在主目录里。在 ~ 中新建终端在主目录与上述文件夹不同时，在主目录里做同样的事；打开文件夹…会先让你选一个文件夹。最近下面最多列出六个最近用过的文件夹，每个都会在该文件夹里打开一个终端标签页（搜索时会列出所有匹配项）。在 文件夹名称 中的 Agent 下面，每个已安装的 Agent 都会打开一个标签页，里面一个分屏在该文件夹里运行它，不用 worktree，也不恢复会话。没有安装任何 Agent 时，有一行会带你去设置 → Agent。除新建标签页外，每一行都恰好打开一个带一个分屏的标签页，Free 套餐的限制和任何新标签页一样适用。
• 名称：工作区标签页取用其文件夹的名称。双击标签页可重命名，Enter 保存，Esc 取消。
• 切换：点一个标签页，按 Cmd+1 到 Cmd+8 按序号切换，或在 macOS 上按 Cmd+← / Cmd+→ 切到上一个或下一个标签页（Windows 上用 Ctrl+Alt+← / Ctrl+Alt+→）。
• 顺序：拖动标签页即可移动，也可以按 Cmd+↑（Windows 上用 Ctrl+↑）把当前标签页向左移动一位。Cmd+Shift+← 和 Cmd+Shift+→ 可向左或向右移动，但 macOS 可能在应用收到之前就先截走。Cmd+↓ 不移动标签页：它会把当前分屏滚动到底部，并聚焦它的输入。侧边栏列表保持相同的顺序。
• 宽度：标签页最宽 220px，名称过长会被截断。悬停在上面可以看到完整名称。
• 独立窗口：右键点标签页，选择将标签页移动到新窗口（窗口里有多个标签页时才会出现）。移动到主窗口可以把它放回来，菜单栏图标里的 Merge All Windows 则把所有窗口重新合到一起。见分屏与拆分。
• 关闭：悬停在标签页上，点它的 ×。如果标签页里有多个终端，会先弹出确认关闭工作区标签页，点关闭标签页会结束其中的所有进程。只有一个终端的标签页会直接关闭。
• 关闭最后一个标签页后，会回到创建工作区页面。

左侧的侧边栏在工作区下列出你的工作区。每一行有项目图标和两行内容：先是名称，然后是分屏数量；如果对话已知，还有这些对话在这台 Mac 上用掉的 Token（最多过去 30 天）和按标价计算的费用，例如 6 Panes · 1.7M · $0.41。悬停在某个工作区上，用它的 ⋮ 菜单可以重命名或关闭，也可以拖动来调整顺序。新建工作区会打开一个停在创建工作区页面的新标签页。工作区、终端以及 MXterm Hosts 和 SSH 这一组，默认各占侧边栏高度的三分之一，各行是柔和的卡片。拖动两个区域之间的线可以调整大小，双击这条线可以还原。隐藏侧边栏和重启后，高度都会保留。MXterm Hosts 和 SSH 共用一个高度，因为同一时间只展开其中一个。工作区下面，终端列出当前工作区的终端，第二行是 Agent 和它的 Token 数，后面跟着该分屏所在文件夹的 git 分支（已知时才显示，SSH 分屏和其他电脑的分屏不显示）；点一个就聚焦到它的分屏。它的 全部 | 最近 开关会切换列表：最近显示这台 Mac 上每个标签页的每个分屏，按最新输出排序，使用时顺序保持不动，所以点击总会落在你瞄准的那一行（其他机器的分屏不在其中）。标题被截断时，悬停可以看到完整标题。终端下面，MXterm Hosts 列出你已配对的其他 MXterm Pro 电脑（见分屏与拆分），只有已配对机器时才默认展开；它标题栏里的设置按钮会打开设置中的远程访问与设备。展开一台机器，可以看到它的标签页卡片和卡片里的分屏，每个分屏处于五种状态之一，与手机上一致；如果标签页的 Control Room 在线，会有一行可以展开，只读查看最近 100 条消息。机器的 ⋯ 菜单里还有新建 Control Room…和新建会话…（见分屏与拆分）。你可以固定某台机器或某个标签页，也可以拖动各行调整顺序；如果保存的地址失效，MXterm Pro 会自动尝试该机器的其他已知地址（局域网或 Tailscale）。从另一台机器打开的标签页，在工作区里第二行的末尾会显示那台机器的名称和连接方式，例如 4 Panes · Mac Thuy · Tailscale；它在终端里的分屏显示各自的名称和 Agent，末尾是那台机器的名称。再往下，SSH 列出你已保存的 SSH 主机：点一个就在新标签页里打开。它的标题栏有一个新建主机按钮，还有一个打开 SSH & SFTP 会话管理器的按钮。底部是设置和应用版本号。

用 macOS 上的 Cmd+B（Windows 上是 Ctrl+B）或标题栏左侧的侧边栏按钮隐藏或显示侧边栏。更多快捷键见键盘快捷键，拆分和排列分屏见分屏。

本页的所有内容在 Free 上都能用。Free 没有分屏数量限制：你可以在所有标签页和窗口里打开任意多个分屏。除分屏外，Free 默认还限制六项，Pro 许可证会把它们全部去掉。Pro 还会加上 My Devices（无需代码或密码即可打开你其他已登录的 Mac）和长期访问密码（不会过期）。

这些是默认数字。mxterm.net 可以在固定范围内调整 Free 的数字，调整也可能到期，到期后恢复默认值。限制是在你添加东西时检查的：调低限制不会关闭已经打开或保存的内容；在 Free 上添加第二台机器会打开升级对话框，已有的机器仍然保留。第二个有成员的 Control Room 也一样：没有成员的房间不计入，已有的房间仍然保留。Control Room 和机器这两项限制由应用本身执行。手机上的 MXterm App（iPhone、iPad）和浏览器都不计入“1 台其他电脑可控制这台 Mac”的上限，只有运行 MXterm 的其他电脑才会计入。两项远程控制限制只拒绝新增的内容：已经配对的电脑和已经共享的分屏保持不变。

远程访问还有一条 Pro 限制：Free 可以开启最长 8 小时的访问密码（临时），而长期密码，或超过 8 小时的临时密码（最长 7 天），需要 Pro。密码至少 6 个字符。见设置。

通过 SFTP 浏览、编辑、上传和下载文件都是免费的，Token Meter 也是。

达到限制时，会弹出对话框说明是哪一项，并提供获取 MXterm Pro、输入许可证密钥或暂不。套餐见定价，激活密钥的方法见设置。

关闭唯一的 MXterm Pro 窗口会退出应用，所有平台都一样。它不会留在后台运行：每个标签页里的所有终端和 Agent 都会停止。退出会停止所有实时连接。MXterm Pro 的设计是保存你的共享，并在下次启动、同一个分屏再次运行后恢复；无法验证的共享会被丢弃，绝不会被扩大。

如果你打开了第二个窗口，关掉其中一个不算退出。仍有终端的窗口会先问关闭此窗口？，并提供把它的标签页移到另一个窗口的选项，而不是直接结束它们。只有最后一个窗口关闭时才会退出应用。

应用运行期间，点击菜单栏里的图标（Windows 上是系统托盘图标）会把窗口带到前台。图标菜单里有 Show MXterm Pro、Merge All Windows、Check for Updates… 和 Quit。

再次打开应用时，你的工作区标签页会带着各自的分屏布局回来，每个分屏都重新在它的文件夹里启动。如果应用记住了对话 ID，Claude Code 分屏会按 ID 重新打开它自己的对话，否则开始一段新对话。Gemini CLI、OMP 和 Grok 的分屏用 --resume 启动，Codex 的分屏用 codex resume 启动，可以接上之前的对话；其他分屏全新启动。仍停在创建工作区页面的标签页不会恢复。

应用还会大约每 3 秒记录一次每个分屏在运行什么。对 Claude Code 和 OMP，它会记住当时打开的那段对话，所以分屏重开的就是那一段，而不是选择列表，也不是该文件夹里最新的一段。如果那段对话已不存在，Claude Code、OMP 和 Grok 在大多数 shell 里会改用不带参数的 --resume 重试，而不是停在一个空白提示符上。如果你自己在普通终端分屏里启动了某个 Agent，分屏回来时仍会运行该 Agent，并以同样方式恢复，但不带它的 Bypass Mode 参数。在 Windows 上，应用不会读取分屏在运行什么，所以那里没有这些记忆。