HN 日本語サマリー

← 一覧へ戻る
プログラミング

Tokendoctor – Claude Codeを最大38%オフで利用可能に

Tokendoctor – the same Claude Code for up to 38% less (github.com)

20 pointsby rsaryev19978 コメント

要約

Tokendoctorは、Claude CodeのAI機能利用におけるコストと効率を最適化するプラグインです。セッションのトークン使用量を分析し、最大38%のコスト削減やコンテキストウィンドウの効率化を実現します。要約に代わる「スライド」機能により、会話履歴をそのまま保持しつつ、トークン消費を抑えることも可能です。

全文翻訳

tokendoctor

[画像: tokendoctor]

同じClaude Codeを最大38%オフで

Claude Codeの利用でどれだけ過払いしているかを確認し、修正し、いつでも元に戻せます。お使いのマシンで実行されます。

ウェブサイト · インストール · 変更履歴

[画像: 実際のClaude Codeセッションでのtokendoctor: /tokendoctor:sessions、その後の日次トレンド]

著者の6週間の実利用で測定
API定価でのリクエストあたりのメインスレッドコスト(400Kウィンドウとサブエージェント向けSonnet導入前と導入後の1週間比較)
リクエストあたりのコンテキスト
400Kウィンドウで同じセッションをリプレイ(ウィンドウのみ変更)
同日の作業を要約と比較(ベンチマーク)
ベンチマークでの1週間の作業(27ステップ)、出荷時のClaude Codeと適用された修正の比較

特効薬はありません。 セッションが400Kトークンをめったに超えない場合、ウィンドウの変更はあなたにとって何も意味しません。作業完了直前に届く要約は、節約できる額よりも多くかかることがあります。モデル、労力、作業すべてが数値を動かします。そのため、tokendoctorはまずあなたの数値を表示します。/tokendoctor:sessions は、何も変更する前に、より小さいウィンドウであなた自身のセッションをリプレイします。

確認 /tokendoctor:sessions は、より小さいウィンドウであなた自身のセッションをリプレイし、それぞれがどれだけ節約できたか、そしてトークンがどこに行ったかを示します。修正 /tokendoctor:optimize は、ドキュメントに対して38のチェックを実行し、あなたが選んだ変更を適用します。各変更は最初に差分として表示されます。スライド /tokendoctor slide on: Claude Codeが要約するところに、古いツールの出力が代わりに表示されます。一時停止なしで、会話は一語一句そのまま続きます。元に戻す /tokendoctor undo は、tokendoctorが行ったすべての変更をリストし、いつでも元に戻せます。モデル呼び出しもトークンも不要です。

[画像: 著者のtokendoctorダッシュボード:コストの57%はClaudeが会話を再読したことによるもの]
/tokendoctor:dashboard: 日別、モデル別、労力別、メインスレッド別、各サブエージェント別、コンテキストサイズ別、プロジェクト別のすべてのトークンを表示します。ローカルファイル1つで、これは著者のものです。

インストール

claude plugin marketplace add localixai/tokendoctor
claude plugin install tokendoctor@tokendoctor

claude plugin marketplace update tokendoctor および claude plugin update tokendoctor@tokendoctor で更新し、Claude Codeを再起動してください。インストールせずに試すには、リポジトリをクローンして claude --plugin-dir /path/to/tokendoctor を実行してください。

使用方法

コマンド
/tokendoctor:sessions [days]
/tokendoctor:audit
/tokendoctor:dashboard [days]
/tokendoctor:optimize [focus]
/tokendoctor [name] [value]
/tokendoctor fix <finding-id>
/tokendoctor undo [n]

/tokendoctor への応答はプラグイン自体が行うため、コストはかかりません。タブ補完で名前(window、slide、cache、effort、model、subagents、および残りのための/tokendoctor all)とその値が補完されます。/tokendoctor window 400k は入力通りに適用され、/tokendoctor window reset はデフォルトに戻ります。--project または --local はユーザー設定ではなく、そこに書き込みます。モデル名はエイリアス(opus、sonnet、haiku)またはclaude-… IDである必要があります。

optimize は 調整可能なリスト 上の設定のみを変更し、/config 行も対象です。すべての変更はダイアログを開き、それを表示し、適用でのみ実行されます。誰も尋ねる人がいない場合(-p実行時など)、何も変更されません。フックとパーミッションはリストに含まれません。

