codex doctorの使い方|–network-onlyで通信を診断

codex doctorの使い方|--network-onlyで通信を診断
📅 公開日: 2026年11月8日

codex doctor は、Codex CLI の導入が壊れていないかを調べ、ローカルで診断レポートを作るコマンドです。

公式のコマンド一覧にある説明で、2026年11月7日に確認しました。(公式のコマンド一覧)

2026年10月29日の Codex CLI 0.166.0 では、通信まわりだけを調べる --network-only が加わりました。(公式の更新情報)

この記事では、調べる対象、フラグの違い、使う順番、レポートを共有するときの注意を整理します。

目次

codex doctorは何を調べるコマンドか

LINEでインスタ大学の受取案内を見る

LINEでインスタ大学の受取案内を見る

インスタ大学の受取案内をLINEで確認できます。

LINEでインスタ大学の受取案内を見る

codex doctor は、Codex の導入や設定が正常かを確かめるための診断レポートを、手元のPCで作るコマンドです。(公式のコマンド一覧)

公式の説明では、サポートへ問い合わせる前や、Codex の導入が壊れていないかを調べるときに使うとされています。調べる対象は次の8つです。

対象 公式の表記
インストール installation
設定 configuration
認証 authentication
実行環境 runtime
Git Git
ターミナル terminal
app-server app-server
スレッド一覧の状態 thread inventory health

–network-onlyは何を絞り込むのか

–network-only は、codex doctor の確認対象を、設定と通信まわりの4つに絞るオプションです。

公式の説明にある4つの対象は次のとおりです。

  • 設定(configuration)
  • ネットワーク環境
  • プロバイダーへのHTTP接続
  • Responses WebSocket の接続

更新情報には、0.166.0 の新機能として、設定、接続、WebSocket を絞って診断する codex doctor --network-only が載っています。(更新情報)

GitHub のリリースノートにも、同じ追加が記載されています。(rust-v0.166.0 のリリースノート)

codex doctorの使い方|基本の手順

codex doctor は、まず何も付けずに実行し、必要に応じてフラグを足す使い方が基本です。

  1. ターミナルで codex doctor を実行し、全体の診断レポートを出します。
  2. 結果が長いときは codex doctor --summary で、グループごとの行と最後の件数だけを見ます。
  3. 省略された長い一覧も見たいときは codex doctor --all で展開します。
  4. 通信や接続が疑わしいときは codex doctor --network-only に絞ります。
  5. 他の人やツールに渡す記録が要るときは codex doctor --json で機械可読のレポートを出します。

フラグを2つ以上組み合わせた例は、公式のコマンド一覧の codex doctor の項にありません。まず1つずつ試すのが安全です。

codex doctorのフラグ一覧

codex doctor のフラグは、公式の一覧では次の6つです。(公式のコマンド一覧)

フラグ 公式の説明の要点
--all 詳細な人間向けレポートの長い一覧を展開する
--ascii 人間向けの出力で、ASCIIの状態ラベルと区切りを使う
--json 秘匿加工された機械可読のサポート用レポートを出す
--network-only 設定、ネットワーク環境、プロバイダーのHTTP接続、Responses WebSocket の接続に絞る
--no-color 人間向けの出力でANSIの色を使わない
--summary グループごとの確認行と、最後の件数の要約だけを出す

状況別にどのフラグを選ぶか

状況に合わせて選ぶなら、見たい範囲と出力の形で決めるのが分かりやすい方法です。

次の表は、上の6つの公式の説明を状況に当てはめた、この記事の整理です。

状況 選ぶ指定 選ぶ理由
まず全体の状態を知りたい フラグなし 8つの対象をまとめて確認できる
結果が長くて見づらい --summary グループごとの行と件数だけに絞れる
長い一覧の中身も見たい --all 省略された一覧を展開できる
通信や接続だけを切り分けたい --network-only 設定と通信の4つの対象に絞れる
記録を他の人やツールに渡したい --json 秘匿加工された機械可読の形式で出せる
色や記号が崩れて読めない --no-color や --ascii 色や状態ラベルの出し方を変えられる

仮の例|社内ネットワークでCodexにつながらないとき

通信の不調を切り分けるなら、まず –network-only で設定と接続のどちらに問題があるかを見ます。

次は仮の例です。社内ネットワークで Codex の接続が不安定になった場面を考えます。

  1. codex doctor --network-only を実行し、設定、ネットワーク環境、HTTP接続、WebSocket の接続のうち、どの対象で問題が示されるかを見ます。
  2. 設定の対象に問題が示されたら、config.toml の内容を見直します。
  3. 接続の対象に問題が示されたら、HTTPとWebSocketのどちらかを控えて、ネットワーク管理者に伝えます。
  4. 対処のあとにもう一度同じコマンドを実行し、同じ対象が解消したかを確かめます。

手順の2は、設定の見直しとして次の記事も参考になります。

Codex CLIの設定ファイルconfig.tomlの書き方を確認できます。

プロキシ経由の環境では、0.167.0 の更新情報に、macOS または Windows のシステムのプロキシ設定を /experimental から有効にできると書かれています。(更新情報)

診断レポートを共有するときの注意

診断レポートを共有する前は、--json の秘匿加工に頼り切らず、中身を自分でも読むのが安全です。

公式の項では、--json の出力は秘匿加工済みの報告書とされています。ただし、加工の範囲の詳細は同じ項に書かれていません。

  • 共有先に渡す前に、レポートの中身を自分で読む(この記事の提案)。
  • 社外へ送る場合は、会社の情報共有のルールを確認する(この記事の提案)。
  • サポートへの問い合わせ用には、まず --json の形式で出す(この記事の提案)。

公式の一覧に書かれていないこと

codex doctor の項には、終了コード、出力のサンプル、ログインの要否は書かれていません。

そのため、出力画面の見え方はこの記事では載せていません。実際の表示は、お使いの環境で実行して確かめてください。

関連記事

よくある質問(FAQ)

Q1. codex doctor は何のためのコマンドですか。
Codex の導入や設定が壊れていないかを調べ、ローカルで診断レポートを作るためのコマンドです。
Q2. –network-only で確認できる範囲はどこまでですか。
設定、ネットワーク環境、プロバイダーへのHTTP接続、Responses WebSocket の接続です。インストールやGitなどの他の対象は、このフラグでは確認の範囲外です。
Q3. –network-only はいつ追加されましたか。
更新情報では、2026年10月29日付の Codex CLI 0.166.0 の新機能として載っています。
Q4. –json のレポートはそのまま共有してよいですか。
公式は秘匿加工されたレポートと説明しています。ただし加工の範囲の詳細は書かれていないため、共有前に自分でも中身を読むのが安全です。
Q5. 出力のサンプルはありますか。
公式の codex doctor の項には、サンプル出力は載っていません。お使いの環境で実行して確かめてください。

まとめ

codex doctor は、Codex の導入状態を診断するコマンドです。

通信だけを切り分けたいときは –network-only、長い結果は –summary や –all、共有用は –json と使い分けます。

インスタ大学教材の受取案内は、次のLINEから確認できます。

このサイトは株式会社S.Lineが運営しています。記事内の店舗予約・LINE登録・講座の案内には、当社または当社が集客を担当するサービスの広告(PR)が含まれます。
本記事は公式情報・専門メディアを参考に執筆しています。最新の正確な情報は引用元の公式ページをご確認ください。
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

株式会社S.Line 代表取締役。偏差値39から起業し、AIとSNSの活用で「普通の人」が成果を出す方法を発信。

目次