帮助中心

遇到问题？这里都有答案。

简短、以文字为主的说明——不需要看视频。如果内容过时了，给我们发邮件，我们会及时修正。

快速上手

Termio 由两部分组成：iPhone 应用（你现在正在看的，或即将安装的）和 Mac 客户端（一个免费的菜单栏小工具，负责运行你的编程 Agent 并与手机应用通信）。两者都需要—— 先从你手头有的那一个开始。

从 Mac 开始

从首页下载 TermioStatus.dmg（或运行页面上的一行安装命令），打开后拖入应用程序文件夹。
从菜单栏（一个小云朵图标）打开 Termio Status，选择"使用配对码…"
打开 iPhone 应用，点击 扫描二维码对准 Mac 屏幕——或点击 手动输入配对码，输入 Mac 上显示的 8 位配对码。
配对完成后 Mac 会立即出现在应用中。如果 tmux 或某个 Agent CLI （Claude Code / Codex / Cursor）尚未安装，应用会明确告诉你缺少哪一个—— 详见下方配置你的 Agent。

从 iPhone 开始（还没有 Mac 客户端）

首次打开看到的第一个界面就是"配对 Mac"。点击"还没有 Mac 客户端？点此获取"—— 会在你当前使用的同一域名下打开下载页面。
安装 Mac 客户端（步骤同上），然后回到这个界面。
扫描 Mac 显示的二维码，或手动输入 8 位配对码。

如果你更习惯用终端

高级用户可以直接在终端里配对，而不用菜单栏界面：

termio daemon pair --code <token> --relay-url <url> [--force] [--insecure] [--machine-name <name>]

配对码和中继地址来自手机应用的二维码/配对界面。

配对故障排查

如果配对失败，Termio 会诊断出确切原因，而不是只说"配对失败"。随时在 Mac 上运行 termio pair-doctor 查看属于以下哪种情况。下面是每种诊断结果及其原文修复方法。

ALREADY_PAIRED_SELF

This Mac is already paired to your account. Nothing to do — run termio daemon status to confirm, or termio daemon unpair first if you want a clean re-pair.

ALREADY_PAIRED_OTHER

This Mac is already linked to a DIFFERENT Termio account. Run termio daemon pair --rebind --code <code> --relay-url <url> to move it here, or termio daemon unpair to unlink it first.

STALE_TOKEN

The pairing token saved on this Mac is no longer valid on the server (it was revoked or the account was deleted). Re-pair with a fresh code from the app: termio daemon pair --code <code> --relay-url <url> --force.

DNS_FAIL

Could not resolve the relay's hostname. Check this Mac's DNS/network settings, or whether you're on a VPN or captive portal that blocks DNS lookups.

TCP_FAIL

Could not open a network connection to the relay. Check your firewall or VPN settings, or whether this network blocks the relay's port.

TLS_FAIL

The secure (TLS) connection to the relay failed. If you're pairing to a self-signed/dev relay, retry with --insecure; otherwise this may be a captive portal or proxy intercepting HTTPS.

RELAY_DOWN

The relay server is unreachable or returned an error. Wait a moment and try again.

RELAY_DEGRADED

The relay responded but reported it's degraded (e.g. its database is down). Pairing may fail intermittently — try again shortly.

TOKEN_EXPIRED

This pairing code has expired. Generate a new one in the Termio app and try again.

TOKEN_CONSUMED

This pairing code was already used. Generate a new one in the Termio app and try again.

TOKEN_INVALID

This pairing code isn't recognized by the server. Double-check you copied it correctly, or generate a new one in the app.

最常见情况："Mac 已绑定到另一个账号"对应上面的 ALREADY_PAIRED_OTHER—— 使用 --rebind将这台 Mac 转移到你的账号。

配置你的 Agent

Termio 驱动你 Mac 上已安装的编程 Agent CLI——它本身不内置任何 Agent。目前支持：

Claude Code —— 可执行文件 claude
Codex —— 可执行文件 codex
Cursor —— 可执行文件 agent（Cursor 的 CLI 名叫 "agent"，不是 "cursor"）

"找不到 CLI"

如果 Termio 在你 Mac 上找不到某个 Agent 的 CLI，它会明确告诉你查找的可执行文件名和路径。两种方法修复：

正常安装该 Agent，然后从菜单栏重启 daemon。
已安装在非标准位置？在 ~/.termio/agent-cli.json中添加覆盖配置：
```
{"agents":[{"id":"claude","binary":"/absolute/path/to/claude"}]}
```
然后重启 daemon。

Crew 与面板

面板（Pane）

