メインコンテンツまでスキップ
バージョン: next

ログを確認する

接続や Pairing で詰まったとき、いちばん確実なのは Mac 側の状態を見ることです。CodexPocket では、原因確認に使う場所がだいたい決まっています。

  • 一般 ランタイム、ヘルス、警告
  • ログ Bridge の stdout と stderr
  • 詳細 Codex CLI、git、シェル、設定ファイルの保存先

まず見る順番​

  1. Mac の 一般 を開く
  2. ランタイム と ヘルス を見る
  3. 警告が出ていれば、その内容を先に片付ける
  4. ログ で stdout と stderr を見る
  5. 必要なら 詳細 で依存関係とパスを確認する

一般 で分かること​

ランタイム​

主な見え方は次のとおりです。

  • 実行中 Bridge は起動しています
  • 起動中… 立ち上がり待ちです
  • 停止中 Bridge が動いていません
  • 外部の Bridge を検出 同じポートで別の Bridge が動いています

ヘルス​

status と version が見えていれば、Bridge のヘルスチェックは通っています。ランタイム が 実行中 でも ヘルス が取れない場合は、Bridge プロセスはいるのに応答できていない可能性があります。

よく出る警告​

  • Bridge の前提条件を満たしていません Codex CLI または シェル が見えていないことがあります
  • legacy launchd の警告 ~/Library/LaunchAgents に古い Bridge 設定が残って競合している可能性があります
  • Project が 1 件もありません Pairing 自体はできても、iPhone に workspace が出ません

ログ で分かること​

ログ タブでは、次をその場で確認できます。

  • stdout Bridge が通常出力している内容
  • stderr エラーや異常系の出力

画面右上の 更新 で最新を読み直せます。ログフォルダを開く を押すと、実際の保存先も開けます。

ログの保存先​

ログは次に保存されます。

~/Library/Application Support/CodexPocketMac/logs/

主なファイルは次の 2 つです。

  • bridge.stdout.log
  • bridge.stderr.log

アプリを閉じずに見たいなら ログ タブ、Finder で追いたいならログフォルダ、という使い分けが便利です。

詳細 で分かること​

詳細 では、Bridge を動かす前提条件と保存先を確認できます。

実行ファイルパス では、Codex CLI、git、シェル を個別に指定できます。空に保存すると、その項目だけ自動検出へ戻ります。

依存関係​

  • Codex CLI codex が見つかるか、codex app-server --help が通るか
  • git ブランチ操作を使うなら必要です
  • シェル 実行可能なシェルが解決できるか

パス​

主に次を確認できます。

  • 設定ファイル
  • projects.json
  • codex-remote.env
  • Codex CLI の実パス
  • git の実パス
  • シェル の実パス

「ターミナルでは動くのに Mac アプリでは認識されない」というときは、この画面でアプリから見えているパスを確認すると早く切り分けできます。

症状別に見るポイント​

Codex CLI missing に近い状態​

詳細 の Codex CLI を見ます。Mac アプリは app から見える PATH だけでなく、login shell の which -a codex と標準的な standalone / Homebrew / Codex app の場所も確認します。それでも見つからない場合は、実行ファイルパス で Codex CLI に which codex の結果または実行ファイルのパスを指定します。

git missing​

通常の Thread 操作だけなら大きな問題にならないことがあります。ただし、ブランチ切り替えや作成を使いたいなら、git が見えている必要があります。Terminal では使えるのに Mac アプリで見つからない場合は、実行ファイルパス で git の実行ファイルを指定します。

このポートでは別の Bridge がすでに動作しています​

同じポートで別の Bridge が動いています。古い launchd 残骸や別プロセスとの競合を疑ってください。一般 の警告と 詳細 の legacy launchd 情報を確認します。

Bridge プロセスは動作中ですが、ヘルスチェックに失敗しました​

Bridge は起動していても、正常に応答できていません。stderr にヒントが出ていないかを先に見ます。

認証に失敗しました​

これは iPhone 側に出ることが多いですが、原因確認には Mac の ペアリング を見ます。最近 トークンを再生成 していないかを確認してください。

困ったときに残しておくと役立つ情報​

自分で切り分けるときも、あとで報告するときも、次があると十分です。

  • Mac の 一般 に見えている ランタイム
  • ヘルス
  • ログ の該当行
  • 詳細 に出ている Codex CLI / git / シェル の状態
  • iPhone 側の表示メッセージ

長いログ全体より、症状が出た直前後の数行のほうが見返しやすくなります。