2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

LLMのトークンを60〜90%削るCLIプロキシ「bdo」を機能強化してみた

2
Last updated at Posted at 2026-07-06

はじめに

Claude Code や各種コーディングエージェントを使っていると、cat・grep・git diff・cargo test といったコマンドの出力がまるごと LLM のコンテキストに流し込まれます。
この生出力はノイズが多く、コンテキストを圧迫し、トークン課金を膨らませ、肝心の情報を薄めます。

そこで作ったのが bdo(Bushido)です。
コマンドの出力を LLM に渡す前に圧縮・要約する透過プロキシで、単一の Rust バイナリ、100 以上のコマンド対応、オーバーヘッド 10ms 未満。実測で 60〜90% のトークン削減を狙えます。

上流の rtk (Rust Token Killer) を武士道テーマでフォーク・拡張したものです。コマンド名は bdo、npm パッケージは bdo-cli。

インストール

# npm(bdo コマンドが入ります)
npm install -g bdo-cli

# または Homebrew
brew install tedorigawa001/tap/bushido

動作確認:

bdo --version
bdo gain          # トークン削減の集計

Screenshot 2026-07-07 at 8.04.46.png

何が起きるのか — before / after

bdo は「native コマンドの薄いラッパ」として振る舞います。
出力から余計な装飾・空白・重複・成功ノイズを削り、エージェントが必要とする信号だけを残します。

# 従来: 生の git status は装飾と空行だらけ
$ git status
On branch main
Your branch is up to date with 'origin/main'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   src/main.rs
...

# bdo: 同じ情報を最小トークンで
$ bdo git status
 M src/main.rs

cat や grep、cargo test も同様です。テスト系は失敗だけを残すので、2.5 万トークンの実行ログが数百トークンになります。

効果(30分の Claude Code セッション想定)

操作 回数 標準 bdo 削減
ls / tree 10x 2,000 400 -80%
cat / read 20x 40,000 12,000 -70%
grep / rg 8x 16,000 3,200 -80%
git status 10x 3,000 600 -80%
git diff 5x 10,000 2,500 -75%
cargo test / npm test 5x 25,000 2,500 -90%
pytest / go test 7x 14,000 1,400 -90%
合計 約118,000 約23,900 -80%

中規模の TypeScript / Rust プロジェクトでの概算。実際の削減率はプロジェクト規模で変わります。

削減量は bdo gain でいつでも集計できます(コマンド別・エージェント別の内訳も出ます)。

本命の使い方 — Claude Code フック連携

一番の価値は、エージェントが自分で bdo を打つ必要がない点です。
bdo init で Claude Code の PreToolUse フックを仕込むと、エージェントが投げた git status が自動で bdo git status に書き換えられます。

bdo init -g --auto-patch     # グローバルにフック設置(要 Claude Code 再起動)

以降はエージェントが普段どおりコマンドを打つだけで、透過的に 0 トークンのオーバーヘッドで削減が効きます。Gemini / Antigravity / Cursor / Copilot 向けの連携も用意しています。

bdo ならではのコマンド

単なる圧縮だけでなく、「LLM に読ませる」ことに特化した独自コマンドがあります。

bdo read -l outline / bdo map — コードの地図

ファイルのシグネチャだけを残して本体 { … } を畳みます。bdo map はディレクトリ全体のトップレベル宣言だけを出すので、src/core が 74k → 3.5k トークン(約95%減)に。API 面を把握したいときに刺さります。

Screenshot 2026-07-07 at 8.31.59.png

bdo review / bdo stale — 変更レビューと残骸監査

  • bdo review … 変更セットの要約(変更ファイル・紛れ込んだ生成物・stale マーカー・走らせるべきテスト)
  • bdo stale … tracked tree 全体の残骸監査。見つかれば非ゼロ終了で CI ゲートに使える

機能強化(NEW) bdo ci — プリマージ・ゲート(1コマンド)

上記を束ねた統合ゲート。
review(変更サマリ)+ stale(残骸ゲート)+ test --changed(変更セットのテスト)を実行し、単一の exit code を返します。

$ bdo ci
━━━ bdo ci (1/3) — change summary ━━━
...
━━━ bdo ci (2/3) — residue audit ━━━
...
━━━ bdo ci (3/3) — changed tests ━━━
...
━━━ bdo ci: PASS ━━━
  review  shown (informational)
  stale   ok
  tests   ok

軽い検査を先に・遅いテストを最後に走らせつつ、全ステージを実行して1パスで全ブロッカーを提示します。

Screenshot 2026-07-07 at 8.23.06.png

設計思想 — 「正しさ > 圧縮率」

圧縮ツールで一番怖いのは「削りすぎて情報を失う」ことです。
bdo はフェイルセーフを最優先にしています。

  • 各フィルタは catch_unwind で保護され、敵対的な出力で panic しても生出力にフォールバックする(情報を失わない)
  • exit code は必ず保持する(bdo cargo test が失敗すれば非ゼロで返る)
  • 圧縮しても情報が壊れないコマンドだけをフィルタ対象にする

「LLM がその出力を信頼して使える」ことを保証する方向に振っているので、コードや diff のような 1 文字が致命的な対象でも安心して噛ませられます。

なお、巷で流行っている画像に圧縮する手法は圧縮効果は絶大ですが、わずかながらにデータの完全性が落ちるため、採用してません。コード・数式・固有名詞・厳密な数値など「1文字の誤りが致命的」になるため。
(画像は密度でトークンを稼ぐ仕組み(1タイルに複数文字を畳み込める)のようですが、モデル側の課金方式に依存し、将来的にAI会社に対策されるリスクもあるため)

まとめ

  • bdo はコマンド出力を LLM に渡す前に圧縮する透過プロキシ(単一 Rust バイナリ)
  • npm install -g bdo-cli / brew install tedorigawa001/tap/bushido
  • bdo init で Claude Code に仕込めば、エージェントが何も変えなくても 60〜90% 削減
  • bdo map / review / stale / ci など「LLM に読ませる」ための独自コマンドも
  • 設計は「正しさ > 圧縮率」。壊れたら生出力へフォールバック

トークン課金とコンテキスト圧迫に悩んでいる方は、まず bdo gain で自分のセッションがどれだけ削れるか試してみてください。

2
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?