Claude Codeのトークンコストと使用量分析

Anthropicは、Claude Codeで同じバグを修正する際にトークン消費量が大きく異なる理由を説明した詳細なブログ記事を公開した。コストモデルは、プリフィルとデコードの間に5倍の価格差があること、プレフィックスマッチングによるプロンプトキャッシュの仕組み、コンテキスト内のすべてのアイテムが会話のターンごとに再送信されることを示している。推奨事項では、/clear、/compact、@メンションコマンドを頻繁に使用し、セッションを短く保ち、コンテキストを最小限に抑え、タスクに応じたモデルと労力を選択し、プロンプトキャッシュの中断を避けることが強調されている。このガイドでは、トークンの価格を決定する要素(モデル、入出力分割、キャッシュ、キャッシュ破壊要因)、セッションが送信するトークン数(一度だけ送信されるものはない、コンテキスト内のコンテンツ、ターン数、サブエージェント)、および最適化を優先すべき箇所について説明している。
Key insights
Anthropicがトークンコスト構造を分析、プリフィル/デコード間の5倍の価格差を強調
トークンの価格は、モデルの選択、入力トークンと出力トークンの違い、特にプロンプトキャッシュによって決まる。プリフィルとデコードの分割により5倍の価格差が生じる。キャッシュを適切に活用し、それを破壊するアクションを理解することで、セッションコストを大幅に変えることができる。
毎回のターンでのコンテキストの繰り返し送信がトークン消費を増加
重要な洞察は、情報は一度だけ送信されるわけではないということだ。ツール、メモリー、MCPリソースを含むコンテキスト内のすべてが、セッションごとに数十回再送信される。これにより、長いセッションや肥大化したコンテキストは、単純なタスクであっても特にコストが高くなる。
実用的なコマンドとセッション管理でコストを大幅に削減
ブログでは、/clear、/compact、および正確な@メンションコマンドの定期的な使用を推奨している。ユーザーは、過度に長いセッションを避け、コンテキストサイズを制限し、タスクに必要なモデルと努力レベルのみを使用し、プロンプトキャッシュを壊さないようにするようアドバイスされている。これらの調整により、不必要なデータの繰り返し送信を回避できる。