接続されているのに応答がない？モバイルコーディングAgentのトラブルシューティング

スマートフォンはコンピューターに接続されているのに、Claude CodeやCodexが応答しないことがあります。あるいは、リクエストを送信した後に接続が切れ、戻ってみると会話がまったく変わっていないように見えることもあります。待つべきか、再接続すべきか、Agentを起動すべきか、それとも再度送信すべきでしょうか。

次のステップは、何が欠けているかによって異なります。スマートフォンからホストへの正常な接続、入力を受け付ける準備ができているAgent、そしてそのAgentにリクエストが到達していることは、それぞれ別の状態です。この順番で確認してください。

本ガイドでは、Tactic Remoteを通じて作成された会話を対象としています。具体的な操作方法はスマートフォンおよびコンパニオン（companion）のバージョンによって異なります。表示されている通知に一致する手順に従ってください。AnthropicのRemote Controlやその他のクライアントを使用している場合は、操作系や復旧時の挙動が異なります。クライアントとコンパニオンの両方のバージョンをあわせて確認してください。1.10の概要で現在のワークフローを説明しています。

実際に目に見える状態から確認する

過去の返信やメッセージバブルは、現在のタスクの結果を証明するものではありません。調査しているリクエストに対応する出力を探してください。

ホストと元の会話を確認する

ホスト名、プロジェクト、会話のタイトルを確認してください。2つの会話が同じプロジェクトを使用していても、含まれる作業内容が異なる場合があります。新しい会話を作成することは古い会話の更新（リフレッシュ）ではなく、同じディレクトリを選択しても別のAgentのコンテキストが引き継がれるわけではありません。

プロジェクトのホームから、リクエストを送信した会話を開きます。どのAgentが使用されているかを確認してください。コンピューターやデバイスを切り替えた場合は、空の履歴を作業の消失と誤認する前に、再度ホストを検証してください。

ホスト自体に到達できない場合は、後述のネットワークのセクションに進んでください。ホストに接続できる場合は、その会話にとどまり、入力欄と最新の出力を確認してください。

これが初めての接続である場合は、既存のタスクを診断する前に、iPhone設定ガイドまたはiPadワークフローガイドに従ってください。

最初のタスクが開始されていない場合

New Conversationでは、プロジェクトとAgentを選択することでタスクの準備が整います。最初のメッセージによってタスクが開始されます。再利用可能なプロンプトを選択しただけ、または入力欄にテキストを入力しただけの場合、Agentにはまだ回答すべき内容が届いていない可能性があります。

入力欄の下にあるプロジェクトボタンを確認してください。既存のコードで作業する場合は実際のレポジトリを選択します。Independent Workspaceは別のディレクトリを作成します。次にAgentボタンを確認し、以下のような小さなリクエストを1つ送信します：

ファイルを変更せずにこのプロジェクトを調査してください。作業ディレクトリとGitブランチを報告し、アプリがどのように起動するかを説明してください。テストの実行や依存関係のインストールは行わないでください。

対象のディレクトリからの返信が得られれば、有益な出発点になります。代わりに起動プロンプトやログインプロンプトが表示された場合は、2つ目のタスクを追加する前にそのプロンプトに対処してください。

リクエストがキューに入っている場合

アプリがリクエストをキューに入っている（queued）とマークしている場合、ディスパッチを待機している状態です。付属の通知を読んでください。再接続、現在のタスクの完了待ち、承認の解決、または会話状態の同期完了を求められている可能性があります。

ご利用のビルドで入力欄の上にキューに入った下書きが表示されている場合は、付属の通知を読んでください。たとえば、syncing（同期中）の通知は、アプリがタスク状態の確立を待っていることを意味します。同じ指示を再度送信しても、最初の下書きの進行を助けることなく、別の下書きが追加されるだけです。

Restore to composerが利用可能な場合は、それを使用して待機中の指示を修正します。これにより、下書きが入力欄に戻りますが、送信はされません。入力欄にすでにテキストが含まれている間はこの操作を使用できないため、まずそのテキストを保存するか消去してください。キューに入った下書きをこれ以上実行したくない場合は削除してください。

