Codexネットワーク制限の確認方法と接続エラーの診断手順

Codexのネットワーク制限を今確認したい理由

OpenAIの公式更新履歴では、2026年10月29日のCodex CLI 0.166.0に、codex doctor --network-onlyが追加されています。説明されている対象は、設定、接続性、WebSocketの診断です。通信に関する問題を調べたいとき、インストールや端末全般の情報から必要な項目を探す負担を減らせる変更といえます。

従来からあるcodex doctorは、インストール、設定、サインイン、実行環境、端末、会話一覧などを含む広い診断を行います。今回の追加は、その中でも「つながらない」という症状を扱う際の選択肢です。モデルに依頼文を送る段階で止まる場合と、依頼を受け取ったあとに外部の資料を取得できない場合では、問題が起きる経路が違います。通信診断を始める前に、どの段階で失敗したかを短く記録しておくと結果を読みやすくなります。

本記事は2026年11月2日時点で確認した公式情報に基づきます。更新履歴は新しいオプションを案内していますが、Developer commandsの公式リファレンスのDoctor欄では、確認時点で当該オプションの詳細が掲載されていませんでした。そのため、検査項目の全容や固定の結果文言を推測せず、利用中の版のヘルプと実際の表示を併せて確認する方法を採ります。

通信の許可・接続先・承認を分けて考える

ネットワークの問題を一括して扱うと、接続先を許可したつもりなのに通信が始まらない、承認設定を変えても失敗が続く、といった混乱が起こります。OpenAIのAgent approvals & securityは、サンドボックスが技術的にできる操作を制限し、承認方針が確認を求めるタイミングを定めると説明しています。通信の可否と確認の有無を、同じスイッチとして扱わないことが出発点です。

通信が無効なら接続先の許可だけでは足りない

公式資料では、標準的なworkspace-writeのサンドボックスは、設定で有効にしない限りネットワークアクセスを無効にすると説明されています。接続先のルールだけを追加しても、通信自体が無効な状態を有効にはできません。手元で選択している権限の種類や会社側の管理設定によって条件が変わるため、一般的な説明をそのまま自分の現在値だと決めつけず、適用中の設定を確認してください。

接続先のルールには有効化の条件がある

同じ公式資料は、利用者側のネットワークプロキシ機能を使って接続先を制限する場合、その機能を有効にする必要があると案内しています。通信を許可したうえで接続先のルールを書くだけでは、そのルールによる制限が働かない構成もあります。一方、管理者が定める要件は別に扱われます。「ルールが書いてある」という事実だけで制限の有効性を判断せず、どの仕組みがそのルールを適用しているかまで確かめましょう。

通信専用のDoctorを使う確認手順

ここで紹介するコマンドは、利用者が手元の端末で確認するための例です。記事内の説明にある表示と異なる場合は、手元のヘルプを優先してください。特に複数のCodexを入れている端末では、更新したものとは別の版を開いている可能性があります。診断結果を比べる際は、版、作業場所、接続しているコンピューターをそろえることが重要です。失敗した操作の内容を控えておけば、診断後に同じ条件で比較でき、偶然の復旧と設定変更の効果を取り違えにくくなります。

Step 1: 版とヘルプを確認する

PowerShellなどの端末でcodex --versionを入力し、続けてcodex doctor --helpでDoctorが受け付けるオプションを確認します。--network-onlyは0.166.0の更新履歴に追加として記載されているため、それより前の版では使えると仮定しないでください。更新後も未知の引数というエラーになる場合は、実際に呼び出されているCodexの場所と版を確認します。最初から権限を変える必要はありません。

Step 2: 元の作業と同じ場所で通信診断を行う

失敗した作業のフォルダーへ移動し、codex doctor --network-onlyを入力します。これは端末に入力するコマンドであり、Codexとの対話欄へ自然文の依頼として送るものではありません。別のコンピューターへ接続して作業しているなら、どちらの環境を調べているかも確認してください。手元の端末で成功した結果を、接続先のコンピューターの通信状態として読み替えないことが大切です。

Step 3: 結果と元の症状を対応させる

表示された診断結果から、失敗した項目、関連する設定、対象の接続先など、確認できる情報を記録します。すべての項目が必ず同じ形式で出るとは限りません。診断が完了したあと、元の依頼を必要最小限の範囲で試し直して、同じ場所で止まるかを確認します。診断に成功しても特定サイトだけ失敗するなら、全体の接続性と個別の接続先の問題を分けて調べる材料になります。

Step 4: 通信以外の疑いがあれば診断を広げる

