cco-tools について
cco-tools はツール結果の実測トークンコストを記録し、ツール名ごとに使用量を集計します。MCP を多用する Claude セッションで、コンテキスト予算の消費先や推定の信頼性を確認できます。
主な機能
- 01ツールごとの平均・最大コストを記録
- 02呼び出し数と累計使用量を集計
- 03サンプルが3件未満の推定を表示
- 04学習したコスト履歴をリセット
活用シーン
- 01コンテキスト予算を最も消費するツールの特定
- 02コスト変動の大きいツールのクエリを絞り込み
- 03MCP 設定変更後の再測定
MCP 対応
MCP と Agent のツール結果にかかるトークンコストを測定します。MCP サーバーを提供するものではありません。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/cco-toolsを入力して読み込まれたか確認します。
詳細
CCO Tools — ツールの実際のコスト
MCP とエージェントのトークンコストは、以前は一度決めた定数（mcp__* ≈ 200 入力、Agent ≈ 500）でした。実際の結果には桁違いの差があります。「すべての issue を一覧表示する」クエリと 1 行を検索するクエリは、同じツール名でもコストはまったく異なります。MCP を多用するセッションでは、予算メーターは最も大きな項目を推測するしかありませんでした。
CCO は現在、すべてのツール結果を測定し、ツール名ごとの平均を学習します。
プラグインのルートから実行します。
show（または引数なし）
node ${CLAUDE_PLUGIN_ROOT}/src/tool-costs.js
学習した表を出力します。ツールごとの呼び出し回数、平均、最悪値、累計が、合計コストの高い順に表示されます。
ユーザーに結果を説明する際に役立つポイントは次のとおりです。
totalが最も大きい行が、実際にコンテキスト予算を消費している箇所です。 多くの場合、ファイルの読み取りではなく MCP サーバーです。·が付いた行はサンプルが 3 件未満で、引き続き組み込みの定数を使用しています。推定値はまだ信頼できません。avgとmaxの差が大きい場合、そのツールの結果は予測しにくいことを意味します。使用をやめるのではなく、クエリを絞り込むよう提案してください（フィルター、上限、ページネーションなど）。
/cco-overhead mcp と併用してください。そちらでは、設定されているものの呼び出されていないサーバーがわかります。こちらでは、呼び出されたサーバーの実際のコストがわかります。
reset
node ${CLAUDE_PLUGIN_ROOT}/src/tool-costs.js reset
学習した表を消去し、すべてのツールを組み込みの定数に戻します。MCP サーバーやその設定を変更し、過去の測定値が現在のセットアップを反映しなくなった場合に便利です。実行前に確認してください。履歴は復元できません。