37レイヤーテーブルに表示されないが、キャッシュされたままになるものに影響する 2 つの設定があります。37レイヤーテーブルに表示されないが、キャッシュされたままになるものに影響する 2 つの設定があります。

38 38 

39* **モデル**：各モデルには独自のキャッシュがあります。モデルを切り替えると、コンテンツが同じであってもリクエスト全体が再計算されます。以下の [モデルの切り替え](#switching-models) を参照してください。39* **モデル**：各モデルには独自のキャッシュがあります。モデルを切り替えると、コンテンツが同じであってもリクエスト全体が再計算されます。以下の [モデルの切り替え](#switching-models) を参照してください。

40* **エフォートレベル**：ほとんどのモデルでは、各エフォートレベルには独自のキャッシュがあるため、セッション中にエフォートを変更するとリクエスト全体が再計算されます。API キーまたは Claude サブスクリプションを使用した Opus 5.5 および Fable 5.1 では、デフォルトではキャッシュはそのままです。以下の [エフォートレベルの変更](#changing-effort-level) を参照してください。40* **エフォートレベル**：ほとんどのモデルでは、各エフォートレベルには独自のキャッシュがあるため、セッション中にエフォートを変更するとリクエスト全体が再計算されます。API キーまたは Claude サブスクリプションを使用した Opus 5.5、Sonnet 5.5、および Fable 5.1 では、デフォルトではキャッシュはそのままです。以下の [エフォートレベルの変更](#changing-effort-level) を参照してください。

41 41 

42<Tip>42<Tip>

43 セッションの最初にモデルとエフォートレベルを選択し、タスク間の自然な区切りのために `/compact` を保存してください。タスク中に行う変更が少ないほど、キャッシュヒット率が高くなります。43 セッションの最初にモデルとエフォートレベルを選択し、タスク間の自然な区切りのために `/compact` を保存してください。タスク中に行う変更が少ないほど、キャッシュヒット率が高くなります。

70 キャッシュを無効化するアクション70 キャッシュを無効化するアクション

71</h2>71</h2>

72 72 

73これらのアクションは、次のリクエストでキャッシュの一部または全部がミスになる原因となります。その後、新しいプレフィックスがキャッシュされるまで、1 回限りの遅く、より高額なターンが表示されます。これらのほとんどは、コストがあることを知ったら、タスク中に回避できます。モデルスイッチは、その後の遅いターンに気付くまで無料に感じられるかもしれません。73これらのアクションは、次のリクエストがキャッシュの一部または全部をミスする原因となります。その後、新しいプレフィックスがキャッシュされるまで、1 回限りの遅い、より高額なターンが表示されます。これらのほとんどは、コストがあることを知ったら、タスク中に回避できます。モデルスイッチは、その後の遅いターンに気付くまで無料に感じられます。

74 74 

75* [モデルの切り替え](#switching-models)75* [モデルの切り替え](#switching-models)

76* [努力レベルの変更](#changing-effort-level)76* [努力レベルの変更](#changing-effort-level)

77* [高速モードの有効化](#turning-on-fast-mode)77* [高速モードの有効化](#turning-on-fast-mode)

78* [MCP サーバーの接続または切断](#connecting-or-disconnecting-an-mcp-server)78* [MCP サーバーの接続または削除](#connecting-or-removing-an-mcp-server)

79* [プラグインの有効化または無効化](#enabling-or-disabling-a-plugin)79* [プラグインの有効化または無効化](#enabling-or-disabling-a-plugin)

80* [ツール全体の拒否](#denying-an-entire-tool)80* [ツール全体の拒否](#denying-an-entire-tool)

81* [会話のコンパクト化](#compacting-the-conversation)81* [会話のコンパクト化](#compacting-the-conversation)

88 88 

89各モデルには独自のキャッシュがあります。[`/model`](/docs/ja/model-config#setting-your-model) で切り替えると、コンテンツが同じであっても、次のリクエストはキャッシュヒットなしで会話履歴全体を読み込みます。89各モデルには独自のキャッシュがあります。[`/model`](/docs/ja/model-config#setting-your-model) で切り替えると、コンテンツが同じであっても、次のリクエストはキャッシュヒットなしで会話履歴全体を読み込みます。

90 90 

91ターミナルで `/model` を実行すると、キャッシュがまだ温かい間は、Claude Code はスイッチの確認を求めます。ただし、新しいモデルが最後のレスポンスを生成したモデルではない場合に限ります。キャッシュは、Claude Code がこの会話で最後にリクエストを送信した後、または Claude が最後に応答した後、1 つの[キャッシュ TTL](#cache-lifetime) の間、温かいままです。その時間が経過すると、キャッシュは期限切れになるため、Claude Code は確認を求めずに切り替えます。91ターミナルで `/model` を実行すると、キャッシュがまだ温かく、新しいモデルが最後のレスポンスを生成したモデルではない場合にのみ、Claude Code はスイッチの確認を求めます。キャッシュは、Claude Code がこの会話で最後にリクエストを送信した後、または Claude が最後に応答した後、1 つの [キャッシュ TTL](#cache-lifetime) の間、温かいままです。その時間が経過すると、キャッシュは期限切れになるため、Claude Code は確認なしで切り替えます。

92 92 

93v2.1.238 より前では、Claude Code はキャッシュ TTL をチェックせず、キャッシュが期限切れになった後でも確認を求めていました。93v2.1.238 より前では、Claude Code はキャッシュ TTL をチェックせず、キャッシュが期限切れになった後でも確認を求めていました。

94 94 

95[PreModelSwitch フック](/docs/ja/hooks#premodelswitch-decision-control)を使用して、この確認を必須にするか、スキップすることもできます。95[PreModelSwitch フック](/docs/ja/hooks#premodelswitch-decision-control) を使用して、この確認を必須にするか、スキップすることもできます。

96 96 

97[`opusplan` モデル設定](/docs/ja/model-config#opusplan-model-setting)は、プランモード中は Opus に、実行中は Sonnet に解決されるため、各プランモードの切り替えはモデルスイッチであり、新しいキャッシュを開始します。97[`opusplan` モデル設定](/docs/ja/model-config#opusplan-model-setting) は、プランモード中は Opus に、実行中は Sonnet に解決されるため、各プランモード切り替えはモデルスイッチであり、新しいキャッシュを開始します。

98 98 

99Fable モデルと Opus 5.5 および Opus 5 の[自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)もモデルスイッチです。安全分類器がフォールバックモデルを持つカテゴリーでリクエストにフラグを立てると、Claude Code はそのモデルでリクエストを再実行し、セッションはそこで続行されます。99Fable モデル、Opus 5.5、Sonnet 5.5、および Opus 5 の [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) もモデルスイッチです。安全分類器がフォールバックモデルを持つカテゴリーでリクエストにフラグを立てると、Claude Code はそのモデルでリクエストを再実行し、セッションはそこで続行されます。

100 100 

101スキルまたはコマンドのフロントマターがセッションの現在のモデル以外の [`model`](/docs/ja/skills#frontmatter-reference)を指定する場合、そのターンもモデルスイッチです。次のリクエストはキャッシュヒットなしで会話履歴全体を読み込みます。セッションモデルは次のプロンプトで再開されます。`context: fork` スキルは、代わりに[フォークされたサブエージェントのモデル](/docs/ja/skills#run-skills-in-a-subagent)を設定します。101スキルまたはコマンドのフロントマターがセッションの現在のモデル以外の [`model`](/docs/ja/skills#frontmatter-reference) を指定する場合、そのターンもモデルスイッチです。次のリクエストはキャッシュヒットなしで会話履歴全体を読み込みます。セッションモデルは次のプロンプトで再開されます。`context: fork` スキルは、代わりに [フォークされたサブエージェントのモデル](/docs/ja/skills#run-skills-in-a-subagent) を設定します。

102 102 

103<h3 id="changing-effort-level">103<h3 id="changing-effort-level">

104 努力レベルの変更104 努力レベルの変更

105</h3>105</h3>

106 106 

107ほとんどのモデルでは、セッション中に[努力レベル](/docs/ja/model-config#adjust-effort-level)を変更すると、次のリクエストはキャッシュヒットなしで会話履歴全体を読み込みます。キャッシュがまだ温かい間は、Claude Code は最初に変更を確認するよう求めます。107ほとんどのモデルでは、セッション中に [努力レベル](/docs/ja/model-config#adjust-effort-level) を変更すると、次のリクエストはキャッシュヒットなしで会話履歴全体を読み込みます。キャッシュがまだ温かい間、Claude Code は最初に変更を確認するよう求めます。

108 108 

109API キーまたは Claude サブスクリプションを使用した Opus 5.5 および Fable 5.1 では、努力レベルの変更によってキャッシュが保持され、Claude Code は確認を求めずに新しいレベルを適用します。これは Amazon Bedrock、Google Cloud の Agent Platform、[Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway)、または [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)を設定した場合、あるいは組織が HIPAA 構成を持つ場合には適用されません。109API キーまたは Claude サブスクリプションを使用する Opus 5.5、Sonnet 5.5、および Fable 5.1 では、努力レベルを変更してもキャッシュが保持され、Claude Code は確認なしに新しいレベルを適用します。これは Amazon Bedrock、Google Cloud の Agent Platform、または [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway) には適用されません。また、[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) を設定した場合、または組織が HIPAA 構成を持つ場合にも適用されません。

110 110 

111v2.1.260 より前では、API キーまたは Claude サブスクリプションを使用した Fable 5.1 での努力レベルの変更もキャッシュを無効化していました。111v2.1.260 より前では、API キーまたは Claude サブスクリプションを使用する Fable 5.1 の努力レベルを変更すると、キャッシュも無効化されていました。

112 112 

113<h3 id="turning-on-fast-mode">113<h3 id="turning-on-fast-mode">

114 高速モードの有効化114 高速モードの有効化

115</h3>115</h3>

116 116 

117[高速モード](/docs/ja/fast-mode)を有効にすると、キャッシュキーの一部であるリクエストヘッダーが追加されるため、Claude Code が高速モードをオンにして送信する最初のリクエストはキャッシュヒットなしで会話履歴全体を読み込みます。Claude Code はターンの開始時にそのヘッダーを 1 回設定し、ターン全体でそれを保持するため、Claude が作業中に高速モードをオンにすると、ヘッダーからのキャッシュミスは次のターンの最初のリクエストで発生します。これらのキャッシュされていない入力トークンは[高速モードレート](/docs/ja/fast-mode#understand-the-cost-tradeoff)で請求されます。これが、セッションの開始時にオンにするのが、長いセッションの深くでオンにするよりもコストが低い理由です。現在のモデルが高速モードをサポートしていない場合、高速モードを有効にすると[モデルも切り替わり](#switching-models)、そのスイッチ自体が実行中のターンの次のリクエストから新しいキャッシュを開始します。117[高速モード](/docs/ja/fast-mode) を有効にすると、キャッシュキーの一部であるリクエストヘッダーが追加されるため、Claude Code が高速モードをオンにして送信する最初のリクエストはキャッシュヒットなしで会話履歴全体を読み込みます。Claude Code はターンの開始時にそのヘッダーを 1 回設定し、ターン全体でそれを保持するため、Claude が作業中に高速モードをオンにすると、ヘッダーからのキャッシュミスは次のターンの最初のリクエストで発生します。これらのキャッシュされていない入力トークンは [高速モードレート](/docs/ja/fast-mode#understand-the-cost-tradeoff) で請求されます。これが、セッションの開始時に高速モードをオンにすることが、長いセッションの深くでオンにすることより低コストである理由です。現在のモデルが高速モードをサポートしていない場合、高速モードを有効にすると [モデルも切り替わり](#switching-models)、そのスイッチ自体が実行中のターンの次のリクエストから新しいキャッシュを開始します。

118 118 

119コストは会話ごとに 1 回適用されます。最初の高速モードターンの後、Claude Code はヘッダーを送信し続け、キャッシュキーの一部ではないリクエストの速度設定のみを変更します。高速モードをオフにする、[レート制限後の標準速度への自動フォールバック](/docs/ja/fast-mode#handle-rate-limits)、およびその後にオンに戻すことはすべてキャッシュを保持します。[使用クレジットが不足した](/docs/ja/fast-mode#handle-rate-limits)場合、Claude Code は各拒否された高速モードリクエストを同じ方法で標準速度で再試行するため、このフォールバックもキャッシュを保持します。`/clear` と `/compact` はこれをリセットします。これらはとにかくそれらのポイントでキャッシュを再構築するためです。119コストは会話ごとに 1 回適用されます。最初の高速モードターンの後、Claude Code はヘッダーを送信し続け、キャッシュキーの一部ではないリクエストの速度設定のみを変更します。高速モードをオフにすること、[レート制限後の標準速度への自動フォールバック](/docs/ja/fast-mode#handle-rate-limits)、およびその後にオンに戻すことはすべてキャッシュを保持します。[使用クレジットが不足した](/docs/ja/fast-mode#handle-rate-limits) 場合、Claude Code は各拒否された高速モードリクエストを同じ方法で標準速度で再試行するため、このフォールバックもキャッシュを保持します。`/clear` と `/compact` はこれをリセットします。これらはとにかくそれらのポイントでキャッシュを再構築するためです。

120 120 

121<h3 id="connecting-or-disconnecting-an-mcp-server">121<h3 id="connecting-or-removing-an-mcp-server">

122 MCP サーバーの接続または切断122 MCP サーバーの接続または削除

123</h3>123</h3>

124 124 

125ツール定義はシステムプロンプトレイヤーに存在するため、ターン間でリクエスト内のツール定義のセットが変わるとキャッシュが無効化されます。[アドバイザーツール](/docs/ja/advisor)の切り替えは例外です。その定義はキャッシュブレークポイントの後に存在するため、`/advisor` を有効または無効にするとキャッシュされたプレフィックスはそのまま保持されます。[MCP サーバー](/docs/ja/mcp)の変更がこれを行うかどうかは、そのツールが[ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search)によって遅延されるか、プレフィックスに読み込まれるかによって異なります。125ツール定義はシステムプロンプトレイヤーに存在するため、リクエスト内のツール定義のセットがターン間で変更されるとキャッシュが無効化されます。[アドバイザーツール](/docs/ja/advisor) の切り替えは例外です。その定義はキャッシュブレークポイントの後に存在するため、`/advisor` を有効または無効にするとキャッシュされたプレフィックスはそのまま保持されます。[MCP サーバー](/docs/ja/mcp) の変更がこれを行うかどうかは、[ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) がセッションの MCP ツールを遅延させるかどうかによります。これはサポートされているモデルのデフォルトです。

126 126 

127* **遅延ツール**、サポートされているモデルのデフォルト：サーバーの接続、切断、またはツールリストの変更は、新しいコンテンツを追加するだけで、既にキャッシュされているものを乱しません。127* **ツール遅延**: Claude Code は会話の最初のリクエストからツールリストを保持するため、セッション中にサーバーが接続または切断されても、既にキャッシュされているものは何も影響を受けません。最初のリクエスト後に接続を完了するサーバーは、Claude がオンデマンドで読み込む遅延定義としてそのツールを提供します。

128* **プレフィックスに読み込まれるツール**：それらへの変更はキャッシュを無効化します。これは、[ツール検索が利用できないか無効になっている](/docs/ja/mcp#configure-tool-search)場合に発生します。例えば、Claude 4.5 世代より前の Google Cloud の Agent Platform モデル、カスタム `ANTHROPIC_BASE_URL` ゲートウェイ、または Claude Code がデプロイメントがツール検索を拒否することを検出した Microsoft Foundry [Azure でホストされているデプロイメント](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options)の場合です。また、[`alwaysLoad`](/docs/ja/mcp#exempt-a-server-from-deferral)とマークされたサーバーまたはツール、および[閾値ベースの読み込み](/docs/ja/mcp#configure-tool-search)によって前もって保持される定義の場合にも発生します。128* **ツール事前読み込み**: 定義を追加するとキャッシュが無効化され、意図的に削除してもそうなります。これは、ツール検索が [その `auto` しきい値以下、無効、または利用不可](/docs/ja/mcp#configure-tool-search) である場合に適用されます。例えば、Google Cloud の Agent Platform モデル（Claude 4.5 世代より前）、カスタム `ANTHROPIC_BASE_URL` ゲートウェイ、または Microsoft Foundry [Azure でホストされているデプロイメント](https://platform.claude.com/docs/en/build-with-claude/claude-in-microsoft-foundry#hosting-options) で、Claude Code がデプロイメントがツール検索を拒否することを検出した場合です。

129 129 

130ツールがプレフィックスに読み込まれる場合、無効化の最も一般的な原因は、セッション中にサーバーが接続または切断されることです。これは、あなたのアクションなしに発生する可能性があります。stdio サーバーのプロセスが終了する、HTTP セッションが期限切れになる、またはサーバーが[一時的な障害後に自動的に再接続](/docs/ja/mcp#automatic-reconnection)する場合です。接続されたサーバーは、そのツールリストを変更する[動的ツール更新](/docs/ja/mcp#dynamic-tool-updates)をプッシュすることもできます。130ツール検索がない場合、セッション中のサーバー変更がキャッシュを無効化するかどうかは、何が変更されたかによります。各変更について、このテーブルはキャッシュが保持されるかどうか、および次のリクエストのツール定義に何が起こるかを示します。

131 131 

132MCP 設定を編集しても、それ自体ではキャッシュは変わりません。新しい設定は、サーバーが接続または切断される再起動後にのみ有効になります。132| セッション中の変更 | キャッシュ | 次のリクエストのツール定義 |

133| - | - | - |

134| サーバーが接続する、または [動的ツール更新](/docs/ja/mcp#dynamic-tool-updates) がツールを追加する | 無効化 | 新しい定義が追加される |

135| サーバーがあなたの操作なしで切断される（例えば、stdio サーバーのプロセスが終了する） | 保持 | サーバーの定義は変更されないままです。そのツールの 1 つへの呼び出しはエラーを返します（実行される代わりに） |

136| リモートサーバーが接続切断後に [自動的に再接続](/docs/ja/mcp#automatic-reconnection) する | 保持（サーバーが再接続中に送信されたリクエストが `WaitForMcpServers` ツールを追加する場合を除き、その場合は 1 回無効化） | サーバーの定義は変更されないままです。サーバーが再接続中に送信されたリクエストは、会話がまだそれをリストしていない場合に `WaitForMcpServers` を追加でき、ツールはその後会話の残りの間リストされたままになります |

137| [拒否ルール](#denying-an-entire-tool) を使用するか、`/mcp` でサーバーを無効にするなど、意図的にツールを削除する | 無効化 | 定義が削除される |

138 

139ツールがプレフィックスに読み込まれる会話を再開する場合、その MCP サーバーの 1 つは最初のリクエストが送信されるときにまだ接続中である可能性があります。トランスクリプトがそのサーバーのツール定義を記録した場合、そのリクエストは記録されたものとしてそれらを含むため、サーバーが同じツールで接続を完了しても変更されません。

140 

141MCP 設定を編集しても、それ自体ではキャッシュは変更されません。新しい設定は再起動後にのみ有効になります。これは、サーバーが接続または切断されるときです。

133 142 

134<h3 id="enabling-or-disabling-a-plugin">143<h3 id="enabling-or-disabling-a-plugin">

135 プラグインの有効化または無効化144 プラグインの有効化または無効化

136</h3>145</h3>

137 146 

138[プラグイン](/docs/ja/plugins/overview)を有効または無効にする場合、変更のコストはプラグインが提供するコンポーネントタイプによって異なります。以下のケースは、各コンポーネントタイプ、Claude Code が変更を適用するタイミング、および同じセッション内でプラグインを再度無効にする場合の動作をカバーしています。147[プラグイン](/docs/ja/plugins/overview) を有効または無効にする場合、変更のコストはプラグインが提供するコンポーネントタイプによって異なります。以下のケースは各コンポーネントタイプ、Claude Code が変更を適用するタイミング、および同じセッション内でプラグインを再度無効にするときに何が起こるかをカバーしています。

139 148 

140<h4 id="plugin-components-that-keep-the-cache">149<h4 id="plugin-components-that-keep-the-cache">

141 キャッシュを保持するプラグインコンポーネント150 キャッシュを保持するプラグインコンポーネント

142</h4>151</h4>

143 152 

144Claude Code は、プラグインのスキル、コマンド、エージェント、フック、モニター、またはテーマのキャッシュを無効化することはありません。既存の会話の後にそのコンテンツを追加するため、次のリクエストはそのコンテンツに対して支払い、その前のすべてをキャッシュから読み込みます。153Claude Code は、プラグインのスキル、コマンド、エージェント、フック、モニター、またはテーマのキャッシュを無効化することはありません。既存の会話の後にそれらのコンテンツを追加するため、次のリクエストはそのコンテンツに対して支払い、その前のすべてをキャッシュから読み込みます。

145 154 

146<h4 id="plugins-that-provide-mcp-servers">155<h4 id="plugins-that-provide-mcp-servers">

147 MCP サーバーを提供するプラグイン156 MCP サーバーを提供するプラグイン

148</h4>157</h4>

149 158 

150[MCP サーバー](/docs/ja/plugins/components#mcp-servers)を提供するプラグインを有効または無効にする場合、Claude Code は[MCP サーバーを接続または切断する](#connecting-or-disconnecting-an-mcp-server)場合と同じルールに従います。159[MCP サーバー](/docs/ja/plugins/components#mcp-servers) を提供するプラグインを有効または無効にする場合、Claude Code は [MCP サーバーを接続または削除](#connecting-or-removing-an-mcp-server) するときと同じルールに従います。

151 

152* Claude Code がサーバーのツールを遅延させる場合、キャッシュを保持します。

153* Claude Code がそれらをプレフィックスに読み込む場合、次のリクエストは会話全体を再読み込みします。

154 160 

155<h4 id="code-intelligence-plugins">161<h4 id="code-intelligence-plugins">

156 コード インテリジェンス プラグイン162 コード インテリジェンス プラグイン

157</h4>163</h4>

158 164 

159[コード インテリジェンス プラグイン](/docs/ja/plugins/code-intelligence)を有効にすると、Claude は[LSP ツール](/docs/ja/tools-reference#lsp-tool-behavior)を取得します。165[コード インテリジェンス プラグイン](/docs/ja/plugins/code-intelligence) を有効にすると、Claude は [LSP ツール](/docs/ja/tools-reference#lsp-tool-behavior) を取得します。

160 166 

161<h4 id="when-plugin-changes-apply">167<h4 id="when-plugin-changes-apply">

162 プラグイン変更が適用される場合168 プラグイン変更が適用されるタイミング

163</h4>169</h4>

164 170 

165`/plugin` メニューで行った変更は、[`/reload-plugins`](/docs/ja/plugins/cli-reference#reload-plugins)を通じて行われます。Claude Code はメニューを閉じるときにこれを実行します。追加されたアナウンスメントまたは完全な再読み込みのいずれかのコストを、変更が適用された後の最初のターンで支払います。Claude Code は変更を独自に適用することもできます。171`/plugin` メニューで行った変更は [`/reload-plugins`](/docs/ja/plugins/cli-reference#reload-plugins) を通じて行われます。これは Claude Code がメニューを閉じるときに実行します。コストは、追加されたアナウンスメントまたは完全な再読み込みのいずれかで、変更が適用された後の最初のターンで支払われます。Claude Code は変更を独自に適用することもできます。

166 172 

167* `command` ソースを持つプラグインの場合、Claude Code は[プラグイン自体を再読み込みできます](/docs/ja/plugins/loading#when-a-command-source-re-runs)。173* `command` ソースを持つプラグインの場合、Claude Code は [プラグイン自体を再読み込みできます](/docs/ja/plugins/loading#when-a-command-source-re-runs)。

168* [`/plugin` インターフェースからプラグインをインストール](/docs/ja/plugins/install#install-a-plugin)する場合、Claude Code はインストール中にそれを有効化できます。インストール概要は、それが行われたかどうかを示します。174* [`/plugin` インターフェースからプラグインをインストール](/docs/ja/plugins/install#install-a-plugin) する場合、Claude Code はインストール中にそれを有効化できます。インストール概要は、それが行われたかどうかを示します。

169* v2.1.246 以降で [`/cd`](/docs/ja/permissions#move-the-session-to-another-directory)でセッションを移動する場合、Claude Code は新しいディレクトリの設定が有効にするプラグインを移動の一部として適用します。`/reload-plugins` が保持する完全な再読み込み警告なしで。175* v2.1.246 以降で [`/cd` でセッションを移動](/docs/ja/permissions#move-the-session-to-another-directory) する場合、Claude Code は新しいディレクトリの設定が有効にするプラグインを移動の一部として適用します。完全な再読み込み警告なしで `/reload-plugins` を保持します。

170* インタラクティブセッションでは、`--plugin-dir` で渡した[プラグインのフォルダ](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session)でプラグインを追加または削除する場合、変更は直ちに適用されます。それを適用すると完全な再読み込みがトリガーされる場合、Claude Code は変更を保持し、`/reload-plugins` を実行するための通知を表示します。Claude Code v2.1.265 以降が必要です。176* インタラクティブセッションでは、`--plugin-dir` で渡した [プラグインのフォルダ](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session) 内のプラグインを追加または削除する場合、変更は直ちに適用されます。それを適用すると完全な再読み込みがトリガーされる場合、Claude Code は変更を保持し、`/reload-plugins` を実行するための通知を表示します。Claude Code v2.1.265 以降が必要です。

171 177 

172`/reload-plugins` が実行され、再読み込みが完全な再読み込みをトリガーする場合、Claude Code は警告を表示し、再読み込みを適用しません。`/reload-plugins --force` を実行して、とにかくそれを適用します。178`/reload-plugins` が実行され、再読み込みが完全な再読み込みをトリガーする場合、Claude Code は警告を表示し、再読み込みを適用しません。`/reload-plugins --force` を実行して、とにかく適用します。

173 179 

174`/reload-plugins` は、デスクトップアプリ、Agent SDK、および [`-p` を使用した非インタラクティブモード](/docs/ja/headless)など、インタラクティブターミナルのないセッションでも実行されます。セッションに直接入力する場合です。Claude Code v2.1.260 以降が必要です。180`/reload-plugins` はまた、デスクトップアプリ、Agent SDK、および [`-p` を使用した非インタラクティブモード](/docs/ja/headless) など、インタラクティブターミナルのないセッションで実行されます。セッションに直接入力する場合です。Claude Code v2.1.260 以降が必要です。

175 181 

176これらのセッションでは、再読み込みはプラグイン MCP サーバーの変更を除くすべてを適用します。これらは[次のセッションで有効になり](/docs/ja/plugins/cli-reference#reload-plugins)、セッション中に完全な再読み込みのコストは決してかかりません。182これらのセッションでは、再読み込みはプラグイン MCP サーバー変更を除くすべてを適用します。これらは [次のセッションで有効になり](/docs/ja/plugins/cli-reference#reload-plugins)、セッション中に完全な再読み込みのコストが発生することはありません。

177 183 

178<h4 id="plugins-you-enable-and-then-disable-in-one-session">184<h4 id="plugins-you-enable-and-then-disable-in-one-session">

179 セッション内で有効化してから無効化するプラグイン185 セッション内で有効にしてから無効にするプラグイン

180</h4>186</h4>

181 187 

182セッションの前半で有効にしたプラグインを無効にする場合、Claude Code は以前のリクエスト形状を復元します。そのプレフィックスがまだ[キャッシュ有効期間](#cache-lifetime)内にある場合、次のリクエストは再構築する代わりに、より古いキャッシュエントリを読み込みます。188セッションの前半で有効にしたプラグインを無効にする場合、Claude Code は以前のリクエスト形状を復元します。そのプレフィックスがまだその [キャッシュ有効期間](#cache-lifetime) 内にある場合、次のリクエストは再構築する代わりに古いキャッシュエントリを読み込みます。

183 189 

184<h3 id="denying-an-entire-tool">190<h3 id="denying-an-entire-tool">

185 ツール全体の拒否191 ツール全体の拒否

186</h3>192</h3>

187 193 

188`Bash` または `WebFetch` のような裸のツール名を[拒否ルール](/docs/ja/permissions#manage-permissions)として追加すると、Claude はそのツールを次のリクエストから呼び出すことができなくなります。`/permissions` を通じて追加するか、[設定ファイルを直接編集](/docs/ja/settings#when-edits-take-effect)するかのいずれかです。これには、ターンの途中で `/permissions` を通じて追加するルールが含まれます。194`Bash` や `WebFetch` のような裸のツール名を [拒否ルール](/docs/ja/permissions#manage-permissions) として追加する場合、Claude は `/permissions` を通じてルールを追加するか、[設定ファイルを直接編集](/docs/ja/settings#when-edits-take-effect) するかに関わらず、次のリクエストからそのツールを呼び出すことができません。これには、ターンの途中で `/permissions` を通じて追加するルールも含まれます。

189 195 

190[ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search)がアクティブな場合（サポートされているモデルではデフォルト）、リクエストのツール定義は変更されず、キャッシュされたプレフィックスは保持されます。ツール検索が利用できないか無効になっている場合、Claude Code は次のリクエストから定義を削除し、キャッシュを無効化します。ルールを後で削除する場合も同じです。196[ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) がアクティブな場合（サポートされているモデルのデフォルト）、リクエストのツール定義は変更されず、キャッシュされたプレフィックスは生き残ります。ツール検索が利用不可または無効な場合、Claude Code は定義を次のリクエストから削除し、キャッシュを無効化し、ルールを後で削除してもそうなります。

191 197 

192ツール名の位置で一致する拒否ルールのみがこの効果を持ちます。裸のツール名、同等の `Bash(*)` 形式、または [`"*"` のようなツール名グロブ](/docs/ja/permissions#tool-name-wildcards)です。`"mcp__*"` のような MCP ツールのみに一致するグロブは、同じ方法でそれらのツールをブロックします。`Bash(rm *)` のようなスコープ付き拒否ルール、およびすべての許可とアスクルールは、Claude が見るツールを変更しません。Claude Code は Claude が呼び出しを試みるときにそれらをチェックし、プレフィックスはそのまま保持されます。198この方法でツールをブロックするのは、ツール名の位置で一致する拒否ルールのみです。裸のツール名、同等の `Bash(*)` フォーム、または [ツール名グロブ](/docs/ja/permissions#tool-name-wildcards) （`"*"` など）です。`"mcp__*"` のような MCP ツールのみに一致するグロブは、同じ方法でそれらのツールをブロックします。`Bash(rm *)` のようなスコープ付き拒否ルール、およびすべての許可と質問ルールは、Claude が見るツールを変更しません。Claude Code は Claude が呼び出しを試みるときにそれらをチェックし、プレフィックスはそのまま保持されます。

193 199 

194<h3 id="compacting-the-conversation">200<h3 id="compacting-the-conversation">

195 会話のコンパクト化201 会話のコンパクト化

196</h3>202</h3>

197 203 

198[コンパクト化](/docs/ja/context-window#what-survives-compaction)は、メッセージ履歴を概要に置き換えます。設計上、これは会話レイヤーを無効化します。次のリクエストには、古いものと共通のプレフィックスを共有しない、新しく短い履歴があるためです。Claude Code はシステムプロンプトレイヤーを再利用します。ただし、会話が[そうでなければ変更されるシステムプロンプトを保持しながら再開された](#resuming-a-session)場合を除きます。その場合、最初のコンパクト化は現在のプロンプトに切り替わり、そのレイヤーは 1 回再構築されます。プロジェクトコンテキストをディスクから再読み込みします。これはセッション開始以降 CLAUDE.md とメモリが変更されていない場合にのみキャッシュヒットします。204[コンパクト化](/docs/ja/context-window#what-survives-compaction) はメッセージ履歴を概要に置き換えます。設計上、これは会話レイヤーを無効化します。次のリクエストには、古いものとプレフィックスを共有しない新しい、より短い履歴があるためです。Claude Code はシステムプロンプトレイヤーを再利用します。ただし、会話が [そうでなければ変更されるシステムプロンプトを保持しながら再開された](#resuming-a-session) 場合を除きます。その場合、最初のコンパクト化は現在のプロンプトに切り替わり、そのレイヤーは 1 回再構築されます。ディスクからプロジェクトコンテキストを再読み込みします。これはキャッシュヒットのみ CLAUDE.md とメモリがセッション開始以来変更されていない場合です。

199 205 

200概要を生成するために、Claude Code は会話と同じシステムプロンプト、ツール、および履歴を持つ別のリクエストを送信します。さらに、最終ユーザーメッセージとして追加された要約化指示があります。キャッシュが温かい間、そのリクエストはキャッシュからプレフィックスを読み込むため、セッション中の `/compact` はコンテキストサイズが示唆するコストの一部であり、ほとんどの時間を概要の生成に費やします。206概要を生成するために、Claude Code は会話と同じシステムプロンプト、ツール、および履歴を持つ別のリクエストを送信します。さらに、最終ユーザーメッセージとして追加されたサマリー化命令があります。キャッシュが温かい間、そのリクエストはキャッシュからプレフィックスを読み込むため、セッション中の `/compact` はコンテキストサイズが示唆するコストの一部であり、ほとんどの時間を概要の生成に費やします。

201 207 

202[キャッシュ有効期間](#cache-lifetime)より長い休止の後、読み込むキャッシュは残っていないため、要約化リクエストはキャッシュされていない入力として完全な履歴を再処理します。これが `/compact` が[古いセッションを再開](/docs/ja/sessions#resume-from-a-summary)するときに最もコストがかかる理由です。温かいケースと冷たいケースの両方で、コンパクト化後のターンは、はるかに短い概要のためだけに会話キャッシュを再構築するため、そのターンは遅い部分ではありません。208[キャッシュ有効期間](#cache-lifetime) より長い休止の後、読み込むキャッシュは残っていないため、サマリー化リクエストは完全な履歴をキャッシュされていない入力として再処理します。これが `/compact` が [古いセッションを再開](/docs/ja/sessions#resume-from-a-summary) するときに最もコストがかかる理由です。温かいケースと冷たいケースの両方で、コンパクト化後のターンは、はるかに短い概要のみのために会話キャッシュを再構築するため、そのターンは遅い部分ではありません。

203 209 

204<Tip>210<Tip>

205 コンパクト化は、破棄するコンテキストがもう必要ないコンテンツである場合、あなたに有利に機能します。オーバーヘッドが発生するタイミングを選択するには、タスク間などの作業の自然な区切りで `/compact` を実行します。自動コンパクト化がタスク中にトリガーされるのを待つ代わりに。完全に放棄したいパスを下った場合は、代わりに[`/rewind`](#rewinding-the-conversation)を使用して以前のターンに戻ります。巻き戻しは、コンパクト化が行うように新しいものを構築するのではなく、既にキャッシュされているプレフィックスに切り詰めます。211 コンパクト化は、破棄するコンテキストがもう必要ないコンテンツである場合、あなたに有利に機能します。そのオーバーヘッドが発生するタイミングを選択するには、タスク間などの作業の自然な区切りで `/compact` を実行します。自動コンパクト化がタスク中にトリガーされるのを待つ代わりに。完全に放棄したいパスを下った場合、代わりに [以前のターンに `/ rewind`](#rewinding-the-conversation) してください。巻き戻しは、コンパクト化が行うように新しいものを構築するのではなく、既にキャッシュされているプレフィックスに切り詰めます。

206</Tip>212</Tip>

207 213 

208<h3 id="accumulating-many-images">214<h3 id="accumulating-many-images">

209 多くの画像の蓄積215 多くの画像の蓄積

210</h3>216</h3>

211 217 

212API は、各リクエストが実行できる画像と PDF の数を制限しています。現在の数については、API ドキュメントの[リクエスト制限](https://platform.claude.com/docs/en/build-with-claude/vision#request-limits)を参照してください。Claude Code はリクエスト内の画像と PDF の合計サイズもキャップするため、大きなスクリーンショットは小さいものより少ない画像で制限に達します。218API は各リクエストが実行できる画像と PDF の数を制限します。現在の数については、API ドキュメントの [リクエスト制限](https://platform.claude.com/docs/en/build-with-claude/vision#request-limits) を参照してください。Claude Code はまた、リクエスト内の画像と PDF の合計サイズを制限するため、大きなスクリーンショットは小さいものより少ない画像でリミットに達します。

213 219 

214次のリクエストがいずれかの制限を超える場合、Claude Code は送信する内容から最も古い画像と PDF のバッチを削除します。これにより、再度削除する必要があるまでさらに多くの余地が生まれます。Claude はもう削除された画像を見ることができません。Claude がそれらの 1 つを再度必要とする場合は、再度共有してください。220次のリクエストがいずれかのリミットを超える場合、Claude Code は送信する内容から最も古い画像と PDF のバッチを削除します。これにより、再度削除する必要があるまでさらに多くのスペースが確保されます。Claude はもう削除された画像を見ることができません。Claude がそれらの 1 つを再度必要とする場合、再度共有してください。

215 221 

216画像を削除すると、それらを保持していたメッセージが変更されるため、次のリクエストはそれらのメッセージの最も早いものから会話を再処理します。Claude Code はバッチごとに削除するため、新しいスクリーンショットごとに 1 つではなく、バッチごとに 1 つの遅いターンが表示されます。222画像を削除すると、それらを保持していたメッセージが変更されるため、次のリクエストはそれらのメッセージの最も早いものから会話を再処理します。Claude Code はバッチで一度に削除するため、新しいスクリーンショットごとに 1 つではなく、バッチごとに 1 つの遅いターンが表示されます。

217 223 

218<h3 id="upgrading-claude-code">224<h3 id="upgrading-claude-code">

219 Claude Code のアップグレード225 Claude Code のアップグレード

220</h3>226</h3>

221 227 

222新しい Claude Code バージョンは通常、システムプロンプトまたはツール定義を更新するため、アップグレード後に開始する最初の会話はトップからキャッシュを構築します。[自動更新](/docs/ja/setup#auto-updates)は新しいバージョンをバックグラウンドでダウンロードしますが、次の起動時に適用され、セッション中には決して適用されません。そのため、セッション中の驚きではなく、再起動後のキャッシュされていない最初のターンとしてこれが表示されます。`DISABLE_AUTOUPDATER=1` を設定して、アップグレードが適用されるタイミングを制御します。228新しい Claude Code バージョンは通常、システムプロンプトまたはツール定義を更新するため、アップグレード後に開始する最初の会話はトップからキャッシュを構築します。[自動更新](/docs/ja/setup#auto-updates) は新しいバージョンをバックグラウンドでダウンロードしますが、次の起動時に適用され、セッション中には決して適用されないため、セッション中のサプライズではなく、再起動後のキャッシュされていない最初のターンとしてこれが表示されます。`DISABLE_AUTOUPDATER=1` を設定して、アップグレードが適用されるタイミングを制御します。

223 229 

224<Note>230<Note>

225 アップグレード前に開始した会話を再開するコストについては、[セッションの再開](#resuming-a-session)を参照してください。231 アップグレード前に開始した会話を再開するコストについては、[セッションの再開](#resuming-a-session) を参照してください。

226</Note>232</Note>

227 233 

228<h2 id="actions-that-keep-the-cache">234<h2 id="actions-that-keep-the-cache">

244 リポジトリ内のファイルを編集する250 リポジトリ内のファイルを編集する

245</h3>251</h3>

246 252 

247ファイルの内容は Claude がそれらを読むときにのみコンテキストに入り、読み取りは会話に追加されます。Claude が以前読んだファイルを編集しても、履歴内の以前の読み取りは遡及的に変更されません。代わりに、Claude Code はファイルが変更されたことを示す `<system-reminder>` を追加し、必要に応じて Claude がそれを再度読み取ります。253ファイルの内容は Claude がそれらを読むときにのみコンテキストに入り、読み取りは会話に追加されます。Claude が以前読んだファイルを編集しても、履歴内の以前の読み取りは遡及的に変更されません。代わりに、Claude Code はファイルが変更されたことを示す [`<system-reminder>`](/docs/ja/glossary#system-reminder) を追加し、必要に応じて Claude がそれを再度読み取ります。

248 254 

249<h3 id="editing-claude-md-mid-session">255<h3 id="editing-claude-md-mid-session">

250 セッション中に CLAUDE.md を編集する256 セッション中に CLAUDE.md を編集する

354 キャッシュスコープ360 キャッシュスコープ

355</h2>361</h2>

356 362 

357Claude Code では、キャッシュは事実上 1 つのマシンとディレクトリにスコープされます。各会話は作業ディレクトリ、プラットフォーム、シェル、OS バージョンを保持し、システムプロンプトは自動メモリパスに名前を付けるため、異なるディレクトリの 2 つのセッションは異なるプリフィックスを構築し、互いのキャッシュをミスします。これには同じリポジトリの worktrees が含まれます。各 worktree は独自の作業ディレクトリを持つためです。363Claude Code では、キャッシュは事実上 1 つのマシンとディレクトリにスコープされます。システムプロンプトは自動メモリパスを埋め込み、会話は作業ディレクトリ、プラットフォーム、シェル、OS バージョンのアナウンスで開始されます。異なるディレクトリの 2 つのセッションは、したがって異なるプリフィックスを構築し、互いのキャッシュをミスします。

358 364 

359同じディレクトリで並行して実行するセッションは、一致するプリフィックスを構築し、互いのキャッシュを読み取ります。順序付きセッションは、起動時に取得された git ステータススナップショットが一致する場合にのみプリフィックスを共有します。各会話はそのスナップショットからブランチと最近のコミットも保持するためです。365同じディレクトリで並行して実行するセッションは、一致するプリフィックスを構築し、互いのキャッシュを読み取ります。順序付きセッションは、起動時に取得された git ステータススナップショットが一致する場合にのみプリフィックスを共有します。各会話はそのスナップショットからブランチと最近のコミットも保持するためです。

360 366 

361基礎となる API キャッシュはより広いです。キャッシュは組織間で分離され、一部のプロバイダーでは、[組織内のワークスペース間](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching#cache-storage-and-sharing)で分離されます。これらの境界内で、同じモデルとプリフィックスを持つ 2 つのリクエストは同じキャッシュを読み取ります。自動化されたプロセスのフリートを実行する Agent SDK 呼び出し元については、[ユーザーとマシン間でプロンプトキャッシングを改善](/docs/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines)を参照して、システムプロンプトのマシンごとのセクションを抑制し、マシン間でキャッシュを共有します。367基礎となる API キャッシュはより広いです。キャッシュは組織間で分離され、一部のプロバイダーでは、[組織内のワークスペース間](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching#cache-storage-and-sharing)で分離されます。これらの境界内で、同じモデルとプリフィックスを持つ 2 つのリクエストは同じキャッシュを読み取ります。自動化されたプロセスのフリートを実行する Agent SDK 呼び出し元については、[ユーザーとマシン間でプロンプトキャッシングを改善](/docs/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines)を参照して、自動メモリの場所をシステムプロンプトから移動し、システムプロンプトのキャッシュエントリをユーザーとマシン間で共有します。

362 368 

363<h2 id="check-cache-performance">369<h2 id="check-cache-performance">

364 キャッシュパフォーマンスを確認する370 キャッシュパフォーマンスを確認する

405| 変数 | 効果 |411| 変数 | 効果 |

406| - | - |412| - | - |

407| `DISABLE_PROMPT_CACHING` | すべてのモデルに対して無効にする |413| `DISABLE_PROMPT_CACHING` | すべてのモデルに対して無効にする |

408| `DISABLE_PROMPT_CACHING_HAIKU` | Haiku のみに対して無効にする |414| `DISABLE_PROMPT_CACHING_HAIKU` | デフォルトの Haiku モデルに対して無効にする |

409| `DISABLE_PROMPT_CACHING_SONNET` | Sonnet のみに対して無効にする |415| `DISABLE_PROMPT_CACHING_SONNET` | Sonnet のみに対して無効にする |

410| `DISABLE_PROMPT_CACHING_OPUS` | Opus のみに対して無効にする |416| `DISABLE_PROMPT_CACHING_OPUS` | Opus のみに対して無効にする |

411| `DISABLE_PROMPT_CACHING_FABLE` | Fable のみに対して無効にする |417| `DISABLE_PROMPT_CACHING_FABLE` | Fable のみに対して無効にする |

412 418 

419`DISABLE_PROMPT_CACHING_HAIKU` はデフォルトの Haiku モデル、`haiku` エイリアスが解決するモデルに適用されます。そのモデルがメインモデルである場合のメイン会話を含め、そのモデルが実行される場所ならどこでもキャッシングを無効にします。メイン会話をカバーするには Claude Code v2.1.283 以降が必要です。

420 

421この変数は、メインモデルと異なる場合、非推奨の `ANTHROPIC_SMALL_FAST_MODEL` 変数で設定したバックグラウンドモデルもカバーします。

422 

423メインモデルとしてピン留めした別の Haiku バージョンはキャッシングを保持します。それに対してキャッシングを無効にするには `DISABLE_PROMPT_CACHING` を設定してください。

424 

413組織全体でキャッシングポリシーを設定するには、これらのいずれかまたは [TTL 変数](#cache-lifetime)を [管理設定](/docs/ja/managed-settings)の `env` ブロックに入れます。通常の使用では、キャッシングを有効のままにしてください。425組織全体でキャッシングポリシーを設定するには、これらのいずれかまたは [TTL 変数](#cache-lifetime)を [管理設定](/docs/ja/managed-settings)の `env` ブロックに入れます。通常の使用では、キャッシングを有効のままにしてください。

414 426 

415<h2 id="related-resources">427<h2 id="related-resources">