よくある問題
Tactic Remote の頻出トラブルの対処法。
サーバーに接続できない
症状： 接続がタイムアウトまたは即座に失敗。
対処：
- 両デバイスが同一 WiFi にあることを確認（ローカルモードの場合）
- Mac アプリ / サーバーが実行中であることを確認
- IP アドレスとポートが正しいことを確認。Mac で
ipconfig getifaddr en0を実行 - macOS ファイアウォールが有効な場合、アプリの着信接続を許可
- 両デバイスの VPN を無効化（トラフィックのルーティングが変わる場合がある）
- 企業/ホテルの WiFi はデバイスをアイソレーションしている可能性あり。自宅ネットワークやスマホのホットスポットで試す
IP アドレスにドットが入力できない
症状： ドイツ語やフランス語などの一部ロケールで、数字キーボードが . の代わりに , を表示。
対処： 標準のアルファベットキーボードに切り替えてドットを入力するか、メモアプリから IP アドレスをペースト。
接続済みだがターミナルが空白
症状： 緑の接続インジケーターは表示されるが、ターミナルビューに何も表示されない。
対処：
- セッションセレクターを開いてセッションを再選択
- セッションが表示されない場合は新規作成
- セッションは存在するが出力がない場合は、Start をタップして Claude Code を起動
Start をタップしても何も起きない
症状： Start をタップしても変化なし。
これは Claude Code がすでに実行中の場合に想定される動作です。 アプリには重複起動防止機能があります。ステータスインジケーターを確認 — Running（緑）が表示されていれば Claude Code はすでにアクティブです。そのままプロンプトを送信してください。
通知が届かない
症状： Claude Code がタスクを完了しても、プッシュ通知が表示されない。
対処：
- iOS 設定 > Tactic Remote > 通知 — 有効になっていることを確認
- サーバーとアプリが最新バージョンであることを確認
- 通知は Claude Code の hook イベントに依存。WebSocket 接続が到達可能であることが必要
アプリがバックグラウンドになると接続が切断される
症状： アプリをしばらく離れて戻ると、切断状態が表示される。
これは iOS の正常な動作です。 iOS はバッテリー節約のためバックグラウンドのネットワーク接続を中断します。アプリに戻ると自動的に再接続されます。
長時間タスクでは、アプリを開いたままにするよりプッシュ通知に頼ってください。
サーバー IP が変わり続ける
症状： Mac の IP が毎回変わり、保存された接続が機能しない。
対処：
- システム設定 > ネットワーク で Mac に固定 IP を割り当てる
- 手動 IP の代わりに Bonjour 自動検出を使用
- Cloudflare Tunnel で固定 URL を使用
Claude Code が "API key not set" と表示
これは Tactic Remote ではなく Claude Code のエラーです。Claude Code が動作するには Anthropic API キーが必要です。
ターミナルで設定：
または claude config で恒久的に設定。
注意： これは Tactic Remote サーバーの API キーとは別です。Anthropic キーは Claude AI サービス用。サーバー API キーは iPhone-Mac 間の接続認証用です。
さらにヘルプが必要な場合
サポートページにアクセスするか、GitHub で Issue を作成してください。以下の情報を添えてください：
- アプリバージョン
- 接続モード（ローカルまたは Cloudflare Tunnel）
- 試したことと結果