Termio 正在监视的一个实时终端会话——你在应用中切换、查看实时输出的最小单位。

Crew

一组协同工作的面板——一个 manager 加一个或多个 worker，每个都运行自己的 Agent CLI。从"+"按钮创建，然后添加 worker；如果某个 worker 的 Agent CLI 未安装，你会看到上面提到的"找不到 CLI"提示。

权限卡片与回复

当你的 Agent 想要执行某个工具（编辑文件、运行 Shell 命令）时，它会暂停并发送一张标题为"Claude wants to run:"（或 Codex，取决于所用 Agent）的卡片。回复方式：

允许（Allow） —— 仅执行这一次。
本次会话都允许 —— 本次会话不再询问。
拒绝（Deny） —— Agent 跳过并自行调整。

已回复的卡片会显示"Answered"；超时未回复的会显示"Expired — check the terminal"—— 表示 Agent 没有等待就继续了。

订阅与计费

档位	并发面板数	每日实时流时长
免费版	1	约 60 分钟/天（注册首周约 180 分钟/天）
Termio Pro	4	约 240 分钟/天
Termio Max	无限制	无限制

新注册账号在首周享有更高的免费版每日流式时长，确保你第一次体验智能体会话不会中途中断。在应用内"设置 → Termio Pro/Max"中随时管理或取消订阅（这是 Apple 订阅——通过你的 Apple ID 计费，不经过我们）。以上数字可能会调整；应用内的付费墙始终反映当前的真实限制。

常见问题

我的 Mac 已经绑定到另一个账号了，怎么办？

这就是上面配对故障排查中的 ALREADY_PAIRED_OTHER 诊断。运行 termio daemon pair --rebind --code <code> --relay-url <url>将这台 Mac 转移到你的账号。

Codex 的消息太多了 / 可视终端范围太小了。

这是一个已知问题（Codex 快速输出导致实时视图不堪重负），在最新的 Mac 客户端和 iOS 版本中已修复。请更新到最新版本；如果问题仍然存在，请给我们发邮件。

Markdown（.md）文件无法预览。

已修复——请更新到最新 iOS 版本。Markdown 文件现在会直接内嵌渲染，不再回退到通用文件图标。

点击或滚动后终端好像卡住了/没反应，怎么恢复？

这几乎总是 tmux 自带的翻页视图（"copy mode"），不是崩溃——鼠标滚动或误按某个键都可能让面板进入这个模式，进入后面板看起来没反应：打字传不到你的 Agent，或者屏幕底部一直要求你输入却怎么都确认不了。内容都还在，没有丢失。请在 Mac 上（真正的 Ghostty 窗口里，不是手机上）依次尝试：

按 q ——退出 tmux 的翻页/copy mode。
按 Esc ——退出 copy mode，或取消卡住的底部输入行。
按 Ctrl+C ——如果上面两个没反应，用它取消大多数卡住的提示。
先点一下这个面板，再重复第 1–3 步——有时候需要先把焦点切到正确的面板上。
只关闭出问题的那个 Ghostty 窗口/标签页，再重新打开 Termio 的菜单栏图标——你的 Agent 一直在 Mac 上运行，不会被打断。

一般不需要整个退出 Ghostty——如果第 1–4 步都解决不了，请发邮件到 [email protected]，并说明卡住之前你点了/按了什么——这个细节能帮我们更快定位具体触发原因。

菜单栏里的"安装推荐环境"是做什么的？

它会在你的 Mac 上一键配置 fleetmux ——我们免费开源的终端环境套件：Ghostty 终端、fish shell、Starship 提示符，以及一份调校过的 tmux 配置。执行前会先列出即将安装的内容，你也可以单独取消勾选 fish 或 Ghostty，只保留 tmux/Starship 核心部分。这项功能是可选的——Termio 本身不依赖它，只是我们推荐的一种便捷设置方式。fleetmux 本身可以独立使用，配合任意终端、任意 agent，甚至不装 agent 也行；如果不想用 Mac App，也可以直接用 curl 安装——安装完成后可查看快捷键速查表。

Termio 会保存我的终端输出内容吗？

不会——中继服务器只负责转发，不是数据库，它不存储任何终端内容（没有面板输出、没有提示词、没有回复内容）。具体保存了哪些内容（账号信息、Inbox 消息）请见隐私政策。

我发现了安全问题，或想举报 Agent 的可疑行为。

请发邮件至 [email protected]，并尽量提供详细信息——截图和具体步骤能帮助我们更快修复。

还是没解决？

访问支持页面或发邮件至 [email protected]。