SSH が切れても Claude Code を動かし続ける:tmux のレシピ

tmux を使えば、SSH が切れても Claude Code は動き続けます。同じプロセスに再接続し、永続性を確かめ、AgentsRoom のオプトイン設定を使う方法です。

エージェントがサーバーで作業しています。あなたはノートパソコンを閉じます。戻ってきたとき、戻る先のプロセスはもうありません。

私たちはまさにこの要望を受け取りました。クライアントが切断されても残る永続的なリモートセッションがほしい、そうすれば別のマシンから続きができる、というものです。私たちの SSH 起動は、もともと CLI をホスト上で実行していました。それだけでは足りませんでした。プロセスはまだ対話型 SSH ターミナルに依存していたからです。

この変更は AgentsRoom 1.198.0 で出荷しました。まず手作業のレシピを、次にアプリがそれをどう使うかを紹介します。同じライフサイクルの問題は、Claude Code、Codex、その他の対話型コーディング CLI にも当てはまります。

ターミナルは接続より長く生きる必要がある

私たちの通常のリモート起動は、ターミナルが付いた SSH チャネルを使っていました。そのチャネルが消えると、ホストはハングアップシグナルを送ることがあり、エージェントは終了します。プロセスがリモートにあるというだけでは、永続的にはなりません。

tmux は、見ている側とは独立してホスト上で生きるターミナルをプロセスに与えます。その入門ガイドは、まさにこの使い方を説明しています。リモートのプログラムを接続の切断から守り、別のコンピューターからアクセスすることです。

ここで扱うのは、プロセスを生かしておくことです。クラウドセッション、スマートフォンからのリモート操作、自分のサーバーのどれを選ぶかという広い話は、リモートエージェントの 3 つの意味を読んでください。

エージェントより先に tmux を起動する

Unix 系のホストに、いつもの SSH エイリアスで接続します。リポジトリのパスは自分のものに置き換えてください。

ssh my-server
tmux -V
tmux new-session -s coding
cd ~/projects/my-repo
claude

Codex の場合は、最後の行を codex にします。CLI はサーバー上にインストールされ、サインイン済みである必要があります。最初は、試しても困らないリポジトリで始めてください。

Ctrl+B、続けて D でデタッチします。あとで再接続します。

ssh my-server
tmux list-sessions
tmux attach-session -t coding

tmux のマニュアルにデタッチとアタッチの説明があります。再アタッチすると、動いているターミナルに戻ります。タスクを送り直すことも、別のエージェントを起動することもありません。

本番の作業を任せる前にライフサイクルを確かめる

エージェントの利用枠を消費せずに、このレシピを確かめられます。新しい tmux セッションの中で、CLI の代わりにこの終わりのあるコマンドを実行します。

python3 -u -c 'import time; [(print(i, flush=True), time.sleep(1)) for i in range(60)]'

デタッチし、SSH を切断し、1 分以内にアタッチし直します。離れている間に数字が進んでいるはずです。これはあなたのホストで行う手順であり、私たちがあらゆるサーバー構成で実施したベンチマークではありません。

次に、短いエージェントのタスクを試します。再接続したら、変更されたファイルと、エージェントが返答を待っていないかを確認します。エージェントが許可の確認で待っている間も、セッションは生き続けられます。生かしておくことは、自律的にすることとは違います。

AgentsRoom で変えたこと

保存済みの SSH 接続を開き、AgentsRoom を閉じてもこのホストでエージェントを実行し続けるを有効にします。デフォルトではオフです。ホストには tmux 3.0 以降が必要です。

次に、リモートプロジェクトを開き、そこでエージェントを起動します。CLI はホスト上の名前付き tmux セッションの中で動きます。AgentsRoom の終了、ノートパソコンのスリープ、接続の切断は、そのセッションに影響しません。同じ保存済みエージェントをもう一度開くと、そのセッションにアタッチします。同じアカウントの別のコンピューターからでも同様です。

実装では 4 つの選択をしました。どれもユーザーの体験を変えるからです。

  • セッション名はエージェントの ID に従います。そのエージェントを開き直すとそのプロセスが見つかり、新しいエージェントには新しいセッションが作られます。
  • アプリは独立した tmux サーバーを使い、あなた個人の tmux 設定は読み込みません。あなたが手で管理しているセッションを並べ替えることはありません。
  • アプリの中では tmux のプレフィックスを無効にしています。Ctrl+B はコーディング CLI で使えるままで、Escape は tmux のいつもの遅延なしに CLI に届きます。
  • エージェントを明示的に再起動すると、リモートのプロセスが置き換わります。アプリを終了すると、見ている側がデタッチします。この 2 つの操作は、違う結果にならなければなりません。

最後の区別がいちばん重要です。エージェントのタブを閉じることは、作業を続けさせる方法ではありません。アプリを終了するか、ビューアーを切断してください。エージェントを明示的に閉じる、または再起動すると、AgentsRoom はリモートのセッションも止めようとします。ホストに到達できない場合、その停止は保証できません。

