codex

Codex スキルガイド

タスクの実行

1. 新しいセッションでは（再開時は以前のモデル／推論の労力を引き継ぎます。手順 5 を参照）、使用するモデルと推論の労力を、2 つの質問を含む 1 つのプロンプトでユーザーに尋ねます（AskUserQuestion を使用）。ユーザーが希望を示さない場合は、gpt-6-astra の high をデフォルトとして使用します。
   • モデル — デフォルトは gpt-6-astra：
     • GPT-6： gpt-6-astra（最先端／最高性能 — デフォルト）
     • GPT-5.6： gpt-5.6-sol（信頼性の高いエージェント型の主力モデル）、gpt-5.6-terra（バランスの取れた日常向け）、gpt-5.6-luna（高速で低コスト）
     • レガシー（互換性のために維持）： gpt-5.5、gpt-5.4、gpt-5.4-mini、gpt-5.3-codex-spark、gpt-5.3-codex
   • 推論の労力 — デフォルトは high：low、medium、high、xhigh、max、ultra。
     • max／ultra は GPT-6 または GPT-5.6 モデルでのみ使用できます。ultra は astra／sol／terra でのみ使用でき（luna の上限は max）、レガシーモデルの上限は xhigh です。
     • ultra = 自動タスク委任を伴う最大限の推論（最も時間とコストがかかるため、最も難しい作業に限って使用してください）。
     • 選択した労力がモデルの上限を超える場合は、そのモデルでサポートされる最高の労力に切り替え、その旨をユーザーに伝えます。
2. タスクに必要なサンドボックスモードを選択します。編集やネットワークアクセスが必要な場合を除き、デフォルトは --sandbox read-only です。
3. 適切なオプションを使ってコマンドを組み立てます。
   • -m, --model <MODEL>
   • --config model_reasoning_effort="<low|medium|high|xhigh|max|ultra>"（max／ultra は GPT-6／GPT-5.6 モデルでのみ使用可能。ultra は astra／sol／terra でのみ使用可能 — 手順 1 を参照）
   • --sandbox <read-only|workspace-write|danger-full-access>
   • --full-auto
   • -C, --cd <DIR>
   • --skip-git-repo-check
   • "your prompt here"（最後の位置引数として指定）
4. 必ず --skip-git-repo-check を使用します。
5. 前のセッションを続行する場合は、codex exec --skip-git-repo-check resume --last を stdin 経由で使用します。セッションを再開するときは、ユーザーから明示的に指定された場合（たとえば、セッション再開を依頼する際にモデルまたは推論の労力を指定した場合）を除き、設定フラグを使用しないでください。再開時の構文：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. 重要（stdin）： codex exec は、位置引数のプロンプトをすべて指定している場合でも、常に stdin を読み取り、その内容を位置引数のプロンプトに連結します。stdin が閉じられていないと、codex は永久にブロックします。ハーネス（バックグラウンドタスク、フック、stdin が TTY ではないものの閉じられていないスクリプトなど）から呼び出す場合は、stdin を明示的にリダイレクトしてください。例：codex exec ... "prompt" </dev/null 2>/dev/null。この指定を誤った場合の症状：stdout が 0 バイト、CPU 使用時間が 0、プロセスが永久にハングしているように見えます。
8. コマンドを実行し、stdout／stderr を（適切にフィルタリングして）取得したうえで、結果をユーザーに要約します。
9. **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

実行タイムアウト

Codex は途中の出力を生成しません。完了時にのみ結果を書き込みます。完了前にプロセスが終了すると、出力ファイルはエラーなしで空になります。

推奨される方法： 同期実行してください。タイムアウトのリスクが完全になくなり、いずれにせよ会話は結果を待つためです。

バックグラウンドで実行する場合は、推論にかける労力に応じて実行タイムアウトを設定してください。

推論の労力	タイムアウト
low	150s
medium	300s
high	600s
xhigh	1200s
max	1800s
ultra	1800s

フォローアップ

• codex コマンドを実行するたびに、直ちに AskUserQuestion を使って次の手順を確認し、追加情報を収集するか、codex exec resume --last で再開するか判断してください。
• 再開するときは、新しいプロンプトを標準入力経由で渡してください：echo "new prompt" | codex exec resume --last 2>/dev/null。再開したセッションでは、元のセッションと同じモデル、推論の労力、サンドボックスモードが自動的に使われます。
• フォローアップの手順を提案するときは、選択したモデル、推論の労力、サンドボックスモードを改めて伝えてください。

Codex の出力を批判的に評価する

Codex は OpenAI のモデルを搭載しており、独自の知識カットオフや制約があります。Codex は権威ではなく同僚として扱ってください。

ガイドライン

• 自信がある場合は、自分の知識を信頼してください。 Codex の主張が誤っていると分かっている場合は、明確に異議を唱えてください。
• 意見が食い違う場合は、WebSearch またはドキュメントを使って調査してください。 必要に応じて、resume 経由で調査結果を Codex に伝えてください。
• 知識カットオフに留意してください。 Codex は、トレーニングデータの更新後にリリースされた新しいバージョン、API、変更点を知らない可能性があります。
• 鵜呑みにしないでください。 特に次の点について、Codex の提案を慎重に評価してください。
  • モデル名と機能
  • 最近のライブラリバージョンや API の変更
  • 進化している可能性のあるベストプラクティス

Codex が誤っている場合

1. ユーザーに明確に異議を伝えてください。
2. 根拠（自分の知識、ウェブ検索、ドキュメント）を示してください。
3. 必要に応じて Codex セッションを再開し、意見の相違について話し合ってください。Codex が同じ立場の AI として理解できるよう、自分が Claude であることを明示してください。固定の名前ではなく、実際に実行中のモデル名（例：現在実行中のモデル名）を使ってください。

   echo "This is Claude (<your current model name>) following up. I disagree with [X] because [evidence]. What's your take on this?" | codex exec --skip-git-repo-check resume --last 2>/dev/null
   

4. 意見の相違は訂正ではなく、話し合いとして提示してください。どちらの AI も間違っている可能性があります。
5. 本当に曖昧な点がある場合は、ユーザーに進め方を決めてもらってください。

エラー処理

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