起動そのものが不安定、設定の読み込みに失敗する、サインイン状態が分からないといった場合は、通信専用の結果だけで判断せず、通常のcodex doctorも確認します。公式リファレンスには、概要を表示する--summaryや、色を使わない--no-colorなども掲載されています。ただし、それらと通信専用オプションを組み合わせた動作までは本記事で保証しません。必要な組み合わせは手元のヘルプで確認してください。

診断結果から次の確認先を選ぶ

通信エラーの原因を、表示された単語一つから断定するのは避けたいところです。たとえば接続が切れたという症状でも、端末の回線、会社の通信経路、接続先側の応答、Codexの設定など、複数の確認先があります。以下は公式に定められたエラー分類ではなく、診断後に確認を進めるための整理方法です。自分の表示と照らし合わせて、該当する条件から調べます。再試行で成功した場合も、接続先や利用した機能が変わっていないかを確認すると、同じ問題が再発した際の比較に役立ちます。

Codexへ依頼する前から接続できない場合

モデルから返答が来る前に接続が途切れるなら、まずCodex自体がサービスへ接続する経路を確認します。端末がオンラインか、会社指定の通信経路を利用しているか、診断に失敗した項目があるかを見ます。ここで外部資料の取得許可だけを変更しても、同じ原因に効くとは限りません。接続が始まらない症状と、作業中の一つのコマンドが失敗する症状を分けて記録すると、相談時にも話が伝わります。

返答は来るが外部資料の取得だけ失敗する場合

Codexとの会話が成立していても、作業中のコマンドから外部へ通信できるとは限りません。公式の権限資料では、コマンドのネットワーク制御と、検索や外部ツールの制御は同一ではないと説明されています。そのため、検索で情報が見つかったことを、コマンドから同じ場所へ接続できる証拠にしないでください。どの機能を使い、どの接続先へのアクセスで失敗したかを確認します。

特定の接続先だけ失敗する場合

一部のホストだけ到達できないときは、接続先のルールと実際のホスト名を照合します。公式資料では、完全なホスト名の一致とサブドメインの指定は意味が異なり、拒否ルールが許可ルールより優先されると説明されています。また、公開ホストと端末内や社内向けの接続先では扱いが異なります。一つの接続成功だけで全体を正常と判断せず、必要な接続先ごとに条件を確認してください。

設定を変更する前後に残す情報

診断後に設定を見直す場合は、変更前の状態を記録し、一度に変える対象を絞ります。通信の許可、接続先のルール、承認方針をまとめて変えると、どの変更が結果に影響したか分からなくなります。特に会社の管理下では、利用者の設定より管理側の要件が優先される場合があるため、個人の設定ファイルだけを何度も書き換えても解決しないことがあります。

1. 失敗した時刻、Codexの版、作業した端末、失敗した操作を記録します。対象の接続先は、分かる範囲のホスト名で整理します。
2. 通信診断の結果を確認し、関係する項目だけを抜き出します。利用者名、社内のファイルの場所、接続情報など、共有先に不要な情報は取り除きます。
3. 変更が必要なら、管理方針に沿って一つの条件を変更します。変更した項目と理由を残し、診断と元の小さな操作を同じ条件で確認します。
4. 改善しない場合は、元の状態へ戻せることを確認したうえで、診断結果と比較内容を管理担当者やサポートへ伝えます。必要な接続先と実際にできなかったことを具体的に示します。

公式リファレンスでは、codex doctor --jsonは情報を伏せた機械可読のサポート用レポートを出すと説明されています。ただし、情報が伏せられる機能を利用した場合でも、共有前の内容確認は役立ちます。誰へ何を伝える必要があるかを決め、診断と無関係な会話や業務情報まで添付しないようにしましょう。

制限を緩める前に失敗した経路を確かめる

Codexのネットワーク制限を調べる際は、通信が許可されているか、必要な接続先に到達できるか、操作の承認で止まっているかを別々に確認します。CLI 0.166.0で加わったcodex doctor --network-onlyは、そのうち通信に関する設定や接続性を調べる新しい入口です。診断は原因を絞る材料であり、通信を有効にする設定変更そのものではありません。

まず版とヘルプを確認し、失敗した作業と同じ場所で診断し、結果を元の症状と対応させます。個別の接続先の問題や管理側の制限が分かれば、必要な範囲だけを相談できます。今後の版で表示や検査内容が変わる可能性もあるため、公式更新履歴とDoctorのリファレンスを確認し、手元の表示を基準に進めてください。