コスト最適化ガイド

Codexのトークン予算・
利用上限管理完全ガイド

Goalモードのトークン予算設定と、利用上限をリセットできるクレジット機能まで解説します。

Codexで自律的に長時間タスクを走らせると、気づかないうちにトークンを大量消費してしまうことがあります。本記事では、Goalモードのトークン予算設定と、利用上限をリセットできるクレジット機能という2つのコスト管理手段を解説します。

Goalモードのトークン予算とは

Goalモード（/goal）で長時間の自律タスクを実行する際、トークン予算がコスト制御の主要なレバーになります。予算が尽きると「ソフトストップ」が発動し、進行中のターンは最後まで完了させた上で、それ以降は実質的な新規作業を開始しない挙動になります。強制的に打ち切られるのではなく、きりの良いところで止まるイメージです。

Goalの起動

/goal Refactor the auth module to use the new OAuth2 library

目標を作成する際には暗黙的なデフォルト予算が設定されますが、App Server API経由では明示的にトークン予算を指定することもできます。

App Server APIでの明示的な予算指定

{
  "method": "thread/goal/set",
  "params": {
    "token_budget": 500000
  }
}

config.tomlでの設定レシピ

用途に応じて、保守的な設定と自律性を優先した設定を使い分けられます。

保守的な設定（承認を重視）

config.toml

[features]
goals = true
approval_policy = "unless-allow-listed"
model_reasoning_effort = "medium"

自律的な設定（長時間タスク向け）

config.toml

[features]
goals = true
permissions = ":workspace"
model_reasoning_effort = "high"
model = "gpt-5.5"

CI環境での実行例

codex execコマンド

codex exec \
  --config features.goals=true \
  --config model_reasoning_effort=medium \
  "Fix all type errors..."

マルチエージェントの委任設定について

App Server経由でCodexを組み込むクライアント向けには、サブエージェントへの委任を「無効」「明示的なリクエスト時のみ」「プロアクティブ」の3段階で制御する仕組みも用意されています。ただしこれは主に開発者がApp Server APIを直接扱う場面での設定であり、通常のCLI利用では意識する必要はほとんどありません。

利用上限リセットクレジット（Reset Credits）

トークン予算とは別に、Codexには利用上限そのものをリセットできるクレジットという仕組みもあります。/usageコマンドから、トークン利用状況の確認に加えて、獲得済みのリセットクレジットの確認・利用（redeem）ができます。

利用状況の確認コマンド

/usage           # メニューを表示（トークン利用状況・リセットクレジット等）
/usage daily     # 日次の利用状況
/usage weekly    # 週次の利用状況
/usage cumulative # 累積の利用状況

リセットクレジットの獲得方法

ローンチ特典：Plus・Proの全加入者に1回分の無料リセットクレジットが付与された実績があります
招待特典：招待された相手が初めてCodexにメッセージを送ると、招待した側・された側の両方に1回分のリセットクレジットが付与されます

リセットクレジットの使い方

Codexのプロフィールまたは利用状況メニューから、貯まっているリセットをクリックして確認するだけで有効化され、対象となる利用上限がその場でリフレッシュされます。

APIクレジットとは別物

リセットクレジットはAPIクレジットではなく、譲渡・売却・現金化はできません。あくまで「現在の利用上限ウィンドウ内でCodexを使い続けられるようにする」ためのリセット権であることを理解しておきましょう。

コスト管理の使い分け方

目的	使う機能
長時間の自律タスクで暴走を防ぎたい	Goalモードの`token_budget`設定
承認ステップを厳しくして安全に倒したい	`approval_policy = "unless-allow-listed"`
スピード重視で自律性を高めたい	`permissions = ":workspace"` ＋高いreasoning effort
利用上限に達しても今すぐ作業を続けたい	`/usage`からリセットクレジットを利用