alexgreensh/token-optimizer

English · 한국어 · 简体中文 · 日本語

無駄にしているトークンを削る。失うはずだった仕事を残す。

バックグラウンドで自動的に動きます。いつも通り作業を続けてください。全体像が欲しいときに監査を実行します。

30秒バージョン

Token Optimizerは、AIコーディングアシスタントが無駄にするトークンを削り、セッションと圧縮(compaction)をまたいで仕事を生かし、毎ドルがどこに行ったかをライブダッシュボードで示します。ほとんどは自動で動きます。インストールして監査を一度実行すれば、あとはフックが処理します。

なぜHeadroomやRTKで済ませないのか? どちらもコマンド出力を圧縮しますが、それはコンテキストの15〜25%しかカバーしません。Token Optimizerはそれに加えて残り75%をカバーします:膨張した設定、未使用のスキル、古いメモリ、圧縮ロス、モデルの誤ルーティング、振る舞いの無駄。すべての節約はキャッシュセーフで測定されます。ダッシュボードは毎セッション後に自動更新されます。

Devinがロードマップの次です。

何が得られるか

毎セッション自動で動き、あなたは何もしない:

• 🔄 スマート圧縮(Smart Compaction): 自動圧縮前にチェックポイント、後に復元
• 🗄️ セッション継続性(Session Continuity): セッション間ヒント、コールドリジューム、チェックポイント採点
• 📦 アクティブ圧縮(Active Compression): 9機能、すべてデフォルトオン(delta diff、スケルトン、bash/検索圧縮、リーン出力ナッジ、品質ナッジ、ループ検出、アクティビティモード、意思決定抽出)
• 📊 品質スコアリング(Quality Scoring): 7シグナル、リアルタイム、S〜Fの文字等級
• 🗃️ セッションデータベース(Session Database): SQLite、15テーブル、完全な監査証跡、ゼロネットワーク
• 🔍 プログレッシブ開示(Progressive Disclosure): 大きな出力はアーカイブ、要求時に展開
• 🧠 コンテキストインテル要約(Context Intel Digest): 圧縮後の再読込なしの再位置づけ
• 🔀 モデルルーティングナッジ(Model Routing Nudges): タスクに合ったティアへ誘導

あなたが求めたとき:

• 🩺 /token-optimizer: ガイド付き修正を伴う完全監査
• 📈 /token-coach: 具体的な修正を伴う30日トレンド分析
• ⚡ quick: 10秒ヘルスチェック
• 🎯 route: お金を使う前に、このタスクが実際に必要とするモデルとeffort
• 🔧 doctor: インストールチェック
• 💰 savings: ドル節約レポート
• 📋 report: コンポーネント別トークン内訳
• 🌐 dashboard: 完全ダッシュボードを開く
• 📝 memory-review: MEMORY.md構造監査
• 📂 expand: アーカイブされたツール結果を取得
• 🔙 resume-lean: コールドセッションを再開

インストールして/token-optimizerを一度実行すれば、あとはすべて自動で動きます。

Claudeデスクトップアプリ内のステータスバー

_{30秒のプレビュー。 音声付きのフルムービーを見る（50秒）。}

Claude Codeでは、プラグインが独自のインターフェース要素を追加できるようになりました。これをmodと呼びます。Token Optimizerはmodを使って、プロンプトのすぐ上にセッションの状態を表示します。品質グレード、コンテキストの使用率、キャッシュが保持される残り時間、そして2つの利用上限です。いま注意すべきことを一文で伝え、ボタン1つで対処できます。小さなオレンジ色のマスコットClawdがセッションの動きを演じるので、Claudeが読んでいるのか、編集しているのか、許可を待っているのか、完了したのかが一目でわかります。

プラグインに含まれているため、追加のインストールは不要です。詳しくはこちら。

インストール

Claude Code(推奨):

/plugin marketplace add alexgreensh/token-optimizer
/plugin install token-optimizer@alexgreensh-token-optimizer

その後Claude Codeで: /token-optimizer

インストール後に自動更新を有効にしてください。 Claude Codeはサードパーティのマーケットプレースをデフォルトで自動更新オフで配布します。/plugin → Marketplacesタブ → alexgreensh-token-optimizerを選択 → Enable auto-update。一回限り、10秒です。

