Codexのトークン予算設定でコストを上限管理する方法（rollout token budget）

「Codexにまとめて処理を任せていたら、気づいたときには想定よりずっと多くのトークンを消費していた」——複数のエージェントスレッドを走らせるような使い方をしていると、誰もがこの不安を抱えます。

結論から言うと、Codexには2026年6月のアップデートで「rollout token budget（ロールアウト・トークン予算）」という機能が追加されました。1回の実行全体で消費してよいトークン量に上限を設定でき、上限が近づくと警告を出し、使い切るとその処理を自動的に中断してくれます。

株式会社FyveはCodexやClaude Codeなど生成AIツールの中小企業への導入支援を行っています。本記事では公式のリリースノートと設定ファイルの仕様をもとに、rollout token budgetが何をしてくれる機能なのか、どう設定し、どう使い分ければよいかを整理します。

rollout token budgetとは

「rollout（ロールアウト）」は、Codexが1つのタスクを開始してから完了するまでの一連の処理のまとまりを指す言葉です。メインのやり取りだけで完結する場合もあれば、途中で複数の「エージェントスレッド（サブエージェント）」が派生し、並行して作業を進めることもあります。rollout token budgetは、この一連の処理全体で共有される、合計トークン消費の上限を設定する機能です。

Codexの公式リリースノート（openai/codexリポジトリのバージョン0.142.0）には、次のように説明されています。「Configurable rollout token budgets track usage across agent threads, provide remaining-budget reminders, and abort turns when exhausted.」——日本語にすると「設定可能なロールアウト・トークン予算は、エージェントスレッド全体の使用量を追跡し、残り予算のリマインダーを提供し、予算を使い切るとターンを中断する」という機能です。

ポイントは、上限が1つのエージェントだけでなく、そこから派生した複数のスレッドすべてに対して共有される点です。メインの処理とサブエージェントがそれぞれ別々にトークンを消費していても、合算した消費量が1つの予算枠として管理されます。

なぜコスト管理に効くか（暴走防止・費用の予測可能性）

Codexには、1つのタスクの中で必要に応じて複数のサブエージェントを呼び出す「マルチエージェント委任」の仕組みがあります。これは複雑な作業を分担して進められる便利な機能である一方、上限を設定していないと、派生したスレッドの数だけトークン消費が積み上がり、1回の実行でどこまでコストが膨らむか事前に読めないという課題がありました。

rollout token budgetは、この「読めないコスト」に上限という形で歯止めをかけます。上限（limit_tokens）に達すると、それ以降の処理はエラーとして中断される仕組みのため、1回の実行にかかる最大コストをあらかじめ見積もれるようになります。想定外の使いすぎに気づかないまま処理が進み続ける事態を防げる点が、この機能の一番の価値です。

加えて、公式の設定項目には出力トークン（sampling_token_weight）と入力トークン（prefill_token_weight）をそれぞれ別の重みで予算計算に反映する設定もあります。既定値はどちらも1.0ですが、一般的に生成コストが高くなりやすい出力トークン側の重みを引き上げるといった調整もできる設計です。単純な合計トークン数だけでなく、実際の費用感に近い形で予算を管理できます。

同じアップデートでは、サブエージェントへの処理委任そのものを「無効化」「明示的な依頼があった場合のみ許可」「積極的に任せる」の3段階で制御できる設定も追加されています。委任の範囲を絞る設定と、消費できるトークン量の上限を絞る設定を組み合わせることで、コストが膨らみやすい根本原因（委任のしすぎ）と、その結果（トークン消費の増加）の両面から歯止めをかけられます。

外部に開発を依頼せず自社でCodexを使った自動化を組んでいる中小企業ほど、想定外のコスト増を事後にチェックする体制は手薄になりがちです。rollout token budgetは、超過に気づいてから対応するのではなく、超過そのものを未然に防ぐという発想への転換だと捉えると分かりやすくなります。

読者特典・無料ダウンロードひとりAI経営 全体マップ無料でダウンロード →↓

設定と使いどころ（どの業務で上限を絞るか）

rollout token budgetは、Codexの設定ファイル（config.toml）に記述して有効化します。公式のプルリクエストで示されている設定例は次のとおりです。

[features.rollout_budget]
enabled = true
limit_tokens = 100000
reminder_at_remaining_tokens = [65536, 32768, 16384, 8192]
sampling_token_weight = 1.0
prefill_token_weight = 1.0

それぞれの項目の役割は次のとおりです。

• enabled：機能そのものを有効にするかどうか
• limit_tokens：1回のロールアウトで消費できるトークン量の上限
• reminder_at_remaining_tokens：残りトークン数がここで指定した数値を下回るたびに、警告メッセージを出すしきい値の一覧
• sampling_token_weight / prefill_token_weight：出力トークン・入力トークンをそれぞれどの程度の重みで予算計算に含めるかの倍率

