1Byte Systems

指南 · 1B Terminal

在手机上接收 AI 智能体的提醒

编程智能体会停下来请求权限、完成任务或遇到错误,却没有人在看。借助 1B Terminal 和几分钟的设置,这些时刻会以可回复的通知形式送达您的 Android 手机。

设置已于 2026年11月4日 对照各工具的官方文档核实。

为什么您会错过智能体的提问

在等您的智能体什么也不做。1B Terminal 确保您能知道。

  • 它会停下来等待

    Claude Code、Codex、OpenCode 等智能体在运行命令或编辑文件之前会暂停。如果您没在看屏幕,工作就会一直停着,直到您回来。

  • 您的手机能听到

    1B Terminal 会把终端响铃和智能体的通知(OSC 9 和 OSC 777)变成 Android 通知,适用于每个您没在查看的会话。在 tmux 中也一样:从 1.2.0 版起,应用会在自己的 tmux 会话中自动开启 allow-passthrough。

  • 从通知中回复

    每条提醒都有 回复、Enter 和 y 按钮。无需打开应用,即可输入或口述回答、按 Enter 确认,或直接表示同意。

  • 即使智能体不发通知

    如果某个程序从不发送提醒,1B Terminal 可以在它忙碌一阵后输出停下来时通知您:它很可能已经完成,或正在等您。

在 1B Terminal 中设置

在手机上完成五个步骤。加粗的名称与您在应用(1.2.0 版)中看到的完全一致。

  1. 安装 1B Terminal

    在 Android 手机(Android 8.0 或更高版本)上从 Google Play 获取。无需创建账号。

    在 Google Play 上获取

  2. 添加服务器

    在 主机 中点按 + 打开 新建主机,输入地址、用户名以及密钥或密码,然后保存。连接一次并核对服务器的指纹。

  3. 为主机开启 tmux

    在主机编辑器的 会话 下,开启 连接时进入 tmux。连接中断时智能体会继续在服务器上运行,1B Terminal 会让它的提醒穿过 tmux。服务器上需要安装 tmux。

  4. 为智能体准备服务器

    打开 设置 › AI 智能体 › 为智能体配置服务器(会话的 ⋮ 菜单中也有)。这里会显示下一节中的设置,可直接复制。应用从不修改您服务器上的文件:由您自己添加。

  5. 允许通知

    在 Android 13 及更高版本上,应用请求时请允许通知。在 设置 › 通知 中,保持开启 会话需要您时通知,如有需要开启 输出停止时通知,并保持开启 从通知中回复 以显示按钮。

现在启动智能体,然后切换到其他应用或锁定手机。当智能体需要您时,通知就会到达;点按即可回到该会话。

各智能体需要更改的设置

只列出各工具官方文档中出现的设置,并附上链接,方便您自行核对。

Claude Code

默认情况下,Claude Code 不会向它无法识别的终端发送任何内容;其文档写的是“Other terminals: nothing”。让它在任何终端中都发出终端响铃,1B Terminal 就会把响铃变成通知。

文件: ~/.claude/settings.json
{
  "preferredNotifChannel": "terminal_bell"
}

您也可以在 Claude Code 中打开 /config,进入 Local notifications 并选择终端响铃。

如果您自己启动 tmux

开启 连接时进入 tmux 后,1B Terminal 已经会在自己的会话中放行提醒。如果您改为自己启动 tmux,请添加 Claude Code 文档中的这几行,并用 tmux source-file ~/.tmux.conf 重新加载。

文件: ~/.tmux.conf
set -g allow-passthrough on
set -g focus-events on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

会话状态:Claude Code v2.1.295 及更高版本会报告每个会话是在工作还是在等您(OSC 7501),1B Terminal 会在会话标签上显示。仅当 Claude Code 在 tmux 之外运行时有效。

官方文档: code.claude.com/docs/en/terminal-config · code.claude.com/docs/en/settings-reference ·

Codex

Codex 可以把提醒作为 OSC 9 通知发送,1B Terminal 会连同文字一起显示。把这几行添加到您的用户配置文件中。

文件: ~/.codex/config.toml
[tui]
notifications = true
notification_method = "osc9"
notification_condition = "always"

设为“always”时,即使终端处于焦点,Codex 也会提醒您。1B Terminal 从不针对您正在查看的会话发出提醒,因此不会收到重复通知。

官方文档: learn.chatgpt.com/docs/config-file/config-reference ·

OpenCode

OpenCode 的注意提醒默认关闭。请在它的 tui.json 中开启。

文件: tui.json
{
  "$schema": "https://opencode.ai/tui.json",
  "attention": {
    "enabled": true,
    "notifications": true
  }
}

OpenCode 的文档没有说明该文件的位置;不过文档提到可以用 OPENCODE_TUI_CONFIG 变量指定一个文件。OpenCode 只在终端失去焦点时提醒,而您离开会话时 1B Terminal 会告知它。

官方文档: opencode.ai/docs/tui ·

Antigravity CLI

Google 的 Antigravity CLI 以 agy 运行。其文档没有描述通知设置,因此请让 1B Terminal 在输出停下时提醒您。

官方文档: github.com/google-antigravity/antigravity-cli ·

其他任何智能体

在 设置 › 通知 中开启 输出停止时通知。当一个会话忙碌之后不再输出时,1B Terminal 会通知您:程序很可能已经完成,或正在等待回答。

常见问题

需要 tmux 吗?

不需要。提醒在普通 SSH 会话中同样有效,应用会在后台保持连接。推荐使用 tmux,是因为连接中断时智能体会继续在服务器上工作,重新连接后 1B Terminal 会回到同一个会话。

能在 iPhone 上使用吗?

不能。1B Terminal 仅支持 Android(8.0 或更高版本)。

会向 1Byte Systems 发送任何内容吗?

不会。连接通过 SSH 直接从您的手机到您的服务器,通知在手机上生成。中间没有 1Byte 服务器,也不需要账号。

为什么正在查看的会话不发提醒?

这是有意为之:1B Terminal 只针对您没在查看的会话发出提醒,且每个会话最多每 5 秒一次。

不打开应用也能回复吗?

可以,使用通知上的“回复”“Enter”和“y”按钮。开启应用锁定时这些按钮会隐藏。

获取 1B Terminal

在 Android 手机上与 AI 智能体协作的 SSH 终端:密钥、tmux、专为智能体设计的按键行,以及能送达您的提醒。