インストール後、/token-optimizerを一度実行してフックを設定してください。それ以降はすべて自動で動きます:圧縮、チェックポイント、品質スコア、ダッシュボード更新。監査が欲しいとき以外、コマンドを再実行する必要はありません。

codex plugin marketplace add alexgreensh/token-optimizer

{ "$schema": "https://opencode.ai/config.json", "plugin": ["token-optimizer-opencode"] }

openclaw plugins install github:alexgreensh/token-optimizer

git clone https://github.com/alexgreensh/token-optimizer.git
token-optimizer/install.sh --hermes

git clone --depth 1 https://github.com/alexgreensh/token-optimizer.git
cd token-optimizer
bash install.sh --copilot

git clone --depth 1 https://github.com/alexgreensh/token-optimizer.git
cd token-optimizer
bash install.sh --cursor

tmp="$(mktemp -d)"
release_json="$(curl -fsSL https://api.github.com/repos/alexgreensh/token-optimizer/releases/latest)"
tag="$(python3 -c 'import json,sys; print(json.load(sys.stdin)["tag_name"])' <<<"$release_json")"
git clone --branch "$tag" --depth 1 https://github.com/alexgreensh/token-optimizer.git ~/.claude/token-optimizer
bash ~/.claude/token-optimizer/install.sh
rm -rf "$tmp"

sed -i 's/\r$//' ~/.claude/token-optimizer/install.sh
# すでにリポジトリがある? 改行をその場で再正規化:
git -C ~/.claude/token-optimizer add --renormalize . && git -C ~/.claude/token-optimizer checkout -- .

/plugin uninstall token-optimizer@alexgreensh-token-optimizer

何が違うのか

ほとんどのトークンツールはコマンド出力を圧縮します。それはコンテキストの15〜25%をカバーします。残り75%は手つかずです。

圧縮カバレッジ。 Headroom、RTK、JFrog Boostはbashとコマンド出力を圧縮します。Token Optimizerは出力スタックの8つの面を圧縮します。状態: 🟢 サポート、🟡 部分、🔴 非サポート。

RTKとBoostは最初の面に到達します。Headroomは最初と3番目に到達します。Token Optimizerは8つすべてをカバーし、圧縮の周りで何が起きるかへ進み続けます:

• 1つではなく3種類の無駄。 構造的(膨張した設定、未使用スキル、古いメモリ)、ランタイム(冗長な出力、再読込)、振る舞い(モデル誤ルーティング、キャッシュ期限、再試行ループ)。それぞれの仕組み →
• 節約は圧縮を生き残る。 自動圧縮前にチェックポイント、後に復元。これがないと、圧縮の節約は圧縮が発火した瞬間に消えます。
• 役に立ったか測る。 前後のトークン差分、4つの価格ティアにわたるドル節約、劣化を追跡する品質スコア。単なる「圧縮した」ではありません。
• ゼロのベースラインオーバーヘッド。 外部プロセス、コンテキストに常時オンの指示なし、MCPサーバーなし、依存関係なし、テレメトリなし。

この10行は、Token Optimizerがその行で唯一🟢の行です: 圧縮を超えて生き残るもの、そしてどの圧縮器も探さない無駄。圧縮の仕組み、コストと安全性、そして私たちが負ける2行は折りたたみの後ろにあります。

ダッシュボード

1つのHTMLページ、SessionEndフック経由で毎セッション後に自動再生成、手動トリガー不要。ブックマーク可能なURL http://localhost:24842/token-optimizerはオプトインです: python3 skills/token-optimizer/scripts/measure.py setup-daemonを実行してローカルサーバーを起動した後にのみ動作します。それまでは、measure.py dashboardが Dashboard:行に出力するファイルパスを開いてください。

ターンごとのトークン内訳、4つの価格ティアにわたるコスト、TTLミックスとヒット率を伴うキャッシュ分析、すべてのセッションに重ねられた品質スコア、サブエージェントコスト内訳、計測済みと推定を分けて保持する節約トラッカー。インストール後ゼロ設定。完全なダッシュボードドキュメント →

何を節約するか

