Skip to Content
Docs08. コーディングエージェントOpenAI Codex 実践ガイド
中級coding-agentscost-managementprompt-caching更新: 2026-10-08この記事の誤りを報告

この記事の音声は準備中です。

音声の一覧・再生リストへ

OpenAI Codex 実践ガイド

この記事の目的

OpenAI Codex の機能(ローカル / クラウドの各面・スキル・サブエージェント・自動化)を使いどころから理解し、消費(利用制限・クレジット)を抑えながら業務を効率化できるようになります。製品の選定判断は OpenAI Codex が正で、本記事は「導入済みの人が使いこなす」段階を扱います。

対象読者

  • Codex を使い始めたが、対話以外の機能(クラウド委任・exec・スキル)を活用できていないエンジニア
  • 利用制限・クレジット消費を管理しながらチームで運用したい人

前提知識

本文

最終確認日: AGENTS.md の開始 cwd と読込範囲、サブエージェントの委任条件、モデル退役、Fast の速度・課金区分、定期タスクの実行場所・認証別課金、CODEX_API_KEY の対応範囲は 2026-09-10、その他は 2026-08-18 の公式ドキュメントに基づきます。制限値・レートは特に変わりやすいため、必ず公式ページ(参考資料)で最新値を確認してください。

モデル別のキャッシュ入力レート、Fast の利用枠・課金区分と認証別退役は 2026-10-08 に部分再確認しました。AGENTS.md・定期タスク・その他の製品仕様まで再検証したという意味ではありません。

面の使い分けとハンドオフ

公式ドキュメント自身が面(surface)ごとの使い分けを明示しています。

面公式が推す用途
IDE 拡張ローカル探索。開いているファイルが自動でコンテキストに入り、選択範囲でスコープを絞れる
CLI再現手順を回す「タイトなループ」。@ パス補完でファイルを添付
クラウド長時間の実装・並列実行・デバイス横断の委任
デスクトップアプリスレッド開始時に Local / Worktree(隔離された git worktree)/ Cloud を選択。並列作業の管制

実践上の要点は**ハンドオフ(引き継ぎ)**です。ローカルで計画を詰めてからクラウドアイコンで委任すると、既存スレッドの文脈を引き継いだクラウドスレッドが作られます。「リファクタ計画はローカルで対話的に作り、実行はクラウドに委任する」が公式推奨の分担です。逆方向は、クラウドの結果 diff をローカルに適用して仕上げます。

カスタマイズ機構の使い分け

Codex は拡張機構が多いため、公式の使い分け指針(Customization ページ)を軸に整理します。

