Headroomとは？
Headroom は、AI エージェントが読むものをモデルに届く前に圧縮します。対象はツールの結果、ログ、検索結果、RAG のチャンク、ファイル、会話履歴です。ルーターが内容の種類を判定し、JSON は統計的な圧縮器に、ソースコードは AST を理解する圧縮器に、文章はチームがエージェントのトレースで学習させた小型モデル Kompress-v2-base に回します。元のデータはローカルにキャッシュされ、モデルは必要なときに全文を取り戻せます。
Python と TypeScript のライブラリ（`headroom-ai`）、ポート 8787 のプロキシ、Claude Code、Codex、Copilot、Aider のほか約 15 のエージェントをコマンドひとつで包むラッパー、そして MCP サーバーとして提供されます。追加機能には、エージェント間の共有メモリ、失敗したセッションを調べて `CLAUDE.md` に修正を書き込む `headroom learn`、任意の出力削減があります。Headroom Labs は Apache 2.0 のコードと並行してエンタープライズ版を販売しています。
Headroomは使う価値があるか？
プロジェクトは看板の数字ひとつではなく、再現可能な数字を公開しています。実際の MCP 出力形式から作ったシード固定の 4 シナリオで、入力トークンはコード検索で 21%、コードベースの探索で 42%、issue の仕分けで 30%、障害のデバッグで 57% 減り、繰り返しの多い JSON 配列やログ行では 90% を超えました。文章はほとんど縮みません。10,000 トークンの JSON 結果の圧縮にかかる時間は中央値で 0.21 ms で、レイテンシーにはほぼ影響せず、小規模な精度テスト（各 100 問）でもスコアは誤差の範囲に収まりました。
独立した利用者の報告も同じ傾向ですが、見え方はそれほど好意的ではありません。russ.cloud のブログは数日間、対話型の混在したコーディングで使い、190 万（1.9 million）トークンで 20.7% の削減を確認しました。ただしダッシュボード上の金額の節約 は大半が提供元自身のプロンプトキャッシュ割引（$47.36）で、圧縮によるものは $9.23 にとどまり、プロキシのオーバーヘッドはリクエストあたり 304 ms でした。筆者は圧縮器より `headroom learn` のほうが役に立ったとしています。別のレビューはトークン数が提供元の記録と一致することを確認しつつ、請求額が必ず下がるかには疑問を呈しました。
利用は話題先行ではなく実体があります。直近 1 か月の PyPI ダウンロードは 466,346 回、npm は 125,494 回で、スターは 79,667、コミットは 3,730 件です。リリースは頻繁で、v0.44.0 は 2026年11月10日に出ました。
注意点：匿名のテレメトリビーコンが既定で有効です（圧縮率、提供元とモデルの ID、OS。プロンプトやコードは含まない）。またプロキシはすべての API キーとリクエストの経路上にあります。アドバイザリーは 2 件公開されており、8月の深刻度高のクロスサイト WebSocket ハイジャックと、2026年11月9日の MCP サーバーの読み取りツールにおける任意ファイル読み取りで、どちらも修正済みです。
結論：大きな JSON、ログ、検索結果を読むエージェントなら元が取れます。普通のチャット型のコーディングなら、RTK のコマンドフィルターがより少ない仕組みで同じ仕事の多くをこなします。
真価を発揮する場面
Claude Code で障害をデバッグする SRE チーム
ログのダンプやメトリクスの JSON でコンテキストウィンドウが埋まるのを防ぎたい
`headroom wrap claude` でセッション用のローカルプロキシが起動します。プロジェクトの障害シナリオでは 55,957 トークンが 24,340 トークンになりました。モデルは必要なら取得ツールで元の行を呼び出せます。
Python で RAG API を運用するバックエンド開発者
取得したチャンクやデータベースの行が長く並ぶ入力のコストを下げたい
提供元を呼ぶ前に `compress(messages, model=...)` を呼びます。プロセス内で動き、キーもネットワークも不要です。レビュアーの勧めどおり、まず自分のトラフィックで `headroom evals` を実行し、回答が変わらないことを確かめてください。
エージェントの同じ間違いを何度も直しているエンジニア
繰り返す失敗を常設の指示に変えたい
`headroom learn` が過去のセッションを読み、`CLAUDE.local.md` か `AGENTS.md` に修正を書き込みます。独立したテスターはここが最も役立つ部分だと評価しました。実行以外の費用はかかりません。
導入前に確認すること
- 導入
- `uv tool install --python 3.13 "headroom-ai[all]"` のあと `headroom wrap claude`（または codex、copilot、aider など）を実行します。`headroom doctor` でルーティングを確認できます。ライブラリは `pip install headroom-ai` か `npm install headroom-ai` です。
- 連携
- Claude Code、Codex、Copilot CLI と VS Code、Cursor（手動設定）、Aider、OpenCode、Cline、Continue、Goose、OpenHands など。Anthropic、OpenAI、Vercel AI の SDK 用ラッパー、LiteLLM、LangChain、Agno、Strands、MCP サーバーにも対応します。
- データとプライバシー
- 圧縮はローカルで行われ、元データは手元のマシンにキャッシュされます。匿名ビーコンが既定で圧縮率、カウンター、提供元とモデルの ID、OS、アーキテクチャを送信し、`HEADROOM_TELEMETRY=off` か `DO_NOT_TRACK=1` で止められます。
- 大規模利用時のコスト
- ライセンス費用はありません。節約は繰り返しの多さに比例し、繰り返しの多い JSON やログでは 90% 以上、独立したテストの混在したコーディングセッションでは約 20% でした。金額上の節約の多くはすでにプロンプトキャッシュで得られている場合があります。
- 制限
- 文章や短いプロンプトはほとんど圧縮されません。CLI には Python が必要です。第三者の OpenAI 互換提供元では上流 URL を明示しないとキーが OpenAI に送られます。未解決の issue は 302 件です。
良い点
- シナリオごとの正直な数字を伴う再現可能なベンチマーク
- 圧縮はローカルで行われ、必要に応じて元に戻せる
- ライブラリ、プロキシ、エージェントラッパー、MCP サーバーがひとつのパッケージに
- 実際の利用が多く、PyPI で月 466,346 回ダウンロード
気になる点
- 文章や対話型コーディングでは節約が小さい
- テレメトリビーコンが既定で有効
- プロキシがすべてのキーとリクエストを扱い、8月以降アドバイザリーが 2 件
- 圧縮以外にも機能が広がりすぎている
おすすめの人
エージェントや RAG パイプラインが大量の JSON、ログ、検索結果をモデルに送り、入力トークン単位で支払っているチーム向けです。
Headroomの代替
Headroom：よくある質問
- Headroomは使う価値があるか？
- Headroom はトークン節約ツールのなかで最も厳密であり、その自前の数字は、節約幅がほぼツール出力の繰り返しの多さだけで決まることを示しています。 評価は5点満点中3.9点です。
- Headroomの料金は？
- 無料のオープンソース（Apache 2.0）です。チーム向けの Headroom Enterprise は別売りで、料金は公開されていません。
- Headroomの欠点は？
- 文章や対話型コーディングでは節約が小さい; テレメトリビーコンが既定で有効; プロキシがすべてのキーとリクエストを扱い、8月以降アドバイザリーが 2 件; 圧縮以外にも機能が広がりすぎている.
- Headroomは誰に向いているか？
- エージェントや RAG パイプラインが大量の JSON、ログ、検索結果をモデルに送り、入力トークン単位で支払っているチーム向けです。
- チームや本番環境でHeadroomを使うと費用はいくらか？
- ライセンス費用はありません。節約は繰り返しの多さに比例し、繰り返しの多い JSON やログでは 90% 以上、独立したテストの混在したコーディングセッションでは約 20% でした。金額上の節約の多くはすでにプロンプトキャッシュで得られている場合があります。
- Headroomは企業データを扱っても安全か？
- 圧縮はローカルで行われ、元データは手元のマシンにキャッシュされます。匿名ビーコンが既定で圧縮率、カウンター、提供元とモデルの ID、OS、アーキテクチャを送信し、`HEADROOM_TELEMETRY=off` か `DO_NOT_TRACK=1` で止められます。
- Headroomの代わりになるものは？
- 当サイトでレビューした中で最も近い代替はrtk (Rust Token Killer), Caveman 、 OmniRouteです。
回答確認日：2026年11月14日