Codex: つながらない時は codex doctor --network-only で設定・接続・WebSocket だけ診断する
codex doctor に --network-only を付けると、ネットワークまわりだけを見る。設定、接続、WebSocket の3点に絞られるので、プロキシや社内ネットワークで止まる原因を早く切り分けられる。Codex CLI 0.166.0 で入った。
どんな時に使う？
- Codex が応答しない・途中で切れるが、認証のせいかネットワークのせいか分からない
- 社内プロキシ・VPN・リモート環境（app-server への接続など）で、自分の環境だけ動かない
- 問い合わせ用に、診断結果を貼れる形で集めたい
手順
- バージョンを確かめる:
codex --versionが 0.166.0 以上であること - 実行:
codex doctor --network-only - 出力で、設定・接続・WebSocket のどこで失敗したかを見る
- 接続から失敗しているなら、
openai_base_urlやプロキシの設定を先に見直す。WebSocket だけ失敗するなら、途中のプロキシや VPN が WebSocket を通しているかを疑う（ここは一般的な切り分けで、公式の手順ではない）
注意点
- 0.166.0 の変更点には「WebSocket の診断結果を残しつつ、細部は伏せ字にする」(#57597) も入っている。それでも、人に見せる前に URL やホスト名を自分で確認する
- 3項目の具体的な表示内容はバージョンで変わりうる。上の見方は目安
- 同じ 0.166.0 で
codex queue --resumeなども入った。詳しくは AIコーディング ツール・モデル動向（2026-10-29〜2026-10-30）
出典
- @oswrav 2026-10-30（Codex 小技 No.16）: @oswrav · 2026-10-30
- openai/codex rust-v0.166.0 リリースノート（#57606
codex doctor --network-only）: github.com