codex

Codex スキルガイド

タスクの実行

1. デフォルトで gpt-5.2 モデルを使用します。AskUserQuestion を使って、どの推論effort を使うかユーザーに確認してください（xhigh、high、medium、low）。必要に応じてユーザーはモデルを変更できます（下記の Model Options を参照）。
2. タスクに必要なサンドボックスモードを選択します。編集またはネットワークアクセスが必要な場合を除き、デフォルトは --sandbox read-only です。
3. 適切なオプションを指定してコマンドを組み立てます：
   • -m, --model <MODEL>
   • --config model_reasoning_effort="<high|medium|low>"
   • --sandbox <read-only|workspace-write|danger-full-access>
   • --full-auto
   • -C, --cd <DIR>
   • --skip-git-repo-check
4. 常に --skip-git-repo-check を使用してください。
5. 前のセッションを継続する場合は、stdin 経由で codex exec --skip-git-repo-check resume --last を使用します。再開時には、ユーザーが明示的に要求しない限り、設定フラグを一切使用しないでください。たとえば、セッションを再開する際にモデルや推論effort を指定した場合は例外です。再開の構文：echo "your prompt here" | codex exec --skip-git-repo-check resume --last 2>/dev/null。すべてのフラグは exec と resume の間に挿入する必要があります。
6. 重要: デフォルトでは、思考トークン（stderr）を抑制するために、すべての codex exec コマンドに 2>/dev/null を付加してください。ユーザーが思考トークンの表示を明示的に要求した場合、またはデバッグが必要な場合にのみ stderr を表示してください。
7. コマンドを実行し、stdout/stderr を（必要に応じてフィルタリングして）取得し、結果をユーザーに要約します。
8. Codex の完了後、ユーザーに次のように伝えます：「'codex resume' と言う、または追加の分析や変更の継続を依頼することで、いつでもこの Codex セッションを再開できます。」

クイックリファレンス

ユースケース	サンドボックスモード	主なフラグ
読み取り専用のレビューまたは分析	read-only	--sandbox read-only 2>/dev/null
ローカル編集の適用	workspace-write	--sandbox workspace-write --full-auto 2>/dev/null
ネットワークまたは広範なアクセスを許可	danger-full-access	--sandbox danger-full-access --full-auto 2>/dev/null
最近のセッションを再開	元のセッションから継承	echo "prompt" | codex exec --skip-git-repo-check resume --last 2>/dev/null（フラグは使用不可）
別のディレクトリから実行	タスクの必要性に合わせる	-C <DIR> と他のフラグ 2>/dev/null

モデルオプション

モデル	最適な用途	コンテキストウィンドウ	主な特徴
gpt-5.2-max	Max モデル：超複雑な推論、深い問題分析	入力 400K / 出力 128K	SWE-bench 76.3%、適応的推論、$1.25/$10.00
gpt-5.2 ⭐	フラッグシップモデル：ソフトウェアエンジニアリング、エージェント型コーディングワークフロー	入力 400K / 出力 128K	SWE-bench 76.3%、適応的推論、$1.25/$10.00
gpt-5.2-mini	コスト効率の高いコーディング（利用枠は4倍）	入力 400K / 出力 128K	SOTA に近い性能、$0.25/$2.00
gpt-5.1-thinking	超複雑な推論、深い問題分析	入力 400K / 出力 128K	適応的な思考の深さ、最も難しいタスクでは2倍遅く動作

GPT-5.2 の利点：SWE-bench 76.3%（GPT-5 は 72.8%）、平均的なタスクで30%高速、ツール処理の改善、ハルシネーションの削減、コード品質の向上。知識カットオフ：2024年9月30日。

推論 Effort レベル：

• xhigh - 超複雑なタスク（深い問題分析、複雑な推論、問題の深い理解）
• high - 複雑なタスク（リファクタリング、アーキテクチャ、セキュリティ分析、パフォーマンス最適化）
• medium - 標準的なタスク（リファクタリング、コードの整理、機能追加、バグ修正）
• low - 単純なタスク（簡単な修正、単純な変更、コードフォーマット、ドキュメント作成）

キャッシュ入力の割引：繰り返し使われるコンテキストについて 90% オフ（$0.125/M トークン）、キャッシュは最長 24 時間有効です。

フォローアップ

• codex コマンドを実行するたびに、すぐに AskUserQuestion を使って次のステップを確認したり、追加の確認事項を収集したり、codex exec resume --last で再開するかどうかを決めたりしてください。
• 再開する場合は、新しいプロンプトを stdin 経由で渡してください: echo "new prompt" | codex exec resume --last 2>/dev/null。再開されたセッションは、元のセッションと同じモデル、推論の労力、サンドボックスモードを自動的に使用します。
• フォローアップのアクションを提案する際は、選択したモデル、推論の労力、サンドボックスモードを改めて明示してください。

エラーハンドリング

• codex --version または codex exec コマンドが非ゼロで終了した場合は、直ちに停止して失敗を報告し、再試行する前に指示を求めてください。
• 影響の大きいフラグ（--full-auto、--sandbox danger-full-access、--skip-git-repo-check）を使用する前には、既に許可を得ていない限り、AskUserQuestion を使ってユーザーに許可を求めてください。
• 出力に警告や部分的な結果が含まれる場合は、それらを要約し、AskUserQuestion を使って調整方法を尋ねてください。

CLI のバージョン

GPT-5.2 モデルをサポートするには、Codex CLI v0.57.0 以降が必要です。CLI のデフォルトモデルは macOS/Linux では gpt-5.2、Windows でも gpt-5.2 です。バージョンの確認: codex --version

Codex セッション内で /model スラッシュコマンドを使ってモデルを切り替えるか、~/.codex/config.toml でデフォルトを設定できます。