2026-11-01 時点の30日間で、API料金換算の合計は約 $597.72。価格を算定できた分の小計です。 内訳ごとに根拠を区別しています。

• 記録されたアクション: $78.59。 4,945 件のイベントで計測したトークン変化をAPI料金で換算。
• モデルルーティング: $422.88。 導入前の固定モデル構成と、固定した参照モデルの料金表を使った推定。
• 回避された繰り返し読込: $60.69。 観測されたターンから次の実際のコンパクションまでをモデル化し、判明している各ターンの料金で換算。
• その他の推定: $35.56。 ゼロの項目も含め、8種類すべてを方法論に記載。

価格の把握は不完全です。 価格不明の繰り返し読込に関する節約分と差し引き分は除外しており、全体の差し引き金額は算定できません。4つの内訳の合計は総額と一致します。

同じスナップショットのトークンカードは 24,797,356 トークン節約（計測 9,831,072 + 推定 14,966,284）。消費 286,218,848 + 節約 24,797,356 = 311,016,204 の 約 8% です。対象は記録されたトークンと、MCP上限・ヒント経由の読込・出力簡潔化・リーンな再開の推定分（スナップショットは v5.13.63 のルールで取得。チェックポイント復元はその後、推定ティアに移動しました）。モデル化した繰り返し読込とルーティングはこのトークン合計に含まず、ドル小計の対象範囲はより広くなります。

メイン作業 1,644 セッションと委任 3 セッションに基づきます。ダッシュボードはあなた自身の履歴で計算するため、結果は異なります。方法論 →

アクティブ圧縮

コンテキストを能動的に減らす9機能、すべてデフォルトオン、すべて自動、すべてダッシュボードまたはCLIからトグル可能。

内部では、PreToolUseフックがすべてのReadとBash呼び出しをコンテキストに入る前にインターセプトします。ファイルがすでに読まれていれば、diffだけが戻ります。コードファイルの再読込なら、構造スケルトンが完全内容を置き換えます。CLIコマンドなら、出力が圧縮されます。PostToolUseフックは完全なオリジナルをディスクにアーカイブし、圧縮イベントをSQLiteに記録します。何も失われず、すべてが取得可能です。あなたは何もしない。フックがすべて処理します。

ダッシュボードのManageタブ、CLI(measure.py v5 enable|disable <feature>)、または環境変数からトグル。v5動詞は現在の機能を制御するレガシーコマンド名です。

各機能の仕組みを読む →

python3 measure.py compression-stats --days 30

セッションデータベース

Token Optimizerが行うすべては2つのローカルSQLiteデータベースで支えられています。マシンから何も出ません。ゼロのネットワーク呼び出し。

セッション別DB(~/.claude/token-optimizer/snapshots/session-store/<session>.db)はファイル読込、ツール出力、コマンド出力、キャッシュされた内容、コンテキストインテルイベント、アクティビティログ、意思決定ログ、ヒント提供を追跡する8テーブルを持ちます。フックプロセスからの並行読み書きのためのWALモード。セッションあたり50MBの上限。

トレンドDB(~/.claude/token-optimizer/snapshots/trends.db)はセッション履歴、日次集計、スキル/モデル/サブエージェント使用、節約イベント、圧縮イベントを追跡する7テーブルを持ちます。O(log n)の結合のためにセッションUUIDでインデックス。これがダッシュボード、コーチモード、30日トレンド分析を駆動します。

すべての圧縮イベント、すべての節約、すべての品質計測はクエリ可能な1行です。ダッシュボードはこのデータの読み取り専用ビューです。measure.py compression-statsはSQLクエリです。あなたのデータはあなたのものです。

プログレッシブ開示

大きなツール結果(>4KB)はディスクにアーカイブされ、短いプレビューと取得ポインタで置き換えられます。完全な出力は圧縮を生き残ります。モデルが必要な時、コマンドの再実行や失われた出力なしにexpandでオリジナルを引っ張ります。

これは単なる保存ではありません。システムはアーカイブされた結果対再展開された結果の数を追跡するので、折りたたまれたまま残ったネットトークンを見られます。再展開は節約合計から相殺されるので、実際に圧縮されたまま残ったものだけを数えます。

