codex doctor は、Codex CLI の導入が壊れていないかを調べ、ローカルで診断レポートを作るコマンドです。
公式のコマンド一覧にある説明で、2026年11月7日に確認しました。(公式のコマンド一覧)
2026年10月29日の Codex CLI 0.166.0 では、通信まわりだけを調べる --network-only が加わりました。(公式の更新情報)
この記事では、調べる対象、フラグの違い、使う順番、レポートを共有するときの注意を整理します。
codex doctorは何を調べるコマンドか
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 は、まず何も付けずに実行し、必要に応じてフラグを足す使い方が基本です。
- ターミナルで
codex doctorを実行し、全体の診断レポートを出します。 - 結果が長いときは
codex doctor --summaryで、グループごとの行と最後の件数だけを見ます。 - 省略された長い一覧も見たいときは
codex doctor --allで展開します。 - 通信や接続が疑わしいときは
codex doctor --network-onlyに絞ります。 - 他の人やツールに渡す記録が要るときは
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 の接続が不安定になった場面を考えます。
codex doctor --network-onlyを実行し、設定、ネットワーク環境、HTTP接続、WebSocket の接続のうち、どの対象で問題が示されるかを見ます。- 設定の対象に問題が示されたら、config.toml の内容を見直します。
- 接続の対象に問題が示されたら、HTTPとWebSocketのどちらかを控えて、ネットワーク管理者に伝えます。
- 対処のあとにもう一度同じコマンドを実行し、同じ対象が解消したかを確かめます。
手順の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から確認できます。
あわせて読みたい・姉妹メディア

