Codex
プロファイル
- (プロファイルなし) — 読み取り専用分析（コンパイルなし、テストなし）
--profile edit— ローカル編集、ビルド、テスト（workspace-write、完全自動）--profile full— ネットワークまたは広範なファイルシステムアクセス（danger-full-access、完全自動）
タスクに go test、go build、またはビルド成果物を書き込むコマンドが含まれる場合は、常に --profile edit を使用してください。デフォルトの読み取り専用サンドボックスは、コンパイラの一時ディレクトリを含むすべての書き込みをブロックします。
複雑なタスクの場合は、--config model_reasoning_effort="xhigh" を追加してください。
モデル選択
デフォルトは .codex/config.toml のプロジェクトモデル（gpt-5.4）です。
高速なインタラクティブ作業には --model gpt-5.3-codex-spark を使用します:
- 緊密なやり取りの反復
- 素早いバグ修正と対象を絞った編集
- 小〜中規模のリファクタリングやUI調整
- 頻繁な方向転換や割り込みが予想される迅速なプロトタイピング
深い作業にはデフォルトの gpt-5.4 を使用します:
- 長時間の自律実行
- 高度な推論を必要とする広範な複数ファイル変更
- テストや検証が重要なタスク
- 深い推論が追加のレイテンシに見合う、正確性やリスク面が高い作業
ユーザーが明示的にモデルを要求した場合は、その要求に従います。
コマンド
プロジェクトのデフォルトは .codex/config.toml にあります。常に --skip-git-repo-check と 2>/dev/null を含めてください。モデルの上書きは、ユーザーが明示的に要求した場合、またはタスクが上記のSpark高速優先基準に明確に該当する場合のみ行います。
| ユースケース | コマンド |
|---|---|
| 読み取り専用分析 | codex exec --skip-git-repo-check -o "$CODEX_OUT" "プロンプト" 2>/dev/null |
| 高速インタラクティブループ（Spark） | --model gpt-5.3-codex-spark を追加 |
| ローカル編集の適用 | --profile edit を追加 |
| ネットワーク/広範なアクセス | --profile full を追加 |
| セッションの再開 | `echo "プロンプト" |
実行前に出力用の一時ファイルを作成します: CODEX_OUT=$(mktemp /tmp/codex-out.XXXXXX)。完了後、$CODEX_OUT から結果を読み取ります。
Bashで run_in_background: true を使用して実行します。TaskOutput で block: true, timeout: 600000 を指定して監視します — ポーリングに sleep コマンドは使用しないでください。最終回答は -o ファイルから読み取ります。
再開
再開時にはモデル/努力度/サンドボックスのフラグを渡さないでください — 元のセッション設定が引き継がれます。-o は含めても問題ありません。
規約
これはGoプロジェクトです。プロンプトでは go test、go build、go vet を使用してください。Codexワーカーは CLAUDE.md やフックを受け取らないため、プロジェクトの規約は明示的に記述する必要があります。
実行後の検証
Codexの出力は常に git diff --stat で検証してください — ワーカーの自己報告によるファイルリストを決して信用しないでください。Codexワーカーは範囲外の変更（ファイルの削除、無関係なコードの復元、テスト関数の削除）を行う可能性があります。完了の約束は、意図したファイルのみをリストし、破壊的な副作用を省略することがあります。
同じコードベースに他の作業が存在する場合は、プロンプトに "変更または削除しないでください" という明示的なファイルリストを含めてください。肯定命令（"これらのファイルにのみ触れる"）だけでは不十分です — Codexは "クリーンアップ" を広く解釈します。
[[principles/prove-it-works]] に従い、自己報告ではなく成果物を信頼してください。
ワーキングツリーの使用
-C <worktree-dir> を使用すると、ワーキングツリーは独自のgitインデックスを持ちます。.claude/ は .agents/ にシンボリックリンクされている場合があります — git操作には .agents/ パスを使用してください。