python3 measure.py expand --list          # アーカイブされたツール結果を一覧
python3 measure.py expand <tool-use-id>   # 特定の結果を取得

一部のMCPツールは、メタデータプレビューが要点を損なうような、大きな逐語ペイロードを返すよう文書化されています(ソースフェッチャー、ドキュメント検索器)。それらを許可リストに入れて、完全な結果が置換されずにコンテキストに届くようにしてください(まだアーカイブされるのでexpandは動きます)。完全ツール名にマッチするfnmatch globのカンマ区切りリストを設定:

TOKEN_OPTIMIZER_ARCHIVE_EXEMPT_TOOLS="mcp__context7__*,*github_repository_file"

デフォルトは空です、ツールをオプトインしない限り何も免除されません。

セッション継続性

圧縮も重要ですが、Token Optimizerが行う最も重要なことは、セッションと圧縮をまたいで仕事を自動的に生かしておくことです。

セッションを終える時、Token Optimizerはあなたの状態をSQLiteにチェックポイントします: アクティブタスク、主要な意思決定、変更されたファイル、gitブランチ、最近の読込。新しいセッションを始める時、プロンプトに対してすべての最近のチェックポイントを採点し、最も関連するものをヒントとして浮上させます。ゼロからではなく、コンテキストと共に再開します。

自動的に何が起きるか:

• セッション間ヒント: 関連性採点されたチェックポイントが新しいセッション開始時に浮上。ヒントは前のセッションのタスク、意思決定、ファイル、ブランチを含む。すべてRECOVERED DATAとしてフェンス、決して指示ではない。
• コールドリジュームリーン: 完全なトランスクリプトコストを払わずに古いセッションを再開。Token Optimizerはチェックポイントからリーンなコンテキストを再構築。LLM呼び出しなし、完全トランスクリプトのコールドリジュームなし。SQLiteからのトークン不要の再構築。
• ヒントフォロー推定: 継続性ヒントがファイルパスを浮上しモデルがその後その一つを読むと、Token Optimizerは回避された探索的検索を推定。ヒント→読込のペアは観測されるが、回避された検索の規模は固定推定で、推定ティアに報告され、計測合計には含まれない。

python3 measure.py resume-lean                    # 再開可能なコールドセッションを一覧
python3 measure.py resume-lean <#|session_id> --print  # リーンコンテキストブロックを出力

圧縮の節約はセッションが圧縮を生き残る時にのみ定着します。セッション継続性がそれを実現します。

スマート圧縮

自動圧縮が発火すると、会話の60〜70%が消えます。意思決定、エラー修正シーケンス、エージェント状態、すべて消えます。

Token Optimizerは圧縮前にセッションをチェックポイントし、フック経由でサマリが落としたものを自動的に復元します。またコンテキストインテル要約を注入します: モデルがすでに処理した大きなツール出力のヒューリスティックなサマリ(触れたファイルパス、見たエラー、行数)。圧縮後、モデルはすべてを再読込せずに自分が見たものを知ります。

アクティビティモード検出は最後の10回のツール呼び出しを使ってセッションをリアルタイムで分類します(コード、デバッグ、レビュー、インフラ、一般)。このモードは圧縮ガイダンスに入り、PRESERVE/DROPの優先順位が汎用ヒューリスティックではなく今あなたのしていることに適応します。

意思決定抽出は意思決定ステートメントをツール出力から発生時に捕捉し、セッションDBに保存します。圧縮時に、これらはサマリが逐字保存しなければならないCRITICAL DECISIONSとして注入されます。セッションあたり10の上限。

圧縮の節約はセッションが圧縮を生き残る時にのみ定着します。git statusでトークンを節約しても、次の自動圧縮がそれを実行させた意思決定を消し去れば役に立ちません。

python3 measure.py setup-smart-compact    # チェックポイント + 復元フック

出力トークン: リーン vs 冗長

出力トークンはあなたのセッションで最も高価な部分です。Opusでは入力トークンの5倍のコストで、キャッシュ読み取りではなく生成ごとに課金されます。簡単な質問への冗長な応答は、決して費やす必要のなかったドルを燃やします。