シェルから

プラグインの bin/ ディレクトリは、有効になっている間、BashツールのPATHに含まれます。

tokendoctor-audit [--project <dir>] [--json]
tokendoctor-sessions [--days <n>] [--project <dir>] [--by day|week] [--json]
tokendoctor-set --list | <key> <value>|--unset [--scope user|project|local] [--write]
tokendoctor-apply <finding-id> [--scope user|project|local] [--project <dir>] [--write]
tokendoctor-undo [--json] | <n> [--write]
tokendoctor-replay [--days <n>] [--window 200k,400k] [--json]   # より小さいウィンドウでどれだけ節約できたか
tokendoctor-org-install [--write] [--uninstall]                # チーム/エンタープライズログイン下でのスライド(下記参照)
tokendoctor-selfcheck [--log <file>] [--json]                  # 実際にロードされたもの、デバッグログから(小さなHaikuリクエスト1つ、またはあなたが持っているログ)

インストールを維持するコスト

スキルはユーザーによってのみ呼び出されます(disable-model-invocation)。claude plugin details tokendoctor@tokendoctor は、5つのスキルすべてに対して、常にオンのコストとして約235トークンと推定しています。プラグインにはMCPサーバーはありません。そのフックモジュールは、最適化ツール(mcp__tokendoctor__*)をToolSearchの後ろに追加するため、/tokendoctor:optimize がロードするまで名前のみがリストされます。/tokendoctor とスライドはフックモジュールでも実行され、モデル呼び出しがないため、トークンは追加されません。その1つのコマンドフックは、セッション開始時にバックグラウンドでtokendoctor-recordを実行します。フックは非同期であり、何も出力しないため、トークンは追加されません。完了した日の合計を~/.claude/tokendoctor/history.jsonlに追記するため、トレンドはClaude Codeのトランスクリプトクリーンアップ後も持続します。

38の設定チェック

エラーは設定が間違っているか無視されていることを示し、警告は実際のお金がかかる可能性が高いことを示し、情報は確認する価値があることを示します。Claude Codeのリリースに依存するルールは、古いバージョンではスキップされます。

検出内容
settings-unreadable
compact-threshold-undocumented
compact-env-bare-number
compact-window-unset
compact-window-small
prompt-caching-disabled
subagent-model-force
effort-max-in-settings
advisor-inactive
fast-mode-enabled
auto-compact-off
tool-search-off
explore-default-model
subagent-model-unset
main-model-expensive
agents-inherit-model
heavy-dirs-not-denied
large-lockfile-readable
instructions-long
compact-instructions-missing
context-surface
duplicate-skills
thinking-tokens-env
prompt-cache-ttl-forced-short
agent-teams-enabled
mcp-output-limit-raised
every-tool-hooks
idle-compaction-off
bash-output-raised
code-intelligence-missing
settings-key-undocumented
env-undocumented
setting-needs-newer-version
slide-blocked-by-guard
compact-pct-override
skill-model-switch
opusplan-cache
no-statusline

templates/statusline.sh は、修正がClaude設定フォルダにインストールするステータスラインスクリプトです。templates/agents/ には、小さなモデルにピン留めされ、読み取り専用または限定的なツールを持つ3つの汎用サブエージェント(Explore、test-runner、docs-lookup)が含まれています。プラグインは組み込みエージェントをオーバーライドしたり、autoCompactWindow、env、permissionsなどのsettings.jsonキーを送信したりできないため、適用ステップはテンプレートを~/.claude/agents/または.claude/agents/にコピーし、設定ファイルを自分で編集します(バックアップ付き)。

今日のドキュメントと実際にロードされたものとの比較

