AnthropicがClaude Codeのトークン消費を解説

Anthropicの投稿は、トークン単位で支払うすべての人にとって重要な区別を打ち出している。サブスク型のコーディングツールはリクエストのコストを隠すが、Claude Codeのようなエージェント型ツールはタスクごとに課金される。投稿はトークンがどこへ消えるかを、プリフィル段階とデコード段階に分けて説明する。プリフィルでは、モデルがリクエスト、コンテキスト、システムプロンプト、CLAUDE.md、メッセージ、そして前回のメッセージ以降に会話へ追加されたすべて——Claudeが読んだファイルやコマンド出力を含む——を読み込む。デコードでは、思考・ツール呼び出し・テキストといった出力トークンが1つずつ生成される。

助言の多くはプロンプトキャッシュに帰着する。Anthropicはこれをコストを抑える仕組みだと説明する。キャッシュ読み込みは入力価格の0.1倍、キャッシュへの書き込みは最大で入力価格の2倍だが、トークンごとに1回しか発生しない。Anthropicは、ユーザーの操作でキャッシュが無効になり得ると警告する。キャッシュはリクエスト先頭での一致が必要なため、セッション途中でのモデルやエフォートレベルの切り替え、権限モードの変更、/compactの実行、あるいは単に時間が経過するだけで、会話全体が正規料金で読み直される。最終使用から1時間、APIキーの最終使用から5分での失効が主な原因だ。

Anthropicのまとめは、コストに最も大きく影響する4つの要因を挙げる。長いセッション、コンテキストの抱えすぎ、タスクに必要ない大きいモデルや高いエフォートレベルの使用、そして壊れたプロンプトキャッシュだ。実践的な提案——無関係なタスク間での/clear実行、開始前の/modelと/effort設定、Claudeに読ませるのではなくファイルを添付する、早めに/contextを確認する、キャッシュ失効前に/compactを実行する——はいずれも同じ方向を向いている。実際に請求額が下がるかは、各エンジニアがセッション開始時の助言をどれだけ忠実に守るかにかかりそうだ。Anthropicが示す最も安い道（入力の0.1倍のキャッシュ読み込み）は、セッション途中の変更で最も失われやすいからだ。