Token Optimizerはリーン出力ナッジでこれを自動的に処理します。コンテキストが25%を超えて埋まると、短いナッジがモデルに深く推論しつつ可視出力は簡潔に保つよう伝えます。充填が唯一のトリガーで、コンテキスト品質は条件ではありません。削減は10-15%と推定され、反事実的には計測されないため、推定ティアで報告され、計測された節約とは別です。

仕組み:

• ナッジはadditionalContextとして注入、既存のプレフィックスを変更しないので、キャッシュは無傷のまま
• コンテキストが埋まりつつある時にのみ発火、十分な余裕がある時ではない
• モデルは依然として問題を考える; より簡潔な可視回答を生成するだけ
• 今日オン/オフのスイッチはない; TOKEN_OPTIMIZER_VERBOSITY_MIN_FILL(デフォルト25)でトリガーポイントを調整

これは9つのアクティブ圧縮機能の一つで、トークンが最も高価な出力側で節約する機能です。

品質スコアリング

品質スコアは2つを追跡します: リソースヘルス(退化の崖にどれだけ近いか)とセッション効率(あなたのトークンが有用な仕事をしているか)。SからFまでの文字等級がトリアージを即時にします。

コンテキストが埋まるにつれ、品質は下がります。MRCRは256Kと1Mのコンテキスト間で93%から76%に下がります。ウィンドウが埋まるにつれAIは計測可能に馬鹿になります。品質スコアはそれがいつ起きるか正確に示します。

ステータスバーは品質が退化するにつれ色が変わります: 緑、黄、オレンジ、赤。品質が75を下回ると、セッション期間が警告として現れます。実行中のサブエージェントはモデルと経過時間と共に表示されます。

python3 measure.py setup-quality-bar      # 一回限りのインストール

スコアリングの仕組みを読む →

python3 measure.py setup-quality-bar --uninstall

コーチモード

> /token-coach

目標を伝えます。正確なトークン節約を伴う、具体的で優先順位付けされた修正を受け取ります。30日間のセッションデータを読み、単一セッションでは示せないものを浮上させます: 品質の下方ドリフト、セッションが長くなること、キャッシュヒット率の低下、セッションあたりコストの上昇。

すべてのインサイトはあなたの実際の数字に基づきます。「短いセッションは68点、長いセッションは60点」は「より短いセッションを検討してください」とは違った響きがあります。コーチモードはまたプロジェクトレベルの最適化機会(決して使わないスキル、熱心にロードするMCPサーバー、キャッシュを壊すCLAUDE.mdパターン)を特定し、将来のセッションがよりリーンに始まるよう直し方を教えます。

コーチモードについて読む →

python3 measure.py keepwarm-enable          # オプトイン(API課金のみ)
python3 measure.py keepwarm-report            # 正味節約、支出、トリップワイヤー状態
python3 measure.py keepwarm-disable           # いつでもオプトアウト

python3 measure.py inject-routing --dry-run   # プレビュー
python3 measure.py inject-routing              # 注入

FAQ

すべてのコマンド

ライセンス

PolyForm Noncommercial 1.0.0 に加え、書面によるスモールビジネス許諾があります。ソース公開。

個人 / ホビー / 研究 / 教育?

どうぞ。完全なソース、ローカルで動作、ライセンス購入不要。ご自身のオープンソースのサイドプロジェクトも含みます。基準は「どこで動かすか」ではなく「誰のための作業か」です。勤務先のための作業は、自宅で行っても勤務先の利用になります。

スモールビジネス(5人未満 かつ 月の売上$20k未満)?

無償の商用ライセンスを書面で付与しています: LICENSE-SMALL-BUSINESS.md。どちらの条件も、チームや利用者数ではなく会社全体(親会社・グループ会社を含む)に適用されます。大きな会社の中の少人数チームには商用ライセンスが必要です。

個人で始めたが、ビジネスになりつつある?

過去の使用は全く問題ありません。条件を満たさなくなってから32日間の猶予があるので、その間に商用ライセンスを手配してください。

より大きな会社 / 商用利用?

Alex Greenshpunまたは[email protected]に連絡してください。条件は妥当で、会社の規模に応じて決まります。

Alex Greenshpunによって作成。