Caveman Claude Codeとは?トークン65%削減の設定と使い方
Claude Code を使い込むほど「説明が丁寧すぎてトークンがもったいない」と感じる場面は増えます。Caveman は、その冗長な出力を「原始人の話し方」まで削ぎ落として消費トークンを大幅に減らすオープンソースのスキルです。本記事では、Caveman の仕組み、インストール手順、6 段階の圧縮モード、効果測定コマンド、そして導入前に知っておくべきデメリットを整理します。
Caveman は Claude Code の回答から前置きや冗長な説明を削り、出力トークンを平均 65% 削減する MIT ライセンスの無料スキル。curl 一発で導入でき、lite〜wenyan の強度切替と /caveman-stats による節約額の確認までできる。
Contents (7)
Caveman とは — 「原始人語」で答えさせるトークン節約スキル
Caveman は、開発者 Julius Brussee 氏が公開している Claude Code 向けスキルです。GitHub リポジトリの説明文「why use many token when few token do trick(多くのトークンを使う必要ない、少しで足りる)」が示すとおり、AI の回答を原始人のような短い断片文に変換し、消費トークンを削減します。
具体的には、「Great question!(いい質問ですね!)」のような社交辞令、繰り返しの前置き、3 語で済む内容を 4 段落かけて説明する冗長さを削除します。一方でコード・コマンド・エラーメッセージには手を加えず、技術的な正確さは維持する設計です。
公式リポジトリ(github.com/JuliusBrussee/caveman)によると、10 種類のタスクでの平均で出力トークンを 65% 削減(削減幅は 22〜87%)。React の再レンダリング説明では 87%、認証バグ修正では 83% の削減が報告されています。「同じ修正。語数は 3 分の 1。技術的には何も失っていない」というのが作者の主張です。
インストール方法 — curl 一発、約 30 秒で完了
導入は非常にシンプルで、Node.js 18 以上があれば約 30 秒で完了します。手順は次のとおりです。
- ターミナルを開く(macOS / Linux / WSL / Git Bash の場合)
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bashを実行する- Windows PowerShell 5.1 以上の場合は
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 | iexを実行する - Claude Code を起動する(セッション初回から自動で有効になる)
インストーラーは再実行しても安全で、アンインストールは同じコマンドに --uninstall フラグを付けるだけです。テレメトリ送信・アカウント登録・外部バックエンドとの通信は一切なく、スキル本体はプロンプト、フックはローカルスクリプトとして動作します。ライセンスは MIT です。
なお、Caveman は Claude Code 専用ではなく、Codex・Gemini CLI・Cursor・Windsurf・Cline・GitHub Copilot など 30 以上のコーディングエージェントに対応しています(公式サイト: getcaveman.dev)。
6 段階の強度レベル — lite から古典中国語モードまで
Caveman は圧縮の強度を段階的に選べます。セッション中に /caveman [レベル名] コマンドで切り替え可能です。
- normal — 圧縮なしの通常エージェント
- lite — ヘッジ表現(婉曲な言い回し)の削除のみ
- full — 標準の原始人モード(デフォルト)
- ultra — 重度の省略・断片文
- wenyan — 古典中国語(文言文)のパターンを使う最大圧縮モード
面白いのは、セキュリティ警告や破壊的操作の説明など「明瞭さが簡潔さより重要な場面」では、Caveman が一時的に通常の話し方へ自動復帰する点です。トークン節約のために危険な操作の警告まで削られる、という事故を防ぐ配慮がされています。
効果測定と便利コマンド — /caveman-stats で節約額を可視化
導入後の効果は感覚ではなくコマンドで確認できます。主要コマンドは以下のとおりです。
/caveman-stats— セッションログからトークン使用量・削減量・USD 換算の節約額を計算する/caveman-compress <file>— CLAUDE.md などのメモリファイルを圧縮し、以降の全セッションで入力トークンを約 46% 削減する/caveman-commit— 50 字以内の規約準拠コミットメッセージを生成する/caveman-review— 1 行の PR レビューコメントを生成する
特に /caveman-compress は出力ではなく入力側の恒常的な節約になるため、CLAUDE.md が肥大化しているプロジェクトでは単体でも導入価値があります。
注意点 — 削減されるのは「出力」トークンだけ
導入前に必ず理解しておくべき制約が 2 つあります。
第一に、Caveman が削減するのは出力トークンのみです。入力トークンと思考(reasoning)トークンには影響しません。しかもスキル自体が 1 ターンあたり約 1,000〜1,500 の入力トークンを追加するため、セッション全体で見た実際の節約率は「出力 65% 削減」より小さくなります。もともと回答が簡潔なタスクでは、差し引きでマイナスになる可能性すら README に明記されています。
第二に、学習フェーズのユーザーには不向きです。Medium の検証記事(bobde-yagyesh.medium.com)でも約 50% のコスト削減が確認された一方、「Caveman が削るトークンは、学習中の人にとってはまさに必要だったトークン」と指摘されています。Claude の説明がノイズに感じられるレベルに達してから有効化するのが正しい使い方です。
どんな人に向いているか — 判断基準
以上を踏まえると、Caveman の向き・不向きは次のように整理できます。
| 状況 | 判断 |
|---|---|
| Claude Code を長時間使い、説明文を読み飛ばしている | 導入価値が高い |
| Max プランの利用上限やレート制限に頻繁に当たる | 導入価値が高い |
| CLAUDE.md が肥大化している | /caveman-compress だけでも有効 |
| Claude の説明を読んで学習している段階 | 導入は時期尚早 |
| 回答がもともと短いタスクが中心 | ネットで損をする可能性あり |
トークン節約の手段としては、モデルの使い分け(Haiku へ切替)やコンテキスト管理(/compact の活用)もありますが、Caveman は「回答の質を保ったまま語数だけ減らす」という独自のアプローチであり、既存の節約術と併用できます。
まとめ — 上級者の「読む時間」と「トークン」を同時に節約
Caveman は、Claude Code の冗長な出力を原始人語に圧縮して出力トークンを平均 65% 削減する MIT ライセンスの無料スキルです。curl 一発で導入でき、lite から wenyan まで 6 段階の強度を選べて、/caveman-stats で節約額を数値で確認できます。ただし削減対象は出力トークンのみで、スキル自体が入力トークンを 1〜1.5k 追加する点、学習段階のユーザーには説明の削減がむしろ害になる点は導入前に押さえておきましょう。「Claude の説明がノイズに感じ始めた」人にとっては、読む時間とトークンの両方を節約できる実用的なツールです。
出典: