mcpField
C
cco-budget

cco-budget

github.com/egorfedorovエージェントワークフロー125208 回インストール1 日前に更新
リポジトリ

cco-budget について

cco-budgetはClaude Codeセッション向けのモデル対応トークン予算管理スキルです。予算上限、フォールバックモデル、自動コンパクションのしきい値を確認・変更でき、入力と出力のコストを個別に見積もります。

主な機能

  1. 01予算と自動コンパクション設定の表示
  2. 02トークン予算上限の設定
  3. 03コスト見積もり用フォールバックモデルの設定
  4. 04自動コンパクションの有効化と無効化
  5. 05入力と出力のコストを個別に見積もり

活用シーン

  1. 01現在のセッション予算設定の確認
  2. 02セッションのトークン上限の調整
  3. 03コスト見積もり用フォールバックモデルの設定
  4. 04自動コンパクションの有効化または無効化

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/egorfedorov/claude-context-optimizer --skill cco-budget

インストール後、Claude Code で/cco-budgetを入力して読み込まれたか確認します。

詳細

コンテキスト予算マネージャー

Claude Code セッションのトークン予算を管理します。モデルを考慮し、モデルごとに適切な実効コンテキストウィンドウと料金を選択します。セッションで実際に使用されているモデルは予算フックがトランスクリプトから読み取ります。config.model はフォールバックとしてのみ使用されます。Sonnet 4.6 以降はすべて 1M、Haiku 4.5 は 200K です。

$ARGUMENTS を解析します。

status（または引数なし）

現在の予算設定と自動コンパクト設定を表示します。
~/.claude-context-optimizer/config.json と ~/.claude-context-optimizer/budget-config.json を読み取ります（どちらも存在しない場合があります）。 設定ファイルがない場合は、デフォルト値（1M ウィンドウで作業予算 200K、フォールバックモデル opus-5.5、50/70/85/95% で警告）を表示します。

set <tokens>

予算上限を更新します。トークン数を解析します（200K、1M、500000 はすべて使用できます）。 ~/.claude-context-optimizer/config.json を更新します（書き込みにはユーザーの承認が必要です）。

{
  "budgetTokens": <parsed_number>,
  "warnAt": [50, 70, 85, 95],
  "autoCompactAt": 90,
  "model": "opus-5.5"
}

budgetTokens が選択したモデルのコンテキストウィンドウを超える場合は、ユーザーに警告します。

model <name>

コスト計算に使うフォールバックモデルを設定します（セッションのトランスクリプトにまだモデル ID がない場合のみ使用されます）。対応するキー：

  • haiku-4.5（エイリアス haiku）— 100 万トークンあたり $1/$5、200K
  • sonnet-4.6（エイリアス sonnet）— 100 万トークンあたり $3/$15、1M
  • sonnet-5 — 100 万トークンあたり $2/$10、1M
  • sonnet-5.5 — 100 万トークンあたり $2/$10、1M
  • opus-4.7 / opus-4.8 — 100 万トークンあたり $5/$25、1M
  • opus-5（エイリアス opus）— 100 万トークンあたり $5/$25、1M
  • opus-5.5（デフォルト）— 100 万トークンあたり $4/$20、1M、キャッシュ読み取りは 0.05×
  • fable-5 — 100 万トークンあたり $10/$50、1M
  • fable-5.1（エイリアス fable）— 100 万トークンあたり $10/$50、1M、キャッシュ読み取りは 0.025×（他のモデルでは 0.1×）

opus-4.8-1m / opus-4.7-1m / opus-extended は後方互換性のためのエイリアスのみです。1M の追加料金はなく、1M ウィンドウは $5/$25 で標準提供されます。

config.json の model フィールドを更新します。1M コンテキストモデルに切り替える際、現在の budgetTokens が 500K 未満の場合は、1M に引き上げるかどうかをユーザーに確認します。

auto <on|off>

しきい値（80% / 90%）での自動コンパクトを切り替えます。次のファイルを更新します。 ~/.claude-context-optimizer/budget-config.json：

  • auto on → autoCompactEnabled: true
  • auto off → autoCompactEnabled: false

ファイルがない場合のデフォルト値：

{
  "autoCompactEnabled": true,
  "autoCompactThreshold": 80,
  "criticalThreshold": 90
}

コスト計算

予算モニターは、入力トークンと出力トークンを個別に推定し、モデルの実際の入出力料金を使うようになりました。例：Edit で 200 文字の new_string を使う場合、出力トークンは約 54 として数えられ、モデルの出力料金で課金されます。

実効予算倍率

予算使用率が 50% 以上になると、モニターに CCO が実効予算をどれだけ拡大したかが表示されます。たとえば、Read Cache とファイルダイジェストによって重複した読み取りが十分に削減され、200K のコンテキストが約 320K 相当として機能する場合、「実効性が 1.6 倍向上」のように表示されます。

コメント

Markdown 対応