tmux がない、または古すぎる場合、アプリは以前と同じように起動します。チェックボックスだけで永続性が証明されるとは考えないでください。ホストを確認し、切断のテストを行ってください。これらの詳細は、2026 年 10 月 7 日に公開済みの実装と照らし合わせて確認しました。

エージェントをコンピューターにまったく依存させたくないとき

上の設定はエージェントをホスト上で生かし続けますが、AgentsRoom 自体はコンピューターで動いたままなので、AgentsRoom が止まるとチームの実行やトリガーも止まります。バージョン 1.252.0(2026 年 11 月)からは、アプリ自体をサーバーに置けます。

sudo apt install ./desktop_<version>_amd64.deb
agentsroom --server

ARM サーバーでは arm64 パッケージを使ってください。サーバーはリンクと短いコードを表示します。コンピューターかスマートフォンでリンクを開き、マシンとコードを確認して、接続 をクリックします。そのあと agentsroom --server --open ~/my-repo でプロジェクトを開けます。

ウィンドウはなく、Xvfb も VNC も使いません。スマートフォンや他のコンピューターは、エンドツーエンド暗号化のリレーを通じてサーバーのプロジェクトを表示し、そのエージェントを起動し、その質問に答えます。受信ポートは必要ありません。各エージェント CLI はサーバーにインストールし、ノートパソコンと同じようにサーバー上でサインインします。

比べておくべきコストは 2 つあります。完全なアプリなので、アイドル時に約 400 MB のメモリを使い、さらに CLI の分が加わります。また、画面のないマシンには通常キーチェーンがないため、保存した SSH とデータベースのパスワードはそこでは拒否されます。作業中に強力なマシンでエージェントを動かしたいだけなら、上の SSH オプションのほうが簡単です。

nohup と Mosh の位置づけ

nohup は、マニュアルの説明どおり、コマンドにハングアップシグナルを無視させます。あとからアタッチできる対話型ターミナルは用意してくれません。質問をしてくる可能性のあるエージェントよりも、入出力をリダイレクトしたバッチコマンドに向いています。

Mosh は、途切れがちな接続やネットワークの切り替えに対応します。そのドキュメントは、スクロールバック全体ではなく見えている画面を同期することにも注意を促しています。tmux と組み合わせて使えます。クライアントを意図的に終了したあとでセッションを使える状態に保つことは、ネットワーク間を移動することとは別の問題です。

永続化で解決しないこと

ホストは動き続けていなければなりません。再起動すると、動いているプロセスは終了します。利用枠の上限、CLI のクラッシュ、許可の確認は、依然として作業を止めることがあります。再接続して戻るのは今の画面です。別のコンピューターに表示されていたコンソールの履歴が、すべて再表示されるとは限りません。

作業は、次のセッションが読めるファイルに残してください。短いタスクメモ、変更そのもの、検証の結果です。生き残るターミナルは役に立ちます。それでも、状態がそのターミナルの中にしかないタスクは壊れやすいままです。

リモートアクセスのページでは、エージェントにたどり着く方法を説明しています。このレシピが扱うのはその次の問いです。接続がなくなったあとも、たどり着く先のエージェントがまだいるかどうかです。

よくある質問

サーバー上のコーディングエージェントは SSH の切断を乗り越えられますか?

素の対話型 SSH ターミナルは、永続化の仕組みではありません。ターミナルを失うとエージェントが止まることがあります。切断する前にサーバー上の tmux の中でエージェントを動かし、あとでそのセッションにアタッチし直してください。サーバーは動き続けている必要があり、エージェントが自分の理由で止まる可能性は残ります。

別のコンピューターから再接続できますか?

はい。同じサーバーに同じホストユーザーで接続し、名前付きの tmux セッションにアタッチします。AgentsRoom では、SSH 接続で永続セッションを有効にし、同じアカウントの別のコンピューターから同じ保存済みエージェントを開きます。別のエージェントを起動すると、別のセッションになります。

再接続は会話の再開と同じですか?

いいえ。動いている tmux セッションへのアタッチは、一度も止まっていないプロセスに戻ることです。保存された会話の再開は、CLI の履歴を読み込む新しいプロセスを起動することです。会話ファイルでは、実行中のコマンドや、終了してしまったターミナルプロセスは元に戻せません。

AgentsRoom を閉じると、永続化したリモートエージェントは止まりますか?

SSH 接続の永続セッションのオプションが有効で、ホストに tmux 3.0 以降があれば、アプリを終了してもエージェントは動き続けます。エージェントを明示的に閉じる、または再起動すると、そのプロセスの停止または置き換えを要求します。ホストに到達できない場合、その操作は確認できません。対応する tmux がなければ、起動は通常の SSH の動作に戻ります。

AgentsRoomをダウンロード

すべてのAIエージェントを、すべてのプロジェクトで、ひとつのウィンドウから実行。

AgentsRoomをダウンロード無料

コンパニオンアプリ:外出先でもエージェントを確認

Claude、Codex、Antigravity CLI、またはその他の AI プロバイダーを使用します。

バグや要望を公開バックログに直接送信できます。

続きを読む