困ったときは
CodexPocket は、Mac で動く CodexPocketMac と、iPhone の CodexPocket が組み合わさって動きます。Mac の前を離れて使う場面でも、困りごとの多くは次の 4 つに分かれます。
Pairingが完了しないProjectが表示されない- いったん使えていた
Hostに再接続できない - どこを見れば原因が分からない
まずは「Mac 側の Bridge が動いているか」と「iPhone が同じネットワークから見に行けるか」を確認すると、切り分けが早くなります。
症状から探す
| 症状 | 読むページ |
|---|---|
| QR が読めない、保存後に止まる、認証に失敗する | Pairing できないとき |
| Pairing は済んだのに Project が見えない | Project が表示されないとき |
| 以前つながっていた Host に戻れない | 再接続と再 Pairing |
| まず Mac 側のログと検出状態を見たい | ログを確認する |
| 同じ LAN や接続条件を見直したい | 接続に必要なネットワーク条件 |
先に確認すると早い 5 項目
- Mac の
一般でランタイムが実行中になっている - Mac の
一般にBridge の前提条件を満たしていませんや legacy launchd の警告が出ていない - Mac の
ペアリングで QR を表示できる - iPhone の
ホストで対象 Host に接続テストを実行できる - Mac と iPhone が同じネットワークにいる
現在のリリースはローカルネットワーク前提です。外出先や別ネットワークから直接つなごうとしている場合は、まず同じネットワークに戻してから確認してください。
症状別の入口
Pairing が終わらない
次のようなときは、まずこちらを見てください。
- QR を読み取れない
Host として保存のあとに設定が止まる認証に失敗しましたやBridge URL または Token が未設定ですと出る
Project が見えない
次のようなときに向いています。
- Pairing は済んだのに
プロジェクトが空のまま - いつも Mac で使っている workspace が iPhone に出てこない
- Host は見えるが Thread へ進めない
つながっていた Host に再接続できない
次のようなときはこちらです。
- 以前は使えていたのに
切断になった - ライブ更新が止まった
- Mac 側の設定を変えてからつながらなくなった
まずログを見たい
Mac 側で詳しく確認したいときは、次のページから入るのが早いです。
Codex CLIやgitの検出状態を見たいBridgeが起動しない理由を知りたいstdoutとstderrの保存先を知りたい
先に見るとよい場所
- Mac アプリの
一般 - Mac アプリの
ログ - Mac アプリの
詳細 - iPhone の
ホスト
CodexPocket は Mac 側に本体があるので、迷ったら先に Mac アプリを見るのが近道です。
解決しない場合
ここまで確認しても解決できない場合は、公開可能な不具合報告は GitHub Issues へ、非公開の問い合わせは contact form (English only) よりご連絡ください。