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

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

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

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

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

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

config.tomlでの設定レシピ

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

[features]\ngoals = true\napproval_policy = "unless-allow-listed"\nmodel_reasoning_effort = "medium"

[features]\ngoals = true\npermissions = ":workspace"\nmodel_reasoning_effort = "high"\nmodel = "gpt-5.5"

CI環境での実行例

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

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

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

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

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

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

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

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

コスト管理の使い分け方

よくある質問

まとめ

長時間の自律タスクほどコスト管理の重要性が増します。まずはGoalモードで予算を明示的に設定する習慣をつけ、いざという時のためにリセットクレジットの存在も覚えておきましょう。