途中でツールを足すとClaudeのプロンプトキャッシュが全部飛ぶ問題と回避策

Claudeでエージェント実行中にツールを追加すると、プロンプトキャッシュが消失し、再課金される問題とその回避策について解説しています。長時間稼働するエージェントにおいて、この問題はコスト増加に直結します。

• Claudeでツールを途中追加するとプロンプトキャッシュが全て無効になる問題が判明しました。
• これは、ツール定義の変更がキャッシュ照合の最前面にあり、ハッシュ値が変わるためと説明されています。
• 従来、この問題のためツールの変更は困難でしたが、Anthropicの新機能で回避策が提供されます。
• 新機能では、ツール配列自体は変更せず、systemメッセージでツールの追加・削除を指示します。