フィールドガイド / 10 分
Codex を診断し features と completions を確認する
Config や shell startup を変える前に observable inventory を読みます。
doctor は installation/runtime layers、features は stage/effective state、completion は shell integration、debug utilities は bundled model catalog など特定 evidence を提供します。Read-only inspection から始め、version context を保ち、ticket/startup file へ置く前に output を review します。
CLI
検証済みターミナル手順
- $
codex doctor --summary - $
codex features list - $
codex completion zsh > /tmp/_codex - $
codex debug models --bundled
A
作業原則
Release を先に記録
Feature stage/output/shell support は変わるため diagnostic と version を組にします。
Inspect before mutate
Feature state を list してから変更、completion output を見てから source。
Diagnostics を慎重に共有
Paths/repo names/config clues を review/redact。
B
フィールド手順
- 01
Identity
Active executable/version を解決。
- 02
Layered diagnostics
doctor summary から最初の failing layer を処理。
- 03
Feature state
features list で stage/effective value を記録。
- 04
Shell completion
対応 shell を選び temp file を inspect 後に統合。
- 05
Narrow debug
必要 evidence の subcommand だけ実行し broad dump を公開しない。
PASS / FAIL
受入チェック
- Version/executable 記録。
- First failing layer 優先。
- Exact feature だけ変更。
- Active shell 用 completion。
- Shared report redacted。
WATCH / REJECT
失敗パターン
- Doctor 前に複数 config 編集。
- Experimental feature を推測で enable。
- Generated shell code を未確認 append。