持続セッション
デフォルトでは、ServerCC を閉じたりターミナルから離れると、Claude Code/Codex セッションは停止します。持続セッションを使えば、Claude Code/Codex はサーバーのバックグラウンドで動作し続け、いつでも再接続して進捗を確認したり会話を続けることができます。
必要条件
持続セッションにはリモートサーバーに tmux がインストールされている必要があります。ほとんどの Linux ディストリビューションにはデフォルトで含まれていますが、パッケージマネージャーでインストールすることもできます:
# Ubuntu / Debian
sudo apt install tmux
# CentOS / RHEL / Fedora
sudo dnf install tmux
# macOS
brew install tmux
持続セッションの開始
セッションピッカーの設定セクションには持続接続モードトグルがあります。オンに切り替えてから新規セッション(または過去のセッションの任意の行)をタップすると、そのセッションを持続モードで開始/再開できます。
持続モードがオフの場合、同じ入り口から起動したセッションは離脱時に停止する通常セッションになります。
tmux がサーバーにインストールされている場合のみ「持続接続モード」トグルが表示されます。サーバー詳細画面の Tmux インストール状態行で一目で確認できます。
持続セッションへの再接続
持続セッションがバックグラウンドで動作中の場合、セッションピッカーの上部に「持続セッションを再開」バナーが表示されます。バナーには以下が表示されます:
- セッションが開始されてからの経過時間
- やり取りされたメッセージ数
- Git ブランチ(該当する場合)
バナーをタップして再接続します。以前の出力がすべて表示された状態でターミナルに戻り、中断しなかったかのように Claude との作業を続けることができます。
持続セッションからの退出
持続セッションの実行中にターミナルを退出すると、ダイアログが表示されます:
- 持続セッションを維持 — Claude Code はサーバー上で動作し続けます。後で再接続できます。
- 持続セッションを停止 — セッションは即座に終了します。Claude Code の実行が停止します。
再接続せずに持続セッションを終了することもできます — セッションピッカーの持続セッションを再開行を左にスワイプすると持続セッションを終了が表示されます。
活用例
長時間タスク
複雑なリファクタリングや機能実装を開始し、アプリを閉じて後で確認します。あなたが離れている間も Claude は作業を続けます。
不安定なネットワーク接続
ネットワーク接続が不安定な場合でも、持続セッションにより Claude の作業は切断で中断されません。接続が回復したら再接続するだけです。
進捗の確認
Claude にタスクを任せておき、定期的に再接続して進捗確認、質問への回答、ファイル変更の承認を行います。
各ワークスペースでは同時に1つの持続セッションのみ保持できます — メインブランチとすべての worktree を合わせた上限です。この上限に達すると、セッションピッカーは新規セッションを無効化し、既存のセッションを再開するか、スワイプして終了するよう案内します。持続セッションがアイドル状態(実行中のプロセスがない場合)になると、自動的にクリーンアップされます。
外部 Tmux セッションの引き継ぎ
ServerCC はアプリ外で開始された tmux セッションへの attach にも対応しています — 例えばデスクトップの SSH クライアントや別のターミナルから開いたセッションでも、内部で claude や codex が動作していれば引き継ぎ可能です。再起動することなく、長時間の作業をスマートフォンから続けられます。
サーバー詳細画面を開くと、ServerCC はホスト上でエージェントを実行中の tmux ペインをスキャンし、ホスト Tmux 引き継ぎセクションに一覧表示します。各行には作業ディレクトリ(パス末尾の要素)、検出されたエージェント(Claude Code または Codex)、ペインの開始時刻が表示されます。
行をタップすると attach します。ターミナルビューが既存のペインを開き、すべての出力はそのまま残っているため、ServerCC から開始したかのようにそのまま作業を続けられます。
外部 tmux の引き継ぎは無料で試せます — 非 Pro ユーザーは 1日に5回まで、Pro ユーザーは無制限です。ピッカーには「Daily remaining」カウンターが表示されるため、残り回数を常に把握できます。
関連項目:一般的なセッション管理はセッション、複数インスタンスの実行はバックグラウンドと並列実行、過去の接続の確認は接続履歴をご覧ください。