FIELD GUIDE / CODEX CLI 0.147.0
Prompt から証拠まで Codex を運用する。
8 つの実践モジュールで完全な command inventory を実際の terminal workflow に接続します。コマンドは共有 release manifest から取得し、安全境界を明示します。
完全リファレンスを開く→codex exec = headless
JSONL → schema → evidenceFIELD PROCEDURE / 01
Interactive session と root command
対象 repository に入り、model または profile を選び、作業前に状態を確認します。Codex の -p は profile で、print や non-interactive ではありません。
- $
cd your-repository - $
codex --profile deep-review - ›
/status - ›
/permissions
FIELD PROCEDURE / 02
Headless、JSONL、schema
Script と CI では codex exec を使います。--json は stdout に JSONL events、--output-schema は最終結果を制約し、--output-last-message は最終テキストを別保存します。
- $
codex exec "Run the affected tests" - $
codex exec --json --output-schema schema.json --output-last-message final.txt "Audit the change"
FIELD PROCEDURE / 03
Config layers、profiles、overrides
永続設定は config.toml、--profile は $CODEX_HOME/NAME.config.toml、-c key=value は 1 回限りの override に使います。requirements は override を制約します。
- $
codex --profile deep-review - $
codex -c model_reasoning_effort=high - $
codex --strict-config
FIELD PROCEDURE / 04
Approvals、sandbox、permissions
自律性を与える前に filesystem と approval の境界を選びます。workspace-write と on-request が実用的な開始点です。
- $
codex --sandbox workspace-write --ask-for-approval on-request - $
codex sandbox --permission-profile NAME -- command - ›
/permissions
FIELD PROCEDURE / 05
Resume、fork、archive、delete
Resume は継続、fork は分岐、archive は可逆、delete は永久です。Automation では正確な session ID を優先します。
- $
codex resume --last - $
codex fork --last - $
codex archive SESSION_ID - $
codex unarchive SESSION_ID - $
codex delete SESSION_ID
FIELD PROCEDURE / 06
MCP servers と authentication
stdio は -- の後、HTTP は --url で登録します。Bearer token value は環境変数に置き、OAuth 対応 server だけ mcp login を使います。
- $
codex mcp add docs --url https://developers.openai.com/mcp - $
codex mcp add local -- node server.mjs - $
codex mcp get docs --json - $
codex mcp login docs --scopes tools.read
FIELD PROCEDURE / 07
Plugins、skills、hooks
Marketplace は plugin catalog を提供し、plugin は tools、MCP servers、skills、hooks を追加できます。有効化前に出典と trust state を確認します。
- $
codex plugin marketplace list - $
codex plugin list --available --json - $
codex plugin add PLUGIN@MARKETPLACE - ›
/plugins - ›
/skills - ›
/hooks
FIELD PROCEDURE / 08
Review、diagnostics、evidence
最後に対象 tests、diff、focused review を行い、installation、auth、config、Git、runtime が不明なら doctor を使います。
- ›
/diff - ›
/review - $
codex review --uncommitted - $
codex doctor --summary - $
git status --short
SHARED MANIFEST / SUPPORTED WORKFLOWS
The guide resolves back to the inventory.
例はインストール済み Codex CLI 0.147.0 が対象です。Hidden execpolicy は inventory 専用で、サポート workflow には含めません。
codexruntime-confirmedcodex execruntime-confirmedcodex sandboxruntime-confirmedcodex resumeruntime-confirmedcodex archiveruntime-confirmedcodex deleteruntime-confirmedcodex forkruntime-confirmedcodex mcp getruntime-confirmedcodex mcp addruntime-confirmedcodex mcp loginruntime-confirmedcodex plugin listruntime-confirmedcodex plugin marketplaceruntime-confirmed
NEXT / SEARCH EVERY SURFACE