Documentation — Spybara

admin-setup.md +1 −1

Details

167 167

168* [クイックスタート](/docs/ja/quickstart): インストールからプロジェクトの操作まで、最初のセッションのウォークスルー168* [クイックスタート](/docs/ja/quickstart): インストールからプロジェクトの操作まで、最初のセッションのウォークスルー

169* [一般的なワークフロー](/docs/ja/common-workflows): コードレビュー、リファクタリング、デバッグなどの日常的なタスクのパターン169* [一般的なワークフロー](/docs/ja/common-workflows): コードレビュー、リファクタリング、デバッグなどの日常的なタスクのパターン

170* [Claude 101](https://anthropic.skilljar.com/claude-101) と [Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action): Anthropic Academy の自習型コース170* [Claude Code 101](https://academy.claude.com/courses/claude-code-101) と [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action): [Claude Academy](https://academy.claude.com/) の無料の自習型コース

171 171

172ログインの問題については、開発者に [認証のトラブルシューティング](/docs/ja/troubleshoot-install#login-and-authentication) を指してください。最も一般的な修正は次のとおりです。172ログインの問題については、開発者に [認証のトラブルシューティング](/docs/ja/troubleshoot-install#login-and-authentication) を指してください。最も一般的な修正は次のとおりです。

173 173

advisor.md +6 −6

Details

56* `/advisor opus` などのモデルを使用して `/advisor` を実行して、それを設定します。56* `/advisor opus` などのモデルを使用して `/advisor` を実行して、それを設定します。

57* `/advisor off` を実行してそれをオフにします。57* `/advisor off` を実行してそれをオフにします。

58 58

59Claude Code は、組織の [`availableModels`](/docs/ja/model-config#restrict-model-selection)許可リストが除外した保存済み advisor を呼び出しません。advisor を使用するには、`/advisor` で許可されたモデルを選択してください。Claude Code は、現在のメインモデルがサポートしていない advisor を引き続き保存します。その advisor は、[`/model`](/docs/ja/model-config#setting-your-model)で[互換性のあるメインモデル](#choose-an-advisor-model)に切り替えた後にアクティブになります。59Claude Code は、組織の [`availableModels`](/docs/ja/model-config#restrict-model-selection)許可リストが除外した保存済み advisor を呼び出しません。advisor を使用するには、`/advisor` で許可されたモデルを選択してください。Claude Code は、現在のメインモデルがサポートしていない advisor を引き続き保存します。その advisor は、[`/model`](/docs/ja/model-config#setting-your-model)で[互換性のあるメインモデル](#choose-an-advisor-model)に切り替えた後にアクティブになります。API がすでに現在の会話で保存済み advisor を拒否した場合、モデルを切り替えた後でも、`/clear` または `/compact` まで、それはオフのままです。

60 60

61一部のプランでは、Fable を advisor として使用する場合、Fable の使用を使用クレジットに請求することへの 1 回限りの[同意](/docs/ja/model-config#fable-and-usage-credits)も必要です。その同意を与える前に `/advisor fable` が何をするかについては、[Fable advisor と使用クレジット](#fable-advisor-and-usage-credits)を参照してください。61一部のプランでは、Fable を advisor として使用する場合、Fable の使用を使用クレジットに請求することへの 1 回限りの[同意](/docs/ja/model-config#fable-and-usage-credits)も必要です。その同意を与える前に `/advisor fable` が何をするかについては、[Fable advisor と使用クレジット](#fable-advisor-and-usage-credits)を参照してください。

62 62

98アドバイザーはメインモデル以上の能力を持つ必要があります。各メインモデルで受け入れられるアドバイザーは以下の通りです。98アドバイザーはメインモデル以上の能力を持つ必要があります。各メインモデルで受け入れられるアドバイザーは以下の通りです。

99 99

100| メインモデル | 受け入れられるアドバイザー | 注記 |100| メインモデル | 受け入れられるアドバイザー | 注記 |

101| --------------------- | -------------------------- | ------------------------------------------------------------------------------------- |101| --------------------- | -------------------------- | ------------------------------------------------------------------------ |

103| Sonnet 4.6 | Fable、Opus、Sonnet | |103| Sonnet 4.6 | Fable、Opus、Sonnet | |

110 110

111Fable 5.1 には Claude Code v2.1.257 以降が必要です。両方の Fable モデルには [Fable アクセス](/docs/ja/model-config#work-with-fable) が必要です。111Fable 5.1 には Claude Code v2.1.257 以降が必要です。両方の Fable モデルには [Fable アクセス](/docs/ja/model-config#work-with-fable) が必要です。

112 112

113アドバイザーを `fable`、`opus`、または `sonnet` として設定します。これらのエイリアスは Claude Code の各モデルファミリーの組み込みデフォルトバージョンに解決され、新しい Claude Code リリースで進化します。`claude-opus-5` などの完全なモデル ID を渡すこともできます。113アドバイザーを `fable`、`opus`、または `sonnet` として設定します。これらのエイリアスは Claude Code の各モデルファミリーの組み込みデフォルトバージョンに解決され、新しい Claude Code リリースで進化します。`claude-opus-5-5` などの完全なモデル ID を渡すこともできます。

114 114

115サブエージェントは設定されたアドバイザーを継承し、独自のモデルに対して同じペアリングチェックを適用します。115サブエージェントは設定されたアドバイザーを継承し、独自のモデルに対して同じペアリングチェックを適用します。

116 116

117Claude Code はリクエストを送信する前にペアリングを検証し、API が再度検証します。117Claude Code はリクエストを送信する前にペアリングを検証し、API が再度検証します。

118 118

119* テーブルで拒否されたアドバイザーの場合、Claude Code はそれをメインモデルのリクエストに添付しません。`/advisor` コマンド出力と通知がこれを表示します。独自のモデルがペアリングを満たすサブエージェントは、引き続きアドバイザーを使用できます。119* テーブルで拒否されたアドバイザーの場合、Claude Code はそれをメインモデルのリクエストに添付しません。`/advisor` コマンド出力と通知がこれを表示します。独自のモデルがペアリングを満たすサブエージェントは、引き続きアドバイザーを使用できます。

120* テーブルで API エラーで失敗するとリストされているアドバイザーの場合、Claude Code はそれを添付し、API がそれを拒否します。`/advisor` でアドバイザーを変更するか、オフにするまで、すべてのリクエストが `'<advisor model>' cannot be used as an advisor when the request model is '<main model>'` で失敗します。120* テーブルで API エラーで失敗するとリストされているアドバイザーの場合、Claude Code はそれを添付し、API がそれを拒否します。Claude Code はその後、アドバイザーなしでそのリクエストを再送信し、残りの会話はアドバイザーなしで実行されるため、エラーが表示されず、アドバイザー呼び出しが行われません。`/advisor` で受け入れられたアドバイザーを選択してください。変更は `/clear` または `/compact` の後と新しいセッションで有効になります。

121* メインモデルまたはアドバイザーが Claude Code が認識しないモデルの場合、アドバイザーは添付されません。121* メインモデルまたはアドバイザーが Claude Code が認識しないモデルの場合、アドバイザーは添付されません。

122 122

123<h3 id="fable-advisor-and-usage-credits">123<h3 id="fable-advisor-and-usage-credits">

195 195

196advisor ツールには、以下のすべてが必要です。196advisor ツールには、以下のすべてが必要です。

197 197

198* **Anthropic API のみ**：advisor はサーバー実行ツールです。Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。[LLM ゲートウェイ](/docs/ja/llm-gateway)を通じて `ANTHROPIC_BASE_URL` で構成されている場合、利用可能性はゲートウェイがリクエストを Anthropic API に完全に転送するかどうかに依存します。198* **Anthropic API のみ**：advisor はサーバー実行ツールです。Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。[LLM ゲートウェイ](/docs/ja/llm-gateway)を通じて `ANTHROPIC_BASE_URL` で構成されている場合、利用可能性はゲートウェイがリクエストを Anthropic API に完全に転送するかどうかに依存します。ゲートウェイまたはそのアップストリームが advisor ツールを認識しない場合は、[自動リトライとエラー転送](/docs/ja/llm-gateway-protocol#automatic-retry-and-error-forwarding)を参照して、Claude Code がどのように応答するかを確認してください。

199* **サポートされているメインモデル**：Fable、Opus 4.6 以降、Sonnet 4.6 以降、または Haiku 4.5。[advisor モデルを選択する](#choose-an-advisor-model)を参照して、各 advisor がどのモデルを受け入れるかを確認してください。199* **サポートされているメインモデル**：Fable、Opus 4.6 以降、Sonnet 4.6 以降、または Haiku 4.5。[advisor モデルを選択する](#choose-an-advisor-model)を参照して、各 advisor がどのモデルを受け入れるかを確認してください。

200* **フィーチャーフラグ取得**：Claude Code は Anthropic から取得するフィーチャーフラグを通じて advisor をオンにします。`DISABLE_TELEMETRY` など、フラグ取得をオフにする変数が設定されているセッションでは、advisor はオフのままです。[フィーチャーフラグ取得が必要な機能](/docs/ja/env-vars#features-that-need-feature-flag-fetching)を参照してください。200* **フィーチャーフラグ取得**：Claude Code は Anthropic から取得するフィーチャーフラグを通じて advisor をオンにします。`DISABLE_TELEMETRY` など、フラグ取得をオフにする変数が設定されているセッションでは、advisor はオフのままです。[フィーチャーフラグ取得が必要な機能](/docs/ja/env-vars#features-that-need-feature-flag-fetching)を参照してください。

201 201

agent-sdk/configuration.md +3 −1

Details

189TypeScript には `applyFlagSettings()` と `updateSettings()` もあります：189TypeScript には `applyFlagSettings()` と `updateSettings()` もあります：

190 190

191* **`applyFlagSettings()`**：`await session.applyFlagSettings({ effortLevel: "high" })` のように実行時に設定を適用します。メソッドは options フィールドではなく設定ファイルキーを取るため、スキーマについては [`applyFlagSettings()` リファレンス](/docs/ja/agent-sdk/typescript#applyflagsettings)を確認し、どのキーがセッション中に有効になるかを確認してください。191* **`applyFlagSettings()`**：`await session.applyFlagSettings({ effortLevel: "high" })` のように実行時に設定を適用します。メソッドは options フィールドではなく設定ファイルキーを取るため、スキーマについては [`applyFlagSettings()` リファレンス](/docs/ja/agent-sdk/typescript#applyflagsettings)を確認し、どのキーがセッション中に有効になるかを確認してください。

192* **`updateSettings()`**：`await session.updateSettings("localSettings", { outputStyle: "Explanatory" })` のように、許可リストに登録されたキーセットをプロジェクトのローカル設定ファイルに書き込みます。書き込まれたキーはセッションの次のリクエストで有効になり、`local` 設定を読み込む後のセッションに対して永続化されます。メソッドの行は [メソッドテーブル](/docs/ja/agent-sdk/typescript#methods)で許可リストに登録されたキーとバージョンフロアに名前を付けます。192* **`updateSettings()`**：許可リストに登録されたキーを設定ファイルに書き込みます。[`updateSettings()` リファレンス](/docs/ja/agent-sdk/typescript#updatesettings)は各ソースが受け入れるキーとバージョンフロアに名前を付けます。

193 * `"localSettings"` を渡して、プロジェクトのローカル設定ファイルに書き込みます。`await session.updateSettings("localSettings", { outputStyle: "Explanatory" })` のように使用します。書き込まれたキーはセッションの次のリクエストで有効になり、`local` 設定を読み込む後のセッションに対して永続化されます。

194 * `"userSettings"` を渡して、このソースが受け入れる唯一のキーである `effortLevel` を書き込みます。Claude Code はそれをセッションの現在のモデルのデフォルト努力レベルとして保存し、実行中のセッションの努力は変わりません。

193 195

194以下の例は 2 ターンセッションを実行し、ターン間で設定を変更し、各ターンに答えたモデルを出力します。TypeScript では、プロンプトストリームは 2 番目のメッセージをセッターが実行されるまで保持し、2 番目のターンは新しいモデルで実行されます。196以下の例は 2 ターンセッションを実行し、ターン間で設定を変更し、各ターンに答えたモデルを出力します。TypeScript では、プロンプトストリームは 2 番目のメッセージをセッターが実行されるまで保持し、2 番目のターンは新しいモデルで実行されます。

195 197

agent-sdk/cost-tracking.md +31 −21

Details

37 37

38* **`query()` 呼び出し：** SDK の `query()` 関数の 1 回の呼び出し。単一の呼び出しは複数のステップを含むことができます。Claude が応答し、ツールを使用し、結果を取得し、再度応答します。各呼び出しは最後に 1 つの [`result`](/docs/ja/agent-sdk/typescript#sdkresultmessage) メッセージを生成します。ただし、[ストリーミング入力モード](/docs/ja/agent-sdk/streaming-vs-single-mode)では、1 つの `query()` 呼び出しが複数のユーザーターンを実行し、各ターンが独自の `result` メッセージを発行します。38* **`query()` 呼び出し：** SDK の `query()` 関数の 1 回の呼び出し。単一の呼び出しは複数のステップを含むことができます。Claude が応答し、ツールを使用し、結果を取得し、再度応答します。各呼び出しは最後に 1 つの [`result`](/docs/ja/agent-sdk/typescript#sdkresultmessage) メッセージを生成します。ただし、[ストリーミング入力モード](/docs/ja/agent-sdk/streaming-vs-single-mode)では、1 つの `query()` 呼び出しが複数のユーザーターンを実行し、各ターンが独自の `result` メッセージを発行します。

39* **ステップ：** `query()` 呼び出し内の単一のリクエスト/レスポンスサイクル。各ステップはトークン使用量を含むアシスタントメッセージを生成します。39* **ステップ：** `query()` 呼び出し内の単一のリクエスト/レスポンスサイクル。各ステップはトークン使用量を含むアシスタントメッセージを生成します。

40* **セッション：** セッション ID でリンクされた一連の `query()` 呼び出し（`resume` オプションを使用）。セッション内の各 `query()` 呼び出しは、独立してそれ自身のコストを報告します。40* **セッション：** セッション ID でリンクされた一連の `query()` 呼び出し（`resume` オプションを使用）。セッションを再開した呼び出しの結果は、その呼び出し自体だけでなく、セッション全体の支出を報告します。複数の呼び出しにわたってコストを累積する方法については、[複数の呼び出しにわたってコストを累積する](#accumulate-costs-across-multiple-calls)を参照してください。

41 41

42次の図は、単一の `query()` 呼び出しからのメッセージストリームを示しており、各ステップでトークン使用量が報告され、最後に累積推定値が表示されます。42次の図は、単一の `query()` 呼び出しからのメッセージストリームを示しており、各ステップでトークン使用量が報告され、最後に累積推定値が表示されます。

43 43

51 </Step>51 </Step>

52 52

53 <Step title="結果メッセージは累積推定値を提供します">53 <Step title="結果メッセージは累積推定値を提供します">

54 `query()` 呼び出しが完了すると、SDK は `total_cost_usd` と累積 `usage` を含む結果メッセージを発行します。TypeScript では [`SDKResultMessage`](/docs/ja/agent-sdk/typescript#sdkresultmessage) として型付けされ、Python では [`ResultMessage`](/docs/ja/agent-sdk/python#resultmessage) として型付けされます。複数の `query()` 呼び出しを行う場合（例えば、マルチターンセッションで）、各結果はその個別の呼び出しのコストのみを反映します。推定合計のみが必要な場合は、ステップごとの使用量を無視して、この単一の値を読むことができます。54 `query()` 呼び出しが完了すると、SDK は `total_cost_usd` と累積 `usage` を含む結果メッセージを発行します。TypeScript では [`SDKResultMessage`](/docs/ja/agent-sdk/typescript#sdkresultmessage) として型付けされ、Python では [`ResultMessage`](/docs/ja/agent-sdk/python#resultmessage) として型付けされます。推定合計のみが必要な場合は、ステップごとの使用量を無視して、この単一の値を読むことができます。

55 55

56 ストリーミング入力モードでは、各ターンが独自の結果メッセージを発行します。ストリーミング入力モードでコール合計を読む方法については、[ストリーミング入力モードでコストを追跡する](#track-costs-in-streaming-input-mode)を参照してください。56 複数の独立した `query()` 呼び出しを行う場合、各結果はその個別の呼び出しのコストのみを反映します。セッションを再開した呼び出しは、セッションの以前の支出もカウントします。

58 ストリーミング入力モードでは、各ターンが独自の結果メッセージを発行します。そのモードでコール合計を読む方法については、[ストリーミング入力モードでコストを追跡する](#track-costs-in-streaming-input-mode)を参照してください。

57 </Step>59 </Step>

58</Steps>60</Steps>

59 61

64[ストリーミング入力モード](/docs/ja/agent-sdk/streaming-vs-single-mode)では、1 つの `query()` 呼び出しが複数のユーザーターンを実行し、各ターンが独自の結果メッセージを出力します。結果フィールドのスコープは異なります。66[ストリーミング入力モード](/docs/ja/agent-sdk/streaming-vs-single-mode)では、1 つの `query()` 呼び出しが複数のユーザーターンを実行し、各ターンが独自の結果メッセージを出力します。結果フィールドのスコープは異なります。

65 67

66* **`usage`**: そのターンのみをカバーし、その中でもメインエージェントループのみで、実行したサブエージェントはカバーしません。68* **`usage`**: そのターンのみをカバーし、その中でもメインエージェントループのみで、実行したサブエージェントはカバーしません。

~~67* **`total_cost_usd` と `modelUsage`、または Python の `model_usage`**: これまでの呼び出し全体の実行合計を保持します。~~69* **`total_cost_usd` と `modelUsage`、または Python の `model_usage`**: これまでの呼び出し全体の実行合計を保持し、呼び出しがセッションを再開したときに復元されたすべての支出を含みます。

68 70

69アプリが `/clear`、`/reset`、または `/new` を送信しない呼び出しでは、結果全体を合計するのではなく、最新の結果を読んで呼び出し合計を取得してください。71アプリが `/clear`、`/reset`、または `/new` を送信しない呼び出しでは、結果全体を合計するのではなく、最新の結果を読んで呼び出し合計を取得してください。

70 72

78 80

79TypeScript では、SDK は各リセットで [`SDKConversationResetMessage`](/docs/ja/agent-sdk/typescript#sdkconversationresetmessage) も出力するため、ストリームからリセットを検出できます。Python では、SDK は同様に `ConversationResetMessage` を出力します。Python SDK v0.2.137 より前では、Python イテレータはそのメッセージをドロップしたため、これらのバージョンではアプリが送信する `/clear` ターンからリセットを自分でカウントしてください。81TypeScript では、SDK は各リセットで [`SDKConversationResetMessage`](/docs/ja/agent-sdk/typescript#sdkconversationresetmessage) も出力するため、ストリームからリセットを検出できます。Python では、SDK は同様に `ConversationResetMessage` を出力します。Python SDK v0.2.137 より前では、Python イテレータはそのメッセージをドロップしたため、これらのバージョンではアプリが送信する `/clear` ターンからリセットを自分でカウントしてください。

80 82

~~81`maxBudgetUsd`、または Python の `max_budget_usd` は同じ実行合計と比較されるため、`/clear` はバジェットもリセットします。~~83`maxBudgetUsd`（TypeScript）または `max_budget_usd`（Python）は呼び出し自体の支出のみをカウントします。再開されたセッションから復元された合計はカウントされず、`/clear` はバジェットをリセットします。

82 84

83<h2 id="get-the-total-cost-of-a-query">85<h2 id="get-the-total-cost-of-a-query">

84 クエリの総コストを取得する86 クエリの総コストを取得する

85</h2>87</h2>

86 88

87結果メッセージは、TypeScript では [`SDKResultMessage`](/docs/ja/agent-sdk/typescript#sdkresultmessage) として、Python では [`ResultMessage`](/docs/ja/agent-sdk/python#resultmessage) として型付けされており、`query()` 呼び出しのエージェントループの終了を示します。これには `total_cost_usd` が含まれており、その呼び出し内のすべてのステップにわたる累積推定コストです。Python ではこのフィールドはオプションとして型付けされているため、読み取る前に `None` でないことを確認してください。成功結果とエラー結果の両方がこれを含みますが、[セッションクラッシュ後の総コストの復旧](#recover-totals-after-a-session-crash)の最終結果はゼロになる可能性があります。89結果メッセージは、TypeScript では [`SDKResultMessage`](/docs/ja/agent-sdk/typescript#sdkresultmessage) として、Python では [`ResultMessage`](/docs/ja/agent-sdk/python#resultmessage) として型付けされており、`query()` 呼び出しのエージェントループの終了を示します。これには `total_cost_usd` が含まれており、その呼び出し内のすべてのステップにわたる累積推定コストです。セッションを再開する呼び出しは、セッションの以前の支出もカウントします。値を読み取る場合、2 つの注意事項が適用されます。

91* Python ではフィールドはオプションとして型付けされているため、読み取る前に `None` でないことを確認してください。

92* 成功結果とエラー結果の両方がこれを含みますが、[セッションクラッシュ後の総コストの復旧](#recover-totals-after-a-session-crash)の最終結果はゼロになる可能性があります。

88 93

89セッションを使用して複数の `query()` 呼び出しを行う場合、各結果はその個別の呼び出しのコストのみを反映します。ストリーミング入力モードでは、[ストリーミング入力モードでのコスト追跡](#track-costs-in-streaming-input-mode)で説明されているように呼び出し総額を読み取ります。94ストリーミング入力モードでは、[ストリーミング入力モードでのコスト追跡](#track-costs-in-streaming-input-mode)で説明されているように呼び出し総額を読み取ります。

90 95

913 つの結果レベルのフィールドは、エージェントが [サブエージェント](/docs/ja/agent-sdk/subagents) を生成する場合に何をカウントするかが異なります。ツリー全体のトークンアカウンティングには `modelUsage` または Python では `model_usage` を使用してください。`usage` フィールドはネストが発生するとすぐに過小カウントされます。963 つの結果レベルのフィールドは、エージェントが [サブエージェント](/docs/ja/agent-sdk/subagents) を生成する場合に何をカウントするかが異なります。ツリー全体のトークンアカウンティングには `modelUsage` または Python では `model_usage` を使用してください。`usage` フィールドはネストが発生するとすぐに過小カウントされます。

92 97

232 複数の呼び出しにわたってコストを累積する237 複数の呼び出しにわたってコストを累積する

233</h2>238</h2>

234 239

235各 `query()` 呼び出しは独自の `total_cost_usd` を返します。SDK はセッションレベルの合計を提供しないため、アプリケーションが複数の `query()` 呼び出しを行う場合（例えば、マルチターンセッションや異なるユーザー間）、合計を自分で累積する必要があります。ストリーミング入力モードでは、[ストリーミング入力モードでコストを追跡する](#track-costs-in-streaming-input-mode)で説明されているように各呼び出しの合計を読み取ります。セッションクラッシュで終了した呼び出しについては、[セッションクラッシュ後に合計を復旧する](#recover-totals-after-a-session-crash)を参照してください。240各 `query()` 呼び出しは結果に対して `total_cost_usd` を返します。値の組み合わせ方は、呼び出しがセッションを共有するかどうかによって異なります。

241

242* **`resume` または `continue` オプションのない独立した呼び出し**：各結果は独自の呼び出しのみをカバーするため、以下の例のように合計を自分で追加する必要があります。

243* **同じセッションを再開する呼び出し**：Claude Code はプロセスが正常に終了するときにセッションの合計を[トランスクリプト](/docs/ja/sessions#where-transcripts-are-stored)に保存し、後の呼び出しがセッションを再開またはフォークするときに復元します。各結果には既にセッションの以前の支出が含まれています。セッション合計については最新の結果を読み取ります。結果を合計すると、復元された支出が二重計算されます。v2.1.277 より前では、SDK または `claude -p` を通じて再開したセッションは合計をゼロで開始したため、各呼び出しの結果はその呼び出しのみをカバーしていました。

244

245ストリーミング入力モードでは、[ストリーミング入力モードでコストを追跡する](#track-costs-in-streaming-input-mode)で説明されているように各呼び出しの合計を読み取ります。セッションクラッシュで終了した呼び出しについては、[セッションクラッシュ後に合計を復旧する](#recover-totals-after-a-session-crash)を参照してください。

236 246

237以下の例は、2 つの `query()` 呼び出しを順次実行し、各呼び出しの `total_cost_usd` を実行中の合計に追加し、呼び出しごとの合計と組み合わせた合計の両方を出力します。247以下の例は、2 つの `query()` 呼び出しを順次実行し、各呼び出しの `total_cost_usd` を実行中の合計に追加し、呼び出しごとの合計と組み合わせた合計の両方を出力します。

238 248

330* **[セッションクラッシュ後の `error_during_execution`](#recover-totals-after-a-session-crash)**: すべてのコストフィールドがゼロになる可能性があります。340* **[セッションクラッシュ後の `error_during_execution`](#recover-totals-after-a-session-crash)**: すべてのコストフィールドがゼロになる可能性があります。

331* **`error_max_budget_usd`**: `usage` は予算を超えたレスポンスを除外しますが、`total_cost_usd` と `modelUsage` はそれを含みます。341* **`error_max_budget_usd`**: `usage` は予算を超えたレスポンスを除外しますが、`total_cost_usd` と `modelUsage` はそれを含みます。

332 342

333選択肢がある場合は、`usage` ではなく `total_cost_usd` または `modelUsage` から計算してください。343選択肢がある場合は、`usage` ではなく `total_cost_usd` または `modelUsage` から計上してください。

334 344

335<h3 id="recover-totals-after-a-session-crash">345<h3 id="recover-totals-after-a-session-crash">

336 セッションクラッシュ後に合計を復旧する346 セッションクラッシュ後に合計を復旧する

337</h3>347</h3>

338 348

339Claude Code プロセスがクラッシュすると、最終的な `error_during_execution` 結果を発行して終了します。シングルショットモードとストリーミング入力モードの両方で同様です。その結果は `usage`、`total_cost_usd`、および `modelUsage` がゼロになる可能性があるため、それより前に到着したものから呼び出しの合計を復旧してください。ステップ 1 は以前の結果が存在するときはいつでも完全な合計を復旧します。ステップ 2 のフォールバックはメインループの入力とキャッシュトークンのみを復旧します。349Claude Code プロセスがクラッシュすると、最終的な `error_during_execution` 結果を発行して終了します。シングルショットモードとストリーミング入力モードの両方で同様です。その結果は `usage`、`total_cost_usd`、および `modelUsage` がゼロになる可能性があるため、それより前に到着したものから呼び出しの合計を復旧してください。ステップ 1 は、以前の結果が存在する場合はいつでも完全な合計を復旧します。ステップ 2 のフォールバックは、メインループの入力とキャッシュトークンのみを復旧します。

340 350

3411. クラッシュの前のターンの結果を使用します。ストリーミング入力モードでは、呼び出しの開始以降またはそれ以降の実行中の合計を保持します。その結果があなたを助けることができない場合はステップ 2 に進んでください。3511. クラッシュの前のターンの結果を使用します。ストリーミング入力モードでは、[ストリーミング入力モードでコストを追跡する](#track-costs-in-streaming-input-mode)で説明されている実行中の合計を保持しています。その結果が役に立たない場合はステップ 2 に進んでください。

342 * 呼び出しはシングルショットであるため、以前の結果は存在しません。352 * 呼び出しはシングルショットであるため、以前の結果は存在しません。

343 * クラッシュは最初のターンで発生しました。353 * クラッシュは最初のターンで発生しました。

344 * クラッシュの前のターンは `/clear` 自体であったため、その結果はリセットのみをカバーしています。354 * クラッシュの前のターンは `/clear` 自体であったため、その結果はリセットのみをカバーしています。

3452. 代わりにアシスタントメッセージの `usage` を合計し、各 API レスポンスを 1 回カウントします。[ステップごとの使用状況を追跡する](#track-per-step-usage)例が行うように。シングルショットモードでは、すべてを合計します。ストリーミング入力モードでは、最後の結果の後に到着したものを合計します。これにより、メインループの入力とキャッシュトークンが得られます。サブエージェントの使用状況はこの方法では復旧できず、出力トークンや USD コストも復旧できません。[ステップごとの `output_tokens` はプレースホルダー](#read-output-tokens-from-the-result-message)であるためです。3552. 代わりに、アシスタントメッセージの `usage` を合計し、各 API レスポンスを 1 回カウントします。[ステップごとの使用状況を追跡する](#track-per-step-usage)の例が行うように。シングルショットモードでは、すべてを合計します。ストリーミング入力モードでは、最後の結果の後に到着したものを合計します。これにより、メインループの入力とキャッシュトークンが得られます。サブエージェントの使用状況はこの方法では復旧できず、出力トークンや USD コストも復旧できません。[ステップごとの `output_tokens` はプレースホルダー](#read-output-tokens-from-the-result-message)であるためです。

346 356

347<h3 id="track-cache-tokens">357<h3 id="track-cache-tokens">

348 キャッシュトークンを追跡する358 キャッシュトークンを追跡する

349</h3>359</h3>

350 360

351Agent SDK は自動的に[プロンプトキャッシング](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)を使用して、繰り返されるコンテンツのコストを削減します。キャッシングを自分で設定する必要はありません。使用状況オブジェクトには、キャッシュ追跡用の 2 つの追加フィールドが含まれています。361Agent SDK は、繰り返されるコンテンツのコストを削減するために、[プロンプトキャッシング](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)を自動的に使用します。キャッシングを自分で設定する必要はありません。使用状況オブジェクトには、キャッシュ追跡用の 2 つの追加フィールドが含まれています。

352 362

353* `cache_creation_input_tokens`: 新しいキャッシュエントリを作成するために使用されたトークン（標準入力トークンより高いレートで課金されます）。363* `cache_creation_input_tokens`: 新しいキャッシュエントリを作成するために使用されたトークン（標準入力トークンより高いレートで課金されます）。

354* `cache_read_input_tokens`: 既存のキャッシュエントリから読み取られたトークン（削減されたレートで課金されます）。364* `cache_read_input_tokens`: 既存のキャッシュエントリから読み取られたトークン（削減されたレートで課金されます）。

359 プロンプトキャッシュ TTL を 1 時間に延長する369 プロンプトキャッシュ TTL を 1 時間に延長する

360</h3>370</h3>

361 371

362あなた自身のターンは、[メイン会話 TTL バケット](/docs/ja/prompt-caching#which-ttl-each-request-gets)に分類されます。Claude Code がそれらと一緒にインラインで実行するヘルパーと共に。Claude Code が会話外で行う要求（[サブエージェント](/docs/ja/agent-sdk/subagents)など）には、[別の TTL 制御](/docs/ja/prompt-caching#choose-the-ttl-yourself)があります。372独自のターンは、[メイン会話 TTL バケット](/docs/ja/prompt-caching#which-ttl-each-request-gets)に分類されます。Claude Code がそれらと一緒にインラインで実行するヘルパーと共に。Claude Code が会話外で行う要求（[サブエージェント](/docs/ja/agent-sdk/subagents)など）には、[別の TTL 制御](/docs/ja/prompt-caching#choose-the-ttl-yourself)があります。

363 373

364あなた自身のターンのキャッシュエントリは、API キーで認証するか、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または [AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws)で実行する場合、デフォルトで 5 分の TTL を使用します。ワークロードが同じシステムプロンプトとコンテキストに対して多くの短いセッションを実行し、セッション間に 5 分以上のギャップがある場合、キャッシュはセッション間で期限切れになり、各新しいセッションは完全な入力価格を支払います。374独自のターンのキャッシュエントリは、API キーで認証するか、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または [AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws) で実行する場合、デフォルトで 5 分の TTL を使用します。ワークロードが同じシステムプロンプトとコンテキストに対して多くの短いセッションを実行し、セッション間に 5 分以上のギャップがある場合、キャッシュはセッション間で期限切れになり、各新しいセッションは完全な入力価格を支払います。

365 375

366キャッシュ書き込みで 1 時間の TTL をリクエストするには、[`ENABLE_PROMPT_CACHING_1H`](/docs/ja/env-vars)環境変数を設定します。シェルまたはコンテナ環境でエクスポートするか、`options.env` を通じて渡すことができます。376キャッシュ書き込みで 1 時間の TTL をリクエストするには、[`ENABLE_PROMPT_CACHING_1H`](/docs/ja/env-vars) 環境変数を設定します。シェルまたはコンテナ環境でエクスポートするか、`options.env` を通じて渡すことができます。

367 377

368次の例は、Amazon Bedrock で実行されているエージェントの 1 時間 TTL を有効にします。`CLAUDE_CODE_USE_BEDROCK` を設定するため、[Amazon Bedrock](/docs/ja/amazon-bedrock)の動作する AWS 認証情報が必要です。それらがない場合、クエリは失敗します。378次の例は、Amazon Bedrock で実行されているエージェントの 1 時間 TTL を有効にします。`CLAUDE_CODE_USE_BEDROCK` を設定するため、[Amazon Bedrock](/docs/ja/amazon-bedrock) の動作する AWS 認証情報が必要です。それらがない場合、クエリは失敗します。

369 379

370<CodeGroup>380<CodeGroup>

371 ```python Python theme={null}381 ```python Python theme={null}

405 ```415 ```

406</CodeGroup>416</CodeGroup>

407 417

4081 時間の TTL でのキャッシュ書き込みは、5 分の書き込みより高いレートで課金されるため、これを有効にすると、より高い書き込みコストとより多くのキャッシュ読み取りがトレードオフされます。詳細については、[プロンプトキャッシング価格](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)を参照してください。Claude サブスクリプション内でプランの含まれた使用状況では、この変数を設定せずに、あなた自身のターンで 1 時間の TTL を取得し、Claude Code がそれらの横で行うヘルパー要求の一部でも取得します。Claude Code は、[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を引き出すと、これらのターンを 5 分の TTL に落とします。4181 時間の TTL でのキャッシュ書き込みは、5 分の書き込みより高いレートで課金されるため、これを有効にすると、より高い書き込みコストとより多くのキャッシュ読み取りがトレードオフされます。詳細については、[プロンプトキャッシング価格](https://platform.claude.com/docs/en/build-with-claude/prompt-caching)を参照してください。プランの含まれる使用量内の Claude サブスクリプションでは、この変数を設定せずに独自のターンで 1 時間の TTL を取得し、Claude Code がそれらのターンを 5 分の TTL に削除するのは、[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を引き出しているときです。

409 419

410`ENABLE_PROMPT_CACHING_1H` は、両方のバケット内のすべてのリクエストで 1 時間の TTL をリクエストします。各バケットの TTL を個別に選択するには、代わりにこれらの制御を使用してください。それぞれは `5m` または `1h` を取り、`ENABLE_PROMPT_CACHING_1H` より優先されます。420`ENABLE_PROMPT_CACHING_1H` は、両方のバケット内のすべてのリクエストで 1 時間の TTL をリクエストします。各バケットの TTL を個別に選択するには、代わりにこれらの制御を使用してください。それぞれは `5m` または `1h` を取り、`ENABLE_PROMPT_CACHING_1H` より優先されます。

411 421

412* メイン会話: `CLAUDE_CODE_PROMPT_CACHE_TTL` [環境変数](/docs/ja/env-vars)、または [`promptCacheTtl`](/docs/ja/settings-reference#promptcachettl)設定422* メイン会話: `CLAUDE_CODE_PROMPT_CACHE_TTL` [環境変数](/docs/ja/env-vars)、または [`promptCacheTtl`](/docs/ja/settings-reference#promptcachettl) 設定

413* その他すべて: `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` 環境変数、または [`subagentPromptCacheTtl`](/docs/ja/settings-reference#subagentpromptcachettl)設定423* その他すべて: `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` 環境変数、または [`subagentPromptCacheTtl`](/docs/ja/settings-reference#subagentpromptcachettl) 設定

414 424

415`promptCacheTtl` を `1h` に設定すると、[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を引き出している間、メイン会話で 1 時間のキャッシュを保持します。完全な優先順位については、[TTL を自分で選択する](/docs/ja/prompt-caching#choose-the-ttl-yourself)を参照してください。425`promptCacheTtl` を `1h` に設定すると、使用クレジットを引き出しているときにメイン会話で 1 時間のキャッシュを保持します。完全な優先順位については、[TTL を自分で選択する](/docs/ja/prompt-caching#choose-the-ttl-yourself)を参照してください。

416 426

417<h2 id="related-documentation">427<h2 id="related-documentation">

418 関連ドキュメント428 関連ドキュメント

agent-sdk/hosting.md +1 −1

Details

10 10

11このページは独自のインフラストラクチャでのセルフホスティングについて説明しています。デプロイ可能な Dockerfile と Kubernetes マニフェストについては、[ホスティングクックブック](https://github.com/anthropics/claude-cookbooks/tree/main/claude_agent_sdk/hosting)を参照してください。11このページは独自のインフラストラクチャでのセルフホスティングについて説明しています。デプロイ可能な Dockerfile と Kubernetes マニフェストについては、[ホスティングクックブック](https://github.com/anthropics/claude-cookbooks/tree/main/claude_agent_sdk/hosting)を参照してください。

12 12

13インフラストラクチャ制御、カスタム分離、または独自のデータプレーンが不要な場合は、[Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) の使用を検討してください。これは Anthropic がエージェントとサンドボックスを実行するホスト型 REST API であり、アプリケーションはイベントを送信して結果をストリーミングで受け取ることができます。ホスティングインフラストラクチャを運用する必要はありません。13エージェントループ自体を独自のインフラストラクチャで実行する必要がない場合は、[Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) の使用を検討してください。Anthropic がエージェントループをホストし、アプリケーションはクライアント SDK または REST API を通じてイベントを送信し、ストリーミング結果を受け取ります。ツール実行は Anthropic 管理クラウドサンドボックスまたは独自のインフラストラクチャ上の[セルフホスト型サンドボックス](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes)で実行されます。

14 14

15<h2 id="the-subprocess-model">15<h2 id="the-subprocess-model">

16 サブプロセスモデル16 サブプロセスモデル

agent-sdk/modifying-system-prompts.md +4 −0

Details

387* マーカーを複数回含める場合、最初のものが分割であり、SDK は他のものを削除します。387* マーカーを複数回含める場合、最初のものが分割であり、SDK は他のものを削除します。

388* マーカーを除外する場合、SDK はすべての文字列を 1 つのブロックに結合します。これは 1 つの文字列を渡すのと同じです。388* マーカーを除外する場合、SDK はすべての文字列を 1 つのブロックに結合します。これは 1 つの文字列を渡すのと同じです。

389 389

390CLI の [`--system-prompt` または `--system-prompt-file` フラグ](/docs/ja/cli-reference#system-prompt-flags) では、プロンプトは 1 つの文字列であるため、マーカーを含む配列はありません。静的部分とリクエストごとの部分の間に `__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` のみを含む行を含めます。Claude Code はプロンプトを最初のそのような行で同じ 2 つのブロックに分割し、その行を削除します。Claude Code v2.1.275 以降が必要です。

391

392SDK では、配列形式を推奨します。これはマーカー行なしで境界を含みます。

393

390<h3 id="change-the-prompt-of-an-existing-session">394<h3 id="change-the-prompt-of-an-existing-session">

391 既存のセッションのプロンプトを変更する395 既存のセッションのプロンプトを変更する

392</h3>396</h3>

agent-sdk/overview.md +8 −8

Details

12 Agent SDK と他の Claude ツールの比較12 Agent SDK と他の Claude ツールの比較

13</h2>13</h2>

14 14

15Agent SDK、CLI、Client SDK、および Managed Agents はそれぞれ異なるニーズに対応しています。構築しているものに合致するツールを見つけるために、表を使用してください。15Agent SDK、CLI、Client SDK、および Managed Agents は、エージェントを実行するのは誰か、何が組み込まれているか、どのようにアクセスするかが異なります。構築して実行する方法に合致する行を見つけてください。

16 16

17| 対象 | 使用するツール | 理由 |17| 対象 | 使用するツール | 取得内容 |

18| ----------------------------------------------------------- | --------------------------------------------------------------------------------- | --------------------------------------------------------------------- |18| ------------------------------------------------------------------------ | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

21| API を直接呼び出し、ツールループを自分で実装している | [**Client SDK**](https://platform.claude.com/docs/en/api/client-sdks) | Claude Code ではなく Anthropic API への直接アクセス。ツールループを自分で実装します。 |21| 独自のコードから Claude API を直接呼び出す | [**Client SDK**](https://platform.claude.com/docs/en/cli-sdks-libraries/overview) | クライアント SDK 言語のいずれからでも Claude API に直接アクセスできます。ツールループを自分で記述するか、クライアント SDK のベータ版[ツールランナー](https://platform.claude.com/docs/en/agents-and-tools/tool-use/tool-runner)に駆動させることができます。 |

22| 独自のサンドボックスまたはセッションインフラストラクチャを管理せずに、長時間実行または非同期エージェントを実行している | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | ホストされた REST API で、Agent SDK とは別の製品です。Anthropic がエージェントとサンドボックスを実行します。 |22| Anthropic がエージェントをホストし、Claude API を通じて構成する | [**Managed Agents**](https://platform.claude.com/docs/en/managed-agents/overview) | エージェントループを実行するホストされたエージェントハーネスで、Anthropic が管理するクラウドサンドボックスまたは独自のインフラストラクチャ上の[セルフホストサンドボックス](https://platform.claude.com/docs/en/managed-agents/self-hosted-sandboxes)のセッションを備えています。[言語用の SDK](https://platform.claude.com/docs/en/managed-agents/quickstart#install-the-sdk)、`ant` CLI、または REST API から使用できます。 |

23 23

24SDK は Python と TypeScript のライブラリとしてのみ利用可能です。別の言語から同じエージェントループを駆動するには、[`-p` フラグと `--output-format json` を使用して CLI をサブプロセスとして実行](/docs/ja/headless)してください。24Python または TypeScript 以外の言語から同じエージェントループを駆動するには、[`-p` フラグと `--output-format json` を使用して CLI をサブプロセスとして実行](/docs/ja/headless)してください。

25 25

26<h2 id="capabilities">26<h2 id="capabilities">

27 機能27 機能

agent-sdk/python.md +13 −31

Details

909| `disallowed_tools` | `list[str]` | `[]` | 拒否するツール。`"Bash"`のような単純な名前はClaudeのコンテキストからツールを削除します。`"Bash(rm *)"`のようなスコープ付きルールはツールを利用可能なままにし、`bypassPermissions`を含むすべての権限モードで、[書かれたとおりの](/docs/ja/permissions#bash-rule-limits)コマンドの一致する呼び出しを拒否します。[権限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照してください |909| `disallowed_tools` | `list[str]` | `[]` | 拒否するツール。`"Bash"`のような単純な名前はClaudeのコンテキストからツールを削除します。`"Bash(rm *)"`のようなスコープ付きルールはツールを利用可能なままにし、`bypassPermissions`を含むすべての権限モードで、[書かれたとおりの](/docs/ja/permissions#bash-rule-limits)コマンドの一致する呼び出しを拒否します。[権限](/docs/ja/agent-sdk/permissions#allow-and-deny-rules)を参照してください |

1487`ClaudeAgentOptions`の`betas`フィールドで使用して、ベータ機能を有効にします。1487`ClaudeAgentOptions`の`betas`フィールドで使用して、ベータ機能を有効にします。

1488 1488

1489<Warning>1489<Warning>

1490 `context-1m-2025-08-07`ベータは2026年4月30日の時点で廃止されました。このヘッダーをClaude Sonnet 4.5またはSonnet 4で渡すと効果がなく、標準200kトークンコンテキストウィンドウを超えるリクエストはエラーを返します。1Mトークンコンテキストウィンドウを使用するには、[Claude Opus 5、Claude Sonnet 5、Claude Sonnet 4.6、Claude Opus 4.6、Claude Opus 4.7、またはClaude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview)に移行してください。これらには、ベータヘッダーなしで標準価格で1Mコンテキストが含まれます。1490 `context-1m-2025-08-07`ベータは2026年4月30日の時点で廃止されました。このヘッダーをClaude Sonnet 4.5またはSonnet 4で渡すと効果がなく、標準200kトークンコンテキストウィンドウを超えるリクエストはエラーを返します。1Mトークンコンテキストウィンドウを使用するには、[Claude Opus 5.5、Claude Opus 5、Claude Sonnet 5、Claude Sonnet 4.6、Claude Opus 4.6、Claude Opus 4.7、またはClaude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview)に移行してください。これらには、ベータヘッダーなしで標準価格で1Mコンテキストが含まれます。

1491</Warning>1491</Warning>

1492 1492

1493<h3 id="mcpsdkserverconfig">1493<h3 id="mcpsdkserverconfig">

1799 1799

1800`model_usage` dict はモデル名をモデルごとの使用状況にマップします。クエリパイプラインを通じて行われたすべてのモデル呼び出しをカバーします：メインループ、サブエージェント、および圧縮と Workflow エージェントなどの内部呼び出し。パーミッション分類器とトークンカウントリクエストなどのそのパイプラインの外のヘルパー呼び出しは、`model_usage` から除外されます。`model_usage` を推定値として扱い、請求書ではなく。1800`model_usage` dict はモデル名をモデルごとの使用状況にマップします。クエリパイプラインを通じて行われたすべてのモデル呼び出しをカバーします：メインループ、サブエージェント、および圧縮と Workflow エージェントなどの内部呼び出し。パーミッション分類器とトークンカウントリクエストなどのそのパイプラインの外のヘルパー呼び出しは、`model_usage` から除外されます。`model_usage` を推定値として扱い、請求書ではなく。

1801 1801

1802[ストリーミング入力モード](/docs/ja/agent-sdk/streaming-vs-single-mode) では、`model_usage` と `total_cost_usd` はターン全体で累積されるため、結果全体で合計するのではなく、最新の結果を読み取ってください。リセットについては [ストリーミング入力モードでコストを追跡](/docs/ja/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) を、ゼロ化された結果については [セッションクラッシュ後に合計を復旧](/docs/ja/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) を参照してください。1802[ストリーミング入力モード](/docs/ja/agent-sdk/streaming-vs-single-mode) では、`model_usage` と `total_cost_usd` はターン全体で累積されるため、結果全体で合計するのではなく、最新の結果を読み取ってください。セッションの以前の呼び出しから復元された [合計を蓄積](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) も、呼び出しがセッションを再開する場合にカウントされます。リセットについては [ストリーミング入力モードでコストを追跡](/docs/ja/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) を、ゼロ化された結果については [セッションクラッシュ後に合計を復旧](/docs/ja/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) を参照してください。

1803 1803

1804`model_usage` の各値は `ModelUsage` TypedDict で、`from claude_agent_sdk.types import ModelUsage` でインポートされます。そのキーは camelCase を使用します。これは、基になる CLI プロセスから変更されずに渡される値であり、TypeScript [`ModelUsage`](/docs/ja/agent-sdk/typescript#modelusage) 型と一致するためです：1804`model_usage` の各値は `ModelUsage` TypedDict で、`from claude_agent_sdk.types import ModelUsage` でインポートされます。そのキーは camelCase を使用します。これは、基になる CLI プロセスから変更されずに渡される値であり、TypeScript [`ModelUsage`](/docs/ja/agent-sdk/typescript#modelusage) 型と一致するためです：

1805 1805

2922 "command": str | None, # シェルスクリプト。各 stdout 行はイベント、終了はウォッチを終了2922 "command": str | None, # シェルスクリプト。各 stdout 行はイベント、終了はウォッチを終了

2923 "ws": dict | None, # WebSocket ソース：{"url": str, "protocols": list[str] | None}。各テキストフレームはイベント2923 "ws": dict | None, # WebSocket ソース：{"url": str, "protocols": list[str] | None}。各テキストフレームはイベント

2924 "description": str, # 通知に表示される短い説明2924 "description": str, # 通知に表示される短い説明

2925 "timeout_ms": int | None, # この期限後に強制終了（デフォルト 300000、最大 3600000）2925 "timeout_ms": int | None, # この期限後に強制終了（デフォルト 300000、最大 3600000。有効な期限は最大 1800000）

2926 "persistent": bool | None, # セッションの期間中実行。TaskStop で停止

2927}2926}

2928```2927```

2929 2928

2932```python theme={null}2931```python theme={null}

2933{2932{

2934 "taskId": str, # バックグラウンド監視タスクの ID2933 "taskId": str, # バックグラウンド監視タスクの ID

2935 "timeoutMs": int, # タイムアウト期限（ミリ秒）（persistent の場合は 0）2934 "timeoutMs": int, # ウォッチの有効な期限（ミリ秒）

2936 "persistent": bool | None, # TaskStop またはセッション終了まで実行する場合は True2935 "persistent": bool | None, # False：すべてのウォッチに期限があります

2937}2936}

2938```2937```

2939 2938

3349 TaskOutput3348 TaskOutput

3350</h3>3349</h3>

3351 3350

3352**ツール名：** `TaskOutput`。以前の名前 `BashOutput` はまだエイリアスとして受け入れられています。3351Claude Code v2.1.277 で削除されました。以前は実行中または完了したバックグラウンドタスクから出力を取得し、`BashOutput` はエイリアスとして受け入れられていました。Claude はバックグラウンドタスクの出力ファイルを `Read` で読み込みます。

3353 3352

3354<Note>`TaskOutput` は非推奨です。タスクの出力ファイルパスで `Read` を使用することをお勧めします。以下のスキーマは、ツールを遭遇するフックと権限ハンドラーに対して有効なままです。</Note>3353`disallowed_tools` エントリまたはいずれかの名前をまだ名付けている拒否ルールは、警告なしに無視されます。

~~3355~~

3356**入力：**

~~3357~~

3358```python theme={null}

3359{

3360 "task_id": str, # 出力を取得するタスク ID

3361 "block": bool, # 完了を待つかどうか（デフォルト True）

3362 "timeout": int, # 最大待機時間（ミリ秒。デフォルト 30000）

3363}

3364```

~~3365~~

3366**出力：**

~~3367~~

3368```python theme={null}

3369{

3370 "retrieval_status": "success" | "timeout" | "not_ready", # 出力が取得されたかどうか

3371 "task": dict | None, # タスク詳細：task_id、task_type、status、description、output。exitCode などのタイプ固有フィールドを含む

3372}

3373```

3374 3354

3375<h3 id="taskstop">3355<h3 id="taskstop">

3376 TaskStop3356 TaskStop

3628```3608```

3629 3609

3630| プロパティ | 型 | デフォルト | 説明 |3610| プロパティ | 型 | デフォルト | 説明 |

3631| :-------------------------- | :---------------------------------------------------- | :------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |3611| :-------------------------- | :---------------------------------------------------- | :------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

3635| `allowUnsandboxedCommands` | `bool` | `True` | モデルがサンドボックスの外でコマンドを実行するようにリクエストすることを許可します。`True` の場合、モデルはツール入力で `dangerouslyDisableSandbox` を設定でき、[パーミッションシステム](#permissions-fallback-for-unsandboxed-commands) にフォールバックします |3615| `allowUnsandboxedCommands` | `bool` | `True` | モデルがサンドボックスの外でコマンドを実行するようにリクエストすることを許可します。`True` の場合、モデルはツール入力で `dangerouslyDisableSandbox` を設定でき、[パーミッションシステム](#permissions-fallback-for-unsandboxed-commands) にフォールバックします |

3736 サンドボックスなしコマンドのパーミッションフォールバック3716 サンドボックスなしコマンドのパーミッションフォールバック

3737</h3>3717</h3>

3738 3718

3739`allowUnsandboxedCommands` が有効な場合、モデルはツール入力で `dangerouslyDisableSandbox: True` を設定することでサンドボックスの外でコマンドを実行するようにリクエストできます。これらのリクエストは既存のパーミッションシステムにフォールバックします。つまり、`can_use_tool` ハンドラーが呼び出され、カスタム認可ロジックを実装できます。`excludedCommands` にリストされているコマンドは、代わりにサンドボックスを自動的にバイパスし、モデルの関与がありません。[`SandboxSettings`](#sandboxsettings) を参照してください。3719`allowUnsandboxedCommands` が有効な場合、モデルはツール入力で `dangerouslyDisableSandbox: True` を設定することでサンドボックスの外でコマンドを実行するようにリクエストできます。これらのリクエストは既存のパーミッションシステムにフォールバックします。つまり、`can_use_tool` ハンドラーが呼び出され、カスタム認可ロジックを実装できます。

3720

3721`excludedCommands` エントリは代わりにサンドボックスを自動的にバイパスし、モデルの関与がありません。[`sandbox.excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) は、エントリが適用される場合をカバーしています。

3740 3722

3741次の例は、各サンドボックスなしリクエストをログし、独自の認可ロジックが許可しない限りそれを拒否します：3723次の例は、各サンドボックスなしリクエストをログし、独自の認可ロジックが許可しない限りそれを拒否します：

3742 3724

agent-sdk/subagents.md +2 −2

Details

648| :---- | :------------------------------------------------------ | :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |648| :---- | :------------------------------------------------------ | :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

649| 深さ | [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/ja/env-vars) | メインエージェントの下に `3` 層のサブエージェント。`1` はサブエージェントが独自のサブエージェントを生成することを停止します | 下層のサブエージェントが生成できないようにして、委譲された作業を自分で実行します。[ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)を参照してください |649| 深さ | [`CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH`](/docs/ja/env-vars) | メインエージェントの下に `3` 層のサブエージェント。`1` はサブエージェントが独自のサブエージェントを生成することを停止します | 下層のサブエージェントが生成できないようにして、委譲された作業を自分で実行します。[ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)を参照してください |

650| 並行実行数 | [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/ja/env-vars) | `20` 個のサブエージェントが同時に実行され、Agent ツールで Claude が生成するすべてのサブエージェントをカウントします | 別のサブエージェントの生成を拒否し、`Concurrent subagent limit reached` を返します。実行中のカウントが制限を下回るまで待機します。[ultracode](/docs/ja/model-config#adjust-effort-level)がアクティブなセッションは拒否されることはありません。[並行サブエージェント制限](/docs/ja/sub-agents#concurrent-subagent-limit)を参照してください |650| 並行実行数 | [`CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS`](/docs/ja/env-vars) | `20` 個のサブエージェントが同時に実行され、Agent ツールで Claude が生成するすべてのサブエージェントをカウントします | 別のサブエージェントの生成を拒否し、`Concurrent subagent limit reached` を返します。実行中のカウントが制限を下回るまで待機します。[ultracode](/docs/ja/model-config#adjust-effort-level)がアクティブなセッションは拒否されることはありません。[並行サブエージェント制限](/docs/ja/sub-agents#concurrent-subagent-limit)を参照してください |

651| 支出 | TypeScript では `maxBudgetUsd`、Python では `max_budget_usd` | 制限なし。`total_cost_usd` と比較されるため、サブエージェントリクエストがカウントされます | キャップを 3 つの方法で実装します。より多くのサブエージェントの生成を拒否し、`Budget limit reached` を返します。実行中のバックグラウンドサブエージェントを停止し、`error_max_budget_usd` 結果サブタイプでクエリを終了します。[ターンと予算](/docs/ja/agent-sdk/agent-loop#turns-and-budget)を参照してください |651| 支出 | TypeScript では `maxBudgetUsd`、Python では `max_budget_usd` | 制限なし。呼び出し自体の支出をカウントし、サブエージェントリクエストが含まれます | キャップを 3 つの方法で実装します。より多くのサブエージェントの生成を拒否し、`Budget limit reached` を返します。実行中のバックグラウンドサブエージェントを停止し、`error_max_budget_usd` 結果サブタイプでクエリを終了します。セッション全体でキャップがどのように動作するかについては、[ターンと予算](/docs/ja/agent-sdk/agent-loop#turns-and-budget)を参照してください |

652 652

6532 つの SDK は `env` オプションを異なる方法で処理します。TypeScript SDK はサブプロセス環境をそれで置き換えるため、`PATH` のような変数を保持するために `process.env` をそれに展開し、Python SDK はそれを継承された環境にマージします。この例ではネストをオフにし、最大 5 個のサブエージェントを同時に許可し、推定支出が \$5 に達したらクエリを停止します。6532 つの SDK は `env` オプションを異なる方法で処理します。TypeScript SDK はサブプロセス環境をそれで置き換えるため、`PATH` のような変数を保持するために `process.env` をそれに展開し、Python SDK はそれを継承された環境にマージします。この例ではネストをオフにし、最大 5 個のサブエージェントを同時に許可し、推定支出が \$5 に達したらクエリを停止します。

654 654

747 747

748Claude がサブエージェントに委譲する代わりにタスクを直接完了する場合：748Claude がサブエージェントに委譲する代わりにタスクを直接完了する場合：

749 749

750* **明示的なプロンプトを使用する**: プロンプトでサブエージェントを名前で言及します。例えば「code-reviewer エージェントを使用して...」のように750* **明示的なプロンプトを使用する**: プロンプトでサブエージェントを名前で言及します。例えば「code-reviewer エージェントを使用して認証モジュールをチェックする」のように

751* **明確な説明を書く**: サブエージェントをいつ使用すべきかを正確に説明し、Claude がタスクを適切にマッチングできるようにします751* **明確な説明を書く**: サブエージェントをいつ使用すべきかを正確に説明し、Claude がタスクを適切にマッチングできるようにします

752 752

753<h3 id="filesystem-based-agents-not-loading">753<h3 id="filesystem-based-agents-not-loading">

agent-sdk/typescript.md +205 −183

Details

93 `startup()`93 `startup()`

94</h3>94</h3>

95 95

96CLI サブプロセスをプリウォームします。プロセスをスポーンし、プロンプトが利用可能になる前に初期化ハンドシェイクを完了します。返された [`WarmQuery`](#warmquery) ハンドルは後でプロンプトを受け入れ、既に準備ができているプロセスに書き込むため、最初の `query()` 呼び出しはサブプロセスのスポーンと初期化コストをインラインで支払うことなく解決します。96CLI サブプロセスをプリウォームします。プロセスをスポーンし、プロンプトが利用可能になる前に初期化ハンドシェイクを完了します。返された [`WarmQuery`](#warmquery) ハンドルは後でプロンプトを受け入れ、既に準備ができているプロセスに書き込むため、最初の `query()` 呼び出しはサブプロセスのスポーンと初期化のコストを支払わずに解決します。

97 97

98```typescript theme={null}98```typescript theme={null}

99function startup(params?: {99function startup(params?: {

167 `ToolAnnotations`167 `ToolAnnotations`

168</h4>168</h4>

169 169

170`@modelcontextprotocol/sdk/types.js` から再エクスポートされます。すべてのフィールドはオプションのヒントです。クライアントはセキュリティ決定にこれらに依存すべきではありません。170`@modelcontextprotocol/sdk/types.js` から再エクスポートされます。すべてのフィールドはオプションのヒントです。クライアントはセキュリティの決定にこれらに依存すべきではありません。

171 171

172| フィールド | 型 | デフォルト | 説明 |172| フィールド | 型 | デフォルト | 説明 |

173| :---------------- | :-------- | :---------- | :----------------------------------------------------------------------------------- |173| :---------------- | :-------- | :---------- | :------------------------------------------------------------------------------------ |

179 179

180```typescript theme={null}180```typescript theme={null}

181import { tool } from "@anthropic-ai/claude-agent-sdk";181import { tool } from "@anthropic-ai/claude-agent-sdk";

250| :------------- | :-------------------- | :-------------------------------------------------- |250| :------------- | :-------------------- | :-------------------------------------------------- |

261 261

262<h4 id="example-2">262<h4 id="example-2">

263 例263 例

264</h4>264</h4>

265 265

266プロジェクトの 10 個の最新セッションを出力します。結果は `lastModified` の降順でソートされるため、最初のアイテムが最新です。`dir` を省略してすべてのプロジェクト全体を検索します。266プロジェクトの 10 個の最新セッションを出力します。結果は `lastModified` で降順にソートされるため、最初の項目が最新です。`dir` を省略すると、すべてのプロジェクト全体を検索します。

267 267

268```typescript theme={null}268```typescript theme={null}

269import { listSessions } from "@anthropic-ai/claude-agent-sdk";269import { listSessions } from "@anthropic-ai/claude-agent-sdk";

313| `parent_agent_id` | `string \| null` | [ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) からのメッセージの場合、それをスポーンしたサブエージェントの `agentId`。メインセッションメッセージ、トップレベルサブエージェントからのメッセージ、および古いセッションの場合は `null`。Claude Code v2.1.202 以降が必要です |313| `parent_agent_id` | `string \| null` | [ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) からのメッセージの場合、それをスポーンしたサブエージェントの `agentId`。メインセッションメッセージ、トップレベルサブエージェントからのメッセージ、および古いセッションの場合は `null`。Claude Code v2.1.202 以降が必要です |

314 314

315<h4 id="example-3">315<h4 id="example-3">

337 `getSessionInfo()`337 `getSessionInfo()`

338</h3>338</h3>

339 339

340プロジェクトディレクトリ全体をスキャンせずに、ID でシングルセッションのメタデータを読み取ります。340フルプロジェクトディレクトリスキャンなしで ID でシングルセッションのメタデータを読み取ります。

341 341

342```typescript theme={null}342```typescript theme={null}

343function getSessionInfo(343function getSessionInfo(

434`resolveSettings()` は単一のオプションオブジェクトを受け入れます。すべてのフィールドはオプションです。434`resolveSettings()` は単一のオプションオブジェクトを受け入れます。すべてのフィールドはオプションです。

435 435

436| パラメータ | 型 | デフォルト | 説明 |436| パラメータ | 型 | デフォルト | 説明 |

437| :------------------------------ | :------------------------------------ | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |437| :------------------------------ | :------------------------------------ | :-------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

439| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | すべてのソース | どのファイルシステムソースをロードするか。`[]` を渡してユーザー、プロジェクト、およびローカル設定をスキップします。[エンドポイント管理ポリシー](/docs/ja/managed-settings#delivery-mechanisms) はすべての場合にロードされます。`resolveSettings()` は `options.serverManagedSettings` を渡す場合のみサーバー管理設定を含めます |439| `options.settingSources` | [`SettingSource`](#settingsource)`[]` | すべてのソース | どのファイルシステムソースをロードするか。`[]` を渡してユーザー、プロジェクト、およびローカル設定をスキップします。[エンドポイント管理ポリシー](/docs/ja/managed-settings#delivery-mechanisms) はすべての場合にロードされます。`resolveSettings()` は `options.serverManagedSettings` を渡す場合のみサーバー管理設定を含めます |

440| `options.managedSettings` | `Settings` | `undefined` | 埋め込みホストによって提供されるポリシーティア設定。[`Options`](#options) の [`managedSettings`](#options) と同じルールに従います。ただし、`resolveSettings()` は設定された [`policyHelper`](/docs/ja/settings-reference#policyhelper) を実行しないため、スナップショットはライブセッションがドロップする設定を含めることができます |440| `options.managedSettings` | `Settings` | `undefined` | 埋め込みホストによって提供されるポリシーティア設定。[`Options`](#options) の [`managedSettings`](/docs/ja/settings-reference) と同じルールに従います。ただし、`resolveSettings()` は設定された [`policyHelper`](/docs/ja/settings-reference) を実行しないため、スナップショットはライブセッションが削除する設定を含めることができます |

442 442

443<h4 id="return-type-resolvedsettings">443<h4 id="return-type-resolvedsettings">

504| `extraArgs` | `Record<string, string \| null>` | `{}` | 追加引数 |504| `extraArgs` | `Record<string, string \| null>` | `{}` | 追加引数 |

505| `fallbackModel` | `string` | `undefined` | プライマリモデルが失敗した場合に使用するモデル。カンマ区切りリストを受け入れます。順序と上限については[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)を参照してください。ガイダンスについては[モデルを選択](/docs/ja/agent-sdk/configuration#choose-a-model)を参照してください |505| `fallbackModel` | `string` | `undefined` | プライマリモデルが失敗した場合に使用するモデル。カンマ区切りリストを受け入れます。順序と上限については[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)を参照してください。ガイダンスについては[モデルを選択](/docs/ja/agent-sdk/configuration#choose-a-model)を参照してください |

507| `forwardSubagentText` | `boolean` | `false` | サブエージェントのテキストと思考ブロックをアシスタントおよびユーザーメッセージとして `parent_tool_use_id` を設定して転送し、コンシューマーがネストされたトランスクリプトをレンダリングできるようにします。このオプションがない場合、Claude Code はサブエージェント `tool_use` および `tool_result` ブロックを出力しますが、テキストや思考は出力しません。すべてのネストの深さのサブエージェントからのメッセージは Claude Code v2.1.219 以降で転送されます。v2.1.219 より前では、深さ 1 のサブエージェントからのメッセージのみが表示されました |507| `forwardSubagentText` | `boolean` | `false` | サブエージェントのテキストと思考ブロックをアシスタントおよびユーザーメッセージとして `parent_tool_use_id` を設定して転送し、コンシューマーがネストされたトランスクリプトをレンダリングできるようにします。このオプションがない場合、Claude Code はサブエージェント `tool_use` および `tool_result` ブロックを出力しますが、テキストや思考は出力しません。すべてのネストの深さのサブエージェントからのメッセージは Claude Code v2.1.219 以降で転送されます。v2.1.219 より前では、深さ 1 のサブエージェントからのメッセージのみが表示されました。フォークされたスキルがスポーンするサブエージェントのメッセージ、およびネストされたフォークされたスキルのメッセージには v2.1.275 以降が必要です |

508| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | イベントのフックコールバック |508| `hooks` | `Partial<Record<`[`HookEvent`](#hookevent)`, `[`HookCallbackMatcher`](#hookcallbackmatcher)`[]>>` | `{}` | イベントのフックコールバック |

509| `includeHookEvents` | `boolean` | `false` | フックライフサイクルイベントをメッセージストリームに [`SDKHookStartedMessage`](#sdkhookstartedmessage)、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、[`SDKHookResponseMessage`](#sdkhookresponsemessage) として含めます。`SessionStart` および `Setup` フックのライフサイクルイベントは常に含まれ、このオプションは不要です。`Notification`、`SessionEnd`、`PreCompact`、`PostCompact` などの一部のフックイベントは、このオプションを使用しても `SDKHookStartedMessage` を生成しません。これらのイベントについては、Claude Code は 1 秒以上実行されるコマンドフックが出力を生成している間 `SDKHookProgressMessage` を出力し、[バックグラウンドで実行](/docs/ja/hooks#run-hooks-in-the-background)するフックが完了したときのみ `SDKHookResponseMessage` を出力します |509| `includeHookEvents` | `boolean` | `false` | フックライフサイクルイベントをメッセージストリームに [`SDKHookStartedMessage`](#sdkhookstartedmessage)、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、[`SDKHookResponseMessage`](#sdkhookresponsemessage) として含めます。`SessionStart` および `Setup` フックのライフサイクルイベントは常に含まれ、このオプションは不要です。`Notification`、`SessionEnd`、`PreCompact`、`PostCompact` などの一部のフックイベントは、このオプションを使用しても `SDKHookStartedMessage` を生成しません。これらのイベントについては、Claude Code は 1 秒以上実行されるコマンドフックが出力を生成している間 `SDKHookProgressMessage` を出力し、[バックグラウンドで実行](/docs/ja/hooks#run-hooks-in-the-background)するフックが完了したときのみ `SDKHookResponseMessage` を出力します |

512| `managedSettings` | `Settings` | `undefined` | ホストプロセスがスポーンされたセッションに提供するポリシー層設定。管理者がデプロイした管理設定を持つマシンでは、管理者の最優先管理ソースが `parentSettingsBehavior: 'merge'` を設定しない限り、Claude Code はこれらを無視し、[`policyHelper`](/docs/ja/settings-reference#policyhelper) が管理設定を提供している間はマージしません。マージされた値は制限のみのフィルターを通過します。[親設定を制限](/docs/ja/claude-apps-gateway#restrict-parent-settings)はフィルターが許可するもの、および `allowManaged*Only` ロックをカバーします。[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を設定するホストは、このペイロードから直接 3 つのキーを読み込みます。Claude Code v2.1.222 以降の[モデル設定](/docs/ja/model-config#restrict-model-selection)、管理ソースが設定していない場合の v2.1.246 以降の [`modelPricing`](/docs/ja/settings-reference#modelpricing)、および v2.1.247 以降の `ENABLE_TOOL_SEARCH` env エントリ |512| `managedSettings` | `Settings` | `undefined` | ホストプロセスがスポーンされたセッションに提供するポリシー層設定。管理者がデプロイした管理設定を持つマシンでは、管理者の最優先管理ソースが `parentSettingsBehavior: 'merge'` を設定しない限り、Claude Code はこれらを無視し、[`policyHelper`](/docs/ja/settings-reference#policyhelper) が管理設定を提供している間はマージしません。マージされた値は制限のみのフィルターを通過します。[親設定を制限](/docs/ja/claude-apps-gateway#restrict-parent-settings)はフィルターが許可するもの、および `allowManaged*Only` ロックをカバーします。[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を設定するホストは、このペイロードから直接 3 つのキーを読み込みます。Claude Code v2.1.222 以降の[モデル設定](/docs/ja/model-config#restrict-model-selection)、管理ソースが設定していない場合の v2.1.246 以降の [`modelPricing`](/docs/ja/settings-reference#modelpricing)、および v2.1.247 以降の `ENABLE_TOOL_SEARCH` env エントリ |

516| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | MCP サーバー設定 |516| `mcpServers` | `Record<string, [`McpServerConfig`](#mcpserverconfig)>` | `{}` | MCP サーバー設定 |

528| `projectConfigRoot` | `string` | `undefined` | `cwd` がワークツリーである信頼できるチェックアウトの絶対パス。Claude Code はプロジェクト設定、`.mcp.json`、およびプロジェクトの `.claude/` コマンド、エージェント、スキル、ワークフロー、ルーチン、出力スタイルを `cwd` ではなくこのディレクトリから読み込み、`CLAUDE_PROJECT_DIR` をそれに設定します。フック、`apiKeyHelper` などのヘルパースクリプト、および stdio MCP サーバーはこのディレクトリを作業ディレクトリとして開始します。`CLAUDE.md` ファイルと `.claude/rules/` は引き続き `cwd` から読み込まれます。Claude Code v2.1.275 以降が必要です |

528| `promptSuggestions` | `boolean` | `false` | プロンプト提案を有効にします。ターン後、Claude Code は予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを出力します。アカウントが使用制限に近い、または達している場合など、一部のターンでは Claude Code は提案を生成しません。[Claude Code が提案をスキップする場合](/docs/ja/interactive-mode#when-claude-code-skips-suggestions)を参照してください |529| `promptSuggestions` | `boolean` | `false` | プロンプト提案を有効にします。ターン後、Claude Code は予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを出力します。アカウントが使用制限に近い、または達している場合など、一部のターンでは Claude Code は提案を生成しません。[Claude Code が提案をスキップする場合](/docs/ja/interactive-mode#when-claude-code-skips-suggestions)を参照してください |

530| `resumeDropsTurn` | `string` | `undefined` | `resumeSessionAt` を使用: 切り詰め再開が破棄するつもりのターンのプロンプト UUID。破棄された範囲に、そのターンに帰属しないもの（吸収されたキューに入ったメッセージやタスク通知など）が含まれている場合、Claude Code は再開を拒否し、拒否メッセージで `--resume-drops-turn` フラグを指定します。Agent SDK とプリントモード再開のみがペアを読み込みます。Claude Code v2.1.223 以降が必要です |531| `resumeDropsTurn` | `string` | `undefined` | `resumeSessionAt` を使用: 切り詰め再開が破棄するつもりのターンのプロンプト UUID。破棄された範囲に、そのターンに帰属しないもの（吸収されたキューに入ったメッセージやタスク通知など）が含まれている場合、Claude Code は再開を拒否し、拒否メッセージで `--resume-drops-turn` フラグを指定します。Agent SDK とプリントモード再開のみがペアを読み込みます。Claude Code v2.1.223 以降が必要です |

600 : Settings[K] | null;601 : Settings[K] | null;

601 }): Promise<void>;602 }): Promise<void>;

602 updateSettings(603 updateSettings(

603 source: 'localSettings',604 source: 'localSettings' | 'userSettings',

604 settings: Record<string, unknown>,605 settings: Record<string, unknown>,

605 ): Promise<void>;606 ): Promise<void>;

606 initializationResult(): Promise<SDKControlInitializeResponse>;607 initializationResult(): Promise<SDKControlInitializeResponse>;

621 reconnectMcpServer(serverName: string): Promise<void>;622 reconnectMcpServer(serverName: string): Promise<void>;

622 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;623 toggleMcpServer(serverName: string, enabled: boolean): Promise<void>;

623 setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;624 setMcpServers(servers: Record<string, McpServerConfig>): Promise<McpSetServersResult>;

625 readMcpResource(serverName: string, uri: string): Promise<SDKControlMcpReadResourceResponse>;

624 streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;626 streamInput(stream: AsyncIterable<SDKUserMessage>): Promise<void>;

625 stopTask(taskId: string): Promise<void>;627 stopTask(taskId: string): Promise<void>;

626 close(): void;628 close(): void;

639| `setModel()` | モデルを変更します（ストリーミング入力モードでのみ利用可能）。`undefined` または文字列 `"default"` を渡すと、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされます |641| `setModel()` | モデルを変更します（ストリーミング入力モードでのみ利用可能）。`undefined` または文字列 `"default"` を渡すと、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされます |

640| `setMaxThinkingTokens()` | *非推奨:* 代わりに `thinking` オプションを使用してください。最大思考トークン数を変更します。`null` を渡すと、思考をセッションデフォルトにリセットします。中セッション上書きはクリアされ、思考が無効なセッションでは思考は無効のままです |642| `setMaxThinkingTokens()` | *非推奨:* 代わりに `thinking` オプションを使用してください。最大思考トークン数を変更します。`null` を渡すと、思考をセッションデフォルトにリセットします。中セッション上書きはクリアされ、思考が無効なセッションでは思考は無効のままです |

641| `applyFlagSettings(settings)` | 実行時にセッションのフラグ設定層に設定をマージします（ストリーミング入力モードでのみ利用可能）。[`applyFlagSettings()`](#applyflagsettings) を参照してください |643| `applyFlagSettings(settings)` | 実行時にセッションのフラグ設定層に設定をマージします（ストリーミング入力モードでのみ利用可能）。[`applyFlagSettings()`](#applyflagsettings) を参照してください |

642| `updateSettings(source, settings)` | プロジェクトのローカル設定ファイル `.claude/settings.local.json` に設定をマージします。次のリクエストで有効になります。`source: 'localSettings'` とホワイトリストキーセット（現在 `outputStyle`）のみを受け入れ、文字列値を持ちます。キーの削除はサポートされていません。リモートトランスポートおよび [`settingSources`](#options) が `local` を除外するセッションで拒否されます。TypeScript SDK v0.3.257 以降が必要で、Claude Code v2.1.257 をバンドルしています |644| `updateSettings(source, settings)` | プロジェクトのローカル設定ファイルまたはユーザー設定ファイルにホワイトリストキーを書き込み、値が後のセッションで永続化されるようにします。[`updateSettings()`](#updatesettings) を参照してください。TypeScript SDK v0.3.257 以降が必要で、Claude Code v2.1.257 をバンドルしています |

644| `reinitialize()` | 実行中の CLI に `initialize` 制御リクエストを再送信し、キャッシュされた最初の接続結果の代わりに新しい結果を返します。トランスポートギャップ後（切断後のセッションへの再接続など）に使用して、保留中の権限リクエストが `canUseTool` コールバックに再度到達するようにします。コールバックをリクエスト ID ごとにべき等にしてください。応答が失われたリクエストは再度ディスパッチされるためです。Claude Code v2.1.195 以降が必要です |646| `reinitialize()` | 実行中の CLI に `initialize` 制御リクエストを再送信し、キャッシュされた最初の接続結果の代わりに新しい結果を返します。トランスポートギャップ後（切断後のセッションへの再接続など）に使用して、保留中の権限リクエストが `canUseTool` コールバックに再度到達するようにします。コールバックをリクエスト ID ごとにべき等にしてください。応答が失われたリクエストは再度ディスパッチされるためです。Claude Code v2.1.195 以降が必要です |

645| `supportedCommands()` | 利用可能なコマンドを返します。Agent SDK v0.3.216 からリストは中セッションコマンド変更を反映します。[`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) を参照してください |647| `supportedCommands()` | 利用可能なコマンドを返します。Agent SDK v0.3.216 からリストは中セッションコマンド変更を反映します。[`SDKCommandsChangedMessage`](#sdkcommandschangedmessage) を参照してください |

649| `getContextUsage(opts?)` | セッションのコンテキストウィンドウ使用状況をカテゴリ、スキル、ツール別に分類する [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) を返します。デフォルト `detail` では、インタラクティブセッションで `/context` が表示するのと同じデータです。[`detail` オプション](#sdkcontrolgetcontextusageresponse)には Agent SDK v0.3.257 以降が必要です |651| `getContextUsage(opts?)` | セッションのコンテキストウィンドウ使用状況をカテゴリ、スキル、ツール別に分類する [`SDKControlGetContextUsageResponse`](#sdkcontrolgetcontextusageresponse) を返します。デフォルト `detail` では、インタラクティブセッションで `/context` が表示するのと同じデータです。[`detail` オプション](#sdkcontrolgetcontextusageresponse)には Agent SDK v0.3.257 以降が必要です |

650| `readFile(path, options?)` | セッションのファイルシステムからファイルを読み込みます。Claude Code は `cwd` に対してパスを解決します。[`readFile()` が読み込める内容](#what-readfile-can-read)は提供するファイルをリストします。読み込みキャップを変更するには `{ maxBytes }` を渡します（デフォルト 1 MB、上限 10 MB）。画像などのバイナリファイルの場合は `{ encoding: 'base64' }` を渡します。[`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) で解決するか、権限拒否、ファイル欠落、またはトランスポートエラーで `null` で解決します。TypeScript SDK v0.2.121 以降が必要です |652| `readFile(path, options?)` | セッションのファイルシステムからファイルを読み込みます。Claude Code は `cwd` に対してパスを解決します。[`readFile()` が読み込める内容](#what-readfile-can-read)は提供するファイルをリストします。読み込みキャップを変更するには `{ maxBytes }` を渡します（デフォルト 1 MB、上限 10 MB）。画像などのバイナリファイルの場合は `{ encoding: 'base64' }` を渡します。[`SDKControlReadFileResponse`](#sdkcontrolreadfileresponse) で解決するか、権限拒否、ファイル欠落、またはトランスポートエラーで `null` で解決します。TypeScript SDK v0.2.121 以降が必要です |

651| `reloadSkills()` | ディスクからスキルを再読み込みして、中セッションで追加または編集したスキルが実行中のセッションで利用可能になるようにします。再読み込み後に利用可能なスキルをリストする [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) で解決します。Agent SDK v0.3.163 以降が必要です |653| `reloadSkills()` | ディスクからスキルを再読み込みして、中セッションで追加または編集したスキルが実行中のセッションで利用可能になるようにします。再読み込み後に利用可能なスキルをリストする [`SDKControlReloadSkillsResponse`](#sdkcontrolreloadskillsresponse) で解決します。Agent SDK v0.3.163 以降が必要です |

653| `reconnectMcpServer(serverName)` | MCP サーバーを名前で再接続します。名前が `.mcp.json` または `~/.claude.json` などの設定ファイルのエントリとも一致する場合、Claude Code は設定ファイルエントリではなく、[`mcpServers`](#options) または `setMcpServers()` を通じて設定したサーバーを再接続します。その解決順序には Claude Code v2.1.257 以降が必要です |655| `reconnectMcpServer(serverName)` | MCP サーバーを名前で再接続します。名前が `.mcp.json` または `~/.claude.json` などの設定ファイルのエントリとも一致する場合、Claude Code は設定ファイルエントリではなく、[`mcpServers`](#options) または `setMcpServers()` を通じて設定したサーバーを再接続します。その解決順序には Claude Code v2.1.257 以降が必要です |

655| `setMcpServers(servers)` | このセッションの MCP サーバーセットを動的に置き換えます。追加および削除されたサーバーと任意のエラーを指定する [`McpSetServersResult`](#mcpsetserversresult) で解決します |657| `setMcpServers(servers)` | このセッションの MCP サーバーセットを動的に置き換えます。追加および削除されたサーバーと任意のエラーを指定する [`McpSetServersResult`](#mcpsetserversresult) で解決します |

658| `readMcpResource(serverName, uri)` | *アルファ版。* 接続された MCP サーバーから 1 つの MCP Apps `ui://` リソースを読み込み、アプリケーションがツールのウィジェットをレンダリングできるようにします。[`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse) で解決します。TypeScript Agent SDK v0.3.280 以降が必要です |

675 678

676連続した呼び出しは最上位レベルキーをシャローマージします。`{ permissions: {...} }` を含む 2 番目の呼び出しは、前の呼び出しからの `permissions` オブジェクト全体を深くマージするのではなく置き換えます。フラグ層からキーをクリアするには、そのキーに `null` を渡します。ほとんどのキーはその後、低優先度ソースにフォールバックします。クリアされた `model` は、設定ファイルが `model` を設定している場合でも、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされます。`undefined` を渡すと JSON シリアル化がそれをドロップするため効果がありません。679連続した呼び出しは最上位レベルキーをシャローマージします。`{ permissions: {...} }` を含む 2 番目の呼び出しは、前の呼び出しからの `permissions` オブジェクト全体を深くマージするのではなく置き換えます。フラグ層からキーをクリアするには、そのキーに `null` を渡します。ほとんどのキーはその後、低優先度ソースにフォールバックします。クリアされた `model` は、設定ファイルが `model` を設定している場合でも、[Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットされます。`undefined` を渡すと JSON シリアル化がそれをドロップするため効果がありません。

677 680

681`model` 以外の 3 つのキーはセッション状態をリセットする代わりにフォールバックします:

682

683* `effortLevel: null` はセッションをモデルのデフォルト努力レベルに返します。`query()` の `effort` オプションまたは設定ファイルの `effortLevel` ではなく。

684* `agent: null` は次のターンから、メインスレッドをエージェントなしで実行します。`query()` の `agent` オプションまたは設定ファイルの `agent` を復元するのではなく。クリアされたエージェントが独自のモデルを適用していた場合、セッションはスタートアップで解決したモデルに戻ります。

685* `ultracode: null` は `false` と同様に ultracode をオフにします。設定ファイルから `ultracode` 値を復元するのではなく。セッションは現在の努力レベルを保持するため、同じ呼び出しで `effortLevel` を渡してそれを変更します。

686

678ストリーミング入力モードでのみ利用可能です。これは `setModel()` と `setPermissionMode()` と同じ制約です。687ストリーミング入力モードでのみ利用可能です。これは `setModel()` と `setPermissionMode()` と同じ制約です。

679 688

680以下の例は中セッションでアクティブなモデルを切り替え、その後上書きをクリアしてモデルを [Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットします。689以下の例は中セッションでアクティブなモデルを切り替え、その後上書きをクリアしてモデルを [Claude Code のデフォルトモデル](/docs/ja/model-config)にリセットします。

695 `applyFlagSettings()` は TypeScript のみです。Python SDK は同等のメソッドを公開していません。704 `applyFlagSettings()` は TypeScript のみです。Python SDK は同等のメソッドを公開していません。

696</Note>705</Note>

697 706

707<h4 id="updatesettings">

708 `updateSettings()`

709</h4>

710

711設定ファイルにホワイトリストキーを書き込み、値が後のセッションで永続化されるようにします。各ソースは 1 つのキーを受け入れます。文字列値を持ちます:

712

713* **`"localSettings"`**: `outputStyle` を受け入れ、プロジェクトのローカル設定ファイル `.claude/settings.local.json` にマージします。新しいスタイルはセッションの次のリクエストで有効になります。

714* **`"userSettings"`**: `effortLevel` を受け入れ、セッションの現在のモデルのデフォルト[努力レベル](/docs/ja/model-config#adjust-effort-level)としてユーザー設定ファイルの [`modelSettings`](/docs/ja/settings-reference#modelsettings) の下に保存します。`max` を渡すと、`max` はセッションのみであるため何も書き込みません。実行中のセッションは現在の努力レベルをどちらにしても保持するため、変更したい場合は [`applyFlagSettings()`](#applyflagsettings) を呼び出します。このソースには TypeScript SDK v0.3.277 以降が必要で、Claude Code v2.1.277 をバンドルしています。

715

716呼び出しは、リクエストが他のキーを運ぶ場合、セッションがリモートトランスポートを通じて実行される場合、およびセッションの [`settingSources`](#options) が指定したソースを除外する場合に拒否されます。キーの削除はサポートされていません。

717

698<h3 id="warmquery">718<h3 id="warmquery">

699 `WarmQuery`719 `WarmQuery`

700</h3>720</h3>

942 962

943`skills` は再読み込み後に利用可能なスキルをリストします。`supportedCommands()` が返すのと同じ [`SlashCommand`](#slashcommand) 形状です。963`skills` は再読み込み後に利用可能なスキルをリストします。`supportedCommands()` が返すのと同じ [`SlashCommand`](#slashcommand) 形状です。

944 964

965<h3 id="sdkcontrolmcpreadresourceresponse">

966 `SDKControlMcpReadResourceResponse`

967</h3>

968

969[`readMcpResource()`](#query-object) の戻り値の型。MCP サーバーの `resources/read` 結果を運びます。TypeScript Agent SDK v0.3.280 以降が必要です。

970

971```typescript theme={null}

972type SDKControlMcpReadResourceResponse = {

973 contents: {

974 uri: string;

975 mimeType?: string;

976 text?: string;

977 blob?: string;

978 _meta?: Record<string, unknown>;

979 }[];

980};

981```

982

983`readMcpResource()` にサーバー名を `mcpServerStatus()` が報告するのと同じように、および `ui://` URI（ツールが [`_meta`](#mcpserverstatus) で宣言する `ui.resourceUri` など）を渡します。呼び出しは他の URI スキーム、アプリケーションが自分でホストする [SDK MCP サーバー](#createsdkmcpserver)、および接続されていないサーバーに対して拒否されます。初期化メッセージの [`capabilities`](#sdksystemmessage) に `mcp_read_resource_v1` が含まれている場合に利用可能です。

984

985各 `contents` エントリは、サーバーが送信した 1 つのコンテンツアイテムです。`blob` はバイナリアイテムの base64 データを保持し、`_meta` はアイテム自体の `_meta` で、MCP Apps サーバーはリソースの `ui.csp` と `ui.permissions` を配置します。コンテンツは信頼できない第三者の HTML であるため、サンドボックスでレンダリングしてください。

986

945<h3 id="agentdefinition">987<h3 id="agentdefinition">

946 `AgentDefinition`988 `AgentDefinition`

947</h3>989</h3>

1368 uuid?: UUID;1410 uuid?: UUID;

1369 session_id?: string;1411 session_id?: string;

1370 message: MessageParam; // Anthropic SDK から1412 message: MessageParam; // Anthropic SDK から

1413 pasted_content?: MessageParam["content"][];

1371 parent_tool_use_id: string | null;1414 parent_tool_use_id: string | null;

1372 isSynthetic?: boolean;1415 isSynthetic?: boolean;

1373 shouldQuery?: boolean;1416 shouldQuery?: boolean;

1374 tool_use_result?: unknown;1417 tool_use_result?: unknown;

1375 origin?: SDKMessageOrigin;1418 origin?: SDKMessageOrigin;

1419 inline_pastes?: string[];

1376};1420};

1377```1421```

1378 1422

1423ユーザーが入力したのではなく、プロンプト UI に貼り付けたコンテンツを送信するには `pasted_content` を設定します。貼り付けごとに 1 つのエントリ。各エントリは文字列またはコンテンツブロックの配列です。Claude Code は各エントリのテキストを入力されたテキストの後に追加し、各貼り付けを `<pasted_content>` タグで囲む可能性があります。テキスト以外のブロックは無視されるため、画像とドキュメントを `message.content` で送信します。Agent SDK v0.3.277 以降が必要です。

1424

1379`shouldQuery` を `false` に設定して、アシスタントターンをトリガーせずにメッセージをトランスクリプトに追加します。メッセージは保持され、ターンをトリガーする次のユーザーメッセージにマージされます。これを使用して、バンド外で実行したコマンドの出力など、モデル呼び出しを費やさずにコンテキストを注入します。1425`shouldQuery` を `false` に設定して、アシスタントターンをトリガーせずにメッセージをトランスクリプトに追加します。メッセージは保持され、ターンをトリガーする次のユーザーメッセージにマージされます。これを使用して、バンド外で実行したコマンドの出力など、モデル呼び出しを費やさずにコンテキストを注入します。

1380 1426

1381`tool_result` ブロックを持つメッセージでは、`tool_use_result` はモデルに送信されたテキストではなく、ツールの構造化出力オブジェクトです。その形状は、対応する `tool_use` ブロックで指定されたツールに依存するため、フィールドは `unknown` として型付けされます。組み込みの形状は [ツール出力型](#tool-output-types) の下にリストされています。1427`tool_result` ブロックを持つメッセージでは、`tool_use_result` はモデルに送信されたテキストではなく、ツールの構造化出力オブジェクトです。その形状は、対応する `tool_use` ブロックで指定されたツールに依存するため、フィールドは `unknown` として型付けされます。組み込みの形状は [ツール出力型](#tool-output-types) の下にリストされています。

1384 1430

1385結果に `resource_link` ブロックを含む MCP ツールの場合、`tool_use_result` は [`SDKMcpResourceLink`](#sdkmcpresourcelink) エントリの `resourceLinks` 配列を持つオブジェクトです。Claude は各リンクを `tool_result` ブロック内のテキスト行として受け取るため、そのテキストを解析する代わりに `resourceLinks` を読んでサーバーが返したファイルをレンダリングします。Claude Code は結果にリンクがない場合、サブエージェントからの結果で `resourceLinks` を省略し、結果ごとに最大 50 リンクを保持し、配列が 64 KiB のシリアル化 JSON に達するとリンクの追加を停止します。`resourceLinks` には Agent SDK v0.3.257 以降が必要です。1431結果に `resource_link` ブロックを含む MCP ツールの場合、`tool_use_result` は [`SDKMcpResourceLink`](#sdkmcpresourcelink) エントリの `resourceLinks` 配列を持つオブジェクトです。Claude は各リンクを `tool_result` ブロック内のテキスト行として受け取るため、そのテキストを解析する代わりに `resourceLinks` を読んでサーバーが返したファイルをレンダリングします。Claude Code は結果にリンクがない場合、サブエージェントからの結果で `resourceLinks` を省略し、結果ごとに最大 50 リンクを保持し、配列が 64 KiB のシリアル化 JSON に達するとリンクの追加を停止します。`resourceLinks` には Agent SDK v0.3.257 以降が必要です。

1386 1432

1433ユーザーが貼り付けたのではなく入力した `message.content` のどの部分かを Claude Code に伝えるには `inline_pastes` を設定します。貼り付けごとに 1 つの文字列。プロンプトテキストはユーザーが配置した場所に留まります。Claude Code は各リストされた貼り付けを `<pasted_content>` タグで囲む可能性があります。そこに立つため、Claude は貼り付けられた素材をユーザー自身の言葉から区別できます。プロンプトの最後のテキストブロック内の貼り付けのみがラップされます。TypeScript Agent SDK v0.3.280 以降が必要です。

1434

1387<h3 id="sdkusermessagereplay">1435<h3 id="sdkusermessagereplay">

1388 `SDKUserMessageReplay`1436 `SDKUserMessageReplay`

1389</h3>1437</h3>

1488* `first_content_frame_ms`：最初の `content_block_start` または `content_block_delta` ストリームイベントまでの時間（ミリ秒）。思考ブロックをコンテンツとしてカウントします。成功の場合のみ存在し、`is_error` が false のときです。Agent SDK v0.3.260 以降が必要です。1536* `first_content_frame_ms`：最初の `content_block_start` または `content_block_delta` ストリームイベントまでの時間（ミリ秒）。思考ブロックをコンテンツとしてカウントします。成功の場合のみ存在し、`is_error` が false のときです。Agent SDK v0.3.260 以降が必要です。

1489* `first_stream_post_ms`、`first_stream_post_ack_ms`、`first_stream_post_wall_ms`：ターンの最初のストリームイベントをアップロードするためのタイミング。Claude Code はそれを [クラウドセッション](/docs/ja/claude-code-on-the-web) などの claude.ai にストリーミングするセッションでのみ記録し、`query()` が生成する結果はそれらを持ちません。Agent SDK v0.3.260 以降が必要です。1537* `first_stream_post_ms`、`first_stream_post_ack_ms`、`first_stream_post_wall_ms`：ターンの最初のストリームイベントをアップロードするためのタイミング。Claude Code はそれを [クラウドセッション](/docs/ja/claude-code-on-the-web) などの claude.ai にストリーミングするセッションでのみ記録し、`query()` が生成する結果はそれらを持ちません。Agent SDK v0.3.260 以降が必要です。

1490* `usage`：メインエージェントループのみ。サブエージェントと補助モデル呼び出しを除外し、ストリーミング入力セッションではターンごとです。トークン/コスト会計には `modelUsage` を優先してください。1538* `usage`：メインエージェントループのみ。サブエージェントと補助モデル呼び出しを除外し、ストリーミング入力セッションではターンごとです。トークン/コスト会計には `modelUsage` を優先してください。

1491* `modelUsage`：この `query()` 呼び出し中にクエリパイプラインを通じて行われたすべてのモデル呼び出しのモデルごとの合計。メインループ、サブエージェント、圧縮や Workflow エージェントなどの内部呼び出しを含みます。権限分類器やトークンカウントリクエストなど、そのパイプラインの外側のヘルパー呼び出しは除外されます。ストリーミング入力セッションでは、合計はターン全体で累積されるため、結果全体で合計するのではなく、最新の結果を読んでください。[ストリーミング入力モードでコストを追跡する](/docs/ja/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) でリセットを参照し、[セッションクラッシュ後に合計を復旧する](/docs/ja/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) でゼロ化された結果を参照してください。1539* `modelUsage`：この `query()` 呼び出し中にクエリパイプラインを通じて行われたすべてのモデル呼び出しのモデルごとの合計。メインループ、サブエージェント、圧縮や Workflow エージェントなどの内部呼び出しを含みます。権限分類器やトークンカウントリクエストなど、そのパイプラインの外側のヘルパー呼び出しは除外されます。セッションを再開する呼び出しは、[セッションの以前の呼び出しから復元されたモデルごとの合計](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) もカウントします。ストリーミング入力セッションでは、合計はターン全体で累積されるため、結果全体で合計するのではなく、最新の結果を読んでください。[ストリーミング入力モードでコストを追跡する](/docs/ja/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) でリセットを参照し、[セッションクラッシュ後に合計を復旧する](/docs/ja/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) でゼロ化された結果を参照してください。

1492* `total_cost_usd`：この `query()` 呼び出しの累積推定コスト（USD）。`modelUsage` と同じ呼び出しをカバーし、同じポイントでリセットされます。これは推定値であり、請求書ではありません。[コストと使用状況を追跡する](/docs/ja/agent-sdk/cost-tracking) で精度に関する注意事項を参照してください。1540* `total_cost_usd`：この `query()` 呼び出しの累積推定コスト（USD）。`modelUsage` と同じ呼び出しをカバーし、同じポイントでリセットされます。セッションを再開する呼び出しは、[セッションの以前の呼び出しから復元された合計](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls) もカウントします。これは推定値であり、請求書ではありません。[コストと使用状況を追跡する](/docs/ja/agent-sdk/cost-tracking) で精度に関する注意事項を参照してください。

1493* `queued_turn_count`：Claude Code が結果を生成したときに、`origin: { kind: "human" }` で送信したメッセージのうち、まだ待機中のメッセージの数。[`queued_turn_count`](#queued_turn_count) を参照して、`0` と不在フィールドが何を示すかを確認してください。1541* `queued_turn_count`：Claude Code が結果を生成したときに、`origin: { kind: "human" }` で送信したメッセージのうち、まだ待機中のメッセージの数。[`queued_turn_count`](#queued_turn_count) を参照して、`0` と不在フィールドが何を示すかを確認してください。

1494* `startup_failure_reason`：Claude Code が起動を拒否した理由。セッションが開始する前に結果を生成します。[`startup_failure_reason`](#startup_failure_reason) を参照して、値と、どの失敗がそれを持つかを確認してください。Agent SDK v0.3.274 以降が必要です。1542* `startup_failure_reason`：Claude Code が起動を拒否した理由。セッションが開始する前に結果を生成します。[`startup_failure_reason`](#startup_failure_reason) を参照して、値と、どの失敗がそれを持つかを確認してください。Agent SDK v0.3.274 以降が必要です。

1495* `terminal_reason`：ループが終了した理由。`"completed"`、`"max_turns"`、`"tool_deferred"`、`"aborted_streaming"`、`"aborted_tools"`、`"hook_stopped"`、`"stop_hook_prevented"`、`"background_requested"`、`"blocking_limit"`、`"rapid_refill_breaker"`、`"prompt_too_long"`、`"image_error"`、`"model_error"`、`"api_error"`、`"malformed_tool_use_exhausted"`、`"budget_exhausted"`、`"structured_output_retry_exhausted"`、`"tool_deferred_unavailable"`、または `"turn_setup_failed"` のいずれかです。1543* `terminal_reason`：ループが終了した理由。`"completed"`、`"max_turns"`、`"tool_deferred"`、`"aborted_streaming"`、`"aborted_tools"`、`"hook_stopped"`、`"stop_hook_prevented"`、`"background_requested"`、`"blocking_limit"`、`"rapid_refill_breaker"`、`"prompt_too_long"`、`"image_error"`、`"model_error"`、`"api_error"`、`"malformed_tool_use_exhausted"`、`"budget_exhausted"`、`"structured_output_retry_exhausted"`、`"tool_deferred_unavailable"`、または `"turn_setup_failed"` のいずれかです。

1513 1561

1514同じフィールドペアが [`SDKSystemMessage`](#sdksystemmessage) と [`SDKControlInitializeResponse`](#sdkcontrolinitializeresponse) に表示されるため、最初のターンの前に高速モード状態を読むことができます。1562同じフィールドペアが [`SDKSystemMessage`](#sdksystemmessage) と [`SDKControlInitializeResponse`](#sdkcontrolinitializeresponse) に表示されるため、最初のターンの前に高速モード状態を読むことができます。

1515 1563

1516`origin` フィールドは、この結果をトリガーしたユーザーメッセージの [`SDKMessageOrigin`](#sdkmessageorigin) を転送します。SDK が完了したバックグラウンドタスクなどの合成フォローアップターンを注入する場合、結果の `SDKResultMessage` は `origin: { kind: "task-notification" }` を持ちます。トリガーが発火し、サーバーが検証したメッセージが他のセッションから到着するルーチンも、[タスク通知サブキンド](#task-notification-subkinds) で説明されている `subkind` を持つこのキンドで到着します。`kind` をチェックして、プロンプトに答える結果と注入されたフォローアップを区別してから、ルーティングまたは抑制します。1564`origin` フィールドは、この結果をトリガーしたユーザーメッセージの [`SDKMessageOrigin`](#sdkmessageorigin) を転送します。SDK が完了したバックグラウンドタスクなどの合成フォローアップターンを注入する場合、結果の `SDKResultMessage` は `origin: { kind: "task-notification" }` を持ちます。トリガーが発火し、サーバーが検証したメッセージが他のセッションから到着するルーチンも、[タスク通知サブキンド](#task-notification-subkinds) で説明されている `subkind` を持つこのキンドで到着します。`kind` をチェックして、プロンプトに答える結果と注入されたフォローアップを区別してから、ルーティングまたは抑制します。アプリケーションが [スケジュール済み実行を宣言](#declare-a-scheduled-run) する場合、それらの結果も `kind: "task-notification"` を持つため、`kind` だけで抑制しないでください。

1565

1566複数のバックグラウンドタスク完了が一緒にキューに入れられている場合、Claude Code はそれらを 1 つのターンで答えることができます。各完了は依然として独自の結果を生成します。Claude Code が一緒に答える完了のうち、最後のもの以外はすべて、`num_turns: 0` の空の結果を順番に生成し、最後のものの結果はそれらすべてに答えるターンを持ちます。

1517 1567

1518フィールドは、スタートアップエラーなど、ユーザーターンの前に発行される結果には存在しません。1568フィールドは、スタートアップエラーなど、ユーザーターンの前に発行される結果には存在しません。

1519 1569

1929 | {1979 | {

1930 kind: "task-notification";1980 kind: "task-notification";

1931 subkind?: "scheduled-trigger" | "peer-send-message";1981 subkind?: "scheduled-trigger" | "peer-send-message";

1982 fireReason?: string;

1932 }1983 }

1933 | { kind: "coordinator" }1984 | { kind: "coordinator" }

1934 | { kind: "auto-continuation" }1985 | { kind: "auto-continuation" }

1949 タスク通知サブキンド2000 タスク通知サブキンド

1950</h3>2001</h3>

1951 2002

1952Claude Code がタスク通知をセッションに配信するとき、その通知の `origin` に `subkind` を設定するのは、Anthropic サーバーがその通知がどこから来たかを検証した場合のみです。`subkind` には Claude Code v2.1.213 以降が必要で、2 つの値のいずれかを取ります：2003Claude Code がタスク通知をセッションに配信するとき、その通知の `origin` に `subkind` を設定するのは、Anthropic サーバーがその通知がどこから来たかを検証した場合のみです。また、アプリケーションが [スケジュール済み実行を宣言](#declare-a-scheduled-run) する場合にも `subkind` を設定します。これには TypeScript Agent SDK v0.3.280 以降が必要です。`subkind` には Claude Code v2.1.213 以降が必要で、2 つの値のいずれかを取ります：

1953 2004

1954* `scheduled-trigger`：通知は [ルーチン](/docs/ja/routines) の保存されたプロンプトで、ルーチンのトリガーの 1 つが発火したため配信されました：スケジュール、[API トリガー](/docs/ja/routines#add-an-api-trigger)、[GitHub トリガー](/docs/ja/routines#add-a-github-trigger)、または **今すぐ実行**。Claude Code はこれらをモデルにセッションの割り当てられたタスクとしてフレーミングし、[他のタスク通知が持つ通知](#sdktasknotificationmessage) とは異なる通知を持ちます。2005* `scheduled-trigger`：通知は [ルーチン](/docs/ja/routines) の保存されたプロンプトで、ルーチンのトリガーの 1 つが発火したため配信されました：スケジュール、[API トリガー](/docs/ja/routines#add-an-api-trigger)、[GitHub トリガー](/docs/ja/routines#add-a-github-trigger)、または **今すぐ実行**。アプリケーションが [スケジュール済み実行を宣言](#declare-a-scheduled-run) する場合も、この値を持ちます。Claude Code はこれらをモデルにセッションの割り当てられたタスクとしてフレーミングし、[他のタスク通知が持つ通知](#sdktasknotificationmessage) とは異なる通知を持ちます。

1955* `peer-send-message`：通知は別のセッションが [クラウドセッション](/docs/ja/claude-code-on-the-web) が互いにメッセージするために使用するサーバー側 `send_message` ツールで送信したメッセージで、[クロスセッション `SendMessage` ツール](/docs/ja/cross-session-messaging) ではなく、Anthropic サーバーが両方のセッションが同じプライベートセッショングループに属することを検証しました。Claude Code v2.1.224 以降が必要です。サーバーが検証しなかった `send_message` 配信は `subkind` を取得しません。2006* `peer-send-message`：通知は別のセッションが [クラウドセッション](/docs/ja/claude-code-on-the-web) が互いにメッセージするために使用するサーバー側 `send_message` ツールで送信したメッセージで、[クロスセッション `SendMessage` ツール](/docs/ja/cross-session-messaging) ではなく、Anthropic サーバーが両方のセッションが同じプライベートセッショングループに属することを検証しました。Claude Code v2.1.224 以降が必要です。サーバーが検証しなかった `send_message` 配信は `subkind` を取得しません。

1956 2007

1957他のすべてのタスク通知には `subkind` がありません。これには、マシンで発火する [スケジュール済みタスク](/docs/ja/scheduled-tasks)、[PR アクティビティ](/docs/ja/claude-code-on-the-web#how-claude-responds-to-pr-activity) がセッションに配信される、バックグラウンドイベント（完了したタスクなど）が含まれます。[クロスセッション `SendMessage` ツール](/docs/ja/cross-session-messaging) からのメッセージはタスク通知ではありません：同じマシンのセッションから来るか、別のマシンから Anthropic サーバーを通じて来るかに関わらず、Claude Code は `kind: "peer"` と [ピア出所フィールド](#peer-origin-fields) を与えます。2008他のすべてのタスク通知には `subkind` がありません。これには、マシンで発火する [スケジュール済みタスク](/docs/ja/scheduled-tasks)、[PR アクティビティ](/docs/ja/claude-code-on-the-web#how-claude-responds-to-pr-activity) がセッションに配信される、バックグラウンドイベント（完了したタスクなど）が含まれます。[クロスセッション `SendMessage` ツール](/docs/ja/cross-session-messaging) からのメッセージはタスク通知ではありません：同じマシンのセッションから来るか、別のマシンから Anthropic サーバーを通じて来るかに関わらず、Claude Code は `kind: "peer"` と [ピア出所フィールド](#peer-origin-fields) を与えます。

1958 2009

2010`fireReason` は `scheduled-trigger` 通知が発火した理由を示します。`scheduled`、`manual`、`retry`、`catch_up`、`api` などの短い小文字トークンとして。Anthropic サーバーは [ルーチン](/docs/ja/routines) の配信に設定し、アプリケーションはスケジュール済み実行を宣言するときに設定します。どちらも送信しなかった場合は不在です。TypeScript Agent SDK v0.3.280 以降が必要です。

2011

2012<h4 id="declare-a-scheduled-run">

2013 スケジュール済み実行を宣言する

2014</h4>

2015

2016アプリケーションが独自のスケジュールでプロンプトを実行する場合、各実行を宣言して、Claude Code がターンをモデルにスケジュール済みタスクとしてフレーミングするようにします。ライブユーザー入力ではなく。[`env`](#options) で `CLAUDE_CODE_HOST_SCHEDULED_RUN` を `1` に設定してセッションを開始し、実行の [`SDKUserMessage`](#sdkusermessage) を `origin: { kind: "task-notification", subkind: "scheduled-trigger", fireReason: "scheduled" }` で送信し、`isSynthetic` なしで送信します。Claude Code はその変数なしで開始されたプロセスで宣言を無視します。また、プロセスの環境が [`CLAUDECODE`](/docs/ja/env-vars) または `CLAUDE_CODE_CHILD_SESSION` を持つプロセスでも無視します。Claude Code は `fireReason` を値が 1 ～ 32 の小文字の文字または下線である場合にのみ保持します。TypeScript Agent SDK v0.3.280 以降が必要です。

2017

1959<h3 id="peer-origin-fields">2018<h3 id="peer-origin-fields">

1960 ピア出所フィールド2019 ピア出所フィールド

1961</h3>2020</h3>

2832 | ReadMcpResourceInput2891 | ReadMcpResourceInput

2833 | RefreshMcpToolsInput2892 | RefreshMcpToolsInput

2834 | RemoteTriggerInput2893 | RemoteTriggerInput

2835 | REPLInput

2836 | ReportFindingsInput2894 | ReportFindingsInput

2837 | ScheduleWakeupInput2895 | ScheduleWakeupInput

2838 | ShowOnboardingRolePickerInput2896 | ShowOnboardingRolePickerInput

2839 | TaskCreateInput2897 | TaskCreateInput

2840 | TaskGetInput2898 | TaskGetInput

2841 | TaskListInput2899 | TaskListInput

2842 | TaskOutputInput

2843 | TaskStopInput2900 | TaskStopInput

2844 | TaskUpdateInput2901 | TaskUpdateInput

2845 | TodoWriteInput2902 | TodoWriteInput

2934 2991

2935バックグラウンドソースを実行し、各イベントを Claude に配信するため、ポーリングなしで反応できます。`command` はスクリプトを実行し、stdout 行ごとに 1 つのイベントを発行し、`ws` は WebSocket を開き、テキストフレームごとに 1 つのイベントを発行します。`command` または `ws` のいずれか正確に 1 つを指定してください。`ws` ソースには Claude Code v2.1.195 以降が必要です。2992バックグラウンドソースを実行し、各イベントを Claude に配信するため、ポーリングなしで反応できます。`command` はスクリプトを実行し、stdout 行ごとに 1 つのイベントを発行し、`ws` は WebSocket を開き、テキストフレームごとに 1 つのイベントを発行します。`command` または `ws` のいずれか正確に 1 つを指定してください。`ws` ソースには Claude Code v2.1.195 以降が必要です。

2936 2993

2937`timeout_ms` はウォッチの期限（ミリ秒）です。デフォルトは 300000 で、有効な期限は最大 1800000（30 分）です。期限に達するとウォッチが終了し、Claude は 1 つの通知を受け取るため、必要に応じて新しいウォッチを開始できます。2994`timeout_ms` はウォッチの期限（ミリ秒）です。デフォルトは 300000 で、最大 3600000 の値を受け入れます。有効な期限は最大 1800000（30 分）です。より大きい受け入れられた値はその値に短縮されます。期限に達するとウォッチが終了し、Claude は 1 つの通知を受け取るため、必要に応じて新しいウォッチを開始できます。

2938 2995

2939エクスポートされた型は `timeout_ms` を必須としてマークしています。スキーマがデフォルトを入力するため、それを省略する呼び出しは検証されます。2996エクスポートされた型は `timeout_ms` を必須としてマークしています。スキーマがデフォルトを入力するため、それを省略する呼び出しは検証されます。

2940 2997

2944 TaskOutput3001 TaskOutput

2945</h3>3002</h3>

2946 3003

2947**ツール名：** `TaskOutput`3004Claude Code v2.1.277 で削除されました。その `TaskOutputInput` 型と一緒に削除されました。以前は実行中または完了したバックグラウンドタスクから出力を取得していました。Claude はバックグラウンドタスクの出力ファイルを `Read` で読み取ります。

~~2948~~

2949<Note>`TaskOutput` は非推奨です。タスクの出力ファイルパスで `Read` を使用することをお勧めします。以下のスキーマは、ツールを遭遇するフック及び権限ハンドラーに対して有効なままです。</Note>

~~2950~~

2951```typescript theme={null}

2952type TaskOutputInput = {

2953 task_id: string;

2954 block: boolean;

2955 timeout: number;

2956};

2957```

2958 3005

2959実行中または完了したバックグラウンドタスクから出力を取得します。3006`disallowedTools` エントリまたは `TaskOutput` という名前の deny ルールは警告なしに無視されます。

2960 3007

2961<h3 id="edit">3008<h3 id="edit">

2962 Edit3009 Edit

3451 REPL3498 REPL

3452</h3>3499</h3>

3453 3500

3454**ツール名：** `REPL`3501v2.1.275 で削除されました。v2.1.274 までは、実験的な `REPL` ツールを [`env` オプション](#options) で `CLAUDE_CODE_REPL=1` を設定することでオンにできました。

~~3455~~

3456```typescript theme={null}

3457type REPLInput = {

3458 code: string;

3459 description?: string;

3460 timeout?: number;

3461};

3462```

~~3463~~

3464永続的な REPL で JavaScript コードを実行します。状態は呼び出し間で永続化され、トップレベルの await がサポートされています。`timeout` はミリ秒単位で、デフォルトは 30000、最大は 600000 です。

~~3465~~

3466型はエクスポートされていますが、SDK セッションではツールはオフになっています。[`env` オプション](#options) で `CLAUDE_CODE_REPL=1` を設定しない限り。また、ネイティブインストーラーが提供する Bun ベースの `claude` 実行可能ファイルが必要です。

3467 3502

3468<h3 id="reportfindings">3503<h3 id="reportfindings">

3469 ReportFindings3504 ReportFindings

3509 action?: "publish" | "list";3544 action?: "publish" | "list";

3510 file_path?: string;3545 file_path?: string;

3511 favicon?: string;3546 favicon?: string;

3547 icon?: string;

3512 limit?: number;3548 limit?: number;

3513 scope?: "mine" | "shared" | "all";3549 scope?: "mine" | "shared" | "all";

3514 title?: string;3550 title?: string;

3521};3557};

3522```3558```

3523 3559

3524ローカル `.html` または `.md` ファイルをホストされたアーティファクトページとして公開するか、ユーザーの公開されたアーティファクトをリストします。`action` を省略するか `"publish"` を渡して `file_path` を公開します。これは公開アクション、および `favicon`（ユーザーのギャラリーでアーティファクトをマークする 1 つまたは 2 つの絵文字）に必須です。`title` は HTML ファイルに `<title>` タグがない場合、ブラウザタブとギャラリーで公開されたページに名前を付けます。`url` は新しいページを作成する代わりに、既存のアーティファクトをその場で更新するターゲットです。3560ローカル `.html` または `.md` ファイルをホストされたアーティファクトページとして公開するか、ユーザーの公開されたアーティファクトをリストします。`action` を省略するか `"publish"` を渡して `file_path` を公開します。これは公開アクションに必須です。以下の各フィールドは公開に適用されます：

3561

3562* `icon`：アーティファクトのブラウザタブアイコンの 1 つの短い一般的な単語（`chart` や `map` など）。Claude は最初の公開時にそれを含め、更新時に省略します。これはアーティファクトの保存されたアイコンを保持します。

3563* `favicon`：非推奨で、Claude は省略します。

3564* `title`：HTML ファイルに `<title>` タグがない場合、ブラウザタブとギャラリーで公開されたページに名前を付けます。

3565* `url`：新しいページを作成する代わりに、既存のアーティファクトをその場で更新するターゲット。

3525 3566

3526`force` は、別のセッションが公開した新しいバージョンを破棄する最後の手段の上書きです。競合時に、失敗した公開はより新しいコンテンツを返します。Claude はその変更をそのコンテンツにマージするか、アーティファクトを再度読み取り、再度公開します。ユーザーがそのバージョンを明示的に破棄するよう求めた場合にのみ `force` を渡します。3567`force` は、別のセッションが公開した新しいバージョンを破棄する最後の手段の上書きです。競合時に、失敗した公開はより新しいコンテンツを返します。Claude はその変更をそのコンテンツにマージするか、アーティファクトを再度読み取り、再度公開します。ユーザーがそのバージョンを明示的に破棄するよう求めた場合にのみ `force` を渡します。

3527 3568

3658 | ReadMcpResourceOutput3699 | ReadMcpResourceOutput

3659 | RefreshMcpToolsOutput3700 | RefreshMcpToolsOutput

3660 | RemoteTriggerOutput3701 | RemoteTriggerOutput

3661 | REPLOutput

3662 | ReportFindingsOutput3702 | ReportFindingsOutput

3663 | ScheduleWakeupOutput3703 | ScheduleWakeupOutput

3664 | ShowOnboardingRolePickerOutput3704 | ShowOnboardingRolePickerOutput

4508 4548

4509配信の詳細を返します。プッシュまたはローカル通知が送信されたかどうか、および配信がスキップされた理由を含みます。4549配信の詳細を返します。プッシュまたはローカル通知が送信されたかどうか、および配信がスキップされた理由を含みます。

4510 4550

4511<h3 id="repl-2">

4512 REPL

4513</h3>

~~4514~~

4515**ツール名：** `REPL`

~~4516~~

4517```typescript theme={null}

4518type REPLOutput = {

4519 code: string;

4520 result: {

4521 [k: string]: unknown;

4522 };

4523 stdout: string;

4524 stderr: string;

4525 error?: string;

4526 registeredTools?: string[];

4527 images?: {

4528 base64: string;

4529 mediaType: string;

4530 }[];

4531 documents?: {

4532 base64: string;

4533 }[];

4534};

4535```

~~4536~~

4537実行結果、キャプチャされたコンソール出力、および内部 `Read` 呼び出しによって表示されたイメージまたはドキュメントを返します。

~~4538~~

4539<h3 id="reportfindings-2">4551<h3 id="reportfindings-2">

4540 ReportFindings4552 ReportFindings

4541</h3>4553</h3>

4815```4827```

4816 4828

4817<h2 id="other-types">4829<h2 id="other-types">

4818 その他の型4830 その他のタイプ

4819</h2>4831</h2>

4820 4832

4821<h3 id="apikeysource">4833<h3 id="apikeysource">

4822 `ApiKeySource`4834 `ApiKeySource`

4823</h3>4835</h3>

4824 4836

4825セッションのリクエストの API キーがどこから来たかを示します。[`SDKSystemMessage`](#sdksystemmessage) 初期化メッセージの `apiKeySource` として報告されます。4837セッションのリクエストに使用される API キーの出所です。[`SDKSystemMessage`](#sdksystemmessage) 初期化メッセージの `apiKeySource` として報告されます。

4826 4838

4827```typescript theme={null}4839```typescript theme={null}

4828type ApiKeySource =4840type ApiKeySource =

4840Claude Code は 4 つの値のいずれかを報告します。4852Claude Code は 4 つの値のいずれかを報告します。

4841 4853

4842| 値 | 使用中のキー |4854| 値 | 使用中のキー |

4843| -------------------- | ------------------------------------------------------------------------------------------------------- |4855| -------------------- | ------------------------------------------------------------------------------------------------------ |

4846| `/login managed key` | [Claude Console アカウント](/docs/ja/authentication#claude-console-authentication) でログインしたときに Claude Code が保存したキー |4858| `/login managed key` | [Claude Console アカウント](/docs/ja/authentication#claude-console-authentication)でログインしたときに Claude Code が保存したキー |

4848 4860

4849Agent SDK v0.3.234 以降は、型にこれら 4 つの値をリストします。この型は、古いコードが引き続きコンパイルされるように `user`、`project`、`org`、`temporary`、および `oauth` も保持し、Claude Code はそれらを報告しません。4861Agent SDK v0.3.234 以降では、タイプ内にこれら 4 つの値がリストされます。タイプは `user`、`project`、`org`、`temporary`、`oauth` も保持しているため、古いコードは引き続きコンパイルされ、Claude Code はそれらを報告しません。

4850 4862

4851<h3 id="sdkbeta">4863<h3 id="sdkbeta">

4852 `SdkBeta`4864 `SdkBeta`

4853</h3>4865</h3>

4854 4866

4855`betas` オプション経由で有効にできる利用可能なベータ機能。詳細は [ベータヘッダー](https://platform.claude.com/docs/ja/api/beta-headers) を参照してください。4867`betas` オプションで有効にできる利用可能なベータ機能です。詳細については、[Beta headers](https://platform.claude.com/docs/en/api/beta-headers) を参照してください。

4856 4868

4857```typescript theme={null}4869```typescript theme={null}

4858type SdkBeta = "context-1m-2025-08-07";4870type SdkBeta = "context-1m-2025-08-07";

4859```4871```

4860 4872

4861<Warning>4873<Warning>

4862 `context-1m-2025-08-07` ベータは 2026 年 4 月 30 日時点で廃止されました。Claude Sonnet 4.5 または Sonnet 4 でこの値を渡すと効果がなく、標準 200k トークンコンテキストウィンドウを超えるリクエストはエラーを返します。1M トークンコンテキストウィンドウを使用するには、[Claude Opus 5、Claude Sonnet 5、Claude Sonnet 4.6、Claude Opus 4.6、Claude Opus 4.7、または Claude Opus 4.8](https://platform.claude.com/docs/ja/about-claude/models/overview) に移行してください。これらには、ベータヘッダーなしで標準価格で 1M コンテキストが含まれます。4874 `context-1m-2025-08-07` ベータは 2026 年 4 月 30 日時点で廃止されました。Claude Sonnet 4.5 または Sonnet 4 でこの値を渡すと効果がなく、標準の 200k トークンコンテキストウィンドウを超えるリクエストはエラーを返します。1M トークンコンテキストウィンドウを使用するには、[Claude Opus 5.5、Claude Opus 5、Claude Sonnet 5、Claude Sonnet 4.6、Claude Opus 4.6、Claude Opus 4.7、または Claude Opus 4.8](https://platform.claude.com/docs/en/about-claude/models/overview) に移行してください。これらは標準価格で 1M コンテキストを含み、ベータヘッダーは不要です。

4863</Warning>4875</Warning>

4864 4876

4865<h3 id="slashcommand">4877<h3 id="slashcommand">

4866 `SlashCommand`4878 `SlashCommand`

4867</h3>4879</h3>

4868 4880

4869利用可能なコマンドに関する情報。4881利用可能なコマンドに関する情報です。

4870 4882

4871```typescript theme={null}4883```typescript theme={null}

4872type SlashCommand = {4884type SlashCommand = {

4874 description: string;4886 description: string;

4875 argumentHint: string;4887 argumentHint: string;

4876 aliases?: string[];4888 aliases?: string[];

4889 builtin?: boolean;

4877};4890};

4878```4891```

4879 4892

4893`builtin` は、コマンドが Claude Code 自体のものであり、`/name` を入力するとそれが実行される場合に `true` です。ユーザー、プロジェクト、プラグイン、または MCP サーバーによって定義されたコマンド、および [名前で置き換える](/docs/ja/skills#resolve-skills-that-share-a-name) バンドルされたコマンドの場合は存在しません。Agent SDK v0.3.277 以降が必要です。

4894

4880<h3 id="modelinfo">4895<h3 id="modelinfo">

4881 `ModelInfo`4896 `ModelInfo`

4882</h3>4897</h3>

4883 4898

4884利用可能なモデルに関する情報。4899利用可能なモデルに関する情報です。

4885 4900

4886```typescript theme={null}4901```typescript theme={null}

4887type ModelInfo = {4902type ModelInfo = {

4897};4912};

4898```4913```

4899 4914

4900| フィールド | 型 | 説明 |4915| フィールド | タイプ | 説明 |

4901| :------------------------- | :----------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |4916| :------------------------- | :----------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

4903| `resolvedModel` | `string \| undefined` | このエントリの `value` が解決される正規のワイヤモデル ID。`sonnet` などのエイリアスエントリは `claude-sonnet-5` などの明示的なモデル ID に解決されるため、ホストは保存された明示的なモデル ID をそれをカバーするエイリアスエントリと照合できます。Claude Code v2.1.197 以降が必要です。 |4918| `resolvedModel` | `string \| undefined` | このエントリの `value` が解決される正規のワイヤモデル ID。`sonnet` などのエイリアスエントリは `claude-sonnet-5` などの明示的なモデル ID に解決されるため、ホストは保存された明示的なモデル ID をそれをカバーするエイリアスエントリと照合できます。Claude Code v2.1.197 以降が必要です。 |

4911 4926

4913 `AgentInfo`4928 `AgentInfo`

4914</h3>4929</h3>

4915 4930

4916Agent ツール経由で呼び出すことができる利用可能なサブエージェントに関する情報。4931Agent ツールを介して呼び出すことができる利用可能なサブエージェントに関する情報です。

4917 4932

4918```typescript theme={null}4933```typescript theme={null}

4919type AgentInfo = {4934type AgentInfo = {

4923};4938};

4924```4939```

4925 4940

4926| フィールド | 型 | 説明 |4941| フィールド | タイプ | 説明 |

4927| :------------ | :-------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- |4942| :------------ | :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------- |

4931 4946

4932<h3 id="mcpserverprovenance">4947<h3 id="mcpserverprovenance">

4933 `McpServerProvenance`4948 `McpServerProvenance`

4934</h3>4949</h3>

4935 4950

4936`mcp__*` ツールを提供する MCP サーバーと、そのサーバーの定義がどこから来たかを示します。[`PreToolUse`](#pretoolusehookinput)、`PostToolUse`、`PostToolUseFailure`、`PermissionRequest`、および `PermissionDenied` フックの入力は `mcp_server` として、[`CanUseTool`](#canusetool) オプションは `mcpServer` として実行します。MCP サーバーから来ないツールについては両方とも省略します。4951`mcp__*` ツールを提供する MCP サーバーと、そのサーバーの定義がどこから来たかです。[`PreToolUse`](#pretoolusehookinput)、`PostToolUse`、`PostToolUseFailure`、`PermissionRequest`、`PermissionDenied` フックの入力は `mcp_server` として、[`CanUseTool`](#canusetool) オプションは `mcpServer` として持ちます。MCP サーバーから来ないツールの場合は両方とも省略されます。

4937 4952

4938```typescript theme={null}4953```typescript theme={null}

4939type McpServerProvenance = {4954type McpServerProvenance = {

4942};4957};

4943```4958```

4944 4959

4945| フィールド | 型 | 説明 |4960| フィールド | タイプ | 説明 |

4946| :------- | :------- | :------------------------------------------------------------------- |4961| :------- | :------- | :------------------------------------------------------------- |

4949 4964

4950`source` は以下の値のいずれかを取ります。セットは開いているため、認識しない値を設定されたソースとして扱い、`sdk` として扱わないでください。4965`source` は以下の値のいずれかを取ります。セットはオープンなため、認識しない値を設定されたソースとして扱い、`sdk` としては扱いません。

4951 4966

4952* **`sdk`**: アプリケーションが登録したインプロセスサーバー。SDK ホストアプリケーションのみが 1 つを登録できるため、設定されたサーバーは名前に関わらず `sdk` を報告しません。4967* **`sdk`**: アプリケーションが登録したインプロセスサーバー。SDK ホストアプリケーションのみが登録できるため、設定されたサーバーは名前に関係なく `sdk` を報告しません。

4953* **`plugin`**: [プラグイン](/docs/ja/agent-sdk/plugins) が提供するサーバー。その `name` は [プラグイン提供 MCP サーバー](/docs/ja/mcp#plugin-provided-mcp-servers) の下で説明されているスコープ付き `plugin:<plugin-name>:<server-name>` 形式です。4968* **`plugin`**: [プラグイン](/docs/ja/agent-sdk/plugins) が提供するサーバー。その `name` は [プラグイン提供 MCP サーバー](/docs/ja/mcp#plugin-provided-mcp-servers) で説明されているスコープ付き `plugin:<plugin-name>:<server-name>` 形式です。

4954* **設定スコープ**: `user`、`project`、`local`、`dynamic`、`managed`、`enterprise`、`claudeai`、または `agent`。`.mcp.json` サーバーは `project` を報告し、[MCP インストールスコープ](/docs/ja/mcp#mcp-installation-scopes) は `local`、`project`、および `user` を定義します。アプリケーションが [`mcpServers` オプション](#options) で渡すサーバー（インプロセス SDK サーバー以外）は `dynamic` を報告します。4969* **設定スコープ**: `user`、`project`、`local`、`dynamic`、`managed`、`enterprise`、`claudeai`、または `agent`。`.mcp.json` サーバーは `project` を報告し、[MCP インストールスコープ](/docs/ja/mcp#mcp-installation-scopes) は `local`、`project`、`user` を定義します。アプリケーションが [`mcpServers` オプション](#options) で渡すサーバー（インプロセス SDK サーバー以外）は `dynamic` を報告します。

4955 4970

4956信頼決定を `source` に基づいて行い、`name` または `mcp__<server>__` ツール名プレフィックスに基づいて行わないでください。`sdk` 以外のソースの場合、`name` は信頼されていないテキストです。表示する前にエスケープしてください。4971信頼決定は `name` または `mcp__<server>__` ツール名プレフィックスではなく `source` に基づいてください。`sdk` 以外のソースの場合、`name` は信頼されていないテキストです。表示する前にエスケープしてください。

4957 4972

4958`McpServerProvenance` およびそれを実行するフィールドには Agent SDK v0.3.274 以降が必要です。4973`McpServerProvenance` とそれを持つフィールドには Agent SDK v0.3.274 以降が必要です。

4959 4974

4960<h3 id="mcpserverstatus">4975<h3 id="mcpserverstatus">

4961 `McpServerStatus`4976 `McpServerStatus`

4962</h3>4977</h3>

4963 4978

4964接続された MCP サーバーのステータス。4979接続された MCP サーバーのステータスです。

4965 4980

4966```typescript theme={null}4981```typescript theme={null}

4967type McpServerStatus = {4982type McpServerStatus = {

4983 destructive?: boolean;4998 destructive?: boolean;

4984 openWorld?: boolean;4999 openWorld?: boolean;

4985 };5000 };

5001 _meta?: Record<string, unknown>;

4986 }[];5002 }[];

4987};5003};

4988```5004```

4989 5005

4990`source` はサーバーの定義がどこから来たかを示し、[`McpServerProvenance`](#mcpserverprovenance) の `source` と同じ値と信頼ルールを持ちます。フィールドには Agent SDK v0.3.274 以降が必要で、以前のバージョンには存在しません。5006`source` はサーバーの定義がどこから来たかを示し、[`McpServerProvenance`](#mcpserverprovenance) の `source` と同じ値と信頼ルールを持ちます。フィールドには Agent SDK v0.3.274 以降が必要で、以前のバージョンでは存在しません。

5007

5008`tools` エントリの `_meta` は、そのツールの `_meta` の MCP Apps メンバーを持ち、アプリケーションが [`readMcpResource()`](#query-object) でレンダリングする `ui://` リソースを見つけることができます。Claude Code は `ui` オブジェクトと非推奨のフラット `ui/resourceUri` 文字列をパススルーし、他のすべてのキーを保留します。`ui` 内では、`resourceUri` は `ui://` 文字列で、`visibility` はサーバーが設定した場合に `"model"` と `"app"` の配列で、他のメンバーは変更されずにパススルーされます。Claude Code は値が不正な形式の場合、どちらかのキーをドロップし、ツールが宣言しない場合は `_meta` を省略します。フィールドは初期化メッセージの [`capabilities`](#sdksystemmessage) に `mcp_tool_ui_meta_v1` が含まれる場合にのみ存在し、TypeScript Agent SDK v0.3.280 以降が必要です。

4991 5009

4992<h3 id="mcpserverstatusconfig">5010<h3 id="mcpserverstatusconfig">

4993 `McpServerStatusConfig`5011 `McpServerStatusConfig`

4994</h3>5012</h3>

4995 5013

4996`mcpServerStatus()` によってレポートされた MCP サーバーの設定。これはすべての MCP サーバートランスポートタイプの共用体です。5014`mcpServerStatus()` によって報告される MCP サーバーの設定です。これはすべての MCP サーバートランスポートタイプの和集合です。

4997 5015

4998```typescript theme={null}5016```typescript theme={null}

4999type McpServerStatusConfig =5017type McpServerStatusConfig =

5010 `AccountInfo`5028 `AccountInfo`

5011</h3>5029</h3>

5012 5030

5013認証されたユーザーのアカウント情報。5031認証されたユーザーのアカウント情報です。

5014 5032

5015```typescript theme={null}5033```typescript theme={null}

5016type AccountInfo = {5034type AccountInfo = {

5026 `ModelUsage`5044 `ModelUsage`

5027</h3>5045</h3>

5028 5046

5029結果メッセージで返されるモデルごとの使用統計。`costUSD` 値はクライアント側の推定です。請求に関する注意事項については、[コストと使用状況を追跡](/docs/ja/agent-sdk/cost-tracking) を参照してください。5047結果メッセージで返されるモデルごとの使用統計です。`costUSD` 値はクライアント側の推定値です。請求に関する注意事項については、[コストと使用状況の追跡](/docs/ja/agent-sdk/cost-tracking) を参照してください。

5030 5048

5031```typescript theme={null}5049```typescript theme={null}

5032type ModelUsage = {5050type ModelUsage = {

5045};5063};

5046```5064```

5047 5065

5048`thinkingTokens` はこのモデルが生成した思考トークンをカウントします。`outputTokens` には既に含まれているため、2 つを足さないでください。フィールドは思考トークンを記録する Claude Code バージョンでターンが実行されるまで存在しないため、以前のバージョンで開始された再開セッションは部分的なカウントを報告します。`thinkingTokens` には Agent SDK v0.3.257 以降が必要です。5066`thinkingTokens` はこのモデルが生成した思考トークンをカウントします。`outputTokens` はすでにそれらを含んでいるため、2 つを合計しないでください。フィールドは、ターンが記録するバージョンの Claude Code で実行されるまで存在しません。そのため、以前のバージョンで開始された再開されたセッションは部分的なカウントを報告します。`thinkingTokens` には Agent SDK v0.3.257 以降が必要です。

5049 5067

5050`canonicalModel` および `provider` フィールドには Claude Code v2.1.218 以降が必要です。`canonicalModel` は価格ルックアップが使用する正規モデル ID です。例えば、その文字列がプロバイダー固有の ID またはエイリアスの場合、生のモデル文字列と異なる場合があります。5068`canonicalModel` および `provider` フィールドには Claude Code v2.1.218 以降が必要です。`canonicalModel` は価格ルックアップが使用する正規モデル ID です。例えば、その文字列がプロバイダー固有の ID またはエイリアスの場合、生のモデル文字列と異なる場合があります。

5051 5069

5052`provider` は、`firstParty`、`bedrock`、`vertex`、`foundry`、`anthropicAws`、`mantle`、または `gateway` など、モデルを提供した API バックエンドに名前を付けます。5070`provider` は、`firstParty`、`bedrock`、`vertex`、`foundry`、`anthropicAws`、`mantle`、`gateway` など、モデルを提供した API バックエンドに名前を付けます。

5053 5071

5054`costBasis` はモデルの最新リクエストに価格を付けた価格表に名前を付けます。`list` はリスト価格、`managed` は [`modelPricing`](/docs/ja/settings-reference#modelpricing) テーブル、またはモデル ID がどちらにも一致しなかった場合は `unknown`。フィールドには Claude Code v2.1.246 以降が必要です。5072`costBasis` はモデルの最新リクエストに価格を付けた価格表に名前を付けます：リスト価格の場合は `list`、[`modelPricing`](/docs/ja/settings-reference#modelpricing) テーブルの場合は `managed`、モデル ID がどちらにも一致しない場合は `unknown`。フィールドには Claude Code v2.1.246 以降が必要です。

5055 5073

5056<h3 id="configscope">5074<h3 id="configscope">

5057 `ConfigScope`5075 `ConfigScope`

5065 `NonNullableUsage`5083 `NonNullableUsage`

5066</h3>5084</h3>

5067 5085

5068すべての nullable フィールドが non-nullable になった [`Usage`](#usage) のバージョン。5086すべてのヌル許容フィールドがヌル許容でない [`Usage`](#usage) のバージョンです。

5069 5087

5070```typescript theme={null}5088```typescript theme={null}

5071type NonNullableUsage = {5089type NonNullableUsage = {

5077 `Usage`5095 `Usage`

5078</h3>5096</h3>

5079 5097

5080トークン使用統計。これは `@anthropic-ai/sdk` の `BetaUsage` 型です。5098トークン使用統計です。これは `@anthropic-ai/sdk` の `BetaUsage` タイプです。

5081 5099

5082```typescript theme={null}5100```typescript theme={null}

5083type Usage = {5101type Usage = {

5098};5116};

5099```5117```

5100 5118

5101`BetaServerToolUsage`、`BetaIterationsUsage`、および `BetaOutputTokensDetails` は `@anthropic-ai/sdk` で定義されています。5119`BetaServerToolUsage`、`BetaIterationsUsage`、`BetaOutputTokensDetails` は `@anthropic-ai/sdk` で定義されています。

5102 5120

5103`output_tokens_details` はカテゴリ別に請求出力を分類します。現在、`thinking_tokens: number` という 1 つのフィールドを含み、モデルが内部推論として生成した出力トークンをカウントします。これには思考ブロック区切り文字が含まれます。`output_tokens_details` フィールドには TypeScript SDK v0.3.228 以降が必要です。これは Claude Code v2.1.228 をバンドルしています。5121`output_tokens_details` は請求された出力をカテゴリ別に分類します。現在、`thinking_tokens: number` という 1 つのフィールドを持ち、モデルが内部推論として生成した出力トークンをカウントします。これには思考ブロック区切り文字が含まれます。`output_tokens_details` フィールドには TypeScript SDK v0.3.228 以降が必要で、これは Claude Code v2.1.228 をバンドルしています。

5104 5122

5105* **請求**: 観測可能性のために分類を読み、請求のためではありません。`output_tokens` は権限のある合計のままで、`output_tokens - thinking_tokens` は非推論出力を近似します。5123* **請求**: 観測可能性のために分類を読み、請求のためではありません。`output_tokens` は権限のある合計のままで、`output_tokens - thinking_tokens` は非推論出力を近似します。

5106* **カウントが対象とするもの**: モデルが生成した生の推論。応答本文で返された思考テキストより長くなる場合があります。API はその生のテキストを再トークン化することで計算するため、モデルの正確な生成カウントから数トークン異なる場合があります。5124* **カウントが対象とするもの**: モデルが生成した生の推論。これは応答本文で返された思考テキストより長い場合があります。API はその生テキストを再トークン化することで計算するため、モデルの正確な生成カウントから数トークン異なる場合があります。

5107* **ストリーミング**: ストリーミングされたアシスタントメッセージでは、この分類は `output_tokens` と同様に `message_start` プレースホルダーで、実際のカウントを含まないため、[結果メッセージから出力トークンを読む](/docs/ja/agent-sdk/cost-tracking#read-output-tokens-from-the-result-message) で説明されているように結果メッセージから読んでください。結果メッセージでは、モデルまたはプロバイダーが分類を報告しない場合、`thinking_tokens` は `0` を読みます。5125* **ストリーミング**: ストリーミングされたアシスタントメッセージでは、この分類は `output_tokens` と同様に `message_start` プレースホルダーで、実際のカウントを持たないため、[結果メッセージから出力トークンを読む](/docs/ja/agent-sdk/cost-tracking#read-output-tokens-from-the-result-message) で説明されているように結果メッセージから読んでください。結果メッセージでは、モデルまたはプロバイダーが分類を報告しない場合、`thinking_tokens` は `0` を読みます。

5108* **`null` ケース**: `output_tokens_details` 自体は、Claude Code が合成するアシスタントメッセージ（API エラーメッセージなど）では `null` です。5126* **`null` ケース**: `output_tokens_details` 自体は、Claude Code が合成するアシスタントメッセージ（API エラーメッセージなど）では `null` です。

5109 5127

5110<h3 id="calltoolresult">5128<h3 id="calltoolresult">

5111 `CallToolResult`5129 `CallToolResult`

5112</h3>5130</h3>

5113 5131

5114MCP ツール結果型（`@modelcontextprotocol/sdk/types.js` から）。`structuredContent` は `content` と一緒に返すことができる JSON オブジェクトで、画像ブロックを含みます。詳細は [構造化データを返す](/docs/ja/agent-sdk/custom-tools#return-structured-data) を参照してください。5132MCP ツール結果タイプ（`@modelcontextprotocol/sdk/types.js` から）。`structuredContent` は `content` と一緒に返すことができる JSON オブジェクトで、画像ブロックを含みます。[構造化データを返す](/docs/ja/agent-sdk/custom-tools#return-structured-data) を参照してください。

5115 5133

5116```typescript theme={null}5134```typescript theme={null}

5117type CallToolResult = {5135type CallToolResult = {

5118 content: Array<{5136 content: Array<{

5120 // 追加フィールドはタイプによって異なります5138 // Additional fields vary by type

5121 }>;5139 }>;

5122 structuredContent?: Record<string, unknown>;5140 structuredContent?: Record<string, unknown>;

5123 isError?: boolean;5141 isError?: boolean;

5128 `SDKMcpResourceLink`5146 `SDKMcpResourceLink`

5129</h3>5147</h3>

5130 5148

5131MCP ツールが参照によって返した 1 つのファイル。Claude Code は各エントリをツール結果の `resource_link` ブロックから構築し、[`SDKUserMessage.tool_use_result`](#sdkusermessage) の `resourceLinks` として、またはバックグラウンドで呼び出しが完了したときに [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) の `resource_links` として配信します。Agent SDK v0.3.257 以降が必要です。5149MCP ツールが参照によって返した 1 つのファイルです。Claude Code は各エントリをツール結果の `resource_link` ブロックから構築し、[`SDKUserMessage.tool_use_result`](#sdkusermessage) の `resourceLinks` として、または [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) の `resource_links` として呼び出しがバックグラウンドで完了したときにリストを配信します。Agent SDK v0.3.257 以降が必要です。

5132 5150

5133```typescript theme={null}5151```typescript theme={null}

5134type SDKMcpResourceLink = {5152type SDKMcpResourceLink = {

5142};5160};

5143```5161```

5144 5162

5145Claude Code は `uri` または `name` が文字列でないブロックを削除し、値がリストされた型でないオプションフィールドを省略します。5163Claude Code は `uri` または `name` が文字列でないブロックをドロップし、値がリストされたタイプでないオプションフィールドを除外します。

5146 5164

5147| フィールド | 型 | 説明 |5165| フィールド | タイプ | 説明 |

5148| :------------ | :------------------------------------- | :---------------------------------- |5166| :------------ | :------------------------------------- | :--------------------------------------- |

5149| `uri` | `string` | リソースの URI。サーバーが返したもの |5167| `uri` | `string` | リソースの URI。サーバーが返したもの |

5156 5174

5157<h3 id="thinkingconfig">5175<h3 id="thinkingconfig">

5158 `ThinkingConfig`5176 `ThinkingConfig`

5164type ThinkingDisplay = "summarized" | "omitted";5182type ThinkingDisplay = "summarized" | "omitted";

5165 5183

5166type ThinkingConfig =5184type ThinkingConfig =

5167 | { type: "adaptive"; display?: ThinkingDisplay } // モデルが推論のタイミングと量を決定します（Opus 4.6 以降）5185 | { type: "adaptive"; display?: ThinkingDisplay } // The model determines when and how much to reason (Opus 4.6+)

5168 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // 固定思考トークン予算5186 | { type: "enabled"; budgetTokens?: number; display?: ThinkingDisplay } // Fixed thinking token budget

5169 | { type: "disabled" }; // 拡張思考なし5187 | { type: "disabled" }; // No extended thinking

5170```5188```

5171 5189

5172オプションの `display` フィールドは、思考テキストが `"summarized"` または `"omitted"` で返されるかどうかを制御します。Claude Opus 4.7 以降では、API のデフォルトは `"omitted"` であるため、`"summarized"` を設定して `thinking` ブロックで思考コンテンツを受け取ります。Claude Code は Amazon Bedrock または Google Cloud の Agent Platform に `display` を送信しないため、これらのプロバイダーでは Opus 4.7 以降は `display` を `"summarized"` に設定した場合でも空の `thinking` ブロックを返します。5190オプションの `display` フィールドは、思考テキストが `"summarized"` または `"omitted"` で返されるかどうかを制御します。Claude Opus 4.7 以降では、API デフォルトは `"omitted"` なため、思考コンテンツを `thinking` ブロックで受け取るには `"summarized"` を設定してください。Claude Code は Amazon Bedrock または Google Cloud の Agent Platform に `display` を送信しないため、これらのプロバイダーでは Opus 4.7 以降は `display` を `"summarized"` に設定した場合でも空の `thinking` ブロックを返します。

5173 5191

5174<h3 id="spawnedprocess">5192<h3 id="spawnedprocess">

5175 `SpawnedProcess`5193 `SpawnedProcess`

5176</h3>5194</h3>

5177 5195

5178カスタムプロセススポーニング用のインターフェース（`spawnClaudeCodeProcess` オプションで使用）。`ChildProcess` は既にこのインターフェースを満たしています。5196カスタムプロセス生成用のインターフェース（`spawnClaudeCodeProcess` オプションで使用）。`ChildProcess` はすでにこのインターフェースを満たしています。

5179 5197

5180```typescript theme={null}5198```typescript theme={null}

5181interface SpawnedProcess {5199interface SpawnedProcess {

5206 `SpawnOptions`5224 `SpawnOptions`

5207</h3>5225</h3>

5208 5226

5209カスタムスポーン関数に渡されるオプション。5227カスタム spawn 関数に渡されるオプションです。

5210 5228

5211```typescript theme={null}5229```typescript theme={null}

5212interface SpawnOptions {5230interface SpawnOptions {

5219```5237```

5220 5238

5221<Note>5239<Note>

5222 `signal` フィールドは、スポーン関数にプロセスをティアダウンするタイミングを通知します。Node の `spawn()` に `signal` オプションとして渡すか、VM またはコンテナティアダウンハンドラーに渡してください。5240 `signal` フィールドは、プロセスをティアダウンするタイミングを spawn 関数に伝えます。Node の `spawn()` に `signal` オプションとして渡すか、VM またはコンテナティアダウンハンドラーに渡してください。

5223 5241

5224 このシグナルは、[`Options.abortController`](#options) が中止した瞬間には発火しません。SDK は最初にプロセスの stdin を閉じて約 2 秒待機し、CLI がクリーンにシャットダウンできるようにしてから、このシグナルを中止します。呼び出し元が中止した瞬間に反応するには、スポーン関数がそのエンクロージングスコープから参照できる独自の `Options.abortController.signal` をリッスンしてください。5242 このシグナルは [`Options.abortController`](#options) が中止する瞬間に発火しません。SDK は最初にプロセスの stdin を閉じ、CLI がクリーンにシャットダウンできるように約 2 秒待機してから、このシグナルを中止します。呼び出し元が中止する瞬間に反応するには、spawn 関数がそのエンクロージングスコープから参照できる独自の `Options.abortController.signal` をリッスンしてください。

5225</Note>5243</Note>

5226 5244

5227<h3 id="mcpsetserversresult">5245<h3 id="mcpsetserversresult">

5228 `McpSetServersResult`5246 `McpSetServersResult`

5229</h3>5247</h3>

5230 5248

5231`setMcpServers()` 操作の結果。5249`setMcpServers()` 操作の結果です。

5232 5250

5233```typescript theme={null}5251```typescript theme={null}

5234type McpSetServersResult = {5252type McpSetServersResult = {

5242 5260

5243* **呼び出しが名前を付けないサーバー**: Claude Code はプラグイン提供サーバーを実行し続けます。Agent SDK v0.3.210 以降が必要です。5261* **呼び出しが名前を付けないサーバー**: Claude Code はプラグイン提供サーバーを実行し続けます。Agent SDK v0.3.210 以降が必要です。

5244* **呼び出しが名前を付けるサーバー**: CLI が起動時に開始した組み込みサーバーを除き、Claude Code は実行中のサーバーを、渡した設定と異なる場合にのみ置き換えます。5262* **呼び出しが名前を付けるサーバー**: CLI が起動時に開始した組み込みサーバーを除き、Claude Code は実行中のサーバーを、渡した設定と異なる場合にのみ置き換えます。

5245* **CLI が起動時に開始した組み込みサーバー**: 呼び出しが 1 つを名前付けする場合、Claude Code はそのエントリを削除し、`errors` で報告します。5263* **CLI が起動時に開始した組み込みサーバー**: 呼び出しが 1 つを名前付けする場合、Claude Code はそのエントリをドロップし、`errors` で報告します。

5246 5264

5247新しく追加された stdio、HTTP、および SSE サーバーが接続または失敗した後、プロミスは解決されるため、接続されたサーバーからのツールは次のターンで利用可能です。5265新しく追加された stdio、HTTP、SSE サーバーが接続または失敗した後、プロミスが解決されるため、接続されたサーバーからのツールは次のターンで利用可能です。

5248 5266

5249`added` は Claude Code が追加または置き換えたサーバーをリストします。接続されたかどうかに関わらず。接続に失敗したサーバーは `added` と `errors` の両方に表示され、失敗テキストは `errors` の下にあり、[`mcpServerStatus()`](#methods) に `failed` 行があります。Claude Code v2.1.257 より前は、接続試行がスローされたサーバーは `errors` の下にのみ報告されていました。5267`added` は Claude Code が追加または置き換えたサーバーをリストします。接続したかどうかに関わらず。接続に失敗したサーバーは `added` と `errors` の両方に表示され、失敗テキストは `errors` の下にあり、[`mcpServerStatus()`](#methods) に `failed` 行があります。Claude Code v2.1.257 より前では、接続試行がスローされたサーバーは `errors` の下にのみ報告されました。

5250 5268

5251<h3 id="rewindfilesresult">5269<h3 id="rewindfilesresult">

5252 `RewindFilesResult`5270 `RewindFilesResult`

5253</h3>5271</h3>

5254 5272

5255`rewindFiles()` 操作の結果。5273`rewindFiles()` 操作の結果です。

5256 5274

5257```typescript theme={null}5275```typescript theme={null}

5258type RewindFilesResult = {5276type RewindFilesResult = {

5265};5283};

5266```5284```

5267 5285

5268`skippedLinks` は、リンク安全性のために巻き戻しが復元または削除を拒否した追跡パスをカウントします。追跡パスのシンボリックリンク、ハードリンク、またはその他の非通常ファイル、チェックポイントが取得されたときに指していた場所に解決されなくなった親ディレクトリ、または安全に読み取ることができなかったバックアップ。フィールドには Claude Code v2.1.216 以降が必要です。`rewindFiles(userMessageId, { dryRun: true })` でのプレビュー呼び出しはそれを設定しません。5286`skippedLinks` は、リンク安全性のためにリワインドが復元または削除を拒否した追跡パスをカウントします。追跡パスのシンボリックリンク、ハードリンク、またはその他の非通常ファイル、チェックポイント取得時に指していた場所に解決されなくなった親ディレクトリ、または安全に読み取ることができなかったバックアップ。フィールドには Claude Code v2.1.216 以降が必要です。`rewindFiles(userMessageId, { dryRun: true })` でのプレビュー呼び出しは設定しません。

5269 5287

5270<h3 id="sdkstatusmessage">5288<h3 id="sdkstatusmessage">

5271 `SDKStatusMessage`5289 `SDKStatusMessage`

5272</h3>5290</h3>

5273 5291

5274ステータス更新メッセージ（例：圧縮）。5292ステータス更新メッセージ（例：コンパクト化）。

5275 5293

5276```typescript theme={null}5294```typescript theme={null}

5277type SDKStatusMessage = {5295type SDKStatusMessage = {

5288 `SDKTaskNotificationMessage`5306 `SDKTaskNotificationMessage`

5289</h3>5307</h3>

5290 5308

5291バックグラウンドタスクが完了、失敗、または停止したときの通知。バックグラウンドタスクには、`run_in_background` Bash コマンド、[Monitor](#monitor) ウォッチ、およびバックグラウンドサブエージェントが含まれます。`ambient` フィールドについては、[`SDKTaskStartedMessage`](#sdktaskstartedmessage) を参照してください。これはそれを定義し、そのバージョン要件を定義します。5309バックグラウンドタスクが完了、失敗、または停止したときの通知です。バックグラウンドタスクには `run_in_background` Bash コマンド、[Monitor](#monitor) ウォッチ、バックグラウンドサブエージェントが含まれます。`ambient` フィールドについては、[`SDKTaskStartedMessage`](#sdktaskstartedmessage) を参照してください。これはそれを定義し、そのバージョン要件を定義します。

5292 5310

5293```typescript theme={null}5311```typescript theme={null}

5294type SDKTaskNotificationMessage = {5312type SDKTaskNotificationMessage = {

5311};5329};

5312```5330```

5313 5331

5314Claude Code が [長い MCP ツール呼び出しをバックグラウンドに移動](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) する場合、その呼び出しの `tool_result` ブロックはプレースホルダーのみを保持し、呼び出しの実際の結果はこの通知で到着します。`tool_use_id` で通知を呼び出しと照合します。完了通知では、`resource_links` はツールが [`SDKMcpResourceLink`](#sdkmcpresourcelink) エントリとして参照によって返したファイルをリストします。[`tool_use_result.resourceLinks`](#sdkusermessage) と同じ 50 リンクおよび 64 KiB 制限があります。Claude Code は結果にリンクがなかった場合、および MCP ツール呼び出しではないタスクの通知で `resource_links` を省略します。`resource_links` には Agent SDK v0.3.257 以降が必要です。5332Claude Code が [長い MCP ツール呼び出しをバックグラウンドに移動](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) する場合、その呼び出しの `tool_result` ブロックはプレースホルダーのみを保持し、呼び出しの実際の結果はこの通知で到着します。`tool_use_id` で通知を呼び出しと照合してください。

5333`completed` 通知では、`resource_links` はツールが [`SDKMcpResourceLink`](#sdkmcpresourcelink) エントリとして参照によって返したファイルをリストし、[`tool_use_result.resourceLinks`](#sdkusermessage) と同じ 50 リンクおよび 64 KiB 制限があります。Claude Code は結果にリンクがなく、MCP ツール呼び出しではないタスクの通知では `resource_links` を省略します。`resource_links` には Agent SDK v0.3.257 以降が必要です。

5315 5334

5316Claude Code は、[`scheduled-trigger` サブカインド](#task-notification-subkinds) でスタンプされた配信を除き、送信するすべてのタスク通知に通知を付加します。これらは代わりに割り当てられたタスクフレーミングを実行します。通知は、人間の入力が発生していないことを述べているため、モデルは通知をユーザー指示または承認として扱いません。5335Claude Code は、[`scheduled-trigger` サブカインド](#task-notification-subkinds) でスタンプされた配信を除き、送信するすべてのタスク通知にモデルへの通知を前置します。これらは代わりに割り当てられたタスクフレーミングを持ちます。通知は、人間の入力が発生していないため、モデルが通知をユーザー指示または承認として扱わないことを述べています。

5317 5336

5318タスク通知ターンを検出するには、[`SDKUserMessage`](#sdkusermessage) または [`SDKResultMessage`](#sdkresultmessage) で `origin.kind === "task-notification"` をチェックしてください。通知テキストの一致ではなく。同じフィールドから `subkind` を読んで、それを発生させたものを知る必要がある場合。v2.1.205 より前は、Claude Code はセッションがアイドル状態の間に到着した通知から通知を削除しました。5337タスク通知ターンを検出するには、[`SDKUserMessage`](#sdkusermessage) または [`SDKResultMessage`](#sdkresultmessage) で `origin.kind === "task-notification"` をチェックしてください。通知テキストの一致ではなく。必要に応じて同じフィールドから `subkind` を読んで、何がそれを発生させたかを知ってください。v2.1.205 より前では、Claude Code はセッションがアイドル状態の間に到着した通知から通知を除外しました。

5319 5338

5320<h3 id="sdktoolusesummarymessage">5339<h3 id="sdktoolusesummarymessage">

5321 `SDKToolUseSummaryMessage`5340 `SDKToolUseSummaryMessage`

5322</h3>5341</h3>

5323 5342

5324会話でのツール使用のサマリー。5343会話でのツール使用の概要です。

5325 5344

5326```typescript theme={null}5345```typescript theme={null}

5327type SDKToolUseSummaryMessage = {5346type SDKToolUseSummaryMessage = {

5337 `SDKHookStartedMessage`5356 `SDKHookStartedMessage`

5338</h3>5357</h3>

5339 5358

5340フックが実行を開始したときに発行されます。5359フックが実行を開始するときに発行されます。

5341 5360

5342Claude Code は、このメッセージ、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、および [`SDKHookResponseMessage`](#sdkhookresponsemessage) をメッセージストリームに直ちに配信します。これは、セッション起動中に `SessionStart` または `Setup` フックがまだ実行中であっても含まれます。Claude Code v2.1.169 から v2.1.203 は、`SessionStart` または `Setup` フックが完了した後、これらのメッセージを 1 つのバッチで配信していました。v2.1.204 はライブ配信を復元しました。5361Claude Code はこのメッセージ、[`SDKHookProgressMessage`](#sdkhookprogressmessage)、[`SDKHookResponseMessage`](#sdkhookresponsemessage) をメッセージストリームに直ちに配信します。セッション起動中に `SessionStart` または `Setup` フックがまだ実行中の場合も含みます。Claude Code v2.1.169 から v2.1.203 はこれらのメッセージを `SessionStart` または `Setup` フックが完了した後に 1 つのバッチで配信しました。v2.1.204 はライブ配信を復元しました。

5343 5362

5344```typescript theme={null}5363```typescript theme={null}

5345type SDKHookStartedMessage = {5364type SDKHookStartedMessage = {

5357 `SDKHookProgressMessage`5376 `SDKHookProgressMessage`

5358</h3>5377</h3>

5359 5378

5360フックが実行中に stdout/stderr 出力で発行されます。5379フックが実行中で、stdout/stderr 出力があるときに発行されます。

5361 5380

5362```typescript theme={null}5381```typescript theme={null}

5363type SDKHookProgressMessage = {5382type SDKHookProgressMessage = {

5378 `SDKHookResponseMessage`5397 `SDKHookResponseMessage`

5379</h3>5398</h3>

5380 5399

5381フックが実行を終了したときに発行されます。5400フックが実行を完了するときに発行されます。

5382 5401

5383```typescript theme={null}5402```typescript theme={null}

5384type SDKHookResponseMessage = {5403type SDKHookResponseMessage = {

5401 `SDKToolProgressMessage`5420 `SDKToolProgressMessage`

5402</h3>5421</h3>

5403 5422

5404ツール実行中に定期的に発行され、進捗を示します。5423ツールが実行中に定期的に発行され、進捗を示します。

5405 5424

5406```typescript theme={null}5425```typescript theme={null}

5407type SDKToolProgressMessage = {5426type SDKToolProgressMessage = {

5426};5445};

5427```5446```

5428 5447

5429ツール呼び出しがメイン会話で実行されている間、Claude Code は `heartbeat: true` で 30 秒ごとに `tool_progress` メッセージを発行します。各ハートビートはツール名と経過秒数を含むため、長時間実行される呼び出しを停止したセッションから区別できます。Claude Code はサブエージェント内のツール呼び出しのハートビートを発行しません。`heartbeat` フィールドには Agent SDK v0.3.214 以降が必要です。v2.1.257 より前は、Claude Code はフォアグラウンド Agent ツール呼び出しのハートビートも発行しませんでした。5448ツール呼び出しがメイン会話で実行されている間、Claude Code は `heartbeat: true` で 30 秒ごとに `tool_progress` メッセージを発行します。各ハートビートはツール名と経過秒数を持ち、長時間実行される呼び出しを停止したセッションと区別できます。Claude Code はサブエージェント内のツール呼び出しのハートビートを発行しません。`heartbeat` フィールドには Agent SDK v0.3.214 以降が必要です。v2.1.257 より前では、Claude Code はフォアグラウンド Agent ツール呼び出しのハートビートも発行しませんでした。

5430 5449

5431ハートビート以外の Agent ツールの `tool_progress` メッセージでは、`subagent_type` は実行中のサブエージェント型に名前を付けます。例えば `general-purpose`。`subagent_retry` は、レート制限またはオーバーロードなどの API エラーバックオフを待機している間に存在し、再試行試行ごとに 1 つのメッセージがあります。両方のフィールドには Agent SDK v0.3.214 以降が必要です。5450ハートビート以外の Agent ツールの `tool_progress` メッセージでは、`subagent_type` は実行中のサブエージェントタイプ（`general-purpose` など）に名前を付けます。`subagent_retry` はそのサブエージェントが API エラーバックオフ（レート制限やオーバーロードなど）を待機している間に存在し、再試行試行ごとに 1 つのメッセージがあります。両方のフィールドには Agent SDK v0.3.214 以降が必要です。

5432 5451

5433`subagent_retry` から再試行インジケーターをレンダリングするには。5452`subagent_retry` から再試行インジケーターをレンダリングするには：

5434 5453

5435* `parent_tool_use_id` でインジケーターを追跡します。これはサブエージェントごとに一意です。`tool_use_id` は 1 つのアシスタントターンから並列サブエージェントで共有されるため、それで追跡すると 1 つのサブエージェントの更新が別のサブエージェントのインジケーターをクリアします。5454* `parent_tool_use_id` でインジケーターを追跡します。これはサブエージェントごとに一意です。`tool_use_id` は 1 つのアシスタントターンから並列サブエージェントで共有されるため、それで追跡するとあるサブエージェントの更新が別のサブエージェントのインジケーターをクリアします。

5436* 同じ `parent_tool_use_id` の後の `tool_progress` が `subagent_retry` も `heartbeat: true` も含まない場合、またはツールの結果メッセージが到着したときにインジケーターをクリアします。`heartbeat: true` のフレームはライブネスのみを報告するため、 1 つが到着したときはインジケーターを保持します。`attempt` は永続的な再試行の下で `max_retries` を超える可能性があるため、カウンターからクリアを導出しないでください。5455* 同じ `parent_tool_use_id` の後の `tool_progress` が `subagent_retry` も `heartbeat: true` も持たない場合、またはツールの結果メッセージが到着したときにインジケーターをクリアします。`heartbeat: true` のフレームはライブネスのみを報告するため、1 つが到着したときはインジケーターを保持してください。`attempt` は永続的な再試行の下で `max_retries` を超える可能性があるため、カウンターからクリアを導出しないでください。

5437* `error_category` をディスプレイテキストではなく、独自のメッセージテキストを選択するためのトークンとして扱います。値は `rate_limit`、`overloaded`、`authentication_failed`、`server_error`、`cloud_credential_error`、および `unknown`。認識しない値を `unknown` と同じ方法で処理します。後のリリースは値を追加できるため。5456* `error_category` を表示テキストではなく、独自のメッセージテキストを選択するためのトークンとして扱います。値は `rate_limit`、`overloaded`、`authentication_failed`、`server_error`、`cloud_credential_error`、`unknown` です。認識しない値を `unknown` と同じ方法で処理してください。後のリリースは値を追加できるためです。

5438 5457

5439<h3 id="sdkauthstatusmessage">5458<h3 id="sdkauthstatusmessage">

5440 `SDKAuthStatusMessage`5459 `SDKAuthStatusMessage`

5457 `SDKTaskStartedMessage`5476 `SDKTaskStartedMessage`

5458</h3>5477</h3>

5459 5478

5460タスクが開始したときに発行されます。`task_type` フィールドは、Bash コマンドと [Monitor](#monitor) ウォッチの場合は `"local_bash"`、サブエージェントの場合は `"local_agent"`、またはリモートエージェントの場合は `"remote_agent"`。5479タスクが開始するときに発行されます。`task_type` フィールドは Bash コマンドと [Monitor](#monitor) ウォッチの場合は `"local_bash"`、サブエージェントの場合は `"local_agent"`、または `"remote_agent"` です。

5461 5480

5462```typescript theme={null}5481```typescript theme={null}

5463type SDKTaskStartedMessage = {5482type SDKTaskStartedMessage = {

5475};5494};

5476```5495```

5477 5496

5478`ambient` は、セッションの作業の一部ではないタスク（Claude Code が独自の操作のために実行するタスクなど）の場合は `true`。ライブ更新ウォッチャーも環境です。ユーザーが要求したウォッチャーを含む。環境タスクをアクティビティインジケーターから除外します。フィールドには Agent SDK v0.3.247 以降が必要です。5497`ambient` は、セッションの作業の一部ではないタスク（Claude Code が独自の操作のために実行するタスクなど）の場合は `true` です。ライブアップデートウォッチャーもアンビエントで、ユーザーが要求したウォッチャーを含みます。アクティビティインジケーターからアンビエントタスクを除外してください。フィールドには Agent SDK v0.3.247 以降が必要です。

5479 5498

5480`ambient` は [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) および [`SDKBackgroundTasksChangedMessage`](#sdkbackgroundtaskschangedmessage) エントリにも表示されます。5499`ambient` は [`SDKTaskNotificationMessage`](#sdktasknotificationmessage) および [`SDKBackgroundTasksChangedMessage`](#sdkbackgroundtaskschangedmessage) エントリにも表示されます。

5481 5500

5482`is_backgrounded` および `spawn_depth` は、Claude Code がタスクをどのように開始したかを説明します。両方のフィールドには Agent SDK v0.3.238 以降が必要です。5501`is_backgrounded` および `spawn_depth` は Claude Code がタスクをどのように開始したかを説明します。両方のフィールドには Agent SDK v0.3.238 以降が必要です。

5483 5502

5484* `is_backgrounded`: Claude Code は `"local_agent"` および `"local_bash"` タスクで設定します。`true` はタスクがバックグラウンドで実行されることを意味します。`false` はタスクがフォアグラウンドで実行され、それを開始したツール呼び出しはタスクが完了するか、バックグラウンドに移動するまでブロックされたままであることを意味します。5503* `is_backgrounded`: Claude Code は `"local_agent"` および `"local_bash"` タスクで設定します。`true` はタスクがバックグラウンドで実行されることを意味します。`false` はタスクがフォアグラウンドで実行され、それを開始したツール呼び出しはタスクが完了するかバックグラウンドに移動するまでブロックされたままであることを意味します。

5485* `spawn_depth`: Claude Code は `"local_agent"` タスクのみで設定します。メインスレッドが生成したサブエージェントの深さは `1`。深さ `1` サブエージェントが生成したサブエージェントの深さは `2`。以下同様。5504* `spawn_depth`: Claude Code は `"local_agent"` タスクのみで設定します。メインスレッドが生成したサブエージェントの深さは `1` です。深さ `1` サブエージェントが生成したサブエージェントの深さは `2` などです。

5486 5505

5487[再開されたサブエージェント](/docs/ja/agent-sdk/subagents#resume-subagents) は常に `is_backgrounded: true` を報告します。Claude Code はすべての再開されたサブエージェントをバックグラウンドで実行するため。フォアグラウンドタスクが後でバックグラウンドに移動する場合、Claude Code は新しい `is_backgrounded` 値を [`task_updated`](#sdktaskupdatedmessage) メッセージで報告し、2 番目の `task_started` を送信しません。5506[再開されたサブエージェント](/docs/ja/agent-sdk/subagents#resume-subagents) は常に `is_backgrounded: true` を報告します。Claude Code はすべての再開されたサブエージェントをバックグラウンドで実行するためです。フォアグラウンドタスクが後でバックグラウンドに移動する場合、Claude Code は新しい `is_backgrounded` 値を [`task_updated`](#sdktaskupdatedmessage) メッセージで報告し、2 番目の `task_started` を送信しません。

5488 5507

5489<h3 id="sdktaskprogressmessage">5508<h3 id="sdktaskprogressmessage">

5490 `SDKTaskProgressMessage`5509 `SDKTaskProgressMessage`

5491</h3>5510</h3>

5492 5511

5493サブエージェントまたはバックグラウンドタスクが実行中に定期的に発行されます。`summary` フィールドは、[`agentProgressSummaries`](#options) が有効な場合にのみ入力されます。5512サブエージェントまたはバックグラウンドタスクが実行中に定期的に発行されます。`summary` フィールドは [`agentProgressSummaries`](#options) が有効な場合にのみ入力されます。

5494 5513

5495```typescript theme={null}5514```typescript theme={null}

5496type SDKTaskProgressMessage = {5515type SDKTaskProgressMessage = {

5516 `SDKTaskUpdatedMessage`5535 `SDKTaskUpdatedMessage`

5517</h3>5536</h3>

5518 5537

5519バックグラウンドタスクの状態が変更されたときに発行されます。例えば、`running` から `completed` に遷移するときなど。`patch` をローカルタスクマップ（`task_id` でキー付け）にマージしてください。`end_time` フィールドは Unix エポックタイムスタンプ（ミリ秒単位）で、`Date.now()` と比較可能です。5538バックグラウンドタスクの状態が変わるときに発行されます。例えば、`running` から `completed` に遷移するときなど。`patch` をローカルタスクマップ（`task_id` でキー付け）にマージしてください。`end_time` フィールドは Unix エポックタイムスタンプ（ミリ秒単位）で、`Date.now()` と比較可能です。

5520 5539

5521```typescript theme={null}5540```typescript theme={null}

5522type SDKTaskUpdatedMessage = {5541type SDKTaskUpdatedMessage = {

5540 `SDKBackgroundTasksChangedMessage`5559 `SDKBackgroundTasksChangedMessage`

5541</h3>5560</h3>

5542 5561

5543ライブバックグラウンドタスクのセットが変更されるたびに発行されます。タスクが開始、完了、キル、フォアグラウンドエージェントがバックグラウンド化、またはタスクの `description` または `ambient` フィールドが変更されるときです。5562ライブバックグラウンドタスクのセットが変わるときに発行されます。タスクが開始、完了、キル、フォアグラウンドエージェントがバックグラウンド化、またはタスクの `description` または `ambient` フィールドが変わるときなど。

5544 5563

5545`tasks` 配列はライブセット全体です。`task_started` および `task_notification` イベントをペアリングするのではなく、各ペイロードでキャッシュされたセットを置き換えてください。そのため、次のメンバーシップ変更は、逃したイベントを修正します。5564`tasks` 配列はライブセット全体です。`task_started` および `task_notification` イベントをペアリングするのではなく、各ペイロードでキャッシュされたセットを置き換えてください。次のメンバーシップ変更は逃したイベントを修正します。

5546 5565

5547これらのタスク単位のイベントに対する順序付けは指定されていないため、2 つのストリームを相関させないでください。5566これらのタスクごとのイベントに対する順序付けは指定されていないため、2 つのストリームを相関させないでください。

5548 5567

5549起動時には何も発行されません。セッションの CLI プロセスが開始または再開されるたびに空のセットにリセットし、次のメンバーシップ変更でそれを再入力させてください。5568起動時には何も発行されません。セッションの CLI プロセスが開始または再開されるたびに空のセットにリセットし、次のメンバーシップ変更でそれを再入力させてください。

5550 5569

5551実行中のセッションに繰り返される `initialize` 制御リクエストを送信する場合（例えば、トランスポートギャップ後に [`reinitialize()`](#query-object) を使用）、Claude Code は応答に続いて現在のライブセットのスナップショットを配信します。空の場合でも。再接続ホストは、次のメンバーシップ変更を待つことなく、何が実行されているかを学習します。Agent SDK v0.3.239 より前は、Claude Code は繰り返された `initialize` の後にスナップショットを送信しませんでした。5570実行中のセッションに繰り返される `initialize` 制御リクエストを送信する場合（例えば、トランスポートギャップ後の [`reinitialize()`](#query-object)）、Claude Code は応答に続いて現在のライブセットのスナップショットを送信します。空の場合でも。再接続ホストは次のメンバーシップ変更を待つことなく何が実行されているかを学習します。Agent SDK v0.3.239 より前では、Claude Code は繰り返された `initialize` の後にスナップショットを送信しませんでした。

5552 5571

5553Claude Code v2.1.203 以降が必要です。5572Claude Code v2.1.203 以降が必要です。

5554 5573

5571 `SDKThinkingTokensMessage`5590 `SDKThinkingTokensMessage`

5572</h3>5591</h3>

5573 5592

5574Claude が思考ブロック（編集されたものを含む）を生成している間に発行されます。`estimated_tokens` は現在のブロックで生成された思考トークンの実行中の推定値で、`estimated_tokens_delta` はこのフレームで実行された増分です。進捗表示に使用してください。5593Claude が思考ブロック（編集されたものを含む）を生成している間に発行されます。`estimated_tokens` は現在のブロックで生成された思考トークンの実行推定値で、`estimated_tokens_delta` はこのフレームで持ち込まれた増分です。進捗表示にこれらの推定値を使用してください。

5575 5594

5576モデルまたはプロバイダーが分類を報告する場合、トップレベルエージェントループの最終カウントは結果メッセージの [`usage.output_tokens_details.thinking_tokens`](#usage) です。これは [サブエージェントトークンを含みません](/docs/ja/agent-sdk/cost-tracking#get-the-total-cost-of-a-query)。5595モデルまたはプロバイダーが分類を報告する場合、トップレベルエージェントループの最終カウントは結果メッセージの [`usage.output_tokens_details.thinking_tokens`](#usage) です。これは [サブエージェントトークンを含みません](/docs/ja/agent-sdk/cost-tracking#get-the-total-cost-of-a-query)。

5577 5596

5593 `SDKFilesPersistedEvent`5612 `SDKFilesPersistedEvent`

5594</h3>5613</h3>

5595 5614

5596ファイルチェックポイントがディスクに永続化されたときに発行されます。5615ファイルチェックポイントがディスクに永続化されるときに発行されます。

5597 5616

5598```typescript theme={null}5617```typescript theme={null}

5599type SDKFilesPersistedEvent = {5618type SDKFilesPersistedEvent = {

5611 `SDKRateLimitEvent`5630 `SDKRateLimitEvent`

5612</h3>5631</h3>

5613 5632

5614セッションがレート制限に遭遇したときに発行されます。5633セッションがレート制限に遭遇するときに発行されます。

5615 5634

5616```typescript theme={null}5635```typescript theme={null}

5617type SDKRateLimitEvent = {5636type SDKRateLimitEvent = {

5629};5648};

5630```5649```

5631 5650

5632`errorCode` が `"credits_required"` の場合、拒否は含まれた使用量が枯渇した claude.ai サブスクリプションからのもので、ユーザーが使用クレジットを購入するまでセッションは続行できません。`canUserPurchaseCredits` は認証されたユーザーがアカウントのクレジットを購入できるかどうかを示し、`hasChargeableSavedPaymentMethod` は保存された支払い方法がファイルにあるかどうかを示します。3 つのフィールドすべてはクレジット必須の拒否ではないレート制限イベントには存在しません。Claude Code v2.1.181 以降が必要です。5651`errorCode` が `"credits_required"` の場合、拒否は含まれた使用量が枯渇した claude.ai サブスクリプションからのもので、ユーザーが使用クレジットを購入するまでセッションは続行できません。`canUserPurchaseCredits` はアカウントのクレジットを購入できるかどうかを示し、`hasChargeableSavedPaymentMethod` は保存された支払い方法がファイルにあるかどうかを示します。3 つのフィールドすべてはクレジット必須拒否ではないレート制限イベントでは存在しません。Claude Code v2.1.181 以降が必要です。

5633 5652

5634<h3 id="sdklocalcommandoutputmessage">5653<h3 id="sdklocalcommandoutputmessage">

5635 `SDKLocalCommandOutputMessage`5654 `SDKLocalCommandOutputMessage`

5651 `SDKCommandsChangedMessage`5670 `SDKCommandsChangedMessage`

5652</h3>5671</h3>

5653 5672

5654利用可能なコマンドのセットがセッション中に変更されたときに発行されます。例えば、エージェントがサブディレクトリに入るときにスキルが検出されるなど。`commands` 配列は完全に更新されたリストであるため、キャッシュされたコマンドリストをこのペイロードで置き換えてください。このメッセージの後に [`supportedCommands()`](#query-object) を呼び出すと、同じ更新されたリストが返されます。メソッドは最新のプッシュを追跡するため。これには Agent SDK v0.3.216 以降が必要です。以前の SDK バージョンでは、`supportedCommands()` は初期化時にキャプチャされたスナップショットを返し、セッション中の変更を反映しません。5673利用可能なコマンドのセットがセッション中に変わるときに発行されます。例えば、Claude Code がエージェントがサブディレクトリに入るときにスキルを発見するときなど。`commands` 配列は完全に更新されたリストなため、このペイロードでキャッシュされたコマンドリストを置き換えてください。

5674このメッセージの後に [`supportedCommands()`](#query-object) を呼び出すと、メソッドが最新のプッシュを追跡するため、同じ更新されたリストが返されます。これには Agent SDK v0.3.216 以降が必要です。以前の SDK バージョンでは、`supportedCommands()` は初期化時にキャプチャされたスナップショットを返し、セッション中の変更を反映しません。

5655 5675

5656```typescript theme={null}5676```typescript theme={null}

5657type SDKCommandsChangedMessage = {5677type SDKCommandsChangedMessage = {

5667 `SDKPromptSuggestionMessage`5687 `SDKPromptSuggestionMessage`

5668</h3>5688</h3>

5669 5689

5670[`promptSuggestions`](#options) が有効な場合、各ターン後に発行されます。Claude Code がそのターンの提案を生成した場合。予測される次のユーザープロンプトを含みます。提案を取得しないターンについては、[Claude Code が提案をスキップする場合](/docs/ja/interactive-mode#when-claude-code-skips-suggestions) を参照してください。5690[`promptSuggestions`](#options) が有効で Claude Code がそのターンの提案を生成した後、ターンの後に発行されます。予測される次のユーザープロンプトが含まれます。提案を取得しないターンについては、[Claude Code が提案をスキップする場合](/docs/ja/interactive-mode#when-claude-code-skips-suggestions) を参照してください。

5671 5691

5672```typescript theme={null}5692```typescript theme={null}

5673type SDKPromptSuggestionMessage = {5693type SDKPromptSuggestionMessage = {

5682 `SDKConversationResetMessage`5702 `SDKConversationResetMessage`

5683</h3>5703</h3>

5684 5704

5685セッションの会話がセッションを終了せずに置き換えられたときに発行されます。`query()` 呼び出しでは、`/clear` とそのエイリアスのみがこのメッセージを生成します。`new_conversation_id` の下に空のトランスクリプトをマウントし、キャッシュされたセッションタイトルを破棄してください。5705セッションを終了せずにセッションの会話が置き換えられるときに発行されます。`query()` 呼び出しでは、`/clear` とそのエイリアスのみがこのメッセージを生成します。`new_conversation_id` の下に空のトランスクリプトをマウントし、キャッシュされたセッションタイトルを破棄してください。

5686 5706

5687```typescript theme={null}5707```typescript theme={null}

5688type SDKConversationResetMessage = {5708type SDKConversationResetMessage = {

5693};5713};

5694```5714```

5695 5715

5696SDK の公開された型定義は Claude Code v2.1.203 以降で `SDKConversationResetMessage` を宣言しています。v2.1.203 より前では、`SDKMessage` は型を宣言せずに参照していたため、`skipLibCheck` が無効な場合、`type === "conversation_reset"` での絞り込みは型チェックに失敗しました。5716SDK の公開された型付けは Claude Code v2.1.203 以降で `SDKConversationResetMessage` を宣言します。v2.1.203 より前では、`SDKMessage` は型を宣言せずに参照したため、`skipLibCheck` が無効な場合、`type === "conversation_reset"` での絞り込みは型チェックに失敗しました。

5697 5717

5698<h3 id="aborterror">5718<h3 id="aborterror">

5699 `AbortError`5719 `AbortError`

5700</h3>5720</h3>

5701 5721

5702中止操作のカスタムエラークラス。5722中止操作のカスタムエラークラスです。

5703 5723

5704```typescript theme={null}5724```typescript theme={null}

5705class AbortError extends Error {}5725class AbortError extends Error {}

5706```5726```

5707 5727

5708`AbortError` は SDK の型付き API の唯一のエラークラスです。Claude Code プロセスの終了または起動失敗など、その他の失敗は、SDK クラスと照合するエラーなしでメッセージ反復を拒否します。[トラブルシューティング](/docs/ja/agent-sdk/troubleshooting) はそれらのエラーをメッセージでキー付けし、各エラーの原因と修正を提供します。5728`AbortError` は SDK の型付き API の唯一のエラークラスです。Claude Code プロセスの終了や起動失敗など、その他の失敗は、SDK クラスと照合するメッセージイテレーションを拒否します。[トラブルシューティング](/docs/ja/agent-sdk/troubleshooting) はそれらのエラーをメッセージでキー付けし、各エラーの原因と修正を示します。

5709 5729

5710<h2 id="sandbox-configuration">5730<h2 id="sandbox-configuration">

5711 サンドボックス設定5731 サンドボックス設定

5733```5753```

5734 5754

5735| プロパティ | 型 | デフォルト | 説明 |5755| プロパティ | 型 | デフォルト | 説明 |

5736| :-------------------------- | :---------------------------------------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |5756| :-------------------------- | :---------------------------------------------------- | :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

5741| `allowUnsandboxedCommands` | `boolean` | `true` | モデルがサンドボックス外でコマンドを実行するようにリクエストすることを許可します。`true` の場合、モデルはツール入力で `dangerouslyDisableSandbox` を設定でき、[パーミッションシステム](#permissions-fallback-for-unsandboxed-commands) にフォールバックします |5761| `allowUnsandboxedCommands` | `boolean` | `true` | モデルがサンドボックス外でコマンドを実行するようにリクエストすることを許可します。`true` の場合、モデルはツール入力で `dangerouslyDisableSandbox` を設定でき、[パーミッションシステム](#permissions-fallback-for-unsandboxed-commands) にフォールバックします |

5844 サンドボックス外コマンドのパーミッションフォールバック5864 サンドボックス外コマンドのパーミッションフォールバック

5845</h3>5865</h3>

5846 5866

5847`allowUnsandboxedCommands` が有効な場合、モデルはツール入力で `dangerouslyDisableSandbox: true` を設定することで、サンドボックス外でコマンドを実行するようにリクエストできます。これらのリクエストは既存のパーミッションシステムにフォールバックします。つまり、`canUseTool` ハンドラーが呼び出され、カスタム認可ロジックを実装できます。`excludedCommands` にリストされているコマンドは、代わりにサンドボックスを自動的にバイパスし、モデルの関与はありません。[`SandboxSettings`](#sandboxsettings) を参照してください。5867`allowUnsandboxedCommands` が有効な場合、モデルはツール入力で `dangerouslyDisableSandbox: true` を設定することで、サンドボックス外でコマンドを実行するようにリクエストできます。これらのリクエストは既存のパーミッションシステムにフォールバックします。つまり、`canUseTool` ハンドラーが呼び出され、カスタム認可ロジックを実装できます。

5868

5869`excludedCommands` エントリは、代わりにサンドボックスを自動的にバイパスし、モデルの関与はありません。[`sandbox.excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) を参照して、エントリが適用される場合を確認してください。

5848 5870

5849下の例では、`isCommandAuthorized` は定義する認可チェックの代わりです。5871下の例では、`isCommandAuthorized` は定義する認可チェックの代わりです。

5850 5872

agent-teams.md +0 −4

Details

14 14

15チームを設定する前に、より軽量なオプションで十分かどうかを確認してください。[Subagents](/docs/ja/sub-agents) は単一セッション内で動作し、[クロスセッションメッセージング](/docs/ja/cross-session-messaging) を使用すると Claude は自分で実行するセッション間で検出結果を渡すことができます。15チームを設定する前に、より軽量なオプションで十分かどうかを確認してください。[Subagents](/docs/ja/sub-agents) は単一セッション内で動作し、[クロスセッションメッセージング](/docs/ja/cross-session-messaging) を使用すると Claude は自分で実行するセッション間で検出結果を渡すことができます。

16 16

~~17<Note>~~

18 このページは v2.1.178 時点のエージェントチームについて説明しています。`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` が設定されている場合、チームメンバーのスポーンにはセットアップステップが不要になり、セッション終了時にクリーンアップが自動的に行われます。v2.1.178 より前は、最初にチームを作成して名前を付けるよう Claude に依頼し、Claude は `TeamCreate` と `TeamDelete` ツールを使用してセットアップと削除を行いました。両方のツールはもう存在しません。Agent ツールの `team_name` 入力は受け入れられますが無視され、`TaskCreated`、`TaskCompleted`、および `TeammateIdle` [hook ペイロード](/docs/ja/hooks#taskcreated)の `team_name` フィールドはセッション派生名を含み、非推奨です。

~~19</Note>~~

21<h2 id="when-to-use-agent-teams">17<h2 id="when-to-use-agent-teams">

22 エージェントチームを使用する場合18 エージェントチームを使用する場合

23</h2>19</h2>

amazon-bedrock.md +7 −7

Details

291 291

292これらの環境変数を特定の Amazon Bedrock モデル ID に設定してください。292これらの環境変数を特定の Amazon Bedrock モデル ID に設定してください。

293 293

294`ANTHROPIC_DEFAULT_OPUS_MODEL` がない場合、Amazon Bedrock の `opus` エイリアスは Opus 5 に解決され、`ANTHROPIC_DEFAULT_SONNET_MODEL` がない場合、`sonnet` エイリアスは Sonnet 4.5 に解決されます。この例では各エイリアスを特定のバージョンにピンしています。294`ANTHROPIC_DEFAULT_OPUS_MODEL` がない場合、Amazon Bedrock の `opus` エイリアスは Opus 5.5 に解決され、`ANTHROPIC_DEFAULT_SONNET_MODEL` がない場合、`sonnet` エイリアスは Sonnet 4.5 に解決されます。この例では各エイリアスを特定のバージョンにピンしています。

295 295

296```bash theme={null}296```bash theme={null}

297export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'297export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'

304組み込みデフォルトモデルを保持し、優先プレフィックスのみを変更するには、ピンの代わりに [`ANTHROPIC_BEDROCK_REGION_PREFIX`](#cross-region-inference-profile-prefixes) を設定してください。`opus` エイリアスが解決する内容の違いを示します。304組み込みデフォルトモデルを保持し、優先プレフィックスのみを変更するには、ピンの代わりに [`ANTHROPIC_BEDROCK_REGION_PREFIX`](#cross-region-inference-profile-prefixes) を設定してください。`opus` エイリアスが解決する内容の違いを示します。

305 305

307| :------------------------------------------------------------ | :------------------------------------------------- |307| :------------------------------------------------------------ | :--------------------------------------------------- |

310 310

311現在および従来のモデル ID については、[Models overview](https://platform.claude.com/docs/en/about-claude/models/overview) を参照してください。ピン環境変数の完全なリストについては、[Model configuration](/docs/ja/model-config#pin-models-for-third-party-deployments) を参照してください。311現在および従来のモデル ID については、[Models overview](https://platform.claude.com/docs/en/about-claude/models/overview) を参照してください。ピン環境変数の完全なリストについては、[Model configuration](/docs/ja/model-config#pin-models-for-third-party-deployments) を参照してください。

312 312

314 314

315| モデルタイプ | デフォルトモデル |315| モデルタイプ | デフォルトモデル |

316| :------- | :-------------------------------------------------------------------------- |316| :------- | :-------------------------------------------------------------------------- |

319 319

320セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル（通常は Haiku クラスモデル）を使用します。Amazon Bedrock では、すべてのアカウントまたはリージョンで Haiku が有効になっていない可能性があるため、Claude Code はバックグラウンドタスクにデフォルト Sonnet モデルを使用します。2 つの選択がどのモデルがそれらを実行するかを変更します。320セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル（通常は Haiku クラスモデル）を使用します。Amazon Bedrock では、すべてのアカウントまたはリージョンで Haiku が有効になっていない可能性があるため、Claude Code はバックグラウンドタスクにデフォルト Sonnet モデルを使用します。2 つの選択がどのモデルがそれらを実行するかを変更します。

326 Opus モデルは Sonnet モデルより高いトークンあたりの価格を持つため、プライマリモデルをピンしないデプロイメントは v2.1.207 以降に更新されると Opus レートで請求されます。Sonnet 4.5 をプライマリモデルとして保持するには、`ANTHROPIC_MODEL` をその完全なモデル ID に設定してください。`ANTHROPIC_DEFAULT_SONNET_MODEL` で操舵され、`ANTHROPIC_DEFAULT_OPUS_MODEL` を設定しないデプロイメントは、操舵された Sonnet モデルをデフォルトとして保持します。326 Opus モデルは Sonnet モデルより高いトークンあたりの価格を持つため、プライマリモデルをピンしないデプロイメントは v2.1.207 以降に更新されると Opus レートで請求されます。Sonnet 4.5 をプライマリモデルとして保持するには、`ANTHROPIC_MODEL` をその完全なモデル ID に設定してください。`ANTHROPIC_DEFAULT_SONNET_MODEL` で操舵され、`ANTHROPIC_DEFAULT_OPUS_MODEL` を設定しないデプロイメントは、操舵された Sonnet モデルをデフォルトとして保持します。

327</Warning>327</Warning>

328 328

329v2.1.207 から v2.1.218 では、Amazon Bedrock のプライマリモデルは Opus 4.8 にデフォルト設定され、`opus` エイリアスは Opus 4.8 に解決されました。v2.1.207 より前では、プライマリモデルは Sonnet 4.5 にデフォルト設定され、`opus` エイリアスは Opus 4.6 に解決され、バックグラウンドタスクは常にプライマリモデルを使用していました。329v2.1.280 より前では、Amazon Bedrock のプライマリモデルは Opus 5 にデフォルト設定され、`opus` エイリアスは v2.1.219 から Opus 5 に解決されました。v2.1.207 から v2.1.218 では、Amazon Bedrock のプライマリモデルは Opus 4.8 にデフォルト設定され、`opus` エイリアスは Opus 4.8 に解決されました。v2.1.207 より前では、プライマリモデルは Sonnet 4.5 にデフォルト設定され、`opus` エイリアスは Opus 4.6 に解決され、バックグラウンドタスクは常にプライマリモデルを使用していました。

330 330

331モデルをさらにカスタマイズするには、以下のいずれかの方法を使用してください。331モデルをさらにカスタマイズするには、以下のいずれかの方法を使用してください。

332 332

405```bash theme={null}405```bash theme={null}

406export ANTHROPIC_BEDROCK_REGION_PREFIX=global406export ANTHROPIC_BEDROCK_REGION_PREFIX=global

407# us-* リージョンでは、プライマリモデルは407# us-* リージョンでは、プライマリモデルは

408# us.anthropic.claude-opus-5 の代わりに408# us.anthropic.claude-opus-5-5 の代わりに

409# global.anthropic.claude-opus-5 に解決されます409# global.anthropic.claude-opus-5-5 に解決されます

410```410```

411 411

412優先プレフィックスは保証ではなく、リージョンから来ているか変数から来ているかに関わらず、単なる優先度です。Claude Code がそれを適用する方法は、アカウント内のプロファイル可用性を確認できるかどうかによって異なります。412優先プレフィックスは保証ではなく、リージョンから来ているか変数から来ているかに関わらず、単なる優先度です。Claude Code がそれを適用する方法は、アカウント内のプロファイル可用性を確認できるかどうかによって異なります。

artifacts.md +2 −2

Details

347アーティファクトには、以下のすべての条件が必要です。いずれかが満たされていない場合、Claude はローカル HTML ファイルを書き込むか、公開できないと言います。347アーティファクトには、以下のすべての条件が必要です。いずれかが満たされていない場合、Claude はローカル HTML ファイルを書き込むか、公開できないと言います。

348 348

349| 要件 | 利用可能な場合 |349| 要件 | 利用可能な場合 |

350| :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |350| :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

351| プラン | Pro、Max、Team、または Enterprise。Pro および Max プランでは、アーティファクトはあなたにプライベートであり、共有するまで管理者管理は適用されません。Team プランでは、アーティファクトはデフォルトで有効です。Enterprise プランでは、Owner が claude.ai 管理設定で[有効にします](#manage-artifacts-for-your-organization)。 |351| プラン | Pro、Max、Team、または Enterprise。Pro および Max プランでは、アーティファクトはあなたにプライベートであり、共有するまで管理者管理は適用されません。Team プランでは、アーティファクトはデフォルトで有効です。Enterprise プランでは、Owner が claude.ai 管理設定で[有効にします](#manage-artifacts-for-your-organization)。 |

352| 認証 | セッションは claude.ai アカウントでバックアップされています。CLI またはデスクトップアプリで `/login` でサインインしてください。Claude Tag セッションはエージェントの ID を通じてサインインするため、追加の手順は不要です。API キー、[ゲートウェイトークン](/docs/ja/llm-gateway)、またはクラウドプロバイダー認証情報を使用するセッションは公開できません。 |352| 認証 | セッションは claude.ai アカウントでバックアップされています。CLI またはデスクトップアプリで `/login` でサインインしてください。Claude Tag セッションはエージェントの ID を通じてサインインするため、追加の手順は不要です。API キー、[ゲートウェイトークン](/docs/ja/llm-gateway)、またはクラウドプロバイダー認証情報を使用するセッションは公開できません。 |

353| モデルプロバイダー | Anthropic API。[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、または [Microsoft Foundry](/docs/ja/microsoft-foundry) では利用できません。 |353| モデルプロバイダー | Anthropic API。[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、または [Microsoft Foundry](/docs/ja/microsoft-foundry) では利用できません。 |

354| 組織ポリシー | カスタマー管理暗号化キー（CMEK）、HIPAA、および [Zero Data Retention](/docs/ja/zero-data-retention) は組織で有効になっていません。 |354| 組織ポリシー | カスタマー管理暗号化キー（CMEK）、HIPAA、および [Zero Data Retention](/docs/ja/zero-data-retention) は組織で有効になっていません。 |

355| サーフェス | Claude Code CLI バージョン 2.1.183 以降、または Claude デスクトップアプリバージョン 1.13576.0 以降。[Claude Tag](https://claude.com/docs/claude-tag/overview) セッションは、Claude Tag とアーティファクトの両方が組織で有効になっている場合、アーティファクトを公開することもできます。[Agent SDK](/docs/ja/agent-sdk/overview)、GitHub Action、MCP サーバーコンテキストではデフォルトでオフになっており、[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) が設定されている場合もオフになります。 |355| サーフェス | Claude Code CLI、または Claude デスクトップアプリバージョン 1.13576.0 以降。[Claude Tag](https://claude.com/docs/claude-tag/overview) セッションは、Claude Tag とアーティファクトの両方が組織で有効になっている場合、アーティファクトを公開することもできます。[Agent SDK](/docs/ja/agent-sdk/overview)、GitHub Action、MCP サーバーコンテキストではデフォルトでオフになっており、[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) が設定されている場合もオフになります。 |

356 356

357<h2 id="disable-artifacts">357<h2 id="disable-artifacts">

358 アーティファクトを無効にする358 アーティファクトを無効にする

authentication.md +2 −2

Details

53 53

54[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) と [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) は、Claude Code を使用する組織に最適なエクスペリエンスを提供します。チームメンバーは Claude Code と Web 上の Claude の両方にアクセスでき、一元化された請求とチーム管理が可能です。54[Claude for Teams](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_teams#team-&-enterprise) と [Claude for Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_enterprise) は、Claude Code を使用する組織に最適なエクスペリエンスを提供します。チームメンバーは Claude Code と Web 上の Claude の両方にアクセスでき、一元化された請求とチーム管理が可能です。

55 55

~~56* **Claude for Teams**: コラボレーション機能、管理ツール、請求管理を備えたセルフサービスプラン。小規模なチームに最適です。~~56* **Claude for Teams**: コラボレーション機能、管理ツール、SSO、請求管理、および組織全体の Claude Code 設定のための [サーバー管理設定](/docs/ja/server-managed-settings)を備えたセルフサービスプラン。小規模なチームに最適です。

57* **Claude for Enterprise**: SSO、ドメインキャプチャ、ロールベースの権限、コンプライアンス API、および組織全体の Claude Code 設定のための管理ポリシー設定を追加します。セキュリティとコンプライアンス要件を持つ大規模な組織に最適です。57* **Claude for Enterprise**: ドメインキャプチャ、ロールベースの権限、およびコンプライアンス API を追加します。セキュリティとコンプライアンス要件を持つ大規模な組織に最適です。

58 58

59<Steps>59<Steps>

60 <Step title="購読">60 <Step title="購読">

claude-code-on-the-web.md +2 −2

Details

250 250

251クラウドセッションは[組み込みコマンド](/docs/ja/commands)をサポートしており、テキスト出力を生成します。ターミナルインターフェイスでのみ実行されるコマンド（`/plugin` や `/resume` など）は利用できません。ターミナルでピッカーまたはパネルを開くコマンドはクラウドセッションで異なる動作をします：251クラウドセッションは[組み込みコマンド](/docs/ja/commands)をサポートしており、テキスト出力を生成します。ターミナルインターフェイスでのみ実行されるコマンド（`/plugin` や `/resume` など）は利用できません。ターミナルでピッカーまたはパネルを開くコマンドはクラウドセッションで異なる動作をします：

252 252

253* **`/model`、`/effort`、`/color`、`/rename`**：ターミナルピッカーまたはスライダーを開く代わりに、引数として値を渡します。例えば `/model sonnet` のように使用します。引数形式はセッションの環境で Claude Code v2.1.205 以降が必要であり、各コマンドの[利用可能性に関する注記](/docs/ja/commands#all-commands)に従います。`/effort` はモデルの[起動デフォルト努力保持](/docs/ja/model-config#adjust-effort-level)が有効な場合は `Not applied` を報告します。253* **`/model`、`/effort`、`/color`、`/rename`**：ターミナルピッカーまたはスライダーを開く代わりに、引数として値を渡します。例えば `/model sonnet` のように使用します。引数形式はセッションの環境で Claude Code v2.1.205 以降が必要であり、各コマンドの[利用可能性に関する注記](/docs/ja/commands#all-commands)に従います。

254* **`/fast`**：アカウントで[利用可能な場合](/docs/ja/fast-mode#requirements)、セッションの[ファストモード](/docs/ja/fast-mode#use-fast-mode-in-cloud-sessions)を切り替えます。セッションの環境で Claude Code v2.1.271 以降が必要です。254* **`/fast`**：アカウントで[利用可能な場合](/docs/ja/fast-mode#requirements)、セッションの[ファストモード](/docs/ja/fast-mode#use-fast-mode-in-cloud-sessions)を切り替えます。セッションの環境で Claude Code v2.1.271 以降が必要です。

255* **`/config`**：ウェブ上では、値を設定する代わりに Claude Code セクションの設定を開き、`key=value` を含むコマンド後のテキストは無視されます。クラウドセッションの設定を変更するには、[環境変数](/docs/ja/cloud-environments#set-environment-variables)を環境に設定するか、1 つのリポジトリを持つセッションでキーをそのリポジトリの `.claude/settings.json` にコミットします。[クラウドセッションの設定](/docs/ja/settings#settings-in-cloud-sessions)には各セッションが読み込むものが記載されています。255* **`/config`**：ブラウザの claude.ai/code では、値を設定する代わりに Claude Code セクションの設定を開き、`key=value` を含むコマンド後のテキストは無視されます。クラウドセッションの設定を変更するには、[環境変数](/docs/ja/cloud-environments#set-environment-variables)を環境に設定するか、1 つのリポジトリを持つセッションでキーをそのリポジトリの `.claude/settings.json` にコミットします。[クラウドセッションの設定](/docs/ja/settings#settings-in-cloud-sessions)には各セッションが読み込むものが記載されています。

256 256

257コンテキスト管理の場合：257コンテキスト管理の場合：

258 258

claude-directory.md +25 −7

Details

1451エクスプローラーは、あなたが作成および編集するファイルをカバーしています。いくつかの関連ファイルは他の場所にあります。1451エクスプローラーは、あなたが作成および編集するファイルをカバーしています。いくつかの関連ファイルは他の場所にあります。

1452 1452

1453| ファイル | 場所 | 目的 |1453| ファイル | 場所 | 目的 |

1454| ----------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1454| ----------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1455| `managed-settings.json` | システムレベル、OS によって異なる | エンタープライズが強制する設定で、[限定的な例外](/docs/ja/settings#security-keys-where-the-stricter-value-applies)を除いてオーバーライドできません。[ファイルの保存場所](/docs/ja/managed-settings#deploy-a-managed-settings-file)と [Claude Code が使用する管理ソース](/docs/ja/managed-settings#precedence-within-the-managed-tier)を参照してください。 |1455| `managed-settings.json` | システムレベル、OS によって異なる | エンタープライズが強制する設定で、[限定的な例外](/docs/ja/settings#security-keys-where-the-stricter-value-applies)を除いてオーバーライドできません。[ファイルの保存場所](/docs/ja/managed-settings#deploy-a-managed-settings-file)と [Claude Code が使用する管理ソース](/docs/ja/managed-settings#precedence-within-the-managed-tier)を参照してください。 |

1457| `AGENTS.md` | プロジェクトルート、`.claude/`、または任意のディレクトリ | AI コーディングエージェント向けに作成するプロジェクト指示。Claude Code は[それを読み込む](/docs/ja/memory#agents-md)ことができます。これは独立して、または `CLAUDE.md` と一緒に読み込まれます。 |1457| `AGENTS.md` | プロジェクトルート、`.claude/`、または任意のディレクトリ | AI コーディングエージェント向けに作成するプロジェクト指示。Claude Code は[それを読み込む](/docs/ja/memory#agents-md)ことができます。これは独立して、または `CLAUDE.md` と一緒に読み込まれます。 |

1458| インストール済みプラグイン | `~/.claude/plugins` | クローンされたマーケットプレイス、インストール済みプラグインバージョン、およびプラグインごとのデータで、`claude plugin` コマンドで管理されます。リンクモードでマーケットプレイス [`command` ソース](/docs/ja/plugin-marketplaces#command-sources)からインストールされたプラグインの場合、Claude Code はコピーの代わりにここにリンクを保存し、プラグインのファイルはコマンドが出力するディレクトリに留まります。`command` ソースには Claude Code v2.1.229 以降が必要です。ローカルディレクトリマーケットプレイスで相対パスでリストされているプラグインも、キャッシュコピーではなく、ソースディレクトリから[その場で読み込まれます](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)。[プラグインキャッシング](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)を参照して、孤立したバージョンがどのようにクリーンアップされるかを確認してください。 |1458| インストール済みプラグイン | `~/.claude/plugins` | クローンされたマーケットプレイス、インストール済みプラグインバージョン、`installed_plugins.json` インストール記録、およびプラグインごとのデータで、`claude plugin` コマンドで管理されます。プラグイン[あなたの claude.ai アカウントから同期](/docs/ja/plugins-reference#synced-plugins)は `~/.claude/plugins/synced/` にダウンロードされます。リンクモードでマーケットプレイス [`command` ソース](/docs/ja/plugin-marketplaces#command-sources)からインストールされたプラグインの場合、Claude Code はコピーの代わりにここにリンクを保存し、プラグインのファイルはコマンドが出力するディレクトリに留まります。`command` ソースには Claude Code v2.1.229 以降が必要です。ローカルディレクトリマーケットプレイスで相対パスでリストされているプラグインも、キャッシュコピーではなく、ソースディレクトリから[その場で読み込まれます](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)。[プラグインキャッシング](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)を参照して、孤立したバージョンがどのようにクリーンアップされるかを確認してください。 |

1459 1459

1460`~/.claude` はまた、Claude Code があなたが作業する際に書き込むデータも保持しています。トランスクリプト、プロンプト履歴、ファイルスナップショット、キャッシュ、およびログです。下記の[アプリケーションデータ](#application-data)を参照してください。1460`~/.claude` はまた、Claude Code があなたが作業する際に書き込むデータも保持しています。トランスクリプト、プロンプト履歴、ファイルスナップショット、キャッシュ、およびログです。下記の[アプリケーションデータ](#application-data)を参照してください。

1461 1461

1516| [`themes/*.json`](#ce-themes) | グローバルのみ | | カスタムカラーテーマ | [カスタムテーマ](/docs/ja/terminal-config#create-a-custom-theme) |1516| [`themes/*.json`](#ce-themes) | グローバルのみ | | カスタムカラーテーマ | [カスタムテーマ](/docs/ja/terminal-config#create-a-custom-theme) |

1517 1517

1518<h2 id="frontmatter-fields-by-file">

1519 ファイル別フロントマターフィールド

1520</h2>

1521

1522スキル、コマンドファイル、サブエージェント、出力スタイル、およびルールは、ファイルの上部にある YAML [フロントマター](/docs/ja/glossary#frontmatter)から設定を読み込み、それぞれが独自のフィールドセットを受け入れます。このテーブルは、各ファイルのフィールド名をリストアップし、それらを説明するリファレンスへのリンクを提供します。

1523

1524| ファイル | フロントマターフィールド | リファレンス |

1525| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |

1526| `skills/<name>/SKILL.md` | `name`, `description`, `when_to_use`, `argument-hint`, `arguments`, `disable-model-invocation`, `user-invocable`, `allowed-tools`, `disallowed-tools`, `model`, `effort`, `context`, `agent`, `background`, `hooks`, `paths`, `shell`, `metadata`, `license`, `compatibility` | [スキルフロントマター](/docs/ja/skills#frontmatter-reference) |

1527| `commands/*.md` | `name` と `paths` を除くスキルフィールド | [スキルフロントマター](/docs/ja/skills#frontmatter-reference) |

1528| `agents/*.md` | `name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experimental` | [サブエージェントフロントマター](/docs/ja/sub-agents#supported-frontmatter-fields) |

1529| `output-styles/*.md` | `name`, `description`, `keep-coding-instructions`, `force-for-plugin` | [出力スタイルフロントマター](/docs/ja/output-styles#frontmatter) |

1530| `rules/*.md` | `paths` | [ルールフロントマター](/docs/ja/memory#rules-frontmatter-reference) |

1531

1532[プラグイン](/docs/ja/plugins-reference#plugin-agent-frontmatter)に含まれるエージェントは、サブエージェントフィールドのサブセットに対応しています。

1533

1518<h2 id="troubleshoot-configuration">1534<h2 id="troubleshoot-configuration">

1519 設定をトラブルシューティングする1535 設定をトラブルシューティングする

1520</h2>1536</h2>

1534Claude Code は、[`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) より古いファイルを以下のパスから削除します。ただし、保持期間を安全に判定できる場合に限ります。デフォルトは 30 日で、最小値は 1 です。`0` に設定するとバリデーションエラーが発生します。同じ経過日数の閾値が、[孤立した worktrees](/docs/ja/worktrees#clean-up-subagent-and-background-session-worktrees) の自動削除にも適用されます。1550Claude Code は、[`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) より古いファイルを以下のパスから削除します。ただし、保持期間を安全に判定できる場合に限ります。デフォルトは 30 日で、最小値は 1 です。`0` に設定するとバリデーションエラーが発生します。同じ経過日数の閾値が、[孤立した worktrees](/docs/ja/worktrees#clean-up-subagent-and-background-session-worktrees) の自動削除にも適用されます。

1535 1551

1536| `~/.claude/` 下のパス | 内容 |1552| `~/.claude/` 下のパス | 内容 |

1537| ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1553| ------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1539| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`、`projects/<project>/<session>.jsonl.superseded-<timestamp>` | Claude Code が上書きまたは削除する代わりに脇に置いたセッションの前のトランスクリプト。セッションピッカーには表示されません |1555| `projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`、`projects/<project>/<session>.jsonl.superseded-<timestamp>` | Claude Code が上書きまたは削除する代わりに脇に置いたセッションの前のトランスクリプト。セッションピッカーには表示されません |

1540| `projects/<project>/<session>/subagents/` | [Subagent](/docs/ja/sub-agents) の会話トランスクリプト。親セッションのトランスクリプトが経過時間で削除されるときに削除されます |1556| `projects/<project>/<session>/subagents/` | [Subagent](/docs/ja/sub-agents) の会話トランスクリプト。親セッションのトランスクリプトが経過時間で削除されるときに削除されます |

1544| `debug/` | セッションごとのデバッグログ。デバッグログが有効な場合に書き込まれます。例えば、[`--debug`](/docs/ja/cli-reference#cli-flags) で起動するか `/debug` を実行する場合です |1560| `debug/` | セッションごとのデバッグログ。デバッグログが有効な場合に書き込まれます。例えば、[`--debug`](/docs/ja/cli-reference#cli-flags) で起動するか `/debug` を実行する場合です |

1546| `image-cache/<session>/` | 添付された画像。各スイープで、Claude Code は他のすべてのセッションのディレクトリを削除します。経過時間に関係なく |1562| `image-cache/<session>/` | Claude Code v2.1.274 以前によって保存された添付画像。以降のバージョンは、貼り付けられた画像と添付された画像を `~/.claude` の外に保存します。[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) が制御する temp ディレクトリの下の各セッションの `images/` ディレクトリに保存されます。スイープは他のセッションの残されたディレクトリをここから削除します。経過時間に関係なく |

1547| `uploads/<session>/` | Web またはモバイルアプリから添付したファイル、およびモバイルアプリから添付した写真。[Remote Control](/docs/ja/remote-control) セッションにメッセージを送信する場合です。[クラウドセッション](/docs/ja/claude-code-on-the-web) への添付は、代わりにそのセッション自体のクラウド環境に保存され、マシン上には保存されません |1563| `uploads/<session>/` | Web またはモバイルアプリから添付したファイル、およびモバイルアプリから添付した写真。[Remote Control](/docs/ja/remote-control) セッションにメッセージを送信する場合です。[クラウドセッション](/docs/ja/claude-code-on-the-web) への添付は、代わりにそのセッション自体のクラウド環境に保存され、マシン上には保存されません |

1610* `history.jsonl` の一致するプロンプト行1626* `history.jsonl` の一致するプロンプト行

1611* `~/.claude.json` のプロジェクトエントリ1627* `~/.claude.json` のプロジェクトエントリ

1612 1628

1629プロジェクトのセッションで貼り付けたまたは添付した画像は、`~/.claude` ではなく Claude Code の temp ディレクトリに保存されるため、パージはそれらを削除しません。[保持クリーンアップスイープ](#cleaned-up-automatically) は、`cleanupPeriodDays` より古くなると削除します。

1630

1613コマンドは完全な削除計画を出力し、何かを削除する前に確認を求めます。1631コマンドは完全な削除計画を出力し、何かを削除する前に確認を求めます。

1614 1632

1615以下の例は、プレースホルダーとして `~/work/my-repo` を使用しています。プロジェクトへのパスに置き換えてください。パスに一致する状態がない場合、コマンドはエラーを出力して終了ステータス 1 で終了します。1633以下の例は、プレースホルダーとして `~/work/my-repo` を使用しています。プロジェクトへのパスに置き換えてください。パスに一致する状態がない場合、コマンドはエラーを出力して終了ステータス 1 で終了します。

1660[保持する状態ファイル](#state-files-to-keep) を除いて、上記のアプリケーションデータパスのいずれかを手動で削除することもできます。新しいセッションは影響を受けません。以下の表は、過去のセッションで失うものを示しています。1678[保持する状態ファイル](#state-files-to-keep) を除いて、上記のアプリケーションデータパスのいずれかを手動で削除することもできます。新しいセッションは影響を受けません。以下の表は、過去のセッションで失うものを示しています。

1661 1679

1662| 削除 | 失うもの |1680| 削除 | 失うもの |

1663| ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |1681| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |

1666| `~/.claude/paste-cache/` | リコールされたプロンプトの貼り付けたテキスト。[大きなコンテンツを貼り付ける](/docs/ja/terminal-config#paste-large-content) を参照してください |1684| `~/.claude/paste-cache/` | リコールされたプロンプトの貼り付けたテキスト。[大きなコンテンツを貼り付ける](/docs/ja/terminal-config#paste-large-content) を参照してください |

1677| `~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/` | Claude Code が削除した [同期されたスキル](/docs/ja/skills#how-synced-skills-behave) と [同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins) を復元する機会 |1695| `~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/` | Claude Code が削除した [同期されたスキル](/docs/ja/skills#how-synced-skills-behave) と [同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins) を復元する機会 |

1678| `~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/image-cache/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/` | ユーザー向けのなし |1696| `~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/` | ユーザー向けのなし |

1680 1698

1681`~/.claude.json`、`~/.claude/settings.json`、`~/.claude/plugins/` は削除しないでください。これらは認証、設定、インストール済みプラグインを保持しています。1699`~/.claude.json`、`~/.claude/settings.json`、`~/.claude/plugins/` は削除しないでください。これらは認証、設定、インストール済みプラグインを保持しています。

1682 1700

claude-platform-on-aws.md +1 −1

Details

284 284

285AWS 上の Claude Platform は、直接 Claude API と同じモデル ID を使用します。285AWS 上の Claude Platform は、直接 Claude API と同じモデル ID を使用します。

286 286

287デフォルトのエイリアス `fable`、`opus`、`sonnet`、`haiku` は Claude Code の AWS 上の Claude Platform 用の組み込みデフォルトに解決されます。これは最新リリースより遅れる可能性があります。`ANTHROPIC_DEFAULT_OPUS_MODEL` がない場合、`opus` エイリアスは Opus 5 に解決されます。v2.1.219 より前では、Opus 4.8 に解決されていました。v2.1.207 より前では、Opus 4.7 に解決されていました。287デフォルトのエイリアス `fable`、`opus`、`sonnet`、`haiku` は Claude Code の AWS 上の Claude Platform 用の組み込みデフォルトに解決されます。これは最新リリースより遅れる可能性があります。`ANTHROPIC_DEFAULT_OPUS_MODEL` がない場合、`opus` エイリアスは Opus 5.5 に解決されます。v2.1.280 より前では、v2.1.219 から Opus 5 に解決されていました。v2.1.207 から Opus 4.8 に解決されていました。それより前は Opus 4.7 に解決されていました。

288 288

289Claude Code をチームにデプロイする場合、モデル ID を明示的にピン留めして、新しいリリースがすべてのユーザーを一度に移動しないようにします。289Claude Code をチームにデプロイする場合、モデル ID を明示的にピン留めして、新しいリリースがすべてのユーザーを一度に移動しないようにします。

290 290

claude-projects.md +27 −27

Details

56* **スレッド**: ワーカー。各スレッドは独自のコンテキストウィンドウを持つ個別の [クラウドセッション](/docs/ja/claude-code-on-the-web) で、独自のブランチで 1 つの作業を実行し、作業が必要な場合はプルリクエストを開き、完了時に会話に報告します。56* **スレッド**: ワーカー。各スレッドは独自のコンテキストウィンドウを持つ個別の [クラウドセッション](/docs/ja/claude-code-on-the-web) で、独自のブランチで 1 つの作業を実行し、作業が必要な場合はプルリクエストを開き、完了時に会話に報告します。

57* **すべてのスレッドが開始する内容**:57* **すべてのスレッドが開始する内容**:

58 * プロジェクトのリポジトリとファイル、およびその [指示とメモリ](#give-a-project-standing-context)58 * プロジェクトのリポジトリとファイル、およびその [指示とメモリ](#give-a-project-standing-context)

59 * `CLAUDE.md`、スキル、および [プロジェクトの各リポジトリ](#what-threads-pick-up-from-your-repositories) のプラグイン、および 1 つのリポジトリを持つプロジェクトでは、そのリポジトリの権限ルールとフックも59 * `CLAUDE.md` とスキル、および [プロジェクトの各リポジトリ](#what-threads-pick-up-from-your-repositories) のプラグイン、および 1 つのリポジトリを持つプロジェクトでは、そのリポジトリの権限ルールとフックも

60 * [コネクタ](#get-skills-plugins-connectors-and-tools-into-threads) を claude.ai アカウントに60 * [コネクタ](#get-skills-plugins-connectors-and-tools-into-threads) を claude.ai アカウントに

61 * ネットワークアクセス、環境変数、API 認証情報、インストール済みツールを設定する [クラウド環境](#choose-an-environment-for-threads)61 * ネットワークアクセス、環境変数、API 認証情報、インストール済みツールを設定する [クラウド環境](#choose-an-environment-for-threads)

62* **Overview ペイン**: [すべてのスレッドを一度に確認](#see-what-needs-you-in-overview) でき、どのスレッドが必要かを確認できる場所。その他のタブは、追加したファイルとスレッドが生成したファイルの **Library**、スレッドが開いたプルリクエストの **Pull requests**、プロジェクトのスケジュール作業の **Routines** です。62* **Overview ペイン**: [すべてのスレッドを一度に確認](#see-what-needs-you-in-overview) でき、どのスレッドが必要かを確認できる場所。その他のタブは、追加したファイルとスレッドが生成したファイルの **Library**、スレッドが開いたプルリクエストの **Pull requests**、プロジェクトのスケジュール作業の **Routines** です。

279 プロジェクトに常時コンテキストを付与する279 プロジェクトに常時コンテキストを付与する

280</h2>280</h2>

281 281

282プロジェクトメモリ、プロジェクト指示、およびプロジェクトのリポジトリ、ファイル、環境は、スレッド全体でコンテキストを保持します。各項目を一度設定すると、すべての新しいスレッドに適用されます。282プロジェクトメモリ、プロジェクト指示、およびプロジェクトのリポジトリ、ファイル、環境は、スレッド全体でコンテキストを保持します。各項目を 1 回設定すると、すべての新しいスレッドに適用されます。

283 283

285| :------------ | :-------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------ |285| :------------ | :-------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------- |

286| プロジェクトメモリ | Claude がプロジェクトについて保持するメモ（要件、決定、落とし穴など）をファイルとして保存します。すべてのスレッドは開始時にインデックスファイル `MEMORY.md` を読み込み、必要に応じて他のファイルを開きます | プロジェクト会話またはスレッド内で Claude に要件、決定、落とし穴を記憶するよう依頼するか、忘れるよう依頼します。**プロジェクト設定 > メモリ** でファイルを読み込み、編集、削除します |286| プロジェクトメモリ | Claude がプロジェクトについて保持するメモ（要件、決定、落とし穴など）をファイルとして保存します。すべてのスレッドは開始時にインデックスファイル `MEMORY.md` を読み込み、必要に応じて他のファイルを開きます | プロジェクト会話またはスレッド内で Claude に要件、決定、落とし穴を記憶するよう依頼するか、忘れるよう依頼します。**プロジェクト設定 > メモリ** でファイルを読み込み、編集、削除します |

288| リポジトリ、ファイル、環境 | すべてのスレッドがクローンするリポジトリ、すべてのスレッドが `/mnt/project-files` 下で読み込めるフォルダとファイル、スレッドが実行されるクラウド環境 | **プロジェクト設定 > 環境** でリポジトリと環境を設定するか、会話内で Claude にリポジトリをプロジェクトに追加するよう依頼します。**概要** タブの **ライブラリ** タブから **追加** でファイルとフォルダを追加します |288| リポジトリ、ファイル、環境 | すべてのスレッドがクローンするリポジトリ、すべてのスレッドが `/mnt/project-files` の下で読み取ることができるフォルダとファイル、およびスレッドが実行されるクラウド環境 | **プロジェクト設定 > 環境** のリポジトリと環境、または会話内で Claude にリポジトリをプロジェクトに追加するよう依頼します。**概要** の **ライブラリ** タブの **追加** からファイルとフォルダを追加します |

289 289

290**プロジェクト設定 > メモリ** は、これらのファイルを **自動メモリ** の下に一覧表示します。Claude がプロジェクトで作業する際に自分自身で書き込むためです。これらは Claude Code がマシン上で保持する [自動メモリ](/docs/ja/memory) とは別です。どちらも `MEMORY.md` インデックスを使用していますが、別のものです。また、プロジェクトのリポジトリ内の `CLAUDE.md` ファイルとも別です。各スレッドは開始時にクローンからこれらの `CLAUDE.md` ファイルを読み込むため、リポジトリに関する指示をそのリポジトリの `CLAUDE.md` に記載し、プロジェクトに関するメモをプロジェクトメモリに記載してください。290**プロジェクト設定 > メモリ** は、これらのファイルを **自動メモリ** の下にリストしています。これは Claude がプロジェクト内で作業する際に自分で書き込むためです。これらは、Claude Code があなたのマシンで保持する [自動メモリ](/docs/ja/memory) とは別です。両方とも `MEMORY.md` インデックスを使用していますが、プロジェクトメモリはプロジェクトのリポジトリ内の `CLAUDE.md` ファイルとは別です。各スレッドは開始時にクローンからこれらの `CLAUDE.md` ファイルを読み込むため、リポジトリに関する指示をその `CLAUDE.md` に、プロジェクトに関するメモをプロジェクトメモリに記載してください。

291 291

292<h3 id="write-project-instructions">292<h3 id="write-project-instructions">

293 プロジェクト指示を書く293 プロジェクト指示を書く

297 297

298* プロジェクトの目的298* プロジェクトの目的

299* 作業が行われる場所：どのリポジトリ、どのブランチから開始するか、プルリクエストの命名方法299* 作業が行われる場所：どのリポジトリ、どのブランチから開始するか、プルリクエストの命名方法

300* スレッドが作業完了前に自分の作業をチェックする方法300* スレッドが作業完了と判断する前に自分の作業をチェックする方法

301* 必要なものが見つからない場合の対応方法301* 必要なものが見つからない場合の対応方法

302* あなたの承認が必要な事項302* あなたの承認が必要な事項

303 303

304例：304例：

305 305

306```text theme={null}306```text theme={null}

307このプロジェクトは、payments API の p95 レイテンシを 200 ms 以下に保つため、プロファイリング、クエリとキャッシング修正、およびそれに伴う依存関係のアップグレードを payments-api リポジトリで行います。307このプロジェクトは、payments API の p95 レイテンシを 200 ms 以下に保ちます：プロファイリング、クエリとキャッシング修正、およびそれに伴う依存関係のアップグレードを payments-api リポジトリで行います。

308 308

309- main からブランチを作成し、スレッドごとに 1 つのドラフトプルリクエストを開きます。309- main からブランチを作成し、スレッドごとに 1 つのドラフトプルリクエストを開きます。

310- 作業完了前に、`make test` と `make lint` を実行し、最終メッセージに概要行を貼り付けます。310- 作業完了と判断する前に、`make test` と `make lint` を実行し、最終メッセージに概要行を貼り付けます。

311- リポジトリ、シークレット、API、コネクタなど、必要なものに到達できない場合は、最初のメッセージで正確に何が不足しているかを述べ、停止します。代替案を提案したり、モックを作成したり、推測したりしないでください。311- リポジトリ、シークレット、API、コネクタなど、必要なものに到達できない場合は、最初のメッセージで正確に何が不足しているかを述べて停止します。代替案を提案したり、モックを作成したり、推測したりしないでください。

312- マージ、強制プッシュ、CI 設定の変更は、スレッド内で私に確認してから行ってください。312- マージ、強制プッシュ、CI 設定の変更は、スレッド内で私に確認してから行ってください。

313```313```

314 314

3151 つのリポジトリに関するルール（ビルドコマンドなど）は、そのリポジトリの `CLAUDE.md` に記載してください。リポジトリがプロジェクトの一部である場合、すべてのスレッドはリポジトリ開始時にこのファイルを読み込みます。作業が進行中の場合、スレッドを修正するときに、Claude にその修正を記憶するよう依頼してください。修正は [プロジェクトメモリ](#give-a-project-standing-context) に保存され、後続のスレッドはそれを使用して開始します。3151 つのリポジトリに関するルール（ビルドコマンドなど）は、そのリポジトリの `CLAUDE.md` に属します。このファイルは、リポジトリがプロジェクトの一部である場合、すべてのスレッドが開始時に読み込みます。作業が進行中の場合、スレッドを修正するときは、Claude にその修正を記憶するよう依頼してください。修正は [プロジェクトメモリ](#give-a-project-standing-context) に記録され、後のスレッドはそれを使用して開始します。

316 316

317<h3 id="decide-which-repositories-to-add">317<h3 id="decide-which-repositories-to-add">

318 追加するリポジトリを決定する318 追加するリポジトリを決定する

319</h3>319</h3>

320 320

321プロジェクトに追加するリポジトリは、すべてのスレッドでそのコード、`CLAUDE.md`、スキルを含めて提供されます。追加しないリポジトリでも、スレッドがアクセスできます。スレッドのタスクが必要な場合、スレッドはそれ自体にリポジトリを追加できます。ほとんどのプロジェクトは両方を使用します：321プロジェクトに追加するリポジトリは、すべてのスレッドでそれらに含まれるすべてのもの（コード、`CLAUDE.md`、スキル）を持ってきます。追加しないリポジトリにもアクセスできます：スレッドがタスクで必要な場合、自分自身にリポジトリを追加できます。ほとんどのプロジェクトは両方を使用します：

322 322

323* **プロジェクトに追加する**：**新規プロジェクト** ダイアログ、**プロジェクト設定 > 環境**、または会話内で Claude にプロジェクトに追加するよう依頼します。その後、すべてのスレッドはそれをクローンし、タスクがそれに触れるかどうかに関わらず、その `CLAUDE.md` とスキルを使用して開始します。1 つのリポジトリから複数のリポジトリに移行すると、各リポジトリの `.claude/settings.json` からスレッドが取得する内容も変わります。[リポジトリから取得するスレッド](#what-threads-pick-up-from-your-repositories) を参照してください。323* **プロジェクトに追加します**。**新規プロジェクト** ダイアログ、**プロジェクト設定 > 環境**、または会話内で Claude にプロジェクトに追加するよう依頼します。その後のすべてのスレッドは、タスクがそれに触れるかどうかに関わらず、それをクローンして `CLAUDE.md` とスキルを読み込んで開始します。1 つのリポジトリから複数のリポジトリに移行すると、各リポジトリの `.claude/settings.json` からスレッドが取得するものも変わります。[スレッドがリポジトリから取得するもの](#what-threads-pick-up-from-your-repositories) を参照してください。

324* **追加しないで、スレッドが必要に応じて追加するようにする。** タスクがプロジェクトにないリポジトリを必要とするスレッドは、それ自体にリポジトリを追加でき、スレッド内のメモはそれがこのスレッドのみに追加されたことを示します。クローンはタスクの途中で発生するため、そのリポジトリの `CLAUDE.md` とスキルはスレッド開始時には存在しません。次のスレッドは再度それなしで開始します。スレッドが追加するリポジトリは、プロジェクトリポジトリと同じ [前提条件](#check-the-prerequisites) が必要です：Claude GitHub App がインストールされており、GitHub アカウントからプッシュアクセスがあります。324* **オフのままにして、スレッドが必要な場合に追加させます。** タスクがプロジェクトにないリポジトリを必要とするスレッドは、自分自身にそれを追加でき、スレッド内のメモはそれがこのスレッドのみに追加されたことを示します。クローンはタスクの途中で発生するため、そのリポジトリの `CLAUDE.md` とスキルはスレッド開始時には存在しません。次のスレッドは再度それなしで開始します。スレッドが追加するリポジトリは、プロジェクトリポジトリと同じ [前提条件](#check-the-prerequisites) が必要です：Claude GitHub App がインストールされていることと、GitHub アカウントからのプッシュアクセスです。

325 325

326プロジェクトはリポジトリを必要としません。スレッドは引き続き調査、ドキュメント作成、独自のサンドボックスでのコード作成と実行を行い、**ライブラリ** タブにファイルを配信できます。そこのスレッドは、タスクが必要な場合、スレッド自体にリポジトリを追加することもできます。326プロジェクトはリポジトリをまったく必要としません。そのスレッドは、研究、ドキュメント作成、独自のサンドボックスでのコード作成と実行を行うことができ、**ライブラリ** タブにファイルを配信します。そこのスレッドは、タスクが必要な場合、自分自身にリポジトリを追加することもできます。

327 327

328プロジェクトにリポジトリがある場合、Claude はプロジェクトが既に使用している GitHub オーナーからのみリポジトリを追加できます。プロジェクトに追加するか、スレッドがそれ自体に追加するかに関わらず同じです。別のオーナーからリポジトリを取得するには、**プロジェクト設定 > 環境** で自分でプロジェクトに追加してください。328プロジェクトにリポジトリがある場合、Claude はプロジェクトが既に使用している GitHub オーナーからのみリポジトリを追加できます。プロジェクトに追加するか、スレッドが自分自身に追加するかに関わらず同じです。別のオーナーからリポジトリを持ってくるには、**プロジェクト設定 > 環境** で自分でプロジェクトに追加してください。

329 329

330サーバー、ウェブ、モバイル、デスクトップコードを含む機能など、多くのリポジトリにまたがるプロジェクトの場合、ほぼすべてのタスクが触れる 1 つまたは 2 つのリポジトリを追加し、他のリポジトリを [プロジェクト指示](#write-project-instructions) に記載して、Claude が残りのコードがどこにあるかを知るようにします。スレッドは小さく開始し、必要なタスクに対してのみ他のリポジトリを取得します。330サーバー、ウェブ、モバイル、デスクトップコードを持つ機能など、多くのリポジトリにまたがるプロジェクトの場合、ほぼすべてのタスクが触れる 1 つまたは 2 つのリポジトリを追加し、[プロジェクト指示](#write-project-instructions) で他のリポジトリに名前を付けて、Claude が残りのコードがどこにあるかを知るようにします。スレッドは小さく開始し、それらが必要なタスクに対してのみ他のリポジトリを取得します。

331 331

332<h3 id="what-threads-pick-up-from-your-repositories">332<h3 id="what-threads-pick-up-from-your-repositories">

333 リポジトリから取得するスレッド333 スレッドがリポジトリから取得するもの

334</h3>334</h3>

335 335

336各スレッドはプロジェクト内のすべてのリポジトリをクローンし、すべてのリポジトリから `CLAUDE.md`、スキル、プラグインを読み込みます。権限ルール、フック、`env` は、スレッドが開始するディレクトリ内の `.claude/settings.json` からのみ取得されます：プロジェクトに 1 つのリポジトリがある場合はリポジトリ内、複数のリポジトリがある場合はクローンの上、リポジトリのファイルは読み込まれません。336各スレッドはプロジェクト内のすべてのリポジトリをクローンし、すべてのリポジトリから `CLAUDE.md` とスキルを読み込みます。権限ルール、フック、`env` は、スレッドが開始するディレクトリ内の `.claude/settings.json` からのみ取得されます：プロジェクトが 1 つのリポジトリを持つ場合はリポジトリ内、複数のリポジトリを持つ場合はクローンの上で、リポジトリのファイルはそれらに対して読み込まれません。

337 337

339| :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------- |339| :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------- | :------------------------------------------------- |

343| `.claude/settings.json` で定義された権限ルール、フック、`env` | スレッドに適用されます。ただし、[クラウドセッションが認識しない](/docs/ja/cloud-environments#what-carries-over-from-your-setup) `env` キーは除きます | 適用されません |343| `.claude/settings.json` で定義された権限ルール、フック、`env` | スレッドに適用されます。ただし、[クラウドセッションが認識しない](/docs/ja/cloud-environments#what-carries-over-from-your-setup) `env` キーは除きます | 適用されません |

344 344

345複数のリポジトリを持つプロジェクトでは、各クローンは `CLAUDE.md` 読み込みが有効になっている [追加ディレクトリ](/docs/ja/memory#load-from-additional-directories) としてスレッドに接続されます。これが、スレッドがそれらの上で開始されるにもかかわらず、すべてのリポジトリの `CLAUDE.md` とスキルが開始時に読み込まれる理由です。どちらの場合でも、有効化されたプラグインが提供するフックは実行されます。プラグインはすべてのリポジトリから読み込まれるためです。複数のリポジトリを持つプロジェクトでは、プロジェクト指示に常時ルールを記載し、[クラウド環境](#choose-an-environment-for-threads) を通じてスレッドに環境変数を提供します。345複数のリポジトリを持つプロジェクトでは、各クローンは `CLAUDE.md` 読み込みが有効になった [追加ディレクトリ](/docs/ja/memory#load-from-additional-directories) としてスレッドに接続されます。これが、スレッドがそれらの上で開始されるにもかかわらず、すべてのリポジトリの `CLAUDE.md` とスキルが開始時に読み込まれる理由です。このようなプロジェクトでは、スタンディングルールをプロジェクト指示に記載し、[クラウド環境](#choose-an-environment-for-threads) を通じてスレッドに環境変数を提供してください。

346 346

347<h3 id="choose-an-environment-for-threads">347<h3 id="choose-an-environment-for-threads">

348 スレッドの環境を選択する348 スレッドの環境を選択する

350 350

351すべての新しいスレッドはプロジェクトの [クラウド環境](/docs/ja/cloud-environments) で開始します。環境は、スレッドが到達できるドメイン、スレッドが持つ環境変数、リクエストに追加される API 認証情報、Claude が開始する前にセットアップスクリプトがインストールするものを設定します。スレッドは、**プロジェクト設定 > 環境** で選択するまで、デフォルトの Anthropic ホスト環境を使用します。351すべての新しいスレッドはプロジェクトの [クラウド環境](/docs/ja/cloud-environments) で開始します。環境は、スレッドが到達できるドメイン、スレッドが持つ環境変数、リクエストに追加される API 認証情報、Claude が開始する前にセットアップスクリプトがインストールするものを設定します。スレッドは、**プロジェクト設定 > 環境** で選択するまで、デフォルトの Anthropic ホスト環境を使用します。

352 352

353スレッドが内部 API またはプライベートパッケージレジストリに到達する必要がある場合、またはマシンが通常保持するトークンが必要な場合は、プロジェクトではなく環境を変更してください。[ネットワークアクセス](/docs/ja/cloud-environments#network-access)、[API 認証情報を追加](/docs/ja/cloud-environments#add-api-credentials)、[セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) を参照してください。353スレッドが内部 API またはプライベートパッケージレジストリに到達する必要がある場合、またはマシンが通常保持するトークンが必要な場合は、プロジェクトではなく環境を変更してください：[ネットワークアクセス](/docs/ja/cloud-environments#network-access)、[API 認証情報を追加](/docs/ja/cloud-environments#add-api-credentials)、[セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) を参照してください。

354 354

355<h3 id="get-skills-plugins-connectors-and-tools-into-threads">355<h3 id="get-skills-plugins-connectors-and-tools-into-threads">

356 スキル、プラグイン、コネクタ、ツールをスレッドに取得する356 スキル、プラグイン、コネクタ、ツールをスレッドに取得する

358 358

359スレッドはクラウドセッションであるため、マシンにのみインストールされているスキル、MCP サーバー、プラグイン、ツールを持っていません。これらのそれぞれをスレッドで利用可能にするには：359スレッドはクラウドセッションであるため、マシンにのみインストールされているスキル、MCP サーバー、プラグイン、ツールを持っていません。これらのそれぞれをスレッドで利用可能にするには：

360 360

361* スキル、サブエージェント、コマンド：プロジェクトに追加したリポジトリにコミットします。例えば、`.claude/skills/<skill-name>/SKILL.md` のスキル。各スレッドはプロジェクト内のすべてのリポジトリをクローンし、各リポジトリから `.claude/skills/`、`.claude/agents/`、`.claude/commands/` を読み込むため、1 つのリポジトリにコミットされたスキルはすべての新しいスレッドで利用可能です。スレッドは、Claude.ai アカウントで有効化したスキルも読み込みます。361* スキル、サブエージェント、コマンド：プロジェクトに追加したリポジトリにコミットします。例えば、`.claude/skills/<skill-name>/SKILL.md` のスキル。各スレッドはプロジェクト内のすべてのリポジトリをクローンし、それぞれから `.claude/skills/`、`.claude/agents/`、`.claude/commands/` を読み込むため、1 つのリポジトリにコミットされたスキルはすべての新しいスレッドで利用可能です。スレッドは、Claude.ai アカウントで有効化したスキルも読み込みます。

362* プラグイン：**プロジェクト設定 > プラグイン** で追加します。各新しいスレッドに読み込まれます。リポジトリが `.claude/settings.json` で宣言するプラグインも読み込まれます。[セットアップから取得される内容](/docs/ja/cloud-environments#what-carries-over-from-your-setup) を参照してください。362* プラグイン：**プロジェクト設定 > プラグイン** で追加します。各新しいスレッドに読み込まれます。リポジトリが `.claude/settings.json` で宣言するプラグインは、スレッドがクラウドセッションであるため、[スレッドに読み込まれません](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。

363* MCP サーバー：スレッドは Claude.ai アカウント上のコネクタから MCP ツールを取得します。これは、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で一度接続するか、**プロジェクト設定 > 環境** の **コネクタを管理** リンクを通じて接続する MCP サーバーです。すべてのスレッドはプロジェクト固有のセットアップなしでそれらすべてを使用できます。プロジェクト会話自体にはコネクタがないため、コネクタが必要な作業をスレッドのタスクとして送信してください。1 つのリポジトリを持つプロジェクトでは、スレッドはそのリポジトリの [`.mcp.json`](/docs/ja/cloud-environments#what-carries-over-from-your-setup) から MCP サーバーも読み込みます。[コネクタが Claude Code に到達する方法](/docs/ja/mcp#how-connectors-reach-claude-code) はクラウドセッションのルールと、コネクタをオフにする設定を一覧表示します。363* MCP サーバー：スレッドは、Claude.ai アカウントのコネクタから MCP ツールを取得します。これは、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で 1 回接続する MCP サーバーか、**プロジェクト設定 > 環境** の **コネクタを管理** リンクを通じて接続します。すべてのスレッドは、プロジェクト固有のセットアップなしでそれらすべてを使用できます。プロジェクト会話自体にはコネクタがないため、コネクタが必要な作業をスレッドのタスクとして送信してください。1 つのリポジトリを持つプロジェクトでは、スレッドはそのリポジトリの [`.mcp.json`](/docs/ja/cloud-environments#what-carries-over-from-your-setup) から MCP サーバーも読み込みます。[コネクタが Claude Code に到達する方法](/docs/ja/mcp#how-connectors-reach-claude-code) は、クラウドセッションのルールとコネクタをオフにする設定をリストしています。

364* コマンドラインツールとパッケージ：環境の [セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) にインストールします。364* コマンドラインツールとパッケージ：環境の [セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) にインストールします。

365 365

366実行中のスレッドが claude.ai/code でどのコネクタを持っているかを確認するには、スレッドを開き、メッセージボックスの横の **+** メニューから **コネクタ** を選択します。そこでコネクタをオフにすると、そのスレッドから削除され、あなたがそれをオンに戻すまで、後で開始されたスレッドでもオフのままになります。スレッドは、あなたが追加またはオンに戻したコネクタを、次のメッセージを送信した後に取得します。366実行中のスレッドが claude.ai/code でどのコネクタを持っているかを確認するには、スレッドを開き、メッセージボックスの横の **+** メニューから **コネクタ** を選択します。コネクタをそこでオフにすると、そのスレッドから削除され、アカウントのデフォルトとして保存されます。そのため、新しいスレッドと claude.ai チャットは、再度オンにするまでそれなしで開始します。スレッドは、送信後のメッセージで追加または再接続したコネクタを取得します。

367 367

368<h2 id="project-settings-reference">368<h2 id="project-settings-reference">

369 プロジェクト設定リファレンス369 プロジェクト設定リファレンス

cli-reference.md +5 −3

Details

60これらのコマンドラインフラグを使用して Claude Code の動作をカスタマイズします。`claude --help` はすべてのフラグをリストアップしていないため、フラグが `--help` に表示されていないことは、そのフラグが利用できないことを意味しません。60これらのコマンドラインフラグを使用して Claude Code の動作をカスタマイズします。`claude --help` はすべてのフラグをリストアップしていないため、フラグが `--help` に表示されていないことは、そのフラグが利用できないことを意味しません。

61 61

62| フラグ | 説明 | 例 |62| フラグ | 説明 | 例 |

63| :---------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |63| :---------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |

64| `--add-dir` | Claude がファイルを読み書きするための追加の作業ディレクトリを追加します。ファイルアクセスを許可します。Claude Code は[これらのディレクトリから `.claude/` 設定のほとんどを検出しません](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)。各パスがディレクトリとして存在することを検証します。`\\server\share` などの[ネットワークパス](/docs/ja/errors#working-directory-is-a-network-path)のほとんどを追加することはできません。これらのディレクトリをセッション間で保持するには、設定で [`permissions.additionalDirectories`](/docs/ja/settings-reference#permissions-additionaldirectories) を設定します | `claude --add-dir ../apps ../lib` |64| `--add-dir` | Claude がファイルを読み書きするための追加の作業ディレクトリを追加します。ファイルアクセスを許可します。Claude Code は[これらのディレクトリから `.claude/` 設定のほとんどを検出しません](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)。各パスがディレクトリとして存在することを検証します。`\\server\share` などの[ネットワークパス](/docs/ja/errors#working-directory-is-a-network-path)のほとんどを追加することはできません。これらのディレクトリをセッション間で保持するには、設定で [`permissions.additionalDirectories`](/docs/ja/settings-reference#permissions-additionaldirectories) を設定します | `claude --add-dir ../apps ../lib` |

65| `--advisor <model>` | このセッションのサーバー側[アドバイザーツール](/docs/ja/advisor)を有効にします。モデルエイリアス `fable`、`opus`、`sonnet`、または完全なモデル ID を使用します。`advisorModel` 設定よりも優先されます。`fable` には[Fable アクセス](/docs/ja/advisor#choose-an-advisor-model)が必要です | `claude --advisor opus` |65| `--advisor <model>` | このセッションのサーバー側[アドバイザーツール](/docs/ja/advisor)を有効にします。モデルエイリアス `fable`、`opus`、`sonnet`、または完全なモデル ID を使用します。`advisorModel` 設定よりも優先されます。`fable` には[Fable アクセス](/docs/ja/advisor#choose-an-advisor-model)が必要です | `claude --advisor opus` |

94| `--fallback-model` | プライマリモデルがオーバーロードされているか利用できない場合（例：廃止されたモデル）に、指定されたモデルへの自動フォールバックを有効にします。順序で試行されるコンマ区切りリストを受け入れます。[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)を参照してください。セッション間でチェーンを保持するには、このフラグがオーバーライドする [`fallbackModel` 設定](/docs/ja/settings-reference#fallbackmodel)を使用します | `claude --fallback-model sonnet,haiku` |94| `--fallback-model` | プライマリモデルがオーバーロードされているか利用できない場合（例：廃止されたモデル）に、指定されたモデルへの自動フォールバックを有効にします。順序で試行されるコンマ区切りリストを受け入れます。[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)を参照してください。セッション間でチェーンを保持するには、このフラグがオーバーライドする [`fallbackModel` 設定](/docs/ja/settings-reference#fallbackmodel)を使用します | `claude --fallback-model sonnet,haiku` |

96| `--forward-subagent-text` | [サブエージェント](/docs/ja/sub-agents)テキストと思考ブロックを出力ストリームに `parent_tool_use_id` が設定された `assistant` および `user` メッセージとして出力して、各サブエージェントのトランスクリプトを再構築できるようにします。このフラグがない場合、Claude Code は[フォアグラウンド](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)で実行されるサブエージェントのテキストと思考ブロックを省略します。`--print` と `--output-format stream-json` が必要です。Claude Code は[ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)からのメッセージも転送し、各サブエージェントを生成したエージェントツール呼び出しの ID に `parent_tool_use_id` を設定します。これには Claude Code v2.1.219 以降が必要です。[`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/ja/env-vars)環境変数は同じ動作を有効にします。Claude Code v2.1.211 以降が必要です | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |96| `--forward-subagent-text` | [サブエージェント](/docs/ja/sub-agents)テキストと思考ブロックを出力ストリームに `parent_tool_use_id` が設定された `assistant` および `user` メッセージとして出力して、各サブエージェントのトランスクリプトを再構築できるようにします。このフラグがない場合、Claude Code は[フォアグラウンド](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)で実行されるサブエージェントのテキストと思考ブロックを省略します。`--print` と `--output-format stream-json` が必要です。Claude Code は[ネストされたサブエージェント](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)からのメッセージも転送し、各サブエージェントを生成したエージェントツール呼び出しの ID に `parent_tool_use_id` を設定します。これには Claude Code v2.1.219 以降が必要です。フォークされたスキルが生成するサブエージェントのメッセージ、およびネストされたフォークされたスキルのメッセージには v2.1.275 以降が必要です。[`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/ja/env-vars)環境変数は同じ動作を有効にします。Claude Code v2.1.211 以降が必要です | `claude -p --output-format stream-json --verbose --forward-subagent-text "query"` |

97| `--from-pr` | セッションピッカーを特定のプルリクエストにリンクされたセッションにフィルタリングして開きます。PR 番号、GitHub または GitHub Enterprise PR URL、GitLab マージリクエスト URL、または Bitbucket プルリクエスト URL を受け入れます。Claude がプルリクエストを作成すると、セッションは自動的にリンクされます | `claude --from-pr 123` |97| `--from-pr` | セッションピッカーを特定のプルリクエストにリンクされたセッションにフィルタリングして開きます。PR 番号、GitHub または GitHub Enterprise PR URL、GitLab マージリクエスト URL、または Bitbucket プルリクエスト URL を受け入れます。Claude がプルリクエストを作成すると、セッションは自動的にリンクされます | `claude --from-pr 123` |

98| `--ide` | 起動時に、正確に 1 つの有効な IDE が利用可能な場合、自動的に IDE に接続します | `claude --ide` |98| `--ide` | 起動時に、正確に 1 つの有効な IDE が利用可能な場合、自動的に IDE に接続します | `claude --ide` |

104| `--json-schema` | エージェントがワークフローを完了した後、JSON スキーマに一致する検証済み JSON 出力を取得します（プリントモードのみ）。[構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照してください。Claude Code は無効なスキーマでエラーで終了し、`format` キーワードをクライアント側検証なしの注釈として受け入れます | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |104| `--json-schema` | エージェントがワークフローを完了した後、JSON スキーマに一致する検証済み JSON 出力を取得します（プリントモードのみ）。[構造化出力](/docs/ja/agent-sdk/structured-outputs)を参照してください。Claude Code は無効なスキーマでエラーで終了し、`format` キーワードをクライアント側検証なしの注釈として受け入れます | `claude -p --json-schema '{"type":"object","properties":{...}}' "query"` |

106| `--max-budget-usd` | API 呼び出しで支出する最大ドル額。停止する前に支出します（プリントモードのみ）。[サブエージェント](/docs/ja/sub-agents)からの支出はキャップにカウントされます。支出がキャップに達すると、別のサブエージェントを生成すると `Budget limit reached` で失敗し、Claude Code は引き続き実行中のバックグラウンドサブエージェントを停止します。キャップ実行動作には Claude Code v2.1.217 以降が必要です | `claude -p --max-budget-usd 5.00 "query"` |106| `--max-budget-usd` | API 呼び出しで支出する最大ドル額。停止する前に支出します（プリントモードのみ）。[サブエージェント](/docs/ja/sub-agents)からの支出はキャップにカウントされます。`--continue` または `--resume` で会話に戻るときに、[以前の実行から復元された](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)合計はそれに対してカウントされません。支出がキャップに達すると、別のサブエージェントを生成すると `Budget limit reached` で失敗し、Claude Code は引き続き実行中のバックグラウンドサブエージェントを停止します。キャップ実行動作には Claude Code v2.1.217 以降が必要です | `claude -p --max-budget-usd 5.00 "query"` |

107| `--max-turns` | エージェンティックターンの数を制限します（プリントモードのみ）。制限に達するとエラーで終了します。デフォルトでは制限がありません。`--input-format stream-json` を使用する場合、制限がターンを終了するときにキューに入れられたメッセージは引き続きキューに入れられ、独自の制限で新しいターンを開始します | `claude -p --max-turns 3 "query"` |107| `--max-turns` | エージェンティックターンの数を制限します（プリントモードのみ）。制限に達するとエラーで終了します。デフォルトでは制限がありません。`--input-format stream-json` を使用する場合、制限がターンを終了するときにキューに入れられたメッセージは引き続きキューに入れられ、独自の制限で新しいターンを開始します | `claude -p --max-turns 3 "query"` |

108| `--mcp-config` | JSON ファイルまたは文字列から MCP サーバーを読み込みます（スペース区切り）。このフラグを `-p` で渡すと、Claude Code は最初のターンを実行する前に、まだ保留中のサーバーが接続されるまで待機します。デフォルトでは [`MCP_TIMEOUT`](/docs/ja/env-vars) スタートアップタイムアウト 30 秒まで待機します。[キャッシュされたツールリスト](/docs/ja/mcp#managing-your-servers)を持つサーバーは待機をスキップし、最初の使用時に接続します。待機には Claude Code v2.1.221 以降が必要です | `claude --mcp-config ./mcp.json` |108| `--mcp-config` | JSON ファイルまたは文字列から MCP サーバーを読み込みます（スペース区切り）。このフラグを `-p` で渡すと、Claude Code は最初のターンを実行する前に、まだ保留中のサーバーが接続されるまで待機します。デフォルトでは [`MCP_TIMEOUT`](/docs/ja/env-vars) スタートアップタイムアウト 30 秒まで待機します。[キャッシュされたツールリスト](/docs/ja/mcp#managing-your-servers)を持つサーバーは待機をスキップし、最初の使用時に接続します。待機には Claude Code v2.1.221 以降が必要です | `claude --mcp-config ./mcp.json` |

109| `--model` | `sonnet`、`opus`、`haiku`、`fable` などの[モデルエイリアス](/docs/ja/model-config#model-aliases)またはモデルの完全な名前を使用して、現在のセッションのモデルを設定します。[`model`](/docs/ja/settings-reference#model) 設定と [`ANTHROPIC_MODEL`](/docs/ja/model-config#environment-variables) をオーバーライドします | `claude --model claude-sonnet-5` |109| `--model` | `sonnet`、`opus`、`haiku`、`fable` などの[モデルエイリアス](/docs/ja/model-config#model-aliases)またはモデルの完全な名前を使用して、現在のセッションのモデルを設定します。[`model`](/docs/ja/settings-reference#model) 設定と [`ANTHROPIC_MODEL`](/docs/ja/model-config#environment-variables) をオーバーライドします | `claude --model claude-sonnet-5` |

157 157

158`--system-prompt` と `--system-prompt-file` は相互に排他的です。追加フラグは置換フラグのいずれかと組み合わせることができます。158`--system-prompt` と `--system-prompt-file` は相互に排他的です。追加フラグは置換フラグのいずれかと組み合わせることができます。

159 159

160置換テキストが、すべての実行で同じ指示と実行ごとに変わるコンテキストを組み合わせる場合、`__SYSTEM_PROMPT_DYNAMIC_BOUNDARY__` のみを含む行を指示とコンテキストの間に追加します。Claude Code はその最初の行でプロンプトを分割し、その行を削除するため、その上の部分はキャッシュされたままで、その下の部分は変わります。Claude Code v2.1.275 以降が必要です。[カスタムプロンプトの静的部分をキャッシュ](/docs/ja/agent-sdk/modifying-system-prompts#cache-the-static-part-of-a-custom-prompt)は、分割が適用される設定をリストアップしています。

161

160Claude Code のデフォルト ID がタスクに適合するかどうかに基づいて選択します。Claude がコーディングアシスタントのままで、追加のルールも従うべき場合は、追加フラグを使用します。呼び出しごとの指示、出力形式、または `-p` スクリプトのドメインコンテキスト。追加するとデフォルトのツールガイダンス、安全指示、コーディング規約が保持されるため、異なる部分のみを提供します。Claude Code のサーフェス、ID、または権限モデルが異なる場合は、置換フラグを使用します。人間が見ていないパイプラインの非コーディングエージェントなど。置換するとデフォルトプロンプト全体が削除されます。ツールガイダンスと安全指示を含むため、タスクがまだ必要とするものについて責任を負います。162Claude Code のデフォルト ID がタスクに適合するかどうかに基づいて選択します。Claude がコーディングアシスタントのままで、追加のルールも従うべき場合は、追加フラグを使用します。呼び出しごとの指示、出力形式、または `-p` スクリプトのドメインコンテキスト。追加するとデフォルトのツールガイダンス、安全指示、コーディング規約が保持されるため、異なる部分のみを提供します。Claude Code のサーフェス、ID、または権限モデルが異なる場合は、置換フラグを使用します。人間が見ていないパイプラインの非コーディングエージェントなど。置換するとデフォルトプロンプト全体が削除されます。ツールガイダンスと安全指示を含むため、タスクがまだ必要とするものについて責任を負います。

161 163

162プロジェクト間で切り替えて共有できる永続的なペルソナについては、[出力スタイル](/docs/ja/output-styles)を使用します。Claude が常に従うべきプロジェクト規約については、[CLAUDE.md](/docs/ja/memory)を使用します。[エージェント SDK ガイド（システムプロンプト）](/docs/ja/agent-sdk/modifying-system-prompts#decide-on-a-starting-point)は同じ決定をより詳しく説明しています。164プロジェクト間で切り替えて共有できる永続的なペルソナについては、[出力スタイル](/docs/ja/output-styles)を使用します。Claude が常に従うべきプロジェクト規約については、[CLAUDE.md](/docs/ja/memory)を使用します。[エージェント SDK ガイド（システムプロンプト）](/docs/ja/agent-sdk/modifying-system-prompts#decide-on-a-starting-point)は同じ決定をより詳しく説明しています。

cloud-environments.md +2 −2

Details

301| リポジトリの `.claude/rules/` | はい | クローンの一部 |301| リポジトリの `.claude/rules/` | はい | クローンの一部 |

302| リポジトリの `.claude/skills/`、`.claude/agents/`、`.claude/commands/` | はい | クローンの一部 |302| リポジトリの `.claude/skills/`、`.claude/agents/`、`.claude/commands/` | はい | クローンの一部 |

303| `.claude/settings.json` で宣言されたプラグイン | はい | 宣言した[マーケットプレイス](/docs/ja/plugin-marketplaces)からセッション開始時にインストールされます。マーケットプレイスソースに到達するにはネットワークアクセスが必要です |303| リポジトリの `.claude/settings.json` で宣言されたプラグインとマーケットプレイス | いいえ | クラウドセッションは、リポジトリが [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) で有効にするプラグインをインストールしません。これには [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) の下にリストされているマーケットプレイスのプラグインも含まれます。代わりに claude.ai アカウントのプラグインを有効にして、Claude Code が[同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins)として読み込むようにしてください |

304| 組織の[サーバー管理設定](/docs/ja/server-managed-settings) | はい | セッション開始時に Anthropic のサーバーから取得されます。クラウドセッションで `availableModels` がどのように適用されるかについては、[Surface coverage](/docs/ja/model-config#surface-coverage) を参照してください。MDM または管理設定ファイルを通じてデバイスにデプロイされた設定は適用されません。セッションは Anthropic 管理 VM で実行されるためです。[セルフホスト環境](/docs/ja/self-hosted-environments)では、セッションはランナーイメージの管理設定ファイルも読み取ります。[Claude Code が管理ソースを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)に従います |304| 組織の[サーバー管理設定](/docs/ja/server-managed-settings) | はい | セッション開始時に Anthropic のサーバーから取得されます。クラウドセッションで `availableModels` がどのように適用されるかについては、[Surface coverage](/docs/ja/model-config#surface-coverage) を参照してください。MDM または管理設定ファイルを通じてデバイスにデプロイされた設定は適用されません。セッションは Anthropic 管理 VM で実行されるためです。[セルフホスト環境](/docs/ja/self-hosted-environments)では、セッションはランナーイメージの管理設定ファイルも読み取ります。[Claude Code が管理ソースを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)に従います |

305| ユーザー `~/.claude/CLAUDE.md` | いいえ | マシンに存在し、リポジトリには存在しません |305| ユーザー `~/.claude/CLAUDE.md` | いいえ | マシンに存在し、リポジトリには存在しません |

306| ユーザー `~/.claude/skills/`、`~/.claude/agents/`、`~/.claude/commands/` | いいえ | マシンに存在し、リポジトリには存在しません。代わりにリポジトリの `.claude/` ディレクトリにコミットしてください。クラウドセッションは claude.ai で有効にしたスキルを自動的に読み込みます |306| ユーザー `~/.claude/skills/`、`~/.claude/agents/`、`~/.claude/commands/` | いいえ | マシンに存在し、リポジトリには存在しません。代わりにリポジトリの `.claude/` ディレクトリにコミットしてください。クラウドセッションは claude.ai で有効にしたスキルを自動的に読み込みます |

307| ユーザー設定でのみ有効なプラグイン | いいえ | ユーザースコープの `enabledPlugins` は `~/.claude/settings.json` に存在します。代わりにリポジトリの `.claude/settings.json` で宣言するか、claude.ai アカウントで有効にして、Claude Code が[同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins)として読み込むようにしてください |307| ユーザー設定でのみ有効なプラグイン | いいえ | ユーザースコープの `enabledPlugins` は `~/.claude/settings.json` に存在します。代わりに claude.ai アカウントで有効にして、Claude Code が[同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins)として読み込むようにしてください |

308| デフォルトのローカルスコープまたはユーザースコープで `claude mcp add` を使用して追加した MCP サーバー | いいえ | これらはマシンの `~/.claude.json` に書き込まれ、リポジトリには書き込まれません。`claude mcp add --scope project` でサーバーを追加します。これはリポジトリの[`.mcp.json`](/docs/ja/mcp#project-scope)に書き込まれ、そのファイルをコミットしてください。1 つのリポジトリを持つセッションはそれを読み込みます |308| デフォルトのローカルスコープまたはユーザースコープで `claude mcp add` を使用して追加した MCP サーバー | いいえ | これらはマシンの `~/.claude.json` に書き込まれ、リポジトリには書き込まれません。`claude mcp add --scope project` でサーバーを追加します。これはリポジトリの[`.mcp.json`](/docs/ja/mcp#project-scope)に書き込まれ、そのファイルをコミットしてください。1 つのリポジトリを持つセッションはそれを読み込みます |

309| リポジトリの `.claude/settings.json` `env` ブロック内のトランスポート変数（`NODE_EXTRA_CA_CERTS` や[mTLS クライアント証明書変数](/docs/ja/network-config#mtls-authentication)など） | いいえ | ホスティング環境がセッションの API 接続を管理するため、Claude Code はこれらのキーを無視し、セッションのデバッグログで無視された各キーを記録します |309| リポジトリの `.claude/settings.json` `env` ブロック内のトランスポート変数（`NODE_EXTRA_CA_CERTS` や[mTLS クライアント証明書変数](/docs/ja/network-config#mtls-authentication)など） | いいえ | ホスティング環境がセッションの API 接続を管理するため、Claude Code はこれらのキーを無視し、セッションのデバッグログで無視された各キーを記録します |

310| Claude が呼び出すサービスの API キーとトークン | Pro および Max プランでは、[API 認証情報](#add-api-credentials)として | キーを環境に一度追加すると、エージェントプロキシがリストしたホストへのリクエストにそれを添付します。エージェントプロキシが[添付できない](#requests-that-never-get-the-credential)キー、または Team または Enterprise プランのキーは環境変数に留まります |310| Claude が呼び出すサービスの API キーとトークン | Pro および Max プランでは、[API 認証情報](#add-api-credentials)として | キーを環境に一度追加すると、エージェントプロキシがリストしたホストへのリクエストにそれを添付します。エージェントプロキシが[添付できない](#requests-that-never-get-the-credential)キー、または Team または Enterprise プランのキーは環境変数に留まります |

commands.md +105 −104

Details

26 26

27**並行して作業を実行します。** Claude は副次的なタスクを [サブエージェント](/docs/ja/sub-agents) に委譲し、`/tasks` は現在のセッションのバックグラウンド作業（完了したサブエージェントを含む）をリストします。`/background` はセッション全体をデタッチして [バックグラウンドエージェント](/docs/ja/agent-view) として実行し続け、ターミナルを解放します。コードベース全体にまたがる大きな変更の場合、`/batch` はそれを独立したユニットに分解し、各ユニットを独自の [ワークツリー](/docs/ja/worktrees) で実行します。これらのアプローチがどのように関連しているかについては、[エージェントを並行実行する](/docs/ja/agents) を参照してください。27**並行して作業を実行します。** Claude は副次的なタスクを [サブエージェント](/docs/ja/sub-agents) に委譲し、`/tasks` は現在のセッションのバックグラウンド作業（完了したサブエージェントを含む）をリストします。`/background` はセッション全体をデタッチして [バックグラウンドエージェント](/docs/ja/agent-view) として実行し続け、ターミナルを解放します。コードベース全体にまたがる大きな変更の場合、`/batch` はそれを独立したユニットに分解し、各ユニットを独自の [ワークツリー](/docs/ja/worktrees) で実行します。これらのアプローチがどのように関連しているかについては、[エージェントを並行実行する](/docs/ja/agents) を参照してください。

28 28

29**リリース前。** `/diff` は変更内容を表示します。`/code-review` は現在の diff を正確性バグとクリーンアップについてチェックし、`--fix` で結果を適用できます。PR 番号（例：`/code-review high 1234`）を渡して、代わりにプルリクエストをレビューします。`/review` はエイリアスです。`/code-review ultra` はクラウドでマルチエージェントレビューを実行します。`/security-review` は diff をセキュリティ脆弱性についてチェックします。29**リリース前。** `/diff` は変更内容を表示します。`/code-review` は現在の diff を正確性バグについてチェックし、`--fix` で結果を適用できます。PR 番号（例：`/code-review high 1234`）を渡して、代わりにプルリクエストをレビューします。`/review` はエイリアスです。`/code-review ultra` はクラウドでマルチエージェントレビューを実行します。`/security-review` は diff をセキュリティ脆弱性についてチェックします。

30 30

31**セッション間。** `/clear` はプロジェクトメモリを保持しながら新しいタスクで新規開始します。`/resume` は以前の会話に戻り、`/branch` は現在の会話をブランチして別の方向を試し、`/fork` はそれを新しい [バックグラウンドセッション](/docs/ja/agent-view) にコピーします。`/teleport` は Web セッションをこのターミナルに引き込み、`/remote-control` はこのローカルセッションを別のデバイスから続行できるようにします。31**セッション間。** `/clear` はプロジェクトメモリを保持しながら新しいタスクで新規開始します。`/resume` は以前の会話に戻り、`/branch` は現在の会話をブランチして別の方向を試し、`/fork` はそれを新しい [バックグラウンドセッション](/docs/ja/agent-view) にコピーします。`/teleport` は Web セッションをこのターミナルに引き込み、`/remote-control` はこのローカルセッションを別のデバイスから続行できるようにします。

32 32

36 すべてのコマンド36 すべてのコマンド

37</h2>37</h2>

38 38

39以下の表は、Claude Code に含まれるすべてのコマンドを一覧にしています。ほとんどは組み込みコマンドで、その動作は CLI にコード化されています。2 つの種類のエントリが表示されます。39以下の表は、Claude Code に含まれるすべてのコマンドを一覧にしています。ほとんどは組み込みコマンドで、その動作は CLI にコード化されています。2 種類のエントリが標記されています：

40 40

~~41* **[Skill](/docs/ja/skills#bundled-skills)**: バンドルされたスキル。自分で作成するスキルと同じように機能します。Claude に渡されるプロンプトです。~~41* **[Skill](/docs/ja/skills#bundled-skills)**: バンドルされたスキル。自分で書くスキルと同じように機能します：Claude に渡されるプロンプトです。

~~42 * `/verify` は、呼び出すときのみ実行されます。v2.1.215 より前は、Claude が自動的に `/verify` を実行することもできました。~~42 * `/verify` は呼び出すときのみ実行されます。v2.1.215 より前は、Claude が自動的に `/verify` を実行することもできました。

43* **[Workflow](/docs/ja/workflows#bundled-workflows)**: バンドルされた[動的ワークフロー](/docs/ja/workflows)で、多くのサブエージェント全体に作業を展開し、バックグラウンドで実行されます。43* **[Workflow](/docs/ja/workflows#bundled-workflows)**: バンドルされた[動的ワークフロー](/docs/ja/workflows)で、多くのサブエージェント全体に作業を展開し、バックグラウンドで実行されます。

~~44 * `/deep-research` は、呼び出すときのみ実行されます。v2.1.218 より前は、Claude が自動的に開始することもできました。~~44 * `/deep-research` は呼び出すときのみ実行されます。v2.1.218 より前は、Claude が自動的に開始することもできました。

45 45

46独自のコマンドを追加するには、[skills](/docs/ja/skills) を参照してください。46独自のコマンドを追加するには、[skills](/docs/ja/skills) を参照してください。

47 47

48以下の表では、`<arg>` は必須引数を示し、`[arg]` はオプション引数を示します。48以下の表では、`<arg>` は必須引数を示し、`[arg]` はオプション引数を示します。

49 49

50<Note>50<Note>

51 すべてのコマンドがすべてのユーザーに表示されるわけではありません。可用性はプラットフォーム、プラン、環境によって異なります。たとえば、`/desktop` は macOS と x64 Windows で Claude サブスクリプションでサインインしている場合のみ表示され、`/upgrade` は Enterprise プランでは表示されません。51 すべてのコマンドがすべてのユーザーに表示されるわけではありません。可用性はプラットフォーム、プラン、環境によって異なります。たとえば、`/desktop` は Claude サブスクリプションでサインインしている場合、macOS と x64 Windows にのみ表示され、`/upgrade` は Enterprise プランには表示されません。

52</Note>52</Note>

53 53

54| コマンド | 目的 |54| コマンド | 目的 |

55| :----------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |55| :----------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

56| `/add-dir <path>` | 現在のセッション中にファイルアクセス用の作業ディレクトリを追加します。部分的なパスを入力して一致するディレクトリの候補を表示し、`Tab` を押して 1 つを受け入れます。ほとんどの `.claude/` 設定は、追加されたディレクトリから[検出されません](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)。`\\server\share` などのほとんどの[ネットワークパス](/docs/ja/errors#working-directory-is-a-network-path)は追加できません。追加に成功すると、[`DirectoryAdded` hooks](/docs/ja/hooks#directoryadded) が実行されます。Claude が応答している間にこれを実行すると、Claude Code はディレクトリをすぐに確認するよう求め、確認すると Claude の同じターンの次のツール呼び出しがそれにアクセスできます。v2.1.234 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました |56| `/add-dir <path>` | ファイルアクセスのための作業ディレクトリを現在のセッション中に追加します。部分的なパスを入力して一致するディレクトリの提案を表示し、`Tab` を押して 1 つを受け入れます。ほとんどの `.claude/` 設定は追加されたディレクトリから[検出されません](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)。ほとんどの[ネットワークパス](/docs/ja/errors#working-directory-is-a-network-path)（`\\server\share` など）は追加できません。正常に追加された後、[`DirectoryAdded` hooks](/docs/ja/hooks#directoryadded) が実行されます。Claude が応答している間に実行すると、Claude Code はディレクトリをすぐに確認するよう求め、確認すると Claude の同じターンの次のツール呼び出しがアクセスできます。v2.1.234 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました |

57| `/advisor [model\|off]` | [アドバイザーツール](/docs/ja/advisor)を有効または無効にします。このツールはタスク中の重要な瞬間に 2 番目のモデルに相談します。`fable`、`opus`、`sonnet`、または完全なモデル ID を受け入れます。`fable` には[Fable アクセス](/docs/ja/advisor#choose-an-advisor-model)が必要です。引数がない場合は、ピッカーを開きます。対話型ターミナルがないセッション、または[Remote Control](/docs/ja/remote-control#limitations)経由では、モデルまたは `off` を引数として渡します。引数がない場合、コマンドは現在のアドバイザーをテキストとして出力します。これらのフォームには Claude Code v2.1.260 以降が必要です |57| `/advisor [model\|off]` | [advisor ツール](/docs/ja/advisor)を有効または無効にします。このツールはタスク中の重要な瞬間に 2 番目のモデルに相談します。`fable`、`opus`、`sonnet`、または完全なモデル ID を受け入れます。`fable` には [Fable アクセス](/docs/ja/advisor#choose-an-advisor-model)が必要です。引数がない場合、ピッカーが開きます。インタラクティブなターミナルがないセッション、または [Remote Control](/docs/ja/remote-control#limitations) 経由では、モデルまたは `off` を引数として渡します。引数がない場合、コマンドは現在の advisor をテキストとして出力します。これらの形式には Claude Code v2.1.260 以降が必要です |

58| `/agents` | v2.1.198 以降、`/agents` を実行すると、Claude に[サブエージェント](/docs/ja/sub-agents)を作成または管理するよう求めるか、`.claude/agents/` または `~/.claude/agents/` を直接編集するよう促すリマインダーが表示されます。v2.1.197 以前では、サブエージェント設定を作成および管理するための対話型インターフェイスを開きます |58| `/agents` | v2.1.198 以降、`/agents` を実行すると、Claude に [subagents](/docs/ja/sub-agents) を作成または管理するよう求めるか、`.claude/agents/` または `~/.claude/agents/` を直接編集するよう促すリマインダーが出力されます。v2.1.197 以前では、subagent 設定を作成および管理するためのインタラクティブなインターフェイスが開きます |

59| `/artifacts` | [アーティファクト](/docs/ja/artifacts#find-an-artifact-again)を所有しているか、共有されているアーティファクトを一覧表示し、セッションに添付するか、ブラウザで開くか、そのリンクをコピーします。[アーティファクト](/docs/ja/artifacts#availability)が利用可能な場所で利用可能です。Claude Code v2.1.208 以降が必要です。`Enter` で添付するには v2.1.216 が必要です |59| `/artifacts` | 所有または共有されている[アーティファクト](/docs/ja/artifacts#find-an-artifact-again)を一覧表示し、セッションに添付するか、ブラウザで開くか、そのリンクをコピーします。[アーティファクト](/docs/ja/artifacts#availability)が利用可能な場所で利用できます。Claude Code v2.1.208 以降が必要です。`Enter` で添付するには v2.1.216 が必要です |

60| `/auto-mode-setup` | [プロジェクトと最近のセッションから `autoMode.environment` エントリを作成](/docs/ja/auto-mode-config#generate-environment-entries)し、ドラフトを確認してユーザー設定に保存します。Pro、Max、または Team プランと Claude Code v2.1.228 以降が必要です。ネイティブ Windows では v2.1.233 以降が必要です |60| `/auto-mode-setup` | プロジェクトと最近のセッションから [`autoMode.environment` エントリ](/docs/ja/auto-mode-config#generate-environment-entries)をドラフトし、ドラフトを確認してユーザー設定に保存します。Pro、Max、または Team プランと Claude Code v2.1.228 以降が必要です。ネイティブ Windows では v2.1.233 以降が必要です |

61| `/autocompact [auto\|<tokens>]` | [auto-compact ウィンドウを設定](/docs/ja/model-config#set-the-auto-compact-window)します。Claude Code が自動的にコンパクトする前にコンテキストウィンドウがどのくらい満杯になるかを示します。`500k` などのサイズを渡すか、`auto` を渡してモデル用に調整されたウィンドウに戻します。Claude Code は値をユーザー設定に保存し、現在のセッションに適用します。受け入れられる値と何がそれをオーバーライドするかについては、[auto-compact ウィンドウを設定](/docs/ja/model-config#set-the-auto-compact-window)を参照してください。引数がない場合は、現在のウィンドウを表示するダイアログを開きます。Claude Code v2.1.221 以降が必要です |61| `/autocompact [auto\|<tokens>]` | auto-compact ウィンドウを設定します：Claude Code が自動的にコンパクトする前にコンテキストウィンドウがどのくらい満杯になるかです。`500k` などのサイズを渡すか、`auto` を渡してモデル用に調整されたウィンドウに戻します。Claude Code は値をユーザー設定に保存し、現在のセッションに適用します。受け入れられる値と何がそれをオーバーライドするかについては、[auto-compact ウィンドウを設定する](/docs/ja/model-config#set-the-auto-compact-window)を参照してください。引数がない場合、現在のウィンドウを表示するダイアログが開きます。Claude Code v2.1.221 以降が必要です |

62| `/autofix-pr [prompt]` | 現在のブランチの PR を監視し、CI が失敗するか、レビュアーがコメントを残すと修正をプッシュする[クラウドセッション](/docs/ja/claude-code-on-the-web#auto-fix-pull-requests)を生成します。`gh pr view` でチェックアウトされたブランチからオープン PR を検出します。別の PR を監視するには、最初にそのブランチをチェックアウトしてください。デフォルトでは、クラウドセッションはすべての CI 失敗とレビューコメントを修正するよう指示されます。プロンプトを渡して異なる指示を与えます。たとえば `/autofix-pr only fix lint and type errors`。`gh` CLI と[クラウドセッション](/docs/ja/claude-code-on-the-web)へのアクセスが必要です |62| `/autofix-pr [prompt]` | 現在のブランチの PR を監視し、CI が失敗するか、レビュアーがコメントを残すと修正をプッシュする[クラウドセッション](/docs/ja/claude-code-on-the-web#auto-fix-pull-requests)を生成します。`gh pr view` で現在チェックアウトされているブランチから開いている PR を検出します。別の PR を監視するには、最初にそのブランチをチェックアウトします。デフォルトでは、クラウドセッションはすべての CI 失敗とレビューコメントを修正するよう指示されます。別の指示を与えるためにプロンプトを渡します。たとえば `/autofix-pr only fix lint and type errors`。`gh` CLI と[クラウドセッション](/docs/ja/claude-code-on-the-web)へのアクセスが必要です |

63| `/background [prompt]` | 現在のセッションをデタッチして[バックグラウンドエージェント](/docs/ja/agent-view)として実行し、このターミナルを解放します。デタッチする前に 1 つ以上の指示を送信するプロンプトを渡します。`claude agents` でセッションを監視します。このセッションが実行し続けている間に会話を新しいバックグラウンドセッションにコピーするには、`/fork` を使用します。エイリアス: `/bg` |63| `/background [prompt]` | 現在のセッションをデタッチして[バックグラウンドエージェント](/docs/ja/agent-view)として実行し、このターミナルを解放します。デタッチする前に別の指示を送るためにプロンプトを渡します。`claude agents` でセッションを監視します。このセッションが実行し続けている間に会話を新しいバックグラウンドセッションにコピーするには、`/fork` を使用します。エイリアス：`/bg` |

64| `/batch <instruction>` | **[Skill](/docs/ja/skills#bundled-skills).** コードベース全体で大規模な変更を並列に調整します。コードベースを調査し、作業を 5 ～ 30 個の独立したユニットに分解し、計画を提示します。承認されると、分離された [git worktree](/docs/ja/worktrees) 内の各ユニットに 1 つの[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を生成します。各サブエージェントはそのユニットを実装し、テストを実行し、プルリクエストを開きます。git リポジトリが必要です。例: `/batch migrate src/ from JavaScript to TypeScript` |64| `/batch <instruction>` | **[Skill](/docs/ja/skills#bundled-skills).** コードベース全体で大規模な変更を並列に調整します。コードベースを調査し、作業を 5 ～ 30 個の独立したユニットに分解し、計画を提示します。承認されると、分離された [git worktree](/docs/ja/worktrees) 内のユニットごとに 1 つの[バックグラウンド subagent](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) を生成します。各 subagent はそのユニットを実装し、テストを実行し、プルリクエストを開きます。git リポジトリが必要です。例：`/batch migrate src/ from JavaScript to TypeScript` |

65| `/branch [name]` | 現在の会話をこの時点で分岐させて、会話を失わずに別の方向を試すことができます。分岐に切り替え、元の会話を保持します。`/resume` で元の会話に戻ることができます。別の[バックグラウンドセッション](/docs/ja/agent-view)として実行するコピーを切り替える代わりに、`/fork` を使用します。この会話に報告する[サブエージェント](/docs/ja/sub-agents)に副タスクを渡すには、`/subtask` を使用します |65| `/branch [name]` | 現在の会話をこの時点で分岐させて、会話を失わずに別の方向を試すことができます。分岐に切り替え、元の会話を保持します。元の会話には `/resume` で戻ることができます。別の[バックグラウンドセッション](/docs/ja/agent-view)として分岐を実行する代わりに切り替えるには、`/fork` を使用します。この会話に報告する [subagent](/docs/ja/sub-agents) に副タスクを渡すには、`/subtask` を使用します |

66| `/btw [question]` | 会話に追加せずに、現在のセッションについて[副質問](/docs/ja/interactive-mode#side-questions-with-%2Fbtw)をします。質問なしで `/btw` を実行すると、Claude Code は最新の副質問を表示して、以前の回答を参照できます。まだ質問していない場合は、Claude Code は使用行を出力します。v2.1.212 より前は、`/btw` は質問が必要でした |66| `/btw [question]` | 会話に追加せずに現在のセッションについて[副質問](/docs/ja/interactive-mode#side-questions-with-%2Fbtw)をします。`/btw` を質問なしで実行すると、Claude Code は最新の副質問を表示して、以前の回答を参照できます。まだ質問していない場合、Claude Code は使用行を出力します。v2.1.212 より前は、`/btw` は質問が必要でした |

67| `/bug [report]` | バグを報告するか、会話を共有します。セッション履歴をどのくらい含めるかを選択し、何かが送信される前に同意画面で確認します。Anthropic に第一者接続でサインインしている場合、レポートは Anthropic に送信されます。サードパーティプロバイダーまたは Anthropic 認証情報がない場合、Claude Code は[`~/.claude/feedback-bundles/` の下のローカルアーカイブ](/docs/ja/data-usage#telemetry-services)にレポートを書き込み、自分で転送します。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)では、`/bug` は代わりに拡張機能独自のフィードバックダイアログを開きます。Claude Code v2.1.229 以降が必要です。Claude が応答している間にこれを実行すると、Claude Code はダイアログをすぐに開きます。v2.1.232 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました。エイリアス: `/share`。v2.1.212 より前は、`/bug` と `/share` は `/feedback` のエイリアスでした |67| `/bug [report]` | バグを報告するか、会話を共有します。セッション履歴をどのくらい含めるかを選択し、何かが送信される前に同意画面で確認します。Anthropic への最初のパーティ接続でサインインしている場合、レポートは Anthropic に送信されます。サードパーティプロバイダーまたは Anthropic 認証情報がない場合、Claude Code はレポートを [`~/.claude/feedback-bundles/`](/docs/ja/data-usage#telemetry-services) の[ローカルアーカイブ](/docs/ja/data-usage#telemetry-services)に書き込み、自分で転送します。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)でサインインしている場合、`/bug` は代わりに拡張機能独自のフィードバックダイアログを開きます。Claude Code v2.1.229 以降が必要です。Claude が応答している間に実行すると、Claude Code はダイアログをすぐに開きます。v2.1.232 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました。エイリアス：`/share`。v2.1.212 より前は、`/bug` と `/share` は `/feedback` のエイリアスでした |

68| `/cd <path>` | このセッションを新しい作業ディレクトリに移動し、会話を保持します。部分的なパスを入力して一致するディレクトリの候補を表示し、`Tab` を押して 1 つを受け入れます。候補には Claude Code v2.1.206 以降が必要です。Claude Code が新しいディレクトリからすぐに適用するもの、および `/cd` が `/add-dir` とどのように異なるかについては、[セッションを別のディレクトリに移動](/docs/ja/permissions#move-the-session-to-another-directory)を参照してください |68| `/cd <path>` | このセッションを新しい作業ディレクトリに移動し、会話を保持します。部分的なパスを入力して一致するディレクトリの提案を表示し、`Tab` を押して 1 つを受け入れます。提案には Claude Code v2.1.206 以降が必要です。Claude Code が新しいディレクトリからすぐに適用するもの、および `/cd` が `/add-dir` とどのように異なるかについては、[セッションを別のディレクトリに移動する](/docs/ja/permissions#move-the-session-to-another-directory)を参照してください |

70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトの言語用に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み込みます。コードが `anthropic` または `@anthropic-ai/sdk` をインポートするときも自動的にアクティブになります。`migrate` を実行して、既存の Claude API コードを新しいモデルに更新します。プロジェクトの Anthropic SDK 依存関係をメジャーバージョン全体で移動するには `upgrade` を実行します。現在、Python `anthropic` パッケージを 0.x から 1.x に移動します。新しい Managed Agent を作成するウォークスルーについては、`managed-agents-onboard` を実行します。古いモデル用に作成された指示をプロンプト、スキル、ツール説明でフラグを立て、修正を diff として提案するには `prompt-audit` を実行します。プロジェクトの Claude API 支出がどこに行くかをプロファイルし、プロンプトキャッシング、不要な入出力トークンのトリミング、バッチ処理、努力、モデル選択などのオプションから節約を提案するには `cost-optimize` を実行します。一度に 1 つの変更。Claude 搭載アプリの eval セットを構築するには `build-eval` を実行し、既存の eval に対してアプリを反復的に改善するには `hillclimb` を実行します。`prompt-audit` サブコマンドには Claude Code v2.1.221 以降が必要です。`upgrade` には v2.1.236 以降が必要です。`cost-optimize` には v2.1.247 以降が必要です。`build-eval` と `hillclimb` には v2.1.259 以降が必要です |70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトの言語用に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み込みます。コードが `anthropic` または `@anthropic-ai/sdk` をインポートするときも自動的にアクティブになります。`migrate` を実行して既存の Claude API コードを新しいモデルに更新します。`upgrade` を実行してプロジェクトの Anthropic SDK 依存関係をメジャーバージョン全体で移動します。現在、Python `anthropic` パッケージを 0.x から 1.x に移動します。`managed-agents-onboard` を実行して、新しい Managed Agent を作成するウォークスルーを取得します。`prompt-audit` を実行して、プロンプト、スキル、ツール説明で古いモデル用に書かれた指示にフラグを立て、修正を diff として提案します。`cost-optimize` を実行して、プロジェクトの Claude API 支出がどこに行くかをプロファイルし、prompt caching、不要な入出力トークンのトリミング、バッチ処理、努力、モデル選択などのオプションから節約を提案します。一度に 1 つの変更を行います。`build-eval` を実行して Claude 搭載アプリの eval セットを構築し、`hillclimb` を実行して既存の eval に対してアプリを反復的に改善します。`prompt-audit` サブコマンドには Claude Code v2.1.221 以降が必要です。`upgrade` には v2.1.236 以降が必要です。`cost-optimize` には v2.1.247 以降が必要です。`build-eval` と `hillclimb` には v2.1.259 以降が必要です |

71| `/clear [name]` | 空のコンテキストで新しい会話を開始します。前の会話に `/resume` ピッカーでラベルを付けるには、名前を渡します。同じ会話を続けながらコンテキストを解放するには、`/compact` を代わりに使用します。`/resume` で前の会話を再開するか、同じ Claude Code プロセスで、[rewind メニューの previous-session エントリから](/docs/ja/checkpointing#rewind-past-a-cleared-conversation)復元します。rewind エントリには Claude Code v2.1.191 以降が必要です。エイリアス: `/reset`、`/new` |71| `/clear [name]` | 空のコンテキストで新しい会話を開始します。前の会話に `/resume` ピッカーでラベルを付けるために名前を渡します。同じ会話を続けながらコンテキストを解放するには、代わりに `/compact` を使用します。`/resume` で前の会話を再開するか、同じ Claude Code プロセスで、[rewind メニューの previous-session エントリ](/docs/ja/checkpointing#rewind-past-a-cleared-conversation)から復元します。rewind エントリには Claude Code v2.1.191 以降が必要です。エイリアス：`/reset`、`/new` |

72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/ja/skills#bundled-skills).** 現在の diff、または渡す PR 番号、ブランチ、またはパスを確認して、正確性のバグとクリーンアップの機会を確認します。`--fix` を渡して検出結果を適用し、`--comment` を渡して GitHub PR または GitLab マージリクエストに投稿するか、`ultra` を渡して深い[クラウドレビュー](/docs/ja/ultrareview)を実行します。GitLab マージリクエストに投稿するには Claude Code v2.1.257 以降が必要です。`github.com` PR ターゲットで `ultra` を使用する場合、`--post` を渡して[PR に完成した検出結果を投稿](/docs/ja/ultrareview#post-findings-to-the-pull-request)することを起動ダイアログで事前選択します。`--post` には Claude Code v2.1.227 以降が必要です。努力レベル、ターゲット、および `/simplify` との関係については、[diff をローカルで確認](/docs/ja/code-review#review-a-diff-locally)を参照してください。エイリアス: `/review` |72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/ja/skills#bundled-skills).** 現在の diff、または渡す PR 番号、ブランチ、またはパスを正確性バグについてレビューします。モデルと努力レベルに応じて、レビューはクリーンアップの機会もカバーします。`--fix` を渡して検出結果を適用し、`--comment` を渡して GitHub PR または GitLab マージリクエストに投稿するか、`ultra` を渡してディープ[クラウドレビュー](/docs/ja/ultrareview)を実行します。GitLab マージリクエストに投稿するには Claude Code v2.1.257 以降が必要です。`github.com` PR ターゲットで `ultra` を使用する場合、`--post` を渡して [PR に完成した検出結果を投稿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)ことを起動ダイアログで事前選択します。`--post` には Claude Code v2.1.227 以降が必要です。努力レベル、ターゲット、および `/simplify` との関係については、[diff をローカルでレビューする](/docs/ja/code-review#review-a-diff-locally)を参照してください。エイリアス：`/review` |

73| `/color [color\|default]` | 現在のセッションのプロンプトバーのカラーを設定します。利用可能なカラー: `red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。`default` を使用してリセットするか、引数なしで実行してランダムなカラーを選択します。[Remote Control](/docs/ja/remote-control) が接続されている場合、カラーは claude.ai/code に同期されます。非対話型モード（`-p`）でも利用可能です。Claude Code v2.1.205 以降が必要です |73| `/color [color\|default]` | 現在のセッションのプロンプトバーの色を設定します。利用可能な色：`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。`default` を使用してリセットするか、引数なしで実行してランダムな色を選択します。[Remote Control](/docs/ja/remote-control) が接続されている場合、色は claude.ai/code に同期されます。非インタラクティブモード（`-p`）でも利用可能です。Claude Code v2.1.205 以降が必要です |

74| `/compact [instructions]` | これまでの会話を要約してコンテキストを解放します。オプションで要約の焦点指示を渡します。[コンパクション処理がルール、スキル、メモリファイルをどのように処理するか](/docs/ja/context-window#what-survives-compaction)を参照してください |74| `/compact [instructions]` | ここまでの会話を要約してコンテキストを解放します。オプションで要約のフォーカス指示を渡します。[コンパクション処理がルール、スキル、メモリファイルをどのように処理するか](/docs/ja/context-window#what-survives-compaction)を参照してください |

75| `/config [key=value ...]` | [設定](/docs/ja/settings)インターフェイスを開いて、テーマ、モデル、[出力スタイル](/docs/ja/output-styles)、およびその他の設定を調整します。1 つ以上の `key=value` ペアを渡してインターフェイスを開かずに設定を直接設定します。たとえば `/config thinking=false`、`/config theme=dark`、または `/config model=sonnet`。`key=value` フォームは非対話型モード（`-p`）および Claude モバイルアプリから [Remote Control](/docs/ja/remote-control) 経由でも機能します。`key=value` フォームは、[`autoContinueAtUsageLimit`](/docs/ja/interactive-mode#turn-automatic-continue-off)などのパネルで確認が必要な設定をオンにすることはできませんが、オフにすることはできます。`/config --help` を実行して、受け入れるキーを一覧表示します。エイリアス: `/settings` |75| `/config [key=value ...]` | [設定](/docs/ja/settings)インターフェイスを開いて、テーマ、モデル、[出力スタイル](/docs/ja/output-styles)、その他の設定を調整します。1 つ以上の `key=value` ペアを渡して、インターフェイスを開かずに設定を直接設定します。たとえば `/config thinking=false`、`/config theme=dark`、または `/config model=sonnet`。`key=value` 形式は非インタラクティブモード（`-p`）および Claude モバイルアプリから [Remote Control](/docs/ja/remote-control) 経由でも機能します。`key=value` 形式は、[`autoContinueAtUsageLimit`](/docs/ja/interactive-mode#turn-automatic-continue-off) などのパネルで確認が必要な設定をオンにすることはできませんが、オフにすることはできます。`/config --help` を実行して、受け入れるキーを一覧表示します。エイリアス：`/settings` |

76| `/context [all]` | 現在のコンテキスト使用量を色付きグリッドとして視覚化します。コンテキストが多いツール、メモリの肥大化、容量警告の最適化提案を表示します。会話がコンテキストウィンドウを超える場合、出力には[警告](/docs/ja/errors#context-exceeds-the-token-limit)が含まれ、制限をどのくらい超えているか、どのコマンドがスペースを解放するかが表示されます。[全画面モード](/docs/ja/fullscreen)では、`/context` は項目ごとの内訳を折りたたんでグリッドを表示したままにします。`all` を渡して展開します |76| `/context [all]` | 現在のコンテキスト使用量をカラーグリッドとして視覚化します。コンテキストが多いツール、メモリ肥大化、容量警告の最適化提案を表示します。会話がコンテキストウィンドウを超える場合、出力には制限をどのくらい超えているか、どのコマンドがスペースを解放するかを示す[警告](/docs/ja/errors#context-exceeds-the-token-limit)が含まれます。[フルスクリーンモード](/docs/ja/fullscreen)では、`/context` は項目ごとの内訳を折りたたんでグリッドを表示したままにします。`all` を渡して展開します |

77| `/copy [N]` | 最後のアシスタント応答をクリップボードにコピーします。数値 `N` を渡して、N 番目に最新の応答をコピーします。`/copy 2` は 2 番目に最新の応答をコピーします。コードブロックが存在する場合、個別のブロックまたは完全な応答を選択するための対話型ピッカーを表示します。ピッカーで `w` を押して、クリップボードの代わりにファイルに選択を書き込みます。これは SSH 経由で便利です |77| `/copy [N]` | 最後のアシスタント応答をクリップボードにコピーします。数値 `N` を渡して N 番目に最新の応答をコピーします：`/copy 2` は 2 番目に最新の応答をコピーします。コードブロックが存在する場合、個別のブロックまたは完全な応答を選択するためのインタラクティブなピッカーを表示します。ピッカーで `w` を押して、クリップボードの代わりにファイルに選択を書き込みます。これは SSH 経由で便利です |

79| `/dataviz [request]` | **[Skill](/docs/ja/skills#bundled-skills).** チャート、グラフ、ダッシュボードの設計ガイダンス。Claude はデータのチャート形式を選択し、役割別にカラーを割り当て、バンドルされたスクリプトで色覚異常の安全性とコントラストを検証し、マーク、相互作用、アクセシビリティルールを適用します。独自のパレットに置き換えるブランド中立プレースホルダーパレットを使用します。Claude Code v2.1.198 以降が必要です |79| `/dataviz [request]` | **[Skill](/docs/ja/skills#bundled-skills).** チャート、グラフ、ダッシュボードの設計ガイダンス。Claude はデータのチャート形式を選択し、役割別に色を割り当て、バンドルされたスクリプトで色覚異常の安全性とコントラストを検証し、マーク、インタラクション、アクセシビリティルールを適用します。独自のパレットに置き換えるブランド中立的なプレースホルダーパレットを使用します。Claude Code v2.1.198 以降が必要です |

80| `/debug [description]` | **[Skill](/docs/ja/skills#bundled-skills).** 現在のセッションのデバッグログを有効にし、セッションデバッグログを読んで問題をトラブルシューティングします。デバッグログはデフォルトではオフです。`claude --debug` で開始した場合を除き、セッション中に `/debug` を実行するとその時点からログのキャプチャを開始します。オプションで問題を説明して分析に焦点を当てます |80| `/debug [description]` | **[Skill](/docs/ja/skills#bundled-skills).** 現在のセッションのデバッグログを有効にし、セッションデバッグログを読んで問題をトラブルシューティングします。デバッグログはデフォルトではオフです。`claude --debug` で開始した場合を除き、セッション中に `/debug` を実行するとその時点からログのキャプチャを開始します。オプションで問題を説明して分析にフォーカスを当てます |

81| `/deep-research <question>` | **[Workflow](/docs/ja/workflows#bundled-workflows).** 質問に関する Web 検索を展開し、ソースを取得して相互確認し、引用されたレポートを合成します |81| `/deep-research <question>` | **[Workflow](/docs/ja/workflows#bundled-workflows).** 質問に関する Web 検索をファンアウトし、ソースをフェッチして相互チェックし、引用されたレポートを合成します |

82| `/design [brief]` | **[Skill](/docs/ja/skills#bundled-skills).** UI モックアップ、スクリーンフロー、ランディングページ、またはポスターを 1 つのキャンバス上のアートボードとしてドラフトし、Design [アーティファクト](/docs/ja/artifacts#draft-a-design-canvas)として公開します。たとえば `/design a settings screen for a mobile banking app`。デスクトップブラウザでアートボードを編集し、編集は自動的に保存されます。各アートボードを PNG または PDF としてエクスポートできます。[アーティファクトが利用可能](/docs/ja/artifacts#availability)なセッションと Claude Code v2.1.265 以降が必要です。Anthropic API で利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS では、アーティファクトが利用できないため、コマンドはそこで利用できません |82| `/design [brief]` | **[Skill](/docs/ja/skills#bundled-skills).** UI モックアップ、スクリーンフロー、ランディングページ、またはポスターを 1 つのキャンバス上のアートボードとしてドラフトし、Design [artifact](/docs/ja/artifacts#draft-a-design-canvas) として公開します。たとえば `/design a settings screen for a mobile banking app`。デスクトップブラウザでアートボードを編集し、編集は自動的に保存されます。各アートボードを PNG または PDF としてエクスポートできます。[アーティファクトが利用可能](/docs/ja/artifacts#availability)なセッションと Claude Code v2.1.265 以降が必要です。Anthropic API で利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS では、アーティファクトが利用できないため、コマンドは利用できません |

84| `/design-sync [hint]` | **[Skill](/docs/ja/skills#bundled-skills).** リポジトリの React デザインシステムを変換して [Claude Design](https://claude.ai/design) にアップロードし、生成するデザインが実際のコンポーネントを使用するようにします。オプションでデザインシステムに名前を付けます。たとえば `/design-sync Acme DS`。初回同期はすべてのコンポーネントを検証し、大規模なリポジトリでは数時間かかる場合があります。Anthropic API で利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS では、基盤となるツールが claude.ai に到達できないため、コマンドは利用できません。[Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由でも利用できません |84| `/design-sync [hint]` | **[Skill](/docs/ja/skills#bundled-skills).** リポジトリの React 設計システムを変換して [Claude Design](https://claude.ai/design) にアップロードし、生成される設計が実際のコンポーネントを使用するようにします。オプションで設計システムに名前を付けます。たとえば `/design-sync Acme DS`。初回同期はすべてのコンポーネントを検証し、大規模なリポジトリでは数時間かかる場合があります。Anthropic API で利用可能です。CLI が接触しない claude.ai が必要です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由では、コマンドは利用できません |

86| `/diff` | 作業ツリーの変更（Claude がこれまでに行った編集を含む）を確認します。[/diff で変更を確認](/docs/ja/interactive-mode#review-changes-with-%2Fdiff)を参照してください |86| `/diff` | 作業ツリーの変更（Claude がこれまでに行った編集を含む）を確認します。[/diff で変更を確認する](/docs/ja/interactive-mode#review-changes-with-%2Fdiff)を参照してください |

87| `/doctor` | **[Skill](/docs/ja/skills#bundled-skills).** セットアップチェックアップを実行して、問題を診断して修正できます。重複またはレフトオーバーインストール、`PATH` の問題、解析不可能な設定ファイルなど、インストール正常性をチェックします。未使用のスキル、MCP サーバー、プラグインとそのコンテキストコストを検出し、遅い[hooks](/docs/ja/hooks)にフラグを立て、[リリースチャネル](/docs/ja/setup#configure-release-channel)で新しいバージョンをチェックします。ローカル `CLAUDE.md` ファイルをチェックイン済みのファイルに対して重複排除し、Claude がコードベースから導出できるコンテンツをカットしてチェックイン済み [`CLAUDE.md`](/docs/ja/memory#my-claude-md-is-too-large) ファイルをトリミングし、残っている常にロードされるガイダンスを[スキル](/docs/ja/skills)およびオンデマンドでロードされるネストされた `CLAUDE.md` ファイルに移行します。また、[自動モード](/docs/ja/permissions#permission-modes)をデフォルトにすることと、頻繁に拒否される読み取り専用コマンドを[事前承認](/docs/ja/permissions)することも提案します。最初に検出結果を報告し、何かを変更する前に確認を求めます。ターミナルから、`claude doctor` はセッションを開始せずに読み取り専用インストール診断を出力します。エイリアス: `/checkup`。`CLAUDE.md` トリミングチェックには Claude Code v2.1.206 以降が必要です。v2.1.205 より前は、`/doctor` は読み取り専用診断画面を開き、`f` を押すとレポートを Claude に送信しました |87| `/doctor` | **[Skill](/docs/ja/skills#bundled-skills).** セットアップチェックアップを実行して、問題を診断して修正できます。重複またはレフトオーバーインストール、`PATH` の問題、解析不可能な設定ファイルを含むインストール正常性をチェックします。未使用のスキル、MCP サーバー、プラグインとそのコンテキストコストを検出し、遅い [hooks](/docs/ja/hooks) にフラグを立て、[リリースチャネル](/docs/ja/setup#configure-release-channel)で新しいバージョンをチェックします。ローカル `CLAUDE.md` ファイルをチェックイン済みのファイルに対して重複排除し、チェックイン済みの [`CLAUDE.md`](/docs/ja/memory#my-claude-md-is-too-large) ファイルをコードベースから導出できるコンテンツをカットしてトリミングし、常にロードされるガイダンスを [skills](/docs/ja/skills) とオンデマンドでロードされるネストされた `CLAUDE.md` ファイルに移行します。また、[auto mode](/docs/ja/permissions#permission-modes) をデフォルトにすることと、頻繁に拒否される読み取り専用コマンドを[事前承認](/docs/ja/permissions)することを提案します。最初に検出結果を報告し、何かを変更する前に確認を求めます。ターミナルから、`claude doctor` はセッションを開始せずに読み取り専用インストール診断を出力します。エイリアス：`/checkup`。`CLAUDE.md` トリミングチェックには Claude Code v2.1.206 以降が必要です。v2.1.205 より前は、`/doctor` は読み取り専用診断画面を開き、`f` を押すとレポートを Claude に送信しました |

88| `/effort [level\|auto\|status]` | [努力レベル](/docs/ja/model-config#adjust-effort-level)を設定します。`low` から `xhigh`、`max`、[`ultracode`](/docs/ja/workflows#let-claude-decide-with-ultracode)、または `auto`。`status` はそれを出力します。`max` と `ultracode` はセッションのみです。[`ultracode`](/docs/ja/settings-reference#ultracode) キーは永続化されます。Claude が応答している間にこれを実行し、Claude Code が表示する場合は[キャッシュ警告](/docs/ja/prompt-caching#changing-effort-level)を確認すると、Claude Code は新しいレベルをそのターンの次のリクエストに適用します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからターン中にコマンドを実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)しないセッション（[サードパーティプロバイダー](/docs/ja/third-party-integrations)など）では常にキューに入れていました。[努力保留](/docs/ja/model-config#adjust-effort-level)外の `-p` で機能します |88| `/effort [level\|auto\|status]` | [努力レベル](/docs/ja/model-config#adjust-effort-level)を設定します：`low` から `xhigh`、`max`、[`ultracode`](/docs/ja/workflows#let-claude-decide-with-ultracode)、または `auto`。`status` はそれを出力します。`max` と `ultracode` はセッションのみです。[`ultracode`](/docs/ja/settings-reference#ultracode) キーは永続化されます。Claude が応答している間に実行し、[キャッシュ警告](/docs/ja/prompt-caching#changing-effort-level)を確認すると、Claude Code が表示する場合、Claude Code は新しいレベルをそのターンの次のリクエストに適用します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからコマンドをミッドターンで実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッション（[サードパーティプロバイダー](/docs/ja/third-party-integrations)など）では常にキューに入れていました。非インタラクティブモード（`-p`）で機能します |

91| `/fast [on\|off]` | [高速モード](/docs/ja/fast-mode)をオンまたはオフに切り替えます。Claude が応答している間にこれを実行すると、Claude Code はターンが終了するのを待たずに高速モードを切り替えますが、実行中のターンは元の速度で終了します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからターン中にコマンドを実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)しないセッションでは常にキューに入れていました。非対話型モード（`-p`）での可用性は限定的です。[高速モードを切り替え](/docs/ja/fast-mode#toggle-fast-mode)を参照してください。Claude Code v2.1.205 以降が必要です |91| `/fast [on\|off]` | [fast mode](/docs/ja/fast-mode) をオンまたはオフに切り替えます。Claude が応答している間に実行し、Claude Code はターンの終了を待たずに fast mode を切り替えます。ただし、実行中のターンは元の速度で終了します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからコマンドをミッドターンで実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションでは常にキューに入れていました。非インタラクティブモードでの `-p` での可用性は限定的です。[fast mode を切り替える](/docs/ja/fast-mode#toggle-fast-mode)を参照してください。Claude Code v2.1.205 以降が必要です |

92| `/feedback [report]` | Claude Code に関する製品フィードバックを送信します。[`/bug`](#all-commands) と同じダイアログを開き、同じ同意ステップ、送信ルール、ターン中の動作を使用します。[Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を含むセッションでは、引数なしで `/feedback` を実行するとドラフトキューを開きます。ここで、Claude がキューに入れたドラフトを確認、編集、送信、または破棄します。キューには新しいレポートをダイアログに書き込むオプションが含まれます。引数を使用する場合、および `/bug` の場合は常に、ダイアログが直接開きます |92| `/feedback [report]` | Claude Code に関する製品フィードバックを送信します。[`/bug`](#all-commands) と同じダイアログを開き、同じ同意ステップ、送信ルール、ミッドターン動作があります。[Claude がドラフトしたフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を含むセッションでは、引数なしで `/feedback` を実行するとドラフトキューが代わりに開き、Claude がキューに入れたドラフトを確認、編集、送信、または破棄できます。キューには新しいレポートをダイアログで書き込むオプションが含まれます。引数を指定した場合、および `/bug` の場合は常に、ダイアログが直接開きます |

93| `/fewer-permission-prompts` | **[Skill](/docs/ja/skills#bundled-skills).** トランスクリプトで一般的な読み取り専用 Bash および MCP ツール呼び出しをスキャンし、プロジェクト `.claude/settings.json` に優先許可リストを追加して権限プロンプトを減らします |93| `/fewer-permission-prompts` | **[Skill](/docs/ja/skills#bundled-skills).** トランスクリプトで一般的な読み取り専用 Bash および MCP ツール呼び出しをスキャンし、プロジェクト `.claude/settings.json` に優先許可リストを追加して権限プロンプトを減らします |

94| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、編集 diffstats を含む 1 行のツール呼び出しサマリー、および最終応答のみを表示します。ツール呼び出しサマリーはターンで起動されたサブエージェントもカウントし、完了したバックグラウンドタスク通知を 1 つのカウントに折りたたみます。選択はセッション全体で永続化されます。設定で [`viewMode`](/docs/ja/settings-reference#viewmode) を設定してオーバーライドします。[全画面レンダリング](/docs/ja/fullscreen)でのみ利用可能です。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)は独自のフォーカスビューをコマンドメニュー切り替えとして提供し、拡張機能設定として保存され、`viewMode` とは独立しています |94| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、1 行のツール呼び出し要約と編集 diffstats、および最終応答のみを表示します。ツール呼び出し要約はターンで起動された subagents もカウントし、完了したバックグラウンドタスク通知を 1 つのカウントに折りたたみます。選択はセッション全体で永続化されます。設定で [`viewMode`](/docs/ja/settings-reference#viewmode) を設定してオーバーライドします。[フルスクリーンレンダリング](/docs/ja/fullscreen)でのみ利用可能です。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)は独自のフォーカスビューをコマンドメニュー切り替えとして提供し、拡張機能設定として保存され、`viewMode` とは独立しています |

95| `/fork [prompt]` | [現在の会話をコピー](/docs/ja/agent-view#copy-the-session-with-%2Ffork)して新しいバックグラウンドセッションを作成し、ここで作業を続けます。プロンプトを渡すと、コピーはすぐにそれに取り組み始めます。なしで、エージェントビューで最初のプロンプトを待ちます。コピーが[その場で編集](/docs/ja/agent-view#how-file-edits-are-isolated)する場合を除き、Claude Code はコード変更を行う前に独自の worktree を作成するよう指示します。分離指示には Claude Code v2.1.221 以降が必要です。結果がこの会話に戻ってくるサブエージェントに副タスクを渡すには、`/subtask` を使用します。自分でコピーに切り替えるには、`/branch` を使用します。Claude Code v2.1.212 以降が必要です。v2.1.161 ～ v2.1.211 では、および [agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっている場合は常に、`/fork` は[フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation)を開始します |95| `/fork [prompt]` | [現在の会話をコピー](/docs/ja/agent-view#copy-the-session-with-%2Ffork)して新しいバックグラウンドセッションを作成し、ここで作業を続けます。プロンプトを渡すとコピーはすぐにそれに対して作業を開始します。渡さない場合、エージェントビューで最初のプロンプトを待ちます。コピーが[その場で編集](/docs/ja/agent-view#how-file-edits-are-isolated)する場合を除き、Claude Code はコード変更を行う前に独自の worktree を作成するよう指示します。分離指示には Claude Code v2.1.221 以降が必要です。結果がこの会話に戻ってくる subagent に副タスクを渡すには、`/subtask` を使用します。自分でコピーに切り替えるには、`/branch` を使用します。Claude Code v2.1.212 以降が必要です。v2.1.161 ～ v2.1.211 では、および [agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっている場合は常に、`/fork` は [forked subagent](/docs/ja/sub-agents#fork-the-current-conversation) を開始します |

96| `/goal [condition\|clear]` | [目標](/docs/ja/goal)を設定します。Claude は条件が満たされるか、目標が[別の理由でクリア](/docs/ja/goal#how-evaluation-works)されるまで、ターン全体で作業を続けます。引数がない場合は、現在または最近達成された目標を表示します。`clear`、`stop`、`off`、`reset`、`none`、または `cancel` はアクティブな目標を早期に削除します |96| `/goal [condition\|clear]` | [goal](/docs/ja/goal) を設定します：Claude は条件が満たされるか goal が[別の理由でクリア](/docs/ja/goal#how-evaluation-works)されるまでターン全体で作業を続けます。引数がない場合、現在または最近達成された goal を表示します。`clear`、`stop`、`off`、`reset`、`none`、または `cancel` はアクティブな goal を早期に削除します |

97| `/heapdump` | JavaScript ヒープスナップショットとメモリ内訳を `~/Desktop` または Linux のホームディレクトリ（Desktop フォルダがない場合）に書き込んで、高いメモリ使用量を診断します。メモリの問題を報告するときは、`-diagnostics.json` ファイルのみを添付してください。`.heapsnapshot` には完全な会話と認証情報が含まれているため、共有しないでください。[出力で何をするか](/docs/ja/troubleshooting#high-cpu-or-memory-usage)を参照してください |97| `/heapdump` | JavaScript ヒープスナップショットとメモリ内訳を `~/Desktop` または Linux のホームディレクトリ（Desktop フォルダがない場合）に書き込んで、高いメモリ使用量を診断します。メモリ問題を報告するときは `-diagnostics.json` ファイルのみを添付してください。`.heapsnapshot` には完全な会話と認証情報が含まれているため、共有しないでください。[出力で何をするか](/docs/ja/troubleshooting#high-cpu-or-memory-usage)を参照してください |

100| `/ide` | IDE 統合を管理して状態を表示します |100| `/ide` | IDE 統合を管理して状態を表示します |

101| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | マシン上の OpenAI Codex、Google Gemini CLI、または Cursor から Claude Code に設定を取り込みます。指示ファイル、MCP サーバー、コマンド、サブエージェント、スキルを含みます。[非対話型モード](/docs/ja/headless)で `-p` を使用する場合、`/import` は見つけたものを一覧表示し、インポートを確認するコマンドを提供します。`--dry-run` を追加して何も書き込まずにプレビューするか、`--yes` を追加して対話型ピッカーをスキップします。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または Claude Platform on AWS では利用できません。[Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由でも利用できません。[フィーチャーフラグ取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)をオフにしている場合も利用できません。Claude Code v2.1.213 以降が必要です。Cursor からのインポートには v2.1.265 以降が必要です |101| `/import [codex\|gemini\|cursor] [--dry-run] [--yes]` | OpenAI Codex、Google Gemini CLI、または Cursor からマシン上の Claude Code に設定を取り込みます。指示ファイル、MCP サーバー、コマンド、subagents、スキルを含みます。[非インタラクティブモード](/docs/ja/headless)で `-p` を使用する場合、`/import` は見つけたものを一覧表示し、インポートを確認するコマンドを提供します。`--dry-run` を追加して何も書き込まずにプレビューするか、`--yes` を追加してインタラクティブなピッカーをスキップします。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、または [Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) 経由では利用できません。[フィーチャーフラグフェッチング](/docs/ja/env-vars#features-that-need-feature-flag-fetching)をオフにしている場合も利用できません。Claude Code v2.1.213 以降が必要です。Cursor からのインポートには v2.1.265 以降が必要です |

102| `/init` | `CLAUDE.md` ガイドでプロジェクトを初期化します。`CLAUDE_CODE_NEW_INIT=1` を設定して、スキル、hooks、個人メモリファイルもウォークスルーする対話型フローを実行します。`/init` が OpenAI Codex または Google Gemini CLI 設定を見つけた場合、`/import` で引き継ぐことを提案します |102| `/init` | `CLAUDE.md` ガイドでプロジェクトを初期化します。`CLAUDE_CODE_NEW_INIT=1` を設定して、スキル、hooks、個人メモリファイルのウォークスルーも行うインタラクティブなフローを取得します。`/init` が OpenAI Codex または Google Gemini CLI 設定を見つけた場合、`/import` で引き継ぐことを提案します |

103| `/insights` | このマシンの最近のセッションを分析する HTML レポートを生成します。どのプロジェクトで作業するか、Claude Code をどのように使用するか、何が問題になるか、試すべき機能を示します。[クラウドセッション](/docs/ja/claude-code-on-the-web)では利用できません。レポートの場所、保持期間、コストについては、[使用パターンを分析](/docs/ja/costs#analyze-your-usage-patterns)を参照してください |103| `/insights` | このマシンの最近のセッションを分析する HTML レポートを生成します：どのプロジェクトで作業するか、Claude Code をどのように使用するか、何が問題になるか、試すべき機能。[クラウドセッション](/docs/ja/claude-code-on-the-web)では利用できません。レポートの場所、保持、コストについては、[使用パターンを分析する](/docs/ja/costs#analyze-your-usage-patterns)を参照してください |

104| `/install-github-app` | リポジトリに Claude GitHub App をインストールし、オプションで [GitHub Actions](/docs/ja/github-actions) ワークフローとシークレットをセットアップするステップを実行します。リポジトリを選択して統合を設定するウォークスルーを実行します。github.com リポジトリでのみ機能します。リポジトリの git リモートが gitlab.com または bitbucket.org にある場合、コマンドは通知を出力してセットアップを開始する代わりに終了します。GitLab パイプラインから Claude Code を実行するには、[GitLab CI/CD](/docs/ja/gitlab-ci-cd) を参照してください |104| `/install-github-app` | リポジトリの Claude GitHub App をインストールし、[GitHub Actions](/docs/ja/github-actions) ワークフローとシークレットをセットアップするオプションのステップを実行します。リポジトリを選択して統合を設定するウォークスルーを行います。github.com リポジトリでのみ機能します。リポジトリの git リモートが gitlab.com または bitbucket.org にある場合、コマンドは通知を出力してセットアップを開始する代わりに終了します。GitLab パイプラインから Claude Code を実行するには、[GitLab CI/CD](/docs/ja/gitlab-ci-cd) を参照してください |

107| `/list-agents` | Claude Code がメッセージを送信できるサブエージェント、[エージェントチーム](/docs/ja/agent-teams)チームメイト、およびその他の Claude Code セッションを一覧表示し、各セッションに使用する名前を表示します。[クロスセッションメッセージング](/docs/ja/cross-session-messaging)を参照してください。`/peers` としても利用可能です。Claude Code v2.1.224 以降が必要です。以前のバージョンは `Unknown command: /list-agents` を報告します。チームメイト行とこのセッション独自の名前を表示する最初の行には v2.1.239 以降が必要です。[クロスセッションメッセージングが有効](/docs/ja/cross-session-messaging#availability)なセッションでのみ利用可能です |107| `/list-agents` | subagents、[agent team](/docs/ja/agent-teams) チームメイト、および Claude Code がメッセージを送信できるその他の Claude Code セッションを、各セッションで使用する名前とともに一覧表示します。[クロスセッションメッセージング](/docs/ja/cross-session-messaging)を参照してください。`/peers` としても利用可能です。Claude Code v2.1.224 以降が必要です。以前のバージョンは `Unknown command: /list-agents` を報告します。チームメイト行とこのセッション独自の名前を示す最初の行には v2.1.239 以降が必要です。[クロスセッションメッセージングが有効](/docs/ja/cross-session-messaging#availability)なセッションでのみ利用可能です |

110| `/loop [interval] [prompt]` | **[Skill](/docs/ja/skills#bundled-skills).** セッションが開いている間、プロンプトを繰り返し実行します。間隔を省略すると、Claude は[反復間で自動ペース](/docs/ja/scheduled-tasks#let-claude-choose-the-interval)を設定します。プロンプトを省略すると、Claude は[組み込みメンテナンスプロンプト](/docs/ja/scheduled-tasks#run-the-built-in-maintenance-prompt)または [`loop.md`](/docs/ja/scheduled-tasks#customize-the-default-prompt-with-loop-md) を実行します。例: `/loop 5m check if the deploy finished`。[スケジュールでプロンプトを実行](/docs/ja/scheduled-tasks)を参照してください。エイリアス: `/proactive` |110| `/loop [interval] [prompt]` | **[Skill](/docs/ja/skills#bundled-skills).** セッションが開いている間、プロンプトを繰り返し実行します。間隔を省略すると、Claude は[反復間で自分のペースを設定](/docs/ja/scheduled-tasks#let-claude-choose-the-interval)します。プロンプトを省略すると、Claude は[組み込みメンテナンスプロンプト](/docs/ja/scheduled-tasks#run-the-built-in-maintenance-prompt)または [`loop.md`](/docs/ja/scheduled-tasks#customize-the-default-prompt-with-loop-md) を実行します。例：`/loop 5m check if the deploy finished`。[スケジュールでプロンプトを実行する](/docs/ja/scheduled-tasks)を参照してください。エイリアス：`/proactive` |

111| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | MCP サーバー接続と OAuth 認証を管理します。引数なしで実行して対話型リストを開くか、`reconnect <server>` を渡して 1 つの切断されたサーバーを再接続するか、`enable`/`disable` をサーバー名または `all` で渡してダイアログを開かずに接続状態を変更します。非対話型モード（`-p`）でも利用可能です。引数なしで実行するとリストを開く代わりにサーバーステータスのテキストサマリーを出力します。Claude Code v2.1.205 以降が必要です |111| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | MCP サーバー接続と OAuth 認証を管理します。引数なしで実行してインタラクティブなリストを開くか、`reconnect <server>` を渡して 1 つの切断されたサーバーを再接続するか、`enable`/`disable` をサーバー名または `all` で渡してダイアログを開かずに接続状態を変更します。非インタラクティブモード（`-p`）でも利用可能です。引数なしで実行するとサーバー状態のテキスト要約を出力します。ダイアログを開く代わりに Claude Code v2.1.205 以降が必要です |

114| `/model [model]` | AI モデルを切り替えて、新しいセッションのデフォルトとして保存します。サポートするモデルの場合、左右の矢印を使用して[努力レベルを調整](/docs/ja/model-config#adjust-effort-level)します。引数がない場合は、ピッカーを開きます。行で `s` を押して、現在のセッションのみに切り替えます。[Claude Code がスイッチを確認するよう求めるとき](/docs/ja/prompt-caching#switching-models)を参照してください。スイッチを確認すると、Claude Code が尋ねた場合、Claude Code は現在の応答が終了するのを待たずに変更を適用します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからターン中にコマンドを実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)しないセッション（[サードパーティプロバイダー](/docs/ja/third-party-integrations)など）では常にキューに入れていました。非対話型モード（`-p`）でもモデル引数を使用して利用可能です。ピッカーの代わりに、現在のセッションのみに適用され、デフォルトとして保存されません。Claude Code v2.1.205 以降が必要です |114| `/model [model]` | AI モデルを切り替えて、新しいセッションのデフォルトとして保存します。サポートするモデルの場合、左右の矢印を使用して[努力レベルを調整](/docs/ja/model-config#adjust-effort-level)します。引数がない場合、ピッカーが開きます。行で `s` を押して現在のセッションのみ切り替えます。[Claude Code が切り替えを確認するよう求めるとき](/docs/ja/prompt-caching#switching-models)を参照してください。切り替えを確認すると、Claude Code が尋ねた場合、Claude Code は現在の応答の終了を待たずに変更を適用します。v2.1.242 より前は、Claude Code は Anthropic から取得したフィーチャーフラグからコマンドをミッドターンで実行するか、ターンが終了するまでキューに入れるかを決定し、[フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッション（[サードパーティプロバイダー](/docs/ja/third-party-integrations)など）では常にキューに入れていました。非インタラクティブモード（`-p`）でもモデル引数を使用して利用可能です。ピッカーの代わりに、現在のセッションのみに適用され、デフォルトとして保存されません。Claude Code v2.1.205 以降が必要です |

115| `/output-style [style]` | [出力スタイル](/docs/ja/output-styles)を一覧表示するか、1 つに切り替えます。たとえば `/output-style concise`。[出力スタイルを変更](/docs/ja/output-styles#change-your-output-style)を参照してください。Claude Code v2.1.269 以降が必要です |115| `/output-style [style]` | [出力スタイル](/docs/ja/output-styles)を一覧表示するか、1 つに切り替えます。たとえば `/output-style concise`。[出力スタイルを変更する](/docs/ja/output-styles#change-your-output-style)を参照してください。Claude Code v2.1.269 以降が必要です |

117| `/permissions` | ツール権限の許可、質問、拒否ルールを管理します。対話型ダイアログを開きます。スコープ別にルールを表示し、ルールを追加または削除し、作業ディレクトリを管理し、[最近の自動モード拒否](/docs/ja/auto-mode-config#review-denials)を確認できます。ダイアログの **Auto mode** タブから[自動モード分類器ルール](/docs/ja/auto-mode-config#edit-rules-from-permissions)を表示および編集することもできます。Claude が応答している間にこれを実行すると、Claude Code はダイアログをすぐに開き、Claude の同じターンの次のツール呼び出しから変更を適用します。v2.1.234 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました。エイリアス: `/allowed-tools` |117| `/permissions` | ツール権限の許可、質問、拒否ルールを管理します。スコープ別にルールを表示し、ルールを追加または削除し、作業ディレクトリを管理し、[最近の auto mode 拒否](/docs/ja/auto-mode-config#review-denials)を確認できるインタラクティブなダイアログが開きます。ダイアログの **Auto mode** タブから [auto mode 分類器ルール](/docs/ja/auto-mode-config#edit-rules-from-permissions)を表示および編集することもできます。Claude が応答している間に実行すると、Claude Code はダイアログをすぐに開き、同じターンで Claude の次のツール呼び出しから変更を適用します。v2.1.234 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました。エイリアス：`/allowed-tools` |

119| `/plugin [subcommand]` | Claude Code [プラグイン](/docs/ja/plugins)を管理します。引数なしで実行してプラグインメニューを開くか、`list`、`install`、`enable`、`disable` などのサブコマンドを渡して直接実行します。Claude Code はインストール中にプラグインをアクティブ化できます。[インストールサマリー](/docs/ja/discover-plugins#install-plugins)は、それが行われたか、`/reload-plugins` を実行するかを示します |119| `/plugin [subcommand]` | Claude Code [plugins](/docs/ja/plugins) を管理します。引数なしで実行してプラグインメニューを開くか、`list`、`install`、`enable`、`disable` などのサブコマンドを渡して直接実行します。Claude Code はインストール中にプラグインをアクティブ化できます。[インストール要約](/docs/ja/discover-plugins#install-plugins)は、アクティブ化したかどうか、または `/reload-plugins` を実行するかどうかを示します |

121| `/pr-comments [PR]` | v2.1.91 で削除されました。代わりに Claude に直接プルリクエストコメントを表示するよう依頼してください。以前のバージョンでは、GitHub プルリクエストからコメントを取得して表示します。現在のブランチの PR を自動的に検出するか、PR URL または番号を渡します。`gh` CLI が必要です |121| `/pr-comments [PR]` | v2.1.91 で削除されました。代わりに Claude に直接プルリクエストコメントを表示するよう求めてください。以前のバージョンでは、GitHub プルリクエストからコメントをフェッチして表示します。現在のブランチの PR を自動的に検出するか、PR URL または番号を渡します。`gh` CLI が必要です |

124| `/rate-limit-options` | claude.ai 使用制限がリクエストをブロックしているときに作業を続ける方法を表示します。待機して[制限がリセットされたときに自動的に続行](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)するか、[使用クレジット](/docs/ja/costs#add-usage-credits-to-your-subscription)を追加するか、プランをアップグレードします。Claude Code は、独自のターミナルで制限に達したときに、このメニューを独自に開くこともできます。[自動続行をオフにする](/docs/ja/interactive-mode#turn-automatic-continue-off)を参照してください。claude.ai サブスクリプションが必要です。コマンドメニューに表示されません。完全に入力してください。待機と続行の行には Claude Code v2.1.234 以降が必要です |124| `/rate-limit-options` | claude.ai 使用制限がリクエストをブロックしている場合に作業を続ける方法を表示します：待機して[制限がリセットされたときに自動的に続行](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)、[使用クレジット](/docs/ja/costs#add-usage-credits-to-your-subscription)を追加、またはプランをアップグレードします。Claude Code は制限に達したときに独自のターミナルでこのメニューを開くこともできます。[自動続行をオフにする](/docs/ja/interactive-mode#turn-automatic-continue-off)を参照してください。claude.ai サブスクリプションが必要です。コマンドメニューに表示されません。完全に入力してください。待機と続行行には Claude Code v2.1.234 以降が必要です |

125| `/recap` | 現在のセッションの 1 行のサマリーをオンデマンドで生成します。[セッションの要約](/docs/ja/interactive-mode#session-recap)を参照してください。これは、離れていた後に表示される自動要約です |125| `/recap` | 現在のセッションの 1 行の要約をオンデマンドで生成します。[セッション要約](/docs/ja/interactive-mode#session-recap)を参照してください。これは、離れていた後に表示される自動要約です |

126| `/release-notes` | 対話型バージョンピッカーでチェンジログを表示します。特定のバージョンを選択してそのリリースノートを表示するか、すべてのバージョンを表示することを選択します。ノートはトランスクリプトに表示され、Claude が見る会話に入りません |126| `/release-notes` | インタラクティブなバージョンピッカーでチェンジログを表示します。特定のバージョンを選択してそのリリースノートを表示するか、すべてのバージョンを表示することを選択します。ノートは Claude が見るトランスクリプトに表示されます |

127| `/reload-plugins [--force]` | すべてのアクティブな[プラグイン](/docs/ja/plugins)を再度読み込んで、再起動せずに保留中の変更を適用します。再度読み込まれた各コンポーネントのカウントを報告し、読み込みエラーにフラグを立てます。再度読み込むと、読み込まれた MCP ツールが変更され、プロンプトキャッシュが無効になる場合、コマンドは警告を表示し、`--force` を渡さない限りスキップします。非対話型モード（`-p`）、Agent SDK、デスクトップアプリでも利用可能です。セッションに直接入力されたテキストでのみ実行され、プラグイン MCP サーバーの変更は適用されません。Claude Code v2.1.260 以降が必要です。[再起動なしでプラグイン変更を適用](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を参照してください |127| `/reload-plugins [--force]` | すべてのアクティブな [plugins](/docs/ja/plugins) を再度読み込んで、保留中の変更を再起動なしで適用します。再度読み込まれた各コンポーネントのカウントを報告し、読み込みエラーにフラグを立てます。再度読み込むと読み込まれた MCP ツールが変更され、プロンプトキャッシュが無効になる場合、コマンドは警告を出し、`--force` を渡さない限りスキップします。非インタラクティブモード（`-p`）、Agent SDK、デスクトップアプリでも利用可能です。セッションに直接入力されたテキストでのみ実行され、プラグイン MCP サーバーの変更は適用されません。Claude Code v2.1.260 以降が必要です。[再起動なしでプラグイン変更を適用する](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を参照してください |

128| `/reload-skills` | [スキル](/docs/ja/skills)とコマンドディレクトリを再スキャンして、セッション中にディスク上で追加または変更されたスキルが再起動なしで利用可能になるようにします。利用可能なスキルの数と追加または削除されたスキルの数を報告します |128| `/reload-skills` | [skill](/docs/ja/skills) とコマンドディレクトリを再スキャンして、セッション中にディスクで追加または変更されたスキルが再起動なしで利用可能になるようにします。利用可能なスキルの数と追加または削除されたスキルの数を報告します |

129| `/remote-control` | このセッションを claude.ai から[Remote Control](/docs/ja/remote-control) で利用可能にします。サインアウト状態で実行すると、Remote Control に claude.ai サブスクリプションが必要であることを出力し、サインイン方法を示します。v2.1.206 より前は `Unknown command: /remote-control` を報告しました。エイリアス: `/rc` |129| `/remote-control` | このセッションを claude.ai から [Remote Control](/docs/ja/remote-control) で利用可能にします。サインアウト状態で実行すると、Remote Control に claude.ai サブスクリプションが必要であることを出力し、サインイン方法を示します。v2.1.206 より前は `Unknown command: /remote-control` を報告しました。エイリアス：`/rc` |

131| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合は、会話履歴から自動生成されます。非対話型モード（`-p`）でも利用可能です。Claude Code v2.1.205 以降が必要です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字でキャップします。非表示文字が削除されると名前が空の場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字の置き換えと長さの上限には Claude Code v2.1.221 以降が必要です。このマシン上の別のライブセッションが既に渡した名前を使用している場合、Claude Code は代わりに[その変種](/docs/ja/sessions#name-your-sessions)を適用します |131| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非インタラクティブモード（`-p`）でも利用可能です。Claude Code v2.1.205 以降が必要です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字でキャップします。非表示文字が削除されると名前が空の場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さキャップには Claude Code v2.1.221 以降が必要です。このマシン上の別のライブセッションが既に渡した名前を使用している場合、Claude Code は[その変種](/docs/ja/sessions#name-your-sessions)を代わりに適用します |

132| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。[バックグラウンドセッション](/docs/ja/agent-view)はピッカーに `bg` でマークされて表示されます。実行中のセッションはここで再開できないため、`claude agents` から接続するか、最初にそこで停止します。エイリアス: `/continue` |132| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。[バックグラウンドセッション](/docs/ja/agent-view)はピッカーに `bg` でマークされて表示されます。実行中のセッションはここで再開できないため、`claude agents` からアタッチするか、最初にそこで停止します。エイリアス：`/continue` |

133| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | [`/code-review`](/docs/ja/code-review#review-a-diff-locally) のエイリアス。現在の diff、または `/review 1234` などの渡す PR 番号、ブランチ、またはパスを確認し、同じ努力レベルとフラグを取ります。レベルが指定されていない場合、レビューは最後に入力した `low` ～ `max` レベルを再利用します。正確なルールについては、[diff をローカルで確認](/docs/ja/code-review#review-a-diff-locally)を参照してください。深いクラウドレビューについては、[`/code-review ultra`](/docs/ja/ultrareview) を使用してください。v2.1.223 より前は、`/review` は GitHub プルリクエストの単一パス、読み取り専用レビューを実行する別のコマンドで、引数なしで実行するときはオープン PR を一覧表示して選択できました。v2.1.186 ～ v2.1.201 では、`/code-review medium` と同じマルチエージェントエンジンを実行しました |133| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | [`/code-review`](/docs/ja/code-review#review-a-diff-locally) のエイリアス：現在の diff、または `/review 1234` などの渡す PR 番号、ブランチ、またはパスをレビューし、同じ努力レベルとフラグを取ります。レベルが指定されていない場合、レビューは最後に入力した `low` ～ `max` レベルを再利用します。正確なルールについては、[diff をローカルでレビューする](/docs/ja/code-review#review-a-diff-locally)を参照してください。ディープクラウドレビューの場合は、[`/code-review ultra`](/docs/ja/ultrareview) を使用してください。v2.1.223 より前は、`/review` は GitHub プルリクエストの単一パス、読み取り専用レビューを実行する別のコマンドで、引数なしで実行すると開いている PR を一覧表示して選択できました。v2.1.186 ～ v2.1.201 では、`/code-review medium` と同じマルチエージェントエンジンを実行しました |

134| `/rewind` | 会話またはコードを前の時点に巻き戻すか、選択したメッセージから要約します。[チェックポイント](/docs/ja/checkpointing)を参照してください。エイリアス: `/checkpoint`、`/undo` |134| `/rewind` | 会話またはコードを前の時点に巻き戻すか、選択したメッセージから要約します。[checkpointing](/docs/ja/checkpointing) を参照してください。エイリアス：`/checkpoint`、`/undo` |

135| `/run` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトのアプリを起動して駆動して、テストに合格するだけでなく、変更が機能しているのを確認します。[アプリを実行して検証](/docs/ja/skills#run-and-verify-your-app)を参照してください |135| `/run` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトのアプリを起動して駆動し、テストに合格するだけでなく、変更が機能しているのを確認します。[アプリを実行して検証する](/docs/ja/skills#run-and-verify-your-app)を参照してください |

136| `/run-skill-generator` | **[Skill](/docs/ja/skills#bundled-skills).** クリーンな環境からプロジェクトのアプリをビルド、起動、駆動する方法を `/run` と `/verify` に教えます。プロジェクトごとの[スキル](/docs/ja/skills#run-and-verify-your-app)を作成します |136| `/run-skill-generator` | **[Skill](/docs/ja/skills#bundled-skills).** クリーンな環境からプロジェクトのアプリをビルド、起動、駆動する方法を `/run` と `/verify` に教え、プロジェクトごとの [skill](/docs/ja/skills#run-and-verify-your-app) を書き込むことで学習します |

138| `/schedule [description]` | クラウドで実行される[ルーチン](/docs/ja/routines)を作成、更新、一覧表示、または実行します。Claude はセットアップを会話的にウォークスルーします。[ルーチンの最近の実行](/docs/ja/routines#manage-routines-from-the-cli)についても質問できます。エイリアス: `/routines` |138| `/schedule [description]` | クラウドで実行される[ルーチン](/docs/ja/routines)を作成、更新、一覧表示、または実行します。Claude はセットアップを会話的にウォークスルーします。[ルーチンの最近の実行](/docs/ja/routines#manage-routines-from-the-cli)について質問することもできます。エイリアス：`/routines` |

139| `/scroll-speed` | マウスホイール[スクロール速度](/docs/ja/fullscreen#mouse-wheel-scrolling)を対話的に調整します。ダイアログが開いている間にスクロールして変更をプレビューできるルーラーを使用します。[全画面レンダリング](/docs/ja/fullscreen)でのみ利用可能で、JetBrains IDE ターミナルでは利用できません |139| `/scroll-speed` | マウスホイール[スクロール速度](/docs/ja/fullscreen#mouse-wheel-scrolling)をインタラクティブに調整し、ダイアログが開いている間にスクロールして変更をプレビューできるルーラーを使用します。[フルスクリーンレンダリング](/docs/ja/fullscreen)でのみ利用可能で、JetBrains IDE ターミナルでは利用できません |

140| `/security-review` | 現在のブランチの変更をセキュリティ脆弱性について分析します。ブランチと origin のデフォルトブランチ間の diff をレビューし、インジェクション、認証の問題、データ公開などのリスクを特定します。`origin` リモートが必要です。レビューが `ambiguous argument` エラーで失敗した場合は、[エラーリファレンス](/docs/ja/errors#security-review-fails-without-origin-head)を参照してください |140| `/security-review` | 現在のブランチの変更をセキュリティ脆弱性について分析します。ブランチと origin のデフォルトブランチ間の diff をレビューし、インジェクション、認証の問題、データ公開などのリスクを特定します。`origin` リモートが必要です。レビューが `ambiguous argument` エラーで失敗した場合、[エラーリファレンス](/docs/ja/errors#security-review-fails-without-origin-head)を参照してください |

141| `/setup-bedrock` | 対話型ウィザードを通じて [Amazon Bedrock](/docs/ja/amazon-bedrock) 認証、リージョン、モデルピンを設定します。`CLAUDE_CODE_USE_BEDROCK=1` が設定されるまで[コマンドメニューから非表示](#how-the-command-menu-matches-what-you-type)。完全に入力してください。初回 Amazon Bedrock ユーザーはログイン画面からこのウィザードにアクセスすることもできます |141| `/setup-bedrock` | インタラクティブなウィザードを通じて [Amazon Bedrock](/docs/ja/amazon-bedrock) 認証、リージョン、モデルピンを設定します。`CLAUDE_CODE_USE_BEDROCK=1` が設定されるまで[コマンドメニューから非表示](#how-the-command-menu-matches-what-you-type)です。完全に入力してください。初回 Amazon Bedrock ユーザーはログイン画面からこのウィザードにアクセスすることもできます |

142| `/setup-vertex` | 対話型ウィザードを通じて [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai) 認証、プロジェクト、リージョン、モデルピンを設定します。`CLAUDE_CODE_USE_VERTEX=1` が設定されるまで[コマンドメニューから非表示](#how-the-command-menu-matches-what-you-type)。完全に入力してください。初回 Google Cloud の Agent Platform ユーザーはログイン画面からこのウィザードにアクセスすることもできます |142| `/setup-vertex` | インタラクティブなウィザードを通じて [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai) 認証、プロジェクト、リージョン、モデルピンを設定します。`CLAUDE_CODE_USE_VERTEX=1` が設定されるまで[コマンドメニューから非表示](#how-the-command-menu-matches-what-you-type)です。完全に入力してください。初回 Google Cloud の Agent Platform ユーザーはログイン画面からこのウィザードにアクセスすることもできます |

143| `/simplify [target]` | **[Skill](/docs/ja/skills#bundled-skills).** 変更されたコードをクリーンアップの機会について確認し、修正を適用します。4 つのレビュー[エージェント](/docs/ja/sub-agents)が並列で実行され、既存のヘルパーの再利用、簡素化、効率、変更が抽象化の正しいレベルにあるかどうかをカバーします。レビューは正確性のバグを探しません。バグを見つけるには `/code-review` を使用してください。パスまたは PR リファレンスを渡して特定のターゲットを確認します |143| `/simplify [target]` | **[Skill](/docs/ja/skills#bundled-skills).** 変更されたコードをクリーンアップの機会についてレビューし、修正を適用します。4 つのレビュー[エージェント](/docs/ja/sub-agents)が並列で実行され、既存のヘルパーの再利用、簡略化、効率、変更が抽象化の正しいレベルにあるかどうかをカバーします。レビューは正確性バグを探しません。バグを見つけるには `/code-review` を使用してください。パスまたは PR リファレンスを渡して特定のターゲットをレビューします |

144| `/skill-doctor` | 各[スキル](/docs/ja/skills)がコンテキストでどのくらいのコストがかかるか、どのくらいの頻度で使用されるかを表示して、[オフにするスキルを見つけ](/docs/ja/skills#find-unused-skills)ます。Claude Code v2.1.252 以降と[フィーチャーフラグ取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)が必要です |144| `/skill-doctor` | 各 [skill](/docs/ja/skills) がコンテキストでコストするもの、および使用頻度を表示して、[オフにするスキルを見つけ](/docs/ja/skills#find-unused-skills)ることができます。Claude Code v2.1.252 以降と[フィーチャーフラグフェッチング](/docs/ja/env-vars#features-that-need-feature-flag-fetching)が必要です |

145| `/skills` | 利用可能な[スキル](/docs/ja/skills)を一覧表示します。名前、説明、またはソースでリストをフィルタリングするには入力します。`t` を押してトークン数でソートし、`Space` または `Enter` を押して[スキルの可視性を Claude と `/` メニューに循環](/docs/ja/skills#override-skill-visibility-from-settings)させ、`Esc` を押して保存して閉じます。プラグインスキル、frontmatter が `disable-model-invocation: true` を設定するスキル、または管理設定の `skillOverrides` エントリまたは `--settings` フラグを持つスキルは循環できません |145| `/skills` | 利用可能な [skills](/docs/ja/skills) を一覧表示します。名前、説明、またはソースでリストをフィルタリングするために入力します。`t` を押してトークンカウントでソートし、`Space` または `Enter` を押して[skill の可視性を Claude と `/` メニューに循環](/docs/ja/skills#override-skill-visibility-from-settings)させ、`Esc` を押して保存して閉じます。プラグインスキル、frontmatter が `disable-model-invocation: true` を設定するスキル、または管理設定または `--settings` フラグに `skillOverrides` エントリがあるスキルは循環できません |

147| `/status` | 設定インターフェイスを Status タブで開き、バージョン、モデル、アカウント、接続性を表示します。`Session kind` 行は[バックグラウンドセッション](/docs/ja/agent-view)で `background job · attached` または `background job · unattended` を読み取り、他のセッションでは `interactive` を読み取ります。v2.1.221 より前は、`/status` はこの行を表示しませんでした。Claude が応答している間に機能します |147| `/status` | 設定インターフェイスを Status タブで開き、バージョン、モデル、アカウント、接続性を表示します。`Session kind` 行は [background session](/docs/ja/agent-view) で `background job · attached` または `background job · unattended` を読み取り、他のセッションでは `interactive` を読み取ります。v2.1.221 より前は、`/status` はこの行を表示しませんでした。Claude が応答している間に機能します |

150| `/stop` | 現在の[バックグラウンドセッション](/docs/ja/agent-view)を停止します。バックグラウンドセッションに接続されている間のみ利用可能です。トランスクリプトと worktree は保持されます。デタッチして停止しないようにするには、`/exit` を使用するか、`←` を押します |150| `/stop` | 現在の[バックグラウンドセッション](/docs/ja/agent-view)を停止します。バックグラウンドセッションにアタッチされている間のみ利用可能です。トランスクリプトと worktree は保持されます。デタッチして停止しない場合は、`/exit` を使用するか、`←` を押します |

151| `/subtask <task>` | [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation)を生成します。完全な会話を継承し、タスクに取り組みながら作業を続けるバックグラウンドサブエージェント。その結果は完了時にこの会話に戻ります。会話を別のバックグラウンドセッションにコピーする代わりに、`/fork` を使用します。Claude Code v2.1.212 以降が必要です。v2.1.161 ～ v2.1.211 では、このコマンドは `/fork` です。[agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっている場合、`/subtask` は利用できず、`/fork` はフォークされたサブエージェント動作を保持します |151| `/subtask <task>` | [forked subagent](/docs/ja/sub-agents#fork-the-current-conversation) を生成します：完全な会話を継承し、タスクに取り組みながら作業を続けるバックグラウンド subagent。その結果は完了時にこの会話に戻ります。会話を別のバックグラウンドセッションにコピーする代わりに、`/fork` を使用します。Claude Code v2.1.212 以降が必要です。v2.1.161 ～ v2.1.211 では、このコマンドは `/fork` です。[agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっている場合、`/subtask` は利用できず、`/fork` は forked-subagent 動作を保持します |

153| `/team-onboarding` | Claude Code 使用履歴からチームオンボーディングガイドを生成します。Claude は過去 30 日間のセッション、コマンド、MCP サーバー使用状況を分析し、チームメイトが最初のメッセージとして貼り付けてすぐにセットアップできるマークダウンガイドを作成します。claude.ai サブスクライバーの Pro、Max、Team、Enterprise プランについては、チームメイトが Claude Code で直接開くことができる共有リンクも返します |153| `/team-onboarding` | Claude Code 使用履歴からチームオンボーディングガイドを生成します。Claude は過去 30 日間のセッション、コマンド、MCP サーバー使用状況を分析し、チームメイトが最初のメッセージとして貼り付けて素早くセットアップできるマークダウンガイドを生成します。claude.ai サブスクライバーの Pro、Max、Team、Enterprise プランの場合、チームメイトが Claude Code で直接開くことができる共有リンクも返します |

154| `/teleport` | [クラウドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)をこのターミナルにプルします。ピッカーを開き、ブランチと会話を取得します。`/tp` としても利用可能です。claude.ai サブスクリプションが必要です |154| `/teleport` | [cloud session](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal) をこのターミナルにプルします。ピッカーを開き、ブランチと会話をフェッチします。`/tp` としても利用可能です。claude.ai サブスクリプションが必要です |

155| `/terminal-setup` | VS Code、Cursor、Devin Desktop、Alacritty、または Zed で[改行用の Shift+Enter キーバインディングをインストール](/docs/ja/terminal-config#enter-multiline-prompts)します。Apple Terminal では、代わりに[改行用に Option+Enter を有効にして、可聴ベルをオフ](/docs/ja/terminal-config#enable-option-key-shortcuts-on-macos)にします。iTerm2 では、[クリップボードアクセスをオンにして `/copy` が機能するようにします](/docs/ja/terminal-config#enable-option-key-shortcuts-on-macos) |155| `/terminal-setup` | VS Code、Cursor、Devin Desktop、Alacritty、または Zed で[改行用の Shift+Enter キーバインディングをインストール](/docs/ja/terminal-config#enter-multiline-prompts)します。Apple Terminal では、代わりに[改行用に Option+Enter を有効にして、可聴ベルをオフ](/docs/ja/terminal-config#enable-option-key-shortcuts-on-macos)にします。iTerm2 では、[`/copy` が機能するようにクリップボードアクセスをオン](/docs/ja/terminal-config#enable-option-key-shortcuts-on-macos)にします |

156| `/theme` | カラーテーマを変更します。ターミナルの明るいまたは暗い背景に一致する `auto` オプション、明るいおよび暗いバリアント、色覚異常対応（ダルトン化）テーマ、ターミナルのカラーパレットを使用する ANSI テーマ、および `~/.claude/themes/` またはプラグインからの[カスタムテーマ](/docs/ja/terminal-config#create-a-custom-theme)を含みます。**New custom theme…** を選択して作成します |156| `/theme` | カラーテーマを変更します。ターミナルの明るいまたは暗い背景に一致する `auto` オプション、明るいおよび暗い変種、色覚異常アクセス可能（daltonized）テーマ、ターミナルのカラーパレットを使用する ANSI テーマ、および `~/.claude/themes/` またはプラグインからの[カスタムテーマ](/docs/ja/terminal-config#create-a-custom-theme)を含みます。**New custom theme…** を選択して 1 つを作成します |

157| `/tui [default\|fullscreen]` | ターミナル UI レンダラーを設定し、会話をそのまま使用して再起動します。`fullscreen` は[ちらつきのない alt-screen レンダラー](/docs/ja/fullscreen)を有効にします。引数がない場合は、アクティブなレンダラーを出力します |157| `/tui [default\|fullscreen]` | ターミナル UI レンダラーを設定し、会話をそのまま使用して再起動します。`fullscreen` は[ちらつきのない alt-screen レンダラー](/docs/ja/fullscreen)を有効にします。引数がない場合、アクティブなレンダラーを出力します |

158| `/ultraplan <prompt>` | 削除されました。代わりに[プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)を使用してください。以前は、計画タスクを[クラウドセッション](/docs/ja/claude-code-on-the-web)に送信して、ブラウザで確認します |158| `/ultraplan <prompt>` | 削除されました。代わりに [plan mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) を使用してください。以前は計画タスクを[クラウドセッション](/docs/ja/claude-code-on-the-web)に送信してブラウザで確認しました |

159| `/ultrareview [PR or branch]` | [ultrareview](/docs/ja/ultrareview) を使用してクラウドサンドボックスで深い、マルチエージェントコードレビューを実行します。PR リファレンスを渡してそのプルリクエストを確認するか、ブランチ名を渡して比較ベースを変更します。推奨される呼び出しは `/code-review ultra` で、`/ultrareview` はエイリアスとして残ります。Pro および Max で 3 つの無料実行を含み、その後[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)が必要です |159| `/ultrareview [PR or branch]` | [ultrareview](/docs/ja/ultrareview) を使用してクラウドサンドボックスでディープなマルチエージェントコードレビューを実行します。PR リファレンスを渡してそのプルリクエストをレビューするか、ベースブランチまたはコミットを渡して比較ベースを変更します。推奨される呼び出しは `/code-review ultra` で、`/ultrareview` はエイリアスです。Pro および Max で 3 つの無料実行が含まれ、その後 [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) が必要です |

160| `/update-config [request]` | **[Skill](/docs/ja/skills#bundled-skills).** コマンドを許可する、環境変数を設定する、[hook](/docs/ja/hooks) を追加するなどの設定変更を説明し、Claude は一致する [`settings.json`](/docs/ja/settings) ファイルを編集します。テーマやモデルなどのオプションについては、代わりに `/config` を使用してください |

161| `/usage` | セッションコスト、プラン使用制限、アクティビティ統計を表示します。Pro、Max、Team、または Enterprise プランでは、[プラン制限に対してカウントされるもの](/docs/ja/costs#plan-usage-breakdown)の内訳を含みます。`/cost` と `/stats` はエイリアスです |162| `/usage` | セッションコスト、プラン使用制限、アクティビティ統計を表示します。Pro、Max、Team、または Enterprise プランでは、[プラン制限に対してカウントされるもの](/docs/ja/costs#plan-usage-breakdown)の内訳が含まれます。`/cost` と `/stats` はエイリアスです |

162| `/usage-credits` | 制限に達したときに使用クレジットを設定するか、管理者に要求します。[使用クレジット請求設定](/docs/ja/costs#add-usage-credits-to-your-subscription)をブラウザで開きます。ただし、Team および Enterprise メンバーで請求アクセス権がない場合は、ダイアログで確認した後、CLI から管理者に使用クレジット要求を送信します。ブラウザが請求ページを開くことができない場合（SSH 経由など）、コマンドは代わりに訪問する URL を出力します。これには Claude Code v2.1.205 以降が必要です。以前のバージョンはその場合に何も表示しませんでした。以前は `/extra-usage` |163| `/usage-credits` | 制限に達したときに使用クレジットを設定するか、管理者に要求します。ブラウザで [usage-credits 請求設定](/docs/ja/costs#add-usage-credits-to-your-subscription)を開きます。ただし、Team および Enterprise メンバーで請求アクセスがない場合は、ダイアログで確認した後、CLI から管理者に usage-credits リクエストを送信します。SSH 経由など、ブラウザが請求ページを開くことができない場合、コマンドは代わりに訪問する URL を出力します。Claude Code v2.1.205 以降が必要です。以前のバージョンはこの場合に何も表示しませんでした。以前は `/extra-usage` |

163| `/verify` | **[Skill](/docs/ja/skills#bundled-skills).** コード変更がテストまたは型チェックに依存するのではなく、プロジェクトのアプリをビルド、実行、観察することで、期待どおりに機能することを確認します。[アプリを実行して検証](/docs/ja/skills#run-and-verify-your-app)を参照してください |164| `/verify` | **[Skill](/docs/ja/skills#bundled-skills).** コード変更がテストまたは型チェックに依存するのではなく、プロジェクトのアプリをビルド、実行、観察することで、何をすべきかを確認します。[アプリを実行して検証する](/docs/ja/skills#run-and-verify-your-app)を参照してください |

164| `/vim` | v2.1.92 で削除されました。Vim と Normal 編集モード間を切り替えるには、`/config` → Editor mode を使用してください |165| `/vim` | v2.1.92 で削除されました。Vim と Normal 編集モード間を切り替えるには、`/config` → Editor mode を使用してください |

165| `/voice [hold\|tap\|off]` | [音声ディクテーション](/docs/ja/voice-dictation)を切り替えるか、特定のモードで有効にします。Claude.ai アカウントが必要です |166| `/voice [hold\|tap\|off]` | [voice dictation](/docs/ja/voice-dictation) を切り替えるか、特定のモードで有効にします。Claude.ai アカウントが必要です |

166| `/web-setup` | ローカル `gh` CLI 認証情報を使用して GitHub アカウントを[クラウドセッション](/docs/ja/web-quickstart#connect-from-your-terminal)に接続します |167| `/web-setup` | ローカル `gh` CLI 認証情報を使用して [cloud sessions](/docs/ja/web-quickstart#connect-from-your-terminal) の GitHub アカウントを接続します |

167| `/workflow-authoring` | **[Skill](/docs/ja/skills#bundled-skills).** [動的ワークフロー](/docs/ja/workflows)スクリプトを作成するためのリファレンスを読み込みます。スクリプト API、再開動作、品質パターン、実装例。Claude は通常、スクリプトを作成する前にそれを自動的に読み込みます。[保存されたスクリプトを手動で編集](/docs/ja/workflows#edit-a-saved-script)する前に自分で実行してください。動的ワークフローが有効な場合に利用可能で、Claude Code v2.1.248 以降が必要です |168| `/workflow-authoring` | **[Skill](/docs/ja/skills#bundled-skills).** [動的ワークフロー](/docs/ja/workflows)スクリプトを書くためのリファレンスを読み込みます：スクリプト API、再開動作、品質パターン、実装例。Claude は通常、スクリプトを書く前にそれを自動的に読み込みます。[保存されたスクリプトを手で編集する](/docs/ja/workflows#edit-a-saved-script)前に自分で実行してください。動的ワークフローが有効な場合に利用可能で、Claude Code v2.1.248 以降が必要です |

169 170

170<h2 id="how-the-command-menu-matches-what-you-type">171<h2 id="how-the-command-menu-matches-what-you-type">

171 コマンドメニューが入力内容にどのようにマッチするか172 コマンドメニューが入力内容にどのようにマッチするか

communications-kit.md +4 −4

Details

105 📚 クイックスタート · VS Code · 無料 1 時間コース105 📚 クイックスタート · VS Code · 無料 1 時間コース

106 https://code.claude.com/docs/ja/quickstart106 https://code.claude.com/docs/ja/quickstart

107 https://code.claude.com/docs/ja/vs-code107 https://code.claude.com/docs/ja/vs-code

108 https://anthropic.skilljar.com/claude-code-in-action108 https://academy.claude.com/courses/claude-code-in-action

109 109

110 質問 → このスレッド。[所有者] が対応しています。110 質問 → このスレッド。[所有者] が対応しています。

111 ```111 ```

227 227

228Claude Code は Claude アプリと同じモデルで実行され、セッション中に切り替えることができます。*Sonnet* は、日常的な機能作業、バグ、テスト、レビューのためのデフォルトの主力です。大規模なリファクタリング、複雑なデバッグ、または高リスクなものに対して *Opus* に手を伸ばしてください。速度が重要な迅速な質問、フォーマット、機械的な編集に対して *Haiku* にドロップしてください。228Claude Code は Claude アプリと同じモデルで実行され、セッション中に切り替えることができます。*Sonnet* は、日常的な機能作業、バグ、テスト、レビューのためのデフォルトの主力です。大規模なリファクタリング、複雑なデバッグ、または高リスクなものに対して *Opus* に手を伸ばしてください。速度が重要な迅速な質問、フォーマット、機械的な編集に対して *Haiku* にドロップしてください。

229 229

230*Fable* は、最も難しく、最も長時間実行されるタスクに対して最も能力の高いモデルです。これはデフォルトではないため、`/model fable` で選択してください。サイバーセキュリティとバイオロジーコンテンツは自動的に Opus にフォールバックすることに注意してください。Opus 5 は独自のチェックを実行するため、フラグが付いたサイバーセキュリティコンテンツはモデルを切り替え、フラグが付いたバイオロジーコンテンツは拒否されます。230*Fable* は、最も難しく、最も長時間実行されるタスクに対して最も能力の高いモデルです。これはデフォルトではないため、`/model fable` で選択してください。サイバーセキュリティとバイオロジーコンテンツは自動的に Opus にフォールバックすることに注意してください。Opus 5.5 と Opus 5 は独自のチェックを実行するため、フラグが付いたコンテンツは以前の Opus に切り替わります。ただし、Opus 5 でフラグが付いたバイオロジーコンテンツは拒否されます。

231 231

232*今すぐ試す：* `/model` を入力し、まだ選択していない場合は Sonnet を選択してください。これはほとんどのタスクの正しいデフォルトです。232*今すぐ試す：* `/model` を入力し、まだ選択していない場合は Sonnet を選択してください。これはほとんどのタスクの正しいデフォルトです。

233 233

235```235```

236 236

237| モデル | 最適な用途 |237| モデル | 最適な用途 |

238| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |238| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |

239| Fable | 最も難しく、最も長時間実行されるタスク。オプトイン専用：`/model fable` で選択してください。サイバーセキュリティまたはバイオロジーコンテンツは [Opus への自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) をトリガーします |239| Fable | 最も難しく、最も長時間実行されるタスク。オプトイン専用：`/model fable` で選択してください。サイバーセキュリティまたはバイオロジーコンテンツは [Opus への自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) をトリガーします |

240| Opus | 大規模なリファクタリング、複雑なデバッグ、アーキテクチャの決定、高リスクな変更。Opus 5 では、サイバーセキュリティまたはバイオロジーコンテンツは [自動モデルフォールバックまたは拒否](/docs/ja/model-config#automatic-model-fallback) をトリガーします |240| Opus | 大規模なリファクタリング、複雑なデバッグ、アーキテクチャの決定、高リスクな変更。Opus 5.5 と Opus 5 では、サイバーセキュリティまたはバイオロジーコンテンツは [自動モデルフォールバックまたは拒否](/docs/ja/model-config#automatic-model-fallback) をトリガーします |

241| Sonnet | 日常的な機能作業、バグ修正、テスト、ドキュメント、コードレビュー。推奨デフォルト。 |241| Sonnet | 日常的な機能作業、バグ修正、テスト、ドキュメント、コードレビュー。推奨デフォルト。 |

242| Haiku | 迅速な質問、フォーマット、機械的な編集、迅速な反復 |242| Haiku | 迅速な質問、フォーマット、機械的な編集、迅速な反復 |

243 243

context-window.md +2 −1

Details

35 tokens: 280,35 tokens: 280,

36 color: '#6B6964',36 color: '#6B6964',

37 vis: 'hidden',37 vis: 'hidden',

~~38 desc: 'Working directory, platform, shell, OS version, and whether this is a git repo. Git branch, status, and recent commits load as a separate block at the very end of the system prompt.',~~38 desc: 'Working directory, platform, shell, OS version, and whether this is a git repo. Git branch, status, and recent commits load as a separate block.',

39 link: null39 link: null

40 }, {40 }, {

41 t: 0.08,41 t: 0.08,

1602| システムプロンプトと出力スタイル | 両方とも引き続き適用されます |1602| システムプロンプトと出力スタイル | 両方とも引き続き適用されます |

1603| プロジェクトルート CLAUDE.md とスコープなしルール | ディスクから再度注入されます |1603| プロジェクトルート CLAUDE.md とスコープなしルール | ディスクから再度注入されます |

1604| 自動メモリ | ディスクから再度注入されます |1604| 自動メモリ | ディスクから再度注入されます |

1605| [Git ステータススナップショット](/docs/ja/settings-reference#includegitinstructions) | Claude Code はリポジトリから新しいものを読み込みます |

1605| [plan mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)で Claude が作成したプラン | ディスクから再度注入されます |1606| [plan mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)で Claude が作成したプラン | ディスクから再度注入されます |

1607| サブディレクトリ内のネストされた CLAUDE.md | Claude Code がそのサブディレクトリ内のファイルを読み込むときに再度読み込みます |1608| サブディレクトリ内のネストされた CLAUDE.md | Claude Code がそのサブディレクトリ内のファイルを読み込むときに再度読み込みます |

costs.md +31 −27

Details

254 トークン使用量を削減する254 トークン使用量を削減する

255</h2>255</h2>

256 256

257トークンコストはコンテキストサイズに応じてスケーリングされます。Claude が処理するコンテキストが多いほど、より多くのトークンを使用します。Claude Code は [プロンプトキャッシング](/docs/ja/prompt-caching)（システムプロンプトなどの繰り返されるコンテンツのコストを削減）と自動コンパクション（コンテキスト制限に近づくと会話履歴を要約）を通じてコストを自動的に最適化します。257トークンコストはコンテキストサイズに応じてスケールします。Claude が処理するコンテキストが大きいほど、より多くのトークンを使用します。Claude Code は [プロンプトキャッシング](/docs/ja/prompt-caching) を通じてコストを自動的に最適化します。プロンプトキャッシングはシステムプロンプトなどの繰り返されるコンテンツのコストを削減し、auto-compact はコンテキスト制限に近づいたときに会話履歴を要約します。

258 258

259以下の戦略は、コンテキストを小さく保ち、メッセージあたりのコストを削減するのに役立ちます。259以下の戦略は、コンテキストを小さく保ち、メッセージあたりのコストを削減するのに役立ちます。

260 260

262 コンテキストを積極的に管理する262 コンテキストを積極的に管理する

263</h3>263</h3>

264 264

265`/usage` を使用して現在のトークン使用量を確認するか、[ステータスラインを設定](/docs/ja/statusline#context-window-usage) してそれを継続的に表示します。265`/usage` を使用して現在のトークン使用量を確認するか、[ステータスラインを設定](/docs/ja/statusline#context-window-usage) して継続的に表示します。

266 266

267* **タスク間でクリアする**: 関連のない作業に切り替える場合は `/clear` を使用して新しく開始します。古いコンテキストは後続のすべてのメッセージでトークンを浪費します。クリアする前に `/rename` を使用してセッションに名前を付けると、後で簡単に見つけることができます。その後、`/resume` を使用して戻ります。267* **タスク間でクリアする**: 関連のない作業に切り替えるときは `/clear` を使用して新しく開始します。古いコンテキストは後続のすべてのメッセージでトークンを無駄にします。クリアする前に `/rename` を使用してセッションに名前を付けると、後で簡単に見つけることができます。その後 `/resume` を使用して復帰します。

268* **カスタムコンパクション指示を追加する**: `/compact Focus on code samples and API usage` は、要約中に保持する内容を Claude に指示します。新しいセッションでは、`/compact` は `Not enough messages to compact.` と出力します。これは、まだ要約する会話履歴がないためです。268* **カスタムコンパクション指示を追加する**: `/compact Focus on code samples and API usage` は、要約中に保持する内容を Claude に指示します。新しいセッションでは、会話履歴がまだないため `/compact` は `Not enough messages to compact.` と出力します。

269 269

270プロジェクトのルートにある CLAUDE.md ファイルでコンパクション動作をカスタマイズすることもできます。270プロジェクトのルートにある CLAUDE.md ファイルでコンパクション動作をカスタマイズすることもできます。

271 271

279 適切なモデルを選択する279 適切なモデルを選択する

280</h3>280</h3>

281 281

282Sonnet はほとんどのコーディングタスクをうまく処理し、Opus よりもコストが低くなります。複雑なアーキテクチャの決定または複数ステップの推論のために Opus を予約します。`/model` を使用してセッション中にモデルを切り替えるか、`/config` でデフォルトを設定します。単純な subagent タスクの場合、[subagent 設定](/docs/ja/sub-agents#choose-a-model) で `model: haiku` を指定します。282Sonnet はほとんどのコーディングタスクをうまく処理でき、Opus よりもコストが低くなります。複雑なアーキテクチャの決定や多段階の推論には Opus を予約します。`/model` を使用してセッション中にモデルを切り替えるか、`/config` でデフォルトを設定します。Opus への切り替えは [セッションのモデルを継承するサブエージェント](/docs/ja/model-config#setting-your-model) にも適用されます。シンプルなサブエージェントタスクの場合は、[サブエージェント設定](/docs/ja/sub-agents#choose-a-model) で `model: haiku` を指定します。

283 283

284<h3 id="reduce-mcp-server-overhead">284<h3 id="reduce-mcp-server-overhead">

285 MCP サーバーのオーバーヘッドを削減する285 MCP サーバーのオーバーヘッドを削減する

287 287

288MCP ツール定義は [デフォルトで遅延](/docs/ja/mcp#scale-with-mcp-tool-search) されるため、Claude が特定のツールを使用するまで、ツール名とサーバー指示のみがコンテキストに入ります。`/context` を実行して、何がスペースを消費しているかを確認します。288MCP ツール定義は [デフォルトで遅延](/docs/ja/mcp#scale-with-mcp-tool-search) されるため、Claude が特定のツールを使用するまで、ツール名とサーバー指示のみがコンテキストに入ります。`/context` を実行して、何がスペースを消費しているかを確認します。

289 289

290* **利用可能な場合は CLI ツールを優先する**: `gh`、`aws`、`gcloud`、`sentry-cli` などのツールは、ツールごとのリストを追加しないため、MCP サーバーよりもコンテキスト効率が高くなります。Claude はオーバーヘッドなしで CLI コマンドを直接実行できます。290* **利用可能な場合は CLI ツールを優先する**: `gh`、`aws`、`gcloud`、`sentry-cli` などのツールは、ツールごとのリストを追加しないため、MCP サーバーよりもコンテキスト効率が高いです。Claude は CLI コマンドを直接実行できます。

291* **未使用のサーバーを無効にする**: `/mcp` を実行して設定されたサーバーを確認し、積極的に使用していないサーバーを無効にします。291* **未使用のサーバーを無効にする**: `/mcp` を実行して設定されたサーバーを確認し、積極的に使用していないサーバーを無効にします。

292 292

293<h3 id="install-code-intelligence-plugins-for-typed-languages">293<h3 id="install-code-intelligence-plugins-for-typed-languages">

294 型付き言語用のコードインテリジェンスプラグインをインストールする294 型付き言語用のコードインテリジェンスプラグインをインストールする

295</h3>295</h3>

296 296

297[コードインテリジェンスプラグイン](/docs/ja/discover-plugins#code-intelligence) は Claude にテキストベースの検索の代わりに正確なシンボルナビゲーションを提供し、不慣れなコードを探索する際の不要なファイル読み取りを削減します。単一の「定義に移動」呼び出しは、grep の後に複数の候補ファイルを読み取る必要があるものを置き換えます。インストールされた言語サーバーは編集後に型エラーを自動的に報告するため、Claude はコンパイラを実行せずにエラーをキャッチします。297[コードインテリジェンスプラグイン](/docs/ja/discover-plugins#code-intelligence) は、Claude にテキストベースの検索の代わりに正確なシンボルナビゲーションを提供し、不慣れなコードを探索するときの不要なファイル読み取りを削減します。単一の「定義に移動」呼び出しは、複数の候補ファイルを読み取る前に grep を実行する必要があったものを置き換えます。インストールされた言語サーバーは、編集後に型エラーを自動的に報告するため、Claude はコンパイラを実行せずにエラーをキャッチします。

298 298

299<h3 id="offload-processing-to-hooks-and-skills">299<h3 id="offload-processing-to-hooks-and-skills">

300 フックとスキルに処理をオフロードする300 hooks と skills に処理をオフロードする

301</h3>301</h3>

302 302

303カスタム [フック](/docs/ja/hooks) は Claude がそれを見る前にデータを前処理できます。Claude が 10,000 行のログファイルを読んでエラーを見つける代わりに、フックは `ERROR` に対して grep を実行し、一致する行のみを返すことができ、コンテキストを数万トークンから数百に削減します。303カスタム [hooks](/docs/ja/hooks) は Claude がそれを見る前にデータを前処理できます。Claude が 10,000 行のログファイルを読んでエラーを見つける代わりに、hook は `ERROR` に対して grep を実行し、一致する行のみを返すことができます。これにより、コンテキストを数万トークンから数百に削減します。

304 304

305[スキル](/docs/ja/skills) は Claude にドメイン知識を与えることができるため、探索する必要がありません。たとえば、「codebase-overview」スキルはプロジェクトのアーキテクチャ、主要なディレクトリ、および命名規則を説明できます。Claude がスキルを呼び出すと、構造を理解するために複数のファイルを読むトークンを費やす代わりに、このコンテキストが即座に取得されます。305[skill](/docs/ja/skills) は Claude にドメイン知識を与えることができるため、探索する必要がありません。たとえば、「codebase-overview」skill はプロジェクトのアーキテクチャ、主要なディレクトリ、命名規則を説明できます。Claude が skill を呼び出すと、構造を理解するために複数のファイルを読むトークンを費やす代わりに、このコンテキストが即座に得られます。

306 306

307たとえば、この PreToolUse フックはテスト出力をフィルタリングして失敗のみを表示します。307たとえば、この PreToolUse hook はテスト出力をフィルタリングして失敗のみを表示します。

308 308

309<Tabs>309<Tabs>

310 <Tab title="settings.json">310 <Tab title="settings.json">

311 これを [settings.json](/docs/ja/settings#where-settings-live) に追加して、すべての Bash コマンドの前にフックを実行します。311 これを [settings.json](/docs/ja/settings#where-settings-live) に追加して、すべての Bash コマンドの前に hook を実行します。

312 312

313 ```json theme={null}313 ```json theme={null}

314 {314 {

330 </Tab>330 </Tab>

331 331

332 <Tab title="filter-test-output.sh">332 <Tab title="filter-test-output.sh">

333 フックはこのスクリプトを呼び出します。`mkdir -p ~/.claude/hooks` でフォルダを作成し、以下のスクリプトを `~/.claude/hooks/filter-test-output.sh` として保存し、`chmod +x ~/.claude/hooks/filter-test-output.sh` で実行可能にします。コマンドがテストランナーであるかどうかを確認し、失敗のみを表示するように変更します。333 hook はこのスクリプトを呼び出します。`mkdir -p ~/.claude/hooks` でフォルダを作成し、以下のスクリプトを `~/.claude/hooks/filter-test-output.sh` として保存し、`chmod +x ~/.claude/hooks/filter-test-output.sh` で実行可能にします。コマンドがテストランナーであるかどうかをチェックし、失敗のみを表示するように変更します。

334 334

335 ```bash theme={null}335 ```bash theme={null}

336 #!/bin/bash336 #!/bin/bash

349 </Tab>349 </Tab>

350</Tabs>350</Tabs>

351 351

352セットアップを確認するには、`/hooks` を実行して、フックが PreToolUse の下に表示されることを確認します。また、`claude --debug-file ./claude-debug.txt` で Claude Code を起動し、Claude に `npm test` を実行するよう依頼することもできます。フックがコマンドを書き直すと、そのログファイルには `command` と他の Bash 入力フィールドをリストする `modified tool input keys` 行が含まれます。352セットアップを確認するには、`/hooks` を実行して、hook が PreToolUse の下に表示されることを確認します。`claude --debug-file ./claude-debug.txt` で Claude Code を起動し、Claude に `npm test` を実行するよう依頼することもできます。hook がコマンドを書き直すと、そのログファイルには `command` と他の Bash 入力フィールドをリストする `modified tool input keys` 行が含まれます。

353 353

354<h3 id="move-instructions-from-claude-md-to-skills">354<h3 id="move-instructions-from-claude-md-to-skills">

355 CLAUDE.md からスキルに指示を移動する355 CLAUDE.md から skills に指示を移動する

356</h3>356</h3>

357 357

358[CLAUDE.md](/docs/ja/memory) ファイルはセッション開始時にコンテキストに読み込まれます。PR レビューやデータベース移行などの特定のワークフロー用の詳細な指示が含まれている場合、関連のない作業を行っている場合でもそれらのトークンが存在します。[スキル](/docs/ja/skills) はオンデマンドでのみ呼び出されたときに読み込まれるため、特殊な指示をスキルに移動することで、ベースコンテキストを小さく保ちます。CLAUDE.md を 200 行以下に保つことを目指し、必須のみを含めます。358[CLAUDE.md](/docs/ja/memory) ファイルはセッション開始時にコンテキストに読み込まれます。PR レビューやデータベースマイグレーションなどの特定のワークフロー用の詳細な指示が含まれている場合、関連のない作業を行っているときでもそれらのトークンが存在します。[Skills](/docs/ja/skills) はオンデマンドでのみ呼び出されたときに読み込まれるため、特殊な指示を skills に移動することで、ベースコンテキストを小さく保ちます。必須項目のみを含めることで、CLAUDE.md を 200 行以下に保つことを目指します。

359 359

360<h3 id="adjust-extended-thinking">360<h3 id="adjust-extended-thinking">

361 拡張思考を調整する361 拡張思考を調整する

362</h3>362</h3>

363 363

364拡張思考はデフォルトで有効になっています。これは複雑な計画と推論タスクのパフォーマンスを大幅に向上させるためです。思考トークンは出力トークンとして課金され、デフォルト予算はモデルに応じて数万トークンになる場合があります。深い推論が必要ない単純なタスクの場合、`/effort` または `/model` で [努力レベル](/docs/ja/model-config#adjust-effort-level) を低下させるか、`/config` で思考を無効にすることでコストを削減できます。Fable モデルは常に拡張思考を使用するため、思考をオフにすることはできません。[固定思考予算](/docs/ja/model-config#adaptive-reasoning-and-fixed-thinking-budgets) を持つモデルでは、`MAX_THINKING_TOKENS=8000` などの `MAX_THINKING_TOKENS` [環境変数](/docs/ja/env-vars) を設定して予算を低下させることもできます。適応推論モデルはゼロ以外の予算を無視するため、代わりに努力レベルを使用します。364拡張思考はデフォルトで有効になっています。複雑な計画と推論タスクのパフォーマンスを大幅に向上させるためです。思考トークンは出力トークンとして課金され、デフォルトの予算はモデルに応じてリクエストあたり数万トークンになる可能性があります。

365

366深い推論が不要なシンプルなタスクの場合は、`/effort` または `/model` で [努力レベル](/docs/ja/model-config#adjust-effort-level) を下げるか、`/config` で思考を無効にすることでコストを削減できます。Opus 5.5 または Fable モデルでは思考をオフにすることはできません。これらは常に拡張思考を使用します。

367

368[固定思考予算](/docs/ja/model-config#adaptive-reasoning-and-fixed-thinking-budgets) を持つモデルでは、`MAX_THINKING_TOKENS` [環境変数](/docs/ja/env-vars) を設定することで予算を下げることもできます。たとえば `MAX_THINKING_TOKENS=8000` です。適応推論モデルはゼロ以外の予算を無視するため、代わりに努力レベルを使用します。

365 369

366<h3 id="delegate-verbose-operations-to-subagents">370<h3 id="delegate-verbose-operations-to-subagents">

367 詳細な操作を subagent に委任する371 冗長な操作をサブエージェントに委譲する

368</h3>372</h3>

369 373

370テストの実行、ドキュメントの取得、またはログファイルの処理は、かなりのコンテキストを消費できます。これらを [subagent](/docs/ja/sub-agents#isolate-high-volume-operations) に委任して、詳細な出力が subagent のコンテキストに留まり、メインの会話に戻るのはサマリーのみです。374テストの実行、ドキュメントの取得、またはログファイルの処理は、かなりのコンテキストを消費する可能性があります。これらを [サブエージェント](/docs/ja/sub-agents#isolate-high-volume-operations) に委譲して、冗長な出力がサブエージェントのコンテキストに留まり、要約のみがメインの会話に返されるようにします。

371 375

372<h3 id="manage-agent-team-costs">376<h3 id="manage-agent-team-costs">

373 エージェントチームのコストを管理する377 エージェントチームのコストを管理する

374</h3>378</h3>

375 379

376エージェントチームは、チームメイトがプランモードで実行される場合、標準セッションよりも約 7 倍多くのトークンを使用します。これは、各チームメイトが独自のコンテキストウィンドウを維持し、別の Claude インスタンスとして実行されるためです。チームメイトあたりのトークン使用量を制限するために、チームタスクを小さく自己完結させておきます。詳細については、[エージェントチーム](/docs/ja/agent-teams) を参照してください。380エージェントチームは、チームメイトが plan mode で実行されるときに標準セッションよりも約 7 倍多くのトークンを使用します。各チームメイトが独自のコンテキストウィンドウを維持し、別の Claude インスタンスとして実行されるためです。チームタスクを小さく自己完結させて、チームメイトあたりのトークン使用量を制限します。詳細は [エージェントチーム](/docs/ja/agent-teams) を参照してください。

377 381

378<h3 id="write-specific-prompts">382<h3 id="write-specific-prompts">

379 具体的なプロンプトを作成する383 具体的なプロンプトを作成する

380</h3>384</h3>

381 385

382「このコードベースを改善する」のような曖昧なリクエストは、広範なスキャンをトリガーします。「auth.ts のログイン関数に入力検証を追加する」のような具体的なリクエストにより、Claude は最小限のファイル読み取りで効率的に作業できます。386「このコードベースを改善する」のような曖昧なリクエストは広範なスキャンをトリガーします。「auth.ts のログイン関数に入力検証を追加する」のような具体的なリクエストは、Claude が最小限のファイル読み取りで効率的に作業できるようにします。

383 387

384<h3 id="work-efficiently-on-complex-tasks">388<h3 id="work-efficiently-on-complex-tasks">

385 複雑なタスクで効率的に作業する389 複雑なタスクで効率的に作業する

386</h3>390</h3>

387 391

388より長いまたはより複雑な作業の場合、これらの習慣は間違った方向に進むことからの無駄なトークンを回避するのに役立ちます。392より長いまたはより複雑な作業の場合、これらの習慣は間違った方向に進むことからのトークン浪費を回避するのに役立ちます。

389 393

390* **複雑なタスクにはプランモードを使用する**: Shift+Tab を押して、実装の前に [プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) に入ります。Claude はコードベースを探索し、承認のためのアプローチを提案し、初期方向が間違っている場合の高価な再作業を防ぎます。394* **複雑なタスクに plan mode を使用する**: Shift+Tab を押して実装前に [plan mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) に切り替えます。Claude はコードベースを探索し、承認のためのアプローチを提案し、初期の方向が間違っている場合の高額な再作業を防ぎます。

391* **早期に方向を修正する**: Claude が間違った方向に向かい始めた場合は、Escape を押して直ちに停止します。`/rewind` を使用するか、Escape をダブルタップして、会話とコードを前のチェックポイントに復元します。395* **早期に方向を修正する**: Claude が間違った方向に向かい始めたら、Escape を押してすぐに停止します。`/rewind` を使用するか、Escape をダブルタップして、会話とコードを以前のチェックポイントに復元します。

392* **検証ターゲットを指定する**: テストケースを含めるか、スクリーンショットを貼り付けるか、プロンプトで予想される出力を定義します。Claude が独自の作業を検証できる場合、修正をリクエストする必要がある前に問題をキャッチします。396* **検証ターゲットを指定する**: テストケースを含める、スクリーンショットを貼り付ける、またはプロンプトで予想される出力を定義します。Claude が独自の作業を検証できる場合、修正をリクエストする必要がある前に問題をキャッチします。

393* **段階的にテストする**: 1 つのファイルを作成し、テストしてから続行します。これは、修正が安い場合に早期に問題をキャッチします。397* **段階的にテストする**: 1 つのファイルを作成し、テストしてから続行します。これにより、修正が安価なときに早期に問題をキャッチします。

394 398

395<h2 id="background-token-usage">399<h2 id="background-token-usage">

396 バックグラウンドトークン使用量400 バックグラウンドトークン使用量

desktop.md +2 −2

Details

508 508

509プラグインはユーザーアカウント、特定のプロジェクト、またはローカルのみにスコープできます。組織がプラグインを一元管理する場合、それらのプラグインは CLI と同じ方法で Desktop セッションで利用可能です。509プラグインはユーザーアカウント、特定のプロジェクト、またはローカルのみにスコープできます。組織がプラグインを一元管理する場合、それらのプラグインは CLI と同じ方法で Desktop セッションで利用可能です。

510 510

511プラグインブラウザはクラウドセッションでは利用できず、デスクトップアプリからインストールしたプラグインはクラウドセッションでは利用できません。クラウドセッションでプラグインを使用するには、リポジトリの `.claude/settings.json` の [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) で宣言して Claude Code が [セッション開始時にインストール](/docs/ja/cloud-environments#what-carries-over-from-your-setup)するか、claude.ai アカウント用に有効化して Claude Code が [同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins)としてロードするようにします。プラグインは WSL セッションでは利用できません。プラグインの作成を含む完全なプラグインリファレンスについては、[プラグイン](/docs/ja/plugins)を参照してください。511プラグインブラウザはクラウドセッションでは利用できず、デスクトップアプリからインストールしたプラグインはクラウドセッションでは利用できません。クラウドセッションでプラグインを使用するには、リポジトリの `.claude/settings.json` で宣言して Claude Code が [セッション開始時にインストール](/docs/ja/cloud-environments#what-carries-over-from-your-setup)するか、claude.ai アカウント用に有効化して Claude Code が [同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins)としてロードするようにします。プラグインは WSL セッションでは利用できません。プラグインの作成を含む完全なプラグインリファレンスについては、[プラグイン](/docs/ja/plugins)を参照してください。

512 512

513<h3 id="configure-preview-servers">513<h3 id="configure-preview-servers">

514 プレビューサーバーを設定する514 プレビューサーバーを設定する

735 735

736ローカルセッションと dev サーバーの環境変数を設定するには、プロンプトボックスの環境ドロップダウンを開き、**Local** にマウスを合わせて、ギアアイコンをクリックしてローカル環境エディタを開きます。ここで保存する変数は、マシンに暗号化されて保存され、開始するすべてのローカルセッションとプレビューサーバーに適用されます。また、`~/.claude/settings.json` ファイルの `env` キーに変数を追加することもできます。ただし、これらは Claude セッションにのみ到達し、dev サーバーには到達しません。サポートされている変数の完全なリストについては、[環境変数](/docs/ja/env-vars)を参照してください。736ローカルセッションと dev サーバーの環境変数を設定するには、プロンプトボックスの環境ドロップダウンを開き、**Local** にマウスを合わせて、ギアアイコンをクリックしてローカル環境エディタを開きます。ここで保存する変数は、マシンに暗号化されて保存され、開始するすべてのローカルセッションとプレビューサーバーに適用されます。また、`~/.claude/settings.json` ファイルの `env` キーに変数を追加することもできます。ただし、これらは Claude セッションにのみ到達し、dev サーバーには到達しません。サポートされている変数の完全なリストについては、[環境変数](/docs/ja/env-vars)を参照してください。

737 737

738[拡張思考](/docs/ja/model-config#extended-thinking)はデフォルトで有効になっており、複雑な推論タスクのパフォーマンスを向上させますが、追加のトークンを使用します。Anthropic API では、ローカル環境エディタで `MAX_THINKING_TOKENS` を `0` に設定して思考をオフにします。これは Fable モデルには効果がなく、常に拡張思考を使用します。Anthropic API で思考をオフにした場合、Claude Code は、Opus 5 などの[その組み合わせを受け入れない](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off)ことが分かっているモデルに、より高いレベルではなく effort `high` を送信します。738[拡張思考](/docs/ja/model-config#extended-thinking)はデフォルトで有効になっており、複雑な推論タスクのパフォーマンスを向上させますが、追加のトークンを使用します。Anthropic API では、ローカル環境エディタで `MAX_THINKING_TOKENS` を `0` に設定して思考をオフにします。これは Opus 5.5 または Fable モデルには効果がなく、常に拡張思考を使用します。Anthropic API で思考をオフにした場合、Claude Code は、Opus 5 などの[その組み合わせを受け入れない](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off)ことが分かっているモデルに、より高いレベルではなく effort `high` を送信します。

739 739

740[適応的推論](/docs/ja/model-config#adjust-effort-level)を持つモデルでは、適応的推論が思考の深さを制御するため、`0` 以外の `MAX_THINKING_TOKENS` 値は無視されます。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を `1` に設定します。Fable モデル、Sonnet 5、および Opus 4.7 以降は常に適応的推論を使用し、固定予算モードはありません。740[適応的推論](/docs/ja/model-config#adjust-effort-level)を持つモデルでは、適応的推論が思考の深さを制御するため、`0` 以外の `MAX_THINKING_TOKENS` 値は無視されます。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を `1` に設定します。Fable モデル、Sonnet 5、および Opus 4.7 以降は常に適応的推論を使用し、固定予算モードはありません。

741 741

desktop-linux.md +1 −1

Details

16 要件16 要件

17</h2>17</h2>

18 18

~~19* Ubuntu 22.04 以降、または Debian 12 以降~~19* Debian ベースのディストリビューション：Ubuntu 22.04 以降、または Debian 12 以降

20* x86\_64 または arm6420* x86\_64 または arm64

21 21

22これらの要件を満たす他の Debian ベースのディストリビューションは動作する可能性がありますが、公式にはテストされていません。Fedora や Arch などの Debian ベース以外のディストリビューションでは、代わりに [CLI](/docs/ja/setup#system-requirements) を実行してください。Windows で WSL 2 を使用している場合は、Windows デスクトップアプリをインストールし、ディストリビューション内でセッションを実行してください。[Claude Code Desktop in WSL](/docs/ja/desktop-wsl) を参照してください。22これらの要件を満たす他の Debian ベースのディストリビューションは動作する可能性がありますが、公式にはテストされていません。Fedora や Arch などの Debian ベース以外のディストリビューションでは、代わりに [CLI](/docs/ja/setup#system-requirements) を実行してください。Windows で WSL 2 を使用している場合は、Windows デスクトップアプリをインストールし、ディストリビューション内でセッションを実行してください。[Claude Code Desktop in WSL](/docs/ja/desktop-wsl) を参照してください。

discover-plugins.md +7 −3

Details

42/plugin install github@claude-plugins-official42/plugin install github@claude-plugins-official

43```43```

44 44

45`/plugin` はターミナル CLI で対話的なパネルを開きます。Claude が `/plugin` がこの環境では利用できないと返答する場合は、Claude デスクトップアプリの[プラグインブラウザー](/docs/ja/desktop#install-plugins)を使用するか、クラウドセッションの `.claude/settings.json` で [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) の下にプラグインを宣言してください。45`/plugin` はターミナル CLI で対話的なパネルを開きます。Claude が `/plugin` がこの環境では利用できないと返答する場合は、別の方法でプラグインをインストールしてください：

47* **Claude デスクトップアプリ**：[プラグインブラウザー](/docs/ja/desktop#install-plugins)を使用してください。

48* **VS Code 拡張機能**：[**Manage plugins** ダイアログ](/docs/ja/vs-code#manage-plugins)からインストールしてください。

49* **クラウドセッション**：claude.ai アカウントのプラグインを有効にして、Claude Code が[同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins)として読み込むようにしてください。

46 50

47インストールが失敗した場合は、Claude Code が報告するメッセージと照合してください：51インストールが失敗した場合は、Claude Code が報告するメッセージと照合してください：

48 52

360Claude Code はローカルマーケットプレイスカタログのコピーでプラグインを検索します。プラグインの名前の付け方によって、Claude Code がそのコピーを最初に更新するかどうかが決まります：364Claude Code はローカルマーケットプレイスカタログのコピーでプラグインを検索します。プラグインの名前の付け方によって、Claude Code がそのコピーを最初に更新するかどうかが決まります：

361 365

362* **マーケットプレイス名を含む場合**: セッションで `plugin-name@marketplace-name` をインストールするか、`claude plugin install` で実行すると、Claude Code はルックアップの前にそのマーケットプレイスを更新します。Claude Code は、マーケットプレイスの[自動更新](#configure-auto-updates)をオフにしたか、`DISABLE_AUTOUPDATER` を設定した場合でも、更新を実行します。v2.1.232 より前では、Claude Code はルックアップの前にマーケットプレイスを更新しませんでした。Claude Code は以下の場合、この更新をスキップします：366* **マーケットプレイス名を含む場合**: セッションで `plugin-name@marketplace-name` をインストールするか、`claude plugin install` で実行すると、Claude Code はルックアップの前にそのマーケットプレイスを更新します。Claude Code は、マーケットプレイスの[自動更新](#configure-auto-updates)をオフにしたか、`DISABLE_AUTOUPDATER` を設定した場合でも、更新を実行します。v2.1.232 より前では、Claude Code はルックアップの前にマーケットプレイスを更新しませんでした。Claude Code は以下の場合、この更新をスキップします：

363 * マーケットプレイスが[GitHub、別の Git ホスト、またはリモート URL から追加](#add-marketplaces)されていない。367 * マーケットプレイスが[GitHub、別の Git ホスト、リモート URL から追加](#add-marketplaces)されていない、または[Claude.ai から追加](#add-from-claude-ai)されていない。

364 * [シードディレクトリ](/docs/ja/plugin-marketplaces#pre-populate-plugins-for-containers)がマーケットプレイスを提供している。368 * [シードディレクトリ](/docs/ja/plugin-marketplaces#pre-populate-plugins-for-containers)がマーケットプレイスを提供している。

365 * Claude Code が過去 30 秒以内にマーケットプレイスを更新した。369 * Claude Code が過去 30 秒以内にマーケットプレイスを更新した。

366 * [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars)を設定した。370 * [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars)を設定した。

395 399

396ソースは[`/plugin marketplace add`](#add-marketplaces)と同じ形式を取ります。例えば、GitHub の `owner/repo`、git URL、またはローカルパスなど。ただし、スペースを含むことはできません。プラグイン名は `@marketplace` サフィックスなしで指定します。400ソースは[`/plugin marketplace add`](#add-marketplaces)と同じ形式を取ります。例えば、GitHub の `owner/repo`、git URL、またはローカルパスなど。ただし、スペースを含むことはできません。プラグイン名は `@marketplace` サフィックスなしで指定します。

397 401

398そのマーケットプレイスをまだ追加していない場合、Claude Code は解決されたソースを表示し、追加する前に確認を求めます。キャンセルするとインストールがキャンセルされ、何も追加されません。マーケットプレイスが追加されると、プラグインの詳細が開き、[インストールスコープ](/docs/ja/settings#where-settings-live)を選択できます。402Claude Code はソースが解決されたことを表示し、マーケットプレイスを追加する前に確認を求めます。キャンセルするとインストールがキャンセルされ、何も追加されません。マーケットプレイスが追加されると、プラグインの詳細が開き、[インストールスコープ](/docs/ja/settings#where-settings-live)を選択できます。ソースが既に追加したマーケットプレイスと一致する場合、Claude Code は確認をスキップし、そのマーケットプレイスでプラグインの詳細を開きます。

399 403

400<h2 id="manage-installed-plugins">404<h2 id="manage-installed-plugins">

401 インストール済みプラグインを管理する405 インストール済みプラグインを管理する

env-vars.md +301 −297

Details

124 変数124 変数

125</h2>125</h2>

126 126

127タイムアウト、トークン予算、再試行回数などの数値変数は、変数の行で「プレーンな数字のみ」と記載されている場合を除き、科学記法と数字区切り文字の表記に加えてプレーンな数字を受け入れます。例えば、Claude Code は `2e3` を 2000 として、`64_000` を 64000 として読み込みます。v2.1.211 より前は、これらの表記により、`1e6` がタイムアウトを 1 に設定するなど、はるかに小さい値が静かに設定される可能性がありました。127タイムアウト、トークン予算、再試行回数などの数値変数は、変数の行に「プレーンな数字のみ」と記載されている場合を除き、プレーンな数字に加えて科学記法と数字区切り文字を受け入れます。例えば、Claude Code は `2e3` を 2000 として、`64_000` を 64000 として読み込みます。v2.1.211 より前は、これらの表記法により、`1e6` がタイムアウトを 1 に設定するなど、はるかに小さい値が静かに設定される可能性がありました。

128 128

129<Note>129<Note>

130 動作をオン/オフにする変数の場合、`1` または `true` を設定してオンにし、`0` または `false` を設定してオフにします。大文字小文字は問いません。130 動作をオン/オフにする変数の場合、`1` または `true` を設定してオンにし、`0` または `false` を設定してオフにします。大文字小文字は問いません。

131 131

132 一部の変数は、設定されているかどうかのみを読み取るため、`0` を含む空でない値はその動作をオンにし、変数を設定解除するか空の値に設定することで動作をオフにします。これらの変数はそのように機能します：132 一部の変数は、設定されているかどうかのみを読み取るため、`0` を含む空でない値を設定すると動作がオンになり、変数を設定解除するか空の値に設定することで動作がオフになります。これらの変数は次のように機能します：

133 133

134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`134 * `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`

135 * `DISABLE_TELEMETRY`135 * `DISABLE_TELEMETRY`

141 別の変数には独自のルールがあります：`FORCE_HYPERLINK` は数値を読み取るため、`0` のみがオフになります。各変数の行には、その独自のルールも記載されています。141 別の変数には独自のルールがあります：`FORCE_HYPERLINK` は数値を読み取るため、`0` のみがオフになります。各変数の行には、その独自のルールも記載されています。

142</Note>142</Note>

143 143

144| Variable | Purpose |144| 変数 | 目的 |

145| :------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |145| :------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

146| `ANTHROPIC_API_KEY` | `X-Api-Key` ヘッダーとして送信される API キー。設定されている場合、ログインしていても、このキーは Claude Pro、Max、Team、または Enterprise サブスクリプションの代わりに使用されます。非対話モード（`-p`）では、キーが存在する場合は常に使用されます。対話モードでは、キーがサブスクリプションをオーバーライドする前に、一度承認するよう求められます。代わりにサブスクリプションを使用するには、`unset ANTHROPIC_API_KEY` を実行します |146| `ANTHROPIC_API_KEY` | `X-Api-Key` ヘッダーとして送信される API キー。設定されている場合、ログインしていても、このキーが Claude Pro、Max、Team、または Enterprise サブスクリプションの代わりに使用されます。非対話モード（`-p`）では、キーが存在する場合は常に使用されます。対話モードでは、キーがサブスクリプションをオーバーライドする前に、一度承認するよう求められます。代わりにサブスクリプションを使用するには、`unset ANTHROPIC_API_KEY` を実行してください |

148| `ANTHROPIC_AWS_API_KEY` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のワークスペース API キー。AWS コンソールで生成されます。`x-api-key` として送信され、AWS SigV4 より優先されます |148| `ANTHROPIC_AWS_API_KEY` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のワークスペース API キー。AWS コンソールで生成されます。`x-api-key` として送信され、AWS SigV4 より優先されます |

149| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) エンドポイント URL をオーバーライドします。カスタムリージョンの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。デフォルトは `https://aws-external-anthropic.{region}.api.aws` です。Claude Code は [Amazon Bedrock と同じ優先順位でリージョンを解決します](/docs/ja/amazon-bedrock#3-configure-claude-code) |149| `ANTHROPIC_AWS_BASE_URL` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) エンドポイント URL をオーバーライドします。カスタムリージョンの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。デフォルトは `https://aws-external-anthropic.{region}.api.aws` です。Claude Code は [Amazon Bedrock と同じ優先順位でリージョンを解決します](/docs/ja/amazon-bedrock#3-configure-claude-code) |

150| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) に必須です。すべてのリクエストで `anthropic-workspace-id` ヘッダーとして送信されます |150| `ANTHROPIC_AWS_WORKSPACE_ID` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) に必須です。すべてのリクエストで `anthropic-workspace-id` ヘッダーとして送信されます |

151| `ANTHROPIC_BASE_URL` | API エンドポイントをオーバーライドして、プロキシまたはゲートウェイを通じてリクエストをルーティングします。非ファーストパーティホストに設定されている場合、[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) はデフォルトで無効になります。プロキシが `tool_reference` ブロックを転送する場合は、`ENABLE_TOOL_SEARCH=true` を設定します。v2.1.196 以降、[リモートコントロール](/docs/ja/remote-control#requirements) は、これが `api.anthropic.com` 以外のホストを指している場合は無効になり、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry での動作と一致します |151| `ANTHROPIC_BASE_URL` | API エンドポイントをオーバーライドして、プロキシまたはゲートウェイを通じてリクエストをルーティングします。ファーストパーティ以外のホストに設定されている場合、[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) はデフォルトで無効になります。プロキシが `tool_reference` ブロックを転送する場合は、`ENABLE_TOOL_SEARCH=true` を設定してください。v2.1.196 以降、[Remote Control](/docs/ja/remote-control#requirements) は、これが `api.anthropic.com` 以外のホストを指している場合は無効になります。これは Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry での動作と一致します |

152| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock エンドポイント URL をオーバーライドします。カスタム Amazon Bedrock エンドポイントの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。[Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください |152| `ANTHROPIC_BEDROCK_BASE_URL` | Amazon Bedrock エンドポイント URL をオーバーライドします。カスタム Amazon Bedrock エンドポイントの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。[Amazon Bedrock](/docs/ja/amazon-bedrock) を参照してください |

153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle エンドポイント URL をオーバーライドします。[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint) を参照してください |153| `ANTHROPIC_BEDROCK_MANTLE_BASE_URL` | Amazon Bedrock Mantle エンドポイント URL をオーバーライドします。[Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint) を参照してください |

154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | クロスリージョン推論プロファイルプレフィックス（`us`、`eu`、`apac`、`jp`、`au`、または `global`）Claude Code が AWS リージョンから派生したものの代わりに最初に試します。AWS GovCloud リージョンでは無視されます。Claude Code v2.1.224 以降が必要です。[Amazon Bedrock](/docs/ja/amazon-bedrock#cross-region-inference-profile-prefixes) を参照してください |154| `ANTHROPIC_BEDROCK_REGION_PREFIX` | クロスリージョン推論プロファイルプレフィックス（`us`、`eu`、`apac`、`jp`、`au`、または `global`）Claude Code が AWS リージョンから派生したものの代わりに最初に試します。AWS GovCloud リージョンでは無視されます。Claude Code v2.1.224 以降が必要です。[Amazon Bedrock](/docs/ja/amazon-bedrock#cross-region-inference-profile-prefixes) を参照してください |

155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [サービスティア](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)（`default`、`flex`、または `priority`）。`X-Amzn-Bedrock-Service-Tier` ヘッダーとして送信されます。[Amazon Bedrock](/docs/ja/amazon-bedrock#service-tiers) を参照してください |155| `ANTHROPIC_BEDROCK_SERVICE_TIER` | Amazon Bedrock [サービスティア](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)（`default`、`flex`、または `priority`）。`X-Amzn-Bedrock-Service-Tier` ヘッダーとして送信されます。[Amazon Bedrock](/docs/ja/amazon-bedrock#service-tiers) を参照してください |

156| `ANTHROPIC_BETAS` | API リクエストに含める追加の `anthropic-beta` ヘッダー値のカンマ区切りリスト。Claude Code は既に必要なベータヘッダーを送信します。Claude Code がネイティブサポートを追加する前に、[Anthropic API ベータ](https://platform.claude.com/docs/en/api/beta-headers) にオプトインするために使用します。[`--betas` フラグ](/docs/ja/cli-reference#cli-flags) とは異なり、API キー認証が必要ですが、この変数は Claude.ai サブスクリプションを含むすべての認証方法で機能します |156| `ANTHROPIC_BETAS` | API リクエストに含める追加の `anthropic-beta` ヘッダー値のカンマ区切りリスト。Claude Code は既に必要なベータヘッダーを送信します。Claude Code がネイティブサポートを追加する前に、[Anthropic API ベータ](https://platform.claude.com/docs/en/api/beta-headers) にオプトインするために使用します。[`--betas` フラグ](/docs/ja/cli-reference#cli-flags) とは異なり、API キー認証が必要ですが、この変数は Claude.ai サブスクリプションを含むすべての認証方法で機能します |

157| `ANTHROPIC_CUSTOM_HEADERS` | リクエストに追加するカスタムヘッダー（`Name: Value` 形式、複数ヘッダーの場合は改行区切り）。名前または値に HTTP ヘッダーが処理できない文字（カーリークォートやゼロ幅スペースなど）が含まれている場合、リクエストは位置で対を識別するエラーで失敗します。Claude Code v2.1.227 以降が必要です。[無効なリクエストヘッダー値](/docs/ja/errors#invalid-request-header-value) は正確な文字セットとチェックが実行される場所をリストしています。認証情報、組織またはテナント、ルーティング、または API 動作ヘッダー（`Authorization` や `Host` など）を設定する値は、サーバー管理設定がそれを配信する場合、[承認が必要な設定](/docs/ja/server-managed-settings#environment-variables-and-the-approval-dialog) としてカウントされます。プロジェクトまたはローカル設定からは、そのような値は [`env` 値が適用される場合のルール](/docs/ja/settings-reference#when-claude-code-applies-env-values) に従います |157| `ANTHROPIC_CUSTOM_HEADERS` | リクエストに追加するカスタムヘッダー（`Name: Value` 形式、複数ヘッダーの場合は改行区切り）。名前または値に HTTP ヘッダーが処理できない文字（カーリークォートやゼロ幅スペースなど）が含まれている場合、リクエストは位置で識別されるペアを示すエラーで失敗します。Claude Code v2.1.227 以降が必要です。[無効なリクエストヘッダー値](/docs/ja/errors#invalid-request-header-value) は正確な文字セットとチェックが実行される場所をリストしています。`Authorization` や `Host` などの認証情報、組織またはテナント、ルーティング、または API 動作ヘッダーを設定する値は、サーバー管理設定がそれを配信する場合、[承認が必要な設定](/docs/ja/server-managed-settings#environment-variables-and-the-approval-dialog) としてカウントされます。プロジェクトまたはローカル設定からは、そのような値は [`env` 値が適用される場合のルール](/docs/ja/settings-reference#when-claude-code-applies-env-values) に従います |

158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` ピッカーにカスタムエントリとして追加するモデル ID。組み込みエイリアスを置き換えることなく、非標準またはゲートウェイ固有のモデルを選択可能にするために使用します。[モデル設定](/docs/ja/model-config#add-a-custom-model-option) を参照してください |158| `ANTHROPIC_CUSTOM_MODEL_OPTION` | `/model` ピッカーにカスタムエントリとして追加するモデル ID。組み込みエイリアスを置き換えることなく、非標準またはゲートウェイ固有のモデルを選択可能にするために使用します。[モデル設定](/docs/ja/model-config#add-a-custom-model-option) を参照してください |

159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` ピッカーのカスタムモデルエントリの表示説明。設定されていない場合、デフォルトは `Custom model (<model-id>)` です |159| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` ピッカーのカスタムモデルエントリの表示説明。設定されていない場合、デフォルトは `Custom model (<model-id>)` です |

160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` ピッカーのカスタムモデルエントリの表示名。設定されていない場合、Claude Code が [ID を認識する](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) 場合はモデルの名前を表示し、そうでない場合はモデル ID を表示します |160| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` ピッカーのカスタムモデルエントリの表示名。設定されていない場合、Claude Code が [ID を認識する](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) 場合はエントリにモデルの名前が表示され、そうでない場合はモデル ID が表示されます |

161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | カスタムモデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |161| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | カスタムモデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` エイリアスが解決するモデル ID、および Claude Code がサードパーティプロバイダーで [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) のために Fable モデルとして認識する ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |162| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` エイリアスが解決するモデル ID、および Claude Code が Fable モデルとして認識するモデル ID。サードパーティプロバイダーでの [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) の場合。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |

163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Fable モデルの表示説明。設定されていない場合、行は `Custom Fable model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |163| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Fable モデルの表示説明。設定されていない場合、行は `Custom Fable model` で始まるデフォルトの説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` ピッカーのピン留めされた Fable モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |164| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | `/model` ピッカーのピン留めされた Fable モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合は行にモデルの名前が表示され、そうでない場合はピン留めされた ID が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Fable モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |165| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Fable モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` エイリアスが解決するモデル ID。[バックグラウンド機能](/docs/ja/costs#background-token-usage) にも使用されます。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |166| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` エイリアスが解決するモデル ID。[バックグラウンド機能](/docs/ja/costs#background-token-usage) にも使用されます。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |

167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Haiku モデルの表示説明。設定されていない場合、行は `Custom Haiku model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |167| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Haiku モデルの表示説明。設定されていない場合、行は `Custom Haiku model` で始まるデフォルトの説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` ピッカーのピン留めされた Haiku モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |168| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | `/model` ピッカーのピン留めされた Haiku モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合は行にモデルの名前が表示され、そうでない場合はピン留めされた ID が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Haiku モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |169| `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Haiku モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

170| `ANTHROPIC_DEFAULT_MODEL` | 新しいセッションがデフォルトで開始するモデル。Claude Code v2.1.236 以降が必要です。[新しいセッションのデフォルトモデルを設定](/docs/ja/model-config#set-a-default-model-for-new-sessions) を参照してください |170| `ANTHROPIC_DEFAULT_MODEL` | 新しいセッションがデフォルトで開始するモデル。Claude Code v2.1.236 以降が必要です。[新しいセッションのデフォルトモデルを設定](/docs/ja/model-config#set-a-default-model-for-new-sessions) を参照してください |

171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` エイリアスが解決するモデル ID、および Plan Mode がアクティブな間に `opusplan` が使用するモデル ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |171| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` エイリアスが解決するモデル ID、および Plan Mode がアクティブな場合に `opusplan` が使用するモデル ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |

172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Opus モデルの表示説明。設定されていない場合、行は `Custom Opus model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |172| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Opus モデルの表示説明。設定されていない場合、行は `Custom Opus model` で始まるデフォルトの説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` ピッカーのピン留めされた Opus モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |173| `ANTHROPIC_DEFAULT_OPUS_MODEL_NAME` | `/model` ピッカーのピン留めされた Opus モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合は行にモデルの名前が表示され、そうでない場合はピン留めされた ID が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Opus モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |174| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Opus モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` エイリアスが解決するモデル ID、および Plan Mode がアクティブでない場合に `opusplan` が使用するモデル ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |175| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` エイリアスが解決するモデル ID、および Plan Mode がアクティブでない場合に `opusplan` が使用するモデル ID。[モデル設定](/docs/ja/model-config#environment-variables) を参照してください |

176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Sonnet モデルの表示説明。設定されていない場合、行は `Custom Sonnet model` で始まるデフォルト説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |176| `ANTHROPIC_DEFAULT_SONNET_MODEL_DESCRIPTION` | `/model` ピッカーのピン留めされた Sonnet モデルの表示説明。設定されていない場合、行は `Custom Sonnet model` で始まるデフォルトの説明を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` ピッカーのピン留めされた Sonnet モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合はモデルの名前を表示し、そうでない場合はピン留めされた ID を表示します。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |177| `ANTHROPIC_DEFAULT_SONNET_MODEL_NAME` | `/model` ピッカーのピン留めされた Sonnet モデルの表示名。設定されていない場合、Claude Code がピン留めされた ID を認識する場合は行にモデルの名前が表示され、そうでない場合はピン留めされた ID が表示されます。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Sonnet モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |178| `ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Sonnet モデルがサポートする [機能](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) のカンマ区切りリスト。例えば `effort,thinking`。[モデル設定](/docs/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

179| `ANTHROPIC_FEDERATION_RULE_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のフェデレーションルール ID。`ANTHROPIC_ORGANIZATION_ID` と一緒に設定すると、Claude Code はフェデレーション認証情報を選択します。これは `/login` 認証情報より上位にランクされます。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |179| `ANTHROPIC_FEDERATION_RULE_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のフェデレーションルール ID。`ANTHROPIC_ORGANIZATION_ID` と一緒に設定すると、Claude Code はフェデレーション認証情報を選択します。これは `/login` 認証情報より上位にランクされます。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |

181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Microsoft Foundry 認証用のベアラートークン。Microsoft Entra アクセストークンなど。Claude Code は `Authorization: Bearer` ヘッダーとして送信します。`ANTHROPIC_FOUNDRY_API_KEY` および Azure デフォルト認証情報チェーンより優先されます。[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照してください。Claude Code v2.1.203 以降が必要です |181| `ANTHROPIC_FOUNDRY_AUTH_TOKEN` | Microsoft Entra アクセストークンなど、Microsoft Foundry 認証用のベアラートークン。Claude Code は `Authorization: Bearer` ヘッダーとして送信します。`ANTHROPIC_FOUNDRY_API_KEY` および Azure デフォルト認証情報チェーンより優先されます。[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照してください。Claude Code v2.1.203 以降が必要です |

182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry リソースの完全なベース URL（例：`https://my-resource.services.ai.azure.com/anthropic`）。`ANTHROPIC_FOUNDRY_RESOURCE` の代替（[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照） |182| `ANTHROPIC_FOUNDRY_BASE_URL` | Microsoft Foundry リソースの完全なベース URL（例：`https://my-resource.services.ai.azure.com/anthropic`）。`ANTHROPIC_FOUNDRY_RESOURCE` の代替（[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照） |

183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry リソース名（例：`my-resource`）。`ANTHROPIC_FOUNDRY_BASE_URL` が設定されていない場合は必須（[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照） |183| `ANTHROPIC_FOUNDRY_RESOURCE` | Microsoft Foundry リソース名（例：`my-resource`）。`ANTHROPIC_FOUNDRY_BASE_URL` が設定されていない場合は必須（[Microsoft Foundry](/docs/ja/microsoft-foundry) を参照） |

185| `ANTHROPIC_ORGANIZATION_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) の組織 ID。`ANTHROPIC_FEDERATION_RULE_ID` と一緒に設定します。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |185| `ANTHROPIC_ORGANIZATION_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) の組織 ID。`ANTHROPIC_FEDERATION_RULE_ID` と一緒に設定します。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |

186| `ANTHROPIC_PROFILE` | 認証に使用する Anthropic プロファイルの名前。[`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) で作成されたもの、または [API キーなしで Console アカウントにサインイン](/docs/ja/authentication#sign-in-without-an-api-key) したもの。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |186| `ANTHROPIC_PROFILE` | 認証する Anthropic プロファイルの名前。例えば、[`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) で作成されたもの、または [API キーなしで Console アカウントにサインイン](/docs/ja/authentication#sign-in-without-an-api-key) したもの。[認証の優先順位](/docs/ja/authentication#authentication-precedence) を参照してください |

188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Amazon Bedrock または Amazon Bedrock Mantle を使用する場合、Haiku クラスモデルの AWS リージョンをオーバーライドします。Amazon Bedrock では、`ANTHROPIC_DEFAULT_HAIKU_MODEL` または非推奨の `ANTHROPIC_SMALL_FAST_MODEL` も設定されている場合のみ有効になります。Amazon Bedrock はそれ以外の場合、セッションリージョンの [デフォルト Sonnet モデルまたはプライマリモデル](/docs/ja/amazon-bedrock#4-pin-model-versions) でバックグラウンドタスクを実行するため |188| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Amazon Bedrock または Amazon Bedrock Mantle を使用する場合、Haiku クラスモデルの AWS リージョンをオーバーライドします。Amazon Bedrock では、`ANTHROPIC_DEFAULT_HAIKU_MODEL` または非推奨の `ANTHROPIC_SMALL_FAST_MODEL` も設定されている場合にのみ有効になります。Amazon Bedrock はそれ以外の場合、バックグラウンドタスクをセッションリージョンの [デフォルト Sonnet モデルまたはプライマリモデル](/docs/ja/amazon-bedrock#4-pin-model-versions) で実行するため |

189| `ANTHROPIC_VERTEX_BASE_URL` | Google Cloud の Agent Platform エンドポイント URL をオーバーライドします。カスタム Google Cloud の Agent Platform エンドポイントの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai) を参照してください |189| `ANTHROPIC_VERTEX_BASE_URL` | Google Cloud の Agent Platform エンドポイント URL をオーバーライドします。カスタム Google Cloud の Agent Platform エンドポイントの場合、または [LLM ゲートウェイ](/docs/ja/llm-gateway) を通じてルーティングする場合に使用します。[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai) を参照してください |

190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud の Agent Platform リクエストが対象とする GCP プロジェクト ID。[GCP 認証情報を設定](/docs/ja/google-vertex-ai#3-configure-gcp-credentials) を参照してください |190| `ANTHROPIC_VERTEX_PROJECT_ID` | Google Cloud の Agent Platform リクエストが対象とする GCP プロジェクト ID。[GCP 認証情報を設定](/docs/ja/google-vertex-ai#3-configure-gcp-credentials) を参照してください |

191| `ANTHROPIC_WORKSPACE_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のワークスペース ID。フェデレーションルールが複数のワークスペースにスコープされている場合、トークン交換がどのワークスペースをターゲットにするかを知るために設定します |191| `ANTHROPIC_WORKSPACE_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) のワークスペース ID。フェデレーションルールが複数のワークスペースにスコープされている場合、トークン交換がどのワークスペースをターゲットにするかを知るために設定します |

192| `API_FORCE_IDLE_TIMEOUT` | ストリーミングモデル応答がバイトを受け取らないときに中止する 5 分間のボディアイドルタイムアウトをオーバーライドします。`0` に設定してタイムアウトをオフにします。例えば、遅い [ゲートウェイ](/docs/ja/llm-gateway) またはローカルモデルがチャンク間で 5 分以上一時停止する場合、または `1` に設定してすべてのプロバイダーでオンに保ちます。設定されていない場合、タイムアウトは直接 Anthropic API および [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 以外のプロバイダーでアクティブです。[ストリーム監視犬](/docs/ja/network-config#streaming-idle-watchdogs) は独立して実行され、ここで `0` を設定した場合でも長い無音の一時停止を中止します |192| `API_FORCE_IDLE_TIMEOUT` | バイトが到着しないときにストリーミングモデル応答を中止する 5 分間のボディアイドルタイムアウトをオーバーライドします。`0` に設定してタイムアウトをオフにします。例えば、遅い [ゲートウェイ](/docs/ja/llm-gateway) またはローカルモデルがチャンク間で 5 分以上一時停止する場合、または `1` に設定してすべてのプロバイダーで有効に保ちます。設定されていない場合、タイムアウトは Anthropic API 直接接続および [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 以外のプロバイダーでアクティブです。[ストリーム監視犬](/docs/ja/network-config#streaming-idle-watchdogs) は独立して実行され、ここで `0` を設定した場合でも長い無音の一時停止を中止します |

193| `API_TIMEOUT_MS` | API リクエストのタイムアウト（ミリ秒単位）（デフォルト：600000、または 10 分。最大：2147483647）。遅いネットワークでリクエストがタイムアウトする場合、またはプロキシを通じてルーティングする場合は増加させます。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが直ちに失敗します |193| `API_TIMEOUT_MS` | API リクエストのタイムアウト（ミリ秒単位）（デフォルト：600000、または 10 分。最大：2147483647）。遅いネットワークでリクエストがタイムアウトする場合、またはプロキシを通じてルーティングする場合は増加させます。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが直ちに失敗します |

194| `AWS_BEARER_TOKEN_BEDROCK` | 認証用の Amazon Bedrock API キー（[Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照） |194| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock API キー認証用（[Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照） |

196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数（デフォルト：30000。最大：150000）。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を設定した場合、Claude Code はこの変数を無視します。[出力制限](/docs/ja/tools-reference#output-limits) を参照してください |196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数（デフォルト：30000。最大：150000）。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を設定した場合、Claude Code はこの変数を無視します。[出力制限](/docs/ja/tools-reference#output-limits) を参照してください |

197| `BASH_MAX_TIMEOUT_MS` | モデルが長時間実行される bash コマンドに設定できる最大タイムアウト（デフォルト：600000、または 10 分）。有効な上限は、これと `BASH_DEFAULT_TIMEOUT_MS` の大きい方です |197| `BASH_MAX_TIMEOUT_MS` | モデルが長時間実行される bash コマンドに設定できる最大タイムアウト（デフォルト：600000、または 10 分）。有効な上限は、これと `BASH_DEFAULT_TIMEOUT_MS` の大きい方です |

198| `BETA_TRACING_ENDPOINT` | [詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) 用の OTLP エンドポイント：`ENABLE_BETA_TRACING_DETAILED=1` を使用すると、ログとトレースは設定されたエクスポーターではなくそこに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |198| `BETA_TRACING_ENDPOINT` | [詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) 用の OTLP エンドポイント：`ENABLE_BETA_TRACING_DETAILED=1` を使用すると、ログとトレースは設定されたエクスポーターではなくそこに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

199| `CCR_FORCE_BUNDLE` | `1` に設定して、[`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) をローカルリポジトリをリモートから複製する代わりにバンドルしてアップロードするように強制します |199| `CCR_FORCE_BUNDLE` | [`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモートから複製する代わりにローカルリポジトリをバンドルしてアップロードするように強制するには `1` に設定します |

200| `CLAUDECODE` | Claude Code が生成するサブプロセス（Bash および PowerShell ツール、tmux セッション、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) サブプロセス）で `1` に設定します。IDE 拡張機能は統合ターミナルでもこれを設定します。スクリプトが Claude Code によって生成されたサブプロセス内で実行されているかどうかを検出するために使用します。Claude Code が開始した stdio MCP サーバー内ではなく、ツール呼び出しまたはフックによって直接生成されたプロセスであるかどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |200| `CLAUDECODE` | Claude Code が生成するサブプロセス（Bash および PowerShell ツール、tmux セッション、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) サブプロセス）で `1` に設定されます。IDE 拡張機能は統合ターミナルでもこれを設定します。スクリプトが Claude Code によって生成されたサブプロセス内で実行されているかどうかを検出するために使用します。現在のプロセスがツール呼び出しまたはフックによって直接生成されたのか、Claude Code が開始した stdio MCP サーバー内かどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |

201| `CLAUDE_AFK_COUNTDOWN_MS` | 自動継続前に、未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログに画面上のカウントダウンが表示されるまでのミリ秒数。デフォルト `20000`（20 秒）。自動継続タイムアウトでキャップされます。自動継続がオンでない場合は効果がありません。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定および `CLAUDE_AFK_TIMEOUT_MS` を参照してください。Claude Code v2.1.198 以降が必要です |201| `CLAUDE_AFK_COUNTDOWN_MS` | 自動継続前に、未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログに画面上のカウントダウンが表示されるまでのミリ秒数。デフォルト `20000`（20 秒）。自動継続タイムアウトでキャップされます。自動継続がオンでない場合は効果がありません。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定および `CLAUDE_AFK_TIMEOUT_MS` を参照してください。Claude Code v2.1.198 以降が必要です |

202| `CLAUDE_AFK_TIMEOUT_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログが自動継続されるまでのアイドル時間（ミリ秒単位）。自動継続はデフォルトでオフです。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定でオプトインします。この変数はデモと自動テスト用のオーバーライドです：設定されている場合、その設定より優先され、設定が設定されていない場合または `never` の場合でも自動継続をオンにします。`0` を設定してもタイムアウトはオフになりません。ダイアログが直ちに閉じます。v2.1.198 および v2.1.199 では、自動継続はデフォルトでオンで、`60000`（60 秒）タイムアウトでした。Claude Code v2.1.198 以降が必要です |202| `CLAUDE_AFK_TIMEOUT_MS` | 未回答の [`AskUserQuestion`](/docs/ja/tools-reference) ダイアログが自動継続されるまでのアイドル時間（ミリ秒単位）。自動継続はデフォルトでオフです。[`askUserQuestionTimeout`](/docs/ja/settings-reference#askuserquestiontimeout) 設定でオプトインします。この変数はデモと自動テスト用のオーバーライドです：設定されている場合、その設定より優先され、設定が設定されていない場合または `never` の場合でも自動継続をオンにします。`0` を設定してもタイムアウトはオフになりません。ダイアログが直ちに閉じます。v2.1.198 および v2.1.199 では、自動継続はデフォルトでオンで、`60000`（60 秒）タイムアウトでした。Claude Code v2.1.198 以降が必要です |

203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | `1` に設定して、Explore や Plan などのすべての組み込み [サブエージェント](/docs/ja/sub-agents) タイプを無効にします。非対話モード（`-p` フラグ）にのみ適用されます。ブランクスレートが必要な SDK ユーザーに役立ちます。これにより、Agent ツール呼び出しが `subagent_type` を省略したときに Claude Code が実行する `general-purpose` も削除されます。そのような呼び出しは [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) で失敗します |203| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | すべての組み込み [サブエージェント](/docs/ja/sub-agents) タイプ（Explore や Plan など）を無効にするには `1` に設定します。非対話モード（`-p` フラグ）にのみ適用されます。SDK ユーザーが白紙の状態を望む場合に便利です。これにより、エージェントツール呼び出しが `subagent_type` を省略した場合に実行される `general-purpose` も削除されます。その場合、呼び出しは [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) で失敗します |

204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | `1` に設定して、SDK で作成された MCP サーバーからのツール名の `mcp__<server>__` プレフィックスをスキップします。ツールは元の名前を使用します。SDK 使用のみ |204| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK で作成された MCP サーバーからのツール名の `mcp__<server>__` プレフィックスをスキップするには `1` に設定します。ツールは元の名前を使用します。SDK 使用のみ |

205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブエージェントのスタルタイムアウト（ミリ秒単位）。デフォルト `600000`（10 分）。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` を上げてストリーム監視犬がオンの場合、デフォルトはそれに応じて上がります。[遅いまたは停止した API 応答を処理](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses) で説明されています。タイマーはストリーミング進捗イベントごとにリセットされます。ウィンドウ内に進捗が到着しない場合、Claude Code はサブエージェントを中止し、スタルを親に報告します |205| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | サブエージェントのスタルタイムアウト（ミリ秒単位）。デフォルト `600000`（10 分）。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` を上げてストリーム監視犬がオンの場合、デフォルトはそれに応じて上がります。[遅いまたは停止した API 応答を処理](/docs/ja/agent-sdk/typescript#handle-slow-or-stalled-api-responses) で説明されています。タイマーはストリーミング進捗イベントごとにリセットされます。ウィンドウ内に進捗が到着しない場合、Claude Code はサブエージェントを中止し、スタルを親に報告します |

206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 自動コンパクションがトリガーされる自動コンパクトウィンドウのパーセンテージ（1～100）を設定します。`50` などの低い値を使用して早期にコンパクトします。変数はしきい値を上げることはできないため、デフォルトパーセンテージを超える値は無視されます。[モデルのコンテキスト制限の前にコンパクト](/docs/ja/model-config#context-window-and-auto-compaction) するセッションにのみ適用されます。メイン会話とサブエージェントの両方に適用されます |206| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | 自動圧縮がトリガーされる自動圧縮ウィンドウのパーセンテージ（1～100）を設定します。`50` などの低い値を使用して早期に圧縮します。変数はしきい値を上げることはできないため、デフォルトのパーセンテージを超える値は無視されます。[モデルのコンテキスト制限の前に圧縮](/docs/ja/model-config#context-window-and-auto-compaction) するセッションにのみ適用されます。メイン会話とサブエージェントの両方に適用されます |

207| `CLAUDE_AUTO_BACKGROUND_TASKS` | `1` に設定して、長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にします。有効にすると、サブエージェントは約 2 分間実行した後、バックグラウンドに移動されます。また、Claude Code v2.1.212 以降の非対話モードで [長い MCP ツール呼び出しの自動バックグラウンド化](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) も有効にします |207| `CLAUDE_AUTO_BACKGROUND_TASKS` | 長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にするには `1` に設定します。有効にすると、サブエージェントは約 2 分間実行した後、バックグラウンドに移動されます。また、Claude Code v2.1.212 以降の非対話モードで [長い MCP ツール呼び出しの自動バックグラウンド化](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) も有効にします |

208| `CLAUDE_AX_PREPARK_MS` | [スクリーンリーダーモード](/docs/ja/accessibility#what-your-screen-reader-hears) では、Claude Code が新しい行または変更された行を書き込む前に、カーソルを行の開始位置に置いて待機するミリ秒数。デフォルト `50`。`0` に設定して直ちに書き込みます。Claude Code は待機を `5000` でキャップします。Claude Code v2.1.233 以降が必要です |208| `CLAUDE_AX_PREPARK_MS` | [スクリーンリーダーモード](/docs/ja/accessibility#what-your-screen-reader-hears) では、Claude Code が新しい行または変更された行を書き込む前に、カーソルを行の開始位置に置いて待機するミリ秒数。デフォルト `50`。`0` に設定して直ちに書き込みます。Claude Code は待機を `5000` でキャップします。Claude Code v2.1.233 以降が必要です |

209| `CLAUDE_AX_SCREEN_READER` | スクリーンリーダーフレンドリーな出力をレンダリングするために `1` に設定します：装飾的なボーダーやアニメーションのないフラットテキスト。[`axScreenReader`](/docs/ja/settings-reference#axscreenreader) が `true` の場合でも、スクリーンリーダーモードを強制的にオフにするために `0` に設定します。[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) フラグが優先されます。Claude Code v2.1.181 以降が必要です |209| `CLAUDE_AX_SCREEN_READER` | スクリーンリーダーフレンドリーな出力をレンダリングするには `1` に設定します：装飾的なボーダーやアニメーションのないフラットテキスト。[`axScreenReader`](/docs/ja/settings-reference#axscreenreader) が `true` の場合でも、スクリーンリーダーモードを強制的にオフにするには `0` に設定します。[`--ax-screen-reader`](/docs/ja/cli-reference#cli-flags) フラグが優先されます。Claude Code v2.1.181 以降が必要です |

210| `CLAUDE_AX_STARTUP_QUIET_MS` | [スクリーンリーダーモード](/docs/ja/accessibility) では、スクリーンリーダーが新しい出力によって中断される前に行全体を話すことができるように、スタートアップ確認行の後の最初のインターフェイスレンダリングを保持するミリ秒数。デフォルト `3000`。`0` に設定して直ちにレンダリングします。Claude Code は保持を `600000`（10 分）でキャップします。最初のキーストロークが保持を早期に終了します。Claude Code v2.1.217 以降が必要です |210| `CLAUDE_AX_STARTUP_QUIET_MS` | [スクリーンリーダーモード](/docs/ja/accessibility) では、スクリーンリーダーが新しい出力によって中断される前に行全体を話すことができるように、スタートアップ確認行の後の最初のインターフェイスレンダリングを保持するミリ秒数。デフォルト `3000`。`0` に設定して直ちにレンダリングします。Claude Code は保持を `600000`（10 分）でキャップします。最初のキーストロークが保持を早期に終了します。Claude Code v2.1.217 以降が必要です |

212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | バイトレベルストリーミングアイドル監視犬のタイムアウト（ミリ秒単位）。設定されている場合、そのタイムアウトに対して `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先され、イベントレベルの監視犬は変更されません。Claude Code はこの変数を 10 秒～ 30 分の間にクランプします。Claude Code v2.1.210 以降が必要です |212| `CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` | バイトレベルストリーミングアイドル監視犬のタイムアウト（ミリ秒単位）。設定されている場合、そのアイドル監視犬の `CLAUDE_STREAM_IDLE_TIMEOUT_MS` より優先され、イベントレベルの監視犬は変更されません。Claude Code はこの変数を 10 秒～ 30 分の間にクランプします。Claude Code v2.1.210 以降が必要です |

213| `CLAUDE_CLIENT_PRESENCE_FILE` | スクリーンロックリスナーなどの外部ツールが、スクリーンのロックを解除するときに作成し、ロックするときに削除するファイルへのパス。ファイルが存在する間、Claude Code は [リモートコントロールモバイルプッシュ通知](/docs/ja/remote-control#mobile-push-notifications) をスキップするため、コンピューターをアクティブに使用している間はプッシュを受け取りません。ファイルが存在しないか読み取り不可の場合、通知は通常どおり送信されます。Claude Code はファイルをポーリングするのではなく、プッシュトリガーイベントごとに 1 回チェックします。Claude Code v2.1.181 以降が必要です |213| `CLAUDE_CLIENT_PRESENCE_FILE` | スクリーンロックリスナーなどの外部ツールが、画面のロックを解除したときに作成し、ロックしたときに削除するファイルへのパス。ファイルが存在する間、Claude Code は [Remote Control モバイルプッシュ通知](/docs/ja/remote-control#mobile-push-notifications) をスキップするため、コンピューターをアクティブに使用している間はプッシュを受け取りません。ファイルが存在しないか読み取り不可の場合、通知は通常どおり送信されます。Claude Code はファイルをポーリングするのではなく、プッシュトリガーイベントごとに 1 回チェックします。Claude Code v2.1.181 以降が必要です |

214| `CLAUDE_CODE_ACCESSIBILITY` | ネイティブターミナルカーソルを表示したままにし、反転テキストカーソルインジケーターを無効にするために `1` に設定します。macOS Zoom などのスクリーン拡大鏡がカーソル位置を追跡できるようにします |214| `CLAUDE_CODE_ACCESSIBILITY` | ネイティブターミナルカーソルを表示したままにし、反転テキストカーソルインジケーターを無効にするには `1` に設定します。macOS Zoom などのスクリーンマグニファイアーがカーソル位置を追跡できるようにします |

215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `--add-dir` で指定されたディレクトリからメモリファイルを読み込むために `1` に設定します。`CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。デフォルトでは、追加ディレクトリはメモリファイルを読み込みません |215| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `--add-dir` で指定されたディレクトリからメモリファイルを読み込むには `1` に設定します。`CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。デフォルトでは、追加ディレクトリはメモリファイルを読み込みません |

216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | [フルスクリーンレンダリング](/docs/ja/fullscreen) で増分更新を送信する代わりに、すべてのフレームで画面全体を再描画するために `1` に設定します。フルスクリーンモードが古いまたは配置ずれのテキストフラグメントを表示する場合に使用します。Claude Code はバックグラウンドセッションおよび Windows の [エージェントビュー](/docs/ja/agent-view) でこれを自動的に有効にします |216| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | [フルスクリーンレンダリング](/docs/ja/fullscreen) で増分更新を送信する代わりに、すべてのフレームで画面全体を再描画するには `1` に設定します。フルスクリーンモードで古いテキストフラグメントまたは配置ずれが表示される場合に使用します。Claude Code はバックグラウンドセッションおよび Windows の [エージェントビュー](/docs/ja/agent-view) でこれを自動的に有効にします |

217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Claude Code がモデル ID を努力対応として認識しない場合でも、すべてのリクエストで [努力](/docs/ja/model-config#adjust-effort-level) パラメーターを送信するために `1` に設定します。[LLM ゲートウェイ](/docs/ja/llm-gateway) またはカスタム識別子でモデルを提供するサードパーティプロバイダーを通じてルーティングする場合に使用します。API で努力パラメーターを拒否するモデル（Claude 3 モデル、Sonnet 4.0 および 4.5、Opus 4.0 および 4.1、Haiku 4.5 を含む）は、リクエストが失敗しないように除外されます |217| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Claude Code がモデル ID を努力対応として認識しない場合でも、すべてのリクエストで [努力](/docs/ja/model-config#adjust-effort-level) パラメーターを送信するには `1` に設定します。[LLM ゲートウェイ](/docs/ja/llm-gateway) またはカスタム識別子でモデルを提供するサードパーティプロバイダーを通じてルーティングする場合に使用します。Claude 3 モデル、Sonnet 4.0 および 4.5、Opus 4.0 および 4.1、Haiku 4.5 を含む、API で努力パラメーターを拒否するモデルは、リクエストが失敗しないようにまだ除外されています |

218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 認証情報をリフレッシュする間隔（ミリ秒単位）（[`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) を使用する場合） |218| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 認証情報をリフレッシュする間隔（ミリ秒単位）（[`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) を使用する場合） |

219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 新しい [アーティファクト](/docs/ja/artifacts#create-an-artifact) が公開されたときに Claude Code がブラウザーを自動的に開くのを停止するために `0` に設定します |219| `CLAUDE_CODE_ARTIFACT_AUTO_OPEN` | 新しい [アーティファクト](/docs/ja/artifacts#create-an-artifact) が公開されたときにブラウザーを自動的に開くのを停止するには `0` に設定します |

220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | [アーティファクトのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact) を読み取り、返信するのを停止するために `0` に設定します。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が [アーティファクトをオフ](/docs/ja/artifacts#availability) にした場合は効果がありません。Claude Code v2.1.221 以降が必要です |220| `CLAUDE_CODE_ARTIFACT_COMMENTS` | [アーティファクトのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact) を読み取り、返信するのを停止するには `0` に設定します。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が [アーティファクトをオフ](/docs/ja/artifacts#availability) にした場合は効果がありません。Claude Code v2.1.221 以降が必要です |

221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Claude が [送信されたコメントに自動的に返信するのを停止](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) するために `0` に設定します。Claude Code v2.1.228 以降が必要です |221| `CLAUDE_CODE_ARTIFACT_COMMENTS_AUTOREACT` | Claude が [送信されたコメントに自動的に返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) するのを停止するには `0` に設定します。Claude Code v2.1.228 以降が必要です |

222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | [属性ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)（クライアントバージョンとプロンプトフィンガープリントを含む）をシステムプロンプトの開始から省略するために `0` に設定します。Anthropic API への直接接続でのキャッシングはどちらの方法でも影響を受けません。一部の直接接続セットアップでは、Claude Code は `0` を設定した場合でも [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器リクエストでブロックをオンに保ちます。[システムプロンプト属性ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block) で、これがカバーする接続と認証情報を確認してください。v2.1.181 より前は、ブロックにはカスタムベース URL および Microsoft Foundry 接続でのリクエストごとのトークンが含まれていたため、これらのバージョンでは、LLM ゲートウェイがリクエスト本体でキャッシュするか、リクエストをサードパーティプロバイダーに転送する場合、または Microsoft Foundry に直接接続する場合は `0` に設定します |222| `CLAUDE_CODE_ATTRIBUTION_HEADER` | [属性ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block)（クライアントバージョンとプロンプトフィンガープリントを含む）をシステムプロンプトの開始から省略するには `0` に設定します。Anthropic API への直接接続でのキャッシングはどちらの方法でも影響を受けません。一部の直接接続セットアップでは、Claude Code は `0` を設定した場合でも [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器リクエストでブロックをオンに保ちます。[システムプロンプト属性ブロック](/docs/ja/llm-gateway-protocol#system-prompt-attribution-block) で、これがカバーする接続と認証情報を確認してください。v2.1.181 より前は、ブロックにはカスタムベース URL および Microsoft Foundry 接続でのリクエストごとのトークンが含まれていたため、これらのバージョンでは、LLM ゲートウェイがリクエスト本体でキャッシュするか、リクエストをサードパーティプロバイダーに転送する場合、または Microsoft Foundry に直接接続する場合は `0` に設定します |

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | `CLAUDE_AUTO_BACKGROUND_TASKS` が有効な場合、Claude に [バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) がまだ実行されているかをチェックするよう促すリマインダー間の秒数。`1` ～ `86400` の範囲の平文整数のみを受け入れます。その他の値または表記は設定されていないものとして読み取られます。設定されていない場合、チェックインリマインダーはありません。Claude Code v2.1.248 以降が必要です |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | `CLAUDE_AUTO_BACKGROUND_TASKS` が有効な場合、Claude に [バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) がまだ実行されているかどうかを確認するよう促すリマインダー間の秒数。`1` ～ `86400` の範囲の平文整数のみを受け入れます。その他の値またはスペルは設定されていないものとして読み取られます。設定されていない場合、チェックインリマインダーはありません。Claude Code v2.1.248 以降が必要です |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動コンパクトウィンドウ](/docs/ja/model-config#set-the-auto-compact-window) をトークン単位で設定します。`100000` ～ `1000000`。`500000` などの平文整数のみを受け入れます：`500k` などの値は `500` として読み取られ、100K 最小値にクランプされます。有効なウィンドウはモデルのコンテキストウィンドウでもキャップされます。`/autocompact` コマンド、`--autocompact` フラグ、および `autoCompactWindow` 設定より優先されます。ステータスラインの `used_percentage` は常にモデルの完全なコンテキストウィンドウに対して測定されるため、この変数が設定されると、そのパーセンテージはコンパクションが実行されるときを示さなくなります |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動圧縮ウィンドウ](/docs/ja/model-config#set-the-auto-compact-window) をトークン単位で設定します。`100000` ～ `1000000`。`500000` などの平文整数のみを受け入れます：`500k` などの値は `500` として読み取られ、100K 最小値にクランプされます。有効なウィンドウはモデルのコンテキストウィンドウでもキャップされます。`/autocompact` コマンド、`--autocompact` フラグ、および `autoCompactWindow` 設定より優先されます。ステータスラインの `used_percentage` は常にモデルの完全なコンテキストウィンドウに対して測定されるため、この変数が設定されると、そのパーセンテージは圧縮が実行されるタイミングを示さなくなります |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動 [IDE 接続](/docs/ja/vs-code) をオーバーライドします。デフォルトでは、Claude Code はサポートされている IDE の統合ターミナル内で起動されたときに自動的に接続します。`false` に設定してこれを防ぎます。tmux が親ターミナルを隠すなど、自動検出が失敗した場合に接続を試みるように強制するために `true` に設定します。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グローバル設定より優先されます |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動 [IDE 接続](/docs/ja/vs-code) をオーバーライドします。デフォルトでは、Claude Code はサポートされている IDE の統合ターミナル内で起動されたときに自動的に接続します。自動検出が失敗した場合（tmux が親ターミナルを隠す場合など）に接続試行を防ぐには `false` に設定します。接続試行を強制するには `true` に設定します。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グローバル設定より優先されます |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では、プラットフォームのサーバー側分類器が [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) アクションをレビューするために `1` に設定します。プラットフォームが分類器を実行しない場合、Claude Code は独自の分類器リクエストにフォールバックします。設定されていない場合または `0` の場合、分類器は Claude Code 自体が送信するリクエストを通じて実行されます。他のプロバイダー（Anthropic API を含む）には効果がありません。Claude Code v2.1.271 以降が必要です |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサーバーに [自動モードアクションをレビュー](/docs/ja/permission-modes#server-side-classifier-review) するよう要求するかどうかを制御します。設定されていない場合、Claude Code は Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS でサーバーに要求し、`ANTHROPIC_BASE_URL` が LLM ゲートウェイまたはプロキシを指している場合に要求します。Claude Code 独自の分類器リクエストを代わりに使用するには `0` に設定します。Anthropic API への直接接続では読み取られません。Claude Code v2.1.271 以降が必要です。デフォルトでサーバーに要求するには v2.1.278 以降が必要です |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Claude Code が AWS デフォルト認証情報プロバイダーチェーンが認証情報を生成するのを待つ時間（ミリ秒単位）。リクエストが [`AWS default-chain credential resolve timed out`](/docs/ja/errors#aws-default-chain-credential-resolve-timed-out) で失敗するまで（デフォルト：`60000`）。チェーン内のステップが正当に長い時間を必要とする場合は増加させます。例えば、`aws-vault` などのラッパーを通じた MFA を使用したブラウザベースの SSO サインイン。デフォルトチェーンで署名する Claude Code のすべての場所に適用されます：[Amazon Bedrock](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)。Claude Code v2.1.207 以降が必要です |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Claude Code が AWS デフォルト認証情報プロバイダーチェーンが認証情報を生成するのを待つ時間（ミリ秒単位）。リクエストが [`AWS default-chain credential resolve timed out`](/docs/ja/errors#aws-default-chain-credential-resolve-timed-out) で失敗する前（デフォルト：`60000`）。チェーン内のステップが正当に長く必要な場合（`aws-vault` などのラッパーを通じた MFA を使用したブラウザベースの SSO サインインなど）は増加させます。Claude Code がデフォルトチェーンで署名する場所に適用されます：[Amazon Bedrock](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)。Claude Code v2.1.207 以降が必要です |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Bash コマンドが変更したファイルの [差分](/docs/ja/hooks#bash) をオフにするために `0` に設定するか、すべての権限モードで記録するために `1` に設定します。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 設定より優先されます。Claude Code v2.1.269 以降が必要です |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Bash コマンドの実行中に変更されたファイルの [差分](/docs/ja/hooks#bash) をオフにするには `0` に設定するか、すべての権限モードで記録するには `1` に設定します。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 設定より優先されます。Claude Code v2.1.269 以降が必要です |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | 非対話セッションがバックグラウンド作業がまだ実行されている場合でも、ターンの終了時にアイドルステータスをホストに報告するために `0` に設定します。デフォルトでは、セッションはバックグラウンドエージェントや [ワークフロー](/docs/ja/workflows) 実行などのバックグラウンド作業がまだ実行されている間、ターン終了を過ぎて実行ステータスを報告し続けます。これにより、セッションリストなどのステータスを監視するホストが、Claude が作業中に入力を待っていることを発表するのを防ぎます。バックグラウンドシェルコマンド（開発サーバーなど）は実行ステータスを保持しません。実行ステータスのデフォルトと `0` オプトアウトには Claude Code v2.1.269 以降が必要です。以前のバージョンでは、実行ステータスを保持するために `1` を設定します |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | 非対話セッションがバックグラウンド作業がまだ実行されている場合でも、ターン終了時にホストにアイドルステータスを報告するには `0` に設定します。デフォルトでは、セッションはバックグラウンドエージェントや [ワークフロー](/docs/ja/workflows) 実行などのバックグラウンド作業がまだ実行されている間、ターン終了を過ぎて実行ステータスを報告し続けます。これにより、セッションリストなどのステータスを監視するホストが、Claude が作業中に入力を待機していることを発表するのを防ぎます。バックグラウンドシェルコマンド（開発サーバーなど）は実行ステータスを保持しません。実行ステータスのデフォルトと `0` オプトアウトには Claude Code v2.1.269 以降が必要です。以前のバージョンでは、実行ステータスを保持するには `1` を設定します |

230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | セッションがアクティブな [リモートコントロール](/docs/ja/remote-control) 接続を持っている間、Bash ツールおよび [フックコマンド](/docs/ja/hooks) サブプロセスで自動的に設定され、接続が終了すると削除されます。値はセッションの ID（`session_` 形式）で、セッションの `claude.ai/code` URL に表示される同じ識別子です。スクリプトはそれを実行したセッションにリンクバックできます。Claude Code v2.1.199 以降が必要です。[クラウドセッション](/docs/ja/claude-code-on-the-web) では、代わりに `CLAUDE_CODE_REMOTE_SESSION_ID` を読み取ります |230| `CLAUDE_CODE_BRIDGE_SESSION_ID` | セッションがアクティブな [Remote Control](/docs/ja/remote-control) 接続を持っている間、Bash ツールおよび [フックコマンド](/docs/ja/hooks) サブプロセスで自動的に設定され、接続が終了すると削除されます。値は `session_` 形式のセッション ID で、セッションの `claude.ai/code` URL に表示される同じ識別子であるため、スクリプトはそれを実行したセッションにリンクバックできます。Claude Code v2.1.199 以降が必要です。[クラウドセッション](/docs/ja/claude-code-on-the-web) では、代わりに `CLAUDE_CODE_REMOTE_SESSION_ID` を読み取ります |

231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Claude Code が `0x08` バイト（`^H` とも書かれます）をプレーンバックスペースとして読み取るために `0` に設定するか、Ctrl+Backspace として読み取るために `1` に設定します。どちらの値もプラットフォームのデフォルトを置き換えます。デフォルトでは、Claude Code は Windows で Ctrl+Backspace として読み取ります。ただし、`TERM_PROGRAM` が `mintty` または `TERM` が `cygwin` の場合を除き、macOS および Linux ではプレーンバックスペースとして読み取ります。Windows ターミナルで [Backspace が単語全体を削除](/docs/ja/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) する場合は `0` に設定します |231| `CLAUDE_CODE_BS_AS_CTRL_BACKSPACE` | Claude Code が `0x08` バイト（`^H` とも書かれる）をプレーンバックスペースとして読み取るには `0` に設定するか、Ctrl+Backspace として読み取るには `1` に設定します。どちらの値もプラットフォームのデフォルトを置き換えます。デフォルトでは、Claude Code は Windows で Ctrl+Backspace として読み取ります。ただし、`TERM_PROGRAM` が `mintty` または `TERM` が `cygwin` の場合を除き、macOS および Linux ではプレーンバックスペースとして読み取ります。Windows ターミナルで [Backspace が単語全体を削除](/docs/ja/terminal-config#fix-backspace-deleting-a-whole-word-on-windows) する場合は `0` に設定します |

232| `CLAUDE_CODE_CERT_STORE` | TLS 接続用の CA 証明書ソースのカンマ区切りリスト。`bundled` は Claude Code に付属する Mozilla CA セットです。`system` はオペレーティングシステムの信頼ストアで、`tls.getCACertificates` を持つランタイムでのみ読み取られます：ネイティブバイナリ、または npm インストール用の Node 22.15 以降。[CA 証明書ストア](/docs/ja/network-config#ca-certificate-store) を参照してください。デフォルトは `bundled,system` です |232| `CLAUDE_CODE_CERT_STORE` | TLS 接続用の CA 証明書ソースのカンマ区切りリスト。`bundled` は Claude Code に付属する Mozilla CA セットです。`system` はオペレーティングシステムの信頼ストアで、`tls.getCACertificates` を持つランタイムでのみ読み取られます：ネイティブバイナリ、または npm インストール用の Node 22.15 以降。[CA 証明書ストア](/docs/ja/network-config#ca-certificate-store) を参照してください。デフォルトは `bundled,system` です |

233| `CLAUDE_CODE_CHILD_SESSION` | Bash、PowerShell、Monitor ツール、[フック](/docs/ja/hooks) コマンド、および [ステータスライン](/docs/ja/statusline) コマンドを通じて Claude Code が生成するサブプロセスで `1` に設定されます。stdio [MCP サーバー](/docs/ja/mcp) サブプロセスでは設定されません。これらは長寿命で、それらを生成したセッションより長く存在します。`CLAUDECODE` とは異なり、これは Claude Code 自体がサブプロセスを起動するときのみ設定され、IDE 拡張機能では設定されないため、ネストされたセッションを IDE 統合ターミナルで起動されたトップレベルの `claude` から確実に区別します。この方法で開始されたネストされた対話型 `claude` TUI は、`--resume`、`--continue`、上矢印履歴、および `claude agents` リストから自動的に除外されます。非対話型 `claude -p` セッションは引き続き永続化されます。このセッションの除外をオーバーライドするには `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` を設定します。Claude Code v2.1.172 以降が必要です |233| `CLAUDE_CODE_CHILD_SESSION` | Bash、PowerShell、Monitor ツール、[フック](/docs/ja/hooks) コマンド、および [ステータスライン](/docs/ja/statusline) コマンドを通じて Claude Code が生成するサブプロセスで `1` に設定されます。stdio [MCP サーバー](/docs/ja/mcp) サブプロセスでは設定されません。これらは長寿命で、それらを生成したセッションより長く存在します。`CLAUDECODE` とは異なり、これは Claude Code 自体がサブプロセスを起動する場合にのみ設定され、IDE 拡張機能では設定されないため、ネストされたセッションを IDE 統合ターミナルで起動されたトップレベルの `claude` から確実に区別します。この方法で開始されたネストされた対話型 `claude` TUI は `--resume`、`--continue`、上矢印履歴、および `claude agents` リストから自動的に除外されます。非対話型 `claude -p` セッションは引き続き永続化されます。このセキュリティ除外をオーバーライドするには `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` を設定します。Claude Code v2.1.172 以降が必要です |

237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186 で削除され、現在は no-op です。以前は、ストリーミング API リクエストの接続、TLS、応答ヘッダーフェーズの個別タイムアウトを設定していました。リクエストごとのタイムアウトには `API_TIMEOUT_MS` を使用します。ストリーミングリクエストの応答ヘッダーフェーズについては、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を参照してください |237| `CLAUDE_CODE_CONNECT_TIMEOUT_MS` | v2.1.186 で削除され、現在は no-op です。以前は、ストリーミング API リクエストの接続、TLS、応答ヘッダーフェーズの個別タイムアウトを設定していました。リクエストごとのタイムアウトには `API_TIMEOUT_MS` を使用します。ストリーミングリクエストの応答ヘッダーフェーズについては、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を参照してください |

238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルパスをオーバーライドします。名前に反して、これはディレクトリではなくファイルパスです。デバッグモードを `--debug`、`/debug`、または `DEBUG` 環境変数で別途有効にする必要があります：この変数を設定するだけではログが有効になりません。[`--debug-file`](/docs/ja/cli-reference#cli-flags) フラグは両方を一度に実行します。デフォルトは `~/.claude/debug/<session-id>.txt` です |238| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルパスをオーバーライドします。名前に反して、これはディレクトリではなくファイルパスです。デバッグモードは `--debug`、`/debug`、または `DEBUG` 環境変数を通じて別途有効にする必要があります：この変数を設定するだけではログが有効になりません。[`--debug-file`](/docs/ja/cli-reference#cli-flags) フラグは両方を一度に実行します。デフォルトは `~/.claude/debug/<session-id>.txt` です |

239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値：`verbose`、`debug`（デフォルト）、`info`、`warn`、`error`。フルステータスラインコマンド出力などの大量の診断を含めるために `verbose` に設定するか、ノイズを減らすために `error` に上げます |239| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値：`verbose`、`debug`（デフォルト）、`info`、`warn`、`error`。フルステータスラインコマンド出力などの大量の診断を含めるには `verbose` に設定するか、ノイズを減らすには `error` に上げます |

240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | [1M コンテキストウィンドウ](/docs/ja/model-config#extended-context) サポートを無効にするために `1` に設定します。設定されている場合、1M モデルバリアントはモデルピッカーで利用できず、Claude Code は [Sonnet 5](/docs/ja/model-config#sonnet-5-context-window) や Fable モデルなど、ネイティブ 1M ウィンドウを持つモデルのセッションを 200K ウィンドウに保持します。[拡張コンテキスト](/docs/ja/model-config#extended-context) で保持がどのように実装されるかを参照してください。コンプライアンス要件を持つエンタープライズ環境に役立ちます。認識されない `[1m]` モデル ID のウィンドウを修正する際の役割については、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください |240| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | [1M コンテキストウィンドウ](/docs/ja/model-config#extended-context) サポートを無効にするには `1` に設定します。設定されている場合、1M モデルバリアントはモデルピッカーで利用できず、Claude Code は [Sonnet 5](/docs/ja/model-config#sonnet-5-context-window) や Fable モデルなど、ネイティブ 1M ウィンドウを持つモデルのセッションを 200K ウィンドウに保持します。[拡張コンテキスト](/docs/ja/model-config#extended-context) でホールドがどのように実装されるかを参照してください。コンプライアンス要件を持つエンタープライズ環境に便利です。認識されない `[1m]` モデル ID のウィンドウを修正する際の役割については、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください |

241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Opus 4.6 および Sonnet 4.6 で [適応的推論](/docs/ja/model-config#adjust-effort-level) を無効にし、`MAX_THINKING_TOKENS` で制御される固定思考予算にフォールバックするために `1` に設定します。[Fable モデル](/docs/ja/model-config#extended-thinking)、Sonnet 5、または Opus 4.7 以降には効果がありません。これらは常に適応的推論を使用します |241| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Opus 4.6 および Sonnet 4.6 で [適応的推論](/docs/ja/model-config#adjust-effort-level) を無効にし、`MAX_THINKING_TOKENS` で制御される固定思考予算にフォールバックするには `1` に設定します。[Fable モデル](/docs/ja/model-config#extended-thinking)、Sonnet 5、Opus 4.7 以降には効果がありません。これらは常に適応的推論を使用します |

242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Claude Code が [管理設定](/docs/ja/managed-settings#precedence-within-the-managed-tier) `env` ブロックをキーごとにマージするのを停止するために `1` に設定します。v2.1.223 より前のように、最高優先度のソースの全体 `env` ブロックのみが適用されます。Claude Code を起動する環境で設定します。Claude Code は設定 `env` ブロックを通じて配信されたコピーを無視するため、v2.1.223 以降が必要です |242| `CLAUDE_CODE_DISABLE_ADMIN_ENV_UNION` | Claude Code が [管理設定](/docs/ja/managed-settings#precedence-within-the-managed-tier) `env` ブロックをキーごとにマージするのを停止するには `1` に設定します。v2.1.223 より前のように、最高優先度のソースの全体 `env` ブロックのみが適用されます。Claude Code を起動する環境で設定します。Claude Code は設定 `env` ブロックを通じて配信されたコピーを無視するため。Claude Code v2.1.223 以降が必要です |

243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | [アドバイザーツール](/docs/ja/advisor) を無効にするために `1` に設定します。`/advisor` コマンドは利用できなくなり、設定された `advisorModel` は無視され、`--advisor` フラグは受け入れられますが効果がないため、既存のスクリプトがそれを渡し続けてもエラーなしで機能します |243| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | [アドバイザーツール](/docs/ja/advisor) を無効にするには `1` に設定します。`/advisor` コマンドは利用できなくなり、設定された `advisorModel` は無視され、`--advisor` フラグは受け入れられますが効果がないため、既存のスクリプトがそれを渡し続けてもエラーなく機能します |

244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | [バックグラウンドエージェントとエージェントビュー](/docs/ja/agent-view) をオフにするために `1` に設定します：`claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザー。[`disableAgentView`](/docs/ja/settings-reference#disableagentview) 設定と同等です |244| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | [バックグラウンドエージェントとエージェントビュー](/docs/ja/agent-view) をオフにするには `1` に設定します：`claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザー。[`disableAgentView`](/docs/ja/settings-reference#disableagentview) 設定と同等です |

245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | [フルスクリーンレンダリング](/docs/ja/fullscreen) を無効にし、クラシックメインスクリーンレンダラーを使用するために `1` に設定します。会話はターミナルのネイティブスクロールバックに留まるため、`Cmd+f` と tmux コピーモードが通常どおり機能します。`CLAUDE_CODE_NO_FLICKER` および [`tui`](/docs/ja/settings-reference#tui) 設定より優先されます。`/tui default` で切り替えることもできます。[エージェントビュー](/docs/ja/agent-view) から開かれたバックグラウンドセッションには適用されません。これらは常にフルスクリーンレンダリングを使用します |245| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | [フルスクリーンレンダリング](/docs/ja/fullscreen) を無効にし、クラシックメインスクリーンレンダラーを使用するには `1` に設定します。会話はターミナルのネイティブスクロールバックに留まるため、`Cmd+f` と tmux コピーモードが通常どおり機能します。`CLAUDE_CODE_NO_FLICKER` および [`tui`](/docs/ja/settings-reference#tui) 設定より優先されます。`/tui default` で切り替えることもできます。[エージェントビュー](/docs/ja/agent-view) から開かれたバックグラウンドセッションには適用されません。これらは常にフルスクリーンレンダリングを使用します |

246| `CLAUDE_CODE_DISABLE_ARTIFACT` | [アーティファクト](/docs/ja/artifacts) ツールをオフにするために `1` に設定します。このツールは、セッション出力を claude.ai 上のプライベート Web ページとして公開します。一度設定すると、設定ファイルはツールをオンに戻しません。代わりに設定ファイルからツールをオフにするには、[`enableArtifact`](/docs/ja/settings-reference#enableartifact) を `false` に設定します。非推奨の [`disableArtifact`](/docs/ja/settings-reference#disableartifact) キーもそれをオフにします |246| `CLAUDE_CODE_DISABLE_ARTIFACT` | [アーティファクト](/docs/ja/artifacts) ツールをオフにするには `1` に設定します。このツールは、セッション出力を claude.ai 上のプライベート Web ページとして公開します。設定されると、設定ファイルはツールをオンに戻しません。代わりに設定ファイルからツールをオフにするには、[`enableArtifact`](/docs/ja/settings-reference#enableartifact) を `false` に設定します。非推奨の [`disableArtifact`](/docs/ja/settings-reference#disableartifact) キーもツールをオフにします |

247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 添付ファイル処理を無効にするために `1` に設定します。`@` 構文を使用したファイルメンションはファイルコンテンツに展開されるのではなく、プレーンテキストとして送信されます |247| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 添付ファイル処理を無効にするには `1` に設定します。`@` 構文を使用したファイルメンションは、ファイルコンテンツに展開されるのではなく、プレーンテキストとして送信されます |

248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | [自動メモリ](/docs/ja/memory#auto-memory) を無効にするために `1` に設定します。`--bare` モードまたは [`autoMemoryEnabled: false`](/docs/ja/settings-reference#automemoryenabled) が自動メモリを無効にする場合でも、自動メモリを強制的にオンにするために `0` に設定します。無効にされている場合、Claude は自動メモリファイルを作成または読み込みません |248| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | [自動メモリ](/docs/ja/memory#auto-memory) を無効にするには `1` に設定します。`--bare` モードまたは [`autoMemoryEnabled: false`](/docs/ja/settings-reference#automemoryenabled) が自動メモリを無効にする場合でも、自動メモリをオンに強制するには `0` に設定します。無効にされた場合、Claude は自動メモリファイルを作成または読み込みません |

249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Bash および subagent ツールの `run_in_background` パラメーター、自動バックグラウンド化、Ctrl+B ショートカットを含む、すべてのバックグラウンドタスク機能を無効にするために `1` に設定します |249| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | すべてのバックグラウンドタスク機能を無効にするには `1` に設定します。Bash およびサブエージェントツールの `run_in_background` パラメーター、自動バックグラウンド化、および Ctrl+B ショートカットを含みます |

250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Claude Code が [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミング応答を、`Content-Type` ヘッダーが欠落または空の Amazon Bedrock バイナリイベントストリームとして扱うのを停止するために `1` に設定します。デフォルトでは、Claude Code はゲートウェイがそれ以外は変更されていない応答からヘッダーをドロップしたと想定するため、本体をデコードしてストリーミングが機能し続けます。ゲートウェイがストリームをサーバー送信イベントとして再発行する場合のみこれを設定します。Claude Code はヘッダーレス本体をサーバー送信イベントとして読み取ります。Claude Code v2.1.239 以降が必要です |250| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | Claude Code が [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミング応答を、欠落または空の `Content-Type` ヘッダーを持つ Amazon Bedrock のバイナリイベントストリームとして扱うのを停止するには `1` に設定します。デフォルトでは、Claude Code はゲートウェイがそれ以外は変更されていない応答からヘッダーをドロップしたと想定するため、本体をデコードしてストリーミングが機能し続けます。ゲートウェイがストリームをサーバー送信イベントとして再発行する場合にのみこれを設定します。Claude Code はヘッダーレスの本体をサーバー送信イベントとして読み取ります。Claude Code v2.1.239 以降が必要です |

251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミング応答が `application/vnd.amazon.eventstream` コンテンツタイプを持つかどうかのチェックをスキップするために `1` に設定します。この変数がない場合、応答が異なるコンテンツタイプを持つと、Claude Code はそのタイプを名前付けするエラーでリクエストを失敗させます。これは [ゲートウェイまたはプロキシが応答を変換している](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) ことを意味します。この変数を設定する代わりに、`Content-Type` ヘッダーと本体を変更されていない状態で転送するようにゲートウェイを設定します。Claude Code v2.1.208 以降が必要です |251| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | [Amazon Bedrock](/docs/ja/amazon-bedrock) ストリーミング応答が `application/vnd.amazon.eventstream` コンテンツタイプを持つかどうかのチェックをスキップするには `1` に設定します。この変数がない場合、応答が異なるコンテンツタイプを持つと、Claude Code はそのタイプを名前で示すエラーでリクエストを失敗させます。これは [ゲートウェイまたはプロキシが応答を変換している](/docs/ja/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy) ことを意味します。この変数を設定する代わりに、`Content-Type` ヘッダーと本体を変更されないまま転送するようにゲートウェイを設定します。Claude Code v2.1.208 以降が必要です |

252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | [バックグラウンドセッション](/docs/ja/agent-view) の実行中のバックグラウンドシェルコマンド、動的ワークフロー、および v2.1.198 以降のバックグラウンドサブエージェントが [スーパーバイザー](/docs/ja/agent-view#the-supervisor-process) を停止、再起動、またはそのセッションのプロセスを更新するときに停止するのを停止するために `1` に設定します。これはそのハンドオフのみに影響します：`←` または [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化すると、進行中の作業が引き続き実行され、`CLAUDE_DISABLE_ADOPT` は両方をオフにします。Claude Code v2.1.196 以降が必要です |252| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | [バックグラウンドセッション](/docs/ja/agent-view) の実行中のバックグラウンドシェルコマンド、動的ワークフロー、および v2.1.198 以降のバックグラウンドサブエージェントが [スーパーバイザー](/docs/ja/agent-view#the-supervisor-process) がそのセッションのプロセスを停止、再起動、または更新するときに停止するのを停止するには `1` に設定します。セッションの次のプロセスに渡す代わりに。このハンドオフのみに影響します：`←` または [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化すると、進行中の作業が引き継がれ、`CLAUDE_DISABLE_ADOPT` は両方をオフにします。Claude Code v2.1.196 以降が必要です |

253| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | オペレーティングシステムがメモリ圧力を報告するときに [バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands) を終了するのを停止するために `1` に設定します。デフォルトでは、macOS および Linux では、Claude Code はメインセッションで開始されたバックグラウンドシェルを、セッションが 30 分間アイドル状態で、ターンまたはサブエージェントが実行されていない場合、メモリ圧力信号で終了します。Windows にはメモリ圧力信号がないため、この変数は効果がありません。Claude Code v2.1.193 以降が必要です |253| `CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP` | Claude Code がメモリ圧力下で [バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands) を終了するのを停止するには `1` に設定します。デフォルトでは、macOS および Linux では、オペレーティングシステムが重大なメモリ圧力を報告し、セッションが 30 分間アイドル状態で、ターンまたはサブエージェントが実行されていない場合、Claude Code はバックグラウンドシェルを終了します。Windows にはメモリ圧力信号がないため、この変数は効果がありません。Claude Code v2.1.193 以降が必要です |

254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code に含まれる [スキル](/docs/ja/skills) とワークフローを無効にするために `1` に設定します：バンドルされたスキルとワークフローは完全に削除されますが、`/init` などの組み込みコマンドは入力可能なままですが、モデルから非表示になります。`/doctor` は組み込みコマンドのように入力可能なままです。`DISABLE_DOCTOR_COMMAND` で非表示にします。プラグイン、`.claude/skills/`、および `.claude/commands/` からのスキルは影響を受けません。[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) 設定と同等です |254| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code に含まれる [スキル](/docs/ja/skills) とワークフローを無効にするには `1` に設定します：バンドルされたスキルとワークフローは完全に削除されますが、`/init` などの組み込みコマンドは入力可能なままですが、モデルから非表示になります。`/doctor` は組み込みコマンドのように入力可能なままです。`DISABLE_DOCTOR_COMMAND` で非表示にします。プラグイン、`.claude/skills/`、および `.claude/commands/` からのスキルは影響を受けません。[`disableBundledSkills`](/docs/ja/settings-reference#disablebundledskills) 設定と同等です |

255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | [Claude in Chrome](/docs/ja/chrome) ブラウザーツールを利用可能に保ちながら、システムプロンプトの Chrome セクションと `/claude-in-chrome` [バンドルスキル](/docs/ja/skills#bundled-skills) を省略するために `1` に設定します。Claude Code を埋め込むホストおよび独自のブラウザーガイダンスを提供するホスト向け。Claude Code v2.1.257 以降が必要です |255| `CLAUDE_CODE_DISABLE_CFC_PROMPT` | [Chrome の Claude](/docs/ja/chrome) ブラウザーツールを利用可能に保ちながら、システムプロンプトの Chrome セクションと `/claude-in-chrome` [バンドルスキル](/docs/ja/skills#bundled-skills) を省略するには `1` に設定します。Claude Code を埋め込み、独自のブラウザーガイダンスを提供するホスト向け。Claude Code v2.1.257 以降が必要です |

257| `CLAUDE_CODE_DISABLE_CRON` | [スケジュール済みタスク](/docs/ja/scheduled-tasks) を無効にするために `1` に設定します。`/loop` スキルと cron ツールは利用できなくなり、既にスケジュール済みのタスクは停止します。セッション内で既に実行されているタスクを含みます |257| `CLAUDE_CODE_DISABLE_CRON` | [スケジュール済みタスク](/docs/ja/scheduled-tasks) を無効にするには `1` に設定します。`/loop` スキルと cron ツールは利用できなくなり、既にスケジュール済みのタスクは停止します。既に実行中のタスクを含みます |

258| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Anthropic 固有の `anthropic-beta` リクエストヘッダーと beta ツールスキーマフィールド（`defer_loading` および `eager_input_streaming` など）を API リクエストから削除するために `1` に設定します。プロキシゲートウェイが「`anthropic-beta` ヘッダーの予期しない値」または「追加の入力は許可されていません」などのエラーでリクエストを拒否する場合に使用します。標準フィールド（`name`、`description`、`input_schema`、`cache_control`）は保持されます。[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) は無効になり、すべての MCP ツールは、設定されている場合でも事前に読み込まれます。Claude Code v2.1.227 以降では、[管理設定](/docs/ja/managed-settings) はツール検索をオンに保つことができます。[事前リリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) でオーバーライドが適用される場所をカバーしています |258| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Anthropic 固有の `anthropic-beta` リクエストヘッダーとベータツールスキーマフィールド（`defer_loading` や `eager_input_streaming` など）を API リクエストから削除するには `1` に設定します。プロキシゲートウェイが「`anthropic-beta` ヘッダーの予期しない値」や「追加の入力は許可されていません」などのエラーでリクエストを拒否する場合に使用します。標準フィールド（`name`、`description`、`input_schema`、`cache_control`）は保持されます。[MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) は無効になり、`ENABLE_TOOL_SEARCH` を設定した場合でも、すべての MCP ツールが事前に読み込まれます。Claude Code v2.1.227 以降では、[管理設定](/docs/ja/managed-settings) がツール検索をオンに保つことができます。[プリリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) でオーバーライドが適用される場所をカバーしています |

259| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 組み込み [Explore および Plan サブエージェント](/docs/ja/sub-agents#built-in-subagents) を無効にするために `1` に設定します。Claude は検索ツールまたは汎用サブエージェントで探索し、[プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) はファイルを直接読み取ります。Explore または Plan という名前のカスタムサブエージェントは影響を受けません。Agent SDK または非対話モードのすべての組み込みサブエージェントタイプを削除するには、代わりに `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` を使用します。Claude Code v2.1.198 以降が必要です |259| `CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS` | 組み込み [Explore および Plan サブエージェント](/docs/ja/sub-agents#built-in-subagents) を無効にするには `1` に設定します。Claude は検索ツールまたは汎用サブエージェントで探索し、[プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) は Explore および Plan エージェントを起動する代わりにファイルを直接読み取ります。`Explore` または `Plan` という名前のカスタムサブエージェントは影響を受けません。Agent SDK または非対話モードで組み込みサブエージェントタイプをすべて削除するには、代わりに `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` を使用します。Claude Code v2.1.198 以降が必要です |

261| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 「Claude はどのように機能していますか？」セッション品質調査を無効にするために `1` に設定します。`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合、調査も無効になります。ただし、`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` がオプトバックインしない限り。サンプルレートを設定する代わりに完全に無効にするには、[`feedbackSurveyRate`](/docs/ja/settings-reference#feedbacksurveyrate) 設定を使用します。[セッション品質調査](/docs/ja/data-usage#session-quality-surveys) を参照してください |261| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | 「Claude はどのように機能していますか？」セッション品質調査を無効にするには `1` に設定します。`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合、調査は無効になります。ただし、`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` がオプトバックインしない限り。完全に無効にする代わりにサンプルレートを設定するには、[`feedbackSurveyRate`](/docs/ja/settings-reference#feedbacksurveyrate) 設定を使用します。[セッション品質調査](/docs/ja/data-usage#session-quality-surveys) を参照してください |

262| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | ファイル [チェックポイント](/docs/ja/checkpointing) を無効にするために `1` に設定します。`/rewind` コマンドはコード変更を復元できません。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定をオーバーライドします |262| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | ファイル [チェックポイント](/docs/ja/checkpointing) を無効にするには `1` に設定します。`/rewind` コマンドはコード変更を復元できません。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定をオーバーライドします |

263| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | Claude のシステムプロンプトから組み込みコミットおよび PR ワークフロー指示と git ステータススナップショットを削除するために `1` に設定します。独自の git ワークフロースキルを使用する場合に役立ちます。[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定が設定されている場合、これが優先されます |263| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | 組み込みコミットおよび PR ワークフロー指示と git ステータススナップショットを Claude のコンテキストから削除するには `1` に設定します。独自の git ワークフロースキルを使用する場合に便利です。[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定が設定されている場合、これより優先されます |

264| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Anthropic API で Opus 4.0 および 4.1 を現在の Opus バージョンに自動的にリマップするのを防ぐために `1` に設定します。古いモデルを意図的にピン留めしたい場合に使用します。リマップは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では実行されません |264| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Opus 4.0 および 4.1 を Anthropic API の現在の Opus バージョンに自動的に再マップするのを防ぐには `1` に設定します。古いモデルを意図的にピン留めする場合に使用します。再マップは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では実行されません |

265| `CLAUDE_CODE_DISABLE_MOUSE` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウストラッキングを無効にするために `1` に設定します。`PgUp` および `PgDn` を使用したキーボードスクロールは引き続き機能します。ターミナルのネイティブコピーオンセレクト動作を保持するために使用します |265| `CLAUDE_CODE_DISABLE_MOUSE` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウストラッキングを無効にするには `1` に設定します。`PgUp` および `PgDn` を使用したキーボードスクロールは引き続き機能します。ターミナルのネイティブコピーオンセレクト動作を保持するために使用します |

266| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でクリック、ドラッグ、ホバー処理を無効にしながら、マウスホイールスクロールを保持するために `1` に設定します。Claude Code 内でホイールスクロールが機能するが、クリックがカーソルを配置したり、ツール出力を展開したり、リンクを開いたりしないようにする場合に使用します。両方が設定されている場合、`CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |266| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウスホイールスクロールを保持しながら、クリック、ドラッグ、ホバー処理を無効にするには `1` に設定します。Claude Code 内でホイールスクロールが機能するが、クリックがカーソルを配置したり、ツール出力を展開したり、リンクを開いたりしないようにする場合に使用します。両方が設定されている場合、`CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |

267| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | API リクエストが接続リセットや TLS ハンドシェイクエラーなどの接続レベルエラーで失敗するときに、Claude Code が [mTLS クライアント証明書とキー](/docs/ja/network-config#mtls-authentication) を再読み込みするのを停止するために `1` に設定します。リロードが無効な場合、Claude Code は設定を次に適用するか、次のスタートアップ時にのみローテーションされたファイルを読み込みます。Claude Code v2.1.232 以降が必要です |267| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | 接続リセットや TLS ハンドシェイクエラーなどの接続レベルエラーで API リクエストが失敗した場合、Claude Code が [mTLS クライアント証明書とキー](/docs/ja/network-config#mtls-authentication) を再読み込みするのを停止するには `1` に設定します。リロードが無効な場合、Claude Code は設定を次に適用するか、次のスタートアップ時にのみ回転したファイルを読み込みます。Claude Code v2.1.232 以降が必要です |

268| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 自動更新、テレメトリ、エラー報告、`/feedback` コマンド、[Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)、リリースノート、[PR および MR ステータスバッジ](/docs/ja/interactive-mode#pr-review-status) チェック、[高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) チェックなどの可用性チェックなど、非必須ネットワークトラフィックを無効にするために、`1` などの空でない値に設定します。また、[プラグイン `command` ソースのバックグラウンド実行](/docs/ja/plugin-marketplaces#when-claude-code-re-runs-the-command) を停止します。これらはネットワークトラフィックではなくローカルコマンドですが、依存関係のインストールをトリガーできます。**`0` または `false` に設定してもこのトラフィックは無効になります**。ほとんどのオン/オフ変数とは異なり、変数を設定解除してそれを再度許可します。また、機能フラグ取得を無効にします。これにより、[リモートコントロール](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。公式プラグインマーケットプレイスの自動インストールはカバーされていません。`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` で無効にします。[ゲートウェイモデル検出](/docs/ja/llm-gateway-connect#add-gateway-models-to-the-model-picker) には影響しません。これには独自のオプトインがあります |268| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | 非必須ネットワークトラフィックを無効にするには、`1` などの空でない値に設定します：自動更新、テレメトリ、エラー報告、`/feedback` コマンド、[Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)、リリースノート、[PR および MR ステータスバッジ](/docs/ja/interactive-mode#pr-review-status) チェック、[高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) チェックなどの可用性チェック。また、[プラグイン `command` ソースのバックグラウンド実行](/docs/ja/plugin-marketplaces#when-claude-code-re-runs-the-command) を停止します。これらはネットワークトラフィックではなくローカルコマンドですが、依存関係のインストールをトリガーできます。**`0` または `false` に設定してもこのトラフィックは無効になります**。ほとんどのオン/オフ変数とは異なり、変数を設定解除してもう一度許可します。また、機能フラグ取得を無効にします。これにより、[Remote Control](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。公式プラグインマーケットプレイスの自動インストールはカバーされていません。`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` で無効にします。[ゲートウェイモデル検出](/docs/ja/llm-gateway-connect#add-gateway-models-to-the-model-picker) には影響しません。これには独自のオプトインがあります |

269| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | ストリーミングリクエストがストリーム中に失敗したときの非ストリーミングフォールバックを無効にするために `1` に設定します。ストリーミングエラーは再試行レイヤーに伝播します。プロキシまたはゲートウェイがフォールバックで重複したツール実行を生成する場合に役立ちます |269| `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK` | ストリーミングリクエストがストリーム中に失敗した場合の非ストリーミングフォールバックを無効にするには `1` に設定します。ストリーミングエラーは再試行レイヤーに伝播します。プロキシまたはゲートウェイがフォールバックで重複したツール実行を生成する場合に便利です |

270| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | ターミナルで入力または焦点を当てている間でも、`PushNotification` ツールのデスクトップ通知を送信するために `1` に設定します。デフォルトでは、ツールは最近のキーボード活動またはターミナルフォーカスを検出したときに、デスクトップ通知と [モバイルプッシュ](/docs/ja/remote-control#mobile-push-notifications) の両方をスキップします。この変数はそのローカルチェックのみを無効にするため、サーバーはアクティブなときにモバイルプッシュを抑制できます。Claude Code v2.1.193 以降が必要です |270| `CLAUDE_CODE_DISABLE_NOTIFICATION_PRESENCE_CHECK` | ターミナルで入力または焦点を当てている間でも、`PushNotification` ツールのデスクトップ通知を送信するには `1` に設定します。デフォルトでは、ツールは最近のキーボード活動またはターミナルフォーカスを検出すると、デスクトップ通知と [モバイルプッシュ](/docs/ja/remote-control#mobile-push-notifications) の両方をスキップします。この変数はそのローカルチェックのみを無効にするため、サーバーはアクティブであることを検出したときにモバイルプッシュを抑制できます。Claude Code v2.1.193 以降が必要です |

271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 公式プラグインマーケットプレイスの自動登録を無効にするために `1` に設定します。Claude Code はマーケットプレイスを登録しようとしているときに変数を読み取ります。通常、マシンの最初の対話的起動中です。その時点で変数が設定されている場合、Claude Code は登録を永続的にスキップします。後で変数を設定解除してもスキップは元に戻りません。`claude plugin marketplace add anthropics/claude-plugins-official` を実行して、いつでもマーケットプレイスを登録します |271| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 公式プラグインマーケットプレイスの自動登録を無効にするには `1` に設定します。Claude Code は通常、マシンの最初の対話的起動中にマーケットプレイスを登録しようとするときに変数を読み取ります。その時点で変数が設定されている場合、Claude Code は登録を永続的にスキップします。後で変数を設定解除してもスキップは元に戻りません。`claude plugin marketplace add anthropics/claude-plugins-official` を実行して、いつでもマーケットプレイスを登録します |

272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Claude Code が [未回答の権限リクエストの `Notification` フック](/docs/ja/hooks#notification) を実行するのを停止するために `1` に設定します。Claude Desktop および VS Code 拡張機能が Claude Code をホストするセッションでは、Claude Code がそれらを Agent SDK の `canUseTool` コールバックに送信します。ターミナルセッションには効果がありません。Claude Code v2.1.233 以降が必要です |272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Claude Code が [未回答の権限リクエストの `Notification` フック](/docs/ja/hooks#notification) を実行するのを停止するには `1` に設定します。Claude Desktop および VS Code 拡張機能が Claude Code をホストするセッションでは、Claude Code がそれらを Agent SDK の `canUseTool` コールバックに送信します。ターミナルセッションには効果がありません。Claude Code v2.1.233 以降が必要です |

273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | システム全体の管理スキルディレクトリからスキルを読み込むのをスキップするために `1` に設定します。管理されたスキルを読み込まないコンテナまたは CI セッションに役立ちます |273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | システム全体の管理スキルディレクトリからスキルを読み込むのをスキップするには `1` に設定します。オペレーター提供のスキルを読み込まないコンテナまたは CI セッションに便利です |

274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 会話コンテキストに基づいて自動ターミナルタイトル更新を無効にするために `1` に設定します。Agent SDK および `claude -p` セッションでは、これはセッションタイトルを生成するバックグラウンド小型/高速モデルリクエストもスキップします |274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 会話コンテキストに基づいた自動ターミナルタイトル更新を無効にするには `1` に設定します。これにより、[セッションタイトルを生成](/docs/ja/sessions#name-your-sessions) するバックグラウンド小型/高速モデルリクエストもスキップされます |

275| `CLAUDE_CODE_DISABLE_THINKING` | API リクエストから `thinking` パラメーターを完全に省略するために `1` に設定します。これはパラメーターを拒否するプロキシとゲートウェイの互換性オプションです。デフォルトで考えるモデルでは、パラメーターを省略してもモデルが考える可能性があります。Anthropic API で [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) を明示的に無効にするには、代わりに `MAX_THINKING_TOKENS=0` を使用します。どちらの変数も Fable モデルで思考をオフにしません。これは思考をオフにできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`MAX_THINKING_TOKENS=0` も同様にパラメーターを省略するため、2 つの変数は同じように動作します |275| `CLAUDE_CODE_DISABLE_THINKING` | API リクエストから `thinking` パラメーターを完全に省略するには `1` に設定します。これは、パラメーターを拒否するプロキシとゲートウェイの互換性オプションです。デフォルトで考えるモデルでは、パラメーターを省略してもモデルは考える可能性があります。Anthropic API で [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) を明示的に無効にするには、代わりに `MAX_THINKING_TOKENS=0` を使用します。どちらの変数も Opus 5.5 または Fable モデルで思考をオフにしません。これらは思考をオフにすることはできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`MAX_THINKING_TOKENS=0` も同様にパラメーターを省略するため、2 つの変数は同じように動作します |

276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Claude Code がモデル ID を認識しない場合（[LLM ゲートウェイ](/docs/ja/llm-gateway) エイリアスなど）、プロアクティブな [自動コンパクション](/docs/ja/costs#reduce-token-usage) をスキップするために `1` に設定します。この変数がない場合、Claude Code は ID に対して想定するコンテキストウィンドウでコンパクトします。`CLAUDE_CODE_MAX_CONTEXT_TOKENS` は想定されるウィンドウを修正できます。[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) で、各変数がいつ適用されるかを参照してください。Claude Code v2.1.223 以降が必要です |276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Claude Code がモデル ID を認識しない場合（[LLM ゲートウェイ](/docs/ja/llm-gateway) エイリアスなど）、プロアクティブな [自動圧縮](/docs/ja/costs#reduce-token-usage) をスキップするには `1` に設定します。この変数がない場合、Claude Code は ID に対して想定するコンテキストウィンドウで圧縮します。`CLAUDE_CODE_MAX_CONTEXT_TOKENS` は代わりに想定されるウィンドウを修正できます。各変数が適用される場合については、[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。Claude Code v2.1.223 以降が必要です |

277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | [フルスクリーンレンダリング](/docs/ja/fullscreen) で仮想スクロールを無効にし、トランスクリプト内のすべてのメッセージをレンダリングするために `1` に設定します。フルスクリーンモードでのスクロールがメッセージが表示されるべき場所に空白の領域を表示する場合に使用します |277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | [フルスクリーンレンダリング](/docs/ja/fullscreen) で仮想スクロールを無効にし、トランスクリプト内のすべてのメッセージをレンダリングするには `1` に設定します。フルスクリーンモードでのスクロールがメッセージが表示されるべき場所に空白の領域を表示する場合に使用します |

278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Windows で `cmd.exe` ランチャーを通じてではなく、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) コマンドを直接開始するために `1` に設定します。デフォルトでは、ランチャーは [バックグラウンドで実行](/docs/ja/tools-reference#background-commands) している PowerShell コマンドが [セッションの次のプロセスに引き継がれる](/docs/ja/agent-view#the-supervisor-process) ことを許可します。例えば、セッションを [バックグラウンド化](/docs/ja/agent-view#from-inside-a-session) するとき。変数を設定すると、バックグラウンド化された PowerShell コマンドはセッションのプロセスが終了するときに停止します。Bash コマンドは影響を受けません。Claude Code v2.1.269 以降が必要です |278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Windows で `cmd.exe` ランチャーを通さずに [PowerShell ツール](/docs/ja/tools-reference#powershell-tool) コマンドを直接開始するには `1` に設定します。デフォルトでは、ランチャーは [バックグラウンドで実行](/docs/ja/tools-reference#background-commands) している PowerShell コマンドが [セッションの次のプロセスに引き継がれる](/docs/ja/agent-view#the-supervisor-process) ようにします。例えば、[セッションをバックグラウンド化](/docs/ja/agent-view#from-inside-a-session) する場合。変数を設定すると、バックグラウンド化された PowerShell コマンドはセッションのプロセスが終了すると停止します。Bash コマンドは影響を受けません。Claude Code v2.1.269 以降が必要です |

279| `CLAUDE_CODE_DISABLE_WORKFLOWS` | [ワークフロー](/docs/ja/workflows#turn-workflows-off) を無効にするために `1` に設定します。[`disableWorkflows`](/docs/ja/settings-reference#disableworkflows) 設定と同等です |279| `CLAUDE_CODE_DISABLE_WORKFLOWS` | [ワークフロー](/docs/ja/workflows#turn-workflows-off) を無効にするには `1` に設定します。[`disableWorkflows`](/docs/ja/settings-reference#disableworkflows) 設定と同等です |

280| `CLAUDE_CODE_EFFORT_LEVEL` | サポートされているモデルの努力レベルを設定します。値：`low`、`medium`、`high`、`xhigh`、`max`、またはモデルのデフォルトを使用する `auto`。利用可能なレベルはモデルに依存します。`--effort`、`/effort`、および `modelSettings` および `effortLevel` 設定より優先されます。[`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) キャップは引き続き適用されます。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level) を参照してください |280| `CLAUDE_CODE_EFFORT_LEVEL` | サポートされているモデルの努力レベルを設定します。値：`low`、`medium`、`high`、`xhigh`、`max`、またはモデルのデフォルトを使用する `auto`。利用可能なレベルはモデルによって異なります。`--effort`、`/effort`、および `modelSettings` および `effortLevel` 設定より優先されます。[`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) キャップは引き続き適用されます。[努力レベルを調整](/docs/ja/model-config#adjust-effort-level) を参照してください |

281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 古いリリースとの互換性のために受け入れられ、効果がありません。自動モードは、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および署名済み [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway) セッションを含むすべてのプロバイダーでデフォルトで利用可能です。v2.1.158 ～ v2.1.206 では、これを `1` に設定して [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) をこれらのプロバイダーで利用可能にする必要がありました |281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 古いリリースとの互換性のために受け入れられ、効果がありません。自動モードはすべてのプロバイダーで利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および署名済み [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway) セッションを含みます。v2.1.158 ～ v2.1.206 では、これらのプロバイダーで [自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) を利用可能にするために `1` に設定する必要がありました |

282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [セッションリキャップ](/docs/ja/interactive-mode#session-recap) の可用性をオーバーライドします。`/config` トグルに関係なくリキャップを強制的にオフにするために `0` に設定します。[`awaySummaryEnabled`](/docs/ja/settings-reference#awaysummaryenabled) が `false` の場合、リキャップを強制的にオンにするために `1` に設定します。設定および `/config` トグルより優先されます |282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [セッションリキャップ](/docs/ja/interactive-mode#session-recap) の可用性をオーバーライドします。`/config` トグルに関係なく、リキャップを強制的にオフにするには `0` に設定します。[`awaySummaryEnabled`](/docs/ja/settings-reference#awaysummaryenabled) が `false` の場合、リキャップを強制的にオンにするには `1` に設定します。設定および `/config` トグルより優先されます |

283| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | バックグラウンドインストールが完了した後、[非対話モード](/docs/ja/headless) でターン境界でプラグイン状態をリフレッシュするために `1` に設定します。デフォルトではオフです。リフレッシュはセッション中にシステムプロンプトを変更するため、そのターンの [プロンプトキャッシング](/docs/ja/prompt-caching) を無効にします |283| `CLAUDE_CODE_ENABLE_BACKGROUND_PLUGIN_REFRESH` | バックグラウンドインストールが完了した後、[非対話モード](/docs/ja/headless) でターン境界でプラグイン状態をリフレッシュするには `1` に設定します。デフォルトではオフです。リフレッシュはセッション中にシステムプロンプトを変更するため、そのターンの [プロンプトキャッシング](/docs/ja/prompt-caching) が無効になります |

284| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Anthropic バウンドの非必須トラフィックがブロックされている場合、「Claude はどのように機能していますか？」セッション品質調査を独自の [OpenTelemetry コレクター](/docs/ja/monitoring-usage) にルーティングするために `1` に設定します。調査評価は OTEL イベントとしてのみ設定されたコレクターに発行されます。このモードでは、調査データは Anthropic に送信されません。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY`、または `DO_NOT_TRACK` が設定されている場合に適用され、それ以外の場合は効果がありません。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` および組織製品フィードバックポリシーが優先されます |284| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Anthropic バウンドの非必須トラフィックがブロックされている場合、「Claude はどのように機能していますか？」セッション品質調査を独自の [OpenTelemetry コレクター](/docs/ja/monitoring-usage) にルーティングするには `1` に設定します。調査の評価は、このモードでは OTEL イベントとしてのみ設定されたコレクターに発行されます。このモードでは、Anthropic にサーベイデータは送信されません。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、`DISABLE_TELEMETRY`、または `DO_NOT_TRACK` が設定されている場合に適用され、それ以外の場合は効果がありません。`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` および組織製品フィードバックポリシーが優先されます |

285| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | ツール呼び出し入力が Claude が生成するときに API からストリーミングするかどうかを制御します。これがオフの場合、長いファイル書き込みなどの大きなツール入力は、Claude がそれを生成した後にのみ到着します。これは、ハングしているように見える可能性があります。Anthropic API でデフォルトで有効になっています。Amazon Bedrock および Google Cloud の Agent Platform では、デプロイされたコンテナがサポートしている場合、モデルごとに有効になります。プロキシを通じてルーティングするときにオプトアウトするために `0` に設定します。`ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_BEDROCK_BASE_URL` を通じて。Microsoft Foundry および [ゲートウェイ](/docs/ja/llm-gateway) 接続ではデフォルトでオフです |285| `CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING` | ツール呼び出し入力が Claude が生成するときに API からストリーミングするかどうかを制御します。これがオフの場合、長いファイル書き込みなどの大きなツール入力は、Claude が生成を完了した後にのみ到着します。これは、ハングしているように見える可能性があります。Anthropic API でデフォルトで有効になっています。Amazon Bedrock および Google Cloud の Agent Platform では、デプロイされたコンテナがサポートしている場合、モデルごとに有効になります。プロキシを通じてルーティングする場合は `ANTHROPIC_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、または `ANTHROPIC_BEDROCK_BASE_URL` を通じて `1` に設定して強制的にオンにします。Microsoft Foundry および [ゲートウェイ](/docs/ja/llm-gateway) 接続ではデフォルトでオフです |

286| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL` が LiteLLM、Kong、または内部プロキシなどの Anthropic 互換ゲートウェイを指している場合、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーを設定するために `1` に設定します。デフォルトではオフです。共有 API キーでバックアップされたゲートウェイは、そうでなければすべてのユーザーにキーがアクセスできるすべてのモデルを表示するため。検出されたモデルは、セッションが受け取る [`availableModels`](/docs/ja/settings-reference#availablemodels) 許可リストでフィルタリングされます。[MDM または管理設定ファイル](/docs/ja/managed-settings#delivery-mechanisms) を通じてリストを配信します。[サーバー管理配信はゲートウェイ設定では利用できません](/docs/ja/server-managed-settings#platform-availability) |286| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | `ANTHROPIC_BASE_URL` が LiteLLM、Kong、または内部プロキシなどの Anthropic 互換ゲートウェイを指している場合、ゲートウェイの `/v1/models` エンドポイントから `/model` ピッカーを設定するには `1` に設定します。デフォルトではオフです。共有 API キーでバックアップされたゲートウェイは、キーがアクセスできるすべてのモデルをすべてのユーザーに表示するため。検出されたモデルは、セッションが受け取る [`availableModels`](/docs/ja/settings-reference#availablemodels) 許可リストでフィルタリングされます。[MDM または管理設定ファイル](/docs/ja/managed-settings#delivery-mechanisms) を通じてリストを配信します。[ゲートウェイ設定ではサーバー管理配信は利用できません](/docs/ja/server-managed-settings#platform-availability) |

287| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142 で削除されました。[高速モード](/docs/ja/fast-mode) のデフォルトが Opus 4.6 から Opus 4.7 に移動したとき |287| `CLAUDE_CODE_ENABLE_OPUS_4_7_FAST_MODE` | v2.1.142 で削除されました。[高速モード](/docs/ja/fast-mode) のデフォルトが Opus 4.6 から Opus 4.7 に移動したとき |

288| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | プロンプト入力に表示される灰色の予測であるプロンプト提案をオフにするために `false` に設定します。[`promptSuggestionEnabled`](/docs/ja/settings-reference#promptsuggestionenabled) 設定より優先されます。これは `/config` の **プロンプト提案** トグルが書き込むものです。Claude Code は [アカウントが使用制限に近いか達している場合、提案を一時停止](/docs/ja/interactive-mode#when-claude-code-skips-suggestions) します。制限に達するまでそれらをオンに保つために `true` に設定します。Claude Code v2.1.238 以降が必要です。[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions) を参照してください |288| `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION` | プロンプト入力に表示される灰色の予測であるプロンプト提案をオフにするには `false` に設定します。[`promptSuggestionEnabled`](/docs/ja/settings-reference#promptsuggestionenabled) 設定より優先されます。これは `/config` の **プロンプト提案** トグルが書き込むものです。Claude Code は [アカウントが使用制限に近い場合または達している場合、提案を一時停止](/docs/ja/interactive-mode#when-claude-code-skips-suggestions) します。制限に達するまでそれらをオンに保つには `true` に設定します。Claude Code v2.1.238 以降が必要です。[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions) を参照してください |

289| `CLAUDE_CODE_ENABLE_TASKS` | [タスクツールを持つセッション](/docs/ja/tools-reference#task-tool-availability) で Claude Code が提供するタスク追跡ツールを選択します。デフォルトでは、Claude Code は Task ツール `TaskCreate`、`TaskUpdate`、`TaskGet`、および `TaskList` を提供します。レガシー `TodoWrite` ツールを取得するために `0` に設定します。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |289| `CLAUDE_CODE_ENABLE_TASKS` | [タスク追跡ツール](/docs/ja/tools-reference#task-tool-availability) を持つセッションで Claude Code が提供するタスク追跡ツールを選択します。デフォルトでは、Claude Code は Task ツール `TaskCreate`、`TaskUpdate`、`TaskGet`、および `TaskList` を提供します。レガシー `TodoWrite` ツールを代わりに取得するには `0` に設定します。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |

290| `CLAUDE_CODE_ENABLE_TELEMETRY` | OpenTelemetry データ収集をメトリクスとログ用に有効にするために `1` に設定します。OTel エクスポーターを設定する前に必須です。[監視](/docs/ja/monitoring-usage) を参照してください |290| `CLAUDE_CODE_ENABLE_TELEMETRY` | OpenTelemetry データ収集をメトリクスとログ用に有効にするには `1` に設定します。OTel エクスポーターを設定する前に必須です。[監視](/docs/ja/monitoring-usage) を参照してください |

291| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | すべてのモデルでタスク追跡ツールを取得するために `1` に設定します。これがない場合、Claude Code はデフォルトでのみ [タスクツール可用性](/docs/ja/tools-reference#task-tool-availability) の下にリストされているモデルでそれらを提供します。`CLAUDE_CODE_ENABLE_TASKS` は引き続き Task ツールまたは `TodoWrite` を選択します。Claude Code v2.1.233 以降が必要です |291| `CLAUDE_CODE_ENABLE_TODO_TOOLS` | すべてのモデルでタスク追跡ツールを取得するには `1` に設定します。これがない場合、Claude Code はデフォルトでのみ [タスクツール可用性](/docs/ja/tools-reference#task-tool-availability) の下にリストされているモデルで提供します。`CLAUDE_CODE_ENABLE_TASKS` は引き続き Task ツールまたは `TodoWrite` を選択します。Claude Code v2.1.233 以降が必要です |

293| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [エージェントチーム](/docs/ja/agent-teams) を有効にするために `1` に設定します。エージェントチームは実験的で、デフォルトで無効になっています |293| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [エージェントチーム](/docs/ja/agent-teams) を有効にするには `1` に設定します。エージェントチームは実験的で、デフォルトで無効になっています |

294| `CLAUDE_CODE_EXTRA_BODY` | すべての API リクエスト本体のトップレベルにマージする JSON オブジェクト。Claude Code が直接公開しないプロバイダー固有のパラメーターを渡すのに役立ちます。シェルでエクスポートされた値は、`claude agents` または `--bg` でディスパッチする [バックグラウンドセッション](/docs/ja/agent-view) にも適用されます。v2.1.206 より前は、バックグラウンドセッションはシェルエクスポート値を無視し、バックグラウンドスーパーバイザープロセスが継承したコピーを使用していました |294| `CLAUDE_CODE_EXTRA_BODY` | すべての API リクエスト本体のトップレベルにマージする JSON オブジェクト。Claude Code が直接公開しないプロバイダー固有のパラメーターを渡すのに便利です。シェルでエクスポートされた値は、`claude agents` または `--bg` でディスパッチする [バックグラウンドセッション](/docs/ja/agent-view) にも適用されます。v2.1.206 より前は、バックグラウンドセッションはシェルエクスポート値を無視し、バックグラウンドスーパーバイザープロセスが継承したコピーを使用していました |

296| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | 別の Claude Code セッション内から起動された場合でも、トランスクリプト永続化、プロンプト履歴、および `claude agents` 登録を強制するために `1` に設定します。例えば、`screen` セッションまたは Claude Code の Bash ツールによって最初に開始されたバックグラウンドランチャーから継承された `CLAUDE_CODE_CHILD_SESSION` 値により、本物のトップレベルセッションが誤分類される場合に使用します。v2.1.178 以降、Claude Code は tmux ケースを自動的に検出し、継承されたマーカーを無視するため、tmux はこの変数を必要としなくなります。また、v2.1.169 以前で尊重されます。v2.1.170 および v2.1.171 では効果がありません。ネストされたセッション検出が削除されました |296| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | この `claude` が別の Claude Code セッション内から起動された場合でも、トランスクリプト永続化、プロンプト履歴、および `claude agents` 登録を強制するには `1` に設定します。例えば、`screen` セッションまたは Claude Code の Bash ツールによって最初に開始されたバックグラウンドランチャーから継承された `CLAUDE_CODE_CHILD_SESSION` 値が、本物のトップレベルセッションを入れ子として誤分類する場合に使用します。v2.1.178 以降、Claude Code は tmux ケースを自動的に検出し、継承されたマーカーを無視するため、tmux はもはやこの変数を必要としません。また、v2.1.169 以前で尊重されます。v2.1.170 および v2.1.171 では効果がありません。これらのバージョンでは、それがオーバーライドする入れ子セッション検出が削除されました |

297| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | ターミナルがサポートしているが自動検出されない場合（SSH 経由で `TERM_PROGRAM` が転送されていない場合など）、Claude の応答で `~~text~~` の取り消し線レンダリングを強制するために `1` に設定します。これがない場合、検出されないターミナルはリテラル `~~` マーカーを表示します。Claude Code v2.1.186 以降が必要です |297| `CLAUDE_CODE_FORCE_STRIKETHROUGH` | ターミナルがサポートしているが自動検出されない場合（SSH 経由で `TERM_PROGRAM` が転送されない場合など）、Claude の応答で `~~text~~` の取り消し線レンダリングを強制するには `1` に設定します。これがない場合、検出されないターミナルはリテラル `~~` マーカーを表示します。Claude Code v2.1.186 以降が必要です |

298| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | ターミナルがサポートしているが自動検出されない場合、DEC プライベートモード 2026 [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を強制的に有効にするために `1` に設定します。Emacs `eat` などの BSU/ESU を実装するが、機能プローブに応答しないエミュレーターに役立ちます。tmux では効果がありません。`CLAUDE_CODE_NO_FLICKER` とは異なり、[フルスクリーンレンダリング](/docs/ja/fullscreen) に切り替わらず、レンダラーを変更しません |298| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | ターミナルがサポートしているが自動検出されない場合、DEC プライベートモード 2026 [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を強制的に有効にするには `1` に設定します。Emacs `eat` などの BSU/ESU を実装するが機能プローブに応答しないエミュレーターに便利です。tmux では効果がありません。[フルスクリーンレンダリング](/docs/ja/fullscreen) に切り替わる `CLAUDE_CODE_NO_FLICKER` とは異なり、これはレンダラーを変更しません |

299| `CLAUDE_CODE_FORK_SUBAGENT` | [フォークモード](/docs/ja/sub-agents#turn-fork-mode-on-or-off) を制御します。これにより Claude は [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation) を自身で生成でき、対話セッションではデフォルトでオンです。`claude -p` および Agent SDK でもオンにするために `1` に設定するか、すべての種類のセッションでオフにするために `0` に設定します。フォークモードがオンかどうかに関係なく `/subtask` を実行できます。対話デフォルトには Claude Code v2.1.232 以降が必要です。以前のバージョンでは、フォークモードをオンにするために変数を `1` に設定します |299| `CLAUDE_CODE_FORK_SUBAGENT` | [フォークモード](/docs/ja/sub-agents#turn-fork-mode-on-or-off) を制御します。これにより Claude は [フォークされたサブエージェント](/docs/ja/sub-agents#fork-the-current-conversation) を自身で生成でき、対話セッションではデフォルトでオンです。`claude -p` および Agent SDK でもオンにするには `1` に設定するか、すべての種類のセッションでオフにするには `0` に設定します。フォークモードがオンかどうかに関係なく、`/subtask` を実行できます。対話デフォルトには Claude Code v2.1.232 以降が必要です。以前のバージョンでは、フォークモードをオンにするために変数を `1` に設定します |

300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | [`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) フラグと同じ動作である `claude -p --output-format stream-json` 出力で [サブエージェント](/docs/ja/sub-agents) テキストと思考ブロックを発行するために `1` に設定します。ハーネスが `claude` を呼び出し、フラグ自体を渡すことができない場合に変数を使用します。フラグとは異なり、非対話モードで stream-json 出力の外でエラーで終了しますが、変数はそこで無視されるため、ネストされた呼び出しは設定されたときに機能し続けます。Claude Code v2.1.211 以降が必要です |300| `CLAUDE_CODE_FORWARD_SUBAGENT_TEXT` | [サブエージェント](/docs/ja/sub-agents) テキストと思考ブロックを `claude -p --output-format stream-json` 出力で発行するには `1` に設定します。[`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) フラグと同じ動作。ハーネスが `claude` を呼び出し、フラグ自体を渡すことができない場合に変数を使用します。フラグとは異なり、非対話モードで stream-json 出力の外でエラーで終了しますが、変数はそこで無視されるため、ネストされた呼び出しはプロセス全体で設定されている場合も機能し続けます。Claude Code v2.1.211 以降が必要です |

301| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` がオンにする [ゲートウェイモデル検出](/docs/ja/llm-gateway-protocol#model-discovery) リクエストのタイムアウト（ミリ秒単位）（デフォルト：`3000`）。ゲートウェイが起動時に `/v1/models` に答えるのに 3 秒以上必要な場合は増加させます。プレーンな数字のみを受け入れます。`0`、負の値、その他の表記はデフォルトを保持します。Claude Code v2.1.269 以降が必要です |301| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | カスタムプロキシまたは Amazon Bedrock や Claude Platform on AWS などのサードパーティプロバイダーで [ゲートウェイヒントヘッダー](/docs/ja/llm-gateway-protocol#gateway-hint-headers)（`x-claude-code-request-class` や `x-claude-code-compaction` など）を送信するには `1` に設定します。Anthropic API への直接接続を含むすべての接続でそれらの送信を停止するには `0` に設定します。Claude Code はデフォルトで直接接続で送信します。Claude Code v2.1.273 以降が必要です |

302| `CLAUDE_CODE_GIT_BASH_PATH` | Windows のみ：Git Bash 実行可能ファイル（`bash.exe`）へのパス。Git Bash がインストールされているが PATH にない場合に使用します。パスが存在しないか、ファイルが `bash.exe`、`sh.exe`、`bash`、または `sh` という名前でない場合、Claude Code は変数を無視し、`--debug` で表示される警告をログして Git Bash を自動検出します。v2.1.219 より前は、パスが存在しない場合、Claude Code はスタートアップで終了し、bash または sh であることを確認せずに既存のファイルをシェルとして使用していました。[Windows セットアップ](/docs/ja/setup#set-up-on-windows) を参照してください |302| `CLAUDE_CODE_GATEWAY_MODEL_DISCOVERY_TIMEOUT_MS` | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` がオンにする [ゲートウェイモデル検出](/docs/ja/llm-gateway-protocol#model-discovery) リクエストのタイムアウト（ミリ秒単位）（デフォルト：`3000`）。ゲートウェイがスタートアップで `/v1/models` に答えるのに 3 秒以上必要な場合は増加させます。平文数字のみを受け入れます。`0`、負の値、その他のスペルはデフォルトを保持します。Claude Code v2.1.269 以降が必要です |

303| `CLAUDE_CODE_GLOB_HIDDEN` | Claude が [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) を呼び出すときに、結果からドットファイルを除外するために `false` に設定します。デフォルトで含まれます。`@` ファイルオートコンプリート、`ls`、Grep、または Read には影響しません |303| `CLAUDE_CODE_GIT_BASH_PATH` | Windows のみ：Git Bash 実行可能ファイル（`bash.exe`）へのパス。Git Bash がインストールされているが PATH にない場合に使用します。パスが存在しないか、ファイルが `bash.exe`、`sh.exe`、`bash`、または `sh` という名前でない場合、Claude Code は変数を無視し、設定されていない場合のように Git Bash を自動検出し、`--debug` で表示されるログに警告を記録します。v2.1.219 より前は、パスが存在しない場合、Claude Code はスタートアップで終了し、bash または sh であることを確認せずに既存のファイルをシェルとして使用していました。[Windows セットアップ](/docs/ja/setup#set-up-on-windows) を参照してください |

304| `CLAUDE_CODE_GLOB_NO_IGNORE` | [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) が `.gitignore` パターンを尊重するようにするために `false` に設定します。デフォルトでは、Glob は gitignored を含むすべての一致ファイルを返します。`@` ファイルオートコンプリートには影響しません。これには独自の [`respectGitignore` 設定](/docs/ja/settings-reference#respectgitignore) があります |304| `CLAUDE_CODE_GLOB_HIDDEN` | Claude が [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) を呼び出すときに、結果からドットファイルを除外するには `false` に設定します。デフォルトで含まれます。`@` ファイルオートコンプリート、`ls`、Grep、または Read には影響しません |

305| `CLAUDE_CODE_GLOB_NO_IGNORE` | [Glob ツール](/docs/ja/tools-reference#glob-tool-behavior) が `.gitignore` パターンを尊重するようにするには `false` に設定します。デフォルトでは、Glob は gitignored されたものを含むすべての一致ファイルを返します。`@` ファイルオートコンプリートには影響しません。これには独自の [`respectGitignore` 設定](/docs/ja/settings-reference#respectgitignore) があります |

306| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | バックグラウンド作業がアクティブなゴールを待機させることができる分数。Claude Code が [それをチェックするよう Claude に求める](/docs/ja/goal#background-work-defers-evaluation) 前。デフォルト `30`。チェックインをオフにするために `0` に設定します。平文の数字で全分を指定します。最大 `10080`（1 週間）。その他の値または表記は設定されていないものとして読み取られ、デフォルトを使用します。Claude Code v2.1.234 以降が必要です |307| `CLAUDE_CODE_GOAL_CHECKIN_MINUTES` | バックグラウンド作業がアクティブなゴールを待機させることができる分数。その後、Claude Code は [Claude にそれをチェックするよう要求](/docs/ja/goal#background-work-defers-evaluation) します。デフォルト `30`。チェックインをオフにするには `0` に設定します。平文数字で全分を指定します。最大 `10080`（1 週間）。その他の値またはスペルは設定されていないものとして扱われ、デフォルトが使用されます。Claude Code v2.1.234 以降が必要です |

308| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 拡張機能への接続に使用されるホストアドレスをオーバーライドします。デフォルトでは Claude Code は WSL-to-Windows ルーティングを含む正しいアドレスを自動検出します |309| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 拡張機能への接続に使用されるホストアドレスをオーバーライドします。デフォルトでは Claude Code は WSL-to-Windows ルーティングを含む正しいアドレスを自動検出します |

309| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | IDE 拡張機能の自動インストールをスキップするために `1` に設定します。[`autoInstallIdeExtension`](/docs/ja/settings-reference#autoinstallideextension) を `false` に設定することと同等です |310| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | IDE 拡張機能の自動インストールをスキップするには `1` に設定します。[`autoInstallIdeExtension`](/docs/ja/settings-reference#autoinstallideextension) を `false` に設定するのと同等です |

311| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent ツールが別のスポーンを拒否する前に、1 つのセッションで実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数（デフォルト：20）。平文の数字で正の整数を受け入れます。その他は無視されるため、変数はキャップを調整できますが、無効にはできません。Claude Code v2.1.217 以降が必要です |312| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | 1 つのセッションで実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数。Agent ツールが別のセッションを生成するのを拒否する前（デフォルト：20）。平文数字で正の整数を受け入れます。その他は無視されるため、変数は上限を調整できますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |

312| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルに対して想定するコンテキストウィンドウサイズをオーバーライドします。v2.1.193 以降、適用方法は Claude Code がモデル ID をどのように解決するかに依存します。[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。`ANTHROPIC_BASE_URL` を通じてモデルにルーティングする場合、コンテキストウィンドウが組み込みサイズと一致しない場合に使用します |313| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルに対して想定するコンテキストウィンドウサイズをオーバーライドします。v2.1.193 以降、それがどのように適用されるかは Claude Code がモデル ID をどのように解決するかに依存します。[ゲートウェイまたはカスタムモデル ID のウィンドウを修正](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。`ANTHROPIC_BASE_URL` を通じてモデルにルーティングする場合、その名前の組み込みサイズと一致しないコンテキストウィンドウを持つモデルの場合に使用します |

313| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトとキャップはモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。Claude Code はゲートウェイ固有の名前などの認識されないモデル ID に対して 32000 にデフォルト設定し、モデルのキャップを超える値をキャップに低下させます。この値を増加させると、[自動コンパクション](/docs/ja/costs#reduce-token-usage) がトリガーされる前に利用可能な有効なコンテキストウィンドウが減少します |314| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトと上限はモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。Claude Code は、ゲートウェイ固有の名前など、認識しないモデル ID に対して 32000 にデフォルト設定し、モデルの上限を超える値をモデルの上限に低下させます。この値を増加させると、[自動圧縮](/docs/ja/costs#reduce-token-usage) がトリガーされる前に利用可能な有効なコンテキストウィンドウが減少します |

314| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数をオーバーライドします（デフォルト：10）。v2.1.186 以降、15 でキャップされます。v2.1.199 以降、`CLAUDE_CODE_RETRY_WATCHDOG` はデフォルトを上げ、キャップを削除します。無人セッションがより長い停止を待つ必要がある場合は、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定します |315| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数をオーバーライドします（デフォルト：10）。v2.1.186 以降、15 でキャップされます。v2.1.199 以降、`CLAUDE_CODE_RETRY_WATCHDOG` はデフォルトを上げ、キャップを削除します。より長い停止を待つ必要がある無人セッションの場合は、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定します |

315| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削除され、現在は no-op です。以前は、Agent ツールで 1 つのセッションで Claude が生成できる [サブエージェント](/docs/ja/sub-agents) の総数をキャップしていました（デフォルト：200）。キャップを超えてスポーンすると、`Subagent spawn limit reached` で失敗しました。[同時サブエージェント制限](/docs/ja/sub-agents#concurrent-subagent-limit) および [深さ制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は引き続き適用されます |316| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削除され、現在は no-op です。以前は、1 つのセッションで Agent ツールを使用して Claude が生成できる [サブエージェント](/docs/ja/sub-agents) の総数をキャップしていました（デフォルト：200）。キャップを超えて生成すると、`Subagent spawn limit reached` で失敗しました。[同時サブエージェント制限](/docs/ja/sub-agents#concurrent-subagent-limit) および [深さ制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は引き続き適用されます |

316| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | メイン会話の下で許可される [サブエージェントレイヤー](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) の数（デフォルト：3）。デフォルトでは、サブエージェントは独自のサブエージェントを生成でき、3 番目のレイヤーのサブエージェントはさらに生成できません。ネストをオフにするために `1` に設定します。v2.1.217 ～ v2.1.218 では、デフォルトは 1 でした。サブエージェントは制限を上げない限り、独自のサブエージェントを生成できませんでした。v2.1.219 はデフォルトを 3 に上げました。平文の数字で正の整数を受け入れます。その他は無視されるため、制限を調整できますが、削除はできません。Claude Code v2.1.217 以降が必要です |317| `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` | メイン会話の下で許可される [サブエージェントレイヤー](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) の数（デフォルト：3）。デフォルトでは、サブエージェントは独自のサブエージェントを生成でき、3 番目のレイヤーのサブエージェントはさらに生成できません。ネストをオフにするには `1` に設定します。v2.1.217 ～ v2.1.218 では、デフォルトは 1 でした。サブエージェントは制限を上げない限り独自のサブエージェントを生成できませんでした。v2.1.219 はデフォルトを 3 に上げました。平文数字で正の整数を受け入れます。その他は無視されるため、制限を調整できますが、削除することはできません。Claude Code v2.1.217 以降が必要です |

318| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されない場合、エージェント的ターン数をキャップします。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を渡すことと同等です。両方が設定されている場合、フラグが優先されます。正の整数ではない値は、キャップなしとして扱われるのではなく、スタートアップでエラーで拒否されます |319| `CLAUDE_CODE_MAX_TURNS` | 明示的な制限が渡されない場合、エージェントターンの数をキャップします。[`--max-turns`](/docs/ja/cli-reference#cli-flags) を渡すのと同等です。両方が設定されている場合、フラグが優先されます。正の整数でない値は、キャップなしとして扱われるのではなく、スタートアップでエラーで拒否されます |

319| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | 1 つのセッションが実行できる [WebSearch](/docs/ja/tools-reference#websearch-tool-behavior) 呼び出しの総数のキャップ（デフォルト：200）。Claude がキャップに達すると、さらなる WebSearch 呼び出しは、既に収集した情報で続行するよう Claude に指示する通知を返します。上限なしで正の整数を受け入れます。その他は無視され、デフォルトが適用されるため、キャップを上げることはできますが、オフにはできません。Claude Code v2.1.212 以降が必要です |320| `CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION` | 1 つのセッションが実行できる [WebSearch](/docs/ja/tools-reference#websearch-tool-behavior) 呼び出しの総数のキャップ（デフォルト：200）。Claude がキャップに達すると、さらなる WebSearch 呼び出しは、既に収集した情報で続行するよう指示する通知を返します。上限なしで正の整数を受け入れます。その他は無視され、デフォルトが適用されるため、キャップを上げることはできますが、オフにすることはできません。Claude Code v2.1.212 以降が必要です |

321| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | MCP ツール呼び出しが [バックグラウンドタスク](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) に移動するまでの経過時間（ミリ秒単位）（デフォルト：120000、または 2 分）。自動バックグラウンド化をオフにするために `0` に設定します。Claude Code v2.1.212 以降が必要です |322| `CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS` | MCP ツール呼び出しが [バックグラウンドタスク](/docs/ja/mcp#automatic-backgrounding-of-long-tool-calls) に移動するまでの経過時間（ミリ秒単位）（デフォルト：120000、または 2 分）。自動バックグラウンド化をオフにするには `0` に設定します。Claude Code v2.1.212 以降が必要です |

322| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非対話](/docs/ja/headless) セッションの最初のターンが、デフォルト [最初のターン待機](/docs/ja/agent-sdk/mcp#connection-timing) の代わりに、まだ接続中の MCP サーバーを待つ時間（ミリ秒単位）。設定されている場合、待機はすべての保留中のサーバーをカバーします。待機をスキップするために `0` に設定します。[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) サーバーは、値に関係なく独自の `MCP_TIMEOUT` 待機を保持します。Claude Code v2.1.274 以降が必要です |323| `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` | [非対話](/docs/ja/headless) セッションの最初のターンが、まだ接続中の MCP サーバーを待機する時間（ミリ秒単位）。デフォルトの [最初のターン待機](/docs/ja/agent-sdk/mcp#connection-timing) の代わりに。設定されている場合、待機はすべての保留中のサーバーをカバーします。待機をスキップするには `0` に設定します。[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) サーバーは、値に関係なく独自の `MCP_TIMEOUT` 待機を保持します。Claude Code v2.1.274 以降が必要です |

323| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP ツール呼び出しのアイドルタイムアウト（ミリ秒単位）。stdio、HTTP、SSE、WebSocket、または [claude.ai コネクター](/docs/ja/mcp#use-mcp-servers-from-claude-ai) MCP サーバーがこの長さの間応答と進捗通知を送信しない場合、ツール呼び出しは全体的な `MCP_TOOL_TIMEOUT` を待つ代わりにエラーで中止されます。ネットワークサーバーの 300000（5 分）および stdio サーバーの 1800000（30 分）のトランスポートごとのデフォルトをオーバーライドします。アイドルチェックを無効にするために `0` に設定します。1000 未満の値は 1 秒に上げられ、値は有効な `MCP_TOOL_TIMEOUT` でキャップされます。`.mcp.json` の 1000 以上のサーバーごとの `timeout` は、そのサーバーのアイドルウィンドウを少なくとも `timeout` 値に上げます。IDE サーバーまたは SDK インプロセスサーバーには適用されません。Claude Code v2.1.187 以降が必要です。v2.1.203 より前は、stdio サーバーはアイドルタイムアウトから除外されていました |324| `CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` | MCP ツール呼び出しのアイドルタイムアウト（ミリ秒単位）。stdio、HTTP、SSE、WebSocket、または [claude.ai コネクター](/docs/ja/mcp#use-mcp-servers-from-claude-ai) MCP サーバーがこの長さの間応答と進捗通知を送信しない場合、ツール呼び出しは全体的な `MCP_TOOL_TIMEOUT` を待つ代わりにエラーで中止されます。ネットワークサーバーの 300000（5 分）および stdio サーバーの 1800000（30 分）のトランスポートごとのデフォルトをオーバーライドします。アイドルチェックを無効にするには `0` に設定します。1000 未満の値は 1 秒に上げられ、値は有効な `MCP_TOOL_TIMEOUT` でキャップされます。`.mcp.json` の少なくとも 1000 のサーバーごとの `timeout` は、そのサーバーのアイドルウィンドウを少なくとも `timeout` 値に上げます。IDE サーバーまたは SDK インプロセスサーバーには適用されません。Claude Code v2.1.187 以降が必要です。v2.1.203 より前は、stdio サーバーはアイドルタイムアウトから除外されていました |

324| `CLAUDE_CODE_MESSAGING_SOCKET` | Claude Code によって設定されます。あなたではなく：[インボックスソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバインドするセッションでは、Claude Code はそのソケットのパスをフックおよび Bash コマンドにエクスポートします。メッセージングがオンで開始するセッションでは、Claude Code はフックが実行される前にソケットをバインドします。マシン上の他のセッションはこのパスにメッセージを配信します。各セッションは親から継承されたものではなく、独自のソケットをエクスポートし、そのソケットに到着するメッセージはセッションの [インバウンドコントロール](/docs/ja/cross-session-messaging#control-inbound-messages) を通じて処理されます。設定 `env` ブロックはそれを設定できません。Claude Code v2.1.224 以降が必要です |325| `CLAUDE_CODE_MESSAGING_SOCKET` | Claude Code によって設定されます。あなたではなく：[インボックスソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバインドするセッションでは、Claude Code はそのソケットのパスをフックおよび Bash コマンドにエクスポートします。メッセージングがオンで開始するセッションでは、Claude Code はいずれかのフックが実行される前にソケットをバインドします。マシン上の他のセッションはこのパスにメッセージを配信します。各セッションは親から継承されたものではなく、独自のソケットをエクスポートし、それに到着するメッセージはセッションの [インバウンドコントロール](/docs/ja/cross-session-messaging#control-inbound-messages) を通じて処理されます。設定 `env` ブロックはそれを設定できません。Claude Code v2.1.224 以降が必要です |

325| `CLAUDE_CODE_MESSAGING_TOKEN` | Claude Code によって設定されます。あなたではなく：[インボックスソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバインドするセッションでは、Claude Code は `CLAUDE_CODE_MESSAGING_SOCKET` と一緒にこのセッションごとのトークンをフックおよび Bash コマンドにエクスポートします。ソケットに投稿するスクリプトは、`{"type":"auth","token":"<token>"}` を最初の行として送信して、セッションに属していることを証明できます。ネイティブ Windows では、Claude Code はこの行を必須とし、有効なものを開かない接続を閉じます。[独自の子ルール](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) は Claude Code がトークンを参照するときを示します。各セッションは親セッションから継承されたものではなく、独自のトークンをエクスポートします。設定 `env` ブロックはそれを設定できません。Claude Code v2.1.228 以降が必要です |326| `CLAUDE_CODE_MESSAGING_TOKEN` | Claude Code によって設定されます。あなたではなく：[インボックスソケット](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) をバインドするセッションでは、Claude Code は `CLAUDE_CODE_MESSAGING_SOCKET` と一緒にこのセッションごとのトークンをフックおよび Bash コマンドにエクスポートします。ソケットに投稿するスクリプトは、`{"type":"auth","token":"<token>"}` を最初の行として送信して、セッションに属していることを証明できます。ネイティブ Windows では、Claude Code はこの行を必須とし、有効なもので開かないすべての接続を閉じます。[独自の子ルール](/docs/ja/cross-session-messaging#the-sessions-inbox-socket) は Claude Code がトークンを参照するタイミングを示しています。各セッションは親セッションから継承されたものではなく、独自のトークンをエクスポートします。設定 `env` ブロックはそれを設定できません。Claude Code v2.1.228 以降が必要です |

327| `CLAUDE_CODE_NEW_INIT` | `/init` が対話的なセットアップフローを実行するようにするために `1` に設定します。フローは、CLAUDE.md、スキル、フックを含む、生成するファイルを尋ねてから、コードベースを探索して書き込みます。この変数がない場合、`/init` はプロンプトなしに CLAUDE.md を自動的に生成します |328| `CLAUDE_CODE_NEW_INIT` | `/init` が対話的なセットアップフローを実行するようにするには `1` に設定します。フローは、CLAUDE.md、スキル、フックを含む、生成するファイルを尋ねてから、コードベースを探索して書き込みます。この変数がない場合、`/init` はプロンプトなしで CLAUDE.md を自動的に生成します |

328| `CLAUDE_CODE_NONBLOCKING_STDOUT` | 2 番目の非ブロッキングファイル記述子を通じてターミナル出力を書き込むために `1` に設定します。読み取りを停止するターミナル（一時停止した tmux コントロールモードペインまたは停止した SSH 接続など）が Claude Code をセッション中にフリーズできません。stdout がターミナルの場合、macOS、Linux、WSL で適用されます。Claude Code v2.1.261 以降が必要です |329| `CLAUDE_CODE_NONBLOCKING_STDOUT` | 2 番目の非ブロッキングファイルディスクリプタを通じてターミナル出力を書き込むには `1` に設定します。読み取りを停止するターミナル（一時停止した tmux コントロールモードペインまたは停止した SSH 接続など）が Claude Code をセッション中にフリーズするのを防ぎます。stdout がターミナルの場合、macOS、Linux、WSL で適用されます。Claude Code v2.1.261 以降が必要です |

329| `CLAUDE_CODE_NO_FLICKER` | [フルスクリーンレンダリング](/docs/ja/fullscreen) を有効にするために `1` に設定します。長い会話でちらつきを減らし、メモリをフラットに保つ研究プレビュー。[`tui`](/docs/ja/settings-reference#tui) 設定をオーバーライドします。`/tui fullscreen` で切り替えることもできます |330| `CLAUDE_CODE_NO_FLICKER` | [フルスクリーンレンダリング](/docs/ja/fullscreen) を有効にするには `1` に設定します。ちらつきを減らし、長い会話でメモリをフラットに保つ研究プレビュー。[`tui`](/docs/ja/settings-reference#tui) 設定をオーバーライドします。`/tui fullscreen` で切り替えることもできます |

330| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定されている場合、`claude auth login` はブラウザーを開く代わりに、このトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必須です。自動化された環境での認証のプロビジョニングに役立ちます |331| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定されている場合、`claude auth login` はブラウザを開く代わりにこのトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必須です。自動化された環境での認証のプロビジョニングに便利です |

331| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンが発行された OAuth スコープ。スペース区切り。例：`"user:profile user:inference user:sessions:claude_code"`。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` が設定されている場合は必須です |332| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンが発行されたスペース区切りの OAuth スコープ。例えば `"user:profile user:inference user:sessions:claude_code"`。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` が設定されている場合は必須です |

332| `CLAUDE_CODE_OAUTH_TOKEN` | claude.ai 認証用の OAuth アクセストークン。SDK および自動化された環境の `/login` の代替。キーチェーン保存認証情報より優先されます。[`claude setup-token`](/docs/ja/authentication#generate-a-long-lived-token) で生成します。[`/login`](/docs/ja/authentication#authentication-precedence) を実行しない限り、Claude Code はセッション全体に設定したトークンを使用します。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動します |333| `CLAUDE_CODE_OAUTH_TOKEN` | claude.ai 認証用の OAuth アクセストークン。SDK および自動化された環境の `/login` の代替。キーチェーン保存の認証情報より優先されます。[`claude setup-token`](/docs/ja/authentication#generate-a-long-lived-token) で生成します。[`/login`](/docs/ja/authentication#authentication-precedence) を実行しない限り、Claude Code はセッション全体に設定したトークンを使用します。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動します |

333| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160 で削除され、現在は no-op です。以前は [高速モード](/docs/ja/fast-mode) を現在のデフォルトの代わりに Claude Opus 4.6 にピン留めしていました。Opus 4.6 はもはや高速モードをサポートしていません |334| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160 で削除され、現在は no-op です。以前は [高速モード](/docs/ja/fast-mode) を現在のデフォルトの代わりに Claude Opus 4.6 にピン留めしていました。Opus 4.6 はもはや高速モードをサポートしていません |

334| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツを含む OpenTelemetry 属性（モデル応答、ツールコンテンツ、システムプロンプト、生 API 本体）の最大長。切り詰めマーカーを含む。UTF-16 コード単位（デフォルト：61440、つまり 60 KB）。テレメトリバックエンドが 64 KB を超える属性値を受け入れる場合のみ上げるか、テレメトリボリュームを削減するために低下させます。Claude Code v2.1.214 以降が必要です。[監視](/docs/ja/monitoring-usage) を参照してください |335| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツを含む OpenTelemetry 属性（モデル応答、ツールコンテンツ、システムプロンプト、生 API 本体）の最大長。切り詰めマーカーを含む UTF-16 コード単位（デフォルト：61440、つまり 60 KB）。テレメトリバックエンドが 64 KB より大きい属性値を受け入れる場合のみ上げるか、テレメトリボリュームを削減するために低下させます。Claude Code v2.1.214 以降が必要です。[監視](/docs/ja/monitoring-usage) を参照してください |

335| `CLAUDE_CODE_OTEL_DIAG_STDERR` | OpenTelemetry エクスポーター診断エラーを stderr に書き込むために `1` に設定します。デフォルトでは、これらのエラーは `--debug` でのみ表示されるため、Prometheus ポート衝突などの設定ミスエクスポーターは、そうでなければ静かに失敗します。Claude Code v2.1.179 以降が必要です。[監視](/docs/ja/monitoring-usage) を参照してください |336| `CLAUDE_CODE_OTEL_DIAG_STDERR` | OpenTelemetry エクスポーター診断エラーを stderr に書き込むには `1` に設定します。デフォルトでは、これらのエラーは `--debug` でのみ表示されるため、Prometheus ポート衝突などの設定ミスエクスポーターはそれ以外の場合は静かに失敗します。Claude Code v2.1.179 以降が必要です。[監視](/docs/ja/monitoring-usage) を参照してください |

336| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 保留中の OpenTelemetry スパンをフラッシュするためのタイムアウト（ミリ秒単位）（デフォルト：5000）。[監視](/docs/ja/monitoring-usage) を参照してください |337| `CLAUDE_CODE_OTEL_FLUSH_TIMEOUT_MS` | 保留中の OpenTelemetry スパンをフラッシュするためのタイムアウト（ミリ秒単位）（デフォルト：5000）。[監視](/docs/ja/monitoring-usage) を参照してください |

337| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的 OpenTelemetry ヘッダーをリフレッシュするための間隔（ミリ秒単位）（デフォルト：1740000 / 29 分）。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers) を参照してください |338| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的 OpenTelemetry ヘッダーをリフレッシュするための間隔（ミリ秒単位）（デフォルト：1740000 / 29 分）。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers) を参照してください |

338| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | OpenTelemetry エクスポーターがシャットダウン時に完了するためのタイムアウト（ミリ秒単位）（デフォルト：2000）。メトリクスが終了時にドロップされる場合は増加させます。[監視](/docs/ja/monitoring-usage) を参照してください |339| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | シャットダウン時に OpenTelemetry エクスポーターが完了するためのタイムアウト（ミリ秒単位）（デフォルト：2000）。メトリクスが終了時にドロップされる場合は増加させます。[監視](/docs/ja/monitoring-usage) を参照してください |

339| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 新しいバージョンが利用可能な場合、Claude Code がバックグラウンドでパッケージマネージャーのアップグレードコマンドを実行できるようにするために `1` に設定します。Homebrew および WinGet インストールに適用されます。他のパッケージマネージャーは、実行せずにアップグレードコマンドを表示し続けます。[自動更新](/docs/ja/setup#auto-updates) を参照してください |340| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | 新しいバージョンが利用可能な場合、Claude Code がバックグラウンドでパッケージマネージャーのアップグレードコマンドを実行できるようにするには `1` に設定します。Homebrew および WinGet インストールに適用されます。他のパッケージマネージャーは、実行せずにアップグレードコマンドを表示し続けます。[自動更新](/docs/ja/setup#auto-updates) を参照してください |

340| `CLAUDE_CODE_PERFORCE_MODE` | Perforce 対応の書き込み保護を有効にするために `1` に設定します。設定されている場合、Edit、Write、NotebookEdit は、所有者書き込みビットがないターゲットファイルで失敗します。Perforce は同期されたファイルでこれをクリアするため、`p4 edit` がそれらを開くまで。これにより、Claude Code が Perforce 変更追跡をバイパスするのを防ぎます |341| `CLAUDE_CODE_PERFORCE_MODE` | Perforce 対応の書き込み保護を有効にするには `1` に設定します。設定されている場合、Edit、Write、および NotebookEdit は、所有者書き込みビットがないターゲットファイルで失敗します。Perforce は同期されたファイルでこれをクリアします。`p4 edit` がそれらを開くまで。これにより、Claude Code が Perforce 変更追跡をバイパスするのを防ぎます |

341| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | プラグインルートディレクトリをオーバーライドします。名前に反して、これは親ディレクトリを設定します：マーケットプレイスとプラグインキャッシュはこのパスの下のサブディレクトリに存在します。デフォルトは `~/.claude/plugins` です |342| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | プラグインルートディレクトリをオーバーライドします。名前に反して、これは親ディレクトリを設定します。マーケットプレイスとプラグインキャッシュはこのパスの下のサブディレクトリに存在します。デフォルトは `~/.claude/plugins` です |

342| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | プラグインをインストールまたは更新するときの git 操作のタイムアウト（ミリ秒単位）（デフォルト：120000）。大規模なリポジトリまたは遅いネットワーク接続の場合は、この値を増加させます。[Git 操作がタイムアウト](/docs/ja/plugin-marketplaces#git-operations-time-out) を参照してください |343| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | プラグインのインストールまたは更新時の git 操作のタイムアウト（ミリ秒単位）（デフォルト：120000）。大規模なリポジトリまたは遅いネットワーク接続の場合は、この値を増加させます。[Git 操作がタイムアウト](/docs/ja/plugin-marketplaces#git-operations-time-out) を参照してください |

343| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | マーケットプレイスリフレッシュがリモートに到達または認証できない場合、再複製を試みるのをスキップし、既存のマーケットプレイスチェックアウトを使用し続けるために `1` に設定します。オフラインまたはエアギャップ環境で役立ちます。再複製は同じ方法で失敗します。[マーケットプレイス更新がオフライン環境で失敗](/docs/ja/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) を参照してください |344| `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE` | マーケットプレイスリフレッシュがリモートに到達または認証できない場合、再複製試行をスキップし、既存のマーケットプレイスチェックアウトを使用し続けるには `1` に設定します。オフラインまたはエアギャップ環境で再複製が同じ方法で失敗する場合に便利です。[オフライン環境でのマーケットプレイス更新の失敗](/docs/ja/plugin-marketplaces#marketplace-updates-fail-in-offline-environments) を参照してください |

344| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` ショートハンドソースを SSH ではなく HTTPS 経由で複製するために `1` に設定します。プラグインのインストールと更新、および `/plugin marketplace add` と `update` に適用されます。CI ランナー、コンテナ、または `github.com` 用に設定された SSH キーがない環境で役立ちます |345| `CLAUDE_CODE_PLUGIN_PREFER_HTTPS` | GitHub `owner/repo` ショートハンドソースを SSH ではなく HTTPS 経由で複製するには `1` に設定します。プラグインのインストールと更新、および `/plugin marketplace add` と `update` に適用されます。CI ランナー、コンテナ、または `github.com` 用に設定された SSH キーがない環境で便利です |

345| `CLAUDE_CODE_PLUGIN_SEED_DIR` | 1 つ以上の読み取り専用プラグインシードディレクトリへのパス。Unix では `:` で、Windows では `;` で区切られます。事前に設定されたプラグインディレクトリをコンテナイメージにバンドルするために使用します。Claude Code はこれらのディレクトリからマーケットプレイスを登録し、再複製なしで事前キャッシュされたプラグインを使用します。[コンテナ用にプラグインを事前設定](/docs/ja/plugin-marketplaces#pre-populate-plugins-for-containers) を参照してください |346| `CLAUDE_CODE_PLUGIN_SEED_DIR` | `:` で Unix または `;` で Windows で区切られた、1 つ以上の読み取り専用プラグインシードディレクトリへのパス。これを使用して、事前に設定されたプラグインディレクトリをコンテナイメージにバンドルします。Claude Code はこれらのディレクトリからマーケットプレイスを登録し、再複製なしで事前キャッシュされたプラグインを使用します。[コンテナ用のプラグインを事前設定](/docs/ja/plugin-marketplaces#pre-populate-plugins-for-containers) を参照してください |

346| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | PowerShell をツール呼び出し、フック、ステータスラインコマンド用に生成するときに `-ExecutionPolicy Bypass` を渡すのを停止し、代わりにマシンの有効な実行ポリシーを尊重するために `1` に設定します。デフォルトでは Claude Code はプロセススコープで実行ポリシーをバイパスするため、`.ps1` スクリプトとモジュールインポートはデフォルト制限 Windows インストールで機能します。プロセススコープバイパスは、この設定に関係なく、グループポリシー `MachinePolicy` または `UserPolicy` をオーバーライドしません |347| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | ツール呼び出し、フック、ステータスラインコマンド用に PowerShell を生成するときに Claude Code が `-ExecutionPolicy Bypass` を渡すのを停止し、マシンの有効な実行ポリシーを尊重するには `1` に設定します。デフォルトでは Claude Code はプロセススコープで実行ポリシーをバイパスするため、`.ps1` スクリプトとモジュールインポートはデフォルト制限 Windows インストールで機能します。プロセススコープバイパスは、この設定に関係なく、グループポリシー `MachinePolicy` または `UserPolicy` をオーバーライドしません |

347| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | [非対話モード](/docs/ja/headless#background-tasks-at-exit) で `-p` フラグを使用した最終ターン後、バックグラウンドサブエージェントおよびワークフローのアイドル待機の上限（ミリ秒単位）。アイドル待機は、Claude がバックグラウンド結果を処理するためにターンを取るたびに再開されます。デフォルト：`600000`、または 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機を停止して終了します。無期限に待機するために `0` に設定します。このキャップは、プレーンバックグラウンドシェルに適用される 5 秒の猶予期間とは別です。Claude Code v2.1.182 以降が必要です |348| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | [非対話モード](/docs/ja/headless#background-tasks-at-exit) で `-p` フラグを使用した最終ターン後、バックグラウンドサブエージェントとワークフローを待機するアイドル待機の上限（ミリ秒単位）。アイドル待機は Claude がバックグラウンド結果を処理するターンを取るたびに再開されます。デフォルト：`600000`、または 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機を停止して終了します。`0` に設定して無期限に待機します。このキャップは、プレーンバックグラウンドシェルに適用される 5 秒の猶予期間とは別です。Claude Code v2.1.182 以降が必要です |

348| `CLAUDE_CODE_PROCESS_WRAPPER` | Claude Code が独自のバイナリから開始するプロセス（[エージェントビュー](/docs/ja/agent-view) セッションをホストするバックグラウンドサービスなど）を、`/opt/corp/launcher` などの argv プレフィックスとして指定されたコーポレートランチャーを通じて起動します。ユーザーまたは [管理設定](/docs/ja/managed-settings) の `env` ブロックで設定します。プロジェクトおよびローカル設定では設定できません。デタッチされたバックグラウンドサービスが継承するため。[`processWrapper` 設定](/docs/ja/settings-reference#processwrapper) と同等です。Claude Code v2.1.210 以降が必要です。この変数は両方が設定されている場合に優先されます。VS Code 拡張機能は `claudeProcessWrapper` 設定を通じて独自のランチャーを別途設定します。Windows では無視されます。[Claude Code をコーポレートランチャーの背後で実行](/docs/ja/corporate-launcher) で値の形式、ランチャーがカバーするもの、ランチャーが満たす必要があるコントラクトを参照してください。Claude Code v2.1.208 以降が必要です |349| `CLAUDE_CODE_PROCESS_WRAPPER` | Claude Code が独自のバイナリから開始するプロセス（[エージェントビュー](/docs/ja/agent-view) セッションをホストするバックグラウンドサービスなど）を、`/opt/corp/launcher` などの argv プレフィックスとして指定されたコーポレートランチャーを通じて起動します。ユーザーまたは [管理設定](/docs/ja/managed-settings) の `env` ブロックで設定します。プロジェクトおよびローカル設定では設定できません。デタッチされたバックグラウンドサービスがそれを継承するため。[`processWrapper` 設定](/docs/ja/settings-reference#processwrapper) と同等です。Claude Code v2.1.210 以降が必要です。この変数は両方が設定されている場合に優先されます。VS Code 拡張機能は `claudeProcessWrapper` 設定を通じて独自のランチャーを個別に設定します。Windows では無視されます。値の形式、ランチャーがカバーするもの、ランチャーが満たす必要があるコントラクトについては、[コーポレートランチャーの背後で Claude Code を実行](/docs/ja/corporate-launcher) を参照してください。Claude Code v2.1.208 以降が必要です |

349| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR` と一緒に設定して、Claude Code がそのセッションのトランスクリプトと自動メモリを保存する `projects/` ディレクトリ名を選択します。作業ディレクトリパスから派生したものの代わりに。例えば、`CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` で開始すると、`/srv/tenant-a/projects/work/` の下に保存されます。`CLAUDE_CONFIG_DIR` が設定されていない場合、Claude Code はこの変数を無視し、`claude` を開始する環境からのみ読み取ります。設定ファイル `env` ブロックからではなく。[プロジェクトディレクトリ名を自分で選択](/docs/ja/sessions#name-the-project-directory-yourself) を参照してください。Claude Code v2.1.234 以降が必要です |350| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR` と一緒に設定して、Claude Code がそのセッションのトランスクリプトと自動メモリを保存する `projects/` ディレクトリ名を選択します。作業ディレクトリパスから派生したものの代わりに。例えば、`CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` で開始すると、`/srv/tenant-a/projects/work/` の下に保存されます。`CLAUDE_CONFIG_DIR` が設定されていない場合、Claude Code はこの変数を無視し、`claude` を開始する環境からのみ読み取ります。設定ファイル `env` ブロックからは読み取りません。[プロジェクトディレクトリを自分で名前付け](/docs/ja/sessions#name-your-project-directory-yourself) を参照してください。Claude Code v2.1.234 以降が必要です |

350| `CLAUDE_CODE_PROMPT_CACHE_TTL` | メイン会話の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択するために `5m` または `1h` に設定します。対話的、`-p`、SDK ターン、およびそれらと一緒にインラインで実行されるヘルパー。\[`promptCacheTtl` 設定および `ENABLE_PROMPT_CACHING_1H` より優先されます。`FORCE_PROMPT_CACHING_5M` はそれをオーバーライドします。API は 1 時間キャッシュ書き込みをより高いレートで請求します。Claude Code v2.1.242 以降が必要です |351| `CLAUDE_CODE_PROMPT_CACHE_TTL` | `5m` または `1h` に設定します。Claude Code が受け入れる唯一の値。メイン会話の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択します：対話的、`-p`、SDK ターン、およびそれらと一緒に実行されるヘルパー。`promptCacheTtl` 設定および `ENABLE_PROMPT_CACHING_1H` より優先されます。`FORCE_PROMPT_CACHING_5M` がそれをオーバーライドします。API は 1 時間のキャッシュ書き込みをより高いレートで請求します。Claude Code v2.1.242 以降が必要です |

351| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | `ANTHROPIC_BASE_URL` がカスタムプロキシを指している場合、W3C トレースコンテキストを伝播するために `1` に設定します。伝播はモデルおよび HTTP MCP リクエストの `traceparent` ヘッダーと、Bash、PowerShell、フックサブプロセスの `TRACEPARENT` 環境変数をカバーします。デフォルトでは、伝播は Anthropic API に直接接続されている場合のみ有効になります。v2.1.152 で追加されました。[トレース（ベータ）](/docs/ja/monitoring-usage#traces-beta) を参照してください |352| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | `ANTHROPIC_BASE_URL` がカスタムプロキシを指している場合、W3C トレースコンテキストを伝播するには `1` に設定します。伝播はモデルおよび HTTP MCP リクエストの `traceparent` ヘッダーと、Bash、PowerShell、フックサブプロセスの `TRACEPARENT` 環境変数をカバーします。デフォルトでは、伝播は Anthropic API への直接接続に接続されている場合にのみ有効になります。v2.1.152 で追加されました。[トレース（ベータ）](/docs/ja/monitoring-usage#traces-beta) を参照してください |

352| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code を埋め込み、その代わりにモデルプロバイダーのルーティングを管理するホストプラットフォームによって設定されます。設定されている場合、Claude Code は `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` などの設定ファイルのプロバイダー選択、エンドポイント、認証変数を無視するため、ユーザー設定はホストのルーティングをオーバーライドできません。Claude Code は、[管理設定](/docs/ja/managed-settings) で配信されるどの管理ソースからでも、`model`、`fallbackModel`、`modelOverrides` などのモデル選択キーも無視するため、ホストのモデル設定は古い管理モデルピンより優先されます。Claude Code は、管理 `env` ブロックの `ANTHROPIC_MODEL` および `ANTHROPIC_DEFAULT_*_MODEL` ファミリーなどのモデル選択変数も無視します。管理設定の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストはホストが独自のものを提供しない限り引き続き適用されます。Claude Code は、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry などのサードパーティプロバイダーで通常適用される自動テレメトリオプトアウトをスキップするため、テレメトリは標準 `DISABLE_TELEMETRY` オプトアウトに従います。[API プロバイダーごとのデフォルト動作](/docs/ja/data-usage#default-behaviors-by-api-provider) を参照してください |353| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code をホストし、その代わりにモデルプロバイダーのルーティングを管理するホストプラットフォームによって設定されます。設定されている場合、Claude Code は `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` などの設定ファイルのプロバイダー選択、エンドポイント、認証変数を無視するため、ユーザー設定はホストのルーティングをオーバーライドできません。Claude Code は、[管理設定](/docs/ja/managed-settings) で配信されるマネージド設定ソースから、`model`、`fallbackModel`、`modelOverrides` などのモデル選択キーも無視するため、ホストのモデル設定は古い管理モデルピンより優先されます。Claude Code は、管理 `env` ブロックの `ANTHROPIC_MODEL` および `ANTHROPIC_DEFAULT_*_MODEL` ファミリーなどのモデル選択変数も無視します。管理設定の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストは、ホストが独自を提供しない限り、引き続き適用されます。Claude Code は、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry などのサードパーティプロバイダーで通常適用される自動テレメトリオプトアウトをスキップするため、テレメトリは標準 `DISABLE_TELEMETRY` オプトアウトに従います。[API プロバイダーごとのデフォルト動作](/docs/ja/data-usage#default-behaviors-by-api-provider) を参照してください |

354| `CLAUDE_CODE_REMOTE` | Claude Code が [クラウドセッション](/docs/ja/claude-code-on-the-web) として実行されている場合、自動的に `true` に設定されます。フックまたはセットアップスクリプトからこれを読み取って、クラウドセッションにいるかどうかを検出します |355| `CLAUDE_CODE_REMOTE` | Claude Code が [クラウドセッション](/docs/ja/claude-code-on-the-web) として実行されている場合、自動的に `true` に設定されます。フックまたはセットアップスクリプトからこれを読み取って、クラウドセッションにいるかどうかを検出します |

355| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/docs/ja/claude-code-on-the-web) で現在のセッション ID に自動的に設定されます。セッショントランスクリプトへのリンクを構築するために読み取ります。[出力をセッションにリンク](/docs/ja/cloud-environments#link-output-back-to-the-session) を参照してください |356| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/docs/ja/claude-code-on-the-web) で現在のセッション ID に自動的に設定されます。これを読み取ってセッショントランスクリプトへのリンクを構築します。[出力をセッションにリンク](/docs/ja/cloud-environments#link-output-back-to-the-session) を参照してください |

356| `CLAUDE_CODE_RESTRICTED` | `1` に設定して、[`--restricted`](/docs/ja/cli-reference#cli-flags) を渡すのと同じセッションを制限モードで開始します。Claude Code はこの変数を設定ファイルの `env` ブロックで無視します。Claude Code v2.1.248 以降が必要です |357| `CLAUDE_CODE_RESTRICTED` | セッションを制限モードで開始するには `1` に設定します。[`--restricted`](/docs/ja/cli-reference#cli-flags) を渡すのと同じです。Claude Code はこの変数を設定ファイルの `env` ブロックで無視します。Claude Code v2.1.248 以降が必要です |

357| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 前のセッションがターン中に終了した場合、自動的に再開するために `1` に設定します。SDK モードで使用されるため、モデルは SDK がプロンプトを再送信する必要なく続行します。これをオフにするには、変数を設定解除するか `0` に設定します。v2.1.221 より前は、Claude Code は `0` およびその他の falsy 値を無視し、非対話モードで再開をトリガーし、変数を設定解除することが唯一の方法でした |358| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 前のセッションがターン中に終了した場合、自動的に再開するには `1` に設定します。SDK モードで使用されるため、モデルは SDK がプロンプトを再送信する必要なく続行します。これをオフにするには、変数を設定解除するか `0` に設定します。v2.1.221 より前は、Claude Code は `0` およびその他の falsy 値を無視したため、非対話モードで再開をトリガーし、変数を設定解除することが唯一の方法でした |

358| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | ターン中に終了したセッションが再開時に自動的に続行するための最後のトランスクリプトメッセージの最大経過時間（ミリ秒単位）。最後のメッセージがこの境界より古い場合、Claude Code は `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 自動再開と注入された `CLAUDE_CODE_RESUME_PROMPT` 継続メッセージの両方をスキップし、セッションはアイドル状態で開始されるため、明示的に続行します。設定されていない場合または `0` は境界がないことを意味します。ただし、最後のリクエストが API エラーで失敗したターンは、そのエラーが 6 時間以内である間のみ再開されます。正の値はすべてのターンをバウンドします。負の値または非数値は 1 時間の境界を適用します。長時間実行されるエージェント用のスポーンスクリプトはこれを設定して、古いトランスクリプトに対する再起動が古いプロンプトを再実行しないようにできます。Claude Code は、[エージェントビュー](/docs/ja/agent-view) セッションがクラッシュして対話セッションから会話を継承した場合、1 時間の境界を自身で設定します。Claude Code v2.1.211 以降が必要です |359| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | ターン中に終了したセッションが自動的に再開するための最後のトランスクリプトメッセージの最大経過時間（ミリ秒単位）。最後のメッセージがこの境界より古い場合、Claude Code は `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` 自動再開と注入された `CLAUDE_CODE_RESUME_PROMPT` 継続メッセージの両方をスキップし、セッションはアイドル状態で開始されるため、明示的に続行します。設定解除または `0` は境界がないことを意味します。ただし、最後のリクエストが API エラーで失敗したターンは、そのエラーが 6 時間未満の間のみ再開されます。正の値はすべてのターンをバウンドします。負またはアルファベット値は 1 時間のバウンドを適用します。長時間実行されるエージェント用のスポーンスクリプトはこれを設定して、古いトランスクリプトに対する再開が古いプロンプトを再実行しないようにできます。Claude Code は、[エージェントビュー](/docs/ja/agent-view) セッションがクラッシュして対話セッションから会話を継承した場合、1 時間のバウンドを自身で設定します。Claude Code v2.1.211 以降が必要です |

359| `CLAUDE_CODE_RESUME_PROMPT` | ターン中に終了したセッションを再開するときに注入される継続メッセージをオーバーライドします。デフォルトは `Continue from where you left off.` です。長時間実行されるエージェント用のスポーンスクリプトはこれを、より指示的なブートメッセージに設定できます。空の文字列はデフォルトを使用します |360| `CLAUDE_CODE_RESUME_PROMPT` | ターン中に終了したセッションを再開するときに注入される継続メッセージをオーバーライドします。デフォルトは `Continue from where you left off.` です。長時間実行されるエージェント用のスポーンスクリプトはこれを、より指示的なブートメッセージに設定できます。空の文字列はデフォルトを使用します |

360| `CLAUDE_CODE_RETRY_WATCHDOG` | eval ハーネス、CI ジョブ、リモートワーカーなどの無人セッション用に `1` に設定します。`429` および `529` 容量エラーを `CLAUDE_CODE_MAX_RETRIES` 試行後に失敗する代わりに無期限に再試行します。Claude Code は、標準速度リクエストが支出制限またはクレジット使用済みを報告する `429` を取得すると直ちに失敗します。[ゲートウェイ支出キャップ](/docs/ja/errors#spend-limit-reached) からのリセットスケジュール付きのものでも。高速モードリクエストについては、[レート制限を処理](/docs/ja/fast-mode#handle-rate-limits) を参照してください。監視犬は試行間で最大 5 分バックオフするか、応答がレート制限リセット時間を報告する場合はリセット時間まで待機するため、使用制限に達したセッションは残りのウィンドウを待機します。v2.1.199 以降では、サーバーエラー、タイムアウト、ドロップされた接続などの他の一時的なエラーの既定再試行回数も上げられ、約 3 時間のバックオフに上げられ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合、15 のキャップが削除されます。Claude Code v2.1.186 以降が必要です |361| `CLAUDE_CODE_RETRY_WATCHDOG` | 評価ハーネス、CI ジョブ、リモートワーカーなどの無人セッション用に `1` に設定します。`429` および `529` 容量エラーを `CLAUDE_CODE_MAX_RETRIES` 試行後に失敗する代わりに無期限に再試行します。Claude Code は、標準速度リクエストが支出制限またはリソース使用クレジットを報告する `429` を取得すると直ちに失敗します。[ゲートウェイ支出キャップ](/docs/ja/errors#spend-limit-reached) からのリセットスケジュール。v2.1.239 より前は、監視犬はこれらを無期限に再試行していました。高速モードリクエストについては、[レート制限を処理](/docs/ja/fast-mode#handle-rate-limits) を参照してください。監視犬は試行間で最大 5 分までバックオフするか、応答がレート制限リセット時間を運ぶときにリセットが発生するまで待機するため、使用制限に達したセッションは残りのウィンドウを待機します。v2.1.199 以降では、サーバーエラー、タイムアウト、ドロップされた接続などの他の一時的なエラーのデフォルト再試行回数も上げられます。約 3 時間のバックオフに対して 300 に上げ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合、15 のキャップを削除します。Claude Code v2.1.186 以降が必要です |

361| `CLAUDE_CODE_SAFE_MODE` | セーフモードで開始するために `1` に設定します：CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインおよびファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。設定の破損をトラブルシューティングするため。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含む。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは読み込まれません。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を渡すことと同等です。直接生成された子プロセスは変数を継承します |362| `CLAUDE_CODE_SAFE_MODE` | セーフモードで開始するには `1` に設定します：CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインおよびファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。設定の破損をトラブルシューティングするため。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含みます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは読み込まれません。[`--safe-mode`](/docs/ja/cli-reference#cli-flags) を渡すのと同等です。直接生成された子プロセスは変数を継承します |

362| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合、セッションごとに特定のスクリプトを呼び出すことができる回数を制限する JSON オブジェクト。キーはコマンドテキストに対して一致するサブストリングです。値は整数呼び出し制限です。例えば、`{"deploy.sh": 2}` は `deploy.sh` を最大 2 回呼び出すことを許可します。マッチングはサブストリングベースであるため、`./scripts/deploy.sh $(evil)` などのシェル展開トリックはキャップに対してカウントされます。`xargs` または `find -exec` を通じたランタイムファンアウトは検出されません。これは深層防御コントロールです |363| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合、セッションごとに特定のスクリプトを呼び出すことができる回数を制限する JSON オブジェクト。キーはコマンドテキストに対して一致するサブストリングです。値は整数呼び出し制限です。例えば、`{"deploy.sh": 2}` は `deploy.sh` を最大 2 回呼び出すことができます。マッチングはサブストリングベースであるため、`./scripts/deploy.sh $(evil)` などのシェル展開トリックはキャップに対してカウントされます。`xargs` または `find -exec` を通じたランタイムファンアウトは検出されません。これは多層防御コントロールです |

363| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でマウスホイールスクロール乗数を設定します。`0.5` などの 1 未満の小数値を含む、最大 20 までの正の値を受け入れます。加速トラックパッドおよびホイールスクロールを遅くするため。ターミナルが既に増幅ホイールイベントを送信する場合は `3` に設定して `vim` と一致させます。JetBrains IDE ターミナルでは無視されます。Claude Code は独自のスクロール処理を使用します |364| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/docs/ja/fullscreen#mouse-wheel-scrolling) でマウスホイールスクロール乗数を設定します。1 未満の `0.5` などの小数値を含む、最大 20 までの正の値を受け入れます。加速トラックパッドおよびホイールスクロールを遅くするため。ターミナルが既にホイールイベントを増幅する場合。ターミナルが増幅なしで 1 ノッチあたり 1 つのホイールイベントを送信する場合は `3` に設定して `vim` と一致させます。JetBrains IDE ターミナルでは無視されます。Claude Code は独自のスクロール処理を使用します |

364| `CLAUDE_CODE_SEND_FEEDBACK` | セッションの [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) をオフにするために `0` に設定します。アカウントが既にアクセス権を持つ場所でオンにするために `1` に設定します。変数はアクセス権を付与できず、`DISABLE_FEEDBACK_COMMAND` および [`feedbackDrafts`](/docs/ja/settings-reference#feedbackdrafts) 設定の `off` 値などのフィードバックをオフにする他のスイッチは引き続き適用されます |365| `CLAUDE_CODE_SEND_FEEDBACK` | セッションの [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) をオフにするには `0` に設定します。アカウントが既にアクセス権を持っている場合、オンにするには `1` に設定します。変数はアクセス権を付与できず、`DISABLE_FEEDBACK_COMMAND` および [`feedbackDrafts`](/docs/ja/settings-reference#feedbackdrafts) 設定の `off` 値などのフィードバックをオフにする他のスイッチは引き続き適用されます |

365| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ja/hooks#sessionend) フックの時間予算をミリ秒単位でオーバーライドします。値は、独自の `timeout` を設定しないフックの各フックのタイムアウトでもあります。セッション終了、`/clear`、対話的 `/resume` を通じたセッション切り替えに適用されます。デフォルトでは予算は 1.5 秒です。設定ファイルで設定された最高のフックごとの `timeout` に自動的に上げられます。最大 60 秒。プラグイン提供フックのタイムアウトは予算を上げません |366| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/docs/ja/hooks#sessionend) フックの時間予算をミリ秒単位でオーバーライドします。値は、独自の `timeout` を設定しないフックのタイムアウトでもあります。セッション終了、`/clear`、および対話的な `/resume` を通じたセッション切り替えに適用されます。デフォルトでは予算は 1.5 秒で、設定ファイルで設定された最高のフックごとの `timeout` に自動的に上げられます。最大 60 秒。プラグイン提供フックのタイムアウトは予算を上げません |

366| `CLAUDE_CODE_SESSION_ID` | Bash および PowerShell ツールサブプロセス、[フックコマンド](/docs/ja/hooks) サブプロセス、stdio [MCP サーバー](/docs/ja/mcp) サブプロセスで現在のセッション ID に自動的に設定されます。Bash、PowerShell、フックの場合、これはフック JSON 入力の `session_id` フィールドと一致し、`/clear` で更新されます。MCP サーバーサブプロセスは、生成されたときに受け取った ID を保持します。`--resume <session-id>` では、再開された ID を受け取ります。`--continue` または明示的な ID なしで `--resume` では、初期スタートアップ ID を受け取る可能性があります。スクリプトおよび外部ツールを Claude Code セッションと関連付けるために使用します |367| `CLAUDE_CODE_SESSION_ID` | Bash および PowerShell ツールサブプロセス、[フックコマンド](/docs/ja/hooks) サブプロセス、stdio [MCP サーバー](/docs/ja/mcp) サブプロセスで現在のセッション ID に自動的に設定されます。Bash、PowerShell、フックの場合、これはフック JSON 入力の `session_id` フィールドと一致し、`/clear` で更新されます。MCP サーバーサブプロセスは、生成されたときに受け取った ID を保持します。`--resume <session-id>` では、再開された ID を受け取ります。`--continue` または明示的な ID なしで `--resume` では、初期スタートアップ ID を代わりに受け取る可能性があります。スクリプトと外部ツールを Claude Code セッションと関連付けるために使用します |

367| `CLAUDE_CODE_SHELL` | Claude Code が Bash ツールコマンドを実行するために使用するシェルを設定します。`/opt/homebrew/bin/bash` などの `bash` または `zsh` バイナリへのパスを受け入れます。`fish` などの他のシェルはサポートされていません。値が機能する `bash` または `zsh` パスでない場合、Claude Code はそれを無視し、自動検出にフォールバックします。自動検出は、`bash` または `zsh` を指している場合は `$SHELL` を使用します。そうでない場合は、`PATH` および標準インストール場所で見つかった最初の機能する `zsh` を選択し、次に `bash` を選択します |368| `CLAUDE_CODE_SHELL` | Claude Code が Bash ツールコマンドを実行するために使用するシェルを設定します。`/opt/homebrew/bin/bash` などの `bash` または `zsh` バイナリへのパスを受け入れます。`fish` などの他のシェルはサポートされていません。値が機能する `bash` または `zsh` パスでない場合、Claude Code はそれを無視し、自動検出にフォールバックします。自動検出は、`bash` または `zsh` を指す場合に `$SHELL` を使用します。そうでない場合は、`PATH` および標準インストール場所で見つかった最初の機能する `zsh` を選択してから `bash` を選択します |

368| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code が生成するシェルコマンドをラップするコマンドプレフィックス：Bash ツール呼び出し、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) スタートアップコマンド。PowerShell フックおよび exec フォームフックはプレフィックスなしで実行されます。ログまたは監査に役立ちます。`/path/to/logger.sh` などのベアの実行可能ファイルパスを設定すると、各コマンドが `/path/to/logger.sh '<command>'` として実行されます。ラッパーはコマンドラインを `$1` の単一シェルクォート引数として受け取るため、ラッパーは `$1` を `exec bash -c "$1"` などのシェルで再評価する必要があります。`$1` をベアの実行可能ファイルパスとして扱うと、`npx -y <package>` などの引数を渡す stdio MCP サーバーが破損します。Bash ツール呼び出しの場合、`$1` には Claude Code が組み立てる完全なシェル呼び出しが含まれます。環境セットアップを含む。コマンド Claude が実行したのみではなく |369| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code が生成するシェルコマンドをラップするコマンドプレフィックス：Bash ツール呼び出し、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) スタートアップコマンド。PowerShell フックおよび exec フォームフックはプレフィックスなしで実行されます。ログまたは監査に便利です。`/path/to/logger.sh` などのベアの実行可能ファイルパスを設定すると、各コマンドが `/path/to/logger.sh '<command>'` として実行されます。ラッパーはコマンドラインを `$1` の単一シェルクォート引数として受け取るため、ラッパーは `$1` を `exec bash -c "$1"` などのシェルで再評価する必要があります。`$1` をベアの実行可能ファイルパスとして扱うと、`npx -y <package>` などの引数を渡す stdio MCP サーバーが破損します。Bash ツール呼び出しの場合、`$1` には Claude Code が組み立てる完全なシェル呼び出しが含まれます。環境セットアップを含みます。Claude が実行したコマンドのみではありません |

369| `CLAUDE_CODE_SIMPLE` | 最小限のシステムプロンプトおよび Bash、ファイル読み取り、ファイル編集ツールのみで実行するために `1` に設定します。`--mcp-config` からの MCP ツールは引き続き利用可能です。フック、スキル、カスタムコマンド、サブエージェント、プラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出を無効にします。`--add-dir` で渡すディレクトリのスキルは引き続き読み込まれます。OAuth トークンおよびキーチェーン認証情報は読み取られないため、Anthropic 認証は `ANTHROPIC_API_KEY` または `--settings` の `apiKeyHelper` から取得する必要があります。[`--bare`](/docs/ja/headless#start-faster-with-bare-mode) を渡すことと同等です |370| `CLAUDE_CODE_SIMPLE` | 最小限のシステムプロンプトおよび Bash、ファイル読み取り、ファイル編集ツールのみで実行するには `1` に設定します。`--mcp-config` からの MCP ツールは引き続き利用可能です。フック、スキル、カスタムコマンド、サブエージェント、プラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出を無効にします。`--add-dir` で渡すディレクトリ内のスキルは引き続き読み込まれます。OAuth トークンおよびキーチェーン認証情報は読み取られないため、Anthropic 認証は `ANTHROPIC_API_KEY` または `--settings` の `apiKeyHelper` から取得する必要があります。[`--bare`](/docs/ja/headless#start-faster-with-bare-mode) を渡すのと同等です |

370| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 任意のモデルで短いシステムプロンプトおよび省略されたツール説明を使用するために `1` に設定します。実験またはサーバー設定がそれ以外で有効にする場合でも、オプトアウトするために `0`、`false`、`no`、または `off` に設定します。完全なツールセット、フック、MCP サーバー、CLAUDE.md 検出は有効なままです |371| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 任意のモデルで短いシステムプロンプトと省略されたツール説明を使用するには `1` に設定します。実験またはサーバー設定がそれ以外の場合有効にしても、オプトアウトするには `0`、`false`、`no`、または `off` に設定します。完全なツールセット、フック、MCP サーバー、CLAUDE.md 検出は有効なままです |

371| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のクライアント側認証をスキップします。ゲートウェイが自身でリクエストに署名する場合 |372| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のクライアント側認証をスキップします。ゲートウェイが自身でリクエストに署名する場合 |

372| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | AWS デフォルト認証情報プロバイダーチェーンから解決された認証情報のインプロセスキャッシュをオフにするために `1` に設定します。キャッシュがオフの場合、Claude Code はすべての API リクエストでチェーンを解決します。キャッシュがオフの場合、SSO バックアッププロファイルはすべてのリクエストで IAM Identity Center から認証情報をリクエストします。[認証情報キャッシングおよび解決タイムアウト](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout) を参照してください。Claude Code v2.1.207 以降が必要です |373| `CLAUDE_CODE_SKIP_AWS_CRED_CACHE` | AWS デフォルト認証情報プロバイダーチェーンから解決された認証情報のインプロセスキャッシュをオフにするには `1` に設定します。キャッシュがオフの場合、Claude Code はすべての API リクエストでチェーンを解決します。SSO バックアップされたプロファイルは、すべてのリクエストで IAM Identity Center から認証情報をリクエストします。[認証情報キャッシングおよび解決タイムアウト](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout) を参照してください。Claude Code v2.1.207 以降が必要です |

374| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | 失敗した [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックを利用可能として扱うために `1` に設定します。チェックの直接リクエストを `api.anthropic.com` にブロックするネットワークの場合。Claude Code は「組織によって無効化」応答を引き続き尊重します |375| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | 失敗した [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックを利用可能として扱うには `1` に設定します。チェックの直接リクエストを `api.anthropic.com` にブロックするネットワークの場合。Claude Code は「組織によって無効化」応答を引き続き尊重します |

375| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | クライアント側 [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックをスキップするために `1` に設定します。チェックのリクエストをインターセプトするプロキシの場合。API は、組織が高速モードを無効にしている場合、高速モードリクエストを引き続き拒否します |376| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | クライアント側 [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックをスキップするには `1` に設定します。プロキシがチェックのリクエストをリクエストを拒否する代わりに傍受する場合。API は、組織が高速モードを無効にしている場合、高速モードリクエストを引き続き拒否します |

376| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry の Azure 認証をスキップします。プロキシまたはゲートウェイが独自の `Authorization` ヘッダーを注入する場合。Claude Code は Azure 認証情報なしでリクエストを送信し、`ANTHROPIC_CUSTOM_HEADERS` を通じて提供されるものなど、提供する `Authorization` ヘッダーを保持します。`ANTHROPIC_FOUNDRY_API_KEY` または `ANTHROPIC_FOUNDRY_AUTH_TOKEN` が設定されている場合は無視されます。v2.1.203 より前は、この変数は API キーも設定されていない限り、Microsoft Foundry クライアントがリクエストを送信できないままにしました |377| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry の Azure 認証をスキップします。プロキシまたはゲートウェイが独自の `Authorization` ヘッダーを注入する場合。Claude Code は Azure 認証情報なしでリクエストを送信し、`Authorization` ヘッダーを保持します。例えば、`ANTHROPIC_CUSTOM_HEADERS` を通じて提供されるもの。`ANTHROPIC_FOUNDRY_API_KEY` または `ANTHROPIC_FOUNDRY_AUTH_TOKEN` が設定されている場合は無視されます。v2.1.203 より前は、この変数は API キーも設定されていない限り、Microsoft Foundry クライアントがリクエストを送信できないままにしました |

378| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | プロンプト履歴およびセッショントランスクリプトをディスクに書き込むのをスキップするために `1` に設定します。この変数で開始されたセッションは `--resume`、`--continue`、または上矢印履歴に表示されません。一時的なスクリプトセッションに役立ちます |379| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | プロンプト履歴とセッショントランスクリプトをディスクに書き込むのをスキップするには `1` に設定します。この変数で開始されたセッションは `--resume`、`--continue`、または上矢印履歴に表示されません。一時的なスクリプトセッションに便利です |

380| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `--output-format stream-json` で開始されたセッションが、スタートアップ失敗の場合、[Claude Code が開始を拒否した理由を名前付けする結果メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込むために `1` に設定します。それ以外の場合は stderr のみで終了します。Claude Code v2.1.274 以降が必要です |381| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `--output-format stream-json` で開始されたセッションが、スタートアップ失敗の場合、stderr のみで終了する代わりに [Claude Code が開始を拒否した理由を名前で示す結果メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込むようにするには `1` に設定します。Claude Code v2.1.274 以降が必要です |

381| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/ja/hooks#stop) または [SubagentStop](/docs/ja/hooks#subagentstop) フックがターンの終了をブロックできる最大連続回数。その後、Claude Code はそれをオーバーライドしてターンを終了します（デフォルト：8）。フックが正当に解決するのに必要な場合は `0` に設定して上限を無効にするか、上げます |382| `CLAUDE_CODE_STOP_HOOK_BLOCK_CAP` | [Stop](/docs/ja/hooks#stop) または [SubagentStop](/docs/ja/hooks#subagentstop) フックがターンの終了をブロックできる連続回数の最大値。その後、Claude Code はそれをオーバーライドしてターンを終了します（デフォルト：8）。フックが正当に解決するのに必要な場合は `0` に設定して上限を無効にするか、上げます |

382| `CLAUDE_CODE_SUBAGENT_MODEL` | [サブエージェント](/docs/ja/sub-agents#choose-a-model)、[エージェントチーム](/docs/ja/agent-teams#specify-teammates-and-models) チームメイト、別の方法でモデルが割り当てられていない [ワークフロー](/docs/ja/workflows) エージェントのデフォルトモデル。`haiku` などのエイリアスまたは完全なモデル名を受け入れます。2 つのソースがそれより優先されます：Claude がエージェントを生成するときに渡すモデル、およびエージェント定義の `model` フィールド（`inherit` を含む）。それを変更するには、[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ja/sub-agents#run-every-subagent-on-one-model) を設定します。完全な順序については [モデルを選択](/docs/ja/sub-agents#choose-a-model) を参照してください。`inherit` に設定することは、設定されていないままにすることと同じです。v2.1.251 より前は、この変数は呼び出しごとのモデルと定義の `model` フィールドの両方をオーバーライドしました |383| `CLAUDE_CODE_SUBAGENT_MODEL` | [サブエージェント](/docs/ja/sub-agents#choose-a-model)、[エージェントチーム](/docs/ja/agent-teams#specify-teammates-and-models) チームメイト、別の方法でモデルが割り当てられていない [ワークフロー](/docs/ja/workflows) エージェントのデフォルトモデル。`haiku` などのエイリアスまたは完全なモデル名を受け入れます。2 つのソースがそれより優先されます：Claude がエージェントを生成するときに渡すモデル、およびエージェント定義の `model` フィールド（`inherit` を含む）。それを変更するには、[`CLAUDE_CODE_SUBAGENT_MODEL_FORCE`](/docs/ja/sub-agents#run-every-subagent-on-one-model) を設定します。[モデルを選択](/docs/ja/sub-agents#choose-a-model) で完全な順序を参照してください。`inherit` に設定することは、設定解除するのと同じです。v2.1.251 より前は、この変数は呼び出しごとのモデルと定義の `model` フィールドの両方をオーバーライドしました |

383| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | サブエージェント、チームメイト、ワークフローエージェントに 1 つのモデルを強制するために `1` に設定します。[すべてのサブエージェントを 1 つのモデルで実行](/docs/ja/sub-agents#run-every-subagent-on-one-model) はそのモデルを示します。Claude Code v2.1.257 以降が必要です |384| `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` | サブエージェント、チームメイト、ワークフローエージェントに 1 つのモデルを強制するには `1` に設定します。[すべてのサブエージェントを 1 つのモデルで実行](/docs/ja/sub-agents#run-every-subagent-on-one-model) はそのモデルがどれであるかを示しています。Claude Code v2.1.257 以降が必要です |

384| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | メイン会話外のリクエスト（[サブエージェント](/docs/ja/sub-agents)、ワークフロー、バックグラウンド作業など）の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択するために `5m` または `1h` に設定します。`subagentPromptCacheTtl` 設定および `ENABLE_PROMPT_CACHING_1H` より優先されます。`FORCE_PROMPT_CACHING_5M` はそれをオーバーライドします。API は 1 時間キャッシュ書き込みをより高いレートで請求します。Claude Code v2.1.242 以降が必要です |385| `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` | `5m` または `1h` に設定します。Claude Code が受け入れる唯一の値。メイン会話外のリクエストの [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択します。[サブエージェント](/docs/ja/sub-agents)、ワークフロー、バックグラウンド作業など。`subagentPromptCacheTtl` 設定および `ENABLE_PROMPT_CACHING_1H` より優先されます。`FORCE_PROMPT_CACHING_5M` がそれをオーバーライドします。API は 1 時間のキャッシュ書き込みをより高いレートで請求します。Claude Code v2.1.242 以降が必要です |

385| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | サブプロセス環境から認証情報を削除するために `1` に設定します（Bash ツール、フック、MCP stdio サーバー）：Anthropic およびクラウドプロバイダー認証情報、Claude Code が認証情報として認識する他の変数、パッケージレジストリ URL に埋め込まれた認証情報。親 Claude プロセスはこれらの認証情報を API 呼び出し用に保持しますが、子プロセスは読み取ることができず、シェル展開を通じて秘密を流出させようとするプロンプトインジェクション攻撃への露出を減らします。v2.1.251 以降では、スクラブは Claude Code 独自の設定ストアポインター変数（`CLAUDE_CONFIG_DIR` など）も削除するため、子プロセスは再配置された設定ディレクトリを見つけることができません。子プロセスがこれらの変数を必要とする場合は、スクラブを設定されていないままにします。Linux では、これは Bash サブプロセスを分離された PID 名前空間で実行するため、`/proc` を通じてホストプロセス環境を読み取ることができません。副作用として、`ps`、`pgrep`、`kill` はホストプロセスを見たり、シグナルを送ったりできません。`allowed_non_write_users` が設定されている場合、`claude-code-action` はこれを自動的に設定します |386| `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` | サブプロセス環境から認証情報を削除するには `1` に設定します（Bash ツール、フック、MCP stdio サーバー）：Anthropic およびクラウドプロバイダー認証情報、Claude Code が認証情報として認識する他の変数、パッケージレジストリ URL に埋め込まれた認証情報。親 Claude プロセスはこれらの認証情報を API 呼び出しに保持しますが、子プロセスはそれらを読み取ることができず、シェル展開を通じてシークレットを流出させようとするプロンプトインジェクション攻撃への露出を減らします。v2.1.251 以降では、スクラブは Claude Code の独自の設定ストアポインター変数（`CLAUDE_CONFIG_DIR` など）も削除するため、子プロセスは再配置された設定ディレクトリを見つけることができません。サブプロセスがこれらの変数を必要とする場合は、スクラブを設定解除したままにします。Linux では、これは Bash サブプロセスを分離された PID 名前空間で実行するため、`ps`、`pgrep`、`kill` はホストプロセスを見たり、シグナルを送ったりすることができません。副作用として。`claude-code-action` は `allowed_non_write_users` が設定されている場合、これを自動的に設定します |

386| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード（`-p` フラグ）でプラグインインストールが最初のクエリの前に完了するのを待つために `1` に設定します。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンで利用できない可能性があります。`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせて待機をバウンドします |387| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード（`-p` フラグ）で、最初のクエリの前にプラグインインストールが完了するまで待機するには `1` に設定します。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンで利用できない可能性があります。`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせて待機をバウンドします |

387| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同期プラグインインストールのタイムアウト（ミリ秒単位）。超過すると、Claude Code はプラグインなしで進行し、エラーをログします。デフォルトなし：この変数がない場合、同期インストールは完了まで待機します |388| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同期プラグインインストールのタイムアウト（ミリ秒単位）。超過すると、Claude Code はプラグインなしで進行し、エラーをログに記録します。デフォルトなし：この変数がない場合、同期インストールは完了するまで待機します |

388| `CLAUDE_CODE_SYNC_SKILLS` | 非対話モード（`-p` フラグ）で Claude Code が claude.ai アカウント用に有効なスキルをダウンロードし、`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` まで最初のクエリの前にそれらのリストを待つために `1` に設定します。ダウンロード自体はバックグラウンドで完了し、Claude はスキルを呼び出すときにスキルのダウンロードを待ちます。claude.ai 認証が必要です。claude.ai アカウントでサインインするターミナルセッションは [これらのスキルをダウンロード](/docs/ja/skills#where-synced-skills-load) して `~/.claude/skills/synced/` に約 10 分ごとに再同期します。この変数なしで、`-p` 実行が最初のクエリでこれらのスキルを必要とする場合のみ設定します。v2.1.273 より前は、ターミナルセッションはこの変数が設定された `-p` 実行でのみダウンロードしました。`synced` フォルダ名は [このダウンロード用に予約されています](/docs/ja/skills#where-skills-live)。v2.1.227 より前は、スキルは `~/.claude/skills/` に直接ダウンロードされました。Claude Code は [ダウンロードされたスキルに追加ルール](/docs/ja/skills#how-synced-skills-behave) を適用します。例えば、マシンで `!` コマンドを実行しません |389| `CLAUDE_CODE_SYNC_SKILLS` | `-p` フラグを使用した非対話モードで、Claude Code が claude.ai アカウント用に有効なスキルをその実行でダウンロードし、`CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` まで最初のクエリの前にそれらのリストを待機するには `1` に設定します。ダウンロード自体はバックグラウンドで完了し、Claude はスキルを呼び出すときにそのスキルのダウンロードを待機します。claude.ai 認証が必要です。この変数なしで、claude.ai アカウントで署名したターミナルセッションは [これらのスキルをダウンロード](/docs/ja/skills#where-synced-skills-load) して `~/.claude/skills/synced/` に再同期し、約 10 分ごとに再同期します。`-p` 実行がその最初のクエリでスキルを必要とする場合にのみ設定します。v2.1.273 より前は、ターミナルセッションはこの変数セットで `-p` 実行でのみダウンロードしました。`synced` フォルダ名は [このダウンロード用に予約されています](/docs/ja/skills#where-skills-live)。v2.1.227 より前は、スキルは `~/.claude/skills/` に直接ダウンロードされました。Claude Code は [ダウンロードされたスキルに追加ルール](/docs/ja/skills#how-synced-skills-behave) を適用します。例えば、マシンで `!` コマンドを実行しません |

389| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | アプリが [Agent SDK](/docs/ja/agent-sdk/typescript#query-object) に基づいてスキルをリロードするときに実行される mid セッションスキル再同期のタイムアウト（ミリ秒単位）（デフォルト：30000）。超過すると、リロードは到着したスキルで続行され、残りのダウンロードはバックグラウンドで完了します |390| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | アプリが [Agent SDK](/docs/ja/agent-sdk/typescript#query-object) に基づいてスキルをリロードするときに実行される、セッション中のスキル再同期のタイムアウト（ミリ秒単位）（デフォルト：30000）。超過すると、リロードは到着したスキルで続行され、残りのダウンロードはバックグラウンドで完了します |

390| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合、最初のクエリが初期スキルリストを待つタイムアウト（ミリ秒単位）（デフォルト：5000）。超過すると、最初のクエリは到着したスキルで実行されます。ダウンロードはどちらの方法でもバックグラウンドで完了し、Claude はスキルを呼び出すときにスキルのダウンロードを待ちます |391| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合、最初のクエリが初期スキルリストを待機するタイムアウト（ミリ秒単位）（デフォルト：5000）。超過すると、最初のクエリは到着したスキルで実行されます。ダウンロードはどちらの方法でもバックグラウンドで完了し、Claude はスキルを呼び出すときにそのスキルのダウンロードを待機します |

391| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | diff 出力での構文強調表示を無効にするために `false` に設定します。色がターミナルセットアップに干渉する場合に役立ちます。コードブロックおよびファイルプレビューでの強調表示も無効にするには、[`syntaxHighlightingDisabled`](/docs/ja/settings-reference#syntaxhighlightingdisabled) 設定を使用します |392| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | diff 出力での構文強調表示を無効にするには `false` に設定します。色がターミナルセットアップに干渉する場合に便利です。コードブロックおよびファイルプレビューでの強調表示も無効にするには、[`syntaxHighlightingDisabled`](/docs/ja/settings-reference#syntaxhighlightingdisabled) 設定を使用します |

392| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有します。複数の Claude Code インスタンスで同じ ID を設定して、[タスクツールを持つセッション](/docs/ja/tools-reference#task-tool-availability) で共有タスクリストを調整します。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |393| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有します。複数の Claude Code インスタンスで同じ ID を設定して、[タスクツールを持つセッション](/docs/ja/tools-reference#task-tool-availability) で共有タスクリストを調整します。[タスクリスト](/docs/ja/interactive-mode#task-list) を参照してください |

393| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 非対話セッションが終了時に [エージェントチーム](/docs/ja/agent-teams) の破棄を完了するのを待つ時間（ミリ秒単位）をオーバーライドします。1000 ～ 60000 を受け入れます。範囲外の値は無視され、デフォルト 10000 が適用されます。Claude Code v2.1.206 以降が必要です |394| `CLAUDE_CODE_TEAM_TEARDOWN_PARK_TIMEOUT_MS` | 非対話セッションが終了時に [エージェントチーム](/docs/ja/agent-teams) の破棄を完了するまで待機する時間（ミリ秒単位）をオーバーライドします。1000 ～ 60000 を受け入れます。範囲外の値は無視され、デフォルト 10000 が適用されます。Claude Code v2.1.206 以降が必要です |

394| `CLAUDE_CODE_TMPDIR` | 内部一時ファイルに使用される一時ディレクトリをオーバーライドします。Claude Code は Unix で `/claude-{uid}/` を、Windows で `/claude/` をこのパスに追加します。デフォルト：macOS では `/tmp`、Linux および Windows では `os.tmpdir()`。macOS および Linux では、[サンドボックス化](/docs/ja/sandboxing) Bash サブプロセスは、オーバーライドが長いパスの場合、システムデフォルトの下で短いフォールバック `$TMPDIR` を受け取ります。一部のツールは一時パスが長すぎるときに失敗するため。サンドボックス化されていない Bash コマンドはシェルの `$TMPDIR` を変更されていない状態で継承します。Claude Code 独自の一時ファイルは常にオーバーライドを使用します。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |395| `CLAUDE_CODE_TMPDIR` | 内部一時ファイルに使用される一時ディレクトリをオーバーライドします。Claude Code は Unix で `/claude-{uid}/` を、Windows で `/claude/` をこのパスに追加します。デフォルト：macOS では `/tmp`、Linux および Windows では `os.tmpdir()`。macOS および Linux では、[サンドボックス化](/docs/ja/sandboxing) された Bash サブプロセスは、オーバーライドが長いパスの場合、システムデフォルトの下で短いフォールバック `$TMPDIR` を受け取ります。一部のツールは一時パスが長すぎるときに失敗するため。サンドボックス化されていない Bash コマンドは、設定されている場合、シェルの `$TMPDIR` を継承します。Claude Code の独自の一時ファイルは常にオーバーライドを使用します。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

395| `CLAUDE_CODE_TMUX_TRUECOLOR` | tmux 内で 24 ビット truecolor 出力を許可するために、`1` などの空でない値に設定します。**`0` または `false` に設定してもまだ truecolor を許可します**。ほとんどのオン/オフ変数とは異なり。256 色クランプを復元するために変数を設定解除します。デフォルトでは、`$TMUX` が設定されている場合、Claude Code は 256 色にクランプします。tmux は `set -ga terminal-overrides ',*:Tc'` を `~/.tmux.conf` に追加しない限り、truecolor エスケープシーケンスを通さないため。[ターミナル設定](/docs/ja/terminal-config) で他の tmux 設定を参照してください |396| `CLAUDE_CODE_TMUX_TRUECOLOR` | tmux 内で 24 ビット truecolor 出力を許可するには、`1` などの空でない値に設定します。**`0` または `false` に設定してもまだ truecolor を許可します**。ほとんどのオン/オフ変数とは異なり。256 色クランプを復元するには、変数を設定解除します。デフォルトでは、`$TMUX` が設定されている場合、Claude Code は 256 色にクランプします。tmux は `set -ga terminal-overrides ',*:Tc'` を `~/.tmux.conf` に追加しない限り、truecolor エスケープシーケンスを通さないため。[ターミナル設定](/docs/ja/terminal-config) で他の tmux 設定を参照してください |

396| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Linux および WSL では、Claude Code が [ツールメモリキャップから除外](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) するプロセスの種類のカンマ区切りリストに設定します。例えば `mcp` または `lsp`。すべての種類をキャップするために `none` に設定するか、Bash、PowerShell、Monitor ツールコマンドのみをキャップするために `all-new` に設定します。Claude Code は、リストするものに関係なく、Bash、PowerShell、Monitor ツールコマンドをキャップの下に保ちます。Claude Code v2.1.246 以降が必要です |397| `CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE` | Linux および WSL では、Claude Code が [ツールメモリキャップから除外](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) するプロセスの種類のカンマ区切りリストに設定します。例えば `mcp` または `lsp`。すべての種類をキャップするには `none` に設定するか、Bash、PowerShell、Monitor ツールコマンドのみをキャップするには `all-new` に設定します。Claude Code は、リストするものに関係なく、Bash、PowerShell、Monitor ツールコマンドをキャップの下に保ちます。Claude Code v2.1.246 以降が必要です |

397| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Linux および WSL では、[Bash および PowerShell ツールコマンドが使用できるメモリをキャップ](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) するために `4G` などのサイズに設定します。v2.1.246 以降の Monitor ツールコマンド。平文の数字で、単独でバイト数、または `K`、`M`、`G`、`T` サフィックス付きでサイズを書き込みます。キャップをオフにするために `0` または `off` に設定します。Claude Code が開始する最初のプロセスがキャップをオンまたはオフにした後、変更された値は次回 `claude` を起動するときに有効になります。Claude Code v2.1.233 以降が必要です |398| `CLAUDE_CODE_TOOL_MEMORY_LIMIT` | Linux および WSL では、[Bash および PowerShell ツールコマンドが使用できるメモリをキャップ](/docs/ja/tools-reference#memory-limit-on-linux-and-wsl) するには `4G` などのサイズに設定します。v2.1.246 以降の Monitor ツールコマンド。平文数字で、単独でバイト数、または `K`、`M`、`G`、`T` サフィックス付きでサイズを書き込みます。キャップをオフにするには `0` または `off` に設定します。Claude Code が開始する最初のプロセスがキャップをオンまたはオフにしたら、変更された値は次に `claude` を起動するときに有効になります。Claude Code v2.1.233 以降が必要です |

398| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code が [リモートコントロール](/docs/ja/remote-control) または SDK ホストなどのリモートクライアント、または [保持されたクロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages) の承認ダイアログに転送するダイアログをキャンセルするまでのミリ秒単位の期限。権限プロンプトおよび `AskUserQuestion` 質問は独自のフローを使用し、それによって管理されません。Claude Code v2.1.236 以降では、無人で実行される可能性があるセッションの mid セッション [Fable 使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits) もバウンドします。[インバウンドメッセージを制御](/docs/ja/cross-session-messaging#control-inbound-messages) および [非対話セッション](/docs/ja/cross-session-messaging#non-interactive-sessions) は、期限が適用されない場合を含む、完全な保持メッセージ有効期限ルールをカバーします。[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) 設定をオーバーライドします。`0` または負の値は期限を無効にします |399| `CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS` | Claude Code が [Remote Control](/docs/ja/remote-control) または SDK ホストなどのリモートクライアントに転送するダイアログ、または [保持されたクロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages) の承認ダイアログをキャンセルするまでのデッドライン（ミリ秒単位）。権限プロンプトおよび `AskUserQuestion` 質問は独自のフローを使用し、それによって管理されません。Claude Code v2.1.236 以降では、無人で実行されている可能性があるセッションの [Fable 使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits) 中期もバウンドします。[インバウンドメッセージを制御](/docs/ja/cross-session-messaging#control-inbound-messages) および [非対話セッション](/docs/ja/cross-session-messaging#non-interactive-sessions) は、デッドラインが適用されない場合を含む、完全な保持メッセージ有効期限ルールをカバーしています。[`dialogExpiry`](/docs/ja/settings-reference#dialogexpiry) 設定をオーバーライドします。`0` または負の値はデッドラインを無効にします |

403| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | ripgrep の代わりに Node.js ファイル API を使用してカスタムコマンド、サブエージェント、出力スタイルを検出するために `1` に設定します。バンドルされた ripgrep バイナリが利用できないか、環境でブロックされている場合に設定します。Grep またはファイル検索ツールには影響しません |404| `CLAUDE_CODE_USE_NATIVE_FILE_SEARCH` | Node.js ファイル API を使用してカスタムコマンド、サブエージェント、出力スタイルを検出するには `1` に設定します。バンドルされた ripgrep バイナリが利用できないか、環境でブロックされている場合に設定します。Grep またはファイル検索ツールには影響しません |

404| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell ツールを制御します。Git Bash がない Windows では、ツールは自動的に有効になります。無効にするために `0` に設定します。Git Bash がインストールされている Windows では、ツールは claude.ai および Console アカウントでデフォルトでオンです。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry セッションで有効にするために `1` に設定するか、オフにするために `0` に設定します。Linux、macOS、WSL では、有効にするために `1` に設定します。これには PATH に `pwsh` が必要です。Windows で有効にされている場合、Claude は Git Bash を通じてルーティングする代わりに PowerShell コマンドをネイティブに実行できます。[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) を参照してください |405| `CLAUDE_CODE_USE_POWERSHELL_TOOL` | PowerShell ツールを制御します。Git Bash がない Windows では、ツールは自動的に有効になります。無効にするには `0` に設定します。Git Bash がインストールされている Windows では、ツールは claude.ai および Console アカウントでデフォルトでオンです。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry セッションで有効にするには `1` に設定するか、オフにするには `0` に設定します。Linux、macOS、WSL では、有効にするには `1` に設定します。これには `pwsh` が `PATH` に必要です。Windows で有効にされている場合、Claude は Git Bash を通じてルーティングする代わりに PowerShell コマンドをネイティブに実行できます。[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) を参照してください |

406| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) が各フェッチされた URL の応答をキャッシュする時間（ミリ秒単位）に設定します。デフォルトは `900000`（15 分）です。平文の数字のみを受け入れます。`0`、小数、その他の表記はデフォルトを保持します。Claude Code は起動ごとに値を 1 回読み取るため、設定 `env` ブロックの変更は次回 `claude` を起動するときに適用されます。Claude Code v2.1.233 以降が必要です |407| `CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) が各フェッチされた URL の応答をキャッシュする時間（ミリ秒単位）に設定します。デフォルトは `900000`（15 分）です。平文数字のみを受け入れます。`0`、小数、その他のスペルはデフォルトを保持します。Claude Code は起動ごとに値を 1 回読み取るため、設定 `env` ブロックの変更は次に `claude` を起動するときに適用されます。Claude Code v2.1.233 以降が必要です |

407| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) がページのダウンロードを待つ時間の上限（ミリ秒単位）。フォローするリダイレクトを含みます。その時点までにダウンロードが完了していない場合、期限エラーで失敗します。デフォルトは `300000`（5 分）です。制限を削除するために `0` に設定します。平文の数字のみを受け入れます。小数またはその他の表記はデフォルトを保持します。Claude Code v2.1.268 以降が必要です |408| `CLAUDE_CODE_WEBFETCH_DEADLINE_MS` | [WebFetch](/docs/ja/tools-reference#webfetch-tool-behavior) がページのダウンロードを待機する時間（ミリ秒単位）の上限。リダイレクトを含みます。その時点までに完了していないダウンロードはデッドラインエラーで失敗します。デフォルトは `300000`（5 分）です。制限を削除するには `0` に設定します。平文数字のみを受け入れます。小数またはその他のスペルはデフォルトを保持します。Claude Code v2.1.268 以降が必要です |

408| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 単一 [ワークフロー](/docs/ja/workflows) 実行が一度に実行するエージェント数。`1` ～ `256`。デフォルトでは、実行は一度に最大 16 エージェントを実行します。Claude Code が利用可能な CPU が少ない場合は少なくなります。キューに入れられた `agent()` 呼び出しは無料スロットを待ちます。実行中の各エージェントのトランスクリプトは Claude Code のメモリに留まるため、より高い値はメモリ使用量を上げます。平文の数字のみを受け入れます。範囲外の値およびその他の表記はデフォルトを保持します。Claude Code v2.1.269 以降が必要です |409| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 単一 [ワークフロー](/docs/ja/workflows) 実行が一度に実行するエージェント数。`1` ～ `256`。デフォルトでは、実行は一度に最大 16 エージェントを実行します。Claude Code が利用可能な CPU が少ない場合は少なくなります。キューに入れられた `agent()` 呼び出しは無料スロットを待機します。実行中の各エージェントのトランスクリプトは Claude Code のメモリに留まるため、より高い値はメモリ使用量を上げます。平文数字のみを受け入れます。範囲外の値およびその他のスペルはデフォルトを保持します。Claude Code v2.1.269 以降が必要です |

409| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [ワークフロー](/docs/ja/workflows) エージェントが同じプレフィックスシブリングの最初の応答が開始されるのを待つ時間の上限（ミリ秒単位）。複数のエージェントが [プロンプトキャッシュプレフィックス](/docs/ja/workflows#prompt-caching-in-a-fan-out) を共有するファンアウトが開始されると、Claude Code はすべてのエージェント（最初のエージェント以外）を最大この長さ保持するため、残りはキャッシュされたプレフィックスを読み取ります。デフォルト `5000`。待機を無効にするために `0` に設定します。`DISABLE_PROMPT_CACHING` が設定されている場合、エージェントは待機しません。Claude Code v2.1.229 以降が必要です |410| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [ワークフロー](/docs/ja/workflows) エージェントが同じプレフィックスシブリングの最初の応答の開始を待機する時間（ミリ秒単位）の上限。複数のエージェントがファンアウトを開始し、[プロンプトキャッシュプレフィックス](/docs/ja/workflows#prompt-caching-in-a-fan-out) を共有する場合、Claude Code は最初のエージェント以外をこの長さまで保持するため、残りはキャッシュされたプレフィックスを読み取ります。各プロセスは未キャッシュで処理する代わりに。デフォルト `5000`。待機を無効にするには `0` に設定します。`DISABLE_PROMPT_CACHING` が設定されている場合、エージェントは待機しません。Claude Code v2.1.229 以降が必要です |

410| `CLAUDE_CONFIG_DIR` | 設定ディレクトリをオーバーライドします（デフォルト：`~/.claude`）。すべての設定、セッション履歴、プラグインはこのパスの下に保存されます。認証情報については、[Claude Code が認証情報を保存する場所](/docs/ja/authentication#credential-management) を参照してください。複数のアカウントを並行して実行するのに役立ちます。例えば、`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |411| `CLAUDE_CONFIG_DIR` | 設定ディレクトリをオーバーライドします（デフォルト：`~/.claude`）。すべての設定、セッション履歴、プラグインはこのパスの下に保存されます。認証情報については、[Claude Code が認証情報を保存する場所](/docs/ja/authentication#credential-management) を参照してください。複数のアカウントを並行して実行するのに便利です。例えば、`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

411| `CLAUDE_DISABLE_ADOPT` | `←` を押すか [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化するときに、進行中のバックグラウンド作業を実行し続ける代わりに停止するために `1` に設定します。Claude Code はバックグラウンド化する前に確認を求め、そうでなければ引き継がれるタスクを停止します。Claude Code v2.1.195 以降が必要です |412| `CLAUDE_DISABLE_ADOPT` | `←` を押すか [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンド化するときに、進行中のバックグラウンド作業を引き継ぐ代わりに停止するには `1` に設定します。Claude Code はバックグラウンド化する前に確認するよう求め、それ以外の場合は引き継がれるタスクを停止します。Claude Code v2.1.195 以降が必要です |

412| `CLAUDE_EFFORT` | サブプロセスが開始されるときに有効な [努力レベル](/docs/ja/model-config#adjust-effort-level) に Bash ツールサブプロセスおよびフックコマンドで自動的に設定されます：`low`、`medium`、`high`、`xhigh`、または `max`。Ultracode は個別のレベルではなく、`xhigh` として報告されます。[フック](/docs/ja/hooks) に渡される `effort.level` フィールドと一致します。現在のモデルが努力パラメーターをサポートする場合のみ設定されます |413| `CLAUDE_EFFORT` | サブプロセスが開始されるときに有効な [努力レベル](/docs/ja/model-config#adjust-effort-level) に Bash ツールサブプロセスおよびフックコマンドで自動的に設定されます：`low`、`medium`、`high`、`xhigh`、または `max`。Ultracode は個別のレベルではなく、`xhigh` として報告されます。[フック](/docs/ja/hooks) に渡される `effort.level` フィールドと一致します。現在のモデルが努力パラメーターをサポートする場合にのみ設定されます |

413| `CLAUDE_ENABLE_BYTE_WATCHDOG` | バイトレベルストリーミングアイドル監視犬を強制的に有効にするために `1` に設定するか、強制的に無効にするために `0` に設定します。`0` は、その期限が実行される接続の [最初バイト期限](/docs/ja/network-config#streaming-idle-watchdogs) もオフにします。設定されていない場合、監視犬は直接 Anthropic API および [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 接続でデフォルトで有効になり、`ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` を通じて到達した [ゲートウェイ](/docs/ja/gateways) 接続でのストリーミング応答でも有効になります。v2.1.222 より前は、これらのゲートウェイ接続では実行されず、イベントレベルの監視犬はそこでも keep-alive ping が到着している間にスタルを報告できました。タイムアウトおよびタイマーがどのように相互作用するかについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |414| `CLAUDE_ENABLE_BYTE_WATCHDOG` | バイトレベルストリーミングアイドル監視犬を強制的に有効にするには `1` に設定するか、強制的に無効にするには `0` に設定します。`0` は、その監視犬が実行される接続で [最初バイトデッドライン](/docs/ja/network-config#streaming-idle-watchdogs) もオフにします。設定されていない場合、監視犬は Anthropic API 直接接続および [Claude Platform on AWS](/docs/ja/claude-platform-on-aws) 接続でデフォルトで有効になり、`ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` を通じて到達した [ゲートウェイ](/docs/ja/gateways) 接続でのストリーミング応答の場合。v2.1.222 より前は、ゲートウェイ接続では実行されず、イベントレベルの監視犬はそこで keep-alive ping が到着している間でもスタルを報告できました。タイムアウトおよびタイマーがどのように相互作用するかについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |

414| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` 応答でバイトレベルストリーミングアイドル監視犬を有効にするために `1` に設定します。これは Bedrock ストリーミングリクエストの [最初バイト期限](/docs/ja/network-config#streaming-idle-watchdogs) も有効にします。デフォルトではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |415| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` 応答でバイトレベルストリーミングアイドル監視犬を有効にするには `1` に設定します。これは Bedrock ストリーミングリクエストで [最初バイトデッドライン](/docs/ja/network-config#streaming-idle-watchdogs) も有効にします。デフォルトではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |

415| `CLAUDE_ENABLE_STREAM_WATCHDOG` | イベントレベルストリーミングアイドル監視犬を強制的に無効にするために `0` に設定するか、強制的に有効にするために `1` に設定します。設定されていない場合、監視犬はすべてのプロバイダーでデフォルトでオンです。v2.1.196 より前は、設定されていないデフォルトは直接 Anthropic API でサーバー制御され、他のプロバイダーではオフでした。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します。他のスタルタイマーについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |416| `CLAUDE_ENABLE_STREAM_WATCHDOG` | イベントレベルストリーミングアイドル監視犬を強制的に無効にするには `0` に設定するか、強制的に有効にするには `1` に設定します。設定されていない場合、監視犬はすべてのプロバイダーでデフォルトでオンです。v2.1.196 より前は、設定されていないデフォルトは Anthropic API ではサーバー制御で、他のプロバイダーではオフでした。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します。他のスタルタイマーについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |

416| `CLAUDE_ENV_FILE` | シェルスクリプトへのパス。Claude Code は各 Bash コマンドの前に同じシェルプロセスで内容を実行するため、ファイルのエクスポートはコマンドに表示されます。virtualenv または conda アクティベーションをコマンド間で永続化するために使用します。また、[SessionStart](/docs/ja/hooks#persist-environment-variables)、[Setup](/docs/ja/hooks#setup)、[CwdChanged](/docs/ja/hooks#cwdchanged)、[FileChanged](/docs/ja/hooks#filechanged) フックによって動的に設定されます |417| `CLAUDE_ENV_FILE` | Claude Code が各 Bash コマンドの前に同じシェルプロセスで実行するシェルスクリプトへのパス。ファイルのエクスポートはコマンドに表示されます。virtualenv または conda アクティベーションをコマンド間で永続化するために使用します。また、[SessionStart](/docs/ja/hooks#persist-environment-variables)、[Setup](/docs/ja/hooks#setup)、[CwdChanged](/docs/ja/hooks#cwdchanged)、[FileChanged](/docs/ja/hooks#filechanged) フックによって動的に設定されます |

417| `CLAUDE_JOB_DIR` | Claude Code によって各 [バックグラウンドセッション](/docs/ja/agent-view) でそのセッションの `~/.claude/jobs/<id>` ディレクトリに設定されます。セッションが実行するシェルコマンドはそれを継承します。スクラッチファイルを [`$CLAUDE_JOB_DIR/tmp`](/docs/ja/agent-view#where-state-is-stored) に書き込みます。Claude の `Write` および `Edit` 呼び出しはそこで権限を求めず、セッションが削除されるとディレクトリが削除されます |418| `CLAUDE_JOB_DIR` | Claude Code によって各 [バックグラウンドセッション](/docs/ja/agent-view) でそのセッションの `~/.claude/jobs/<id>` ディレクトリに設定されます。セッションが実行するシェルコマンドはそれを継承します。スクラッチファイルを [`$CLAUDE_JOB_DIR/tmp`](/docs/ja/agent-view#where-state-is-stored) に書き込みます。Claude の `Write` および `Edit` 呼び出しはそこで権限を求めません。ディレクトリはセッションが削除されるときに削除されます |

418| `CLAUDE_PID` | Claude Code は、生成するサブプロセスで独自のプロセス ID に設定します：Bash および PowerShell ツールコマンドおよびフックコマンド。Linux では、Bash ツールのシェル統合はそれを使用して、Claude Code プロセス自体と一致する `pkill` パターンを拒否します。[エラーリファレンス](/docs/ja/errors#pkill-pattern-matches-the-claude-code-process) を参照してください。独自のスクリプトから読み取って、親 Claude Code プロセスを意図的に識別またはシグナルします。Claude Code v2.1.214 以降が必要です |419| `CLAUDE_PID` | Claude Code はこれを生成するサブプロセスで独自のプロセス ID に設定します：Bash および PowerShell ツールコマンドおよびフックコマンド。Linux では、Bash ツールのシェル統合はそれを使用して、Claude Code プロセス自体と一致する `pkill` パターンを拒否します。[エラーリファレンス](/docs/ja/errors#pkill-pattern-matches-the-claude-code-process) を参照してください。独自のスクリプトからそれを読み取って、親 Claude Code プロセスを意図的に識別またはシグナルします。Claude Code v2.1.214 以降が必要です |

419| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が提供されない場合、自動生成 [リモートコントロール](/docs/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` などの名前を生成します。`--remote-control-session-name-prefix` CLI フラグは単一呼び出しに同じ値を設定します |420| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が提供されない場合、自動生成された [Remote Control](/docs/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` などの名前を生成します。`--remote-control-session-name-prefix` CLI フラグは単一呼び出しに同じ値を設定します |

420| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | ストリーミングリクエストの最初の応答バイトの期限（ミリ秒単位）。[最初バイト期限](/docs/ja/network-config#streaming-idle-watchdogs) が実行される接続で。Claude Code がそれをクランプする方法、大きなリクエスト本体に追加する追加時間、設定されていない場合に期限を選択する方法については、[API からの応答がない](/docs/ja/errors#no-response-from-api) を参照してください。Claude Code v2.1.242 以降が必要です |421| `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` | ストリーミングリクエストの最初の応答バイトのデッドライン（ミリ秒単位）。[最初バイトデッドライン](/docs/ja/network-config#streaming-idle-watchdogs) が実行される接続で。Claude Code がそれをクランプする方法、大きなリクエスト本体に追加する追加時間、設定されていない場合にデッドラインを選択する方法については、[API からの応答がない](/docs/ja/errors#no-response-from-api) を参照してください。Claude Code v2.1.242 以降が必要です |

421| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | イベントおよびバイトレベルストリーミングアイドル監視犬が停止した接続を閉じるまでのミリ秒単位のタイムアウト。この変数を明示的に設定すると、最小値は `300000`（5 分）です。低い値は拡張思考の一時停止とプロキシバッファリングを吸収するために静かにクランプされ、バイトレベルの監視犬は値を 30 分でキャップします。`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` はバイトレベルの監視犬に対してこの変数より優先されます。監視犬ごとの設定されていないデフォルトについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |422| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | イベントおよびバイトレベルストリーミングアイドル監視犬が停止した接続を閉じるまでのタイムアウト（ミリ秒単位）。この変数を明示的に設定すると、最小値は `300000`（5 分）です。低い値は拡張思考の一時停止とプロキシバッファリングを吸収するために静かにクランプされ、バイトレベルの監視犬は値を 30 分でキャップします。`CLAUDE_BYTE_STREAM_IDLE_TIMEOUT_MS` はバイトレベルの監視犬でこの変数より優先されます。監視犬ごとの設定されていないデフォルトについては、[ストリーミングアイドル監視犬](/docs/ja/network-config#streaming-idle-watchdogs) を参照してください |

422| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | v2.1.260 で削除され、現在は no-op です。以前は [バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands) が [サブエージェント](/docs/ja/sub-agents) が開始できる実行時間をキャップしていました。ミリ秒単位。60 分のデフォルト。[バックグラウンドコマンド生涯ルール](/docs/ja/tools-reference#background-commands) を参照してください |423| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | v2.1.260 で削除され、現在は no-op です。以前は、[サブエージェント](/docs/ja/sub-agents) が開始した [バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands) が実行できる最大時間（ミリ秒単位）をキャップしていました。デフォルト 60 分。[バックグラウンドコマンドライフタイムルール](/docs/ja/tools-reference#background-commands) を参照してください |

423| `DEBUG` | デバッグモードを有効にするために `1` に設定します。[`--debug`](/docs/ja/cli-reference#cli-flags) で起動することと同等です。デバッグログは `~/.claude/debug/<session-id>.txt` または `CLAUDE_CODE_DEBUG_LOGS_DIR` で設定されたパスに書き込まれます。`DEBUG=express:*` などの名前空間パターンは他のツール用に設定されるため、`1`、`true`、`yes`、`on` のみの truthy 値がデバッグモードを有効にします。それはトリガーしません |424| `DEBUG` | デバッグモードを有効にするには `1` に設定します。[`--debug`](/docs/ja/cli-reference#cli-flags) で起動するのと同等です。デバッグログは `~/.claude/debug/<session-id>.txt` または `CLAUDE_CODE_DEBUG_LOGS_DIR` で設定されたパスに書き込まれます。`1`、`true`、`yes`、`on` の truthy 値のみがデバッグモードを有効にするため、`DEBUG=express:*` などの他のツール用に設定された名前空間パターンはそれをトリガーしません |

424| `DISABLE_AUTOUPDATER` | 自動バックグラウンド更新を無効にするために `1` に設定します。手動 `claude update` は引き続き機能します。ブロック両方を更新するために `DISABLE_UPDATES` を使用します |425| `DISABLE_AUTOUPDATER` | 自動バックグラウンド更新を無効にするには `1` に設定します。手動 `claude update` は引き続き機能します。両方をブロックするには `DISABLE_UPDATES` を使用します |

425| `DISABLE_AUTO_COMPACT` | コンテキスト制限に近づくときの自動コンパクションを無効にするために `1` に設定します。手動 `/compact` コマンドは利用可能なままです。コンパクションが発生するときに明示的な制御が必要な場合に使用します。[`autoCompactEnabled`](/docs/ja/settings-reference#autocompactenabled) 設定をオーバーライドします |426| `DISABLE_AUTO_COMPACT` | コンテキスト制限に近づくときの自動圧縮を無効にするには `1` に設定します。手動 `/compact` コマンドは利用可能なままです。圧縮が発生するタイミングを明示的に制御する場合に使用します。[`autoCompactEnabled`](/docs/ja/settings-reference#autocompactenabled) 設定をオーバーライドします |

428| `DISABLE_DOCTOR_COMMAND` | [`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップスキルおよびその `/checkup` エイリアスを非表示にするために `1` に設定します。ユーザーがセッションからセットアップ診断を実行すべきでない管理デプロイメントに役立ちます。`claude doctor` ターミナルコマンドには影響しません。v2.1.205 より前は、この変数は `/doctor` 診断スクリーンコマンドを非表示にしました |429| `DISABLE_DOCTOR_COMMAND` | [`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップスキルとその `/checkup` エイリアスを非表示にするには `1` に設定します。ユーザーがセッションからセットアップ診断を実行しないようにする管理デプロイメントに便利です。`claude doctor` ターミナルコマンドには影響しません。v2.1.205 より前は、この変数は `/doctor` 診断スクリーンコマンドを非表示にしました |

429| `DISABLE_ERROR_REPORTING` | エラー報告をオプトアウトするために、`1` などの空でない値に設定します。**`0` または `false` に設定してもオプトアウト**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してエラー報告をオンに戻します |430| `DISABLE_ERROR_REPORTING` | エラー報告をオプトアウトするには、`1` などの空でない値に設定します。**`0` または `false` に設定してもオプトアウト**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してエラー報告をオンに戻します |

431| `DISABLE_FEEDBACK_COMMAND` | `/feedback` コマンドおよび [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) を無効にするために `1` に設定します。また、`/bug` および `/share` を無効にします。これらは同じパスを通じて報告します。v2.1.212 より前は、すべての名前でコマンドが無効になっていました。古い名前 `DISABLE_BUG_COMMAND` も受け入れられます |432| `DISABLE_FEEDBACK_COMMAND` | `/feedback` コマンドおよび [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) を無効にするには `1` に設定します。また、`/bug` および `/share` を無効にします。これらは同じパスを通じて報告します。v2.1.212 より前は、コマンドはすべての名前で無効になっていました。古い名前 `DISABLE_BUG_COMMAND` も受け入れられます |

432| `DISABLE_GROWTHBOOK` | GrowthBook 機能フラグ取得を無効にし、すべてのフラグにコードデフォルトを使用するために `1` または `true` に設定します。これにより、[リモートコントロール](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。`0` または `false` に設定すると、取得がオンのままになります。テレメトリイベントログは `DISABLE_TELEMETRY` も設定されていない限りオンのままです |433| `DISABLE_GROWTHBOOK` | GrowthBook 機能フラグ取得を無効にし、すべてのフラグにコードデフォルトを使用するには `1` または `true` に設定します。これにより、[Remote Control](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。`0` または `false` に設定すると、取得がオンのままになります。テレメトリイベントログは `DISABLE_TELEMETRY` も設定されていない限りオンのままです |

434| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `/install-github-app` コマンドを非表示にするために `1` に設定します。サードパーティプロバイダー（Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry）を使用する場合は既に非表示です |435| `DISABLE_INSTALL_GITHUB_APP_COMMAND` | `/install-github-app` コマンドを非表示にするには `1` に設定します。サードパーティプロバイダー（Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry）を使用する場合は既に非表示です |

435| `DISABLE_INTERLEAVED_THINKING` | インターリーブ思考ベータヘッダーの送信を防ぐために `1` に設定します。LLM ゲートウェイまたはプロバイダーが [インターリーブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) をサポートしない場合に役立ちます |436| `DISABLE_INTERLEAVED_THINKING` | インターリーブ思考ベータヘッダーの送信を防ぐには `1` に設定します。LLM ゲートウェイまたはプロバイダーが [インターリーブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) をサポートしない場合に便利です |

438| `DISABLE_PROMPT_CACHING` | すべてのモデルの [プロンプトキャッシング](/docs/ja/prompt-caching#disable-prompt-caching) を無効にするために `1` に設定します（モデルごとの設定より優先） |439| `DISABLE_PROMPT_CACHING` | すべてのモデルの [プロンプトキャッシング](/docs/ja/prompt-caching#disable-prompt-caching) を無効にするには `1` に設定します（モデルごとの設定より優先） |

443| `DISABLE_TELEMETRY` | テレメトリをオプトアウトするために、`1` などの空でない値に設定します。**`0` または `false` に設定してもオプトアウト**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してテレメトリをオンに戻します。テレメトリイベントにはコード、ファイルパス、bash コマンドなどのユーザーデータは含まれません。また、`DISABLE_GROWTHBOOK` と同じ効果で機能フラグ取得を無効にします。これにより、[リモートコントロール](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。[組織のテレメトリをオフにする](/docs/ja/managed-settings#turn-telemetry-off-for-your-organization) を参照してください |444| `DISABLE_TELEMETRY` | テレメトリをオプトアウトするには、`1` などの空でない値に設定します。**`0` または `false` に設定してもオプトアウト**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してテレメトリをオンに戻します。テレメトリイベントにはコード、ファイルパス、bash コマンドなどのユーザーデータは含まれません。また、`DISABLE_GROWTHBOOK` と同じ効果で機能フラグ取得を無効にします。これにより、[Remote Control](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。[組織のテレメトリをオフにする](/docs/ja/managed-settings#turn-telemetry-off-for-your-organization) を参照してください |

444| `DISABLE_UPDATES` | 手動 `claude update` および `claude install` を含むすべての更新をブロックするために `1` に設定します。`DISABLE_AUTOUPDATER` より厳しい。独自のチャネルを通じて Claude Code を配布し、ユーザーが自己更新すべきでない場合に使用します |445| `DISABLE_UPDATES` | 手動 `claude update` および `claude install` を含むすべての更新をブロックするには `1` に設定します。`DISABLE_AUTOUPDATER` より厳しい。独自のチャネルを通じて Claude Code を配布し、ユーザーが自己更新しないようにする場合に使用します |

446| `DO_NOT_TRACK` | `DISABLE_TELEMETRY` と同じ効果でテレメトリをオプトアウトするために `1` に設定します。[リモートコントロール](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。Claude Code はこの変数を標準ブール値として読み取るため、`0` はテレメトリをオンのままにし、多くの開発者 CLI で認識されるクロスツール規約として尊重します |447| `DO_NOT_TRACK` | テレメトリをオプトアウトするには `1` に設定します。`DISABLE_TELEMETRY` と同じ効果。[Remote Control](/docs/ja/remote-control#requirements) および他の [機能フラグ取得が必要な機能](#features-that-need-feature-flag-fetching) が利用できなくなります。Claude Code はこの変数を標準ブール値として読み取るため、`0` はテレメトリをオンのままにし、多くの開発者 CLI で認識されるクロスツール規約として尊重します |

447| `ENABLE_BETA_TRACING_DETAILED` | `BETA_TRACING_ENDPOINT` と一緒に `1` に設定して、[詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) をオンにします。コンテンツを含むスパン属性および `claude_code.hook` スパンを追加します。対話型 CLI セッションでは、組織がベータ用にホワイトリストに登録されている必要があります。両方の変数は [プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |448| `ENABLE_BETA_TRACING_DETAILED` | `BETA_TRACING_ENDPOINT` と一緒に `1` に設定して、[詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) をオンにします。コンテンツを含むスパン属性と `claude_code.hook` スパンを追加します。対話型 CLI セッションでは、組織もベータ用にホワイトリストに登録される必要があります。両方の変数は [プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

448| `ENABLE_CLAUDEAI_MCP_SERVERS` | Claude Code が [claude.ai MCP サーバー](/docs/ja/mcp#use-mcp-servers-from-claude-ai) をフェッチするのを停止するために `false` に設定します。ログインしたユーザーではデフォルトで有効になります。プロジェクトごとまたは組織ごとに無効にするには、代わりに設定で [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) を設定します |449| `ENABLE_CLAUDEAI_MCP_SERVERS` | Claude Code が [claude.ai MCP サーバー](/docs/ja/mcp#use-mcp-servers-from-claude-ai) をフェッチするのを停止するには `false` に設定します。ログインしたユーザーでデフォルトで有効になります。プロジェクトごとまたは組織ごとに無効にするには、代わりに設定で [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) を設定します |

449| `ENABLE_PROMPT_CACHING_1H` | デフォルト 5 分の代わりに 1 時間の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) をリクエストするために `1` に設定します。API キー、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) ユーザー向け。サブスクリプションユーザーは含まれた使用内で [メイン会話](/docs/ja/prompt-caching#which-ttl-each-request-gets) で自動的に 1 時間 TTL を受け取ります。[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) を引き出すサブスクリプションユーザーは、1 時間 TTL を保持するために設定できます。1 時間キャッシュ書き込みはより高いレートで請求されます。リクエストバケットごとに TTL を選択するには、代わりに `CLAUDE_CODE_PROMPT_CACHE_TTL` および `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` を使用します。これらはこの変数より優先されます |450| `ENABLE_PROMPT_CACHING_1H` | デフォルトの 5 分の代わりに 1 時間の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) をリクエストするには `1` に設定します。API キー、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) ユーザー向け。含まれた使用量内のサブスクリプションユーザーは [メイン会話](/docs/ja/prompt-caching#which-ttl-each-request-gets) で 1 時間の TTL を自動的に受け取ります。[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) を引き出すサブスクリプションユーザーは、1 時間の TTL を保持するために設定できます。1 時間のキャッシュ書き込みはより高いレートで請求されます。リクエストバケットごとに TTL を選択するには、`CLAUDE_CODE_PROMPT_CACHE_TTL` および `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` を使用します。これらはこの変数より優先されます |

451| `ENABLE_TOOL_SEARCH` | [MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) を制御します。設定されていない場合、Claude Code はデフォルトですべての MCP ツールを遅延させます。ただし、Google Cloud の Agent Platform モデルが Claude 4.5 世代より前の場合、Microsoft Foundry デプロイメントが Azure でホストされている場合、`ANTHROPIC_BASE_URL` がファーストパーティ以外のホストを指している場合は事前に読み込みます。`true` は常に遅延させ、ベータヘッダーを送信します。ただし、同じ Agent Platform モデルおよび Microsoft Foundry デプロイメント以外。リクエストは `tool_reference` をサポートしないプロキシで失敗します。`auto` はツール定義がコンテキストの 10% 以内に収まる場合は事前に読み込みます。`auto:N` はカスタムしきい値を設定します。例えば `auto:5` は 5% です。`false` はすべてのツールを事前に読み込みます。自分で設定した値は `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` が設定されている場合は無視されます。v2.1.221 より前は、Claude Code は `true` に設定しない限り、Google Cloud の Agent Platform のすべてのモデルのツール検索を無効にしました |452| `ENABLE_TOOL_SEARCH` | [MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search) を制御します。設定されていない場合、Claude Code はデフォルトですべての MCP ツールを遅延させます。Google Cloud の Agent Platform モデルの Claude 4.5 世代より前のバージョン、Azure でホストされている Microsoft Foundry デプロイメント、`ANTHROPIC_BASE_URL` がファーストパーティ以外のホストを指している場合は、事前に読み込みます。`true` は常に遅延させ、ベータヘッダーを送信します。これらの同じ Agent Platform モデルおよび Microsoft Foundry デプロイメント以外。リクエストは `tool_reference` をサポートしないプロキシで失敗します。`auto` はツール定義がコンテキストの 10% 以内に収まる場合、事前に読み込みます。`auto:N` はカスタムしきい値を設定します。例えば `auto:5` は 5% です。`false` はすべてのツールを事前に読み込みます。自分で設定した値は `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` が設定されている場合は無視されます。v2.1.221 より前は、Claude Code は `true` に設定しない限り、Google Cloud の Agent Platform のすべてのモデルでツール検索を無効にしていました |

452| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Claude Code が繰り返されたオーバーロードエラーで、フォールバックモデルが設定されていない場合、すべてのモデルの再試行を停止するようにするために、`1` などの空でない値に設定します。**`0` または `false` に設定してもこれを有効にします**。ほとんどのオン/オフ変数とは異なり。これがない場合、Claude Code は API キーまたは [サードパーティプロバイダー](/docs/ja/third-party-integrations) ではなく Claude サブスクリプションで認証する場合、Opus、Fable、Mythos モデルとして認識するモデルでこのように再試行を停止します。Claude Code v2.1.160 以降では、Claude Code は繰り返されたオーバーロードエラーで任意のプライマリモデルに設定された [フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains) に切り替わるため、この変数はフォールバックモデルへの切り替えに影響しません |453| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | Claude Code が繰り返されたオーバーロードエラーで、フォールバックモデルが設定されていない場合、すべてのモデルの再試行を停止するようにするには、`1` などの空でない値に設定します。**`0` または `false` に設定してもこれを有効にします**。ほとんどのオン/オフ変数とは異なり。これがない場合、Claude Code は API キーまたは [サードパーティプロバイダー](/docs/ja/third-party-integrations) で認証するときに、Opus、Fable、Mythos モデルとして認識するモデルでこの方法で再試行を停止します。Claude サブスクリプションではなく。Claude Code v2.1.160 以降では、Claude Code は繰り返されたオーバーロードエラーで設定された [フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains) に切り替わるため、この変数はフォールバックモデルへの切り替えに影響しません |

454| `FORCE_HYPERLINK` | ターミナルがサポートしているが自動検出されない場合、クリック可能な OSC 8 ハイパーリンクを有効にするために `1` に設定するか、無効にするために `0` に設定します。設定されていない場合、Claude Code はターミナルサポートを検出した場合のみハイパーリンクを有効にします。Claude Code はこの値をブール値ではなく数値として解析するため、`false`、`no`、`off` などの値はハイパーリンクを無効にする代わりに有効にします。フッター [PR またはマージリクエストバッジ](/docs/ja/interactive-mode#pr-review-status) は、SSH 経由など Claude Code がターミナルサポートを検出できない場合でも、ハイパーリンクとしてレンダリングされます。バッジをプレーンテキストとしてレンダリングするために `0` に設定します |455| `FORCE_HYPERLINK` | ターミナルがサポートしているが自動検出されない場合、クリック可能な OSC 8 ハイパーリンクを有効にするには `1` に設定するか、無効にするには `0` に設定します。設定されていない場合、Claude Code はターミナルサポートが検出された場合にのみハイパーリンクを有効にします。Claude Code はこの値をブール値ではなく数値として解析するため、`false`、`no`、`off` などの値はハイパーリンクを無効にする代わりに有効にします。フッター [PR またはマージリクエストバッジ](/docs/ja/interactive-mode#pr-review-status) は、SSH 経由など Claude Code がターミナルサポートを検出できない場合でも、ハイパーリンクとしてレンダリングされます。バッジをプレーンテキストとしてレンダリングするには `0` に設定します |

455| `FORCE_PROMPT_CACHING_5M` | 1 時間 TTL がそれ以外で適用される場合でも、5 分プロンプトキャッシュ TTL を強制するために `1` に設定します。`CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`、および `promptCacheTtl` および `subagentPromptCacheTtl` 設定をオーバーライドします |456| `FORCE_PROMPT_CACHING_5M` | 1 時間の TTL がそれ以外の場合適用される場合でも、5 分のプロンプトキャッシュ TTL を強制するには `1` に設定します。`CLAUDE_CODE_PROMPT_CACHE_TTL`、`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`、`ENABLE_PROMPT_CACHING_1H`、および `promptCacheTtl` および `subagentPromptCacheTtl` 設定をオーバーライドします |

458| `IS_DEMO` | デモモードを有効にするために、`1` などの空でない値に設定します：ヘッダーおよび `/status` 出力からメールアドレスと組織名を非表示にし、オンボーディングをスキップします。**`0` または `false` に設定してもデモモードを有効にします**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してオフにします。セッションをストリーミングまたは記録するときに役立ちます |459| `IS_DEMO` | デモモードを有効にするには、`1` などの空でない値に設定します：ヘッダーおよび `/status` 出力からメールアドレスと組織名を非表示にし、オンボーディングをスキップします。**`0` または `false` に設定してもデモモードを有効にします**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してオフにします。セッションをストリーミングまたは記録する場合に便利です |

459| `MAX_MCP_OUTPUT_TOKENS` | MCP ツール応答で許可される最大トークン数。Claude Code は出力が 10,000 トークンを超える場合に警告を表示します。[`anthropic/maxResultSizeChars`](/docs/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言するツールはテキストコンテンツにその文字制限を使用しますが、これらのツールからの画像コンテンツはこの変数の対象です（デフォルト：25000） |460| `MAX_MCP_OUTPUT_TOKENS` | MCP ツール応答で許可される最大トークン数。Claude Code は出力が 10,000 トークンを超える場合に警告を表示します。[`anthropic/maxResultSizeChars`](/docs/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言するツールは、テキストコンテンツにはその文字制限を使用しますが、それらのツールからの画像コンテンツはこの変数の対象です（デフォルト：25000） |

460| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モード（`-p` フラグ）で [`--json-schema`](/docs/ja/cli-reference#cli-flags) に対する検証に失敗したモデルの応答に対して Claude Code が許可する試行回数。その後、有効な出力がない場合、実行は失敗します。[ワークフロー](/docs/ja/workflows) サブエージェントの構造化出力が検証に失敗した場合も同じキャップが適用されます。デフォルト 5。最初の試行と 4 回の再試行 |461| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モードで `-p` フラグを使用して、モデルの応答が [`--json-schema`](/docs/ja/cli-reference#cli-flags) に対する検証に失敗した場合、Claude Code が許可する試行回数。その後、有効な出力がない場合、実行は失敗します。[ワークフロー](/docs/ja/workflows) サブエージェントの構造化出力が検証に失敗した場合にも同じキャップが適用されます。デフォルト 5。最初の試行と 4 回の再試行 |

461| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) の固定トークン予算。Claude Code はそれを 1 トークン下のリクエストの最大出力トークンでキャップし、1,024 以下ではありません。[`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ja/model-config#adjust-effort-level) でそのリミットを設定する方法を参照してください。設定されていない場合、[適応的推論](/docs/ja/model-config#adjust-effort-level) を持つモデルは独自の思考深度を選択し、他のモデルはキャップを使用します。Anthropic API で思考をオフにするために `0` に設定します。Fable モデルを除き、思考をオフにできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`0` はパラメーターを省略します。Anthropic API で思考がオフの場合、Claude Code は、Opus 5 などの [その組み合わせを受け入れないことが分かっているモデル](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off) に努力 `high` を送信します。Claude Code は適応的推論モデルで非ゼロ値を無視します。ただし、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` が適応的推論をオフにするモデルを除き |462| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) の固定トークン予算。Claude Code はそれを要求の最大出力トークンの 1 トークン下でキャップし、1,024 未満にはしません。[`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ja/model-config#adjust-effort-level) でそのリミットを設定する方法を参照してください。設定されていない場合、[適応的推論](/docs/ja/model-config#adjust-effort-level) を持つモデルは独自の思考深度を選択し、他のモデルはキャップを使用します。Anthropic API で思考を無効にするには `0` に設定します。Opus 5.5 および Fable モデルを除き、思考をオフにすることはできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`0` は代わりに `thinking` パラメーターを省略します。Anthropic API で思考がオフの場合、Claude Code は、Opus 5 などの [その組み合わせを受け入れないモデル](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off) に努力 `high` を送信します。Claude Code は、適応的推論モデルの非ゼロ値を無視します。ただし、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` が適応的推論をオフにするモデルを除きます |

462| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的プロンプトを回避します |463| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的なプロンプトを回避します |

463| `MCP_CONNECTION_NONBLOCKING` | MCP サーバーが最初のクエリの前に接続するのを待つかどうかを制御します。MCP スタートアップはデフォルトで非ブロッキングです：サーバーはバックグラウンドで接続し、完了するとそれらのツールが利用可能になります。最初のクエリの前にサーバーが接続するのを待つために `0` に設定します。[`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、[検出キャッシュ](/docs/ja/mcp#server-status-detail) から提供される場合を除き、関係なく起動を待たせます。ツールは最初のプロンプトが構築されるときに存在する必要があります。非対話モード（`-p`）で `--input-format stream-json` がない場合、Claude Code は最初のターンの前に保留中のサーバーを待ちます。[`--mcp-config`](/docs/ja/cli-reference#cli-flags) を明示的に渡すと、待機にはより長い期限があります。そのフラグのエントリでキャッシュサーバーの例外を参照してください |464| `MCP_CONNECTION_NONBLOCKING` | MCP サーバーが最初のクエリの前に接続するのを待機するかどうかを制御します。MCP スタートアップはデフォルトで非ブロッキングです：サーバーはバックグラウンドで接続し、完了するとそれらのツールが利用可能になります。最初のクエリの前にサーバーが接続するのを待機するには `0` に設定します。[`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、[検出キャッシュ](/docs/ja/mcp#server-status-detail) から提供される場合を除き、関係なくスタートアップを待機させます。ツールは最初のプロンプトが構築されるときに存在する必要があります。非対話モード（`-p`）で `--input-format stream-json` がない場合、Claude Code は最初のターンの前に保留中のサーバーを待機します。[`--mcp-config`](/docs/ja/cli-reference#cli-flags) を明示的に渡すと、待機にはより長いデッドラインがあります。キャッシュされたサーバーの例外については、そのフラグのエントリを参照してください |

464| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップがツールリストをスナップショットする前に接続バッチを待つ時間（ミリ秒単位）（デフォルト：5000）。`MCP_CONNECTION_NONBLOCKING=0` または [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。サーバーは期限で保留中のままバックグラウンドで接続し続けます。`MCP_TIMEOUT` とは異なり。個別のサーバーの接続試行をバウンドします |465| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップがツールリストをスナップショットする前に接続バッチを待機する時間（ミリ秒単位）（デフォルト：5000）。`MCP_CONNECTION_NONBLOCKING=0` または [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。デッドラインで保留中のサーバーはバックグラウンドで接続し続けます。`MCP_TIMEOUT` とは異なり、個別のサーバーの接続試行をバウンドします |

465| `MCP_DISCOVERY_CACHE` | [MCP 検出キャッシュ](/docs/ja/mcp#server-status-detail) をオンまたはオフにします。キャッシュがオンの場合、以前に使用したリモート HTTP または SSE サーバーは [`cached` ステータス](/docs/ja/mcp#server-status-detail) を表示でき、Claude Code はスタートアップではなく最初のツール呼び出しで接続します。キャッシュはデフォルトではオフです。段階的ロールアウトがアカウント用に有効にしない限り。オンにするために `1` に設定するか、ロールアウトが有効にしている場合でもオフに保つために `0` に設定します。v2.1.238 より前は、キャッシュはデフォルトでオンでした。`cached` ステータスには Claude Code v2.1.221 以降が必要です |466| `MCP_DISCOVERY_CACHE` | [MCP 検出キャッシュ](/docs/ja/mcp#server-status-detail) をオンまたはオフにします。キャッシュがオンの場合、以前に使用したリモート HTTP または SSE サーバーは [`cached` ステータス](/docs/ja/mcp#server-status-detail) を表示でき、Claude Code は最初のツール呼び出しで接続します。スタートアップではなく。キャッシュはデフォルトではオフです。段階的なロールアウトがアカウント用に有効にしない限り。オンにするには `1` に設定するか、ロールアウトが有効にしている場合でもオフに保つには `0` に設定します。v2.1.238 より前は、キャッシュはデフォルトでオンでした。`cached` ステータスには Claude Code v2.1.221 以降が必要です |

466| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリの最大経過時間（秒単位）（デフォルト：14400、または 4 時間）。エントリがそれより古い開始では、Claude Code はそれを破棄し、キャッシュがオフの場合と同様にスタートアップでサーバーを接続します。Claude Code は値を 7 日でキャップします。v2.1.238 より前は、デフォルトは 86400（24 時間）で、Claude Code は値をキャップしませんでした |467| `MCP_DISCOVERY_CACHE_MAX_STALE_S` | [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリの最大経過時間（秒単位）（デフォルト：14400、または 4 時間）。エントリがそれより古い開始では、Claude Code はそれを破棄し、キャッシュがオフの場合と同様にスタートアップでサーバーに接続します。Claude Code は値を 7 日でキャップします。v2.1.238 より前は、デフォルトは 86400（24 時間）で、Claude Code は値をキャップしませんでした |

467| `MCP_DISCOVERY_CACHE_STRIKES` | 開始時に [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリが `MCP_DISCOVERY_CACHE_TTL_S` より古い場合、Claude Code はバックグラウンドでリフレッシュします。この変数は、リフレッシュが連続して失敗してからエントリを破棄し、代わりに次の開始でサーバーを接続する前に失敗できる回数を設定します（デフォルト：1）。ネットワーク接続が時々ドロップする場合は上げます。1 回の失敗がエントリを破棄しないようにするため。Claude Code v2.1.238 以降が必要です |468| `MCP_DISCOVERY_CACHE_STRIKES` | 開始時に [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリが `MCP_DISCOVERY_CACHE_TTL_S` より古い場合、Claude Code はバックグラウンドでリフレッシュします。この変数は、Claude Code がエントリを破棄し、代わりに次の開始でサーバーに接続する前に、連続でリフレッシュが失敗できる回数を設定します（デフォルト：1）。ネットワーク接続が時々ドロップする場合は上げます。1 回の失敗したリフレッシュがエントリを破棄しないようにするため。Claude Code v2.1.238 以降が必要です |

468| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code が [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリをリフレッシュせずに使用する秒数（デフォルト：900）。エントリがそれより古い開始では、Claude Code は引き続きそれを使用しますが、バックグラウンドでリフレッシュします。エントリが `MCP_DISCOVERY_CACHE_MAX_STALE_S` より古くなると、Claude Code は代わりに破棄します。Claude Code は値を `MCP_DISCOVERY_CACHE_MAX_STALE_S`（デフォルト 4 時間）でキャップします。v2.1.238 より前は Claude Code は値をキャップしませんでした |469| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code が [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリをリフレッシュせずに使用する秒数（デフォルト：900）。エントリがそれより古い開始では、Claude Code は引き続きそれを使用しますが、バックグラウンドでリフレッシュします。エントリが `MCP_DISCOVERY_CACHE_MAX_STALE_S` より古い場合、Claude Code は代わりに破棄します。Claude Code は値を `MCP_DISCOVERY_CACHE_MAX_STALE_S`（デフォルト 4 時間）でキャップします。v2.1.238 より前は、Claude Code は値をキャップしませんでした |

469| `MCP_OAUTH_CALLBACK_PORT` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) を使用して MCP サーバーを追加するときの OAuth リダイレクトコールバックの固定ポート。`--callback-port` の代替 |470| `MCP_OAUTH_CALLBACK_PORT` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) を使用して MCP サーバーを追加するときの OAuth リダイレクトコールバック用の固定ポート。`--callback-port` の代替 |

470| `MCP_PROTOCOL_NEGOTIATION` | [v2 MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) のみで、Claude Code が MCP プロトコルリビジョン 2026-07-28 のサーバーをプローブするかどうか。HTTP、claude.ai コネクター、stdio サーバーをプローブするために `auto` に設定します。プローブに応答しないサーバーは以前のプロトコルで接続します。SSE および WebSocket サーバーは常にそうします。すべてのサーバーのプローブをスキップするために `legacy` に設定します。変数がない場合、Claude Code は HTTP サーバーをプローブし、[機能フラグを取得](/docs/ja/mcp#mcp-client-runtimes) するセッションで claude.ai コネクターサーバーもプローブします。その他の値は警告とともに無視されます。Claude Code v2.1.221 以降が必要です |471| `MCP_PROTOCOL_NEGOTIATION` | [v2 MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) でのみ、Claude Code が MCP プロトコルリビジョン 2026-07-28 のサーバーをプローブするかどうか。HTTP、claude.ai コネクター、stdio サーバーをプローブするには `auto` に設定します。プローブに応答しないサーバーは以前のプロトコルで接続します。SSE および WebSocket サーバーは常にそうします。すべてのサーバーのプローブをスキップするには `legacy` に設定します。変数がない場合、Claude Code は HTTP サーバーをプローブし、[機能フラグを取得](/docs/ja/mcp#mcp-client-runtimes) するセッションで claude.ai コネクターサーバーもプローブします。その他の値は警告で無視されます。Claude Code v2.1.221 以降が必要です |

472| `MCP_SDK_GENERATION` | このプロセスが MCP サーバーに接続する [MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) をピン留めします：`v1`（MCP TypeScript SDK 1.x に基づく）または `v2`（[MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) に基づく）。変数がない場合、Claude Code は v2 を使用します。そのセクションにリストされているバージョンから開始します。Claude Code v2.1.221 以降では、v2 ランタイムは MCP OAuth サーバーが認可応答で返す発行者をチェックし、一致しない場合、`Issuer mismatch in authorization response` で始まるエラーでサインインに失敗します。v1 ランタイムはこのチェックを実行しません。認識されない値を設定すると、Claude Code はそれを無視し、デバッグログに警告を書き込みます。Claude Code はプロセスごとに値を 1 回読み取ります。Claude Code v2.1.218 以降が必要です |473| `MCP_SDK_GENERATION` | このプロセスが MCP サーバーに接続する [MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) をピン留めします：`v1`（MCP TypeScript SDK 1.x に基づく）または `v2`（[MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) に基づく）。変数がない場合、Claude Code は v2 を使用します。そのセクションにリストされているバージョンから開始。Claude Code v2.1.221 以降では、v2 ランタイムは MCP OAuth サーバーが認可応答で返す発行者をチェックし、一致しない場合、`Issuer mismatch in authorization response` で始まるエラーでサインインに失敗します。v1 ランタイムはこのチェックを実行しません。認識されない値を設定すると、Claude Code はそれを無視し、デバッグログに警告を書き込みます。Claude Code はプロセスごとに値を 1 回読み取ります。Claude Code v2.1.218 以降が必要です |

475| `MCP_TOOL_TIMEOUT` | MCP ツール実行のタイムアウト（ミリ秒単位）（デフォルト：100000000、約 28 時間）。HTTP、SSE、claude.ai コネクターサーバーの場合、各リクエストもデフォルトで 60 秒後にタイムアウトします。この変数またはサーバーごとの `timeout` を 60000 以上に設定して、そのリクエストごとのリミットを上げます。低い値はまだ全体的なツール実行タイムアウトを短縮しますが、リクエストごとのリミットを 60 秒のままにします。Stdio および WebSocket サーバーにはリクエストごとのタイマーがありません。`.mcp.json` のサーバーごとの `timeout` フィールドはこのサーバーをオーバーライドします。1000 以上のサーバーごとの `timeout` は、そのサーバーのツール呼び出しの最小アイドルウィンドウも設定するため、`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` はそれより早く中止しません。このフロアには Claude Code v2.1.203 以降が必要です。環境変数の場合、1000 未満の値は 1 秒にフロアされます。サーバーごとのフィールドの場合、1000 未満の値は無視されます |476| `MCP_TOOL_TIMEOUT` | MCP ツール実行のタイムアウト（ミリ秒単位）（デフォルト：100000000、約 28 時間）。HTTP、SSE、claude.ai コネクターサーバーの場合、各リクエストもデフォルトで 60 秒後にタイムアウトします。このリクエストごとのリミットを上げるには、この変数またはサーバーごとの `timeout` を 60000 を超えて設定します。低い値はまだ全体的なツール実行タイムアウトを短縮しますが、リクエストごとのリミットを 60 秒のままにします。Stdio および WebSocket サーバーにはリクエストごとのタイマーがありません。`.mcp.json` のサーバーごとの `timeout` フィールドはそのサーバーでこれをオーバーライドします。少なくとも 1000 のサーバーごとの `timeout` は、そのサーバーのツール呼び出しのアイドルウィンドウの最小値も設定するため、`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT` はそれらを早期に中止しません。このフロアには Claude Code v2.1.203 以降が必要です。環境変数の場合、1000 未満の値は 1 秒にフロアされます。サーバーごとのフィールドの場合、1000 未満の値は無視されます |

477| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | 標準 OpenTelemetry SDK 属性値長制限。Claude Code はコンテンツを含むテレメトリ属性をこれと `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` の小さい方でキャップするため、切り詰めマーカーは SDK リミット内に留まります。Claude Code は `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` および `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` バリアントを同じ方法で読み取り、最小設定値がすべてのシグナルに適用されます。Claude Code v2.1.214 以降が必要です。[監視](/docs/ja/monitoring-usage#common-configuration-variables) を参照してください |478| `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` | 属性値長の標準 OpenTelemetry SDK リミット。Claude Code はコンテンツを含むテレメトリ属性をこれと `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` の小さい方でキャップするため、切り詰めマーカーは SDK リミット内に留まります。Claude Code は `OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT` および `OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT` バリアントを同じ方法で読み取り、最小設定値がすべてのシグナルに適用されます。Claude Code v2.1.214 以降が必要です。[監視](/docs/ja/monitoring-usage#common-configuration-variables) を参照してください |

478| `OTEL_LOG_ASSISTANT_RESPONSES` | `assistant_response` OpenTelemetry ログイベントにモデルの応答テキストを含めるために `1` に設定します。設定されていない場合、`OTEL_LOG_USER_PROMPTS` の値が使用されます。`OTEL_LOG_USER_PROMPTS` が設定されている場合でも応答を編集したままにするために `0` に設定します。Claude Code v2.1.193 以降が必要です。[監視](/docs/ja/monitoring-usage#assistant-response-event) を参照してください |479| `OTEL_LOG_ASSISTANT_RESPONSES` | モデルの応答テキストを `assistant_response` OpenTelemetry ログイベントに含めるには `1` に設定します。設定されていない場合、`OTEL_LOG_USER_PROMPTS` の値が代わりに使用されます。`OTEL_LOG_USER_PROMPTS` が設定されている場合でも応答を編集したままにするには `0` に設定します。Claude Code v2.1.193 以降が必要です。[監視](/docs/ja/monitoring-usage#assistant-response-event) を参照してください |

479| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストおよび応答 JSON を `api_request_body` / `api_response_body` ログイベントとして発行します。インラインボディを切り詰めたコンテンツリミットで `1` に設定するか、切り詰めされていないボディをディスクに書き込み、代わりに `body_ref` パスを発行するために `file:<dir>` に設定します。`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` はコンテンツリミットを設定します。デフォルト 60 KB。デフォルトで無効です。ボディは会話履歴全体を含みます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage#api-request-body-event) を参照してください |480| `OTEL_LOG_MANAGED_SETTINGS` | 編集された管理設定と、編集前の設定の SHA-256 ダイジェストを `managed_settings_resolved` OpenTelemetry ログイベントに追加するには `1` に設定します。デフォルトで無効。シェル、ユーザー設定、または管理設定で設定します。プロジェクトまたはローカル設定の値はオンにしません。Claude Code v2.1.274 以降が必要です。[監視](/docs/ja/monitoring-usage#managed-settings-resolved-event) を参照してください |

480| `OTEL_LOG_TOOL_CONTENT` | `tool.output` OpenTelemetry スパンイベントにツールコンテンツを含めるために `1` に設定します。スパン属性は [独自のゲート](/docs/ja/monitoring-usage#new-context-gates) の下でツールコンテンツを実行します。[トレーシング](/docs/ja/monitoring-usage#traces-beta) が必要です。デフォルトで無効です。機密データを保護するため。[監視](/docs/ja/monitoring-usage#tool-output-span-event) を参照してください |481| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストおよび応答 JSON を `api_request_body` / `api_response_body` ログイベントとして発行します。コンテンツリミットで切り詰められたインラインボディの場合は `1` に設定するか、編集されていないボディをディスクに書き込み、代わりに `body_ref` パスを発行するには `file:<dir>` に設定します。`CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` はコンテンツリミットを設定します。デフォルト 60 KB。デフォルトで無効。ボディには会話履歴全体が含まれます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます。[監視](/docs/ja/monitoring-usage#api-request-body-event) を参照してください |

481| `OTEL_LOG_TOOL_DETAILS` | ツール入力引数、MCP サーバー名、ユーザー作成ワークフロー名、ツール失敗時の生エラー文字列、`api_refusal` イベントの拒否 `category`、その他のツール詳細を OpenTelemetry トレースおよびログに含めるために `1` に設定します。デフォルトで無効です。PII を保護するため。[監視](/docs/ja/monitoring-usage) を参照してください |482| `OTEL_LOG_TOOL_CONTENT` | `tool.output` OpenTelemetry スパンイベントにツールコンテンツを含めるには `1` に設定します。スパン属性は [独自のゲート](/docs/ja/monitoring-usage#new-context-gates) の下でツールコンテンツを運びます。[トレーシング](/docs/ja/monitoring-usage#traces-beta) が必要です。デフォルトで無効。機密データを保護するため。[監視](/docs/ja/monitoring-usage#tool-output-span-event) を参照してください |

482| `OTEL_LOG_USER_PROMPTS` | OpenTelemetry トレースおよびログにユーザープロンプトテキストを含めるために `1` に設定します。デフォルトで無効です（プロンプトは編集されます）。[監視](/docs/ja/monitoring-usage) を参照してください |483| `OTEL_LOG_TOOL_DETAILS` | ツール入力引数、MCP サーバー名、ユーザー作成ワークフロー名、ツール失敗時の生エラー文字列、`api_refusal` イベントの拒否 `category`、その他のツール詳細を OpenTelemetry トレースおよびログに含めるには `1` に設定します。デフォルトで無効。PII を保護するため。[監視](/docs/ja/monitoring-usage) を参照してください |

483| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | メトリクス属性からアカウント UUID を除外するために `false` に設定します（デフォルト：含まれます）。[監視](/docs/ja/monitoring-usage) を参照してください |484| `OTEL_LOG_USER_PROMPTS` | OpenTelemetry トレースおよびログにユーザープロンプトテキストを含めるには `1` に設定します。デフォルトで無効（プロンプトは編集されます）。[監視](/docs/ja/monitoring-usage) を参照してください |

484| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | メトリクス属性にセッションエントリポイントを含めるために `true` に設定します（デフォルト：除外）。v2.1.152 で追加されました。[監視](/docs/ja/monitoring-usage) を参照してください |485| `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` | メトリクス属性からアカウント UUID を除外するには `false` に設定します（デフォルト：含まれます）。[監視](/docs/ja/monitoring-usage) を参照してください |

485| `OTEL_METRICS_INCLUDE_REPOSITORY` | OpenTelemetry メトリクスおよびイベントにセッションのリポジトリを識別する `vcs.*` 属性でタグ付けするために `true` に設定します（デフォルト：除外）。Claude Code v2.1.269 以降が必要です。[リポジトリ属性](/docs/ja/monitoring-usage#repository-attributes) を参照してください |486| `OTEL_METRICS_INCLUDE_ENTRYPOINT` | メトリクス属性にセッションエントリポイントを含めるには `true` に設定します（デフォルト：除外）。v2.1.152 で追加されました。[監視](/docs/ja/monitoring-usage) を参照してください |

486| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | v2.1.161 以降、Claude Code は `OTEL_RESOURCE_ATTRIBUTES` キーをメトリクスデータポイントラベルに添付します。除外するために `false` に設定します（デフォルト：含まれます）。[監視](/docs/ja/monitoring-usage#multi-team-organization-support) を参照してください |487| `OTEL_METRICS_INCLUDE_REPOSITORY` | OpenTelemetry メトリクスおよびイベントにセッションのリポジトリを識別する `vcs.*` 属性でタグ付けするには `true` に設定します（デフォルト：除外）。Claude Code v2.1.269 以降が必要です。[リポジトリ属性](/docs/ja/monitoring-usage#repository-attributes) を参照してください |

487| `OTEL_METRICS_INCLUDE_SESSION_ID` | メトリクス属性からセッション ID を除外するために `false` に設定します（デフォルト：含まれます）。[監視](/docs/ja/monitoring-usage) を参照してください |488| `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` | v2.1.161 以降、Claude Code は `OTEL_RESOURCE_ATTRIBUTES` キーをメトリクスデータポイントラベルに添付します。除外するには `false` に設定します（デフォルト：含まれます）。[監視](/docs/ja/monitoring-usage#multi-team-organization-support) を参照してください |

488| `OTEL_METRICS_INCLUDE_VERSION` | メトリクス属性に Claude Code バージョンを含めるために `true` に設定します（デフォルト：除外）。[監視](/docs/ja/monitoring-usage) を参照してください |489| `OTEL_METRICS_INCLUDE_SESSION_ID` | メトリクス属性からセッション ID を除外するには `false` に設定します（デフォルト：含まれます）。[監視](/docs/ja/monitoring-usage) を参照してください |

489| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [スキルツール](/docs/ja/skills#control-who-invokes-a-skill) に表示されるスキルメタデータの文字予算をオーバーライドします。予算はコンテキストウィンドウの 1% で動的にスケーリングされ、フォールバックは 8,000 文字です。後方互換性のために古い名前を保持 |490| `OTEL_METRICS_INCLUDE_VERSION` | メトリクス属性に Claude Code バージョンを含めるには `true` に設定します（デフォルト：除外）。[監視](/docs/ja/monitoring-usage) を参照してください |

490| `TASK_MAX_OUTPUT_LENGTH` | [バックグラウンドタスク](/docs/ja/tools-reference#background-commands) の出力の最大文字数。`TaskOutput` ツールが保持します（デフォルト：32000。最大：160000）。[`taskOutputMaxChars`](/docs/ja/settings-reference#taskoutputmaxchars) 設定を設定した場合、Claude Code はこの変数を無視します |491| `SLASH_COMMAND_TOOL_CHAR_BUDGET` | [Skill ツール](/docs/ja/skills#control-who-invokes-a-skill) に表示されるスキルメタデータの文字予算をオーバーライドします。予算はコンテキストウィンドウの 1% で動的にスケーリングされ、フォールバックは 8,000 文字です。後方互換性のために古い名前を保持 |

491| `USE_BUILTIN_RIPGREP` | Claude Code に含まれる `rg` の代わりにシステムインストール `rg` を使用するために `0` に設定します |492| `TASK_MAX_OUTPUT_LENGTH` | v2.1.277 で削除され、現在は no-op です。それがサイズした `TaskOutput` ツールと一緒に。以前は、[バックグラウンドタスク](/docs/ja/tools-reference#background-commands) の出力の最大文字数を設定していました。`TaskOutput` ツールが保持していました。Claude は代わりに `Read` でバックグラウンドタスクの出力ファイルを読み取ります |

493| `USE_BUILTIN_RIPGREP` | システムインストール `rg` の代わりに Claude Code に含まれる `rg` を使用するには `0` に設定します |

506| `VERTEX_REGION_CLAUDE_5_5_OPUS` | Google Cloud の Agent Platform を使用する場合、Claude Opus 5.5 のリージョンをオーバーライドします。v2.1.280 で追加されました |

504| `VERTEX_REGION_CLAUDE_5_OPUS` | Google Cloud の Agent Platform を使用する場合、Claude Opus 5 のリージョンをオーバーライドします。v2.1.219 で追加されました |507| `VERTEX_REGION_CLAUDE_5_OPUS` | Google Cloud の Agent Platform を使用する場合、Claude Opus 5 のリージョンをオーバーライドします。v2.1.219 で追加されました |

505| `VERTEX_REGION_CLAUDE_5_SONNET` | Google Cloud の Agent Platform を使用する場合、Claude Sonnet 5 のリージョンをオーバーライドします。v2.1.197 で追加されました |508| `VERTEX_REGION_CLAUDE_5_SONNET` | Google Cloud の Agent Platform を使用する場合、Claude Sonnet 5 のリージョンをオーバーライドします。v2.1.197 で追加されました |

506| `VERTEX_REGION_CLAUDE_FABLE_5` | Google Cloud の Agent Platform を使用する場合、Claude Fable 5 のリージョンをオーバーライドします。v2.1.170 で追加されました |509| `VERTEX_REGION_CLAUDE_FABLE_5` | Google Cloud の Agent Platform を使用する場合、Claude Fable 5 のリージョンをオーバーライドします。v2.1.170 で追加されました |

521 524

522取得がオフの場合、以下のことはできません。525取得がオフの場合、以下のことはできません。

523 526

524* Claude Code が [プロジェクト指示として `AGENTS.md` ファイルを読む](/docs/ja/memory#agents-md) ことができない。`CLAUDE.md` ファイルのみを読み込みます527* Claude Code が [プロジェクト指示として `AGENTS.md` ファイルを読む](/docs/ja/memory#agents-md) こと。`CLAUDE.md` ファイルのみを読み込みます

525* Pro、Max、Team プランで [デフォルトでセッションをオートモードで開始する](/docs/ja/permission-modes#which-mode-a-session-starts-in)528* [Pro、Max、Team プランでデフォルトでセッションをオートモードで開始する](/docs/ja/permission-modes#which-mode-a-session-starts-in) こと

526* VS Code 拡張機能が [開始権限モードの設定ファイルを読み込む](/docs/ja/permission-modes#switch-permission-modes)529* VS Code 拡張機能が [開始権限モードの設定ファイルを読む](/docs/ja/permission-modes#switch-permission-modes) こと

527* [`/auto-mode-setup`](/docs/ja/auto-mode-config#generate-environment-entries) を実行して `autoMode.environment` エントリを作成する530* [`/auto-mode-setup`](/docs/ja/auto-mode-config#generate-environment-entries) を実行して `autoMode.environment` エントリを作成すること

528* [Remote Control](/docs/ja/remote-control#requirements) を使用する531* [Remote Control](/docs/ja/remote-control#requirements) を使用すること

529* [このマシン以外のセッションにメッセージを送信する](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)。このマシン上のセッション間のメッセージングは取得がオフでも機能します532* [このマシン以外のセッションにメッセージを送信する](/docs/ja/cross-session-messaging#message-sessions-on-other-machines) こと。このマシン上のセッション間のメッセージングは取得がオフでも機能します

530* [`claude import` または `/import` コマンド](/docs/ja/cli-reference#cli-commands) を実行する533* [`claude import` または `/import` コマンド](/docs/ja/cli-reference#cli-commands) を実行すること

531* [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行するか、`/plugin` **Stats** タブでそのレポートを開く534* [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行するか、`/plugin` **Stats** タブでそのレポートを開くこと

532* [スキル](/docs/ja/skills#where-synced-skills-load) および [プラグイン](/docs/ja/plugins-reference#synced-plugins) が claude.ai アカウント用に有効になっているものをターミナルセッションに同期する535* claude.ai アカウント用に有効になっている [スキル](/docs/ja/skills#where-synced-skills-load) と [プラグイン](/docs/ja/plugins-reference#synced-plugins) をターミナルセッションに同期すること

533* [アドバイザーツール](/docs/ja/advisor#requirements) を使用する536* [アドバイザーツール](/docs/ja/advisor#requirements) を使用すること

534* [アーティファクトのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact) を読むまたは返信する537* [アーティファクトのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact) を読むか返信すること

535* Claude Code が claude.ai コネクタサーバーをプローブして [MCP プロトコルリビジョン 2026-07-28](/docs/ja/mcp#mcp-client-runtimes) を取得する。ただし、`MCP_PROTOCOL_NEGOTIATION=auto` を設定している場合を除きます538* Claude Code が `MCP_PROTOCOL_NEGOTIATION=auto` を設定していない限り、claude.ai コネクタサーバーに [MCP プロトコルリビジョン 2026-07-28](/docs/ja/mcp#mcp-client-runtimes) をプローブさせること

536* Git Bash がインストールされている Windows 上の claude.ai および Console アカウント向けに [PowerShell ツール](/docs/ja/tools-reference#powershell-tool) をデフォルトで取得する。Claude Code は `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を設定しない限り、シェルコマンドを Git Bash 経由でルーティングします。Git Bash がない Windows では、ツールはオンのままです539* Git Bash がインストールされている Windows 上の claude.ai および Console アカウント用に、デフォルトで [PowerShell ツール](/docs/ja/tools-reference#powershell-tool) を取得すること。Claude Code は `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を設定していない限り、シェルコマンドを Git Bash 経由でルーティングします。Git Bash がない Windows では、ツールはオンのままです

537* [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) を取得する。Claude Code はこれを取得されたフラグを通じてオンにします540* [Claude が作成したフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior) を取得すること。Claude Code はこれを取得されたフラグを通じてオンにします

538* Claude Code が [入力スキーマを API が拒否する MCP ツールを除外する](/docs/ja/mcp#tools-with-invalid-input-schemas) ことができない。スキーマを送信してしまい、それを含むリクエストは [ツールをその位置で名前付けする 400 エラー](/docs/ja/errors#tool-input-schema-is-invalid) で失敗します541* Claude が [大きなペーストを入力されたテキストではなくペーストされたテキストとして扱う](/docs/ja/terminal-config#how-claude-treats-pasted-text) こと。`[Pasted text #N]` プレースホルダの背後にあるコンテンツは、マークなしで Claude に到達します

542* Claude Code が [API が入力スキーマを拒否する MCP ツールを除外する](/docs/ja/mcp#tools-with-invalid-input-schemas) こと。スキーマを送信し、それを含むリクエストは [ツールの位置で名前を付けた 400 エラー](/docs/ja/errors#tool-input-schema-is-invalid) で失敗します

539 543

540<h3 id="first-session-after-an-install-or-upgrade">544<h3 id="first-session-after-an-install-or-upgrade">

541 インストールまたはアップグレード後の最初のセッション545 インストールまたはアップグレード後の最初のセッション

542</h3>546</h3>

543 547

544Claude Code をインストールした後、またはフィーチャーを追加するバージョンにアップグレードした後の最初のセッションでは、[フラグゲートされたフィーチャー](#features-that-need-feature-flag-fetching) が欠落する可能性があり、セッションは通常はオートモードで開始するプランでも Manual モードで開始する可能性があります。Claude Code はそのセッション中にフラグを取得するため、次のセッションではどちらも存在します。548Claude Code をインストールした後、またはフィーチャーを追加するバージョンにアップグレードした後の最初のセッションでは、[フラグゲートされたフィーチャー](#features-that-need-feature-flag-fetching) が欠落する可能性があり、セッションは通常オートモードで開始するプランでも Manual モードで開始する可能性があります。Claude Code はそのセッション中にフラグを取得するため、次のセッションでは両方が存在します。

545 549

546新規インストール後、`claude -p`、Agent SDK、VS Code 拡張機能などの非対話型セッションでは、Claude Code は [開始権限モードを選択する](/docs/ja/permission-modes#which-mode-a-session-starts-in) 前にフラグを取得できます。550新規インストール後、`claude -p`、Agent SDK、または VS Code 拡張機能などの非対話型セッションでは、Claude Code は [開始権限モードを選択する](/docs/ja/permission-modes#which-mode-a-session-starts-in) 前にフラグを取得できます。

547 551

548<h2 id="see-also">552<h2 id="see-also">

549 関連項目553 関連項目

errors.md +160 −8

Details

74| `Artifacts need a claude.ai login` | [認証](#artifacts-need-a-claude-ai-login) |

75| `Administrator policy requires a Cloud gateway sign-in on this machine` | [認証](#administrator-policy-requires-a-cloud-gateway-sign-in) |76| `Administrator policy requires a Cloud gateway sign-in on this machine` | [認証](#administrator-policy-requires-a-cloud-gateway-sign-in) |

91| `Sign-in timed out while waiting for you to continue. Try again.` | [認証](#sign-in-timed-out-while-waiting-for-you-to-continue) |

149| `effort '<level>' is not supported when thinking is disabled` | [リクエストエラー](#effort-isnt-available-with-thinking-turned-off) |151| `effort '<level>' is not supported when thinking is disabled` | [リクエストエラー](#effort-isnt-available-with-thinking-turned-off) |

154| `API Error: 400 orphaned tool_result in conversation history` | [リクエストエラー](#tool-use-or-thinking-block-mismatch) |

155| `API Error: 400 duplicate tool_use ID in conversation history` | [リクエストエラー](#tool-use-or-thinking-block-mismatch) |

153| `server_tool_use.name: Input should be` on every turn of a resumed session | [リクエストエラー](#unsupported-tool-content-removed) |157| `server_tool_use.name: Input should be` on every turn of a resumed session | [リクエストエラー](#unsupported-tool-content-removed) |

155| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [リクエストエラー](#usage-policy-refusal) |159| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [リクエストエラー](#usage-policy-refusal) |

161| `Opus 5.5's safeguards flagged this session` | [リクエストエラー](#safety-measures-flagged-a-cybersecurity-topic) |

157| `<model> has safety measures that flagged this message for a cybersecurity topic` | [リクエストエラー](#safety-measures-flagged-a-cybersecurity-topic) |162| `<model> has safety measures that flagged this message for a cybersecurity topic` | [リクエストエラー](#safety-measures-flagged-a-cybersecurity-topic) |

158| `Installation was killed before it could finish (exit code 137)` | [インストールエラー](#installation-was-killed-before-it-could-finish) |163| `Installation was killed before it could finish (exit code 137)` | [インストールエラー](#installation-was-killed-before-it-could-finish) |

159| `The connection dropped while downloading the update` | [インストールエラー](#the-connection-dropped-while-downloading-the-update) |164| `The connection dropped while downloading the update` | [インストールエラー](#the-connection-dropped-while-downloading-the-update) |

201| `Cannot switch renderers while work is running in the background` | [コマンドラインエラー](#cannot-switch-renderers-in-this-session) |206| `Cannot switch renderers while work is running in the background` | [コマンドラインエラー](#cannot-switch-renderers-in-this-session) |

207| `Couldn't open Claude Desktop` | [コマンドラインエラー](#couldnt-open-claude-desktop) |

208| `Failed to open Claude Desktop. Please try opening it manually.` | [コマンドラインエラー](#couldnt-open-claude-desktop) |

202| `Couldn't read your Zed keymap` / `Couldn't back up your Zed keymap` / `Couldn't update your Zed keymap` | [コマンドラインエラー](#terminal-setup-left-your-zed-keymap-unchanged) |209| `Couldn't read your Zed keymap` / `Couldn't back up your Zed keymap` / `Couldn't update your Zed keymap` | [コマンドラインエラー](#terminal-setup-left-your-zed-keymap-unchanged) |

204| `Skill usage reports are not available on this connection.` | [コマンドラインエラー](#skill-usage-reports-are-not-available-on-this-connection) |211| `Skill usage reports are not available on this connection.` | [コマンドラインエラー](#skill-usage-reports-are-not-available-on-this-connection) |

206| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [コマンドラインエラー](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |213| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [コマンドラインエラー](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |

207| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [プラグインエラー](#plugin-eval-is-currently-in-early-access) |214| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [プラグインエラー](#plugin-eval-is-currently-in-early-access) |

208| `Marketplace "<name>" is registered from an untrusted source` | [プラグインエラー](#marketplace-is-registered-from-an-untrusted-source) |215| `Marketplace "<name>" is registered from an untrusted source` | [プラグインエラー](#marketplace-is-registered-from-an-untrusted-source) |

216| `Marketplace "<name>" is already added from a different source` | [プラグインエラー](#marketplace-is-already-added-from-a-different-source) |

209| `references ${user_config.*} in a shell-form command` | [プラグインエラー](#plugin-command-references-user-config) |217| `references ${user_config.*} in a shell-form command` | [プラグインエラー](#plugin-command-references-user-config) |

210| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [プラグインエラー](#plugin-command-references-user-config) |218| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [プラグインエラー](#plugin-command-references-user-config) |

211| `headersHelper for MCP server '<name>' references ${user_config.*}` | [プラグインエラー](#plugin-command-references-user-config) |219| `headersHelper for MCP server '<name>' references ${user_config.*}` | [プラグインエラー](#plugin-command-references-user-config) |

227| `Plugin "<name>@synced" is required by your organization and can't be disabled here` | [プラグインエラー](#plugin-is-required-by-your-organization) |

221| `subagent_type is required: the general-purpose agent is not available in this session` | [ツールエラー](#subagent-type-is-required) |230| `subagent_type is required: the general-purpose agent is not available in this session` | [ツールエラー](#subagent-type-is-required) |

247| `blocked because the path is spelled in a form that cannot be safely resolved` | [バックグラウンドセッションエラー](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |256| `blocked because the path is spelled in a form that cannot be safely resolved` | [バックグラウンドセッションエラー](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) |

248| `blocked because the path is network-shaped` | [バックグラウンドセッションエラー](#write-or-command-blocked-because-the-path-names-a-network-location) |257| `blocked because the path is network-shaped` | [バックグラウンドセッションエラー](#write-or-command-blocked-because-the-path-names-a-network-location) |

258| `is isolated in the worktree <path>, but this command <reason>. Refusing to run it` | [バックグラウンドセッションエラー](#command-blocked-by-the-worktree-isolation-checks) |

259| `too complex to verify that it stays inside the worktree` | [バックグラウンドセッションエラー](#command-blocked-by-the-worktree-isolation-checks) |

250| `Can't open — this session is running in another terminal` | [バックグラウンドセッションエラー](#this-session-is-running-in-another-terminal) |261| `Can't open — this session is running in another terminal` | [バックグラウンドセッションエラー](#this-session-is-running-in-another-terminal) |

251| `This conversation is already open in another running Claude session` | [バックグラウンドセッションエラー](#this-session-is-running-in-another-terminal) |262| `This conversation is already open in another running Claude session` | [バックグラウンドセッションエラー](#this-session-is-running-in-another-terminal) |

281| `MCP server <name> is blocked by enterprise managed policy` | [設定の警告](#mcp-server-is-blocked-by-enterprise-managed-policy) |292| `MCP server <name> is blocked by enterprise managed policy` | [設定の警告](#mcp-server-is-blocked-by-enterprise-managed-policy) |

282| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [設定の警告](#managed-settings-document-could-not-be-parsed) |293| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [設定の警告](#managed-settings-document-could-not-be-parsed) |

295| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [設定の警告](#otelheadershelper-failed) |

284| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [設定の警告](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |296| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [設定の警告](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |

624**対応方法：**636**対応方法：**

625 637

626* `/model` を実行し、`[1m]` サフィックスなしのバリアントを選択して、標準コンテキストウィンドウにフォールバックします638* `/model` を実行し、`[1m]` サフィックスなしのバリアントを選択して、標準コンテキストウィンドウにフォールバックします

627* メッセージが `/usage-credits` を指定する場合、それを実行して Pro と Max で 1M バリアントのメータリング課金をオンにするか、Team と Enterprise で管理者に使用クレジットをリクエストします。使用クレジットがオンになったら Claude Code を再起動します。再起動するまで、セッションは標準コンテキスト制限に留まります。639* メッセージが `/usage-credits` を指定する場合、それを実行して Pro と Max で 1M バリアントのメータリング課金をオンにするか、Team と Enterprise で管理者に使用クレジットをリクエストします。使用クレジットがオンになったら Claude Code を再起動するか、新しいセッションを開始します。メッセージが指定するまで、セッションは標準コンテキスト制限に留まります。

628* `/model` の後もエラーが続く場合、1M モデル ID が他の場所に設定されている可能性があります。[モデルの設定](/docs/ja/model-config#setting-your-model) を参照して、優先順位順に確認する設定場所を確認してください。640* `/model` の後もエラーが続く場合、1M モデル ID が他の場所に設定されている可能性があります。[モデルの設定](/docs/ja/model-config#setting-your-model) を参照して、優先順位順に確認する設定場所を確認してください。

629* モデルピッカーから 1M バリアントを完全に削除するには、[`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ja/env-vars) を設定します641* モデルピッカーから 1M バリアントを完全に削除するには、[`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/ja/env-vars) を設定します

630 642

861* `apiKeyHelper` で設定されたコマンドをシェルで直接実行して、失敗を再現します873* `apiKeyHelper` で設定されたコマンドをシェルで直接実行して、失敗を再現します

862* コマンドが期限切れのセッションを報告する場合は、認証情報プロバイダーで再認証します。たとえば、SSO またはシークレットボールトに再度サインインします874* コマンドが期限切れのセッションを報告する場合は、認証情報プロバイダーで再認証します。たとえば、SSO またはシークレットボールトに再度サインインします

863* コマンドを修正して、stdout にのみキーを出力するようにします。単一のトークンとして、最大 16,384 文字の印字可能 ASCII で、終了コード 0 で終了します。[apiKeyHelper で認証情報をローテーションする](/docs/ja/llm-gateway-connect#rotate-credentials-with-apikeyhelper) を参照して、動作するセットアップを確認してください。875* コマンドを修正して、stdout にのみキーを出力するようにします。単一のトークンとして、最大 16,384 文字の印字可能 ASCII で、終了コード 0 で終了します。[apiKeyHelper で認証情報をローテーションする](/docs/ja/llm-gateway-connect#rotate-credentials-with-apikeyhelper) を参照して、動作するセットアップを確認してください。

864* `/status` を実行して、`apiKeyHelper` がアクティブな認証情報ソースであることを確認します。コマンドが失敗するたびに、その終了コードとエラー出力がターミナルの `Authentication` パネルに表示されます。v2.1.212 より前では、パネルは `Cloud authentication` というタイトルでした。876* `/status` を実行して、`apiKeyHelper` がアクティブな認証情報ソースであることを確認します。`apiKeyHelper` 行は `Failing` を表示し、最後の失敗の詳細（終了コードとコマンドのエラー出力など）を表示し、次の成功した実行後に消えます。v2.1.274 より前では、`/status` は認証情報ソースのみを表示し、失敗を表示しませんでした。

877* コマンドが失敗するたびに、その終了コードとエラー出力がターミナルの `Authentication` パネルに表示されます。v2.1.212 より前では、パネルは `Cloud authentication` というタイトルでした。

865 878

866<h3 id="invalid-request-header-value">879<h3 id="invalid-request-header-value">

867 無効なリクエストヘッダー値880 無効なリクエストヘッダー値

1167 1180

1168* `/login` を実行し、サインインを完了してから、セッションを再度開始します1181* `/login` を実行し、サインインを完了してから、セッションを再度開始します

1169 1182

1183<h3 id="artifacts-need-a-claude-ai-login">

1184 Artifacts には claude.ai ログインが必要です

1185</h3>

1186

1187Claude Code は、セッションに artifacts に使用できる claude.ai ログインがないため、[Artifacts](/docs/ja/artifacts) の公開または読み取りを拒否しました。

1188

1189メッセージのすべての形式は同じ単語で始まり、その後にセッションの認証方法に応じた救済が続きます。競合する認証情報がない場合は、次のように読みます：

1190

1191```text theme={null}

1192Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.

1193```

1194

1195**対応方法：**

1196

1197* `/login` を実行し、**Claude account with subscription** を選択します。**Anthropic Console account** オプションは claude.ai 認証情報を提供しません。

1198* メッセージが `ANTHROPIC_API_KEY`、`apiKeyHelper` 設定、または前の `/login` で保存された Console キーなど、優先順位を取る認証情報に名前を付ける場合は、メッセージが言う方法でそれを削除してから、`/login` を実行します

1199* メッセージがこのリモートセッションがそれを起動したマシンを通じて認証されると言う場合は、そのマシンで claude.ai にサインインしてから、セッションを再接続します

1200* メッセージが認証情報がセッションのホスト環境によって注入されると言う場合は、そのセッションでそれを変更できません。claude.ai にサインインしているセッションを開始します

1201* [可用性](/docs/ja/artifacts#availability) については、プラン、モデルプロバイダー、オーガニゼーションポリシーなど、Artifacts が持つ他の要件を参照してください

1202

1170<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1203<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">

1171 管理者ポリシーがクラウドゲートウェイサインインを必要とします1204 管理者ポリシーがクラウドゲートウェイサインインを必要とします

1172</h3>1205</h3>

1535* セッションで `/login` を実行し、ブラウザサインインを完了します1568* セッションで `/login` を実行し、ブラウザサインインを完了します

1536* 非対話的な起動の場合は、同じ環境で `claude` を起動し、`/login` を実行してから、コマンドを再実行します1569* 非対話的な起動の場合は、同じ環境で `claude` を起動し、`/login` を実行してから、コマンドを再実行します

1537 1570

1571<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">

1572 サインイン中にタイムアウトしました。続行するのを待機しています

1573</h3>

1574

1575[Claude apps gateway](/docs/ja/claude-apps-gateway) サインイン中に、ゲートウェイはサインインしたアカウントに名前を付け、Claude Code はそれを保存する前に確認するよう求めました。ゲートウェイの独自の有効期限を過ぎて確認を開いたままにしておき、ゲートウェイは更新トークンを発行しなかったため、続行したときに Claude Code は何も保存しませんでした：

1576

1577```text theme={null}

1578Sign-in timed out while waiting for you to continue. Try again.

1579```

1580

1581**対応方法：**

1582

1583* `/login` を再度実行し、サインインの有効期限が切れる前にアカウントを確認します

1584

1538<h3 id="gateway-refused-the-request">1585<h3 id="gateway-refused-the-request">

1539 ゲートウェイがリクエストを拒否しました1586 ゲートウェイがリクエストを拒否しました

1540</h3>1587</h3>

2268 2315

2269**対応方法：**2316**対応方法：**

2270 2317

2271* `claude update` を実行して Claude Code を再開してください。Opus 4.7 には v2.1.111 以降が必要です。Opus 4.8 には v2.1.154 以降が必要です。Sonnet 5 には v2.1.197 以降が必要です。Opus 5 には v2.1.219 以降が必要です2318* `claude update` を実行して Claude Code を再開してください。Opus 4.7 には v2.1.111 以降が必要です。Opus 4.8 には v2.1.154 以降が必要です。Sonnet 5 には v2.1.197 以降が必要です。Opus 5 には v2.1.219 以降が必要です。Opus 5.5 には v2.1.280 以降が必要です

2272* アップグレードできない場合は、`/model` を実行して Opus 4.6 または Sonnet 4.6 を選択してください2319* アップグレードできない場合は、`/model` を実行して Opus 4.6 または Sonnet 4.6 を選択してください

2273* [Agent SDK](/docs/ja/agent-sdk/overview)でこれに遭遇した場合は、SDK パッケージをアップグレードしてください。Opus 4.8 には TypeScript SDK v0.3.154 以降と Python SDK v0.2.88 以降が必要です。Sonnet 5 には TypeScript SDK v0.3.197 以降が必要です。Opus 5 には TypeScript SDK v0.3.219 以降が必要です2320* [Agent SDK](/docs/ja/agent-sdk/overview)でこれに遭遇した場合は、SDK パッケージをアップグレードしてください。Opus 4.8 には TypeScript SDK v0.3.154 以降と Python SDK v0.2.88 以降が必要です。Sonnet 5 には TypeScript SDK v0.3.197 以降が必要です。Opus 5 には TypeScript SDK v0.3.219 以降が必要です。Opus 5.5 には TypeScript SDK v0.3.280 以降が必要です

2274 2321

2275<h3 id="effort-isnt-available-with-thinking-turned-off">2322<h3 id="effort-isnt-available-with-thinking-turned-off">

2276 思考がオフの場合、努力は利用できません2323 思考がオフの場合、努力は利用できません

2314 2361

2315```text theme={null}2362```text theme={null}

2316API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.2363API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.

2364API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation.

2365API Error: 400 duplicate tool_use ID in conversation history. Run /rewind to recover the conversation.

2317API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks2366API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks

2318API Error: 400 ... thinking blocks ... cannot be modified2367API Error: 400 ... thinking blocks ... cannot be modified

2319```2368```

2320 2369

23213 つのバリアントはすべて同じことを意味します。履歴内の `tool_use`、`tool_result`、および `thinking` ブロックのシーケンスが、API が期待するものと一致しなくなりました。2370すべてのバリアントは同じことを意味します。履歴内の `tool_use`、`tool_result`、および `thinking` ブロックのシーケンスが、API が期待するものと一致しなくなりました。

2322 2371

2323**対応方法：**2372**対応方法：**

2324 2373

2376API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude2425API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude

2377```2426```

2378 2427

2379メッセージは [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)にリンクしており、正当なサイバーセキュリティ作業へのアクセスを許可します。2428メッセージは [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude)にリンクしており、正当なサイバーセキュリティ作業へのアクセスを許可します。Opus 5.5 では、v2.1.280 以降が必要であり、メッセージは `Opus 5.5's safeguards flagged this session` で開始されます。フラグが立てられたカテゴリにフォールバックモデルが利用可能な場合、Claude Code は [モデルを切り替え](/docs/ja/model-config#automatic-model-fallback)ます。このエラーを表示する代わりに。

2380 2429

2381[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、および [Microsoft Foundry](/docs/ja/microsoft-foundry)では、サイバーセキュリティフラグは代わりに [使用ポリシー拒否](#usage-policy-refusal)メッセージを生成します。2430[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、および [Microsoft Foundry](/docs/ja/microsoft-foundry)では、サイバーセキュリティフラグは代わりに [使用ポリシー拒否](#usage-policy-refusal)メッセージを生成します。

2382 2431

2437* 企業プロキシが転送を閉じ続ける場合は、ネットワークチームに `downloads.claude.ai` からの完全なダウンロードを許可するよう依頼します。[ネットワークアクセス要件](/docs/ja/network-config#network-access-requirements)を参照してください。2486* 企業プロキシが転送を閉じ続ける場合は、ネットワークチームに `downloads.claude.ai` からの完全なダウンロードを許可するよう依頼します。[ネットワークアクセス要件](/docs/ja/network-config#network-access-requirements)を参照してください。

2438* シェルから `claude doctor` を実行して、インストール診断を実行します2487* シェルから `claude doctor` を実行して、インストール診断を実行します

2439 2488

2489***

2490

2491title: "コマンドラインエラー"

2492description: "Claude Code のコマンドラインエラーのトラブルシューティングガイド。エラーメッセージの意味と対処方法を説明します。"

2493-----------------------------------------------------------------------------

2494

2440<h2 id="command-line-errors">2495<h2 id="command-line-errors">

2441 コマンドラインエラー2496 コマンドラインエラー

2442</h2>2497</h2>

3087**対処方法：**3142**対処方法：**

3088 3143

3089* メッセージからセッション ID を使用して `claude --resume <session-id>` を実行して再試行してください。3144* メッセージからセッション ID を使用して `claude --resume <session-id>` を実行して再試行してください。

3145* 再試行が再度失敗する場合は、`claude update` を実行してから再開してください。v2.1.275 より前のバージョンは、保存されたトランスクリプトに読み込めないエントリが含まれている場合、再開に失敗します。

3090* 再試行が再度失敗する場合は、`claude` を実行して新しいセッションを開始してください。3146* 再試行が再度失敗する場合は、`claude` を実行して新しいセッションを開始してください。

3091 3147

3092<h3 id="no-conversation-found-with-the-session-id">3148<h3 id="no-conversation-found-with-the-session-id">

3139 3195

3140* これらの制限なしで開始されたセッションで、`/tui fullscreen` または `/tui default` を実行して戻してください。Claude Code はそこで [`tui` 設定](/docs/ja/settings-reference#tui)を保存します。3196* これらの制限なしで開始されたセッションで、`/tui fullscreen` または `/tui default` を実行して戻してください。Claude Code はそこで [`tui` 設定](/docs/ja/settings-reference#tui)を保存します。

3141 3197

3198<h3 id="couldnt-open-claude-desktop">

3199 Claude Desktop を開くことができませんでした

3200</h3>

3201

3202[`/desktop`](/docs/ja/desktop#coming-from-the-cli) またはそのエイリアス `/app` を実行しましたが、Claude Desktop を開くために Claude Code が使用するシステムコマンドが失敗しました。セッションはターミナルに留まります。

3203

3204```text theme={null}

3205Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.

3206```

3207

3208**対処方法：**

3209

3210* Claude Desktop を自分で開いてから、`/desktop` を再度実行してください。

3211* そのコマンドの完全なエラー出力を読むには、`/debug` でデバッグログをオンにし、`/desktop` を再度実行してから、デバッグログを確認してください。

3212

3213v2.1.275 より前は、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかを言いませんでした。

3214

3142<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3215<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3143 /terminal-setup は Zed キーマップを変更しませんでした3216 /terminal-setup は Zed キーマップを変更しませんでした

3144</h3>3217</h3>

3256* 名前が予約される前にその名前を使用していたサードパーティマーケットプレイスを公開する場合は、名前を変更し、ユーザーにあなたのソースから再度追加するよう依頼してください3329* 名前が予約される前にその名前を使用していたサードパーティマーケットプレイスを公開する場合は、名前を変更し、ユーザーにあなたのソースから再度追加するよう依頼してください

3257* [マーケットプレイススキーマ](/docs/ja/plugin-marketplaces#marketplace-schema)の予約名リストを参照してください3330* [マーケットプレイススキーマ](/docs/ja/plugin-marketplaces#marketplace-schema)の予約名リストを参照してください

3258 3331

3332<h3 id="marketplace-is-already-added-from-a-different-source">

3333 マーケットプレイスが既に別のソースから追加されている

3334</h3>

3335

3336[`/plugin install <plugin> --marketplace <source>`](/docs/ja/discover-plugins#add-a-marketplace-and-install-in-one-command)を通じてマーケットプレイスの追加を確認し、そのソースから Claude Code が取得したカタログが、別のソースから既に追加したマーケットプレイスと同じ名前を付けています。Claude Code は既存のマーケットプレイスを保持し、それを置き換えず、プラグインはインストールされません。

3337

3338```text theme={null}

3339Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

3340```

3341

3342**対処方法：**

3343

3344* 既に追加したマーケットプレイスが必要なものである場合は、名前でそこからインストールしてください：`/plugin install <plugin>@<name>`

3345* 新しいソースに切り替えるには、`/plugin marketplace remove <name>` を実行してから、インストールを再試行してください

3346

3259<h3 id="plugin-command-references-user-config">3347<h3 id="plugin-command-references-user-config">

3260 プラグインコマンドがシェルコマンドで user\_config を参照している3348 プラグインコマンドがシェルコマンドで user\_config を参照している

3261</h3>3349</h3>

3380プラグインの[マーケットプレイスエントリ](/docs/ja/plugin-marketplaces#plugin-entries)は、Claude Code がマーケットプレイス自体のディレクトリ内の場所に解決できないソースパスを宣言しているため、プラグインはインストールまたは読み込まれません。拒否は以下をカバーしています：3468プラグインの[マーケットプレイスエントリ](/docs/ja/plugin-marketplaces#plugin-entries)は、Claude Code がマーケットプレイス自体のディレクトリ内の場所に解決できないソースパスを宣言しているため、プラグインはインストールまたは読み込まれません。拒否は以下をカバーしています：

3381 3469

3382* 絶対パス、`..` でマーケットプレイスから抜け出す、またはネットワークパスのようにスペルされたエントリパス3470* 絶対パス、`..` でマーケットプレイスから抜け出す、またはネットワークパスのようにスペルされたエントリパス

3471* macOS と Linux では、先頭の `./` の後のどこかにバックスラッシュが含まれているエントリパス

3383* git または URL などのリモートソースから取得されたマーケットプレイス内のエントリで、マーケットプレイスディレクトリの外に解決するシンボリックリンクを通じてターゲットに到達する3472* git または URL などのリモートソースから取得されたマーケットプレイス内のエントリで、マーケットプレイスディレクトリの外に解決するシンボリックリンクを通じてターゲットに到達する

3384* マーケットプレイスの `marketplace.json` への直接 URL から追加された相対エントリ：Claude Code はそのファイルのみをダウンロードするため、パスが名前を付けるローカルプラグインファイルは存在しません。[相対パスを持つプラグインが URL ベースのマーケットプレイスで失敗する](/docs/ja/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照してください3473* マーケットプレイスの `marketplace.json` への直接 URL から追加された相対エントリ：Claude Code はそのファイルのみをダウンロードするため、パスが名前を付けるローカルプラグインファイルは存在しません。[相対パスを持つプラグインが URL ベースのマーケットプレイスで失敗する](/docs/ja/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照してください

3385 3474

3424* `~/.claude/plugins/known_marketplaces.json` を開き、JSON を修復するか、メッセージが名前を付けるエントリがレジストリスキーマと一致しないように修正してください3513* `~/.claude/plugins/known_marketplaces.json` を開き、JSON を修復するか、メッセージが名前を付けるエントリがレジストリスキーマと一致しないように修正してください

3425* 修復できない場合は、ファイルを削除するか、その内容を `{}` に置き換えてから、`claude plugin marketplace add <source>` で各マーケットプレイスを再度追加してください。Claude Code は、信頼したフォルダで次回起動するときに、ユーザーまたはマネージド設定で [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) で宣言したマーケットプレイスを再登録します。3514* 修復できない場合は、ファイルを削除するか、その内容を `{}` に置き換えてから、`claude plugin marketplace add <source>` で各マーケットプレイスを再度追加してください。Claude Code は、信頼したフォルダで次回起動するときに、ユーザーまたはマネージド設定で [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) で宣言したマーケットプレイスを再登録します。

3426 3515

3516<h3 id="plugin-is-required-by-your-organization">

3517 プラグインは組織で必須です

3518</h3>

3519

3520`claude plugin disable` を実行するか、`/plugin` **Installed** タブを使用して、組織が必須としてマークしている [claude.ai から同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins)をオフにしました：

3521

3522```text theme={null}

3523Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.

3524```

3525

3526Claude Code は何も保存せず、プラグインは有効なままです。

3527

3528必須プラグインが依存するプラグインを無効にしようとすると、Claude Code は同じ方法で拒否し、それが必要な必須プラグインに名前を付けるメッセージを表示します。

3529

3530**対処方法：**

3531

3532* claude.ai 組織の管理者に、プラグインの必須ステータスを claude.ai で変更するよう依頼してください

3533

3427<h2 id="tool-errors">3534<h2 id="tool-errors">

3428 ツールエラー3535 ツールエラー

3429</h2>3536</h2>

3452 3559

3453* エラーが指定する各エントリを [subagent が利用可能なツール](/docs/ja/sub-agents#available-tools)に対して修正します3560* エラーが指定する各エントリを [subagent が利用可能なツール](/docs/ja/sub-agents#available-tools)に対して修正します

3454* セッションが持たないツール（接続されていないサーバーからの MCP ツールなど）のエントリを削除します3561* セッションが持たないツール（接続されていないサーバーからの MCP ツールなど）のエントリを削除します

3455* [バックグラウンド subagent が削除する](/docs/ja/sub-agents#available-tools)ツール（`LSP` など）の場合、エントリを削除します。ツールを保持するには、[fork モードをオフにして](/docs/ja/sub-agents#turn-fork-mode-on-or-off)、Claude に subagent をフォアグラウンドで実行するよう依頼します3562* [バックグラウンド subagent が削除する](/docs/ja/sub-agents#available-tools)ツール（`CronCreate` など）の場合、エントリを削除します。ツールを保持するには、[fork モードをオフにして](/docs/ja/sub-agents#turn-fork-mode-on-or-off)、Claude に subagent をフォアグラウンドで実行するよう依頼します

3456* `tools` フィールドを削除して、subagent に [subagent が利用可能なすべてのツール](/docs/ja/sub-agents#available-tools)を与えます3563* `tools` フィールドを削除して、subagent に [subagent が利用可能なすべてのツール](/docs/ja/sub-agents#available-tools)を与えます

3457* `Agent` のみを含む `tools` リストの場合、[深さ制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)を上げるか、エージェントに少なくとも 1 つの他のツールを与えます。Claude Code はその制限でこの深さで `Agent` を保留するため、それ以外に何もないリストは、ツールなしに解決されます3564* `Agent` のみを含む `tools` リストの場合、[深さ制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents)を上げるか、エージェントに少なくとも 1 つの他のツールを与えます。Claude Code はその制限でこの深さで `Agent` を保留するため、それ以外に何もないリストは、ツールなしに解決されます

3458 3565

3812* 通常は何もしません：Claude はメッセージが要求するローカルスペルで再試行します3919* 通常は何もしません：Claude はメッセージが要求するローカルスペルで再試行します

3813* ファイルがローカルファイルのスペルが付いたネットワークパスではなく、ネットワーク共有上にある場合、セッションのローカルワークスペースの外にあります。通常のインタラクティブセッションから編集してください3920* ファイルがローカルファイルのスペルが付いたネットワークパスではなく、ネットワーク共有上にある場合、セッションのローカルワークスペースの外にあります。通常のインタラクティブセッションから編集してください

3814 3921

3922<h3 id="command-blocked-by-the-worktree-isolation-checks">

3923 worktree 分離チェックによってコマンドがブロックされました

3924</h3>

3925

3926Claude は、[worktree に分離されたセッション](/docs/ja/worktrees#how-claude-code-enforces-isolation)で Bash または Monitor コマンドを実行し、Claude Code は 2 つの理由のいずれかでそれを拒否しました：

3927

3928* コマンドは git をメインチェックアウトに指します。

3929* Claude Code は、コマンドテキストからコマンドが実行する git が worktree 内に留まることを確認できません。git に名前を付けないコマンドでも、`${!name}` などの変数間接参照を展開するか、`${ command; }` などの Bash 関数置換を実行すると、実行時に値が生成される可能性があるため、この理由で拒否される可能性があります。

3930

3931メッセージの中央は、検証できなかったものに名前を付けます：

3932

3933```text wrap theme={null}

3934This session is isolated in the worktree /path/to/worktree, but this command evaluates ${!x@P} arithmetically inside a construct too complex to verify, which can run a command hidden in a variable's value. Refusing to run it — a worktree-isolated session's git operations must target its own worktree. Split it into plain, separate commands and run them from /path/to/worktree.

3935```

3936

3937**対処方法：**

3938

3939* 通常は何もしません：Claude はメッセージを読み、最後の文が要求する方法でコマンドを書き直します

3940* 要求したコマンドが拒否され続ける場合、フラグが付いた値をリテラルでスペルします：間接参照または置換をその値に置き換え、git を worktree 内から独自のプレーンコマンドとして実行します

3941* メインチェックアウトで意図的に動作するには、セッション外のターミナルでコマンドを自分で実行します

3942

3815<h3 id="this-session-has-no-saved-transcript">3943<h3 id="this-session-has-no-saved-transcript">

3816 このセッションに保存されたトランスクリプトがありません3944 このセッションに保存されたトランスクリプトがありません

3817</h3>3945</h3>

4201 4329

4202Claude Code は、[retention sweep](/docs/ja/claude-directory#cleaned-up-automatically) でセッションのバックアップを削除します。デフォルトではセッションが最後にバックアップを保存してから約 30 日後です。その後にセッションを再開した場合、`/rewind` はそのチェックポイントをリストしますが、そのいずれかに rewind すると、このエラーで失敗する可能性があります。メッセージに `N paths were skipped for link safety` も表示されている場合は、これらのパスについて [Restored the code, but skipped files](#restored-the-code-but-skipped-files) を参照してください。4330Claude Code は、[retention sweep](/docs/ja/claude-directory#cleaned-up-automatically) でセッションのバックアップを削除します。デフォルトではセッションが最後にバックアップを保存してから約 30 日後です。その後にセッションを再開した場合、`/rewind` はそのチェックポイントをリストしますが、そのいずれかに rewind すると、このエラーで失敗する可能性があります。メッセージに `N paths were skipped for link safety` も表示されている場合は、これらのパスについて [Restored the code, but skipped files](#restored-the-code-but-skipped-files) を参照してください。

4203 4331

4332セッションをフォークする場合（例えば [`--fork-session`](/docs/ja/cli-reference#cli-flags) または [`/branch`](/docs/ja/sessions#branch-a-session) を使用する場合）、Claude Code は元のセッションのバックアップをフォークにコピーします。Claude Code がバックアップをコピーできない場合（例えばディスクがいっぱいの場合）、そのバックアップはフォークに存在しません。それを必要とするチェックポイントに rewind すると、このエラーで失敗する可能性があります。

4333

4204**対応方法：**4334**対応方法：**

4205 4335

4206* 別の方法で変更を元に戻してください。Claude に編集を逆にするよう依頼するか、バージョン管理からファイルを復元してください。バックアップがなくなると、`/rewind` を再度実行しても同じ方法で失敗します。4336* 別の方法で変更を元に戻してください。Claude に編集を逆にするよう依頼するか、バージョン管理からファイルを復元してください。バックアップがなくなると、`/rewind` を再度実行しても同じ方法で失敗します。

4458* マシンを管理している場合は、名前が付けられたドキュメントを JSON オブジェクトとして解析するように修正するか、ファイル、プロファイル、またはレジストリ値を削除してください。空の `managed-settings.json` は `{}` としてカウントされ、起動をブロックしません。4588* マシンを管理している場合は、名前が付けられたドキュメントを JSON オブジェクトとして解析するように修正するか、ファイル、プロファイル、またはレジストリ値を削除してください。空の `managed-settings.json` は `{}` としてカウントされ、起動をブロックしません。

4459* そうでない場合は、管理者に、デプロイされたドキュメントを修正するよう依頼してください。独自の設定ファイルの何もこのエラーを引き起こしたり、クリアしたりしません。4589* そうでない場合は、管理者に、デプロイされたドキュメントを修正するよう依頼してください。独自の設定ファイルの何もこのエラーを引き起こしたり、クリアしたりしません。

4460 4590

4591<h3 id="otelheadershelper-failed">

4592 otelHeadersHelper が失敗しました

4593</h3>

4594

4595Claude Code は、[`otelHeadersHelper`](/docs/ja/settings-reference#otelheadershelper) スクリプトが失敗したか、[スクリプト要件](/docs/ja/monitoring-usage#script-requirements) を満たさない出力を出力したときに、この警告を対話型セッションで通知として表示します。

4596

4597スクリプトが失敗し続ける間、エクスポートは失敗し、テレメトリバックエンドはセッションから何も受け取りません。

4598

4599`See /status:` の後のテキストは、スクリプトの終了コードとそのエラー出力など、失敗した内容を示しています。

4600

4601```text theme={null}

4602otelHeadersHelper failed; telemetry is not being exported. See /status: exited 1: token service unreachable

4603```

4604

4605**対応方法：**

4606

4607* `/status` を実行して、失敗の詳細を読んでください。

4608* スクリプトが 30 秒以内に終了コード 0 で終了し、stdout に文字列ヘッダー値の JSON オブジェクトを出力するように修正してください。[スクリプト要件](/docs/ja/monitoring-usage#script-requirements) を参照してください。

4609* 組織が [管理設定](/docs/ja/managed-settings) を通じてスクリプトをデプロイしている場合は、それを保守している人にそれを修正するよう依頼してください。

4610

4611[非対話型モード](/docs/ja/headless) で `-p` を使用する場合、同じ失敗は stderr に `otelHeadersHelper failed (OpenTelemetry export headers unavailable): <error>` として表示されます。

4612

4461<h3 id="headershelper-not-run">4613<h3 id="headershelper-not-run">

4462 headersHelper が実行されていません4614 headersHelper が実行されていません

4463</h3>4615</h3>

4652 4804

4653* 設定された [`--fallback-model`](/docs/ja/cli-reference#cli-flags) は可用性エラーの後、そのターンのみ引き継ぎ、トランスクリプトに通知が表示されます4805* 設定された [`--fallback-model`](/docs/ja/cli-reference#cli-flags) は可用性エラーの後、そのターンのみ引き継ぎ、トランスクリプトに通知が表示されます

4654* Amazon Bedrock または Google Cloud の Agent Platform スタートアップチェックがデフォルトモデルが利用不可であることを検出します4806* Amazon Bedrock または Google Cloud の Agent Platform スタートアップチェックがデフォルトモデルが利用不可であることを検出します

4655* [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) は Fable 5.1、Fable 5、Opus 5 でセッションをフラグが付いたカテゴリのフォールバックモデルに移動し、そのカテゴリにフォールバックモデルがある場合、トランスクリプトに通知が表示されます4807* [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) は Fable 5.1、Fable 5、Opus 5.5、Opus 5 でセッションをフラグが付いたカテゴリのフォールバックモデルに移動し、そのカテゴリにフォールバックモデルがある場合、トランスクリプトに通知が表示されます

4656 4808

4657以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします。最初のケースはトランスクリプト通知として表示され、`/model` の変更ではなく表示されます。[モデル設定](/docs/ja/model-config) は各フォールバックが適用される時期を説明しています。4809以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします。最初のケースはトランスクリプト通知として表示され、`/model` の変更ではなく表示されます。[モデル設定](/docs/ja/model-config) は各フォールバックが適用される時期を説明しています。

4658 4810

fast-mode.md +12 −7

Details

12 12

13高速モードは Claude Opus の高速構成で、モデルを最大 2.5 倍高速化しますが、トークンあたりのコストは高くなります。迅速な反復やライブデバッグなどのインタラクティブな作業で速度が必要な場合は `/fast` でオンにし、コストがレイテンシーより重要な場合はオフにします。13高速モードは Claude Opus の高速構成で、モデルを最大 2.5 倍高速化しますが、トークンあたりのコストは高くなります。迅速な反復やライブデバッグなどのインタラクティブな作業で速度が必要な場合は `/fast` でオンにし、コストがレイテンシーより重要な場合はオフにします。

14 14

15高速モードは異なるモデルではありません。Claude Opus を使用していますが、コスト効率よりも速度を優先する異なる API 構成です。同じ品質と機能が得られ、レスポンスが高速化されるだけです。高速モードは Opus 5 および Opus 4.8 でサポートされています。Sonnet、Haiku、または他のモデルでは利用できません。15高速モードは異なるモデルではありません。Claude Opus を使用していますが、コスト効率よりも速度を優先する異なる API 構成です。同じ品質と機能が得られ、レスポンスが高速化されるだけです。高速モードは Opus 5.5、Opus 5、および Opus 4.8 でサポートされています。Sonnet、Haiku、または他のモデルでは利用できません。

16 16

17Claude Code は Opus 4.7 を高速モードをサポートしていない他のモデルと同じように扱います。Opus 4.7 に切り替えると高速モードがオフになります。Opus 4.7 の高速モードは 2026 年 6 月 25 日に非推奨となり、2026 年 7 月 24 日に削除されました。17Opus 4.7 は高速モードをサポートしていないため、それに切り替えると高速モードがオフになります。Opus 4.7 の高速モードは 2026 年 6 月 25 日に非推奨となり、2026 年 7 月 24 日に削除されました。

18 18

19知っておくべきこと：19知っておくべきこと：

20 20

21* Claude Code CLI で `/fast` を使用して高速モードをオンにします。VS Code Extension は [`fastMode` 設定](#toggle-fast-mode)に従い、選択したモデルが高速モードをサポートしている場合は**高速モードを切り替え**コマンドを提供します。21* Claude Code CLI で `/fast` を使用して高速モードをオンにします。[VS Code 拡張機能](/docs/ja/vs-code)は、選択したモデルが高速モードをサポートしている場合、**高速モードを切り替え**コマンドを提供します。Claude Code はそのトグルを [`fastMode` 設定](#toggle-fast-mode)に保存します。

~~22* 高速モード価格は Opus 5 および Opus 4.8 で入力/出力あたり $10/$50 MTok です。~~22* 高速モード価格は Opus 5.5 で入力/出力あたり $8/$40 MTok、Opus 5 および Opus 4.8 で入力/出力あたり $10/$50 MTok です。

23* サブスクリプションプラン（Pro/Max/Team/Enterprise）の Claude Code ユーザーと Claude Console のすべてのユーザーが利用可能です。Team および Enterprise 組織は Owner が最初に有効にする必要があり、Console 組織はアクセスを最初にプロビジョニングする必要があります。どちらも[要件](#requirements)に記載されています。23* サブスクリプションプラン（Pro/Max/Team/Enterprise）の Claude Code ユーザーと Claude Console のすべてのユーザーが利用可能です。Team および Enterprise 組織は Owner が最初に有効にする必要があり、Console 組織はアクセスを最初にプロビジョニングする必要があります。どちらも[要件](#requirements)に記載されています。

24* サブスクリプションプラン（Pro/Max/Team/Enterprise）の Claude Code ユーザーの場合、高速モードは使用量クレジットのみで利用可能であり、サブスクリプションレート制限に含まれていません。24* サブスクリプションプラン（Pro/Max/Team/Enterprise）の Claude Code ユーザーの場合、高速モードは使用量クレジットのみで利用可能であり、サブスクリプションレート制限に含まれていません。

25 25

29 29

30CLI では、次のいずれかの方法で高速モードを切り替えます：30CLI では、次のいずれかの方法で高速モードを切り替えます：

31 31

~~32* `/fast` と入力して Tab キーを押してオンまたはオフに切り替える~~32* `/fast` を実行して、Space キーを押してオンまたはオフに切り替えてから、Enter キーを押して確認します

33* [ユーザー設定ファイル](/docs/ja/settings)で `"fastMode": true` を設定する33* [ユーザー設定ファイル](/docs/ja/settings)で `"fastMode": true` を設定する

34 34

35デフォルトでは、インタラクティブセッションで有効にした高速モードはセッション全体で保持されます。高速モードを各セッションでリセットするように構成できます。詳細は[セッションごとのオプトインが必要](#require-per-session-opt-in)を参照してください。35デフォルトでは、インタラクティブセッションで有効にした高速モードはセッション全体で保持されます。高速モードを各セッションでリセットするように構成できます。詳細は[セッションごとのオプトインが必要](#require-per-session-opt-in)を参照してください。

47* 高速モードがアクティブな間、プロンプトの横に小さい `↯` アイコンが表示されます47* 高速モードがアクティブな間、プロンプトの横に小さい `↯` アイコンが表示されます

48* いつでも `/fast` を再度実行して、高速モードがオンかオフかを確認できます48* いつでも `/fast` を再度実行して、高速モードがオンかオフかを確認できます

49 49

50Opus 5 は Claude Code v2.1.219 以降の高速モードのデフォルトです。v2.1.219 より前では、高速モードは v2.1.154 から v2.1.218 では Opus 4.8 がデフォルトで、v2.1.142 から v2.1.153 では Opus 4.7 がデフォルトでした。50Opus 5.5 は Claude Code v2.1.280 以降の高速モードのデフォルトです。v2.1.280 より前では、高速モードは v2.1.219 から v2.1.280 では Opus 5 がデフォルトで、v2.1.154 から v2.1.218 では Opus 4.8 がデフォルトで、v2.1.142 から v2.1.153 では Opus 4.7 がデフォルトでした。

51 51

52`/fast` を再度実行して高速モードを無効にすると、Opus に留まります。別のモデルに切り替えるには、`/model` を使用します。52`/fast` を再度実行して高速モードを無効にすると、Opus に留まります。別のモデルに切り替えるには、`/model` を使用します。

53 53

80 80

81| モデル | 入力（MTok） | 出力（MTok） |81| モデル | 入力（MTok） | 出力（MTok） |

82| -------- | -------- | -------- |82| -------- | -------- | -------- |

83| Opus 5.5 | \$8 | \$40 |

83| Opus 5 | \$10 | \$50 |84| Opus 5 | \$10 | \$50 |

84| Opus 4.8 | \$10 | \$50 |85| Opus 4.8 | \$10 | \$50 |

85 86

145* **Team および Enterprise の所有者による有効化**：高速モードは Team および Enterprise 組織ではデフォルトで無効になっています。ユーザーがアクセスできるようにするには、所有者が明示的に[高速モードを有効にする](#enable-fast-mode-for-your-organization)必要があります。146* **Team および Enterprise の所有者による有効化**：高速モードは Team および Enterprise 組織ではデフォルトで無効になっています。ユーザーがアクセスできるようにするには、所有者が明示的に[高速モードを有効にする](#enable-fast-mode-for-your-organization)必要があります。

146 147

147<Note>148<Note>

148 2 つの組織設定が `/fast` で高速モードをオンにすることをブロックできます：149 4 つの組織設定が `/fast` で高速モードをオンにすることをブロックできます：

149 150

150 * **高速モードが有効になっていない**：組織で高速モードが有効になっていない場合、`/fast` で高速モードをオンにすると「Fast mode has been disabled by your organization.」と表示されます。151 * **高速モードが有効になっていない**：組織で高速モードが有効になっていない場合、`/fast` で高速モードをオンにすると「Fast mode has been disabled by your organization.」と表示されます。

152 * **高速モードが管理設定によってオフにされている**：組織が [`fastMode: false`](/docs/ja/settings-reference#fastmode) を設定する[管理設定](/docs/ja/managed-settings)をデプロイしている場合、`/fast` で高速モードをオンにすると同じ「Fast mode has been disabled by your organization」メッセージが表示されます。

153 * **セッションごとのオプトインが必要**：[`fastModePerSessionOptIn: true`](#require-per-session-opt-in) を設定する管理設定は、インタラクティブターミナルセッション以外のすべての場所で `/fast on` を同じメッセージで拒否します。

151 * **高速モードモデルが許可されていない**：組織の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストが高速モード Opus モデルを除外している場合、オンにすることは「is not in your organization's allowed models」で拒否されます。高速モードをサポートする許可された Opus モデルで既に実行中のセッションでは、`/fast` はモデルを切り替える代わりに現在のモデルで高速モードを有効にします。154 * **高速モードモデルが許可されていない**：組織の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストが高速モード Opus モデルを除外している場合、オンにすることは「is not in your organization's allowed models」で拒否されます。高速モードをサポートする許可された Opus モデルで既に実行中のセッションでは、`/fast` はモデルを切り替える代わりに現在のモデルで高速モードを有効にします。

152</Note>155</Note>

153 156

204 207

205これは、ユーザーが複数の同時セッションを実行する組織でコストを制御するのに役立ちます。ユーザーの高速モード設定は保存されたままなので、この設定を削除するとデフォルトの永続的な動作が復元されます。208これは、ユーザーが複数の同時セッションを実行する組織でコストを制御するのに役立ちます。ユーザーの高速モード設定は保存されたままなので、この設定を削除するとデフォルトの永続的な動作が復元されます。

206 209

210管理設定がキーを設定する場合、`/fast on` はインタラクティブターミナルセッションでのみ機能します。[非インタラクティブモード](/docs/ja/headless)、[VS Code 拡張機能](/docs/ja/vs-code)、および[クラウドセッション](#use-fast-mode-in-cloud-sessions)を含むその他のすべての場所では、組織が高速モードを無効化したというメッセージで拒否されます。

211

207<h2 id="handle-rate-limits">212<h2 id="handle-rate-limits">

208 レート制限の処理213 レート制限の処理

209</h2>214</h2>

features-overview.md +103 −83

Details

21拡張機能は agentic ループのさまざまな部分に接続します。21拡張機能は agentic ループのさまざまな部分に接続します。

22 22

23* **[CLAUDE.md](/docs/ja/memory)** は、Claude がすべてのセッションで見る永続的なコンテキストを追加します23* **[CLAUDE.md](/docs/ja/memory)** は、Claude がすべてのセッションで見る永続的なコンテキストを追加します

24* **[Output styles](/docs/ja/output-styles)** はすべてのセッションのすべての応答に対して Claude の役割、トーン、応答形式を設定します

24* **[Skills](/docs/ja/skills)** は再利用可能な知識と呼び出し可能なワークフローを追加します25* **[Skills](/docs/ja/skills)** は再利用可能な知識と呼び出し可能なワークフローを追加します

25* **[Code intelligence](/docs/ja/tools-reference#lsp-tool-behavior)** は Claude を言語サーバーに接続し、シンボルレベルのナビゲーションとライブ型エラーを実現します26* **[Code intelligence](/docs/ja/tools-reference#lsp-tool-behavior)** は Claude を言語サーバーに接続し、シンボルレベルのナビゲーションとライブ型エラーを実現します

26* **[MCP](/docs/ja/mcp)** は Claude を外部サービスとツールに接続します27* **[MCP](/docs/ja/mcp)** は Claude を外部サービスとツールに接続します

33[Skills](/docs/ja/skills) は最も柔軟な拡張機能です。スキルは知識、ワークフロー、または指示を含むマークダウンファイルです。`/deploy` のようなコマンドでスキルを呼び出すことができます。または Claude は関連する場合に自動的にスキルをロードできます。スキルは現在の会話で実行することも、subagents を介して独立したコンテキストで実行することもできます。34[Skills](/docs/ja/skills) は最も柔軟な拡張機能です。スキルは知識、ワークフロー、または指示を含むマークダウンファイルです。`/deploy` のようなコマンドでスキルを呼び出すことができます。または Claude は関連する場合に自動的にスキルをロードできます。スキルは現在の会話で実行することも、subagents を介して独立したコンテキストで実行することもできます。

34 35

35<h2 id="match-features-to-your-goal">36<h2 id="match-features-to-your-goal">

~~36 機能をあなたの目標に合わせる~~37 目標に合わせて機能を選択する

37</h2>38</h2>

38 39

39機能は、Claude がすべてのセッションで見る常時オンのコンテキストから、あなたまたは Claude が呼び出すことができるオンデマンド機能、特定のイベントで実行されるバックグラウンド自動化まで、さまざまです。以下の表は、利用可能な機能と各機能が適切な場合を示しています。40機能は、Claude がすべてのセッションで見る常時オンのコンテキストから、ユーザーまたは Claude が呼び出せるオンデマンド機能、特定のイベントで実行されるバックグラウンド自動化まで、様々な範囲に及びます。以下の表は、利用可能な機能と、各機能が適切な場面を示しています。

40 41

41| 機能 | 機能 | 使用する場合 | 例 |42| 機能 | 機能説明 | 使用場面 | 例 |

42| -------------------------------------------------------------- | --------------------------------------------------------- | ----------------------------------- | ------------------------------------------------------------ |43| -------------------------------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------ |

52 54

53**[Plugins](/docs/ja/plugins)** はパッケージングレイヤーです。プラグインはスキル、フック、subagents、MCP サーバーを単一のインストール可能なユニットにバンドルします。プラグインスキルは名前空間化されています（`/my-plugin:review` のように）ため、複数のプラグインが共存できます。同じセットアップを複数のリポジトリで再利用したい場合、または **[marketplace](/docs/ja/plugin-marketplaces)** を通じて他のユーザーに配布したい場合はプラグインを使用します。55**[Plugins](/docs/ja/plugins)** はパッケージングレイヤーです。プラグインはスキル、フック、subagent、MCP サーバーを単一のインストール可能なユニットにバンドルします。プラグインスキルは名前空間化されているため（`/my-plugin:review` など）、複数のプラグインが共存できます。複数のリポジトリ全体で同じセットアップを再利用したい場合、または **[marketplace](/docs/ja/plugin-marketplaces)** を通じて他のユーザーに配布したい場合はプラグインを使用します。

54 56

55<h3 id="build-your-setup-over-time">57<h3 id="build-your-setup-over-time">

56 セットアップを時間をかけて構築する58 セットアップを時間をかけて構築する

59すべてを事前に設定する必要はありません。各機能には認識可能なトリガーがあり、ほとんどのチームはおおよそこの順序で追加します。61すべてを事前に設定する必要はありません。各機能には認識可能なトリガーがあり、ほとんどのチームはおおよそこの順序で追加します。

60 62

61| トリガー | 追加 |63| トリガー | 追加 |

~~62| :-------------------------------------------- | :------------------------------------------------------------------------------ |~~64| :---------------------------------------------- | :-------------------------------------------------------------------------------- |

~~63| Claude が規約またはコマンドを 2 回間違える | [CLAUDE.md](/docs/ja/memory) に追加 |~~65| Claude が規約またはコマンドを 2 回間違える | [CLAUDE.md](/docs/ja/memory) に追加する |

64| 同じプロンプトをタスクを開始するために何度も入力している | ユーザーが呼び出し可能な [skill](/docs/ja/skills) として保存 |66| Claude をより短く、より詳しく説明するか、同じ形式で答えるよう何度も依頼している | [output style](/docs/ja/output-styles) を設定する |

65| 同じプレイブックまたは複数ステップの手順をチャットに 3 回目に貼り付けている | [skill](/docs/ja/skills) としてキャプチャ |67| タスクを開始するために同じプロンプトを何度も入力している | ユーザーが呼び出せる [skill](/docs/ja/skills) として保存する |

66| Claude が見ることができないブラウザタブからデータをコピーし続けている | そのシステムを [MCP server](/docs/ja/mcp) として接続 |68| 同じプレイブックまたは複数ステップの手順をチャットに 3 回目に貼り付けている | [skill](/docs/ja/skills) としてキャプチャする |

67| Claude が多くのファイルを読み取ってシンボルが定義または使用されている場所を見つける | 言語用の [code intelligence plugin](/docs/ja/discover-plugins#code-intelligence) をインストール |69| Claude が見ることができないブラウザタブからデータをコピーし続けている | そのシステムを [MCP server](/docs/ja/mcp) として接続する |

68| サイドタスクが会話に再度参照しない出力で満杯になっている | [subagent](/docs/ja/sub-agents) を通じてルーティング |70| Claude が多くのファイルを読み取ってシンボルが定義または使用されている場所を見つけている | 言語用の [code intelligence plugin](/docs/ja/discover-plugins#code-intelligence) をインストールする |

~~69| 何かが毎回聞かずに起こることを望んでいる | [hook](/docs/ja/hooks-guide) を記述 |~~71| サイドタスクが会話に再度参照しない出力で満杯になっている | [subagent](/docs/ja/sub-agents) を通してルーティングする |

70| 2 番目のリポジトリが同じセットアップを必要としている | [plugin](/docs/ja/plugins) としてパッケージ化 |72| 何かが毎回起こることを望んでいる（尋ねることなく） | [hook](/docs/ja/hooks-guide) を作成する |

71 73| 2 番目のリポジトリが同じセットアップを必要としている | [plugin](/docs/ja/plugins) としてパッケージ化する |

72同じトリガーは、既に持っているものを更新する時期を示します。繰り返される間違いまたは繰り返されるレビューコメントは、チャットでの 1 回限りの修正ではなく、CLAUDE.md の編集です。手動で何度も調整するワークフローは、別の改訂が必要なスキルです。74

75同じトリガーは、既に持っているものを更新するタイミングを示します。繰り返される間違いまたは繰り返されるレビューコメントは、チャットでの 1 回限りの修正ではなく、CLAUDE.md の編集です。手動で何度も調整するワークフローは、別の改訂が必要なスキルです。

73 76

74<h3 id="compare-similar-features">77<h3 id="compare-similar-features">

75 類似機能を比較する78 類似機能を比較する

76</h3>79</h3>

77 80

78一部の機能は似ているように見えることがあります。より詳しい説明については、[Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) をブログで参照してください。ここでは、それらを区別する方法を説明します。81一部の機能は似ているように見えることがあります。それらの間で選択するためのより深い説明については、ブログの [Steering Claude Code: when to use CLAUDE.md, skills, hooks, and subagents](https://claude.com/blog/steering-claude-code-skills-hooks-rules-subagents-and-more) を参照してください。それらを区別する方法は次のとおりです。

79 82

80<Tabs>83<Tabs>

81 <Tab title="Skill vs Subagent">84 <Tab title="Skill vs Subagent">

~~82 スキルと subagents は異なる問題を解決します。~~85 スキルと subagent は異なる問題を解決します。

83 86

~~84 * **Skills** は任意のコンテキストにロードできる再利用可能なコンテンツです~~87 * **Skills** は任意のコンテキストに読み込める再利用可能なコンテンツです

~~85 * **Subagents** はメイン会話とは別に実行される独立したワーカーです~~88 * **Subagents** はメインの会話とは別に実行される分離されたワーカーです

86 89

87 | 側面 | Skill | Subagent |90 | 側面 | Skill | Subagent |

~~88 | --------------------------------------------- | ------------------------- | ------------------------------ |~~91 | --------------------------------------------- | --------------------- | ----------------------------- |

93 96

94 **スキルはリファレンスまたはアクションです。** リファレンススキルは Claude がセッション全体で使用する知識を提供します（API スタイルガイドなど）。アクションスキルは Claude に特定の操作を実行するよう指示します（デプロイメントワークフローを実行する `/deploy` など）。97 **スキルは参照またはアクションです。** 参照スキルは Claude がセッション全体で使用する知識を提供します（API スタイルガイドなど）。アクションスキルは Claude に特定の操作を実行するよう指示します（デプロイメントワークフローを実行する `/deploy` など）。

95 98

96 **コンテキスト分離が必要な場合、またはコンテキストウィンドウがいっぱいになっている場合は subagent を使用します。** subagent は数十のファイルを読み取るか、広範な検索を実行する可能性がありますが、メイン会話はサマリーのみを受け取ります。subagent の作業はメインコンテキストを消費しないため、中間作業を表示したままにする必要がない場合にも便利です。カスタム subagents は独自の指示を持つことができ、スキルをプリロードできます。99 **コンテキスト分離が必要な場合、またはコンテキストウィンドウが満杯になっている場合は subagent を使用します。** subagent は数十のファイルを読み取ったり、広範な検索を実行したりする可能性がありますが、メインの会話は要約のみを受け取ります。subagent の作業はメインコンテキストを消費しないため、中間作業を表示したままにする必要がない場合にも便利です。カスタム subagent は独自の指示を持つことができ、スキルをプリロードできます。

97 100

98 **それらは組み合わせることができます。** subagent は特定のスキルをプリロードできます（`skills:` フィールド）。スキルは `context: fork` を使用して独立したコンテキストで実行できます。詳細は [Skills](/docs/ja/skills) を参照してください。101 **それらは組み合わせることができます。** subagent は特定のスキルをプリロードできます（`skills:` フィールド）。スキルは `context: fork` を使用して分離されたコンテキストで実行できます。詳細は [Skills](/docs/ja/skills) を参照してください。

99 </Tab>102 </Tab>

100 103

101 <Tab title="CLAUDE.md vs Skill">104 <Tab title="CLAUDE.md vs Skill">

102 どちらも指示を保存しますが、ロード方法と目的が異なります。105 どちらも指示を保存しますが、読み込み方法と目的が異なります。

103 106

104 | 側面 | CLAUDE.md | Skill |107 | 側面 | CLAUDE.md | Skill |

105 | ------------------- | ------------------ | ------------------------- |108 | ------------------ | ------------------ | ------------------ |

106 | **ロード** | すべてのセッション、自動的に | オンデマンド |109 | **読み込み** | すべてのセッション、自動的に | オンデマンド |

108 | **ワークフローをトリガーできます** | いいえ | はい、`/<name>` 付き |111 | **ワークフローをトリガーできる** | いいえ | はい、`/<name>` 付き |

110 113

111 **Claude が常に知っておくべき場合は CLAUDE.md に入れます。** コーディング規約、ビルドコマンド、プロジェクト構造、「X を実行しない」ルール。114 **Claude が常に知っておくべき場合は CLAUDE.md に入れます。** コーディング規約、ビルドコマンド、プロジェクト構造、「X を実行しないでください」ルール。

112 115

113 **Claude が時々必要とするリファレンスマテリアル（API ドキュメント、スタイルガイド）の場合、またはあなたが `/<name>` でトリガーするワークフロー（デプロイ、レビュー、リリース）の場合は、スキルに入れます。**116 **Claude が時々必要とする参照資料（API ドキュメント、スタイルガイド）または `/<name>` でトリガーするワークフロー（デプロイ、レビュー、リリース）の場合は、スキルに入れます。**

114 117

115 **経験則：** CLAUDE.md を 200 行以下に保ちます。増加している場合は、リファレンスコンテンツをスキルに移動するか、[`.claude/rules/`](/docs/ja/memory#organize-rules-with-claude%2Frules%2F) ファイルに分割します。118 **経験則：** CLAUDE.md を 200 行以下に保ちます。成長している場合は、参照コンテンツをスキルに移動するか、[`.claude/rules/`](/docs/ja/memory#organize-rules-with-claude/rules/) ファイルに分割します。

119 </Tab>

120

121 <Tab title="CLAUDE.md vs Output style">

122 どちらも Claude に常時指示を与えます。CLAUDE.md は Claude が知っておくべきことを含み、output style は Claude がどのように応答するかを設定します。

123

124 | 側面 | CLAUDE.md | Output style |

125 | --------- | ----------------------------- | ------------------------------------------------------------------------------- |

126 | **保持する** | プロジェクトに関する事実とルール | ロール、トーン、応答形式 |

127 | **切り替え** | 常に読み込まれる | 一度に 1 つアクティブ。[スタイルを切り替える](/docs/ja/output-styles#change-your-output-style) ことはいつでも可能 |

128 | **最適な用途** | ビルドコマンド、規約、「X を実行しないでください」ルール | より短い応答、コードと一緒に説明、非エンジニアリングロール |

129

130 **プロジェクトに対して真実である場合は CLAUDE.md に入れます。** どのスタイルを使用していても、コーディング規約、ビルドコマンド、プロジェクト構造。

131

132 **応答自体に関するもので、再度オフにしたい場合は output style を使用します。** 長さ、形式、Claude がどの程度説明するか、またはライティングアシスタントなどの異なるロール。Claude Code には [組み込みスタイル](/docs/ja/output-styles#built-in-output-styles) が含まれており、独自のスタイルを作成できます。

133

134 **それらは組み合わせます。** CLAUDE.md はどのスタイルを選択しても読み込まれたままです。Claude は両方を指示として従うため、どちらも強制されません。毎回実行する必要があるものについては、[hook](/docs/ja/hooks-guide) を使用します。

116 </Tab>135 </Tab>

117 136

118 <Tab title="CLAUDE.md vs Rules vs Skills">137 <Tab title="CLAUDE.md vs Rules vs Skills">

119 3 つすべてが指示を保存しますが、ロード方法が異なります。138 3 つすべてが指示を保存しますが、読み込み方法が異なります。

120 139

122 | --------- | ------------ | ----------------------------- | ------------------------ |141 | --------- | ------------ | ---------------------------- | -------------------------- |

126 145

127 **すべてのセッションが必要とする指示には CLAUDE.md を使用します。** ビルドコマンド、テスト規約、プロジェクトアーキテクチャ。146 **すべてのセッションが必要とする指示には CLAUDE.md を使用します。** ビルドコマンド、テスト規約、プロジェクトアーキテクチャ。

128 147

129 **CLAUDE.md を焦点を当てたままにするためにルールを使用します。** [`paths` frontmatter](/docs/ja/memory#path-specific-rules) を持つルールは、Claude がマッチングファイルで作業するときのみロードされ、コンテキストを節約します。148 **CLAUDE.md を焦点を当てるためにルールを使用します。** [`paths` frontmatter](/docs/ja/memory#path-specific-rules) を持つルールは、Claude が一致するファイルで作業するときのみ読み込まれ、コンテキストを節約します。

130 149

131 **Claude が時々必要とするコンテンツ（API ドキュメントまたは `/<name>` でトリガーするデプロイメントチェックリスト）にはスキルを使用します。**150 **Claude が時々必要とするコンテンツ（API ドキュメントまたは `/<name>` でトリガーするデプロイメントチェックリスト）にはスキルを使用します。**

132 </Tab>151 </Tab>

133 152

134 <Tab title="Subagent vs Dynamic workflow">153 <Tab title="Subagent vs Dynamic workflow">

135 どちらもメイン会話の外で作業を行います。subagents では Claude がターンごとに次に実行するものを決定します。ワークフローではスクリプトが決定します。154 どちらもメインの会話の外で作業を実行します。subagent では、Claude はターンごとに次に実行するものを決定します。ワークフローでは、スクリプトが決定します。

136 155

137 * **Subagents** は Claude がスポーンするワーカーであり、各ワーカーはそれをスポーンした会話にサマリーを返します156 * **Subagents** は Claude が生成するワーカーで、各ワーカーが会話を生成したものに要約を返す

138 * **[Dynamic workflows](/docs/ja/workflows)** は Claude が記述するスクリプトであり、バックグラウンドで多くの subagents を実行し、1 つの結果を返します157 * **[Dynamic workflows](/docs/ja/workflows)** は Claude が作成するスクリプトで、バックグラウンドで多くの subagent を実行し、1 つの結果を返す

139 158

140 **クイックで焦点を絞ったワーカーが必要な場合は subagent を使用します。** 質問を研究する、主張を検証する、ファイルをレビューする。subagent は作業を実行し、サマリーを返します。メイン会話はクリーンなままです。Claude が名前を付けてスポーンした subagents は、互いに [メッセージを送信](/docs/ja/sub-agents#what-loads-at-startup) することもできます。159 **クイックで焦点を当てたワーカーが必要な場合は subagent を使用します。** 質問を調査する、主張を検証する、ファイルをレビューする。subagent は作業を実行して要約を返すため、メインの会話はクリーンなままです。Claude が生成したときに名前を付けた Subagent は、相互に [メッセージを送信](/docs/ja/sub-agents#what-loads-at-startup) することもできます。

141 160

142 \*\*ジョブが [複数の subagents を超えて成長する](/docs/ja/workflows#when-to-use-a-workflow) 場合、または結果を見る前に検証したい場合は dynamic workflow を使用します。たとえば、コードベース全体の監査、大規模な移行、または複数の角度から作成されたプラン。開始するには、[プロンプトでワークフローを要求](/docs/ja/workflows#ask-for-a-workflow-in-your-prompt) してください。161 **ジョブが [複数の subagent を超えて成長する](/docs/ja/workflows#when-to-use-a-workflow) 場合、または結果を見る前に複数の検証を希望する場合は、動的ワークフローを使用します。** コードベース全体の監査、大規模な移行、複数の角度から作成されたプランなど。開始するには、[プロンプトでワークフローを要求します](/docs/ja/workflows#ask-for-a-workflow-in-your-prompt)。

143 162

144 **セッションの 1 つから別のセッションに結果を渡すには、** 最初のセッションの Claude に送信するよう依頼してください。Claude は [cross-session messaging](/docs/ja/cross-session-messaging) で配信します。[複数の Claude を並列実行](/docs/ja/agents) は、複数の Claude を実行する他の方法を比較します。これには、後で確認するために引き継ぐセッションが含まれます。163 **セッションの 1 つから別のセッションに結果を渡すには、** 最初のセッションの Claude に送信するよう依頼します。Claude は [cross-session messaging](/docs/ja/cross-session-messaging) で配信します。[複数の Claude を並列で実行](/docs/ja/agents) は、セッションを手渡して後で確認するなど、複数の Claude を一度に実行する他の方法を比較します。

145 </Tab>164 </Tab>

146 165

147 <Tab title="MCP vs Skill">166 <Tab title="MCP vs Skill">

148 MCP は Claude を外部サービスに接続します。スキルは Claude が知ることを拡張します。これらのサービスを効果的に使用する方法を含みます。167 MCP は Claude を外部サービスに接続します。スキルは Claude が知っていることを拡張し、それらのサービスを効果的に使用する方法を含みます。

149 168

150 | 側面 | MCP | Skill |169 | 側面 | MCP | Skill |

151 | --------- | ------------------------- | ------------------------------------- |170 | --------- | ------------------------- | ------------------------------------- |

153 | **提供** | ツールとデータアクセス | 知識、ワークフロー、リファレンスマテリアル |172 | **提供する** | ツールとデータアクセス | 知識、ワークフロー、参照資料 |

154 | **例** | Slack 統合、データベースクエリ、ブラウザ制御 | コードレビューチェックリスト、デプロイワークフロー、API スタイルガイド |173 | **例** | Slack 統合、データベースクエリ、ブラウザ制御 | コードレビューチェックリスト、デプロイワークフロー、API スタイルガイド |

155 174

156 これらは異なる問題を解決し、一緒に機能します。175 これらは異なる問題を解決し、一緒に機能します。

157 176

158 **MCP** は Claude に外部システムと相互作用する能力を与えます。MCP がなければ、Claude はデータベースをクエリしたり、Slack に投稿したりできません。177 **MCP** は Claude に外部システム用の目的に合わせたツールを提供し、接続と認証はサーバーによって処理されます。

159 178

160 **スキル** は Claude にこれらのツールを効果的に使用する方法についての知識を与え、さらに `/<name>` でトリガーできるワークフローを提供します。スキルには、チームのデータベーススキーマとクエリパターン、または `/post-to-slack` ワークフローとチームのメッセージフォーマットルールが含まれる場合があります。179 **スキル** は Claude にそれらのツールを効果的に使用する方法についての知識を提供し、さらに `/<name>` でトリガーできるワークフローを提供します。スキルには、チームのデータベーススキーマとクエリパターン、または `/post-to-slack` ワークフロー（チームのメッセージフォーマットルール付き）が含まれる場合があります。

161 </Tab>180 </Tab>

162 181

163 <Tab title="Hook vs Skill">182 <Tab title="Hook vs Skill">

164 Claude Code はライフサイクルイベントでフックを実行します。スキルをコンテキストにロードして Claude が適用します。183 Claude Code はライフサイクルイベントでフックを実行します。コンテキストにスキルを読み込んで Claude が適用します。

165 184

166 | 側面 | Hook | Skill |185 | 側面 | Hook | Skill |

167 | ------------- | ------------------------------------------------------------------------------ | ----------------------------------- |186 | ------------- | ------------------------------------------------------------------------- | ------------------------------------------------- |

168 | **実行** | シェルコマンド、HTTP リクエスト、MCP ツール呼び出し、LLM プロンプト、または subagent | Claude が読み取って従う指示 |187 | **実行** | シェルコマンド、HTTP リクエスト、MCP ツール呼び出し、LLM プロンプト、または subagent | Claude が読み取って従う指示 |

170 | **決定論性** | イベントで常に発火。トリガーは保証される | Claude が指示を解釈。結果は異なる可能性 |189 | **決定論** | イベントで常に発火します。トリガーは保証されます | Claude が指示を解釈します。結果は異なる場合があります |

173 192

174 **アクションが毎回同じ方法で実行される必要があり、Claude が考える必要がない場合は hook を使用します。** たとえば、保存時にフォーマット、`rm -rf /` を拒否、セッション終了時に Slack メッセージを投稿。193 **アクションが毎回同じ方法で実行される必要があり、Claude が考える必要がない場合は、フックを使用します。** 例えば、保存時にフォーマットする、`rm -rf /` を拒否する、セッション終了時に Slack メッセージを投稿する。

175 194

176 **Claude が手順をどのように適用するかを決定する必要がある場合、またはコンテンツが知識ではなくスクリプトの場合は skill を使用します。** たとえば、`/release` チェックリスト、API スタイルガイド、デバッグプレイブック。195 **Claude が手順を適用する方法を決定する必要がある場合、またはコンテンツが知識ではなくスクリプトの場合は、スキルを使用します。** 例えば、`/release` チェックリスト、API スタイルガイド、デバッグプレイブック。

177 196

178 **ガードレールをフックに入れます。** CLAUDE.md またはスキルの「`.env` を編集しない」のような指示はリクエストであり、保証ではありません。編集をブロックする `PreToolUse` フックは強制です。ルールが毎回保持される必要がある場合は、プロンプト指示ではなくフックにします。197 **フックにガードレールを入れます。** CLAUDE.md またはスキルの「`.env` を編集しないでください」のような指示は要求であり、保証ではありません。編集をブロックする `PreToolUse` フックは強制です。ルールが毎回保持される必要がある場合は、プロンプト指示ではなくフックにします。

179 198

180 **フック出力はコンテキストに着地します。** リンターを実行する `PostToolUse` フックは結果をテキストとして返し、Claude が読み取ります。`/fix-lint` スキルは Claude にそれらを解決する方法を指示します。199 **フック出力はコンテキストに着地します。** リンターを実行する `PostToolUse` フックは結果をテキストとして返し、Claude が読み取ります。`/fix-lint` スキルは Claude にそれらを解決する方法を指示します。

181 </Tab>200 </Tab>

185 機能がどのようにレイヤーするかを理解する204 機能がどのようにレイヤーするかを理解する

186</h3>205</h3>

187 206

188機能は複数のレベルで定義できます。ユーザー全体、プロジェクトごと、プラグイン経由、または管理ポリシーを通じて。また、CLAUDE.md ファイルをサブディレクトリにネストしたり、スキルをモノレポの特定のパッケージに配置したりすることもできます。同じ機能が複数のレベルに存在する場合、ここでそれらがどのようにレイヤーするかを示します。207機能は複数のレベルで定義できます。ユーザー全体、プロジェクトごと、プラグイン経由、または管理ポリシーを通じて。CLAUDE.md ファイルをサブディレクトリにネストしたり、スキルをモノレポの特定のパッケージに配置したりすることもできます。同じ機能が複数のレベルに存在する場合、以下がレイヤーする方法です。

189 208

190* **CLAUDE.md ファイル** は加算的です。すべてのレベルがコンテンツを同時に Claude のコンテキストに提供します。作業ディレクトリ以上のファイルは起動時にロードされます。サブディレクトリは作業時にロードされます。指示が競合する場合、Claude は判断を使用してそれらを調整し、より具体的な指示が通常優先されます。[CLAUDE.md ファイルがどのようにロードされるか](/docs/ja/memory#how-claude-md-files-load) を参照してください。209* **CLAUDE.md ファイル** は加算的です。すべてのレベルが同時に Claude のコンテキストにコンテンツを提供します。作業ディレクトリ以上のファイルは起動時に読み込まれます。サブディレクトリは作業中に読み込まれます。指示が競合する場合、Claude は判断を使用してそれらを調整します。[CLAUDE.md ファイルがどのように読み込まれるかを参照してください](/docs/ja/memory#how-claude-md-files-load)。

191* **スキルと subagents** は名前でオーバーライドします。同じ名前が複数のレベルに存在する場合、優先度に基づいて 1 つの定義が勝ちます（スキルの場合は管理 > ユーザー > プロジェクト。subagents の場合は管理 > CLI フラグ > プロジェクト > ユーザー > プラグイン）。プラグインスキルは競合を避けるために [名前空間化](/docs/ja/plugins#add-skills-to-your-plugin) されています。[スキル検出](/docs/ja/skills#resolve-skills-that-share-a-name) と [subagent スコープ](/docs/ja/sub-agents#choose-the-subagent-scope) を参照してください。210* **スキルと subagent** は名前でオーバーライドします。同じ名前が複数のレベルに存在する場合、優先度に基づいて 1 つの定義が勝ちます（スキルの場合は管理 > ユーザー > プロジェクト。subagent の場合は管理 > CLI フラグ > プロジェクト > ユーザー > プラグイン）。プラグインスキルは [名前空間化](/docs/ja/plugins#add-skills-to-your-plugin) されており、競合を回避します。[スキル検出](/docs/ja/skills#resolve-skills-that-share-a-name) と [subagent スコープ](/docs/ja/sub-agents#choose-the-subagent-scope) を参照してください。

192* **MCP サーバー** は名前でオーバーライドします。ローカル > プロジェクト > ユーザー。[MCP スコープ](/docs/ja/mcp#scope-hierarchy-and-precedence) を参照してください。211* **MCP サーバー** は名前でオーバーライドします。ローカル > プロジェクト > ユーザー。[MCP スコープ](/docs/ja/mcp#scope-hierarchy-and-precedence) を参照してください。

193* **Hooks** はマージされます。すべての登録されたフックは、ソースに関係なく、マッチングイベントに対して発火します。[Hooks](/docs/ja/hooks) を参照してください。212* **フック** はマージされます。登録されたすべてのフックは、ソースに関係なく、一致するイベントに対して発火します。[フック](/docs/ja/hooks) を参照してください。

194 213

195<h3 id="combine-features">214<h3 id="combine-features">

196 機能を組み合わせる215 機能を組み合わせる

197</h3>216</h3>

198 217

199各拡張機能は異なる問題を解決します。CLAUDE.md は常時オンのコンテキストを処理し、スキルはオンデマンド知識とワークフローを処理し、MCP は外部接続を処理し、subagents は分離を処理し、フックは自動化を処理します。実際のセットアップはワークフローに基づいてそれらを組み合わせます。218各拡張は異なる問題を解決します。CLAUDE.md は常時オンのコンテキストを処理し、スキルはオンデマンドの知識とワークフローを処理し、MCP は外部接続を処理し、subagent は分離を処理し、フックは自動化を処理します。実際のセットアップはワークフローに基づいてそれらを組み合わせます。

200 219

201たとえば、CLAUDE.md をプロジェクト規約に使用し、スキルをデプロイメントワークフローに使用し、MCP をデータベースに接続し、フックをすべての編集後にリントを実行するために使用する場合があります。各機能は最適な機能を処理します。220例えば、プロジェクト規約に CLAUDE.md を使用し、デプロイメントワークフローにスキルを使用し、データベースに接続するために MCP を使用し、すべてのファイル編集後にリントを実行するためにフックを使用する場合があります。各機能は最適な機能を処理します。

202 221

203| パターン | 機能 | 例 |222| パターン | 動作方法 | 例 |

204| ---------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------- |223| ---------------------- | ----------------------------------------------------- | -------------------------------------------------------------------- |

209 228

210<h2 id="understand-context-costs">229<h2 id="understand-context-costs">

220各機能には異なるロード戦略とコンテキストコストがあります。239各機能には異なるロード戦略とコンテキストコストがあります。

221 240

222| 機能 | ロード時期 | ロード内容 | コンテキストコスト |241| 機能 | ロード時期 | ロード内容 | コンテキストコスト |

223| --------------------- | ---------------- | ---------------------------------------------------------------------------------- | ----------------------- |242| --------------------- | -------------------------- | ---------------------------------------------------------------------------------- | ----------------------- |

fullscreen.md +2 −2

Details

234 234

235`/clear` を実行して新しい会話を開始します。235`/clear` を実行して新しい会話を開始します。

236 236

237スクリーンをクリアして会話を保持するには、`Ctrl+L` を押します。以前のメッセージが画面外にスクロールアップされ、`PgUp` またはマウスホイールでスクロールバックして再度読むことができます。v2.1.260 より前では、`Ctrl+L` はスクリーンを再描画しましたが、クリアしませんでした。v2.1.238 より前では、2 秒以内に 2 回押すと `/clear` が実行されました。237表示がおかしく見えたり、部分的に空白になっている場合は、`Ctrl+L` を押してスクリーンを再描画します。再描画により、会話と入力内容がそのまま保持されます。

238 238

239ターミナルが `Cmd+K` を Claude Code に渡す場合、`Cmd+K` は `Ctrl+L` と同じ動作をします。iTerm2 と Terminal.app は `Cmd+K` を自身で処理し、Claude Code は会話をクリアする代わりに再描画するため、これらのターミナルでは `Ctrl+L` を押します。239ターミナルが `Cmd+K` を Claude Code に渡す場合、`Cmd+K` は `Ctrl+L` と同じ動作をします。iTerm2 と Terminal.app は `Cmd+K` を自身で処理してスクリーン自体をクリアし、Claude Code はクリアされたスクリーンを検出して会話を再描画します。v2.1.280 より前では、v2.1.260 以降、`Ctrl+L` または Claude Code に到達する `Cmd+K` を押すと、フルスクリーン描画でスクリーンがクリアされました。v2.1.238 より前では、2 秒以内に `Ctrl+L` を 2 回押すと `/clear` が実行されました。

240 240

241<h2 id="use-with-tmux">241<h2 id="use-with-tmux">

242 tmux での使用242 tmux での使用

github-actions.md +1 −1

Details

300 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}300 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

301 prompt: "Generate a summary of yesterday's commits and open issues"301 prompt: "Generate a summary of yesterday's commits and open issues"

302 claude_args: |302 claude_args: |

303 --model claude-opus-4-8303 --model claude-opus-5-5

304 --allowedTools "mcp__github__list_commits,mcp__github__list_issues"304 --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

305```305```

306 306

glossary.md +12 −0

Details

208 208

209詳細情報: [Use extended thinking](/docs/ja/model-config#extended-thinking)209詳細情報: [Use extended thinking](/docs/ja/model-config#extended-thinking)

210 210

211<h2 id="f">

212 F

213</h2>

214

215<h3 id="frontmatter">

216 Frontmatter

217</h3>

218

219Markdown ファイルの最上部にある YAML 設定ブロックで、開始の `---` 行と終了の `---` 行の間に配置されます。Skills、subagents、output styles、および rules は、それぞれ frontmatter から設定を読み込みます。例えば、skill の `description` や subagent の `tools` などであり、終了の `---` の後のすべてを指示として扱います。開始の `---` はファイルの最初の行である必要があります。各ファイルタイプは独自のフィールドセットを受け入れます。

220

221詳細情報：[Skill frontmatter](/docs/ja/skills#frontmatter-reference)、[Subagent frontmatter](/docs/ja/sub-agents#supported-frontmatter-fields)、[Output style frontmatter](/docs/ja/output-styles#frontmatter)、[Rule frontmatter](/docs/ja/memory#rules-frontmatter-reference)

222

211<h2 id="h">223<h2 id="h">

212 H224 H

213</h2>225</h2>

google-vertex-ai.md +3 −3

Details

238 238

239これらの環境変数を特定の Google Cloud の Agent Platform モデル ID に設定します。239これらの環境変数を特定の Google Cloud の Agent Platform モデル ID に設定します。

240 240

241`ANTHROPIC_DEFAULT_OPUS_MODEL` がない場合、Google Cloud の Agent Platform 上の `opus` エイリアスは Opus 5 に解決され、`ANTHROPIC_DEFAULT_SONNET_MODEL` がない場合、`sonnet` エイリアスは Sonnet 4.5 に解決されます。この例では、各エイリアスを特定のバージョンにピン留めします。241`ANTHROPIC_DEFAULT_OPUS_MODEL` がない場合、Google Cloud の Agent Platform 上の `opus` エイリアスは Opus 5.5 に解決され、`ANTHROPIC_DEFAULT_SONNET_MODEL` がない場合、`sonnet` エイリアスは Sonnet 4.5 に解決されます。この例では、各エイリアスを特定のバージョンにピン留めします。

242 242

243```bash theme={null}243```bash theme={null}

244export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'244export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'

252 252

253| モデルタイプ | デフォルト値 |253| モデルタイプ | デフォルト値 |

254| :------- | :--------------------------- |254| :------- | :--------------------------- |

257 257

258セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル（通常は Haiku クラスモデル）を使用します。Google Cloud の Agent Platform では、Haiku がすべてのプロジェクトまたはリージョンで有効になっていない可能性があるため、Claude Code はバックグラウンドタスクにデフォルトの Sonnet モデルを使用します。2 つの選択がどのモデルがバックグラウンドタスクを実行するかを変更します。258セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル（通常は Haiku クラスモデル）を使用します。Google Cloud の Agent Platform では、Haiku がすべてのプロジェクトまたはリージョンで有効になっていない可能性があるため、Claude Code はバックグラウンドタスクにデフォルトの Sonnet モデルを使用します。2 つの選択がどのモデルがバックグラウンドタスクを実行するかを変更します。

264 Opus モデルは Sonnet モデルより高いトークンあたりの価格を持つため、プライマリモデルをピン留めしないデプロイメントは v2.1.207 以降に更新されると Opus レートで課金されます。Sonnet 4.5 をプライマリモデルとして保つには、`ANTHROPIC_MODEL` をその完全なモデル ID に設定します。`ANTHROPIC_DEFAULT_SONNET_MODEL` でデフォルトを制御し、`ANTHROPIC_DEFAULT_OPUS_MODEL` を設定しないデプロイメントは、制御された Sonnet モデルをデフォルトとして保ちます。264 Opus モデルは Sonnet モデルより高いトークンあたりの価格を持つため、プライマリモデルをピン留めしないデプロイメントは v2.1.207 以降に更新されると Opus レートで課金されます。Sonnet 4.5 をプライマリモデルとして保つには、`ANTHROPIC_MODEL` をその完全なモデル ID に設定します。`ANTHROPIC_DEFAULT_SONNET_MODEL` でデフォルトを制御し、`ANTHROPIC_DEFAULT_OPUS_MODEL` を設定しないデプロイメントは、制御された Sonnet モデルをデフォルトとして保ちます。

265</Warning>265</Warning>

266 266

267v2.1.207 ～ v2.1.218 では、Google Cloud の Agent Platform 上のプライマリモデルは Opus 4.8 にデフォルト設定され、`opus` エイリアスは Opus 4.8 に解決されました。v2.1.207 より前は、プライマリモデルは Sonnet 4.5 にデフォルト設定され、`opus` エイリアスは Opus 4.6 に解決され、バックグラウンドタスクは常にプライマリモデルを使用していました。267v2.1.280 より前は、Google Cloud の Agent Platform 上のプライマリモデルは Opus 5 にデフォルト設定され、`opus` エイリアスは v2.1.219 から Opus 5 に解決されました。v2.1.207 ～ v2.1.218 では、Google Cloud の Agent Platform 上のプライマリモデルは Opus 4.8 にデフォルト設定され、`opus` エイリアスは Opus 4.8 に解決されました。v2.1.207 より前は、プライマリモデルは Sonnet 4.5 にデフォルト設定され、`opus` エイリアスは Opus 4.6 に解決され、バックグラウンドタスクは常にプライマリモデルを使用していました。

268 268

269モデルをさらにカスタマイズするには、以下を実行します。269モデルをさらにカスタマイズするには、以下を実行します。

270 270

headless.md +3 −2

Details

109cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt109cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

110```110```

111 111

112`--output-format json` を使用すると、応答ペイロードに `total_cost_usd` とモデルごとのコスト内訳が含まれるため、スクリプト呼び出し元は [usage dashboard](/docs/ja/costs) を参照せずに呼び出しごとの支出を追跡できます。どちらの数値も [client-side estimates](/docs/ja/agent-sdk/cost-tracking) であり、実際の請求額と異なる場合があります。112`--output-format json` を使用すると、応答ペイロードに `total_cost_usd` とモデルごとのコスト内訳が含まれるため、スクリプト呼び出し元は [usage dashboard](/docs/ja/costs) を参照せずに支出を追跡できます。`--continue` または `--resume` で以前の会話を続ける場合、実行は会話全体の合計を報告し、[以前の実行の支出を含めて](/docs/ja/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls)。両方の数値は [client-side estimates](/docs/ja/agent-sdk/cost-tracking) であり、実際の請求額と異なる場合があります。

113 113

114<Note>114<Note>

115 パイプされた stdin は 10MB に制限されています。制限を超えた場合、Claude Code は明確なエラーメッセージを表示して終了し、ゼロ以外のステータスを返します。より大きな入力を処理するには、コンテンツをファイルに書き込み、パイプする代わりにプロンプトでファイルパスを参照してください。115 パイプされた stdin は 10MB に制限されています。制限を超えた場合、Claude Code は明確なエラーメッセージを表示して終了し、ゼロ以外のステータスを返します。より大きな入力を処理するには、コンテンツをファイルに書き込み、パイプする代わりにプロンプトでファイルパスを参照してください。

212* **デフォルト**：サブエージェントの `tool_use` および `tool_result` ブロック。212* **デフォルト**：サブエージェントの `tool_use` および `tool_result` ブロック。

213* **[`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) または [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/ja/env-vars) を使用**：サブエージェントのテキストおよび thinking ブロックも含まれるため、各サブエージェントのトランスクリプトを再構築できます。これには Claude Code v2.1.211 以降が必要です。213* **[`--forward-subagent-text`](/docs/ja/cli-reference#cli-flags) または [`CLAUDE_CODE_FORWARD_SUBAGENT_TEXT`](/docs/ja/env-vars) を使用**：サブエージェントのテキストおよび thinking ブロックも含まれるため、各サブエージェントのトランスクリプトを再構築できます。これには Claude Code v2.1.211 以降が必要です。

214 214

215いずれかのオプションを有効にすると、Claude Code は [subagents at every nesting depth](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) からのメッセージを転送します。サブエージェントが独自のサブエージェントを生成する場合、ネストされたサブエージェントのメッセージは、`parent_tool_use_id` でそれを生成した Agent ツール呼び出しの ID を含むため、これらの ID をフォローして完全なネストツリーを再構築できます。v2.1.219 より前では、ネストされたサブエージェントからのメッセージはストリームに表示されていませんでした。215いずれかのオプションを有効にすると、Claude Code は [subagents at every nesting depth](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) からのメッセージを転送します。Agent ツールまたは [forked skill](/docs/ja/skills#run-skills-in-a-subagent) として開始された場合、サブエージェントが生成されたかどうかに関わらず。

216フォークされたスキルが生成するサブエージェントのメッセージ、およびサブエージェント内またはフォークされたスキル内で開始されたフォークされたスキルには、Claude Code v2.1.275 以降が必要です。`parent_tool_use_id` では、ネストされたサブエージェントのメッセージは、それを開始した Agent または Skill ツール呼び出しの ID を含むため、これらの ID をフォローして完全なネストツリーを再構築できます。v2.1.219 より前では、ネストされたサブエージェントからのメッセージはストリームに表示されていませんでした。

216 217

217[subagent で実行される](/docs/ja/skills#run-skills-in-a-subagent) Skills は、ストリームに同じ方法で表示されます。フォークされたスキルの最初のメッセージは、実行を駆動するスキルコンテンツを含む `user` メッセージです。いずれかのオプションを有効にすると、ストリームはフォークされたスキルのテキストおよび thinking ブロックも含みます。v2.1.265 より前では、フォークされたスキルの `tool_use` および `tool_result` ブロックのみがストリームに表示されていました。218[subagent で実行される](/docs/ja/skills#run-skills-in-a-subagent) Skills は、ストリームに同じ方法で表示されます。フォークされたスキルの最初のメッセージは、実行を駆動するスキルコンテンツを含む `user` メッセージです。いずれかのオプションを有効にすると、ストリームはフォークされたスキルのテキストおよび thinking ブロックも含みます。v2.1.265 より前では、フォークされたスキルの `tool_use` および `tool_result` ブロックのみがストリームに表示されていました。

218 219

how-claude-code-works.md +17 −17

Details

24 24

25あなたもこのループの一部です。任意の時点で中断して Claude を別の方向に導いたり、追加のコンテキストを提供したり、別のアプローチを試すよう求めたりできます。Claude は自律的に動作しますが、あなたの入力に対して応答性を保ちます。25あなたもこのループの一部です。任意の時点で中断して Claude を別の方向に導いたり、追加のコンテキストを提供したり、別のアプローチを試すよう求めたりできます。Claude は自律的に動作しますが、あなたの入力に対して応答性を保ちます。

26 26

27agentic ループは 2 つのコンポーネントによって駆動されます。推論する [モデル](#models) と、アクションを実行する [ツール](#tools) です。Claude Code は Claude の周りの **agentic ハーネス** として機能します。言語モデルを有能なコーディングエージェントに変えるツール、コンテキスト管理、実行環境を提供します。27agentic ループは 2 つのコンポーネントによって駆動されます。推論する [モデル](#models) と、アクションを実行する [ツール](#tools) です。Claude Code はモデルの周りのレイヤーで、ツールを提供し、モデルが見るコンテキストを管理します。この周囲のレイヤーが agentic ハーネスという用語が指すものです。

28 28

29<h3 id="models">29<h3 id="models">

30 モデル30 モデル

201 Claude Code を効果的に使用する201 Claude Code を効果的に使用する

202</h2>202</h2>

203 203

204これらのヒントは Claude Code からより良い結果を得るのに役立ちます。詳細なプロンプト、検証、計画については、[ベストプラクティス](/docs/ja/best-practices)を参照してください。204これらのヒントは Claude Code からより良い結果を得るのに役立ちます。特定のプロンプト、検証、計画の詳細については、[ベストプラクティス](/docs/ja/best-practices)を参照してください。

205 205

206<h3 id="ask-claude-code-for-help">206<h3 id="ask-claude-code-for-help">

207 Claude Code に助けを求める207 Claude Code に助言を求める

208</h3>208</h3>

209 209

210Claude Code はそれの使用方法を教えることができます。「フックをセットアップするにはどうすればいいですか？」や「CLAUDE.md を構造化する最良の方法は何ですか？」などの質問をすると、Claude が説明します。210Claude Code はそれの使い方を教えることができます。「hooks をどのようにセットアップするのか」や「CLAUDE.md を構造化する最良の方法は何か」といった質問をしてください。Claude が説明します。

211 211

212組み込みコマンドもセットアップをガイドします：212組み込みコマンドもセットアップをガイドします：

213 213

214* `/init` はプロジェクト用のスターター CLAUDE.md を生成します214* `/init` はプロジェクト用のスターター CLAUDE.md を生成します

215* `/doctor` はインストールと設定の問題を診断し、修正することができるセットアップチェックアップを実行します215* `/doctor` はセットアップチェックアップを実行し、インストールと設定の問題を診断し、修正することができます

216 216

217<h3 id="it’s-a-conversation">217<h3 id="it’s-a-conversation">

218 会話です218 これは会話です

219</h3>219</h3>

220 220

221Claude Code は会話的です。完璧なプロンプトは必要ありません。何を望むかで始めて、その後改善します：221Claude Code は会話型です。完璧なプロンプトは必要ありません。やりたいことから始めて、その後改善します：

222 222

223```text theme={null}223```text theme={null}

224ログインバグを修正して224Fix the login bug

225```225```

226 226

227\[Claude が調査し、何かを試す]227\[Claude が調査し、何かを試す]

228 228

229```text theme={null}229```text theme={null}

230それは完全には正しくありません。問題はセッション処理にあります。230That's not quite right. The issue is in the session handling.

231```231```

232 232

233\[Claude がアプローチを調整]233\[Claude がアプローチを調整する]

234 234

235最初の試みが正しくない場合、最初からやり直す必要はありません。反復します。235最初の試みが正しくない場合、最初からやり直す必要はありません。反復します。

236 236

237<h4 id="interrupt-and-steer">237<h4 id="interrupt-and-steer">

238 中断して操舵する238 割り込みと操舵

239</h4>239</h4>

240 240

241任意の時点で Claude をリダイレクトできます。ターンが終了するのを待つか、最初からやり直す必要はありません：241任意の時点で Claude をリダイレクトでき、最初からやり直す必要はありません。以下のいずれかを実行してください：

242 242

243* **`Esc` を押す** と Claude が直ちに停止します。実行中のツール呼び出しがキャンセルされ、Claude は次の指示を待ちます。メッセージがキューに入っている場合、Claude Code は[次にそれらを送信します](/docs/ja/interactive-mode#queue-messages-while-claude-works)。243* **`Esc` キーを押す**と Claude が直ちに停止します。実行中のツール呼び出しがキャンセルされ、Claude は次の指示を待ちます。メッセージがキューに入っている場合、Claude Code は[次にそれらを送信します](/docs/ja/interactive-mode#queue-messages-while-claude-works)。

244* **修正を入力して `Enter` を押す** と、実行中のツールを停止せずに送信できます。Claude は現在のアクションが完了するとすぐにそれを読み、次のステップを決定する前に調整します。244* **修正を入力して `Enter` キーを押す**と Claude を停止せずに実行します。メッセージは入力ボックスの上にキューに入っているものとして表示されます。Claude がツール呼び出しを実行している場合、それらの呼び出しが完了するとすぐに、同じターン内でメッセージを読み取り、次のステップの前に調整します。[Claude が作業している間にメッセージをキューに入れる](/docs/ja/interactive-mode#queue-messages-while-claude-works)は、他のキューに入っているエントリがいつ送信されるかについて説明しています。

245 245

246<h3 id="delegate-don’t-dictate">246<h3 id="delegate-don’t-dictate">

247 指示するのではなく委譲する247 指示するのではなく委譲する

248</h3>248</h3>

249 249

250有能な同僚に委譲することを考えてください。コンテキストと方向を与え、Claude が詳細を理解することを信頼します：250有能な同僚に委譲することを考えてください。コンテキストと方向性を提供し、その後 Claude が詳細を理解することを信頼してください：

251 251

252```text theme={null}252```text theme={null}

253チェックアウトフローは期限切れのカードを持つユーザーに対して壊れています。253The checkout flow is broken for users with expired cards.

254関連するコードは src/payments/ にあります。調査して修正できますか？254The relevant code is in src/payments/. Can you investigate and fix it?

255```255```

256 256

257どのファイルを読むか、どのコマンドを実行するかを指定する必要はありません。Claude がそれを理解します。257どのファイルを読むか、どのコマンドを実行するかを指定する必要はありません。Claude がそれを理解します。

interactive-mode.md +12 −2

Details

26| `Ctrl+X Ctrl+K` | このセッション内のすべての実行中の[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を停止し、[アーティファクト自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)をセッションの残りの部分で無効にします。3 秒以内に 2 回押して確認 | サブエージェント制御 |26| `Ctrl+X Ctrl+K` | このセッション内のすべての実行中の[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を停止し、[アーティファクト自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)をセッションの残りの部分で無効にします。3 秒以内に 2 回押して確認 | サブエージェント制御 |

28| `Ctrl+G` または `Ctrl+X Ctrl+E` | デフォルトテキストエディタで開く | プロンプトまたはカスタム応答をデフォルトテキストエディタで編集します。`Ctrl+X Ctrl+E` は readline ネイティブバインディングです。`/config` で**外部エディタで最後の応答を表示**をオンにすると、Claude の前の返信を `#` コメント付きコンテキストとしてプロンプトの上に追加します。Claude Code は保存時にコメントブロックを削除します |28| `Ctrl+G` または `Ctrl+X Ctrl+E` | デフォルトテキストエディタで開く | プロンプトまたはカスタム応答をデフォルトテキストエディタで編集します。`Ctrl+X Ctrl+E` は readline ネイティブバインディングです。`/config` で**外部エディタで最後の応答を表示**をオンにすると、Claude の前の返信を `#` コメント付きコンテキストとしてプロンプトの上に追加します。Claude Code は保存時にコメントブロックを削除します |

29| `Ctrl+L` | 画面を再描画またはクリア | 完全なターミナル再描画を強制し、入力と会話履歴を保持します。ディスプレイが乱れたり部分的に空白になった場合に使用して復旧します。[フルスクリーンレンダリング](/docs/ja/fullscreen#clear-the-conversation)では、画面もクリアされ、スクロールアップして以前のメッセージを表示できます |29| `Ctrl+L` | 画面を再描画 | 完全なターミナル再描画を強制し、入力と会話履歴を保持します。ディスプレイが乱れたり部分的に空白になった場合に使用して復旧します。[会話をクリア](/docs/ja/fullscreen#clear-the-conversation)を参照してください（フルスクリーンレンダリング） |

30| `Ctrl+O` | トランスクリプトビューアを切り替え | 詳細なツール使用法と実行を表示し、各アシスタントメッセージにタイムスタンプと使用されたモデルを表示します。また、デフォルトで折りたたまれる行（MCP 呼び出しなど、`Called slack 3 times` という 1 行として表示される行）や[他のセッションからのメッセージ](/docs/ja/cross-session-messaging#what-a-message-looks-like)（`Message from @<sender>` プレビューとして 1 行で表示される）を展開します |30| `Ctrl+O` | トランスクリプトビューアを切り替え | 詳細なツール使用法と実行を表示し、各アシスタントメッセージにタイムスタンプと使用されたモデルを表示します。また、デフォルトで折りたたまれる行（MCP 呼び出しなど、`Called slack 3 times` という 1 行として表示される行）や[他のセッションからのメッセージ](/docs/ja/cross-session-messaging#what-a-message-looks-like)（`Message from @<sender>` プレビューとして 1 行で表示される）を展開します |

32| `Ctrl+V` または `Cmd+V`（iTerm2）または `Alt+V`（Windows および WSL） | クリップボードから画像を貼り付け | カーソルに `[Image #N]` チップを挿入して、プロンプト内で位置的に参照できます。WSL では、`Ctrl+V` と `Alt+V` の両方がバインドされています。ターミナルが `Ctrl+V` をインターセプトする場合は `Alt+V` を使用してください |32| `Ctrl+V` または `Cmd+V`（iTerm2）または `Alt+V`（Windows および WSL） | クリップボードから画像を貼り付け | カーソルに `[Image #N]` チップを挿入して、プロンプト内で位置的に参照できます。WSL では、`Ctrl+V` と `Alt+V` の両方がバインドされています。ターミナルが `Ctrl+V` をインターセプトする場合は `Alt+V` を使用してください |

42| `Ctrl+Enter` または `Ctrl+X Ctrl+S` | キューに入れたメッセージを今すぐ送信 | 現在のターンを割り込んで、[キューに入れたメッセージ](#queue-messages-while-claude-works)とドラフトがターン終了時ではなく直ちに送出されます。[シェルモード](#shell-mode-with-prefix)では、キーはコマンドをキューに入れて割り込みません。拡張キーを報告しないターミナルでは、`Ctrl+Enter` は通常の `Enter` として到着します。`Ctrl+X Ctrl+S` はすべてのターミナルで機能します。Claude Code v2.1.275 以降が必要です |42| `Ctrl+Enter` または `Ctrl+X Ctrl+S` | キューに入れたメッセージを今すぐ送信 | 現在のターンを割り込んで、[キューに入れたメッセージ](#queue-messages-while-claude-works)とドラフトがターン終了時ではなく直ちに送出されます。[シェルモード](#shell-mode-with-prefix)では、キーはコマンドをキューに入れて割り込みません。拡張キーを報告しないターミナルでは、`Ctrl+Enter` は通常の `Enter` として到着します。`Ctrl+X Ctrl+S` はすべてのターミナルで機能します。Claude Code v2.1.275 以降が必要です |

43| `Shift+Tab`、または Node または Bun ランタイムが VT 入力モードを有効にしない場合は Windows で `Alt+M` | 権限モードを循環 | `default`（モード指標で Manual とラベル付け）、`acceptEdits`、`plan`、および利用可能な場合は `bypassPermissions` と `auto` を循環します。`auto` から、最初のプレスは `default` に切り替わります。[権限モード](/docs/ja/permission-modes)を参照してください。ファイル権限プロンプトでは、同じキーが開いている[コメントフィールド](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt)を閉じます。フィールドが開いていない場合、プロンプトがそのオプションを提供するときに、セッションの残りの部分でアクションを許可するオプションを選択します |43| `Shift+Tab`、または Node または Bun ランタイムが VT 入力モードを有効にしない場合は Windows で `Alt+M` | 権限モードを循環 | `default`（モード指標で Manual とラベル付け）、`acceptEdits`、`plan`、および利用可能な場合は `bypassPermissions` と `auto` を循環します。`auto` から、最初のプレスは `default` に切り替わります。[権限モード](/docs/ja/permission-modes)を参照してください。ファイル権限プロンプトでは、同じキーが開いている[コメントフィールド](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt)を閉じます。フィールドが開いていない場合、プロンプトがそのオプションを提供するときに、セッションの残りの部分でアクションを許可するオプションを選択します |

47 47

48<h3 id="text-editing">48<h3 id="text-editing">

593 593

594これらのうちどれが起こったかを確認するには、スペルチェックをオンにして `claude --debug` を開始し、単語を入力してください。次に、`~/.claude/debug/<session-id>.txt` のデバッグログで `[spellcheck]` 行を探してください。1 行は Claude Code が開始したプログラムに名前を付けるか、探したが見つからなかったプログラムをリストします。後の行は停止した理由を説明します。そこの辞書欠落エラーは、チェッカーが `language` 値の辞書を持っていないか、`language` が設定されていない場合はデフォルトの辞書を持っていないことを意味します。1 つをインストールするか、`language` を持っている辞書に設定してください。594これらのうちどれが起こったかを確認するには、スペルチェックをオンにして `claude --debug` を開始し、単語を入力してください。次に、`~/.claude/debug/<session-id>.txt` のデバッグログで `[spellcheck]` 行を探してください。1 行は Claude Code が開始したプログラムに名前を付けるか、探したが見つからなかったプログラムをリストします。後の行は停止した理由を説明します。そこの辞書欠落エラーは、チェッカーが `language` 値の辞書を持っていないか、`language` が設定されていない場合はデフォルトの辞書を持っていないことを意味します。1 つをインストールするか、`language` を持っている辞書に設定してください。

595 595

596<h2 id="invisible-characters-in-prompts">

597 プロンプト内の見えない文字

598</h2>

599

600貼り付けたテキストには、タグ文字、双方向制御、ゼロ幅スペースなど、ターミナルが何も描画しない Unicode 文字が含まれる可能性があるため、プロンプトには見えないテキストが含まれることがあります。コピーしたテキストがターミナルに描画されない命令を含まないようにするため、Claude Code は Enter キーを押すときにそれらの文字を削除してから、何かを送信します。プロンプトと、プロンプトに含まれる任意の折りたたまれた[貼り付けテキスト参照](/docs/ja/terminal-config#paste-large-content)の内容の両方をクリーンアップします。Claude Code はペルシア語とインド系スクリプトが書く結合文字と、絵文字シーケンス内のセレクタを保持します。

601

602Claude Code が何かを削除した場合、その Enter は何も送信しません。クリーンアップされたプロンプトは、`Removed 3 invisible characters · review and press Enter to send` などの通知とともに入力ボックスに戻り、もう一度 Enter キーを押すと、表示されたテキストが送信されます。

603

604`claude "fix the login bug"` のようにコマンドラインでプロンプトを渡すか、対話型セッションにパイプする場合、Claude Code は 2 番目の Enter を待ちません。文字を削除し、通知を表示し、クリーンアップされたプロンプトを送信します。クリーンアップされたプロンプトが `/` で始まる場合、Claude Code はそれを入力ボックスに入れて、確認して送信するようにします。

605

596<h2 id="review-changes-with-/diff">606<h2 id="review-changes-with-/diff">

597 /diff で変更内容を確認する607 /diff で変更内容を確認する

598</h2>608</h2>

keybindings.md +114 −88

Details

77 利用可能なアクション77 利用可能なアクション

78</h2>78</h2>

79 79

80アクションは `namespace:action` 形式に従います。例えば、`chat:submit` はメッセージを送信し、`app:toggleTodos` はタスクリストを表示します。各コンテキストには特定のアクションが利用可能です。80アクションは `namespace:action` 形式に従います。例えば、メッセージを送信する `chat:submit` や、タスクリストを表示する `app:toggleTodos` などです。各コンテキストには特定のアクションが利用可能です。

81 81

82<h3 id="app-actions">82<h3 id="app-actions">

~~83 アプリアクション~~83 アプリケーションアクション

84</h3>84</h3>

85 85

86`Global` コンテキストで利用可能なアクション：86`Global` コンテキストで利用可能なアクション：

87 87

88| アクション | デフォルト | 説明 |88| アクション | デフォルト | 説明 |

~~89| :--------------------- | :------- | :-------------------------------------------------------------------------- |~~89| :--------------------- | :------- | :--------------------------------------------------------------------------- |

95 95

96<h3 id="history-actions">96<h3 id="history-actions">

112`Chat` コンテキストで利用可能なアクション：112`Chat` コンテキストで利用可能なアクション：

113 113

114| アクション | デフォルト | 説明 |114| アクション | デフォルト | 説明 |

115| :-------------------- | :-------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |115| :-------------------- | :----------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

119| `chat:killAgents` | Ctrl+X Ctrl+K | このセッション内のすべての実行中の[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を停止し、このセッションの残りの[アーティファクト自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own)をオフにします |119| `chat:killAgents` | Ctrl+X Ctrl+K | このセッション内で実行中のすべての [バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) を停止し、残りのセッションの [アーティファクト自動返信](/docs/ja/artifacts#let-claude-reply-to-comments-on-its-own) をオフにします |

125| `chat:queueSubmit` | Ctrl+X Enter | メッセージを送信し、順番を待つようにマークします：Claude が作業中の場合、Claude Code は[それをキューに入れ](/docs/ja/interactive-mode#queue-messages-while-claude-works)、ターンを中断しません。`chat:submit` とは異なり、オートコンプリート提案が開いている場合でもドラフトを送信します。v2.1.247 以降が必要 |125| `chat:queueSubmit` | Ctrl+X Enter | メッセージを送信し、順番を待つようにマーク：Claude が作業中の場合、Claude Code は [それをキューに入れ](/docs/ja/interactive-mode#queue-messages-while-claude-works)、ターンを中断しません。`chat:submit` とは異なり、オートコンプリート候補がハイライトされている場合でも下書きを送信します。v2.1.247 以降が必要 |

126| `chat:sendNow` | Ctrl+Enter、Ctrl+X Ctrl+S | 実行中のターンを中断して、[キューに入れられたメッセージ](/docs/ja/interactive-mode#queue-messages-while-claude-works)とドラフトをすぐに送信します。何も実行されていない場合は、ドラフトを送信し、[シェルモード](/docs/ja/interactive-mode#shell-mode-with-prefix)ではコマンドを中断せずにキューに入れます。拡張キーを報告しないターミナルは `Ctrl+Enter` をプレーン `Enter` として配信するため、`Ctrl+X Ctrl+S` はどのターミナルでも機能するバインディングです。v2.1.275 以降が必要 |126| `chat:sendNow` | Ctrl+Enter、Ctrl+X Ctrl+S | 実行中のターンを中断して、[キューに入れたメッセージ](/docs/ja/interactive-mode#queue-messages-while-claude-works) と下書きをすぐに送信します。何も実行されていない場合は下書きを送信し、[シェルモード](/docs/ja/interactive-mode#shell-mode-with-prefix) ではコマンドをキューに入れて中断しません。拡張キーを報告しないターミナルは `Ctrl+Enter` をプレーン `Enter` として配信するため、`Ctrl+X Ctrl+S` はどのターミナルでも機能するバインディングです。v2.1.275 以降が必要 |

132 132

133\*VT モードなし（Node \<24.2.0/\<22.17.0、Bun \<1.2.23）の Windows では、デフォルトは Meta+M です。133\*VT モードなし Windows（Node \<24.2.0/\<22.17.0、Bun \<1.2.23）では、デフォルトは Meta+M です。

134 134

135<h3 id="autocomplete-actions">135<h3 id="autocomplete-actions">

136 オートコンプリートアクション136 オートコンプリートアクション

140 140

141| アクション | デフォルト | 説明 |141| アクション | デフォルト | 説明 |

142| :---------------------- | :----- | :------- |142| :---------------------- | :----- | :------- |

143| `autocomplete:accept` | Tab | 提案を受け入れ |143| `autocomplete:accept` | Tab | 候補を受け入れ |

145| `autocomplete:previous` | Up | 前の提案 |145| `autocomplete:previous` | Up | 前の候補 |

147 147

148<h3 id="confirmation-actions">148<h3 id="confirmation-actions">

149 確認アクション149 確認アクション

152`Confirmation` コンテキストで利用可能なアクション：152`Confirmation` コンテキストで利用可能なアクション：

153 153

154| アクション | デフォルト | 説明 |154| アクション | デフォルト | 説明 |

155| :---------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |155| :---------------------- | :---------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

158| `confirm:previous` | Up | 前のオプション |158| `confirm:previous` | Up | 前のオプション |

160| `confirm:nextField` | Tab | 次のフィールド |160| `confirm:nextField` | Tab | 次のフィールド |

163| `confirm:cycleMode` | Shift+Tab\* | 権限モードをサイクルします。ファイル権限プロンプトでは、開いている[コメントフィールド](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt)を閉じます。フィールドが開いていない場合は、プロンプトがそのオプションを提供するときに、セッションの残りの期間アクションを許可するオプションを選択します |163| `confirm:cycleMode` | Shift+Tab\* | 権限モードをサイクルします。ファイル権限プロンプトでは、開いている [コメントフィールド](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt) を閉じます。フィールドが開いていない場合は、プロンプトがそのオプションを提供するときに、セッションの残りの間アクションを許可するオプションを選択します |

164 164

165\*VT モードなし（Node \<24.2.0/\<22.17.0、Bun \<1.2.23）の Windows では、デフォルトは Meta+M です。165\*VT モードなし Windows（Node \<24.2.0/\<22.17.0、Bun \<1.2.23）では、デフォルトは Meta+M です。

166 166

167v2.1.257 より前では、`confirm:toggleExplanation` アクション（デフォルトでは Ctrl+E にバインド）が Bash および PowerShell 権限プロンプトでモデルが生成したコマンドの説明を表示していました。167v2.1.257 より前では、`confirm:toggleExplanation` アクション（デフォルトでは Ctrl+E にバインド）が Bash と PowerShell 権限プロンプトでモデル生成の説明を表示していました。

168

169ダイアログは、はい/いいえの質問をしていない場合でも、`confirm:yes` と `confirm:no` を使用して受け入れとキャンセルを行います。このコンテキストで `y` や `n` などのベアレターをバインドすると、そのレターをキーとして表示しないダイアログにも作用します。`y` と `n` をキーとして表示するダイアログはそれらのレターを自分で読み取り、バインディングは不要です。

170

171この例は `y` を `confirm:yes` に、`n` を `confirm:no` にバインドします：

172

173```json theme={null}

174{

175 "bindings": [

176 {

177 "context": "Confirmation",

178 "bindings": {

179 "y": "confirm:yes",

180 "n": "confirm:no"

181 }

182 }

183 ]

184}

185```

186

187v2.1.280 より前では、`y` もデフォルトで `confirm:yes` にバインドされ、`n` は `confirm:no` にバインドされていました。v2.1.280 より前に `/keybindings` で `keybindings.json` を作成した場合、ファイルは両方のバインディングをリストし、それらの 2 行を削除するまで有効なままです。

168 188

169<h3 id="permission-actions">189<h3 id="permission-actions">

170 権限アクション190 権限アクション

173権限ダイアログの `Confirmation` コンテキストで利用可能なアクション：193権限ダイアログの `Confirmation` コンテキストで利用可能なアクション：

174 194

175| アクション | デフォルト | 説明 |195| アクション | デフォルト | 説明 |

176| :----------------------- | :------- | :------------------------------------------------------------------------------- |196| :----------------------- | :------- | :------------------------------------------------------------------------- |

178 198

179<h3 id="transcript-actions">199<h3 id="transcript-actions">

180 トランスクリプトアクション200 トランスクリプトアクション

189 209

190`transcript:toggleShowAll` はクラシックレンダラーにのみ適用されます。[フルスクリーンレンダリング](/docs/ja/fullscreen)では、トランスクリプトビューアは表示切り替えオプションを提供しません。210`transcript:toggleShowAll` はクラシックレンダラーでのみ適用されます。[フルスクリーンレンダリング](/docs/ja/fullscreen) では、トランスクリプトビューアは show-all トグルを提供しません。

191 211

192<h3 id="history-search-actions">212<h3 id="history-search-actions">

193 履歴検索アクション213 履歴検索アクション

205 225

206`historySearch:next`、`historySearch:accept`、`historySearch:cancel`、`historySearch:execute` のデフォルトはクラシックレンダラーのインライン履歴検索に適用され、常にすべてのプロジェクトからプロンプトを検索します。`historySearch:cycleScope` は[フルスクリーンレンダリング](/docs/ja/fullscreen)でのみ有効です。ここで Ctrl+R は検索ダイアログを開き、Ctrl+S はそのスコープをサイクルします。ダイアログの他のキーは固定されており、再バインドできません：Enter または Tab はハイライトされたマッチをプロンプト入力に配置し、Esc はキャンセルします。226`historySearch:next`、`historySearch:accept`、`historySearch:cancel`、`historySearch:execute` のデフォルトはクラシックレンダラーのインライン履歴検索に適用され、常にすべてのプロジェクトからプロンプトを検索します。`historySearch:cycleScope` は [フルスクリーンレンダリング](/docs/ja/fullscreen) でのみ有効です。ここで Ctrl+R は検索ダイアログを開き、Ctrl+S はそのスコープをサイクルします。ダイアログの他のキーは固定されており、リバインドできません：`Enter` または `Tab` はハイライトされたマッチをプロンプト入力に配置し、`Esc` はキャンセルします。

207 227

208<h3 id="task-actions">228<h3 id="task-actions">

209 タスクアクション229 タスクアクション

212`Task` コンテキストで利用可能なアクション：232`Task` コンテキストで利用可能なアクション：

213 233

214| アクション | デフォルト | 説明 |234| アクション | デフォルト | 説明 |

215| :---------------- | :------------------- | :-------------------------------------------------------- |235| :---------------- | :------------------- | :------------------------------------------------------------- |

217 237

218<h3 id="theme-actions">238<h3 id="theme-actions">

219 テーマアクション239 テーマアクション

222`ThemePicker` コンテキストで利用可能なアクション：242`ThemePicker` コンテキストで利用可能なアクション：

223 243

224| アクション | デフォルト | 説明 |244| アクション | デフォルト | 説明 |

225| :------------------------------- | :----- | :--------------- |245| :------------------------------- | :----- | :----------- |

227 247

228<h3 id="help-actions">248<h3 id="help-actions">

229 ヘルプアクション249 ヘルプアクション

266`Footer` コンテキストで利用可能なアクション：286`Footer` コンテキストで利用可能なアクション：

267 287

268| アクション | デフォルト | 説明 |288| アクション | デフォルト | 説明 |

269| :---------------------- | :--------------- | :------------------------------------------------------------------------------------------------------------- |289| :---------------------- | :--------------- | :--------------------------------------------------------------------------------------------------------------- |

272| `footer:up` | Up | フッター内で上に移動（最上部で選択解除） |292| `footer:up` | Up | フッター内を上にナビゲート（上部で選択解除） |

297

298フッター項目が選択されている場合（プロンプトの下のエージェントパネルの行など）、`Chat` コンテキストで `Enter` を `chat:queueSubmit` または `chat:newline` に再バインドしても、`Enter` はそれを開きます。

299

300`Chat` コンテキストの `Shift+Tab` の `chat:cycleMode` など、`Footer` コンテキストがバインドしないキーのバインディングは、項目が選択されている間も機能します。

277 301

278<h3 id="message-selector-actions">302<h3 id="message-selector-actions">

279 メッセージセレクタアクション303 メッセージセレクターアクション

280</h3>304</h3>

281 305

282`MessageSelector` コンテキストで利用可能なアクション：306`MessageSelector` コンテキストで利用可能なアクション：

283 307

284| アクション | デフォルト | 説明 |308| アクション | デフォルト | 説明 |

285| :----------------------- | :------------------------------------- | :------- |309| :----------------------- | :------------------------------------- | :-------- |

291 315

292<h3 id="diff-actions">316<h3 id="diff-actions">

303| `diff:previousFile` | Up、K | ファイルリストの前のファイル。詳細ビューで 1 行上にスクロール |327| `diff:previousFile` | Up、K | ファイルリスト内の前のファイル。詳細ビューで 1 行上にスクロール |

307 331

308Diff 詳細ビューは、ページャースタイルのキーを標準的な[スクロールアクション](#scroll-actions)にバインドします。これらのバインディングは `DiffDialog` コンテキストの一部であり、詳細ビューにのみ適用されます。[スクロールアクション](#scroll-actions)の下に記載されている `Scroll` コンテキストのデフォルトは変わりません。332Diff 詳細ビューは、ページャースタイルのキーを標準 [スクロールアクション](#scroll-actions) にバインドします。これらのバインディングは `DiffDialog` コンテキストの一部であり、詳細ビューでのみ適用されます。[スクロールアクション](#scroll-actions) の下にリストされている `Scroll` コンテキストのデフォルトは変更されません。

309 333

310| アクション | デフォルト | 説明 |334| アクション | デフォルト | 説明 |

311| :-------------------- | :------------ | :----------------- |335| :-------------------- | :------------ | :--------------- |

318 342

319<h3 id="diff-panel-actions">343<h3 id="diff-panel-actions">

320 Diff パネルアクション344 Diff パネルアクション

321</h3>345</h3>

322 346

323`/diff` がフルスクリーンレンダリングで開く[Diff パネル](/docs/ja/interactive-mode#diff-panel)のアクション。`app:cycleDiffBase` は `DiffPanel` コンテキストにあり、パネルが開いている間はアクティブです。他は `Global` です。パネルは Claude Code v2.1.260 以降が必要です。347`/diff` がフルスクリーンレンダリングで開く [Diff パネル](/docs/ja/interactive-mode#diff-panel) のアクション。`app:cycleDiffBase` は `DiffPanel` コンテキストにあり、パネルが開いている間はアクティブです。その他は `Global` です。パネルには Claude Code v2.1.260 以降が必要です。

324 348

325| アクション | デフォルト | 説明 |349| アクション | デフォルト | 説明 |

326| :-------------------------- | :------------------ | :------------------------------------- |350| :-------------------------- | :------------------ | :------------------------------------- |

333 357

334<h3 id="model-picker-actions">358<h3 id="model-picker-actions">

335 モデルピッカーアクション359 モデルピッカーアクション

347 努力スライダーアクション371 努力スライダーアクション

348</h3>372</h3>

349 373

350`EffortSlider` コンテキストで利用可能なアクション。引数なしで `/effort` を実行するときに開くスライダー。スライダーの Left、Right、Enter、Escape キーは再バインドできません。374`EffortSlider` コンテキストで利用可能なアクション。引数なしで `/effort` を実行するときに開くスライダーです。スライダーの Left、Right、Enter、Escape キーは再バインドできません。

351 375

352| アクション | デフォルト | 説明 |376| アクション | デフォルト | 説明 |

353| :----------------------------- | :---- | :----------------------------------------------------------------------------------- |377| :----------------------------- | :---- | :------------------------------------------------------------------------------------- |

354| `effortSlider:thisSessionOnly` | s | フォーカスされた[努力レベル](/docs/ja/model-config#adjust-effort-level)をこのセッションのみに適用します。v2.1.257 以降が必要 |378| `effortSlider:thisSessionOnly` | s | フォーカスされた [努力レベル](/docs/ja/model-config#adjust-effort-level) をこのセッションのみに適用します。v2.1.257 以降が必要 |

355 379

356<h3 id="select-actions">380<h3 id="select-actions">

357 選択アクション381 選択アクション

372 396

373Claude Code は `/skills` メニューで `select:pageUp`、`select:pageDown`、`select:first`、`select:last` バインディングを適用します。`/model` ピッカーなどほとんどの他のリストでは、Claude Code はバインディングに関係なく PageUp と PageDown でページングし、Home と End を無視します。397Claude Code は `/skills` メニューで `select:pageUp`、`select:pageDown`、`select:first`、`select:last` バインディングを適用します。`/model` ピッカーなどのほとんどの他のリストでは、`select:first` と `select:last` バインディングが適用されます。PageUp と PageDown は、バインディングに関係なく、これらのリストのオプションをページングします。

398

399v2.1.280 より前では、これらの他のリストは Home、End、および `select:first` と `select:last` バインディングを無視していました。

374 400

375<h3 id="plugin-actions">401<h3 id="plugin-actions">

376 プラグインアクション402 プラグインアクション

382| :---------------- | :---- | :---------------------------------------------- |408| :---------------- | :---- | :---------------------------------------------- |

384| `plugin:install` | I | 選択したプラグインをインストール |410| `plugin:install` | I | 選択したプラグインをインストール |

385| `plugin:favorite` | F | 選択したプラグインをお気に入りにして、インストール済みタブの上部付近にソートされるようにします |411| `plugin:favorite` | F | 選択したプラグインをお気に入りにして、インストール済みタブの上部付近でソートされるようにします |

386 412

387<h3 id="settings-actions">413<h3 id="settings-actions">

388 設定アクション414 設定アクション

389</h3>415</h3>

390 416

391`Settings` コンテキストで利用可能なアクション。`select:accept` と `confirm:no` アクションは[選択](#select-actions)と[確認](#confirmation-actions)コンテキストから再利用されており、設定固有の動作があります：変更は設定を変更するとすぐに各設定に適用されるため、Escape は変更を破棄するのではなく、変更を保存して閉じます。417`Settings` コンテキストで利用可能なアクション。`select:accept` と `confirm:no` アクションは [選択](#select-actions) と [確認](#confirmation-actions) コンテキストから再利用され、設定固有の動作があります：変更は各設定を変更するとすぐに適用されるため、Escape はパネルを閉じて変更を保存します。拒否するのではなく。

392 418

393| アクション | デフォルト | 説明 |419| アクション | デフォルト | 説明 |

394| :---------------- | :---------- | :----------------------- |420| :---------------- | :---------- | :----------------------- |

395| `settings:search` | / | 検索モードに入る |421| `settings:search` | / | 検索モードに入る |

396| `settings:retry` | R | 使用状況データの読み込みを再試行（エラー時） |422| `settings:retry` | R | エラー時に使用データの読み込みを再試行 |

399 425

401 エージェントアクション427 エージェントアクション

402</h3>428</h3>

403 429

404`Agents` コンテキストで利用可能なアクション。`claude agents` で開く[エージェントビュー](/docs/ja/agent-view)に適用されます。v2.1.257 以降が必要です。430`claude agents` で開く [エージェントビュー](/docs/ja/agent-view) で適用される `Agents` コンテキストで利用可能なアクション。v2.1.257 以降が必要です。

405 431

406| アクション | デフォルト | 説明 |432| アクション | デフォルト | 説明 |

407| :------------------ | :----- | :-------------------------------------------------------------- |433| :------------------ | :----- | :--------------------------------------------------------------- |

410 436

411エージェントビューが開いている間、Claude Code は `Agents` コンテキストがキーをバインドする場合、そのキーに対して `Agents` バインディングを使用し、同じキーの `Chat` または `Global` バインディングを無視します。例えば、エージェントビューで Ctrl+S を押すと、デフォルトの `chat:stash` をトリガーするのではなく、セッショングループ化を切り替えます。437エージェントビューが開いている間、Claude Code は `Agents` コンテキストがバインドするキーに対して `Agents` バインディングを使用し、同じキーの `Chat` または `Global` バインディングを無視します。例えば、エージェントビューで Ctrl+S を押すと、デフォルトの `chat:stash` をトリガーするのではなく、セッショングループ化を切り替えます。

412 438

413ディスパッチ入力の外部エディタショートカットは `Agents` アクションではありません。エージェントビューは `Chat` コンテキストの `chat:externalEditor` バインディング（デフォルトでは Ctrl+G）に従います。439ディスパッチ入力の外部エディタショートカットは `Agents` アクションではありません。エージェントビューは `Chat` コンテキストの `chat:externalEditor` バインディング（デフォルトでは Ctrl+G）に従います。

414 440

415エージェントビューではバインディングが単一キーストロークで発火するため、`chat:externalEditor` にバインドされた Ctrl+X Ctrl+E コードはエディタを開きません。441バインディングはエージェントビューで単一キーストロークで発火するため、`chat:externalEditor` にバインドされた Ctrl+X Ctrl+E コードはエディタをそこで開きません。

416 442

417<h3 id="voice-actions">443<h3 id="voice-actions">

418 音声アクション444 音声アクション

419</h3>445</h3>

420 446

421[音声ディクテーション](/docs/ja/voice-dictation)が有効な場合、`Chat` コンテキストで利用可能なアクション：447[音声ディクテーション](/docs/ja/voice-dictation) が有効な場合の `Chat` コンテキストで利用可能なアクション：

422 448

423| アクション | デフォルト | 説明 |449| アクション | デフォルト | 説明 |

424| :----------------- | :---- | :-------------------------------------------- |450| :----------------- | :---- | :------------------------------------ |

426 452

427<h3 id="scroll-actions">453<h3 id="scroll-actions">

428 スクロールアクション454 スクロールアクション

429</h3>455</h3>

430 456

431[フルスクリーンレンダリング](/docs/ja/fullscreen)が有効な場合、`Scroll` コンテキストで利用可能なアクション：457[フルスクリーンレンダリング](/docs/ja/fullscreen) が有効な場合の `Scroll` コンテキストで利用可能なアクション：

432 458

433| アクション | デフォルト | 説明 |459| アクション | デフォルト | 説明 |

434| :-------------------------- | :------------------- | :---------------------------------------------------------------- |460| :-------------------------- | :------------------- | :------------------------------------------------------------ |

453 479

454<h2 id="keystroke-syntax">480<h2 id="keystroke-syntax">

455 キーストロークシンタックス481 キーストロークシンタックス

large-codebases.md +1 −1

Details

255 255

256これは特に[サブエージェントワークツリー分離](/docs/ja/worktrees#isolate-subagents-with-worktrees)に役立ちます。サブエージェントはサブタスク用に生成される並列 Claude インスタンスで、ワークツリーで実行されるそれぞれは、フルツリーの代わりに軽量チェックアウトを取得します。セッション内のすべてのワークツリーは同じ `sparsePaths` を共有するため、1 つのサブエージェントが `packages/api/` を必要とし、別のサブエージェントが `packages/web/` を必要とする場合は、両方をリストします。256これは特に[サブエージェントワークツリー分離](/docs/ja/worktrees#isolate-subagents-with-worktrees)に役立ちます。サブエージェントはサブタスク用に生成される並列 Claude インスタンスで、ワークツリーで実行されるそれぞれは、フルツリーの代わりに軽量チェックアウトを取得します。セッション内のすべてのワークツリーは同じ `sparsePaths` を共有するため、1 つのサブエージェントが `packages/api/` を必要とし、別のサブエージェントが `packages/web/` を必要とする場合は、両方をリストします。

257 257

258`sparsePaths` にはディレクトリをリストし、個別のファイルはリストしません。`package.json`、`tsconfig.base.json`、ロックファイルなどのルートレベルのファイルは、リストするディレクトリと一緒に常にチェックアウトされます。ルートレベルのディレクトリはそうではないため、ワークツリー内でリポジトリルートの `.claude/settings.json`、`.claude/rules/`、または `.claude/skills/` を利用可能にしたい場合は、リストに `.claude` を含めます。258`sparsePaths` にはディレクトリをリストし、個別のファイルはリストしません。`package.json`、`tsconfig.base.json`、ロックファイルなどのルートレベルのファイルは、リストするディレクトリと一緒に常にチェックアウトされます。ルートレベルのディレクトリはそうではないため、ワークツリー内でリポジトリルートの `.claude/settings.json` または `.claude/rules/` を利用可能にしたい場合は、リストに `.claude` を含めます。プロジェクトスキル、エージェント、コマンドについては、[ワークツリーがメインチェックアウトと共有するもの](/docs/ja/worktrees#what-worktrees-share-with-the-main-checkout)を参照してください。

259 259

260Sparse checkout では、sparse ワークツリーが存在する間、git がリポジトリの共有 `.git/config` で `extensions.worktreeConfig` を有効にする必要があります。Claude Code は最後のワークツリーが削除された後、そのエントリを削除しますが、Claude Code が追加した場合のみです。自分で設定した値は削除されません。v2.1.207 より前では、エントリは最後のワークツリーが削除された後も残り、`tea` などの go-git ベースのツールは `git config --unset extensions.worktreeConfig` を実行するまでリポジトリを開くことができませんでした。260Sparse checkout では、sparse ワークツリーが存在する間、git がリポジトリの共有 `.git/config` で `extensions.worktreeConfig` を有効にする必要があります。Claude Code は最後のワークツリーが削除された後、そのエントリを削除しますが、Claude Code が追加した場合のみです。自分で設定した値は削除されません。v2.1.207 より前では、エントリは最後のワークツリーが削除された後も残り、`tea` などの go-git ベースのツールは `git config --unset extensions.worktreeConfig` を実行するまでリポジトリを開くことができませんでした。

261 261

llm-gateway-connect.md +2 −1

Details

578ゲートウェイを通じて Claude Code を実行する場合の最も一般的なエラーで、ゲートウェイ側の原因と修正方法です：578ゲートウェイを通じて Claude Code を実行する場合の最も一般的なエラーで、ゲートウェイ側の原因と修正方法です：

579 579

580| エラー | 原因 | 修正 |580| エラー | 原因 | 修正 |

581| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |581| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

582| 2 つの認証情報ソースという名前の起動警告で、`auth may not work as expected` で終わります。古いバージョンは代わりに `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` を表示します。 | ゲートウェイ認証情報と保存されたログインの両方がアクティブです。変数はリクエストに使用されますが、古いログインは予期しない認証動作を引き起こす可能性があります | 変数を設定解除して保存されたログインを使用するか、`/logout` を実行してゲートウェイ認証情報を使用します |582| 2 つの認証情報ソースという名前の起動警告で、`auth may not work as expected` で終わります。古いバージョンは代わりに `Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set` を表示します。 | ゲートウェイ認証情報と保存されたログインの両方がアクティブです。変数はリクエストに使用されますが、古いログインは予期しない認証動作を引き起こす可能性があります | 変数を設定解除して保存されたログインを使用するか、`/logout` を実行してゲートウェイ認証情報を使用します |

583| 無効または認識されないトークンという名前の `401` エラー | 認証情報はゲートウェイが発行したものではないか、ゲートウェイが読むヘッダーにあります | [認証情報テーブル](#set-the-credential-variable)で変数が認証情報の種類と一致することを確認し、ゲートウェイで失効した場合はキーを再生成します |583| 無効または認識されないトークンという名前の `401` エラー | 認証情報はゲートウェイが発行したものではないか、ゲートウェイが読むヘッダーにあります | [認証情報テーブル](#set-the-credential-variable)で変数が認証情報の種類と一致することを確認し、ゲートウェイで失効した場合はキーを再生成します |

584| `Your apiKeyHelper script is failing`、または非対話型モードで stderr に `apiKeyHelper failed:` | [`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) 設定のコマンドが使用可能なキーを生成しなかったため、リクエストはプレースホルダーキーを含みます | コマンドを直接実行して失敗の理由を確認し、期限切れセッションを報告する場合は認証情報プロバイダーで再認証します。[エラーリファレンス](/docs/ja/errors#your-apikeyhelper-script-is-failing)を参照してください |584| `Your apiKeyHelper script is failing`、または非対話型モードで stderr に `apiKeyHelper failed:` | [`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) 設定のコマンドが使用可能なキーを生成しなかったため、リクエストはプレースホルダーキーを含みます | コマンドを直接実行して失敗の理由を確認し、期限切れセッションを報告する場合は認証情報プロバイダーで再認証します。[エラーリファレンス](/docs/ja/errors#your-apikeyhelper-script-is-failing)を参照してください |

588| `thinking` または `adaptive` という名前の `400` エラー（`Input tag 'adaptive' found` など） | 上流モデルビルドは Claude Code が Claude 4.6 以降のモデルに要求する適応推論を受け入れません | ゲートウェイの上流をアップグレードします。Opus 4.6 と Sonnet 4.6 では、代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` が機能します。[モデル設定](/docs/ja/model-config)機能変数は、`CLAUDE_CODE_USE_BEDROCK` や `CLAUDE_CODE_USE_VERTEX` などのプロバイダー設定にのみ適用され、`ANTHROPIC_BASE_URL` ゲートウェイの背後には適用されません |588| `thinking` または `adaptive` という名前の `400` エラー（`Input tag 'adaptive' found` など） | 上流モデルビルドは Claude Code が Claude 4.6 以降のモデルに要求する適応推論を受け入れません | ゲートウェイの上流をアップグレードします。Opus 4.6 と Sonnet 4.6 では、代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` が機能します。[モデル設定](/docs/ja/model-config)機能変数は、`CLAUDE_CODE_USE_BEDROCK` や `CLAUDE_CODE_USE_VERTEX` などのプロバイダー設定にのみ適用され、`ANTHROPIC_BASE_URL` ゲートウェイの背後には適用されません |

589| ゲートウェイ独自の言葉でコンテキストまたはトークン制限を述べる `400` エラー（`ContextWindowExceededError` または `prompt token count of N exceeds the limit of M` など） | ゲートウェイはモデルのネイティブウィンドウより小さいコンテキストを強制し、上流エラーを書き直すため、Claude Code は[長すぎるエラー](/docs/ja/errors#prompt-is-too-long)として認識せず、自動的にコンパクト化して再試行しません | `/compact` を実行してセッションを復旧します。防ぐには、`CLAUDE_CODE_AUTO_COMPACT_WINDOW` をゲートウェイの制限に設定します。Claude Code は値を少なくとも 100,000 トークン、最大でもモデルのコンテキストウィンドウにクランプするため、100,000 未満のゲートウェイ制限は一致できず、`/compact` はそこでの復旧のままです。また、`CLAUDE_CODE_MAX_OUTPUT_TOKENS` をゲートウェイモデルの出力制限より下に設定します |589| ゲートウェイ独自の言葉でコンテキストまたはトークン制限を述べる `400` エラー（`ContextWindowExceededError` または `prompt token count of N exceeds the limit of M` など） | ゲートウェイはモデルのネイティブウィンドウより小さいコンテキストを強制し、上流エラーを書き直すため、Claude Code は[長すぎるエラー](/docs/ja/errors#prompt-is-too-long)として認識せず、自動的にコンパクト化して再試行しません | `/compact` を実行してセッションを復旧します。防ぐには、`CLAUDE_CODE_AUTO_COMPACT_WINDOW` をゲートウェイの制限に設定します。Claude Code は値を少なくとも 100,000 トークン、最大でもモデルのコンテキストウィンドウにクランプするため、100,000 未満のゲートウェイ制限は一致できず、`/compact` はそこでの復旧のままです。また、`CLAUDE_CODE_MAX_OUTPUT_TOKENS` をゲートウェイモデルの出力制限より下に設定します |

590| Claude Code v2.1.265 から v2.1.267 で、ツールの入力スキーマまたはその `pattern` を拒否するゲートウェイ独自の言葉での `400` エラー | これらのバージョンでの段階的なロールアウトで、[Artifact ツール](/docs/ja/artifacts#availability)スキーマは `\p{...}` Unicode 文字クラスを持つ正規表現を含みます。Anthropic API はそれを受け入れますが、各ツールスキーマの `pattern` を独自の正規表現エンジンでチェックするゲートウェイまたは上流は、リクエスト全体を拒否します | v2.1.268 以降に更新します。これは正規表現を送信しません。影響を受けるバージョンでは、[アーティファクトをオフにします](/docs/ja/artifacts#disable-artifacts)。これはツールとそのスキーマをリクエストから削除します |590| Claude Code v2.1.265 から v2.1.267 で、ツールの入力スキーマまたはその `pattern` を拒否するゲートウェイ独自の言葉での `400` エラー | これらのバージョンでの段階的なロールアウトで、[Artifact ツール](/docs/ja/artifacts#availability)スキーマは `\p{...}` Unicode 文字クラスを持つ正規表現を含みます。Anthropic API はそれを受け入れますが、各ツールスキーマの `pattern` を独自の正規表現エンジンでチェックするゲートウェイまたは上流は、リクエスト全体を拒否します | v2.1.268 以降に更新します。これは正規表現を送信しません。影響を受けるバージョンでは、[アーティファクトをオフにします](/docs/ja/artifacts#disable-artifacts)。これはツールとそのスキーマをリクエストから削除します |

591| `400` エラーがすべてのリクエストで、ゲートウェイ独自の言葉で認識されないツールタイプを拒否します。例えば `Input tag 'advisor_20260301'`。Claude Code v2.1.275 | そのバージョンでの段階的なロールアウトで、リクエストはアドバイザーがオフの場合でも[アドバイザーツール](/docs/ja/advisor)エントリを含みます。Anthropic API はそれを受け入れますが、ツールタイプを検証するゲートウェイまたは上流はリクエスト全体を拒否します。[リクエスト本体フィールドを変更せずに転送](/docs/ja/llm-gateway-protocol#forward-as-open-lists)するものはそれを影響を受けずに通します。エントリは会話コンテンツを含まない宣言です | v2.1.276 以降に更新します。これは `ANTHROPIC_BASE_URL` ゲートウェイの背後でエントリを送信しません。アドバイザーをオンにしない限り。v2.1.275 では、[`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1`](/docs/ja/env-vars)を設定します。これはリクエストからエントリを削除します |

591| `/model` ピッカーから欠落しているモデル | ゲートウェイモデル名は Claude Code の組み込みリストにありません。または Claude Code は組み込みオプションを置き換える [`modelPicker`](/docs/ja/settings-reference#modelpicker) ラインアップを表示しています | [ゲートウェイモデル検出](#add-gateway-models-to-the-model-picker)を有効にするか、[モデル設定](/docs/ja/model-config)変数で名前を追加します。Claude Code が置き換える `modelPicker` ラインアップを表示している場合は、ゲートウェイモデルをそれに追加するか、管理設定がそれを提供する場合は管理者に追加を依頼します |592| `/model` ピッカーから欠落しているモデル | ゲートウェイモデル名は Claude Code の組み込みリストにありません。または Claude Code は組み込みオプションを置き換える [`modelPicker`](/docs/ja/settings-reference#modelpicker) ラインアップを表示しています | [ゲートウェイモデル検出](#add-gateway-models-to-the-model-picker)を有効にするか、[モデル設定](/docs/ja/model-config)変数で名前を追加します。Claude Code が置き換える `modelPicker` ラインアップを表示している場合は、ゲートウェイモデルをそれに追加するか、管理設定がそれを提供する場合は管理者に追加を依頼します |

592| 推論リクエストが機能している間に `/fast` が `Fast mode unavailable due to network connectivity issues` を報告します | [高速モード](/docs/ja/fast-mode)の可用性チェックは `api.anthropic.com` に直接移動し、`ANTHROPIC_BASE_URL` に従いません。そのため、ブロックされた直接エグレスはチェックに失敗します。チェックが `ANTHROPIC_API_KEY` からゲートウェイ発行キーまたは `apiKeyHelper` を提示し、Anthropic がそれを拒否する場合、同じメッセージが開いたネットワークに表示されます | エグレスがブロックされている場合は `api.anthropic.com` をホワイトリストに登録するか、スキップ変数を設定します。拒否されたゲートウェイキーの場合のみ、スキップ変数が役立ちます。[プロキシと LLM ゲートウェイの背後で高速モードを使用する](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |593| 推論リクエストが機能している間に `/fast` が `Fast mode unavailable due to network connectivity issues` を報告します | [高速モード](/docs/ja/fast-mode)の可用性チェックは `api.anthropic.com` に直接移動し、`ANTHROPIC_BASE_URL` に従いません。そのため、ブロックされた直接エグレスはチェックに失敗します。チェックが `ANTHROPIC_API_KEY` からゲートウェイ発行キーまたは `apiKeyHelper` を提示し、Anthropic がそれを拒否する場合、同じメッセージが開いたネットワークに表示されます | エグレスがブロックされている場合は `api.anthropic.com` をホワイトリストに登録するか、スキップ変数を設定します。拒否されたゲートウェイキーの場合のみ、スキップ変数が役立ちます。[プロキシと LLM ゲートウェイの背後で高速モードを使用する](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |

593| `ANTHROPIC_AUTH_TOKEN` で認証されたセッションで `/fast` が `Fast mode has been disabled by your organization` を報告します。組織が高速モードを有効にしている場合でも | 可用性チェックには claude.ai ログインまたは Anthropic API キーが必要です。ベアラートークンのみの場合、Claude Code は高速モードをチェックを送信せずに無効として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` を設定します。[プロキシと LLM ゲートウェイの背後で高速モードを使用する](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |594| `ANTHROPIC_AUTH_TOKEN` で認証されたセッションで `/fast` が `Fast mode has been disabled by your organization` を報告します。組織が高速モードを有効にしている場合でも | 可用性チェックには claude.ai ログインまたは Anthropic API キーが必要です。ベアラートークンのみの場合、Claude Code は高速モードをチェックを送信せずに無効として扱います | `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK=1` を設定します。[プロキシと LLM ゲートウェイの背後で高速モードを使用する](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)を参照してください |

llm-gateway-protocol.md +34 −0

Details

144 144

145開発者が `ANTHROPIC_CUSTOM_HEADERS` を設定した場合、それらのヘッダーもリクエストに表示されます。145開発者が `ANTHROPIC_CUSTOM_HEADERS` を設定した場合、それらのヘッダーもリクエストに表示されます。

146 146

147<h3 id="gateway-hint-headers">

148 ゲートウェイヒントヘッダー

149</h3>

150

151Claude Code はルーティングヒントも送信できます。ゲートウェイまたはルーターがリクエストをスケジュール、キャッシュ、または属性付けするために使用できるリクエストごとの事実です。Claude Code v2.1.273 以降が必要です。

152

153リクエストがそれらを含むかどうかは、Claude Code がそれをどこに送信するかによって異なります。

154

155* Anthropic API への直接接続：デフォルトで送信されます

156* カスタムベース URL：デフォルトでオフです。不明なヘッダーを拒否するプロキシはリクエストを失敗させるためです。それらを受け取るには、開発者向けに [`CLAUDE_CODE_GATEWAY_HINT_HEADERS=1`](/docs/ja/env-vars) を設定してください。例えば、[管理設定](/docs/ja/managed-settings)の `env` ブロックで設定できます

157* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、AWS 上の Claude Platform を含む他のバックエンド：`CLAUDE_CODE_GATEWAY_HINT_HEADERS=1` が設定されている場合にのみ送信されます

158

159`CLAUDE_CODE_GATEWAY_HINT_HEADERS` を `0` に設定すると、すべての接続でヘッダーが停止します。

160

161ヘッダーは以下の行にリストされているもののみを含みます。固定語彙、ツール名、および期間です。プロンプトテキストまたはファイルコンテンツは含まれません。すべての値は印字可能な ASCII です。

162

163| ヘッダー | 説明 |

164| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

165| `x-claude-code-request-class` | このリクエストの種類：メイン会話のターンの場合は `main`、[サブエージェント](/docs/ja/sub-agents)のターンの場合は `subagent`、ワークフロー内で実行されているエージェントの場合は `workflow`、会話をコンパクト化する要約リクエストの場合は `compaction`、セッションタイトル、分類器、および要約などのサイドリクエストの場合は `auxiliary`。すべてのリクエストで送信されます |

166| `x-claude-code-agent-type` | リクエストを発行したサブエージェントの種類：`Explore`、`Plan`、または `general-purpose` などの組み込みエージェント型名、ユーザー定義エージェントの場合は `custom`、[エージェントチーム](/docs/ja/agent-teams)メンバーがリードのプロセスで実行されている場合は `teammate`、または [フォーク](/docs/ja/sub-agents#fork-the-current-conversation)の場合は `fork`。サブエージェント自身のターンにのみ存在します。サブエージェントのコンパクト化またはサイドリクエストはエージェント ID を保持しますが、タイプは含みません。ユーザーが選択したエージェント名は送信されません |

167| `x-claude-code-compaction` | [コンパクト化](/docs/ja/prompt-caching#compacting-the-conversation)中に会話を要約するリクエストに存在します。値は何がトリガーしたかを示します。コンテキストウィンドウが容量に近づいた場合は `auto`、`/compact` の場合は `manual`、API がリクエストが長すぎると拒否した場合は `reactive`。他のすべてのリクエストでは存在しません |

168| `x-claude-code-context-compacted` | コンパクト化後の最初のメイン会話リクエストに 1 回存在し、`x-claude-code-compaction` と同じ値を持ちます。このリクエストの前の会話プレフィックスはもう使用されないため、それをキーとしたキャッシュは削除できます |

169| `x-claude-code-prev-tool-durations` | このリクエストが含む結果のツール呼び出しの測定実行時間。`<name>=<ms>;<name>=<ms>` として、例えば `Bash=742;Read=9`。同じ会話のツール呼び出しのバッチ後の次のリクエストで送信されます。メインセッションまたはサブエージェントから送信されます |

170

171`x-claude-code-prev-tool-durations` を解析する前に、Claude Code が値をどのように構築し、何を除外するかを確認してください。

172

173* エントリ：実行されたツール呼び出しごとに 1 つ。その結果が収集された順序で、ミリ秒単位です

174* キャップ：Claude Code は最大 32 エントリと 4 KB を送信し、最初のエントリを保持します

175* エンコーディング：ツール名はパーセントエンコードされ、`%`、`;`、`=`、カンマ、スペース、および印字可能な ASCII 外の任意の文字をカバーします

176* 解析：`;` で分割し、次に `=` で分割し、各名前をデコードします

177* 不在：コンパクト化呼び出し、サイドリクエスト、および新しいプロンプトの最初のリクエストはそれを含みません。不足しているヘッダーをツールを実行しなかったターンとして読まないでください

178* 時間：各エントリは権限プロンプトとフックを除外し、並列ツール呼び出しは各自の時間を報告するため、エントリはリクエスト間のギャップに加算されません

179

147<h3 id="forward-as-open-lists">180<h3 id="forward-as-open-lists">

148 オープンリストとして転送181 オープンリストとして転送

149</h3>182</h3>

221 254

222* アップストリームが `thinking` フィールド、会話中のシステムメッセージ、またはそのようなメッセージの `cache_control` マーカーを拒否する場合、Claude Code はリクエストをリトライし、拒否された機能を会話の残りの部分で無効にします255* アップストリームが `thinking` フィールド、会話中のシステムメッセージ、またはそのようなメッセージの `cache_control` マーカーを拒否する場合、Claude Code はリクエストをリトライし、拒否された機能を会話の残りの部分で無効にします

223* アップストリームが[思考署名](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)を拒否する場合（`bound to a different conversation` という `400` を含む）、Claude Code はリクエストを以前の思考ブロックなしでリトライし、それらを後のすべてのリクエストから除外します。新しい応答には依然として思考が含まれます256* アップストリームが[思考署名](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)を拒否する場合（`bound to a different conversation` という `400` を含む）、Claude Code はリクエストを以前の思考ブロックなしでリトライし、それらを後のすべてのリクエストから除外します。新しい応答には依然として思考が含まれます

257* ゲートウェイまたはそのアップストリームが [advisor ツール](/docs/ja/advisor)エントリを `tools` で認識されないツールタイプとして拒否する場合、Claude Code はそのエントリとその `anthropic-beta` 値なしでリクエストを 1 回リトライします。その後のそのベース URL へのリクエストは Claude Code が終了するまで advisor を除外し、その時間は `/advisor` は開発者に利用不可です。Claude Code はこの拒否を `Input tag` の後にツールタイプを命名するメッセージを含む `400` または `422` レスポンスによって認識します。例えば `Input tag 'advisor_20260301'` です。v2.1.280 より前では、Claude Code はこの拒否をリトライしませんでした

224* Claude Code はコンテキスト管理またはツールスキーマフィールド拒否をリトライしません。それらの `400` エラーは開発者に到達します258* Claude Code はコンテキスト管理またはツールスキーマフィールド拒否をリトライしません。それらの `400` エラーは開発者に到達します

225 259

226`bound to a different conversation` 拒否は API の[保存された思考](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking)チェックから来ます。これは、`system`、`tools`、または以前の `messages` コンテンツが思考を生成したリクエストと異なる場合に失敗します。そのコンテンツのいずれかを書き直すゲートウェイは、拒否自体を引き起こす可能性があります。[ライブラリ、プロキシ、およびゲートウェイ](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways)は、変更なしで渡すべき内容をカバーしています。260`bound to a different conversation` 拒否は API の[保存された思考](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking)チェックから来ます。これは、`system`、`tools`、または以前の `messages` コンテンツが思考を生成したリクエストと異なる場合に失敗します。そのコンテンツのいずれかを書き直すゲートウェイは、拒否自体を引き起こす可能性があります。[ライブラリ、プロキシ、およびゲートウェイ](https://platform.claude.com/docs/en/build-with-claude/preserved-thinking#libraries-proxies-gateways)は、変更なしで渡すべき内容をカバーしています。

llm-gateway-rollout.md +2 −1

Details

180どちらのパスを選択するかに関わらず、同じ変数セットが適用されます。ほとんどのロールアウトは `ANTHROPIC_BASE_URL` と認証情報のみが必要です。ゲートウェイセットアップが必要とする場合は、条件付き行を含めてください。180どちらのパスを選択するかに関わらず、同じ変数セットが適用されます。ほとんどのロールアウトは `ANTHROPIC_BASE_URL` と認証情報のみが必要です。ゲートウェイセットアップが必要とする場合は、条件付き行を含めてください。

181 181

182| 変数またはセッティング | 機能 | 含める場合 |182| 変数またはセッティング | 機能 | 含める場合 |

183| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |183| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

184| `ANTHROPIC_BASE_URL` | Claude Code の API リクエストを `api.anthropic.com` の代わりにゲートウェイに送信します | 常に |184| `ANTHROPIC_BASE_URL` | Claude Code の API リクエストを `api.anthropic.com` の代わりにゲートウェイに送信します | 常に |

185| `apiKeyHelper`、または `ANTHROPIC_AUTH_TOKEN` または `ANTHROPIC_API_KEY` の認証情報 | ゲートウェイへの各リクエストを認証します。ヘルパーはキーを取得するコマンドを実行します。変数は静的キーを保持し、それぞれ `Authorization: Bearer` と `x-api-key` として送信されます | 常に。3 つのうち 1 つ |185| `apiKeyHelper`、または `ANTHROPIC_AUTH_TOKEN` または `ANTHROPIC_API_KEY` の認証情報 | ゲートウェイへの各リクエストを認証します。ヘルパーはキーを取得するコマンドを実行します。変数は静的キーを保持し、それぞれ `Authorization: Bearer` と `x-api-key` として送信されます | 常に。3 つのうち 1 つ |

187| `CLAUDE_CODE_GATEWAY_HINT_HEADERS` | [ゲートウェイヒントヘッダー](/docs/ja/llm-gateway-protocol#gateway-hint-headers)を送信します。これはゲートウェイでのルーティングとスケジューリング決定のために各リクエストを分類します。Claude Code v2.1.273 以降が必要です | ゲートウェイがヒントヘッダーを読み取る場合 |

188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Claude Code がプリリリース機能ヘッダーとボディフィールドを送信するのを停止します。[プリリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)は正確なスコープをカバーしています | ゲートウェイが Amazon Bedrock または Google Cloud の Agent Platform アップストリームに転送し、ベータフィールドを拒否する場合。[ゲートウェイ要件](#gateway-requirements)を参照してください。 |189| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Claude Code がプリリリース機能ヘッダーとボディフィールドを送信するのを停止します。[プリリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)は正確なスコープをカバーしています | ゲートウェイが Amazon Bedrock または Google Cloud の Agent Platform アップストリームに転送し、ベータフィールドを拒否する場合。[ゲートウェイ要件](#gateway-requirements)を参照してください。 |

189| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` または `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | `ANTHROPIC_BASE_URL` に従う代わりに `api.anthropic.com` に直接呼び出す可用性チェックが失敗、インターセプト、または Anthropic 認証情報がないためスキップされた場合、[高速モード](/docs/ja/fast-mode)を復元します | 組織が高速モードを使用し、開発者が `ANTHROPIC_AUTH_TOKEN` のみで認証する場合、`ANTHROPIC_API_KEY` のゲートウェイ発行キーまたは `apiKeyHelper` から認証する場合、またはネットワークが `api.anthropic.com` への直接リクエストをブロックまたはインターセプトする場合。[プロキシと LLM ゲートウェイの背後で高速モードを使用する](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)は、どちらの変数が設定に一致するかをカバーしています。 |190| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` または `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | `ANTHROPIC_BASE_URL` に従う代わりに `api.anthropic.com` に直接呼び出す可用性チェックが失敗、インターセプト、または Anthropic 認証情報がないためスキップされた場合、[高速モード](/docs/ja/fast-mode)を復元します | 組織が高速モードを使用し、開発者が `ANTHROPIC_AUTH_TOKEN` のみで認証する場合、`ANTHROPIC_API_KEY` のゲートウェイ発行キーまたは `apiKeyHelper` から認証する場合、またはネットワークが `api.anthropic.com` への直接リクエストをブロックまたはインターセプトする場合。[プロキシと LLM ゲートウェイの背後で高速モードを使用する](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways)は、どちらの変数が設定に一致するかをカバーしています。 |

managed-settings.md +8 −2

Details

361無効な場合にドロップされない強制キーがいくつかあります。Claude Code は値が修正されるまでより厳密なフォールバックを適用します。テーブルは各キーに対して適用されるものを示します。361無効な場合にドロップされない強制キーがいくつかあります。Claude Code は値が修正されるまでより厳密なフォールバックを適用します。テーブルは各キーに対して適用されるものを示します。

362 362

363| フィールド | 存在するが無効な場合の動作 |363| フィールド | 存在するが無効な場合の動作 |

364| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |364| :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

365| `allowedMcpServers` | ユーザーが追加する MCP サーバーが許可されないように、値が修正されるまで空のアローリストとして適用されます。組織が [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) を通じて配信するサーバーは引き続きロードされ、`managed-mcp.json` サーバーは[サーバーの評価方法](/docs/ja/managed-mcp#how-a-server-is-evaluated)に従ってロードされます。個別の無効なエントリは削除され、有効なサブセットが適用されます。 |365| `allowedMcpServers` | ユーザーが追加する MCP サーバーが許可されないように、値が修正されるまで空のアローリストとして適用されます。組織が [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) を通じて配信するサーバーは引き続きロードされ、`managed-mcp.json` サーバーは[サーバーの評価方法](/docs/ja/managed-mcp#how-a-server-is-evaluated)に従ってロードされます。個別の無効なエントリは削除され、有効なサブセットが適用されます。 |

366| `allowedHttpHookUrls` | Claude Code は値を修正するまで空の管理[アローリスト](/docs/ja/settings-reference#allowedhttphookurls)を適用するため、HTTP フックは別の設定ファイルがその URL をリストしている場合にのみ実行されます。無効なエントリが 1 つだけの場合、Claude Code はそのエントリを削除し、残りを適用します。 |366| `allowedHttpHookUrls` | Claude Code は値を修正するまで空の管理[アローリスト](/docs/ja/settings-reference#allowedhttphookurls)を適用するため、HTTP フックは別の設定ファイルがその URL をリストしている場合にのみ実行されます。無効なエントリが 1 つだけの場合、Claude Code はそのエントリを削除し、残りを適用します。 |

367| `httpHookAllowedEnvVars` | Claude Code は値を修正するまで空の管理[アローリスト](/docs/ja/settings-reference#httphookallowedenvvars)を適用するため、ヘッダー変数は別の設定ファイルがそれを名前で示している場合にのみ補間されます。無効なエントリが 1 つだけの場合、Claude Code はそのエントリを削除し、残りを適用します。 |367| `httpHookAllowedEnvVars` | Claude Code は値を修正するまで空の管理[アローリスト](/docs/ja/settings-reference#httphookallowedenvvars)を適用するため、ヘッダー変数は別の設定ファイルがそれを名前で示している場合にのみ補間されます。無効なエントリが 1 つだけの場合、Claude Code はそのエントリを削除し、残りを適用します。 |

368| `allowedChannelPlugins` | 値を修正するまで空のアローリストとして適用されるため、`--channels` に渡されるチャネルプラグインは許可されません。無効なエントリが 1 つだけの場合、それを削除し、残りを適用します。 |368| `allowedChannelPlugins` | 値を修正するまで空のアローリストとして適用されるため、`--channels` に渡されるチャネルプラグインは許可されません。無効なエントリが 1 つだけの場合、それを削除し、残りを適用します。 |

369| `strictKnownMarketplaces` | 値が修正されるまで空のアローリストとして適用されるため、[マーケットプレイスソース](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)は許可されません。無効なエントリ、または `hostPattern` 正規表現がコンパイルされないなど適用できないエントリは削除され、有効なサブセットが適用されます。 |

369| `allowManagedHooksOnly` | 修正されるまで `true` として扱われます。[フック制限](/docs/ja/settings-reference#allowmanagedhooksonly)が適用され、`disableCommandPluginSources` が明示的に `false` でない限り、コマンドソースのプラグインは無効になります。 |370| `allowManagedHooksOnly` | 修正されるまで `true` として扱われます。[フック制限](/docs/ja/settings-reference#allowmanagedhooksonly)が適用され、`disableCommandPluginSources` が明示的に `false` でない限り、コマンドソースのプラグインは無効になります。 |

373| `disableSideloadFlags` | 値が修正されるまで `true` として扱われ、[`disableSideloadFlags`](/docs/ja/settings-reference#disablesideloadflags) にリストされた効果があります。 |

376| `syncClaudeAiPlugins` | `false` として扱われるため、[claude.ai プラグイン](/docs/ja/settings-reference#syncclaudeaiplugins)の同期は値が修正されるまでオフになります。 |

375| `gatewayInternalNetworks` | 無効な値が最も高い管理対象ソースから来ている場合、そのマシン上の `/login` は値が修正されるまで、すべての新しい[クラウドゲートウェイ](/docs/ja/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)サインインを拒否します。 |378| `gatewayInternalNetworks` | 無効な値が最も高い管理対象ソースから来ている場合、そのマシン上の `/login` は値が修正されるまで、すべての新しい[クラウドゲートウェイ](/docs/ja/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)サインインを拒否します。 |

376| `crossSessionInbound` | 最も制限的な値である `refuse` として扱われるため、値が修正されるまで[クロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)のインバウンドは拒否されます。開発者は[警告](/docs/ja/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse)を見ます。 |379| `crossSessionInbound` | 最も制限的な値である `refuse` として扱われるため、値が修正されるまで[クロスセッションメッセージ](/docs/ja/cross-session-messaging#control-inbound-messages)のインバウンドは拒否されます。開発者は[警告](/docs/ja/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse)を見ます。 |

377| `deniedMcpServers` | 個別の無効なエントリは削除され、有効なサブセットが適用されます。完全に無効な値は警告とともにドロップされます。すべてのサーバーを拒否するとポリシーが名前を付けなかったサーバーがブロックされるためです。 |380| `deniedMcpServers` | 個別の無効なエントリは削除され、有効なサブセットが適用されます。完全に無効な値は警告とともにドロップされます。すべてのサーバーを拒否するとポリシーが名前を付けなかったサーバーがブロックされるためです。 |

381| `blockedMarketplaces` | 個別の無効なエントリは削除され、有効なサブセットが適用されます。`hostPattern` 正規表現がコンパイルされないなど、解析されるが決してマッチしないエントリは警告とともに保持されます。修正されるまでは何もブロックしませんが、[マーケットプレイス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)は有効なままです。完全に無効な値は警告とともにドロップされます。すべてのマーケットプレイスをブロックするとポリシーが名前を付けなかったソースがブロックされるためです。 |

378| `sandbox.credentials` | 回復可能な無効なエントリは `mode: "deny"` に低下し、警告が表示されます。回復不可能なエントリは削除されます。有効なエントリは適用されたままです。[管理対象設定の無効な認証情報エントリ](/docs/ja/settings-reference#invalid-credential-entries-in-managed-settings)を参照してください |382| `sandbox.credentials` | 回復可能な無効なエントリは `mode: "deny"` に低下し、警告が表示されます。回復不可能なエントリは削除されます。有効なエントリは適用されたままです。[管理対象設定の無効な認証情報エントリ](/docs/ja/settings-reference#invalid-credential-entries-in-managed-settings)を参照してください |

379 383

380`allowedHttpHookUrls` と `httpHookAllowedEnvVars` は設定ファイル全体でマージされるため、管理対象リストが空の間、ユーザー、プロジェクト、またはローカル設定のエントリは引き続き適用されます。これら 2 つのキーと `allowedChannelPlugins` のフォールバックには Claude Code v2.1.267 以降が必要です。以前のバージョンは、値またはエントリが無効な場合、キー全体をドロップします。384`allowedHttpHookUrls` と `httpHookAllowedEnvVars` は設定ファイル全体でマージされるため、管理対象リストが空の間、ユーザー、プロジェクト、またはローカル設定のエントリは引き続き適用されます。

385

386これら 2 つのキーと `allowedChannelPlugins` のフォールバックには Claude Code v2.1.267 以降が必要です。以前のバージョンは、値またはエントリが無効な場合、キー全体をドロップします。`strictKnownMarketplaces`、`blockedMarketplaces`、および `disableSideloadFlags` のフォールバックには Claude Code v2.1.277 以降が必要です。以前のバージョンは、値またはエントリが無効な場合、キー全体をドロップします。

381 387

382`requiredMinimumVersion` と `requiredMaximumVersion` は設計上オープンに失敗します。無効な値は適用されるのではなくドロップされます。388`requiredMinimumVersion` と `requiredMaximumVersion` は設計上オープンに失敗します。無効な値は適用されるのではなくドロップされます。

383 389

memory.md +24 −9

Details

82<Tip>82<Tip>

83 `/init` を実行して、開始用の CLAUDE.md を自動的に生成します。Claude はコードベースを分析し、発見したビルドコマンド、テスト指示、プロジェクト規約を含むファイルを作成します。CLAUDE.md が既に存在する場合、`/init` は上書きするのではなく改善を提案します。そこから Claude が自分で発見しない指示で改善してください。83 `/init` を実行して、開始用の CLAUDE.md を自動的に生成します。Claude はコードベースを分析し、発見したビルドコマンド、テスト指示、プロジェクト規約を含むファイルを作成します。CLAUDE.md が既に存在する場合、`/init` は上書きするのではなく改善を提案します。そこから Claude が自分で発見しない指示で改善してください。

84 84

85 `CLAUDE_CODE_NEW_INIT=1` を設定して、インタラクティブなマルチフェーズフローを有効にします。`/init` はセットアップするアーティファクトを尋ねます。CLAUDE.md ファイル、スキル、フック。その後、サブエージェントでコードベースを探索し、フォローアップの質問でギャップを埋め、ファイルを書き込む前に確認可能な提案を提示します。85 インタラクティブなマルチフェーズフローの場合は、`/init` を実行する前に `CLAUDE_CODE_NEW_INIT` 環境変数を `1` に設定してください。シェルまたは [環境変数を設定する](/docs/ja/env-vars#set-environment-variables) に示されているように設定ファイルの `env` ブロックで設定してください。設定すると、`/init` はセットアップするアーティファクトを尋ねます。CLAUDE.md ファイル、スキル、フック。その後、サブエージェントでコードベースを探索し、フォローアップの質問でギャップを埋め、ファイルを書き込む前に確認可能な提案を提示します。変数は `/init` の実行方法のみを変更するため、設定したままにしておくことができます。

86</Tip>86</Tip>

87 87

88<h3 id="write-effective-instructions">88<h3 id="write-effective-instructions">

124 124

125バージョン管理にチェックインすべきではない個人的なプロジェクト固有の設定については、プロジェクトルートに `CLAUDE.local.md` を作成してください。これは `CLAUDE.md` と一緒に読み込まれ、同じ方法で扱われます。`CLAUDE.local.md` を `.gitignore` に追加して、コミットされないようにしてください。`CLAUDE_CODE_NEW_INIT=1` が設定されている場合、`/init` を実行して個人オプションを選択するとこれが自動的に行われます。125バージョン管理にチェックインすべきではない個人的なプロジェクト固有の設定については、プロジェクトルートに `CLAUDE.local.md` を作成してください。これは `CLAUDE.md` と一緒に読み込まれ、同じ方法で扱われます。`CLAUDE.local.md` を `.gitignore` に追加して、コミットされないようにしてください。`CLAUDE_CODE_NEW_INIT=1` が設定されている場合、`/init` を実行して個人オプションを選択するとこれが自動的に行われます。

126 126

127同じリポジトリの複数の git worktree で作業する場合、gitignored `CLAUDE.local.md` は作成した worktree にのみ存在します。worktree 全体で個人的な指示を共有するには、代わりにホームディレクトリからファイルをインポートしてください。127同じリポジトリの複数の git worktrees で作業する場合、gitignored `CLAUDE.local.md` は作成した worktree にのみ存在します。worktree 全体で個人的な指示を共有するには、代わりにホームディレクトリからファイルをインポートしてください。

128 128

129```text theme={null}129```text theme={null}

130# Individual Preferences130# Individual Preferences

165CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config165CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

166```166```

167 167

168これは追加ディレクトリから `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。`CLAUDE.local.md` は [`--setting-sources`](/docs/ja/cli-reference) から `local` を除外した場合はスキップされます。168インライン形式はその 1 回の起動に対して Bash または Zsh で変数を設定します。すべてのセッションで有効に保つには、[環境変数を設定する](/docs/ja/env-vars#set-environment-variables) に示されているように `~/.claude/settings.json` の `env` ブロックに追加してください。

169

170これは追加ディレクトリから `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。[`--setting-sources`](/docs/ja/cli-reference) から `local` を除外した場合、`CLAUDE.local.md` はスキップされます。

169 171

170<h3 id="organize-rules-with-claude/rules/">172<h3 id="organize-rules-with-claude/rules/">

171 `.claude/rules/` でルールを整理する173 `.claude/rules/` でルールを整理する

244 246

245グロブ構文は `[` をブラケット式（`[abc]` など）の開始として扱います。`photos [2024/**` のようにブラケット式として読めない `[` を持つパターンは無効です。何もマッチしず、ルールの他のパターンは機能し続けます。ファイル名内のリテラル `[` をマッチするには、`photos \[2024/**` としてエスケープしてください。v2.1.207 より前では、1 つの無効なパターンは、マッチしない代わりに、ルールが評価されたすべてのファイルに対して Read ツールを失敗させました。247グロブ構文は `[` をブラケット式（`[abc]` など）の開始として扱います。`photos [2024/**` のようにブラケット式として読めない `[` を持つパターンは無効です。何もマッチしず、ルールの他のパターンは機能し続けます。ファイル名内のリテラル `[` をマッチするには、`photos \[2024/**` としてエスケープしてください。v2.1.207 より前では、1 つの無効なパターンは、マッチしない代わりに、ルールが評価されたすべてのファイルに対して Read ツールを失敗させました。

246 248

249<h4 id="rules-frontmatter-reference">

250 ルール frontmatter リファレンス

251</h4>

252

253YAML [frontmatter](/docs/ja/glossary#frontmatter) を使用してルールを設定してください。`---` マーカーの間に配置します。`paths` は Claude Code が読み取る唯一のフィールドです。その他のフィールドはエラーなしで無視されます。Claude Code はルールをコンテキストに読み込む前に frontmatter を削除します。

254

255| フィールド | 必須 | 説明 |

256| :------ | :-- | :------------------------------------------------------------------------------ |

257| `paths` | いいえ | [ルールを一致するファイルにスコープする](#path-specific-rules) グロブパターン。YAML リストまたはカンマ区切り文字列を受け入れます |

258

259マーカー間の YAML が解析されない場合、Claude Code は frontmatter を無視し、`paths` がないかのようにルールを読み込みます。`claude --debug` を実行して解析エラーを確認してください。

260

247<h4 id="share-rules-across-projects-with-symlinks">261<h4 id="share-rules-across-projects-with-symlinks">

248 シンボリックリンクでプロジェクト全体でルールを共有する262 シンボリックリンクでプロジェクト全体でルールを共有する

249</h4>263</h4>

271└── workflows.md # Your preferred workflows285└── workflows.md # Your preferred workflows

272```286```

273 287

274ユーザーレベルのルールはプロジェクトルールの前に読み込まれ、プロジェクトルールに高い優先度を与えます。288ユーザーレベルのルールはプロジェクトルールの前に読み込まれるため、プロジェクトルールは Claude のコンテキストでユーザールールより後に表示されます。どちらのセットも他方をオーバーライドしません。ユーザールールとプロジェクトルールが矛盾する場合、Claude はどちらか一方に従う可能性があるため、2 つを一貫性のあるものに保ってください。

275 289

276<h3 id="manage-claude-md-for-large-teams">290<h3 id="manage-claude-md-for-large-teams">

277 大規模なチーム向けに CLAUDE.md を管理する291 大規模なチーム向けに CLAUDE.md を管理する

424* Claude Code v2.1.277 より前のバージョンを使用している438* Claude Code v2.1.277 より前のバージョンを使用している

425* セッションが Anthropic から [フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)（例えば Amazon Bedrock または別のサードパーティプロバイダーを使用している、またはテレメトリを無効にしている）。リンク先のセクションに完全なリストがあります439* セッションが Anthropic から [フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)（例えば Amazon Bedrock または別のサードパーティプロバイダーを使用している、またはテレメトリを無効にしている）。リンク先のセクションに完全なリストがあります

426* `AGENTS.md` サポート付きのバージョンに [インストールまたはアップグレード](/docs/ja/env-vars#first-session-after-an-install-or-upgrade) した後の最初のセッションです。次のセッションから Claude は `AGENTS.md` を読み込みます440* `AGENTS.md` サポート付きのバージョンに [インストールまたはアップグレード](/docs/ja/env-vars#first-session-after-an-install-or-upgrade) した後の最初のセッションです。次のセッションから Claude は `AGENTS.md` を読み込みます

427* あなたまたは組織が [`disableAllHooks`](/docs/ja/settings-reference#disableallhooks) または [`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) を設定したか、`/plugin` で組み込み `agents-md` プラグインを無効にしました441* 組み込み `agents-md` プラグインを `/plugin` で無効にしました

428 442

429これらのセッションで Claude に `AGENTS.md` を提供するには、[`CLAUDE.md` からインポート](#share-one-file-with-other-coding-tools) してください。443これらのセッションで Claude に `AGENTS.md` を提供するには、[`CLAUDE.md` からインポート](#share-one-file-with-other-coding-tools) してください。

430 444

435Claude が **Project instructions** セッティングを通じて読み込む `AGENTS.md` は、これらの場所で `CLAUDE.md` と異なります。449Claude が **Project instructions** セッティングを通じて読み込む `AGENTS.md` は、これらの場所で `CLAUDE.md` と異なります。

436 450

438| :--------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------ |452| :--------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------- | :------------------------------------------------------------------ |

439| `/memory` と `/context` の **Memory files** リスト | リストされている | リストされていない。Claude がそれを読み込んだことを確認するには、既定値の下の [`AGENTS.md loaded` 行](#when-claude-code-reads-agents-md) を探すか、Claude にプロジェクト指示が何かを尋ねてください |

441| [`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`](#load-from-additional-directories) が設定されている間に `--add-dir` で追加するディレクトリ | それらの `CLAUDE.md` が読み込まれる | それらの `AGENTS.md` は読み込まれません |454| [`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`](#load-from-additional-directories) が設定されている間に `--add-dir` で追加するディレクトリ | それらの `CLAUDE.md` が読み込まれる | それらの `AGENTS.md` は読み込まれません |

604 617

605デバッグするには：618デバッグするには：

606 619

607* `/context` を実行し、**Memory files** の下のリストを確認して、CLAUDE.md と CLAUDE.local.md ファイルが読み込まれたことを確認します。`CLAUDE.md` ファイルがそこにない場合、Claude はそれを見ることができません。`AGENTS.md` は、Claude が [直接読み込む](#where-agents-md-differs-from-claude-md) 場合ではなく、`CLAUDE.md` がそれをインポートする場合にのみそこに表示されます。`/memory` を使用してファイルを開いて編集します。620* `/context` を実行し、**Memory files** の下のリストを確認して、CLAUDE.md と CLAUDE.local.md ファイルが読み込まれたことを確認します。`CLAUDE.md` ファイルがそこにない場合、Claude はそれを見ることができません。`/memory` を使用してファイルを開いて編集します。

608* 関連する CLAUDE.md がセッションに読み込まれる場所にあることを確認します（[CLAUDE.md ファイルをどこに配置するかを選択する](#choose-where-to-put-claude-md-files) を参照）。621* 関連する CLAUDE.md がセッションに読み込まれる場所にあることを確認します（[CLAUDE.md ファイルをどこに配置するかを選択する](#choose-where-to-put-claude-md-files) を参照）。

609* 指示をより具体的にします。「Use 2-space indentation」は「format code nicely」よりも効果的です。622* 指示をより具体的にします。「Use 2-space indentation」は「format code nicely」よりも効果的です。

610* CLAUDE.md ファイル全体で矛盾する指示を探します。2 つのファイルが同じ動作に対して異なるガイダンスを提供する場合、Claude は任意に 1 つを選択する可能性があります。623* CLAUDE.md ファイル全体で矛盾する指示を探します。2 つのファイルが同じ動作に対して異なるガイダンスを提供する場合、Claude は任意に 1 つを選択する可能性があります。

6283. セッションが [AGENTS.md を読み込むことができない](#when-agents-md-support-is-unavailable) セッション（サードパーティプロバイダーのセッションやテレメトリが無効なセッションなど）であるかどうかを確認します。6413. セッションが [AGENTS.md を読み込むことができない](#when-agents-md-support-is-unavailable) セッション（サードパーティプロバイダーのセッションやテレメトリが無効なセッションなど）であるかどうかを確認します。

6294. セッションで `/config` を入力して設定パネルを開き、**Project instructions** が `claude-md` または `managed-only` に設定されていないことを確認します。そこに設定が表示されない場合、セッションは [AGENTS.md を読み込むことができない](#when-agents-md-support-is-unavailable) セッションです。6424. セッションで `/config` を入力して設定パネルを開き、**Project instructions** が `claude-md` または `managed-only` に設定されていないことを確認します。そこに設定が表示されない場合、セッションは [AGENTS.md を読み込むことができない](#when-agents-md-support-is-unavailable) セッションです。

630 643

631`AGENTS.md` は Claude が直接読み込む場合、`/memory` または `/context` に表示されないため、`AGENTS.md loaded` 行を確認するか、Claude にプロジェクト指示が何であるかを尋ねます。644Claude が `AGENTS.md` を読み込んだかどうかを確認するには、`/memory` を実行し、リストでそのパスを探します。

645

646v2.1.280 より前では、`/memory` と `/context` は Claude が直接読み込んだ `AGENTS.md` をリストしていませんでした。これらのバージョンでは、代わりに Claude にプロジェクト指示が何であるかを尋ねます。

632 647

633見つけた `CLAUDE.md` を保持したい場合、またはセッションが `AGENTS.md` を読み込むことができない場合は、[`AGENTS.md` の横に `AGENTS.md` をインポートする `CLAUDE.md` を追加します](#share-one-file-with-other-coding-tools)。648見つけた `CLAUDE.md` を保持したい場合、またはセッションが `AGENTS.md` を読み込むことができない場合は、[`AGENTS.md` の横に `AGENTS.md` をインポートする `CLAUDE.md` を追加します](#share-one-file-with-other-coding-tools)。

634 649

monitoring-usage.md +67 −6

Details

123| `OTEL_LOG_ASSISTANT_RESPONSES` | `assistant_response` イベントでアシスタント応答テキストのログを有効にする (デフォルト: 無効)。設定されていない場合、`OTEL_LOG_USER_PROMPTS` の値にフォールバックします。Claude Code v2.1.193 以降が必要です | `1` で有効化、`0` でマスク状態を保持 |123| `OTEL_LOG_ASSISTANT_RESPONSES` | `assistant_response` イベントでアシスタント応答テキストのログを有効にする (デフォルト: 無効)。設定されていない場合、`OTEL_LOG_USER_PROMPTS` の値にフォールバックします。Claude Code v2.1.193 以降が必要です | `1` で有効化、`0` でマスク状態を保持 |

124| `OTEL_LOG_TOOL_DETAILS` | ツールイベントおよびトレーススパン属性でツールパラメーターと入力引数のログを有効にする: Bash コマンド、MCP サーバーとツール名、スキル名、ユーザー作成ワークフロー名、ツール入力。また、`user_prompt` イベントでカスタム、プラグイン、MCP コマンド名を有効にします (デフォルト: 無効)。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、フラグがオフでも `mcp_server_name`/`mcp_tool_name` は `tool_decision`/`tool_result` で出力されます。この例外には Claude Code v2.1.214 以降が必要です | `1` で有効化 |124| `OTEL_LOG_TOOL_DETAILS` | ツールイベントおよびトレーススパン属性でツールパラメーターと入力引数のログを有効にする: Bash コマンド、MCP サーバーとツール名、スキル名、ユーザー作成ワークフロー名、ツール入力。また、`user_prompt` イベントでカスタム、プラグイン、MCP コマンド名を有効にします (デフォルト: 無効)。Claude Desktop の組み込みサーバーの場合、Claude Desktop が所有するセッションでは、フラグがオフでも `mcp_server_name`/`mcp_tool_name` は `tool_decision`/`tool_result` で出力されます。この例外には Claude Code v2.1.214 以降が必要です | `1` で有効化 |

125| `OTEL_LOG_TOOL_CONTENT` | [`tool.output` スパンイベント](#tool-output-span-event)でツールコンテンツのログを有効にする (デフォルト: 無効)。スパン属性は[独自のゲート](#new-context-gates)の下でツールコンテンツを含みます。[トレース](#traces-beta)が必要です。コンテンツはコンテンツ制限で切り詰められます (デフォルト: 60 KB) | `1` で有効化 |125| `OTEL_LOG_TOOL_CONTENT` | [`tool.output` スパンイベント](#tool-output-span-event)でツールコンテンツのログを有効にする (デフォルト: 無効)。スパン属性は[独自のゲート](#new-context-gates)の下でツールコンテンツを含みます。[トレース](#traces-beta)が必要です。コンテンツはコンテンツ制限で切り詰められます (デフォルト: 60 KB) | `1` で有効化 |

126| `OTEL_LOG_MANAGED_SETTINGS` | マスク処理された管理設定と、マスク処理前の設定の SHA-256 ダイジェストを [管理設定解決](#managed-settings-resolved-event)イベントに追加します (デフォルト: 無効)。プロジェクトまたはローカル設定の値はそれをオンにしません。Claude Code v2.1.274 以降が必要です | `1` で有効化 |

126| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストとレスポンス JSON 全体を `api_request_body` / `api_response_body` ログイベントとして出力します (デフォルト: 無効)。ボディには会話履歴全体が含まれます。これを有効にすることは、`OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、および `OTEL_LOG_TOOL_CONTENT` が明かすすべてのものに同意することを意味します | `1` でコンテンツ制限で切り詰められたインラインボディ (デフォルト: 60 KB)、または `file:<dir>` でディスク上の切り詰められていないボディと、イベント内の `body_ref` ポインター |127| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストとレスポンス JSON 全体を `api_request_body` / `api_response_body` ログイベントとして出力します (デフォルト: 無効)。ボディには会話履歴全体が含まれます。これを有効にすることは、`OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、および `OTEL_LOG_TOOL_CONTENT` が明かすすべてのものに同意することを意味します | `1` でコンテンツ制限で切り詰められたインラインボディ (デフォルト: 60 KB)、または `file:<dir>` でディスク上の切り詰められていないボディと、イベント内の `body_ref` ポインター |

127| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツ制限: モデルレスポンス、ツールコンテンツ、システムプロンプト、生 API ボディなどのコンテンツを含む属性の最大長 (UTF-16 コード単位、デフォルト: 61440、つまり 60 KB)。デフォルトは 64 KB で属性値をキャップするバックエンド向けにサイズ設定されています。バックエンドがより大きな値を受け入れる場合はそれを上げるか、テレメトリ量を削減するために下げてください。OpenTelemetry SDK 属性制限 `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` またはそのログレコードおよびスパンバリアントがより低い値に設定されている場合、Claude Code はその小さい値で切り詰めるため、`[TRUNCATED ...]` マーカーは SDK 制限内に留まります。Claude Code v2.1.214 以降が必要です | `262144` |128| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツ制限: モデルレスポンス、ツールコンテンツ、システムプロンプト、生 API ボディなどのコンテンツを含む属性の最大長 (UTF-16 コード単位、デフォルト: 61440、つまり 60 KB)。デフォルトは 64 KB で属性値をキャップするバックエンド向けにサイズ設定されています。バックエンドがより大きな値を受け入れる場合はそれを上げるか、テレメトリ量を削減するために下げてください。OpenTelemetry SDK 属性制限 `OTEL_ATTRIBUTE_VALUE_LENGTH_LIMIT` またはそのログレコードおよびスパンバリアントがより低い値に設定されている場合、Claude Code はその小さい値で切り詰めるため、`[TRUNCATED ...]` マーカーは SDK 制限内に留まります。Claude Code v2.1.214 以降が必要です | `262144` |

241| `workflow.run_id` | このエージェントを生成した [Workflow](/docs/ja/workflows) ツール実行の実行識別子。`wf_` で始まります。ワークフローによって生成されていないエージェントでは存在しません | |242| `workflow.run_id` | このエージェントを生成した [Workflow](/docs/ja/workflows) ツール実行の実行識別子。`wf_` で始まります。ワークフローによって生成されていないエージェントでは存在しません | |

245| `effort` | [リクエストに適用される努力レベル](/docs/ja/model-config#adjust-effort-level): `low`、`medium`、`high`、`xhigh`、または `max`。Claude Code が努力レベルを送信しない場合は存在しません。例えば、努力をサポートしていないモデルの場合。Claude Code v2.1.274 以降が必要です | |

385echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"387echo "{\"Authorization\": \"Bearer $(get-token.sh)\", \"X-API-Key\": \"$(get-api-key.sh)\"}"

386```388```

387 389

388ヘルパーが失敗するか、これらの要件を満たさない出力を出力する場合、Claude Code は以下のエラーを報告します:390ヘルパーが失敗するか、これらの要件を満たさない出力を出力する場合、エクスポートは失敗し、ヘルパーが再び機能するまで、セッションからテレメトリバックエンドは何も受け取りません。Claude Code は以下の場所で失敗を報告します:

389 391

392* 対話型セッションの警告通知。[`otelHeadersHelper failed; telemetry is not being exported`](/docs/ja/errors#otelheadershelper-failed)。ヘルパーが最初に失敗したときにセッションごとに 1 回表示されます

390* `/status` 出力393* `/status` 出力

391* [`--debug`](/docs/ja/cli-reference#cli-flags) で実行するか、セッション内で `/debug` を実行した後のデバッグログ394* [`--debug`](/docs/ja/cli-reference#cli-flags) で実行するか、セッション内で `/debug` を実行した後のデバッグログ

392* stderr、`-p` で開始された非対話型セッション内395* stderr、`-p` で開始された非対話型セッション内

709ユーザーがプロンプトを送信すると、Claude Code は複数の API 呼び出しを行い、いくつかのツールを実行する可能性があります。`prompt.id` 属性を使用すると、これらすべてのイベントを、それらをトリガーした単一のプロンプトに結び付けることができます。712ユーザーがプロンプトを送信すると、Claude Code は複数の API 呼び出しを行い、いくつかのツールを実行する可能性があります。`prompt.id` 属性を使用すると、これらすべてのイベントを、それらをトリガーした単一のプロンプトに結び付けることができます。

710 713

711| 属性 | 説明 |714| 属性 | 説明 |

712| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |715| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

715| `message.uuid` | セッショントランスクリプト（`~/.claude/projects/*/*.jsonl` ファイル）に保持されるメッセージの UUID。`assistant_response` に存在し、コマンドディスパッチを除く `user_prompt` に存在します。コマンドディスパッチはゼロまたは多くのメッセージを生成できます。`assistant_response` では、これは応答の最終トランスクリプトエントリであり、次のターンの `parentUuid` がこれからチェーンされます。Claude Code v2.1.214 以降が必要 |718| `message.uuid` | セッショントランスクリプト（`~/.claude/projects/*/*.jsonl` ファイル）に保持されるメッセージの UUID。`assistant_response`、`api_response_body` に存在し、コマンドディスパッチを除く `user_prompt` に存在します。コマンドディスパッチはゼロまたは多くのメッセージを生成できます。`assistant_response` および `api_response_body` では、これは応答の最終トランスクリプトエントリであり、次のターンの `parentUuid` がこれからチェーンされます。Claude Code v2.1.214 以降が必要。または `api_response_body` では v2.1.274 以降 |

716| `client_request_id` | `x-client-request-id` リクエストヘッダーとして送信されるクライアント生成 UUID。ファーストパーティ API 接続の `api_request` および `api_error` に存在します。サードパーティプロバイダーバックエンドおよびリクエストが非ストリーミングフォールバック経由で再試行された場合は存在しません。リクエストをその応答とペアリングし、サーバー `request_id` を生成しなかったタイムアウトなどの障害に対して利用可能なままです。`llm_request` トレーススパンの同じ属性と一致します。Claude Code v2.1.214 以降が必要 |719| `client_request_id` | `x-client-request-id` リクエストヘッダーとして送信されるクライアント生成 UUID。ファーストパーティ API 接続の `api_request` および `api_error` に存在します。サードパーティプロバイダーバックエンドおよびリクエストが非ストリーミングフォールバック経由で再試行された場合は存在しません。リクエストをその応答とペアリングし、サーバー `request_id` を生成しなかったタイムアウトなどの障害に対して利用可能なままです。`llm_request` トレーススパンの同じ属性と一致します。Claude Code v2.1.214 以降が必要 |

717 720

718単一のプロンプトによってトリガーされたすべてのアクティビティをトレースするには、特定の `prompt.id` 値でイベントをフィルタリングします。これにより、user\_prompt イベント、すべての api\_request イベント、およびそのプロンプト処理中に発生したすべての tool\_result イベントが返されます。721単一のプロンプトによってトリガーされたすべてのアクティビティをトレースするには、特定の `prompt.id` 値でイベントをフィルタリングします。これにより、user\_prompt イベント、すべての api\_request イベント、およびそのプロンプト処理中に発生したすべての tool\_result イベントが返されます。

721 724

722メッセージレベルの再構成の場合、各イベントクラスはセッショントランスクリプトのフィールドと一致するキーを持ちます。トランスクリプトエントリ形式は [Claude Code に内部的](/docs/ja/sessions#where-transcripts-are-stored) であり、バージョン間で変わるため、これらのフィールドで結合するパイプラインはリリースで破損する可能性があります。結合を安定した契約ではなくバージョン固有として扱います。725メッセージレベルの再構成の場合、各イベントクラスはセッショントランスクリプトのフィールドと一致するキーを持ちます。トランスクリプトエントリ形式は [Claude Code に内部的](/docs/ja/sessions#where-transcripts-are-stored) であり、バージョン間で変わるため、これらのフィールドで結合するパイプラインはリリースで破損する可能性があります。結合を安定した契約ではなくバージョン固有として扱います。

723 726

724* `message.uuid` on `user_prompt` and `assistant_response`727* `message.uuid` on `user_prompt`、`assistant_response`、および `api_response_body`

725* `request_id` on the API events, persisted as `requestId` on the transcript's assistant entries728* `request_id` on the API events、persisted as `requestId` on the transcript's assistant entries

726* `tool_use_id` on `tool_result` and `tool_decision` events729* `tool_use_id` on `tool_result` and `tool_decision` events

727 730

728<h4 id="user-prompt-event">731<h4 id="user-prompt-event">

1342* `files_past_cutoff`: 保持期間より古いファイル。スイープが削除に失敗。例えば、権限エラーまたは開いているファイルのため。ゼロ以上の値は、ファイルが設定された保持期間を超えたことを意味します。ゼロは、ディレクトリ削除全体の失敗が代わりに `error_count` にカウントされるため、何もしなかったことの証明ではありません1345* `files_past_cutoff`: 保持期間より古いファイル。スイープが削除に失敗。例えば、権限エラーまたは開いているファイルのため。ゼロ以上の値は、ファイルが設定された保持期間を超えたことを意味します。ゼロは、ディレクトリ削除全体の失敗が代わりに `error_count` にカウントされるため、何もしなかったことの証明ではありません

1343* `error_count`: スイープがファイルをリストまたは削除しながら遭遇したエラーの数1346* `error_count`: スイープがファイルをリストまたは削除しながら遭遇したエラーの数

1344 1347

1348<h4 id="managed-settings-resolved-event">

1349 管理設定解決イベント

1350</h4>

1351

1352セッションが解決した [管理設定](/docs/ja/managed-settings): セッション開始時に 1 回、セッション中に管理設定または [ポリシーヘルパー](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program) の状態が変わるときに再度、Claude Code がセッションを開始することを拒否するか、`error.type` 属性がリストする理由の 1 つでセッションを終了するときに。

1353このイベントを使用して、予期しない管理ソースで実行されているマシン、ポリシーヘルパーが失敗しているマシン、マシンが開始を拒否した理由を見つけます。

1354Claude Code v2.1.274 以降が必要です。

1355

1356デフォルトでは、イベントは管理ソースとポリシーヘルパーの状態を持ちますが、設定自体は持ちません。リダクションされた `managed_settings.settings` 属性と `managed_settings.resolved_sha256` ダイジェストを追加するには、`OTEL_LOG_MANAGED_SETTINGS=1` を設定します。

1357

1358* 管理設定、ユーザー設定、または `--settings` の `env` ブロック、または Claude Code を起動する環境で設定します。プロジェクトまたはローカル設定の値は有効にしません。クローンされたリポジトリはそれらを書き込むことができるため。

1359* サーバー管理設定は、変数が組織が既に受け取るイベントに組織自体のリダクションされたポリシーのみを追加するため、[セキュリティ承認ダイアログ](/docs/ja/server-managed-settings#security-approval-dialogs) を表示せずに設定できます。

1360

1361信頼していないフォルダ内のインタラクティブセッションでは、Claude Code は拒否イベントをエクスポートしません。プロジェクトおよびローカル設定はエクスポートを別のコレクターにポイントできるため、[信頼](/docs/ja/permissions#what-runs-before-you-trust-a-folder) する前に。

1362

1363**イベント名**: `claude_code.managed_settings_resolved`

1364

1365**属性**:

1366

1367* すべての [標準属性](#standard-attributes)

1368* `event.name`: `"managed_settings_resolved"`

1369* `event.timestamp`: ISO 8601 タイムスタンプ

1370* `event.sequence`: イベント順序付けのためのプロセスごとのカウンター。[イベント相関属性](#event-correlation-attributes) で説明

1371* `managed_settings.trigger`: セッション開始イベントの場合は `"startup"`、セッション中に管理設定またはポリシーヘルパーの状態が変わった場合は `"change"`、管理設定ポリシーがセッションを停止した場合は `"refused"`。Claude Code は、属性が前のイベントから異なる場合のみ `change` イベントを送信し、変更された設定値は `OTEL_LOG_MANAGED_SETTINGS` がオフの場合でもカウントされます

1372* `error.type`: Claude Code がセッションを停止した理由。`refused` イベントにのみ存在:

1373 * `"helper_failed"`: [ポリシーヘルパー実行が失敗](/docs/ja/settings-reference#helper-failures)

1374 * `"policy_invalid"`: 管理設定にエラーが含まれており、Claude Code が開始できない、またはアドミンソースが読み込めないため、Claude Code は組織ログイン強制をチェックできません

1375 * `"consent_rejected"`: ユーザーがサーバー管理設定の [セキュリティ承認ダイアログ](/docs/ja/server-managed-settings#security-approval-dialogs) を拒否しました

1376 * `"force_refresh_failed"`: [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh) が必要とする設定フェッチが失敗しました

1377 * `"gateway_rejected"`: [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway) が管理設定ロードに HTTP 403 で応答しました

1378 * `"version_below_minimum"`: この Claude Code バージョンは [`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion) より下、または [`requiredMaximumVersion`](/docs/ja/settings-reference#requiredmaximumversion) より上です

1379 * `"_OTHER"`: Claude アプリゲートウェイ管理設定ロードが別の理由で失敗しました

1380* `managed_settings.sources`: [ポリシーキー](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) を少なくとも 1 つ配信するすべての管理ソース。優先度が最も高い順。`first-wins` の下で効果を持たないソースを含む。値は `"remote"`、`"plist"` または `"hklm"` は MDM または OS レベルのポリシー、`"file"` は管理設定ファイルおよびドロップイン、`"parent"` は [埋め込みホスト](/docs/ja/managed-settings#let-an-embedding-host-add-policy) が設定を提供する場合、`"hkcu"` は Claude Code が [読み取る](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) 場合の [Windows HKCU レジストリ値](/docs/ja/managed-settings#where-each-mechanism-stores-the-policy)。ポリシーキーのみを持つソース、または Claude Code が読み取れなかったソースはリストされていません。文字列の配列として発行。管理ソースがポリシーキーを配信しない場合は空

1381* `managed_settings.source_behavior`: Claude Code が読み取った [`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) 値。`"first-wins"` または `"merge"`。キーが設定されていない場合は `"first-wins"`

1382* `managed_settings.helper.state`: 選択された MDM またはファイルソースが設定するポリシーヘルパーの状態:

1383 * `"ok"`: ヘルパーの出力が管理設定として機能

1384 * `"bad_path"`、`"not_a_file"`、`"exit_nonzero"`、`"timed_out"`、`"oversize"`、`"parse_failed"`、`"envelope_invalid"`、または `"schema_rejected"`: ヘルパーの最後の実行が失敗。[ヘルパー障害](/docs/ja/settings-reference#helper-failures) はケースを説明

1385 * `"none"`: ヘルパーが設定されていない、またはそれを設定するソースが MDM ポリシーまたは管理設定ファイルではない

1386* `managed_settings.helper.applied`: ヘルパーの独自の出力が管理設定として機能する場合は `"output"`。そうでない場合は `"none"`

1387* `managed_settings.helper.entry`: Claude Code が [`policyHelper`](/docs/ja/settings-reference#policyhelper) を選択した場合は `"policyHelper"`。ヘルパーを選択しなかった場合は存在しません

1388* `managed_settings.helper.path`: ヘルパーの設定された [`path`](/docs/ja/settings-reference#policyhelper-path)。Claude Code がヘルパーを選択したときはいつでも存在。`OTEL_LOG_MANAGED_SETTINGS` が設定されているかどうかに関わらず

1389* `managed_settings.resolved_sha256`（`OTEL_LOG_MANAGED_SETTINGS=1` の場合）: リダクション前の解決された管理設定の SHA-256。JSON としてシリアル化。キーは再帰的にソートされ、空白なし。同じダイジェストを持つマシンは同じポリシーを実行します。Claude Code は短いポリシーを推測をハッシュすることで回復できるため、オプトインでのみダイジェストを送信します。管理設定が解決されない場合は存在しません。`refused` イベントでは存在しません

1390* `managed_settings.settings`（`OTEL_LOG_MANAGED_SETTINGS=1` の場合）: 解決された管理設定の名前と形状。値はリダクションされます。JSON 文字列として。`refused` イベントでは存在しません。Claude Code はその設定スキーマから構築します:

1391

1392 * スキーマが宣言する設定名はエクスポートされ、スキーマが宣言しないキーは除外されます

1393 * ブール値、数値、および文字列値。スキーマが `permissions.defaultMode` などの固定オプションセットに制限する場合、そのままエクスポートされます。`sandbox.network.httpProxyPort` および `sandbox.network.socksProxyPort` は `"[REDACTED]"` としてエクスポートされます

1394 * その他のすべての文字列。`model`、`apiKeyHelper`、すべての `env` 値、すべての URL、およびすべてのコマンドは `"[REDACTED]"` としてエクスポートされます

1395 * マップのエントリ名。`env` 変数名およびプラグイン ID はそのままエクスポートされます。スキーマが入力をタイプしない設定。`vimInsertModeRemaps` などは単一の `"[REDACTED]"` としてエクスポートされ、`sandbox.ignoreViolations` はコマンドパターンなしでそのパスリストのリストとしてエクスポートされます

1396 * リストはその長さを保持し、各エントリは同じルールでリダクションされます

1397 * `permissions.allow`、`permissions.deny`、または `permissions.ask` ルールは、ツール名がこのバージョンの Claude Code に組み込まれている場合、またはそのツール名がリダクションされたコンテンツを持つ `mcp__` 参照（`mcp__jira__create_issue` など）である場合、そのツール名としてエクスポートされます。その他のルールは `"[REDACTED]"` としてエクスポートされます

1398 * フックは同じルールに従うため、`type` および `timeout` などの固定オプションおよび数値フィールドが表示されます。各コマンド、URL、`matcher`、および `if` 条件は `"[REDACTED]"` としてエクスポートされます

1399

1400 例えば、`apiKeyHelper`、2 つの `env` 変数、および拒否ルールを持つ管理設定は `{"apiKeyHelper":"[REDACTED]","env":{"HTTPS_PROXY":"[REDACTED]","CLAUDE_CODE_ENABLE_TELEMETRY":"[REDACTED]"},"permissions":{"deny":["Read([REDACTED])"]}}` としてエクスポートされます。

1401

1402 Claude Code は値を 8 KB の UTF-8 で切り詰め、切り詰められた値は有効な JSON ではありません

1403* `managed_settings.settings_truncated`（`managed_settings.settings` が存在する場合）: Claude Code が `managed_settings.settings` を 8 KB で切り詰めた場合は `true`。それ以外の場合は `false`。ブール値として発行。文字列ではなく

1404

1345<h2 id="interpret-metrics-and-events-data">1405<h2 id="interpret-metrics-and-events-data">

1346 メトリクスとイベントデータの解釈1406 メトリクスとイベントデータの解釈

1347</h2>1407</h2>

1461検出ルールを構築する場合、監視したいシグナルを検索し、対応するイベントと属性についてバックエンドをクエリします：1521検出ルールを構築する場合、監視したいシグナルを検索し、対応するイベントと属性についてバックエンドをクエリします：

1462 1522

1464| ----------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------- |1524| -------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1532| マシンが実行する管理設定ソース、そのポリシーヘルパーが正常かどうか、およびマシンが起動を拒否した理由 | `managed_settings_resolved` | `managed_settings.trigger`、`managed_settings.sources`、`managed_settings.source_behavior`、`managed_settings.helper.state`、`error.type`；`managed_settings.settings` および `managed_settings.resolved_sha256`（`OTEL_LOG_MANAGED_SETTINGS=1` の場合） |

1472 1533

1473Claude Code は生のイベントストリームのみを出力します。異常検出、ベースライン化、セッション間の相関、アラートは SIEM または可観測性バックエンドの責任です。1534Claude Code は生のイベントストリームのみを出力します。異常検出、ベースライン化、セッション間の相関、アラートは SIEM または可観測性バックエンドの責任です。

1474 1535

network-config.md +1 −0

Details

245| `registry.npmjs.org` | プラグインインストール（npm ソースプラグインパッケージの取得とプラグインの Node.js パッケージ依存関係のインストール）、`npx` で起動された MCP サーバー、および Claude Code 自体の npm と bun インストール用パッケージレジストリ |245| `registry.npmjs.org` | プラグインインストール（npm ソースプラグインパッケージの取得とプラグインの Node.js パッケージ依存関係のインストール）、`npx` で起動された MCP サーバー、および Claude Code 自体の npm と bun インストール用パッケージレジストリ |

247| `*.frame.claudeusercontent.com` | [Artifact](/docs/ja/artifacts) コンテンツ読み取り。CLI は Claude がアーティファクトを開いたときにこのホストからアーティファクトのファイルを取得し、Artifact ツールがアカウントで[利用可能](/docs/ja/artifacts#availability)な場合のみです。ツールをオフにしてこの要件を削除するには、[`"enableArtifact": false`](/docs/ja/settings-reference#enableartifact) または [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/ja/env-vars) を設定してください。Claude Code は非推奨の [`disableArtifact`](/docs/ja/settings-reference#disableartifact) 設定も尊重します。これらの設定がどのように相互作用するかについては、[アーティファクトを無効にする](/docs/ja/artifacts#disable-artifacts)を参照してください |247| `*.frame.claudeusercontent.com` | [Artifact](/docs/ja/artifacts) コンテンツ読み取り。CLI は Claude がアーティファクトを開いたときにこのホストからアーティファクトのファイルを取得し、Artifact ツールがアカウントで[利用可能](/docs/ja/artifacts#availability)な場合のみです。ツールをオフにしてこの要件を削除するには、[`"enableArtifact": false`](/docs/ja/settings-reference#enableartifact) または [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/ja/env-vars) を設定してください。Claude Code は非推奨の [`disableArtifact`](/docs/ja/settings-reference#disableartifact) 設定も尊重します。これらの設定がどのように相互作用するかについては、[アーティファクトを無効にする](/docs/ja/artifacts#disable-artifacts)を参照してください |

248| `github.com` | GitHub ホスト型[プラグインマーケットプレイス](/docs/ja/plugin-marketplaces)とプラグインのクローン（公式 Anthropic マーケットプレイスを含む）。HTTPS または SSH 経由。GitHub `owner/repo` ソースを HTTPS のみでクローンするには、[`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ja/env-vars) を設定してください |

248| `raw.githubusercontent.com` | [`/release-notes`](/docs/ja/commands) のチェンジログフィード。対話型セッションでは、Claude Code はキャッシュされたチェンジログがまだ実行中のバージョンをカバーしていない場合（更新後の初回起動など）、スタートアップ時にバックグラウンドでそれを取得します。非対話型およびクラウドセッションは決してそれを取得しません |249| `raw.githubusercontent.com` | [`/release-notes`](/docs/ja/commands) のチェンジログフィード。対話型セッションでは、Claude Code はキャッシュされたチェンジログがまだ実行中のバージョンをカバーしていない場合（更新後の初回起動など）、スタートアップ時にバックグラウンドでそれを取得します。非対話型およびクラウドセッションは決してそれを取得しません |

249| `*-review.googlesource.com` | `googlesource.com` チェックアウトでの Gerrit 変更検索。Claude Desktop Code タブセッションが [信頼済み](/docs/ja/permissions#project-allow-rules-and-workspace-trust)チェックアウトで開始または再開され、その `origin` が `googlesource.com` ホストである場合、Claude Code はそのホストの `-review` サーバーに匿名で、HEAD の `Change-Id` に一致するオープン変更を 1 回（開始または再開ごと）要求します。他のセッションタイプはこの検索をスキップし、他の Gerrit ホストには接続されません。オプション：[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) で無効化 |250| `*-review.googlesource.com` | `googlesource.com` チェックアウトでの Gerrit 変更検索。Claude Desktop Code タブセッションが [信頼済み](/docs/ja/permissions#project-allow-rules-and-workspace-trust)チェックアウトで開始または再開され、その `origin` が `googlesource.com` ホストである場合、Claude Code はそのホストの `-review` サーバーに匿名で、HEAD の `Change-Id` に一致するオープン変更を 1 回（開始または再開ごと）要求します。他のセッションタイプはこの検索をスキップし、他の Gerrit ホストには接続されません。オプション：[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) で無効化 |

250| `http-intake.logs.us5.datadoghq.com` | 運用テレメトリイベント。CLI が Anthropic API を直接使用する場合にのみ送信され、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では送信されません。オプション：[`DISABLE_TELEMETRY`](/docs/ja/data-usage#telemetry-services) または `DO_NOT_TRACK` で無効化 |251| `http-intake.logs.us5.datadoghq.com` | 運用テレメトリイベント。CLI が Anthropic API を直接使用する場合にのみ送信され、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では送信されません。オプション：[`DISABLE_TELEMETRY`](/docs/ja/data-usage#telemetry-services) または `DO_NOT_TRACK` で無効化 |

output-styles.md +124 −42

Details

4 4

5# 出力スタイル5# 出力スタイル

6 6

~~7> ソフトウェアエンジニアリング以外の用途に合わせて Claude Code を適応させる~~7> Concise や Explanatory などの組み込み出力スタイルを使用するか、カスタムスタイルを作成して、Claude Code のロール、トーン、応答形式を変更します。

8 8

9出力スタイルは Claude がどのように応答するかを変更し、Claude が何を知っているかは変更しません。これらはすべての応答に対して Claude のロール、トーン、出力形式を設定します。毎回同じ声や形式で再度プロンプトを入力し続ける場合、または Claude がソフトウェアエンジニア以外として機能することを望む場合に使用します。9出力スタイルは、セッション内のすべての応答に対して Claude のロール、トーン、応答形式を設定する一連の指示です。Claude Code には、デフォルトの他に 4 つの組み込みスタイルが含まれており、独自のスタイルを作成することもできます。

10 10

11カスタム出力スタイルは Claude に独自の指示を提供し、Claude Code の組み込みソフトウェアエンジニアリング指示を保持するかどうかを選択できます。Claude がコミュニケーション方法を変更しているがまだコーディングしている場合（常に図で答えるなど）は保持します。Claude がソフトウェアエンジニアリングをまったく行っていない場合（執筆アシスタントやデータアナリストなど）は除外します。11出力スタイルを使用すると、セッション全体で Claude がどのように応答し、あなたと協力するかを変更できるため、各プロンプトでリクエストを繰り返す必要がありません。たとえば、組み込みスタイルは応答をより短くしたり、各変更の説明を追加したり、Claude が定型的な質問をせずに作業を開始したりできます。カスタムスタイルは、Claude をソフトウェアエンジニア以外のもの（ライティングアシスタントやデータアナリストなど）に変えることもできます。

12 12

~~13プロジェクト、規約、またはコードベースに関する指示については、代わりに [CLAUDE.md](/docs/ja/memory) を使用してください。~~13* 組み込みスタイルを使用するには、[組み込み出力スタイル](#built-in-output-styles)から 1 つを選択して、[それに切り替えます](#change-your-output-style)。

14* 独自の指示を作成するには、[カスタム出力スタイルを作成します](#create-a-custom-output-style)。

16<Note>

17 出力スタイルは Claude に従うべき指示を与えます。何かが常に起こることや決して起こらないことを保証するものではありません。一部のニーズは異なる機能に適しています。

19 * Claude がプロジェクトについて知っておくべきことについては、[CLAUDE.md](/docs/ja/memory) を使用します。

20 * 各編集後のフォーマットやコマンドのブロックなど、毎回必ず起こる必要があることについては、[フック](/docs/ja/hooks-guide)を使用します。

21 * スキル、サブエージェント、その他のオプションについては、[出力スタイルと他の機能の選択](#choose-between-an-output-style-and-other-features)を参照してください。

22</Note>

14 23

15<h2 id="built-in-output-styles">24<h2 id="built-in-output-styles">

16 組み込み出力スタイル25 組み込み出力スタイル

17</h2>26</h2>

18 27

19Claude Code の **Default** 出力スタイルは標準的な指示セットであり、ソフトウェアエンジニアリングタスクを効率的に完了するのに役立つように設計されています。28Claude Code は [**Default**](#default) スタイルで開始します。これはソフトウェアエンジニアリングタスクを完了するための標準的な指示です。他の 4 つの組み込みスタイルはこれらの指示を保持し、独自の指示を追加します。

30このテーブルは各スタイルがセッションについて何を変更するか、そしていつそれが適切かを示しています。

32| スタイル | 変更内容 | 使用する場合 |

33| :-------------------------- | :---------------------------------------------------- | :----------------------------------------------- |

34| [Proactive](#proactive) | Claude は即座に作業を開始し、日常的な決定について質問する代わりに合理的な仮定を立てます | Claude に日常的な決定を通じて作業を続けさせたい場合、仮定が間違っていれば方向を修正します |

35| [Concise](#concise) | レスポンスは結果で始まり、前置き、説明、および要約を省略します | デフォルトのレスポンスが想定より長い場合 |

36| [Explanatory](#explanatory) | Claude は、記述したコードの背後にある選択肢を説明する短い `Insight` ブロックを追加します | コードベースを学習中、または変更と一緒に推論を望む場合 |

37| [Learning](#learning) | Claude は選択肢を説明し、自分で記述するための小さなコード片を残します | タスクがまだ完了している間、実践的なコーディング練習を望む場合 |

39<h3 id="default">

40 Default

41</h3>

43Default は出力スタイルが選択されていないことを意味します。Claude Code はスタイル指示を追加せず、Claude は Claude Code の標準システムプロンプトから動作します。これはソフトウェアエンジニアリングタスク用に記述されています。

45`default` は他のスタイルと共に `/output-style` リストに表示されるため、[同じ方法で選択](#change-your-output-style)します。

47<h3 id="proactive">

48 Proactive

49</h3>

51Proactive スタイルでは、Claude はタスクを送信するとすぐに実装を開始します。日常的な決定について合理的な仮定を立て、質問するために停止することはなく、計画を求めない限り計画モードに切り替わりません。任意の時点でそれをリダイレクトできます。

53スタイルの指示は、データを削除するか、共有またはプロダクションシステムを変更するアクションの前に、Claude がカンバセーション内でユーザーに確認するよう指示します。その確認は Claude が従う指示であり、権限プロンプトとは別です。

55Proactive スタイルに切り替えても、[権限モード](/docs/ja/permission-modes)は変わりません。権限モードは依然としてユーザーに尋ねずに実行するツール呼び出しを決定するため、権限プロンプトは切り替え前と同じ方法で表示されます。

57<h3 id="concise">

58 Concise

59</h3>

61Concise スタイルでは、レスポンスの最初の文が何が起こったか、または答えが何かを述べています。Claude は導入部、ステップバイステップの説明、および終了時の要約を省略し、簡単な質問に 1 ～ 3 文で答えます。Default スタイルと同じくらい徹底的にエンジニアリング作業を行います。Claude Code v2.1.237 以降が必要です。

63Claude は以下の場合でも完全な長さで記述します。

65* **ユーザーが求めるもの**: 説明または詳細情報を求めると、Claude は完全に答えます。

66* **安全に行動するために必要なもの**: エラーレポート、失敗したテスト出力、セキュリティ警告、および破壊的なアクションの確認は完全な内容を保持します。

68<h3 id="explanatory">

69 Explanatory

70</h3>

72Explanatory スタイルでは、Claude は Default スタイルと同じ方法でタスクを実行し、立てた選択肢の理由についての短い説明を追加します。各説明はカンバセーションに表示され、それが関連するコードの前または後に、`Insight` というラベルの付いたブロックに表示されます。説明はファイルにコメントとして記述されません。

20 73

~~214 つの追加の組み込み出力スタイルがあります。~~74`Insight` ブロックは、コードベースまたは Claude が記述したコードについて 2 ～ 3 つのポイントを含みます。例えば、API エンドポイントを追加した後のこのようなものです。

22 75

23* **Proactive**: Claude は即座に実行し、日常的な決定で一時停止する代わりに合理的な仮定を立て、計画よりもアクションを優先します。これは [オートモード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) が適用するより強力な自律実行ガイダンスであり、権限モードを変更せずに機能するため、権限モードは依然として何が実行されるかを決定し、確認を求めません。76```text theme={null}

77★ Insight ─────────────────────────────────────

78- このリポジトリのすべてのルートは withAuth ラッパーを通過するため、新しいエンドポイントは独自のミドルウェアなしでセッションチェックを取得します。

79- レート制限は limits.ts でルートごとに設定されるため、この変更はグローバルデフォルトではなく、そこにエントリを追加します。

80─────────────────────────────────────────────────

81```

83<h3 id="learning">

84 Learning

85</h3>

24 86

25* **Concise**: Claude は結果を最初に示し、前置きと説明をスキップし、デフォルトスタイルと同じくらい徹底的にエンジニアリング作業を行いながら、デフォルトでは応答を短く保ちます。説明や詳細情報を求めると、Claude は完全に答えます。Claude は常にエラーレポート、セキュリティ警告、および破壊的なアクションの確認の完全な内容を保持します。Claude Code v2.1.237 以降が必要です。87Learning スタイルでは、Claude は [Explanatory スタイル](#explanatory)と同じ `Insight` ブロックを追加し、ユーザーにコードの一部を記述するよう求めます。Claude は日常的な実装を自分で処理します。エラーハンドリング、データ構造、または複数の有効なアプローチを持つビジネスロジックなど、実際の設計決定を伴う部分に到達すると、ユーザーのために数行を残します。

26 88

27* **Explanatory**: ソフトウェアエンジニアリングタスクの完了を支援しながら、教育的な「Insights」を提供します。実装の選択肢とコードベースのパターンを理解するのに役立ちます。89Claude は `TODO(human)` コメントでファイル内の場所をマークし、既に構築されたもの、記述するもの、および検討すべきことを述べるリクエストを送信します。

28 90

29* **Learning**: 協調的な学習型モードです。Claude はコーディング中に「Insights」を共有するだけでなく、小さな戦略的なコードの一部を自分で実装するよう求めます。Claude Code はコード内に `TODO(human)` マーカーを追加して、実装するべき箇所を示します。91```text theme={null}

92● Learn by Doing

94Context: アップロードフォームが配置され、ファイルを受け入れる前に validateFile() を呼び出します。サイズとタイプのチェックは画像に対して機能しますが、switch ステートメントにはドキュメントの処理がまだありません。

96Your Task: upload.js で、validateFile() 内の case "document" ブランチを実装します。TODO(human) を探します。

98Guidance: ドキュメントのサイズ制限を決定し、ファイル拡張子が MIME タイプと一致する必要があるかどうかを決定します。{valid: boolean, error?: string} を返します。

99```

100

101Claude はその後停止し、待機します。`TODO(human)` コメントでコードを記述し、完了したことを Claude に伝えます。Claude はユーザーのコードについて 1 つの `Insight` で応答し、タスクを続行します。

30 102

31<h2 id="change-your-output-style">103<h2 id="change-your-output-style">

32 出力スタイルを変更する104 出力スタイルを変更する

33</h2>105</h2>

34 106

~~35以下のいずれかの方法でスタイルを選択します。~~107コマンド、メニュー、または設定ファイルでスタイルを選択します。コマンドと両方のメニューは、選択内容を [ローカルプロジェクトレベル](/docs/ja/settings) の `.claude/settings.local.json` に保存します。

36 108

37* **`/output-style` コマンド**: `/output-style <style>` を実行してスタイルを切り替えます。例えば `/output-style concise` のように使用します。引数なしで実行すると、選択可能なスタイルが一覧表示され、現在のスタイルがマークされます。Claude Code は選択内容を [ローカルプロジェクトレベル](/docs/ja/settings) の `.claude/settings.local.json` に保存します。109* **`/output-style` コマンド**: `/output-style <style>` を実行してスタイルを切り替えます。例えば `/output-style concise` のように使用します。引数なしで実行すると、選択可能なスタイルが一覧表示され、現在のスタイルがマークされます。

38 110

39 このコマンドは [非対話型モード](/docs/ja/headless) と Agent SDK セッション、およびモバイルアプリまたは Web から [リモートコントロール](/docs/ja/remote-control#limitations) 経由でも機能します。この場合、[組み込みスタイル](#built-in-output-styles) のみをリストして選択できます。Claude Code v2.1.269 以降が必要です。111 このコマンドは [非対話型モード](/docs/ja/headless) と Agent SDK セッション、およびモバイルアプリまたは Web から [リモートコントロール](/docs/ja/remote-control#limitations) 経由でも機能します。この場合、[組み込みスタイル](#built-in-output-styles) のみをリストして選択できます。Claude Code v2.1.269 以降が必要です。

40* **Terminal**: `/config` を実行し、**Output style** を選択してメニューからスタイルを選択します。Claude Code は選択内容を [ローカルプロジェクトレベル](/docs/ja/settings) の `.claude/settings.local.json` に保存します。112* **Terminal メニュー**: `/config` を実行し、**Output style** を選択してメニューからスタイルを選択します。

41* **VS Code extension**: [コマンドメニュー](/docs/ja/vs-code#use-the-prompt-box) を `/` で開き、**Output styles** を選択してスタイルを選択します。カスタムスタイルも含まれます。Claude Code は選択内容を `.claude/settings.local.json` に保存します。これはターミナルメニューが書き込むのと同じファイルです。Claude Code v2.1.257 以降が必要です。113* **VS Code extension**: [コマンドメニュー](/docs/ja/vs-code#use-the-prompt-box) を `/` で開き、**Output styles** を選択してスタイルを選択します。カスタムスタイルも含まれます。Claude Code v2.1.257 以降が必要です。

42* **Desktop app**: 設定ファイル（例えば `.claude/settings.local.json`、ターミナルメニューが書き込むファイル）の `outputStyle` フィールドを設定します。`/config` を実行すると、Claude Code は [**Settings > Claude Code**](/docs/ja/desktop#what%E2%80%99s-not-available-in-desktop) を開きます。メニューではなく設定画面が開きます。114* **Desktop app**: 設定ファイル（例えば `.claude/settings.local.json`、ターミナルメニューが書き込むファイル）の `outputStyle` フィールドを設定します。`/config` を実行すると、Claude Code は [**Settings > Claude Code**](/docs/ja/desktop#what%E2%80%99s-not-available-in-desktop) を開きます。メニューではなく設定画面が開きます。

43 115

44メニューなしでスタイルを設定するには、設定ファイルの `outputStyle` フィールドを直接編集します。116メニューなしでスタイルを設定するには、設定ファイルの `outputStyle` フィールドを直接編集します。

49}121}

50```122```

51 123

124値は大文字と小文字を区別するため、組み込み名は `Proactive`、`Concise`、`Explanatory`、`Learning` と記述してください。`explanatory` のようにスタイル名と完全に一致しない値を指定すると、デフォルトスタイルが適用されます。`/output-style` コマンドは大文字と小文字を区別しません。

125

126プロジェクト全体でスタイルをデフォルトにするには、`~/.claude/settings.json` で `outputStyle` を設定します。プロジェクト独自の設定ファイルは [その値より優先されます](/docs/ja/settings#settings-precedence)。

127

52セッション中にスタイルを切り替えると、Claude は次のメッセージから新しいスタイルを使用します。最初のメッセージのプロンプトキャッシングのコストについては、[出力スタイルの変更](/docs/ja/prompt-caching#changing-output-style) を参照してください。v2.1.251 より前は、新しいスタイルは `/clear` を実行するか新しいセッションを開始した後にのみ適用されました。128セッション中にスタイルを切り替えると、Claude は次のメッセージから新しいスタイルを使用します。最初のメッセージのプロンプトキャッシングのコストについては、[出力スタイルの変更](/docs/ja/prompt-caching#changing-output-style) を参照してください。v2.1.251 より前は、新しいスタイルは `/clear` を実行するか新しいセッションを開始した後にのみ適用されました。

53 129

54<h2 id="create-a-custom-output-style">130<h2 id="create-a-custom-output-style">

98[プラグイン](/docs/ja/plugins-reference) は `output-styles/` ディレクトリで出力スタイルを配布することもできます。174[プラグイン](/docs/ja/plugins-reference) は `output-styles/` ディレクトリで出力スタイルを配布することもできます。

99 175

100<h3 id="frontmatter">176<h3 id="frontmatter">

101 Frontmatter177 Frontmatter リファレンス

102</h3>178</h3>

103 179

104出力スタイルファイルは、これらの frontmatter フィールドをサポートしています。180出力スタイルを YAML [frontmatter](/docs/ja/glossary#frontmatter) で設定します。ファイルの上部の `---` マーカーの間に記述します。すべてのフィールドはオプションであり、フィールド名はハイフンで区切られた小文字の単語を使用します。スペルが間違ったフィールドはエラーなしで無視されます。YAML が解析できない場合、スタイルはファイル名で読み込まれ、フィールドは設定されません。`claude --debug` を実行して解析エラーを確認してください。

105 181

106| Frontmatter | 目的 | デフォルト |182| フィールド | 必須 | 説明 |

107| :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------- | :-------- |183| :------------------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

109| `description` | `/config` ピッカーに表示される出力スタイルの説明 | なし |185| `description` | いいえ | 出力スタイルの説明。`/config` ピッカーに表示されます |

111| `force-for-plugin` | プラグイン出力スタイルのみ: プラグインが有効になるたびに、ユーザーが選択する必要なく、このスタイルを自動的に適用します。ユーザーの `outputStyle` 設定をオーバーライドします。複数の有効なプラグインがこれを設定する場合、Claude Code は最初に読み込まれたものを使用します。 | `false` |187| `force-for-plugin` | いいえ | プラグイン出力スタイルのみ。`true` に設定すると、プラグインが有効になるたびに、ユーザーが選択する必要なく、このスタイルを自動的に適用します。ユーザーの `outputStyle` 設定をオーバーライドします。複数の有効なプラグインがこれを設定する場合、Claude Code は最初に読み込まれたものを使用します。デフォルト: `false` |

112 188

113<h2 id="how-output-styles-work">189<span id="comparisons-to-related-features" />

114 出力スタイルの仕組み

115</h2>

116 190

117出力スタイルは Claude Code が Claude に与える指示を変更します。191<h2 id="choose-between-an-output-style-and-other-features">

192 出力スタイルと他の機能の選択

193</h2>

118 194

119* Claude Code はアクティブなスタイルの指示をすべてのリクエストで送信します。195出力スタイルはセッション内のすべての応答に適用されます。これは Claude が従う指示であるため、何も強制しません。必要なものがすべての応答より狭い範囲である場合、または確実に発生する必要がある場合は、別の機能がより適切です。

120* [Default 以外のスタイルを選択](#change-your-output-style)すると、Claude Code は会話中に Claude にそのスタイルを思い出させます。

121* カスタム出力スタイルは、`keep-coding-instructions` が `true` に設定されていない限り、スコープ変更の方法、コメントの書き方、作業の検証方法など、Claude Code の組み込みソフトウェアエンジニアリング指示を除外します。

122 196

123出力スタイルはメイン会話と [フォーク](/docs/ja/sub-agents#fork-the-current-conversation)に適用されます。フォークは親の完全な会話とシステムプロンプトを継承します。その他の [サブエージェントは独自のシステムプロンプトを実行](/docs/ja/sub-agents#what-loads-at-startup)するため、スタイルはそれらの応答方法を変更しません。197この表は、必要なものを、それを実現する機能に対応させています。

124 198

125トークン使用量はスタイルによって異なります。スタイルの指示はインプットトークンを追加しますが、プロンプトキャッシングはセッション内の最初のリクエスト後にこのコストを削減します。199| 必要なもの | 使用する機能 | 適切な理由 |

200| :---------------------------------------- | :---------------------------------------------------------------- | :----------------------------------------------------------- |

201| 特定の声、長さ、または形式のすべての応答、または異なるロールの Claude | 出力スタイル | セッション全体に適用され、1 つのコマンドでスタイルを切り替えることができます |

202| Claude がプロジェクトの規約、コマンド、および構造を知っている | [CLAUDE.md](/docs/ja/memory) | Claude が知るべきコードベースについての情報を保持し、選択したスタイルに関係なく読み込まれたままになります |

203| リリースチェックリストやレビュー手順など、1 種類のタスクの指示 | [skill](/docs/ja/skills) | Claude はそれを呼び出すか、タスクが一致する場合にのみ読み込むため、関連のない応答を形成しません |

204| 各編集後のフォーマットやコマンドのブロックなど、例外なく毎回発生する必要があるもの | [hook](/docs/ja/hooks-guide) | Claude Code はライフサイクルイベントでフック自体を実行するため、Claude が指示に従うことに依存しません |

205| 焦点を絞ったタスク用に独自の指示、モデル、およびツールを備えたヘルパー | [subagent](/docs/ja/sub-agents) | 独自のシステムプロンプトを備えた別のコンテキストで実行され、会話に概要を返します |

206| Claude Code を開始するときに渡す Claude の指示への追加 | [`--append-system-prompt`](/docs/ja/cli-reference#system-prompt-flags) | 何も削除せずにシステムプロンプトに追加します |

126 207

127組み込みの Explanatory および Learning スタイルは、設計上 Default よりも長い応答を生成するため、アウトプットトークンが増加します。Concise スタイルはその逆で、Claude にデフォルトで応答を短く保つよう指示することで、反対の効果を生み出します。カスタムスタイルの場合、アウトプットトークン使用量は、指示が Claude に生成させるものに依存します。208これらの機能は組み合わせることができます。たとえば、Claude が知るべきことに CLAUDE.md を使用し、応答方法に出力スタイルを使用し、保証する必要があるものに hook を使用できます。[Claude Code を拡張](/docs/ja/features-overview)すると、残りの拡張機能が比較されます。

128 209

129<h2 id="comparisons-to-related-features">210<h2 id="how-output-styles-work">

130 関連機能との比較211 出力スタイルの仕組み

131</h2>212</h2>

132 213

133Claude Code の動作をカスタマイズするいくつかの機能があります。出力スタイルは Claude Code のデフォルト指示を変更し、すべての応答に適用されます。その他は、デフォルトを変更せずに指示を追加するか、特定のタスクにスコープします。214出力スタイルは Claude Code が Claude に与える指示を変更します。

215

216* Claude Code はすべてのリクエストで有効なスタイルの指示を送信します。

217* カスタム出力スタイルは、`keep-coding-instructions` が `true` に設定されていない限り、変更のスコープ、コメントの書き方、作業の検証方法など、Claude Code の組み込みソフトウェアエンジニアリング指示を除外します。

218

219出力スタイルはメイン会話と [フォーク](/docs/ja/sub-agents#fork-the-current-conversation) に適用されます。フォークは親の完全な会話とシステムプロンプトを継承します。その他の [サブエージェントは独自のシステムプロンプトを実行](/docs/ja/sub-agents#what-loads-at-startup) するため、スタイルはそれらの応答方法を変更しません。

220

221トークン使用量はスタイルによって異なります。スタイルの指示は入力トークンを追加しますが、プロンプトキャッシングはセッション内の最初のリクエスト後にこのコストを削減します。

134 222

135| 機能 | 仕組み | 使用する場合 |223組み込みの Explanatory および Learning スタイルは、設計上 Default よりも長い応答を生成し、これは出力トークンを増加させます。Concise スタイルはその逆で、Claude にデフォルトで応答を短く保つよう指示することで反対の効果を生じます。カスタムスタイルの場合、出力トークン使用量は、指示が Claude に何を生成するよう指示するかによって異なります。

136| :----------------------- | :----------------------------------- | :------------------------------------------------------------------------- |

137| 出力スタイル | Claude Code のデフォルト指示を変更する | 毎回異なるロール、トーン、またはデフォルト応答形式が必要な場合 |

138| [CLAUDE.md](/docs/ja/memory) | システムプロンプトの後にユーザーメッセージを追加する | Claude がプロジェクト規約とコードベースコンテキストを常に知っている必要がある場合 |

139| `--append-system-prompt` | 何も削除せずにシステムプロンプトに追加する | [CLI フラグ](/docs/ja/cli-reference#system-prompt-flags)として起動時に渡される 1 回限りの追加が必要な場合 |

140| [エージェント](/docs/ja/sub-agents) | 独自のシステムプロンプト、モデル、ツールを持つサブエージェントを実行する | フォーカスされたタスク用に個別にスコープされたヘルパーが必要な場合 |

141| [スキル](/docs/ja/skills) | 呼び出されたときまたは関連する場合にタスク固有の指示を読み込む | 再利用可能なワークフローがある場合 |

142 224

143<h2 id="related-resources">225<h2 id="related-resources">

144 関連リソース226 関連リソース

overview.md +1 −0

Details

247* [クイックスタート](/docs/ja/quickstart)：コードベースの探索から修正のコミットまで、最初の実際のタスクを実行します247* [クイックスタート](/docs/ja/quickstart)：コードベースの探索から修正のコミットまで、最初の実際のタスクを実行します

248* [指示とメモリを保存する](/docs/ja/memory)：CLAUDE.md ファイルと自動メモリで Claude に永続的な指示を与えます248* [指示とメモリを保存する](/docs/ja/memory)：CLAUDE.md ファイルと自動メモリで Claude に永続的な指示を与えます

249* [一般的なワークフロー](/docs/ja/common-workflows) と [ベストプラクティス](/docs/ja/best-practices)：Claude Code から最大限の価値を得るためのパターン249* [一般的なワークフロー](/docs/ja/common-workflows) と [ベストプラクティス](/docs/ja/best-practices)：Claude Code から最大限の価値を得るためのパターン

250* [Claude Academy](https://academy.claude.com/)：無料の自習コース。[Claude Code 101](https://academy.claude.com/courses/claude-code-101) と [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action) を含みます

250* [すべてのタスクのためのハーネス](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code)：Claude Code チームが [動的ワークフロー](/docs/ja/workflows) を使用して大規模にサブエージェントを調整する方法251* [すべてのタスクのためのハーネス](https://claude.com/blog/a-harness-for-every-task-dynamic-workflows-in-claude-code)：Claude Code チームが [動的ワークフロー](/docs/ja/workflows) を使用して大規模にサブエージェントを調整する方法

251* [設定](/docs/ja/settings)：ワークフローに合わせて Claude Code をカスタマイズします252* [設定](/docs/ja/settings)：ワークフローに合わせて Claude Code をカスタマイズします

252* [トラブルシューティング](/docs/ja/troubleshooting)：一般的な問題の解決策253* [トラブルシューティング](/docs/ja/troubleshooting)：一般的な問題の解決策

permission-modes.md +44 −29

Details

246```246```

247 247

248<h2 id="analyze-before-you-edit-with-plan-mode">248<h2 id="analyze-before-you-edit-with-plan-mode">

249 計画モードで編集前に分析する249 プランモードで編集前に分析する

250</h2>250</h2>

251 251

252計画モードは Claude に変更を加えずに調査と提案を行うよう指示します。Claude はファイルを読み、シェルコマンドを実行して探索し、計画を書きますが、ソースを編集しません。[bypass permissions が利用可能](#skip-all-checks-with-bypasspermissions-mode)なインタラクティブターミナルセッションを除き、編集は計画を承認するまでブロックされたままです。252プランモードは Claude に変更を研究して提案するよう指示しますが、実際には変更を加えません。Claude はファイルを読み込み、シェルコマンドを実行して探索し、プランを作成しますが、ソースを編集しません。[bypass 権限が利用可能](#skip-all-checks-with-bypasspermissions-mode)なインタラクティブターミナルセッションを除き、編集はプランを承認するまでブロックされたままです。

253 253

254[auto モード](/docs/ja/auto-mode-config)が利用可能で `useAutoModeDuringPlan` 設定がオンの場合（デフォルト）、分類器は計画中にシェルコマンドをレビューし、プロンプトの代わりに承認します。承認されたコマンドは実行され、拒否されたコマンドはブロックされます。そうでない場合、[読み取り専用コマンド](/docs/ja/permissions#read-only-commands)の外側のコマンドはプロンプトが表示されます。これはサンドボックスの [auto-allow モード](/docs/ja/sandboxing#sandbox-modes)が有効な場合も含まれます。bypass permissions が利用可能なインタラクティブターミナルセッションでは、分類器もプロンプトも計画コマンドに適用されません。[bypassPermissions モードですべてのチェックをスキップする](#skip-all-checks-with-bypasspermissions-mode)は、計画中に依然としてプロンプトが表示される少数のものをカバーしています。v2.1.212 から v2.1.217 では、bypass permissions のないセッションは、auto モードが利用可能かどうかに関係なく、読み取り専用セット外のすべてのコマンドをプロンプトしました。254[オートモード](/docs/ja/auto-mode-config)が利用可能で、デフォルトでオンになっている `useAutoModeDuringPlan` 設定がオンの場合、分類器はプランニング中にシェルコマンドをレビューしてプロンプトを表示する代わりに確認します。承認されたコマンドは実行され、拒否されたコマンドはブロックされます。それ以外の場合、[組み込みの読み取り専用セット](/docs/ja/permissions#read-only-commands)外のコマンドはサンドボックスの[オートアロウモード](/docs/ja/sandboxing#sandbox-modes)が有効な場合を含めて承認を求めるプロンプトが表示されます。bypass 権限が利用可能なインタラクティブターミナルセッションでは、分類器もプロンプトもプランニングコマンドには適用されません。[bypassPermissions モードですべてのチェックをスキップ](#skip-all-checks-with-bypasspermissions-mode)は、そこでもまだプロンプトが表示される少数のものをカバーしています。v2.1.212 から v2.1.217 では、bypass 権限のないセッションは、オートモードが利用可能かどうかに関わらず、読み取り専用セット外のすべてのコマンドについてプロンプトを表示していました。

255 255

256`Shift+Tab` を押すか、単一のプロンプトに `/plan` をプレフィックスして計画モードに入ります。CLI から計画モードで開始することもできます。256プランモードに入るには、`Shift+Tab` を押すか、単一のプロンプトに `/plan` を付けます。CLI からプランモードで開始することもできます。

257 257

258```bash theme={null}258```bash theme={null}

259claude --permission-mode plan259claude --permission-mode plan

260```260```

261 261

262計画モードを終了するには `Shift+Tab` を再度押し、計画を承認しません。262`Shift+Tab` をもう一度押してプランを承認せずにプランモードを終了します。

263 263

264<h3 id="review-and-approve-a-plan">264<h3 id="review-and-approve-a-plan">

265 計画をレビューして承認する265 プランをレビューして承認する

266</h3>266</h3>

267 267

268計画の準備ができたら、Claude はそれを提示し、どのように進めるかを尋ねます。そのプロンプトから以下を選択できます。268プランの準備ができたら、Claude はそれを提示し、どのように進めるかを尋ねます。そのプロンプトから以下を選択できます。

269 269

270* **Yes, and use auto mode**：承認して [auto モード](#eliminate-prompts-with-auto-mode)で開始します。auto モードが利用できない場合、このオプションは **Yes, auto-accept edits** と表示されます。bypass permissions が有効な状態でセッションを開始した場合、オプションは **Yes, and switch to BYPASS PERMISSIONS (no further prompts) for this session** と表示されます。270* **はい、オートモードを使用する**: 承認して[オートモード](#eliminate-prompts-with-auto-mode)で開始します。オートモードがセッションで[利用可能でない](#eliminate-prompts-with-auto-mode)場合（例えば、組織がそれをオフにした場合）、このオプションは**はい、編集を自動受け入れ**と表示されます。bypass 権限を有効にしてセッションを開始した場合、オプションは代わりに**はい、このセッションで BYPASS PERMISSIONS（以降プロンプトなし）に切り替える**と表示されます。

271* **Yes, manually approve edits**：承認して各編集を手動でレビューします。271* **はい、編集を手動で承認する**: 承認して各編集を個別にレビューします。

272* **No, keep planning**：計画モードにとどまり、Claude に何を変更するかを伝えます。272* **いいえ、プランニングを続ける**: プランモードにとどまり、Claude に何を変更するかを伝えます。

273 273

274計画を承認すると、計画モードを終了し、セッションを各承認オプションが説明する権限モードに切り替えるため、Claude は編集を開始します。再度計画するには、`Shift+Tab` で計画モードに戻るか、次のプロンプトに `/plan` をプレフィックスしてください。274プランを承認するとプランモードを終了し、セッションを各承認オプションが説明する権限モードに切り替えるため、Claude は編集を開始します。再度プランを立てるには、`Shift+Tab` でプランモードに戻すか、次のプロンプトに `/plan` を付けます。

275 275

276`Ctrl+G` を押して、提案された計画をデフォルトのテキストエディタで開き、Claude が進める前に直接編集できます。[`showClearContextOnPlanAccept`](/docs/ja/settings-reference#showclearcontextonplanaccept)が有効な場合、リストは計画コンテキストを最初にクリアするオプションを取得します。276`Ctrl+G` を押して、提案されたプランをデフォルトのテキストエディタで開き、Claude が進める前に直接編集します。[`showClearContextOnPlanAccept`](/docs/ja/settings-reference#showclearcontextonplanaccept)が有効な場合、リストはプランを承認してプランニングコンテキストをクリアする最初のオプションを取得します。

277 277

278計画を受け入れると、セッションに[生成されたタイトル](/docs/ja/sessions#name-your-sessions)が計画に基づいて付与されます。ただし、セッションに既に名前を付けている場合を除きます。278プランを受け入れると、セッションはプランに基づいて[生成されたタイトル](/docs/ja/sessions#name-your-sessions)も取得します。ただし、セッションに既に名前を付けている場合を除きます。

279 279

280<h3 id="set-plan-mode-as-the-default">280<h3 id="set-plan-mode-as-the-default">

281 計画モードをデフォルトとして設定する281 プランモードをデフォルトとして設定する

282</h3>282</h3>

283 283

284プロジェクトのターミナルセッションのデフォルトとして計画モードを設定するには、`.claude/settings.json` で `defaultMode` を `plan` に設定します。[異なる権限モードで開始する](#start-in-a-different-mode)の例が示すように配置します。[VS Code 拡張機能](/docs/ja/vs-code)が開始する会話はプロジェクト設定を開始権限モードに読み込みません。そこで、VS Code ユーザー設定で `claudeCode.initialPermissionMode` を `plan` に設定します。284プロジェクトのターミナルセッションのデフォルトをプランモードにするには、`.claude/settings.json` で `defaultMode` を `plan` に設定します。これは[別の権限モードで開始](#start-in-a-different-mode)の下の例として配置されます。[VS Code 拡張機能](/docs/ja/vs-code)が開始する会話は、開始権限モードのプロジェクト設定を読み込みません。そこで、VS Code ユーザー設定で `claudeCode.initialPermissionMode` を `plan` に設定してください。

285 285

286<h2 id="eliminate-prompts-with-auto-mode">286<h2 id="eliminate-prompts-with-auto-mode">

287 権限プロンプトを自動モードで排除する287 権限プロンプトを自動モードで排除する

305 305

306* **プラン**: すべてのプラン。306* **プラン**: すべてのプラン。

307* **組織**: Team と Enterprise では、自動モードはデフォルトで利用可能です。管理者は、[管理設定](/docs/ja/managed-settings)で `permissions.disableAutoMode` を `"disable"` に設定することで、組織の自動モードをオフにできます。307* **組織**: Team と Enterprise では、自動モードはデフォルトで利用可能です。管理者は、[管理設定](/docs/ja/managed-settings)で `permissions.disableAutoMode` を `"disable"` に設定することで、組織の自動モードをオフにできます。

308* **モデル**: Anthropic API と[AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws) では、Claude Opus 4.6 以降、Sonnet 4.6 以降、または[Fable モデル](/docs/ja/model-config#work-with-fable)。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、およびサインイン済みの[Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでは、Claude Sonnet 5、Opus 4.7 以降、および Fable モデルのみです。Sonnet 4.5、Opus 4.5、Haiku、claude-3 モデルを含む古いモデルは、どのプロバイダーでもサポートされていません。308* **モデル**: Anthropic API と[AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws)では、Claude Opus 4.6 以降、Sonnet 4.6 以降、または[Fable モデル](/docs/ja/model-config#work-with-fable)。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、およびサインイン済みの[Claude apps gateway](/docs/ja/claude-apps-gateway)セッションでは、Claude Sonnet 5、Opus 4.7 以降、および Fable モデルのみです。Sonnet 4.5、Opus 4.5、Haiku、claude-3 モデルを含む古いモデルは、どのプロバイダーでもサポートされていません。

309* **プロバイダー**: Anthropic API、AWS 上の Claude Platform、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、およびサインイン済みの Claude apps gateway セッションでデフォルトで利用可能です。309* **プロバイダー**: Anthropic API、AWS 上の Claude Platform、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、およびサインイン済みの Claude apps gateway セッションでデフォルトで利用可能です。

310 310

311Claude Code が自動モードを利用不可と報告する場合は、まずこれらの要件を確認し、設定ファイルが [`disableAutoMode`](/docs/ja/settings-reference#disableautomode) を設定しているかどうかを確認してください。Anthropic がサーバー側で自動モードをオフにしたか、サーバーがアカウントの自動モードを拒否した可能性があります。どちらかの回答を受け取ったセッションは、セッションが終了するまで自動モードをオフのままにするため、後で新しいセッションを開始してください。311Claude Code が自動モードを利用不可と報告する場合は、まずこれらの要件を確認し、設定ファイルが [`disableAutoMode`](/docs/ja/settings-reference#disableautomode) を設定しているかどうかを確認してください。Anthropic がサーバー側で自動モードをオフにしたか、サーバーがアカウントの自動モードを拒否した可能性があります。どちらかの回答を受け取ったセッションは、セッションが終了するまで自動モードをオフのままにするため、後で新しいセッションを開始してください。

318 Bedrock、Agent Platform、または Foundry での自動モード318 Bedrock、Agent Platform、または Foundry での自動モード

319</h3>319</h3>

320 320

321[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、およびサインイン済みの[Claude apps gateway](/docs/ja/claude-apps-gateway) セッションでは、自動モードはデフォルトで `Shift+Tab` サイクルに表示されます。サイクルに表示されることは、セッションが開始される権限モードを変更しません。これらのプロバイダーでは、ターミナルセッションは [`defaultMode`](/docs/ja/settings-reference#permissions-defaultmode) で開始されます。これは変更しない限り Manual です。[VS Code 拡張機能](/docs/ja/vs-code)の会話は、`claudeCode.initialPermissionMode` または拡張機能で選択したモードが設定しない限り Manual で開始されます。これらのプロバイダーでは、Claude Sonnet 5、Opus 4.7 以降、および Fable モデルのみがサポートされています。321[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、およびサインイン済みの[Claude apps gateway](/docs/ja/claude-apps-gateway)セッションでは、自動モードはデフォルトで `Shift+Tab` サイクルに表示されます。サイクルに表示されることは、セッションが開始される権限モードを変更しません。これらのプロバイダーでは、ターミナルセッションは [`defaultMode`](/docs/ja/settings-reference#permissions-defaultmode)で開始されます。これは変更しない限り Manual です。[VS Code 拡張機能](/docs/ja/vs-code)の会話は、`claudeCode.initialPermissionMode` または拡張機能で選択したモードが設定しない限り Manual で開始されます。これらのプロバイダーでは、Claude Sonnet 5、Opus 4.7 以降、および Fable モデルのみがサポートされています。

322 322

323自動モードをデフォルトの開始権限モードにするには、ユーザーまたは管理設定で `"permissions": {"defaultMode": "auto"}` を設定します。VS Code 拡張機能が開始するセッションでは、モード指示器から **Auto** を選択します。[権限モードの切り替え](#switch-permission-modes)は、その選択を上回るものをカバーしています。323自動モードをデフォルトの開始権限モードにするには、ユーザーまたは管理設定で `"permissions": {"defaultMode": "auto"}` を設定します。VS Code 拡張機能が開始するセッションでは、モード指示器から **Auto** を選択します。[権限モードの切り替え](#switch-permission-modes)は、その選択を上回るものをカバーしています。

324 324

325[`/doctor`](/docs/ja/commands#all-commands) チェックアップは、Anthropic API と同じ方法で、これらのプロバイダーのユーザー設定デフォルトを提案します。325[`/doctor`](/docs/ja/commands#all-commands)チェックアップは、Anthropic API と同じ方法で、これらのプロバイダーのユーザー設定デフォルトを提案します。

326 326

327開発者が自動モードを使用するのを防ぐには、[管理設定](/docs/ja/managed-settings)で `disableAutoMode` を `"disable"` に設定します。これにより `auto` が `Shift+Tab` サイクルから削除され、`--permission-mode auto` で開始されたセッションは Manual で開始されます。既に自動モードで実行されているセッションは、設定が[管理者がデプロイしたソース](/docs/ja/managed-settings#which-managed-source-claude-code-uses)からそのセッションに到達すると、自動モードを離れ、`auto mode disabled by settings` を表示します。v2.1.251 より前では、実行中のセッションは終了するまで自動モードを保持していました。327開発者が自動モードを使用するのを防ぐには、[管理設定](/docs/ja/managed-settings)で `disableAutoMode` を `"disable"` に設定します。これにより `auto` が `Shift+Tab` サイクルから削除され、`--permission-mode auto` で開始されたセッションは Manual で開始されます。既に自動モードで実行されているセッションは、設定が[管理者がデプロイしたソース](/docs/ja/managed-settings#which-managed-source-claude-code-uses)からそのセッションに到達すると、自動モードを離れ、`auto mode disabled by settings` を表示します。v2.1.251 より前では、実行中のセッションは終了するまで自動モードを保持していました。

328 328

332 サーバー側クラシファイアレビュー332 サーバー側クラシファイアレビュー

333</h3>333</h3>

334 334

335Enterprise プランおよび Claude API を使用するアカウント、[AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws)、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および `ANTHROPIC_BASE_URL` を[LLM ゲートウェイまたはプロキシ](/docs/ja/llm-gateway)に指す場合、自動モードの Claude Code はサーバーに[クラシファイアに送信されるアクション](#how-the-classifier-evaluates-actions)をセッションのモデルリクエストの一部としてレビューするよう要求します。サーバーがそれらをレビューする場所では、その判定がこれらのアクションを決定します。レビューしない場所では、通常はゲートウェイまたはプロキシがトラフィックに干渉するため、プラットフォーム、リージョン、または認証情報がまだサーバー側チェックを持たないため、Claude Code は独自のクラシファイアリクエストにフォールバックします。そのフォールバックがセッションの残りの間保持されると、これらのリクエストが請求されるアカウントで[クラシファイアリクエスト料金に関する通知](/docs/ja/auto-mode-classifier-billing)を表示します。サーバーに質問することをスキップして、常に Claude Code 独自のクラシファイアリクエストを使用するには、[`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ja/env-vars) を設定します。変数は Anthropic API への直接接続では読み取られません。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を設定し、`CLAUDE_CODE_AUTO_MODE_SERVER` を設定しないままにする場合、Claude Code もサーバーに質問することを停止します。335Enterprise プランおよび Claude API を使用するアカウント、[AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws)、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および `ANTHROPIC_BASE_URL` を[LLM ゲートウェイまたはプロキシ](/docs/ja/llm-gateway)に指す場合、自動モードの Claude Code はサーバーに[クラシファイアに送信されるアクション](#how-the-classifier-evaluates-actions)をセッションのモデルリクエストの一部としてレビューするよう要求します。サーバーがそれらをレビューする場所では、その判定がこれらのアクションを決定します。レビューしない場所では、通常はゲートウェイまたはプロキシがトラフィックに干渉するため、プラットフォーム、リージョン、または認証情報がまだサーバー側チェックを持たないため、Claude Code は独自のクラシファイアリクエストにフォールバックします。そのフォールバックがセッションの残りの間保持されると、これらのリクエストが請求されるアカウントで[クラシファイアリクエスト料金に関する通知](/docs/ja/auto-mode-classifier-billing)を表示します。サーバーに質問することをスキップして、常に Claude Code 独自のクラシファイアリクエストを使用するには、[`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ja/env-vars)を設定します。変数は Anthropic API への直接接続では読み取られません。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を設定し、`CLAUDE_CODE_AUTO_MODE_SERVER` を設定しないままにする場合、Claude Code もサーバーに質問することを停止します。

336 336

337デフォルトでサーバーに質問することには Claude Code v2.1.278 以降が必要です。337デフォルトでサーバーに質問することには Claude Code v2.1.278 以降が必要です。

338 338

426* 同じセッションで前に Claude が作成した正確なジョブの削除426* 同じセッションで前に Claude が作成した正確なジョブの削除

427* セキュリティ関連のコード、構成、および脅威モデルの読み取り、レビュー、または書き込み。タスクの一部として427* セキュリティ関連のコード、構成、および脅威モデルの読み取り、レビュー、または書き込み。タスクの一部として

428* 同じマルチエージェントセッションで一緒に作業しているエージェント間のメッセージ428* 同じマルチエージェントセッションで一緒に作業しているエージェント間のメッセージ

429* [`environment`](/docs/ja/auto-mode-config#define-trusted-infrastructure) にリストされている信頼できるドメイン、バケット、およびサービスへのデータ送信。これはデータフローのみをカバーし、同じインフラストラクチャ上の破壊的または認証情報操作ではありません429* [`environment`](/docs/ja/auto-mode-config#define-trusted-infrastructure)にリストされている信頼できるドメイン、バケット、およびサービスへのデータ送信。これはデータフローのみをカバーし、同じインフラストラクチャ上の破壊的または認証情報操作ではありません

430* [Chrome の Claude](/docs/ja/chrome)。信頼できる内部ドメイン、localhost、または指定した URL へのナビゲーション430* [Chrome の Claude](/docs/ja/chrome)。信頼できる内部ドメイン、localhost、または指定した URL へのナビゲーション

431 431

432サンドボックス化されたコマンドはデフォルトではネットワークアクセスを取得しません。Claude はコマンドが必要とするホストをコマンド自体に名前を付け、クラシファイアはそれらをコマンドでレビューし、承認されたリストはそのコマンドのみのためにそれらのホストを開きます。[コマンドごとの許可ドメイン](/docs/ja/sandboxing#per-command-allowed-domains-in-auto-mode)は、リストが何を開くことができるか、できないか、およびコマンドがリストされていないホストに到達するときに何が起こるかをカバーしています。432サンドボックス化されたコマンドはデフォルトではネットワークアクセスを取得しません。Claude はコマンドが必要とするホストをコマンド自体に名前を付け、クラシファイアはそれらをコマンドでレビューし、承認されたリストはそのコマンドのみのためにそれらのホストを開きます。[コマンドごとの許可ドメイン](/docs/ja/sandboxing#per-command-allowed-domains-in-auto-mode)は、リストが何を開くことができるか、できないか、およびコマンドがリストされていないホストに到達するときに何が起こるかをカバーしています。

439 作業ディレクトリ外の最初の読み取り439 作業ディレクトリ外の最初の読み取り

440</h3>440</h3>

441 441

442[`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) がオフの間、ファイル読み取りは自動モードでプロンプトなしで実行されます。[作業ディレクトリ](/docs/ja/permissions#working-directories)外のパスを含む。Claude が Read、Grep、または Glob ツールを初めて使用するとき。外側のパスで、Claude Code はそれらの読み取りを許可し続けるかどうかを尋ねます。442[`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories)がオフの間、ファイル読み取りは自動モードでプロンプトなしで実行されます。[作業ディレクトリ](/docs/ja/permissions#working-directories)外のパスを含む。Claude が Read、Grep、または Glob ツールを初めて使用するとき。外側のパスで、Claude Code はそれらの読み取りを許可し続けるかどうかを尋ねます。

443 443

444プロンプトは非インタラクティブな `-p` 実行またはバックグラウンドセッションには表示されません。そこでの読み取りは以前と同じように実行されます。444プロンプトは非インタラクティブな `-p` 実行またはバックグラウンドセッションには表示されません。そこでの読み取りは以前と同じように実行されます。

445 445

446答えに関係なく、Claude は作業を続けます。446答えに関係なく、Claude は作業を続けます。

447 447

448* **許可し続ける**: 読み取りが実行され、作業ディレクトリ外の後の読み取りは以前と同じように実行され、Claude Code は答えを記録するため、プロンプトは再度表示されません448* **許可し続ける**: 読み取りが実行され、作業ディレクトリ外の後の読み取りは以前と同じように実行され、Claude Code は答えを記録するため、プロンプトは再度表示されません

449* **今からブロック**: 読み取りが拒否され、Claude Code は [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) をユーザー設定で `true` に設定します。これにより、ファイルツールはすべての後のセッションとすべての権限モードでそのような読み取りを拒否します。後で Claude がそのようなパスを読み取ることを許可するには、`/add-dir` でそのディレクトリを追加するか、設定を削除します。449* **今からブロック**: 読み取りが拒否され、Claude Code は [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories)をユーザー設定で `true` に設定します。これにより、ファイルツールはすべての後のセッションとすべての権限モードでそのような読み取りを拒否します。後で Claude がそのようなパスを読み取ることを許可するには、`/add-dir` でそのディレクトリを追加するか、設定を削除します。

450* **次回また質問**: 読み取りが拒否され、作業ディレクトリ外の次の読み取りが再度プロンプトします450* **次回また質問**: 読み取りが拒否され、作業ディレクトリ外の次の読み取りが再度プロンプトします

451 451

452<h3 id="boundaries-you-state-in-conversation">452<h3 id="boundaries-you-state-in-conversation">

457 457

458境界はルールとして保存されません。クラシファイアはチェックのたびにトランスクリプトから再度読み取るため、[コンテキストコンパクション](/docs/ja/costs#reduce-token-usage)が境界を述べたメッセージを削除する場合、境界は失われる可能性があります。ハード保証の場合は、代わりに[拒否ルール](/docs/ja/permissions#permission-rule-syntax)を追加します。458境界はルールとして保存されません。クラシファイアはチェックのたびにトランスクリプトから再度読み取るため、[コンテキストコンパクション](/docs/ja/costs#reduce-token-usage)が境界を述べたメッセージを削除する場合、境界は失われる可能性があります。ハード保証の場合は、代わりに[拒否ルール](/docs/ja/permissions#permission-rule-syntax)を追加します。

459 459

460<h3 id="approvals-you-state-in-conversation">

461 会話で述べた承認

462</h3>

463

464ブロックされたアクションが許可されていることを Claude に伝える場合、クラシファイアはそれをあなたの承認として読み取り、ブロックをクリアできます。それをどのように表現したかは、アクションが実行されるかどうか、および承認がどこまで到達するかを決定します。

465

466* **アクションとその詳細に名前を付ける**: メッセージはアクションと、それを危険にする特定のもの（force push のブランチなど）に名前を付ける必要があります。動詞だけに名前を付けるとブロックはクリアされません。「force-push できます」はブロックを有効なままにします。

467* **1 つのアクションをカバーすることを期待する**: 承認は、あなたが名前を付けた破壊的なアクションをカバーするため、後のアクションは再度ブロックされます。ルーチンパターンを 1 つずつ承認することを停止するには、[`autoMode.allow`](/docs/ja/auto-mode-config#override-the-block-and-allow-rules)に追加します。

468* **いくつかのブロックは有効なままです**: [クラシファイアの優先順位](/docs/ja/auto-mode-config#override-the-block-and-allow-rules)は、あなたの承認が到達できるブロックを設定します。それがクリアしないステップを実行するには、[自動モードを離れ](#switch-permission-modes)、権限プロンプトに答えます。

469

460<h3 id="when-auto-mode-falls-back">470<h3 id="when-auto-mode-falls-back">

461 自動モードがフォールバックするとき471 自動モードがフォールバックするとき

462</h3>472</h3>

465 475

466* **ブロックされたアクション**: Claude Code は通知を表示し、`/permissions` の下の **Recently denied** タブにアクションをリストします。そこで `r` を押して、手動承認で再試行できます。クラシファイアが[アクションに対して判定を出さない](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)場合。自動モードとは別の安全チェックがクラシファイアのリクエスト自体を拒否したか、その応答が解析されなかったため、Claude Code は通知または **Recently denied** エントリなしでアクションを拒否します。476* **ブロックされたアクション**: Claude Code は通知を表示し、`/permissions` の下の **Recently denied** タブにアクションをリストします。そこで `r` を押して、手動承認で再試行できます。クラシファイアが[アクションに対して判定を出さない](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)場合。自動モードとは別の安全チェックがクラシファイアのリクエスト自体を拒否したか、その応答が解析されなかったため、Claude Code は通知または **Recently denied** エントリなしでアクションを拒否します。

467* **繰り返されるブロック**: クラシファイアが連続して 3 回またはセッション全体で 20 回アクションをブロックする場合、自動モードは一時停止し、Claude Code はプロンプトを再開します。プロンプトされたアクションを承認すると、自動モードが再開されます。これらのしきい値は構成不可能です。許可されたアクションは連続カウンターをリセットしますが、合計カウンターはセッション用に保持され、独自のリミットがフォールバックをトリガーするときのみリセットされます。Claude Code は、[自動モードとは別の安全チェックがクラシファイアのリクエストを拒否する](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)場合、拒否をどちらのしきい値にもカウントしません。リンクされたエントリは Claude Code がそれらの拒否をどのように処理するかをカバーしています。477* **繰り返されるブロック**: クラシファイアが連続して 3 回またはセッション全体で 20 回アクションをブロックする場合、自動モードは一時停止し、Claude Code はプロンプトを再開します。プロンプトされたアクションを承認すると、自動モードが再開されます。これらのしきい値は構成不可能です。許可されたアクションは連続カウンターをリセットしますが、合計カウンターはセッション用に保持され、独自のリミットがフォールバックをトリガーするときのみリセットされます。Claude Code は、[自動モードとは別の安全チェックがクラシファイアのリクエストを拒否する](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)場合、拒否をどちらのしきい値にもカウントしません。リンクされたエントリは Claude Code がそれらの拒否をどのように処理するかをカバーしています。

468* **プロンプトできないセッション**: [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) のない[非インタラクティブ](/docs/ja/headless) `-p` 実行にはフォールバックするプロンプトがありません。繰り返されるブロックがしきい値に到達すると、アクションは実行されず、Claude は作業を続けます。[自動モードとは別の安全チェックがクラシファイアのリクエストを拒否する](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)場合も同じです。Claude Code はどちらの場合もランを停止しません。478* **プロンプトできないセッション**: [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags)のない[非インタラクティブ](/docs/ja/headless) `-p` 実行にはフォールバックするプロンプトがありません。繰り返されるブロックがしきい値に到達すると、アクションは実行されず、Claude は作業を続けます。[自動モードとは別の安全チェックがクラシファイアのリクエストを拒否する](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)場合も同じです。Claude Code はどちらの場合もランを停止しません。

469* **チェック中のモード切り替え**: クラシファイアチェックが保留中に権限モードを切り替える場合、Claude Code は新しいモードが要求しなかった判定を破棄します。代わりにプロンプトされるか、[`dontAsk` モード](#allow-only-pre-approved-tools-with-dontask-mode)でアクションが自動拒否されます。479* **チェック中のモード切り替え**: クラシファイアチェックが保留中に権限モードを切り替える場合、Claude Code は新しいモードが要求しなかった判定を破棄します。代わりにプロンプトされるか、[`dontAsk` モード](#allow-only-pre-approved-tools-with-dontask-mode)でアクションが自動拒否されます。

470 480

471繰り返されるブロックは通常、クラシファイアがインフラストラクチャについてのコンテキストを欠いていることを意味します。`/feedback` を使用して偽陽性を報告するか、管理者に[信頼できるインフラストラクチャを構成](/docs/ja/auto-mode-config)させてください。481繰り返されるブロックは通常、クラシファイアがインフラストラクチャについてのコンテキストを欠いていることを意味します。`/feedback` を使用して偽陽性を報告するか、管理者に[信頼できるインフラストラクチャを構成](/docs/ja/auto-mode-config)させてください。

478 488

479 1. [許可、質問、または拒否ルール](/docs/ja/permissions#manage-permissions)に一致するアクションは、これらの例外を除いて直ちに解決されます。489 1. [許可、質問、または拒否ルール](/docs/ja/permissions#manage-permissions)に一致するアクションは、これらの例外を除いて直ちに解決されます。

480 * [保護されたパス](#protected-paths)への書き込みは、許可ルールが一致する場合でもクラシファイアにルーティングされます。`rm` と `rmdir` の削除も Claude Code v2.1.218 以降で[重要なパス](#critical-paths)をターゲットにしている場合もそうです490 * [保護されたパス](#protected-paths)への書き込みは、許可ルールが一致する場合でもクラシファイアにルーティングされます。`rm` と `rmdir` の削除も Claude Code v2.1.218 以降で[重要なパス](#critical-paths)をターゲットにしている場合もそうです

481 * [`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツール。許可ルールが一致する場合でも直接プロンプトします。コネクタツール[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)したもの。その設定が Claude Code に到達するセッションでも491 * [`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool)とマークされた MCP ツール。許可ルールが一致する場合でも直接プロンプトします。コネクタツール[組織が `ask` に設定](/docs/ja/mcp#organization-controls-on-connector-tools)したもの。その設定が Claude Code に到達するセッションでも

482 * [コマンドごとの許可ドメイン](/docs/ja/sandboxing#per-command-allowed-domains-in-auto-mode)を含むシェルコマンド。許可ルールが一致する場合でもクラシファイアにルーティングされます。ルールはコマンドを承認するため、そのホストではなく492 * [コマンドごとの許可ドメイン](/docs/ja/sandboxing#per-command-allowed-domains-in-auto-mode)を含むシェルコマンド。許可ルールが一致する場合でもクラシファイアにルーティングされます。ルールはコマンドを承認するため、そのホストではなく

483 * `Bash(git push *)` のようなコマンドのコンテンツで一致する質問ルール。権限プロンプトにフォールバック493 * `Bash(git push *)` のようなコマンドのコンテンツで一致する質問ルール。権限プロンプトにフォールバック

484 2. 読み取り専用アクションと作業ディレクトリ内のファイル編集は自動承認されます。[保護されたパス](#protected-paths)と[作業ディレクトリ外の最初の読み取り](#first-read-outside-the-working-directories)への書き込みを除く。プロンプトします494 2. 読み取り専用アクションと作業ディレクトリ内のファイル編集は自動承認されます。[保護されたパス](#protected-paths)と[作業ディレクトリ外の最初の読み取り](#first-read-outside-the-working-directories)への書き込みを除く。プロンプトします

491 * `Bash(python*)` のようなワイルドカードインタープリタ501 * `Bash(python*)` のようなワイルドカードインタープリタ

492 * パッケージマネージャー実行コマンド502 * パッケージマネージャー実行コマンド

493 * `Agent` 許可ルール503 * `Agent` 許可ルール

494 * [`Monitor`](/docs/ja/tools-reference#monitor-tool) 許可ルール。Claude Code は Monitor コマンドをシェルを通じて実行するため504 * [`Monitor`](/docs/ja/tools-reference#monitor-tool)許可ルール。Claude Code は Monitor コマンドをシェルを通じて実行するため

495 505

496 `Bash(npm test)` のような狭いルールは有効なままです。Claude Code は自動モードを離れるときに削除されたルールを復元します。v2.1.236 より前では、Claude Code は自動モードで `Monitor` 許可ルールを有効なままにしていたため、ツール全体に一致するルールは分類器レビューなしで Monitor コマンドを承認しました。506 `Bash(npm test)` のような狭いルールは有効なままです。Claude Code は自動モードを離れるときに削除されたルールを復元します。v2.1.236 より前では、Claude Code は自動モードで `Monitor` 許可ルールを有効なままにしていたため、ツール全体に一致するルールは分類器レビューなしで Monitor コマンドを承認しました。

497 507

510 1. サブエージェントが開始する前に、委任されたタスク説明が評価されるため、危険に見えるタスクはスポーン時にブロックされます。520 1. サブエージェントが開始する前に、委任されたタスク説明が評価されるため、危険に見えるタスクはスポーン時にブロックされます。

511 2. サブエージェントが実行されている間、その各アクションはクラシファイアを通じて親セッションと同じルールで実行され、サブエージェントの frontmatter の `permissionMode` は無視されます。521 2. サブエージェントが実行されている間、その各アクションはクラシファイアを通じて親セッションと同じルールで実行され、サブエージェントの frontmatter の `permissionMode` は無視されます。

512 3. サブエージェントが終了すると、クラシファイアはその作業と最終レポートをレビューしてから、親がレポートを読みます。クラシファイアがサブエージェントの作業またはレポートにフラグを立てるか、別の API 安全チェックがレビューを拒否する場合、レポートは依然として配信されます。セキュリティ警告が前に付きます。クラシファイアがレビューに利用できない場合、レポートはサブエージェントの作業を検証してから行動する前に確認するメモと共に到着します。522 3. サブエージェントが終了すると、クラシファイアはその作業と最終レポートをレビューしてから、親がレポートを読みます。クラシファイアがサブエージェントの作業またはレポートにフラグを立てるか、別の API 安全チェックがレビューを拒否する場合、レポートは依然として配信されます。セキュリティ警告が前に付きます。クラシファイアがレビューに利用できない場合、レポートはサブエージェントの作業を検証してから行動する前に確認するメモと共に到着します。

~~513~~

514 ステップ 1 には Claude Code v2.1.178 以降が必要です。以前のバージョンはステップ 2 と 3 でクラシファイアを適用しましたが、サブエージェントが開始する前にタスク説明を評価しませんでした。

515 </Accordion>523 </Accordion>

516 524

517 <Accordion title="コストとレイテンシ">525 <Accordion title="コストとレイテンシ">

518 クラシファイアはデフォルトでは `/model` 選択ではなく Claude Sonnet 5 で実行されます。Anthropic がサーバー側で構成するクラシファイアモデルはそのデフォルトより優先されます。セッションのモデルが Claude Sonnet 4.6 の場合、または [`availableModels`](/docs/ja/model-config#restrict-model-selection) が Sonnet 5 を除外する場合、クラシファイアは代わりにセッションのモデルで実行されます。またはセッションが[Fable モデル](/docs/ja/model-config#work-with-fable)で実行される場合は Opus モデルで。Anthropic API 以外のプロバイダーでは、その Opus フォールバックはプロバイダーのデフォルト Opus モデルです。526 クラシファイアはデフォルトでは `/model` 選択ではなく Claude Sonnet 5 で実行されます。Anthropic がサーバー側で構成するクラシファイアモデルはそのデフォルトより優先されます。セッションのモデルが Claude Sonnet 4.6 の場合、または [`availableModels`](/docs/ja/model-config#restrict-model-selection)が Sonnet 5 を除外する場合、クラシファイアは代わりにセッションのモデルで実行されます。またはセッションが[Fable モデル](/docs/ja/model-config#work-with-fable)で実行される場合は Opus モデルで。Anthropic API 以外のプロバイダーでは、その Opus フォールバックはプロバイダーのデフォルト Opus モデルです。

519 527

520 セッションの最初の自動モードリクエストは Sonnet 5 デフォルトを検証します。リクエストが成功する場合、Sonnet 5 はセッションのクラシファイアモデルのままです。リクエストがモデルが利用できないため失敗する場合、セッションは代わりにフォールバックを使用します。その検証が解決した後、クラシファイアのモデルはセッション用に変更されません。528 セッションの最初の自動モードリクエストは Sonnet 5 デフォルトを検証します。リクエストが成功する場合、Sonnet 5 はセッションのクラシファイアモデルのままです。リクエストがモデルが利用できないため失敗する場合、セッションは代わりにフォールバックを使用します。その検証が解決した後、クラシファイアのモデルはセッション用に変更されません。

521 529

662 670

663Claude Code は、`rm -rf "$DIR"/*` のようなシェル変数の直下のグロブまたは末尾のスラッシュも重要なパスの削除として扱います。変数が空の場合、コマンドはファイルシステムルートからの削除になるためです。671Claude Code は、`rm -rf "$DIR"/*` のようなシェル変数の直下のグロブまたは末尾のスラッシュも重要なパスの削除として扱います。変数が空の場合、コマンドはファイルシステムルートからの削除になるためです。

664 672

665`(...)` を使用したサブシェル、`{ ...; }` を使用したブレースグループ、`$(...)` またはバッククォートを使用したコマンド置換、あるいは `<(...)` を使用したプロセス置換内に削除を隠すことは、チェックをスキップしません。Claude Code は、`(rm -rf ~)` や `echo "$(rm -rf ~)"` のように置換内にある重要なパスの削除、または同じコマンド内の他の場所にある削除を見つけます。673このプロンプトは、フラグが付いた `rm` に名前を付け、チェックに合格するように書き直す方法を説明します。

674

675* `$DIR` のような変数の場合、各展開をガードして、変数が設定されていないか空の場合にシェルがエラーで停止するようにします。例えば `rm -rf "${DIR:?}"/*` のように、またはリテラルパスを使用します

676* `$HOME` のような通常設定されている変数の場合、リテラルパスを使用します

677

678その方法ですべての展開がガードされている削除は重要なパスの削除ではないため、`bypassPermissions` モードではプロンプトなしで実行されます。

679

680削除を `(...)` を使用したサブシェル、`{ ...; }` を使用したブレースグループ、`$(...)` またはバッククォートを使用したコマンド置換、あるいは `<(...)` を使用したプロセス置換内に隠すことは、チェックをスキップしません。Claude Code は、`(rm -rf ~)` や `echo "$(rm -rf ~)"` のように置換内にある重要なパスの削除、または同じコマンド内の他の場所にある削除を見つけます。

666 681

667<h3 id="remove-item-in-powershell">682<h3 id="remove-item-in-powershell">

668 PowerShell の Remove-Item683 PowerShell の Remove-Item

permissions.md +2 −10

Details

26 26

27v2.1.211 より前では、Claude Code は常にルールを開始ディレクトリに保存していたため、worktree またはサブディレクトリで付与された承認はリポジトリの残りの部分に適用されませんでした。以前のバージョンがサブディレクトリまたは worktree に保存したルールは、そこで開始されたセッションに引き続き適用されます。27v2.1.211 より前では、Claude Code は常にルールを開始ディレクトリに保存していたため、worktree またはサブディレクトリで付与された承認はリポジトリの残りの部分に適用されませんでした。以前のバージョンがサブディレクトリまたは worktree に保存したルールは、そこで開始されたセッションに引き続き適用されます。

28 28

29場合によっては、権限プロンプトは 1 回限りの承認のみを提供し、「今後は聞かない」オプションもセッションの残りの部分のアクションを許可するオプションもありません。Claude Code はプロンプトがそれらが許可するすべてのものをあなたに表示できる場合にのみ、これらのオプションを提供するため、プロンプトから保存するルールは、その名前のオプションが許可するものだけをカバーします。29場合によっては、権限プロンプトは 1 回限りの承認のみを提供し、「今後は聞かない」オプションもセッションの残りの部分のアクションを許可するオプションもありません。Claude Code はプロンプトがそれらが許可するすべてのものをあなたに表示できる場合にのみ、これらのオプションを提供するため、プロンプトから保存するルールは、その名前のオプションが許可するものだけをカバーします。プロンプトが 1 回限りの承認のみを提供する場合、アクションを 1 回承認するか、[`/permissions`](#manage-permissions)でルール自体を追加してください。

31Claude Code を開始したディレクトリがオプションのラベルを長すぎるものにしている場合、Claude Code はラベルでそれを短縮し、ホームディレクトリを `~` に置き換え、パスの終わりを `…` に置き換え、オプションを保持します。同じルールを保存します。Claude Code は 3 つのケースでオプションを除外します。

~~33* **コマンドまたは編集：** 完全に表示するには大きすぎます。~~

~~34* **ルールがカバーするコマンドまたはパス：** ラベルはそれらすべてに適合できません。~~

~~35* **開始ディレクトリが長すぎて、短縮されていない：** Claude Code が安全に表示できない文字が含まれているか、その開始さえ適合しません。~~

~~37アクションを 1 回承認するか、[`/permissions`](#manage-permissions)でルール自体を追加してください。~~

38 30

39<h3 id="add-a-comment-when-you-answer-a-permission-prompt">31<h3 id="add-a-comment-when-you-answer-a-permission-prompt">

40 権限プロンプトに回答するときにコメントを追加する32 権限プロンプトに回答するときにコメントを追加する

224 216

225許可ルールは、リテラル `mcp__<server>__` プレフィックスの後でのみツール名 glob を受け入れます。サーバーセグメントは glob フリーである必要があるため、ルールは設定した特定のサーバーに名前を付けます。`mcp__puppeteer__*` は `puppeteer` サーバーからのすべてのツールにマッチし、`mcp__github__get_*` はその `get_` ツールにマッチします。`"*"`、`"B*"`、または `"mcp__*"` などのアンカーなし許可 glob は警告とともにスキップされ、自動承認されません。217許可ルールは、リテラル `mcp__<server>__` プレフィックスの後でのみツール名 glob を受け入れます。サーバーセグメントは glob フリーである必要があるため、ルールは設定した特定のサーバーに名前を付けます。`mcp__puppeteer__*` は `puppeteer` サーバーからのすべてのツールにマッチし、`mcp__github__get_*` はその `get_` ツールにマッチします。`"*"`、`"B*"`、または `"mcp__*"` などのアンカーなし許可 glob は警告とともにスキップされ、自動承認されません。

226 218

227ツール名がマッチしない既知のツールを持つ拒否ルールまたは確認ルールは、タイプミスをキャッチするためにスタートアップ警告を生成します。`_` または `*` を含むツール名はチェックから除外されます。219ツール名がマッチしない既知のツールを持つ拒否ルールまたは確認ルールは、タイプミスをキャッチするためにスタートアップ警告を生成します。`_` または `*` を含むツール名はチェックから除外されます。また、Claude Code が削除したツール（`TaskOutput` など）の名前も除外されます。

228 220

229トランスクリプトと権限ダイアログに表示されるツールのラベルは、その正規名と異なる場合があります。たとえば、トランスクリプトで `Stop Task` というラベルが付いているツールの正規名は `TaskStop` です。権限ルールと [hook マッチャー](/docs/ja/hooks) はラベルにはマッチしないため、`Stop Task` として記述されたルールはマッチしません。拒否ルールと確認ルールの場合、上記のスタートアップ警告がミスマッチをキャッチします。[ツール参照](/docs/ja/tools-reference) に記載されている正規名を使用してください。221トランスクリプトと権限ダイアログに表示されるツールのラベルは、その正規名と異なる場合があります。たとえば、トランスクリプトで `Stop Task` というラベルが付いているツールの正規名は `TaskStop` です。権限ルールと [hook マッチャー](/docs/ja/hooks) はラベルにはマッチしないため、`Stop Task` として記述されたルールはマッチしません。拒否ルールと確認ルールの場合、上記のスタートアップ警告がミスマッチをキャッチします。[ツール参照](/docs/ja/tools-reference) に記載されている正規名を使用してください。

230 222

plugin-evals.md +1 −1

Details

339 ツールを付与する339 ツールを付与する

340</h3>340</h3>

341 341

342実行は許可を求めるために停止することはありません。付与しなかった許可が必要な組み込みツール（`Bash`、`Write`、`Edit`、`WebFetch`、`WebSearch` など）はセッションから削除されるため、Claude はそれらをまったく呼び出すことができません。許可リストは、ケースが `allowed_tools` にリストする読み取り専用ツール（`Read`、`Glob`、`Grep`、`NotebookRead`、`Skill`、`Agent`、`TodoWrite`、およびタスクツール `TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate`、`TaskStop`、`TaskOutput` から）と、`--allow-tools` で付与するもの（スイート内のすべてのケースに適用）です。ケースが `Bash`、`Write`、`Edit`、`WebFetch`、`WebSearch` を使用できるようにするには、自分で付与します。342実行は許可を求めるために停止することはありません。付与しなかった許可が必要な組み込みツール（`Bash`、`Write`、`Edit`、`WebFetch`、`WebSearch` など）はセッションから削除されるため、Claude はそれらをまったく呼び出すことができません。許可リストは、ケースが `allowed_tools` にリストする読み取り専用ツール（`Read`、`Glob`、`Grep`、`NotebookRead`、`Skill`、`Agent`、`TodoWrite`、およびタスクツール `TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate`、`TaskStop`）と、`--allow-tools` で付与するもの（スイート内のすべてのケースに適用）です。ケースが `Bash`、`Write`、`Edit`、`WebFetch`、`WebSearch` を使用できるようにするには、自分で付与します。

343 343

344```bash theme={null}344```bash theme={null}

345claude plugin eval . --allow-tools Write Edit "Bash(npm test *)"345claude plugin eval . --allow-tools Write Edit "Bash(npm test *)"

plugin-marketplaces.md +2 −2

Details

279Claude Code は、インストール済みの各プラグインをローカルバージョン管理されたプラグインキャッシュ（`~/.claude/plugins/cache`）にコピーします。ただし、プラグインがその場で読み込まれる場合は例外です。[リンクモードの `command` ソース](#copy-mode-and-link-mode)はその場で読み込まれ、[ローカルディレクトリから追加されたマーケットプレイスの相対パスソース](#relative-paths)も同様です。Claude Code はまた、[プラグインの対象となる Node.js パッケージ依存関係](/docs/ja/plugins-reference#node-js-package-dependencies)をキャッシュされたコピーにインストールします。ローカルディレクトリマーケットプレイスからその場で読み込まれたプラグインが編集内容を取得する方法については、[プラグインキャッシングとファイル解決](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)を参照してください。279Claude Code は、インストール済みの各プラグインをローカルバージョン管理されたプラグインキャッシュ（`~/.claude/plugins/cache`）にコピーします。ただし、プラグインがその場で読み込まれる場合は例外です。[リンクモードの `command` ソース](#copy-mode-and-link-mode)はその場で読み込まれ、[ローカルディレクトリから追加されたマーケットプレイスの相対パスソース](#relative-paths)も同様です。Claude Code はまた、[プラグインの対象となる Node.js パッケージ依存関係](/docs/ja/plugins-reference#node-js-package-dependencies)をキャッシュされたコピーにインストールします。ローカルディレクトリマーケットプレイスからその場で読み込まれたプラグインが編集内容を取得する方法については、[プラグインキャッシングとファイル解決](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)を参照してください。

280 280

281| ソース | タイプ | フィールド | 注記 |281| ソース | タイプ | フィールド | 注記 |

282| ------------ | --------------------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |282| ------------ | --------------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

283| 相対パス | `string`（例：`"./my-plugin"`） | なし | マーケットプレイスリポジトリ内のローカルディレクトリ。`./` で始まる必要があります。ただし、[`metadata.pluginRoot` の下に裸の名前を記述する](#relative-paths)場合は除きます。Claude Code はパスを `.claude-plugin/` ディレクトリではなく、マーケットプレイスルートを基準に解決します |283| 相対パス | `string`（例：`"./my-plugin"`） | なし | マーケットプレイスリポジトリ内のローカルディレクトリ。`./` で始まる必要があります。ただし、[`metadata.pluginRoot` の下に裸の名前を記述する](#relative-paths)場合は除きます。Claude Code はパスを `.claude-plugin/` ディレクトリではなく、マーケットプレイスルートを基準に解決します |

plugins-reference.md +112 −62

Details

71エージェントの役割、専門知識、および動作を説明する詳細なシステムプロンプト。71エージェントの役割、専門知識、および動作を説明する詳細なシステムプロンプト。

72```72```

73 73

74プラグインエージェントは、`name`、`description`、`model`、`effort`、`maxTurns`、`tools`、`disallowedTools`、`skills`、`memory`、`background`、[`omitClaudeMd`](/docs/ja/sub-agents#supported-frontmatter-fields)、および `isolation` frontmatter フィールドをサポートしています。唯一の有効な `isolation` 値は `"worktree"` です。74<h4 id="plugin-agent-frontmatter">

75 プラグインエージェント frontmatter

76</h4>

78プラグインエージェントファイルは、[サブエージェントファイルと同じ frontmatter フィールド](/docs/ja/sub-agents#supported-frontmatter-fields)を使用しますが、Claude Code はプラグインから来たエージェントの場合、そのうちのいくつかのみを尊重します。

80* **サポート対象**: `name`、`description`、`model`、`effort`、`maxTurns`、`tools`、`disallowedTools`、`skills`、`memory`、`background`、`omitClaudeMd`、`isolation`、`color`、および `experimental`。唯一の有効な `isolation` 値は `"worktree"` です。

81* **セキュリティ上の理由からサポート対象外**: `hooks`、`mcpServers`、および `permissionMode`。Claude Code はプラグインからエージェントを読み込む場合、これらを無視します。これらを使用するには、エージェントファイルを `.claude/agents/` または `~/.claude/agents/` にコピーします。

82* **サポート対象外**: `initialPrompt`。

75 83

~~76セキュリティ上の理由から、プラグイン提供エージェントは `hooks`、`mcpServers`、または `permissionMode` をサポートしていません。~~84プラグインエージェントファイルを `agents/` のサブフォルダーに配置できます。Claude Code は [それらを再帰的に読み込み](/docs/ja/sub-agents#choose-the-subagent-scope)、プラグイン名、各サブフォルダー名、およびファイル名をコロンで結合して、エージェントのスコープ付き名を形成します。たとえば、`my-plugin` という名前のプラグイン内の `agents/review/security.md` は `my-plugin:review:security` として読み込まれます。2 つの設定がその名前を変更します。

86* Frontmatter `name`: ファイル名のみを置き換えるため、`agents/review/security.md` の `name: audit` は `my-plugin:review:audit` として読み込まれます

87* マニフェスト [`agents`](#component-path-fields) フィールド: そこにリストされているファイルはサブフォルダー名なしで読み込まれるため、`"agents": "./custom/review/security.md"` は `my-plugin:security` として読み込まれます

77 88

78Claude Code は、frontmatter に `name` がない場合またはパースに失敗した場合でも、プラグインエージェントを読み込みます。89Claude Code は、frontmatter に `name` がない場合またはパースに失敗した場合でも、プラグインエージェントを読み込みます。

79 90

474 プラグインマニフェストスキーマ485 プラグインマニフェストスキーマ

475</h2>486</h2>

476 487

477`.claude-plugin/plugin.json` ファイルは、プラグインのメタデータと設定を定義します。488`.claude-plugin/plugin.json` ファイルはプラグインのメタデータと設定を定義します。

478 489

479マニフェストはオプションです。省略した場合、Claude Code は[デフォルトの場所](#file-locations-reference)のコンポーネントを自動検出し、ディレクトリ名からプラグイン名を導出します。メタデータまたはカスタムコンポーネントパスを提供する必要がある場合は、マニフェストを使用してください。490マニフェストはオプションです。省略した場合、Claude Code は[デフォルトの場所](#file-locations-reference)のコンポーネントを自動検出し、ディレクトリ名からプラグイン名を導出します。メタデータまたはカスタムコンポーネントパスを提供する必要がある場合は、マニフェストを使用してください。

480 491

527| :----- | :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |538| :----- | :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |

528| `name` | string | ケバブケースの一意の識別子。スペース、制御文字、双方向フォーマット文字を含みません。[マーケットプレイスエントリ](/docs/ja/plugin-marketplaces#plugin-entries)がプラグインを別の名前でリストする場合、マーケットプレイスエントリ名が `enabledPlugins` キーと `/plugin` で使用されます | `"deployment-tools"` |539| `name` | string | ケバブケースの一意の識別子。スペース、制御文字、双方向フォーマット文字を含みません。[マーケットプレイスエントリ](/docs/ja/plugin-marketplaces#plugin-entries)がプラグインを別の名前でリストする場合、マーケットプレイスエントリ名が `enabledPlugins` キーと `/plugin` で使用されます | `"deployment-tools"` |

529 540

530この名前はコンポーネントの名前空間に使用されます。たとえば、UI では、名前が `plugin-dev` のプラグインのエージェント `agent-creator` は `plugin-dev:agent-creator` として表示されます。541この名前はコンポーネントの名前空間化に使用されます。たとえば、UI では、名前が `plugin-dev` のプラグインのエージェント `agent-creator` は `plugin-dev:agent-creator` として表示されます。

531 542

532<h3 id="unrecognized-fields">543<h3 id="unrecognized-fields">

533 認識されないフィールド544 認識されないフィールド

534</h3>545</h3>

535 546

536Claude Code は認識しないトップレベルフィールドを無視します。`plugin.json` に別のエコシステムからのメタデータを保持でき、プラグインは引き続き読み込まれます。これにより、VS Code または Cursor 拡張マニフェスト、npm `package.json`、または MCPB/DXT バンドルマニフェストとして機能する 1 つのマニフェストを保守することが実用的になります。547Claude Code は認識しないトップレベルフィールドを無視します。別のエコシステムからのメタデータを `plugin.json` に保持でき、プラグインは引き続き読み込まれます。これにより、VS Code または Cursor 拡張マニフェスト、npm `package.json`、または MCPB/DXT バンドルマニフェストとして機能する 1 つのマニフェストを保守することが実用的になります。

537 548

538`claude plugin validate` は認識されないフィールドを警告として報告し、エラーではありません。フィールドが認識されたフィールドから 1 文字または 2 文字異なる場合、警告は意図された名前を示唆します。認識されないフィールド警告のみを持つプラグインは検証に合格し、実行時に読み込まれます。549`claude plugin validate` は認識されないフィールドを警告として報告し、エラーではありません。フィールドが認識されたフィールドから 1 文字または 2 文字異なる場合、警告は意図された名前を示唆します。認識されないフィールド警告のみを持つプラグインは検証に合格し、実行時に読み込まれます。

539 550

540Claude Code が認識されたフィールドを処理する方法は、値の型が間違っている場合、フィールドによって異なります。551Claude Code が値の型が間違っている認識されたフィールドを処理する方法は、フィールドによって異なります。

541 552

542* **ほとんどのフィールド**: プラグインは読み込みに失敗します。たとえば、配列ではなく文字列である `keywords` 値は読み込みエラーであり、`claude plugin validate` はそれをエラーとして報告します。553* **ほとんどのフィールド**: プラグインは読み込みに失敗します。たとえば、文字列の代わりに配列である `keywords` 値は読み込みエラーであり、`claude plugin validate` はそれをエラーとして報告します。

543* **`experimental` と `metadata`**: Claude Code は非オブジェクト値を無視し、`claude plugin validate` は警告を報告します。554* **`experimental` と `metadata`**: Claude Code は非オブジェクト値を無視し、`claude plugin validate` は警告を報告します。

544 555

545`--strict` を渡して、警告をエラーとして扱います。CI で使用して、公開前に別のツールのマニフェストから残されたスペルミスのあるフィールド名またはフィールドをキャッチします。ただし、プラグインは実行時に読み込まれます。556`--strict` を渡して、警告をエラーとして扱います。CI で使用して、公開前に別のツールのマニフェストから残された綴り間違いのフィールド名またはフィールドをキャッチします。プラグインは実行時に読み込まれますが。

546 557

547```bash theme={null}558```bash theme={null}

548claude plugin validate ./my-plugin --strict559claude plugin validate ./my-plugin --strict

553</h3>564</h3>

554 565

555| フィールド | 型 | 説明 | 例 |566| フィールド | 型 | 説明 | 例 |

556| :--------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------- |567| :--------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------- |

558| `displayName` | string | `/plugin` ピッカーおよび他の UI サーフェスに表示される人間が読める名前。マーケットプレイスインストール済みプラグインの場合、[マーケットプレイスエントリ](/docs/ja/plugin-marketplaces#optional-plugin-fields)の `displayName` はこの値より優先されます。どちらの場所にも表示名が設定されていない場合、ユーザーは `name` を見ます。`name` とは異なり、スペースと任意の大文字小文字を含むことができます。名前空間またはルックアップには使用されません。 | `"Deployment Tools"` |569| `displayName` | string | `/plugin` ピッカーおよび他の UI サーフェスに表示される人間が読める名前。マーケットプレイスにインストールされたプラグインの場合、[マーケットプレイスエントリ](/docs/ja/plugin-marketplaces#optional-plugin-fields)の `displayName` はこの値より優先されます。どちらの場所にも表示名が設定されていない場合、ユーザーは `name` を見ます。`name` とは異なり、スペースと任意の大文字小文字を含むことができます。名前空間化またはルックアップには使用されません。 | `"Deployment Tools"` |

559| `version` | string | オプション。セマンティックバージョン。これを設定するとプラグインをそのバージョン文字列にピンします。ユーザーはバージョンをバンプしたときのみ更新を受け取ります。[`command` ソース](/docs/ja/plugin-marketplaces#command-sources)を除きます。[プラグインキャッシングとファイル解決](#plugin-caching-and-file-resolution)を参照してください。マーケットプレイスエントリにも設定されている場合、`plugin.json` が優先されます。省略した場合、バージョンは[バージョン管理](#version-management)の次のソースから取得されます。 | `"2.1.0"` |570| `version` | string | オプション。セマンティックバージョン。これを設定するとプラグインをそのバージョン文字列にピン留めするため、ユーザーはバージョンをバンプしたときにのみ更新を受け取ります。[`command` ソース](/docs/ja/plugin-marketplaces#command-sources)またはプラグイン[読み込み中](#plugin-caching-and-file-resolution)を除きます。[バージョン管理](#version-management)を参照してください。マーケットプレイスエントリにも設定されている場合、`plugin.json` が優先されます。省略した場合、バージョンは[バージョン管理](#version-management)の次のソースから取得されます。 | `"2.1.0"` |

561| `author` | object | 著者情報 | `{"name": "Dev Team", "email": "dev@company.com"}` |572| `author` | object | 著者情報 | `{"name": "Dev Team", "email": "dev@company.com"}` |

566| `metadata` | object | 権利付与またはカタログフィールドなど、独自のデータ用のフリーフォームオブジェクト。Claude Code はこれを読まないため、値はプラグインの動作に影響しません。Claude Code は非オブジェクト値を無視し、`claude plugin validate` は警告として報告します。v2.1.222 より前では、Claude Code はキーを[認識されないフィールド](#unrecognized-fields)として扱いました。 | `{"catalogId": "cat-123"}` |577| `metadata` | object | 権利付与またはカタログフィールドなど、独自のデータ用の自由形式オブジェクト。Claude Code はこれを読まないため、値はプラグインの動作に影響しません。Claude Code は非オブジェクト値を無視し、`claude plugin validate` は警告として報告します。v2.1.222 より前では、Claude Code はキーを[認識されないフィールド](#unrecognized-fields)として扱いました。 | `{"catalogId": "cat-123"}` |

568 579

569<h3 id="default-enablement">580<h3 id="default-enablement">

570 デフォルト有効化581 デフォルト有効化

571</h3>582</h3>

572 583

573`plugin.json` で `defaultEnabled: false` を設定して、無効な状態でインストールされるプラグインを配布します。ユーザーは `claude plugin enable <plugin>` または `/plugin` インターフェースでオンにします。外部サービスに接続するなど、ユーザーがオプトインすべきコストまたはスコープを追加するプラグインに使用します。584`plugin.json` で `defaultEnabled: false` を設定して、無効な状態でインストールされるプラグインを配布します。ユーザーは `claude plugin enable <plugin>` または `/plugin` インターフェースでオンにします。外部サービスに接続するものなど、ユーザーがオプトインすべきコストまたはスコープを追加するプラグインに使用します。

574 585

575`defaultEnabled` は、他に何もプラグインの状態を決定していない場合のフォールバックです。2 つのことがそれより優先されます。586`defaultEnabled` は、他に何もプラグインの状態を決定していない場合のフォールバックです。ユーザーの設定と依存関係の要件が優先されます。

576 587

577* **ユーザーの設定**: 任意の設定スコープで `enabledPlugins` のプラグインエントリ。一度書き込まれると、プラグイン更新と再インストール全体で永続化されるため、後のリリースで `defaultEnabled` を変更しても既存ユーザーは反転しません。588* **ユーザーの設定**: 任意の設定スコープで `enabledPlugins` のプラグインのエントリ。一度書き込まれると、プラグイン更新と再インストール全体で永続化されるため、後のリリースで `defaultEnabled` を変更しても既存ユーザーは反転しません。

578* **依存関係要件**: プラグインが別のアクティブなプラグインによって必要とされる場合、Claude Code はインストール時または有効化時に `true` を書き込みます。これにより明示的な設定が与えられるため、独自のデフォルトは適用されなくなります。[依存関係を持つプラグインを有効または無効にする](/docs/ja/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies)を参照してください。589* **依存関係の要件**: プラグインがアクティブな別のプラグインによって必要とされる場合、Claude Code はインストール時または有効化時に `true` を書き込みます。これにより明示的な設定が与えられるため、独自のデフォルトはもはや適用されません。[依存関係を持つプラグインを有効または無効にする](/docs/ja/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies)を参照してください。

579 590

580同じフィールドはプラグインのマーケットプレイスエントリに表示でき、`plugin.json` の値より優先されます。[オプションプラグインフィールド](/docs/ja/plugin-marketplaces#optional-plugin-fields)を参照してください。591同じフィールドはプラグインのマーケットプレイスエントリに表示でき、`plugin.json` の値より優先されます。[オプションプラグインフィールド](/docs/ja/plugin-marketplaces#optional-plugin-fields)を参照してください。

581 592

584</h3>595</h3>

585 596

586| フィールド | 型 | 説明 | 例 |597| フィールド | 型 | 説明 | 例 |

587| :---------------------- | :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |598| :---------------------- | :-------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

601| `dependencies` | array | このプラグインが必要とする他のプラグイン。オプションで semver バージョン制約付き。[プラグイン依存関係バージョンを制約する](/docs/ja/plugin-dependencies)を参照してください | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |612| `dependencies` | array | このプラグインが必要とする他のプラグイン。オプションで semver バージョン制約付き。[プラグイン依存関係バージョンを制約する](/docs/ja/plugin-dependencies)を参照してください | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |

602 613

610 ユーザー設定621 ユーザー設定

611</h3>622</h3>

612 623

613`userConfig` フィールドは、プラグインが有効化されたときに Claude Code がユーザーにプロンプトする値を宣言します。ユーザーに `settings.json` を手動で編集させる代わりに、これを使用してください。624`userConfig` フィールドは、プラグインが有効化されたときに Claude Code がユーザーにプロンプトする値を宣言します。ユーザーに `settings.json` を手動で編集させる代わりにこれを使用してください。

614 625

615```json theme={null}626```json theme={null}

616{627{

633キーは有効な識別子である必要があります。各オプションはこれらのフィールドをサポートします。644キーは有効な識別子である必要があります。各オプションはこれらのフィールドをサポートします。

634 645

635| フィールド | 必須 | 説明 |646| フィールド | 必須 | 説明 |

636| :------------ | :-- | :------------------------------------------------------------------------------- |647| :------------ | :-- | :---------------------------------------------------------------------------------------------------------------------------------------------- |

637| `type` | はい | `string`、`number`、`boolean`、`directory`、または `file` のいずれか |648| `type` | はい | `string`、`number`、`boolean`、`directory`、または `file` のいずれか |

638| `title` | はい | 設定ダイアログに表示されるラベル |649| `title` | はい | 設定ダイアログに表示されるラベル |

639| `description` | はい | フィールドの下に表示されるヘルプテキスト |650| `description` | はい | フィールドの下に表示されるヘルプテキスト |

640| `sensitive` | いいえ | `true` の場合、入力をマスクし、値を `settings.json` の代わりにセキュアストレージに保存します |651| `sensitive` | いいえ | `true` の場合、入力をマスクし、値を `settings.json` の代わりにセキュアストレージに保存します |

641| `required` | いいえ | `true` の場合、フィールドが空の場合は検証が失敗します |652| `required` | いいえ | `true` の場合、フィールドが空の場合は検証が失敗します |

642| `default` | いいえ | ユーザーが何も提供しない場合に使用される値 |653| `default` | いいえ | ユーザーが何も提供しない場合に使用される値 |

643| `options` | いいえ | `string` 型の場合、フィールドが受け入れる値。`/config` でピッカーとして表示されます。Claude Code v2.1.271 以降が必要です |654| `options` | いいえ | `string` 型の場合、フィールドが受け入れる値。`/config` にピッカーとして表示されます。[フィールドを固定オプションに制限する](#limit-a-field-to-fixed-options)を参照してください。Claude Code v2.1.271 以降が必要です |

644| `multiple` | いいえ | `string` 型の場合、文字列の配列を許可します |655| `multiple` | いいえ | `string` 型の場合、文字列の配列を許可します |

645| `min` / `max` | いいえ | `number` 型の境界 |656| `min` / `max` | いいえ | `number` 型の境界 |

646 657

647`sensitive` フィールドと `multiple` リストを除き、有効化された各プラグインの各フィールドは `/config` パネルの行としても表示されます。行には Claude Code v2.1.269 以降が必要です。658`sensitive` フィールドと `multiple` リストを除き、有効な各プラグインの各フィールドは `/config` パネルの行としても表示されます。行には Claude Code v2.1.269 以降が必要です。

648 659

649各値は MCP および LSP サーバーコンフィグとフックコマンドで `${user_config.KEY}` として置換可能です。機密でない値はスキルおよびエージェントコンテンツでも置換できます。すべての値は `CLAUDE_PLUGIN_OPTION_<KEY>` 環境変数としてフックプロセスにエクスポートされます。ここで `<KEY>` はオプションキーを大文字にしたものです。660各値は MCP および LSP サーバー設定とフックコマンドで `${user_config.KEY}` として置換可能です。機密でない値はスキルおよびエージェントコンテンツでも置換できます。すべての値は、`<KEY>` がオプションキーを大文字にしたフックプロセスに `CLAUDE_PLUGIN_OPTION_<KEY>` 環境変数としてエクスポートされます。

650 661

651シェルで実行されるフィールドは `${user_config.*}` を拒否します。設定された値をシェルコマンドに置換すると、シェルはその値が含むものを実行できるため、コンポーネントは[エラー](/docs/ja/errors#plugin-command-references-user-config)で失敗します。拒否された各フィールドには、値を渡す別の方法があります。662シェルで実行されるフィールドは `${user_config.*}` を拒否します。設定された値をシェルコマンドに置換すると、シェルはその値に含まれるものを実行できるため、コンポーネントは[エラー](/docs/ja/errors#plugin-command-references-user-config)で失敗します。拒否された各フィールドには、値を渡す別の方法があります。

652 663

653| 拒否されたフィールド | 値を渡す方法 |664| 拒否されたフィールド | 値を渡す方法 |

654| :--------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- |665| :--------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------- |

655| シェル形式フックコマンド | `args` で[exec 形式](/docs/ja/hooks#exec-form-and-shell-form)を使用するか、フックの環境から `CLAUDE_PLUGIN_OPTION_<KEY>` を読み取ります |666| シェル形式フックコマンド | [exec 形式](/docs/ja/hooks#exec-form-and-shell-form)を `args` で使用するか、フックの環境から `CLAUDE_PLUGIN_OPTION_<KEY>` を読み取ります |

656| [Monitor](#monitors)コマンド | スクリプトの設定ファイルから値を読み取ります |667| [Monitor](#monitors)コマンド | スクリプトの設定ファイルから値を読み取ります |

658 669

660 671

661機密でない値は、ユーザー `settings.json` の [`pluginConfigs`](/docs/ja/settings-reference#pluginconfigs) キーの下に `pluginConfigs[<plugin-id>].options` として保存されます。672機密でない値は、ユーザー `settings.json` の [`pluginConfigs`](/docs/ja/settings-reference#pluginconfigs) キーの下に `pluginConfigs[<plugin-id>].options` として保存されます。

662 673

663macOS では、Claude Code は機密値を macOS キーチェーンに保存し、キーチェーンが書き込みを拒否した場合は `~/.claude/.credentials.json` にフォールバックします。サポートされているキーチェーンのないプラットフォームでは、`~/.claude/.credentials.json` に保存されます。キーチェーンストレージは OAuth トークンと共有され、約 2 KB の合計制限があるため、機密値は小さく保ってください。674macOS では、Claude Code は macOS キーチェーンに機密値を保存し、キーチェーンが書き込みを拒否した場合は `~/.claude/.credentials.json` にフォールバックします。サポートされているキーチェーンのないプラットフォームでは、`~/.claude/.credentials.json` に保存されます。キーチェーンストレージは OAuth トークンと共有され、約 2 KB の合計制限があるため、機密値を小さく保ちます。

664 675

665Claude Code は 3 つの設定ソースからのみすべての `pluginConfigs` 値を読み取ります。676Claude Code は 3 つの設定ソースからのみすべての `pluginConfigs` 値を読み取ります。

666 677

668* **`--settings`**: CLI フラグまたは SDK インライン設定679* **`--settings`**: CLI フラグまたは SDK インライン設定

669* **管理設定**: [組織制御ポリシー](/docs/ja/permissions#managed-settings)680* **管理設定**: [組織制御ポリシー](/docs/ja/permissions#managed-settings)

670 681

671複数のソースが同じキーを設定する場合、管理設定が優先され、次に `--settings`、次にユーザー設定が優先されます。このリストから削除できる唯一のソースはユーザー設定です。`user` なしで [`--setting-sources`](/docs/ja/cli-reference#cli-flags) を渡すと、Claude Code はそれらをスキップします。管理設定と `--settings` は、渡すものが何であれ保持されます。SDK の [`settingSources`](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)オプションは同じリストを設定します。682複数のソースが同じキーを設定する場合、管理設定が優先され、次に `--settings`、次にユーザー設定が優先されます。このリストから削除できる唯一のソースはユーザー設定です。`--setting-sources` を `user` なしで渡し、Claude Code はそれらをスキップします。管理設定と `--settings` は渡すものが何であれ保持されます。SDK の [`settingSources`](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)オプションは同じリストを設定します。

683

684プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` のエントリは無視されます。両方のファイルはワークスペースに存在するため、クローンされたリポジトリはそこに値を提供でき、それらの値はプラグインフックコマンド、MCP サーバー設定、LSP コマンド、およびモニターコマンドに流れます。v2.1.207 より前では、これらのエントリが読み取られました。制限は `pluginConfigs` に固有です。[`enabledPlugins`](/docs/ja/settings-reference#enabledplugins)はまだプロジェクトおよびローカル設定を尊重します。

685

686<h4 id="limit-a-field-to-fixed-options">

687 フィールドを固定オプションに制限する

688</h4>

689

690`userConfig` フィールドに `options` を設定して、ユーザーが固定リストからその値を選択するようにします。

691

692`tone` フィールドを 3 つのオプションに制限するには、`options` にそれらをリストし、`default` をそのうちの 1 つに設定します。

693

694```json theme={null}

695{

696 "userConfig": {

697 "tone": {

698 "type": "string",

699 "title": "Tone",

700 "description": "Voice for generated replies",

701 "options": ["neutral", "warm", "formal"],

702 "default": "neutral"

703 }

704 }

705}

706```

707

708任意のフィールドで `options` を宣言する場合、Claude Code v2.1.271 より前のバージョンのユーザーはプラグインを読み込むことができません。

709

710フィールドに `options` を設定する場合、これらのルールに従います。

711

712* `type` を `string` に設定します

713* `multiple` または `sensitive` を `true` に設定しません

714* `default` をオプションの 1 つに設定します

715* `default` を設定しない場合は、`required` を `true` に設定します

716* 少なくとも 1 つのオプションをリストし、各 1 〜 64 文字の長さです

717* オプションをスペースで開始または終了しません

718* 制御文字、非表示文字、テキスト方向を変更する文字、またはオプション内の通常のスペース以外のスペースを使用しません

719* 異なる大文字小文字でも同じオプションを 2 回リストしません

672 720

673プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` のエントリは無視されます。両方のファイルはワークスペースに存在するため、クローンされたリポジトリはそこに値を提供でき、それらの値はプラグインフックコマンド、MCP サーバーコンフィグ、LSP コマンド、およびモニターコマンドに流れます。v2.1.207 より前では、これらのエントリが読み取られました。制限は `pluginConfigs` に固有です。[`enabledPlugins`](/docs/ja/settings-reference#enabledplugins)はまだプロジェクトおよびローカル設定を尊重します。721これらのルールのいずれかを破った場合、プラグインは読み込みに失敗します。`claude plugin validate` を実行して、どのフィールドがどのルールを破るかを確認してください。

674 722

675<h3 id="channels">723<h3 id="channels">

676 チャネル724 チャネル

677</h3>725</h3>

678 726

679`channels` フィールドを使用すると、プラグインは 1 つ以上のメッセージチャネルを宣言でき、コンテンツを会話に注入します。各チャネルはプラグインが提供する MCP サーバーにバインドされます。727`channels` フィールドを使用すると、プラグインは会話にコンテンツを注入する 1 つ以上のメッセージチャネルを宣言できます。各チャネルはプラグインが提供する MCP サーバーにバインドされます。

680 728

681```json theme={null}729```json theme={null}

682{730{

709 757

710カスタムパスがプラグインのデフォルトディレクトリを置き換えるか拡張するかは、フィールドによって異なります。758カスタムパスがプラグインのデフォルトディレクトリを置き換えるか拡張するかは、フィールドによって異なります。

711 759

712* **デフォルトを置き換え**: `commands`、`agents`、`workflows`、`outputStyles`、`experimental.themes`、`experimental.monitors`。たとえば、マニフェストが `commands` を指定する場合、デフォルト `commands/` ディレクトリはスキャンされません。デフォルトを保持して追加するには、明示的にリストします。`"commands": ["./commands/", "./extras/"]`760* **デフォルトを置き換え**: `commands`、`agents`、`workflows`、`outputStyles`、`experimental.themes`、`experimental.monitors`。たとえば、マニフェストが `commands` を指定する場合、デフォルト `commands/` ディレクトリはスキャンされません。デフォルトを保持してさらに追加するには、明示的にリストします。`"commands": ["./commands/", "./extras/"]`

713* **デフォルトに追加**: `skills`。デフォルト `skills/` ディレクトリは常にスキャンされ、`skills` にリストされているディレクトリはそれと一緒に読み込まれます。例外: [ソースがマーケットプレイスルートに解決される](/docs/ja/plugin-marketplaces#advanced-plugin-entries)マーケットプレイスエントリの場合、特定のサブディレクトリを宣言するとデフォルト `skills/` スキャンが置き換えられます761* **デフォルトに追加**: `skills`。デフォルト `skills/` ディレクトリは常にスキャンされ、`skills` にリストされているディレクトリはそれと一緒に読み込まれます。例外: [ソースがマーケットプレイスルートに解決される](/docs/ja/plugin-marketplaces#advanced-plugin-entries)[マーケットプレイスエントリ](/docs/ja/plugin-marketplaces#advanced-plugin-entries)の場合、特定のサブディレクトリを宣言するとデフォルト `skills/` スキャンが置き換わります

714* **独自のマージルール**: [フック](#hooks)、[MCP サーバー](#mcp-servers)、および[LSP サーバー](#lsp-servers)。各セクションで複数のソースがどのように結合されるかを参照してください762* **独自のマージルール**: [フック](#hooks)、[MCP サーバー](#mcp-servers)、および [LSP サーバー](#lsp-servers)。各セクションで複数のソースがどのように結合されるかを参照してください

715 763

716プラグインがデフォルトフォルダと一致するマニフェストキーの両方を持つ場合、Claude Code は `claude plugin list` と `/plugin` 詳細ビューで無視されたフォルダについて警告します。プラグインはマニフェストパスを使用して読み込まれます。マニフェストキーがデフォルトフォルダを指す場合、Claude Code は警告しません。たとえば `"commands": ["./commands/deploy.md"]` の場合、そのパスはフォルダを明示的に名前付けするためです。764プラグインにデフォルトフォルダと一致するマニフェストキーの両方がある場合、Claude Code は `claude plugin list` と `/plugin` 詳細ビューで無視されたフォルダについて警告します。プラグインはマニフェストパスを使用して引き続き読み込まれます。マニフェストキーがデフォルトフォルダを指す場合、Claude Code は警告しません。たとえば `"commands": ["./commands/deploy.md"]` は、そのパスがフォルダを明示的に名前付けするためです。

717 765

718すべてのパスフィールドについて。766すべてのパスフィールドについて。

719 767

720* すべてのパスはプラグインルートに相対的で `./` で始まる必要があります。ただし、`skills` フィールドは `.` も受け入れます768* すべてのパスはプラグインルートに相対的で `./` で始まる必要があります。ただし、`skills` フィールドは `.` も受け入れます

721 * `"."` と `"./"` の両方はプラグインルート自体を示します769 * `"."` と `"./"` の両方はプラグインルート自体を示します

722 * v2.1.221 より前では、`"."` はマニフェスト検証に失敗し、プラグインは読み込まれなかったため、以前のバージョンをサポートするには `"./"` を使用してください770 * v2.1.221 より前では、`"."` はマニフェスト検証に失敗し、プラグインは読み込まれなかったため、`"./"` を使用して以前のバージョンをサポートします

723* カスタムパスのコンポーネントは同じ命名および名前空間ルールを使用します771* カスタムパスのコンポーネントは、エージェントファイルを除き、同じ命名および名前空間化ルールを使用します。エージェント名がどのように機能するかについては[エージェント](#agents)を参照してください

724* 複数のパスは配列として指定できます772* 複数のパスは配列として指定できます

725* スキルパスは `SKILL.md` を直接含むディレクトリを指すことができます。たとえば、プラグインルートの場合は `"skills": ["."]`773* スキルパスは `SKILL.md` を直接含むディレクトリを指すことができます。たとえば、プラグインルートの場合は `"skills": ["."]`

726 * Claude Code はスキルの呼び出し名を `SKILL.md` のフロントマター `name` フィールドから取得するため、インストールディレクトリの名前が何であれ、名前は安定したままです774 * Claude Code は `SKILL.md` のフロントマター `name` フィールドからスキルの呼び出し名を取得するため、インストールディレクトリの名前が何であれ、名前は安定したままです

727 * フロントマターで `name` が設定されていない場合、Claude Code はディレクトリベース名にフォールバックします775 * フロントマターで `name` が設定されていない場合、Claude Code はディレクトリベース名にフォールバックします

728 776

729プラグインがルートに `SKILL.md` を持ち、`skills/` サブディレクトリがなく、`skills` マニフェストフィールドがない場合、自動的に単一スキルプラグインとして読み込まれます。このレイアウトの場合、`plugin.json` で `"skills": ["./"]` を設定する必要はありません。777ルートに `SKILL.md` があり、`skills/` サブディレクトリがなく、`skills` マニフェストフィールドがないプラグインは、単一スキルプラグインとして自動的に読み込まれます。このレイアウトの場合、`plugin.json` で `"skills": ["./"]` を設定する必要はありません。

730 778

731**パスの例**:779**パスの例**:

732 780

747 環境変数795 環境変数

748</h3>796</h3>

749 797

750Claude Code は 3 つのパス参照用変数を提供します。798Claude Code はパスを参照するための 3 つの変数を提供します。

751 799

752| 変数 | 解決先 | 用途 |800| 変数 | 解決先 | 用途 |

753| :---------------------- | :------------------------------------------------------------------ | :----------------------------------------------------------- |801| :---------------------- | :------------------------------------------------------------------ | :-------------------------------------------------------------- |

754| `${CLAUDE_PLUGIN_ROOT}` | プラグインのインストールディレクトリへの絶対パス | プラグインにバンドルされたスクリプト、バイナリ、設定ファイル |802| `${CLAUDE_PLUGIN_ROOT}` | プラグインのインストールディレクトリへの絶対パス | プラグインにバンドルされたスクリプト、バイナリ、および設定ファイル |

755| `${CLAUDE_PLUGIN_DATA}` | プラグイン更新を超えて存続する[永続ディレクトリ](#persistent-data-directory)。最初の参照時に作成されます | `node_modules` または Python 仮想環境などのインストール済み依存関係、生成されたコード、キャッシュ |803| `${CLAUDE_PLUGIN_DATA}` | プラグイン更新を超えて存続する[永続ディレクトリ](#persistent-data-directory)。最初の参照時に作成されます | `node_modules` または Python 仮想環境などのインストール済み依存関係、生成されたコード、およびキャッシュ |

756| `${CLAUDE_PROJECT_DIR}` | プロジェクトルート | プロジェクトローカルスクリプトと設定ファイル |804| `${CLAUDE_PROJECT_DIR}` | プロジェクトルート | プロジェクトローカルスクリプトおよび設定ファイル |

757 805

7583 つすべてはフックプロセスおよび MCP と LSP サーバーサブプロセスに環境変数としてエクスポートされます。どのフィールドがそれらをインラインで置換するかは、プラグインコンポーネントによって異なります。8063 つすべてが環境変数としてフックプロセスおよび MCP と LSP サーバーサブプロセスにエクスポートされます。これらはメインセッションまたはサブエージェントで Bash ツールを通じて Claude が実行するコマンドの環境には存在しません。プラグインコンテンツで、プレースホルダーを書き込み、Claude Code はコンテンツを読み込むときにパスをインラインで置換します。どのフィールドがそれらをインラインで置換するかは、プラグインコンポーネントによって異なります。

759 807

760| プラグインコンポーネント | プレースホルダーが解決されるフィールド |808| プラグインコンポーネント | プレースホルダーが解決されるフィールド |

761| :------------------------- | :--------------------------------------- |809| :------------------------- | :--------------------------------------- |

767 815

768フックコマンドでは、各パスが 1 つの引数として引用符なしで渡されるように、`args` で[exec 形式](/docs/ja/hooks#exec-form-and-shell-form)を使用してください。シェル形式フックおよびモニターコマンドでは、変数を二重引用符で囲みます。`"${CLAUDE_PROJECT_DIR}/scripts/server.sh"` のように。このシェル形式フックはプラグインにバンドルされたスクリプトを実行します。816フックコマンドで、[exec 形式](/docs/ja/hooks#exec-form-and-shell-form)を `args` で使用して、各パスが引用符なしで 1 つの引数として渡されるようにします。シェル形式フックおよびモニターコマンドで、`"${CLAUDE_PROJECT_DIR}/scripts/server.sh"` のように変数をダブルクォートで囲みます。このシェル形式フックはプラグインにバンドルされたスクリプトを実行します。

769 817

770```json theme={null}818```json theme={null}

771{819{

784}832}

785```833```

786 834

787`${CLAUDE_PLUGIN_ROOT}` はプラグインが更新されるときに変更されます。前のバージョンのディレクトリは更新後の猶予期間ディスク上に残りますが、それを一時的なものとして扱い、そこに状態を書き込まないでください。[プラグインキャッシングとファイル解決](#plugin-caching-and-file-resolution)を参照してください。クリーンアップセマンティクスについては[プラグインキャッシング](#plugin-caching-and-file-resolution)を参照してください。835コピーされたプラグインの場合、`${CLAUDE_PLUGIN_ROOT}` はプラグインが更新されるときに変更されます。前のバージョンのディレクトリは更新後の猶予期間ディスク上に残りますが、それを一時的なものとして扱い、そこに状態を書き込まないでください。ローカルディレクトリマーケットプレイスから読み込まれたプラグインの場合、変数は安定したソースディレクトリを指します。どのプラグインがコピーされるか、およびクリーンアップセマンティクスについては、[プラグインキャッシング](#plugin-caching-and-file-resolution)を参照してください。

788 836

789プラグインがセッション中に更新される場合、フックコマンド、モニター、MCP サーバー、および LSP サーバーは前のバージョンのパスを使用し続けます。`/reload-plugins` を実行して、フック、MCP サーバー、および LSP サーバーを新しいパスに切り替えます。モニターはセッション再開が必要です。インタラクティブターミナルのないセッションでは、リロードはプラグイン MCP サーバーを次のセッションまで古いパスに残します。837コピーされたプラグインがセッション中に更新される場合、フックコマンド、モニター、MCP サーバー、および LSP サーバーは前のバージョンのパスを使用し続けます。`/reload-plugins` を実行して、フック、MCP サーバー、および LSP サーバーを新しいパスに切り替えます。モニターはセッション再開が必要です。インタラクティブターミナルのないセッションでは、リロードはプラグイン MCP サーバーを次のセッションまで古いパスに残します。

790 838

791`command` ソースを持つプラグインの場合、Claude Code は[プラグイン自体を再実行](/docs/ja/plugin-marketplaces#when-claude-code-re-runs-the-command)できます。839`command` ソースを持つプラグインの場合、Claude Code は[プラグイン自体を再読み込みできます](/docs/ja/plugin-marketplaces#when-claude-code-re-runs-the-command)。

792 840

793MCP サーバーは実行時にセッションの作業ディレクトリを読み取るために `roots/list` リクエストを呼び出すこともできます。[`roots/list` が返すもの、および Claude Code がサーバーに変更を通知するタイミング](/docs/ja/mcp#option-3-add-a-local-stdio-server)を参照してください。841MCP サーバーは `roots/list` リクエストを呼び出して、実行時にセッションの作業ディレクトリを読み取ることもできます。[`roots/list` が返すもの、および Claude Code がサーバーに変更を通知するとき](/docs/ja/mcp#option-3-add-a-local-stdio-server)を参照してください。

794 842

795<h4 id="persistent-data-directory">843<h4 id="persistent-data-directory">

796 永続データディレクトリ844 永続データディレクトリ

797</h4>845</h4>

798 846

799`${CLAUDE_PLUGIN_DATA}` ディレクトリは `~/.claude/plugins/data/{id}/` に解決されます。ここで `{id}` はプラグイン識別子で、`a-z`、`A-Z`、`0-9`、`_`、および `-` 以外の文字は `-` に置き換えられます。`formatter@my-marketplace` としてインストールされたプラグインの場合、ディレクトリは `~/.claude/plugins/data/formatter-my-marketplace/` です。847`${CLAUDE_PLUGIN_DATA}` ディレクトリは `~/.claude/plugins/data/{id}/` に解決されます。ここで `{id}` はプラグイン識別子で、`a-z`、`A-Z`、`0-9`、`_`、および `-` の外の文字は `-` に置き換えられます。`formatter@my-marketplace` としてインストールされたプラグインの場合、ディレクトリは `~/.claude/plugins/data/formatter-my-marketplace/` です。

800 848

801一般的な用途は、言語依存関係を 1 回インストールし、セッションとプラグイン更新全体で再利用することです。Python 依存関係、Yarn または pnpm でロックされた依存関係、およびライフサイクルスクリプトを実行する必要があるパッケージに使用します。マーケットプレイスインストール済みプラグインの場合、それが必要ない場合があります。Claude Code はプラグインをキャッシュするときに、適格な[Node.js パッケージ依存関係](#node-js-package-dependencies)を自動的にインストールします。849一般的な用途は、言語依存関係を 1 回インストールし、セッションとプラグイン更新全体で再利用することです。Python 依存関係、Yarn または pnpm でロックされた依存関係、およびライフサイクルスクリプトを実行する必要があるパッケージに使用します。マーケットプレイスにインストールされたプラグインの場合、それをまったく必要としない場合があります。Claude Code はキャッシュ時に適格な[Node.js パッケージ依存関係](#node-js-package-dependencies)を自動的にインストールします。

802 850

803データディレクトリは単一のプラグインバージョンより長く存続するため、ディレクトリ存在チェックのみでは、更新がプラグインの依存関係マニフェストを変更したときを検出できません。推奨パターンはバンドルされたマニフェストをデータディレクトリのコピーと比較し、異なる場合は再インストールします。851データディレクトリは単一のプラグインバージョンより長く存続するため、ディレクトリ存在チェックだけでは、更新がプラグインの依存関係マニフェストを変更したときを検出できません。推奨パターンはバンドルされたマニフェストをデータディレクトリのコピーと比較し、異なる場合は再インストールします。

804 852

805この `SessionStart` フックは最初の実行時に `node_modules` をインストールし、プラグイン更新に変更された `package.json` が含まれるたびに再度インストールします。853この `SessionStart` フックは最初の実行時に `node_modules` をインストールし、プラグイン更新に変更された `package.json` が含まれるたびに再度インストールします。

806 854

821}869}

822```870```

823 871

824`diff` はストレージコピーが見つからないか、バンドルされたものと異なる場合にゼロ以外で終了し、最初の実行と依存関係変更更新の両方をカバーします。`npm install` が失敗した場合、末尾の `rm` はコピーされたマニフェストを削除して、次のセッションが再試行されるようにします。872`diff` は保存されたコピーが見つからないか、バンドルされたコピーと異なる場合にゼロ以外で終了し、最初の実行と依存関係変更更新の両方をカバーします。`npm install` が失敗した場合、末尾の `rm` はコピーされたマニフェストを削除して、次のセッションが再試行されるようにします。

825 873

826`${CLAUDE_PLUGIN_ROOT}` にバンドルされたスクリプトは、永続化された `node_modules` に対して実行できます。874`${CLAUDE_PLUGIN_ROOT}` にバンドルされたスクリプトは、永続化された `node_modules` に対して実行できます。

827 875

839}887}

840```888```

841 889

842データディレクトリは、プラグインをインストールされている最後のスコープからアンインストールするときに自動的に削除されます。`/plugin` インターフェースはディレクトリサイズを表示し、削除前にプロンプトします。CLI はデフォルトで削除します。[`--keep-data`](#plugin-uninstall)を渡して保持します。890データディレクトリは、最後のスコープからプラグインをアンインストールするときに自動的に削除されます。`/plugin` インターフェースはディレクトリサイズを表示し、削除前にプロンプトします。CLI はデフォルトで削除します。[`--keep-data`](#plugin-uninstall)を渡して保持します。

843 891

844***892***

845 893

959├── agents/ # Subagent 定義1007├── agents/ # Subagent 定義

960│ ├── security-reviewer.md1008│ ├── security-reviewer.md

961│ ├── performance-tester.md1009│ ├── performance-tester.md

962│ └── compliance-checker.md1010│ ├── compliance-checker.md

1011│ └── review/ # ここのエージェントは enterprise-plugin:review:<name> として読み込まれます

1012│ └── accessibility.md

963├── workflows/ # ワークフロースクリプト1013├── workflows/ # ワークフロースクリプト

964│ └── release-audit.js1014│ └── release-audit.js

965├── output-styles/ # 出力スタイル定義1015├── output-styles/ # 出力スタイル定義

1005| **テーマ** | `themes/` | カラーテーマ定義 |1055| **テーマ** | `themes/` | カラーテーマ定義 |

prompt-caching.md +1 −1

Details

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

prompt-library.md +1 −1

Details

1384* [Anthropic チームが Claude Code をどのように使用しているか](https://claude.com/blog/how-anthropic-teams-use-claude-code): エンジニアリング、プロダクト、デザイン、データチームからの実際のワークフロー。[法務](https://claude.com/blog/how-anthropic-uses-claude-legal)、[マーケティング](https://claude.com/blog/how-anthropic-uses-claude-marketing)、[サイバーセキュリティ](https://claude.com/blog/how-anthropic-uses-claude-cybersecurity)の詳細なダイブ1384* [Anthropic チームが Claude Code をどのように使用しているか](https://claude.com/blog/how-anthropic-teams-use-claude-code): エンジニアリング、プロダクト、デザイン、データチームからの実際のワークフロー。[法務](https://claude.com/blog/how-anthropic-uses-claude-legal)、[マーケティング](https://claude.com/blog/how-anthropic-uses-claude-marketing)、[サイバーセキュリティ](https://claude.com/blog/how-anthropic-uses-claude-cybersecurity)の詳細なダイブ

1385* [agentic coding スケーリングガイド](https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf): エンタープライズ採用ガイド1385* [agentic coding スケーリングガイド](https://resources.anthropic.com/hubfs/Scaling%20agentic%20coding%20across%20your%20organization.pdf): エンタープライズ採用ガイド

1386 1386

1387これらのパターンのビデオウォークスルーについては、Anthropic Academy の無料 [Claude Code in Action](https://anthropic.skilljar.com/claude-code-in-action)コースを参照してください。1387これらのパターンのビデオウォークスルーについては、[Claude Academy](https://academy.claude.com/) の無料 [Claude Code in Action](https://academy.claude.com/courses/claude-code-in-action) コースを参照してください。

1388 1388

1389<h2 id="related-resources">1389<h2 id="related-resources">

1390 関連リソース1390 関連リソース

quickstart.md +2 −1

Details

377 ヘルプを取得する377 ヘルプを取得する

378</h2>378</h2>

379 379

380* **Claude Code 内**：`/help` を入力するか、「how do I...」と質問する380* **Claude Code 内**：`/help` を入力するか、「how do I」という質問をする

381* **ドキュメント**：ここにいます！他のガイドを参照してください381* **ドキュメント**：ここにいます！他のガイドを参照してください

382* **コース**：[Claude Code 101](https://academy.claude.com/courses/claude-code-101) と [Claude Academy](https://academy.claude.com/) の他の無料のセルフペースコースを受講する

382* **コミュニティ**：[Discord](https://www.anthropic.com/discord) に参加してヒントとサポートを得る383* **コミュニティ**：[Discord](https://www.anthropic.com/discord) に参加してヒントとサポートを得る

remote-control.md +1 −1

Details

187* **`/teleport` でセッションをプルする**: [クラウドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)をターミナルに `/teleport` でプルする場合、接続されたデバイスはプルされた会話の以前の履歴を受け取りません。双方向の新しいメッセージはプルされた会話に対して行き来し、これはターミナルで開いている会話になります。187* **`/teleport` でセッションをプルする**: [クラウドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)をターミナルに `/teleport` でプルする場合、接続されたデバイスはプルされた会話の以前の履歴を受け取りません。双方向の新しいメッセージはプルされた会話に対して行き来し、これはターミナルで開いている会話になります。

188* **他のセッションからのメッセージ**: [クロスセッションメッセージング](/docs/ja/cross-session-messaging)では、同じ接続が異なるマシン上の独自のセッション間のメッセージと [Claude Code on the web](/docs/ja/claude-code-on-the-web) セッションからのメッセージを、Remote Control トラフィックの残りのように Anthropic サーバーを通じて運びます。[他のマシンのメッセージセッション](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)は配信ルールをカバーし、[インバウンドメッセージを制御](/docs/ja/cross-session-messaging#control-inbound-messages)はインバウンドコントロールをカバーします。Claude Code v2.1.224 以降が必要です。188* **他のセッションからのメッセージ**: [クロスセッションメッセージング](/docs/ja/cross-session-messaging)では、同じ接続が異なるマシン上の独自のセッション間のメッセージと [Claude Code on the web](/docs/ja/claude-code-on-the-web) セッションからのメッセージを、Remote Control トラフィックの残りのように Anthropic サーバーを通じて運びます。[他のマシンのメッセージセッション](/docs/ja/cross-session-messaging#message-sessions-on-other-machines)は配信ルールをカバーし、[インバウンドメッセージを制御](/docs/ja/cross-session-messaging#control-inbound-messages)はインバウンドコントロールをカバーします。Claude Code v2.1.224 以降が必要です。

189* **ターン中に送信されたプロンプト**: 現在のターンが終了する前に接続されたデバイスからプロンプトを送信する場合、Claude Code はそれをキューに入れ、そのターンが終了した後、デバイスのトランスクリプトに保持します。189* **ターン中に送信されたプロンプト**: 現在のターンが終了する前に接続されたデバイスからプロンプトを送信する場合、Claude Code はそれをキューに入れ、そのターンが終了した後、デバイスのトランスクリプトに保持します。

190* **変更の差分**: セッションのディレクトリが git リポジトリにある場合、接続されたデバイスの差分ペインはコミットされていない変更の差分を表示します。デバイスは接続を通じて差分をリクエストし、Claude Code はマシンで計算します。作業ツリーがクリーンな場合、Claude Code は代わりにデフォルトブランチから分岐した以来のブランチの変更を提供します。v2.1.247 より前では、Claude Code は `claude remote-control` で提供されるセッションでのみ接続されたデバイスに差分を報告していました。190* **変更の差分**: セッションのディレクトリが git リポジトリにある場合、接続されたデバイスの差分ペインはコミットされていない変更の差分を表示します。デバイスは接続を通じて差分をリクエストし、Claude Code はマシンで計算します。リポジトリのデフォルトブランチより先にコミットがあるブランチでは、ペインはブランチがそこから分岐してからの変更を表示します。これには、コミットされていない編集が含まれます。デフォルトブランチ自体、またはそれより先にないブランチでは、ペインはコミットされていない変更のみを表示します。v2.1.247 より前では、Claude Code は `claude remote-control` で提供されるセッションでのみ接続されたデバイスに差分を報告していました。

191* **モデル**: 接続されたデバイスから[モデル](/docs/ja/model-config)を選択する場合、Claude Code はセッションをそのモデルで実行します。ターミナルの `/model` ピッカー、`/status`、および `/config` はそのモデルを表示します。Claude Code v2.1.238 以降が必要です。191* **モデル**: 接続されたデバイスから[モデル](/docs/ja/model-config)を選択する場合、Claude Code はセッションをそのモデルで実行します。ターミナルの `/model` ピッカー、`/status`、および `/config` はそのモデルを表示します。Claude Code v2.1.238 以降が必要です。

192 * デバイスのモデルコントロールから選択したモデルは現在のセッションのみに適用されます。デバイスから対話型セッションに `/model <name>` を送信する場合、Claude Code は新しいセッションのデフォルトも設定します。192 * デバイスのモデルコントロールから選択したモデルは現在のセッションのみに適用されます。デバイスから対話型セッションに `/model <name>` を送信する場合、Claude Code は新しいセッションのデフォルトも設定します。

193 * Claude Code が認識しない名前（例えば、モデル ID が予期される場所の表示名）を送信する場合、Claude Code は[ピックを拒否](/docs/ja/errors#model-is-not-a-recognized-model-id)し、セッションは現在のモデルを保持します。v2.1.260 より前では、Claude Code はデバイスのモデルコントロールから認識されないピックを保存し、次のメッセージは失敗していました。193 * Claude Code が認識しない名前（例えば、モデル ID が予期される場所の表示名）を送信する場合、Claude Code は[ピックを拒否](/docs/ja/errors#model-is-not-a-recognized-model-id)し、セッションは現在のモデルを保持します。v2.1.260 より前では、Claude Code はデバイスのモデルコントロールから認識されないピックを保存し、次のメッセージは失敗していました。

security-guidance.md +6 −5

Details

31/plugin install security-guidance@claude-plugins-official31/plugin install security-guidance@claude-plugins-official

32```32```

33 33

34`/plugin` はインタラクティブパネルを開き、ターミナル CLI でのみ利用可能です。Claude が `/plugin` がこの環境では利用できないと報告した場合、別の方法でインストールしてください：34`/plugin` はターミナル CLI でインタラクティブパネルを開きます。Claude が `/plugin` がこの環境では利用できないと報告した場合、別の方法でインストールしてください：

35 35

36* **Claude デスクトップアプリ、ローカルまたは SSH セッション**：プロンプトの横にある **+** ボタンをクリックして[プラグインブラウザ](/docs/ja/desktop#install-plugins)を開き、**Plugins** をクリックしてから **Add plugin** をクリックします36* **Claude デスクトップアプリ、ローカルまたは SSH セッション**：プロンプトの横にある **+** ボタンをクリックして[プラグインブラウザ](/docs/ja/desktop#install-plugins)を開き、**Plugins** をクリックしてから **Add plugin** をクリックします

37* **クラウドセッション**：[クラウドセッションと共有リポジトリで有効化](#enable-in-cloud-sessions-and-shared-repositories)に示すように、`.claude/settings.json` でプラグインを宣言します37* **VS Code 拡張機能**：[**Manage plugins** ダイアログ](/docs/ja/vs-code#manage-plugins)からインストールします

38* **クラウドセッション**：claude.ai アカウントでプラグインを有効化して、Claude Code が[同期されたプラグイン](/docs/ja/plugins-reference#synced-plugins)として読み込むようにします。クラウドセッションは、ユーザー設定またはリポジトリの `.claude/settings.json` からプラグインを読み込みません。[セットアップから引き継がれるもの](/docs/ja/cloud-environments#what-carries-over-from-your-setup)で説明されています

38 39

39ターミナルインストールはスコープを求めます。ユーザースコープを選択して、プラグインをユーザー設定に書き込み、このマシンで開始するすべての新しいローカルセッションで読み込まれるようにします。40ターミナルインストールはスコープを求めます。ユーザースコープを選択して、プラグインをユーザー設定に書き込み、このマシンで開始するすべての新しいローカルセッションで読み込まれるようにします。

40 41

45 46

46インストール概要を確認してください。`Run /reload-plugins to activate.` と報告された場合、[プラグイン変更を再起動なしで適用](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を参照して、現在のセッションでプラグインを有効化してください。47インストール概要を確認してください。`Run /reload-plugins to activate.` と報告された場合、[プラグイン変更を再起動なしで適用](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を参照して、現在のセッションでプラグインを有効化してください。

47 48

~~48<h3 id="enable-in-cloud-sessions-and-shared-repositories">~~49<h3 id="enable-for-your-team-in-local-sessions">

~~49 クラウドセッションと共有リポジトリで有効化する~~50 ローカルセッションでチームに対して有効化する

50</h3>51</h3>

51 52

52ユーザースコープのプラグインは、これらのセッションがマシンではなくクラウドで実行されるため、[クラウドセッション](/docs/ja/claude-code-on-the-web) には引き継がれません。そこで有効化するか、リポジトリをクローンするすべてのユーザーに対して有効化するには、プロジェクトのチェックイン設定で宣言します：53リポジトリで開始するローカルセッションでプラグインをオンにするには、プロジェクトのチェックイン設定で宣言します：

53 54

54```json .claude/settings.json theme={null}55```json .claude/settings.json theme={null}

55{56{

self-hosted-environments-deploy.md +5 −5

Details

120 git を設定する120 git を設定する

121</h2>121</h2>

122 122

123ランナーはリポジトリチェックアウトを管理しますが、デフォルトでは git ID または認証情報を設定しません。ランナーのイメージとプロセス環境を制御するため、git 設定を制御します。 2 つのアプローチのいずれかを選択してください：123ランナーはリポジトリチェックアウトを管理しますが、デフォルトでは git ID または認証情報を設定しません。ランナーのイメージとプロセス環境を制御するため、git 設定を制御します。2 つのアプローチのいずれかを選択してください：

124 124

125* **ランナーに git を設定させる**：`--configure-git` でランナーを開始して、Anthropic ホストセッションが使用する同じ ID とコミット署名設定を書き込ませます125* **ランナーに git を設定させる**：`--configure-git` でランナーを開始して、Anthropic ホストセッションが使用する同じ ID とコミット署名設定を書き込ませます

126* **イメージに git 設定を含める**：ID とプッシュ認証情報を自分で設定します。例えば、独自のボット ID でコミットするため126* **イメージに git 設定を含める**：ID とプッシュ認証情報を自分で設定します。例えば、独自のボット ID でコミットするため

127 127

128ランナーホストの Git バージョンフロア：[`--configure-git`](#let-the-runner-configure-git) SSH コミット署名には Git 2.34 以降が必要です。[`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) には 2.32 以降が必要です。[`--push-outcome-on-release`](/docs/ja/self-hosted-environments-reference#runner-cli-flags) でプッシュされたブランチからセッションを再開するには 2.29 以降が必要です。 3 つすべてを省略して git ID を自分で管理する場合は、Git 2.24 で十分です。128ランナーホストの Git バージョンフロア：[`--configure-git`](#let-the-runner-configure-git) SSH コミット署名には Git 2.34 以降が必要です。[`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) には 2.32 以降が必要です。[`--push-outcome-on-release`](/docs/ja/self-hosted-environments-reference#runner-cli-flags) でプッシュされたブランチからセッションを再開するには 2.29 以降が必要です。3 つすべてを省略して git ID を自分で管理する場合は、Git 2.24 で十分です。

129 129

130<h3 id="let-the-runner-configure-git">130<h3 id="let-the-runner-configure-git">

131 ランナーに git を設定させる131 ランナーに git を設定させる

184 184

185プロキシは `--capacity 1` を必要とします。プロキシ URL はセッションごとであり、git 2.32 以降が必要です。古い git はプロキシがセッションを相互に分離するために使用する設定メカニズムを無視するためです。ランナーは要件のいずれかが満たされない場合、起動を拒否します。プロキシは Anthropic 側からフェッチするため、git ホストは Anthropic インフラストラクチャから到達可能である必要があります。これは Anthropic ホストセッションと同じ要件です。ネットワーク内でのみルーティング可能な git ホストの場合は、代わりに [`checkout` ライフサイクルフック](/docs/ja/self-hosted-environments-configuration#checkout)を使用してください。各ランナープロセスは一度に 1 つのセッションを処理するため、並列処理のためにより多くのレプリカを実行してください。プロキシが有効な場合、`--git-host-rewrite` と `--git-ssh-rewrite` は効果がありません：プロキシ URL は git ホストではなく `api.anthropic.com` を指します。185プロキシは `--capacity 1` を必要とします。プロキシ URL はセッションごとであり、git 2.32 以降が必要です。古い git はプロキシがセッションを相互に分離するために使用する設定メカニズムを無視するためです。ランナーは要件のいずれかが満たされない場合、起動を拒否します。プロキシは Anthropic 側からフェッチするため、git ホストは Anthropic インフラストラクチャから到達可能である必要があります。これは Anthropic ホストセッションと同じ要件です。ネットワーク内でのみルーティング可能な git ホストの場合は、代わりに [`checkout` ライフサイクルフック](/docs/ja/self-hosted-environments-configuration#checkout)を使用してください。各ランナープロセスは一度に 1 つのセッションを処理するため、並列処理のためにより多くのレプリカを実行してください。プロキシが有効な場合、`--git-host-rewrite` と `--git-ssh-rewrite` は効果がありません：プロキシ URL は git ホストではなく `api.anthropic.com` を指します。

186 186

187ランナーは登録時に Anthropic にオプトインを報告し、起動時に `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` を出力します。その後、オプトインランナー上の各セッションは、Anthropic 管理の git またはセッションごとのプロキシ URL のいずれかを使用します。セッションがセッションごとのプロキシ URL を使用する場合、ランナーは 1 つの `[runner:warn]` 行をログに記録します。187ランナーは登録時に Anthropic にオプトインを報告し、起動時に `Registering as opted in to Anthropic-managed git (--use-anthropic-git-proxy)` を出力します。オプトインの報告には Claude Code v2.1.267 以降が必要です。それより前のバージョンはフラグを受け入れますが、報告しないか、その行を出力しません。その後、オプトインランナー上の各セッションは、Anthropic 管理の git またはセッションごとのプロキシ URL のいずれかを使用します。セッションがセッションごとのプロキシ URL を使用する場合、ランナーは 1 つの `[runner:warn]` 行をログに記録します。

188 188

189<h3 id="rewrite-git-urls-for-private-networks">189<h3 id="rewrite-git-urls-for-private-networks">

190 プライベートネットワークの git URL を書き直す190 プライベートネットワークの git URL を書き直す

191</h3>191</h3>

192 192

193リポジトリ URL はコントロールプレーンから HTTPS として到達します。git ホストのホスト名を使用します。GitHub Enterprise の場合、Claude Code 管理設定で [GitHub Enterprise 統合](/docs/ja/github-enterprise-server)用に設定したホスト名です。 2 つの繰り返し可能なフラグはクローン前にこれらの URL を書き直します：193リポジトリ URL はコントロールプレーンから HTTPS として到達します。git ホストのホスト名を使用します。GitHub Enterprise の場合、Claude Code 管理設定で [GitHub Enterprise 統合](/docs/ja/github-enterprise-server)用に設定したホスト名です。2 つの繰り返し可能なフラグはクローン前にこれらの URL を書き直します：

194 194

195* `--git-host-rewrite <from>=<to>`：スプリットホライズン DNS の場合。Anthropic は外部ホスト名を通じて git ホストに到達しますが、ランナーは内部ホスト名を使用する必要があります195* `--git-host-rewrite <from>=<to>`：スプリットホライズン DNS の場合。Anthropic は外部ホスト名を通じて git ホストに到達しますが、ランナーは内部ホスト名を使用する必要があります

196* `--git-ssh-rewrite <host>`：SSH のみを受け入れる git ホストの場合。`https://<host>/owner/repo` を `git@<host>:owner/repo` に書き直します196* `--git-ssh-rewrite <host>`：SSH のみを受け入れる git ホストの場合。`https://<host>/owner/repo` を `git@<host>:owner/repo` に書き直します

223ノードが ARM の場合は `linux-x64` を `linux-arm64` に、Alpine などの musl ベースのイメージの場合は `linux-x64-musl` または `linux-arm64-musl` に置き換えます。[Alpine Linux セットアップ](/docs/ja/setup#alpine-linux-and-musl-based-distributions)を参照して、musl イメージが必要とする追加パッケージについて確認してください。URL は標準 Claude Code リリースロケーションであるため、[バイナリ整合性とコード署名](/docs/ja/setup#binary-integrity-and-code-signing)で説明されているように、ダウンロードされたバイナリをリリースの署名されたマニフェストに対して検証できます。Claude Code バージョン 2.1.224 以降でイメージをビルドしてから、レジストリにプッシュし、以下のレシピで参照してください：223ノードが ARM の場合は `linux-x64` を `linux-arm64` に、Alpine などの musl ベースのイメージの場合は `linux-x64-musl` または `linux-arm64-musl` に置き換えます。[Alpine Linux セットアップ](/docs/ja/setup#alpine-linux-and-musl-based-distributions)を参照して、musl イメージが必要とする追加パッケージについて確認してください。URL は標準 Claude Code リリースロケーションであるため、[バイナリ整合性とコード署名](/docs/ja/setup#binary-integrity-and-code-signing)で説明されているように、ダウンロードされたバイナリをリリースの署名されたマニフェストに対して検証できます。Claude Code バージョン 2.1.224 以降でイメージをビルドしてから、レジストリにプッシュし、以下のレシピで参照してください：

224 224

225```bash theme={null}225```bash theme={null}

226docker build --build-arg CLAUDE_CODE_VERSION=2.1.224 -t <your-registry>/claude-runner:latest .226docker build --build-arg CLAUDE_CODE_VERSION=2.1.267 -t <your-registry>/claude-runner:latest .

227```227```

228 228

229<h2 id="size-cpu-and-memory-for-sessions">229<h2 id="size-cpu-and-memory-for-sessions">

server-managed-settings.md +1 −1

Details

171* **`env` ブロック**：テレメトリユニットと認証情報キーとペアになったルーティング変数を除き、以下で説明するように、管理者が管理するソース全体でキーごとにマージされます。各環境変数について、それを定義する最優先ソースが優先され、下位の管理ソースは上位のソースが設定しない変数を埋めます。したがって、エンドポイント管理 `env` エントリは、サーバー管理構成がその変数を設定しない場合、またはキャッシュされたサーバー値が[サーバー確認待ちで保留中](#fetch-and-caching-behavior)の場合に適用されます。Claude Code v2.1.223 以降が必要です。v2.1.223 より前は、Claude Code は選択されたソースの全体 `env` ブロックのみを適用します。171* **`env` ブロック**：テレメトリユニットと認証情報キーとペアになったルーティング変数を除き、以下で説明するように、管理者が管理するソース全体でキーごとにマージされます。各環境変数について、それを定義する最優先ソースが優先され、下位の管理ソースは上位のソースが設定しない変数を埋めます。したがって、エンドポイント管理 `env` エントリは、サーバー管理構成がその変数を設定しない場合、またはキャッシュされたサーバー値が[サーバー確認待ちで保留中](#fetch-and-caching-behavior)の場合に適用されます。Claude Code v2.1.223 以降が必要です。v2.1.223 より前は、Claude Code は選択されたソースの全体 `env` ブロックのみを適用します。

172 * **テレメトリユニット**：`OTEL_EXPORTER_OTLP_*` エクスポーターキー、`OTEL_LOG_*` コンテンツキャプチャトグル、`OTEL_LOGS_EXPORTER`、およびベータトレーシング変数 `ENABLE_BETA_TRACING_DETAILED` と `BETA_TRACING_ENDPOINT` は、それらのいずれかを設定する最優先ソースをユニットとして従います。`otelHeadersHelper` 認証情報キーを配信するソースもユニットを要求しますが、これらの変数は選択されたソースである場合にのみ配置されます。選択されていないが、キーを配信するソースはそれらのいずれも提供せず、下位のソースがそれらを埋めるのをブロックします。いずれにせよ、1 つのソースからのエクスポーターエンドポイントは、別のソースからの認証情報とペアになることはできません。172 * **テレメトリユニット**：`OTEL_EXPORTER_OTLP_*` エクスポーターキー、`OTEL_LOG_*` コンテンツキャプチャトグル、`OTEL_LOGS_EXPORTER`、およびベータトレーシング変数 `ENABLE_BETA_TRACING_DETAILED` と `BETA_TRACING_ENDPOINT` は、それらのいずれかを設定する最優先ソースをユニットとして従います。`otelHeadersHelper` 認証情報キーを配信するソースもユニットを要求しますが、これらの変数は選択されたソースである場合にのみ配置されます。選択されていないが、キーを配信するソースはそれらのいずれも提供せず、下位のソースがそれらを埋めるのをブロックします。いずれにせよ、1 つのソースからのエクスポーターエンドポイントは、別のソースからの認証情報とペアになることはできません。

173 * **認証情報ペアのルーティング**：`apiKeyHelper` または `otelHeadersHelper` などの選択されたソースのみの認証情報キーとペアになったルーティング変数を配信するソースは、それがスロットに勝つ場合にのみそれらのルーティング変数を提供します。173 * **認証情報ペアのルーティング**：`apiKeyHelper` または `otelHeadersHelper` などの選択されたソースのみの認証情報キーとペアになったルーティング変数を配信するソースは、それがスロットに勝つ場合にのみそれらのルーティング変数を提供します。

174* **ゲートウェイサインインキー**：Claude Code は [`forceLoginGatewayUrl`](/docs/ja/settings-reference#forcelogingatewayurl) または [`forceLoginMethod`](/docs/ja/settings-reference#forceloginmethod) の `"gateway"` 値をサーバー管理設定から読み取ることはありません。したがって、サーバー管理設定を選択してもゲートウェイサインインは提供されず、MDM ポリシーまたは管理設定ファイルで設定されたものは隠されません。[`managedSourcesBehavior` エントリ](/docs/ja/settings-reference#managedsourcesbehavior)は、マシン上のどの管理ソースがそれらを提供するかを説明しています。174* **ゲートウェイサインインキー**：Claude Code は [`forceLoginGatewayUrl`](/docs/ja/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](/docs/ja/settings-reference#gatewayinternalnetworks)、または [`forceLoginMethod`](/docs/ja/settings-reference#forceloginmethod) の `"gateway"` 値をサーバー管理設定から読み取ることはありません。したがって、サーバー管理設定の値は適用されず、MDM ポリシーまたは管理設定ファイルで設定されたものも隠されません。[`managedSourcesBehavior` エントリ](/docs/ja/settings-reference#managedsourcesbehavior)は、マシン上のどの管理ソースがそれらを提供するかを説明しています。

175 175

176<h3 id="fetch-and-caching-behavior">176<h3 id="fetch-and-caching-behavior">

177 フェッチとキャッシング動作177 フェッチとキャッシング動作

sessions.md +7 −1

Details

147名前を付けないセッションでも、Claude Code が割り当てる 2 つのラベルが付けられます。生成されたタイトルのみが再開ハンドルとして機能します。147名前を付けないセッションでも、Claude Code が割り当てる 2 つのラベルが付けられます。生成されたタイトルのみが再開ハンドルとして機能します。

148 148

149* デフォルト表示名：名前を付けないインタラクティブセッションでも、起動時にデフォルト表示名が自動的に付けられます。Claude Code v2.1.196 以降が必要です。デフォルト名は、作業ディレクトリの名前と 2 文字のサフィックスを組み合わせたもので、例えば `my-app-3f` のようになり、[agent view](/docs/ja/agent-view)や `claude agents --json` 出力などの実行中セッションのリストでセッションを識別します。デフォルト名は再開ハンドルではありません。`claude --resume` または `/resume` に渡した場合、Claude Code はセッションを見つけません。セッションに名前を付けるとデフォルト名がリストに置き換わり、プランを受け入れても置き換わります。149* デフォルト表示名：名前を付けないインタラクティブセッションでも、起動時にデフォルト表示名が自動的に付けられます。Claude Code v2.1.196 以降が必要です。デフォルト名は、作業ディレクトリの名前と 2 文字のサフィックスを組み合わせたもので、例えば `my-app-3f` のようになり、[agent view](/docs/ja/agent-view)や `claude agents --json` 出力などの実行中セッションのリストでセッションを識別します。デフォルト名は再開ハンドルではありません。`claude --resume` または `/resume` に渡した場合、Claude Code はセッションを見つけません。セッションに名前を付けるとデフォルト名がリストに置き換わり、プランを受け入れても置き換わります。

150* 生成されたタイトル：セッションに名前を付けない場合、Claude Code はセッションのタイトルを生成します。タイトルは最初のプロンプトの短い要約で、通常は Haiku クラスモデルである小型/高速モデルへのバックグラウンドリクエストで作成されます。プランを受け入れるとプランに基づいたタイトルに置き換わります。セッションに名前を付けると生成されたタイトルが置き換わります。最初のプロンプトタイトルは[セッションピッカー](#use-the-session-picker)と、名前が設定されていない場合のステータスライン [`session_name`](/docs/ja/statusline) フィールドに表示されます。プランタイトルは同じ 2 つの場所に表示され、実行中セッションのリストにも表示され、デフォルト表示名の代わりになります。`claude --resume` または `/resume` にいずれかのタイトルを渡すことができ、Claude Code は設定した名前と同じ方法で解決します。150* 生成されたタイトル：セッションに名前を付けない場合、Claude Code はセッションのタイトルを生成します。タイトルは最初のプロンプトの短い要約で、通常は Haiku クラスモデルである小型/高速モデルへのバックグラウンドリクエストで作成されます。シェルまたはスクリプトから直接開始する `claude -p` 実行は生成されません。

151

152 プランを受け入れるとプランに基づいたタイトルに置き換わります。セッションに名前を付けると生成されたタイトルが置き換わります。

153

154 最初のプロンプトタイトルは[セッションピッカー](#use-the-session-picker)と、名前が設定されていない場合のステータスライン [`session_name`](/docs/ja/statusline) フィールドに表示されます。プランタイトルは同じ 2 つの場所に表示され、実行中セッションのリストにも表示され、デフォルト表示名の代わりになります。

155

156 `claude --resume` または `/resume` にいずれかのタイトルを渡すことができ、Claude Code は設定した名前と同じ方法で解決します。

151 157

152<h2 id="use-the-session-picker">158<h2 id="use-the-session-picker">

153 セッションピッカーを使用する159 セッションピッカーを使用する

settings.md +3 −3

Details

468 リポジトリから個人設定を除外する468 リポジトリから個人設定を除外する

469</h3>469</h3>

470 470

471プロジェクト内で自分の設定を変更し、チームメイトの設定を変更しないようにするには、プロジェクト内の `.claude/settings.local.json` に保存してください。Claude Code はそのファイルをコミットされた `.claude/settings.json` に適用するため、チームのファイルが `"model": "claude-sonnet-5"` を設定し、Opus が必要な場合は、ローカルファイルに `"model": "claude-opus-4-8"` を入れて、セッションのみを変更します。471プロジェクト内で自分の設定を変更し、チームメイトの設定を変更しないようにするには、プロジェクト内の `.claude/settings.local.json` に保存してください。Claude Code はそのファイルをコミットされた `.claude/settings.json` に適用するため、チームのファイルが `"model": "claude-sonnet-5"` を設定し、Opus が必要な場合は、ローカルファイルに `"model": "claude-opus-5-5"` を入れて、セッションのみを変更します。

472 472

473Claude Code もこのファイルに書き込み、コミットから除外し、信頼ステップなしに allow ルールを適用します：473Claude Code もこのファイルに書き込み、コミットから除外し、信頼ステップなしに allow ルールを適用します：

474 474

598たとえば、デフォルトを変更せずに 1 つのセッションで Opus で開始するには：598たとえば、デフォルトを変更せずに 1 つのセッションで Opus で開始するには：

599 599

600```bash theme={null}600```bash theme={null}

601claude --settings '{"model": "claude-opus-4-8"}'601claude --settings '{"model": "claude-opus-5-5"}'

602```602```

603 603

604<h3 id="when-edits-take-effect">604<h3 id="when-edits-take-effect">

803 803

804[クラウドセッション](/docs/ja/claude-code-on-the-web)は[クラウド環境](/docs/ja/cloud-environments)で実行され、マシン上ではなくリポジトリの新しいクローンで実行されます。これにより、どの設定がそこに到達するかが変わります：804[クラウドセッション](/docs/ja/claude-code-on-the-web)は[クラウド環境](/docs/ja/cloud-environments)で実行され、マシン上ではなくリポジトリの新しいクローンで実行されます。これにより、どの設定がそこに到達するかが変わります：

805 805

806* **共有プロジェクト設定**（`.claude/settings.json`）：1 つのリポジトリを持つセッションで読み込まれます。ファイルはクローンの一部であり、セッションはその内部で開始されるためです。その設定をコミットして、それらのセッションに適用してください。複数のリポジトリを持つセッションは、クローンの上で開始されるため、各リポジトリの `.claude/settings.json` からは、ファイルが宣言するプラグインとマーケットプレイスのみを読み込み、権限ルール、hooks、`env`、またはその他のキーは読み込みません。[セットアップから何が引き継がれるか](/docs/ja/cloud-environments#what-carries-over-from-your-setup)を参照してください。806* **共有プロジェクト設定**（`.claude/settings.json`）：1 つのリポジトリを持つセッションで読み込まれます。ファイルはクローンの一部であり、セッションはその内部で開始されるためです。その設定をコミットして、それらのセッションに適用してください。複数のリポジトリを持つセッションはクローンの上で開始され、各リポジトリの `.claude/settings.json` から `enabledPlugins` と `extraKnownMarketplaces` キーのみを読み込み、権限ルール、hooks、`env`、またはその他のキーは読み込みません。これら 2 つのキーが宣言するマーケットプレイスとプラグインは、それでも[クラウドセッションでは読み込まれません](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。

807* **ユーザーおよびプロジェクトローカル設定**（`~/.claude/settings.json` および `.claude/settings.local.json`）：読み込まれません。両方ともマシンに留まり、ローカルファイルはクローンにありません。807* **ユーザーおよびプロジェクトローカル設定**（`~/.claude/settings.json` および `.claude/settings.local.json`）：読み込まれません。両方ともマシンに留まり、ローカルファイルはクローンにありません。

808* **管理設定**：[サーバー管理設定](/docs/ja/server-managed-settings)のみがクラウドセッションに到達します。デバイスの `managed-settings.json` ファイルまたは MDM プロファイルは到達しません。[自己ホスト型環境](/docs/ja/self-hosted-environments)もランナーイメージの管理設定ファイルを読み込みます。[Claude Code が管理ソースを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)はそのファイルがいつ適用されるかを説明します。808* **管理設定**：[サーバー管理設定](/docs/ja/server-managed-settings)のみがクラウドセッションに到達します。デバイスの `managed-settings.json` ファイルまたは MDM プロファイルは到達しません。[自己ホスト型環境](/docs/ja/self-hosted-environments)もランナーイメージの管理設定ファイルを読み込みます。[Claude Code が管理ソースを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)はそのファイルがいつ適用されるかを説明します。

809* **`/config`**：ブラウザの claude.ai/code では、値を変更する代わりに Claude Code セクションの claude.ai 設定を開きます。クラウドセッションの設定を変更するには、環境で[環境変数](/docs/ja/cloud-environments#set-environment-variables)を設定するか、1 つのリポジトリを持つセッションでは、そのリポジトリの `.claude/settings.json` にキーをコミットしてください。809* **`/config`**：ブラウザの claude.ai/code では、値を変更する代わりに Claude Code セクションの claude.ai 設定を開きます。クラウドセッションの設定を変更するには、環境で[環境変数](/docs/ja/cloud-environments#set-environment-variables)を設定するか、1 つのリポジトリを持つセッションでは、そのリポジトリの `.claude/settings.json` にキーをコミットしてください。

settings-example.md +7 −3

Details

29 ```json ~/.claude/settings.json theme={null}29 ```json ~/.claude/settings.json theme={null}

30 {30 {

31 "model": "claude-sonnet-5",31 "model": "claude-sonnet-5",

~~32 "effortLevel": "xhigh",~~32 "modelSettings": {

33 "claude-sonnet-5": { "effortLevel": "xhigh" }

34 },

33 "editorMode": "vim",35 "editorMode": "vim",

34 "theme": "light-daltonized",36 "theme": "light-daltonized",

35 "statusLine": {37 "statusLine": {

58 {60 {

59 // すべてのセッションを Sonnet 5 で開始61 // すべてのセッションを Sonnet 5 で開始

60 "model": "claude-sonnet-5",62 "model": "claude-sonnet-5",

61 // 保存されたレベルのないモデルでデフォルトの高レベルより深く推論します。/effort はモデルごとにレベルを保存し、--effort は単一セッションに設定します63 // Sonnet 5 をデフォルトの高レベルより上で実行します。/effort はモデルごとにレベルを保存し、--effort は単一セッションに設定します

~~62 "effortLevel": "xhigh",~~64 "modelSettings": {

65 "claude-sonnet-5": { "effortLevel": "xhigh" }

66 },

63 // プロンプトの Vim キーバインディング67 // プロンプトの Vim キーバインディング

64 "editorMode": "vim",68 "editorMode": "vim",

65 // 色覚異常対応のライトテーマ69 // 色覚異常対応のライトテーマ

settings-reference.md +31 −21

Details

690| [`isolatePeerMachines`](#isolatepeermachines) | Claude が[別のマシンのセッションの 1 つにメッセージを送信](/docs/ja/cross-session-messaging#require-approval-for-cross-machine-messages)する前に確認を求めます | Agents, sessions, and worktrees | Any file |690| [`isolatePeerMachines`](#isolatepeermachines) | Claude が[別のマシンのセッションの 1 つにメッセージを送信](/docs/ja/cross-session-messaging#require-approval-for-cross-machine-messages)する前に確認を求めます | Agents, sessions, and worktrees | Any file |

801| [`teammateDefaultModel`](#teammatedefaultmodel) | v2.1.234 で削除されました。Claude Code がチームメイトのモデルを選択する方法については[チームメイトとモデルを指定](/docs/ja/agent-teams#specify-teammates-and-models)を参照してください | Global config settings | Global config |801| [`teammateDefaultModel`](#teammatedefaultmodel) | v2.1.234 で削除されました。Claude Code がチームメイトのモデルを選択する方法については[チームメイトとモデルを指定](/docs/ja/agent-teams#specify-teammates-and-models)を参照してください | Global config settings | Global config |

993 `fastModePerSessionOptIn`993 `fastModePerSessionOptIn`

994</h3>994</h3>

995 995

996通常、`/fast` を実行するとユーザー設定に [`fastMode`](#fastmode)が保存されるため、高速モードは後のすべてのセッションの開始時にオンになります。このキーを `true` に設定してそれを停止します。保存された `fastMode: true` はセッション開始時に高速モードをオンにしなくなり、各ユーザーは必要な各セッションで `/fast` を実行する必要があります。Claude Code は `fastMode` キーをファイルに残すため、このキーをオフにすると古い動作が復元されます。Team または Enterprise プランのオーナーは、[サーバー管理設定](/docs/ja/server-managed-settings)を通じて組織全体にデプロイできます。996通常、`/fast` を実行するとユーザー設定に [`fastMode`](#fastmode)が保存されるため、高速モードは後のすべてのセッションの開始時にオンになります。このキーを `true` に設定してそれを停止します。保存された `fastMode: true` はセッション開始時に高速モードをオンにしなくなり、各ユーザーは必要な各セッションで `/fast` を実行する必要があります。Claude Code は `fastMode` キーをファイルに残すため、このキーをオフにすると古い動作が復元されます。Team または Enterprise プランのオーナーは、[サーバー管理設定](/docs/ja/server-managed-settings)を通じて組織全体にデプロイできます。管理設定がキーを設定すると、`/fast on` はインタラクティブターミナルセッション外で拒否され、組織が高速モードを無効にしたと報告します。これは[非インタラクティブモード](/docs/ja/headless)、[VS Code 拡張機能](/docs/ja/vs-code)、および[クラウドセッション](/docs/ja/claude-code-on-the-web)をカバーします。

997 997

998* **スコープ**: [`任意のファイル`](#scopes)998* **スコープ**: [`任意のファイル`](#scopes)

999* **タイプ**: ブール値999* **タイプ**: ブール値

1208 `modelSettings`1208 `modelSettings`

1209</h3>1209</h3>

1210 1210

1211使用する各モデルの[努力レベル](/docs/ja/model-config#adjust-effort-level)を保存します。マシン上のインタラクティブセッションで、`/effort` または `/model` ピッカーの努力スライダーで `low`、`medium`、`high`、または `xhigh` をデフォルトとして保存すると、Claude Code はそのレベルを使用しているモデルの下にここに書き込むため、このキーを自分で編集することはめったにありません。[`effortLevel`](#effortlevel)エントリは、`/effort` がそのセッションのみに適用されるセッションをリストします。Claude Code v2.1.251 以降が必要です。1211使用する各モデルの[努力レベル](/docs/ja/model-config#adjust-effort-level)を保存します。Claude Code v2.1.251 以降が必要です。

1212

1213マシン上のインタラクティブセッションで、`/effort` または `/model` ピッカーの努力スライダーで `low`、`medium`、`high`、または `xhigh` をデフォルトとして保存すると、Claude Code はそのレベルを使用しているモデルの下にここに書き込むため、このキーを自分で編集することはめったにありません。[VS Code 拡張機能のモデルピッカー](/docs/ja/vs-code#use-the-prompt-box)でこれらのレベルの 1 つを選択すると、Claude Code は同じ方法でここに保存します。[`effortLevel`](#effortlevel)エントリは、`/effort` がそのセッションのみに適用されるセッションをリストします。

1212 1214

1213キーを手動で編集して、保存したレベルを変更または削除します。1215キーを手動で編集して、保存したレベルを変更または削除します。

1214 1216

1260 `promptCacheTtl`1262 `promptCacheTtl`

1261</h3>1263</h3>

1262 1264

1263[プロンプトキャッシュ](/docs/ja/prompt-caching)がメイン会話を保持する期間を選択します。このキーは、インタラクティブ、`-p`、および Agent SDK ターンに適用されます。インラインで実行する Claude Code ヘルパーと一緒に。1 時間のライフタイムは、より長い休憩全体でキャッシュをウォームに保ち、API は[各キャッシュ書き込みを 5 分のライフタイムより高いレートで請求します](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing)。Claude Code v2.1.242 以降が必要です。1265[プロンプトキャッシュ](/docs/ja/prompt-caching)がメイン会話を保持する期間を選択します。Claude Code v2.1.242 以降が必要です。このキーは、インタラクティブ、`-p`、および Agent SDK ターンに適用されます。インラインで実行する Claude Code ヘルパーと一緒に。1 時間のライフタイムは、より長い休憩全体でキャッシュをウォームに保ち、API は[各キャッシュ書き込みを 5 分のライフタイムより高いレートで請求します](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing)。

1264 1266

1265* **スコープ**: [`任意のファイル`](#scopes)1267* **スコープ**: [`任意のファイル`](#scopes)

1266* **タイプ**: 文字列。以下のいずれか:1268* **タイプ**: 文字列。以下のいずれか:

1304 `subagentPromptCacheTtl`1306 `subagentPromptCacheTtl`

1305</h3>1307</h3>

1306 1308

1307[プロンプトキャッシュ](/docs/ja/prompt-caching)がメイン会話外で Claude Code が行うリクエストを保持する期間を選択します。このキーは、[サブエージェント](/docs/ja/sub-agents)、[ワークフロー](/docs/ja/workflows)、および Claude Code 独自のバックグラウンドおよびヘルパーリクエスト（圧縮やセッションタイトルなど）に適用されます。1 時間のライフタイムは、より長い休憩全体でキャッシュをウォームに保ち、API は[各キャッシュ書き込みを 5 分のライフタイムより高いレートで請求します](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing)。Claude Code v2.1.242 以降が必要です。1309[プロンプトキャッシュ](/docs/ja/prompt-caching)がメイン会話外で Claude Code が行うリクエストを保持する期間を選択します。Claude Code v2.1.242 以降が必要です。このキーは、[サブエージェント](/docs/ja/sub-agents)、[ワークフロー](/docs/ja/workflows)、および Claude Code 独自のバックグラウンドおよびヘルパーリクエスト（圧縮やセッションタイトルなど）に適用されます。1 時間のライフタイムは、より長い休憩全体でキャッシュをウォームに保ち、API は[各キャッシュ書き込みを 5 分のライフタイムより高いレートで請求します](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing)。

1308 1310

1309* **スコープ**: [`任意のファイル`](#scopes)1311* **スコープ**: [`任意のファイル`](#scopes)

1310* **タイプ**: 文字列。以下のいずれか:1312* **タイプ**: 文字列。以下のいずれか:

1837 `sandbox.excludedCommands`1839 `sandbox.excludedCommands`

1838</h3>1840</h3>

1839 1841

1840Claude Code が常にサンドボックスの外で実行するコマンド（それの下で動作しないツールなど）に名前を付けます。各エントリは、`Bash(...)` [権限ルール](/docs/ja/permissions#permission-rule-syntax)の内容と同じ構文を使用します：正確なコマンド、`docker *` などのプレフィックス、またはワイルドカードパターン。複合コマンドの任意の部分がエントリと一致する場合、Claude Code はコマンド全体をサンドボックスなしで実行します。1842Claude Code が常にサンドボックスの外で実行するコマンド（それの下で動作しないツールなど）に名前を付けます。各エントリは、`Bash(...)` [権限ルール](/docs/ja/permissions#permission-rule-syntax)の内容と同じ構文を使用します：正確なコマンド、`docker *` などのプレフィックス、またはワイルドカードパターン。

1843

1844エントリはそれをカバーするすべてのコマンドがある場合にのみ、Bash 呼び出しをサンドボックスから外します。一部の呼び出し形状はそれでもサンドボックス化されたままです。`docker *` エントリだけでは、`npm ci && docker build .` をサンドボックスから外しません。

1841 1845

1842* **Scope**: [`Any file`](#scopes)1846* **Scope**: [`Any file`](#scopes)

1843* **Type**: コマンドパターンの配列1847* **Type**: コマンドパターンの配列

1851}1855}

1852```1856```

1853 1857

1858Claude Code は Bash 呼び出しをサンドボックス化されたままにします。これらの形状の 1 つがある場合：

1859

1860* `sudo`、`eval`、`xargs` で始まるコマンド

1861* `cd`、`pushd`、`popd`。呼び出しのどこにでも表示される

1862* コマンド置換、サブシェル、`if` または `for` などの制御フローブロック

1863* `docker build . > build.log` のような `2>&1` のようなファイル記述子を複製するもの以外のリダイレクト

1864* 変数から来るコマンド名

1865

1866たとえば、`cd build && docker compose up` は `docker *` エントリの下でサンドボックス化されたままで、`cd` エントリを追加してもそれは変わりません。

1867

1854除外されたコマンドは通常の権限フローを通過します。除外はセキュリティ境界ではなく、便宜です。ツールが特定の場所にのみ書き込む必要がある場合は、[`filesystem.allowWrite`](#sandbox-filesystem-allowwrite)を優先してください。Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、このリストに対する管理対象のみのロックはないため、管理対象リストは狭く保ってください。1868除外されたコマンドは通常の権限フローを通過します。除外はセキュリティ境界ではなく、便宜です。ツールが特定の場所にのみ書き込む必要がある場合は、[`filesystem.allowWrite`](#sandbox-filesystem-allowwrite)を優先してください。Claude Code はセッションが読み込むすべての設定スコープ全体でエントリをマージし、このリストに対する管理対象のみのロックはないため、管理対象リストは狭く保ってください。

1855 1869

1856<h3 id="sandbox-allowunsandboxedcommands">1870<h3 id="sandbox-allowunsandboxedcommands">

3064 `taskOutputMaxChars`3078 `taskOutputMaxChars`

3065</h3>3079</h3>

3066 3080

3067Claude が `TaskOutput` ツールでタスクを読み取るときに、[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)の出力の文字数を設定します。Claude がインラインで受け取ります。完了したタスクの出力がより長い場合、Claude は最新の文字を受け取ります。バックグラウンドタスクが定期的にデフォルトより多くの出力を生成する場合は、制限を引き上げます。Claude Code v2.1.261 以降が必要です。3081<Warning>

~~3068~~ 3082 v2.1.277 で削除されました。これとともに、それをサイズ設定した `TaskOutput` ツールも削除されました。現在のバージョンでこれを設定しても効果がありません。Claude は代わりに `Read` を使用して、バックグラウンドタスクの[出力ファイル](/docs/ja/tools-reference#background-commands)を読み取ります。

3069* **スコープ**: [`任意のファイル`](#scopes)3083</Warning>

3070* **タイプ**: 文字数。正の整数。Claude Code はこの値を `4000` から `128000` の範囲に制限します

3071* **デフォルト**: 未設定。Claude は最大 32,000 文字をインラインで受け取ります

~~3072~~

3073```json settings.json theme={null}

3074{

3075 "taskOutputMaxChars": 100000

3076}

3077```

3078 3084

3079このキーを設定すると、Claude Code は[`TASK_MAX_OUTPUT_LENGTH`](/docs/ja/env-vars)環境変数を無視します。3085v2.1.276 を通じて、このキーを[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)の出力の文字数に設定しました。Claude が `TaskOutput` ツールでタスクを読み取るときにインラインで受け取ります。

3080 3086

3081<h2 id="interface-and-terminal">3087<h2 id="interface-and-terminal">

3082 インターフェースとターミナル3088 インターフェースとターミナル

3992 3998

3993すべてのアトリビューションを非表示にするには、[`commit`](#attribution-commit) と [`pr`](#attribution-pr) を空の文字列に設定し、[`sessionUrl`](#attribution-sessionurl) を `false` に設定します。`commit` または `pr` を設定すると、Claude Code は非推奨の `includeCoAuthoredBy` 設定を無視し、設定しなかった方のデフォルトテキストを使用します。3999すべてのアトリビューションを非表示にするには、[`commit`](#attribution-commit) と [`pr`](#attribution-pr) を空の文字列に設定し、[`sessionUrl`](#attribution-sessionurl) を `false` に設定します。`commit` または `pr` を設定すると、Claude Code は非推奨の `includeCoAuthoredBy` 設定を無視し、設定しなかった方のデフォルトテキストを使用します。

3994 4000

4001Claude Code は、CLAUDE.md または [memory](/docs/ja/memory) ルールなど、アトリビューションに関するカスタマー独自の命令が、[managed settings](/docs/ja/managed-settings) で設定されている場合を除き、これらのコミットおよび PR 行より優先されることを Claude に伝えます。

4002

3995<h3 id="includecoauthoredby">4003<h3 id="includecoauthoredby">

3996 `includeCoAuthoredBy`4004 `includeCoAuthoredBy`

3997</h3>4005</h3>

4020 `includeGitInstructions`4028 `includeGitInstructions`

4021</h3>4029</h3>

4022 4030

4023セッション開始時に、Claude Code は git 関連の 2 つの部分を Claude のプロンプトに追加します。Bash ツールの説明にあるコミットとプルリクエストの書き方に関する組み込み命令と、システムプロンプトのリポジトリの git ステータススナップショット（現在のブランチ、メインブランチ、`git status` 出力、最近のコミット）です。このキーを `false` に設定して両方を除外します。例えば、独自の git ワークフロースキルを使用する場合などです。4031Claude Code は git 関連の 2 つの部分をコンテキストとして Claude に提供します。Bash ツールの説明にあるコミットとプルリクエストの書き方に関する組み込み命令と、リポジトリの git ステータススナップショット（現在のブランチ、メインブランチ、`git status` 出力、最近のコミット）です。Claude Code はコンバーセーション開始時にスナップショットを読み込みます。

4032

4033このキーを `false` に設定して両方を除外します。例えば、独自の git ワークフロースキルを使用する場合などです。

4024 4034

4025* **スコープ**: [`Any file`](#scopes)4035* **スコープ**: [`Any file`](#scopes)

4026* **タイプ**: ブール値4036* **タイプ**: ブール値

5937バックグラウンド自動更新と `claude update` がこれより下のバージョンをインストールするのを防ぎます。これにより、`"stable"` チャネルに移動しても、より新しい `"latest"` ビルドからダウングレードされません。Claude Code は `/config` でチャネルを切り替えながら現在のバージョンにとどまることを選択すると、このキーを書き込み、`"latest"` に戻すと削除します。5947バックグラウンド自動更新と `claude update` がこれより下のバージョンをインストールするのを防ぎます。これにより、`"stable"` チャネルに移動しても、より新しい `"latest"` ビルドからダウングレードされません。Claude Code は `/config` でチャネルを切り替えながら現在のバージョンにとどまることを選択すると、このキーを書き込み、`"latest"` に戻すと削除します。

5938 5948

5939* **スコープ**: [`Any file`](#scopes)。ユーザーおよびプロジェクト設定が低下させることができない、組織全体の最小値をピン留めするために、管理設定で設定します。5949* **スコープ**: [`Any file`](#scopes)。ユーザーおよびプロジェクト設定が低下させることができない、組織全体の最小値をピン留めするために、管理設定で設定します。

5940* **タイプ**: 文字列、`"2.1.100"` などのバージョン番号5950* **タイプ**: 文字列、`"2.1.100"` などのバージョン番号。有効なバージョンではない値は無視されます

5941* **デフォルト**: 未設定の場合、更新はチャネルが提供するすべてのバージョンをインストールできる5951* **デフォルト**: 未設定の場合、更新はチャネルが提供するすべてのバージョンをインストールできる

5942 5952

5943この例は stable チャネルに従い、2.1.100 より下のバージョンをインストールするのを拒否します：5953この例は stable チャネルに従い、2.1.100 より下のバージョンをインストールするのを拒否します：

statusline.md +1 −1

Details

236 "prompt_id": "550e8400-e29b-41d4-a716-446655440000",236 "prompt_id": "550e8400-e29b-41d4-a716-446655440000",

237 "transcript_path": "/path/to/transcript.jsonl",237 "transcript_path": "/path/to/transcript.jsonl",

238 "model": {238 "model": {

239 "id": "claude-opus-5",239 "id": "claude-opus-5-5",

240 "display_name": "Opus"240 "display_name": "Opus"

241 },241 },

242 "workspace": {242 "workspace": {

sub-agents.md +56 −42

Details

30 組み込みサブエージェント30 組み込みサブエージェント

31</h2>31</h2>

32 32

33Claude Code には、Claude が適切なときに自動的に使用する組み込みサブエージェントが含まれています。各サブエージェントは親の会話の権限を継承し、ほとんどは制限されたツールセットで実行されます。33Claude Code には、Claude が必要に応じて自動的に使用する組み込みサブエージェントが含まれています。各サブエージェントは親の会話の権限を継承します。ほとんどは制限されたツールセットで実行されます。

34 34

35Explore と Plan は CLAUDE.md ファイルと親セッションの git ステータスをスキップして、研究を高速かつ低コストに保ちます。その他すべての組み込みおよび[カスタムサブエージェント](#configure-subagents)は両方をロードします。ただし、その定義が [`omitClaudeMd`](#supported-frontmatter-fields) フィールドを設定してユーザー、プロジェクト、およびローカル CLAUDE.md ファイルをスキップする場合を除きます。サブエージェントに到達するものの完全な内訳については、[スタートアップ時にロードされるもの](#what-loads-at-startup)を参照してください。35Explore と Plan は、研究を高速かつ低コストに保つために、CLAUDE.md ファイルと git ステータススナップショットをスキップします。その他のすべての組み込みサブエージェントと[カスタムサブエージェント](#configure-subagents)は、その定義が[`omitClaudeMd`](#supported-frontmatter-fields)フィールドを設定してユーザー、プロジェクト、およびローカル CLAUDE.md ファイルをスキップしない限り、両方を読み込みます。サブエージェントに到達するものの完全な内訳については、[スタートアップ時に読み込まれるもの](#what-loads-at-startup)を参照してください。

36 36

37<Tabs>37<Tabs>

38 <Tab title="Explore">38 <Tab title="Explore">

39 コードベースの検索と分析に最適化された高速な読み取り専用エージェント。39 コードベースの検索と分析に最適化された高速な読み取り専用エージェント。

40 40

41 * **モデル**：メイン会話から継承され、Claude API では Opus でキャップされるため、Explore はセッション用に既に選択したモデルより高価なモデルで実行されることはありません。ただし、`CLAUDE_CODE_SUBAGENT_MODEL` を設定して[すべてのサブエージェントを 1 つのモデルで実行](#run-every-subagent-on-one-model)する場合を除きます41 * **モデル**: メイン会話から継承され、Claude API では Opus でキャップされます。つまり、Explore は、`CLAUDE_CODE_SUBAGENT_MODEL`を設定して[すべてのサブエージェントを 1 つのモデルで実行](#run-every-subagent-on-one-model)しない限り、セッション用に既に選択したモデルより高価なモデルで実行されることはありません。

~~42 * **ツール**：読み取り専用ツール。Write と Edit は拒否されます~~42 * **ツール**: 読み取り専用ツール。Write と Edit は拒否されます。

~~43 * **目的**：ファイル検出、コード検索、コードベース探索~~43 * **目的**: ファイル検出、コード検索、コードベース探索

44 44

45 v2.1.198 以降、Explore はメイン会話のモデルを継承し、常に Haiku で実行されるわけではありません。Claude API では、継承されたモデルは Opus でキャップされます。より高いティアのメイン会話は Explore を Opus で実行し、Sonnet または Haiku のメイン会話は Explore をそのモデルで実行します。[Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform](/docs/ja/third-party-integrations)などの他のプロバイダーでは、Explore はメイン会話のモデルを直接継承します。45 v2.1.198 以降、Explore はメイン会話のモデルを継承し、常に Haiku で実行されるわけではありません。Claude API では、継承されたモデルは Opus でキャップされます。より高いティアのメイン会話は Explore を Opus で実行し、Sonnet または Haiku のメイン会話は Explore を同じモデルで実行します。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform などの[その他のプロバイダー](/docs/ja/third-party-integrations)では、Explore はメイン会話のモデルを直接継承します。

46 46

47 `Explore` という名前の[ユーザーまたはプロジェクトサブエージェント](#choose-the-subagent-scope)は組み込みをオーバーライドし、独自の `model` フィールドを保持するため、`model: haiku` で定義して探索を低コストモデルに保つことができます。47 [ユーザーまたはプロジェクトサブエージェント](#choose-the-subagent-scope)として名前付けられた`Explore`は、組み込みをオーバーライドし、独自の`model`フィールドを保持します。探索をより低コストのモデルに保つために、`model: haiku`で定義します。

48 48

49 Claude は、変更を加えずにコードベースを検索または理解する必要があるときに Explore に委譲します。これにより、探索結果がメインの会話コンテキストから除外されます。49 Claude は、変更を加えずにコードベースを検索または理解する必要がある場合、Explore に委譲します。これにより、探索結果がメイン会話コンテキストから除外されます。

50 50

51 Explore を呼び出すときに、Claude は徹底度レベルを指定します：ターゲット検索の場合は **quick**、バランスの取れた探索の場合は **medium**、包括的な分析の場合は **very thorough**。51 Explore を呼び出すとき、Claude は徹底度レベルを指定します。ターゲット検索の場合は**quick**、バランスの取れた探索の場合は**medium**、包括的な分析の場合は**very thorough**です。

52 </Tab>52 </Tab>

53 53

54 <Tab title="Plan">54 <Tab title="Plan">

55 [プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)中にプランを提示する前にコンテキストを収集するために使用される研究エージェント。55 [プランモード](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)中にプランを提示する前にコンテキストを収集するために使用される研究エージェント。

56 56

57 * **モデル**：メイン会話から継承されます。ただし、`CLAUDE_CODE_SUBAGENT_MODEL` を設定して[すべてのサブエージェントを 1 つのモデルで実行](#run-every-subagent-on-one-model)する場合を除きます57 * **モデル**: メイン会話から継承されます。ただし、`CLAUDE_CODE_SUBAGENT_MODEL`を設定して[すべてのサブエージェントを 1 つのモデルで実行](#run-every-subagent-on-one-model)する場合を除きます。

~~58 * **ツール**：読み取り専用ツール。Write と Edit は拒否されます~~58 * **ツール**: 読み取り専用ツール。Write と Edit は拒否されます。

~~59 * **目的**：計画のためのコードベース研究~~59 * **目的**: 計画のためのコードベース研究

60 60

61 プランモード中に Claude がコードベースを理解する必要がある場合、研究を Plan サブエージェントに委譲して、探索出力がメイン会話が読み取り専用のままである間に別のコンテキストウィンドウに留まるようにします。61 プランモード中で Claude がコードベースを理解する必要がある場合、探索出力が別のコンテキストウィンドウに留まるように、Plan サブエージェントに研究を委譲し、メイン会話は読み取り専用のままです。

62 </Tab>62 </Tab>

63 63

64 <Tab title="General-purpose">64 <Tab title="General-purpose">

~~65 探索と実行の両方を必要とする複雑なマルチステップタスク向けの有能なエージェント。~~65 探索とアクションの両方を必要とする複雑なマルチステップタスク用の有能なエージェント。

66 66

67 * **モデル**：[`CLAUDE_CODE_SUBAGENT_MODEL`](#choose-a-model) モデル（設定した場合で、他の方法でモデルが割り当てられていない場合）、それ以外はメイン会話のモデル。[モデルを選択](#choose-a-model)は完全な順序を示し、[すべてのサブエージェントを 1 つのモデルで実行](#run-every-subagent-on-one-model)は変数がこれらのソースをオーバーライドする方法を示します67 * **モデル**: [`CLAUDE_CODE_SUBAGENT_MODEL`](#choose-a-model)モデル（設定した場合で、他の何もモデルを別の方法で割り当てない場合）、それ以外の場合はメイン会話のモデル。[モデルを選択](#choose-a-model)は完全な順序を示し、[すべてのサブエージェントを 1 つのモデルで実行](#run-every-subagent-on-one-model)は変数がこれらのソースをオーバーライドする方法を示します。

~~68 * **ツール**：[サブエージェントで利用可能](#available-tools)なすべてのツール~~68 * **ツール**: [サブエージェントで利用可能](#available-tools)なすべてのツール

~~69 * **目的**：複雑な研究、マルチステップ操作、コード変更~~69 * **目的**: 複雑な研究、マルチステップ操作、コード変更

70 70

71 Claude は、タスクが探索と変更の両方を必要とする場合、結果を解釈するための複雑な推論が必要な場合、または複数の依存ステップがある場合に general-purpose に委譲します。71 Claude は、タスクが探索と変更の両方を必要とする場合、結果を解釈するための複雑な推論、または複数の依存ステップが必要な場合、general-purpose に委譲します。

72 </Tab>72 </Tab>

73 73

74 <Tab title="Other">74 <Tab title="Other">

75 Claude Code には、特定のタスク向けの追加のヘルパーエージェントが含まれています。これらは通常自動的に呼び出されるため、直接使用する必要はありません。75 Claude Code には、特定のタスク用の追加のヘルパーエージェントが含まれています。これらは通常自動的に呼び出されるため、直接使用する必要はありません。

76 76

77 | エージェント | モデル | Claude が使用する場合 |77 | エージェント | モデル | Claude が使用する場合 |

78 | :---------------- | :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |78 | :---------------- | :------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

79 | claude | 独自のものはありません。Claude がサブエージェントとして生成する場合は[モデル順序](#choose-a-model)に従います | タスクがより特化したエージェントに適合しない場合。[サブエージェントで利用可能](#available-tools)なすべてのツールを備えたキャッチオール。また、ディスパッチされた[バックグラウンドセッション](/docs/ja/agent-view)のデフォルトエージェント。[セッションが開始される方法に応じて、開始する権限モード](/docs/ja/agent-view#permission-mode-model-and-effort) |79 | claude | 独自のモデルはありません。Claude がサブエージェントとして生成する場合は[モデル順序](#choose-a-model)に従います | タスクがより特化したエージェントに適合しない場合。[サブエージェントで利用可能](#available-tools)なすべてのツールを備えたキャッチオール。また、ディスパッチされた[バックグラウンドセッション](/docs/ja/agent-view)のデフォルトエージェント。[セッションが開始される方法に応じて、開始される権限モード](/docs/ja/agent-view#permission-mode-model-and-effort)。 |

82 </Tab>82 </Tab>

83</Tabs>83</Tabs>

84 84

~~85組み込みサブエージェントはデフォルトでインタラクティブセッションに登録されます。これらを制限するには：~~85組み込みサブエージェントはインタラクティブセッションでデフォルトで登録されます。これらを制限するには：

86 86

87* 特定の組み込みタイプをブロックするには、[特定のサブエージェントを無効にする](#disable-specific-subagents)に示されているように `permissions.deny` に追加します。87* 特定の組み込みタイプをブロックするには、[特定のサブエージェントを無効にする](#disable-specific-subagents)に示されているように、`permissions.deny`に追加します。

~~88* Claude がサブエージェントに委譲することを防ぐには、[`permissions.deny`](/docs/ja/permissions#tool-specific-permission-rules)で `Agent` ツール自体を拒否します。~~88* Claude がサブエージェントに委譲するのを防ぐには、[`permissions.deny`](/docs/ja/permissions#tool-specific-permission-rules)で`Agent`ツール自体を拒否します。

89* 組み込みの `Explore` と `Plan` サブエージェントのみを削除するには、[`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1`](/docs/ja/env-vars)を設定します。Claude はファイルを直接読み取り、探索し、サブエージェントに委譲する代わりに実行します。Claude Code v2.1.198 以降が必要です。89* 組み込みの`Explore`および`Plan`サブエージェントのみを削除するには、[`CLAUDE_CODE_DISABLE_EXPLORE_PLAN_AGENTS=1`](/docs/ja/env-vars)を設定します。Claude はファイルを直接読み取り、探索し、サブエージェントに委譲しません。Claude Code v2.1.198 以降が必要です。

90* [非インタラクティブモード](/docs/ja/headless)および [Agent SDK](/docs/ja/agent-sdk/overview)では、[`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/ja/env-vars)を設定して、すべての組み込みタイプを削除し、独自のものだけを提供します。90* [非インタラクティブモード](/docs/ja/headless)および[Agent SDK](/docs/ja/agent-sdk/overview)では、[`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/docs/ja/env-vars)を設定して、すべての組み込みタイプを削除し、独自のタイプのみを提供します。

91 91

92`subagent_type` を省略した Agent ツール呼び出しは、セッションに [`subagent_type is required`](/docs/ja/errors#subagent-type-is-required) にフォールバックする `general-purpose` サブエージェントがない場合に失敗します。92サブエージェント型を省略する Agent ツール呼び出しは、セッションにフォールバックする general-purpose サブエージェントがない場合、[`subagent_type is required`](/docs/ja/errors#subagent-type-is-required)で失敗します。

93 93

94これらの組み込みサブエージェント以外に、カスタムプロンプト、ツール制限、権限モード、hooks、および skills を使用して独自のサブエージェントを作成できます。以下のセクションでは、開始方法とサブエージェントのカスタマイズ方法を示します。94これらの組み込みサブエージェント以外に、カスタムプロンプト、ツール制限、権限モード、フック、およびスキルを使用して独自のサブエージェントを作成できます。次のセクションでは、サブエージェントの使用を開始し、カスタマイズする方法を示します。

95 95

96<h2 id="quickstart-create-your-first-subagent">96<h2 id="quickstart-create-your-first-subagent">

97 クイックスタート：最初のサブエージェントを作成する97 クイックスタート：最初のサブエージェントを作成する

230 </Tab>230 </Tab>

231</Tabs>231</Tabs>

232 232

233`--agents` フラグは `prompt` フィールドと以下の [frontmatter](#supported-frontmatter-fields) フィールドを含む JSON を受け入れます。`description`、`tools`、`disallowedTools`、`model`、`permissionMode`、`mcpServers`、`hooks`、`maxTurns`、`skills`、`initialPrompt`、`memory`、`effort`、`background`、`omitClaudeMd`、および `isolation`。システムプロンプトには `prompt` を使用します。これはファイルベースのサブエージェントのマークダウン本体と同等です。233`--agents` フラグは `prompt` フィールドと以下の [frontmatter](#supported-frontmatter-fields) フィールドを含む JSON を受け入れます。`description`、`tools`、`disallowedTools`、`model`、`permissionMode`、`mcpServers`、`hooks`、`maxTurns`、`skills`、`initialPrompt`、`memory`、`effort`、`background`、`omitClaudeMd`、および `isolation`。システムプロンプトには `prompt` を使用します。これはファイルベースのサブエージェントのマークダウン本体と同等です。`color` と `experimental` はここでは受け入れられず、拒否されるのではなく無視されます。

234 234

235JSON の各トップレベルキーはエージェントの名前です。名前を `-` で始めないでください。235JSON の各トップレベルキーはエージェントの名前です。名前を `-` で始めないでください。

236 236

295 295

296メイン会話自体が worktree で分離されて実行される場合、Claude Code はセッションとそれがスポーンするすべてのサブエージェント（`isolation: worktree` なしのサブエージェントを含む）に同じチェックを適用します。[Claude Code が分離を強制する方法](/docs/ja/worktrees#how-claude-code-enforces-isolation)を参照してください。296メイン会話自体が worktree で分離されて実行される場合、Claude Code はセッションとそれがスポーンするすべてのサブエージェント（`isolation: worktree` なしのサブエージェントを含む）に同じチェックを適用します。[Claude Code が分離を強制する方法](/docs/ja/worktrees#how-claude-code-enforces-isolation)を参照してください。

297 297

298<h4 id="supported-frontmatter-fields">298<h3 id="supported-frontmatter-fields">

299 サポートされている frontmatter フィールド299 Frontmatter リファレンス

300</h4>300</h3>

301

302以下のフィールドは YAML [frontmatter](/docs/ja/glossary#frontmatter) で使用できます。`name` と `description` のみが必須です。

301 303

302以下のフィールドは YAML frontmatter で使用できます。`name` と `description` のみが必須です。304複数単語のフィールド名は `maxTurns` や `disallowedTools` などの camelCase を使用し、テーブルと正確に一致する必要があります。Claude Code は認識しないフィールドを無視し、エラーを報告しません。サブエージェントファイルが読み込まれなかった理由を確認するには、[Claude Code がスキップするサブエージェントファイル](#subagent-files-claude-code-skips)を参照してください。

303 305

304| フィールド | 必須 | 説明 |306| フィールド | 必須 | 説明 |

305| :---------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |307| :---------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

306| `name` | はい | 小文字とハイフンを使用した一意の識別子。[Hooks](/docs/ja/hooks#subagentstart)はこの値を `agent_type` として受け取ります。ファイル名は一致する必要はありません。名前に `:` を含めることはできません。これは [plugin-scoped identifiers](/docs/ja/plugins)（`my-plugin:reviewer` など）用に予約されています。Claude Code は `:` を含む名前のファイルを読み込まず、デバッグログにエラーをログします。v2.1.218 より前では、そのような名前は受け入れられていました |308| `name` | はい | 一意の識別子（`code-reviewer` や `reviewer-v2` など）。[フック](/docs/ja/hooks#subagentstart)はこの値を `agent_type` として受け取ります。ファイル名は一致する必要はありません。名前に `:` を含めることはできません。これは [plugin-scoped identifiers](/docs/ja/plugins)（`my-plugin:reviewer` など）用に予約されています。Claude Code は `:` を含む名前のファイルを読み込まず、デバッグログにエラーをログします。v2.1.218 より前では、そのような名前は受け入れられていました |

307| `description` | はい | Claude がこのサブエージェントに委任すべき場合 |309| `description` | はい | Claude がこのサブエージェントに委任すべき場合 |

308| `tools` | いいえ | サブエージェントが使用できる[ツール](#available-tools)。省略した場合、サブエージェントで利用可能なすべてのツールを継承します。リスト内のエントリがツールに解決されない場合、サブエージェントは通常、エントリに名前を付けるエラーで[起動に失敗](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)します。スキルをコンテキストにプリロードするには、ここで `Skill` をリストするのではなく、`skills` フィールドを使用します |310| `tools` | いいえ | サブエージェントが使用できる[ツール](#available-tools)。`Read, Grep, Glob` や YAML リストなどのカンマ区切り文字列として。省略した場合、サブエージェントで利用可能なすべてのツールを継承します。リスト内のエントリがツールに解決されない場合、サブエージェントは通常、エントリに名前を付けるエラーで[起動に失敗](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)します。スキルをコンテキストにプリロードするには、ここで `Skill` をリストするのではなく、`skills` フィールドを使用します |

309| `disallowedTools` | いいえ | 継承または指定されたリストから削除するツール。`Bash(git push *)` などの指定子を持つエントリは、[ツール全体](#available-tools)を削除します |311| `disallowedTools` | いいえ | 継承または指定されたリストから削除するツール。`tools` と同じ形式。`Bash(git push *)` などの指定子を持つエントリは、[ツール全体](#available-tools)を削除します |

310| `model` | いいえ | 使用する[モデル](#choose-a-model)。`sonnet`、`opus`、`haiku`、`fable`、`claude-opus-5` などの完全なモデル ID、または `inherit`。省略した場合、Claude Code は[サブエージェントモデル順序](#choose-a-model)でモデルを選択します |312| `model` | いいえ | 使用する[モデル](#choose-a-model)。`sonnet`、`opus`、`haiku`、`fable`、`claude-opus-5-5` などの完全なモデル ID、または `inherit`。省略した場合、Claude Code は[サブエージェントモデル順序](#choose-a-model)でモデルを選択します |

311| `permissionMode` | いいえ | [権限モード](#permission-modes)。`default`、`acceptEdits`、`auto`、`dontAsk`、`bypassPermissions`、`plan`、または `default` のエイリアスとしての `manual`。`manual` エイリアスには Claude Code v2.1.200 以降が必要です。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |313| `permissionMode` | いいえ | [権限モード](#permission-modes)。`default`、`acceptEdits`、`auto`、`dontAsk`、`bypassPermissions`、`plan`、または `default` のエイリアスとしての `manual`。`manual` エイリアスには Claude Code v2.1.200 以降が必要です。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

312| `maxTurns` | いいえ | サブエージェントが停止する前の最大 agentic ターン数。サブエージェントが制限に達すると、Claude Code は出力を部分的としてマークして返し、Claude は[再開](#resume-subagents)して続行できます。部分的なマーキングには Claude Code v2.1.246 以降が必要です |314| `maxTurns` | いいえ | サブエージェントが停止する前の最大 agentic ターン数。サブエージェントが制限に達すると、Claude Code は出力を部分的としてマークして返し、Claude は[再開](#resume-subagents)して続行できます。部分的なマーキングには Claude Code v2.1.246 以降が必要です |

313| `skills` | いいえ | 起動時にサブエージェントのコンテキストにプリロードする[スキル](/docs/ja/skills)。説明のみではなく、完全なスキルコンテンツが注入されます。サブエージェントは、Skill ツールを通じてリストされていないプロジェクト、ユーザー、およびプラグインスキルを呼び出すことができます |315| `skills` | いいえ | 起動時にサブエージェントのコンテキストにプリロードする[スキル](/docs/ja/skills)。説明のみではなく、完全なスキルコンテンツが注入されます。サブエージェントは、Skill ツールを通じてリストされていないプロジェクト、ユーザー、およびプラグインスキルを呼び出すことができます |

319| `effort` | いいえ | このサブエージェントがアクティブな場合の努力レベル。セッション努力レベルをオーバーライドします。デフォルト。セッションから継承します。オプション。`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルに依存します |321| `effort` | いいえ | このサブエージェントがアクティブな場合の努力レベル。セッション努力レベルをオーバーライドします。デフォルト。セッションから継承します。オプション。`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルに依存します |

320| `isolation` | いいえ | サブエージェントを一時的な[git worktree](/docs/ja/worktrees)で実行するには `worktree` に設定します。これにより、親セッションの `HEAD` ではなく、デフォルトで[デフォルトブランチ](/docs/ja/worktrees#choose-the-base-branch)からブランチされたリポジトリの分離されたコピーが提供されます。サブエージェントが変更を加えない場合、worktree は自動的にクリーンアップされます |322| `isolation` | いいえ | サブエージェントを一時的な[git worktree](/docs/ja/worktrees)で実行するには `worktree` に設定します。これにより、親セッションの `HEAD` ではなく、デフォルトで[デフォルトブランチ](/docs/ja/worktrees#choose-the-base-branch)からブランチされたリポジトリの分離されたコピーが提供されます。サブエージェントが変更を加えない場合、worktree は自動的にクリーンアップされます |

321| `color` | いいえ | タスクリストとトランスクリプトでのサブエージェントの表示カラー。`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、または `cyan` を受け入れます |323| `color` | いいえ | タスクリストとトランスクリプトでのサブエージェントの表示カラー。`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、または `cyan` を受け入れます |

322| `initialPrompt` | いいえ | このエージェントがメインセッションエージェント（`--agent` または `agent` 設定経由）として実行される場合、最初のユーザーターンとして自動送信されます。[コマンド](/docs/ja/commands)と[スキル](/docs/ja/skills)が処理されます。ユーザー提供のプロンプトの前に付加されます |324| `initialPrompt` | いいえ | このエージェントがメインセッションエージェント（`--agent` または `agent` 設定経由）として実行される場合、最初のユーザーターンとして自動送信されます。[コマンド](/docs/ja/commands)と[スキル](/docs/ja/skills)が処理されます。ユーザー提供のプロンプトの前に付加されます。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

323| `experimental` | いいえ | 実験的オプションのマップ。その `cacheTtl` キーを `5m` または `1h` に設定して、このサブエージェントのリクエストの[プロンプトキャッシュライフタイム](/docs/ja/prompt-caching#choose-the-ttl-yourself)を選択します。frontmatter の[キャッシュライフタイム優先順位](/docs/ja/prompt-caching#choose-the-ttl-yourself)の場所。Claude Code は他の値を無視し、Claude サブスクリプションが使用クレジットを使用している間は `1h` を無視し、サブエージェントファイルからのみフィールドを読み取ります。Claude Code v2.1.248 以降が必要です |325| `experimental` | いいえ | 実験的オプションのマップ。その `cacheTtl` キーを `5m` または `1h` に設定して、このサブエージェントのリクエストの[プロンプトキャッシュライフタイム](/docs/ja/prompt-caching#choose-the-ttl-yourself)を選択します。frontmatter の[キャッシュライフタイム優先順位](/docs/ja/prompt-caching#choose-the-ttl-yourself)の場所。Claude Code は他の値を無視し、Claude サブスクリプションが使用クレジットを使用している間は `1h` を無視し、サブエージェントファイルからのみフィールドを読み取ります。Claude Code v2.1.248 以降が必要です |

324 326

325`cacheTtl` を frontmatter のトップレベルではなく、`experimental` マップ内に書き込みます。327`cacheTtl` を frontmatter のトップレベルではなく、`experimental` マップ内に書き込みます。

362`model` フィールドはサブエージェントが使用するモデルを制御します。364`model` フィールドはサブエージェントが使用するモデルを制御します。

363 365

364* **モデルエイリアス**。利用可能なエイリアスの 1 つを使用します。`sonnet`、`opus`、`haiku`、または `fable`366* **モデルエイリアス**。利用可能なエイリアスの 1 つを使用します。`sonnet`、`opus`、`haiku`、または `fable`

365* **完全なモデル ID**。`claude-opus-5` または `claude-sonnet-5` などの完全なモデル ID を使用します。`--model` フラグと同じ値を受け入れます367* **完全なモデル ID**。`claude-opus-5-5` または `claude-sonnet-5` などの完全なモデル ID を使用します。`--model` フラグと同じ値を受け入れます

366* **inherit**。メイン会話と同じモデルを使用します368* **inherit**。メイン会話と同じモデルを使用します

367 369

368Claude がサブエージェントを呼び出すとき、その特定の呼び出しに対して `model` パラメータを渡すこともできます。Claude Code はサブエージェントのモデルをこの順序で解決します。370Claude がサブエージェントを呼び出すとき、その特定の呼び出しに対して `model` パラメータを渡すこともできます。Claude Code はサブエージェントのモデルをこの順序で解決します。

3723. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ja/model-config#environment-variables)環境変数。モデルエイリアスまたはモデル ID に設定した場合3743. [`CLAUDE_CODE_SUBAGENT_MODEL`](/docs/ja/model-config#environment-variables)環境変数。モデルエイリアスまたはモデル ID に設定した場合

3734. メイン会話のモデル3754. メイン会話のモデル

374 376

3772 つのケースでは、`opus` などのファミリエイリアスが、呼び出しごとのパラメータまたは frontmatter で、メイン会話のモデルの代わりに[エイリアスが指す](/docs/ja/model-config#model-aliases)バージョンに解決されます。

378

379* **メイン会話のモデルがそのファミリに属する**。サブエージェントはメイン会話の正確なモデル（`[1m]` サフィックスを含む）で実行されるため、メイン会話と同じ[拡張コンテキスト](/docs/ja/model-config#extended-context)ウィンドウを取得します。

380* **Claude Code がメイン会話のモデルファミリを判断できない。[Anthropic API 以外のプロバイダー](/docs/ja/third-party-integrations)上で**。これは Claude Code がバッキングモデルに解決していない[アプリケーション推論プロファイル ARN](/docs/ja/amazon-bedrock#iam-configuration)を持つ Amazon Bedrock で発生する可能性があります。このケースは `opus` エイリアスのみをカバーし、[`ANTHROPIC_DEFAULT_OPUS_MODEL`](/docs/ja/model-config#environment-variables)を設定した場合は適用されません。`opus` はその後、設定したモデルに解決されるため。

381

382`CLAUDE_CODE_SUBAGENT_MODEL` のエイリアスは、メイン会話のファミリに名前を付けた場合でも、常にエイリアスが指すバージョンに解決されます。

383

375`CLAUDE_CODE_SUBAGENT_MODEL` を単独で設定しても、組み込みの Explore および Plan サブエージェントが実行されるモデルは変わりません。変更するには、[すべてのサブエージェントを 1 つのモデルで実行](#run-every-subagent-on-one-model)を参照してください。384`CLAUDE_CODE_SUBAGENT_MODEL` を単独で設定しても、組み込みの Explore および Plan サブエージェントが実行されるモデルは変わりません。変更するには、[すべてのサブエージェントを 1 つのモデルで実行](#run-every-subagent-on-one-model)を参照してください。

376 385

377v2.1.251 より前では、`CLAUDE_CODE_SUBAGENT_MODEL` はこの順序で最初に来て、呼び出しごとのパラメータと frontmatter（`model: inherit` を含む）の両方をオーバーライドしました。386v2.1.251 より前では、`CLAUDE_CODE_SUBAGENT_MODEL` はこの順序で最初に来て、呼び出しごとのパラメータと frontmatter（`model: inherit` を含む）の両方をオーバーライドしました。

438* `EnterPlanMode`447* `EnterPlanMode`

439* `ExitPlanMode`。サブエージェントの [`permissionMode`](#permission-modes)が `plan` でない限り448* `ExitPlanMode`。サブエージェントの [`permissionMode`](#permission-modes)が `plan` でない限り

440* `ScheduleWakeup`449* `ScheduleWakeup`

441* `TaskOutput`

442* `WaitForMcpServers`450* `WaitForMcpServers`

443* `Workflow`451* `Workflow`

444 452

4452 番目のフィルタはバックグラウンドで実行されるサブエージェントに適用されます。`Agent` と `ExitPlanMode` を除き、これらはサブエージェントが実行される場所に関係なく最初のフィルタの条件に従います。バックグラウンドサブエージェントはすべての MCP ツールを保持しますが、これらの組み込みツールのみです。`Read`、`Grep`、`Glob`、`Bash`、`PowerShell`、`Edit`、`Write`、`NotebookEdit`、`WebFetch`、`WebSearch`、`TodoWrite`、`Skill`、`ToolSearch`、`EnterWorktree`、`ExitWorktree`、`Monitor`、`TaskStop`、`SendMessage`、および `Artifact`。それを報告するサブエージェント用の [`SubagentHandoff`](/docs/ja/tools-reference)。Claude Code はバックグラウンドサブエージェントから他のすべての組み込みツールを削除します。継承またはリストされているかどうかに関わらず、`tools` フィールドで。同じ定義はフォアグラウンドとバックグラウンドで異なるツールに解決できます。削除は、`tools` リストが[何も解決しない](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)場合を除き、エラーを報告しません。4532 番目のフィルタはバックグラウンドで実行されるサブエージェントに適用されます。`Agent` と `ExitPlanMode` を除き、これらはサブエージェントが実行される場所に関係なく最初のフィルタの条件に従います。バックグラウンドサブエージェントはすべての MCP ツールを保持しますが、これらの組み込みツールのみです。`Read`、`Grep`、`Glob`、`LSP`、`Bash`、`PowerShell`、`Edit`、`Write`、`NotebookEdit`、`WebFetch`、`WebSearch`、`TodoWrite`、`Skill`、`ToolSearch`、`EnterWorktree`、`ExitWorktree`、`Monitor`、`TaskStop`、`SendMessage`、および `Artifact`。それを報告するサブエージェント用の [`SubagentHandback`](/docs/ja/tools-reference)。Claude Code はバックグラウンドサブエージェントから他のすべての組み込みツールを削除します。継承またはリストされているかどうかに関わらず、`tools` フィールドで。同じ定義はフォアグラウンドとバックグラウンドで異なるツールに解決できます。削除は、`tools` リストが[何も解決しない](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)場合を除き、エラーを報告しません。

454

455v2.1.280 より前では、バックグラウンドサブエージェントは `LSP` を使用できませんでした。

446 456

447[`ListAgents`](/docs/ja/cross-session-messaging)は、他の組み込みツールと同様にこれらのフィルタに従います。フォアグラウンドサブエージェントは、クロスセッションメッセージングが有効なセッションで継承し、バックグラウンドサブエージェントは保持しません。457[`ListAgents`](/docs/ja/cross-session-messaging)は、他の組み込みツールと同様にこれらのフィルタに従います。フォアグラウンドサブエージェントは、クロスセッションメッセージングが有効なセッションで継承し、バックグラウンドサブエージェントは保持しません。

448 458

989 999

990スキャンはコンテンツが悪意があるかどうかを判断せず、レポート内の指示が何ができるかは変わりません。レポートが Claude に行わせるツール呼び出しは、セッションの [権限チェック](/docs/ja/permissions) と [サンドボックス](/docs/ja/sandboxing) を通じて実行されます。これは [サブエージェントが到達できるものを制限](#control-subagent-capabilities) する代わりではありません。1000スキャンはコンテンツが悪意があるかどうかを判断せず、レポート内の指示が何ができるかは変わりません。レポートが Claude に行わせるツール呼び出しは、セッションの [権限チェック](/docs/ja/permissions) と [サンドボックス](/docs/ja/sandboxing) を通じて実行されます。これは [サブエージェントが到達できるものを制限](#control-subagent-capabilities) する代わりではありません。

991 1001

1002サブエージェントの結果として Claude に返されるレポートは、サブエージェント出力としてマークするヘッダーの下に到達します。ヘッダーは、レポート内の指示または承認請求がサブエージェントの言葉であり、あなたからの権限を持たないことを述べています。

1003

1004[バックグラウンドサブエージェントのレポート](#run-subagents-in-foreground-or-background) は完了通知内に到達し、これはあなたからのメッセージではなく自動化されたイベントとしてマークされます。

1005

992<Note>1006<Note>

993 サブエージェント出力スキャンには Claude Code v2.1.210 以降が必要です。1007 サブエージェント出力スキャンには Claude Code v2.1.210 以降が必要です。

994</Note>1008</Note>

terminal-config.md +20 −6

Details

343 大量のコンテンツを貼り付ける343 大量のコンテンツを貼り付ける

344</h2>344</h2>

345 345

346800 文字以上または 3 行以上をプロンプトに貼り付けると、Claude Code は入力を `[Pasted text #1 +120 lines]` などのプレースホルダーに折りたたんで、入力ボックスが使用可能な状態を保ちます。ターミナルウィンドウが 12 行未満の場合、行制限が低下するため、Claude Code は 11 行で 3 行の貼り付けを折りたたみ、10 行以下で複数行の貼り付けを折りたたみます。Claude Code は送信時に完全なコンテンツを送信します。346800 文字以上または 3 行以上をプロンプトに貼り付けると、Claude Code は入力を `[Pasted text #1 +120 lines]` などのプレースホルダーに折りたたんで、入力ボックスが使用可能な状態を保ちます。送信時に完全なコンテンツを送信します。ファイル全体やログが長いなど、非常に大きな入力の場合は、コンテンツをファイルに書き込んで、貼り付けの代わりに Claude にそれを読むよう依頼してください。会話トランスクリプトが読みやすくなり、Claude が後のターンでパスによってファイルを参照できます。VS Code 統合ターミナルは、非常に大きな貼り付けから Claude Code に到達する前に文字をドロップできるため、そこではファイルを使用してください。

347 347

348`Ctrl+W` や `Ctrl+K` などの単語または行ショートカットで削除するか、`df]` などの `f`/`t` モーションを使用した vim 削除で削除し、削除範囲がプレースホルダー内に達する場合、Claude Code はプレースホルダー全体を削除します。削除を貼り付け直して復元できます。単語または行ショートカットの後に [`Ctrl+Y`](/docs/ja/interactive-mode#text-editing) を使用するか、vim 削除の後に [`p` NORMAL モード](/docs/ja/interactive-mode#editing-normal-mode) で復元できます。348貼り付けに [目に見えない Unicode 文字](/docs/ja/interactive-mode#invisible-characters-in-prompts) が含まれている場合、Claude Code は Enter キーを押すときにそれらを削除し、クリーンアップされたプロンプトを入力ボックスに戻して、別の Enter で送信できるようにします。

349 349

350Claude Code は折りたたまれたコンテンツを `~/.claude/paste-cache/` に保持するため、[コマンド履歴](/docs/ja/interactive-mode#command-history) からプロンプトを呼び出して再送信すると、Claude Code は完全な貼り付けコンテンツを再度送信します。これは後のセッションでも含まれます。保持期間スイープがキャッシュファイルを削除するまで続きます。350<h3 id="how-claude-treats-pasted-text">

351 Claude が貼り付けたテキストをどのように処理するか

352</h3>

353

354送信すると、Claude は各 `[Pasted text #N]` プレースホルダーの背後にあるコンテンツを、他の場所から貼り付けたテキストとして表示され、入力したテキストではなく表示されます。Claude には、貼り付けには入力していない指示が含まれる可能性があり、入力したメッセージがそれを要求する場所でのみ指示に従うよう指示されます。[機能フラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching) しないセッションでは、貼り付けはマークされません。

351 355

352Claude Code は [`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) より古いキャッシュファイルを削除し、[保持期間スイープルール](/docs/ja/claude-directory#cleaned-up-automatically) に従うため、呼び出されたプロンプトは存在しなくなった貼り付けテキストを参照できます。そのようなプロンプトを送信すると、Claude Code はリテラル `[Pasted text #N]` 文字列を送信することはなく、不足している貼り付けの名前を示す通知を表示します。356<h3 id="delete-and-restore-a-collapsed-paste">

357 折りたたまれた貼り付けを削除して復元する

358</h3>

359

360`Ctrl+W` や `Ctrl+K` などの単語または行ショートカットで削除するか、`df]` などの `f`/`t` モーションを使用した vim 削除で削除し、削除範囲が `[Pasted text #N]` プレースホルダー内に達する場合、Claude Code はプレースホルダー全体を削除します。復元するには、単語または行ショートカットの後に [`Ctrl+Y`](/docs/ja/interactive-mode#text-editing) で削除を貼り付け直すか、vim 削除の後に [`p` NORMAL モード](/docs/ja/interactive-mode#editing-normal-mode) で復元してください。

361

362<h3 id="recall-a-prompt-that-had-pasted-text">

363 貼り付けたテキストを含むプロンプトを呼び出す

364</h3>

365

366Claude Code は折りたたまれたコンテンツを各 `[Pasted text #N]` プレースホルダーの背後に `~/.claude/paste-cache/` に保持するため、[コマンド履歴](/docs/ja/interactive-mode#command-history) からプロンプトを呼び出して再送信すると、完全な貼り付けコンテンツが再度送信され、後のセッションでも含まれます。

367

368[保持期間スイープルール](/docs/ja/claude-directory#cleaned-up-automatically) に従い、[`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) より古いキャッシュファイルは削除されるため、呼び出されたプロンプトは存在しなくなった貼り付けテキストを参照できます。そのようなプロンプトを送信すると、Claude Code はリテラル `[Pasted text #N]` 文字列を送信することはなく、不足している貼り付けの名前を示す通知を表示します。

353 369

354* テキストが残っているプレーンプロンプトでは、Claude Code はプレースホルダーを削除して残りのテキストを送信します。370* テキストが残っているプレーンプロンプトでは、Claude Code はプレースホルダーを削除して残りのテキストを送信します。

355* [シェルモード](/docs/ja/interactive-mode#shell-mode-with-prefix) コマンドまたは `/` コマンドでは、削除が実行内容を変更する可能性があり、プロンプトの削除が空のままになる場合、Claude Code は送信をキャンセルし、元のテキストを入力に保持します。プレースホルダーはまだ含まれています。プレースホルダーを削除するか、コマンドを編集してから再送信してください。371* [シェルモード](/docs/ja/interactive-mode#shell-mode-with-prefix) コマンドまたは `/` コマンドでは、削除が実行内容を変更する可能性があり、プロンプトの削除が空のままになる場合、Claude Code は送信をキャンセルし、元のテキストを入力に保持します。プレースホルダーはまだ含まれています。プレースホルダーを削除するか、コマンドを編集してから再送信してください。

356 372

357VS Code 統合ターミナルは、非常に大きな貼り付けから Claude Code に到達する前に文字をドロップできるため、そこではファイルベースのワークフローを優先してください。ファイル全体やログが長いなど、非常に大きな入力の場合は、コンテンツをファイルに書き込んで、貼り付けの代わりに Claude にそれを読むよう依頼してください。これにより、会話トランスクリプトが読みやすくなり、Claude が後のターンでパスによってファイルを参照できます。

~~358~~

359<h2 id="edit-prompts-with-vim-keybindings">373<h2 id="edit-prompts-with-vim-keybindings">

360 Vim キーバインディングでプロンプトを編集する374 Vim キーバインディングでプロンプトを編集する

361</h2>375</h2>

third-party-integrations.md +2 −2

Details

86 86

87ほとんどの組織では、Claude for Teams または Claude for Enterprise が最適なエクスペリエンスを提供します。チームメンバーは、単一のサブスクリプション、一元化された請求、インフラストラクチャセットアップが不要で、Claude Code と Web 上の Claude の両方にアクセスできます。87ほとんどの組織では、Claude for Teams または Claude for Enterprise が最適なエクスペリエンスを提供します。チームメンバーは、単一のサブスクリプション、一元化された請求、インフラストラクチャセットアップが不要で、Claude Code と Web 上の Claude の両方にアクセスできます。

88 88

89**Claude for Teams** はセルフサービスで、コラボレーション機能、管理ツール、請求管理が含まれています。迅速に開始する必要がある小規模なチームに最適です。89**Claude for Teams** はセルフサービスで、コラボレーション機能、管理ツール、SSO、請求管理、および[サーバー管理設定](/docs/ja/server-managed-settings)（組織全体の Claude Code 構成用）が含まれています。迅速に開始する必要がある小規模なチームに最適です。

90 90

91**Claude for Enterprise** は SSO とドメインキャプチャ、ロールベースの権限、コンプライアンス API アクセス、および組織全体の Claude Code 構成をデプロイするための管理ポリシー設定を追加します。セキュリティとコンプライアンス要件がある大規模な組織に最適です。91**Claude for Enterprise** はドメインキャプチャ、ロールベースの権限、およびコンプライアンス API アクセスを追加します。セキュリティとコンプライアンス要件がある大規模な組織に最適です。

92 92

93[Team プラン](https://support.claude.com/en/articles/9266767-what-is-the-team-plan)と[Enterprise プラン](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan)の詳細をご覧ください。93[Team プラン](https://support.claude.com/en/articles/9266767-what-is-the-team-plan)と[Enterprise プラン](https://support.claude.com/en/articles/9797531-what-is-the-enterprise-plan)の詳細をご覧ください。

94 94

troubleshoot-install.md +115 −115

Details

28| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Homebrew を更新する](#homebrew-cask-unavailable-or-outdated) |28| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Homebrew を更新する](#homebrew-cask-unavailable-or-outdated) |

30| `A parameter cannot be found that matches parameter name 'fsSL'` | [Windows インストーラーコマンドを使用する](#wrong-install-command-on-windows) |30| `A parameter cannot be found that matches parameter name 'fsSL'` | [Windows インストーラーコマンドを使用する](#wrong-install-command-on-windows) |

337```337```

338 338

339<h2 id="common-installation-issues">339<h2 id="common-installation-issues">

340 一般的なインストール問題340 インストールの一般的な問題

341</h2>341</h2>

342 342

343これらは最も頻繁に遭遇するインストール問題とその解決策です。343これらは最も頻繁に遭遇するインストール問題とその解決策です。

346 インストールスクリプトがシェルスクリプトではなく HTML を返す346 インストールスクリプトがシェルスクリプトではなく HTML を返す

347</h3>347</h3>

348 348

349インストールコマンドを実行するときに、次のいずれかのエラーが表示される場合があります：349インストールコマンドを実行すると、次のいずれかのエラーが表示される場合があります。

350 350

351```text theme={null}351```text theme={null}

352bash: line 1: syntax error near unexpected token `<'352bash: line 1: syntax error near unexpected token `<'

353bash: line 1: `<!DOCTYPE html>'353bash: line 1: `<!DOCTYPE html>'

354```354```

355 355

356PowerShell では、同じ問題は解析エラーとして表示され、`iex` が HTML と CSS を PowerShell として実行しようとします：356PowerShell では、同じ問題が返されたページを指すパースエラーとして表示され、`iex` が HTML と CSS を PowerShell として実行しようとします。

357 357

358```text theme={null}358```text theme={null}

359iex : At line:1 char:2310359iex : At line:1 char:2310

362...362...

363```363```

364 364

365表現は PowerShell バージョンとシステム言語によって異なります。`Missing expression after unary operator '--'` または `ParserError` と `ParseException` が表示される場合があります。引用符で囲まれたテキスト内の HTML タグまたは CSS はこの失敗を識別します。代わりに `-OutFile install.ps1` でダウンロードする場合、保存されたファイルは同じウェブページであるため、それも役に立ちません。365表現は PowerShell のバージョンとシステム言語によって異なります。`Missing expression after unary operator '--'` または `ParserError` と `ParseException` が表示される場合があります。引用符で囲まれたテキスト内の HTML タグまたは CSS はこの失敗を示します。代わりに `-OutFile install.ps1` でダウンロードしても、保存されたファイルは同じウェブページなので、それは役に立ちません。

366 366

367リクエストのルーティング方法によっては、HTML ボディなしの 403 が表示される場合があります：367リクエストのルーティング方法によっては、HTML ボディなしで 403 が表示される場合があります。

368 368

369```text theme={null}369```text theme={null}

370curl: (22) The requested URL returned error: 403370curl: (22) The requested URL returned error: 403

371```371```

372 372

373これらはすべて、インストール URL がインストールスクリプトではなく HTML ページまたはエラーステータスを返したことを意味します。HTML ページが「App unavailable in region」と表示される場合、Claude Code はお客様の国では利用できません。[サポートされている国](https://www.anthropic.com/supported-countries)を参照してください。373これらはすべて、インストール URL がインストールスクリプトではなく HTML ページまたはエラーステータスを返したことを意味します。HTML ページに「App unavailable in region」と表示されている場合、Claude Code はお客様の国では利用できません。[サポートされている国](https://www.anthropic.com/supported-countries)を参照してください。

374 374

375ボディなしの 403 は多くの場合同じ原因がありますが、企業プロキシまたはダウンロードをブロックしているファイアウォールからも発生する可能性があります。サポートされている国にいるのに 403 が表示される場合は、以下の代替インストーラーを試す前に[ネットワーク接続を確認する](#check-network-connectivity)を実行してください。これらは同じホストに到達するためです。375ボディなしの 403 は多くの場合同じ原因ですが、企業プロキシまたはファイアウォールがダウンロードをブロックしている場合もあります。サポートされている国にいるのに 403 が表示される場合は、以下の代替インストーラーを試す前に[ネットワーク接続を確認](#check-network-connectivity)してください。これらは同じホストに到達するためです。

376 376

377それ以外の場合、これはネットワークの問題、地域的なルーティング、または一時的なサービス中断が原因で発生する可能性があります。377それ以外の場合、これはネットワークの問題、地域的なルーティング、または一時的なサービス中断が原因で発生する可能性があります。

378 378

379**解決策：**379**解決策：**

380 380

3811. **別のインストール方法を使用してください**：3811. **別のインストール方法を使用する**：

382 382

383 macOS では、Homebrew 経由でインストールしてください：383 macOS では、Homebrew 経由でインストールします。

384 384

385 ```bash theme={null}385 ```bash theme={null}

386 brew install --cask claude-code386 brew install --cask claude-code

387 ```387 ```

388 388

389 Windows では、WinGet 経由でインストールしてください：389 Windows では、WinGet 経由でインストールします。

390 390

391 ```powershell theme={null}391 ```powershell theme={null}

392 winget install Anthropic.ClaudeCode392 winget install Anthropic.ClaudeCode

393 ```393 ```

394 394

395 その後、`claude --version` を実行して確認してください。コマンドは `2.1.211 (Claude Code)` などのバージョン番号を出力します。シェルが `claude` が見つからないと報告する場合は、新しいターミナルウィンドウを開いて再試行してください。インストール元のセッションは古い `PATH` を保持しています。395 次に `claude --version` を実行して確認します。コマンドは `2.1.211 (Claude Code)` などのバージョン番号を出力します。シェルが `claude` が見つからないと報告する場合は、新しいターミナルウィンドウを開いて再試行してください。インストール元のセッションは古い `PATH` を保持しています。

396 396

3972. **数分後に再試行してください**：問題は一時的なことが多いです。待ってから元のコマンドを再度試してください。3972. **数分後に再試行する**：この問題は多くの場合一時的です。待機して元のコマンドを再度試してください。

398 398

399<h3 id="command-not-found-claude-after-installation">399<h3 id="command-not-found-claude-after-installation">

400 インストール後に `command not found: claude`400 インストール後の `command not found: claude`

401</h3>401</h3>

402 402

403インストールが完了しましたが、`claude` が機能しません。正確なエラーはプラットフォームによって異なります：403インストールは完了しましたが、`claude` が機能しません。正確なエラーはプラットフォームによって異なります。

404 404

405| プラットフォーム | エラーメッセージ |405| プラットフォーム | エラーメッセージ |

406| :---------- | :--------------------------------------------------------------------- |406| :---------- | :--------------------------------------------------------------------- |

411 411

412これは、インストールディレクトリがシェルの検索パスに含まれていないことを意味します。各プラットフォームの修正については、[PATH を確認する](#verify-your-path)を参照してください。412これは、インストールディレクトリがシェルの検索パスにないことを意味します。各プラットフォームの修正については、[PATH を確認](#verify-your-path)を参照してください。

413 413

414<h3 id="curl-56-failure-writing-output-to-destination">414<h3 id="curl-56-failure-writing-output-to-destination">

415 `curl: (56) Failure writing output to destination`415 `curl: (56) Failure writing output to destination`

417 417

418`curl ... | bash` コマンドはスクリプトをダウンロードして Bash にパイプして実行します。このエラーと関連する `curl: (23) Failure writing output to destination` は、Bash がスクリプト全体を受け取らなかったことを意味します。終了コード 56 はダウンロード自体が中断されたことを示し、終了コード 23 は curl がパイプに受け取ったものを書き込めなかったことを示します。通常は Bash が早期に終了したためです。418`curl ... | bash` コマンドはスクリプトをダウンロードして Bash にパイプして実行します。このエラーと関連する `curl: (23) Failure writing output to destination` は、Bash がスクリプト全体を受け取らなかったことを意味します。終了コード 56 はダウンロード自体が中断されたことを示し、終了コード 23 は curl がパイプに受け取ったものを書き込めなかったことを示します。通常は Bash が早期に終了したためです。

419 419

420[ネットワーク接続を確認する](#check-network-connectivity)のチェックで `downloads.claude.ai` に到達できることをテストしてください。サーバーに到達した場合、元の失敗は一時的なものである可能性があります。インストールコマンドを再試行してください。[別のインストール方法を試す](/docs/ja/setup#install-claude-code)こともできます。420[ネットワーク接続を確認](#check-network-connectivity)のチェックで `downloads.claude.ai` に到達できることをテストしてください。サーバーに到達した場合、元の失敗は一時的である可能性があります。インストールコマンドを再試行してください。[別のインストール方法を試す](/docs/ja/setup#install-claude-code)こともできます。

421 421

422<h3 id="homebrew-cask-unavailable-or-outdated">422<h3 id="homebrew-cask-unavailable-or-outdated">

423 Homebrew cask が利用できないか古い423 Homebrew cask が利用できないか古い

424</h3>424</h3>

425 425

426Homebrew が `Error: Cask 'claude-code' is unavailable: No Cask with this name exists` を報告する場合、Homebrew cask インデックスのローカルコピーが cask の公開より前のものです。インデックスを更新して再試行してください：426Homebrew は、Homebrew cask インデックスのローカルコピーが cask の公開前の場合、`Error: Cask 'claude-code' is unavailable: No Cask with this name exists` を報告します。インデックスを更新して再試行してください。

427 427

428```bash theme={null}428```bash theme={null}

429brew update429brew update

430brew install --cask claude-code430brew install --cask claude-code

431```431```

432 432

433Homebrew が予想より古い Claude Code バージョンをインストールする場合、通常は同じ古いインデックスが原因です。`claude-code` cask は安定チャネルを追跡し、通常は最新リリースより約 1 週間遅れています。最新バージョンを実行するには、代わりに `brew install --cask claude-code@latest` を実行してください。2 つの cask の違いについては、[リリースチャネルを設定する](/docs/ja/setup#configure-release-channel)を参照してください。433Homebrew が予想より古い Claude Code バージョンをインストールする場合、通常は同じ古いインデックスが原因です。`claude-code` cask は安定チャネルを追跡し、通常は最新リリースの約 1 週間遅れています。最新バージョンを実行するには、代わりに `brew install --cask claude-code@latest` を実行してください。2 つの cask の違いについては、[リリースチャネルを設定](/docs/ja/setup#configure-release-channel)を参照してください。

434 434

435<h3 id="tls-or-ssl-connection-errors">435<h3 id="tls-or-ssl-connection-errors">

436 TLS または SSL 接続エラー436 TLS または SSL 接続エラー

437</h3>437</h3>

438 438

439`curl: (35) TLS connect error`、`schannel: next InitializeSecurityContext failed`、または PowerShell の `Could not establish trust relationship for the SSL/TLS secure channel` などのエラーは TLS ハンドシェイク失敗を示します。439`curl: (35) TLS connect error`、`schannel: next InitializeSecurityContext failed`、または PowerShell の `Could not establish trust relationship for the SSL/TLS secure channel` などのエラーは、TLS ハンドシェイク失敗を示します。

440 440

441**解決策：**441**解決策：**

442 442

4431. **システム CA 証明書を更新してください**：4431. **システム CA 証明書を更新する**：

444 444

445 Ubuntu/Debian では：445 Ubuntu/Debian では：

446 446

450 450

451 macOS では、システム curl は Keychain トラストストアを使用します。macOS 自体を更新するとルート証明書が更新されます。451 macOS では、システム curl は Keychain トラストストアを使用します。macOS 自体を更新するとルート証明書が更新されます。

452 452

4532. **Windows では、インストーラーを実行する前に PowerShell で TLS 1.2 を有効にしてください**：4532. **Windows では、インストーラーを実行する前に PowerShell で TLS 1.2 を有効にする**：

454 ```powershell theme={null}454 ```powershell theme={null}

455 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12455 [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

456 irm https://claude.ai/install.ps1 | iex456 irm https://claude.ai/install.ps1 | iex

457 ```457 ```

458 458

4593. **プロキシまたはファイアウォール干渉を確認してください**：TLS 検査を実行する企業プロキシは、`unable to get local issuer certificate` や `SELF_SIGNED_CERT_IN_CHAIN` を含むこれらのエラーを引き起こす可能性があります。インストール手順では、インストールダウンロードを企業プロキシの CA に信頼させてください：4593. **プロキシまたはファイアウォールの干渉を確認する**：TLS 検査を実行する企業プロキシはこれらのエラーを引き起こす可能性があります。`unable to get local issuer certificate` と `SELF_SIGNED_CERT_IN_CHAIN` を含みます。インストールステップでは、インストールダウンロードが企業プロキシの CA を信頼するようにします。

460 460

461 <Tabs>461 <Tabs>

462 <Tab title="macOS/Linux">462 <Tab title="macOS/Linux">

466 </Tab>466 </Tab>

467 467

468 <Tab title="Windows PowerShell">468 <Tab title="Windows PowerShell">

469 PowerShell インストーラーは .NET を通じてダウンロードし、Windows 証明書ストアに対して TLS を検証します。プロキシの CA 証明書がまだそこにない場合は、IT チームに Windows ストアに追加するよう依頼してから、インストーラーを実行してください：469 PowerShell インストーラーは .NET 経由でダウンロードされ、Windows 証明書ストアに対して TLS を検証します。プロキシの CA 証明書がまだそこにない場合は、IT チームに Windows ストアに追加するよう依頼してから、インストーラーを実行してください。

470 470

471 ```powershell theme={null}471 ```powershell theme={null}

472 irm https://claude.ai/install.ps1 | iex472 irm https://claude.ai/install.ps1 | iex

474 </Tab>474 </Tab>

475 </Tabs>475 </Tabs>

476 476

477 インストール後の Claude Code 自体については、`NODE_EXTRA_CA_CERTS` を設定して API リクエストが同じバンドルを信頼するようにしてください：477 インストール後の Claude Code 自体については、`NODE_EXTRA_CA_CERTS` を設定して API リクエストが同じバンドルを信頼するようにします。

478 478

479 <Tabs>479 <Tabs>

480 <Tab title="macOS/Linux">480 <Tab title="macOS/Linux">

490 </Tab>490 </Tab>

491 </Tabs>491 </Tabs>

492 492

493 証明書ファイルがない場合は IT チームに問い合わせてください。また、直接接続で試して、プロキシが原因であることを確認することもできます。493 証明書ファイルがない場合は IT チームに依頼してください。直接接続で試して、プロキシが原因であることを確認することもできます。

494 494

4954. **Windows では、ブロックされた失効確認を回避してください**。エラー `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` と `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` は、curl がサーバーに到達したが、ネットワークが証明書失効ルックアップをブロックしていることを意味します。これは企業ファイアウォールの背後では一般的です。失敗したコマンドが `install.cmd` をダウンロードする `curl` の場合、`--ssl-revoke-best-effort` を追加してコマンドプロンプトから再実行してください：4954. **Windows では、ブロックされた失効確認を回避する**。エラー `CRYPT_E_NO_REVOCATION_CHECK (0x80092012)` と `CRYPT_E_REVOCATION_OFFLINE (0x80092013)` は curl がサーバーに到達したが、ネットワークが証明書失効ルックアップをブロックしていることを意味します。これは企業ファイアウォールの背後で一般的です。失敗しているコマンドが `install.cmd` をダウンロードする `curl` の場合、`--ssl-revoke-best-effort` を追加してコマンドプロンプトから再実行してください。

496 ```batch theme={null}496 ```batch theme={null}

497 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd497 curl --ssl-revoke-best-effort -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

498 ```498 ```

499 スクリプト自体のダウンロードが同じエラーに直面すると、自動的にベストエフォート失効確認で再試行されるため、フラグは自分で実行するコマンドにのみ必要です。ベストエフォート確認は到達不可能な失効サーバーを許容しますが、既知の失効証明書は依然として拒否し、ブラウザが失効を処理する方法と一致します。PowerShell インストーラーを PowerShell から実行することで curl の失効確認を完全に回避することもできます。これは .NET を通じてダウンロードし、失効サーバーに到達できない場合は失敗しません：499 スクリプト自体のダウンロードが同じエラーに遭遇すると、自動的にベストエフォート失効確認で再試行されるため、フラグは自分で実行するコマンドにのみ必要です。ベストエフォート確認は到達不可能な失効サーバーを許容しますが、失効していることが判明している証明書は引き続き拒否します。これはブラウザが失効を処理する方法と一致します。PowerShell から PowerShell インストーラーを実行することで curl の失効確認を完全に回避することもできます。これは .NET 経由でダウンロードされ、失効サーバーが到達不可能な場合は失敗しません。

500 ```powershell theme={null}500 ```powershell theme={null}

501 irm https://claude.ai/install.ps1 | iex501 irm https://claude.ai/install.ps1 | iex

502 ```502 ```

506 `Failed to fetch version from downloads.claude.ai`506 `Failed to fetch version from downloads.claude.ai`

507</h3>507</h3>

508 508

509インストーラーがダウンロードサーバーに到達できませんでした。これは通常、`downloads.claude.ai` がネットワークでブロックされていることを意味します。[ネットワーク接続を確認する](#check-network-connectivity)を参照してください。509インストーラーがダウンロードサーバーに到達できませんでした。これは通常、`downloads.claude.ai` がネットワークでブロックされていることを意味します。[ネットワーク接続を確認](#check-network-connectivity)を参照してください。

510 510

511<h3 id="wrong-install-command-on-windows">511<h3 id="wrong-install-command-on-windows">

512 Windows での間違ったインストールコマンド512 Windows での間違ったインストールコマンド

513</h3>513</h3>

514 514

515`'irm' is not recognized`、`The token '&&' is not valid`、`A parameter cannot be found that matches parameter name 'fsSL'`、または `'bash' is not recognized as the name of a cmdlet` が表示される場合、別のシェルまたはオペレーティングシステムのインストールコマンドをコピーしました。コマンドがスクリプトのテキストを出力する場合、その一部のみを実行しました。515`'irm' is not recognized`、`The token '&&' is not a valid statement separator`、`A parameter cannot be found that matches parameter name 'fsSL'`、または `'bash' is not recognized as the name of a cmdlet` が表示される場合、別のシェルまたはオペレーティングシステムのインストールコマンドをコピーしました。コマンドがスクリプトのテキストを出力する場合、インストールの一部のみを実行しました。

516 516

517* **`irm` が認識されない**：CMD にいて、PowerShell ではありません。2 つのオプションがあります：517* **`irm` が認識されない**：CMD にいます。PowerShell ではありません。2 つのオプションがあります。

518 518

519 スタートメニューで「PowerShell」を検索して PowerShell を開き、元のインストールコマンドを実行してください：519 スタートメニューで「PowerShell」を検索して PowerShell を開き、元のインストールコマンドを実行します。

520 520

521 ```powershell theme={null}521 ```powershell theme={null}

522 irm https://claude.ai/install.ps1 | iex522 irm https://claude.ai/install.ps1 | iex

523 ```523 ```

524 524

525 または CMD にとどまり、代わりに CMD インストーラーを使用してください：525 または CMD にとどまり、CMD インストーラーを代わりに使用します。

526 526

527 ```batch theme={null}527 ```batch theme={null}

528 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd528 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

529 ```529 ```

530 530

531* **`&&` が有効ではない**：PowerShell にいますが、CMD インストーラーコマンドを実行しました。PowerShell インストーラーを使用してください：531* **`&&` が有効なステートメント区切り文字ではない**：PowerShell にいますが、CMD インストーラーコマンドを実行しました。PowerShell インストーラーを使用してください。

532 ```powershell theme={null}532 ```powershell theme={null}

533 irm https://claude.ai/install.ps1 | iex533 irm https://claude.ai/install.ps1 | iex

534 ```534 ```

535 535

536* **`A parameter cannot be found that matches parameter name 'fsSL'`**：Windows PowerShell で macOS/Linux `curl -fsSL ... | bash` インストーラーを実行しました。ここで `curl` は `Invoke-WebRequest` のエイリアスであり、`-fsSL` フラグを拒否します。代わりに PowerShell インストーラーを使用してください：536* **`A parameter cannot be found that matches parameter name 'fsSL'`**：Windows PowerShell で macOS/Linux `curl -fsSL ... | bash` インストーラーを実行しました。`curl` は `Invoke-WebRequest` のエイリアスであり、`-fsSL` フラグを拒否します。代わりに PowerShell インストーラーを使用してください。

537 ```powershell theme={null}537 ```powershell theme={null}

538 irm https://claude.ai/install.ps1 | iex538 irm https://claude.ai/install.ps1 | iex

539 ```539 ```

540 540

541* **`bash` が認識されない**：Windows で macOS/Linux インストーラーを実行しました。代わりに PowerShell インストーラーを使用してください：541* **`bash` が認識されない**：Windows で macOS/Linux インストーラーを実行しました。代わりに PowerShell インストーラーを使用してください。

542 ```powershell theme={null}542 ```powershell theme={null}

543 irm https://claude.ai/install.ps1 | iex543 irm https://claude.ai/install.ps1 | iex

544 ```544 ```

545 545

546* **コマンドがスクリプトテキストを出力する**：ダウンロード半分のコマンドを実行部分なしで実行しました。`irm https://claude.ai/install.ps1` 単独でダウンロードされたスクリプトをターミナルに出力します。`iex` にパイプして実行してください：546* **コマンドがスクリプトテキストを出力する**：ダウンロード部分を実行せずに、それを実行する部分なしでコマンドを実行しました。`irm https://claude.ai/install.ps1` 単独でダウンロードされたスクリプトをターミナルに出力します。`iex` にパイプして実行します。

547 547

548 ```powershell theme={null}548 ```powershell theme={null}

549 irm https://claude.ai/install.ps1 | iex549 irm https://claude.ai/install.ps1 | iex

550 ```550 ```

551 551

552 CMD では、`-o` なしの `curl -fsSL https://claude.ai/install.cmd` はバッチスクリプトを保存する代わりに出力します。完全なコマンドを実行してください：552 CMD では、`-o` なしの `curl -fsSL https://claude.ai/install.cmd` はバッチスクリプトを保存する代わりに出力します。完全なコマンドを実行します。

553 553

554 ```batch theme={null}554 ```batch theme={null}

555 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd555 curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

556 ```556 ```

557 557

558どのインストーラーを使用するにしても、それが機能したことを確認してください。新しいターミナルを開いて `claude --version` を実行してください。これは `2.1.211 (Claude Code)` などのバージョン番号を出力します。558どのインストーラーを使用するにしても、それが機能したことを確認します。新しいターミナルを開いて `claude --version` を実行します。これは `2.1.211 (Claude Code)` などのバージョン番号を出力します。

559 559

560<h3 id="running-scripts-is-disabled-on-this-system">560<h3 id="running-scripts-is-disabled-on-this-system">

561 `running scripts is disabled on this system`561 `running scripts is disabled on this system`

562</h3>562</h3>

563 563

564Windows で npm を通じて Claude Code をインストールまたは実行すると、`SecurityError` で失敗する可能性があります：564Windows で npm 経由で Claude Code をインストールまたは実行すると、`SecurityError` で失敗する場合があります。

565 565

566```text theme={null}566```text theme={null}

567npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.567npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.

569 + CategoryInfo : SecurityError: (:) [], PSSecurityException569 + CategoryInfo : SecurityError: (:) [], PSSecurityException

570```570```

571 571

572npm インストール後に `claude` を実行すると、同じエラーが `claude.ps1` に名前を付けます。PowerShell の実行ポリシーは npm がそのコマンド用に作成する `.ps1` ランチャースクリプトをブロックしています。ポリシーはスクリプトファイルに適用されるため、ダウンロードされたテキストを直接実行する PowerShell インストーラー `irm https://claude.ai/install.ps1 | iex` には影響しません。572npm インストール後に `claude` を実行すると、同じエラーが `claude.ps1` に名前を付けます。PowerShell の実行ポリシーは npm がそのコマンド用に作成する `.ps1` ランチャースクリプトをブロックしています。ポリシーはスクリプトファイルに適用されるため、PowerShell インストーラー `irm https://claude.ai/install.ps1 | iex` には影響しません。これはダウンロードされたテキストを直接実行します。

573 573

574**解決策：**574**解決策：**

575 575

5761. **ユーザーのローカルで作成されたスクリプトを許可してから、再試行してください**：5761. **ユーザーのローカルで作成されたスクリプトを許可してから再試行します**。

577 ```powershell theme={null}577 ```powershell theme={null}

578 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser578 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

579 ```579 ```

5802. **`.cmd` ランチャーを呼び出してください**：`npm.cmd` と `claude.cmd` は同じジョブを実行し、ポリシーはそれらをカバーしません。5802. **`.cmd` ランチャーを呼び出す**：`npm.cmd` と `claude.cmd` は同じ仕事をし、ポリシーはそれらをカバーしません。

5813. **npm の代わりに [PowerShell インストーラー](/docs/ja/setup#install-claude-code)を使用してください**。これは `.ps1` スクリプトではなくバイナリをインストールします。5813. **npm の代わりに [PowerShell インストーラー](/docs/ja/setup#install-claude-code)を使用する**。バイナリではなく `.ps1` スクリプトをインストールします。

582 582

583<h3 id="the-process-cannot-access-the-file-during-windows-install">583<h3 id="the-process-cannot-access-the-file-during-windows-install">

584 Windows インストール中の `The process cannot access the file`584 Windows インストール中の `The process cannot access the file`

585</h3>585</h3>

586 586

587PowerShell インストーラーが `Failed to download binary: The process cannot access the file ... because it is being used by another process` で失敗する場合、インストーラーは `%USERPROFILE%\.claude\downloads` に書き込むことができませんでした。これは通常、以前のインストール試行がまだ実行されているか、アンチウイルスソフトウェアがそのフォルダー内の部分的にダウンロードされたバイナリをスキャンしていることを意味します。587PowerShell インストーラーが `Failed to download binary: The process cannot access the file ... because it is being used by another process` で失敗する場合、インストーラーは `%USERPROFILE%\.claude\downloads` に書き込めませんでした。これは通常、前のインストール試行がまだ実行中であるか、アンチウイルスソフトウェアがそのフォルダー内の部分的にダウンロードされたバイナリをスキャンしていることを意味します。

588 588

589インストーラーを実行している他の PowerShell ウィンドウを閉じ、アンチウイルススキャンがファイルを解放するのを待ってください。その後、ダウンロードフォルダーを削除してインストーラーを再度実行してください：589インストーラーを実行している他の PowerShell ウィンドウを閉じ、アンチウイルススキャンがファイルを解放するまで待機します。次にダウンロードフォルダーを削除してインストーラーを再度実行します。

590 590

591```powershell theme={null}591```powershell theme={null}

592Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"592Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"

594```594```

595 595

596<h3 id="install-killed-on-low-memory-linux-servers">596<h3 id="install-killed-on-low-memory-linux-servers">

597 低メモリ Linux サーバーでインストール中に Killed597 メモリ不足の Linux サーバーでインストールが強制終了される

598</h3>598</h3>

599 599

600インストール中に `Killed` メッセージが表示される場合、通常は Linux のメモリ不足（OOM）キラーがシステムがメモリ不足になったため `claude install` ステップを終了したことを意味します。これは小規模な VPS とクラウドインスタンスで一般的です。インストールスクリプトは原因を報告し、終了コード 137 で終了します。この例では、行番号とプロセス ID はリリースと実行によって異なります：600インストール中の `Killed` メッセージは通常、Linux メモリ不足（OOM）キラーがシステムのメモリ不足のため `claude install` ステップを終了したことを意味します。これは小規模な VPS とクラウドインスタンスで一般的です。インストールスクリプトは原因を報告し、終了コード 137 で終了します。この例では、行番号とプロセス ID はリリースと実行によって異なります。

601 601

602```text theme={null}602```text theme={null}

603Setting up Claude Code...603Setting up Claude Code...

610 610

611**解決策：**611**解決策：**

612 612

6131. **RAM が限られている場合はスワップスペースを追加してください**。スワップはディスク領域をオーバーフローメモリとして使用し、物理 RAM が少ない場合でもインストールを完了できます。6131. **サーバーの RAM が限られている場合はスワップスペースを追加する**。スワップはディスク領域をオーバーフローメモリとして使用し、物理 RAM が少ない場合でもインストールを完了できます。

614 614

615 2 GB スワップファイルを作成して有効にしてください：615 2 GB スワップファイルを作成して有効にします。

616 616

617 ```bash theme={null}617 ```bash theme={null}

618 sudo fallocate -l 2G /swapfile618 sudo fallocate -l 2G /swapfile

621 sudo swapon /swapfile621 sudo swapon /swapfile

622 ```622 ```

623 623

624 その後、インストールを再試行してください：624 次にインストールを再試行します。

625 625

626 ```bash theme={null}626 ```bash theme={null}

627 curl -fsSL https://claude.ai/install.sh | bash627 curl -fsSL https://claude.ai/install.sh | bash

628 ```628 ```

629 629

6302. **インストール前に他のプロセスを閉じてメモリを解放してください**。6302. **インストール前に他のプロセスを閉じてメモリを解放する**。

631 631

6323. **可能であれば、より大きなインスタンスを使用してください**。Claude Code には少なくとも 4 GB の RAM が必要です。6323. **可能であれば、より大きなインスタンスを使用する**。Claude Code には最低 4 GB の RAM が必要です。

633 633

634<h3 id="install-hangs-in-docker">634<h3 id="install-hangs-in-docker">

635 Docker でのインストールハング635 Docker でインストールがハングする

636</h3>636</h3>

637 637

638Docker コンテナで Claude Code をインストールするときに、root として `/` にインストールするとハングが発生する可能性があります。638Docker コンテナーで Claude Code をインストールする場合、root として `/` にインストールするとハングが発生する可能性があります。

639 639

640**解決策：**640**解決策：**

641 641

6421. **インストーラーを実行する前に作業ディレクトリを設定してください**。`/` から実行すると、インストーラーはファイルシステム全体をスキャンし、過度なメモリ使用を引き起こします。`WORKDIR` を設定すると、スキャンが小さなディレクトリに制限されます：6421. **インストーラーを実行する前に作業ディレクトリを設定する**。`/` から実行すると、インストーラーはファイルシステム全体をスキャンし、過度なメモリ使用が発生します。`WORKDIR` を設定すると、スキャンが小さなディレクトリに制限されます。

643 ```dockerfile theme={null}643 ```dockerfile theme={null}

644 WORKDIR /tmp644 WORKDIR /tmp

645 RUN curl -fsSL https://claude.ai/install.sh | bash645 RUN curl -fsSL https://claude.ai/install.sh | bash

646 ```646 ```

647 647

6482. **Docker Desktop を使用している場合は Docker にさらにメモリを与えてください**。ビルドコンテナーは Docker Desktop 仮想マシンに割り当てられたメモリを共有するため、Docker Desktop で **Settings > Resources** を開き、メモリ制限を上げて、ビルドを再実行してください。6482. **Docker Desktop を使用している場合は Docker にメモリを追加する**。ビルドコンテナーは Docker Desktop 仮想マシンに割り当てられたメモリを共有するため、Docker Desktop で **Settings > Resources** を開き、メモリ制限を上げて、ビルドを再実行します。

649 649

650<h3 id="raw-mode-is-not-supported-during-install">650<h3 id="raw-mode-is-not-supported-during-install">

651 インストール中の `Raw mode is not supported`651 インストール中の `Raw mode is not supported`

652</h3>652</h3>

653 653

654組織の[サーバー管理設定](/docs/ja/server-managed-settings)に[セキュリティ承認](/docs/ja/server-managed-settings#security-approval-dialogs)が必要な変更が含まれている場合、Claude Code v2.1.246 より前のバージョンは `claude install` 中に承認ダイアログを表示しようとします。ダイアログは stdin 上のターミナルが必要です。インストーラーが `curl -fsSL https://claude.ai/install.sh | bash` のようにパイプから `claude install` を実行する場合、stdin はターミナルではなくパイプであるため、インストールは `Raw mode is not supported` を含むエラーで失敗します。654組織の[サーバー管理設定](/docs/ja/server-managed-settings)に[セキュリティ承認](/docs/ja/server-managed-settings#security-approval-dialogs)が必要な変更が含まれている場合、Claude Code バージョン 2.1.246 より前は `claude install` 中に承認ダイアログを表示しようとします。ダイアログは stdin のターミナルが必要です。インストーラーが `curl -fsSL https://claude.ai/install.sh | bash` のようにパイプから `claude install` を実行する場合、stdin はターミナルではなくパイプであるため、インストールは `Raw mode is not supported` を含むエラーで失敗します。

655 655

656Claude Code v2.1.246 以降は `claude install` または `claude update` 中にダイアログを表示しません。コマンドは最後に承認した設定で実行され、Claude Code は次の対話型セッションでダイアログを表示します。組織のスタートアップ構成が[設定フェッチを待つ](/docs/ja/server-managed-settings#enforce-fail-closed-startup)場合（`forceRemoteSettingsRefresh` を設定する場合など）、ダイアログはこれらのコマンド中に表示され、パイプから実行されたインストールは依然として失敗します。656Claude Code v2.1.246 以降は、`claude install` または `claude update` 中にダイアログを表示しません。コマンドは最後に承認した設定で実行され、Claude Code は次の対話型セッションでダイアログを表示します。組織のスタートアップ構成が[設定フェッチを待つ](/docs/ja/server-managed-settings#enforce-fail-closed-startup)場合（`forceRemoteSettingsRefresh` を設定する場合など）、ダイアログはこれらのコマンド中に表示され、パイプから実行されたインストールは引き続き失敗します。

657 657

658他のすべての構成では、インストーラーを再実行するとこのエラーを超えます。スクリプトは古いバージョンをインストールするよう求めても最新リリースの `install` コマンドを実行するためです。プラットフォームのコマンドを再実行してください：658他のすべての構成では、インストーラーを再実行すると、古いバージョンをインストールするよう求めた場合でも、スクリプトは最新リリースの `install` コマンドを実行するため、このエラーを回避できます。プラットフォームのコマンドを再実行してください。

659 659

660<Tabs>660<Tabs>

661 <Tab title="macOS/Linux">661 <Tab title="macOS/Linux">

674`claude --version` は再実行がインストールしたバージョンを出力します。674`claude --version` は再実行がインストールしたバージョンを出力します。

675 675

676<h3 id="claude-update-or-claude-doctor-hangs">676<h3 id="claude-update-or-claude-doctor-hangs">

677 `claude update` または `claude doctor` がハング677 `claude update` または `claude doctor` がハングする

678</h3>678</h3>

679 679

680`claude update` と `claude doctor` はシェル構成ファイルで古い `claude` エイリアスをスキャンします：`~/.zshrc`、`~/.bashrc`、`~/.config/fish/config.fish`、および macOS では存在する `~/.bash_profile`、`~/.bash_login`、または `~/.profile` の最初のもの。`ZDOTDIR` を設定する場合、Zsh ファイルは代わりに `$ZDOTDIR/.zshrc` です。これらのパスの 1 つがディレクトリの場合、Claude Code はそれをスキップし、両方のコマンドが正常に完了します。v2.1.214 より前では、これらのパスの 1 つにあるディレクトリは両方のコマンドをハングさせ、`/status` のシステム診断セクションを空白のままにしました。`claude doctor` は出力なしでハングしました。`claude update` は `Checking for updates` を出力した直後にハングしました。680`claude update` と `claude doctor` は、古い `claude` エイリアス `~/.zshrc`、`~/.bashrc`、`~/.config/fish/config.fish` のシェル構成ファイルをスキャンします。macOS では、存在する `~/.bash_profile`、`~/.bash_login`、`~/.profile` の最初のものです。`ZDOTDIR` を設定する場合、Zsh ファイルは代わりに `$ZDOTDIR/.zshrc` です。これらのパスの 1 つがディレクトリの場合、Claude Code はそれをスキップし、両方のコマンドが正常に完了します。v2.1.214 より前では、これらのパスの 1 つにあるディレクトリは両方のコマンドをハングさせ、`/status` のシステム診断セクションを空白のままにしました。`claude doctor` は出力なしでハングしました。`claude update` はハングしました。`Checking for updates` を出力した直後。

681 681

682以前のバージョンでハングに直面した場合は、ディレクトリを見つけてください。このコマンドの出力では、`d` で始まる行はそのパスをディレクトリとしてマークします。`No such file or directory` という行は、そのパスに何も存在せず、原因ではないことを意味します：682以前のバージョンでハングに遭遇した場合は、ディレクトリを見つけてください。このコマンドの出力では、`d` で始まる行がそのパスをディレクトリとしてマークします。`No such file or directory` 行は、そのパスに何も存在せず、原因ではないことを意味します。

683 683

684```bash theme={null}684```bash theme={null}

685ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish685ls -ld ~/.zshrc ~/.bashrc ~/.bash_profile ~/.bash_login ~/.profile ~/.config/fish/config.fish

686```686```

687 687

688ディレクトリを脇に移動するか、v2.1.214 以降に更新してください。`claude update` は影響を受けたバージョンでハングするため、代わりに[インストールスクリプト](/docs/ja/setup#install-claude-code)を再実行して更新してください。688ディレクトリを移動するか、v2.1.214 以降に更新してください。`claude update` は影響を受けるバージョンでハングするため、代わりに[インストールスクリプト](/docs/ja/setup#install-claude-code)を再実行して更新してください。

689 689

690<h3 id="claude-desktop-overrides-the-claude-command-on-windows">690<h3 id="claude-desktop-overrides-the-claude-command-on-windows">

691 Claude Desktop が Windows の `claude` コマンドをオーバーライドする691 Claude Desktop が Windows で `claude` コマンドをオーバーライドする

692</h3>692</h3>

693 693

694Claude Desktop の古いバージョンをインストールした場合、`WindowsApps` ディレクトリに `Claude.exe` を登録して、Claude Code CLI よりも PATH の優先度を取得する可能性があります。`claude` を実行すると、CLI ではなく Desktop アプリが開きます。694古いバージョンの Claude Desktop をインストールした場合、`WindowsApps` ディレクトリに `Claude.exe` を登録して、Claude Code CLI より PATH の優先度を高くする可能性があります。`claude` を実行すると、CLI ではなくデスクトップアプリが開きます。

695 695

696Claude Desktop を最新バージョンに更新して、この問題を修正してください。696Claude Desktop を最新バージョンに更新して、この問題を修正してください。

697 697

698<h3 id="claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell">698<h3 id="claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell">

699 Windows での Claude Code は Git for Windows（Bash 用）または PowerShell が必要です699 Windows の Claude Code には Git for Windows（bash 用）または PowerShell のいずれかが必要です

700</h3>700</h3>

701 701

702Git for Windows はオプションです。Claude Code は Git Bash がない場合、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool)を使用するため、このエラーはどちらのシェルも見つからなかったことを意味します。702Git for Windows はオプションです。Claude Code は Git Bash がない場合、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool)を使用するため、このエラーはどちらのシェルも見つからなかったことを意味します。

703 703

704**PowerShell が PATH にない場合**、デフォルトの場所は `C:\Windows\System32\WindowsPowerShell\v1.0\` です。そのディレクトリを `PATH` に追加するか、`pwsh` を提供する [PowerShell 7](https://aka.ms/powershell) をインストールしてください。704**PowerShell が PATH にない場合**、デフォルトの場所は `C:\Windows\System32\WindowsPowerShell\v1.0\` です。そのディレクトリを `PATH` に追加するか、`pwsh` を提供する [PowerShell 7](https://aka.ms/powershell) をインストールしてください。

705 705

706**Git for Windows をインストールする代わりに**、[git-scm.com/downloads/win](https://git-scm.com/downloads/win) からダウンロードしてください。セットアップ中に「Add to PATH」を選択してください。インストール後、ターミナルを再起動してください。インストールすると Bash ツールが有効になり、Bash ベースのスクリプトとツーリングを操作するときに便利です。706**Git for Windows をインストールする代わりに**、[git-scm.com/downloads/win](https://git-scm.com/downloads/win) からダウンロードしてください。セットアップ中に「Add to PATH」を選択してください。インストール後にターミナルを再起動してください。インストールすると Bash ツールが有効になり、Bash ベースのスクリプトとツーリングを操作する場合に便利です。

707 707

708**Git が既にインストールされている**が Claude Code が見つけられない場合は、その場所を Claude Code がチェックする場所と比較してください。`CLAUDE_CODE_GIT_BASH_PATH` が設定されていない場合、Claude Code は次の順序で `bash.exe` を探します：708**Git が既にインストールされている**が Claude Code が見つけられない場合は、その場所を Claude Code がチェックする場所と比較してください。`CLAUDE_CODE_GIT_BASH_PATH` が設定されていない場合、Claude Code は次の順序で `bash.exe` を探します。

709 709

7101. デフォルトインストール場所 `C:\Program Files\Git` と `C:\Program Files (x86)\Git`。7101. デフォルトのインストール場所 `C:\Program Files\Git` と `C:\Program Files (x86)\Git`。

7112. `PATH` 上の `git`。そのインストールから `bin\bash.exe` を使用します。7112. `PATH` 上の `git`。その Git インストールから `bin\bash.exe` を使用します。

712 712

713ステップ 2 では、Claude Code を起動したフォルダーに存在する `git`、またはそのフォルダーの下の `node_modules` または `.venv` や `env` などの仮想環境フォルダーを含むパスをスキップします。例えば、`C:\dev\env\myproject` から起動した場合の `C:\dev\env\myproject\Git`。これにより、Claude Code がプロジェクトがそこに配置した実行可能ファイルを実行するのを防ぎます。Git がそのような場所にある場合は、`CLAUDE_CODE_GIT_BASH_PATH` でそれを指します。713ステップ 2 では、Claude Code は Claude Code を起動したフォルダーに存在する `git`、またはそのフォルダーの下のパスで `node_modules` または `.venv` や `env` などの仮想環境フォルダーを含むパスをスキップします。例えば、`C:\dev\env\myproject` から起動した場合の `C:\dev\env\myproject\Git`。これにより、Claude Code がプロジェクトがそこに配置した実行可能ファイルを実行することを防ぎます。Git がそのような場所にある場合は、`CLAUDE_CODE_GIT_BASH_PATH` をそれに指します。

714 714

715**Claude Code を特定の Git インストールに指すには**、PowerShell で `where.exe git` を実行してそれを見つけ、そのインストールから `bin\bash.exe` パスを [settings.json ファイル](/docs/ja/settings)で `CLAUDE_CODE_GIT_BASH_PATH` として設定してください：715**Claude Code を特定の Git インストールに指す**には、PowerShell で `where.exe git` を実行して見つけ、そのインストールから `bin\bash.exe` パスを [settings.json ファイル](/docs/ja/settings)の `CLAUDE_CODE_GIT_BASH_PATH` として設定します。

716 716

717```json theme={null}717```json theme={null}

718{718{

722}722}

723```723```

724 724

725**`CLAUDE_CODE_GIT_BASH_PATH` が正しいパスに設定されており、ファイルが存在する**が Claude Code がそれを使用しない場合は、ファイルの名前を最初に確認してください。Claude Code は `bash.exe`、`sh.exe`、`bash`、または `sh` という名前のファイルのみを受け入れます。Git for Windows の `git-bash.exe` ランチャーなど、他の名前では、変数を無視して自動検出にフォールバックし、`--debug` で表示される警告をログに記録します。存在しないパスは同じフォールバックと警告を取得します。v2.1.219 より前では、Claude Code は名前をチェックせずに既存のファイルを使用し、パスが存在しない場合は `Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path` で起動時に終了しました。725**`CLAUDE_CODE_GIT_BASH_PATH` が正しいパスに設定されており、ファイルが存在する**が Claude Code がそれを使用しない場合は、まずファイルの名前を確認してください。Claude Code は `bash.exe`、`sh.exe`、`bash`、または `sh` という名前のファイルのみを受け入れます。Git for Windows の `git-bash.exe` ランチャーなど、他の名前では、変数を無視して Git Bash を自動検出し、`--debug` で表示される警告をログに記録します。存在しないパスは同じフォールバックと警告を取得します。v2.1.219 より前では、Claude Code は名前をチェックせずに既存のファイルを使用し、パスが存在しない場合は `Claude Code was unable to find CLAUDE_CODE_GIT_BASH_PATH path` で起動時に終了しました。

726 726

727ファイルの名前が正しい場合、AppLocker、グループポリシーソフトウェア制限ポリシー、または EDR エージェントなどのエンドポイントセキュリティソフトウェアが干渉している可能性があります。IT チームに `claude.exe` と、`cmd.exe` や `bash.exe` を含むそれが生成するプロセスをエンドポイント保護ポリシーでホワイトリストに登録するよう依頼してください。727ファイルの名前が正しい場合、AppLocker、グループポリシーソフトウェア制限ポリシー、EDR エージェントなどのエンドポイントセキュリティソフトウェアが干渉している可能性があります。IT チームに `claude.exe` と、`cmd.exe` や `bash.exe` を含むそれが生成するプロセスをエンドポイント保護ポリシーでホワイトリストに登録するよう依頼してください。

728 728

729<h3 id="claude-code-does-not-support-32-bit-windows">729<h3 id="claude-code-does-not-support-32-bit-windows">

730 Claude Code は 32 ビット Windows をサポートしていません730 Claude Code は 32 ビット Windows をサポートしていません

731</h3>731</h3>

732 732

733Windows のスタートメニューには 2 つの PowerShell エントリが含まれています：`Windows PowerShell` と `Windows PowerShell (x86)`。x86 エントリは 32 ビットプロセスとして実行され、64 ビットマシンでもこのエラーをトリガーします。どちらの場合かを確認するには、エラーを生成したのと同じウィンドウで次を実行してください：733Windows のスタートメニューには 2 つの PowerShell エントリがあります。`Windows PowerShell` と `Windows PowerShell (x86)`。x86 エントリは 32 ビットプロセスとして実行され、64 ビットマシンでもこのエラーをトリガーします。どちらの場合かを確認するには、エラーを生成した同じウィンドウで次を実行します。

734 734

735```powershell theme={null}735```powershell theme={null}

736[Environment]::Is64BitOperatingSystem736[Environment]::Is64BitOperatingSystem

737```737```

738 738

739これが `True` を出力する場合、オペレーティングシステムは問題ありません。ウィンドウを閉じて、x86 サフィックスなしで `Windows PowerShell` を開き、インストールコマンドを再度実行してください。739これが `True` を出力する場合、オペレーティングシステムは問題ありません。ウィンドウを閉じ、x86 サフィックスなしで `Windows PowerShell` を開き、インストールコマンドを再度実行します。

740 740

741これが `False` を出力する場合、32 ビット版の Windows を使用しています。Claude Code には 64 ビットオペレーティングシステムが必要です。[システム要件](/docs/ja/setup#system-requirements)を参照してください。741これが `False` を出力する場合、32 ビット版の Windows を使用しています。Claude Code には 64 ビットオペレーティングシステムが必要です。[システム要件](/docs/ja/setup#system-requirements)を参照してください。

742 742

744 Linux musl または glibc バイナリの不一致744 Linux musl または glibc バイナリの不一致

745</h3>745</h3>

746 746

747インストール後に `libstdc++.so.6` または `libgcc_s.so.1` などの不足している共有ライブラリに関するエラーが表示される場合、インストーラーはシステムに対応した間違ったバイナリバリアントをダウンロードした可能性があります。747インストール後に `libstdc++.so.6` や `libgcc_s.so.1` などの共有ライブラリが見つからないというエラーが表示される場合、インストーラーはシステムの間違ったバイナリバリアントをダウンロードした可能性があります。

748 748

749```text theme={null}749```text theme={null}

750Error loading shared library libstdc++.so.6: No such file or directory750Error loading shared library libstdc++.so.6: No such file or directory

754 754

755**解決策：**755**解決策：**

756 756

7571. **システムが使用している libc を確認してください**：7571. **システムが使用する libc を確認する**：

758 ```bash theme={null}758 ```bash theme={null}

759 ldd --version 2>&1 | head -1759 ldd --version 2>&1 | head -1

760 ```760 ```

761 `GNU libc` または `GLIBC` に言及している出力は glibc を意味します。`musl` に言及している出力は musl を意味します。761 `GNU libc` または `GLIBC` に言及する出力は glibc を意味します。`musl` に言及する出力は musl を意味します。

762 762

7632. **glibc にいるが musl バイナリを取得した場合**、インストールを削除して再インストールしてください。`https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` のマニフェストを使用して正しいバイナリを手動でダウンロードすることもできます。`ldd --version` と `ls /lib/libc.musl*` の出力を含めて [GitHub issue](https://github.com/anthropics/claude-code/issues) をファイルしてください。7632. **glibc にいるが musl バイナリを取得した場合**、インストールを削除して再インストールしてください。`https://downloads.claude.ai/claude-code-releases/{VERSION}/manifest.json` のマニフェストを使用して正しいバイナリを手動でダウンロードすることもできます。`ldd --version` と `ls /lib/libc.musl*` の出力を含む [GitHub issue](https://github.com/anthropics/claude-code/issues) をファイルしてください。

764 764

7653. **実際に musl にいる場合**（Alpine Linux など）、必要なパッケージをインストールしてください：7653. **実際に musl にいる場合**（Alpine Linux など）、必要なパッケージをインストールしてください。

766 ```bash theme={null}766 ```bash theme={null}

767 apk add libgcc libstdc++ ripgrep767 apk add libgcc libstdc++ ripgrep

768 ```768 ```

772 `Illegal instruction`772 `Illegal instruction`

773</h3>773</h3>

774 774

775`claude` またはインストーラーを実行すると `Illegal instruction` が出力される場合、ネイティブバイナリはプロセッサがサポートしていない CPU 命令を使用しています。2 つの異なる原因があります。775`claude` またはインストーラーを実行すると `Illegal instruction` が出力される場合、ネイティブバイナリはプロセッサーがサポートしていない CPU 命令を使用しています。2 つの異なる原因があります。

776 776

777**アーキテクチャの不一致。** インストーラーは間違ったバイナリをダウンロードしました。例えば、ARM サーバーで x86。macOS または Linux では `uname -m` で、PowerShell では `$env:PROCESSOR_ARCHITECTURE` で確認してください。結果が受け取ったバイナリと一致しない場合は、出力を含めて [GitHub issue](https://github.com/anthropics/claude-code/issues) をファイルしてください。777**アーキテクチャの不一致。** インストーラーは間違ったバイナリをダウンロードしました。例えば ARM サーバーで x86。macOS または Linux で `uname -m` を使用して確認するか、PowerShell で `$env:PROCESSOR_ARCHITECTURE` を使用してください。結果が受け取ったバイナリと一致しない場合は、出力を含む [GitHub issue](https://github.com/anthropics/claude-code/issues) をファイルしてください。

778 778

779**不足している AVX 命令セット。** アーキテクチャは正しいが、それでも `Illegal instruction` が表示される場合、CPU は AVX またはバイナリが必要とする別の命令がない可能性があります。これは約 2013 年以前の Intel および AMD プロセッサに影響します。仮想マシンでは、ハイパーバイザーが AVX をゲストに渡さない場合があります。779**AVX 命令セットが見つかりません。** アーキテクチャは正しいが `Illegal instruction` が表示される場合、CPU はおそらく AVX またはバイナリが必要とする別の命令がありません。これは約 2013 年以前の Intel および AMD プロセッサー、およびハイパーバイザーが AVX をゲストに渡さない仮想マシンに影響します。

780 780

781VPS または VM では、`grep -m1 -ow avx /proc/cpuinfo` を実行してください。空の結果は AVX がゲストで利用できないことを意味します。781VPS または VM では、`grep -m1 -ow avx /proc/cpuinfo` を実行します。空の結果は AVX がゲストで利用できないことを意味します。

782 782

783ネイティブバイナリの回避策はありません。[issue #50384](https://github.com/anthropics/claude-code/issues/50384) でステータスを追跡し、報告するときに Linux では `grep -m1 "model name" /proc/cpuinfo` から、macOS では `sysctl -n machdep.cpu.brand_string` から CPU モデルを含めてください。783ネイティブバイナリの回避策はありません。ステータスについては [issue #50384](https://github.com/anthropics/claude-code/issues/50384) を追跡し、報告する際に Linux で `grep -m1 "model name" /proc/cpuinfo` または macOS で `sysctl -n machdep.cpu.brand_string` から CPU モデルを含めてください。

784 784

785別のインストール方法は同じネイティブバイナリをダウンロードし、どちらの原因も解決しません。785代替インストール方法は同じネイティブバイナリをダウンロードし、どちらの原因も解決しません。

786 786

787<h3 id="dyld-cannot-load-on-macos">787<h3 id="dyld-cannot-load-on-macos">

788 macOS での `dyld: cannot load`788 macOS での `dyld: cannot load`

790 790

791インストール中に `dyld: Symbol not found`、`dyld: cannot load`、または `Abort trap: 6` が表示される場合、バイナリは macOS バージョンまたはハードウェアと互換性がありません。791インストール中に `dyld: Symbol not found`、`dyld: cannot load`、または `Abort trap: 6` が表示される場合、バイナリは macOS バージョンまたはハードウェアと互換性がありません。

792 792

793`Symbol not found` エラーが `libicucore` を参照する場合、macOS バージョンがバイナリがサポートするより古いことを意味します：793`libicucore` を参照する `Symbol not found` エラーは、macOS バージョンがバイナリがサポートするより古いことを意味します。

794 794

795```text theme={null}795```text theme={null}

796dyld: Symbol not found: _ubrk_clone796dyld: Symbol not found: _ubrk_clone

798 Expected in: /usr/lib/libicucore.A.dylib798 Expected in: /usr/lib/libicucore.A.dylib

799```799```

800 800

801ローダーは代わりにバイナリのロードコマンドを拒否する可能性があり、これは macOS バージョンが古すぎることも意味します：801ローダーは代わりにバイナリのロードコマンドを拒否する可能性があります。これは macOS バージョンが古すぎることも意味します。

802 802

803```text theme={null}803```text theme={null}

804dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)804dyld: cannot load 'claude-2.1.42-darwin-x64' (load command 0x80000034 is unknown)

807 807

808**解決策：**808**解決策：**

809 809

8101. **macOS バージョンを確認してください**：Claude Code には macOS 13.0 以降が必要です。Apple メニューを開き、「このマックについて」を選択してバージョンを確認してください。8101. **macOS バージョンを確認する**：Claude Code には macOS 13.0 以降が必要です。Apple メニューを開き、「このマックについて」を選択してバージョンを確認してください。

811 811

8122. **古いバージョンを使用している場合は macOS を更新してください**。バイナリは古い macOS バージョンがサポートしていないロードコマンドとシステムライブラリを使用しています。Homebrew などの別のインストール方法は同じバイナリをダウンロードし、このエラーを解決しません。8122. **古いバージョンを使用している場合は macOS を更新する**。バイナリは古い macOS バージョンがサポートしていないロードコマンドとシステムライブラリを使用しています。Homebrew などの代替インストール方法は同じバイナリをダウンロードし、このエラーを解決しません。

813 813

814<h3 id="exec-format-error-on-wsl1">814<h3 id="exec-format-error-on-wsl1">

815 WSL1 での `Exec format error`815 WSL1 での `Exec format error`

816</h3>816</h3>

817 817

818WSL で `claude` を実行すると `cannot execute binary file: Exec format error` が出力される場合、WSL1 にいて、[issue #38788](https://github.com/anthropics/claude-code/issues/38788) で追跡されている既知のネイティブバイナリ回帰に直面しています。バイナリのプログラムヘッダーが WSL1 のローダーが処理できない方法で変更されました。818WSL で `claude` を実行すると `cannot execute binary file: Exec format error` が出力される場合、WSL1 にいて、[issue #38788](https://github.com/anthropics/claude-code/issues/38788) で追跡されている既知のネイティブバイナリ回帰に遭遇しています。バイナリのプログラムヘッダーが WSL1 のローダーが処理できない方法で変更されました。

819 819

820最もクリーンな修正は、PowerShell からディストリビューションを WSL2 に変換することです：820最もクリーンな修正は、PowerShell からディストリビューションを WSL2 に変換することです。

821 821

822```powershell theme={null}822```powershell theme={null}

823wsl --set-version <DistroName> 2823wsl --set-version <DistroName> 2

824```824```

825 825

826WSL1 にとどまる必要がある場合は、動的リンカーを通じてバイナリを呼び出してください。ホームディレクトリが異なる場合はパスを置き換えて、WSL 内の `~/.bashrc` にこの関数を追加してください：826WSL1 にとどまる必要がある場合は、動的リンカーを通じてバイナリを呼び出します。ホームディレクトリが異なる場合はパスを置き換えて、WSL 内の `~/.bashrc` にこの関数を追加します。

827 827

828```bash theme={null}828```bash theme={null}

829claude() {829claude() {

831}831}

832```832```

833 833

834その後、`source ~/.bashrc` を実行して `claude` を再試行してください。834次に `source ~/.bashrc` を実行して `claude` を再試行します。

835 835

836<h3 id="npm-install-errors-in-wsl">836<h3 id="npm-install-errors-in-wsl">

837 WSL での npm インストールエラー837 WSL での npm インストールエラー

839 839

840これらの問題は、WSL 内で `npm install -g` を使用して Claude Code をインストールした場合に適用されます。[ネイティブインストーラー](/docs/ja/setup)を使用した場合は、このセクションをスキップしてください。840これらの問題は、WSL 内で `npm install -g` を使用して Claude Code をインストールした場合に適用されます。[ネイティブインストーラー](/docs/ja/setup)を使用した場合は、このセクションをスキップしてください。

841 841

842**OS またはプラットフォーム検出の問題。** npm がインストール中にプラットフォームの不一致を報告する場合、WSL は Windows `npm` を取得している可能性があります。最初に `npm config set os linux` を実行してから、`npm install -g @anthropic-ai/claude-code --force` でインストールしてください。`sudo` を使用しないでください。842**OS またはプラットフォーム検出の問題。** npm がインストール中にプラットフォームの不一致を報告する場合、WSL はおそらく Windows `npm` を選択しています。最初に `npm config set os linux` を実行してから、`npm install -g @anthropic-ai/claude-code --force` でインストールしてください。`sudo` を使用しないでください。

843 843

844**`claude` を実行するときの `exec: node: not found`。** WSL 環境は Windows インストール Node.js を使用している可能性があります。`which npm` と `which node` で確認してください：`/mnt/c/` で始まるパスは Windows バイナリで、Linux パスは `/usr/` で始まります。これを修正するには、Linux ディストリビューションのパッケージマネージャーまたは [`nvm`](https://github.com/nvm-sh/nvm) 経由で Node をインストールしてください。844**`claude` を実行するときの `exec: node: not found`。** WSL 環境はおそらく Node.js の Windows インストールを使用しています。`which npm` と `which node` で確認してください。`/mnt/c/` で始まるパスは Windows バイナリで、Linux パスは `/usr/` で始まります。これを修正するには、Linux ディストリビューションのパッケージマネージャーまたは [`nvm`](https://github.com/nvm-sh/nvm) 経由で Node をインストールしてください。

845 845

846**nvm バージョンの競合。** WSL と Windows の両方に nvm がインストールされている場合、WSL でノードバージョンを切り替えると、WSL はデフォルトで Windows PATH をインポートし、Windows nvm が優先されるため、破損する可能性があります。最も一般的な原因は、nvm がシェルに読み込まれていないことです。nvm ローダーを `~/.bashrc` または `~/.zshrc` に追加してください：846**nvm バージョンの競合。** WSL と Windows の両方に nvm がインストールされている場合、WSL でノードバージョンを切り替えると、WSL がデフォルトで Windows PATH をインポートし、Windows nvm が優先されるため、破損する可能性があります。最も一般的な原因は、nvm がシェルに読み込まれていないことです。nvm ローダーを `~/.bashrc` または `~/.zshrc` に追加します。

847 847

848```bash theme={null}848```bash theme={null}

849export NVM_DIR="$HOME/.nvm"849export NVM_DIR="$HOME/.nvm"

851[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"851[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

852```852```

853 853

854または現在のセッションで読み込んでください：854または現在のセッションで読み込みます。

855 855

856```bash theme={null}856```bash theme={null}

857source ~/.nvm/nvm.sh857source ~/.nvm/nvm.sh

858```858```

859 859

860nvm が読み込まれているが Windows パスがまだ優先される場合は、Linux Node パスを明示的に先頭に追加してください：860nvm が読み込まれているが Windows パスが引き続き優先される場合は、Linux ノードパスを明示的に先頭に追加します。

861 861

862```bash theme={null}862```bash theme={null}

863export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"863export PATH="$HOME/.nvm/versions/node/$(node -v)/bin:$PATH"

864```864```

865 865

866<Warning>866<Warning>

867 `appendWindowsPath = false` で Windows PATH インポートを無効にすることは避けてください。これは WSL から Windows 実行可能ファイルを呼び出す機能を破壊します。同様に、Windows 開発に使用する場合は Windows から Node.js をアンインストールすることは避けてください。867 `appendWindowsPath = false` 経由で Windows PATH インポートを無効にすることは避けてください。これは WSL から Windows 実行可能ファイルを呼び出す機能を破壊します。同様に、Windows 開発に使用する場合は Windows から Node.js をアンインストールすることは避けてください。

868</Warning>868</Warning>

869 869

870<h3 id="permission-errors-during-installation">870<h3 id="permission-errors-during-installation">

871 インストール中の権限エラー871 インストール中の権限エラー

872</h3>872</h3>

873 873

874ネイティブインストーラーが権限エラーで失敗する場合、ターゲットディレクトリが書き込み可能でない可能性があります。[ディレクトリ権限を確認する](#check-directory-permissions)を参照してください。874ネイティブインストーラーが権限エラーで失敗する場合、ターゲットディレクトリが書き込み可能でない可能性があります。[ディレクトリ権限を確認](#check-directory-permissions)を参照してください。

875 875

876以前に npm でインストールしていて、npm 固有の権限エラーに直面している場合は、ネイティブインストーラーに切り替えてください：876以前に npm でインストールしており、npm 固有の権限エラーに遭遇している場合は、ネイティブインストーラーに切り替えてください。

877 877

878```bash theme={null}878```bash theme={null}

879curl -fsSL https://claude.ai/install.sh | bash879curl -fsSL https://claude.ai/install.sh | bash

883 npm インストール後にネイティブバイナリが見つからない883 npm インストール後にネイティブバイナリが見つからない

884</h3>884</h3>

885 885

886`@anthropic-ai/claude-code` npm パッケージは、`@anthropic-ai/claude-code-darwin-arm64` などのプラットフォーム固有のオプション依存関係を通じてネイティブバイナリを取得します。npm はパッケージの postinstall スクリプトを実行し、そのバイナリを `claude` コマンドとして所定の位置にコピーします。実行されるまで、`claude` はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーは所定の位置に留まり、macOS と Linux で `claude` を実行すると出力されます：886`@anthropic-ai/claude-code` npm パッケージは、`@anthropic-ai/claude-code-darwin-arm64` などのプラットフォーム固有のオプション依存関係としてネイティブバイナリをダウンロードします。npm はパッケージの postinstall スクリプトを実行し、そのバイナリを `claude` コマンドとしてコピーします。実行されるまで、`claude` はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーは残り、macOS と Linux で `claude` を実行すると出力されます。

887 887

888```text theme={null}888```text theme={null}

889Error: claude native binary not installed.889Error: claude native binary not installed.

900 900

901Windows では、`bin/claude.exe` はその同じシェルスクリプトプレースホルダーであり、実際の実行可能ファイルではないため、PowerShell と CMD はこのメッセージを出力する代わりにファイルを実行できないと報告します。901Windows では、`bin/claude.exe` はその同じシェルスクリプトプレースホルダーであり、実際の実行可能ファイルではないため、PowerShell と CMD はこのメッセージを出力する代わりにファイルを実行できないと報告します。

902 902

903次の原因を確認してください：903次の原因を確認してください。

904 904

905* **オプション依存関係が無効になっています。** npm インストールコマンドから `--omit=optional` を削除し、pnpm から `--no-optional` を削除し、yarn から `--ignore-optional` を削除し、`.npmrc` が `optional=false` を設定していないことを確認してから、再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックはありません。905* **オプション依存関係が無効になっている。** npm インストールコマンドから `--omit=optional` を削除し、pnpm から `--no-optional` を削除し、yarn から `--ignore-optional` を削除し、`.npmrc` が `optional=false` を設定していないことを確認してから、再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックがなく、`install.cjs` を再度実行してもダウンロードされなかったバイナリを配置できません。

906* **インストールスクリプトが無効になっています。** `--ignore-scripts` と一部の pnpm 構成は postinstall ステップをスキップしますが、プラットフォームパッケージはダウンロードします。メッセージが示唆するように `node node_modules/@anthropic-ai/claude-code/install.cjs` を実行するか、フラグなしで再インストールしてください。postinstall が環境で実行できない場合、`node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` はダウンロードされたパッケージを見つけて起動し、各起動時に追加の Node プロセスのコストがかかります。ラッパーが代わりに `Could not find native binary package` を出力する場合、プラットフォームパッケージはダウンロードされなかったため、最初に上記のオプション依存関係の原因を修正してください。906* **インストールスクリプトが無効になっている。** `--ignore-scripts` と一部の pnpm 構成は postinstall ステップをスキップしますが、プラットフォームパッケージはダウンロードします。メッセージが示唆するように `node node_modules/@anthropic-ai/claude-code/install.cjs` を実行するか、フラグなしで再インストールしてください。postinstall が環境で実行できない場合、`node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` はダウンロードされたパッケージを見つけてそれを起動します。各起動時に余分なノードプロセスのコストで。ラッパーが `Could not find native binary package` を出力する代わりに、プラットフォームパッケージはダウンロードされなかったため、上記のオプション依存関係の原因を最初に修正してください。

907* **サポートされていないプラットフォーム。** プリビルドバイナリは `darwin-arm64`、`darwin-x64`、`linux-x64`、`linux-arm64`、`linux-x64-musl`、`linux-arm64-musl`、`win32-x64`、および `win32-arm64` 用に公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。[システム要件](/docs/ja/setup#system-requirements)を参照してください。FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。907* **サポートされていないプラットフォーム。** プリビルドバイナリは `darwin-arm64`、`darwin-x64`、`linux-x64`、`linux-arm64`、`linux-x64-musl`、`linux-arm64-musl`、`win32-x64`、`win32-arm64` に対して公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。[システム要件](/docs/ja/setup#system-requirements)を参照してください。FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。

908* **企業 npm ミラーがプラットフォームパッケージを欠いています。** レジストリがメタパッケージに加えて 8 つすべての `@anthropic-ai/claude-code-*` プラットフォームパッケージをミラーしていることを確認してください。908* **企業 npm ミラーがプラットフォームパッケージを欠落している。** レジストリがメタパッケージに加えて 8 つの `@anthropic-ai/claude-code-*` プラットフォームパッケージすべてをミラーしていることを確認してください。

909 909

910<h3 id="npm-enotempty-during-update-or-reinstall">910<h3 id="npm-enotempty-during-update-or-reinstall">

911 npm `ENOTEMPTY` エラー（更新または再インストール中）911 npm `ENOTEMPTY` エラー（更新または再インストール中）

912</h3>912</h3>

913 913

914既存のインストール上で `npm install -g @anthropic-ai/claude-code` を実行すると、npm は古いパッケージディレクトリを脇に移動しながら失敗する可能性があります：914既存のインストール上で `npm install -g @anthropic-ai/claude-code` を実行すると、npm は古いパッケージディレクトリを移動しようとしている間に失敗する可能性があります。

915 915

916```text theme={null}916```text theme={null}

917npm error code ENOTEMPTY917npm error code ENOTEMPTY

922npm error ENOTEMPTY: directory not empty, rename '...'922npm error ENOTEMPTY: directory not empty, rename '...'

923```923```

924 924

925`npm error path` 行は npm が移動できなかったディレクトリに名前を付けます。そのディレクトリと、以前の中断された実行が残す可能性のある隣接する `.claude-code-*` ディレクトリを削除してください。以下のコマンドは `npm root -g` でグローバルパッケージディレクトリを見つけます。`npm error path` 行が名前を付けるディレクトリが `npm root -g` が出力するディレクトリの下にない場合（例えば nvm でノードバージョンを切り替えたため）、エラーが名前を付けるディレクトリを削除してください：925`npm error path` 行は npm が移動できなかったディレクトリに名前を付けます。そのディレクトリと、以前の中断された実行が残す可能性のある隣接する `.claude-code-*` ディレクトリを削除してください。以下のコマンドは `npm root -g` でグローバルパッケージディレクトリを見つけます。`npm error path` 行が名前を付けるディレクトリが `npm root -g` が出力するディレクトリの下にない場合（例えば nvm でノードバージョンを切り替えた場合）、エラーが名前を付けるディレクトリを削除してください。

926 926

927<Tabs>927<Tabs>

928 <Tab title="macOS/Linux">928 <Tab title="macOS/Linux">

930 rm -rf "$(npm root -g)/@anthropic-ai/claude-code"930 rm -rf "$(npm root -g)/@anthropic-ai/claude-code"

931 ```931 ```

932 932

933 その後、残っているテンポラリディレクトリを削除してください。zsh が `no matches found` を出力する場合、削除するものはありませんでした：933 次に、残っているテンポラリディレクトリを削除します。Zsh が `no matches found` を出力する場合、削除するものはありませんでした。

934 934

935 ```bash theme={null}935 ```bash theme={null}

936 rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*936 rm -rf "$(npm root -g)/@anthropic-ai/.claude-code-"*

944 </Tab>944 </Tab>

945</Tabs>945</Tabs>

946 946

947その後、再インストールしてください：947次に再インストールします。

948 948

949```bash theme={null}949```bash theme={null}

950npm install -g @anthropic-ai/claude-code950npm install -g @anthropic-ai/claude-code

951```951```

952 952

953`claude --version` で確認してください。これは `2.1.211 (Claude Code)` などのバージョン番号を出力します。953`claude --version` で確認します。これは `2.1.211 (Claude Code)` などのバージョン番号を出力します。

954 954

955<h2 id="login-and-authentication">955<h2 id="login-and-authentication">

956 ログインと認証956 ログインと認証

troubleshooting.md +5 −1

Details

413. 大規模なビルドディレクトリを `.gitignore` ファイルに追加することを検討してください413. 大規模なビルドディレクトリを `.gitignore` ファイルに追加することを検討してください

424. [`claude --safe-mode`](/docs/ja/cli-reference#cli-flags) で再起動して、プラグイン、MCP サーバー、またはフックが原因かどうかを確認します。セッション中のすべてのカスタマイズが無効になります。使用量が低下した場合は、[設定をデバッグする](/docs/ja/debug-your-config#test-against-a-clean-configuration)を参照して、どれが原因かを特定します424. [`claude --safe-mode`](/docs/ja/cli-reference#cli-flags) で再起動して、プラグイン、MCP サーバー、またはフックが原因かどうかを確認します。セッション中のすべてのカスタマイズが無効になります。使用量が低下した場合は、[設定をデバッグする](/docs/ja/debug-your-config#test-against-a-clean-configuration)を参照して、どれが原因かを特定します

43 43

44セッションのヒープメモリが 2.5GB を超える場合、重大なメモリ使用量警告が表示されます。メモリを解放するには、Claude Code を再起動して [`claude --continue`](/docs/ja/cli-reference#cli-flags) を実行し、新しいプロセスでカンバセーションを再開します。

46[フルスクリーンレンダリング](/docs/ja/fullscreen)の外では、`/compact` を実行するとメモリも解放されます。メモリ使用量が 2.5GB を下回ると、警告は消えます。

44これらのステップ後もメモリ使用量が高いままの場合は、`/heapdump` を実行して 2 つのファイルを `~/Desktop` に書き込みます。`<session-id>.heapsnapshot` という名前の JavaScript ヒープスナップショットと、`<session-id>-diagnostics.json` という名前のメモリ分析です。Claude Code は[コマンドメニューからコマンドを非表示にします](/docs/ja/commands#how-the-command-menu-matches-what-you-type)。完全に入力してください。Linux でデスクトップフォルダがない場合、ファイルはホームディレクトリに書き込まれます。48これらのステップ後もメモリ使用量が高いままの場合は、`/heapdump` を実行して 2 つのファイルを `~/Desktop` に書き込みます。`<session-id>.heapsnapshot` という名前の JavaScript ヒープスナップショットと、`<session-id>-diagnostics.json` という名前のメモリ分析です。Claude Code は[コマンドメニューからコマンドを非表示にします](/docs/ja/commands#how-the-command-menu-matches-what-you-type)。完全に入力してください。Linux でデスクトップフォルダがない場合、ファイルはホームディレクトリに書き込まれます。

45 49

46<Warning>50<Warning>

108 112

109Claude の出力をクリップボードに配置するには、Claude に応答でコンテンツを出力するよう依頼してから、[`/copy`](/docs/ja/commands) を実行します。`/copy` はサンドボックス化されたコマンドではなく Claude Code プロセス自体からクリップボードに書き込むため、サンドボックスはそれをブロックしません。応答全体ではなく単一のコードブロックをコピーでき、コピーしたものをファイルに書き込んで、パスを出力します。これにより、クリップボード書き込みがターミナルに到達しない場合（例えば SSH 経由）のフォールバックが提供されます。113Claude の出力をクリップボードに配置するには、Claude に応答でコンテンツを出力するよう依頼してから、[`/copy`](/docs/ja/commands) を実行します。`/copy` はサンドボックス化されたコマンドではなく Claude Code プロセス自体からクリップボードに書き込むため、サンドボックスはそれをブロックしません。応答全体ではなく単一のコードブロックをコピーでき、コピーしたものをファイルに書き込んで、パスを出力します。これにより、クリップボード書き込みがターミナルに到達しない場合（例えば SSH 経由）のフォールバックが提供されます。

110 114

111パイプされたコマンドが代わりにクリップボードに直接到達できるようにするには、`pbcopy *`、`wl-copy *`、または `xclip *` を [`excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) に追加して、コマンドがサンドボックスの外で実行されるようにします。115Claude がテキストをこれらのツールにパイプする場合、`pbcopy *`、`wl-copy *`、または `xclip *` を [`excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) に追加しても、そのコマンドをサンドボックスの外で実行することはできません。

112 116

113<h3 id="copied-text-doesn’t-reach-your-local-clipboard-over-ssh">117<h3 id="copied-text-doesn’t-reach-your-local-clipboard-over-ssh">

114 SSH 経由でコピーされたテキストがローカルクリップボードに到達しない118 SSH 経由でコピーされたテキストがローカルクリップボードに到達しない

ultrareview.md +10 −3

Details

50 50

51ベースブランチはローカルクローンに存在する必要はありません。Claude Code は `origin` からそれをフェッチします。名前にタイプミスがある場合、Claude Code はエラーで最も近いブランチ名を提案します。51ベースブランチはローカルクローンに存在する必要はありません。Claude Code は `origin` からそれをフェッチします。名前にタイプミスがある場合、Claude Code はエラーで最も近いブランチ名を提案します。

52 52

53コミット ID またはタグもベースとして機能し、レビューはそのコミット以降のブランチ上の変更をカバーします。

53<h3 id="review-a-pull-request">55<h3 id="review-a-pull-request">

54 プルリクエストをレビューする56 プルリクエストをレビューする

55</h3>57</h3>

114Ultrareview はレビュー作業が実行される前に差分をチェックし、それをそのままレビューできない場合に通知します。116Ultrareview はレビュー作業が実行される前に差分をチェックし、それをそのままレビューできない場合に通知します。

115 117

116* **差分が大きすぎる**: ブランチレビューはデフォルトで最大 500 個の変更されたファイルと 8,000 個の変更された行を含むことができます。正確な値は変更される可能性があり、[拒否](/docs/ja/errors#diff-is-too-large-for-ultrareview)は有効な値、差分のサイズ、および最も変更された行を持つファイルを名前付けします。Claude Code は同じ方法で大きすぎるプルリクエストを拒否し、ファイルと行数を名前付けしますが、ファイルごとの内訳は名前付けしません。118* **差分が大きすぎる**: ブランチレビューはデフォルトで最大 500 個の変更されたファイルと 8,000 個の変更された行を含むことができます。正確な値は変更される可能性があり、[拒否](/docs/ja/errors#diff-is-too-large-for-ultrareview)は有効な値、差分のサイズ、および最も変更された行を持つファイルを名前付けします。Claude Code は同じ方法で大きすぎるプルリクエストを拒否し、ファイルと行数を名前付けしますが、ファイルごとの内訳は名前付けしません。

117* **レビューするものがない**: ベースに対する差分が空の場合、Claude Code はそう言い、ローカル編集をステージングまたはコミットするか、別のベースを渡すことを提案します。119* **レビューするものがない**: ベースに対する差分が空の場合、ultrareview は拒否し、比較したブランチまたはコミットを名前付けし、あなたがいるケース（ベースブランチ自体にいてコミットされていない変更がない、またはコミットがすべてベースの一部である既存のブランチなど）を名前付けします。また、そのケースの解決方法を提案します。例えば、作業があるブランチに切り替える、ローカル編集をステージングまたはコミットする、または別のベースを渡すなどです。

118* **マージベースがない**: ブランチがベースブランチと履歴を共有しない場合、Claude Code はリポジトリ内のすべての追跡ファイルをレビューすることにフォールバックします。フォールバックは完全なクローンが必要で、同じサイズ制限を適用します。URL をフェッチした後に `FETCH_HEAD` をチェックアウトして作成されたデタッチされた HEAD など、ブランチまたは他の参照がないチェックアウトでは、Claude Code は [レビューを拒否](/docs/ja/errors#your-checkout-has-no-branches)し、最初にブランチを作成することを提案します。120* **最初のコミット**: リポジトリの最初のコミットは比較する前のものがないため、ultrareview は起動ダイアログで確認した後、それ内のすべてのファイルをレビューします。追跡されていないファイルがある場合、代わりに拒否し、レビューしたいものを `git add` するよう指示します。同じサイズ制限が適用されます。

121

122 最初のコミットはその確認後にのみ全体的にレビューされるため、`claude ultrareview` サブコマンドと `claude -p` はそれを拒否し、インタラクティブセッションを使用するよう指示します。Claude Code v2.1.277 以降が必要です

123* **マージベースがない**: ブランチがベースブランチと履歴を共有しない場合、またはリポジトリに比較するベースブランチがない場合、ultrareview はリポジトリ内のすべての追跡ファイルをレビューすることにフォールバックします。フォールバックは完全なクローンが必要で、同じサイズ制限を適用します。起動ダイアログで確認するか、`claude ultrareview` サブコマンドを自分で実行するときのみ起動します。`claude -p` およびどちらも起こらない他の場所では、ultrareview は拒否し、レビューがすべてのファイルをカバーすることを言い、インタラクティブセッションを使用するよう指示します。

124

125 ブランチまたは他の参照がないチェックアウト（URL をフェッチした後に `FETCH_HEAD` をチェックアウトして作成されたデタッチされた HEAD など）では、Claude Code は [レビューを拒否](/docs/ja/errors#your-checkout-has-no-branches)し、最初にブランチを作成することを提案します。

119 126

120<h2 id="pricing-and-free-runs">127<h2 id="pricing-and-free-runs">

121 価格と無料実行回数128 価格と無料実行回数

166 173

167引数なしの場合、サブコマンドは現在のブランチとデフォルトブランチ間の差分をレビューします。マージベースが存在しない場合は、`/code-review ultra` と同じ[リポジトリ全体フォールバック](#diff-limits-and-fallbacks)を使用します。PR 番号を渡してプルリクエストをレビューするか、ベースブランチを渡してそれに対してレビューします。[ベースブランチの処理](#review-against-a-different-base)は対話的コマンドと一致します。174引数なしの場合、サブコマンドは現在のブランチとデフォルトブランチ間の差分をレビューします。マージベースが存在しない場合は、`/code-review ultra` と同じ[リポジトリ全体フォールバック](#diff-limits-and-fallbacks)を使用します。PR 番号を渡してプルリクエストをレビューするか、ベースブランチを渡してそれに対してレビューします。[ベースブランチの処理](#review-against-a-different-base)は対話的コマンドと一致します。

168 175

169サブコマンドを実行すると、リポジトリ全体フォールバックと課金および利用規約プロンプトに同意したことになるため、入力を待たずに実行が開始されます。176サブコマンドを実行すると、リポジトリ全体フォールバックと課金および利用規約プロンプトに同意したことになるため、入力を待たずに実行が開始されます。自分でそれを実行することが同意としてカウントされます。代わりに Claude がサブコマンドを実行する場合（例えば Bash ツール経由）、Claude Code はリポジトリ全体レビューを拒否します。

170 177

171Claude Code v2.1.218 以降では、非対話的セッション（例：`claude -p '/code-review ultra'`）で `/code-review ultra` を実行してクラウドレビューを開始することもできます。Claude Code はレビューを起動し、`claude ultrareview` とは異なり、検出結果を待たずに追跡リンクを出力します。`claude ultrareview` は検出結果が到着するまでブロックします。レビューが使用クレジットを課金する場合、Claude Code は起動前に停止し、課金確認には対話的セッションが必要であるため、`claude ultrareview` を指します。v2.1.218 より前では、非対話的セッションの `/code-review ultra` はローカルレビューを実行していました。178Claude Code v2.1.218 以降では、非対話的セッション（例：`claude -p '/code-review ultra'`）で `/code-review ultra` を実行してクラウドレビューを開始することもできます。Claude Code はレビューを起動し、`claude ultrareview` とは異なり、検出結果を待たずに追跡リンクを出力します。`claude ultrareview` は検出結果が到着するまでブロックします。レビューが使用クレジットを課金する場合、Claude Code は起動前に停止し、課金確認には対話的セッションが必要であるため、`claude ultrareview` を指します。v2.1.218 より前では、非対話的セッションの `/code-review ultra` はローカルレビューを実行していました。

172 179

vs-code.md +121 −58

Details

90 * Manual モードでは、Claude がファイルを編集したい場合、元のコンテンツと提案された変更の並べて比較を表示し、権限を求めます。受け入れたり、拒否したり、代わりに Claude に何をするかを指示したりできます。受け入れる前に diff ビューで提案されたコンテンツを直接編集した場合、Claude はそれを修正したことが通知されるため、ファイルが元の提案と一致していると想定されません。90 * Manual モードでは、Claude がファイルを編集したい場合、元のコンテンツと提案された変更の並べて比較を表示し、権限を求めます。受け入れたり、拒否したり、代わりに Claude に何をするかを指示したりできます。受け入れる前に diff ビューで提案されたコンテンツを直接編集した場合、Claude はそれを修正したことが通知されるため、ファイルが元の提案と一致していると想定されません。

91 91

92 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code が Claude の提案された変更の diff を表示し、編集を行うかどうかを尋ねる権限プロンプトが表示されている" width="3292" height="1876" data-path="images/vs-code-edits.png" />92 <img src="https://mintcdn.com/claude-code/FVYz38sRY-VuoGHA/images/vs-code-edits.png?fit=max&auto=format&n=FVYz38sRY-VuoGHA&q=85&s=e005f9b41c541c5c7c59c082f7c4841c" alt="VS Code が Claude の提案された変更の diff を表示し、編集を行うかどうかを尋ねる権限プロンプトが表示されている" width="3292" height="1876" data-path="images/vs-code-edits.png" />

94 提案された編集を 1 つずつ確認するには、diff 内の各変更の下にある **Accept this change** および **Reject this change** ボタンを使用します。変更を拒否すると、提案されたコンテンツ内でそれが元に戻されます。受け入れると、確認済みとしてマークされます。ファイル全体を受け入れるか拒否すると、確認が完了します。100 を超える変更を含む diff は、変更ごとのボタンなしで開かれるため、ファイル全体として確認してください。変更ごとの確認には Claude Code v2.1.275 以降が必要です。

96 同じアクションは、エディタのコンテキストメニューおよびコマンドパレットから **Claude Code: Accept Change at Cursor** および **Claude Code: Reject Change at Cursor** として利用できます。

93 </Step>97 </Step>

94</Steps>98</Steps>

95 99

105 109

106プロンプトボックスは複数の機能をサポートしています。110プロンプトボックスは複数の機能をサポートしています。

107 111

108* **権限モード**: プロンプトボックスの下部にあるモード指示器をクリックして、権限モードを切り替えます。Pro、Max、Team プランでは、Auto がビルトイン開始権限モードです。[拡張機能が開始権限モードを選択する方法](/docs/ja/permission-modes#switch-permission-modes)と、指示器が提供するすべての権限モードについては、こちらを参照してください。112* **権限モード**: プロンプトボックスの下部にあるモード表示をクリックして、権限モードを切り替えます。Pro、Max、Team プランでは、Auto が組み込みの開始権限モードです。[拡張機能が開始権限モードを選択する方法](/docs/ja/permission-modes#switch-permission-modes)と、表示されるすべての権限モードについては、こちらをご覧ください。

109 * **Auto**: 分類器があなたに尋ねる代わりにほとんどのアクションをレビューします。[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で、それがレビューおよびブロックする内容を確認してください。113 * **Auto**: ほとんどのアクションについて、分類器があなたに尋ねる代わりに確認します。[自動モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で、確認およびブロックされる内容をご覧ください。

110 * **Manual**: Claude はファイル編集とほとんどのシェルコマンドの前に権限を求めます。114 * **Manual**: Claude はファイル編集とほとんどのシェルコマンドの前に権限を求めます。

111 * **Plan**: Claude は実行する内容を説明し、変更を加える前に承認を待ちます。VS Code は自動的にプランを完全な Markdown ドキュメントとして開き、Claude が開始する前にフィードバックを提供するためにインラインコメントを追加できます。115 * **Plan**: Claude は変更を加える前に、実行内容を説明し、承認を待ちます。VS Code は計画を完全な Markdown ドキュメントとして自動的に開き、Claude が開始する前にフィードバックを提供するためのインラインコメントを追加できます。

112 * **Edit automatically**: Claude は尋ねることなく編集を行います。116 * **Edit automatically**: Claude は確認を求めずに編集を行います。

113* **Model**: コマンドメニューから **Switch model…** を選択して、セッション中にモデルを変更します。プロンプトボックスの下部にあるモデル名をクリックして、同じピッカーを開くこともできます。現在のモデルが [effort levels](/docs/ja/model-config#adjust-effort-level) をサポートしている場合、ピッカーは **Effort** 行も表示します。モデル名ボタンと **Effort** 行には Claude Code v2.1.257 以降が必要です。117* **Model**: コマンドメニューから **Switch model…** を選択して、セッション中にモデルを変更します。プロンプトボックスの下部にあるモデル名をクリックして、同じピッカーを開くこともできます。

114* **Command menu**: `/` をクリックするか `/` を入力してコマンドメニューを開きます。オプションには、ファイルの添付、モデルの切り替え、拡張思考の切り替えが含まれます。Customize セクションは MCP サーバー、slash commands、出力スタイル、hooks、メモリ、権限、プラグインへのアクセスを提供します。ターミナルアイコン付きのアイテムは統合ターミナルで開きます。118

115 * `/usage` や [`/remote-control`](/docs/ja/remote-control) などのコマンドを参照するには、Customize セクションで **Slash commands** を選択します。ダイアログはフィルターボックス付きでそれらをリストします。1 つを選択して実行します。プロンプトボックスで `/` を入力すると、引き続きコマンドをインラインで提案します。Claude Code v2.1.257 以降が必要です。119 現在のモデルが[努力レベル](/docs/ja/model-config#adjust-effort-level)をサポートしている場合、ピッカーは **Effort** 行も表示し、モデル名ボタンは選択されたレベルを表示します。`max` 以外のレベルを選択すると、Claude Code はそれを現在のモデルのデフォルトとしてユーザー設定の [`modelSettings`](/docs/ja/settings-reference#modelsettings) に保存します。`max` は現在のセッションにのみ適用されます。モデル名ボタンと **Effort** 行には Claude Code v2.1.257 以降が必要です。

116 * Customize セクションで **Output styles** を選択して、カスタムスタイルを含む [output style](/docs/ja/output-styles) を選択します。Claude Code v2.1.257 以降が必要です。120* **コマンドメニュー**: `/` をクリックするか `/` を入力してコマンドメニューを開きます。オプションには、ファイルの添付、モデルの切り替え、拡張思考の切り替えが含まれます。

~~117~~ 121

118 代わりにカスタムスタイルを作成するには、**Output styles** メニューから **Build a custom style** を選択します。Claude Code はプロジェクトまたはユーザーレベルで [style file](/docs/ja/output-styles#create-a-custom-output-style) を作成します。Claude Code v2.1.261 以降が必要です。122 Customize セクションは、MCP サーバー、コマンド、出力スタイル、hooks、メモリ、instructions、権限、プラグインへのアクセスを提供します。ターミナルアイコンが付いているアイテムは統合ターミナルで開きます。

119 * Customize セクションで **Hooks** を選択して、セッションに読み込まれた [hooks](/docs/ja/hooks) をイベント別にグループ化して表示します。ユーザー、プロジェクト、ローカル設定ファイルに保存された hooks を追加、編集、削除できます。マネージド設定やプラグインなどの他のソースからの Hooks は読み取り専用です。Claude Code v2.1.269 以降が必要です。123

120 * Customize セクションで **Permissions** を選択して、セッションの [permission rules](/docs/ja/permissions) を Allow、Ask、Deny にグループ化して表示します。ユーザー、プロジェクト、ローカル設定にルールを追加し、そこに保存されたルールを削除できます。マネージド設定やこのセッションのみに対して行われた承認などの他のソースからのルールは読み取り専用です。Claude Code v2.1.269 以降が必要です。124 * `/usage` や [`/remote-control`](/docs/ja/remote-control) などのコマンドを参照するには、Customize セクションで **Slash commands** を選択します。ダイアログにはフィルターボックス付きでそれらが一覧表示されます。実行するコマンドを選択します。プロンプトボックスで `/` を入力すると、引き続きコマンドがインラインで提案されます。Claude Code v2.1.257 以降が必要です。

125 * Customize セクションで **Output styles** を選択して、カスタムスタイルを含む[出力スタイル](/docs/ja/output-styles)を選択します。Claude Code v2.1.257 以降が必要です。

126

127 代わりにカスタムスタイルを作成するには、**Output styles** メニューから **Build a custom style** を選択します。Claude Code はプロジェクトまたはユーザーレベルで[スタイルファイル](/docs/ja/output-styles#create-a-custom-output-style)を作成します。Claude Code v2.1.261 以降が必要です。

128 * Customize セクションで **Hooks** を選択して、セッションに読み込まれた[hooks](/docs/ja/hooks)をイベント別にグループ化して表示します。ユーザー、プロジェクト、ローカル設定ファイルに保存された hooks を追加、編集、または削除できます。マネージド設定やプラグインなどの他のソースからの Hooks は読み取り専用です。Claude Code v2.1.269 以降が必要です。

129 * Customize セクションで **Permissions** を選択して、セッションの[権限ルール](/docs/ja/permissions)を Allow、Ask、Deny にグループ化して表示します。ユーザー、プロジェクト、またはローカル設定にルールを追加し、そこに保存されたルールを削除できます。マネージド設定やこのセッションのみの承認など、他のソースからのルールは読み取り専用です。Claude Code v2.1.269 以降が必要です。

130 * Customize セクションで **Memory** を選択して、[自動メモリ](/docs/ja/memory#auto-memory)をオンまたはオフにします。オンの場合、Claude が保存したメモリを参照し、それらを保存するフォルダをファイルマネージャーで表示することもできます。Claude Code v2.1.274 以降が必要です。

131

132 保存されたメモリをクリックしてダイアログで読み取り、テキストを編集したり、メモリを削除したり、そのファイルをエディターで開いたりできます。ダイアログでメモリを表示、編集、削除するには Claude Code v2.1.275 以降が必要です。

133 * Customize セクションで **Instructions** を選択して、Claude が読む[CLAUDE.md ファイル](/docs/ja/memory#claude-md-files)を編集します。ファイルを選択してエディターで開きます。ファイルがまだ存在しない場合、Claude Code は最初にそれを作成します。Claude Code v2.1.274 以降が必要です。

121 * Settings セクションには **Enable Remote Control for all sessions** が含まれており、これは [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) を設定して、[新しいインタラクティブセッションが Remote Control に自動的に接続するかどうか](/docs/ja/remote-control#enable-remote-control-for-all-sessions)を制御します。Claude Code v2.1.203 以降が必要です。134 * Settings セクションには **Enable Remote Control for all sessions** が含まれており、これは [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) を設定して、[新しいインタラクティブセッションが Remote Control に自動的に接続するかどうか](/docs/ja/remote-control#enable-remote-control-for-all-sessions)を制御します。Claude Code v2.1.203 以降が必要です。

122 135

123 VS Code ウィンドウでトグルをオンまたはオフにすると、その変更は、その後に開始するセッションだけでなく、その VS Code ウィンドウで既に開いているセッションに適用されます。オフにすると、開いているセッションは切断されます。Claude Code v2.1.261 以降では、その変更は他の VS Code ウィンドウで開いているセッションにも到達します。136 VS Code ウィンドウでトグルをオンまたはオフにすると、その変更は、その後に開始するセッションだけでなく、その VS Code ウィンドウで既に開いているセッションに適用されます。オフにすると、開いているセッションは切断されます。Claude Code v2.1.261 以降では、その変更は他の VS Code ウィンドウで開いているセッションにも適用されます。

124 * Settings セクションには **Focus view** も含まれており、これはツール呼び出し、ツール結果、思考を展開可能な行の背後に隠し、プロンプトと Claude の応答を残します。そこでトグルするか、`Ctrl+Option+F`（Mac）/ `Ctrl+Alt+F`（Windows/Linux）で、またはコマンドパレットから **Claude Code: Toggle Focus view** で切り替えます。変更はすべての開いているセッションに適用され、セッション全体で保持されます。Claude Code v2.1.221 以降が必要です。137 * Settings セクションには **Focus view** も含まれており、これはツール呼び出し、ツール結果、思考を展開可能な行の背後に隠し、プロンプトと Claude の応答を残します。そこで切り替えるか、`Ctrl+Option+F`（Mac）/ `Ctrl+Alt+F`（Windows/Linux）で切り替えるか、コマンドパレットから **Claude Code: Toggle Focus view** で切り替えます。変更はすべての開いているセッションに適用され、セッション全体で保持されます。Claude Code v2.1.221 以降が必要です。

125 138

126 Claude の最新の to-do リストは表示されたままで、Claude からの保留中の質問が尋ねているテキストも表示されます。これには Claude Code v2.1.225 以降が必要です。Claude が [subagents](/docs/ja/sub-agents) を実行している間、最新のアクティビティを含むライブ進捗行は、それらを開始したツール呼び出しグループの下に表示されます。これには Claude Code v2.1.269 以降が必要です。139 Claude の最新のやることリストは表示されたままになり、Claude からの保留中の質問が尋ねているテキストも表示されたままになります。これには Claude Code v2.1.225 以降が必要です。Claude が[サブエージェント](/docs/ja/sub-agents)を実行している間、最新のアクティビティを含むライブ進捗行が、それらを開始したツール呼び出しグループの下に表示されます。これには Claude Code v2.1.269 以降が必要です。

140 * Anthropic アカウントからサインアウトするには、Settings セクションで **Sign out** を選択するか、`/logout` を入力します。[サードパーティプロバイダー](#use-third-party-providers)では、メニューはどちらも提供しません。Claude Code v2.1.277 以降が必要です。

127 * バグを報告するには、メニューの下部にある **Report a problem** をクリックするか、`/bug` または `/feedback` をオプションの説明と共に入力して、レポートに事前入力します。レポートを送信し、ファーストパーティ接続で Anthropic にサインインしている場合、Claude Code はそれを Anthropic に送信します。サードパーティプロバイダーまたは Anthropic 認証情報がない場合、ダイアログは引き続き開きますが、送信するとエラーが表示され、何も送信されません。CLI の `/bug` とは異なり、拡張機能はローカルアーカイブを作成しません。Claude Code v2.1.229 以降が必要です。141 * バグを報告するには、メニューの下部にある **Report a problem** をクリックするか、`/bug` または `/feedback` をオプションの説明と共に入力して、レポートに事前入力します。レポートを送信し、ファーストパーティ接続で Anthropic にサインインしている場合、Claude Code はそれを Anthropic に送信します。サードパーティプロバイダーまたは Anthropic 認証情報がない場合、ダイアログは引き続き開きますが、送信するとエラーが表示され、何も送信されません。CLI の `/bug` とは異なり、拡張機能はローカルアーカイブを作成しません。Claude Code v2.1.229 以降が必要です。

128 142

129 組織のポリシーが製品フィードバックをオフにしている場合、**Report a problem** はメニューに表示されず、`/bug` と `/feedback` はレポートを開く代わりに `Feedback is turned off by your organization's policy or this environment's settings.` という通知を表示します。143 組織のポリシーが製品フィードバックをオフにしている場合、**Report a problem** はメニューに表示されず、`/bug` と `/feedback` はレポートを開く代わりに `Feedback is turned off by your organization's policy or this environment's settings.` という通知を表示します。

130* **Side questions**: `/btw` の後に質問を入力して、[会話に追加せずに](/docs/ja/interactive-mode#side-questions-with-%2Fbtw)セッションについて質問します。答えはチャットの横のパネルで開き、そこでフォローアップ質問をすることができます。スレッドはウィンドウの再読み込みを生き残ります。Claude Code は最新の 20 回の交換を保持し、Claude Code が [安全に保持期間を決定できる](/docs/ja/claude-directory#cleaned-up-automatically)限り、[`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays) スケジュールで保存されたスレッドを期限切れにします。スレッドをクリアするには、パネルのゴミ箱アイコンをクリックします。Claude Code v2.1.227 以降が必要です。144* **サイドクエスチョン**: `/btw` の後に質問を入力して、[会話に追加せずに](/docs/ja/interactive-mode#side-questions-with-%2Fbtw)セッションについて質問します。答えはチャットの横のパネルで開き、そこでフォローアップの質問をすることができます。スレッドはウィンドウの再読み込みを通じて保持されます。Claude Code は最新の 20 回の交換を保持し、Claude Code が[保持期間を安全に判断できる](/docs/ja/claude-directory#cleaned-up-automatically)限り、[`cleanupPeriodDays`](/docs/ja/settings-reference#cleanupperioddays)スケジュールに従って保存されたスレッドを期限切れにします。スレッドをクリアするには、パネルのゴミ箱アイコンをクリックします。Claude Code v2.1.227 以降が必要です。

131* **Context indicator**: プロンプトボックスは Claude のコンテキストウィンドウをどのくらい使用しているかを表示します。Claude は必要に応じて自動的にコンパクトにするか、`/compact` を手動で実行できます。145* **応答をコピー**: 応答にマウスを置いて **Copy response** をクリックしてクリップボードにコピーするか、`/copy` を入力して最新の応答をコピーします。`/copy 2` は 2 番目に新しい応答をコピーします。Claude Code v2.1.277 以降が必要です。

132* **Prompt cache clock**: コンテキスト指示器の横にあるクロックアイコンは、会話の [prompt cache](/docs/ja/prompt-caching) がキャッシュの 5 分または 1 時間の [lifetime](/docs/ja/prompt-caching#cache-lifetime) の前に期限切れになるまでの時間を推定します。キャッシュの有効期間からカウントダウンし、キャッシュを使用する各応答がカウントダウンを再開します。コンパクション以外に、[キャッシュを無効にするアクション](/docs/ja/prompt-caching#actions-that-invalidate-the-cache)はクロックをリセットしないため、モデルを切り替えた後でも残り時間を表示できます。146* **コンテキスト表示**: プロンプトボックスは Claude のコンテキストウィンドウをどの程度使用しているかを表示します。Claude は必要に応じて自動的にコンパクトにするか、`/compact` を手動で実行できます。

133 * カウントダウンが終了するまで、アイコンは **12m** などの残り分数を表示します。147* **プロンプトキャッシュクロック**: コンテキスト表示の横にある時計アイコンは、会話の[プロンプトキャッシュ](/docs/ja/prompt-caching)が期限切れになるまでの時間を推定します。キャッシュの 5 分または 1 時間の[有効期限](/docs/ja/prompt-caching#cache-lifetime)からカウントダウンし、キャッシュを使用する各応答がカウントダウンを再開します。コンパクション以外に、[キャッシュを無効にするアクション](/docs/ja/prompt-caching#actions-that-invalidate-the-cache)はクロックをリセットしないため、モデルを切り替えた後も残り時間を表示できます。

134 * カウントダウンが終了すると、分数が消え、アイコンは赤色またはテーマのエラーカラーに変わり、次の応答まで続きます。キャッシュは期限切れの可能性があるため、キャッシュが再構築される間、次のメッセージへのより遅く、より高価な応答を予期してください。5 分の有効期間がメッセージ間で実行され続ける場合は、[TTL を自分で選択](/docs/ja/prompt-caching#choose-the-ttl-yourself)を参照してください。148 * カウントダウンが終了するまで、アイコンは **12m** などの残り時間を表示します。

135 * 会話が [compacted](/docs/ja/prompt-caching#compacting-the-conversation) された直後、アイコンは次の応答まで分数なしで赤色に変わります。これは、キャッシュがコンパクトされた会話をまだカバーしていないためです。149 * カウントダウンが終了すると、分が消え、アイコンは赤くなるか、次の応答までテーマのエラーカラーになります。キャッシュは期限切れの可能性があるため、次のメッセージへの応答が遅くなり、キャッシュが再構築される間、より高くなることを予想してください。5 分の有効期限がメッセージ間で実行され続ける場合は、[TTL を自分で選択](/docs/ja/prompt-caching#choose-the-ttl-yourself)を参照してください。

136* **Agent map**: 会話に [subagents](/docs/ja/sub-agents) が含まれている場合、プロンプトボックスの下部に **2 agents** などのエージェント数が表示されます。そのドットは、subagent が動作しているか、あなたの権限を待っているかを示します。150 * 会話が[コンパクト化](/docs/ja/prompt-caching#compacting-the-conversation)された直後、アイコンは次の応答までの分なしで赤くなります。キャッシュはまだコンパクト化された会話をカバーしていないためです。

~~137~~ 151* **エージェントマップ**: 会話に[サブエージェント](/docs/ja/sub-agents)が含まれている場合、プロンプトボックスの下部に **2 agents** などのエージェント数が表示されます。そのドットは、サブエージェントが動作しているか、権限を待っているかを示します。

138 エージェント数をクリックしてエージェントマップを開きます。これは会話の subagents をメインエージェントの下のツリーとして描画し、各エージェントのステータス、経過時間、トークン数を表示します。subagent をクリックして、そのプロンプトとツール呼び出しを表示し、読み取り専用トランスクリプトを開くか、実行中に停止します。Claude Code v2.1.269 以降が必要です。152

139* **Extended thinking**: Claude が複雑な問題を推論するのに時間をかけることができます。コマンドメニュー（`/`）経由でオンに切り替えます。Claude の推論は会話に折りたたまれたブロックとして表示されます。ブロックをクリックして読むか、`Ctrl+O` を押してセッション内のすべての思考ブロックを展開または折りたたみます。詳細については、[Extended thinking](/docs/ja/model-config#extended-thinking) を参照してください。153 エージェント数をクリックしてエージェントマップを開きます。これは会話のサブエージェントをメインエージェントの下のツリーとして描画し、それぞれのステータス、経過時間、トークン数を表示します。サブエージェントをクリックして、そのプロンプトとツール呼び出しを表示したり、読み取り専用トランスクリプトを開いたり、実行中に停止したりできます。Claude Code v2.1.269 以降が必要です。

140* **Multi-line input**: `Shift+Enter` を押して、送信せずに新しい行を追加します。これは質問ダイアログの「Other」フリーテキスト入力でも機能します。154

155 マップは、バックグラウンドシェルコマンドや[モニター](/docs/ja/tools-reference#monitor-tool)などのセッションの他の[バックグラウンドタスク](/docs/ja/tools-reference#background-commands)もエージェントの下に一覧表示します。行をクリックしてタスクのカードを開き、そこで停止します。

156

157 エージェント数が表示されていない場合（Claude がバックグラウンドシェルを開始したがサブエージェントがない場合など）にマップを開くには、プロンプトボックスで `/tasks` を入力します。マップ内のバックグラウンドタスクと入力された `/tasks` には Claude Code v2.1.277 以降が必要です。

158* **拡張思考**: Claude が複雑な問題を推論するためにより多くの時間を費やすことができます。コマンドメニュー（`/`）経由でオンに切り替えます。Claude の推論は会話に折りたたまれたブロックとして表示されます。ブロックをクリックして読むか、`Ctrl+O` を押してセッション内のすべての思考ブロックを展開または折りたたみます。詳細については、[拡張思考](/docs/ja/model-config#extended-thinking)を参照してください。

159* **複数行入力**: `Shift+Enter` を押して、送信せずに新しい行を追加します。これは質問ダイアログの「その他」フリーテキスト入力でも機能します。

141 160

142<h3 id="reference-files-and-folders">161<h3 id="reference-files-and-folders">

143 ファイルとフォルダを参照する162 ファイルとフォルダを参照する

144</h3>163</h3>

145 164

146@-mentions を使用して、特定のファイルまたはフォルダについて Claude にコンテキストを提供します。`@` の後にファイルまたはフォルダ名を入力すると、Claude はそのコンテンツを読み取り、それについて質問に答えたり、変更を加えたりできます。Claude Code はファジーマッチングをサポートしているため、部分的な名前を入力して必要なものを見つけることができます。165@-メンションを使用して、特定のファイルまたはフォルダに関するコンテキストを Claude に提供します。`@` の後にファイルまたはフォルダ名を入力すると、Claude はそのコンテンツを読み取り、それについて質問に答えたり、変更を加えたりできます。Claude Code はあいまい一致をサポートしているため、部分的な名前を入力して必要なものを見つけることができます。

147 166

148```text wrap theme={null}167```text wrap theme={null}

149Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)168Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)

150What's in @src/components/ (include a trailing slash for folders)169What's in @src/components/ (include a trailing slash for folders)

151```170```

152 171

153大きな PDF の場合、ファイル全体ではなく特定のページを読むよう Claude に依頼できます。単一ページ、1～10 ページのような範囲、またはページ 3 以降のようなオープンエンド範囲です。172大きな PDF の場合、ファイル全体ではなく特定のページを読むよう Claude に依頼できます。単一ページ、1～10 ページなどの範囲、またはページ 3 以降などのオープンエンド範囲。

154 173

155エディターでテキストを選択すると、Claude は強調表示されたコードを自動的に見ることができます。プロンプトボックスのフッターは、選択されている行数を表示します。`Option+K`（Mac）/ `Alt+K`（Windows/Linux）を押して、ファイルパスと行番号を含む @-mention を挿入します（例：`@app.ts#5-10`）。選択指示器の **X** をクリックして、Claude が選択を受け取らないようにします。別のテキストを選択すると、指示器が戻ります。174エディターでテキストを選択すると、Claude は強調表示されたコードを自動的に表示できます。プロンプトボックスのフッターは、選択されている行数を表示します。`Option+K`（Mac）/ `Alt+K`（Windows/Linux）を押して、ファイルパスと行番号を含む @-メンション（例：`@app.ts#5-10`）を挿入します。選択表示の **X** をクリックして削除し、Claude が選択を受け取らないようにします。他のテキストを選択すると、表示が戻ります。

156 175

157Claude はエディターで開いているファイルも見ることができます。何も選択されていない場合でも、プロンプトボックスはそのファイル名を表示します。選択したテキストのみを追加するには、[Attach Open File setting](vscode://settings/claudeCode.attachOpenFile) をオフにします。この設定には Claude Code v2.1.271 以降が必要です。176拡張機能は一部のファイルから選択されたテキストを保留します。ファイルがワークスペース内にあり、`files.exclude` または `search.exclude` 設定と一致する場合、Claude は最大でもファイルのパスを受け取り、選択したテキストは受け取りません。同じことが git が無視するファイルにも適用されます。ただし、VS Code の `search.useIgnoreFiles` 設定と拡張機能の [`respectGitIgnore` 設定](#extension-settings)の両方がオンになっている場合に限ります。これはデフォルトです。このフィルターはチャットパネルのみをカバーします。Claude Code が統合ターミナルで実行される場合、CLI はファイルに関係なく選択されたテキストを送信するため、[`Read` 拒否ルール](#the-built-in-ide-mcp-server)を追加して、ファイルのコンテンツが Claude にそこに到達しないようにします。

158 177

159画像を添付するには、クリップボードからプロンプトボックスに貼り付けます。また、`Shift` を押しながらファイルをプロンプトボックスにドラッグして、添付ファイルとして追加することもできます。任意の添付ファイルの X をクリックして、コンテキストから削除します。178Claude はエディターで開いているファイルも表示します。何も選択されていない場合でも、プロンプトボックスはその名前を表示します。選択されたテキストのみを追加するには、[Attach Open File 設定](vscode://settings/claudeCode.attachOpenFile)をオフにします。この設定には Claude Code v2.1.271 以降が必要です。

179

180メッセージに画像とファイルを添付することもできます。

181

182* 画像を添付するには、クリップボードからプロンプトボックスに貼り付けます。

183* ファイルを添付するには、`Shift` を押しながらプロンプトボックスにドラッグします。

184* コンテキストから添付ファイルを削除するには、その X をクリックします。

160 185

161<h3 id="resume-past-conversations">186<h3 id="resume-past-conversations">

162 過去の会話を再開する187 過去の会話を再開する

164 189

165Claude Code パネルの上部にある **Session history** ボタンをクリックして、会話履歴にアクセスします。キーワードで検索するか、時間で参照できます。190Claude Code パネルの上部にある **Session history** ボタンをクリックして、会話履歴にアクセスします。キーワードで検索するか、時間で参照できます。

166 191

167任意の会話をクリックして、完全なメッセージ履歴で再開します。セッションが現在のウィンドウの別のタブで既に開いている場合、クリックするとそのタブに切り替わります。セッションの再開の詳細については、[Manage sessions](/docs/ja/sessions) を参照してください。192任意の会話をクリックして、完全なメッセージ履歴で再開します。会話が現在のウィンドウの別のタブで既に開いている場合、クリックするとそのタブに切り替わります。セッションの再開の詳細については、[セッションを管理](/docs/ja/sessions)を参照してください。

168 193

169* **Session titles**: 新しいセッションは、最初のメッセージに基づいて AI が生成したタイトルを受け取ります。194* **セッションタイトル**: 新しいセッションは最初のメッセージに基づいて AI が生成したタイトルを受け取ります。

170* **Rename and archive**: セッションの上にマウスを置くと、これらのアクションが表示されます。説明的なタイトルを付けるために名前変更するか、リストの下部にある **Archived sessions** グループに移動するためにアーカイブします。195* **名前変更とアーカイブ**: セッションにマウスを置いて、これらのアクションを表示します。説明的なタイトルを付けるために名前を変更するか、リストの下部にある **Archived sessions** グループに移動するためにアーカイブします。

171 196

172デフォルトでは、14 日間アクティビティがないセッションは、開いている、未読、または [group](#organize-sessions-into-groups) にない限り、自動的に **Archived sessions** に移動します。自動アーカイブには Claude Code v2.1.265 以降が必要です。期間を変更するか、オフにするには、[Archive Inactive Sessions setting](vscode://settings/claudeCode.archiveInactiveSessions) を開き、日数を選択するか **Never** を選択します。197デフォルトでは、14 日間アクティビティがないセッションは、開いている、未読、または[グループ](#organize-sessions-into-groups)内にない限り、自動的に **Archived sessions** に移動します。自動アーカイブには Claude Code v2.1.265 以降が必要です。期間を変更するか、オフにするには、[Archive Inactive Sessions 設定](vscode://settings/claudeCode.archiveInactiveSessions)を開き、日数または **Never** を選択します。

173 198

174アーカイブされたセッションを復元するには、**Archived sessions** を展開して **Unarchive session** をクリックします。v2.1.257 より前では、アクションは **Delete session** でした。これはセッションを隠し、復元する方法がありませんでした。その後削除したセッションは、アップグレード後に **Archived sessions** の下に表示されます。199アーカイブされたセッションを復元するには、**Archived sessions** を展開して **Unarchive session** をクリックします。アーカイブされたすべてのセッションを一度に復元するには、セッションリストの Activity Bar で **Archived sessions** ヘッダーにマウスを置き、その復元アイコンをクリックします。これには Claude Code v2.1.277 以降が必要です。v2.1.257 より前では、アクションは **Delete session** でした。これはセッションを非表示にし、復元する方法がありませんでした。その後削除したセッションは、アップグレード後に **Archived sessions** の下に表示されます。

175 200

176再開した会話が plan モードで終了した場合、Claude Code は plan モードを復元します。Claude Code v2.1.246 以降が必要です。Claude Code は 2 つのケースでは復元しません。201再開した会話が計画モードで終了した場合、Claude Code は計画モードを復元します。Claude Code v2.1.246 以降が必要です。Claude Code は 2 つのケースでは復元しません。

177 202

178* 拡張機能が `claudeCode.initialPermissionMode` から [開始権限モードを選択](/docs/ja/permission-modes#switch-permission-modes)するか、以前の会話から引き継がれるピックがある203* 拡張機能が `claudeCode.initialPermissionMode` から開始権限モードを[選択](/docs/ja/permission-modes#switch-permission-modes)するか、以前の会話から引き継がれたピックがある

179* `claudeCode.claudeProcessWrapper` が設定されている204* `claudeCode.claudeProcessWrapper` が設定されている

180 205

181<h3 id="resume-cloud-sessions-from-claude-ai">206<h3 id="resume-cloud-sessions-from-claude-ai">

182 Claude.ai からクラウドセッションを再開する207 Claude.ai からクラウドセッションを再開する

183</h3>208</h3>

184 209

185[Claude Code on the web](/docs/ja/claude-code-on-the-web) を使用している場合、それらのクラウドセッションを VS Code で直接再開できます。これには Anthropic Console ではなく、**Claude.ai Subscription** でサインインする必要があります。210[クラウドセッション](/docs/ja/claude-code-on-the-web)を実行している場合、VS Code で直接再開できます。これには **Claude.ai Subscription** でのサインインが必要です。Anthropic Console ではありません。

186 211

187<Steps>212<Steps>

188 <Step title="Open session history">213 <Step title="セッション履歴を開く">

189 Claude Code パネルの上部にある **Session history** ボタンをクリックします。214 Claude Code パネルの上部にある **Session history** ボタンをクリックします。

190 </Step>215 </Step>

191 216

192 <Step title="Select the Web tab">217 <Step title="Web タブを選択">

193 ダイアログは 2 つのタブを表示します。Local と Web です。**Web** をクリックして claude.ai からのセッションを表示します。218 ダイアログには 2 つのタブが表示されます。Local と Web です。**Web** をクリックして claude.ai からのセッションを表示します。

194 </Step>219 </Step>

195 220

196 <Step title="Select a session to resume">221 <Step title="再開するセッションを選択">

197 クラウドセッションを参照または検索します。任意のセッションをクリックして、ダウンロードし、会話をローカルで続行します。222 クラウドセッションを参照または検索します。任意のセッションをクリックしてダウンロードし、会話をローカルで続行します。

198 </Step>223 </Step>

199</Steps>224</Steps>

200 225

201<Note>226<Note>

202 Web タブに表示されるのは、GitHub リポジトリで開始された Web セッションのみです。再開するとローカルに会話履歴が読み込まれます。変更は claude.ai に同期されません。227 Web タブに表示されるのは、GitHub リポジトリで開始されたクラウドセッションのみです。再開すると、会話履歴がローカルに読み込まれます。変更は claude.ai に同期されません。

203</Note>228</Note>

204 229

205<h3 id="check-account-and-usage">230<h3 id="check-account-and-usage">

206 アカウントと使用状況を確認する231 アカウントと使用状況を確認する

207</h3>232</h3>

208 233

209`/usage` を実行して、Account & usage ダイアログを開きます。ダイアログは claude.ai サインインが必要なため、[サードパーティプロバイダー](#use-third-party-providers)では提供されません。サインインしたアカウント、プラン、現在のセッションと週の使用状況バーを表示します。各バーは、制限がリセットされるまでの時間を表示します。234`/usage` を実行して Account & usage ダイアログを開きます。サインインしているアカウントを表示し、報告される使用状況はサインインによって異なります。

235

236* **claude.ai プラン**: 現在のセッションと週など、プランの制限の使用状況バー。各バーは、制限がリセットされるまでの時間を表示します。

210 237

211ダイアログは、プラン制限に貢献しているものを詳細に説明します。キャッシュミス、長いコンテキスト、subagent が多い、または高度に並列なセッションなど、最近の使用状況の 10% 以上を占める動作にフラグを立てます。各動作には、それを削減するためのヒントが付いています。Attribution テーブルは、各スキル、subagent、プラグイン、MCP サーバーからどのくらいの使用状況が来たかを示します。238 ダイアログは、プランの制限に寄与しているものも詳しく説明します。キャッシュミス、長いコンテキスト、サブエージェント集約型または高度に並列化されたセッションなど、最近の使用状況の 10% 以上を占める動作にフラグを立て、それぞれを削減するためのヒントを提供します。属性テーブルは、各スキル、サブエージェント、プラグイン、MCP サーバーからどの程度の使用状況が来たかを示します。

212 239

213Day と Week トグルを使用して、過去 24 時間と過去 7 日間を切り替えます。数値は概算であり、このマシン上のローカルセッションから計算されるため、他のデバイスまたは claude.ai からの使用状況は含まれません。使用状況の追跡と削減の詳細については、[Track your costs](/docs/ja/costs#track-your-costs) を参照してください。240 Day と Week トグルを使用して、過去 24 時間と過去 7 日間を切り替えます。数値は概算であり、このマシン上のローカルセッションから計算されるため、他のデバイスまたは claude.ai からの使用状況は含まれません。

241* **その他のサインイン**: [サードパーティプロバイダー](#use-third-party-providers)または API キーなど、プランの制限がサインインに適用されない場合、Usage セクションはセッション自体のコストとトークン使用状況を代わりに表示します。CLI の `/usage` は[セッションブロック](/docs/ja/costs#track-your-costs)で同じ合計を表示します。Activity Bar のセッションリストは、**Account & usage** ヘッダーの下にアクティブセッションの合計も表示します。Claude Code v2.1.277 以降が必要です。

242

243使用状況の追跡と削減の詳細については、[コストを追跡](/docs/ja/costs#track-your-costs)を参照してください。

214 244

215<h2 id="customize-your-workflow">245<h2 id="customize-your-workflow">

216 ワークフローをカスタマイズする246 ワークフローをカスタマイズする

228* **プライマリサイドバー**: Explorer、Search などのアイコンがある左側のサイドバー。258* **プライマリサイドバー**: Explorer、Search などのアイコンがある左側のサイドバー。

229* **エディタ領域**: Claude をファイルの横のタブとして開きます。サイドタスクに便利です。259* **エディタ領域**: Claude をファイルの横のタブとして開きます。サイドタスクに便利です。

230 260

261Claude がエディタグループの新しいタブを開くと、拡張機能はそのグループをロックするため、Claude タブがフォーカスされている間に開いたファイルは別のグループに移動します。

262

263拡張機能がグループをロックするのを停止するには、[Lock Editor Groups 設定](vscode://settings/claudeCode.lockEditorGroups)をオフにします。既にロックされているグループは、ロック解除するまでロックされたままです。この設定には Claude Code v2.1.274 以降が必要です。

264

231<Tip>265<Tip>

232 メイン Claude セッションにはサイドバーを使用し、サイドタスク用に追加タブを開きます。Claude は優先される場所を記憶します。アクティビティバーのセッションリストアイコンは Claude パネルとは別です。セッションリストは常にアクティビティバーに表示されますが、Claude パネルアイコンは左側のサイドバーにドッキングされている場合にのみそこに表示されます。266 メイン Claude セッションにはサイドバーを使用し、サイドタスク用に追加タブを開きます。Claude は優先される場所を記憶します。アクティビティバーのセッションリストアイコンは Claude パネルとは別です。セッションリストは常にアクティビティバーに表示されますが、Claude パネルアイコンは左側のサイドバーにドッキングされている場合にのみそこに表示されます。

233</Tip>267</Tip>

237* **エディタタブ**: 会話はそのタブとともに戻ります。271* **エディタタブ**: 会話はそのタブとともに戻ります。

238* **サイドバー**: 過去 10 分以内にメッセージを送信したか Claude が応答した場合、会話は戻ります。戻らない場合は、[セッション履歴](#resume-past-conversations)から会話を再開してください。272* **サイドバー**: 過去 10 分以内にメッセージを送信したか Claude が応答した場合、会話は戻ります。戻らない場合は、[セッション履歴](#resume-past-conversations)から会話を再開してください。

239 273

274リロードが Claude の途中のステップを中断した場合、会話が戻ると Claude はそのステップを続行し、チャット内の通知が継続をマークします。Claude Code v2.1.274 以降が必要です。ステップが 1 時間以上前に中断されたか、セッションが別の場所で開かれている場合、会話はアイドル状態で戻ります。

275

276継続をオフにするには、[Continue After Reload 設定](vscode://settings/claudeCode.continueAfterReload)を開いてチェックを外します。

277

240<h3 id="run-multiple-conversations">278<h3 id="run-multiple-conversations">

241 複数の会話を実行する279 複数の会話を実行する

242</h3>280</h3>

304URL は 2 つのクエリパラメータを受け取ります。342URL は 2 つのクエリパラメータを受け取ります。

305 343

306| パラメータ | 説明 |344| パラメータ | 説明 |

307| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |345| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |

309| `marketplace` | プラグインの出所。[マーケットプレイスタブ](#manage-marketplaces)が受け入れる任意の形式（GitHub の `owner/repo` または git URL など）。`&` などの文字が含まれている場合は URL エンコードしてください。省略した場合は `anthropics/claude-plugins-official` がデフォルトになります。 |347| `marketplace` | プラグインの出所：GitHub の `owner/repo`、`https://` URL、または `git@github.com:owner/repo.git` などの git SSH URL。省略した場合は `anthropics/claude-plugins-official` がデフォルトになります。 |

348

349[マーケットプレイスタブ](#manage-marketplaces)が受け入れるいくつかの値（ローカルパスや `http://` アドレスなど）はリンクでは機能しません。これらの場合、VS Code はエラーメッセージを表示し、ダイアログは開きません。

310 350

3112 つのケースでは、スコープ選択ではなくダイアログのメッセージで終了します。3512 つのケースでは、スコープ選択ではなくダイアログのメッセージで終了します。

312 352

364</Note>404</Note>

365 405

366| コマンド | ショートカット | 説明 |406| コマンド | ショートカット | 説明 |

367| -------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |407| -------------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |

409| Focus last message | - | 会話内の最新メッセージ、または待機中の権限プロンプトにキーボードフォーカスを移動します。キーボードまたはスクリーンリーダーでそこから読み取ることができます。[ターミナルモード](#switch-to-terminal-mode)では利用できません。Claude Code v2.1.268 以降が必要です |

369| Open in Side Bar | - | Claude をサイドバーで開きます |410| Open in Side Bar | - | Claude をサイドバーで開きます |

370| Open in Terminal | - | Claude をターミナルモードで開きます |411| Open in Terminal | - | Claude をターミナルモードで開きます |

374| Reopen Closed Session | `Cmd+Shift+T`（Mac）/ `Ctrl+Shift+T`（Windows/Linux） | 最近閉じた Claude セッションタブを再度開きます。最後に閉じたタブが Claude セッションではない場合、VS Code の通常の再度開く機能にフォールスルーします。`enableReopenClosedSessionShortcut` で無効にできます |415| Reopen Closed Session | `Cmd+Shift+T`（Mac）/ `Ctrl+Shift+T`（Windows/Linux） | 最近閉じた Claude セッションタブを再度開きます。最後に閉じたタブが Claude セッションではない場合、VS Code の通常の再度開く機能にフォールスルーします。`enableReopenClosedSessionShortcut` で無効にできます |

417| Accept Change at Cursor | - | [提案された編集をレビューする](#get-started)際に、カーソル位置の変更を 1 つずつ受け入れます。Claude Code v2.1.275 以降が必要です |

418| Reject Change at Cursor | - | 提案された編集をレビューする際に、カーソル位置の変更を 1 つずつ元に戻します。Claude Code v2.1.275 以降が必要です |

377| Rename Session Tab | - | アクティブな Claude タブのセッションの名前を変更します。Claude Code v2.1.257 以降が必要です |420| Rename Session Tab | - | アクティブな Claude タブのセッションの名前を変更します。Claude Code v2.1.257 以降が必要です |

378| Add Session Tab to Group | - | アクティブな Claude タブのセッションを、選択または作成する[セッショングループ](#organize-sessions-into-groups)に追加します。Claude Code v2.1.257 以降が必要です |421| Add Session Tab to Group | - | アクティブな Claude タブのセッションを、選択または作成する[セッショングループ](#organize-sessions-into-groups)に追加します。Claude Code v2.1.257 以降が必要です |

453VS Code は `initialPermissionMode` をユーザー設定から読み込み、ワークスペース値を無視します。v2.1.225 より前では、VS Code は設定をデフォルトの `default` に設定し、ワークスペース値を適用していました。496VS Code は `initialPermissionMode` をユーザー設定から読み込み、ワークスペース値を無視します。v2.1.225 より前では、VS Code は設定をデフォルトの `default` に設定し、ワークスペース値を適用していました。

454 497

455| 設定 | デフォルト | 説明 |498| 設定 | デフォルト | 説明 |

456| ----------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |499| ----------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

458| `initialPermissionMode` | - | 新しい会話の承認プロンプトを制御します：`default`、`plan`、`acceptEdits`、または `bypassPermissions`。`manual` は `default` のエイリアスで、モード指示器で **Manual** というラベルが付いたモードを選択します。設定を未設定のままにすると、拡張機能は [Switch permission modes](/docs/ja/permission-modes#switch-permission-modes) で説明されているように開始権限モードを選択します。 |501| `initialPermissionMode` | - | 新しい会話の承認プロンプトを制御します：`default`、`plan`、`acceptEdits`、または `bypassPermissions`。`manual` は `default` のエイリアスで、モード指示器で **Manual** というラベルが付いたモードを選択します。設定を未設定のままにすると、拡張機能は [Switch permission modes](/docs/ja/permission-modes#switch-permission-modes) で説明されているように開始権限モードを選択します。 |

503| `lockEditorGroups` | `true` | [Claude がそのタブを開始するエディターグループをロック](#choose-where-claude-lives)して、Claude タブがフォーカスされている間に開いたファイルが別のグループに移動するようにします。オフの場合、拡張機能はエディターグループをロックしません。Claude Code v2.1.274 以降が必要です |

507| `scrollToBottomOnSend` | `true` | メッセージを送信するときに会話を下部にスクロールします。オフの場合、会話は元の位置に留まります。Claude Code v2.1.275 以降が必要です |

464| `enableReopenClosedSessionShortcut` | `true` | Cmd/Ctrl+Shift+T を使用して、最近閉じた Claude セッションタブを再度開きます。最後に閉じたタブが Claude セッションではなかった場合、ショートカットは VS Code の通常の再度開く閉じたエディターコマンドを実行します。 |509| `enableReopenClosedSessionShortcut` | `true` | Cmd/Ctrl+Shift+T を使用して、最近閉じた Claude セッションタブを再度開きます。最後に閉じたタブが Claude セッションではなかった場合、ショートカットは VS Code の通常の再度開く閉じたエディターコマンドを実行します。 |

465| `archiveInactiveSessions` | `14` | この日数アクティビティがない場合、[セッションを自動的にアーカイブします](#resume-past-conversations)：`1`、`2`、`7`、または `14`。`0` に設定してオフにします。Claude Code v2.1.265 以降が必要です |510| `archiveInactiveSessions` | `14` | この日数アクティビティがない場合、[セッションを自動的にアーカイブします](#resume-past-conversations)：`1`、`2`、`7`、または `14`。`0` に設定してオフにします。Claude Code v2.1.265 以降が必要です |

511| `continueAfterReload` | `true` | ウィンドウをリロードした後、Claude は復元されたセッションで [中断されたステップを続行します](#choose-where-claude-lives)。Claude Code v2.1.274 以降が必要です |

467| `focusView` | `false` | ツール呼び出し、ツール結果、思考を展開可能な行の背後に非表示にして、プロンプトと Claude の応答を残します。Claude の最新のやることリストは表示されたままです。これには Claude Code v2.1.225 以降が必要です。コマンドメニューから Focus ビューを切り替えることもできます。Claude Code v2.1.221 以降が必要です |513| `focusView` | `false` | ツール呼び出し、ツール結果、思考を展開可能な行の背後に非表示にして、プロンプトと Claude の応答を残します。Claude の最新のやることリストは表示されたままです。これには Claude Code v2.1.225 以降が必要です。コマンドメニューから Focus ビューを切り替えることもできます。Claude Code v2.1.221 以降が必要です |

470| `environmentVariables` | `[]` | Claude プロセスの環境変数を設定します。共有構成には Claude Code 設定を使用してください。 |516| `environmentVariables` | `[]` | Claude プロセスの環境変数を設定します。共有構成には Claude Code 設定を使用してください。 |

473| `claudeProcessWrapper` | - | Claude プロセスを起動するために使用される実行可能ファイル。バンドルされたバイナリパスが存在する場合、引数として渡されます。プラットフォーム用のバイナリが拡張機能ビルドに含まれていない場合は、別途インストールされた `claude` バイナリに設定します。ラップされたセットアップでは、`initialPermissionMode` を設定するか、以前の会話で Manual、Edit automatically、または Auto を選択していない限り、会話は Manual モードで開始されます。これは、拡張機能が設定とビルトインデフォルトステップをスキップするためです。[Switch permission modes](/docs/ja/permission-modes#switch-permission-modes) を参照してください。アクティベーション時の「Unsupported platform」エラーは、プラットフォーム用にバイナリがバンドルされていないことを意味します。[npm install 後にネイティブバイナリが見つからない](/docs/ja/troubleshoot-install#native-binary-not-found-after-npm-install) を参照してください。 |519| `claudeProcessWrapper` | - | Claude プロセスを起動するために使用される実行可能ファイル。バンドルされたバイナリパスが存在する場合、引数として渡されます。プラットフォーム用のバイナリが拡張機能ビルドに含まれていない場合は、別途インストールされた `claude` バイナリに設定します。ラップされたセットアップでは、`initialPermissionMode` を設定するか、以前の会話で Manual、Edit automatically、または Auto を選択していない限り、会話は Manual モードで開始されます。これは、拡張機能が設定とビルトインデフォルトステップをスキップするためです。[Switch permission modes](/docs/ja/permission-modes#switch-permission-modes) を参照してください。アクティベーション時の「Unsupported platform」エラーは、プラットフォーム用にバイナリがバンドルされていないことを意味します。[npm install 後にネイティブバイナリが見つからない](/docs/ja/troubleshoot-install#native-binary-not-found-after-npm-install) を参照してください。 |

474 520

475<h2 id="use-a-screen-reader">521<h2 id="use-a-screen-reader">

476 スクリーンリーダーを使用する522 スクリーンリーダーを使用する

487* **ステータス変更**: 拡張機能は Claude が作業を開始したとき、Claude があなたの入力の準備ができたとき、および Claude Code が会話をコンパクト化し始めたときを通知します。533* **ステータス変更**: 拡張機能は Claude が作業を開始したとき、Claude があなたの入力の準備ができたとき、および Claude Code が会話をコンパクト化し始めたときを通知します。

488* **エラーとモデルプロンプト**: 拡張機能は会話内のエラーを通知し、[使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits) または [フラグ付きリクエストプロンプト](/docs/ja/model-config#ask-before-switching) が表示されたときを通知します。534* **エラーとモデルプロンプト**: 拡張機能は会話内のエラーを通知し、[使用クレジット同意プロンプト](/docs/ja/model-config#fable-and-usage-credits) または [フラグ付きリクエストプロンプト](/docs/ja/model-config#ask-before-switching) が表示されたときを通知します。

489 535

490トランスクリプト内の各ターンは、ターンを開始したプロンプトでラベル付けされた視覚的に隠されたヘッディングで始まるため、スクリーンリーダーのヘッディングナビゲーションを使用してターン間をジャンプできます。`Tab` でトランスクリプト自体にフォーカスを移動することもできます。拡張機能はそれをラベル付きリージョンとして公開しており、自分のペースで読むことができます。Claude が作業している間、スクリーンリーダーはプログレススピナーのアニメーションの代わりにテキストラベルを読みます。536Claude が作業している間、スクリーンリーダーはプログレススピナーのアニメーションの代わりにテキストラベルを読みます。

491 537

492セッションを再度開くか別のセッションに切り替えると、拡張機能は何も通知しません。復元された履歴、保留中の権限プロンプト、および進行中のステータスは、新しいことが発生するまで沈黙を保ちます。538セッションを再度開くか別のセッションに切り替えると、拡張機能は何も通知しません。復元された履歴、保留中の権限プロンプト、および進行中のステータスは、新しいことが発生するまで沈黙を保ちます。

493 539

540<h3 id="use-the-chat-panel-from-the-keyboard">

541 キーボードからチャットパネルを使用する

542</h3>

543

544トランスクリプト内の各ターンは、ターンを開始したプロンプトでラベル付けされた視覚的に隠されたヘッディングで始まるため、スクリーンリーダーのヘッディングナビゲーションを使用してターン間をジャンプできます。

545

546ターン内で、スクリーンリーダーはメッセージを移動するときに、誰のメッセージであるかを通知します。

547

548* **あなたのメッセージ**: 「You」

549* **Claude のメッセージ**: 「Claude」

550* **ツールステップ**: 「Claude」とツール名（「Claude, Bash」など）

551* **思考ブロック**: 「Claude, thinking」

552

553拡張機能はトランスクリプトをラベル付きリージョンとして公開しているため、`Tab` でトランスクリプト自体にフォーカスを移動して、自分のペースで読むこともできます。最新のメッセージまたは待機中の権限プロンプトにフォーカスを移動するには、代わりに [コマンドパレット](#vs-code-commands-and-shortcuts) から **Claude Code: Focus last message** を実行します。

554

555権限プロンプトのオプションが権限ルールまたはディレクトリアクセスを保存する場合、そのラベルは「すべてのプロジェクト」や「このセッション」など、承認が保存される場所を名前で指定して終了します。そのオプションにフォーカスがある場合、`Left` または `Right` 矢印キーを押して保存先を変更でき、拡張機能は移動するたびに各保存先を通知します。ラベル内の保存先をクリックすることもできます。矢印キーには Claude Code v2.1.268 以降が必要です。

556

494<h2 id="vs-code-extension-vs-claude-code-cli">557<h2 id="vs-code-extension-vs-claude-code-cli">

495 VS Code 拡張機能と Claude Code CLI558 VS Code 拡張機能と Claude Code CLI

496</h2>559</h2>

503| MCP サーバー設定 | はい | はい（チャットパネルで `/mcp` を使用して[サーバーを追加・管理](#connect-to-external-tools-with-mcp)） |566| MCP サーバー設定 | はい | はい（チャットパネルで `/mcp` を使用して[サーバーを追加・管理](#connect-to-external-tools-with-mcp)） |

504| チェックポイント | はい | はい |567| チェックポイント | はい | はい |

505| `!` bash ショートカット | はい | いいえ |568| `!` Bash ショートカット | はい | いいえ |

506| タブ補完 | はい | いいえ |569| タブ補完 | はい | いいえ |

507 570

508<h3 id="rewind-with-checkpoints">571<h3 id="rewind-with-checkpoints">

543 バックグラウンドプロセスを監視する606 バックグラウンドプロセスを監視する

544</h3>607</h3>

545 608

546拡張機能でのバックグラウンドタスクの可視性は CLI と比較して限定的です。より良い可視性を得るには、Claude にコマンドを出力させて、VS Code の統合ターミナルで実行します。609プロンプトボックスで `/tasks` を入力して[エージェントマップ](#use-the-prompt-box)を開きます。これにより、セッションのバックグラウンドタスク（Claude がバックグラウンドシェルコマンドとして実行中の開発サーバーなど）が一覧表示されます。タスクをクリックしてそのカードを開き、そこで停止できます。Claude Code v2.1.277 以降が必要です。

547 610

548<h3 id="connect-to-external-tools-with-mcp">611<h3 id="connect-to-external-tools-with-mcp">

549 MCP を使用して外部ツールに接続する612 MCP を使用して外部ツールに接続する

610 </Step>673 </Step>

611</Steps>674</Steps>

612 675

613サードパーティプロバイダーでは、拡張機能は claude.ai アカウントが必要な機能（使用状況の追跡、[音声入力](/docs/ja/voice-dictation)、[クラウドセッション](#resume-cloud-sessions-from-claude-ai)用の Web タブなど）を提供しません。以前の `/login` から残された claude.ai サインインは未使用のままです。拡張機能はリクエストと共にそれを送信しません。676サードパーティプロバイダーでは、拡張機能は claude.ai アカウントが必要な機能（プラン使用状況バー、[音声入力](/docs/ja/voice-dictation)、[クラウドセッション](#resume-cloud-sessions-from-claude-ai)用の Web タブなど）を提供しません。これらのサインインで Account & usage ダイアログが表示する内容については、[アカウントと使用状況を確認する](#check-account-and-usage)を参照してください。以前の `/login` から残された claude.ai サインインは未使用のままです。拡張機能はリクエストと共にそれを送信しません。

614 677

615<h2 id="security-and-privacy">678<h2 id="security-and-privacy">

616 セキュリティとプライバシー679 セキュリティとプライバシー

workflows.md +4 −2

Details

231 231

232v2.1.216 より前は、Claude Code はリンクをたどり、選択した場所の外にファイルを配置する可能性がありました。232v2.1.216 より前は、Claude Code はリンクをたどり、選択した場所の外にファイルを配置する可能性がありました。

233 233

234複数の `.claude/` ディレクトリを持つモノレポでは、ワークフローを適用するパッケージの横に保持できます。v2.1.178 以降、プロジェクト場所に保存すると、作業ディレクトリとリポジトリルートの間に既に存在する最も近い `.claude/workflows/` ディレクトリに書き込むか、まだ存在しない場合はリポジトリルートに書き込みます。プロジェクトワークフローはそのパスに沿ったすべての `.claude/workflows/` からも読み込まれ、複数が同じ名前を定義する場合、Claude Code は作業ディレクトリに最も近いものを実行します。234複数の `.claude/` ディレクトリを持つモノレポでは、ワークフローを適用するパッケージの横に保持できます。プロジェクト場所に保存すると、作業ディレクトリとリポジトリルートの間に既に存在する最も近い `.claude/workflows/` ディレクトリに書き込むか、まだ存在しない場合はリポジトリルートに書き込みます。プロジェクトワークフローはそのパスに沿ったすべての `.claude/workflows/` からも読み込まれ、複数が同じ名前を定義する場合、Claude Code は作業ディレクトリに最も近いものを実行します。

235 235

236プロジェクトワークフローと個人用ワークフローが名前を共有する場合、プロジェクトのものが実行されます。236プロジェクトワークフローと個人用ワークフローが名前を共有する場合、プロジェクトのものが実行されます。

237 237

348 348

349本体は最上位の `await` を持つプレーン JavaScript です。`agent()` は 1 つのサブエージェントを生成し、`pipeline()` はリスト内の 1 つのアイテムごとに 1 つを実行し、`parallel()` は一連のエージェントタスクを同時に実行してすべてが完了するのを待ちます。349本体は最上位の `await` を持つプレーン JavaScript です。`agent()` は 1 つのサブエージェントを生成し、`pipeline()` はリスト内の 1 つのアイテムごとに 1 つを実行し、`parallel()` は一連のエージェントタスクを同時に実行してすべてが完了するのを待ちます。

350 350

351`agent()` 呼び出しは、実行中に停止した場合または回復不可能な API エラーが発生した場合は `null` に解決されます。[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、分類器はサブエージェントが開始される前に `agent()` 呼び出しをブロックできます。ブロックされた呼び出しは `null` に解決され、理由とともに実行の進捗ビューに表示されます。`pipeline()` はその `null` を結果配列に保持するため、例は `.filter(Boolean)` で終わってそれらのエントリを削除します。351`agent()` 呼び出しは、実行中に停止した場合または回復不可能な API エラーが発生した場合は `null` に解決されます。`pipeline()` はその `null` を結果配列に保持するため、例は `.filter(Boolean)` で終わってそれらのエントリを削除します。

352

353[auto モード](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、スクリプトが `agent()` に渡すプロンプトは、分類器がそのサブエージェントのアクションをレビューするときにあなたからのリクエストとしてカウントされません。Claude Code はそれをスクリプトが計算したテキストとしてマークするためです。

352 354

353`agent()` 呼び出しで `schema` を渡す場合、そのサブエージェントはプローズの代わりに形状に一致する JSON を返します。Claude Code はサブエージェントを開始する前にスキーマをチェックします。スキーマが矛盾していることを証明できる場合、呼び出しは矛盾を名前付けするエラーで失敗し、サブエージェントは開始されません。証明できる 1 つの矛盾は、`additionalProperties: false` が除外する `required` キーです。355`agent()` 呼び出しで `schema` を渡す場合、そのサブエージェントはプローズの代わりに形状に一致する JSON を返します。Claude Code はサブエージェントを開始する前にスキーマをチェックします。スキーマが矛盾していることを証明できる場合、呼び出しは矛盾を名前付けするエラーで失敗し、サブエージェントは開始されません。証明できる 1 つの矛盾は、`additionalProperties: false` が除外する `required` キーです。

354 356

Documentation 2026-09-21 22:59 UTC to 2026-09-22 23:59 UTC