OpenAI codex doctor が出した『サポート可観測性』のテンプレート — Codex 0.131.0、Runtime / Auth / WebSocket / SQLite を一発診断し、JSON で支援者に投げられる構造へ

概要

2026年5月19日にリリースされた Codex CLI 0.131.0 が同梱した codex doctor は、Codex の Runtime / Configuration / Updates / Connectivity / Background Server を 5 セクションで一気に診断する新コマンドだ（PR #22336、fcoury-oai）。

これは単発の診断機能ではなく、「ユーザーがサポートに投げる時の情報単位」を CLI 側で標準化する 設計だ。

codex doctor の中身

5 セクション + Notes

Notes ブロックが先頭

通常の診断ツールは check を順に並べるが、codex doctor は 異常がある項目だけを Notes として先頭に promote する。これは Sentry / Datadog の "Issues" タブに近い設計で、サポート担当者が冒頭だけ見れば優先度の高い問題が見える。

Codex Doctor v0.0.0 · macos-aarch64

Notes
   ↑ updates      0.130.0 available (current 0.0.0, dismissed 0.128.0)
   ⚠ rollouts     1,526 active files · 2.53 GB on disk
   ⚠ mcp          MCP configuration has optional issues
   ⚠ auth         mixed auth signals: ChatGPT login plus API key env var
─────────────────────────────────────────────────────────────

Provider-aware なネットワーク診断

OpenAI 公式 API キー / ChatGPT 認証 / Bedrock / AWS / カスタム HTTP エンドポイントで検証ターゲットを切り替える。

ChatGPT 認証時の WebSocket ハンドシェイクは独立した check として timeout / DNS / auth / provider の文脈 を含めて報告される。

JSON 出力で支援者に投げる前提

codex doctor --json は redacted な JSON を出力する。checks は check ID で keyed、details は key/value object。Sentry / 内部 issue tracker / Slack に貼り付ける単位 として最適化されている。

codex doctor --json > codex-doctor-report.json
# このファイルが feedback upload で自動添付される

feedback upload 時に best-effort で codex-doctor-report.json が attach され、overall status / failing / warning から Sentry tag が派生 する。CLI バグレポートのテンプレートも codex doctor --json 結果の貼り付けを要求するように更新された。

対象としている "失敗モード"

PR 本文が想定する failure modes が明示されている。

特に ChatGPT 認証時の WebSocket と SQLite integrity は、CLI のサポート担当者が「ユーザー環境で何が起きているか」を遠隔で把握するのに最も時間がかかっていた領域だ。

Claude Code の /doctor との対比

Claude Code には 2.1 系列で /doctor がある。観点ごとに比較する。

Claude Code の /doctor は「ユーザーが自力で直す triage」、codex doctor は「サポートに投げる snapshot」。両者は補完関係だが、設計思想の差が CLI ベンダーのカスタマーサクセス戦略に直結する。

"サポート可観測性" の設計テンプレート

codex doctor は単なる便利機能ではなく、AI CLI のサポートに必要な情報単位を製品化 した。これは観測性（observability）の CLI 版だ。

これは Datadog / Honeycomb / Grafana が SaaS 観測性で 10 年かけて固めたパターンを、CLI に圧縮した形だ。

日本への示唆

エンタープライズ調達での "サポート品質" 観点

国内エンタープライズが AI CLI を全社展開する際、サポートのエスカレーション設計が調達評価項目に入る。

NTT データ・富士通・NRI 等の国内 SIer が AI CLI を顧客に展開する場合、codex doctor のような診断コマンドの有無は、提案書の差別化要因 になる。

Anthropic / OpenAI の "ロックイン要素" 比較

過去記事で扱った Anthropic 3日連続投下（CLUE / Computer Use BP / Founder's Playbook） は「戦略・実装・運用の物語」を整える方向。OpenAI Codex は CLI レベルで運用品質を上げる 方向。両者の差が日本のエンタープライズ調達担当者にどう映るかで、勝敗が決まる。

国内 SIer の CLI ツール提供への波及

Python SDK との接続

Codex 0.131.0 は同時に Python SDK を openai-codex パッケージに刷新 した。Python SDK + codex doctor --json の組み合わせで、自前の運用ダッシュボードに codex の health を統合する 経路が現実的になる。

import subprocess
import json

result = subprocess.run(
    ["codex", "doctor", "--json"],
    capture_output=True, text=True,
)
report = json.loads(result.stdout)

for check_id, check in report["checks"].items():
    if check["status"] in ("warn", "fail"):
        send_to_observability(check_id, check["details"])

社内に N 台の開発端末で codex を運用している企業 は、夜間 cron で codex doctor --json を回して集約するだけで、フリート全体の健全性ダッシュボード が組める構造になった。

まとめ

• 2026年5月19日リリースの Codex CLI 0.131.0 が codex doctor を同梱。Runtime / Auth / Terminal / Network / SQLite を 5 セクションで一気に診断、Notes ブロックで異常を冒頭に promote、--summary/--json で出力モード切替
• 出力は redacted JSON で支援者に投げる単位 に最適化。feedback upload に自動添付、Sentry tag を派生付与、CLI バグテンプレートも --json 添付を要求
• Claude Code /doctor は「triage」、codex doctor は「support snapshot」。両者の設計思想の差は、ベンダーのカスタマーサクセス戦略の差
• SaaS 観測性（Datadog/Honeycomb）で固めた "Inventory / Config / Connectivity / State / Events / Sharing" のパターンを CLI に圧縮した。AI CLI の運用品質テンプレートとして他ベンダーが追従する圧力がかかる
• 日本のエンタープライズ調達で「診断コマンドの有無」が評価項目に。NRI/TIS/SCSK/NTT データなど SIer は、診断 JSON を起点にした runbook 整備や自社オブザーバビリティ統合の SaaS 化が現実的な打ち手

参考リンク

• Codex CLI 0.131.0 Release Notes — GitHub
• feat(cli): add codex doctor diagnostics — PR #22336
• Command line options — Codex CLI Reference (OpenAI Developers)
• Claude Code /doctor: Fix Setup Issues in 30 Seconds — Vincent's Blog