TokenEconomizerとは？
TokenEconomizerは、何度も戻ってくるリポジトリでコーディングエージェントを安く動かすためのプラグインで、エージェントもモデルも変更しません。セッションが終わるたびに3つのものを更新します。1つ目はmicro-skillsで、セッションが毎回探し直すリポジトリの事実（たとえばpytestがないのでpython -m pytestを使う、など）です。2つ目はリポジトリで一度も使われないツールの一覧で、エージェント自身の設定を通じてそれらを外します。3つ目はloop guardで、失敗を繰り返すターンが行き詰まっているかを判定モデルに尋ね、そうであれば一度だけ方向転換を促します。
Claude Code、Codex、GitHub Copilot CLI、Piに対応し、Cursor、opencode、Hermesは実験的な対応です。ツールの刈り込みとloop guardは初期状態で有効、micro-skillsは無効です。プラグイン専用のAPIキーは不要で、モデル呼び出しはエージェントのCLIを通じて既存のプランで行われ、学習した内容は~/.tokeneconomizerに保存されます。
Microsoft Research、Microsoft Security、UC Berkeleyの研究者による論文「TokenEconomizer: Experience-Driven Black-Box Cost Control for Coding Agents」（arXiv 2610.22732）とともに公開されました。Pythonの標準ライブラリだけで書かれ、Python 3.10以降が必要で、ライセンスはApache-2.0です。バージョン0.1.0は2026年10月26日に出ました。
TokenEconomizerは使う価値があるか？
TokenEconomizerは、管理された研究に裏付けられたコーディングエージェント向けのコスト削減アドオンで、その研究が支えるのは控えめで信頼できる主張です。何度も戻ってくるリポジトリでは、エージェントは同じ失敗や一度も呼ばないツールに費用を払わずに済むようになります。論文は6つのリポジトリから取った277件のSWE-Benchタスクを順番に実行し、それぞれ3つのシードで、エージェントとモデルの5つの組み合わせを試しました。キャッシュを考慮した平均コストは改変なしのエージェントより18.4から30.9%低く、リポジトリと組み合わせの30のセルすべてで下がり（5.2から40.1%）、プラグイン自身のモデル呼び出しはそれを引き起こしたタスクに計上されています。同じ条件で、RTK単体はそのうち12のセルでコストを上げ、AiderのRepoMapは15のセルで上げました。
注意すべき点は論文自体に書かれています。Pass@1は5つの組み合わせのうち4つで上がり、Opus 4.8を使ったClaude Codeでは1.0ポイント下がりました。論文は3つのシードでの標準偏差を示していますが有意性検定はなく、差の多くは1から2ポイントです。ハイパーパラメータは同じ6つのリポジトリでの開発用の実行で決められ、タスクの列は実際の利用者のセッションではなく独立した修正で、著者は対話的な利用は検証していないと述べています。節約には時間もかかります。xarray以外のすべてのリポジトリで最初は費用が増え、6件目のタスクまでにすべてが安くなりました。
配布時の初期設定は、見出しの数字を生んだ構成ではありません。18.4から30.9%という数字は3つの仕組みすべてを使っていますが、プラグインは初期状態でmicro-skillsを無効にしています。Claude Codeについて、論文のアブレーションはツールの刈り込みだけで13.2%（Sonnet 5）と17.7%（Opus 4.8）、micro-skillsだけで11.8%と14.3%、loop guardだけで7.1%と5.4%としています。私たちが見つけた唯一の独立した検証は、v0.1.0のタグより前にyoDEVがDEV Communityで公開したもので、この見方と合っています。小さなPythonリポジトリでの8件のバグ修正を各側2回ずつ実行したところ、刈り込みで284個のツールが外れ、リクエストあたりのコンテキストは31%減り、セッションあたりの費用はわずか4セッションで15%下がりました（$0.72から$0.61）。micro-skillsは一度も有効にならず、loop guardも一度も作動しませんでした。
データの扱いは多くの製品より明快です。追加のAPIキーはなく、判定、方向転換、事実の提案の呼び出しは自分のエージェントのCLI（claude -p、codex exec、copilot -p）を通り、Claude Codeでは初期設定でHaikuを使います。ドキュメントによれば、どの呼び出しにもファイルの中身やプロンプトは渡されません。判定モデルが見るのは直近24のアクションで、コマンドは90文字で切られ、最大でおよそ1,500トークンです。学習した状態は~/.tokeneconomizerに残り、ドキュメントにテレメトリーの記載はありません。ただし刈り込みは.claude/settings.local.jsonのようなプロジェクトのファイルに拒否リストを書き込み、.git/info/excludeでgitから隠します。
初期段階の研究リリースです。リポジトリは2026年10月13日に作成され、スターは約4,800、未解決のissueとプルリクエストは16件で、Windowsのフック起動部のメモリリーク（#144）や、ツールを並列実行したときのloop guardの競合状態（#142）が含まれます。検証済みのエージェントのバージョン範囲は狭く、たとえばClaude Codeは2.1.300から2.1.310で、それより新しいバージョンは未検証です。RTKがコマンドの出力を圧縮するのに対し、TokenEconomizerはエージェントが読み込み繰り返すものを変えるので、両者は併用できます。論文でのOpus 4.8の最良の結果、33.2%のコスト削減は両方を組み合わせたものでした。
真価を発揮する場面
APIプランで、1つのDjangoモノレポで毎日Claude Codeを使うバックエンド開発者
リポジトリで一度も使わないMCPツールやコネクターへの支払いをやめる
プラグインを入れて初期設定のままにします。数セッション後、ツールの刈り込みが.claude/settings.local.jsonに拒否リストを書き込みます。温まったプロンプトキャッシュを壊さないよう、約1時間操作がない時に行われます。yoDEVの小さな検証では284個のツールが外れ、リクエストあたりのコンテキストが31%減りました。toolprune restoreで元に戻せます。
Codexを使う10人のチームのエージェント費用を見ているエンジ ニアリングマネージャー
チームの主要リポジトリでエージェントの費用が本当に下がるかを確かめる
各開発者が導入します。statusとリポジトリごとのledger.jsonlが、プラグイン自身の呼び出しを含むセッション費用を示します。最初のセッションは高くつくと考え、論文の18.4から30.9%ではなく、通常の作業を1週間続けた後の結果で判断してください。
エージェントが同じ失敗するテストコマンドを何度も実行し直してしまう開発者
エージェントを手で止めずに長い失敗のループを断ち切る
リポジトリで5回のターンが成功した後、loop guardは行き詰まって見えるターンを自分のプラン上の判定モデル（Claude Codeでは初期設定でHaiku）に送り、判定モデルの確信度が0.7以上なら一度だけ方向転換を促します。自分からターンを止めることはなく、ヘッドレス実行では印の付いたターンもエージェント自身の上限まで続きます。
導入前に確認すること
- 導入
- Python 3.10以降が必要です。リポジトリをクローンしてその場所に置いたまま、プラグインのマーケットプレイスとして追加し、tokeneconomizer@tokeneconomizerをインストールします（claude、codex、copilotのpluginコ マンド）。Piはgitから直接インストールします。Claude CodeとCopilot CLIでは、マシンごとに1回と、エージェントを更新した後にtoolprune refresh-catalogを実行します。
- 連携
- 検証済みはClaude Code 2.1.300から2.1.310、Codex 0.153.1から0.164.0、Copilot CLI 1.0.83から1.0.102、Pi 1.2.0から1.3.0です。Cursor、opencode、Hermesは実験的です。刈り込みで外れるのは、Claude Codeでは個々のツール、Codexでは機能パッケージ、Copilot CLIではMCPサーバー全体で、その他では何も外れません。
- データとプライバシー
- 事実、ツールの利用状況、ループの履歴、費用の記録、エラーログは~/.tokeneconomizerに残り、このフォルダを消せば学習内容も消えます。モデル呼び出しはエージェントのCLIを通り、ドキュメントによればファイルの中身やプロンプトは含まれません。テレメトリーの記載はありません。Apache-2.0。
- 大規模利用時のコスト
- プラグインは無料です。判定モデルと事実の提案の呼び出しは自分のプランに課金され、初期設定ではターンが行き詰まって見えるときだけモデルを呼びます。ホスティング版や有料版は公表されていません。
- 制限
- 節約には同じリポジトリでの繰り返しのセッションが必要で、最初はマイナスから 始まります。Copilot BYOKではプラグインのモデル呼び出しが一時停止されます。エージェント内でプラグインのコマンドを実行するとモデルの1ターン分の費用がかかります。未解決のissueとプルリクエストは16件で、Windowsのメモリリークやloop guardでの並列ツールの競合状態が含まれます。
良い点
- 3つのシードで測定し自身の呼び出しも含めた論文で節約を確認
- 追加のAPIキー不要で、モデル呼び出しはエージェントのCLI経由
- 学習した状態は~/.tokeneconomizerにローカル保存
- どの操作も元に戻せ、プラグインが失敗してもセッションは続く
気になる点
- 見出しの結果の一部であるmicro-skillsは初期状態で無効
- 新しいリポジトリでは最初の数タスクで費用が増える
- ハイパーパラメータは検証と同じリポジトリで調整
- v0.1.0で、Windowsと並行処理の未解決バグがあり、検証済みのエージェントのバージョンが狭い
おすすめの人
Claude Code、Codex、Copilot CLIにトークン単位で支払い、同じいくつかのリポジトリで毎日エージェントを動かす開発者とチーム。
TokenEconomizerの代替
TokenEconomizer：よくある質問
- TokenEconomizerは使う価値があるか？
- 実際の研究に裏付けられたコスト削減策で、毎日作業するリポジトリには入れる価値がありますが、配布時の初期設定では論文の見出しの数字より小さな効果を見込むべきです。 評価は5点満点中3.8点です。
- TokenEconomizerの料金は？
- Apache-2.0ライセンスで無料です。プラグイン自身のモデル呼び出しは、既存のエージェントのプランまたはキーに課金されます。
- TokenEconomizerの欠点は？
- 見出しの結果の一部であるmicro-skillsは初期状態で無効; 新しいリポジトリでは最初の数タスクで費用が増える; ハイパーパラメータは検証と同じリポジトリで調整; v0.1.0で、Windowsと並行処理の未解決バグがあり、検証済みのエージェントのバージョンが狭い.
- TokenEconomizerは誰に向いているか？
- Claude Code、Codex、Copilot CLIにトークン単位で支払い、同じいくつかのリポジトリで毎日エージェントを動かす開発者とチーム。
- チームや本番環境でTokenEconomizerを使うと費用はいくらか？
- プラグインは無料です。 判定モデルと事実の提案の呼び出しは自分のプランに課金され、初期設定ではターンが行き詰まって見えるときだけモデルを呼びます。ホスティング版や有料版は公表されていません。
- TokenEconomizerは企業データを扱っても安全か？
- 事実、ツールの利用状況、ループの履歴、費用の記録、エラーログは~/.tokeneconomizerに残り、このフォルダを消せば学習内容も消えます。モデル呼び出しはエージェントのCLIを通り、ドキュメントによればファイルの中身やプロンプトは含まれません。テレメトリーの記載はありません。Apache-2.0。
- TokenEconomizerの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はrtk (Rust Token Killer), context-mode 、 ccusageです。
回答確認日：2026年11月5日