caveman（JuliusBrussee/caveman）：Claude Codeの出力と読み込みを圧縮してトークン消費を抑えるスキル・プロキシ

caveman（JuliusBrussee/caveman）は、Claude Codeなどのコーディングエージェントに「余計な前置きを省いた短い文体」で回答させるためのルールファイル（スキル）です。あわせて、エージェントが読み込むログやテスト出力を圧縮するローカルプロキシ、自作アプリ向けのミドルウェアも同じリポジトリに含まれています。AI利用料が従量課金のため、トークン消費を減らしたい個人事業主や、長い作業セッションで出力が冗長に感じる方が主な対象です。

READMEによると、コード、コマンド、ファイルパス、エラーメッセージの原文はそのまま残し、周囲の説明文だけを短くします。セキュリティ警告や確認メッセージは通常の文章に戻る仕様です。READMEの例では、Reactの再描画に関する回答が69トークンから19トークンに縮んでいます。

3つの構成要素
導入方法
注意点
まとめ

3つの構成要素

READMEでは、大きさの異なる3つの部品が用意されています。それぞれ「何を減らすか」が違います。

スキル：エージェントが「話す」量を減らすルールファイル。MITライセンスで、Claude Code、Codex、Gemini CLI、Cursorなど30以上のエージェントに対応するとされています。
プロキシ（CLI）：エージェントが「読む」量を減らす。ログ、テスト出力、JSON、diffなどを圧縮してからAIプロバイダーに送ります。圧縮前の原文はローカルのSQLiteに保存され、エージェントが必要に応じて取り戻せる仕組みです。
ミドルウェア：自作のエージェントに組み込むライブラリ。TypeScript版とPython版があり、READMEでは現時点でalpha版とされています。

スキルの強度は切り替えられます。/caveman liteは丁寧さを残した簡潔な文体、/caveman ultraはさらに切り詰めた文体です。ほかに、1行のコミットメッセージを作る/caveman-commit、指摘を1行ずつ出す/caveman-review、CLAUDE.mdなどの説明文を圧縮する/caveman-compressがあります。通常の文体に戻すときは「stop caveman」と伝えます。

導入方法

最小構成はスキルだけの導入です。READMEはアカウントもAPIキーも不要としています。

npx skills add JuliusBrussee/caveman -g

エージェントが自動で反応しない場合は、/cavemanと入力して起動します。Claude Codeにプラグインとして入れる場合は、次の2コマンドが案内されています。

claude plugin marketplace add JuliusBrussee/caveman
claude plugin install caveman@caveman

プロキシを使う場合は、Node.jsが必要です（フルインストーラーはNode.js 22.13以上とされています）。CLIを入れて初期設定を行い、対象のエージェントをラップして起動します。

npm install -g @caveman-ai/cli && caveman setup --install
caveman claude

プロキシ導入後の確認用コマンドも用意されています。caveman learnは、ディスク上に残るエージェントの履歴を読み、トークンを多く使っている箇所をローカルで順位付けします。caveman trial -- claudeは、caveman有りと無しで同じ作業を実行して差を比較します。削除する場合は、次のコマンドです。

npx -y github:JuliusBrussee/caveman -- --uninstall

注意点

テレメトリー：READMEによると、CLI（プロキシ側）は匿名の利用統計をデフォルトで送信します。内容は実行したコマンドと、圧縮したトークン数です。プロンプト、コード、ファイルパスは送らないと記載されています。止めるにはcaveman telemetry offを実行するか、環境変数DO_NOT_TRACK=1を設定します。スキルとフックは送信しないとされています。
通信経路：プロキシはローカルで動作し、エージェントとAIプロバイダーの間に入ります。READMEでは、cavemanのサーバーは経路に入らず、Claude Pro/Maxのログイン情報はAnthropicにそのまま渡されると説明されています。ただし、認証情報が通る経路にツールが入る点は、導入前にSECURITY.mdで確認する必要があります。
管理モード：READMEには、managed modeではリポジトリ名（owner/name）と現在のブランチ名をx-cave-tagsとして送る、との記載があります。ブランチ名に個人名が入る場合は注意が必要です。
ライセンス：スキルはMIT、プロキシなどのエンジン部分はBSL-1.1（ソース公開型で、OSI定義のオープンソースではない）です。自社の通信での利用は無料で、第三者へのホスティングには商用ライセンスが必要とされています。
導入シェルスクリプト：フルインストーラーはcurlの出力をそのままbashに渡す方式です。実行前にスクリプトの中身を読むことができます。
効果が出ない場合：READMEは、リクエスト単位の課金（GitHub Copilotのプレミアムリクエストなど）や、説明文がほとんどないコード生成中心の作業では向かないと明記しています。ルールが1回の呼び出しごとに約1,000トークンの入力を追加するため、短い質問では逆に増える場合があります。

効果の数字は、READMEで第三者の測定として次のように紹介されています。JetBrainsによる86件の実コーディング作業の比較では、スキルのみで出力トークンが8.5%減、コストは約10%減、品質に検出可能な差はなかったとされています。Adobe Researchの論文は、チャット形式の回答でコストが1.4〜2.4倍改善するとしています。READMEは、エージェントを使った作業では出力側の削減幅は限定的で、読み込み側の削減がプロキシの目的だと説明しています。これらは作者側の引用であり、当サイトで検証した数字ではありません。