caveman — コーディングエージェントのトークン消費を抑えるGo製ツール
JuliusBrussee/caveman
★ 120,080 ・ Go ・ Apache-2.0
概要
JuliusBrussee/caveman は、Claude Code、Codex、Gemini CLI などのコーディングエージェントにおいて、トークンの消費量と利用コストを抑えるためのプロキシ兼拡張スキルです。
LLM(大規模言語モデル)を活用した開発支援ツールは利便性が高い一方で、冗長な説明文や長大なログの読み込みによって、API利用料金の増加やコンテキストウィンドウの圧迫を招きやすい課題があります。本ツールは、航空機の整備マニュアルで採用されている簡易英語の仕様を参考に、コードやパスなどの重要情報を一切改変することなく、AIの解説文やログなどの入出力を切り詰めるアプローチをとっています。
日常的にターミナルベースのコーディングエージェントを利用しており、APIコストの抑制やレスポンスの効率化を図りたい開発者に向いているプロジェクトです。
主な特徴
READMEではバージョン4.0以降のコア機能として「6つの要素(Six rocks)」が紹介されています。これらは個別に有効・無効を切り替えることが可能です。
- Say less(回答文の圧縮): エージェントの回答から挨拶や不要な前置きを省き、要点のみを簡潔に出力させます。コードブロックやコマンド、ファイルパスなどは一字一句そのまま維持されます。
- Read less(入力データの圧縮): 実行ログ、JSON、CSV、テストの出力結果などをモデルに読み込ませる前に前処理で圧縮し、入力トークン数を削減します。
- Auto(モデル・推論の自動最適化): 要求されたタスクの難易度に応じて、使用するモデルや推論の強度(effort)を自動的に選択し、精度を保ちながらコストを抑えます。
- Blocks(コード実行スクリプトの再利用): エージェントが一度作成したテスト用スクリプトなどを保持して再実行することで、同一タスクにおける不要なトークン生成を防ぎます。
- Waste fixes(キャッシュ保持と無駄の排除): トークン消費の無駄を特定して修正します。開発者が作業を一時停止している間もプロンプトキャッシュを維持する機能などが含まれます。
- Browse(Web閲覧データの圧縮): エージェントがWebページを参照する際、取得したページコンテンツを圧縮して入力トークンを削減します。
使い方
セットアップには複数の方法が用意されています。ローカル環境でプロキシを含めて一括設定する方法と、回答短縮のプロンプトスキルのみを導入する方法があります。
CLIによる一括セットアップ
環境にインストール済みのエージェントを自動検出し、設定を適用するCLIコマンドが提供されています(Node.js 22.13以上が必要です)。
npx @caveman-ai/cli@latest
実行すると検出されたエージェントや変更内容が表示され、Enterキーを押すことで設定が反映されます。設定後は、通常の claude コマンドや対応エージェントが自動的に本ツールの設定下で動作します。
状態の確認や個別機能の停止は以下のコマンドで行えます。
# 有効な機能の確認
caveman status
# 特定機能(例: Webブラウズ圧縮)の無効化
caveman off browse
スキル単体での利用
プロキシ機能を使用せず、回答を短くするプロンプト制御スキルのみを導入したい場合は、グローバルスキルとして追加できます。
npx skills add JuliusBrussee/caveman -g
エージェント内で自動開始されない場合は /caveman(Codexでは $caveman)と入力します。元の会話スタイルに戻す際は stop caveman と指示します。
また、Claude Codeのプラグインとしても追加可能です。
claude plugin marketplace add JuliusBrussee/caveman && claude plugin install caveman@caveman
技術的なポイント
READMEに記載されている設計思想と実装のポイントは以下の通りです。
制御言語仕様(ASD-STE100)を応用したプロンプティング
単に「短く答えろ」と指示するのではなく、航空機整備マニュアル向けの制御英語規格である「ASD-STE100」をベースにした構文規則をモデルに与えています。「結論を先に述べる」「1文につき1つのアイデア」「20語以内」といった明確な制約を課すことで、文法を崩壊させずに情報密度を高めています。
また、指示内容には「否定表現(not, never, no, only)は削らない」「数値や単位は正確に残す」「コードやエラーメッセージ、パスは文字単位で完全一致させる」といった例外規則が厳密に定められており、コードの正確性を損なわない配慮がなされています。重大なセキュリティ警告や不可逆な操作を行う場面では、通常の自然言語による警告文に自動復帰する仕組みも組み込まれています。
ユーザープロンプトを改変しない方針
Adobe Researchが発表した関連研究(CAVEWOMAN論文)の知見を引用し、ユーザー側の入力プロンプトを短縮・圧縮すると回答精度が低下することが示されているため、本ツールはユーザーが入力したプロンプト自体には手を加えない設計になっています。
入力データの前処理とキャッシュ維持
JetBrains社によるA/Bテストの結果として、エージェントセッションの大半はツール実行やコード読み込みなどの入力が占めていることが示されています。これを受け、出力の短縮(Say less)だけでなく、ログや構造化データの事前圧縮(Read less)や、プロンプトキャッシュを維持する機構(Waste fixes)を組み合わせてトークン削減を図っています。
注意点
- ライセンス: 本リポジトリのコードは Apache-2.0 ライセンスの下で公開されています。
- 動作環境: CLIのセットアップには Node.js 22.13 以降が必要です。対応OSとして Mac、Linux、Windows が挙げられています。
- 料金形態による向き不向き: README内のドキュメントでも言及されている通り、トークン従量課金ではなくリクエスト単位課金や固定課金(GitHub Copilotなど)を利用している環境では、出力トークンを短縮してもコスト面でのメリットは得られません。
- 初期入力トークンのコスト: 短縮ルールをプロンプトとして適用するにあたり、約1,160トークンの入力が消費されます。極端にやり取りの往復が少ない短いタスクでは、削減効果が相殺される可能性があります。
- アカウント要件: 基本機能はローカルで動作しますが、「Auto」機能を利用する場合のみ無料のアカウント登録が必要とされています。
まとめ
caveman は、コーディングエージェントの出力を要点だけに絞り込み、入力ログの圧縮やキャッシュ保持を組み合わせることでトークン消費を抑える実用的なツールです。外部研究機関の検証データを取り入れながら、コードの正確性を犠牲にしない明確なルール設計が施されています。日々の開発でエージェントツールの利用頻度が高く、コスト効率を改善したい方は試してみてはいかがでしょうか。