Claude Codeは数日ごとに変更されるため、監査はプラグインに凍結されたリストを信頼しません。

  • code.claude.com から現在の設定リファレンスと環境変数リストをMarkdown形式で読み取ります(すべてのドキュメントページは…/docs/en/<page>.mdで提供され、llms.txtでモデル用にインデックス化されています。コンテキスト7のようなミラーは独自のスケジュールで再インデックス化します)。~/.claude/tokendoctor/docsに1日キャッシュされます。--offline はキャッシュのみを使用します。公開されているページのみが取得され、何も送信されません。Claude Codeがドキュメント化していない設定キー(settings-key-undocumented:スペルミスまたは削除されたキーは何も機能しません)、Claude Code自身のファミリーで知らない変数(env-undocumented)、および新しいリリースが必要なキー(setting-needs-newer-version)をフラグ付けします。
  • 1日のclaude --debugログ(もしあれば)を読み取ります。tokendoctor-selfcheckはログを作成します(保存されていないセッションなしでHaikuでのclaude -pリクエスト1つ。--log <file>はあなたが持っているものをコストなしで読み取ります):どのtokendoctorのコピーがどのティアでロードされたか、組み込みガードが座っていたかどうか、コンパクト化のモッドの順序、スキップされたフック、Claude Codeが実際にコンパクト化するウィンドウ、および予算を超えたスキルリスト(説明は短縮されています)。
  • /tokendoctor:audit および /tokendoctor:optimize スキルは、検出内容のドキュメントページを読み取ってから説明または推奨します。
  • tokendoctorのメンテナー向けに、npm run docs:check は、現在ドキュメントに対して名前が付けられているすべて設定キーと変数をチェックします。

セッションレポートが見つけるもの

検出内容
late-compaction
subagents-on-top-model
long-sessions
idle-cache-rebuilds
images-read-repeatedly
rereads-after-compaction

コンパクト化の代わりにウィンドウをスライドさせる

デフォルトではオフです。/tokendoctor slide on(またはtokendoctor-set tokendoctor.slide true --write、または/tokendoctor:optimize)を使用すると、Claude Codeがコンパクト化する場所で、プラグインのフックモジュールは古いツールの出力を要約する代わりに短いポインターに省略します。これはllxが行う方法と同じです。すべてのプロンプト、回答、決定は一語一句そのまま保持され、要約の一時停止はありません。

  • 最初に表示されるもの:後続の読み取りまたは同じファイルの編集によって古くなった読み取り、次に編集内容(ディスク上にある)、次に最も古い出力。最近のテール、モデルがまだ回答していない出力、およびエージェントの結果は保持されます。
  • tokendoctor.slideToパーセント(デフォルト25)まで解放されるため、スライドはまれです。各スライドはコンテキストを1回だけ再送信します。これは要約と同様です。ポインターは二度と触れられません。
  • /compact は依然として要約を実行し、十分なスペースを解放できないスライドも同様です。より小さいウィンドウをautoCompactWindow(例:400000)で設定すると、スライドはそのウィンドウから機能します。
  • アイドルコンパクト化も対象となります(1時間のキャッシュが期限切れになる前)。/compact およびプラグインの$.session.compact は依然として要約を実行します。
  • チームおよびエンタープライズログイン、および管理対象設定を持つマシン。 ここでは、Claude Codeはインストールしたモッドの前に組み込みガードcc-plugin-sec-defaultを配置し、モッドを通過してコンパクト化を送信します。スライドは実行できず、監査と/tokendoctor slideはその旨を示します。tokendoctor-org-installは、マシン自身のモッドとしてtokendoctorをインストールします。これはガードの後に実行されます。システムフォルダ内のルート所有のコピーと、appendPluginsを持つmanaged-settings.d/50-tokendoctor.json(最初にドライランし、次に1つのsudoコマンド。--uninstallで元に戻します)。組織が独自の管理対象設定を提供している場合、ファイルは無視され、管理者のみが追加できます。

実際のセッションで、同じサイズで:Claude Codeの要約は65.3秒で367Kから35Kに削減されました。スライドは0.04秒で368Kから36Kに削減されました。著者の実際のセッションでの要約は平均79秒かかります(109回、9月22日から11月1日)。

bench/では、Claude CodeがTypeScriptプロジェクトを修正された受け入れテストに対して実行し、Haiku 5.5、100Kウィンドウで複数回コンパクト化(中央値)します。1回のコンパクト化を伴う短いタスクは時間節約にはなりますがお金は節約しません。作業が長くなるほど、スライドはより多く節約できます。

タスク
1日の作業(7リクエスト、307テスト)、2回実行
evalkit(評価ハーネス、238テスト)、5回および3回実行
fixkit(バグ12個発見、238テスト)、5回実行

以前の、より小さなnode bench/window.mjsの実行(60ファイル、各300行を1つずつ読み込み、その後同じセッションでフォローアップ、200Kウィンドウ)は、両方とも同じコストでした。

