tokendoctorと呼ばれる新しいローカルプラグインは、非効率な設定を特定して修正することで、Claude Codeの使用コストを最大38%削減すると主張しています。localixaiによって開発されたこのツールは、ユーザーの実際のセッション履歴を分析して、どこでトークンに対して過剰な支払いが発生しているかを特定し、環境を最適化するための38の具体的なチェック項目を提供します。

Claude Codeセッション内でtokendoctorコマンドが実行されているターミナルインターフェース。
セッション履歴とトレンドを分析するために、ライブのClaude Codeセッションで使用されているtokendoctorプラグイン。github.com

この画像は、Claude Code環境内で直接セッション履歴を分析するというツールの主要な機能を実演しています。

監査および最適化の仕組み

Tokendoctorは、ユーザーのセッションをより小さなコンテキストウィンドウでリプレイすることで、何が節約できたかを判断します。具体的には、読み取り不可能な設定ファイル、誤ったキー、プロンプトキャッシュが無効になっている環境などのエラーを特定します。

このプラグインは、公式ドキュメントに対して38の異なるチェックを実行します。これには、ユーザーがサブエージェントのために高価なモデルを強制的に使用している場合や、大きなディレクトリ(「dist」や「build」など)がモデルの読み取り権限から適切に除外されていない場合などを特定することが含まれます。

“tokendoctor: 最大38%安くなる、同じClaude Code。”

— GitHub - localixai/tokendoctor: tokendoctor: the same Claude Code for up to 38% less. A Claude Code plugin that shows wh

コンテキスト管理と「Slide」機能

このツールの主要なメカニズムの一つは「slide」コマンドです。Claude Codeは通常、スペースを節約するために古いツールの出力を要約しますが、tokendoctorはそれらの要約を実際の古いツールの出力に置き換えます。これにより、新しい要約呼び出しのコストを回避しながら、会話の内容を一言一句そのまま維持します。

このツールは「autoCompactWindow」も管理します。例えば、コンテキストサイズとプロンプトキャッシュを温かい状態に保つ必要性のバランスをとるために、ウィンドウを400,000トークンに設定することを提案できます。

ローカルダッシュボードとトレードオフ

ユーザーは、マシン上で消費されたすべてのトークンをプロジェクト、時間、モデル別に分類して追跡するローカルHTMLダッシュボードを生成できます。このファイルはローカルに保持され、表示するためにネットワーク接続を必要としません。

トークン支出の内訳を示すデータ視覚化ダッシュボード。
支出の大部分が、モデルが以前の会話コンテキストを再読することから発生する可能性があることを示すtokendoctorダッシュボードのサンプル。github.com

ダッシュボードは、ツールが特定する冗長な読み取りなどの具体的な非効率性の種類を例示しています。

このツールの有効性は、ユーザー固有の使用パターンに依存します。例えば、ユーザーのセッションが400,000トークンを超えることがほとんどない場合、ウィンドウの調整では測定可能な節約が得られない可能性があります。さらに、セッションの終了直前に行われる要約は、最適化によって得られる節約よりもコストがかかる場合もあります。

Hacker Newsの読者の反応

  • 懐疑的: あるコメント投稿者は、ツールの包括性に懐疑的な見方を示し、デフォルトの設定ですでに優れている可能性や、追加の複雑さが証明可能な利点をもたらさない可能性を示唆しました。 コメント ↗
  • 体験談: あるユーザーはツールで成功を収めたと報告しましたが、他の類似ツールと同時に使用した際に競合を引き起こさないかという疑問を投げかけました。 コメント ↗
  • 代替案: 別のコメント投稿者は、トークン使用量を制限するという目標は、「caveman」のように異なるアプローチをとる他のプロジェクトを通じて達成できる可能性があると提案しました。 コメント ↗
  • 懐疑的: ある読者は、このようなツールの実際の有効性に疑問を呈し、ユーザーが検出しにくい方法でパフォーマンスを微妙に低下させる可能性があると主張しました。 コメント ↗

Hacker Newsのスレッドで出た意見の要約です。事実として検証されたものではありません。 議論の全文を読む ↗