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 で設定する

スマートフォンで 5 つの手順です。太字の名前は、アプリ(バージョン 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 に伝えます。

公式ドキュメント: opencode.ai/docs/tui ·

Gemini CLI

Google は 2026年6月18日に個人アカウント向けの Gemini CLI を終了しました。ビジネスライセンスや API キーでは引き続き使えます。その方法で使う場合は、出力が止まったときに通知 をオンにすれば、止まったときに 1B Terminal が知らせます。

公式ドキュメント: developers.google.com/gemini-code-assist/docs/deprecations/code-assist-individuals ·

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 秒に 1 回です。

アプリを開かずに返信できますか?

はい。通知の「返信」「Enter」「y」ボタンを使います。アプリのロックがオンのときは表示されません。

1B Terminal を入手

Android スマートフォンから AI エージェントと作業するための SSH ターミナル。鍵、tmux、エージェント向けのキー列、そしてきちんと届く通知。