OpenAI Codex リモート実行の「Awaiting approval（承認待ち）」フリーズとQRペアリング失敗の解決法
OpenAI Codex CLIやターミナル型AIエージェントを活用すると、コマンドラインから複数ステップの自動コード生成やリファクタリング、テストの自動実行を任せることができます。デスクを離れている間も、スマホから進捗を見守りたいエンジニアが増えています。
しかし、モバイル遠隔操作を行う多くの開発者が直面するのが、「Awaiting approval（承認待ち）」のままスマホ側がフリーズする現象と、SQLiteのロックによるQRコードペアリングの無限ループです。
本記事では、これらの不具合が発生する技術的な原因と、macOS上での即時復旧コマンド、そしてプロンプトの非表示バグを根本から解消する方法を解説します。
| 発生する現象 | 根本原因 | 対策・解決コマンド |
|---|---|---|
| スマホ側が「Thinking...」でフリーズ | Macのターミナルでは承認を求めているが、モバイル側のイベントパースが欠落してプロンプトが表示されない | 非対話フラグで回避、または生のMac PTYストリーミングを使用 |
| QRペアリングが無限に待機・失敗する | SQLiteの先行書き込みログロック（state_5.sqlite-wal の残留） | 孤立プロセスを終了し、WAL/SHMファイルを一括削除 |
不具合 1: モバイル側で承認ボタンが表示されない「ゴーストプロンプト」問題
Codexがシェルコマンドの実行許可（y/n）を求める際、対話型TTYプロンプトをWebリレー用のJSONスキーマにシリアライズする過程で変換エラーが起きることがあります。
デスクトップ側のMacでは「Do you want to run this command? (y/n)」とキー入力を待っているにもかかわらず、スマホの画面上ではそのイベントが欠落し、「Thinking...」や「Processing...」と表示されたまま永遠に止まります。結果として、自宅のデスクに戻ってMacのキーボードを叩くまで何も進まなくなります。
Codex CLI側の一時的なワークアラウンド:
codex --auto-approve-commands --dangerously-skip-permissions※危険: 全自動承認を有効にすると、AIが誤って重要なファイルを削除したり、意図しない破壊的コマンドを実行した場合でも確認なしで実行されてしまいます。外出先での運用には大きなリスクを伴います。
不具合 2: SQLite WALロックによるQR接続の無限停止
Codexはローカルのセッション状態を組み込みSQLiteデータベース（~/.codex/state_5.sqlite）に記録しています。
前のセッションがネットワーク切断や強制終了で異常終了した場合、SQLiteがWrite-Ahead Logging（WAL）のデッドロック状態に陥り、新しいペアリング要求の書き込みがブロックされ、QRコードを読み取っても永遠に接続が完了しなくなります。
macOSでのロック解除手順（ターミナルで実行）:
# 残留しているCodexプロセスを強制終了
pkill -9 -f codex
# ロックされたWALとSHM一時ファイルを削除
rm -f ~/.codex/*.sqlite-wal ~/.codex/*.sqlite-shmこれでデータベースのロックが解放され、正常にQRコードペアリングができるようになります。
根本的な解決策: MackyによるMacターミナルの直接ストリーミング
中継サーバーを介したWebリレーアプリは、文字コードやエスケープシーケンスの変換エラーで承認ダイアログが消える問題を根本的に抱えています。
最も確実で安全なアプローチは、Macky を使ってMac実機の生の対話型ターミナル（PTY）をそのままWebRTCでiPhoneにストリーミングすることです。
MackyでAIエージェントを遠隔操作するメリット
- ✓プロンプトの消失ゼロ: ターミナルの文字出力を100%そのまま届けるため、「Mac側では待っているのにスマホで消える」バグが構造上存在しません。diffの色分けも正確に表示されます。
- ✓片手でワンタップ承認: 画面下部に「y」「n」「Enter」「Ctrl+C」などのショートカットボタンが常時配置されており、iOSのキーボードを都度切り替えずに1秒で承認・キャンセルできます。
- ✓スリープしてもAIが止まらない: 処理はすべてMac上で実行されているため、iPhoneをポケットにしまったり駅のWi-Fiから5Gへ切り替わっても、長時間のコード生成やテストが中断されることはありません。
- ✓Claude Code、Aider、Ollamaにも完全対応: Codexだけでなく、ターミナルで動くあらゆるAIツールを同じ操作感で扱えます。
AIエージェントの遠隔監視を、ストレスフリーに。
Mackyなら、外出先のiPhoneからCodexやClaude Codeを安全に監視・1タップ承認。設定不要で今すぐ無料でお試しいただけます。
関連ガイド・比較記事
Macのターミナルを、いつでもポケットに。
ポート開放やVPN設定は一切不要。iPhoneから自宅やオフィスのMacへWebRTCでセキュアに直結し、デスクトップ画面とネイティブシェルを遠隔操作。まずは無料でお試しいただけます（買い切り $29・サブスクなし）。