モデル
Haiku 5.5(3回実行)
Haiku 5.5(3回実行)
Sonnet 5.5(1回実行)
Sonnet 5.5(1回実行)

要約が失うもの(--task recallで測定):セッションはユーザーからの5つの決定から始まり、ファイルは読み取り後に削除され、フォローアップでは決定とモデルが記録した8つのKEYが要求されます。Claude Codeの要約は、すべての実行で両方のモデルで6/6と8/8を保持しました。スライドはHaiku 5.5(3回実行、2%高価)で同じことを行いました。Sonnet 5.5(1回実行)では1つのKEYを逃しましたが、これはモデルがスライド後の最初の応答で記録するのをスキップしました。今のところ、スライドがより良く、または悪く回答することを示すテストはありません。品質ではなく、時間とコストを節約します。

制限事項

  • ユーザー、プロジェクト、ローカル設定ファイル、~/.claude.json(MCPサーバー名、カウント用、プランタイプ、ガードが座っているかどうかの判断用)、システムフォルダ内の管理対象設定ファイル、およびキャッシュされたサーバー管理対象ファイル(ガードとそのマシンコピーを見つけるためのみ)、およびスキルとエージェントフォルダを読み取ります。管理対象設定はルールに対してチェックされません。
  • 監査は、Claude Codeのドキュメントの公開ページを1日2回取得します(--offlineでスキップ)。それ以外はネットワークを介さず、あなたのものは何も送信されません。
  • ルールが役立つかどうかは、あなたのプランとワークロードによって異なります。検出内容はトレードオフを説明し、ドキュメントにリンクしています。ご自身で判断してください。
  • permissions.deny の拒否ルールは、検索ツールに対してベストエフォートであり、Bashによる読み取りを停止しません。
  • コストは、各モデルのClaude API価格(lib/prices.mjs:Opus 5.5およびSonnet 5.5では入力の0.05倍、Fable 5.1では0.025倍でキャッシュ読み取り、Haiku 5.5はプロンプト長、ファストモード、米国のみの推論、ウェブ検索で価格設定)でのドルです。ProまたはMaxプランでは、APIで同じ作業にかかるコストと同じです。Anthropicは、プラン制限が各トークンタイプをどのように重み付けするかを公開していません。
  • Claude Codeは、トランスクリプトに書き込まない一部のリクエストを請求します:要約コンパクト化自体のリクエスト、タイトル、WebFetch用にページを読み取る小さなモデル。そのコストはClaude Code自身のセッション合計(cost-state行)からトランスクリプト内の応答を引いたもの(合計がそこにある場合)です。それ以外の場合、要約は読み取ったコンテキストから推定されます。benchの78回の実行でClaude Codeが報告したコストに対して:77回はセント単位で一致し、1回は7.7%増でした。
  • 他のマシンでのセッションとClaude Codeがすでにクリーンアップしたトランスクリプトは、履歴ファイルにすでに存在する日を除き、カウントされません。

開発

npm test               # Nodeの組み込みテストランナー、依存関係なし
npm run test:mod     # フックモジュールのテスト(claude plugin test)
claude plugin validate .
bun bench/run.ts --task fixkit --window 100000 --arm factory --arm factory+slide   # bench/README.mdを参照

test/private.test.mjs は、gitがコミットするものがAPIキーまたはトークン、ホームフォルダパス、またはマシンのテンポラリフォルダを含んでいる場合に失敗します。ベンチマーク結果は、誰かのアカウントでの実行から得られるため、コミットされるのはその人の要約のみであり、トランスクリプトはローカルに保持されます。

ランディングページは site/ にあります(cd site && npm install && npm run dev)。npm run build はプリレンダリングし、node scripts/og.mjs はソーシャルカードを再描画します。デモはasciinemaで録画された実際のセッションです。site/scripts/RECORDING.md に再録画方法が記載されています。

ルールはスナップショットに対する純粋な関数です(lib/rules.mjs)。ディスクの読み取りはlib/collect.mjsに、書き込みはlib/apply.mjsにあります。ルールを追加するには、エントリとそのテストを追加します。セッション分析はlib/sessions.mjsとlib/history.mjsに、tokendoctor-setが変更する設定はlib/tunables.mjsに、/tokendoctorコマンドはlib/console.mjsに、リプレイはlib/replay.mjsに、スライドはhooks/window.tsに、最適化ツールはhooks/register.tsにあります。

ライセンス

MIT