Claudeコードトークン浪費修正：キャッシュヒット向上のための帰属ヘッダーの無効化

Claude Codeはバージョン2.1.69以降、プロンプトキャッシュを妨げる課金属性ヘッダーのため、すべての新規セッションでトークンを浪費してきました。この問題は複数のGitHubイシュー（#40652、#34629、#40524）で文書化されていますが、ソース公開時点でAnthropicからの公式な回答はありません。

何が起きているのか

v2.1.69以降、Claude Codeはシステムプロンプトの最初のブロックに課金属性文字列を挿入します：x-anthropic-billing-header: cc_version=2.1.88.a3f; cc_entrypoint=cli; cch=00000;

.a3fの部分は、各会話の最初のメッセージからこの関数を使用して計算される3文字のハッシュです：

function computeHash(firstUserMessage, version) {
  const chars = [4, 7, 20].map(i => firstUserMessage[i] || "0").join("");
  return sha256("59cf53e54c78" + chars + version).slice(0, 3);
}

異なる最初のメッセージを持つ異なる会話は、毎回異なるハッシュを生成します。

これがキャッシュを壊す理由

Anthropicのキャッシングには100%同一のプロンプトセグメントが必要です。キャッシュはセッションごとではなく、組織またはワークスペース全体で共有されます。課金ヘッダーは約23Kトークンのシステムプロンプトの先頭に位置し、会話ごとに変化するため、接頭辞が一致せず、新しいチャットごとにキャッシュミスが発生します。

ベンチマーク結果

制御されたA/Bテストでは以下の結果が示されました：

• ヘッダーON（デフォルト）： 48%のキャッシュヒット率、セッションごとに約12Kトークン再構築
• ヘッダーOFF： 99.98%のキャッシュヒット率、4回中3回のセッションでキャッシュ作成ゼロ

この結果、システムプロンプト処理のセッションごとのコストが7分の1に削減されます。

修正方法

シェル設定に以下を追加してください：

export CLAUDE_CODE_ATTRIBUTION_HEADER=false

zshユーザーの場合：

echo 'export CLAUDE_CODE_ATTRIBUTION_HEADER=false' >> ~/.zshrc
source ~/.zshrc

新しいセッションは自動的にこれを取得します。既存のセッションは再起動する必要はありません—ハッシュは会話中に変更されず、新しいセッションと干渉しません。

安全性と背景

これはハックではありません—環境変数は適切な機能トグルとしてソースコードに存在します。claude-code-routerとCLIProxyAPIは、この設定を無効にして本番環境で出荷されており、報告された問題はありません。

Anthropicはおそらく、どのバージョンとエントリーポイント（CLI対SDK対GitHub Action）が各API呼び出しを行ったかを追跡するためにこれを実装し、Bedrock/Vertexがカスタムヘッダーを転送しないため、システムプロンプト内に配置しました。