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、專為代理設計的按鍵列,以及確實送達的提醒。