機構使うとき(公式指針)
AGENTS.mdそのリポジトリで毎回従わせたいルール(ビルドコマンド・規約・禁止事項)
スキル(.agents/skills/)反復するワークフロー(リリース手順・レビュー定型・移行手順)。「同じプロンプトを使い回し始めたらスキル化」が公式の判断基準
MCPツールやデータソースを LLM アプリケーションに接続するための標準プロトコル。概要は ツール使用、接続の実務は ツール接続標準(MCP とエコシステム)リポジトリの外にある能力(Issue トラッカー・デザインツール・共有ドキュメント)
サブエージェント(.codex/agents/*.toml)ノイズの多い・専門化したタスクの委任。直接の依頼、適用される AGENTS.md・スキルの委任指示に従って起動
定期タスク(Scheduled)定期チェック。スキルで定めた作業手順をスケジュールに従って実行

ローカルのアプリ・CLI・IDE では、直接のユーザー指示に加え、適用される AGENTS.md やスキルの委任指示も起動根拠になります。ChatGPT Work では通常は明示的に委任を依頼し、利用資格のある Ultra では速度・品質に寄与する独立作業を能動的に委任できます。提供面と設定を記録し、「指示していないから絶対に起動しない」という前提で消費上限を決めないようにします。

コスト削減: 制限の構造とレバー

構造の理解が先です(2026-08 時点): ローカルのメッセージとクラウドタスクは同一の 5 時間ウィンドウを共有し、週次制限が追加で適用されます。表向きは「メッセージ数」ですが内部の計量はトークンベースのクレジットで、モデル・入出力・キャッシュ有無でレートが異なります。

そのうえで、公式が明記する節約レバーは次のとおりです。

  1. プロンプトと注入コンテキストの削減 — 共通ルールを短く保ち、開始時の作業ディレクトリ(cwd)と AGENTS.md の読込範囲を合わせます。Codex は起動時にプロジェクトルートから cwd までの経路を読み、cwd より下は自動探索しません。下位に配置するだけでは開始時の指示に入りません
  2. MCP サーバーの絞り込み — 接続した MCP はすべてコンテキストを太らせ、制限を消費します。使っていないものは外します
  3. 軽量モデルへの切替 — ルーチンタスクは軽量系(gpt-5.6-luna 等)へ(gpt-5.4-mini は ChatGPT 認証の Codex で 2026-08-31 に提供終了。API キー認証と OpenAI API はこの終了の対象外)。サブエージェントにも軽量モデルを割り当てるのが公式の想定です
  4. 推論レベルをタスクに合わせる — 速いタスクは Low、複雑な変更だけ High 以上に
  5. スレッドはタスク単位 — 「プロジェクト単位の 1 スレッド運用」は公式の「よくある間違い」リストに載っています。肥大化したスレッドの継続は消費を膨らませます(コスト最適化 の一般原則どおり)

AGENTS.md の例では、ルートで起動すると services/payments/AGENTS.md は開始時の探索経路に入りません。codex --cd services/payments で起動すれば、その経路上の指示が対象になります(各階層の override 優先・サイズ上限は別途適用)。ルートから作業する場合は、必要な下位規約を明示して読むよう依頼し、読込結果を確認する運用を選べます。明示参照は運用上の設計例であり、リンクを書くだけで参照先が自動注入される保証ではありません。公式の探索・確認手順 (アクセス日: 2026-09-10)

2026-10-08 の公式 Pricing では、キャッシュ済み入力のレートはモデルごとに異なります。GPT-6.1 Sol は通常入力 50 / キャッシュ済み入力 2.5 credits per 1M tokens で 1/20、GPT-6 Sol / Luna と GPT-5.6 系は 1/10 です。キャッシュが消費を抑える関係と、具体的なモデル別レートを分けて確認します。

2026-10-08 の公式 Speed では、対応モデルの Fast mode は 契約に含まれる利用枠を標準の 2.5 倍で消費し、購入クレジットと Enterprise の従量利用は標準の 2 倍で課金されます。この倍率は速度倍率ではありません。GPT-5.6 / 5.5 の速度向上は 1.5 倍と案内されていますが、GPT-6 系へ同じ速度倍率を一般化しません。利用可能性はプラン・クライアント・管理者設定・展開状況に依存します。API キー認証では API のトークン料金を使い、ChatGPT のクレジット倍率を適用しません。モデルと認証方式の区別も確認します。

  • 逆に、サブエージェントの多用は消費を増やします(「同等の単一エージェント実行よりトークンを消費する」と公式明記)。並列化の便益と消費のトレードオフで判断してください
  • 残量確認は CLI の /status と Web の使用量ダッシュボードです。コンパクションは自動(閾値は model_auto_compact_token_limit で調整可)+ 手動 /compact があります

業務効率化・自動化

非対話実行(codex exec) は CI 組み込みの中核です。設計が CI 向けに整理されています:

GitHub Action(openai/codex-action@v1) は prompt-file 指定で PR レビュー等を組めます。safety-strategy(既定 drop-sudo)で権限を落とし、公式自身が「ユーザー入力のサニタイズによるプロンプトインジェクションモデルへの入力に紛れ込ませた指示で、開発者の意図した挙動を上書きする攻撃。ユーザー入力による直接型と、Agent が読む外部コンテンツ経由の間接型がある。対策」「ジョブの最終ステップに置く」「トリガーを信頼できるユーザーに制限」を指針にしています。

コードレビュー自動化: リポジトリ単位のトグルで全 PR の自動レビューを有効化でき、観点は AGENTS.md の ## Review guidelines セクションで指定します(変更ファイルに最も近い AGENTS.md が適用されるため、パッケージ固有の観点は深い階層に置けます)。GitHub 経由のレビューのみ「Code Review 使用量」として別枠計上されます。

チャットからの委任: Slack はスレッド文脈を自動参照するため再説明が不要です。Linear はトリアージルールで条件に合う Issue を Codex に自動アサインでき、人手ゼロの委任パターンが組めます(自動化パターン の Issue トリアージの実装例)。

定期タスク(Scheduled): デスクトップアプリでは、ローカルのプロジェクトディレクトリまたは隔離された worktree で実行できます。ローカルファイルを使う回は、PC の電源とアプリの起動が必要です。Web の定期タスクはアップロード済みの資料や接続ツールを使えますが、PC のフォルダーを直接操作できません。作成・更新はアプリまたは Web のチャットから依頼し、実行状況は Scheduled で管理します。Codex CLI には Scheduled の管理画面はありません。

ChatGPT でログインしたローカル Codex は契約の利用枠を使います。API キーで実行すると、ChatGPT の契約枠ではなく OpenAI Platform の API 料金で課金されます。定期実行を設計するときは実行場所と認証方式を分けて確認し、利用制限による中断も見込んでおきます。

設計例として、ローカルの定期タスクが一次情報発信源そのものの情報(論文の原典・公式ドキュメント・公式ブログ・規格本文・法令)。解説・まとめ(二次情報)と区別し、根拠は一次情報に置くのが情報リテラシーの基本。二次情報は「存在を知る」までに使い、一次まで遡って確かめる。の調査・記事編集・PR 作成を担当し、GitHub Actions が文書検証・ビルド・マージ後の公開を担当する分担があります。ChatGPT 認証でローカルのモデル実行を行う構成なら、モデル実行用の API キーを Actions に用意する必要はありません。記事内容のレビューとマージ条件はリポジトリの運用に従います。スケジュール化の前には通常スレッドで手順を試します。

品質を上げる公式プラクティス

  • プロンプトの 4 要素: Goal / Context / Constraints / Done when(完了条件)。依頼設計 の基本構造と同じ枠組みが公式にも明文化されています
  • 難しいタスクは計画から: Plan mode(/plan)を使い、「Codex に自分をインタビューさせて前提を明確化する」手法も公式が案内しています
  • 検証手段を渡す: 「Codex は自分の作業を検証できるとき、より高品質な出力を出す」と公式明記。テスト・lint・型チェックの実行を依頼に含め、仕上げに /review を使います
  • 公式の「よくある間違い」: AGENTS.md を使わずプロンプトに毎回詰め込む / ビルド・テストコマンドを教えない / 計画を飛ばす / 理解前にフル権限を与える / worktree なしでスレッドを並走させる / 不安定なワークフローを自動化する / プロジェクト単位のスレッド運用 — いずれも本章の各記事の原則と一致します

実務での注意点

アンチパターン

  • 1 つのスレッドをプロジェクト全体で使い続ける — 消費が毎ターン膨らみ、品質も落ちます(公式の「よくある間違い」筆頭)。→ タスク単位でスレッドを切り、/compact・新スレッドを使い分けます
  • MCP・サブエージェントを「便利そうだから」全部盛りにする — 常時コンテキストと消費が増え、制限に早く当たります。→ 公式の導入順序(AGENTS.md → スキル → MCP → サブエージェント)に従い、使っていないものを外します
  • Fast mode を常時オンにする — 対象モデルと利用枠・課金区分に応じて消費が増えます(2026-10-08 の条件は本文参照)。→ 対話的な反復など速度が効く場面に限定します
  • 手動で安定していないワークフローを定期タスク・自動レビューに載せる — 失敗が定期的に量産されます。→ 通常スレッドで成功パターンを固めてから自動化します(自動化パターン)

チェックリスト

  • ローカル(探索・ループ)とクラウド(長時間・並列)の使い分けをチームで共有したか
  • 開始 cwd と、ルートからそこまでの AGENTS.md の読込経路を確認したか。経路外の規約が必要なら、対象ディレクトリでの起動または明示的な読込依頼を選び、実際に読まれた指示を確認したか
  • 繰り返し使うプロンプトをスキル化したか(description の発火テスト込み)
  • サブエージェント・ルーチンタスクに軽量モデル / 適切な推論レベルを割り当てたか
  • /status・使用量ダッシュボードでの残量確認を習慣化したか
  • CI 利用(exec / Action)で read-only 既定・API キー分離・入力サニタイズを守っているか

関連トピック

参考資料

TODO・未確認事項

  • codex exec の終了コード仕様、Scheduled のプラン別の利用資格・詳細な消費制限、全 PR 自動レビューの消費レートと draft PR の扱いは未確認です。定期実行で使う ChatGPT 認証と API キー認証の課金区分は本文のとおりです

変わりやすい項目(定点観測)

Claude Code 実践ガイドGitHub Copilot 実践ガイド