安全な Start と再接続
セッションの安全な開始方法と切断からの復旧のベストプラクティス。
最も混乱を招く2つの問題：Claude Code を誤って二重起動してしまうことと、再接続後に古い出力が表示されること。このページでは両方の回避方法を説明します。
安全な Start
Start をタップする前に、セッションステータスインジケーターを確認：
- 緑（Running）： Claude Code はすでにアクティブ。Start をタップしないでください。
- グレー（Stopped）： Claude Code は停止中。Start をタップして起動。
アプリには重複起動防止機能が組み込まれており、Claude が実行中に Start をタップしても何も起きません。ただし、インジケーターを先に確認することで混乱を避けられます。
Claude が実行中か不明な場合
セッションセレクターを開き、セッションを再選択してください。ターミナルビューが更新され、現在の状態が表示されます。Claude Code のプロンプトが見えれば実行中、シェルプロンプトだけが見えれば停止中です。
再接続
バックグラウンドやネットワーク中断後にアプリを再開した場合：
- 自動再接続： アプリはサーバーに自動で再接続します。通常1〜3秒。
- セッション復元： tmux セッションのターミナル出力がスマホに再ストリーミングされます。
特に操作は不要 — アプリを再開するだけです。
ターミナルが空白または古い場合
長時間のバックグラウンド後に発生することがあります。対処法：
- セッションセレクター（左上）を開く
- 現在のセッションを再選択
- ターミナルビューがリフレッシュされる
セッションが削除されていた場合
サーバーの再起動などで tmux セッションが削除された場合：
- アプリは空の状態を表示
- 新しいセッションを作成して再開
長時間タスク
数分以上かかるタスクの場合：
- アプリを開いたままにしない。 iOS はいずれネットワーク接続を中断します。
- 代わりに通知を使用。 Claude Code の hook イベントがタスク完了時にプッシュ通知をトリガーします。
- 通知が届いたらアプリを開き、再接続して出力を確認。
iOS でフォアグラウンド接続を維持するより、この方法の方が確実です。
日常のルーティン
- アプリを開く。自動で再接続。
- セッションステータスを確認。Claude Code が実行中ならそのまま続行。
- 停止中なら Start をタップ。
- プロンプトを送信。長時間タスクはスマホをロックして通知を待つ。
- 完了したら、セッションを実行中のままにするか Stop をタップ。