この設定は専用の管理画面ではなく、テキストファイルを直接編集する形式です。細かい数値の意味を理解した上で記述する必要があるため、非エンジニアの方が単独で調整するにはやや専門的な作業になります。導入時に一度、詳しい担当者に安全な初期値を決めてもらい、以降はその値を必要に応じて見直していく運用が現実的です。

上限の絞り方は、業務の性質によって変えるのが基本的な考え方です。やることが決まっている定型的な自動化タスクは、実績に近い数値まで上限を絞って暴走の芽を早めに摘み、逆に消費量が読みにくい探索的な作業は余裕を持たせつつも上限は必ず設定する、という使い分けが現実的です。

特に、複数のスレッドをまとめて動かすような自動化の運用では、この上限設定が効いてきます。バルク処理やスレッドの引き継ぎを伴う自動化については、以下の記事もあわせてご覧ください。

CodexCodex自動化のバルク操作とスレッドハンドオフ｜実行履歴の一括管理とlocal↔remote引き継ぎ

使用量確認との違い・併用

Codexには、日次・週次・累計のトークン使用量をアカウント全体で確認できる「使用量確認」の仕組みも用意されています。rollout token budgetとは役割が異なるため、混同しないよう整理しておきます。

• 使用量確認（/usage）：すでに消費した分を事後に振り返る「可視化」の機能。全体の傾向をつかむのに向いている
• rollout token budget：これから始まる1回の実行に対して、あらかじめ上限を決めておく「事前の制御」の機能

実務では、この2つを組み合わせて使うのが効果的です。まず使用量確認で「この種類のタスクは平均してどれくらいのトークンを消費しているか」という実績を把握し、その数値を踏まえてrollout token budgetの上限値を決める、という流れです。使用量確認の詳しい見方については、以下の記事で解説しています。

CodexCodex の使用量を確認する方法｜トークン管理の実務

よくある質問

rollout token budgetを使うのに追加費用はかかりますか？

機能自体はCodexのアップデートで無料提供されている設定項目です。上限に達するまでに実際に消費したトークン分の利用料は、通常どおり発生します。正確な料金体系については最新の公式情報で確認してください。

設定にはエンジニアの知識が必要ですか？

現時点ではconfig.tomlという設定ファイルを直接編集する形式で、専用の管理画面はありません。TOML形式のテキストを手で追記する作業になるため、非エンジニアが単独で設定するにはやや敷居があります。導入時に一度、詳しい担当者に安全な初期値を設定してもらう運用をおすすめします。

上限に達すると、実行中の処理は強制終了されますか？

即座に処理を打ち切るのではなく、消費量が上限を超えた時点でそのターン（一連のやり取りの単位）を中断する仕組みです。公式の実装説明では「ソフトな境界」と表現されており、他のスレッドに割り込んで一斉に停止させるものではないとされています。

使用量確認（/usage）と何が違いますか？

/usageはアカウント全体の使用量を日次・週次・累計で確認する「事後の可視化」機能です。一方rollout token budgetは、1回の実行が始まる前に上限をあらかじめ決めておく「事前の制御」機能です。/usageで実績を把握し、その数値を踏まえてrollout token budgetの上限値を調整するのが実務的な使い方になります。

上限値はどのくらいに設定すればよいですか？

業務内容によって適正値は変わるため、公式に推奨される固定値はありません。まずは使用量確認で普段のタスクが消費しているトークン量の目安を把握し、それに余裕を持たせた数値から始めて、実際の運用の中で調整していくことをおすすめします。

設定を変更したら、すぐに反映されますか？

設定ファイルの変更は、新しく開始する実行（ロールアウト）から反映される仕組みです。すでに走っている処理の途中で設定を書き換えても、その処理自体には反映されません。次の実行を始める前に設定を見直す運用にしてください。

まとめ

rollout token budgetは、Codexが1回の実行で消費するトークン量に上限を設けられる機能です。要点を整理します。

• 「ロールアウト」＝1回の処理全体（メインのやり取り＋派生したエージェントスレッド）で、合計トークン消費の上限を共有できる
• config.tomlの[features.rollout_budget]で有効化し、limit_tokensで上限、reminder_at_remaining_tokensで警告のタイミングを指定する
• 上限に達するとそのターンを中断する「ソフトな境界」であり、他のスレッドを一斉停止させるものではない
• 出力トークン・入力トークンをそれぞれ別の重みで予算計算に反映する調整も可能
• 使用量確認（/usage）による事後の可視化と組み合わせることで、実績に基づいた予測可能なコスト管理ができる
• 業務の定型度・重要度に応じて、上限の厳しさを使い分けるのが実務的な運用

複数のエージェントスレッドを使いこなすほど、コストの見通しは立てにくくなります。rollout token budgetという「上限を決めておく」選択肢を知っておくことは、Codexを業務で安心して使い続けるための土台になります。