一時停止されたキューにResume queueが表示されている場合は、表示された原因を解決した後に使用してください。これはホストへの再接続や承認の解決の代わりにはなりません。セッションが終了したという通知が表示されている場合は、まずセッションを復旧してください。Resume queueを繰り返し押しても、利用できなくなったAgentセッションを復帰させることはできません。

Agentに対応が必要な場合

ホストが接続されていても、Agentがログイン、プロジェクトの信頼に関する確認、利用制限、または承認の段階で待機していることがあります。最新の出力を読み、そこで挙げられている問題に対応してください。

Claude Codeのログイン問題については、サーバーを実行しているユーザーアカウントで、開発用コンピューター上のAgentを確認してください。TacticアカウントとClaude Codeの認証は異なる役割を持っています。セットアップに応じたAnthropicの認証手順に従ってください。必ずしもAPIキーを作成する必要はありません。ローカルでも同じ障害が発生する場合は、公式トラブルシューティングガイドを参照してください。

承認については、現在のリクエストを読み、その操作について判断してください。一般的な「continue」メッセージを送信しても、承認そのものに答えたことにはなりません。会話内の古い承認カードは過去の履歴コンテキストにすぎません。現在保留中のリクエストに対応してください。

Agentが実行されておらずメッセージが送信されなかったとTacticが明示的に報告した場合、送信ブロックのバナーにStart & Send、Queue、Editが表示されることがあります。保持されたリクエストのためにAgentを起動したい場合はStart & Sendを選択します。修正したい場合はEditを、後回しにしたい場合はQueueを選択します。これらの選択肢は、静止しているすべての画面ではなく、送信の失敗が確認された場合に適用されます。

切断後、再送信すべきかどうかを判断する

ネットワーク障害は、リクエストがホストに到達した後、スマートフォンが確認を受け取る前に発生することがあります。したがって、タイムアウト自体から何も実行されなかったと判断することはできません。

明確な「not sent」通知と、不確実な接続障害とでは、異なる対応が必要です。「the prompt may still have been sent」や「the prompt may still be running」といったメッセージが表示された場合は、すぐに重複して送信するのではなく、元の会話を確認する必要があります。

同じホストに再接続し、同じ会話を再度開いて、最新の出力とキューに入った下書きを確認します。その上で、以下の判断に従ってください：

ステータスだけでなく内容も読んでください。この例では、次のステップはファイルを読むことであり、チェックは実行されていません（Checks: Not run）。Idleラベルが表示されていたとしても、それらのメモが完成した実装に変わるわけではありません。

履歴にEarlier messages omittedと表示されている場合、表示されている記録は不完全です。過去のリクエストが見当たらないことは、それを再送信する十分な根拠にはなりません。現在のセッションがアイドル状態であることを確認したら、次のような確認が有効です。「あなたが実際に完了したこと、残っていること、私の判断を待っていることを要約してください。以前のコマンドを繰り返さないでください。」

ホストに接続できない場合

コンピューターがスリープ解除されており、コンパニオンまたはサーバーが実行されていることを確認してください。自宅のWi-Fiで機能していた接続が、モバイルデータ通信で自動的に機能するとは限りません。

ローカル接続の場合は、現在のホストアドレスと、ネットワークがデバイス間の相互アクセスを許可しているかを確認してください。Cloudflareの場合は、トンネルが実行されており、保存されているアドレスが最新であることを確認してください。一時アドレスは再起動後に変更される可能性があります。その経路に応じたローカルネットワーク設定ガイドまたはCloudflare設定ガイドに従ってください。

Windowsアカウント接続の場合は、Windowsガイドを使用して、バインドされたPC、一致するTacticアカウント、および接続されたRelay状態を確認してください。経路を修復すればホストに戻ることができますが、ホスト上で元のタスクを検査する必要があります。

サポートに最後の既知の状態を伝える

問題が解決しない場合は、スマートフォンとコンパニオンのバージョン、ホストOS、Agent、接続経路、正確なメッセージ、問題が発生する前の最後の操作を添えてサポートに連絡してください。リクエストがキューに残っているかどうか、ホストに新しい出力が表示されているかどうか、ネットワークを切り替えたかどうかも含めてください。スクリーンショットから認証情報を削除してください。

その記録は、接続の問題とAgentの問題を区別するのに役立ち、原因が解決された後に作業を再開するための明確な足がかりとなります。