SpyBara
Go Premium

Documentation 2026-06-16 21:57 UTC to 2026-06-17 17:02 UTC

115 files changed +7,454 −1,455. View all changes and history on the product overview
2026
Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

admin-setup.md +24 −9

Details

22| [使用状況の可視性をセットアップする](#set-up-usage-visibility) | 支出と採用を追跡する方法 | [Analytics](/ja/analytics)、[Monitoring](/ja/monitoring-usage)、[Costs](/ja/costs) |22| [使用状況の可視性をセットアップする](#set-up-usage-visibility) | 支出と採用を追跡する方法 | [Analytics](/ja/analytics)、[Monitoring](/ja/monitoring-usage)、[Costs](/ja/costs) |

23| [データ処理を確認する](#review-data-handling) | データ保持とコンプライアンス体制 | [Data usage](/ja/data-usage)、[Security](/ja/security) |23| [データ処理を確認する](#review-data-handling) | データ保持とコンプライアンス体制 | [Data usage](/ja/data-usage)、[Security](/ja/security) |

24 24 

25## API プロバイダーを選択する25<h2 id="choose-your-api-provider">

26 API プロバイダーを選択する

27</h2>

26 28 

27Claude Code は複数の API プロバイダーのいずれかを通じて Claude に接続します。選択は課金、認証、継承するコンプライアンス体制、および開発者が使用できる Claude Code 機能に影響します。29Claude Code は複数の API プロバイダーのいずれかを通じて Claude に接続します。選択は課金、認証、継承するコンプライアンス体制、および開発者が使用できる Claude Code 機能に影響します。

28 30 


40 42 

41[ネットワーク設定](/ja/network-config) のプロキシとファイアウォール要件は、プロバイダーに関係なく適用されます。複数のプロバイダーの前に単一のエンドポイントを配置したい場合、または集中化されたリクエストログを記録したい場合は、[LLM gateway](/ja/llm-gateway) を参照してください。43[ネットワーク設定](/ja/network-config) のプロキシとファイアウォール要件は、プロバイダーに関係なく適用されます。複数のプロバイダーの前に単一のエンドポイントを配置したい場合、または集中化されたリクエストログを記録したい場合は、[LLM gateway](/ja/llm-gateway) を参照してください。

42 44 

43## 設定がデバイスに到達する方法を決定する45<h2 id="decide-how-settings-reach-devices">

46 設定がデバイスに到達する方法を決定する

47</h2>

44 48 

45マネージド設定は、ローカル開発者設定よりも優先されるポリシーを定義します。Claude Code 4 つの場所で設定を探し特定のデバイスで最初に見つかったものを使用します49マネージド設定は、ローカル開発者設定よりも優先されるポリシーを定義します。Claude Code は以下の 4 つのソースを優先順位順にチェックし空でない設定を返す最初のものを適用します

46 50 

47| メカニズム | 配信 | 優先度 | プラットフォーム |51| メカニズム | 配信 | 優先度 | プラットフォーム |

48| :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-- | :------------ |52| :---------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-- | :------------ |


63 67 

64[Server-managed settings](/ja/server-managed-settings) と [Settings files and precedence](/ja/settings#settings-files) を参照してください。68[Server-managed settings](/ja/server-managed-settings) と [Settings files and precedence](/ja/settings#settings-files) を参照してください。

65 69 

66## 実行する内容を決定する70<h2 id="decide-what-to-enforce">

71 実行する内容を決定する

72</h2>

67 73 

68マネージド設定は、ツール、サンドボックス実行、MCP サーバーとプラグインソースへのアクセスをロックダウンし、実行されるフックを制御できます。各行は、それを駆動する設定キーを持つ制御サーフェスです。74マネージド設定は、ツール、サンドボックス実行、MCP サーバーとプラグインソースへのアクセスをロックダウンし、実行されるフックを制御できます。各行は、それを駆動する設定キーを持つ制御サーフェスです。

69 75 


79| [Hook restrictions](/ja/settings#hook-configuration) | マネージドフックのみが読み込まれる。HTTP フック URL を制限する | `allowManagedHooksOnly`、`allowedHttpHookUrls` |85| [Hook restrictions](/ja/settings#hook-configuration) | マネージドフックのみが読み込まれる。HTTP フック URL を制限する | `allowManagedHooksOnly`、`allowedHttpHookUrls` |

80| [Disable agent view](/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザーをオフにする | `disableAgentView` |86| [Disable agent view](/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザーをオフにする | `disableAgentView` |

81| [Version floor](/ja/settings) | 自動更新が組織全体の最小値より下にインストールされるのを防ぐ | `minimumVersion` |87| [Version floor](/ja/settings) | 自動更新が組織全体の最小値より下にインストールされるのを防ぐ | `minimumVersion` |

88| [Required version range](/ja/settings) | 実行中のバージョンが組織承認の範囲外の場合、まったく起動を拒否する。`minimumVersion` より強力で、ダウングレードのみをブロックする | `requiredMinimumVersion`、`requiredMaximumVersion` |

82 89 

83パーミッションルールとサンドボックスは異なるレイヤーをカバーします。WebFetch を拒否すると Claude の fetch ツールがブロックされますが、Bash が許可されている場合、`curl` と `wget` は依然として任意の URL に到達できます。サンドボックスは OS レベルで実行されるネットワークドメイン許可リストでそのギャップを閉じます。90パーミッションルールとサンドボックスは異なるレイヤーをカバーします。WebFetch を拒否すると Claude の fetch ツールがブロックされますが、Bash が許可されている場合、`curl` と `wget` は依然として任意の URL に到達できます。サンドボックスは OS レベルで実行されるネットワークドメイン許可リストでそのギャップを閉じます。

84 91 

85これらの制御が防御する脅威モデルについては、[Security](/ja/security) を参照してください。92これらの制御が防御する脅威モデルについては、[Security](/ja/security) を参照してください。

86 93 

87## 使用状況の可視性をセットアップする94<h2 id="set-up-usage-visibility">

95 使用状況の可視性をセットアップする

96</h2>

88 97 

89必要なレポート内容に基づいて監視を選択してください。98必要なレポート内容に基づいて監視を選択してください。

90 99 


96 105 

97クラウドプロバイダーは AWS Cost Explorer、GCP Billing、または Azure Cost Management を通じて支出を公開します。Claude for Teams および Enterprise プランには、[claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) での使用状況ダッシュボードが含まれています。106クラウドプロバイダーは AWS Cost Explorer、GCP Billing、または Azure Cost Management を通じて支出を公開します。Claude for Teams および Enterprise プランには、[claude.ai/analytics/claude-code](https://claude.ai/analytics/claude-code) での使用状況ダッシュボードが含まれています。

98 107 

99## データ処理を確認する108<h2 id="review-data-handling">

109 データ処理を確認する

110</h2>

100 111 

101Team、Enterprise、Claude API、およびクラウドプロバイダープランでは、Anthropic はコードまたはプロンプトでモデルをトレーニングしません。API プロバイダーが保持とコンプライアンス体制を決定します。112Team、Enterprise、Claude API、およびクラウドプロバイダープランでは、Anthropic はコードまたはプロンプトでモデルをトレーニングしません。API プロバイダーが保持とコンプライアンス体制を決定します。

102 113 


108 119 

109リクエストレベルの監査ログが必要な場合、またはデータの機密性によってトラフィックをルーティングしたい場合は、開発者とプロバイダーの間に [LLM gateway](/ja/llm-gateway) を配置してください。規制要件と認定については、[Legal and compliance](/ja/legal-and-compliance) を参照してください。120リクエストレベルの監査ログが必要な場合、またはデータの機密性によってトラフィックをルーティングしたい場合は、開発者とプロバイダーの間に [LLM gateway](/ja/llm-gateway) を配置してください。規制要件と認定については、[Legal and compliance](/ja/legal-and-compliance) を参照してください。

110 121 

111## 検証とオンボード122<h2 id="verify-and-onboard">

123 検証とオンボード

124</h2>

112 125 

113マネージド設定を設定した後、開発者に Claude Code 内で `/status` を実行させてください。出力には `Enterprise managed settings` で始まる行が含まれ、その後に括弧内のソースが続きます。`(remote)`、`(plist)`、`(HKLM)`、`(HKCU)`、または `(file)` のいずれかです。[アクティブな設定を検証](/ja/settings#verify-active-settings) を参照してください。126マネージド設定を設定した後、開発者に Claude Code 内で `/status` を実行させてください。**Status** タブの `Setting sources` 行に `Enterprise managed settings` が表示され、その後に括弧内のソースが続きます。`(remote)`、`(plist)`、`(HKLM)`、`(HKCU)`、または `(file)` のいずれかです。[アクティブな設定を検証](/ja/settings#verify-active-settings) を参照してください。

114 127 

115開発者が開始するのに役立つこれらのリソースを共有してください。128開発者が開始するのに役立つこれらのリソースを共有してください。

116 129 


126 139 

127開発者が「You haven't been added to your organization yet」というメッセージを見た場合、そのシートには Claude Code アクセスが含まれておらず、管理コンソールで更新する必要があります。140開発者が「You haven't been added to your organization yet」というメッセージを見た場合、そのシートには Claude Code アクセスが含まれておらず、管理コンソールで更新する必要があります。

128 141 

129## 次のステップ142<h2 id="next-steps">

143 次のステップ

144</h2>

130 145 

131プロバイダーと配信メカニズムを選択したら、詳細な設定に進みます。146プロバイダーと配信メカニズムを選択したら、詳細な設定に進みます。

132 147 

advisor.md +198 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# advisor ツールで難しい判断をエスカレートする

6 

7> メインモデルをより強力な advisor モデルと組み合わせて、タスク中の重要な瞬間に Claude が相談できるようにします。

8 

9{/* plan-availability: feature=advisor providers=anthropic */}

10 

11<Note>

12 advisor ツールは実験的機能であり、Anthropic API を使用する Claude Code v2.1.98 以降が必要です。Amazon Bedrock、Google Vertex AI、Microsoft Foundry では利用できません。動作、価格設定、および利用可能性は変更される可能性があります。

13</Note>

14 

15advisor ツールを使用すると、Claude はタスク中の重要な瞬間(アプローチをコミットする前、繰り返し発生するエラーで行き詰まった場合、またはタスク完了を宣言する前など)に、通常はより強力な 2 番目のモデルに相談できます。advisor は、すべてのツール呼び出しと結果を含む完全な会話を受け取り、Claude が続行する前に適用するガイダンスを返します。

16 

17advisor は Anthropic インフラストラクチャ上でサーバー側で実行され、[サーバーツール](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool)として、サブスクリプションと API 課金の両方のアカウントで利用できます。どのモデルが advisor として機能するかを選択し、Claude がそれをいつ呼び出すかを決定します。

18 

19このページでは、advisor を有効にする方法、受け入れられるモデルペアリング、相談中に Claude が表示する内容、および advisor 使用量がどのように課金されるかについて説明します。

20 

21<h2 id="when-to-use-the-advisor">

22 advisor を使用する場合

23</h2>

24 

25advisor は、ほとんどのターンが定型的であるが、プラン品質が結果を決定する長い複数ステップのタスクに適しています。例としては、大規模なリファクタリング、エラーが繰り返し発生するデバッグセッション、および Claude が完了を宣言する前に独立して確認したいタスクが挙げられます。

26 

27計画する必要がほとんどない短いタスク、またはすべてのターンで最強のモデルが必要な作業では、価値が低くなります。その場合は、[メインモデルを切り替える](/ja/model-config#setting-your-model)か、[advisor が opusplan およびサブエージェントとどのように比較されるか](#compare-with-related-features)を参照して、2 番目の意見を得る他の方法を確認してください。

28 

29<h2 id="enable-the-advisor">

30 advisor を有効にする

31</h2>

32 

33advisor モデルは 3 つの方法で設定できます。

34 

35* **`/advisor` コマンド**:セッション中に advisor を設定または変更し、デフォルトとして保存します

36* **`advisorModel` 設定**:[設定ファイル](/ja/settings)で永続的なデフォルトを構成します

37* **`--advisor` フラグ**:起動時に単一セッションの advisor を設定します

38 

39これらのいずれかが advisor モデルを設定する場合、advisor はメインモデルが[それをサポートしている](#choose-an-advisor-model)セッションで有効になります。使用を停止するには、[advisor をオフにする](#turn-the-advisor-off)を参照してください。

40 

41<Note>

42 Fable 5 を advisor として使用するには、Claude Code v2.1.170 以降と、組織の [Fable 5 アクセス](/ja/model-config#work-with-fable-5)が必要です。

43</Note>

44 

45<h3 id="use-the-/advisor-command">

46 `/advisor` コマンドを使用する

47</h3>

48 

49引数なしで `/advisor` を実行して、利用可能な advisor モデルをリストするピッカーを開くか、モデルを直接渡します。

50 

51```

52/advisor opus

53```

54 

55選択は、ユーザー設定の `advisorModel` に保存され、セッション全体で保持されます。現在のメインモデルが advisor をサポートしていない場合、選択は引き続き保存され、[`/model`](/ja/model-config#setting-your-model)で[互換性のあるメインモデル](#choose-an-advisor-model)に切り替えるときにアクティブになります。

56 

57<h3 id="set-advisormodel-in-settings">

58 設定で `advisorModel` を設定する

59</h3>

60 

61セッションを開かずにデフォルトとして advisor を構成するには、設定ファイルで設定します。

62 

63```json theme={null}

64{

65 "advisorModel": "opus"

66}

67```

68 

69<h3 id="use-the-advisor-flag">

70 `--advisor` フラグを使用する

71</h3>

72 

73保存された設定を変更せずに単一セッションの advisor を設定するには、フラグを使用して起動します。

74 

75```bash theme={null}

76claude --advisor opus

77```

78 

79フラグはそのセッションの `advisorModel` 設定よりも優先されます。`/advisor` とは異なり、セッションのメインモデルが advisor をサポートしていない場合、フラグはエラーで終了します。

80 

81<h2 id="choose-an-advisor-model">

82 advisor モデルを選択する

83</h2>

84 

85advisor はメインモデル以上の機能を持つ必要があります。各メインモデルで受け入れられる advisor は次のとおりです。

86 

87| メインモデル | 受け入れられる advisor | 注記 |

88| ----------------------------------------------- | -------------------------- | ----------------------------------------------------- |

89| Haiku 4.5 | Fable、Opus、Sonnet | Haiku は advisor を呼び出すことはできますが、advisor として機能することはできません |

90| Sonnet 4.6 | Fable、Opus、Sonnet | |

91| Opus 4.6 以降 | Fable、メインモデルのバージョン以上の Opus | Opus 4.7 メインと Opus 4.6 advisor は拒否されます |

92| Fable 5 ({/* min-version: 2.1.170 */}v2.1.170+) | Fable | Opus または Sonnet advisor は拒否されます |

93 

94Fable 5 は、メインモデルとして機能するか advisor として機能するかに関わらず、Claude Code v2.1.170 以降と Fable 5 アクセスが必要です。

95 

96advisor を `opus`、`sonnet`、または `fable` として設定します。これらのエイリアスは各モデルの最新バージョンに解決されます。`claude-opus-4-8` などの完全なモデル ID を渡すこともできます。

97 

98Subagent は設定された advisor を継承し、独自のモデルに対して同じペアリングチェックを適用します。

99 

100Claude Code はリクエストを送信する前にペアリングを検証します。

101 

102* advisor がメインモデルより機能が低い場合、advisor はメインモデルのリクエストに接続されません。`/advisor` コマンド出力と通知がこれを表示します。独自のモデルがペアリングを満たす Subagent は引き続き advisor を使用できます。

103* メインモデルまたは advisor が Claude Code が認識しないモデルである場合、advisor は接続されません。

104 

105<h3 id="common-model-pairings">

106 一般的なモデルペアリング

107</h3>

108 

109受け入れられるペアリングはすべて機能します。これらの組み合わせは、異なる方法でコストと機能のバランスを取ります。

110 

111| ペアリング | 使用する場合 |

112| --------------------------- | -------------------------------------------------------------------------------------------------------------- |

113| Sonnet メイン + Opus advisor | Sonnet は定型的な作業を処理し、計画、曖昧な失敗、および完了チェックを Opus にエスカレートします |

114| Sonnet メイン + Fable advisor | 決定ポイントで Fable 5 ガイダンスを取得し、Fable 5 全体を実行しません。v2.1.170 以降と Fable 5 アクセスが必要です |

115| Haiku メイン + Opus advisor | 強力な計画を備えた最も低コストのメインモデル。Haiku のみよりもコストが高くなることが予想されますが、メインモデルを Sonnet または Opus に切り替えるよりは低くなります |

116| Opus メイン + Opus advisor | 2 番目の Opus が最初の Opus をレビューします。コストよりも独立したチェックが重要な高リスクタスクに役立ちます |

117| Fable メイン + Fable advisor | Fable 5 が利用可能な場合の最高機能ペアリング(v2.1.170+)。Fable は Opus および Sonnet より上位のティアであるため、Fable メインモデルの唯一の受け入れられた advisor です |

118| Sonnet メイン + Sonnet advisor | 定型的な見落としをキャッチするための低コストの 2 番目の意見 |

119 

120<h2 id="when-claude-consults-the-advisor">

121 Claude が advisor に相談する場合

122</h2>

123 

124Claude は advisor をいつ呼び出すかを決定します。アプローチをコミットする前、エラーが繰り返し発生する場合、およびタスク完了を宣言する前に相談する傾向がありますが、タイミングはルールベースではなくモデル駆動です。

125 

126プロンプトで相談をリクエストするのと同じ方法で、プロンプトで相談をリクエストできます。例えば、`continue する前に advisor に相談してください`。advisor 呼び出しをキャップまたは強制する設定はありません。タスク中に Claude が advisor に相談する頻度を増やしたい場合は、指示で言及してください。

127 

128<h2 id="what-you-see-during-a-session">

129 セッション中に表示される内容

130</h2>

131 

132Claude が advisor を呼び出すと、トランスクリプトに呼び出しが進行中の advisor モデル名を含む `Advising` 行が表示されます。結果が返されると、行は advisor が会話をレビューしたことを確認します。`Ctrl+O` を押して展開し、advisor の完全なガイダンスを読みます。

133 

134Claude は一般的に advisor のガイダンスに従いますが、独自の証拠が特定の主張と矛盾する場合は適応します。推奨されたステップが試行時に失敗した場合、またはファイルの内容がアドバイスと矛盾する場合、Claude はガイダンスに無条件に従うのではなく、矛盾を表示します。

135 

136advisor は常に完全な会話を受け取り、Claude がタイミングを制御します。より多くの制御または異なる構成については、[advisor がサブエージェントおよび opusplan とどのように比較されるか](#compare-with-related-features)を参照してください。

137 

138<h2 id="cost">

139 コスト

140</h2>

141 

142各 advisor 呼び出しは会話を advisor モデルに送信するため、メインモデルの使用に加えて advisor モデルのレートでトークンを消費します。API 課金では、advisor トークンは advisor モデルの入力および出力レートで課金されます。サブスクリプションプランでは、advisor 使用量はプランの使用制限にカウントされます。

143 

144Claude は各ターンではなく決定ポイントで advisor を呼び出すため、より高速なメインモデルをより強力な advisor と組み合わせることは、通常、より強力なモデルを全体で実行するよりもコストが低くなります。advisor 使用量は [`/usage`](/ja/costs#track-your-costs)で表示されるセッション合計にカウントされます。

145 

146advisor トークンが API レスポンスでどのように報告されるかについては、Claude API ドキュメントの [使用量と課金](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool#usage-and-billing)を参照してください。

147 

148<h2 id="impact-on-prompt-caching">

149 プロンプトキャッシュへの影響

150</h2>

151 

152セッション中に advisor を有効または無効にしても、メインモデルの[プロンプトキャッシュ](/ja/prompt-caching)は無効になりません。[モデルまたは努力レベルを変更する](/ja/prompt-caching#actions-that-invalidate-the-cache)とは異なり、`/advisor` を切り替えるとキャッシュされたプレフィックスはそのまま保持され、advisor が返したガイダンスは後のターンでトランスクリプトの一部としてキャッシュされます。

153 

154advisor モデル自体の会話の読み取りはキャッシュされません。各 advisor 呼び出しは完全なトランスクリプトを新たに処理し、呼び出し間での再利用はありません。

155 

156<h2 id="requirements">

157 要件

158</h2>

159 

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

161 

162* **Claude Code v2.1.98 以降**:`claude update` を実行してアップグレードします。

163* **Anthropic API のみ**:advisor はサーバー実行ツールです。Amazon Bedrock、Google Vertex AI、または Microsoft Foundry では利用できません。[LLM ゲートウェイ](/ja/llm-gateway)を通じて `ANTHROPIC_BASE_URL` で構成されている場合、利用可能性はゲートウェイがリクエストを Anthropic API に完全に転送するかどうかに依存します。

164* **サポートされているメインモデル**:Opus 4.6 以降、Sonnet 4.6、または Haiku 4.5。{/* min-version: 2.1.170 */}Fable 5 も Claude Code v2.1.170 以降で適格です。

165 

166<h2 id="turn-the-advisor-off">

167 advisor をオフにする

168</h2>

169 

170advisor の使用を停止し、保存された `advisorModel` をクリアするには、`/advisor off` を実行するか、`/advisor` ピッカーで **No advisor** を選択します。

171 

172```

173/advisor off

174```

175 

176advisor ツール全体(`/advisor` コマンドと `--advisor` フラグを含む)を無効にするには、`CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1` を設定します。[環境変数](/ja/env-vars)を参照してください。

177 

178<h2 id="compare-with-related-features">

179 関連機能との比較

180</h2>

181 

182advisor は、モデルの強みを組み合わせるいくつかの方法の 1 つです。2 番目のモデルをいつ関与させるかに基づいて選択します。

183 

184| アプローチ | より強力なモデルが実行される場合 | 開始方法 |

185| ----------------------------------------------------- | ------------------------------- | ----------------------------- |

186| Advisor ツール | タスク中の決定ポイント | Claude がガイダンスが必要な場合に呼び出します |

187| [`opusplan`](/ja/model-config#opusplan-model-setting) | プランモード中、その後実行用に Sonnet に切り替わります | プランモードに入ります |

188| [サブエージェント](/ja/sub-agents#choose-a-model)(`model` 設定) | 委任されたサブタスク全体 | Claude が委任するか、サブエージェントを呼び出します |

189| [`/model`](/ja/model-config#setting-your-model) | 後続のすべてのターン | モデルを切り替えます |

190 

191<h2 id="see-also">

192 関連項目

193</h2>

194 

195* [モデル構成](/ja/model-config):モデルを切り替え、努力レベルを設定し、`opusplan` を使用します

196* [コストを効果的に管理する](/ja/costs):モデル全体のトークン使用量を追跡します

197* [Claude API の Advisor ツール](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool):基盤となるサーバーツールを理解するか、Messages API から直接使用します

198* [advisor 戦略](https://claude.com/blog/the-advisor-strategy):高速メインモデルをより強力な advisor と組み合わせる理由

Details

4 4 

5# エージェントループの仕組み5# エージェントループの仕組み

6 6 

7> メッセージライフサイクル、ツール実行、コンテキストウィンドウ、および SDK エージェントを支える アーキテクチャを理解します7> メッセージライフサイクル、ツール実行、コンテキストウィンドウ、および SDK エージェントを支えるアーキテクチャを理解します

8 8 

9Agent SDK を使用すると、Claude Code の自律型エージェントループを独自のアプリケーションに組み込むことができます。SDK はスタンドアロンパッケージで、ツール、権限、コスト制限、および出力をプログラムで制御できます。これを使用するために Claude Code CLI をインストールする必要はありません。9Agent SDK を使用すると、Claude Code の自律型エージェントループを独自のアプリケーションに組み込むことができます。SDK はスタンドアロンパッケージで、ツール、権限、コスト制限、および出力をプログラムで制御できます。これを使用するために Claude Code CLI をインストールする必要はありません。

10 10 


16 16 

17すべてのエージェントセッションは同じサイクルに従います。17すべてのエージェントセッションは同じサイクルに従います。

18 18 

19<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agent-loop-diagram.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=1c6e8f28d80dba14a7287419656f1237" alt="エージェントループプロンプトが入力され、Claude が評価しツール呼び出しまたは最終回答に分岐" width="720" height="212" data-path="images/agent-loop-diagram.svg" />19<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agent-loop-diagram.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=1c6e8f28d80dba14a7287419656f1237" alt="エージェントループの図プロンプトが agentic ループに入り、Claude が評価してツール呼び出しをリクエストするか最終回答を返すか、またはツール呼び出しの結果が別の評価にフィードバックされます" width="720" height="212" data-path="images/agent-loop-diagram.svg" />

20 20 

211. **プロンプトを受け取る。** Claude はプロンプト、システムプロンプト、ツール定義、および会話履歴とともにプロンプトを受け取ります。SDK はセッションメタデータを含むサブタイプ `"init"` の[`SystemMessage`](#message-types)を生成します。211. **プロンプトを受け取る。** Claude はプロンプト、システムプロンプト、ツール定義、および会話履歴とともにプロンプトを受け取ります。SDK はセッションメタデータを含むサブタイプ `"init"` の[`SystemMessage`](#message-types)を生成します。

222. **評価して応答する。** Claude は現在の状態を評価し、どのように進めるかを決定します。テキストで応答したり、1 つ以上のツール呼び出しをリクエストしたり、その両方を行ったりできます。SDK はテキストとツール呼び出しリクエストを含む[`AssistantMessage`](#message-types)を生成します。222. **評価して応答する。** Claude は現在の状態を評価し、どのように進めるかを決定します。テキストで応答したり、1 つ以上のツール呼び出しをリクエストしたり、その両方を行ったりできます。SDK はテキストとツール呼び出しリクエストを含む[`AssistantMessage`](#message-types)を生成します。


53 53 

54ループが実行されると、SDK はメッセージのストリームを生成します。各メッセージは、ループのどのステージから来たかを示すタイプを持ちます。5 つのコアタイプは次のとおりです。54ループが実行されると、SDK はメッセージのストリームを生成します。各メッセージは、ループのどのステージから来たかを示すタイプを持ちます。5 つのコアタイプは次のとおりです。

55 55 

56* **`SystemMessage`:** セッションライフサイクルイベント。`subtype` フィールドはそれらを区別します。`"init"` は最初のメッセージ(セッションメタデータ)で、`"compact_boundary"` は[圧縮](#automatic-compaction)後に発火します。TypeScript では、圧縮境界は `SDKSystemMessage` のサブタイプではなく、独自の[`SDKCompactBoundaryMessage`](/ja/agent-sdk/typescript#sdkcompactboundarymessage)タイプです。56* **`SystemMessage`:** セッションライフサイクルイベント。`subtype` フィールドはそれらを区別します。

57 

58 * `"init"`:セッションメタデータを含む最初のメッセージ

59 * `"compact_boundary"`:[圧縮](#automatic-compaction)後に発火します

60 * `"informational"`:ループからのプレーンテキストステータスバナー

61 * `"worker_shutting_down"`:ホストが終了しているか Remote Control が切断されたため、現在のターン後にループが終了します

62 

63 TypeScript では、`"init"` 以外の各サブタイプは `SDKSystemMessage` のサブタイプではなく、[`SDKMessage` ユニオン](/ja/agent-sdk/typescript#sdkmessage)内の独自のタイプです。

57* **`AssistantMessage`:** 最終テキストのみの応答を含む、各 Claude 応答の後に生成されます。そのターンからのテキストコンテンツブロックとツール呼び出しブロックを含みます。64* **`AssistantMessage`:** 最終テキストのみの応答を含む、各 Claude 応答の後に生成されます。そのターンからのテキストコンテンツブロックとツール呼び出しブロックを含みます。

58* **`UserMessage`:** 各ツール実行後、Claude に送り返されるツール結果コンテンツとともに生成されます。ループ中盤でストリーミングするユーザー入力に対しても生成されます。65* **`UserMessage`:** 各ツール実行後、Claude に送り返されるツール結果コンテンツとともに生成されます。ループ中盤でストリーミングするユーザー入力に対しても生成されます。

59* **`StreamEvent`:** 部分メッセージが有効な場合のみ生成されます。生のAPI ストリーミングイベント(テキストデルタ、ツール入力チャンク)を含みます。[ストリーム応答](/ja/agent-sdk/streaming-output)を参照してください。66* **`StreamEvent`:** 部分メッセージが有効な場合のみ生成されます。生の API ストリーミングイベント(テキストデルタ、ツール入力チャンク)を含みます。[ストリーム応答](/ja/agent-sdk/streaming-output)を参照してください。

60* **`ResultMessage`:** エージェントループの終了をマークします。最終テキスト結果、トークン使用量、コスト、およびセッション ID を含みます。`subtype` フィールドをチェックして、タスクが成功したか制限に達したかを判断します。`prompt_suggestion` などの少数の末尾システムイベントはその後に到着する可能性があるため、結果で中断するのではなく、ストリームを完了まで反復処理します。[結果を処理する](#handle-the-result)を参照してください。67* **`ResultMessage`:** エージェントループの終了をマークします。最終テキスト結果、トークン使用量、コスト、およびセッション ID を含みます。`subtype` フィールドをチェックして、タスクが成功したか制限に達したかを判断します。`prompt_suggestion` などの少数の末尾システムイベントはその後に到着する可能性があるため、結果で中断するのではなく、ストリームを完了まで反復処理します。[結果を処理する](#handle-the-result)を参照してください。

61 68 

62これら 5 つのタイプは、両方の SDK でエージェントループライフサイクル全体をカバーしています。TypeScript SDK は、追加の観測可能性イベント(フックイベント、ツール進捗、レート制限、タスク通知)も生成し、追加の詳細を提供しますが、ループを駆動するために必須ではありません。完全なリストについては、[Python メッセージタイプリファレンス](/ja/agent-sdk/python#message-types)と[TypeScript メッセージタイプリファレンス](/ja/agent-sdk/typescript#message-types)を参照してください。69これら 5 つのタイプは、両方の SDK でエージェントループライフサイクル全体をカバーしています。TypeScript SDK は、追加の観測可能性イベント(フックイベント、ツール進捗、レート制限、タスク通知)も生成し、追加の詳細を提供しますが、ループを駆動するために必須ではありません。完全なリストについては、[Python メッセージタイプリファレンス](/ja/agent-sdk/python#message-types)と[TypeScript メッセージタイプリファレンス](/ja/agent-sdk/typescript#message-types)を参照してください。


183`effort` オプションは Claude が適用する推論の量を制御します。低い努力レベルはターンあたりのトークンが少なく、コストが削減されます。すべてのモデルが努力パラメータをサポートしているわけではありません。どのモデルがサポートしているかについては、[努力](https://platform.claude.com/docs/ja/build-with-claude/effort)を参照してください。190`effort` オプションは Claude が適用する推論の量を制御します。低い努力レベルはターンあたりのトークンが少なく、コストが削減されます。すべてのモデルが努力パラメータをサポートしているわけではありません。どのモデルがサポートしているかについては、[努力](https://platform.claude.com/docs/ja/build-with-claude/effort)を参照してください。

184 191 

185| レベル | 動作 | 適している用途 |192| レベル | 動作 | 適している用途 |

186| :--------- | :---------- | :-------------------------------------- |193| :--------- | :---------- | :-------------------------------------------------- |

187| `"low"` | 最小限の推論、高速応答 | ファイル検索、ディレクトリのリスト |194| `"low"` | 最小限の推論、高速応答 | ファイル検索、ディレクトリのリスト |

188| `"medium"` | バランスの取れた推論 | ルーチン編集、標準タスク |195| `"medium"` | バランスの取れた推論 | ルーチン編集、標準タスク |

189| `"high"` | 徹底的な分析 | リファクタリング、デバッグ |196| `"high"` | 徹底的な分析 | リファクタリング、デバッグ |

190| `"xhigh"` | 拡張推論深度 | コーディングと agentic coding タスク。Opus 4.7 で推奨 |197| `"xhigh"` | 拡張推論深度 | コーディングと agentic coding タスク。Fable 5 と Opus 4.7 以上で推奨 |

191| `"max"` | 最大推論深度 | 深い分析が必要な複数ステップの問題 |198| `"max"` | 最大推論深度 | 深い分析が必要な複数ステップの問題 |

192 199 

193`effort` を設定しない場合、Python SDK はパラメータを設定したままにして、モデルのデフォルト動作に委譲します。TypeScript SDK はデフォルトで `"high"` です。200`effort` を設定しない場合、両方の SDK はパラメータを設定したままにして、モデルのデフォルト動作に委譲します。

194 201 

195<Note>202<Note>

196 `effort` は各応答内の推論深度のレイテンシとトークンコストをトレードオフします。[拡張思考](https://platform.claude.com/docs/ja/build-with-claude/extended-thinking)は、出力に表示される思考の連鎖ブロックを生成する別の機能です。これらは独立しています。`effort: "low"` を拡張思考有効で設定することも、`effort: "max"` を有効にしないで設定することもできます。203 `effort` は各応答内の推論深度のレイテンシとトークンコストをトレードオフします。[拡張思考](https://platform.claude.com/docs/ja/build-with-claude/extended-thinking)は、出力に表示される思考の連鎖ブロックを生成する別の機能です。これらは独立しています。`effort: "low"` を拡張思考有効で設定することも、`effort: "max"` を有効にしないで設定することもできます。


205権限モードオプション(Python では `permission_mode`、TypeScript では `permissionMode`)は、エージェントがツールを使用する前に承認を求めるかどうかを制御します。212権限モードオプション(Python では `permission_mode`、TypeScript では `permissionMode`)は、エージェントがツールを使用する前に承認を求めるかどうかを制御します。

206 213 

207| モード | 動作 |214| モード | 動作 |

208| :---------------------- | :------------------------------------------------------------------------------------------------------------------- |215| :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

209| `"default"` | 許可ルールでカバーされていないツールは承認コールバックをトリガーします。コールバックがない場合は拒否 |216| `"default"` | 許可ルールでカバーされていないツールは承認コールバックをトリガーします。コールバックがない場合は拒否 |

210| `"acceptEdits"` | ファイル編集と一般的なファイルシステムコマンド(`mkdir`、`touch`、`mv`、`cp` など)を自動承認します。他の Bash コマンドはデフォルトルールに従います |217| `"acceptEdits"` | ファイル編集と一般的なファイルシステムコマンド(`mkdir`、`touch`、`mv`、`cp` など)を自動承認します。他の Bash コマンドはデフォルトルールに従います |

211| `"plan"` | 読み取り専用ツールを実行します。Claude はソースファイルを編集せずに探索して計画を作成します |218| `"plan"` | Claude はソースファイルを編集せずに探索して計画を作成します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトされます |

212| `"dontAsk"` | プロンプトしません。[権限ルール](/ja/settings#permission-settings)によって事前承認されたツールが実行され、その他はすべて拒否されます |219| `"dontAsk"` | プロンプトしません。[権限ルール](/ja/settings#permission-settings)によって事前承認されたツールが実行され、その他はすべて拒否されます |

213| `"auto"`(TypeScript のみ) | モデル分類器を使用して各ツール呼び出しを承認または拒否します。利用可能性と動作については、[自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください |220| `"auto"`(TypeScript のみ) | モデル分類器を使用して各ツール呼び出しを承認または拒否します。利用可能性と動作については、[自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください |

214| `"bypassPermissions"` | 尋ねずにすべての許可されたツールを実行します。Unix でルートとして実行する場合は使用できません。エージェントのアクションが気にするシステムに影響を与えられない隔離環境でのみ使用します |221| `"bypassPermissions"` | 明示的な[`ask` ルール](/ja/settings#permission-settings)に一致しない限り、尋ねずにすべての許可されたツールを実行します。権限がどのように評価されるかについては、[権限の評価方法](/ja/agent-sdk/permissions#how-permissions-are-evaluated)を参照してください。Unix でルートとして実行する場合は使用できません。エージェントのアクションが気にするシステムに影響を与えられない隔離環境でのみ使用します |

215 222 

216インタラクティブアプリケーションの場合は、ツール承認コールバックで `"default"` を使用して承認プロンプトを表示します。開発マシン上の自律型エージェントの場合は、`"acceptEdits"` を使用してファイル編集と一般的なファイルシステムコマンド(`mkdir`、`touch`、`mv`、`cp` など)を自動承認しながら、他の `Bash` コマンドを許可ルールの背後にゲートします。CI、コンテナ、またはその他の隔離環境に対して `"bypassPermissions"` を予約します。詳細については、[権限](/ja/agent-sdk/permissions)を参照してください。223インタラクティブアプリケーションの場合は、ツール承認コールバックで `"default"` を使用して承認プロンプトを表示します。開発マシン上の自律型エージェントの場合は、`"acceptEdits"` を使用してファイル編集と一般的なファイルシステムコマンド(`mkdir`、`touch`、`mv`、`cp` など)を自動承認しながら、他の `Bash` コマンドを許可ルールの背後にゲートします。CI、コンテナ、またはその他の隔離環境に対して `"bypassPermissions"` を予約します。詳細については、[権限](/ja/agent-sdk/permissions)を参照してください。

217 224 


305ループが終了すると、`ResultMessage` は何が起こったかを示し、出力を提供します。`subtype` フィールド(両方の SDK で利用可能)は、終了状態をチェックする主な方法です。312ループが終了すると、`ResultMessage` は何が起こったかを示し、出力を提供します。`subtype` フィールド(両方の SDK で利用可能)は、終了状態をチェックする主な方法です。

306 313 

307| 結果サブタイプ | 何が起こったか | `result` フィールドは利用可能か? |314| 結果サブタイプ | 何が起こったか | `result` フィールドは利用可能か? |

308| :------------------------------------ | :------------------------------------------ | :-------------------: |315| :------------------------------------ | :---------------------------------------------------------------------------------- | :-------------------: |

309| `success` | Claude は通常、タスクを完了しました | はい |316| `success` | Claude は通常、タスクを完了しました | はい |

310| `error_max_turns` | 完了前に `maxTurns` 制限に達しました | いいえ |317| `error_max_turns` | 完了前に `maxTurns` 制限に達しました | いいえ |

311| `error_max_budget_usd` | 完了前に `maxBudgetUsd` 制限に達しました | いいえ |318| `error_max_budget_usd` | 完了前に `maxBudgetUsd` 制限に達しました | いいえ |

312| `error_during_execution` | エラーがループを中断しました(たとえば、API 障害またはキャンセルされたリクエスト) | いいえ |319| `error_during_execution` | エラーがループを中断しました(たとえば、API 障害またはキャンセルされたリクエスト) | いいえ |

313| `error_max_structured_output_retries` | 構造化出力検証が設定された再試行制限後に失敗しました | いいえ |320| `error_max_structured_output_retries` | 設定された再試行制限内で有効な構造化出力が生成されませんでした。すべての試行が検証に失敗したか、モデルフォールバックが成功した再試行なしで完了した出力を取り消しました | いいえ |

314 321 

315`result` フィールド(最終テキスト出力)は `success` バリアントにのみ存在するため、読み取る前に常にサブタイプをチェックしてください。すべての結果サブタイプは `total_cost_usd`、`usage`、`num_turns`、および `session_id` を持つため、コストを追跡し、エラー後でも再開できます。Python では、`total_cost_usd` と `usage` はオプションとして型付けされ、一部のエラーパスで `None` である可能性があるため、フォーマットする前にガードしてください。[コストと使用量の追跡](/ja/agent-sdk/cost-tracking)を参照して、`usage` フィールドの解釈の詳細を確認してください。322`result` フィールド(最終テキスト出力)は `success` バリアントにのみ存在するため、読み取る前に常にサブタイプをチェックしてください。すべての結果サブタイプは `total_cost_usd`、`usage`、`num_turns`、および `session_id` を持つため、コストを追跡し、エラー後でも再開できます。Python では、`total_cost_usd` と `usage` はオプションとして型付けされ、一部のエラーパスで `None` である可能性があるため、フォーマットする前にガードしてください。[コストと使用量の追跡](/ja/agent-sdk/cost-tracking)を参照して、`usage` フィールドの解釈の詳細を確認してください。

316 323 

Details

158 158 

159各 `query()` 呼び出しは独自の `total_cost_usd` を返します。SDK はセッションレベルの合計を提供しないため、アプリケーションが複数の `query()` 呼び出しを行う場合(たとえば、マルチターンセッションまたは異なるユーザー間)、合計を自分で累積してください。159各 `query()` 呼び出しは独自の `total_cost_usd` を返します。SDK はセッションレベルの合計を提供しないため、アプリケーションが複数の `query()` 呼び出しを行う場合(たとえば、マルチターンセッションまたは異なるユーザー間)、合計を自分で累積してください。

160 160 

161次の例は 2 つの `query()` 呼び出しを順序立てて実行し、各呼び出しの `total_cost_usd` を実行中の合計に追加し、呼び出しごとの合計コストと合計コストの両方を出力します161次の例は 2 つの `query()` 呼び出しを順序立てて実行し、各呼び出しの `total_cost_usd` を実行中の合計に追加し、呼び出しごとのコストと合計コストの両方を出力します

162 162 

163<CodeGroup>163<CodeGroup>

164 ```typescript TypeScript theme={null}164 ```typescript TypeScript theme={null}


257 257 

258<CodeGroup>258<CodeGroup>

259 ```python Python theme={null}259 ```python Python theme={null}

260 from claude_agent_sdk import ClaudeAgentOptions, query

261 import asyncio

262 

263 

264 async def main():

260 options = ClaudeAgentOptions(265 options = ClaudeAgentOptions(

261 env={266 env={

262 "CLAUDE_CODE_USE_BEDROCK": "1",267 "CLAUDE_CODE_USE_BEDROCK": "1",

263 "ENABLE_PROMPT_CACHING_1H": "1",268 "ENABLE_PROMPT_CACHING_1H": "1",

264 },269 },

265 )270 )

271 

272 async for message in query(prompt="Summarize this project", options=options):

273 print(message)

274 

275 

276 asyncio.run(main())

266 ```277 ```

267 278 

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

280 import { query } from "@anthropic-ai/claude-agent-sdk";

281 

269 const options = {282 const options = {

270 env: {283 env: {

271 ...process.env,284 ...process.env,


273 ENABLE_PROMPT_CACHING_1H: "1",286 ENABLE_PROMPT_CACHING_1H: "1",

274 },287 },

275 };288 };

289 

290 for await (const message of query({ prompt: "Summarize this project", options })) {

291 console.log(message);

292 }

276 ```293 ```

277</CodeGroup>294</CodeGroup>

278 295 

Details

36* **説明:** ツールが何をするかを説明します。Claude はこれを読んで、ツールをいつ呼び出すかを決定します。36* **説明:** ツールが何をするかを説明します。Claude はこれを読んで、ツールをいつ呼び出すかを決定します。

37* **入力スキーマ:** Claude が提供する必要がある引数。TypeScript では常に [Zod スキーマ](https://zod.dev/)であり、ハンドラーの `args` は自動的に型付けされます。Python では `{"latitude": float}` のような名前から型へのマッピングであり、SDK が JSON Schema に変換します。Python デコレーターは、列挙型、範囲、オプションフィールド、またはネストされたオブジェクトが必要な場合、完全な [JSON Schema](https://json-schema.org/understanding-json-schema/about) 辞書も受け入れます。37* **入力スキーマ:** Claude が提供する必要がある引数。TypeScript では常に [Zod スキーマ](https://zod.dev/)であり、ハンドラーの `args` は自動的に型付けされます。Python では `{"latitude": float}` のような名前から型へのマッピングであり、SDK が JSON Schema に変換します。Python デコレーターは、列挙型、範囲、オプションフィールド、またはネストされたオブジェクトが必要な場合、完全な [JSON Schema](https://json-schema.org/understanding-json-schema/about) 辞書も受け入れます。

38* **ハンドラー:** Claude がツールを呼び出すときに実行される非同期関数。検証された引数を受け取り、以下を含むオブジェクトを返す必要があります。38* **ハンドラー:** Claude がツールを呼び出すときに実行される非同期関数。検証された引数を受け取り、以下を含むオブジェクトを返す必要があります。

39 * `content`(必須):結果ブロックの配列。各ブロックは `"text"`、`"image"`、または `"resource"` の `type` を持ちます。非テキストブロックについては、[画像とリソースを返す](#return-images-and-resources)を参照してください。39 * `content`(必須):結果ブロックの配列。各ブロックは `"text"`、`"image"`、`"audio"`、`"resource"`、または `"resource_link"` の `type` を持ちます。非テキストブロックについては、[画像とリソースを返す](#return-images-and-resources)を参照してください。

40 * `structuredContent`(オプション):結果をマシン可読データとして保持する JSON オブジェクト。`content` と共に返されます。[構造化データを返す](#return-structured-data)を参照してください。40 * `structuredContent`(オプション):結果をマシン可読データとして保持する JSON オブジェクト。`content` と共に返されます。[構造化データを返す](#return-structured-data)を参照してください。

41 * `isError`(オプション):ツール障害を通知するために `true` に設定し、Claude が対応できるようにします。[エラーを処理する](#handle-errors)を参照してください。41 * `isError`(オプション):ツール障害を通知するために `true` に設定し、Claude が対応できるようにします。[エラーを処理する](#handle-errors)を参照してください。

42 42 


461 画像とリソースを返す461 画像とリソースを返す

462</h2>462</h2>

463 463 

464ツール結果の `content` 配列は `text`、`image`、および `resource` ブロックを受け入れます。同じ応答でそれらを混ぜることができます。464ツール結果の `content` 配列は `text`、`image`、`audio`、`resource`、および `resource_link` ブロックを受け入れます。同じ応答でそれらを混ぜることができます。オーディオブロックはディスクに保存され、Claude は保存されたファイルパスを含むテキストブロックを受け取ります。リソースリンクブロックはリンクの名前、URI、および説明を含むテキストブロックに変換されます。

465 465 

466<h3 id="images">466<h3 id="images">

467 画像467 画像

Details

719</h2>719</h2>

720 720 

721<h3 id="checkpointing-options-not-recognized">721<h3 id="checkpointing-options-not-recognized">

722 checkpointing オプションが認識されない722 Checkpointing オプションが認識されない

723</h3>723</h3>

724 724 

725`enableFileCheckpointing` または `rewindFiles()` が利用できない場合、古い SDK バージョンを使用している可能性があります。725`enableFileCheckpointing` または `rewindFiles()` が利用できない場合、古い SDK バージョンを使用している可能性があります。


729* **Python**:`pip install --upgrade claude-agent-sdk`729* **Python**:`pip install --upgrade claude-agent-sdk`

730* **TypeScript**:`npm install @anthropic-ai/claude-agent-sdk@latest`730* **TypeScript**:`npm install @anthropic-ai/claude-agent-sdk@latest`

731 731 

732<h3 id="user-messages-don-t-have-uuids">732<h3 id="user-messages-dont-have-uuids">

733 ユーザーメッセージに UUID がない733 ユーザーメッセージに UUID がない

734</h3>734</h3>

735 735 

agent-sdk/mcp.md +79 −27

Details

14 このページは Agent SDK の MCP 設定について説明しています。Claude Code CLI に MCP サーバーを追加してすべてのプロジェクトで読み込むには、[MCP インストールスコープ](/ja/mcp#mcp-installation-scopes)を参照してください。14 このページは Agent SDK の MCP 設定について説明しています。Claude Code CLI に MCP サーバーを追加してすべてのプロジェクトで読み込むには、[MCP インストールスコープ](/ja/mcp#mcp-installation-scopes)を参照してください。

15</Note>15</Note>

16 16 

17## クイックスタート17<h2 id="quickstart">

18 クイックスタート

19</h2>

18 20 

19この例は、[HTTP トランスポート](#httpsse-servers)を使用して [Claude Code ドキュメンテーション](https://code.claude.com/docs)MCP サーバーに接続し、[`allowedTools`](#allow-mcp-tools)とワイルドカードを使用してサーバーからすべてのツールを許可します。21この例は、[HTTP トランスポート](#http%2Fsse-servers)を使用して [Claude Code ドキュメンテーション](https://code.claude.com/docs)MCP サーバーに接続し、[`allowedTools`](#allow-mcp-tools)とワイルドカードを使用してサーバーからすべてのツールを許可します。

20 22 

21<CodeGroup>23<CodeGroup>

22 ```typescript TypeScript theme={null}24 ```typescript TypeScript theme={null}


70 72 

71エージェントはドキュメンテーションサーバーに接続し、hooks に関する情報を検索して、結果を返します。73エージェントはドキュメンテーションサーバーに接続し、hooks に関する情報を検索して、結果を返します。

72 74 

73## MCP サーバーを追加する75<h2 id="add-an-mcp-server">

76 MCP サーバーを追加する

77</h2>

74 78 

75`query()` を呼び出すときにコード内で MCP サーバーを設定するか、[`settingSources`](#from-a-config-file)経由で読み込まれる `.mcp.json` ファイルで設定できます。79`query()` を呼び出すときにコード内で MCP サーバーを設定するか、[`settingSources`](#from-a-config-file)経由で読み込まれる `.mcp.json` ファイルで設定できます。

76 80 

77### コード内で81<h3 id="in-code">

82 コード内で

83</h3>

78 84 

79`mcpServers` オプションで MCP サーバーを直接渡します:85`mcpServers` オプションで MCP サーバーを直接渡します:

80 86 


129 ```135 ```

130</CodeGroup>136</CodeGroup>

131 137 

132### 設定ファイルから138<h3 id="from-a-config-file">

139 設定ファイルから

140</h3>

133 141 

134プロジェクトルートに `.mcp.json` ファイルを作成します。`project` 設定ソースが有効な場合、ファイルが取得されます。これはデフォルトの `query()` オプションの場合です。`settingSources` を明示的に設定する場合は、このファイルを読み込むために `"project"` を含めます:142プロジェクトルートに `.mcp.json` ファイルを作成します。`project` 設定ソースが有効な場合、ファイルが取得されます。これはデフォルトの `query()` オプションの場合です。`settingSources` を明示的に設定する場合は、このファイルを読み込むために `"project"` を含めます:

135 143 


144}152}

145```153```

146 154 

147## MCP ツールを許可する155<h2 id="allow-mcp-tools">

156 MCP ツールを許可する

157</h2>

148 158 

149MCP ツールは Claude が使用する前に明示的な許可が必要です。許可がない場合、Claude はツールが利用可能であることを認識しますが、呼び出すことはできません。159MCP ツールは Claude が使用する前に明示的な許可が必要です。許可がない場合、Claude はツールが利用可能であることを認識しますが、呼び出すことはできません。

150 160 

151### ツール命名規則161<h3 id="tool-naming-convention">

162 ツール命名規則

163</h3>

152 164 

153MCP ツールは `mcp__<server-name>__<tool-name>` という命名パターンに従います。たとえば、`"github"` という名前の GitHub サーバーに `list_issues` ツールがある場合、`mcp__github__list_issues` になります。165MCP ツールは `mcp__<server-name>__<tool-name>` という命名パターンに従います。たとえば、`"github"` という名前の GitHub サーバーに `list_issues` ツールがある場合、`mcp__github__list_issues` になります。

154 166 

155### allowedTools でアクセスを許可する167<h3 id="auto-approve-with-allowedtools">

168 allowedTools でアクセスを許可する

169</h3>

156 170 

157`allowedTools` を使用して、Claude が使用できる MCP ツールを指定します:171`allowedTools` を使用して、Claude が使用できる MCP ツールを指定します:

158 172 


177 **MCP アクセスには `allowedTools` をパーミッションモードより優先してください。** `permissionMode: "acceptEdits"` は MCP ツールを自動承認しません(ファイル編集とファイルシステム Bash コマンドのみ)。`permissionMode: "bypassPermissions"` は MCP ツールを自動承認しますが、他のすべてのセーフティプロンプトも無効にするため、必要以上に広範です。`allowedTools` のワイルドカードは、必要な MCP サーバーのみを許可し、それ以上は許可しません。完全な比較については、[パーミッションモード](/ja/agent-sdk/permissions#permission-modes)を参照してください。191 **MCP アクセスには `allowedTools` をパーミッションモードより優先してください。** `permissionMode: "acceptEdits"` は MCP ツールを自動承認しません(ファイル編集とファイルシステム Bash コマンドのみ)。`permissionMode: "bypassPermissions"` は MCP ツールを自動承認しますが、他のすべてのセーフティプロンプトも無効にするため、必要以上に広範です。`allowedTools` のワイルドカードは、必要な MCP サーバーのみを許可し、それ以上は許可しません。完全な比較については、[パーミッションモード](/ja/agent-sdk/permissions#permission-modes)を参照してください。

178</Note>192</Note>

179 193 

180### 利用可能なツールを検出する194<h3 id="discover-available-tools">

195 利用可能なツールを検出する

196</h3>

181 197 

182MCP サーバーが提供するツールを確認するには、サーバーのドキュメンテーションを確認するか、サーバーに接続して `system` init メッセージを検査します:198MCP サーバーが提供するツールを確認するには、サーバーのドキュメンテーションを確認するか、サーバーに接続して `system` init メッセージを検査します:

183 199 


189}205}

190```206```

191 207 

192## トランスポートタイプ208<h2 id="transport-types">

209 トランスポートタイプ

210</h2>

193 211 

194MCP サーバーはさまざまなトランスポートプロトコルを使用してエージェントと通信します。サーバーのドキュメンテーションを確認して、どのトランスポートをサポートしているかを確認してください:212MCP サーバーはさまざまなトランスポートプロトコルを使用してエージェントと通信します。サーバーのドキュメンテーションを確認して、どのトランスポートをサポートしているかを確認してください:

195 213 


197* ドキュメンテーションに**URL** が記載されている場合は、HTTP または SSE を使用します215* ドキュメンテーションに**URL** が記載されている場合は、HTTP または SSE を使用します

198* コード内で独自のツールを構築している場合は、SDK MCP サーバーを使用します216* コード内で独自のツールを構築している場合は、SDK MCP サーバーを使用します

199 217 

200### stdio サーバー218<h3 id="stdio-servers">

219 stdio サーバー

220</h3>

201 221 

202stdin/stdout 経由で通信するローカルプロセス。同じマシンで実行する MCP サーバーに使用します:222stdin/stdout 経由で通信するローカルプロセス。同じマシンで実行する MCP サーバーに使用します:

203 223 


253 </Tab>273 </Tab>

254</Tabs>274</Tabs>

255 275 

256### HTTP/SSE サーバー276<h3 id="http/sse-servers">

277 HTTP/SSE サーバー

278</h3>

257 279 

258クラウドホストされた MCP サーバーとリモート API に HTTP または SSE を使用します:280クラウドホストされた MCP サーバーとリモート API に HTTP または SSE を使用します:

259 281 


311 333 

312ストリーミング可能な HTTP トランスポートの場合は、代わりに `"type": "http"` を使用します。`.mcp.json` およびその他の JSON 設定ファイルでは、`"streamable-http"` は `"http"` のエイリアスとして受け入れられます。プログラマティック `mcpServers` オプションは `"http"` のみを受け入れます。334ストリーミング可能な HTTP トランスポートの場合は、代わりに `"type": "http"` を使用します。`.mcp.json` およびその他の JSON 設定ファイルでは、`"streamable-http"` は `"http"` のエイリアスとして受け入れられます。プログラマティック `mcpServers` オプションは `"http"` のみを受け入れます。

313 335 

314### SDK MCP サーバー336<h3 id="sdk-mcp-servers">

337 SDK MCP サーバー

338</h3>

315 339 

316別のサーバープロセスを実行する代わりに、アプリケーションコード内でカスタムツールを直接定義します。実装の詳細については、[カスタムツールガイド](/ja/agent-sdk/custom-tools)を参照してください。340別のサーバープロセスを実行する代わりに、アプリケーションコード内でカスタムツールを直接定義します。実装の詳細については、[カスタムツールガイド](/ja/agent-sdk/custom-tools)を参照してください。

317 341 

318## MCP ツール検索342<h2 id="mcp-tool-search">

343 MCP ツール検索

344</h2>

319 345 

320多くの MCP ツールを設定している場合、ツール定義はコンテキストウィンドウの大部分を消費する可能性があります。ツール検索は、コンテキストからツール定義を保留し、各ターンで Claude が必要とするツールのみを読み込むことでこれを解決します。346多くの MCP ツールを設定している場合、ツール定義はコンテキストウィンドウの大部分を消費する可能性があります。ツール検索は、コンテキストからツール定義を保留し、各ターンで Claude が必要とするツールのみを読み込むことでこれを解決します。

321 347 


323 349 

324カスタム SDK ツールでのベストプラクティスとツール検索の使用を含む詳細については、[ツール検索ガイド](/ja/agent-sdk/tool-search)を参照してください。350カスタム SDK ツールでのベストプラクティスとツール検索の使用を含む詳細については、[ツール検索ガイド](/ja/agent-sdk/tool-search)を参照してください。

325 351 

326## 認証352<h2 id="authentication">

353 認証

354</h2>

327 355 

328ほとんどの MCP サーバーは外部サービスにアクセスするために認証が必要です。サーバー設定の環境変数を通じて認証情報を渡します。356ほとんどの MCP サーバーは外部サービスにアクセスするために認証が必要です。サーバー設定の環境変数を通じて認証情報を渡します。

329 357 

330### 環境変数を通じて認証情報を渡す358<h3 id="pass-credentials-via-environment-variables">

359 環境変数を通じて認証情報を渡す

360</h3>

331 361 

332`env` フィールドを使用して、API キー、トークン、およびその他の認証情報を MCP サーバーに渡します:362`env` フィールドを使用して、API キー、トークン、およびその他の認証情報を MCP サーバーに渡します:

333 363 


387 417 

388デバッグログを含む完全な動作例については、[リポジトリからの問題のリスト](#list-issues-from-a-repository)を参照してください。418デバッグログを含む完全な動作例については、[リポジトリからの問題のリスト](#list-issues-from-a-repository)を参照してください。

389 419 

390### リモートサーバーの HTTP ヘッダー420<h3 id="http-headers-for-remote-servers">

421 リモートサーバーの HTTP ヘッダー

422</h3>

391 423 

392HTTP および SSE サーバーの場合、サーバー設定で認証ヘッダーを直接渡します:424HTTP および SSE サーバーの場合、サーバー設定で認証ヘッダーを直接渡します:

393 425 


445 </Tab>477 </Tab>

446</Tabs>478</Tabs>

447 479 

448### OAuth2 認証480<h3 id="oauth2-authentication">

481 OAuth2 認証

482</h3>

449 483 

450[MCP 仕様は OAuth 2.1 をサポートしています](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization)。SDK は OAuth フローを自動的に処理しませんが、アプリケーションで OAuth フローを完了した後、ヘッダー経由でアクセストークンを渡すことができます:484[MCP 仕様は OAuth 2.1 をサポートしています](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization)。SDK は OAuth フローを自動的に処理しませんが、アプリケーションで OAuth フローを完了した後、ヘッダー経由でアクセストークンを渡すことができます:

451 485 


485 ```519 ```

486</CodeGroup>520</CodeGroup>

487 521 

488## 522<h2 id="examples">

523

524</h2>

489 525 

490### リポジトリから問題をリストする526<h3 id="list-issues-from-a-repository">

527 リポジトリから問題をリストする

528</h3>

491 529 

492この例は、[GitHub MCP サーバー](https://github.com/modelcontextprotocol/servers/tree/main/src/github)に接続して最近の問題をリストします。この例には、MCP 接続とツール呼び出しを検証するためのデバッグログが含まれています。530この例は、[GitHub MCP サーバー](https://github.com/modelcontextprotocol/servers/tree/main/src/github)に接続して最近の問題をリストします。この例には、MCP 接続とツール呼び出しを検証するためのデバッグログが含まれています。

493 531 


584 ```622 ```

585</CodeGroup>623</CodeGroup>

586 624 

587### データベースをクエリする625<h3 id="query-a-database">

626 データベースをクエリする

627</h3>

588 628 

589この例は、[Postgres MCP サーバー](https://github.com/modelcontextprotocol/servers/tree/main/src/postgres)を使用してデータベースをクエリします。接続文字列はサーバーへの引数として渡されます。エージェントは自動的にデータベーススキーマを検出し、SQL クエリを記述して、結果を返します:629この例は、[Postgres MCP サーバー](https://github.com/modelcontextprotocol/servers/tree/main/src/postgres)を使用してデータベースをクエリします。接続文字列はサーバーへの引数として渡されます。エージェントは自動的にデータベーススキーマを検出し、SQL クエリを記述して、結果を返します:

590 630 


655 ```695 ```

656</CodeGroup>696</CodeGroup>

657 697 

658## エラーハンドリング698<h2 id="error-handling">

699 エラーハンドリング

700</h2>

659 701 

660MCP サーバーはさまざまな理由で接続に失敗する可能性があります。サーバープロセスがインストールされていない、認証情報が無効である、またはリモートサーバーに到達できない可能性があります。702MCP サーバーはさまざまな理由で接続に失敗する可能性があります。サーバープロセスがインストールされていない、認証情報が無効である、またはリモートサーバーに到達できない可能性があります。

661 703 


717 ```759 ```

718</CodeGroup>760</CodeGroup>

719 761 

720## トラブルシューティング762<h2 id="troubleshooting">

763 トラブルシューティング

764</h2>

721 765 

722### サーバーが「失敗」ステータスを表示する766<h3 id="server-shows-failed-status">

767 サーバーが「失敗」ステータスを表示する

768</h3>

723 769 

724`init` メッセージをチェックして、どのサーバーが接続に失敗したかを確認します:770`init` メッセージをチェックして、どのサーバーが接続に失敗したかを確認します:

725 771 


740* **無効な接続文字列**:データベースサーバーの場合、接続文字列の形式を確認し、データベースにアクセス可能であることを確認します。786* **無効な接続文字列**:データベースサーバーの場合、接続文字列の形式を確認し、データベースにアクセス可能であることを確認します。

741* **ネットワークの問題**:リモート HTTP/SSE サーバーの場合、URL に到達可能であり、ファイアウォールが接続を許可していることを確認します。787* **ネットワークの問題**:リモート HTTP/SSE サーバーの場合、URL に到達可能であり、ファイアウォールが接続を許可していることを確認します。

742 788 

743### ツールが呼び出されていない789<h3 id="tools-not-being-called">

790 ツールが呼び出されていない

791</h3>

744 792 

745Claude がツールを認識しているが使用していない場合は、`allowedTools` で許可を付与していることを確認します:793Claude がツールを認識しているが使用していない場合は、`allowedTools` で許可を付与していることを確認します:

746 794 


755};803};

756```804```

757 805 

758### 接続タイムアウト806<h3 id="connection-timeouts">

807 接続タイムアウト

808</h3>

759 809 

760MCP SDK のサーバー接続のデフォルトタイムアウトは 60 秒です。サーバーの起動に時間がかかる場合、接続は失敗します。より多くの起動時間が必要なサーバーの場合は、以下を検討してください:810MCP SDK のサーバー接続のデフォルトタイムアウトは 60 秒です。サーバーの起動に時間がかかる場合、接続は失敗します。より多くの起動時間が必要なサーバーの場合は、以下を検討してください:

761 811 


763* エージェントを開始する前にサーバーをプリウォーミングする813* エージェントを開始する前にサーバーをプリウォーミングする

764* 遅い初期化の原因についてサーバーログを確認する814* 遅い初期化の原因についてサーバーログを確認する

765 815 

766## 関連リソース816<h2 id="related-resources">

817 関連リソース

818</h2>

767 819 

768* **[カスタムツールガイド](/ja/agent-sdk/custom-tools)**:SDK アプリケーションと同じプロセスで実行される独自の MCP サーバーを構築します820* **[カスタムツールガイド](/ja/agent-sdk/custom-tools)**:SDK アプリケーションと同じプロセスで実行される独自の MCP サーバーを構築します

769* **[パーミッション](/ja/agent-sdk/permissions)**:`allowedTools` と `disallowedTools` を使用してエージェントが使用できる MCP ツールを制御します821* **[パーミッション](/ja/agent-sdk/permissions)**:`allowedTools` と `disallowedTools` を使用してエージェントが使用できる MCP ツールを制御します

Details

12 12 

13Claude Code SDK は **Claude Agent SDK** に名前が変更され、ドキュメントが再編成されました。この変更は、コーディングタスクだけでなく、AI エージェント構築のための SDK のより広い機能を反映しています。13Claude Code SDK は **Claude Agent SDK** に名前が変更され、ドキュメントが再編成されました。この変更は、コーディングタスクだけでなく、AI エージェント構築のための SDK のより広い機能を反映しています。

14 14 

15<h2 id="what-s-changed">15<h2 id="whats-changed">

16 変更内容16 変更内容

17</h2>17</h2>

18 18 


82}82}

83```83```

84 84 

85以上です。他のコード変更は必要ありません。85**5. [破壊的変更](#breaking-changes) を確認します**

86 

87移行を完了するために必要なコード変更を行います。

86 88 

87<h3 id="for-python-projects">89<h3 id="for-python-projects">

88 Python プロジェクト向け90 Python プロジェクト向け


172 174 

173<CodeGroup>175<CodeGroup>

174 ```typescript TypeScript theme={null}176 ```typescript TypeScript theme={null}

177 import { query } from "@anthropic-ai/claude-agent-sdk";

178 

175 // 変更前(v0.0.x)- デフォルトで Claude Code のシステムプロンプトを使用179 // 変更前(v0.0.x)- デフォルトで Claude Code のシステムプロンプトを使用

176 const result = query({ prompt: "Hello" });180 const before = query({ prompt: "Hello" });

177 181 

178 // 変更後(v0.1.0)- デフォルトで最小限のシステムプロンプトを使用182 // 変更後(v0.1.0)- デフォルトで最小限のシステムプロンプトを使用

179 // 古い動作を取得するには、Claude Code のプリセットを明示的にリクエストします:183 // 古い動作を取得するには、Claude Code のプリセットを明示的にリクエストします:

180 const result = query({184 const presetResult = query({

181 prompt: "Hello",185 prompt: "Hello",

182 options: {186 options: {

183 systemPrompt: { type: "preset", preset: "claude_code" }187 systemPrompt: { type: "preset", preset: "claude_code" }


185 });189 });

186 190 

187 // またはカスタムシステムプロンプトを使用します:191 // またはカスタムシステムプロンプトを使用します:

188 const result = query({192 const customResult = query({

189 prompt: "Hello",193 prompt: "Hello",

190 options: {194 options: {

191 systemPrompt: "You are a helpful coding assistant"195 systemPrompt: "You are a helpful coding assistant"


233 237 

234<CodeGroup>238<CodeGroup>

235 ```typescript TypeScript theme={null}239 ```typescript TypeScript theme={null}

236 const result = query({240 import { query } from "@anthropic-ai/claude-agent-sdk";

241 

242 const isolatedResult = query({

237 prompt: "Hello",243 prompt: "Hello",

238 options: {244 options: {

239 settingSources: [] // ファイルシステム設定は読み込まれません245 settingSources: [] // ファイルシステム設定は読み込まれません


241 });247 });

242 248 

243 // または特定のソースのみを読み込みます:249 // または特定のソースのみを読み込みます:

244 const result = query({250 const projectOnlyResult = query({

245 prompt: "Hello",251 prompt: "Hello",

246 options: {252 options: {

247 settingSources: ["project"] // プロジェクト設定のみ253 settingSources: ["project"] // プロジェクト設定のみ

Details

193 ...process.env,193 ...process.env,

194 // ... エクスポーター設定 ...194 // ... エクスポーター設定 ...

195 OTEL_SERVICE_NAME: "support-triage-agent",195 OTEL_SERVICE_NAME: "support-triage-agent",

196 OTEL_RESOURCE_ATTRIBUTES:196 OTEL_RESOURCE_ATTRIBUTES":

197 "service.version=1.4.0,deployment.environment=production",197 "service.version=1.4.0,deployment.environment=production",

198 },198 },

199 };199 };

Details

478 478 

479| 機能 | 説明 | 場所 |479| 機能 | 説明 | 場所 |

480| ------------------------------------------------ | ---------------------------------------------- | ----------------------------------- |480| ------------------------------------------------ | ---------------------------------------------- | ----------------------------------- |

481| [Skills](/ja/agent-sdk/skills) | Markdown で定義された特化した機能 | `.claude/skills/*/SKILL.md` |481| [Skills](/ja/agent-sdk/skills) | Claude が自動的に使用するか、`/name` で呼び出す特化した機能 | `.claude/skills/*/SKILL.md` |

482| [Commands](/ja/agent-sdk/slash-commands) | レガシー形式のカスタムコマンド。新しいカスタムコマンドには skills を使用してください | `.claude/commands/*.md` |482| [Commands](/ja/agent-sdk/slash-commands) | レガシー形式のカスタムコマンド。新しいカスタムコマンドには skills を使用してください | `.claude/commands/*.md` |

483| [Memory](/ja/agent-sdk/modifying-system-prompts) | プロジェクトコンテキストと指示 | `CLAUDE.md` または `.claude/CLAUDE.md` |483| [Memory](/ja/agent-sdk/modifying-system-prompts) | プロジェクトコンテキストと指示 | `CLAUDE.md` または `.claude/CLAUDE.md` |

484| [Plugins](/ja/agent-sdk/plugins) | skills、エージェント、hooks、および MCP サーバーで拡張 | `plugins` オプション経由でプログラム的に |484| [Plugins](/ja/agent-sdk/plugins) | skills、エージェント、hooks、および MCP サーバーで拡張 | `plugins` オプション経由でプログラム的に |


567 バグの報告567 バグの報告

568</h2>568</h2>

569 569 

570Agent SDK でバグまたは問題が発生した場合570Agent SDK でバグまたは問題が発生した場合

571 571 

572* **TypeScript SDK**: [GitHub で問題を報告](https://github.com/anthropics/claude-agent-sdk-typescript/issues)572* **TypeScript SDK**: [GitHub で問題を報告](https://github.com/anthropics/claude-agent-sdk-typescript/issues)

573* **Python SDK**: [GitHub で問題を報告](https://github.com/anthropics/claude-agent-sdk-python/issues)573* **Python SDK**: [GitHub で問題を報告](https://github.com/anthropics/claude-agent-sdk-python/issues)


576 ブランドガイドライン576 ブランドガイドライン

577</h2>577</h2>

578 578 

579Claude Agent SDK を統合するパートナーの場合、Claude ブランドの使用はオプションです。製品で Claude を参照する場合579Claude Agent SDK を統合するパートナーの場合、Claude ブランドの使用はオプションです。製品で Claude を参照する場合

580 580 

581**許可されています:**581**許可されています**

582 582 

583* 'Claude Agent'(ドロップダウンメニューに推奨)583* Claude Agent(ドロップダウンメニューに推奨)

584* 'Claude'(既に'Agents'というラベルが付いたメニュー内の場合)584* Claude(既にAgentsというラベルが付いたメニュー内の場合)

585* '{YourAgentName} Powered by Claude'(既存のエージェント名がある場合)585* {YourAgentName} Powered by Claude(既存のエージェント名がある場合)

586 586 

587**許可されていません:**587**許可されていません**

588 588 

589* 'Claude Code'または'Claude Code Agent'589* Claude CodeまたはClaude Code Agent

590* Claude Code ブランドの ASCII アートまたは Claude Code を模倣する視覚要素590* Claude Code ブランドの ASCII アートまたは Claude Code を模倣する視覚要素

591 591 

592製品は独自のブランドを維持し、Claude Code または任意の Anthropic 製品のように見えるべきではありません。ブランドコンプライアンスに関する質問については、Anthropic [営業チーム](https://www.anthropic.com/contact-sales)に連絡してください。592製品は独自のブランドを維持し、Claude Code または任意の Anthropic 製品のように見えるべきではありません。ブランドコンプライアンスに関する質問については、Anthropic [営業チーム](https://www.anthropic.com/contact-sales)に連絡してください。

Details

27 `deny` ルール(`disallowed_tools` および[settings.json](/ja/settings#permission-settings)から)をチェックします。拒否ルールが一致する場合、`bypassPermissions` モードでもツールはブロックされます。`Bash` のような裸名の拒否ルールはこの評価が開始される前に Claude のコンテキストからツールを削除するため、このステップでチェックされるのは `Bash(rm *)` のようなスコープ付きルールのみです。27 `deny` ルール(`disallowed_tools` および[settings.json](/ja/settings#permission-settings)から)をチェックします。拒否ルールが一致する場合、`bypassPermissions` モードでもツールはブロックされます。`Bash` のような裸名の拒否ルールはこの評価が開始される前に Claude のコンテキストからツールを削除するため、このステップでチェックされるのは `Bash(rm *)` のようなスコープ付きルールのみです。

28 </Step>28 </Step>

29 29 

30 <Step title="質問ルール">

31 [settings.json](/ja/settings#permission-settings)から `ask` ルールをチェックします。質問ルールが一致する場合、`bypassPermissions` モードでも、コールは確認のために[`canUseTool` コールバック](/ja/agent-sdk/user-input)にフォールスルーします。`dontAsk` モードでは、一致する質問ルールは代わりに拒否されます。このモードはプロンプトを表示しないためです。

32 </Step>

33 

30 <Step title="パーミッションモード">34 <Step title="パーミッションモード">

31 アクティブな[パーミッションモード](#permission-modes)を適用します。`bypassPermissions` はこのステップに到達したすべてを承認します。`acceptEdits` はファイル操作を承認します。その他のモードはフォールスルーします。35 アクティブな[パーミッションモード](#permission-modes)を適用します。`bypassPermissions` はこのステップに到達したすべてを承認します。`acceptEdits` はファイル操作を承認します。`plan` はファイル編集およびシェル書き込みツールを許可ルールに関係なく [`canUseTool` コールバック](/ja/agent-sdk/user-input)にルーティングするため、計画中は書き込み操作を自動承認することはできません。その他のモードはフォールスルーします。

32 </Step>36 </Step>

33 37 

34 <Step title="許可ルール">38 <Step title="許可ルール">


40 </Step>44 </Step>

41</Steps>45</Steps>

42 46 

43<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=cc94220087262cd48c9b64a14c4e1c2c" alt="パーミッション評価フロー図" width="1024" height="260" data-path="images/agent-sdk/permissions-flow.svg" />47<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/agent-sdk/permissions-flow.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=cc94220087262cd48c9b64a14c4e1c2c" alt="5 ステップのパーミッション評価フロー図。ツールリクエストはフック、拒否ルール、パーミッションモード、許可ルール、canUseTool を通過します。フック、拒否ルール、canUseTool はブロックにルーティングでき、パーミッションモードバイパス、許可ルール、canUseTool は実行にルーティングできます。" width="1024" height="260" data-path="images/agent-sdk/permissions-flow.svg" />

44 48 

45このページは**許可および拒否ルール**と**パーミッションモード**に焦点を当てています。その他のステップについては、以下を参照してください。49このページは**許可および拒否ルール**と**パーミッションモード**に焦点を当てています。その他のステップについては、以下を参照してください。

46 50 


58| `allowed_tools=["Read", "Grep"]` | `Read` および `Grep` は自動承認されます。ここにリストされていないツールは引き続き存在し、パーミッションモードおよび `canUseTool` にフォールスルーします。 |62| `allowed_tools=["Read", "Grep"]` | `Read` および `Grep` は自動承認されます。ここにリストされていないツールは引き続き存在し、パーミッションモードおよび `canUseTool` にフォールスルーします。 |

59| `disallowed_tools=["Bash"]` | `Bash` ツール定義はリクエストから削除されます。Claude はツールを認識せず、それを試みることはできません。 |63| `disallowed_tools=["Bash"]` | `Bash` ツール定義はリクエストから削除されます。Claude はツールを認識せず、それを試みることはできません。 |

60| `disallowed_tools=["Bash(rm *)"]` | `Bash` は利用可能なままです。`rm *` に一致する呼び出しは、`bypassPermissions` を含むすべてのパーミッションモードで拒否されます。その他の `Bash` 呼び出しはパーミッションモードにフォールスルーします。 |64| `disallowed_tools=["Bash(rm *)"]` | `Bash` は利用可能なままです。`rm *` に一致する呼び出しは、`bypassPermissions` を含むすべてのパーミッションモードで拒否されます。その他の `Bash` 呼び出しはパーミッションモードにフォールスルーします。 |

65| `disallowed_tools=["*"]` | すべてのツール定義はリクエストから削除されます。拒否ルールではツール名グロブがサポートされています。`"*"` はすべてのツールに一致し、`"mcp__*"` はすべてのサーバー全体のすべての MCP ツールに一致します。 |

66 

67許可ルールは、リテラル `mcp__<server>__` プレフィックスの後にのみツール名グロブを受け入れます。サーバーセグメントはグロブフリーである必要があり、設定したサーバーに名前を付けます。`mcp__puppeteer__*` は `puppeteer` サーバーからのすべてのツールに一致し、`mcp__github__get_*` はその `get_` ツールに一致します。`allowed_tools=["*"]` または `allowed_tools=["mcp__*"]` のようなアンカーされていないエントリは、スタートアップ警告で無視され、何も自動承認しません。

61 68 

62ロックダウンされたエージェントの場合、`allowedTools` を `permissionMode: "dontAsk"` と組み合わせます。リストされたツールは承認されます。その他のものはプロンプトの代わりに直接拒否されます。69ロックダウンされたエージェントの場合、`allowedTools` を `permissionMode: "dontAsk"` と組み合わせます。リストされたツールは承認されます。その他のものはプロンプトの代わりに直接拒否されます。

63 70 


87SDK は以下のパーミッションモードをサポートしています。94SDK は以下のパーミッションモードをサポートしています。

88 95 

89| モード | 説明 | ツール動作 |96| モード | 説明 | ツール動作 |

90| :-------------------- | :------------------- | :----------------------------------------------------------------------------------------------------------- |97| :-------------------- | :--------------- | :----------------------------------------------------------------------------------------------------------- |

91| `default` | 標準パーミッション動作 | 自動承認なし。一致しないツールは `canUseTool` コールバックをトリガーします |98| `default` | 標準パーミッション動作 | 自動承認なし。一致しないツールは `canUseTool` コールバックをトリガーします |

92| `dontAsk` | プロンプトの代わりに拒否 | `allowed_tools` またはルールで事前承認されていないものはすべて拒否されます。`canUseTool` は呼び出されません |99| `dontAsk` | プロンプトの代わりに拒否 | `allowed_tools` またはルールで事前承認されていないものはすべて拒否されます。`canUseTool` は呼び出されません |

93| `acceptEdits` | ファイル編集を自動受け入れ | ファイル編集および[ファイルシステム操作](#accept-edits-mode-acceptedits)(`mkdir`、`rm`、`mv` など)は自動的に承認されます |100| `acceptEdits` | ファイル編集を自動受け入れ | ファイル編集および[ファイルシステム操作](#accept-edits-mode-acceptedits)(`mkdir`、`rm`、`mv` など)は自動的に承認されます |

94| `bypassPermissions` | すべてのパーミッションチェックをバイパス | すべてのツールはパーミッションプロンプトなしで実行されます(注意して使用してください) |101| `bypassPermissions` | パーミッションチェックをバイパス | ツールは明示的な [`ask` ルール](#how-permissions-are-evaluated)が一致しない限り、パーミッションプロンプトなしで実行されます(注意して使用してください) |

95| `plan` | 計画モード | 読み取り専用ツールが実行されます。Claude はソースファイルを編集せずに分析および計画します |102| `plan` | 計画モード | Claude はソースファイルを編集せずにコードベースを探索および計画します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトが表示されます |

96| `auto`(TypeScript のみ) | モデル分類承認 | モデル分類器が各ツール呼び出しを承認または拒否します。利用可能性については[自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください |103| `auto`(TypeScript のみ) | モデル分類承認 | モデル分類器が各ツール呼び出しを承認または拒否します。利用可能性については[自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を参照してください |

97 104 

98<Warning>105<Warning>

99 **サブエージェント継承:** 親が `bypassPermissions`、`acceptEdits`、または `auto` を使用する場合、すべてのサブエージェントはそのモードを継承し、サブエージェントごとにオーバーライドすることはできません。サブエージェントはシステムプロンプトが異なり、メインエージェントよりも制約が少ない動作をする可能性があるため、`bypassPermissions` を継承すると、承認プロンプトなしで完全な自律的なシステムアクセスが付与されます106 **サブエージェント継承:** 親が `bypassPermissions`、`acceptEdits`、または `auto` を使用する場合、すべてのサブエージェントはそのモードを継承し、サブエージェントごとにオーバーライドすることはできません。サブエージェントはシステムプロンプトが異なり、メインエージェントよりも制約が少ない動作をする可能性があるため、`bypassPermissions` を継承すると、完全な自律的なシステムアクセスが付与されます明示的な [`ask` ルール](#how-permissions-are-evaluated)は引き続きプロンプトを強制します。

100</Warning>107</Warning>

101 108 

102<h3 id="set-permission-mode">109<h3 id="set-permission-mode">


226 233 

227**使用時期:** Claude の編集を信頼し、プロトタイピング中など、より高速な反復を望む場合、または分離されたディレクトリで作業する場合。234**使用時期:** Claude の編集を信頼し、プロトタイピング中など、より高速な反復を望む場合、または分離されたディレクトリで作業する場合。

228 235 

229<h4 id="don-t-ask-mode-dontask">236<h4 id="dont-ask-mode-dontask">

230 質問しないモード(`dontAsk`)237 質問しないモード(`dontAsk`)

231</h4>238</h4>

232 239 


250 計画モード(`plan`)257 計画モード(`plan`)

251</h4>258</h4>

252 259 

253Claude を読み取り専用ツールに制限しますClaude はファイルを読み取り読み取り専用シェルコマンドを実行してコードベースを探索できますがソースファイルは編集しません。Claude `AskUserQuestion` を使用して、計画を最終化する前に要件を明確にする場合があります。これらのプロンプトの処理については、[承認とユーザー入力の処理](/ja/agent-sdk/user-input#handle-clarifying-questions)を参照してください。260Claude はコードベースを探索および計画を作成し、ソースファイルを編集しません読み取り専用ツールはデフォルトモードと同じように実行されます。ファイル編集は計画モードで自動承認されることはなく許可ルールが一致する場合でも代わりに `canUseTool` コールバックを通じてプロンプトが表示されます。Claude は計画を最終化する前に要件を明確にするために `AskUserQuestion` を使用する場合があります。これらのプロンプトの処理については、[承認とユーザー入力の処理](/ja/agent-sdk/user-input#handle-clarifying-questions)を参照してください。

254 261 

255**使用時期:** Claude に変更を提案させたいが実行させたくない場合、たとえばコードレビュー中または変更を実行する前に承認が必要な場合。262**使用時期:** Claude に変更を提案させたいが実行させたくない場合、たとえばコードレビュー中または変更を実行する前に承認が必要な場合。

256 263 

agent-sdk/python.md +517 −176

Details

6 6 

7> Python Agent SDK の完全な API リファレンス。すべての関数、型、クラスを含みます。7> Python Agent SDK の完全な API リファレンス。すべての関数、型、クラスを含みます。

8 8 

9## インストール9<h2 id="installation">

10 インストール

11</h2>

10 12 

11```bash theme={null}13```bash theme={null}

12pip install claude-agent-sdk14pip install claude-agent-sdk

13```15```

14 16 

15## `query()` と `ClaudeSDKClient` の選択17<h2 id="choosing-between-query-and-claudesdkclient">

18 `query()` と `ClaudeSDKClient` の選択

19</h2>

16 20 

17Python SDK は Claude Code と対話するための 2 つの方法を提供します。21Python SDK は Claude Code と対話するための 2 つの方法を提供します。

18 22 

19### クイック比較23<h3 id="quick-comparison">

24 クイック比較

25</h3>

20 26 

21| 機能 | `query()` | `ClaudeSDKClient` |27| 機能 | `query()` | `ClaudeSDKClient` |

22| :------------ | :----------------------------------------- | :---------------- |28| :------------ | :----------------------------------------- | :---------------- |


30| **会話を続ける** | `continue_conversation` または `resume` で手動実行 | ✅ 自動 |36| **会話を続ける** | `continue_conversation` または `resume` で手動実行 | ✅ 自動 |

31| **ユースケース** | 1 回限りのタスク | 継続的な会話 |37| **ユースケース** | 1 回限りのタスク | 継続的な会話 |

32 38 

33### `query()` を使用する場合(1 回限りのタスク)39<h3 id="when-to-use-query-one-off-tasks">

40 `query()` を使用する場合(1 回限りのタスク)

41</h3>

34 42 

35**最適な用途:**43**最適な用途:**

36 44 


39* シンプルな自動化スクリプト47* シンプルな自動化スクリプト

40* 毎回新しく開始したい場合48* 毎回新しく開始したい場合

41 49 

42### `ClaudeSDKClient` を使用する場合(継続的な会話)50<h3 id="when-to-use-claudesdkclient-continuous-conversation">

51 `ClaudeSDKClient` を使用する場合(継続的な会話)

52</h3>

43 53 

44**最適な用途:**54**最適な用途:**

45 55 


49* **応答駆動ロジック** - 次のアクションが Claude の応答に依存する場合59* **応答駆動ロジック** - 次のアクションが Claude の応答に依存する場合

50* **セッション制御** - 会話ライフサイクルを明示的に管理する60* **セッション制御** - 会話ライフサイクルを明示的に管理する

51 61 

52## 関数62<h2 id="functions">

63 関数

64</h2>

53 65 

54### `query()`66<h3 id="query">

67 `query()`

68</h3>

55 69 

56Claude Code との各インタラクションのために新しいセッションを作成します。デフォルトでは、メッセージが到着するにつれて生成される非同期イテレータを返します。`query()` への各呼び出しは、`continue_conversation=True` または [`ClaudeAgentOptions`](#claudeagentoptions) の `resume` を渡さない限り、前のインタラクションのメモリなしで新しく開始します。[セッション](/ja/agent-sdk/sessions) を参照してください。70Claude Code との各インタラクションのために新しいセッションを作成します。デフォルトでは、メッセージが到着するにつれて生成される非同期イテレータを返します。`query()` への各呼び出しは、`continue_conversation=True` または [`ClaudeAgentOptions`](#claudeagentoptions) の `resume` を渡さない限り、前のインタラクションのメモリなしで新しく開始します。[セッション](/ja/agent-sdk/sessions) を参照してください。

57 71 


64) -> AsyncIterator[Message]78) -> AsyncIterator[Message]

65```79```

66 80 

67#### パラメータ81<h4 id="parameters">

82 パラメータ

83</h4>

68 84 

69| パラメータ | 型 | 説明 |85| パラメータ | 型 | 説明 |

70| :---------- | :--------------------------- | :------------------------------------------------------ |86| :---------- | :--------------------------- | :------------------------------------------------------ |


72| `options` | `ClaudeAgentOptions \| None` | オプションの設定オブジェクト(None の場合は `ClaudeAgentOptions()` がデフォルト) |88| `options` | `ClaudeAgentOptions \| None` | オプションの設定オブジェクト(None の場合は `ClaudeAgentOptions()` がデフォルト) |

73| `transport` | `Transport \| None` | CLI プロセスとの通信用のオプションのカスタムトランスポート |89| `transport` | `Transport \| None` | CLI プロセスとの通信用のオプションのカスタムトランスポート |

74 90 

75#### 戻り値91<h4 id="returns">

92 戻り値

93</h4>

76 94 

77会話からのメッセージを生成する `AsyncIterator[Message]` を返します。95会話からのメッセージを生成する `AsyncIterator[Message]` を返します。

78 96 

79#### 例 - オプション付き97<h4 id="example-with-options">

98 例 - オプション付き

99</h4>

80 100 

81```python theme={null}101```python theme={null}

82import asyncio102import asyncio


97asyncio.run(main())117asyncio.run(main())

98```118```

99 119 

100### `tool()`120<h3 id="tool">

121 `tool()`

122</h3>

101 123 

102型安全性を備えた MCP ツールを定義するためのデコレータ。124型安全性を備えた MCP ツールを定義するためのデコレータ。

103 125 


110) -> Callable[[Callable[[Any], Awaitable[dict[str, Any]]]], SdkMcpTool[Any]]132) -> Callable[[Callable[[Any], Awaitable[dict[str, Any]]]], SdkMcpTool[Any]]

111```133```

112 134 

113#### パラメータ135<h4 id="parameters-1">

136 パラメータ

137</h4>

114 138 

115| パラメータ | 型 | 説明 |139| パラメータ | 型 | 説明 |

116| :------------- | :---------------------------------------------- | :------------------------------------- |140| :------------- | :---------------------------------------------- | :------------------------------------- |


119| `input_schema` | `type \| dict[str, Any]` | ツールの入力パラメータを定義するスキーマ(以下を参照) |143| `input_schema` | `type \| dict[str, Any]` | ツールの入力パラメータを定義するスキーマ(以下を参照) |

120| `annotations` | [`ToolAnnotations`](#toolannotations)` \| None` | クライアントに動作ヒントを提供するオプションの MCP ツールアノテーション |144| `annotations` | [`ToolAnnotations`](#toolannotations)` \| None` | クライアントに動作ヒントを提供するオプションの MCP ツールアノテーション |

121 145 

122#### 入力スキーマオプション146<h4 id="input-schema-options">

147 入力スキーマオプション

148</h4>

123 149 

1241. **シンプルな型マッピング**(推奨):1501. **シンプルな型マッピング**(推奨):

125 151 


139 }165 }

140 ```166 ```

141 167 

142#### 戻り値168<h4 id="returns-1">

169 戻り値

170</h4>

143 171 

144ツール実装をラップし、`SdkMcpTool` インスタンスを返すデコレータ関数。172ツール実装をラップし、`SdkMcpTool` インスタンスを返すデコレータ関数。

145 173 

146#### 174<h4 id="example">

175

176</h4>

147 177 

148```python theme={null}178```python theme={null}

149from claude_agent_sdk import tool179from claude_agent_sdk import tool


155 return {"content": [{"type": "text", "text": f"Hello, {args['name']}!"}]}185 return {"content": [{"type": "text", "text": f"Hello, {args['name']}!"}]}

156```186```

157 187 

158#### `ToolAnnotations`188<h4 id="toolannotations">

189 `ToolAnnotations`

190</h4>

159 191 

160`mcp.types` から再エクスポート(`from claude_agent_sdk import ToolAnnotations` としても利用可能)。すべてのフィールドはオプションのヒントです。クライアントはセキュリティ決定のためにこれらに依存すべきではありません。192`mcp.types` から再エクスポート(`from claude_agent_sdk import ToolAnnotations` としても利用可能)。すべてのフィールドはオプションのヒントです。クライアントはセキュリティ決定のためにこれらに依存すべきではありません。

161 193 


182 return {"content": [{"type": "text", "text": f"Results for: {args['query']}"}]}214 return {"content": [{"type": "text", "text": f"Results for: {args['query']}"}]}

183```215```

184 216 

185### `create_sdk_mcp_server()`217<h3 id="create_sdk_mcp_server">

218 `create_sdk_mcp_server()`

219</h3>

186 220 

187Python アプリケーション内で実行されるインプロセス MCP サーバーを作成します。221Python アプリケーション内で実行されるインプロセス MCP サーバーを作成します。

188 222 


194) -> McpSdkServerConfig228) -> McpSdkServerConfig

195```229```

196 230 

197#### パラメータ231<h4 id="parameters-2">

232 パラメータ

233</h4>

198 234 

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

200| :-------- | :------------------------------ | :-------- | :--------------------------- |236| :-------- | :------------------------------ | :-------- | :--------------------------- |


202| `version` | `str` | `"1.0.0"` | サーバーバージョン文字列 |238| `version` | `str` | `"1.0.0"` | サーバーバージョン文字列 |

203| `tools` | `list[SdkMcpTool[Any]] \| None` | `None` | `@tool` デコレータで作成されたツール関数のリスト |239| `tools` | `list[SdkMcpTool[Any]] \| None` | `None` | `@tool` デコレータで作成されたツール関数のリスト |

204 240 

205#### 戻り値241<h4 id="returns-2">

242 戻り値

243</h4>

206 244 

207`ClaudeAgentOptions.mcp_servers` に渡すことができる `McpSdkServerConfig` オブジェクトを返します。245`ClaudeAgentOptions.mcp_servers` に渡すことができる `McpSdkServerConfig` オブジェクトを返します。

208 246 

209#### 247<h4 id="example-1">

248

249</h4>

210 250 

211```python theme={null}251```python theme={null}

212from claude_agent_sdk import tool, create_sdk_mcp_server252from claude_agent_sdk import tool, create_sdk_mcp_server


235)275)

236```276```

237 277 

238### `list_sessions()`278<h3 id="list_sessions">

279 `list_sessions()`

280</h3>

239 281 

240メタデータを含む過去のセッションをリストします。プロジェクトディレクトリでフィルタするか、すべてのプロジェクト全体のセッションをリストします。同期的です。すぐに返します。282メタデータを含む過去のセッションをリストします。プロジェクトディレクトリでフィルタするか、すべてのプロジェクト全体のセッションをリストします。同期的です。すぐに返します。

241 283 


247) -> list[SDKSessionInfo]289) -> list[SDKSessionInfo]

248```290```

249 291 

250#### パラメータ292<h4 id="parameters-3">

293 パラメータ

294</h4>

251 295 

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

253| :------------------ | :------------ | :----- | :---------------------------------------------------------- |297| :------------------ | :------------ | :----- | :---------------------------------------------------------- |


255| `limit` | `int \| None` | `None` | 返すセッションの最大数 |299| `limit` | `int \| None` | `None` | 返すセッションの最大数 |

256| `include_worktrees` | `bool` | `True` | `directory` が git リポジトリ内にある場合、すべての worktree パスからのセッションを含めます |300| `include_worktrees` | `bool` | `True` | `directory` が git リポジトリ内にある場合、すべての worktree パスからのセッションを含めます |

257 301 

258#### 戻り値の型:`SDKSessionInfo`302<h4 id="return-type-sdksessioninfo">

303 戻り値の型:`SDKSessionInfo`

304</h4>

259 305 

260| プロパティ | 型 | 説明 |306| プロパティ | 型 | 説明 |

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


270| `tag` | `str \| None` | ユーザーが設定したセッションタグ([`tag_session()`](#tag_session) を参照) |316| `tag` | `str \| None` | ユーザーが設定したセッションタグ([`tag_session()`](#tag_session) を参照) |

271| `created_at` | `int \| None` | エポック以降のミリ秒単位でのセッション作成時刻 |317| `created_at` | `int \| None` | エポック以降のミリ秒単位でのセッション作成時刻 |

272 318 

273#### 319<h4 id="example-2">

320

321</h4>

274 322 

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

276 324 


281 print(f"{session.summary} ({session.session_id})")329 print(f"{session.summary} ({session.session_id})")

282```330```

283 331 

284### `get_session_messages()`332<h3 id="get_session_messages">

333 `get_session_messages()`

334</h3>

285 335 

286過去のセッションからメッセージを取得します。同期的です。すぐに返します。336過去のセッションからメッセージを取得します。同期的です。すぐに返します。

287 337 


294) -> list[SessionMessage]344) -> list[SessionMessage]

295```345```

296 346 

297#### パラメータ347<h4 id="parameters-4">

348 パラメータ

349</h4>

298 350 

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

300| :----------- | :------------ | :----- | :--------------------------------------- |352| :----------- | :------------ | :----- | :--------------------------------------- |


303| `limit` | `int \| None` | `None` | 返すメッセージの最大数 |355| `limit` | `int \| None` | `None` | 返すメッセージの最大数 |

304| `offset` | `int` | `0` | 開始からスキップするメッセージ数 |356| `offset` | `int` | `0` | 開始からスキップするメッセージ数 |

305 357 

306#### 戻り値の型:`SessionMessage`358<h4 id="return-type-sessionmessage">

359 戻り値の型:`SessionMessage`

360</h4>

307 361 

308| プロパティ | 型 | 説明 |362| プロパティ | 型 | 説明 |

309| :------------------- | :----------------------------- | :------------ |363| :------------------- | :----------------------------- | :------------ |


313| `message` | `Any` | 生のメッセージコンテンツ |367| `message` | `Any` | 生のメッセージコンテンツ |

314| `parent_tool_use_id` | `None` | 将来の使用のために予約済み |368| `parent_tool_use_id` | `None` | 将来の使用のために予約済み |

315 369 

316#### 370<h4 id="example-3">

371

372</h4>

317 373 

318```python theme={null}374```python theme={null}

319from claude_agent_sdk import list_sessions, get_session_messages375from claude_agent_sdk import list_sessions, get_session_messages


325 print(f"[{msg.type}] {msg.uuid}")381 print(f"[{msg.type}] {msg.uuid}")

326```382```

327 383 

328### `get_session_info()`384<h3 id="get_session_info">

385 `get_session_info()`

386</h3>

329 387 

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

331 389 


336) -> SDKSessionInfo | None394) -> SDKSessionInfo | None

337```395```

338 396 

339#### パラメータ397<h4 id="parameters-5">

398 パラメータ

399</h4>

340 400 

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

342| :----------- | :------------ | :----- | :------------------------------------------- |402| :----------- | :------------ | :----- | :------------------------------------------- |


345 405 

346[`SDKSessionInfo`](#return-type-sdksessioninfo) を返すか、セッションが見つからない場合は `None`。406[`SDKSessionInfo`](#return-type-sdksessioninfo) を返すか、セッションが見つからない場合は `None`。

347 407 

348#### 408<h4 id="example-4">

409

410</h4>

349 411 

350プロジェクトディレクトリをスキャンせずに、シングルセッションのメタデータを検索します。前の実行からセッション ID を既に持っている場合に便利です。412プロジェクトディレクトリをスキャンせずに、シングルセッションのメタデータを検索します。前の実行からセッション ID を既に持っている場合に便利です。

351 413 


357 print(f"{info.summary} (branch: {info.git_branch}, tag: {info.tag})")419 print(f"{info.summary} (branch: {info.git_branch}, tag: {info.tag})")

358```420```

359 421 

360### `rename_session()`422<h3 id="rename_session">

423 `rename_session()`

424</h3>

361 425 

362カスタムタイトルエントリを追加することでセッションの名前を変更します。繰り返し呼び出しは安全です。最新のタイトルが優先されます。同期的です。426カスタムタイトルエントリを追加することでセッションの名前を変更します。繰り返し呼び出しは安全です。最新のタイトルが優先されます。同期的です。

363 427 


369) -> None433) -> None

370```434```

371 435 

372#### パラメータ436<h4 id="parameters-6">

437 パラメータ

438</h4>

373 439 

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

375| :----------- | :------------ | :----- | :------------------------------------------- |441| :----------- | :------------ | :----- | :------------------------------------------- |


379 445 

380`session_id` が有効な UUID でない場合、または `title` が空の場合は `ValueError` を発生させます。セッションが見つからない場合は `FileNotFoundError`。446`session_id` が有効な UUID でない場合、または `title` が空の場合は `ValueError` を発生させます。セッションが見つからない場合は `FileNotFoundError`。

381 447 

382#### 448<h4 id="example-5">

449

450</h4>

383 451 

384最新のセッションの名前を変更して、後で見つけやすくします。新しいタイトルは、その後の読み取りで [`SDKSessionInfo.custom_title`](#return-type-sdksessioninfo) に表示されます。452最新のセッションの名前を変更して、後で見つけやすくします。新しいタイトルは、その後の読み取りで [`SDKSessionInfo.custom_title`](#return-type-sdksessioninfo) に表示されます。

385 453 


391 rename_session(sessions[0].session_id, "Refactor auth module")459 rename_session(sessions[0].session_id, "Refactor auth module")

392```460```

393 461 

394### `tag_session()`462<h3 id="tag_session">

463 `tag_session()`

464</h3>

395 465 

396セッションにタグを付けます。`None` を渡してタグをクリアします。繰り返し呼び出しは安全です。最新のタグが優先されます。同期的です。466セッションにタグを付けます。`None` を渡してタグをクリアします。繰り返し呼び出しは安全です。最新のタグが優先されます。同期的です。

397 467 


403) -> None473) -> None

404```474```

405 475 

406#### パラメータ476<h4 id="parameters-7">

477 パラメータ

478</h4>

407 479 

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

409| :----------- | :------------ | :----- | :---------------------------------------------- |481| :----------- | :------------ | :----- | :---------------------------------------------- |


413 485 

414`session_id` が有効な UUID でない場合、またはサニタイズ後に `tag` が空の場合は `ValueError` を発生させます。セッションが見つからない場合は `FileNotFoundError`。486`session_id` が有効な UUID でない場合、またはサニタイズ後に `tag` が空の場合は `ValueError` を発生させます。セッションが見つからない場合は `FileNotFoundError`。

415 487 

416#### 488<h4 id="example-6">

489

490</h4>

417 491 

418セッションにタグを付けてから、後の読み取りでそのタグでフィルタします。既存のタグをクリアするには `None` を渡します。492セッションにタグを付けてから、後の読み取りでそのタグでフィルタします。既存のタグをクリアするには `None` を渡します。

419 493 


429 print(session.summary)503 print(session.summary)

430```504```

431 505 

432## クラス506<h2 id="classes">

507 クラス

508</h2>

433 509 

434### `ClaudeSDKClient`510<h3 id="claudesdkclient">

511 `ClaudeSDKClient`

512</h3>

435 513 

436**複数の交換にわたってセッションを維持します。** これは TypeScript SDK の `query()` 関数が内部的にどのように機能するかの Python 同等物です。会話を続けることができるクライアントオブジェクトを作成します。514**複数の交換にわたってセッションを維持します。** これは TypeScript SDK の `query()` 関数が内部的にどのように機能するかの Python 同等物です。会話を続けることができるクライアントオブジェクトを作成します。

437 515 

438#### 主な機能516<h4 id="key-features">

517 主な機能

518</h4>

439 519 

440* **セッション継続性**:複数の `query()` 呼び出しにわたって会話コンテキストを維持します520* **セッション継続性**:複数の `query()` 呼び出しにわたって会話コンテキストを維持します

441* **同じ会話**:セッションは前のメッセージを保持します521* **同じ会話**:セッションは前のメッセージを保持します


463 async def disconnect(self) -> None543 async def disconnect(self) -> None

464```544```

465 545 

466#### メソッド546<h4 id="methods">

547 メソッド

548</h4>

467 549 

468| メソッド | 説明 |550| メソッド | 説明 |

469| :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |551| :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------------- |


483| `get_server_info()` | セッション ID と機能を含むサーバー情報を取得します |565| `get_server_info()` | セッション ID と機能を含むサーバー情報を取得します |

484| `disconnect()` | Claude から切断します |566| `disconnect()` | Claude から切断します |

485 567 

486#### コンテキストマネージャーサポート568<h4 id="context-manager-support">

569 コンテキストマネージャーサポート

570</h4>

487 571 

488クライアントは自動接続管理のための非同期コンテキストマネージャーとして使用できます:572クライアントは自動接続管理のための非同期コンテキストマネージャーとして使用できます:

489 573 


496 580 

497> **重要:** メッセージを反復処理する場合、早期に終了するために `break` を使用することは避けてください。これは asyncio クリーンアップの問題を引き起こす可能性があります。代わりに、反復を自然に完了させるか、フラグを使用して必要なものを見つけたときを追跡してください。581> **重要:** メッセージを反復処理する場合、早期に終了するために `break` を使用することは避けてください。これは asyncio クリーンアップの問題を引き起こす可能性があります。代わりに、反復を自然に完了させるか、フラグを使用して必要なものを見つけたときを追跡してください。

498 582 

499#### 例 - 会話を続ける583<h4 id="example-continuing-a-conversation">

584 例 - 会話を続ける

585</h4>

500 586 

501```python theme={null}587```python theme={null}

502import asyncio588import asyncio


537asyncio.run(main())623asyncio.run(main())

538```624```

539 625 

540#### 例 - ClaudeSDKClient でのストリーミング入力626<h4 id="example-streaming-input-with-claudesdkclient">

627 例 - ClaudeSDKClient でのストリーミング入力

628</h4>

541 629 

542```python theme={null}630```python theme={null}

543import asyncio631import asyncio


581asyncio.run(main())669asyncio.run(main())

582```670```

583 671 

584#### 例 - 割り込みの使用672<h4 id="example-using-interrupts">

673 例 - 割り込みの使用

674</h4>

585 675 

586```python theme={null}676```python theme={null}

587import asyncio677import asyncio


624 **割り込み後のバッファ動作:** `interrupt()` は停止信号を送信しますが、メッセージバッファをクリアしません。割り込まれたタスクによって既に生成されたメッセージ(`subtype="error_during_execution"` の `ResultMessage` を含む)はストリームに残ります。新しいクエリの応答を読む前に、`receive_response()` でそれらをドレインする必要があります。`interrupt()` の直後に新しいクエリを送信し、`receive_response()` を 1 回だけ呼び出すと、割り込まれたタスクのメッセージが受け取られ、新しいクエリの応答ではありません。714 **割り込み後のバッファ動作:** `interrupt()` は停止信号を送信しますが、メッセージバッファをクリアしません。割り込まれたタスクによって既に生成されたメッセージ(`subtype="error_during_execution"` の `ResultMessage` を含む)はストリームに残ります。新しいクエリの応答を読む前に、`receive_response()` でそれらをドレインする必要があります。`interrupt()` の直後に新しいクエリを送信し、`receive_response()` を 1 回だけ呼び出すと、割り込まれたタスクのメッセージが受け取られ、新しいクエリの応答ではありません。

625</Note>715</Note>

626 716 

627#### 例 - 高度なパーミッション制御717<h4 id="example-advanced-permission-control">

718 例 - 高度なパーミッション制御

719</h4>

628 720 

629```python theme={null}721```python theme={null}

630from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions722from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions


673asyncio.run(main())765asyncio.run(main())

674```766```

675 767 

676## 768<h2 id="types">

769

770</h2>

677 771 

678<Note>772<Note>

679 **`@dataclass` vs `TypedDict`:** この SDK は 2 種類の型を使用します。`@dataclass` で装飾されたクラス(`ResultMessage`、`AgentDefinition`、`TextBlock` など)は実行時にオブジェクトインスタンスであり、属性アクセスをサポートします:`msg.result`。`TypedDict` で定義されたクラス(`ThinkingConfigEnabled`、`McpStdioServerConfig`、`SyncHookJSONOutput` など)は**実行時にプレーンな dict** であり、キーアクセスが必要です:`config["budget_tokens"]`、`config.budget_tokens` ではなく。`ClassName(field=value)` 呼び出し構文は両方で機能しますが、dataclass のみが属性を持つオブジェクトを生成します。773 **`@dataclass` vs `TypedDict`:** この SDK は 2 種類の型を使用します。`@dataclass` で装飾されたクラス(`ResultMessage`、`AgentDefinition`、`TextBlock` など)は実行時にオブジェクトインスタンスであり、属性アクセスをサポートします:`msg.result`。`TypedDict` で定義されたクラス(`ThinkingConfigEnabled`、`McpStdioServerConfig`、`SyncHookJSONOutput` など)は**実行時にプレーンな dict** であり、キーアクセスが必要です:`config["budget_tokens"]`、`config.budget_tokens` ではなく。`ClassName(field=value)` 呼び出し構文は両方で機能しますが、dataclass のみが属性を持つオブジェクトを生成します。

680</Note>774</Note>

681 775 

682### `SdkMcpTool`776<h3 id="sdkmcptool">

777 `SdkMcpTool`

778</h3>

683 779 

684`@tool` デコレータで作成された SDK MCP ツールの定義。780`@tool` デコレータで作成された SDK MCP ツールの定義。

685 781 


701| `handler` | `Callable[[T], Awaitable[dict[str, Any]]]` | ツール実行を処理する非同期関数 |797| `handler` | `Callable[[T], Awaitable[dict[str, Any]]]` | ツール実行を処理する非同期関数 |

702| `annotations` | `ToolAnnotations \| None` | オプションの MCP ツールアノテーション(例:`readOnlyHint`、`destructiveHint`、`openWorldHint`)。`mcp.types` から |798| `annotations` | `ToolAnnotations \| None` | オプションの MCP ツールアノテーション(例:`readOnlyHint`、`destructiveHint`、`openWorldHint`)。`mcp.types` から |

703 799 

704### `Transport`800<h3 id="transport">

801 `Transport`

802</h3>

705 803 

706カスタムトランスポート実装の抽象基本クラス。これを使用して、カスタムチャネル(例:ローカルサブプロセスの代わりにリモート接続)を介して Claude プロセスと通信します。804カスタムトランスポート実装の抽象基本クラス。これを使用して、カスタムチャネル(例:ローカルサブプロセスの代わりにリモート接続)を介して Claude プロセスと通信します。

707 805 


746 844 

747インポート:`from claude_agent_sdk import Transport`845インポート:`from claude_agent_sdk import Transport`

748 846 

749### `ClaudeAgentOptions`847<h3 id="claudeagentoptions">

848 `ClaudeAgentOptions`

849</h3>

750 850 

751Claude Code クエリの設定 dataclass。851Claude Code クエリの設定 dataclass。

752 852 


810| `max_budget_usd` | `float \| None` | `None` | クライアント側のコスト推定がこの USD 値に達したときにクエリを停止します。`total_cost_usd` と同じ推定と比較されます。[コストと使用状況を追跡](/ja/agent-sdk/cost-tracking) で精度の注意事項を参照 |910| `max_budget_usd` | `float \| None` | `None` | クライアント側のコスト推定がこの USD 値に達したときにクエリを停止します。`total_cost_usd` と同じ推定と比較されます。[コストと使用状況を追跡](/ja/agent-sdk/cost-tracking) で精度の注意事項を参照 |

811| `disallowed_tools` | `list[str]` | `[]` | 拒否するツール。`Bash` などの単純な名前はツールを Claude のコンテキストから削除します。`Bash(rm *)` などのスコープ付きルールはツールを利用可能なままにし、`bypassPermissions` を含むすべてのパーミッションモードで一致する呼び出しを拒否します。[パーミッション](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照 |911| `disallowed_tools` | `list[str]` | `[]` | 拒否するツール。`Bash` などの単純な名前はツールを Claude のコンテキストから削除します。`Bash(rm *)` などのスコープ付きルールはツールを利用可能なままにし、`bypassPermissions` を含むすべてのパーミッションモードで一致する呼び出しを拒否します。[パーミッション](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照 |

812| `enable_file_checkpointing` | `bool` | `False` | ファイル変更追跡を有効にして巻き戻しを可能にします。[ファイルチェックポイント](/ja/agent-sdk/file-checkpointing) を参照 |912| `enable_file_checkpointing` | `bool` | `False` | ファイル変更追跡を有効にして巻き戻しを可能にします。[ファイルチェックポイント](/ja/agent-sdk/file-checkpointing) を参照 |

813| `model` | `str \| None` | `None` | 使用する Claude モデル |913| `model` | `str \| None` | `None` | Claude モデルエイリアスまたは完全なモデル名。[受け入れられた値とプロバイダー固有の ID](/ja/model-config#available-models) を参照 |

814| `fallback_model` | `str \| None` | `None` | プライマリモデルが失敗した場合に使用するフォールバックモデル |914| `fallback_model` | `str \| None` | `None` | プライマリモデルが失敗した場合に使用するフォールバックモデル |

815| `betas` | `list[SdkBeta]` | `[]` | 有効にするベータ機能。利用可能なオプションについては [`SdkBeta`](#sdkbeta) を参照 |915| `betas` | `list[SdkBeta]` | `[]` | 有効にするベータ機能。利用可能なオプションについては [`SdkBeta`](#sdkbeta) を参照 |

816| `output_format` | `dict[str, Any] \| None` | `None` | 構造化応答の出力形式(例:`{"type": "json_schema", "schema": {...}}`)。詳細については [構造化出力](/ja/agent-sdk/structured-outputs) を参照 |916| `output_format` | `dict[str, Any] \| None` | `None` | 構造化応答の出力形式(例:`{"type": "json_schema", "schema": {...}}`)。詳細については [構造化出力](/ja/agent-sdk/structured-outputs) を参照 |


837| `skills` | `list[str] \| Literal["all"] \| None` | `None` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `"all"` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowed_tools` にリストしなくても Skill ツールを自動的に有効にします。[スキル](/ja/agent-sdk/skills) を参照 |937| `skills` | `list[str] \| Literal["all"] \| None` | `None` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `"all"` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowed_tools` にリストしなくても Skill ツールを自動的に有効にします。[スキル](/ja/agent-sdk/skills) を参照 |

838| `max_thinking_tokens` | `int \| None` | `None` | *非推奨* - 思考ブロックの最大トークン数。代わりに `thinking` を使用してください |938| `max_thinking_tokens` | `int \| None` | `None` | *非推奨* - 思考ブロックの最大トークン数。代わりに `thinking` を使用してください |

839| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | 拡張思考動作を制御します。`max_thinking_tokens` より優先されます |939| `thinking` | [`ThinkingConfig`](#thinkingconfig) ` \| None` | `None` | 拡張思考動作を制御します。`max_thinking_tokens` より優先されます |

840| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | 思考の深さの努力レベル |940| `effort` | [`EffortLevel`](#effortlevel) ` \| None` | `None` | 思考の深さの努力レベル。[努力レベルを調整](/ja/model-config#adjust-effort-level) を参照 |

841| `session_store` | [`SessionStore`](/ja/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | セッショントランスクリプトを外部バックエンドにミラーリングして、任意のホストがそれらを再開できるようにします。[セッションを外部ストレージに永続化](/ja/agent-sdk/session-storage) を参照 |941| `session_store` | [`SessionStore`](/ja/agent-sdk/session-storage#the-sessionstore-interface) ` \| None` | `None` | セッショントランスクリプトを外部バックエンドにミラーリングして、任意のホストがそれらを再開できるようにします。[セッションを外部ストレージに永続化](/ja/agent-sdk/session-storage) を参照 |

842| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | ミラーリングされたトランスクリプトエントリを `session_store` にフラッシュするタイミング。`"batched"` はターンごと、またはバッファが満杯になったときにフラッシュします。`"eager"` はすべてのフレームの後にバックグラウンドフラッシュをトリガーします。`session_store` が `None` の場合は無視されます |942| `session_store_flush` | `Literal["batched", "eager"]` | `"batched"` | ミラーリングされたトランスクリプトエントリを `session_store` にフラッシュするタイミング。`"batched"` はターンごと、またはバッファが満杯になったときにフラッシュします。`"eager"` はすべてのフレームの後にバックグラウンドフラッシュをトリガーします。`session_store` が `None` の場合は無視されます |

843 943 

844#### 遅いまたは停止した API レスポンスを処理944<h4 id="handle-slow-or-stalled-api-responses">

945 遅いまたは停止した API レスポンスを処理

946</h4>

845 947 

846CLI サブプロセスは、API タイムアウトと停止検出を制御するいくつかの環境変数を読み込みます。`ClaudeAgentOptions.env` を通じてそれらを渡します:948CLI サブプロセスは、API タイムアウトと停止検出を制御するいくつかの環境変数を読み込みます。`ClaudeAgentOptions.env` を通じてそれらを渡します:

847 949 


858* `API_TIMEOUT_MS`:Anthropic クライアントのリクエストごとのタイムアウト(ミリ秒単位)。デフォルト `600000`。メインループとすべてのサブエージェントに適用されます。960* `API_TIMEOUT_MS`:Anthropic クライアントのリクエストごとのタイムアウト(ミリ秒単位)。デフォルト `600000`。メインループとすべてのサブエージェントに適用されます。

859* `CLAUDE_CODE_MAX_RETRIES`:最大 API リトライ数。デフォルト `10`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の実時間はおおよそ `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。961* `CLAUDE_CODE_MAX_RETRIES`:最大 API リトライ数。デフォルト `10`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の実時間はおおよそ `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。

860* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`:`run_in_background` で起動されたサブエージェント用の停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。962* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`:`run_in_background` で起動されたサブエージェント用の停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。

861* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`:ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。デフォルトではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルト `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。963* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`:ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。`CLAUDE_ENABLE_STREAM_WATCHDOG` が設定されていない場合、デフォルトは直接 Anthropic API ではサーバー制御、他のプロバイダーではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルト `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。

862 964 

863### `OutputFormat`965<h3 id="outputformat">

966 `OutputFormat`

967</h3>

864 968 

865構造化出力検証の設定。これを `ClaudeAgentOptions` の `output_format` フィールドに dict として渡します:969構造化出力検証の設定。これを `ClaudeAgentOptions` の `output_format` フィールドに dict として渡します:

866 970 


877| `type` | はい | JSON Schema 検証の場合は `"json_schema"` である必要があります |981| `type` | はい | JSON Schema 検証の場合は `"json_schema"` である必要があります |

878| `schema` | はい | 出力検証用の JSON Schema 定義 |982| `schema` | はい | 出力検証用の JSON Schema 定義 |

879 983 

880### `SystemPromptPreset`984<h3 id="systempromptpreset">

985 `SystemPromptPreset`

986</h3>

881 987 

882オプションの追加を含む Claude Code のプリセットシステムプロンプトを使用するための設定。988オプションの追加を含む Claude Code のプリセットシステムプロンプトを使用するための設定。

883 989 


896| `append` | いいえ | プリセットシステムプロンプトに追加する追加の指示 |1002| `append` | いいえ | プリセットシステムプロンプトに追加する追加の指示 |

897| `exclude_dynamic_sections` | いいえ | 作業ディレクトリ、git リポジトリフラグ、自動メモリパスなどのセッションごとのコンテキストをシステムプロンプトから最初のユーザーメッセージに移動します。ユーザーとマシン全体でのプロンプトキャッシュの再利用を改善します。[システムプロンプトを変更](/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) を参照 |1003| `exclude_dynamic_sections` | いいえ | 作業ディレクトリ、git リポジトリフラグ、自動メモリパスなどのセッションごとのコンテキストをシステムプロンプトから最初のユーザーメッセージに移動します。ユーザーとマシン全体でのプロンプトキャッシュの再利用を改善します。[システムプロンプトを変更](/ja/agent-sdk/modifying-system-prompts#improve-prompt-caching-across-users-and-machines) を参照 |

898 1004 

899### `SettingSource`1005<h3 id="settingsource">

1006 `SettingSource`

1007</h3>

900 1008 

901SDK が設定を読み込むファイルシステムベースの設定ソースを制御します。1009SDK が設定を読み込むファイルシステムベースの設定ソースを制御します。

902 1010 


910| `"project"` | 共有プロジェクト設定(バージョン管理) | `.claude/settings.json` |1018| `"project"` | 共有プロジェクト設定(バージョン管理) | `.claude/settings.json` |

911| `"local"` | ローカルプロジェクト設定(gitignored) | `.claude/settings.local.json` |1019| `"local"` | ローカルプロジェクト設定(gitignored) | `.claude/settings.local.json` |

912 1020 

913#### デフォルト動作1021<h4 id="default-behavior">

1022 デフォルト動作

1023</h4>

914 1024 

915`setting_sources` が省略されるか `None` の場合、`query()` は Claude Code CLI と同じファイルシステム設定を読み込みます:ユーザー、プロジェクト、ローカル。管理ポリシー設定はすべての場合に読み込まれます。このオプションに関係なく読み込まれる入力については [settingSources が制御しないもの](/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照し、それらを無効にする方法を参照してください。1025`setting_sources` が省略されるか `None` の場合、`query()` は Claude Code CLI と同じファイルシステム設定を読み込みます:ユーザー、プロジェクト、ローカル。管理ポリシー設定はすべての場合に読み込まれます。このオプションに関係なく読み込まれる入力については [settingSources が制御しないもの](/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照し、それらを無効にする方法を参照してください。

916 1026 

917#### setting\_sources を使用する理由1027<h4 id="why-use-setting_sources">

1028 setting\_sources を使用する理由

1029</h4>

918 1030 

919**ファイルシステム設定を無効にする:**1031**ファイルシステム設定を無効にする:**

920 1032 


1011 print(message)1123 print(message)

1012```1124```

1013 1125 

1014#### 設定の優先順位1126<h4 id="settings-precedence">

1127 設定の優先順位

1128</h4>

1015 1129 

1016複数のソースが読み込まれる場合、設定はこの優先順位(最高から最低)でマージされます:1130複数のソースが読み込まれる場合、設定はこの優先順位(最高から最低)でマージされます:

1017 1131 


1021 1135 

1022`agents` と `allowed_tools` などのプログラム的なオプションは、ユーザー、プロジェクト、ローカルのファイルシステム設定をオーバーライドします。管理ポリシー設定はプログラム的なオプションより優先されます。1136`agents` と `allowed_tools` などのプログラム的なオプションは、ユーザー、プロジェクト、ローカルのファイルシステム設定をオーバーライドします。管理ポリシー設定はプログラム的なオプションより優先されます。

1023 1137 

1024### `AgentDefinition`1138<h3 id="agentdefinition">

1139 `AgentDefinition`

1140</h3>

1025 1141 

1026プログラムで定義されたサブエージェントの設定。1142プログラムで定義されたサブエージェントの設定。

1027 1143 


1044```1160```

1045 1161 

1046| フィールド | 必須 | 説明 |1162| フィールド | 必須 | 説明 |

1047| :---------------- | :-- | :-------------------------------------------------------------------------------------------------------------- |1163| :---------------- | :-- | :-------------------------------------------------------------------------------------------------------------------------------------------------- |

1048| `description` | はい | このエージェントを使用する場合の自然言語説明 |1164| `description` | はい | このエージェントを使用する場合の自然言語説明 |

1049| `prompt` | はい | エージェントのシステムプロンプト |1165| `prompt` | はい | エージェントのシステムプロンプト |

1050| `tools` | いいえ | 許可されたツール名の配列。省略した場合、すべてのツールを継承します |1166| `tools` | いいえ | 許可されたツール名の配列。省略した場合、すべてのツールを継承します |

1051| `disallowedTools` | いいえ | エージェントのツールセットから削除するツール名の配列 |1167| `disallowedTools` | いいえ | エージェントのツールセットから削除するツール名の配列。MCP サーバーレベルのパターンも受け入れられます:`mcp__server` または `mcp__server__*` はそのサーバーからすべてのツールを削除し、`mcp__*` はすべてのサーバーからすべての MCP ツールを削除します |

1052| `model` | いいえ | このエージェントのモデルオーバーライド。`"sonnet"`、`"opus"`、`"haiku"`、`"inherit"` などのエイリアス、または完全なモデル ID を受け入れます。省略した場合、メインモデルを使用します |1168| `model` | いいえ | このエージェントのモデルオーバーライド。`"sonnet"`、`"opus"`、`"haiku"`、`"inherit"` などのエイリアス、または完全なモデル ID を受け入れます。省略した場合、メインモデルを使用します |

1053| `skills` | いいえ | このエージェントが利用可能なスキル名のリスト |1169| `skills` | いいえ | このエージェントが起動時にコンテキストにプリロードするスキル名のリスト。リストされていないスキルは Skill ツールを通じて呼び出し可能なままです |

1054| `memory` | いいえ | このエージェントのメモリソース:`"user"`、`"project"`、または `"local"` |1170| `memory` | いいえ | このエージェントのメモリソース:`"user"`、`"project"`、または `"local"` |

1055| `mcpServers` | いいえ | このエージェントが利用可能な MCP サーバー。各エントリはサーバー名またはインライン `{name: config}` dict です |1171| `mcpServers` | いいえ | このエージェントが利用可能な MCP サーバー。各エントリはサーバー名またはインライン `{name: config}` dict です |

1056| `initialPrompt` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます |1172| `initialPrompt` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます |


1063 `AgentDefinition` フィールド名は `disallowedTools`、`permissionMode`、`maxTurns` などの camelCase を使用します。これらの名前は TypeScript SDK と共有される wire 形式に直接マップされます。これは `disallowed_tools` と `permission_mode` などの同等のトップレベルフィールドに Python snake\_case を使用する `ClaudeAgentOptions` とは異なります。`AgentDefinition` は dataclass であるため、snake\_case キーワードを渡すと構築時に `TypeError` が発生します。1179 `AgentDefinition` フィールド名は `disallowedTools`、`permissionMode`、`maxTurns` などの camelCase を使用します。これらの名前は TypeScript SDK と共有される wire 形式に直接マップされます。これは `disallowed_tools` と `permission_mode` などの同等のトップレベルフィールドに Python snake\_case を使用する `ClaudeAgentOptions` とは異なります。`AgentDefinition` は dataclass であるため、snake\_case キーワードを渡すと構築時に `TypeError` が発生します。

1064</Note>1180</Note>

1065 1181 

1066### `PermissionMode`1182<h3 id="permissionmode">

1183 `PermissionMode`

1184</h3>

1067 1185 

1068ツール実行を制御するためのパーミッションモード。1186ツール実行を制御するためのパーミッションモード。

1069 1187 


1071PermissionMode = Literal[1189PermissionMode = Literal[

1072 "default", # Standard permission behavior1190 "default", # Standard permission behavior

1073 "acceptEdits", # Auto-accept file edits1191 "acceptEdits", # Auto-accept file edits

1074 "plan", # Planning mode - read-only tools only1192 "plan", # Planning mode - explore without editing

1075 "dontAsk", # Deny anything not pre-approved instead of prompting1193 "dontAsk", # Deny anything not pre-approved instead of prompting

1076 "bypassPermissions", # Bypass all permission checks (use with caution)1194 "bypassPermissions", # Bypass permission checks; explicit ask rules still prompt (use with caution)

1077]1195]

1078```1196```

1079 1197 

1080### `EffortLevel`1198<h3 id="effortlevel">

1199 `EffortLevel`

1200</h3>

1081 1201 

1082思考の深さを導くための努力レベル。1202思考の深さを導くための努力レベル。

1083 1203 


1086 "low", # Minimal thinking, fastest responses1206 "low", # Minimal thinking, fastest responses

1087 "medium", # Moderate thinking1207 "medium", # Moderate thinking

1088 "high", # Deep reasoning1208 "high", # Deep reasoning

1089 "xhigh", # Extended reasoning (Opus 4.7 only; falls back to "high" on other models)1209 "xhigh", # Extended reasoning (Opus 4.8 and Opus 4.7; falls back to "high" on other models)

1090 "max", # Maximum effort1210 "max", # Maximum effort

1091]1211]

1092```1212```

1093 1213 

1094### `CanUseTool`1214<h3 id="canusetool">

1215 `CanUseTool`

1216</h3>

1095 1217 

1096ツールパーミッションコールバック関数の型エイリアス。1218ツールパーミッションコールバック関数の型エイリアス。

1097 1219 


1109 1231 

1110`PermissionResult`(`PermissionResultAllow` または `PermissionResultDeny`)を返します。1232`PermissionResult`(`PermissionResultAllow` または `PermissionResultDeny`)を返します。

1111 1233 

1112### `ToolPermissionContext`1234<h3 id="toolpermissioncontext">

1235 `ToolPermissionContext`

1236</h3>

1113 1237 

1114ツールパーミッションコールバックに渡されるコンテキスト情報。1238ツールパーミッションコールバックに渡されるコンテキスト情報。

1115 1239 


1135| `display_name` | `str \| None` | ツールアクション用の短い名詞句。例えば、`Read file`。ボタンラベルに適しています |1259| `display_name` | `str \| None` | ツールアクション用の短い名詞句。例えば、`Read file`。ボタンラベルに適しています |

1136| `description` | `str \| None` | パーミッション UI 用の人間が読める字幕 |1260| `description` | `str \| None` | パーミッション UI 用の人間が読める字幕 |

1137 1261 

1138### `PermissionResult`1262<h3 id="permissionresult">

1263 `PermissionResult`

1264</h3>

1139 1265 

1140パーミッションコールバック結果の Union 型。1266パーミッションコールバック結果の Union 型。

1141 1267 


1143PermissionResult = PermissionResultAllow | PermissionResultDeny1269PermissionResult = PermissionResultAllow | PermissionResultDeny

1144```1270```

1145 1271 

1146### `PermissionResultAllow`1272<h3 id="permissionresultallow">

1273 `PermissionResultAllow`

1274</h3>

1147 1275 

1148ツール呼び出しを許可すべきことを示す結果。1276ツール呼び出しを許可すべきことを示す結果。

1149 1277 


1161| `updated_input` | `dict[str, Any] \| None` | `None` | 元の代わりに使用する変更された入力 |1289| `updated_input` | `dict[str, Any] \| None` | `None` | 元の代わりに使用する変更された入力 |

1162| `updated_permissions` | `list[PermissionUpdate] \| None` | `None` | 適用するパーミッション更新 |1290| `updated_permissions` | `list[PermissionUpdate] \| None` | `None` | 適用するパーミッション更新 |

1163 1291 

1164### `PermissionResultDeny`1292<h3 id="permissionresultdeny">

1293 `PermissionResultDeny`

1294</h3>

1165 1295 

1166ツール呼び出しを拒否すべきことを示す結果。1296ツール呼び出しを拒否すべきことを示す結果。

1167 1297 


1179| `message` | `str` | `""` | ツールが拒否された理由を説明するメッセージ |1309| `message` | `str` | `""` | ツールが拒否された理由を説明するメッセージ |

1180| `interrupt` | `bool` | `False` | 現在の実行を割り込むかどうか |1310| `interrupt` | `bool` | `False` | 現在の実行を割り込むかどうか |

1181 1311 

1182### `PermissionUpdate`1312<h3 id="permissionupdate">

1313 `PermissionUpdate`

1314</h3>

1183 1315 

1184プログラムでパーミッションを更新するための設定。1316プログラムでパーミッションを更新するための設定。

1185 1317 


1212| `directories` | `list[str] \| None` | ディレクトリ追加/削除操作用のディレクトリ |1344| `directories` | `list[str] \| None` | ディレクトリ追加/削除操作用のディレクトリ |

1213| `destination` | `Literal[...] \| None` | パーミッション更新を適用する場所 |1345| `destination` | `Literal[...] \| None` | パーミッション更新を適用する場所 |

1214 1346 

1215### `PermissionRuleValue`1347<h3 id="permissionrulevalue">

1348 `PermissionRuleValue`

1349</h3>

1216 1350 

1217パーミッション更新で追加、置換、または削除するルール。1351パーミッション更新で追加、置換、または削除するルール。

1218 1352 


1223 rule_content: str | None = None1357 rule_content: str | None = None

1224```1358```

1225 1359 

1226### `ToolsPreset`1360<h3 id="toolspreset">

1361 `ToolsPreset`

1362</h3>

1227 1363 

1228Claude Code のデフォルトツールセットを使用するためのプリセットツール設定。1364Claude Code のデフォルトツールセットを使用するためのプリセットツール設定。

1229 1365 


1233 preset: Literal["claude_code"]1369 preset: Literal["claude_code"]

1234```1370```

1235 1371 

1236### `ThinkingConfig`1372<h3 id="thinkingconfig">

1373 `ThinkingConfig`

1374</h3>

1237 1375 

1238拡張思考動作を制御します。3 つの設定の Union:1376拡張思考動作を制御します。3 つの設定の Union:

1239 1377 


1281# config.budget_tokens would raise AttributeError1419# config.budget_tokens would raise AttributeError

1282```1420```

1283 1421 

1284### `SdkBeta`1422<h3 id="sdkbeta">

1423 `SdkBeta`

1424</h3>

1285 1425 

1286SDK ベータ機能の Literal 型。1426SDK ベータ機能の Literal 型。

1287 1427 


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

1293 1433 

1294<Warning>1434<Warning>

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

1296</Warning>1436</Warning>

1297 1437 

1298### `McpSdkServerConfig`1438<h3 id="mcpsdkserverconfig">

1439 `McpSdkServerConfig`

1440</h3>

1299 1441 

1300`create_sdk_mcp_server()` で作成された SDK MCP サーバーの設定。1442`create_sdk_mcp_server()` で作成された SDK MCP サーバーの設定。

1301 1443 


1306 instance: Any # MCP Server instance1448 instance: Any # MCP Server instance

1307```1449```

1308 1450 

1309### `McpServerConfig`1451<h3 id="mcpserverconfig">

1452 `McpServerConfig`

1453</h3>

1310 1454 

1311MCP サーバー設定の Union 型。1455MCP サーバー設定の Union 型。

1312 1456 


1316)1460)

1317```1461```

1318 1462 

1319#### `McpStdioServerConfig`1463<h4 id="mcpstdioserverconfig">

1464 `McpStdioServerConfig`

1465</h4>

1320 1466 

1321```python theme={null}1467```python theme={null}

1322class McpStdioServerConfig(TypedDict):1468class McpStdioServerConfig(TypedDict):


1326 env: NotRequired[dict[str, str]]1472 env: NotRequired[dict[str, str]]

1327```1473```

1328 1474 

1329#### `McpSSEServerConfig`1475<h4 id="mcpsseserverconfig">

1476 `McpSSEServerConfig`

1477</h4>

1330 1478 

1331```python theme={null}1479```python theme={null}

1332class McpSSEServerConfig(TypedDict):1480class McpSSEServerConfig(TypedDict):


1335 headers: NotRequired[dict[str, str]]1483 headers: NotRequired[dict[str, str]]

1336```1484```

1337 1485 

1338#### `McpHttpServerConfig`1486<h4 id="mcphttpserverconfig">

1487 `McpHttpServerConfig`

1488</h4>

1339 1489 

1340```python theme={null}1490```python theme={null}

1341class McpHttpServerConfig(TypedDict):1491class McpHttpServerConfig(TypedDict):


1344 headers: NotRequired[dict[str, str]]1494 headers: NotRequired[dict[str, str]]

1345```1495```

1346 1496 

1347### `McpServerStatusConfig`1497<h3 id="mcpserverstatusconfig">

1498 `McpServerStatusConfig`

1499</h3>

1348 1500 

1349[`get_mcp_status()`](#methods) によって報告される MCP サーバーの設定。これは、すべての [`McpServerConfig`](#mcpserverconfig) トランスポートバリアント、および claude.ai を通じてプロキシされるサーバー用の出力のみの `claudeai-proxy` バリアントの Union です。1501[`get_mcp_status()`](#methods) によって報告される MCP サーバーの設定。これは、すべての [`McpServerConfig`](#mcpserverconfig) トランスポートバリアント、および claude.ai を通じてプロキシされるサーバー用の出力のみの `claudeai-proxy` バリアントの Union です。

1350 1502 


1360 1512 

1361`McpSdkServerConfigStatus` は [`McpSdkServerConfig`](#mcpsdkserverconfig) のシリアライズ可能な形式で、`type`(`"sdk"`)と `name`(`str`)フィールドのみです。インプロセス `instance` は省略されます。`McpClaudeAIProxyServerConfig` には `type`(`"claudeai-proxy"`)、`url`(`str`)、`id`(`str`)フィールドがあります。1513`McpSdkServerConfigStatus` は [`McpSdkServerConfig`](#mcpsdkserverconfig) のシリアライズ可能な形式で、`type`(`"sdk"`)と `name`(`str`)フィールドのみです。インプロセス `instance` は省略されます。`McpClaudeAIProxyServerConfig` には `type`(`"claudeai-proxy"`)、`url`(`str`)、`id`(`str`)フィールドがあります。

1362 1514 

1363### `McpStatusResponse`1515<h3 id="mcpstatusresponse">

1516 `McpStatusResponse`

1517</h3>

1364 1518 

1365[`ClaudeSDKClient.get_mcp_status()`](#methods) からの応答。サーバーステータスのリストを `mcpServers` キーの下にラップします。1519[`ClaudeSDKClient.get_mcp_status()`](#methods) からの応答。サーバーステータスのリストを `mcpServers` キーの下にラップします。

1366 1520 


1369 mcpServers: list[McpServerStatus]1523 mcpServers: list[McpServerStatus]

1370```1524```

1371 1525 

1372### `McpServerStatus`1526<h3 id="mcpserverstatus">

1527 `McpServerStatus`

1528</h3>

1373 1529 

1374接続された MCP サーバーのステータス。[`McpStatusResponse`](#mcpstatusresponse) に含まれます。1530接続された MCP サーバーのステータス。[`McpStatusResponse`](#mcpstatusresponse) に含まれます。

1375 1531 


1394| `scope` | `str`(オプション) | 設定スコープ |1550| `scope` | `str`(オプション) | 設定スコープ |

1395| `tools` | `list`(オプション) | このサーバーが提供するツール。各ツールには `name`、`description`、`annotations` フィールドがあります |1551| `tools` | `list`(オプション) | このサーバーが提供するツール。各ツールには `name`、`description`、`annotations` フィールドがあります |

1396 1552 

1397### `SdkPluginConfig`1553<h3 id="sdkpluginconfig">

1554 `SdkPluginConfig`

1555</h3>

1398 1556 

1399SDK でプラグインを読み込むための設定。1557SDK でプラグインを読み込むための設定。

1400 1558 


1420 1578 

1421プラグインの作成と使用に関する完全な情報については、[プラグイン](/ja/agent-sdk/plugins) を参照してください。1579プラグインの作成と使用に関する完全な情報については、[プラグイン](/ja/agent-sdk/plugins) を参照してください。

1422 1580 

1423## メッセージ型1581<h2 id="message-types">

1582 メッセージ型

1583</h2>

1424 1584 

1425### `Message`1585<h3 id="message">

1586 `Message`

1587</h3>

1426 1588 

1427すべての可能なメッセージの Union 型。1589すべての可能なメッセージの Union 型。

1428 1590 


1437)1599)

1438```1600```

1439 1601 

1440### `UserMessage`1602<h3 id="usermessage">

1603 `UserMessage`

1604</h3>

1441 1605 

1442ユーザー入力メッセージ。1606ユーザー入力メッセージ。

1443 1607 


1457| `parent_tool_use_id` | `str \| None` | このメッセージがツール結果応答の場合のツール使用 ID |1621| `parent_tool_use_id` | `str \| None` | このメッセージがツール結果応答の場合のツール使用 ID |

1458| `tool_use_result` | `dict[str, Any] \| None` | 該当する場合のツール結果データ |1622| `tool_use_result` | `dict[str, Any] \| None` | 該当する場合のツール結果データ |

1459 1623 

1460### `AssistantMessage`1624<h3 id="assistantmessage">

1625 `AssistantMessage`

1626</h3>

1461 1627 

1462コンテンツブロック付きのアシスタント応答メッセージ。1628コンテンツブロック付きのアシスタント応答メッセージ。

1463 1629 


1481| `usage` | `dict[str, Any] \| None` | メッセージごとのトークン使用状況([`ResultMessage.usage`](#resultmessage) と同じキー) |1647| `usage` | `dict[str, Any] \| None` | メッセージごとのトークン使用状況([`ResultMessage.usage`](#resultmessage) と同じキー) |

1482| `message_id` | `str \| None` | API メッセージ ID。1 つのターンからの複数のメッセージは同じ ID を共有します |1648| `message_id` | `str \| None` | API メッセージ ID。1 つのターンからの複数のメッセージは同じ ID を共有します |

1483 1649 

1484### `AssistantMessageError`1650<h3 id="assistantmessageerror">

1651 `AssistantMessageError`

1652</h3>

1485 1653 

1486アシスタントメッセージの可能なエラータイプ。1654アシスタントメッセージの可能なエラータイプ。

1487 1655 


1497]1665]

1498```1666```

1499 1667 

1500### `SystemMessage`1668<h3 id="systemmessage">

1669 `SystemMessage`

1670</h3>

1501 1671 

1502メタデータ付きのシステムメッセージ。1672メタデータ付きのシステムメッセージ。

1503 1673 


1508 data: dict[str, Any]1678 data: dict[str, Any]

1509```1679```

1510 1680 

1511### `ResultMessage`1681<h3 id="resultmessage">

1682 `ResultMessage`

1683</h3>

1512 1684 

1513コストと使用状況情報を含む最終結果メッセージ。1685コストと使用状況情報を含む最終結果メッセージ。

1514 1686 


1534 uuid: str | None = None1706 uuid: str | None = None

1535```1707```

1536 1708 

1709`subtype` フィールドは、他のどのフィールドが入力されるかを決定します。これは `"success"`、`"error_during_execution"`、`"error_max_turns"`、`"error_max_budget_usd"`、または `"error_max_structured_output_retries"` のいずれかです。Python データクラスはすべてのバリアントを 1 つの形状にフラット化するため、返された subtype に適用されないフィールドは `None` です。

1710 

1711会話がエラーで終了する場合、いくつかのフィールドは診断の詳細を含みます:

1712 

1713* `is_error`:会話がエラー状態で終了した場合は `True`。`error_*` サブタイプでは常に `True`。`subtype="success"` では、最終モデルリクエストが失敗した場合は `True`。つまり、エージェントループが完了しましたが、最後の API 呼び出しがエラーを返しました。

1714* `api_error_status`:終了する API エラーの HTTP ステータスコード。ターンがエラーなしで終了した場合は `None`。`subtype="success"` でのみ入力されます。

1715* `result`:`subtype="success"` での最終アシスタントメッセージのテキスト、または `error_*` サブタイプでは `None`。`subtype="success"` で `is_error=True` の場合、これは利用可能な場合は API エラー文字列を保持しますが、空の場合もあるため、`api_error_status` と前の `AssistantMessage` コンテンツで詳細を確認してください。

1716* `errors`:最大ターンメッセージなどのループレベルのエラー文字列。`error_*` サブタイプでのみ入力されます。

1717 

1537`usage` dict には、存在する場合、以下のキーが含まれます:1718`usage` dict には、存在する場合、以下のキーが含まれます:

1538 1719 

1539| キー | 型 | 説明 |1720| キー | 型 | 説明 |


1556| `contextWindow` | `int` | このモデルのコンテキストウィンドウサイズ。 |1737| `contextWindow` | `int` | このモデルのコンテキストウィンドウサイズ。 |

1557| `maxOutputTokens` | `int` | このモデルの最大出力トークン制限。 |1738| `maxOutputTokens` | `int` | このモデルの最大出力トークン制限。 |

1558 1739 

1559### `StreamEvent`1740<h3 id="streamevent">

1741 `StreamEvent`

1742</h3>

1560 1743 

1561ストリーミング中の部分的なメッセージ更新のためのストリームイベント。`ClaudeAgentOptions` で `include_partial_messages=True` の場合のみ受け取られます。`from claude_agent_sdk.types import StreamEvent` でインポートしてください。1744ストリーミング中の部分的なメッセージ更新のためのストリームイベント。`ClaudeAgentOptions` で `include_partial_messages=True` の場合のみ受け取られます。`from claude_agent_sdk.types import StreamEvent` でインポートしてください。

1562 1745 


1576| `event` | `dict[str, Any]` | 生の Claude API ストリームイベントデータ |1759| `event` | `dict[str, Any]` | 生の Claude API ストリームイベントデータ |

1577| `parent_tool_use_id` | `str \| None` | このイベントがサブエージェントからの場合の親ツール使用 ID |1760| `parent_tool_use_id` | `str \| None` | このイベントがサブエージェントからの場合の親ツール使用 ID |

1578 1761 

1579### `RateLimitEvent`1762<h3 id="ratelimitevent">

1763 `RateLimitEvent`

1764</h3>

1580 1765 

1581レート制限ステータスが変更されたときに発行されます(例:`"allowed"` から `"allowed_warning"` へ)。ユーザーにハード制限に達する前に警告するか、ステータスが `"rejected"` の場合にバックオフするために使用します。1766レート制限ステータスが変更されたときに発行されます(例:`"allowed"` から `"allowed_warning"` へ)。ユーザーにハード制限に達する前に警告するか、ステータスが `"rejected"` の場合にバックオフするために使用します。

1582 1767 


1594| `uuid` | `str` | 一意のイベント識別子 |1779| `uuid` | `str` | 一意のイベント識別子 |

1595| `session_id` | `str` | セッション識別子 |1780| `session_id` | `str` | セッション識別子 |

1596 1781 

1597### `RateLimitInfo`1782<h3 id="ratelimitinfo">

1783 `RateLimitInfo`

1784</h3>

1598 1785 

1599[`RateLimitEvent`](#ratelimitevent) によって運ばれるレート制限状態。1786[`RateLimitEvent`](#ratelimitevent) によって運ばれるレート制限状態。

1600 1787 


1628| `overage_disabled_reason` | `str \| None` | ステータスが `"rejected"` の場合、超過が利用できない理由 |1815| `overage_disabled_reason` | `str \| None` | ステータスが `"rejected"` の場合、超過が利用できない理由 |

1629| `raw` | `dict[str, Any]` | 上記でモデル化されていないフィールドを含む、CLI からの完全な生 dict |1816| `raw` | `dict[str, Any]` | 上記でモデル化されていないフィールドを含む、CLI からの完全な生 dict |

1630 1817 

1631### `TaskStartedMessage`1818<h3 id="taskstartedmessage">

1819 `TaskStartedMessage`

1820</h3>

1632 1821 

1633バックグラウンドタスクが開始されたときに発行されます。バックグラウンドタスクは、メインターンの外で追跡されるもの:バックグラウンド Bash コマンド、[Monitor](#monitor) ウォッチ、Agent ツール経由で生成されたサブエージェント、またはリモートエージェント。`task_type` フィールドはどれであるかを示します。このネーミングは `Task` から `Agent` ツールへの名前変更とは無関係です。1822バックグラウンドタスクが開始されたときに発行されます。バックグラウンドタスクは、メインターンの外で追跡されるもの:バックグラウンド Bash コマンド、[Monitor](#monitor) ウォッチ、Agent ツール経由で生成されたサブエージェント、またはリモートエージェント。`task_type` フィールドはどれであるかを示します。このネーミングは `Task` から `Agent` ツールへの名前変更とは無関係です。

1634 1823 


1652| `tool_use_id` | `str \| None` | 関連するツール使用 ID |1841| `tool_use_id` | `str \| None` | 関連するツール使用 ID |

1653| `task_type` | `str \| None` | バックグラウンドタスクの種類:バックグラウンド Bash と Monitor ウォッチの場合は `"local_bash"`、`"local_agent"`、または `"remote_agent"` |1842| `task_type` | `str \| None` | バックグラウンドタスクの種類:バックグラウンド Bash と Monitor ウォッチの場合は `"local_bash"`、`"local_agent"`、または `"remote_agent"` |

1654 1843 

1655### `TaskUsage`1844<h3 id="taskusage">

1845 `TaskUsage`

1846</h3>

1656 1847 

1657バックグラウンドタスクのトークンとタイミングデータ。1848バックグラウンドタスクのトークンとタイミングデータ。

1658 1849 


1663 duration_ms: int1854 duration_ms: int

1664```1855```

1665 1856 

1666### `TaskProgressMessage`1857<h3 id="taskprogressmessage">

1858 `TaskProgressMessage`

1859</h3>

1667 1860 

1668実行中のバックグラウンドタスクの進捗更新で定期的に発行されます。1861実行中のバックグラウンドタスクの進捗更新で定期的に発行されます。

1669 1862 


1689| `tool_use_id` | `str \| None` | 関連するツール使用 ID |1882| `tool_use_id` | `str \| None` | 関連するツール使用 ID |

1690| `last_tool_name` | `str \| None` | タスクが最後に使用したツールの名前 |1883| `last_tool_name` | `str \| None` | タスクが最後に使用したツールの名前 |

1691 1884 

1692### `TaskNotificationMessage`1885<h3 id="tasknotificationmessage">

1886 `TaskNotificationMessage`

1887</h3>

1693 1888 

1694バックグラウンドタスクが完了、失敗、または停止されたときに発行されます。バックグラウンドタスクには、`run_in_background` Bash コマンド、Monitor ウォッチ、バックグラウンドサブエージェントが含まれます。1889バックグラウンドタスクが完了、失敗、または停止されたときに発行されます。バックグラウンドタスクには、`run_in_background` Bash コマンド、Monitor ウォッチ、バックグラウンドサブエージェントが含まれます。

1695 1890 


1717| `tool_use_id` | `str \| None` | 関連するツール使用 ID |1912| `tool_use_id` | `str \| None` | 関連するツール使用 ID |

1718| `usage` | `TaskUsage \| None` | タスクの最終トークン使用状況 |1913| `usage` | `TaskUsage \| None` | タスクの最終トークン使用状況 |

1719 1914 

1720## コンテンツブロック型1915<h2 id="content-block-types">

1916 コンテンツブロック型

1917</h2>

1721 1918 

1722### `ContentBlock`1919<h3 id="contentblock">

1920 `ContentBlock`

1921</h3>

1723 1922 

1724すべてのコンテンツブロックの Union 型。1923すべてのコンテンツブロックの Union 型。

1725 1924 


1727ContentBlock = TextBlock | ThinkingBlock | ToolUseBlock | ToolResultBlock1926ContentBlock = TextBlock | ThinkingBlock | ToolUseBlock | ToolResultBlock

1728```1927```

1729 1928 

1730### `TextBlock`1929<h3 id="textblock">

1930 `TextBlock`

1931</h3>

1731 1932 

1732テキストコンテンツブロック。1933テキストコンテンツブロック。

1733 1934 


1737 text: str1938 text: str

1738```1939```

1739 1940 

1740### `ThinkingBlock`1941<h3 id="thinkingblock">

1942 `ThinkingBlock`

1943</h3>

1741 1944 

1742思考コンテンツブロック(思考機能を持つモデル用)。1945思考コンテンツブロック(思考機能を持つモデル用)。

1743 1946 


1748 signature: str1951 signature: str

1749```1952```

1750 1953 

1751### `ToolUseBlock`1954<h3 id="tooluseblock">

1955 `ToolUseBlock`

1956</h3>

1752 1957 

1753ツール使用リクエストブロック。1958ツール使用リクエストブロック。

1754 1959 


1760 input: dict[str, Any]1965 input: dict[str, Any]

1761```1966```

1762 1967 

1763### `ToolResultBlock`1968<h3 id="toolresultblock">

1969 `ToolResultBlock`

1970</h3>

1764 1971 

1765ツール実行結果ブロック。1972ツール実行結果ブロック。

1766 1973 


1772 is_error: bool | None = None1979 is_error: bool | None = None

1773```1980```

1774 1981 

1775## エラー型1982<h2 id="error-types">

1983 エラー型

1984</h2>

1776 1985 

1777### `ClaudeSDKError`1986<h3 id="claudesdkerror">

1987 `ClaudeSDKError`

1988</h3>

1778 1989 

1779すべての SDK エラーの基本例外クラス。1990すべての SDK エラーの基本例外クラス。

1780 1991 


1783 """Base error for Claude SDK."""1994 """Base error for Claude SDK."""

1784```1995```

1785 1996 

1786### `CLINotFoundError`1997<h3 id="clinotfounderror">

1998 `CLINotFoundError`

1999</h3>

1787 2000 

1788Claude Code CLI がインストールされていないか見つからない場合に発生します。2001Claude Code CLI がインストールされていないか見つからない場合に発生します。

1789 2002 


1799 """2012 """

1800```2013```

1801 2014 

1802### `CLIConnectionError`2015<h3 id="cliconnectionerror">

2016 `CLIConnectionError`

2017</h3>

1803 2018 

1804Claude Code への接続に失敗した場合に発生します。2019Claude Code への接続に失敗した場合に発生します。

1805 2020 


1808 """Failed to connect to Claude Code."""2023 """Failed to connect to Claude Code."""

1809```2024```

1810 2025 

1811### `ProcessError`2026<h3 id="processerror">

2027 `ProcessError`

2028</h3>

1812 2029 

1813Claude Code プロセスが失敗した場合に発生します。2030Claude Code プロセスが失敗した場合に発生します。

1814 2031 


1821 self.stderr = stderr2038 self.stderr = stderr

1822```2039```

1823 2040 

1824### `CLIJSONDecodeError`2041<h3 id="clijsondecodeerror">

2042 `CLIJSONDecodeError`

2043</h3>

1825 2044 

1826JSON 解析に失敗した場合に発生します。2045JSON 解析に失敗した場合に発生します。

1827 2046 


1837 self.original_error = original_error2056 self.original_error = original_error

1838```2057```

1839 2058 

1840## Hook 2059<h2 id="hook-types">

2060 Hook 型

2061</h2>

1841 2062 

1842hooks の使用に関する包括的なガイド、例、一般的なパターンについては、[Hooks ガイド](/ja/agent-sdk/hooks) を参照してください。2063hooks の使用に関する包括的なガイド、例、一般的なパターンについては、[Hooks ガイド](/ja/agent-sdk/hooks) を参照してください。

1843 2064 

1844### `HookEvent`2065<h3 id="hookevent">

2066 `HookEvent`

2067</h3>

1845 2068 

1846サポートされている hook イベント型。2069サポートされている hook イベント型。

1847 2070 


1864 TypeScript SDK は、Python ではまだ利用できない追加の hook イベントをサポートしています:`SessionStart`、`SessionEnd`、`Setup`、`TeammateIdle`、`TaskCompleted`、`ConfigChange`、`WorktreeCreate`、`WorktreeRemove`、`PostToolBatch`、および `MessageDisplay`。2087 TypeScript SDK は、Python ではまだ利用できない追加の hook イベントをサポートしています:`SessionStart`、`SessionEnd`、`Setup`、`TeammateIdle`、`TaskCompleted`、`ConfigChange`、`WorktreeCreate`、`WorktreeRemove`、`PostToolBatch`、および `MessageDisplay`。

1865</Note>2088</Note>

1866 2089 

1867### `HookCallback`2090<h3 id="hookcallback">

2091 `HookCallback`

2092</h3>

1868 2093 

1869hook コールバック関数の型定義。2094hook コールバック関数の型定義。

1870 2095 


1884* `systemMessage`:ユーザーに表示される警告メッセージ2109* `systemMessage`:ユーザーに表示される警告メッセージ

1885* `hookSpecificOutput`:hook 固有の出力データ2110* `hookSpecificOutput`:hook 固有の出力データ

1886 2111 

1887### `HookContext`2112<h3 id="hookcontext">

2113 `HookContext`

2114</h3>

1888 2115 

1889hook コールバックに渡されるコンテキスト情報。2116hook コールバックに渡されるコンテキスト情報。

1890 2117 


1893 signal: Any | None # Future: abort signal support2120 signal: Any | None # Future: abort signal support

1894```2121```

1895 2122 

1896### `HookMatcher`2123<h3 id="hookmatcher">

2124 `HookMatcher`

2125</h3>

1897 2126 

1898特定のイベントまたはツールに hook をマッチングするための設定。2127特定のイベントまたはツールに hook をマッチングするための設定。

1899 2128 


1911 )2140 )

1912```2141```

1913 2142 

1914### `HookInput`2143<h3 id="hookinput">

2144 `HookInput`

2145</h3>

1915 2146 

1916すべての hook 入力型の Union 型。実際の型は `hook_event_name` フィールドに依存します。2147すべての hook 入力型の Union 型。実際の型は `hook_event_name` フィールドに依存します。

1917 2148 


1930)2161)

1931```2162```

1932 2163 

1933### `BaseHookInput`2164<h3 id="basehookinput">

2165 `BaseHookInput`

2166</h3>

1934 2167 

1935すべての hook 入力型に存在する基本フィールド。2168すべての hook 入力型に存在する基本フィールド。

1936 2169 


1949| `cwd` | `str` | 現在の作業ディレクトリ |2182| `cwd` | `str` | 現在の作業ディレクトリ |

1950| `permission_mode` | `str`(オプション) | 現在のパーミッションモード |2183| `permission_mode` | `str`(オプション) | 現在のパーミッションモード |

1951 2184 

1952### `PreToolUseHookInput`2185<h3 id="pretoolusehookinput">

2186 `PreToolUseHookInput`

2187</h3>

1953 2188 

1954`PreToolUse` hook イベントの入力データ。2189`PreToolUse` hook イベントの入力データ。

1955 2190 


1972| `agent_id` | `str`(オプション) | サブエージェント識別子。hook がサブエージェント内で発火する場合に存在 |2207| `agent_id` | `str`(オプション) | サブエージェント識別子。hook がサブエージェント内で発火する場合に存在 |

1973| `agent_type` | `str`(オプション) | サブエージェント型。hook がサブエージェント内で発火する場合に存在 |2208| `agent_type` | `str`(オプション) | サブエージェント型。hook がサブエージェント内で発火する場合に存在 |

1974 2209 

1975### `PostToolUseHookInput`2210<h3 id="posttoolusehookinput">

2211 `PostToolUseHookInput`

2212</h3>

1976 2213 

1977`PostToolUse` hook イベントの入力データ。2214`PostToolUse` hook イベントの入力データ。

1978 2215 


1997| `agent_id` | `str`(オプション) | サブエージェント識別子。hook がサブエージェント内で発火する場合に存在 |2234| `agent_id` | `str`(オプション) | サブエージェント識別子。hook がサブエージェント内で発火する場合に存在 |

1998| `agent_type` | `str`(オプション) | サブエージェント型。hook がサブエージェント内で発火する場合に存在 |2235| `agent_type` | `str`(オプション) | サブエージェント型。hook がサブエージェント内で発火する場合に存在 |

1999 2236 

2000### `PostToolUseFailureHookInput`2237<h3 id="posttoolusefailurehookinput">

2238 `PostToolUseFailureHookInput`

2239</h3>

2001 2240 

2002`PostToolUseFailure` hook イベントの入力データ。ツール実行が失敗したときに呼び出されます。2241`PostToolUseFailure` hook イベントの入力データ。ツール実行が失敗したときに呼び出されます。

2003 2242 


2024| `agent_id` | `str`(オプション) | サブエージェント識別子。hook がサブエージェント内で発火する場合に存在 |2263| `agent_id` | `str`(オプション) | サブエージェント識別子。hook がサブエージェント内で発火する場合に存在 |

2025| `agent_type` | `str`(オプション) | サブエージェント型。hook がサブエージェント内で発火する場合に存在 |2264| `agent_type` | `str`(オプション) | サブエージェント型。hook がサブエージェント内で発火する場合に存在 |

2026 2265 

2027### `UserPromptSubmitHookInput`2266<h3 id="userpromptsubmithookinput">

2267 `UserPromptSubmitHookInput`

2268</h3>

2028 2269 

2029`UserPromptSubmit` hook イベントの入力データ。2270`UserPromptSubmit` hook イベントの入力データ。

2030 2271 


2039| `hook_event_name` | `Literal["UserPromptSubmit"]` | 常に "UserPromptSubmit" |2280| `hook_event_name` | `Literal["UserPromptSubmit"]` | 常に "UserPromptSubmit" |

2040| `prompt` | `str` | ユーザーが送信したプロンプト |2281| `prompt` | `str` | ユーザーが送信したプロンプト |

2041 2282 

2042### `StopHookInput`2283<h3 id="stophookinput">

2284 `StopHookInput`

2285</h3>

2043 2286 

2044`Stop` hook イベントの入力データ。2287`Stop` hook イベントの入力データ。

2045 2288 


2054| `hook_event_name` | `Literal["Stop"]` | 常に "Stop" |2297| `hook_event_name` | `Literal["Stop"]` | 常に "Stop" |

2055| `stop_hook_active` | `bool` | stop hook がアクティブかどうか |2298| `stop_hook_active` | `bool` | stop hook がアクティブかどうか |

2056 2299 

2057### `SubagentStopHookInput`2300<h3 id="subagentstophookinput">

2301 `SubagentStopHookInput`

2302</h3>

2058 2303 

2059`SubagentStop` hook イベントの入力データ。2304`SubagentStop` hook イベントの入力データ。

2060 2305 


2075| `agent_transcript_path` | `str` | サブエージェントのトランスクリプトファイルへのパス |2320| `agent_transcript_path` | `str` | サブエージェントのトランスクリプトファイルへのパス |

2076| `agent_type` | `str` | サブエージェントの型 |2321| `agent_type` | `str` | サブエージェントの型 |

2077 2322 

2078### `PreCompactHookInput`2323<h3 id="precompacthookinput">

2324 `PreCompactHookInput`

2325</h3>

2079 2326 

2080`PreCompact` hook イベントの入力データ。2327`PreCompact` hook イベントの入力データ。

2081 2328 


2092| `trigger` | `Literal["manual", "auto"]` | コンパクションをトリガーしたもの |2339| `trigger` | `Literal["manual", "auto"]` | コンパクションをトリガーしたもの |

2093| `custom_instructions` | `str \| None` | コンパクション用のカスタム指示 |2340| `custom_instructions` | `str \| None` | コンパクション用のカスタム指示 |

2094 2341 

2095### `NotificationHookInput`2342<h3 id="notificationhookinput">

2343 `NotificationHookInput`

2344</h3>

2096 2345 

2097`Notification` hook イベントの入力データ。2346`Notification` hook イベントの入力データ。

2098 2347 


2111| `title` | `str`(オプション) | 通知タイトル |2360| `title` | `str`(オプション) | 通知タイトル |

2112| `notification_type` | `str` | 通知の型 |2361| `notification_type` | `str` | 通知の型 |

2113 2362 

2114### `SubagentStartHookInput`2363<h3 id="subagentstarthookinput">

2364 `SubagentStartHookInput`

2365</h3>

2115 2366 

2116`SubagentStart` hook イベントの入力データ。2367`SubagentStart` hook イベントの入力データ。

2117 2368 


2128| `agent_id` | `str` | サブエージェントの一意の識別子 |2379| `agent_id` | `str` | サブエージェントの一意の識別子 |

2129| `agent_type` | `str` | サブエージェントの型 |2380| `agent_type` | `str` | サブエージェントの型 |

2130 2381 

2131### `PermissionRequestHookInput`2382<h3 id="permissionrequesthookinput">

2383 `PermissionRequestHookInput`

2384</h3>

2132 2385 

2133`PermissionRequest` hook イベントの入力データ。hooks がパーミッション決定をプログラムで処理できるようにします。2386`PermissionRequest` hook イベントの入力データ。hooks がパーミッション決定をプログラムで処理できるようにします。

2134 2387 


2147| `tool_input` | `dict[str, Any]` | ツールの入力パラメータ |2400| `tool_input` | `dict[str, Any]` | ツールの入力パラメータ |

2148| `permission_suggestions` | `list[Any]`(オプション) | CLI からの提案されたパーミッション更新 |2401| `permission_suggestions` | `list[Any]`(オプション) | CLI からの提案されたパーミッション更新 |

2149 2402 

2150### `HookJSONOutput`2403<h3 id="hookjsonoutput">

2404 `HookJSONOutput`

2405</h3>

2151 2406 

2152hook コールバック戻り値の Union 型。2407hook コールバック戻り値の Union 型。

2153 2408 


2155HookJSONOutput = AsyncHookJSONOutput | SyncHookJSONOutput2410HookJSONOutput = AsyncHookJSONOutput | SyncHookJSONOutput

2156```2411```

2157 2412 

2158#### `SyncHookJSONOutput`2413<h4 id="synchookjsonoutput">

2414 `SyncHookJSONOutput`

2415</h4>

2159 2416 

2160制御フィールドと決定フィールドを持つ同期 hook 出力。2417制御フィールドと決定フィールドを持つ同期 hook 出力。

2161 2418 


2179 Python コードで `continue_`(アンダースコア付き)を使用してください。CLI に送信されるときに自動的に `continue` に変換されます。2436 Python コードで `continue_`(アンダースコア付き)を使用してください。CLI に送信されるときに自動的に `continue` に変換されます。

2180</Note>2437</Note>

2181 2438 

2182#### `HookSpecificOutput`2439<h4 id="hookspecificoutput">

2440 `HookSpecificOutput`

2441</h4>

2183 2442 

2184hook イベント名とイベント固有のフィールドを含む `TypedDict`。形状は `hookEventName` 値に依存します。hook イベントごとに利用可能なフィールドの詳細については、[hooks で実行を制御](/ja/agent-sdk/hooks#outputs) を参照してください。2443hook イベント名とイベント固有のフィールドを含む `TypedDict`。形状は `hookEventName` 値に依存します。hook イベントごとに利用可能なフィールドの詳細については、[hooks で実行を制御](/ja/agent-sdk/hooks#outputs) を参照してください。

2185 2444 


2237)2496)

2238```2497```

2239 2498 

2240#### `AsyncHookJSONOutput`2499<h4 id="asynchookjsonoutput">

2500 `AsyncHookJSONOutput`

2501</h4>

2241 2502 

2242hook 実行を遅延させる非同期 hook 出力。2503hook 実行を遅延させる非同期 hook 出力。

2243 2504 


2251 Python コードで `async_`(アンダースコア付き)を使用してください。CLI に送信されるときに自動的に `async` に変換されます。2512 Python コードで `async_`(アンダースコア付き)を使用してください。CLI に送信されるときに自動的に `async` に変換されます。

2252</Note>2513</Note>

2253 2514 

2254### Hook 使用例2515<h3 id="hook-usage-example">

2516 Hook 使用例

2517</h3>

2255 2518 

2256この例は 2 つの hook を登録します:1 つは `rm -rf /` のような危険な bash コマンドをブロックし、もう 1 つは監査のためにすべてのツール使用をログします。セキュリティ hook は `matcher` を介して Bash コマンドでのみ実行され、ログ hook はすべてのツールで実行されます。2519この例は 2 つの hook を登録します:1 つは `rm -rf /` のような危険な bash コマンドをブロックし、もう 1 つは監査のためにすべてのツール使用をログします。セキュリティ hook は `matcher` を介して Bash コマンドでのみ実行され、ログ hook はすべてのツールで実行されます。

2257 2520 


2303 print(message)2566 print(message)

2304```2567```

2305 2568 

2306## ツール入出力型2569<h2 id="tool-input/output-types">

2570 ツール入出力型

2571</h2>

2307 2572 

2308すべての組み込み Claude Code ツールの入出力スキーマのドキュメント。Python SDK はこれらを型としてエクスポートしませんが、メッセージ内のツール入出力の構造を表します。2573すべての組み込み Claude Code ツールの入出力スキーマのドキュメント。Python SDK はこれらを型としてエクスポートしませんが、メッセージ内のツール入出力の構造を表します。

2309 2574 

2310### Agent2575<h3 id="agent">

2576 Agent

2577</h3>

2311 2578 

2312**ツール名:** `Agent`(以前は `Task`。これはまだエイリアスとして受け入れられます)2579**ツール名:** `Agent`(以前は `Task`。これはまだエイリアスとして受け入れられます)

2313 2580 


2332}2599}

2333```2600```

2334 2601 

2335### AskUserQuestion2602<h3 id="askuserquestion">

2603 AskUserQuestion

2604</h3>

2336 2605 

2337**ツール名:** `AskUserQuestion`2606**ツール名:** `AskUserQuestion`

2338 2607 


2378}2647}

2379```2648```

2380 2649 

2381### Bash2650<h3 id="bash">

2651 Bash

2652</h3>

2382 2653 

2383**ツール名:** `Bash`2654**ツール名:** `Bash`

2384 2655 


2404}2675}

2405```2676```

2406 2677 

2407### Monitor2678<h3 id="monitor">

2679 Monitor

2680</h3>

2408 2681 

2409**ツール名:** `Monitor`2682**ツール名:** `Monitor`

2410 2683 


2431}2704}

2432```2705```

2433 2706 

2434### Edit2707<h3 id="edit">

2708 Edit

2709</h3>

2435 2710 

2436**ツール名:** `Edit`2711**ツール名:** `Edit`

2437 2712 


2456}2731}

2457```2732```

2458 2733 

2459### Read2734<h3 id="read">

2735 Read

2736</h3>

2460 2737 

2461**ツール名:** `Read`2738**ツール名:** `Read`

2462 2739 


2490}2767}

2491```2768```

2492 2769 

2493### Write2770<h3 id="write">

2771 Write

2772</h3>

2494 2773 

2495**ツール名:** `Write`2774**ツール名:** `Write`

2496 2775 


2513}2792}

2514```2793```

2515 2794 

2516### Glob2795<h3 id="glob">

2796 Glob

2797</h3>

2517 2798 

2518**ツール名:** `Glob`2799**ツール名:** `Glob`

2519 2800 


2536}2817}

2537```2818```

2538 2819 

2539### Grep2820<h3 id="grep">

2821 Grep

2822</h3>

2540 2823 

2541**ツール名:** `Grep`2824**ツール名:** `Grep`

2542 2825 


2585}2868}

2586```2869```

2587 2870 

2588### NotebookEdit2871<h3 id="notebookedit">

2872 NotebookEdit

2873</h3>

2589 2874 

2590**ツール名:** `NotebookEdit`2875**ツール名:** `NotebookEdit`

2591 2876 


2612}2897}

2613```2898```

2614 2899 

2615### WebFetch2900<h3 id="webfetch">

2901 WebFetch

2902</h3>

2616 2903 

2617**ツール名:** `WebFetch`2904**ツール名:** `WebFetch`

2618 2905 


2638}2925}

2639```2926```

2640 2927 

2641### WebSearch2928<h3 id="websearch">

2929 WebSearch

2930</h3>

2642 2931 

2643**ツール名:** `WebSearch`2932**ツール名:** `WebSearch`

2644 2933 


2662}2951}

2663```2952```

2664 2953 

2665### TodoWrite2954<h3 id="todowrite">

2955 TodoWrite

2956</h3>

2666 2957 

2667**ツール名:** `TodoWrite`2958**ツール名:** `TodoWrite`

2668 2959 


2693}2984}

2694```2985```

2695 2986 

2696### TaskCreate2987<h3 id="taskcreate">

2988 TaskCreate

2989</h3>

2697 2990 

2698**ツール名:** `TaskCreate`2991**ツール名:** `TaskCreate`

2699 2992 


2716}3009}

2717```3010```

2718 3011 

2719### TaskUpdate3012<h3 id="taskupdate">

3013 TaskUpdate

3014</h3>

2720 3015 

2721**ツール名:** `TaskUpdate`3016**ツール名:** `TaskUpdate`

2722 3017 


2748}3043}

2749```3044```

2750 3045 

2751### TaskGet3046<h3 id="taskget">

3047 TaskGet

3048</h3>

2752 3049 

2753**ツール名:** `TaskGet`3050**ツール名:** `TaskGet`

2754 3051 


2775}3072}

2776```3073```

2777 3074 

2778### TaskList3075<h3 id="tasklist">

3076 TaskList

3077</h3>

2779 3078 

2780**ツール名:** `TaskList`3079**ツール名:** `TaskList`

2781 3080 


2801}3100}

2802```3101```

2803 3102 

2804### BashOutput3103<h3 id="bashoutput">

3104 BashOutput

3105</h3>

2805 3106 

2806**ツール名:** `BashOutput`3107**ツール名:** `BashOutput`

2807 3108 


2824}3125}

2825```3126```

2826 3127 

2827### KillBash3128<h3 id="killbash">

3129 KillBash

3130</h3>

2828 3131 

2829**ツール名:** `KillBash`3132**ツール名:** `KillBash`

2830 3133 


2845}3148}

2846```3149```

2847 3150 

2848### ExitPlanMode3151<h3 id="exitplanmode">

3152 ExitPlanMode

3153</h3>

2849 3154 

2850**ツール名:** `ExitPlanMode`3155**ツール名:** `ExitPlanMode`

2851 3156 


2866}3171}

2867```3172```

2868 3173 

2869### ListMcpResources3174<h3 id="listmcpresources">

3175 ListMcpResources

3176</h3>

2870 3177 

2871**ツール名:** `ListMcpResourcesTool`3178**ツール名:** `ListMcpResourcesTool`

2872 3179 


2895}3202}

2896```3203```

2897 3204 

2898### ReadMcpResource3205<h3 id="readmcpresource">

3206 ReadMcpResource

3207</h3>

2899 3208 

2900**ツール名:** `ReadMcpResourceTool`3209**ツール名:** `ReadMcpResourceTool`

2901 3210 


2919}3228}

2920```3229```

2921 3230 

2922## ClaudeSDKClient を使用した高度な機能3231<h2 id="advanced-features-with-claudesdkclient">

3232 ClaudeSDKClient を使用した高度な機能

3233</h2>

2923 3234 

2924### 継続的な会話インターフェースの構築3235<h3 id="building-a-continuous-conversation-interface">

3236 継続的な会話インターフェースの構築

3237</h3>

2925 3238 

2926```python theme={null}3239```python theme={null}

2927from claude_agent_sdk import (3240from claude_agent_sdk import (


3000asyncio.run(main())3313asyncio.run(main())

3001```3314```

3002 3315 

3003### 動作修正のための Hooks の使用3316<h3 id="using-hooks-for-behavior-modification">

3317 動作修正のための hooks の使用

3318</h3>

3004 3319 

3005```python theme={null}3320```python theme={null}

3006from claude_agent_sdk import (3321from claude_agent_sdk import (


3084asyncio.run(main())3399asyncio.run(main())

3085```3400```

3086 3401 

3087### リアルタイム進捗監視3402<h3 id="real-time-progress-monitoring">

3403 リアルタイム進捗監視

3404</h3>

3088 3405 

3089```python theme={null}3406```python theme={null}

3090from claude_agent_sdk import (3407from claude_agent_sdk import (


3125asyncio.run(monitor_progress())3442asyncio.run(monitor_progress())

3126```3443```

3127 3444 

3128## 使用例3445<h2 id="example-usage">

3446 使用例

3447</h2>

3129 3448 

3130### 基本的なファイル操作(query を使用)3449<h3 id="basic-file-operations-using-query">

3450 基本的なファイル操作(query を使用)

3451</h3>

3131 3452 

3132```python theme={null}3453```python theme={null}

3133from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock3454from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ToolUseBlock


3153asyncio.run(create_project())3474asyncio.run(create_project())

3154```3475```

3155 3476 

3156### エラー処理3477<h3 id="error-handling">

3478 エラー処理

3479</h3>

3157 3480 

3158```python theme={null}3481```python theme={null}

3159from claude_agent_sdk import query, CLINotFoundError, ProcessError, CLIJSONDecodeError3482from claude_agent_sdk import query, CLINotFoundError, ProcessError, CLIJSONDecodeError


3171 print(f"Failed to parse response: {e}")3494 print(f"Failed to parse response: {e}")

3172```3495```

3173 3496 

3174### クライアントでのストリーミングモード3497<h3 id="streaming-mode-with-client">

3498 クライアントでのストリーミングモード

3499</h3>

3175 3500 

3176```python theme={null}3501```python theme={null}

3177from claude_agent_sdk import ClaudeSDKClient3502from claude_agent_sdk import ClaudeSDKClient


3198asyncio.run(interactive_session())3523asyncio.run(interactive_session())

3199```3524```

3200 3525 

3201### ClaudeSDKClient でカスタムツールを使用する3526<h3 id="using-custom-tools-with-claudesdkclient">

3527 ClaudeSDKClient でカスタムツールを使用する

3528</h3>

3202 3529 

3203```python theme={null}3530```python theme={null}

3204from claude_agent_sdk import (3531from claude_agent_sdk import (


3270asyncio.run(main())3597asyncio.run(main())

3271```3598```

3272 3599 

3273## サンドボックス設定3600<h2 id="sandbox-configuration">

3601 サンドボックス設定

3602</h2>

3274 3603 

3275### `SandboxSettings`3604<h3 id="sandboxsettings">

3605 `SandboxSettings`

3606</h3>

3276 3607 

3277サンドボックス動作の設定。これを使用してコマンドサンドボックスを有効にし、ネットワーク制限をプログラムで設定します。3608サンドボックス動作の設定。これを使用してコマンドサンドボックスを有効にし、ネットワーク制限をプログラムで設定します。

3278 3609 


3303 サンドボックス設定で `"failIfUnavailable": True` を設定して、代わりに停止するようにしてください。このキーはまだ `SandboxSettings` で宣言されていませんが、SDK は Claude Code に転送し、Claude Code がこれを尊重します。その後、`query()` は `subtype="error_during_execution"` の `ResultMessage` を報告し、理由は `errors` に含まれます。`query()` がメッセージを生成する前に例外を発生させることを期待するのではなく、そのサブタイプを監視してください。3634 サンドボックス設定で `"failIfUnavailable": True` を設定して、代わりに停止するようにしてください。このキーはまだ `SandboxSettings` で宣言されていませんが、SDK は Claude Code に転送し、Claude Code がこれを尊重します。その後、`query()` は `subtype="error_during_execution"` の `ResultMessage` を報告し、理由は `errors` に含まれます。`query()` がメッセージを生成する前に例外を発生させることを期待するのではなく、そのサブタイプを監視してください。

3304</Note>3635</Note>

3305 3636 

3306#### 使用例3637<h4 id="example-usage-1">

3638 使用例

3639</h4>

3307 3640 

3308```python theme={null}3641```python theme={null}

3309from claude_agent_sdk import query, ClaudeAgentOptions, SandboxSettings3642from claude_agent_sdk import query, ClaudeAgentOptions, SandboxSettings


3325 **Unix ソケットセキュリティ**:`allowUnixSockets` オプションは強力なシステムサービスへのアクセスを許可できます。例えば、`/var/run/docker.sock` を許可すると、Docker API を通じてホストシステムへの完全なアクセスが効果的に許可され、サンドボックス分離がバイパスされます。厳密に必要な Unix ソケットのみを許可し、各ソケットのセキュリティへの影響を理解してください。3658 **Unix ソケットセキュリティ**:`allowUnixSockets` オプションは強力なシステムサービスへのアクセスを許可できます。例えば、`/var/run/docker.sock` を許可すると、Docker API を通じてホストシステムへの完全なアクセスが効果的に許可され、サンドボックス分離がバイパスされます。厳密に必要な Unix ソケットのみを許可し、各ソケットのセキュリティへの影響を理解してください。

3326</Warning>3659</Warning>

3327 3660 

3328### `SandboxNetworkConfig`3661<h3 id="sandboxnetworkconfig">

3662 `SandboxNetworkConfig`

3663</h3>

3329 3664 

3330サンドボックスモード用のネットワーク固有の設定。これらの設定は、親の [`SandboxSettings`](#sandboxsettings) で `enabled` が `True` の場合、サンドボックス化された Bash コマンドに適用されます。WebFetch ツールには適用されず、WebFetch ツールは代わりに [パーミッションルール](/ja/permissions#webfetch) を使用します。3665サンドボックスモード用のネットワーク固有の設定。これらの設定は、親の [`SandboxSettings`](#sandboxsettings) で `enabled` が `True` の場合、サンドボックス化された Bash コマンドに適用されます。WebFetch ツールには適用されず、WebFetch ツールは代わりに [パーミッションルール](/ja/permissions#webfetch) を使用します。

3331 3666 


3358 組み込みサンドボックスプロキシは、リクエストされたホスト名に基づいてネットワーク許可リストを強制し、TLS トラフィックを終了または検査しないため、[ドメインフロンティング](https://en.wikipedia.org/wiki/Domain_fronting) などの技術がそれをバイパスする可能性があります。詳細は [サンドボックスセキュリティの制限事項](/ja/sandboxing#security-limitations) を参照し、TLS 終了プロキシの設定については [セキュアなデプロイ](/ja/agent-sdk/secure-deployment#traffic-forwarding) を参照してください。3693 組み込みサンドボックスプロキシは、リクエストされたホスト名に基づいてネットワーク許可リストを強制し、TLS トラフィックを終了または検査しないため、[ドメインフロンティング](https://en.wikipedia.org/wiki/Domain_fronting) などの技術がそれをバイパスする可能性があります。詳細は [サンドボックスセキュリティの制限事項](/ja/sandboxing#security-limitations) を参照し、TLS 終了プロキシの設定については [セキュアなデプロイ](/ja/agent-sdk/secure-deployment#traffic-forwarding) を参照してください。

3359</Note>3694</Note>

3360 3695 

3361### `SandboxIgnoreViolations`3696<h3 id="sandboxignoreviolations">

3697 `SandboxIgnoreViolations`

3698</h3>

3362 3699 

3363特定のサンドボックス違反を無視するための設定。3700特定のサンドボックス違反を無視するための設定。

3364 3701 


3373| `file` | `list[str]` | `[]` | 違反を無視するファイルパスパターン |3710| `file` | `list[str]` | `[]` | 違反を無視するファイルパスパターン |

3374| `network` | `list[str]` | `[]` | 違反を無視するネットワークパターン |3711| `network` | `list[str]` | `[]` | 違反を無視するネットワークパターン |

3375 3712 

3376### サンドボックスなしコマンドのパーミッションフォールバック3713<h3 id="permissions-fallback-for-unsandboxed-commands">

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

3715</h3>

3377 3716 

3378`allowUnsandboxedCommands` が有効な場合、モデルはツール入力で `dangerouslyDisableSandbox: True` を設定することでサンドボックスの外でコマンドを実行するようにリクエストできます。これらのリクエストは既存のパーミッションシステムにフォールバックします。つまり、`can_use_tool` ハンドラーが呼び出され、カスタム認可ロジックを実装できます。3717`allowUnsandboxedCommands` が有効な場合、モデルはツール入力で `dangerouslyDisableSandbox: True` を設定することでサンドボックスの外でコマンドを実行するようにリクエストできます。これらのリクエストは既存のパーミッションシステムにフォールバックします。つまり、`can_use_tool` ハンドラーが呼び出され、カスタム認可ロジックを実装できます。

3379 3718 


3451 `permission_mode` が `bypassPermissions` に設定され、`allow_unsandboxed_commands` が有効な場合、モデルは承認プロンプトなしにサンドボックスの外でコマンドを自律的に実行できます。この組み合わせは、モデルがサンドボックス分離をサイレントに逃れることを効果的に許可します。3790 `permission_mode` が `bypassPermissions` に設定され、`allow_unsandboxed_commands` が有効な場合、モデルは承認プロンプトなしにサンドボックスの外でコマンドを自律的に実行できます。この組み合わせは、モデルがサンドボックス分離をサイレントに逃れることを効果的に許可します。

3452</Warning>3791</Warning>

3453 3792 

3454## 関連項目3793<h2 id="see-also">

3794 関連項目

3795</h2>

3455 3796 

3456* [SDK 概要](/ja/agent-sdk/overview) - 一般的な SDK 概念3797* [SDK 概要](/ja/agent-sdk/overview) - 一般的な SDK 概念

3457* [TypeScript SDK リファレンス](/ja/agent-sdk/typescript) - TypeScript SDK ドキュメント3798* [TypeScript SDK リファレンス](/ja/agent-sdk/typescript) - TypeScript SDK ドキュメント

Details

244これが Agent SDK を異なるものにする理由です:Claude は、実装するよう求める代わりに、ツールを直接実行します。244これが Agent SDK を異なるものにする理由です:Claude は、実装するよう求める代わりに、ツールを直接実行します。

245 245 

246<Note>246<Note>

247 API key not foundが表示される場合は、`.env` ファイルまたはシェル環境で `ANTHROPIC_API_KEY` 環境変数を設定していることを確認してください。詳細については、[完全なトラブルシューティングガイド](/ja/troubleshooting) を参照してください。247 'API key not found'が表示される場合は、`.env` ファイルまたはシェル環境で `ANTHROPIC_API_KEY` 環境変数を設定していることを確認してください。詳細については、[完全なトラブルシューティングガイド](/ja/troubleshooting) を参照してください。

248</Note>248</Note>

249 249 

250<h3 id="try-other-prompts">250<h3 id="try-other-prompts">


340**権限モード** は、必要な人間の監視の量を制御します:340**権限モード** は、必要な人間の監視の量を制御します:

341 341 

342| モード | 動作 | ユースケース |342| モード | 動作 | ユースケース |

343| --------------------- | ----------------------------------------------- | ------------------------- |343| --------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------- |

344| `acceptEdits` | ファイル編集と一般的なファイルシステムコマンドを自動承認し、他のアクションについては確認します | 信頼できる開発ワークフロー |344| `acceptEdits` | ファイル編集と一般的なファイルシステムコマンドを自動承認し、他のアクションについては確認します | 信頼できる開発ワークフロー |

345| `dontAsk` | `allowedTools` にないものを拒否します | ロックダウンされたヘッドレスエージェント |345| `dontAsk` | `allowedTools` にないものを拒否します | ロックダウンされたヘッドレスエージェント |

346| `auto`(TypeScript のみ) | モデル分類器が各ツール呼び出しを承認または拒否します | 安全ガードレール付きの自律エージェント |346| `auto`(TypeScript のみ) | モデル分類器が各ツール呼び出しを承認または拒否します | 安全ガードレール付きの自律エージェント |

347| `bypassPermissions` | プロンプトなしですべてのツールを実行します | サンドボックス化された CI、完全に信頼できる環境 |347| `bypassPermissions` | 明示的な [`ask` ルール](/ja/agent-sdk/permissions#how-permissions-are-evaluated) に一致しない限り、プロンプトなしですべてのツールを実行します | サンドボックス化された CI、完全に信頼できる環境 |

348| `default` | 承認を処理するために `canUseTool` コールバックが必要です | カスタム承認フロー |348| `default` | 承認を処理するために `canUseTool` コールバックが必要です | カスタム承認フロー |

349 349 

350上記の例は `acceptEdits` モードを使用しており、ファイル操作を自動承認するため、エージェントはインタラクティブなプロンプトなしで実行できます。ユーザーに承認を促す場合は、`default` モードを使用し、ユーザー入力を収集する [`canUseTool` コールバック](/ja/agent-sdk/user-input) を提供します。より詳細な制御については、[権限](/ja/agent-sdk/permissions) を参照してください。350上記の例は `acceptEdits` モードを使用しており、ファイル操作を自動承認するため、エージェントはインタラクティブなプロンプトなしで実行できます。ユーザーに承認を促す場合は、`default` モードを使用し、ユーザー入力を収集する [`canUseTool` コールバック](/ja/agent-sdk/user-input) を提供します。より詳細な制御については、[権限](/ja/agent-sdk/permissions) を参照してください。

Details

150 ```150 ```

151</CodeGroup>151</CodeGroup>

152 152 

1532 番目のクエリは最初のクエリのファイルの概要を出力し、エージェントがストアから完全なコンテキストで再開されたことを示しています。

154 

153<h2 id="write-your-own-adapter">155<h2 id="write-your-own-adapter">

154 独自のアダプターを作成する156 独自のアダプターを作成する

155</h2>157</h2>


162 リファレンス実装164 リファレンス実装

163</h2>165</h2>

164 166 

165TypeScript SDK リポジトリには、[`examples/session-stores/`](https://github.com/anthropics/claude-agent-sdk-typescript/tree/main/examples/session-stores) の下に S3、Redis、Postgres 用の実行可能なリファレンスアダプターが含まれています。これらは npm に公開されていません。必要な `src/` ファイルをプロジェクトにコピーし、対応するバックエンドクライアントをインストールします167TypeScript SDK リポジトリには、[`examples/session-stores/`](https://github.com/anthropics/claude-agent-sdk-typescript/tree/main/examples/session-stores) の下に S3、Redis、Postgres 用の実行可能なリファレンスアダプターが含まれています。これらは npm に公開されていません。必要な `src/` ファイルをプロジェクトにコピーし、対応するバックエンドクライアントをインストールしてください

166 168 

167| アダプター | バックエンドクライアント | ストレージモデル |169| アダプター | バックエンドクライアント | ストレージモデル |

168| :----------------------------------------------------------------------------------------------------------------------------- | :------------------- | :--------------------------------------------------------- |170| :----------------------------------------------------------------------------------------------------------------------------- | :------------------- | :--------------------------------------------------------- |


207 209 

208両方の SDK は、`append`、`load`、およびオプションメソッドが満たす必要がある動作契約をアサートする適合スイートを提供しています。オプションメソッドのテストは、これらのメソッドが実装されていない場合、自動的にスキップされます。210両方の SDK は、`append`、`load`、およびオプションメソッドが満たす必要がある動作契約をアサートする適合スイートを提供しています。オプションメソッドのテストは、これらのメソッドが実装されていない場合、自動的にスキップされます。

209 211 

210TypeScript では、例ディレクトリから [`shared/conformance.ts`](https://github.com/anthropics/claude-agent-sdk-typescript/blob/main/examples/session-stores/shared/conformance.ts) をテストスイートにコピーします。Python では、スイートはパッケージに含まれています:212TypeScript では、例ディレクトリから [`shared/conformance.ts`](https://github.com/anthropics/claude-agent-sdk-typescript/blob/main/examples/session-stores/shared/conformance.ts) をテストスイートにコピーしてください。Python では、スイートはパッケージに含まれています:

211 213 

212```python Python theme={null}214```python Python theme={null}

213import pytest215import pytest

Details

104asyncio.run(main())104asyncio.run(main())

105```105```

106 106 

107Python SDK リファレンスの [`ClaudeSDKClient` とスタンドアロン `query()` 関数のどちらを使用するかについて](/ja/agent-sdk/python#choosing-between-query-and-claudesdkclient)の詳細を参照してください。107Python SDK リファレンスの [ClaudeSDKClient とスタンドアロン `query()` 関数のどちらを使用するかについて](/ja/agent-sdk/python#choosing-between-query-and-claudesdkclient)の詳細を参照してください。

108 108 

109<h3 id="typescript-continue-true">109<h3 id="typescript-continue-true">

110 TypeScript:`continue: true`110 TypeScript:`continue: true`


230 ```230 ```

231 231 

232 ```typescript TypeScript theme={null}232 ```typescript TypeScript theme={null}

233 import { query } from "@anthropic-ai/claude-agent-sdk";

234 

235 const sessionId = "..."; // The ID you captured in the previous example

236 

233 // Earlier session analyzed the code; now build on that analysis237 // Earlier session analyzed the code; now build on that analysis

234 for await (const message of query({238 for await (const message of query({

235 prompt: "Now implement the refactoring you suggested",239 prompt: "Now implement the refactoring you suggested",


245 ```249 ```

246</CodeGroup>250</CodeGroup>

247 251 

252以前の分析に基づいて構築された応答が表示されるはずです。これにより、エージェントが以前のコンテキストを保持したままセッションを再開したことが確認されます。

253 

248<Tip>254<Tip>

249 `resume` 呼び出しが予期された履歴ではなく新しいセッションを返す場合、最も一般的な原因は `cwd` の不一致です。セッションは `~/.claude/projects/<encoded-cwd>/*.jsonl` に保存されます。ここで `<encoded-cwd>` は、すべての英数字以外の文字が `-` に置き換えられた絶対作業ディレクトリです(したがって `/Users/me/proj` は `-Users-me-proj` になります)。resume 呼び出しが別のディレクトリから実行される場合、SDK は間違った場所を探します。セッションファイルも現在のマシンに存在する必要があります。255 `resume` 呼び出しが予期された履歴ではなく新しいセッションを返す場合、最も一般的な原因は `cwd` の不一致です。セッションは `~/.claude/projects/<encoded-cwd>/*.jsonl` に保存されます。または、`CLAUDE_CONFIG_DIR` 環境変数を設定した場合は `$CLAUDE_CONFIG_DIR/projects/<encoded-cwd>/*.jsonl` に保存されます。ここで `<encoded-cwd>` は、すべての英数字以外の文字が `-` に置き換えられた絶対作業ディレクトリです(したがって `/Users/me/proj` は `-Users-me-proj` になります)。resume 呼び出しが別のディレクトリから実行される場合、SDK は間違った場所を探します。セッションファイルも現在のマシンに存在する必要があります。

250</Tip>256</Tip>

251 257 

252マシン間またはサーバーレス環境でセッションを再開するには、[`SessionStore` アダプター](/ja/agent-sdk/session-storage)を使用して共有ストレージにトランスクリプトをミラーリングします。258マシン間またはサーバーレス環境でセッションを再開するには、[`SessionStore` アダプター](/ja/agent-sdk/session-storage)を使用して共有ストレージにトランスクリプトをミラーリングします。


268 # Fork: branch from session_id into a new session274 # Fork: branch from session_id into a new session

269 forked_id = None275 forked_id = None

270 async for message in query(276 async for message in query(

271 prompt="Instead of JWT, implement OAuth2 for the auth module",277 prompt="Instead of JWT, outline how OAuth2 would work for the auth module",

272 options=ClaudeAgentOptions(278 options=ClaudeAgentOptions(

273 resume=session_id,279 resume=session_id,

274 fork_session=True,280 fork_session=True,

281 max_turns=5,

275 ),282 ),

276 ):283 ):

277 if isinstance(message, ResultMessage):284 if isinstance(message, ResultMessage):


291 ```298 ```

292 299 

293 ```typescript TypeScript theme={null}300 ```typescript TypeScript theme={null}

301 import { query } from "@anthropic-ai/claude-agent-sdk";

302 

303 const sessionId = "..."; // The ID you captured in the previous example

304 

294 // Fork: branch from sessionId into a new session305 // Fork: branch from sessionId into a new session

295 let forkedId: string | undefined;306 let forkedId: string | undefined;

296 307 

297 for await (const message of query({308 for await (const message of query({

298 prompt: "Instead of JWT, implement OAuth2 for the auth module",309 prompt: "Instead of JWT, outline how OAuth2 would work for the auth module",

299 options: {310 options: {

300 resume: sessionId,311 resume: sessionId,

301 forkSession: true312 forkSession: true,

313 maxTurns: 5

302 }314 }

303 })) {315 })) {

304 if (message.type === "system" && message.subtype === "init") {316 if (message.type === "system" && message.subtype === "init") {


323 ```335 ```

324</CodeGroup>336</CodeGroup>

325 337 

338`forkedId` が元のセッション ID と異なることが表示されるはずです。元のセッションを再開すると、JWT スレッドが続行されます。これにより、フォークが元の履歴を変更しなかったことが確認されます。

339 

326<h2 id="resume-across-hosts">340<h2 id="resume-across-hosts">

327 ホスト間で再開する341 ホスト間で再開する

328</h2>342</h2>

Details

119 119 

120Skills の作成に関する完全なガイダンス(SKILL.md 構造、複数ファイルの Skills、例を含む)については、以下を参照してください。120Skills の作成に関する完全なガイダンス(SKILL.md 構造、複数ファイルの Skills、例を含む)については、以下を参照してください。

121 121 

122* [Claude Code の Agent Skills](/ja/skills):例とテンプレートを含む完全なガイド122* [Claude Code の Agent Skills](/ja/skills):例を含む完全なガイド

123* [Agent Skills のベストプラクティス](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/best-practices):作成ガイドラインと命名規則123* [Agent Skills のベストプラクティス](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/best-practices):作成ガイドラインと命名規則

124 124 

125<h2 id="tool-restrictions">125<h2 id="tool-restrictions">

Details

101 parent_tool_use_id: string | null;101 parent_tool_use_id: string | null;

102 uuid: UUID;102 uuid: UUID;

103 session_id: string;103 session_id: string;

104 ttft_ms?: number; // メッセージ開始イベントにのみ存在する、最初のトークンまでの時間(ミリ秒)

104 };105 };

105 ```106 ```

106</CodeGroup>107</CodeGroup>

107 108 

108`event` フィールドには、[Claude API](https://platform.claude.com/docs/en/build-with-claude/streaming#event-types) からの生のストリーミングイベントが含まれます。一般的なイベントタイプは以下の通りです:109`event` フィールドには、[Claude API](https://platform.claude.com/docs/ja/build-with-claude/streaming#event-types) からの生のストリーミングイベントが含まれます。一般的なイベントタイプは以下の通りです:

109 110 

110| イベントタイプ | 説明 |111| イベントタイプ | 説明 |

111| :-------------------- | :---------------------------- |112| :-------------------- | :---------------------------- |

Details

218 ```218 ```

219</CodeGroup>219</CodeGroup>

220 220 

221<Note>

222 TypeScript SDK では、例えば読み込むファイルが見つからない場合など、メッセージジェネレータが例外をスローすると、ストリームは元のエラーではなく「Claude Code process aborted by user」というエラーで終了するため、そのメッセージが表示された場合は、まずジェネレータ内のコードを確認してください。エラーの前に、バンドルされた SDK ソースの長い縮小化された行が表示される場合もあるため、出力の最後まで読んでエラーテキストを確認してください。

223 

224 Python SDK では、ジェネレータの例外はデバッグレベルでログに記録され、セッションは例外を発生させずにスタールします。そのため、ストリーミングセッションが出力なくハングする場合は、デバッグログを有効にしてジェネレータを確認してください。

225</Note>

226 

221<h2 id="single-message-input">227<h2 id="single-message-input">

222 シングルメッセージ入力228 シングルメッセージ入力

223</h2>229</h2>


247 * 自然なマルチターン会話253 * 自然なマルチターン会話

248</Warning>254</Warning>

249 255 

250<h3 id="implementation-example">256クエリが `error_max_turns` などのエラー結果で終了する場合、シングルメッセージの `query()` 呼び出しは最終結果メッセージを生成した後、失敗テキストを含むエラーを発生させます。コードが続行する必要がある場合は、ループを try ブロックでラップしてください。結果サブタイプについては、[結果を処理する](/ja/agent-sdk/agent-loop#handle-the-result)を参照してください。

257 

258<h3 id="implementation-example-1">

251 実装例259 実装例

252</h3>260</h3>

253 261 

Details

98 import asyncio98 import asyncio

99 from claude_agent_sdk import query, ClaudeAgentOptions, ResultMessage99 from claude_agent_sdk import query, ClaudeAgentOptions, ResultMessage

100 100 

101 # 返してほしいデータの形状を定義101 // 返してほしいデータの形状を定義

102 schema = {102 schema = {

103 "type": "object",103 "type": "object",

104 "properties": {104 "properties": {


117 output_format={"type": "json_schema", "schema": schema}117 output_format={"type": "json_schema", "schema": schema}

118 ),118 ),

119 ):119 ):

120 # 結果メッセージには検証済みデータを含む structured_output が含まれます120 // 結果メッセージには検証済みデータを含む structured_output が含まれます

121 if isinstance(message, ResultMessage) and message.structured_output:121 if isinstance(message, ResultMessage) and message.structured_output:

122 print(message.structured_output)122 print(message.structured_output)

123 # {'company_name': 'Anthropic', 'founded_year': 2021, 'headquarters': 'San Francisco, CA'}123 # {'company_name': 'Anthropic', 'founded_year': 2021, 'headquarters': 'San Francisco, CA'}


245* `type`:構造化された出力の場合は `"json_schema"` に設定245* `type`:構造化された出力の場合は `"json_schema"` に設定

246* `schema`:出力構造を定義する [JSON Schema](https://json-schema.org/understanding-json-schema/about) オブジェクト。Zod スキーマから `z.toJSONSchema()` で、または Pydantic モデルから `.model_json_schema()` で生成できます。246* `schema`:出力構造を定義する [JSON Schema](https://json-schema.org/understanding-json-schema/about) オブジェクト。Zod スキーマから `z.toJSONSchema()` で、または Pydantic モデルから `.model_json_schema()` で生成できます。

247 247 

248SDK は、すべての基本型(object、array、string、number、boolean、null)、`enum`、`const`、`required`、ネストされたオブジェクト、および `$ref` 定義を含む標準 JSON Schema 機能をサポートしています。サポートされている機能と制限の完全なリストについては、[JSON Schema の制限](https://platform.claude.com/docs/en/build-with-claude/structured-outputs#json-schema-limitations) を参照してください。248SDK は、すべての基本型(object、array、string、number、boolean、null)、`enum`、`const`、`required`、ネストされたオブジェクト、および `$ref` 定義を含む標準 JSON Schema 機能をサポートしています。サポートされている機能と制限の完全なリストについては、[JSON Schema の制限](https://platform.claude.com/docs/ja/build-with-claude/structured-outputs#json-schema-limitations) を参照してください。

249 249 

250<h2 id="example-todo-tracking-agent">250<h2 id="example-todo-tracking-agent">

251 例:TODO トラッキングエージェント251 例:TODO トラッキングエージェント


358 エラーハンドリング358 エラーハンドリング

359</h2>359</h2>

360 360 

361エージェントがスキーマに一致する有効な JSON を生成できない場合、構造化された出力の生成は失敗する可能性があります。これは通常、スキーマがタスクに対して複雑すぎる場合、タスク自体が曖昧な場合、またはエージェントが検証エラーを修正しようとして再試行制限に達した場合に発生します。361構造化された出力の生成は、エージェントがスキーマに一致する有効な JSON を生成できない場合に失敗する可能性があります。これは通常、スキーマがタスクに対して複雑すぎる場合、タスク自体が曖昧な場合、またはエージェントが検証エラーを修正しようとして再試行制限に達した場合に発生します。また、検証の失敗がなくても発生する可能性があります。[モデルフォールバック](/ja/model-config#automatic-model-fallback)は既に完了した出力をストリーム中に取り消すことができ、再試行がそれを置き換えない場合、実行は同じエラーで終了します。デバッグの前に、結果メッセージの `errors` フィールドをチェックして、2 つの原因を区別してください。

362 362 

363エラーが発生すると、結果メッセージには何が問題かを示す `subtype` があります:363エラーが発生すると、結果メッセージには何が問題かを示す `subtype` があります:

364 364 

365| Subtype | 意味 |365| Subtype | 意味 |

366| ------------------------------------- | ------------------------------ |366| ------------------------------------- | ---------------------------------------------------------- |

367| `success` | 出力が正常に生成および検証されました |367| `success` | 出力が正常に生成および検証されました |

368| `error_max_structured_output_retries` | エージェントは複数の試行後に有効な出力を生成できませんでした |368| `error_max_structured_output_retries` | 複数の試行後に有効な出力が生き残りませんでした(検証の失敗、またはモデルフォールバックの取り消しで再試行がない場合) |

369 369 

370以下の例は、`subtype` フィールドをチェックして、出力が正常に生成されたか、失敗を処理する必要があるかを判断します:370以下の例は、`subtype` フィールドをチェックして、出力が正常に生成されたか、失敗を処理する必要があるかを判断します:

371 371 

Details

41 並列化41 並列化

42</h3>42</h3>

43 43 

44複数のサブエージェントを同時に実行でき、複雑なワークフローを劇的に高速化します44複数のサブエージェントを同時に実行でき、独立したサブタスクはすべての合計ではなく、最も遅いものの時間で完了します

45 45 

46**例:** コードレビュー中に、`style-checker`、`security-scanner`、`test-coverage` サブエージェントを同時に実行できレビュー時間を数分から数秒に短縮できます46**例:** コードレビュー中に、`style-checker`、`security-scanner`、`test-coverage` サブエージェントを順序立てて実行するのではなく同時に実行できます

47 47 

48<h3 id="specialized-instructions-and-knowledge">48<h3 id="specialized-instructions-and-knowledge">

49 特殊な指示と知識49 特殊な指示と知識


178</h3>178</h3>

179 179 

180| フィールド | 型 | 必須 | 説明 |180| フィールド | 型 | 必須 | 説明 |

181| :---------------- | :---------------------------------------------------------- | :-- | :------------------------------------------------------------------------------------------------------------------- |181| :---------------- | :---------------------------------------------------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------- |

182| `description` | `string` | はい | このエージェントをいつ使用するかについての自然言語説明 |182| `description` | `string` | はい | このエージェントをいつ使用するかについての自然言語説明 |

183| `prompt` | `string` | はい | エージェントの役割と動作を定義するシステムプロンプト |183| `prompt` | `string` | はい | エージェントの役割と動作を定義するシステムプロンプト |

184| `tools` | `string[]` | いいえ | 許可されたツール名の配列。省略した場合、すべてのツールを継承します |184| `tools` | `string[]` | いいえ | 許可されたツール名の配列。省略した場合、すべてのツールを継承します |

185| `disallowedTools` | `string[]` | いいえ | エージェントのツールセットから削除するツール名の配列 |185| `disallowedTools` | `string[]` | いいえ | エージェントのツールセットから削除するツール名の配列。MCP サーバーレベルのパターンも受け入れられます。`mcp__server` または `mcp__server__*` はそのサーバーからすべてのツールを削除し、`mcp__*` は任意のサーバーからすべての MCP ツールを削除します |

186| `model` | `string` | いいえ | このエージェントのモデルオーバーライド。`'sonnet'`、`'opus'`、`'haiku'`、`'inherit'` などのエイリアス、または完全なモデル ID を受け入れます。省略した場合、メインモデルがデフォルトになります |186| `model` | `string` | いいえ | このエージェントのモデルオーバーライド。`'fable'`、`'opus'`、`'sonnet'`、`'haiku'`、`'inherit'` などのエイリアス、または完全なモデル ID を受け入れます。省略した場合、メインモデルがデフォルトになります |

187| `skills` | `string[]` | いいえ | スタートアップ時にエージェントのコンテキストにプリロードするスキル名のリスト。リストされていないスキルは Skill ツール経由で呼び出し可能なままです |187| `skills` | `string[]` | いいえ | スタートアップ時にエージェントのコンテキストにプリロードするスキル名のリスト。リストされていないスキルは Skill ツール経由で呼び出し可能なままです |

188| `memory` | `'user' \| 'project' \| 'local'` | いいえ | このエージェントのメモリソース |188| `memory` | `'user' \| 'project' \| 'local'` | いいえ | このエージェントのメモリソース |

189| `mcpServers` | `(string \| object)[]` | いいえ | このエージェントが利用可能な MCP サーバー(名前またはインライン設定) |189| `mcpServers` | `(string \| object)[]` | いいえ | このエージェントが利用可能な MCP サーバー(名前またはインライン設定) |

190| `initialPrompt` | `string` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます。エージェントがサブエージェントとして呼び出される場合は無視されます |

190| `maxTurns` | `number` | いいえ | エージェントが停止する前の最大 agentic ターン数 |191| `maxTurns` | `number` | いいえ | エージェントが停止する前の最大 agentic ターン数 |

191| `background` | `boolean` | いいえ | 呼び出されたときにこのエージェントをノンブロッキングバックグラウンドタスクとして実行します |192| `background` | `boolean` | いいえ | 呼び出されたときにこのエージェントをノンブロッキングバックグラウンドタスクとして実行します |

192| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max' \| number` | いいえ | このエージェントの推論努力レベル |193| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max' \| number` | いいえ | このエージェントの推論努力レベル |


195Python SDK では、これらのフィールド名は wire フォーマットに一致するように camelCase を使用します。詳細については、[`AgentDefinition` リファレンス](/ja/agent-sdk/python#agentdefinition)を参照してください。196Python SDK では、これらのフィールド名は wire フォーマットに一致するように camelCase を使用します。詳細については、[`AgentDefinition` リファレンス](/ja/agent-sdk/python#agentdefinition)を参照してください。

196 197 

197<Note>198<Note>

198 サブエージェントは独自のサブエージェントを生成することはできませんサブエージェントの `tools` 配列に `Agent` を含めないでください199 {/* min-version: 2.1.172 */}Claude Code v2.1.172 以降、サブエージェントは独自のサブエージェントを生成できますメインエージェントの 5 レベル下のバックグラウンドサブエージェントはそれ以上のサブエージェントを生成できません。フォアグラウンドサブエージェントは任意の深さで生成できます。サブエージェントが他のサブエージェントを生成するのを防ぐには、その `tools` 配列から `Agent` を省略するか、`disallowedTools` に追加してください完全な深さルールについては、[ネストされたサブエージェント](/ja/sub-agents#spawn-nested-subagents)を参照してください。

199</Note>200</Note>

200 201 

201<h3 id="filesystem-based-definition-alternative">202<h3 id="filesystem-based-definition-alternative">


215サブエージェントのコンテキストウィンドウは新しく開始されます(親の会話なし)が、空ではありません。親からサブエージェントへの唯一のチャネルは Agent ツールのプロンプト文字列なので、サブエージェントが必要とするファイルパス、エラーメッセージ、または決定をそのプロンプトに直接含めてください。216サブエージェントのコンテキストウィンドウは新しく開始されます(親の会話なし)が、空ではありません。親からサブエージェントへの唯一のチャネルは Agent ツールのプロンプト文字列なので、サブエージェントが必要とするファイルパス、エラーメッセージ、または決定をそのプロンプトに直接含めてください。

216 217 

217| サブエージェントが受け取るもの | サブエージェントが受け取らないもの |218| サブエージェントが受け取るもの | サブエージェントが受け取らないもの |

218| :------------------------------------------------------ | :-------------------------------------------------------- |219| :------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------- |

219| 独自のシステムプロンプト(`AgentDefinition.prompt`)と Agent ツールのプロンプト | 親の会話履歴またはツール結果 |220| 独自のシステムプロンプト(`AgentDefinition.prompt`)と Agent ツールのプロンプト | 親の会話履歴またはツール結果 |

220| プロジェクト CLAUDE.md(`settingSources` 経由でロード) | プリロードされたスキルコンテンツ(`AgentDefinition.skills` にリストされている場合を除く) |221| プロジェクト CLAUDE.md([`settingSources`](/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) 経由でロード) | プリロードされたスキルコンテンツ(`AgentDefinition.skills` にリストされている場合を除く) |

221| ツール定義(親から継承、または `tools` のサブセット) | 親のシステムプロンプト |222| ツール定義(親から継承、または `tools` のサブセット) | 親のシステムプロンプト |

222 223 

223<Note>224<Note>


240 明示的な呼び出し241 明示的な呼び出し

241</h3>242</h3>

242 243 

243Claude が特定のサブエージェントを使用することを保証するには、プロンプトで名前を言及してください244Claude が特定のサブエージェントを使用することを保証するには、プロンプトで名前を言及してください

244 245 

245```text theme={null}246```text theme={null}

246"Use the code-reviewer agent to check the authentication module"247"Use the code-reviewer agent to check the authentication module"


336 ツール名は Claude Code v2.1.63 で `"Task"` から `"Agent"` に変更されました。現在の SDK リリースは `tool_use` ブロックで `"Agent"` を出力しますが、`system:init` ツールリストと `result.permission_denials[].tool_name` では引き続き `"Task"` を使用します。SDK バージョン全体での互換性を確保するために、`block.name` で両方の値をチェックしてください。337 ツール名は Claude Code v2.1.63 で `"Task"` から `"Agent"` に変更されました。現在の SDK リリースは `tool_use` ブロックで `"Agent"` を出力しますが、`system:init` ツールリストと `result.permission_denials[].tool_name` では引き続き `"Task"` を使用します。SDK バージョン全体での互換性を確保するために、`block.name` で両方の値をチェックしてください。

337</Note>338</Note>

338 339 

339この例はストリーミングされたメッセージを反復処理しサブエージェントが呼び出されたときとその後のメッセージがそのサブエージェントの実行コンテキスト内から発信されたときをログに記録します340メッセージ構造は SDK 間で異なります。Python ではコンテンツブロックは `message.content` 経由で直接アクセスされます。TypeScript では`SDKAssistantMessage` が Claude API メッセージをラップするためコンテンツは `message.message.content` 経由でアクセスされます

340 341 

341<Note>342この例は、ストリーミングされたメッセージを反復処理し、サブエージェントが呼び出されたときと、その後のメッセージがそのサブエージェントの実行コンテキスト内から発信されたときをログに記録します。

342 メッセージ構造は SDK 間で異なります。Python では、コンテンツブロックは `message.content` 経由で直接アクセスされます。TypeScript では、`SDKAssistantMessage` が Claude API メッセージをラップするため、コンテンツは `message.message.content` 経由でアクセスされます。

343</Note>

344 343 

345<CodeGroup>344<CodeGroup>

346 ```python Python theme={null}345 ```python Python theme={null}


427 426 

428サブエージェントを再開して、中断したところから続行できます。再開されたサブエージェントは、以前のすべてのツール呼び出し、結果、推論を含む完全な会話履歴を保持します。サブエージェントは新しく開始するのではなく、停止したところから正確に再開します。427サブエージェントを再開して、中断したところから続行できます。再開されたサブエージェントは、以前のすべてのツール呼び出し、結果、推論を含む完全な会話履歴を保持します。サブエージェントは新しく開始するのではなく、停止したところから正確に再開します。

429 428 

430サブエージェントが完了すると、Claude Agent ツール結果でエージェント ID を受け取ります。サブエージェントをプログラム的に再開するには:429サブエージェントが完了すると、Agent ツール結果には `agentId: <id>` を含むテキストブロックが含まれます。組み込みの [`Explore` および `Plan` エージェント](/ja/sub-agents#built-in-subagents) はワンショットであり、`agentId` を返さないため、再開が必要な場合はカスタムエージェントまたは `general-purpose` を使用してください。サブエージェントをプログラム的に再開するには:

431 430 

4321. **セッション ID をキャプチャする**: 最初のクエリ中にメッセージから `session_id` を抽出します4311. **セッション ID をキャプチャする**: 最初のクエリ中にメッセージから `session_id` を抽出します

4332. **エージェント ID を抽出する**: メッセージコンテンツから `agentId` を解析します4322. **エージェント ID を抽出する**: Agent ツール結果テキストから `agentId` を解析します

4343. **セッションを再開する**: 2 番目のクエリのオプションで `resume: sessionId` を渡し、プロンプトにエージェント ID を含めます4333. **セッションを再開する**: 2 番目のクエリのオプションで `resume: sessionId` を渡し、プロンプトにエージェント ID を含めます

435 434 

436<Note>435<Note>

437 サブエージェントのトランスクリプトにアクセスするには、同じセッションを再開する必要があります。各 `query()` 呼び出しはデフォルトで新しいセッションを開始するため、同じセッションで続行するには `resume: sessionId` を渡してください。436 サブエージェントのトランスクリプトにアクセスするには、同じセッションを再開する必要があります。各 `query()` 呼び出しはデフォルトで新しいセッションを開始するため、同じセッションで続行するには `resume: sessionId` を渡してください。

438 437 

439 カスタムエージェント(組み込みエージェントではない)を使用している場合は両方のクエリで `agents` パラメータに同じエージェント定義を渡す必要もあります438 カスタムエージェントを使用する場合は両方のクエリの `agents` パラメータで同じエージェント定義を渡してください

440</Note>439</Note>

441 440 

442以下の例は、このフローを示しています最初のクエリはサブエージェントを実行してセッション ID とエージェント ID をキャプチャし、2 番目のクエリはセッションを再開して、最初の分析からのコンテキストが必要なフォローアップ質問をします。441以下の例は、カスタム `endpoint-finder` エージェントを定義しています最初のクエリはそれを実行し、Agent ツール結果からセッション ID とエージェント ID をキャプチャします。その後、2 番目のクエリはセッションを再開して、最初の分析からのコンテキストが必要なフォローアップ質問をします。

443 442 

444<CodeGroup>443<CodeGroup>

445 ```typescript TypeScript theme={null}

446 import { query, type SDKMessage } from "@anthropic-ai/claude-agent-sdk";

447 

448 // Helper to extract agentId from message content

449 // Stringify to avoid traversing different block types (TextBlock, ToolResultBlock, etc.)

450 function extractAgentId(message: SDKMessage): string | undefined {

451 if (message.type !== "assistant" && message.type !== "user") return undefined;

452 // Stringify the content so we can search it without traversing nested blocks

453 const content = JSON.stringify(message.message.content);

454 const match = content.match(/agentId:\s*([a-f0-9-]+)/);

455 return match?.[1];

456 }

457 

458 let agentId: string | undefined;

459 let sessionId: string | undefined;

460 

461 // First invocation - use the Explore agent to find API endpoints

462 for await (const message of query({

463 prompt: "Use the Explore agent to find all API endpoints in this codebase",

464 options: { allowedTools: ["Read", "Grep", "Glob", "Agent"] }

465 })) {

466 // Capture session_id from ResultMessage (needed to resume this session)

467 if ("session_id" in message) sessionId = message.session_id;

468 // Search message content for the agentId (appears in Agent tool results)

469 const extractedId = extractAgentId(message);

470 if (extractedId) agentId = extractedId;

471 // Print the final result

472 if ("result" in message) console.log(message.result);

473 }

474 

475 // Second invocation - resume and ask follow-up

476 if (agentId && sessionId) {

477 for await (const message of query({

478 prompt: `Resume agent ${agentId} and list the top 3 most complex endpoints`,

479 options: { allowedTools: ["Read", "Grep", "Glob", "Agent"], resume: sessionId }

480 })) {

481 if ("result" in message) console.log(message.result);

482 }

483 }

484 ```

485 

486 ```python Python theme={null}444 ```python Python theme={null}

487 import asyncio445 import asyncio

488 import json

489 import re446 import re

490 from claude_agent_sdk import query, ClaudeAgentOptions447 from claude_agent_sdk import query, ClaudeAgentOptions, AgentDefinition, ToolResultBlock

448 

449 AGENTS = {

450 "endpoint-finder": AgentDefinition(

451 description="Locates and catalogs API endpoints in a codebase.",

452 prompt="You find and document API endpoints. Report each endpoint's path, method, and handler.",

453 tools=["Read", "Grep", "Glob"],

454 )

455 }

491 456 

492 457 

493 def extract_agent_id(text: str) -> str | None:458 def extract_agent_id(block: ToolResultBlock) -> str | None:

494 """Extract agentId from Agent tool result text."""459 """Extract agentId from an Agent tool result's text content."""

495 match = re.search(r"agentId:\s*([a-f0-9-]+)", text)460 parts = block.content if isinstance(block.content, list) else [{"text": block.content}]

496 return match.group(1) if match else None461 for part in parts:

462 if match := re.search(r"agentId:\s*([\w-]+)", part.get("text") or ""):

463 return match.group(1)

464 return None

497 465 

498 466 

499 async def main():467 async def main():

500 agent_id = None468 agent_id = None

501 session_id = None469 session_id = None

502 470 

503 # First invocation - use the Explore agent to find API endpoints471 # First invocation - run the endpoint-finder subagent

504 async for message in query(472 async for message in query(

505 prompt="Use the Explore agent to find all API endpoints in this codebase",473 prompt="Use the endpoint-finder agent to find all API endpoints in this codebase",

506 options=ClaudeAgentOptions(allowed_tools=["Read", "Grep", "Glob", "Agent"]),474 options=ClaudeAgentOptions(allowed_tools=["Read", "Grep", "Glob", "Agent"], agents=AGENTS),

507 ):475 ):

508 # Capture session_id from ResultMessage (needed to resume this session)476 # Capture session_id from ResultMessage (needed to resume this session)

509 if hasattr(message, "session_id"):477 if hasattr(message, "session_id"):

510 session_id = message.session_id478 session_id = message.session_id

511 # Search message content for the agentId (appears in Agent tool results)479 # Search tool results for the agentId trailer

512 if hasattr(message, "content"):480 for block in getattr(message, "content", None) or []:

513 # Stringify the content so we can search it without traversing nested blocks481 if isinstance(block, ToolResultBlock):

514 content_str = json.dumps(message.content, default=str)482 agent_id = extract_agent_id(block) or agent_id

515 extracted = extract_agent_id(content_str)

516 if extracted:

517 agent_id = extracted

518 # Print the final result483 # Print the final result

519 if hasattr(message, "result"):484 if hasattr(message, "result"):

520 print(message.result)485 print(message.result)


524 async for message in query(489 async for message in query(

525 prompt=f"Resume agent {agent_id} and list the top 3 most complex endpoints",490 prompt=f"Resume agent {agent_id} and list the top 3 most complex endpoints",

526 options=ClaudeAgentOptions(491 options=ClaudeAgentOptions(

527 allowed_tools=["Read", "Grep", "Glob", "Agent"], resume=session_id492 allowed_tools=["Read", "Grep", "Glob", "Agent"], agents=AGENTS, resume=session_id

528 ),493 ),

529 ):494 ):

530 if hasattr(message, "result"):495 if hasattr(message, "result"):


533 498 

534 asyncio.run(main())499 asyncio.run(main())

535 ```500 ```

501 

502 ```typescript TypeScript theme={null}

503 import { query, type SDKMessage } from "@anthropic-ai/claude-agent-sdk";

504 

505 const agents = {

506 "endpoint-finder": {

507 description: "Locates and catalogs API endpoints in a codebase.",

508 prompt: "You find and document API endpoints. Report each endpoint's path, method, and handler.",

509 tools: ["Read", "Grep", "Glob"]

510 }

511 };

512 

513 // Stringify content to search for agentId without traversing nested block types

514 function extractAgentId(message: SDKMessage): string | undefined {

515 if (message.type !== "assistant" && message.type !== "user") return undefined;

516 const content = JSON.stringify(message.message.content);

517 const match = content.match(/agentId:\s*([\w-]+)/);

518 return match?.[1];

519 }

520 

521 let agentId: string | undefined;

522 let sessionId: string | undefined;

523 

524 // First invocation - run the endpoint-finder subagent

525 for await (const message of query({

526 prompt: "Use the endpoint-finder agent to find all API endpoints in this codebase",

527 options: { allowedTools: ["Read", "Grep", "Glob", "Agent"], agents }

528 })) {

529 // Capture session_id from ResultMessage (needed to resume this session)

530 if ("session_id" in message) sessionId = message.session_id;

531 // Search message content for the agentId (appears in Agent tool results)

532 const extractedId = extractAgentId(message);

533 if (extractedId) agentId = extractedId;

534 // Print the final result

535 if ("result" in message) console.log(message.result);

536 }

537 

538 // Second invocation - resume and ask follow-up

539 if (agentId && sessionId) {

540 for await (const message of query({

541 prompt: `Resume agent ${agentId} and list the top 3 most complex endpoints`,

542 options: { allowedTools: ["Read", "Grep", "Glob", "Agent"], agents, resume: sessionId }

543 })) {

544 if ("result" in message) console.log(message.result);

545 }

546 }

547 ```

536</CodeGroup>548</CodeGroup>

537 549 

538サブエージェントのトランスクリプトはメイン会話とは独立して永続化されます550サブエージェントのトランスクリプトはメイン会話とは独立して永続化されます

539 551 

540* **メイン会話の圧縮**: メイン会話が圧縮されると、サブエージェントのトランスクリプトは影響を受けません。これらは別のファイルに保存されます。552* **メイン会話の圧縮**: メイン会話が圧縮されると、サブエージェントのトランスクリプトは影響を受けません。これらは別のファイルに保存されます。

541* **セッション永続化**: サブエージェントのトランスクリプトはセッション内で永続化されます。同じセッションを再開することで、Claude Code を再起動した後にサブエージェントを再開できます。553* **セッション永続化**: サブエージェントのトランスクリプトはセッション内で永続化されます。同じセッションを再開することで、Claude Code を再起動した後にサブエージェントを再開できます。

542* **自動クリーンアップ**: トランスクリプトは `cleanupPeriodDays` 設定に基づいてクリーンアップされます(デフォルト:30 日)。554* **自動クリーンアップ**: トランスクリプトは `cleanupPeriodDays` 設定に基づいてクリーンアップされます(デフォルト:30 日)。

543 555 

544<h2 id="tool-restrictions">556<h2 id="tool-restrictions-1">

545 ツール制限557 ツール制限

546</h2>558</h2>

547 559 

Details

217| アイテム形状:`{ content, status, activeForm }` | `TaskCreate` 入力:`{ subject, description, activeForm?, metadata? }`。`TaskUpdate` 入力:`{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`。`status` は `"pending"`、`"in_progress"`、または `"completed"`;削除するには `status: "deleted"` を設定 |217| アイテム形状:`{ content, status, activeForm }` | `TaskCreate` 入力:`{ subject, description, activeForm?, metadata? }`。`TaskUpdate` 入力:`{ taskId, status?, subject?, description?, activeForm?, addBlocks?, addBlockedBy?, owner?, metadata? }`。`status` は `"pending"`、`"in_progress"`、または `"completed"`;削除するには `status: "deleted"` を設定 |

218| `block.input.todos` を直接レンダリング | 呼び出し全体でアイテムを蓄積するか、ストリームから `TaskList` ツール結果のスナップショットを読み取る |218| `block.input.todos` を直接レンダリング | 呼び出し全体でアイテムを蓄積するか、ストリームから `TaskList` ツール結果のスナップショットを読み取る |

219 219 

220割り当てられたタスク ID は `TaskCreate` 入力にはありません。マッチング `tool_result` で `{ task: { id, subject } }` として返されるため、マップをキー付けするために結果ブロックからそれをキャプチャします。次の例は、[Todo 変更の監視](#monitoring-todo-changes)ループへの最小限の変更を示しています。完全なリストをレンダリングするには、ストリーム内の `TaskList` ツール結果を監視するか、`TaskCreate` 結果と `TaskUpdate` 入力をマップに蓄積します220割り当てられたタスク ID は `TaskCreate` 入力にはありません。マッチング `tool_result` で `{ task: { id, subject } }` として返されるため、マップをキー付けするために結果ブロックからそれをキャプチャします。次の例は、[Todo 変更の監視](#monitoring-todo-changes)ループへの最小限の変更を示しています。完全なリストをレンダリングするには、ストリーム内の `TaskList` ツール結果を監視するか、`TaskCreate` 結果と `TaskUpdate` 入力をマップに蓄積します

221 

222ストリーミングされた `tool_use` 入力は、モデルが発行した生の形状です。Claude Code は実行前にいくつかの近いが正確でないキー名を修復し、`id` または `task_id` を `taskId` にマッピングし、`active_form` を `activeForm` にマッピングしますが、その修復はストリームに反映されません。以下のサンプルのように、常に正規名が存在すると仮定するのではなく、`TaskUpdate` 入力フィールドを防御的に読み取ります。

221 223 

222<CodeGroup>224<CodeGroup>

223 ```typescript TypeScript theme={null}225 ```typescript TypeScript theme={null}


233 const input = block.input as { subject: string };235 const input = block.input as { subject: string };

234 console.log(`+ ${input.subject}`);236 console.log(`+ ${input.subject}`);

235 } else if (block.name === "TaskUpdate") {237 } else if (block.name === "TaskUpdate") {

236 const input = block.input as { taskId: string; status?: string };238 const input = block.input as {

237 if (input.status) console.log(` ${input.taskId} -> ${input.status}`);239 taskId?: string;

240 id?: string;

241 task_id?: string;

242 status?: string;

243 };

244 const taskId = input.taskId ?? input.id ?? input.task_id;

245 if (taskId && input.status) console.log(` ${taskId} -> ${input.status}`);

238 }246 }

239 }247 }

240 }248 }


254 if block.name == "TaskCreate":262 if block.name == "TaskCreate":

255 print(f"+ {block.input['subject']}")263 print(f"+ {block.input['subject']}")

256 elif block.name == "TaskUpdate" and block.input.get("status"):264 elif block.name == "TaskUpdate" and block.input.get("status"):

257 print(f" {block.input['taskId']} -> {block.input['status']}")265 task_id = (

266 block.input.get("taskId")

267 or block.input.get("id")

268 or block.input.get("task_id")

269 )

270 if task_id:

271 print(f" {task_id} -> {block.input['status']}")

258 ```272 ```

259</CodeGroup>273</CodeGroup>

260 274 

Details

100}): Promise<WarmQuery>;100}): Promise<WarmQuery>;

101```101```

102 102 

103<h4 id="parameters">103<h4 id="parameters-1">

104 パラメータ104 パラメータ

105</h4>105</h4>

106 106 


109| `options` | [`Options`](#options) | オプションの設定オブジェクト。`query()` の `options` パラメータと同じです |109| `options` | [`Options`](#options) | オプションの設定オブジェクト。`query()` の `options` パラメータと同じです |

110| `initializeTimeoutMs` | `number` | サブプロセス初期化を待つ最大時間(ミリ秒)。デフォルトは `60000` です。初期化が時間内に完了しない場合、プロミスはタイムアウトエラーで拒否されます |110| `initializeTimeoutMs` | `number` | サブプロセス初期化を待つ最大時間(ミリ秒)。デフォルトは `60000` です。初期化が時間内に完了しない場合、プロミスはタイムアウトエラーで拒否されます |

111 111 

112<h4 id="returns">112<h4 id="returns-1">

113 戻り値113 戻り値

114</h4>114</h4>

115 115 


149): SdkMcpToolDefinition<Schema>;149): SdkMcpToolDefinition<Schema>;

150```150```

151 151 

152<h4 id="parameters">152<h4 id="parameters-2">

153 パラメータ153 パラメータ

154</h4>154</h4>

155 155 


204}): McpSdkServerConfigWithInstance;204}): McpSdkServerConfigWithInstance;

205```205```

206 206 

207<h4 id="parameters">207<h4 id="parameters-3">

208 パラメータ208 パラメータ

209</h4>209</h4>

210 210 


224function listSessions(options?: ListSessionsOptions): Promise<SDKSessionInfo[]>;224function listSessions(options?: ListSessionsOptions): Promise<SDKSessionInfo[]>;

225```225```

226 226 

227<h4 id="parameters">227<h4 id="parameters-4">

228 パラメータ228 パラメータ

229</h4>229</h4>

230 230 


251| `tag` | `string \| undefined` | ユーザーが設定したセッションタグ([`tagSession()`](#tagsession) を参照) |251| `tag` | `string \| undefined` | ユーザーが設定したセッションタグ([`tagSession()`](#tagsession) を参照) |

252| `createdAt` | `number \| undefined` | 最初のエントリのタイムスタンプからのエポック以降のミリ秒単位での作成時刻 |252| `createdAt` | `number \| undefined` | 最初のエントリのタイムスタンプからのエポック以降のミリ秒単位での作成時刻 |

253 253 

254<h4 id="example">254<h4 id="example-1">

255255

256</h4>256</h4>

257 257 


280): Promise<SessionMessage[]>;280): Promise<SessionMessage[]>;

281```281```

282 282 

283<h4 id="parameters">283<h4 id="parameters-5">

284 パラメータ284 パラメータ

285</h4>285</h4>

286 286 


303| `message` | `unknown` | トランスクリプトからの生のメッセージペイロード |303| `message` | `unknown` | トランスクリプトからの生のメッセージペイロード |

304| `parent_tool_use_id` | `string \| null` | サブエージェントメッセージの場合、スポーニング `Agent` ツール呼び出しの `tool_use_id`。メインセッションメッセージおよび古いセッションの場合は `null` |304| `parent_tool_use_id` | `string \| null` | サブエージェントメッセージの場合、スポーニング `Agent` ツール呼び出しの `tool_use_id`。メインセッションメッセージおよび古いセッションの場合は `null` |

305 305 

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

307307

308</h4>308</h4>

309 309 


337): Promise<SDKSessionInfo | undefined>;337): Promise<SDKSessionInfo | undefined>;

338```338```

339 339 

340<h4 id="parameters">340<h4 id="parameters-6">

341 パラメータ341 パラメータ

342</h4>342</h4>

343 343 


362): Promise<void>;362): Promise<void>;

363```363```

364 364 

365<h4 id="parameters">365<h4 id="parameters-7">

366 パラメータ366 パラメータ

367</h4>367</h4>

368 368 


386): Promise<void>;386): Promise<void>;

387```387```

388 388 

389<h4 id="parameters">389<h4 id="parameters-8">

390 パラメータ390 パラメータ

391</h4>391</h4>

392 392 


412): Promise<ResolvedSettings>;412): Promise<ResolvedSettings>;

413```413```

414 414 

415<h4 id="parameters">415<h4 id="parameters-9">

416 パラメータ416 パラメータ

417</h4>417</h4>

418 418 


437| `provenance` | `Partial<Record<keyof Settings, ProvenanceEntry>>` | `effective` の各トップレベルキーについて、値を提供したソース |437| `provenance` | `Partial<Record<keyof Settings, ProvenanceEntry>>` | `effective` の各トップレベルキーについて、値を提供したソース |

438| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | ソースごとの生の設定。最も低い優先度から最も高い優先度の順に並べられています |438| `sources` | `Array<{ source, settings, path?, policyOrigin? }>` | ソースごとの生の設定。最も低い優先度から最も高い優先度の順に並べられています |

439 439 

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

441441

442</h4>442</h4>

443 443 


481| `debug` | `boolean` | `false` | Claude Code プロセスのデバッグモードを有効にします |481| `debug` | `boolean` | `false` | Claude Code プロセスのデバッグモードを有効にします |

482| `debugFile` | `string` | `undefined` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします |482| `debugFile` | `string` | `undefined` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします |

483| `disallowedTools` | `string[]` | `[]` | 拒否するツール。`Bash` などの単純な名前はツールを Claude のコンテキストから削除します。`Bash(rm *)` などのスコープ付きルールはツールを利用可能なままにし、`bypassPermissions` を含むすべてのパーミッションモードで一致する呼び出しを拒否します。[パーミッション](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照してください |483| `disallowedTools` | `string[]` | `[]` | 拒否するツール。`Bash` などの単純な名前はツールを Claude のコンテキストから削除します。`Bash(rm *)` などのスコープ付きルールはツールを利用可能なままにし、`bypassPermissions` を含むすべてのパーミッションモードで一致する呼び出しを拒否します。[パーミッション](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照してください |

484| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | `'high'` | Claude がその応答にどれだけの努力を費やすかを制御します。適応的思考と連携して思考の深さをガイドします |484| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | モデルのデフォルト | Claude がその応答にどれだけの努力を費やすかを制御します。適応的思考と連携して思考の深さをガイドします。[努力レベルを調整](/ja/model-config#adjust-effort-level) を参照してください |

485| `enableFileCheckpointing` | `boolean` | `false` | ファイル変更追跡を有効にして巻き戻します。[ファイルチェックポイント](/ja/agent-sdk/file-checkpointing) を参照してください |485| `enableFileCheckpointing` | `boolean` | `false` | ファイル変更追跡を有効にして巻き戻します。[ファイルチェックポイント](/ja/agent-sdk/file-checkpointing) を参照してください |

486| `env` | `Record<string, string \| undefined>` | `process.env` | 環境変数。設定すると、このオプションは `process.env` とマージする代わりに、サブプロセス環境を置き換えるため、継承された `PATH` などの変数を保つには `{ ...process.env, YOUR_VAR: 'value' }` を渡します。[遅いまたは停止した API レスポンスを処理](#handle-slow-or-stalled-api-responses) でこのパターンの例を参照してください。また、[環境変数](/ja/env-vars) で基になる CLI が読み取る変数を参照してください。User-Agent ヘッダーでアプリを識別するには `CLAUDE_AGENT_SDK_CLIENT_APP` を設定します |486| `env` | `Record<string, string \| undefined>` | `process.env` | 環境変数。設定すると、このオプションは `process.env` とマージする代わりに、サブプロセス環境を置き換えるため、継承された `PATH` などの変数を保つには `{ ...process.env, YOUR_VAR: 'value' }` を渡します。[遅いまたは停止した API レスポンスを処理](#handle-slow-or-stalled-api-responses) でこのパターンの例を参照してください。また、[環境変数](/ja/env-vars) で基になる CLI が読み取る変数を参照してください。User-Agent ヘッダーでアプリを識別するには `CLAUDE_AGENT_SDK_CLIENT_APP` を設定します |

487| `executable` | `'bun' \| 'deno' \| 'node'` | 自動検出 | 使用する JavaScript ランタイム |487| `executable` | `'bun' \| 'deno' \| 'node'` | 自動検出 | 使用する JavaScript ランタイム |


499| `maxThinkingTokens` | `number` | `undefined` | *非推奨:* 代わりに `thinking` を使用してください。思考プロセスの最大トークン数 |499| `maxThinkingTokens` | `number` | `undefined` | *非推奨:* 代わりに `thinking` を使用してください。思考プロセスの最大トークン数 |

500| `maxTurns` | `number` | `undefined` | 最大 agentic ターン数(ツール使用ラウンドトリップ) |500| `maxTurns` | `number` | `undefined` | 最大 agentic ターン数(ツール使用ラウンドトリップ) |

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

502| `model` | `string` | CLI からのデフォルト | 使用する Claude モデル |502| `model` | `string` | CLI からのデフォルト | Claude モデルエイリアスまたは完全なモデル名。[受け入れられた値とプロバイダー固有の ID](/ja/model-config#available-models) を参照してください |

503| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | MCP エリシテーションリクエストを処理するためのコールバック。MCP サーバーがユーザー入力をリクエストし、フックがそれを最初に処理しない場合に呼び出されます。提供されない場合、未処理のエリシテーションリクエストは自動的に拒否されます |503| `onElicitation` | `(request: ElicitationRequest, options: { signal: AbortSignal }) => Promise<ElicitationResult>` | `undefined` | MCP エリシテーションリクエストを処理するためのコールバック。MCP サーバーがユーザー入力をリクエストし、フックがそれを最初に処理しない場合に呼び出されます。提供されない場合、未処理のエリシテーションリクエストは自動的に拒否されます |

504| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェント結果の出力形式を定義します。詳細は [構造化出力](/ja/agent-sdk/structured-outputs) を参照してください |504| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェント結果の出力形式を定義します。詳細は [構造化出力](/ja/agent-sdk/structured-outputs) を参照してください |

505| `outputStyle` | `string` | `undefined` | `Options` フィールドではありません。インライン [`settings`](/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルをアクティブにする](/ja/agent-sdk/modifying-system-prompts#activate-an-output-style) を参照してください |505| `outputStyle` | `string` | `undefined` | `Options` フィールドではありません。インライン [`settings`](/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルをアクティブにする](/ja/agent-sdk/modifying-system-prompts#activate-an-output-style) を参照してください |


518| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *アルファ版。* `sessionStore` のフラッシュモード。`sessionStore` が設定されていない場合は無視されます |518| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *アルファ版。* `sessionStore` のフラッシュモード。`sessionStore` が設定されていない場合は無視されます |

519| `settings` | `string \| Settings` | `undefined` | インライン [設定](/ja/settings) オブジェクトまたは設定ファイルへのパス。[優先順位](/ja/settings#settings-precedence) のフラグ設定レイヤーを入力します。[`applyFlagSettings()`](#applyflagsettings) でランタイムに変更します |519| `settings` | `string \| Settings` | `undefined` | インライン [設定](/ja/settings) オブジェクトまたは設定ファイルへのパス。[優先順位](/ja/settings#settings-precedence) のフラグ設定レイヤーを入力します。[`applyFlagSettings()`](#applyflagsettings) でランタイムに変更します |

520| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI デフォルト(すべてのソース) | ロードするファイルシステム設定を制御します。ユーザー、プロジェクト、ローカル設定を無効にするには `[]` を渡します。管理ポリシー設定は関係なくロードされます。[Claude Code 機能を使用](/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照してください |520| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI デフォルト(すべてのソース) | ロードするファイルシステム設定を制御します。ユーザー、プロジェクト、ローカル設定を無効にするには `[]` を渡します。管理ポリシー設定は関係なくロードされます。[Claude Code 機能を使用](/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照してください |

521| `skills` | `string[] \| 'all'` | `undefined` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `'all'` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowedTools` にリストされていなくても Skill ツールを自動的に有効にします。[スキル](/ja/agent-sdk/skills) を参照してください |521| `skills` | `string[] \| 'all'` | `undefined` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `'all'` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowedTools` `'Skill'` を含めていなくても Skill ツールを自動的に追加します`tools` も渡す場合は、そのリストに `'Skill'` を含めます。[スキル](/ja/agent-sdk/skills) を参照してください |

522| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code プロセスをスポーンするカスタム関数。VM、コンテナ、またはリモート環境で Claude Code を実行するために使用します |522| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code プロセスをスポーンするカスタム関数。VM、コンテナ、またはリモート環境で Claude Code を実行するために使用します |

523| `stderr` | `(data: string) => void` | `undefined` | stderr 出力のコールバック |523| `stderr` | `(data: string) => void` | `undefined` | stderr 出力のコールバック |

524| `strictMcpConfig` | `boolean` | `false` | `mcpServers` で渡されたサーバーのみを使用し、プロジェクト `.mcp.json`、ユーザー設定、プラグイン提供の MCP サーバー、および [claude.ai コネクタ](/ja/mcp#use-mcp-servers-from-claude-ai) を無視します |524| `strictMcpConfig` | `boolean` | `false` | `mcpServers` で渡されたサーバーのみを使用し、プロジェクト `.mcp.json`、ユーザー設定、プラグイン提供の MCP サーバー、および [claude.ai コネクタ](/ja/mcp#use-mcp-servers-from-claude-ai) を無視します |


553* `API_TIMEOUT_MS`:Anthropic クライアントのリクエストごとのタイムアウト(ミリ秒単位)。デフォルト `600000`。メインループとすべてのサブエージェントに適用されます。553* `API_TIMEOUT_MS`:Anthropic クライアントのリクエストごとのタイムアウト(ミリ秒単位)。デフォルト `600000`。メインループとすべてのサブエージェントに適用されます。

554* `CLAUDE_CODE_MAX_RETRIES`:最大 API リトライ数。デフォルト `10`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の経過時間は約 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。554* `CLAUDE_CODE_MAX_RETRIES`:最大 API リトライ数。デフォルト `10`。各リトライは独自の `API_TIMEOUT_MS` ウィンドウを取得するため、最悪の場合の経過時間は約 `API_TIMEOUT_MS × (CLAUDE_CODE_MAX_RETRIES + 1)` にバックオフを加えたものです。

555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`:`run_in_background` で起動されたサブエージェントの停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。555* `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS`:`run_in_background` で起動されたサブエージェントの停止ウォッチドッグ。デフォルト `600000`。各ストリームイベントでリセットされます。停止時にサブエージェントを中止し、タスクを失敗とマークし、部分的な結果を含むエラーを親に表示します。同期サブエージェントには適用されません。

556* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`:ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。デフォルトではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルトで `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。556* `CLAUDE_ENABLE_STREAM_WATCHDOG=1` と `CLAUDE_STREAM_IDLE_TIMEOUT_MS`:ヘッダーが到着したがレスポンスボディがストリーミングを停止したときにリクエストを中止します。`CLAUDE_ENABLE_STREAM_WATCHDOG` が設定されていない場合、デフォルトは直接 Anthropic API ではサーバー制御で、他のプロバイダーではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` はデフォルトで `300000` で、その最小値にクランプされます。中止されたリクエストは通常のリトライパスを通ります。

557 557 

558<h3 id="query-object">558<h3 id="query-object">

559 `Query` オブジェクト559 `Query` オブジェクト


658}658}

659```659```

660 660 

661<h4 id="methods">661<h4 id="methods-1">

662 メソッド662 メソッド

663</h4>663</h4>

664 664 


717```717```

718 718 

719| フィールド | 必須 | 説明 |719| フィールド | 必須 | 説明 |

720| :------------------------------------ | :-- | :----------------------------------------------------------------------------------------------------------------------------- |720| :------------------------------------ | :-- | :---------------------------------------------------------------------------------------------------------------------------------------------------- |

721| `description` | はい | このエージェントをいつ使用するかの自然言語説明 |721| `description` | はい | このエージェントをいつ使用するかの自然言語説明 |

722| `tools` | いいえ | 許可されたツール名の配列。省略すると、親からすべてのツールを継承します。スキルをエージェントのコンテキストにプリロードするには、`tools` にリストするのではなく `skills` フィールドを使用します |722| `tools` | いいえ | 許可されたツール名の配列。省略すると、親からすべてのツールを継承します。スキルをエージェントのコンテキストにプリロードするには、`tools` にリストするのではなく `skills` フィールドを使用します |

723| `disallowedTools` | いいえ | このエージェントに対して明示的に許可しないツール名の配列 |723| `disallowedTools` | いいえ | このエージェントに対して明示的に許可しないツール名の配列。MCP サーバーレベルのパターンも受け入れられます:`mcp__server` または `mcp__server__*` はそのサーバーからすべてのツールを削除し、`mcp__*` はすべての MCP ツールをすべてのサーバーから削除します |

724| `prompt` | はい | エージェントのシステムプロンプト |724| `prompt` | はい | エージェントのシステムプロンプト |

725| `model` | いいえ | このエージェントのモデルオーバーライド。`'sonnet'`、`'opus'`、`'haiku'`、`'inherit'` などのエイリアス、または完全なモデル ID を受け入れます。省略または `'inherit'` の場合、メインモデルを使用します |725| `model` | いいえ | このエージェントのモデルオーバーライド。`'fable'`、`'opus'`、`'sonnet'`、`'haiku'`、`'inherit'` などのエイリアス、または完全なモデル ID を受け入れます。省略または `'inherit'` の場合、メインモデルを使用します |

726| `mcpServers` | いいえ | このエージェントの MCP サーバー仕様 |726| `mcpServers` | いいえ | このエージェントの MCP サーバー仕様 |

727| `skills` | いいえ | エージェントコンテキストにプリロードするスキル名の配列 |727| `skills` | いいえ | エージェントコンテキストにプリロードするスキル名の配列 |

728| `initialPrompt` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます |728| `initialPrompt` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます |


874type PermissionMode =874type PermissionMode =

875 | "default" // 標準的なパーミッション動作875 | "default" // 標準的なパーミッション動作

876 | "acceptEdits" // ファイル編集を自動承認876 | "acceptEdits" // ファイル編集を自動承認

877 | "bypassPermissions" // すべてのパーミッションチェックをバイパス877 | "bypassPermissions" // パーミッションチェックをバイパス;明示的な質問ルールはまだプロンプトします

878 | "plan" // 計画モード - 読み取り専用ツールのみ878 | "plan" // 計画モード - 編集なしで探索

879 | "dontAsk" // パーミッションをプロンプトしない、事前承認されていない場合は拒否879 | "dontAsk" // パーミッションをプロンプトしない、事前承認されていない場合は拒否

880 | "auto"; // モデル分類器を使用して各ツール呼び出しを承認または拒否880 | "auto"; // モデル分類器を使用して各ツール呼び出しを承認または拒否

881```881```


1035type SdkPluginConfig = {1035type SdkPluginConfig = {

1036 type: "local";1036 type: "local";

1037 path: string;1037 path: string;

1038 skipMcpDiscovery?: boolean;

1038};1039};

1039```1040```

1040 1041 

1041| フィールド | 型 | 説明 |1042| フィールド | 型 | 説明 |

1042| :----- | :-------- | :-------------------------------------- |1043| :----------------- | :-------- | :----------------------------------------------------------------------------------------------------------------------------------------- |

1043| `type` | `'local'` | `'local'` である必要があります(現在ローカルプラグインのみサポート) |1044| `type` | `'local'` | `'local'` である必要があります(現在ローカルプラグインのみサポート) |

1044| `path` | `string` | プラグインディレクトリへの絶対パスまたは相対パス |1045| `path` | `string` | プラグインディレクトリへの絶対パスまたは相対パス |

1046| `skipMcpDiscovery` | `boolean` | `true` の場合、SDK はこのプラグインからスキル、フック、エージェント、コマンドをロードしますが、その `.mcp.json` またはマニフェスト `mcpServers` は読み取りません。アプリケーションがプラグインの MCP 接続を所有している場合に設定します。 |

1045 1047 

1046**例:**1048**例:**

1047 1049 


1086 | SDKTaskProgressMessage1088 | SDKTaskProgressMessage

1087 | SDKTaskUpdatedMessage1089 | SDKTaskUpdatedMessage

1088 | SDKSessionStateChangedMessage1090 | SDKSessionStateChangedMessage

1091 | SDKWorkerShuttingDownMessage

1089 | SDKCommandsChangedMessage1092 | SDKCommandsChangedMessage

1090 | SDKNotificationMessage1093 | SDKNotificationMessage

1091 | SDKFilesPersistedEvent1094 | SDKFilesPersistedEvent


1096 | SDKPermissionDeniedMessage1099 | SDKPermissionDeniedMessage

1097 | SDKPromptSuggestionMessage1100 | SDKPromptSuggestionMessage

1098 | SDKAPIRetryMessage1101 | SDKAPIRetryMessage

1099 | SDKMirrorErrorMessage;1102 | SDKMirrorErrorMessage

1103 | SDKInformationalMessage;

1100```1104```

1101 1105 

1102<h3 id="sdkassistantmessage">1106<h3 id="sdkassistantmessage">


1183 result: string;1187 result: string;

1184 stop_reason: string | null;1188 stop_reason: string | null;

1185 ttft_ms?: number;1189 ttft_ms?: number;

1190 ttft_stream_ms?: number;

1186 total_cost_usd: number;1191 total_cost_usd: number;

1187 usage: NonNullableUsage;1192 usage: NonNullableUsage;

1188 modelUsage: { [modelName: string]: ModelUsage };1193 modelUsage: { [modelName: string]: ModelUsage };


1221結果の複数のフィールドは、`subtype` を超えた診断詳細を提供します:1226結果の複数のフィールドは、`subtype` を超えた診断詳細を提供します:

1222 1227 

1223* `api_error_status`:会話を終了させた API エラーの HTTP ステータスコード。ターンが API エラーなしで終了した場合、存在しないか `null` です。1228* `api_error_status`:会話を終了させた API エラーの HTTP ステータスコード。ターンが API エラーなしで終了した場合、存在しないか `null` です。

1224* `ttft_ms`:最初のトークンまでの時間(ミリ秒)。成功の場合のみ存在します。1229* `ttft_ms`:最初のトークンまでの時間(ミリ秒)。最初の完全なアシスタントメッセージが到着したときに測定されます。成功の場合のみ存在します。

1230* `ttft_stream_ms`:最初の `message_start` ストリームイベントまでの時間(ミリ秒)。レスポンスストリームが開くときです。`ttft_ms` より低く、2 つの間のギャップは最初のメッセージをストリーミングするのに費やされた時間です。成功の場合のみ存在します。

1225* `terminal_reason`:ループが終了した理由。`"completed"`、`"max_turns"`、`"tool_deferred"`、`"aborted_streaming"`、`"aborted_tools"`、`"hook_stopped"`、`"stop_hook_prevented"`、`"blocking_limit"`、`"rapid_refill_breaker"`、`"prompt_too_long"`、`"image_error"`、または `"model_error"` のいずれかです。1231* `terminal_reason`:ループが終了した理由。`"completed"`、`"max_turns"`、`"tool_deferred"`、`"aborted_streaming"`、`"aborted_tools"`、`"hook_stopped"`、`"stop_hook_prevented"`、`"blocking_limit"`、`"rapid_refill_breaker"`、`"prompt_too_long"`、`"image_error"`、または `"model_error"` のいずれかです。

1226* `fast_mode_state`:`"on"`、`"off"`、または `"cooldown"` のいずれかです。1232* `fast_mode_state`:`"on"`、`"off"`、または `"cooldown"` のいずれかです。

1227 1233 


1273 parent_tool_use_id: string | null;1279 parent_tool_use_id: string | null;

1274 uuid: UUID;1280 uuid: UUID;

1275 session_id: string;1281 session_id: string;

1282 ttft_ms?: number; // 最初のトークンまでの時間(ミリ秒)。message_start イベントにのみ存在

1276};1283};

1277```1284```

1278 1285 


1295};1302};

1296```1303```

1297 1304 

1305<h3 id="sdkinformationalmessage">

1306 `SDKInformationalMessage`

1307</h3>

1308 

1309ループによって発行される汎用テキストバナー。エラーではないステータス行、`UserPromptSubmit` フックのブロック理由などのフックフィードバック、およびコマンド出力を含みます。`content` を指定された `level` でプレーンテキストとしてレンダリングします。

1310 

1311```typescript theme={null}

1312type SDKInformationalMessage = {

1313 type: "system";

1314 subtype: "informational";

1315 content: string;

1316 level: "info" | "notice" | "suggestion" | "warning";

1317 tool_use_id?: string;

1318 prevent_continuation?: boolean;

1319 uuid: UUID;

1320 session_id: string;

1321};

1322```

1323 

1324<h3 id="sdkworkershuttingdownmessage">

1325 `SDKWorkerShuttingDownMessage`

1326</h3>

1327 

1328グレースフルワーカーティアダウン時に発行されるため、リモートクライアントはハートビートタイムアウトを待つ代わりにワーカーが消えた理由を表示できます。`reason` はホスト CLI によって設定される短い snake\_case 文字列です(`"host_exit"` や `"remote_control_disabled"` など)。ライブストリーミング時にのみこれに対応します。再開されたセッションはこのメッセージの過去のインスタンスを再生するため、その場合は無視してください。

1329 

1330```typescript theme={null}

1331type SDKWorkerShuttingDownMessage = {

1332 type: "system";

1333 subtype: "worker_shutting_down";

1334 reason: string;

1335 uuid: UUID;

1336 session_id: string;

1337};

1338```

1339 

1298<h3 id="sdkplugininstallmessage">1340<h3 id="sdkplugininstallmessage">

1299 `SDKPluginInstallMessage`1341 `SDKPluginInstallMessage`

1300</h3>1342</h3>


1369type SDKMessageOrigin =1411type SDKMessageOrigin =

1370 | { kind: "human" }1412 | { kind: "human" }

1371 | { kind: "channel"; server: string }1413 | { kind: "channel"; server: string }

1372 | { kind: "peer"; from: string; name?: string }1414 | { kind: "peer"; from: string; name?: string; senderTaskId?: string }

1373 | { kind: "task-notification" }1415 | { kind: "task-notification" }

1374 | { kind: "coordinator" };1416 | { kind: "coordinator" }

1417 | { kind: "auto-continuation" };

1375```1418```

1376 1419 

1377| `kind` | 意味 |1420| `kind` | 意味 |

1378| ------------------- | ------------------------------------------------------------------------------------------------ |1421| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1379| `human` | エンドユーザーからの直接入力。ユーザーメッセージでは、`origin` が存在しないこともヒューマン入力を意味します。 |1422| `human` | エンドユーザーからの直接入力。ユーザーメッセージでは、`origin` が存在しないこともヒューマン入力を意味します。 |

1380| `channel` | [チャネル](/ja/channels)に到着するメッセージ。`server` はソース MCP サーバー名です。 |1423| `channel` | [チャネル](/ja/channels)に到着するメッセージ。`server` はソース MCP サーバー名です。 |

1381| `peer` | `SendMessage` 経由で別のエージェントセッションからのメッセージ。`from` は送信者アドレス、`name` は利用可能な場合は送信者の表示名です。 |1424| `peer` | 別のエージェントセッションからのメッセージ用に予約されています。`from` は送信者アドレス、`name` は利用可能な場合は送信者の表示名です。`senderTaskId` はメッセージを送信したプロセス内バックグラウンドサブエージェントのタスク ID です。クロスセッションピアの場合は存在しません。Agent SDK はこのオリジンを発行しません。未知のオリジンとして扱ってください。 |

1382| `task-notification` | バックグラウンドタスク完了後に注入される合成ターン。[`SDKTaskNotificationMessage`](#sdktasknotificationmessage) を参照してください。 |1425| `task-notification` | バックグラウンドタスク完了後に注入される合成ターン。[`SDKTaskNotificationMessage`](#sdktasknotificationmessage) を参照してください。 |

1383| `coordinator` | [エージェントチーム](/ja/agent-teams)のチームコーディネーターからのメッセージ。 |1426| `coordinator` | [エージェントチーム](/ja/agent-teams)のチームコーディネーターからのメッセージ。 |

1427| `auto-continuation` | セッションが新しいユーザー入力なしで続行するときに注入される合成ターン(コマンド結果がフォローアッププロンプトをトリガーするなど)。 |

1384 1428 

1385<h2 id="hook-types">1429<h2 id="hook-types">

1386 フック型1430 フック型


1712type TeammateIdleHookInput = BaseHookInput & {1756type TeammateIdleHookInput = BaseHookInput & {

1713 hook_event_name: "TeammateIdle";1757 hook_event_name: "TeammateIdle";

1714 teammate_name: string;1758 teammate_name: string;

1759 /** @deprecated v2.1.178 以降は非推奨。セッション派生のチーム名を保持します。削除予定です。 */

1715 team_name: string;1760 team_name: string;

1716};1761};

1717```1762```


1727 task_subject: string;1772 task_subject: string;

1728 task_description?: string;1773 task_description?: string;

1729 teammate_name?: string;1774 teammate_name?: string;

1775 /** @deprecated v2.1.178 以降は非推奨。セッション派生のチーム名を保持します。削除予定です。 */

1730 team_name?: string;1776 team_name?: string;

1731};1777};

1732```1778```


1934 description: string;1980 description: string;

1935 prompt: string;1981 prompt: string;

1936 subagent_type: string;1982 subagent_type: string;

1937 model?: "sonnet" | "opus" | "haiku";1983 model?: "sonnet" | "opus" | "haiku" | "fable";

1938 resume?: string;1984 resume?: string;

1939 run_in_background?: boolean;1985 run_in_background?: boolean;

1940 max_turns?: number;1986 max_turns?: number;

1941 name?: string;1987 name?: string;

1942 team_name?: string;

1943 mode?: "acceptEdits" | "bypassPermissions" | "default" | "dontAsk" | "plan";1988 mode?: "acceptEdits" | "bypassPermissions" | "default" | "dontAsk" | "plan";

1944 isolation?: "worktree";1989 isolation?: "worktree";

1945};1990};


2385 | WorkflowOutput;2430 | WorkflowOutput;

2386```2431```

2387 2432 

2388<h3 id="agent">2433<h3 id="agent-1">

2389 Agent2434 Agent

2390</h3>2435</h3>

2391 2436 


2397 status: "completed";2442 status: "completed";

2398 agentId: string;2443 agentId: string;

2399 content: Array<{ type: "text"; text: string }>;2444 content: Array<{ type: "text"; text: string }>;

2445 resolvedModel?: string;

2400 totalToolUseCount: number;2446 totalToolUseCount: number;

2401 totalDurationMs: number;2447 totalDurationMs: number;

2402 totalTokens: number;2448 totalTokens: number;


2421 status: "async_launched";2467 status: "async_launched";

2422 agentId: string;2468 agentId: string;

2423 description: string;2469 description: string;

2470 resolvedModel?: string;

2424 prompt: string;2471 prompt: string;

2425 outputFile: string;2472 outputFile: string;

2426 canReadOutputFile?: boolean;2473 canReadOutputFile?: boolean;


2434 2481 

2435サブエージェントからの結果を返します。`status` フィールドで判別されます:完了したタスクの場合は `"completed"`、バックグラウンドタスクの場合は `"async_launched"`、インタラクティブサブエージェントの場合は `"sub_agent_entered"`。2482サブエージェントからの結果を返します。`status` フィールドで判別されます:完了したタスクの場合は `"completed"`、バックグラウンドタスクの場合は `"async_launched"`、インタラクティブサブエージェントの場合は `"sub_agent_entered"`。

2436 2483 

2437<h3 id="askuserquestion">2484`completed` および `async_launched` バリアントの `resolvedModel` フィールドは、サブエージェントが実際に実行されたモデルに名前を付けます。これは、[`availableModels`](/ja/model-config#restrict-model-selection) または別のオーバーライドが適用される場合、要求された `model` 入力と異なる場合があります。{/* min-version: 2.1.174 */}このフィールドには Claude Code v2.1.174 以降が必要です。

2485 

2486<h3 id="askuserquestion-1">

2438 AskUserQuestion2487 AskUserQuestion

2439</h3>2488</h3>

2440 2489 


2455 2504 

2456質問とユーザーの回答を返します。`response` はユーザーが構造化された質問に答える代わりに自由形式の返信を入力した場合に設定されます。存在する場合、Claude は質問ごとの回答リストの代わりに「ユーザーが応答しました:…」を受け取ります。2505質問とユーザーの回答を返します。`response` はユーザーが構造化された質問に答える代わりに自由形式の返信を入力した場合に設定されます。存在する場合、Claude は質問ごとの回答リストの代わりに「ユーザーが応答しました:…」を受け取ります。

2457 2506 

2458<h3 id="bash">2507<h3 id="bash-1">

2459 Bash2508 Bash

2460</h3>2509</h3>

2461 2510 


2480 2529 

2481stdout/stderr が分割されたコマンド出力を返します。バックグラウンドコマンドには `backgroundTaskId` が含まれます。2530stdout/stderr が分割されたコマンド出力を返します。バックグラウンドコマンドには `backgroundTaskId` が含まれます。

2482 2531 

2483<h3 id="monitor">2532<h3 id="monitor-1">

2484 Monitor2533 Monitor

2485</h3>2534</h3>

2486 2535 


2496 2545 

2497実行中のモニターのバックグラウンドタスク ID を返します。この ID を `TaskStop` で使用して、ウォッチを早期にキャンセルします。2546実行中のモニターのバックグラウンドタスク ID を返します。この ID を `TaskStop` で使用して、ウォッチを早期にキャンセルします。

2498 2547 

2499<h3 id="edit">2548<h3 id="edit-1">

2500 Edit2549 Edit

2501</h3>2550</h3>

2502 2551 


2530 2579 

2531編集操作の構造化された diff を返します。2580編集操作の構造化された diff を返します。

2532 2581 

2533<h3 id="read">2582<h3 id="read-1">

2534 Read2583 Read

2535</h3>2584</h3>

2536 2585 


2590 2639 

2591ファイルタイプに適切な形式でファイルコンテンツを返します。`type` フィールドで判別されます。2640ファイルタイプに適切な形式でファイルコンテンツを返します。`type` フィールドで判別されます。

2592 2641 

2593<h3 id="write">2642<h3 id="write-1">

2594 Write2643 Write

2595</h3>2644</h3>

2596 2645 


2622 2671 

2623構造化された diff 情報を含む書き込み結果を返します。2672構造化された diff 情報を含む書き込み結果を返します。

2624 2673 

2625<h3 id="glob">2674<h3 id="glob-1">

2626 Glob2675 Glob

2627</h3>2676</h3>

2628 2677 


2639 2688 

2640glob パターンに一致するファイルパスを返します。変更時刻でソートされます。2689glob パターンに一致するファイルパスを返します。変更時刻でソートされます。

2641 2690 

2642<h3 id="grep">2691<h3 id="grep-1">

2643 Grep2692 Grep

2644</h3>2693</h3>

2645 2694 


2660 2709 

2661検索結果を返します。形状は `mode` によって異なります:ファイルリスト、マッチを含むコンテンツ、またはマッチ数。2710検索結果を返します。形状は `mode` によって異なります:ファイルリスト、マッチを含むコンテンツ、またはマッチ数。

2662 2711 

2663<h3 id="taskstop">2712<h3 id="taskstop-1">

2664 TaskStop2713 TaskStop

2665</h3>2714</h3>

2666 2715 


2677 2726 

2678バックグラウンドタスクを停止した後の確認を返します。2727バックグラウンドタスクを停止した後の確認を返します。

2679 2728 

2680<h3 id="notebookedit">2729<h3 id="notebookedit-1">

2681 NotebookEdit2730 NotebookEdit

2682</h3>2731</h3>

2683 2732 


2699 2748 

2700元のファイルと更新されたファイルコンテンツを含むノートブック編集の結果を返します。2749元のファイルと更新されたファイルコンテンツを含むノートブック編集の結果を返します。

2701 2750 

2702<h3 id="webfetch">2751<h3 id="webfetch-1">

2703 WebFetch2752 WebFetch

2704</h3>2753</h3>

2705 2754 


2718 2767 

2719HTTP ステータスとメタデータを含む取得されたコンテンツを返します。2768HTTP ステータスとメタデータを含む取得されたコンテンツを返します。

2720 2769 

2721<h3 id="websearch">2770<h3 id="websearch-1">

2722 WebSearch2771 WebSearch

2723</h3>2772</h3>

2724 2773 


2740 2789 

2741ウェブからの検索結果を返します。2790ウェブからの検索結果を返します。

2742 2791 

2743<h3 id="workflow">2792<h3 id="workflow-1">

2744 Workflow2793 Workflow

2745</h3>2794</h3>

2746 2795 


2770| `scriptPath` | `string` | この実行のために永続化されたワークフロースクリプトへのパス。編集して `scriptPath` として戻すことで、スクリプトを再送信せずに再実行できます |2819| `scriptPath` | `string` | この実行のために永続化されたワークフロースクリプトへのパス。編集して `scriptPath` として戻すことで、スクリプトを再送信せずに再実行できます |

2771| `error` | `string` | スクリプトが構文チェックに失敗した場合に設定されます。存在する場合、`async_launched` ステータスにもかかわらず実行は開始されませんでした |2820| `error` | `string` | スクリプトが構文チェックに失敗した場合に設定されます。存在する場合、`async_launched` ステータスにもかかわらず実行は開始されませんでした |

2772 2821 

2773<h3 id="todowrite">2822<h3 id="todowrite-1">

2774 TodoWrite2823 TodoWrite

2775</h3>2824</h3>

2776 2825 


2797 TypeScript Agent SDK 0.3.142 以降、`TodoWrite` はデフォルトで無効になっています。代わりに `TaskCreate`、`TaskGet`、`TaskUpdate`、および `TaskList` を使用してください。[タスクツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools)を参照して、監視コードを更新するか、`CLAUDE_CODE_ENABLE_TASKS=0` を設定して `TodoWrite` に戻してください。2846 TypeScript Agent SDK 0.3.142 以降、`TodoWrite` はデフォルトで無効になっています。代わりに `TaskCreate`、`TaskGet`、`TaskUpdate`、および `TaskList` を使用してください。[タスクツールへの移行](/ja/agent-sdk/todo-tracking#migrate-to-task-tools)を参照して、監視コードを更新するか、`CLAUDE_CODE_ENABLE_TASKS=0` を設定して `TodoWrite` に戻してください。

2798</Note>2847</Note>

2799 2848 

2800<h3 id="taskcreate">2849<h3 id="taskcreate-1">

2801 TaskCreate2850 TaskCreate

2802</h3>2851</h3>

2803 2852 


2814 2863 

2815割り当てられた ID を持つ作成されたタスクを返します。2864割り当てられた ID を持つ作成されたタスクを返します。

2816 2865 

2817<h3 id="taskupdate">2866<h3 id="taskupdate-1">

2818 TaskUpdate2867 TaskUpdate

2819</h3>2868</h3>

2820 2869 


2835 2884 

2836更新結果を返します。どのフィールドが変更されたかを含みます。2885更新結果を返します。どのフィールドが変更されたかを含みます。

2837 2886 

2838<h3 id="taskget">2887<h3 id="taskget-1">

2839 TaskGet2888 TaskGet

2840</h3>2889</h3>

2841 2890 


2856 2905 

2857完全なタスクレコードを返します。ID が見つからない場合は `null` を返します。2906完全なタスクレコードを返します。ID が見つからない場合は `null` を返します。

2858 2907 

2859<h3 id="tasklist">2908<h3 id="tasklist-1">

2860 TaskList2909 TaskList

2861</h3>2910</h3>

2862 2911 


2876 2925 

2877現在のリスト内のすべてのタスクのスナップショットを返します。2926現在のリスト内のすべてのタスクのスナップショットを返します。

2878 2927 

2879<h3 id="exitplanmode">2928<h3 id="exitplanmode-1">

2880 ExitPlanMode2929 ExitPlanMode

2881</h3>2930</h3>

2882 2931 


2895 2944 

2896計画モード終了後の計画状態を返します。2945計画モード終了後の計画状態を返します。

2897 2946 

2898<h3 id="listmcpresources">2947<h3 id="listmcpresources-1">

2899 ListMcpResources2948 ListMcpResources

2900</h3>2949</h3>

2901 2950 


2913 2962 

2914利用可能な MCP リソースの配列を返します。2963利用可能な MCP リソースの配列を返します。

2915 2964 

2916<h3 id="readmcpresource">2965<h3 id="readmcpresource-1">

2917 ReadMcpResource2966 ReadMcpResource

2918</h3>2967</h3>

2919 2968 


2931 2980 

2932要求された MCP リソースのコンテンツを返します。2981要求された MCP リソースのコンテンツを返します。

2933 2982 

2934<h3 id="enterworktree">2983<h3 id="enterworktree-1">

2935 EnterWorktree2984 EnterWorktree

2936</h3>2985</h3>

2937 2986 


3010type PermissionUpdateDestination =3059type PermissionUpdateDestination =

3011 | "userSettings" // グローバルユーザー設定3060 | "userSettings" // グローバルユーザー設定

3012 | "projectSettings" // ディレクトリごとのプロジェクト設定3061 | "projectSettings" // ディレクトリごとのプロジェクト設定

3013 | "localSettings" // Gitignored ローカル設定3062 | "localSettings" // ローカルプロジェクト設定

3014 | "session" // 現在のセッションのみ3063 | "session" // 現在のセッションのみ

3015 | "cliArg"; // CLI 引数3064 | "cliArg"; // CLI 引数

3016```3065```


3049```3098```

3050 3099 

3051<Warning>3100<Warning>

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

3053</Warning>3102</Warning>

3054 3103 

3055<h3 id="slashcommand">3104<h3 id="slashcommand">


3241```typescript theme={null}3290```typescript theme={null}

3242type CallToolResult = {3291type CallToolResult = {

3243 content: Array<{3292 content: Array<{

3244 type: "text" | "image" | "resource";3293 type: "text" | "image" | "audio" | "resource" | "resource_link";

3245 // 追加フィールドはタイプによって異なります3294 // 追加フィールドはタイプによって異なります

3246 }>;3295 }>;

3247 structuredContent?: Record<string, unknown>;3296 structuredContent?: Record<string, unknown>;

Details

16 16 

17このガイドでは、各タイプのリクエストを検出し、適切に応答する方法を示します。17このガイドでは、各タイプのリクエストを検出し、適切に応答する方法を示します。

18 18 

19## Claude が入力を必要とする場合を検出する19<h2 id="detect-when-claude-needs-input">

20 Claude が入力を必要とする場合を検出する

21</h2>

20 22 

21クエリオプションで `canUseTool` コールバックを渡します。Claude がユーザー入力を必要とするたびにコールバックが発火し、ツール名と入力を引数として受け取ります。23クエリオプションで `canUseTool` コールバックを渡します。Claude がユーザー入力を必要とするたびにコールバックが発火し、ツール名と入力を引数として受け取ります。

22 24 


49 ユーザーにプロンプトを表示せずにツールを自動的に許可または拒否するには、代わりに [フック](/ja/agent-sdk/hooks)を使用します。フックは `canUseTool` の前に実行され、独自のロジックに基づいてリクエストを許可、拒否、または変更できます。また、[`PermissionRequest` フック](/ja/agent-sdk/hooks#available-hooks)を使用して、Claude が承認を待っているときに外部通知(Slack、メール、プッシュ)を送信することもできます。51 ユーザーにプロンプトを表示せずにツールを自動的に許可または拒否するには、代わりに [フック](/ja/agent-sdk/hooks)を使用します。フックは `canUseTool` の前に実行され、独自のロジックに基づいてリクエストを許可、拒否、または変更できます。また、[`PermissionRequest` フック](/ja/agent-sdk/hooks#available-hooks)を使用して、Claude が承認を待っているときに外部通知(Slack、メール、プッシュ)を送信することもできます。

50</Note>52</Note>

51 53 

52## ツール承認リクエストを処理する54<h2 id="handle-tool-approval-requests">

55 ツール承認リクエストを処理する

56</h2>

53 57 

54クエリオプションで `canUseTool` コールバックを渡すと、Claude が自動承認されていないツールを使用したい場合に発火します。コールバックは 3 つの引数を受け取ります。58クエリオプションで `canUseTool` コールバックを渡すと、Claude が自動承認されていないツールを使用したい場合に発火します。コールバックは 3 つの引数を受け取ります。

55 59 


197 201 

198この例では y/n フローを使用しており、`y` 以外の入力は拒否として扱われます。実際には、ユーザーがリクエストを変更したり、フィードバックを提供したり、Claude を完全にリダイレクトしたりできるより豊富な UI を構築する可能性があります。すべての応答方法については [ツールリクエストに応答する](#respond-to-tool-requests)を参照してください。202この例では y/n フローを使用しており、`y` 以外の入力は拒否として扱われます。実際には、ユーザーがリクエストを変更したり、フィードバックを提供したり、Claude を完全にリダイレクトしたりできるより豊富な UI を構築する可能性があります。すべての応答方法については [ツールリクエストに応答する](#respond-to-tool-requests)を参照してください。

199 203 

200### ツールリクエストに応答する204<h3 id="respond-to-tool-requests">

205 ツールリクエストに応答する

206</h3>

201 207 

202コールバックは 2 つの応答タイプのいずれかを返します。208コールバックは 2 つの応答タイプのいずれかを返します。

203 209 


407 </Tab>413 </Tab>

408</Tabs>414</Tabs>

409 415 

410## 確認質問を処理する416<h2 id="handle-clarifying-questions">

417 確認質問を処理する

418</h2>

411 419 

412Claude が複数の有効なアプローチを持つタスクについてさらに方向性が必要な場合、`AskUserQuestion` ツールを呼び出します。これは `toolName` が `AskUserQuestion` に設定された `canUseTool` コールバックをトリガーします。入力には Claude の質問が複数選択肢として含まれており、これらをユーザーに表示して、ユーザーの選択を返します。420Claude が複数の有効なアプローチを持つタスクについてさらに方向性が必要な場合、`AskUserQuestion` ツールを呼び出します。これは `toolName` が `AskUserQuestion` に設定された `canUseTool` コールバックをトリガーします。入力には Claude の質問が複数選択肢として含まれており、これらをユーザーに表示して、ユーザーの選択を返します。

413 421 


551 </Step>559 </Step>

552</Steps>560</Steps>

553 561 

554### 質問形式562<h3 id="question-format">

563 質問形式

564</h3>

555 565 

556入力には Claude が生成した質問が `questions` 配列に含まれています。各質問には以下のフィールドがあります。566入力には Claude が生成した質問が `questions` 配列に含まれています。各質問には以下のフィールドがあります。

557 567 

558| フィールド | 説明 |568| フィールド | 説明 |

559| ------------- | -------------------------------------------------------------------------------------------------------------------------------- |569| ------------- | ------------------------------------------------------------------------------------------------------------------------------- |

560| `question` | 表示する完全な質問テキスト |570| `question` | 表示する完全な質問テキスト |

561| `header` | 質問の短いラベル(最大 12 文字) |571| `header` | 質問の短いラベル(最大 12 文字) |

562| `options` | 2~4 個の選択肢の配列。各選択肢には `label` と `description` があります。TypeScript:オプションで `preview`(下記の [オプションプレビュー](#option-previews-type-script)を参照) |572| `options` | 2~4 個の選択肢の配列。各選択肢には `label` と `description` があります。TypeScript:オプションで `preview`(下記の [オプションプレビュー](#option-previews-typescript)を参照) |

563| `multiSelect` | `true` の場合、ユーザーは複数のオプションを選択できます |573| `multiSelect` | `true` の場合、ユーザーは複数のオプションを選択できます |

564 574 

565コールバックが受け取る構造:575コールバックが受け取る構造:


580}590}

581```591```

582 592 

583#### オプションプレビュー(TypeScript)593<h4 id="option-previews-typescript">

594 オプションプレビュー(TypeScript)

595</h4>

584 596 

585`toolConfig.askUserQuestion.previewFormat` は各オプションに `preview` フィールドを追加して、アプリがラベルと一緒に視覚的なモックアップを表示できるようにします。この設定がない場合、Claude はプレビューを生成せず、フィールドは存在しません。597`toolConfig.askUserQuestion.previewFormat` は各オプションに `preview` フィールドを追加して、アプリがラベルと一緒に視覚的なモックアップを表示できるようにします。この設定がない場合、Claude はプレビューを生成せず、フィールドは存在しません。

586 598 


621}633}

622```634```

623 635 

624### 応答形式636<h3 id="response-format">

637 応答形式

638</h3>

625 639 

626各質問の `question` フィールドを選択されたオプションの `label` にマップする `answers` オブジェクトを返します。640各質問の `question` フィールドを選択されたオプションの `label` にマップする `answers` オブジェクトを返します。

627 641 


645}659}

646```660```

647 661 

648#### 自由テキスト入力をサポートする662<h4 id="support-free-text-input">

663 自由テキスト入力をサポートする

664</h4>

649 665 

650Claude の定義済みオプションがユーザーが望むものをカバーしていない場合があります。ユーザーが独自の回答を入力できるようにするには:666Claude の定義済みオプションがユーザーが望むものをカバーしていない場合があります。ユーザーが独自の回答を入力できるようにするには:

651 667 


654 670 

655完全な実装については、下記の [完全な例](#complete-example)を参照してください。671完全な実装については、下記の [完全な例](#complete-example)を参照してください。

656 672 

657### 完全な例673<h3 id="complete-example">

674 完全な例

675</h3>

658 676 

659Claude は、タスクを進めるためにユーザー入力が必要な場合に確認質問をします。たとえば、モバイルアプリのテックスタックを決定するのに役立つよう求められた場合、Claude はクロスプラットフォーム対応 vs ネイティブ、バックエンド設定、またはターゲットプラットフォームについて質問する可能性があります。これらの質問は、Claude がユーザーの設定に合致する決定を下すのに役立ちます。推測ではなく。677Claude は、タスクを進めるためにユーザー入力が必要な場合に確認質問をします。たとえば、モバイルアプリのテックスタックを決定するのに役立つよう求められた場合、Claude はクロスプラットフォーム対応 vs ネイティブ、バックエンド設定、またはターゲットプラットフォームについて質問する可能性があります。これらの質問は、Claude がユーザーの設定に合致する決定を下すのに役立ちます。推測ではなく。

660 678 


821 ```839 ```

822</CodeGroup>840</CodeGroup>

823 841 

824## 制限事項842<h2 id="limitations">

843 制限事項

844</h2>

825 845 

826* **サブエージェント**:`AskUserQuestion` は現在、Agent ツール経由で生成されたサブエージェントでは利用できません846* **サブエージェント**:`AskUserQuestion` は現在、Agent ツール経由で生成されたサブエージェントでは利用できません

827* **質問の制限**:各 `AskUserQuestion` 呼び出しは 1~4 個の質問と 2~4 個のオプションをサポートします847* **質問の制限**:各 `AskUserQuestion` 呼び出しは 1~4 個の質問と 2~4 個のオプションをサポートします

828 848 

829## ユーザー入力を取得する他の方法849<h2 id="other-ways-to-get-user-input">

850 ユーザー入力を取得する他の方法

851</h2>

830 852 

831`canUseTool` コールバックと `AskUserQuestion` ツールはほとんどの承認と明確化のシナリオをカバーしていますが、SDK はユーザーから入力を取得する他の方法を提供しています。853`canUseTool` コールバックと `AskUserQuestion` ツールはほとんどの承認と明確化のシナリオをカバーしていますが、SDK はユーザーから入力を取得する他の方法を提供しています。

832 854 

833### ストリーミング入力855<h3 id="streaming-input">

856 ストリーミング入力

857</h3>

834 858 

835以下が必要な場合は [ストリーミング入力](/ja/agent-sdk/streaming-vs-single-mode)を使用します。859以下が必要な場合は [ストリーミング入力](/ja/agent-sdk/streaming-vs-single-mode)を使用します。

836 860 


840 864 

841ストリーミング入力は、承認チェックポイントだけでなく、実行全体を通じてユーザーがエージェントと対話する会話型 UI に最適です。865ストリーミング入力は、承認チェックポイントだけでなく、実行全体を通じてユーザーがエージェントと対話する会話型 UI に最適です。

842 866 

843### カスタムツール867<h3 id="custom-tools">

868 カスタムツール

869</h3>

844 870 

845以下が必要な場合は [カスタムツール](/ja/agent-sdk/custom-tools)を使用します。871以下が必要な場合は [カスタムツール](/ja/agent-sdk/custom-tools)を使用します。

846 872 


850 876 

851カスタムツールは対話を完全に制御できますが、組み込みの `canUseTool` コールバックを使用するよりも実装作業が必要です。877カスタムツールは対話を完全に制御できますが、組み込みの `canUseTool` コールバックを使用するよりも実装作業が必要です。

852 878 

853## 関連リソース879<h2 id="related-resources">

880 関連リソース

881</h2>

854 882 

855* [権限を設定する](/ja/agent-sdk/permissions):権限モードとルールを設定する883* [権限を設定する](/ja/agent-sdk/permissions):権限モードとルールを設定する

856* [フックで実行を制御する](/ja/agent-sdk/hooks):エージェントライフサイクルの重要なポイントでカスタムコードを実行する884* [フックで実行を制御する](/ja/agent-sdk/hooks):エージェントライフサイクルの重要なポイントでカスタムコードを実行する

agent-teams.md +142 −76

Details

7> 複数の Claude Code インスタンスがチームとして連携して動作するように調整し、共有タスク、エージェント間メッセージング、および一元管理を実現します。7> 複数の Claude Code インスタンスがチームとして連携して動作するように調整し、共有タスク、エージェント間メッセージング、および一元管理を実現します。

8 8 

9<Warning>9<Warning>

10 エージェントチームは実験的機能であり、デフォルトでは無効になっています。[settings.json](/ja/settings) または環境に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` を追加して有効にしてください。エージェントチームには、セッション再開、タスク調整、シャットダウン動作に関する[既知の制限](#limitations)があります。10 エージェントチームは実験的機能であり、デフォルトでは無効になっています。[settings.json](/ja/settings) または環境に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` を追加して有効にしてください。その変数がない場合、セッション開始時にチームが設定されず、チームディレクトリが書き込まれず、Claude はチームメンバーをスポーンまたは提案しません。エージェントチームには、セッション再開、タスク調整、シャットダウン動作に関する[既知の制限](#limitations)があります。

11</Warning>11</Warning>

12 12 

13エージェントチームを使用すると、複数の Claude Code インスタンスが連携して動作するように調整できます。1 つのセッションがチームリーダーとして機能し、作業を調整し、タスクを割り当て、結果を統合します。チームメンバーは独立して動作し、それぞれ独自のコンテキストウィンドウで動作し、互いに直接通信します。13エージェントチームを使用すると、複数の Claude Code インスタンスが連携して動作するように調整できます。1 つのセッションがチームリーダーとして機能し、作業を調整し、タスクを割り当て、結果を統合します。チームメンバーは独立して動作し、それぞれ独自のコンテキストウィンドウで動作し、互いに直接通信します。


15[subagents](/ja/sub-agents)(単一セッション内で実行され、メインエージェントにのみ報告できる)とは異なり、リーダーを経由せずに個別のチームメンバーと直接対話することもできます。15[subagents](/ja/sub-agents)(単一セッション内で実行され、メインエージェントにのみ報告できる)とは異なり、リーダーを経由せずに個別のチームメンバーと直接対話することもできます。

16 16 

17<Note>17<Note>

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

19</Note>19</Note>

20 20 

21このページでは、以下について説明します。21このページでは、以下について説明します。


25* [チームメンバーを制御する](#control-your-agent-team)(表示モード、タスク割り当て、委任を含む)25* [チームメンバーを制御する](#control-your-agent-team)(表示モード、タスク割り当て、委任を含む)

26* [並列作業のベストプラクティス](#best-practices)26* [並列作業のベストプラクティス](#best-practices)

27 27 

28## エージェントチームを使用する場合28<h2 id="when-to-use-agent-teams">

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

30</h2>

29 31 

30エージェントチームは、並列探索が実際の価値を追加するタスクに最も効果的です。完全なシナリオについては、[ユースケース例](#use-case-examples)を参照してください。最も強力なユースケースは以下の通りです。32エージェントチームは、並列探索が実際の価値を追加するタスクに最も効果的です。完全なシナリオについては、[ユースケース例](#use-case-examples)を参照してください。最も強力なユースケースは以下の通りです。

31 33 


36 38 

37エージェントチームは調整オーバーヘッドを追加し、単一セッションよりも大幅に多くのトークンを使用します。チームメンバーが独立して動作できる場合に最も効果的です。順序付きタスク、同じファイルの編集、または多くの依存関係を持つ作業の場合は、単一セッションまたは [subagents](/ja/sub-agents) がより効果的です。39エージェントチームは調整オーバーヘッドを追加し、単一セッションよりも大幅に多くのトークンを使用します。チームメンバーが独立して動作できる場合に最も効果的です。順序付きタスク、同じファイルの編集、または多くの依存関係を持つ作業の場合は、単一セッションまたは [subagents](/ja/sub-agents) がより効果的です。

38 40 

39### subagents との比較41<h3 id="compare-with-subagents">

42 subagents との比較

43</h3>

40 44 

41エージェントチームと [subagents](/ja/sub-agents) の両方を使用すると、作業を並列化できますが、動作方法が異なります。ワーカーが互いに通信する必要があるかどうかに基づいて選択してください。45エージェントチームと [subagents](/ja/sub-agents) の両方を使用すると、作業を並列化できますが、動作方法が異なります。ワーカーが互いに通信する必要があるかどうかに基づいて選択してください。

42 46 


56 60 

57結果を報告する必要がある迅速で焦点を絞ったワーカーが必要な場合は subagents を使用してください。チームメンバーが調査結果を共有し、互いに検証し、独立して調整する必要がある場合は、エージェントチームを使用してください。61結果を報告する必要がある迅速で焦点を絞ったワーカーが必要な場合は subagents を使用してください。チームメンバーが調査結果を共有し、互いに検証し、独立して調整する必要がある場合は、エージェントチームを使用してください。

58 62 

59## エージェントチームを有効にする63<h2 id="enable-agent-teams">

64 エージェントチームを有効にする

65</h2>

60 66 

61エージェントチームはデフォルトでは無効になっています。`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` 環境変数を `1` に設定して有効にしてください。シェル環境または [settings.json](/ja/settings) を通じて設定できます。67エージェントチームはデフォルトでは無効になっています。`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` 環境変数を `1` に設定して有効にしてください。シェル環境または [settings.json](/ja/settings) を通じて設定できます。

62 68 


68}74}

69```75```

70 76 

71## 最初のエージェントチームを開始する77<h2 id="start-your-first-agent-team">

78 最初のエージェントチームを開始する

79</h2>

72 80 

73エージェントチームを有効にした後、Claude に対してエージェントチームを作成するよう指示し、自然言語でタスクとチーム構成を説明してください。Claude がチームを作成し、チームメンバーを生成し、プロンプトに基づいて作業を調整します。81エージェントチームを有効にした後、実行したいタスクとチームメンバーを自然言語で説明してください。Claude がチームメンバーを生成し、プロンプトに基づいて作業を調整します。

74 82 

75この例は、3 つの役割が独立しており、互いに待つことなく問題を探索できるため、うまく機能します。83この例は、3 つの役割が独立しており、互いに待つことなく問題を探索できるため、うまく機能します。

76 84 

77```text theme={null}85```text theme={null}

78I'm designing a CLI tool that helps developers track TODO comments across86I'm designing a CLI tool that helps developers track TODO comments across

79their codebase. Create an agent team to explore this from different angles: one87their codebase. Spawn three teammates to explore this from different angles:

80teammate on UX, one on technical architecture, one playing devil's advocate.88one on UX, one on technical architecture, one playing devil's advocate.

81```89```

82 90 

83その後、Claude は [共有タスクリスト](/ja/interactive-mode#task-list) を持つチームを作成し、各視点のチームメンバーを生成し、問題を探索させ、調査結果を統合し、完了時に [チームをクリーンアップ](#clean-up-the-team) しようとします91その後、Claude は [共有タスクリスト](/ja/interactive-mode#task-list) を作成し、各視点のチームメンバーを生成し、問題を探索させ、完了時に調査結果を統合します

84 92 

85リーダーのターミナルには、すべてのチームメンバーと彼らが取り組んでいる内容が表示されます。Shift+Down を使用してチームメンバーをサイクルして、直接メッセージを送信してください。最後のチームメンバーの後、Shift+Down はリーダーに戻ります。93リーダーのターミナルには、すべてのチームメンバーと彼らが取り組んでいる内容が表示されます。Shift+Down を使用してチームメンバーをサイクルして、直接メッセージを送信してください。最後のチームメンバーの後、Shift+Down はリーダーに戻ります。

86 94 

87各チームメンバーを独自の分割ペインに配置したい場合は、[表示モードを選択](#choose-a-display-mode)を参照してください。95各チームメンバーを独自の分割ペインに配置したい場合は、[表示モードを選択](#choose-a-display-mode)を参照してください。

88 96 

89## エージェントチームを制御する97<h2 id="control-your-agent-team">

98 エージェントチームを制御する

99</h2>

90 100 

91リーダーに自然言語で実行したい内容を指示してください。チーム調整、タスク割り当て、および指示に基づいた委任を処理します。101リーダーに自然言語で実行したい内容を指示してください。チーム調整、タスク割り当て、および指示に基づいた委任を処理します。

92 102 

93### 表示モードを選択する103<h3 id="choose-a-display-mode">

104 表示モードを選択する

105</h3>

94 106 

95エージェントチームは 2 つの表示モードをサポートしています。107エージェントチームは 2 つの表示モードをサポートしています。

96 108 


120* **tmux**:システムのパッケージマネージャーを通じてインストールしてください。プラットフォーム固有の手順については、[tmux wiki](https://github.com/tmux/tmux/wiki/Installing) を参照してください。132* **tmux**:システムのパッケージマネージャーを通じてインストールしてください。プラットフォーム固有の手順については、[tmux wiki](https://github.com/tmux/tmux/wiki/Installing) を参照してください。

121* **iTerm2**:[`it2` CLI](https://github.com/mkusaka/it2) をインストールし、**iTerm2 → Settings → General → Magic → Enable Python API** で Python API を有効にしてください。133* **iTerm2**:[`it2` CLI](https://github.com/mkusaka/it2) をインストールし、**iTerm2 → Settings → General → Magic → Enable Python API** で Python API を有効にしてください。

122 134 

123### チームメンバーとモデルを指定する135<h3 id="specify-teammates-and-models">

136 チームメンバーとモデルを指定する

137</h3>

124 138 

125Claude はタスクに基づいて生成するチームメンバーの数を決定するか、正確に実行したい内容を指定できます。139Claude はタスクに基づいて生成するチームメンバーの数を決定するか、正確に実行したい内容を指定できます。

126 140 

127```text theme={null}141```text theme={null}

128Create a team with 4 teammates to refactor these modules in parallel.142Spawn 4 teammates to refactor these modules in parallel. Use Sonnet for

129Use Sonnet for each teammate.143each teammate.

130```144```

131 145 

132チームメンバーはデフォルトではリーダーの `/model` 選択を継承しません。プロンプトで指定されていない場合に使用されるモデルを変更するには、`/config` で **Default teammate model** を設定してください。チームメンバーがリーダーの現在のモデルに従うようにするには、**Default (leader's model)** を選択してください。146チームメンバーはデフォルトではリーダーの `/model` 選択を継承しません。プロンプトで指定されていない場合に使用されるモデルを変更するには、`/config` で **Default teammate model** を設定してください。チームメンバーがリーダーの現在のモデルに従うようにするには、**Default (leader's model)** を選択してください。

133 147 

134### チームメンバーのプラン承認を要求する148<h3 id="require-plan-approval-for-teammates">

149 チームメンバーのプラン承認を要求する

150</h3>

135 151 

136複雑またはリスクの高いタスクの場合、チームメンバーが実装前にプランを立てることを要求できます。チームメンバーはリーダーがアプローチを承認するまで、読み取り専用プランモードで動作します。152複雑またはリスクの高いタスクの場合、チームメンバーが実装前にプランを立てることを要求できます。チームメンバーはリーダーがアプローチを承認するまで、読み取り専用プランモードで動作します。

137 153 


144 160 

145リーダーは自律的に承認決定を下します。リーダーの判断に影響を与えるには、プロンプトで「テストカバレッジを含むプランのみを承認する」や「データベーススキーマを変更するプランを却下する」などの基準を指定してください。161リーダーは自律的に承認決定を下します。リーダーの判断に影響を与えるには、プロンプトで「テストカバレッジを含むプランのみを承認する」や「データベーススキーマを変更するプランを却下する」などの基準を指定してください。

146 162 

147### チームメンバーと直接通信する163<h3 id="talk-to-teammates-directly">

164 チームメンバーと直接通信する

165</h3>

148 166 

149各チームメンバーは、完全で独立した Claude Code セッションです。任意のチームメンバーに直接メッセージを送信して、追加の指示を与えたり、フォローアップの質問をしたり、アプローチをリダイレクトしたりできます。167各チームメンバーは、完全で独立した Claude Code セッションです。任意のチームメンバーに直接メッセージを送信して、追加の指示を与えたり、フォローアップの質問をしたり、アプローチをリダイレクトしたりできます。

150 168 

151* **In-process モード**:Shift+Down を使用してチームメンバーをサイクルして、メッセージを入力してください。Enter キーを押してチームメンバーのセッションを表示し、Escape キーを押して現在のターンを中断してください。Ctrl+T を押してタスクリストを切り替えてください。169* **In-process モード**:Shift+Down を使用してチームメンバーをサイクルして、メッセージを入力してください。Enter キーを押してチームメンバーのセッションを表示し、Escape キーを押して現在のターンを中断してください。Ctrl+T を押してタスクリストを切り替えてください。

152* **分割ペインモード**:チームメンバーのペインをクリックして、セッションと直接対話してください。各チームメンバーは独自のターミナルの完全なビューを持っています。170* **分割ペインモード**:チームメンバーのペインをクリックして、セッションと直接対話してください。各チームメンバーは独自のターミナルの完全なビューを持っています。

153 171 

154### タスクを割り当てて要求する172<h3 id="assign-and-claim-tasks">

173 タスクを割り当てて要求する

174</h3>

155 175 

156共有タスクリストはチーム全体の作業を調整します。リーダーがタスクを作成し、チームメンバーがそれらを処理します。タスクには 3 つの状態があります。保留中、進行中、完了。タスクは他のタスクに依存することもできます。未解決の依存関係を持つ保留中のタスクは、それらの依存関係が完了するまで要求できません。176共有タスクリストはチーム全体の作業を調整します。リーダーがタスクを作成し、チームメンバーがそれらを処理します。タスクには 3 つの状態があります。保留中、進行中、完了。タスクは他のタスクに依存することもできます。未解決の依存関係を持つ保留中のタスクは、それらの依存関係が完了するまで要求できません。

157 177 


162 182 

163タスク要求はファイルロックを使用して、複数のチームメンバーが同時に同じタスクを要求しようとするときの競合状態を防ぎます。183タスク要求はファイルロックを使用して、複数のチームメンバーが同時に同じタスクを要求しようとするときの競合状態を防ぎます。

164 184 

165### チームメンバーをシャットダウンする185<h3 id="shut-down-teammates">

186 チームメンバーをシャットダウンする

187</h3>

166 188 

167チームメンバーのセッションを適切に終了するには、以下を実行してください189チームメンバーのセッションを適切に終了するには、名前で参照してください例えば、researcher という名前のチームメンバーの場合:

168 190 

169```text theme={null}191```text theme={null}

170Ask the researcher teammate to shut down192Ask the researcher teammate to shut down


172 194 

173リーダーはシャットダウンリクエストを送信します。チームメンバーは承認して適切に終了するか、説明付きで却下できます。195リーダーはシャットダウンリクエストを送信します。チームメンバーは承認して適切に終了するか、説明付きで却下できます。

174 196 

175### チームをクリーンアップする197チームの共有ディレクトリは、セッションが終了すると自動的にクリーンアップされるため、別のクリーンアップステップはありません。削除されるディレクトリと、再開されたセッションのために保持されるディレクトリについては、[Architecture](#architecture) を参照してください。

176 198 

177完了したら、リーダーにクリーンアップするよう指示してください。199<h3 id="enforce-quality-gates-with-hooks">

178 200 hooks で品質ゲートを実施する

179```text theme={null}201</h3>

180Clean up the team

181```

182 

183これにより、共有チームリソースが削除されます。リーダーがクリーンアップを実行すると、アクティブなチームメンバーをチェックし、まだ実行中の場合は失敗するため、最初にシャットダウンしてください。

184 

185<Warning>

186 常にリーダーを使用してクリーンアップしてください。チームメンバーはクリーンアップを実行しないでください。チームメンバーのチームコンテキストが正しく解決されない可能性があり、リソースが不整合な状態のままになる可能性があります。

187</Warning>

188 

189### hooks で品質ゲートを実施する

190 202 

191[hooks](/ja/hooks) を使用して、チームメンバーが作業を完了したときまたはタスクが作成または完了したときのルールを実施してください。203[hooks](/ja/hooks) を使用して、チームメンバーが作業を完了したときまたはタスクが作成または完了したときのルールを実施してください。

192 204 


194* [`TaskCreated`](/ja/hooks#taskcreated):タスクが作成されているときに実行されます。終了コード 2 で作成を防止し、フィードバックを送信してください。206* [`TaskCreated`](/ja/hooks#taskcreated):タスクが作成されているときに実行されます。終了コード 2 で作成を防止し、フィードバックを送信してください。

195* [`TaskCompleted`](/ja/hooks#taskcompleted):タスクが完了としてマークされているときに実行されます。終了コード 2 で完了を防止し、フィードバックを送信してください。207* [`TaskCompleted`](/ja/hooks#taskcompleted):タスクが完了としてマークされているときに実行されます。終了コード 2 で完了を防止し、フィードバックを送信してください。

196 208 

197## エージェントチームの動作方法209<h2 id="how-agent-teams-work">

210 エージェントチームの動作方法

211</h2>

198 212 

199このセクションでは、エージェントチームの背後にあるアーキテクチャとメカニクスについて説明します。使用を開始したい場合は、上記の [エージェントチームを制御する](#control-your-agent-team) を参照してください。213このセクションでは、エージェントチームの背後にあるアーキテクチャとメカニクスについて説明します。使用を開始したい場合は、上記の [エージェントチームを制御する](#control-your-agent-team) を参照してください。

200 214 

201### Claude がエージェントチームを開始する方法215<h3 id="how-claude-starts-agent-teams">

216 Claude がエージェントチームを開始する方法

217</h3>

202 218 

203エージェントチームが開始される方法は 2 つあります。219エージェントチームは最初のチームメンバーが生成されるときに形成され、メインセッションがリーダーとして機能します。チームメンバーが生成される方法は 2 つあります。

204 220 

205* **チームをリクエストする**:並列作業から利益を得るタスクを Claude に提供し、明示的にエージェントチームをリクエストしてください。Claude は指示に基づいてチームを作成します221* **チームメンバーをリクエストする**:並列作業から利益を得るタスクを Claude に提供し、明示的にチームメンバーをリクエストしてください。Claude は指示に基づいてチームメンバーを生成します

206* **Claude がチームを提案する**:Claude がタスクが並列作業から利益を得ると判断した場合、チームの作成を提案する可能性があります。進行する前に確認してください。222* **Claude がチームメンバーを提案する**:Claude がタスクが並列作業から利益を得ると判断した場合、チームメンバーの生成を提案する可能性があります。進行する前に確認してください。

207 223 

208どちらの場合でも、制御は維持されます。Claude はあなたの承認なしにチームを作成しません224どちらの場合でも、制御は維持されます。Claude はあなたの承認なしにチームメンバーを生成しません

209 225 

210### アーキテクチャ226<h3 id="architecture">

227 アーキテクチャ

228</h3>

211 229 

212エージェントチームは以下で構成されています。230エージェントチームは以下で構成されています。

213 231 

214| コンポーネント | 役割 |232| コンポーネント | 役割 |

215| :---------- | :----------------------------------------------- |233| :---------- | :--------------------------------------- |

216| **チームリーダー** | チームを作成し、チームメンバーを生成し、作業を調整するメイン Claude Code セッション |234| **チームリーダー** | チームメンバーを生成し、作業を調整するメイン Claude Code セッション |

217| **チームメンバー** | 割り当てられたタスクで動作する個別の Claude Code インスタンス |235| **チームメンバー** | 割り当てられたタスクで動作する個別の Claude Code インスタンス |

218| **タスクリスト** | チームメンバーが要求して完了する共有作業項目リスト |236| **タスクリスト** | チームメンバーが要求して完了する共有作業項目リスト |

219| **メールボックス** | エージェント間の通信用メッセージングシステム |237| **メールボックス** | エージェント間の通信用メッセージングシステム |

220 238 

221表示設定オプションについては、[表示モードを選択](#choose-a-display-mode)を参照してください。チームメンバーのメッセージはリーダーに自動的に到着します。239表示設定オプションについては、[表示モードを選択](#choose-a-display-mode) を参照してください。チームメンバーのメッセージはリーダーに自動的に到着します。

222 240 

223システムはタスク依存関係を自動的に管理します。チームメンバーが他のタスクが依存するタスクを完了すると、ブロックされたタスクは手動介入なしにブロック解除されます。241システムはタスク依存関係を自動的に管理します。チームメンバーが他のタスクが依存するタスクを完了すると、ブロックされたタスクは手動介入なしにブロック解除されます。

224 242 

225チームとタスクはローカルに保存されます243チームとタスクはセッション派生名でローカルに保存されます名前は `session-` の後にセッション ID の最初の 8 文字が続きます。

226 244 

227* **チーム設定**:`~/.claude/teams/{team-name}/config.json`245* **チーム設定**:`~/.claude/teams/{team-name}/config.json`

228* **タスクリスト**:`~/.claude/tasks/{team-name}/`246* **タスクリスト**:`~/.claude/tasks/{team-name}/`

229 247 

230Claude Code はチームを作成するときにこれらの両方を自動的に生成し、チームメンバーが参加、アイドル状態になる、または離脱するときに更新します。チーム設定には、セッション ID と tmux ペイン ID などのランタイム状態が含まれているため手動で編集したり事前に作成したりしないでください次の状態更新時に変更が上書きされます248Claude Code はセッション起動時にこれらの両方を自動的に生成し、チームメンバーが参加、アイドル状態になる、または離脱するときに更新します。チーム設定ディレクトリはセッション終了時に削除されます。タスクリストディレクトリはローカルに保持されアップロードされることはないため再開されたセッションはタスクを保持します保持期間は、セッショントランスクリプト用に既に制御している同じ [`cleanupPeriodDays`](/ja/settings#available-settings) によって管理されます

249 

250チーム設定はセッション ID と tmux ペイン ID などのランタイム状態を保持しているため、手動で編集したり、事前に作成したりしないでください。次の状態更新時に変更が上書きされます。

231 251 

232再利用可能なチームメンバーロールを定義するには、代わりに [subagent 定義を使用](#use-subagent-definitions-for-teammates) してください。252再利用可能なチームメンバーロールを定義するには、代わりに [subagent 定義を使用](#use-subagent-definitions-for-teammates) してください。

233 253 


235 255 

236プロジェクトレベルのチーム設定に相当するものはありません。プロジェクトディレクトリ内の `.claude/teams/teams.json` のようなファイルは設定として認識されません。Claude はそれを通常のファイルとして扱います。256プロジェクトレベルのチーム設定に相当するものはありません。プロジェクトディレクトリ内の `.claude/teams/teams.json` のようなファイルは設定として認識されません。Claude はそれを通常のファイルとして扱います。

237 257 

238### チームメンバーに subagent 定義を使用する258<h3 id="use-subagent-definitions-for-teammates">

259 チームメンバーに subagent 定義を使用する

260</h3>

239 261 

240チームメンバーを生成するときに、任意の [subagent スコープ](/ja/sub-agents#choose-the-subagent-scope)(プロジェクト、ユーザー、プラグイン、または CLI 定義)から [subagent](/ja/sub-agents) タイプを参照できます。これにより、セキュリティレビュアーやテストランナーなどのロールを 1 回定義し、委任された subagent とエージェントチームチームメンバーの両方として再利用できます。262チームメンバーを生成するときに、任意の [subagent スコープ](/ja/sub-agents#choose-the-subagent-scope)(プロジェクト、ユーザー、プラグイン、または CLI 定義)から [subagent](/ja/sub-agents) タイプを参照できます。これにより、セキュリティレビュアーやテストランナーなどのロールを 1 回定義し、委任された subagent とエージェントチームチームメンバーの両方として再利用できます。

241 263 


251 subagent 定義の `skills` と `mcpServers` frontmatter フィールドは、その定義がチームメンバーとして実行される場合は適用されません。チームメンバーは、通常のセッションと同じように、プロジェクトおよびユーザー設定から skills と MCP servers をロードします。273 subagent 定義の `skills` と `mcpServers` frontmatter フィールドは、その定義がチームメンバーとして実行される場合は適用されません。チームメンバーは、通常のセッションと同じように、プロジェクトおよびユーザー設定から skills と MCP servers をロードします。

252</Note>274</Note>

253 275 

254### 権限276<h3 id="permissions">

277 権限

278</h3>

255 279 

256チームメンバーはリーダーの権限設定で開始します。リーダーが `--dangerously-skip-permissions` で実行する場合、すべてのチームメンバーも同様に実行します。生成後、個別のチームメンバーモードを変更できますが、生成時にチームメンバーごとのモードを設定することはできません。280チームメンバーはリーダーの権限設定で開始します。リーダーが `--dangerously-skip-permissions` で実行する場合、すべてのチームメンバーも同様に実行します。生成後、個別のチームメンバーモードを変更できますが、生成時にチームメンバーごとのモードを設定することはできません。

257 281 

258### コンテキストと通信282<h3 id="context-and-communication">

283 コンテキストと通信

284</h3>

259 285 

260各チームメンバーは独自のコンテキストウィンドウを持っています。生成されると、チームメンバーは通常のセッションと同じプロジェクトコンテキストをロードします。CLAUDE.md、MCP servers、および skills。また、リーダーからの生成プロンプトを受け取ります。リーダーの会話履歴は引き継がれません。286各チームメンバーは独自のコンテキストウィンドウを持っています。生成されると、チームメンバーは通常のセッションと同じプロジェクトコンテキストをロードします。CLAUDE.md、MCP servers、および skills。また、リーダーからの生成プロンプトを受け取ります。リーダーの会話履歴は引き継がれません。

261 287 


268 294 

269リーダーは生成時に各チームメンバーに名前を割り当て、任意のチームメンバーはその名前で他のチームメンバーにメッセージを送信できます。後のプロンプトで参照できる予測可能な名前を取得するには、生成指示でリーダーに各チームメンバーを何と呼ぶかを指示してください。295リーダーは生成時に各チームメンバーに名前を割り当て、任意のチームメンバーはその名前で他のチームメンバーにメッセージを送信できます。後のプロンプトで参照できる予測可能な名前を取得するには、生成指示でリーダーに各チームメンバーを何と呼ぶかを指示してください。

270 296 

271### トークン使用量297<h3 id="token-usage">

298 トークン使用量

299</h3>

272 300 

273エージェントチームは単一セッションよりも大幅に多くのトークンを使用します。各チームメンバーは独自のコンテキストウィンドウを持ち、トークン使用量はアクティブなチームメンバーの数でスケールします。調査、レビュー、および新機能作業の場合、追加のトークンは通常価値があります。ルーチンタスクの場合、単一セッションがより費用効果的です。使用ガイダンスについては、[エージェントチームトークンコスト](/ja/costs#agent-team-token-costs)を参照してください。301エージェントチームは単一セッションよりも大幅に多くのトークンを使用します。各チームメンバーは独自のコンテキストウィンドウを持ち、トークン使用量はアクティブなチームメンバーの数でスケールします。調査、レビュー、および新機能作業の場合、追加のトークンは通常価値があります。ルーチンタスクの場合、単一セッションがより費用効果的です。使用ガイダンスについては、[エージェントチームトークンコスト](/ja/costs#agent-team-token-costs) を参照してください。

274 302 

275## ユースケース例303<h2 id="use-case-examples">

304 ユースケース例

305</h2>

276 306 

277これらの例は、エージェントチームが並列探索が価値を追加するタスクをどのように処理するかを示しています。307これらの例は、エージェントチームが並列探索が価値を追加するタスクをどのように処理するかを示しています。

278 308 

279### 並列コードレビューを実行する309<h3 id="run-a-parallel-code-review">

310 並列コードレビューを実行する

311</h3>

280 312 

281単一のレビュアーは一度に 1 つのタイプの問題に傾く傾向があります。レビュー基準を独立したドメインに分割することで、セキュリティ、パフォーマンス、およびテストカバレッジがすべて同時に徹底的に注意を受けます。プロンプトは各チームメンバーに異なるレンズを割り当てるため、重複しません。313単一のレビュアーは一度に 1 つのタイプの問題に傾く傾向があります。レビュー基準を独立したドメインに分割することで、セキュリティ、パフォーマンス、およびテストカバレッジがすべて同時に徹底的に注意を受けます。プロンプトは各チームメンバーに異なるレンズを割り当てるため、重複しません。

282 314 

283```text theme={null}315```text theme={null}

284Create an agent team to review PR #142. Spawn three reviewers:316Spawn three teammates to review PR #142:

285- One focused on security implications317- One focused on security implications

286- One checking performance impact318- One checking performance impact

287- One validating test coverage319- One validating test coverage


290 322 

291各レビュアーは同じ PR から動作しますが、異なるフィルターを適用します。リーダーは完了後、3 つすべてにわたって調査結果を統合します。323各レビュアーは同じ PR から動作しますが、異なるフィルターを適用します。リーダーは完了後、3 つすべてにわたって調査結果を統合します。

292 324 

293### 競合する仮説で調査する325<h3 id="investigate-with-competing-hypotheses">

326 競合する仮説で調査する

327</h3>

294 328 

295根本原因が不明な場合、単一のエージェントは 1 つのもっともらしい説明を見つけて停止する傾向があります。プロンプトはチームメンバーを明示的に敵対的にすることでこれと戦います。各チームメンバーの仕事は、独自の理論を調査するだけでなく、他の理論に異議を唱えることです。329根本原因が不明な場合、単一のエージェントは 1 つのもっともらしい説明を見つけて停止する傾向があります。プロンプトはチームメンバーを明示的に敵対的にすることでこれと戦います。各チームメンバーの仕事は、独自の理論を調査するだけでなく、他の理論に異議を唱えることです。

296 330 


305 339 

306複数の独立した調査官が互いに積極的に反証しようとしている場合、生き残る理論は実際の根本原因である可能性がはるかに高くなります。340複数の独立した調査官が互いに積極的に反証しようとしている場合、生き残る理論は実際の根本原因である可能性がはるかに高くなります。

307 341 

308## ベストプラクティス342<h2 id="best-practices">

343 ベストプラクティス

344</h2>

309 345 

310### チームメンバーに十分なコンテキストを提供する346<h3 id="give-teammates-enough-context">

347 チームメンバーに十分なコンテキストを提供する

348</h3>

311 349 

312チームメンバーはプロジェクトコンテキスト(CLAUDE.md、MCP servers、および skills を含む)を自動的にロードしますが、リーダーの会話履歴は継承しません。詳細については、[コンテキストと通信](#context-and-communication)を参照してください。生成プロンプトにタスク固有の詳細を含めてください。350チームメンバーはプロジェクトコンテキスト(CLAUDE.md、MCP servers、および skills を含む)を自動的にロードしますが、リーダーの会話履歴は継承しません。詳細については、[コンテキストと通信](#context-and-communication)を参照してください。生成プロンプトにタスク固有の詳細を含めてください。

313 351 


318httpOnly cookies. Report any issues with severity ratings."356httpOnly cookies. Report any issues with severity ratings."

319```357```

320 358 

321### 適切なチームサイズを選択する359<h3 id="choose-an-appropriate-team-size">

360 適切なチームサイズを選択する

361</h3>

322 362 

323チームメンバーの数に厳しい制限はありませんが、実際の制約が適用されます。363チームメンバーの数に厳しい制限はありませんが、実際の制約が適用されます。

324 364 


332 372 

333作業が本当にチームメンバーが同時に動作することから利益を得る場合にのみスケールアップしてください。3 人の焦点を絞ったチームメンバーは、5 人の散らばったチームメンバーよりもしばしば優れています。373作業が本当にチームメンバーが同時に動作することから利益を得る場合にのみスケールアップしてください。3 人の焦点を絞ったチームメンバーは、5 人の散らばったチームメンバーよりもしばしば優れています。

334 374 

335### タスクを適切にサイズ設定する375<h3 id="size-tasks-appropriately">

376 タスクを適切にサイズ設定する

377</h3>

336 378 

337* **小さすぎる**:調整オーバーヘッドが利益を超える379* **小さすぎる**:調整オーバーヘッドが利益を超える

338* **大きすぎる**:チームメンバーはチェックインなしで長時間動作し、無駄な努力のリスクが増加します380* **大きすぎる**:チームメンバーはチェックインなしで長時間動作し、無駄な努力のリスクが増加します


342 リーダーは作業をタスクに分割し、チームメンバーに自動的に割り当てます。十分なタスクを作成していない場合は、作業をより小さな部分に分割するよう指示してください。チームメンバーあたり 5~6 個のタスクを持つことで、誰もが生産的に保たれ、誰かが立ち往生した場合、リーダーが作業を再割り当てできます。384 リーダーは作業をタスクに分割し、チームメンバーに自動的に割り当てます。十分なタスクを作成していない場合は、作業をより小さな部分に分割するよう指示してください。チームメンバーあたり 5~6 個のタスクを持つことで、誰もが生産的に保たれ、誰かが立ち往生した場合、リーダーが作業を再割り当てできます。

343</Tip>385</Tip>

344 386 

345### チームメンバーが完了するまで待つ387<h3 id="wait-for-teammates-to-finish">

388 チームメンバーが完了するまで待つ

389</h3>

346 390 

347時々、リーダーはチームメンバーを待つ代わりに、タスク自体を実装し始めます。これに気付いた場合は、以下を実行してください。391時々、リーダーはチームメンバーを待つ代わりに、タスク自体を実装し始めます。これに気付いた場合は、以下を実行してください。

348 392 


350Wait for your teammates to complete their tasks before proceeding394Wait for your teammates to complete their tasks before proceeding

351```395```

352 396 

353### 調査とレビューから開始する397<h3 id="start-with-research-and-review">

398 調査とレビューから開始する

399</h3>

354 400 

355エージェントチームが初めての場合は、明確な境界があり、コードを書く必要がないタスクから開始してください。PR をレビューする、ライブラリを調査する、またはバグを調査します。これらのタスクは、並列実装に伴う調整の課題なしに、並列探索の価値を示しています。401エージェントチームが初めての場合は、明確な境界があり、コードを書く必要がないタスクから開始してください。PR をレビューする、ライブラリを調査する、またはバグを調査します。これらのタスクは、並列実装に伴う調整の課題なしに、並列探索の価値を示しています。

356 402 

357### ファイルの競合を回避する403<h3 id="avoid-file-conflicts">

404 ファイルの競合を回避する

405</h3>

358 406 

3592 人のチームメンバーが同じファイルを編集すると、上書きが発生します。作業を分割して、各チームメンバーが異なるファイルセットを所有するようにしてください。4072 人のチームメンバーが同じファイルを編集すると、上書きが発生します。作業を分割して、各チームメンバーが異なるファイルセットを所有するようにしてください。

360 408 

361### 監視と操舵409<h3 id="monitor-and-steer">

410 監視と操舵

411</h3>

362 412 

363チームメンバーの進捗をチェックし、機能していないアプローチをリダイレクトし、調査結果が入ってくるにつれて統合してください。チームを長時間無人で実行させると、無駄な努力のリスクが増加します。413チームメンバーの進捗をチェックし、機能していないアプローチをリダイレクトし、調査結果が入ってくるにつれて統合してください。チームを長時間無人で実行させると、無駄な努力のリスクが増加します。

364 414 

365## トラブルシューティング415<h2 id="troubleshooting">

416 トラブルシューティング

417</h2>

366 418 

367### チームメンバーが表示されない419<h3 id="teammates-not-appearing">

420 チームメンバーが表示されない

421</h3>

368 422 

369Claude にチームを作成するよう指示した後、チームメンバーが表示されない場合は、以下を実行してください。423Claude にチームメンバーを生成するよう指示した後、チームメンバーが表示されない場合は、以下を実行してください。

370 424 

371* In-process モードでは、チームメンバーは既に実行中ですが、表示されない可能性があります。Shift+Down を押してアクティブなチームメンバーをサイクルしてください。425* In-process モードでは、チームメンバーは既に実行中ですが、表示されない可能性があります。Shift+Down を押してアクティブなチームメンバーをサイクルしてください。

372* Claude に提供したタスクがチームを保証するのに十分複雑であることを確認してください。Claude はタスクに基づいてチームメンバーを生成するかどうかを決定します。426* Claude に提供したタスクがチームメンバーを生成する必要があるほど十分複雑であることを確認してください。Claude はタスクに基づいてチームメンバーを生成するかどうかを決定します。

373* 明示的に分割ペインをリクエストした場合は、tmux がインストールされ、PATH で利用可能であることを確認してください。427* 明示的に分割ペインをリクエストした場合は、tmux がインストールされ、PATH で利用可能であることを確認してください。

374 ```bash theme={null}428 ```bash theme={null}

375 which tmux429 which tmux

376 ```430 ```

377* iTerm2 の場合、`it2` CLI がインストールされ、Python API が iTerm2 の設定で有効になっていることを確認してください。431* iTerm2 の場合、`it2` CLI がインストールされ、Python API が iTerm2 の設定で有効になっていることを確認してください。

378 432 

379### 権限プロンプトが多すぎる433<h3 id="too-many-permission-prompts">

434 権限プロンプトが多すぎる

435</h3>

380 436 

381チームメンバーの権限リクエストはリーダーにバブルアップし、摩擦を生じさせる可能性があります。チームメンバーを生成する前に、[権限設定](/ja/permissions)で一般的な操作を事前承認して、中断を減らしてください。437チームメンバーの権限リクエストはリーダーにバブルアップし、摩擦を生じさせる可能性があります。チームメンバーを生成する前に、[権限設定](/ja/permissions)で一般的な操作を事前承認して、中断を減らしてください。

382 438 

383### チームメンバーがエラーで停止する439<h3 id="teammates-stopping-on-errors">

440 チームメンバーがエラーで停止する

441</h3>

384 442 

385チームメンバーはエラーが発生した後、回復する代わりに停止する可能性があります。In-process モードで Shift+Down を使用するか、分割モードでペインをクリックして出力を確認し、以下のいずれかを実行してください。443チームメンバーはエラーが発生した後、回復する代わりに停止する可能性があります。In-process モードで Shift+Down を使用するか、分割モードでペインをクリックして出力を確認し、以下のいずれかを実行してください。

386 444 

387* 直接追加の指示を与える445* 直接追加の指示を与える

388* 作業を続行するために置き換えチームメンバーを生成する446* 作業を続行するために置き換えチームメンバーを生成する

389 447 

390### リーダーが作業完了前にシャットダウンする448<h3 id="lead-shuts-down-before-work-is-done">

449 リーダーが作業完了前にシャットダウンする

450</h3>

391 451 

392リーダーは、すべてのタスクが実際に完了する前に、チームが完了したと判断する可能性があります。これが発生した場合は、続行するよう指示してください。また、リーダーが委任する代わりに作業を開始する場合は、チームメンバーが完了するまで待つようリーダーに指示することもできます。452リーダーは、すべてのタスクが実際に完了する前に、チームが完了したと判断する可能性があります。これが発生した場合は、続行するよう指示してください。また、リーダーが委任する代わりに作業を開始する場合は、チームメンバーが完了するまで待つようリーダーに指示することもできます。

393 453 

394### 孤立した tmux セッション454<h3 id="orphaned-tmux-sessions">

455 孤立した tmux セッション

456</h3>

395 457 

396チームが終了した後、tmux セッションが持続する場合、完全にクリーンアップされていない可能性があります。セッションをリストして、チームによって作成されたセッションを終了してください。458チームが終了した後、tmux セッションが持続する場合、完全にクリーンアップされていない可能性があります。セッションをリストして、チームによって作成されたセッションを終了してください。

397 459 


400tmux kill-session -t <session-name>462tmux kill-session -t <session-name>

401```463```

402 464 

403## 制限事項465<h2 id="limitations">

466 制限事項

467</h2>

404 468 

405エージェントチームは実験的です。注意すべき現在の制限事項は以下の通りです。469エージェントチームは実験的です。注意すべき現在の制限事項は以下の通りです。

406 470 

407* **In-process チームメンバーでのセッション再開なし**:`/resume` と `/rewind` は in-process チームメンバーを復元しません。セッションを再開した後、リーダーは存在しなくなったチームメンバーにメッセージを送信しようとする可能性があります。これが発生した場合は、リーダーに新しいチームメンバーを生成するよう指示してください。471* **In-process チームメンバーでのセッション再開なし**:`/resume` と `/rewind` は in-process チームメンバーを復元しません。セッションを再開した後、リーダーは存在しなくなったチームメンバーにメッセージを送信しようとする可能性があります。これが発生した場合は、リーダーに新しいチームメンバーを生成するよう指示してください。

408* **タスクステータスが遅延する可能性**:チームメンバーはタスクを完了としてマークできず、依存タスクをブロックすることがあります。タスクが立ち往生しているように見える場合は、作業が実際に完了しているかどうかを確認し、タスクステータスを手動で更新するか、リーダーにチームメンバーをナッジするよう指示してください。472* **タスクステータスが遅延する可能性**:チームメンバーはタスクを完了としてマークできず、依存タスクをブロックすることがあります。タスクが立ち往生しているように見える場合は、作業が実際に完了しているかどうかを確認し、タスクステータスを手動で更新するか、リーダーにチームメンバーをナッジするよう指示してください。

409* **シャットダウンが遅い可能性**:チームメンバーは現在のリクエストまたはツール呼び出しを完了してからシャットダウンし、時間がかかる可能性があります。473* **シャットダウンが遅い可能性**:チームメンバーは現在のリクエストまたはツール呼び出しを完了してからシャットダウンし、時間がかかる可能性があります。

410* **セッションあたり 1 つのチーム**:リーダーは一度に 1 つのチームのみを管理できます新しいチームを開始する前に現在のチームをクリーンアップしてください474* **セッションあたり 1 つのチーム**:セッションは正確に 1 つのチームを持ち、そのセッションにスコープされています追加の名前付きチームを作成したりセッション間でチームを共有したりすることはできません

411* **ネストされたチームなし**:チームメンバーは独自のチームまたはチームメンバーを生成できません。リーダーのみがチームを管理できます。475* **ネストされたチームなし**:チームメンバーは独自のチームメンバーを生成できません。リーダーのみがチームを管理できます。

412* **リーダーは固定**:チームを作成するセッションは、その生涯のリーダーです。チームメンバーをリーダーに昇格させたり、リーダーシップを譲渡したりすることはできません。476* **リーダーは固定**:メインセッションはその生涯のリーダーです。チームメンバーをリーダーに昇格させたり、リーダーシップを譲渡したりすることはできません。

413* **権限は生成時に設定**:すべてのチームメンバーはリーダーの権限モードで開始します。生成後に個別のチームメンバーモードを変更できますが、生成時にチームメンバーごとのモードを設定することはできません。477* **権限は生成時に設定**:すべてのチームメンバーはリーダーの権限モードで開始します。生成後に個別のチームメンバーモードを変更できますが、生成時にチームメンバーごとのモードを設定することはできません。

414* **分割ペインには tmux または iTerm2 が必要**:デフォルトの in-process モードは任意のターミナルで動作します。分割ペインモードは VS Code の統合ターミナル、Windows Terminal、または Ghostty ではサポートされていません。478* **分割ペインには tmux または iTerm2 が必要**:デフォルトの in-process モードは任意のターミナルで動作します。分割ペインモードは VS Code の統合ターミナル、Windows Terminal、または Ghostty ではサポートされていません。

415 479 


417 **`CLAUDE.md` は正常に動作**:チームメンバーは作業ディレクトリから `CLAUDE.md` ファイルを読み取ります。これを使用して、プロジェクト固有のガイダンスをすべてのチームメンバーに提供してください。481 **`CLAUDE.md` は正常に動作**:チームメンバーは作業ディレクトリから `CLAUDE.md` ファイルを読み取ります。これを使用して、プロジェクト固有のガイダンスをすべてのチームメンバーに提供してください。

418</Tip>482</Tip>

419 483 

420## 次のステップ484<h2 id="next-steps">

485 次のステップ

486</h2>

421 487 

422並列作業と委任の関連アプローチを探索してください。488並列作業と委任の関連アプローチを探索してください。

423 489 

agent-view.md +16 −7

Details

143 143 

144各行の 1 行の概要は [Haiku クラスモデル](/ja/model-config) によって生成されるため、行はトランスクリプトを開かずにセッションが何をしているか、何が必要か、または何を生成したかを伝えることができます。セッションがアクティブに作業している間、概要は最大 15 秒ごとに 1 回、および各ターンが終了したときに 1 回更新されます。144各行の 1 行の概要は [Haiku クラスモデル](/ja/model-config) によって生成されるため、行はトランスクリプトを開かずにセッションが何をしているか、何が必要か、または何を生成したかを伝えることができます。セッションがアクティブに作業している間、概要は最大 15 秒ごとに 1 回、および各ターンが終了したときに 1 回更新されます。

145 145 

146v2.1.161 以降では、セッションが subagents、バックグラウンドシェルコマンド、またはモニターなど、2 つ以上の並列作業項目を実行している場合、`2/5` などの `done/total` カウントが概要テキストの前に表示されます。

147 

146各更新は通常のプロバイダーを通じた 1 つの短い Haiku クラスリクエストであり、セッション自体と同じ [データ使用条件](/ja/data-usage) の下で請求および処理されます。Bedrock、Vertex AI、Microsoft Foundry、カスタムゲートウェイなどのサードパーティプロバイダーでは、Haiku モデルが設定されていない場合、リクエストはセッションのメインモデルにフォールバックします。これらのプロバイダーでこれらの概要のモデルを選択するには、[`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/ja/model-config#environment-variables) を設定します。148各更新は通常のプロバイダーを通じた 1 つの短い Haiku クラスリクエストであり、セッション自体と同じ [データ使用条件](/ja/data-usage) の下で請求および処理されます。Bedrock、Vertex AI、Microsoft Foundry、カスタムゲートウェイなどのサードパーティプロバイダーでは、Haiku モデルが設定されていない場合、リクエストはセッションのメインモデルにフォールバックします。これらのプロバイダーでこれらの概要のモデルを選択するには、[`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/ja/model-config#environment-variables) を設定します。

147 149 

148<h3 id="pull-request-status">150<h3 id="pull-request-status">


170 172 

171選択した行で `Space` を押してピークパネルを開きます。セッションが何を必要としているか、最新の出力、および開いたプルリクエストが表示されます。ほとんどの場合、これで十分であり、フルトランスクリプトを開く必要はありません。173選択した行で `Space` を押してピークパネルを開きます。セッションが何を必要としているか、最新の出力、および開いたプルリクエストが表示されます。ほとんどの場合、これで十分であり、フルトランスクリプトを開く必要はありません。

172 174 

175v2.1.161 以降では、セッションが並列作業項目を実行している場合、パネルは最も長く実行されているものとその実行時間を名前で表示するため、アタッチせずにセッションが何を待機しているかを確認できます。

176 

173ピークパネルに返信を入力して `Enter` を押すと、そのセッションに送信されます。セッションが複数選択肢の質問をしている場合、ピークパネルはオプションを表示し、数字キーを押して 1 つを選択できます。他のブロックされたセッションの場合は、`Tab` を押して入力に提案された返信を入力し、送信前に編集できます。返信の前に `!` を付けて Bash コマンドを代わりに送信します。177ピークパネルに返信を入力して `Enter` を押すと、そのセッションに送信されます。セッションが複数選択肢の質問をしている場合、ピークパネルはオプションを表示し、数字キーを押して 1 つを選択できます。他のブロックされたセッションの場合は、`Tab` を押して入力に提案された返信を入力し、送信前に編集できます。返信の前に `!` を付けて Bash コマンドを代わりに送信します。

174 178 

175[音声ディクテーション](/ja/voice-dictation) が有効な場合、返信入力がフォーカスされている間、プッシュトゥトークキーを押したままにするか、タップして返信をディクテーションします。これはエージェントビューの下部のディスパッチ入力でも同じように機能します。179v2.1.145 以降では、[音声ディクテーション](/ja/voice-dictation) が有効な場合、返信入力がフォーカスされている間、プッシュトゥトークキーを押したままにするか、タップして返信をディクテーションします。これはエージェントビューの下部のディスパッチ入力でも同じように機能します。

176 180 

177`↑` と `↓` を使用してパネルを閉じずに隣接するセッションをピーク表示するか、`→` を使用してアタッチします。181`↑` と `↓` を使用してパネルを閉じずに隣接するセッションをピーク表示するか、`→` を使用してアタッチします。

178 182 


224| `a:<name>` | 名前付きエージェントを実行しているセッション |228| `a:<name>` | 名前付きエージェントを実行しているセッション |

225| `s:<state>` | 指定された状態のセッション。例えば `s:working`。また `s:blocked` はあなたを待機しているすべてのセッションを受け入れます |229| `s:<state>` | 指定された状態のセッション。例えば `s:working`。また `s:blocked` はあなたを待機しているすべてのセッションを受け入れます |

226| `#<number>` または PR URL | そのプルリクエストで作業しているセッション |230| `#<number>` または PR URL | そのプルリクエストで作業しているセッション |

231| その他の URL | 最初のプロンプトにその URL が含まれていたセッション |

227 232 

228<h3 id="keyboard-shortcuts">233<h3 id="keyboard-shortcuts">

229 キーボードショートカット234 キーボードショートカット


478すべてのバックグラウンドセッションには、シェルから使用できる短い ID があります。ID は `claude --bg` でセッションを開始するときに出力され、各セッションの ID は `~/.claude/jobs/` の下のディレクトリ名です。これらのコマンドはスクリプティングまたはエージェントビューを開きたくない場合に便利です。483すべてのバックグラウンドセッションには、シェルから使用できる短い ID があります。ID は `claude --bg` でセッションを開始するときに出力され、各セッションの ID は `~/.claude/jobs/` の下のディレクトリ名です。これらのコマンドはスクリプティングまたはエージェントビューを開きたくない場合に便利です。

479 484 

480| コマンド | 目的 |485| コマンド | 目的 |

481| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |486| :--------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

482| `claude agents` | エージェントビューを開く |487| `claude agents` | エージェントビューを開く |

483| `claude agents --cwd <path>` | `<path>` の下で開始されたセッションにスコープされたエージェントビューを開く |488| `claude agents --cwd <path>` | `<path>` の下で開始されたセッションにスコープされたエージェントビューを開く |

484| `claude agents --json` | ライブセッションを JSON 配列として出力して終了します。各エントリには `pid`、`cwd`、`kind`、`startedAt` が含まれ設定されている場合は `sessionId`、`name`、`status` も含まれます。`--cwd <path>` と組み合わせてフィルタリングします |489| `claude agents --json` | アクティブなセッションを JSON 配列として出力して終了します。すべてのライブセッション、およびプロセスが終了した場合でも引き続き動作またはブロックされているバックグラウンドセッションが含まれます。`--all` を追加して完了したバックグラウンドセッションも含めます。各エントリには `cwd`、`kind`、`startedAt` が含まれます。バックグラウンドエントリには`claude attach`/`logs`/`stop` で使用可能な `id` と、`working`、`blocked`、`done`、`failed`、`stopped` のいずれかの `state` も含まれます。`pid` と `status` はプロセスが生きている間のみ存在し、status が `waiting` の場合は `waitingFor` が存在し、`permission prompt` や `input needed` など、セッションがブロックされている内容を示します。`sessionId` と `name` は設定されている場合に表示されます。`--cwd <path>` と組み合わせてフィルタリングします |

485| `claude attach <id>` | このターミナルでセッションにアタッチする |490| `claude attach <id>` | このターミナルでセッションにアタッチする |

486| `claude logs <id>` | セッションの最新出力を出力する |491| `claude logs <id>` | セッションの最新出力を出力する |

487| `claude stop <id>` | セッションを停止する。`claude kill` も受け入れます |492| `claude stop <id>` | セッションを停止する。`claude kill` も受け入れます |


530 535 

531各バックグラウンドセッションには `CLAUDE_JOB_DIR` 環境変数が `~/.claude/jobs/<id>` ディレクトリに設定されているため、セッションが実行するシェルコマンドは並列セッションと衝突することなく `$CLAUDE_JOB_DIR/tmp` に一時ファイルを書き込むことができます。536各バックグラウンドセッションには `CLAUDE_JOB_DIR` 環境変数が `~/.claude/jobs/<id>` ディレクトリに設定されているため、セッションが実行するシェルコマンドは並列セッションと衝突することなく `$CLAUDE_JOB_DIR/tmp` に一時ファイルを書き込むことができます。

532 537 

533この状態を直接ファイルを読むことなく検査するには、`claude daemon status` を実行します。スーパーバイザーに到達可能かどうか、そのプロセス ID とバージョン、ソケットディレクトリ、およびライブのバックグラウンドセッション数を報告します。`/doctor` には同じチェックの概要が含まれます。Windows では、`claude daemon status` はデーモンのパイプキーファイルがロックされているか読み取り不可の場合、一般的な接続失敗を報告する代わりに、基になるファイルエラーを表示します。538この状態を直接ファイルを読むことなく検査するには、`claude daemon status` を実行します。スーパーバイザーに到達可能かどうか、そのプロセス ID とバージョン、ソケットディレクトリ、およびライブのバックグラウンドセッション数を報告します。`/doctor` には同じチェックの概要が含まれます。

539 

540このコマンドは、実行中のスーパーバイザーが呼び出した `claude` とは異なるバージョンにある場合に警告を表示します。これはスーパーバイザーがまだ再開していない更新後に発生します。警告は両方のバージョンを表示し、`claude daemon stop --any` を実行して新しいバージョンを取得するよう指示します。Claude Code が OS サービスとしてインストールされている場合、推奨されるコマンドはフラグなしの `claude daemon stop` です。

541 

542Windows では、`claude daemon status` はデーモンのパイプキーファイルがロックされているか読み取り不可の場合、一般的な接続失敗を報告する代わりに、基になるファイルエラーを表示します。

534 543 

535<h3 id="turn-off-agent-view">544<h3 id="turn-off-agent-view">

536 エージェントビューをオフにする545 エージェントビューをオフにする


556 565 

557最初のセッションをディスパッチする前に、エージェントビューはセッションリストの代わりに、例のプロンプトを含む短いオンボーディングヒントを表示します。下部の入力にプロンプトを入力して `Enter` を押して、最初のセッションをディスパッチします。566最初のセッションをディスパッチする前に、エージェントビューはセッションリストの代わりに、例のプロンプトを含む短いオンボーディングヒントを表示します。下部の入力にプロンプトを入力して `Enter` を押して、最初のセッションをディスパッチします。

558 567 

559<h3 id="cannot-open-agents-because-background-tasks-are-running">568<h3 id="cannot-open-agents-because-work-is-running-in-the-background">

560 バックグラウンドタスクが実行中のためエージェントを開くことができない569 バックグラウンドで作業が実行中のためエージェントを開くことができない

561</h3>570</h3>

562 571 

563`←` を押して現在のセッションをバックグラウンドに移すと `Cannot open agents — N background task(s) running` が表示される場合、セッションにはサブエージェント、ダイナミックワークフロー、またはバックグラウンドシェルコマンドなどの進行中の作業があり、ショートカットはそれを静かに放棄しません。`/tasks` を実行して何が実行されているかを確認し、`/bg` を実行して放棄することを確認します。バックグラウンドに移すときに何が転送され、何が転送されないかについては、[セッション内から](#from-inside-a-session)を参照してください。572`←` を押して現在のセッションをバックグラウンドに移すと `Cannot open agents — N still running in the background` が表示される場合、セッションにはサブエージェント、ダイナミックワークフロー、またはバックグラウンドシェルコマンドなどの進行中の作業があり、ショートカットはそれを静かに放棄しません。`/tasks` を実行して何が実行されているかを確認し、`/bg` を実行して放棄することを確認します。バックグラウンドに移すときに何が転送され、何が転送されないかについては、[セッション内から](#from-inside-a-session)を参照してください。

564 573 

565<h3 id="prompt-rejected-as-too-short">574<h3 id="prompt-rejected-as-too-short">

566 プロンプトが短すぎるとして拒否される575 プロンプトが短すぎるとして拒否される

agents.md +3 −3

Details

9[サブエージェント](/ja/sub-agents)、[エージェントビュー](/ja/agent-view)、[エージェントチーム](/ja/agent-teams)、および [動的ワークフロー](/ja/workflows) は、それぞれ異なる方法で作業を並列化します。どれを選ぶかは、各会話に自分で留まりたいのか、タスクを引き継いで後で確認したいのか、それとも Claude に一群のワーカーを調整させたいのかによって異なります。9[サブエージェント](/ja/sub-agents)、[エージェントビュー](/ja/agent-view)、[エージェントチーム](/ja/agent-teams)、および [動的ワークフロー](/ja/workflows) は、それぞれ異なる方法で作業を並列化します。どれを選ぶかは、各会話に自分で留まりたいのか、タスクを引き継いで後で確認したいのか、それとも Claude に一群のワーカーを調整させたいのかによって異なります。

10 10 

11| アプローチ | 提供内容 | 使用する場合 |11| アプローチ | 提供内容 | 使用する場合 |

12| :--------------------------- | :---------------------------------------------------------------------- | :--------------------------------------------------------------------------- |12| :--------------------------- | :---------------------------------------------------------------------- | :-------------------------------------------------------------------------- |

13| [サブエージェント](/ja/sub-agents) | 1 つのセッション内で委任されたワーカーが、独自のコンテキストでサイドタスクを実行し、サマリーを返す | サイドタスクが検索結果、ログ、またはファイルコンテンツで主な会話を埋め尽くす場合(再度参照しない) |13| [サブエージェント](/ja/sub-agents) | 1 つのセッション内で委任されたワーカーが、独自のコンテキストでサイドタスクを実行し、サマリーを返す | サイドタスクが検索結果、ログ、またはファイルコンテンツで主な会話を埋め尽くす場合(再度参照しない) |

14| [エージェントビュー](/ja/agent-view) | `claude agents` で開く、バックグラウンドで実行されているセッションをディスパッチして監視する 1 つの画面。リサーチプレビュー | 複数の独立したタスクがあり、それらを引き継いで、一目で状態を確認し、必要な場合のみ介入したい場合 |14| [エージェントビュー](/ja/agent-view) | `claude agents` で開く、バックグラウンドで実行されているセッションをディスパッチして監視する 1 つの画面。リサーチプレビュー | 複数の独立したタスクがあり、それらを引き継いで、一目で状態を確認し、必要な場合のみ介入したい場合 |

15| [エージェントチーム](/ja/agent-teams) | 共有タスクリストとエージェント間メッセージングを備えた複数の調整されたセッション。リーダーによって管理される。実験的で、デフォルトでは無効 | Claude にプロジェクトを分割させ、割り当てさせ、ワーカーを同期させたい場合 |15| [エージェントチーム](/ja/agent-teams) | 共有タスクリストとエージェント間メッセージングを備えた複数の調整されたセッション。リーダーによって管理される。実験的で、デフォルトでは無効 | Claude にプロジェクトを分割させ、割り当てさせ、ワーカーを同期させたい場合 |

16| [動的ワークフロー](/ja/workflows) | 多くのサブエージェントを実行し、その結果をチェックするスクリプト。1 回のターンで調整するには大きすぎるジョブ向け。リサーチプレビュー | タスクが大きすぎてサブエージェント数個では対応できない場合。コードベース全体の監査、500 ファイルのマイグレーション、または敵対的検証が必要な調査など |16| [動的ワークフロー](/ja/workflows) | 多くのサブエージェントを実行し、その結果をチェックするスクリプト。1 回のターンで調整するには大きすぎるジョブ向け | タスクが大きすぎてサブエージェント数個では対応できない場合。コードベース全体の監査、500 ファイルのマイグレーション、または相互検証が必要な調査など |

17 17 

18すべてのアプローチにおいて、ワーカーは Claude セッションです。別のツールを関与させるには、それを Claude に [MCP サーバー](/ja/mcp) として公開します。18すべてのアプローチにおいて、ワーカーは Claude セッションです。別のツールを関与させるには、それを Claude に [MCP サーバー](/ja/mcp) として公開します。

19 19 


63 詳細情報63 詳細情報

64</h2>64</h2>

65 65 

66以下の各ガイドは、1 つのアプローチのセットアップと構成をカバーしています。66各ガイド以下は、1 つのアプローチのセットアップと構成をカバーしています。

67 67 

68* [カスタムサブエージェントを作成する](/ja/sub-agents):再利用可能なスペシャリストを定義し、使用できるツールを制御します。68* [カスタムサブエージェントを作成する](/ja/sub-agents):再利用可能なスペシャリストを定義し、使用できるツールを制御します。

69* [エージェントビューでエージェントを管理する](/ja/agent-view):セッションをディスパッチし、その状態を監視し、必要な場合にアタッチします。69* [エージェントビューでエージェントを管理する](/ja/agent-view):セッションをディスパッチし、その状態を監視し、必要な場合にアタッチします。

amazon-bedrock.md +176 −40

Details

6 6 

7> Amazon Bedrock を通じた Claude Code の設定方法(セットアップ、IAM 設定、トラブルシューティングを含む)について学習します。7> Amazon Bedrock を通じた Claude Code の設定方法(セットアップ、IAM 設定、トラブルシューティングを含む)について学習します。

8 8 

9## 前提条件9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;

11 const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">

12 <line x1="5" y1="12" x2="19" y2="12" />

13 <polyline points="12 5 19 12 12 19" />

14 </svg>;

15 const STYLES = `

16.cc-cs {

17 --cs-slate: #141413;

18 --cs-clay: #d97757;

19 --cs-clay-deep: #c6613f;

20 --cs-gray-000: #ffffff;

21 --cs-gray-700: #3d3d3a;

22 --cs-border-default: rgba(31, 30, 29, 0.15);

23 font-family: inherit;

24}

25.dark .cc-cs {

26 --cs-slate: #f0eee6;

27 --cs-gray-000: #262624;

28 --cs-gray-700: #bfbdb4;

29 --cs-border-default: rgba(240, 238, 230, 0.14);

30}

31.cc-cs-card {

32 display: flex; align-items: center; justify-content: space-between;

33 gap: 16px; padding: 14px 16px; margin: 0;

34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);

35 border-radius: 8px; flex-wrap: wrap;

36}

37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }

38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }

39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }

40.cc-cs-btn-clay {

41 display: inline-flex; align-items: center; gap: 8px;

42 background: var(--cs-clay-deep); color: #fff; border: none;

43 border-radius: 8px; padding: 8px 14px;

44 font-size: 13px; font-weight: 500;

45 transition: background-color 0.15s; white-space: nowrap;

46}

47.cc-cs-btn-clay:hover { background: var(--cs-clay); }

48.cc-cs-btn-ghost {

49 display: inline-flex; align-items: center; gap: 8px;

50 background: transparent; color: var(--cs-gray-700);

51 border: 0.5px solid var(--cs-border-default);

52 border-radius: 8px; padding: 8px 14px;

53 font-size: 13px; font-weight: 500;

54}

55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }

56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }

57@media (max-width: 720px) {

58 .cc-cs-actions { width: 100%; }

59}

60`;

61 return <div className="cc-cs not-prose">

62 <style>{STYLES}</style>

63 <div className="cc-cs-card">

64 <div className="cc-cs-text">

65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.

66 </div>

67 <div className="cc-cs-actions">

68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">

69 View plans

70 </a>

71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">

72 Contact sales {iconArrowRight()}

73 </a>

74 </div>

75 </div>

76 </div>;

77};

78 

79<ContactSalesCard surface="bedrock" />

80 

81<h2 id="prerequisites">

82 前提条件

83</h2>

10 84 

11Claude Code を Bedrock で設定する前に、以下を確認してください。85Claude Code を Bedrock で設定する前に、以下を確認してください。

12 86 


15* AWS CLI がインストールされ、設定されていること(オプション - 認証情報を取得する別のメカニズムがない場合のみ必要)89* AWS CLI がインストールされ、設定されていること(オプション - 認証情報を取得する別のメカニズムがない場合のみ必要)

16* 適切な IAM 権限90* 適切な IAM 権限

17 91 

18Bedrock 認証情報を使用してサインインするには、以下の [Bedrock でサインイン](#bedrock-でサインイン)に従ってください。チーム全体に Claude Code をデプロイするには、[手動でセットアップ](#手動でセットアップ)の手順を使用し、ロールアウト前に[モデルバージョンをピン留め](#4-モデルバージョンをピン留め)してください。92Bedrock 認証情報を使用してサインインするには、以下の [Bedrock でサインイン](#sign-in-with-bedrock)に従ってください。チーム全体に Claude Code をデプロイするには、[手動でセットアップ](#set-up-manually)の手順を使用し、ロールアウト前に[モデルバージョンをピン留め](#4-pin-model-versions)してください。

19 93 

20## Bedrock でサインイン94<h2 id="sign-in-with-bedrock">

95 Bedrock でサインイン

96</h2>

21 97 

22AWS 認証情報を持っていて、Bedrock を通じて Claude Code の使用を開始したい場合、ログインウィザードがそれをガイドします。AWS 側の前提条件はアカウントごとに 1 回完了します。ウィザードは Claude Code 側を処理します。98AWS 認証情報を持っていて、Bedrock を通じて Claude Code の使用を開始したい場合、ログインウィザードがそれをガイドします。AWS 側の前提条件はアカウントごとに 1 回完了します。ウィザードは Claude Code 側を処理します。

23 99 

24<Steps>100<Steps>

25 <Step title="AWS アカウントで Anthropic モデルを有効にする">101 <Step title="AWS アカウントで Anthropic モデルを有効にする">

26 [Amazon Bedrock コンソール](https://console.aws.amazon.com/bedrock/)で、モデルカタログを開き、Anthropic モデルを選択して、ユースケースフォームを送信します。送信直後にアクセスが付与されます。AWS Organizations については[ユースケースの詳細を送信](#1-ユースケースの詳細を送信)を、権限については [IAM 設定](#iam-設定)を参照してください。102 [Amazon Bedrock コンソール](https://console.aws.amazon.com/bedrock/)で、モデルカタログを開き、Anthropic モデルを選択して、ユースケースフォームを送信します。送信直後にアクセスが付与されます。AWS Organizations については[ユースケースの詳細を送信](#1-submit-use-case-details)を、権限については [IAM 設定](#iam-configuration)を参照してください。

27 </Step>103 </Step>

28 104 

29 <Step title="Claude Code を開始して Bedrock を選択する">105 <Step title="Claude Code を開始して Bedrock を選択する">


37 113 

38サインイン後、いつでも `/setup-bedrock` を実行してウィザードを再度開き、認証情報、リージョン、またはモデルピンを変更できます。114サインイン後、いつでも `/setup-bedrock` を実行してウィザードを再度開き、認証情報、リージョン、またはモデルピンを変更できます。

39 115 

40## 手動でセットアップ116<h2 id="set-up-manually">

117 手動でセットアップ

118</h2>

41 119 

42ウィザードの代わりに環境変数を通じて Bedrock を設定するには、例えば CI またはスクリプト化されたエンタープライズロールアウトで、以下の手順に従ってください。120ウィザードの代わりに環境変数を通じて Bedrock を設定するには、例えば CI またはスクリプト化されたエンタープライズロールアウトで、以下の手順に従ってください。

43 121 

44### 1. ユースケースの詳細を送信122<h3 id="1-submit-use-case-details">

123 1. ユースケースの詳細を送信

124</h3>

45 125 

46Anthropic モデルの初回ユーザーは、モデルを呼び出す前にユースケースの詳細を送信する必要があります。これは AWS アカウントごとに 1 回行われます。126Anthropic モデルの初回ユーザーは、モデルを呼び出す前にユースケースの詳細を送信する必要があります。これは AWS アカウントごとに 1 回行われます。

47 127 


52 132 

53AWS Organizations を使用する場合、[`PutUseCaseForModelAccess` API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutUseCaseForModelAccess.html) を使用して管理アカウントからフォームを 1 回送信できます。この呼び出しには `bedrock:PutUseCaseForModelAccess` IAM 権限が必要です。承認は子アカウントに自動的に拡張されます。133AWS Organizations を使用する場合、[`PutUseCaseForModelAccess` API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_PutUseCaseForModelAccess.html) を使用して管理アカウントからフォームを 1 回送信できます。この呼び出しには `bedrock:PutUseCaseForModelAccess` IAM 権限が必要です。承認は子アカウントに自動的に拡張されます。

54 134 

55### 2. AWS 認証情報を設定135<h3 id="2-configure-aws-credentials">

136 2. AWS 認証情報を設定

137</h3>

56 138 

57Claude Code は、デフォルトの AWS SDK 認証情報チェーンを使用します。以下のいずれかの方法を使用して認証情報を設定してください。139Claude Code は、デフォルトの AWS SDK 認証情報チェーンを使用します。以下のいずれかの方法を使用して認証情報を設定してください。

58 140 


94 176 

95Bedrock API キーは、完全な AWS 認証情報を必要としない、より簡単な認証方法を提供します。[Bedrock API キーについて詳しく学習](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)してください。177Bedrock API キーは、完全な AWS 認証情報を必要としない、より簡単な認証方法を提供します。[Bedrock API キーについて詳しく学習](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)してください。

96 178 

97#### 高度な認証情報設定179<h4 id="advanced-credential-configuration">

180 高度な認証情報設定

181</h4>

98 182 

99Claude Code は、AWS SSO および企業 ID プロバイダーの自動認証情報更新をサポートしています。これらの設定を Claude Code 設定ファイルに追加してください(ファイルの場所については [Settings](/ja/settings) を参照)。183Claude Code は、AWS SSO および企業 ID プロバイダーの自動認証情報更新をサポートしています。これらの設定を Claude Code 設定ファイルに追加してください(ファイルの場所については [Settings](/ja/settings) を参照)。

100 184 


103* **`awsAuthRefresh`**:Claude Code がローカルのタイムスタンプに基づくか、Bedrock が認証情報エラーを返した場合に AWS 認証情報の有効期限が切れていることを検出した場合にのみ実行され、更新された認証情報でリクエストを再試行します。187* **`awsAuthRefresh`**:Claude Code がローカルのタイムスタンプに基づくか、Bedrock が認証情報エラーを返した場合に AWS 認証情報の有効期限が切れていることを検出した場合にのみ実行され、更新された認証情報でリクエストを再試行します。

104* **`awsCredentialExport`**:セッション開始時および各認証情報リロード時に実行されます。AWS デフォルト認証情報プロバイダーチェーン内の認証情報がまだ有効な場合でも実行されます。Bedrock アカウントがデフォルトプロバイダーチェーンが解決するものと異なるクロスアカウント認証情報を必要とする場合に使用します。188* **`awsCredentialExport`**:セッション開始時および各認証情報リロード時に実行されます。AWS デフォルト認証情報プロバイダーチェーン内の認証情報がまだ有効な場合でも実行されます。Bedrock アカウントがデフォルトプロバイダーチェーンが解決するものと異なるクロスアカウント認証情報を必要とする場合に使用します。

105 189 

106##### 設定例190<h5 id="example-configuration">

191 設定例

192</h5>

107 193 

108```json theme={null}194```json theme={null}

109{195{


114}200}

115```201```

116 202 

117##### 設定の説明203<h5 id="configuration-settings-explained">

204 設定の説明

205</h5>

118 206 

119**`awsAuthRefresh`**:`.aws` ディレクトリを変更するコマンド(認証情報、SSO キャッシュ、または設定ファイルの更新など)に使用します。コマンドの出力はユーザーに表示されますが、対話的な入力はサポートされていません。これは、CLI が URL またはコードを表示し、ブラウザで認証を完了するブラウザベースの SSO フローに適しています。207**`awsAuthRefresh`**:`.aws` ディレクトリを変更するコマンド(認証情報、SSO キャッシュ、または設定ファイルの更新など)に使用します。コマンドの出力はユーザーに表示されますが、対話的な入力はサポートされていません。これは、CLI が URL またはコードを表示し、ブラウザで認証を完了するブラウザベースの SSO フローに適しています。

120 208 


125 "Credentials": {213 "Credentials": {

126 "AccessKeyId": "value",214 "AccessKeyId": "value",

127 "SecretAccessKey": "value",215 "SecretAccessKey": "value",

128 "SessionToken": "value"216 "SessionToken": "value",

217 "Expiration": "2026-01-01T00:00:00Z"

129 }218 }

130}219}

131```220```

132 221 

133### 3. Claude Code を設定222`Expiration` はオプションです。{/* min-version: 2.1.176 */}Claude Code v2.1.176 以降では、コマンドが有効な ISO 8601 `Expiration` を返す場合、Claude Code はその時刻の 5 分前までの認証情報をキャッシュします。それがない場合、または以前のバージョンでは、認証情報は 1 時間キャッシュされます。

223 

224<h3 id="3-configure-claude-code">

225 3. Claude Code を設定

226</h3>

134 227 

135Bedrock を有効にするために、以下の環境変数を設定します。228Bedrock を有効にするために、以下の環境変数を設定します。

136 229 

137```bash theme={null}230```bash theme={null}

138# Bedrock 統合を有効にする231# Bedrock 統合を有効にする

139export CLAUDE_CODE_USE_BEDROCK=1232export CLAUDE_CODE_USE_BEDROCK=1

140export AWS_REGION=us-east-1 # または希望するリージョン233export AWS_REGION=us-east-1 # AWS プロファイルがすでにリージョンを設定している場合はオプション

141 234 

142# オプション:小型/高速モデル(Bedrock および Mantle)の AWS リージョンをオーバーライド235# オプション:小型/高速モデル(Bedrock および Mantle)の AWS リージョンをオーバーライド

143# Bedrock では、ANTHROPIC_DEFAULT_HAIKU_MODEL236# Bedrock では、ANTHROPIC_DEFAULT_HAIKU_MODEL


150 243 

151Claude Code で Bedrock を有効にする場合は、以下に注意してください。244Claude Code で Bedrock を有効にする場合は、以下に注意してください。

152 245 

153* `AWS_REGION` は必須の環境変数です。Claude Code はこの設定について `.aws` 設定ファイルから読み込みません246* {/* min-version: 2.1.172 */}v2.1.172 以降では、AWS プロファイルのリージョンをオーバーライドする場合、またはプロファイルにリージョンがない場合にのみ `AWS_REGION` を設定する必要があります。Claude Code はこの順序でリージョンを解決します

247 

248 * `AWS_REGION`

249 * `AWS_DEFAULT_REGION`

250 * AWS 共有認証情報ファイルから最初に読み込まれ、次に共有設定ファイルから読み込まれた、アクティブな AWS プロファイルに設定されたリージョン(AWS SDK の優先順位と一致)

251 * `us-east-1`

252 

253 アクティブなプロファイルは、設定されている場合は `AWS_PROFILE`、そうでない場合は `default` です。`AWS_SHARED_CREDENTIALS_FILE` または `AWS_CONFIG_FILE` を設定して、デフォルト以外のファイルパスを指定します。`/status` を実行して、解決されたリージョンを確認します。リージョンが AWS 設定ファイルまたはデフォルトフォールバックから取得された場合、`/status` はソースも記載します。v2.1.171 以前では、Claude Code は AWS 設定ファイルを読み込まないため、`AWS_REGION` を明示的に設定してください。

154* Bedrock を使用する場合、`/logout` コマンドは無効になります。認証は AWS 認証情報を通じて処理されるためです。254* Bedrock を使用する場合、`/logout` コマンドは無効になります。認証は AWS 認証情報を通じて処理されるためです。

155* WebSearch ツールは Bedrock では利用できません。[WebSearch ツールの動作](/ja/tools-reference#websearch-tool-behavior)を参照してください。255* WebSearch ツールは Bedrock では利用できません。[WebSearch ツールの動作](/ja/tools-reference#websearch-tool-behavior)を参照してください。

156* 他のプロセスに漏らしたくない `AWS_PROFILE` などの環境変数に設定ファイルを使用できます。詳細については [Settings](/ja/settings) を参照してください。256* 他のプロセスに漏らしたくない `AWS_PROFILE` などの環境変数に設定ファイルを使用できます。詳細については [Settings](/ja/settings) を参照してください。

157 257 

158### 4. モデルバージョンをピン留め258<h3 id="4-pin-model-versions">

259 4. モデルバージョンをピン留め

260</h3>

159 261 

160<Warning>262<Warning>

161 複数のユーザーにデプロイする場合は、特定のモデルバージョンをピン留めしてください。ピン留めなしでは、`sonnet` や `opus` などのモデルエイリアスは最新バージョンに解決されます。これは、Anthropic がアップデートをリリースしたときに、Bedrock アカウントでまだ利用できない可能性があります。Claude Code は、最新が利用できない場合、スタートアップで[前のバージョンにフォールバック](#startup-model-checks)しますが、ピン留めするとユーザーが新しいモデルに移行するタイミングを制御できます。263 複数のユーザーにデプロイする場合は、特定のモデルバージョンをピン留めしてください。ピン留めなしでは、`sonnet` や `opus` などのモデルエイリアスは Claude Code の Bedrock 用の組み込みデフォルトに解決されますこれは最新リリースより遅れる可能性があり、アカウントでまだ利用できない場合があります。Claude Code は、デフォルトが利用できない場合、スタートアップで[前のバージョンにフォールバック](#startup-model-checks)しますが、ピン留めするとユーザーが新しいモデルに移行するタイミングを制御できます。

162</Warning>264</Warning>

163 265 

164これらの環境変数を特定の Bedrock モデル ID に設定します。266これらの環境変数を特定の Bedrock モデル ID に設定します。


171export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'273export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

172```274```

173 275 

174これらの変数は、クロスリージョン推論プロファイル ID(`us.` プレフィックス付き)を使用します。別のリージョンプレフィックスまたはアプリケーション推論プロファイルを使用する場合は、それに応じて調整してください。現在および従来のモデル ID については、[Models overview](https://platform.claude.com/docs/en/about-claude/models/overview) を参照してください。環境変数の完全なリストについては、[Model configuration](/ja/model-config#pin-models-for-third-party-deployments) を参照してください。276これらの変数は、クロスリージョン推論プロファイル ID(`us.` プレフィックス付き)を使用します。別のリージョンプレフィックスまたはアプリケーション推論プロファイルを使用する場合は、それに応じて調整してください。AWS GovCloud リージョンでは、`us-gov.` プレフィックスを使用します。現在および従来のモデル ID については、[Models overview](https://platform.claude.com/docs/en/about-claude/models/overview) を参照してください。環境変数の完全なリストについては、[Model configuration](/ja/model-config#pin-models-for-third-party-deployments) を参照してください。

175 277 

176ピン留め変数が設定されていない場合、Claude Code はこれらのデフォルトモデルを使用します。278ピン留め変数が設定されていない場合、Claude Code はこれらのデフォルトモデルを使用します。

177 279 


203 305 

204<Note>プロンプトキャッシングは、すべての Bedrock リージョンで利用できない場合があります。キャッシュトークンカウントがゼロのままの場合は、Bedrock ドキュメントの[サポートされているモデル、リージョン、および制限](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models)を確認してください。</Note>306<Note>プロンプトキャッシングは、すべての Bedrock リージョンで利用できない場合があります。キャッシュトークンカウントがゼロのままの場合は、Bedrock ドキュメントの[サポートされているモデル、リージョン、および制限](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models)を確認してください。</Note>

205 307 

206#### 各モデルバージョンを推論プロファイルにマップ308<h4 id="map-each-model-version-to-an-inference-profile">

309 各モデルバージョンを推論プロファイルにマップ

310</h4>

207 311 

208`ANTHROPIC_DEFAULT_*_MODEL` 環境変数は、モデルファミリーごとに 1 つの推論プロファイルを設定します。組織が同じファミリーの複数のバージョンを `/model` ピッカーで公開し、それぞれを独自のアプリケーション推論プロファイル ARN にルーティングする必要がある場合は、代わりに [settings file](/ja/settings#settings-files) の `modelOverrides` 設定を使用してください。312`ANTHROPIC_DEFAULT_*_MODEL` 環境変数は、モデルファミリーごとに 1 つの推論プロファイルを設定します。組織が同じファミリーの複数のバージョンを `/model` ピッカーで公開し、それぞれを独自のアプリケーション推論プロファイル ARN にルーティングする必要がある場合は、代わりに [settings file](/ja/settings#settings-files) の `modelOverrides` 設定を使用してください。

209 313 


222 326 

223ユーザーが `/model` でこれらのバージョンのいずれかを選択すると、Claude Code はマップされた ARN で Bedrock を呼び出します。オーバーライドのないバージョンは、組み込みの Bedrock モデル ID またはスタートアップで検出された一致する推論プロファイルにフォールバックします。オーバーライドが `availableModels` および他のモデル設定とどのように相互作用するかについては、[Override model IDs per version](/ja/model-config#override-model-ids-per-version) を参照してください。327ユーザーが `/model` でこれらのバージョンのいずれかを選択すると、Claude Code はマップされた ARN で Bedrock を呼び出します。オーバーライドのないバージョンは、組み込みの Bedrock モデル ID またはスタートアップで検出された一致する推論プロファイルにフォールバックします。オーバーライドが `availableModels` および他のモデル設定とどのように相互作用するかについては、[Override model IDs per version](/ja/model-config#override-model-ids-per-version) を参照してください。

224 328 

225## スタートアップモデルチェック329<h2 id="startup-model-checks">

330 スタートアップモデルチェック

331</h2>

226 332 

227Claude Code が Bedrock で設定されて起動すると、使用するモデルがアカウントでアクセス可能であることを確認します。このチェックには Claude Code v2.1.94 以降が必要です。333Claude Code が Bedrock で設定されて起動すると、使用するモデルがアカウントでアクセス可能であることを確認します。このチェックには Claude Code v2.1.94 以降が必要です。

228 334 

229現在の Claude Code デフォルトより古いモデルバージョンをピン留めしていて、アカウントが新しいバージョンを呼び出せる場合、Claude Code はピンを更新するよう促します。受け入れると、新しいモデル ID が [user settings file](/ja/settings) に書き込まれ、Claude Code が再起動されます。拒否すると、次のデフォルトバージョン変更まで記憶されます。[アプリケーション推論プロファイル ARN](#各モデルバージョンを推論プロファイルにマップ)を指す PIN は、管理者によって管理されるため、スキップされます。335現在の Claude Code デフォルトより古いモデルバージョンをピン留めしていて、アカウントが新しいバージョンを呼び出せる場合、Claude Code はピンを更新するよう促します。受け入れると、新しいモデル ID が [user settings file](/ja/settings) に書き込まれ、Claude Code が再起動されます。拒否すると、次のデフォルトバージョン変更まで記憶されます。[アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile)を指す PIN は、管理者によって管理されるため、スキップされます。

230 336 

231モデルをピン留めしていなくて、現在のデフォルトがアカウントで利用できない場合、Claude Code は現在のセッションで前のバージョンにフォールバックし、通知を表示します。フォールバックは永続化されません。Bedrock アカウントで新しいモデルを有効にするか、[バージョンをピン留め](#4-モデルバージョンをピン留め)して選択を永続化してください。337モデルをピン留めしていなくて、現在のデフォルトがアカウントで利用できない場合、Claude Code は現在のセッションで前のバージョンにフォールバックし、通知を表示します。フォールバックは永続化されません。Bedrock アカウントで新しいモデルを有効にするか、[バージョンをピン留め](#4-pin-model-versions)して選択を永続化してください。

232 338 

233## IAM 設定339<h2 id="iam-configuration">

340 IAM 設定

341</h2>

234 342 

235Claude Code に必要な権限を持つ IAM ポリシーを作成します。343Claude Code に必要な権限を持つ IAM ポリシーを作成します。

236 344 


273 381 

274より制限的な権限の場合は、リソースを特定の推論プロファイル ARN に制限できます。382より制限的な権限の場合は、リソースを特定の推論プロファイル ARN に制限できます。

275 383 

276`bedrock:GetInferenceProfile` により、Claude Code は[アプリケーション推論プロファイル ARN](#各モデルバージョンを推論プロファイルにマップ)をそのバッキング基盤モデルに解決でき、そのモデルに対して正しいリクエスト形状を選択するために使用されます。384`bedrock:GetInferenceProfile` により、Claude Code は[アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile)をそのバッキング基盤モデルに解決でき、そのモデルに対して正しいリクエスト形状を選択するために使用されます。

277 385 

278トークンにこの権限がない場合、Claude Code は代替形状で 1 回再試行することで自動的に復旧するため、リクエストは成功しますが、新しいモデルが追加されるたびに追加のラウンドトリップが発生します。権限を付与することで再試行を回避できます。これは `AWS_BEARER_TOKEN_BEDROCK` デプロイメントに最も頻繁に適用され、トークンのポリシーは通常、完全な IAM ロールよりも狭くなります。386トークンにこの権限がない場合、Claude Code は代替形状で 1 回再試行することで自動的に復旧するため、リクエストは成功しますが、新しいモデルが追加されるたびに追加のラウンドトリップが発生します。権限を付与することで再試行を回避できます。これは `AWS_BEARER_TOKEN_BEDROCK` デプロイメントに最も頻繁に適用され、トークンのポリシーは通常、完全な IAM ロールよりも狭くなります。

279 387 

280詳細については、[Bedrock IAM documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam.html) を参照してください。388詳細については、[Bedrock IAM documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam.html)を参照してください。

281 389 

282<Note>390<Note>

283 コスト追跡とアクセス制御を簡素化するために、Claude Code 用の専用 AWS アカウントを作成してください。391 コスト追跡とアクセス制御を簡素化するために、Claude Code 用の専用 AWS アカウントを作成してください。

284</Note>392</Note>

285 393 

286## 1M トークンコンテキストウィンドウ394<h2 id="1m-token-context-window">

395 1M トークンコンテキストウィンドウ

396</h2>

287 397 

288Claude Opus 4.6 以降および Sonnet 4.6 は、Amazon Bedrock で [1M トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。Claude Code は、1M モデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。398Claude Opus 4.6 以降および Sonnet 4.6 は、Amazon Bedrock で [1M トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。Claude Code は、1M モデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。

289 399 

290[セットアップウィザード](#bedrock-でサインイン)は、モデルをピン留めするときに 1M コンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[Pin models for third-party deployments](/ja/model-config#pin-models-for-third-party-deployments) を参照してください。400[セットアップウィザード](#sign-in-with-bedrock)は、モデルをピン留めするときに 1M コンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[Pin models for third-party deployments](/ja/model-config#pin-models-for-third-party-deployments) を参照してください。

291 401 

292## サービスティア402<h2 id="service-tiers">

403 サービスティア

404</h2>

293 405 

294[Amazon Bedrock サービスティア](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)を使用すると、コストとレイテンシーのトレードオフを行うことができます。`ANTHROPIC_BEDROCK_SERVICE_TIER` を `default`、`flex`、または `priority` に設定します。406[Amazon Bedrock サービスティア](https://docs.aws.amazon.com/bedrock/latest/userguide/service-tiers-inference.html)を使用すると、コストとレイテンシーのトレードオフを行うことができます。`ANTHROPIC_BEDROCK_SERVICE_TIER` を `default`、`flex`、または `priority` に設定します。

295 407 


299 411 

300Claude Code は、各リクエストで `X-Amzn-Bedrock-Service-Tier` ヘッダーとしてこれを送信します。ティアの可用性はモデルとリージョンによって異なります。予約容量は、この設定の代わりに[プロビジョニングされたスループット](https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html) ARN をモデル ID として使用します。412Claude Code は、各リクエストで `X-Amzn-Bedrock-Service-Tier` ヘッダーとしてこれを送信します。ティアの可用性はモデルとリージョンによって異なります。予約容量は、この設定の代わりに[プロビジョニングされたスループット](https://docs.aws.amazon.com/bedrock/latest/userguide/prov-throughput.html) ARN をモデル ID として使用します。

301 413 

302## AWS Guardrails414<h2 id="aws-guardrails">

415 AWS Guardrails

416</h2>

303 417 

304[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html)を使用すると、Claude Code のコンテンツフィルタリングを実装できます。[Amazon Bedrock コンソール](https://console.aws.amazon.com/bedrock/)で Guardrail を作成し、バージョンを公開してから、Guardrail ヘッダーを [settings file](/ja/settings) に追加します。クロスリージョン推論プロファイルを使用している場合は、Guardrail でクロスリージョン推論を有効にしてください。418[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html)を使用すると、Claude Code のコンテンツフィルタリングを実装できます。[Amazon Bedrock コンソール](https://console.aws.amazon.com/bedrock/)で Guardrail を作成し、バージョンを公開してから、Guardrail ヘッダーを [settings file](/ja/settings) に追加します。クロスリージョン推論プロファイルを使用している場合は、Guardrail でクロスリージョン推論を有効にしてください。

305 419 


313}427}

314```428```

315 429 

316## Mantle エンドポイントを使用430<h2 id="use-the-mantle-endpoint">

431 Mantle エンドポイントを使用

432</h2>

317 433 

318Mantle は、Bedrock Invoke API ではなく、ネイティブ Anthropic API シェイプを通じて Claude モデルを提供する Amazon Bedrock エンドポイントです。同じ AWS 認証情報、IAM 権限、および `awsAuthRefresh` 設定を使用します。このページで前述したものです。434Mantle は、Bedrock Invoke API ではなく、ネイティブ Anthropic API シェイプを通じて Claude モデルを提供する Amazon Bedrock エンドポイントです。同じ AWS 認証情報、IAM 権限、および `awsAuthRefresh` 設定を使用します。このページで前述したものです。

319 435 


321 Mantle には Claude Code v2.1.94 以降が必要です。確認するには `claude --version` を実行してください。437 Mantle には Claude Code v2.1.94 以降が必要です。確認するには `claude --version` を実行してください。

322</Note>438</Note>

323 439 

324### Mantle を有効にする440<h3 id="enable-mantle">

441 Mantle を有効にする

442</h3>

325 443 

326AWS 認証情報が既に設定されている場合、`CLAUDE_CODE_USE_MANTLE` を設定して、リクエストを Mantle エンドポイントにルーティングします。444AWS 認証情報が既に設定されている場合、`CLAUDE_CODE_USE_MANTLE` を設定して、リクエストを Mantle エンドポイントにルーティングします。

327 445 


330export AWS_REGION=us-east-1448export AWS_REGION=us-east-1

331```449```

332 450 

333Claude Code は `AWS_REGION` からエンドポイント URL を構築します。カスタムエンドポイントまたはゲートウェイの場合、`ANTHROPIC_BEDROCK_MANTLE_BASE_URL` を設定してオーバーライドします451Claude Code は AWS リージョンからエンドポイント URL を構築します。{/* min-version: 2.1.172 */}v2.1.172 以降では、リージョンは [上記の Bedrock](#3-configure-claude-code) と同じ優先順位で解決されます。以前のバージョンは `AWS_REGION` のみを使用します。カスタムエンドポイントまたはゲートウェイの URL をオーバーライドするには、`ANTHROPIC_BEDROCK_MANTLE_BASE_URL` を設定します

334 452 

335Claude Code 内で `/status` を実行して確認します。Mantle がアクティブな場合、プロバイダー行は `Amazon Bedrock (Mantle)` を表示します。453Claude Code 内で `/status` を実行して確認します。Mantle がアクティブな場合、プロバイダー行は `Amazon Bedrock (Mantle)` を表示します。

336 454 

337### Mantle モデルを選択455<h3 id="select-a-mantle-model">

456 Mantle モデルを選択

457</h3>

338 458 

339Mantle は `anthropic.` で始まり、バージョンサフィックスのないモデル ID を使用します。例えば `anthropic.claude-haiku-4-5`。アカウントで利用可能なモデルは、組織に付与されたものに依存します。追加のモデル ID は AWS からのオンボーディング資料に記載されています。AWS アカウントチームに連絡して、許可リストされたモデルへのアクセスをリクエストしてください。459Mantle は `anthropic.` で始まり、バージョンサフィックスのないモデル ID を使用します。例えば `anthropic.claude-haiku-4-5`。アカウントで利用可能なモデルは、組織に付与されたものに依存します。追加のモデル ID は AWS からのオンボーディング資料に記載されています。AWS アカウントチームに連絡して、許可リストされたモデルへのアクセスをリクエストしてください。

340 460 


344claude --model anthropic.claude-haiku-4-5464claude --model anthropic.claude-haiku-4-5

345```465```

346 466 

347### Mantle を Invoke API と並行して実行467<h3 id="run-mantle-alongside-the-invoke-api">

468 Mantle を Invoke API と並行して実行

469</h3>

348 470 

349Mantle で利用可能なモデルは、今日使用するすべてのモデルを含まない場合があります。`CLAUDE_CODE_USE_BEDROCK` と `CLAUDE_CODE_USE_MANTLE` の両方を設定すると、Claude Code は同じセッションから両方のエンドポイントを呼び出せます。Mantle 形式に一致するモデル ID は Mantle にルーティングされ、他のすべてのモデル ID は Bedrock Invoke API に移動します。471Mantle で利用可能なモデルは、今日使用するすべてのモデルを含まない場合があります。`CLAUDE_CODE_USE_BEDROCK` と `CLAUDE_CODE_USE_MANTLE` の両方を設定すると、Claude Code は同じセッションから両方のエンドポイントを呼び出せます。Mantle 形式に一致するモデル ID は Mantle にルーティングされ、他のすべてのモデル ID は Bedrock Invoke API に移動します。

350 472 


365 487 

366両方のプロバイダーがアクティブな場合、`/status` は `Amazon Bedrock + Amazon Bedrock (Mantle)` を表示します。488両方のプロバイダーがアクティブな場合、`/status` は `Amazon Bedrock + Amazon Bedrock (Mantle)` を表示します。

367 489 

368### Mantle をゲートウェイ経由でルーティング490<h3 id="route-mantle-through-a-gateway">

491 Mantle をゲートウェイ経由でルーティング

492</h3>

369 493 

370組織がモデルトラフィックを集中化された [LLM gateway](/ja/llm-gateway) を通じてルーティングし、AWS 認証情報をサーバー側に注入する場合、クライアント側認証を無効にして、Claude Code が SigV4 署名または `x-api-key` ヘッダーなしでリクエストを送信するようにします。494組織がモデルトラフィックを集中化された [LLM gateway](/ja/llm-gateway) を通じてルーティングし、AWS 認証情報をサーバー側に注入する場合、クライアント側認証を無効にして、Claude Code が SigV4 署名または `x-api-key` ヘッダーなしでリクエストを送信するようにします。

371 495 


375export ANTHROPIC_BEDROCK_MANTLE_BASE_URL=https://your-gateway.example.com499export ANTHROPIC_BEDROCK_MANTLE_BASE_URL=https://your-gateway.example.com

376```500```

377 501 

378### Mantle 環境変数502<h3 id="mantle-environment-variables">

503 Mantle 環境変数

504</h3>

379 505 

380これらの変数は Mantle エンドポイントに固有です。完全なリストについては、[Environment variables](/ja/env-vars) を参照してください。506これらの変数は Mantle エンドポイントに固有です。完全なリストについては、[Environment variables](/ja/env-vars) を参照してください。

381 507 


386| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | プロキシセットアップのクライアント側認証をスキップ |512| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | プロキシセットアップのクライアント側認証をスキップ |

387| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Haiku クラスモデルの AWS リージョンをオーバーライド(Bedrock と共有) |513| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | Haiku クラスモデルの AWS リージョンをオーバーライド(Bedrock と共有) |

388 514 

389## トラブルシューティング515<h2 id="troubleshooting">

516 トラブルシューティング

517</h2>

390 518 

391### SSO と企業プロキシでの認証ループ519<h3 id="authentication-loop-with-sso-and-corporate-proxies">

520 SSO と企業プロキシでの認証ループ

521</h3>

392 522 

393AWS SSO を使用する場合にブラウザタブが繰り返し生成される場合は、[settings file](/ja/settings) から `awsAuthRefresh` 設定を削除してください。これは、企業 VPN または TLS 検査プロキシが SSO ブラウザフローを中断した場合に発生する可能性があります。Claude Code は中断された接続を認証失敗として扱い、`awsAuthRefresh` を再実行し、無限ループします。523AWS SSO を使用する場合にブラウザタブが繰り返し生成される場合は、[settings file](/ja/settings) から `awsAuthRefresh` 設定を削除してください。これは、企業 VPN または TLS 検査プロキシが SSO ブラウザフローを中断した場合に発生する可能性があります。Claude Code は中断された接続を認証失敗として扱い、`awsAuthRefresh` を再実行し、無限ループします。

394 524 

395ネットワーク環境が自動ブラウザベースの SSO フローに干渉する場合は、`awsAuthRefresh` に依存する代わりに、Claude Code を開始する前に手動で `aws sso login` を使用してください。525ネットワーク環境が自動ブラウザベースの SSO フローに干渉する場合は、`awsAuthRefresh` に依存する代わりに、Claude Code を開始する前に手動で `aws sso login` を使用してください。

396 526 

397### リージョンの問題527<h3 id="region-issues">

528 リージョンの問題

529</h3>

398 530 

399リージョンの問題が発生した場合:531リージョンの問題が発生した場合:

400 532 


408 540 

409Claude Code は Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) を使用し、Converse API はサポートしていません。541Claude Code は Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) を使用し、Converse API はサポートしていません。

410 542 

411### Mantle エンドポイントエラー543<h3 id="mantle-endpoint-errors">

544 Mantle エンドポイントエラー

545</h3>

412 546 

413`CLAUDE_CODE_USE_MANTLE` を設定した後、`/status` が `Amazon Bedrock (Mantle)` を表示しない場合、変数がプロセスに到達していません。Claude Code を起動したシェルでエクスポートされているか、[settings file](/ja/settings) の `env` ブロックで設定されていることを確認してください。547`CLAUDE_CODE_USE_MANTLE` を設定した後、`/status` が `Amazon Bedrock (Mantle)` を表示しない場合、変数がプロセスに到達していません。Claude Code を起動したシェルでエクスポートされているか、[settings file](/ja/settings) の `env` ブロックで設定されていることを確認してください。

414 548 


416 550 

417モデル ID を名前付ける `400` は、そのモデルが Mantle で提供されていないことを意味します。Mantle は標準 Bedrock カタログとは別の独自のモデルラインアップを持っているため、`us.anthropic.claude-sonnet-4-6` などの推論プロファイル ID は機能しません。Mantle 形式の ID を使用するか、[両方のエンドポイントを有効にして](#run-mantle-alongside-the-invoke-api)、Claude Code が各リクエストをモデルが利用可能なエンドポイントにルーティングするようにしてください。551モデル ID を名前付ける `400` は、そのモデルが Mantle で提供されていないことを意味します。Mantle は標準 Bedrock カタログとは別の独自のモデルラインアップを持っているため、`us.anthropic.claude-sonnet-4-6` などの推論プロファイル ID は機能しません。Mantle 形式の ID を使用するか、[両方のエンドポイントを有効にして](#run-mantle-alongside-the-invoke-api)、Claude Code が各リクエストをモデルが利用可能なエンドポイントにルーティングするようにしてください。

418 552 

419## 追加リソース553<h2 id="additional-resources">

554 追加リソース

555</h2>

420 556 

421* [Bedrock documentation](https://docs.aws.amazon.com/bedrock/)557* [Bedrock documentation](https://docs.aws.amazon.com/bedrock/)

422* [Bedrock pricing](https://aws.amazon.com/bedrock/pricing/)558* [Bedrock pricing](https://aws.amazon.com/bedrock/pricing/)

analytics.md +1 −1

Details

149 属性プロセス149 属性プロセス

150</h4>150</h4>

151 151 

152プルリクエストがマージされるとき152プルリクエストがマージされるとき

153 153 

1541. 追加された行が PR diff から抽出されます1541. 追加された行が PR diff から抽出されます

1552. 時間ウィンドウ内で一致するファイルを編集した Claude Code セッションが識別されます1552. 時間ウィンドウ内で一致するファイルを編集した Claude Code セッションが識別されます

Details

136* **更新間隔**: デフォルトでは、`apiKeyHelper` は 5 分後または HTTP 401 レスポンス時に呼び出されます。カスタム更新間隔の場合は、`CLAUDE_CODE_API_KEY_HELPER_TTL_MS` 環境変数を設定してください。136* **更新間隔**: デフォルトでは、`apiKeyHelper` は 5 分後または HTTP 401 レスポンス時に呼び出されます。カスタム更新間隔の場合は、`CLAUDE_CODE_API_KEY_HELPER_TTL_MS` 環境変数を設定してください。

137* **遅いヘルパー通知**: `apiKeyHelper` がキーを返すのに 10 秒以上かかる場合、Claude Code はプロンプトバーに経過時間を表示する警告通知を表示します。この通知が定期的に表示される場合は、認証情報スクリプトを最適化できるかどうかを確認してください。137* **遅いヘルパー通知**: `apiKeyHelper` がキーを返すのに 10 秒以上かかる場合、Claude Code はプロンプトバーに経過時間を表示する警告通知を表示します。この通知が定期的に表示される場合は、認証情報スクリプトを最適化できるかどうかを確認してください。

138 138 

139`apiKeyHelper`、`ANTHROPIC_API_KEY`、および `ANTHROPIC_AUTH_TOKEN` はターミナル CLI セッションにのみ適用されます。Claude Desktop とリモートセッションは OAuth のみを使用し、`apiKeyHelper` を呼び出したり、API キー環境変数を読み込んだりしません。139`apiKeyHelper`、`ANTHROPIC_API_KEY`、および `ANTHROPIC_AUTH_TOKEN` はターミナル CLI セッションにのみ適用されます。Claude Desktop とクラウドセッションは OAuth のみを使用し、`apiKeyHelper` を呼び出したり、API キー環境変数を読み込んだりしません。

140 140 

141<h3 id="authentication-precedence">141<h3 id="authentication-precedence">

142 認証の優先順位142 認証の優先順位

Details

6 6 

7> オートモード分類器に、組織が信頼するリポジトリ、バケット、ドメインを指定します。環境コンテキストを設定し、デフォルトのブロックルールと許可ルールをオーバーライドし、オートモード CLI サブコマンドで有効な設定を確認します。7> オートモード分類器に、組織が信頼するリポジトリ、バケット、ドメインを指定します。環境コンテキストを設定し、デフォルトのブロックルールと許可ルールをオーバーライドし、オートモード CLI サブコマンドで有効な設定を確認します。

8 8 

9[オートモード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を使用すると、Claude Code は各ツール呼び出しを分類器にルーティングして、不可逆的、破壊的、または環境外を対象とした操作をブロックすることで、権限プロンプトなしで実行できます。`autoMode` 設定ブロックを使用して、その分類器に、組織が信頼するリポジトリ、バケット、ドメインを指定すると、ルーチンの内部操作のブロックが停止します。9[オートモード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を使用すると、Claude Code は各ツール呼び出しを分類器にルーティングして、不可逆的、破壊的、または環境外を対象とした操作をブロックすることで、権限プロンプトなしで実行できます。Deny ルールと explicit ask ルールは分類器の前に評価され、引き続きブロックまたはプロンプトを表示します。`autoMode` 設定ブロックを使用して、その分類器に、組織が信頼するリポジトリ、バケット、ドメインを指定すると、ルーチンの内部操作のブロックが停止します。

10 10 

11<Note>11<Note>

12 オートモードは、Anthropic API を通じてすべてのユーザーが利用できます。Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry では、まず [`CLAUDE_CODE_ENABLE_AUTO_MODE`](/ja/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) を[設定](/ja/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry)する必要があります。Claude Code がアカウントでオートモードが利用不可と報告する場合は、[完全な要件](/ja/permission-modes#eliminate-prompts-with-auto-mode)を確認してください。これには、サポートされているモデルと Team および Enterprise プランの管理者有効化も含まれます。12 オートモードは、Anthropic API を通じてすべてのユーザーが利用できます。Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry では、まず [`CLAUDE_CODE_ENABLE_AUTO_MODE`](/ja/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) を[設定](/ja/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry)する必要があります。Claude Code がアカウントでオートモードが利用不可と報告する場合は、[完全な要件](/ja/permission-modes#eliminate-prompts-with-auto-mode)を確認してください。これには、サポートされているモデルと Team および Enterprise プランの管理者有効化も含まれます。


33信頼できるインフラストラクチャや組織全体の拒否ルールなど、プロジェクト全体に適用されるルールについては、`autoMode` 設定ブロックを使用します。分類器は以下のスコープから `autoMode` を読み込みます。33信頼できるインフラストラクチャや組織全体の拒否ルールなど、プロジェクト全体に適用されるルールについては、`autoMode` 設定ブロックを使用します。分類器は以下のスコープから `autoMode` を読み込みます。

34 34 

35| スコープ | ファイル | 用途 |35| スコープ | ファイル | 用途 |

36| :---------------------------- | :---------------------------------- | :----------------------------------- |36| :---------------------------- | :---------------------------------- | :--------------------------- |

37| 1 人の開発者 | `~/.claude/settings.json` | 個人の信頼できるインフラストラクチャ |37| 1 人の開発者 | `~/.claude/settings.json` | 個人の信頼できるインフラストラクチャ |

38| 1 つのプロジェクト、1 人の開発者 | `.claude/settings.local.json` | プロジェクトごとの信頼できるバケットまたはサービス、gitignored |38| 1 つのプロジェクト、1 人の開発者 | `.claude/settings.local.json` | プロジェクトごとの信頼できるバケットまたはサービス |

39| 組織全体 | [管理設定](/ja/server-managed-settings) | すべての開発者に配布される信頼できるインフラストラクチャ |39| 組織全体 | [管理設定](/ja/server-managed-settings) | すべての開発者に配布される信頼できるインフラストラクチャ |

40| `--settings` フラグまたは Agent SDK | インライン JSON | 自動化のための呼び出しごとのオーバーライド |40| `--settings` フラグまたは Agent SDK | インライン JSON | 自動化のための呼び出しごとのオーバーライド |

41 41 


189 関連項目189 関連項目

190</h2>190</h2>

191 191 

192* [権限モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)オートモードとは何か、デフォルトでブロックされる内容、有効にする方法192* [権限モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)オートモードとは何か、デフォルトでブロックされる内容、有効にする方法

193* [管理設定](/ja/server-managed-settings)組織全体に `autoMode` 設定をデプロイ193* [管理設定](/ja/server-managed-settings)組織全体に `autoMode` 設定をデプロイ

194* [権限](/ja/permissions)分類器が実行される前に適用される許可、質問、拒否ルール194* [権限](/ja/permissions)分類器が実行される前に適用される許可、質問、拒否ルール

195* [設定](/ja/settings)`autoMode` キーを含む完全な設定リファレンス195* [設定](/ja/settings)`autoMode` キーを含む完全な設定リファレンス

Details

116 116 

117 ファイルは順番に 3 つのことを実行します:117 ファイルは順番に 3 つのことを実行します:

118 118 

119 * **サーバー設定**:`claude/channel` をその機能に含む MCP サーバーを作成します。これが Claude Code にこれがチャネルであることを伝えます。[`instructions`](#server-options) 文字列は Claude のシステムプロンプトに入ります:Claude に期待するイベント、返信するかどうか、返信する場合はどのツールを使用するか、どの属性を返送するか(`chat_id` など)を伝えます119 * **サーバー設定**:`claude/channel` をその機能に含む MCP サーバーを作成します。これが Claude Code にこれがチャネルであることを伝えます。[`instructions`](#server-options) 文字列は Claude のシステムプロンプトに入ります:Claude に期待するイベント、返信するかどうか、返信する場合はどのように返信を処理するかを伝えます

120 * **Stdio 接続**:stdin/stdout 経由で Claude Code に接続します。これは任意の [MCP サーバー](https://modelcontextprotocol.io/docs/concepts/transports#standard-io)の標準です:Claude Code はそれをサブプロセスとして生成します。120 * **Stdio 接続**:stdin/stdout 経由で Claude Code に接続します。これは任意の [MCP サーバー](https://modelcontextprotocol.io/docs/concepts/transports#standard-io) の標準です:Claude Code はそれをサブプロセスとして生成します。

121 * **HTTP リスナー**:ポート 8788 でローカル Web サーバーを開始します。すべての POST 本文は `mcp.notification()` 経由でチャネルイベントとして Claude に転送されます。`content` はイベント本文になり、各 `meta` エントリは `<channel>` タグの属性になります。リスナーは `mcp` インスタンスへのアクセスが必要なため、同じプロセスで実行されます。より大きなプロジェクトの場合は、別のモジュールに分割できます。121 * **HTTP リスナー**:ポート 8788 でローカル Web サーバーを開始します。すべての POST 本文は `mcp.notification()` 経由でチャネルイベントとして Claude に転送されます。`content` はイベント本文になり、各 `meta` エントリは `<channel>` タグの属性になります。リスナーは `mcp` インスタンスへのアクセスが必要なため、同じプロセスで実行されます。より大きなプロジェクトの場合は、別のモジュールに分割できます。

122 </Step>122 </Step>

123 123 


142 claude --dangerously-load-development-channels server:webhook142 claude --dangerously-load-development-channels server:webhook

143 ```143 ```

144 144 

145 このプロジェクトで初めてセッションを開始するとき、Claude Code は `.mcp.json` から新しいサーバーを使用する前に同意を求めます。ダイアログは'このプロジェクトで見つかった新しい MCP サーバー:webhook'と報告します。**このMCPサーバーを使用** を選択して続行します。

146 

145 Claude Code が起動すると、MCP 設定を読み込み、`webhook.ts` をサブプロセスとして生成し、HTTP リスナーは設定したポート(この例では 8788)で自動的に開始されます。サーバーを自分で実行する必要はありません。147 Claude Code が起動すると、MCP 設定を読み込み、`webhook.ts` をサブプロセスとして生成し、HTTP リスナーは設定したポート(この例では 8788)で自動的に開始されます。サーバーを自分で実行する必要はありません。

146 148 

147 'ブロックされた組織ポリシー'が表示される場合は、組織管理者が最初に[チャネルを有効化](/ja/channels#enterprise-controls)する必要があります149 スタートアップバナーの下の薄い通知がチャネルが登録されたことを確認します:`Channels (experimental) messages from server:webhook inject directly in this session · restart without --dangerously-load-development-channels to stop`

150 

151 '組織ポリシーによってブロックされています'が表示される場合は、組織管理者が最初に [チャネルを有効化](/ja/channels#enterprise-controls) する必要があります。

148 152 

149 別のターミナルで、HTTP POST でメッセージを送信して webhook をシミュレートします。この例は、CI 失敗アラートをポート 8788(または設定したポート)に送信します:153 別のターミナルで、HTTP POST でメッセージを送信して webhook をシミュレートします。この例は、CI 失敗アラートをポート 8788(または設定したポート)に送信します:

150 154 


158 <channel source="webhook" path="/" method="POST">build failed on main: https://ci.example.com/run/1234</channel>162 <channel source="webhook" path="/" method="POST">build failed on main: https://ci.example.com/run/1234</channel>

159 ```163 ```

160 164 

161 Claude Code ターミナルでは、Claude がメッセージを受け取り、応答を開始するのが見えます:ファイルを読み込み、コマンドを実行、またはメッセージが要求するもの。これは一方向チャネルなので、Claude はセッションで動作しますが、webhook を通じて何も返送しません。返信を追加するには、[返信ツールを公開](#expose-a-reply-tool)を参照してください。165 Claude Code ターミナルでは、Claude がメッセージを受け取り、応答を開始するのが見えます:ファイルを読み込み、コマンドを実行、またはメッセージが要求するもの。これは一方向チャネルなので、Claude はセッションで動作しますが、webhook を通じて何も返送しません。返信を追加するには、[返信ツールを公開](#expose-a-reply-tool) を参照してください。

162 166 

163 イベントが到着しない場合、診断は `curl` が返したものに依存します:167 イベントが到着しない場合、診断は `curl` が返したものに依存します:

164 168 


167 </Step>171 </Step>

168</Steps>172</Steps>

169 173 

170[fakechat サーバー](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/fakechat)は、Web UI、ファイル添付、および双方向チャットの返信ツールでこのパターンを拡張します。174[fakechat サーバー](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/fakechat) は、Web UI、ファイル添付、および双方向チャットの返信ツールでこのパターンを拡張します。

171 175 

172<h2 id="test-during-the-research-preview">176<h2 id="test-during-the-research-preview">

173 リサーチプレビュー中のテスト177 リサーチプレビュー中のテスト


753curl -d "list the files in this directory" -H "X-Sender: dev" localhost:8788757curl -d "list the files in this directory" -H "X-Sender: dev" localhost:8788

754```758```

755 759 

756ローカル権限ダイアログが Claude Code ターミナルで開きます。少し後、プロンプトが `/events` ストリームに表示され、5 文字の ID を含みます。リモート側から承認します:760ファイルをリストすることは読み取り専用なので、Claude は承認なしでそれを実行します。権限ダイアログは Claude `reply` ツールを呼び出して答えを返送するときに開きますローカルダイアログは Claude Code ターミナルで開き、少し後、`mcp__webhook__reply` のプロンプトが `/events` ストリームに表示され、5 文字の ID を含みます。リモート側から承認します:

757 761 

758```bash theme={null}762```bash theme={null}

759curl -d "yes <id>" -H "X-Sender: dev" localhost:8788763curl -d "yes <id>" -H "X-Sender: dev" localhost:8788

760```764```

761 765 

762ローカルダイアログが閉じ、ツールが実行されます。Claude の返信は `reply` ツール経由で戻りストリームにも到着します766ローカルダイアログが閉じ、`reply` ツールが実行されClaude の返信がストリームに到着します

763 767 

764このファイルの 3 つのチャネル固有の部分:768このファイルの 3 つのチャネル固有の部分:

765 769 

Details

81 Bash コマンドの変更は追跡されません81 Bash コマンドの変更は追跡されません

82</h3>82</h3>

83 83 

84チェックポイント機能は、bash コマンドで変更されたファイルを追跡しません。たとえば、Claude Code が以下を実行する場合84チェックポイント機能は、bash コマンドで変更されたファイルを追跡しません。たとえば、Claude Code が以下を実行する場合

85 85 

86```bash theme={null}86```bash theme={null}

87rm file.txt87rm file.txt


101 バージョン管理の代替ではありません101 バージョン管理の代替ではありません

102</h3>102</h3>

103 103 

104チェックポイントは、クイックなセッションレベルの復旧用に設計されています。永続的なバージョン履歴とコラボレーションの場合104チェックポイントは、クイックなセッションレベルの復旧用に設計されています。永続的なバージョン履歴とコラボレーションの場合

105 105 

106* バージョン管理(例:Git)を引き続き使用してコミット、ブランチ、長期履歴を管理します106* バージョン管理(例:Git)を引き続き使用してコミット、ブランチ、長期履歴を管理します

107* チェックポイントは適切なバージョン管理を補完しますが、置き換えるものではありません107* チェックポイントは適切なバージョン管理を補完しますが、置き換えるものではありません

Details

59 59 

60各セッションはリポジトリがクローンされた新しい Anthropic 管理 VM で実行されます。このセクションではセッション開始時に利用可能なものと、それをカスタマイズする方法をカバーしています。60各セッションはリポジトリがクローンされた新しい Anthropic 管理 VM で実行されます。このセクションではセッション開始時に利用可能なものと、それをカスタマイズする方法をカバーしています。

61 61 

62<h3 id="what-s-available-in-cloud-sessions">62<h3 id="whats-available-in-cloud-sessions">

63 クラウドセッションで利用可能なもの63 クラウドセッションで利用可能なもの

64</h3>64</h3>

65 65 

66クラウドセッションはリポジトリの新しいクローンから開始されます。リポジトリにコミットされたものはすべて利用可能です。自分のマシンにのみインストールまたは設定したものは利用できません。66クラウドセッションはリポジトリの新しいクローンから開始されます。リポジトリにコミットされたものはすべて利用可能です。自分のマシンにのみインストールまたは設定したものは利用できません。

67 67 

68| | クラウドセッションで利用可能 | 理由 |68| | クラウドセッションで利用可能 | 理由 |

69| :------------------------------------------------------------- | :------------- | :--------------------------------------------------------------------------------------------------------- |69| :----------------------------------------------------------------- | :------------- | :--------------------------------------------------------------------------------------------------------- |

70| リポジトリの `CLAUDE.md` | はい | クローンの一部 |70| リポジトリの `CLAUDE.md` | はい | クローンの一部 |

71| リポジトリの `.claude/settings.json` フック | はい | クローンの一部 |71| リポジトリの `.claude/settings.json` フック | はい | クローンの一部 |

72| リポジトリの `.mcp.json` MCP サーバー | はい | クローンの一部 |72| リポジトリの `.mcp.json` MCP サーバー | はい | クローンの一部 |


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

75| `.claude/settings.json` で宣言されたプラグイン | はい | 宣言した[マーケットプレイス](/ja/plugin-marketplaces)からセッション開始時にインストールされます。マーケットプレイスソースに到達するためにはネットワークアクセスが必要です |75| `.claude/settings.json` で宣言されたプラグイン | はい | 宣言した[マーケットプレイス](/ja/plugin-marketplaces)からセッション開始時にインストールされます。マーケットプレイスソースに到達するためにはネットワークアクセスが必要です |

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

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

77| ユーザー設定でのみ有効なプラグイン | いいえ | ユーザースコープの `enabledPlugins` は `~/.claude/settings.json` に存在します。代わりにリポジトリの `.claude/settings.json` で宣言してください |78| ユーザー設定でのみ有効なプラグイン | いいえ | ユーザースコープの `enabledPlugins` は `~/.claude/settings.json` に存在します。代わりにリポジトリの `.claude/settings.json` で宣言してください |

78| `claude mcp add` で追加した MCP サーバー | いいえ | これらはローカルユーザー設定に書き込まれ、リポジトリには書き込まれません。代わりに [`.mcp.json`](/ja/mcp#project-scope) でサーバーを宣言してください |79| `claude mcp add` で追加した MCP サーバー | いいえ | これらはローカルユーザー設定に書き込まれ、リポジトリには書き込まれません。代わりに [`.mcp.json`](/ja/mcp#project-scope) でサーバーを宣言してください |

79| 静的 API トークンと認証情報 | いいえ | 専用シークレットストアはまだ存在しません。以下を参照してください |80| 静的 API トークンと認証情報 | いいえ | 専用シークレットストアはまだ存在しません。以下を参照してください |


353* 悪意のあるリクエストに対する保護354* 悪意のあるリクエストに対する保護

354* レート制限と不正使用防止355* レート制限と不正使用防止

355* 強化されたセキュリティのためのコンテンツフィルタリング356* 強化されたセキュリティのためのコンテンツフィルタリング

357* リクエストされたホスト名の DNS レベル監査証跡

356 358 

357<h3 id="default-allowed-domains">359<h3 id="default-allowed-domains">

358 デフォルト許可ドメイン360 デフォルト許可ドメイン


745| `/context` | はい | 現在コンテキストウィンドウにあるものを表示します |747| `/context` | はい | 現在コンテキストウィンドウにあるものを表示します |

746| `/clear` | いいえ | サイドバーから新しいセッションを開始します |748| `/clear` | いいえ | サイドバーから新しいセッションを開始します |

747 749 

748自動圧縮はコンテキストウィンドウが容量に近づくと自動的に実行され、CLI と同じです。より早くトリガーするには、[環境変数](#configure-your-environment)で [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/ja/env-vars)を設定します。例えば、`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70` はデフォルトの \~95% ではなく 70% 容量で圧縮します。圧縮計算の有効なウィンドウサイズを変更するには、[`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/ja/env-vars)を使用します。750自動圧縮はコンテキストウィンドウが容量に近づくと自動的に実行されます。より早くトリガーするには、[環境変数](#configure-your-environment)で [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/ja/env-vars)を設定します。例えば、`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70` はウィンドウがほぼいっぱいになるまで待つのではなく、70% 容量で圧縮します。圧縮計算の有効なウィンドウサイズを変更するには、[`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/ja/env-vars)を使用します。

749 751 

750[Subagents](/ja/sub-agents)はローカルと同じように機能します。Claude は Task ツールでそれらをスポーンして、研究または並列作業を別のコンテキストウィンドウにオフロードし、メイン会話を軽くすることができます。リポジトリの `.claude/agents/` で定義された Subagents は自動的にピックアップされます。[Agent teams](/ja/agent-teams)はデフォルトでオフですが、[環境変数](#configure-your-environment)に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を追加することで有効にできます。752[Subagents](/ja/sub-agents)はローカルと同じように機能します。Claude は Task ツールでそれらをスポーンして、研究または並列作業を別のコンテキストウィンドウにオフロードし、メイン会話を軽くすることができます。リポジトリの `.claude/agents/` で定義された Subagents は自動的にピックアップされます。[Agent teams](/ja/agent-teams)はデフォルトでオフですが、[環境変数](#configure-your-environment)に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を追加することで有効にできます。

751 753 


868 870 

869* ローカルで `/login` を実行して認証情報をリフレッシュし、再接続してください871* ローカルで `/login` を実行して認証情報をリフレッシュし、再接続してください

870* セッションを所有する同じアカウントにサインインしていることを確認してください872* セッションを所有する同じアカウントにサインインしていることを確認してください

871* `Remote Control may not be available for this organization` が表示される場合、管理者がプランのリモートセッションを有効にしていません873* `Remote Control may not be available for this organization` が表示される場合、管理者がプランのクラウドセッションを有効にしていません

872 874 

873<h3 id="environment-expired">875<h3 id="environment-expired">

874 環境の有効期限切れ876 環境の有効期限切れ


886 888 

887* **レート制限**:ウェブ上の Claude Code はアカウント内のすべての他の Claude および Claude Code 使用とレート制限を共有します。複数のタスクを並列で実行すると、レート制限をより多く消費します。クラウド VM に対する個別のコンピュート料金はありません。889* **レート制限**:ウェブ上の Claude Code はアカウント内のすべての他の Claude および Claude Code 使用とレート制限を共有します。複数のタスクを並列で実行すると、レート制限をより多く消費します。クラウド VM に対する個別のコンピュート料金はありません。

888* **リポジトリ認証**:ウェブからローカルにセッションを移動できるのは、同じアカウントに認証されている場合のみです890* **リポジトリ認証**:ウェブからローカルにセッションを移動できるのは、同じアカウントに認証されている場合のみです

889* **プラットフォーム制限**:リポジトリのクローンとプルリクエストの作成には GitHub が必要です。自己ホスト型の [GitHub Enterprise Server](/ja/github-enterprise-server)インスタンスは Team および Enterprise プランでサポートされています。GitLab、Bitbucket、およびその他の非 GitHub リポジトリは[ローカルバンドル](#send-local-repositories-without-github)としてクラウドセッションに送信できますが、セッションはリモートに結果をプッシュバックできません891* **プラットフォーム制限**:リポジトリのクローンとプルリクエストの作成には GitHub が必要です。自己ホスト型の [GitHub Enterprise Server](/ja/github-enterprise-server) インスタンスは Team および Enterprise プランでサポートされています。GitLab、Bitbucket、およびその他の非 GitHub リポジトリは[ローカルバンドル](#send-local-repositories-without-github)としてクラウドセッションに送信できますが、セッションはリモートに結果をプッシュバックできません

890* **組織 IP 許可リスト**:クラウドセッションは Anthropic 管理インフラストラクチャから Anthropic API を呼び出すため、ネットワークからではありません。組織が [IP 許可リスト](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting)を有効にしている場合、すべてのクラウドセッションは認証エラーで失敗します。同じことが [Code Review](/ja/code-review) および [Routines](/ja/routines)に適用されます。[Anthropic サポート](https://support.claude.com/)に連絡して、Anthropic ホスト型サービスを組織の IP 許可リストから除外してください。892* **組織 IP 許可リスト**:クラウドセッションは Anthropic 管理インフラストラクチャから Anthropic API を呼び出すため、ネットワークからではありません。組織が [IP 許可リスト](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting)を有効にしている場合、すべてのクラウドセッションは認証エラーで失敗します。同じことが [Code Review](/ja/code-review) および [Routines](/ja/routines)に適用されます。[Anthropic サポート](https://support.claude.com/)に連絡して、Anthropic ホスト型サービスを組織の IP 許可リストから除外してください。

891 893 

892<h2 id="related-resources">894<h2 id="related-resources">

claude-directory.md +1429 −3

Details

6 6 

7> Claude Code が CLAUDE.md、settings.json、hooks、skills、commands、subagents、workflows、rules、auto memory を読み込む場所。プロジェクト内の .claude ディレクトリとホームディレクトリの ~/.claude を探索します。7> Claude Code が CLAUDE.md、settings.json、hooks、skills、commands、subagents、workflows、rules、auto memory を読み込む場所。プロジェクト内の .claude ディレクトリとホームディレクトリの ~/.claude を探索します。

8 8 

9export const ClaudeExplorer = () => {

10 const A = useMemo(() => ({href, children}) => <a href={href} style={{

11 color: 'var(--ce-accent)',

12 textDecoration: 'none',

13 borderBottom: '1px dotted var(--ce-accent)'

14 }}>{children}</a>, []);

15 const C = useMemo(() => ({children}) => <code style={{

16 fontFamily: 'var(--ce-mono)',

17 fontSize: '0.92em',

18 padding: '1px 4px',

19 borderRadius: '3px',

20 background: 'var(--ce-surface)',

21 border: '0.5px solid var(--ce-border-subtle)'

22 }}>{children}</code>, []);

23 const commandsNote = useMemo(() => <>Commands and skills are now the same mechanism. For new workflows, use <A href="/en/skills">skills/</A> instead: same <C>/name</C> invocation, plus you can bundle supporting files.</>, []);

24 const FILE_TREE = useMemo(() => ({

25 project: {

26 label: 'your-project/',

27 children: [{

28 id: 'claude-md',

29 label: 'CLAUDE.md',

30 type: 'file',

31 icon: 'md',

32 color: '#6A9BCC',

33 badge: 'committed',

34 oneLiner: 'Project instructions Claude reads every session',

35 when: 'Loaded into context at the start of every session',

36 description: 'Project-specific instructions that shape how Claude works in this repository. Put your conventions, common commands, and architectural context here so Claude operates with the same assumptions your team does.',

37 tips: ['Target under 200 lines. Longer files still load in full but may reduce adherence', <>CLAUDE.md loads into every session. If something only matters for specific tasks, move it to a <A href="/en/skills">skill</A> or a path-scoped <A href="/en/memory#organize-rules-with-claude/rules/">rule</A> so it loads only when needed</>, 'List the commands you run most, like build, test, and format, so Claude knows them without you spelling them out each time', <>Run <C>/memory</C> to open and edit CLAUDE.md from within a session</>, <>Also works at <C>.claude/CLAUDE.md</C> if you prefer to keep the project root clean</>],

38 exampleIntro: 'This example is for a TypeScript and React project. It lists the build and test commands, the framework conventions Claude should follow, and project-specific rules like export style and file layout.',

39 example: `# Project conventions

40 

41## Commands

42- Build: \`npm run build\`

43- Test: \`npm test\`

44- Lint: \`npm run lint\`

45 

46## Stack

47- TypeScript with strict mode

48- React 19, functional components only

49 

50## Rules

51- Named exports, never default exports

52- Tests live next to source: \`foo.ts\` -> \`foo.test.ts\`

53- All API routes return \`{ data, error }\` shape`,

54 docsLink: '/en/memory'

55 }, {

56 id: 'mcp-json',

57 label: '.mcp.json',

58 type: 'file',

59 icon: 'json',

60 color: '#9B7BC4',

61 badge: 'committed',

62 oneLiner: 'Project-scoped MCP servers, shared with your team',

63 when: <>Servers connect when the session begins. Tool schemas are deferred by default and load on demand via <A href="/en/mcp#scale-with-mcp-tool-search">tool search</A></>,

64 description: <>Configures Model Context Protocol (MCP) servers that give Claude access to external tools: databases, APIs, browsers, and more. This file holds the project-scoped servers your whole team uses. Personal servers you want to keep to yourself go in <C>~/.claude.json</C> instead.</>,

65 tips: [<>Use environment variable references for secrets: <C>{'${GITHUB_TOKEN}'}</C></>, <>Lives at the project root, not inside <C>.claude/</C></>, <>For servers only you need, run <C>claude mcp add --scope user</C>. This writes to <C>~/.claude.json</C> instead of <C>.mcp.json</C></>],

66 exampleIntro: <>This example configures the GitHub MCP server so Claude can read issues and open pull requests. The <C>{'${GITHUB_TOKEN}'}</C> reference is read from your shell environment when Claude Code starts the server, so the token never lands in the file.</>,

67 example: `{

68 "mcpServers": {

69 "github": {

70 "command": "npx",

71 "args": ["-y", "@modelcontextprotocol/server-github"],

72 "env": {

73 "GITHUB_TOKEN": "\${GITHUB_TOKEN}"

74 }

75 }

76 }

77}`,

78 docsLink: '/en/mcp'

79 }, {

80 id: 'worktreeinclude',

81 label: '.worktreeinclude',

82 type: 'file',

83 icon: 'md',

84 color: '#8FA876',

85 badge: 'committed',

86 oneLiner: 'Gitignored files to copy into new worktrees',

87 when: <>Read when Claude creates a git worktree via <C>--worktree</C>, the <C>EnterWorktree</C> tool, or subagent <C>isolation: worktree</C></>,

88 description: <>Lists gitignored files to copy from your main repository into each new worktree. Worktrees are fresh checkouts, so untracked files like <C>.env</C> are missing by default. Patterns here use <C>.gitignore</C> syntax. Only files that match a pattern and are also gitignored get copied, so tracked files are never duplicated.</>,

89 tips: [<>Lives at the project root, not inside <C>.claude/</C></>, <>Git-only: if you configure a <A href="/en/hooks#worktreecreate">WorktreeCreate hook</A> for a different VCS, this file is not read. Copy files inside your hook script instead</>, <>Also applies to parallel sessions in the <A href="/en/desktop#work-in-parallel-with-sessions">desktop app</A></>],

90 exampleIntro: 'This example copies your local environment files and a secrets config into every worktree Claude creates. Comments start with # and blank lines are ignored, same as .gitignore.',

91 example: `# Local environment

92.env

93.env.local

94 

95# API credentials

96config/secrets.json`,

97 docsLink: '/en/worktrees#copy-gitignored-files-into-worktrees'

98 }, {

99 id: 'dot-claude',

100 label: '.claude/',

101 type: 'folder',

102 icon: 'folder',

103 color: 'var(--ce-accent)',

104 oneLiner: 'Project-level configuration, rules, and extensions',

105 description: 'Everything Claude Code reads that is specific to this project. If you use git, commit most files here so your team shares them; a few, like settings.local.json, are automatically gitignored. Each file badge shows which.',

106 children: [{

107 id: 'settings-json',

108 label: 'settings.json',

109 type: 'file',

110 icon: 'json',

111 color: 'var(--ce-text-3)',

112 badge: 'committed',

113 oneLiner: 'Permissions, hooks, and configuration',

114 when: <>Overrides global <C>~/.claude/settings.json</C>. Local settings, CLI flags, and managed settings override this</>,

115 description: 'Settings that Claude Code applies directly. Permissions control which commands and tools Claude can use; hooks run your scripts at specific points in a session. Unlike CLAUDE.md, which Claude reads as guidance, these are enforced whether Claude follows them or not.',

116 contains: [<><A href="/en/permissions">permissions</A>: allow, deny, or prompt before Claude uses specific tools or commands</>, <><A href="/en/hooks">hooks</A>: run your own scripts on events like before a tool call or after a file edit</>, <><A href="/en/statusline">statusLine</A>: customize the line shown at the bottom while Claude works</>, <><A href="/en/settings#available-settings">model</A>: pick a default model for this project</>, <><A href="/en/settings#environment-variables">env</A>: environment variables set in every session</>, <><A href="/en/output-styles">outputStyle</A>: select a custom system-prompt style from output-styles/</>],

117 tips: [<>Bash permission patterns support wildcards: <C>Bash(npm test *)</C> matches any command starting with <C>npm test</C></>, <>Array settings like <C>permissions.allow</C> combine across all scopes; scalar settings like <C>model</C> use the most specific value</>],

118 exampleIntro: <>This example allows <C>npm test</C> and <C>npm run</C> commands without prompting, blocks <C>rm -rf</C>, and runs Prettier on files after Claude edits or writes them.</>,

119 example: `{

120 "permissions": {

121 "allow": [

122 "Bash(npm test *)",

123 "Bash(npm run *)"

124 ],

125 "deny": [

126 "Bash(rm -rf *)"

127 ]

128 },

129 "hooks": {

130 "PostToolUse": [{

131 "matcher": "Edit|Write",

132 "hooks": [{

133 "type": "command",

134 "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"

135 }]

136 }]

137 }

138}`,

139 docsLink: '/en/settings'

140 }, {

141 id: 'settings-local-json',

142 label: 'settings.local.json',

143 type: 'file',

144 icon: 'json',

145 color: 'var(--ce-text-3)',

146 badge: 'gitignored',

147 oneLiner: 'Your personal settings overrides for this project',

148 when: 'Highest of the user-editable settings files; CLI flags and managed settings still take precedence',

149 description: 'Personal settings that take precedence over the project defaults. Same JSON format as settings.json, but not committed. Use this when you need different permissions or defaults than the team config.',

150 tips: [<>Same schema as settings.json. Array settings like <C>permissions.allow</C> combine across scopes; scalar settings like <C>model</C> use the local value</>, <>Claude Code adds this file to <C>~/.config/git/ignore</C> the first time it writes one. If you use a custom <C>core.excludesFile</C>, add the pattern there too. To share the ignore rule with your team, also add it to the project <C>.gitignore</C></>],

151 exampleIntro: 'This example adds Docker permissions on top of whatever the team settings.json allows.',

152 example: `{

153 "permissions": {

154 "allow": [

155 "Bash(docker *)"

156 ]

157 }

158}`,

159 docsLink: '/en/settings'

160 }, {

161 id: 'rules',

162 label: 'rules/',

163 type: 'folder',

164 icon: 'folder',

165 color: '#9B7BC4',

166 oneLiner: 'Topic-scoped instructions, optionally gated by file paths',

167 when: <>Rules without <C>paths:</C> load at session start. Rules with <C>paths:</C> load when a matching file enters context</>,

168 description: [<>Project instructions split into topic files that can load conditionally based on file paths. A rule without <C>paths:</C> frontmatter loads at session start like CLAUDE.md; a rule with <C>paths:</C> loads only when Claude reads a matching file.</>, <>Like CLAUDE.md, rules are guidance Claude reads, not configuration Claude Code enforces. For guaranteed behavior use <A href="/en/hooks">hooks</A> or <A href="/en/permissions">permissions</A>.</>],

169 tips: [<>Use <C>paths:</C> frontmatter with globs to scope rules to directories or file types</>, <>Subdirectories work: <C>.claude/rules/frontend/react.md</C> is discovered automatically</>, 'When CLAUDE.md approaches 200 lines, start splitting into rules'],

170 docsLink: '/en/memory#organize-rules-with-claude/rules/',

171 children: [{

172 id: 'rule-testing',

173 label: 'testing.md',

174 type: 'file',

175 icon: 'md',

176 color: '#9B7BC4',

177 badge: 'committed',

178 oneLiner: 'Test conventions scoped to test files',

179 when: <>Loaded when Claude reads a file matching the <C>paths:</C> globs below</>,

180 description: <>An example rule that only loads when Claude is working on test files. The <C>paths:</C> globs in the frontmatter define which files trigger it; here, anything ending in .test.ts or .test.tsx. For other files, this rule is not loaded into context.</>,

181 example: `---

182paths:

183 - "**/*.test.ts"

184 - "**/*.test.tsx"

185---

186 

187# Testing Rules

188 

189- Use descriptive test names: "should [expected] when [condition]"

190- Mock external dependencies, not internal modules

191- Clean up side effects in afterEach`

192 }, {

193 id: 'rule-api',

194 label: 'api-design.md',

195 type: 'file',

196 icon: 'md',

197 color: '#9B7BC4',

198 badge: 'committed',

199 oneLiner: 'API conventions scoped to backend code',

200 when: <>Loaded when Claude reads a file matching the <C>paths:</C> glob below</>,

201 description: <>A second example showing a rule scoped to backend code. The <C>paths:</C> glob matches files under src/api/, so these conventions load only when Claude is editing API routes.</>,

202 example: `---

203paths:

204 - "src/api/**/*.ts"

205---

206 

207# API Design Rules

208 

209- All endpoints must validate input with Zod schemas

210- Return shape: { data: T } | { error: string }

211- Rate limit all public endpoints`

212 }]

213 }, {

214 id: 'skills',

215 label: 'skills/',

216 type: 'folder',

217 icon: 'folder',

218 color: '#D4A843',

219 oneLiner: 'Reusable prompts you or Claude invoke by name',

220 when: <>Invoked with <C>/skill-name</C> or when Claude matches the task to a skill</>,

221 description: <>Each skill is a folder with a SKILL.md file plus any supporting files it needs. By default, both you and Claude can invoke a skill. Use frontmatter to control that: <C>disable-model-invocation: true</C> for user-only workflows like <C>/deploy</C>, or <C>user-invocable: false</C> to hide from the <C>/</C> menu while Claude can still invoke it.</>,

222 tips: [<>Skills accept arguments: <C>/deploy staging</C> passes "staging" as <C>$ARGUMENTS</C>. Use <C>$0</C>, <C>$1</C>, and so on for positional access</>, <>The <C>description</C> frontmatter determines when Claude auto-invokes the skill</>, 'Bundle reference docs alongside SKILL.md. Claude knows the skill directory path and can read supporting files when you mention them'],

223 docsLink: '/en/skills',

224 children: [{

225 id: 'skill-review',

226 label: 'security-review/',

227 type: 'folder',

228 icon: 'folder',

229 color: '#D4A843',

230 oneLiner: 'A skill bundling SKILL.md with supporting files',

231 children: [{

232 id: 'skill-review-md',

233 label: 'SKILL.md',

234 type: 'file',

235 icon: 'md',

236 color: '#D4A843',

237 badge: 'committed',

238 oneLiner: 'Entrypoint: trigger, invocability, instructions',

239 when: <>User types <C>/security-review &lt;target&gt;</C>; Claude cannot auto-invoke this skill</>,

240 description: [<>This skill uses <C>disable-model-invocation: true</C> so only you can trigger it; Claude never invokes it on its own.</>, <>The <C>!`...`</C> line runs a shell command and injects its output into the prompt. <C>$ARGUMENTS</C> substitutes whatever you typed after the skill name. Claude sees the skill directory path, so mentioning a bundled file like checklist.md lets Claude read it.</>],

241 example: `---

242description: Reviews code changes for security vulnerabilities, authentication gaps, and injection risks

243disable-model-invocation: true

244argument-hint: <branch-or-path>

245---

246 

247## Diff to review

248 

249!\`git diff $ARGUMENTS\`

250 

251Audit the changes above for:

252 

2531. Injection vulnerabilities (SQL, XSS, command)

2542. Authentication and authorization gaps

2553. Hardcoded secrets or credentials

256 

257Use checklist.md in this skill directory for the full review checklist.

258 

259Report findings with severity ratings and remediation steps.`

260 }, {

261 id: 'skill-checklist',

262 label: 'checklist.md',

263 type: 'file',

264 icon: 'md',

265 color: '#D4A843',

266 badge: 'committed',

267 oneLiner: 'Supporting file bundled with the skill',

268 when: 'Claude reads it on demand while running the skill',

269 description: <>Skills can bundle any supporting files: reference docs, templates, scripts. The skill directory path is prepended to SKILL.md, so Claude can read bundled files by name. For scripts in bash injection commands, use the <C>{'${CLAUDE_SKILL_DIR}'}</C> placeholder.</>,

270 example: `# Security Review Checklist

271 

272## Input Validation

273- [ ] All user input sanitized before DB queries

274- [ ] File upload MIME types validated

275- [ ] Path traversal prevented on file operations

276 

277## Authentication

278- [ ] JWT tokens expire after 24 hours

279- [ ] API keys stored in environment variables

280- [ ] Passwords hashed with bcrypt or argon2`

281 }]

282 }]

283 }, {

284 id: 'commands',

285 label: 'commands/',

286 type: 'folder',

287 icon: 'folder',

288 color: '#788C5D',

289 oneLiner: <>Single-file prompts invoked with <C>/name</C></>,

290 note: commandsNote,

291 when: <>User types <C>/command-name</C></>,

292 description: <>A file at <C>commands/deploy.md</C> creates <C>/deploy</C> the same way a skill at <C>skills/deploy/SKILL.md</C> does, and both can be auto-invoked by Claude. Skills use a directory with SKILL.md, letting you bundle reference docs, templates, or scripts alongside the prompt.</>,

293 tips: [<>Use <C>$ARGUMENTS</C> in the file to accept parameters: <C>/fix-issue 123</C></>, 'If a skill and command share a name, the skill takes precedence', 'New commands should usually be skills instead; commands remain supported'],

294 docsLink: '/en/skills',

295 children: [{

296 id: 'cmd-example',

297 label: 'fix-issue.md',

298 type: 'file',

299 icon: 'md',

300 color: '#788C5D',

301 badge: 'committed',

302 oneLiner: <>Invoked as <C>/fix-issue &lt;number&gt;</C></>,

303 note: commandsNote,

304 description: [<>An example command for fixing a GitHub issue. Type <C>/fix-issue 123</C> and the <C>!`...`</C> line runs <C>gh issue view 123</C> in your shell, injecting the output into the prompt before Claude sees it.</>, <><C>$ARGUMENTS</C> substitutes whatever you typed after the command name. For positional access, use <C>$0</C> <C>$1</C> and so on.</>],

305 example: `---

306argument-hint: <issue-number>

307---

308 

309!\`gh issue view $ARGUMENTS\`

310 

311Investigate and fix the issue above.

312 

3131. Trace the bug to its root cause

3142. Implement the fix

3153. Write or update tests

3164. Summarize what you changed and why`

317 }]

318 }, {

319 id: 'output-styles',

320 label: 'output-styles/',

321 type: 'folder',

322 icon: 'folder',

323 color: '#5AA7A7',

324 oneLiner: 'Project-scoped output styles, if your team shares any',

325 when: 'Applied at session start when selected via the outputStyle setting',

326 description: <>Output styles are usually personal, so most live in <C>~/.claude/output-styles/</C>. Put one here if your team shares a style, like a review mode everyone uses. See <A href="#ce-global-output-styles">the Global tab</A> for the full explanation and example.</>,

327 docsLink: '/en/output-styles',

328 children: []

329 }, {

330 id: 'agents',

331 label: 'agents/',

332 type: 'folder',

333 icon: 'folder',

334 color: '#C46686',

335 oneLiner: 'Specialized subagents with their own context window',

336 when: 'Runs in its own context window when you or Claude invoke it',

337 description: 'Each markdown file defines a subagent with its own system prompt, tool access, and optionally its own model. Subagents run in a fresh context window, keeping the main conversation clean. Useful for parallel work or isolated tasks.',

338 tips: ['Each agent gets a fresh context window, separate from your main session', <>Restrict tool access per agent with the <C>tools:</C> frontmatter field</>, 'Type @ and pick an agent from the autocomplete to delegate directly'],

339 docsLink: '/en/sub-agents',

340 children: [{

341 id: 'agent-reviewer',

342 label: 'code-reviewer.md',

343 type: 'file',

344 icon: 'md',

345 color: '#C46686',

346 badge: 'committed',

347 oneLiner: 'Subagent for isolated code review',

348 when: 'Claude spawns it for review tasks, or you @-mention it from the autocomplete',

349 description: <>An example subagent restricted to read-only tools. The <C>description</C> frontmatter tells Claude when to delegate to it automatically; <C>tools:</C> limits it to Read, Grep, and Glob so it can inspect code but never edit. The body becomes the subagent's system prompt.</>,

350 example: `---

351name: code-reviewer

352description: Reviews code for correctness, security, and maintainability

353tools: Read, Grep, Glob

354---

355 

356You are a senior code reviewer. Review for:

357 

3581. Correctness: logic errors, edge cases, null handling

3592. Security: injection, auth bypass, data exposure

3603. Maintainability: naming, complexity, duplication

361 

362Every finding must include a concrete fix.`

363 }]

364 }, {

365 id: 'workflows',

366 label: 'workflows/',

367 type: 'folder',

368 icon: 'folder',

369 color: '#C46686',

370 oneLiner: 'Dynamic workflow scripts that orchestrate many subagents',

371 when: 'Loaded at startup; each file becomes a /<name> command',

372 description: <>Each <C>.js</C> file is a <A href="/en/workflows">dynamic workflow</A>: a script the runtime executes to spawn and coordinate many subagents. Workflows are written by Claude and saved here from <C>/workflows</C> rather than authored from scratch.</>,

373 tips: [<>Save a run from <C>/workflows</C> with <C>s</C> to create one of these</>, <>A project workflow takes precedence over a personal one in <C>~/.claude/workflows/</C> with the same name</>],

374 docsLink: '/en/workflows'

375 }, {

376 id: 'agent-memory',

377 label: 'agent-memory/',

378 type: 'folder',

379 icon: 'folder',

380 color: '#C46686',

381 badge: 'committed',

382 autogen: true,

383 oneLiner: 'Subagent persistent memory, separate from your main session auto memory',

384 when: 'First 200 lines (capped at 25KB) of MEMORY.md loaded into the subagent system prompt when it runs',

385 description: <>Subagents with <C>memory: project</C> in their frontmatter get a dedicated memory directory here. This is distinct from your <A href="/en/memory#auto-memory">main session auto memory</A> at <C>~/.claude/projects/</C>: each subagent reads and writes its own MEMORY.md, not yours.</>,

386 tips: [<>Only created for subagents that set the <C>memory:</C> frontmatter field</>, <>This directory holds project-scoped subagent memory, meant to be shared with your team. To keep memory out of version control use <C>memory: local</C>, which writes to <C>.claude/agent-memory-local/</C> instead. For cross-project memory use <C>memory: user</C>, which writes to <C>~/.claude/agent-memory/</C></>, <>The main session auto memory is a different feature; see <C>~/.claude/projects/</C> in the Global tab</>],

387 docsLink: '/en/sub-agents#enable-persistent-memory',

388 children: [{

389 id: 'agent-memory-sub',

390 label: '<agent-name>/',

391 type: 'folder',

392 icon: 'folder',

393 color: '#C46686',

394 autogen: true,

395 children: [{

396 id: 'agent-memory-md',

397 label: 'MEMORY.md',

398 type: 'file',

399 icon: 'md',

400 color: '#C46686',

401 badge: 'committed',

402 autogen: true,

403 oneLiner: 'The subagent writes and maintains this file automatically',

404 when: 'Loaded into the subagent system prompt when the subagent starts',

405 description: <>Works the same as your <A href="/en/memory#auto-memory">main auto memory</A>: the subagent creates and updates this file itself. You do not write it. The subagent reads it at the start of each task and writes back what it learns.</>,

406 example: `# code-reviewer memory

407 

408## Patterns seen

409- Project uses custom Result<T, E> type, not exceptions

410- Auth middleware expects Bearer token in Authorization header

411- Tests use factory functions in test/factories/

412 

413## Recurring issues

414- Missing null checks on API responses (src/api/*)

415- Unhandled promise rejections in background jobs`

416 }]

417 }]

418 }]

419 }]

420 },

421 global: {

422 label: '~/',

423 children: [{

424 id: 'claude-json',

425 label: '.claude.json',

426 type: 'file',

427 icon: 'json',

428 color: 'var(--ce-text-3)',

429 badge: 'local',

430 oneLiner: 'App state and UI preferences',

431 when: <>Read at session start for your preferences and MCP servers. Claude Code writes back to it when you change settings in <C>/config</C> or approve trust prompts</>,

432 description: <>Holds state that does not belong in settings.json: theme, OAuth session, per-project trust decisions, your personal MCP servers, and UI toggles. Mostly managed through <C>/config</C> rather than editing directly.</>,

433 tips: [<>IDE toggles like <C>autoConnectIde</C> and <C>externalEditorContext</C> live here, not in settings.json</>, <>The <C>projects</C> key tracks per-project state like trust-dialog acceptance and last-session metrics. Permission rules you approve in-session go to <C>.claude/settings.local.json</C> instead</>, <>MCP servers here are yours only: user scope applies across all projects, local scope is per-project but not committed. Team-shared servers go in <C>.mcp.json</C> at the project root instead</>],

434 example: `{

435 "autoConnectIde": true,

436 "externalEditorContext": true,

437 "mcpServers": {

438 "my-tools": {

439 "command": "npx",

440 "args": ["-y", "@example/mcp-server"]

441 }

442 }

443}`,

444 docsLink: '/en/settings#global-config-settings'

445 }, {

446 id: 'global-dot-claude',

447 label: '.claude/',

448 type: 'folder',

449 icon: 'folder',

450 color: 'var(--ce-accent)',

451 oneLiner: 'Your personal configuration across all projects',

452 description: 'The global counterpart to your project .claude/ directory. Files here apply to every project you work in and are never committed to any repository.',

453 children: [{

454 id: 'global-claude-md',

455 label: 'CLAUDE.md',

456 type: 'file',

457 icon: 'md',

458 color: '#6A9BCC',

459 badge: 'local',

460 oneLiner: 'Personal preferences across every project',

461 when: 'Loaded at the start of every session, in every project',

462 description: 'Your global instruction file. Loaded alongside the project CLAUDE.md at session start, so both are in context together. When instructions conflict, project-level instructions take priority. Keep this to preferences that apply everywhere: response style, commit format, personal conventions.',

463 tips: ['Keep it short since it loads into context for every project, alongside that project\'s own CLAUDE.md', 'Good for response style, commit format, and personal conventions'],

464 example: `# Global preferences

465 

466- Keep explanations concise

467- Use conventional commit format

468- Show the terminal command to verify changes

469- Prefer composition over inheritance`,

470 docsLink: '/en/memory'

471 }, {

472 id: 'global-settings',

473 label: 'settings.json',

474 type: 'file',

475 icon: 'json',

476 color: 'var(--ce-text-3)',

477 badge: 'local',

478 oneLiner: 'Default settings for all projects',

479 when: 'Your defaults. Project and local settings.json override any keys you also set there',

480 description: [<>Same keys as project <C>settings.json</C>: permissions, hooks, model, environment variables, and the rest. Put settings here that you want in every project, like permissions you always allow, a preferred model, or a notification hook that runs regardless of which project you're in.</>, <>Settings follow a precedence order: project <C>settings.json</C> overrides any matching keys you set here. This is different from CLAUDE.md, where global and project files are both loaded into context rather than merged key by key.</>],

481 example: `{

482 "permissions": {

483 "allow": [

484 "Bash(git log *)",

485 "Bash(git diff *)"

486 ]

487 }

488}`,

489 docsLink: '/en/settings'

490 }, {

491 id: 'keybindings',

492 label: 'keybindings.json',

493 type: 'file',

494 icon: 'json',

495 color: 'var(--ce-text-3)',

496 badge: 'local',

497 oneLiner: 'Custom keyboard shortcuts',

498 when: 'Read at session start and hot-reloaded when you edit the file',

499 description: <>Rebind keyboard shortcuts in the interactive CLI. Run <C>/keybindings</C> to create or open this file with a schema reference. Ctrl+C, Ctrl+D, Ctrl+M, and Caps Lock are reserved and cannot be rebound.</>,

500 exampleIntro: <>This example binds <C>Ctrl+E</C> to open your external editor and unbinds <C>Ctrl+U</C> by setting it to <C>null</C>. The <C>context</C> field scopes bindings to a specific part of the CLI, here the main chat input.</>,

501 example: `{

502 "$schema": "https://www.schemastore.org/claude-code-keybindings.json",

503 "$docs": "https://code.claude.com/docs/en/keybindings",

504 "bindings": [

505 {

506 "context": "Chat",

507 "bindings": {

508 "ctrl+e": "chat:externalEditor",

509 "ctrl+u": null

510 }

511 }

512 ]

513}`,

514 docsLink: '/en/keybindings'

515 }, {

516 id: 'themes',

517 label: 'themes/',

518 type: 'folder',

519 icon: 'folder',

520 color: '#5AA7A7',

521 oneLiner: 'Custom color themes',

522 when: <>Read at session start and hot-reloaded when files change. Listed in <C>/theme</C></>,

523 description: <>Each <C>.json</C> file defines a custom color theme: a built-in <C>base</C> preset plus an <C>overrides</C> map of color tokens. Create one interactively with <C>/theme</C> or write the JSON by hand. Selecting a custom theme stores <C>custom:&lt;slug&gt;</C> as your theme preference.</>,

524 example: `{

525 "name": "Dracula",

526 "base": "dark",

527 "overrides": {

528 "claude": "#bd93f9",

529 "error": "#ff5555",

530 "success": "#50fa7b"

531 }

532}`,

533 docsLink: '/en/terminal-config#create-a-custom-theme',

534 children: []

535 }, {

536 id: 'global-projects',

537 label: 'projects/',

538 type: 'folder',

539 icon: 'folder',

540 color: '#E8A45C',

541 autogen: true,

542 oneLiner: "Auto memory: Claude's notes to itself, per project",

543 when: 'MEMORY.md loaded at session start; topic files read on demand',

544 description: 'Auto memory lets Claude accumulate knowledge across sessions without you writing anything. Claude saves notes as it works: build commands, debugging insights, architecture notes. Each project gets its own memory directory keyed by the repository path.',

545 tips: [<>On by default. Toggle with <C>/memory</C> or <C>autoMemoryEnabled</C> in settings</>, 'MEMORY.md is the index loaded each session. The first 200 lines, or 25KB, whichever comes first, are read', 'Topic files like debugging.md are read on demand, not at startup', 'These are plain markdown. Edit or delete them anytime'],

546 docsLink: '/en/memory#auto-memory',

547 children: [{

548 id: 'memory-dir',

549 label: '<project>/memory/',

550 type: 'folder',

551 icon: 'folder',

552 color: '#E8A45C',

553 autogen: true,

554 oneLiner: "Claude's accumulated knowledge for one project",

555 children: [{

556 id: 'memory-md',

557 label: 'MEMORY.md',

558 type: 'file',

559 icon: 'md',

560 color: '#E8A45C',

561 badge: 'local',

562 autogen: true,

563 oneLiner: 'Claude writes and maintains this file automatically',

564 when: 'First 200 lines (capped at 25KB) loaded at session start',

565 description: 'Claude creates and updates this file as it works; you do not write it yourself. It acts as an index that Claude reads at the start of every session, pointing to topic files for detail. You can edit or delete it, but Claude will keep updating it.',

566 example: `# Memory Index

567 

568## Project

569- [build-and-test.md](build-and-test.md): npm run build (~45s), Vitest, dev server on 3001

570- [architecture.md](architecture.md): API client singleton, refresh-token auth

571 

572## Reference

573- [debugging.md](debugging.md): auth token rotation and DB connection troubleshooting`,

574 docsLink: '/en/memory'

575 }, {

576 id: 'memory-topic',

577 label: 'debugging.md',

578 type: 'file',

579 icon: 'md',

580 color: '#E8A45C',

581 badge: 'local',

582 autogen: true,

583 oneLiner: 'Topic notes Claude writes when MEMORY.md gets long',

584 when: 'Claude reads this when a related task comes up',

585 description: 'An example of a topic file Claude creates when MEMORY.md grows too long. Claude picks the filename based on what it splits out: debugging.md, architecture.md, build-commands.md, or similar. You never create these yourself. Claude reads a topic file back only when the current task relates to it.',

586 example: `---

587name: Debugging patterns

588description: Auth token rotation and database connection troubleshooting for this project

589type: reference

590---

591 

592## Auth Token Issues

593- Refresh token rotation: old token invalidated immediately

594- If 401 after refresh: check clock skew between client and server

595 

596## Database Connection Drops

597- Connection pool: max 10 in dev, 50 in prod

598- Always check \`docker compose ps\` first`

599 }]

600 }]

601 }, {

602 id: 'global-rules',

603 label: 'rules/',

604 type: 'folder',

605 icon: 'folder',

606 color: '#9B7BC4',

607 oneLiner: 'User-level rules that apply to every project',

608 when: <>Rules without <C>paths:</C> load at session start. Rules with <C>paths:</C> load when a matching file enters context</>,

609 description: 'Same as project .claude/rules/ but applies everywhere. Use this for conventions you want across all your work, like personal code style or commit message format.',

610 docsLink: '/en/memory#organize-rules-with-claude/rules/',

611 children: []

612 }, {

613 id: 'global-skills',

614 label: 'skills/',

615 type: 'folder',

616 icon: 'folder',

617 color: '#D4A843',

618 oneLiner: 'Personal skills available in every project',

619 when: <>Invoked with <C>/skill-name</C> in any project</>,

620 description: 'Skills you built for yourself that work everywhere. Same structure as project skills: each is a folder with SKILL.md, scoped to your user account instead of a single project.',

621 docsLink: '/en/skills',

622 children: []

623 }, {

624 id: 'global-commands',

625 label: 'commands/',

626 type: 'folder',

627 icon: 'folder',

628 color: '#788C5D',

629 oneLiner: 'Personal single-file commands available in every project',

630 note: commandsNote,

631 when: <>User types <C>/command-name</C> in any project</>,

632 description: 'Same as project commands/ but scoped to your user account. Each markdown file becomes a command available everywhere.',

633 docsLink: '/en/skills',

634 children: []

635 }, {

636 id: 'global-output-styles',

637 label: 'output-styles/',

638 type: 'folder',

639 icon: 'folder',

640 color: '#5AA7A7',

641 oneLiner: 'Custom system-prompt sections that adjust how Claude works',

642 when: 'Applied at session start when selected via the outputStyle setting',

643 description: [<>Each markdown file defines an output style: a section appended to the system prompt that, by default, also drops the built-in software-engineering task instructions. Use this to adapt Claude Code for uses beyond coding, or to add teaching or review modes.</>, <>Select a built-in or custom style with <C>/config</C> or the <C>outputStyle</C> key in settings. Styles here are available in every project; project-level styles with the same name take precedence.</>],

644 tips: ['Built-in styles Explanatory and Learning are included with Claude Code; custom styles go here', <>Set <C>keep-coding-instructions: true</C> in frontmatter to keep the default task instructions alongside your additions</>, 'Changes take effect on the next session since the system prompt is fixed at startup for caching'],

645 docsLink: '/en/output-styles',

646 children: [{

647 id: 'output-style-example',

648 label: 'teaching.md',

649 type: 'file',

650 icon: 'md',

651 color: '#5AA7A7',

652 badge: 'local',

653 oneLiner: 'Example style that adds explanations and leaves small changes for you',

654 when: <>Active when <C>outputStyle</C> in settings is set to <C>teaching</C></>,

655 description: <>This style appends instructions to the system prompt: Claude adds a "Why this approach" note after each task and leaves TODO(human) markers for changes under 10 lines instead of writing them itself. Select it by setting <C>outputStyle</C> to the filename without .md, or to the <C>name</C> field if you set one in frontmatter.</>,

656 example: `---

657description: Explains reasoning and asks you to implement small pieces

658keep-coding-instructions: true

659---

660 

661After completing each task, add a brief "Why this approach" note

662explaining the key design decision.

663 

664When a change is under 10 lines, ask the user to implement it

665themselves by leaving a TODO(human) marker instead of writing it.`

666 }]

667 }, {

668 id: 'global-agents',

669 label: 'agents/',

670 type: 'folder',

671 icon: 'folder',

672 color: '#C46686',

673 oneLiner: 'Personal subagents available in every project',

674 when: 'Claude delegates or you @-mention in any project',

675 description: 'Subagents defined here are available across all your projects. Same format as project agents.',

676 docsLink: '/en/sub-agents',

677 children: []

678 }, {

679 id: 'global-workflows',

680 label: 'workflows/',

681 type: 'folder',

682 icon: 'folder',

683 color: '#C46686',

684 oneLiner: 'Personal dynamic workflows available in every project',

685 when: 'Loaded at startup; each file becomes a /<name> command',

686 description: <>Workflow scripts saved here are available across all your projects. A project workflow with the same name in <C>.claude/workflows/</C> takes precedence.</>,

687 docsLink: '/en/workflows',

688 children: []

689 }, {

690 id: 'global-agent-memory',

691 label: 'agent-memory/',

692 type: 'folder',

693 icon: 'folder',

694 color: '#C46686',

695 autogen: true,

696 oneLiner: <>Persistent memory for subagents with <C>memory: user</C></>,

697 when: 'Loaded into the subagent system prompt when the subagent starts',

698 description: <>Subagents with <C>memory: user</C> in their frontmatter store knowledge here that persists across all projects. For project-scoped subagent memory, see <C>.claude/agent-memory/</C> instead.</>,

699 docsLink: '/en/sub-agents#enable-persistent-memory',

700 children: []

701 }]

702 }]

703 }

704 }), []);

705 const BADGE_STYLES = useMemo(() => ({

706 committed: {

707 bg: 'rgba(85,138,66,0.08)',

708 color: 'var(--ce-badge-committed)',

709 border: 'rgba(85,138,66,0.15)',

710 label: 'committed'

711 },

712 gitignored: {

713 bg: 'rgba(217,119,87,0.06)',

714 color: 'var(--ce-badge-gitignored)',

715 border: 'rgba(217,119,87,0.15)',

716 label: 'gitignored'

717 },

718 local: {

719 bg: 'rgba(115,114,108,0.06)',

720 color: 'var(--ce-badge-local)',

721 border: 'rgba(115,114,108,0.12)',

722 label: 'local only'

723 },

724 autogen: {

725 bg: 'rgba(232,164,92,0.1)',

726 color: 'var(--ce-badge-autogen)',

727 border: 'rgba(232,164,92,0.2)',

728 label: 'Claude writes'

729 }

730 }), []);

731 const allNodes = useMemo(() => {

732 const flatten = (nodes, acc, path, parentId) => {

733 for (const node of nodes) {

734 const nextPath = [...path, node.label];

735 acc[node.id] = {

736 ...node,

737 path: nextPath,

738 parentId

739 };

740 if (node.children) flatten(node.children, acc, nextPath, node.id);

741 }

742 return acc;

743 };

744 const project = flatten(FILE_TREE.project.children, {}, [FILE_TREE.project.label]);

745 const global = flatten(FILE_TREE.global.children, {}, [FILE_TREE.global.label]);

746 for (const id in project) project[id].root = 'project';

747 for (const id in global) global[id].root = 'global';

748 return {

749 ...project,

750 ...global

751 };

752 }, [FILE_TREE]);

753 const allFolderIds = useMemo(() => Object.keys(allNodes).filter(id => allNodes[id].type === 'folder'), [allNodes]);

754 const DEFAULT_EXPANDED = ['dot-claude', 'rules', 'skills', 'skill-review', 'commands', 'agents', 'agent-memory', 'agent-memory-sub', 'global-dot-claude', 'global-output-styles', 'global-projects', 'memory-dir'];

755 const [mounted, setMounted] = useState(false);

756 const [activeRoot, setActiveRoot] = useState('project');

757 const [selectedId, setSelectedId] = useState('claude-md');

758 const [expandedFolders, setExpandedFolders] = useState(() => new Set(DEFAULT_EXPANDED));

759 const [forceMobile, setForceMobile] = useState(false);

760 const [copiedId, setCopiedId] = useState(null);

761 const [isFullscreen, setIsFullscreen] = useState(false);

762 const copyTimeoutRef = useRef(null);

763 const rootRef = useRef(null);

764 useEffect(() => {

765 setMounted(true);

766 const applyHash = scroll => {

767 const hash = window.location.hash.slice(1);

768 if (!hash.startsWith('ce-')) return;

769 const id = hash.slice(3);

770 const node = allNodes[id];

771 if (!node) return;

772 setActiveRoot(node.root);

773 setSelectedId(id);

774 setExpandedFolders(new Set(allFolderIds));

775 if (scroll && rootRef.current) rootRef.current.scrollIntoView({

776 behavior: 'smooth',

777 block: 'start'

778 });

779 };

780 applyHash(false);

781 const onHashChange = () => applyHash(true);

782 const onFsChange = () => setIsFullscreen(!!document.fullscreenElement);

783 window.addEventListener('hashchange', onHashChange);

784 document.addEventListener('fullscreenchange', onFsChange);

785 return () => {

786 if (copyTimeoutRef.current) clearTimeout(copyTimeoutRef.current);

787 window.removeEventListener('hashchange', onHashChange);

788 document.removeEventListener('fullscreenchange', onFsChange);

789 };

790 }, []);

791 useEffect(() => {

792 if (!mounted || !rootRef.current) return;

793 const hash = window.location.hash.slice(1);

794 if (hash.startsWith('ce-') && allNodes[hash.slice(3)]) {

795 rootRef.current.scrollIntoView({

796 behavior: 'smooth',

797 block: 'start'

798 });

799 }

800 }, [mounted]);

801 if (!mounted) return null;

802 const selected = allNodes[selectedId];

803 const tree = FILE_TREE[activeRoot];

804 const isCopied = copiedId === selected.id;

805 const toggleFolder = id => {

806 const next = new Set(expandedFolders);

807 next.has(id) ? next.delete(id) : next.add(id);

808 setExpandedFolders(next);

809 };

810 const switchRoot = root => {

811 if (root === activeRoot) return;

812 setActiveRoot(root);

813 const firstId = FILE_TREE[root].children[0].id;

814 setSelectedId(firstId);

815 try {

816 history.replaceState(null, '', '#ce-' + firstId);

817 } catch (e) {}

818 };

819 const toggleFullscreen = () => {

820 if (!rootRef.current) return;

821 if (document.fullscreenElement) document.exitFullscreen(); else rootRef.current.requestFullscreen().catch(() => {});

822 };

823 const selectNode = n => {

824 setSelectedId(n.id);

825 if (n.type === 'folder' && !expandedFolders.has(n.id)) toggleFolder(n.id);

826 try {

827 history.replaceState(null, '', '#ce-' + n.id);

828 } catch (e) {}

829 };

830 const iconBtn = {

831 width: 28,

832 flexShrink: 0,

833 borderRadius: '6px',

834 border: 'none',

835 cursor: 'pointer',

836 background: 'transparent',

837 color: 'var(--ce-text-4)',

838 display: 'flex',

839 alignItems: 'center',

840 justifyContent: 'center'

841 };

842 const visibleFolderIds = allFolderIds.filter(id => allNodes[id].root === activeRoot);

843 const allExpanded = visibleFolderIds.every(id => expandedFolders.has(id));

844 const toggleAllFolders = () => {

845 const next = new Set(expandedFolders);

846 visibleFolderIds.forEach(id => allExpanded ? next.delete(id) : next.add(id));

847 setExpandedFolders(next);

848 };

849 const onTreeKeyDown = e => {

850 if (!['ArrowDown', 'ArrowUp', 'ArrowRight', 'ArrowLeft'].includes(e.key)) return;

851 const visible = [];

852 const walk = nodes => {

853 for (const n of nodes) {

854 visible.push(n.id);

855 if (n.children && expandedFolders.has(n.id)) walk(n.children);

856 }

857 };

858 walk(tree.children);

859 const i = visible.indexOf(selectedId);

860 if (i === -1) return;

861 e.preventDefault();

862 if (e.key === 'ArrowDown' && i < visible.length - 1) selectNode(allNodes[visible[i + 1]]); else if (e.key === 'ArrowUp' && i > 0) selectNode(allNodes[visible[i - 1]]); else if (e.key === 'ArrowRight' && selected.type === 'folder') {

863 if (!expandedFolders.has(selectedId)) toggleFolder(selectedId); else if (selected.children && selected.children.length) selectNode(allNodes[selected.children[0].id]);

864 } else if (e.key === 'ArrowLeft') {

865 if (selected.type === 'folder' && expandedFolders.has(selectedId)) toggleFolder(selectedId); else if (selected.parentId) selectNode(allNodes[selected.parentId]);

866 }

867 };

868 const copyExample = (id, text) => {

869 const done = () => {

870 setCopiedId(id);

871 if (copyTimeoutRef.current) clearTimeout(copyTimeoutRef.current);

872 copyTimeoutRef.current = setTimeout(() => setCopiedId(null), 2000);

873 };

874 const fallback = () => {

875 const ta = document.createElement('textarea');

876 ta.value = text;

877 ta.style.position = 'fixed';

878 ta.style.opacity = '0';

879 document.body.appendChild(ta);

880 ta.select();

881 try {

882 if (document.execCommand('copy')) done();

883 } catch (e) {}

884 document.body.removeChild(ta);

885 };

886 if (navigator.clipboard) {

887 navigator.clipboard.writeText(text).then(done, fallback);

888 } else {

889 fallback();

890 }

891 };

892 const renderIcon = (icon, color, size) => {

893 const sz = size || 14;

894 if (icon === 'folder') {

895 return <svg width={sz} height={sz} viewBox="0 0 14 14" fill="none">

896 <path d="M1.5 3.5a1 1 0 0 1 1-1h2.6l1 1.2h5.4a1 1 0 0 1 1 1v5.8a1 1 0 0 1-1 1h-9a1 1 0 0 1-1-1V3.5z" fill={color} fillOpacity="0.15" stroke={color} strokeWidth="1" />

897 </svg>;

898 }

899 if (icon === 'json') {

900 return <svg width={sz} height={sz} viewBox="0 0 14 14" fill="none">

901 <rect x="2" y="1.5" width="10" height="11" rx="1.5" fill={color} fillOpacity="0.15" stroke={color} strokeWidth="1" />

902 <text x="7" y="9" fontSize="6" fontFamily="monospace" fill={color} textAnchor="middle" fontWeight="700">{'{}'}</text>

903 </svg>;

904 }

905 return <svg width={sz} height={sz} viewBox="0 0 14 14" fill="none">

906 <rect x="2" y="1.5" width="10" height="11" rx="1.5" fill={color} fillOpacity="0.15" stroke={color} strokeWidth="1" />

907 <line x1="4.5" y1="5" x2="9.5" y2="5" stroke={color} strokeWidth="1" />

908 <line x1="4.5" y1="7" x2="9.5" y2="7" stroke={color} strokeWidth="1" />

909 <line x1="4.5" y1="9" x2="8" y2="9" stroke={color} strokeWidth="1" />

910 </svg>;

911 };

912 const renderNode = (node, depth) => {

913 const isFolder = node.type === 'folder';

914 const isExpanded = expandedFolders.has(node.id);

915 const isSelected = selectedId === node.id;

916 return <div key={node.id}>

917 <button role="treeitem" tabIndex={-1} onClick={() => selectNode(node)} aria-selected={isSelected} aria-expanded={isFolder ? isExpanded : undefined} style={{

918 display: 'flex',

919 alignItems: 'center',

920 gap: '5px',

921 width: '100%',

922 padding: `4px 8px 4px ${8 + depth * 16}px`,

923 background: isSelected ? 'var(--ce-accent-bg)' : 'transparent',

924 borderTop: 'none',

925 borderRight: 'none',

926 borderBottom: 'none',

927 borderLeft: isSelected ? '2px solid var(--ce-accent)' : '2px solid transparent',

928 outline: 'none',

929 cursor: 'pointer',

930 textAlign: 'left',

931 fontFamily: 'var(--ce-mono)',

932 fontSize: '13.5px',

933 color: isSelected ? 'var(--ce-accent)' : 'var(--ce-text-2)',

934 fontWeight: isSelected ? 550 : 400,

935 transition: 'all 0.1s'

936 }}>

937 {isFolder ? <span onClick={e => {

938 e.stopPropagation();

939 toggleFolder(node.id);

940 }} style={{

941 fontSize: '14px',

942 color: 'var(--ce-text-4)',

943 width: '20px',

944 height: '20px',

945 display: 'inline-flex',

946 alignItems: 'center',

947 justifyContent: 'center',

948 cursor: 'pointer',

949 borderRadius: '4px',

950 marginLeft: '-6px',

951 flexShrink: 0

952 }} onMouseEnter={e => {

953 e.currentTarget.style.background = 'var(--ce-arrow-hover)';

954 e.currentTarget.style.color = 'var(--ce-text-2)';

955 }} onMouseLeave={e => {

956 e.currentTarget.style.background = 'transparent';

957 e.currentTarget.style.color = 'var(--ce-text-4)';

958 }}>{isExpanded ? '▾' : '▸'}</span> : <span style={{

959 width: '14px',

960 flexShrink: 0

961 }} />}

962 {renderIcon(node.icon, node.color)}

963 <span style={{

964 flex: 1,

965 overflow: 'hidden',

966 textOverflow: 'ellipsis',

967 whiteSpace: 'nowrap'

968 }}>{node.label}</span>

969 {node.badge && BADGE_STYLES[node.badge] && <span title={BADGE_STYLES[node.badge].label} style={{

970 width: 6,

971 height: 6,

972 borderRadius: '50%',

973 background: BADGE_STYLES[node.badge].color,

974 flexShrink: 0,

975 opacity: 0.7

976 }} />}

977 </button>

978 {isFolder && isExpanded && node.children && <div role="group">{node.children.map(child => renderNode(child, depth + 1))}</div>}

979 </div>;

980 };

981 return <>

982 <style>{`

983 .ce-root {

984 --ce-mono: var(--font-mono, ui-monospace, monospace);

985 --ce-accent: #D97757;

986 --ce-accent-bg: rgba(217,119,87,0.06);

987 --ce-accent-border: rgba(217,119,87,0.12);

988 --ce-bg: #fff;

989 --ce-surface: #FAFAF7;

990 --ce-surface-hover: #F0EEE6;

991 --ce-border: #E8E6DC;

992 --ce-border-subtle: #F0EEE6;

993 --ce-text: #141413;

994 --ce-text-2: #5E5D59;

995 --ce-text-3: #73726C;

996 --ce-text-4: #9C9A92;

997 --ce-text-5: #B8B6AE;

998 --ce-sep: #D1CFC5;

999 --ce-code-header: #F5F4ED;

1000 --ce-code-bg: #1A1918;

1001 --ce-arrow-hover: rgba(0,0,0,0.08);

1002 --ce-badge-committed: #3d6b2e;

1003 --ce-badge-gitignored: #b85c3a;

1004 --ce-badge-local: #5e5d59;

1005 --ce-badge-autogen: #b07520;

1006 --ce-when-text: #4a7fb5;

1007 }

1008 .dark .ce-root {

1009 --ce-bg: #1a1918;

1010 --ce-surface: #232221;

1011 --ce-surface-hover: #2e2d2b;

1012 --ce-border: #3a3936;

1013 --ce-border-subtle: #2e2d2b;

1014 --ce-text: #e8e6dc;

1015 --ce-text-2: #c4c2b8;

1016 --ce-text-3: #9c9a92;

1017 --ce-text-4: #73726c;

1018 --ce-text-5: #5e5d59;

1019 --ce-sep: #4a4946;

1020 --ce-code-header: #2e2d2b;

1021 --ce-code-bg: #0d0d0c;

1022 --ce-arrow-hover: rgba(255,255,255,0.08);

1023 --ce-badge-committed: #6fa85c;

1024 --ce-badge-gitignored: #e08a60;

1025 --ce-badge-local: #9c9a92;

1026 --ce-badge-autogen: #e8a45c;

1027 --ce-when-text: #8bb4e0;

1028 }

1029 .ce-mobile-fallback { display: none; border: 1px solid rgba(0,0,0,0.1); background: rgba(0,0,0,0.03); }

1030 .dark .ce-mobile-fallback { border-color: rgba(255,255,255,0.15); background: rgba(255,255,255,0.04); }

1031 @media (max-width: 700px) {

1032 .ce-root:not(.ce-force) { display: none !important; }

1033 .ce-mobile-fallback { display: block; }

1034 }

1035 `}</style>

1036 {!forceMobile && <div className="ce-mobile-fallback" style={{

1037 padding: '14px 16px',

1038 borderRadius: '8px',

1039 fontSize: '14px'

1040 }}>

1041 The interactive explorer works best on a larger screen. See the <a href="#file-reference" style={{

1042 color: '#D97757'

1043 }}>file reference table</a> below, or <button onClick={() => setForceMobile(true)} style={{

1044 border: 'none',

1045 background: 'none',

1046 padding: 0,

1047 color: '#D97757',

1048 textDecoration: 'underline',

1049 cursor: 'pointer',

1050 font: 'inherit'

1051 }}>show the explorer anyway</button>.

1052 </div>}

1053 <div ref={rootRef} className={forceMobile ? 'ce-root ce-force' : 'ce-root'} style={{

1054 borderRadius: isFullscreen ? 0 : '12px',

1055 border: '1px solid var(--ce-border)',

1056 background: 'var(--ce-bg)',

1057 display: 'flex',

1058 alignItems: 'stretch',

1059 overflow: 'hidden',

1060 fontFamily: 'var(--font-sans, -apple-system, sans-serif)',

1061 ...isFullscreen && ({

1062 height: '100vh'

1063 })

1064 }}>

1065 {}

1066 <div style={{

1067 width: 'min(240px, 35%)',

1068 minWidth: '180px',

1069 flexShrink: 0,

1070 borderRight: '1px solid var(--ce-border-subtle)',

1071 background: 'var(--ce-surface)',

1072 display: 'flex',

1073 flexDirection: 'column'

1074 }}>

1075 <div style={{

1076 padding: '8px 8px 4px',

1077 borderBottom: '1px solid var(--ce-border-subtle)',

1078 display: 'flex',

1079 gap: '4px'

1080 }}>

1081 {['project', 'global'].map(root => <button key={root} onClick={() => switchRoot(root)} style={{

1082 flex: 1,

1083 padding: '6px 0',

1084 borderRadius: '6px',

1085 border: 'none',

1086 cursor: 'pointer',

1087 fontFamily: 'var(--ce-mono)',

1088 fontSize: '11.5px',

1089 background: activeRoot === root ? 'var(--ce-accent-bg)' : 'transparent',

1090 color: activeRoot === root ? 'var(--ce-accent)' : 'var(--ce-text-4)',

1091 fontWeight: activeRoot === root ? 600 : 430

1092 }}>

1093 {root === 'project' ? 'Project' : 'Global (~/)'}

1094 </button>)}

1095 <button onClick={toggleAllFolders} title={allExpanded ? 'Collapse all' : 'Expand all'} style={{

1096 ...iconBtn,

1097 fontSize: 11

1098 }}>

1099 {allExpanded ? '⊟' : '⊞'}

1100 </button>

1101 <button onClick={toggleFullscreen} title={isFullscreen ? 'Exit fullscreen' : 'Fullscreen'} style={{

1102 ...iconBtn,

1103 fontSize: 13

1104 }}>

1105 {isFullscreen ? '⤡' : '⛶'}

1106 </button>

1107 </div>

1108 <div role="tree" aria-label="Configuration files" tabIndex={0} onKeyDown={onTreeKeyDown} style={{

1109 padding: '6px 0',

1110 overflowY: 'auto',

1111 flex: 1,

1112 outline: 'none'

1113 }}>

1114 {tree.children.map(node => renderNode(node, 0))}

1115 </div>

1116 </div>

1117 

1118 {}

1119 <div style={{

1120 flex: 1,

1121 minWidth: 0,

1122 padding: '20px 24px',

1123 minHeight: '400px',

1124 overflowY: 'auto'

1125 }}>

1126 <span aria-live="polite" style={{

1127 position: 'absolute',

1128 width: 1,

1129 height: 1,

1130 overflow: 'hidden',

1131 clip: 'rect(0 0 0 0)'

1132 }}>{selected.label} selected</span>

1133 {}

1134 <div style={{

1135 fontFamily: 'var(--ce-mono)',

1136 fontSize: '11px',

1137 color: 'var(--ce-text-4)',

1138 marginBottom: '10px',

1139 cursor: 'default'

1140 }}>

1141 {selected.path.map((seg, i) => <span key={i}>

1142 <span style={{

1143 color: i === selected.path.length - 1 ? 'var(--ce-accent)' : 'var(--ce-text-4)'

1144 }}>{seg.replace(/\/$/, '')}</span>

1145 {i < selected.path.length - 1 && <span style={{

1146 color: 'var(--ce-sep)'

1147 }}> / </span>}

1148 </span>)}

1149 </div>

1150 

1151 {}

1152 <div style={{

1153 display: 'flex',

1154 alignItems: 'flex-start',

1155 gap: '10px',

1156 marginBottom: '10px'

1157 }}>

1158 <span style={{

1159 flexShrink: 0,

1160 display: 'flex'

1161 }}>{renderIcon(selected.icon, selected.color, 24)}</span>

1162 <div style={{

1163 flex: 1,

1164 minWidth: 0

1165 }}>

1166 <div style={{

1167 fontSize: '22px',

1168 fontWeight: 600,

1169 color: 'var(--ce-text)',

1170 letterSpacing: '-0.3px',

1171 lineHeight: '26px'

1172 }}>{selected.label}</div>

1173 {selected.oneLiner && <div style={{

1174 fontSize: '15px',

1175 color: 'var(--ce-text-3)',

1176 marginTop: '3px'

1177 }}>{selected.oneLiner}</div>}

1178 </div>

1179 <div style={{

1180 display: 'flex',

1181 gap: '4px',

1182 flexShrink: 0

1183 }}>

1184 {[selected.autogen && 'autogen', selected.badge].filter(Boolean).map(k => {

1185 const s = BADGE_STYLES[k];

1186 if (!s) return null;

1187 return <span key={k} style={{

1188 fontFamily: 'var(--ce-mono)',

1189 fontSize: '10px',

1190 fontWeight: 600,

1191 textTransform: 'uppercase',

1192 letterSpacing: '0.3px',

1193 padding: '2px 6px',

1194 borderRadius: '4px',

1195 background: s.bg,

1196 color: s.color,

1197 border: `0.5px solid ${s.border}`

1198 }}>{s.label}</span>;

1199 })}

1200 </div>

1201 </div>

1202 

1203 {}

1204 {selected.note && <div style={{

1205 padding: '10px 12px',

1206 borderRadius: '8px',

1207 marginBottom: '14px',

1208 background: 'rgba(217,119,87,0.06)',

1209 border: '1px solid rgba(217,119,87,0.2)',

1210 borderLeft: '3px solid var(--ce-accent)',

1211 fontSize: '15px',

1212 color: 'var(--ce-text-2)',

1213 lineHeight: 1.6

1214 }}>

1215 {selected.note}

1216 </div>}

1217 

1218 {}

1219 {selected.when && <div style={{

1220 padding: '8px 12px',

1221 borderRadius: '6px',

1222 background: 'rgba(106,155,204,0.06)',

1223 border: '0.5px solid rgba(106,155,204,0.12)',

1224 fontSize: '15px',

1225 color: 'var(--ce-when-text)',

1226 marginBottom: '16px'

1227 }}>

1228 <div style={{

1229 fontSize: '10px',

1230 fontWeight: 700,

1231 textTransform: 'uppercase',

1232 letterSpacing: '0.4px',

1233 opacity: 0.65,

1234 marginBottom: '3px'

1235 }}>When it loads</div>

1236 <div style={{

1237 fontWeight: 500

1238 }}>{selected.when}</div>

1239 </div>}

1240 

1241 {}

1242 {selected.description && <div style={{

1243 fontSize: '16px',

1244 color: 'var(--ce-text-2)',

1245 lineHeight: 1.65,

1246 marginBottom: '16px'

1247 }}>

1248 {Array.isArray(selected.description) ? selected.description.map((para, i) => <div key={i} style={{

1249 marginBottom: i < selected.description.length - 1 ? '12px' : 0

1250 }}>{para}</div>) : selected.description}

1251 </div>}

1252 

1253 {}

1254 {selected.contains && selected.contains.length > 0 && <div style={{

1255 marginBottom: '16px'

1256 }}>

1257 <div style={{

1258 fontSize: '11px',

1259 fontWeight: 700,

1260 color: 'var(--ce-text-4)',

1261 textTransform: 'uppercase',

1262 letterSpacing: '0.4px',

1263 marginBottom: '8px'

1264 }}>Common keys</div>

1265 {selected.contains.map((item, i) => <div key={i} style={{

1266 display: 'flex',

1267 gap: '7px',

1268 fontSize: '15px',

1269 color: 'var(--ce-text-2)',

1270 lineHeight: 1.5,

1271 marginBottom: '5px'

1272 }}>

1273 <span style={{

1274 fontSize: '7px',

1275 color: 'var(--ce-text-4)',

1276 marginTop: '6px'

1277 }}>●</span>

1278 <span>{item}</span>

1279 </div>)}

1280 </div>}

1281 

1282 {}

1283 {selected.tips && selected.tips.length > 0 && <div style={{

1284 padding: '12px 14px',

1285 borderRadius: '8px',

1286 background: 'var(--ce-surface)',

1287 border: '1px solid var(--ce-border-subtle)',

1288 marginBottom: '16px'

1289 }}>

1290 <div style={{

1291 fontSize: '11px',

1292 fontWeight: 700,

1293 color: 'var(--ce-accent)',

1294 textTransform: 'uppercase',

1295 letterSpacing: '0.4px',

1296 marginBottom: '6px'

1297 }}>Tips</div>

1298 {selected.tips.map((tip, i) => <div key={i} style={{

1299 display: 'flex',

1300 gap: '7px',

1301 fontSize: '14.5px',

1302 color: 'var(--ce-text-2)',

1303 marginBottom: i < selected.tips.length - 1 ? '5px' : 0

1304 }}>

1305 <span style={{

1306 fontSize: '7px',

1307 color: 'var(--ce-accent)',

1308 marginTop: '6px'

1309 }}>●</span>

1310 <span>{tip}</span>

1311 </div>)}

1312 </div>}

1313 

1314 {}

1315 {selected.example && <div style={{

1316 marginBottom: '16px'

1317 }}>

1318 {selected.exampleIntro && <div style={{

1319 fontSize: '15px',

1320 color: 'var(--ce-text-2)',

1321 lineHeight: 1.6,

1322 marginBottom: '10px'

1323 }}>

1324 {selected.exampleIntro}

1325 </div>}

1326 <div style={{

1327 display: 'flex',

1328 justifyContent: 'space-between',

1329 alignItems: 'center',

1330 padding: '6px 10px',

1331 background: 'var(--ce-code-header)',

1332 border: '1px solid var(--ce-border)',

1333 borderRadius: '8px 8px 0 0'

1334 }}>

1335 <span style={{

1336 fontFamily: 'var(--ce-mono)',

1337 fontSize: '11px',

1338 fontWeight: 600,

1339 color: 'var(--ce-text-3)'

1340 }}>{selected.label}</span>

1341 <button onClick={() => copyExample(selected.id, selected.example)} style={{

1342 padding: '3px 8px',

1343 borderRadius: '4px',

1344 fontSize: '11px',

1345 fontWeight: 600,

1346 cursor: 'pointer',

1347 transition: 'all 0.15s',

1348 background: isCopied ? 'rgba(85,138,66,0.08)' : 'var(--ce-code-header)',

1349 border: isCopied ? '0.5px solid rgba(85,138,66,0.2)' : '0.5px solid var(--ce-border)',

1350 color: isCopied ? '#558A42' : 'var(--ce-text-3)'

1351 }}>

1352 {isCopied ? '✓ Copied' : 'Copy'}

1353 </button>

1354 </div>

1355 <pre style={{

1356 margin: 0,

1357 padding: '12px 14px',

1358 background: 'var(--ce-code-bg)',

1359 color: '#E8E6DC',

1360 fontFamily: 'var(--ce-mono)',

1361 fontSize: '13px',

1362 lineHeight: 1.65,

1363 borderRadius: '0 0 8px 8px',

1364 overflowX: 'auto',

1365 whiteSpace: 'pre'

1366 }}>{selected.example}</pre>

1367 </div>}

1368 

1369 {}

1370 {selected.docsLink && <a href={selected.docsLink} style={{

1371 display: 'inline-flex',

1372 padding: '5px 12px',

1373 borderRadius: '6px',

1374 background: 'var(--ce-accent-bg)',

1375 border: '1px solid var(--ce-accent-border)',

1376 color: 'var(--ce-accent)',

1377 fontSize: '12px',

1378 fontWeight: 600,

1379 textDecoration: 'none'

1380 }}>Full docs →</a>}

1381 

1382 {}

1383 {selected.children && selected.children.length > 0 && <div style={{

1384 marginTop: '20px'

1385 }}>

1386 <div style={{

1387 fontSize: '11px',

1388 fontWeight: 700,

1389 color: 'var(--ce-text-4)',

1390 textTransform: 'uppercase',

1391 letterSpacing: '0.4px',

1392 marginBottom: '8px'

1393 }}>Contents</div>

1394 <div style={{

1395 display: 'flex',

1396 flexDirection: 'column',

1397 gap: '4px'

1398 }}>

1399 {selected.children.map(child => <button key={child.id} onClick={() => selectNode(child)} style={{

1400 display: 'flex',

1401 alignItems: 'center',

1402 gap: '8px',

1403 padding: '6px 8px',

1404 width: '100%',

1405 background: 'var(--ce-surface)',

1406 borderRadius: '6px',

1407 border: 'none',

1408 cursor: 'pointer',

1409 textAlign: 'left',

1410 transition: 'background 0.1s'

1411 }} onMouseEnter={e => e.currentTarget.style.background = 'var(--ce-surface-hover)'} onMouseLeave={e => e.currentTarget.style.background = 'var(--ce-surface)'}>

1412 {renderIcon(child.icon, child.color, 13)}

1413 <span style={{

1414 fontFamily: 'var(--ce-mono)',

1415 fontSize: '12px',

1416 color: 'var(--ce-text-2)'

1417 }}>{child.label}</span>

1418 {child.oneLiner && <span style={{

1419 fontSize: '11px',

1420 color: 'var(--ce-text-4)',

1421 overflow: 'hidden',

1422 textOverflow: 'ellipsis',

1423 whiteSpace: 'nowrap'

1424 }}>{child.oneLiner}</span>}

1425 </button>)}

1426 </div>

1427 </div>}

1428 </div>

1429 </div>

1430 </>;

1431};

1432 

9Claude Code は、プロジェクトディレクトリとホームディレクトリの `~/.claude` から、指示、設定、skills、subagents、メモリを読み込みます。プロジェクトファイルを git にコミットしてチームと共有します。`~/.claude` 内のファイルは、すべてのプロジェクトに適用される個人設定です。1433Claude Code は、プロジェクトディレクトリとホームディレクトリの `~/.claude` から、指示、設定、skills、subagents、メモリを読み込みます。プロジェクトファイルを git にコミットしてチームと共有します。`~/.claude` 内のファイルは、すべてのプロジェクトに適用される個人設定です。

10 1434 

11Windows では、`~/.claude` は `%USERPROFILE%\.claude` に解決されます。[`CLAUDE_CONFIG_DIR`](/ja/env-vars) を設定した場合、このページのすべての `~/.claude` パスはそのディレクトリの下に存在します。1435Windows では、`~/.claude` は `%USERPROFILE%\.claude` に解決されます。[`CLAUDE_CONFIG_DIR`](/ja/env-vars) を設定した場合、このページのすべての `~/.claude` パスはそのディレクトリの下に存在します。


18 1442 

19ツリー内のファイルをクリックして、各ファイルの機能、読み込みタイミング、および例を確認してください。1443ツリー内のファイルをクリックして、各ファイルの機能、読み込みタイミング、および例を確認してください。

20 1444 

21<h2 id="what-s-not-shown">1445<ClaudeExplorer />

1446 

1447<h2 id="what’s-not-shown">

22 表示されていないもの1448 表示されていないもの

23</h2>1449</h2>

24 1450 

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

26 1452 

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

28| ----------------------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1454| ----------------------- | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

29| `managed-settings.json` | システムレベル、OS によって異なる | オーバーライドできないエンタープライズが強制する設定。[サーバー管理設定](/ja/server-managed-settings)を参照してください。 |1455| `managed-settings.json` | システムレベル、OS によって異なる | オーバーライドできないエンタープライズが強制する設定。[サーバー管理設定](/ja/server-managed-settings)を参照してください。 |

30| `CLAUDE.local.md` | プロジェクトルート | このプロジェクトの個人的な設定。CLAUDE.md と一緒に読み込まれます。手動で作成し、`.gitignore` に追加してください。 |1456| `CLAUDE.local.md` | プロジェクトルート | このプロジェクトの個人的な設定。CLAUDE.md と一緒に読み込まれます。手動で作成し、`.gitignore` に追加してください。 |

31| インストール済みプラグイン | `~/.claude/plugins/` | クローンされたマーケットプレイス、インストール済みプラグインバージョン、およびプラグインごとのデータ。`claude plugin` コマンドで管理されます。孤立したバージョンはプラグインの更新またはアンインストール後 7 日で削除されます。[プラグインキャッシング](/ja/plugins-reference#plugin-caching-and-file-resolution)を参照してください。 |1457| インストール済みプラグイン | `~/.claude/plugins` | クローンされたマーケットプレイス、インストール済みプラグインバージョン、およびプラグインごとのデータ。`claude plugin` コマンドで管理されます。孤立したバージョンはプラグインの更新またはアンインストール後 7 日で削除されます。[プラグインキャッシング](/ja/plugins-reference#plugin-caching-and-file-resolution)を参照してください。 |

32 1458 

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

34 1460 

Details

6 6 

7> AWS 認証、IAM アクセス制御、AWS Marketplace 請求を使用して、Anthropic が運営する Claude API を使用するように Claude Code を設定します。7> AWS 認証、IAM アクセス制御、AWS Marketplace 請求を使用して、Anthropic が運営する Claude API を使用するように Claude Code を設定します。

8 8 

9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;

11 const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">

12 <line x1="5" y1="12" x2="19" y2="12" />

13 <polyline points="12 5 19 12 12 19" />

14 </svg>;

15 const STYLES = `

16.cc-cs {

17 --cs-slate: #141413;

18 --cs-clay: #d97757;

19 --cs-clay-deep: #c6613f;

20 --cs-gray-000: #ffffff;

21 --cs-gray-700: #3d3d3a;

22 --cs-border-default: rgba(31, 30, 29, 0.15);

23 font-family: inherit;

24}

25.dark .cc-cs {

26 --cs-slate: #f0eee6;

27 --cs-gray-000: #262624;

28 --cs-gray-700: #bfbdb4;

29 --cs-border-default: rgba(240, 238, 230, 0.14);

30}

31.cc-cs-card {

32 display: flex; align-items: center; justify-content: space-between;

33 gap: 16px; padding: 14px 16px; margin: 0;

34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);

35 border-radius: 8px; flex-wrap: wrap;

36}

37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }

38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }

39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }

40.cc-cs-btn-clay {

41 display: inline-flex; align-items: center; gap: 8px;

42 background: var(--cs-clay-deep); color: #fff; border: none;

43 border-radius: 8px; padding: 8px 14px;

44 font-size: 13px; font-weight: 500;

45 transition: background-color 0.15s; white-space: nowrap;

46}

47.cc-cs-btn-clay:hover { background: var(--cs-clay); }

48.cc-cs-btn-ghost {

49 display: inline-flex; align-items: center; gap: 8px;

50 background: transparent; color: var(--cs-gray-700);

51 border: 0.5px solid var(--cs-border-default);

52 border-radius: 8px; padding: 8px 14px;

53 font-size: 13px; font-weight: 500;

54}

55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }

56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }

57@media (max-width: 720px) {

58 .cc-cs-actions { width: 100%; }

59}

60`;

61 return <div className="cc-cs not-prose">

62 <style>{STYLES}</style>

63 <div className="cc-cs-card">

64 <div className="cc-cs-text">

65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.

66 </div>

67 <div className="cc-cs-actions">

68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">

69 View plans

70 </a>

71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">

72 Contact sales {iconArrowRight()}

73 </a>

74 </div>

75 </div>

76 </div>;

77};

78 

79export const Experiment = ({flag, treatment, children}) => {

80 const VID_KEY = 'exp_vid';

81 const CONSENT_COUNTRIES = new Set(['AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HU', 'IE', 'IT', 'LV', 'LT', 'LU', 'MT', 'NL', 'PL', 'PT', 'RO', 'SK', 'SI', 'ES', 'SE', 'RE', 'GP', 'MQ', 'GF', 'YT', 'BL', 'MF', 'PM', 'WF', 'PF', 'NC', 'AW', 'CW', 'SX', 'FO', 'GL', 'AX', 'GB', 'UK', 'AI', 'BM', 'IO', 'VG', 'KY', 'FK', 'GI', 'MS', 'PN', 'SH', 'TC', 'GG', 'JE', 'IM', 'CA', 'BR', 'IN']);

82 const fnv1a = s => {

83 let h = 0x811c9dc5;

84 for (let i = 0; i < s.length; i++) {

85 h ^= s.charCodeAt(i);

86 h += (h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24);

87 }

88 return h >>> 0;

89 };

90 const bucket = (seed, vid) => fnv1a(fnv1a(seed + vid) + '') % 10000 < 5000 ? 'control' : 'treatment';

91 const [decision] = useState(() => {

92 const params = new URLSearchParams(location.search);

93 const preBucketed = document.documentElement.dataset['gb_' + flag.replace(/-/g, '_')];

94 const force = params.get('gb-force');

95 if (force) {

96 for (const p of force.split(',')) {

97 const [k, v] = p.split(':');

98 if (k === flag) return {

99 variant: v || 'treatment',

100 track: false

101 };

102 }

103 }

104 if (navigator.globalPrivacyControl) {

105 return {

106 variant: 'control',

107 track: false

108 };

109 }

110 const prefsMatch = document.cookie.match(/(?:^|; )anthropic-consent-preferences=([^;]+)/);

111 if (prefsMatch) {

112 try {

113 if (JSON.parse(decodeURIComponent(prefsMatch[1])).analytics !== true) {

114 return {

115 variant: 'control',

116 track: false

117 };

118 }

119 } catch {

120 return {

121 variant: 'control',

122 track: false

123 };

124 }

125 } else {

126 const country = params.get('country')?.toUpperCase() || (document.cookie.match(/(?:^|; )cf_geo=([A-Z]{2})/) || [])[1];

127 if (!country || CONSENT_COUNTRIES.has(country)) {

128 return {

129 variant: 'control',

130 track: false

131 };

132 }

133 }

134 let vid;

135 try {

136 const ajsMatch = document.cookie.match(/(?:^|; )ajs_anonymous_id=([^;]+)/);

137 if (ajsMatch) {

138 vid = decodeURIComponent(ajsMatch[1]).replace(/^"|"$/g, '');

139 } else {

140 vid = localStorage.getItem(VID_KEY);

141 if (!vid) {

142 vid = crypto.randomUUID();

143 }

144 document.cookie = `ajs_anonymous_id=${vid}; domain=.claude.com; path=/; Secure; SameSite=Lax; max-age=31536000`;

145 }

146 try {

147 localStorage.setItem(VID_KEY, vid);

148 } catch {}

149 } catch {

150 return {

151 variant: 'control',

152 track: false

153 };

154 }

155 const variant = preBucketed === '1' ? 'treatment' : preBucketed === '0' ? 'control' : bucket(flag, vid);

156 return {

157 variant,

158 track: true,

159 vid

160 };

161 });

162 useEffect(() => {

163 if (!decision.track) return;

164 fetch('https://api.anthropic.com/api/event_logging/v2/batch', {

165 method: 'POST',

166 headers: {

167 'Content-Type': 'application/json',

168 'x-service-name': 'claude_code_docs'

169 },

170 body: JSON.stringify({

171 events: [{

172 event_type: 'GrowthbookExperimentEvent',

173 event_data: {

174 device_id: decision.vid,

175 anonymous_id: decision.vid,

176 timestamp: new Date().toISOString(),

177 experiment_id: flag,

178 variation_id: decision.variant === 'treatment' ? 1 : 0,

179 environment: 'production'

180 }

181 }]

182 }),

183 keepalive: true

184 }).catch(() => {});

185 }, []);

186 return decision.variant === 'treatment' ? treatment : children;

187};

188 

189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />

190 

9AWS 上の Claude Platform は、AWS 認証、IAM アクセス制御、AWS Marketplace 請求を備えた Anthropic が運営する Claude API です。リクエストは Anthropic の API に直接到達するため、[Claude API](https://platform.claude.com/docs) と同じモデルと機能を同じリリーススケジュールで取得できます。AWS 認証情報またはワークスペース API キーで認証し、AWS Marketplace を通じて支払います。191AWS 上の Claude Platform は、AWS 認証、IAM アクセス制御、AWS Marketplace 請求を備えた Anthropic が運営する Claude API です。リクエストは Anthropic の API に直接到達するため、[Claude API](https://platform.claude.com/docs) と同じモデルと機能を同じリリーススケジュールで取得できます。AWS 認証情報またはワークスペース API キーで認証し、AWS Marketplace を通じて支払います。

10 192 

11このガイドを使用して、AWS 上の Claude Platform を通じてすでにプロビジョニングしたワークスペースに Claude Code をポイントします。このガイドの前に行う AWS サブスクリプションとワークスペースのセットアップについては、[AWS 上の Claude Platform ドキュメント](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)を参照してください。193このガイドを使用して、AWS 上の Claude Platform を通じてすでにプロビジョニングしたワークスペースに Claude Code をポイントします。このガイドの前に行う AWS サブスクリプションとワークスペースのセットアップについては、[AWS 上の Claude Platform ドキュメント](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)を参照してください。


92 3. モデルバージョンをピン留めする274 3. モデルバージョンをピン留めする

93</h3>275</h3>

94 276 

95AWS 上の Claude Platform は、直接 Claude API と同じモデル ID を使用します。デフォルトのエイリアス `opus`、`sonnet`、`haiku` は、ワークスペースで利用可能な最新バージョンに解決されます277AWS 上の Claude Platform は、直接 Claude API と同じモデル ID を使用します。デフォルトのエイリアス `fable`、`opus`、`sonnet`、`haiku` は Claude Code の AWS 上の Claude Platform 用の組み込みデフォルトに解決されます。これは最新リリースより遅れる可能性があります。`ANTHROPIC_DEFAULT_OPUS_MODEL` がない場合`opus` エイリアスは Opus 4.7 に解決されます

96 278 

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

98 280 

99```bash theme={null}281```bash theme={null}

282export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5

100export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7283export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7

101export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6284export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6

102export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5285export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5


157 すべてのリクエストで `403 Forbidden` または `AccessDenied`340 すべてのリクエストで `403 Forbidden` または `AccessDenied`

158</h3>341</h3>

159 342 

160Claude Code が解決した IAM プリンシパルは、ワークスペースで Anthropic サービスを呼び出す権限がない可能性があります。AWS プロファイルに接続されたロール、または Claude Code を開始したランナーを確認し、[IAM アクション参照](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions)に記載されている `aws-external-anthropic` アクションがあることを確認します。343Claude Code が解決した IAM プリンシパルは、ワークスペースで Anthropic サービスを呼び出す権限がない可能性があります。AWS プロファイルに接続されたロール、または Claude Code を開始したランナーを確認し、[IAM アクション参照](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions)に記載されている `aws-external-anthropic` アクションがあることを確認します。

161 344 

162`ANTHROPIC_AWS_API_KEY` を設定した場合、キーは SigV4 よりも優先され、古いキーは同じエラーを生成します。AWS Console の **Claude Platform on AWS → API keys** でキーを再生成するか、変数をアンセットして AWS 認証情報にフォールバックします。345`ANTHROPIC_AWS_API_KEY` を設定した場合、キーは SigV4 よりも優先され、古いキーは同じエラーを生成します。AWS Console の **Claude Platform on AWS → API keys** でキーを再生成するか、変数をアンセットして AWS 認証情報にフォールバックします。

163 346 


179 362 

180Claude Code を設定する前に行う AWS 上の Claude Platform サブスクリプション、ワークスペース、IAM セットアップはプラットフォームドキュメントで説明されています。363Claude Code を設定する前に行う AWS 上の Claude Platform サブスクリプション、ワークスペース、IAM セットアップはプラットフォームドキュメントで説明されています。

181 364 

182* [AWS 上の Claude Platform 概要](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws): サブスクリプション、ワークスペースセットアップ、製品リファレンス365* [AWS 上の Claude Platform 概要](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws): サブスクリプション、ワークスペースセットアップ、製品リファレンス

183* [IAM アクション参照](https://platform.claude.com/docs/en/api/claude-platform-on-aws-iam-actions): 権限とマネージドポリシー366* [IAM アクション参照](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions): 権限とマネージドポリシー

cli-reference.md +17 −15

Details

13これらのコマンドを使用して、セッションを開始し、コンテンツをパイプし、会話を再開し、更新を管理できます。13これらのコマンドを使用して、セッションを開始し、コンテンツをパイプし、会話を再開し、更新を管理できます。

14 14 

15| コマンド | 説明 | 例 |15| コマンド | 説明 | 例 |

16| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |16| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------- |

17| `claude` | インタラクティブセッションを開始 | `claude` |17| `claude` | インタラクティブセッションを開始 | `claude` |

18| `claude "query"` | 初期プロンプト付きでインタラクティブセッションを開始 | `claude "explain this project"` |18| `claude "query"` | 初期プロンプト付きでインタラクティブセッションを開始 | `claude "explain this project"` |

19| `claude -p "query"` | SDK 経由でクエリを実行してから終了 | `claude -p "explain this function"` |19| `claude -p "query"` | SDK 経由でクエリを実行してから終了 | `claude -p "explain this function"` |


26| `claude auth login` | Anthropic アカウントにサインインします。`--email` を使用してメールアドレスを事前入力し、`--sso` を使用して SSO 認証を強制し、`--console` を使用して Claude サブスクリプションの代わりに Anthropic Console で API 使用料金をサインインできます | `claude auth login --console` |26| `claude auth login` | Anthropic アカウントにサインインします。`--email` を使用してメールアドレスを事前入力し、`--sso` を使用して SSO 認証を強制し、`--console` を使用して Claude サブスクリプションの代わりに Anthropic Console で API 使用料金をサインインできます | `claude auth login --console` |

27| `claude auth logout` | Anthropic アカウントからログアウト | `claude auth logout` |27| `claude auth logout` | Anthropic アカウントからログアウト | `claude auth logout` |

28| `claude auth status` | 認証ステータスを JSON として表示します。`--text` を使用して人間が読める形式で表示できます。ログイン済みの場合はコード 0 で終了し、ログインしていない場合は 1 で終了します | `claude auth status` |28| `claude auth status` | 認証ステータスを JSON として表示します。`--text` を使用して人間が読める形式で表示できます。ログイン済みの場合はコード 0 で終了し、ログインしていない場合は 1 で終了します | `claude auth status` |

29| `claude agents` | [エージェントビュー](/ja/agent-view) を開いて、並列バックグラウンドセッションを監視およびディスパッチします。`--cwd <path>` を使用して、そのディレクトリの下で開始されたセッションのみを表示するか、`--json` を使用してライブセッションを JSON 配列として出力してスクリプト作成用にします。`--permission-mode`、`--model`、`--effort`、または `--agent` を渡して、[ディスパッチされたセッションのデフォルト](/ja/agent-view#permission-mode-model-and-effort) を設定します。トップレベルの `claude` コマンドと同様に `--settings`、`--add-dir`、`--plugin-dir`、および `--mcp-config` を受け入れます。エージェントビューを開くにはインタラクティブターミナルが必要です | `claude agents --json` |29| `claude agents` | [エージェントビュー](/ja/agent-view) を開いて、並列バックグラウンドセッションを監視およびディスパッチします。`--cwd <path>` を使用して、そのディレクトリの下で開始されたセッションのみを表示するか、`--json` を使用してアクティブなセッションを JSON 配列として出力してスクリプト作成用にします(`--json --all` は完了したバックグラウンドセッションも含みます)。`--permission-mode`、`--model`、`--effort`、または `--agent` を渡して、[ディスパッチされたセッションのデフォルト](/ja/agent-view#permission-mode-model-and-effort) を設定します。トップレベルの `claude` コマンドと同様に `--settings`、`--add-dir`、`--plugin-dir`、および `--mcp-config` を受け入れます。エージェントビューを開くにはインタラクティブターミナルが必要です | `claude agents --json` |

30| `claude attach <id>` | このターミナルで [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) に接続します | `claude attach 7c5dcf5d` |30| `claude attach <id>` | このターミナルで [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) に接続します | `claude attach 7c5dcf5d` |

31| `claude auto-mode defaults` | 組み込み [auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器ルールを JSON として出力します。`claude auto-mode config` を使用して、設定が適用された有効な設定を確認してください | `claude auto-mode defaults > rules.json` |31| `claude auto-mode defaults` | 組み込み [auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器ルールを JSON として出力します。`claude auto-mode config` を使用して、設定が適用された有効な設定を確認してください | `claude auto-mode defaults > rules.json` |

32| `claude daemon status` | バックグラウンドセッション [スーパーバイザー](/ja/agent-view#the-supervisor-process) の状態、バージョン、ソケットディレクトリ、および診断用のワーカー数を出力します。スーパーバイザーが実行されていない場合は 1 で終了します | `claude daemon status` |32| `claude daemon status` | バックグラウンドセッション [スーパーバイザー](/ja/agent-view#the-supervisor-process) の状態、バージョン、ソケットディレクトリ、および診断用のワーカー数を出力します。スーパーバイザーが実行されていない場合は 1 で終了します | `claude daemon status` |


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

52 52 

53| フラグ | 説明 | 例 |53| フラグ | 説明 | 例 |

54| :---------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |54| :---------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- |

55| `--add-dir` | Claude がファイルを読み取り、編集するための追加の作業ディレクトリを追加します。ファイルアクセスを許可します。ほとんどの `.claude/` 設定は [これらのディレクトリから検出されません](/ja/permissions#additional-directories-grant-file-access-not-configuration)。各パスがディレクトリとして存在することを検証します。これらのディレクトリをセッション全体で永続化するには、設定で [`permissions.additionalDirectories`](/ja/settings#permission-settings) を設定してください | `claude --add-dir ../apps ../lib` |55| `--add-dir` | Claude がファイルを読み取り、編集するための追加の作業ディレクトリを追加します。ファイルアクセスを許可します。ほとんどの `.claude/` 設定は [これらのディレクトリから検出されません](/ja/permissions#additional-directories-grant-file-access-not-configuration)。各パスがディレクトリとして存在することを検証します。これらのディレクトリをセッション全体で永続化するには、設定で [`permissions.additionalDirectories`](/ja/settings#permission-settings) を設定してください | `claude --add-dir ../apps ../lib` |

56| `--advisor <model>` | {/* min-version: 2.1.98 */}このセッションのサーバーサイド [advisor ツール](/ja/advisor) をモデルエイリアス `opus`、`sonnet`、または `fable`({/* min-version: 2.1.170 */}v2.1.170+)、または完全なモデル ID で有効にします。このセッションの `advisorModel` 設定より優先されます。Claude Code v2.1.98 以降が必要です | `claude --advisor opus` |

56| `--agent` | 現在のセッションのエージェントを指定します(`agent` 設定をオーバーライドします) | `claude --agent my-custom-agent` |57| `--agent` | 現在のセッションのエージェントを指定します(`agent` 設定をオーバーライドします) | `claude --agent my-custom-agent` |

57| `--agents` | JSON 経由でカスタム subagents を動的に定義します。subagent [frontmatter](/ja/sub-agents#supported-frontmatter-fields) と同じフィールド名を使用し、さらにエージェントの指示用の `prompt` フィールドを追加します | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |58| `--agents` | JSON 経由でカスタム subagents を動的に定義します。subagent [frontmatter](/ja/sub-agents#supported-frontmatter-fields) と同じフィールド名を使用し、さらにエージェントの指示用の `prompt` フィールドを追加します | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

58| `--allow-dangerously-skip-permissions` | `Shift+Tab` モードサイクルに `bypassPermissions` を追加します。これを開始時に有効にしません。`plan` のような別のモードで開始し、後で `bypassPermissions` に切り替えることができます。[権限モード](/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) を参照してください | `claude --permission-mode plan --allow-dangerously-skip-permissions` |59| `--allow-dangerously-skip-permissions` | `Shift+Tab` モードサイクルに `bypassPermissions` を追加します。これを開始時に有効にしません。`plan` のような別のモードで開始し、後で `bypassPermissions` に切り替えることができます。[権限モード](/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) を参照してください | `claude --permission-mode plan --allow-dangerously-skip-permissions` |

59| `--allowedTools` | 権限を求めずに実行するツール。パターンマッチングについては [権限ルール構文](/ja/settings#permission-rule-syntax) を参照してください。利用可能なツールを制限するには、代わりに `--tools` を使用してください | `"Bash(git log *)" "Bash(git diff *)" "Read"` |60| `--allowedTools`、`--allowed-tools` | 権限を求めずに実行するツール。パターンマッチングについては [権限ルール構文](/ja/settings#permission-rule-syntax) を参照してください。利用可能なツールを制限するには、代わりに `--tools` を使用してください | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

60| `--append-system-prompt` | デフォルトシステムプロンプトの末尾にカスタムテキストを追加します | `claude --append-system-prompt "Always use TypeScript"` |61| `--append-system-prompt` | デフォルトシステムプロンプトの末尾にカスタムテキストを追加します | `claude --append-system-prompt "Always use TypeScript"` |

61| `--append-system-prompt-file` | ファイルから追加のシステムプロンプトテキストを読み込み、デフォルトプロンプトに追加します | `claude --append-system-prompt-file ./extra-rules.txt` |62| `--append-system-prompt-file` | ファイルから追加のシステムプロンプトテキストを読み込み、デフォルトプロンプトに追加します | `claude --append-system-prompt-file ./extra-rules.txt` |

62| `--bare` | 最小限モード:hooks、skills、plugins、MCP サーバー、自動メモリ、CLAUDE.md の自動検出をスキップして、スクリプト化された呼び出しをより高速に開始します。Claude は Bash、ファイル読み取り、ファイル編集ツールにアクセスできます。[`CLAUDE_CODE_SIMPLE`](/ja/env-vars) を設定します。[bare mode](/ja/headless#start-faster-with-bare-mode) を参照してください | `claude --bare -p "query"` |63| `--bare` | 最小限モード:hooks、skills、plugins、MCP サーバー、自動メモリ、CLAUDE.md の自動検出をスキップして、スクリプト化された呼び出しをより高速に開始します。Claude は Bash、ファイル読み取り、ファイル編集ツールにアクセスできます。[`CLAUDE_CODE_SIMPLE`](/ja/env-vars) を設定します。[bare mode](/ja/headless#start-faster-with-bare-mode) を参照してください | `claude --bare -p "query"` |


64| `--bg` | セッションを [バックグラウンドエージェント](/ja/agent-view) として開始し、すぐに戻ります。セッション ID と管理コマンドを出力します。`--exec` と組み合わせて、Claude セッションの代わりにシェルコマンドをバックグラウンドジョブとして実行するか、`--agent` と組み合わせて特定の subagent を実行します | `claude --bg "investigate the flaky test"` |65| `--bg` | セッションを [バックグラウンドエージェント](/ja/agent-view) として開始し、すぐに戻ります。セッション ID と管理コマンドを出力します。`--exec` と組み合わせて、Claude セッションの代わりにシェルコマンドをバックグラウンドジョブとして実行するか、`--agent` と組み合わせて特定の subagent を実行します | `claude --bg "investigate the flaky test"` |

65| `--channels` | (研究プレビュー)Claude がこのセッションでリッスンすべき [channel](/ja/channels) 通知を持つ MCP サーバー。`plugin:<name>@<marketplace>` エントリのスペース区切りリスト。Claude.ai 認証が必要です | `claude --channels plugin:my-notifier@my-marketplace` |66| `--channels` | (研究プレビュー)Claude がこのセッションでリッスンすべき [channel](/ja/channels) 通知を持つ MCP サーバー。`plugin:<name>@<marketplace>` エントリのスペース区切りリスト。Claude.ai 認証が必要です | `claude --channels plugin:my-notifier@my-marketplace` |

66| `--chrome` | Web 自動化とテストのための [Chrome ブラウザ統合](/ja/chrome) を有効にします | `claude --chrome` |67| `--chrome` | Web 自動化とテストのための [Chrome ブラウザ統合](/ja/chrome) を有効にします | `claude --chrome` |

67| `--continue`, `-c` | 現在のディレクトリで最新の会話を読み込みます。このディレクトリを `/add-dir` で追加したセッションを含みます | `claude --continue` |68| `--continue``-c` | 現在のディレクトリで最新の会話を読み込みます。このディレクトリを `/add-dir` で追加したセッションを含みます | `claude --continue` |

68| `--dangerously-load-development-channels` | 承認されたアローリストにない [channels](/ja/channels-reference#test-during-the-research-preview) をローカル開発用に有効にします。`plugin:<name>@<marketplace>` および `server:<name>` エントリを受け入れます。確認を求めます | `claude --dangerously-load-development-channels server:webhook` |69| `--dangerously-load-development-channels` | 承認されたアローリストにない [channels](/ja/channels-reference#test-during-the-research-preview) をローカル開発用に有効にします。`plugin:<name>@<marketplace>` および `server:<name>` エントリを受け入れます。確認を求めます | `claude --dangerously-load-development-channels server:webhook` |

69| `--dangerously-skip-permissions` | すべての権限プロンプトをスキップします。`--permission-mode bypassPermissions` と同等です。[権限モード](/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) を参照して、これが何をスキップし、何をスキップしないかを確認してください | `claude --dangerously-skip-permissions` |70| `--dangerously-skip-permissions` | すべての権限プロンプトをスキップします。`--permission-mode bypassPermissions` と同等です。[権限モード](/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) を参照して、これが何をスキップし、何をスキップしないかを確認してください | `claude --dangerously-skip-permissions` |

70| `--debug` | オプションのカテゴリフィルタリング付きでデバッグモードを有効にします(例:`"api,hooks"` または `"!statsig,!file"`) | `claude --debug "api,mcp"` |71| `--debug` | オプションのカテゴリフィルタリング付きでデバッグモードを有効にします(例:`"api,hooks"` または `"!statsig,!file"`) | `claude --debug "api,mcp"` |

71| `--debug-file <path>` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします。`CLAUDE_CODE_DEBUG_LOGS_DIR` より優先されます | `claude --debug-file /tmp/claude-debug.log` |72| `--debug-file <path>` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします。`CLAUDE_CODE_DEBUG_LOGS_DIR` より優先されます | `claude --debug-file /tmp/claude-debug.log` |

72| `--disable-slash-commands` | このセッションのすべてのスキルとコマンドを無効にします | `claude --disable-slash-commands` |73| `--disable-slash-commands` | このセッションのすべてのスキルとコマンドを無効にします | `claude --disable-slash-commands` |

73| `--disallowedTools` | 拒否ルール。ベアツール名はそのツールをモデルのコンテキストから削除します。`Bash(rm *)` のようなスコープ付きルールはツールを利用可能なままにし、一致する呼び出しのみを拒否します | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |74| `--disallowedTools`、`--disallowed-tools` | 拒否ルール。ベアツール名はそのツールをモデルのコンテキストから削除します:`"Edit"` は Edit を削除し、`"*"` はすべてのツールを削除し、`"mcp__*"` はすべての MCP ツールを削除します。`Bash(rm *)` のようなスコープ付きルールはツールを利用可能なままにし、一致する呼び出しのみを拒否します | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

74| `--effort` | 現在のセッションの [努力レベル](/ja/model-config#adjust-effort-level) を設定します。オプション:`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルによって異なります。[`effortLevel`](/ja/settings#available-settings) 設定をこのセッションでオーバーライドし、永続化されません | `claude --effort high` |75| `--effort` | 現在のセッションの [努力レベル](/ja/model-config#adjust-effort-level) を設定します。オプション:`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルによって異なります。[`effortLevel`](/ja/settings#available-settings) 設定をこのセッションでオーバーライドし、永続化されません | `claude --effort high` |

75| `--enable-auto-mode` | {/* max-version: 2.1.110 */}v2.1.111 で削除されました。Auto mode は現在 `Shift+Tab` サイクルにデフォルトで含まれています。`--permission-mode auto` を使用して開始してください | `claude --permission-mode auto` |76| `--enable-auto-mode` | {/* max-version: 2.1.110 */}v2.1.111 で削除されました。Auto mode は現在 `Shift+Tab` サイクルにデフォルトで含まれています。`--permission-mode auto` を使用して開始してください | `claude --permission-mode auto` |

76| `--exclude-dynamic-system-prompt-sections` | システムプロンプトからマシンごとのセクション(作業ディレクトリ、環境情報、メモリパス、git リポジトリフラグ)を最初のユーザーメッセージに移動します。異なるユーザーとマシンで同じタスクを実行する場合、prompt-cache の再利用を改善します。デフォルトシステムプロンプトにのみ適用されます。`--system-prompt` または `--system-prompt-file` が設定されている場合は無視されます。スクリプト化された複数ユーザーのワークロードの場合は `-p` と一緒に使用してください | `claude -p --exclude-dynamic-system-prompt-sections "query"` |77| `--exclude-dynamic-system-prompt-sections` | システムプロンプトからマシンごとのセクション(作業ディレクトリ、環境情報、メモリパス、git リポジトリフラグ)を最初のユーザーメッセージに移動します。異なるユーザーとマシンで同じタスクを実行する場合、prompt-cache の再利用を改善します。デフォルトシステムプロンプトにのみ適用されます。`--system-prompt` または `--system-prompt-file` が設定されている場合は無視されます。スクリプト化された複数ユーザーのワークロードの場合は `-p` と一緒に使用してください | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

77| `--exec` | シェルコマンドを PTY バックアップのバックグラウンドジョブとして実行します。Claude セッションを開始する代わりに `--bg` と一緒に使用してください | `claude --bg --exec 'pytest -x'` |78| `--exec` | シェルコマンドを PTY バックアップのバックグラウンドジョブとして実行します。Claude セッションを開始する代わりに `--bg` と一緒に使用してください | `claude --bg --exec 'pytest -x'` |

78| `--fallback-model` | デフォルトモデルが過負荷の場合、指定されたモデルへの自動フォールバックを有効にします。例えば、廃止されたモデル。プリントモード(`-p`)と [バックグラウンドセッション](/ja/agent-view) で有効になります。バックグラウンドセッションは非インタラクティブで実行されますインタラクティブセッションでは無視されます | `claude -p --fallback-model sonnet "query"` |79| `--fallback-model` | プライマリモデルが過負荷の場合または利用できない場合、指定されたモデルへの自動フォールバックを有効にします。例えば、廃止されたモデル。カンマ区切りリストを受け入れ、順番に試されます。[フォールバックモデルチェーン](/ja/model-config#fallback-model-chains) を参照してください。セッション全体でチェーンを永続化するには、[`fallbackModel` 設定](/ja/settings#available-settings) を使用してくださいこのフラグはそれをオーバーライドします | `claude --fallback-model sonnet,haiku` |

79| `--fork-session` | 再開時に、元のセッション ID を再利用する代わりに新しいセッション ID を作成します(`--resume` または `--continue` と一緒に使用) | `claude --resume abc123 --fork-session` |80| `--fork-session` | 再開時に、元のセッション ID を再利用する代わりに新しいセッション ID を作成します(`--resume` または `--continue` と一緒に使用) | `claude --resume abc123 --fork-session` |

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

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


89| `--max-budget-usd` | 停止する前に API 呼び出しに費やす最大ドル金額(プリントモードのみ) | `claude -p --max-budget-usd 5.00 "query"` |90| `--max-budget-usd` | 停止する前に API 呼び出しに費やす最大ドル金額(プリントモードのみ) | `claude -p --max-budget-usd 5.00 "query"` |

90| `--max-turns` | agentic ターンの数を制限します(プリントモードのみ)。制限に達するとエラーで終了します。デフォルトでは制限なし | `claude -p --max-turns 3 "query"` |91| `--max-turns` | agentic ターンの数を制限します(プリントモードのみ)。制限に達するとエラーで終了します。デフォルトでは制限なし | `claude -p --max-turns 3 "query"` |

91| `--mcp-config` | JSON ファイルまたは文字列から MCP サーバーを読み込みます(スペース区切り) | `claude --mcp-config ./mcp.json` |92| `--mcp-config` | JSON ファイルまたは文字列から MCP サーバーを読み込みます(スペース区切り) | `claude --mcp-config ./mcp.json` |

92| `--model` | 現在のセッションのモデルを、最新モデルのエイリアス(`sonnet` または `opus`)またはモデルの完全な名前で設定します。[`model`](/ja/settings#available-settings) 設定と [`ANTHROPIC_MODEL`](/ja/model-config#environment-variables) をオーバーライドします | `claude --model claude-sonnet-4-6` |93| `--model` | 現在のセッションのモデルを、最新モデルのエイリアス(`sonnet`、`opus`、`haiku`、または `fable`)またはモデルの完全な名前で設定します。[`model`](/ja/settings#available-settings) 設定と [`ANTHROPIC_MODEL`](/ja/model-config#environment-variables) をオーバーライドします | `claude --model claude-sonnet-4-6` |

93| `--name`, `-n` | セッションの表示名を設定します。`/resume` とターミナルタイトルに表示されます。`claude --resume <name>` で名前付きセッションを再開できます。<br /><br />[`/rename`](/ja/commands) はセッション中に名前を変更し、プロンプトバーにも表示します | `claude -n "my-feature-work"` |94| `--name``-n` | セッションの表示名を設定します。`/resume` とターミナルタイトルに表示されます。`claude --resume <name>` で名前付きセッションを再開できます。<br /><br />[`/rename`](/ja/commands) はセッション中に名前を変更し、プロンプトバーにも表示します | `claude -n "my-feature-work"` |

94| `--no-chrome` | このセッションの [Chrome ブラウザ統合](/ja/chrome) を無効にします | `claude --no-chrome` |95| `--no-chrome` | このセッションの [Chrome ブラウザ統合](/ja/chrome) を無効にします | `claude --no-chrome` |

95| `--no-session-persistence` | セッション永続化を無効にして、セッションがディスクに保存されず、再開できないようにします(プリントモードのみ)。[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ja/env-vars) 環境変数は任意のモードで同じことを行います | `claude -p --no-session-persistence "query"` |96| `--no-session-persistence` | セッション永続化を無効にして、セッションがディスクに保存されず、再開できないようにします(プリントモードのみ)。[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ja/env-vars) 環境変数は任意のモードで同じことを行います | `claude -p --no-session-persistence "query"` |

96| `--output-format` | プリントモードの出力形式を指定します(オプション:`text`、`json`、`stream-json`) | `claude -p "query" --output-format json` |97| `--output-format` | プリントモードの出力形式を指定します(オプション:`text`、`json`、`stream-json`) | `claude -p "query" --output-format json` |


98| `--permission-prompt-tool` | 非インタラクティブモードで権限プロンプトを処理する MCP ツールを指定します | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |99| `--permission-prompt-tool` | 非インタラクティブモードで権限プロンプトを処理する MCP ツールを指定します | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

99| `--plugin-dir` | このセッションのみのプラグインをディレクトリまたは `.zip` アーカイブから読み込みます。各フラグは 1 つのパスを取ります。複数のプラグインの場合はフラグを繰り返します:`--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |100| `--plugin-dir` | このセッションのみのプラグインをディレクトリまたは `.zip` アーカイブから読み込みます。各フラグは 1 つのパスを取ります。複数のプラグインの場合はフラグを繰り返します:`--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |

100| `--plugin-url` | このセッションのみのプラグイン `.zip` アーカイブを URL から取得します。複数のプラグインの場合はフラグを繰り返すか、スペース区切りの URL を単一の引用符で囲まれた値で渡します | `claude --plugin-url https://example.com/plugin.zip` |101| `--plugin-url` | このセッションのみのプラグイン `.zip` アーカイブを URL から取得します。複数のプラグインの場合はフラグを繰り返すか、スペース区切りの URL を単一の引用符で囲まれた値で渡します | `claude --plugin-url https://example.com/plugin.zip` |

101| `--print`, `-p` | インタラクティブモードなしで応答を出力します(プログラムによる使用の詳細については [Agent SDK ドキュメント](/ja/agent-sdk/overview) を参照) | `claude -p "query"` |102| `--print``-p` | インタラクティブモードなしで応答を出力します(プログラムによる使用の詳細については [Agent SDK ドキュメント](/ja/agent-sdk/overview) を参照) | `claude -p "query"` |

102| `--prompt-suggestions` | 各ターンの後に、予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを発行します。`--print`、`--output-format stream-json`、および `--verbose` が必要です。[プロンプト提案](/ja/interactive-mode#prompt-suggestions) を参照してください | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |103| `--prompt-suggestions` | 各ターンの後に、予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを発行します。`--print`、`--output-format stream-json`、および `--verbose` が必要です。[プロンプト提案](/ja/interactive-mode#prompt-suggestions) を参照してください | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

103| `--remote` | 提供されたタスク説明で claude.ai に新しい [Web セッション](/ja/claude-code-on-the-web) を作成します | `claude --remote "Fix the login bug"` |104| `--remote` | 提供されたタスク説明で claude.ai に新しい [Web セッション](/ja/claude-code-on-the-web) を作成します | `claude --remote "Fix the login bug"` |

104| `--remote-control`, `--rc` | [Remote Control](/ja/remote-control#start-a-remote-control-session) を有効にしてインタラクティブセッションを開始し、claude.ai または Claude アプリからも制御できるようにします。オプションでセッションの名前を渡すことができます | `claude --remote-control "My Project"` |105| `--remote-control``--rc` | [Remote Control](/ja/remote-control#start-a-remote-control-session) を有効にしてインタラクティブセッションを開始し、claude.ai または Claude アプリからも制御できるようにします。オプションでセッションの名前を渡すことができます | `claude --remote-control "My Project"` |

105| `--remote-control-session-name-prefix <prefix>` | 明示的な名前が設定されていない場合、自動生成される [Remote Control](/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前が生成されます。同じ効果を得るには `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を設定してください | `claude remote-control --remote-control-session-name-prefix dev-box` |106| `--remote-control-session-name-prefix <prefix>` | 明示的な名前が設定されていない場合、自動生成される [Remote Control](/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前が生成されます。同じ効果を得るには `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を設定してください | `claude remote-control --remote-control-session-name-prefix dev-box` |

106| `--replay-user-messages` | stdin からのユーザーメッセージを stdout に再発行して確認します。`--input-format stream-json` と `--output-format stream-json` が必要です | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |107| `--replay-user-messages` | stdin からのユーザーメッセージを stdout に再発行して確認します。`--input-format stream-json` と `--output-format stream-json` が必要です | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

107| `--resume`, `-r` | ID または名前で特定のセッションを再開するか、セッションを選択するためのインタラクティブピッカーを表示します。このディレクトリを `/add-dir` で追加したセッションを含みます。v2.1.144 以降、[バックグラウンドセッション](/ja/agent-view) はピッカーに `bg` でマークされて表示されます | `claude --resume auth-refactor` |108| `--resume``-r` | ID または名前で特定のセッションを再開するか、セッションを選択するためのインタラクティブピッカーを表示します。ピッカーと名前検索には、このディレクトリを `/add-dir` で追加したセッションが含まれますセッション ID を渡すと、現在のプロジェクトディレクトリとその git worktrees のみが検索されます。v2.1.144 以降、[バックグラウンドセッション](/ja/agent-view) はピッカーに `bg` でマークされて表示されます | `claude --resume auth-refactor` |

109| `--safe-mode` | {/* min-version: 2.1.169 */}すべてのカスタマイズを無効にして開始し、壊れた設定をトラブルシューティングします:CLAUDE.md、skills、plugins、hooks、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインとファイル提案コマンド、LSP サーバー、および自動メモリは読み込まれません。認証、モデル選択、組み込みツール、および権限は通常どおり機能します。これは [`--bare`](/ja/headless#start-faster-with-bare-mode) とは異なります。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含みます。管理プラグイン、管理スキル、管理 CLAUDE.md、およびポリシー設定 MCP サーバーは含まれません。[Fable 5 からの自動フォールバック](/ja/model-config#automatic-model-fallback) をトリガーするカスタマイズかどうかを確認するのに役立ちます。[`CLAUDE_CODE_SAFE_MODE`](/ja/env-vars) を設定します | `claude --safe-mode` |

108| `--session-id` | 会話に特定のセッション ID を使用します(有効な UUID である必要があります) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |110| `--session-id` | 会話に特定のセッション ID を使用します(有効な UUID である必要があります) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

109| `--setting-sources` | 読み込む設定ソースのカンマ区切りリスト(`user`、`project`、`local`) | `claude --setting-sources user,project` |111| `--setting-sources` | 読み込む設定ソースのカンマ区切りリスト(`user`、`project`、`local`) | `claude --setting-sources user,project` |

110| `--settings` | 設定 JSON ファイルまたはインライン JSON 文字列へのパス。ここで設定した値は、このセッションの `settings.json` ファイル内の同じキーをオーバーライドします。省略したキーはファイルベースの値を保持します。[設定の優先順位](/ja/settings#settings-precedence) を参照してください | `claude --settings ./settings.json` |112| `--settings` | 設定 JSON ファイルまたはインライン JSON 文字列へのパス。ここで設定した値は、このセッションの `settings.json` ファイル内の同じキーをオーバーライドします。省略したキーはファイルベースの値を保持します。[設定の優先順位](/ja/settings#settings-precedence) を参照してください | `claude --settings ./settings.json` |


114| `--teleport` | [Web セッション](/ja/claude-code-on-the-web) をローカルターミナルで再開します | `claude --teleport` |116| `--teleport` | [Web セッション](/ja/claude-code-on-the-web) をローカルターミナルで再開します | `claude --teleport` |

115| `--teammate-mode` | [エージェントチーム](/ja/agent-teams) のチームメイトの表示方法を設定します:`auto`(デフォルト)、`in-process`、または `tmux`。このセッションの [`teammateMode`](/ja/settings#available-settings) 設定をオーバーライドします。[ディスプレイモードを選択](/ja/agent-teams#choose-a-display-mode) を参照してください | `claude --teammate-mode in-process` |117| `--teammate-mode` | [エージェントチーム](/ja/agent-teams) のチームメイトの表示方法を設定します:`auto`(デフォルト)、`in-process`、または `tmux`。このセッションの [`teammateMode`](/ja/settings#available-settings) 設定をオーバーライドします。[ディスプレイモードを選択](/ja/agent-teams#choose-a-display-mode) を参照してください | `claude --teammate-mode in-process` |

116| `--tmux` | worktree 用に tmux セッションを作成します。`--worktree` が必要です。利用可能な場合は iTerm2 ネイティブペインを使用します。従来の tmux の場合は `--tmux=classic` を渡します | `claude -w feature-auth --tmux` |118| `--tmux` | worktree 用に tmux セッションを作成します。`--worktree` が必要です。利用可能な場合は iTerm2 ネイティブペインを使用します。従来の tmux の場合は `--tmux=classic` を渡します | `claude -w feature-auth --tmux` |

117| `--tools` | Claude が使用できる組み込みツールを制限します。`""` を使用してすべてを無効にし、`"default"` を使用してすべてを有効にするか、`"Bash,Edit,Read"` のようなツール名を使用します | `claude --tools "Bash,Edit,Read"` |119| `--tools` | Claude が使用できる組み込みツールを制限します。`""` を使用してすべてを無効にし、`"default"` を使用してすべてを有効にするか、`"Bash,Edit,Read"` のようなツール名を使用します。MCP ツールは影響を受けません。それらも拒否するには、`--disallowedTools "mcp__*"` を使用するか、`--mcp-config` なしで `--strict-mcp-config` を渡して、MCP サーバーが読み込まれないようにします | `claude --tools "Bash,Edit,Read"` |

118| `--verbose` | 詳細ログを有効にし、ターンごとの完全な出力を表示します。このセッションの [`viewMode`](/ja/settings#available-settings) 設定をオーバーライドします | `claude --verbose` |120| `--verbose` | 詳細ログを有効にし、ターンごとの完全な出力を表示します。このセッションの [`viewMode`](/ja/settings#available-settings) 設定をオーバーライドします | `claude --verbose` |

119| `--version`, `-v` | バージョン番号を出力します | `claude -v` |121| `--version``-v` | バージョン番号を出力します | `claude -v` |

120| `--worktree`, `-w` | Claude を `<repo>/.claude/worktrees/<name>` の分離された [git worktree](/ja/worktrees) で開始します。名前が指定されていない場合は、自動生成されます。`#<number>` または GitHub プルリクエスト URL を渡して、`origin` からその PR をフェッチし、worktree をそこからブランチします | `claude -w feature-auth` |122| `--worktree``-w` | Claude を `<repo>/.claude/worktrees/<name>` の分離された [git worktree](/ja/worktrees) で開始します。名前が指定されていない場合は、自動生成されます。`#<number>` または GitHub プルリクエスト URL を渡して、`origin` からその PR をフェッチし、worktree をそこからブランチします | `claude -w feature-auth` |

121 123 

122<h3 id="system-prompt-flags">124<h3 id="system-prompt-flags">

123 システムプロンプトフラグ125 システムプロンプトフラグ

code-review.md +67 −25

Details

30 GitHub アプリをインストールせずにターミナルでローカルに差分をレビューするには、任意の Claude Code セッションで `/code-review` コマンドを実行してください。[ローカルで差分をレビューする](#review-a-diff-locally)を参照してください。30 GitHub アプリをインストールせずにターミナルでローカルに差分をレビューするには、任意の Claude Code セッションで `/code-review` コマンドを実行してください。[ローカルで差分をレビューする](#review-a-diff-locally)を参照してください。

31</Note>31</Note>

32 32 

33## レビューの仕組み33<h2 id="how-reviews-work">

34 レビューの仕組み

35</h2>

34 36 

35管理者が組織の Code Review を[有効にする](#set-up-code-review)と、リポジトリの設定された動作に応じて、PR が開かれたとき、すべてのプッシュ時、または手動でリクエストされたときにレビューがトリガーされます。PR で `@claude review` と[コメントすると](#manually-trigger-reviews)、任意のモードでレビューが開始されます。37管理者が組織の Code Review を[有効にする](#set-up-code-review)と、リポジトリの設定された動作に応じて、PR が開かれたとき、すべてのプッシュ時、または手動でリクエストされたときにレビューがトリガーされます。PR で `@claude review` と[コメントすると](#manually-trigger-reviews)、任意のモードでレビューが開始されます。

36 38 


38 40 

39レビューはコストが PR のサイズと複雑さに応じてスケーリングされ、平均 20 分で完了します。管理者は[分析ダッシュボード](#view-usage)を通じてレビューアクティビティと支出を監視できます。41レビューはコストが PR のサイズと複雑さに応じてスケーリングされ、平均 20 分で完了します。管理者は[分析ダッシュボード](#view-usage)を通じてレビューアクティビティと支出を監視できます。

40 42 

41### 重大度レベル43<h3 id="severity-levels">

44 重大度レベル

45</h3>

42 46 

43各結果は重大度レベルでタグ付けされます:47各結果は重大度レベルでタグ付けされます:

44 48 


50 54 

51結果には、展開可能な拡張推論セクションが含まれており、Claude がなぜ問題をフラグ立てしたのか、どのように問題を検証したのかを理解するために展開できます。55結果には、展開可能な拡張推論セクションが含まれており、Claude がなぜ問題をフラグ立てしたのか、どのように問題を検証したのかを理解するために展開できます。

52 56 

53### 結果に対する評価と返信57<h3 id="rate-and-reply-to-findings">

58 結果に対する評価と返信

59</h3>

54 60 

55Claude からの各レビューコメントには、👍 と 👎 が既に添付されているため、GitHub UI で両方のボタンがワンクリック評価のために表示されます。結果が有用だった場合は 👍 をクリックし、間違っていたか騒々しかった場合は 👎 をクリックしてください。Anthropic は PR がマージされた後にリアクションカウントを収集し、それを使用してレビュアーをチューニングします。リアクションは再レビューをトリガーしたり、PR 上の何かを変更したりしません。61Claude からの各レビューコメントには、👍 と 👎 が既に添付されているため、GitHub UI で両方のボタンがワンクリック評価のために表示されます。結果が有用だった場合は 👍 をクリックし、間違っていたか騒々しかった場合は 👎 をクリックしてください。Anthropic は PR がマージされた後にリアクションカウントを収集し、それを使用してレビュアーをチューニングします。リアクションは再レビューをトリガーしたり、PR 上の何かを変更したりしません。

56 62 

57インラインコメントに返信しても、Claude が応答したり PR を更新したりするようにプロンプトされません。結果に対処するには、コードを修正してプッシュしてください。PR がプッシュトリガーレビューにサブスクライブされている場合、次の実行は問題が修正されるとスレッドを解決します。プッシュせずに新しいレビューをリクエストするには、[トップレベルの PR コメント](#manually-trigger-reviews)として `@claude review once` とコメントしてください。63インラインコメントに返信しても、Claude が応答したり PR を更新したりするようにプロンプトされません。結果に対処するには、コードを修正してプッシュしてください。PR がプッシュトリガーレビューにサブスクライブされている場合、次の実行は問題が修正されるとスレッドを解決します。プッシュせずに新しいレビューをリクエストするには、[トップレベルの PR コメント](#manually-trigger-reviews)として `@claude review once` とコメントしてください。

58 64 

59### チェック実行出力65<h3 id="check-run-output">

66 チェック実行出力

67</h3>

60 68 

61インラインレビューコメントに加えて、各レビューは CI チェックと並んで表示される **Claude Code Review** チェック実行を生成します。その **Details** リンクを展開して、すべての結果の概要を 1 か所で確認でき、重大度でソートされています:69インラインレビューコメントに加えて、各レビューは CI チェックと並んで表示される **Claude Code Review** チェック実行を生成します。その **Details** リンクを展開して、すべての結果の概要を 1 か所で確認でき、重大度でソートされています:

62 70 


76 84 

77これは重大度ごとのカウントを含む JSON オブジェクトを返します。例えば `{"normal": 2, "nit": 1, "pre_existing": 0}` です。`normal` キーは Important の結果のカウントを保持します。ゼロ以外の値は、Claude がマージ前に修正する価値のあるバグを少なくとも 1 つ見つけたことを意味します。85これは重大度ごとのカウントを含む JSON オブジェクトを返します。例えば `{"normal": 2, "nit": 1, "pre_existing": 0}` です。`normal` キーは Important の結果のカウントを保持します。ゼロ以外の値は、Claude がマージ前に修正する価値のあるバグを少なくとも 1 つ見つけたことを意味します。

78 86 

79### Code Review がチェックする内容87<h3 id="what-code-review-checks">

88 Code Review がチェックする内容

89</h3>

80 90 

81デフォルトでは、Code Review は正確性に焦点を当てています:フォーマット設定の好みやテストカバレッジの欠落ではなく、本番環境を壊すバグです。リポジトリに[ガイダンスファイルを追加](#customize-reviews)することで、チェック内容を拡張できます。91デフォルトでは、Code Review は正確性に焦点を当てています:フォーマット設定の好みやテストカバレッジの欠落ではなく、本番環境を壊すバグです。リポジトリに[ガイダンスファイルを追加](#customize-reviews)することで、チェック内容を拡張できます。

82 92 

83## Code Review のセットアップ93<h2 id="set-up-code-review">

94 Code Review のセットアップ

95</h2>

84 96 

85管理者が組織に対して Code Review を 1 回有効にし、含めるリポジトリを選択します。97管理者が組織に対して Code Review を 1 回有効にし、含めるリポジトリを選択します。

86 98 


122 134 

123セットアップを確認するには、テスト PR を開きます。自動トリガーを選択した場合、**Claude Code Review** という名前のチェック実行が数分以内に表示されます。Manual を選択した場合は、PR で `@claude review` とコメントして最初のレビューを開始します。チェック実行が表示されない場合は、リポジトリが管理設定に一覧表示されていることと、Claude GitHub App がアクセス権を持っていることを確認してください。135セットアップを確認するには、テスト PR を開きます。自動トリガーを選択した場合、**Claude Code Review** という名前のチェック実行が数分以内に表示されます。Manual を選択した場合は、PR で `@claude review` とコメントして最初のレビューを開始します。チェック実行が表示されない場合は、リポジトリが管理設定に一覧表示されていることと、Claude GitHub App がアクセス権を持っていることを確認してください。

124 136 

125## レビューを手動でトリガーする137<h2 id="manually-trigger-reviews">

138 レビューを手動でトリガーする

139</h2>

126 140 

1272 つのコメントコマンドがオンデマンドでレビューを開始します。どちらもリポジトリの設定されたトリガーに関係なく機能するため、Manual モードで特定の PR をレビューにオプトインするか、他のモードで即座に再レビューを取得するために使用できます。1412 つのコメントコマンドがオンデマンドでレビューを開始します。どちらもリポジトリの設定されたトリガーに関係なく機能するため、Manual モードで特定の PR をレビューにオプトインするか、他のモードで即座に再レビューを取得するために使用できます。

128 142 


144 158 

145その PR でレビューが既に実行されている場合、リクエストは進行中のレビューが完了するまでキューに入ります。PR のチェック実行を通じて進捗を監視できます。159その PR でレビューが既に実行されている場合、リクエストは進行中のレビューが完了するまでキューに入ります。PR のチェック実行を通じて進捗を監視できます。

146 160 

147## レビューをカスタマイズする161<h2 id="customize-reviews">

162 レビューをカスタマイズする

163</h2>

148 164 

149Code Review はリポジトリから 2 つのファイルを読み取り、フラグを立てる内容をガイドします。これらは、デフォルトの正確性チェックの上にどの程度強く影響するかが異なります165Code Review はリポジトリから 2 つのファイルを読み取り、フラグを立てる内容をガイドします。これらは、リビューにどの程度強く影響するかが異なります

150 166 

151* **`CLAUDE.md`**: Claude Code がすべてのタスク(レビューだけではなく)に使用する共有プロジェクト指示。Code Review はそれをプロジェクトコンテキストとして読み取り、新しく導入された違反を nit としてフラグ立てします。167* **`CLAUDE.md`**: Claude Code がすべてのタスク(レビューだけではなく)に使用する共有プロジェクト指示。Code Review はそれをプロジェクトコンテキストとして読み取り、新しく導入された違反を nit としてフラグ立てします。

152* **`REVIEW.md`**: レビューのみのガイダンス、レビューパイプラインのすべてのエージェントに最優先として直接注入されます。フラグを立てるもの、重大度、結果の報告方法を変更するために使用します。168* **`REVIEW.md`**: レビューのみのガイダンス、レビューパイプラインのすべてのエージェントに最優先として直接注入されます。フラグを立てるもの、重大度、結果の報告方法を変更するために使用します。

153 169 

154### CLAUDE.md170<h3 id="claude-md">

171 CLAUDE.md

172</h3>

155 173 

156Code Review はリポジトリの `CLAUDE.md` ファイルを読み取り、新しく導入された違反を[nit レベル](#severity-levels)の結果として扱います。これは双方向に機能します:PR が `CLAUDE.md` ステートメントを古くする方法でコードを変更する場合、Claude はドキュメントを更新する必要があることをフラグ立てします。174Code Review はリポジトリの `CLAUDE.md` ファイルを読み取り、新しく導入された違反を[nit レベル](#severity-levels)の結果として扱います。これは双方向に機能します:PR が `CLAUDE.md` ステートメントを古くする方法でコードを変更する場合、Claude はドキュメントを更新する必要があることをフラグ立てします。

157 175 


159 177 

160一般的な Claude Code セッションに適用したくないレビュー固有のガイダンスについては、代わりに[`REVIEW.md`](#review-md)を使用します。178一般的な Claude Code セッションに適用したくないレビュー固有のガイダンスについては、代わりに[`REVIEW.md`](#review-md)を使用します。

161 179 

162### REVIEW\.md180<h3 id="review-md">

181 REVIEW\.md

182</h3>

163 183 

164`REVIEW.md` はリポジトリルートのファイルで、Code Review がリポジトリ上でどのように動作するかをオーバーライドします。その内容は、レビューパイプラインのすべてのエージェントのシステムプロンプトに最優先の指示ブロックとして注入され、デフォルトのレビューガイダンスより優先されます。184`REVIEW.md` はリポジトリルートのファイルで、Code Review がリポジトリ上でどのように動作するかをオーバーライドします。その内容は、レビューパイプラインのすべてのエージェントのシステムプロンプトに最優先の指示ブロックとして注入され、デフォルトのレビューガイダンスより優先されます。

165 185 

166逐語的に貼り付けられるため、`REVIEW.md` はプレーンな指示です:[`@` import 構文](/ja/memory#import-additional-files)は展開されず、参照されたファイルはプロンプトに読み込まれません。実装したいルールをファイルに直接配置します。186逐語的に貼り付けられるため、`REVIEW.md` はプレーンな指示です:[`@` import 構文](/ja/memory#import-additional-files)は展開されず、参照されたファイルはプロンプトに読み込まれません。実装したいルールをファイルに直接配置します。

167 187 

168#### チューニング可能な内容188<h4 id="what-you-can-tune">

189 チューニング可能な内容

190</h4>

169 191 

170`REVIEW.md` はフリーフォーム markdown であるため、レビュー指示として表現できるものはすべてスコープ内です。以下のパターンは実際に最も影響があります。192`REVIEW.md` はフリーフォーム markdown であるため、レビュー指示として表現できるものはすべてスコープ内です。以下のパターンは実際に最も影響があります。

171 193 


183 205 

184**概要の形状**: レビュー本文が `2 factual, 4 style` のような 1 行のタリーで開くことを要求し、その場合は「ファクチュアルな問題なし」で始めることを要求します。著者は詳細の前に作業の形状を知りたいです。206**概要の形状**: レビュー本文が `2 factual, 4 style` のような 1 行のタリーで開くことを要求し、その場合は「ファクチュアルな問題なし」で始めることを要求します。著者は詳細の前に作業の形状を知りたいです。

185 207 

186#### 208<h4 id="example">

209

210</h4>

187 211 

188この `REVIEW.md` はバックエンドサービスの重大度を再キャリブレーションし、nit をキャップし、生成されたファイルをスキップし、リポジトリ固有のチェックを追加します。212この `REVIEW.md` はバックエンドサービスの重大度を再キャリブレーションし、nit をキャップし、生成されたファイルをスキップし、リポジトリ固有のチェックを追加します。

189 213 


211- データベースクエリは呼び出し元のテナントにスコープされている235- データベースクエリは呼び出し元のテナントにスコープされている

212```236```

213 237 

214#### フォーカスを保つ238<h4 id="keep-it-focused">

239 フォーカスを保つ

240</h4>

215 241 

216長さはコストがあります:長い `REVIEW.md` は最も重要なルールを薄めます。レビュー動作を変更する指示に保ち、一般的なプロジェクトコンテキストは `CLAUDE.md` に残します。242長さはコストがあります:長い `REVIEW.md` は最も重要なルールを薄めます。レビュー動作を変更する指示に保ち、一般的なプロジェクトコンテキストは `CLAUDE.md` に残します。

217 243 

218## 使用状況を表示する244<h2 id="view-usage">

245 使用状況を表示する

246</h2>

219 247 

220[claude.ai/analytics/code-review](https://claude.ai/analytics/code-review) にアクセスして、組織全体の Code Review アクティビティを確認します。ダッシュボードは以下を表示します:248[claude.ai/analytics/code-review](https://claude.ai/analytics/code-review) にアクセスして、組織全体の Code Review アクティビティを確認します。ダッシュボードは以下を表示します:

221 249 


228 256 

229管理設定のリポジトリテーブルは、各リポジトリの平均レビューコストも表示します。ダッシュボードのコスト数値は活動を監視するための推定値です。請求書に正確な支出については、Anthropic の請求書を参照してください。257管理設定のリポジトリテーブルは、各リポジトリの平均レビューコストも表示します。ダッシュボードのコスト数値は活動を監視するための推定値です。請求書に正確な支出については、Anthropic の請求書を参照してください。

230 258 

231## 料金259<h2 id="pricing">

260 料金

261</h2>

232 262 

233Code Review はトークン使用量に基づいて請求されます。各レビューは平均 \$15~25 のコストで、PR サイズ、コードベースの複雑さ、検証が必要な問題の数に応じてスケーリングされます。Code Review の使用は[usage credits](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)を通じて個別に請求され、プランの含まれた使用量にはカウントされません。263Code Review はトークン使用量に基づいて請求されます。各レビューは平均 \$15~25 のコストで、PR サイズ、コードベースの複雑さ、検証が必要な問題の数に応じてスケーリングされます。Code Review の使用は[usage credits](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)を通じて個別に請求され、プランの含まれた使用量にはカウントされません。

234 264 


244 274 

245[analytics](#view-usage) の週次コストチャートまたは管理設定のリポジトリごとの平均コスト列を通じて支出を監視します。275[analytics](#view-usage) の週次コストチャートまたは管理設定のリポジトリごとの平均コスト列を通じて支出を監視します。

246 276 

247## トラブルシューティング277<h2 id="troubleshooting">

278 トラブルシューティング

279</h2>

248 280 

249レビュー実行はベストエフォートです。失敗した実行は PR をブロックすることはありませんが、自動的に再試行されることもありません。このセクションでは、失敗した実行から回復する方法と、チェック実行が報告する問題が見つからない場合に確認する場所について説明します。281レビュー実行はベストエフォートです。失敗した実行は PR をブロックすることはありませんが、自動的に再試行されることもありません。このセクションでは、失敗した実行から回復する方法と、チェック実行が報告する問題が見つからない場合に確認する場所について説明します。

250 282 

251### 失敗またはタイムアウトしたレビューを再トリガーする283<h3 id="retrigger-a-failed-or-timed-out-review">

284 失敗またはタイムアウトしたレビューを再トリガーする

285</h3>

252 286 

253レビューインフラストラクチャが内部エラーに遭遇するか、時間制限を超える場合、チェック実行は **Code review encountered an error** または **Code review timed out** というタイトルで完了します。結論は依然として中立的であるため、マージをブロックするものはありませんが、結果は投稿されません。287レビューインフラストラクチャが内部エラーに遭遇するか、時間制限を超える場合、チェック実行は **Code review encountered an error** または **Code review timed out** というタイトルで完了します。結論は依然として中立的であるため、マージをブロックするものはありませんが、結果は投稿されません。

254 288 


256 290 

257GitHub の Checks タブの **Re-run** ボタンは Code Review を再トリガーしません。コメントコマンドまたは新しいプッシュを代わりに使用してください。291GitHub の Checks タブの **Re-run** ボタンは Code Review を再トリガーしません。コメントコマンドまたは新しいプッシュを代わりに使用してください。

258 292 

259### レビューが実行されず、PR が支出上限メッセージを表示する293<h3 id="review-didn’t-run-and-the-pr-shows-a-spend-cap-message">

294 レビューが実行されず、PR が支出上限メッセージを表示する

295</h3>

260 296 

261組織の月次支出上限に達すると、Code Review は PR に単一のコメントを投稿し、レビューがスキップされたことを説明します。レビューは次の請求期間の開始時に自動的に再開されるか、管理者が [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) で上限を引き上げるとすぐに再開されます。297組織の月次支出上限に達すると、Code Review は PR に単一のコメントを投稿し、レビューがスキップされたことを説明します。レビューは次の請求期間の開始時に自動的に再開されるか、管理者が [claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) で上限を引き上げるとすぐに再開されます。

262 298 

263### インラインコメントとして表示されていない問題を見つける299<h3 id="find-issues-that-aren’t-showing-as-inline-comments">

300 インラインコメントとして表示されていない問題を見つける

301</h3>

264 302 

265チェック実行タイトルが問題が見つかったと言っているが、diff にインラインレビューコメントが表示されない場合は、結果が表示されるこれらの他の場所を確認してください:303チェック実行タイトルが問題が見つかったと言っているが、diff にインラインレビューコメントが表示されない場合は、結果が表示されるこれらの他の場所を確認してください:

266 304 


268* **Files changed 注釈**: PR の **Files changed** タブを開きます。結果はレビューコメントとは別に、diff 行に直接添付された注釈としてレンダリングされます。306* **Files changed 注釈**: PR の **Files changed** タブを開きます。結果はレビューコメントとは別に、diff 行に直接添付された注釈としてレンダリングされます。

269* **レビュー本文**: レビューが実行されている間に PR にプッシュした場合、一部の結果は現在の diff に存在しなくなった行を参照する場合があります。これらは、インラインコメントではなく、レビュー本文テキストの **Additional findings** 見出しの下に表示されます。307* **レビュー本文**: レビューが実行されている間に PR にプッシュした場合、一部の結果は現在の diff に存在しなくなった行を参照する場合があります。これらは、インラインコメントではなく、レビュー本文テキストの **Additional findings** 見出しの下に表示されます。

270 308 

271## ローカルで差分をレビューする309<h2 id="review-a-diff-locally">

310 ローカルで差分をレビューする

311</h2>

272 312 

273[`/code-review` コマンド](/ja/commands)はターミナルで差分をレビューし、GitHub App をインストールせずに実行します。任意の Claude Code セッションで実行します:現在の差分の正確性バグを報告し、{/* min-version: 2.1.151 */}再利用、簡素化、効率化のクリーンアップを報告します。`--comment` を渡してインライン PR コメントとして結果を投稿するか、`--fix` を渡してレビュー後に結果をワーキングツリーに適用します。313[`/code-review` コマンド](/ja/commands)はターミナルで差分をレビューし、GitHub App をインストールせずに実行します。任意の Claude Code セッションで実行します:正確性バグを報告し、{/* min-version: 2.1.151 */}再利用、簡素化、効率化のクリーンアップを報告します。デフォルトでは、ローカルレビューはブランチのアップストリームより先のコミットとワーキングツリーの未コミット変更をカバーします。`--comment` を渡してインライン PR コメントとして結果を投稿するか、`--fix` を渡してレビュー後に結果をワーキングツリーに適用します。

274 314 

275低い[努力レベル](/ja/model-config#adjust-effort-level)は、より少なく、より高い信頼度の結果を返し、`high` から `max` はより広いカバレッジを提供し、不確実な結果を含む場合があります。努力引数がない場合、レビューはセッションの現在の努力を使用します。現在の差分の代わりに特定のターゲットをレビューするためにパスまたは PR 参照を渡します315低い[努力レベル](/ja/model-config#adjust-effort-level)はより少なく、より高い信頼度の結果を返し、`high` から `max` はより広いカバレッジを提供し、不確実な結果を含む場合があります。努力引数がない場合、レビューはセッションの現在の努力を使用します。デフォルトの差分以外をレビューするには、ターゲットを渡します:ファイルパス、PR 番号、ブランチ名、または `main...my-feature` などの ref 範囲ですref 範囲形式は、ブランチのアップストリームがどのように設定されているかに関係なく、`my-feature` から `main` へのプルリクエストに含まれるコミット済み差分をレビューします。

276 316 

277`/code-review ultra --fix` はクラウドでより深い[ultrareview](/ja/ultrareview)を実行し、セッションに戻ってきたときに結果をワーキングツリーに適用します。317`/code-review ultra --fix` はクラウドでより深い[ultrareview](/ja/ultrareview)を実行し、セッションに戻ってきたときに結果をワーキングツリーに適用します。Ultrareview は独自のスコープを使用します:現在のブランチとリポジトリのデフォルトブランチ、およびワーキングツリーの未コミットおよびステージされた変更です。

278 318 

279このコマンドは v2.1.147 より前は `/simplify` という名前で、デフォルトで修正を適用していました。{/* min-version: 2.1.154 */}v2.1.154 から、`/simplify` はバグを探さずに修正を適用するクリーンアップのみのレビューを実行します。バグ検出のために `/simplify` をスクリプト化した場合は、変更されていない `/code-review --fix` に切り替えてください。319このコマンドは v2.1.147 より前は `/simplify` という名前で、デフォルトで修正を適用していました。{/* min-version: 2.1.154 */}v2.1.154 から、`/simplify` はバグを探さずに修正を適用するクリーンアップのみのレビューを実行します。バグ検出のために `/simplify` をスクリプト化した場合は、変更されていない `/code-review --fix` に切り替えてください。

280 320 

281## 関連リソース321<h2 id="related-resources">

322 関連リソース

323</h2>

282 324 

283Code Review は Claude Code の残りの部分と連携するように設計されています。PR を開く前にローカルでレビューを実行したい場合、自己ホスト型セットアップが必要な場合、または `CLAUDE.md` がツール全体で Claude の動作をどのように形成するかについてさらに詳しく知りたい場合、これらのページは次の良い停止点です:325Code Review は Claude Code の残りの部分と連携するように設計されています。PR を開く前にローカルでレビューを実行したい場合、自己ホスト型セットアップが必要な場合、または `CLAUDE.md` がツール全体で Claude の動作をどのように形成するかについてさらに詳しく知りたい場合、これらのページは次の良い停止点です:

284 326 

commands.md +24 −13

Details

12 12 

13コマンドはメッセージの開始時にのみ認識されます。コマンド名の後に続くテキストは引数として渡されます。13コマンドはメッセージの開始時にのみ認識されます。コマンド名の後に続くテキストは引数として渡されます。

14 14 

15## 典型的なワークフロー全体でのコマンド15<h2 id="commands-across-a-typical-workflow">

16 典型的なワークフロー全体でのコマンド

17</h2>

16 18 

17ほとんどのコマンドはセッション内の特定の時点で有用です。プロジェクトのセットアップから変更のリリースまでです。19ほとんどのコマンドはセッション内の特定の時点で有用です。プロジェクトのセットアップから変更のリリースまでです。

18 20 


28 30 

29**何か問題がある場合。** `/rewind` はコードと会話をチェックポイントに巻き戻すか、会話の一部を要約します。`/doctor` と `/debug` はインストールとランタイムの問題を診断し、`/feedback` はセッションコンテキストが添付されたバグを報告します。31**何か問題がある場合。** `/rewind` はコードと会話をチェックポイントに巻き戻すか、会話の一部を要約します。`/doctor` と `/debug` はインストールとランタイムの問題を診断し、`/feedback` はセッションコンテキストが添付されたバグを報告します。

30 32 

31## すべてのコマンド33<h2 id="all-commands">

34 すべてのコマンド

35</h2>

32 36 

33以下の表は Claude Code に含まれるすべてのコマンドをリストしています。ほとんどは CLI にコード化された動作を持つ組み込みコマンドです。2 つの種類のエントリがマークされています。37以下の表は Claude Code に含まれるすべてのコマンドをリストしています。ほとんどは CLI にコード化された動作を持つ組み込みコマンドです。2 つの種類のエントリがマークされています。

34 38 


46| コマンド | 目的 |50| コマンド | 目的 |

47| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |51| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

48| `/add-dir <path>` | 現在のセッション中にファイルアクセス用の作業ディレクトリを追加します。ほとんどの `.claude/` 設定は追加されたディレクトリから[検出されません](/ja/permissions#additional-directories-grant-file-access-not-configuration)。後で `--continue` または `--resume` を使用して、追加されたディレクトリからセッションを再開できます |52| `/add-dir <path>` | 現在のセッション中にファイルアクセス用の作業ディレクトリを追加します。ほとんどの `.claude/` 設定は追加されたディレクトリから[検出されません](/ja/permissions#additional-directories-grant-file-access-not-configuration)。後で `--continue` または `--resume` を使用して、追加されたディレクトリからセッションを再開できます |

53| `/advisor [model\|off]` | {/* min-version: 2.1.98 */}[アドバイザーツール](/ja/advisor)を有効または無効にします。このツールはタスク中の重要な瞬間に 2 番目のモデルに相談して指導を受けます。`opus`、`sonnet`、`fable`({/* min-version: 2.1.170 */}v2.1.170+)、または完全なモデル ID を受け入れます。引数なしで、ピッカーを開きます。Claude Code v2.1.98 以降が必要です |

49| `/agents` | [エージェント](/ja/sub-agents)設定を管理します |54| `/agents` | [エージェント](/ja/sub-agents)設定を管理します |

50| `/autofix-pr [prompt]` | 現在のブランチの PR を監視し、CI が失敗するか、レビュアーがコメントを残したときに修正をプッシュする [Claude Code on the web](/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 と [Claude Code on the web](/ja/claude-code-on-the-web#who-can-use-claude-code-on-the-web) へのアクセスが必要です |55| `/autofix-pr [prompt]` | 現在のブランチの PR を監視し、CI が失敗するか、レビュアーがコメントを残したときに修正をプッシュする [Claude Code on the web](/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 と [Claude Code on the web](/ja/claude-code-on-the-web) へのアクセスが必要です |

51| `/background [prompt]` | 現在のセッションをデタッチして[バックグラウンドエージェント](/ja/agent-view)として実行し、このターミナルを解放します。デタッチする前に 1 つ以上の指示を送信するためにプロンプトを渡します。`claude agents` でセッションを監視します。エイリアス: `/bg` |56| `/background [prompt]` | 現在のセッションをデタッチして[バックグラウンドエージェント](/ja/agent-view)として実行し、このターミナルを解放します。デタッチする前に 1 つ以上の指示を送信するためにプロンプトを渡します。`claude agents` でセッションを監視します。エイリアス: `/bg` |

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

53| `/branch [name]` | この時点で現在の会話のブランチを作成します。ブランチに切り替え、元の会話を保持します。`/resume` で戻ることができます。エイリアス: `/fork`。[`CLAUDE_CODE_FORK_SUBAGENT`](/ja/env-vars) が設定されている場合、`/fork` は代わりに[フォークされたサブエージェント](/ja/sub-agents#fork-the-current-conversation)を生成し、このコマンドのエイリアスではなくなります |58| `/branch [name]` | この時点で現在の会話のブランチを作成します。ブランチに切り替え、元の会話を保持します。`/resume` で戻ることができます。サイドタスクをバックグラウンドサブエージェントに渡す代わりに自分自身をコピーに切り替えるには、`/fork` を使用します |

54| `/btw <question>` | 会話に追加せずに[サイドクエスチョン](/ja/interactive-mode#side-questions-with-%2Fbtw)として素早く質問します |59| `/btw <question>` | 会話に追加せずに[サイドクエスチョン](/ja/interactive-mode#side-questions-with-%2Fbtw)として素早く質問します |

60| `/cd <path>` | {/* min-version: 2.1.169 */}このセッションを新しい作業ディレクトリに移動します。会話のプロンプトキャッシュは保持されます。新しいディレクトリの [`CLAUDE.md`](/ja/memory) はシステムプロンプトを再構築する代わりにメッセージとして追加されます。セッションは新しいディレクトリのプロジェクトストレージに再配置されるため、`--resume` と `--continue` はそこから見つかります。以前に作業していないディレクトリを信頼するよう求めます。セッションを移動せずに追加ディレクトリへのアクセスを許可するには、`/add-dir` を使用します。[`Cd` 権限ルール](/ja/permissions#cd)で `/cd` ターゲットを制限または無効にします。Claude Code v2.1.169 以降が必要です。以前のバージョンは `Unknown command: /cd` を報告します |

55| `/chrome` | [Chrome の Claude](/ja/chrome) 設定を構成します |61| `/chrome` | [Chrome の Claude](/ja/chrome) 設定を構成します |

56| `/claude-api [migrate\|managed-agents-onboard]` | **[スキル](/ja/skills#bundled-skills)。** プロジェクトの言語(Python、TypeScript、Java、Go、Ruby、C#、PHP、または cURL)と Managed Agents リファレンス用の Claude API リファレンス資料を読み込みます。ツール使用、ストリーミング、バッチ、構造化出力、および一般的な落とし穴をカバーしています。また、コードが `anthropic` または `@anthropic-ai/sdk` をインポートするときに自動的にアクティブになります。`/claude-api migrate` を実行して、既存の Claude API コードを新しいモデルにアップグレードします。Claude はスキャンするファイルとターゲットモデルを尋ね、モデル ID、思考設定、およびバージョン間で変更されたその他のパラメータを更新します。`/claude-api managed-agents-onboard` を実行して、新しい Managed Agent をゼロから作成するインタラクティブなウォークスルーを実施します |62| `/claude-api [migrate\|managed-agents-onboard]` | **[スキル](/ja/skills#bundled-skills)。** プロジェクトの言語(Python、TypeScript、Java、Go、Ruby、C#、PHP、または cURL)と Managed Agents リファレンス用の Claude API リファレンス資料を読み込みます。ツール使用、ストリーミング、バッチ、構造化出力、および一般的な落とし穴をカバーしています。また、コードが `anthropic` または `@anthropic-ai/sdk` をインポートするときに自動的にアクティブになります。`/claude-api migrate` を実行して、既存の Claude API コードを新しいモデルにアップグレードします。Claude はスキャンするファイルとターゲットモデルを尋ね、モデル ID、思考設定、およびバージョン間で変更されたその他のパラメータを更新します。`/claude-api managed-agents-onboard` を実行して、新しい Managed Agent をゼロから作成するインタラクティブなウォークスルーを実施します |

57| `/clear [name]` | 空のコンテキストで新しい会話を開始します。前の会話は `/resume` で利用可能なままです。前の会話にラベルを付けるために名前を渡します。`/resume` ピッカーで。同じ会話を続けながらコンテキストを解放するには、代わりに `/compact` を使用してください。エイリアス: `/reset`、`/new` |63| `/clear [name]` | 空のコンテキストで新しい会話を開始します。前の会話は `/resume` で利用可能なままです。前の会話にラベルを付けるために名前を渡します。`/resume` ピッカーで。同じ会話を続けながらコンテキストを解放するには、代わりに `/compact` を使用してください。エイリアス: `/reset`、`/new` |


74| `/feedback [report]` | フィードバックを送信し、バグを報告するか、会話を共有します。エイリアス: `/bug`、`/share` |80| `/feedback [report]` | フィードバックを送信し、バグを報告するか、会話を共有します。エイリアス: `/bug`、`/share` |

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

76| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、編集 diffstats を含む 1 行のツール呼び出し要約、および最終応答のみを表示します。選択は複数セッション間で保持されます。設定で [`viewMode`](/ja/settings#available-settings) を設定してオーバーライドします。[フルスクリーンレンダリング](/ja/fullscreen)でのみ利用可能です |82| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、編集 diffstats を含む 1 行のツール呼び出し要約、および最終応答のみを表示します。選択は複数セッション間で保持されます。設定で [`viewMode`](/ja/settings#available-settings) を設定してオーバーライドします。[フルスクリーンレンダリング](/ja/fullscreen)でのみ利用可能です |

83| `/fork <directive>` | {/* min-version: 2.1.161 */}[フォークされたサブエージェント](/ja/sub-agents#fork-the-current-conversation)を生成します。完全な会話を継承し、指示に対して作業するバックグラウンドサブエージェント。その結果は完了時に会話に戻ります。会話自体のコピーに切り替えるには、`/branch` を使用します。v2.1.161 より前では、`/fork` は `/branch` のエイリアスです |

77| `/goal [condition\|clear]` | [目標](/ja/goal)を設定します。Claude は条件が満たされるまでターン間で作業を続けます。引数なしで、現在または最後に達成された目標を表示します。`clear`、`stop`、`off`、`reset`、`none`、または `cancel` はアクティブな目標を早期に削除します |84| `/goal [condition\|clear]` | [目標](/ja/goal)を設定します。Claude は条件が満たされるまでターン間で作業を続けます。引数なしで、現在または最後に達成された目標を表示します。`clear`、`stop`、`off`、`reset`、`none`、または `cancel` はアクティブな目標を早期に削除します |

78| `/heapdump` | JavaScript ヒープスナップショットとメモリ分析を `~/Desktop` に書き込んで、高いメモリ使用量を診断します。Linux で Desktop フォルダがない場合はホームディレクトリに書き込みます。[トラブルシューティング](/ja/troubleshooting#high-cpu-or-memory-usage)を参照してください |85| `/heapdump` | JavaScript ヒープスナップショットとメモリ分析を `~/Desktop` に書き込んで、高いメモリ使用量を診断します。Linux で Desktop フォルダがない場合はホームディレクトリに書き込みます。[トラブルシューティング](/ja/troubleshooting#high-cpu-or-memory-usage)を参照してください |

79| `/help` | ヘルプと利用可能なコマンドを表示します |86| `/help` | ヘルプと利用可能なコマンドを表示します |


83| `/insights` | Claude Code セッションを分析するレポートを生成します。プロジェクト領域、相互作用パターン、および摩擦点を含みます |90| `/insights` | Claude Code セッションを分析するレポートを生成します。プロジェクト領域、相互作用パターン、および摩擦点を含みます |

84| `/install-github-app` | リポジトリ用の [Claude GitHub Actions](/ja/github-actions) アプリをセットアップします。リポジトリを選択して統合を構成するプロセスをガイドします |91| `/install-github-app` | リポジトリ用の [Claude GitHub Actions](/ja/github-actions) アプリをセットアップします。リポジトリを選択して統合を構成するプロセスをガイドします |

85| `/install-slack-app` | Claude Slack アプリをインストールします。OAuth フローを完了するためにブラウザを開きます |92| `/install-slack-app` | Claude Slack アプリをインストールします。OAuth フローを完了するためにブラウザを開きます |

86| `/keybindings` | キーバインディング設定ファイルを開くか作成します |93| `/keybindings` | キーバインディング設定ファイルを開きます |

87| `/login` | Anthropic アカウントにサインインします |94| `/login` | Anthropic アカウントにサインインします |

88| `/logout` | Anthropic アカウントからサインアウトします |95| `/logout` | Anthropic アカウントからサインアウトします |

89| `/loop [interval] [prompt]` | **[スキル](/ja/skills#bundled-skills)。** セッションが開いている間、プロンプトを繰り返し実行します。間隔を省略すると Claude は反復間で自動的にペースを調整します。プロンプトを省略すると、[利用可能な場合](/ja/scheduled-tasks#run-the-built-in-maintenance-prompt)、Claude は自律的なメンテナンスチェックを実行するか、`.claude/loop.md` のプロンプトを実行します。例: `/loop 5m check if the deploy finished`。[スケジュールに従ってプロンプトを実行](/ja/scheduled-tasks)を参照してください。エイリアス: `/proactive` |96| `/loop [interval] [prompt]` | **[スキル](/ja/skills#bundled-skills)。** セッションが開いている間、プロンプトを繰り返し実行します。間隔を省略すると Claude は反復間で自動的にペースを調整します。プロンプトを省略すると、[利用可能な場合](/ja/scheduled-tasks#run-the-built-in-maintenance-prompt)、Claude は自律的なメンテナンスチェックを実行するか、`.claude/loop.md` のプロンプトを実行します。例: `/loop 5m check if the deploy finished`。[スケジュールに従ってプロンプトを実行](/ja/scheduled-tasks)を参照してください。エイリアス: `/proactive` |

90| `/mcp` | MCP サーバー接続と OAuth 認証を管理します |97| `/mcp [reconnect <server>\|enable\|disable [<server>\|all]]` | MCP サーバー接続と OAuth 認証を管理します。引数なしで実行してインタラクティブリストを開くか、`reconnect <server>` を渡して 1 つの切断されたサーバーを再接続するか、`enable`/`disable` をサーバー名または `all` で渡してダイアログを開かずに接続状態を変更します |

91| `/memory` | `CLAUDE.md` メモリファイルを編集し、[自動メモリ](/ja/memory#auto-memory)を有効または無効にし、自動メモリエントリを表示します |98| `/memory` | `CLAUDE.md` メモリファイルを編集し、[自動メモリ](/ja/memory#auto-memory)を有効または無効にし、自動メモリエントリを表示します |

92| `/mobile` | Claude モバイルアプリをダウンロードするための QR コードを表示します。エイリアス: `/ios`、`/android` |99| `/mobile` | Claude モバイルアプリをダウンロードするための QR コードを表示します。エイリアス: `/ios`、`/android` |

93| `/model [model]` | AI モデルを切り替えて、新しいセッションのデフォルトとして保存します。サポートしているモデルの場合、左右矢印を使用して[努力レベルを調整](/ja/model-config#adjust-effort-level)します。引数なしで、ピッカーを開きます。`s` をピッカーの行で押して、現在のセッションのみのモデルを切り替えます。会話に前の出力がある場合、ピッカーは確認を求めます。次の応答はキャッシュされたコンテキストなしで完全な履歴を再読み込みするためです。確認されると、現在の応答の完了を待たずに変更が適用されます |100| `/model [model]` | AI モデルを切り替えて、新しいセッションのデフォルトとして保存します。サポートしているモデルの場合、左右矢印を使用して[努力レベルを調整](/ja/model-config#adjust-effort-level)します。引数なしで、ピッカーを開きます。`s` をピッカーの行で押して、現在のセッションのみのモデルを切り替えます。会話に前の出力がある場合、ピッカーは確認を求めます。次の応答はキャッシュされたコンテキストなしで完全な履歴を再読み込みするためです。確認されると、現在の応答の完了を待たずに変更が適用されます |

94| `/passes` | Claude Code の無料 1 週間を友人と共有します。アカウントが対象の場合のみ表示されます |101| `/passes` | Claude Code の無料 1 週間を友人と共有します。アカウントが対象の場合のみ表示されます |

95| `/permissions` | ツール権限のアクセス許可、確認、および拒否ルールを管理します。スコープ別にルールを表示し、ルールを追加または削除し、作業ディレクトリを管理し、[最近の自動モード拒否](/ja/auto-mode-config#review-denials)を確認できるインタラクティブダイアログを開きます。エイリアス: `/allowed-tools` |102| `/permissions` | ツール権限のアクセス許可、確認、および拒否ルールを管理します。スコープ別にルールを表示し、ルールを追加または削除し、作業ディレクトリを管理し、[最近の自動モード拒否](/ja/auto-mode-config#review-denials)を確認できるインタラクティブダイアログを開きます。エイリアス: `/allowed-tools` |

96| `/plan [description]` | プロンプトから直接 Plan Mode に入ります。オプションの説明を渡して Plan Mode に入り、すぐにそのタスクで開始します。例えば `/plan fix the auth bug` |103| `/plan [description]` | プロンプトから直接 Plan Mode に入ります。オプションの説明を渡して Plan Mode に入り、すぐにそのタスクで開始します。例えば `/plan fix the auth bug` |

97| `/plugin` | Claude Code [プラグイン](/ja/plugins)を管理します |104| `/plugin [subcommand]` | Claude Code [プラグイン](/ja/plugins)を管理します。引数なしで実行してプラグインメニューを開くか、`list`、`install`、`enable`、`disable` などのサブコマンドを渡して直接実行します |

98| `/powerup` | アニメーション化されたデモを使用したクイックインタラクティブレッスンを通じて Claude Code 機能を発見します |105| `/powerup` | アニメーション化されたデモを使用したクイックインタラクティブレッスンを通じて Claude Code 機能を発見します |

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

100| `/privacy-settings` | プライバシー設定を表示および更新します。Pro および Max プランサブスクライバーのみ利用可能です |107| `/privacy-settings` | プライバシー設定を表示および更新します。Pro および Max プランサブスクライバーのみ利用可能です |

101| `/radio` | Claude FM lo-fi ラジオをブラウザで開きます。ブラウザが利用できない場合、ストリーム URL を出力します。Bedrock、Vertex、または Foundry では利用できません |108| `/radio` | Claude FM lo-fi ラジオをブラウザで開きます。ブラウザが利用できない場合、ストリーム URL を出力します。Bedrock、Vertex、または Foundry では利用できません |

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

103| `/release-notes` | インタラクティブバージョンピッカーでチェンジログを表示します。特定のバージョンを選択してそのリリースノートを表示するか、すべてのバージョンを表示することを選択します |110| `/release-notes` | インタラクティブバージョンピッカーでチェンジログを表示します。特定のバージョンを選択してそのリリースノートを表示するか、すべてのバージョンを表示することを選択します |

104| `/reload-plugins` | すべてのアクティブな[プラグイン](/ja/plugins)を再読み込みして、再起動せずに保留中の変更を適用します。読み込まれた各コンポーネントのカウントを報告し、読み込みエラーをフラグします |111| `/reload-plugins [--force]` | すべてのアクティブな[プラグイン](/ja/plugins)を再読み込みして、再起動せずに保留中の変更を適用します。読み込まれた各コンポーネントのカウントを報告し、読み込みエラーをフラグします。再読み込みが読み込まれた MCP ツールを変更し、プロンプトキャッシュを無効にする場合、コマンドは警告を表示し、`--force` を渡さない限りスキップします |

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

106| `/remote-control` | このセッションを claude.ai から[リモートコントロール](/ja/remote-control)できるようにします。エイリアス: `/rc` |113| `/remote-control` | このセッションを claude.ai から[リモートコントロール](/ja/remote-control)できるようにします。エイリアス: `/rc` |

107| `/remote-env` | [`--remote` で開始されたウェブセッション](/ja/claude-code-on-the-web#configure-your-environment)のデフォルトリモート環境を構成します |114| `/remote-env` | [クラウドエージェント](/ja/claude-code-on-the-web#configure-your-environment)のデフォルト環境を選択します |

108| `/rename [name]` | 現在のセッションの名前を変更してプロンプトバーに名前を表示します。名前を指定しない場合、会話履歴から自動生成されます |115| `/rename [name]` | 現在のセッションの名前を変更してプロンプトバーに名前を表示します。名前を指定しない場合、会話履歴から自動生成されます |

109| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。v2.1.144 以降、[バックグラウンドセッション](/ja/agent-view)はピッカーに `bg` とマークされて表示されます。エイリアス: `/continue` |116| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。v2.1.144 以降、[バックグラウンドセッション](/ja/agent-view)はピッカーに `bg` とマークされて表示されます。エイリアス: `/continue` |

110| `/review [PR]` | 現在のセッションでプルリクエストをローカルでレビューします。より深いクラウドベースのレビューについては、[`/code-review ultra`](/ja/ultrareview)を参照してください |117| `/review [PR]` | 現在のセッションでプルリクエストをローカルでレビューします。より深いクラウドベースのレビューについては、[`/code-review ultra`](/ja/ultrareview)を参照してください |


124| `/statusline` | Claude Code の[ステータスライン](/ja/statusline)を構成します。必要な内容を説明するか、引数なしで実行してシェルプロンプトから自動構成します |131| `/statusline` | Claude Code の[ステータスライン](/ja/statusline)を構成します。必要な内容を説明するか、引数なしで実行してシェルプロンプトから自動構成します |

125| `/stickers` | Claude Code ステッカーを注文します |132| `/stickers` | Claude Code ステッカーを注文します |

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

127| `/tasks` | バックグラウンドタスクをリストおよび管理します。`/bashes` としても利用可能です |134| `/tasks` | バックグラウンドで実行されているすべてのものを表示および管理します。`/bashes` としても利用可能です |

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

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

130| `/terminal-setup` | Shift+Enter およびその他のショートカットのターミナルキーバインディングを構成します。VS Code、Cursor、Devin Desktop、Alacritty、または Zed などの必要なターミナルでのみ表示されます |137| `/terminal-setup` | Shift+Enter およびその他のショートカットのターミナルキーバインディングを構成します。VS Code、Cursor、Devin Desktop、Alacritty、または Zed などの必要なターミナルでのみ表示されます |


141| `/web-setup` | ローカル `gh` CLI 認証情報を使用して GitHub アカウントを [Claude Code on the web](/ja/web-quickstart#connect-from-your-terminal) に接続します。GitHub が接続されていない場合、`/schedule` は自動的にこれを求めます |148| `/web-setup` | ローカル `gh` CLI 認証情報を使用して GitHub アカウントを [Claude Code on the web](/ja/web-quickstart#connect-from-your-terminal) に接続します。GitHub が接続されていない場合、`/schedule` は自動的にこれを求めます |

142| `/workflows` | [ワークフロー](/ja/workflows#watch-the-run)進捗ビューを開いて、実行中および完了したワークフローを監視、一時停止、再開、または保存します |149| `/workflows` | [ワークフロー](/ja/workflows#watch-the-run)進捗ビューを開いて、実行中および完了したワークフローを監視、一時停止、再開、または保存します |

143 150 

144## MCP プロンプト151<h2 id="mcp-prompts">

152 MCP プロンプト

153</h2>

145 154 

146MCP サーバーはコマンドとして表示されるプロンプトを公開できます。これらは `/mcp__<server>__<prompt>` 形式を使用し、接続されたサーバーから動的に検出されます。詳細については、[MCP プロンプト](/ja/mcp#use-mcp-prompts-as-commands)を参照してください。155MCP サーバーはコマンドとして表示されるプロンプトを公開できます。これらは `/mcp__<server>__<prompt>` 形式を使用し、接続されたサーバーから動的に検出されます。詳細については、[MCP プロンプト](/ja/mcp#use-mcp-prompts-as-commands)を参照してください。

147 156 

148## 関連項目157<h2 id="see-also">

158 関連項目

159</h2>

149 160 

150* [スキル](/ja/skills): 独自のコマンドを作成161* [スキル](/ja/skills): 独自のコマンドを作成

151* [インタラクティブモード](/ja/interactive-mode): キーボードショートカット、Vim モード、およびコマンド履歴162* [インタラクティブモード](/ja/interactive-mode): キーボードショートカット、Vim モード、およびコマンド履歴

Details

234レビューのためのデフォルトの主力です。大規模なリファクタリング、複雑な234レビューのためのデフォルトの主力です。大規模なリファクタリング、複雑な

235デバッグ、または高リスクなものに対して *Opus* に手を伸ばしてください。235デバッグ、または高リスクなものに対して *Opus* に手を伸ばしてください。

236速度が重要な迅速な質問、フォーマット、機械的な編集に対して *Haiku* に236速度が重要な迅速な質問、フォーマット、機械的な編集に対して *Haiku* に

237ドロップしてください。237ドロップしてください。*Fable 5* は、最も難しく、最も長時間実行される

238タスクに対して最も能力の高いモデルです。これはデフォルトではないため、

239`/model fable` で選択してください。サイバーセキュリティとバイオロジー

240コンテンツは自動的に Opus にフォールバックすることに注意してください。

238 241 

239*今すぐ試す:* `/model` を入力し、まだ選択していない場合は Sonnet を242*今すぐ試す:* `/model` を入力し、まだ選択していない場合は Sonnet を

240選択してください。これはほとんどのタスクの正しいデフォルトです。243選択してください。これはほとんどのタスクの正しいデフォルトです。


243```246```

244 247 

245| モデル | 最適な用途 |248| モデル | 最適な用途 |

246| ------ | ----------------------------------------- |249| ------- | ----------------------------------------------------------------------------------------------------------------------------------------- |

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

247| Opus | 大規模なリファクタリング、複雑なデバッグ、アーキテクチャの決定、高リスクな変更 |251| Opus | 大規模なリファクタリング、複雑なデバッグ、アーキテクチャの決定、高リスクな変更 |

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

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


411机に座って Claude が長いタスクを処理するのを見ていますか?その 8 分間415机に座って Claude が長いタスクを処理するのを見ていますか?その 8 分間

412やることがあります。416やることがあります。

413 417 

414フック は Claude Code イベントで発火するシェルコマンドです。デスクトップ418フックは Claude Code イベントで発火するシェルコマンドです。デスクトップ

415通知を送信する Stop フック は、長いリファクタリングを開始し、立ち去り、419通知を送信する Stop フックは、長いリファクタリングを開始し、立ち去り、

416完了した瞬間にピングを受け取ることができることを意味します。420完了した瞬間にピングを受け取ることができることを意味します。

417 421 

418*今すぐ試す:* Claude に「完了したときにデスクトップ通知を送信する Stop422*今すぐ試す:* Claude に「完了したときにデスクトップ通知を送信する Stop


452修正に 5 分かかりました。コミットメッセージ、ブランチ、PR の説明に 15 分456修正に 5 分かかりました。コミットメッセージ、ブランチ、PR の説明に 15 分

453かかりました。その比率は間違っています。457かかりました。その比率は間違っています。

454 458 

455Claude は完全な git フロー を処理します。従来のメッセージを含むコミット、459Claude は完全な git フローを処理します。従来のメッセージを含むコミット、

456ブランチ、適切な要約を含む PR。1 つの要求:「off-by-one を修正し、460ブランチ、適切な要約を含む PR。1 つの要求:「off-by-one を修正し、

457従来のコミットメッセージでコミットし、PR を開いてください」。他の人の461従来のコミットメッセージでコミットし、PR を開いてください」。他の人の

458作業をレビューしていますか?PR URL を貼り付けて、Claude に diff を462作業をレビューしていますか?PR URL を貼り付けて、Claude に diff を

computer-use.md +61 −21

Details

16 16 

17このページでは、CLI でコンピュータ使用がどのように機能するかについて説明します。Desktop アプリについては、[Desktop でのコンピュータ使用](/ja/desktop#let-claude-use-your-computer)を参照してください。17このページでは、CLI でコンピュータ使用がどのように機能するかについて説明します。Desktop アプリについては、[Desktop でのコンピュータ使用](/ja/desktop#let-claude-use-your-computer)を参照してください。

18 18 

19## コンピュータ使用でできること19<h2 id="what-you-can-do-with-computer-use">

20 コンピュータ使用でできること

21</h2>

20 22 

21コンピュータ使用は GUI が必要なタスクを処理します。通常、ターミナルを離れて手動で行う必要があるすべてのことです。23コンピュータ使用は GUI が必要なタスクを処理します。通常、ターミナルを離れて手動で行う必要があるすべてのことです。

22 24 


25* **ビジュアルとレイアウトの問題をデバッグ**: Claude に「モーダルが小さいウィンドウでクリップしている」と伝えます。Claude はウィンドウをリサイズし、バグを再現し、スクリーンショットを撮り、CSS にパッチを当て、修正を検証します。Claude はあなたが見るものを見ます。27* **ビジュアルとレイアウトの問題をデバッグ**: Claude に「モーダルが小さいウィンドウでクリップしている」と伝えます。Claude はウィンドウをリサイズし、バグを再現し、スクリーンショットを撮り、CSS にパッチを当て、修正を検証します。Claude はあなたが見るものを見ます。

26* **GUI のみのツールを駆動**: デザインツール、ハードウェアコントロールパネル、iOS Simulator、または CLI や API がない独自のアプリと対話します。28* **GUI のみのツールを駆動**: デザインツール、ハードウェアコントロールパネル、iOS Simulator、または CLI や API がない独自のアプリと対話します。

27 29 

28## コンピュータ使用が適用される場合30<h2 id="when-computer-use-applies">

31 コンピュータ使用が適用される場合

32</h2>

29 33 

30Claude はアプリやサービスと対話するいくつかの方法があります。コンピュータ使用は最も広く、最も遅いため、Claude は最初に最も正確なツールを試します。34Claude はアプリやサービスと対話するいくつかの方法があります。コンピュータ使用は最も広く、最も遅いため、Claude は最初に最も正確なツールを試します。

31 35 


36 40 

37スクリーン制御は、他に何も到達できないもの(ネイティブアプリ、シミュレータ、API のないツール)のために予約されています。41スクリーン制御は、他に何も到達できないもの(ネイティブアプリ、シミュレータ、API のないツール)のために予約されています。

38 42 

39## コンピュータ使用を有効にする43<h2 id="enable-computer-use">

44 コンピュータ使用を有効にする

45</h2>

40 46 

41コンピュータ使用は `computer-use` という組み込み MCP サーバーとして利用可能です。有効にするまでデフォルトではオフです。47コンピュータ使用は `computer-use` という組み込み MCP サーバーとして利用可能です。有効にするまでデフォルトではオフです。

42 48 


72sure nothing crashes. Screenshot any error states you find.78sure nothing crashes. Screenshot any error states you find.

73```79```

74 80 

75## セッションごとにアプリを承認する81<h2 id="approve-apps-per-session">

82 セッションごとにアプリを承認する

83</h2>

76 84 

77`computer-use` サーバーを有効にしても、Claude にマシン上のすべてのアプリへのアクセスが許可されるわけではありません。Claude がセッション内で特定のアプリを初めて必要とする場合、ターミナルにプロンプトが表示され、以下が示されます。85`computer-use` サーバーを有効にしても、Claude にマシン上のすべてのアプリへのアクセスが許可されるわけではありません。Claude がセッション内で特定のアプリを初めて必要とする場合、ターミナルにプロンプトが表示され、以下が示されます。

78 86 


90| 任意のファイルを読み取りまたは書き込みできます | Finder |98| 任意のファイルを読み取りまたは書き込みできます | Finder |

91| システム設定を変更できます | System Settings |99| システム設定を変更できます | System Settings |

92 100 

93これらのアプリはブロックされていません。警告により、タスクがそのレベルのアクセスを保証するかどうかを決定できます101これらのアプリはブロックされていません。警告により、タスクがそのレベルのアクセスを必要とするかどうかを決定できます

94 102 

95Claude の制御レベルはアプリカテゴリによっても異なります。ブラウザと取引プラットフォームはビューのみ、ターミナルと IDE はクリックのみ、その他すべてはフルコントロールを取得します。完全なティア分類については、[Desktop でのアプリのアクセス許可](/ja/desktop#app-permissions)を参照してください。103Claude の制御レベルはアプリカテゴリによっても異なります。ブラウザと取引プラットフォームはビューのみ、ターミナルと IDE はクリックのみ、その他すべてはフルコントロールを取得します。完全なティア分類については、[Desktop でのアプリのアクセス許可](/ja/desktop#app-permissions)を参照してください。

96 104 

97## Claude がスクリーンでどのように機能するか105<h2 id="how-claude-works-on-your-screen">

106 Claude がスクリーンでどのように機能するか

107</h2>

98 108 

99フローを理解することで、Claude が何をするかを予測し、どのように介入するかを理解するのに役立ちます。109フローを理解することで、Claude が何をするかを予測し、どのように介入するかを理解するのに役立ちます。

100 110 

101### 一度に 1 つのセッション111<h3 id="one-session-at-a-time">

112 一度に 1 つのセッション

113</h3>

102 114 

103コンピュータ使用は、アクティブ中にマシン全体のロックを保持します。別の Claude Code セッションが既にコンピュータを使用している場合、新しい試みはロックを保持しているセッションを示すメッセージで失敗します。最初にそのセッションを終了または終了します。115コンピュータ使用は、アクティブ中にマシン全体のロックを保持します。別の Claude Code セッションが既にコンピュータを使用している場合、新しい試みはロックを保持しているセッションを示すメッセージで失敗します。最初にそのセッションを終了または終了します。

104 116 

105### Claude が作業している間、アプリは非表示になります117<h3 id="apps-are-hidden-while-claude-works">

118 Claude が作業している間、アプリは非表示になります

119</h3>

106 120 

107Claude がスクリーンの制御を開始すると、他の表示されているアプリは非表示になり、Claude は承認されたアプリのみと対話します。ターミナルウィンドウは表示されたままで、スクリーンショットから除外されるため、セッションを監視でき、Claude は独自の出力を見ることはありません。121Claude がスクリーンの制御を開始すると、他の表示されているアプリは非表示になり、Claude は承認されたアプリのみと対話します。ターミナルウィンドウは表示されたままで、スクリーンショットから除外されるため、セッションを監視でき、Claude は独自の出力を見ることはありません。

108 122 

109Claude がターンを終了すると、非表示のアプリは自動的に復元されます。123Claude がターンを終了すると、非表示のアプリは自動的に復元されます。

110 124 

111### スクリーンショットは自動的にダウンスケールされます125<h3 id="screenshots-are-downscaled-automatically">

126 スクリーンショットは自動的にダウンスケールされます

127</h3>

112 128 

113Claude Code はモデルに送信する前に、すべてのスクリーンショットをダウンスケールします。Retina またはその他の高解像度ディスプレイでディスプレイ解像度を下げたり、ウィンドウをリサイズしたりする必要はありません。16 インチ MacBook Pro をネイティブ Retina 解像度でキャプチャすると 3456×2234 でキャプチャされ、約 1372×887 にダウンスケールされ、アスペクト比が保持されます。129Claude Code はモデルに送信する前に、すべてのスクリーンショットをダウンスケールします。Retina またはその他の高解像度ディスプレイでディスプレイ解像度を下げたり、ウィンドウをリサイズしたりする必要はありません。16 インチ MacBook Pro をネイティブ Retina 解像度でキャプチャすると 3456×2234 でキャプチャされ、約 1372×887 にダウンスケールされ、アスペクト比が保持されます。

114 130 

115ターゲットサイズを変更する設定はありません。ダウンスケール後、オンスクリーンテキストまたはコントロールが Claude が読むには小さすぎる場合は、ディスプレイ解像度を変更するのではなく、アプリでそれらのサイズを増やします。131ターゲットサイズを変更する設定はありません。ダウンスケール後、オンスクリーンテキストまたはコントロールが Claude が読むには小さすぎる場合は、ディスプレイ解像度を変更するのではなく、アプリでそれらのサイズを増やします。

116 132 

117### いつでも停止133<h3 id="stop-at-any-time">

134 いつでも停止

135</h3>

118 136 

119Claude がロックを取得すると、macOS 通知が表示されます。「Claude is using your computer · press Esc to stop」。どこからでも `Esc` を押して現在のアクションを直ちに中止するか、ターミナルで `Ctrl+C` を押します。どちらの方法でも、Claude はロックを解放し、アプリを表示し、制御をあなたに返します。137Claude がロックを取得すると、macOS 通知が表示されます。「Claude is using your computer · press Esc to stop」。どこからでも `Esc` を押して現在のアクションを直ちに中止するか、ターミナルで `Ctrl+C` を押します。どちらの方法でも、Claude はロックを解放し、アプリを表示し、制御をあなたに返します。

120 138 

121Claude が完了したときに 2 番目の通知が表示されます。139Claude が完了したときに 2 番目の通知が表示されます。

122 140 

123## セーフティと信頼の境界141<h2 id="safety-and-the-trust-boundary">

142 セーフティと信頼の境界

143</h2>

124 144 

125<Warning>145<Warning>

126 [サンドボックス化された Bash ツール](/ja/sandboxing)とは異なり、コンピュータ使用は実際のデスクトップで実行され、承認したアプリへのアクセスがあります。Claude は各アクションをチェックし、オンスクリーンコンテンツからの潜在的なプロンプトインジェクションにフラグを立てますが、信頼の境界は異なります。ベストプラクティスについては、[コンピュータ使用セーフティガイド](https://support.claude.com/en/articles/14128542)を参照してください。146 [サンドボックス化された Bash ツール](/ja/sandboxing)とは異なり、コンピュータ使用は実際のデスクトップで実行され、承認したアプリへのアクセスがあります。Claude は各アクションをチェックし、オンスクリーンコンテンツからの潜在的なプロンプトインジェクションにフラグを立てますが、信頼の境界は異なります。ベストプラクティスについては、[コンピュータ使用セーフティガイド](https://support.claude.com/en/articles/14128542)を参照してください。


134* **グローバルエスケープ**: `Esc` キーはどこからでもコンピュータ使用を中止し、キープレスは消費されるため、プロンプトインジェクションはそれを使用してダイアログを閉じることはできません。154* **グローバルエスケープ**: `Esc` キーはどこからでもコンピュータ使用を中止し、キープレスは消費されるため、プロンプトインジェクションはそれを使用してダイアログを閉じることはできません。

135* **ロックファイル**: 一度に 1 つのセッションのみがマシンを制御できます。155* **ロックファイル**: 一度に 1 つのセッションのみがマシンを制御できます。

136 156 

137## ワークフロー例157<h2 id="example-workflows">

158 ワークフロー例

159</h2>

138 160 

139これらの例は、コンピュータ使用とコーディングタスクを組み合わせる一般的な方法を示しています。161これらの例は、コンピュータ使用とコーディングタスクを組み合わせる一般的な方法を示しています。

140 162 

141### ネイティブビルドを検証する163<h3 id="validate-a-native-build">

164 ネイティブビルドを検証する

165</h3>

142 166 

143macOS または iOS アプリに変更を加えた後、Claude にコンパイルして 1 回のパスで検証させます。167macOS または iOS アプリに変更を加えた後、Claude にコンパイルして 1 回のパスで検証させます。

144 168 


150 174 

151Claude は `xcodebuild` を実行し、アプリを起動し、UI と対話し、見つけたものを報告します。175Claude は `xcodebuild` を実行し、アプリを起動し、UI と対話し、見つけたものを報告します。

152 176 

153### レイアウトバグを再現する177<h3 id="reproduce-a-layout-bug">

178 レイアウトバグを再現する

179</h3>

154 180 

155ビジュアルバグが特定のウィンドウサイズでのみ表示される場合、Claude に見つけさせます。181ビジュアルバグが特定のウィンドウサイズでのみ表示される場合、Claude に見つけさせます。

156 182 


162 188 

163Claude はウィンドウをリサイズし、壊れた状態をキャプチャし、関連するスタイルシートを読みます。189Claude はウィンドウをリサイズし、壊れた状態をキャプチャし、関連するスタイルシートを読みます。

164 190 

165### シミュレータフローをテストする191<h3 id="test-a-simulator-flow">

192 シミュレータフローをテストする

193</h3>

166 194 

167XCTest を書かずに iOS Simulator を駆動します。195XCTest を書かずに iOS Simulator を駆動します。

168 196 


173 201 

174Claude はマウスを使用するのと同じ方法でシミュレータを制御します。202Claude はマウスを使用するのと同じ方法でシミュレータを制御します。

175 203 

176## Desktop アプリとの違い204<h2 id="differences-from-the-desktop-app">

205 Desktop アプリとの違い

206</h2>

177 207 

178CLI と Desktop サーフェスは同じコンピュータ使用エンジンを共有します。いくつかの違いがあります。208CLI と Desktop サーフェスは同じコンピュータ使用エンジンを共有します。いくつかの違いがあります。

179 209 


185| 自動非表示トグル | オプション | 常にオン |215| 自動非表示トグル | オプション | 常にオン |

186| Dispatch 統合 | Dispatch で生成されたセッションはコンピュータ使用を使用できます | 適用されません |216| Dispatch 統合 | Dispatch で生成されたセッションはコンピュータ使用を使用できます | 適用されません |

187 217 

188## トラブルシューティング218<h2 id="troubleshooting">

219 トラブルシューティング

220</h2>

189 221 

190### 「Computer use is in use by another Claude session222<h3 id="computer-use-is-in-use-by-another-claude-session">

223 「Computer use is in use by another Claude session」

224</h3>

191 225 

192別の Claude Code セッションがロックを保持しています。そのセッションでタスクを終了するか、終了します。他のセッションがクラッシュした場合、Claude がプロセスがもう実行されていないことを検出すると、ロックは自動的に解放されます。226別の Claude Code セッションがロックを保持しています。そのセッションでタスクを終了するか、終了します。他のセッションがクラッシュした場合、Claude がプロセスがもう実行されていないことを検出すると、ロックは自動的に解放されます。

193 227 

194### macOS のアクセス許可プロンプトが繰り返し表示される228<h3 id="macos-permissions-prompt-keeps-reappearing">

229 macOS のアクセス許可プロンプトが繰り返し表示される

230</h3>

195 231 

196macOS は、Screen Recording を付与した後、リクエストプロセスの再起動が必要な場合があります。Claude Code を完全に終了し、新しいセッションを開始します。プロンプトが続く場合は、**System Settings > Privacy & Security > Screen Recording** を開き、ターミナルアプリがリストされ、有効になっていることを確認します。232macOS は、Screen Recording を付与した後、リクエストプロセスの再起動が必要な場合があります。Claude Code を完全に終了し、新しいセッションを開始します。プロンプトが続く場合は、**System Settings > Privacy & Security > Screen Recording** を開き、ターミナルアプリがリストされ、有効になっていることを確認します。

197 233 

198### `computer-use` が `/mcp` に表示されない234<h3 id="computer-use-doesn’t-appear-in-/mcp">

235 `computer-use` が `/mcp` に表示されない

236</h3>

199 237 

200サーバーは適格なセットアップにのみ表示されます。以下を確認してください。238サーバーは適格なセットアップにのみ表示されます。以下を確認してください。

201 239 


205* claude.ai を通じて認証されています。コンピュータ使用は Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry などのサードパーティプロバイダーでは利用できません。サードパーティプロバイダーのみを通じて Claude にアクセスする場合、この機能を使用するには別の claude.ai アカウントが必要です。243* claude.ai を通じて認証されています。コンピュータ使用は Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry などのサードパーティプロバイダーでは利用できません。サードパーティプロバイダーのみを通じて Claude にアクセスする場合、この機能を使用するには別の claude.ai アカウントが必要です。

206* インタラクティブセッションを使用しています。コンピュータ使用は `-p` フラグを使用した非インタラクティブモードでは利用できません。244* インタラクティブセッションを使用しています。コンピュータ使用は `-p` フラグを使用した非インタラクティブモードでは利用できません。

207 245 

208## 関連項目246<h2 id="see-also">

247 関連項目

248</h2>

209 249 

210* [Desktop でのコンピュータ使用](/ja/desktop#let-claude-use-your-computer): グラフィカル設定ページを備えた同じ機能250* [Desktop でのコンピュータ使用](/ja/desktop#let-claude-use-your-computer): グラフィカル設定ページを備えた同じ機能

211* [Chrome の Claude](/ja/chrome): Web ベースのタスク用のブラウザ自動化251* [Chrome の Claude](/ja/chrome): Web ベースのタスク用のブラウザ自動化

context-window.md +1592 −6

Details

6 6 

7> Claude Code のコンテキストウィンドウがセッション中にどのように満たされるかのインタラクティブなシミュレーション。自動的に読み込まれるもの、各ファイル読み込みのコスト、ルールとフックが発火するタイミングを確認できます。7> Claude Code のコンテキストウィンドウがセッション中にどのように満たされるかのインタラクティブなシミュレーション。自動的に読み込まれるもの、各ファイル読み込みのコスト、ルールとフックが発火するタイミングを確認できます。

8 8 

9Claude Code のコンテキストウィンドウには、セッションについて Claude が知っているすべてのものが含まれます。つまり、あなたの指示、読み込まれたファイル、Claude 自身の応答、およびターミナルに表示されないコンテンツです。以下のタイムラインは、何が読み込まれ、いつ読み込まれるかを説明します。[書かれた説明](#what-the-timeline-shows)で同じコンテンツをリストとして確認できます。9export const ContextWindow = () => {

10 const MAX = 200000;

11 const STARTUP_END = 0.2;

12 {}

13 const EVENTS = useMemo(() => [{}, {

14 t: 0.015,

15 kind: 'auto',

16 label: 'System prompt',

17 tokens: 4200,

18 color: '#6B6964',

19 vis: 'hidden',

20 desc: 'Core instructions for behavior, tool use, and response formatting. Always loaded first. You never see it.',

21 link: null

22 }, {

23 t: 0.035,

24 kind: 'auto',

25 label: 'Auto memory (MEMORY.md)',

26 tokens: 680,

27 color: '#E8A45C',

28 vis: 'hidden',

29 desc: "Claude's notes to itself from previous sessions: build commands it learned, patterns it noticed, mistakes to avoid. The first 200 lines or 25KB, whichever comes first, are loaded into the conversation context.",

30 link: '/en/memory#auto-memory'

31 }, {

32 t: 0.06,

33 kind: 'auto',

34 label: 'Environment info',

35 tokens: 280,

36 color: '#6B6964',

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.',

39 link: null

40 }, {

41 t: 0.08,

42 kind: 'auto',

43 label: 'MCP tools (deferred)',

44 tokens: 120,

45 color: '#9B7BC4',

46 vis: 'hidden',

47 desc: 'MCP tool names listed so Claude knows what is available. By default, full schemas stay deferred and Claude loads specific ones on demand via tool search when a task needs them. Set `ENABLE_TOOL_SEARCH=auto` to load schemas upfront when they fit within 10% of the context window, or `ENABLE_TOOL_SEARCH=false` to load everything.',

48 link: '/en/mcp#scale-with-mcp-tool-search'

49 }, {

50 t: 0.1,

51 kind: 'auto',

52 label: 'Skill descriptions',

53 tokens: 450,

54 color: '#D4A843',

55 vis: 'hidden',

56 noSurviveCompact: true,

57 desc: 'One-line descriptions of available skills so Claude knows what it can invoke. Full skill content loads only when Claude actually uses one. Skills with `disable-model-invocation: true` are not in this list. They stay completely out of context until you invoke them with `/name`. Unlike the rest of the startup content, this listing is not re-injected after `/compact`. Only skills you actually invoked get preserved.',

58 link: '/en/skills'

59 }, {

60 t: 0.12,

61 kind: 'auto',

62 label: '~/.claude/CLAUDE.md',

63 tokens: 320,

64 color: '#6A9BCC',

65 vis: 'hidden',

66 desc: 'Your global preferences. Applies to every project. Loaded alongside project instructions at the start of every conversation.',

67 link: '/en/memory#choose-where-to-put-claude-md-files'

68 }, {

69 t: 0.14,

70 kind: 'auto',

71 label: 'Project CLAUDE.md',

72 tokens: 1800,

73 color: '#6A9BCC',

74 vis: 'hidden',

75 desc: 'Project conventions, build commands, architecture notes. The most important file you can create. Lives in your project root, so your whole team gets the same instructions.',

76 tip: 'Keep it under 200 lines. Move reference content to skills or path-scoped rules so it only loads when needed.',

77 link: '/en/memory'

78 }, {}, {

79 t: 0.22,

80 kind: 'user',

81 label: 'Your prompt',

82 tokens: 45,

83 color: '#558A42',

84 vis: 'full',

85 desc: '"Fix the auth bug where users get 401 after token refresh"',

86 link: null

87 }, {}, {

88 t: 0.28,

89 kind: 'claude',

90 label: 'Read src/api/auth.ts',

91 tokens: 2400,

92 color: '#8A8880',

93 vis: 'brief',

94 desc: 'Main auth file. You see "Read auth.ts" in your terminal, but the 2,400 tokens of file content only Claude sees.',

95 tip: 'File reads dominate context usage. Be specific in prompts ("fix the bug in auth.ts") so Claude reads fewer files. For research-heavy tasks, use a subagent.',

96 link: null

97 }, {

98 t: 0.32,

99 kind: 'claude',

100 label: 'Read src/lib/tokens.ts',

101 tokens: 1100,

102 color: '#8A8880',

103 vis: 'brief',

104 desc: 'Following imports to the token module. Shown as a one-liner in your terminal.',

105 link: null

106 }, {

107 t: 0.35,

108 kind: 'auto',

109 label: 'Rule: api-conventions.md',

110 tokens: 380,

111 color: '#4A9B8E',

112 vis: 'brief',

113 desc: 'This rule in `.claude/rules/` has a `paths:` pattern matching `src/api/**`. It loaded automatically when Claude read a file in that directory. You see "Loaded .claude/rules/api-conventions.md" in your terminal, but not the rule content.',

114 link: '/en/memory#path-specific-rules'

115 }, {

116 t: 0.38,

117 kind: 'claude',

118 label: 'Read middleware.ts',

119 tokens: 1800,

120 color: '#8A8880',

121 vis: 'brief',

122 desc: 'Tracing the auth flow deeper.',

123 link: null

124 }, {

125 t: 0.41,

126 kind: 'claude',

127 label: 'Read auth.test.ts',

128 tokens: 1600,

129 color: '#8A8880',

130 vis: 'brief',

131 desc: 'Checking existing tests for expected behavior.',

132 link: null

133 }, {

134 t: 0.44,

135 kind: 'auto',

136 label: 'Rule: testing.md',

137 tokens: 290,

138 color: '#4A9B8E',

139 vis: 'brief',

140 desc: 'Another path-scoped rule, this one matching `*.test.ts` files. Triggered when Claude read auth.test.ts. Shown as a one-line "Loaded" notice.',

141 link: '/en/memory#path-specific-rules'

142 }, {

143 t: 0.47,

144 kind: 'claude',

145 label: 'grep "refreshToken"',

146 tokens: 600,

147 color: '#A09E96',

148 vis: 'brief',

149 desc: 'Search results across the codebase. You see the command ran, not the full output.',

150 link: null

151 }, {}, {

152 t: 0.53,

153 kind: 'claude',

154 label: "Claude's analysis",

155 tokens: 800,

156 color: '#D97757',

157 vis: 'full',

158 desc: 'Explains the bug: token invalidated too early in the rotation. This text appears in your terminal.',

159 link: null

160 }, {

161 t: 0.57,

162 kind: 'claude',

163 label: 'Edit auth.ts',

164 tokens: 400,

165 color: '#D97757',

166 vis: 'full',

167 desc: 'Fixes the token rotation order. The diff appears in your terminal.',

168 link: null

169 }, {

170 t: 0.59,

171 kind: 'hook',

172 label: 'Hook: prettier',

173 tokens: 120,

174 color: '#B8860B',

175 vis: 'hidden',

176 desc: 'A PostToolUse hook in `settings.json` runs prettier after every file edit and reports back via `hookSpecificOutput.additionalContext`. That field enters Claude\'s context. Plain stdout on exit 0 does not. It is written to the debug log only.',

177 tip: 'Output JSON with `additionalContext` to send info to Claude. For PostToolUse hooks, exit code 2 surfaces stderr as an error but cannot block since the tool already ran. Keep output concise since it enters context without truncation.',

178 link: '/en/hooks-guide'

179 }, {

180 t: 0.62,

181 kind: 'claude',

182 label: 'Edit auth.test.ts',

183 tokens: 600,

184 color: '#D97757',

185 vis: 'full',

186 desc: 'Adds a regression test for the fix. The diff appears in your terminal.',

187 link: null

188 }, {

189 t: 0.64,

190 kind: 'hook',

191 label: 'Hook: prettier',

192 tokens: 100,

193 color: '#B8860B',

194 vis: 'hidden',

195 desc: 'The same hook fires again for the test file. Every matching tool event triggers it.',

196 link: '/en/hooks-guide'

197 }, {

198 t: 0.67,

199 kind: 'claude',

200 label: 'npm test output',

201 tokens: 1200,

202 color: '#A09E96',

203 vis: 'brief',

204 desc: 'Runs the test suite. You see "Running npm test..." and the pass count, not the full 1,200 tokens of output.',

205 link: null

206 }, {

207 t: 0.70,

208 kind: 'claude',

209 label: 'Summary',

210 tokens: 400,

211 color: '#D97757',

212 vis: 'full',

213 desc: '"Fixed token rotation. Added regression test. All tests pass."',

214 link: null

215 }, {}, {

216 t: 0.72,

217 kind: 'user',

218 label: 'Your follow-up',

219 tokens: 40,

220 color: '#558A42',

221 vis: 'full',

222 desc: '"Use a subagent to research session timeout handling, then fix it"',

223 tip: 'Follow-ups add to the same context. Delegating research to a subagent keeps large file reads out of your main window.',

224 link: null

225 }, {

226 t: 0.79,

227 kind: 'claude',

228 label: 'Spawn research subagent',

229 tokens: 80,

230 color: '#D97757',

231 vis: 'brief',

232 desc: "Claude delegates the research to a subagent with a fresh, separate context window. It loads CLAUDE.md and the same MCP and skill setup, but starts without your conversation history or the main session's auto memory.",

233 link: '/en/sub-agents'

234 }, {

235 t: 0.795,

236 kind: 'sub',

237 label: 'System prompt',

238 tokens: 0,

239 subTokens: 900,

240 color: '#6B6964',

241 vis: 'hidden',

242 desc: "The subagent gets its own system prompt, shorter than the main session's. For the general-purpose agent, it's a brief prompt plus environment details. The main session's auto memory is not included. If a custom agent has memory: in its frontmatter, it loads its own separate MEMORY.md here instead.",

243 link: '/en/sub-agents#enable-persistent-memory'

244 }, {

245 t: 0.80,

246 kind: 'sub',

247 label: 'Project CLAUDE.md (own copy)',

248 tokens: 0,

249 subTokens: 1800,

250 color: '#6A9BCC',

251 vis: 'hidden',

252 desc: "The subagent loads CLAUDE.md too. Same file, same content, but it counts against the subagent's context, not yours. The built-in Explore and Plan agents skip this for a smaller context.",

253 link: '/en/sub-agents'

254 }, {

255 t: 0.805,

256 kind: 'sub',

257 label: 'MCP tools + skills',

258 tokens: 0,

259 subTokens: 970,

260 color: '#9B7BC4',

261 vis: 'hidden',

262 desc: "The subagent has access to the same MCP servers and skills. It gets most of the parent's tools, minus several that don't apply in a nested context, including plan-mode controls, background-task tools, and by default the Agent tool itself to prevent recursion.",

263 link: '/en/sub-agents'

264 }, {

265 t: 0.81,

266 kind: 'sub',

267 label: 'Task prompt from main',

268 tokens: 0,

269 subTokens: 120,

270 color: '#558A42',

271 vis: 'hidden',

272 desc: "Instead of a user prompt, the subagent receives the task Claude wrote for it: 'Research session timeout handling in this codebase.'",

273 link: '/en/sub-agents'

274 }, {

275 t: 0.82,

276 kind: 'sub',

277 label: 'Read session.ts',

278 tokens: 0,

279 subTokens: 2200,

280 color: '#8A8880',

281 vis: 'hidden',

282 desc: "Now the subagent does its work. This file read fills the subagent's context, not yours.",

283 link: '/en/sub-agents'

284 }, {

285 t: 0.825,

286 kind: 'sub',

287 label: 'Read timeouts.ts',

288 tokens: 0,

289 subTokens: 800,

290 color: '#8A8880',

291 vis: 'hidden',

292 desc: "Another file read in the subagent's separate context.",

293 link: '/en/sub-agents'

294 }, {

295 t: 0.83,

296 kind: 'sub',

297 label: 'Read config/*.ts',

298 tokens: 0,

299 subTokens: 3100,

300 color: '#8A8880',

301 vis: 'hidden',

302 desc: "The subagent can read as many files as it needs. None of this touches your main context.",

303 link: '/en/sub-agents'

304 }, {

305 t: 0.85,

306 kind: 'claude',

307 label: 'Subagent returns summary',

308 tokens: 420,

309 color: '#D97757',

310 vis: 'brief',

311 desc: "Only the subagent's final text response comes back to your context, plus a small metadata trailer with token counts and duration. The subagent read 6,100 tokens of files. You got a 420-token result. That's the context savings.",

312 link: '/en/sub-agents'

313 }, {

314 t: 0.86,

315 kind: 'claude',

316 label: "Claude's response",

317 tokens: 1200,

318 color: '#D97757',

319 vis: 'full',

320 desc: 'Analysis and fix for session timeouts. This text appears in your terminal.',

321 link: null

322 }, {}, {

323 t: 0.875,

324 kind: 'user',

325 label: '!git status',

326 tokens: 180,

327 color: '#558A42',

328 vis: 'full',

329 desc: "You ran a shell command with the ! prefix to see which files Claude modified. The command and its output both enter context as part of your message. Useful for grounding Claude in command output without Claude running it.",

330 link: '/en/interactive-mode#bash-mode-with-prefix'

331 }, {

332 t: 0.89,

333 kind: 'user',

334 label: '/commit-push',

335 tokens: 620,

336 color: '#558A42',

337 vis: 'brief',

338 desc: 'You invoked a skill that has `disable-model-invocation: true`. Its description was not in the skill index at startup, so it cost zero context until this moment. Now the full skill content loads and Claude follows its instructions to stage, commit, and push your changes.',

339 tip: 'Set `disable-model-invocation: true` on skills with side effects like committing, deploying, or sending messages. They stay out of context entirely until you need them.',

340 link: '/en/skills#control-who-invokes-a-skill'

341 }, {}, {

342 t: 0.93,

343 kind: 'compact',

344 label: '/compact',

345 tokens: 0,

346 color: '#D97757',

347 vis: 'brief',

348 desc: 'Replaces the conversation with a structured summary. You see a "Conversation compacted" message. The summarization happens without appearing in your terminal.',

349 link: '/en/how-claude-code-works#the-context-window'

350 }].filter(e => e.t !== undefined), []);

351 const VIS_META = {

352 hidden: {

353 label: 'Invisible in your terminal',

354 sub: 'This content does not appear in your terminal.'

355 },

356 brief: {

357 label: 'One-liner in your terminal',

358 sub: 'You see a brief mention, not the full content.'

359 },

360 full: {

361 label: 'Shown in your terminal',

362 sub: 'The actual content appears in your terminal.'

363 }

364 };

365 {}

366 const GATES = [{

367 at: 0.18,

368 kind: 'prompt',

369 text: 'Fix the auth bug where users get 401 after token refresh',

370 resumeTo: 0.22

371 }, {

372 at: 0.705,

373 kind: 'prompt',

374 text: 'Use a subagent to research session timeout handling, then fix it',

375 resumeTo: 0.72

376 }, {

377 at: 0.865,

378 kind: 'bang',

379 text: '!git status',

380 resumeTo: 0.875

381 }, {

382 at: 0.88,

383 kind: 'slash',

384 text: '/commit-push',

385 resumeTo: 0.89

386 }, {

387 at: 0.90,

388 kind: 'compact',

389 text: '/compact',

390 resumeTo: 1

391 }];

392 const KIND_META = {

393 auto: {

394 badge: 'auto',

395 detail: 'Auto-loaded',

396 badgeBg: 'rgba(94,93,89,0.15)',

397 badgeColor: '#8A8880'

398 },

399 user: {

400 badge: 'you',

401 detail: 'You typed this',

402 badgeBg: 'rgba(85,138,66,0.15)',

403 badgeColor: '#6BA656'

404 },

405 claude: {

406 badge: 'claude',

407 detail: "Claude's work",

408 badgeBg: 'rgba(217,119,87,0.12)',

409 badgeColor: '#D97757'

410 },

411 hook: {

412 badge: 'hook',

413 detail: 'Hook (automatic)',

414 badgeBg: 'rgba(184,134,11,0.15)',

415 badgeColor: '#CCA020'

416 },

417 compact: {

418 badge: 'compact',

419 detail: 'Compaction',

420 badgeBg: 'rgba(217,119,87,0.12)',

421 badgeColor: '#D97757'

422 },

423 sub: {

424 badge: 'subagent',

425 detail: "In subagent's context",

426 badgeBg: 'rgba(155,123,196,0.12)',

427 badgeColor: '#9B7BC4'

428 }

429 };

430 const LEGEND = [{

431 c: '#6B6964',

432 l: 'System'

433 }, {

434 c: '#6A9BCC',

435 l: 'CLAUDE.md'

436 }, {

437 c: '#E8A45C',

438 l: 'Memory'

439 }, {

440 c: '#D4A843',

441 l: 'Skills'

442 }, {

443 c: '#9B7BC4',

444 l: 'MCP'

445 }, {

446 c: '#4A9B8E',

447 l: 'Rules'

448 }, {

449 c: '#558A42',

450 l: 'You'

451 }, {

452 c: '#8A8880',

453 l: 'Files'

454 }, {

455 c: '#A09E96',

456 l: 'Output'

457 }, {

458 c: '#D97757',

459 l: 'Claude'

460 }, {

461 c: '#B8860B',

462 l: 'Hooks'

463 }];

464 const fmt = n => n >= 1000 ? (n / 1000).toFixed(1).replace(/\.0$/, '') + 'K' : n + '';

465 const [time, setTime] = useState(0);

466 const [playing, setPlaying] = useState(false);

467 const [hovIdx, setHovIdx] = useState(null);

468 const [selIdx, setSelIdx] = useState(null);

469 const [hovCat, setHovCat] = useState(null);

470 const [gatesPassed, setGatesPassed] = useState(0);

471 const [mounted, setMounted] = useState(false);

472 const [hasInteracted, setHasInteracted] = useState(false);

473 const lastRef = useRef(null);

474 const scrollRef = useRef(null);

475 const detailRef = useRef(null);

476 useEffect(() => setMounted(true), []);

477 const activeGate = GATES.find((g, i) => i >= gatesPassed && time >= g.at && time < g.resumeTo);

478 useEffect(() => {

479 if (!playing) return;

480 let raf;

481 let stopped = false;

482 const tick = ts => {

483 if (stopped) return;

484 if (!lastRef.current) lastRef.current = ts;

485 const dt = (ts - lastRef.current) / 1000;

486 lastRef.current = ts;

487 setTime(prev => {

488 const next = prev + dt * 0.032;

489 const gate = GATES.find((g, i) => i >= gatesPassed && next >= g.at && prev < g.resumeTo);

490 if (gate) {

491 stopped = true;

492 setPlaying(false);

493 return gate.at;

494 }

495 if (next >= 1) {

496 stopped = true;

497 setPlaying(false);

498 return 1;

499 }

500 return next;

501 });

502 if (!stopped) raf = requestAnimationFrame(tick);

503 };

504 raf = requestAnimationFrame(tick);

505 return () => {

506 stopped = true;

507 cancelAnimationFrame(raf);

508 lastRef.current = null;

509 };

510 }, [playing, gatesPassed]);

511 const sendPrompt = () => {

512 if (!activeGate) return;

513 const isCompact = activeGate.kind === 'compact';

514 setGatesPassed(n => n + 1);

515 setTime(activeGate.resumeTo);

516 setSelIdx(null);

517 setHovIdx(null);

518 if (!isCompact) setPlaying(true);

519 };

520 const visibleCount = EVENTS.filter(e => e.t <= time).length;

521 const preCompactVisible = useMemo(() => EVENTS.slice(0, visibleCount), [EVENTS, visibleCount]);

522 const compactGateIdx = GATES.length - 1;

523 const isCompacted = gatesPassed > compactGateIdx && preCompactVisible.some(e => e.kind === 'compact');

524 const {visible, preCompactTotal} = useMemo(() => {

525 const nonCompact = preCompactVisible.filter(e => e.kind !== 'compact');

526 if (!isCompacted) {

527 return {

528 visible: preCompactVisible,

529 preCompactTotal: 0

530 };

531 }

532 {}

533 const autoLoads = nonCompact.filter(e => e.kind === 'auto' && e.t < STARTUP_END && !e.noSurviveCompact);

534 const summarized = nonCompact.filter(e => e.t >= STARTUP_END && e.kind !== 'sub');

535 const sumTokens = summarized.reduce((s, e) => s + e.tokens, 0);

536 const summaryBlock = {

537 t: STARTUP_END,

538 kind: 'compact',

539 label: 'Conversation summary',

540 tokens: Math.round(sumTokens * 0.12),

541 color: '#A09E96',

542 vis: 'hidden',

543 desc: `All ${summarized.length} conversation events condensed into one structured summary. The summary keeps: your requests and intent, key technical concepts, files examined or modified with important code snippets, errors and how they were fixed, pending tasks, and current work. It replaces the verbatim conversation: full tool outputs and intermediate reasoning are gone. Claude can still reference the work but won't have the exact code it read earlier.`,

544 link: '/en/how-claude-code-works#the-context-window'

545 };

546 return {

547 visible: [...autoLoads, summaryBlock],

548 preCompactTotal: nonCompact.reduce((s, e) => s + e.tokens, 0)

549 };

550 }, [preCompactVisible, isCompacted]);

551 const {blocks, totalTokens} = useMemo(() => {

552 const bl = visible.map((e, visIdx) => ({

553 ...e,

554 id: e.label + e.t,

555 visIdx

556 })).filter(e => e.tokens > 0 || e.label === 'Conversation summary');

557 return {

558 blocks: bl,

559 totalTokens: bl.reduce((s, b) => s + b.tokens, 0)

560 };

561 }, [visible]);

562 const subTotal = useMemo(() => visible.filter(e => e.kind === 'sub').reduce((s, e) => s + (e.subTokens || 0), 0), [visible]);

563 useEffect(() => {

564 if (!scrollRef.current) return;

565 if (isCompacted) scrollRef.current.scrollTo({

566 top: 0,

567 behavior: 'smooth'

568 }); else if (playing || activeGate) scrollRef.current.scrollTop = scrollRef.current.scrollHeight;

569 }, [visible.length, !!activeGate, isCompacted]);

570 const rootRef = useRef(null);

571 const keyStateRef = useRef({});

572 const [isFullscreen, setIsFullscreen] = useState(false);

573 keyStateRef.current = {

574 time,

575 activeGate,

576 sendPrompt,

577 hasInteracted

578 };

579 useEffect(() => {

580 const onFsChange = () => setIsFullscreen(!!document.fullscreenElement);

581 document.addEventListener('fullscreenchange', onFsChange);

582 return () => document.removeEventListener('fullscreenchange', onFsChange);

583 }, []);

584 const toggleFullscreen = () => {

585 if (!rootRef.current) return;

586 if (document.fullscreenElement) document.exitFullscreen(); else rootRef.current.requestFullscreen().catch(() => {});

587 };

588 useEffect(() => {

589 const onKey = e => {

590 const tag = e.target.tagName;

591 if (tag === 'INPUT' || tag === 'BUTTON' || tag === 'TEXTAREA' || tag === 'SELECT' || e.target.isContentEditable) return;

592 if (!rootRef.current) return;

593 const rect = rootRef.current.getBoundingClientRect();

594 if (rect.width === 0 && rect.height === 0) return;

595 if (rect.bottom < 0 || rect.top > window.innerHeight) return;

596 if (e.code === 'Space') {

597 const {time: t, activeGate: g, sendPrompt: send, hasInteracted: hi} = keyStateRef.current;

598 if (!hi) return;

599 e.preventDefault();

600 if (t === 0) setPlaying(true); else if (g) send(); else if (t >= 1) {

601 setTime(0);

602 setGatesPassed(0);

603 setSelIdx(null);

604 setHovIdx(null);

605 setPlaying(true);

606 } else setPlaying(p => !p);

607 }

608 };

609 window.addEventListener('keydown', onKey);

610 return () => window.removeEventListener('keydown', onKey);

611 }, []);

612 const pct = totalTokens / MAX * 100;

613 const barColor = pct > 75 ? '#D97757' : pct > 50 ? '#B8860B' : '#558A42';

614 const activeIdx = selIdx !== null ? selIdx : hovIdx;

615 const hovEvent = activeIdx !== null ? visible[activeIdx] : null;

616 useEffect(() => {

617 if (detailRef.current) detailRef.current.scrollTop = 0;

618 }, [hovEvent]);

619 const focusT = hovEvent ? hovEvent.t : time;

620 const takeaway = isCompacted ? 'Compaction replaces the conversation with a structured summary. System prompt, CLAUDE.md, memory, and MCP tools reload automatically. The skill listing is the one exception. Only skills you actually invoked are preserved.' : focusT < STARTUP_END ? 'A lot loads before you type anything. CLAUDE.md, memory, skills, and MCP tools are all in context before your first prompt.' : focusT < 0.28 ? "Your prompt is tiny compared to what's already loaded. Most of Claude's context is project knowledge, not your words." : focusT < 0.50 ? 'Each file Claude reads grows the context. Path-scoped rules load automatically alongside matching files.' : focusT < 0.71 ? 'Hooks fire automatically on tool events. Output reaches Claude via additionalContext JSON. Exit code 2 surfaces stderr to Claude. Plain stdout on exit 0 goes to the debug log, not the transcript.' : focusT < 0.79 ? 'Follow-up questions keep building on the same context. Everything from earlier is still there.' : focusT < 0.87 ? "The subagent works in its own separate context window. None of its file reads touch yours. Only the final summary comes back." : focusT < 0.88 ? 'Bang commands run in your shell and prefix the output to your next message. Useful for grounding Claude in command results without it running them.' : focusT < 0.90 ? 'User-only skills stay out of context entirely until you invoke them. The skill index at startup only lists skills Claude can call on its own.' : '/compact summarizes the conversation to free space while keeping key information. In a real session, run it when context starts affecting performance or before a long new task.';

621 const terminalView = isCompacted ? 'A "Conversation compacted" message. The summarization happens silently.' : focusT < STARTUP_END ? 'The input box, waiting for your first message. Everything above loads silently before you type anything.' : focusT < 0.28 ? 'Your prompt. Claude hasn\'t started working yet.' : focusT < 0.52 ? 'Your prompt and "Reading files...". Rules show as one-line "Loaded" notices, not their content.' : focusT < 0.72 ? "Claude's response and file diffs. Hooks fire silently. Tool output like npm test shows as a brief summary, not the full content." : focusT < 0.79 ? 'Your follow-up prompt.' : focusT < 0.86 ? "A brief notice that a subagent is working, then its result. You don't see the subagent's individual file reads." : focusT < 0.90 ? "Claude's response, your git status output, and the commit-push skill running." : 'Your full conversation. /compact is available to run.';

622 const mono = 'var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace)';

623 const renderWithCode = s => s.split('`').map((part, i) => i % 2 === 1 ? <code key={i} style={{

624 fontFamily: mono,

625 fontSize: '0.92em',

626 background: 'var(--cw-track)',

627 padding: '1px 4px',

628 borderRadius: 3

629 }}>{part}</code> : part);

630 if (!mounted) return null;

631 return <>

632 <div className="cw-mobile-fallback">

633 This interactive timeline works best on a larger screen. See <a href="#what-the-timeline-shows" style={{

634 color: '#D97757'

635 }}>the written breakdown below</a> for the same concepts.

636 </div>

637 <div className="cw-root" ref={rootRef} onClickCapture={() => setHasInteracted(true)} style={isFullscreen ? {

638 height: '100vh',

639 borderRadius: 0,

640 display: 'flex',

641 flexDirection: 'column'

642 } : {}}>

643 <style>{`

644 .cw-root {

645 --cw-bg: #FAFAF8;

646 --cw-text: #1A1918;

647 --cw-text-2: #3D3C38;

648 --cw-text-3: #5E5D59;

649 --cw-text-dim: #6E6C64;

650 --cw-text-faint: #8A8880;

651 --cw-surface: rgba(0,0,0,0.025);

652 --cw-surface-2: rgba(0,0,0,0.04);

653 --cw-border: rgba(0,0,0,0.08);

654 --cw-track: rgba(0,0,0,0.04);

655 --cw-hover: rgba(0,0,0,0.04);

656 --cw-rail: rgba(0,0,0,0.08);

657 --cw-scrollbar: rgba(0,0,0,0.22);

658 background: var(--cw-bg);

659 border-radius: 12px;

660 overflow: hidden;

661 font-family: var(--font-sans, -apple-system, BlinkMacSystemFont, sans-serif);

662 color: var(--cw-text);

663 border: 1px solid var(--cw-border);

664 }

665 .dark .cw-root {

666 --cw-bg: #111110;

667 --cw-text: #E8E6DC;

668 --cw-text-2: #B8B6AE;

669 --cw-text-3: #9C9A92;

670 --cw-text-dim: #8A8880;

671 --cw-text-faint: #6E6C64;

672 --cw-surface: rgba(255,255,255,0.02);

673 --cw-surface-2: rgba(255,255,255,0.015);

674 --cw-border: rgba(255,255,255,0.06);

675 --cw-track: rgba(255,255,255,0.03);

676 --cw-hover: rgba(255,255,255,0.04);

677 --cw-rail: rgba(255,255,255,0.04);

678 --cw-scrollbar: rgba(255,255,255,0.18);

679 }

680 .cw-scroll::-webkit-scrollbar { width: 6px; }

681 .cw-scroll::-webkit-scrollbar-track { background: transparent; }

682 .cw-scroll::-webkit-scrollbar-thumb { background: var(--cw-scrollbar); border-radius: 3px; }

683 @keyframes cw-blink { 50% { opacity: 0; } }

684 @keyframes cw-fadein { from { opacity: 0; transform: translateY(-4px); } to { opacity: 1; transform: translateY(0); } }

685 .cw-compacted-row { animation: cw-fadein 0.3s ease-out backwards; }

686 .cw-mobile-fallback { display: none; padding: 14px 16px; border-radius: 8px; font-size: 14px; border: 1px solid rgba(0,0,0,0.1); background: rgba(0,0,0,0.03); }

687 .dark .cw-mobile-fallback { border-color: rgba(255,255,255,0.15); background: rgba(255,255,255,0.04); }

688 @media (max-width: 700px) {

689 .cw-root { display: none !important; }

690 .cw-mobile-fallback { display: block; }

691 }

692 `}</style>

10 693 

11## タイムラインが示すもの694 {}

695 <div style={{

696 padding: '16px 20px 12px',

697 display: 'flex',

698 alignItems: 'flex-end',

699 gap: 24

700 }}>

701 <div style={{

702 flex: 1,

703 minWidth: 0

704 }}>

705 <div style={{

706 fontSize: 18,

707 fontWeight: 600,

708 letterSpacing: -0.3,

709 lineHeight: 1

710 }}>

711 Explore the context window

712 </div>

713 <div style={{

714 fontSize: 14,

715 color: 'var(--cw-text-dim)',

716 marginTop: 4

717 }}>

718 A simulated session showing what enters context and what it costs

719 </div>

720 </div>

721 <div style={{

722 textAlign: 'right',

723 flexShrink: 0

724 }}>

725 <div style={{

726 fontFamily: mono,

727 fontSize: 20,

728 fontWeight: 600,

729 color: barColor,

730 letterSpacing: -0.5,

731 lineHeight: 1

732 }}>

733 ~{fmt(totalTokens)}<span style={{

734 fontSize: 15,

735 fontWeight: 500,

736 marginLeft: 4

737 }}>tokens</span>

738 </div>

739 <div style={{

740 fontFamily: mono,

741 fontSize: 13,

742 color: 'var(--cw-text-dim)',

743 marginTop: 2

744 }} title="Token counts are illustrative. Actual values vary with your CLAUDE.md size, MCP servers, and file lengths.">

745 / {fmt(MAX)} · illustrative

746 </div>

747 </div>

748 </div>

749 

750 {}

751 <div style={{

752 padding: '0 20px'

753 }}>

754 <div style={{

755 height: 4,

756 borderRadius: 2,

757 background: 'var(--cw-track)',

758 overflow: 'hidden',

759 marginBottom: 6

760 }}>

761 <div style={{

762 width: pct + '%',

763 height: '100%',

764 background: barColor,

765 transition: 'width 0.6s cubic-bezier(0.4, 0, 0.2, 1), background 0.3s'

766 }} />

767 </div>

768 <div style={{

769 height: 28,

770 borderRadius: 5,

771 background: 'var(--cw-track)',

772 border: '1px solid var(--cw-border)',

773 overflow: 'hidden',

774 display: 'flex'

775 }}>

776 {blocks.map((b, i) => {

777 const w = Math.max(b.tokens / MAX * 100, 0.15);

778 const isHov = b.visIdx === activeIdx;

779 const catMatch = hovCat && b.color === hovCat;

780 const dimmed = hovCat ? !catMatch : activeIdx !== null && !isHov;

781 return <div key={b.id} onMouseEnter={() => setHovIdx(b.visIdx)} onMouseLeave={() => setHovIdx(null)} onClick={() => setSelIdx(selIdx === b.visIdx ? null : b.visIdx)} style={{

782 width: w + '%',

783 height: '100%',

784 background: b.color,

785 opacity: isHov || catMatch ? 1 : dimmed ? 0.25 : 0.65,

786 borderRight: i < blocks.length - 1 ? '0.5px solid var(--cw-border)' : 'none',

787 transition: 'opacity 0.15s',

788 cursor: 'pointer'

789 }} />;

790 })}

791 </div>

792 <div style={{

793 display: 'flex',

794 gap: 12,

795 marginTop: 6,

796 flexWrap: 'wrap',

797 justifyContent: 'space-between'

798 }}>

799 <div style={{

800 display: 'flex',

801 gap: 12,

802 flexWrap: 'wrap'

803 }}>

804 {LEGEND.map(x => {

805 const active = hovCat === x.c;

806 return <div key={x.l} onMouseEnter={() => setHovCat(x.c)} onMouseLeave={() => setHovCat(null)} style={{

807 display: 'flex',

808 alignItems: 'center',

809 gap: 4,

810 padding: '2px 6px',

811 borderRadius: 4,

812 cursor: 'pointer',

813 background: active ? 'var(--cw-hover)' : 'transparent',

814 transition: 'background 0.1s'

815 }}>

816 <div style={{

817 width: 6,

818 height: 6,

819 borderRadius: 1.5,

820 background: x.c,

821 opacity: active ? 1 : 0.7

822 }} />

823 <span style={{

824 fontSize: 12,

825 color: active ? 'var(--cw-text)' : 'var(--cw-text-dim)'

826 }}>{x.l}</span>

827 </div>;

828 })}

829 </div>

830 <div style={{

831 display: 'flex',

832 gap: 6,

833 alignItems: 'center',

834 fontSize: 12,

835 color: 'var(--cw-text-dim)'

836 }}>

837 <svg width="11" height="11" viewBox="0 0 24 24" fill="none" stroke="#558A42" strokeWidth="2.5">

838 <path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z" /><circle cx="12" cy="12" r="3" />

839 </svg>

840 <span>= appears in your terminal</span>

841 </div>

842 </div>

843 </div>

844 

845 {}

846 <div style={{

847 display: 'flex',

848 padding: '14px 20px 0',

849 gap: 16,

850 height: isFullscreen ? 'calc(100vh - 240px)' : 420

851 }}>

852 

853 {}

854 <div ref={scrollRef} className="cw-scroll" style={{

855 flex: 1,

856 minWidth: 0,

857 overflowY: 'auto',

858 paddingRight: 8,

859 scrollBehavior: 'smooth'

860 }}>

861 {visible.length === 0 && !playing && <div style={{

862 height: '100%',

863 display: 'flex',

864 flexDirection: 'column',

865 alignItems: 'center',

866 justifyContent: 'center',

867 gap: 16

868 }}>

869 <div style={{

870 fontFamily: mono,

871 fontSize: 16,

872 color: 'var(--cw-text-dim)',

873 display: 'flex',

874 alignItems: 'center',

875 gap: 8

876 }}>

877 <span style={{

878 color: 'var(--cw-text-faint)'

879 }}>$</span>

880 <span>claude</span>

881 <span style={{

882 display: 'inline-block',

883 width: 8,

884 height: 16,

885 background: 'var(--cw-text-dim)',

886 opacity: 0.5,

887 animation: 'cw-blink 1s step-end infinite'

888 }} />

889 </div>

890 <button onClick={() => setPlaying(true)} style={{

891 padding: '10px 20px',

892 borderRadius: 8,

893 border: '1px solid rgba(217,119,87,0.3)',

894 background: 'rgba(217,119,87,0.08)',

895 color: '#D97757',

896 fontSize: 15,

897 fontWeight: 600,

898 cursor: 'pointer',

899 display: 'flex',

900 alignItems: 'center',

901 gap: 8

902 }}>

903 <span>▶</span>

904 <span>Start session</span>

905 </button>

906 <div style={{

907 fontSize: 13,

908 color: 'var(--cw-text-faint)',

909 maxWidth: 280,

910 textAlign: 'center',

911 lineHeight: 1.5

912 }}>

913 Watch what loads into context, from the moment you run <code style={{

914 fontFamily: mono

915 }}>claude</code> through a full conversation.

916 </div>

917 </div>}

918 {isCompacted && <div style={{

919 marginBottom: 10,

920 padding: '10px 12px',

921 borderRadius: 6,

922 background: 'rgba(217,119,87,0.05)',

923 border: '1px solid rgba(217,119,87,0.15)'

924 }}>

925 <div style={{

926 fontSize: 13,

927 fontWeight: 600,

928 color: '#D97757',

929 marginBottom: 3

930 }}>

931 After /compact

932 </div>

933 <div style={{

934 fontSize: 13,

935 color: 'var(--cw-text-3)',

936 lineHeight: 1.5,

937 fontFamily: mono

938 }}>

939 {fmt(preCompactTotal)} → {fmt(totalTokens)} tokens · freed {fmt(preCompactTotal - totalTokens)}

940 </div>

941 <div style={{

942 fontSize: 13,

943 color: 'var(--cw-text-dim)',

944 lineHeight: 1.5,

945 marginTop: 4

946 }}>

947 This is what's left in context: startup content, which lives outside the message history and reloads after compaction, plus a structured summary of the entire conversation. Skill descriptions don't reload.

948 </div>

949 </div>}

950 {time > 0 && visible.length > 0 && <div style={{

951 fontSize: 12,

952 fontWeight: 700,

953 color: 'var(--cw-text-faint)',

954 textTransform: 'uppercase',

955 letterSpacing: 0.6,

956 marginBottom: 6,

957 paddingLeft: 28

958 }}>

959 {isCompacted ? 'Reloaded after compact' : 'Before you type anything'}

960 </div>}

961 

962 {time > 0 && visible.map((evt, i) => {

963 const meta = KIND_META[evt.kind];

964 const isHov = hovIdx === i;

965 const prevKind = i > 0 ? visible[i - 1].kind : null;

966 const isSub = evt.kind === 'sub';

967 const enteringSubagent = isSub && prevKind !== 'sub';

968 const leavingSubagent = prevKind === 'sub' && !isSub;

969 let showPhase = null;

970 if (evt.kind === 'user' && prevKind !== 'user') showPhase = 'You'; else if (evt.kind === 'claude' && prevKind === 'user') showPhase = 'Claude works'; else if (evt.label === 'Conversation summary') showPhase = 'Summarized by /compact';

971 const isNewRow = isCompacted && !(evt.kind === 'auto' && evt.t < STARTUP_END);

972 return <div key={evt.label + evt.t} className={isNewRow ? 'cw-compacted-row' : ''} style={isNewRow ? {

973 animationDelay: `${i * 60}ms`

974 } : {}}>

975 {showPhase && <div style={{

976 fontSize: 12,

977 fontWeight: 700,

978 color: 'var(--cw-text-faint)',

979 textTransform: 'uppercase',

980 letterSpacing: 0.6,

981 marginTop: 14,

982 marginBottom: 6,

983 paddingLeft: 28

984 }}>

985 {showPhase}

986 </div>}

987 {enteringSubagent && <div style={{

988 marginLeft: 28,

989 marginTop: 6,

990 marginBottom: 2,

991 paddingLeft: 10,

992 borderLeft: '2px solid rgba(155,123,196,0.4)',

993 fontSize: 12,

994 fontWeight: 600,

995 color: '#9B7BC4',

996 textTransform: 'uppercase',

997 letterSpacing: 0.5

998 }}>

999 Subagent's separate context window

1000 </div>}

1001 {leavingSubagent && <div style={{

1002 marginLeft: 28,

1003 marginBottom: 6,

1004 paddingLeft: 10,

1005 paddingBottom: 6,

1006 borderLeft: '2px solid rgba(155,123,196,0.4)',

1007 fontSize: 12,

1008 color: 'var(--cw-text-dim)',

1009 fontFamily: mono

1010 }}>

1011 ↓ {fmt(subTotal)} tokens stayed in subagent's context · only the summary returns

1012 </div>}

1013 <div onMouseEnter={() => setHovIdx(i)} onMouseLeave={() => setHovIdx(null)} onClick={() => setSelIdx(selIdx === i ? null : i)} style={{

1014 display: 'flex',

1015 alignItems: 'flex-start',

1016 borderRadius: 6,

1017 cursor: 'pointer',

1018 background: selIdx === i || isHov ? 'var(--cw-hover)' : 'transparent',

1019 outline: selIdx === i ? '1px solid rgba(217,119,87,0.4)' : 'none',

1020 opacity: hovCat && evt.color !== hovCat ? 0.35 : 1,

1021 transition: 'background 0.1s, opacity 0.15s',

1022 marginLeft: isSub ? 28 : 0,

1023 paddingLeft: isSub ? 10 : 0,

1024 borderLeft: isSub ? '2px solid rgba(155,123,196,0.4)' : 'none'

1025 }}>

1026 <div style={{

1027 width: 28,

1028 display: 'flex',

1029 flexDirection: 'column',

1030 alignItems: 'center',

1031 paddingTop: 8,

1032 flexShrink: 0

1033 }}>

1034 <div style={{

1035 width: evt.kind === 'user' || evt.kind === 'compact' ? 10 : 7,

1036 height: evt.kind === 'user' || evt.kind === 'compact' ? 10 : 7,

1037 borderRadius: '50%',

1038 background: evt.color,

1039 opacity: isHov ? 1 : 0.6,

1040 transition: 'opacity 0.15s',

1041 boxShadow: isHov ? `0 0 8px ${evt.color}40` : 'none'

1042 }} />

1043 {i < visible.length - 1 && <div style={{

1044 width: 1.5,

1045 flex: 1,

1046 background: 'var(--cw-rail)',

1047 marginTop: 2,

1048 minHeight: 6

1049 }} />}

1050 </div>

1051 <div style={{

1052 flex: 1,

1053 minWidth: 0,

1054 padding: '5px 10px 5px 4px',

1055 display: 'flex',

1056 alignItems: 'center',

1057 gap: 8

1058 }}>

1059 <span style={{

1060 fontSize: 12,

1061 fontWeight: 600,

1062 padding: '1px 5px',

1063 borderRadius: 3,

1064 background: meta.badgeBg,

1065 color: meta.badgeColor,

1066 flexShrink: 0,

1067 fontFamily: mono

1068 }}>

1069 {meta.badge}

1070 </span>

1071 <span style={{

1072 fontSize: 15,

1073 fontFamily: mono,

1074 color: isHov ? 'var(--cw-text)' : evt.kind === 'user' ? '#558A42' : evt.kind === 'auto' ? 'var(--cw-text-dim)' : 'var(--cw-text-2)',

1075 flex: 1,

1076 minWidth: 0,

1077 overflow: 'hidden',

1078 textOverflow: 'ellipsis',

1079 whiteSpace: 'nowrap',

1080 fontWeight: evt.kind === 'user' ? 550 : 400

1081 }}>

1082 {evt.label}

1083 </span>

1084 {evt.tokens > 0 && <span style={{

1085 fontSize: 12,

1086 fontFamily: mono,

1087 color: 'var(--cw-text-faint)',

1088 flexShrink: 0

1089 }}>

1090 +{fmt(evt.tokens)}

1091 </span>}

1092 {evt.subTokens > 0 && <span style={{

1093 fontSize: 12,

1094 fontFamily: mono,

1095 color: '#9B7BC4',

1096 flexShrink: 0,

1097 opacity: 0.6

1098 }}>

1099 +{fmt(evt.subTokens)}

1100 </span>}

1101 {evt.tokens > 0 && <div style={{

1102 width: 50,

1103 height: 5,

1104 borderRadius: 2,

1105 background: 'var(--cw-track)',

1106 flexShrink: 0,

1107 overflow: 'hidden'

1108 }}>

1109 <div style={{

1110 width: Math.min(evt.tokens / 5000 * 100, 100) + '%',

1111 height: '100%',

1112 background: evt.color,

1113 opacity: isHov ? 0.8 : 0.4,

1114 transition: 'opacity 0.15s'

1115 }} />

1116 </div>}

1117 <span style={{

1118 width: 14,

1119 flexShrink: 0,

1120 display: 'flex',

1121 justifyContent: 'center'

1122 }} title={VIS_META[evt.vis].label}>

1123 {evt.vis !== 'hidden' && <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke={evt.vis === 'full' ? '#558A42' : 'currentColor'} style={{

1124 color: 'var(--cw-text-faint)',

1125 opacity: evt.vis === 'full' ? 1 : 0.5

1126 }} strokeWidth="2">

1127 <path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z" /><circle cx="12" cy="12" r="3" />

1128 </svg>}

1129 </span>

1130 </div>

1131 </div>

1132 </div>;

1133 })}

1134 

1135 {activeGate && (activeGate.kind === 'prompt' || activeGate.kind === 'bang' || activeGate.kind === 'slash') && <div style={{

1136 paddingLeft: 28,

1137 marginTop: 12,

1138 paddingRight: 8

1139 }}>

1140 <div style={{

1141 fontSize: 11,

1142 fontWeight: 600,

1143 color: '#6BA656',

1144 fontFamily: mono,

1145 textTransform: 'uppercase',

1146 letterSpacing: 0.5,

1147 marginBottom: 4,

1148 paddingLeft: 2

1149 }}>

1150 You type in your terminal

1151 </div>

1152 <div style={{

1153 display: 'flex',

1154 alignItems: 'flex-start',

1155 gap: 8,

1156 padding: '10px 12px',

1157 borderRadius: 6,

1158 background: 'rgba(85,138,66,0.06)',

1159 border: '1px solid rgba(85,138,66,0.2)'

1160 }}>

1161 <span style={{

1162 color: '#558A42',

1163 fontSize: 15,

1164 fontFamily: mono,

1165 flexShrink: 0

1166 }}>❯</span>

1167 <span style={{

1168 fontSize: 15,

1169 fontFamily: mono,

1170 color: 'var(--cw-text-2)',

1171 flex: 1,

1172 lineHeight: 1.5

1173 }}>

1174 {activeGate.text}

1175 <span style={{

1176 display: 'inline-block',

1177 width: 7,

1178 height: 13,

1179 marginLeft: 2,

1180 background: '#558A42',

1181 opacity: 0.5,

1182 verticalAlign: 'middle',

1183 animation: 'cw-blink 1s step-end infinite'

1184 }} />

1185 </span>

1186 <button onClick={sendPrompt} style={{

1187 padding: '5px 12px',

1188 borderRadius: 5,

1189 border: 'none',

1190 background: '#558A42',

1191 color: '#fff',

1192 fontSize: 13,

1193 fontWeight: 600,

1194 cursor: 'pointer',

1195 flexShrink: 0

1196 }}>

1197 {activeGate.kind === 'prompt' ? 'Send ↵' : 'Run ↵'}

1198 </button>

1199 </div>

1200 </div>}

1201 {activeGate && activeGate.kind === 'compact' && <div style={{

1202 paddingLeft: 28,

1203 marginTop: 12,

1204 paddingRight: 8

1205 }}>

1206 <div style={{

1207 padding: '12px 14px',

1208 borderRadius: 6,

1209 background: 'rgba(217,119,87,0.06)',

1210 border: '1px solid rgba(217,119,87,0.25)'

1211 }}>

1212 <div style={{

1213 fontSize: 13,

1214 color: 'var(--cw-text-3)',

1215 marginBottom: 8,

1216 lineHeight: 1.5

1217 }}>

1218 Context is at <span style={{

1219 fontFamily: mono,

1220 fontWeight: 600,

1221 color: barColor

1222 }}>{fmt(totalTokens)} tokens</span>.

1223 Run <code style={{

1224 fontFamily: mono,

1225 background: 'var(--cw-track)',

1226 padding: '1px 4px',

1227 borderRadius: 3

1228 }}>/compact</code> to

1229 summarize older exchanges and free space for more work.

1230 </div>

1231 <div style={{

1232 display: 'flex',

1233 alignItems: 'center',

1234 gap: 8

1235 }}>

1236 <span style={{

1237 color: '#D97757',

1238 fontSize: 15,

1239 fontFamily: mono

1240 }}>❯</span>

1241 <span style={{

1242 fontSize: 15,

1243 fontFamily: mono,

1244 color: 'var(--cw-text-2)',

1245 flex: 1

1246 }}>

1247 {activeGate.text}

1248 </span>

1249 <button onClick={sendPrompt} style={{

1250 padding: '5px 12px',

1251 borderRadius: 5,

1252 border: 'none',

1253 background: '#D97757',

1254 color: '#fff',

1255 fontSize: 13,

1256 fontWeight: 600,

1257 cursor: 'pointer',

1258 flexShrink: 0

1259 }}>

1260 Run ↵

1261 </button>

1262 </div>

1263 </div>

1264 </div>}

1265 </div>

1266 

1267 {}

1268 <div style={{

1269 width: 300,

1270 flexShrink: 0,

1271 display: 'flex',

1272 flexDirection: 'column'

1273 }}>

1274 <div ref={detailRef} className="cw-scroll" style={{

1275 padding: '14px 16px',

1276 borderRadius: 10,

1277 background: 'var(--cw-surface)',

1278 border: '1px solid var(--cw-border)',

1279 flex: 1,

1280 minHeight: 0,

1281 overflowY: 'auto',

1282 display: 'flex',

1283 flexDirection: 'column',

1284 gap: 10

1285 }}>

1286 {hovEvent ? <div>

1287 <div style={{

1288 display: 'flex',

1289 alignItems: 'center',

1290 gap: 8,

1291 marginBottom: 8

1292 }}>

1293 <div style={{

1294 width: 10,

1295 height: 10,

1296 borderRadius: 3,

1297 background: hovEvent.color,

1298 opacity: 0.8

1299 }} />

1300 <span style={{

1301 fontSize: 16,

1302 fontWeight: 600

1303 }}>{hovEvent.label}</span>

1304 </div>

1305 <div style={{

1306 display: 'flex',

1307 width: 'fit-content',

1308 padding: '3px 8px',

1309 borderRadius: 4,

1310 marginBottom: 8,

1311 background: KIND_META[hovEvent.kind].badgeBg

1312 }}>

1313 <span style={{

1314 fontSize: 12,

1315 fontWeight: 600,

1316 color: KIND_META[hovEvent.kind].badgeColor

1317 }}>

1318 {KIND_META[hovEvent.kind].detail}

1319 </span>

1320 </div>

1321 {hovEvent.tokens > 0 && <div style={{

1322 fontSize: 14,

1323 fontFamily: mono,

1324 color: 'var(--cw-text-dim)',

1325 marginBottom: 6

1326 }}>

1327 {fmt(hovEvent.tokens)} tokens

1328 </div>}

1329 {hovEvent.subTokens > 0 && <div style={{

1330 fontSize: 14,

1331 fontFamily: mono,

1332 color: '#9B7BC4',

1333 marginBottom: 6

1334 }}>

1335 {fmt(hovEvent.subTokens)} tokens in the subagent's context

1336 </div>}

1337 <p style={{

1338 fontSize: 15,

1339 color: 'var(--cw-text-3)',

1340 lineHeight: 1.55,

1341 margin: 0

1342 }}>

1343 {renderWithCode(hovEvent.desc)}

1344 </p>

1345 <div style={{

1346 marginTop: 10,

1347 padding: '8px 10px',

1348 borderRadius: 6,

1349 background: hovEvent.vis === 'full' ? 'rgba(85,138,66,0.08)' : 'var(--cw-surface-2)',

1350 border: '1px solid ' + (hovEvent.vis === 'full' ? 'rgba(85,138,66,0.2)' : 'var(--cw-border)')

1351 }}>

1352 <div style={{

1353 display: 'flex',

1354 alignItems: 'center',

1355 gap: 6,

1356 marginBottom: 3

1357 }}>

1358 <span style={{

1359 fontSize: 13,

1360 color: hovEvent.vis === 'full' ? '#558A42' : 'var(--cw-text-dim)'

1361 }}>

1362 {hovEvent.vis === 'full' ? '●' : hovEvent.vis === 'brief' ? '◐' : '○'}

1363 </span>

1364 <span style={{

1365 fontSize: 12,

1366 fontWeight: 600,

1367 color: 'var(--cw-text-2)'

1368 }}>

1369 {VIS_META[hovEvent.vis].label}

1370 </span>

1371 </div>

1372 <div style={{

1373 fontSize: 13,

1374 color: 'var(--cw-text-dim)',

1375 lineHeight: 1.4

1376 }}>

1377 {VIS_META[hovEvent.vis].sub}

1378 </div>

1379 </div>

1380 {hovEvent.tip && <div style={{

1381 marginTop: 10,

1382 padding: '8px 10px',

1383 borderRadius: 6,

1384 background: 'rgba(85,138,66,0.06)',

1385 border: '1px solid rgba(85,138,66,0.15)'

1386 }}>

1387 <div style={{

1388 fontSize: 12,

1389 fontWeight: 600,

1390 color: '#558A42',

1391 marginBottom: 3,

1392 display: 'flex',

1393 alignItems: 'center',

1394 gap: 4

1395 }}>

1396 <span>💡</span> Save context

1397 </div>

1398 <div style={{

1399 fontSize: 13,

1400 color: 'var(--cw-text-3)',

1401 lineHeight: 1.5

1402 }}>

1403 {renderWithCode(hovEvent.tip)}

1404 </div>

1405 </div>}

1406 {hovEvent.link && <a href={hovEvent.link} style={{

1407 display: 'inline-block',

1408 marginTop: 10,

1409 fontSize: 13,

1410 color: '#D97757',

1411 textDecoration: 'none',

1412 borderBottom: '1px solid rgba(217,119,87,0.3)'

1413 }}>

1414 Learn more →

1415 </a>}

1416 </div> : <div style={{

1417 display: 'flex',

1418 flexDirection: 'column',

1419 alignItems: 'center',

1420 textAlign: 'center',

1421 gap: 4,

1422 padding: '12px 0 4px'

1423 }}>

1424 <div style={{

1425 fontSize: 22,

1426 opacity: 0.2

1427 }}>👁</div>

1428 <div style={{

1429 fontSize: 14,

1430 fontWeight: 500,

1431 color: 'var(--cw-text-dim)'

1432 }}>Hover or click any event</div>

1433 <div style={{

1434 fontSize: 12,

1435 color: 'var(--cw-text-faint)',

1436 lineHeight: 1.4,

1437 maxWidth: 200

1438 }}>

1439 Hover to preview. Click to pin so you can scroll.

1440 </div>

1441 </div>}

1442 

1443 <div style={{

1444 padding: '10px 12px',

1445 borderRadius: 8,

1446 background: 'rgba(217,119,87,0.05)',

1447 border: '1px solid rgba(217,119,87,0.12)'

1448 }}>

1449 <div style={{

1450 fontSize: 11,

1451 fontWeight: 700,

1452 color: '#D97757',

1453 textTransform: 'uppercase',

1454 letterSpacing: 0.5,

1455 marginBottom: 3

1456 }}>

1457 Key takeaway

1458 </div>

1459 <div style={{

1460 fontSize: 13,

1461 color: 'var(--cw-text-3)',

1462 lineHeight: 1.5

1463 }}>

1464 {takeaway}

1465 </div>

1466 </div>

1467 

1468 <div style={{

1469 padding: '10px 12px',

1470 borderRadius: 8,

1471 background: 'var(--cw-surface-2)',

1472 border: '1px solid var(--cw-border)'

1473 }}>

1474 <div style={{

1475 fontSize: 11,

1476 fontWeight: 700,

1477 color: 'var(--cw-text-dim)',

1478 textTransform: 'uppercase',

1479 letterSpacing: 0.5,

1480 marginBottom: 3

1481 }}>

1482 In your terminal you see

1483 </div>

1484 <div style={{

1485 fontSize: 13,

1486 color: 'var(--cw-text-3)',

1487 lineHeight: 1.5

1488 }}>

1489 {terminalView}

1490 </div>

1491 </div>

1492 </div>

1493 </div>

1494 </div>

1495 

1496 {}

1497 <div style={{

1498 padding: '10px 20px 14px',

1499 display: 'flex',

1500 alignItems: 'center',

1501 gap: 10

1502 }}>

1503 <button aria-label={time >= 1 ? 'Restart' : activeGate ? 'Continue' : playing ? 'Pause' : 'Play'} onClick={() => {

1504 if (time >= 1) {

1505 setTime(0);

1506 setGatesPassed(0);

1507 setSelIdx(null);

1508 setHovIdx(null);

1509 setPlaying(true);

1510 } else if (activeGate) sendPrompt(); else setPlaying(!playing);

1511 }} style={{

1512 width: 30,

1513 height: 30,

1514 borderRadius: 6,

1515 border: 'none',

1516 background: 'rgba(217,119,87,0.1)',

1517 color: '#D97757',

1518 cursor: 'pointer',

1519 fontSize: 15,

1520 fontWeight: 700,

1521 display: 'flex',

1522 alignItems: 'center',

1523 justifyContent: 'center'

1524 }}>

1525 {time >= 1 ? '↺' : playing ? '⏸' : '▶'}

1526 </button>

1527 <div style={{

1528 flex: 1,

1529 height: 3,

1530 borderRadius: 2,

1531 background: 'var(--cw-track)',

1532 overflow: 'hidden'

1533 }}>

1534 <div style={{

1535 width: time * 100 + '%',

1536 height: '100%',

1537 background: '#D97757',

1538 transition: 'width 0.1s linear'

1539 }} />

1540 </div>

1541 <span style={{

1542 fontSize: 12,

1543 fontFamily: mono,

1544 color: 'var(--cw-text-faint)',

1545 minWidth: 30

1546 }}>

1547 {Math.round(time * 100)}%

1548 </span>

1549 <button onClick={toggleFullscreen} aria-label={isFullscreen ? 'Exit fullscreen' : 'Enter fullscreen'} title={isFullscreen ? 'Exit fullscreen' : 'Fullscreen'} style={{

1550 width: 28,

1551 height: 28,

1552 borderRadius: 6,

1553 border: '1px solid var(--cw-border)',

1554 background: 'var(--cw-surface)',

1555 color: 'var(--cw-text-dim)',

1556 cursor: 'pointer',

1557 fontSize: 15,

1558 flexShrink: 0,

1559 marginLeft: 4,

1560 display: 'flex',

1561 alignItems: 'center',

1562 justifyContent: 'center'

1563 }}>

1564 {isFullscreen ? '⤡' : '⛶'}

1565 </button>

1566 </div>

1567 </div>

1568 </>;

1569};

1570 

1571Claude Code のコンテキストウィンドウには、セッションについて Claude が知っているすべてのものが含まれます。つまり、あなたの指示、読み込まれたファイル、Claude 自身の応答、およびターミナルに表示されないコンテンツです。以下のタイムラインは、スタートアップからコンパクションまでの完全なセッションを再生します。何が読み込まれ、各ファイル読み込み、ルール、フックが Claude の作業中に追加するもの、そしてサブエージェントが大きな読み込みをコンテキストから外す方法を確認できます。[書かれた説明](#what-the-timeline-shows)で同じコンテンツをリストとして確認できます。

1572 

1573<ContextWindow />

1574 

1575<h2 id="what-the-timeline-shows">

1576 タイムラインが示すもの

1577</h2>

12 1578 

13セッションは、代表的なトークン数を含む現実的なフローを通じて進みます。1579セッションは、代表的なトークン数を含む現実的なフローを通じて進みます。

14 1580 

15* **何も入力する前に**: CLAUDE.md、自動メモリ、MCP ツール名、スキルの説明がすべてコンテキストに読み込まれます。あなた自身のセットアップは、[出力スタイル](/ja/output-styles)や[`--append-system-prompt`](/ja/cli-reference)からのテキストなど、ここにさらに多くのものを追加する可能性があります。これらはシステムプロンプトと同じ方法で入ります。1581* **何も入力する前に**: CLAUDE.md、自動メモリ、MCP ツール名、スキルの説明がすべてコンテキストに読み込まれます。あなた自身のセットアップは、[出力スタイル](/ja/output-styles)や[`--append-system-prompt`](/ja/cli-reference)からのテキストなど、ここにさらに多くのものを追加する可能性があります。これらはシステムプロンプトと同じ方法で入ります。

16* **Claude が作業するとき**: 各ファイル読み込みがコンテキストに追加され、[パススコープ付きルール](/ja/memory#path-specific-rules)は一致するファイルと一緒に自動的に読み込まれ、[PostToolUse フック](/ja/hooks-guide)は各編集後に発火します。1582* **Claude が作業するとき**: 各ファイル読み込みがコンテキストに追加され、[パススコープ付きルール](/ja/memory#path-specific-rules)は一致するファイルと一緒に自動的に読み込まれ、[PostToolUse フック](/ja/hooks-guide)は各編集後に発火します。

17* **フォローアップ プロンプト**: [サブエージェント](/ja/sub-agents)は独自の別のコンテキストウィンドウで研究を処理するため、大きなファイル読み込みはあなたのコンテキストウィンドウから外れます。サマリーと小さなメタデータトレーラーだけが戻ってきます。1583* **フォローアップ プロンプト**: [サブエージェント](/ja/sub-agents)は独自の別のコンテキストウィンドウで研究を処理するため、大きなファイル読み込みはあなたのコンテキストウィンドウから外れます。サマリーと小さなメタデータトレーラーだけが戻ってきます。

18* **最後に**: `/compact` は会話をまとめられた構造化されたサマリーに置き換えます。ほとんどのスタートアップコンテンツは自動的に再度読み込まれます。以下の表は、各メカニズムに何が起こるかを示しています。1584* **最後に**: `/compact` は会話を構造化されたサマリーに置き換えます。ほとんどのスタートアップコンテンツは自動的に再度読み込まれます。以下の表は、各メカニズムに何が起こるかを示しています。

19 1585 

20## コンパクション後に残るもの1586<h2 id="what-survives-compaction">

1587 コンパクション後に残るもの

1588</h2>

21 1589 

22長いセッションがコンパクションされると、Claude Code は会話履歴をコンテキストウィンドウに収まるようにまとめます。あなたの指示に何が起こるかは、それらがどのように読み込まれたかによって異なります。1590長いセッションがコンパクションされると、Claude Code は会話履歴をコンテキストウィンドウに収まるようにまとめます。あなたの指示に何が起こるかは、それらがどのように読み込まれたかによって異なります。

23 1591 


35 1603 

36スキル本体はコンパクション後に再度注入されますが、大きなスキルはスキルあたりのキャップに収まるようにトリミングされ、合計予算を超えると最も古い呼び出されたスキルがドロップされます。トリミングはファイルの開始を保持するため、`SKILL.md` の上部に最も重要な指示を配置してください。1604スキル本体はコンパクション後に再度注入されますが、大きなスキルはスキルあたりのキャップに収まるようにトリミングされ、合計予算を超えると最も古い呼び出されたスキルがドロップされます。トリミングはファイルの開始を保持するため、`SKILL.md` の上部に最も重要な指示を配置してください。

37 1605 

38## あなた自身のセッションを確認する1606<h2 id="when-your-context-fills-up">

1607 コンテキストがいっぱいになるとき

1608</h2>

1609 

1610Claude Code はコンテキストウィンドウの制限に近づくと自動的にコンパクションを実行するため、コンテキストウィンドウがいっぱいになってもセッションが終了することはありません。自動パスはタイムラインの `/compact` ステップと同じ方法で機能します。保持される内容については、[コンテキストがいっぱいになるとき](/ja/how-claude-code-works#when-context-fills-up)を参照してください。

1611 

1612自動パスが実行される前に対応することもできます。

1613 

1614* **フォーカスを絞ってコンパクション**: `/compact` を指示付きで実行します。例えば、`/compact focus on the auth bug fix` のように、長い新しいタスクを開始する前に実行してください。サマリーは自動パスが重要だと推測するものではなく、あなたが選択したものを保持します。

1615* **タスク間でクリア**: 関連のない作業に切り替えるときに `/clear` を実行してください。古い会話は次に必要なファイルを圧迫し、すべてのメッセージでトークンを消費します。

1616* **大きな読み込みを委譲**: 研究を[サブエージェント](/ja/sub-agents)に送信して、ファイルコンテンツがあなたのコンテキストウィンドウではなく、そのコンテキストウィンドウに留まるようにしてください。

1617 

1618より小さな会話ではなく、より大きなウィンドウが必要な場合、Fable 5、Opus 4.6 以降、および Sonnet 4.6 は 100 万トークンのコンテキストウィンドウをサポートしています。プランごとの利用可能性と `[1m]` モデルバリアントの選択方法については、[拡張コンテキスト](/ja/model-config#extended-context)を参照してください。コンパクションはより大きな制限でも同じ方法で機能します。

1619 

1620<h2 id="check-your-own-session">

1621 あなた自身のセッションを確認する

1622</h2>

39 1623 

40ビジュアライゼーションは代表的な数値を使用しています。任意の時点でのあなたの実際のコンテキスト使用状況を確認するには、`/context` を実行して、カテゴリ別の詳細な内訳と最適化の提案を取得してください。`/memory` を実行して、スタートアップ時にどの CLAUDE.md と自動メモリファイルが読み込まれたかを確認してください。1624ビジュアライゼーションは代表的な数値を使用しています。任意の時点でのあなたの実際のコンテキスト使用状況を確認するには、`/context` を実行して、カテゴリ別の詳細な内訳と最適化の提案を取得してください。`/memory` を実行して、スタートアップ時にどの CLAUDE.md と自動メモリファイルが読み込まれたかを確認してください。

41 1625 

42## 関連リソース1626<h2 id="related-resources">

1627 関連リソース

1628</h2>

43 1629 

44タイムラインに示されている機能の詳細なカバレッジについては、これらのページを参照してください。1630タイムラインに示されている機能の詳細なカバレッジについては、これらのページを参照してください。

45 1631 

costs.md +6 −4

Details

35 35 

36Pro、Max、Team、または Enterprise プランでは、`/usage` はプラン制限に対してカウントされるものの内訳も表示します。最近の使用量をスキル、サブエージェント、プラグイン、および個別の MCP サーバーに属性付けし、それぞれが合計のパーセンテージとして表示されます。`d` または `w` を押して、過去 24 時間と過去 7 日間を切り替えることができます。数値は概算であり、このマシン上のローカルセッション履歴から計算されるため、他のデバイスまたは claude.ai からの使用量は含まれていません。36Pro、Max、Team、または Enterprise プランでは、`/usage` はプラン制限に対してカウントされるものの内訳も表示します。最近の使用量をスキル、サブエージェント、プラグイン、および個別の MCP サーバーに属性付けし、それぞれが合計のパーセンテージとして表示されます。`d` または `w` を押して、過去 24 時間と過去 7 日間を切り替えることができます。数値は概算であり、このマシン上のローカルセッション履歴から計算されるため、他のデバイスまたは claude.ai からの使用量は含まれていません。

37 37 

38[VS Code 拡張機能](/ja/vs-code#check-account-and-usage) では、同じ内訳が Account & usage ダイアログに Day および Week トグルとともに表示されます。Claude Code v2.1.174 以降が必要です。

39 

38<h2 id="managing-costs-for-teams">40<h2 id="managing-costs-for-teams">

39 チームのコストを管理する41 チームのコストを管理する

40</h2>42</h2>


85* チームメイトに Sonnet を使用します。これは調整タスクの機能とコストのバランスを取ります。87* チームメイトに Sonnet を使用します。これは調整タスクの機能とコストのバランスを取ります。

86* チームを小さく保ちます。各チームメイトは独自のコンテキストウィンドウを実行するため、トークン使用量はおおよそチームサイズに比例します。88* チームを小さく保ちます。各チームメイトは独自のコンテキストウィンドウを実行するため、トークン使用量はおおよそチームサイズに比例します。

87* スポーンプロンプトを焦点を絞ったものにします。チームメイトは CLAUDE.md、MCP サーバー、およびスキルを自動的に読み込みますが、スポーンプロンプト内のすべてが最初からコンテキストに追加されます。89* スポーンプロンプトを焦点を絞ったものにします。チームメイトは CLAUDE.md、MCP サーバー、およびスキルを自動的に読み込みますが、スポーンプロンプト内のすべてが最初からコンテキストに追加されます。

88* 作業が完了したらチームをクリーンアップします。アクティブなチームメイトはアイドル状態でもトークンを消費し続けます。90* 作業が完了したらチームをシャットダウンします。アクティブなチームメイトはアイドル状態でもトークンを消費し続けます。

89* エージェントチームはデフォルトで無効になっています。[settings.json](/ja/settings) または環境で `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を設定して有効にします。[エージェントチームを有効にする](/ja/agent-teams#enable-agent-teams) を参照してください。91* エージェントチームはデフォルトで無効になっています。[settings.json](/ja/settings) または環境で `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を設定して有効にします。[エージェントチームを有効にする](/ja/agent-teams#enable-agent-teams) を参照してください。

90 92 

91<h2 id="reduce-token-usage">93<h2 id="reduce-token-usage">


196 拡張思考を調整する198 拡張思考を調整する

197</h3>199</h3>

198 200 

199拡張思考はデフォルトで有効になっています。これは複雑な計画と推論タスクのパフォーマンスを大幅に向上させるためです。思考トークンは出力トークンとして課金され、デフォルト予算はモデルに応じて数万トークンになる場合があります。深い推論が必要ない単純なタスクの場合、`/effort` で [努力レベル](/ja/model-config#adjust-effort-level) を低下させるか、`/model` で、`/config` で思考を無効にするか、`MAX_THINKING_TOKENS=8000` で予算を低下させることでコストを削減できます。201拡張思考はデフォルトで有効になっています。これは複雑な計画と推論タスクのパフォーマンスを大幅に向上させるためです。思考トークンは出力トークンとして課金され、デフォルト予算はモデルに応じて数万トークンになる場合があります。深い推論が必要ない単純なタスクの場合、`/effort` で [努力レベル](/ja/model-config#adjust-effort-level) を低下させるか、`/model` で、`/config` で思考を無効にするか、`MAX_THINKING_TOKENS=8000` で予算を低下させることでコストを削減できます。適応推論モデルはゼロ以外の予算を無視するため、代わりに努力レベルを使用します。Fable 5 では思考を無効にすることはできません。これは常に拡張思考を使用します。

200 202 

201<h3 id="delegate-verbose-operations-to-subagents">203<h3 id="delegate-verbose-operations-to-subagents">

202 詳細な操作を subagent に委任する204 詳細な操作を subagent に委任する


236* **会話要約**: `claude --resume` 機能の前の会話を要約するバックグラウンドジョブ238* **会話要約**: `claude --resume` 機能の前の会話を要約するバックグラウンドジョブ

237* **コマンド処理**: `/usage` などの一部のコマンドは、ステータスを確認するためにリクエストを生成する場合があります239* **コマンド処理**: `/usage` などの一部のコマンドは、ステータスを確認するためにリクエストを生成する場合があります

238 240 

239これらのバックグラウンドプロセスは、アクティブなインタラクションがなくても、少量のトークン(通常はセッションあたり 0.04 ドル未満)を消費します。241これらのバックグラウンドプロセスは、アクティブなインタラクションがなくても、少量のトークン(通常はセッションあたり \$0.04 未満)を消費します。

240 242 

241<h2 id="understanding-changes-in-claude-code-behavior">243<h2 id="understanding-changes-in-claude-code-behavior">

242 Claude Code の動作の変更を理解する244 Claude Code の動作の変更を理解する

243</h2>245</h2>

244 246 

245Claude Code は、コスト報告を含む機能の動作方法を変更する可能性のある定期的な更新を受け取ります。`claude --version` を実行して現在のバージョンを確認します。特定の請求に関する質問については、[Console アカウント](https://platform.claude.com/login) を通じて Anthropic サポートに連絡してください。247Claude Code は、コスト報告を含む機能の動作方法を変更する可能性のある定期的な更新を受け取ります。`claude --version` を実行して現在のバージョンを確認してください。特定の請求に関する質問については、[Console アカウント](https://platform.claude.com/login)を通じて Anthropic サポートに連絡してください。

data-usage.md +2 −2

Details

83 83 

84以下の図は、インストール中および通常の操作中に Claude Code が外部サービスにどのように接続するかを示しています。実線は必須の接続を示し、破線はオプションまたはユーザーが開始したデータフローを表します。84以下の図は、インストール中および通常の操作中に Claude Code が外部サービスにどのように接続するかを示しています。実線は必須の接続を示し、破線はオプションまたはユーザーが開始したデータフローを表します。

85 85 

86<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/claude-code-data-flow.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=5b1131530bdfdd415700a0cb4d4070c4" alt="Claude Code の外部接続を示す図:インストール/更新は配布サーバーに接続し、ユーザーリクエストは Console 認証、public-api、およびオプションでメトリクス、Sentry、バグレポートを含む Anthropic サービスに接続します" width="720" height="520" data-path="images/claude-code-data-flow.svg" />86<img src="https://mintcdn.com/claude-code/ikqp3_70mqIahteV/images/claude-code-data-flow.svg?fit=max&auto=format&n=ikqp3_70mqIahteV&q=85&s=5b1131530bdfdd415700a0cb4d4070c4" alt="Claude Code の外部接続を示す図:インストール/更新は配布サーバーに接続し、ユーザーリクエストは Console 認証、public-api、およびオプションでメトリクスと Sentry に接続します。/feedback で送信されたフィードバックは Google Cloud Storage に送信されオプションで GitHub issue を作成します" width="720" height="520" data-path="images/claude-code-data-flow.svg" />

87 87 

88Claude Code はローカルで実行されます。LLM と対話するために、Claude Code はネットワーク経由でデータを送信します。このデータには、すべてのユーザープロンプトとモデル出力が含まれます。データは TLS 1.2 以上で転送中に暗号化されます。Claude Code はほとんどの一般的な VPN および LLM プロキシと互換性があります。88Claude Code はローカルで実行されます。LLM と対話するために、Claude Code はネットワーク経由でデータを送信します。このデータには、すべてのユーザープロンプトとモデル出力が含まれます。データは TLS 1.2 以上で転送中に暗号化されます。Claude Code はほとんどの一般的な VPN および LLM プロキシと互換性があります。

89 89 


119 119 

120Claude Code はユーザーのマシンから Sentry に接続して、運用エラーログを記録します。データは TLS を使用して転送中に暗号化され、256 ビット AES 暗号化を使用して保存時に暗号化されます。詳細については、[Sentry security documentation](https://sentry.io/security/) を参照してください。エラーログをオプトアウトするには、`DISABLE_ERROR_REPORTING` 環境変数を設定します。120Claude Code はユーザーのマシンから Sentry に接続して、運用エラーログを記録します。データは TLS を使用して転送中に暗号化され、256 ビット AES 暗号化を使用して保存時に暗号化されます。詳細については、[Sentry security documentation](https://sentry.io/security/) を参照してください。エラーログをオプトアウトするには、`DISABLE_ERROR_REPORTING` 環境変数を設定します。

121 121 

122`/feedback` コマンドを実行すると、コードを含む会話履歴のコピーが Anthropic に送信されます。送信前に、含める履歴の量を選択できます。デフォルトは現在のセッションのみですが、同じプロジェクトの過去 24 時間または 7 日間の他のセッションも含めることができます。データは TLS 経由で転送中に暗号化されます。オプションで、公開リポジトリに GitHub イシューが作成されます。オプトアウトするには、`DISABLE_FEEDBACK_COMMAND` 環境変数を `1` に設定します。122`/feedback` コマンドを実行すると、コードを含む会話履歴のコピーが Anthropic に送信されます。送信前に、含める履歴の量を選択できます。デフォルトは現在のセッションのみですが、同じプロジェクトの過去 24 時間または 7 日間の他のセッションも含めることができます。データは TLS 経由で転送中に暗号化され、Google Cloud Storage に保存されますGoogle Cloud Storage はデフォルトで保存時のデータを暗号化します。オプションで、公開リポジトリに GitHub イシューが作成されます。オプトアウトするには、`DISABLE_FEEDBACK_COMMAND` 環境変数を `1` に設定します。

123 123 

124Bedrock や Vertex などのサードパーティプロバイダーを使用している場合、または Anthropic 認証情報が設定されていない場合、`/feedback` はレポートを Anthropic に送信する代わりに、`~/.claude/feedback-bundles/` の下のローカルアーカイブに書き込みます。既知の API キーおよびトークンパターンは、アーカイブが書き込まれる前に削除されます。Anthropic アカウント担当者にファイルを送信するか、サポートリクエストに添付するまで、何もマシンから出ません。124Bedrock や Vertex などのサードパーティプロバイダーを使用している場合、または Anthropic 認証情報が設定されていない場合、`/feedback` はレポートを Anthropic に送信する代わりに、`~/.claude/feedback-bundles/` の下のローカルアーカイブに書き込みます。既知の API キーおよびトークンパターンは、アーカイブが書き込まれる前に削除されます。Anthropic アカウント担当者にファイルを送信するか、サポートリクエストに添付するまで、何もマシンから出ません。

125 125 

Details

78 クリーン設定に対してテストする78 クリーン設定に対してテストする

79</h2>79</h2>

80 80 

81ターゲット化されたチェックが原因を特定しない場合、または設定が不明な状態にある場合は、通常のセットアップから何も読み込まないセッションと比較してください。[`CLAUDE_CONFIG_DIR`](/ja/env-vars) を空のディレクトリに指定して `~/.claude` の下のすべてをバイパスし、`.claude` フォルダ`.mcp.json`または `CLAUDE.md` がないディレクトリから起動して、プロジェクト設定もスキップします81{/* min-version: 2.1.169 */}[`claude --safe-mode`](/ja/cli-reference#cli-flags) で開始します。これにより、`CLAUDE.md`、skills、plugins、hooks、MCP サーバーカスタムコマンドエージェントを含むすべてのカスタマイズが無効になった状態でセッションが起動します。認証、モデル選択、組み込みツール、権限は通常通り機能します。セーフモードで問題が消える場合、これらのサーフェスのいずれかが原因です。上記のターゲット化されたチェックを使用して、どれが原因かを特定してください。組織によってデプロイされたマネージド設定は部分的に適用されるため、ポリシー設定された hooks とステータスラインはセーフモードでも実行されます

82 

83セーフモードで問題が続く場合、または設定自体が疑わしい場合は、通常のセットアップから何も読み込まないセッションと比較してください。[`CLAUDE_CONFIG_DIR`](/ja/env-vars) を空のディレクトリに指定して `~/.claude` の下のすべてをバイパスし、`.claude` フォルダ、`.mcp.json`、または `CLAUDE.md` がないディレクトリから起動して、プロジェクト設定もスキップします。

82 84 

83```bash theme={null}85```bash theme={null}

84cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude86cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude

85```87```

86 88 

87クリーンセッションには、ユーザーまたはプロジェクト設定、hooks、MCP サーバー、プラグイン、またはメモリがありません。89クリーンセッションには、ユーザーまたはプロジェクト設定、hooks、MCP サーバー、plugins、またはメモリがありません。

88 90 

89* マネージド設定は、組織がそれらをデプロイする場合でも適用されます。これらは `~/.claude` の外のシステムパスに存在するためです。91* マネージド設定は、組織がそれらをデプロイする場合でも適用されます。これらは `~/.claude` の外のシステムパスに存在するためです。

90* Linux と Windows では、認証情報が設定ディレクトリの下に保存されているため、再度ログインするよう促されます。92* Linux と Windows では、認証情報が設定ディレクトリの下に保存されているため、再度ログインするよう促されます。

91* macOS では、認証情報は Keychain にあり、クリーンセッションに引き継がれます。93* macOS では、認証情報は Keychain にあり、クリーンセッションに引き継がれます。

92 94 

93問題がここで消える場合、原因は実際の `~/.claude` またはプロジェクト `.claude` ファイルのどこかにあります。ファイルを一度に 1 つずつ再導入します。ファイルを一時ディレクトリにコピーするか、プロジェクトから起動して、どれが原因かを見つけます。クリーンセッションで問題が続く場合、原因はユーザーおよびプロジェクト設定の外にあります。`/status` を実行してマネージド設定が有効かどうかを確認し、[環境変数](/ja/env-vars) を探して Claude Code に影響を与えます。その後、[トラブルシューティング](/ja/troubleshooting) を参照してください。95問題がここで消える場合、原因は実際の `~/.claude` またはプロジェクト `.claude` ファイルのどこかにあります。ファイルを一度に 1 つずつ再導入します。ファイルを一時ディレクトリにコピーするか、プロジェクトから起動して、どれが原因かを見つけます。クリーンセッションで問題が続く場合、原因はユーザーおよびプロジェクト設定の外にあります。`/status` を実行してマネージド設定が有効かどうかを確認し、Claude Code に影響を与える[環境変数](/ja/env-vars)を探してから、[トラブルシューティング](/ja/troubleshooting)を参照してください。

94 96 

95<h2 id="check-common-causes">97<h2 id="check-common-causes">

96 一般的な原因を確認する98 一般的な原因を確認する

desktop.md +35 −33

Details

41最初のメッセージを送信する前に、プロンプト領域で 4 つのことを設定してください:41最初のメッセージを送信する前に、プロンプト領域で 4 つのことを設定してください:

42 42 

43* **環境**:Claude が実行される場所を選択します。ローカルマシンの場合は**Local**、Anthropic ホスト型クラウドセッションの場合は**Remote**、管理するリモートマシンの場合は[**SSH 接続**](#ssh-sessions)を選択します。[環境設定](#environment-configuration)を参照してください。43* **環境**:Claude が実行される場所を選択します。ローカルマシンの場合は**Local**、Anthropic ホスト型クラウドセッションの場合は**Remote**、管理するリモートマシンの場合は[**SSH 接続**](#ssh-sessions)を選択します。[環境設定](#environment-configuration)を参照してください。

44* **プロジェクトフォルダ**:Claude が作業するフォルダまたはリポジトリを選択します。リモートセッションの場合、[複数のリポジトリ](#run-long-running-tasks-remotely)を追加できます。44* **プロジェクトフォルダ**:Claude が作業するフォルダまたはリポジトリを選択します。クラウドセッションの場合、[複数のリポジトリ](#run-long-running-tasks-remotely)を追加できます。

45* **モデル**:送信ボタンの横のドロップダウンから[モデル](/ja/model-config#available-models)を選択します。セッション中にこれを変更できます。45* **モデル**:送信ボタンの横のドロップダウンから[モデル](/ja/model-config#available-models)を選択します。セッション中にこれを変更できます。

46* **権限モード**:[モードセレクタ](#choose-a-permission-mode)から Claude がどの程度の自律性を持つかを選択します。セッション中にこれを変更できます。46* **権限モード**:[モードセレクタ](#choose-a-permission-mode)から Claude がどの程度の自律性を持つかを選択します。セッション中にこれを変更できます。

47 47 


67 67 

68プロンプトボックスは外部コンテキストを取り込む 2 つの方法をサポートしています:68プロンプトボックスは外部コンテキストを取り込む 2 つの方法をサポートしています:

69 69 

70* **@mention ファイル**:`@`の後にファイル名を入力して、ファイルを会話コンテキストに追加します。Claude はそのファイルを読み取り、参照できます。@mention はリモートセッションでは利用できません70* **@mention ファイル**:`@`の後にファイル名を入力して、ファイルを会話コンテキストに追加します。Claude はそのファイルを読み取り、参照できます。@mention はクラウドセッションでは利用できません

71* **ファイルを添付**:添付ボタンを使用するか、ファイルをプロンプトに直接ドラッグアンドドロップして、画像、PDF、およびその他のファイルをプロンプトに添付します。これはバグのスクリーンショット、デザインモックアップ、または参照ドキュメントを共有するのに便利です。71* **ファイルを添付**:添付ボタンを使用するか、ファイルをプロンプトに直接ドラッグアンドドロップして、画像、PDF、およびその他のファイルをプロンプトに添付します。これはバグのスクリーンショット、デザインモックアップ、または参照ドキュメントを共有するのに便利です。

72 72 

73<h3 id="choose-a-permission-mode">73<h3 id="choose-a-permission-mode">


77権限モードは、セッション中に Claude がどの程度の自律性を持つかを制御します:ファイルの編集、コマンドの実行、またはその両方の前に確認するかどうかです。送信ボタンの横のモードセレクタを使用して、いつでもモードを切り替えることができます。Ask permissions で開始して Claude が実行する内容を正確に確認してから、慣れてきたら Auto accept edits または Plan mode に移動します。77権限モードは、セッション中に Claude がどの程度の自律性を持つかを制御します:ファイルの編集、コマンドの実行、またはその両方の前に確認するかどうかです。送信ボタンの横のモードセレクタを使用して、いつでもモードを切り替えることができます。Ask permissions で開始して Claude が実行する内容を正確に確認してから、慣れてきたら Auto accept edits または Plan mode に移動します。

78 78 

79| モード | 設定キー | 動作 |79| モード | 設定キー | 動作 |

80| ---------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |80| ---------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

81| **Ask permissions** | `default` | Claude はファイルの編集またはコマンドの実行の前に確認を求めます。diff を確認し、各変更を受け入れるか拒否できます。新規ユーザーに推奨されます。 |81| **Ask permissions** | `default` | Claude はファイルの編集またはコマンドの実行の前に確認を求めます。diff を確認し、各変更を受け入れるか拒否できます。新規ユーザーに推奨されます。 |

82| **Auto accept edits** | `acceptEdits` | Claude はファイル編集と`mkdir`、`touch`、`mv`などの一般的なファイルシステムコマンドを自動的に受け入れますが、他のターミナルコマンドの実行前には確認を求めます。ファイル変更を信頼し、より高速な反復を望む場合に使用します。 |82| **Auto accept edits** | `acceptEdits` | Claude はファイル編集と`mkdir`、`touch`、`mv`などの一般的なファイルシステムコマンドを自動的に受け入れますが、他のターミナルコマンドの実行前には確認を求めます。ファイル変更を信頼し、より高速な反復を望む場合に使用します。 |

83| **Plan mode** | `plan` | Claude はファイルを読み取り、コマンドを実行して探索してから、ソースコードを編集せずにプランを提案します。アプローチを最初に確認したい複雑なタスクに適しています。 |83| **Plan mode** | `plan` | Claude はファイルを読み取り、コマンドを実行して探索してから、ソースコードを編集せずにプランを提案します。アプローチを最初に確認したい複雑なタスクに適しています。 |

84| **Auto** | `auto` | Claude はすべてのアクションをバックグラウンド安全チェック付きで実行し、リクエストとの整合性を確認します。権限プロンプトを削減しながら監視を維持します。Settings → Claude Code で有効にします。[利用可能性要件](#auto-mode-availability)以下を参照してください。 |84| **Auto** | `auto` | Claude はすべてのアクションをバックグラウンド安全チェック付きで実行し、リクエストとの整合性を確認します。権限プロンプトを削減しながら監視を維持します。Settings → Claude Code で有効にします。[利用可能性要件](#auto-mode-availability)以下を参照してください。 |

85| **Bypass permissions** | `bypassPermissions` | Claude は権限プロンプトなしで実行され、CLI の`--dangerously-skip-permissions`と同等です。Settings → Claude Code の「Allow bypass permissions mode」で有効にします。サンドボックス化されたコンテナまたは VM でのみ使用してください。エンタープライズ管理者はこのオプションを無効にできます。 |85| **Bypass permissions** | `bypassPermissions` | Claude は権限プロンプトなしで実行され、明示的な[ask ルール](/ja/permissions#manage-permissions)によって強制されるもの以外は、CLI の`--dangerously-skip-permissions`と同等です。Settings → Claude Code の「Allow bypass permissions mode」で有効にします。サンドボックス化されたコンテナまたは VM でのみ使用してください。エンタープライズ管理者はこのオプションを無効にできます。 |

86 86 

87`dontAsk`権限モードは[CLI](/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode)でのみ利用可能です。87`dontAsk`権限モードは[CLI](/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode)でのみ利用可能です。

88 88 


94 複雑なタスクを Plan mode で開始して、Claude が変更を加える前にアプローチをマップアウトするようにします。プランを承認したら、Auto accept edits または Ask permissions に切り替えて実行します。このワークフローの詳細については、[最初に探索してからプランしてからコード化する](/ja/best-practices#explore-first-then-plan-then-code)を参照してください。94 複雑なタスクを Plan mode で開始して、Claude が変更を加える前にアプローチをマップアウトするようにします。プランを承認したら、Auto accept edits または Ask permissions に切り替えて実行します。このワークフローの詳細については、[最初に探索してからプランしてからコード化する](/ja/best-practices#explore-first-then-plan-then-code)を参照してください。

95</Tip>95</Tip>

96 96 

97リモートセッションは Auto accept edits Plan mode をサポートしています。Ask permissions はリモートセッションがデフォルトでファイル編集を自動受け入れするため利用できず、Bypass permissions はリモート環境が既にサンドボックス化されているため利用できません97クラウドセッションは Accept edits、Plan mode、および Auto mode をサポートしています。Accept edits は`default`モードに対応しています:クラウドセッションはファイル編集を事前に承認するため、セレクタは Ask permissions ではなく Accept edits を表示します。Bypass permissions はクラウド環境が既にサンドボックス化されているため利用できません

98 98 

99エンタープライズ管理者は利用可能な権限モードを制限できます。詳細については、[エンタープライズ設定](#enterprise-configuration)を参照してください。99エンタープライズ管理者は利用可能な権限モードを制限できます。詳細については、[エンタープライズ設定](#enterprise-configuration)を参照してください。

100 100 


178 178 

179チャットまたは diff ビューアのファイルパスをクリックして、ファイルペインで開きます。HTML、PDF、画像、およびビデオパスは代わりに[プレビューペイン](#preview-your-app)で開きます。スポット編集を行い、**Save**をクリックして書き戻します。ファイルを開いてからディスク上で変更された場合、ペインは警告を表示し、オーバーライドまたは破棄できます。**Discard**をクリックして編集を元に戻すか、ペインヘッダーのパスをクリックして絶対パスをコピーします。179チャットまたは diff ビューアのファイルパスをクリックして、ファイルペインで開きます。HTML、PDF、画像、およびビデオパスは代わりに[プレビューペイン](#preview-your-app)で開きます。スポット編集を行い、**Save**をクリックして書き戻します。ファイルを開いてからディスク上で変更された場合、ペインは警告を表示し、オーバーライドまたは破棄できます。**Discard**をクリックして編集を元に戻すか、ペインヘッダーのパスをクリックして絶対パスをコピーします。

180 180 

181ファイルペインはローカルおよび SSH セッションで利用可能です。リモートセッションの場合、Claude に変更を加えるよう依頼します。181ファイルペインはローカルおよび SSH セッションで利用可能です。クラウドセッションの場合、Claude に変更を加えるよう依頼します。

182 182 

183<h3 id="open-files-in-other-apps">183<h3 id="open-files-in-other-apps">

184 ファイルを他のアプリで開く184 ファイルを他のアプリで開く


243 Claude にコンピュータを使用させる243 Claude にコンピュータを使用させる

244</h2>244</h2>

245 245 

246コンピュータ使用により、Claude はアプリを開き、スクリーンを制御し、あなたがするのと同じ方法でマシンで直接作業できます。iOS シミュレータでネイティブアプリをテストするよう Claude に依頼したり、CLI がないデスクトップツールと対話したり、GUI を通じてのみ機能する何かを自動化したりします。246コンピュータ使用により、Claude はアプリを開き、スクリーンを制御し、あなたがするのと同じ方法でマシンで直接作業できます。モバイルシミュレータでネイティブアプリをテストするよう Claude に依頼したり、CLI がないデスクトップツールと対話したり、GUI を通じてのみ機能する何かを自動化したりします。

247 247 

248<Note>248<Note>

249 コンピュータ使用は macOS と Windows の研究プレビューであり、Pro または Max プランが必要です。Team または Enterprise プランでは利用できません。Claude Desktop アプリが実行されている必要があります。249 コンピュータ使用は macOS と Windows の研究プレビューであり、Pro または Max プランが必要です。Team または Enterprise プランでは利用できません。Claude Desktop アプリが実行されている必要があります。


266* タスクがブラウザ作業であり、[Chrome の Claude](/ja/chrome)がセットアップされている場合、Claude はそれを使用します。266* タスクがブラウザ作業であり、[Chrome の Claude](/ja/chrome)がセットアップされている場合、Claude はそれを使用します。

267* これらのいずれも適用されない場合、Claude はコンピュータ使用を使用します。267* これらのいずれも適用されない場合、Claude はコンピュータ使用を使用します。

268 268 

269[アプリごとのアクセス層](#app-permissions)はこれを強化します:ブラウザはビューのみに制限され、ターミナルと IDE はクリックのみに制限され、Claude をコンピュータ使用がアクティブな場合でも専用ツールに向けます。スクリーン制御は、ネイティブアプリ、ハードウェア制御パネル、iOS シミュレータ、または API のない独自ツールなど、他に何も到達できないものに予約されています。269[アプリごとのアクセス層](#app-permissions)はこれを強化します:ブラウザはビューのみに制限され、ターミナルと IDE はクリックのみに制限され、Claude をコンピュータ使用がアクティブな場合でも専用ツールに向けます。スクリーン制御は、ネイティブアプリ、ハードウェア制御パネル、モバイルシミュレータ、または API のない独自ツールなど、他に何も到達できないものに予約されています。

270 270 

271<h3 id="enable-computer-use">271<h3 id="enable-computer-use">

272 コンピュータ使用を有効にする272 コンピュータ使用を有効にする


403 外部ツールを接続する403 外部ツールを接続する

404</h3>404</h3>

405 405 

406ローカルおよび[SSH](#ssh-sessions)セッションの場合、プロンプトボックスの横の\*\*+**ボタンをクリックして**Connectors**を選択し、Google Calendar、Slack、GitHub、Linear、Notion などの統合を追加します。セッションの前または中にコネクタを追加できます。**+\*\*ボタンはリモートセッションでは利用できませんが、[ルーチン](/ja/routines)はルーチン作成時にコネクタを設定します。406ローカルおよび[SSH](#ssh-sessions)セッションの場合、プロンプトボックスの横の\*\*+**ボタンをクリックして**Connectors**を選択し、Google Calendar、Slack、GitHub、Linear、Notion などの統合を追加します。セッションの前または中にコネクタを追加できます。**+\*\*ボタンはクラウドセッションでは利用できませんが、[ルーチン](/ja/routines)はルーチン作成時にコネクタを設定します。

407 407 

408コネクタを管理または切断するには、デスクトップアプリの Settings → Connectors に移動するか、プロンプトボックスの Connectors メニューから**Manage connectors**を選択します。408コネクタを管理または切断するには、デスクトップアプリの Settings → Connectors に移動するか、プロンプトボックスの Connectors メニューから**Manage connectors**を選択します。

409 409 


425 425 

426ローカルおよび[SSH](#ssh-sessions)セッションの場合、プロンプトボックスの横の\*\*+**ボタンをクリックして**Plugins**を選択して、インストール済みプラグインとそのスキルを確認します。プラグインを追加するには、サブメニューから**Add plugin\*\*を選択してプラグインブラウザを開きます。これは、公式 Anthropic マーケットプレイスを含む、設定された[マーケットプレイス](/ja/plugin-marketplaces)から利用可能なプラグインを表示します。**Manage plugins**を選択して、プラグインを有効化、無効化、またはアンインストールします。426ローカルおよび[SSH](#ssh-sessions)セッションの場合、プロンプトボックスの横の\*\*+**ボタンをクリックして**Plugins**を選択して、インストール済みプラグインとそのスキルを確認します。プラグインを追加するには、サブメニューから**Add plugin\*\*を選択してプラグインブラウザを開きます。これは、公式 Anthropic マーケットプレイスを含む、設定された[マーケットプレイス](/ja/plugin-marketplaces)から利用可能なプラグインを表示します。**Manage plugins**を選択して、プラグインを有効化、無効化、またはアンインストールします。

427 427 

428プラグインはユーザーアカウント、特定のプロジェクト、またはローカルのみにスコープできます。組織がプラグインを一元管理する場合、それらのプラグインは CLI セッションと同じ方法で Desktop セッションで利用可能です。プラグインはリモートセッションでは利用できません。プラグインの作成を含む完全なプラグインリファレンスについては、[プラグイン](/ja/plugins)を参照してください。428プラグインはユーザーアカウント、特定のプロジェクト、またはローカルのみにスコープできます。組織がプラグインを一元管理する場合、それらのプラグインは CLI セッションと同じ方法で Desktop セッションで利用可能です。プラグインはクラウドセッションでは利用できません。プラグインの作成を含む完全なプラグインリファレンスについては、[プラグイン](/ja/plugins)を参照してください。

429 429 

430<h3 id="configure-preview-servers">430<h3 id="configure-preview-servers">

431 プレビューサーバーを設定する431 プレビューサーバーを設定する


487| `program` | string | `node`で実行するスクリプト。[`program`と`runtimeExecutable`を使用する場合](#when-to-use-program-vs-runtimeexecutable)を参照してください |487| `program` | string | `node`で実行するスクリプト。[`program`と`runtimeExecutable`を使用する場合](#when-to-use-program-vs-runtimeexecutable)を参照してください |

488| `args` | string\[] | `program`に渡される引数。`program`が設定されている場合のみ使用されます |488| `args` | string\[] | `program`に渡される引数。`program`が設定されている場合のみ使用されます |

489 489 

490<a id="when-to-use-program-vs-runtimeexecutable" />

491 

490<h5 id="when-to-use-program-vs-runtimeexecutable">492<h5 id="when-to-use-program-vs-runtimeexecutable">

491 `program`と`runtimeExecutable`を使用する場合493 `program`と`runtimeExecutable`を使用する場合

492</h5>494</h5>


598 600 

599ローカルセッションと dev サーバーの環境変数を設定するには、プロンプトボックスの環境ドロップダウンを開き、**Local** にマウスを合わせて、ギアアイコンをクリックしてローカル環境エディタを開きます。ここで保存する変数は、マシンに暗号化されて保存され、開始するすべてのローカルセッションとプレビューサーバーに適用されます。また、`~/.claude/settings.json` ファイルの `env` キーに変数を追加することもできます。ただし、これらは Claude セッションにのみ到達し、dev サーバーには到達しません。サポートされている変数の完全なリストについては、[環境変数](/ja/env-vars)を参照してください。601ローカルセッションと dev サーバーの環境変数を設定するには、プロンプトボックスの環境ドロップダウンを開き、**Local** にマウスを合わせて、ギアアイコンをクリックしてローカル環境エディタを開きます。ここで保存する変数は、マシンに暗号化されて保存され、開始するすべてのローカルセッションとプレビューサーバーに適用されます。また、`~/.claude/settings.json` ファイルの `env` キーに変数を追加することもできます。ただし、これらは Claude セッションにのみ到達し、dev サーバーには到達しません。サポートされている変数の完全なリストについては、[環境変数](/ja/env-vars)を参照してください。

600 602 

601[拡張思考](/ja/model-config#extended-thinking)はデフォルトで有効になっており、複雑な推論タスクのパフォーマンスを向上させますが、追加のトークンを使用します。思考を完全に無効にするには、ローカル環境エディタで `MAX_THINKING_TOKENS` を `0` に設定します。[適応的推論](/ja/model-config#adjust-effort-level)を持つモデルでは、適応的推論が思考の深さを制御するため、他の `MAX_THINKING_TOKENS` 値は無視されます。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を `1` に設定します。Opus 4.7 以降は常に適応的推論を使用し、固定予算モードはありません。603[拡張思考](/ja/model-config#extended-thinking)はデフォルトで有効になっており、複雑な推論タスクのパフォーマンスを向上させますが、追加のトークンを使用します。思考を無効にするには、ローカル環境エディタで `MAX_THINKING_TOKENS` を `0` に設定します。これは Fable 5 には効果がなく、常に拡張思考を使用します。[サードパーティプロバイダー](/ja/third-party-integrations)では、`0` は代わりに `thinking` パラメータを省略し、適応的推論モデルは依然として思考する可能性があります。[適応的推論](/ja/model-config#adjust-effort-level)を持つモデルでは、適応的推論が思考の深さを制御するため、他の `MAX_THINKING_TOKENS` 値は無視されます。Opus 4.6 と Sonnet 4.6 では、固定思考予算を使用するために `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を `1` に設定します。Opus 4.7 以降は常に適応的推論を使用し、固定予算モードはありません。

602 604 

603<h3 id="remote-sessions">605<h3 id="cloud-sessions">

604 リモートセッション606 クラウドセッション

605</h3>607</h3>

606 608 

607リモートセッションはアプリを閉じても、バックグラウンドで続行されます。使用状況は[サブスクリプションプランの制限](/ja/costs)にカウントされ、別の計算料金はありません。609クラウドセッションはアプリを閉じても、バックグラウンドで続行されます。使用状況は[サブスクリプションプランの制限](/ja/costs)にカウントされ、別の計算料金はありません。

608 610 

609異なるネットワークアクセスレベルと環境変数を持つカスタムクラウド環境を作成できます。リモートセッションを開始するときに環境ドロップダウンを選択し、**Add environment** を選択します。ネットワークアクセスと環境変数の設定の詳細については、[クラウド環境](/ja/claude-code-on-the-web#the-cloud-environment)を参照してください。611異なるネットワークアクセスレベルと環境変数を持つカスタムクラウド環境を作成できます。クラウドセッションを開始するときに環境ドロップダウンを選択し、**Add environment** を選択します。ネットワークアクセスと環境変数の設定の詳細については、[クラウド環境](/ja/claude-code-on-the-web#the-cloud-environment)を参照してください。

610 612 

611<h3 id="ssh-sessions">613<h3 id="ssh-sessions">

612 SSH セッション614 SSH セッション


683* **Code in the desktop**:組織内のユーザーがデスクトップアプリで Claude Code にアクセスできるかどうかを制御します685* **Code in the desktop**:組織内のユーザーがデスクトップアプリで Claude Code にアクセスできるかどうかを制御します

684* **Code in the web**:組織の[Web セッション](/ja/claude-code-on-the-web)を有効または無効にします686* **Code in the web**:組織の[Web セッション](/ja/claude-code-on-the-web)を有効または無効にします

685* **Remote Control**:組織の[Remote Control](/ja/remote-control)を有効または無効にします687* **Remote Control**:組織の[Remote Control](/ja/remote-control)を有効または無効にします

686* **Bypass permissions モードを無効化**:組織内のユーザーが bypass permissions モードを有効にするのを防ぎます688* **Disable Bypass permissions mode**:組織内のユーザーが bypass permissions モードを有効にするのを防ぎます

687 689 

688<h3 id="managed-settings">690<h3 id="managed-settings">

689 管理設定691 管理設定


710 712 

711IT チームは、macOS の MDM または Windows のグループポリシーを通じてデスクトップアプリを管理できます。利用可能なポリシーには、Claude Code 機能の有効化または無効化、自動更新の制御、およびカスタムデプロイメント URL の設定が含まれます。713IT チームは、macOS の MDM または Windows のグループポリシーを通じてデスクトップアプリを管理できます。利用可能なポリシーには、Claude Code 機能の有効化または無効化、自動更新の制御、およびカスタムデプロイメント URL の設定が含まれます。

712 714 

713* **macOS**:Jamf または Kandji などのツールを使用して`com.anthropic.Claude`プリファレンスドメインを通じて設定します715* **macOS**:Jamf または Kandji などのツールを使用して`com.anthropic.claudefordesktop`プリファレンスドメインを通じて設定します

714* **Windows**:`SOFTWARE\Policies\Claude`のレジストリを通じて設定します716* **Windows**:`SOFTWARE\Policies\Claude`のレジストリを通じて設定します

715 717 

716<h3 id="authentication-and-sso">718<h3 id="authentication-and-sso">

717 認証と SSO719 認証と SSO

718</h3>720</h3>

719 721 

720エンタープライズ組織はすべてのユーザーに SSO を要求できます。プランレベルの詳細については[認証](/ja/authentication)を参照し、SAML および OIDC 設定については[SSO の設定](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso)を参照してください。722エンタープライズ組織はすべてのユーザーに SSO を要求できます。プランレベルの詳細については[認証](/ja/authentication)を参照し、SAML および OIDC 設定については[Setting up SSO](https://support.claude.com/en/articles/13132885-setting-up-single-sign-on-sso)を参照してください。

721 723 

722<h3 id="data-handling">724<h3 id="data-handling">

723 データ処理725 データ処理

724</h3>726</h3>

725 727 

726Claude Code はローカルセッションではコードをローカルで処理するか、リモートセッションでは Anthropic のクラウドインフラストラクチャで処理します。会話とコードコンテキストは処理のために Anthropic の API に送信されます。データ保持、プライバシー、およびコンプライアンスの詳細については、[データ処理](/ja/data-usage)を参照してください。728Claude Code はローカルセッションではコードをローカルで処理するか、クラウドセッションでは Anthropic のクラウドインフラストラクチャで処理します。会話とコードコンテキストは処理のために Anthropic の API に送信されます。データ保持、プライバシー、およびコンプライアンスの詳細については、[データ処理](/ja/data-usage)を参照してください。

727 729 

728<h3 id="deployment">730<h3 id="deployment">

729 デプロイメント731 デプロイメント


734* **macOS**:Jamf または Kandji などの MDM を使用して`.dmg`インストーラーを通じて配布します736* **macOS**:Jamf または Kandji などの MDM を使用して`.dmg`インストーラーを通じて配布します

735* **Windows**:MSIX パッケージまたは`.exe`インストーラーを通じてデプロイします。サイレントインストールを含むエンタープライズデプロイメントオプションについては、[Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows)を参照してください。737* **Windows**:MSIX パッケージまたは`.exe`インストーラーを通じてデプロイします。サイレントインストールを含むエンタープライズデプロイメントオプションについては、[Deploy Claude Desktop for Windows](https://support.claude.com/en/articles/12622703-deploy-claude-desktop-for-windows)を参照してください。

736 738 

737ネットワーク設定(プロキシ設定、ファイアウォール許可リスト、LLM ゲートウェイなど)については、[ネットワーク設定](/ja/network-config)を参照してください。739プロキシ設定、ファイアウォール許可リスト、LLM ゲートウェイなどのネットワーク設定については、[ネットワーク設定](/ja/network-config)を参照してください。

738 740 

739完全なエンタープライズ設定リファレンスについては、[エンタープライズ設定ガイド](https://support.claude.com/en/articles/12622667-enterprise-configuration)を参照してください。741完全なエンタープライズ設定リファレンスについては、[エンタープライズ設定ガイド](https://support.claude.com/en/articles/12622667-enterprise-configuration)を参照してください。

740 742 


762| `--resume`、`--continue` | サイドバーのセッションをクリック |764| `--resume`、`--continue` | サイドバーのセッションをクリック |

763| `--permission-mode` | 送信ボタンの横のモードセレクタ |765| `--permission-mode` | 送信ボタンの横のモードセレクタ |

764| `--dangerously-skip-permissions` | Bypass permissions モード。Settings → Claude Code → 「Allow bypass permissions mode」で有効にします。エンタープライズ管理者はこの設定を無効にできます。 |766| `--dangerously-skip-permissions` | Bypass permissions モード。Settings → Claude Code → 「Allow bypass permissions mode」で有効にします。エンタープライズ管理者はこの設定を無効にできます。 |

765| `--add-dir` | リモートセッションで **+** ボタンで複数のリポジトリを追加 |767| `--add-dir` | クラウドセッションで **+** ボタンで複数のリポジトリを追加 |

766| `--allowedTools`、`--disallowedTools` | セッションごとの同等物はありません。[設定ファイル](/ja/settings)の権限ルールは引き続き適用されます。 |768| `--allowedTools`、`--disallowedTools` | セッションごとの同等物はありません。[設定ファイル](/ja/settings)の権限ルールは引き続き適用されます。 |

767| `--verbose` | [Verbose ビューモード](#switch-view-modes)(Transcript view ドロップダウン) |769| `--verbose` | [Verbose ビューモード](#switch-view-modes)(Transcript view ドロップダウン) |

768| `--print`、`--output-format` | 利用できません。Desktop はインタラクティブのみです。 |770| `--print`、`--output-format` | 利用できません。Desktop はインタラクティブのみです。 |


779* `~/.claude.json` または `.mcp.json` で設定された **[MCP サーバー](/ja/mcp)** は両方で機能します781* `~/.claude.json` または `.mcp.json` で設定された **[MCP サーバー](/ja/mcp)** は両方で機能します

780* 設定で定義された **[Hooks](/ja/hooks)** および **[skills](/ja/skills)** は両方に適用されます782* 設定で定義された **[Hooks](/ja/hooks)** および **[skills](/ja/skills)** は両方に適用されます

781* `~/.claude.json` および `~/.claude/settings.json` の **[設定](/ja/settings)** は共有されます。`settings.json` の権限ルール、許可されたツール、およびその他の設定は Desktop セッションに適用されます。783* `~/.claude.json` および `~/.claude/settings.json` の **[設定](/ja/settings)** は共有されます。`settings.json` の権限ルール、許可されたツール、およびその他の設定は Desktop セッションに適用されます。

782* **モデル**:Sonnet、Opus、および Haiku は両方で利用可能です。Desktop では、送信ボタンの横のドロップダウンからモデルを選択します。セッション中にモデルを変更できます784* **モデル**:同じ[モデル](/ja/model-config#available-models)は両方で利用可能です。Desktop では、送信ボタンの横のドロップダウンからモデルを選択します。セッション中にモデルを同じドロップダウンから変更できます

783 785 

784<Note>786<Note>

785 **Claude Desktop チャットアプリからの MCP サーバー**:Desktop アプリは `claude_desktop_config.json` から MCP サーバーを Code タブセッションに読み込みます。これは `~/.claude.json` および `.mcp.json` からのサーバーと並行して行われます。`claude_desktop_config.json` で定義されたサーバーは Desktop チャットサーフェスと Code タブの両方で利用可能です。787 **Claude Desktop チャットアプリからの MCP サーバー**:Desktop アプリは `claude_desktop_config.json` から MCP サーバーを Code タブセッションに読み込みます。これは `~/.claude.json` および `.mcp.json` からのサーバーと並行して行われます。`claude_desktop_config.json` で定義されたサーバーは Desktop チャットサーフェスと Code タブの両方で利用可能です。


794このテーブルは、CLI と Desktop の間のコア機能を比較しています。CLI フラグの完全なリストについては、[CLI リファレンス](/ja/cli-reference)を参照してください。796このテーブルは、CLI と Desktop の間のコア機能を比較しています。CLI フラグの完全なリストについては、[CLI リファレンス](/ja/cli-reference)を参照してください。

795 797 

796| 機能 | CLI | Desktop |798| 機能 | CLI | Desktop |

797| --------------------------------------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |799| --------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

798| 権限モード | `dontAsk` を含むすべてのモード | Ask permissions、Auto accept edits、Plan mode、Auto、および Settings 経由の Bypass permissions |800| 権限モード | `dontAsk` を含むすべてのモード | Ask permissions、Auto accept edits、Plan mode、Auto、および Settings 経由の Bypass permissions |

799| `--dangerously-skip-permissions` | CLI フラグ | Bypass permissions モード。Settings → Claude Code → 「Allow bypass permissions mode」で有効にします |801| `--dangerously-skip-permissions` | CLI フラグ | Bypass permissions モード。Settings → Claude Code → 「Allow bypass permissions mode」で有効にします |

800| [サードパーティプロバイダー](/ja/third-party-integrations) | Bedrock、Vertex、Foundry | Anthropic の API がデフォルト。エンタープライズデプロイメントは Vertex AI とゲートウェイプロバイダーを設定できます。[エンタープライズ設定ガイド](https://support.claude.com/en/articles/12622667-enterprise-configuration)を参照してください。 |802| [サードパーティプロバイダー](/ja/third-party-integrations) | Bedrock、Vertex AI、Foundry | Anthropic の API がデフォルト。エンタープライズデプロイメントは Vertex AI とゲートウェイプロバイダーを設定できます。[エンタープライズ設定ガイド](https://support.claude.com/en/articles/12622667-enterprise-configuration)を参照してください。Bedrock、Vertex AI、Foundry、または自己ホスト型 LLM ゲートウェイで Code タブを実行するには、[Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview)を参照してください。 |

801| [MCP サーバー](/ja/mcp) | 設定ファイルで設定 | ローカルおよび SSH セッションの Connectors UI、または設定ファイル |803| [MCP サーバー](/ja/mcp) | 設定ファイルで設定 | ローカルおよび SSH セッションの Connectors UI、または設定ファイル |

802| [Plugins](/ja/plugins) | `/plugin` コマンド | プラグインマネージャー UI |804| [Plugins](/ja/plugins) | `/plugin` コマンド | プラグインマネージャー UI |

803| @mention ファイル | テキストベース | オートコンプリート付き;ローカルおよび SSH セッションのみ |805| @mention ファイル | テキストベース | オートコンプリート付き;ローカルおよび SSH セッションのみ |


809| Dispatch 統合 | 利用できません | [Dispatch セッション](#sessions-from-dispatch)(サイドバー) |811| Dispatch 統合 | 利用できません | [Dispatch セッション](#sessions-from-dispatch)(サイドバー) |

810| スクリプトと自動化 | [`--print`](/ja/cli-reference)、[Agent SDK](/ja/headless) | 利用できません |812| スクリプトと自動化 | [`--print`](/ja/cli-reference)、[Agent SDK](/ja/headless) | 利用できません |

811 813 

812<h3 id="what-s-not-available-in-desktop">814<h3 id="whats-not-available-in-desktop">

813 Desktop では利用できないもの815 Desktop では利用できないもの

814</h3>816</h3>

815 817 

816以下の機能は CLI または VS Code 拡張機能でのみ利用可能です:818以下の機能は CLI または VS Code 拡張機能でのみ利用可能です。ただし、以下の場合を除きます

817 819 

818* **サードパーティプロバイダー**:Desktop は Anthropic の API に直接接続します。エンタープライズデプロイメントは Vertex AI とゲートウェイプロバイダーを [管理設定](https://support.claude.com/en/articles/12622667-enterprise-configuration)経由で設定できます。Bedrock または Foundry の場合は、[CLI](/ja/quickstart)を使用します820* **サードパーティプロバイダー**:Desktop は Anthropic の API に直接接続します。エンタープライズデプロイメントは Vertex AI とゲートウェイプロバイダーを [管理設定](https://support.claude.com/en/articles/12622667-enterprise-configuration)経由で設定できます。Bedrock または Foundry の場合は、[クイックスタート](/ja/quickstart)を参照してください上記のセクションの例外として、[Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview)は Bedrock、Vertex AI、Foundry、または自己ホスト型 LLM ゲートウェイで Code タブを実行します。

819* **Linux**:デスクトップアプリは macOS と Windows でのみ利用可能です。Linux では、[CLI](/ja/quickstart)を使用します。821* **Linux**:デスクトップアプリは macOS と Windows でのみ利用可能です。Linux では、[CLI](/ja/quickstart)を使用します。

820* **インラインコード提案**:Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。822* **インラインコード提案**:Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。

821* **エージェントチーム**:並列 Claude Code セッションが互いにメッセージを送信するのは [CLI](/ja/agent-teams) で利用可能であり、Desktop では利用できません。1 つのセッション内でマルチエージェント作業を行う場合は、[動的ワークフロー](/ja/workflows)を使用します。これは Desktop で実行されます。823* **エージェントチーム**:並列 Claude Code セッションが互いにメッセージを送信するのは [CLI](/ja/agent-teams) で利用可能であり、Desktop では利用できません。1 つのセッション内でマルチエージェント作業を行う場合は、[動的ワークフロー](/ja/workflows)を使用します。これは Desktop で実行されます。


885 887 

886MCP サーバートグルが応答しない場合、または Windows でサーバーが接続に失敗する場合、サーバーが設定で正しく設定されていることを確認し、アプリを再起動し、Task Manager でサーバープロセスが実行されていることを確認し、接続エラーについてサーバーログを確認します。888MCP サーバートグルが応答しない場合、または Windows でサーバーが接続に失敗する場合、サーバーが設定で正しく設定されていることを確認し、アプリを再起動し、Task Manager でサーバープロセスが実行されていることを確認し、接続エラーについてサーバーログを確認します。

887 889 

888<h3 id="app-won-t-quit">890<h3 id="app-wont-quit">

889 アプリが終了しない891 アプリが終了しない

890</h3>892</h3>

891 893 


899* **インストール後に PATH が更新されない**:新しいターミナルウィンドウを開きます。PATH の更新は新しいターミナルセッションにのみ適用されます。901* **インストール後に PATH が更新されない**:新しいターミナルウィンドウを開きます。PATH の更新は新しいターミナルセッションにのみ適用されます。

900* **同時インストールエラー**:別のインストールが進行中であるというエラーが表示されるが、実際には進行中でない場合、インストーラーを管理者として実行してみてください。902* **同時インストールエラー**:別のインストールが進行中であるというエラーが表示されるが、実際には進行中でない場合、インストーラーを管理者として実行してみてください。

901 903 

902<h3 id="branch-doesn-t-exist-yet-when-opening-in-cli">904<h3 id="branch-doesnt-exist-yet-when-opening-in-cli">

903 CLI で開くときに「Branch doesn't exist yet」905 CLI で開くときに「Branch doesn't exist yet」

904</h3>906</h3>

905 907 

906リモートセッションはローカルマシンに存在しないブランチを作成できます。セッションツールバーのブランチ名をクリックしてコピーしてから、ローカルでフェッチします:908クラウドセッションはローカルマシンに存在しないブランチを作成できます。セッションツールバーのブランチ名をクリックしてコピーしてから、ローカルでフェッチします:

907 909 

908```bash theme={null}910```bash theme={null}

909git fetch origin <branch-name>911git fetch origin <branch-name>


914 まだ立ち往生していますか?916 まだ立ち往生していますか?

915</h3>917</h3>

916 918 

917* [GitHub Issues](https://github.com/anthropics/claude-code/issues)でバグを検索またはファイルします919* デスクトップアプリで Help → Get Support を開くか、[Claude サポートセンター](https://support.claude.com/)に直接アクセスします

918* [Claude サポートセンター](https://support.claude.com/)にアクセスします920* スタンドアロン`claude` CLI でも再現される問題については、[GitHub Issues](https://github.com/anthropics/claude-code/issues)でバグを検索またはファイルします

919 921 

920バグをファイルするときは、デスクトップアプリのバージョン、オペレーティングシステム、正確なエラーメッセージ、および関連ログを含めます。macOS では Console.app を確認します。Windows では Event Viewer → Windows Logs → Application を確認します。922問題を報告するときは、デスクトップアプリのバージョン、オペレーティングシステム、正確なエラーメッセージ、および関連ログを含めます。macOS では Console.app を確認します。Windows では Event Viewer → Windows Logs → Application を確認します。

Details

71 </Step>71 </Step>

72 72 

73 <Step title="モデルを選択する">73 <Step title="モデルを選択する">

74 送信ボタンの横のドロップダウンからモデルを選択します。Opus、Sonnet、Haiku の比較については、[モデル](/ja/model-config#available-models) を参照してください。後でこのドロップダウンから同じモデルを変更できます。74 送信ボタンの横のドロップダウンからモデルを選択します。利用可能なモデルの比較については、[モデル](/ja/model-config#available-models) を参照してください。後でこのドロップダウンから同じモデルを変更できます。

75 </Step>75 </Step>

76 76 

77 <Step title="Claude に何をするかを伝える">77 <Step title="Claude に何をするかを伝える">


127 CLI から来ましたか?127 CLI から来ましたか?

128</h2>128</h2>

129 129 

130Desktop は、グラフィカルインターフェース付きの CLI と同じエンジンを実行します。同じプロジェクトで両方を同時に実行でき、設定(CLAUDE.md ファイル、MCP servers、hooks、スキル、設定)を共有します。機能、フラグの同等物、Desktop で利用できないものの完全な比較については、[CLI 比較](/ja/desktop#coming-from-the-cli)を参照してください。130Desktop は、グラフィカルインターフェース付きの CLI と同じエンジンを実行します。同じプロジェクトで両方を同時に実行でき、設定(CLAUDE.md ファイル、MCP servers、hooks、skills、設定)を共有します。機能、フラグの同等物、Desktop で利用できないものの完全な比較については、[CLI 比較](/ja/desktop#coming-from-the-cli)を参照してください。

131 131 

132<h2 id="what-s-next">132<h2 id="whats-next">

133 次のステップ133 次のステップ

134</h2>134</h2>

135 135 

Details

89 スケジュール設定されたタスクの権限89 スケジュール設定されたタスクの権限

90</h2>90</h2>

91 91 

92各タスクには独自の権限モードがあり、タスクを作成または編集するときに設定します。`~/.claude/settings.json` からのルールも許可されます。スケジュール設定されたタスクセッションにも適用されます。タスクが Ask モードで実行され、権限がないツールを実行する必要がある場合、実行は承認されるまで停止します。セッションはサイドバーに開いたままなので、後で応答できます。92各タスクには独自の権限モードがあり、タスクを作成または編集するときに設定します。`~/.claude/settings.json` からの許可ルールもスケジュール設定されたタスクセッションに適用されます。タスクが Ask モードで実行され、権限がないツールを実行する必要がある場合、実行は承認されるまで停止します。セッションはサイドバーに開いたままなので、後で応答できます。

93 93 

94停止を避けるには、タスクを作成した後に **Run now** をクリックし、権限プロンプトを監視し、各プロンプトに対して「常に許可」を選択します。そのタスクの将来の実行は、プロンプトなしで同じツールを自動承認します。タスクの詳細ページからこれらの承認をレビューして取り消すことができます。94停止を避けるには、タスクを作成した後に **Run now** をクリックし、権限プロンプトを監視し、各プロンプトに対して「常に許可」を選択します。そのタスクの将来の実行は、プロンプトなしで同じツールを自動承認します。タスクの詳細ページからこれらの承認をレビューして取り消すことができます。

95 95 

devcontainer.md +1 −1

Details

27 27 

28 <img src="https://mintcdn.com/claude-code/YvJyjZfd9yMihr0i/images/devcontainer-architecture-dark.svg?fit=max&auto=format&n=YvJyjZfd9yMihr0i&q=85&s=ef00c8e25b1ea7a3a152895f1488831b" className="hidden dark:block" alt="ホスト上のエディタが Docker 開発コンテナに接続する図。Claude Code、ターミナル、ビルドツールはコンテナ内で実行されます。ホストリポジトリはコンテナにバインドマウントされ、ワークスペースとして機能します。" width="640" height="300" data-path="images/devcontainer-architecture-dark.svg" />28 <img src="https://mintcdn.com/claude-code/YvJyjZfd9yMihr0i/images/devcontainer-architecture-dark.svg?fit=max&auto=format&n=YvJyjZfd9yMihr0i&q=85&s=ef00c8e25b1ea7a3a152895f1488831b" className="hidden dark:block" alt="ホスト上のエディタが Docker 開発コンテナに接続する図。Claude Code、ターミナル、ビルドツールはコンテナ内で実行されます。ホストリポジトリはコンテナにバインドマウントされ、ワークスペースとして機能します。" width="640" height="300" data-path="images/devcontainer-architecture-dark.svg" />

29 29 

30 開発コンテナは Docker コンテナとして実行され、マシン上またはGitHub Codespaces などのクラウドホスト上で実行されます。Dev Containers 仕様をサポートするエディタ(VS Code、GitHub Codespaces、JetBrains IDE、Cursor など)がそのコンテナに接続します。通常どおりエディタでファイルを参照および編集しますが、統合ターミナル、言語サーバー、ビルドツールはすべてホストではなくコンテナ内で実行されます。プレーン Vim などの開発コンテナをサポートしていないエディタはこのワークフローの対象外です。30 開発コンテナは Docker コンテナとして実行され、マシン上または GitHub Codespaces などのクラウドホスト上で実行されます。Dev Containers 仕様をサポートするエディタ(VS Code、GitHub Codespaces、JetBrains IDE、Cursor など)がそのコンテナに接続します。通常どおりエディタでファイルを参照および編集しますが、統合ターミナル、言語サーバー、ビルドツールはすべてホストではなくコンテナ内で実行されます。プレーン Vim などの開発コンテナをサポートしていないエディタはこのワークフローの対象外です。

31 31 

32 Claude Code はコンテナ内で実行されるため、プロジェクトのツールチェーンの残りの部分と同じファイル、依存関係、ツールが表示されます。VS Code では、[Claude Code 拡張機能パネル](/ja/vs-code)を使用するか、統合ターミナルで `claude` を実行できます。どちらもコンテナ内で実行され、同じ `~/.claude` 設定を共有します。32 Claude Code はコンテナ内で実行されるため、プロジェクトのツールチェーンの残りの部分と同じファイル、依存関係、ツールが表示されます。VS Code では、[Claude Code 拡張機能パネル](/ja/vs-code)を使用するか、統合ターミナルで `claude` を実行できます。どちらもコンテナ内で実行され、同じ `~/.claude` 設定を共有します。

33</Accordion>33</Accordion>

discover-plugins.md +101 −33

Details

10 10 

11独自のマーケットプレイスを作成して配布したいですか?[プラグインマーケットプレイスを作成して配布する](/ja/plugin-marketplaces)を参照してください。11独自のマーケットプレイスを作成して配布したいですか?[プラグインマーケットプレイスを作成して配布する](/ja/plugin-marketplaces)を参照してください。

12 12 

13## マーケットプレイスの仕組み13<h2 id="how-marketplaces-work">

14 マーケットプレイスの仕組み

15</h2>

14 16 

15マーケットプレイスは、他の誰かが作成して共有したプラグインのカタログです。マーケットプレイスを使用するのは 2 段階のプロセスです:17マーケットプレイスは、他の誰かが作成して共有したプラグインのカタログです。マーケットプレイスを使用するのは 2 段階のプロセスです:

16 18 


26 28 

27アプリストアを追加するようなものと考えてください。ストアを追加するとそのコレクションを参照できるようになりますが、どのアプリをダウンロードするかは個別に選択します。29アプリストアを追加するようなものと考えてください。ストアを追加するとそのコレクションを参照できるようになりますが、どのアプリをダウンロードするかは個別に選択します。

28 30 

29## 公式 Anthropic マーケットプレイス31<h2 id="official-anthropic-marketplace">

32 公式 Anthropic マーケットプレイス

33</h2>

30 34 

31公式 Anthropic マーケットプレイス(`claude-plugins-official`)は Claude Code を起動すると自動的に利用可能になります。`/plugin` を実行して **Discover** タブに移動し、利用可能なものを参照するか、[claude.com/plugins](https://claude.com/plugins)でカタログを表示してください。35公式 Anthropic マーケットプレイス(`claude-plugins-official`)は Claude Code を起動すると自動的に利用可能になります。`/plugin` を実行して **Discover** タブに移動し、利用可能なものを参照するか、[claude.com/plugins](https://claude.com/plugins)でカタログを表示してください。

32 36 


44 48 

45公式マーケットプレイスには、プラグインのいくつかのカテゴリが含まれています:49公式マーケットプレイスには、プラグインのいくつかのカテゴリが含まれています:

46 50 

47### コード インテリジェンス51<h3 id="code-intelligence">

52 コード インテリジェンス

53</h3>

48 54 

49コード インテリジェンス プラグインは Claude Code の組み込み LSP ツールを有効にし、Claude が定義にジャンプしたり、参照を見つけたり、編集直後に型エラーを確認したりできるようにします。これらのプラグインは [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) 接続を構成します。これは VS Code のコード インテリジェンスを強化する同じテクノロジーです。55コード インテリジェンス プラグインは Claude Code の組み込み LSP ツールを有効にし、Claude が定義にジャンプしたり、参照を見つけたり、編集直後に型エラーを確認したりできるようにします。これらのプラグインは [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) 接続を構成します。これは VS Code のコード インテリジェンスを強化する同じテクノロジーです。

50 56 


70 プラグインをインストール後に `/plugin` Errors タブに `Executable not found in $PATH` が表示される場合は、上記の表から必要なバイナリをインストールしてください。76 プラグインをインストール後に `/plugin` Errors タブに `Executable not found in $PATH` が表示される場合は、上記の表から必要なバイナリをインストールしてください。

71</Note>77</Note>

72 78 

73#### コード インテリジェンス プラグインから Claude が得られるもの79<h4 id="what-claude-gains-from-code-intelligence-plugins">

80 コード インテリジェンス プラグインから Claude が得られるもの

81</h4>

74 82 

75コード インテリジェンス プラグインがインストールされ、その言語サーバーバイナリが利用可能になると、Claude は 2 つの機能を得られます:83コード インテリジェンス プラグインがインストールされ、その言語サーバーバイナリが利用可能になると、Claude は 2 つの機能を得られます:

76 84 


79 87 

80問題が発生した場合は、[コード インテリジェンスのトラブルシューティング](#code-intelligence-issues)を参照してください。88問題が発生した場合は、[コード インテリジェンスのトラブルシューティング](#code-intelligence-issues)を参照してください。

81 89 

82### 外部統合90<h3 id="external-integrations">

91 外部統合

92</h3>

83 93 

84これらのプラグインは事前構成された [MCP サーバー](/ja/mcp)をバンドルしているため、手動セットアップなしで Claude を外部サービスに接続できます:94これらのプラグインは事前構成された [MCP サーバー](/ja/mcp)をバンドルしているため、手動セットアップなしで Claude を外部サービスに接続できます:

85 95 


90* **コミュニケーション**: `slack`100* **コミュニケーション**: `slack`

91* **監視**: `sentry`101* **監視**: `sentry`

92 102 

93### 自動セキュリティレビュー103<h3 id="automatic-security-review">

104 自動セキュリティレビュー

105</h3>

94 106 

95`security-guidance` プラグインは Claude が行う各変更を一般的な脆弱性についてレビューし、Claude に見つかったものを修正するよう指示します。[Claude がコードを書く際にセキュリティの問題をキャッチする](/ja/security-guidance)を参照して、何をチェックするか、プロジェクト固有のルールを追加する方法を確認してください。107`security-guidance` プラグインは Claude が行う各変更を一般的な脆弱性についてレビューし、Claude に見つかったものを修正するよう指示します。[Claude がコードを書く際にセキュリティの問題をキャッチする](/ja/security-guidance)を参照して、何をチェックするか、プロジェクト固有のルールを追加する方法を確認してください。

96 108 

97### 開発ワークフロー109<h3 id="development-workflows">

110 開発ワークフロー

111</h3>

98 112 

99一般的な開発タスク用のスキルとエージェントを追加するプラグイン:113一般的な開発タスク用のスキルとエージェントを追加するプラグイン:

100 114 


103* **agent-sdk-dev**: Claude Agent SDK で構築するためのツール117* **agent-sdk-dev**: Claude Agent SDK で構築するためのツール

104* **plugin-dev**: 独自のプラグインを作成するためのツールキット118* **plugin-dev**: 独自のプラグインを作成するためのツールキット

105 119 

106### 出力スタイル120<h3 id="output-styles">

121 出力スタイル

122</h3>

107 123 

108Claude の応答方法をカスタマイズします:124Claude の応答方法をカスタマイズします:

109 125 

110* **explanatory-output-style**: 実装の選択に関する教育的な洞察126* **explanatory-output-style**: 実装の選択に関する教育的な洞察

111* **learning-output-style**: スキル構築のためのインタラクティブな学習モード127* **learning-output-style**: スキル構築のためのインタラクティブな学習モード

112 128 

113## コミュニティ マーケットプレイス129<h2 id="community-marketplace">

130 コミュニティ マーケットプレイス

131</h2>

114 132 

115[`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community)のコミュニティ マーケットプレイスは、Anthropic の自動検証とセキュリティ スクリーニングに合格したサードパーティ プラグインをホストしています。各プラグインはカタログ内の特定のコミット SHA に固定されています。公式マーケットプレイスとは異なり、手動で追加します:133[`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community)のコミュニティ マーケットプレイスは、Anthropic の自動検証とセキュリティ スクリーニングに合格したサードパーティ プラグインをホストしています。各プラグインはカタログ内の特定のコミット SHA に固定されています。公式マーケットプレイスとは異なり、手動で追加します:

116 134 


126 144 

127独自のプラグインをコミュニティ マーケットプレイスに送信するには、プラグイン作成ガイドの[プラグインをコミュニティ マーケットプレイスに送信する](/ja/plugins#submit-your-plugin-to-the-community-marketplace)を参照してください。145独自のプラグインをコミュニティ マーケットプレイスに送信するには、プラグイン作成ガイドの[プラグインをコミュニティ マーケットプレイスに送信する](/ja/plugins#submit-your-plugin-to-the-community-marketplace)を参照してください。

128 146 

129## 試してみる: デモマーケットプレイスを追加する147<h2 id="try-it-add-the-demo-marketplace">

148 試してみる: デモマーケットプレイスを追加する

149</h2>

130 150 

131Anthropic は、プラグインシステムで何が可能かを示す例プラグインを含む [デモプラグインマーケットプレイス](https://github.com/anthropics/claude-code/tree/main/plugins)(`claude-code-plugins`)も管理しています。公式マーケットプレイスとは異なり、このマーケットプレイスは手動で追加する必要があります。151Anthropic は、プラグインシステムで何が可能かを示す例プラグインを含む [デモプラグインマーケットプレイス](https://github.com/anthropics/claude-code/tree/main/plugins)(`claude-code-plugins`)も管理しています。公式マーケットプレイスとは異なり、このマーケットプレイスは手動で追加する必要があります。

132 152 


149 * **Marketplaces**: 追加したマーケットプレイスを追加、削除、または更新169 * **Marketplaces**: 追加したマーケットプレイスを追加、削除、または更新

150 * **Errors**: プラグイン読み込みエラーを表示170 * **Errors**: プラグイン読み込みエラーを表示

151 171 

152 **Discover** タブに移動して、追加したばかりのマーケットプレイスからプラグインを確認してください。{/* min-version: 2.1.154 */}現在の作業ディレクトリに関連するとマークされたプラグインは、**suggested for this directory** ラベル付きで上部に固定されます。172 **Discover** タブに移動して、追加したばかりのマーケットプレイスからプラグインを確認してください。{/* min-version: 2.1.154 */}管理者が [`pluginSuggestionMarketplaces`](/ja/settings#available-settings) マネージド設定を通じてマーケットプレイスをホワイトリストに登録している場合、現在の作業ディレクトリに関連するとマークされたプラグインは、**suggested for this directory** ラベル付きで上部に固定されます。

153 </Step>173 </Step>

154 174 

155 <Step title="プラグインをインストールする">175 <Step title="プラグインをインストールする">


193 213 

194このガイドの残りの部分では、マーケットプレイスを追加し、プラグインをインストールし、構成を管理するすべての方法について説明します。214このガイドの残りの部分では、マーケットプレイスを追加し、プラグインをインストールし、構成を管理するすべての方法について説明します。

195 215 

196## マーケットプレイスを追加する216<h2 id="add-marketplaces">

217 マーケットプレイスを追加する

218</h2>

197 219 

198`/plugin marketplace add` コマンドを使用して、異なるソースからマーケットプレイスを追加します。220`/plugin marketplace add` コマンドを使用して、異なるソースからマーケットプレイスを追加します。

199 221 


206* **ローカル パス**: ディレクトリまたは `marketplace.json` ファイルへの直接パス228* **ローカル パス**: ディレクトリまたは `marketplace.json` ファイルへの直接パス

207* **リモート URL**: ホストされた `marketplace.json` ファイルへの直接 URL229* **リモート URL**: ホストされた `marketplace.json` ファイルへの直接 URL

208 230 

209### GitHub から追加する231<h3 id="add-from-github">

232 GitHub から追加する

233</h3>

210 234 

211`.claude-plugin/marketplace.json` ファイルを含む GitHub リポジトリを `owner/repo` 形式を使用して追加します。ここで `owner` は GitHub ユーザー名または組織で、`repo` はリポジトリ名です。235`.claude-plugin/marketplace.json` ファイルを含む GitHub リポジトリを `owner/repo` 形式を使用して追加します。ここで `owner` は GitHub ユーザー名または組織で、`repo` はリポジトリ名です。

212 236 


216/plugin marketplace add anthropics/claude-code240/plugin marketplace add anthropics/claude-code

217```241```

218 242 

219### 他の Git ホストから追加する243<h3 id="add-from-other-git-hosts">

244 他の Git ホストから追加する

245</h3>

220 246 

221完全な URL を提供することで、任意の git リポジトリを追加します。これは GitLab、Bitbucket、自己ホスト サーバーを含む任意の Git ホストで機能します。`.git` サフィックスを含めて、Claude Code がリポジトリをクローンするようにしてください。URL をホストされた `marketplace.json` ファイルへの直接リンクとして扱うのではなく。247完全な URL を提供することで、任意の git リポジトリを追加します。これは GitLab、Bitbucket、自己ホスト サーバーを含む任意の Git ホストで機能します。`.git` サフィックスを含めて、Claude Code がリポジトリをクローンするようにしてください。URL をホストされた `marketplace.json` ファイルへの直接リンクとして扱うのではなく。

222 248 


238/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0264/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

239```265```

240 266 

241### ローカル パスから追加する267<h3 id="add-from-local-paths">

268 ローカル パスから追加する

269</h3>

242 270 

243`.claude-plugin/marketplace.json` ファイルを含むローカル ディレクトリを追加します:271`.claude-plugin/marketplace.json` ファイルを含むローカル ディレクトリを追加します:

244 272 


252/plugin marketplace add ./path/to/marketplace.json280/plugin marketplace add ./path/to/marketplace.json

253```281```

254 282 

255### リモート URL から追加する283<h3 id="add-from-remote-urls">

284 リモート URL から追加する

285</h3>

256 286 

257URL 経由でリモート `marketplace.json` ファイルを追加します:287URL 経由でリモート `marketplace.json` ファイルを追加します:

258 288 


264 URL ベースのマーケットプレイスは、Git ベースのマーケットプレイスと比べていくつかの制限があります。プラグインをインストールするときに「path not found」エラーが発生した場合は、[トラブルシューティング](/ja/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照してください。294 URL ベースのマーケットプレイスは、Git ベースのマーケットプレイスと比べていくつかの制限があります。プラグインをインストールするときに「path not found」エラーが発生した場合は、[トラブルシューティング](/ja/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照してください。

265</Note>295</Note>

266 296 

267## プラグインをインストールする297<h2 id="install-plugins">

298 プラグインをインストールする

299</h2>

268 300 

269マーケットプレイスを追加したら、プラグインを直接インストールできます(デフォルトではユーザー スコープにインストール):301マーケットプレイスを追加したら、プラグインを直接インストールできます(デフォルトではユーザー スコープにインストール):

270 302 


284 プラグインをインストールする前に、それを信頼していることを確認してください。Anthropic はプラグインに含まれる MCP サーバー、ファイル、またはその他のソフトウェアを制御せず、意図したとおりに機能することを確認できません。詳細については、各プラグインのホームページを確認してください。316 プラグインをインストールする前に、それを信頼していることを確認してください。Anthropic はプラグインに含まれる MCP サーバー、ファイル、またはその他のソフトウェアを制御せず、意図したとおりに機能することを確認できません。詳細については、各プラグインのホームページを確認してください。

285</Warning>317</Warning>

286 318 

287## インストール済みプラグインを管理する319<h2 id="manage-installed-plugins">

320 インストール済みプラグインを管理する

321</h2>

288 322 

289`/plugin` を実行して **Installed** タブに移動し、プラグインを表示、有効化、無効化、またはアンインストールします。リストはスコープでグループ化され、問題が最初に表示されるようにソートされます。読み込みエラーまたは未解決の依存関係を持つプラグインが上部に表示され、その後にお気に入りが続き、無効化されたプラグインは下部の折りたたまれたヘッダーの後ろに折りたたまれます。323`/plugin` を実行して **Installed** タブに移動し、プラグインを表示、有効化、無効化、またはアンインストールします。リストはスコープでグループ化され、問題が最初に表示されるようにソートされます。読み込みエラーまたは未解決の依存関係を持つプラグインが上部に表示され、その後にお気に入りが続き、無効化されたプラグインは下部の折りたたまれたヘッダーの後ろに折りたたまれます。

290 324 


294* 入力してプラグイン名または説明でフィルタリング328* 入力してプラグイン名または説明でフィルタリング

295* Enter を押してプラグインの詳細ビューを開き、有効化、無効化、またはアンインストール329* Enter を押してプラグインの詳細ビューを開き、有効化、無効化、またはアンインストール

296 330 

297プラグインをインストールして依存関係を宣言するとインストール出力にはそれと共に自動インストールされた依存関係が一覧表示されます331詳細ビューにはプラグインが提供するコンポーネントが表示されます。コマンドskills、agents、hooks、MCP サーバー、LSP サーバーです同じインベントリは、コマンドラインから `claude plugin details` で利用できます。

332 

333依存関係を宣言するプラグインをインストールすると、インストール出力には、それと共に自動インストールされた依存関係が一覧表示されます。

298 334 

299直接コマンドでプラグインを管理することもできます。335直接コマンドでプラグインを管理することもできます。

300 336 

337メニューを開かずにインストール済みプラグインを一覧表示します:

338 

339```shell theme={null}

340/plugin list

341```

342 

343`--enabled` または `--disabled` を渡して、その状態のプラグインのみを表示します。

344 

301プラグインをアンインストールせずに無効化します:345プラグインをアンインストールせずに無効化します:

302 346 

303```shell theme={null}347```shell theme={null}


323claude plugin uninstall formatter@your-org --scope project367claude plugin uninstall formatter@your-org --scope project

324```368```

325 369 

326### プラグインの変更をリスタートなしで適用する370<h3 id="apply-plugin-changes-without-restarting">

371 プラグインの変更をリスタートなしで適用する

372</h3>

327 373 

328セッション中にプラグインをインストール、有効化、または無効化すると、`/reload-plugins` を実行してすべての変更をリスタートなしで取得します:374セッション中にプラグインをインストール、有効化、または無効化すると、`/reload-plugins` を実行してすべての変更をリスタートなしで取得します:

329 375 


331/reload-plugins377/reload-plugins

332```378```

333 379 

334Claude Code はすべてのアクティブなプラグインをリロードし、プラグイン、スキルエージェントフック、プラグイン MCP サーバー、プラグイン LSP サーバーのカウントを表示します。380Claude Code はすべてのアクティブなプラグインをリロードし、プラグイン、skillsagentshooks、プラグイン MCP サーバー、プラグイン LSP サーバーのカウントを表示します。

335 381 

336リロードには次のリクエストでトークンコストがあります。新しくロードされたコンポーネントは会話に追加されたコンテンツで自身を発表し、既存の履歴はプロンプトキャッシュから読み込まれたままです。MCP サーバーを提供するプラグインは、そのツールが [tool search](/ja/mcp#scale-with-mcp-tool-search) によって遅延されていない場合、より多くのコストがかかります。変更はキャッシュを無効にし、次のリクエストは会話全体を再度読み込みます。詳細については、[プラグインの有効化または無効化](/ja/prompt-caching#enabling-or-disabling-a-plugin) を参照してください。382リロードには次のリクエストでトークンコストがあります。新しくロードされたコンポーネントは会話に追加されたコンテンツで自身を発表し、既存の履歴はプロンプトキャッシュから読み込まれたままです。MCP サーバーを提供するプラグインは、そのツールが [tool search](/ja/mcp#scale-with-mcp-tool-search) によって遅延されていない場合、より多くのコストがかかります。変更はキャッシュを無効にし、次のリクエストは会話全体を再度読み込みます。{/* min-version: 2.1.163 */}その場合、`/reload-plugins` は警告を表示し、リロードを適用しません。`--force` を渡して、とにかく適用します。詳細については、[プラグインの有効化または無効化](/ja/prompt-caching#enabling-or-disabling-a-plugin) を参照してください。

337 383 

338## マーケットプレイスを管理する384<h2 id="manage-marketplaces">

385 マーケットプレイスを管理する

386</h2>

339 387 

340インタラクティブな `/plugin` インターフェースまたは CLI コマンドを使用してマーケットプレイスを管理できます。388インタラクティブな `/plugin` インターフェースまたは CLI コマンドを使用してマーケットプレイスを管理できます。

341 389 

342### インタラクティブ インターフェースを使用する390<h3 id="use-the-interactive-interface">

391 インタラクティブ インターフェースを使用する

392</h3>

343 393 

344`/plugin` を実行して **Marketplaces** タブに移動して、以下を実行します:394`/plugin` を実行して **Marketplaces** タブに移動して、以下を実行します:

345 395 


348* マーケットプレイス リストを更新して最新のプラグインを取得398* マーケットプレイス リストを更新して最新のプラグインを取得

349* 不要になったマーケットプレイスを削除399* 不要になったマーケットプレイスを削除

350 400 

351### CLI コマンドを使用する401<h3 id="use-cli-commands">

402 CLI コマンドを使用する

403</h3>

352 404 

353直接コマンドでマーケットプレイスを管理することもできます。405直接コマンドでマーケットプレイスを管理することもできます。

354 406 


374 マーケットプレイスを削除すると、そこからインストールしたプラグインがアンインストールされます。426 マーケットプレイスを削除すると、そこからインストールしたプラグインがアンインストールされます。

375</Warning>427</Warning>

376 428 

377### 自動更新を構成する429<h3 id="configure-auto-updates">

430 自動更新を構成する

431</h3>

378 432 

379Claude Code はスタートアップ時にマーケットプレイスとそのインストール済みプラグインを自動的に更新できます。マーケットプレイスで自動更新が有効になっている場合、Claude Code はマーケットプレイス データを更新し、インストール済みプラグインを最新バージョンに更新します。プラグインが更新された場合、`/reload-plugins` を実行するよう促すメッセージが表示されます。433Claude Code はスタートアップ時にマーケットプレイスとそのインストール済みプラグインを自動的に更新できます。マーケットプレイスで自動更新が有効になっている場合、Claude Code はマーケットプレイス データを更新し、インストール済みプラグインを最新バージョンに更新します。プラグインが更新された場合、`/reload-plugins` を実行するよう促すメッセージが表示されます。

380 434 


400 454 

401これは Claude Code の更新を手動で管理したいが、プラグイン更新を自動的に受け取りたい場合に便利です。455これは Claude Code の更新を手動で管理したいが、プラグイン更新を自動的に受け取りたい場合に便利です。

402 456 

403## チーム マーケットプレイスを構成する457<h2 id="configure-team-marketplaces">

458 チーム マーケットプレイスを構成する

459</h2>

404 460 

405チーム管理者は、`.claude/settings.json` にマーケットプレイス構成を追加することで、プロジェクトの自動マーケットプレイス インストールを設定できます。チーム メンバーがリポジトリ フォルダを信頼すると、Claude Code はこれらのマーケットプレイスとプラグインをインストールするよう促します。461チーム管理者は、`.claude/settings.json` にマーケットプレイス構成を追加することで、プロジェクトの自動マーケットプレイス インストールを設定できます。チーム メンバーがリポジトリ フォルダを信頼すると、Claude Code はこれらのマーケットプレイスとプラグインをインストールするよう促します。

406 462 


421 477 

422`extraKnownMarketplaces` と `enabledPlugins` を含む完全な構成オプションについては、[プラグイン設定](/ja/settings#plugin-settings)を参照してください。478`extraKnownMarketplaces` と `enabledPlugins` を含む完全な構成オプションについては、[プラグイン設定](/ja/settings#plugin-settings)を参照してください。

423 479 

424## セキュリティ480<h2 id="security">

481 セキュリティ

482</h2>

425 483 

426プラグインとマーケットプレイスは、ユーザー権限でマシン上で任意のコードを実行できる、非常に信頼されたコンポーネントです。信頼できるソースからのみプラグインをインストールし、マーケットプレイスを追加してください。組織は、[管理マーケットプレイス制限](/ja/plugin-marketplaces#managed-marketplace-restrictions)を使用してユーザーが追加できるマーケットプレイスを制限できます。484プラグインとマーケットプレイスは、ユーザー権限でマシン上で任意のコードを実行できる、非常に信頼されたコンポーネントです。信頼できるソースからのみプラグインをインストールし、マーケットプレイスを追加してください。組織は、[管理マーケットプレイス制限](/ja/plugin-marketplaces#managed-marketplace-restrictions)を使用してユーザーが追加できるマーケットプレイスを制限できます。

427 485 

428## トラブルシューティング486<h2 id="troubleshooting">

487 トラブルシューティング

488</h2>

429 489 

430### /plugin コマンドが認識されない490<h3 id="/plugin-command-not-recognized">

491 /plugin コマンドが認識されない

492</h3>

431 493 

432「unknown command」が表示されるか、`/plugin` コマンドが表示されない場合:494「unknown command」が表示されるか、`/plugin` コマンドが表示されない場合:

433 495 


438 * **ネイティブ インストーラー**: [セットアップ](/ja/setup)からインストール コマンドを再実行します。500 * **ネイティブ インストーラー**: [セットアップ](/ja/setup)からインストール コマンドを再実行します。

4393. **Claude Code を再起動する**: 更新後、ターミナルを再起動して `claude` を再度実行します。5013. **Claude Code を再起動する**: 更新後、ターミナルを再起動して `claude` を再度実行します。

440 502 

441### 一般的な問題503<h3 id="common-issues">

504 一般的な問題

505</h3>

442 506 

443* **マーケットプレイスが読み込まれない**: URL がアクセス可能であり、`.claude-plugin/marketplace.json` がパスに存在することを確認してください。507* **マーケットプレイスが読み込まれない**: URL がアクセス可能であり、`.claude-plugin/marketplace.json` がパスに存在することを確認してください。

444* **プラグイン インストール エラー**: プラグイン ソース URL がアクセス可能であり、リポジトリが公開されている(またはアクセス権がある)ことを確認してください。508* **プラグイン インストール エラー**: プラグイン ソース URL がアクセス可能であり、リポジトリが公開されている(またはアクセス権がある)ことを確認してください。


447 511 

448詳細なトラブルシューティングとソリューションについては、マーケットプレイス ガイドの [トラブルシューティング](/ja/plugin-marketplaces#troubleshooting)を参照してください。デバッグ ツールについては、[デバッグと開発ツール](/ja/plugins-reference#debugging-and-development-tools)を参照してください。512詳細なトラブルシューティングとソリューションについては、マーケットプレイス ガイドの [トラブルシューティング](/ja/plugin-marketplaces#troubleshooting)を参照してください。デバッグ ツールについては、[デバッグと開発ツール](/ja/plugins-reference#debugging-and-development-tools)を参照してください。

449 513 

450### コード インテリジェンスの問題514<h3 id="code-intelligence-issues">

515 コード インテリジェンスの問題

516</h3>

451 517 

452* **言語サーバーが起動しない**: バイナリがインストールされており、`$PATH` で利用可能であることを確認してください。詳細については、`/plugin` Errors タブを確認してください。518* **言語サーバーが起動しない**: バイナリがインストールされており、`$PATH` で利用可能であることを確認してください。詳細については、`/plugin` Errors タブを確認してください。

453* **メモリ使用量が多い**: `rust-analyzer` や `pyright` などの言語サーバーは、大規模なプロジェクトで大量のメモリを消費する可能性があります。メモリの問題が発生した場合は、`/plugin disable <plugin-name>` でプラグインを無効化し、代わりに Claude の組み込み検索ツールを使用してください。519* **メモリ使用量が多い**: `rust-analyzer` や `pyright` などの言語サーバーは、大規模なプロジェクトで大量のメモリを消費する可能性があります。メモリの問題が発生した場合は、`/plugin disable <plugin-name>` でプラグインを無効化し、代わりに Claude の組み込み検索ツールを使用してください。

454* **モノレポでの誤検知診断**: ワークスペースが正しく構成されていない場合、言語サーバーは内部パッケージの未解決インポート エラーを報告する可能性があります。これらはコードを編集する Claude の能力に影響しません。520* **モノレポでの誤検知診断**: ワークスペースが正しく構成されていない場合、言語サーバーは内部パッケージの未解決インポート エラーを報告する可能性があります。これらはコードを編集する Claude の能力に影響しません。

455 521 

456## 次のステップ522<h2 id="next-steps">

523 次のステップ

524</h2>

457 525 

458* **独自のプラグインを構築する**: スキル、エージェント、フックを作成するには、[プラグイン](/ja/plugins)を参照してください。526* **独自のプラグインを構築する**: スキル、エージェント、フックを作成するには、[プラグイン](/ja/plugins)を参照してください。

459* **マーケットプレイスを作成する**: チームまたはコミュニティにプラグインを配布するには、[プラグイン マーケットプレイスを作成](/ja/plugin-marketplaces)を参照してください。527* **マーケットプレイスを作成する**: チームまたはコミュニティにプラグインを配布するには、[プラグイン マーケットプレイスを作成](/ja/plugin-marketplaces)を参照してください。

env-vars.md +33 −18

Details

73選択したファイルは、変数が適用される対象を制御します:73選択したファイルは、変数が適用される対象を制御します:

74 74 

75| ファイル | 適用対象 |75| ファイル | 適用対象 |

76| :---------------------------- | :------------------------------ |76| :---------------------------- | :---------------------------------------------- |

77| `~/.claude/settings.json` | すべてのプロジェクトで、あなた |77| `~/.claude/settings.json` | すべてのプロジェクトで、あなた |

78| `.claude/settings.json` | プロジェクトで作業しているすべての人。ソース管理にチェックイン |78| `.claude/settings.json` | プロジェクトで作業しているすべての人。ソース管理にチェックイン |

79| `.claude/settings.local.json` | このプロジェクトでのみ、あなた。チェックインされない |79| `.claude/settings.local.json` | このプロジェクトでのみ、あなた(手動で作成した場合は gitignore に追加してください) |

80| 管理設定 | 組織内のすべての人。管理者によってデプロイ |80| 管理設定 | 組織内のすべての人。管理者によってデプロイ |

81 81 

82各ファイルの場所については [設定ファイル](/ja/settings#settings-files) を、複数のファイルが同じ変数を設定する場合の組み合わせ方については [設定の優先順位](/ja/settings#settings-precedence) を参照してください。82各ファイルの場所については [設定ファイル](/ja/settings#settings-files) を、複数のファイルが同じ変数を設定する場合の組み合わせ方については [設定の優先順位](/ja/settings#settings-precedence) を参照してください。


96</h2>96</h2>

97 97 

98| 変数 | 目的 |98| 変数 | 目的 |

99| :------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |99| :------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

100| `ANTHROPIC_API_KEY` | `X-Api-Key` ヘッダーとして送信される API キー。設定されている場合、ログインしていても Claude Pro、Max、Team、または Enterprise サブスクリプションの代わりにこのキーが使用されます。非対話モード(`-p`)では、キーが存在する場合は常に使用されます。対話モードでは、キーがサブスクリプションをオーバーライドする前に一度承認するよう求められます。代わりにサブスクリプションを使用するには、`unset ANTHROPIC_API_KEY` を実行してください |100| `ANTHROPIC_API_KEY` | `X-Api-Key` ヘッダーとして送信される API キー。設定されている場合、ログインしていても Claude Pro、Max、Team、または Enterprise サブスクリプションの代わりにこのキーが使用されます。非対話モード(`-p`)では、キーが存在する場合は常に使用されます。対話モードでは、キーがサブスクリプションをオーバーライドする前に一度承認するよう求められます。代わりにサブスクリプションを使用するには、`unset ANTHROPIC_API_KEY` を実行してください |

101| `ANTHROPIC_AUTH_TOKEN` | `Authorization` ヘッダーのカスタム値(ここで設定した値には `Bearer ` が接頭辞として付けられます) |101| `ANTHROPIC_AUTH_TOKEN` | `Authorization` ヘッダーのカスタム値(ここで設定した値には `Bearer ` が接頭辞として付けられます) |

102| `ANTHROPIC_AWS_API_KEY` | [Claude Platform on AWS](/ja/claude-platform-on-aws) のワークスペース API キー。AWS コンソールで生成されます。`x-api-key` として送信され、AWS SigV4 よりも優先されます |102| `ANTHROPIC_AWS_API_KEY` | [Claude Platform on AWS](/ja/claude-platform-on-aws) のワークスペース API キー。AWS コンソールで生成されます。`x-api-key` として送信され、AWS SigV4 よりも優先されます |


112| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` ピッカーのカスタムモデルエントリの表示説明。設定されていない場合、デフォルトは `Custom model (<model-id>)` です |112| `ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION` | `/model` ピッカーのカスタムモデルエントリの表示説明。設定されていない場合、デフォルトは `Custom model (<model-id>)` です |

113| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` ピッカーのカスタムモデルエントリの表示名。設定されていない場合、デフォルトはモデル ID です |113| `ANTHROPIC_CUSTOM_MODEL_OPTION_NAME` | `/model` ピッカーのカスタムモデルエントリの表示名。設定されていない場合、デフォルトはモデル ID です |

114| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | [モデル設定](/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |114| `ANTHROPIC_CUSTOM_MODEL_OPTION_SUPPORTED_CAPABILITIES` | [モデル設定](/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

115| `ANTHROPIC_DEFAULT_FABLE_MODEL` | [モデル設定](/ja/model-config#environment-variables) を参照してください |

116| `ANTHROPIC_DEFAULT_FABLE_MODEL_DESCRIPTION` | [モデル設定](/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

117| `ANTHROPIC_DEFAULT_FABLE_MODEL_NAME` | [モデル設定](/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

118| `ANTHROPIC_DEFAULT_FABLE_MODEL_SUPPORTED_CAPABILITIES` | [モデル設定](/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

115| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | [モデル設定](/ja/model-config#environment-variables) を参照してください |119| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | [モデル設定](/ja/model-config#environment-variables) を参照してください |

116| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | [モデル設定](/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |120| `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | [モデル設定](/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |

117| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | [モデル設定](/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |121| `ANTHROPIC_DEFAULT_HAIKU_MODEL_NAME` | [モデル設定](/ja/model-config#customize-pinned-model-display-and-capabilities) を参照してください |


133| `ANTHROPIC_VERTEX_BASE_URL` | Vertex AI エンドポイント URL をオーバーライドします。カスタム Vertex エンドポイントを使用する場合、または [LLM ゲートウェイ](/ja/llm-gateway) を通じてルーティングする場合に使用します。[Google Vertex AI](/ja/google-vertex-ai) を参照してください |137| `ANTHROPIC_VERTEX_BASE_URL` | Vertex AI エンドポイント URL をオーバーライドします。カスタム Vertex エンドポイントを使用する場合、または [LLM ゲートウェイ](/ja/llm-gateway) を通じてルーティングする場合に使用します。[Google Vertex AI](/ja/google-vertex-ai) を参照してください |

134| `ANTHROPIC_VERTEX_PROJECT_ID` | Vertex AI リクエスト用の GCP プロジェクト ID。`GCLOUD_PROJECT`、`GOOGLE_CLOUD_PROJECT`、または `GOOGLE_APPLICATION_CREDENTIALS` 認証情報ファイル内のプロジェクトでオーバーライドされます。[Google Vertex AI](/ja/google-vertex-ai) を参照してください |138| `ANTHROPIC_VERTEX_PROJECT_ID` | Vertex AI リクエスト用の GCP プロジェクト ID。`GCLOUD_PROJECT`、`GOOGLE_CLOUD_PROJECT`、または `GOOGLE_APPLICATION_CREDENTIALS` 認証情報ファイル内のプロジェクトでオーバーライドされます。[Google Vertex AI](/ja/google-vertex-ai) を参照してください |

135| `ANTHROPIC_WORKSPACE_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 用のワークスペース ID。フェデレーションルールが複数のワークスペースにスコープされている場合に設定します。トークン交換がターゲットとするワークスペースを認識できるようにします |139| `ANTHROPIC_WORKSPACE_ID` | [ワークロード ID フェデレーション](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 用のワークスペース ID。フェデレーションルールが複数のワークスペースにスコープされている場合に設定します。トークン交換がターゲットとするワークスペースを認識できるようにします |

140| `API_FORCE_IDLE_TIMEOUT` | {/* min-version: 2.1.169 */}バイトが到着しない場合にストリーミングモデル応答を中止する 5 分のアイドルタイムアウトをオーバーライドします。遅い [ゲートウェイ](/ja/llm-gateway) またはローカルモデルが 5 分以上チャンク間で一時停止する場合は、`0` に設定してタイムアウトを無効にします。`1` に設定してすべてのプロバイダーでタイムアウトを保持します。未設定の場合、タイムアウトは Anthropic API 直接接続と [Claude Platform on AWS](/ja/claude-platform-on-aws) では非アクティブです。Claude Code 独自のバイトレベルストリームウォッチドッグが実行されます。[Vertex AI](/ja/google-vertex-ai)、[Foundry](/ja/microsoft-foundry)、[Mantle](/ja/amazon-bedrock#use-the-mantle-endpoint)、[Bedrock](/ja/amazon-bedrock)、ゲートウェイ接続を含むすべての他のプロバイダーではアクティブです。停止したストリームはハングする代わりに中止されます。v2.1.169 以降 |

136| `API_TIMEOUT_MS` | API リクエストのタイムアウト(ミリ秒)(デフォルト:600000、または 10 分。最大:2147483647)。遅いネットワークでリクエストがタイムアウトする場合、またはプロキシを通じてルーティングする場合は、この値を増やしてください。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが直ちに失敗する原因となります |141| `API_TIMEOUT_MS` | API リクエストのタイムアウト(ミリ秒)(デフォルト:600000、または 10 分。最大:2147483647)。遅いネットワークでリクエストがタイムアウトする場合、またはプロキシを通じてルーティングする場合は、この値を増やしてください。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが直ちに失敗する原因となります |

137| `AWS_BEARER_TOKEN_BEDROCK` | 認証用の Bedrock API キー([Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照してください) |142| `AWS_BEARER_TOKEN_BEDROCK` | 認証用の Bedrock API キー([Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照してください) |

138| `BASH_DEFAULT_TIMEOUT_MS` | 長時間実行される bash コマンドのデフォルトタイムアウト(デフォルト:120000、または 2 分) |143| `BASH_DEFAULT_TIMEOUT_MS` | 長時間実行される bash コマンドのデフォルトタイムアウト(デフォルト:120000、または 2 分) |

139| `BASH_MAX_OUTPUT_LENGTH` | bash 出力が完全な出力がファイルに保存され、Claude がパスと短いプレビューを受け取る前の最大文字数。[Bash ツール動作](/ja/tools-reference#bash-tool-behavior) を参照してください |144| `BASH_MAX_OUTPUT_LENGTH` | bash 出力が完全な出力がファイルに保存され、Claude がパスと短いプレビューを受け取る前の最大文字数。[Bash ツール動作](/ja/tools-reference#bash-tool-behavior) を参照してください |

140| `BASH_MAX_TIMEOUT_MS` | 長時間実行される bash コマンドに対してモデルが設定できる最大タイムアウト(デフォルト:600000、または 10 分) |145| `BASH_MAX_TIMEOUT_MS` | 長時間実行される bash コマンドに対してモデルが設定できる最大タイムアウト(デフォルト:600000、または 10 分) |

141| `CCR_FORCE_BUNDLE` | GitHub アクセスが利用可能な場合でも、[`claude --remote`](/ja/claude-code-on-the-web#send-local-repositories-without-github) がローカルリポジトリをバンドルしてアップロードするよう強制するには `1` に設定します |146| `CCR_FORCE_BUNDLE` | GitHub アクセスが利用可能な場合でも、[`claude --remote`](/ja/claude-code-on-the-web#send-local-repositories-without-github) がローカルリポジトリをバンドルしてアップロードするよう強制するには `1` に設定します |

142| `CLAUDECODE` | Claude Code がスポーンするサブプロセス(Bash と PowerShell ツール、tmux セッション、[フック](/ja/hooks) コマンド、[ステータスライン](/ja/statusline) コマンド、stdio [MCP サーバー](/ja/mcp) サブプロセス)で `1` に設定されます。スクリプトが Claude Code によってスポーンされたサブプロセス内で実行されているかどうかを検出するために使用します |147| `CLAUDECODE` | Claude Code がスポーンするサブプロセス(Bash と PowerShell ツール、tmux セッション、[フック](/ja/hooks) コマンド、[ステータスライン](/ja/statusline) コマンド、stdio [MCP サーバー](/ja/mcp) サブプロセス)で `1` に設定されます。IDE 拡張機能は統合ターミナルでもこれを設定します。スクリプトが Claude Code によってスポーンされたサブプロセス内で実行されているかどうかを検出するために使用します。現在のプロセスがツール呼び出しまたはフックによって直接スポーンされたか、Claude Code が開始した stdio MCP サーバー内かどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |

143| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | すべての組み込み [subagent](/ja/sub-agents) タイプ(Explore や Plan など)を無効にするには `1` に設定します。非対話モード(`-p` フラグ)でのみ適用されます。SDK ユーザーが白紙の状態を望む場合に役立ちます |148| `CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS` | すべての組み込み [subagent](/ja/sub-agents) タイプ(Explore や Plan など)を無効にするには `1` に設定します。非対話モード(`-p` フラグ)でのみ適用されます。SDK ユーザーが白紙の状態を望む場合に役立ちます |

144| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK で作成された MCP サーバーからのツール名の `mcp__<server>__` プレフィックスをスキップするには `1` に設定します。ツールは元の名前を使用します。SDK 使用のみ |149| `CLAUDE_AGENT_SDK_MCP_NO_PREFIX` | SDK で作成された MCP サーバーからのツール名の `mcp__<server>__` プレフィックスをスキップするには `1` に設定します。ツールは元の名前を使用します。SDK 使用のみ |

145| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | バックグラウンド subagent のスタルタイムアウト(ミリ秒)。デフォルト `600000`(10 分)。タイマーは各ストリーミング進捗イベントでリセットされます。ウィンドウ内に進捗が到着しない場合、subagent は中止され、タスクは失敗とマークされ、部分的な結果が親に表示されます |150| `CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS` | バックグラウンド subagent のスタルタイムアウト(ミリ秒)。デフォルト `600000`(10 分)。タイマーは各ストリーミング進捗イベントでリセットされます。ウィンドウ内に進捗が到着しない場合、subagent は中止され、タスクは失敗とマークされ、部分的な結果が親に表示されます |

146| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | オートコンパクションがトリガーされるコンテキスト容量のパーセンテージ(1~100)を設定します。デフォルトではオートコンパクションは約 95% の容量でトリガーされます。`50` などの低い値を使用してより早くコンパクトします。デフォルトの閾値より高い値は効果がありません。メインの会話と subagent の両方に適用されます。このパーセンテージは、[ステータスライン](/ja/statusline) で利用可能な `context_window.used_percentage` フィールドと一致します |151| `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` | オートコンパクションがトリガーされるオートコンパクションウィンドウのパーセンテージ(1~100)を設定します。低い値(`50` など)を使用してより早くコンパクトします。この変数はClaude Code がプロアクティブにコンパクトする場合にのみ早期コンパクションを引き起こします:`CLAUDE_CODE_AUTO_COMPACT_WINDOW` が設定されている場合[クラウドセッション](/ja/claude-code-on-the-web) では、[Remote Control](/ja/remote-control) セッションでは、Sonnet 4.6 と Opus 4.6 では [拡張コンテキスト](/ja/model-config#extended-context) なしでは、デフォルトで 200K 境界でコンパクトします。ローカルセッションのデフォルトなど、他の場合では、オートコンパクションは会話がモデルのコンテキスト制限に達したときにトリガーされます。オーバーライドはしきい値を低くすることのみができるため、デフォルトより高い値は効果がありません。メインの会話と subagent の両方に適用されます |

147| `CLAUDE_AUTO_BACKGROUND_TASKS` | 長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にするには `1` に設定します。有効にすると、subagent は約 2 分間実行した後、バックグラウンドに移動されます |152| `CLAUDE_AUTO_BACKGROUND_TASKS` | 長時間実行されるエージェントタスクの自動バックグラウンド化を強制的に有効にするには `1` に設定します。有効にすると、subagent は約 2 分間実行した後、バックグラウンドに移動されます |

148| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | メインセッションの各 Bash または PowerShell コマンドの後に元の作業ディレクトリに戻ります |153| `CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR` | メインセッションの各 Bash または PowerShell コマンドの後に元の作業ディレクトリに戻ります |

149| `CLAUDE_CODE_ACCESSIBILITY` | ネイティブターミナルカーソルを表示したままにし、反転テキストカーソルインジケーターを無効にするには `1` に設定します。macOS Zoom などのスクリーンマグニファイアーがカーソル位置を追跡できるようにします |154| `CLAUDE_CODE_ACCESSIBILITY` | ネイティブターミナルカーソルを表示したままにし、反転テキストカーソルインジケーターを無効にするには `1` に設定します。macOS Zoom などのスクリーンマグニファイアーがカーソル位置を追跡できるようにします |

150| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `--add-dir` で指定されたディレクトリからメモリファイルを読み込むには `1` に設定します。`CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。デフォルトでは、追加ディレクトリはメモリファイルを読み込みません |155| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` | `--add-dir` で指定されたディレクトリからメモリファイルを読み込むには `1` に設定します。`CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。デフォルトでは、追加ディレクトリはメモリファイルを読み込みません |

151| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | [フルスクリーンレンダリング](/ja/fullscreen) で増分更新を送信する代わりに、すべてのフレームで画面全体を再描画するには `1` に設定します。フルスクリーンモードで古いテキストまたは配置が間違ったテキストフラグメントが表示される場合に使用します。Claude Code は Windows のバックグラウンドセッションと [エージェントビュー](/ja/agent-view) でこれを自動的に有効にします |156| `CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT` | [フルスクリーンレンダリング](/ja/fullscreen) で増分更新を送信する代わりに、すべてのフレームで画面全体を再描画するには `1` に設定します。フルスクリーンモードで古いテキストまたは配置が間違ったテキストフラグメントが表示される場合に使用します。Claude Code は Windows のバックグラウンドセッションと [エージェントビュー](/ja/agent-view) でこれを自動的に有効にします |

157| `CLAUDE_CODE_ALWAYS_ENABLE_EFFORT` | Claude Code がモデル ID を努力対応として認識しない場合でも、すべてのリクエストで [努力](/ja/model-config#adjust-effort-level) パラメータを送信するには `1` に設定します。[LLM ゲートウェイ](/ja/llm-gateway) またはカスタム識別子の下でモデルを提供するサードパーティプロバイダーを通じてルーティングする場合に使用します。Claude 3 モデル、Sonnet 4.0 と 4.5、Opus 4.0 と 4.1、Haiku 4.5 を含む、API で努力パラメータを拒否するモデルは、リクエストが失敗しないようにまだ除外されています |

152| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 認証情報をリフレッシュする間隔(ミリ秒)([`apiKeyHelper`](/ja/settings#available-settings) を使用する場合) |158| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | 認証情報をリフレッシュする間隔(ミリ秒)([`apiKeyHelper`](/ja/settings#available-settings) を使用する場合) |

153| `CLAUDE_CODE_ATTRIBUTION_HEADER` | システムプロンプトの開始から属性ブロック(クライアントバージョンとプロンプトフィンガープリント)を省略するには `0` に設定します。これを無効にすると、[LLM ゲートウェイ](/ja/llm-gateway) を通じてルーティングする場合のプロンプトキャッシュヒット率が向上します。Anthropic API キャッシングは影響を受けません |159| `CLAUDE_CODE_ATTRIBUTION_HEADER` | システムプロンプトの開始から属性ブロック(クライアントバージョンとプロンプトフィンガープリント)を省略するには `0` に設定します。これを無効にすると、[LLM ゲートウェイ](/ja/llm-gateway) を通じてルーティングする場合のプロンプトキャッシュヒット率が向上します。Anthropic API キャッシングは影響を受けません |

154| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | オートコンパクション計算に使用されるコンテキスト容量をトークン単位で設定します。デフォルトはモデルのコンテキストウィンドウです:標準モデルの場合は 200K、[拡張コンテキスト](/ja/model-config#extended-context) モデルの場合は 1M。1M モデルで `500000` などの低い値を使用して、コンパクション目的でウィンドウを 500K として扱います。値はモデルの実際のコンテキストウィンドウでキャップされます。`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` はこの値のパーセンテージとして適用されます。この変数を設定すると、コンパクション閾値がステータスラインの `used_percentage` から分離されます。これは常にモデルの完全なコンテキストウィンドウを使用します |160| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | オートコンパクション計算に使用されるコンテキスト容量をトークン単位で設定します。デフォルトはモデルのコンテキストウィンドウです:標準モデルの場合は 200K、[拡張コンテキスト](/ja/model-config#extended-context) モデルの場合は 1M。1M モデルで `500000` などの低い値を使用して、コンパクション目的でウィンドウを 500K として扱います。値はモデルの実際のコンテキストウィンドウでキャップされます。`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` はこの値のパーセンテージとして適用されます。この変数を設定すると、コンパクション閾値がステータスラインの `used_percentage` から分離されます。これは常にモデルの完全なコンテキストウィンドウを使用します |

155| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動 [IDE 接続](/ja/vs-code) をオーバーライドします。デフォルトでは、Claude Code はサポートされている IDE の統合ターミナル内で起動されると自動的に接続します。これを防ぐには `false` に設定します。tmux が親ターミナルを隠すなど、自動検出が失敗した場合に接続を強制するには `true` に設定します。[`autoConnectIde`](/ja/settings#global-config-settings) グローバル設定より優先されます |161| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動 [IDE 接続](/ja/vs-code) をオーバーライドします。デフォルトでは、Claude Code はサポートされている IDE の統合ターミナル内で起動されると自動的に接続します。これを防ぐには `false` に設定します。tmux が親ターミナルを隠すなど、自動検出が失敗した場合に接続を強制するには `true` に設定します。[`autoConnectIde`](/ja/settings#global-config-settings) グローバル設定より優先されます |

156| `CLAUDE_CODE_CERT_STORE` | TLS 接続用の CA 証明書ソースのカンマ区切りリスト。`bundled` は Claude Code に付属する Mozilla CA セットです。`system` はオペレーティングシステムの信頼ストアです。デフォルトは `bundled,system` です |162| `CLAUDE_CODE_CERT_STORE` | TLS 接続用の CA 証明書ソースのカンマ区切りリスト。`bundled` は Claude Code に付属する Mozilla CA セットです。`system` はオペレーティングシステムの信頼ストアです。デフォルトは `bundled,system` です |

163| `CLAUDE_CODE_CHILD_SESSION` | {/* min-version: 2.1.172 */}Claude Code が Bash、PowerShell、Monitor ツール、[フック](/ja/hooks) コマンド、[ステータスライン](/ja/statusline) コマンドを通じてスポーンするサブプロセスで `1` に設定されます。stdio [MCP サーバー](/ja/mcp) サブプロセスでは設定されません。これらは長寿命で、それらをスポーンしたセッションより長く存在します。`CLAUDECODE` とは異なり、これは Claude Code 独自のスポーンパスによってのみ設定され、IDE 拡張機能によっては設定されないため、ネストされたセッションをトップレベルの `claude` から確実に区別します。IDE 統合ターミナルで起動されました。この方法で開始されたネストされた対話的な `claude` TUI は、`--resume`、`--continue`、上矢印履歴、`claude agents` リストから自動的に除外されます。非対話的な `claude -p` セッションは依然として永続化されます。`CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1` を設定してこの除外をオーバーライドします。Claude Code v2.1.172 以降が必須です |

157| `CLAUDE_CODE_CLIENT_CERT` | mTLS 認証用のクライアント証明書ファイルへのパス |164| `CLAUDE_CODE_CLIENT_CERT` | mTLS 認証用のクライアント証明書ファイルへのパス |

158| `CLAUDE_CODE_CLIENT_KEY` | mTLS 認証用のクライアント秘密鍵ファイルへのパス |165| `CLAUDE_CODE_CLIENT_KEY` | mTLS 認証用のクライアント秘密鍵ファイルへのパス |

159| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 暗号化された CLAUDE\_CODE\_CLIENT\_KEY のパスフレーズ(オプション) |166| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | 暗号化された CLAUDE\_CODE\_CLIENT\_KEY のパスフレーズ(オプション) |

160| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルパスをオーバーライドします。名前に反して、これはディレクトリではなくファイルパスです。デバッグモードを `--debug`、`/debug`、または `DEBUG` 環境変数で別途有効にする必要があります。この変数を設定するだけではログが有効になりません。[`--debug-file`](/ja/cli-reference#cli-flags) フラグは両方を一度に行います。デフォルトは `~/.claude/debug/<session-id>.txt` です |167| `CLAUDE_CODE_DEBUG_LOGS_DIR` | デバッグログファイルパスをオーバーライドします。名前に反して、これはディレクトリではなくファイルパスです。デバッグモードを `--debug`、`/debug`、または `DEBUG` 環境変数で別途有効にする必要があります。この変数を設定するだけではログが有効になりません。[`--debug-file`](/ja/cli-reference#cli-flags) フラグは両方を一度に行います。デフォルトは `~/.claude/debug/<session-id>.txt` です |

161| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値:`verbose`、`debug`(デフォルト)、`info`、`warn`、`error`。フルステータスラインコマンド出力などの大量の診断を含めるには `verbose` に設定するか、ノイズを減らすには `error` に上げます |168| `CLAUDE_CODE_DEBUG_LOG_LEVEL` | デバッグログファイルに書き込まれる最小ログレベル。値:`verbose`、`debug`(デフォルト)、`info`、`warn`、`error`。フルステータスラインコマンド出力などの大量の診断を含めるには `verbose` に設定するか、ノイズを減らすには `error` に上げます |

162| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | [1M コンテキストウィンドウ](/ja/model-config#extended-context) サポートを無効にするには `1` に設定します。設定すると、1M モデルバリアントはモデルピッカーで利用できなくなります。コンプライアンス要件のあるエンタープライズ環境に役立ちます |169| `CLAUDE_CODE_DISABLE_1M_CONTEXT` | [1M コンテキストウィンドウ](/ja/model-config#extended-context) サポートを無効にするには `1` に設定します。設定すると、1M モデルバリアントはモデルピッカーで利用できなくなります。コンプライアンス要件のあるエンタープライズ環境に役立ちます |

163| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Opus 4.6 と Sonnet 4.6 の [適応的推論](/ja/model-config#adjust-effort-level) を無効にするには `1` に設定します。`MAX_THINKING_TOKENS` で制御される固定思考予算にフォールバックします。{/* min-version: 2.1.111 */}v2.1.111 以降、Opus 4.7 以降では効果がなく、常に適応的推論を使用します |170| `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` | Opus 4.6 と Sonnet 4.6 の [適応的推論](/ja/model-config#adjust-effort-level) を無効にするには `1` に設定します。`MAX_THINKING_TOKENS` で制御される固定思考予算にフォールバックします。{/* min-version: 2.1.111 */}v2.1.111 以降、Fable 5 には効果がなく、Opus 4.7 以降では常に適応的推論を使用します |

171| `CLAUDE_CODE_DISABLE_ADVISOR_TOOL` | {/* min-version: 2.1.98 */}[アドバイザーツール](/ja/advisor) を無効にするには `1` に設定します。`/advisor` コマンドと `--advisor` フラグが利用できなくなり、設定された `advisorModel` は無視されます。Claude Code v2.1.98 以降が必須です |

164| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | [バックグラウンドエージェントとエージェントビュー](/ja/agent-view) をオフにするには `1` に設定します:`claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザー。[`disableAgentView`](/ja/settings#available-settings) 設定と同等です |172| `CLAUDE_CODE_DISABLE_AGENT_VIEW` | [バックグラウンドエージェントとエージェントビュー](/ja/agent-view) をオフにするには `1` に設定します:`claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザー。[`disableAgentView`](/ja/settings#available-settings) 設定と同等です |

165| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | [フルスクリーンレンダリング](/ja/fullscreen) を無効にするには `1` に設定します。クラシックなメインスクリーンレンダラーを使用します。会話はターミナルのネイティブなスクロールバックに留まるため、`Cmd+f` と tmux コピーモードが通常通り機能します。`CLAUDE_CODE_NO_FLICKER` と [`tui`](/ja/settings#available-settings) 設定より優先されます。`/tui default` で切り替えることもできます。バックグラウンドセッションから開かれた [エージェントビュー](/ja/agent-view) には適用されません。これらは常にフルスクリーンレンダリングを使用します |173| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | [フルスクリーンレンダリング](/ja/fullscreen) を無効にするには `1` に設定します。クラシックなメインスクリーンレンダラーを使用します。会話はターミナルのネイティブなスクロールバックに留まるため、`Cmd+f` と tmux コピーモードが通常通り機能します。`CLAUDE_CODE_NO_FLICKER` と [`tui`](/ja/settings#available-settings) 設定より優先されます。`/tui default` で切り替えることもできます。バックグラウンドセッションから開かれた [エージェントビュー](/ja/agent-view) には適用されません。これらは常にフルスクリーンレンダリングを使用します |

166| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 添付ファイル処理を無効にするには `1` に設定します。`@` 構文を使用したファイルメンションはファイルコンテンツに展開される代わりにプレーンテキストとして送信されます |174| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | 添付ファイル処理を無効にするには `1` に設定します。`@` 構文を使用したファイルメンションはファイルコンテンツに展開される代わりにプレーンテキストとして送信されます |

167| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | [自動メモリ](/ja/memory#auto-memory) を無効にするには `1` に設定します。`--bare` モードまたは [`autoMemoryEnabled: false`](/ja/settings#available-settings) が自動メモリを無効にする場合でも、自動メモリを強制的にオンにするには `0` に設定します。無効にすると、Claude は自動メモリファイルを作成または読み込みません |175| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | [自動メモリ](/ja/memory#auto-memory) を無効にするには `1` に設定します。`--bare` モードまたは [`autoMemoryEnabled: false`](/ja/settings#available-settings) が自動メモリを無効にする場合でも、自動メモリを強制的にオンにするには `0` に設定します。無効にすると、Claude は自動メモリファイルを作成または読み込みません |

168| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Bash と subagent ツールの `run_in_background` パラメータ、自動バックグラウンド化、Ctrl+B ショートカットを含む、すべてのバックグラウンドタスク機能を無効にするには `1` に設定します |176| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | Bash と subagent ツールの `run_in_background` パラメータ、自動バックグラウンド化、Ctrl+B ショートカットを含む、すべてのバックグラウンドタスク機能を無効にするには `1` に設定します |

177| `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` | Claude Code に付属する [スキル](/ja/skills) とワークフローを無効にするには `1` に設定します:バンドルされたスキルとワークフローは完全に削除されます。`/init` などの組み込みスラッシュコマンドは入力可能なままですが、モデルから非表示になります。プラグイン、`.claude/skills/`、`.claude/commands/` からのスキルは影響を受けません。[`disableBundledSkills`](/ja/settings#available-settings) 設定と同等です。`0` はそれをオーバーライドしません |

169| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | ユーザー、プロジェクト、自動メモリファイルを含む、任意の CLAUDE.md メモリファイルをコンテキストに読み込むことを防ぐには `1` に設定します |178| `CLAUDE_CODE_DISABLE_CLAUDE_MDS` | ユーザー、プロジェクト、自動メモリファイルを含む、任意の CLAUDE.md メモリファイルをコンテキストに読み込むことを防ぐには `1` に設定します |

170| `CLAUDE_CODE_DISABLE_CRON` | [スケジュール済みタスク](/ja/scheduled-tasks) を無効にするには `1` に設定します。`/loop` スキルと cron ツールが利用できなくなり、既にスケジュール済みのタスクはすべて実行を停止します。これには既にセッション中に実行中のタスクも含まれます |179| `CLAUDE_CODE_DISABLE_CRON` | [スケジュール済みタスク](/ja/scheduled-tasks) を無効にするには `1` に設定します。`/loop` スキルと cron ツールが利用できなくなり、既にスケジュール済みのタスクはすべて実行を停止します。これには既にセッション中に実行中のタスクも含まれます |

171| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Anthropic 固有の `anthropic-beta` リクエストヘッダーと beta ツールスキーマフィールド(`defer_loading` や `eager_input_streaming` など)を API リクエストから削除するには `1` に設定します。プロキシゲートウェイが「`anthropic-beta` ヘッダーの予期しない値」や「追加の入力は許可されていません」などのエラーでリクエストを拒否する場合に使用します。標準フィールド(`name`、`description`、`input_schema`、`cache_control`)は保持されます。 |180| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Anthropic 固有の `anthropic-beta` リクエストヘッダーと beta ツールスキーマフィールド(`defer_loading` や `eager_input_streaming` など)を API リクエストから削除するには `1` に設定します。プロキシゲートウェイが「`anthropic-beta` ヘッダーの予期しない値」や「追加の入力は許可されていません」などのエラーでリクエストを拒否する場合に使用します。標準フィールド(`name`、`description`、`input_schema`、`cache_control`)は保持されます。 |


180| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 初回実行時に公式プラグインマーケットプレイスの自動追加をスキップするには `1` に設定します |189| `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` | 初回実行時に公式プラグインマーケットプレイスの自動追加をスキップするには `1` に設定します |

181| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | システム全体で管理されているスキルディレクトリからスキルを読み込むことをスキップするには `1` に設定します。コンテナまたは CI セッションがオペレーターがプロビジョニングしたスキルを読み込むべきでない場合に役立ちます |190| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | システム全体で管理されているスキルディレクトリからスキルを読み込むことをスキップするには `1` に設定します。コンテナまたは CI セッションがオペレーターがプロビジョニングしたスキルを読み込むべきでない場合に役立ちます |

182| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 会話コンテキストに基づいて自動的にターミナルタイトルを更新することを無効にするには `1` に設定します。Agent SDK と `claude -p` セッションでは、これはセッションタイトルを生成するバックグラウンド Haiku リクエストもスキップします |191| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | 会話コンテキストに基づいて自動的にターミナルタイトルを更新することを無効にするには `1` に設定します。Agent SDK と `claude -p` セッションでは、これはセッションタイトルを生成するバックグラウンド Haiku リクエストもスキップします |

183| `CLAUDE_CODE_DISABLE_THINKING` | モデルサポートまたは他の設定に関係なく、[拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) を強制的に無効にするには `1` に設定します。`MAX_THINKING_TOKENS=0` よりも直接的です |192| `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 5 では効果がありません。思考をオフにすることはできません。[サードパーティプロバイダー](/ja/third-party-integrations) では、`0` 同様にパラメータを省略するため、2 つの変数はそこで同じ動作をします |

184| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | [フルスクリーンレンダリング](/ja/fullscreen) で仮想スクロールを無効にするには `1` に設定します。トランスクリプト内のすべてのメッセージをレンダリングします。フルスクリーンモードでのスクロールがメッセージが表示されるべき場所に空白領域を表示する場合に使用します |193| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | [フルスクリーンレンダリング](/ja/fullscreen) で仮想スクロールを無効にするには `1` に設定します。トランスクリプト内のすべてのメッセージをレンダリングします。フルスクリーンモードでのスクロールがメッセージが表示されるべき場所に空白領域を表示する場合に使用します |

185| `CLAUDE_CODE_DISABLE_WORKFLOWS` | [ワークフロー](/ja/workflows#turn-workflows-off) を無効にするには `1` に設定します。[`disableWorkflows`](/ja/settings#available-settings) 設定と同等です |194| `CLAUDE_CODE_DISABLE_WORKFLOWS` | [ワークフロー](/ja/workflows#turn-workflows-off) を無効にするには `1` に設定します。[`disableWorkflows`](/ja/settings#available-settings) 設定と同等です |

186| `CLAUDE_CODE_EFFORT_LEVEL` | サポートされているモデルの努力レベルを設定します。値:`low`、`medium`、`high`、`xhigh`、`max`、または `auto`(モデルのデフォルトを使用)。利用可能なレベルはモデルによって異なります。`/effort` および `effortLevel` 設定より優先されます。[努力レベルを調整](/ja/model-config#adjust-effort-level) を参照してください |195| `CLAUDE_CODE_EFFORT_LEVEL` | サポートされているモデルの努力レベルを設定します。値:`low`、`medium`、`high`、`xhigh`、`max`、または `auto`(モデルのデフォルトを使用)。利用可能なレベルはモデルによって異なります。`/effort` および `effortLevel` 設定より優先されます。[努力レベルを調整](/ja/model-config#adjust-effort-level) を参照してください |


198| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [エージェントチーム](/ja/agent-teams) を有効にするには `1` に設定します。エージェントチームは実験的であり、デフォルトでは無効です |207| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | [エージェントチーム](/ja/agent-teams) を有効にするには `1` に設定します。エージェントチームは実験的であり、デフォルトでは無効です |

199| `CLAUDE_CODE_EXTRA_BODY` | すべての API リクエストボディの最上位にマージする JSON オブジェクト。Claude Code が直接公開していないプロバイダー固有のパラメータを渡すのに役立ちます |208| `CLAUDE_CODE_EXTRA_BODY` | すべての API リクエストボディの最上位にマージする JSON オブジェクト。Claude Code が直接公開していないプロバイダー固有のパラメータを渡すのに役立ちます |

200| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | ファイル読み取りのデフォルトトークン制限をオーバーライドします。より大きなファイルを完全に読み取る必要がある場合に役立ちます |209| `CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS` | ファイル読み取りのデフォルトトークン制限をオーバーライドします。より大きなファイルを完全に読み取る必要がある場合に役立ちます |

210| `CLAUDE_CODE_FORCE_SESSION_PERSISTENCE` | {/* min-version: 2.1.172 */}別の Claude Code セッション内から起動された場合でも、トランスクリプト永続化、プロンプト履歴、`claude agents` 登録を強制するには `1` に設定します。例えば、Claude Code の Bash ツールによって最初に開始された tmux サーバーから継承された `CLAUDE_CODE_CHILD_SESSION` 値が、本物のトップレベルセッションをネストされたものとして誤分類する場合に使用します。v2.1.169 以降でも尊重されます。v2.1.170 と v2.1.171 では効果がなく、それがオーバーライドするネストされたセッション検出が削除されました |

201| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | ターミナルがサポートしているが自動検出されていない場合、DEC プライベートモード 2026 [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を強制的に有効にするには `1` に設定します。Emacs `eat` などのエミュレーターで役立ちます。これは BSU/ESU を実装していますが、機能プローブに応答しません。tmux では効果がありません |211| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | ターミナルがサポートしているが自動検出されていない場合、DEC プライベートモード 2026 [同期出力](https://gist.github.com/christianparpart/d8a62cc1ab659194337d73e399004036) を強制的に有効にするには `1` に設定します。Emacs `eat` などのエミュレーターで役立ちます。これは BSU/ESU を実装していますが、機能プローブに応答しません。tmux では効果がありません |

202| `CLAUDE_CODE_FORK_SUBAGENT` | [フォークされた subagent](/ja/sub-agents#fork-the-current-conversation) をモデルのデフォルトにするには `1` に設定します:Claude 一般的な subagent を使用する代わりにフォークをスポーンします。フォークは、最初から開始する代わりに、完全な会話コンテキストを継承する subagent です。すべての subagent スポーンはバックグラウンドで実行されます。明示的な [`/fork`](/ja/commands) コマンドはこの変数なしで機能します。対話モードと SDK または `claude -p` を通じて機能します |212| `CLAUDE_CODE_FORK_SUBAGENT` | [フォークされた subagent](/ja/sub-agents#fork-the-current-conversation) をモデルのデフォルトにするには `1` に設定します。または `0` に設定して無効にします。サーバー側ロールアウトをオーバーライドします。有効にするとClaude は一般的な subagent を使用する代わりにフォークをスポーンします。フォークは、最初から開始する代わりに、完全な会話コンテキストを継承する subagent です。すべての subagent スポーンはバックグラウンドで実行されます。明示的な [`/fork`](/ja/commands) コマンドはこの変数なしで機能します。対話モードと SDK または `claude -p` を通じて機能します |

203| `CLAUDE_CODE_GIT_BASH_PATH` | Windows のみ:Git Bash 実行可能ファイル(`bash.exe`)へのパス。Git Bash がインストールされているが PATH にない場合に使用します。[Windows セットアップ](/ja/setup#set-up-on-windows) を参照してください |213| `CLAUDE_CODE_GIT_BASH_PATH` | Windows のみ:Git Bash 実行可能ファイル(`bash.exe`)へのパス。Git Bash がインストールされているが PATH にない場合に使用します。[Windows セットアップ](/ja/setup#set-up-on-windows) を参照してください |

204| `CLAUDE_CODE_GLOB_HIDDEN` | Claude が [Glob ツール](/ja/tools-reference#glob-tool-behavior) を呼び出すときに結果からドットファイルを除外するには `false` に設定します。デフォルトで含まれます。`@` ファイルオートコンプリート、`ls`、Grep、または Read には影響しません |214| `CLAUDE_CODE_GLOB_HIDDEN` | Claude が [Glob ツール](/ja/tools-reference#glob-tool-behavior) を呼び出すときに結果からドットファイルを除外するには `false` に設定します。デフォルトで含まれます。`@` ファイルオートコンプリート、`ls`、Grep、または Read には影響しません |

205| `CLAUDE_CODE_GLOB_NO_IGNORE` | [Glob ツール](/ja/tools-reference#glob-tool-behavior) が `.gitignore` パターンを尊重するようにするには `false` に設定します。デフォルトでは、Glob は gitignored されたものを含むすべての一致するファイルを返します。`@` ファイルオートコンプリートには影響しません。これは独自の [`respectGitignore` 設定](/ja/settings#available-settings) を持っています |215| `CLAUDE_CODE_GLOB_NO_IGNORE` | [Glob ツール](/ja/tools-reference#glob-tool-behavior) が `.gitignore` パターンを尊重するようにするには `false` に設定します。デフォルトでは、Glob は gitignored されたものを含むすべての一致するファイルを返します。`@` ファイルオートコンプリートには影響しません。これは独自の [`respectGitignore` 設定](/ja/settings#available-settings) を持っています |


239| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/ja/claude-code-on-the-web) で現在のセッションの ID に自動的に設定されます。セッショントランスクリプトへのリンクを構築するために読み取ります。[セッションにアーティファクトをリンク](/ja/claude-code-on-the-web#link-artifacts-back-to-the-session) を参照してください |249| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/ja/claude-code-on-the-web) で現在のセッションの ID に自動的に設定されます。セッショントランスクリプトへのリンクを構築するために読み取ります。[セッションにアーティファクトをリンク](/ja/claude-code-on-the-web#link-artifacts-back-to-the-session) を参照してください |

240| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 前のセッションが途中で終了した場合に自動的に再開するには `1` に設定します。SDK モードで使用されるため、モデルは SDK がプロンプトを再送信する必要なく続行します |250| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | 前のセッションが途中で終了した場合に自動的に再開するには `1` に設定します。SDK モードで使用されるため、モデルは SDK がプロンプトを再送信する必要なく続行します |

241| `CLAUDE_CODE_RESUME_PROMPT` | セッションが途中で終了した場合に再開するときに挿入される継続メッセージをオーバーライドします。デフォルトは `Continue from where you left off.` です。長時間実行されるエージェント用のスポーンスクリプトは、これをより指示的なブートメッセージに設定できます。空の文字列はデフォルトを使用します |251| `CLAUDE_CODE_RESUME_PROMPT` | セッションが途中で終了した場合に再開するときに挿入される継続メッセージをオーバーライドします。デフォルトは `Continue from where you left off.` です。長時間実行されるエージェント用のスポーンスクリプトは、これをより指示的なブートメッセージに設定できます。空の文字列はデフォルトを使用します |

252| `CLAUDE_CODE_SAFE_MODE` | セーフモードで開始するには `1` に設定します:CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインとファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。壊れた設定のトラブルシューティング用。管理設定ポリシーは依然として適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含みます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは適用されません。[`--safe-mode`](/ja/cli-reference#cli-flags) を渡すのと同等です。直接スポーンされた子プロセスは変数を継承します |

242| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合、セッションごとに特定のスクリプトを呼び出すことができる回数を制限する JSON オブジェクト。キーはコマンドテキストに対して一致するサブストリングです。値は整数呼び出し制限です。例えば、`{"deploy.sh": 2}` は `deploy.sh` を最大 2 回呼び出すことを許可します。マッチングはサブストリングベースなので、`./scripts/deploy.sh $(evil)` などのシェル展開トリックは依然としてキャップに対してカウントされます。`xargs` または `find -exec` を通じた実行時ファンアウトは検出されません。これは多層防御制御です |253| `CLAUDE_CODE_SCRIPT_CAPS` | `CLAUDE_CODE_SUBPROCESS_ENV_SCRUB` が設定されている場合、セッションごとに特定のスクリプトを呼び出すことができる回数を制限する JSON オブジェクト。キーはコマンドテキストに対して一致するサブストリングです。値は整数呼び出し制限です。例えば、`{"deploy.sh": 2}` は `deploy.sh` を最大 2 回呼び出すことを許可します。マッチングはサブストリングベースなので、`./scripts/deploy.sh $(evil)` などのシェル展開トリックは依然としてキャップに対してカウントされます。`xargs` または `find -exec` を通じた実行時ファンアウトは検出されません。これは多層防御制御です |

243| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/ja/fullscreen) でマウスホイールスクロール乗数を設定します。1~20 の値を受け入れます。ターミナルが増幅なしで 1 ノッチあたり 1 つのホイールイベントを送信する場合、`vim` に一致させるには `3` に設定します。JetBrains IDE ターミナルでは無視されます。Claude Code は独自のスクロール処理を使用します |254| `CLAUDE_CODE_SCROLL_SPEED` | [フルスクリーンレンダリング](/ja/fullscreen) でマウスホイールスクロール乗数を設定します。1~20 の値を受け入れます。ターミナルが増幅なしで 1 ノッチあたり 1 つのホイールイベントを送信する場合、`vim` に一致させるには `3` に設定します。JetBrains IDE ターミナルでは無視されます。Claude Code は独自のスクロール処理を使用します |

244| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/ja/hooks#sessionend) フックの時間予算をオーバーライドします(ミリ秒)。セッション終了、`/clear`、および対話的な `/resume` を通じたセッション切り替えに適用されます。デフォルトでは予算は 1.5 秒で、設定ファイルで設定されたフックごとの最高 `timeout` に自動的に引き上げられます。最大 60 秒。プラグイン提供フックのタイムアウトは予算を引き上げません |255| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | [SessionEnd](/ja/hooks#sessionend) フックの時間予算をオーバーライドします(ミリ秒)。セッション終了、`/clear`、および対話的な `/resume` を通じたセッション切り替えに適用されます。デフォルトでは予算は 1.5 秒で、設定ファイルで設定されたフックごとの最高 `timeout` に自動的に引き上げられます。最大 60 秒。プラグイン提供フックのタイムアウトは予算を引き上げません |

245| `CLAUDE_CODE_SESSION_ID` | Bash と PowerShell ツールサブプロセスで現在のセッション ID に自動的に設定されます。[フック](/ja/hooks) コマンドサブプロセスと stdio [MCP サーバー](/ja/mcp) サブプロセスでも設定されます。フックに渡される `session_id` フィールドと一致します。`/clear` で更新されます。スクリプトと外部ツールを Claude Code セッションと相関させるために使用します |256| `CLAUDE_CODE_SESSION_ID` | Bash と PowerShell ツールサブプロセスで現在のセッション ID に自動的に設定されます。[フック](/ja/hooks) コマンドサブプロセスと stdio [MCP サーバー](/ja/mcp) サブプロセスでも設定されます。フックに渡される `session_id` フィールドと一致します。`/clear` で更新されます。スクリプトと外部ツールを Claude Code セッションと相関させるために使用します |

246| `CLAUDE_CODE_SHELL` | 自動シェル検出をオーバーライドします。ログインシェルが優先作業シェルと異なる場合に役立ちます(例:`bash` vs `zsh`) |257| `CLAUDE_CODE_SHELL` | 自動シェル検出をオーバーライドします。ログインシェルが優先作業シェルと異なる場合に役立ちます(例:`bash` vs `zsh`) |

247| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code がスポーンするシェルコマンドをラップするコマンドプレフィックス:Bash ツール呼び出し、[フック](/ja/hooks) コマンド、stdio [MCP サーバー](/ja/mcp) スタートアップコマンド。ログまたは監査に役立ちます。例:`/path/to/logger.sh` を設定すると、各コマンドが `/path/to/logger.sh <command>` として実行されます |258| `CLAUDE_CODE_SHELL_PREFIX` | Claude Code がスポーンするシェルコマンドをラップするコマンドプレフィックス:Bash ツール呼び出し、[フック](/ja/hooks) コマンド、[ステータスライン](/ja/statusline) コマンド、stdio [MCP サーバー](/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 が組み立てた完全なシェル呼び出しが含まれます。環境セットアップを含みます。Claude が実行したコマンドのみではありません |

248| `CLAUDE_CODE_SIMPLE` | 最小限のシステムプロンプトと Bash、ファイル読み取り、ファイル編集ツールのみで実行するには `1` に設定します。`--mcp-config` からの MCP ツールは引き続き利用可能です。フック、スキル、プラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出を無効にします。OAuth トークンとキーチェーン認証情報は読み取られないため、Anthropic 認証は `ANTHROPIC_API_KEY` または `--settings` の `apiKeyHelper` から取得する必要があります。[`--bare`](/ja/headless#start-faster-with-bare-mode) CLI フラグと同等です |259| `CLAUDE_CODE_SIMPLE` | 最小限のシステムプロンプトと Bash、ファイル読み取り、ファイル編集ツールのみで実行するには `1` に設定します。`--mcp-config` からの MCP ツールは引き続き利用可能です。フック、スキル、プラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出を無効にします。OAuth トークンとキーチェーン認証情報は読み取られないため、Anthropic 認証は `ANTHROPIC_API_KEY` または `--settings` の `apiKeyHelper` から取得する必要があります。[`--bare`](/ja/headless#start-faster-with-bare-mode) CLI フラグと同等です |

249| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 任意のモデルで短いシステムプロンプトと省略されたツール説明を使用するには `1` に設定します。`0`、`false`、`no`、または `off` に設定して、実験またはサーバー設定がそれ以外の場合に有効にしてもオプトアウトします。完全なツールセット、フック、MCP サーバー、CLAUDE.md 検出は有効なままです |260| `CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT` | 任意のモデルで短いシステムプロンプトと省略されたツール説明を使用するには `1` に設定します。`0`、`false`、`no`、または `off` に設定して、実験またはサーバー設定がそれ以外の場合に有効にしてもオプトアウトします。完全なツールセット、フック、MCP サーバー、CLAUDE.md 検出は有効なままです |

250| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/ja/claude-platform-on-aws) のクライアント側認証をスキップします。リクエストに自分で署名するゲートウェイの場合 |261| `CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH` | [Claude Platform on AWS](/ja/claude-platform-on-aws) のクライアント側認証をスキップします。リクエストに自分で署名するゲートウェイの場合 |


259| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード(`-p` フラグ)でプラグインインストールが完了するまで待機するには `1` に設定します。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンで利用できない可能性があります。`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせて待機を制限します |270| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL` | 非対話モード(`-p` フラグ)でプラグインインストールが完了するまで待機するには `1` に設定します。これがない場合、プラグインはバックグラウンドでインストールされ、最初のターンで利用できない可能性があります。`CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` と組み合わせて待機を制限します |

260| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同期プラグインインストールのタイムアウト(ミリ秒)。超過すると、Claude Code はプラグインなしで続行し、エラーをログします。デフォルトなし:この変数がない場合、同期インストールは完了するまで待機します |271| `CLAUDE_CODE_SYNC_PLUGIN_INSTALL_TIMEOUT_MS` | 同期プラグインインストールのタイムアウト(ミリ秒)。超過すると、Claude Code はプラグインなしで続行し、エラーをログします。デフォルトなし:この変数がない場合、同期インストールは完了するまで待機します |

261| `CLAUDE_CODE_SYNC_SKILLS` | 非対話モード(`-p` フラグ)で有効な claude.ai スキルを `~/.claude/skills/` にダウンロードし、10 分ごとに再同期するには `1` に設定します。[Claude Code on the web](/ja/claude-code-on-the-web) セッションで自動的に設定されます。claude.ai 認証が必須です |272| `CLAUDE_CODE_SYNC_SKILLS` | 非対話モード(`-p` フラグ)で有効な claude.ai スキルを `~/.claude/skills/` にダウンロードし、10 分ごとに再同期するには `1` に設定します。[Claude Code on the web](/ja/claude-code-on-the-web) セッションで自動的に設定されます。claude.ai 認証が必須です |

273| `CLAUDE_CODE_SYNC_SKILLS_INSTALL_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合、セッション中のスキル再同期のタイムアウト(ミリ秒)(デフォルト:30000)。ホストがセッション中にスキル再読み込みをリクエストしたときにトリガーされるダウンロードを制限します。超過すると、再同期は停止し、残りのダウンロードはバックグラウンドで続行されます |

262| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合、最初のクエリが初期スキル同期を待機するタイムアウト(ミリ秒)(デフォルト:5000)。超過すると、クエリは続行され、残りのスキルダウンロードはバックグラウンドで続行されます |274| `CLAUDE_CODE_SYNC_SKILLS_WAIT_TIMEOUT_MS` | `CLAUDE_CODE_SYNC_SKILLS` が設定されている場合、最初のクエリが初期スキル同期を待機するタイムアウト(ミリ秒)(デフォルト:5000)。超過すると、クエリは続行され、残りのスキルダウンロードはバックグラウンドで続行されます |

263| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | diff 出力の構文強調表示を無効にするには `false` に設定します。色がターミナルセットアップに干渉する場合に役立ちます。コードブロックとファイルプレビューの強調表示も無効にするには、[`syntaxHighlightingDisabled`](/ja/settings) 設定を使用します |275| `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | diff 出力の構文強調表示を無効にするには `false` に設定します。色がターミナルセットアップに干渉する場合に役立ちます。コードブロックとファイルプレビューの強調表示も無効にするには、[`syntaxHighlightingDisabled`](/ja/settings) 設定を使用します |

264| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有します。複数の Claude Code インスタンスで同じ ID を設定して、共有タスクリストで調整します。[タスクリスト](/ja/interactive-mode#task-list) を参照してください |276| `CLAUDE_CODE_TASK_LIST_ID` | セッション間でタスクリストを共有します。複数の Claude Code インスタンスで同じ ID を設定して、共有タスクリストで調整します。[タスクリスト](/ja/interactive-mode#task-list) を参照してください |

265| `CLAUDE_CODE_TEAM_NAME` | このチームメイトが属するエージェントチームの名前。[エージェントチーム](/ja/agent-teams) メンバーで自動的に設定されます |277| `CLAUDE_CODE_TEAM_NAME` | このチームメイトが属するエージェントチームの名前。[エージェントチーム](/ja/agent-teams) メンバーで自動的に設定されます |

266| `CLAUDE_CODE_TMPDIR` | 内部一時ファイルに使用される一時ディレクトリをオーバーライドします。Claude Code はこのパスに `/claude-{uid}/`(Unix)または `/claude/`(Windows)を追加します。デフォルト:macOS では `/tmp`、Linux/Windows では `os.tmpdir()`。{/* min-version: 2.1.161 */}v2.1.161 以降、macOS と Linux では、Bash サブプロセスは、一部のツールが長いパスで失敗するため、オーバーライドが長いパスの場合、システムデフォルト下の短いフォールバック `$TMPDIR` を受け取ります。Claude Code 独自の一時ファイルは常にオーバーライドを使用します |278| `CLAUDE_CODE_TMPDIR` | 内部一時ファイルに使用される一時ディレクトリをオーバーライドします。Claude Code はこのパスに `/claude-{uid}/`(Unix)または `/claude/`(Windows)を追加します。デフォルト:macOS では `/tmp`、Linux/Windows では `os.tmpdir()`。{/* min-version: 2.1.161 */}v2.1.161 以降、macOS と Linux では、[サンドボックス化](/ja/sandboxing) された Bash サブプロセスは、一部のツールが長いパスで失敗するため、オーバーライドが長いパスの場合、システムデフォルト下の短いフォールバック `$TMPDIR` を受け取ります。サンドボックス化されていない Bash コマンドはシェルの `$TMPDIR` を変更なしで継承します。Claude Code 独自の一時ファイルは常にオーバーライドを使用します |

267| `CLAUDE_CODE_TMUX_TRUECOLOR` | tmux 内で 24 ビット truecolor 出力を許可するには `1` に設定します。デフォルトでは、`$TMUX` が設定されている場合、Claude Code は 256 色にクランプされます。tmux は設定されていない限り truecolor エスケープシーケンスを通過させないためです。`~/.tmux.conf` に `set -ga terminal-overrides ',*:Tc'` を追加した後、これを設定します。[ターミナル設定](/ja/terminal-config) で他の tmux 設定を参照してください |279| `CLAUDE_CODE_TMUX_TRUECOLOR` | tmux 内で 24 ビット truecolor 出力を許可するには `1` に設定します。デフォルトでは、`$TMUX` が設定されている場合、Claude Code は 256 色にクランプされます。tmux は設定されていない限り truecolor エスケープシーケンスを通過させないためです。`~/.tmux.conf` に `set -ga terminal-overrides ',*:Tc'` を追加した後、これを設定します。[ターミナル設定](/ja/terminal-config) で他の tmux 設定を参照してください |

268| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/ja/claude-platform-on-aws) を使用します |280| `CLAUDE_CODE_USE_ANTHROPIC_AWS` | [Claude Platform on AWS](/ja/claude-platform-on-aws) を使用します |

269| `CLAUDE_CODE_USE_BEDROCK` | [Bedrock](/ja/amazon-bedrock) を使用します |281| `CLAUDE_CODE_USE_BEDROCK` | [Bedrock](/ja/amazon-bedrock) を使用します |


274| `CLAUDE_CODE_USE_VERTEX` | [Vertex](/ja/google-vertex-ai) を使用します |286| `CLAUDE_CODE_USE_VERTEX` | [Vertex](/ja/google-vertex-ai) を使用します |

275| `CLAUDE_CONFIG_DIR` | 設定ディレクトリをオーバーライドします(デフォルト:`~/.claude`)。すべての設定、認証情報、セッション履歴、プラグインはこのパスの下に保存されます。複数のアカウントを並行して実行する場合に役立ちます:例えば、`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |287| `CLAUDE_CONFIG_DIR` | 設定ディレクトリをオーバーライドします(デフォルト:`~/.claude`)。すべての設定、認証情報、セッション履歴、プラグインはこのパスの下に保存されます。複数のアカウントを並行して実行する場合に役立ちます:例えば、`alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'` |

276| `CLAUDE_EFFORT` | Bash ツールサブプロセスとフックコマンドで、ターンのアクティブな [努力レベル](/ja/model-config#adjust-effort-level) に自動的に設定されます:`low`、`medium`、`high`、`xhigh`、`max`。Ultracode は異なるレベルではなく、`xhigh` として報告されます。[フック](/ja/hooks) に渡される `effort.level` フィールドと一致します。現在のモデルが努力パラメータをサポートしている場合にのみ設定されます |288| `CLAUDE_EFFORT` | Bash ツールサブプロセスとフックコマンドで、ターンのアクティブな [努力レベル](/ja/model-config#adjust-effort-level) に自動的に設定されます:`low`、`medium`、`high`、`xhigh`、`max`。Ultracode は異なるレベルではなく、`xhigh` として報告されます。[フック](/ja/hooks) に渡される `effort.level` フィールドと一致します。現在のモデルが努力パラメータをサポートしている場合にのみ設定されます |

277| `CLAUDE_ENABLE_BYTE_WATCHDOG` | バイトレベルストリーミングアイドルウォッチドッグを強制的に有効にするには `1` に設定するか、強制的に無効にするには `0` に設定します。未設定の場合、ウォッチドッグは Anthropic API 接続でデフォルトで有効になります。バイトウォッチドッグは、`CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定された期間、ワイヤ上にバイトが到着しない場合に接続を中止します。最小 5 分で、イベントレベルウォッチドッグとは独立しています |289| `CLAUDE_ENABLE_BYTE_WATCHDOG` | バイトレベルストリーミングアイドルウォッチドッグを強制的に有効にするには `1` に設定するか、強制的に無効にするには `0` に設定します。未設定の場合、ウォッチドッグは Anthropic API 直接接続と [Claude Platform on AWS](/ja/claude-platform-on-aws) 接続でデフォルトで有効になります。バイトウォッチドッグは、ワイヤ上にバイトが到着しない場合に接続を中止します。Anthropic API 直接接続ではデフォルト 180 秒、Claude Platform on AWS では 300 秒、Bedrock で有効な場合は 300 秒、または `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定された値(最小 5 分にクランプ)。イベントレベルウォッチドッグとは独立しています |

278| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` レスポンスでバイトレベルストリーミングアイドルウォッチドッグを有効にするには `1` に設定します。デフォルトではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |290| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | Amazon Bedrock `vnd.amazon.eventstream` レスポンスでバイトレベルストリーミングアイドルウォッチドッグを有効にするには `1` に設定します。デフォルトではオフです。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |

279| `CLAUDE_ENABLE_STREAM_WATCHDOG` | イベントレベルストリーミングアイドルウォッチドッグを有効にするには `1` に設定します。デフォルトではオフです。すべてのプロバイダーに適用されますVertex Foundry ではこれが唯一利用可能なアイドルウォッチドッグです。Bedrock では、`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` で独立したバイトレベルウォッチドッグも有効にできます。両方が設定されている場合、一緒に実行されます。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |291| `CLAUDE_ENABLE_STREAM_WATCHDOG` | イベントレベルストリーミングアイドルウォッチドッグを強制的に有効にするには `1` に設定するか、強制的に無効にするには `0` に設定します。未設定の場合、デフォルトは Anthropic API 直接接続ではサーバー制御、他のプロバイダーではオフです{/* min-version: 2.1.169 */}v2.1.169 以降Anthropic API 直接接続と Claude Platform on AWS 以外のプロバイダーも、この変数とは独立した 5 分のボディアイドルタイムアウトを持っています`API_FORCE_IDLE_TIMEOUT` を参照してください。Bedrock では、`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` で独立したバイトレベルウォッチドッグも有効にできます。両方が設定されている場合、一緒に実行されます。`CLAUDE_STREAM_IDLE_TIMEOUT_MS` でタイムアウトを設定します |

280| `CLAUDE_ENV_FILE` | Claude Code が各 Bash コマンドの前に同じシェルプロセスで実行するシェルスクリプトへのパス。ファイル内のエクスポートはコマンドに表示されます。virtualenv または conda アクティベーションをコマンド間で永続化するために使用します。[SessionStart](/ja/hooks#persist-environment-variables)、[Setup](/ja/hooks#setup)、[CwdChanged](/ja/hooks#cwdchanged)、[FileChanged](/ja/hooks#filechanged) フックによって動的に入力されます |292| `CLAUDE_ENV_FILE` | Claude Code が各 Bash コマンドの前に同じシェルプロセスで実行するシェルスクリプトへのパス。ファイル内のエクスポートはコマンドに表示されます。virtualenv または conda アクティベーションをコマンド間で永続化するために使用します。[SessionStart](/ja/hooks#persist-environment-variables)、[Setup](/ja/hooks#setup)、[CwdChanged](/ja/hooks#cwdchanged)、[FileChanged](/ja/hooks#filechanged) フックによって動的に入力されます |

281| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が指定されていない場合、自動生成される [Remote Control](/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前を生成します。`--remote-control-session-name-prefix` CLI フラグは単一の呼び出しに対して同じ値を設定します |293| `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` | 明示的な名前が指定されていない場合、自動生成される [Remote Control](/ja/remote-control) セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前を生成します。`--remote-control-session-name-prefix` CLI フラグは単一の呼び出しに対して同じ値を設定します |

282| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | ストリーミングアイドルウォッチドッグが停止した接続を閉じるまでのタイムアウト(ミリ秒)。デフォルトと最小 `300000`(5 分)の両方のバイトレベルとイベントレベルウォッチドッグの場合。低い値は拡張思考の一時停止とプロキシバッファリングを吸収するために自動的にクランプされます。サードパーティプロバイダーの場合、`CLAUDE_ENABLE_STREAM_WATCHDOG=1` が必須です。Bedrock では、`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` の場合にも適用されます |294| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | ストリーミングアイドルウォッチドッグが停止した接続を閉じるまでのタイムアウト(ミリ秒)。この変数を明示的に設定する場合、最小は `300000`(5 分)です。低い値は拡張思考の一時停止とプロキシバッファリングを吸収するために自動的にクランプされます。未設定の場合イベントレベルウォッチドッグはデフォルト 300 秒、バイトレベルウォッチドッグは Anthropic API 直接接続でデフォルト 180 秒(Claude Platform on AWS および他のプロバイダーでは 300 秒)。未設定の 180 秒バイトウォッチドッグデフォルトは別の値で、5 分クランプの対象ではありません。サードパーティプロバイダーのイベントレベルウォッチドッグの場合、`CLAUDE_ENABLE_STREAM_WATCHDOG=1` が必須です。`API_FORCE_IDLE_TIMEOUT` で説明されているボディアイドルタイムアウトは独立して適用されます。Bedrock では、`CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` の場合にも適用されます |

283| `DEBUG` | デバッグモードを有効にするには `1` に設定します。[`--debug`](/ja/cli-reference#cli-flags) で起動するのと同等です。デバッグログは `~/.claude/debug/<session-id>.txt` に書き込まれるか、`CLAUDE_CODE_DEBUG_LOGS_DIR` で設定されたパスに書き込まれます。`1`、`true`、`yes`、`on` の真の値のみがデバッグモードを有効にするため、他のツール用に設定された `DEBUG=express:*` などの名前空間パターンはトリガーしません |295| `DEBUG` | デバッグモードを有効にするには `1` に設定します。[`--debug`](/ja/cli-reference#cli-flags) で起動するのと同等です。デバッグログは `~/.claude/debug/<session-id>.txt` に書き込まれるか、`CLAUDE_CODE_DEBUG_LOGS_DIR` で設定されたパスに書き込まれます。`1`、`true`、`yes`、`on` の真の値のみがデバッグモードを有効にするため、他のツール用に設定された `DEBUG=express:*` などの名前空間パターンはトリガーしません |

284| `DISABLE_AUTOUPDATER` | 自動更新を無効にするには `1` に設定します。手動の `claude update` は引き続き機能します。`DISABLE_UPDATES` を使用して両方をブロックします |296| `DISABLE_AUTOUPDATER` | 自動更新を無効にするには `1` に設定します。手動の `claude update` は引き続き機能します。`DISABLE_UPDATES` を使用して両方をブロックします |

285| `DISABLE_AUTO_COMPACT` | コンテキスト制限に近づいたときの自動コンパクションを無効にするには `1` に設定します。手動の `/compact` コマンドは引き続き利用可能です。コンパクションが発生するタイミングを明示的に制御したい場合に使用します |297| `DISABLE_AUTO_COMPACT` | コンテキスト制限に近づいたときの自動コンパクションを無効にするには `1` に設定します。手動の `/compact` コマンドは引き続き利用可能です。コンパクションが発生するタイミングを明示的に制御したい場合に使用します |


296| `DISABLE_LOGIN_COMMAND` | `/login` コマンドを非表示にするには `1` に設定します。認証が API キーまたは `apiKeyHelper` を通じて外部で処理される場合に役立ちます |308| `DISABLE_LOGIN_COMMAND` | `/login` コマンドを非表示にするには `1` に設定します。認証が API キーまたは `apiKeyHelper` を通じて外部で処理される場合に役立ちます |

297| `DISABLE_LOGOUT_COMMAND` | `/logout` コマンドを非表示にするには `1` に設定します |309| `DISABLE_LOGOUT_COMMAND` | `/logout` コマンドを非表示にするには `1` に設定します |

298| `DISABLE_PROMPT_CACHING` | すべてのモデルのプロンプトキャッシングを無効にするには `1` に設定します(モデルごとの設定よりも優先されます) |310| `DISABLE_PROMPT_CACHING` | すべてのモデルのプロンプトキャッシングを無効にするには `1` に設定します(モデルごとの設定よりも優先されます) |

311| `DISABLE_PROMPT_CACHING_FABLE` | Fable モデルのプロンプトキャッシングを無効にするには `1` に設定します |

299| `DISABLE_PROMPT_CACHING_HAIKU` | Haiku モデルのプロンプトキャッシングを無効にするには `1` に設定します |312| `DISABLE_PROMPT_CACHING_HAIKU` | Haiku モデルのプロンプトキャッシングを無効にするには `1` に設定します |

300| `DISABLE_PROMPT_CACHING_OPUS` | Opus モデルのプロンプトキャッシングを無効にするには `1` に設定します |313| `DISABLE_PROMPT_CACHING_OPUS` | Opus モデルのプロンプトキャッシングを無効にするには `1` に設定します |

301| `DISABLE_PROMPT_CACHING_SONNET` | Sonnet モデルのプロンプトキャッシングを無効にするには `1` に設定します |314| `DISABLE_PROMPT_CACHING_SONNET` | Sonnet モデルのプロンプトキャッシングを無効にするには `1` に設定します |


304| `DISABLE_UPGRADE_COMMAND` | `/upgrade` コマンドを非表示にするには `1` に設定します |317| `DISABLE_UPGRADE_COMMAND` | `/upgrade` コマンドを非表示にするには `1` に設定します |

305| `DO_NOT_TRACK` | テレメトリをオプトアウトするには `1` に設定します。`DISABLE_TELEMETRY` を設定するのと同等です。Claude Code はこれをクロスツール規約として尊重します。多くの開発者 CLI で認識されます |318| `DO_NOT_TRACK` | テレメトリをオプトアウトするには `1` に設定します。`DISABLE_TELEMETRY` を設定するのと同等です。Claude Code はこれをクロスツール規約として尊重します。多くの開発者 CLI で認識されます |

306| `ENABLE_CLAUDEAI_MCP_SERVERS` | Claude Code で [claude.ai MCP サーバー](/ja/mcp#use-mcp-servers-from-claude-ai) を無効にするには `false` に設定します。ログインしているユーザーではデフォルトで有効です |319| `ENABLE_CLAUDEAI_MCP_SERVERS` | Claude Code で [claude.ai MCP サーバー](/ja/mcp#use-mcp-servers-from-claude-ai) を無効にするには `false` に設定します。ログインしているユーザーではデフォルトで有効です |

307| `ENABLE_PROMPT_CACHING_1H` | API キー、[Bedrock](/ja/amazon-bedrock)、[Vertex](/ja/google-vertex-ai)、[Foundry](/ja/microsoft-foundry)、[Claude Platform on AWS](/ja/claude-platform-on-aws) ユーザーの場合、デフォルトの 5 分の代わりに 1 時間のプロンプトキャッシュ TTL をリクエストするには `1` に設定します。サブスクリプションユーザーは 1 時間の TTL を自動的に受け取ります。1 時間キャッシュ書き込みはより高いレートで請求されます |320| `ENABLE_PROMPT_CACHING_1H` | API キー、[Bedrock](/ja/amazon-bedrock)、[Vertex](/ja/google-vertex-ai)、[Foundry](/ja/microsoft-foundry)、[Claude Platform on AWS](/ja/claude-platform-on-aws) ユーザーの場合、デフォルトの 5 分の代わりに 1 時間の [プロンプトキャッシュ TTL](/ja/prompt-caching#cache-lifetime) をリクエストするには `1` に設定します。サブスクリプションユーザーは 1 時間の TTL を自動的に受け取ります。1 時間キャッシュ書き込みはより高いレートで請求されます |

308| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非推奨。代わりに `ENABLE_PROMPT_CACHING_1H` を使用してください |321| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非推奨。代わりに `ENABLE_PROMPT_CACHING_1H` を使用してください |

309| `ENABLE_TOOL_SEARCH` | [MCP ツール検索](/ja/mcp#scale-with-mcp-tool-search) を制御します。未設定:すべての MCP ツールはデフォルトで遅延されますが、Vertex AI または `ANTHROPIC_BASE_URL` がファーストパーティ以外のホストを指している場合は事前に読み込まれます。値:`true`(常に遅延し、ベータヘッダーを送信、Vertex AI またはツール参照をサポートしないプロキシでリクエストが失敗)、`auto`(閾値モード:ツールがコンテキストの 10% に収まる場合は事前に読み込み)、`auto:N`(カスタム閾値、例:5% の場合は `auto:5`)、`false`(すべて事前に読み込み) |322| `ENABLE_TOOL_SEARCH` | [MCP ツール検索](/ja/mcp#scale-with-mcp-tool-search) を制御します。未設定:すべての MCP ツールはデフォルトで遅延されますが、Vertex AI または `ANTHROPIC_BASE_URL` がファーストパーティ以外のホストを指している場合は事前に読み込まれます。値:`true`(常に遅延し、ベータヘッダーを送信、Vertex AI モデル Sonnet 4.5 または Opus 4.5 より前、または `tool_reference` をサポートしないプロキシでリクエストが失敗)、`auto`(閾値モード:ツールがコンテキストの 10% に収まる場合は事前に読み込み)、`auto:N`(カスタム閾値、例:5% の場合は `auto:5`)、`false`(すべて事前に読み込み) |

310| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 任意のプライマリモデルで繰り返されるオーバーロードエラーの後に [`--fallback-model`](/ja/cli-reference#cli-flags) へのフォールバックをトリガーするには、空でない値に設定します。デフォルトではOpus モデルのみがフォールバックをトリガーします |323| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | 任意のプライマリモデルで繰り返されるオーバーロードエラーの後にフォールバックモデルを停止するには、空でない値に設定します。{/* min-version: 2.1.160 */}v2.1.160 以降、設定された [フォールバックモデルチェーン](/ja/model-config#fallback-model-chains) は任意のプライマリモデルで繰り返されるオーバーロードエラーでトリガーされるためこの変数はフォールバックモデルへの切り替えに影響しません |

311| `FORCE_AUTOUPDATE_PLUGINS` | メインのオートアップデーターが `DISABLE_AUTOUPDATER` で無効になっている場合でも、プラグインの自動更新を強制するには `1` に設定します |324| `FORCE_AUTOUPDATE_PLUGINS` | メインのオートアップデーターが `DISABLE_AUTOUPDATER` で無効になっている場合でも、プラグインの自動更新を強制するには `1` に設定します |

312| `FORCE_PROMPT_CACHING_5M` | 1 時間の TTL が適用される場合でも、5 分のプロンプトキャッシュ TTL を強制するには `1` に設定します。`ENABLE_PROMPT_CACHING_1H` をオーバーライドします |325| `FORCE_PROMPT_CACHING_5M` | 1 時間の TTL が適用される場合でも、5 分のプロンプトキャッシュ TTL を強制するには `1` に設定します。`ENABLE_PROMPT_CACHING_1H` をオーバーライドします |

313| `HTTP_PROXY` | ネットワーク接続用の HTTP プロキシサーバーを指定します |326| `HTTP_PROXY` | ネットワーク接続用の HTTP プロキシサーバーを指定します |


315| `IS_DEMO` | デモモードを有効にするには `1` に設定します:ヘッダーと `/status` 出力からメールと組織名を非表示にし、オンボーディングをスキップします。セッションをストリーミングまたは記録する場合に役立ちます |328| `IS_DEMO` | デモモードを有効にするには `1` に設定します:ヘッダーと `/status` 出力からメールと組織名を非表示にし、オンボーディングをスキップします。セッションをストリーミングまたは記録する場合に役立ちます |

316| `MAX_MCP_OUTPUT_TOKENS` | MCP ツール応答で許可される最大トークン数。Claude Code は出力が 10,000 トークンを超える場合に警告を表示します。[`anthropic/maxResultSizeChars`](/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言するツールはテキストコンテンツにその文字制限を使用しますが、これらのツールからの画像コンテンツはこの変数の対象です(デフォルト:25000) |329| `MAX_MCP_OUTPUT_TOKENS` | MCP ツール応答で許可される最大トークン数。Claude Code は出力が 10,000 トークンを超える場合に警告を表示します。[`anthropic/maxResultSizeChars`](/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言するツールはテキストコンテンツにその文字制限を使用しますが、これらのツールからの画像コンテンツはこの変数の対象です(デフォルト:25000) |

317| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モード(`-p` フラグ)で [`--json-schema`](/ja/cli-reference#cli-flags) に対するモデルの応答検証が失敗した場合の再試行回数。デフォルト:5 |330| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モード(`-p` フラグ)で [`--json-schema`](/ja/cli-reference#cli-flags) に対するモデルの応答検証が失敗した場合の再試行回数。デフォルト:5 |

318| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) トークン予算をオーバーライドします。上限はモデルの [最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) から 1 を引いた値です。思考を完全に無効にするには `0` に設定します。[適応的推論](/ja/model-config#adjust-effort-level) を備えたモデルでは、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を通じて適応的推論が無効にされない限り、予算は無視されます |331| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) トークン予算をオーバーライドします。上限はモデルの [最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) から 1 を引いた値です。Anthropic API で思考を完全に無効にするには `0` に設定します。Fable 5 を除く。思考をオフにすることはできません。[サードパーティプロバイダー](/ja/third-party-integrations) では、`0` 同様にパラメータを省略するため、2 つの変数はそこで同じ動作をします。[適応的推論](/ja/model-config#adjust-effort-level) を備えたモデルでは、非ゼロ値の場合、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` を通じて適応的推論が無効にされない限り、予算は無視されます |

319| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的なプロンプトを回避します |332| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的なプロンプトを回避します |

320| `MCP_CONNECTION_NONBLOCKING` | スタートアップが最初のクエリの前に MCP サーバーの接続を待機するかどうかを制御します。{/* min-version: 2.1.142 */}Claude Code v2.1.142 以降、MCP スタートアップはデフォルトで非ブロッキングです:サーバーはバックグラウンドで接続し、完了するとそのツールが利用可能になります。`0` に設定してブロッキング 5 秒接続待機を復元します。[`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、ツールが最初のプロンプトが構築されるときに存在する必要があるため、この設定に関係なく常にブロックします |333| `MCP_CONNECTION_NONBLOCKING` | スタートアップが最初のクエリの前に MCP サーバーの接続を待機するかどうかを制御します。{/* min-version: 2.1.142 */}Claude Code v2.1.142 以降、MCP スタートアップはデフォルトで非ブロッキングです:サーバーはバックグラウンドで接続し、完了するとそのツールが利用可能になります。`0` に設定してブロッキング 5 秒接続待機を復元します。[`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、ツールが最初のプロンプトが構築されるときに存在する必要があるため、この設定に関係なく常にブロックします |

321| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップが接続バッチを待機する時間(ミリ秒)。ツールリストをスナップショットする前のデフォルト:5000。`MCP_CONNECTION_NONBLOCKING=0` の場合、または [`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。期限で保留中のサーバーはバックグラウンドで接続し続けますが、次のクエリまで表示されません。`MCP_TIMEOUT` とは異なります。これは個別のサーバーの接続試行を制限します |334| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップが接続バッチを待機する時間(ミリ秒)。ツールリストをスナップショットする前のデフォルト:5000。`MCP_CONNECTION_NONBLOCKING=0` の場合、または [`alwaysLoad: true`](/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。期限で保留中のサーバーはバックグラウンドで接続し続けますが、次のクエリまで表示されません。`MCP_TIMEOUT` とは異なります。これは個別のサーバーの接続試行を制限します |


323| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列接続するリモート MCP サーバー(HTTP/SSE)の最大数(デフォルト:20) |336| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列接続するリモート MCP サーバー(HTTP/SSE)の最大数(デフォルト:20) |

324| `MCP_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列接続するローカル MCP サーバー(stdio)の最大数(デフォルト:3) |337| `MCP_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列接続するローカル MCP サーバー(stdio)の最大数(デフォルト:3) |

325| `MCP_TIMEOUT` | MCP サーバー起動のタイムアウト(ミリ秒)(デフォルト:30000、または 30 秒) |338| `MCP_TIMEOUT` | MCP サーバー起動のタイムアウト(ミリ秒)(デフォルト:30000、または 30 秒) |

326| `MCP_TOOL_TIMEOUT` | MCP ツール実行のタイムアウト(ミリ秒)(デフォルト:100000000、約 28 時間)。`.mcp.json` のサーバーごとの `timeout` フィールドはそのサーバーのこれをオーバーライドします。1000 未満の値は 1 秒にフロアされます |339| `MCP_TOOL_TIMEOUT` | MCP ツール実行のタイムアウト(ミリ秒)(デフォルト:100000000、約 28 時間)。`.mcp.json` のサーバーごとの `timeout` フィールドはそのサーバーのこれをオーバーライドします。env 変数の場合、1000 未満の値は 1 秒にフロアされます。サーバーごとのフィールドの場合、1000 未満の値は無視されます |

327| `NO_PROXY` | リクエストが直接発行されるドメインと IP のリスト。プロキシをバイパスします |340| `NO_PROXY` | リクエストが直接発行されるドメインと IP のリスト。プロキシをバイパスします |

328| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストとレスポンス JSON を `api_request_body` / `api_response_body` ログイベントとして出力します。60 KB で切り詰められたインラインボディの場合は `1` に設定するか、切り詰められていないボディをディスクに書き込み、`body_ref` パスを出力する場合は `file:<dir>` に設定します。デフォルトでは無効です。ボディには会話履歴全体が含まれます。[監視](/ja/monitoring-usage#api-request-body-event) を参照してください |341| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストとレスポンス JSON を `api_request_body` / `api_response_body` ログイベントとして出力します。60 KB で切り詰められたインラインボディの場合は `1` に設定するか、切り詰められていないボディをディスクに書き込み、`body_ref` パスを出力する場合は `file:<dir>` に設定します。デフォルトでは無効です。ボディには会話履歴全体が含まれます。[監視](/ja/monitoring-usage#api-request-body-event) を参照してください |

329| `OTEL_LOG_TOOL_CONTENT` | ツール入力と出力コンテンツを OpenTelemetry スパンイベントに含めるには `1` に設定します。機密データを保護するためにデフォルトで無効です。[監視](/ja/monitoring-usage) を参照してください |342| `OTEL_LOG_TOOL_CONTENT` | ツール入力と出力コンテンツを OpenTelemetry スパンイベントに含めるには `1` に設定します。機密データを保護するためにデフォルトで無効です。[監視](/ja/monitoring-usage) を参照してください |


348| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Vertex AI を使用する場合、Claude Opus 4.6 のリージョンをオーバーライドします |361| `VERTEX_REGION_CLAUDE_4_6_OPUS` | Vertex AI を使用する場合、Claude Opus 4.6 のリージョンをオーバーライドします |

349| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Vertex AI を使用する場合、Claude Sonnet 4.6 のリージョンをオーバーライドします |362| `VERTEX_REGION_CLAUDE_4_6_SONNET` | Vertex AI を使用する場合、Claude Sonnet 4.6 のリージョンをオーバーライドします |

350| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Vertex AI を使用する場合、Claude Opus 4.7 のリージョンをオーバーライドします。v2.1.111 で追加されました |363| `VERTEX_REGION_CLAUDE_4_7_OPUS` | {/* min-version: 2.1.111 */}Vertex AI を使用する場合、Claude Opus 4.7 のリージョンをオーバーライドします。v2.1.111 で追加されました |

364| `VERTEX_REGION_CLAUDE_4_8_OPUS` | {/* min-version: 2.1.154 */}Vertex AI を使用する場合、Claude Opus 4.8 のリージョンをオーバーライドします。v2.1.154 で追加されました |

365| `VERTEX_REGION_CLAUDE_FABLE_5` | {/* min-version: 2.1.170 */}Vertex AI を使用する場合、Claude Fable 5 のリージョンをオーバーライドします。v2.1.170 で追加されました |

351| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Vertex AI を使用する場合、Claude Haiku 4.5 のリージョンをオーバーライドします |366| `VERTEX_REGION_CLAUDE_HAIKU_4_5` | Vertex AI を使用する場合、Claude Haiku 4.5 のリージョンをオーバーライドします |

352 367 

353標準 OpenTelemetry エクスポーター変数(`OTEL_METRICS_EXPORTER`、`OTEL_LOGS_EXPORTER`、`OTEL_EXPORTER_OTLP_ENDPOINT`、`OTEL_EXPORTER_OTLP_PROTOCOL`、`OTEL_EXPORTER_OTLP_HEADERS`、`OTEL_METRIC_EXPORT_INTERVAL`、`OTEL_RESOURCE_ATTRIBUTES`、およびシグナル固有のバリアント)もサポートされています。設定の詳細は [監視](/ja/monitoring-usage) を参照してください。368標準 OpenTelemetry エクスポーター変数(`OTEL_METRICS_EXPORTER`、`OTEL_LOGS_EXPORTER`、`OTEL_EXPORTER_OTLP_ENDPOINT`、`OTEL_EXPORTER_OTLP_PROTOCOL`、`OTEL_EXPORTER_OTLP_HEADERS`、`OTEL_METRIC_EXPORT_INTERVAL`、`OTEL_RESOURCE_ATTRIBUTES`、およびシグナル固有のバリアント)もサポートされています。設定の詳細は [監視](/ja/monitoring-usage) を参照してください。

errors.md +201 −50

Details

14 Claude Code は、モデルレスポンスについて Claude API を呼び出すため、ほとんどのランタイムエラーは基盤となる API エラーコードにマップされます。このページでは、Claude Code 内での各エラーの意味と復旧方法について説明しています。生の HTTP ステータスコード定義については、[Claude Platform エラーリファレンス](https://platform.claude.com/docs/en/api/errors)を参照してください。14 Claude Code は、モデルレスポンスについて Claude API を呼び出すため、ほとんどのランタイムエラーは基盤となる API エラーコードにマップされます。このページでは、Claude Code 内での各エラーの意味と復旧方法について説明しています。生の HTTP ステータスコード定義については、[Claude Platform エラーリファレンス](https://platform.claude.com/docs/en/api/errors)を参照してください。

15</Note>15</Note>

16 16 

17## エラーを検索する17<h2 id="find-your-error">

18 エラーを検索する

19</h2>

18 20 

19ターミナルに表示されるメッセージを以下のセクションと照合してください。21ターミナルに表示されるメッセージを以下のセクションと照合してください。

20 22 


26| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |28| `<model> is temporarily unavailable, so auto mode cannot determine the safety of...` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |

27| `Auto mode could not evaluate this action and is blocking it for safety` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |29| `Auto mode could not evaluate this action and is blocking it for safety` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |

28| `Auto mode classifier transcript exceeded context window` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |30| `Auto mode classifier transcript exceeded context window` | [サーバーエラー](#auto-mode-cannot-determine-the-safety-of-an-action) |

29| `You've hit your session limit` / `You've hit your weekly limit` | [使用制限](#youve-hit-your-session-limit) |31| `You've hit your session limit` / `You've hit your weekly limit` | [使用制限](#you%E2%80%99ve-hit-your-session-limit) |

32| `Usage credits required for 1M context` | [使用制限](#usage-credits-required-for-1m-context) |

30| `Server is temporarily limiting requests` | [使用制限](#server-is-temporarily-limiting-requests) |33| `Server is temporarily limiting requests` | [使用制限](#server-is-temporarily-limiting-requests) |

31| `Request rejected (429)` | [使用制限](#request-rejected-429) |34| `Request rejected (429)` | [使用制限](#request-rejected-429) |

32| `Credit balance is too low` | [使用制限](#credit-balance-is-too-low) |35| `Credit balance is too low` | [使用制限](#credit-balance-is-too-low) |

33| `Not logged in · Please run /login` | [認証](#not-logged-in) |36| `Not logged in · Please run /login` | [認証](#not-logged-in) |

37| `Could not resolve authentication method` | [認証](#could-not-resolve-authentication-method) |

34| `Invalid API key` | [認証](#invalid-api-key) |38| `Invalid API key` | [認証](#invalid-api-key) |

35| `This organization has been disabled` | [認証](#this-organization-has-been-disabled) |39| `This organization has been disabled` | [認証](#this-organization-has-been-disabled) |

40| `Your organization has disabled API key authentication` | [認証](#your-organization-has-disabled-api-key-authentication) |

36| `Your organization has disabled Claude subscription access` | [認証](#your-organization-has-disabled-claude-subscription-access) |41| `Your organization has disabled Claude subscription access` | [認証](#your-organization-has-disabled-claude-subscription-access) |

37| `Routines are disabled by your organization's policy` | [認証](#routines-are-disabled-by-your-organizations-policy) |42| `Routines are disabled by your organization's policy` | [認証](#routines-are-disabled-by-your-organization%E2%80%99s-policy) |

38| `OAuth token revoked` / `OAuth token has expired` | [認証](#oauth-token-revoked-or-expired) |43| `OAuth token revoked` / `OAuth token has expired` | [認証](#oauth-token-revoked-or-expired) |

39| `does not meet scope requirement user:profile` | [認証](#oauth-scope-requirement) |44| `does not meet scope requirement user:profile` | [認証](#oauth-scope-requirement) |

40| `Unable to connect to API` | [ネットワーク](#unable-to-connect-to-api) |45| `Unable to connect to API` | [ネットワーク](#unable-to-connect-to-api) |


47| `Unable to resize image` | [リクエストエラー](#unable-to-resize-image) |52| `Unable to resize image` | [リクエストエラー](#unable-to-resize-image) |

48| `PDF too large` / `PDF is password protected` | [リクエストエラー](#pdf-errors) |53| `PDF too large` / `PDF is password protected` | [リクエストエラー](#pdf-errors) |

49| `Extra inputs are not permitted` | [リクエストエラー](#extra-inputs-are-not-permitted) |54| `Extra inputs are not permitted` | [リクエストエラー](#extra-inputs-are-not-permitted) |

50| `There's an issue with the selected model` | [リクエストエラー](#theres-an-issue-with-the-selected-model) |55| `There's an issue with the selected model` | [リクエストエラー](#there%E2%80%99s-an-issue-with-the-selected-model) |

51| `Claude Opus is not available with the Claude Pro plan` | [リクエストエラー](#claude-opus-is-not-available-with-the-claude-pro-plan) |56| `Claude Opus is not available with the Claude Pro plan` | [リクエストエラー](#claude-opus-is-not-available-with-the-claude-pro-plan) |

52| `thinking.type.enabled is not supported for this model` | [リクエストエラー](#thinking-type-enabled-is-not-supported-for-this-model) |57| `thinking.type.enabled is not supported for this model` | [リクエストエラー](#thinking-type-enabled-is-not-supported-for-this-model) |

53| `max_tokens must be greater than thinking.budget_tokens` | [リクエストエラー](#thinking-budget-exceeds-output-limit) |58| `max_tokens must be greater than thinking.budget_tokens` | [リクエストエラー](#thinking-budget-exceeds-output-limit) |


55| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [リクエストエラー](#usage-policy-refusal) |60| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [リクエストエラー](#usage-policy-refusal) |

56| レスポンスの品質が通常より低いように見える | [レスポンス品質](#responses-seem-lower-quality-than-usual) |61| レスポンスの品質が通常より低いように見える | [レスポンス品質](#responses-seem-lower-quality-than-usual) |

57 62 

58## 自動リトライ63<h2 id="automatic-retries">

64 自動リトライ

65</h2>

59 66 

60Claude Code は、エラーを表示する前に一時的な障害をリトライします。サーバーエラー、オーバーロードレスポンス、リクエストタイムアウト、一時的な 429 スロットル、および接続の切断はすべて、指数バックオフで最大 10 回リトライされます。リトライ中、スピナーは `Retrying in Ns · attempt x/y` カウントダウンを表示します。67Claude Code は、エラーを表示する前に一時的な障害をリトライします。サーバーエラー、オーバーロードレスポンス、リクエストタイムアウト、一時的な 429 スロットル、および接続の切断はすべて、指数バックオフで最大 10 回リトライされます。リトライ中、スピナーは `Retrying in Ns · attempt x/y` カウントダウンを表示します。

61 68 


66| [`CLAUDE_CODE_MAX_RETRIES`](/ja/env-vars) | 10 | リトライ試行回数。スクリプトで障害をより速く表示するには低くし、より長いインシデントを待つには高くします。 |73| [`CLAUDE_CODE_MAX_RETRIES`](/ja/env-vars) | 10 | リトライ試行回数。スクリプトで障害をより速く表示するには低くし、より長いインシデントを待つには高くします。 |

67| [`API_TIMEOUT_MS`](/ja/env-vars) | 600000 | リクエストごとのタイムアウト(ミリ秒単位)。遅いネットワークまたはプロキシの場合は高くします。 |74| [`API_TIMEOUT_MS`](/ja/env-vars) | 600000 | リクエストごとのタイムアウト(ミリ秒単位)。遅いネットワークまたはプロキシの場合は高くします。 |

68 75 

69## サーバーエラー76<h2 id="server-errors">

77 サーバーエラー

78</h2>

70 79 

71これらのエラーは、アカウントまたはリクエストではなく、推論プロバイダーから発生します。Anthropic API では Anthropic インフラストラクチャを意味します。Bedrock、Vertex AI、Foundry、またはカスタムゲートウェイでは、そのプロバイダーのインフラストラクチャを意味します。80これらのエラーは、アカウントまたはリクエストではなく、推論プロバイダーから発生します。Anthropic API では Anthropic インフラストラクチャを意味します。Bedrock、Vertex AI、Foundry、またはカスタムゲートウェイでは、そのプロバイダーのインフラストラクチャを意味します。

72 81 

73### API Error: 500 Internal server error82<h3 id="api-error-500-internal-server-error">

83 API Error: 500 Internal server error

84</h3>

74 85 

75Claude Code は、5xx レスポンスに対してステータスコードと API のエラーメッセージを表示します。以下の例は Anthropic API での 500 レスポンスを示しています:86Claude Code は、5xx レスポンスに対してステータスコードと API のエラーメッセージを表示します。以下の例は Anthropic API での 500 レスポンスを示しています:

76 87 


88* 1 分待ってからメッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は全体を貼り付ける代わりに `try again` と入力できます。99* 1 分待ってからメッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は全体を貼り付ける代わりに `try again` と入力できます。

89* エラーが投稿されたインシデントなしで続く場合は、`/feedback` を実行して、Anthropic がリクエスト詳細で調査できるようにしてください。環境で `/feedback` が利用できない場合は、[エラーを報告する](#report-an-error) を参照してください。100* エラーが投稿されたインシデントなしで続く場合は、`/feedback` を実行して、Anthropic がリクエスト詳細で調査できるようにしてください。環境で `/feedback` が利用できない場合は、[エラーを報告する](#report-an-error) を参照してください。

90 101 

91### API Error: Repeated 529 Overloaded errors102<h3 id="api-error-repeated-529-overloaded-errors">

103 API Error: Repeated 529 Overloaded errors

104</h3>

92 105 

93API は、すべてのユーザー全体で一時的に容量に達しています。Claude Code は、このメッセージを表示する前に既に数回リトライしています:106API は、すべてのユーザー全体で一時的に容量に達しています。Claude Code は、このメッセージを表示する前に既に数回リトライしています:

94 107 


104* 数分後に再度試してください117* 数分後に再度試してください

105* `/model` を実行して別のモデルに切り替えて、容量がモデルごとに追跡されるため、作業を続けてください。Claude Code は、1 つのモデルが特に高い負荷を受けている場合、たとえば `Opus is experiencing high load, please use /model to switch to Sonnet` のようにこれを行うようにプロンプトを表示します。118* `/model` を実行して別のモデルに切り替えて、容量がモデルごとに追跡されるため、作業を続けてください。Claude Code は、1 つのモデルが特に高い負荷を受けている場合、たとえば `Opus is experiencing high load, please use /model to switch to Sonnet` のようにこれを行うようにプロンプトを表示します。

106 119 

107### Request timed out120<h3 id="request-timed-out">

121 Request timed out

122</h3>

108 123 

109API は接続期限前に応答しませんでした。124API は接続期限前に応答しませんでした。

110 125 


121* 遅いネットワークまたはプロキシが原因の場合は、[自動リトライ](#automatic-retries) で説明されているように `API_TIMEOUT_MS` を上げてください136* 遅いネットワークまたはプロキシが原因の場合は、[自動リトライ](#automatic-retries) で説明されているように `API_TIMEOUT_MS` を上げてください

122* タイムアウトが頻繁で、ネットワークが正常な場合は、以下の[ネットワークと接続エラー](#network-and-connection-errors) を参照してください137* タイムアウトが頻繁で、ネットワークが正常な場合は、以下の[ネットワークと接続エラー](#network-and-connection-errors) を参照してください

123 138 

124### Auto mode cannot determine the safety of an action139<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">

140 Auto mode cannot determine the safety of an action

141</h3>

125 142 

126[auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode) がアクションを分類するために使用するモデルが決定を生成できなかったため、auto mode はアクションを自動的に承認しませんでした。表示されるメッセージは、分類器が失敗した理由によって異なります。143[auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode) がアクションを分類するために使用するモデルが決定を生成できなかったため、auto mode はアクションを自動的に承認しませんでした。表示されるメッセージは、分類器が失敗した理由によって異なります。

127 144 


163* 表示されるプロンプトでアクションを承認または拒否してください180* 表示されるプロンプトでアクションを承認または拒否してください

164* `/compact` を実行して会話サイズを削減し、後続のアクションが分類器ウィンドウ内に収まるようにしてください181* `/compact` を実行して会話サイズを削減し、後続のアクションが分類器ウィンドウ内に収まるようにしてください

165 182 

166## 使用制限183<h2 id="usage-limits">

184 使用制限

185</h2>

167 186 

168これらのエラーは、アカウントまたはプランに関連するクォータに達したことを意味します。これらは、すべてに影響する[サーバーエラー](#server-errors)とは異なります。187これらのエラーは、アカウントまたはプランに関連するクォータに達したことを意味します。これらは、すべてに影響する[サーバーエラー](#server-errors)とは異なります。

169 188 

170### セッション制限に達しました189<h3 id="you’ve-hit-your-session-limit">

190 セッション制限に達しました

191</h3>

171 192 

172サブスクリプションプランには、ローリング使用許容量が含まれています。使い果たされると、次のいずれかのメッセージが表示されます。193サブスクリプションプランには、ローリング使用許容量が含まれています。使い果たされると、次のいずれかのメッセージが表示されます。

173 194 


188 209 

189制限に達する前に残りの許容量を監視するには、`rate_limits` フィールドを[カスタムステータスライン](/ja/statusline#rate-limit-usage)に追加するか、デスクトップアプリでモデルピッカーの横にある[使用量リング](/ja/desktop#check-usage)をクリックしてください。210制限に達する前に残りの許容量を監視するには、`rate_limits` フィールドを[カスタムステータスライン](/ja/statusline#rate-limit-usage)に追加するか、デスクトップアプリでモデルピッカーの横にある[使用量リング](/ja/desktop#check-usage)をクリックしてください。

190 211 

191### サーバーが一時的にリクエストを制限しています212<h3 id="usage-credits-required-for-1m-context">

213 1M コンテキストに使用量クレジットが必要です

214</h3>

215 

216選択されたモデルは 1M トークンの拡張コンテキストウィンドウを使用しており、お客様のプランではこれを使用量クレジットを通じてのみ含めています。

217 

218```text theme={null}

219API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

220```

221 

222これはクォータ枯渇ではなく、エンタイトルメントチェックです。セッションおよび週間許容量に容量が残っている場合でも発火します。[拡張コンテキスト](/ja/model-config#extended-context)を参照して、どのプランが 1M コンテキストを直接含めており、どのプランが使用量クレジットを必要とするかを確認してください。

223 

224{/* min-version: 2.1.172 */}このエラーがコンテキストが 200K トークンを超えて成長したために会話の途中で表示される場合、Claude Code は自動的に会話を標準コンテキスト制限の下に圧縮し、その後セッションをその制限に保つため、アクションは不要です。v2.1.172 より前のバージョンでは、エラーは `/compact` を含むその後のすべてのリクエストで繰り返されました。これらのバージョンで復旧するには `/clear` を実行してください。以下の手順は、明示的に `[1m]` モデルを選択した場合に適用されます。

225 

226**対応方法:**

227 

228* `/model` を実行して、`[1m]` サフィックスのないバリアントを選択して、標準コンテキストウィンドウにフォールバックしてください

229* `/usage-credits` を実行して、Pro および Max で 1M バリアントのメーター制課金をオンにするか、Team および Enterprise で管理者にリクエストしてください

230* `/model` の後もエラーが続く場合は、1M モデル ID が他の場所に設定されている可能性があります。優先順位順に確認する設定場所については、[選択されたモデルに問題があります](#there%E2%80%99s-an-issue-with-the-selected-model)を参照してください。

231* モデルピッカーから 1M バリアントを完全に削除するには、[`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/ja/env-vars)を設定してください

232 

233<h3 id="server-is-temporarily-limiting-requests">

234 サーバーが一時的にリクエストを制限しています

235</h3>

192 236 

193API は、プランクォータとは無関係の短期的なスロットルを適用しました。237API は、プランクォータとは無関係の短期的なスロットルを適用しました。

194 238 


203* 少し待ってから再度試してください247* 少し待ってから再度試してください

204* 続く場合は [status.claude.com](https://status.claude.com)を確認してください248* 続く場合は [status.claude.com](https://status.claude.com)を確認してください

205 249 

206### リクエストが拒否されました(429250<h3 id="request-rejected-429">

251 リクエストが拒否されました(429)

252</h3>

207 253 

208API キー、Amazon Bedrock プロジェクト、または Google Vertex AI プロジェクト用に設定されたレート制限に達しました。254API キー、Amazon Bedrock プロジェクト、または Google Vertex AI プロジェクト用に設定されたレート制限に達しました。

209 255 


220* Anthropic API キーについては、[レート制限リファレンス](https://platform.claude.com/docs/ja/api/rate-limits)を参照して、層がどのように機能し、ワークスペースごとのキャップを設定する方法を確認してください266* Anthropic API キーについては、[レート制限リファレンス](https://platform.claude.com/docs/ja/api/rate-limits)を参照して、層がどのように機能し、ワークスペースごとのキャップを設定する方法を確認してください

221* 同時実行性を削減します。[`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ja/env-vars)を低くするか、多くの並列サブエージェントの実行を避けるか、高ボリュームのスクリプト実行用に `/model` で小さいモデルに切り替えてください267* 同時実行性を削減します。[`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ja/env-vars)を低くするか、多くの並列サブエージェントの実行を避けるか、高ボリュームのスクリプト実行用に `/model` で小さいモデルに切り替えてください

222 268 

223### クレジット残高が不足しています269<h3 id="credit-balance-is-too-low">

270 クレジット残高が不足しています

271</h3>

224 272 

225Console 組織は、プリペイドクレジットを使い果たしました。273Console 組織は、プリペイドクレジットを使い果たしました。

226 274 


234* Pro、Max、Team、または Enterprise プランがある場合は、`/login` でサブスクリプション認証に切り替えてください282* Pro、Max、Team、または Enterprise プランがある場合は、`/login` でサブスクリプション認証に切り替えてください

235* Console でワークスペースごとの支出キャップを設定して、単一のプロジェクトが組織の残高を枯渇させるのを防いでください。[コストを効果的に管理する](/ja/costs)を参照してください。283* Console でワークスペースごとの支出キャップを設定して、単一のプロジェクトが組織の残高を枯渇させるのを防いでください。[コストを効果的に管理する](/ja/costs)を参照してください。

236 284 

237## 認証エラー285<h2 id="authentication-errors">

286 認証エラー

287</h2>

238 288 

239これらのエラーは、Claude Code が API に対して身元を証明できないことを意味します。いつでも `/status` を実行して、現在アクティブな認証情報を確認してください。289これらのエラーは、Claude Code が API に対して身元を証明できないことを意味します。いつでも `/status` を実行して、現在アクティブな認証情報を確認してください。

240 290 

241### Not logged in291<h3 id="not-logged-in">

292 Not logged in

293</h3>

242 294 

243このセッションで有効な認証情報は利用できません。295このセッションで有効な認証情報は利用できません。

244 296 


255 307 

256ログインを繰り返しプロンプトされている場合は、[ログインしていないまたはトークンの有効期限が切れている](/ja/troubleshoot-install#not-logged-in-or-token-expired)を参照して、システムクロックと macOS キーチェーンの修正を確認してください。308ログインを繰り返しプロンプトされている場合は、[ログインしていないまたはトークンの有効期限が切れている](/ja/troubleshoot-install#not-logged-in-or-token-expired)を参照して、システムクロックと macOS キーチェーンの修正を確認してください。

257 309 

258### Invalid API key310<h3 id="could-not-resolve-authentication-method">

311 Could not resolve authentication method

312</h3>

313 

314セッションが認証情報なしで API クライアントに到達しました。これは[バックグラウンドセッション](/ja/agent-view)、クラウドセッション、および最初のリクエストの前にインタラクティブログインチェックが実行されない Agent SDK コンテキストに表示されます。

315 

316```text theme={null}

317Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

318```

319 

320{/* min-version: 2.1.174 */}v2.1.174 より前では、バックグラウンドまたはクラウドセッションがアイドル状態の事前初期化ワーカーに割り当てられている場合、有効な認証情報が設定されていても、このように失敗する可能性がありました。アップグレードして復旧してください。現在のバージョンでは、エラーはワーカープロセスで認証情報が利用できなかったことを意味します。

321 

322**対応方法:**

323 

324* バックグラウンドまたはクラウドセッションでこれが表示され、認証情報が既に設定されている場合は、v2.1.174 以降にアップグレードしてください

325* `ANTHROPIC_API_KEY`、`CLAUDE_CODE_OAUTH_TOKEN`、またはクラウドプロバイダーの認証情報が、インタラクティブシェルだけでなく、ワーカーを起動する環境で設定されていることを確認してください

326* Agent SDK については、[認証セットアップ](/ja/agent-sdk/overview#get-started)を参照してください

327* 同じ環境のインタラクティブセッションで `/status` を実行して、どの認証情報ソースが解決されるかを確認してください

328 

329<h3 id="invalid-api-key">

330 Invalid API key

331</h3>

259 332 

260`ANTHROPIC_API_KEY` 環境変数または `apiKeyHelper` スクリプトが、API が拒否したキーを返しました。333`ANTHROPIC_API_KEY` 環境変数または `apiKeyHelper` スクリプトが、API が拒否したキーを返しました。

261 334 


271* キーが[`apiKeyHelper`](/ja/settings#available-settings)スクリプトから来ている場合は、スクリプトを直接実行して、stdout に有効なキーを出力することを確認してください344* キーが[`apiKeyHelper`](/ja/settings#available-settings)スクリプトから来ている場合は、スクリプトを直接実行して、stdout に有効なキーを出力することを確認してください

272* `/status` を実行して、Claude Code が実際に使用している認証情報ソースを確認してください345* `/status` を実行して、Claude Code が実際に使用している認証情報ソースを確認してください

273 346 

274### This organization has been disabled347<h3 id="this-organization-has-been-disabled">

348 This organization has been disabled

349</h3>

275 350 

276無効な Console 組織からの古い `ANTHROPIC_API_KEY` がサブスクリプションログインをオーバーライドしています。351無効な Console 組織からの古い `ANTHROPIC_API_KEY` がサブスクリプションログインをオーバーライドしています。

277 352 


288* その後 `/status` を実行して、アクティブな認証情報がサブスクリプションであることを確認してください363* その後 `/status` を実行して、アクティブな認証情報がサブスクリプションであることを確認してください

289* 環境変数が設定されておらず、エラーが続く場合、無効な組織は `/login` に関連付けられているものです。サポートに連絡するか、別のアカウントでサインインしてください。364* 環境変数が設定されておらず、エラーが続く場合、無効な組織は `/login` に関連付けられているものです。サポートに連絡するか、別のアカウントでサインインしてください。

290 365 

291### Your organization has disabled Claude subscription access366<h3 id="your-organization-has-disabled-api-key-authentication">

367 Your organization has disabled API key authentication

368</h3>

369 

370Console 組織の管理者が API キー認証をオフにしているため、API が Claude Code が送信しているキーを拒否しています。`·` の後の復旧ヒントは、キーがどこから来たかによって異なります。

371 

372```text theme={null}

373Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account

374Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead

375Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account

376Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

377```

378 

379環境変数と `apiKeyHelper` は `/login` より優先されるため、どちらかがキーを供給している間は `/login` を実行するだけでは役に立ちません。[認証の優先順位](/ja/authentication#authentication-precedence)を参照してください。

380 

381**対応方法:**

382 

383* メッセージが `ANTHROPIC_API_KEY` に言及している場合は、現在のシェルでアンセットし、シェルプロファイルまたは `.env` ファイルから削除してから、`claude` を再起動してください

384* メッセージが `apiKeyHelper` に言及している場合は、`settings.json` から[`apiKeyHelper`](/ja/settings#available-settings)設定を削除してください

385* `/login` を実行して、claude.ai アカウントでサインインしてください

386* その後 `/status` を実行して、アクティブな認証情報が API キーではなくサブスクリプションであることを確認してください

387* 自動化に API キー認証が必要な場合は、組織の管理者に Console で再度有効にするよう依頼してください

388 

389<h3 id="your-organization-has-disabled-claude-subscription-access">

390 Your organization has disabled Claude subscription access

391</h3>

292 392 

293Claude 組織がサブスクリプションログインで Claude Code にサインインすることを許可していません。同じアカウントで `/login` を再度実行すると、同じエラーが返されます。393Claude 組織がサブスクリプションログインで Claude Code にサインインすることを許可していません。同じアカウントで `/login` を再度実行すると、同じエラーが返されます。

294 394 


304* サブスクリプションの代わりに Console API キーで認証してください。セットアップについては、[Claude Console 認証](/ja/authentication#claude-console-authentication)を参照してください。404* サブスクリプションの代わりに Console API キーで認証してください。セットアップについては、[Claude Console 認証](/ja/authentication#claude-console-authentication)を参照してください。

305* 管理者であり、アクセスを有効にするオプションが表示されない場合は、[Anthropic サポート](https://support.claude.com)に連絡してください405* 管理者であり、アクセスを有効にするオプションが表示されない場合は、[Anthropic サポート](https://support.claude.com)に連絡してください

306 406 

307### Routines are disabled by your organization's policy407<h3 id="routines-are-disabled-by-your-organizations-policy">

408 Routines are disabled by your organization's policy

409</h3>

308 410 

309チームまたはエンタープライズ管理者が、組織レベルでルーチンをオフにしています。エラーは、`/schedule` および claude.ai/code の [Routines](/ja/routines) UI を含め、ルーチンを作成または実行しようとするときに表示されます。411チームまたはエンタープライズ管理者が、組織レベルでルーチンをオフにしています。エラーは、`/schedule` および claude.ai/code の [Routines](/ja/routines) UI を含め、ルーチンを作成または実行しようとするときに表示されます。

310 412 


319* 管理者に [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) で **Routines** トグルを有効にするよう依頼してください421* 管理者に [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) で **Routines** トグルを有効にするよう依頼してください

320* 組織レベルのルーチンを必要としない 1 回限りのスケジュール済み作業については、[スケジュール済みタスク](/ja/scheduled-tasks)を参照してください422* 組織レベルのルーチンを必要としない 1 回限りのスケジュール済み作業については、[スケジュール済みタスク](/ja/scheduled-tasks)を参照してください

321 423 

322### OAuth token revoked or expired424<h3 id="oauth-token-revoked-or-expired">

425 OAuth token revoked or expired

426</h3>

323 427 

324保存されたログインは有効ではなくなりました。取り消されたトークンは、どこかでサインアウトしたか、管理者がアクセスを削除したことを意味します。期限切れのトークンは、自動リフレッシュがセッション中に失敗したことを意味します。428保存されたログインは有効ではなくなりました。取り消されたトークンは、どこかでサインアウトしたか、管理者がアクセスを削除したことを意味します。期限切れのトークンは、自動リフレッシュがセッション中に失敗したことを意味します。

325 429 


336* 起動全体でログインを繰り返しプロンプトされている場合は、[トラブルシューティング](/ja/troubleshoot-install#not-logged-in-or-token-expired)のシステムクロックと macOS キーチェーンチェックを参照してください440* 起動全体でログインを繰り返しプロンプトされている場合は、[トラブルシューティング](/ja/troubleshoot-install#not-logged-in-or-token-expired)のシステムクロックと macOS キーチェーンチェックを参照してください

337* `403 Forbidden` や OAuth ブラウザの問題を含む他の障害については、[ログインと認証](/ja/troubleshoot-install#login-and-authentication)を参照してください441* `403 Forbidden` や OAuth ブラウザの問題を含む他の障害については、[ログインと認証](/ja/troubleshoot-install#login-and-authentication)を参照してください

338 442 

339### OAuth scope requirement443<h3 id="oauth-scope-requirement">

444 OAuth scope requirement

445</h3>

340 446 

341保存されたトークンは、新しい機能が必要とする権限スコープより前のものです。これは、`/usage` とステータスラインの使用量インジケーターから最も頻繁に表示されます。447保存されたトークンは、新しい機能が必要とする権限スコープより前のものです。これは、`/usage` とステータスラインの使用量インジケーターから最も頻繁に表示されます。

342 448 


348 454 

349* `/login` を実行して、現在のスコープで新しいトークンを作成してください。ログアウトする必要はありません。455* `/login` を実行して、現在のスコープで新しいトークンを作成してください。ログアウトする必要はありません。

350 456 

351## ネットワークと接続エラー457<h2 id="network-and-connection-errors">

458 ネットワークと接続エラー

459</h2>

352 460 

353これらのエラーは、Claude Code がネットワークリクエストで API に到達できなかったことを意味します。これらは通常、ローカルネットワーク、プロキシ、またはファイアウォール、あるいはクラウド環境のネットワークポリシーから発生します。461これらのエラーは、Claude Code がネットワークリクエストで API に到達できなかったことを意味します。これらは通常、ローカルネットワーク、プロキシ、またはファイアウォール、あるいはクラウド環境のネットワークポリシーから発生します。

354 462 

355### API に接続できない463<h3 id="unable-to-connect-to-api">

464 API に接続できない

465</h3>

356 466 

357API への TCP 接続に失敗したか、完了しませんでした。467API への TCP 接続に失敗したか、完了しませんでした。

358 468 


381* macOS では、切断または削除された VPN クライアントがトンネルインターフェースまたはルーティングルールを残す可能性があります。`ifconfig` で古い `utun` インターフェースを確認し、システム設定で VPN のネットワーク拡張を削除してください。491* macOS では、切断または削除された VPN クライアントがトンネルインターフェースまたはルーティングルールを残す可能性があります。`ifconfig` で古い `utun` インターフェースを確認し、システム設定で VPN のネットワーク拡張を削除してください。

382* Docker Desktop および同様のコンテナランタイムは、アウトバウンドトラフィックをインターセプトできます。それらを終了して再試行し、これを除外してください。492* Docker Desktop および同様のコンテナランタイムは、アウトバウンドトラフィックをインターセプトできます。それらを終了して再試行し、これを除外してください。

383 493 

384### SSL 証明書エラー494<h3 id="ssl-certificate-errors">

495 SSL 証明書エラー

496</h3>

385 497 

386ネットワーク上のプロキシまたはセキュリティアプライアンスが、独自の証明書で TLS トラフィックをインターセプトしており、Claude Code がそれを信頼していません。498ネットワーク上のプロキシまたはセキュリティアプライアンスが、独自の証明書で TLS トラフィックをインターセプトしており、Claude Code がそれを信頼していません。

387 499 


396* 完全なセットアップ手順については、[ネットワーク設定](/ja/network-config#custom-ca-certificates)を参照してください508* 完全なセットアップ手順については、[ネットワーク設定](/ja/network-config#custom-ca-certificates)を参照してください

397* 証明書検証を完全に無効にする `NODE_TLS_REJECT_UNAUTHORIZED=0` を設定しないでください509* 証明書検証を完全に無効にする `NODE_TLS_REJECT_UNAUTHORIZED=0` を設定しないでください

398 510 

399### クラウドセッションでホストが許可されていない511<h3 id="host-not-allowed-in-a-cloud-session">

512 クラウドセッションでホストが許可されていない

513</h3>

400 514 

401クラウドセッションまたはルーチンからのアウトバウンド HTTP リクエストが、環境のネットワークポリシーによってブロックされました。515クラウドセッションまたはルーチンからのアウトバウンド HTTP リクエストが、環境のネットワークポリシーによってブロックされました。

402 516 


417 531 

418アクセスレベルとデフォルトアローリストについては、[ネットワークアクセス](/ja/claude-code-on-the-web#network-access)を参照してください。ローカル CLI セッションはこのポリシーの影響を受けません。532アクセスレベルとデフォルトアローリストについては、[ネットワークアクセス](/ja/claude-code-on-the-web#network-access)を参照してください。ローカル CLI セッションはこのポリシーの影響を受けません。

419 533 

420## リクエストエラー534<h2 id="request-errors">

535 リクエストエラー

536</h2>

421 537 

422これらのエラーは、API がリクエストを受け取ったが、その内容を拒否したことを意味します。538これらのエラーは、API がリクエストを受け取ったが、その内容を拒否したことを意味します。

423 539 

424### Prompt is too long540<h3 id="prompt-is-too-long">

541 Prompt is too long

542</h3>

425 543 

426会話と添付ファイルがモデルのコンテキストウィンドウを超えています。544会話と添付ファイルがモデルのコンテキストウィンドウを超えています。

427 545 


440 558 

441[コンテキストウィンドウを探索する](/ja/context-window)を参照して、コンテキストがどのように満杯になるかのインタラクティブビューを確認してください。559[コンテキストウィンドウを探索する](/ja/context-window)を参照して、コンテキストがどのように満杯になるかのインタラクティブビューを確認してください。

442 560 

443### Error during compaction: Conversation too long561<h3 id="error-during-compaction-conversation-too-long">

562 Error during compaction: Conversation too long

563</h3>

444 564 

445`/compact` 自体が失敗しました。これは、生成される要約を保持するのに十分な空きコンテキストがないためです。565`/compact` 自体が失敗しました。これは、生成される要約を保持するのに十分な空きコンテキストがないためです。

446 566 


455* Esc を 2 回押してメッセージリストを開き、数ターン戻ってください。これにより、最新のメッセージがコンテキストから削除されます。その後、`/compact` を再度実行してください。575* Esc を 2 回押してメッセージリストを開き、数ターン戻ってください。これにより、最新のメッセージがコンテキストから削除されます。その後、`/compact` を再度実行してください。

456* 戻ることで十分なスペースが解放されない場合は、`/clear` を実行して新しいセッションを開始してください。以前の会話は保存され、`/resume` で再度開くことができます。576* 戻ることで十分なスペースが解放されない場合は、`/clear` を実行して新しいセッションを開始してください。以前の会話は保存され、`/resume` で再度開くことができます。

457 577 

458### Request too large578<h3 id="request-too-large">

579 Request too large

580</h3>

459 581 

460生のリクエストボディが、トークン化前に API のバイト制限を超えました。通常、大きく貼り付けられたファイルまたは添付ファイルが原因です。582生のリクエストボディが、トークン化前に API のバイト制限を超えました。通常、大きく貼り付けられたファイルまたは添付ファイルが原因です。

461 583 


471* 大きなファイルをパスで参照して、内容を貼り付けるのではなく、Claude がチャンク単位で読み取ることができるようにしてください593* 大きなファイルをパスで参照して、内容を貼り付けるのではなく、Claude がチャンク単位で読み取ることができるようにしてください

472* 画像については、以下の[画像が大きすぎました](#image-was-too-large)を参照してください594* 画像については、以下の[画像が大きすぎました](#image-was-too-large)を参照してください

473 595 

474### Image was too large596<h3 id="image-was-too-large">

597 Image was too large

598</h3>

475 599 

476貼り付けられた、または添付された画像が API のサイズまたは寸法制限を超えています。600貼り付けられた、または添付された画像が API のサイズまたは寸法制限を超えています。

477 601 


480API Error: 400 ... image dimensions exceed max allowed size604API Error: 400 ... image dimensions exceed max allowed size

481```605```

482 606 

483画像はエラー後も会話履歴に残るため削除するまで後続のすべてのメッセージは同じエラーで失敗します607{/* min-version: 2.1.142 */}Claude Code は処理できない画像をテキストプレースホルダーに置き換えて再試行するため後続のメッセージは成功しますv2.1.142 より前のバージョンでは、貼り付けられた画像は会話に残る可能性があり、後続のすべてのメッセージで同じエラーが繰り返される可能性があります。これらのバージョンで復旧するには、Esc を 2 回押して、画像が追加されたターンを過ぎて戻ってください。

484 608 

485**対応方法:**609**対応方法:**

486 610 

487* Esc を 2 回押して、画像が追加されたターンを過ぎて戻ってください

488* 貼り付ける前に画像をリサイズしてください。API は、単一の画像の場合は最長辺で最大 8000 ピクセル、またはコンテキストに多くの画像がある場合は 2000 ピクセルの画像を受け入れます。611* 貼り付ける前に画像をリサイズしてください。API は、単一の画像の場合は最長辺で最大 8000 ピクセル、またはコンテキストに多くの画像がある場合は 2000 ピクセルの画像を受け入れます。

489* 全画面ではなく、関連する領域のより厳密なスクリーンショットを撮ってください612* 全画面ではなく、関連する領域のより厳密なスクリーンショットを撮ってください

490 613 

491### Unable to resize image614<h3 id="unable-to-resize-image">

615 Unable to resize image

616</h3>

492 617 

493Claude Code は、API に送信する前に添付された画像をダウンスケールできませんでした。618Claude Code は、API に送信する前に添付された画像をダウンスケールできませんでした。

494 619 


506* メッセージが画像の変換を求めている場合は、PNG、JPEG、GIF、または WebP に変換して、再度添付してください。Claude Code はこれらの形式の寸法を画像プロセッサーなしで検証できます。631* メッセージが画像の変換を求めている場合は、PNG、JPEG、GIF、または WebP に変換して、再度添付してください。Claude Code はこれらの形式の寸法を画像プロセッサーなしで検証できます。

507* メッセージが寸法またはサイズ制限を報告している場合は、その制限以下に画像をリサイズまたは再圧縮してから添付してください。632* メッセージが寸法またはサイズ制限を報告している場合は、その制限以下に画像をリサイズまたは再圧縮してから添付してください。

508 633 

509### PDF errors634<h3 id="pdf-errors">

635 PDF errors

636</h3>

510 637 

511添付した PDF を処理できませんでした。638添付した PDF を処理できませんでした。

512 639 


521* サイズの大きい PDF の場合は、ファイル全体を添付する代わりに Read ツールでページ範囲を読み取るよう Claude に依頼するか、`pdftotext` などのツールでテキストを抽出し、パスでファイルを参照してください648* サイズの大きい PDF の場合は、ファイル全体を添付する代わりに Read ツールでページ範囲を読み取るよう Claude に依頼するか、`pdftotext` などのツールでテキストを抽出し、パスでファイルを参照してください

522* 保護されたまたは無効な PDF の場合は、パスワードを削除するか、ソースアプリケーションからファイルを再度エクスポートしてから、再度試してください649* 保護されたまたは無効な PDF の場合は、パスワードを削除するか、ソースアプリケーションからファイルを再度エクスポートしてから、再度試してください

523 650 

524### Extra inputs are not permitted651<h3 id="extra-inputs-are-not-permitted">

652 Extra inputs are not permitted

653</h3>

525 654 

526Claude Code と API の間のプロキシまたは LLM ゲートウェイが `anthropic-beta` リクエストヘッダーをストリップしたため、API はそれに依存するフィールドを拒否しました。655Claude Code と API の間のプロキシまたは LLM ゲートウェイが `anthropic-beta` リクエストヘッダーをストリップしたため、API はそれに依存するフィールドを拒否しました。

527 656 


538* `anthropic-beta` ヘッダーを転送するようにゲートウェイを設定してください。[LLM ゲートウェイ設定](/ja/llm-gateway)を参照してください。667* `anthropic-beta` ヘッダーを転送するようにゲートウェイを設定してください。[LLM ゲートウェイ設定](/ja/llm-gateway)を参照してください。

539* フォールバックとして、起動前に[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ja/env-vars)を設定してください。これにより、ベータヘッダーが必要な機能が無効になり、リクエストはそれを転送できないゲートウェイを通じて成功します。668* フォールバックとして、起動前に[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ja/env-vars)を設定してください。これにより、ベータヘッダーが必要な機能が無効になり、リクエストはそれを転送できないゲートウェイを通じて成功します。

540 669 

541### There's an issue with the selected model670<h3 id="there’s-an-issue-with-the-selected-model">

671 There's an issue with the selected model

672</h3>

542 673 

543設定されたモデル名が認識されなかったか、アカウントがそれへのアクセスを持っていません。v2.1.160 以降、表示される末尾のヒントはサーフェスによって異なります。674設定されたモデル名が認識されなかったか、アカウントがそれへのアクセスを持っていません。v2.1.160 以降、表示される末尾のヒントはサーフェスによって異なります。

544 675 


555* 間違ったモデルが戻り続ける場合は、古い ID がどこかに設定されています。[優先順位順](/ja/model-config#setting-your-model)で確認してください。`--model` フラグ、`ANTHROPIC_MODEL` 環境変数、その後 `.claude/settings.local.json`、プロジェクトの `.claude/settings.json`、および `~/.claude/settings.json` の `model` フィールド。古い値を削除すると、Claude Code はアカウントのデフォルトにフォールバックします。686* 間違ったモデルが戻り続ける場合は、古い ID がどこかに設定されています。[優先順位順](/ja/model-config#setting-your-model)で確認してください。`--model` フラグ、`ANTHROPIC_MODEL` 環境変数、その後 `.claude/settings.local.json`、プロジェクトの `.claude/settings.json`、および `~/.claude/settings.json` の `model` フィールド。古い値を削除すると、Claude Code はアカウントのデフォルトにフォールバックします。

556* Vertex AI デプロイメントについては、[Vertex AI トラブルシューティング](/ja/google-vertex-ai#troubleshooting)を参照してください。687* Vertex AI デプロイメントについては、[Vertex AI トラブルシューティング](/ja/google-vertex-ai#troubleshooting)を参照してください。

557 688 

558### Claude Opus is not available with the Claude Pro plan689<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

690 Claude Opus is not available with the Claude Pro plan

691</h3>

559 692 

560アクティブなサブスクリプションプランには、選択したモデルが含まれていません。693アクティブなサブスクリプションプランには、選択したモデルが含まれていません。

561 694 


569* 最近プランをアップグレードしてもこれが表示される場合は、`/logout` を実行してから `/login` を実行してください。保存されたトークンはサインイン時のプランを反映しているため、ウェブでアップグレードしても既存のセッションで有効になるまで再認証する必要があります。702* 最近プランをアップグレードしてもこれが表示される場合は、`/logout` を実行してから `/login` を実行してください。保存されたトークンはサインイン時のプランを反映しているため、ウェブでアップグレードしても既存のセッションで有効になるまで再認証する必要があります。

570* [claude.com/pricing](https://claude.com/pricing)を参照して、各プランに含まれるモデルを確認してください703* [claude.com/pricing](https://claude.com/pricing)を参照して、各プランに含まれるモデルを確認してください

571 704 

572### thinking.type.enabled is not supported for this model705<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

706 thinking.type.enabled is not supported for this model

707</h3>

573 708 

574Claude Code バージョンが Opus 4.7 または Opus 4.8 の最小値より古いです。CLI は、モデルが受け入れなくなった思考設定を送信しました。709Claude Code バージョンが Opus 4.7 または Opus 4.8 の最小値より古いです。CLI は、モデルが受け入れなくなった思考設定を送信しました。

575 710 


583* アップグレードできない場合は、`/model` を実行して Opus 4.6 または Sonnet を選択してください718* アップグレードできない場合は、`/model` を実行して Opus 4.6 または Sonnet を選択してください

584* Agent SDK でこれに遭遇した場合は、[SDK トラブルシューティング](/ja/agent-sdk/quickstart#troubleshooting)を参照してください719* Agent SDK でこれに遭遇した場合は、[SDK トラブルシューティング](/ja/agent-sdk/quickstart#troubleshooting)を参照してください

585 720 

586### Thinking budget exceeds output limit721<h3 id="thinking-budget-exceeds-output-limit">

722 Thinking budget exceeds output limit

723</h3>

587 724 

588設定された拡張思考予算が最大レスポンス長を超えているため、実際の回答用のスペースが残っていません。725設定された拡張思考予算が最大レスポンス長を超えているため、実際の回答用のスペースが残っていません。

589 726 


598* `MAX_THINKING_TOKENS` を低くするか、[`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/ja/env-vars)を思考予算より上に上げてください735* `MAX_THINKING_TOKENS` を低くするか、[`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/ja/env-vars)を思考予算より上に上げてください

599* [拡張思考](/ja/model-config#extended-thinking)を参照して、予算が出力長とどのように相互作用するかを確認してください736* [拡張思考](/ja/model-config#extended-thinking)を参照して、予算が出力長とどのように相互作用するかを確認してください

600 737 

601### Tool use or thinking block mismatch738<h3 id="tool-use-or-thinking-block-mismatch">

739 Tool use or thinking block mismatch

740</h3>

602 741 

603会話履歴が矛盾した状態で API に到達しました。通常、ツール呼び出しが中断されたか、ターンがストリーム中に編集された後です。742会話履歴が矛盾した状態で API に到達しました。通常、ツール呼び出しが中断されたか、ターンがストリーム中に編集された後です。

604 743 


615* {/* max-version: 2.1.155 */}Opus 4.7 または Opus 4.8 を使用している場合は、まず `claude update` を実行してください。v2.1.156 より前のバージョンは、通常のツール使用中にこのエラーをトリガーでき、`/rewind` はそれをクリアしません。754* {/* max-version: 2.1.155 */}Opus 4.7 または Opus 4.8 を使用している場合は、まず `claude update` を実行してください。v2.1.156 より前のバージョンは、通常のツール使用中にこのエラーをトリガーでき、`/rewind` はそれをクリアしません。

616* `/rewind` を実行するか、Esc を 2 回押して、破損したターンの前のチェックポイントに戻り、そこから続行してください。[チェックポイント](/ja/checkpointing)を参照して、チェックポイントがどのように作成および復元されるかを確認してください。755* `/rewind` を実行するか、Esc を 2 回押して、破損したターンの前のチェックポイントに戻り、そこから続行してください。[チェックポイント](/ja/checkpointing)を参照して、チェックポイントがどのように作成および復元されるかを確認してください。

617 756 

618### Usage Policy refusal757<h3 id="usage-policy-refusal">

758 Usage Policy refusal

759</h3>

619 760 

620API は、会話内のコンテンツが[利用規約](https://www.anthropic.com/legal/aup)チェックをトリガーしたため、応答を拒否しました。メッセージには、拒否が正しくないと思われる場合にサポートに引用できるリクエスト ID が含まれています。761API は、会話内のコンテンツが[利用規約](https://www.anthropic.com/legal/aup)チェックをトリガーしたため、応答を拒否しました。メッセージには、拒否が正しくないと思われる場合にサポートに引用できるリクエスト ID が含まれています。

621 762 


631* どのターンが原因かを特定できない場合は、`/clear` を実行して同じプロジェクト内で新しい会話を開始してください。以前の会話はディスクに保存され、`/resume` で利用可能なままです。772* どのターンが原因かを特定できない場合は、`/clear` を実行して同じプロジェクト内で新しい会話を開始してください。以前の会話はディスクに保存され、`/resume` で利用可能なままです。

632* [非対話型モード](/ja/headless)(`-p`)では、巻き戻しが利用できないため、言い換えたプロンプトで再試行するか、`--continue` なしで新しいセッションを開始してください。773* [非対話型モード](/ja/headless)(`-p`)では、巻き戻しが利用できないため、言い換えたプロンプトで再試行するか、`--continue` なしで新しいセッションを開始してください。

633 774 

634## Responses seem lower quality than usual775<h2 id="responses-seem-lower-quality-than-usual">

776 Responses seem lower quality than usual

777</h2>

778 

779Claude の回答がエラーなしで予想より能力が低いように見える場合、原因は通常、モデル自体ではなく会話状態です。Claude Code はモデルバージョンを静かに変更しません。3 つの特定のケースでフォールバックモデルに切り替えることができます。

780 

781* 設定された [`--fallback-model`](/ja/cli-reference#cli-flags) は可用性エラーの後にそのターンのみ引き継ぎ、トランスクリプトに通知が表示されます

782* Bedrock または Vertex AI スタートアップチェックがデフォルトモデルが利用不可であることを検出します

783* [Automatic model fallback](/ja/model-config#automatic-model-fallback) on Fable 5 はセッションをデフォルト Opus モデルに移動し、トランスクリプトに通知を表示します

635 784 

636Claude の回答がエラーなしで予想より能力が低いように見える場合、原因は通常、モデル自体ではなく会話状態です。Claude Code はモデルバージョンを静かに変更しません。Opus クォータに達した場合や Bedrock または Vertex AI リージョンがモデルを欠いている場合など、特定の場合にはフォールバックモデルに切り替えることができます以下のモデル選択チェックはその両方をキャッチし、[モデル設定](/ja/model-config)はフォールバックが適用される場合を説明しています785以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします最初のケースはトランスクリプト通知として表示され`/model` 変更ではなく表示されます。[Model configuration](/ja/model-config) はそれぞれのフォールバックが適用される場合を説明しています

637 786 

638最初にこれらを確認してください。787最初にこれらを確認してください。

639 788 

640* **モデル選択**:`/model` を実行して、予想されるモデルにいることを確認してください。以前の `/model` 選択または `ANTHROPIC_MODEL` 環境変数により、意図したより小さいモデルにいる可能性があります。789* **モデル選択**:`/model` を実行して、予想されるモデルにいることを確認してください。以前の `/model` 選択または `ANTHROPIC_MODEL` 環境変数により、意図したより小さいモデルにいる可能性があります。

641* **努力レベル**:`/effort` を実行して、現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げてください。デフォルトはモデルによって異なるため、最大値より下にあると仮定する前に確認してください。[努力レベルを調整する](/ja/model-config#adjust-effort-level)を参照して、モデルごとのデフォルトと `ultrathink` ショートカットを確認してください。790* **努力レベル**:`/effort` を実行して、現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げてください。デフォルトはモデルによって異なるため、最大値より下にあると仮定する前に確認してください。[Adjust effort level](/ja/model-config#adjust-effort-level) を参照して、モデルごとのデフォルトと `ultrathink` ショートカットを確認してください。

642* **コンテキスト圧力**:`/context` を実行して、ウィンドウがどの程度満杯かを確認してください。容量に近い場合は、自然な区切り点で `/compact` を実行するか、`/clear` を実行して新しく開始してください。[コンテキストウィンドウを探索する](/ja/context-window)を参照して、自動コンパクトが以前のターンにどのように影響するかを確認してください。791* **コンテキスト圧力**:`/context` を実行して、ウィンドウがどの程度満杯かを確認してください。容量に近い場合は、自然な区切り点で `/compact` を実行するか、`/clear` を実行して新しく開始してください。[Explore the context window](/ja/context-window) を参照して、自動コンパクトが以前のターンにどのように影響するかを確認してください。

643* **古い指示**:大きなまたは古い `CLAUDE.md` ファイルと MCP ツール定義はコンテキストを消費し、レスポンスを操作できます。`/doctor` は大きなメモリファイルとサブエージェント定義にフラグを立てます。`/context` は MCP ツールトークン使用量を表示します。792* **古い指示**:大きなまたは古い `CLAUDE.md` ファイルと MCP ツール定義はコンテキストを消費し、レスポンスを操作できます。`/doctor` は大きなメモリファイルとサブエージェント定義にフラグを立てます。`/context` は MCP ツールトークン使用量を表示します。

644 793 

645レスポンスが間違っている場合、修正で返信するより、巻き戻しの方が通常うまくいきます。Esc を 2 回押すか、`/rewind` を実行して悪いターンの前に戻り、より詳細なプロンプトで言い換えてください。スレッド内で修正すると、間違った試みがコンテキストに残り、後の回答をそれに固定できます。[チェックポイント](/ja/checkpointing)を参照してください。794レスポンスが間違っている場合、修正で返信するより、巻き戻しの方が通常うまくいきます。Esc を 2 回押すか、`/rewind` を実行して悪いターンの前に戻り、より詳細なプロンプトで言い換えてください。スレッド内で修正すると、間違った試みがコンテキストに残り、後の回答をそれに固定できます。[Checkpointing](/ja/checkpointing) を参照してください。

646 795 

647上記を確認した後も品質が異常に見える場合は、`/feedback` を実行して、期待したものと得たものを説明してください。このように送信されたフィードバックには会話トランスクリプトが含まれており、Anthropic が実際の回帰を診断する最速の方法です。環境で `/feedback` が利用できない場合は、[エラーを報告する](#report-an-error)を参照してください。796上記を確認した後も品質が異常に見える場合は、`/feedback` を実行して、期待したものと得たものを説明してください。このように送信されたフィードバックには会話トランスクリプトが含まれており、Anthropic が実際の回帰を診断する最速の方法です。環境で `/feedback` が利用できない場合は、[Report an error](#report-an-error) を参照してください。

648 797 

649## エラーを報告する798<h2 id="report-an-error">

799 エラーを報告する

800</h2>

650 801 

651このページでは Claude API からのエラーについて説明しています。Claude Code の他のコンポーネントからのエラーについては、関連するガイドを参照してください。802このページでは Claude API からのエラーについて説明しています。Claude Code の他のコンポーネントからのエラーについては、関連するガイドを参照してください。

652 803 

fast-mode.md +2 −2

Details

35 高速モードの切り替え35 高速モードの切り替え

36</h2>36</h2>

37 37 

38次のいずれかの方法で高速モードを切り替えます38高速モードは次のいずれかの方法で切り替えます

39 39 

40* `/fast` と入力して Tab キーを押してオンまたはオフに切り替える40* `/fast` と入力して Tab キーを押してオンまたはオフに切り替える

41* [ユーザー設定ファイル](/ja/settings)で `"fastMode": true` を設定する41* [ユーザー設定ファイル](/ja/settings)で `"fastMode": true` を設定する


115* **Team および Enterprise の管理者による有効化**:高速モードは Team および Enterprise 組織ではデフォルトで無効になっています。ユーザーがアクセスできるようにするには、管理者が明示的に[高速モードを有効にする](#enable-fast-mode-for-your-organization)必要があります。115* **Team および Enterprise の管理者による有効化**:高速モードは Team および Enterprise 組織ではデフォルトで無効になっています。ユーザーがアクセスできるようにするには、管理者が明示的に[高速モードを有効にする](#enable-fast-mode-for-your-organization)必要があります。

116 116 

117<Note>117<Note>

118 管理者が組織の高速モードを有効にしていない場合、`/fast` コマンドは「Fast mode has been disabled by your organization.」と表示されます。118 管理者が組織の高速モードを有効にしていない場合、`/fast` コマンドは「Fast mode has been disabled by your organization.」と表示されます。組織の [`availableModels`](/ja/model-config#restrict-model-selection) 許可リストが高速モード Opus モデルを除外している場合、`/fast` は「is not in your organization's allowed models」で拒否されます。

119</Note>119</Note>

120 120 

121<h3 id="enable-fast-mode-for-your-organization">121<h3 id="enable-fast-mode-for-your-organization">

Details

109 109 

110 **Claude が時々必要とするリファレンスマテリアル(API ドキュメント、スタイルガイド)の場合、またはあなたが `/<name>` でトリガーするワークフロー(デプロイ、レビュー、リリース)の場合は、スキルに入れます。**110 **Claude が時々必要とするリファレンスマテリアル(API ドキュメント、スタイルガイド)の場合、またはあなたが `/<name>` でトリガーするワークフロー(デプロイ、レビュー、リリース)の場合は、スキルに入れます。**

111 111 

112 **経験則:** CLAUDE.md を 200 行以下に保ちます。増加している場合は、リファレンスコンテンツをスキルに移動するか、[`.claude/rules/`](/ja/memory#organize-rules-with-clauderules) ファイルに分割します。112 **経験則:** CLAUDE.md を 200 行以下に保ちます。増加している場合は、リファレンスコンテンツをスキルに移動するか、[`.claude/rules/`](/ja/memory#organize-rules-with-claude%2Frules%2F) ファイルに分割します。

113 </Tab>113 </Tab>

114 114 

115 <Tab title="CLAUDE.md vs Rules vs Skills">115 <Tab title="CLAUDE.md vs Rules vs Skills">


198 198 

199機能は複数のレベルで定義できます。ユーザー全体、プロジェクトごと、プラグイン経由、または管理ポリシーを通じて。また、CLAUDE.md ファイルをサブディレクトリにネストしたり、スキルをモノレポの特定のパッケージに配置したりすることもできます。同じ機能が複数のレベルに存在する場合、ここでそれらがどのようにレイヤーするかを示します。199機能は複数のレベルで定義できます。ユーザー全体、プロジェクトごと、プラグイン経由、または管理ポリシーを通じて。また、CLAUDE.md ファイルをサブディレクトリにネストしたり、スキルをモノレポの特定のパッケージに配置したりすることもできます。同じ機能が複数のレベルに存在する場合、ここでそれらがどのようにレイヤーするかを示します。

200 200 

201* **CLAUDE.md ファイル** は加算的です。すべてのレベルがコンテンツを同時に Claude のコンテキストに提供します。作業ディレクトリ以上のファイルは起動時にロードされます。サブディレクトリは作業時にロードされます。指示が競合する場合、Claude は判断を使用してそれらを調整し、より具体的な指示が通常優先されます。[CLAUDE.md ファイルがどのようにロードされるか](/ja/memory#how-claudemd-files-load) を参照してください。201* **CLAUDE.md ファイル** は加算的です。すべてのレベルがコンテンツを同時に Claude のコンテキストに提供します。作業ディレクトリ以上のファイルは起動時にロードされます。サブディレクトリは作業時にロードされます。指示が競合する場合、Claude は判断を使用してそれらを調整し、より具体的な指示が通常優先されます。[CLAUDE.md ファイルがどのようにロードされるか](/ja/memory#how-claude-md-files-load) を参照してください。

202* **スキルと subagents** は名前でオーバーライドします。同じ名前が複数のレベルに存在する場合、優先度に基づいて 1 つの定義が勝ちます(スキルの場合は管理 > ユーザー > プロジェクト。subagents の場合は管理 > CLI フラグ > プロジェクト > ユーザー > プラグイン)。プラグインスキルは競合を避けるために[名前空間化](/ja/plugins#add-skills-to-your-plugin)されています。[スキル検出](/ja/skills#where-skills-live) と [subagent スコープ](/ja/sub-agents#choose-the-subagent-scope) を参照してください。202* **スキルと subagents** は名前でオーバーライドします。同じ名前が複数のレベルに存在する場合、優先度に基づいて 1 つの定義が勝ちます(スキルの場合は管理 > ユーザー > プロジェクト。subagents の場合は管理 > CLI フラグ > プロジェクト > ユーザー > プラグイン)。プラグインスキルは競合を避けるために[名前空間化](/ja/plugins#add-skills-to-your-plugin)されています。[スキル検出](/ja/skills#where-skills-live) と [subagent スコープ](/ja/sub-agents#choose-the-subagent-scope) を参照してください。

203* **MCP サーバー** は名前でオーバーライドします。ローカル > プロジェクト > ユーザー。[MCP スコープ](/ja/mcp#scope-hierarchy-and-precedence) を参照してください。203* **MCP サーバー** は名前でオーバーライドします。ローカル > プロジェクト > ユーザー。[MCP スコープ](/ja/mcp#scope-hierarchy-and-precedence) を参照してください。

204* **Hooks** はマージされます。すべての登録されたフックは、ソースに関係なく、マッチングイベントに対して発火します。[Hooks](/ja/hooks) を参照してください。204* **Hooks** はマージされます。すべての登録されたフックは、ソースに関係なく、マッチングイベントに対して発火します。[Hooks](/ja/hooks) を参照してください。


255 255 

256 **ロード内容:** すべての CLAUDE.md ファイル(管理、ユーザー、プロジェクトレベル)の完全なコンテンツ。256 **ロード内容:** すべての CLAUDE.md ファイル(管理、ユーザー、プロジェクトレベル)の完全なコンテンツ。

257 257 

258 **継承:** Claude は作業ディレクトリからルートまで CLAUDE.md ファイルを読み取り、サブディレクトリにネストされたものを、それらのファイルにアクセスするときに検出します。詳細は [CLAUDE.md ファイルがどのようにロードされるか](/ja/memory#how-claudemd-files-load) を参照してください。258 **継承:** Claude は作業ディレクトリからルートまで CLAUDE.md ファイルを読み取り、サブディレクトリにネストされたものを、それらのファイルにアクセスするときに検出します。詳細は [CLAUDE.md ファイルがどのようにロードされるか](/ja/memory#how-claude-md-files-load) を参照してください。

259 259 

260 <Tip>CLAUDE.md を 200 行以下に保ちます。リファレンスマテリアルをスキルに移動します。スキルはオンデマンドでロードされます。</Tip>260 <Tip>CLAUDE.md を 200 行以下に保ちます。リファレンスマテリアルをスキルに移動します。スキルはオンデマンドでロードされます。</Tip>

261 </Tab>261 </Tab>

fullscreen.md +22 −3

Details

104export CLAUDE_CODE_SCROLL_SPEED=3104export CLAUDE_CODE_SCROLL_SPEED=3

105```105```

106 106 

107値 `3` は `vim` および同様のアプリケーションのデフォルトと一致します。この設定は 1 から 20 の値を受け入れます107値 `3` は `vim` および同様のアプリケーションのデフォルトと一致します。この設定は 1 から 20 の値を受け入れ、トラックパッドとホイールスクロールを遅くするために 1 未満の小数値(`0.5` など)を受け入れますこれらは既にホイールイベントを増幅するターミナルで使用されます。

108 108 

109スクロール速度を対話的に調整するには、`/scroll-speed` を実行します。ダイアログには、開いている間にスクロールできるルーラーが表示されるため、変更をすぐに感じることができます。`←` と `→` を押して調整し、`r` を押して自動検出されたデフォルトにリセットし、`Enter` を押して保存します。このコマンドは `CLAUDE_CODE_SCROLL_SPEED` 環境変数が設定する同じ値を書き込み、`~/.claude/settings.json` に永続化されます。このコマンドは JetBrains IDE ターミナルでは利用できません。109スクロール速度を対話的に調整するには、`/scroll-speed` を実行します。ダイアログには、開いている間にスクロールできるルーラーが表示されるため、変更をすぐに感じることができます。`←` と `→` を押して調整し、`r` を押して自動検出されたデフォルトにリセットし、`Enter` を押して保存します。このコマンドは `CLAUDE_CODE_SCROLL_SPEED` 環境変数が設定する同じ値を書き込み、`~/.claude/settings.json` に永続化されます。このコマンドは JetBrains IDE ターミナルでは利用できません。

110 110 

111ベース速度とは別に、Claude Code はホイールを素早く回転させるときにスクロール速度を加速するため、高速回転は同じ数の遅い回転よりも多くの距離をカバーします。加速をオフにして、ノッチごとに一定の速度を保つには、[`settings.json`](/ja/settings#available-settings)で `wheelScrollAccelerationEnabled` を `false` に設定します。この設定には Claude Code v2.1.174 以降が必要です。

112 

111<h3 id="scroll-in-the-jetbrains-ide-terminal">113<h3 id="scroll-in-the-jetbrains-ide-terminal">

112 JetBrains IDE ターミナルでのスクロール114 JetBrains IDE ターミナルでのスクロール

113</h3>115</h3>


171 173 

172マウスキャプチャは最も一般的な摩擦点です。特に SSH 経由または tmux 内です。Claude Code がマウスイベントをキャプチャすると、ターミナルのネイティブなコピーオンセレクトが機能しなくなります。クリックアンドドラッグで行う選択は Claude Code 内に存在し、ターミナルの選択バッファには存在しないため、tmux コピーモード、Kitty ヒント、および同様のツールはそれを見ることができません。174マウスキャプチャは最も一般的な摩擦点です。特に SSH 経由または tmux 内です。Claude Code がマウスイベントをキャプチャすると、ターミナルのネイティブなコピーオンセレクトが機能しなくなります。クリックアンドドラッグで行う選択は Claude Code 内に存在し、ターミナルの選択バッファには存在しないため、tmux コピーモード、Kitty ヒント、および同様のツールはそれを見ることができません。

173 175 

174Claude Code は選択をクリップボードに書き込もうとしますが、使用するパスはセットアップに依存します。tmux 内では tmux ペーストバッファに書き込みます。SSH 経由では OSC 52 エスケープシーケンスにフォールバックし、一部のターミナルはデフォルトでブロックしますiTerm2 は Settings → General → Selection → Applications in terminal may access clipboard をオンにするまでブロックしますClaude Code は各コピー後にトーストを出力し、使用したパスを通知します176Claude Code は選択をシステムクリップボードに書き込みます使用するパスはセットアップに依存しますローカルセッションではネイティブクリップボードツールを実行します

177 

178* **macOS**: `pbcopy`

179* **Linux**: Wayland では `wl-copy`、X11 では `xclip` または `xsel`(インストールされているもの)。Claude Code はクリップボードと PRIMARY 選択の両方に書き込むため、中クリックペーストが機能します。

180* **Windows と WSL**: PowerShell `Set-Clipboard`

181 

182tmux 内では tmux ペーストバッファにも書き込みます。SSH 経由では OSC 52 エスケープシーケンスにフォールバックします。Claude Code は各コピー後にトーストを表示し、使用したパスを通知します。

183 

184一部のターミナルはデフォルトで OSC 52 をブロックします。iTerm2 は Settings → General → Selection → Applications in terminal may access clipboard をオンにするまでブロックします。iTerm2 で [`/terminal-setup`](/ja/terminal-config) を実行すると、これが有効になります。

185 

186一度限りのネイティブ選択の場合、使用するキーはターミナルに依存します。

187 

188* **Terminal.app**: `Fn`

189* **iTerm2**: `Option`

190* **VS Code、Cursor、Devin Desktop**: `Shift`、または macOS で `terminal.integrated.macOptionClickForcesSelection` 設定が有効な場合は `Option`

191* **その他のほとんどのターミナル**: `Shift`

192 

193そのキーを押しながらクリックアンドドラッグします。ターミナルが選択を自分で処理し、Claude Code に渡さないため、`Cmd+C` などのコピーショートカットが選択に対して機能します。Claude Code は画面上のヒントに正しいキーも表示します。

175 194 

176一度限りのネイティブ選択の場合、ターミナルのバイパス修飾キーを押しながらクリックアンドドラッグします。iTerm2 では `Option`、ほとんどの Linux および Windows ターミナルでは `Shift` です。修飾キーはターミナルに選択を自分で処理するよう指示しマウスイベントを Claude Code に転送しないため`Cmd+C` とターミナルの他のコピーショートカットが機能します195SSH 経由または tmux 内では、Claude Code が接続元のターミナルを常に検出できるとは限らないためヒントは候補キーのリストを表示します

177 196 

178ネイティブ選択に常に依存する場合、`CLAUDE_CODE_DISABLE_MOUSE=1` を設定してマウスキャプチャをオプトアウトしながら、ちらつきのないレンダリングとフラットメモリを保持します。197ネイティブ選択に常に依存する場合、`CLAUDE_CODE_DISABLE_MOUSE=1` を設定してマウスキャプチャをオプトアウトしながら、ちらつきのないレンダリングとフラットメモリを保持します。

179 198 

github-actions.md +118 −54

Details

12 Claude Code GitHub Actions は [Claude Agent SDK](/ja/agent-sdk/overview) の上に構築されており、Claude Code をアプリケーションにプログラム的に統合できます。SDK を使用して、GitHub Actions を超えたカスタム自動化ワークフローを構築できます。12 Claude Code GitHub Actions は [Claude Agent SDK](/ja/agent-sdk/overview) の上に構築されており、Claude Code をアプリケーションにプログラム的に統合できます。SDK を使用して、GitHub Actions を超えたカスタム自動化ワークフローを構築できます。

13</Note>13</Note>

14 14 

15<Info>15<h2 id="why-use-claude-code-github-actions">

16 **Claude Opus 4.8 が利用可能になりました。** Claude Code GitHub Actions はデフォルトで Sonnet を使用します。Opus 4.8 を使用するには、[model パラメータ](#breaking-changes-reference) を `claude-opus-4-8` に設定してください。16 Claude Code GitHub Actions を使用する理由

17</Info>17</h2>

18 

19## Claude Code GitHub Actions を使用する理由

20 18 

21* **即座の PR 作成**: 必要なことを説明すると、Claude は必要なすべての変更を含む完全な PR を作成します19* **即座の PR 作成**: 必要なことを説明すると、Claude は必要なすべての変更を含む完全な PR を作成します

22* **自動コード実装**: イシューを 1 つのコマンドで動作するコードに変換します20* **自動コード実装**: イシューを 1 つのコマンドで動作するコードに変換します


24* **シンプルなセットアップ**: インストーラーと API キーで数分で開始できます22* **シンプルなセットアップ**: インストーラーと API キーで数分で開始できます

25* **デフォルトで安全**: コードは Github のランナーに留まります23* **デフォルトで安全**: コードは Github のランナーに留まります

26 24 

27## Claude は何ができますか?25<h2 id="what-can-claude-do">

26 Claude は何ができますか?

27</h2>

28 28 

29Claude Code は、コードの操作方法を変える強力な GitHub Action を提供します。29Claude Code は、コードの操作方法を変える強力な GitHub Action を提供します。

30 30 

31### Claude Code Action31<h3 id="claude-code-action">

32 Claude Code Action

33</h3>

32 34 

33この GitHub Action により、GitHub Actions ワークフロー内で Claude Code を実行できます。Claude Code の上に任意のカスタムワークフローを構築するために使用できます。35この GitHub Action により、GitHub Actions ワークフロー内で Claude Code を実行できます。Claude Code の上に任意のカスタムワークフローを構築するために使用できます。

34 36 

35[リポジトリを表示 →](https://github.com/anthropics/claude-code-action)37[リポジトリを表示 →](https://github.com/anthropics/claude-code-action)

36 38 

37## セットアップ39<h2 id="setup">

40 セットアップ

41</h2>

38 42 

39## クイックセットアップ43<h2 id="quick-setup">

44 クイックセットアップ

45</h2>

40 46 

41このアクションをセットアップする最も簡単な方法は、ターミナルで Claude Code を使用することです。claude を開いて `/install-github-app` を実行するだけです。47このアクションをセットアップする最も簡単な方法は、ターミナルで Claude Code を使用することです。claude を開いて `/install-github-app` を実行するだけです。

42 48 


48 * このクイックスタート方法は、直接 Claude API ユーザーのみが利用できます。Amazon Bedrock または Google Vertex AI を使用している場合は、[Amazon Bedrock と Google Vertex AI での使用](#using-with-amazon-bedrock-%26-google-vertex-ai) セクションを参照してください。54 * このクイックスタート方法は、直接 Claude API ユーザーのみが利用できます。Amazon Bedrock または Google Vertex AI を使用している場合は、[Amazon Bedrock と Google Vertex AI での使用](#using-with-amazon-bedrock-%26-google-vertex-ai) セクションを参照してください。

49</Note>55</Note>

50 56 

51## 手動セットアップ57<h2 id="manual-setup">

58 手動セットアップ

59</h2>

52 60 

53`/install-github-app` コマンドが失敗した場合、または手動セットアップを希望する場合は、以下の手動セットアップ手順に従ってください。61`/install-github-app` コマンドが失敗した場合、または手動セットアップを希望する場合は、以下の手動セットアップ手順に従ってください。

54 62 


68 クイックスタートまたは手動セットアップのいずれかを完了した後、イシューまたは PR コメントで `@claude` をタグ付けしてアクションをテストします。76 クイックスタートまたは手動セットアップのいずれかを完了した後、イシューまたは PR コメントで `@claude` をタグ付けしてアクションをテストします。

69</Tip>77</Tip>

70 78 

71## ベータ版からのアップグレード79<h2 id="upgrading-from-beta">

80 ベータ版からのアップグレード

81</h2>

72 82 

73<Warning>83<Warning>

74 Claude Code GitHub Actions v1.0 は、ベータ版から v1.0 にアップグレードするためにワークフローファイルを更新する必要がある破壊的な変更を導入しています。84 Claude Code GitHub Actions v1.0 は、ベータ版から v1.0 にアップグレードするためにワークフローファイルを更新する必要がある破壊的な変更を導入しています。


76 86 

77現在 Claude Code GitHub Actions のベータ版を使用している場合は、ワークフローを GA バージョンを使用するように更新することをお勧めします。新しいバージョンは、自動モード検出などの強力な新機能を追加しながら、設定を簡素化します。87現在 Claude Code GitHub Actions のベータ版を使用している場合は、ワークフローを GA バージョンを使用するように更新することをお勧めします。新しいバージョンは、自動モード検出などの強力な新機能を追加しながら、設定を簡素化します。

78 88 

79### 重要な変更89<h3 id="essential-changes">

90 重要な変更

91</h3>

80 92 

81すべてのベータユーザーは、アップグレードするためにワークフローファイルで以下の変更を行う必要があります。93すべてのベータユーザーは、アップグレードするためにワークフローファイルで以下の変更を行う必要があります。

82 94 


853. **プロンプト入力を更新**: `direct_prompt` を `prompt` に置き換えます973. **プロンプト入力を更新**: `direct_prompt` を `prompt` に置き換えます

864. **CLI オプションを移動**: `max_turns`、`model`、`custom_instructions` などを `claude_args` に変換します984. **CLI オプションを移動**: `max_turns`、`model`、`custom_instructions` などを `claude_args` に変換します

87 99 

88### 破壊的な変更リファレンス100<h3 id="breaking-changes-reference">

101 破壊的な変更リファレンス

102</h3>

89 103 

90| 古いベータ入力 | 新しい v1.0 入力 |104| 古いベータ入力 | 新しい v1.0 入力 |

91| --------------------- | ------------------------------------- |105| --------------------- | ------------------------------------- |


99| `disallowed_tools` | `claude_args: --disallowedTools` |113| `disallowed_tools` | `claude_args: --disallowedTools` |

100| `claude_env` | `settings` JSON format |114| `claude_env` | `settings` JSON format |

101 115 

102### 前後の例116<h3 id="before-and-after-example">

117 前後の例

118</h3>

103 119 

104**ベータ版:**120**ベータ版:**

105 121 


131 アクションは、設定に基づいて、インタラクティブモード(`@claude` メンションに応答)または自動化モード(プロンプト付きで即座に実行)で実行するかどうかを自動的に検出します。147 アクションは、設定に基づいて、インタラクティブモード(`@claude` メンションに応答)または自動化モード(プロンプト付きで即座に実行)で実行するかどうかを自動的に検出します。

132</Tip>148</Tip>

133 149 

134## 使用例150<h2 id="example-use-cases">

151 使用例

152</h2>

135 153 

136Claude Code GitHub Actions は、さまざまなタスクに役立ちます。[examples ディレクトリ](https://github.com/anthropics/claude-code-action/tree/main/examples) には、さまざまなシナリオ用の使用可能なワークフローが含まれています。154Claude Code GitHub Actions は、さまざまなタスクに役立ちます。[examples ディレクトリ](https://github.com/anthropics/claude-code-action/tree/main/examples) には、さまざまなシナリオ用の使用可能なワークフローが含まれています。

137 155 

138### 基本的なワークフロー156<h3 id="basic-workflow">

157 基本的なワークフロー

158</h3>

139 159 

140```yaml theme={null}160```yaml theme={null}

141name: Claude Code161name: Claude Code


154 # Responds to @claude mentions in comments174 # Responds to @claude mentions in comments

155```175```

156 176 

157### skills を使用する177<h3 id="using-skills">

178 skills を使用する

179</h3>

158 180 

159`prompt` 入力は、[skill](/ja/skills) の呼び出しだけでなく、プレーンテキストも受け入れます。181`prompt` 入力は、[skill](/ja/skills) の呼び出しだけでなく、プレーンテキストも受け入れます。

160 182 


180 prompt: "/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"202 prompt: "/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"

181```203```

182 204 

183### プロンプトを使用したカスタム自動化205<h3 id="custom-automation-with-prompts">

206 プロンプトを使用したカスタム自動化

207</h3>

184 208 

185```yaml theme={null}209```yaml theme={null}

186name: Daily Report210name: Daily Report


198 claude_args: "--model opus"222 claude_args: "--model opus"

199```223```

200 224 

201### 一般的な使用例225<h3 id="common-use-cases">

226 一般的な使用例

227</h3>

202 228 

203イシューまたは PR コメント内:229イシューまたは PR コメント内:

204 230 


210 236 

211Claude は自動的にコンテキストを分析し、適切に応答します。237Claude は自動的にコンテキストを分析し、適切に応答します。

212 238 

213## ベストプラクティス239<h2 id="best-practices">

240 ベストプラクティス

241</h2>

214 242 

215### CLAUDE.md 設定243<h3 id="claude-md-configuration">

244 CLAUDE.md 設定

245</h3>

216 246 

217リポジトリルートに `CLAUDE.md` ファイルを作成して、コードスタイルガイドライン、レビュー基準、プロジェクト固有のルール、および推奨パターンを定義します。このファイルは、Claude のプロジェクト標準の理解をガイドします。247リポジトリルートに `CLAUDE.md` ファイルを作成して、コードスタイルガイドライン、レビュー基準、プロジェクト固有のルール、および推奨パターンを定義します。このファイルは、Claude のプロジェクト標準の理解をガイドします。

218 248 

219### セキュリティに関する考慮事項249<h3 id="security-considerations">

250 セキュリティに関する考慮事項

251</h3>

220 252 

221<Warning>API キーをリポジトリに直接コミットしないでください。</Warning>253<Warning>API キーをリポジトリに直接コミットしないでください。</Warning>

222 254 


231 263 

232常に GitHub Secrets(例えば、`${{ secrets.ANTHROPIC_API_KEY }}`)を使用し、API キーをワークフローファイルに直接ハードコードしないでください。264常に GitHub Secrets(例えば、`${{ secrets.ANTHROPIC_API_KEY }}`)を使用し、API キーをワークフローファイルに直接ハードコードしないでください。

233 265 

234### パフォーマンスの最適化266<h3 id="optimizing-performance">

267 パフォーマンスの最適化

268</h3>

235 269 

236イシューテンプレートを使用してコンテキストを提供し、`CLAUDE.md` を簡潔で焦点を絞ったものに保ち、ワークフローに適切なタイムアウトを設定します。270イシューテンプレートを使用してコンテキストを提供し、`CLAUDE.md` を簡潔で焦点を絞ったものに保ち、ワークフローに適切なタイムアウトを設定します。

237 271 

238### CI コスト272<h3 id="ci-costs">

273 CI コスト

274</h3>

239 275 

240Claude Code GitHub Actions を使用する場合、関連するコストに注意してください。276Claude Code GitHub Actions を使用する場合、関連するコストに注意してください。

241 277 


257* ワークフローレベルのタイムアウトを設定して、暴走ジョブを回避します293* ワークフローレベルのタイムアウトを設定して、暴走ジョブを回避します

258* GitHub の並行制御を使用して、並列実行を制限することを検討します294* GitHub の並行制御を使用して、並列実行を制限することを検討します

259 295 

260## 設定例296<h2 id="configuration-examples">

297 設定例

298</h2>

261 299 

262Claude Code Action v1 は、統一されたパラメータで設定を簡素化します。300Claude Code Action v1 は、統一されたパラメータで設定を簡素化します。

263 301 


282 イシューまたは PR コメントに応答する場合、Claude は自動的に @claude メンションに応答します。その他のイベントについては、`prompt` パラメータを使用して指示を提供します。320 イシューまたは PR コメントに応答する場合、Claude は自動的に @claude メンションに応答します。その他のイベントについては、`prompt` パラメータを使用して指示を提供します。

283</Tip>321</Tip>

284 322 

285## Amazon Bedrock と Google Vertex AI での使用323<h2 id="using-with-amazon-bedrock--google-vertex-ai">

324 Amazon Bedrock と Google Vertex AI での使用

325</h2>

286 326 

287エンタープライズ環境では、Claude Code GitHub Actions を独自のクラウドインフラストラクチャで使用できます。このアプローチにより、データレジデンシーと請求を制御しながら、同じ機能を維持できます。327エンタープライズ環境では、Claude Code GitHub Actions を独自のクラウドインフラストラクチャで使用できます。このアプローチにより、データレジデンシーと請求を制御しながら、同じ機能を維持できます。

288 328 

289### 前提条件329<h3 id="prerequisites">

330 前提条件

331</h3>

290 332 

291クラウドプロバイダーで Claude Code GitHub Actions をセットアップする前に、以下が必要です。333クラウドプロバイダーで Claude Code GitHub Actions をセットアップする前に、以下が必要です。

292 334 

293#### Google Cloud Vertex AI の場合:335<h4 id="for-google-cloud-vertex-ai">

336 Google Cloud Vertex AI の場合:

337</h4>

294 338 

2951. Vertex AI が有効な Google Cloud プロジェクト3391. Vertex AI が有効な Google Cloud プロジェクト

2962. GitHub Actions 用に設定された Workload Identity Federation3402. GitHub Actions 用に設定された Workload Identity Federation

2973. 必要なアクセス許可を持つサービスアカウント3413. 必要なアクセス許可を持つサービスアカウント

2984. GitHub App(推奨)または デフォルトの GITHUB\_TOKEN を使用3424. GitHub App(推奨)または デフォルトの GITHUB\_TOKEN を使用

299 343 

300#### Amazon Bedrock の場合:344<h4 id="for-amazon-bedrock">

345 Amazon Bedrock の場合:

346</h4>

301 347 

3021. Amazon Bedrock が有効な AWS アカウント3481. Amazon Bedrock が有効な AWS アカウント

3032. AWS で設定された GitHub OIDC Identity Provider3492. AWS で設定された GitHub OIDC Identity Provider


348 クラウドプロバイダーを選択し、安全な認証をセットアップします。394 クラウドプロバイダーを選択し、安全な認証をセットアップします。

349 395 

350 <AccordionGroup>396 <AccordionGroup>

351 <Accordion title="AWS Bedrock">397 <Accordion title="Amazon Bedrock">

352 **GitHub Actions が認証情報を保存せずに安全に認証できるように AWS を設定します。**398 **GitHub Actions が認証情報を保存せずに安全に認証できるように AWS を設定します。**

353 399 

354 > **セキュリティに関する注意**: リポジトリ固有の設定を使用し、最小限の必要なアクセス許可のみを付与します。400 > **セキュリティに関する注意**: リポジトリ固有の設定を使用し、最小限の必要なアクセス許可のみを付与します。


447 * `APP_ID`: GitHub App の ID493 * `APP_ID`: GitHub App の ID

448 * `APP_PRIVATE_KEY`: プライベートキー(.pem)の内容494 * `APP_PRIVATE_KEY`: プライベートキー(.pem)の内容

449 495 

450 #### AWS Bedrock の場合496 #### Amazon Bedrock の場合

451 497 

452 1. **AWS 認証の場合**:498 1. **AWS 認証の場合**:

453 * `AWS_ROLE_TO_ASSUME`499 * `AWS_ROLE_TO_ASSUME`


458 </Step>504 </Step>

459 505 

460 <Step title="ワークフローファイルを作成">506 <Step title="ワークフローファイルを作成">

461 クラウドプロバイダーと統合する GitHub Actions ワークフローファイルを作成します。以下の例は、AWS Bedrock と Google Vertex AI の両方の完全な設定を示しています。507 クラウドプロバイダーと統合する GitHub Actions ワークフローファイルを作成します。以下の例は、Amazon Bedrock と Google Vertex AI の両方の完全な設定を示しています。

462 508 

463 <AccordionGroup>509 <AccordionGroup>

464 <Accordion title="AWS Bedrock ワークフロー">510 <Accordion title="Amazon Bedrock ワークフロー">

465 **前提条件:**511 **前提条件:**

466 512 

467 * AWS Bedrock アクセスが有効で、Claude モデルのアクセス許可がある513 * Amazon Bedrock アクセスが有効で、Claude モデルのアクセス許可がある

468 * GitHub が AWS で OIDC ID プロバイダーとして設定されている514 * GitHub が AWS で OIDC ID プロバイダーとして設定されている

469 * Bedrock アクセス許可を持つ IAM ロールが GitHub Actions を信頼している515 * Bedrock アクセス許可を持つ IAM ロールが GitHub Actions を信頼している

470 516 


609 </Step>655 </Step>

610</Steps>656</Steps>

611 657 

612## トラブルシューティング658<h2 id="troubleshooting">

659 トラブルシューティング

660</h2>

613 661 

614### Claude が @claude コマンドに応答しない662<h3 id="claude-not-responding-to-claude-commands">

663 Claude が @claude コマンドに応答しない

664</h3>

615 665 

616GitHub App が正しくインストールされていることを確認し、ワークフローが有効になっていることを確認し、API キーがリポジトリシークレットに設定されていることを確認し、コメントに `@claude` が含まれていることを確認します(`/claude` ではなく)。666GitHub App が正しくインストールされていることを確認し、ワークフローが有効になっていることを確認し、API キーがリポジトリシークレットに設定されていることを確認し、コメントに `@claude` が含まれていることを確認します(`/claude` ではなく)。

617 667 

618### CI が Claude のコミットで実行されない668<h3 id="ci-not-running-on-claude’s-commits">

669 CI が Claude のコミットで実行されない

670</h3>

619 671 

620GitHub App またはカスタムアプリを使用していることを確認します(Actions ユーザーではなく)、ワークフロートリガーに必要なイベントが含まれていることを確認し、アプリのアクセス許可に CI トリガーが含まれていることを確認します。672GitHub App またはカスタムアプリを使用していることを確認します(Actions ユーザーではなく)、ワークフロートリガーに必要なイベントが含まれていることを確認し、アプリのアクセス許可に CI トリガーが含まれていることを確認します。

621 673 

622### 認証エラー674<h3 id="authentication-errors">

675 認証エラー

676</h3>

623 677 

624API キーが有効で十分なアクセス許可があることを確認します。Bedrock/Vertex の場合、認証情報の設定を確認し、シークレットがワークフロー内で正しく名前付けされていることを確認します。678API キーが有効で十分なアクセス許可があることを確認します。Bedrock/Vertex の場合、認証情報の設定を確認し、シークレットがワークフロー内で正しく名前付けされていることを確認します。

625 679 

626## 高度な設定680<h2 id="advanced-configuration">

681 高度な設定

682</h2>

627 683 

628### アクションパラメータ684<h3 id="action-parameters">

685 アクションパラメータ

686</h3>

629 687 

630Claude Code Action v1 は、簡素化された設定を使用します。688Claude Code Action v1 は、簡素化された設定を使用します。

631 689 

632| Parameter | Description | Required |690| Parameter | Description | 必須 |

633| --------------------- | --------------------------------------------- | -------- |691| --------------------- | --------------------------------------------- | ------ |

634| `prompt` | Claude の指示(プレーンテキストまたは [skill](/ja/skills) 名) | No\* |692| `prompt` | Claude の指示(プレーンテキストまたは [skill](/ja/skills) 名) | いいえ\* |

635| `claude_args` | Claude Code に渡される CLI 引数 | No |693| `claude_args` | Claude Code に渡される CLI 引数 | いいえ |

636| `plugin_marketplaces` | プラグインマーケットプレイス Git URL の改行区切りリスト | No |694| `plugin_marketplaces` | プラグインマーケットプレイス Git URL の改行区切りリスト | いいえ |

637| `plugins` | 実行前にインストールするプラグイン名の改行区切りリスト | No |695| `plugins` | 実行前にインストールするプラグイン名の改行区切りリスト | いいえ |

638| `anthropic_api_key` | Claude API キー | Yes\*\* |696| `anthropic_api_key` | Claude API キー | はい\*\* |

639| `github_token` | API アクセス用の GitHub トークン | No |697| `github_token` | API アクセス用の GitHub トークン | いいえ |

640| `trigger_phrase` | カスタムトリガーフレーズ(デフォルト:「@claude」) | No |698| `trigger_phrase` | カスタムトリガーフレーズ(デフォルト:「@claude」) | いいえ |

641| `use_bedrock` | Claude API の代わりに Amazon Bedrock を使用 | No |699| `use_bedrock` | Claude API の代わりに Amazon Bedrock を使用 | いいえ |

642| `use_vertex` | Claude API の代わりに Google Vertex AI を使用 | No |700| `use_vertex` | Claude API の代わりに Google Vertex AI を使用 | いいえ |

643 701 

644\*プロンプトはオプションです。イシュー/PR コメントで省略された場合、Claude はトリガーフレーズに応答します\702\*プロンプトはオプションです。イシュー/PR コメントで省略された場合、Claude はトリガーフレーズに応答します\

645\*\*直接 Claude API に必要です。Bedrock/Vertex には不要です703\*\*直接 Claude API に必要です。Bedrock/Vertex には不要です

646 704 

647#### CLI 引数を渡す705<h4 id="pass-cli-arguments">

706 CLI 引数を渡す

707</h4>

648 708 

649`claude_args` パラメータは、任意の Claude Code CLI 引数を受け入れます。709`claude_args` パラメータは、任意の Claude Code CLI 引数を受け入れます。

650 710 


660* `--allowedTools`: 許可されたツールのカンマ区切りリスト。`--allowed-tools` エイリアスも機能します。720* `--allowedTools`: 許可されたツールのカンマ区切りリスト。`--allowed-tools` エイリアスも機能します。

661* `--debug`: デバッグ出力を有効にします721* `--debug`: デバッグ出力を有効にします

662 722 

663### 代替統合方法723<h3 id="alternative-integration-methods">

724 代替統合方法

725</h3>

664 726 

665`/install-github-app` コマンドは推奨されるアプローチですが、以下も実行できます。727`/install-github-app` コマンドは推奨されるアプローチですが、以下も実行できます。

666 728 


670 732 

671詳細なガイドについては、[Claude Code Action ドキュメント](https://github.com/anthropics/claude-code-action/blob/main/docs) を参照してください。認証、セキュリティ、高度な設定に関する詳細なガイドがあります。733詳細なガイドについては、[Claude Code Action ドキュメント](https://github.com/anthropics/claude-code-action/blob/main/docs) を参照してください。認証、セキュリティ、高度な設定に関する詳細なガイドがあります。

672 734 

673### Claude の動作をカスタマイズ735<h3 id="customizing-claude’s-behavior">

736 Claude の動作をカスタマイズ

737</h3>

674 738 

675Claude の動作は 2 つの方法で設定できます。739Claude の動作は 2 つの方法で設定できます。

676 740 

Details

110claude --remote "Add retry logic to the payment webhook handler"110claude --remote "Add retry logic to the payment webhook handler"

111```111```

112 112 

113セッションは Anthropic インフラストラクチャで実行され、GHES からリポジトリをクローンし、変更をブランチにプッシュバックします。`/tasks` で、または [claude.ai/code](https://claude.ai/code) で進捗を監視します。diff レビュー、自動修正、ルーチンを含む完全なリモートセッションワークフローについては、[Claude Code on the web](/ja/claude-code-on-the-web) を参照してください。113セッションは Anthropic インフラストラクチャで実行され、GHES からリポジトリをクローンし、変更をブランチにプッシュバックします。`/tasks` で、または [claude.ai/code](https://claude.ai/code) で進捗を監視します。diff レビュー、自動修正、ルーチンを含む完全なクラウドセッションワークフローについては、[Claude Code on the web](/ja/claude-code-on-the-web) を参照してください。[Claude Code on the web](/ja/claude-code-on-the-web) を参照してください。

114 114 

115<h3 id="teleport-sessions-to-your-terminal">115<h3 id="teleport-sessions-to-your-terminal">

116 セッションをターミナルに Teleport116 セッションをターミナルに Teleport する

117</h3>117</h3>

118 118 

119`claude --teleport` で Web セッションをローカルターミナルにプルします。Teleport は、ブランチをフェッチしてセッション履歴を読み込む前に、同じ GHES リポジトリのチェックアウトにいることを確認します。詳細については、[teleport 要件](/ja/claude-code-on-the-web#teleport-requirements) を参照してください。119`claude --teleport` で Web セッションをローカルターミナルにプルします。Teleport は、ブランチをフェッチしてセッション履歴を読み込む前に、同じ GHES リポジトリのチェックアウトにいることを確認します。詳細については、[teleport 要件](/ja/claude-code-on-the-web#teleport-requirements) を参照してください。


205 GHES インスタンスに到達不可205 GHES インスタンスに到達不可

206</h3>206</h3>

207 207 

208レビューまたは Web セッションがタイムアウトする場合、GHES インスタンスは Anthropic インフラストラクチャから到達不可能な可能性があります。ファイアウォールが [Anthropic API IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses) からのインバウンド接続を許可していることを確認してください。208レビューまたは Web セッションがタイムアウトする場合、GHES インスタンスは Anthropic インフラストラクチャから到達不可能な可能性があります。ファイアウォールが [Anthropic API IP アドレス](https://platform.claude.com/docs/ja/api/ip-addresses) からのインバウンド接続を許可していることを確認してください。

209 209 

210<h2 id="related-resources">210<h2 id="related-resources">

211 関連リソース211 関連リソース

gitlab-ci-cd.md +85 −29

Details

16 この統合は [Claude Code CLI and Agent SDK](/ja/agent-sdk/overview) の上に構築されており、CI/CD ジョブとカスタム自動化ワークフローで Claude をプログラム的に使用できます。16 この統合は [Claude Code CLI and Agent SDK](/ja/agent-sdk/overview) の上に構築されており、CI/CD ジョブとカスタム自動化ワークフローで Claude をプログラム的に使用できます。

17</Note>17</Note>

18 18 

19## GitLab で Claude Code を使用する理由19<h2 id="why-use-claude-code-with-gitlab">

20 GitLab で Claude Code を使用する理由

21</h2>

20 22 

21* **インスタント MR 作成**: 必要なことを説明すると、Claude は変更と説明を含む完全な MR を提案します23* **インスタント MR 作成**: 必要なことを説明すると、Claude は変更と説明を含む完全な MR を提案します

22* **自動実装**: 単一のコマンドまたはメンションで issue を実行可能なコードに変換します24* **自動実装**: 単一のコマンドまたはメンションで issue を実行可能なコードに変換します


25* **エンタープライズ対応**: Claude API、Amazon Bedrock、または Google Vertex AI を選択して、データレジデンシーと調達のニーズを満たします27* **エンタープライズ対応**: Claude API、Amazon Bedrock、または Google Vertex AI を選択して、データレジデンシーと調達のニーズを満たします

26* **デフォルトでセキュア**: GitLab ランナーで実行され、ブランチ保護と承認が適用されます28* **デフォルトでセキュア**: GitLab ランナーで実行され、ブランチ保護と承認が適用されます

27 29 

28## 仕組み30<h2 id="how-it-works">

31 仕組み

32</h2>

29 33 

30Claude Code は GitLab CI/CD を使用して AI タスクを分離されたジョブで実行し、MR 経由で結果をコミットバックします。34Claude Code は GitLab CI/CD を使用して AI タスクを分離されたジョブで実行し、MR 経由で結果をコミットバックします。

31 35 


40 44 

41地域エンドポイントを選択して、既存のクラウド契約を使用しながらレイテンシーを削減し、データソブリンティ要件を満たします。45地域エンドポイントを選択して、既存のクラウド契約を使用しながらレイテンシーを削減し、データソブリンティ要件を満たします。

42 46 

43## Claude は何ができますか?47<h2 id="what-can-claude-do">

48 Claude は何ができますか?

49</h2>

44 50 

45Claude Code は、コードの操作方法を変える強力な CI/CD ワークフローを実現します。51Claude Code は、コードの操作方法を変える強力な CI/CD ワークフローを実現します。

46 52 


50* テストまたはコメントで特定されたバグと低下を修正します56* テストまたはコメントで特定されたバグと低下を修正します

51* フォローアップコメントに応答して、リクエストされた変更を反復処理します57* フォローアップコメントに応答して、リクエストされた変更を反復処理します

52 58 

53## セットアップ59<h2 id="setup">

60 セットアップ

61</h2>

54 62 

55### クイックセットアップ63<h3 id="quick-setup">

64 クイックセットアップ

65</h3>

56 66 

57最速で開始する方法は、`.gitlab-ci.yml` に最小限のジョブを追加し、API キーをマスクされた変数として設定することです。67最速で開始する方法は、`.gitlab-ci.yml` に最小限のジョブを追加し、API キーをマスクされた変数として設定することです。

58 68 


98ジョブと `ANTHROPIC_API_KEY` 変数を追加した後、**CI/CD** → **Pipelines** からジョブを手動で実行してテストするか、MR からトリガーして Claude が変更を提案し、必要に応じて MR を開くようにします。108ジョブと `ANTHROPIC_API_KEY` 変数を追加した後、**CI/CD** → **Pipelines** からジョブを手動で実行してテストするか、MR からトリガーして Claude が変更を提案し、必要に応じて MR を開くようにします。

99 109 

100<Note>110<Note>

101 Claude API の代わりに Amazon Bedrock または Google Vertex AI で実行するには、以下の [Using with Amazon Bedrock & Google Vertex AI](#using-with-amazon-bedrock--google-vertex-ai) セクションを参照して、認証と環境セットアップを確認してください。111 Claude API の代わりに Amazon Bedrock または Google Vertex AI で実行するには、以下の [Using with Amazon Bedrock & Google Vertex AI](#using-with-amazon-bedrock-%26-google-vertex-ai) セクションを参照して、認証と環境セットアップを確認してください。

102</Note>112</Note>

103 113 

104### 手動セットアップ(本番環境に推奨)114<h3 id="manual-setup-recommended-for-production">

115 手動セットアップ(本番環境に推奨)

116</h3>

105 117 

106より制御されたセットアップが必要な場合、またはエンタープライズプロバイダーが必要な場合:118より制御されたセットアップが必要な場合、またはエンタープライズプロバイダーが必要な場合:

107 119 


120 * プロジェクト webhook を「Comments(notes)」に追加して、イベントリスナーに追加します(使用する場合)132 * プロジェクト webhook を「Comments(notes)」に追加して、イベントリスナーに追加します(使用する場合)

121 * コメントに `@claude` が含まれている場合、リスナーがパイプライントリガー API を `AI_FLOW_INPUT` や `AI_FLOW_CONTEXT` などの変数で呼び出すようにします133 * コメントに `@claude` が含まれている場合、リスナーがパイプライントリガー API を `AI_FLOW_INPUT` や `AI_FLOW_CONTEXT` などの変数で呼び出すようにします

122 134 

123## 使用例135<h2 id="example-use-cases">

136 使用例

137</h2>

124 138 

125### issue を MR に変換する139<h3 id="turn-issues-into-mrs">

140 issue を MR に変換する

141</h3>

126 142 

127issue コメント内:143issue コメント内:

128 144 


132 148 

133Claude は issue とコードベースを分析し、ブランチに変更を書き込み、レビュー用に MR を開きます。149Claude は issue とコードベースを分析し、ブランチに変更を書き込み、レビュー用に MR を開きます。

134 150 

135### 実装ヘルプを取得する151<h3 id="get-implementation-help">

152 実装ヘルプを取得する

153</h3>

136 154 

137MR ディスカッション内:155MR ディスカッション内:

138 156 


142 160 

143Claude は変更を提案し、適切なキャッシングを使用してコードを追加し、MR を更新します。161Claude は変更を提案し、適切なキャッシングを使用してコードを追加し、MR を更新します。

144 162 

145### バグを素早く修正する163<h3 id="fix-bugs-quickly">

164 バグを素早く修正する

165</h3>

146 166 

147issue または MR コメント内:167issue または MR コメント内:

148 168 


152 172 

153Claude はバグを特定し、修正を実装し、ブランチを更新するか新しい MR を開きます。173Claude はバグを特定し、修正を実装し、ブランチを更新するか新しい MR を開きます。

154 174 

155## Amazon Bedrock & Google Vertex AI での使用175<h2 id="using-with-amazon-bedrock--google-vertex-ai">

176 Amazon Bedrock & Google Vertex AI での使用

177</h2>

156 178 

157エンタープライズ環境では、同じ開発者エクスペリエンスで Claude Code をクラウドインフラストラクチャ全体で実行できます。179エンタープライズ環境では、同じ開発者エクスペリエンスで Claude Code をクラウドインフラストラクチャ全体で実行できます。

158 180 


238 </Tab>260 </Tab>

239</Tabs>261</Tabs>

240 262 

241## 構成例263<h2 id="configuration-examples">

264 構成例

265</h2>

242 266 

243以下は、パイプラインに適応させることができる使用可能なスニペットです。267以下は、パイプラインに適応させることができる使用可能なスニペットです。

244 268 

245### 基本的な .gitlab-ci.yml(Claude API)269<h3 id="basic-gitlab-ci-yml-claude-api">

270 基本的な .gitlab-ci.yml(Claude API)

271</h3>

246 272 

247```yaml theme={null}273```yaml theme={null}

248stages:274stages:


271 # Claude Code は CI/CD 変数から ANTHROPIC_API_KEY を使用します297 # Claude Code は CI/CD 変数から ANTHROPIC_API_KEY を使用します

272```298```

273 299 

274### Amazon Bedrock ジョブの例(OIDC)300<h3 id="amazon-bedrock-job-example-oidc">

301 Amazon Bedrock ジョブの例(OIDC)

302</h3>

275 303 

276**前提条件:**304**前提条件:**

277 305 


322 Bedrock のモデル ID にはリージョン固有のプレフィックスが含まれます(例:`us.anthropic.claude-sonnet-4-6`)。ワークフローがサポートしている場合は、ジョブ構成またはプロンプト経由で目的のモデルを渡します。350 Bedrock のモデル ID にはリージョン固有のプレフィックスが含まれます(例:`us.anthropic.claude-sonnet-4-6`)。ワークフローがサポートしている場合は、ジョブ構成またはプロンプト経由で目的のモデルを渡します。

323</Note>351</Note>

324 352 

325### Google Vertex AI ジョブの例(Workload Identity Federation)353<h3 id="google-vertex-ai-job-example-workload-identity-federation">

354 Google Vertex AI ジョブの例(Workload Identity Federation)

355</h3>

326 356 

327**前提条件:**357**前提条件:**

328 358 


375 Workload Identity Federation では、サービスアカウントキーを保存する必要はありません。リポジトリ固有の信頼条件と最小権限サービスアカウントを使用します。405 Workload Identity Federation では、サービスアカウントキーを保存する必要はありません。リポジトリ固有の信頼条件と最小権限サービスアカウントを使用します。

376</Note>406</Note>

377 407 

378## ベストプラクティス408<h2 id="best-practices">

409 ベストプラクティス

410</h2>

379 411 

380### CLAUDE.md 構成412<h3 id="claude-md-configuration">

413 CLAUDE.md 構成

414</h3>

381 415 

382リポジトリルートに `CLAUDE.md` ファイルを作成して、コーディング標準、レビュー基準、およびプロジェクト固有のルールを定義します。Claude は実行中にこのファイルを読み取り、変更を提案する際にあなたの規約に従います。416リポジトリルートに `CLAUDE.md` ファイルを作成して、コーディング標準、レビュー基準、およびプロジェクト固有のルールを定義します。Claude は実行中にこのファイルを読み取り、変更を提案する際にあなたの規約に従います。

383 417 

384### セキュリティに関する考慮事項418<h3 id="security-considerations">

419 セキュリティに関する考慮事項

420</h3>

385 421 

386**API キーやクラウド認証情報をリポジトリにコミットしないでください**。常に GitLab CI/CD 変数を使用します。422**API キーやクラウド認証情報をリポジトリにコミットしないでください**。常に GitLab CI/CD 変数を使用します。

387 423 


390* ジョブ権限とネットワーク出力を制限します426* ジョブ権限とネットワーク出力を制限します

391* 他の貢献者と同じように Claude の MR をレビューします427* 他の貢献者と同じように Claude の MR をレビューします

392 428 

393### パフォーマンスの最適化429<h3 id="optimizing-performance">

430 パフォーマンスの最適化

431</h3>

394 432 

395* `CLAUDE.md` を焦点を絞った簡潔なものに保ちます433* `CLAUDE.md` を焦点を絞った簡潔なものに保ちます

396* issue/MR の説明を明確にして、反復を減らします434* issue/MR の説明を明確にして、反復を減らします

397* 実行不可能な実行を避けるために、適切なジョブタイムアウトを構成します435* 実行不可能な実行を避けるために、適切なジョブタイムアウトを構成します

398* ランナーで npm とパッケージのインストールをキャッシュします(可能な場合)436* ランナーで npm とパッケージのインストールをキャッシュします(可能な場合)

399 437 

400### CI コスト438<h3 id="ci-costs">

439 CI コスト

440</h3>

401 441 

402GitLab CI/CD で Claude Code を使用する場合、関連するコストに注意してください。442GitLab CI/CD で Claude Code を使用する場合、関連するコストに注意してください。

403 443 


415 * 適切な `max_turns` とジョブタイムアウト値を設定します455 * 適切な `max_turns` とジョブタイムアウト値を設定します

416 * 並列実行を制限して、並行実行を制御します456 * 並列実行を制限して、並行実行を制御します

417 457 

418## セキュリティとガバナンス458<h2 id="security-and-governance">

459 セキュリティとガバナンス

460</h2>

419 461 

420* 各ジョブは、ネットワークアクセスが制限された分離されたコンテナで実行されます462* 各ジョブは、ネットワークアクセスが制限された分離されたコンテナで実行されます

421* Claude の変更は MR を通じてフローするため、レビュアーはすべての diff を確認できます463* Claude の変更は MR を通じてフローするため、レビュアーはすべての diff を確認できます


423* Claude Code はワークスペーススコープの権限を使用して書き込みを制限します465* Claude Code はワークスペーススコープの権限を使用して書き込みを制限します

424* 独自のプロバイダー認証情報を持ち込むため、コストは制御下に置かれます466* 独自のプロバイダー認証情報を持ち込むため、コストは制御下に置かれます

425 467 

426## トラブルシューティング468<h2 id="troubleshooting">

469 トラブルシューティング

470</h2>

427 471 

428### Claude が @claude コマンドに応答しない472<h3 id="claude-not-responding-to-claude-commands">

473 Claude が @claude コマンドに応答しない

474</h3>

429 475 

430* パイプラインがトリガーされていることを確認します(手動、MR イベント、またはメモイベントリスナー/webhook 経由)476* パイプラインがトリガーされていることを確認します(手動、MR イベント、またはメモイベントリスナー/webhook 経由)

431* CI/CD 変数(`ANTHROPIC_API_KEY` またはクラウドプロバイダー設定)が存在し、マスク解除されていることを確認します477* CI/CD 変数(`ANTHROPIC_API_KEY` またはクラウドプロバイダー設定)が存在し、マスク解除されていることを確認します

432* コメントに `@claude`(`/claude` ではなく)が含まれており、メンショントリガーが構成されていることを確認します478* コメントに `@claude`(`/claude` ではなく)が含まれており、メンショントリガーが構成されていることを確認します

433 479 

434### ジョブがコメントを書き込めない、または MR を開けない480<h3 id="job-can’t-write-comments-or-open-mrs">

481 ジョブがコメントを書き込めない、または MR を開けない

482</h3>

435 483 

436* `CI_JOB_TOKEN` がプロジェクトに対して十分な権限を持っていることを確認するか、`api` スコープを持つ Project Access Token を使用します484* `CI_JOB_TOKEN` がプロジェクトに対して十分な権限を持っていることを確認するか、`api` スコープを持つ Project Access Token を使用します

437* `mcp__gitlab` ツールが `--allowedTools` で有効になっていることを確認します485* `mcp__gitlab` ツールが `--allowedTools` で有効になっていることを確認します

438* ジョブが MR のコンテキストで実行されているか、`AI_FLOW_*` 変数経由で十分なコンテキストを持っていることを確認します486* ジョブが MR のコンテキストで実行されているか、`AI_FLOW_*` 変数経由で十分なコンテキストを持っていることを確認します

439 487 

440### 認証エラー488<h3 id="authentication-errors">

489 認証エラー

490</h3>

441 491 

442* **Claude API の場合**: `ANTHROPIC_API_KEY` が有効で期限切れでないことを確認します492* **Claude API の場合**: `ANTHROPIC_API_KEY` が有効で期限切れでないことを確認します

443* **Bedrock/Vertex の場合**: OIDC/WIF 構成、ロール偽装、シークレット名を確認します。リージョンとモデルの可用性を確認します493* **Bedrock/Vertex の場合**: OIDC/WIF 構成、ロール偽装、シークレット名を確認します。リージョンとモデルの可用性を確認します

444 494 

445## 高度な構成495<h2 id="advanced-configuration">

496 高度な構成

497</h2>

446 498 

447### 一般的なパラメータと変数499<h3 id="common-parameters-and-variables">

500 一般的なパラメータと変数

501</h3>

448 502 

449Claude Code は以下の一般的に使用される入力をサポートしています。503Claude Code は以下の一般的に使用される入力をサポートしています。

450 504 


458 正確なフラグとパラメータは `@anthropic-ai/claude-code` のバージョンによって異なる場合があります。ジョブで `claude --help` を実行して、サポートされているオプションを確認してください。512 正確なフラグとパラメータは `@anthropic-ai/claude-code` のバージョンによって異なる場合があります。ジョブで `claude --help` を実行して、サポートされているオプションを確認してください。

459</Note>513</Note>

460 514 

461### Claude の動作をカスタマイズする515<h3 id="customizing-claude’s-behavior">

516 Claude の動作をカスタマイズする

517</h3>

462 518 

463Claude をガイドするには、主に 2 つの方法があります。519Claude をガイドするには、主に 2 つの方法があります。

464 520 

glossary.md +10 −10

Details

162 Effort level162 Effort level

163</h3>163</h3>

164 164 

165各ターンで Claude が適応的推論思考予算をどの程度使用するかを制御する設定。より高い努力はより多くの思考トークンとより深い推論を意味し、より低い努力はより速く、より安価です。Effort は Opus 4.6 以降、および Sonnet 4.6 でサポートされています。165各ターンで Claude が適応的推論思考予算をどの程度使用するかを制御する設定。より高い努力はより多くの思考トークンとより深い推論を意味し、より低い努力はより速く、より安価です。Effort は Fable 5、Opus 4.6 以降、および Sonnet 4.6 でサポートされています。

166 166 

167詳細情報: [Adjust effort level](/ja/model-config#adjust-effort-level)167詳細情報: [Adjust effort level](/ja/model-config#adjust-effort-level)

168 168 


170 Extended thinking170 Extended thinking

171</h3>171</h3>

172 172 

173モデルが応答する前に実行する可視的なステップバイステップの推論。`MAX_THINKING_TOKENS` で思考トークンをキャップするか、[effort level](#effort-level) を調整できます。思考はターミナルのグレーイタリックテキストで表示されます。173モデルが応答する前に実行する可視的なステップバイステップの推論。[effort level](#effort-level) で調整するか、固定思考予算を持つモデルで `MAX_THINKING_TOKENS` で思考トークンをキャップできます。思考はターミナルのグレーイタリックテキストで表示されます。

174 174 

175詳細情報: [Use extended thinking](/ja/model-config#extended-thinking)175詳細情報: [Use extended thinking](/ja/model-config#extended-thinking)

176 176 


254 254 

255セッションのベースライン承認動作。CLI で `Shift+Tab` でサイクルするか、VS Code、Desktop、claude.ai のモードセレクターを使用します。利用可能なモードは `default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions` です。255セッションのベースライン承認動作。CLI で `Shift+Tab` でサイクルするか、VS Code、Desktop、claude.ai のモードセレクターを使用します。利用可能なモードは `default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions` です。

256 256 

257詳細情報: [Choose a permission mode](/ja/permission-modes)257詳細情報: [Permission mode を選択する](/ja/permission-modes)

258 258 

259<h3 id="permission-rule">259<h3 id="permission-rule">

260 Permission rule260 Permission rule


262 262 

263ツール名と引数パターンに基づいてツール呼び出しを許可、質問、または拒否する設定エントリ。ルールは deny→ask→allow で評価され、最初にマッチしたものが優先されます。Permission rules は、より広い [permission mode](#permission-mode) の上に層状化された細粒度制御です。263ツール名と引数パターンに基づいてツール呼び出しを許可、質問、または拒否する設定エントリ。ルールは deny→ask→allow で評価され、最初にマッチしたものが優先されます。Permission rules は、より広い [permission mode](#permission-mode) の上に層状化された細粒度制御です。

264 264 

265詳細情報: [Configure permissions](/ja/permissions)265詳細情報: [権限を設定する](/ja/permissions)

266 266 

267<h3 id="plan-mode">267<h3 id="plan-mode">

268 Plan mode268 Plan mode


270 270 

271[permission mode](#permission-mode) の一種。Claude はソースファイルを編集せずに変更を研究および提案します。読み取り、検索、探索コマンドを実行でき、その後、何かに触れる前に承認用の計画を提示します。`/plan` を入力するか、`Shift+Tab` を押して plan mode に入ります。271[permission mode](#permission-mode) の一種。Claude はソースファイルを編集せずに変更を研究および提案します。読み取り、検索、探索コマンドを実行でき、その後、何かに触れる前に承認用の計画を提示します。`/plan` を入力するか、`Shift+Tab` を押して plan mode に入ります。

272 272 

273詳細情報: [Analyze before you edit with plan mode](/ja/permission-modes#analyze-before-you-edit-with-plan-mode)273詳細情報: [編集前に分析する(plan mode](/ja/permission-modes#analyze-before-you-edit-with-plan-mode)

274 274 

275<h3 id="plugin">275<h3 id="plugin">

276 Plugin276 Plugin


286 286 

287Claude Code がその設定をロードする前に、ディレクトリを受け入れるダイアログ。受け入れはプロジェクトディレクトリごとに保存されます。ただし、ホームディレクトリの場合は、信頼は現在のセッションのみ保持され、起動するたびにプロンプトが再度表示されます。Trust は marketplace プラグインの自動インストールとプロジェクト定義フックの実行をゲートします。ディレクトリを信頼することは、その `.claude/settings.json`、`.mcp.json`、および他の設定ファイルが有効になることを意味します。287Claude Code がその設定をロードする前に、ディレクトリを受け入れるダイアログ。受け入れはプロジェクトディレクトリごとに保存されます。ただし、ホームディレクトリの場合は、信頼は現在のセッションのみ保持され、起動するたびにプロンプトが再度表示されます。Trust は marketplace プラグインの自動インストールとプロジェクト定義フックの実行をゲートします。ディレクトリを信頼することは、その `.claude/settings.json`、`.mcp.json`、および他の設定ファイルが有効になることを意味します。

288 288 

289詳細情報: [The `.claude` directory](/ja/claude-directory)289詳細情報: [`.claude` ディレクトリ](/ja/claude-directory)

290 290 

291<h3 id="prompt-injection">291<h3 id="prompt-injection">

292 Prompt injection292 Prompt injection

293</h3>293</h3>

294 294 

295ファイル、ウェブページ、またはツール結果に埋め込まれた敵対的な指示。Claude を、あなたが決して求めなかったアクションにリダイレクトしようとします。Claude Code の防御には、権限システム、コマンドブロックリスト、信頼検証が含まれます。[Auto mode](#auto-mode) は、ツール結果の疑わしいコンテンツをスキャンするサーバー側プローブと、ツール結果を見ない分類器を追加します。そのため、注入されたテキストが承認決定に影響を与えることはできません。295ファイル、ウェブページ、またはツール結果に埋め込まれた敵対的な指示。Claude を、あなたが決して求めなかったアクションにリダイレクトしようとします。Claude Code の防御には、権限システム、コマンドインジェクション検出、信頼検証が含まれます。[Auto mode](#auto-mode) は、ツール結果の疑わしいコンテンツをスキャンするサーバー側プローブと、ツール結果を見ない分類器を追加します。そのため、注入されたテキストが承認決定に影響を与えることはできません。

296 296 

297詳細情報: [Protect against prompt injection](/ja/security#protect-against-prompt-injection)297詳細情報: [Prompt injection から保護する](/ja/security#protect-against-prompt-injection)

298 298 

299<h2 id="r">299<h2 id="r">

300 R300 R


410 410 

411セッションが作業が実際に完了したことを知る方法。テストスイート、ビルド、またはスクリーンショット比較など、Claude が実行できるチェックを提供します。Claude はチェックが成功するまで反復します。1 回の試行後に停止するのではなく。Verification loop は [`/goal`](/ja/goal)、無人実行、および [dynamic workflows](/ja/workflows) の前提条件です。それなしでは、エージェントが完了したことを決定する唯一のものはエージェント自体です。411セッションが作業が実際に完了したことを知る方法。テストスイート、ビルド、またはスクリーンショット比較など、Claude が実行できるチェックを提供します。Claude はチェックが成功するまで反復します。1 回の試行後に停止するのではなく。Verification loop は [`/goal`](/ja/goal)、無人実行、および [dynamic workflows](/ja/workflows) の前提条件です。それなしでは、エージェントが完了したことを決定する唯一のものはエージェント自体です。

412 412 

413詳細情報: [Give Claude a way to verify its work](/ja/best-practices#give-claude-a-way-to-verify-its-work)413詳細情報: [Claude に作業を検証する方法を提供する](/ja/best-practices#give-claude-a-way-to-verify-its-work)

414 414 

415<h2 id="w">415<h2 id="w">

416 W416 W


422 422 

423Claude を `.claude/worktrees/` の別の git worktree で実行する分離モード。`-w` フラグまたは subagent 設定の `isolation: worktree` で有効にされます。変更は別のブランチの別のディレクトリに留まるため、並列エージェントはお互いのファイルを上書きしません。423Claude を `.claude/worktrees/` の別の git worktree で実行する分離モード。`-w` フラグまたは subagent 設定の `isolation: worktree` で有効にされます。変更は別のブランチの別のディレクトリに留まるため、並列エージェントはお互いのファイルを上書きしません。

424 424 

425詳細情報: [Run parallel sessions with git worktrees](/ja/worktrees)425詳細情報: [git worktrees を使用した並列セッションの実行](/ja/worktrees)

426 426 

427***427***

428 428 

Details

6 6 

7> Google Vertex AI を通じた Claude Code の設定方法について学びます。セットアップ、IAM 設定、トラブルシューティングを含みます。7> Google Vertex AI を通じた Claude Code の設定方法について学びます。セットアップ、IAM 設定、トラブルシューティングを含みます。

8 8 

9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;

11 const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">

12 <line x1="5" y1="12" x2="19" y2="12" />

13 <polyline points="12 5 19 12 12 19" />

14 </svg>;

15 const STYLES = `

16.cc-cs {

17 --cs-slate: #141413;

18 --cs-clay: #d97757;

19 --cs-clay-deep: #c6613f;

20 --cs-gray-000: #ffffff;

21 --cs-gray-700: #3d3d3a;

22 --cs-border-default: rgba(31, 30, 29, 0.15);

23 font-family: inherit;

24}

25.dark .cc-cs {

26 --cs-slate: #f0eee6;

27 --cs-gray-000: #262624;

28 --cs-gray-700: #bfbdb4;

29 --cs-border-default: rgba(240, 238, 230, 0.14);

30}

31.cc-cs-card {

32 display: flex; align-items: center; justify-content: space-between;

33 gap: 16px; padding: 14px 16px; margin: 0;

34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);

35 border-radius: 8px; flex-wrap: wrap;

36}

37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }

38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }

39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }

40.cc-cs-btn-clay {

41 display: inline-flex; align-items: center; gap: 8px;

42 background: var(--cs-clay-deep); color: #fff; border: none;

43 border-radius: 8px; padding: 8px 14px;

44 font-size: 13px; font-weight: 500;

45 transition: background-color 0.15s; white-space: nowrap;

46}

47.cc-cs-btn-clay:hover { background: var(--cs-clay); }

48.cc-cs-btn-ghost {

49 display: inline-flex; align-items: center; gap: 8px;

50 background: transparent; color: var(--cs-gray-700);

51 border: 0.5px solid var(--cs-border-default);

52 border-radius: 8px; padding: 8px 14px;

53 font-size: 13px; font-weight: 500;

54}

55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }

56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }

57@media (max-width: 720px) {

58 .cc-cs-actions { width: 100%; }

59}

60`;

61 return <div className="cc-cs not-prose">

62 <style>{STYLES}</style>

63 <div className="cc-cs-card">

64 <div className="cc-cs-text">

65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.

66 </div>

67 <div className="cc-cs-actions">

68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">

69 View plans

70 </a>

71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">

72 Contact sales {iconArrowRight()}

73 </a>

74 </div>

75 </div>

76 </div>;

77};

78 

79<ContactSalesCard surface="vertex" />

80 

9<h2 id="prerequisites">81<h2 id="prerequisites">

10 前提条件82 前提条件

11</h2>83</h2>


18* Google Cloud SDK(`gcloud`)がインストールされ、設定されていること90* Google Cloud SDK(`gcloud`)がインストールされ、設定されていること

19* 目的の GCP リージョンに割り当てられたクォータ91* 目的の GCP リージョンに割り当てられたクォータ

20 92 

21Vertex AI 認証情報で サインインするには、以下の[Vertex AI でサインイン](#sign-in-with-vertex-ai)に従ってください。チーム全体に Claude Code をデプロイするには、[手動セットアップ](#set-up-manually)の手順を使用し、ロールアウト前に[モデルバージョンをピン留めして](#5-pin-model-versions)ください。93Vertex AI 認証情報でサインインするには、以下の[Vertex AI でサインイン](#sign-in-with-vertex-ai)に従ってください。チーム全体に Claude Code をデプロイするには、[手動セットアップ](#set-up-manually)の手順を使用し、ロールアウト前に[モデルバージョンをピン留めして](#5-pin-model-versions)ください。

22 94 

23<h2 id="sign-in-with-vertex-ai">95<h2 id="sign-in-with-vertex-ai">

24 Vertex AI でサインイン96 Vertex AI でサインイン


155</h3>227</h3>

156 228 

157<Warning>229<Warning>

158 複数のユーザーにデプロイする場合は、特定のモデルバージョンをピン留めしてください。ピン留めなしでは、`sonnet` および `opus` などのモデルエイリアスは最新バージョンに解決されます。これは、Anthropic がアップデートをリリースしたときに Vertex AI プロジェクトでまだ有効になっていない可能性があります。Claude Code は、最新が利用できない場合、起動時に[前のバージョンにフォールバック](#startup-model-checks)しますが、ピン留めすることで、ユーザーが新しいモデルに移行するタイミングを制御できます。230 複数のユーザーにデプロイする場合は、特定のモデルバージョンをピン留めしてください。ピン留めなしでは、`sonnet` および `opus` などのモデルエイリアスは Claude Code の Vertex AI 用の組み込みデフォルトに解決され、最新リリースより遅れる可能性があり、プロジェクトでまだ有効になっていない可能性があります。Claude Code は、デフォルトが利用できない場合、起動時に[前のバージョンにフォールバック](#startup-model-checks)しますが、ピン留めすることで、ユーザーが新しいモデルに移行するタイミングを制御できます。

159</Warning>231</Warning>

160 232 

161これらの環境変数を特定の Vertex AI モデル ID に設定します。233これらの環境変数を特定の Vertex AI モデル ID に設定します。

headless.md +11 −3

Details

62 `--bare` はスクリプトおよび SDK 呼び出しの推奨モードであり、将来のリリースで `-p` のデフォルトになります。62 `--bare` はスクリプトおよび SDK 呼び出しの推奨モードであり、将来のリリースで `-p` のデフォルトになります。

63</Note>63</Note>

64 64 

65<h3 id="background-tasks-at-exit">

66 終了時のバックグラウンドタスク

67</h3>

68 

69Claude が `claude -p` 実行中に [バックグラウンド Bash タスク](/ja/tools-reference#bash-tool-behavior) を開始する場合(例えば、開発サーバーまたはウォッチビルド)、そのタスクは Claude が最終結果を返し、stdin が閉じられてから約 5 秒後に終了します。猶予期間により、結果の直後に終了するタスクでも出力を配信できます。v2.1.163 より前では、終了しないバックグラウンドプロセスは `claude -p` 呼び出しを無期限に開いたままにしていました。

70 

65<h2 id="examples">71<h2 id="examples">

6672

67</h2>73</h2>


177`system/init` イベントは、モデル、ツール、MCP サーバー、および読み込まれたプラグインを含むセッションメタデータを報告します。[`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ja/env-vars) が設定されていない限り、ストリームの最初のイベントです。その場合、`plugin_install` イベントがそれより前にあります。プラグインフィールドを使用して、プラグインが読み込まれなかった場合に CI を失敗させます。183`system/init` イベントは、モデル、ツール、MCP サーバー、および読み込まれたプラグインを含むセッションメタデータを報告します。[`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ja/env-vars) が設定されていない限り、ストリームの最初のイベントです。その場合、`plugin_install` イベントがそれより前にあります。プラグインフィールドを使用して、プラグインが読み込まれなかった場合に CI を失敗させます。

178 184 

179| フィールド | 型 | 説明 |185| フィールド | 型 | 説明 |

180| --------------- | -- | ---------------------------------------------------------------------------------------------------------------------------------- |186| --------------- | -- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

181| `plugins` | 配列 | 正常に読み込まれたプラグイン。各プラグインは `name` と `path` を持ちます |187| `plugins` | 配列 | 正常に読み込まれたプラグイン。各プラグインは `name` と `path` を持ちます |

182| `plugin_errors` | 配列 | 満たされていない依存関係バージョンなどのプラグイン読み込み時エラー。各エラーは `plugin`、`type`、および `message` を持ちます。影響を受けたプラグインは降格され、`plugins` から削除されます。エラーがない場合、キーは省略されます |188| `plugin_errors` | 配列 | プラグイン読み込み時エラー。各エラーは `plugin`、`type`、および `message` を持ちます。満たされていない依存関係バージョンおよび `--plugin-dir` 読み込み失敗(パスの欠落または無効なアーカイブなど)が含まれます。影響を受けたプラグインは降格され、`plugins` から削除されます。エラーがない場合、キーは省略されます |

183 189 

184[`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ja/env-vars) が設定されている場合、Claude Code は最初のターンの前にマーケットプレイスプラグインがインストールされている間、`system/plugin_install` イベントを発行します。これらを使用して、独自の UI にインストール進行状況を表示します。190[`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ja/env-vars) が設定されている場合、Claude Code は最初のターンの前にマーケットプレイスプラグインがインストールされている間、`system/plugin_install` イベントを発行します。これらを使用して、独自の UI にインストール進行状況を表示します。

185 191 


226`--allowedTools` フラグは [パーミッションルール構文](/ja/settings#permission-rule-syntax) を使用します。末尾の ` *` はプレフィックスマッチングを有効にするため、`Bash(git diff *)` は `git diff` で始まるすべてのコマンドを許可します。スペースは重要です。スペースがない場合、`Bash(git diff*)` は `git diff-index` にも一致します。232`--allowedTools` フラグは [パーミッションルール構文](/ja/settings#permission-rule-syntax) を使用します。末尾の ` *` はプレフィックスマッチングを有効にするため、`Bash(git diff *)` は `git diff` で始まるすべてのコマンドを許可します。スペースは重要です。スペースがない場合、`Bash(git diff*)` は `git diff-index` にも一致します。

227 233 

228<Note>234<Note>

229 ユーザーが呼び出した [skills](/ja/skills)`/code-review` など)および [組み込みコマンド](/ja/commands) 対話モードでのみ利用可能です。`-p` モードでは、代わりに実行したいタスクを説明してください235 ユーザーが呼び出した [skills](/ja/skills) およびカスタムコマンドは `-p` モードで機能します。プロンプト文字列に `/skill-name` を含めると、Claude Code は実行前にそれを展開します。`/config` や `/login` などの対話ダイアログを開く組み込みコマンドは、`-p` モードでは利用できません

230</Note>236</Note>

231 237 

232<h3 id="customize-the-system-prompt">238<h3 id="customize-the-system-prompt">


265claude -p "Continue that review" --resume "$session_id"271claude -p "Continue that review" --resume "$session_id"

266```272```

267 273 

274同じディレクトリから両方のコマンドを実行します。セッション ID ルックアップは現在のプロジェクトディレクトリとその git worktrees にスコープされます。完全なスコープルールについては、[セッションを再開する](/ja/sessions#resume-a-session) を参照してください。

275 

268<h2 id="next-steps">276<h2 id="next-steps">

269 次のステップ277 次のステップ

270</h2>278</h2>

hooks.md +53 −19

Details

174フックを定義する場所によって、そのスコープが決まります。174フックを定義する場所によって、そのスコープが決まります。

175 175 

176| 位置 | スコープ | 共有可能 |176| 位置 | スコープ | 共有可能 |

177| :-------------------------------------------------- | :--------------- | :----------------- |177| :-------------------------------------------------- | :--------------- | :---------------------------------- |

178| `~/.claude/settings.json` | すべてのプロジェクト | いいえ、マシンにローカル |178| `~/.claude/settings.json` | すべてのプロジェクト | いいえ、マシンにローカル |

179| `.claude/settings.json` | 単一プロジェクト | はい、リポジトリにコミット可能 |179| `.claude/settings.json` | 単一プロジェクト | はい、リポジトリにコミット可能 |

180| `.claude/settings.local.json` | 単一プロジェクト | いいえ、gitignored |180| `.claude/settings.local.json` | 単一プロジェクト | いいえ、Claude Code が作成するときに gitignored |

181| 管理ポリシー設定 | 組織全体 | はい、管理者が制御 |181| 管理ポリシー設定 | 組織全体 | はい、管理者が制御 |

182| [プラグイン](/ja/plugins) `hooks/hooks.json` | プラグインが有効な場合 | はい、プラグインにバンドル |182| [プラグイン](/ja/plugins) `hooks/hooks.json` | プラグインが有効な場合 | はい、プラグインにバンドル |

183| [スキル](/ja/skills)または[エージェント](/ja/sub-agents)フロントマター | コンポーネントがアクティブな場合 | はい、コンポーネント ファイルで定義 |183| [スキル](/ja/skills)または[エージェント](/ja/sub-agents)フロントマター | コンポーネントがアクティブな場合 | はい、コンポーネント ファイルで定義 |


311これらのフィールドはすべてのフック タイプに適用されます。311これらのフィールドはすべてのフック タイプに適用されます。

312 312 

313| フィールド | 必須 | 説明 |313| フィールド | 必須 | 説明 |

314| :-------------- | :-- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |314| :-------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

315| `type` | はい | `"command"`、`"http"`、`"mcp_tool"`、`"prompt"`、または `"agent"` |315| `type` | はい | `"command"`、`"http"`、`"mcp_tool"`、`"prompt"`、または `"agent"` |

316| `if` | いいえ | `"Bash(git *)"` または `"Edit(*.ts)"` などの権限ルール構文を使用してこのフックが実行されるタイミングをフィルタリングします。ツール呼び出しがパターンにマッチする場合のみ、フックが生成されますまたは Bash コマンドが解析するには複雑すぎる場合。ツール イベントでのみ評価されます。`PreToolUse`、`PostToolUse`、`PostToolUseFailure`、`PermissionRequest`、`PermissionDenied`。他のイベントでは、`if` が設定されたフックは実行されません。[権限ルール](/ja/permissions)と同じ構文を使用します |316| `if` | いいえ | `"Bash(git *)"` または `"Edit(*.ts)"` などの権限ルール構文を使用してこのフックが実行されるタイミングをフィルタリングします。ツール呼び出しがパターンにマッチする場合のみ、フック コマンドが実行されます[Bash マッチング テーブル](#bash-if-matching)を参照して、Bash パターンがサブコマンド、`$()`、バッククォートに対してどのように評価されるかを確認してください。ツール イベントでのみ評価されます。`PreToolUse`、`PostToolUse`、`PostToolUseFailure`、`PermissionRequest`、`PermissionDenied`。他のイベントでは、`if` が設定されたフックは実行されません。[権限ルール](/ja/permissions)と同じ構文を使用します |

317| `timeout` | いいえ | キャンセルまでの秒数。デフォルト: `command`、`http`、`mcp_tool` は 600、`prompt` は 30、`agent` は 60。[`UserPromptSubmit`](#userpromptsubmit) は `command`、`http`、`mcp_tool` のデフォルトを 30 に低下させ、[`MessageDisplay`](#messagedisplay) はそれを 10 に低下させます |317| `timeout` | いいえ | キャンセルまでの秒数。デフォルト: `command`、`http`、`mcp_tool` は 600、`prompt` は 30、`agent` は 60。[`UserPromptSubmit`](#userpromptsubmit) は `command`、`http`、`mcp_tool` のデフォルトを 30 に低下させ、[`MessageDisplay`](#messagedisplay) はそれを 10 に低下させます |

318| `statusMessage` | いいえ | フックの実行中に表示されるカスタム スピナー メッセージ |318| `statusMessage` | いいえ | フックの実行中に表示されるカスタム スピナー メッセージ |

319| `once` | いいえ | `true` の場合、セッションごとに 1 回だけ実行してから削除されます。[スキル フロントマター](#hooks-in-skills-and-agents)でのみ尊重されます。設定ファイルとエージェント フロントマターでは無視されます |319| `once` | いいえ | `true` の場合、セッションごとに 1 回だけ実行してから削除されます。[スキル フロントマター](#hooks-in-skills-and-agents)でのみ尊重されます。設定ファイルとエージェント フロントマターでは無視されます |

320 320 

321`if` フィールドは正確に 1 つの権限ルールを保持します。ルールを組み合わせるための `&&`、`||`、またはリスト構文はありません。複数の条件を適用するには、各条件に対して個別のフック ハンドラーを定義します。Bash の場合、ルールは先頭の `VAR=value` 割り当てが削除された後のツール入力の各サブコマンドに対してマッチされるため、`if: "Bash(git push *)"` は `FOO=bar git push` と `npm test && git push` の両方にマッチします。コマンドが解析するには複雑すぎる場合、いずれかのサブコマンドがマッチすると、またはいつでもフックが実行されます。321`if` フィールドは正確に 1 つの権限ルールを保持します。ルールを組み合わせるための `&&`、`||`、またはリスト構文はありません。複数の条件を適用するには、各条件に対して個別のフック ハンドラーを定義します。

322 

323<span id="bash-if-matching" />Bash パターンの場合、フック コマンドが実行されるかどうかは、パターンの形状と Claude が呼び出している Bash コマンドに依存します。先頭の `VAR=value` 割り当ては、マッチング前に削除されます。

324 

325| `if` パターン | Bash コマンド | フックが実行されるか | 理由 |

326| :----------------- | :--------------------- | :--------- | :-------------------------------------------------------- |

327| `Bash(git *)` | `FOO=bar git push` | はい | 先頭の割り当ては削除されます。`git push` がマッチします |

328| `Bash(git *)` | `npm test && git push` | はい | 各サブコマンドがチェックされます。`git push` がマッチします |

329| `Bash(rm *)` | `echo $(rm -rf /)` | はい | `$()` とバッククォート内のコマンドがチェックされます。`rm -rf /` がマッチします |

330| `Bash(rm *)` | `echo $(date)` | いいえ | サブコマンドが `rm *` にマッチしません |

331| `Bash(git push *)` | `echo $(date)` | はい | コマンド名以上を指定するパターンは、`$()`、バッククォート、または `$VAR` でとにかくフックを実行します |

332 

333フィルターは、Bash コマンドを解析できない場合、パターンに関係なくフックを実行して、オープンに失敗します。`if` フィルターはベストエフォートであるため、ハードな許可または拒否を強制するには、フックではなく[権限システム](/ja/permissions)を使用してください。

322 334 

323<h4 id="command-hook-fields">335<h4 id="command-hook-fields">

324 コマンド フック フィールド336 コマンド フック フィールド


461[共通フィールド](#common-fields)に加えて、プロンプト フックとエージェント フックはこれらのフィールドを受け入れます。473[共通フィールド](#common-fields)に加えて、プロンプト フックとエージェント フックはこれらのフィールドを受け入れます。

462 474 

463| フィールド | 必須 | 説明 |475| フィールド | 必須 | 説明 |

464| :------- | :-- | :------------------------------------------------------------- |476| :------- | :-- | :----------------------------------------------------------------------------------------------------------------------------- |

465| `prompt` | はい | モデルに送信するプロンプト テキスト。フック入力 JSON のプレースホルダーとして `$ARGUMENTS` を使用します |477| `prompt` | はい | モデルに送信するプロンプト テキスト。フック入力 JSON のプレースホルダーとして `$ARGUMENTS` を使用します。バックスラッシュでエスケープしてリテラル テキストを含めます。`\$1.00` は `$1.00` としてレンダリングされます |

466| `model` | いいえ | 評価に使用するモデル。デフォルトは高速モデル |478| `model` | いいえ | 評価に使用するモデル。デフォルトは高速モデル |

467 479 

468すべてのマッチング フックは並列で実行され、同一のハンドラーは自動的に重複排除されます。コマンド フックはコマンド文字列と `args` で重複排除され、HTTP フックは URL で重複排除されます。ハンドラーは Claude Code の環境を持つ現在のディレクトリで実行されます。`$CLAUDE_CODE_REMOTE` 環境変数はリモート Web 環境で `"true"` に設定され、ローカル CLI では設定されません。480すべてのマッチング フックは並列で実行され、同一のハンドラーは自動的に重複排除されます。コマンド フックはコマンド文字列と `args` で重複排除され、HTTP フックは URL で重複排除されます。ハンドラーは Claude Code の環境を持つ現在のディレクトリで実行されます。`$CLAUDE_CODE_REMOTE` 環境変数はリモート Web 環境で `"true"` に設定され、ローカル CLI では設定されません。


782# Notification フック: Claude Code が注意を必要とするときにデスクトップに ping を送信します。794# Notification フック: Claude Code が注意を必要とするときにデスクトップに ping を送信します。

783input=$(cat)795input=$(cat)

784title="Claude Code'796title="Claude Code'

785body=$(jq -r '.message // 'Needs your attention'' <<<"$input")797body=$(jq -r '.message // 'Needs your attention'' <<<'$input")

786seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")798seq=$(printf '\033]777;notify;%s;%s\007' "$title" "$body")

787jq -nc --arg seq "$seq" '{terminalSequence: $seq}'799jq -nc --arg seq "$seq" '{terminalSequence: $seq}'

788```800```


815* [SessionStart](#sessionstart)、[Setup](#setup)、および [SubagentStart](#subagentstart): 会話の開始時、最初のプロンプトの前827* [SessionStart](#sessionstart)、[Setup](#setup)、および [SubagentStart](#subagentstart): 会話の開始時、最初のプロンプトの前

816* [UserPromptSubmit](#userpromptsubmit) および [UserPromptExpansion](#userpromptexpansion): 送信されたプロンプトの横828* [UserPromptSubmit](#userpromptsubmit) および [UserPromptExpansion](#userpromptexpansion): 送信されたプロンプトの横

817* [PreToolUse](#pretooluse)、[PostToolUse](#posttooluse)、[PostToolUseFailure](#posttoolusefailure)、および [PostToolBatch](#posttoolbatch): ツール結果の横829* [PreToolUse](#pretooluse)、[PostToolUse](#posttooluse)、[PostToolUseFailure](#posttoolusefailure)、および [PostToolBatch](#posttoolbatch): ツール結果の横

830* [Stop](#stop) および [SubagentStop](#subagentstop): ターンの終了時。会話は続行されるため、Claude はフィードバックに対応できます。[Stop 決定制御](#stop-decision-control)を参照してください

818 831 

819複数のフックが同じイベントに対して `additionalContext` を返す場合、Claude はすべての値を受け取ります。値が 10,000 文字を超える場合、Claude Code はセッション ディレクトリ内のファイルに完全なテキストを書き込み、短いプレビューとファイル パスを Claude に渡します。832複数のフックが同じイベントに対して `additionalContext` を返す場合、Claude はすべての値を受け取ります。値が 10,000 文字を超える場合、Claude Code はセッション ディレクトリ内のファイルに完全なテキストを書き込み、短いプレビューとファイル パスを Claude に渡します。

820 833 


838 851 

839| イベント | 決定パターン | キー フィールド |852| イベント | 決定パターン | キー フィールド |

840| :-------------------------------------------------------------------------------------------------------------------------- | :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |853| :-------------------------------------------------------------------------------------------------------------------------- | :------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

841| UserPromptSubmit、UserPromptExpansion、PostToolUse、PostToolUseFailure、PostToolBatch、Stop、SubagentStop、ConfigChange、PreCompact | トップレベル `decision` | `decision: "block"`、`reason` |854| UserPromptSubmit、UserPromptExpansion、PostToolUse、PostToolUseFailure、PostToolBatch、Stop、SubagentStop、ConfigChange、PreCompact | トップレベル `decision` | `decision: "block"`、`reason`。Stop と SubagentStop は[会話を続行する非エラー フィードバック](#stop-decision-control)のために `hookSpecificOutput.additionalContext` も受け入れます |

842| TeammateIdle、TaskCreated、TaskCompleted | 終了コードまたは `continue: false` | 終了コード 2 はアクションをブロックし、stderr フィードバックを使用します。JSON `{"continue": false, "stopReason": "..."}` はチームメイト全体を停止し、`Stop` フック動作と一致します |855| TeammateIdle、TaskCreated、TaskCompleted | 終了コードまたは `continue: false` | 終了コード 2 はアクションをブロックし、stderr フィードバックを使用します。JSON `{"continue": false, "stopReason": "..."}` はチームメイト全体を停止し、`Stop` フック動作と一致します |

843| PreToolUse | `hookSpecificOutput` | `permissionDecision`(allow/deny/ask/defer)、`permissionDecisionReason` |856| PreToolUse | `hookSpecificOutput` | `permissionDecision`(allow/deny/ask/defer)、`permissionDecisionReason` |

844| PermissionRequest | `hookSpecificOutput` | `decision.behavior`(allow/deny) |857| PermissionRequest | `hookSpecificOutput` | `decision.behavior`(allow/deny) |


926 SessionStart 入力939 SessionStart 入力

927</h4>940</h4>

928 941 

929[共通入力フィールド](#common-input-fields)に加えて、SessionStart フックは `source`、`model`、およびオプションで `agent_type` と `session_title` を受け取ります。`source` フィールドはセッションがどのように開始されたかを示します。新しいセッションの場合は `"startup"`、再開されたセッションの場合は `"resume"`、`/clear` の後は `"clear"`、コンパクション後は `"compact"`。`model` フィールドはモデル識別子を含みます。`claude --agent <name>` で Claude Code を開始する場合、`agent_type` フィールドはエージェント名を含みます。`session_title` フィールドは、例えば `--name` または `/rename` 経由で既に設定されている場合、現在のセッション タイトルを含みます。`sessionTitle` を発行するフックは、ユーザーが明示的に設定したタイトルを上書きしないように、最初に `session_title` をチェックできます。942[共通入力フィールド](#common-input-fields)に加えて、SessionStart フックは `source`、`model`、およびオプションで `agent_type` と `session_title` を受け取ります。`source` フィールドはセッションがどのように開始されたかを示します。新しいセッションの場合は `"startup"`、再開されたセッションの場合は `"resume"`、`/clear` の後は `"clear"`、コンパクション後は `"compact"`。`model` フィールドはモデル識別子を含みます。例えば `/clear` の後、またはセッションが会話復旧を通じて復元されるときなど、フィールドが省略される可能性があるため、読み取る前にフィールドをチェックしてください。`claude --agent <name>` で Claude Code を開始する場合、`agent_type` フィールドはエージェント名を含みます。`session_title` フィールドは、例えば `--name` または `/rename` 経由で既に設定されている場合、現在のセッション タイトルを含みます。`sessionTitle` を発行するフックは、ユーザーが明示的に設定したタイトルを上書きしないように、最初に `session_title` をチェックできます。

930 943 

931```json theme={null}944```json theme={null}

932{945{


1240 1253 

1241アシスタント メッセージが画面にストリーミングされている間に実行されます。Claude Code はメッセージを増分で表示します。新しく完了した行のバッチがレンダリング準備ができるたびに、フックはそれらの行で 1 回実行され、Claude Code はフックの置換テキストをその場所にレンダリングします。長いメッセージは複数の呼び出しを生成します。短いメッセージは 1 つだけ生成する可能性があります。1254アシスタント メッセージが画面にストリーミングされている間に実行されます。Claude Code はメッセージを増分で表示します。新しく完了した行のバッチがレンダリング準備ができるたびに、フックはそれらの行で 1 回実行され、Claude Code はフックの置換テキストをその場所にレンダリングします。長いメッセージは複数の呼び出しを生成します。短いメッセージは 1 つだけ生成する可能性があります。

1242 1255 

1243MessageDisplay を使用して Claude の応答を画面に表示されるときに再フォーマット、編集、または圧縮します1256MessageDisplay を使用して以下を実行します

1257 

1258* マークダウンを削除して最小限の表示にする

1259* エージェント SDK アプリケーションがユーザーに表示するテキストを変換する

1260* Claude の応答から API キーまたは内部ホスト名を編集する

1244 1261 

1245Claude Code は各バッチをフックが返されるまで保持するため、フックを高速に保ちます。フックが失敗またはタイムアウトした場合、Claude Code は元のテキストを表示します。このイベントのデフォルト タイムアウトは 10 秒です。フックにより多くの時間が必要な場合は、フック エントリで `timeout` フィールドを設定します。1262Claude Code は各バッチをフックが返されるまで保持するため、フックを高速に保ちます。フックが失敗またはタイムアウトした場合、Claude Code は元のテキストを表示します。このイベントのデフォルト タイムアウトは 10 秒です。フックにより多くの時間が必要な場合は、フック エントリで `timeout` フィールドを設定します。

1246 1263 


1502| `status` | 文字列 | `"completed"` | 同期呼び出しの場合は `"completed"`、`run_in_background: true` の場合は `"async_launched"` |1519| `status` | 文字列 | `"completed"` | 同期呼び出しの場合は `"completed"`、`run_in_background: true` の場合は `"async_launched"` |

1503| `agentId` | 文字列 | `"a4d2c8f1e0b3a297"` | サブエージェント実行の識別子 |1520| `agentId` | 文字列 | `"a4d2c8f1e0b3a297"` | サブエージェント実行の識別子 |

1504| `content` | 配列 | `[{"type": "text", "text": "Found 12 endpoints..."}]` | サブエージェントの最終テキスト ブロック |1521| `content` | 配列 | `[{"type": "text", "text": "Found 12 endpoints..."}]` | サブエージェントの最終テキスト ブロック |

1522| `resolvedModel` | 文字列 | `"claude-sonnet-4-5"` | サブエージェントが実行されたモデル。要求されたモデルと異なる可能性があります。{/* min-version: 2.1.174 */}Claude Code v2.1.174 以降が必要 |

1505| `totalTokens` | 数値 | `12450` | サブエージェントのターン全体で請求されたトークン合計 |1523| `totalTokens` | 数値 | `12450` | サブエージェントのターン全体で請求されたトークン合計 |

1506| `totalDurationMs` | 数値 | `48211` | サブエージェント実行の実時間 |1524| `totalDurationMs` | 数値 | `48211` | サブエージェント実行の実時間 |

1507| `totalToolUseCount` | 数値 | `7` | サブエージェントが行ったツール呼び出しの数 |1525| `totalToolUseCount` | 数値 | `7` | サブエージェントが行ったツール呼び出しの数 |

1508| `usage` | オブジェクト | `{"input_tokens": 8320, ...}` | タイプ別トークン分解: `input_tokens`、`output_tokens`、`cache_creation_input_tokens`、`cache_read_input_tokens` |1526| `usage` | オブジェクト | `{"input_tokens": 8320, ...}` | タイプ別トークン分解: `input_tokens`、`output_tokens`、`cache_creation_input_tokens`、`cache_read_input_tokens` |

1509 1527 

1510`run_in_background: true` 呼び出しの場合、ツールはサブエージェント起動後すぐに返されるため、`tool_response` は使用フィールドを含みません。`status: "async_launched"`、`agentId`、`description`、`prompt`、`outputFile` を含みます。1528`run_in_background: true` 呼び出しの場合、ツールはサブエージェント起動後すぐに返されるため、`tool_response` は使用フィールドを含みません。`status: "async_launched"`、`agentId`、`description`、`prompt`、`outputFile`、`resolvedModel` を含みます。

1529 

1530`resolvedModel` フィールドはサブエージェントが実行されたモデルを名前付けし、`tool_input` の `model` 値と異なる可能性があります。Claude Code v2.1.174 以降が必要です。

1531 

1532<a id="askuserquestion" />

1511 1533 

1512<h5 id="askuserquestion">1534<h5 id="askuserquestion">

1513 AskUserQuestion1535 AskUserQuestion


2019 SubagentStart2041 SubagentStart

2020</h3>2042</h3>

2021 2043 

2022Agent ツール経由でサブエージェントが生成されるときに実行されます。エージェント タイプ名でフィルタリングするマッチャーをサポート(`general-purpose`、`Explore`、`Plan` などの組み込みエージェント、または[カスタム サブエージェント](/ja/sub-agents)の場合はエージェントのフロントマターの `name` フィールド。ファイル名ではありません)2044Agent ツール経由でサブエージェントが生成されるときに実行されます。エージェント タイプ名でフィルタリングするマッチャーをサポート。組み込みエージェントの場合、これはエージェント名(`general-purpose`、`Explore`、`Plan` など)です。[カスタム サブエージェント](/ja/sub-agents)の場合、これはファイル名ではなく、エージェントのフロントマターの `name` フィールドです

2023 2045 

2024<h4 id="subagentstart-input">2046<h4 id="subagentstart-input">

2025 SubagentStart 入力2047 SubagentStart 入力


2084}2106}

2085```2107```

2086 2108 

2087SubagentStop フックは[Stop フック](#stop-decision-control)と同じ決定制御形式を使用します。`additionalContext` をサポートしません。`decision: "block"` を `reason` と一緒に返すとサブエージェントを実行し続け、`reason` をサブエージェントの次の命令として配信します。サブエージェントが戻った後に親セッションにコンテキストを注入するには、代わりに `Agent` ツール上の [`PostToolUse`](#posttooluse)フックを使用します。2109SubagentStop フックは[Stop フック](#stop-decision-control)と同じ決定制御形式を使用します。`hookSpecificOutput.additionalContext` を含む `hookEventName` を `"SubagentStop"` に設定して、非エラー フィードバックをサポートします会話は続行されるため、Claude が対応できます。ただし、`decision: "block"` とは異なり、トランスクリプトでは「Stop フック フィードバック」としてラベル付けされ、フック エラー通知は表示されません。`decision: "block"` を `reason` と一緒に返すとサブエージェントを実行し続け、`reason` をサブエージェントの次の命令として配信します。サブエージェントが戻った後に親セッションにコンテキストを注入するには、代わりに `Agent` ツール上の [`PostToolUse`](#posttooluse)フックを使用します。

2088 2110 

2089<h3 id="taskcreated">2111<h3 id="taskcreated">

2090 TaskCreated2112 TaskCreated


2111 "task_subject": "Implement user authentication",2133 "task_subject": "Implement user authentication",

2112 "task_description": "Add login and signup endpoints",2134 "task_description": "Add login and signup endpoints",

2113 "teammate_name": "implementer",2135 "teammate_name": "implementer",

2114 "team_name": "my-project"2136 "team_name": "session-a1b2c3d4"

2115}2137}

2116```2138```

2117 2139 


2172 "task_subject": "Implement user authentication",2194 "task_subject": "Implement user authentication",

2173 "task_description": "Add login and signup endpoints",2195 "task_description": "Add login and signup endpoints",

2174 "teammate_name": "implementer",2196 "teammate_name": "implementer",

2175 "team_name": "my-project"2197 "team_name": "session-a1b2c3d4"

2176}2198}

2177```2199```

2178 2200 


2288`Stop` と `SubagentStop` フックは Claude が続行するかどうかを制御できます。すべてのフックで利用可能な[JSON 出力フィールド](#json-output)に加えて、フック スクリプトはこれらのイベント固有のフィールドを返すことができます。2310`Stop` と `SubagentStop` フックは Claude が続行するかどうかを制御できます。すべてのフックで利用可能な[JSON 出力フィールド](#json-output)に加えて、フック スクリプトはこれらのイベント固有のフィールドを返すことができます。

2289 2311 

2290| フィールド | 説明 |2312| フィールド | 説明 |

2291| :--------- | :------------------------------------------------ |2313| :------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |

2292| `decision` | `"block"` は Claude が停止するのを防止。Claude を停止させるには省略 |2314| `decision` | `"block"` は Claude が停止するのを防止。Claude を停止させるには省略 |

2293| `reason` | `decision` が `"block"` のときに必須。Claude が続行すべき理由を伝える |2315| `reason` | `decision` が `"block"` のときに必須。Claude が続行すべき理由を伝える |

2316| `hookSpecificOutput.additionalContext` | 非エラー フィードバック Claude 用。会話は続行されるため Claude が対応できますが、`decision: "block"` とは異なり、トランスクリプトでは「Stop フック フィードバック」としてラベル付けされ、フック エラー通知は表示されません |

2294 2317 

2295```json theme={null}2318```json theme={null}

2296{2319{


2299}2322}

2300```2323```

2301 2324 

2325`additionalContext` を使用する場合、フックが設計通りに機能し、Claude にガイダンスを提供しています。例えば、「完了する前にテスト スイートを実行してください」。会話は `stop_hook_active` 入力と 8 回連続継続キャップと同じループ保護を通じて続行されます。

2326 

2327```json theme={null}

2328{

2329 "hookSpecificOutput": {

2330 "hookEventName": "Stop",

2331 "additionalContext": "Please run the test suite before finishing"

2332 }

2333}

2334```

2335 

2302<h3 id="stopfailure">2336<h3 id="stopfailure">

2303 StopFailure2337 StopFailure

2304</h3>2338</h3>


2353 "permission_mode": "default",2387 "permission_mode": "default",

2354 "hook_event_name": "TeammateIdle",2388 "hook_event_name": "TeammateIdle",

2355 "teammate_name": "researcher",2389 "teammate_name": "researcher",

2356 "team_name": "my-project"2390 "team_name": "session-a1b2c3d4"

2357}2391}

2358```2392```

2359 2393 


2684 PostCompact2718 PostCompact

2685</h3>2719</h3>

2686 2720 

2687Claude Code がコンパ クション操作を完了した後に実行されます。このイベントを使用して、新しいコンパクト状態に反応します。例えば、生成されたサマリーをログしたり、外部状態を更新したりします。2721Claude Code がコンパクション操作を完了した後に実行されます。このイベントを使用して、新しいコンパクト状態に反応します。例えば、生成されたサマリーをログしたり、外部状態を更新したりします。

2688 2722 

2689`PreCompact` と同じマッチャー値が適用されます。2723`PreCompact` と同じマッチャー値が適用されます。

2690 2724 

hooks-guide.md +15 −3

Details

506 506 

507複数の hooks が同じイベントにマッチする場合、すべての hook のコマンドが完了してから Claude Code は結果をマージします。1 つの hook が `deny` を返しても、兄弟 hooks の実行は停止されません。1 つの hook の `deny` が別の hook の副作用を抑制することに依存しないでください。507複数の hooks が同じイベントにマッチする場合、すべての hook のコマンドが完了してから Claude Code は結果をマージします。1 つの hook が `deny` を返しても、兄弟 hooks の実行は停止されません。1 つの hook の `deny` が別の hook の副作用を抑制することに依存しないでください。

508 508 

509すべてのマッチングする hooks が完了した後、Claude Code はそれらの出力を組み合わせます。`PreToolUse` 許可決定については、最も制限的な答えが勝ちます`deny``ask` をオーバーライドし、`ask``allow` をオーバーライドします。`additionalContext` からのテキストはすべての hook から保持され、Claude に一緒に渡されます。509すべてのマッチングする hooks が完了した後、Claude Code はそれらの出力を組み合わせます。`PreToolUse` 許可決定については、最も制限的な答えが勝ちます。順序は `deny``defer`、`ask``allow` です。`additionalContext` からのテキストはすべての hook から保持され、Claude に一緒に渡されます。

510 510 

511以下の例は `Bash` に 2 つの `PreToolUse` hooks を登録しています。最初のものはすべてのコマンドをログファイルに追加して 0 で終了します。2 番目のものはスクリプトを実行し、コマンドに `rm -rf` が含まれている場合は 2 で終了して拒否します:511以下の例は `Bash` に 2 つの `PreToolUse` hooks を登録しています。最初のものはすべてのコマンドをログファイルに追加して 0 で終了します。2 番目のものはスクリプトを実行し、コマンドに `rm -rf` が含まれている場合は 2 で終了して拒否します:

512 512 


774}774}

775```775```

776 776 

777Hook プロセスは Bash コマンドが `git *` にマッチするときにのみ生成されます。または、コマンドが解析するには複雑すぎるときです。`npm test && git push` のような複合コマンドの場合、Claude Code は各サブコマンドを評価し、`git push` がマッチするため hook を発火させます。`if` フィールドは許可ルールと同じパターンを受け入れます:`"Bash(git *)"`、`"Edit(*.ts)"` など。複数のツール名をマッチさせるには、それぞれ独自の `if` 値を持つ別のハンドラーを使用するか、パイプ交替がサポートされている `matcher` レベルでマッチします。777Hook コマンドが実行されるかどうかは、`if` パターンの形状と Claude が呼び出している Bash コマンドによって異なります:

778 

779| `if` パターン | Bash コマンド | Hook は実行されるか? | 理由 |

780| :----------------- | :--------------------- | :------------ | :------------------------------------------------------- |

781| `Bash(git *)` | `git push` | はい | コマンド名がマッチします |

782| `Bash(git *)` | `npm test && git push` | はい | 各サブコマンドがチェックされます。`git push` がマッチします |

783| `Bash(git *)` | `echo $(git log)` | はい | `$()` とバッククォート内のコマンドがチェックされます。`git log` がマッチします |

784| `Bash(git *)` | `echo $(date)` | いいえ | サブコマンドが `git *` にマッチしません |

785| `Bash(git push *)` | `echo $(date)` | はい | コマンド名以上を指定するパターンは、`$()`、バッククォート、または `$VAR` で hook を実行します |

786 

787フィルターは失敗時にオープンで実行され、Bash コマンドを解析できない場合は hook を実行します。フィルターはベストエフォートであるため、ハード allow または deny を強制するには、hook ではなく [許可システム](/ja/permissions) を使用してください。

788 

789`if` フィールドは許可ルールと同じパターンを受け入れます:`"Bash(git *)"`、`"Edit(*.ts)"` など。複数のツール名をマッチさせるには、それぞれ独自の `if` 値を持つ別のハンドラーを使用するか、パイプ交替がサポートされている `matcher` レベルでマッチします。

778 790 

779`if` はツールイベントでのみ機能します:`PreToolUse`、`PostToolUse`、`PostToolUseFailure`、`PermissionRequest`、および `PermissionDenied`。他のイベントに追加すると、hook が実行されるのを防ぎます。791`if` はツールイベントでのみ機能します:`PreToolUse`、`PostToolUse`、`PostToolUseFailure`、`PermissionRequest`、および `PermissionDenied`。他のイベントに追加すると、hook が実行されるのを防ぎます。

780 792 


793| [Plugin](/ja/plugins) `hooks/hooks.json` | プラグインが有効なとき | はい、プラグインにバンドル |805| [Plugin](/ja/plugins) `hooks/hooks.json` | プラグインが有効なとき | はい、プラグインにバンドル |

794| [Skill](/ja/skills) または [agent](/ja/sub-agents) frontmatter | スキルまたはエージェントがアクティブなとき | はい、コンポーネントファイルで定義 |806| [Skill](/ja/skills) または [agent](/ja/sub-agents) frontmatter | スキルまたはエージェントがアクティブなとき | はい、コンポーネントファイルで定義 |

795 807 

796Claude Code で [`/hooks`](/ja/hooks#the-hooks-menu) を実行して、イベント別にグループ化されたすべての設定済み hooks を参照します。すべての hooks を一度に無効にするには、設定ファイルで `"disableAllHooks": true` を設定します。管理設定で設定された Hooks は、`disableAllHooks` がそこにも設定されていない限り、実行されます。808Claude Code で [`/hooks`](/ja/hooks#the-%2Fhooks-menu) を実行して、イベント別にグループ化されたすべての設定済み hooks を参照します。すべての hooks を一度に無効にするには、設定ファイルで `"disableAllHooks": true` を設定します。管理設定で設定された Hooks は、`disableAllHooks` がそこにも設定されていない限り、実行されます。

797 809 

798Claude Code が実行中に設定ファイルを直接編集する場合、ファイルウォッチャーは通常、hook の変更を自動的に取得します。810Claude Code が実行中に設定ファイルを直接編集する場合、ファイルウォッチャーは通常、hook の変更を自動的に取得します。

799 811 

Details

207 207 

208Claude Code はそれの使用方法を教えることができます。「フックをセットアップするにはどうすればいいですか?」や「CLAUDE.md を構造化する最良の方法は何ですか?」などの質問をすると、Claude が説明します。208Claude Code はそれの使用方法を教えることができます。「フックをセットアップするにはどうすればいいですか?」や「CLAUDE.md を構造化する最良の方法は何ですか?」などの質問をすると、Claude が説明します。

209 209 

210組み込みコマンドもセットアップをガイドします210組み込みコマンドもセットアップをガイドします

211 211 

212* `/init` はプロジェクト用の CLAUDE.md を作成するプロセスをウォークスルーします212* `/init` はプロジェクト用の CLAUDE.md を作成するプロセスをウォークスルーします

213* `/agents` はカスタム subagent を設定するのに役立ちます213* `/agents` はカスタム subagent を設定するのに役立ちます

214* `/doctor` はインストールの一般的な問題を診断します214* `/doctor` はインストールの一般的な問題を診断します

215 215 

216<h3 id="it-s-a-conversation">216<h3 id="its-a-conversation">

217 会話です217 会話です

218</h3>218</h3>

219 219 


237 中断して操舵する237 中断して操舵する

238</h4>238</h4>

239 239 

240任意の時点で Claude をリダイレクトできます。ターンが終了するのを待つか、最初からやり直す必要はありません240任意の時点で Claude をリダイレクトできます。ターンが終了するのを待つか、最初からやり直す必要はありません

241 241 

242* **`Esc` を押す** と Claude が直ちに停止します。実行中のツール呼び出しがキャンセルされ、Claude は次の指示を待ちます。242* **`Esc` を押す** と Claude が直ちに停止します。実行中のツール呼び出しがキャンセルされ、Claude は次の指示を待ちます。

243* **修正を入力して `Enter` を押す** と、実行中のツールを停止せずに送信できます。Claude は現在のアクションが完了するとすぐにそれを読み、次のステップを決定する前に調整します。243* **修正を入力して `Enter` を押す** と、実行中のツールを停止せずに送信できます。Claude は現在のアクションが完了するとすぐにそれを読み、次のステップを決定する前に調整します。


282 282 

283プランを確認し、会話を通じて改善し、Claude に実装させます。このフェーズアプローチは、コードに直接ジャンプするよりも良い結果を生成します。283プランを確認し、会話を通じて改善し、Claude に実装させます。このフェーズアプローチは、コードに直接ジャンプするよりも良い結果を生成します。

284 284 

285<h3 id="delegate-don-t-dictate">285<h3 id="delegate-dont-dictate">

286 指示するのではなく委譲する286 指示するのではなく委譲する

287</h3>287</h3>

288 288 


295 295 

296どのファイルを読むか、どのコマンドを実行するかを指定する必要はありません。Claude がそれを理解します。296どのファイルを読むか、どのコマンドを実行するかを指定する必要はありません。Claude がそれを理解します。

297 297 

298<h2 id="what-s-next">298<h2 id="whats-next">

299 次のステップ299 次のステップ

300</h2>300</h2>

301 301 

Details

39| `Ctrl+B` | バックグラウンドで実行中のタスク | bash コマンドとエージェントをバックグラウンドで実行します。Tmux ユーザーは 2 回押す |39| `Ctrl+B` | バックグラウンドで実行中のタスク | bash コマンドとエージェントをバックグラウンドで実行します。Tmux ユーザーは 2 回押す |

40| `Ctrl+T` | タスクリストを切り替え | ターミナルステータス領域の [タスクリスト](#task-list) を表示または非表示 |40| `Ctrl+T` | タスクリストを切り替え | ターミナルステータス領域の [タスクリスト](#task-list) を表示または非表示 |

41| `Left/Right 矢印` | ダイアログタブを循環 | 権限ダイアログとメニューのタブ間を移動 |41| `Left/Right 矢印` | ダイアログタブを循環 | 権限ダイアログとメニューのタブ間を移動 |

42| `Up/Down 矢印` または `Ctrl+P`/`Ctrl+N` | カーソルを移動またはコマンド履歴を移動 | 複数行入力では、最初にカーソルをプロンプト内で移動します。カーソルが既に上端または下端にある場合、もう一度押すとコマンド履歴を移動します |42| `Up/Down 矢印` または `Ctrl+P`/`Ctrl+N` | カーソルを移動またはコマンド履歴を移動 | 複数行入力では、最初にカーソルをプロンプト内で移動します。カーソルが既に上端または下端にある場合、もう一度押すとコマンド履歴を移動します。{/* min-version: 2.1.169 */}v2.1.169 以降、折り返された単一行入力は複数行入力と同じように動作します |

43| `Esc` | Claude を割り込み | 現在の応答またはツール呼び出しを途中で停止して、リダイレクトできます。Claude はこれまでの作業を保持します |43| `Esc` | Claude を割り込み | 現在の応答またはツール呼び出しを途中で停止して、リダイレクトできます。Claude はこれまでの作業を保持します |

44| `Esc` + `Esc` | 入力ドラフトをクリア、または巻き戻し | プロンプト入力にテキストが含まれている場合、ダブル `Esc` でクリアし、ドラフトを履歴に保存して `Up` で呼び出せます。入力が空の場合、ダブル `Esc` で [巻き戻しメニュー](/ja/checkpointing) を開き、前の時点からコードと会話を復元または要約できます |44| `Esc` + `Esc` | 入力ドラフトをクリア、または巻き戻し | プロンプト入力にテキストが含まれている場合、ダブル `Esc` でクリアし、ドラフトを履歴に保存して `Up` で呼び出せます。入力が空の場合、ダブル `Esc` で [巻き戻しメニュー](/ja/checkpointing) を開き、前の時点からコードと会話を復元または要約できます |

45| `Shift+Tab` または `Alt+M`(一部の設定) | 権限モードを切り替え | `default`、`acceptEdits`、`plan`、および `auto` や `bypassPermissions` などの有効にしたモード間を循環します。[権限モード](/ja/permission-modes) を参照してください。 |45| `Shift+Tab` または `Alt+M`(一部の設定) | 権限モードを切り替え | `default`、`acceptEdits`、`plan`、および `auto` や `bypassPermissions` などの有効にしたモード間を循環します。[権限モード](/ja/permission-modes) を参照してください。 |

46| `Option+P`(macOS)または `Alt+P`(Windows/Linux) | モデルを切り替え | プロンプトをクリアせずにモデルを切り替え |46| `Option+P`(macOS)または `Alt+P`(Windows/Linux) | モデルを切り替え | プロンプトをクリアせずにモデルを切り替え |

47| `Option+T`(macOS)または `Alt+T`(Windows/Linux) | 拡張思考を切り替え | 拡張思考モードを有効または無効にします。{/* min-version: 2.1.132 */}v2.1.132 以降、このショートカットは macOS で Option を Meta として設定しなくても機能します |47| `Option+T`(macOS)または `Alt+T`(Windows/Linux) | 拡張思考を切り替え | 拡張思考モードを有効または無効にします。Fable 5 には効果がなく、常に拡張思考を使用します。{/* min-version: 2.1.132 */}v2.1.132 以降、このショートカットは macOS で Option を Meta として設定しなくても機能します |

48| `Option+O`(macOS)または `Alt+O`(Windows/Linux) | 高速モードを切り替え | [高速モード](/ja/fast-mode) を有効または無効にします |48| `Option+O`(macOS)または `Alt+O`(Windows/Linux) | 高速モードを切り替え | [高速モード](/ja/fast-mode) を有効または無効にします |

49 49 

50<h3 id="text-editing">50<h3 id="text-editing">


305* 長時間実行プロセス(docker、terraform)305* 長時間実行プロセス(docker、terraform)

306 306 

307<h3 id="shell-mode-with-prefix">307<h3 id="shell-mode-with-prefix">

308 `!` プレフィックス付き Bash モード308 `!` プレフィックス付き Shell モード

309</h3>309</h3>

310 310 

311入力に `!` をプレフィックスして、Claude を経由せずに bash コマンドを直接実行します:311入力に `!` をプレフィックスして、Claude を経由せずに bash コマンドを直接実行します:


316! ls -la316! ls -la

317```317```

318 318 

319Bash モード:319Shell モード:

320 320 

321* コマンドとその出力を会話コンテキストに追加321* コマンドとその出力を会話コンテキストに追加

322* リアルタイムの進捗と出力を表示322* リアルタイムの進捗と出力を表示


324* Claude がコマンドを解釈または承認する必要がない324* Claude がコマンドを解釈または承認する必要がない

325* 履歴ベースのオートコンプリートをサポート:部分的なコマンドを入力し、**Tab** を押して現在のプロジェクトの前の `!` コマンドから完成させる325* 履歴ベースのオートコンプリートをサポート:部分的なコマンドを入力し、**Tab** を押して現在のプロジェクトの前の `!` コマンドから完成させる

326* `Escape`、`Backspace`、または空のプロンプトで `Ctrl+U` で終了326* `Escape`、`Backspace`、または空のプロンプトで `Ctrl+U` で終了

327* 空のプロンプトに `!` で始まるテキストを貼り付けると、入力された `!` の動作と一致して、自動的に bash モードに入ります327* 空のプロンプトに `!` で始まるテキストを貼り付けると、入力された `!` の動作と一致して、自動的に shell モードに入ります

328 328 

329これは会話コンテキストを保持しながら、クイックシェル操作に便利です。329これは会話コンテキストを保持しながら、クイックシェル操作に便利です。

330 330 


372| :----------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |372| :----------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- |

373| `Space`、`Enter`、`Escape` | 回答を却下してプロンプトに戻ります |373| `Space`、`Enter`、`Escape` | 回答を却下してプロンプトに戻ります |

374| `Up` / `Down` | 回答をスクロールします |374| `Up` / `Down` | 回答をスクロールします |

375| `c` | 回答をクリップボードに生の Markdown としてコピーします。マウス選択の代わりにこれを使用してください。マウス選択はハードラップされたターミナルレンダリングをキャプチャするのではなく、ソーステキストをキャプチャします |

375| `f` | 新しいセッションにフォークします。フォークは親会話にこの質問と回答を実際のトランスクリプトターンとして継承するため、完全なツールアクセスで続行できます。元のセッションは [`/resume`](/ja/commands) の下に保持されます。ローカルセッションでのみ利用可能 |376| `f` | 新しいセッションにフォークします。フォークは親会話にこの質問と回答を実際のトランスクリプトターンとして継承するため、完全なツールアクセスで続行できます。元のセッションは [`/resume`](/ja/commands) の下に保持されます。ローカルセッションでのみ利用可能 |

376| `x` | 現在の回答の上に表示されている以前の `/btw` 交換のリストをクリアします |377| `x` | 現在の回答の上に表示されている以前の `/btw` 交換のリストをクリアします |

377 378 

jetbrains.md +76 −24

Details

8 8 

9Claude Code は専用プラグインを通じて JetBrains IDEs と統合され、インタラクティブな diff ビューイング、選択コンテキスト共有など、様々な機能を提供します。9Claude Code は専用プラグインを通じて JetBrains IDEs と統合され、インタラクティブな diff ビューイング、選択コンテキスト共有など、様々な機能を提供します。

10 10 

11## サポートされている IDE11<h2 id="supported-ides">

12 サポートされている IDE

13</h2>

12 14 

13Claude Code プラグインは、以下を含むほとんどの JetBrains IDEs で動作します。15Claude Code プラグインは、以下を含むほとんどの JetBrains IDEs で動作します。

14 16 


19* PhpStorm21* PhpStorm

20* GoLand22* GoLand

21 23 

22## 機能24<h2 id="features">

25 機能

26</h2>

23 27 

24* **クイック起動**: `Cmd+Esc`(Mac)または `Ctrl+Esc`(Windows/Linux)を使用してエディタから Claude Code を直接開くか、UI の Claude Code ボタンをクリックします28* **クイック起動**: `Cmd+Esc`(Mac)または `Ctrl+Esc`(Windows/Linux)を使用してエディタから Claude Code を直接開くか、UI の Claude Code ボタンをクリックします

25* **Diff ビューイング**: コードの変更をターミナルではなく IDE の diff ビューアに直接表示できます29* **Diff ビューイング**: コードの変更をターミナルではなく IDE の diff ビューアに直接表示できます


27* **ファイル参照ショートカット**: `Cmd+Option+K`(Mac)または `Alt+Ctrl+K`(Linux/Windows)を使用して `@src/auth.ts#L1-99` などのファイル参照を挿入します31* **ファイル参照ショートカット**: `Cmd+Option+K`(Mac)または `Alt+Ctrl+K`(Linux/Windows)を使用して `@src/auth.ts#L1-99` などのファイル参照を挿入します

28* **診断共有**: IDE からの診断エラー(lint、構文エラーなど)が作業中に Claude と自動的に共有されます32* **診断共有**: IDE からの診断エラー(lint、構文エラーなど)が作業中に Claude と自動的に共有されます

29 33 

30## インストール34<h2 id="installation">

35 インストール

36</h2>

31 37 

32### マーケットプレイスからのインストール38プラグインは IDE の統合ターミナルで `claude` コマンドを実行し、それに接続します。独自の CLI コピーをバンドルしていないため、両方をインストールする必要があります。

33 39 

34JetBrains マーケットプレイスから [Claude Code プラグイン](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) を見つけてインストールし、IDE を再起動します。40<Steps>

41 <Step title="Claude Code CLI をインストールする">

42 まだインストールしていない場合は、[クイックスタート](/ja/quickstart) に従って CLI をインストールしてください。`claude` が PATH にない場合、プラグインは'Claude Code を起動できません'という通知を表示します。

43 </Step>

44 

45 <Step title="JetBrains プラグインをインストールする">

46 JetBrains マーケットプレイスから [Claude Code プラグイン](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) をインストールし、IDE を再起動します。

47 </Step>

48</Steps>

49 

50`claude` が IDE が見つけられない場所にインストールされている場合は、プラグインの [Claude コマンド設定](#general-settings) でフルパスを設定してください。

35 51 

36Claude Code をまだインストールしていない場合は、[クイックスタートガイド](/ja/quickstart) でインストール手順を確認してください52Claude Code 任意の有料 Claude サブスクリプション(Pro、Max、Team、または Enterprise)または Claude Console アカウントで動作し、API キーは不要です。`claude` を初めて実行するときに [ログイン](/ja/authentication#log-in-to-claude-code) するよう求められます

37 53 

38<Note>54<Note>

39 プラグインをインストール後、IDE を完全に再起動する必要がある場合があります。55 プラグインをインストール後、IDE を完全に再起動する必要がある場合があります。

40</Note>56</Note>

41 57 

42## 使用方法58<h2 id="usage">

59 使用方法

60</h2>

43 61 

44### IDE から62<h3 id="from-your-ide">

63 IDE から

64</h3>

45 65 

46IDE の統合ターミナルから `claude` を実行すると、すべての統合機能がアクティブになります。66IDE の統合ターミナルから `claude` を実行すると、すべての統合機能がアクティブになります。

47 67 

48### 外部ターミナルから68<h3 id="from-external-terminals">

69 外部ターミナルから

70</h3>

49 71 

50任意の外部ターミナルで `/ide` コマンドを使用して Claude Code を JetBrains IDE に接続し、すべての機能をアクティブにします。72任意の外部ターミナルで `/ide` コマンドを使用して Claude Code を JetBrains IDE に接続し、すべての機能をアクティブにします。

51 73 


59 81 

60Claude が IDE と同じファイルにアクセスできるようにしたい場合は、IDE プロジェクトルートと同じディレクトリから Claude Code を起動してください。82Claude が IDE と同じファイルにアクセスできるようにしたい場合は、IDE プロジェクトルートと同じディレクトリから Claude Code を起動してください。

61 83 

62## 設定84<h2 id="configuration">

85 設定

86</h2>

63 87 

64### Claude Code 設定88<h3 id="claude-code-settings">

89 Claude Code 設定

90</h3>

65 91 

66Claude Code の設定を通じて IDE 統合を設定します。92Claude Code の設定を通じて IDE 統合を設定します。

67 93 


692. `/config` コマンドを入力します952. `/config` コマンドを入力します

703. diff ツールを `auto` に設定して IDE に diff を表示するか、`terminal` に設定してターミナルに表示したままにします963. diff ツールを `auto` に設定して IDE に diff を表示するか、`terminal` に設定してターミナルに表示したままにします

71 97 

72### プラグイン設定98<h3 id="plugin-settings">

99 プラグイン設定

100</h3>

73 101 

74**Settings → Tools → Claude Code \[Beta]** に移動して Claude Code プラグインを設定します。102**Settings → Tools → Claude Code \[Beta]** に移動して Claude Code プラグインを設定します。

75 103 

76#### 一般設定104<h4 id="general-settings">

105 一般設定

106</h4>

77 107 

78* **Claude command**: Claude を実行するカスタムコマンドを指定します(例:`claude`、`/usr/local/bin/claude`、または `npx @anthropic-ai/claude-code`)108* **Claude command**: Claude を実行するカスタムコマンドを指定します(例:`claude`、`/usr/local/bin/claude`、または `npx @anthropic-ai/claude-code`)

79* **Suppress notification for Claude command not found**: Claude コマンドが見つからないことに関する通知をスキップします109* **Suppress notification for Claude command not found**: Claude コマンドが見つからないことに関する通知をスキップします


84 WSL ユーザー向け: Claude コマンドとして `wsl -d Ubuntu -- bash -lic "claude"` を設定します(`Ubuntu` を WSL ディストリビューション名に置き換えてください)114 WSL ユーザー向け: Claude コマンドとして `wsl -d Ubuntu -- bash -lic "claude"` を設定します(`Ubuntu` を WSL ディストリビューション名に置き換えてください)

85</Tip>115</Tip>

86 116 

87#### ESC キー設定117<h4 id="esc-key-configuration">

118 ESC キー設定

119</h4>

88 120 

89ESC キーが JetBrains ターミナルで Claude Code 操作を中断しない場合:121ESC キーが JetBrains ターミナルで Claude Code 操作を中断しない場合:

90 122 


96 128 

97これにより、ESC キーが Claude Code 操作を適切に中断できるようになります。129これにより、ESC キーが Claude Code 操作を適切に中断できるようになります。

98 130 

99## 特別な設定131<h2 id="special-configurations">

132 特別な設定

133</h2>

100 134 

101### リモート開発135<h3 id="remote-development">

136 リモート開発

137</h3>

102 138 

103<Warning>139<Warning>

104 JetBrains リモート開発を使用する場合、**Settings → Plugin (Host)** を通じてリモートホストにプラグインをインストールする必要があります。140 JetBrains リモート開発を使用する場合、**Settings → Plugin (Host)** を通じてリモートホストにプラグインをインストールする必要があります。


106 142 

107プラグインはローカルクライアントマシンではなく、リモートホストにインストールする必要があります。143プラグインはローカルクライアントマシンではなく、リモートホストにインストールする必要があります。

108 144 

109### WSL 設定145<h3 id="wsl-configuration">

146 WSL 設定

147</h3>

110 148 

111Claude Code を WSL2 の JetBrains IDE で使用していて「No available IDEs detected」が表示される場合、原因は通常 WSL2 の NAT ネットワークまたは Windows ファイアウォールが WSL2 と Windows ホストで実行されている IDE 間の接続をブロックしていることです。WSL1 はホストのネットワークを直接使用するため、影響を受けません。149Claude Code を WSL2 の JetBrains IDE で使用していて「No available IDEs detected」が表示される場合、原因は通常 WSL2 の NAT ネットワークまたは Windows ファイアウォールが WSL2 と Windows ホストで実行されている IDE 間の接続をブロックしていることです。WSL1 はホストのネットワークを直接使用するため、影響を受けません。

112 150 

113#### Windows ファイアウォール経由で WSL2 トラフィックを許可する151<h4 id="allow-wsl2-traffic-through-windows-firewall">

152 Windows ファイアウォール経由で WSL2 トラフィックを許可する

153</h4>

114 154 

115これは推奨される修正方法です。既存の WSL2 ネットワークモードを保持するためです。155これは推奨される修正方法です。既存の WSL2 ネットワークモードを保持するためです。

116 156 


138 </Step>178 </Step>

139</Steps>179</Steps>

140 180 

141#### WSL2 をミラーリングネットワークに切り替える181<h4 id="switch-wsl2-to-mirrored-networking">

182 WSL2 をミラーリングネットワークに切り替える

183</h4>

142 184 

143ミラーリングネットワークには Windows 11 22H2 以降が必要です。Windows 10 を使用している場合は、代わりに上記のファイアウォールルールを使用してください。185ミラーリングネットワークには Windows 11 22H2 以降が必要です。Windows 10 を使用している場合は、代わりに上記のファイアウォールルールを使用してください。

144 186 


151 193 

152その後、PowerShell から `wsl --shutdown` で WSL を再起動します。194その後、PowerShell から `wsl --shutdown` で WSL を再起動します。

153 195 

154## トラブルシューティング196<h2 id="troubleshooting">

197 トラブルシューティング

198</h2>

155 199 

156### プラグインが動作しない200<h3 id="plugin-not-working">

201 プラグインが動作しない

202</h3>

157 203 

158プラグインがインストールされているが Claude Code 機能が IDE に表示されない場合:204プラグインがインストールされているが Claude Code 機能が IDE に表示されない場合:

159 205 


162* IDE を完全に再起動してください(複数回実行する必要がある場合があります)208* IDE を完全に再起動してください(複数回実行する必要がある場合があります)

163* リモート開発の場合、プラグインがリモートホストにインストールされていることを確認してください209* リモート開発の場合、プラグインがリモートホストにインストールされていることを確認してください

164 210 

165### IDE が検出されない211<h3 id="ide-not-detected">

212 IDE が検出されない

213</h3>

166 214 

167`claude` を実行して「No available IDEs detected」が表示される場合:215`claude` を実行して「No available IDEs detected」が表示される場合:

168 216 


171* 統合ターミナルから Claude Code を実行していることを確認してください219* 統合ターミナルから Claude Code を実行していることを確認してください

172* WSL ユーザーの場合、上記の [WSL 設定](#wsl-configuration) を参照してください220* WSL ユーザーの場合、上記の [WSL 設定](#wsl-configuration) を参照してください

173 221 

174### コマンドが見つからない222<h3 id="command-not-found">

223 コマンドが見つからない

224</h3>

175 225 

176Claude アイコンをクリックして「command not found」が表示される場合:226Claude アイコンをクリックして「command not found」が表示される場合:

177 227 


1792. プラグイン設定で Claude コマンドパスを設定してください2292. プラグイン設定で Claude コマンドパスを設定してください

1803. WSL ユーザーの場合、設定セクションで説明されている WSL コマンド形式を使用してください2303. WSL ユーザーの場合、設定セクションで説明されている WSL コマンド形式を使用してください

181 231 

182## セキュリティに関する考慮事項232<h2 id="security-considerations">

233 セキュリティに関する考慮事項

234</h2>

183 235 

184Claude Code が自動編集権限が有効な JetBrains IDE で実行される場合、IDE によって自動的に実行される可能性のある IDE 設定ファイルを変更できる場合があります。これにより、自動編集モードで Claude Code を実行するリスクが増加し、bash 実行に対する Claude Code の権限プロンプトをバイパスできる可能性があります。236Claude Code が自動編集権限が有効な JetBrains IDE で実行される場合、IDE によって自動的に実行される可能性のある IDE 設定ファイルを変更できる場合があります。これにより、自動編集モードで Claude Code を実行するリスクが増加し、bash 実行に対する Claude Code の権限プロンプトをバイパスできる可能性があります。

185 237 

keybindings.md +5 −5

Details

112`Chat` コンテキストで利用可能なアクション:112`Chat` コンテキストで利用可能なアクション:

113 113 

114| アクション | デフォルト | 説明 |114| アクション | デフォルト | 説明 |

115| :-------------------- | :----------------------- | :-------------------------------------------------------------------------------------------------------- |115| :-------------------- | :-------------------------------- | :-------------------------------------------------------------------------------------------------------- |

116| `chat:cancel` | Escape | 現在の入力をキャンセル |116| `chat:cancel` | Escape | 現在の入力をキャンセル |

117| `chat:clearInput` | Ctrl+L | 入力を保持したまま全画面再描画を強制します。[フルスクリーンレンダリング](/ja/fullscreen#clear-the-conversation)では、2 秒以内に 2 回押して `/clear` を実行 |117| `chat:clearInput` | Ctrl+L | 入力を保持したまま全画面再描画を強制します。[フルスクリーンレンダリング](/ja/fullscreen#clear-the-conversation)では、2 秒以内に 2 回押して `/clear` を実行 |

118| `chat:clearScreen` | Cmd+K | [フルスクリーンレンダリング](/ja/fullscreen#clear-the-conversation)では、2 秒以内に 2 回押して `/clear` を実行 |118| `chat:clearScreen` | Cmd+K | [フルスクリーンレンダリング](/ja/fullscreen#clear-the-conversation)では、2 秒以内に 2 回押して `/clear` を実行 |


126| `chat:undo` | Ctrl+\_、Ctrl+Shift+- | 最後のアクションを元に戻す |126| `chat:undo` | Ctrl+\_、Ctrl+Shift+- | 最後のアクションを元に戻す |

127| `chat:externalEditor` | Ctrl+G、Ctrl+X Ctrl+E | 外部エディタで開く |127| `chat:externalEditor` | Ctrl+G、Ctrl+X Ctrl+E | 外部エディタで開く |

128| `chat:stash` | Ctrl+S | 現在のプロンプトを保存 |128| `chat:stash` | Ctrl+S | 現在のプロンプトを保存 |

129| `chat:imagePaste` | Ctrl+V(Windows では Alt+V) | クリップボードから画像を貼り付けます。WSL では、両方のショートカットがデフォルトでバインドされています |129| `chat:imagePaste` | Ctrl+V(Windows では Alt+V、WSL では両方) | クリップボードから画像を貼り付けます。WSL では、両方のショートカットがデフォルトでバインドされています |

130 130 

131\*VT モードなし(Node \<24.2.0/\<22.17.0、Bun \<1.2.23)の Windows では、デフォルトは Meta+M です。131\*VT モードなし(Node \<24.2.0/\<22.17.0、Bun \<1.2.23)の Windows では、デフォルトは Meta+M です。

132 132 


203`Task` コンテキストで利用可能なアクション:203`Task` コンテキストで利用可能なアクション:

204 204 

205| アクション | デフォルト | 説明 |205| アクション | デフォルト | 説明 |

206| :---------------- | :----- | :--------------- |206| :---------------- | :------------------- | :---------------------------------------------------------------------------------------------------- |

207| `task:background` | Ctrl+B | 現在のタスクをバックグラウンドに |207| `task:background` | Ctrl+B、Ctrl+X Ctrl+B | 現在のタスクをバックグラウンドに。{/* min-version: 2.1.169 */}Ctrl+X Ctrl+B コードは v2.1.169 以降が必要で、tmux プレフィックスの競合を回避します |

208 208 

209<h3 id="theme-actions">209<h3 id="theme-actions">

210 テーマアクション210 テーマアクション


476}476}

477```477```

478 478 

479これはコードバインディングでも機能します。プレフィックスを共有するすべてのコードをアンバインドすると、そのプレフィックスを単一キーバインディングとして使用できるようになります479これはコード バインディングでも機能します。プレフィックスを共有するすべてのコードをアンバインドすると、そのプレフィックスを単一キー バインディングとして使用できるようになります

480 480 

481```json theme={null}481```json theme={null}

482{482{

large-codebases.md +10 −10

Details

119 119 

120`packages/api/` から Claude を開始すると、`packages/api/CLAUDE.md` とルート `CLAUDE.md` の両方が読み込まれます。Claude はローカル命令をリポジトリ全体のルールと一緒に見て、`packages/web/` からの命令はコンテキストに含まれません。同じことは非モノレポツリーのすべてのサブディレクトリに当てはまります。120`packages/api/` から Claude を開始すると、`packages/api/CLAUDE.md` とルート `CLAUDE.md` の両方が読み込まれます。Claude はローカル命令をリポジトリ全体のルールと一緒に見て、`packages/web/` からの命令はコンテキストに含まれません。同じことは非モノレポツリーのすべてのサブディレクトリに当てはまります。

121 121 

122ファイルを最新に保つためのいくつかの方法は、コードベースとモデルが変わるにつれて122ファイルを最新に保つためのいくつかの方法は、コードベースとモデルが変わるにつれてあります

123 123 

124* **プルリクエストで確認**: CLAUDE.md の編集を他のドキュメント変更と同じように扱い、規約がコードを追跡するようにします124* **プルリクエストで確認**: CLAUDE.md の編集を他のドキュメント変更と同じように扱い、規約がコードを追跡するようにします

125* **主要なモデルリリース後に再検討**: 古いモデルの制限を回避した命令は、新しいモデルがケースを独自に処理すると、オーバーヘッドになる可能性があります。たとえば、単一ファイルのリファクタリングを強制するルールは、制限がなくなると削除できます125* **主要なモデルリリース後に再検討**: 古いモデルの制限を回避した命令は、新しいモデルがケースを独自に処理すると、オーバーヘッドになる可能性があります。たとえば、単一ファイルのリファクタリングを強制するルールは、制限がなくなると削除できます


148 148 

149他のチームのパッケージ、レガシーコード、ベンダーサブツリーなど、作業しないディレクトリに使用します。除外リストは静的で、タスクごとのスイッチではありません。今日は 1 つのパッケージに焦点を当て、明日は別のパッケージに焦点を当てるには、除外を編集する代わりに [そのパッケージのディレクトリから Claude を開始](#choose-where-to-start-claude)してください。149他のチームのパッケージ、レガシーコード、ベンダーサブツリーなど、作業しないディレクトリに使用します。除外リストは静的で、タスクごとのスイッチではありません。今日は 1 つのパッケージに焦点を当て、明日は別のパッケージに焦点を当てるには、除外を編集する代わりに [そのパッケージのディレクトリから Claude を開始](#choose-where-to-start-claude)してください。

150 150 

151これらの除外をご自身のみに使用する場合は、gitignore されてコミットされない `.claude/settings.local.json` に設定を配置します。パターンはグロブ構文を使用して絶対ファイルパスに対してマッチするため、相対スタイルのパターンを `**/` で開始して、ツリーのどこにでもマッチするようにします。以下の例は他のチームが所有するパッケージを除外します。151これらの除外をご自身のみに使用する場合は、`.claude/settings.local.json` に設定を配置します。Claude Code はそれを作成するときにそのファイルを gitignore します。ここで手動で作成しているため、gitignore に追加してください。パターンはグロブ構文を使用して絶対ファイルパスに対してマッチするため、相対スタイルのパターンを `**/` で開始して、ツリーのどこにでもマッチするようにします。以下の例は他のチームが所有するパッケージを除外します。

152 152 

153```json .claude/settings.local.json theme={null}153```json .claude/settings.local.json theme={null}

154{154{


329 ディレクトリごとのスキルを追加する329 ディレクトリごとのスキルを追加する

330</h2>330</h2>

331 331 

332任意のサブディレクトリは、独自のスタックにスコープされた [スキル](/ja/skills)を定義できます。スキルは Claude がそれが関連していると判断したときにオンデマンドで読み込まれるため、API 固有のツーリングはフロントエンド作業中にコンテキストを消費しません。332任意のサブディレクトリは、独自のスタックにスコープされた [スキル](/ja/skills) を定義できます。スキルは Claude がそれが関連していると判断したときにオンデマンドで読み込まれるため、API 固有のツーリングはフロントエンド作業中にコンテキストを消費しません。

333 333 

334スキルはディレクトリ内の `.claude/skills/` の下に存在します。そのエリアのコードと一緒にコミットして、リポジトリをクローンする人は誰でもそれらを取得します。モノレポではこれはパッケージごとに 1 つのスキルセットになります。大規模シングルツリーコードベースでは、`src/db/.claude/skills/` などのサブシステムごとに 1 つです。334スキルはディレクトリ内の `.claude/skills/` の下に存在します。そのエリアのコードと一緒にコミットして、リポジトリをクローンする人は誰でもそれらを取得します。モノレポではこれはパッケージごとに 1 つのスキルセットになります。大規模シングルツリーコードベースでは、`src/db/.claude/skills/` などのサブシステムごとに 1 つです。

335 335 


372 372 

373別のサブディレクトリは同じ方法で異なるスキルを保持します。`packages/web/.claude/skills/component-patterns/` はテストの代わりにフロントエンドのコンポーネント規約を説明します。Claude が `packages/api/` のファイルで動作するとき、api-testing スキルを読み込みます。`packages/web/` で動作するとき、component-patterns を読み込みます。どちらのディレクトリのスキルも他のタスク中に読み込まれません。373別のサブディレクトリは同じ方法で異なるスキルを保持します。`packages/web/.claude/skills/component-patterns/` はテストの代わりにフロントエンドのコンポーネント規約を説明します。Claude が `packages/api/` のファイルで動作するとき、api-testing スキルを読み込みます。`packages/web/` で動作するとき、component-patterns を読み込みます。どちらのディレクトリのスキルも他のタスク中に読み込まれません。

374 374 

375ファイルパターンで配置の代わりにスキルをスコープすることもできます。[`paths` frontmatter フィールド](/ja/skills#frontmatter-reference)はグロブパターンを取り、Claude はマッチするファイルで動作するときのみ自動的にスキルを読み込みます。これは、リポジトリルートの `.claude/skills/` に存在するが、データベースマイグレーションスキルなど、`**/migrations/**` にスコープされた特定のファイルにのみ適用されるスキルに使用します。375ファイルパターンで配置の代わりにスキルをスコープすることもできます。[`paths` frontmatter フィールド](/ja/skills#frontmatter-reference) はグロブパターンを取り、Claude はマッチするファイルで動作するときのみ自動的にスキルを読み込みます。これは、リポジトリルートの `.claude/skills/` に存在するが、データベースマイグレーションスキルなど、`**/migrations/**` にスコープされた特定のファイルにのみ適用されるスキルに使用します。

376 376 

377スキルの作成と整理の詳細については、[スキル](/ja/skills)を参照してください。377スキルの作成と整理の詳細については、[スキル](/ja/skills) を参照してください。

378 378 

379<h3 id="keep-skills-discoverable">379<h3 id="keep-skills-discoverable">

380 スキルを発見可能に保つ380 スキルを発見可能に保つ


386 386 

387* **`packages/api/` などのサブディレクトリから**: そのディレクトリのスキル、リポジトリルートまでのすべての親、およびユーザーとエンタープライズレベル387* **`packages/api/` などのサブディレクトリから**: そのディレクトリのスキル、リポジトリルートまでのすべての親、およびユーザーとエンタープライズレベル

388* **リポジトリルートから**: セッション中に Claude が触れるすべてのサブディレクトリのスキル。数百に蓄積する可能性があります388* **リポジトリルートから**: セッション中に Claude が触れるすべてのサブディレクトリのスキル。数百に蓄積する可能性があります

389* **[`--add-dir`](#grant-access-across-packages-or-repositories)で兄弟を追加した後**: そのスキルのスキルも読み込まれます。`additionalDirectories` 設定はファイルアクセスのみを付与し、スキルを読み込みません389* **[`--add-dir`](#grant-access-across-packages-or-repositories) で兄弟を追加した後**: そのスキルのスキルも読み込まれます。`additionalDirectories` 設定はファイルアクセスのみを付与し、スキルを読み込みません

390 390 

391名前は常に読み込まれますが、[多くの場合、説明は短縮されます](/ja/skills#skill-descriptions-are-cut-short)。これは Claude がスキルが適用されるかどうかを決定するために使用するキーワードを削除する可能性があります。説明を短く保ち、「`packages/api/` でテストを書き込み、または変更する」などのリクエストに含まれる単語で先頭に配置します。391名前は常に読み込まれますが、[多くの場合、説明は短縮されます](/ja/skills#skill-descriptions-are-cut-short)。これは Claude がスキルが適用されるかどうかを決定するために使用するキーワードを削除する可能性があります。説明を短く保ち、「`packages/api/` でテストを書き込み、または変更する」などのリクエストに含まれる単語で先頭に配置します。

392 392 

393多くのディレクトリが共有するスキル(PR 規約やデプロイチェックリストなど)については、リポジトリルートの `.claude/skills/` に配置して、任意の開始ディレクトリから読み込まれるようにします。共有スキルが独自のバージョン履歴を必要とするか、リポジトリ全体で動作する必要がある場合は、代わりに [プラグイン](/ja/plugins)としてパッケージ化します。プラグインスキルは `plugin-name:skill-name` 名前空間を使用するため、ディレクトリごとのスキルと衝突することはありません。プラットフォームチームは 1 つの場所でそれらをバージョン管理し、更新できます。393多くのディレクトリが共有するスキル(PR 規約やデプロイチェックリストなど)については、リポジトリルートの `.claude/skills/` に配置して、任意の開始ディレクトリから読み込まれるようにします。共有スキルが独自のバージョン履歴を必要とするか、リポジトリ全体で動作する必要がある場合は、代わりに [プラグイン](/ja/plugins) としてパッケージ化します。プラグインスキルは `plugin-name:skill-name` 名前空間を使用するため、ディレクトリごとのスキルと衝突することはありません。プラットフォームチームは 1 つの場所でそれらをバージョン管理し、更新できます。

394 394 

395使用されていないスキルを見つけるには、OpenTelemetry [ログエクスポーター](/ja/monitoring-usage)を有効にし、`OTEL_LOG_TOOL_DETAILS=1` を設定して、スキル名が編集されずに記録されるようにします。[`skill_activated` イベント](/ja/monitoring-usage#skill-activated-event)は `skill.name` 属性のすべての呼び出しを記録し、`invocation_trigger` はコマンド、Claude、またはネストされたスキルが呼び出したかどうかを記録します。これは統合または廃止するものを示します。395使用されていないスキルを見つけるには、OpenTelemetry [ログエクスポーター](/ja/monitoring-usage) を有効にし、`OTEL_LOG_TOOL_DETAILS=1` を設定して、スキル名が編集されずに記録されるようにします。[`skill_activated` イベント](/ja/monitoring-usage#skill-activated-event) は `skill.name` 属性のすべての呼び出しを記録し、`invocation_trigger` はコマンド、Claude、またはネストされたスキルが呼び出したかどうかを記録します。これは統合または廃止するものを示します。

396 396 

397<h2 id="centralize-conventions-when-layering-stops-scaling">397<h2 id="centralize-conventions-when-layering-stops-scaling">

398 レイアリングが拡張を停止したときに規約を一元化する398 レイアリングが拡張を停止したときに規約を一元化する


450 450 

451このセッションは `packages/api/` から開始するため、兄弟パッケージの CLAUDE.md ファイルはすでにスコープ外であるため、`claudeMdExcludes` はここで必要ありません。ルートからセッションも開始する場合は、代わりにリポジトリルートの `.claude/settings.local.json` に追加します。451このセッションは `packages/api/` から開始するため、兄弟パッケージの CLAUDE.md ファイルはすでにスコープ外であるため、`claudeMdExcludes` はここで必要ありません。ルートからセッションも開始する場合は、代わりにリポジトリルートの `.claude/settings.local.json` に追加します。

452 452 

453`additionalDirectories` エントリは `packages/api/` から直接 Claude を開始するときに適用されます。このセッションから作成されたワークツリー内では、作業ディレクトリはワークツリールートであるため、この設定ファイルは読み込まれません。兄弟パッケージはワークツリー内で既にアクセス可能ですが、拒否ルールはリポジトリルートの `.claude/settings.json` に 2 番目のコピーが必要です。ワークツリーセッションがそれらを取得するため、[ワークツリー設定ノート](#check-out-only-the-directories-you-need)が説明するように453`additionalDirectories` エントリは `packages/api/` から直接 Claude を開始するときに適用されます。このセッションから作成されたワークツリー内では、作業ディレクトリはワークツリールートであるため、この設定ファイルは読み込まれません。兄弟パッケージはワークツリー内で既にアクセス可能ですが、拒否ルールはリポジトリルートの `.claude/settings.json` に 2 番目のコピーが必要です。ワークツリーセッションがそれらを取得するため、[ディレクトリをチェックアウトするだけで十分です](#check-out-only-the-directories-you-need)で説明するように

454 454 

455```json .claude/settings.json theme={null}455```json .claude/settings.json theme={null}

456{456{


495 495 

496上記の設定は Claude が見るものを制御します。共有型を更新し、それを使用するすべての呼び出しサイトを更新するなど、単一の変更が複数のパッケージに触れる場合、タスクをスコープし、シーケンスする方法も結果に影響します。496上記の設定は Claude が見るものを制御します。共有型を更新し、それを使用するすべての呼び出しサイトを更新するなど、単一の変更が複数のパッケージに触れる場合、タスクをスコープし、シーケンスする方法も結果に影響します。

497 497 

498クロスパッケージの変更を一貫性のあるものに保つのに役立つ 2 つの技術498クロスパッケージの変更を一貫性のあるものに保つのに役立つ 2 つの技術があります

499 499 

500* **1 つのセッションで Claude に全体の変更を与える**: 共有編集とその呼び出しサイトを一緒に引き渡すことで、各編集の背後にある決定を一貫性のあるものに保ちます。パッケージごとに再導出するのではなく500* **1 つのセッションで Claude に全体の変更を与える**: 共有編集とその呼び出しサイトを一緒に引き渡すことで、各編集の背後にある決定を一貫性のあるものに保ちます。パッケージごとに再導出するのではなく

501* **編集する前に計画をファイルに保存**: [最初に計画](/ja/best-practices#explore-first-then-plan-then-code)し、Claude に計画をリポジトリのマークダウンファイルに書き込むよう依頼します。長いクロスパッケージセッションは [コンテキストをコンパクト化](/ja/context-window#what-survives-compaction)します。計画は会話履歴が存在しない場合でも生き残ります。501* **編集する前に計画をファイルに保存**: [最初に計画](/ja/best-practices#explore-first-then-plan-then-code)し、Claude に計画をリポジトリのマークダウンファイルに書き込むよう依頼します。長いクロスパッケージセッションは [コンテキストをコンパクト化](/ja/context-window#what-survives-compaction)します。計画は会話履歴が存在しない場合でも生き残ります。

llm-gateway.md +3 −1

Details

14* **監査ログ** - コンプライアンスのためのすべてのモデル相互作用の追跡14* **監査ログ** - コンプライアンスのためのすべてのモデル相互作用の追跡

15* **モデルルーティング** - コード変更なしでプロバイダー間の切り替え15* **モデルルーティング** - コード変更なしでプロバイダー間の切り替え

16 16 

17このページでは、Claude Code CLI のgateway要件と設定について説明します。Enterprise Desktop デプロイメントは、[管理設定](https://support.claude.com/ja/articles/12622667-enterprise-configuration)を通じてgatewayプロバイダーを設定できます。Claude Desktop アプリは、[Cowork on 3P research preview](https://claude.com/docs/cowork/3p/gateway)を通じて自己ホスト型gatewayに対して実行することもでき、これは独自の設定キーを使用します。

18 

17<h2 id="gateway-requirements">19<h2 id="gateway-requirements">

18 Gateway要件20 Gateway要件

19</h2>21</h2>


72ゲートウェイが検出フィルターと一致しないモデル名を使用している場合は、[モデル設定](/ja/model-config)に記載されている環境変数を使用して、手動で追加してください。74ゲートウェイが検出フィルターと一致しないモデル名を使用している場合は、[モデル設定](/ja/model-config)に記載されている環境変数を使用して、手動で追加してください。

73 75 

74<h2 id="litellm-configuration">76<h2 id="litellm-configuration">

75 LiteLLM設定77 LiteLLM 設定

76</h2>78</h2>

77 79 

78<Warning>80<Warning>

managed-mcp.md +2 −2

Details

27Claude Code は、さまざまな制限レベルをサポートしています。各パターンは、以下で説明する 1 つまたは両方のメカニズムを使用します。固定セットをデプロイするための `managed-mcp.json` と、ユーザーが設定できる内容をフィルタリングするための `allowedMcpServers`/`deniedMcpServers` です。27Claude Code は、さまざまな制限レベルをサポートしています。各パターンは、以下で説明する 1 つまたは両方のメカニズムを使用します。固定セットをデプロイするための `managed-mcp.json` と、ユーザーが設定できる内容をフィルタリングするための `allowedMcpServers`/`deniedMcpServers` です。

28 28 

29| パターン | 機能 | 設定 |29| パターン | 機能 | 設定 |

30| :-------------- | :---------------------------------------------- | :--------------------------------------------------------------------------------------------- |30| :-------------- | :---------------------------------------------- | :---------------------------------------------------------------------------------------------- |

31| **MCP を無効にする** | サーバーはどこにも読み込まれません | 空のサーバーマップを含む `managed-mcp.json` |31| **MCP を無効にする** | サーバーはどこにも読み込まれません | 空のサーバーマップを含む `managed-mcp.json` |

32| **固定デプロイ** | すべてのユーザーが同じサーバーを取得し、他のサーバーを追加できません | 必要なサーバーを含む `managed-mcp.json` |32| **固定デプロイ** | すべてのユーザーが同じサーバーを取得し、他のサーバーを追加できません | 必要なサーバーを含む `managed-mcp.json` |

33| **承認済みカタログ** | 承認済みサーバーのリストを公開します。ユーザーは必要なものを追加し、他のものはブロックされます | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |33| **承認済みカタログ** | 承認済みサーバーのリストを公開します。ユーザーは必要なものを追加し、他のものはブロックされます | `allowedMcpServers` + `allowManagedMcpServersOnly: true` |

34| **プラグインサーバーのみ** | サーバーはプラグインからのみ取得できます。ユーザーは独自のサーバーを追加できません | [`strictPluginOnlyCustomization`](/ja/settings#strictpluginonlycustomization)。リストに `mcp` を含めます |34| **プラグインサーバーのみ** | サーバーはプラグインからのみ取得できます。ユーザーは独自のサーバーを追加できません | [`strictPluginOnlyCustomization`](/ja/settings#strictpluginonlycustomization) とリストに `mcp` を含めます |

35| **ソフト許可リスト** | ユーザーが独自の設定で拡張できる許可リストを実施します | `allowManagedMcpServersOnly` なしの `allowedMcpServers` |35| **ソフト許可リスト** | ユーザーが独自の設定で拡張できる許可リストを実施します | `allowManagedMcpServersOnly` なしの `allowedMcpServers` |

36| **ブロックリストのみ** | 既知の悪いサーバーをブロックし、他のすべてを許可します | `deniedMcpServers` |36| **ブロックリストのみ** | 既知の悪いサーバーをブロックし、他のすべてを許可します | `deniedMcpServers` |

37| **制限なし** | ユーザーは何でも追加できます | 管理対象 MCP 設定をデプロイしません |37| **制限なし** | ユーザーは何でも追加できます | 管理対象 MCP 設定をデプロイしません |

mcp.md +162 −76

Details

12 12 

13初めてサーバーを接続する場合は、ステップバイステップのウォークスルーについて [MCP クイックスタート](/ja/mcp-quickstart) から始めてください。このページは完全なリファレンスです。13初めてサーバーを接続する場合は、ステップバイステップのウォークスルーについて [MCP クイックスタート](/ja/mcp-quickstart) から始めてください。このページは完全なリファレンスです。

14 14 

15## MCP でできること15<h2 id="what-you-can-do-with-mcp">

16 MCP でできること

17</h2>

16 18 

17MCP サーバーが接続されている場合、Claude Code に以下のことを依頼できます:19MCP サーバーが接続されている場合、Claude Code に以下のことを依頼できます:

18 20 


23* **ワークフローを自動化する**:「新機能に関するフィードバックセッションに招待する 10 人のユーザーに Gmail ドラフトを作成してください。」25* **ワークフローを自動化する**:「新機能に関するフィードバックセッションに招待する 10 人のユーザーに Gmail ドラフトを作成してください。」

24* **外部イベントに対応する**:MCP サーバーは [チャネル](/ja/channels) として機能することもでき、セッションにメッセージをプッシュするため、Claude は離席中に Telegram メッセージ、Discord チャット、または webhook イベントに対応できます。26* **外部イベントに対応する**:MCP サーバーは [チャネル](/ja/channels) として機能することもでき、セッションにメッセージをプッシュするため、Claude は離席中に Telegram メッセージ、Discord チャット、または webhook イベントに対応できます。

25 27 

26## MCP サーバーを検索してビルドする28<h2 id="find-and-build-mcp-servers">

29 MCP サーバーを検索してビルドする

30</h2>

27 31 

28[Anthropic Directory](https://claude.ai/directory) でレビュー済みのコネクタを参照してください。Directory コネクタは Claude Code と同じ MCP インフラストラクチャを使用しているため、`claude mcp add` を使用して、そこにリストされているリモートサーバーを追加できます。32[Anthropic Directory](https://claude.ai/directory) でレビュー済みのコネクタを参照してください。Directory コネクタは Claude Code と同じ MCP インフラストラクチャを使用しているため、`claude mcp add` を使用して、そこにリストされているリモートサーバーを追加できます。

29 33 


55 </Step>59 </Step>

56</Steps>60</Steps>

57 61 

58## MCP サーバーのインストール62<h2 id="installing-mcp-servers">

63 MCP サーバーのインストール

64</h2>

59 65 

60MCP サーバーは、ニーズに応じて複数の方法で設定できます:66MCP サーバーは、ニーズに応じて複数の方法で設定できます:

61 67 

62### オプション 1:リモート HTTP サーバーを追加する68<h3 id="option-1-add-a-remote-http-server">

69 オプション 1:リモート HTTP サーバーを追加する

70</h3>

63 71 

64HTTP サーバーはリモート MCP サーバーに接続するための推奨オプションです。これはクラウドベースのサービスに最も広くサポートされているトランスポートです。72HTTP サーバーはリモート MCP サーバーに接続するための推奨オプションです。これはクラウドベースのサービスに最も広くサポートされているトランスポートです。

65 73 


77 85 

78MCP サーバーを `.mcp.json`、`~/.claude.json`、または `claude mcp add-json` で JSON を使用して設定する場合、`type` フィールドは `http` のエイリアスとして `streamable-http` を受け入れます。MCP 仕様ではこのトランスポートに `streamable-http` という名前を使用しているため、サーバードキュメントからコピーされた設定は変更なしで機能します。86MCP サーバーを `.mcp.json`、`~/.claude.json`、または `claude mcp add-json` で JSON を使用して設定する場合、`type` フィールドは `http` のエイリアスとして `streamable-http` を受け入れます。MCP 仕様ではこのトランスポートに `streamable-http` という名前を使用しているため、サーバードキュメントからコピーされた設定は変更なしで機能します。

79 87 

80### オプション 2:リモート SSE サーバーを追加する88<h3 id="option-2-add-a-remote-sse-server">

89 オプション 2:リモート SSE サーバーを追加する

90</h3>

81 91 

82<Warning>92<Warning>

83 SSE(Server-Sent Events)トランスポートは非推奨です。利用可能な場合は HTTP サーバーを使用してください。93 SSE(Server-Sent Events)トランスポートは非推奨です。利用可能な場合は HTTP サーバーを使用してください。


95 --header "X-API-Key: your-key-here"105 --header "X-API-Key: your-key-here"

96```106```

97 107 

98### オプション 3:ローカル stdio サーバーを追加する108<h3 id="option-3-add-a-local-stdio-server">

109 オプション 3:ローカル stdio サーバーを追加する

110</h3>

99 111 

100Stdio サーバーはマシン上でローカルプロセスとして実行されます。システムへの直接アクセスやカスタムスクリプトが必要なツールに最適です。112Stdio サーバーはマシン上でローカルプロセスとして実行されます。システムへの直接アクセスやカスタムスクリプトが必要なツールに最適です。

101 113 


108claude mcp add [options] <name> -- <command> [args...]120claude mcp add [options] <name> -- <command> [args...]

109 121 

110# 実際の例:Airtable サーバーを追加する122# 実際の例:Airtable サーバーを追加する

111claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \123claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \

112 -- npx -y airtable-mcp-server124 -- npx -y airtable-mcp-server

113```125```

114 126 

115<Note>127<Note>

116 **重要:オプションの順序**128 **重要:サーバー引数を `--` で分離する**

117 129 

118 すべてのオプション(`--transport``--env`、`--scope`、`--header`)はサーバー名の**前に**来る必要があります。`--`(ダブルダッシュ)はサーバー名を MCP サーバーに渡されるコマンドと引数から分離します130 Stdio サーバーの場合、`--`(ダブルダッシュ)は Claude 自体のオプション(`--transport`、`--env`、`--scope` などをサーバーを実行するコマンドと引数から分離します。`--` の後のすべてはサーバーに変更されずに渡されます

119 131 

120 例:132 例:

121 133 

122 * `claude mcp add --transport stdio myserver -- npx server` → `npx server` を実行します134 * `claude mcp add --transport stdio myserver -- npx server` → `npx server` を実行します

123 * `claude mcp add --transport stdio --env KEY=value myserver -- python server.py --port 8080` → 環境に `KEY=value` を設定して `python server.py --port 8080` を実行します135 * `claude mcp add --env KEY=value --transport stdio myserver -- python server.py --port 8080` → 環境に `KEY=value` を設定して `python server.py --port 8080` を実行します

124 136 

125 これにより、Claude のフラグとサーバーのフラグの間の競合を防ぎます137 `--` がない場合、Claude Code はサーバーのフラグ(上記の `--port` など)を独自のオプションとして解析しようとします

138 

139 `--env` は複数の `KEY=value` ペアを受け入れます。サーバー名が `--env` の直後に来る場合、CLI は名前を別のペアとして読み取り、それを拒否するため、上記の例のように `--env` とサーバー名の間に少なくとも 1 つの別のオプションを配置してください。

126</Note>140</Note>

127 141 

128### オプション 4:リモート WebSocket サーバーを追加する142<h3 id="option-4-add-a-remote-websocket-server">

143 オプション 4:リモート WebSocket サーバーを追加する

144</h3>

129 145 

130WebSocket サーバーは永続的な双方向接続を保持し、Claude に予期しないイベントをプッシュするリモート MCP サーバーに適しています。サーバーがリクエストにのみ応答する場合は HTTP を使用してください。HTTP は OAuth と `claude mcp add --transport` フラグをサポートしていますが、WebSocket はどちらもサポートしていません。146WebSocket サーバーは永続的な双方向接続を保持し、Claude に予期しないイベントをプッシュするリモート MCP サーバーに適しています。サーバーがリクエストにのみ応答する場合は HTTP を使用してください。HTTP は OAuth と `claude mcp add --transport` フラグをサポートしていますが、WebSocket はどちらもサポートしていません。

131 147 


138 154 

139`type: "ws"` エントリは `http` と同じ `url`、`headers`、`headersHelper`、`timeout`、`alwaysLoad` フィールドを受け入れます。認証はヘッダーのみなので、`headers` に静的トークンを渡すか、[`headersHelper`](#use-dynamic-headers-for-custom-authentication) で接続時に生成してください。`claude mcp add --transport` フラグは `ws` を受け入れません。155`type: "ws"` エントリは `http` と同じ `url`、`headers`、`headersHelper`、`timeout`、`alwaysLoad` フィールドを受け入れます。認証はヘッダーのみなので、`headers` に静的トークンを渡すか、[`headersHelper`](#use-dynamic-headers-for-custom-authentication) で接続時に生成してください。`claude mcp add --transport` フラグは `ws` を受け入れません。

140 156 

141### サーバーの管理157<h3 id="managing-your-servers">

158 サーバーの管理

159</h3>

142 160 

143設定後、これらのコマンドで MCP サーバーを管理できます:161設定後、これらのコマンドで MCP サーバーを管理できます:

144 162 


164 182 

165サーバー名 `workspace` は内部使用のために予約されています。設定がその名前のサーバーを定義している場合、Claude Code はロード時にそれをスキップし、名前を変更するよう求める警告を表示します。183サーバー名 `workspace` は内部使用のために予約されています。設定がその名前のサーバーを定義している場合、Claude Code はロード時にそれをスキップし、名前を変更するよう求める警告を表示します。

166 184 

167### 動的ツール更新185<h3 id="dynamic-tool-updates">

186 動的ツール更新

187</h3>

168 188 

169Claude Code は MCP `list_changed` 通知をサポートしており、MCP サーバーが切断して再接続することなく、利用可能なツール、プロンプト、リソースを動的に更新できます。MCP サーバーが `list_changed` 通知を送信すると、Claude Code はそのサーバーから利用可能な機能を自動的に更新します。189Claude Code は MCP `list_changed` 通知をサポートしており、MCP サーバーが切断して再接続することなく、利用可能なツール、プロンプト、リソースを動的に更新できます。MCP サーバーが `list_changed` 通知を送信すると、Claude Code はそのサーバーから利用可能な機能を自動的に更新します。

170 190 

171### 自動再接続191<h3 id="automatic-reconnection">

192 自動再接続

193</h3>

172 194 

173HTTP または SSE サーバーがセッション中に切断された場合、Claude Code は指数バックオフで自動的に再接続します:最大 5 回の試行、1 秒の遅延から始まり、毎回 2 倍になります。サーバーは再接続が進行中の間、`/mcp` では保留中として表示されます。5 回の失敗した試行の後、サーバーは失敗としてマークされ、`/mcp` から手動で再試行できます。Stdio サーバーはローカルプロセスであり、自動的には再接続されません。195HTTP または SSE サーバーがセッション中に切断された場合、Claude Code は指数バックオフで自動的に再接続します:最大 5 回の試行、1 秒の遅延から始まり、毎回 2 倍になります。サーバーは再接続が進行中の間、`/mcp` では保留中として表示されます。5 回の失敗した試行の後、サーバーは失敗としてマークされ、`/mcp` から手動で再試行できます。Stdio サーバーはローカルプロセスであり、自動的には再接続されません。

174 196 

175同じバックオフは、HTTP または SSE サーバーが起動時に初期接続に失敗した場合にも適用されます。v2.1.121 以降、Claude Code は 5xx レスポンス、接続拒否、タイムアウトなどの一時的なエラーで初期接続を最大 3 回再試行し、それでも接続できない場合はサーバーを失敗としてマークします。認証エラーと見つからないエラーは、解決するために設定変更が必要なため、再試行されません。197同じバックオフは、HTTP または SSE サーバーが起動時に初期接続に失敗した場合にも適用されます。v2.1.121 以降、Claude Code は 5xx レスポンス、接続拒否、タイムアウトなどの一時的なエラーで初期接続を最大 3 回再試行し、それでも接続できない場合はサーバーを失敗としてマークします。認証エラーと見つからないエラーは、解決するために設定変更が必要なため、再試行されません。

176 198 

177### チャネルでメッセージをプッシュする199<h3 id="push-messages-with-channels">

200 チャネルでメッセージをプッシュする

201</h3>

178 202 

179MCP サーバーはセッションに直接メッセージをプッシュすることもでき、Claude が CI 結果、監視アラート、チャットメッセージなどの外部イベントに対応できます。これを有効にするには、サーバーが `claude/channel` 機能を宣言し、起動時に `--channels` フラグでオプトインします。公式にサポートされているチャネルを使用するには [チャネル](/ja/channels) を参照するか、独自に構築するには [チャネルリファレンス](/ja/channels-reference) を参照してください。203MCP サーバーはセッションに直接メッセージをプッシュすることもでき、Claude が CI 結果、監視アラート、チャットメッセージなどの外部イベントに対応できます。これを有効にするには、サーバーが `claude/channel` 機能を宣言し、起動時に `--channels` フラグでオプトインします。公式にサポートされているチャネルを使用するには [チャネル](/ja/channels) を参照するか、独自に構築するには [チャネルリファレンス](/ja/channels-reference) を参照してください。

180 204 


192 * `/mcp` を使用して、OAuth 2.0 認証が必要なリモートサーバーで認証します216 * `/mcp` を使用して、OAuth 2.0 認証が必要なリモートサーバーで認証します

193</Tip>217</Tip>

194 218 

195サーバーごとの `timeout` はツール呼び出しごとのハードウォールクロック制限であり、サーバーからの進捗通知はそれを延長しません。1000 未満の値は 1 秒に切り下げられます。HTTP および SSE サーバーの場合、リクエストごとのフェッチ最初バイト予算には、この値に関係なく 60 秒の最小値があるため、ツール呼び出しウォッチドッグのみが小さい値を尊重します219サーバーごとの `timeout` はツール呼び出しごとのハードウォールクロック制限であり、サーバーからの進捗通知はそれを延長しません。1000 未満の値は無視され、`MCP_TOOL_TIMEOUT` にフォールスルーするか、その変数が設定されていない場合は約 28 時間のデフォルトにフォールスルーします。{/* min-version: 2.1.162 */}v2.1.162 より前は、1000 未満の値は 1 秒に切り下げられていました。HTTP および SSE サーバーの場合、リクエストごとのフェッチ最初バイト予算には 60 秒の最小値があります

196 220 

197### プラグイン提供の MCP サーバー221<h3 id="plugin-provided-mcp-servers">

222 プラグイン提供の MCP サーバー

223</h3>

198 224 

199[プラグイン](/ja/plugins) は MCP サーバーをバンドルでき、プラグインが有効になると自動的にツールと統合を提供します。プラグイン MCP サーバーはユーザーが設定したサーバーと同じように機能します。225[プラグイン](/ja/plugins) は MCP サーバーをバンドルでき、プラグインが有効になると自動的にツールと統合を提供します。プラグイン MCP サーバーはユーザーが設定したサーバーと同じように機能します。

200 226 


253 279 

254プラグインサーバーはプラグインから来ていることを示すインジケータ付きでリストに表示されます。280プラグインサーバーはプラグインから来ていることを示すインジケータ付きでリストに表示されます。

255 281 

282**プラグイン MCP ツール名**:

283 

284プラグインでバンドルされた MCP サーバーからのツールには、呼び出し可能な名前にプラグイン名とサーバーキーの両方が含まれます。完全な形式は `mcp__plugin_<plugin-name>_<server-name>__<tool-name>` です。ここで、`A-Z`、`a-z`、`0-9`、`_`、`-` の外の任意の文字は `_` に置き換えられます。`my-plugin` という名前のプラグインでバンドルされた `database-tools` サーバーの場合、`query` ツールは以下のように呼び出し可能です:

285 

286```

287mcp__plugin_my-plugin_database-tools__query

288```

289 

290[権限ルール](/ja/permissions)、スキルの `allowed-tools` リスト、または [サブエージェントの `tools` フィールド](/ja/sub-agents#available-tools) でツールを参照する場合は、この完全な名前を使用してください。

291 

256**プラグイン MCP サーバーの利点**:292**プラグイン MCP サーバーの利点**:

257 293 

258* **バンドル配布**:ツールとサーバーが一緒にパッケージ化されます294* **バンドル配布**:ツールとサーバーが一緒にパッケージ化されます

259* **自動セットアップ**:手動の MCP 設定は不要です295* **自動セットアップ**:手動の MCP 設定は不要です

260* **チーム一貫性**:プラグインがインストールされると、すべてのユーザーが同じツールを取得します296* **チーム一貫性**:プラグインがインストールされると、すべてのユーザーが同じツールを取得します

261 297 

262プラグインで MCP サーバーをバンドルする詳細については、[プラグインコンポーネントリファレンス](/ja/plugins-reference#mcp-servers)を参照してください。298プラグインで MCP サーバーをバンドルする詳細については、[プラグインコンポーネントリファレンス](/ja/plugins-reference#mcp-servers) を参照してください。

263 299 

264## MCP インストールスコープ300<h2 id="mcp-installation-scopes">

301 MCP インストールスコープ

302</h2>

265 303 

266MCP サーバーは 3 つのスコープで設定できます。選択するスコープは、サーバーがロードされるプロジェクトと、設定がチームと共有されるかどうかを制御します。管理者は、[マネージド設定](#managed-mcp-configuration)を通じてエンタープライズレベルでサーバーをデプロイすることもできます。304MCP サーバーは 3 つのスコープで設定できます。選択するスコープは、サーバーがロードされるプロジェクトと、設定がチームと共有されるかどうかを制御します。管理者は、[マネージド設定](#managed-mcp-configuration)を通じてエンタープライズレベルでサーバーをデプロイすることもできます。

267 305 


271| [プロジェクト](#project-scope) | 現在のプロジェクトのみ | はい、バージョン管理経由 | プロジェクトルートの `.mcp.json` |309| [プロジェクト](#project-scope) | 現在のプロジェクトのみ | はい、バージョン管理経由 | プロジェクトルートの `.mcp.json` |

272| [ユーザー](#user-scope) | すべてのプロジェクト | いいえ | `~/.claude.json` |310| [ユーザー](#user-scope) | すべてのプロジェクト | いいえ | `~/.claude.json` |

273 311 

274### ローカルスコープ312<h3 id="local-scope">

313 ローカルスコープ

314</h3>

275 315 

276ローカルスコープはデフォルトです。ローカルスコープのサーバーは、追加したプロジェクトでのみロードされ、あなたにプライベートなままです。Claude Code は `~/.claude.json` のそのプロジェクトのパスの下に保存するため、同じサーバーは他のプロジェクトに表示されません。個人開発サーバー、実験的な設定、またはバージョン管理に含めたくない認証情報を持つサーバーにはローカルスコープを使用してください。316ローカルスコープはデフォルトです。ローカルスコープのサーバーは、追加したプロジェクトでのみロードされ、あなたにプライベートなままです。Claude Code は `~/.claude.json` のそのプロジェクトのパスの下に保存するため、同じサーバーは他のプロジェクトに表示されません。個人開発サーバー、実験的な設定、またはバージョン管理に含めたくない認証情報を持つサーバーにはローカルスコープを使用してください。

277 317 


304}344}

305```345```

306 346 

307### プロジェクトスコープ347<h3 id="project-scope">

348 プロジェクトスコープ

349</h3>

308 350 

309プロジェクトスコープのサーバーは、プロジェクトのルートディレクトリの `.mcp.json` ファイルに設定を保存することで、チーム間のコラボレーションを可能にします。このファイルはバージョン管理にチェックインするように設計されており、すべてのチームメンバーが同じ MCP ツールとサービスにアクセスできることを保証します。プロジェクトスコープのサーバーを追加すると、Claude Code は自動的にこのファイルを作成または更新して、適切な設定構造を使用します。351プロジェクトスコープのサーバーは、プロジェクトのルートディレクトリの `.mcp.json` ファイルに設定を保存することで、チーム間のコラボレーションを可能にします。このファイルはバージョン管理にチェックインするように設計されており、すべてのチームメンバーが同じ MCP ツールとサービスにアクセスできることを保証します。プロジェクトスコープのサーバーを追加すると、Claude Code は自動的にこのファイルを作成または更新して、適切な設定構造を使用します。

310 352 


329 371 

330セキュリティ上の理由から、Claude Code は `.mcp.json` ファイルからプロジェクトスコープのサーバーを使用する前に承認を求めます。これらの承認選択をリセットする必要がある場合は、`claude mcp reset-project-choices` コマンドを使用してください。372セキュリティ上の理由から、Claude Code は `.mcp.json` ファイルからプロジェクトスコープのサーバーを使用する前に承認を求めます。これらの承認選択をリセットする必要がある場合は、`claude mcp reset-project-choices` コマンドを使用してください。

331 373 

332### ユーザースコープ374<h3 id="user-scope">

375 ユーザースコープ

376</h3>

333 377 

334ユーザースコープのサーバーは `~/.claude.json` に保存され、クロスプロジェクトのアクセス可能性を提供し、マシン上のすべてのプロジェクト全体で利用可能になりながら、ユーザーアカウントにプライベートなままです。このスコープは、個人的なユーティリティサーバー、開発ツール、または異なるプロジェクト全体で頻繁に使用するサービスに適しています。378ユーザースコープのサーバーは `~/.claude.json` に保存され、クロスプロジェクトのアクセス可能性を提供し、マシン上のすべてのプロジェクト全体で利用可能になりながら、ユーザーアカウントにプライベートなままです。このスコープは、個人的なユーティリティサーバー、開発ツール、または異なるプロジェクト全体で頻繁に使用するサービスに適しています。

335 379 


338claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic382claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

339```383```

340 384 

341### スコープの階層と優先順位385<h3 id="scope-hierarchy-and-precedence">

386 スコープの階層と優先順位

387</h3>

342 388 

343同じサーバーが複数の場所で定義されている場合、Claude Code はそれに 1 回接続し、最も優先度の高いソースからの定義を使用します。その定義全体が使用され、フィールドはスコープ全体でマージされません。389同じサーバーが複数の場所で定義されている場合、Claude Code はそれに 1 回接続し、最も優先度の高いソースからの定義を使用します。その定義全体が使用され、フィールドはスコープ全体でマージされません。

344 390 


350 396 

3513 つのスコープは名前で重複を照合します。プラグインとコネクタはエンドポイントで照合するため、上記のサーバーと同じ URL またはコマンドを指すものは重複として扱われます。3973 つのスコープは名前で重複を照合します。プラグインとコネクタはエンドポイントで照合するため、上記のサーバーと同じ URL またはコマンドを指すものは重複として扱われます。

352 398 

353### `.mcp.json` での環境変数の展開399<h3 id="environment-variable-expansion-in-mcp-json">

400 `.mcp.json` での環境変数の展開

401</h3>

354 402 

355Claude Code は `.mcp.json` ファイルの環境変数の展開をサポートしており、チームが設定を共有しながら、マシン固有のパスと API キーなどの機密値の柔軟性を維持できます。403Claude Code は `.mcp.json` ファイルの環境変数の展開をサポートしており、チームが設定を共有しながら、マシン固有のパスと API キーなどの機密値の柔軟性を維持できます。

356 404 


386 434 

387必要な環境変数が設定されておらず、デフォルト値がない場合、Claude Code は設定の解析に失敗します。435必要な環境変数が設定されておらず、デフォルト値がない場合、Claude Code は設定の解析に失敗します。

388 436 

389## 実践的な例437<h2 id="practical-examples">

438 実践的な例

439</h2>

390 440 

391{/* ### 例:Playwright でブラウザテストを自動化する441<h3 id="example-monitor-errors-with-sentry">

392 442 例:Sentry でエラーを監視する

393```bash443</h3>

394claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest

395```

396 

397その後、ブラウザテストを作成して実行します:

398 

399```text

400test@example.com でログインフローが機能するかテストしてください

401```

402```text

403モバイルでチェックアウトページのスクリーンショットを撮ってください

404```

405```text

406検索機能が結果を返すことを確認してください

407``` */}

408 

409### 例:Sentry でエラーを監視する

410 444 

411```bash theme={null}445```bash theme={null}

412claude mcp add --transport http sentry https://mcp.sentry.dev/mcp446claude mcp add --transport http sentry https://mcp.sentry.dev/mcp


432どのデプロイメントがこれらの新しいエラーを導入しましたか?466どのデプロイメントがこれらの新しいエラーを導入しましたか?

433```467```

434 468 

435### 例:コードレビューのために GitHub に接続する469<h3 id="example-connect-to-github-for-code-reviews">

470 例:コードレビューのために GitHub に接続する

471</h3>

436 472 

437GitHub のリモート MCP サーバーは、ヘッダーとして渡される GitHub 個人アクセストークンで認証します。取得するには、[GitHub トークン設定](https://github.com/settings/personal-access-tokens)を開き、Claude が操作したいリポジトリへのアクセス権を持つ新しいきめ細かいトークンを生成してから、サーバーを追加します:473GitHub のリモート MCP サーバーは、ヘッダーとして渡される GitHub 個人アクセストークンで認証します。取得するには、[GitHub トークン設定](https://github.com/settings/personal-access-tokens)を開き、Claude が操作したいリポジトリへのアクセス権を持つ新しいきめ細かいトークンを生成してから、サーバーを追加します:

438 474 


455自分に割り当てられているすべてのオープン PR を表示してください491自分に割り当てられているすべてのオープン PR を表示してください

456```492```

457 493 

458### 例:PostgreSQL データベースをクエリする494<h3 id="example-query-your-postgresql-database">

495 例:PostgreSQL データベースをクエリする

496</h3>

459 497 

460```bash theme={null}498```bash theme={null}

461claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \499claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \


476過去 90 日間に購入していない顧客を検索してください514過去 90 日間に購入していない顧客を検索してください

477```515```

478 516 

479## リモート MCP サーバーで認証する517<h2 id="authenticate-with-remote-mcp-servers">

518 リモート MCP サーバーで認証する

519</h2>

480 520 

481多くのクラウドベースの MCP サーバーは認証が必要です。Claude Code は安全な接続のために OAuth 2.0 をサポートしています。521多くのクラウドベースの MCP サーバーは認証が必要です。Claude Code は安全な接続のために OAuth 2.0 をサポートしています。

482 522 


514 * OAuth 認証は HTTP サーバーで機能します554 * OAuth 認証は HTTP サーバーで機能します

515</Tip>555</Tip>

516 556 

517### 固定 OAuth コールバックポートを使用する557<h3 id="use-a-fixed-oauth-callback-port">

558 固定 OAuth コールバックポートを使用する

559</h3>

518 560 

519一部の MCP サーバーは、事前に登録された特定のリダイレクト URI が必要です。デフォルトでは、Claude Code は OAuth コールバック用にランダムに利用可能なポートを選択します。`--callback-port` を使用してポートを固定し、`http://localhost:PORT/callback` の形式の事前登録されたリダイレクト URI と一致させます。561一部の MCP サーバーは、事前に登録された特定のリダイレクト URI が必要です。デフォルトでは、Claude Code は OAuth コールバック用にランダムに利用可能なポートを選択します。`--callback-port` を使用してポートを固定し、`http://localhost:PORT/callback` の形式の事前登録されたリダイレクト URI と一致させます。

520 562 


527 my-server https://mcp.example.com/mcp569 my-server https://mcp.example.com/mcp

528```570```

529 571 

530### 事前設定された OAuth 認証情報を使用する572<h3 id="use-pre-configured-oauth-credentials">

573 事前設定された OAuth 認証情報を使用する

574</h3>

531 575 

532一部の MCP サーバーは、Dynamic Client Registration を通じた自動 OAuth セットアップをサポートしていません。「Incompatible auth server: does not support dynamic client registration」のようなエラーが表示される場合、サーバーは事前設定された認証情報が必要です。Claude Code は Client ID Metadata Document(CIMD)を使用するサーバーもサポートしており、これらを自動的に検出します。自動検出に失敗した場合は、まずサーバーの開発者ポータルを通じて OAuth アプリを登録し、サーバーを追加するときに認証情報を提供してください。576一部の MCP サーバーは、Dynamic Client Registration を通じた自動 OAuth セットアップをサポートしていません。「Incompatible auth server: does not support dynamic client registration」のようなエラーが表示される場合、サーバーは事前設定された認証情報が必要です。Claude Code は Client ID Metadata Document(CIMD)を使用するサーバーもサポートしており、これらを自動的に検出します。自動検出に失敗した場合は、まずサーバーの開発者ポータルを通じて OAuth アプリを登録し、サーバーを追加するときに認証情報を提供してください。

533 577 


598 * `claude mcp get <name>` を使用して、OAuth 認証情報がサーバーに設定されていることを確認してください642 * `claude mcp get <name>` を使用して、OAuth 認証情報がサーバーに設定されていることを確認してください

599</Tip>643</Tip>

600 644 

601### OAuth メタデータ検出をオーバーライドする645<h3 id="override-oauth-metadata-discovery">

646 OAuth メタデータ検出をオーバーライドする

647</h3>

602 648 

603Claude Code を特定の OAuth 認可サーバーメタデータ URL に指定して、デフォルトの検出チェーンをバイパスします。MCP サーバーの標準エンドポイントがエラーになる場合、または内部プロキシを通じて検出をルーティングしたい場合に設定します。デフォルトでは、Claude Code は最初に RFC 9728 保護リソースメタデータを `/.well-known/oauth-protected-resource` でチェックし、次に RFC 8414 認可サーバーメタデータを `/.well-known/oauth-authorization-server` でフォールバックします。649Claude Code を特定の OAuth 認可サーバーメタデータ URL に指定して、デフォルトの検出チェーンをバイパスします。MCP サーバーの標準エンドポイントがエラーになる場合、または内部プロキシを通じて検出をルーティングしたい場合に設定します。デフォルトでは、Claude Code は最初に RFC 9728 保護リソースメタデータを `/.well-known/oauth-protected-resource` でチェックし、次に RFC 8414 認可サーバーメタデータを `/.well-known/oauth-authorization-server` でフォールバックします。

604 650 


620 666 

621URL は `https://` を使用する必要があります。`authServerMetadataUrl` には Claude Code v2.1.64 以降が必要です。メタデータ URL の `scopes_supported` は、アップストリームサーバーがアドバタイズするスコープをオーバーライドします。667URL は `https://` を使用する必要があります。`authServerMetadataUrl` には Claude Code v2.1.64 以降が必要です。メタデータ URL の `scopes_supported` は、アップストリームサーバーがアドバタイズするスコープをオーバーライドします。

622 668 

623### OAuth スコープを制限する669<h3 id="restrict-oauth-scopes">

670 OAuth スコープを制限する

671</h3>

624 672 

625`oauth.scopes` を設定して、認可フロー中に Claude Code がリクエストするスコープをピン留めします。これは、アップストリーム認可サーバーがより多くのスコープをアドバタイズする場合に、MCP サーバーをセキュリティチームが承認したサブセットに制限するサポートされた方法です。値は RFC 6749 §3.3 の `scope` パラメータ形式と一致する単一のスペース区切り文字列です。673`oauth.scopes` を設定して、認可フロー中に Claude Code がリクエストするスコープをピン留めします。これは、アップストリーム認可サーバーがより多くのスコープをアドバタイズする場合に、MCP サーバーをセキュリティチームが承認したサブセットに制限するサポートされた方法です。値は RFC 6749 §3.3 の `scope` パラメータ形式と一致する単一のスペース区切り文字列です。

626 674 


644 692 

645サーバーが後で `insufficient_scope` の 403 を返す場合、Claude Code は同じピン留めされたスコープで再認証します。必要なツールが pin の外側のスコープを必要とする場合は、`oauth.scopes` を拡張してください。693サーバーが後で `insufficient_scope` の 403 を返す場合、Claude Code は同じピン留めされたスコープで再認証します。必要なツールが pin の外側のスコープを必要とする場合は、`oauth.scopes` を拡張してください。

646 694 

647### カスタム認証用の動的ヘッダーを使用する695<h3 id="use-dynamic-headers-for-custom-authentication">

696 カスタム認証用の動的ヘッダーを使用する

697</h3>

648 698 

649MCP サーバーが OAuth 以外の認証スキーム(Kerberos、短期トークン、内部 SSO など)を使用する場合、`headersHelper` を使用して接続時にリクエストヘッダーを生成します。Claude Code はコマンドを実行し、その出力を接続ヘッダーにマージします。699MCP サーバーが OAuth 以外の認証スキーム(Kerberos、短期トークン、内部 SSO など)を使用する場合、`headersHelper` を使用して接続時にリクエストヘッダーを生成します。Claude Code はコマンドを実行し、その出力を接続ヘッダーにマージします。

650 700 


695 `headersHelper` は任意のシェルコマンドを実行します。プロジェクトまたはローカルスコープで定義されている場合、ワークスペース信頼ダイアログを受け入れた後にのみ実行されます。745 `headersHelper` は任意のシェルコマンドを実行します。プロジェクトまたはローカルスコープで定義されている場合、ワークスペース信頼ダイアログを受け入れた後にのみ実行されます。

696</Note>746</Note>

697 747 

698## JSON 設定から MCP サーバーを追加する748<h2 id="add-mcp-servers-from-json-configuration">

749 JSON 設定から MCP サーバーを追加する

750</h2>

699 751 

700MCP サーバーの JSON 設定がある場合は、直接追加できます:752MCP サーバーの JSON 設定がある場合は、直接追加できます:

701 753 


731 * `--scope user` を使用して、プロジェクト固有のサーバーの代わりにユーザー設定にサーバーを追加できます783 * `--scope user` を使用して、プロジェクト固有のサーバーの代わりにユーザー設定にサーバーを追加できます

732</Tip>784</Tip>

733 785 

734## Claude Desktop から MCP サーバーをインポートする786<h2 id="import-mcp-servers-from-claude-desktop">

787 Claude Desktop から MCP サーバーをインポートする

788</h2>

735 789 

736Claude Desktop で MCP サーバーを既に設定している場合は、それらをインポートできます:790Claude Desktop で MCP サーバーを既に設定している場合は、それらをインポートできます:

737 791 


764 * 同じ名前のサーバーが既に存在する場合、数値サフィックスが付与されます(例:`server_1`)818 * 同じ名前のサーバーが既に存在する場合、数値サフィックスが付与されます(例:`server_1`)

765</Tip>819</Tip>

766 820 

767## Claude.ai から MCP サーバーを使用する821<h2 id="use-mcp-servers-from-claude-ai">

822 Claude.ai から MCP サーバーを使用する

823</h2>

768 824 

769[Claude.ai](https://claude.ai) アカウントで Claude Code にログインしている場合、Claude.ai で追加した MCP サーバーは Claude Code で自動的に利用可能です:825[Claude.ai](https://claude.ai) アカウントで Claude Code にログインしている場合、Claude.ai で追加した MCP サーバーは Claude Code で自動的に利用可能です:

770 826 


794 850 

795Claude Code で追加したサーバーは、同じ URL を指す claude.ai コネクタより [優先](#scope-hierarchy-and-precedence) されます。この場合、`/mcp` はコネクタを非表示としてリストし、代わりにコネクタを使用する場合は重複を削除する方法を表示します。851Claude Code で追加したサーバーは、同じ URL を指す claude.ai コネクタより [優先](#scope-hierarchy-and-precedence) されます。この場合、`/mcp` はコネクタを非表示としてリストし、代わりにコネクタを使用する場合は重複を削除する方法を表示します。

796 852 

853Microsoft 365、Gmail、Google Calendar などの一部の Anthropic ホスト型コネクタは、アップストリーム ID プロバイダーが claude.ai が登録したリダイレクト URL のみを受け入れるため、Claude Code からのローカル OAuth をサポートしていません。v2.1.162 以降、これらのホストのいずれかを `/mcp` で認証すると、代わりに claude.ai の Settings → Connectors で接続するよう指示するメッセージが表示されます。そこで接続されると、コネクタは Claude Code に自動的に表示されます。

854 

797Claude Code で claude.ai MCP サーバーを無効にするには、`ENABLE_CLAUDEAI_MCP_SERVERS` 環境変数を `false` に設定します:855Claude Code で claude.ai MCP サーバーを無効にするには、`ENABLE_CLAUDEAI_MCP_SERVERS` 環境変数を `false` に設定します:

798 856 

799```bash theme={null}857```bash theme={null}

800ENABLE_CLAUDEAI_MCP_SERVERS=false claude858ENABLE_CLAUDEAI_MCP_SERVERS=false claude

801```859```

802 860 

803## Claude Code を MCP サーバーとして使用する861<h2 id="use-claude-code-as-an-mcp-server">

862 Claude Code を MCP サーバーとして使用する

863</h2>

804 864 

805Claude Code 自体を MCP サーバーとして使用でき、他のアプリケーションが接続できます:865Claude Code 自体を MCP サーバーとして使用でき、他のアプリケーションが接続できます:

806 866 


859 * この MCP サーバーは Claude Code のツールのみを MCP クライアントに公開しているため、独自のクライアントは個々のツール呼び出しのユーザー確認を実装する責任があります。919 * この MCP サーバーは Claude Code のツールのみを MCP クライアントに公開しているため、独自のクライアントは個々のツール呼び出しのユーザー確認を実装する責任があります。

860</Tip>920</Tip>

861 921 

862## MCP 出力制限と警告922<h2 id="mcp-output-limits-and-warnings">

923 MCP 出力制限と警告

924</h2>

863 925 

864MCP ツールが大きな出力を生成する場合、Claude Code はトークン使用量を管理して、会話コンテキストが圧倒されるのを防ぐのに役立ちます:926MCP ツールが大きな出力を生成する場合、Claude Code はトークン使用量を管理して、会話コンテキストが圧倒されるのを防ぐのに役立ちます:

865 927 


881* 詳細なレポートまたはドキュメントを生成する943* 詳細なレポートまたはドキュメントを生成する

882* 広範なログファイルまたはデバッグ情報を処理する944* 広範なログファイルまたはデバッグ情報を処理する

883 945 

884### 特定のツールの制限を引き上げる946<h3 id="raise-the-limit-for-a-specific-tool">

947 特定のツールの制限を引き上げる

948</h3>

885 949 

886MCP サーバーを構築している場合、ツールの `tools/list` 応答エントリで `_meta["anthropic/maxResultSizeChars"]` を設定することで、個々のツールがデフォルトの永続化ディスク閾値より大きい結果を返すことを許可できます。Claude Code はそのツールの閾値を注釈付き値に引き上げます。最大 500,000 文字のハードシーリングまで。950MCP サーバーを構築している場合、ツールの `tools/list` 応答エントリで `_meta["anthropic/maxResultSizeChars"]` を設定することで、個々のツールがデフォルトの永続化ディスク閾値より大きい結果を返すことを許可できます。Claude Code はそのツールの閾値を注釈付き値に引き上げます。最大 500,000 文字のハードシーリングまで。

887 951 


903 特定の MCP サーバーで出力警告が頻繁に発生する場合は、`MAX_MCP_OUTPUT_TOKENS` 制限を増やすことを検討してください。制御していないサーバーの場合は、サーバー作成者に `anthropic/maxResultSizeChars` 注釈を追加するか、応答をページネーションするよう依頼することもできます。注釈は画像コンテンツを返すツールには影響しません。これらの場合、`MAX_MCP_OUTPUT_TOKENS` を引き上げることが唯一のオプションです。967 特定の MCP サーバーで出力警告が頻繁に発生する場合は、`MAX_MCP_OUTPUT_TOKENS` 制限を増やすことを検討してください。制御していないサーバーの場合は、サーバー作成者に `anthropic/maxResultSizeChars` 注釈を追加するか、応答をページネーションするよう依頼することもできます。注釈は画像コンテンツを返すツールには影響しません。これらの場合、`MAX_MCP_OUTPUT_TOKENS` を引き上げることが唯一のオプションです。

904</Warning>968</Warning>

905 969 

906## MCP 応答要求に対応する970<h2 id="respond-to-mcp-elicitation-requests">

971 MCP 応答要求に対応する

972</h2>

907 973 

908MCP サーバーはタスク中に構造化された入力をあなたに要求するための応答要求を使用できます。サーバーが独自に取得できない情報が必要な場合、Claude Code は対話的なダイアログを表示し、あなたの応答をサーバーに返します。設定は不要です。応答要求ダイアログはサーバーが要求したときに自動的に表示されます。974MCP サーバーはタスク中に構造化された入力をあなたに要求するための応答要求を使用できます。サーバーが独自に取得できない情報が必要な場合、Claude Code は対話的なダイアログを表示し、あなたの応答をサーバーに返します。設定は不要です。応答要求ダイアログはサーバーが要求したときに自動的に表示されます。

909 975 


912* **フォームモード**:Claude Code はサーバーで定義されたフォームフィールド(例:ユーザー名とパスワードプロンプト)を含むダイアログを表示します。フィールドに入力して送信します。978* **フォームモード**:Claude Code はサーバーで定義されたフォームフィールド(例:ユーザー名とパスワードプロンプト)を含むダイアログを表示します。フィールドに入力して送信します。

913* **URL モード**:Claude Code はブラウザ URL を開いて認証または承認を行います。ブラウザでフローを完了し、CLI で確認します。979* **URL モード**:Claude Code はブラウザ URL を開いて認証または承認を行います。ブラウザでフローを完了し、CLI で確認します。

914 980 

915応答要求に自動応答するには、[`Elicitation` フック](/ja/hooks#Elicitation)を使用してください。981応答要求に自動応答するには、[`Elicitation` フック](/ja/hooks#elicitation)を使用してください。

916 982 

917MCP サーバーを構築していて応答要求を使用する場合は、[MCP 応答要求仕様](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation)を参照してプロトコルの詳細とスキーマの例を確認してください。983MCP サーバーを構築していて応答要求を使用する場合は、[MCP 応答要求仕様](https://modelcontextprotocol.io/docs/learn/client-concepts#elicitation)を参照してプロトコルの詳細とスキーマの例を確認してください。

918 984 

919## MCP リソースを使用する985<h2 id="use-mcp-resources">

986 MCP リソースを使用する

987</h2>

920 988 

921MCP サーバーはリソースを公開でき、ファイルを参照する方法と同様に @ メンションを使用して参照できます。989MCP サーバーはリソースを公開でき、ファイルを参照する方法と同様に @ メンションを使用して参照できます。

922 990 

923### MCP リソースを参照する991<h3 id="reference-mcp-resources">

992 MCP リソースを参照する

993</h3>

924 994 

925<Steps>995<Steps>

926 <Step title="利用可能なリソースをリストする">996 <Step title="利用可能なリソースをリストする">


931 `@server:protocol://resource/path` の形式を使用してリソースを参照します:1001 `@server:protocol://resource/path` の形式を使用してリソースを参照します:

932 1002 

933 ```text theme={null}1003 ```text theme={null}

934 @github:issue://123 を分析して修正を提案できますか?1004 Can you analyze @github:issue://123 and suggest a fix?

935 ```1005 ```

936 1006 

937 ```text theme={null}1007 ```text theme={null}

938 @docs:file://api/authentication の API ドキュメントをレビューしてください1008 Please review the API documentation at @docs:file://api/authentication

939 ```1009 ```

940 </Step>1010 </Step>

941 1011 


943 1 つのプロンプトで複数のリソースを参照できます:1013 1 つのプロンプトで複数のリソースを参照できます:

944 1014 

945 ```text theme={null}1015 ```text theme={null}

946 @postgres:schema://users @docs:file://database/user-model を比較してください1016 Compare @postgres:schema://users with @docs:file://database/user-model

947 ```1017 ```

948 </Step>1018 </Step>

949</Steps>1019</Steps>


957 * リソースには、MCP サーバーが提供するあらゆるタイプのコンテンツ(テキスト、JSON、構造化データなど)を含めることができます1027 * リソースには、MCP サーバーが提供するあらゆるタイプのコンテンツ(テキスト、JSON、構造化データなど)を含めることができます

958</Tip>1028</Tip>

959 1029 

960## MCP ツール検索でスケーリングする1030<h2 id="scale-with-mcp-tool-search">

1031 MCP ツール検索でスケーリングする

1032</h2>

961 1033 

962ツール検索は MCP コンテキスト使用量を低く保つことで、ツール定義をオンデマンドで遅延させます。セッション開始時にはツール名とサーバー命令のみがロードされるため、より多くの MCP サーバーを追加してもコンテキストウィンドウへの影響は最小限です。1034ツール検索は MCP コンテキスト使用量を低く保つことで、ツール定義をオンデマンドで遅延させます。セッション開始時にはツール名とサーバー命令のみがロードされるため、より多くの MCP サーバーを追加してもコンテキストウィンドウへの影響は最小限です。Claude Code は固定のサーバーごとのツール上限を課しません。実用的な制限はコンテキストウィンドウの予算です。

963 1035 

964### 仕組み1036<h3 id="how-it-works">

1037 仕組み

1038</h3>

965 1039 

966ツール検索はデフォルトで有効です。MCP ツールは事前にコンテキストにロードされるのではなく、遅延されます。Claude はタスクが必要な場合、検索ツールを使用して関連する MCP ツールを検出します。Claude が実際に使用するツールのみがコンテキストに入ります。あなたの視点からは、MCP ツールは以前と同じように機能します。1040ツール検索はデフォルトで有効です。MCP ツールは事前にコンテキストにロードされるのではなく、遅延されます。Claude はタスクが必要な場合、検索ツールを使用して関連する MCP ツールを検出します。Claude が実際に使用するツールのみがコンテキストに入ります。あなたの視点からは、MCP ツールは以前と同じように機能します。

967 1041 

968しきい値ベースのロードを優先する場合は、`ENABLE_TOOL_SEARCH=auto` を設定して、コンテキストウィンドウの 10% 以内に収まる場合はスキーマを事前にロードし、オーバーフローのみを遅延させます。すべてのオプションについては、[ツール検索の設定](#configure-tool-search)を参照してください。1042しきい値ベースのロードを優先する場合は、`ENABLE_TOOL_SEARCH=auto` を設定して、コンテキストウィンドウの 10% 以内に収まる場合はスキーマを事前にロードし、オーバーフローのみを遅延させます。すべてのオプションについては、[ツール検索の設定](#configure-tool-search)を参照してください。

969 1043 

970### MCP サーバー作成者向け1044<h3 id="for-mcp-server-authors">

1045 MCP サーバー作成者向け

1046</h3>

971 1047 

972MCP サーバーを構築している場合、ツール検索が有効になっているとサーバー命令フィールドがより有用になります。サーバー命令は、[スキル](/ja/skills)の仕組みと同様に、Claude がいつサーバーのツールを検索するかを理解するのに役立ちます。1048MCP サーバーを構築している場合、ツール検索が有効になっているとサーバー命令フィールドがより有用になります。サーバー命令は、[スキル](/ja/skills)の仕組みと同様に、Claude がいつサーバーのツールを検索するかを理解するのに役立ちます。

973 1049 


979 1055 

980Claude Code はツール説明とサーバー命令を各 2KB で切り詰めます。切り詰めを避けるために簡潔に保ち、重要な詳細を最初に配置してください。1056Claude Code はツール説明とサーバー命令を各 2KB で切り詰めます。切り詰めを避けるために簡潔に保ち、重要な詳細を最初に配置してください。

981 1057 

982### ツール検索を設定する1058<h3 id="configure-tool-search">

1059 ツール検索を設定する

1060</h3>

983 1061 

984ツール検索はデフォルトで有効です:MCP ツールは遅延され、オンデマンドで検出されます。Claude Code は Vertex AI ではデフォルトで無効にします。`ANTHROPIC_BASE_URL` が非ファーストパーティホストを指している場合も無効です。ほとんどのプロキシは `tool_reference` ブロックを転送しないためです。`ENABLE_TOOL_SEARCH` を明示的に設定して、いずれかのフォールバックをオーバーライドしてください。1062ツール検索はデフォルトで有効です:MCP ツールは遅延され、オンデマンドで検出されます。Claude Code は Vertex AI ではデフォルトで無効にします。`ANTHROPIC_BASE_URL` が非ファーストパーティホストを指している場合も無効です。ほとんどのプロキシは `tool_reference` ブロックを転送しないためです。`ENABLE_TOOL_SEARCH` を明示的に設定して、いずれかのフォールバックをオーバーライドしてください。

985 1063 

986ツール検索には、`tool_reference` ブロックをサポートするモデルが必要です:Sonnet 4 以降、または Opus 4 以降。Haiku モデルはツール検索をサポートしていません。Vertex AI では、Claude Sonnet 4.5 以降および Claude Opus 4.5 以降でツール検索がサポートされています。1064ツール検索には、`tool_reference` ブロックをサポートするモデルが必要です。Haiku モデルはツール検索をサポートしていません。Vertex AI では、Claude Sonnet 4.5 以降および Claude Opus 4.5 以降でツール検索がサポートされています。

987 1065 

988`ENABLE_TOOL_SEARCH` 環境変数でツール検索の動作を制御します:1066`ENABLE_TOOL_SEARCH` 環境変数でツール検索の動作を制御します:

989 1067 


1015}1093}

1016```1094```

1017 1095 

1018### サーバーを遅延から除外する1096<h3 id="exempt-a-server-from-deferral">

1097 サーバーを遅延から除外する

1098</h3>

1019 1099 

1020サーバーのツールが検索ステップなしで常に Claude に表示される場合は、そのサーバーの設定で `alwaysLoad` を `true` に設定します。そのサーバーのすべてのツールは、`ENABLE_TOOL_SEARCH` 設定に関係なく、セッション開始時にコンテキストにロードされます。これは、Claude がすべてのターンで必要とする少数のツールに使用してください。各事前ロードツールはコンテキストを消費するため、会話に利用可能なコンテキストが減少します。1100サーバーのツールが検索ステップなしで常に Claude に表示される場合は、そのサーバーの設定で `alwaysLoad` を `true` に設定します。そのサーバーのすべてのツールは、`ENABLE_TOOL_SEARCH` 設定に関係なく、セッション開始時にコンテキストにロードされます。これは、Claude がすべてのターンで必要とする少数のツールに使用してください。各事前ロードツールはコンテキストを消費するため、会話に利用可能なコンテキストが減少します。

1021 1101 


1037 1117 

1038`alwaysLoad: true` を設定すると、サーバーが接続されるまでスタートアップもブロックされます。これは標準的な 5 秒の接続タイムアウトでキャップされます。これは MCP スタートアップが[デフォルトではノンブロッキング](/ja/env-vars)である場合でも適用されます。ツールは最初のプロンプトが構築されるときに存在する必要があるためです。他のサーバーはバックグラウンドで接続し続けます。1118`alwaysLoad: true` を設定すると、サーバーが接続されるまでスタートアップもブロックされます。これは標準的な 5 秒の接続タイムアウトでキャップされます。これは MCP スタートアップが[デフォルトではノンブロッキング](/ja/env-vars)である場合でも適用されます。ツールは最初のプロンプトが構築されるときに存在する必要があるためです。他のサーバーはバックグラウンドで接続し続けます。

1039 1119 

1040## MCP プロンプトをコマンドとして使用する1120<h2 id="use-mcp-prompts-as-commands">

1121 MCP プロンプトをコマンドとして使用する

1122</h2>

1041 1123 

1042MCP サーバーはプロンプトを公開でき、Claude Code でコマンドとして利用可能になります。1124MCP サーバーはプロンプトを公開でき、Claude Code でコマンドとして利用可能になります。

1043 1125 

1044### MCP プロンプトを実行する1126<h3 id="execute-mcp-prompts">

1127 MCP プロンプトを実行する

1128</h3>

1045 1129 

1046<Steps>1130<Steps>

1047 <Step title="利用可能なプロンプトを検出する">1131 <Step title="利用可能なプロンプトを検出する">


1076 * サーバーとプロンプト名は正規化されます(スペースはアンダースコアになります)1160 * サーバーとプロンプト名は正規化されます(スペースはアンダースコアになります)

1077</Tip>1161</Tip>

1078 1162 

1079## 管理対象 MCP 設定1163<h2 id="managed-mcp-configuration">

1164 管理対象 MCP 設定

1165</h2>

1080 1166 

1081MCP サーバーへのアクセスを集中管理する必要がある組織の場合は、[管理対象 MCP 設定](/ja/managed-mcp)を参照してください。`managed-mcp.json` を使用した固定サーバーセットのデプロイ、`allowedMcpServers` と `deniedMcpServers` によるサーバーの制限、およびサーバーがブロックされた場合にユーザーに表示される内容について説明しています。1167MCP サーバーへのアクセスを集中管理する必要がある組織の場合は、[管理対象 MCP 設定](/ja/managed-mcp)を参照してください。`managed-mcp.json` を使用した固定サーバーセットのデプロイ、`allowedMcpServers` と `deniedMcpServers` によるサーバーの制限、およびサーバーがブロックされた場合にユーザーに表示される内容について説明しています。

memory.md +94 −34

Details

14このページでは、以下の方法について説明します。14このページでは、以下の方法について説明します。

15 15 

16* [CLAUDE.md ファイルを書いて整理する](#claude-md-files)16* [CLAUDE.md ファイルを書いて整理する](#claude-md-files)

17* [`.claude/rules/` で特定のファイルタイプにルールをスコープする](#organize-rules-with-clauderules)17* [`.claude/rules/` で特定のファイルタイプにルールをスコープする](#organize-rules-with-claude/rules/)

18* [自動メモリを設定する](#auto-memory)ので Claude が自動的にメモを取ります18* [自動メモリを設定する](#auto-memory)ので Claude が自動的にメモを取ります

19* [指示が従われていない場合のトラブルシューティング](#troubleshoot-memory-issues)19* [指示が従われていない場合のトラブルシューティング](#troubleshoot-memory-issues)

20 20 

21## CLAUDE.md と自動メモリ21<h2 id="claude-md-vs-auto-memory">

22 CLAUDE.md と自動メモリ

23</h2>

22 24 

23Claude Code には 2 つの相互補完的なメモリシステムがあります。どちらも各会話の開始時に読み込まれます。Claude はこれらをコンテキストとして扱い、強制的な設定ではありません。指示がより具体的で簡潔であるほど、Claude はそれに従う可能性が高くなります。アクションをブロックするには、Claude の判断に関わらず [PreToolUse hook](/ja/hooks-guide) を使用してください。25Claude Code には 2 つの相互補完的なメモリシステムがあります。どちらも各会話の開始時に読み込まれます。Claude はこれらをコンテキストとして扱い、強制的な設定ではありません。アクションをブロックするには、Claude の判断に関わらず [PreToolUse hook](/ja/hooks-guide) を使用してください。より具体的で簡潔な指示ほど、Claude はそれに従う可能性が高くなります。

24 26 

25| | CLAUDE.md ファイル | 自動メモリ |27| | CLAUDE.md ファイル | 自動メモリ |

26| :----------- | :---------------------------- | :----------------------------- |28| :----------- | :---------------------------- | :----------------------------- |


34 36 

35Subagent も独自の自動メモリを保持できます。詳細については、[subagent 設定](/ja/sub-agents#enable-persistent-memory)を参照してください。37Subagent も独自の自動メモリを保持できます。詳細については、[subagent 設定](/ja/sub-agents#enable-persistent-memory)を参照してください。

36 38 

37## CLAUDE.md ファイル39<h2 id="claude-md-files">

40 CLAUDE.md ファイル

41</h2>

38 42 

39CLAUDE.md ファイルは、プロジェクト、個人的なワークフロー、または組織全体に対して Claude に永続的な指示を与えるマークダウンファイルです。これらのファイルをプレーンテキストで書きます。Claude は各セッションの開始時にそれらを読みます。43CLAUDE.md ファイルは、プロジェクト、個人的なワークフロー、または組織全体に対して Claude に永続的な指示を与えるマークダウンファイルです。これらのファイルをプレーンテキストで書きます。Claude は各セッションの開始時にそれらを読みます。

40 44 

41### CLAUDE.md をいつ追加するか45<h3 id="when-to-add-to-claude-md">

46 CLAUDE.md をいつ追加するか

47</h3>

42 48 

43CLAUDE.md を、そうでなければ再度説明する場所として扱います。以下の場合に追加します。49CLAUDE.md を、そうでなければ再度説明する場所として扱います。以下の場合に追加します。

44 50 


49 55 

50Claude がすべてのセッションで保持すべき事実に限定します。ビルドコマンド、規約、プロジェクトレイアウト、「常に X を実行する」ルール。エントリが複数ステップの手順である場合、またはコードベースの 1 つの部分にのみ関連する場合は、代わりに [skill](/ja/skills) または [パススコープルール](#organize-rules-with-claude/rules/) に移動します。[拡張機能の概要](/ja/features-overview#build-your-setup-over-time)では、各メカニズムをいつ使用するかについて説明しています。56Claude がすべてのセッションで保持すべき事実に限定します。ビルドコマンド、規約、プロジェクトレイアウト、「常に X を実行する」ルール。エントリが複数ステップの手順である場合、またはコードベースの 1 つの部分にのみ関連する場合は、代わりに [skill](/ja/skills) または [パススコープルール](#organize-rules-with-claude/rules/) に移動します。[拡張機能の概要](/ja/features-overview#build-your-setup-over-time)では、各メカニズムをいつ使用するかについて説明しています。

51 57 

52### CLAUDE.md ファイルをどこに配置するかを選択する58<h3 id="choose-where-to-put-claude-md-files">

59 CLAUDE.md ファイルをどこに配置するかを選択する

60</h3>

53 61 

54CLAUDE.md ファイルはいくつかの場所に配置でき、それぞれ異なるスコープを持ちます。下の表はそれらを読み込み順序で列挙しており、最も広いスコープから最も具体的なものまでなので、プロジェクト指示はユーザー指示の後にコンテキストに表示されます。62CLAUDE.md ファイルはいくつかの場所に配置でき、それぞれ異なるスコープを持ちます。下の表はそれらを読み込み順序で列挙しており、最も広いスコープから最も具体的なものまでなので、プロジェクト指示はユーザー指示の後にコンテキストに表示されます。

55 63 


64 72 

65大規模なプロジェクトの場合、[プロジェクトルール](#organize-rules-with-claude/rules/)を使用してトピック固有のファイルに指示を分割できます。ルールを使用すると、特定のファイルタイプまたはサブディレクトリに指示をスコープできます。73大規模なプロジェクトの場合、[プロジェクトルール](#organize-rules-with-claude/rules/)を使用してトピック固有のファイルに指示を分割できます。ルールを使用すると、特定のファイルタイプまたはサブディレクトリに指示をスコープできます。

66 74 

67### プロジェクト CLAUDE.md を設定する75<h3 id="set-up-a-project-claude-md">

76 プロジェクト CLAUDE.md を設定する

77</h3>

68 78 

69プロジェクト CLAUDE.md は `./CLAUDE.md` または `./.claude/CLAUDE.md` に保存できます。このファイルを作成し、プロジェクトで作業する誰もが適用できる指示を追加します。ビルドおよびテストコマンド、コーディング標準、アーキテクチャの決定、命名規則、一般的なワークフロー。これらの指示はバージョン管理を通じてチームと共有されるため、個人的な好みではなくプロジェクトレベルの標準に焦点を当てます。79プロジェクト CLAUDE.md は `./CLAUDE.md` または `./.claude/CLAUDE.md` に保存できます。このファイルを作成し、プロジェクトで作業する誰もが適用できる指示を追加します。ビルドおよびテストコマンド、コーディング標準、アーキテクチャの決定、命名規則、一般的なワークフロー。これらの指示はバージョン管理を通じてチームと共有されるため、個人的な好みではなくプロジェクトレベルの標準に焦点を当てます。

70 80 


74 `CLAUDE_CODE_NEW_INIT=1` を設定して、対話的なマルチフェーズフローを有効にします。`/init` は、どのアーティファクトを設定するかを尋ねます。CLAUDE.md ファイル、skills、および hooks。その後、subagent でコードベースを探索し、フォローアップの質問を通じてギャップを埋め、ファイルを書く前に確認可能な提案を提示します。84 `CLAUDE_CODE_NEW_INIT=1` を設定して、対話的なマルチフェーズフローを有効にします。`/init` は、どのアーティファクトを設定するかを尋ねます。CLAUDE.md ファイル、skills、および hooks。その後、subagent でコードベースを探索し、フォローアップの質問を通じてギャップを埋め、ファイルを書く前に確認可能な提案を提示します。

75</Tip>85</Tip>

76 86 

77### 効果的な指示を書く87<h3 id="write-effective-instructions">

88 効果的な指示を書く

89</h3>

78 90 

79CLAUDE.md ファイルは各セッションの開始時にコンテキストウィンドウに読み込まれ、会話と一緒にトークンを消費します。[コンテキストウィンドウの可視化](/ja/context-window)は、CLAUDE.md がスタートアップコンテキストの残りの部分に相対的にどこに読み込まれるかを示します。これらはコンテキストであり強制的な設定ではないため、指示の書き方は Claude がそれに従う信頼性に影響します。具体的で簡潔でよく構造化された指示が最適に機能します。91CLAUDE.md ファイルは各セッションの開始時にコンテキストウィンドウに読み込まれ、会話と一緒にトークンを消費します。[コンテキストウィンドウの可視化](/ja/context-window)は、CLAUDE.md がスタートアップコンテキストの残りの部分に相対的にどこに読み込まれるかを示します。これらはコンテキストであり強制的な設定ではないため、指示の書き方は Claude がそれに従う信頼性に影響します。具体的で簡潔でよく構造化された指示が最適に機能します。

80 92 


90 102 

91**一貫性**: 2 つのルールが互いに矛盾している場合、Claude は 1 つを任意に選択する可能性があります。CLAUDE.md ファイル、サブディレクトリ内のネストされた CLAUDE.md ファイル、および [`.claude/rules/`](#organize-rules-with-claude/rules/) を定期的に確認して、古い指示または矛盾する指示を削除します。モノレポでは、[`claudeMdExcludes`](#exclude-specific-claude-md-files) を使用して、作業に関連のない他のチームの CLAUDE.md ファイルをスキップします。103**一貫性**: 2 つのルールが互いに矛盾している場合、Claude は 1 つを任意に選択する可能性があります。CLAUDE.md ファイル、サブディレクトリ内のネストされた CLAUDE.md ファイル、および [`.claude/rules/`](#organize-rules-with-claude/rules/) を定期的に確認して、古い指示または矛盾する指示を削除します。モノレポでは、[`claudeMdExcludes`](#exclude-specific-claude-md-files) を使用して、作業に関連のない他のチームの CLAUDE.md ファイルをスキップします。

92 104 

93### 追加ファイルをインポートする105<h3 id="import-additional-files">

106 追加ファイルをインポートする

107</h3>

94 108 

95CLAUDE.md ファイルは `@path/to/import` 構文を使用して追加ファイルをインポートできます。インポートされたファイルは展開され、それらを参照する CLAUDE.md と一緒に起動時にコンテキストに読み込まれます。109CLAUDE.md ファイルは `@path/to/import` 構文を使用して追加ファイルをインポートできます。インポートされたファイルは展開され、それらを参照する CLAUDE.md と一緒に起動時にコンテキストに読み込まれます。

96 110 


120 134 

121指示を整理するためのより構造化されたアプローチについては、[`.claude/rules/`](#organize-rules-with-claude/rules/)を参照してください。135指示を整理するためのより構造化されたアプローチについては、[`.claude/rules/`](#organize-rules-with-claude/rules/)を参照してください。

122 136 

123### AGENTS.md137<h3 id="agents-md">

138 AGENTS.md

139</h3>

124 140 

125Claude Code は `CLAUDE.md` を読みます。`AGENTS.md` ではありません。リポジトリが既に他のコーディングエージェント用に `AGENTS.md` を使用している場合、`CLAUDE.md` を作成してそれをインポートし、両方のツールが重複なしに同じ指示を読むようにします。Claude 固有の指示をインポートの下に追加することもできます。Claude はインポートされたファイルをセッション開始時に読み込み、その後残りを追加します。141Claude Code は `CLAUDE.md` を読みます。`AGENTS.md` ではありません。リポジトリが既に他のコーディングエージェント用に `AGENTS.md` を使用している場合、`CLAUDE.md` を作成してそれをインポートし、両方のツールが重複なしに同じ指示を読むようにします。Claude 固有の指示をインポートの下に追加することもできます。Claude はインポートされたファイルをセッション開始時に読み込み、その後残りを追加します。

126 142 


140 156 

141Windows では、シンボリックリンクを作成するには管理者権限または開発者モードが必要なため、代わりに `@AGENTS.md` インポートを使用します。157Windows では、シンボリックリンクを作成するには管理者権限または開発者モードが必要なため、代わりに `@AGENTS.md` インポートを使用します。

142 158 

143既に `AGENTS.md` を持つリポジトリで [`/init`](/ja/commands) を実行すると、それを読み込み、関連する部分を生成された `CLAUDE.md` に組み込みます。また、`.cursorrules``.windsurfrules` などの他のツール設定も読み込みます。159既に `AGENTS.md` を持つリポジトリで [`/init`](/ja/commands) を実行すると、それを読み込み、関連する部分を生成された `CLAUDE.md` に組み込みます。また、`.cursorrules``.devin/rules/`、`.windsurfrules` などの他のツール設定も読み込みます。

144 160 

145### CLAUDE.md ファイルの読み込み方法161<h3 id="how-claude-md-files-load">

162 CLAUDE.md ファイルの読み込み方法

163</h3>

146 164 

147Claude Code は現在のワーキングディレクトリからディレクトリツリーを上に歩き、途中の各ディレクトリをチェックして `CLAUDE.md` および `CLAUDE.local.md` ファイルを探します。つまり、`foo/bar/` で Claude Code を実行すると、`foo/bar/CLAUDE.md`、`foo/CLAUDE.md`、およびそれらと一緒にある `CLAUDE.local.md` ファイルから指示を読み込みます。165Claude Code は現在のワーキングディレクトリからディレクトリツリーを上に歩き、途中の各ディレクトリをチェックして `CLAUDE.md` および `CLAUDE.local.md` ファイルを探します。つまり、`foo/bar/` で Claude Code を実行すると、`foo/bar/CLAUDE.md`、`foo/CLAUDE.md`、およびそれらと一緒にある `CLAUDE.local.md` ファイルから指示を読み込みます。

148 166 


154 172 

155CLAUDE.md ファイル内のブロックレベル HTML コメント(`<!-- maintainer notes -->`)は、コンテンツが Claude のコンテキストに注入される前に削除されます。コンテキストトークンを費やさずに人間のメンテナーのためにメモを残すために使用します。コードブロック内のコメントは保持されます。Read ツールで CLAUDE.md ファイルを直接開くと、コメントは表示されたままになります。173CLAUDE.md ファイル内のブロックレベル HTML コメント(`<!-- maintainer notes -->`)は、コンテンツが Claude のコンテキストに注入される前に削除されます。コンテキストトークンを費やさずに人間のメンテナーのためにメモを残すために使用します。コードブロック内のコメントは保持されます。Read ツールで CLAUDE.md ファイルを直接開くと、コメントは表示されたままになります。

156 174 

157#### 追加ディレクトリから読み込む175<h4 id="load-from-additional-directories">

176 追加ディレクトリから読み込む

177</h4>

158 178 

159`--add-dir` フラグは、メインワーキングディレクトリの外の追加ディレクトリへのアクセスを Claude に与えます。デフォルトでは、これらのディレクトリからの CLAUDE.md ファイルは読み込まれません。179`--add-dir` フラグは、メインワーキングディレクトリの外の追加ディレクトリへのアクセスを Claude に与えます。デフォルトでは、これらのディレクトリからの CLAUDE.md ファイルは読み込まれません。

160 180 


166 186 

167これは追加ディレクトリから `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。[`--setting-sources`](/ja/cli-reference)から `local` を除外する場合、`CLAUDE.local.md` はスキップされます。187これは追加ディレクトリから `CLAUDE.md`、`.claude/CLAUDE.md`、`.claude/rules/*.md`、および `CLAUDE.local.md` を読み込みます。[`--setting-sources`](/ja/cli-reference)から `local` を除外する場合、`CLAUDE.local.md` はスキップされます。

168 188 

169### `.claude/rules/` でルールを整理する189<h3 id="organize-rules-with-claude/rules/">

190 `.claude/rules/` でルールを整理する

191</h3>

170 192 

171大規模なプロジェクトの場合、`.claude/rules/` ディレクトリを使用して指示を複数のファイルに整理できます。これにより、指示がモジュール化され、チームが保守しやすくなります。ルールは[特定のファイルパスにスコープ](#path-specific-rules)することもできるため、Claude が一致するファイルで作業するときにのみコンテキストに読み込まれ、ノイズを減らしてコンテキストスペースを節約します。193大規模なプロジェクトの場合、`.claude/rules/` ディレクトリを使用して指示を複数のファイルに整理できます。これにより、指示がモジュール化され、チームが保守しやすくなります。ルールは[特定のファイルパスにスコープ](#path-specific-rules)することもできるため、Claude が一致するファイルで作業するときにのみコンテキストに読み込まれ、ノイズを減らしてコンテキストスペースを節約します。

172 194 


174 ルールは各セッションまたは一致するファイルが開かれたときにコンテキストに読み込まれます。常にコンテキストに必要ないタスク固有の指示については、[skills](/ja/skills)を使用してください。これは、呼び出すときまたは Claude がプロンプトに関連していると判断したときにのみ読み込まれます。196 ルールは各セッションまたは一致するファイルが開かれたときにコンテキストに読み込まれます。常にコンテキストに必要ないタスク固有の指示については、[skills](/ja/skills)を使用してください。これは、呼び出すときまたは Claude がプロンプトに関連していると判断したときにのみ読み込まれます。

175</Note>197</Note>

176 198 

177#### ルールを設定する199<h4 id="set-up-rules">

200 ルールを設定する

201</h4>

178 202 

179プロジェクトの `.claude/rules/` ディレクトリにマークダウンファイルを配置します。各ファイルは 1 つのトピックをカバーし、`testing.md` または `api-design.md` のような説明的なファイル名を持つ必要があります。すべての `.md` ファイルは再帰的に発見されるため、`frontend/` または `backend/` のようなサブディレクトリにルールを整理できます。203プロジェクトの `.claude/rules/` ディレクトリにマークダウンファイルを配置します。各ファイルは 1 つのトピックをカバーし、`testing.md` または `api-design.md` のような説明的なファイル名を持つ必要があります。すべての `.md` ファイルは再帰的に発見されるため、`frontend/` または `backend/` のようなサブディレクトリにルールを整理できます。

180 204 


190 214 

191[`paths` frontmatter](#path-specific-rules) のないルールは、`.claude/CLAUDE.md` と同じ優先度で起動時に読み込まれます。215[`paths` frontmatter](#path-specific-rules) のないルールは、`.claude/CLAUDE.md` と同じ優先度で起動時に読み込まれます。

192 216 

193#### パス固有のルール217<h4 id="path-specific-rules">

218 パス固有のルール

219</h4>

194 220 

195ルールは `paths` フィールドを持つ YAML frontmatter を使用して特定のファイルにスコープできます。これらの条件付きルールは、Claude が指定されたパターンに一致するファイルで作業するときにのみ適用されます。221ルールは `paths` フィールドを持つ YAML frontmatter を使用して特定のファイルにスコープできます。これらの条件付きルールは、Claude が指定されたパターンに一致するファイルで作業するときにのみ適用されます。

196 222 


229---255---

230```256```

231 257 

232#### シンボリックリンクでプロジェクト間でルールを共有する258<h4 id="share-rules-across-projects-with-symlinks">

259 シンボリックリンクでプロジェクト間でルールを共有する

260</h4>

233 261 

234`.claude/rules/` ディレクトリはシンボリックリンクをサポートしているため、共有ルールセットを保持し、複数のプロジェクトにリンクできます。シンボリックリンクは解決され、通常どおり読み込まれ、循環シンボリックリンクは検出され、適切に処理されます。262`.claude/rules/` ディレクトリはシンボリックリンクをサポートしているため、共有ルールセットを保持し、複数のプロジェクトにリンクできます。シンボリックリンクは解決され、通常どおり読み込まれ、循環シンボリックリンクは検出され、適切に処理されます。

235 263 


240ln -s ~/company-standards/security.md .claude/rules/security.md268ln -s ~/company-standards/security.md .claude/rules/security.md

241```269```

242 270 

243#### ユーザーレベルのルール271<h4 id="user-level-rules">

272 ユーザーレベルのルール

273</h4>

244 274 

245`~/.claude/rules/` の個人的なルールはマシン上のすべてのプロジェクトに適用されます。プロジェクト固有ではない好みに使用します。275`~/.claude/rules/` の個人的なルールはマシン上のすべてのプロジェクトに適用されます。プロジェクト固有ではない好みに使用します。

246 276 


252 282 

253ユーザーレベルのルールはプロジェクトルールの前に読み込まれ、プロジェクトルールに高い優先度を与えます。283ユーザーレベルのルールはプロジェクトルールの前に読み込まれ、プロジェクトルールに高い優先度を与えます。

254 284 

255### 大規模なチーム向けに CLAUDE.md を管理する285<h3 id="manage-claude-md-for-large-teams">

286 大規模なチーム向けに CLAUDE.md を管理する

287</h3>

256 288 

257Claude Code をチーム全体に展開する組織の場合、指示を一元化し、どの CLAUDE.md ファイルが読み込まれるかを制御できます。289Claude Code をチーム全体に展開する組織の場合、指示を一元化し、どの CLAUDE.md ファイルが読み込まれるかを制御できます。

258 290 

259#### 組織全体の CLAUDE.md を展開する291<h4 id="deploy-organization-wide-claude-md">

292 組織全体の CLAUDE.md を展開する

293</h4>

260 294 

261組織は、マシン上のすべてのユーザーに適用される一元管理の CLAUDE.md を展開できます。このファイルは個別の設定で除外することはできません。295組織は、マシン上のすべてのユーザーに適用される一元管理の CLAUDE.md を展開できます。このファイルは個別の設定で除外することはできません。

262 296 


302 336 

303設定ルールはクライアントによって強制され、Claude が何をするかに関係なく。CLAUDE.md 指示は Claude の動作を形作りますが、ハード強制レイヤーではありません。337設定ルールはクライアントによって強制され、Claude が何をするかに関係なく。CLAUDE.md 指示は Claude の動作を形作りますが、ハード強制レイヤーではありません。

304 338 

305#### 特定の CLAUDE.md ファイルを除外する339<h4 id="exclude-specific-claude-md-files">

340 特定の CLAUDE.md ファイルを除外する

341</h4>

306 342 

307大規模なモノレポでは、祖先 CLAUDE.md ファイルに作業に関連のない指示が含まれている可能性があります。`claudeMdExcludes` 設定を使用すると、パスまたはグロブパターンで特定のファイルをスキップできます。343大規模なモノレポでは、祖先 CLAUDE.md ファイルに作業に関連のない指示が含まれている可能性があります。`claudeMdExcludes` 設定を使用すると、パスまたはグロブパターンで特定のファイルをスキップできます。

308 344 


321 357 

322管理ポリシー CLAUDE.md ファイルは除外できません。これにより、個別の設定に関係なく、組織全体の指示が常に適用されることが保証されます。358管理ポリシー CLAUDE.md ファイルは除外できません。これにより、個別の設定に関係なく、組織全体の指示が常に適用されることが保証されます。

323 359 

324## 自動メモリ360<h2 id="auto-memory">

361 自動メモリ

362</h2>

325 363 

326自動メモリを使用すると、Claude は何も書かずにセッション間で知識を蓄積できます。Claude は作業中に自分自身のためにメモを保存します。ビルドコマンド、デバッグの洞察、アーキテクチャノート、コードスタイルの好み、ワークフローの習慣です。Claude はすべてのセッションで何かを保存するわけではありません。情報が将来の会話で役立つかどうかに基づいて、何を記憶する価値があるかを決定します。364自動メモリを使用すると、Claude は何も書かずにセッション間で知識を蓄積できます。Claude は作業中に自分自身のためにメモを保存します。ビルドコマンド、デバッグの洞察、アーキテクチャノート、コードスタイルの好み、ワークフローの習慣です。Claude はすべてのセッションで何かを保存するわけではありません。情報が将来の会話で役立つかどうかに基づいて、何を記憶する価値があるかを決定します。

327 365 


329 自動メモリには Claude Code v2.1.59 以降が必要です。`claude --version` でバージョンを確認してください。367 自動メモリには Claude Code v2.1.59 以降が必要です。`claude --version` でバージョンを確認してください。

330</Note>368</Note>

331 369 

332### 自動メモリを有効または無効にする370<h3 id="enable-or-disable-auto-memory">

371 自動メモリを有効または無効にする

372</h3>

333 373 

334自動メモリはデフォルトで有効です。切り替えるには、セッションで `/memory` を開き、自動メモリトグルを使用するか、プロジェクト設定で `autoMemoryEnabled` を設定します。374自動メモリはデフォルトで有効です。切り替えるには、セッションで `/memory` を開き、自動メモリトグルを使用するか、プロジェクト設定で `autoMemoryEnabled` を設定します。

335 375 


341 381 

342環境変数を使用して自動メモリを無効にするには、`CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` を設定します。382環境変数を使用して自動メモリを無効にするには、`CLAUDE_CODE_DISABLE_AUTO_MEMORY=1` を設定します。

343 383 

344### ストレージの場所384<h3 id="storage-location">

385 ストレージの場所

386</h3>

345 387 

346各プロジェクトは `~/.claude/projects/<project>/memory/` に独自のメモリディレクトリを取得します。`<project>` パスは git リポジトリから派生しているため、同じリポジトリ内のすべてのワーキングツリーとサブディレクトリは 1 つの自動メモリディレクトリを共有します。git リポジトリの外では、プロジェクトルートが代わりに使用されます。388各プロジェクトは `~/.claude/projects/<project>/memory/` に独自のメモリディレクトリを取得します。`<project>` パスは git リポジトリから派生しているため、同じリポジトリ内のすべてのワーキングツリーとサブディレクトリは 1 つの自動メモリディレクトリを共有します。git リポジトリの外では、プロジェクトルートが代わりに使用されます。

347 389 


369 411 

370自動メモリはマシンローカルです。同じ git リポジトリ内のすべてのワーキングツリーとサブディレクトリは 1 つの自動メモリディレクトリを共有します。ファイルはマシン間またはクラウド環境全体で共有されません。412自動メモリはマシンローカルです。同じ git リポジトリ内のすべてのワーキングツリーとサブディレクトリは 1 つの自動メモリディレクトリを共有します。ファイルはマシン間またはクラウド環境全体で共有されません。

371 413 

372### 仕組み414<h3 id="how-it-works">

415 仕組み

416</h3>

373 417 

374`MEMORY.md` の最初の 200 行、または最初の 25KB のいずれか先に来る方が、すべての会話の開始時に読み込まれます。そのしきい値を超えるコンテンツはセッション開始時に読み込まれません。Claude は詳細なメモを別のトピックファイルに移動することで、`MEMORY.md` を簡潔に保ちます。418`MEMORY.md` の最初の 200 行、または最初の 25KB のいずれか先に来る方が、すべての会話の開始時に読み込まれます。そのしきい値を超えるコンテンツはセッション開始時に読み込まれません。Claude は詳細なメモを別のトピックファイルに移動することで、`MEMORY.md` を簡潔に保ちます。

375 419 


379 423 

380Claude はセッション中にメモリファイルを読み書きします。Claude Code インターフェイスで「Writing memory」または「Recalled memory」が表示されたら、Claude は `~/.claude/projects/<project>/memory/` から積極的に更新または読み込みを行っています。424Claude はセッション中にメモリファイルを読み書きします。Claude Code インターフェイスで「Writing memory」または「Recalled memory」が表示されたら、Claude は `~/.claude/projects/<project>/memory/` から積極的に更新または読み込みを行っています。

381 425 

382### メモリを監査および編集する426<h3 id="audit-and-edit-your-memory">

427 メモリを監査および編集する

428</h3>

383 429 

384自動メモリファイルはプレーンマークダウンで、いつでも編集または削除できます。[`/memory`](#view-and-edit-with-memory) を実行して、セッション内からメモリファイルを参照して開きます。430自動メモリファイルはプレーンマークダウンで、いつでも編集または削除できます。[`/memory`](#view-and-edit-with-%2Fmemory) を実行して、セッション内からメモリファイルを参照して開きます。

385 431 

386## `/memory` で表示および編集する432<h2 id="view-and-edit-with-/memory">

433 `/memory` で表示および編集する

434</h2>

387 435 

388`/memory` コマンドは、現在のセッションに読み込まれたすべての CLAUDE.md、CLAUDE.local.md、およびルールファイルをリストし、自動メモリのオン/オフを切り替え、自動メモリフォルダを開くためのリンクを提供します。任意のファイルを選択してエディタで開きます。436`/memory` コマンドは、現在のセッションに読み込まれたすべての CLAUDE.md、CLAUDE.local.md、およびルールファイルをリストし、自動メモリのオン/オフを切り替え、自動メモリフォルダを開くためのリンクを提供します。任意のファイルを選択してエディタで開きます。

389 437 

390Claude に何かを記憶するよう求めるとき、「常に npm ではなく pnpm を使用する」または「API テストがローカル Redis インスタンスを必要とすることを覚えておく」のように、Claude はそれを自動メモリに保存します。代わりに CLAUDE.md に指示を追加するには、Claude に直接「これを CLAUDE.md に追加する」と尋ねるか、`/memory` を通じてファイルを自分で編集します。438Claude に何かを記憶するよう求めるとき、「常に npm ではなく pnpm を使用する」または「API テストがローカル Redis インスタンスを必要とすることを覚えておく」のように、Claude はそれを自動メモリに保存します。代わりに CLAUDE.md に指示を追加するには、Claude に直接「これを CLAUDE.md に追加する」と尋ねるか、`/memory` を通じてファイルを自分で編集します。

391 439 

392## メモリの問題をトラブルシューティングする440<h2 id="troubleshoot-memory-issues">

441 メモリの問題をトラブルシューティングする

442</h2>

393 443 

394これらは CLAUDE.md と自動メモリの最も一般的な問題と、それらをデバッグするための手順です。444これらは CLAUDE.md と自動メモリの最も一般的な問題と、それらをデバッグするための手順です。

395 445 

396### Claude が CLAUDE.md に従っていない446<h3 id="claude-isn’t-following-my-claude-md">

447 Claude が CLAUDE.md に従っていない

448</h3>

397 449 

398CLAUDE.md コンテンツはシステムプロンプト自体の一部ではなく、システムプロンプトの後のユーザーメッセージとして配信されます。Claude はそれを読んで従おうとしますが、特に曖昧または矛盾する指示の場合、厳密な遵守の保証はありません。450CLAUDE.md コンテンツはシステムプロンプト自体の一部ではなく、システムプロンプトの後のユーザーメッセージとして配信されます。Claude はそれを読んで従おうとしますが、特に曖昧または矛盾する指示の場合、厳密な遵守の保証はありません。

399 451 


412 [`InstructionsLoaded` hook](/ja/hooks#instructionsloaded) を使用して、どの指示ファイルが読み込まれているか、いつ読み込まれているか、なぜ読み込まれているかを正確にログに記録します。これはパス固有のルールまたはサブディレクトリ内のレイジーロードファイルをデバッグするのに役立ちます。464 [`InstructionsLoaded` hook](/ja/hooks#instructionsloaded) を使用して、どの指示ファイルが読み込まれているか、いつ読み込まれているか、なぜ読み込まれているかを正確にログに記録します。これはパス固有のルールまたはサブディレクトリ内のレイジーロードファイルをデバッグするのに役立ちます。

413</Tip>465</Tip>

414 466 

415### 自動メモリが何を保存したかわからない467<h3 id="i-don’t-know-what-auto-memory-saved">

468 自動メモリが何を保存したかわからない

469</h3>

416 470 

417`/memory` を実行し、自動メモリフォルダを選択して、Claude が保存したものを参照します。すべてはプレーンマークダウンで、読み取り、編集、または削除できます。471`/memory` を実行し、自動メモリフォルダを選択して、Claude が保存したものを参照します。すべてはプレーンマークダウンで、読み取り、編集、または削除できます。

418 472 

419### CLAUDE.md が大きすぎる473<h3 id="my-claude-md-is-too-large">

474 CLAUDE.md が大きすぎる

475</h3>

420 476 

421200 行を超えるファイルはより多くのコンテキストを消費し、遵守を減らす可能性があります。[パス固有のルール](#path-specific-rules)を使用して、Claude が一致するファイルで作業する場合にのみ指示を読み込むか、すべてのセッションで必要でないコンテンツをトリミングします。[`@path` インポート](#import-additional-files)に分割すると、組織化に役立ちますが、インポートされたファイルは起動時に読み込まれるため、コンテキストは削減されません。477200 行を超えるファイルはより多くのコンテキストを消費し、遵守を減らす可能性があります。[パス固有のルール](#path-specific-rules)を使用して、Claude が一致するファイルで作業する場合にのみ指示を読み込むか、すべてのセッションで必要でないコンテンツをトリミングします。[`@path` インポート](#import-additional-files)に分割すると、組織化に役立ちますが、インポートされたファイルは起動時に読み込まれるため、コンテキストは削減されません。

422 478 

423### `/compact` 後に指示が失われたようです479<h3 id="instructions-seem-lost-after-/compact">

480 `/compact` 後に指示が失われたようです

481</h3>

424 482 

425プロジェクトルート CLAUDE.md は圧縮を完全に生き残ります。`/compact` の後、Claude はディスクから CLAUDE.md を再度読み込み、セッションに新しく再注入します。サブディレクトリ内のネストされた CLAUDE.md ファイルは自動的に再注入されません。それらは Claude がそのサブディレクトリ内のファイルを読む次回に再度読み込まれます。483プロジェクトルート CLAUDE.md は圧縮を完全に生き残ります。`/compact` の後、Claude はディスクから CLAUDE.md を再度読み込み、セッションに新しく再注入します。サブディレクトリ内のネストされた CLAUDE.md ファイルは自動的に再注入されません。それらは Claude がそのサブディレクトリ内のファイルを読む次回に再度読み込まれます。

426 484 


428 486 

429[効果的な指示を書く](#write-effective-instructions)を参照して、サイズ、構造、および具体性に関するガイダンスを確認してください。487[効果的な指示を書く](#write-effective-instructions)を参照して、サイズ、構造、および具体性に関するガイダンスを確認してください。

430 488 

431## 関連リソース489<h2 id="related-resources">

490 関連リソース

491</h2>

432 492 

433* [設定をデバッグする](/ja/debug-your-config): CLAUDE.md または設定が有効にならない理由を診断する493* [設定をデバッグする](/ja/debug-your-config): CLAUDE.md または設定が有効にならない理由を診断する

434* [Skills](/ja/skills): オンデマンドで読み込まれる反復可能なワークフローをパッケージ化する494* [Skills](/ja/skills): オンデマンドで読み込まれる反復可能なワークフローをパッケージ化する

Details

6 6 

7> Microsoft Foundry を通じて Claude Code を構成する方法について学びます。セットアップ、構成、トラブルシューティングを含みます。7> Microsoft Foundry を通じて Claude Code を構成する方法について学びます。セットアップ、構成、トラブルシューティングを含みます。

8 8 

9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;

11 const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">

12 <line x1="5" y1="12" x2="19" y2="12" />

13 <polyline points="12 5 19 12 12 19" />

14 </svg>;

15 const STYLES = `

16.cc-cs {

17 --cs-slate: #141413;

18 --cs-clay: #d97757;

19 --cs-clay-deep: #c6613f;

20 --cs-gray-000: #ffffff;

21 --cs-gray-700: #3d3d3a;

22 --cs-border-default: rgba(31, 30, 29, 0.15);

23 font-family: inherit;

24}

25.dark .cc-cs {

26 --cs-slate: #f0eee6;

27 --cs-gray-000: #262624;

28 --cs-gray-700: #bfbdb4;

29 --cs-border-default: rgba(240, 238, 230, 0.14);

30}

31.cc-cs-card {

32 display: flex; align-items: center; justify-content: space-between;

33 gap: 16px; padding: 14px 16px; margin: 0;

34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);

35 border-radius: 8px; flex-wrap: wrap;

36}

37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }

38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }

39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }

40.cc-cs-btn-clay {

41 display: inline-flex; align-items: center; gap: 8px;

42 background: var(--cs-clay-deep); color: #fff; border: none;

43 border-radius: 8px; padding: 8px 14px;

44 font-size: 13px; font-weight: 500;

45 transition: background-color 0.15s; white-space: nowrap;

46}

47.cc-cs-btn-clay:hover { background: var(--cs-clay); }

48.cc-cs-btn-ghost {

49 display: inline-flex; align-items: center; gap: 8px;

50 background: transparent; color: var(--cs-gray-700);

51 border: 0.5px solid var(--cs-border-default);

52 border-radius: 8px; padding: 8px 14px;

53 font-size: 13px; font-weight: 500;

54}

55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }

56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }

57@media (max-width: 720px) {

58 .cc-cs-actions { width: 100%; }

59}

60`;

61 return <div className="cc-cs not-prose">

62 <style>{STYLES}</style>

63 <div className="cc-cs-card">

64 <div className="cc-cs-text">

65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.

66 </div>

67 <div className="cc-cs-actions">

68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">

69 View plans

70 </a>

71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">

72 Contact sales {iconArrowRight()}

73 </a>

74 </div>

75 </div>

76 </div>;

77};

78 

79<ContactSalesCard surface="foundry" />

80 

9<h2 id="prerequisites">81<h2 id="prerequisites">

10 前提条件82 前提条件

11</h2>83</h2>


17* Azure CLI がインストールされ、構成されている(オプション - 認証情報を取得する別のメカニズムがない場合のみ必要)89* Azure CLI がインストールされ、構成されている(オプション - 認証情報を取得する別のメカニズムがない場合のみ必要)

18 90 

19<Note>91<Note>

20 Claude Code を複数のユーザーにデプロイする場合は、[モデルバージョンをピン留めして](#4-pin-model-versions)、Anthropic が新しいモデルをリリースしたときの破損を防いでください92 Claude Code を複数のユーザーにデプロイする場合は、[モデルバージョンをピン留めして](#4-pin-model-versions)、ロールアウト前に実施してください

21</Note>93</Note>

22 94 

23<h2 id="setup">95<h2 id="setup">


90</h3>162</h3>

91 163 

92<Warning>164<Warning>

93 すべてのデプロイメントに対して特定のモデルバージョンをピン留めしてください。モデルエイリアス(`sonnet``opus`、`haiku`)をピン留めなしで使用する場合、Claude Code Foundry アカウントで利用できない新しいモデルバージョンを使用しようとする可能性がありAnthropic がアップデートをリリースしたときに既存のユーザーが破損します。Azure デプロイメントを作成するときは、「最新に自動更新」ではなく、特定のモデルバージョンを選択してください。165 すべてのデプロイメントに対して特定のモデルバージョンをピン留めしてください。ピン留めなしでは、`sonnet``opus` などのモデルエイリアスが Claude Code Foundry 用の組み込みデフォルトに解決されます。これは最新リリースより遅れている可能性がありアカウントでまだ利用できない場合があります。Foundry にはスタートアップモデルチェックがないため、デフォルトが利用できない場合、リクエストは失敗します。Azure デプロイメントを作成するときは、「最新に自動更新」ではなく、特定のモデルバージョンを選択してください。

94</Warning>166</Warning>

95 167 

96モデル変数をステップ 1 で作成したデプロイメント名と一致するように設定します。168モデル変数をステップ 1 で作成したデプロイメント名と一致するように設定します。

model-config.md +151 −29

Details

32| モデルエイリアス | 動作 |32| モデルエイリアス | 動作 |

33| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |33| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |

34| **`default`** | 特別な値で、モデルオーバーライドをクリアし、アカウントタイプに応じた推奨モデルに戻します。それ自体はモデルエイリアスではありません |34| **`default`** | 特別な値で、モデルオーバーライドをクリアし、アカウントタイプに応じた推奨モデルに戻します。それ自体はモデルエイリアスではありません |

35| **`best`** | 最も高性能な利用可能なモデルを使用します。現在は `opus` と同等です |35| **`best`** | 組織がアクセスできる場合は Fable 5 を使用し、そうでない場合は最新の Opus モデルを使用 |

36| **`fable`** | 最も難しく、実行時間が長いタスク用に Claude Fable 5 を使用 |

36| **`sonnet`** | 日常的なコーディングタスク用に最新の Sonnet モデルを使用 |37| **`sonnet`** | 日常的なコーディングタスク用に最新の Sonnet モデルを使用 |

37| **`opus`** | 複雑な推論タスク用に最新の Opus モデルを使用 |38| **`opus`** | 複雑な推論タスク用に最新の Opus モデルを使用 |

38| **`haiku`** | シンプルなタスク用に高速で効率的な Haiku モデルを使用 |39| **`haiku`** | シンプルなタスク用に高速で効率的な Haiku モデルを使用 |


48 Opus 4.8 には Claude Code v2.1.154 以降が必要です。`claude update` を実行してアップグレードしてください。49 Opus 4.8 には Claude Code v2.1.154 以降が必要です。`claude update` を実行してアップグレードしてください。

49</Note>50</Note>

50 51 

52<h3 id="work-with-fable-5">

53 Fable 5 を使用する

54</h3>

55 

56[Claude Fable 5](https://platform.claude.com/docs/ja/about-claude/models/introducing-claude-fable-5-and-claude-mythos-5) は Claude Code で最も高性能なモデルで、1 回のセッションより大きなタスクに適しています。長い自律的なセッションを維持し、行動する前に調査し、より小さなモデルよりも頻繁に作業を検証します。

57 

58Fable 5 はデフォルトモデルではありません。`/model fable` で選択してください。安全性分類器がフラグを立てるリクエスト(最も多くの場合、サイバーセキュリティと生物学の領域)は、[自動モデルフォールバック](#automatic-model-fallback)をトリガーします。

59 

60Fable 5 を最大限に活用するには:

61 

62* **結果を説明し、ステップではなく**:望む結果を渡し、パスを計画させます。その結果が成立するまで作業を続けさせるには、[目標を設定](/ja/goal)してください。

63* **曖昧な問題を渡す**:根本原因の調査、障害のデバッグ、アーキテクチャの決定は、追加の調査と検証が役に立つ場所です。

64* **検証リマインダーをスキップ**:独自の作業を検証するため、テストまたはチェックのリマインダーは通常不要です。

65* **より大きなタスクをサイズアップ**:通常は複数の部分に分割する作業を与えます。長いセッションを保持し、スレッドを失いません。

66 

67<Note>

68 Fable 5 には Claude Code v2.1.170 以降が必要です。古いバージョンではモデルピッカーに Fable 5 が表示されず、選択できません。`claude update` を実行してアップグレードしてください。Fable 5 は [ゼロデータ保持](/ja/zero-data-retention) では利用できません。ここで `/model` ピッカーはそれを省略するか、無効として表示します。

69</Note>

70 

51<h3 id="setting-your-model">71<h3 id="setting-your-model">

52 モデルの設定72 モデルの設定

53</h3>73</h3>


101 121 

102エンタープライズ管理者は、[管理設定またはポリシー設定](/ja/settings#settings-files) で `availableModels` を使用して、ユーザーが選択できるモデルを制限できます。122エンタープライズ管理者は、[管理設定またはポリシー設定](/ja/settings#settings-files) で `availableModels` を使用して、ユーザーが選択できるモデルを制限できます。

103 123 

104`availableModels` が設定されている場合、ユーザーは `/model`、`--model` フラグ、または `ANTHROPIC_MODEL` 環境変数を使用してリスト内にないモデルに切り替えることはできません124`availableModels` が設定されている場合、アローリストはユーザーがモデルを指定できるすべての場所に適用されます

125 

126* **メインセッションモデル**:`/model`、`--model` フラグ、および `ANTHROPIC_MODEL` 環境変数

127* **エイリアス解決**:{/* min-version: 2.1.176 */}`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`、および `ANTHROPIC_DEFAULT_FABLE_MODEL` 環境変数は、許可されたエイリアスをリスト外のモデルにリダイレクトすることはできません

128* **高速モード**:{/* min-version: 2.1.176 */}`/fast` は、リスト外の Opus モデルに暗黙的に切り替わる場合、「is not in your organization's allowed models」というメッセージで切り替えを拒否します

129* **サブエージェントモデル**:[サブエージェント](/ja/sub-agents#choose-a-model) frontmatter の `model` フィールド、Agent ツールの `model` パラメータ、`/agents` のモデルピッカー、および `CLAUDE_CODE_SUBAGENT_MODEL`

130* **アドバイザーモデル**:設定された [`advisorModel`](/ja/advisor) 設定

131* **フォールバックチェーン**:[フォールバックモデルチェーン](#fallback-model-chains) のリスト外の要素は削除されます

132 

133`/model` でブロックされたモデルに切り替えるとエラーで拒否されますが、ブロックされた `--model` フラグまたは `ANTHROPIC_MODEL` 値は起動時に警告とともに置き換えられ、要求されたモデルと置き換えられたモデルの両方を名前で示し、セッションはデフォルトモデルで開始されます。ブロックされたサブエージェントまたはアドバイザーのオーバーライドは、リクエストを失敗させるのではなく、継承またはデフォルトモデルにフォールバックします。

105 134 

106```json theme={null}135```json theme={null}

107{136{


113 デフォルトモデルの動作142 デフォルトモデルの動作

114</h3>143</h3>

115 144 

116モデルピッカーの Default オプションは `availableModels` の影響を受けません。常に利用可能であり、[ユーザーのサブスクリプション層に基づいた](#default-model-setting) システムのランタイムデフォルトを表します。145デフォルトでは、モデルピッカーの Default オプションは `availableModels` の影響を受けません。常に利用可能であり、[ユーザーのサブスクリプション層に基づいた](#default-model-setting) システムのランタイムデフォルトを表します。

117 146 

118`availableModels: []` の場合でもユーザーはそのティアの Default モデルで Claude Code を使用できます147アローリストを Default オプションに拡張するには、空でない `availableModels` リストと一緒に管理設定またはポリシー設定で `enforceAvailableModels` を `true` に設定します。ティアのデフォルトがアローリストにない場合、Default はティアのデフォルトではなく、最初に許可されたエントリに解決されます。これには Claude Code v2.1.175 以降が必要です

148 

149空の `availableModels` 配列は強制を実行しません。`availableModels: []` の場合でも、ユーザーは `enforceAvailableModels` に関係なく、そのティアの Default モデルで Claude Code を使用できます。

119 150 

120<h3 id="control-the-model-users-run-on">151<h3 id="control-the-model-users-run-on">

121 ユーザーが実行するモデルの制御152 ユーザーが実行するモデルの制御

122</h3>153</h3>

123 154 

124`model` 設定は初期選択であり、強制ではありません。セッション開始時にアクティブなモデルを設定しますが、ユーザーは `/model` を開いて Default を選択することができ、これはそのティアのシステムデフォルトに解決されます。`model` が何に設定されているかに関係なく。155`model` 設定は初期選択であり、強制ではありません。セッション開始時にアクティブなモデルを設定しますが、ユーザーは `/model` を開いて Default を選択することができ、これは `model` が何に設定されているかに関係なく、そのティアのシステムデフォルトに解決されます

125 156 

126モデル体験を完全に制御するには、3 つの設定を組み合わせます157モデル体験を完全に制御するには、これらの設定を組み合わせます

127 158 

128* **`availableModels`**:ユーザーが切り替えられるという名前のモデルを制限159* **`availableModels`**:ユーザーが切り替えられる名前付きモデルを制限

129* **`model`**:セッション開始時にアクティブなモデルを設定160* **`enforceAvailableModels`**:`availableModels` アローリストを Default オプションに拡張し、Default がリスト外のモデルに解決されないようにします

130* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`**:Default オプションと `sonnet`、`opus`、`haiku` エイリアスが解決するものを制御161* **`model`**:セッション開始時の初期モデル選択を設定

162* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**:Default オプションと `sonnet`、`opus`、`haiku`、`fable` エイリアスが解決するものを制御

131 163 

132この例では、ユーザーを Sonnet 4.5 で開始し、ピッカーを Sonnet と Haiku に制限し、Default を最新リリースではなく Sonnet 4.5 に解決するようにピン留めします164この例では、ユーザーを Sonnet 4.5 で開始し、ピッカーを Sonnet と Haiku に制限し、Default がティアのデフォルトではなくアローリスト上のモデルに解決されるようにします

133 165 

134```json theme={null}166```json theme={null}

135{167{

136 "model": "claude-sonnet-4-5",168 "model": "claude-sonnet-4-5",

137 "availableModels": ["claude-sonnet-4-5", "haiku"],169 "availableModels": ["claude-sonnet-4-5", "haiku"],

170 "enforceAvailableModels": true,

138 "env": {171 "env": {

139 "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"172 "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"

140 }173 }

141}174}

142```175```

143 176 

144`env` ブロックがない場合、ユーザーがピッカーで Default を選択すると、最新の Sonnet リリースが取得され、`model` と `availableModels` のバージョンピンがバイパスされます。177`enforceAvailableModels` または `env` ブロックがない場合、ユーザーがピッカーで Default を選択すると、そのティアの最新リリースが取得され、`model` と `availableModels` のバージョンピンがバイパスされます。2 つの設定は異なるスコープをカバーします。`enforceAvailableModels` は Default がアローリストに従うようにし、`env` ブロックは `sonnet` などの許可されたエイリアスが解決する特定のバージョンをピン留めします。モデルファミリーの制限で十分な場合は `enforceAvailableModels` のみを使用し、特定のバージョンをピン留めする必要がある場合は `env` ブロックを追加します。

145 178 

146<h3 id="merge-behavior">179<h3 id="merge-behavior">

147 マージ動作180 マージ動作

148</h3>181</h3>

149 182 

150`availableModels` がユーザー設定とプロジェクト設定など複数のレベルで設定されている場合配列はマージされ重複排除されます。厳密なアローリストを適用するには最優先度を持つ管理設定またはポリシー設定で `availableModels` を設定します183`availableModels` がユーザープロジェクトローカル設定のみで設定されている場合配列はこれらのレベル全体でマージされ、重複排除されます

184 

185`availableModels` が管理設定またはポリシー設定で設定されている場合、管理設定またはポリシー設定の値がマージされた結果全体を置き換えます。ユーザー設定またはプロジェクト設定で追加されたエントリはそれを拡張することはできません。管理設定とポリシー設定は `enforceAvailableModels` の下位優先度の値を同じ方法で置き換えます。Claude Code v2.1.175 以降では、これが厳密なアローリストを適用する唯一の方法です。以前のバージョンでは、管理リストを下位優先度のエントリとマージします。

151 186 

152<h3 id="mantle-model-ids">187<h3 id="mantle-model-ids">

153 Mantle モデル ID188 Mantle モデル ID

154</h3>189</h3>

155 190 

156[Bedrock Mantle エンドポイント](/ja/amazon-bedrock#use-the-mantle-endpoint) が有効な場合、`availableModels` の `anthropic.` で始まるエントリは、カスタムオプションとして `/model` ピッカーに追加され、Mantle エンドポイントにルーティングされます。これは [サードパーティデプロイメント用のモデルのピン留め](#pin-models-for-third-party-deployments) で説明されているエイリアスのみマッチングの例外です。設定はピッカーをリストされたエントリに制限するため、標準エイリアスと一緒に Mantle ID を含めます。191[Bedrock Mantle エンドポイント](/ja/amazon-bedrock#use-the-mantle-endpoint) が有効な場合、`availableModels` の `anthropic.` で始まるエントリは、カスタムオプションとして `/model` ピッカーに追加され、Mantle エンドポイントにルーティングされます。設定はピッカーをリストされたエントリに制限するため、標準エイリアスと一緒に Mantle ID を含めます。

157 192 

158<h2 id="special-model-behavior">193<h2 id="special-model-behavior">

159 特別なモデルの動作194 特別なモデルの動作


172 207 

173Enterprise 従量課金とは、サブスクリプションシートではなく使用量で請求される Enterprise 組織を意味します。208Enterprise 従量課金とは、サブスクリプションシートではなく使用量で請求される Enterprise 組織を意味します。

174 209 

175Claude Code Opus の使用量閾値に達した場合自動的に Sonnet にフォールバックする可能性があります210Fable 5 はどのアカウントタイプでもデフォルトモデルではありません。セッションは `/model fable``model` 設定または Fable 5 が利用可能な `best` エイリアスで選択した後にのみ Fable 5 を使用します`/model` で選択すると、ユーザー設定で選択されたモデルとして保存されるため、モデルを変更するまで後続のセッションは Fable 5 で開始されます。

176 211 

177<h3 id="opusplan-model-setting">212<h3 id="opusplan-model-setting">

178 `opusplan` モデル設定213 `opusplan` モデル設定


185 220 

186これにより、両方の長所が得られます。計画用の Opus の優れた推論と、実行用の Sonnet の効率性です。221これにより、両方の長所が得られます。計画用の Opus の優れた推論と、実行用の Sonnet の効率性です。

187 222 

188Plan Mode の Opus フェーズは標準的な 200K コンテキストウィンドウで実行されます。[拡張コンテキスト](#extended-context)で説明されている自動 1M アップグレードは `opus` モデル設定に適用され、`opusplan` には拡張されません223Plan Mode の Opus フェーズは `opus` モデル設定と同じコンテキストウィンドウを使用します。[自動アップグレード](#extended-context) Opus 1M コンテキストに自動アップグレードされるサブスクリプション層では、`opusplan` も Plan Mode でアップグレードを受け取ります。自動アップグレード層にない場合に両方のフェーズで 1M コンテキストを強制するにはモデルを `opusplan[1m]` に設定します

224 

225[`availableModels`](#restrict-model-selection)が Opus を除外する場合、`opusplan` は Plan Mode で切り替える代わりに Sonnet に留まります。Sonnet が除外される場合の暗黙的な Haiku から Sonnet への Plan Mode アップグレードにも同じことが適用されます。

226 

227Claude が Plan の境界ではなくタスク途中で 2 番目のモデルを参照するかどうかを決定するハイブリッドアプローチについては、[advisor tool](/ja/advisor)を参照してください。

228 

229<h3 id="fallback-model-chains">

230 フォールバックモデルチェーン

231</h3>

232 

233プライマリモデルが過負荷状態、利用不可、または別の再試行不可能なサーバーエラーを返す場合、Claude Code はリクエストを失敗させる代わりにフォールバックモデルに切り替えることができます。認証、請求、レート制限、リクエストサイズ、トランスポートエラーは切り替えをトリガーしません。これらは通常の再試行とエラー処理に従います。

234 

2351 つ以上のフォールバックモデルを設定し、Claude Code は順番に試行し、切り替え時に通知を表示します。切り替えは現在のターンのみ続くため、次のメッセージはプライマリモデルを最初に再度試行します。チェーンは重複排除後 3 つのモデルに制限され、余分なエントリは無視されます。

236 

237`--fallback-model` フラグを使用して 1 つのセッション用にチェーンを設定します。これはカンマ区切りリストを受け入れます。

238 

239```bash theme={null}

240claude --fallback-model sonnet,haiku

241```

242 

243セッション全体でチェーンを保持するには、[settings](/ja/settings)で `fallbackModel` を配列として設定します。

244 

245```json theme={null}

246{

247 "fallbackModel": ["claude-sonnet-4-6", "claude-haiku-4-5"]

248}

249```

250 

251`--fallback-model` フラグは `fallbackModel` 設定より優先されます。各要素はモデル名またはエイリアスを受け入れ、`"default"` はデフォルトモデルに展開されます。

252 

253要素がスキップされる 2 つのケース:

254 

255* **利用不可能なモデル**:設定にピン留めされた廃止されたモデルなど、到達できないモデルはスキップされ、Claude Code は次の要素に続きます。

256* **許可リストの外**:[`availableModels`](#restrict-model-selection)で許可されていない要素は、チェーンが読み込まれるときにドロップされ、試行されません。

257 

258<h3 id="automatic-model-fallback">

259 自動モデルフォールバック

260</h3>

261 

262このセクションは Fable 5 からのコンテンツベースのフォールバックをカバーしています。モデルが過負荷状態または利用不可の場合の可用性ベースのフォールバックについては、[フォールバックモデルチェーン](#fallback-model-chains)を参照してください。

263 

264Fable 5 はサイバーセキュリティと生物学コンテンツ用のセーフティ分類器で実行されます。分類器がリクエストにフラグを立てると、Claude Code はそのリクエストをデフォルト Opus モデルで再実行し、トランスクリプトに通知を表示します。Anthropic API と[LLM gateway](/ja/llm-gateway)デプロイメント上の Opus 4.8、または[Claude Platform on AWS](/ja/claude-platform-on-aws)上の Opus 4.7。

265 

266セッションはその Opus モデルで続行されます。Fable 5 に戻るには、`/model fable` を実行します。

267 

268<h4 id="check-what-triggered-fallback">

269 フォールバックをトリガーしたものを確認

270</h4>

271 

272フォールバックはセッションの最初のリクエストで、何か異常を送信する前にトリガーできます。最初のリクエストは CLAUDE.md コンテンツと git ステータスなどのワークスペースコンテキストを含むためです。セキュリティまたは生物学資料を含むリポジトリは、そのコンテキストだけで分類器をトリガーできます。

273 

274カスタマイズがトリガーかどうかを確認するには、`claude --safe-mode` でセッションを開始します。これは CLAUDE.md、skills、MCP サーバー、hooks などのカスタマイズを無効にします。Git ステータスとディレクトリ名はカスタマイズではなく、引き続き含まれます。

275 

276<h4 id="ask-before-switching">

277 切り替え前に確認

278</h4>

279 

280リクエストにフラグが立てられるたびに何が起こるかを決定するには、自動的に切り替える代わりに `/config` を実行し、「メッセージにフラグが立てられたときにモデルを切り替える」をオフにします。フラグが立てられたリクエストはセッションを一時停止し、2 つのオプションがあります。Opus モデルに切り替えるか、プロンプトを編集して Fable 5 で再試行します。

281 

282いくつかのケースは異なる動作をします。

283 

284* 両方のモデルが同じリクエストにフラグを立てた場合、プロンプトを編集して再試行するか、新しいセッションを開始できます。

285* モバイル[Claude Code on the web](/ja/claude-code-on-the-web)セッションでは、編集と再試行はサポートされていません。モデルを切り替えるか、デスクトップブラウザまたはデスクトップアプリからセッションを続行します。

286* [非対話モード](/ja/cli-reference#cli-flags)と、プロンプトを表示できない SDK 統合では、フラグが立てられたリクエストは拒否で終了します。

287 

288<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">

289 Bedrock、Vertex AI、Foundry でフォールバックを有効化

290</h4>

291 

292[Amazon Bedrock](/ja/amazon-bedrock)、[Google Vertex AI](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry)では、モデル ID はプロバイダー固有であるため、自動フォールバックは Claude Code が関連する両方のモデルを識別できる場合にのみ動作します。

293 

294* Claude Code は現在のモデルを Fable 5 として認識する必要があります。モデル ID に `claude-fable-5` が含まれるか、`ANTHROPIC_DEFAULT_FABLE_MODEL` の値と一致するか、[`modelOverrides`](#override-model-ids-per-version)でマップされています。

295* フォールバックターゲットは Opus モデルに解決される必要があります。`ANTHROPIC_DEFAULT_OPUS_MODEL` が設定されている場合はその値、それ以外はプロバイダーのモデルリストの Opus 4.8 エントリ。

296 

297どちらかのモデルが識別できない場合、Claude Code は自動的に切り替わりません。フラグが立てられたリクエストは拒否メッセージで終了し、[`/model`](#setting-your-model)でモデルを切り替えて再試行できます。これらのプロバイダーで自動フォールバックを有効にするには、`ANTHROPIC_DEFAULT_FABLE_MODEL` を Fable 5 モデル ID に、`ANTHROPIC_DEFAULT_OPUS_MODEL` を Opus 4.8 モデル ID に設定します。

298 

299<h4 id="security-research-and-biology-workloads">

300 セキュリティ研究と生物学ワークロード

301</h4>

302 

303攻撃的なセキュリティまたは生物学のワークロード(ペネトレーションテスト、Capture the Flag(CTF)演習、生物学隣接コードベースを含む)は頻繁にフォールバックをトリガーし、多くの場合最初のリクエストで。実質的な生物学作業の場合、ほぼすべてのリクエストが再ルーティングされることを期待してください。

304 

305これはこれらのドメイン用の予想されるルーティングであり、アカウントフラグではありません。組織がこの作業に Fable クラスの機能を必要とする場合、信頼されたアクセスプログラムについて Anthropic アカウントチームに問い合わせてください。

189 306 

190<h3 id="adjust-effort-level">307<h3 id="adjust-effort-level">

191 努力レベルの調整308 努力レベルの調整


197 314 

198| モデル | レベル |315| モデル | レベル |

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

317| Fable 5 | `low`、`medium`、`high`、`xhigh`、`max` |

200| Opus 4.8 と Opus 4.7 | `low`、`medium`、`high`、`xhigh`、`max` |318| Opus 4.8 と Opus 4.7 | `low`、`medium`、`high`、`xhigh`、`max` |

201| Opus 4.6 と Sonnet 4.6 | `low`、`medium`、`high`、`max` |319| Opus 4.6 と Sonnet 4.6 | `low`、`medium`、`high`、`max` |

202 320 

203アクティブなモデルがサポートしないレベルを設定した場合、Claude Code は設定したレベル以下の最高サポートレベルにフォールバックします。例えば、`xhigh` は Opus 4.6 では `high` として実行されます。321アクティブなモデルがサポートしないレベルを設定した場合、Claude Code は設定したレベル以下の最高サポートレベルにフォールバックします。例えば、`xhigh` は Opus 4.6 では `high` として実行されます。

204 322 

205デフォルト努力は Opus 4.8、Opus 4.6、Sonnet 4.6 では `high` で、Opus 4.7 では `xhigh` です。323デフォルト努力は Fable 5、Opus 4.8、Opus 4.6、Sonnet 4.6 では `high` で、Opus 4.7 では `xhigh` です。

206 324 

207Opus 4.8 または Opus 4.7 を初めて実行する場合、Claude Code は、別のモデルに対して以前に異なるレベルを設定していても、そのモデルのデフォルト努力を適用します。Opus 4.8 では `high`、Opus 4.7 では `xhigh` です。切り替え後に `/effort` を再度実行して、別のレベルを選択します。325Fable 5、Opus 4.8または Opus 4.7 を初めて実行する場合、Claude Code は、別のモデルに対して以前に異なるレベルを設定していても、そのモデルのデフォルト努力を適用します。Fable 5 と Opus 4.8 では `high`、Opus 4.7 では `xhigh` です。切り替え後に `/effort` を再度実行して、別のレベルを選択します。

208 326 

209`low`、`medium`、`high`、`xhigh` はセッション全体で保持されます。`max` はトークン支出に制約がない最も深い推論を提供し、`CLAUDE_CODE_EFFORT_LEVEL` 環境変数を通じて設定された場合を除き、現在のセッションのみに適用されます。327`low`、`medium`、`high`、`xhigh` はセッション全体で保持されます。`max` はトークン支出に制約がない最も深い推論を提供し、`CLAUDE_CODE_EFFORT_LEVEL` 環境変数を通じて設定された場合を除き、現在のセッションのみに適用されます。

210 328 


220| :---------- | :---------------------------------------------------------------------------------- |338| :---------- | :---------------------------------------------------------------------------------- |

221| `low` | インテリジェンスに敏感でない短くスコープされたレイテンシに敏感なタスク用に予約 |339| `low` | インテリジェンスに敏感でない短くスコープされたレイテンシに敏感なタスク用に予約 |

222| `medium` | インテリジェンスをトレードオフできるコスト敏感な作業のトークン使用量を削減 |340| `medium` | インテリジェンスをトレードオフできるコスト敏感な作業のトークン使用量を削減 |

223| `high` | トークン使用量とインテリジェンスのバランス。Opus 4.8、Opus 4.6、Sonnet 4.6 でのデフォルト |341| `high` | トークン使用量とインテリジェンスのバランス。Fable 5、Opus 4.8、Opus 4.6、Sonnet 4.6 でのデフォルト |

224| `xhigh` | より高いトークン支出での深い推論。Opus 4.7 でのデフォルト |342| `xhigh` | より高いトークン支出での深い推論。Opus 4.7 でのデフォルト |

225| `max` | 難しいタスクのパフォーマンスを改善できますが、収益逓減を示す可能性があり、過度な思考の傾向があります。広く採用する前にテスト |343| `max` | 難しいタスクのパフォーマンスを改善できますが、収益逓減を示す可能性があり、過度な思考の傾向があります。広く採用する前にテスト |

226| `ultracode` | 各実質的なタスク用に `xhigh` ごとのメッセージ推論で[動的ワークフロー](/ja/workflows)を計画する Claude Code 設定。セッションのみ |344| `ultracode` | 各実質的なタスク用に `xhigh` ごとのメッセージ推論で[動的ワークフロー](/ja/workflows)を計画する Claude Code 設定。セッションのみ |


256 374 

257適応的推論は各ステップで思考をオプションにするため、Claude はルーチンプロンプトにより速く応答でき、より深い思考から利益を得るステップのために深い思考を予約できます。現在のレベルが生成するよりも Claude がより頻繁に、またはより少なく思考することを望む場合、プロンプトまたは `CLAUDE.md` で直接そう言うことができます。モデルはその努力設定内でそのガイダンスに応答します。375適応的推論は各ステップで思考をオプションにするため、Claude はルーチンプロンプトにより速く応答でき、より深い思考から利益を得るステップのために深い思考を予約できます。現在のレベルが生成するよりも Claude がより頻繁に、またはより少なく思考することを望む場合、プロンプトまたは `CLAUDE.md` で直接そう言うことができます。モデルはその努力設定内でそのガイダンスに応答します。

258 376 

259Opus 4.7 以降は常に適応的推論を使用します。固定思考予算モードと `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` はそれに適用されません。377Opus 4.7 以降は常に適応的推論を使用します。Fable 5 も同様です。固定思考予算モードと `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` はそれに適用されません。

260 378 

261Opus 4.6 と Sonnet 4.6 では、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` を設定して、`MAX_THINKING_TOKENS` で制御される以前の固定思考予算に戻すことができます。[環境変数](/ja/env-vars)を参照してください。379Opus 4.6 と Sonnet 4.6 では、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` を設定して、`MAX_THINKING_TOKENS` で制御される以前の固定思考予算に戻すことができます。[環境変数](/ja/env-vars)を参照してください。

262 380 


267拡張思考は、Claude が応答する前に発する推論です。[適応的推論](#adjust-effort-level)をサポートするモデルでは、努力レベルは思考がどの程度発生するかの主要な制御です。以下の設定は思考をオンまたはオフにし、それがどのように表示されるかを制御します。385拡張思考は、Claude が応答する前に発する推論です。[適応的推論](#adjust-effort-level)をサポートするモデルでは、努力レベルは思考がどの程度発生するかの主要な制御です。以下の設定は思考をオンまたはオフにし、それがどのように表示されるかを制御します。

268 386 

269| 制御 | 設定方法 |387| 制御 | 設定方法 |

270| :------------ | :------------------------------------------------------------------------------------------------------------------ |388| :------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

271| 現在のセッションのトグル | macOS では `Option+T`、Windows と Linux では `Alt+T` を押します |389| 現在のセッションのトグル | macOS では `Option+T`、Windows と Linux では `Alt+T` を押します |

272| グローバルデフォルトを設定 | `/config` を実行して思考モードをトグルします。`~/.claude/settings.json` に `alwaysThinkingEnabled` として保存されます |390| グローバルデフォルトを設定 | `/config` を実行して思考モードをトグルします。`~/.claude/settings.json` に `alwaysThinkingEnabled` として保存されます |

273| 努力に関係なく無効化 | [`MAX_THINKING_TOKENS=0`](/ja/env-vars)を設定します。他の値は[固定思考予算](#adaptive-reasoning-and-fixed-thinking-budgets)でのみ適用されます |391| 努力に関係なく無効化 | [`MAX_THINKING_TOKENS=0`](/ja/env-vars)を設定します。これは Anthropic API 上の Fable 5 を除いて思考をオフにします。[サードパーティプロバイダー](/ja/third-party-integrations)ではこれは `thinking` パラメータを省略し、適応的推論モデルは引き続き思考する可能性があります。他の値は[固定思考予算](#adaptive-reasoning-and-fixed-thinking-budgets)でのみ適用されます |

392 

393思考は Fable 5 でオフにすることはできません。セッショントグル、`alwaysThinkingEnabled`、`MAX_THINKING_TOKENS=0` はそこに効果がなく、Fable 5 は努力レベルに基づいて各ステップでどの程度思考するかを決定します。

274 394 

275思考出力はデフォルトで折りたたまれています。`Ctrl+O` を押して詳細モードをトグルし、推論をグレーのイタリック体テキストとして表示します。Anthropic API 上のインタラクティブセッションはデフォルトで編集された思考ブロックを受け取るため、展開時に完全な要約を利用可能にしたい場合は[設定](/ja/settings)で `showThinkingSummaries: true` を設定します。折りたたまれたまたは編集された場合でも、生成されたすべての思考トークンに対して課金されます。395思考出力はデフォルトで折りたたまれています。`Ctrl+O` を押して詳細モードをトグルし、推論をグレーのイタリック体テキストとして表示します。Anthropic API 上のインタラクティブセッションはデフォルトで編集された思考ブロックを受け取るため、展開時に完全な要約を利用可能にしたい場合は[設定](/ja/settings)で `showThinkingSummaries: true` を設定します。折りたたまれたまたは編集された場合でも、生成されたすべての思考トークンに対して課金されます。

276 396 


278 拡張コンテキスト398 拡張コンテキスト

279</h3>399</h3>

280 400 

281Opus 4.6 以降と Sonnet 4.6 は、大規模なコードベースを持つ長いセッション用に[100 万トークンのコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。401Fable 5、Opus 4.6 以降、Sonnet 4.6 は、大規模なコードベースを持つ長いセッション用に[100 万トークンのコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。

282 402 

283利用可能性はモデルとプランによって異なります。Max、Team、Enterprise プランでは、Opus は追加設定なしで自動的に 1M コンテキストにアップグレードされます。これは Team Standard と Team Premium の両方のシートに適用されます。Sonnet with 1M context は自動アップグレードの一部ではなく、Max を含むすべてのサブスクリプションプランで[使用クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)が必要です。403利用可能性はモデルとプランによって異なります。Max、Team、Enterprise プランでは、Opus は追加設定なしで自動的に 1M コンテキストにアップグレードされます。これは Team Standard と Team Premium の両方のシートに適用されます。Anthropic API では、Fable 5、Opus 4.8、Opus 4.7 は常に 1M ウィンドウで実行されます。Sonnet with 1M context は自動アップグレードの一部ではなく、Max を含むすべてのサブスクリプションプランで[使用クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)が必要です。

284 404 

285| プラン | Opus with 1M context | Sonnet with 1M context |405| プラン | Opus with 1M context | Sonnet with 1M context |

286| ------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |406| ------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |


340 460 

341| 環境変数 | 説明 |461| 環境変数 | 説明 |

342| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |462| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

463| `ANTHROPIC_DEFAULT_FABLE_MODEL` | `fable` に使用するモデル、および Claude Code が [自動モデルフォールバック](#automatic-model-fallback) でサードパーティプロバイダーが Fable 5 として認識するモデル ID |

343| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` に使用するモデル、または Plan Mode がアクティブな場合の `opusplan` に使用するモデル。 |464| `ANTHROPIC_DEFAULT_OPUS_MODEL` | `opus` に使用するモデル、または Plan Mode がアクティブな場合の `opusplan` に使用するモデル。 |

344| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` に使用するモデル、または Plan Mode がアクティブでない場合の `opusplan` に使用するモデル。 |465| `ANTHROPIC_DEFAULT_SONNET_MODEL` | `sonnet` に使用するモデル、または Plan Mode がアクティブでない場合の `opusplan` に使用するモデル。 |

345| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` に使用するモデル、または [バックグラウンド機能](/ja/costs#background-token-usage) に使用するモデル |466| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | `haiku` に使用するモデル、または [バックグラウンド機能](/ja/costs#background-token-usage) に使用するモデル |


353 474 

354[Bedrock](/ja/amazon-bedrock)、[Vertex AI](/ja/google-vertex-ai)、[Foundry](/ja/microsoft-foundry)、または [Claude Platform on AWS](/ja/claude-platform-on-aws) を通じて Claude Code をデプロイする場合、ユーザーへのロールアウト前にモデルバージョンをピン留めします。475[Bedrock](/ja/amazon-bedrock)、[Vertex AI](/ja/google-vertex-ai)、[Foundry](/ja/microsoft-foundry)、または [Claude Platform on AWS](/ja/claude-platform-on-aws) を通じて Claude Code をデプロイする場合、ユーザーへのロールアウト前にモデルバージョンをピン留めします。

355 476 

356ピン留めなしでは、Claude Code はモデルエイリアス(`sonnet`、`opus`、`haiku`)を使用し最新バージョンに解決されます。Anthropic が新しいモデルをリリースすると新しいバージョンがまだユーザーのアカウントで有効になっていない場合、Bedrock と Vertex AI ユーザーは通知を見て、そのセッションの以前のバージョンにフォールバックしますが、Foundry ユーザーはエラーを見ます。Foundry には同等のスタートアップチェックがないためです。477ピン留めなしでは、Claude Code `fable`、`opus`、`sonnet`、`haiku` などのモデルエイリアスを使用し各プロバイダーの組み込みデフォルトモデル ID に解決されますそのデフォルトは最新の Anthropic リリースより遅れる可能性がありそれが指すモデルはまだユーザーのアカウントで有効になっていない可能性があります。デフォルトが利用できない場合、Bedrock と Vertex AI ユーザーは通知を見て、そのセッションの以前のバージョンにフォールバックしますが、Foundry ユーザーはエラーを見ます。Foundry には同等のスタートアップチェックがないためです。

357 478 

358<Warning>479<Warning>

359 初期セットアップの一部として、3 つのモデル環境変数すべてを特定のバージョン ID に設定します。ピン留めにより、ユーザーが新しいモデルに移行するタイミングを制御できます。480 初期セットアップの一部として、モデル環境変数を特定のバージョン ID に設定します。ピン留めにより、ユーザーが新しいモデルに移行するタイミングを制御できます。

360</Warning>481</Warning>

361 482 

362プロバイダーのバージョン固有のモデル ID を使用して、以下の環境変数を使用します。483プロバイダーのバージョン固有のモデル ID を使用して、以下の環境変数を使用します。


367| Vertex AI | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |488| Vertex AI | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

368| Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |489| Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

369 490 

370`ANTHROPIC_DEFAULT_SONNET_MODEL``ANTHROPIC_DEFAULT_HAIKU_MODEL` に同じパターンを適用します。すべてのプロバイダー全体の現在および従来のモデル ID については、[モデル概要](https://platform.claude.com/docs/ja/about-claude/models/overview) を参照してください。ユーザーを新しいモデルバージョンにアップグレードするには、これらの環境変数を更新して再デプロイします。491`ANTHROPIC_DEFAULT_FABLE_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL``ANTHROPIC_DEFAULT_HAIKU_MODEL` に同じパターンを適用します。すべてのプロバイダー全体の現在および従来のモデル ID については、[モデル概要](https://platform.claude.com/docs/ja/about-claude/models/overview) を参照してください。ユーザーを新しいモデルバージョンにアップグレードするには、これらの環境変数を更新して再デプロイします。

371 492 

372ピン留めされたモデルの [拡張コンテキスト](#extended-context) を有効にするには、`ANTHROPIC_DEFAULT_OPUS_MODEL` または `ANTHROPIC_DEFAULT_SONNET_MODEL` のモデル ID に `[1m]` を追加します。493ピン留めされたモデルの [拡張コンテキスト](#extended-context) を有効にするには、`ANTHROPIC_DEFAULT_OPUS_MODEL` または `ANTHROPIC_DEFAULT_SONNET_MODEL` のモデル ID に `[1m]` を追加します。

373 494 


375export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'496export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8[1m]'

376```497```

377 498 

378`[1m]` サフィックスは、`opus` と `sonnet` エイリアスのすべての使用に 1M コンテキストウィンドウを適用します。これは `opusplan` の plan-mode Opus フェーズを拡張しません。これは [200K で上限が設定されたままです](#opusplan-model-setting)。499`[1m]` サフィックスは、`opus` と `sonnet` エイリアスのすべての使用に 1M コンテキストウィンドウを適用します。これには [`opusplan`](#opusplan-model-setting) の plan-mode Opus フェーズが含まれます

379 500 

380* Claude Code は、モデル ID をプロバイダーに送信する前にサフィックスを削除します。501* Claude Code は、モデル ID をプロバイダーに送信する前にサフィックスを削除します。

381* 基盤となるモデルが [1M コンテキストをサポート](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window) する場合にのみ `[1m]` を追加します。502* 基盤となるモデルが [1M コンテキストをサポート](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window) する場合にのみ `[1m]` を追加します。

382* サフィックスはモデルごとではなく、変数ごとに読み取られます。Bedrock、Vertex、Foundry では、1 つの変数で `[1m]` なしのモデル ID は、別の変数が同じモデルをサフィックス付きで設定している場合でも、200K コンテキストを使用します。503* サフィックスはモデルごとではなく、変数ごとに読み取られます。Bedrock、Vertex、Foundry では、1 つの変数で `[1m]` なしのモデル ID は、別の変数が同じモデルをサフィックス付きで設定している場合でも、200K コンテキストを使用します。

383 504 

384<Note>505<Note>

385 `settings.availableModels` アローリストは、サードパーティプロバイダーを使用する場合でも適用されます。フィルタリングはプロバイダー固有のモデル ID ではなく、モデルエイリアス(`opus`、`sonnet`、`haiku`で一致します。506 `settings.availableModels` アローリストは、サードパーティプロバイダーを使用する場合でも適用されます。フィルタリングは `opus`、`sonnet`、`haiku`、`fable` などのモデルエイリアス、`claude-opus-4-8` などのバージョンプレフィックス、または完全なモデル ID で一致します。任意の `[1m]` サフィックスはアローリストエントリと要求されたモデルの両方から削除されるため、`claude-opus-4-8` のエントリは標準と 1M コンテキスト Opus の両方の行を許可します。`us.anthropic.` などのプロバイダー固有のプレフィックスは削除されません。ピッカーが表示する同じ形式を `availableModels` にリストするか、[`modelOverrides`](#override-model-ids-per-version) を通じてマップします。

386</Note>507</Note>

387 508 

388<h3 id="customize-pinned-model-display-and-capabilities">509<h3 id="customize-pinned-model-display-and-capabilities">


399| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` ピッカーでピン留めされた Opus モデルの表示説明。設定されていない場合は `Custom Opus model` がデフォルト |520| `ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION` | `/model` ピッカーでピン留めされた Opus モデルの表示説明。設定されていない場合は `Custom Opus model` がデフォルト |

400| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Opus モデルがサポートする機能のカンマ区切りリスト |521| `ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES` | ピン留めされた Opus モデルがサポートする機能のカンマ区切りリスト |

401 522 

402同じ `_NAME`、`_DESCRIPTION`、`_SUPPORTED_CAPABILITIES` サフィックスは `ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`、`ANTHROPIC_CUSTOM_MODEL_OPTION` で利用可能です。523同じ `_NAME`、`_DESCRIPTION`、`_SUPPORTED_CAPABILITIES` サフィックスは `ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`、`ANTHROPIC_DEFAULT_FABLE_MODEL`、`ANTHROPIC_CUSTOM_MODEL_OPTION` で利用可能です。

403 524 

404Claude Code は、モデル ID を既知のパターンと照合することで、[努力レベル](#adjust-effort-level) や [拡張思考](#extended-thinking) などの機能を有効にします。Bedrock ARN やカスタムデプロイメント名などのプロバイダー固有の ID は、これらのパターンと一致しないことが多く、サポートされている機能が無効のままになります。`_SUPPORTED_CAPABILITIES` を設定して、Claude Code にモデルが実際にサポートする機能を伝えます。525Claude Code は、モデル ID を既知のパターンと照合することで、[努力レベル](#adjust-effort-level) や [拡張思考](#extended-thinking) などの機能を有効にします。Bedrock ARN やカスタムデプロイメント名などのプロバイダー固有の ID は、これらのパターンと一致しないことが多く、サポートされている機能が無効のままになります。`_SUPPORTED_CAPABILITIES` を設定して、Claude Code にモデルが実際にサポートする機能を伝えます。

405 526 


463| `DISABLE_PROMPT_CACHING_HAIKU` | `1` に設定して、Haiku モデルのみのプロンプトキャッシングを無効にします |584| `DISABLE_PROMPT_CACHING_HAIKU` | `1` に設定して、Haiku モデルのみのプロンプトキャッシングを無効にします |

464| `DISABLE_PROMPT_CACHING_SONNET` | `1` に設定して、Sonnet モデルのみのプロンプトキャッシングを無効にします |585| `DISABLE_PROMPT_CACHING_SONNET` | `1` に設定して、Sonnet モデルのみのプロンプトキャッシングを無効にします |

465| `DISABLE_PROMPT_CACHING_OPUS` | `1` に設定して、Opus モデルのみのプロンプトキャッシングを無効にします |586| `DISABLE_PROMPT_CACHING_OPUS` | `1` に設定して、Opus モデルのみのプロンプトキャッシングを無効にします |

587| `DISABLE_PROMPT_CACHING_FABLE` | `1` に設定して、Fable モデルのみのプロンプトキャッシングを無効にします |

466 588 

467キャッシュ TTL を変更する方法、またはキャッシュミスをトリガーするものについて詳しくは、[Claude Code がプロンプトキャッシングを使用する方法](/ja/prompt-caching) を参照してください。589キャッシュ TTL を変更する方法、またはキャッシュミスをトリガーするものについて詳しくは、[Claude Code がプロンプトキャッシングを使用する方法](/ja/prompt-caching) を参照してください。

Details

65```65```

66 66 

67<Note>67<Note>

68 管理設定は MDM (Mobile Device Management) または他のデバイス管理ソリューションを通じて配布できます。管理設定ファイルで定義された環境変数は優先度が高く、ユーザーによってオーバーライドすることはできません。68 管理設定は MDMMobile Device Managementまたは他のデバイス管理ソリューションを通じて配布できます。管理設定ファイルで定義された環境変数は優先度が高く、ユーザーによってオーバーライドすることはできません。

69</Note>69</Note>

70 70 

71Claude Code は、Bash ツール、フック、MCP サーバー、言語サーバーを含む、生成するサブプロセスに `OTEL_*` 環境変数を渡しません。OpenTelemetry でインストルメント化されたアプリケーションを Bash ツール経由で実行する場合、Claude Code のエクスポーターエンドポイントまたはヘッダーを継承しないため、そのアプリケーションが独自のテレメトリをエクスポートする必要がある場合は、コマンド内でこれらの変数を直接設定してください。71Claude Code は、Bash ツール、フック、MCP サーバー、言語サーバーを含む、生成するサブプロセスに `OTEL_*` 環境変数を渡しません。OpenTelemetry でインストルメント化されたアプリケーションを Bash ツール経由で実行する場合、Claude Code のエクスポーターエンドポイントまたはヘッダーを継承しないため、そのアプリケーションが独自のテレメトリをエクスポートする必要がある場合は、コマンド内でこれらの変数を直接設定してください。


221**`claude_code.tool`**221**`claude_code.tool`**

222 222 

223| 属性 | 説明 | ゲート |223| 属性 | 説明 | ゲート |

224| ----------------- | ------------------------------------------------------------ | ----------------------- |224| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |

225| `tool_name` | ツール名 | |225| `tool_name` | ツール名 | |

226| `duration_ms` | 権限待機と実行を含む実時間 | |226| `duration_ms` | 権限待機と実行を含む実時間 | |

227| `result_tokens` | ツール結果のおおよそのトークンサイズ | |227| `result_tokens` | ツール結果のおおよそのトークンサイズ | |

228| `agent_id` | ツールを実行したサブエージェントまたはチームメイトの識別子。メインセッションでは存在しません | |228| `agent_id` | ツールを実行したサブエージェントまたはチームメイトの識別子。メインセッションでは存在しません | |

229| `parent_agent_id` | このエージェントを生成したエージェントの識別子。メインセッションおよびそこから直接生成されたエージェントでは存在しません | |229| `parent_agent_id` | このエージェントを生成したエージェントの識別子。メインセッションおよびそこから直接生成されたエージェントでは存在しません | |

230| `tool_use_id` | このコールのモデルの `tool_use` ブロック ID。[tool\_result](#tool-result-event) および [tool\_decision](#tool-decision-event) イベントおよびフックペイロード内の `tool_use_id` と一致するため、スパンをこれらのレコードに結合できます | |

231| `gen_ai.tool.call.id` | `tool_use_id` と同じ値。OpenTelemetry GenAI セマンティック規約 | |

230| `file_path` | Read、Edit、Write ツールのターゲットファイルパス | `OTEL_LOG_TOOL_DETAILS` |232| `file_path` | Read、Edit、Write ツールのターゲットファイルパス | `OTEL_LOG_TOOL_DETAILS` |

231| `full_command` | Bash ツールのコマンド文字列 | `OTEL_LOG_TOOL_DETAILS` |233| `full_command` | Bash ツールのコマンド文字列 | `OTEL_LOG_TOOL_DETAILS` |

232| `skill_name` | Skill ツールのスキル名 | `OTEL_LOG_TOOL_DETAILS` |234| `skill_name` | Skill ツールのスキル名 | `OTEL_LOG_TOOL_DETAILS` |


245**`claude_code.tool.execution`**247**`claude_code.tool.execution`**

246 248 

247| 属性 | 説明 | ゲート |249| 属性 | 説明 | ゲート |

248| ------------- | ------------------------------------------------------------------------------------ | ----------------------- |250| --------------------- | ------------------------------------------------------------------------------------ | ----------------------- |

249| `duration_ms` | ツール本体の実行に費やされた時間 | |251| `duration_ms` | ツール本体の実行に費やされた時間 | |

252| `tool_use_id` | 親 `claude_code.tool` スパンと同じ値 | |

253| `gen_ai.tool.call.id` | `tool_use_id` と同じ値。OpenTelemetry GenAI セマンティック規約 | |

250| `success` | `true` または `false` | |254| `success` | `true` または `false` | |

251| `error` | 実行が失敗した場合のエラーカテゴリ文字列。例: `Error:ENOENT` または `ShellError`。ゲートが設定されている場合は完全なエラーメッセージを含む | `OTEL_LOG_TOOL_DETAILS` |255| `error` | 実行が失敗した場合のエラーカテゴリ文字列。例: `Error:ENOENT` または `ShellError`。ゲートが設定されている場合は完全なエラーメッセージを含む | `OTEL_LOG_TOOL_DETAILS` |

252 256 


423すべてのメトリクスとイベントは、これらの標準属性を共有します:427すべてのメトリクスとイベントは、これらの標準属性を共有します:

424 428 

425| 属性 | 説明 | 制御者 |429| 属性 | 説明 | 制御者 |

426| ------------------------------------ | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |430| ------------------------------------ | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |

427| `session.id` | 一意のセッション識別子 | `OTEL_METRICS_INCLUDE_SESSION_ID` (デフォルト: true) |431| `session.id` | 一意のセッション識別子 | `OTEL_METRICS_INCLUDE_SESSION_ID` (デフォルト: true) |

428| `app.version` | 現在の Claude Code バージョン | `OTEL_METRICS_INCLUDE_VERSION` (デフォルト: false) |432| `app.version` | 現在の Claude Code バージョン | `OTEL_METRICS_INCLUDE_VERSION` (デフォルト: false) |

429| `app.entrypoint` | セッションがどのように起動されたか。例: `cli`、`sdk-cli`、`sdk-ts`、`sdk-py`、または `claude-vscode` | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (デフォルト: false) |433| `app.entrypoint` | セッションがどのように起動されたか。例: `cli`、`sdk-cli`、`sdk-ts`、`sdk-py`、または `claude-vscode` | `OTEL_METRICS_INCLUDE_ENTRYPOINT` (デフォルト: false) |

430| `organization.id` | 組織 UUID (認証時) | 利用可能な場合は常に含まれます |434| `organization.id` | 組織 UUID (認証時) | 利用可能な場合は常に含まれます |

431| `user.account_uuid` | アカウント UUID (認証時) | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (デフォルト: true) |435| `user.account_uuid` | アカウント UUID (認証時) | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (デフォルト: true) |

432| `user.account_id` | Anthropic 管理 API と一致するタグ付き形式のアカウント ID (認証時)。例: `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (デフォルト: true) |436| `user.account_id` | Anthropic 管理 API と一致するタグ付き形式のアカウント ID (認証時)。例: `user_01BWBeN28...` | `OTEL_METRICS_INCLUDE_ACCOUNT_UUID` (デフォルト: true) |

433| `user.id` | Claude Code インストールごとに生成される匿名デバイス/インストール識別子 | 常に含まれます |437| `user.id` | 初回実行時に生成され、`~/.claude.json` に保存される匿名識別子。個人情報は含まれず、Claude アカウントから派生していません。ファイルを削除すると、次回実行時に新しい無関係な値が生成されます。 | 常に含まれます |

434| `user.email` | ユーザーメールアドレス (OAuth 経由で認証時) | 利用可能な場合は常に含まれます |438| `user.email` | ユーザーメールアドレス (OAuth 経由で認証時) | 利用可能な場合は常に含まれます |

435| `terminal.type` | ターミナルタイプ。例: `iTerm.app`、`vscode`、`cursor`、`tmux` | 検出された場合は常に含まれます |439| `terminal.type` | ターミナルタイプ。例: `iTerm.app`、`vscode`、`cursor`、`tmux` | 検出された場合は常に含まれます |

436| Keys from `OTEL_RESOURCE_ATTRIBUTES` | カスタム属性 (例: `department` または `team.id`)。[マルチチームの組織サポート](#multi-team-organization-support)を参照してください | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (デフォルト: true) |440| Keys from `OTEL_RESOURCE_ATTRIBUTES` | カスタム属性 (例: `department` または `team.id`)。[マルチチームの組織サポート](#multi-team-organization-support)を参照してください | `OTEL_METRICS_INCLUDE_RESOURCE_ATTRIBUTES` (デフォルト: true) |


484 488 

485* すべての[標準属性](#standard-attributes)489* すべての[標準属性](#standard-attributes)

486* `type`: (`"added"`、`"removed"`)490* `type`: (`"added"`、`"removed"`)

491* `model`: 変更を行ったモデルのモデル識別子 (例: "claude-sonnet-4-6")。{/* min-version: 2.1.172 */}Claude Code v2.1.172 以降が必要です

487 492 

488<h4 id="pull-request-counter">493<h4 id="pull-request-counter">

489 プルリクエストカウンター494 プルリクエストカウンター


692* `effort`: リクエストに適用された[努力レベル](/ja/model-config#adjust-effort-level)。モデルが努力をサポートしない場合は存在しません。697* `effort`: リクエストに適用された[努力レベル](/ja/model-config#adjust-effort-level)。モデルが努力をサポートしない場合は存在しません。

693* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`: リクエストのスキル、プラグイン、エージェント、および MCP 属性。定義と編集動作については [コストカウンター](#cost-counter)を参照してください。698* `agent.name`、`skill.name`、`plugin.name`、`marketplace.name`、`mcp_server.name`、`mcp_tool.name`: リクエストのスキル、プラグイン、エージェント、および MCP 属性。定義と編集動作については [コストカウンター](#cost-counter)を参照してください。

694 699 

700<h4 id="api-refusal-event">

701 API 拒否イベント

702</h4>

703 

704API リクエストが `stop_reason: "refusal"` を返すときにログされます。拒否は HTTP エラーではなく、成功したレスポンスストリームで到着するため、`api_error` イベントは発火しません。このイベントを使用すると、拒否の頻度を追跡できます。

705 

706**イベント名**: `claude_code.api_refusal`

707 

708**属性**:

709 

710* すべての[標準属性](#standard-attributes)

711* `event.name`: `"api_refusal"`

712* `event.timestamp`: ISO 8601 タイムスタンプ

713* `event.sequence`: セッション内のイベントを順序付けするための単調増加カウンター

714* `model`: リクエストからのモデル識別子

715* `request_id`: レスポンスの `request-id` ヘッダーからの Anthropic API リクエスト ID。例: `"req_011..."`。API が返す場合のみ存在します。

716 

695<h4 id="api-request-body-event">717<h4 id="api-request-body-event">

696 API リクエストボディイベント718 API リクエストボディイベント

697</h4>719</h4>


823* `server_scope`: サーバーが設定されているスコープ。例: `"user"`、`"project"`、または `"local"`845* `server_scope`: サーバーが設定されているスコープ。例: `"user"`、`"project"`、または `"local"`

824* `duration_ms`: 接続試行期間 (ミリ秒単位)846* `duration_ms`: 接続試行期間 (ミリ秒単位)

825* `error_code`: 接続が失敗した場合のエラーコード847* `error_code`: 接続が失敗した場合のエラーコード

848* `is_plugin`: サーバーがプラグインによって提供される場合は `true`、そうでない場合は `false`

849* `plugin_id_hash` (`is_plugin` が `true` の場合): プラグイン名とマーケットプレイスの安定ハッシュ。名前を公開することなくプラグインでイベントをグループ化するため

850* `plugin.name` (`is_plugin` が `true` の場合): サーバーを提供するプラグインの名前。サードパーティプラグインの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り、リテラル文字列 `"third-party"` です。これはサードパーティプラグイン名がデフォルトでログに表示されるのを防ぎます。公式 Anthropic ソースのプラグインは常に名前で識別されます。`plugin_id_hash` と `plugin.name` 属性は独自の監視バックエンドに流れ、Anthropic には送信されません

826* `server_name` (`OTEL_LOG_TOOL_DETAILS=1` の場合): 設定されたサーバー名851* `server_name` (`OTEL_LOG_TOOL_DETAILS=1` の場合): 設定されたサーバー名

827* `error` (`OTEL_LOG_TOOL_DETAILS=1` の場合): 接続が失敗した場合の完全なエラーメッセージ852* `error` (`OTEL_LOG_TOOL_DETAILS=1` の場合): 接続が失敗した場合の完全なエラーメッセージ

828 853 


885* `plugin_id_hash`: プラグイン名とマーケットプレイスの決定論的ハッシュ。設定されたエクスポーターにのみ送信されます。フリート全体で読み込まれているサードパーティプラグインの数をカウントできます。その名前を記録することなく910* `plugin_id_hash`: プラグイン名とマーケットプレイスの決定論的ハッシュ。設定されたエクスポーターにのみ送信されます。フリート全体で読み込まれているサードパーティプラグインの数をカウントできます。その名前を記録することなく

886* `has_hooks`: プラグインがフックに貢献するかどうか911* `has_hooks`: プラグインがフックに貢献するかどうか

887* `has_mcp`: プラグインが MCP サーバーに貢献するかどうか912* `has_mcp`: プラグインが MCP サーバーに貢献するかどうか

913* `host_owned_mcp`: SDK ホストがこのプラグインの MCP 接続を管理し、Claude Code がプラグインの MCP サーバー設定の読み取りをスキップした場合は `true`、そうでない場合は `false`。{/* min-version: 2.1.172 */}Claude Code v2.1.172 以降が必要です

888* `skill_path_count`: プラグインが宣言するスキルディレクトリの数914* `skill_path_count`: プラグインが宣言するスキルディレクトリの数

889* `command_path_count`: プラグインが宣言するコマンドディレクトリの数915* `command_path_count`: プラグインが宣言するコマンドディレクトリの数

890* `agent_path_count`: プラグインが宣言するエージェントディレクトリの数916* `agent_path_count`: プラグインが宣言するエージェントディレクトリの数

917* `safe_mode`: セッションが [`--safe-mode`](/ja/cli-reference) で開始された場合は `"true"`、そうでない場合は `"false"`。セーフモードでは、このイベントは設定されたインベントリのみを報告します。プラグインのコマンド、スキル、フック、MCP サーバーは読み込まれません。{/* min-version: 2.1.169 */}Claude Code v2.1.169 以降が必要です

891 918 

892<h4 id="skill-activated-event">919<h4 id="skill-activated-event">

893 スキル有効化イベント920 スキル有効化イベント


906* `skill.name`: スキルの名前。ユーザー定義およびサードパーティプラグインスキルの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り値はプレースホルダー `"custom_skill"` です933* `skill.name`: スキルの名前。ユーザー定義およびサードパーティプラグインスキルの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り値はプレースホルダー `"custom_skill"` です

907* `invocation_trigger`: スキルがどのようにトリガーされたか (`"user-slash"`、`"claude-proactive"`、または `"nested-skill"`)934* `invocation_trigger`: スキルがどのようにトリガーされたか (`"user-slash"`、`"claude-proactive"`、または `"nested-skill"`)

908* `skill.source`: スキルが読み込まれた場所 (例: `"bundled"`、`"userSettings"`、`"projectSettings"`、`"plugin"`)935* `skill.source`: スキルが読み込まれた場所 (例: `"bundled"`、`"userSettings"`、`"projectSettings"`、`"plugin"`)

936* `skill.kind`: スキルがワークフロースキルの場合は `"workflow"`。それ以外の場合は存在しません

909* `plugin.name` (`OTEL_LOG_TOOL_DETAILS=1` またはプラグインが公式マーケットプレイスからの場合): スキルがプラグインによって提供される場合の所有プラグインの名前937* `plugin.name` (`OTEL_LOG_TOOL_DETAILS=1` またはプラグインが公式マーケットプレイスからの場合): スキルがプラグインによって提供される場合の所有プラグインの名前

910* `marketplace.name` (`OTEL_LOG_TOOL_DETAILS=1` またはプラグインが公式マーケットプレイスからの場合): スキルがプラグインによって提供される場合、所有プラグインがインストールされたマーケットプレイス938* `marketplace.name` (`OTEL_LOG_TOOL_DETAILS=1` またはプラグインが公式マーケットプレイスからの場合): スキルがプラグインによって提供される場合、所有プラグインがインストールされたマーケットプレイス

911 939 


964* `hook_event`: フックイベントタイプ。例: `"PreToolUse"` または `"PostToolUse"`992* `hook_event`: フックイベントタイプ。例: `"PreToolUse"` または `"PostToolUse"`

965* `hook_type`: フック実装タイプ: `"command"`、`"prompt"`、`"mcp_tool"`、`"http"`、または `"agent"`993* `hook_type`: フック実装タイプ: `"command"`、`"prompt"`、`"mcp_tool"`、`"http"`、または `"agent"`

966* `hook_source`: フックが定義されている場所: `"userSettings"`、`"projectSettings"`、`"localSettings"`、`"flagSettings"`、`"policySettings"`、または `"pluginHook"`994* `hook_source`: フックが定義されている場所: `"userSettings"`、`"projectSettings"`、`"localSettings"`、`"flagSettings"`、`"policySettings"`、または `"pluginHook"`

995* `safe_mode`: セッションが [`--safe-mode`](/ja/cli-reference) で開始された場合は `"true"`、そうでない場合は `"false"`。{/* min-version: 2.1.169 */}Claude Code v2.1.169 以降が必要です

967* `hook_matcher` (`OTEL_LOG_TOOL_DETAILS=1` の場合): フック設定から設定されている場合のマッチャー文字列996* `hook_matcher` (`OTEL_LOG_TOOL_DETAILS=1` の場合): フック設定から設定されている場合のマッチャー文字列

968* `plugin.name` (`hook_source` が `"pluginHook"` の場合): 貢献するプラグインの名前。公式マーケットプレイスおよび組み込みバンドルの外部にあるプラグインの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り値は `"third-party"` です997* `plugin.name` (`hook_source` が `"pluginHook"` の場合): 貢献するプラグインの名前。公式マーケットプレイスおよび組み込みバンドルの外部にあるプラグインの場合、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り値は `"third-party"` です

969* `plugin_id_hash` (`hook_source` が `"pluginHook"` の場合): プラグイン名とマーケットプレイスの決定論的ハッシュ。設定されたエクスポーターにのみ送信されます。その名前を記録することなく、貢献するプラグインの数をカウントできます998* `plugin_id_hash` (`hook_source` が `"pluginHook"` の場合): プラグイン名とマーケットプレイスの決定論的ハッシュ。設定されたエクスポーターにのみ送信されます。その名前を記録することなく、貢献するプラグインの数をカウントできます


987* `num_hooks`: 一致するフックコマンドの数1016* `num_hooks`: 一致するフックコマンドの数

988* `managed_only`: 管理ポリシーフックのみが許可されている場合は `"true"`1017* `managed_only`: 管理ポリシーフックのみが許可されている場合は `"true"`

989* `hook_source`: `"policySettings"` または `"merged"`1018* `hook_source`: `"policySettings"` または `"merged"`

1019* `safe_mode`: セッションが [`--safe-mode`](/ja/cli-reference) で開始された場合は `"true"`、そうでない場合は `"false"`。{/* min-version: 2.1.169 */}Claude Code v2.1.169 以降が必要です

990* `hook_definitions`: JSON シリアル化されたフック設定。詳細なベータトレースと `OTEL_LOG_TOOL_DETAILS=1` の両方が有効な場合にのみ含まれます1020* `hook_definitions`: JSON シリアル化されたフック設定。詳細なベータトレースと `OTEL_LOG_TOOL_DETAILS=1` の両方が有効な場合にのみ含まれます

991 1021 

992<h4 id="hook-execution-complete-event">1022<h4 id="hook-execution-complete-event">


1013* `total_duration_ms`: すべての一致するフックの実時間1043* `total_duration_ms`: すべての一致するフックの実時間

1014* `managed_only`: 管理ポリシーフックのみが許可されている場合は `"true"`1044* `managed_only`: 管理ポリシーフックのみが許可されている場合は `"true"`

1015* `hook_source`: `"policySettings"` または `"merged"`1045* `hook_source`: `"policySettings"` または `"merged"`

1046* `safe_mode`: セッションが [`--safe-mode`](/ja/cli-reference) で開始された場合は `"true"`、そうでない場合は `"false"`。{/* min-version: 2.1.169 */}Claude Code v2.1.169 以降が必要です

1016* `hook_definitions`: JSON シリアル化されたフック設定。詳細なベータトレースと `OTEL_LOG_TOOL_DETAILS=1` の両方が有効な場合にのみ含まれます1047* `hook_definitions`: JSON シリアル化されたフック設定。詳細なベータトレースと `OTEL_LOG_TOOL_DETAILS=1` の両方が有効な場合にのみ含まれます

1017 1048 

1018<h4 id="hook-plugin-metrics-event">1049<h4 id="hook-plugin-metrics-event">


1089| ------------------------------------------------------------- | ---------------------------------------------------------------------------- |1120| ------------------------------------------------------------- | ---------------------------------------------------------------------------- |

1090| `claude_code.token.usage` | `type` (入力/出力)、ユーザー、チーム、モデル、`skill.name`、`plugin.name`、または `agent.name` 別に分類 |1121| `claude_code.token.usage` | `type` (入力/出力)、ユーザー、チーム、モデル、`skill.name`、`plugin.name`、または `agent.name` 別に分類 |

1091| `claude_code.session.count` | 時間経過に伴う採用と関与を追跡 |1122| `claude_code.session.count` | 時間経過に伴う採用と関与を追跡 |

1092| `claude_code.lines_of_code.count` | コード追加/削除を追跡して生産性を測定 |1123| `claude_code.lines_of_code.count` | コード追加と削除を追跡して生産性を測定し、モデル別に分類 |

1093| `claude_code.commit.count` & `claude_code.pull_request.count` | 開発ワークフローへの影響を理解 |1124| `claude_code.commit.count` & `claude_code.pull_request.count` | 開発ワークフローへの影響を理解 |

1094 1125 

1095<h3 id="cost-monitoring">1126<h3 id="cost-monitoring">


1116* 異常なトークン消費1147* 異常なトークン消費

1117* 特定のユーザーからの高いセッションボリューム1148* 特定のユーザーからの高いセッションボリューム

1118 1149 

1119すべてのメトリクスは、`user.account_uuid``user.account_id`、`organization.id`、`session.id`、`model`、および `app.version` でセグメント化できます1150すべてのメトリクスは、[標準属性](#standard-attributes) でセグメント化できます。`model` 属性は `claude_code.token.usage`、`claude_code.cost.usage`、および v2.1.172 以降の `claude_code.lines_of_code.count` で利用可能です。コミットのモデル別の内訳は1 つのセッションが複数のモデルにまたがる可能性があるため、`session.id` でトークンまたはコストメトリクスに対して結合することによってのみ概算できます

1120 1151 

1121<h3 id="detect-retry-exhaustion">1152<h3 id="detect-retry-exhaustion">

1122 再試行枯渇の検出1153 再試行枯渇の検出


1179 1210 

1180* `tool_result`:`tool_name` と `mcp_server_scope` を保持し、`mcp_server_name`、`mcp_tool_name`、および引数を省略1211* `tool_result`:`tool_name` と `mcp_server_scope` を保持し、`mcp_server_name`、`mcp_tool_name`、および引数を省略

1181* `tool_decision`:`tool_name` を保持し、`tool_parameters` を省略1212* `tool_decision`:`tool_name` を保持し、`tool_parameters` を省略

1182* `mcp_server_connection`:`server_name` とエラーメッセージを省略1213* `mcp_server_connection`:`server_name` とエラーメッセージを省略しますが、`is_plugin`、`plugin_id_hash`、および `plugin.name` を保持し、Anthropic 以外のプラグイン名はリテラル `"third-party"` に編集されるため、プラグイン提供サーバーは詳細ログなしで区別可能なままです

1183 1214 

1184<h3 id="map-security-questions-to-events">1215<h3 id="map-security-questions-to-events">

1185 セキュリティの質問をイベントにマップする1216 セキュリティの質問をイベントにマップする


1193| 権限モードのエスカレーション | `permission_mode_changed` | `from_mode`、`to_mode`、`trigger` |1224| 権限モードのエスカレーション | `permission_mode_changed` | `from_mode`、`to_mode`、`trigger` |

1194| ポリシーフックがアクションをブロック | `hook_execution_complete` | `hook_event`、`num_blocking` |1225| ポリシーフックがアクションをブロック | `hook_execution_complete` | `hook_event`、`num_blocking` |

1195| ログイン、ログアウト、認証失敗 | `auth` | `action`、`success`、`error_category` |1226| ログイン、ログアウト、認証失敗 | `auth` | `action`、`success`、`error_category` |

1196| MCP サーバー接続または失敗 | `mcp_server_connection` | `status`、`server_name`、`error_code` |1227| MCP サーバー接続または失敗 | `mcp_server_connection` | `status`、`server_name`、`is_plugin`、`error_code` |

1197| プラグインがインストールされ、そのソース | `plugin_installed` | `plugin.name`、`marketplace.name`、`marketplace.is_official` |1228| プラグインがインストールされ、そのソース | `plugin_installed` | `plugin.name`、`marketplace.name`、`marketplace.is_official` |

1198| 実行されたコマンドとタッチされたファイル | `tool_result`(実行)または `tool_decision`(拒否)(`OTEL_LOG_TOOL_DETAILS=1` の場合) | `tool_parameters`;`tool_input`(`tool_result` のみ) |1229| 実行されたコマンドとタッチされたファイル | `tool_result`(実行)または `tool_decision`(拒否)(`OTEL_LOG_TOOL_DETAILS=1` の場合) | `tool_parameters`;`tool_input`(`tool_result` のみ) |

1199 1230 


1230 1261 

1231* **時系列データベース (例: Prometheus)**: レート計算、集約メトリクス1262* **時系列データベース (例: Prometheus)**: レート計算、集約メトリクス

1232* **カラムナーストア (例: ClickHouse)**: 複雑なクエリ、一意のユーザー分析1263* **カラムナーストア (例: ClickHouse)**: 複雑なクエリ、一意のユーザー分析

1233* **フル機能の可観測性プラットフォーム (例: Honeycomb、Datadog)**: 高度なクエリ、可視化、アラート1264* **フル機能の可観測性プラットフォーム (例: Honeycomb、Datadog、Grafana Cloud)**: 高度なクエリ、可視化、アラート

1234 1265 

1235<h3 id="for-events/logs">1266<h3 id="for-events/logs">

1236 イベント/ログの場合1267 イベント/ログの場合


1238 1269 

1239* **ログ集約システム (例: Elasticsearch、Loki)**: 全文検索、ログ分析1270* **ログ集約システム (例: Elasticsearch、Loki)**: 全文検索、ログ分析

1240* **カラムナーストア (例: ClickHouse)**: 構造化イベント分析1271* **カラムナーストア (例: ClickHouse)**: 構造化イベント分析

1241* **フル機能の可観測性プラットフォーム (例: Honeycomb、Datadog)**: メトリクスとイベント間の相関1272* **フル機能の可観測性プラットフォーム (例: Honeycomb、Datadog、Grafana Cloud)**: メトリクスとイベント間の相関

1242 1273 

1243<h3 id="for-traces">1274<h3 id="for-traces">

1244 トレースの場合1275 トレースの場合


1247分散トレースストレージとスパン相関をサポートするバックエンドを選択します:1278分散トレースストレージとスパン相関をサポートするバックエンドを選択します:

1248 1279 

1249* **分散トレースシステム (例: Jaeger、Zipkin、Grafana Tempo)**: スパン可視化、リクエストウォーターフォール、レイテンシー分析1280* **分散トレースシステム (例: Jaeger、Zipkin、Grafana Tempo)**: スパン可視化、リクエストウォーターフォール、レイテンシー分析

1250* **フル機能の可観測性プラットフォーム (例: Honeycomb、Datadog)**: トレース検索とメトリクスおよびログとの相関1281* **フル機能の可観測性プラットフォーム (例: Honeycomb、Datadog、Grafana Cloud)**: トレース検索とメトリクスおよびログとの相関

1251 1282 

1252日次/週次/月次アクティブユーザー (DAU/WAU/MAU) メトリクスが必要な組織の場合は、効率的な一意値クエリをサポートするバックエンドを検討してください。1283日次/週次/月次アクティブユーザー (DAU/WAU/MAU) メトリクスが必要な組織の場合は、効率的な一意値クエリをサポートするバックエンドを検討してください。

1253 1284 


1269 ROI 測定リソース1300 ROI 測定リソース

1270</h2>1301</h2>

1271 1302 

1272テレメトリセットアップ、コスト分析、生産性メトリクス、自動レポート生成を含む Claude Code の投資収益率 (ROI) 測定に関する包括的なガイドについては、[Claude Code ROI 測定ガイド](https://github.com/anthropics/claude-code-monitoring-guide)を参照してください。このリポジトリは、すぐに使用できる Docker Compose 設定、Prometheus と OpenTelemetry セットアップ、Linear などのツールと統合された生産性レポート生成テンプレートを提供します。1303テレメトリセットアップ、コスト分析、生産性メトリクス、自動レポート生成を含む Claude Code の投資収益率ROI測定に関する包括的なガイドについては、[Claude Code ROI 測定ガイド](https://github.com/anthropics/claude-code-monitoring-guide)を参照してください。このリポジトリは、すぐに使用できる Docker Compose 設定、Prometheus と OpenTelemetry セットアップ、Linear などのツールと統合された生産性レポート生成テンプレートを提供します。

1273 1304 

1274<h2 id="security-and-privacy">1305<h2 id="security-and-privacy">

1275 セキュリティとプライバシー1306 セキュリティとプライバシー

Details

57 * ユーザー: `~/.claude/output-styles`57 * ユーザー: `~/.claude/output-styles`

58 * プロジェクト: `.claude/output-styles`58 * プロジェクト: `.claude/output-styles`

59 * 管理ポリシー: [管理設定ディレクトリ](/ja/settings#settings-files) 内の `.claude/output-styles`59 * 管理ポリシー: [管理設定ディレクトリ](/ja/settings#settings-files) 内の `.claude/output-styles`

60 

61 プロジェクト出力スタイルは、作業ディレクトリとリポジトリルートの間のすべての `.claude/output-styles/` から読み込まれます。{/* min-version: 2.1.178 */}v2.1.178 以降、これらのネストされたディレクトリの複数が同じ名前のスタイルを定義する場合、Claude Code は作業ディレクトリに最も近いものを使用します。

60 </Step>62 </Step>

61 63 

62 <Step title="Frontmatter と指示を追加する">64 <Step title="Frontmatter と指示を追加する">

overview.md +2 −2

Details

124 <Tab title="JetBrains">124 <Tab title="JetBrains">

125 IntelliJ IDEA、PyCharm、WebStorm、その他の JetBrains IDE 用のプラグインで、インタラクティブな差分表示と選択コンテキスト共有機能があります。125 IntelliJ IDEA、PyCharm、WebStorm、その他の JetBrains IDE 用のプラグインで、インタラクティブな差分表示と選択コンテキスト共有機能があります。

126 126 

127 JetBrains Marketplace から [Claude Code プラグイン](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) をインストールして IDE を再起動します。127 JetBrains Marketplace から [Claude Code プラグイン](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) をインストールして IDE を再起動します。プラグインには Claude Code CLI が必要で、別途インストールしてください。[JetBrains セットアップステップ](/ja/jetbrains#installation)を参照してください。

128 128 

129 [JetBrains ではじめる →](/ja/jetbrains)129 [JetBrains ではじめる →](/ja/jetbrains)

130 </Tab>130 </Tab>


209 209 

210 * デスクから離れて、電話または [リモートコントロール](/ja/remote-control) を使用した任意のブラウザから作業を続けます210 * デスクから離れて、電話または [リモートコントロール](/ja/remote-control) を使用した任意のブラウザから作業を続けます

211 * [Dispatch](/ja/desktop#sessions-from-dispatch) にメッセージを送信して、電話からタスクを送信し、作成されたデスクトップセッションを開きます211 * [Dispatch](/ja/desktop#sessions-from-dispatch) にメッセージを送信して、電話からタスクを送信し、作成されたデスクトップセッションを開きます

212 * [Web](/ja/claude-code-on-the-web) または [iOS アプリ](https://apps.apple.com/app/claude-by-anthropic/id6473753684) で長時間実行されるタスクを開始し、`claude --teleport` でターミナルにプルします212 * [Web](/ja/claude-code-on-the-web) または [iOS アプリ](https://apps.apple.com/app/claude-by-anthropic/id6473753684) で長時間実行されるタスクを開始し、`claude --teleport` でターミナルにプルします。Teleport には claude.ai サブスクリプションが必要です。

213 * ターミナルセッションを [デスクトップアプリ](/ja/desktop) に `/desktop` で渡して、視覚的な差分確認を行います213 * ターミナルセッションを [デスクトップアプリ](/ja/desktop) に `/desktop` で渡して、視覚的な差分確認を行います

214 * チームチャットからタスクをルーティング:[Slack](/ja/slack) で `@Claude` にメンションしてバグレポートを送信し、プルリクエストを取得します214 * チームチャットからタスクをルーティング:[Slack](/ja/slack) で `@Claude` にメンションしてバグレポートを送信し、プルリクエストを取得します

215 </Accordion>215 </Accordion>

Details

25 25 

26`bypassPermissions` を除くすべてのモードで、[保護されたパス](#protected-paths)への書き込みは自動承認されることはなく、リポジトリ状態と Claude 独自の設定を偶発的な破損から保護します。26`bypassPermissions` を除くすべてのモードで、[保護されたパス](#protected-paths)への書き込みは自動承認されることはなく、リポジトリ状態と Claude 独自の設定を偶発的な破損から保護します。

27 27 

28モードはベースラインを設定します。[パーミッションルール](/ja/permissions#manage-permissions)を上に層状にして、`bypassPermissions` を除くすべてのモードで特定のツールを事前承認またはブロックします。`bypassPermissions` はパーミッション層全体をスキップします28モードはベースラインを設定します。[パーミッションルール](/ja/permissions#manage-permissions)を上に層状にして、特定のツールを事前承認またはブロックします拒否ルールと明示的な確認ルールは `bypassPermissions` を含むすべてのモードで適用されます許可ルールはそのモードでは効果がありません。他のすべてが既に承認されているためです。

29 29 

30<h2 id="switch-permission-modes">30<h2 id="switch-permission-modes">

31 パーミッションモードを切り替える31 パーミッションモードを切り替える


95 <Tab title="Web and mobile">95 <Tab title="Web and mobile">

96 [claude.ai/code](https://claude.ai/code) のプロンプトボックスの横またはモバイルアプリのモードドロップダウンを使用します。パーミッションプロンプトは承認のために claude.ai に表示されます。どのモードが表示されるかはセッションが実行される場所によります。96 [claude.ai/code](https://claude.ai/code) のプロンプトボックスの横またはモバイルアプリのモードドロップダウンを使用します。パーミッションプロンプトは承認のために claude.ai に表示されます。どのモードが表示されるかはセッションが実行される場所によります。

97 97 

98 * **[Claude Code on the web](/ja/claude-code-on-the-web) のクラウドセッション**:自動編集受け入れと計画モードパーミッション確認自動、パーミッションのバイパスは利用できません。98 * **[Claude Code on the web](/ja/claude-code-on-the-web) のクラウドセッション**:編集を受け入れる、計画モード、および自動モード編集を受け入れるはクラウド環境がモードに関係なくファイル編集を事前承認するためドロップダウンはパーミッション確認の代わりに編集を受け入れるを表示します。設定からの `defaultMode: "acceptEdits"` は依然として尊重されます。自動モードは組織がそれを許可し選択されたモデルがそれをサポートする場合にのみ表示されます。パーミッションのバイパスは利用できません。

99 * **ローカルマシンの [Remote Control](/ja/remote-control) セッション**:パーミッション確認、自動編集受け入れ、計画モード。自動とパーミッションのバイパスは利用できません。99 * **ローカルマシンの [Remote Control](/ja/remote-control) セッション**:パーミッション確認、自動編集受け入れ、および計画モード。自動とパーミッションのバイパスは利用できません。

100 100 

101 Remote Control の場合、ホストを起動するときに開始モードを設定することもできます。101 Remote Control の場合、ホストを起動するときに開始モードを設定することもできます。

102 102 


176 自動モードには Claude Code v2.1.83 以降が必要です。176 自動モードには Claude Code v2.1.83 以降が必要です。

177</Note>177</Note>

178 178 

179自動モードでは Claude はパーミッションプロンプトなしで実行できます。別の分類器モデルはアクション実行前にアクションをレビューし、リクエストを超えてエスカレートするもの、認識されないインフラストラクチャをターゲットにするもの、または Claude が読んだ敵対的なコンテンツによって駆動されているように見えるものをブロックします。179自動モードでは Claude はルーチンのパーミッションプロンプトなしで実行できます。別の分類器モデルはアクション実行前にアクションをレビューし、リクエストを超えてエスカレートするもの、認識されないインフラストラクチャをターゲットにするもの、または Claude が読んだ敵対的なコンテンツによって駆動されているように見えるものをブロックします。明示的な [ask ルール](/ja/permissions#manage-permissions) は依然としてプロンプトを強制します。

180 180 

181自動モードはまた Claude に即座に実行し明確化の質問を最小化するよう指示します。パーミッションプロンプトを保持しながらより強い自律的な動作を取得するには、代わりに [プロアクティブ出力スタイル](/ja/output-styles) を設定してください。181自動モードはまた Claude に明確化の質問を停止せずに作業を続けるよう促します。ただしClaude はプロンプトまたはスキルが明示的にそれに依存する場合は依然として質問します。パーミッションプロンプトを保持しながらより強い自律的な動作を取得するには、代わりに [プロアクティブ出力スタイル](/ja/output-styles) を設定してください。

182 182 

183<Warning>183<Warning>

184 自動モードはリサーチプレビューです。プロンプトを削除しますが、安全性を保証しません。一般的な方向を信頼するタスクに使用し、機密操作のレビューの代わりとしては使用しないでください。184 自動モードはリサーチプレビューです。プロンプトを削除しますが、安全性を保証しません。一般的な方向を信頼するタスクに使用し、機密操作のレビューの代わりとしては使用しないでください。


193 193 

194Claude Code が自動モードを利用不可と報告する場合、これらの要件のいずれかが満たされていません。これは一時的な停止ではありません。モデルに名前を付けて自動モードが「アクションの安全性を判断できない」と言う別のメッセージは一時的な分類器停止です。[エラーリファレンス](/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action) を参照してください。194Claude Code が自動モードを利用不可と報告する場合、これらの要件のいずれかが満たされていません。これは一時的な停止ではありません。モデルに名前を付けて自動モードが「アクションの安全性を判断できない」と言う別のメッセージは一時的な分類器停止です。[エラーリファレンス](/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action) を参照してください。

195 195 

196[設定](/ja/settings#available-settings) で `defaultMode: "auto"` を設定し、セッションがエラーなしで `default` モードで開始する場合、設定は `.claude/settings.json` または `.claude/settings.local.json` にある可能性があります。Claude Code はこれらのファイルから `auto` を無視するため、リポジトリは自動モードを自身に付与することはできません。`~/.claude/settings.json` に移動してください。196[設定](/ja/settings#available-settings) で `defaultMode: "auto"` を設定し、セッションがエラーなしで `default` モードで開始する場合、設定は `.claude/settings.json` または `.claude/settings.local.json` にある可能性があります。Claude Code v2.1.142 以降はこれらのファイルから `auto` を無視するため、リポジトリは自動モードを自身に付与することはできません。`~/.claude/settings.json` に移動してください。

197 197 

198<h3 id="enable-auto-mode-on-bedrock-vertex-ai-or-foundry">198<h3 id="enable-auto-mode-on-bedrock-vertex-ai-or-foundry">

199 Bedrock、Vertex AI、または Foundry で自動モードを有効にする199 Bedrock、Vertex AI、または Foundry で自動モードを有効にする

200</h3>200</h3>

201 201 

202[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud Vertex AI](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry) では、`CLAUDE_CODE_ENABLE_AUTO_MODE` が `1` に設定されるまで自動モードは `Shift+Tab` サイクルに表示されません。これらのプロバイダーでは Claude Opus 4.7 と Opus 4.8 のみがサポートされています。202[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud Vertex AI](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry) では、`CLAUDE_CODE_ENABLE_AUTO_MODE` が `1` に設定されるまで自動モードは `Shift+Tab` サイクルに表示されません。変数は Claude Code v2.1.158 以降で機能します。これらのプロバイダーでは Claude Opus 4.7 と Opus 4.8 のみがサポートされています。

203 203 

2041 人の開発者に対して有効にするには、`~/.claude/settings.json` の `env` ブロックに変数を追加します。2041 人の開発者に対して有効にするには、`~/.claude/settings.json` の `env` ブロックに変数を追加します。

205 205 


234* IAM またはリポジトリパーミッションの付与234* IAM またはリポジトリパーミッションの付与

235* 共有インフラストラクチャの変更235* 共有インフラストラクチャの変更

236* セッション前に存在していたファイルを不可逆的に破壊236* セッション前に存在していたファイルを不可逆的に破壊

237* フォースプッシュまたは `main` への直接プッシュ237* フォースプッシュ、または `main` への直接プッシュ

238 238 

239**デフォルトで許可**:239**デフォルトで許可**:

240 240 


293 1. サブエージェント開始前に、委譲されたタスク説明が評価されるため、危険に見えるタスクは生成時にブロックされます。293 1. サブエージェント開始前に、委譲されたタスク説明が評価されるため、危険に見えるタスクは生成時にブロックされます。

294 2. サブエージェント実行中、その各アクションは親セッションと同じルールで分類器を通過し、サブエージェントのフロントマターの任意の `permissionMode` は無視されます。294 2. サブエージェント実行中、その各アクションは親セッションと同じルールで分類器を通過し、サブエージェントのフロントマターの任意の `permissionMode` は無視されます。

295 3. サブエージェント完了時、分類器はその完全なアクション履歴をレビューします。リターンチェックが懸念事項にフラグを立てた場合、セキュリティ警告がサブエージェントの結果の前に付加されます。295 3. サブエージェント完了時、分類器はその完全なアクション履歴をレビューします。リターンチェックが懸念事項にフラグを立てた場合、セキュリティ警告がサブエージェントの結果の前に付加されます。

296 

297 ステップ 1 には Claude Code v2.1.178 以降が必要です。以前のバージョンはステップ 2 と 3 で分類器を適用しましたが、サブエージェント開始前にタスク説明を評価しませんでした。

296 </Accordion>298 </Accordion>

297 299 

298 <Accordion title="コストとレイテンシ">300 <Accordion title="コストとレイテンシ">


304 dontAsk モードで事前承認済みツールのみを許可する306 dontAsk モードで事前承認済みツールのみを許可する

305</h2>307</h2>

306 308 

307`dontAsk` モードはプロンプトが表示されるすべてのツール呼び出しを自動的に拒否します。`permissions.allow` ルールと [読み取り専用 Bash コマンド](/ja/permissions#read-only-commands)に一致するアクションのみが実行できます。明示的な `ask` ルールはプロンプトするのではなく拒否されます。これにより、モードは CI パイプラインまたは Claude が実行を許可されているものを事前に定義する制限環境で完全に非対話的になります。309`dontAsk` モードはプロンプトが表示されるすべてのツール呼び出しを自動的に拒否します。`permissions.allow` ルールと [読み取り専用 Bash コマンド](/ja/permissions#read-only-commands)に一致するアクションのみが実行できます。明示的な [`ask` ルール](/ja/permissions#manage-permissions)はプロンプトするのではなく拒否されます。これにより、モードは CI パイプラインまたは Claude が実行を許可されているものを事前に定義する制限環境で完全に非対話的になります。[Claude Code on the web](/ja/claude-code-on-the-web)上のクラウドセッションは `defaultMode: "dontAsk"` を無視します。詳細は [bypassPermissions](#skip-all-checks-with-bypasspermissions-mode)を参照してください。

308 310 

309フラグで起動時に設定します。311フラグで起動時に設定します。

310 312 


316 bypassPermissions モードですべてのチェックをスキップする318 bypassPermissions モードですべてのチェックをスキップする

317</h2>319</h2>

318 320 

319`bypassPermissions` モードはパーミッションプロンプトと安全チェックを無効にするため、ツール呼び出しは即座に実行されます。v2.1.126 以降、これには[保護されたパス](#protected-paths)への書き込みが含まれます。これより前のバージョンではまだプロンプトが表示されていました。ファイルシステムのルートまたはホームディレクトリを対象とした削除(`rm -rf /` や `rm -rf ~` など)は、モデルエラーに対する回路遮断器として機能するため、引き続きプロンプトが表示されます。このモードは、Claude Code がホストシステムに損害を与えることができないコンテナ、VM、またはインターネットアクセスのない dev container のような隔離環境でのみ使用してください。321`bypassPermissions` モードはパーミッションプロンプトと安全チェックを無効にするため、ツール呼び出しは即座に実行されます。v2.1.126 以降、これには[保護されたパス](#protected-paths)への書き込みが含まれます。これより前のバージョンではまだプロンプトが表示されていました。明示的な[ask ルール](/ja/permissions#manage-permissions)はこのモードでもプロンプトを強制し、ファイルシステムのルートまたはホームディレクトリを対象とした削除(`rm -rf /` や `rm -rf ~` など)は、モデルエラーに対する回路遮断器として機能するため、引き続きプロンプトが表示されます。このモードは、Claude Code がホストシステムに損害を与えることができないコンテナ、VM、またはインターネットアクセスのない dev container のような隔離環境でのみ使用してください。

320 322 

321有効にするフラグの 1 つで開始したセッションから `bypassPermissions` に入ることはできません。有効にするために再起動してください。323有効にするフラグの 1 つで開始したセッションから `bypassPermissions` に入ることはできません。有効にするために再起動してください。

322 324 


334 336 

335チェックは認識されたサンドボックス内で自動的にスキップされます。コンテナで自律的に実行するには、[dev container](/ja/devcontainer) 設定を使用してください。これは Claude Code を非 root ユーザーとして実行します。337チェックは認識されたサンドボックス内で自動的にスキップされます。コンテナで自律的に実行するには、[dev container](/ja/devcontainer) 設定を使用してください。これは Claude Code を非 root ユーザーとして実行します。

336 338 

339[Web 上の Claude Code](/ja/claude-code-on-the-web) は設定ファイルの `defaultMode: "bypassPermissions"` または `"dontAsk"` を尊重しないため、リポジトリのチェックイン済み設定はクラウドセッションを bypass-permissions モードで開始することはできません。この設定は無視され、セッションはモードドロップダウンに表示されるモードで開始されます。クラウドセッションが提供するモードについては、[パーミッションモードを切り替える](#switch-permission-modes)を参照してください。

340 

337<Warning>341<Warning>

338 `bypassPermissions` はプロンプトインジェクションまたは意図しないアクションに対する保護を提供しません。プロンプトなしで背景安全チェックの場合、代わりに[自動モード](#eliminate-prompts-with-auto-mode)を使用してください。管理者は[管理設定](/ja/permissions#managed-settings)で `permissions.disableBypassPermissionsMode` を `"disable"` に設定することでこのモードをブロックできます。342 `bypassPermissions` はプロンプトインジェクションまたは意図しないアクションに対する保護を提供しません。プロンプトが大幅に少ない背景安全チェックの場合は、代わりに[自動モード](#eliminate-prompts-with-auto-mode)を使用してください。管理者は[管理設定](/ja/permissions#managed-settings)で `permissions.disableBypassPermissionsMode` を `"disable"` に設定することでこのモードをブロックできます。

339</Warning>343</Warning>

340 344 

341<h2 id="protected-paths">345<h2 id="protected-paths">


351| `dontAsk` | 拒否 |355| `dontAsk` | 拒否 |

352| `bypassPermissions` | 許可 |356| `bypassPermissions` | 許可 |

353 357 

358[`permissions.allow`](/ja/permissions#manage-permissions) 設定ファイルのルールは、保護されたパスへの書き込みを事前承認しません。安全性チェックは Claude Code が設定から allow ルールを評価する前に実行されるため、`~/.claude/settings.json` または `.claude/settings.json` の `Edit(.claude/**)` などのエントリは、上記の表のモード別の結果を変更しません。プロンプトを表示するモードでは、`.claude/` への書き込みのプロンプトに **Yes, and allow Claude to edit its own settings for this session** というオプションが表示され、そのセッション内の後続の `.claude/` への書き込みを再度プロンプトなしで承認します。

359 

354保護されたディレクトリ:360保護されたディレクトリ:

355 361 

356* `.git`362* `.git`


362* `.devcontainer`368* `.devcontainer`

363* `.yarn`369* `.yarn`

364* `.mvn`370* `.mvn`

365* `.claude`。ただし `.claude/commands`、`.claude/agents`、`.claude/skills`、`.claude/worktrees` は除く。Claude はこれらで定期的にコンテンツを作成します371* `.claude`。ただし `.claude/worktrees` は除く。Claude はここに独自の git worktrees を保存します

366 372 

367保護されたファイル:373保護されたファイル:

368 374 

permissions.md +82 −10

Details

30* **Ask** ルールは、Claude Code が指定されたツールを使用しようとするたびに確認を促します。30* **Ask** ルールは、Claude Code が指定されたツールを使用しようとするたびに確認を促します。

31* **Deny** ルールは、Claude Code が指定されたツールを使用することを防止します。31* **Deny** ルールは、Claude Code が指定されたツールを使用することを防止します。

32 32 

33ルールは順序で評価されます。**deny -> ask -> allow**最初にマッチしたルールが優先されるためdeny ルールは常に優先されます33ルールは順序で評価されます。deny、ask、allow の順です。その順序での最初のマッチがアウトカムを決定し、ルールの特異性は順序を変更しません。`Bash(aws *)` のような広い deny ルールは、`Bash(aws s3 ls)` のようなより狭い allow ルールにもマッチする呼び出しを含む、マッチするすべての呼び出しをブロックするため、deny ルールはアローリスト例外を含むことはできません。ask allow の間にも同じ優先順位が適用されますマッチする ask ルールは同じ呼び出しにマッチするより具体的な allow ルールがある場合でも、プロンプトを表示します

34 34 

35Deny ルールは、ツール名を指定するか、ツール内のパターンをスコープするかによって異なる動作をします。`Bash` のようなベアツール名は、ツールを Claude のコンテキストから完全に削除するため、Claude はそれを見ることはありません。`Bash(rm *)` のようなスコープ付きルールは、ツールを利用可能なままにし、Claude が試みたときにマッチする呼び出しをブロックします。35Deny ルールは、ツール名を指定するか、ツール内のパターンをスコープするかによって異なる動作をします。`Bash` のようなベアツール名は、ツールを Claude のコンテキストから完全に削除するため、Claude はそれを見ることはありません。`Bash(rm *)` のようなスコープ付きルールは、ツールを利用可能なままにし、Claude が試みたときにマッチする呼び出しをブロックします。

36 36 


91| `Read(./.env)` | 現在のディレクトリの `.env` ファイルを読み取ることをマッチさせます |91| `Read(./.env)` | 現在のディレクトリの `.env` ファイルを読み取ることをマッチさせます |

92| `WebFetch(domain:example.com)` | example.com へのフェッチリクエストをマッチさせます |92| `WebFetch(domain:example.com)` | example.com へのフェッチリクエストをマッチさせます |

93 93 

94<h3 id="match-by-input-parameter">

95 入力パラメータでマッチさせる

96</h3>

97 

98拒否ルールと確認ルールは、`Tool(param:value)` を使用して任意のツール上のトップレベル入力パラメータをマッチさせることができます。ルールは Claude がそのパラメータをその正確な値に設定してツールを呼び出すときにマッチします。この構文は拒否ルールと確認ルール用です。1 つのパラメータ値に対する許可ルールは、その呼び出しが全体的に安全であることを確立しないため、許可ルールは各ツール独自のスペシファイア構文を使用し続けます。これはツールが受け入れるスカラーパラメータで機能します。

99 

100| ルール | マッチ |

101| :----------------------------- | :------------------------------- |

102| `Agent(model:opus)` | Opus モデルティアをリクエストする Agent 呼び出し |

103| `Agent(isolation:worktree)` | git worktree をリクエストする Agent 呼び出し |

104| `Bash(run_in_background:true)` | バックグラウンドで実行される Bash 呼び出し |

105 

106パラメータマッチングは以下のルールに従います。

107 

108* パラメータ名は Agent ツール上の `model` など、ツールの入力の直接フィールドである必要があります。オブジェクトまたは配列内にネストされたフィールドはマッチ可能ではありません

109* 各ルールは 1 つのパラメータに名前を付けます。`model` と `isolation` の両方でゲートするには、1 つのルールで組み合わせるのではなく、`Agent(model:opus)` と `Agent(isolation:worktree)` の 2 つのルールを記述します

110* 値は `*` をワイルドカードとしてサポートし、任意の文字シーケンスにマッチするため、`Agent(isolation:*)` は任意の明示的な isolation 値にマッチします。`*` がない場合、マッチは正確です

111* モデルが省略するパラメータは決してマッチしないため、`Agent(model:*)` は `model` が設定されていない呼び出しにはマッチしません

112* 値は Claude が送信するリテラル入力と比較され、正規化の前です。`Agent(model:opus)` は別名 `opus` にマッチしますが、完全なモデル ID にはマッチしません。[`--verbose`](/ja/cli-reference) で実行して、各ツール呼び出しの正確なパラメータ名と値を確認してください

113* コロンの周りのホワイトスペースは無視されます

114 

115ツールが独自の正規化ルールでマッチするフィールドはこの方法ではマッチ可能ではありません。Bash と PowerShell の `command`、Read、Edit、Write の `file_path`、Grep と Glob の `path`、NotebookEdit の `notebook_path`、WebFetch の `url` です。`Bash(command:rm *)` のようなルールはコンパウンドコマンドでバイパス可能であるため、Claude Code はそれを無視し、スタートアップ警告を発行します。代わりに `Bash(rm *)`、`Read(./path)`、または `WebFetch(domain:host)` を使用してください。

116 

94<h3 id="wildcard-patterns">117<h3 id="wildcard-patterns">

95 ワイルドカードパターン118 ワイルドカードパターン

96</h3>119</h3>


118 141 

119権限ダイアログは、コマンドプレフィックスに対して「はい、今後は聞かない」を選択すると、スペース区切り形式を書き込みます。`:*` 形式はパターンの末尾でのみ認識されます。`Bash(git:* push)` のようなパターンでは、コロンはリテラル文字として扱われ、git コマンドにはマッチしません。142権限ダイアログは、コマンドプレフィックスに対して「はい、今後は聞かない」を選択すると、スペース区切り形式を書き込みます。`:*` 形式はパターンの末尾でのみ認識されます。`Bash(git:* push)` のようなパターンでは、コロンはリテラル文字として扱われ、git コマンドにはマッチしません。

120 143 

144<h3 id="tool-name-wildcards">

145 ツール名ワイルドカード

146</h3>

147 

148拒否ルールと確認ルールは、ツール名の位置でもグロブパターンを受け入れます。パターンはツール名全体にマッチする必要があります。`"*"` はすべてのツールにマッチし、`"mcp__*"` はすべてのサーバー全体のすべての MCP ツールにマッチします。ベアネーム glob 拒否ルールでマッチしたツールは Claude のコンテキストから削除されます。これはベアツール名と同じです。この設定はすべての MCP ツールを拒否します。

149 

150```json theme={null}

151{

152 "permissions": {

153 "deny": [

154 "mcp__*"

155 ]

156 }

157}

158```

159 

160許可ルールは、リテラル `mcp__<server>__` プレフィックスの後でのみツール名 glob を受け入れます。サーバーセグメントは glob フリーである必要があるため、ルールは設定した特定のサーバーに名前を付けます。`mcp__puppeteer__*` は `puppeteer` サーバーからのすべてのツールにマッチし、`mcp__github__get_*` はその `get_` ツールにマッチします。`"*"`、`"B*"`、または `"mcp__*"` などのアンカーなし許可 glob は警告とともにスキップされ、自動承認されません。

161 

162ツール名がマッチしない既知のツールを持つ拒否ルールまたは確認ルールは、タイプミスをキャッチするためにスタートアップ警告を生成します。`_` または `*` を含むツール名はチェックから除外されます。

163 

164トランスクリプトと権限ダイアログに表示されるツールのラベルは、その正規名と異なる場合があります。たとえば、トランスクリプトで `Stop Task` というラベルが付いているツールの正規名は `TaskStop` です。権限ルールと [hook マッチャー](/ja/hooks) は正規名のみをマッチさせるため、`Stop Task` として記述されたルールはマッチしません。拒否ルールと確認ルールの場合、上記のスタートアップ警告がミスマッチをキャッチします。[ツール参照](/ja/tools-reference) に記載されている正規名を使用してください。

165 

121<h2 id="tool-specific-permission-rules">166<h2 id="tool-specific-permission-rules">

122 ツール固有の権限ルール167 ツール固有の権限ルール

123</h2>168</h2>


266 WebFetch311 WebFetch

267</h3>312</h3>

268 313 

269* `WebFetch(domain:example.com)` example.com へのフェッチリクエストをマッチさせます314WebFetch ルールは `domain:` プレフィックスを使用し、リクエストされた URL のホスト名に対してマッチします。マッチングは大文字と小文字を区別せず、`*` ワイルドカードをサポートし、ルールとホスト名の両方から末尾の `.` をストリップするため、`example.com.` `example.com` は同じものとして扱われます。

315 

316* `WebFetch(domain:example.com)` は `example.com` へのリクエストをマッチさせます

317* `WebFetch(domain:*.example.com)` は `api.example.com` や `a.b.example.com` などの任意の深さのサブドメインをマッチさせますが、`example.com` 自体はマッチさせません

318* `WebFetch(domain:*)` はすべてのドメインをマッチさせ、ベア `WebFetch` ルールと同等です

319 

320先頭の `*.` または全体パターンとしてのみ、`*` は `.` を越えてマッチします。それ以外の場所では、ワイルドカードは 2 つのドット間のテキストのみをマッチさせます。`WebFetch(domain:example.*)` は `example.org` にマッチします。ここで `*` は `org` になりますが、`example.evil.com` にはマッチしません。ここで `*` は `evil.com` になり、ドットを越えます。これにより、末尾のワイルドカードが攻撃者が登録できるドメインをマッチさせるのを防ぎます。

270 321 

271<h3 id="mcp">322<h3 id="mcp">

272 MCP323 MCP


296}347}

297```348```

298 349 

350<h3 id="cd">

351 Cd

352</h3>

353 

354`Cd` ルールは、[`/cd` コマンド](/ja/commands)がセッションを移動できるディレクトリを制御します。`Cd` はモデル呼び出し可能なツールではありません。Claude はそれを呼び出すことはできず、ルールは自分で `/cd` を実行する場合にのみ適用されます。

355 

356ベア `Cd` deny ルールは `/cd` を完全に無効にします。`Cd(<path-pattern>)` deny ルールはマッチするターゲットをブロックします。Deny ルールはターゲットのすべてのスペルをチェックします。これには、それが解決する各シンボリックリンクホップが含まれるため、1 つのパス用に記述されたルールは、それに解決するターゲットもブロックします。

357 

358任意の `Cd` allow ルールを追加すると、`/cd` をホワイトリストモードに切り替えます。解決されたターゲットディレクトリは、allow ルールの 1 つにマッチする必要があります。そうでない場合、`/cd` は拒否します。`Cd` ルールが設定されていない場合、`/cd` はデフォルト動作を保持し、見慣れないディレクトリを信頼するようにプロンプトを表示します。

359 

360パスパターンは [Read と Edit ルール](#read-and-edit)から `//`、`~/`、`/` アンカーを共有しますが、マッチングはディレクトリパス全体にアンカーされます。gitignore スタイルではなく、`*` は正確に 1 つのパスセグメントをマッチさせ、`**` はセグメント全体でマッチさせます。末尾の `/**` はその名前付きルートもマッチさせます。

361 

362| ルール | マッチ | マッチしない |

363| --------------------- | ------------------------------- | ------------------------- |

364| `Cd(~/code/*)` | `~/code/app` | `~/code/app/src`、`~/code` |

365| `Cd(~/code/**)` | `~/code` およびその下のディレクトリ | `~/code` の外のディレクトリ |

366| `Cd(**/node_modules)` | 任意の深さの任意の `node_modules` ディレクトリ | `node_modules/pkg` |

367 

299<h2 id="extend-permissions-with-hooks">368<h2 id="extend-permissions-with-hooks">

300 フックで権限を拡張する369 フックで権限を拡張する

301</h2>370</h2>


318 387 

319追加ディレクトリ内のファイルは、元の作業ディレクトリと同じ権限ルールに従います。プロンプトなしで読み取り可能になり、ファイル編集権限は現在の権限モードに従います。388追加ディレクトリ内のファイルは、元の作業ディレクトリと同じ権限ルールに従います。プロンプトなしで読み取り可能になり、ファイル編集権限は現在の権限モードに従います。

320 389 

390セッションの主要な作業ディレクトリを別のディレクトリを追加する代わりに変更するには、[`/cd`](/ja/commands)を使用します。`/cd` コマンドには Claude Code v2.1.169 以降が必要です。`/add-dir` とは異なり、セッションを再配置します。新しいディレクトリの `CLAUDE.md` が読み込まれ、`--resume` はそこからセッションを検出します。

391 

321<h3 id="additional-directories-grant-file-access-not-configuration">392<h3 id="additional-directories-grant-file-access-not-configuration">

322 追加ディレクトリはファイルアクセスを許可し、設定ではありません393 追加ディレクトリはファイルアクセスを許可し、設定ではありません

323</h3>394</h3>


331| 設定 | `--add-dir` から読み込まれます |402| 設定 | `--add-dir` から読み込まれます |

332| :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------- |403| :------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------- |

333| `.claude/skills/` の [Skills](/ja/skills) | はい、ライブリロード付き |404| `.claude/skills/` の [Skills](/ja/skills) | はい、ライブリロード付き |

405| `.claude/agents/` の [Subagents](/ja/sub-agents) | はい |

334| `.claude/settings.json` のプラグイン設定 | `enabledPlugins` と `extraKnownMarketplaces` のみ |406| `.claude/settings.json` のプラグイン設定 | `enabledPlugins` と `extraKnownMarketplaces` のみ |

335| [CLAUDE.md](/ja/memory) ファイル、`.claude/rules/`、および `CLAUDE.local.md` | `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` が設定されている場合のみ。`CLAUDE.local.md` はさらに `local` 設定ソースが必要です。これはデフォルトで有効になっています |407| [CLAUDE.md](/ja/memory) ファイル、`.claude/rules/`、および `CLAUDE.local.md` | `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` が設定されている場合のみ。`CLAUDE.local.md` はさらに `local` 設定ソースが必要です。これはデフォルトで有効になっています |

336 408 

337Subagents、コマンド、および出力スタイルは、現在の作業ディレクトリとその親、`~/.claude/` のユーザーディレクトリ、および管理設定から検出されます。Hooks およびその他の `settings.json` キーは、現在の作業ディレクトリの `.claude/` フォルダから親ディレクトリへのフォールバックなしで読み込まれ、ユーザーの `~/.claude/settings.json` および管理設定と共に読み込まれます。その設定をプロジェクト全体で共有するには、次のいずれかのアプローチを使用します。409コマンドおよび出力スタイルは、現在の作業ディレクトリとその親、`~/.claude/` のユーザーディレクトリ、および管理設定から検出されます。Hooks およびその他の `settings.json` キーは、現在の作業ディレクトリの `.claude/` フォルダから親ディレクトリへのフォールバックなしで読み込まれ、ユーザーの `~/.claude/settings.json` および管理設定と共に読み込まれます。その設定をプロジェクト全体で共有するには、次のいずれかのアプローチを使用します。

338 410 

339* **ユーザーレベルの設定**:`~/.claude/agents/`、`~/.claude/output-styles/`、または `~/.claude/settings.json` にファイルを配置して、すべてのプロジェクトで利用可能にします411* **ユーザーレベルの設定**:`~/.claude/agents/`、`~/.claude/output-styles/`、または `~/.claude/settings.json` にファイルを配置して、すべてのプロジェクトで利用可能にします

340* **プラグイン**:設定を [プラグイン](/ja/plugins)としてパッケージ化および配布し、チームがインストールできるようにします412* **プラグイン**:設定を [プラグイン](/ja/plugins)としてパッケージ化および配布し、チームがインストールできるようにします


356* サンドボックス内のファイルシステム制限は、[`sandbox.filesystem`](/ja/sandboxing) 設定と Read および Edit deny ルールを組み合わせます。両方が最終的なサンドボックス境界にマージされます428* サンドボックス内のファイルシステム制限は、[`sandbox.filesystem`](/ja/sandboxing) 設定と Read および Edit deny ルールを組み合わせます。両方が最終的なサンドボックス境界にマージされます

357* ネットワーク制限は、WebFetch 権限ルールとサンドボックスの `allowedDomains` および `deniedDomains` リストを組み合わせます429* ネットワーク制限は、WebFetch 権限ルールとサンドボックスの `allowedDomains` および `deniedDomains` リストを組み合わせます

358 430 

359サンドボックスが `autoAllowBashIfSandboxed: true` で有効になっている場合(デフォルト)、サンドボックス化された Bash コマンドは、権限に `ask: Bash(*)` が含まれている場合でもプロンプトなしで実行されます。サンドボックス境界はコマンドごとのプロンプトの代わりになります。明示的な deny ルールは引き続き適用され、`/`、ホームディレクトリ、またはその他の重要なシステムパスをターゲットとする `rm` または `rmdir` コマンドは、引き続きプロンプトをトリガーします。[サンドボックスモード](/ja/sandboxing#sandbox-modes)を参照して、この動作を変更してください。431サンドボックスが `autoAllowBashIfSandboxed: true` で有効になっている場合(デフォルト)、サンドボックス化された Bash コマンドは、権限に bare `Bash` ask ルール、または[同等の `Bash(*)` 形式](#match-all-uses-of-a-tool)が含まれている場合でもプロンプトなしで実行されます。サンドボックス境界は、そのツール全体のプロンプトの代わりになります`Bash(git push *)` のようなコンテンツスコープ ask ルールは、引き続きプロンプトを強制し、明示的な deny ルールは引き続き適用され、`/`、ホームディレクトリ、またはその他の重要なシステムパスをターゲットとする `rm` または `rmdir` コマンドは、引き続きプロンプトをトリガーします。除外されたコマンドなど、サンドボックス化されて実行されないコマンドは、通常どおり bare `Bash` ask ルールを尊重します。[サンドボックスモード](/ja/sandboxing#sandbox-modes)を参照して、この動作を変更してください。

360 432 

361<h2 id="managed-settings">433<h2 id="managed-settings">

362 管理設定434 管理設定


421 関連項目493 関連項目

422</h2>494</h2>

423 495 

424* [設定](/ja/settings)権限設定テーブルを含む完全な設定リファレンス496* [設定](/ja/settings)権限設定テーブルを含む完全な設定リファレンス

425* [auto モードを設定する](/ja/auto-mode-config)auto モード分類器が組織が信頼するインフラストラクチャを伝えます497* [auto モードを設定する](/ja/auto-mode-config)auto モード分類器が組織が信頼するインフラストラクチャを伝えます

426* [サンドボックス](/ja/sandboxing)Bash コマンドの OS レベルのファイルシステムとネットワーク分離498* [サンドボックス](/ja/sandboxing)Bash コマンドの OS レベルのファイルシステムとネットワーク分離

427* [認証](/ja/authentication)Claude Code へのユーザーアクセスを設定します499* [認証](/ja/authentication)Claude Code へのユーザーアクセスを設定します

428* [セキュリティ](/ja/security)セキュリティ保護とベストプラクティス500* [セキュリティ](/ja/security)セキュリティ保護とベストプラクティス

429* [フック](/ja/hooks-guide)ワークフローを自動化し、権限評価を拡張します501* [フック](/ja/hooks-guide)ワークフローを自動化し、権限評価を拡張します

platforms.md +1 −1

Details

23| [Web](/ja/claude-code-on-the-web) | あまり操作が必要ない長時間実行タスク、またはオフラインの場合も続行すべき作業 | Anthropic 管理クラウド、切断後も続行 |23| [Web](/ja/claude-code-on-the-web) | あまり操作が必要ない長時間実行タスク、またはオフラインの場合も続行すべき作業 | Anthropic 管理クラウド、切断後も続行 |

24| モバイル | コンピューターから離れている間にタスクを開始および監視 | iOS および Android 用 Claude アプリからのクラウドセッション、ローカルセッション用の[Remote Control](/ja/remote-control)、Pro および Max での Desktop への[Dispatch](/ja/desktop#sessions-from-dispatch) |24| モバイル | コンピューターから離れている間にタスクを開始および監視 | iOS および Android 用 Claude アプリからのクラウドセッション、ローカルセッション用の[Remote Control](/ja/remote-control)、Pro および Max での Desktop への[Dispatch](/ja/desktop#sessions-from-dispatch) |

25 25 

26CLI はターミナルネイティブな作業に最も完全なサーフェスです。スクリプティングと Agent SDK は CLI のみです。サードパーティプロバイダーは[VS Code](/ja/vs-code#use-third-party-providers)でも機能します。Enterprise [Desktop](/ja/desktop) デプロイメントは Vertex AI およびゲートウェイプロバイダーをサポートしています。Bedrock または Foundry の場合は、Desktop の代わりに CLI または VS Code を使用してください。Desktop と IDE 拡張機能は、CLI のみの機能の一部をビジュアルレビューとより緊密なエディター統合と引き換えにします。Web は Anthropic のクラウドで実行されるため、切断後もタスクが続行されます。モバイルは、これらの同じクラウドセッションへのシンクライアント、または Remote Control 経由のローカルセッションへのシンクライアントであり、Dispatch で Desktop にタスクを送信できます。26CLI はターミナルネイティブな作業に最も完全なサーフェスです。スクリプティングと Agent SDK は CLI のみです。サードパーティプロバイダーは[VS Code](/ja/vs-code#use-third-party-providers)でも機能します。Enterprise [Desktop](/ja/desktop) デプロイメントは Vertex AI およびゲートウェイプロバイダーをサポートしています。Bedrock または Foundry の場合は、CLI または VS Code を使用するか、[Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview)を使用してください。これは、それらのプロバイダーで Code タブを実行します。Desktop と IDE 拡張機能は、CLI のみの機能の一部をビジュアルレビューとより緊密なエディター統合と引き換えにします。Web は Anthropic のクラウドで実行されるため、切断後もタスクが続行されます。モバイルは、これらの同じクラウドセッションへのシンクライアント、または Remote Control 経由のローカルセッションへのシンクライアントであり、Dispatch で Desktop にタスクを送信できます。

27 27 

28同じプロジェクトで複数のサーフェスを混在させることができます。設定、プロジェクトメモリ、MCP サーバーはローカルサーフェス全体で共有されます。28同じプロジェクトで複数のサーフェスを混在させることができます。設定、プロジェクトメモリ、MCP サーバーはローカルサーフェス全体で共有されます。

29 29 

plugin-hints.md +7 −4

Details

16 仕組み16 仕組み

17</h2>17</h2>

18 18 

19Claude Code は、Bash および PowerShell ツールを通じて実行するすべてのコマンド、および [hook](/ja/hooks) コマンドに対して、[`CLAUDECODE`](/ja/env-vars) 環境変数を `1` に設定します。CLI がその変数を検出すると、自己終了型の `<claude-code-hint />` タグを stderr に書き込みます。hook コマンドではヒントタグは削除され、無視されます。Bash および PowerShell ツール出力のみがインストールプロンプトをトリガーします。19Claude Code は、Bash および PowerShell ツールを通じて実行するすべてのコマンド、および [hook](/ja/hooks) コマンドに対して、[`CLAUDECODE`](/ja/env-vars) 環境変数を `1` に設定します。{/* min-version: 2.1.172 */}v2.1.172 以降では、同じサブプロセスで [`CLAUDE_CODE_CHILD_SESSION`](/ja/env-vars) も `1` に設定します。CLI がこれらの変数のいずれかを検出すると、自己終了型の `<claude-code-hint />` タグを stderr に書き込みます。hook コマンドではヒントタグは削除され、無視されます。Bash および PowerShell ツール出力のみがインストールプロンプトをトリガーします。

20 20 

21Claude Code がコマンド出力を受け取ると、以下を実行します。21Claude Code がコマンド出力を受け取ると、以下を実行します。

22 22 


31 ヒントを出力する31 ヒントを出力する

32</h2>32</h2>

33 33 

34`CLAUDECODE` 環境変数でゲートを設定して、マーカーが人間のユーザーのターミナルに表示されないようにします。次に、タグを stderr に独立した行として書き込みます。34環境変数でゲートを設定して、マーカーが人間のユーザーが CLI を直接実行するときに表示されないようにします。次に、タグを stderr に独立した行として書き込みます。チェックする変数を選択してください。

35 35 

36以下の例は、公式マーケットプレイスの `example-cli` という名前のプラグインのヒントを出力します36* `CLAUDECODE`: Claude Code のすべてのバージョンで設定されるため、最も多くのセッションに到達しますClaude Code が起動する tmux セッションと stdio MCP サーバーサブプロセスでも設定され、IDE 拡張機能は統合ターミナルで設定します。人間のユーザーが CLI を直接実行する可能性があります。

37* {/* min-version: 2.1.172 */}`CLAUDE_CODE_CHILD_SESSION`: Claude Code 自体が生成するサブプロセス(ツール呼び出し、hook コマンド、[status line](/ja/statusline) コマンドなど)でのみ設定されるため、タグは通常、人間のターミナルに到達しません。セッション内で開始された長時間実行されるプロセス(tmux サーバーなど)は変数をキャプチャするため、そのプロセスから後で起動されたシェルは依然として生のタグを表示します。Claude Code v2.1.172 以降が必要なため、古いバージョンのセッションではヒントが表示されません。

38 

39以下の例は、最大限のリーチのために `CLAUDECODE` でゲートを設定し、公式マーケットプレイスの `example-cli` という名前のプラグインのヒントを出力します。

37 40 

38<CodeGroup>41<CodeGroup>

39 ```javascript Node.js theme={null}42 ```javascript Node.js theme={null}


147残りのガイダンスは推奨されていますが、強制されていません。Claude Code は CLI がそれに従っているかどうかを観察することはできません。150残りのガイダンスは推奨されていますが、強制されていません。Claude Code は CLI がそれに従っているかどうかを観察することはできません。

148 151 

149* **stderr に書き込む**: stderr は `example-cli deploy | jq` などのシェルパイプラインからタグを除外します。Claude Code は両方のストリームをスキャンするため、stdout も機能します。152* **stderr に書き込む**: stderr は `example-cli deploy | jq` などのシェルパイプラインからタグを除外します。Claude Code は両方のストリームをスキャンするため、stdout も機能します。

150* **`CLAUDECODE` でゲートを設定する**: `CLAUDECODE` 環境変数が設定されている場合のみ出力しますこれによりユーザーが CLI を直接実行するときにマーカーが表示されるのを防ぎます153* **環境変数でゲートを設定する**: `CLAUDECODE` または `CLAUDE_CODE_CHILD_SESSION` が設定されている場合のみ出力します[ヒントを出力する](#emit-the-hint)を参照して2 つの変数がどのように異なるかを確認してください

151 154 

152<h2 id="get-your-plugin-into-the-official-marketplace">155<h2 id="get-your-plugin-into-the-official-marketplace">

153 公式マーケットプレイスにプラグインを取得する156 公式マーケットプレイスにプラグインを取得する

Details

171| `plugins` | array | 利用可能なプラグインのリスト | 以下を参照 |171| `plugins` | array | 利用可能なプラグインのリスト | 以下を参照 |

172 172 

173<Note>173<Note>

174 **予約名**:以下のマーケットプレイス名は Anthropic の公式使用のために予約されており、サードパーティのマーケットプレイスでは使用できません:`claude-code-marketplace`、`claude-code-plugins`、`claude-plugins-official`、`anthropic-marketplace`、`anthropic-plugins`、`agent-skills`、`anthropic-agent-skills`、`knowledge-work-plugins`、`life-sciences`、`claude-for-legal`、`claude-for-financial-services`、`financial-services-plugins`。公式マーケットプレイスになりすましている名前(`official-claude-plugins` や `anthropic-tools-v2` など)もブロックされています。174 **予約名**:以下のマーケットプレイス名は Anthropic の公式使用のために予約されており、サードパーティのマーケットプレイスでは使用できません:`claude-code-marketplace`、`claude-code-plugins`、`claude-plugins-official`、`claude-plugins-community`、`claude-community`、`anthropic-marketplace`、`anthropic-plugins`、`agent-skills`、`anthropic-agent-skills`、`knowledge-work-plugins`、`life-sciences`、`claude-for-legal`、`claude-for-financial-services`、`financial-services-plugins`。公式マーケットプレイスになりすましている名前(`official-claude-plugins` や `anthropic-tools-v2` など)もブロックされています。

175</Note>175</Note>

176 176 

177<h3 id="owner-fields">177<h3 id="owner-fields">


203 203 

204`plugins` 配列内の各プラグインエントリは、プラグインとその場所を説明します。[プラグインマニフェストスキーマ](/ja/plugins-reference#plugin-manifest-schema)のフィールド(`description`、`version`、`author`、`commands`、`hooks` など)を含めることができます。さらに、これらのマーケットプレイス固有のフィールド:`source`、`category`、`tags`、`strict` があります。204`plugins` 配列内の各プラグインエントリは、プラグインとその場所を説明します。[プラグインマニフェストスキーマ](/ja/plugins-reference#plugin-manifest-schema)のフィールド(`description`、`version`、`author`、`commands`、`hooks` など)を含めることができます。さらに、これらのマーケットプレイス固有のフィールド:`source`、`category`、`tags`、`strict` があります。

205 205 

206<h3 id="required-fields">206<h3 id="required-fields-1">

207 必須フィールド207 必須フィールド

208</h3>208</h3>

209 209 


253プラグインがローカルマシンにクローンまたはコピーされると、`~/.claude/plugins/cache` のローカルバージョン管理プラグインキャッシュにコピーされます。253プラグインがローカルマシンにクローンまたはコピーされると、`~/.claude/plugins/cache` のローカルバージョン管理プラグインキャッシュにコピーされます。

254 254 

255| ソース | タイプ | フィールド | 注記 |255| ソース | タイプ | フィールド | 注記 |

256| ------------ | --------------------------- | -------------------------------- | ------------------------------------------- |256| ------------ | --------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------- |

257| 相対パス | `string`(例:`"./my-plugin"`) | | マーケットプレイスリポジトリ内のローカルディレクトリ。`./` で始まる必要があります |257| 相対パス | `string`(例:`"./my-plugin"`) | なし | マーケットプレイスリポジトリ内のローカルディレクトリ。`./` で始まる必要があります。マーケットプレイスルートに相対的に解決されます。`.claude-plugin/` ディレクトリではありません |

258| `github` | object | `repo`、`ref?`、`sha?` | |258| `github` | object | `repo`、`ref?`、`sha?` | |

259| `url` | object | `url`、`ref?`、`sha?` | Git URL ソース |259| `url` | object | `url`、`ref?`、`sha?` | Git URL ソース |

260| `git-subdir` | object | `url`、`path`、`ref?`、`sha?` | Git リポジトリ内のサブディレクトリ。帯域幅を最小化するためにスパースクローンします |260| `git-subdir` | object | `url`、`path`、`ref?`、`sha?` | Git リポジトリ内のサブディレクトリ。帯域幅を最小化するためにスパースクローンします |


269 例えば、`acme-corp/plugin-catalog`(マーケットプレイスソース)でホストされているマーケットプレイスは、`acme-corp/code-formatter`(プラグインソース)から取得されたプラグインを一覧表示できます。マーケットプレイスソースとプラグインソースは異なるリポジトリを指し、独立して固定されます。269 例えば、`acme-corp/plugin-catalog`(マーケットプレイスソース)でホストされているマーケットプレイスは、`acme-corp/code-formatter`(プラグインソース)から取得されたプラグインを一覧表示できます。マーケットプレイスソースとプラグインソースは異なるリポジトリを指し、独立して固定されます。

270</Note>270</Note>

271 271 

272以下の Git ベースのソースタイプは `github`、`url`、および `git-subdir` です。`ref` と `sha` の両方がそれらのいずれかに設定されている場合、`sha` が有効なピンです。Claude Code はピンされたコミットを直接取得してチェックアウトするため、ブランチまたは `ref` で指定されたタグが上流で削除されていても、コミットがリポジトリから到達可能である限り、インストールは成功します。

273 

272<h3 id="relative-paths">274<h3 id="relative-paths">

273 相対パス275 相対パス

274</h3>276</h3>


505* **`${CLAUDE_PLUGIN_ROOT}`**:hooks と MCP サーバー設定でこの変数を使用して、プラグインのインストールディレクトリ内のファイルを参照します。プラグインはインストール時にキャッシュロケーションにコピーされるため、これは必要です。永続的なデータまたはプラグイン更新後も保持する必要がある状態については、代わりに [`${CLAUDE_PLUGIN_DATA}`](/ja/plugins-reference#persistent-data-directory) を使用します。507* **`${CLAUDE_PLUGIN_ROOT}`**:hooks と MCP サーバー設定でこの変数を使用して、プラグインのインストールディレクトリ内のファイルを参照します。プラグインはインストール時にキャッシュロケーションにコピーされるため、これは必要です。永続的なデータまたはプラグイン更新後も保持する必要がある状態については、代わりに [`${CLAUDE_PLUGIN_DATA}`](/ja/plugins-reference#persistent-data-directory) を使用します。

506* **`strict: false`**:これが false に設定されているため、プラグインは独自の `plugin.json` を必要としません。マーケットプレイスエントリがすべてを定義します。以下の[厳密モード](#strict-mode)を参照してください。508* **`strict: false`**:これが false に設定されているため、プラグインは独自の `plugin.json` を必要としません。マーケットプレイスエントリがすべてを定義します。以下の[厳密モード](#strict-mode)を参照してください。

507 509 

510デフォルトでは、プラグインの skills は、その `source` の下の `skills/` ディレクトリから読み込まれ、`skills` の下に一覧表示されているパスはそのスキャンに追加されます。例外は、`source: "./"` などのマーケットプレイスルートソースです。この場合、複数のプラグインエントリが 1 つの `skills/` フォルダを共有します。その場合、`skills` の下に特定のサブディレクトリを一覧表示すると、そのリストがエントリの完全なセットになり、`skills/` の下の他のディレクトリは読み込まれません。`skills/` ディレクトリ自体またはプラグインルートを一覧表示すると、完全なスキャンが保持されます。一覧表示されたパスが存在しない場合、デフォルトスキャンが代わりに実行されます。

511 

508<h3 id="strict-mode">512<h3 id="strict-mode">

509 厳密モード513 厳密モード

510</h3>514</h3>


869 873 

870共有する前にマーケットプレイスをテストします。874共有する前にマーケットプレイスをテストします。

871 875 

872マーケットプレイス JSON 構文を検証します876マーケットプレイス JSON 構文を検証します

873 877 

874```bash theme={null}878```bash theme={null}

875claude plugin validate .879claude plugin validate .


881/plugin validate .885/plugin validate .

882```886```

883 887 

884テスト用にマーケットプレイスを追加します888テスト用にマーケットプレイスを追加します

885 889 

886```shell theme={null}890```shell theme={null}

887/plugin marketplace add ./path/to/marketplace891/plugin marketplace add ./path/to/marketplace

888```892```

889 893 

890すべてが機能することを確認するためにテストプラグインをインストールします894すべてが機能することを確認するためにテストプラグインをインストールします

891 895 

892```shell theme={null}896```shell theme={null}

893/plugin install test-plugin@marketplace-name897/plugin install test-plugin@marketplace-name


1074* プラグインディレクトリに必須ファイルが含まれていることを確認します1078* プラグインディレクトリに必須ファイルが含まれていることを確認します

1075* GitHub ソースの場合、リポジトリが公開されているか、アクセス権限があることを確認します1079* GitHub ソースの場合、リポジトリが公開されているか、アクセス権限があることを確認します

1076* プラグインソースを手動でクローン/ダウンロードしてテストします1080* プラグインソースを手動でクローン/ダウンロードしてテストします

1081* ソースが `ref` と `sha` の両方をピンしている場合、削除されたアップストリームブランチまたはタグはインストールをブロックしません。インストールが失敗し続ける場合は、ピンされたコミットがリポジトリに存在することを確認します

1077 1082 

1078<h3 id="private-repository-authentication-fails">1083<h3 id="private-repository-authentication-fails">

1079 プライベートリポジトリ認証が失敗する1084 プライベートリポジトリ認証が失敗する

plugins.md +7 −3

Details

216| `bin/` | プラグインルート | プラグインが有効になっている間に Bash ツールの `PATH` に追加される実行可能ファイル |216| `bin/` | プラグインルート | プラグインが有効になっている間に Bash ツールの `PATH` に追加される実行可能ファイル |

217| `settings.json` | プラグインルート | プラグインが有効になったときに適用されるデフォルト[設定](/ja/settings) |217| `settings.json` | プラグインルート | プラグインが有効になったときに適用されるデフォルト[設定](/ja/settings) |

218 218 

219正確に 1 つのスキルを含むプラグインは、`skills/` ディレクトリを作成する代わりに、`SKILL.md` をプラグインルートに直接配置できます。Claude Code はそれを単一のスキルとして読み込み、フロントマター `name` フィールドを呼び出し名として使用します。複数のスキルに成長する可能性があるプラグインには、`skills/` レイアウトを使用してください。

220 

219<Note>221<Note>

220 **次のステップ**:さらに多くの機能を追加する準備ができましたか?[より複雑なプラグインを開発する](#develop-more-complex-plugins)にジャンプして、エージェント、フック、MCP サーバー、LSP サーバーを追加してください。すべてのプラグインコンポーネントの完全な技術仕様については、[プラグインリファレンス](/ja/plugins-reference)を参照してください。222 **次のステップ**:さらに多くの機能を追加する準備ができましたか?[より複雑なプラグインを開発する](#develop-more-complex-plugins)にジャンプして、エージェント、フック、MCP サーバー、LSP サーバーを追加してください。すべてのプラグインコンポーネントの完全な技術仕様については、[プラグインリファレンス](/ja/plugins-reference)を参照してください。

221</Note>223</Note>


402 404 

403Anthropic は Claude Code プラグイン用に 2 つの公開マーケットプレイスを管理しています。405Anthropic は Claude Code プラグイン用に 2 つの公開マーケットプレイスを管理しています。

404 406 

405* **`claude-plugins-official`**:Anthropic によって管理されているキュレーションされたプラグインセット。すべての Claude Code インストールで自動的に利用可能です407* **`claude-plugins-official`**:Anthropic によって管理されているキュレーションされたプラグインセット。初めて Claude Code をインタラクティブに起動したときに自動的に登録されます最初の起動前に実行される非インタラクティブスクリプトは、`claude plugin marketplace add anthropics/claude-plugins-official` で明示的に追加する必要があります。

406* **`claude-community`**:レビュー後にサードパーティの送信が登録される公開コミュニティマーケットプレイス。ユーザーは `/plugin marketplace add anthropics/claude-plugins-community` で追加し、`@claude-community` としてインストールします。408* **`claude-community`**:レビュー後にサードパーティの送信が登録される公開コミュニティマーケットプレイス。ユーザーは `/plugin marketplace add anthropics/claude-plugins-community` で追加し、`@claude-community` としてインストールします。

407 409 

408プラグインをコミュニティマーケットプレイスレビュー用に送信するには、アプリ内フォームの 1 つを使用してください。410プラグインをコミュニティマーケットプレイスレビュー用に送信するには、アプリ内フォームの 1 つを使用してください。

409 411 

410* **Claude.ai**:[claude.ai/settings/plugins/submit](https://claude.ai/settings/plugins/submit)412* **claude.ai**:[claude.ai/admin-settings/directory/submissions/plugins/new](https://claude.ai/admin-settings/directory/submissions/plugins/new)

411* **Console**:[platform.claude.com/plugins/submit](https://platform.claude.com/plugins/submit)413* **Console**:[platform.claude.com/plugins/submit](https://platform.claude.com/plugins/submit)

412 414 

415claude.ai フォームには Team または Enterprise 組織とディレクトリ管理アクセスが必要です。組織の所有者はデフォルトでこのアクセス権を持っています。Team または Enterprise 組織に属していない個別の作成者は、代わりに Console フォームを使用できます。

416 

413送信する前に、ローカルで `claude plugin validate` を実行してください。レビューパイプラインはすべての送信に対して同じチェックを実行し、自動化されたセーフティスクリーニングも行います。417送信する前に、ローカルで `claude plugin validate` を実行してください。レビューパイプラインはすべての送信に対して同じチェックを実行し、自動化されたセーフティスクリーニングも行います。

414 418 

415承認されたプラグインは、[`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) カタログ内の特定のコミット SHA にピン留めされ、CI はリポジトリに新しいコミットをプッシュするたびに自動的にピンをバンプします。公開カタログはレビューパイプラインから毎晩同期されるため、承認と `marketplace.json` にプラグインが表示されるまでの間に遅延が生じる可能性があります。プラグインがインストール可能かどうかを確認するには、[コミュニティカタログ](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json)でその名前を検索してください。419承認されたプラグインは、[`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) カタログ内の特定のコミット SHA にピン留めされ、CI はリポジトリに新しいコミットをプッシュするたびに自動的にピンをバンプします。公開カタログはレビューパイプラインから毎晩同期されるため、承認と `marketplace.json` にプラグインが表示されるまでの間に遅延が生じる可能性があります。プラグインがインストール可能かどうかを確認するには、[コミュニティカタログ](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json)でその名前を検索してください。


512| 共有するには手動でコピーする必要がある | `/plugin install` でインストール |516| 共有するには手動でコピーする必要がある | `/plugin install` でインストール |

513 517 

514<Note>518<Note>

515 移行後、重複を避けるために `.claude/` から元のファイルを削除できます読み込まれたときはプラグインバージョンが優先されます519 移行後、重複を避けるために `.claude/` から元のファイルを削除してくださいプロジェクトおよびユーザーの `.claude/agents/` 定義は同じ名前のプラグインエージェントをオーバーライドするため、元のファイルを削除した後にのみプラグインバージョンが有効になります

516</Note>520</Note>

517 521 

518<h2 id="next-steps">522<h2 id="next-steps">

Details

46* Claude はタスクコンテキストに基づいて自動的にそれらを呼び出すことができます46* Claude はタスクコンテキストに基づいて自動的にそれらを呼び出すことができます

47* Skills は SKILL.md の横にサポートファイルを含めることができます47* Skills は SKILL.md の横にサポートファイルを含めることができます

48 48 

49プラグインに `skills/` ディレクトリがなく、`skills` manifest フィールドがない場合、プラグインルートの `SKILL.md` は単一の skill として読み込まれます。frontmatter の `name` フィールドを設定して、skill の呼び出し名を制御します。これがない場合、Claude Code はインストールディレクトリ名にフォールバックします。マーケットプレイスからインストールされたプラグインの場合、これは更新のたびに変わるバージョン文字列です。複数の skill を配布するプラグインの場合は、上記の `skills/` ディレクトリレイアウトを使用してください。

50 

49詳細については、[Skills](/ja/skills)を参照してください。51詳細については、[Skills](/ja/skills)を参照してください。

50 52 

51<h3 id="agents">53<h3 id="agents">


256**オプションフィールド:**258**オプションフィールド:**

257 259 

258| フィールド | 説明 |260| フィールド | 説明 |

259| :---------------------- | :------------------------------------------- |261| :---------------------- | :--------------------------------------------------------------------------------------------- |

260| `args` | LSP サーバーのコマンドライン引数 |262| `args` | LSP サーバーのコマンドライン引数 |

261| `transport` | 通信トランスポート: `stdio`(デフォルト)または `socket` |263| `transport` | 通信トランスポート: `stdio`(デフォルト)または `socket` |

262| `env` | サーバー起動時に設定する環境変数 |264| `env` | サーバー起動時に設定する環境変数 |


265| `workspaceFolder` | サーバーのワークスペースフォルダーパス |267| `workspaceFolder` | サーバーのワークスペースフォルダーパス |

266| `startupTimeout` | サーバー起動を待つ最大時間(ミリ秒) |268| `startupTimeout` | サーバー起動を待つ最大時間(ミリ秒) |

267| `maxRestarts` | 諦める前の最大再起動試行回数 |269| `maxRestarts` | 諦める前の最大再起動試行回数 |

270| `diagnostics` | 編集後に診断を Claude のコンテキストにプッシュするかどうか(デフォルト `true`)。コードナビゲーションは保持しながら自動診断注入を抑制するには `false` に設定します。 |

268 271 

269<Warning>272<Warning>

270 **言語サーバーバイナリを別途インストールする必要があります。** LSP プラグインは Claude Code が言語サーバーに接続する方法を設定しますが、サーバー自体は含まれていません。`/plugin` Errors タブに `Executable not found in $PATH` が表示される場合は、言語に必要なバイナリをインストールしてください。273 **言語サーバーバイナリを別途インストールする必要があります。** LSP プラグインは Claude Code が言語サーバーに接続する方法を設定しますが、サーバー自体は含まれていません。`/plugin` Errors タブに `Executable not found in $PATH` が表示される場合は、言語に必要なバイナリをインストールしてください。


396| `~/.claude/skills/` | personal | すべてのプロジェクトで。場所があなただけのものだから |399| `~/.claude/skills/` | personal | すべてのプロジェクトで。場所があなただけのものだから |

397| `<cwd>/.claude/skills/` | project | そのフォルダのワークスペース[信頼ダイアログ](/ja/settings)を受け入れた後のみ |400| `<cwd>/.claude/skills/` | project | そのフォルダのワークスペース[信頼ダイアログ](/ja/settings)を受け入れた後のみ |

398 401 

399プロジェクトスコーププラグインはリポジトリにチェックインされ、クローンしたすべての共同作業者に到達します。そのコンテンツはあなたではなくリポジトリから来るため、`.claude/settings.json` を管理するのと同じ信頼ゲートの後にのみ読み込まれます。コードを実行するコンポーネントはさらに制限されます:402プロジェクトスコープ プラグインはリポジトリにチェックインされ、クローンしたすべての共同作業者に到達します。そのコンテンツはあなたではなくリポジトリから来るため、`.claude/settings.json` を管理するのと同じ信頼ゲートの後にのみ読み込まれます。コードを実行するコンポーネントはさらに制限されます:

400 403 

401* 宣言する MCP servers は、プロジェクト `.mcp.json` と同じ[サーバーごとの承認](/ja/mcp)を通過します404* 宣言する MCP servers は、プロジェクト `.mcp.json` と同じ[サーバーごとの承認](/ja/mcp)を通過します

402* LSP servers はワークスペースを信頼した後にのみ開始します405* LSP servers はワークスペースを信頼した後にのみ開始します

403* [バックグラウンド monitors](#monitors)は読み込まれません406* [バックグラウンド monitors](#monitors)は読み込まれません

404 407 

405個人スコーププラグインにはこれらの制限はありません408個人スコープ プラグインにはこれらの制限はありません

406 409 

407<Warning>410<Warning>

408 プロジェクトスコープ `@skills-dir` プラグインは、Claude Code を開始したディレクトリの `.claude/skills/` からのみ読み込まれます。plain skills と commands が行うように[リポジトリルートまでウォークアップ](/ja/skills#automatic-discovery-from-parent-and-nested-directories)しません。そのため、サブディレクトリから起動するとリポジトリルートに存在するプラグインが見つかりません。リポジトリルートから起動するか、ディレクトリを変更した後に `/reload-plugins` を実行してください。411 プロジェクトスコープ `@skills-dir` プラグインは、Claude Code を開始したディレクトリの `.claude/skills/` からのみ読み込まれます。plain skills と commands が行うように[リポジトリルートまでウォークアップ](/ja/skills#automatic-discovery-from-parent-and-nested-directories)しません。そのため、サブディレクトリから起動するとリポジトリルートに存在するプラグインが見つかりません。リポジトリルートから起動するか、ディレクトリを変更した後に `/reload-plugins` を実行してください。


629カスタムパスがプラグインのデフォルトディレクトリを置き換えるか拡張するかは、フィールドによって異なります:632カスタムパスがプラグインのデフォルトディレクトリを置き換えるか拡張するかは、フィールドによって異なります:

630 633 

631* **デフォルトを置き換える**: `commands`、`agents`、`outputStyles`、`experimental.themes`、`experimental.monitors`。たとえば、マニフェストが `commands` を指定する場合、デフォルト `commands/` ディレクトリはスキャンされません。デフォルトを保持してさらに追加するには、明示的にリストします: `"commands": ["./commands/", "./extras/"]`634* **デフォルトを置き換える**: `commands`、`agents`、`outputStyles`、`experimental.themes`、`experimental.monitors`。たとえば、マニフェストが `commands` を指定する場合、デフォルト `commands/` ディレクトリはスキャンされません。デフォルトを保持してさらに追加するには、明示的にリストします: `"commands": ["./commands/", "./extras/"]`

632* **デフォルトに追加**: `skills`。デフォルト `skills/` ディレクトリは常にスキャンされ、`skills` にリストされているディレクトリはそれと一緒に読み込まれます635* **デフォルトに追加**: `skills`。デフォルト `skills/` ディレクトリは常にスキャンされ、`skills` にリストされているディレクトリはそれと一緒に読み込まれます。例外: [マーケットプレイスエントリの `source` がマーケットプレイスルートに解決される](/ja/plugin-marketplaces#advanced-plugin-entries)場合、特定のサブディレクトリを宣言するとスキャンが置き換えられます

633* **独自のマージルール**: [hooks](#hooks)、[MCP servers](#mcp-servers)、[LSP servers](#lsp-servers)。各セクションで複数のソースがどのように結合されるかを参照してください636* **独自のマージルール**: [hooks](#hooks)、[MCP servers](#mcp-servers)、[LSP servers](#lsp-servers)。各セクションで複数のソースがどのように結合されるかを参照してください

634 637 

635プラグインがデフォルトフォルダと一致するマニフェストキーの両方を持つ場合、Claude Code v2.1.140 以降は無視されたフォルダを `/doctor`、`claude plugin list`、および `/plugin` 詳細ビューでフラグします。プラグインはマニフェストパスを使用して読み込まれます。マニフェストキーがデフォルトフォルダを指す場合(例: `"commands": ["./commands/deploy.md"]`)は警告は表示されません。その場合、フォルダは明示的にアドレス指定されているためです。638プラグインがデフォルトフォルダと一致するマニフェストキーの両方を持つ場合、Claude Code v2.1.140 以降は無視されたフォルダを `/doctor`、`claude plugin list`、および `/plugin` 詳細ビューでフラグします。プラグインはマニフェストパスを使用して読み込まれます。マニフェストキーがデフォルトフォルダを指す場合(例: `"commands": ["./commands/deploy.md"]`)は警告は表示されません。その場合、フォルダは明示的にアドレス指定されているためです。


867 plugin init870 plugin init

868</h3>871</h3>

869 872 

870`~/.claude/skills/<name>/` に新しいプラグインをスキャフォルドします。次の Claude Code セッションで、マーケットプレイスもインストール手順もなく、`<name>@skills-dir` として自動的に読み込まれます873`~/.claude/skills/<name>/` に新しいプラグインをスキャフォルドします。次の Claude Code セッションで、`<name>@skills-dir` として自動的に読み込まれ、インストール手順なしで `/plugin` と `claude plugin list` に表示されます

871 874 

872[Skills ディレクトリプラグイン](#skills-directory-plugins)のスコープと信頼要件を参照してください。875[Skills ディレクトリプラグイン](#skills-directory-plugins)のスコープと信頼要件を参照してください。

873 876 


1093| `--available` | マーケットプレイスから利用可能なプラグインを含めます。`--json` が必要です | |1096| `--available` | マーケットプレイスから利用可能なプラグインを含めます。`--json` が必要です | |

1094| `-h, --help` | コマンドのヘルプを表示 | |1097| `-h, --help` | コマンドのヘルプを表示 | |

1095 1098 

1099対話型セッション内では、`/plugin list` は同じリストをインラインで出力します。対話型フォームは `--enabled` または `--disabled` を受け入れて、その状態のプラグインのみを表示し、`ls` を `list` の短縮形として使用できます。

1100 

1096<h3 id="plugin-details">1101<h3 id="plugin-details">

1097 plugin details1102 plugin details

1098</h3>1103</h3>


1113| :----------- | :---------- | :---- |1118| :----------- | :---------- | :---- |

1114| `-h, --help` | コマンドのヘルプを表示 | |1119| `-h, --help` | コマンドのヘルプを表示 | |

1115 1120 

1116出力には、各コンポーネントの 2 つのコスト数値が表示されます1121出力には、各コンポーネントの 2 つのコスト数値が表示されます:

1117 1122 

1118* **Always-on:** スキルの説明、エージェントの説明、コマンド名など、プラグインのリスティングテキストによってすべてのセッションに追加されるトークン。コンポーネントが実行されるかどうかに関係なく追加されます。1123* **Always-on:** スキルの説明、エージェントの説明、コマンド名など、プラグインのリスティングテキストによってすべてのセッションに追加されるトークン。コンポーネントが実行されるかどうかに関係なく追加されます。

1119* **On-invoke:** コンポーネントが実行されるときのコンポーネントのコスト。プラグイン全体ではなくコンポーネントごとに表示されます。これは、典型的なセッションではコンポーネントのサブセットのみを呼び出すためです。1124* **On-invoke:** コンポーネントが実行されるときのコンポーネントのコスト。プラグイン全体ではなくコンポーネントごとに表示されます。これは、典型的なセッションではコンポーネントのサブセットのみを呼び出すためです。

1120 1125 

1121この例は、2 つのスキルを持つプラグインの出力がどのように見えるかを示しています1126この例は、2 つのスキルを持つプラグインの出力がどのように見えるかを示しています:

1122 1127 

1123```1128```

1124dependency-guard 1.2.01129dependency-guard 1.2.0

Details

79 79 

80[`opusplan` モデル設定](/ja/model-config#opusplan-model-setting)は、Plan Mode 中に Opus に、実行中に Sonnet に解決されるため、各 Plan Mode トグルはモデル切り替えであり、新しいキャッシュを開始します。80[`opusplan` モデル設定](/ja/model-config#opusplan-model-setting)は、Plan Mode 中に Opus に、実行中に Sonnet に解決されるため、各 Plan Mode トグルはモデル切り替えであり、新しいキャッシュを開始します。

81 81 

82[Fable 5 での自動モデルフォールバック](/ja/model-config#automatic-model-fallback)もモデル切り替えです。安全性分類器がリクエストにフラグを立てると、Claude Code はデフォルトの Opus モデルで再実行し、セッションはそこで続行されます。

83 

82<h3 id="changing-effort-level">84<h3 id="changing-effort-level">

83 努力レベルの変更85 努力レベルの変更

84</h3>86</h3>


101 MCP サーバーの接続または切断103 MCP サーバーの接続または切断

102</h3>104</h3>

103 105 

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

105 107 

106* **遅延ツール**、サポートされているモデルのデフォルト:サーバーの接続、切断、またはツールリストの変更は、新しいコンテンツのみを追加し、既にキャッシュされているものを妨害しません。108* **遅延ツール**、サポートされているモデルのデフォルト:サーバーの接続、切断、またはツールリストの変更は、新しいコンテンツのみを追加し、既にキャッシュされているものを妨害しません。

107* **プリフィックスに読み込まれるツール**:それらへの変更はキャッシュを無効にします。これは[ツール検索が利用不可または無効](/ja/mcp#configure-tool-search)な場合に発生します。Haiku モデル、Vertex AI、またはカスタム `ANTHROPIC_BASE_URL` ゲートウェイなど。また、[`alwaysLoad`](/ja/mcp#exempt-a-server-from-deferral)とマークされたサーバーまたはツール、および[しきい値ベースの読み込み](/ja/mcp#configure-tool-search)によって前もって保持される定義についても発生します。109* **プリフィックスに読み込まれるツール**:それらへの変更はキャッシュを無効にします。これは[ツール検索が利用不可または無効](/ja/mcp#configure-tool-search)な場合に発生します。Haiku モデル、Vertex AI、またはカスタム `ANTHROPIC_BASE_URL` ゲートウェイなど。また、[`alwaysLoad`](/ja/mcp#exempt-a-server-from-deferral)とマークされたサーバーまたはツール、および[しきい値ベースの読み込み](/ja/mcp#configure-tool-search)によって前もって保持される定義についても発生します。


118 120 

119例外は[MCP サーバー](/ja/plugins-reference#mcp-servers)を提供するプラグインです。1 つを有効化または無効化することは、[MCP サーバーの接続または切断](#connecting-or-disconnecting-an-mcp-server)と同じルールに従います。サーバーのツールが遅延されるとキャッシュが保持され、プリフィックスに読み込まれると次のリクエストは会話全体を再度読み取ります。121例外は[MCP サーバー](/ja/plugins-reference#mcp-servers)を提供するプラグインです。1 つを有効化または無効化することは、[MCP サーバーの接続または切断](#connecting-or-disconnecting-an-mcp-server)と同じルールに従います。サーバーのツールが遅延されるとキャッシュが保持され、プリフィックスに読み込まれると次のリクエストは会話全体を再度読み取ります。

120 122 

121プラグインの変更は、[`/reload-plugins`](/ja/discover-plugins#apply-plugin-changes-without-restarting)を実行するか、新しいセッションを開始するときに適用されます。コスト(追加されたアナウンスメントまたは完全な再読み取り)は、`/plugin install`、`/plugin enable`、または `/plugin disable` を実行するときではなく、リロード後の最初のターンに表示されます。123プラグインの変更は、[`/reload-plugins`](/ja/discover-plugins#apply-plugin-changes-without-restarting)を実行するか、新しいセッションを開始するときに適用されます。コスト(追加されたアナウンスメントまたは完全な再読み取り)は、`/plugin install`、`/plugin enable`、または `/plugin disable` を実行するときではなく、リロード後の最初のターンに表示されます。{/* min-version: 2.1.163 */}v2.1.163 以降、リロードが完全な再読み取りをトリガーする場合、`/reload-plugins` は警告を表示し、リロードを適用しません。`--force` を渡して、とにかく適用します。

122 124 

123セッションの前半で有効にしたプラグインを無効にすると、以前のリクエスト形状が復元されます。そのプリフィックスがまだ[キャッシュライフタイム](#cache-lifetime)内にある場合、次のリクエストは再構築するのではなく、古いキャッシュエントリを読み取ります。125セッションの前半で有効にしたプラグインを無効にすると、以前のリクエスト形状が復元されます。そのプリフィックスがまだ[キャッシュライフタイム](#cache-lifetime)内にある場合、次のリクエストは再構築するのではなく、古いキャッシュエントリを読み取ります。

124 126 


128 130 

129`Bash` や `WebFetch` のような裸のツール名を[拒否ルール](/ja/permissions#manage-permissions)として追加すると、そのツールは Claude のコンテキストから完全に削除されます。組み込みツール定義はシステムプロンプトレイヤーに読み込まれるため、これらのルールの 1 つを追加または削除するとセッション中にキャッシュが無効になります。変更は、`/permissions` を通じて追加するか、[設定ファイルを直接編集](/ja/settings#when-edits-take-effect)するかにかかわらず、次のターンで有効になります。131`Bash` や `WebFetch` のような裸のツール名を[拒否ルール](/ja/permissions#manage-permissions)として追加すると、そのツールは Claude のコンテキストから完全に削除されます。組み込みツール定義はシステムプロンプトレイヤーに読み込まれるため、これらのルールの 1 つを追加または削除するとセッション中にキャッシュが無効になります。変更は、`/permissions` を通じて追加するか、[設定ファイルを直接編集](/ja/settings#when-edits-take-effect)するかにかかわらず、次のターンで有効になります。

130 132 

131裸のツール名、または同等の `Bash(*)` 形式のみがこの効果を持ちます。`Bash(rm *)` のようなスコープ付き拒否ルール、およびすべての許可ルールと質問ルールは、Claude が見るツールを変更しません。Claude Code は Claude が呼び出しを試みるときにそれらをチェックし、プリフィックスをそのままにします。133ツール名位置で一致する拒否ルールのみがこの効果を持ちます。裸のツール名、同等の `Bash(*)` 形式、または[ツール名グロブ](/ja/permissions#tool-name-wildcards)(`"*"` など)。`"mcp__*"` のような MCP ツールのみに一致するグロブは、それらのツールを同じ方法で削除しますが、一致したツールが[遅延](#connecting-or-disconnecting-an-mcp-server)されている場合、デフォルトではキャッシュはそのままです。遅延定義はキャッシュされたプリフィックスに含まれていなかったため。`Bash(rm *)` のようなスコープ付き拒否ルール、およびすべての許可ルールと質問ルールは、Claude が見るツールを変更しません。Claude Code は Claude が呼び出しを試みるときにそれらをチェックし、プリフィックスをそのままにします。

132 134 

133<h3 id="compacting-the-conversation">135<h3 id="compacting-the-conversation">

134 会話のコンパクト化136 会話のコンパクト化


171 リポジトリ内のファイルの編集173 リポジトリ内のファイルの編集

172</h3>174</h3>

173 175 

174ファイルコンテンツはコンテキストに入るのは Claude が読むときだけであり、読み取りは会話に追加されます。Claude が以前読んだファイルを編集しても、履歴内の以前の読み取りは遡及的に変更されません。代わりに、Claude Code はファイルが変更されたことを示す `<system-reminder>` を追加し、必要に応じて Claude が再度読み取ります。176ファイルコンテンツがコンテキストに入るのは Claude が読むときだけであり、読み取りは会話に追加されます。Claude が以前読んだファイルを編集しても、履歴内の以前の読み取りは遡及的に変更されません。代わりに、Claude Code はファイルが変更されたことを示す `<system-reminder>` を追加し、必要に応じて Claude が再度読み取ります。

175 177 

176<h3 id="editing-claude-md-mid-session">178<h3 id="editing-claude-md-mid-session">

177 セッション中の CLAUDE.md の編集179 セッション中の CLAUDE.md の編集


211 213 

212[`/rewind`](/ja/checkpointing)は、会話を以前のターンに切り詰めます。残りの履歴は、その時点でキャッシュが構築されたのと同じコンテンツであり、システムプロンプトとプロジェクトコンテキストレイヤーは変更されないため、次のリクエストは以前のキャッシュエントリにヒットします。それ以降のすべてのターンはそのプリフィックスを通じて読み取られており、元のターンが TTL より長い前であっても、エントリを温かく保ちました。214[`/rewind`](/ja/checkpointing)は、会話を以前のターンに切り詰めます。残りの履歴は、その時点でキャッシュが構築されたのと同じコンテンツであり、システムプロンプトとプロジェクトコンテキストレイヤーは変更されないため、次のリクエストは以前のキャッシュエントリにヒットします。それ以降のすべてのターンはそのプリフィックスを通じて読み取られており、元のターンが TTL より長い前であっても、エントリを温かく保ちました。

213 215 

214会話と一緒にファイルチェックポイントを復元しても、キャッシュに対する個別の効果はありません。ファイルコンテンツはコンテキストに入るのは Claude が読むときだけであり、[リポジトリ内のファイルの編集](#editing-files-in-your-repository)と同じです。216会話と一緒にファイルチェックポイントを復元しても、キャッシュに対する個別の効果はありません。ファイルコンテンツがコンテキストに入るのは Claude が読むときだけであり、[リポジトリ内のファイルの編集](#editing-files-in-your-repository)と同じです。

215 217 

216<h2 id="cache-lifetime">218<h2 id="cache-lifetime">

217 キャッシュライフタイム219 キャッシュライフタイム


219 221 

220キャッシュされたプリフィックスは、非アクティブ期間後に期限切れになります。キャッシュにヒットするすべてのリクエストはタイマーをリセットするため、作業を続ける限りキャッシュは温かく保たれます。十分に長いギャップの後、次のリクエストは完全な入力を再計算し、キャッシュを再確立します。これが、立ち去った後の最初のターンが顕著に遅い理由です。222キャッシュされたプリフィックスは、非アクティブ期間後に期限切れになります。キャッシュにヒットするすべてのリクエストはタイマーをリセットするため、作業を続ける限りキャッシュは温かく保たれます。十分に長いギャップの後、次のリクエストは完全な入力を再計算し、キャッシュを再確立します。これが、立ち去った後の最初のターンが顕著に遅い理由です。

221 223 

222Time to Live(TTL)は、キャッシュが生き残るギャップの長さを制御します。API は 2 つを提供します。5 分の TTL と、より長い休憩を通じてキャッシュを温かく保つ[1 時間の TTL](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching#1-hour-cache-duration)ですが、[キャッシュ書き込みをより高いレートで請求](/ja/build-with-claude/prompt-caching#pricing)します。Claude Code は認証方法に基づいて TTL を選択し、環境変数でオーバーライドできます。224Time to Live(TTL)は、キャッシュが生き残るギャップの長さを制御します。API は 2 つを提供します。5 分の TTL と、より長い休憩を通じてキャッシュを温かく保つ[1 時間の TTL](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching#1-hour-cache-duration)ですが、[キャッシュ書き込みをより高いレートで請求](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching#pricing)します。Claude Code は認証方法に基づいて TTL を選択し、環境変数でオーバーライドできます。

223 225 

224<h3 id="on-a-claude-subscription">226<h3 id="on-a-claude-subscription">

225 Claude サブスクリプション上227 Claude サブスクリプション上


290| `DISABLE_PROMPT_CACHING_HAIKU` | Haiku のみに対して無効にする |292| `DISABLE_PROMPT_CACHING_HAIKU` | Haiku のみに対して無効にする |

291| `DISABLE_PROMPT_CACHING_SONNET` | Sonnet のみに対して無効にする |293| `DISABLE_PROMPT_CACHING_SONNET` | Sonnet のみに対して無効にする |

292| `DISABLE_PROMPT_CACHING_OPUS` | Opus のみに対して無効にする |294| `DISABLE_PROMPT_CACHING_OPUS` | Opus のみに対して無効にする |

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

293 296 

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

295 298 

296<h2 id="related-resources">299<h2 id="related-resources">

297 関連リソース300 関連リソース

quickstart.md +20 −13

Details

118claude118claude

119```119```

120 120 

121セッション情報、最近の会話、および最新の更新を含む Claude Code ウェルカムスクリーンが表示されます。利用可能なコマンドについては `/help` を入力するか、前のセッションを続行するには `/resume` を入力します。121Claude Code プロンプトが表示され、バージョン、現在のモデル、および作業ディレクトリが上に表示されます。利用可能なコマンドについては `/help` を入力するか、前の会話を続行するには `/resume` を入力します。

122 122 

123<Tip>123<Tip>

124 ログイン後(ステップ 2)、認証情報がシステムに保存されます。詳細については、[認証情報管理](/ja/authentication#credential-management)を参照してください。124 ログイン後(ステップ 2)、認証情報がシステムに保存されます。詳細については、[認証情報管理](/ja/authentication#credential-management)を参照してください。


131コードベースを理解することから始めましょう。以下のコマンドのいずれかを試してください:131コードベースを理解することから始めましょう。以下のコマンドのいずれかを試してください:

132 132 

133```text theme={null}133```text theme={null}

134このプロジェクトは何をしていますか?134what does this project do?

135```135```

136 136 

137Claude はファイルを分析して概要を提供します。より具体的な質問をすることもできます:137Claude はファイルを分析して概要を提供します。より具体的な質問をすることもできます:

138 138 

139```text theme={null}139```text theme={null}

140このプロジェクトはどのようなテクノロジーを使用していますか?140what technologies does this project use?

141```141```

142 142 

143```text theme={null}143```text theme={null}

144メインエントリーポイントはどこですか?144where is the main entry point?

145```145```

146 146 

147```text theme={null}147```text theme={null}

148フォルダ構造を説明してください148explain the folder structure

149```149```

150 150 

151Claude 自体の機能について質問することもできます:151Claude 自体の機能について質問することもできます:

152 152 

153```text theme={null}153```text theme={null}

154Claude Code は何ができますか?154what can Claude Code do?

155```155```

156 156 

157```text theme={null}157```text theme={null}

158Claude Code でカスタムスキルを作成するにはどうすればよいですか?158how do I create custom skills in Claude Code?

159```159```

160 160 

161```text theme={null}161```text theme={null}

162Claude Code Docker で動作しますか?162can Claude Code work with Docker?

163```163```

164 164 

165<Note>165<Note>


278 必須コマンド278 必須コマンド

279</h2>279</h2>

280 280 

281日常的に使用する最も重要なコマンドは以下の通りです281日常的に使用する最も重要なコマンドは以下の通りです。シェルコマンドはターミナルから実行して Claude Code を開始または再開します。セッションコマンドは Claude Code 起動後に実行します。

282 

283**シェルコマンド**

282 284 

283| コマンド | 機能 | 例 |285| コマンド | 機能 | 例 |

284| ------------------- | -------------------- | ----------------------------------- |286| ------------------- | -------------------- | ----------------------------------- |


286| `claude "task"` | 1 回限りのタスクを実行する | `claude "fix the build error"` |288| `claude "task"` | 1 回限りのタスクを実行する | `claude "fix the build error"` |

287| `claude -p "query"` | 1 回限りのクエリを実行してから終了する | `claude -p "explain this function"` |289| `claude -p "query"` | 1 回限りのクエリを実行してから終了する | `claude -p "explain this function"` |

288| `claude -c` | 現在のディレクトリで最新の会話を続行する | `claude -c` |290| `claude -c` | 現在のディレクトリで最新の会話を続行する | `claude -c` |

289| `claude -r` | 前のセッションを再開する | `claude -r` |291| `claude -r` | 前の会話を再開する | `claude -r` |

292 

293**セッションコマンド**

294 

295| コマンド | 機能 | 例 |

296| ------------------ | ----------------- | -------- |

290| `/clear` | 会話履歴をクリアする | `/clear` |297| `/clear` | 会話履歴をクリアする | `/clear` |

291| `/help` | 利用可能なコマンドを表示する | `/help` |298| `/help` | 利用可能なコマンドを表示する | `/help` |

292| `exit` または Ctrl+D | Claude Code を終了する | `exit` |299| `/exit` または Ctrl+D | Claude Code を終了する | `/exit` |

293 300 

294コマンドの完全なリストについては、[CLI リファレンス](/ja/cli-reference)を参照してください。301シェルコマンドの完全なリストについては [CLI リファレンス](/ja/cli-reference)を、セッションコマンドの完全なリストについては [コマンドリファレンス](/ja/commands)を参照してください。

295 302 

296<h2 id="pro-tips-for-beginners">303<h2 id="pro-tips-for-beginners">

297 初心者向けのプロのヒント304 初心者向けのプロのヒント


336 </Accordion>343 </Accordion>

337</AccordionGroup>344</AccordionGroup>

338 345 

339<h2 id="what-s-next">346<h2 id="whats-next">

340 次のステップ347 次のステップ

341</h2>348</h2>

342 349 

remote-control.md +79 −34

Details

26 26 

27このページでは、セットアップ、セッションの開始と接続方法、および Remote Control と Web 上の Claude Code の比較について説明します。27このページでは、セットアップ、セッションの開始と接続方法、および Remote Control と Web 上の Claude Code の比較について説明します。

28 28 

29## 要件29<h2 id="requirements">

30 要件

31</h2>

30 32 

31Remote Control を使用する前に、環境が以下の条件を満たしていることを確認してください。33Remote Control を使用する前に、環境が以下の条件を満たしていることを確認してください。

32 34 


34* **認証**: `claude` を実行し、まだサインインしていない場合は `/login` を使用して claude.ai 経由でサインインします。36* **認証**: `claude` を実行し、まだサインインしていない場合は `/login` を使用して claude.ai 経由でサインインします。

35* **ワークスペース信頼**: プロジェクトディレクトリで少なくとも 1 回 `claude` を実行して、ワークスペース信頼ダイアログを受け入れます。37* **ワークスペース信頼**: プロジェクトディレクトリで少なくとも 1 回 `claude` を実行して、ワークスペース信頼ダイアログを受け入れます。

36 38 

37## Remote Control セッションを開始する39<h2 id="start-a-remote-control-session">

40 Remote Control セッションを開始する

41</h2>

38 42 

39CLI または VS Code 拡張機能から Remote Control セッションを開始できます。CLI は 3 つの呼び出しモードを提供します。VS Code は `/remote-control` コマンドを使用します。43CLI または VS Code 拡張機能から Remote Control セッションを開始できます。CLI は 3 つの呼び出しモードを提供します。VS Code は `/remote-control` コマンドを使用します。

40 44 


46 claude remote-control50 claude remote-control

47 ```51 ```

48 52 

49 プロセスはサーバーモードでターミナルで実行され続け、リモート接続を待機します。[別のデバイスから接続](#別のデバイスから接続する) するために使用できるセッション URL が表示され、スペースバーを押して電話からの高速アクセス用の QR コードを表示できます。リモートセッションがアクティブな間、ターミナルは接続ステータスとツールアクティビティを表示します。53 プロセスはサーバーモードでターミナルで実行され続け、リモート接続を待機します。[別のデバイスから接続](#connect-from-another-device)するために使用できるセッション URL が表示され、スペースバーを押して電話からの高速アクセス用の QR コードを表示できます。リモートセッションがアクティブな間、ターミナルは接続ステータスとツールアクティビティを表示します。

50 54 

51 利用可能なフラグ:55 利用可能なフラグ:

52 56 


57 | `--spawn <mode>` | サーバーがセッションを作成する方法。<br />• `same-dir`(デフォルト): すべてのセッションが現在の作業ディレクトリを共有するため、同じファイルを編集している場合は競合する可能性があります。<br />• `worktree`: オンデマンドセッションごとに独自の [git worktree](/ja/worktrees) を取得します。git リポジトリが必要です。<br />• `session`: シングルセッションモード。正確に 1 つのセッションを提供し、追加の接続を拒否します。スタートアップ時にのみ設定します。<br />実行時に `w` を押して `same-dir` と `worktree` の間でトグルします。 |61 | `--spawn <mode>` | サーバーがセッションを作成する方法。<br />• `same-dir`(デフォルト): すべてのセッションが現在の作業ディレクトリを共有するため、同じファイルを編集している場合は競合する可能性があります。<br />• `worktree`: オンデマンドセッションごとに独自の [git worktree](/ja/worktrees) を取得します。git リポジトリが必要です。<br />• `session`: シングルセッションモード。正確に 1 つのセッションを提供し、追加の接続を拒否します。スタートアップ時にのみ設定します。<br />実行時に `w` を押して `same-dir` と `worktree` の間でトグルします。 |

58 | `--capacity <N>` | 同時セッションの最大数。デフォルトは 32 です。`--spawn=session` では使用できません。 |62 | `--capacity <N>` | 同時セッションの最大数。デフォルトは 32 です。`--spawn=session` では使用できません。 |

59 | `--verbose` | 詳細な接続とセッションログを表示します。 |63 | `--verbose` | 詳細な接続とセッションログを表示します。 |

60 | `--sandbox` / `--no-sandbox` | ファイルシステムとネットワーク分離のための [サンドボックス](/ja/sandboxing) を有効または無効にします。デフォルトではオフです。 |64 | `--sandbox` / `--no-sandbox` | ファイルシステムとネットワーク分離のための [サンドボックス](/ja/sandboxing)を有効または無効にします。デフォルトではオフです。 |

61 </Tab>65 </Tab>

62 66 

63 <Tab title="対話型セッション">67 <Tab title="対話型セッション">


89 /remote-control My Project93 /remote-control My Project

90 ```94 ```

91 95 

92 これにより、現在の会話履歴を引き継ぎ、[別のデバイスから接続](#別のデバイスから接続する) するために使用できるセッション URL と QR コードを表示する Remote Control セッションが開始されます。`--verbose`、`--sandbox`、および `--no-sandbox` フラグはこのコマンドでは利用できません。96 これにより、現在の会話履歴を引き継ぎ、Remote Control セッションが開始されます。

97 

98 `--verbose`、`--sandbox`、および `--no-sandbox` フラグはこのコマンドでは利用できません。

93 </Tab>99 </Tab>

94 100 

95 <Tab title="VS Code">101 <Tab title="VS Code">

96 [Claude Code VS Code 拡張機能](/ja/vs-code) で、プロンプトボックスに `/remote-control` または `/rc` を入力するか、`/` でコマンドメニューを開いて選択します。Claude Code v2.1.79 以降が必要です。102 [Claude Code VS Code 拡張機能](/ja/vs-code)で、プロンプトボックスに `/remote-control` または `/rc` を入力するか、`/` でコマンドメニューを開いて選択します。Claude Code v2.1.79 以降が必要です。

97 103 

98 ```text theme={null}104 ```text theme={null}

99 /remote-control105 /remote-control

100 ```106 ```

101 107 

102 プロンプトボックスの上にバナーが表示され、接続ステータスが示されます。接続されたら、バナーの **Open in browser** をクリックしてセッションに直接移動するか、[claude.ai/code](https://claude.ai/code) のセッションリストで見つけます。セッション URL は会話にも投稿されます。108 プロンプトボックスの上にバナーが表示され、接続ステータスが示されます。接続されたら、バナーの **Open in browser** をクリックしてセッションに直接移動するか、[claude.ai/code](https://claude.ai/code)のセッションリストで見つけます。セッション URL は会話にも投稿されます。

103 109 

104 切断するには、バナーの閉じるアイコンをクリックするか、`/remote-control` を再度実行します。110 切断するには、バナーの閉じるアイコンをクリックするか、`/remote-control` を再度実行します。

105 111 


107 </Tab>113 </Tab>

108</Tabs>114</Tabs>

109 115 

110### 別のデバイスから接続する116<h3 id="check-connection-status">

117 接続ステータスを確認する

118</h3>

119 

120対話型ターミナルセッションでは、接続がアップしている間、入力ボックスの下のフッターに `/rc active` インジケーターが表示され、ターミナルが狭すぎる場合は非表示になります。インジケーターテキストは claude.ai のセッションへのリンクです。下矢印キーで選択して Enter キーを押すか、`/remote-control` を再度実行して、セッション URL と [別のデバイスから接続](#connect-from-another-device)するために使用できる QR コードを含むステータスパネルを開きます。

121 

122接続に失敗した場合、インジケーターは赤くなり、`/rc failed` と表示されます。下矢印キーで選択して Enter キーを押すと、失敗の理由と却下オプションが表示されます。または、`/remote-control` を再度実行して再試行します。

123 

124<h3 id="connect-from-another-device">

125 別のデバイスから接続する

126</h3>

111 127 

112Remote Control セッションがアクティブになったら、別のデバイスから接続するいくつかの方法があります。128Remote Control セッションがアクティブになったら、別のデバイスから接続するいくつかの方法があります。

113 129 

114* **セッション URL を開く**: 任意のブラウザで [claude.ai/code](https://claude.ai/code) のセッションに直接移動します。130* **セッション URL を開く**: 任意のブラウザで [claude.ai/code](https://claude.ai/code)のセッションに直接移動します。

115* **QR コードをスキャンする**: セッション URL の横に表示される QR コードをスキャンして、Claude アプリで直接開きます。`claude remote-control` を使用する場合は、スペースバーを押して QR コード表示をトグルします。131* **QR コードをスキャンする**: セッション URL の横に表示される QR コードをスキャンして、Claude アプリで直接開きます。`claude remote-control` を使用する場合は、スペースバーを押して QR コード表示をトグルします。

116* **[claude.ai/code](https://claude.ai/code) または Claude アプリを開く**: セッションリストで名前でセッションを見つけます。Claude モバイルアプリでは、ナビゲーションの **Code** をタップしてセッションリストに到達します。Remote Control セッションはオンラインの場合、コンピュータアイコンと緑色のステータスドットを表示します。132* **[claude.ai/code](https://claude.ai/code)または Claude アプリを開く**: セッションリストで名前でセッションを見つけます。Claude モバイルアプリでは、ナビゲーションの **Code** をタップしてセッションリストに到達します。Remote Control セッションはオンラインの場合、コンピュータアイコンと緑色のステータスドットを表示します。

117 133 

118リモートセッションのタイトルは、この順序で選択されます。134リモートセッションのタイトルは、この順序で選択されます。

119 135 


1223. 既存の会話履歴の最後の意味のあるメッセージ1383. 既存の会話履歴の最後の意味のあるメッセージ

1234. `myhost-graceful-unicorn` のような自動生成名。ここで `myhost` はマシンのホスト名または `--remote-control-session-name-prefix` で設定したプレフィックスです1394. `myhost-graceful-unicorn` のような自動生成名。ここで `myhost` はマシンのホスト名または `--remote-control-session-name-prefix` で設定したプレフィックスです

124 140 

125明示的な名前を設定しなかった場合、タイトルはプロンプトを送信すると更新されて反映されます。claude.ai または Claude アプリからセッションの名前を変更すると、`claude --resume` に表示されるローカルタイトルも更新されます。141明示的な名前を設定しなかった場合、プロンプトを送信するとタイトルが更新されて反映されます{/* min-version: 2.1.176 */}Claude Code v2.1.176 以降、自動生成されたタイトルは会話の言語、または設定されている場合は [`language`](/ja/settings#available-settings) 設定に一致します。claude.ai または Claude アプリからセッションの名前を変更すると、`claude --resume` に表示されるローカルタイトルも更新されます。

126 142 

127環境に既にアクティブなセッションがある場合は、それを続行するか新しいセッションを開始するかを尋ねられます。143環境に既にアクティブなセッションがある場合は、それを続行するか新しいセッションを開始するかを尋ねられます。

128 144 

129Claude アプリをまだ持っていない場合は、Claude Code 内で `/mobile` コマンドを使用して、[iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684) または [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude) のダウンロード QR コードを表示します。145Claude アプリをまだ持っていない場合は、Claude Code 内で `/mobile` コマンドを使用して、[iOS](https://apps.apple.com/us/app/claude-by-anthropic/id6473753684)または [Android](https://play.google.com/store/apps/details?id=com.anthropic.claude)のダウンロード QR コードを表示します。

130 146 

131### すべてのセッションで Remote Control を有効にする147<h3 id="enable-remote-control-for-all-sessions">

148 すべてのセッションで Remote Control を有効にする

149</h3>

132 150 

133デフォルトでは、Remote Control は `claude remote-control`、`claude --remote-control`、または `/remote-control` を明示的に実行した場合にのみアクティブになります。すべての対話型セッションで自動的に有効にするには、Claude Code 内で `/config` を実行し、**Enable Remote Control for all sessions** を `true` に設定します。無効にするには `false` に設定します。Desktop アプリでは、**Settings → Claude Code → Enable remote control by default** からこれをトグルすることもできます。151デフォルトでは、Remote Control は `claude remote-control`、`claude --remote-control`、または `/remote-control` を明示的に実行した場合にのみアクティブになります。すべての対話型セッションで自動的に有効にするには、Claude Code 内で `/config` を実行し、**Enable Remote Control for all sessions** を `true` に設定します。無効にするには `false` に設定します。Desktop アプリでは、**Settings → Claude Code → Enable remote control by default** からこれをトグルすることもできます。

134 152 

135この設定がオンの場合、各対話型 Claude Code プロセスは 1 つのリモートセッションを登録します。複数のインスタンスを実行する場合、各インスタンスは独自の環境とセッションを取得します。単一のプロセスから複数の同時セッションを実行するには、[サーバーモード](#remote-control-セッションを開始する) を使用します。153この設定がオンの場合、各対話型 Claude Code プロセスは 1 つのリモートセッションを登録します。複数のインスタンスを実行する場合、各インスタンスは独自の環境とセッションを取得します。単一のプロセスから複数の同時セッションを実行するには、[サーバーモード](#start-a-remote-control-session)を使用します。

136 154 

137## 接続とセキュリティ155<h2 id="connection-and-security">

156 接続とセキュリティ

157</h2>

138 158 

139ローカル Claude Code セッションは、アウトバウンド HTTPS リクエストのみを行い、マシン上のインバウンドポートを開くことはありません。Remote Control を開始すると、Anthropic API に登録され、作業をポーリングします。別のデバイスから接続すると、サーバーは Web またはモバイルクライアントとローカルセッション間のメッセージをストリーミング接続経由でルーティングします。159ローカル Claude Code セッションは、アウトバウンド HTTPS リクエストのみを行い、マシン上のインバウンドポートを開くことはありません。Remote Control を開始すると、Anthropic API に登録され、作業をポーリングします。別のデバイスから接続すると、サーバーは Web またはモバイルクライアントとローカルセッション間のメッセージをストリーミング接続経由でルーティングします。

140 160 

141すべてのトラフィックは TLS 経由で Anthropic API を通じて移動し、Claude Code セッションと同じトランスポートセキュリティです。接続は複数の短命の認証情報を使用し、各認証情報は単一の目的にスコープされ、独立して有効期限が切れます。161すべてのトラフィックは TLS 経由で Anthropic API を通じて移動し、Claude Code セッションと同じトランスポートセキュリティです。接続は複数の短命の認証情報を使用し、各認証情報は単一の目的にスコープされ、独立して有効期限が切れます。

142 162 

143## Remote Control と Web 上の Claude Code163<h2 id="remote-control-vs-claude-code-on-the-web">

164 Remote Control と Web 上の Claude Code

165</h2>

144 166 

145Remote Control と [Web 上の Claude Code](/ja/claude-code-on-the-web) の両方が claude.ai/code インターフェースを使用します。主な違いはセッションが実行される場所です。Remote Control はマシン上で実行されるため、ローカル MCP サーバー、ツール、プロジェクト設定が利用可能なままです。Web 上の Claude Code は Anthropic が管理するクラウドインフラストラクチャで実行されます。167Remote Control と [Web 上の Claude Code](/ja/claude-code-on-the-web) の両方が claude.ai/code インターフェースを使用します。主な違いはセッションが実行される場所です。Remote Control はマシン上で実行されるため、ローカル MCP サーバー、ツール、プロジェクト設定が利用可能なままです。Web 上の Claude Code は Anthropic が管理するクラウドインフラストラクチャで実行されます。

146 168 

147ローカル作業の途中で別のデバイスから続行したい場合は Remote Control を使用します。ローカルセットアップなしでタスクを開始したい場合、クローンしていないリポジトリで作業したい場合、または複数のタスクを並列で実行したい場合は Web 上の Claude Code を使用します。169ローカル作業の途中で別のデバイスから続行したい場合は Remote Control を使用します。ローカルセットアップなしでタスクを開始したい場合、クローンしていないリポジトリで作業したい場合、または複数のタスクを並列で実行したい場合は Web 上の Claude Code を使用します。

148 170 

149## モバイルプッシュ通知171<h2 id="mobile-push-notifications">

172 モバイルプッシュ通知

173</h2>

150 174 

151Remote Control がアクティブな場合、Claude は電話にプッシュ通知を送信できます。175Remote Control がアクティブな場合、Claude は電話にプッシュ通知を送信できます。

152 176 


172 </Step>196 </Step>

173 197 

174 <Step title="Claude Code でプッシュを有効にする">198 <Step title="Claude Code でプッシュを有効にする">

175 ターミナルで `/config` を実行し、**Push when Claude decides** を有効にします199 ターミナルで `/config` を実行し、プロアクティブな通知の場合は **Push when Claude decides** を有効にし、許可プロンプトと質問の場合は **Push when actions required** を有効にするか、その両方を有効にします

176 </Step>200 </Step>

177</Steps>201</Steps>

178 202 


182* iOS では、フォーカスモードと通知サマリーがプッシュを抑制または遅延させることができます。Settings → Notifications → Claude を確認してください。206* iOS では、フォーカスモードと通知サマリーがプッシュを抑制または遅延させることができます。Settings → Notifications → Claude を確認してください。

183* Android では、積極的なバッテリー最適化が配信を遅延させることができます。システム設定で Claude アプリをバッテリー最適化から除外します。207* Android では、積極的なバッテリー最適化が配信を遅延させることができます。システム設定で Claude アプリをバッテリー最適化から除外します。

184 208 

185## 制限事項209<h2 id="limitations">

210 制限事項

211</h2>

186 212 

187* **対話型プロセスごとに 1 つのリモートセッション**: サーバーモード外では、各 Claude Code インスタンスは一度に 1 つのリモートセッションをサポートします。単一のプロセスから複数の同時セッションを実行するには、[サーバーモード](#start-a-remote-control-session) を使用します。213* **対話型プロセスごとに 1 つのリモートセッション**: サーバーモード外では、各 Claude Code インスタンスは一度に 1 つのリモートセッションをサポートします。単一のプロセスから複数の同時セッションを実行するには、[サーバーモード](#start-a-remote-control-session) を使用します。

188* **ローカルプロセスは実行し続ける必要があります**: Remote Control はローカルプロセスとして実行されます。ターミナルを閉じるか、VS Code を終了するか、または `claude` プロセスを停止すると、セッションは終了します。214* **ローカルプロセスは実行し続ける必要があります**: Remote Control はローカルプロセスとして実行されます。ターミナルを閉じるか、VS Code を終了するか、または `claude` プロセスを停止すると、セッションは終了します。

189* **長時間のネットワーク障害**: マシンが起動しているがおよそ 10 分以上ネットワークに到達できない場合、セッションはタイムアウトしてプロセスは終了します。新しいセッションを開始するには、`claude remote-control` を再度実行します。215* **長時間のネットワーク障害**: マシンが起動しているがおよそ 10 分以上ネットワークに到達できない場合、セッションはタイムアウトしてプロセスは終了します。新しいセッションを開始するには、`claude remote-control` を再度実行します。

190* **Ultraplan は Remote Control を切断します**: [ultraplan](/ja/ultraplan) セッションを開始すると、アクティブな Remote Control セッションが切断されます。両方の機能が claude.ai/code インターフェースを占有し、一度に 1 つだけ接続できるためです。216* **Ultraplan は Remote Control を切断します**: [ultraplan](/ja/ultraplan) セッションを開始すると、アクティブな Remote Control セッションが切断されます。両方の機能が claude.ai/code インターフェースを占有し、一度に 1 つだけ接続できるためです。

191* **一部のコマンドはローカルのみです**: ターミナルで対話型ピッカーを開くコマンド(`/mcp`、`/plugin``/resume` など)はローカル CLI からのみ機能します。テキスト出力を生成するコマンド(`/compact`、`/clear`、`/context`、`/usage`、`/exit`、`/usage-credits`、`/recap`、`/reload-plugins` を含む)はモバイルと Web から機能します。217* **一部のコマンドはローカルのみです**: ターミナルで対話型ピッカーを開くコマンド(`/plugin``/resume` など)はローカル CLI からのみ機能します。テキスト出力を生成するコマンド(`/compact`、`/clear`、`/context`、`/usage`、`/exit`、`/usage-credits`、`/recap`、`/reload-plugins` を含む)はモバイルと Web から機能します。{/* min-version: 2.1.166 */}v2.1.166 以降、`/mcp` もモバイルと Web から機能します。ピッカーを開く代わりにサーバーステータスのテキスト概要を返し、ローカル CLI と同じ `reconnect`、`enable`、`disable` [サブコマンド](/ja/commands#all-commands) を受け入れます。ただし 1 つの違いがあります。モバイルと Web から `/mcp reconnect` をサーバー名なしで実行すると、失敗したか認証が必要なすべてのサーバーを再接続します。一方、ローカル CLI では `reconnect` にサーバー名が必要です。

192 218 

193## トラブルシューティング219<h2 id="troubleshooting">

220 トラブルシューティング

221</h2>

194 222 

195### 「Remote Control には claude.ai サブスクリプションが必要です」223<h3 id="remote-control-requires-a-claude-ai-subscription">

224 「Remote Control には claude.ai サブスクリプションが必要です」

225</h3>

196 226 

197claude.ai アカウントで認証されていません。`claude auth login` を実行して claude.ai オプションを選択してください。`ANTHROPIC_API_KEY` が環境に設定されている場合は、最初に設定を解除してください。227claude.ai アカウントで認証されていません。`claude auth login` を実行して claude.ai オプションを選択してください。`ANTHROPIC_API_KEY` が環境に設定されている場合は、最初に設定を解除してください。

198 228 

199### 「Remote Control には完全スコープのログイントークンが必要です」229<h3 id="remote-control-requires-a-full-scope-login-token">

230 「Remote Control には完全スコープのログイントークンが必要です」

231</h3>

200 232 

201`claude setup-token` または `CLAUDE_CODE_OAUTH_TOKEN` 環境変数からの長命トークンで認証されています。これらのトークンは推論のみに制限されており、Remote Control セッションを確立できません。代わりに `claude auth login` を実行して、完全スコープのセッショントークンで認証してください。233`claude setup-token` または `CLAUDE_CODE_OAUTH_TOKEN` 環境変数からの長命トークンで認証されています。これらのトークンは推論のみに制限されており、Remote Control セッションを確立できません。代わりに `claude auth login` を実行して、完全スコープのセッショントークンで認証してください。

202 234 

203### 「Remote Control 適格性のための組織を決定できません」235<h3 id="unable-to-determine-your-organization-for-remote-control-eligibility">

236 「Remote Control 適格性のための組織を決定できません」

237</h3>

204 238 

205キャッシュされたアカウント情報が古いまたは不完全です。`claude auth login` を実行して更新してください。239キャッシュされたアカウント情報が古いまたは不完全です。`claude auth login` を実行して更新してください。

206 240 

207### 「Remote Control はまだアカウントで有効になっていません」241<h3 id="remote-control-is-not-yet-enabled-for-your-account">

242 「Remote Control はまだアカウントで有効になっていません」

243</h3>

208 244 

209特定の環境変数が存在する場合適格性チェックが失敗する可能性があります245Remote Control ロールアウトがアカウントに到達していないかキャッシュされた権利が古い可能性があります最近プランを変更した場合は、`claude auth logout` を実行してから `claude auth login` を実行して更新してください。`claude doctor` を実行して、どの個別の適格性チェックが失敗したかを確認してください。環境変数の競合、到達不可能なチェック、および組織ポリシーはそれぞれ独自のメッセージを生成するため、このエラーはロールアウトゲート自体を意味します。

210 246 

211* `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` または `DISABLE_TELEMETRY`: それらを設定解除して再度試してください。247<h3 id="couldn’t-verify-remote-control-eligibility">

212* `CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_VERTEX`、または `CLAUDE_CODE_USE_FOUNDRY`: Remote Control は claude.ai 認証が必要であり、サードパーティプロバイダーでは機能しません。248Remote Control 適格性を確認できませんでした」

249</h3>

213 250 

214これらのいずれも設定されていない場合は、`/logout` を実行してから `/login` を実行して更新してください251Claude Code は Remote Control がアカウントで有効になっているかどうかを確認するためにフィーチャーフラグサービスに到達できませんでした。通常オフラインであるか、プロキシがリクエストをブロックしているためです。ネットワークアクセスが可能になったら再度実行するか、詳細については `claude doctor` を実行してください。関連メッセージ「組織の Remote Control ポリシーを確認できませんでした」は同じ原因を持ち、同じ修正があります両方のメッセージは v2.1.178 で追加されました。

215 252 

216### 「Remote Control は組織のポリシーで無効になっています」253<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

254 「Remote Control は組織のポリシーで無効になっています」

255</h3>

217 256 

218このエラーには 4 つの異なる原因があります。最初に `/status` を実行して、使用しているログイン方法とサブスクリプションを確認してください。257このエラーには 4 つの異なる原因があります。最初に `/status` を実行して、使用しているログイン方法とサブスクリプションを確認してください。

219 258 


222* **管理者トグルがグレーアウトしている**: 組織には Remote Control と互換性のないデータ保持またはコンプライアンス設定があります。これは管理パネルから変更することはできません。オプションについて説明するために Anthropic サポートに連絡してください。261* **管理者トグルがグレーアウトしている**: 組織には Remote Control と互換性のないデータ保持またはコンプライアンス設定があります。これは管理パネルから変更することはできません。オプションについて説明するために Anthropic サポートに連絡してください。

223* **エラーに `disableRemoteControl` が記載されている**: IT 管理者が [管理設定](/ja/settings#settings-files) を通じてこのデバイスで Remote Control を無効にしています。これは組織全体のトグルとは関係なく行われています。262* **エラーに `disableRemoteControl` が記載されている**: IT 管理者が [管理設定](/ja/settings#settings-files) を通じてこのデバイスで Remote Control を無効にしています。これは組織全体のトグルとは関係なく行われています。

224 263 

225### 「リモート認証情報の取得に失敗しました」264<h3 id="remote-credentials-fetch-failed">

265 「リモート認証情報の取得に失敗しました」

266</h3>

226 267 

227Claude Code は Anthropic API から短命の認証情報を取得して接続を確立できませんでした。`--verbose` で再度実行して完全なエラーを確認してください。268Claude Code は Anthropic API から短命の認証情報を取得して接続を確立できませんでした。`--verbose` で再度実行して完全なエラーを確認してください。

228 269 


236* ネットワークまたはプロキシの問題: ファイアウォールまたはプロキシがアウトバウンド HTTPS リクエストをブロックしている可能性があります。Remote Control はポート 443 で Anthropic API へのアクセスが必要です。277* ネットワークまたはプロキシの問題: ファイアウォールまたはプロキシがアウトバウンド HTTPS リクエストをブロックしている可能性があります。Remote Control はポート 443 で Anthropic API へのアクセスが必要です。

237* セッション作成に失敗: `Session creation failed — see debug log` も表示される場合、失敗はセットアップの前の段階で発生しました。サブスクリプションがアクティブであることを確認してください。278* セッション作成に失敗: `Session creation failed — see debug log` も表示される場合、失敗はセットアップの前の段階で発生しました。サブスクリプションがアクティブであることを確認してください。

238 279 

239## 適切なアプローチを選択する280<h2 id="choose-the-right-approach">

281 適切なアプローチを選択する

282</h2>

240 283 

241Claude Code offers several ways to work when you're not at your terminal. They differ in what triggers the work, where Claude runs, and how much you need to set up.284Claude Code offers several ways to work when you're not at your terminal. They differ in what triggers the work, where Claude runs, and how much you need to set up.

242 285 


248| [Slack](/en/slack) | Mention `@Claude` in a team channel | Anthropic cloud | [Install the Slack app](/en/slack#setting-up-claude-code-in-slack) with [Claude Code on the web](/en/claude-code-on-the-web) enabled | PRs and reviews from team chat |291| [Slack](/en/slack) | Mention `@Claude` in a team channel | Anthropic cloud | [Install the Slack app](/en/slack#setting-up-claude-code-in-slack) with [Claude Code on the web](/en/claude-code-on-the-web) enabled | PRs and reviews from team chat |

249| [Scheduled tasks](/en/scheduled-tasks) | Set a schedule | [CLI](/en/scheduled-tasks), [Desktop](/en/desktop-scheduled-tasks), or [cloud](/en/routines) | Pick a frequency | Recurring automation like daily reviews |292| [Scheduled tasks](/en/scheduled-tasks) | Set a schedule | [CLI](/en/scheduled-tasks), [Desktop](/en/desktop-scheduled-tasks), or [cloud](/en/routines) | Pick a frequency | Recurring automation like daily reviews |

250 293 

251## 関連リソース294<h2 id="related-resources">

295 関連リソース

296</h2>

252 297 

253* [Web 上の Claude Code](/ja/claude-code-on-the-web): マシン上ではなく Anthropic が管理するクラウド環境でセッションを実行します298* [Web 上の Claude Code](/ja/claude-code-on-the-web): マシン上ではなく Anthropic が管理するクラウド環境でセッションを実行します

254* [Ultraplan](/ja/ultraplan): ターミナルからクラウド計画セッションを起動し、ブラウザで計画を確認します299* [Ultraplan](/ja/ultraplan): ターミナルからクラウド計画セッションを起動し、ブラウザで計画を確認します

255* [チャネル](/ja/channels): Telegram、Discord、または iMessage をセッションに転送して、Claude が離席中にメッセージに反応するようにします300* [チャネル](/ja/channels): Telegram、Discord、または iMessage をセッションに転送して、Claude が離席中にメッセージに反応するようにします

256* [Dispatch](/ja/desktop#dispatch-からのセッション): 電話からタスクをメッセージして、Desktop セッションを生成して処理できます301* [Dispatch](/ja/desktop#sessions-from-dispatch): 電話からタスクをメッセージして、Desktop セッションを生成して処理できます

257* [認証](/ja/authentication): `/login` をセットアップし、claude.ai の認証情報を管理します302* [認証](/ja/authentication): `/login` をセットアップし、claude.ai の認証情報を管理します

258* [CLI リファレンス](/ja/cli-reference): `claude remote-control` を含むフラグとコマンドの完全なリスト303* [CLI リファレンス](/ja/cli-reference): `claude remote-control` を含むフラグとコマンドの完全なリスト

259* [セキュリティ](/ja/security): Remote Control セッションが Claude Code セキュリティモデルにどのように適合するか304* [セキュリティ](/ja/security): Remote Control セッションが Claude Code セキュリティモデルにどのように適合するか

routines.md +1 −1

Details

423 423 

424CLI がどのように構成されているかに関わらず、[claude.ai/code/routines](https://claude.ai/code/routines) でいつでもルーティンを作成および管理できます。424CLI がどのように構成されているかに関わらず、[claude.ai/code/routines](https://claude.ai/code/routines) でいつでもルーティンを作成および管理できます。

425 425 

426<h3 id="routines-are-disabled-by-your-organization-s-policy">426<h3 id="routines-are-disabled-by-your-organizations-policy">

427 「ルーティンは組織のポリシーによって無効になっています」427 「ルーティンは組織のポリシーによって無効になっています」

428</h3>428</h3>

429 429 

Details

94 サンドボックスランタイム94 サンドボックスランタイム

95</h2>95</h2>

96 96 

97[`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime)パッケージは、組み込みの Bash サンドボックスが使用するのと同じ Seatbelt または bubblewrap 分離でプロセス全体をラップします。Claude Code をそれを通して実行すると、Bash だけでなく、セッション内のすべてのツール、hook、MCP サーバーが制限されます。ランタイムはベータ研究プレビューであり、パッケージが進化するにつれて設定形式が変わる可能性があります。97[`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime) パッケージは、組み込みの Bash サンドボックスが使用するのと同じ Seatbelt または bubblewrap 分離でプロセス全体をラップします。Claude Code をそれを通して実行すると、Bash だけでなく、セッション内のすべてのツール、hook、MCP サーバーが制限されます。ランタイムはベータ研究プレビューであり、パッケージが進化するにつれて設定形式が変わる可能性があります。

98 98 

99ランタイムはデフォルトですべての書き込みとネットワークアクセスを拒否するため、Claude Code を起動する前に設定してください。`~/.srt-settings.json` または `--settings` で渡すファイルで、少なくともプロジェクトディレクトリと Claude Code の設定パス `~/.claude` および `~/.claude.json` への書き込みアクセスを許可します。セッションが必要とするネットワークドメイン(`api.anthropic.com` または設定されたプロバイダーのエンドポイントを含む)を許可します。完全な設定スキーマについては、パッケージ [README](https://github.com/anthropic-experimental/sandbox-runtime) を参照してください。99ランタイムはデフォルトですべての書き込みとネットワークアクセスを拒否するため、Claude Code を起動する前に設定してください。`~/.srt-settings.json` または `--settings` で渡すファイルで、少なくともプロジェクトディレクトリと Claude Code の設定パス `~/.claude` および `~/.claude.json` への書き込みアクセスを許可します。セッションが必要とするネットワークドメイン(`api.anthropic.com` または設定されたプロバイダーのエンドポイントを含む)を許可します。完全な設定スキーマについては、パッケージ [README](https://github.com/anthropic-experimental/sandbox-runtime) を参照してください。

100 100 


112 112 

113Dev コンテナは Claude Code を Docker コンテナ内で実行します。VS Code または互換性のあるエディターが管理し、プロジェクトがマウントされます。リポジトリの `.devcontainer/` ディレクトリで独自に定義できます。113Dev コンテナは Claude Code を Docker コンテナ内で実行します。VS Code または互換性のあるエディターが管理し、プロジェクトがマウントされます。リポジトリの `.devcontainer/` ディレクトリで独自に定義できます。

114 114 

115claude-code リポジトリは、デフォルト拒否 iptables ファイアウォールを備えた [example dev container](/ja/devcontainer)を出発点として公開しています。リポジトリにコピーし、ファイアウォール許可リスト、ベースイメージ、ピン留めされた Claude Code バージョンを環境に合わせて調整します。ファイアウォールが未承認の出力をブロックするため、このような設定は無人作業のために `--dangerously-skip-permissions` で Claude Code を実行することをサポートしています。115claude-code リポジトリは、デフォルト拒否 iptables ファイアウォールを備えた [example dev container](/ja/devcontainer) を出発点として公開しています。リポジトリにコピーし、ファイアウォール許可リスト、ベースイメージ、ピン留めされた Claude Code バージョンを環境に合わせて調整します。ファイアウォールが未承認の出力をブロックするため、このような設定は無人作業のために `--dangerously-skip-permissions` で Claude Code を実行することをサポートしています。

116 116 

117<h2 id="custom-container">117<h2 id="custom-container">

118 カスタムコンテナ118 カスタムコンテナ


128 仮想マシン128 仮想マシン

129</h2>129</h2>

130 130 

131専用の仮想マシンは、独自のカーネルと、クラウドまたはmicroVM デプロイメントでは独自の仮想化ハードウェアを備えた最強の分離を提供します。オプションには、クラウドインスタンス、ローカルハイパーバイザー、Firecracker などの microVM が含まれます。131専用の仮想マシンは、独自のカーネルと、クラウドまたは microVM デプロイメントでは独自の仮想化ハードウェアを備えた最強の分離を提供します。オプションには、クラウドインスタンス、ローカルハイパーバイザー、Firecracker などの microVM が含まれます。

132 132 

133信頼できないコードを評価する場合、セキュリティポリシーがエージェントとホスト間のカーネルレベルの分離を要求する場合、またはホストレベルのアプローチがコンプライアンス要件を満たさない場合に、このアプローチを使用します。Docker Desktop の [sandboxes feature](https://docs.docker.com/ai/sandboxes/)は、独自の Docker デーモンとワークスペース同期を備えた microVM を提供し、Docker Desktop が既にインストールされているホストで Claude Code を実行できます。133信頼できないコードを評価する場合、セキュリティポリシーがエージェントとホスト間のカーネルレベルの分離を要求する場合、またはホストレベルのアプローチがコンプライアンス要件を満たさない場合に、このアプローチを使用します。Docker Desktop の [sandboxes feature](https://docs.docker.com/ai/sandboxes/) は、独自の Docker デーモンとワークスペース同期を備えた microVM を提供し、Docker Desktop が既にインストールされているホストで Claude Code を実行できます。

134 134 

135<h2 id="claude-code-on-the-web">135<h2 id="claude-code-on-the-web">

136 Web 上の Claude Code136 Web 上の Claude Code

sandboxing.md +14 −11

Details

134 134 

135* 明示的な [拒否ルール](/ja/permissions)は常に尊重されます135* 明示的な [拒否ルール](/ja/permissions)は常に尊重されます

136* `/`、ホームディレクトリ、または他の重要なシステムパスをターゲットにする `rm` または `rmdir` コマンドは、依然として許可プロンプトをトリガーします136* `/`、ホームディレクトリ、または他の重要なシステムパスをターゲットにする `rm` または `rmdir` コマンドは、依然として許可プロンプトをトリガーします

137* [Ask ルール](/ja/permissions)は、通常の許可フローにフォールバックするコマンドに適用されます137* コンテンツスコープの [ask ルール](/ja/permissions)(`Bash(git push *)` など)は、サンドボックス化されたコマンドでも強制的にプロンプトを表示します

138* 単純な `Bash` ask ルール、または同等の `Bash(*)` 形式は、サンドボックス化されて実行されるコマンドではスキップされます。通常の許可フローにフォールバックするコマンドには依然として適用されます

138 139 

139**通常の許可モード**:すべての Bash コマンドは、サンドボックス化されている場合でも、通常の許可フローを通じます。これはより多くの制御を提供しますが、より多くの承認が必要です。140**通常の許可モード**:すべての Bash コマンドは、サンドボックス化されている場合でも、通常の許可フローを通じます。これはより多くの制御を提供しますが、より多くの承認が必要です。

140 141 

141両方のモードで、サンドボックスは同じファイルシステムとネットワーク制限を実施します。違いは、サンドボックス化されたコマンドが自動承認されるか、明示的な許可が必要かだけです。142両方のモードで、サンドボックスは同じファイルシステムとネットワーク制限を実施します。違いは、サンドボックス化されたコマンドが自動承認されるか、明示的な許可が必要かだけです。

142 143 

144セッション一時ディレクトリは、デフォルトで作業ディレクトリと並んでサンドボックス内で書き込み可能です。Claude Code はサンドボックス化されたコマンドに対して `$TMPDIR` をこのディレクトリに設定するため、一時ファイルを書き込むツールは追加の設定なしで動作します。サンドボックス化されていないコマンドは、シェルの `$TMPDIR` を変更されずに継承します。つまり、サンドボックス化されたコマンドとサンドボックス化されていないコマンドは `$TMPDIR` を異なるディレクトリに解決します。2 つの間で一時ファイルを渡すには、代わりに作業ディレクトリの下に書き込んでください。

145 

143一部のコマンドはサンドボックス内でまったく実行できません。これは、それと互換性がないツール、または許可していないホストが必要なツールなどです。タスクを失敗させたり、サンドボックス化をオフにするよう要求したりするのではなく、Claude Code には意図的なエスケープハッチが含まれています。サンドボックス制限のためにコマンドが失敗した場合、Claude は失敗を分析し、`dangerouslyDisableSandbox` パラメータでコマンドを再試行する可能性があります。再試行されたコマンドはサンドボックス外で実行されるため、通常の許可フローを通じて実行され、承認が必要です。146一部のコマンドはサンドボックス内でまったく実行できません。これは、それと互換性がないツール、または許可していないホストが必要なツールなどです。タスクを失敗させたり、サンドボックス化をオフにするよう要求したりするのではなく、Claude Code には意図的なエスケープハッチが含まれています。サンドボックス制限のためにコマンドが失敗した場合、Claude は失敗を分析し、`dangerouslyDisableSandbox` パラメータでコマンドを再試行する可能性があります。再試行されたコマンドはサンドボックス外で実行されるため、通常の許可フローを通じて実行され、承認が必要です。

144 147 

145このエスケープハッチは、[サンドボックス設定](/ja/settings#sandbox-settings)で `"allowUnsandboxedCommands": false` を設定することで無効化できます。無効化されると、`dangerouslyDisableSandbox` パラメータは完全に無視され、すべてのコマンドはサンドボックス化されるか、`excludedCommands` に明示的にリストされている必要があります。148このエスケープハッチは、[サンドボックス設定](/ja/settings#sandbox-settings)で `"allowUnsandboxedCommands": false` を設定することで無効化できます。無効化されると、`/sandbox` Overrides タブに **Strict sandbox mode** として表示されます。`dangerouslyDisableSandbox` パラメータは完全に無視され、すべてのコマンドはサンドボックス化されるか、`excludedCommands` に明示的にリストされている必要があります。

146 149 

147<Info>150<Info>

148 自動許可モードは許可モード設定とは独立して動作します。「編集を受け入れる」モードでない場合でも、自動許可が有効な場合、サンドボックス化された Bash コマンドは自動的に実行されます。これは、ファイル編集ツールが通常は承認を必要とする場合でも、サンドボックス境界内のファイルを変更する Bash コマンドはプロンプトなしに実行されることを意味します。151 自動許可モードは許可モード設定とは独立して動作します。「編集を受け入れる」モードでない場合でも、自動許可が有効な場合、サンドボックス化された Bash コマンドは自動的に実行されます。これは、ファイル編集ツールが通常は承認を必要とする場合でも、サンドボックス境界内のファイルを変更する Bash コマンドはプロンプトなしに実行されることを意味します。


154 157 

155`settings.json` ファイルを通じてサンドボックス動作をカスタマイズします。完全な設定リファレンスについては [Settings](/ja/settings#sandbox-settings) を参照してください。158`settings.json` ファイルを通じてサンドボックス動作をカスタマイズします。完全な設定リファレンスについては [Settings](/ja/settings#sandbox-settings) を参照してください。

156 159 

157デフォルトでは、サンドボックス化されたコマンドは現在の作業ディレクトリにのみ書き込みできます。`kubectl`、`terraform`、`npm` などのサブプロセスコマンドがプロジェクトディレクトリ外に書き込む必要がある場合、`sandbox.filesystem.allowWrite` を使用して特定のパスへのアクセスを付与します。160デフォルトでは、サンドボックス化されたコマンドは現在の作業ディレクトリとセッション一時ディレクトリにのみ書き込みできます。`kubectl`、`terraform`、`npm` などのサブプロセスコマンドがこれらのディレクトリ外に書き込む必要がある場合、`sandbox.filesystem.allowWrite` を使用して特定のパスへのアクセスを付与します。

158 161 

159```json theme={null}162```json theme={null}

160{163{


169 172 

170これらのパスは OS レベルで実施されるため、サンドボックス内で実行されるすべてのコマンド(その子プロセスを含む)がそれらを尊重します。これは、`excludedCommands` でツールをサンドボックスから除外するのではなく、ツールが特定の場所への書き込みアクセスを必要とする場合の推奨アプローチです。173これらのパスは OS レベルで実施されるため、サンドボックス内で実行されるすべてのコマンド(その子プロセスを含む)がそれらを尊重します。これは、`excludedCommands` でツールをサンドボックスから除外するのではなく、ツールが特定の場所への書き込みアクセスを必要とする場合の推奨アプローチです。

171 174 

172同じファイルシステム配列が複数の [設定スコープ](/ja/settings#settings-precedence)で定義されている場合、配列はマージされます。すべてのスコープからのパスが結合され、置き換えられません。175同じファイルシステム配列が複数の [設定スコープ](/ja/settings#settings-precedence) で定義されている場合、配列はマージされます。すべてのスコープからのパスが結合され、置き換えられません。

173 176 

174パスプレフィックスはパスの解決方法を制御します。177パスプレフィックスはパスの解決方法を制御します。

175 178 


179| `~/` | ホームディレクトリからの相対パス | `~/.kube` は `$HOME/.kube` になります |182| `~/` | ホームディレクトリからの相対パス | `~/.kube` は `$HOME/.kube` になります |

180| `./` またはプレフィックスなし | プロジェクト設定の場合はプロジェクトルートからの相対パス、またはユーザー設定の場合は `~/.claude` からの相対パス | `.claude/settings.json` の `./output` は `<project-root>/output` に解決されます |183| `./` またはプレフィックスなし | プロジェクト設定の場合はプロジェクトルートからの相対パス、またはユーザー設定の場合は `~/.claude` からの相対パス | `.claude/settings.json` の `./output` は `<project-root>/output` に解決されます |

181 184 

182この構文は [Read と Edit 許可ルール](/ja/permissions#read-and-edit)とは異なります。これらは絶対パスに `//path` を使用し、プロジェクト相対に `/path` を使用します。サンドボックスファイルシステムパスは標準的な規則を使用します。`/tmp/build` は絶対パスです。185この構文は [Read と Edit 許可ルール](/ja/permissions#read-and-edit) とは異なります。これらは絶対パスに `//path` を使用し、プロジェクト相対に `/path` を使用します。サンドボックスファイルシステムパスは標準的な規則を使用します。`/tmp/build` は絶対パスです。

183 186 

184`sandbox.filesystem.denyWrite` と `sandbox.filesystem.denyRead` を使用して書き込みまたは読み取りアクセスを拒否することもでき、`sandbox.filesystem.allowRead` を使用して拒否された領域内の特定のパスの読み取りを再度許可できます。187`sandbox.filesystem.denyWrite` と `sandbox.filesystem.denyRead` を使用して書き込みまたは読み取りアクセスを拒否することもでき、`sandbox.filesystem.allowRead` を使用して拒否された領域内の特定のパスの読み取りを再度許可できます。

185 188 


209 212 

210サンドボックス化された Bash ツールはファイルシステムアクセスを特定のディレクトリに制限します。213サンドボックス化された Bash ツールはファイルシステムアクセスを特定のディレクトリに制限します。

211 214 

212* **デフォルトの書き込み動作**:現在の作業ディレクトリとそのサブディレクトリへの読み取りおよび書き込みアクセス215* **デフォルトの書き込み動作**:現在の作業ディレクトリとそのサブディレクトリへの読み取りおよび書き込みアクセス、加えて `$TMPDIR` が指すセッション一時ディレクトリへのアクセス

213* **デフォルトの読み取り動作**:特定の拒否ディレクトリを除く、コンピュータ全体への読み取りアクセス。このデフォルトは `~/.aws/credentials` や `~/.ssh/` などの認証情報ファイルの読み取りを許可することに注意してください。これらをブロックするには、`denyRead` に追加してください。216* **デフォルトの読み取り動作**:特定の拒否ディレクトリを除く、コンピュータ全体への読み取りアクセス。このデフォルトは `~/.aws/credentials` や `~/.ssh/` などの認証情報ファイルの読み取りを許可することに注意してください。これらをブロックするには、`denyRead` に追加してください。

214* **ブロックされたアクセス**:明示的な許可なしに現在の作業ディレクトリ外のファイルを変更できません。これには `~/.bashrc` などのシェル設定ファイルと `/bin/` のシステムバイナリが含まれます。217* **ブロックされたアクセス**:明示的な許可なしに現在の作業ディレクトリおよびセッション一時ディレクトリ外のファイルを変更できません。これには `~/.bashrc` などのシェル設定ファイルと `/bin/` のシステムバイナリが含まれます。

215* **Git worktrees**:作業ディレクトリが[リンクされた git worktree](/ja/worktrees)の場合、サンドボックスはメインリポジトリの共有 `.git` ディレクトリへの書き込みも許可するため、`git commit` などのコマンドが refs とインデックスを更新できます。そのディレクトリ内の `hooks/` と `config` への書き込みは引き続き拒否されます。218* **Git worktrees**:作業ディレクトリが[リンクされた git worktree](/ja/worktrees)の場合、サンドボックスはメインリポジトリの共有 `.git` ディレクトリへの書き込みも許可するため、`git commit` などのコマンドが refs とインデックスを更新できます。そのディレクトリ内の `hooks/` と `config` への書き込みは引き続き拒否されます。

216* **設定可能**:設定を通じてカスタム許可パスと拒否パスを定義します219* **設定可能**:設定を通じてカスタム許可パスと拒否パスを定義します

217 220 


369 372 

370* **コマンドがホスト許可なしエラーで失敗する**:多くの CLI ツールは特定のホストに到達する必要があります。プロンプトが表示されたときに許可を付与すると、ホストが許可リストに追加されるため、ツールは将来サンドボックス内で実行されます。373* **コマンドがホスト許可なしエラーで失敗する**:多くの CLI ツールは特定のホストに到達する必要があります。プロンプトが表示されたときに許可を付与すると、ホストが許可リストに追加されるため、ツールは将来サンドボックス内で実行されます。

371* **`jest` がハングまたは失敗する**:`watchman` はサンドボックスと互換性がありません。代わりに `jest --no-watchman` を実行してください。374* **`jest` がハングまたは失敗する**:`watchman` はサンドボックスと互換性がありません。代わりに `jest --no-watchman` を実行してください。

372* **Go ベースの CLI が macOS で TLS 検証に失敗する**:`gh`、`gcloud`、`terraform` などのツールは Seatbelt の下で TLS 検証に失敗する可能性があります。これらのツールを `excludedCommands` にリストして、サンドボックス外で実行してください。`httpProxyPort` を MITM プロキシとカスタム CA で使用している場合は、代わりに [`enableWeakerNetworkIsolation`](/ja/settings#sandbox-settings)を `true` に設定してください。375* **Go ベースの CLI が macOS で TLS 検証に失敗する**:`gh`、`gcloud`、`terraform` などのツールは Seatbelt の下で TLS 検証に失敗する可能性があります。これらのツールを `excludedCommands` にリストして、サンドボックス外で実行してください。`httpProxyPort` を MITM プロキシとカスタム CA で使用している場合は、代わりに [`enableWeakerNetworkIsolation`](/ja/settings#sandbox-settings) を `true` に設定してください。

373* **`docker` コマンドが失敗する**:`docker` はサンドボックスと互換性がありません。`docker *` を `excludedCommands` に追加して、サンドボックス外で実行してください。376* **`docker` コマンドが失敗する**:`docker` はサンドボックスと互換性がありません。`docker *` を `excludedCommands` に追加して、サンドボックス外で実行してください。

374* **Bubblewrap がコンテナ内で起動に失敗する**:非特権コンテナでは、bubblewrap は新しい `/proc` ファイルシステムをマウントできません。[`enableWeakerNestedSandbox`](/ja/settings#sandbox-settings)を `true` に設定して、内部サンドボックスがコンテナの既存の `/proc` をバインドマウントするようにしてください。このオプションは、外部コンテナが既に必要な分離境界を提供する場合にのみ使用してください。新しい `/proc` マウントが隠すサンドボックス化されたコマンドにプロセス情報を公開するためです。377* **Bubblewrap がコンテナ内で起動に失敗する**:非特権コンテナでは、bubblewrap は新しい `/proc` ファイルシステムをマウントできません。[`enableWeakerNestedSandbox`](/ja/settings#sandbox-settings) を `true` に設定して、内部サンドボックスがコンテナの既存の `/proc` をバインドマウントするようにしてください。このオプションは、外部コンテナが既に必要な分離境界を提供する場合にのみ使用してください。新しい `/proc` マウントが隠すサンドボックス化されたコマンドにプロセス情報を公開するためです。

375* **Linux の Seccomp フィルター**:seccomp フィルターは Unix ドメインソケットをブロックするために必要です。`/sandbox` の Dependencies タブに、それが利用可能かどうかが表示されます。不足している場合は、`npm install -g @anthropic-ai/sandbox-runtime` を実行してヘルパーをインストールしてください。378* **Linux の Seccomp フィルター**:seccomp フィルターは Unix ドメインソケットをブロックするために必要です。`/sandbox` の Dependencies タブに、それが利用可能かどうかが表示されます。不足している場合は、`npm install -g @anthropic-ai/sandbox-runtime` を実行してヘルパーをインストールしてください。

376* **`--dangerously-skip-permissions` が root として失敗する**:このフラグは Linux と macOS で root として実行するか sudo 経由で実行する場合にブロックされます。root アクセスと許可プロンプトなしを組み合わせるとシステム上のあらゆるファイルまたはサービスを変更できるためです。チェックは認識されたサンドボックス内で自動的にスキップされます。コンテナで自律的に実行するには、[dev container](/ja/devcontainer)設定を使用してください。これは Claude Code を非 root ユーザーとして実行します。379* **`--dangerously-skip-permissions` が root として失敗する**:このフラグは Linux と macOS で root として実行するか sudo 経由で実行する場合にブロックされます。root アクセスと許可プロンプトなしを組み合わせるとシステム上のあらゆるファイルまたはサービスを変更できるためです。チェックは認識されたサンドボックス内で自動的にスキップされます。コンテナで自律的に実行するには、[dev container](/ja/devcontainer) 設定を使用してください。これは Claude Code を非 root ユーザーとして実行します。

377 380 

378<h2 id="limitations">381<h2 id="limitations">

379 制限事項382 制限事項


410 413 

411サンドボックスは Bash サブプロセスを分離します。他のツールは異なる境界の下で動作します。414サンドボックスは Bash サブプロセスを分離します。他のツールは異なる境界の下で動作します。

412 415 

413* **組み込みファイルツール**:Read、Edit、Write はサンドボックスを通じて実行するのではなく、許可システムを直接使用します。[permissions](/ja/permissions) を参照してください。416* **組み込みファイルツール**:Read、Edit、Write はサンドボックスを通じて実行するのではなく、許可システムを直接使用します。[permissions](/ja/permissions)を参照してください。

414* **コンピュータ使用**:Claude がアプリを開いてスクリーンを制御する場合、分離された環境ではなく実際のデスクトップで実行されます。アプリごとの許可プロンプトが各アプリケーションをゲートします。[CLI でのコンピュータ使用](/ja/computer-use)または [Desktop でのコンピュータ使用](/ja/desktop#let-claude-use-your-computer)を参照してください。417* **コンピュータ使用**:Claude がアプリを開いてスクリーンを制御する場合、分離された環境ではなく実際のデスクトップで実行されます。アプリごとの許可プロンプトが各アプリケーションをゲートします。[CLI でのコンピュータ使用](/ja/computer-use)または [Desktop でのコンピュータ使用](/ja/desktop#let-claude-use-your-computer)を参照してください。

415* **環境変数**:サンドボックス化された Bash コマンドはデフォルトで親プロセス環境を継承します。そこに設定されたすべての認証情報を含みます。サブプロセスから Anthropic とクラウドプロバイダーの認証情報を削除するには、[`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ja/env-vars)を設定してください。418* **環境変数**:サンドボックス化された Bash コマンドはデフォルトで親プロセス環境を継承します。そこに設定されたすべての認証情報を含みます。サブプロセスから Anthropic とクラウドプロバイダーの認証情報を削除するには、[`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/ja/env-vars)を設定してください。

416* **サブエージェント**:[subagents](/ja/sub-agents)は親セッションと同じプロセスで実行され、同じサンドボックス設定を使用します。親セッションでサンドボックス化が有効な場合、サブエージェント内の Bash コマンドはサンドボックス化されます。419* **サブエージェント**:[subagents](/ja/sub-agents)は親セッションと同じプロセスで実行され、同じサンドボックス設定を使用します。親セッションでサンドボックス化が有効な場合、サブエージェント内の Bash コマンドはサンドボックス化されます。

Details

239セッションスコープのスケジューリングには固有の制約があります。239セッションスコープのスケジューリングには固有の制約があります。

240 240 

241* タスクは Claude Code が実行中でアイドル状態の場合にのみ実行されます。ターミナルを閉じるか、セッションを終了すると、タスクは実行を停止します。241* タスクは Claude Code が実行中でアイドル状態の場合にのみ実行されます。ターミナルを閉じるか、セッションを終了すると、タスクは実行を停止します。

242* 見落とされた火災のキャッチアップはありません。タスクのスケジュール済み時間が Claude が長時間実行されるリクエストでビジーの間に経過した場合、Claude がアイドル状態になったときに 1 回実行され、見落とされた間隔ごとに 1 回ではありません。242* 見落とされた実行のキャッチアップはありません。タスクのスケジュール済み時間が Claude が長時間実行されるリクエストでビジーの間に経過した場合、Claude がアイドル状態になったときに 1 回実行され、見落とされた間隔ごとに 1 回ではありません。

243* 新しい会話を開始すると、すべてのセッションスコープのタスクがクリアされます。`claude --resume` または `claude --continue` で再開すると、有効期限切れになっていないタスクが復元されます。過去 7 日以内に作成された定期的なタスク、およびスケジュール済み時間がまだ経過していない 1 回限りのタスク。バックグラウンド Bash およびモニタータスクは再開時に復元されることはありません。243* 新しい会話を開始すると、すべてのセッションスコープのタスクがクリアされます。`claude --resume` または `claude --continue` で再開すると、有効期限切れになっていないタスクが復元されます。過去 7 日以内に作成された定期的なタスク、およびスケジュール済み時間がまだ経過していない 1 回限りのタスク。バックグラウンド Bash およびモニタータスクは再開時に復元されることはありません。

244 244 

245無人で実行する必要がある cron 駆動オートメーションの場合は、以下を使用してください。245無人で実行する必要がある cron 駆動オートメーションの場合は、以下を使用してください。

security.md +4 −4

Details

22 22 

23Claude Code はデフォルトで厳密な読み取り専用パーミッションを使用します。追加のアクション(ファイルの編集、テストの実行、コマンドの実行)が必要な場合、Claude Code は明示的なパーミッションをリクエストします。ユーザーは、アクションを 1 回だけ承認するか、自動的に許可するかを制御できます。23Claude Code はデフォルトで厳密な読み取り専用パーミッションを使用します。追加のアクション(ファイルの編集、テストの実行、コマンドの実行)が必要な場合、Claude Code は明示的なパーミッションをリクエストします。ユーザーは、アクションを 1 回だけ承認するか、自動的に許可するかを制御できます。

24 24 

25Claude Code は透明性とセキュリティを備えるように設計されています例えばbash コマンドを実行する前に承認が必要であり直接制御できます。このアプローチにより、ユーザーと組織はパーミッションを直接設定できます。25Claude Code は Bash コマンドを実行する前に承認が必要ですこのコマンドはシステムを変更できます。`ls``cat``git status` などの読み取り専用コマンドの組み込みセットはプロンプトなしで実行されます。このアプローチにより、ユーザーと組織はパーミッションを直接設定できます。

26 26 

27詳細なパーミッション設定については、[Permissions](/ja/permissions) を参照してください。27詳細なパーミッション設定については、[Permissions](/ja/permissions) を参照してください。

28 28 


56* **パーミッションシステム**: 機密操作には明示的な承認が必要です56* **パーミッションシステム**: 機密操作には明示的な承認が必要です

57* **コンテキスト認識分析**: 完全なリクエストを分析して潜在的に有害な指示を検出します57* **コンテキスト認識分析**: 完全なリクエストを分析して潜在的に有害な指示を検出します

58* **入力サニタイゼーション**: ユーザー入力を処理することでコマンドインジェクションを防止します58* **入力サニタイゼーション**: ユーザー入力を処理することでコマンドインジェクションを防止します

59* **コマンドブロックリスト**: `curl` や `wget` のようにウェブから任意のコンテンツを取得するリスクのあるコマンドをデフォルトでブロックします明示的に許可する場合は、[パーミッションパターンの制限](/ja/permissions#tool-specific-permission-rules) に注意してください59* **ネットワークコマンド承認**: `curl` や `wget` などのウェブからコンテンツを取得するコマンドはデフォルトでは自動承認されません他の読み取り専用以外の Bash コマンドと同様にプロンプトが表示されるため一度承認するか、`Bash(curl *)` のような明示的な許可ルールを追加できます。完全にブロックするには、[`permissions.deny`](/ja/permissions#tool-specific-permission-rules) に追加してください

60 60 

61<h3 id="privacy-safeguards">61<h3 id="privacy-safeguards">

62 プライバシーセーフガード62 プライバシーセーフガード


77* **ネットワークリクエスト承認**: ネットワークリクエストを行うツールはデフォルトでユーザー承認が必要です77* **ネットワークリクエスト承認**: ネットワークリクエストを行うツールはデフォルトでユーザー承認が必要です

78* **分離されたコンテキストウィンドウ**: Web fetch は潜在的に悪意のあるプロンプトの注入を避けるために別のコンテキストウィンドウを使用します78* **分離されたコンテキストウィンドウ**: Web fetch は潜在的に悪意のあるプロンプトの注入を避けるために別のコンテキストウィンドウを使用します

79* **信頼検証**: 初回のコードベース実行と新しい MCP サーバーには信頼検証が必要です79* **信頼検証**: 初回のコードベース実行と新しい MCP サーバーには信頼検証が必要です

80 * 注:信頼検証は `-p` フラグで非対話的に実行する場合は無効になります。例外は [`--worktree`](/ja/worktrees) で、これはディレクトリに対して信頼が受け入れられていることが必要です80 * 注:信頼検証は `-p` フラグで非対話的に実行する場合は無効になります

81 * 注:Claude Code をホームディレクトリで直接起動する場合、信頼受け入れは現在のセッションのみ保持され、ディスクに書き込まれないため、起動するたびにプロンプトが再度表示されます。これを永続化するための設定はありません。代わりに、プロジェクトサブディレクトリから Claude Code を起動してください。そこでは信頼受け入れはディレクトリごとに保存されます81 * 注:Claude Code をホームディレクトリで直接起動する場合、信頼受け入れは現在のセッションのみ保持され、ディスクに書き込まれないため、起動するたびにプロンプトが再度表示されます。これを永続化するための設定はありません。代わりに、プロジェクトサブディレクトリから Claude Code を起動してください。そこでは信頼受け入れはディレクトリごとに保存されます

82* **コマンドインジェクション検出**: 疑わしい bash コマンドは、以前にホワイトリストに登録されていても手動承認が必要です82* **コマンドインジェクション検出**: 疑わしい bash コマンドは、以前にホワイトリストに登録されていても手動承認が必要です

83* **フェイルクローズドマッチング**: マッチしないコマンドはデフォルトで手動承認が必要です83* **フェイルクローズドマッチング**: マッチしないコマンドはデフォルトで手動承認が必要です

84* **自然言語説明**: 複雑な bash コマンドにはユーザーの理解のための説明が含まれます84* **自然言語説明**: 複雑な bash コマンドにはユーザーの理解のための説明が含まれます

85* **セキュアな認証情報ストレージ**: API キーとトークンは暗号化されます。[Credential Management](/ja/authentication#credential-management) を参照してください85* **セキュアな認証情報ストレージ**: API キーとトークンは利用可能な場合は macOS Keychain に保存され、Windows と Linux ではファイルパーミッションで保護されます。[Credential Management](/ja/authentication#credential-management) を参照してください

86 86 

87<Warning>87<Warning>

88 **Windows WebDAV セキュリティリスク**: Windows で Claude Code を実行する場合、WebDAV を有効にしたり、Claude Code に `\\*` などの WebDAV サブディレクトリを含む可能性のあるパスへのアクセスを許可することはお勧めしません。[WebDAV は Microsoft によって非推奨になっています](https://learn.microsoft.com/en-us/windows/whats-new/deprecated-features#:~:text=The%20Webclient%20\(WebDAV\)%20service%20is%20deprecated) セキュリティリスクのため。WebDAV を有効にすると、Claude Code がリモートホストへのネットワークリクエストをトリガーし、パーミッションシステムをバイパスする可能性があります。88 **Windows WebDAV セキュリティリスク**: Windows で Claude Code を実行する場合、WebDAV を有効にしたり、Claude Code に `\\*` などの WebDAV サブディレクトリを含む可能性のあるパスへのアクセスを許可することはお勧めしません。[WebDAV は Microsoft によって非推奨になっています](https://learn.microsoft.com/en-us/windows/whats-new/deprecated-features#:~:text=The%20Webclient%20\(WebDAV\)%20service%20is%20deprecated) セキュリティリスクのため。WebDAV を有効にすると、Claude Code がリモートホストへのネットワークリクエストをトリガーし、パーミッションシステムをバイパスする可能性があります。

Details

172 172 

173Claude Code は設定の更新を自動的に適用します。ただし、OpenTelemetry 構成などの高度な設定は、有効にするために完全な再起動が必要です。173Claude Code は設定の更新を自動的に適用します。ただし、OpenTelemetry 構成などの高度な設定は、有効にするために完全な再起動が必要です。

174 174 

175<h3 id="invalid-entries-in-delivered-settings">

176 配信された設定の無効なエントリ

177</h3>

178 

179配信されたペイロードは、他の管理ソースと同じルールで寛容にパースされます。ペイロードにスキーマ検証に失敗するエントリが含まれている場合、Claude Code はそのエントリを削除し、検証エラーを表示し、残りのすべての有効な設定を適用します。セキュリティ強制フィールドの処理方法を含むフィールドレベルの動作については、[管理設定の無効なエントリ](/ja/settings#invalid-entries-in-managed-settings)を参照してください。Claude Code v2.1.169 以降が必要です。

180 

181サーバー管理配信は、これらの動作を追加します。

182 

183* `~/.claude/remote-settings.json` のキャッシュは、無効なエントリが削除された救済されたペイロードを保存します。生の無効なペイロードは永続化されません。

184* ペイロード内のフィールドが救済できない場合、Claude Code は最後に受け入れられたキャッシュされた設定を保持し、致命的なエラーを記録します。

185* [セキュリティ承認ダイアログ](#security-approval-dialogs)は救済されたペイロードを評価するため、削除された無効なエントリは承認のために提示されず、実行されません。

186 

187配信の問題をデバッグするには、`claude --debug-file <path>` を実行し、ログで `Remote settings` を検索してください。組織にロールアウトする前に、テストマシンで `claude doctor` を使用してペイロード変更を検証してください。

188 

175<h3 id="enforce-fail-closed-startup">189<h3 id="enforce-fail-closed-startup">

176 強制的にクローズされた起動を適用する190 強制的にクローズされた起動を適用する

177</h3>191</h3>


249 関連項目263 関連項目

250</h2>264</h2>

251 265 

252Claude Code 構成を管理するための関連ページ266Claude Code 構成を管理するための関連ページ

253 267 

254* [Settings](/ja/settings):すべての利用可能な設定を含む完全な構成リファレンス268* [Settings](/ja/settings):すべての利用可能な設定を含む完全な構成リファレンス

255* [Endpoint-managed settings](/ja/settings#settings-files):IT によってデバイスに配置される管理設定269* [Endpoint-managed settings](/ja/settings#settings-files):IT によってデバイスに配置される管理設定

sessions.md +9 −9

Details

30| `claude --from-pr <number>` | そのプルリクエストにリンクされたセッションを再開します |30| `claude --from-pr <number>` | そのプルリクエストにリンクされたセッションを再開します |

31| `/resume` | アクティブなセッション内から別の会話に切り替えます |31| `/resume` | アクティブなセッション内から別の会話に切り替えます |

32 32 

33[`claude -p`](/ja/headless)または [Agent SDK](/ja/agent-sdk/overview)で作成されたセッションはセッションピッカーに表示されませんが、セッション ID を `claude --resume <session-id>` に渡すことで再開できます。33[`claude -p`](/ja/headless)または [Agent SDK](/ja/agent-sdk/overview)で作成されたセッションはセッションピッカーに表示されませんが、セッション ID を `claude --resume <session-id>` に渡すことで再開できます。セッションが開始されたディレクトリから実行してください。セッション ID ルックアップは現在のプロジェクトディレクトリとその git worktrees にスコープされているため、他の場所で作成されたセッションは `No conversation found with session ID: <session-id>` と報告されます。

34 34 

35<h3 id="where-the-session-picker-looks">35<h3 id="where-the-session-picker-looks">

36 セッションピッカーが検索する場所36 セッションピッカーが検索する場所

37</h3>37</h3>

38 38 

39セッションはプロジェクトディレクトリごとに保存されます。デフォルトでは、セッションピッカーは現在の worktree からのインタラクティブセッション、および `/add-dir` で現在のディレクトリを追加した他の場所で開始されたセッションを表示します。`Ctrl+W` を使用してリポジトリのすべての worktree に拡張するか、`Ctrl+A` を使用してこのマシン上のすべてのプロジェクトに拡張します。39セッションはプロジェクトディレクトリごとに保存されます。デフォルトでは、セッションピッカーは現在の worktree からのインタラクティブセッション、および `/add-dir` で現在のディレクトリを追加した他の場所で開始されたセッションを表示します。v2.1.169 以降、[`/cd`](/ja/commands)でセッションを移動すると、新しいディレクトリのプロジェクトストレージに再配置されるため、その後そのディレクトリのピッカーに表示されます。`Ctrl+W` を使用してリポジトリのすべての worktree に拡張するか、`Ctrl+A` を使用してこのマシン上のすべてのプロジェクトに拡張します。

40 40 

41同じリポジトリの別の worktree からセッションを選択すると、そこで再開されます。関連のないプロジェクトからセッションを選択すると、`cd` と再開コマンドがクリップボードにコピーされます。41同じリポジトリの別の worktree からセッションを選択すると、そこで再開されます。関連のないプロジェクトからセッションを選択すると、`cd` と再開コマンドがクリップボードにコピーされます。

42 42 


54セッションに説明的な名前を付けて、セッションピッカーで見つけやすく、名前で再開できるようにします。これは複数のタスクを並行して処理している場合に最も重要です。54セッションに説明的な名前を付けて、セッションピッカーで見つけやすく、名前で再開できるようにします。これは複数のタスクを並行して処理している場合に最も重要です。

55 55 

56| 時期 | 名前を設定する方法 |56| 時期 | 名前を設定する方法 |

57| :---------- | :--------------------------------------------------------------------------------------------------------------------- |57| :---------- | :------------------------------------------------------------------------------------------------------------------------ |

58| 起動時 | `claude -n auth-refactor` |58| 起動時 | `claude -n auth-refactor` |

59| セッション中 | `/rename auth-refactor`。名前はプロンプトバーにも表示されます |59| セッション中 | `/rename auth-refactor`。名前はプロンプトバーにも表示されます |

60| セッションピッカーから | セッションをハイライトして `Ctrl+R` を押します |60| セッションピッカーから | セッションをハイライトして `Ctrl+R` を押します |

61| プラン受け入れ時 | [プランモード](/ja/permission-modes#analyze-before-you-edit-with-plan-mode)でプランを受け入れると、既に設定していない限り、プランコンテンツからセッションに名前が付けられます |61| プラン受け入れ時 | [Plan Mode](/ja/permission-modes#analyze-before-you-edit-with-plan-mode)でプランを受け入れると、既に設定していない限り、プランコンテンツからセッションに名前が付けられます |

62 62 

63セッションに名前が付けられたら、`claude --resume <name>` または `/resume <name>` で再開できます。worktree 全体での名前解決の動作については、[セッションを再開する](#resume-a-session)を参照してください。63セッションに名前が付けられたら、`claude --resume <name>` または `/resume <name>` で再開できます。worktree 全体での名前解決の動作については、[セッションを再開する](#resume-a-session)を参照してください。

64 64 


125 125 

126`/export` を実行して、現在の会話をクリップボードにコピーするか、プレーンテキストファイルとして保存します。メッセージとツール出力は読みやすいテキストとしてレンダリングされます。ファイル名を渡して、そのファイルに直接書き込みます。126`/export` を実行して、現在の会話をクリップボードにコピーするか、プレーンテキストファイルとして保存します。メッセージとツール出力は読みやすいテキストとしてレンダリングされます。ファイル名を渡して、そのファイルに直接書き込みます。

127 127 

128トランスクリプトは `~/.claude/projects/<project>/<session-id>.jsonl` に JSONL として保存されます。ここで `<project>` は作業ディレクトリパスから派生しています。各行はメッセージ、ツール使用、またはメタデータエントリの JSON オブジェクトです。セッションを `~/.claude` 以外の場所に保存するには、[`CLAUDE_CONFIG_DIR`](/ja/env-vars)を設定します。これらのローカルファイルはデフォルトで 30 日後に削除されます。[`cleanupPeriodDays`](/ja/settings#available-settings)で変更します。128トランスクリプトは `~/.claude/projects/<project>/<session-id>.jsonl` に JSONL として保存されます。ここで `<project>` は作業ディレクトリパスから派生しています。各行はメッセージ、ツール使用、またはメタデータエントリの JSON オブジェクトです。セッションを `~/.claude` 以外の場所に保存するには、[`CLAUDE_CONFIG_DIR`](/ja/env-vars) を設定します。これらのローカルファイルはデフォルトで 30 日後に削除されます。[`cleanupPeriodDays`](/ja/settings#available-settings) で変更します。

129 129 

130トランスクリプト書き込みを完全に抑制するには、[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ja/env-vars)を設定するか、非インタラクティブモードで `--no-session-persistence` を使用します。130トランスクリプト書き込みを完全に抑制するには、[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ja/env-vars) を設定するか、非インタラクティブモードで `--no-session-persistence` を使用します。

131 131 

132<h2 id="see-also">132<h2 id="see-also">

133 関連項目133 関連項目


136これらのページは関連するセッションと並列処理のメカニクスについて説明しています。136これらのページは関連するセッションと並列処理のメカニクスについて説明しています。

137 137 

138* [Worktrees](/ja/worktrees):別のブランチで分離された並列セッションを実行します138* [Worktrees](/ja/worktrees):別のブランチで分離された並列セッションを実行します

139* [チェックポイント](/ja/checkpointing):コードと会話を以前のポイントに巻き戻します139* [Checkpointing](/ja/checkpointing):コードと会話を以前のポイントに巻き戻します

140* [コンテキストウィンドウ](/ja/context-window):コンテキストを満たすもの、圧縮後に残るもの140* [Context window](/ja/context-window):コンテキストを満たすもの、圧縮後に残るもの

141* [非インタラクティブモード](/ja/headless):`claude -p` の下でのセッション動作141* [Non-interactive mode](/ja/headless):`claude -p` の下でのセッション動作

settings.md +109 −23

Details

19</h3>19</h3>

20 20 

21| スコープ | 場所 | 影響を受けるユーザー | チームと共有? |21| スコープ | 場所 | 影響を受けるユーザー | チームと共有? |

22| :---------- | :--------------------------------------------------------- | :------------------ | :-------------- |22| :---------- | :--------------------------------------------------------- | :------------------ | :----------------------------------- |

23| **Managed** | サーバー管理設定、plist / レジストリ、またはシステムレベルの `managed-settings.json` | マシン上のすべてのユーザー | はい(IT により展開) |23| **Managed** | サーバー管理設定、plist / レジストリ、またはシステムレベルの `managed-settings.json` | マシン上のすべてのユーザー | はい(IT により展開) |

24| **User** | `~/.claude/` ディレクトリ | すべてのプロジェクト全体でのあなた | いいえ |24| **User** | `~/.claude/` ディレクトリ | すべてのプロジェクト全体でのあなた | いいえ |

25| **Project** | リポジトリ内の `.claude/` | このリポジトリのすべてのコラボレーター | はい(git にコミット) |25| **Project** | リポジトリ内の `.claude/` | このリポジトリのすべてのコラボレーター | はい(git にコミット) |

26| **Local** | `.claude/settings.local.json` | このリポジトリ内のあなたのみ | いいえ(gitignored) |26| **Local** | `.claude/settings.local.json` | このリポジトリ内のあなたのみ | いいえ(Claude Code が作成する場合は gitignored) |

27 27 

28<h3 id="when-to-use-each-scope">28<h3 id="when-to-use-each-scope">

29 各スコープを使用する場合29 各スコープを使用する場合


94* **ユーザー設定**は `~/.claude/settings.json` で定義され、すべてのプロジェクトに適用されます。94* **ユーザー設定**は `~/.claude/settings.json` で定義され、すべてのプロジェクトに適用されます。

95* **プロジェクト設定**はプロジェクトディレクトリに保存されます:95* **プロジェクト設定**はプロジェクトディレクトリに保存されます:

96 * `.claude/settings.json` ソース管理にチェックインされ、チームと共有される設定用96 * `.claude/settings.json` ソース管理にチェックインされ、チームと共有される設定用

97 * `.claude/settings.local.json` チェックインされない設定用。個人設定と実験に役立ちます。Claude Code は作成時に `.claude/settings.local.json` を無視するように git を構成します。97 * `.claude/settings.local.json` チェックインされない設定用。個人設定と実験に役立ちます。Claude Code は作成時に `.claude/settings.local.json` を無視するように git を構成します。自分でファイルを作成する場合は、gitignore に手動で追加してください。

98* **Managed 設定**:集中管理が必要な組織向けに、Claude Code は managed 設定の複数の配信メカニズムをサポートしています。すべて同じ JSON 形式を使用し、ユーザー設定またはプロジェクト設定でオーバーライドできません:98* **Managed 設定**:集中管理が必要な組織向けに、Claude Code は managed 設定の複数の配信メカニズムをサポートしています。すべて同じ JSON 形式を使用し、ユーザー設定またはプロジェクト設定でオーバーライドできません:

99 99 

100 * **サーバー管理設定**:Anthropic のサーバーから Claude.ai 管理コンソール経由で配信されます。[サーバー管理設定](/ja/server-managed-settings)を参照してください。100 * **サーバー管理設定**:Anthropic のサーバーから Claude.ai 管理コンソール経由で配信されます。[サーバー管理設定](/ja/server-managed-settings)を参照してください。


174* `model`:セッション中に切り替えるには [`/model`](/ja/model-config#setting-your-model)を使用します174* `model`:セッション中に切り替えるには [`/model`](/ja/model-config#setting-your-model)を使用します

175* [`outputStyle`](/ja/output-styles):システムプロンプトの一部。`/clear` または再起動時に再構築されます175* [`outputStyle`](/ja/output-styles):システムプロンプトの一部。`/clear` または再起動時に再構築されます

176 176 

177<h3 id="invalid-entries-in-managed-settings">

178 Managed 設定の無効なエントリ

179</h3>

180 

181Managed 設定は寛容に解析されます。managed 構成にスキーマ検証に失敗するエントリが含まれている場合、Claude Code はそのエントリを削除し、警告を記録し、残りのすべての有効なポリシーを強制します。単一のタイプミスが組織のポリシーの残りを無効にすることはできません。この動作は、3 つすべての配信メカニズム全体で一貫しています:[サーバー管理設定](/ja/server-managed-settings)、MDM を通じてデプロイされた plist およびレジストリポリシー、および `managed-settings.json` ファイル。Claude Code v2.1.169 以降が必要です。

182 

183セキュリティ強制フィールドは、存在するが無効な場合、全体的に削除されるのではなく、フィールドごとに処理されます:

184 

185| フィールド | 存在するが無効な場合の動作 |

186| :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

187| `allowedMcpServers` | 空のホワイトリストとして強制されるため、値が修正されるまで MCP サーバーは許可されません。個別の無効なエントリは削除され、有効なサブセットが強制されます。 |

188| `allowManagedMcpServersOnly` | `true` として扱われます。 |

189| `availableModels` | {/* min-version: 2.1.175 */}空のホワイトリストとして強制されるため、値が修正されるまでデフォルトモデルのみが利用可能です。文字列以外の個別エントリは削除され、有効なサブセットが強制されます。v2.1.175 以降に適用されます。 |

190| `enforceAvailableModels` | {/* min-version: 2.1.175 */}`true` として扱われます。v2.1.175 以降に適用されます。 |

191| `forceLoginOrgUUID` | 値が修正されるまで、どの組織もログインを許可されません。 |

192| `deniedMcpServers` | 個別の無効なエントリは削除され、有効なサブセットが強制されます。完全に無効な値は警告とともに削除されます。すべてのサーバーを拒否するとポリシーが名前を付けなかったサーバーをブロックするため。 |

193 

194`requiredMinimumVersion` と `requiredMaximumVersion` は設計上失敗して開きます:無効な値は強制されるのではなく削除されるため、不正なポリシープッシュが Claude Code の起動を防ぐことはできません。

195 

196検証エラーは 3 つの場所に表示されます:

197 

198* インタラクティブセッションは起動時に無効なエントリをリストするダイアログを表示します。

199* `-p` を使用したヘッドレス実行は stderr にサマリーを出力します。

200* [`claude doctor`](/ja/debug-your-config)は各無効なエントリをそのソースとフィールドとともにリストします。

201 

202ポリシー変更をテストマシンで `claude doctor` を実行して検証してから、フロート全体に展開します。

203 

204この寛容さは managed 設定にのみ適用されます。ユーザー、プロジェクト、およびローカル設定ファイルは厳密なままです:検証に失敗するファイルは全体として拒否され、報告されます。

205 

177<h3 id="available-settings">206<h3 id="available-settings">

178 利用可能な設定207 利用可能な設定

179</h3>208</h3>


182 211 

183| キー | 説明 | 例 |212| キー | 説明 | 例 |

184| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |213| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |

214| `advisorModel` | {/* min-version: 2.1.98 */}サーバー側[advisor ツール](/ja/advisor)用のモデル。`"opus"`、`"sonnet"`、または `"fable"`({/* min-version: 2.1.170 */}v2.1.170 以降)などのモデルエイリアス、または完全なモデル ID を受け入れます。`/advisor` を実行すると自動的に書き込まれます。advisor を無効にするには未設定のままにします。Claude Code v2.1.98 以降が必要です | `"opus"` |

185| `agent` | メインスレッドを名前付き subagent として実行し、`claude agents` から派遣されたセッションのデフォルト agent を設定します。その subagent のシステムプロンプト、ツール制限、およびモデルを適用します。[subagents を明示的に呼び出す](/ja/sub-agents#invoke-subagents-explicitly)を参照してください | `"code-reviewer"` |215| `agent` | メインスレッドを名前付き subagent として実行し、`claude agents` から派遣されたセッションのデフォルト agent を設定します。その subagent のシステムプロンプト、ツール制限、およびモデルを適用します。[subagents を明示的に呼び出す](/ja/sub-agents#invoke-subagents-explicitly)を参照してください | `"code-reviewer"` |

216| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}[リモートコントロール](/ja/remote-control)が接続されている場合、Claude がプロアクティブなプッシュ通知をスマートフォンに送信することを許可します。たとえば、長いタスクが完了したときなど。デフォルト:`false`。`/config` に**Claude が決定したときにプッシュ**として表示されます。[モバイルプッシュ通知](/ja/remote-control#mobile-push-notifications)を参照してください。Claude Code v2.1.119 以降が必要です | `true` |

186| `allowAllClaudeAiMcps` | (Managed 設定のみ)デプロイされた `managed-mcp.json` と共に claude.ai コネクタを読み込みます。これ以外の場合は排他的な制御を取得し、それらを抑制します。[Managed MCP 構成](/ja/managed-mcp)を参照してください | `true` |217| `allowAllClaudeAiMcps` | (Managed 設定のみ)デプロイされた `managed-mcp.json` と共に claude.ai コネクタを読み込みます。これ以外の場合は排他的な制御を取得し、それらを抑制します。[Managed MCP 構成](/ja/managed-mcp)を参照してください | `true` |

187| `allowedChannelPlugins` | (Managed 設定のみ)メッセージをプッシュできるチャネルプラグインのホワイトリスト。設定されている場合、デフォルトの Anthropic ホワイトリストを置き換えます。未定義 = デフォルトにフォールバック、空配列 = すべてのチャネルプラグインをブロック。`channelsEnabled: true` が必要です。[チャネルプラグインが実行できるものを制限](/ja/channels#restrict-which-channel-plugins-can-run)を参照してください | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |218| `allowedChannelPlugins` | (Managed 設定のみ)メッセージをプッシュできるチャネルプラグインのホワイトリスト。設定されている場合、デフォルトの Anthropic ホワイトリストを置き換えます。未定義 = デフォルトにフォールバック、空配列 = すべてのチャネルプラグインをブロック。`channelsEnabled: true` が必要です。[チャネルプラグインが実行できるものを制限](/ja/channels#restrict-which-channel-plugins-can-run)を参照してください | `[{ "marketplace": "claude-plugins-official", "plugin": "telegram" }]` |

188| `allowedHttpHookUrls` | HTTP hooks がターゲットにできる URL パターンのホワイトリスト。`*` をワイルドカードとしてサポートします。設定されている場合、一致しない URL を持つ hooks はブロックされます。未定義 = 制限なし、空配列 = すべての HTTP hooks をブロック。配列はすべての設定ソース全体でマージされます。[Hook 構成](#hook-configuration)を参照してください | `["https://hooks.example.com/*"]` |219| `allowedHttpHookUrls` | HTTP hooks がターゲットにできる URL パターンのホワイトリスト。`*` をワイルドカードとしてサポートします。設定されている場合、一致しない URL を持つ hooks はブロックされます。未定義 = 制限なし、空配列 = すべての HTTP hooks をブロック。配列はすべての設定ソース全体でマージされます。[Hook 構成](#hook-configuration)を参照してください | `["https://hooks.example.com/*"]` |


190| `allowManagedHooksOnly` | (Managed 設定のみ)managed hooks、SDK hooks、および managed 設定 `enabledPlugins` で強制的に有効にされたプラグインからの hooks のみが読み込まれます。ユーザー、プロジェクト、およびその他すべてのプラグイン hooks はブロックされます。[Hook 構成](#hook-configuration)を参照してください | `true` |221| `allowManagedHooksOnly` | (Managed 設定のみ)managed hooks、SDK hooks、および managed 設定 `enabledPlugins` で強制的に有効にされたプラグインからの hooks のみが読み込まれます。ユーザー、プロジェクト、およびその他すべてのプラグイン hooks はブロックされます。[Hook 構成](#hook-configuration)を参照してください | `true` |

191| `allowManagedMcpServersOnly` | (Managed 設定のみ)managed 設定からの `allowedMcpServers` のみが尊重されます。`deniedMcpServers` はすべてのソースからマージされます。ユーザーは引き続き MCP サーバーを追加できますが、管理者定義のホワイトリストのみが適用されます。[Managed MCP 構成](/ja/managed-mcp)を参照してください | `true` |222| `allowManagedMcpServersOnly` | (Managed 設定のみ)managed 設定からの `allowedMcpServers` のみが尊重されます。`deniedMcpServers` はすべてのソースからマージされます。ユーザーは引き続き MCP サーバーを追加できますが、管理者定義のホワイトリストのみが適用されます。[Managed MCP 構成](/ja/managed-mcp)を参照してください | `true` |

192| `allowManagedPermissionRulesOnly` | (Managed 設定のみ)ユーザーおよびプロジェクト設定が `allow`、`ask`、または `deny` 権限ルールを定義するのを防止します。managed 設定のルールのみが適用されます。[Managed のみの設定](/ja/permissions#managed-only-settings)を参照してください | `true` |223| `allowManagedPermissionRulesOnly` | (Managed 設定のみ)ユーザーおよびプロジェクト設定が `allow`、`ask`、または `deny` 権限ルールを定義するのを防止します。managed 設定のルールのみが適用されます。[Managed のみの設定](/ja/permissions#managed-only-settings)を参照してください | `true` |

193| `alwaysThinkingEnabled` | すべてのセッションに対してデフォルトで[拡張思考](/ja/model-config#extended-thinking)を有効にします。通常は直接編集するのではなく `/config` コマンドを通じて構成されます。思考を強制的にオフにするには、`env` で [`CLAUDE_CODE_DISABLE_THINKING`](/ja/env-vars)を設定します | `true` |224| `alwaysThinkingEnabled` | すべてのセッションに対してデフォルトで[拡張思考](/ja/model-config#extended-thinking)を有効にします。通常は直接編集するのではなく `/config` コマンドを通じて構成されます。思考をオフにするには、`env` で [`MAX_THINKING_TOKENS=0`](/ja/env-vars)を設定します。これにより Anthropic API での思考が無効になります。ただし Fable 5 では思考をオフにすることはできません。[サードパーティプロバイダー](/ja/third-party-integrations)では、代わりに `thinking` パラメータを省略し、適応推論モデルは引き続き思考する可能性があります | `true` |

194| `apiKeyHelper` | `/bin/sh` で実行される認証値を生成するカスタムスクリプト。この値は、モデルリクエストの `X-Api-Key` および `Authorization: Bearer` ヘッダーとして送信されます。[`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/ja/env-vars)でリフレッシュ間隔を設定します | `/bin/generate_temp_api_key.sh` |225| `apiKeyHelper` | `/bin/sh` で実行される認証値を生成するカスタムスクリプト。この値は、モデルリクエストの `X-Api-Key` および `Authorization: Bearer` ヘッダーとして送信されます。[`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/ja/env-vars)でリフレッシュ間隔を設定します | `/bin/generate_temp_api_key.sh` |

195| `attribution` | git コミットとプルリクエストの属性をカスタマイズします。[属性設定](#attribution-settings)を参照してください | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |226| `attribution` | git コミットとプルリクエストの属性をカスタマイズします。[属性設定](#attribution-settings)を参照してください | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |

227| `autoCompactEnabled` | {/* min-version: 2.1.119 */}コンテキストが制限に近づくと、会話を自動的にコンパクトにします。デフォルト:`true`。`/config` に**自動コンパクト**として表示されます。環境変数で無効にするには、`env` で [`DISABLE_AUTO_COMPACT`](/ja/env-vars)を設定します | `false` |

196| `autoMemoryDirectory` | [自動メモリ](/ja/memory#storage-location)ストレージ用のカスタムディレクトリ。絶対パスまたは `~/` プレフィックス付きパスを受け入れます。プロジェクトまたはローカル設定からは、ワークスペース信頼ダイアログを受け入れた後にのみ尊重されます。クローンされたリポジトリがこのファイルを提供できるため | `"~/my-memory-dir"` |228| `autoMemoryDirectory` | [自動メモリ](/ja/memory#storage-location)ストレージ用のカスタムディレクトリ。絶対パスまたは `~/` プレフィックス付きパスを受け入れます。プロジェクトまたはローカル設定からは、ワークスペース信頼ダイアログを受け入れた後にのみ尊重されます。クローンされたリポジトリがこのファイルを提供できるため | `"~/my-memory-dir"` |

197| `autoMemoryEnabled` | [自動メモリ](/ja/memory#enable-or-disable-auto-memory)を有効にします。`false` の場合、Claude は自動メモリディレクトリから読み込んだり、書き込んだりしません。デフォルト:`true`。セッション中に `/memory` でこれを切り替えることもできます。環境変数で無効にするには、`env` で [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/ja/env-vars)を設定します | `false` |229| `autoMemoryEnabled` | [自動メモリ](/ja/memory#enable-or-disable-auto-memory)を有効にします。`false` の場合、Claude は自動メモリディレクトリから読み込んだり、書き込んだりしません。デフォルト:`true`。セッション中に `/memory` でこれを切り替えることもできます。環境変数で無効にするには、`env` で [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](/ja/env-vars)を設定します | `false` |

198| `autoMode` | [自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)分類器がブロックおよび許可するものをカスタマイズします。`environment`、`allow`、`soft_deny`、および `hard_deny` 配列の散文ルールを含みます。リテラル文字列 `"$defaults"` を配列に含めて、その位置で組み込みルールを継承します。[自動モードを構成](/ja/auto-mode-config)を参照してください。共有プロジェクト設定から読み込まれません | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |230| `autoMode` | [自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)分類器がブロックおよび許可するものをカスタマイズします。`environment`、`allow`、`soft_deny`、および `hard_deny` 配列の散文ルールを含みます。リテラル文字列 `"$defaults"` を配列に含めて、その位置で組み込みルールを継承します。[自動モードを構成](/ja/auto-mode-config)を参照してください。共有プロジェクト設定から読み込まれません | `{"soft_deny": ["$defaults", "Never run terraform apply"]}` |

199| `autoScrollEnabled` | [フルスクリーンレンダリング](/ja/fullscreen)で、新しい出力を会話の下部に追従します。デフォルト:`true`。`/config` に**自動スクロール**として表示されます。権限プロンプトはこれがオフの場合でもビューにスクロールします | `false` |231| `autoScrollEnabled` | [フルスクリーンレンダリング](/ja/fullscreen)で、新しい出力を会話の下部に追従します。デフォルト:`true`。`/config` に**自動スクロール**として表示されます。権限プロンプトはこれがオフの場合でもビューにスクロールします | `false` |

200| `autoUpdatesChannel` | 更新に従うリリースチャネル。約 1 週間古いバージョンで、大きな回帰のあるバージョンをスキップする `"stable"` を使用するか、最新リリースの `"latest"`(デフォルト)を使用します。自動更新を完全に無効にするには、`env` で [`DISABLE_AUTOUPDATER`](/ja/setup#disable-auto-updates)を設定します | `"stable"` |232| `autoUpdatesChannel` | 更新に従うリリースチャネル。約 1 週間古いバージョンで、大きな回帰のあるバージョンをスキップする `"stable"` を使用するか、最新リリースの `"latest"`(デフォルト)を使用します。自動更新を完全に無効にするには、`env` で [`DISABLE_AUTOUPDATER`](/ja/setup#disable-auto-updates)を設定します | `"stable"` |

201| `availableModels` | `/model``--model`または `ANTHROPIC_MODEL` を通じてユーザーが選択できるモデルを制限します。デフォルトオプションには影響しません。[モデル選択を制限](/ja/model-config#restrict-model-selection)を参照してください | `["sonnet", "haiku"]` |233| `availableModels` | ユーザーがメインセッション[subagents](/ja/sub-agents)および [advisor](/ja/advisor)用に選択できるモデルを制限します。[モデル選択を制限](/ja/model-config#restrict-model-selection)を参照してください。`enforceAvailableModels` も参照してください。デフォルトを制限します | `["sonnet", "haiku"]` |

202| `awaySummaryEnabled` | 数分間ターミナルから離れた後に戻ったときに、1 行のセッション要約を表示します。`false` に設定するか、`/config` でセッション要約をオフにして無効にします。[`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/ja/env-vars)と同じです | `true` |234| `awaySummaryEnabled` | 数分間ターミナルから離れた後に戻ったときに、1 行のセッション要約を表示します。`false` に設定するか、`/config` でセッション要約をオフにして無効にします。[`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](/ja/env-vars)と同じです | `true` |

203| `awsAuthRefresh` | `.aws` ディレクトリを変更するカスタムスクリプト([高度な認証情報構成](/ja/amazon-bedrock#advanced-credential-configuration)を参照) | `aws sso login --profile myprofile` |235| `awsAuthRefresh` | `.aws` ディレクトリを変更するカスタムスクリプト([高度な認証情報構成](/ja/amazon-bedrock#advanced-credential-configuration)を参照) | `aws sso login --profile myprofile` |

204| `awsCredentialExport` | AWS 認証情報を含む JSON を出力するカスタムスクリプト([高度な認証情報構成](/ja/amazon-bedrock#advanced-credential-configuration)を参照) | `/bin/generate_aws_grant.sh` |236| `awsCredentialExport` | AWS 認証情報を含む JSON を出力するカスタムスクリプト([高度な認証情報構成](/ja/amazon-bedrock#advanced-credential-configuration)を参照) | `/bin/generate_aws_grant.sh` |


213| `disableAgentView` | [バックグラウンドエージェントとエージェントビュー](/ja/agent-view)をオフにするために `true` に設定します:`claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザー。通常は [managed 設定](/ja/permissions#managed-settings)で設定されます。`CLAUDE_CODE_DISABLE_AGENT_VIEW` を `1` に設定するのと同等です | `true` |245| `disableAgentView` | [バックグラウンドエージェントとエージェントビュー](/ja/agent-view)をオフにするために `true` に設定します:`claude agents`、`--bg`、`/background`、およびオンデマンドスーパーバイザー。通常は [managed 設定](/ja/permissions#managed-settings)で設定されます。`CLAUDE_CODE_DISABLE_AGENT_VIEW` を `1` に設定するのと同等です | `true` |

214| `disableAllHooks` | すべての [hooks](/ja/hooks) とカスタム [ステータスライン](/ja/statusline)を無効にします | `true` |246| `disableAllHooks` | すべての [hooks](/ja/hooks) とカスタム [ステータスライン](/ja/statusline)を無効にします | `true` |

215| `disableAutoMode` | [自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)の有効化を防ぐために `"disable"` に設定します。`Shift+Tab` サイクルから `auto` を削除し、起動時に `--permission-mode auto` を拒否します。[managed 設定](/ja/permissions#managed-settings)で最も役立ちます。ユーザーはこれをオーバーライドできません | `"disable"` |247| `disableAutoMode` | [自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)の有効化を防ぐために `"disable"` に設定します。`Shift+Tab` サイクルから `auto` を削除し、起動時に `--permission-mode auto` を拒否します。[managed 設定](/ja/permissions#managed-settings)で最も役立ちます。ユーザーはこれをオーバーライドできません | `"disable"` |

248| `disableBundledSkills` | [skills](/ja/skills)とワークフローをオフにするために `true` に設定します。Claude Code に付属しています:バンドルされた skills とワークフローは完全に削除されますが、`/init` などの組み込みスラッシュコマンドは入力可能なままですが、モデルから非表示になります。プラグイン、`.claude/skills/`、および `.claude/commands/` からの Skills は影響を受けません。`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` を `1` に設定するのと同等です | `true` |

216| `disableDeepLinkRegistration` | Claude Code が起動時にオペレーティングシステムで `claude-cli://` プロトコルハンドラーを登録するのを防ぐために `"disable"` に設定します。[ディープリンク](/ja/deep-links)を使用すると、外部ツールは事前入力されたプロンプトで Claude Code セッションを開くことができます。プロトコルハンドラー登録が制限されているか、別途管理されている環境で役立ちます | `"disable"` |249| `disableDeepLinkRegistration` | Claude Code が起動時にオペレーティングシステムで `claude-cli://` プロトコルハンドラーを登録するのを防ぐために `"disable"` に設定します。[ディープリンク](/ja/deep-links)を使用すると、外部ツールは事前入力されたプロンプトで Claude Code セッションを開くことができます。プロトコルハンドラー登録が制限されているか、別途管理されている環境で役立ちます | `"disable"` |

217| `disabledMcpjsonServers` | `.mcp.json` ファイルから拒否する特定の MCP サーバーのリスト | `["filesystem"]` |250| `disabledMcpjsonServers` | `.mcp.json` ファイルから拒否する特定の MCP サーバーのリスト | `["filesystem"]` |

218| `disableRemoteControl` | {/* min-version: 2.1.128 */}[リモートコントロール](/ja/remote-control)を無効にします:`claude remote-control`、`--remote-control` フラグ、自動開始、およびセッション内トグルをブロックします。通常は [managed 設定](/ja/permissions#managed-settings)に配置されます。デバイスごとの MDM 強制用ですが、任意のスコープから機能します。Claude Code v2.1.128 以降が必要です | `true` |251| `disableRemoteControl` | {/* min-version: 2.1.128 */}[リモートコントロール](/ja/remote-control)を無効にします:`claude remote-control`、`--remote-control` フラグ、自動開始、およびセッション内トグルをブロックします。通常は [managed 設定](/ja/permissions#managed-settings)に配置されます。デバイスごとの MDM 強制用ですが、任意のスコープから機能します。Claude Code v2.1.128 以降が必要です | `true` |


222| `effortLevel` | [努力レベル](/ja/model-config#adjust-effort-level)をセッション全体で永続化します。`"low"`、`"medium"`、`"high"`、または `"xhigh"` を受け入れます。これらの値のいずれかで `/effort` を実行すると自動的に書き込まれます。`--effort` と [`CLAUDE_CODE_EFFORT_LEVEL`](/ja/env-vars)はこれを 1 セッション間オーバーライドします。[努力レベルを調整](/ja/model-config#adjust-effort-level)でサポートされているモデルを参照してください | `"xhigh"` |255| `effortLevel` | [努力レベル](/ja/model-config#adjust-effort-level)をセッション全体で永続化します。`"low"`、`"medium"`、`"high"`、または `"xhigh"` を受け入れます。これらの値のいずれかで `/effort` を実行すると自動的に書き込まれます。`--effort` と [`CLAUDE_CODE_EFFORT_LEVEL`](/ja/env-vars)はこれを 1 セッション間オーバーライドします。[努力レベルを調整](/ja/model-config#adjust-effort-level)でサポートされているモデルを参照してください | `"xhigh"` |

223| `enableAllProjectMcpServers` | プロジェクト `.mcp.json` ファイルで定義されたすべての MCP サーバーを自動的に承認します | `true` |256| `enableAllProjectMcpServers` | プロジェクト `.mcp.json` ファイルで定義されたすべての MCP サーバーを自動的に承認します | `true` |

224| `enabledMcpjsonServers` | `.mcp.json` ファイルから承認する特定の MCP サーバーのリスト | `["memory", "github"]` |257| `enabledMcpjsonServers` | `.mcp.json` ファイルから承認する特定の MCP サーバーのリスト | `["memory", "github"]` |

258| `enforceAvailableModels` | {/* min-version: 2.1.175 */}managed またはポリシー設定で `true` で `availableModels` が空でないリストの場合、デフォルトモデルもホワイトリストに制限されます。詳細については [モデル選択を制限](/ja/model-config#restrict-model-selection)を参照し、`availableModels` が複数のレベルで設定されている場合の[マージ動作](/ja/model-config#merge-behavior)を参照してください。Claude Code v2.1.175 以降が必要です | `true` |

225| `env` | すべてのセッションに適用される環境変数。{/* min-version: 2.1.143 */}v2.1.143 以降、`NO_COLOR` と `FORCE_COLOR` がここで設定されている場合、サブプロセスに渡されますが、Claude Code 自体のインターフェイスの色は変更されません。インターフェイスの色を変更するには、`claude` を起動する前にシェルでこれらを設定します | `{"FOO": "bar"}` |259| `env` | すべてのセッションに適用される環境変数。{/* min-version: 2.1.143 */}v2.1.143 以降、`NO_COLOR` と `FORCE_COLOR` がここで設定されている場合、サブプロセスに渡されますが、Claude Code 自体のインターフェイスの色は変更されません。インターフェイスの色を変更するには、`claude` を起動する前にシェルでこれらを設定します | `{"FOO": "bar"}` |

260| `fallbackModel` | プライマリモデルがオーバーロードされているか利用できない場合に順番に試すフォールバックモデル。Claude Code はチェーン内の次の利用可能なモデルに切り替え、ターンの残りを表示し、通知を表示します。`"default"` はデフォルトモデルに展開されます。チェーンは 3 つのモデルに制限されます。余分なエントリは無視されます。ほとんどの配列設定とは異なり、このキーはスコープ全体でマージされません:これを定義する最高優先度ファイルが全体の値を提供します。[`--fallback-model`](/ja/cli-reference#cli-flags)フラグはこれを 1 セッション間オーバーライドします。[フォールバックモデルチェーン](/ja/model-config#fallback-model-chains)を参照してください | `["claude-sonnet-4-6", "claude-haiku-4-5"]` |

226| `fastModePerSessionOptIn` | `true` の場合、高速モードはセッション全体で永続化されません。各セッションは高速モードがオフで開始され、ユーザーが `/fast` で有効にする必要があります。ユーザーの高速モード設定は引き続き保存されます。[セッションごとのオプトインを要求](/ja/fast-mode#require-per-session-opt-in)を参照してください | `true` |261| `fastModePerSessionOptIn` | `true` の場合、高速モードはセッション全体で永続化されません。各セッションは高速モードがオフで開始され、ユーザーが `/fast` で有効にする必要があります。ユーザーの高速モード設定は引き続き保存されます。[セッションごとのオプトインを要求](/ja/fast-mode#require-per-session-opt-in)を参照してください | `true` |

227| `feedbackSurveyRate` | [セッション品質調査](/ja/data-usage#session-quality-surveys)が適格な場合に表示される確率(0~1)。完全に抑制するには `0` に設定するか、`env` で [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/ja/env-vars)を設定します。Bedrock、Vertex、または Foundry を使用する場合に役立ちます。デフォルトのサンプルレートは適用されません | `0.05` |262| `feedbackSurveyRate` | [セッション品質調査](/ja/data-usage#session-quality-surveys)が適格な場合に表示される確率(0~1)。完全に抑制するには `0` に設定するか、`env` で [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/ja/env-vars)を設定します。Bedrock、Vertex、または Foundry を使用する場合に役立ちます。デフォルトのサンプルレートは適用されません | `0.05` |

263| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}各編集の前にファイルをスナップショットして、[`/rewind`](/ja/checkpointing)でそれらを復元できるようにします。デフォルト:`true`。`/config` に\*\*コードを巻き戻す(チェックポイント)\*\*として表示されます。環境変数で無効にするには、`env` で [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/ja/env-vars)を設定します | `false` |

228| `fileSuggestion` | `@` ファイルオートコンプリート用のカスタムスクリプトを構成します。[ファイル提案設定](#file-suggestion-settings)を参照してください | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |264| `fileSuggestion` | `@` ファイルオートコンプリート用のカスタムスクリプトを構成します。[ファイル提案設定](#file-suggestion-settings)を参照してください | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |

265| `footerLinksRegexes` | {/* min-version: 2.1.176 */}ターン出力に正規表現がマッチするときにフッターにクリック可能なバッジをレンダリングします。各エントリには `pattern`、名前付きキャプチャグループから `{name}` プレースホルダーが入力される URL テンプレート、およびオプションの `label` があります。ユーザー、`--settings` フラグ、および managed 設定からのみ読み込まれます。[フッターリンクバッジ](#footer-link-badges)を参照してください。URL 制約、スキームホワイトリスト、および制限。Claude Code v2.1.176 以降が必要です | `[{"type": "regex", "pattern": "\\b(?<key>PROJ-\\d+)\\b", "url": "https://issues.example.com/browse/{key}", "label": "{key}"}]` |

229| `forceLoginMethod` | `claudeai` を使用して Claude.ai アカウントへのログインを制限するか、`console` を使用して Claude Console アカウントへのログインを制限します。managed 設定で設定されている場合、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` で認証されたセッションは起動時にブロックされます。どちらの値も最初のパーティ OAuth なしでは満たされないため。Bedrock、Vertex、Foundry などのサードパーティプロバイダーセッションはブロックされません:これらはクラウドプロバイダーではなく Anthropic に対して認証されます | `claudeai` |266| `forceLoginMethod` | `claudeai` を使用して Claude.ai アカウントへのログインを制限するか、`console` を使用して Claude Console アカウントへのログインを制限します。managed 設定で設定されている場合、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` で認証されたセッションは起動時にブロックされます。どちらの値も最初のパーティ OAuth なしでは満たされないため。Bedrock、Vertex、Foundry などのサードパーティプロバイダーセッションはブロックされません:これらはクラウドプロバイダーではなく Anthropic に対して認証されます | `claudeai` |

230| `forceLoginOrgUUID` | ログインが特定の Anthropic 組織に属することを要求します。単一の UUID 文字列を受け入れます。これはログイン中にその組織を自動的に事前選択するか、リストされた組織のいずれかが受け入れられる UUID の配列を受け入れます。事前選択なし。managed 設定で設定されている場合、認証されたアカウントがリストされた組織に属していない場合、ログインは失敗します。`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` で認証されたセッションは起動時にブロックされます。これらのセッションでは組織メンバーシップを検証できないため。Bedrock、Vertex、Foundry などのサードパーティプロバイダーセッションはブロックされません:クラウド IAM を使用して、どのクラウドアカウントを使用できるかを制限します。空配列は失敗して閉じられ、ログインを設定ミスメッセージでブロックします | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` または `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |267| `forceLoginOrgUUID` | ログインが特定の Anthropic 組織に属することを要求します。単一の UUID 文字列を受け入れます。これはログイン中にその組織を自動的に事前選択するか、リストされた組織のいずれかが受け入れられる UUID の配列を受け入れます。事前選択なし。managed 設定で設定されている場合、認証されたアカウントがリストされた組織に属していない場合、ログインは失敗します。`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` で認証されたセッションは起動時にブロックされます。これらのセッションでは組織メンバーシップを検証できないため。Bedrock、Vertex、Foundry などのサードパーティプロバイダーセッションはブロックされません:クラウド IAM を使用して、どのクラウドアカウントを使用できるかを制限します。空配列は失敗して閉じられ、ログインを設定ミスメッセージでブロックします | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` または `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |

231| `forceRemoteSettingsRefresh` | (Managed 設定のみ)リモート managed 設定がサーバーから新しく取得されるまで CLI スタートアップをブロックします。フェッチが失敗した場合、キャッシュされた設定または設定なしで続行するのではなく、CLI は終了します。設定されていない場合、スタートアップはリモート設定を待たずに続行します。[fail-closed 強制](/ja/server-managed-settings#enforce-fail-closed-startup)を参照してください | `true` |268| `forceRemoteSettingsRefresh` | (Managed 設定のみ)リモート managed 設定がサーバーから新しく取得されるまで CLI スタートアップをブロックします。フェッチが失敗した場合、キャッシュされた設定または設定なしで続行するのではなく、CLI は終了します。設定されていない場合、スタートアップはリモート設定を待たずに続行します。[fail-closed 強制](/ja/server-managed-settings#enforce-fail-closed-startup)を参照してください | `true` |


234| `httpHookAllowedEnvVars` | HTTP hooks がヘッダーに補間できる環境変数名のホワイトリスト。設定されている場合、各 hook の有効な `allowedEnvVars` はこのリストとの交差です。未定義 = 制限なし。配列はすべての設定ソース全体でマージされます。[Hook 構成](#hook-configuration)を参照してください | `["MY_TOKEN", "HOOK_SECRET"]` |271| `httpHookAllowedEnvVars` | HTTP hooks がヘッダーに補間できる環境変数名のホワイトリスト。設定されている場合、各 hook の有効な `allowedEnvVars` はこのリストとの交差です。未定義 = 制限なし。配列はすべての設定ソース全体でマージされます。[Hook 構成](#hook-configuration)を参照してください | `["MY_TOKEN", "HOOK_SECRET"]` |

235| `includeCoAuthoredBy` | **非推奨**:代わりに `attribution` を使用してください。git コミットとプルリクエストに `co-authored-by Claude` バイラインを含めるかどうか(デフォルト:`true`) | `false` |272| `includeCoAuthoredBy` | **非推奨**:代わりに `attribution` を使用してください。git コミットとプルリクエストに `co-authored-by Claude` バイラインを含めるかどうか(デフォルト:`true`) | `false` |

236| `includeGitInstructions` | Claude のシステムプロンプトに組み込みコミットおよび PR ワークフロー命令と git ステータススナップショットを含めます(デフォルト:`true`)。たとえば、独自の git ワークフロースキルを使用する場合は、これらの命令を削除するために `false` に設定します。`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` 環境変数が設定されている場合、この設定よりも優先されます | `false` |273| `includeGitInstructions` | Claude のシステムプロンプトに組み込みコミットおよび PR ワークフロー命令と git ステータススナップショットを含めます(デフォルト:`true`)。たとえば、独自の git ワークフロースキルを使用する場合は、これらの命令を削除するために `false` に設定します。`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` 環境変数が設定されている場合、この設定よりも優先されます | `false` |

237| `language` | Claude の優先応答言語を構成します(例:`"japanese"`、`"spanish"``"french"`)。Claude はデフォルトでこの言語で応答しますまた、[音声ディクテーション](/ja/voice-dictation#change-the-dictation-language)言語も設定します | `"japanese"` |274| `inputNeededNotifEnabled` | {/* min-version: 2.1.119 */}[リモートコントロール](/ja/remote-control)が接続されている場合権限プロンプトまたは質問があなたの入力を待っているときにスマートフォンにプッシュ通知を送信します。デフォルト:`false``/config` に**アクションが必要なときにプッシュ**として表示されます。[モバイルプッシュ通知](/ja/remote-control#mobile-push-notifications)を参照してください。Claude Code v2.1.119 以降が必要です | `true` |

275| `language` | Claude の優先応答言語を構成します(例:`"japanese"`、`"spanish"`、`"french"`)。Claude はデフォルトでこの言語で応答します。また、[音声ディクテーション](/ja/voice-dictation#change-the-dictation-language)言語も設定します。{/* min-version: 2.1.176 */}v2.1.176 以降、設定されていない場合、セッションタイトルは会話の言語と一致します | `"japanese"` |

238| `maxSkillDescriptionChars` | {/* min-version: 2.1.105 */}[スキルリスティング](/ja/skills#skill-descriptions-are-cut-short)Claude が各ターンで見る `description` と `when_to_use` テキストの結合されたスキルごとの文字上限(デフォルト:`1536`)。この長さより長いテキストは切り詰められます。長い説明を保持するために上げるか、より多くのスキルを [`skillListingBudgetFraction`](#available-settings)の下に収めるために下げます。Claude Code v2.1.105 以降が必要です | `2048` |276| `maxSkillDescriptionChars` | {/* min-version: 2.1.105 */}[スキルリスティング](/ja/skills#skill-descriptions-are-cut-short)Claude が各ターンで見る `description` と `when_to_use` テキストの結合されたスキルごとの文字上限(デフォルト:`1536`)。この長さより長いテキストは切り詰められます。長い説明を保持するために上げるか、より多くのスキルを [`skillListingBudgetFraction`](#available-settings)の下に収めるために下げます。Claude Code v2.1.105 以降が必要です | `2048` |

239| `minimumVersion` | 背景自動更新と `claude update` が特定のバージョン以下にインストールするのを防止するフロア。`"latest"` チャネルから `"stable"` に `/config` を通じて切り替えると、現在のバージョンに留まるか、ダウングレードを許可するかを求めるプロンプトが表示されます。留まることを選択すると、この値が設定されます。また、[managed 設定](/ja/permissions#managed-settings)で組織全体の最小値をピンするのに役立ちます | `"2.1.100"` |277| `minimumVersion` | 背景自動更新と `claude update` が特定のバージョン以下にインストールするのを防止するフロア。`"latest"` チャネルから `"stable"` に `/config` を通じて切り替えると、現在のバージョンに留まるか、ダウングレードを許可するかを求めるプロンプトが表示されます。留まることを選択すると、この値が設定されます。また、[managed 設定](/ja/permissions#managed-settings)で組織全体の最小値をピンするのに役立ちます。ハードフロアについては、`requiredMinimumVersion` を参照してください | `"2.1.100"` |

240| `model` | Claude Code に使用するデフォルトモデルをオーバーライドします。`--model` と [`ANTHROPIC_MODEL`](/ja/model-config#environment-variables)はこれを 1 セッション間オーバーライドします | `"claude-sonnet-4-6"` |278| `model` | Claude Code に使用するデフォルトモデルをオーバーライドします。`--model` と [`ANTHROPIC_MODEL`](/ja/model-config#environment-variables)はこれを 1 セッション間オーバーライドします | `"claude-sonnet-4-6"` |

241| `modelOverrides` | Anthropic モデル ID を Bedrock 推論プロファイル ARN などのプロバイダー固有のモデル ID にマップします。各モデルピッカーエントリは、プロバイダー API を呼び出すときにマップされた値を使用します。[バージョンごとにモデル ID をオーバーライド](/ja/model-config#override-model-ids-per-version)を参照してください | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |279| `modelOverrides` | Anthropic モデル ID を Bedrock 推論プロファイル ARN などのプロバイダー固有のモデル ID にマップします。各モデルピッカーエントリは、プロバイダー API を呼び出すときにマップされた値を使用します。[バージョンごとにモデル ID をオーバーライド](/ja/model-config#override-model-ids-per-version)を参照してください | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |

242| `otelHeadersHelper` | 動的 OpenTelemetry ヘッダーを生成するスクリプト。起動時および定期的に実行されます。[`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/ja/env-vars)でリフレッシュ間隔を設定します。[動的ヘッダー](/ja/monitoring-usage#dynamic-headers)を参照してください | `/bin/generate_otel_headers.sh` |280| `otelHeadersHelper` | 動的 OpenTelemetry ヘッダーを生成するスクリプト。起動時および定期的に実行されます。[`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/ja/env-vars)でリフレッシュ間隔を設定します。[動的ヘッダー](/ja/monitoring-usage#dynamic-headers)を参照してください | `/bin/generate_otel_headers.sh` |


244| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Managed 設定のみ)Agent SDK または IDE 拡張機能などの埋め込みホストプロセスによってプログラム的に提供される managed 設定が、管理者デプロイ済みの managed ティアも存在する場合に適用されるかどうかを制御します。`"first-wins"`:親提供の設定は削除され、管理者ティアのみが適用されます。`"merge"`:親提供の設定は管理者ティアの下で適用され、ポリシーを厳しくできるが緩くすることはできないようにフィルタリングされます。管理者ティアがデプロイされていない場合は効果がありません。デフォルト:`"first-wins"`。Claude Code v2.1.133 以降が必要です | `"merge"` |282| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Managed 設定のみ)Agent SDK または IDE 拡張機能などの埋め込みホストプロセスによってプログラム的に提供される managed 設定が、管理者デプロイ済みの managed ティアも存在する場合に適用されるかどうかを制御します。`"first-wins"`:親提供の設定は削除され、管理者ティアのみが適用されます。`"merge"`:親提供の設定は管理者ティアの下で適用され、ポリシーを厳しくできるが緩くすることはできないようにフィルタリングされます。管理者ティアがデプロイされていない場合は効果がありません。デフォルト:`"first-wins"`。Claude Code v2.1.133 以降が必要です | `"merge"` |

245| `permissions` | 権限の構造については、以下の表を参照してください。 | |283| `permissions` | 権限の構造については、以下の表を参照してください。 | |

246| `plansDirectory` | プランファイルが保存される場所をカスタマイズします。パスはプロジェクトルートに相対的です。デフォルト:`~/.claude/plans` | `"./plans"` |284| `plansDirectory` | プランファイルが保存される場所をカスタマイズします。パスはプロジェクトルートに相対的です。デフォルト:`~/.claude/plans` | `"./plans"` |

247| `pluginSuggestionMarketplaces` | (Managed 設定のみ)プラグインが文脈的なインストール提案として表示される可能性があるマーケットプレイス名。公式マーケットプレイスに加えて。提案は各プラグインのマーケットプレイスエントリの `relevance` 宣言から来ます。名前は、マーケットプレイスがマシンに登録されており、その登録されたソースが managed 設定でも宣言されている場合にのみ有効になります。その名前の `extraKnownMarketplaces` エントリとして、または `strictKnownMarketplaces` のエントリとして。異なるソースから登録されたマーケットプレイスはホワイトリストされた名前の下で無視されます。 | `["acme-corp-plugins"]` |285| `pluginSuggestionMarketplaces` | (Managed 設定のみ)プラグインが文脈的なインストール提案として表示される可能性があるマーケットプレイス名。提案は各プラグインのマーケットプレイスエントリの `relevance` 宣言から来ます。名前は、マーケットプレイスがマシンに登録されており、その登録されたソースが managed 設定でも宣言されている場合にのみ有効になります。その名前の `extraKnownMarketplaces` エントリとして、または `strictKnownMarketplaces` のエントリとして。異なるソースから登録されたマーケットプレイスはホワイトリストされた名前の下で無視されます。公式マーケットプレイスはソース要件から除外されます:その名前をホワイトリストするだけで十分です。その名前は公式 Anthropic ソースからのみ登録できるため。 | `["acme-corp-plugins"]` |

248| `pluginTrustMessage` | (Managed 設定のみ)インストール前に表示されるプラグイン信頼警告に追加されるカスタムメッセージ。これを使用して、組織固有のコンテキストを追加します。たとえば、内部マーケットプレイスからのプラグインが検証されていることを確認します。 | `"All plugins from our marketplace are approved by IT"` |286| `pluginTrustMessage` | (Managed 設定のみ)インストール前に表示されるプラグイン信頼警告に追加されるカスタムメッセージ。これを使用して、組織固有のコンテキストを追加します。たとえば、内部マーケットプレイスからのプラグインが検証されていることを確認します。 | `"All plugins from our marketplace are approved by IT"` |

249| `policyHelper` | {/* min-version: 2.1.136 */}起動時に managed 設定を動的に計算する管理者デプロイ済みの実行可能ファイル。MDM またはシステム `managed-settings.json` ファイルからのみ尊重されます。[ポリシーヘルパーで managed 設定を計算](#compute-managed-settings-with-a-policy-helper)を参照してください。Claude Code v2.1.136 以降が必要です | `{"path": "/usr/local/bin/claude-policy"}` |287| `policyHelper` | {/* min-version: 2.1.136 */}起動時に managed 設定を動的に計算する管理者デプロイ済みの実行可能ファイル。MDM またはシステム `managed-settings.json` ファイルからのみ尊重されます。[ポリシーヘルパーで managed 設定を計算](#compute-managed-settings-with-a-policy-helper)を参照してください。Claude Code v2.1.136 以降が必要です | `{"path": "/usr/local/bin/claude-policy"}` |

250| `preferredNotifChannel` | タスク完了および権限プロンプト通知の方法:`"auto"`、`"terminal_bell"`、`"iterm2"`、`"iterm2_with_bell"`、`"kitty"`、`"ghostty"`、または `"notifications_disabled"`。デフォルト:`"auto"`。iTerm2、Ghostty、Kitty ではデスクトップ通知を送信し、他のターミナルでは何もしません。任意のターミナルでベル文字を鳴らすには `"terminal_bell"` を設定します。`/config` に**通知**として表示されます。[ターミナルベルまたは通知を取得](/ja/terminal-config#get-a-terminal-bell-or-notification)を参照してください | `"terminal_bell"` |288| `preferredNotifChannel` | タスク完了および権限プロンプト通知の方法:`"auto"`、`"terminal_bell"`、`"iterm2"`、`"iterm2_with_bell"`、`"kitty"`、`"ghostty"`、または `"notifications_disabled"`。デフォルト:`"auto"`。iTerm2、Ghostty、Kitty ではデスクトップ通知を送信し、他のターミナルでは何もしません。任意のターミナルでベル文字を鳴らすには `"terminal_bell"` を設定します。`/config` に**通知**として表示されます。[ターミナルベルまたは通知を取得](/ja/terminal-config#get-a-terminal-bell-or-notification)を参照してください | `"terminal_bell"` |

251| `prefersReducedMotion` | アクセシビリティのために UI アニメーション(スピナー、シマー、フラッシュエフェクト)を削減または無効にします | `true` |289| `prefersReducedMotion` | アクセシビリティのために UI アニメーション(スピナー、シマー、フラッシュエフェクト)を削減または無効にします | `true` |

252| `prUrlTemplate` | フッターおよびツール結果サマリーに表示される PR バッジの URL テンプレート。`gh` レポートされた PR URL から `{host}`、`{owner}`、`{repo}`、`{number}`、および `{url}` を置き換えます。PR リンクを `github.com` の代わりに内部コードレビューツールにポイントするために使用します。Claude の散文の `#123` オートリンクには影響しません | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |290| `prUrlTemplate` | フッターおよびツール結果サマリーに表示される PR バッジの URL テンプレート。`gh` レポートされた PR URL から `{host}`、`{owner}`、`{repo}`、`{number}`、および `{url}` を置き換えます。PR リンクを `github.com` の代わりに内部コードレビューツールにポイントするために使用します。Claude の散文の `#123` オートリンクには影響しません | `"https://reviews.example.com/{owner}/{repo}/pull/{number}"` |

291| `requiredMaximumVersion` | Managed 設定のみ。起動を許可される最大 Claude Code バージョン。実行中のバージョンがより新しい場合、Claude Code は起動時に終了し、ユーザーに組織の承認された方法を通じて承認されたバージョンをインストールするよう指示します。`claude install <version>` も機能する可能性があります。背景自動更新と `claude update` は上限を超えるバージョンをスキップするため、範囲内のインストールは範囲内のままです。`claude update`、`claude install`、および `claude doctor` は上限を超えて機能し続けるため、ユーザーは回復できます。この設定より前のバージョンはそれを無視します | `"2.1.150"` |

292| `requiredMinimumVersion` | Managed 設定のみ。起動に必要な最小 Claude Code バージョン。実行中のバージョンがより古い場合、Claude Code は起動時に終了し、ユーザーに組織の承認された方法を通じて更新するよう指示します。`claude update`、`claude install`、および `claude doctor` は下限を超えて機能し続けるため、ユーザーは回復できます。ダウングレードを防止するが起動をブロックしない `minimumVersion` とは異なります。この設定より前のバージョンはそれを無視します | `"2.1.150"` |

253| `respectGitignore` | `@` ファイルピッカーが `.gitignore` パターンを尊重するかどうかを制御します。`true`(デフォルト)の場合、`.gitignore` パターンに一致するファイルは提案から除外されます | `false` |293| `respectGitignore` | `@` ファイルピッカーが `.gitignore` パターンを尊重するかどうかを制御します。`true`(デフォルト)の場合、`.gitignore` パターンに一致するファイルは提案から除外されます | `false` |

254| `showClearContextOnPlanAccept` | プラン受け入れ画面に「コンテキストをクリア」オプションを表示します。デフォルトは `false` です。`true` に設定してオプションを復元します | `true` |294| `showClearContextOnPlanAccept` | プラン受け入れ画面に「コンテキストをクリア」オプションを表示します。デフォルトは `false` です。`true` に設定してオプションを復元します | `true` |

255| `showThinkingSummaries` | [拡張思考](/ja/model-config#extended-thinking)サマリーをインタラクティブセッションに表示します。未設定または `false`(インタラクティブモードのデフォルト)の場合、思考ブロックは API によって編集され、折りたたまれたスタブとして表示されます。編集は表示内容のみを変更し、モデルが生成するものは変更しません:思考支出を削減するには、[予算を低下させるか思考を無効にする](/ja/model-config#extended-thinking)代わりに。この設定は非インタラクティブモード(`-p`)、Agent SDK、または VS Code などの IDE 拡張機能には影響しません | `true` |295| `showThinkingSummaries` | [拡張思考](/ja/model-config#extended-thinking)サマリーをインタラクティブセッションに表示します。未設定または `false`(インタラクティブモードのデフォルト)の場合、思考ブロックは API によって編集され、折りたたまれたスタブとして表示されます。編集は表示内容のみを変更し、モデルが生成するものは変更しません:思考支出を削減するには、[予算を低下させるか思考を無効にする](/ja/model-config#extended-thinking)代わりに。この設定は非インタラクティブモード(`-p`)、Agent SDK、または VS Code などの IDE 拡張機能には影響しません | `true` |


267| `syntaxHighlightingDisabled` | diff、コードブロック、ファイルプレビューの構文強調表示を無効にします | `true` |307| `syntaxHighlightingDisabled` | diff、コードブロック、ファイルプレビューの構文強調表示を無効にします | `true` |

268| `teammateMode` | [エージェントチーム](/ja/agent-teams)チームメイトの表示方法:`auto`(tmux または iTerm2 で分割ペインを選択、それ以外の場合はインプロセス)、`in-process`、または `tmux`。`--teammate-mode` はこれを 1 セッション間オーバーライドします。[表示モードを選択](/ja/agent-teams#choose-a-display-mode)を参照してください | `"in-process"` |308| `teammateMode` | [エージェントチーム](/ja/agent-teams)チームメイトの表示方法:`auto`(tmux または iTerm2 で分割ペインを選択、それ以外の場合はインプロセス)、`in-process`、または `tmux`。`--teammate-mode` はこれを 1 セッション間オーバーライドします。[表示モードを選択](/ja/agent-teams#choose-a-display-mode)を参照してください | `"in-process"` |

269| `terminalProgressBarEnabled` | サポートされているターミナルでターミナル進行状況バーを表示します:ConEmu、Ghostty 1.2.0 以降、および iTerm2 3.6.6 以降。デフォルト:`true`。`/config` に**ターミナル進行状況バー**として表示されます | `false` |309| `terminalProgressBarEnabled` | サポートされているターミナルでターミナル進行状況バーを表示します:ConEmu、Ghostty 1.2.0 以降、および iTerm2 3.6.6 以降。デフォルト:`true`。`/config` に**ターミナル進行状況バー**として表示されます | `false` |

310| `theme` | {/* min-version: 2.1.119 */}インターフェイスのカラーテーマ:`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"`、または `"custom:<slug>"` または `"custom:<plugin-name>:<slug>"` などのカスタムテーマリファレンス。デフォルト:`"dark"`。[カスタムテーマを作成](/ja/terminal-config#create-a-custom-theme)を参照してください。`/config` に**テーマ**として表示されます | `"dark"` |

270| `tui` | ターミナル UI レンダラー。フリッカーのない[alt-screen レンダラー](/ja/fullscreen)を備えた仮想スクロールバック用に `"fullscreen"` を使用します。クラシックメインスクリーンレンダラー用に `"default"` を使用します。`/tui` で設定します。[`CLAUDE_CODE_NO_FLICKER`](/ja/env-vars)環境変数を設定することもできます。[エージェントビュー](/ja/agent-view)から開かれたバックグラウンドセッションは、この設定に関係なく常にフルスクリーンレンダラーを使用します | `"fullscreen"` |311| `tui` | ターミナル UI レンダラー。フリッカーのない[alt-screen レンダラー](/ja/fullscreen)を備えた仮想スクロールバック用に `"fullscreen"` を使用します。クラシックメインスクリーンレンダラー用に `"default"` を使用します。`/tui` で設定します。[`CLAUDE_CODE_NO_FLICKER`](/ja/env-vars)環境変数を設定することもできます。[エージェントビュー](/ja/agent-view)から開かれたバックグラウンドセッションは、この設定に関係なく常にフルスクリーンレンダラーを使用します | `"fullscreen"` |

271| `ultracode` | セッションの [ultracode](/ja/workflows#let-claude-decide-with-ultracode)をオンにします。セッションのみで `settings.json` から読み込まれません。`/effort ultracode`、`--settings`、または Agent SDK 制御リクエストを通じて設定します | `true` |312| `ultracode` | セッションの [ultracode](/ja/workflows#let-claude-decide-with-ultracode)をオンにします。セッションのみで `settings.json` から読み込まれません。`/effort ultracode`、`--settings`、または Agent SDK 制御リクエストを通じて設定します | `true` |

272| `useAutoModeDuringPlan` | プラン モードが自動モードが利用可能な場合に自動モードセマンティクスを使用するかどうか。デフォルト:`true`。共有プロジェクト設定から読み込まれません。`/config` に「プラン中に自動モードを使用」として表示されます | `false` |313| `useAutoModeDuringPlan` | プラン モードが自動モードが利用可能な場合に自動モードセマンティクスを使用するかどうか。デフォルト:`true`。共有プロジェクト設定から読み込まれません。`/config` に「プラン中に自動モードを使用」として表示されます | `false` |

314| `verbose` | {/* min-version: 2.1.119 */}切り詰められたサマリーの代わりに完全なツール出力を表示します。デフォルト:`false`。`/config` に**詳細出力**として表示されます。`--verbose` フラグはこれを 1 セッション間オーバーライドします | `true` |

273| `viewMode` | 起動時のデフォルトトランスクリプトビューモード:`"default"`、`"verbose"`、または `"focus"`。設定されている場合、スティッキー `/focus` 選択をオーバーライドします。`--verbose` フラグはこれを 1 セッション間オーバーライドします | `"verbose"` |315| `viewMode` | 起動時のデフォルトトランスクリプトビューモード:`"default"`、`"verbose"`、または `"focus"`。設定されている場合、スティッキー `/focus` 選択をオーバーライドします。`--verbose` フラグはこれを 1 セッション間オーバーライドします | `"verbose"` |

274| `voice` | [音声ディクテーション](/ja/voice-dictation)設定:`enabled` はディクテーションをオンにし、`mode` は `"hold"` または `"tap"` を選択し、`autoSubmit` はホールドモードでキーリリース時にプロンプトを送信します。`/voice` を実行すると自動的に書き込まれます。Claude.ai アカウントが必要です | `{ "enabled": true, "mode": "tap" }` |316| `voice` | [音声ディクテーション](/ja/voice-dictation)設定:`enabled` はディクテーションをオンにし、`mode` は `"hold"` または `"tap"` を選択し、`autoSubmit` はホールドモードでキーリリース時にプロンプトを送信します。`/voice` を実行すると自動的に書き込まれます。Claude.ai アカウントが必要です | `{ "enabled": true, "mode": "tap" }` |

275| `voiceEnabled` | `voice.enabled` のレガシーエイリアス。`voice` オブジェクトを優先します | `true` |317| `voiceEnabled` | `voice.enabled` のレガシーエイリアス。`voice` オブジェクトを優先します | `true` |

318| `wheelScrollAccelerationEnabled` | {/* min-version: 2.1.174 */}[フルスクリーンレンダリング](/ja/fullscreen#mouse-wheel-scrolling)で、高速スクロール中にマウスホイールスクロール速度を加速します。デフォルト:`true`。ホイールノッチごとに一定のスクロール速度を使用するには `false` に設定します。Claude Code v2.1.174 以降が必要です | `false` |

276| `workflowKeywordTriggerEnabled` | {/* min-version: 2.1.157 */}プロンプト内の単語 `ultracode` が[動的ワークフロー](/ja/workflows#ask-for-a-workflow-in-your-prompt)をトリガーするかどうか。単語を入力してトリガーしないようにするには `false` に設定します。ultracode 努力設定、`/workflows`、および保存されたワークフローコマンドは影響を受けません。デフォルト:`true`。`/config` に**ワークフローキーワードトリガー**として表示されます。v2.1.157 で追加されました。v2.1.160 より前は、トリガーキーワードは `workflow` でした | `false` |319| `workflowKeywordTriggerEnabled` | {/* min-version: 2.1.157 */}プロンプト内の単語 `ultracode` が[動的ワークフロー](/ja/workflows#ask-for-a-workflow-in-your-prompt)をトリガーするかどうか。単語を入力してトリガーしないようにするには `false` に設定します。ultracode 努力設定、`/workflows`、および保存されたワークフローコマンドは影響を受けません。デフォルト:`true`。`/config` に**ワークフローキーワードトリガー**として表示されます。v2.1.157 で追加されました。v2.1.160 より前は、トリガーキーワードは `workflow` でした | `false` |

277| `wslInheritsWindowsSettings` | (Windows managed 設定のみ)`true` の場合、WSL 上の Claude Code は `/etc/claude-code` に加えて Windows ポリシーチェーンから managed 設定を読み込み、Windows ソースが優先されます。HKLM レジストリキーまたは `C:\Program Files\ClaudeCode\managed-settings.json` で設定されている場合のみ尊重されます。どちらも Windows 管理者が書き込む必要があります。HKCU ポリシーが WSL でも適用されるようにするには、フラグを HKCU 自体にも設定する必要があります。ネイティブ Windows には影響しません | `true` |320| `wslInheritsWindowsSettings` | (Windows managed 設定のみ)`true` の場合、WSL 上の Claude Code は `/etc/claude-code` に加えて Windows ポリシーチェーンから managed 設定を読み込み、Windows ソースが優先されます。HKLM レジストリキーまたは `C:\Program Files\ClaudeCode\managed-settings.json` で設定されている場合のみ尊重されます。どちらも Windows 管理者が書き込む必要があります。HKCU ポリシーが WSL でも適用されるようにするには、フラグを HKCU 自体にも設定する必要があります。ネイティブ Windows には影響しません | `true` |

278 321 


283これらの設定は `settings.json` ではなく `~/.claude.json` に保存されます。これらを `settings.json` に追加すると、スキーマ検証エラーがトリガーされます。326これらの設定は `settings.json` ではなく `~/.claude.json` に保存されます。これらを `settings.json` に追加すると、スキーマ検証エラーがトリガーされます。

284 327 

285<Note>328<Note>

286 v2.1.119 より前のバージョンでは、`autoScrollEnabled`、`editorMode`、`showTurnDuration`、`teammateMode`、および `terminalProgressBarEnabled` も `settings.json` ではなくここに保存されます。329 v2.1.119 より前のバージョンでは、`theme`、`verbose`、`editorMode`、`autoCompactEnabled`、および `preferredNotifChannel` も `settings.json` ではなくここに保存されます。

287</Note>330</Note>

288 331 

289| キー | 説明 | 例 |332| キー | 説明 | 例 |


303| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |346| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

304| `worktree.baseRef` | 新しい worktrees がブランチする ref。`"fresh"`(デフォルト)は `origin/<default-branch>` からブランチして、リモートと一致するクリーンツリーを取得します。`"head"` は現在のローカル `HEAD` からブランチするため、プッシュされていないコミットとフィーチャーブランチの状態が worktree に存在します。`--worktree`、`EnterWorktree` ツール、および subagent 分離に適用されます | `"head"` |347| `worktree.baseRef` | 新しい worktrees がブランチする ref。`"fresh"`(デフォルト)は `origin/<default-branch>` からブランチして、リモートと一致するクリーンツリーを取得します。`"head"` は現在のローカル `HEAD` からブランチするため、プッシュされていないコミットとフィーチャーブランチの状態が worktree に存在します。`--worktree`、`EnterWorktree` ツール、および subagent 分離に適用されます | `"head"` |

305| `worktree.symlinkDirectories` | メインリポジトリから各 worktree にシンボリックリンクするディレクトリ。ディスク上の大規模なディレクトリの重複を避けるため。デフォルトではディレクトリはシンボリックリンクされません | `["node_modules", ".cache"]` |348| `worktree.symlinkDirectories` | メインリポジトリから各 worktree にシンボリックリンクするディレクトリ。ディスク上の大規模なディレクトリの重複を避けるため。デフォルトではディレクトリはシンボリックリンクされません | `["node_modules", ".cache"]` |

306| `worktree.sparsePaths` | git sparse-checkout を通じて各 worktree でチェックアウトするディレクトリ。リストされたパスのみがディスクに書き込まれます。大規模なモノレポではより高速です | `["packages/my-app", "shared/utils"]` |349| `worktree.sparsePaths` | git sparse-checkout を通じて各 worktree でチェックアウトするディレクトリ。リストされたパスのみがディスク上に書き込まれます。大規模なモノレポではより高速です | `["packages/my-app", "shared/utils"]` |

307| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}[バックグラウンドセッション](/ja/agent-view#how-file-edits-are-isolated)の分離モード。`"worktree"`(デフォルト)は `EnterWorktree` が呼び出されるまでメインチェックアウトで `Edit`/`Write` をブロックします。`"none"` はバックグラウンドジョブがワーキングコピーを直接編集できるようにします。Claude Code v2.1.143 以降が必要です | `"none"` |350| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}[バックグラウンドセッション](/ja/agent-view#how-file-edits-are-isolated)の分離モード。`"worktree"`(デフォルト)は `EnterWorktree` が呼び出されるまでメインチェックアウトで `Edit`/`Write` をブロックします。`"none"` はバックグラウンドジョブがワーキングコピーを直接編集できるようにします。Claude Code v2.1.143 以降が必要です | `"none"` |

308 351 

309gitignored ファイル(`.env` など)を新しい worktrees にコピーするには、設定の代わりにプロジェクトルートの [`.worktreeinclude` ファイル](/ja/worktrees#copy-gitignored-files-into-worktrees)を使用します。352gitignored ファイル(`.env` など)を新しい worktrees にコピーするには、設定の代わりにプロジェクトルートの [`.worktreeinclude` ファイル](/ja/worktrees#copy-gitignored-files-into-worktrees)を使用します。


314 357 

315| キー | 説明 | 例 |358| キー | 説明 | 例 |

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

317| `allow` | ツール使用を許可する権限ルールの配列。パターンマッチングの詳細については、以下の[権限ルール構文](#permission-rule-syntax)を参照してください | `[ "Bash(git diff *)" ]` |360| `allow` | ツール使用を許可する権限ルールの配列。ツール名 glob はリテラル `mcp__<server>__` プレフィックスの後のツール位置でのみサポートされます。たとえば `mcp__github__get_*`。サーバーセグメントは glob フリーである必要があります。パターンマッチングの詳細については、以下の[権限ルール構文](#permission-rule-syntax)を参照してください | `[ "Bash(git diff *)" ]` |

318| `ask` | ツール使用時に確認を求める権限ルールの配列。[権限ルール構文](#permission-rule-syntax)を参照してください | `[ "Bash(git push *)" ]` |361| `ask` | ツール使用時に確認を求める権限ルールの配列。[権限ルール構文](#permission-rule-syntax)を参照してください | `[ "Bash(git push *)" ]` |

319| `deny` | ツール使用を拒否する権限ルールの配列。これを使用して、機密ファイルを Claude Code アクセスから除外します。[権限ルール構文](#permission-rule-syntax)と [Bash 権限制限](/ja/permissions#tool-specific-permission-rules)を参照してください | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |362| `deny` | ツール使用を拒否する権限ルールの配列。これを使用して、機密ファイルを Claude Code アクセスから除外します。ツール名は glob パターンを受け入れます:`"*"` はすべてのツールを拒否し、`"mcp__*"` はすべての MCP ツールを拒否します。[権限ルール構文](#permission-rule-syntax)と [Bash 権限制限](/ja/permissions#tool-specific-permission-rules)を参照してください | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

320| `additionalDirectories` | Claude がアクセスできる追加の[作業ディレクトリ](/ja/permissions#working-directories) | `[ "../docs/" ]` |363| `additionalDirectories` | Claude がアクセスできる追加の[作業ディレクトリ](/ja/permissions#working-directories)。ほとんどの `.claude/` 構成は[これらのディレクトリから検出されません](/ja/permissions#additional-directories-grant-file-access-not-configuration) | `[ "../docs/" ]` |

321| `defaultMode` | Claude Code を開くときのデフォルト[権限モード](/ja/permission-modes)。有効な値:`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`。{/* min-version: 2.1.142 */}Claude Code v2.1.142 以降、`auto` はプロジェクトまたはローカル設定(`.claude/settings.json`、`.claude/settings.local.json`)で設定されている場合は無視されるため、リポジトリはそれ自体に自動モードを付与できません。代わりに `~/.claude/settings.json` で設定します。`--permission-mode` CLI フラグは単一セッションのこの設定をオーバーライドします | `"acceptEdits"` |364| `defaultMode` | Claude Code を開くときのデフォルト[権限モード](/ja/permission-modes)。有効な値:`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`。{/* min-version: 2.1.142 */}Claude Code v2.1.142 以降、`auto` はプロジェクトまたはローカル設定(`.claude/settings.json`、`.claude/settings.local.json`)で設定されている場合は無視されるため、リポジトリはそれ自体に自動モードを付与できません。代わりに `~/.claude/settings.json` で設定します。`--permission-mode` CLI フラグは単一セッションのこの設定をオーバーライドします | `"acceptEdits"` |

322| `disableBypassPermissionsMode` | `"disable"` に設定して `bypassPermissions` モードの有効化を防止します。これにより `--dangerously-skip-permissions` フラグが無効になります。通常は [managed 設定](/ja/permissions#managed-settings)に配置されます。ユーザーはこれをオーバーライドできません | `"disable"` |365| `disableBypassPermissionsMode` | `"disable"` に設定して `bypassPermissions` モードの有効化を防止します。これにより `--dangerously-skip-permissions` フラグが無効になります。通常は [managed 設定](/ja/permissions#managed-settings)に配置されます。ユーザーはこれをオーバーライドできません | `"disable"` |

323| `skipDangerousModePermissionPrompt` | `--dangerously-skip-permissions` または `defaultMode: "bypassPermissions"` を通じてバイパス権限モードに入る前に表示される確認プロンプトをスキップします。信頼されていないリポジトリがプロンプトを自動バイパスするのを防ぐため、プロジェクト設定(`.claude/settings.json`)で設定されている場合は無視されます | `true` |366| `skipDangerousModePermissionPrompt` | `--dangerously-skip-permissions` または `defaultMode: "bypassPermissions"` を通じてバイパス権限モードに入る前に表示される確認プロンプトをスキップします。信頼されていないリポジトリがプロンプトを自動バイパスするのを防ぐため、プロジェクト設定(`.claude/settings.json`)で設定されている場合は無視されます | `true` |


326 権限ルール構文369 権限ルール構文

327</h3>370</h3>

328 371 

329権限ルールは `Tool` または `Tool(specifier)` の形式に従います。ルールは順序で評価されます:最初に拒否ルール、次に ask、次に allow。最初に一致するルールが優先されます。372権限ルールは `Tool` または `Tool(specifier)` の形式に従います。ルールは順序で評価されます:最初に拒否ルール、次に ask、次に allow。最初に一致するルールが優先されます。[権限ルール評価順序](/ja/permissions#manage-permissions)を参照してください。

330 373 

331クイック例:374クイック例:

332 375 


431**デフォルトコミット属性:**474**デフォルトコミット属性:**

432 475 

433```text theme={null}476```text theme={null}

434🤖 Generated with [Claude Code](https://claude.com/claude-code)477Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

435 

436 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

437```478```

438 479 

480セッションのアクティブなモデルはトレーラーのモデル名を反映します。

481 

439**デフォルトプルリクエスト属性:**482**デフォルトプルリクエスト属性:**

440 483 

441```text theme={null}484```text theme={null}


491```bash theme={null}534```bash theme={null}

492#!/bin/bash535#!/bin/bash

493query=$(cat | jq -r '.query')536query=$(cat | jq -r '.query')

537# your-repo-file-index をあなた自身のファイル検索コマンドに置き換えます

494your-repo-file-index --query "$query" | head -20538your-repo-file-index --query "$query" | head -20

495```539```

496 540 

541<h3 id="footer-link-badges">

542 フッターリンクバッジ

543</h3>

544 

545`footerLinksRegexes` 設定は、入力ボックスの下のフッターに追加のクリック可能なバッジをレンダリングします。プロジェクト CLI によって出力される ID(レビューツールと問題トラッカーなど)をセッションリンクに変換するために使用します。

546 

547各エントリの `pattern` 正規表現はターン出力に対してマッチされます:ツール結果(ファイルコンテンツとフェッチされたページを含む)および Claude 自身の応答。`url` と `label` の `{name}` プレースホルダーはパターンの名前付きキャプチャグループから入力されます。

548 

549次の例は、`PROJ-1234` のような問題キーがターン出力に表示されるたびにバッジをレンダリングします。`(?<key>...)` 名前付きグループはキーをキャプチャし、`{key}` は URL とラベルに置き換えられます:

550 

551```json ~/.claude/settings.json theme={null}

552{

553 "footerLinksRegexes": [

554 {

555 "type": "regex",

556 "pattern": "\\b(?<key>PROJ-\\d+)\\b",

557 "url": "https://issues.example.com/browse/{key}",

558 "label": "{key}"

559 }

560 ]

561}

562```

563 

564これが構成されている場合、`PROJ-1234` がツール結果または Claude の返信に表示されると、`PROJ-1234` チップがフッターに表示され、`https://issues.example.com/browse/PROJ-1234` にリンクされます。

565 

566各エントリに以下の制約が適用されます:

567 

568| 制約 | 動作 |

569| :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

570| URL オリジン | キャプチャされた値は URL エンコードされ、構築された URL はテンプレートのリテラルオリジンを共有する必要があります。キャプチャはパスセグメントまたはクエリ値を入力できますが、リンクがポイントする場所を変更することはできません |

571| URL 長 | 2048 文字より長い構築された URL は削除されます |

572| URL スキーム | `https`、`http`、または認識されたエディターまたはワークスペースディープリンクスキーム:`vscode`、`vscode-insiders`、`cursor`、`windsurf`、`zed`、`jetbrains`、`idea`、`slack`、`linear`、`notion`、`figma` である必要があります |

573| ラベル | デフォルトはマッチされたテキストで、28 表示列に切り詰められます |

574| バッジ数 | 最大 5 つのバッジがレンダリングされます。最も古いものは新しいマッチによって置き換えられ、`/clear` はそれらを削除します |

575| 設定スコープ | ユーザー設定、`--settings` フラグ、および managed 設定からのみ読み込まれます。プロジェクト `.claude/settings.json` およびローカル `.claude/settings.local.json` では無視されます |

576 

577ターンが完了すると、Claude Code はメインスレッドでターン出力に対して各エントリの `pattern` 正規表現をマッチします。そのため、遅い正規表現は UI をブロックしてセッションを凍結するまでブロックします。`(a+)+$` などのネストされた量指定子は、特定の入力に対して指数関数的に長くかかる可能性があるため、各 `pattern` を線形に保ち、`+` または `*` のネストを避けます。

578 

579フッターバッジは、構成されている場合、[カスタムステータスライン](/ja/statusline)と並んでレンダリングされます。どちらも他方を置き換えません。セッションデータから独自のコンテンツを計算するスクリプト駆動行にはステータスラインを使用し、スクリプトなしで会話から ID をリンクに変換するにはフッターバッジを使用します。

580 

497<h3 id="hook-configuration">581<h3 id="hook-configuration">

498 Hook 構成582 Hook 構成

499</h3>583</h3>


560 644 

561設定は優先度の順に適用されます。最高から最低:645設定は優先度の順に適用されます。最高から最低:

562 646 

5631. **Managed 設定**([サーバー管理](/ja/server-managed-settings)、[MDM/OS レベルのポリシー](#configuration-scopes)、または [managed 設定](/ja/settings#settings-files))6471. **Managed 設定**([サーバー管理](/ja/server-managed-settings)、[MDM/OS レベルのポリシー](#configuration-scopes)、または [managed 設定](#settings-files))

564 * IT がサーバー配信、MDM 構成プロファイル、レジストリポリシー、または managed 設定ファイルを通じて展開するポリシー648 * IT がサーバー配信、MDM 構成プロファイル、レジストリポリシー、または managed 設定ファイルを通じて展開するポリシー

565 * コマンドラインの引数を含む他のレベルでオーバーライドできません649 * コマンドラインの引数を含む他のレベルでオーバーライドできません

566 * managed ティア内では、優先度は:サーバー管理 > MDM/OS レベルのポリシー > ファイルベース(`managed-settings.d/*.json` + `managed-settings.json`)> HKCU レジストリ(Windows のみ)です。1 つの managed ソースのみが使用されます。ソースはマージされません。ファイルベースティア内では、ドロップインファイルとベースファイルがマージされます。650 * managed ティア内では、優先度は:サーバー管理 > MDM/OS レベルのポリシー > ファイルベース(`managed-settings.d/*.json` + `managed-settings.json`)> HKCU レジストリ(Windows のみ)です。1 つの managed ソースのみが使用されます。ソースはマージされません。ファイルベースティア内では、ドロップインファイルとベースファイルがマージされます。


583たとえば、ユーザー設定が `permissions.defaultMode` を `acceptEdits` に設定しているが、プロジェクトの共有設定がそれを `default` に設定している場合、プロジェクト値が適用されます。以下の例は、配列値の設定(権限ルールなど)がどのように結合されるかについて説明しています。667たとえば、ユーザー設定が `permissions.defaultMode` を `acceptEdits` に設定しているが、プロジェクトの共有設定がそれを `default` に設定している場合、プロジェクト値が適用されます。以下の例は、配列値の設定(権限ルールなど)がどのように結合されるかについて説明しています。

584 668 

585<Note>669<Note>

586 **配列設定はスコープ全体でマージされます。** 同じ配列値の設定(`sandbox.filesystem.allowWrite` や `permissions.allow` など)が複数のスコープに表示される場合、配列は**連結および重複排除**され、置き換えられません。これは、低優先度のスコープが高優先度のスコープで設定されたエントリをオーバーライドすることなくエントリを追加でき、その逆も同様です。たとえば、managed 設定が `allowWrite` を `["/opt/company-tools"]` に設定し、ユーザーが `["~/.kube"]` を追加する場合、両方のパスが最終構成に含まれます。670 **配列設定はスコープ全体でマージされます。** 同じ配列値の設定(`sandbox.filesystem.allowWrite` や `permissions.allow` など)が複数のスコープに表示される場合、配列は**連結および重複排除**され、置き換えられません。これは、低優先度のスコープが高優先度のスコープで設定されたエントリをオーバーライドすることなくエントリを追加でき、その逆も同様です。たとえば、managed 設定が `allowWrite` を `["/opt/company-tools"]` に設定し、ユーザーが `["~/.kube"]` を追加する場合、両方のパスが最終構成に含まれます。唯一の例外は [`fallbackModel`](#available-settings)。位置が意味を持つ順序付きチェーン:これを定義する最高優先度ファイルが全体の値を提供します。{/* min-version: 2.1.175 */}v2.1.175 以降、[`availableModels`](#available-settings)。managed またはポリシー値は低優先度エントリを完全に置き換えます。[マージ動作](/ja/model-config#merge-behavior)を参照してください。

587</Note>671</Note>

588 672 

589<h3 id="verify-active-settings">673<h3 id="verify-active-settings">

590 アクティブな設定を確認674 アクティブな設定を確認

591</h3>675</h3>

592 676 

593Claude Code 内で `/status` を実行して、どの設定ソースがアクティブで、どこから来ているかを確認します。Status タブには、`Setting sources` 行が含まれており、Claude Code が現在のセッション用に読み込んだ各レイヤーをリストしますたとえば、`User settings` または `Project local settings` などです。[managed 設定](/ja/managed-settings)が有効な場合、エントリは配信チャネルを括弧内に表示します。たとえば、`Enterprise managed settings (remote)`、`(plist)`、`(HKLM)`、`(HKCU)`、または `(file)` などです。レイヤーは、そのソースが少なくとも 1 つのキーで読み込まれた場合にのみリストに表示されるため、空のリストは設定ソースが見つからなかったことを意味します。677Claude Code 内で `/status` を実行して、どの設定ソースがアクティブであるかを確認しますメニュー内の **Status** タブには、`Setting sources` 行が含まれており、このセッション用に Claude Code が読み込んだ各レイヤーをリストします。`User settings` または `Project local settings` などのレイヤーが表示される場合、そのソースはそのセッション用に読み込まれています。[managed 設定](/ja/admin-setup#decide-how-settings-reach-devices)が有効な場合、エントリは配信チャネルを括弧内に表示します。たとえば、`Enterprise managed settings (remote)`、`(plist)`、`(HKLM)`、`(HKCU)`、または `(file)` などです。レイヤーは、そのソースが少なくとも 1 つのキーで読み込まれた場合にのみリストに表示されるため、空のリストは設定ソースが見つからなかったことを意味します。

678 

679`Setting sources` 行は、どのソースが読み込まれているかを確認します。各個別キーがどのレイヤーから供給されたかは表示されません。同じダイアログの **Config** タブは、テーマや詳細出力などの固定されたトグルセットのエディターであり、`settings.json` コンテンツのビューではありません。

594 680 

595`Setting sources` 行はどのソースが読み込まれているかを確認します。各個別キーがどのレイヤーから供給されたかは表示されません。同じダイアログの Config タブは、テーマや詳細出力などの固定されたトグルセットのエディターであり、`settings.json` コンテンツのビューではありません設定ファイルに無効な JSON や検証に失敗した値などのエラーが含まれている場合、`/status` は問題を報告して修正できるようにします681設定ファイルに無効な JSON やバリデーションに失敗する値などのエラーが含まれている場合Claude Code は起動時にセットアップの問題通知を表示し、`/status` は影響を受けたファイルをリストします各エラーの詳細については `/doctor` を実行してください

596 682 

597<h3 id="key-points-about-the-configuration-system">683<h3 id="key-points-about-the-configuration-system">

598 構成システムの重要なポイント684 構成システムの重要なポイント


603* **Skills**:`/skill-name` で呼び出すか、Claude によって自動的に読み込むことができるカスタムプロンプト689* **Skills**:`/skill-name` で呼び出すか、Claude によって自動的に読み込むことができるカスタムプロンプト

604* **MCP サーバー**:追加のツールと統合で Claude Code を拡張します690* **MCP サーバー**:追加のツールと統合で Claude Code を拡張します

605* **優先度**:高レベルの構成(Managed)が低レベルの構成(User/Project)をオーバーライドします691* **優先度**:高レベルの構成(Managed)が低レベルの構成(User/Project)をオーバーライドします

606* **継承**:設定はマージされ、より具体的な設定がより広い設定に追加またはオーバーライドされます692* **継承**:設定はマージされ、スカラー値はより高い優先度のスコープからオーバーライドされ、配列は連結されます。例外:`fallbackModel`。位置が意味を持つ順序付きチェーン:これを定義する最高優先度ファイルが全体の値を提供します。{/* min-version: 2.1.175 */}v2.1.175 以降、`availableModels`。managed またはポリシー値は低優先度エントリを完全に置き換えます

607 693 

608<h3 id="system-prompt">694<h3 id="system-prompt">

609 システムプロンプト695 システムプロンプト


684 770 

685* **ユーザー設定**(`~/.claude/settings.json`):個人的なプラグイン設定771* **ユーザー設定**(`~/.claude/settings.json`):個人的なプラグイン設定

686* **プロジェクト設定**(`.claude/settings.json`):チームと共有されるプロジェクト固有のプラグイン772* **プロジェクト設定**(`.claude/settings.json`):チームと共有されるプロジェクト固有のプラグイン

687* **ローカル設定**(`.claude/settings.local.json`):マシンごとのオーバーライド(コミットされない773* **ローカル設定**(`.claude/settings.local.json`):マシンごとのオーバーライド(Claude Code が作成する場合は gitignored

688* **Managed 設定**(`managed-settings.json`):すべてのスコープでのインストールをブロックし、マーケットプレイスからプラグインを非表示にする組織全体のポリシーオーバーライド774* **Managed 設定**(`managed-settings.json`):すべてのスコープでのインストールをブロックし、マーケットプレイスからプラグインを非表示にする組織全体のポリシーオーバーライド

689 775 

690<Note>776<Note>

setup.md +28 −6

Details

258 258 

259[管理設定](/ja/permissions#managed-settings)では、これはユーザーおよびプロジェクト設定がオーバーライドできない組織全体の最小値を適用します。259[管理設定](/ja/permissions#managed-settings)では、これはユーザーおよびプロジェクト設定がオーバーライドできない組織全体の最小値を適用します。

260 260 

261`minimumVersion` ピンは更新のみを制約します。Claude Code がバージョン範囲外で起動することを拒否するようにするには、代わりに管理設定の `requiredMinimumVersion` と `requiredMaximumVersion` を使用します。更新は `requiredMaximumVersion` の上限も尊重します。[利用可能な設定](/ja/settings#available-settings)を参照してください。

262 

261<h3 id="disable-auto-updates">263<h3 id="disable-auto-updates">

262 自動更新を無効にする264 自動更新を無効にする

263</h3>265</h3>


366 Linux パッケージマネージャーでのインストール368 Linux パッケージマネージャーでのインストール

367</h3>369</h3>

368 370 

369Claude Code は署名付き apt、dnf、および apk リポジトリを公開しています。ローリングチャネルの場合は `stable` `latest` に置き換えてください。パッケージマネージャーのインストールは Claude Code を通じて自動更新されません。更新は通常のシステムアップグレードワークフローを通じて提供されます。371Claude Code は署名付き apt、dnf、および apk リポジトリを公開しています。各リポジトリは 2 つのチャネルを提供します。`stable` は通常約 1 週間前のバージョンを提供し、大きな回帰を伴うリリースをスキップします。`latest` はリリースが出荷されるとすぐにすべてのリリースを提供します以下のコマンドは `stable` チャネルを構成します。これはほとんどのユーザーに適しています。各タブは `latest` リポジトリ URL も表示します。パッケージマネージャーのインストールは Claude Code を通じて自動更新されません。更新は通常のシステムアップグレードワークフローを通じて提供されます。

370 372 

371すべてのリポジトリは [Claude Code リリース署名キー](#binary-integrity-and-code-signing)で署名されています。キーを信頼する前に、各タブで説明されているとおりに検証してください。373すべてのリポジトリは [Claude Code リリース署名キー](#binary-integrity-and-code-signing)で署名されています。キーを信頼する前に、各タブで説明されているとおりに検証してください。

372 374 

373<Tabs>375<Tabs>

374 <Tab title="apt">376 <Tab title="apt">

375 Debian および Ubuntu 用です。ローリングチャネルを使用するには、`deb` 行の両方の `stable` を変更します。URL パスとスイート名です。377 Debian および Ubuntu 用です。以下のコマンドは `stable` チャネルを構成します:

376 378 

377 ```bash theme={null}379 ```bash theme={null}

378 sudo install -d -m 0755 /etc/apt/keyrings380 sudo install -d -m 0755 /etc/apt/keyrings


384 sudo apt install claude-code386 sudo apt install claude-code

385 ```387 ```

386 388 

389 代わりに `latest` チャネルを使用するには、URL パスとスイート名の両方が変わります。この `deb` 行を使用します:

390 

391 ```bash theme={null}

392 echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/latest latest main" \

393 | sudo tee /etc/apt/sources.list.d/claude-code.list

394 ```

395 

387 信頼する前に GPG キーフィンガープリントを検証します。`gpg --show-keys /etc/apt/keyrings/claude-code.asc` は `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE` を報告する必要があります。396 信頼する前に GPG キーフィンガープリントを検証します。`gpg --show-keys /etc/apt/keyrings/claude-code.asc` は `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE` を報告する必要があります。

388 397 

389 後で更新するには、`sudo apt update && sudo apt upgrade claude-code` を実行します。398 後で更新するには、`sudo apt update && sudo apt upgrade claude-code` を実行します。

390 </Tab>399 </Tab>

391 400 

392 <Tab title="dnf">401 <Tab title="dnf">

393 Fedora および RHEL :402 Fedora および RHEL 用です。以下のコマンドは `stable` チャネルを構成します:

394 403 

395 ```bash theme={null}404 ```bash theme={null}

396 sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'405 sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'


404 sudo dnf install claude-code413 sudo dnf install claude-code

405 ```414 ```

406 415 

416 代わりに `latest` チャネルを使用するには、`baseurl` を `latest` リポジトリに設定します:

417 

418 ```ini theme={null}

419 baseurl=https://downloads.claude.ai/claude-code/rpm/latest

420 ```

421 

407 dnf は最初のインストール時にキーをダウンロードし、フィンガープリントを確認するよう求めます。受け入れる前に `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE` と一致することを確認してください。422 dnf は最初のインストール時にキーをダウンロードし、フィンガープリントを確認するよう求めます。受け入れる前に `31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE` と一致することを確認してください。

408 423 

409 後で更新するには、`sudo dnf upgrade claude-code` を実行します。424 後で更新するには、`sudo dnf upgrade claude-code` を実行します。

410 </Tab>425 </Tab>

411 426 

412 <Tab title="apk">427 <Tab title="apk">

413 Alpine Linux :428 Alpine Linux 用です。以下のコマンドは `stable` チャネルを構成します:

414 429 

415 ```sh theme={null}430 ```sh theme={null}

416 wget -O /etc/apk/keys/claude-code.rsa.pub \431 wget -O /etc/apk/keys/claude-code.rsa.pub \


419 apk add claude-code434 apk add claude-code

420 ```435 ```

421 436 

437 `latest` チャネルに切り替えるには、`stable` リポジトリ行を削除し、`latest` リポジトリを追加します:

438 

439 ```sh theme={null}

440 sed -i '\|downloads.claude.ai/claude-code/apk/stable|d' /etc/apk/repositories

441 echo "https://downloads.claude.ai/claude-code/apk/latest" >> /etc/apk/repositories

442 ```

443 

422 `sha256sum /etc/apk/keys/claude-code.rsa.pub` でダウンロードされたキーを検証します。これは `395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6` を報告する必要があります。444 `sha256sum /etc/apk/keys/claude-code.rsa.pub` でダウンロードされたキーを検証します。これは `395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6` を報告する必要があります。

423 445 

424 後で更新するには、`apk update && apk upgrade claude-code` を実行します。446 後で更新するには、`apk update && apk upgrade claude-code` を実行します。


471 gpg --fingerprint security@anthropic.com493 gpg --fingerprint security@anthropic.com

472 ```494 ```

473 495 

474 出力にこのフィンガープリントが含まれていることを確認します496 出力にこのフィンガープリントが含まれていることを確認します:

475 497 

476 ```text theme={null}498 ```text theme={null}

477 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE499 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE


538 560 

539* **macOS**: "Anthropic PBC" によって署名され、Apple によって公証されています。`codesign --verify --verbose ./claude` で検証します。561* **macOS**: "Anthropic PBC" によって署名され、Apple によって公証されています。`codesign --verify --verbose ./claude` で検証します。

540* **Windows**: "Anthropic, PBC" によって署名されています。`Get-AuthenticodeSignature .\claude.exe` で検証します。562* **Windows**: "Anthropic, PBC" によって署名されています。`Get-AuthenticodeSignature .\claude.exe` で検証します。

541* **Linux**: バイナリは個別にコード署名されていません。`claude-code-releases` バケットから直接ダウンロードするか、ネイティブインストーラーを使用する場合は、上記のマニフェスト署名で整合性を検証します。[apt、dnf、または apk](#install-with-linux-package-managers) でインストールする場合、パッケージマネージャーはリポジトリ署名キーを使用して署名を自動的に検証します。563* **Linux**: バイナリは個別にコード署名されていません。`claude-code-releases` バケットから直接ダウンロードするか、ネイティブインストーラーを使用する場合は、上記のマニフェスト署名で整合性を検証します。[apt、dnf、または apk](#install-with-linux-package-managers)でインストールする場合、パッケージマネージャーはリポジトリ署名キーを使用して署名を自動的に検証します。

542 564 

543<h2 id="uninstall-claude-code">565<h2 id="uninstall-claude-code">

544 Claude Code をアンインストール566 Claude Code をアンインストール

skills.md +17 −4

Details

22 バンドルされたスキル22 バンドルされたスキル

23</h2>23</h2>

24 24 

25Claude Code には、すべてのセッションで利用可能な一連のバンドルされたスキルが含まれています。これには `/code-review`、`/batch`、`/debug`、`/loop`、および `/claude-api` が含まれます。固定ロジックを直接実行する組み込みコマンドとは異なり、バンドルされたスキルはプロンプトベースです。Claude に詳細な指示を提供し、ツールを使用して作業を調整させます。他のスキルと同じ方法で呼び出します。`/` の後にスキル名を入力します。25Claude Code には、[`disableBundledSkills`](/ja/settings#available-settings) 設定で無効にしない限り、すべてのセッションで利用可能な一連のバンドルされたスキルが含まれています。これには `/code-review`、`/batch`、`/debug`、`/loop`、および `/claude-api` が含まれます。固定ロジックを直接実行する組み込みコマンドとは異なり、バンドルされたスキルはプロンプトベースです。Claude に詳細な指示を提供し、ツールを使用して作業を調整させます。他のスキルと同じ方法で呼び出します。`/` の後にスキル名を入力します。

26 26 

27バンドルされたスキルは [コマンドリファレンス](/ja/commands) に組み込みコマンドと一緒にリストされており、目的列に**スキル**とマークされています。27バンドルされたスキルは [コマンドリファレンス](/ja/commands) に組み込みコマンドと一緒にリストされており、目的列に**スキル**とマークされています。

28 28 


119 119 

120スキルがレベル全体で同じ名前を共有する場合、enterprise は personal をオーバーライドし、personal はプロジェクトをオーバーライドします。プラグインスキルは `plugin-name:skill-name` 名前空間を使用するため、他のレベルと競合することはできません。`.claude/commands/` にファイルがある場合、それらは同じように機能しますが、スキルとコマンドが同じ名前を共有する場合、スキルが優先されます。120スキルがレベル全体で同じ名前を共有する場合、enterprise は personal をオーバーライドし、personal はプロジェクトをオーバーライドします。プラグインスキルは `plugin-name:skill-name` 名前空間を使用するため、他のレベルと競合することはできません。`.claude/commands/` にファイルがある場合、それらは同じように機能しますが、スキルとコマンドが同じ名前を共有する場合、スキルが優先されます。

121 121 

122スキルは作業ディレクトリの下のネストされた `.claude/skills/` ディレクトリからも読み込まれます。Claude がサブディレクトリ内のファイルを読み取りまたは編集する場合、そのサブディレクトリの `.claude/skills/` からのスキルが利用可能になります。これにより、モノレポパッケージがセッションがリポジトリルートで開始された場合でも、そのパッケージで作業するときに適用される独自のスキルを提供できます。

123 

124ネストされたスキルが別のスキルと同じ名前を共有する場合、両方が利用可能なままです。たとえば、プロジェクトルートに `deploy` スキルがあり、`apps/web/.claude/skills/` に別のスキルがある場合:

125 

126* ネストされたスキルはディレクトリ修飾名 `apps/web:deploy` の下に表示されます。

127* その説明は、どのディレクトリに適用されるかを示します。

128* Claude は、作業しているファイルに一致するバリアントを選択します。

129 

130`/deploy` を入力するとプロジェクトルートスキルが実行されます。修飾名 `/apps/web:deploy` を入力してネストされたバリアントを明示的に実行します。

131 

122<Note>132<Note>

123 スキルフォルダに `.claude-plugin/plugin.json` を追加すると、`<name>@skills-dir` という名前の[プラグイン](/ja/plugins-reference#skills-directory-plugins)として読み込まれるため、エージェント、hooks、および MCP サーバーをバンドルできます。プロジェクトの `.claude/skills/` では、これはまずワークスペーストラストダイアログを受け入れる必要があります。133 スキルフォルダに `.claude-plugin/plugin.json` を追加すると、`<name>@skills-dir` という名前の[プラグイン](/ja/plugins-reference#skills-directory-plugins)として読み込まれるため、エージェント、hooks、および MCP サーバーをバンドルできます。プロジェクトの `.claude/skills/` では、これはまずワークスペーストラストダイアログを受け入れる必要があります。

124</Note>134</Note>


262以下の表は、各レイアウトのコマンド名がどこから取得されるかを示しています:272以下の表は、各レイアウトのコマンド名がどこから取得されるかを示しています:

263 273 

264| スキルの場所 | コマンド名のソース | 例 |274| スキルの場所 | コマンド名のソース | 例 |

265| :----------------------------------------------------- | :------------------------------------ | :------------------------------------------------------------------------------------------------------------------------ |275| :--------------------------------------------------------------------- | :-------------------------------------- | :------------------------------------------------------------------------------------------------------------------------ |

266| `~/.claude/skills/` または `.claude/skills/` の下のスキルディレクトリ | ディレクトリ名 | `.claude/skills/deploy-staging/SKILL.md` → `/deploy-staging` |276| `~/.claude/skills/` または `.claude/skills/` の下のスキルディレクトリ | ディレクトリ名 | `.claude/skills/deploy-staging/SKILL.md` → `/deploy-staging` |

277| [ネストされた](#where-skills-live) `.claude/skills/` ディレクトリ(別のスキルと名前が競合する場合) | 作業ディレクトリからの相対的なサブディレクトリパス、その後スキルディレクトリ名 | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |

267| `.claude/commands/` の下のファイル | 拡張子なしのファイル名 | `.claude/commands/deploy.md` → `/deploy` |278| `.claude/commands/` の下のファイル | 拡張子なしのファイル名 | `.claude/commands/deploy.md` → `/deploy` |

268| プラグイン `skills/` サブディレクトリ | ディレクトリ名、プラグインでネームスペース化 | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review` |279| プラグイン `skills/` サブディレクトリ | ディレクトリ名、プラグインでネームスペース化 | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review` |

269| プラグインルート `SKILL.md` | フロントマター `name`、フォールバックとしてプラグインディレクトリ名 | `my-plugin/SKILL.md` と `name: review` → `/my-plugin:review`。[パス動作ルール](/ja/plugins-reference#path-behavior-rules)を参照してください |280| プラグインルート `SKILL.md` | フロントマター `name`、フォールバックとしてプラグインディレクトリ名 | `my-plugin/SKILL.md` と `name: review` → `/my-plugin:review`。[パス動作ルール](/ja/plugins-reference#path-behavior-rules)を参照してください |


288 299 

289インデックス付き引数はシェルスタイルのクォートを使用するため、複数単語の値をシングル引数として渡すためにクォートで囲みます。たとえば、`/my-skill "hello world" second` は `$0` を `hello world` に、`$1` を `second` に展開します。`$ARGUMENTS` プレースホルダーは常に、入力されたとおりの完全な引数文字列に展開されます。300インデックス付き引数はシェルスタイルのクォートを使用するため、複数単語の値をシングル引数として渡すためにクォートで囲みます。たとえば、`/my-skill "hello world" second` は `$0` を `hello world` に、`$1` を `second` に展開します。`$ARGUMENTS` プレースホルダーは常に、入力されたとおりの完全な引数文字列に展開されます。

290 301 

302リテラル `$` を数字、`ARGUMENTS`、または宣言された引数名の前に含めるには(例:`$1.00` のような散文)、バックスラッシュでエスケープします:`\$1.00`。他の `$` の前のバックスラッシュは変更されません。トークンの直前の単一バックスラッシュのみがそれをエスケープします。`\\$1` のような二重バックスラッシュは両方のバックスラッシュをそのまま残し、`$1` は引数値に展開されます。

303 

291**置換を使用した例:**304**置換を使用した例:**

292 305 

293```yaml theme={null}306```yaml theme={null}


557 570 

558`agent` フィールドは使用するサブエージェント設定を指定します。オプションには、組み込みエージェント(`Explore`、`Plan`、`general-purpose`)または `.claude/agents/` からのカスタムサブエージェントが含まれます。省略した場合、`general-purpose` を使用します。571`agent` フィールドは使用するサブエージェント設定を指定します。オプションには、組み込みエージェント(`Explore`、`Plan`、`general-purpose`)または `.claude/agents/` からのカスタムサブエージェントが含まれます。省略した場合、`general-purpose` を使用します。

559 572 

560<h3 id="restrict-claude-s-skill-access">573<h3 id="restrict-claudes-skill-access">

561 Claude のスキルアクセスを制限する574 Claude のスキルアクセスを制限する

562</h3>575</h3>

563 576 


850 スキルの説明が短縮される863 スキルの説明が短縮される

851</h3>864</h3>

852 865 

853スキルの説明がコンテキストに読み込まれるため、Claude は利用可能なものを知っています。すべてのスキル名は常に含まれていますが、多くのスキルがある場合、説明は文字予算に合わせて短縮される可能性があり、Claude が一致するために必要なキーワードを削除できます。予算はモデルのコンテキストウィンドウの 1% でスケーリングされます。オーバーフローすると、最も呼び出しが少ないスキルの説明が最初に削除され、実際に使用するスキルは完全なテキストを保持します。`/doctor` を実行して、予算がオーバーフローしているかどうか、どのスキルが影響を受けているかを確認します。866スキルの説明がコンテキストに読み込まれるため、Claude は利用可能なものを知っています。すべてのスキル名は常に含まれていますが、多くのスキルがある場合、説明は文字予算に合わせて短縮される可能性があり、Claude が一致するために必要なキーワードを削除できます。予算はモデルのコンテキストウィンドウの 1% でスケーリングされます。オーバーフローすると、最も呼び出しが少ないスキルの説明が最初に削除され、実際に使用するスキルは完全なテキストを保持します。`/doctor` を実行して、スキルの説明がどの程度短縮または削除されているか、どのスキルが影響を受けているかを確認します。

854 867 

855予算を上げるには、[`skillListingBudgetFraction`](/ja/settings#available-settings) 設定(例:`0.02` = 2%)または `SLASH_COMMAND_TOOL_CHAR_BUDGET` 環境変数を固定文字数に設定します。他のスキルの予算を解放するには、[`skillOverrides`](#override-skill-visibility-from-settings) で低優先度のエントリを `"name-only"` に設定して、説明なしでリストアップします。ソースで `description` と `when_to_use` テキストをトリミングすることもできます。各エントリの組み合わせテキストは予算に関係なく 1,536 文字でキャップされているため、主要なユースケースを前置きしてください。キャップは [`maxSkillDescriptionChars`](/ja/settings#available-settings) で設定可能です。868予算を上げるには、[`skillListingBudgetFraction`](/ja/settings#available-settings) 設定(例:`0.02` = 2%)または `SLASH_COMMAND_TOOL_CHAR_BUDGET` 環境変数を固定文字数に設定します。他のスキルの予算を解放するには、[`skillOverrides`](#override-skill-visibility-from-settings) で低優先度のエントリを `"name-only"` に設定して、説明なしでリストアップします。ソースで `description` と `when_to_use` テキストをトリミングすることもできます。各エントリの組み合わせテキストは予算に関係なく 1,536 文字でキャップされているため、主要なユースケースを前置きしてください。キャップは [`maxSkillDescriptionChars`](/ja/settings#available-settings) で設定可能です。

856 869 

slack.md +5 −5

Details

175 175 

176Claude はインストール後、自動的にどのチャネルにも追加されません。ユーザーは Claude を使用したいチャネルに明示的に Claude を招待する必要があります:176Claude はインストール後、自動的にどのチャネルにも追加されません。ユーザーは Claude を使用したいチャネルに明示的に Claude を招待する必要があります:

177 177 

178* **招待が必要**: 任意のチャネルで `/invite @Claude` と入力して Claude をそのチャネルに追加します178* **招待が必要**任意のチャネルで `/invite @Claude` と入力して Claude をそのチャネルに追加します

179* **チャネルメンバーシップがアクセスを制御**: Claude は追加されたチャネルの @mentions にのみ応答できます179* **チャネルメンバーシップがアクセスを制御**Claude は追加されたチャネルの @mentions にのみ応答できます

180* **チャネルを通じたアクセスゲーティング**: 管理者は Claude が招待されるチャネルと、それらのチャネルへのアクセス権を持つユーザーを管理することで、Claude Code の使用を特定のチャネルに制限できます180* **チャネルを通じたアクセスゲーティング**管理者は Claude が招待されるチャネルと、それらのチャネルへのアクセス権を持つユーザーを管理することで、Claude Code の使用を特定のチャネルに制限できます

181* **プライベートチャネルのサポート**: Claude は公開チャネルと非公開チャネルの両方で機能し、チームに可視性を制御する柔軟性を提供します181* **プライベートチャネルのサポート**Claude は公開チャネルと非公開チャネルの両方で機能し、チームに可視性を制御する柔軟性を提供します

182 182 

183このチャネルベースのモデルにより、チームはワークスペースレベルの権限を超えた追加のアクセス制御層を提供して、Claude Code の使用を特定のチャネルに制限できます。183このチャネルベースのモデルにより、チームはワークスペースレベルの権限を超えた追加のアクセス制御層を提供して、Claude Code の使用を特定のチャネルに制限できます。

184 184 

185<h2 id="what-s-accessible-where">185<h2 id="whats-accessible-where">

186 どこでアクセスできるか186 どこでアクセスできるか

187</h2>187</h2>

188 188 

statusline.md +64 −22

Details

15* 複数のセッション間で作業し、それらを区別する必要がある15* 複数のセッション間で作業し、それらを区別する必要がある

16* git ブランチとステータスを常に表示したい16* git ブランチとステータスを常に表示したい

17 17 

18Claude Code は [フッターリンクバッジ](/ja/settings#footer-link-badges) もレンダリングできます。これは、設定された正規表現が会話内のテキストと一致したときにフッターに表示されるクリック可能なチップです。これらはステータスラインとは独立しており、スクリプトと相互作用しません。[`footerLinksRegexes`](/ja/settings#footer-link-badges) 設定を使用して設定してください。

19 

18以下は、最初の行に git 情報を表示し、2 番目の行にカラーコード化されたコンテキストバーを表示する [複数行ステータスライン](#display-multiple-lines) の例です。20以下は、最初の行に git 情報を表示し、2 番目の行にカラーコード化されたコンテキストバーを表示する [複数行ステータスライン](#display-multiple-lines) の例です。

19 21 

20<Frame>22<Frame>


23 25 

24このページでは、[基本的なステータスラインの設定](#set-up-a-status-line) について説明し、Claude Code からスクリプトへの [データフロー](#how-status-lines-work) について説明し、[表示できるすべてのフィールド](#available-data) をリストアップし、git ステータス、コスト追跡、プログレスバーなどの一般的なパターンの [すぐに使える例](#examples) を提供します。26このページでは、[基本的なステータスラインの設定](#set-up-a-status-line) について説明し、Claude Code からスクリプトへの [データフロー](#how-status-lines-work) について説明し、[表示できるすべてのフィールド](#available-data) をリストアップし、git ステータス、コスト追跡、プログレスバーなどの一般的なパターンの [すぐに使える例](#examples) を提供します。

25 27 

26## ステータスラインを設定する28<h2 id="set-up-a-status-line">

29 ステータスラインを設定する

30</h2>

27 31 

28[`/statusline` コマンド](#use-the-statusline-command) を使用して Claude Code にスクリプトを生成させるか、[手動でスクリプトを作成](#manually-configure-a-status-line) して設定に追加します。32[`/statusline` コマンド](#use-the-%2Fstatusline-command) を使用して Claude Code にスクリプトを生成させるか、[手動でスクリプトを作成](#manually-configure-a-status-line) して設定に追加します。

29 33 

30### /statusline コマンドを使用する34<h3 id="use-the-/statusline-command">

35 /statusline コマンドを使用する

36</h3>

31 37 

32`/statusline` コマンドは、表示したい内容を説明する自然言語の指示を受け入れます。Claude Code は `~/.claude/` にスクリプトファイルを生成し、設定を自動的に更新します:38`/statusline` コマンドは、表示したい内容を説明する自然言語の指示を受け入れます。Claude Code は `~/.claude/` にスクリプトファイルを生成し、設定を自動的に更新します:

33 39 


35/statusline show model name and context percentage with a progress bar41/statusline show model name and context percentage with a progress bar

36```42```

37 43 

38### ステータスラインを手動で設定する44<h3 id="manually-configure-a-status-line">

45 ステータスラインを手動で設定する

46</h3>

39 47 

40ユーザー設定(`~/.claude/settings.json`、`~` はホームディレクトリ)または [プロジェクト設定](/ja/settings#settings-files) に `statusLine` フィールドを追加します。`type` を `"command"` に設定し、`command` をスクリプトパスまたはインラインシェルコマンドに指定します。スクリプト作成の完全なチュートリアルについては、[ステータスラインをステップバイステップで構築する](#build-a-status-line-step-by-step) を参照してください。48ユーザー設定(`~/.claude/settings.json`、`~` はホームディレクトリ)または [プロジェクト設定](/ja/settings#settings-files) に `statusLine` フィールドを追加します。`type` を `"command"` に設定し、`command` をスクリプトパスまたはインラインシェルコマンドに指定します。スクリプト作成の完全なチュートリアルについては、[ステータスラインをステップバイステップで構築する](#build-a-status-line-step-by-step) を参照してください。

41 49 


66 74 

67オプションの `hideVimModeIndicator` フィールドは、プロンプトの下にある組み込みの `-- INSERT --` テキストを非表示にします。スクリプトが [`vim.mode`](#available-data) 自体をレンダリングする場合は、これを `true` に設定して、モードが 2 回表示されないようにします。75オプションの `hideVimModeIndicator` フィールドは、プロンプトの下にある組み込みの `-- INSERT --` テキストを非表示にします。スクリプトが [`vim.mode`](#available-data) 自体をレンダリングする場合は、これを `true` に設定して、モードが 2 回表示されないようにします。

68 76 

69### ステータスラインを無効にする77<h3 id="disable-the-status-line">

78 ステータスラインを無効にする

79</h3>

70 80 

71`/statusline` を実行し、ステータスラインを削除またはクリアするよう指示します(例:`/statusline delete`、`/statusline clear`、`/statusline remove it`)。settings.json から `statusLine` フィールドを手動で削除することもできます。81`/statusline` を実行し、ステータスラインを削除またはクリアするよう指示します(例:`/statusline delete`、`/statusline clear`、`/statusline remove it`)。settings.json から `statusLine` フィールドを手動で削除することもできます。

72 82 

73## ステータスラインをステップバイステップで構築する83<h2 id="build-a-status-line-step-by-step">

84 ステータスラインをステップバイステップで構築する

85</h2>

74 86 

75このチュートリアルでは、現在のモデル、作業ディレクトリ、コンテキストウィンドウ使用状況の割合を表示するステータスラインを手動で作成することで、内部で何が起こっているかを示します。87このチュートリアルでは、現在のモデル、作業ディレクトリ、コンテキストウィンドウ使用状況の割合を表示するステータスラインを手動で作成することで、内部で何が起こっているかを示します。

76 88 

77<Note>[`/statusline`](#use-the-statusline-command) を実行して、表示したい内容を説明すると、これらすべてが自動的に設定されます。</Note>89<Note>[`/statusline`](#use-the-%2Fstatusline-command) を実行して、表示したい内容を説明すると、これらすべてが自動的に設定されます。</Note>

78 90 

79これらの例では Bash スクリプトを使用しており、macOS と Linux で動作します。Windows では、[Windows 設定](#windows-configuration) で PowerShell と Git Bash の例を参照してください。91これらの例では Bash スクリプトを使用しており、macOS と Linux で動作します。Windows では、[Windows 設定](#windows-configuration) で PowerShell と Git Bash の例を参照してください。

80 92 


128 </Step>140 </Step>

129</Steps>141</Steps>

130 142 

131## ステータスラインの仕組み143<h2 id="how-status-lines-work">

144 ステータスラインの仕組み

145</h2>

132 146 

133Claude Code はスクリプトを実行し、stdin 経由で [JSON セッションデータ](#available-data) をパイプします。スクリプトは JSON を読み取り、必要なものを抽出し、stdout にテキストを出力します。Claude Code はスクリプトが出力したものを表示します。147Claude Code はスクリプトを実行し、stdin 経由で [JSON セッションデータ](#available-data) をパイプします。スクリプトは JSON を読み取り、必要なものを抽出し、stdout にテキストを出力します。Claude Code はスクリプトが出力したものを表示します。

134 148 


150 164 

151<Note>ステータスラインはローカルで実行され、API トークンを消費しません。オートコンプリート提案、ヘルプメニュー、パーミッションプロンプトなど、特定の UI 相互作用中は一時的に非表示になります。</Note>165<Note>ステータスラインはローカルで実行され、API トークンを消費しません。オートコンプリート提案、ヘルプメニュー、パーミッションプロンプトなど、特定の UI 相互作用中は一時的に非表示になります。</Note>

152 166 

153## 利用可能なデータ167<h2 id="available-data">

168 利用可能なデータ

169</h2>

154 170 

155Claude Code は以下の JSON フィールドを stdin 経由でスクリプトに送信します:171Claude Code は以下の JSON フィールドを stdin 経由でスクリプトに送信します:

156 172 


297 スクリプトで条件付きアクセスと null 値のフォールバックデフォルトを使用して、不在のフィールドを処理します。313 スクリプトで条件付きアクセスと null 値のフォールバックデフォルトを使用して、不在のフィールドを処理します。

298</Accordion>314</Accordion>

299 315 

300### コンテキストウィンドウフィールド316<h3 id="context-window-fields">

317 コンテキストウィンドウフィールド

318</h3>

301 319 

302`context_window` オブジェクトは、最新の API レスポンスからのライブコンテキストウィンドウを説明します。v2.1.132 以降、`total_input_tokens` と `total_output_tokens` は現在のコンテキスト使用状況を反映し、累積セッション合計ではありません。320`context_window` オブジェクトは、最新の API レスポンスからのライブコンテキストウィンドウを説明します。v2.1.132 以降、`total_input_tokens` と `total_output_tokens` は現在のコンテキスト使用状況を反映し、累積セッション合計ではありません。

303 321 


319 337 

320`current_usage` オブジェクトはセッションの最初の API 呼び出しの前は `null` です。また `/compact` の直後は `null` であり、次の API 呼び出しが再度入力されるまで `null` のままです。338`current_usage` オブジェクトはセッションの最初の API 呼び出しの前は `null` です。また `/compact` の直後は `null` であり、次の API 呼び出しが再度入力されるまで `null` のままです。

321 339 

322## 340<h2 id="examples">

341

342</h2>

323 343 

324これらの例は一般的なステータスラインパターンを示しています。任意の例を使用するには:344これらの例は一般的なステータスラインパターンを示しています。任意の例を使用するには:

325 345 


329 349 

330Bash の例は [`jq`](https://jqlang.github.io/jq/) を使用して JSON を解析します。Python と Node.js には組み込みの JSON 解析があります。350Bash の例は [`jq`](https://jqlang.github.io/jq/) を使用して JSON を解析します。Python と Node.js には組み込みの JSON 解析があります。

331 351 

332### コンテキストウィンドウの使用状況352<h3 id="context-window-usage">

353 コンテキストウィンドウの使用状況

354</h3>

333 355 

334現在のモデルとコンテキストウィンドウの使用状況を視覚的なプログレスバーで表示します。各スクリプトは stdin から JSON を読み取り、`used_percentage` フィールドを抽出し、塗りつぶされたブロック(▓)が使用状況を表す 10 文字のバーを構築します:356現在のモデルとコンテキストウィンドウの使用状況を視覚的なプログレスバーで表示します。各スクリプトは stdin から JSON を読み取り、`used_percentage` フィールドを抽出し、塗りつぶされたブロック(▓)が使用状況を表す 10 文字のバーを構築します:

335 357 


396 ```418 ```

397</CodeGroup>419</CodeGroup>

398 420 

399### git ステータスと色421<h3 id="git-status-with-colors">

422 git ステータスと色

423</h3>

400 424 

401ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを使用して git ブランチを表示します。このスクリプトはターミナルの色に [ANSI エスケープコード](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) を使用します:`\033[32m` は緑、`\033[33m` は黄、`\033[0m` はデフォルトにリセットします。425ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを使用して git ブランチを表示します。このスクリプトはターミナルの色に [ANSI エスケープコード](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) を使用します:`\033[32m` は緑、`\033[33m` は黄、`\033[0m` はデフォルトにリセットします。

402 426 


490 ```514 ```

491</CodeGroup>515</CodeGroup>

492 516 

493### コストと期間の追跡517<h3 id="cost-and-duration-tracking">

518 コストと期間の追跡

519</h3>

494 520 

495セッションの API コストと経過時間を追跡します。`cost.total_cost_usd` フィールドは現在のセッションのすべての API 呼び出しの推定コストを累積します。`cost.total_duration_ms` フィールドはセッション開始からの総経過時間を測定し、`cost.total_api_duration_ms` は API レスポンスを待つのに費やされた時間のみを追跡します。521セッションの API コストと経過時間を追跡します。`cost.total_cost_usd` フィールドは現在のセッションのすべての API 呼び出しの推定コストを累積します。`cost.total_duration_ms` フィールドはセッション開始からの総経過時間を測定し、`cost.total_api_duration_ms` は API レスポンスを待つのに費やされた時間のみを追跡します。

496 522 


551 ```577 ```

552</CodeGroup>578</CodeGroup>

553 579 

554### 複数行を表示する580<h3 id="display-multiple-lines">

581 複数行を表示する

582</h3>

555 583 

556スクリプトは複数の行を出力して、より豊かなディスプレイを作成できます。各 `echo` ステートメントはステータス領域に別の行を生成します。584スクリプトは複数の行を出力して、より豊かなディスプレイを作成できます。各 `echo` ステートメントはステータス領域に別の行を生成します。

557 585 


658 ```686 ```

659</CodeGroup>687</CodeGroup>

660 688 

661### クリック可能なリンク689<h3 id="clickable-links">

690 クリック可能なリンク

691</h3>

662 692 

663この例は GitHub リポジトリへのクリック可能なリンクを作成します。git リモート URL を読み取り、SSH 形式を `sed` で HTTPS に変換し、リポジトリ名を OSC 8 エスケープコードでラップします。Cmd(macOS)または Ctrl(Windows/Linux)を押しながらクリックして、ブラウザでリンクを開きます。693この例は GitHub リポジトリへのクリック可能なリンクを作成します。git リモート URL を読み取り、SSH 形式を `sed` で HTTPS に変換し、リポジトリ名を OSC 8 エスケープコードでラップします。Cmd(macOS)または Ctrl(Windows/Linux)を押しながらクリックして、ブラウザでリンクを開きます。

664 694 


738 ```768 ```

739</CodeGroup>769</CodeGroup>

740 770 

741### レート制限の使用状況771<h3 id="rate-limit-usage">

772 レート制限の使用状況

773</h3>

742 774 

743Claude.ai サブスクリプションのレート制限使用状況をステータスラインに表示します。`rate_limits` オブジェクトには `five_hour`(5 時間のローリングウィンドウ)と `seven_day`(週間)ウィンドウが含まれます。各ウィンドウは `used_percentage`(0~100)とウィンドウがリセットされる Unix エポック秒の `resets_at` を提供します。775Claude.ai サブスクリプションのレート制限使用状況をステータスラインに表示します。`rate_limits` オブジェクトには `five_hour`(5 時間のローリングウィンドウ)と `seven_day`(週間)ウィンドウが含まれます。各ウィンドウは `used_percentage`(0~100)とウィンドウがリセットされる Unix エポック秒の `resets_at` を提供します。

744 776 


804 ```836 ```

805</CodeGroup>837</CodeGroup>

806 838 

807### 高コストな操作をキャッシュする839<h3 id="cache-expensive-operations">

840 高コストな操作をキャッシュする

841</h3>

808 842 

809ステータスラインスクリプトはアクティブなセッション中に頻繁に実行されます。`git status` や `git diff` などのコマンドは、特に大規模なリポジトリでは遅い場合があります。この例は git 情報を一時ファイルにキャッシュし、5 秒ごとにのみ更新します。843ステータスラインスクリプトはアクティブなセッション中に頻繁に実行されます。`git status` や `git diff` などのコマンドは、特に大規模なリポジトリでは遅い場合があります。この例は git 情報を一時ファイルにキャッシュし、5 秒ごとにのみ更新します。

810 844 


935 ```969 ```

936</CodeGroup>970</CodeGroup>

937 971 

938### Windows 設定972<h3 id="windows-configuration">

973 Windows 設定

974</h3>

939 975 

940Windows では、Claude Code はステータスラインコマンドを Git Bash 経由で実行します。Git Bash がインストールされている場合、または Git Bash がない場合は PowerShell を通じて実行します。PowerShell スクリプトをステータスラインとして実行するには、`powershell` 経由で呼び出します。これはどちらのシェルからでも機能します:976Windows では、Claude Code はステータスラインコマンドを Git Bash 経由で実行します。Git Bash がインストールされている場合、または Git Bash がない場合は PowerShell を通じて実行します。PowerShell スクリプトをステータスラインとして実行するには、`powershell` 経由で呼び出します。これはどちらのシェルからでも機能します:

941 977 


986 ```1022 ```

987</CodeGroup>1023</CodeGroup>

988 1024 

989## サブエージェントステータスライン1025<h2 id="subagent-status-lines">

1026 サブエージェントステータスライン

1027</h2>

990 1028 

991`subagentStatusLine` 設定は、エージェントパネルに表示される各 [サブエージェント](/ja/sub-agents) のカスタム行本体をレンダリングします。デフォルトの `name · description · token count` 行を独自のフォーマットに置き換えるために使用します。1029`subagentStatusLine` 設定は、エージェントパネルに表示される各 [サブエージェント](/ja/sub-agents) のカスタム行本体をレンダリングします。デフォルトの `name · description · token count` 行を独自のフォーマットに置き換えるために使用します。

992 1030 


1005 1043 

1006`statusLine` に適用される同じトラストと `disableAllHooks` ゲートが `subagentStatusLine` に適用されます。プラグインは、[`settings.json`](/ja/plugins-reference#standard-plugin-layout) でデフォルトの `subagentStatusLine` を配布できます。1044`statusLine` に適用される同じトラストと `disableAllHooks` ゲートが `subagentStatusLine` に適用されます。プラグインは、[`settings.json`](/ja/plugins-reference#standard-plugin-layout) でデフォルトの `subagentStatusLine` を配布できます。

1007 1045 

1008## ヒント1046<h2 id="tips">

1047 ヒント

1048</h2>

1009 1049 

1010* **モック入力でテストする**:`echo '{"model":{"display_name":"Opus"},"workspace":{"current_dir":"/home/user/project"},"context_window":{"used_percentage":25},"session_id":"test-session-abc"}' | ./statusline.sh`1050* **モック入力でテストする**:`echo '{"model":{"display_name":"Opus"},"workspace":{"current_dir":"/home/user/project"},"context_window":{"used_percentage":25},"session_id":"test-session-abc"}' | ./statusline.sh`

1011* **出力を短く保つ**:ステータスバーの幅は限られているため、長い出力は切り詰められたり、不適切にラップされたりする可能性があります1051* **出力を短く保つ**:ステータスバーの幅は限られているため、長い出力は切り詰められたり、不適切にラップされたりする可能性があります


1013 1053 

1014[ccstatusline](https://github.com/sirmalloc/ccstatusline) や [starship-claude](https://github.com/martinemde/starship-claude) などのコミュニティプロジェクトは、テーマと追加機能を備えた事前構築設定を提供します。1054[ccstatusline](https://github.com/sirmalloc/ccstatusline) や [starship-claude](https://github.com/martinemde/starship-claude) などのコミュニティプロジェクトは、テーマと追加機能を備えた事前構築設定を提供します。

1015 1055 

1016## トラブルシューティング1056<h2 id="troubleshooting">

1057 トラブルシューティング

1058</h2>

1017 1059 

1018**ステータスラインが表示されない**1060**ステータスラインが表示されない**

1019 1061 

sub-agents.md +54 −24

Details

61 * **ツール**:読み取り専用ツール(Write および Edit ツールへのアクセスは拒否)61 * **ツール**:読み取り専用ツール(Write および Edit ツールへのアクセスは拒否)

62 * **目的**:計画のためのコードベース研究62 * **目的**:計画のためのコードベース研究

63 63 

64 プランモード中に Claude がコードベースを理解する必要がある場合、研究を Plan サブエージェントに委譲します。これにより、無限ネストを防ぎます(サブエージェントは他のサブエージェントを生成できません)。同時に必要なコンテキストを収集します64 プランモード中に Claude がコードベースを理解する必要がある場合、研究を Plan サブエージェントに委譲して探索出力がメイン会話が読み取り専用のままである間に別のコンテキストウィンドウに留まるようにします

65 </Tab>65 </Tab>

66 66 

67 <Tab title="General-purpose">67 <Tab title="General-purpose">


84 </Tab>84 </Tab>

85</Tabs>85</Tabs>

86 86 

87組み込みサブエージェントは常にインタラクティブセッションに登録されます。特定の組み込みタイプをブロックするには、[特定のサブエージェントを無効にする](#disable-specific-subagents)に示されているように `permissions.deny` に追加します。Claude がサブエージェントに委譲することを防ぐには、[`permissions.deny`](/ja/permissions#tool-specific-permission-rules)で `Agent` ツール自体を拒否します。[非インタラクティブモード](/ja/headless)および [Agent SDK](/ja/agent-sdk/overview)では、[`CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1`](/ja/env-vars)を設定して、すべての組み込みタイプを削除し、独自のものだけを提供します。

88 

87これらの組み込みサブエージェント以外に、カスタムプロンプト、ツール制限、権限モード、hooks、および skills を使用して独自のサブエージェントを作成できます。以下のセクションでは、開始方法とサブエージェントのカスタマイズ方法を示します。89これらの組み込みサブエージェント以外に、カスタムプロンプト、ツール制限、権限モード、hooks、および skills を使用して独自のサブエージェントを作成できます。以下のセクションでは、開始方法とサブエージェントのカスタマイズ方法を示します。

88 90 

89<h2 id="quickstart-create-your-first-subagent">91<h2 id="quickstart-create-your-first-subagent">


158 /agents コマンドを使用する160 /agents コマンドを使用する

159</h3>161</h3>

160 162 

161`/agents` コマンドは、サブエージェントを管理するためのタブ付きインターフェースを開きます。**Running** タブはライブサブエージェントを表示し、それらを開くまたは停止できます。**Library** タブでは以下を実行できます:163`/agents` コマンドは、サブエージェントを管理するためのタブ付きインターフェースを開きます。**Running** タブはライブおよび最近終了したサブエージェントをリストし、それらを開くまたは停止できます。**Library** タブでは以下を実行できます:

162 164 

163* すべての利用可能なサブエージェント(組み込み、ユーザー、プロジェクト、プラグイン)を表示する165* すべての利用可能なサブエージェント(組み込み、ユーザー、プロジェクト、プラグイン)を表示する

164* ガイド付きセットアップまたは Claude 生成を使用して新しいサブエージェントを作成する166* ガイド付きセットアップまたは Claude 生成を使用して新しいサブエージェントを作成する


184 186 

185**プロジェクトサブエージェント** (`.claude/agents/`)は、コードベース固有のサブエージェントに最適です。バージョン管理にチェックインして、チームが協力して使用および改善できるようにします。187**プロジェクトサブエージェント** (`.claude/agents/`)は、コードベース固有のサブエージェントに最適です。バージョン管理にチェックインして、チームが協力して使用および改善できるようにします。

186 188 

187プロジェクトサブエージェントは、現在の作業ディレクトリから上へ向かって検出されます。`--add-dir` で追加されたディレクトリは[ファイルアクセスのみを付与](/ja/permissions#additional-directories-grant-file-access-not-configuration)し、サブエージェントはスキャンされません。プロジェクト全体でサブエージェントを共有するには、`~/.claude/agents/` または[プラグイン](/ja/plugins)を使用します189プロジェクトサブエージェントは、現在の作業ディレクトリから上へ向かって検出されます。そのためそこからリポジトリルートまでのすべての `.claude/agents/` がスキャンされます。{/* min-version: 2.1.178 */}v2.1.178 以降、これらのネストされたディレクトリの複数が同じ `name` を定義する場合、Claude Code は作業ディレクトリに最も近い定義を使用します

190 

191`--add-dir` で追加されたディレクトリもスキャンされます:追加されたディレクトリ内の `.claude/agents/` フォルダはプロジェクトサブエージェントと一緒に読み込まれます。[追加ディレクトリ](/ja/permissions#additional-directories-grant-file-access-not-configuration)を参照して、`--add-dir` から読み込まれる他の設定タイプを確認してください。`--add-dir` なしでプロジェクト全体でサブエージェントを共有するには、`~/.claude/agents/` または[プラグイン](/ja/plugins)を使用します。

188 192 

189**ユーザーサブエージェント** (`~/.claude/agents/`)は、すべてのプロジェクトで利用可能な個人用サブエージェントです。193**ユーザーサブエージェント** (`~/.claude/agents/`)は、すべてのプロジェクトで利用可能な個人用サブエージェントです。

190 194 


282| `description` | はい | Claude がこのサブエージェントに委譲する場合 |286| `description` | はい | Claude がこのサブエージェントに委譲する場合 |

283| `tools` | いいえ | サブエージェントが使用できる[ツール](#available-tools)。省略した場合はすべてのツールを継承します。スキルをコンテキストにプリロードするには、`tools` にリストするのではなく `skills` フィールドを使用します |287| `tools` | いいえ | サブエージェントが使用できる[ツール](#available-tools)。省略した場合はすべてのツールを継承します。スキルをコンテキストにプリロードするには、`tools` にリストするのではなく `skills` フィールドを使用します |

284| `disallowedTools` | いいえ | 拒否するツール。継承または指定されたリストから削除 |288| `disallowedTools` | いいえ | 拒否するツール。継承または指定されたリストから削除 |

285| `model` | いいえ | 使用する[モデル](#choose-a-model):`sonnet`、`opus`、`haiku`、完全なモデル ID(例:`claude-opus-4-8`)、または `inherit`。デフォルトは `inherit` |289| `model` | いいえ | 使用する[モデル](#choose-a-model):`sonnet`、`opus`、`haiku`、`fable`、完全なモデル ID(例:`claude-opus-4-8`)、または `inherit`。デフォルトは `inherit` |

286| `permissionMode` | いいえ | [権限モード](#permission-modes):`default`、`acceptEdits`、`auto`、`dontAsk`、`bypassPermissions`、または `plan`。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |290| `permissionMode` | いいえ | [権限モード](#permission-modes):`default`、`acceptEdits`、`auto`、`dontAsk`、`bypassPermissions`、または `plan`。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

287| `maxTurns` | いいえ | サブエージェントが停止する前の最大 agentic ターン数 |291| `maxTurns` | いいえ | サブエージェントが停止する前の最大 agentic ターン数 |

288| `skills` | いいえ | スタートアップ時にサブエージェントのコンテキストに[プリロード](/ja/skills)する[スキル](/ja/skills)。完全なスキルコンテンツが注入されます。説明だけでなく、スキル全体が注入されます。サブエージェントは、Skill ツールを通じて、リストされていないプロジェクト、ユーザー、およびプラグインスキルを引き続き呼び出すことができます |292| `skills` | いいえ | スタートアップ時にサブエージェントのコンテキストに[プリロード](/ja/skills)する[スキル](/ja/skills)。完全なスキルコンテンツが注入されます。説明だけでなく、スキル全体が注入されます。サブエージェントは、Skill ツールを通じて、リストされていないプロジェクト、ユーザー、およびプラグインスキルを引き続き呼び出すことができます |


301 305 

302`model` フィールドは、サブエージェントが使用する[AI モデル](/ja/model-config)を制御します:306`model` フィールドは、サブエージェントが使用する[AI モデル](/ja/model-config)を制御します:

303 307 

304* **モデルエイリアス**:利用可能なエイリアスの 1 つを使用します:`sonnet`、`opus`、または `haiku`308* **モデルエイリアス**:利用可能なエイリアスの 1 つを使用します:`sonnet`、`opus`、`haiku`、または `fable`

305* **完全なモデル ID**:`claude-opus-4-8` または `claude-sonnet-4-6` などの完全なモデル ID を使用します。`--model` フラグと同じ値を受け入れます309* **完全なモデル ID**:`claude-opus-4-8` または `claude-sonnet-4-6` などの完全なモデル ID を使用します。`--model` フラグと同じ値を受け入れます

306* **inherit**:メイン会話と同じモデルを使用します310* **inherit**:メイン会話と同じモデルを使用します

307* **省略**:指定されていない場合、デフォルトは `inherit`(メイン会話と同じモデルを使用)です311* **省略**:指定されていない場合、デフォルトは `inherit`(メイン会話と同じモデルを使用)です


325 329 

326サブエージェントは、デフォルトでメイン会話で利用可能な[内部ツール](/ja/tools-reference)と MCP ツールを継承します。以下のツールはメイン会話の UI またはセッション状態に依存し、`tools` フィールドにリストされている場合でも、サブエージェントでは利用できません:330サブエージェントは、デフォルトでメイン会話で利用可能な[内部ツール](/ja/tools-reference)と MCP ツールを継承します。以下のツールはメイン会話の UI またはセッション状態に依存し、`tools` フィールドにリストされている場合でも、サブエージェントでは利用できません:

327 331 

328* `Agent`

329* `AskUserQuestion`332* `AskUserQuestion`

330* `EnterPlanMode`333* `EnterPlanMode`

331* `ExitPlanMode`(サブエージェントの [`permissionMode`](#permission-modes)が `plan` の場合を除く)334* `ExitPlanMode`(サブエージェントの [`permissionMode`](#permission-modes)が `plan` の場合を除く)


354 357 

355両方が設定されている場合、`disallowedTools` が最初に適用され、その後 `tools` が残りのプールに対して解決されます。両方にリストされているツールは削除されます。358両方が設定されている場合、`disallowedTools` が最初に適用され、その後 `tools` が残りのプールに対して解決されます。両方にリストされているツールは削除されます。

356 359 

360両方のフィールドは、正確なツール名に加えて MCP サーバーレベルのパターンを受け入れます:`mcp__<server>` または `mcp__<server>__*` は、指定されたサーバーからすべてのツールを付与または削除します。`disallowedTools` では、`mcp__*` はすべてのサーバーからすべての MCP ツールも削除します。この例は、`github` MCP サーバーからすべてのツールを削除しながら、他のサーバーのツールと組み込みツールをすべて保持します:

361 

362```yaml theme={null}

363---

364name: local-only

365description: Inherits every tool except those from the github MCP server

366disallowedTools: mcp__github

367---

368```

369 

357<h4 id="restrict-which-subagents-can-be-spawned">370<h4 id="restrict-which-subagents-can-be-spawned">

358 生成できるサブエージェントを制限する371 生成できるサブエージェントを制限する

359</h4>372</h4>


378tools: Agent, Read, Bash391tools: Agent, Read, Bash

379```392```

380 393 

381`Agent` が `tools` リストから完全に省略されている場合、エージェントはサブエージェントを生成できません。この制限は、`claude --agent` でメインスレッドとして実行されるエージェントにのみ適用されます。サブエージェントは他のサブエージェントを生成できないため、`Agent(agent_type)` はサブエージェント定義では効果がありません。394`Agent` が `tools` リストから完全に省略されている場合、エージェントはサブエージェントを生成できません。

395 

396`Agent(agent_type)` 許可リスト構文は、`claude --agent` でメインスレッドとして実行されるエージェントにのみ適用されます。サブエージェント定義では、`tools` に `Agent` をリストするとそのサブエージェントは[ネストされたサブエージェントを生成](#spawn-nested-subagents)できますが、括弧内のタイプリストは無視されます。

382 397 

383<h4 id="scope-mcp-servers-to-a-subagent">398<h4 id="scope-mcp-servers-to-a-subagent">

384 MCP サーバーをサブエージェントにスコープする399 MCP サーバーをサブエージェントにスコープする


444| `plan` | プランモード(読み取り専用探索) |459| `plan` | プランモード(読み取り専用探索) |

445 460 

446<Warning>461<Warning>

447 `bypassPermissions` は注意して使用してください。権限プロンプトをスキップし、サブエージェントが承認なしで操作を実行できるようにします。`.git`、`.config/git`、`.claude`、`.vscode`、`.idea`、`.husky`、`.cargo`、`.devcontainer`、`.yarn`、および `.mvn` ディレクトリへの書き込みを含みます。`rm -rf /` などのルートおよびホームディレクトリの削除は、サーキットブレーカーとしてプロンプトが表示されます。詳細については、[権限モード](/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)を参照してください。462 `bypassPermissions` は注意して使用してください。権限プロンプトをスキップし、サブエージェントが承認なしで操作を実行できるようにします。`.git`、`.config/git`、`.claude`、`.vscode`、`.idea`、`.husky`、`.cargo`、`.devcontainer`、`.yarn`、および `.mvn` ディレクトリへの書き込みを含みます。明示的な [`ask` ルール](/ja/permissions#manage-permissions)およびルートおよびホームディレクトリの削除(`rm -rf /` など)は引き続きプロンプトが表示されます。詳細については、[権限モード](/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)を参照してください。

448</Warning>463</Warning>

449 464 

450親が `bypassPermissions` または `acceptEdits` を使用する場合、これが優先され、オーバーライドできません。親が[自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を使用する場合、サブエージェントは自動モードを継承し、フロントマター内の `permissionMode` は無視されます:分類器は、親セッションと同じブロックおよび許可ルールを使用してサブエージェントのツール呼び出しを評価します。465親が `bypassPermissions` または `acceptEdits` を使用する場合、これが優先され、オーバーライドできません。親が[自動モード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を使用する場合、サブエージェントは自動モードを継承し、フロントマター内の `permissionMode` は無視されます:分類器は、親セッションと同じブロックおよび許可ルールを使用してサブエージェントのツール呼び出しを評価します。


761 776 

762すべてのバックグラウンドタスク機能を無効にするには、`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 環境変数を `1` に設定します。[環境変数](/ja/env-vars)を参照してください。777すべてのバックグラウンドタスク機能を無効にするには、`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 環境変数を `1` に設定します。[環境変数](/ja/env-vars)を参照してください。

763 778 

764[`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation)が設定されている場合、すべてのサブエージェント生成は `background` フィールドに関係なくバックグラウンドで実行されます。フォークは引き続き権限プロンプトをターミナルに表示します。名前付きサブエージェントは上記の説明のように、プロンプトが表示されるものを自動拒否します。779[`CLAUDE_CODE_FORK_SUBAGENT`](#fork-the-current-conversation)が `1` に設定されている場合、すべてのサブエージェント生成は `background` フィールドに関係なくバックグラウンドで実行されます。フォークは引き続き権限プロンプトをターミナルに表示します。名前付きサブエージェントは上記の説明のように、プロンプトが表示されるものを自動拒否します。

765 780 

766<h3 id="common-patterns">781<h3 id="common-patterns">

767 一般的なパターン782 一般的なパターン


826 841 

827会話に既にあるものについての簡単な質問の場合は、サブエージェントの代わりに[`/btw`](/ja/interactive-mode#side-questions-with-%2Fbtw)を使用します。完全なコンテキストを表示しますが、ツールアクセスはなく、答えは履歴に追加されるのではなく破棄されます。842会話に既にあるものについての簡単な質問の場合は、サブエージェントの代わりに[`/btw`](/ja/interactive-mode#side-questions-with-%2Fbtw)を使用します。完全なコンテキストを表示しますが、ツールアクセスはなく、答えは履歴に追加されるのではなく破棄されます。

828 843 

829<Note>844<h3 id="spawn-nested-subagents">

830 サブエージェントは他のサブエージェントを生成できません。ワークフローがネストされた委譲を必要とする場合は、[スキル](/ja/skills)を使用するか、メイン会話から[サブエージェントをチェーン](#chain-subagents)します。845 ネストされたサブエージェントを生成する

831</Note>846</h3>

847 

848Claude Code v2.1.172 以降、サブエージェントは独自のサブエージェントを生成できます。委譲されたタスク自体が並行サブタスクに分割される場合、このを使用します。例えば、レビュアーサブエージェントが検出結果ごとに検証者をディスパッチする場合、中間出力がメイン会話に到達することはありません。トップレベルのサブエージェントの概要のみがあなたに返されます。

849 

850ネストされたサブエージェントは、トップレベルのものと同じ方法で設定され、同じ[スコープ](#choose-the-subagent-scope)から解決されます。プロンプト入力の下のサブエージェントパネルは、完全なツリーを表示します:各行は子孫の `(+N)` カウントを表示し、行を開くとそのサブエージェントの直接の子が `main` へのパスとともに表示されます。[`/agents`](#use-the-%2Fagents-command)の Running タブは、実行中のサブエージェントをフラットリストとして表示します。

851 

852深さは、各レベルが[フォアグラウンドまたはバックグラウンド](#run-subagents-in-foreground-or-background)で実行されるかどうかに関係なく、メイン会話の下のサブエージェントレベルの数として数えられます:

853 

854* **フォアグラウンドサブエージェント**:任意の深さで生成できます。各レベルは親が返されるまでブロックするため、チェーンは自己制限されます:メイン会話はチェーン全体を待ちます。

855* **バックグラウンドサブエージェント**:深さ 5 のバックグラウンドサブエージェントは Agent ツールを受け取らず、さらに生成することはできません。制限は固定されており、設定不可能で、実行不可能な並行ツリーを防ぐために存在します。

856 

857特定のサブエージェントが他のサブエージェントを生成するのを防ぐには、その [`tools`](#available-tools) リストから `Agent` を省略するか、`disallowedTools` に追加します。

858 

859[フォーク](#fork-the-current-conversation)は引き続き別のフォークを生成することはできません。他のサブエージェントタイプを生成でき、それらは深さ制限にカウントされます。

832 860 

833<h3 id="manage-subagent-context">861<h3 id="manage-subagent-context">

834 サブエージェントコンテキストを管理する862 サブエージェントコンテキストを管理する


860 888 

861再開されたサブエージェントは、すべての前のツール呼び出し、結果、および推論を含む、完全な会話履歴を保持します。サブエージェントは、新規に開始するのではなく、停止した場所から正確に再開します。889再開されたサブエージェントは、すべての前のツール呼び出し、結果、および推論を含む、完全な会話履歴を保持します。サブエージェントは、新規に開始するのではなく、停止した場所から正確に再開します。

862 890 

863サブエージェントが完了すると、Claude はエージェント ID を受け取ります。Claude は `SendMessage` ツールを使用してエージェントの ID を `to` フィールドとして使用してサブエージェントを再開します。`SendMessage` ツールは、[エージェントチーム](/ja/agent-teams)が `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を通じて有効になっている場合にのみ利用可能です。891サブエージェントが完了すると、Claude はエージェント ID を受け取ります。組み込みの Explore および Plan エージェントは 1 回限りで、エージェント ID を返さないため、再開できません。作業を続ける必要がある場合は、`general-purpose` またはカスタムサブエージェントを使用してください。Claude は `SendMessage` ツールを使用してエージェントの ID を `to` フィールドとして使用してサブエージェントを再開します。`SendMessage` ツールは、[エージェントチーム](/ja/agent-teams)が `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を通じて有効になっている場合にのみ利用可能です。

864 892 

865サブエージェントを再開するには、Claude に前の作業を続けるよう依頼します:893サブエージェントを再開するには、Claude に前の作業を続けるよう依頼します:

866 894 


879サブエージェントトランスクリプトはメイン会話から独立して永続化されます:907サブエージェントトランスクリプトはメイン会話から独立して永続化されます:

880 908 

881* **メイン会話圧縮**:メイン会話が圧縮されると、サブエージェントトランスクリプトは影響を受けません。別のファイルに保存されます。909* **メイン会話圧縮**:メイン会話が圧縮されると、サブエージェントトランスクリプトは影響を受けません。別のファイルに保存されます。

882* **セッション永続性**:サブエージェントトランスクリプトはセッション内で永続化されます。Claude Code を再起動した後、同じセッションを再開することで[サブエージェントを再開](#resume-subagents)できます910* **セッション永続性**:サブエージェントトランスクリプトはセッション内で永続化されます。Claude Code を再起動した後、同じセッションを再開することでサブエージェントを再開できます

883* **自動クリーンアップ**:トランスクリプトは `cleanupPeriodDays` 設定に基づいてクリーンアップされます(デフォルト:30 日)。911* **自動クリーンアップ**:トランスクリプトは `cleanupPeriodDays` 設定に基づいてクリーンアップされます(デフォルト:30 日)。

884 912 

885<h4 id="auto-compaction">913<h4 id="auto-compaction">

886 自動圧縮914 自動圧縮

887</h4>915</h4>

888 916 

889サブエージェントは、メイン会話と同じロジックを使用した自動圧縮をサポートします。デフォルトでは、自動圧縮は約 95% の容量でトリガーされます。圧縮を早期にトリガーするには、`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` をより低いパーセンテージ(例:`50`)に設定します詳細については、[環境変数](/ja/env-vars)を参照してください。917サブエージェントは、メイン会話と同じロジックを使用した自動圧縮をサポートします。圧縮は同じ条件下でトリガーされ、`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE` はサブエージェントにも適用されます。[環境変数](/ja/env-vars)を参照してください。オーバーライドがいつ有効になるかについて。

890 918 

891圧縮イベントはサブエージェントトランスクリプトファイルにログされます:919圧縮イベントはサブエージェントトランスクリプトファイルにログされます:

892 920 


908</h2>936</h2>

909 937 

910<Note>938<Note>

911 フォークされたサブエージェントは Claude Code v2.1.117 以降が必要です。{/* min-version: 2.1.161 */}v2.1.161 以降では `/fork` コマンドはデフォルトで有効になります。それより前のバージョンでは [`CLAUDE_CODE_FORK_SUBAGENT`](/ja/env-vars) 環境変数を `1` に設定する必要があります。フォークをモデルの*デフォルト*スポーン動作にすることは実験的であり、将来のリリースで変更される可能性があります。同じ変数を設定して有効にしてください。この変数はインタラクティブモードおよび SDK または `claude -p` 経由で有効になります939 フォークされたサブエージェントは Claude Code v2.1.117 以降が必要です。{/* min-version: 2.1.161 */}v2.1.161 以降では `/fork` コマンドはデフォルトで有効になります。それより前のバージョンでは [`CLAUDE_CODE_FORK_SUBAGENT`](/ja/env-vars) 環境変数を `1` に設定する必要があります。Claude 自体がフォークをスポーンすることは実験的であり、将来のリリースで変更される可能性があります。この機能は、段階的なロールアウトの一部として、インタラクティブセッションでも有効にすることができます

912</Note>940</Note>

913 941 

914フォークは、これまでの会話全体を継承するサブエージェントです。これにより、サブエージェントが通常提供する入力分離が削除されます。フォークはメインセッションと同じシステムプロンプト、ツール、モデル、およびメッセージ履歴を表示するため、状況を再度説明することなく、サイドタスクを渡すことができます。フォークのツール呼び出しはまだ会話から除外され、最終結果のみが返されるため、メインコンテキストウィンドウはクリーンなままです。フォークを使用する場合は、名前付きサブエージェントが有用であるには背景が多すぎる場合、または同じ開始点から複数のアプローチを並行して試したい場合です。942フォークは、これまでの会話全体を継承するサブエージェントです。これにより、サブエージェントが通常提供する入力分離が削除されます。フォークはメインセッションと同じシステムプロンプト、ツール、モデル、およびメッセージ履歴を表示するため、状況を再度説明することなく、サイドタスクを渡すことができます。フォークのツール呼び出しはまだ会話から除外され、最終結果のみが返されるため、メインコンテキストウィンドウはクリーンなままです。フォークを使用する場合は、名前付きサブエージェントが有用であるには背景が多すぎる場合、または同じ開始点から複数のアプローチを並行して試したい場合です。

915 943 

916`CLAUDE_CODE_FORK_SUBAGENT` を設定するとClaude Code 2 つの方法で変更されます:944フォークモードを段階的なロールアウトに関係なく制御するには、[`CLAUDE_CODE_FORK_SUBAGENT`](/ja/env-vars) を `1` に設定して明示的に有効にするか`0` に設定して無効にします。この変数はインタラクティブモードおよび SDK または `claude -p` 経由で有効になります。

945 

946フォークモードを有効にすると、Claude Code が 2 つの方法で変更されます:

917 947 

918* Claude は、[general-purpose](#built-in-subagents) サブエージェントを使用する場合にフォークを生成します。Explore などの名前付きサブエージェントは以前と同じように生成されます948* Claude は、`fork` サブエージェントタイプを明示的にリクエストすることでフォークをスポーンできます。サブエージェントタイプなしのスポーンは、[汎用](#built-in-subagents)サブエージェントを使用し、Explore などの名前付きサブエージェントは以前と同じようにスポーンされます

919* すべてのサブエージェント生成は、[バックグラウンド](#run-subagents-in-foreground-or-background)で実行されます。`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` を `1` に設定して、生成を同期的に保つことができます949* すべてのサブエージェントスポーンは、[バックグラウンド](#run-subagents-in-foreground-or-background)で実行されます。フォークか名前付きサブエージェントかに関わらず実行されます。`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` を `1` に設定して、スポーンを同期的に保つことができます

920 950 

921`/fork` の後に指示を続けて、フォークを自分で開始できます。Claude Code はフォークに指示の最初の単語から名前を付けます。次の例は、メインセッションで実装を続ける間に、フォークが会話をドラフトテストケースに分岐させます:951`/fork` の後に指示を続けて、フォークを自分で開始できます。変数が設定されているかどうかに関わらず実行できます。Claude Code はフォークに指示の最初の単語から名前を付けます。次の例は、メインセッションで実装を続ける間に、フォークが会話をドラフトテストケースに分岐させます:

922 952 

923```text theme={null}953```text theme={null}

924/fork draft unit tests for the parser changes so far954/fork draft unit tests for the parser changes so far


948| | フォーク | 名前付きサブエージェント |978| | フォーク | 名前付きサブエージェント |

949| :------------ | :------------- | :------------------------------------------------------------- |979| :------------ | :------------- | :------------------------------------------------------------- |

950| コンテキスト | 完全な会話履歴 | 渡すプロンプトを使用した新しいコンテキスト |980| コンテキスト | 完全な会話履歴 | 渡すプロンプトを使用した新しいコンテキスト |

951| システムプロンプトとツール | メインセッションと同じ | [定義ファイル](#write-subagent-files) から |981| システムプロンプトとツール | メインセッションと同じ | [定義ファイル](#write-subagent-files)から |

952| モデル | メインセッションと同じ | サブエージェントの `model` フィールドから |982| モデル | メインセッションと同じ | サブエージェントの `model` フィールドから |

953| 権限 | プロンプトがターミナルに表示 | バックグラウンド実行時に[自動拒否](#run-subagents-in-foreground-or-background) |983| 権限 | プロンプトがターミナルに表示 | バックグラウンド実行時に[自動拒否](#run-subagents-in-foreground-or-background) |

954| プロンプトキャッシュ | メインセッションと共有 | 別のキャッシュ |984| プロンプトキャッシュ | メインセッションと共有 | 別のキャッシュ |

955 985 

956フォークのシステムプロンプトとツール定義は親と同じであるため、最初のリクエストは親の [prompt cache](/ja/prompt-caching#subagents-and-the-cache) を再利用します。これにより、同じコンテキストが必要なタスクの場合、フォークは新しいサブエージェントを生成するよりも安価です986フォークのシステムプロンプトとツール定義は親と同じであるため、最初のリクエストは親の [prompt cache](/ja/prompt-caching#subagents-and-the-cache) を再利用します。これにより、同じコンテキストが必要なタスクの場合、フォークは新しいサブエージェントをスポーンするよりも安価です

957 987 

958Claude がフォークを Agent ツール経由で生成するときに、`isolation: "worktree"` を渡すことができるため、フォークのファイル編集は、チェックアウトではなく、別の git worktree に書き込まれます。988Claude Agent ツール経由でフォークをスポーンするときに、`isolation: "worktree"` を渡すことができるため、フォークのファイル編集は、チェックアウトではなく、別の git worktree に書き込まれます。

959 989 

960<h3 id="limitations">990<h3 id="limitations">

961 制限事項991 制限事項

962</h3>992</h3>

963 993 

964`CLAUDE_CODE_FORK_SUBAGENT=1` を設定すると、インタラクティブセッション、[非インタラクティブモード](/ja/headless)、および Agent SDK でフォークモードが有効になります。フォークはさらにフォークを生成できません994`CLAUDE_CODE_FORK_SUBAGENT=1` を設定すると、インタラクティブセッション、[非インタラクティブモード](/ja/headless)、および Agent SDK でフォークモードが有効になります。`CLAUDE_CODE_FORK_SUBAGENT` を `0` に設定するとフォークモードが無効になり、サーバー側のロールアウトを含むすべての場所でフォークモードが無効になりますフォークはさらにフォークをスポーンできません。

965 995 

966<h2 id="example-subagents">996<h2 id="example-subagents">

967 サブエージェントの例997 サブエージェントの例

Details

6 6 

7> Claude Code が様々なサードパーティサービスとインフラストラクチャと統合して、エンタープライズデプロイメント要件を満たす方法について学びます。7> Claude Code が様々なサードパーティサービスとインフラストラクチャと統合して、エンタープライズデプロイメント要件を満たす方法について学びます。

8 8 

9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;

11 const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">

12 <line x1="5" y1="12" x2="19" y2="12" />

13 <polyline points="12 5 19 12 12 19" />

14 </svg>;

15 const STYLES = `

16.cc-cs {

17 --cs-slate: #141413;

18 --cs-clay: #d97757;

19 --cs-clay-deep: #c6613f;

20 --cs-gray-000: #ffffff;

21 --cs-gray-700: #3d3d3a;

22 --cs-border-default: rgba(31, 30, 29, 0.15);

23 font-family: inherit;

24}

25.dark .cc-cs {

26 --cs-slate: #f0eee6;

27 --cs-gray-000: #262624;

28 --cs-gray-700: #bfbdb4;

29 --cs-border-default: rgba(240, 238, 230, 0.14);

30}

31.cc-cs-card {

32 display: flex; align-items: center; justify-content: space-between;

33 gap: 16px; padding: 14px 16px; margin: 0;

34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);

35 border-radius: 8px; flex-wrap: wrap;

36}

37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }

38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }

39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }

40.cc-cs-btn-clay {

41 display: inline-flex; align-items: center; gap: 8px;

42 background: var(--cs-clay-deep); color: #fff; border: none;

43 border-radius: 8px; padding: 8px 14px;

44 font-size: 13px; font-weight: 500;

45 transition: background-color 0.15s; white-space: nowrap;

46}

47.cc-cs-btn-clay:hover { background: var(--cs-clay); }

48.cc-cs-btn-ghost {

49 display: inline-flex; align-items: center; gap: 8px;

50 background: transparent; color: var(--cs-gray-700);

51 border: 0.5px solid var(--cs-border-default);

52 border-radius: 8px; padding: 8px 14px;

53 font-size: 13px; font-weight: 500;

54}

55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }

56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }

57@media (max-width: 720px) {

58 .cc-cs-actions { width: 100%; }

59}

60`;

61 return <div className="cc-cs not-prose">

62 <style>{STYLES}</style>

63 <div className="cc-cs-card">

64 <div className="cc-cs-text">

65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.

66 </div>

67 <div className="cc-cs-actions">

68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">

69 View plans

70 </a>

71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">

72 Contact sales {iconArrowRight()}

73 </a>

74 </div>

75 </div>

76 </div>;

77};

78 

9組織は Anthropic を通じて直接、またはクラウドプロバイダーを通じて Claude Code をデプロイできます。このページは、適切な構成を選択するのに役立ちます。79組織は Anthropic を通じて直接、またはクラウドプロバイダーを通じて Claude Code をデプロイできます。このページは、適切な構成を選択するのに役立ちます。

10 80 

81<ContactSalesCard surface="third_party_overview" />

82 

11<h2 id="compare-deployment-options">83<h2 id="compare-deployment-options">

12 デプロイメントオプションの比較84 デプロイメントオプションの比較

13</h2>85</h2>


271 クラウドプロバイダーのモデルバージョンをピン留めする343 クラウドプロバイダーのモデルバージョンをピン留めする

272</h3>344</h3>

273 345 

274[Bedrock](/ja/amazon-bedrock)、[Vertex AI](/ja/google-vertex-ai)、[Foundry](/ja/microsoft-foundry)、または [Claude Platform on AWS](/ja/claude-platform-on-aws) を通じてデプロイする場合は、`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、および `ANTHROPIC_DEFAULT_HAIKU_MODEL` を使用して特定のモデルバージョンをピン留めします。ピン留めしない場合、モデルエイリアスは最新バージョンに解決され、Anthropic が新しいモデルをリリースしてアカウントでまだ有効になっていない場合があります。ピン留めすることで、ユーザーが新しいモデルに移行するタイミングを制御できます。各プロバイダーが最新バージョンが利用できない場合に何を行うかについては、[モデル構成](/ja/model-config#pin-models-for-third-party-deployments)を参照してください。346[Bedrock](/ja/amazon-bedrock)、[Vertex AI](/ja/google-vertex-ai)、[Foundry](/ja/microsoft-foundry)、または [Claude Platform on AWS](/ja/claude-platform-on-aws) を通じてデプロイする場合は、`ANTHROPIC_DEFAULT_FABLE_MODEL`、`ANTHROPIC_DEFAULT_OPUS_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、および `ANTHROPIC_DEFAULT_HAIKU_MODEL` を使用して特定のモデルバージョンをピン留めします。ピン留めしない場合、モデルエイリアスは Claude Code のそのプロバイダーの組み込みデフォルトに解決され、最新リリースより遅れる可能性があり、アカウントでまだ有効になっていない可能性があります。ピン留めすることで、ユーザーが新しいモデルに移行するタイミングを制御できます。各プロバイダーがデフォルトが利用できない場合に何を行うかについては、[モデル構成](/ja/model-config#pin-models-for-third-party-deployments)を参照してください。

275 347 

276<h3 id="configure-security-policies">348<h3 id="configure-security-policies">

277 セキュリティポリシーを構成する349 セキュリティポリシーを構成する

Details

44| `TaskOutput` | (非推奨)バックグラウンド タスクから出力を取得します。タスクの出力ファイル パスで `Read` を使用することをお勧めします | いいえ |44| `TaskOutput` | (非推奨)バックグラウンド タスクから出力を取得します。タスクの出力ファイル パスで `Read` を使用することをお勧めします | いいえ |

45| `TaskStop` | ID で実行中のバックグラウンド タスクを終了します | いいえ |45| `TaskStop` | ID で実行中のバックグラウンド タスクを終了します | いいえ |

46| `TaskUpdate` | タスク ステータス、依存関係、詳細を更新するか、タスクを削除します | いいえ |46| `TaskUpdate` | タスク ステータス、依存関係、詳細を更新するか、タスクを削除します | いいえ |

47| `TeamCreate` | 複数のメンバーを持つ [agent team](/ja/agent-teams)を作成します。`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` が設定されている場合にのみ利用可能です | いいえ |

48| `TeamDelete` | agent team を解散してメンバー プロセスをクリーンアップします。`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` が設定されている場合にのみ利用可能です | いいえ |

49| `TodoWrite` | {/* min-version: 2.1.142 */}セッション タスク チェックリストを管理します。v2.1.142 以降、`TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate` を優先するため、デフォルトで無効になっています。`CLAUDE_CODE_ENABLE_TASKS=0` を設定して再度有効にします | いいえ |47| `TodoWrite` | {/* min-version: 2.1.142 */}セッション タスク チェックリストを管理します。v2.1.142 以降、`TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate` を優先するため、デフォルトで無効になっています。`CLAUDE_CODE_ENABLE_TASKS=0` を設定して再度有効にします | いいえ |

50| `ToolSearch` | [ツール検索](/ja/mcp#scale-with-mcp-tool-search)が有効な場合、遅延ツールを検索してロードします | いいえ |48| `ToolSearch` | [ツール検索](/ja/mcp#scale-with-mcp-tool-search)が有効な場合、遅延ツールを検索してロードします | いいえ |

51| `WaitForMcpServers` | {/* min-version: 2.1.142 */}バックグラウンドでまだ接続中の 1 つ以上の [MCP servers](/ja/mcp)を待機するため、セッションを再開することなくそのツールをリクエストで使用できます。必要なサーバーがまだ接続されていない場合、Claude はそれを呼び出します。[ツール検索](/ja/mcp#scale-with-mcp-tool-search)が無効な場合にのみ表示されます。有効な場合は `ToolSearch` が待機を処理するため | いいえ |49| `WaitForMcpServers` | {/* min-version: 2.1.142 */}バックグラウンドでまだ接続中の 1 つ以上の [MCP servers](/ja/mcp)を待機するため、セッションを再開することなくそのツールをリクエストで使用できます。必要なサーバーがまだ接続されていない場合、Claude はそれを呼び出します。[ツール検索](/ja/mcp#scale-with-mcp-tool-search)が無効な場合にのみ表示されます。有効な場合は `ToolSearch` が待機を処理するため | いいえ |


61ほとんどの場合、Claude はこれらのツールをいつ使用するかを決定し、Claude と対話するときにツール名を自分で指定する必要はありません。権限およびその他の構成を定義するときにツール名を直接参照します:59ほとんどの場合、Claude はこれらのツールをいつ使用するかを決定し、Claude と対話するときにツール名を自分で指定する必要はありません。権限およびその他の構成を定義するときにツール名を直接参照します:

62 60 

63* 設定の [`permissions.allow` と `permissions.deny`](/ja/settings#available-settings)および `/permissions` インターフェイス内61* 設定の [`permissions.allow` と `permissions.deny`](/ja/settings#available-settings)および `/permissions` インターフェイス内

62* [`allowedTools` と `disallowedTools`](/ja/cli-reference)の CLI フラグ内

64* Agent SDK の [`allowedTools` と `disallowedTools`](/ja/agent-sdk/permissions#allow-and-deny-rules)オプション内63* Agent SDK の [`allowedTools` と `disallowedTools`](/ja/agent-sdk/permissions#allow-and-deny-rules)オプション内

65* [CLI フラグ](/ja/cli-reference)の `--allowedTools` と `--disallowedTools` 内

66* [subagent の `tools` または `disallowedTools`](/ja/sub-agents#supported-frontmatter-fields)frontmatter 内64* [subagent の `tools` または `disallowedTools`](/ja/sub-agents#supported-frontmatter-fields)frontmatter 内

67* [skill の `allowed-tools`](/ja/skills#frontmatter-reference)frontmatter 内65* [skill の `allowed-tools`](/ja/skills#frontmatter-reference)frontmatter 内

68* フックの [`if` 条件](/ja/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field)内66* フックの [`if` 条件](/ja/hooks-guide#filter-by-tool-name-and-arguments-with-the-if-field)内


70これらはすべて同じルール形式 `ToolName(specifier)` を受け入れます。指定子はツールによって異なり、複数のツールが形式を共有します:68これらはすべて同じルール形式 `ToolName(specifier)` を受け入れます。指定子はツールによって異なり、複数のツールが形式を共有します:

71 69 

72| ルール形式 | 適用対象 | 詳細 |70| ルール形式 | 適用対象 | 詳細 |

73| :----------------------------- | :---------------------- | :-------------------------------------------------------- |71| :----------------------------- | :---------------------- | :---------------------------------------------------------------- |

74| `Bash(npm run *)` | Bash、Monitor | [コマンド パターン マッチング](/ja/permissions#bash) |72| `Bash(npm run *)` | Bash、Monitor | [コマンド パターン マッチング](/ja/permissions#bash) |

75| `PowerShell(Get-ChildItem *)` | PowerShell | [コマンド パターン マッチング](/ja/permissions#powershell) |73| `PowerShell(Get-ChildItem *)` | PowerShell | [コマンド パターン マッチング](/ja/permissions#powershell) |

76| `Read(~/secrets/**)` | Read、Grep、Glob、LSP | [パス パターン マッチング](/ja/permissions#read-and-edit) |74| `Read(~/secrets/**)` | Read、Grep、Glob、LSP | [パス パターン マッチング](/ja/permissions#read-and-edit) |

77| `Edit(/src/**)` | Edit、Write、NotebookEdit | [パス パターン マッチング](/ja/permissions#read-and-edit) |75| `Edit(/src/**)` | Edit、Write、NotebookEdit | [パス パターン マッチング](/ja/permissions#read-and-edit) |

78| `Skill(deploy *)` | Skill | [Skill 名マッチング](/ja/skills#restrict-claude's-skill-access) |76| `Skill(deploy *)` | Skill | [Skill 名マッチング](/ja/skills#restrict-claude%E2%80%99s-skill-access) |

79| `Agent(Explore)` | Agent | [Subagent タイプ マッチング](/ja/permissions#agent-subagents) |77| `Agent(Explore)` | Agent | [Subagent タイプ マッチング](/ja/permissions#agent-subagents) |

80| `WebFetch(domain:example.com)` | WebFetch | [ドメイン マッチング](/ja/permissions#webfetch) |78| `WebFetch(domain:example.com)` | WebFetch | [ドメイン マッチング](/ja/permissions#webfetch) |

81| `WebSearch` | WebSearch | 指定子なし。ツール全体を許可または拒否します |79| `WebSearch` | WebSearch | 指定子なし。ツール全体を許可または拒否します |


157 155 

158結果は変更時刻でソートされ、100 ファイルで制限されます。制限に達した場合、Claude は結果に切り詰めフラグを見て、パターンを絞り込むことができます。156結果は変更時刻でソートされ、100 ファイルで制限されます。制限に達した場合、Claude は結果に切り詰めフラグを見て、パターンを絞り込むことができます。

159 157 

160Glob はデフォルトで `.gitignore` を尊重しないため、追跡されたファイルと並んで gitignore されたファイルを検出します。これは [Grep](#grep-tool-behavior)とは異なり、gitignore されたファイルをスキップします。Glob が `.gitignore` を尊重するようにするには、Claude Code を起動する前に `CLAUDE_CODE_GLOB_NO_IGNORE=false` を設定します。158Glob はデフォルトで `.gitignore` を尊重しないため、追跡されたファイルと並んで gitignore されたファイルを検出します。これは [Grep](#grep-tool-behavior) とは異なり、gitignore されたファイルをスキップします。Glob が `.gitignore` を尊重するようにするには、Claude Code を起動する前に `CLAUDE_CODE_GLOB_NO_IGNORE=false` を設定します。

161 159 

162<h2 id="grep-tool-behavior">160<h2 id="grep-tool-behavior">

163 Grep ツールの動作161 Grep ツールの動作


186* シンボルの定義へのジャンプ184* シンボルの定義へのジャンプ

187* シンボルへのすべての参照を検索185* シンボルへのすべての参照を検索

188* 位置での型情報を取得186* 位置での型情報を取得

189* ファイルまたはワークスペース内のシンボルをリスト187* ファイル内のシンボルをリスト

188* ワークスペース全体でシンボルを名前で検索

190* インターフェイスの実装を検索189* インターフェイスの実装を検索

191* 呼び出し階層をトレース190* 呼び出し階層をトレース

192 191 


307 306 

308デフォルトおよび `acceptEdits` 権限モードでは、WebFetch は新しいドメインに最初に到達するときにプロンプトを表示します。プロンプトなしで事前にドメインを許可するには、`WebFetch(domain:example.com)` のような権限ルールを追加します。`auto` および `bypassPermissions` [権限モード](/ja/permissions#permission-modes)はプロンプトを完全にスキップします。307デフォルトおよび `acceptEdits` 権限モードでは、WebFetch は新しいドメインに最初に到達するときにプロンプトを表示します。プロンプトなしで事前にドメインを許可するには、`WebFetch(domain:example.com)` のような権限ルールを追加します。`auto` および `bypassPermissions` [権限モード](/ja/permissions#permission-modes)はプロンプトを完全にスキップします。

309 308 

309明示的な `WebFetch(domain:...)` ルールが `deny`、`ask`、または `allow` にある場合、事前承認されたセットよりも優先されるため、事前承認されたドメインをブロックするか、そのドメインに対してプロンプトを要求できます。

310 

310WebFetch は `Claude-User` で始まる `User-Agent` ヘッダーと、HTML よりも Markdown を優先する `Accept` ヘッダーを設定するため、コンテンツ ネゴシエーションをサポートするサーバーは Markdown を直接返すことができます。[Sandbox](/ja/sandboxing)ネットワーク ルールは別途構成されるため、サンドボックス化されたプロセスが到達したいドメインには、明示的なサンドボックス権限ルールが必要です。311WebFetch は `Claude-User` で始まる `User-Agent` ヘッダーと、HTML よりも Markdown を優先する `Accept` ヘッダーを設定するため、コンテンツ ネゴシエーションをサポートするサーバーは Markdown を直接返すことができます。[Sandbox](/ja/sandboxing)ネットワーク ルールは別途構成されるため、サンドボックス化されたプロセスが到達したいドメインには、明示的なサンドボックス権限ルールが必要です。

311 312 

312<h2 id="websearch-tool-behavior">313<h2 id="websearch-tool-behavior">

313 WebSearch ツールの動作314 WebSearch ツールの動作

314</h2>315</h2>

315 316 

316WebSearch は Anthropic の [web search](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool)バックエンドに対してクエリを実行し、結果のタイトルと URL を返します。結果ページをフェッチしません。Claude が検索結果で見つけたページを読むには、[WebFetch](#webfetch-tool-behavior)でフォローアップします。317WebSearch は Anthropic の [web search](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/web-search-tool)バックエンドに対してクエリを実行し、結果のタイトルと URL を返します。結果ページをフェッチしません。Claude が検索結果で見つけたページを読むには、[WebFetch](#webfetch-tool-behavior)でフォローアップします。

317 318 

318ツールは 1 回の呼び出しあたり最大 8 つのバックエンド検索を発行し、結果を返す前に内部的に検索を絞り込む場合があります。Claude は `allowed_domains` で結果をスコープして特定のホストのみを含めるか、`blocked_domains` で除外できます。2 つのリストは 1 回の呼び出しで組み合わせることはできません。319ツールは 1 回の呼び出しあたり最大 8 つのバックエンド検索を発行し、結果を返す前に内部的に検索を絞り込む場合があります。Claude は `allowed_domains` で結果をスコープして特定のホストのみを含めるか、`blocked_domains` で除外できます。2 つのリストは 1 回の呼び出しで組み合わせることはできません。

319 320 


349 350 

350Claude は会話形式の概要を提供します。正確な MCP ツール名については、`/mcp` を実行します。351Claude は会話形式の概要を提供します。正確な MCP ツール名については、`/mcp` を実行します。

351 352 

353<Note>

354 [advisor tool](/ja/advisor) は、Claude Code が実装するツールではなく、API が実行する [server tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/advisor-tool) です。権限ルールやフック マッチャーで参照できる名前はありません。

355</Note>

356 

352<h2 id="see-also">357<h2 id="see-also">

353 関連項目358 関連項目

354</h2>359</h2>

Details

6 6 

7> Claude Code のインストールまたはサインイン時に、コマンドが見つからない、PATH、権限、ネットワーク、認証エラーを修正します。7> Claude Code のインストールまたはサインイン時に、コマンドが見つからない、PATH、権限、ネットワーク、認証エラーを修正します。

8 8 

9インストールが失敗した場合、またはサインインできない場合は、以下からエラーを見つけてください。Claude Code が動作している場合のランタイム問題については、[トラブルシューティング](/ja/troubleshooting)を参照してください。設定が適用されない、またはフック が発火しないなどの設定の問題については、[設定をデバッグする](/ja/debug-your-config)を参照してください。9インストールが失敗した場合、またはサインインできない場合は、以下からエラーを見つけてください。Claude Code が動作している場合のランタイム問題については、[トラブルシューティング](/ja/troubleshooting)を参照してください。設定が適用されない、またはフックが発火しないなどの設定の問題については、[設定をデバッグする](/ja/debug-your-config)を参照してください。

10 10 

11<h2 id="find-your-error">11<h2 id="find-your-error">

12 エラーを見つける12 エラーを見つける


24| `TLS connect error` または `SSL/TLS secure channel` | [CA 証明書を更新する](#tls-or-ssl-connection-errors) |24| `TLS connect error` または `SSL/TLS secure channel` | [CA 証明書を更新する](#tls-or-ssl-connection-errors) |

25| `Failed to fetch version` またはダウンロードサーバーに到達できない | [ネットワークとプロキシ設定を確認する](#check-network-connectivity) |25| `Failed to fetch version` またはダウンロードサーバーに到達できない | [ネットワークとプロキシ設定を確認する](#check-network-connectivity) |

26| `irm is not recognized` または `&& is not valid` | [シェルに適切なコマンドを使用する](#wrong-install-command-on-windows) |26| `irm is not recognized` または `&& is not valid` | [シェルに適切なコマンドを使用する](#wrong-install-command-on-windows) |

27| `Cask 'claude-code' is unavailable: No Cask with this name exists` | [Homebrew を更新する](#homebrew-cask-unavailable-or-outdated) |

27| `'bash' is not recognized as the name of a cmdlet` | [Windows インストーラーコマンドを使用する](#wrong-install-command-on-windows) |28| `'bash' is not recognized as the name of a cmdlet` | [Windows インストーラーコマンドを使用する](#wrong-install-command-on-windows) |

28| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [シェルをインストールする](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |29| `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell` | [シェルをインストールする](#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell) |

29| `Claude Code does not support 32-bit Windows` | [Windows PowerShell を開く(x86 エントリではなく)](#claude-code-does-not-support-32-bit-windows) |30| `Claude Code does not support 32-bit Windows` | [Windows PowerShell を開く(x86 エントリではなく)](#claude-code-does-not-support-32-bit-windows) |


61curl -sI https://downloads.claude.ai/claude-code-releases/latest62curl -sI https://downloads.claude.ai/claude-code-releases/latest

62```63```

63 64 

65PowerShell では、代わりに `curl.exe -sI` を実行してください。PowerShell は `curl` を `Invoke-WebRequest` にエイリアスしており、`-sI` フラグを拒否します。

66 

64`HTTP/2 200` という行はサーバーに到達したことを意味します。出力がない、`Could not resolve host`、または接続タイムアウトが表示される場合、ネットワークが接続をブロックしています。一般的な原因:67`HTTP/2 200` という行はサーバーに到達したことを意味します。出力がない、`Could not resolve host`、または接続タイムアウトが表示される場合、ネットワークが接続をブロックしています。一般的な原因:

65 68 

66* `downloads.claude.ai` をブロックしている企業ファイアウォールまたはプロキシ69* `downloads.claude.ai` をブロックしている企業ファイアウォールまたはプロキシ


95 98 

96インストールが成功しても、`claude` を実行するときに `command not found` または `not recognized` エラーが表示される場合、インストールディレクトリが PATH に含まれていません。シェルは PATH にリストされているディレクトリ内のプログラムを検索し、インストーラーは macOS/Linux では `~/.local/bin/claude` に、Windows では `%USERPROFILE%\.local\bin\claude.exe` に `claude` を配置します。99インストールが成功しても、`claude` を実行するときに `command not found` または `not recognized` エラーが表示される場合、インストールディレクトリが PATH に含まれていません。シェルは PATH にリストされているディレクトリ内のプログラムを検索し、インストーラーは macOS/Linux では `~/.local/bin/claude` に、Windows では `%USERPROFILE%\.local\bin\claude.exe` に `claude` を配置します。

97 100 

101<Note>

102 [VS Code 拡張機能](/ja/vs-code)は `claude` をこの場所に配置しません。拡張機能ディレクトリ内に CLI のプライベートコピーをバンドルし、独自のチャットパネル用に使用し、PATH に追加しません。拡張機能のみをインストールした場合、`~/.local/bin/claude` は存在しません。ターミナルから `claude` を使用するには[スタンドアロンインストール](/ja/setup)を実行してから、以下を続行してください。

103</Note>

104 

98インストールディレクトリが PATH に含まれているかどうかを確認するには、PATH エントリをリストして `local/bin` でフィルタリングしてください:105インストールディレクトリが PATH に含まれているかどうかを確認するには、PATH エントリをリストして `local/bin` でフィルタリングしてください:

99 106 

100<Tabs>107<Tabs>


188 ls -la ~/.local/bin/claude195 ls -la ~/.local/bin/claude

189 ```196 ```

190 197 

198 `ls` コマンドが `No such file or directory` を出力する場合、それはエラーではありません。その場所に何もインストールされていないことを意味するため、次のチェックに進んでください。

199 

191 ```bash theme={null}200 ```bash theme={null}

192 ls -la ~/.claude/local/201 ls -la ~/.claude/local/

193 ```202 ```


390 winget install Anthropic.ClaudeCode399 winget install Anthropic.ClaudeCode

391 ```400 ```

392 401 

402<h3 id="homebrew-cask-unavailable-or-outdated">

403 Homebrew cask が利用できないか古い

404</h3>

405 

406Homebrew が `Error: Cask 'claude-code' is unavailable: No Cask with this name exists` を報告する場合、Homebrew cask インデックスのローカルコピーが cask の公開より前のものです。インデックスを更新して再試行してください:

407 

408```bash theme={null}

409brew update

410brew install --cask claude-code

411```

412 

413Homebrew が予想より古い Claude Code バージョンをインストールする場合、通常は同じ古いインデックスが原因です。`claude-code` cask は安定チャネルを追跡し、通常は最新リリースより約 1 週間遅れています。最新バージョンを実行するには、代わりに `brew install --cask claude-code@latest` を実行してください。2 つの cask の違いについては、[リリースチャネルを設定する](/ja/setup#configure-release-channel)を参照してください。

414 

393<h3 id="tls-or-ssl-connection-errors">415<h3 id="tls-or-ssl-connection-errors">

394 TLS または SSL 接続エラー416 TLS または SSL 接続エラー

395</h3>417</h3>


592 614 

593Git がどこか別の場所にインストールされている場合は、PowerShell で `where.exe git` を実行してパスを見つけ、そのディレクトリから `bin\bash.exe` パスを使用してください。615Git がどこか別の場所にインストールされている場合は、PowerShell で `where.exe git` を実行してパスを見つけ、そのディレクトリから `bin\bash.exe` パスを使用してください。

594 616 

617**パスが正しく、ファイルが存在する**が Claude Code がそれを見つけられないと報告する場合、AppLocker、グループポリシーソフトウェア制限ポリシー、または EDR エージェントなどのエンドポイントセキュリティソフトウェアが干渉している可能性があります。v2.1.116 より前のバージョンでは、Claude Code はパスを確認するために子プロセス(`cmd.exe`)を生成しました。これらのポリシーはこれをブロックできます。一般的な兆候は、`cmd.exe /c dir "C:\Program Files\Git\bin\bash.exe"` が PowerShell で直接実行するときは機能しますが、`claude.exe` によって起動されたときはサイレントに失敗することです。

618 

619Claude Code v2.1.116 以降はファイルシステムを直接チェックするため、最初に更新してください。現在のバージョンでエラーが続く場合は、IT チームに `claude.exe` と、`cmd.exe` や `bash.exe` を含むそれが生成するプロセスをエンドポイント保護ポリシーでホワイトリストに登録するよう依頼してください。

620 

595<h3 id="claude-code-does-not-support-32-bit-windows">621<h3 id="claude-code-does-not-support-32-bit-windows">

596 Claude Code は 32 ビット Windows をサポートしていません622 Claude Code は 32 ビット Windows をサポートしていません

597</h3>623</h3>

Details

361. `/compact` を定期的に使用してコンテキストサイズを削減します361. `/compact` を定期的に使用してコンテキストサイズを削減します

372. 主要なタスク間で Claude Code を閉じて再起動します372. 主要なタスク間で Claude Code を閉じて再起動します

383. 大規模なビルドディレクトリを `.gitignore` ファイルに追加することを検討してください383. 大規模なビルドディレクトリを `.gitignore` ファイルに追加することを検討してください

394. [`claude --safe-mode`](/ja/cli-reference#cli-flags) で再起動して、プラグイン、MCP サーバー、またはフックが原因かどうかを確認します。セッション中のすべてのカスタマイズが無効になります。使用量が低下した場合は、[設定をデバッグする](/ja/debug-your-config#test-against-a-clean-configuration)を参照して、どれが原因かを特定します

39 40 

40メモリ使用量がこれらのステップ後も高いままの場合は、`/heapdump` を実行して JavaScript ヒープスナップショットとメモリ分析を `~/Desktop` に書き込みます。Linux でデスクトップフォルダがない場合、ファイルはホームディレクトリに書き込まれます。41これらのステップ後もメモリ使用量が高いままの場合は、`/heapdump` を実行して JavaScript ヒープスナップショットとメモリ分析を `~/Desktop` に書き込みます。Linux でデスクトップフォルダがない場合、ファイルはホームディレクトリに書き込まれます。

41 42 

42分析は常駐セットサイズ、JS ヒープ、配列バッファ、および説明されていないネイティブメモリを表示し、成長が JavaScript オブジェクトにあるか、ネイティブコードにあるかを識別するのに役立ちます。Chrome DevTools のメモリ → ロードで `.heapsnapshot` ファイルを開いて、リテイナーを検査します。メモリの問題を報告するときに両方のファイルを [GitHub](https://github.com/anthropics/claude-code/issues) に添付します。43分析は常駐セットサイズ、JS ヒープ、配列バッファ、および説明されていないネイティブメモリを表示し、成長が JavaScript オブジェクトにあるか、ネイティブコードにあるかを識別するのに役立ちます。Chrome DevTools のメモリ → ロードで `.heapsnapshot` ファイルを開いて、リテイナーを検査します。メモリの問題を報告するときに両方のファイルを [GitHub](https://github.com/anthropics/claude-code/issues) に添付します。

43 44 


65 66 

66再起動してもカンバセーションは失われません。同じディレクトリで `claude --resume` を実行してセッションを再開してください。67再起動してもカンバセーションは失われません。同じディレクトリで `claude --resume` を実行してセッションを再開してください。

67 68 

68<h3 id="garbled-or-corrupted-text-in-an-editor-s-integrated-terminal">69<h3 id="garbled-or-corrupted-text-in-an-editors-integrated-terminal">

69 エディタの統合ターミナルでのテキストの文字化けまたは破損70 エディタの統合ターミナルでのテキストの文字化けまたは破損

70</h3>71</h3>

71 72 

72VS Code、Cursor、または Devin Desktop の統合ターミナルで Claude Code を実行する場合、文字がボックス、スミア、または間違ったグリフとしてレンダリングされる場合、ターミナルの GPU レンダラーが原因である可能性があります。Claude Code 内で `/terminal-setup` を実行して、`terminal.integrated.gpuAcceleration` を `"off"` に設定するか、エディタの設定で手動で設定してウィンドウをリロードします。[ターミナル設定](/ja/terminal-config) で、`/terminal-setup` が書き込む他の設定を参照してください。73VS Code、Cursor、または Devin Desktop の統合ターミナルで Claude Code を実行する場合、文字がボックス、スミア、または間違ったグリフとしてレンダリングされる場合、ターミナルの GPU レンダラーが原因である可能性があります。Claude Code 内で `/terminal-setup` を実行して、`terminal.integrated.gpuAcceleration` を `"off"` に設定するか、エディタの設定で手動で設定してウィンドウをリロードします。[ターミナル設定](/ja/terminal-config)で、`/terminal-setup` が書き込む他の設定を参照してください。

73 74 

74<h3 id="search-and-discovery-issues">75<h3 id="search-and-discovery-issues">

75 検索と発見の問題76 検索と発見の問題

ultraplan.md +1 −1

Details

38 38 

39コマンドとキーワードのパスは、起動前に確認ダイアログを開きます。ローカル計画パスはこのダイアログをスキップします。これは、その選択がすでに確認として機能するためです。[Remote Control](/ja/remote-control) がアクティブな場合、ultraplan の開始時に切断されます。これは、両方の機能が claude.ai/code インターフェイスを占有し、一度に 1 つだけ接続できるためです。39コマンドとキーワードのパスは、起動前に確認ダイアログを開きます。ローカル計画パスはこのダイアログをスキップします。これは、その選択がすでに確認として機能するためです。[Remote Control](/ja/remote-control) がアクティブな場合、ultraplan の開始時に切断されます。これは、両方の機能が claude.ai/code インターフェイスを占有し、一度に 1 つだけ接続できるためです。

40 40 

41クラウドセッションが起動した後、CLI のプロンプト入力は、リモートセッションが動作している間、ステータスインジケータを表示します。41クラウドセッションが起動した後、CLI のプロンプト入力は、クラウドセッションが動作している間、ステータスインジケータを表示します。

42 42 

43| ステータス | 意味 |43| ステータス | 意味 |

44| :----------------------------- | :--------------------------------------- |44| :----------------------------- | :--------------------------------------- |

ultrareview.md +2 −2

Details

58| Max | 3 回の無料実行 | [追加使用量](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)として請求 |58| Max | 3 回の無料実行 | [追加使用量](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)として請求 |

59| Team および Enterprise | なし | [追加使用量](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)として請求 |59| Team および Enterprise | なし | [追加使用量](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)として請求 |

60 60 

61Pro および Max サブスクライバーは、機能を試すために 3 回の無料 ultrareview 実行を受け取ります。これら 3 回の実行はアカウントごとの 1 回限りの割り当てであり、更新されません。3 回すべてを使用した後、または無料実行期間が終了した後、各レビューは追加使用量に請求され、通常は変更のサイズに応じて $5 から $20 の費用がかかります。リモートセッションが開始されると実行がカウントされるため、早期に停止したレビューまたは完了に失敗したレビューでも、無料実行を使用します。有料レビューの場合、追加使用量は実行された部分に対してのみ請求されます。61Pro および Max サブスクライバーは、機能を試すために 3 回の無料 ultrareview 実行を受け取ります。これら 3 回の実行はアカウントごとの 1 回限りの割り当てであり、更新されません。3 回すべてを使用した後、または無料実行期間が終了した後、各レビューは追加使用量に請求され、通常は変更のサイズに応じて $5 から $20 の費用がかかります。クラウドセッションが開始されると実行がカウントされるため、早期に停止したレビューまたは完了に失敗したレビューでも、無料実行を使用します。有料レビューの場合、追加使用量は実行された部分に対してのみ請求されます。

62 62 

63Ultrareview は常に無料実行回数外の追加使用量として請求されるため、有料レビューを起動する前に、アカウントまたは組織で追加使用量を有効にする必要があります。追加使用量が有効になっていない場合、Claude Code は起動をブロックし、有効にできる請求設定にリンクします。`/usage-credits` を実行して、現在の設定を確認または変更することもできます。63Ultrareview は常に無料実行回数外の追加使用量として請求されるため、有料レビューを起動する前に、アカウントまたは組織で追加使用量を有効にする必要があります。追加使用量が有効になっていない場合、Claude Code は起動をブロックし、有効にできる請求設定にリンクします。`/usage-credits` を実行して、現在の設定を確認または変更することもできます。

64 64 


115 関連リソース115 関連リソース

116</h2>116</h2>

117 117 

118* [Claude Code on the web](/ja/claude-code-on-the-web): リモートセッションとクラウドサンドボックスの仕組みについて学習します118* [Claude Code on the web](/ja/claude-code-on-the-web): クラウドセッションとクラウドサンドボックスの仕組みについて学習します

119* [Plan complex changes with ultraplan](/ja/ultraplan): 事前設計作業のための ultrareview のカウンターパート119* [Plan complex changes with ultraplan](/ja/ultraplan): 事前設計作業のための ultrareview のカウンターパート

120* [Manage costs effectively](/ja/costs): 使用量を追跡し、支出制限を設定します120* [Manage costs effectively](/ja/costs): 使用量を追跡し、支出制限を設定します

vs-code.md +155 −51

Details

12 12 

13この拡張機能を使用すると、Claude のプランを受け入れる前に確認および編集でき、編集が行われるときに自動的に受け入れることができ、選択範囲から特定の行範囲を持つファイルを @-メンションでき、会話履歴にアクセスでき、複数の会話を別々のタブまたはウィンドウで開くことができます。13この拡張機能を使用すると、Claude のプランを受け入れる前に確認および編集でき、編集が行われるときに自動的に受け入れることができ、選択範囲から特定の行範囲を持つファイルを @-メンションでき、会話履歴にアクセスでき、複数の会話を別々のタブまたはウィンドウで開くことができます。

14 14 

15## 前提条件15<h2 id="prerequisites">

16 前提条件

17</h2>

16 18 

17インストール前に、以下があることを確認してください。19インストール前に、以下があることを確認してください。

18 20 

19* VS Code 1.98.0 以上21* VS Code 1.98.0 以上

20* Anthropic アカウント(拡張機能を初めて開くときにサインインします)。Amazon Bedrock や Google Vertex AI などのサードパーティプロバイダーを使用している場合は代わりに[サードパーティプロバイダーを使用する](#use-third-party-providers)を参照してください。22* Anthropic アカウント:任意の有料 Claude サブスクリプションPro、Max、Team、または Enterpriseまたは Claude Console アカウントが機能し、API キーは不要です拡張機能を初めて開くときに、このアカウントで[サインイン](/ja/authentication#log-in-to-claude-code)します。Amazon Bedrock や Google Vertex AI などのサードパーティプロバイダーを通じて Claude にアクセスする場合はセットアップ手順について[サードパーティプロバイダーを使用する](#use-third-party-providers)を参照してください。

21 23 

22<Tip>24<Tip>

23 拡張機能には CLI(コマンドラインインターフェース)が含まれており、VS Code の統合ターミナルからアクセスして高度な機能を使用できます。詳細については、[VS Code 拡張機能と Claude Code CLI](#vs-code-extension-vs-claude-code-cli) を参照してください。25 拡張機能には、チャットパネル用の CLI(コマンドラインインターフェース)の独自コピーが含まれています。VS Code の統合ターミナルで `claude` を実行するには、[スタンドアロン CLI インストール](/ja/setup)も必要です。詳細については、[VS Code 拡張機能と Claude Code CLI](#vs-code-extension-vs-claude-code-cli)を参照してください。

24</Tip>26</Tip>

25 27 

26## 拡張機能をインストールする28<h2 id="install-the-extension">

29 拡張機能をインストールする

30</h2>

27 31 

28IDE のリンクをクリックして直接インストールします。32IDE のリンクをクリックして直接インストールします。

29 33 


32 36 

33または、VS Code で `Cmd+Shift+X`(Mac)または `Ctrl+Shift+X`(Windows/Linux)を押して拡張機能ビューを開き、「Claude Code」を検索して、**インストール**をクリックします。37または、VS Code で `Cmd+Shift+X`(Mac)または `Ctrl+Shift+X`(Windows/Linux)を押して拡張機能ビューを開き、「Claude Code」を検索して、**インストール**をクリックします。

34 38 

35拡張機能は Devin Desktop や Kiro などの他の VS Code フォークにもインストールされます。エディタの拡張機能ビューで「Claude Code」を検索するか、[Open VSX レジストリ](https://open-vsx.org/extension/Anthropic/claude-code)からインストールしてください。エディタが拡張機能をインストールできない場合は、統合ターミナルで `claude` を実行してください。[CLI](/ja/quickstart) はどのターミナルでも動作します。39拡張機能は Devin Desktop や Kiro などの他の VS Code フォークにもインストールされます。エディタの拡張機能ビューで「Claude Code」を検索するか、[Open VSX レジストリ](https://open-vsx.org/extension/Anthropic/claude-code)からインストールしてください。エディタが拡張機能をインストールできない場合は、[CLI](/ja/quickstart) をインストールして、統合ターミナルで `claude` を実行してください。CLI はどのターミナルでも動作します。

36 40 

37<Note>インストール後に拡張機能が表示されない場合は、VS Code を再起動するか、コマンドパレットから「Developer: Reload Window」を実行してください。</Note>41<Note>インストール後に拡張機能が表示されない場合は、VS Code を再起動するか、コマンドパレットから「Developer: Reload Window」を実行してください。</Note>

38 42 

39## はじめに43<h2 id="get-started">

44 はじめに

45</h2>

40 46 

41インストール後、VS Code インターフェースを通じて Claude Code の使用を開始できます。47インストール後、VS Code インターフェースを通じて Claude Code の使用を開始できます。

42 48 


90 コマンドパレットから'Claude Code: Open Walkthrough'を実行して、基本的なガイド付きツアーを取得します。96 コマンドパレットから'Claude Code: Open Walkthrough'を実行して、基本的なガイド付きツアーを取得します。

91</Tip>97</Tip>

92 98 

93## プロンプトボックスを使用する99<h2 id="use-the-prompt-box">

100 プロンプトボックスを使用する

101</h2>

94 102 

95プロンプトボックスは複数の機能をサポートしています。103プロンプトボックスは複数の機能をサポートしています。

96 104 


100* **拡張思考**:Claude が複雑な問題を推論するためにより多くの時間を費やすことができます。コマンドメニュー(`/`)を使用してオンに切り替えます。Claude の推論は会話に折りたたまれたブロックとして表示されます。ブロックをクリックして読むか、`Ctrl+O` を押してセッション内のすべての思考ブロックを展開または折りたたみます。詳細については、[拡張思考](/ja/model-config#extended-thinking)を参照してください。108* **拡張思考**:Claude が複雑な問題を推論するためにより多くの時間を費やすことができます。コマンドメニュー(`/`)を使用してオンに切り替えます。Claude の推論は会話に折りたたまれたブロックとして表示されます。ブロックをクリックして読むか、`Ctrl+O` を押してセッション内のすべての思考ブロックを展開または折りたたみます。詳細については、[拡張思考](/ja/model-config#extended-thinking)を参照してください。

101* **複数行入力**:`Shift+Enter` を押して送信せずに新しい行を追加します。これは質問ダイアログの'その他'フリーテキスト入力でも機能します。109* **複数行入力**:`Shift+Enter` を押して送信せずに新しい行を追加します。これは質問ダイアログの'その他'フリーテキスト入力でも機能します。

102 110 

103### ファイルとフォルダを参照する111<h3 id="reference-files-and-folders">

112 ファイルとフォルダを参照する

113</h3>

104 114 

105@-メンションを使用して、特定のファイルまたはフォルダに関するコンテキストを Claude に提供します。`@` の後にファイルまたはフォルダ名を入力すると、Claude はそのコンテンツを読み取り、それについて質問したり、変更を加えたりできます。Claude Code はあいまい一致をサポートしているため、部分的な名前を入力して必要なものを見つけることができます。115@-メンションを使用して、特定のファイルまたはフォルダに関するコンテキストを Claude に提供します。`@` の後にファイルまたはフォルダ名を入力すると、Claude はそのコンテンツを読み取り、それについて質問したり、変更を加えたりできます。Claude Code はあいまい一致をサポートしているため、部分的な名前を入力して必要なものを見つけることができます。

106 116 


115 125 

116また、`Shift` を押しながらファイルをプロンプトボックスにドラッグして、添付ファイルとして追加することもできます。任意の添付ファイルの X をクリックしてコンテキストから削除します。126また、`Shift` を押しながらファイルをプロンプトボックスにドラッグして、添付ファイルとして追加することもできます。任意の添付ファイルの X をクリックしてコンテキストから削除します。

117 127 

118### 過去の会話を再開する128<h3 id="resume-past-conversations">

129 過去の会話を再開する

130</h3>

119 131 

120Claude Code パネルの上部の **Session history** ボタンをクリックして、会話履歴にアクセスします。キーワードで検索するか、時間(今日、昨日、過去 7 日間など)で参照できます。任意の会話をクリックして、完全なメッセージ履歴で再開します。新しいセッションは、最初のメッセージに基づいて AI が生成したタイトルを受け取ります。セッションの上にマウスを置くと、名前変更と削除アクションが表示されます。説明的なタイトルを付けるために名前を変更するか、リストから削除するために削除します。セッションの再開の詳細については、[セッションの管理](/ja/sessions)を参照してください。132Claude Code パネルの上部の **Session history** ボタンをクリックして、会話履歴にアクセスします。キーワードで検索するか、時間(今日、昨日、過去 7 日間など)で参照できます。任意の会話をクリックして、完全なメッセージ履歴で再開します。新しいセッションは、最初のメッセージに基づいて AI が生成したタイトルを受け取ります。セッションの上にマウスを置くと、名前変更と削除アクションが表示されます。説明的なタイトルを付けるために名前を変更するか、リストから削除するために削除します。セッションの再開の詳細については、[セッションの管理](/ja/sessions)を参照してください。

121 133 

122### Claude.ai からリモートセッションを再開する134<h3 id="resume-cloud-sessions-from-claude-ai">

135 Claude.ai からリモートセッションを再開する

136</h3>

123 137 

124[Web 上の Claude Code](/ja/claude-code-on-the-web) を使用している場合、VS Code でそれらのリモートセッションを直接再開できます。これには、Anthropic Console ではなく **Claude.ai Subscription** でサインインする必要があります。138[Web 上の Claude Code](/ja/claude-code-on-the-web) を使用している場合、VS Code でそれらのリモートセッションを直接再開できます。これには、Anthropic Console ではなく **Claude.ai Subscription** でサインインする必要があります。

125 139 


141 リモートタブに表示されるのは、GitHub リポジトリで開始された Web セッションのみです。再開するとローカルに会話履歴が読み込まれます。変更は claude.ai に同期されません。155 リモートタブに表示されるのは、GitHub リポジトリで開始された Web セッションのみです。再開するとローカルに会話履歴が読み込まれます。変更は claude.ai に同期されません。

142</Note>156</Note>

143 157 

144## ワークフローをカスタマイズする158<h3 id="check-account-and-usage">

159 アカウントと使用状況を確認する

160</h3>

161 

162コマンドメニューから `/usage` を実行して、アカウント&使用状況ダイアログを開きます。サインインしているアカウント、プラン、および現在のセッションと週の使用状況バーが表示され、各制限がリセットされるまでの時間が示されます。

163 

164ダイアログは、プラン制限に寄与しているものを詳細に示します。キャッシュミス、長いコンテキスト、サブエージェント多用、または高度に並列化されたセッションなど、最近の使用状況の 10% 以上を占める動作にフラグを立て、それぞれを削減するためのヒントを提供します。属性テーブルは、各スキル、サブエージェント、プラグイン、MCP サーバーからどの程度の使用状況が発生したかを示します。Claude Code v2.1.174 以降が必要です。

165 

166Day と Week トグルを使用して、過去 24 時間と過去 7 日間を切り替えます。数値は概算であり、このマシン上のローカルセッションから計算されるため、他のデバイスまたは claude.ai からの使用状況は含まれません。使用状況の追跡と削減の詳細については、[コストを追跡する](/ja/costs#track-your-costs)を参照してください。

167 

168<h2 id="customize-your-workflow">

169 ワークフローをカスタマイズする

170</h2>

145 171 

146起動して実行したら、Claude パネルを再配置したり、複数のセッションを実行したり、ターミナルモードに切り替えたりできます。172起動して実行したら、Claude パネルを再配置したり、複数のセッションを実行したり、ターミナルモードに切り替えたりできます。

147 173 

148### Claude が存在する場所を選択する174<h3 id="choose-where-claude-lives">

175 Claude が存在する場所を選択する

176</h3>

149 177 

150Claude パネルをドラッグして、VS Code 内の任意の場所に再配置できます。パネルのタブまたはタイトルバーをつかんでドラッグします。178Claude パネルをドラッグして、VS Code 内の任意の場所に再配置できます。パネルのタブまたはタイトルバーをつかんでドラッグします。

151 179 


157 メイン Claude セッションにはサイドバーを使用し、サイドタスク用に追加のタブを開きます。Claude はお好みの場所を記憶しています。アクティビティバーセッションリストアイコンは Claude パネルとは別です。セッションリストは常にアクティビティバーに表示されますが、Claude パネルアイコンはパネルが左サイドバーにドッキングされている場合にのみそこに表示されます。185 メイン Claude セッションにはサイドバーを使用し、サイドタスク用に追加のタブを開きます。Claude はお好みの場所を記憶しています。アクティビティバーセッションリストアイコンは Claude パネルとは別です。セッションリストは常にアクティビティバーに表示されますが、Claude パネルアイコンはパネルが左サイドバーにドッキングされている場合にのみそこに表示されます。

158</Tip>186</Tip>

159 187 

160### 複数の会話を実行する188<h3 id="run-multiple-conversations">

189 複数の会話を実行する

190</h3>

161 191 

162コマンドパレットから **Open in New Tab** または **Open in New Window** を使用して、追加の会話を開始します。各会話は独自の履歴とコンテキストを保持し、異なるタスクで並行して作業できます。192コマンドパレットから **Open in New Tab** または **Open in New Window** を使用して、追加の会話を開始します。各会話は独自の履歴とコンテキストを保持し、異なるタスクで並行して作業できます。

163 193 

164タブを使用する場合、Spark アイコンの小さな色付きドットはステータスを示します。青は許可リクエストが保留中であることを意味し、オレンジはタブが非表示の間に Claude が完了したことを意味します。194タブを使用する場合、Spark アイコンの小さな色付きドットはステータスを示します。青は許可リクエストが保留中であることを意味し、オレンジはタブが非表示の間に Claude が完了したことを意味します。

165 195 

166### ターミナルモードに切り替える196<h3 id="switch-to-terminal-mode">

197 ターミナルモードに切り替える

198</h3>

167 199 

168デフォルトでは、拡張機能はグラフィカルチャットパネルを開きます。CLI スタイルのインターフェースを使用する場合は、[Use Terminal 設定](vscode://settings/claudeCode.useTerminal)を開いてボックスをチェックします。200デフォルトでは、拡張機能はグラフィカルチャットパネルを開きます。CLI スタイルのインターフェースを使用する場合は、[Use Terminal 設定](vscode://settings/claudeCode.useTerminal)を開いてボックスをチェックします。

169 201 

170VS Code 設定(Mac で `Cmd+,` または Windows/Linux で `Ctrl+,`)を開き、Extensions → Claude Code に移動して、**Use Terminal** をチェックすることもできます。202VS Code 設定(Mac で `Cmd+,` または Windows/Linux で `Ctrl+,`)を開き、Extensions → Claude Code に移動して、**Use Terminal** をチェックすることもできます。

171 203 

172## プラグインを管理する204<h2 id="manage-plugins">

205 プラグインを管理する

206</h2>

173 207 

174VS Code 拡張機能には、[プラグイン](/ja/plugins)をインストールおよび管理するためのグラフィカルインターフェースが含まれています。プロンプトボックスで `/plugins` と入力して、**Manage plugins** インターフェースを開きます。208VS Code 拡張機能には、[プラグイン](/ja/plugins)をインストールおよび管理するためのグラフィカルインターフェースが含まれています。プロンプトボックスで `/plugins` と入力して、**Manage plugins** インターフェースを開きます。

175 209 

176### プラグインをインストールする210<h3 id="install-plugins">

211 プラグインをインストールする

212</h3>

177 213 

178プラグインダイアログには 2 つのタブが表示されます。**Plugins** と **Marketplaces**。214プラグインダイアログには 2 つのタブが表示されます。**Plugins** と **Marketplaces**。

179 215 


190* **Install for this project**:プロジェクト協力者と共有(プロジェクトスコープ)226* **Install for this project**:プロジェクト協力者と共有(プロジェクトスコープ)

191* **Install locally**:このリポジトリでのみ、あなたのためだけ(ローカルスコープ)227* **Install locally**:このリポジトリでのみ、あなたのためだけ(ローカルスコープ)

192 228 

193### マーケットプレイスを管理する229<h3 id="manage-marketplaces">

230 マーケットプレイスを管理する

231</h3>

194 232 

195**Marketplaces** タブに切り替えて、プラグインソースを追加または削除します。233**Marketplaces** タブに切り替えて、プラグインソースを追加または削除します。

196 234 


206 244 

207プラグインシステムの詳細については、[Plugins](/ja/plugins) と [Plugin marketplaces](/ja/plugin-marketplaces) を参照してください。245プラグインシステムの詳細については、[Plugins](/ja/plugins) と [Plugin marketplaces](/ja/plugin-marketplaces) を参照してください。

208 246 

209## Chrome でブラウザタスクを自動化する247<h2 id="automate-browser-tasks-with-chrome">

248 Chrome でブラウザタスクを自動化する

249</h2>

210 250 

211Claude を Chrome ブラウザに接続して、Web アプリをテストし、コンソールログでデバッグし、VS Code を離れることなくブラウザワークフローを自動化します。これには、[Claude in Chrome extension](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) バージョン 1.0.36 以上が必要です。251Claude を Chrome ブラウザに接続して、Web アプリをテストし、コンソールログでデバッグし、VS Code を離れることなくブラウザワークフローを自動化します。これには、[Claude in Chrome extension](https://chromewebstore.google.com/detail/claude/fcoeoabgfenejglbffodgkkbkcdhcgfn) バージョン 1.0.36 以上が必要です。

212 252 


222 262 

223セットアップ手順、機能の完全なリスト、トラブルシューティングについては、[Use Claude Code with Chrome](/ja/chrome) を参照してください。263セットアップ手順、機能の完全なリスト、トラブルシューティングについては、[Use Claude Code with Chrome](/ja/chrome) を参照してください。

224 264 

225## VS Code コマンドとショートカット265<h2 id="vs-code-commands-and-shortcuts">

266 VS Code コマンドとショートカット

267</h2>

226 268 

227コマンドパレット(Mac で `Cmd+Shift+P` または Windows/Linux で `Ctrl+Shift+P`)を開き、「Claude Code」と入力して、Claude Code 拡張機能で利用可能なすべての VS Code コマンドを表示します。269コマンドパレット(Mac で `Cmd+Shift+P` または Windows/Linux で `Ctrl+Shift+P`)を開き、「Claude Code」と入力して、Claude Code 拡張機能で利用可能なすべての VS Code コマンドを表示します。

228 270 


245| Show Logs | - | 拡張機能デバッグログを表示します |287| Show Logs | - | 拡張機能デバッグログを表示します |

246| Logout | - | Anthropic アカウントからサインアウトします |288| Logout | - | Anthropic アカウントからサインアウトします |

247 289 

248### 他のツールから VS Code タブを起動する290<h3 id="launch-a-vs-code-tab-from-other-tools">

291 他のツールから VS Code タブを起動する

292</h3>

249 293 

250拡張機能は `vscode://anthropic.claude-code/open` で URI ハンドラーを登録します。これを使用して、独自のツーリングから新しい Claude Code タブを開きます。シェルエイリアス、ブラウザブックマークレット、または URL を開くことができるスクリプトです。VS Code がまだ実行されていない場合、URL を開くと最初に起動します。VS Code が既に実行されている場合、URL は現在フォーカスされているウィンドウで開きます。294拡張機能は `vscode://anthropic.claude-code/open` で URI ハンドラーを登録します。これを使用して、独自のツーリングから新しい Claude Code タブを開きます。シェルエイリアス、ブラウザブックマークレット、または URL を開くことができるスクリプトです。VS Code がまだ実行されていない場合、URL を開くと最初に起動します。VS Code が既に実行されている場合、URL は現在フォーカスされているウィンドウで開きます。

251 295 


294 338 

295ターミナルセッションを VS Code タブの代わりに起動するには、CLI の `claude-cli://` ハンドラーを使用します。[Launch sessions from links](/ja/deep-links) を参照してください。339ターミナルセッションを VS Code タブの代わりに起動するには、CLI の `claude-cli://` ハンドラーを使用します。[Launch sessions from links](/ja/deep-links) を参照してください。

296 340 

297## 設定を構成する341<h2 id="configure-settings">

342 設定を構成する

343</h2>

298 344 

299拡張機能には 2 種類の設定があります。345拡張機能には 2 種類の設定があります。

300 346 


305 `"$schema": "https://json.schemastore.org/claude-code-settings.json"` を `settings.json` に追加して、VS Code で利用可能なすべての設定のオートコンプリートとインライン検証を取得します。351 `"$schema": "https://json.schemastore.org/claude-code-settings.json"` を `settings.json` に追加して、VS Code で利用可能なすべての設定のオートコンプリートとインライン検証を取得します。

306</Tip>352</Tip>

307 353 

308### 拡張機能設定354<h3 id="extension-settings">

355 拡張機能設定

356</h3>

309 357 

310| 設定 | デフォルト | 説明 |358| 設定 | デフォルト | 説明 |

311| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------ |359| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------ |


324| `allowDangerouslySkipPermissions` | `false` | モード選択ツールに Bypass permissions を追加します。インターネットアクセスのないサンドボックスでのみ使用してください。 |372| `allowDangerouslySkipPermissions` | `false` | モード選択ツールに Bypass permissions を追加します。インターネットアクセスのないサンドボックスでのみ使用してください。 |

325| `claudeProcessWrapper` | - | Claude プロセスを起動するために使用される実行可能ファイル。バンドルされたバイナリパスは、存在する場合は引数として渡されます。拡張機能ビルドにプラットフォーム用のバイナリが含まれていない場合は、これを別途インストールされた `claude` バイナリに設定します。 |373| `claudeProcessWrapper` | - | Claude プロセスを起動するために使用される実行可能ファイル。バンドルされたバイナリパスは、存在する場合は引数として渡されます。拡張機能ビルドにプラットフォーム用のバイナリが含まれていない場合は、これを別途インストールされた `claude` バイナリに設定します。 |

326 374 

327## VS Code 拡張機能と Claude Code CLI375<h2 id="vs-code-extension-vs-claude-code-cli">

376 VS Code 拡張機能と Claude Code CLI

377</h2>

328 378 

329Claude Code は VS Code 拡張機能(グラフィカルパネル)と CLI(ターミナルのコマンドラインインターフェース)の両方として利用可能です。一部の機能は CLI でのみ利用可能です。CLI のみの機能が必要な場合は、VS Code の統合ターミナルで `claude` を実行します。379Claude Code は VS Code 拡張機能(グラフィカルパネル)と CLI(ターミナルのコマンドラインインターフェース)の両方として利用可能です。一部の機能は CLI でのみ利用可能です。CLI のみの機能が必要な場合は、VS Code の統合ターミナルで `claude` を実行します。これには[スタンドアロン CLI インストール](/ja/setup)が必要です。拡張機能は `claude` を PATH に追加しません。[VS Code で CLI を実行する](#run-cli-in-vs-code)を参照してください。

330 380 

331| 機能 | CLI | VS Code 拡張機能 |381| 機能 | CLI | VS Code 拡張機能 |

332| ---------------- | ------------------- | --------------------------------------------------- |382| ---------------- | ------------------- | --------------------------------------------------- |


336| `!` bash ショートカット | はい | いいえ |386| `!` bash ショートカット | はい | いいえ |

337| タブ補完 | はい | いいえ |387| タブ補完 | はい | いいえ |

338 388 

339### チェックポイントで巻き戻す389<h3 id="rewind-with-checkpoints">

390 チェックポイントで巻き戻す

391</h3>

340 392 

341VS Code 拡張機能はチェックポイントをサポートしており、Claude のファイル編集を追跡し、以前の状態に巻き戻すことができます。任意のメッセージの上にマウスを置いて巻き戻しボタンを表示し、3 つのオプションから選択します。393VS Code 拡張機能はチェックポイントをサポートしており、Claude のファイル編集を追跡し、以前の状態に巻き戻すことができます。任意のメッセージの上にマウスを置いて巻き戻しボタンを表示し、3 つのオプションから選択します。

342 394 

343* **Fork conversation from here**:このメッセージからの新しい会話ブランチを開始し、すべてのコード変更をそのまま保持します。395* **ここから会話をフォークする**:このメッセージからの新しい会話ブランチを開始し、すべてのコード変更をそのまま保持します。

344* **Rewind code to here**:会話の完全な履歴を保持しながら、ファイル変更をこのポイントに戻します。396* **ここにコードを巻き戻す**:会話の完全な履歴を保持しながら、ファイル変更をこのポイントに戻します。

345* **Fork conversation and rewind code**:新しい会話ブランチを開始し、ファイル変更をこのポイントに戻します。397* **会話をフォークしてコードを巻き戻す**:新しい会話ブランチを開始し、ファイル変更をこのポイントに戻します。

346 398 

347チェックポイントの仕組みと制限の詳細については、[Checkpointing](/ja/checkpointing) を参照してください。399チェックポイントの仕組みと制限の詳細については、[Checkpointing](/ja/checkpointing) を参照してください。

348 400 

349### VS Code で CLI を実行する401<h3 id="run-cli-in-vs-code">

402 VS Code で CLI を実行する

403</h3>

350 404 

351VS Code に留まりながら CLI を使用するには、統合ターミナル(Windows/Linux で `` Ctrl+` `` または Mac で `` Cmd+` ``)を開き、`claude` を実行します。CLI は自動的に IDE と統合され、差分表示や診断共有などの機能を提供します。405VS Code に留まりながら CLI を使用するには、統合ターミナル(Windows/Linux で `` Ctrl+` `` または Mac で `` Cmd+` ``)を開き、`claude` を実行します。CLI は自動的に IDE と統合され、差分表示や診断共有などの機能を提供します。

352 406 

407拡張機能をインストールしても、`claude` はシェルの PATH に追加されません。拡張機能はチャットパネル用に CLI のプライベートコピーをバンドルしていますが、ターミナルで `claude` と入力するには[スタンドアロン CLI インストール](/ja/setup)が必要です。インストールを 1 回実行すると、`claude mcp add` や `claude --resume` を含むこのページのコマンドが任意のターミナルで機能します。インストール後も `claude` が見つからない場合は、[PATH を確認してください](/ja/troubleshoot-install#verify-your-path)。

408 

353外部ターミナルを使用している場合は、Claude Code 内で `/ide` を実行して VS Code に接続します。409外部ターミナルを使用している場合は、Claude Code 内で `/ide` を実行して VS Code に接続します。

354 410 

355### 拡張機能と CLI を切り替える411<h3 id="switch-between-extension-and-cli">

412 拡張機能と CLI を切り替える

413</h3>

356 414 

357拡張機能と CLI は同じ会話履歴を共有します。拡張機能の会話を CLI で続行するには、ターミナルで `claude --resume` を実行します。これにより、会話を検索して選択できるインタラクティブピッカーが開きます。415拡張機能と CLI は同じ会話履歴を共有します。拡張機能の会話を CLI で続行するには、ターミナルで `claude --resume` を実行します。これにより、会話を検索して選択できるインタラクティブピッカーが開きます。

358 416 

359### プロンプトにターミナル出力を含める417<h3 id="include-terminal-output-in-prompts">

418 プロンプトにターミナル出力を含める

419</h3>

360 420 

361プロンプトで `@terminal:name` を使用してターミナル出力を参照します。ここで `name` はターミナルのタイトルです。これにより、Claude はコマンド出力、エラーメッセージ、またはログをコピーペーストせずに表示できます。421プロンプトで `@terminal:name` を使用してターミナル出力を参照します。ここで `name` はターミナルのタイトルです。これにより、Claude はコマンド出力、エラーメッセージ、またはログをコピーペーストせずに表示できます。

362 422 

363### バックグラウンドプロセスを監視する423<h3 id="monitor-background-processes">

424 バックグラウンドプロセスを監視する

425</h3>

364 426 

365Claude が長時間実行されるコマンドを実行すると、拡張機能はステータスバーに進行状況を表示します。ただし、バックグラウンドタスクの可視性は CLI と比較して制限されています。より良い可視性のために、Claude にコマンドを出力させて、VS Code の統合ターミナルで実行できるようにします。427Claude が長時間実行されるコマンドを実行すると、拡張機能はステータスバーに進行状況を表示します。ただし、バックグラウンドタスクの可視性は CLI と比較して制限されています。より良い可視性のために、Claude にコマンドを出力させて、VS Code の統合ターミナルで実行できるようにします。

366 428 

367### MCP で外部ツールに接続する429<h3 id="connect-to-external-tools-with-mcp">

430 MCP で外部ツールに接続する

431</h3>

368 432 

369MCP(Model Context Protocol)サーバーは Claude に外部ツール、データベース、API へのアクセスを提供します。433MCP(Model Context Protocol)サーバーは Claude に外部ツール、データベース、API へのアクセスを提供します。

370 434 


379 443 

380VS Code を離れることなく MCP サーバーを管理するには、チャットパネルで `/mcp` と入力します。MCP 管理ダイアログでは、サーバーを有効または無効にし、サーバーに再接続し、OAuth 認証を管理できます。利用可能なサーバーについては、[MCP documentation](/ja/mcp) を参照してください。444VS Code を離れることなく MCP サーバーを管理するには、チャットパネルで `/mcp` と入力します。MCP 管理ダイアログでは、サーバーを有効または無効にし、サーバーに再接続し、OAuth 認証を管理できます。利用可能なサーバーについては、[MCP documentation](/ja/mcp) を参照してください。

381 445 

382## git で作業する446<h2 id="work-with-git">

447 git で作業する

448</h2>

383 449 

384Claude Code は git と統合され、VS Code でバージョン管理ワークフローを直接支援します。Claude にコミット変更、プルリクエスト作成、またはブランチ間での作業を依頼します。450Claude Code は git と統合され、VS Code でバージョン管理ワークフローを直接支援します。Claude にコミット変更、プルリクエスト作成、またはブランチ間での作業を依頼します。

385 451 

386### コミットとプルリクエストを作成する452<h3 id="create-commits-and-pull-requests">

453 コミットとプルリクエストを作成する

454</h3>

387 455 

388Claude はコミットをステージング、コミットメッセージを作成、作業に基づいてプルリクエストを作成できます。456Claude はコミットをステージング、コミットメッセージを作成、作業に基づいてプルリクエストを作成できます。

389 457 


395 463 

396プルリクエストを作成するときに、Claude は実際のコード変更に基づいて説明を生成し、テストまたは実装の決定についてのコンテキストを追加できます。464プルリクエストを作成するときに、Claude は実際のコード変更に基づいて説明を生成し、テストまたは実装の決定についてのコンテキストを追加できます。

397 465 

398### 並列タスク用に git worktrees を使用する466<h3 id="use-git-worktrees-for-parallel-tasks">

467 並列タスク用に git worktrees を使用する

468</h3>

399 469 

400`--worktree`(`-w`)フラグを使用して、独自のファイルとブランチを持つ分離された worktree で Claude を開始します。470`--worktree`(`-w`)フラグを使用して、独自のファイルとブランチを持つ分離された worktree で Claude を開始します。

401 471 


405 475 

406各 worktree は git 履歴を共有しながら独立したファイル状態を保持します。これにより、異なるタスクで作業するときに Claude インスタンスが互いに干渉するのを防ぎます。詳細については、[Git worktrees で並列セッションを実行する](/ja/worktrees) を参照してください。476各 worktree は git 履歴を共有しながら独立したファイル状態を保持します。これにより、異なるタスクで作業するときに Claude インスタンスが互いに干渉するのを防ぎます。詳細については、[Git worktrees で並列セッションを実行する](/ja/worktrees) を参照してください。

407 477 

408## サードパーティプロバイダーを使用する478<h2 id="use-third-party-providers">

479 サードパーティプロバイダーを使用する

480</h2>

409 481 

410デフォルトでは、Claude Code は Anthropic の API に直接接続します。組織が Amazon Bedrock、Google Vertex AI、または Microsoft Foundry を使用して Claude にアクセスする場合は、代わりにプロバイダーを使用するように拡張機能を設定します。482デフォルトでは、Claude Code は Anthropic の API に直接接続します。組織が Amazon Bedrock、Google Vertex AI、または Microsoft Foundry を使用して Claude にアクセスする場合は、代わりにプロバイダーを使用するように拡張機能を設定します。

411 483 


427 </Step>499 </Step>

428</Steps>500</Steps>

429 501 

430## セキュリティとプライバシー502<h2 id="security-and-privacy">

503 セキュリティとプライバシー

504</h2>

431 505 

432コードはプライベートのままです。Claude Code はコード支援を提供するためにコードを処理しますが、モデルのトレーニングには使用しません。データ処理とログアウトの方法の詳細については、[Data and privacy](/ja/data-usage) を参照してください。506コードはプライベートのままです。Claude Code はコード支援を提供するためにコードを処理しますが、モデルのトレーニングには使用しません。データ処理とログアウトの方法の詳細については、[Data and privacy](/ja/data-usage) を参照してください。

433 507 


437* 編集の自動受け入れの代わりに手動承認モードを使用します511* 編集の自動受け入れの代わりに手動承認モードを使用します

438* 変更を受け入れる前に慎重に確認します512* 変更を受け入れる前に慎重に確認します

439 513 

440### 組み込み IDE MCP サーバー514<h3 id="the-built-in-ide-mcp-server">

515 組み込み IDE MCP サーバー

516</h3>

441 517 

442拡張機能がアクティブな場合、CLI が自動的に接続するローカル MCP サーバーを実行します。これは、CLI が VS Code のネイティブ差分ビューアで差分を開く方法、`@`-メンション用に現在の選択を読む方法、および Jupyter ノートブックで作業しているときに VS Code にセルを実行するよう依頼する方法です。518拡張機能がアクティブな場合、CLI が自動的に接続するローカル MCP サーバーを実行します。これは、CLI が VS Code のネイティブ差分ビューアで差分を開く方法、`@`-メンション用に現在の選択を読む方法、および Jupyter ノートブックで作業しているときに VS Code にセルを実行するよう依頼する方法です。

443 519 


462 538 

463<a id="troubleshooting" />539<a id="troubleshooting" />

464 540 

465## 一般的な問題を修正する541<h2 id="fix-common-issues">

542 一般的な問題を修正する

543</h2>

466 544 

467### 拡張機能がインストールされない545<h3 id="extension-won’t-install">

546 拡張機能がインストールされない

547</h3>

468 548 

469* VS Code の互換バージョン(1.98.0 以上)があることを確認してください549* VS Code の互換バージョン(1.98.0 以上)があることを確認してください

470* VS Code に拡張機能をインストールする権限があることを確認してください550* VS Code に拡張機能をインストールする権限があることを確認してください

471* [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) から直接インストールしてみてください551* [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code) から直接インストールしてみてください

472 552 

473### Spark アイコンが表示されない553<h3 id="spark-icon-not-visible">

554 Spark アイコンが表示されない

555</h3>

474 556 

475Spark アイコンは、ファイルを開いている場合、**エディタツールバー**(エディタの右上)に表示されます。表示されない場合:557Spark アイコンは、ファイルを開いている場合、**エディタツールバー**(エディタの右上)に表示されます。表示されない場合:

476 558 


482 564 

483または、**ステータスバー**(右下隅)の「✱ Claude Code」をクリックしてください。これはファイルを開かなくても機能します。**コマンドパレット**(`Cmd+Shift+P` / `Ctrl+Shift+P`)を使用して「Claude Code」と入力することもできます。565または、**ステータスバー**(右下隅)の「✱ Claude Code」をクリックしてください。これはファイルを開かなくても機能します。**コマンドパレット**(`Cmd+Shift+P` / `Ctrl+Shift+P`)を使用して「Claude Code」と入力することもできます。

484 566 

485### macOS で Cmd+Esc が機能しない567<h3 id="cmd-esc-does-nothing-on-macos">

568 macOS で Cmd+Esc が機能しない

569</h3>

486 570 

487macOS Tahoe 以降では、システムのゲームオーバーレイショートカットがデフォルトで `Cmd+Esc` にバインドされており、キープレスが VS Code に到達する前に傍受されます。ショートカットを解放するには:571macOS Tahoe 以降では、システムのゲームオーバーレイショートカットがデフォルトで `Cmd+Esc` にバインドされており、キープレスが VS Code に到達する前に傍受されます。ショートカットを解放するには:

488 572 


492 576 

493または、拡張機能を別のキーに再バインドしてください:VS Code の [キーボードショートカットエディタ](https://code.visualstudio.com/docs/configure/keybindings)(`Cmd+K Cmd+S`)を開き、`Claude Code: Focus input` を検索して、新しいバインディングを割り当ててください。577または、拡張機能を別のキーに再バインドしてください:VS Code の [キーボードショートカットエディタ](https://code.visualstudio.com/docs/configure/keybindings)(`Cmd+K Cmd+S`)を開き、`Claude Code: Focus input` を検索して、新しいバインディングを割り当ててください。

494 578 

495### Claude Code が応答しない579<h3 id="claude-code-never-responds">

580 Claude Code が応答しない

581</h3>

496 582 

497Claude Code がプロンプトに応答しない場合:583Claude Code がプロンプトに応答しない場合:

498 584 


502 588 

503問題が続く場合は、エラーの詳細を含めて [GitHub で問題を報告](https://github.com/anthropics/claude-code/issues)してください。589問題が続く場合は、エラーの詳細を含めて [GitHub で問題を報告](https://github.com/anthropics/claude-code/issues)してください。

504 590 

505## 拡張機能をアンインストールする591<h2 id="uninstall-the-extension">

592 拡張機能をアンインストールする

593</h2>

506 594 

507Claude Code 拡張機能をアンインストールするには:595Claude Code 拡張機能をアンインストールするには:

508 596 

5091. 拡張機能ビューを開きます(Mac で `Cmd+Shift+X` または Windows/Linux で `Ctrl+Shift+X`)5971. 拡張機能ビューを開きます(Mac で `Cmd+Shift+X` または Windows/Linux で `Ctrl+Shift+X`)

5102. 「Claude Code」を検索します5982. 「Claude Code」を検索します

5113. **Uninstall** をクリックします5993. **Uninstall** をクリックします

600 

601拡張機能データを削除してすべての設定をリセットするには、プラットフォーム用の拡張機能のストレージディレクトリを削除します。

512 602 

513拡張機能データを削除してすべての設定をリセットするには603macOS の場合

514 604 

515```bash theme={null}605```bash theme={null}

516rm -rf ~/.vscode/globalStorage/anthropic.claude-code606rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

607```

608 

609Linux の場合:

610 

611```bash theme={null}

612rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

613```

614 

615Windows の場合(PowerShell):

616 

617```powershell theme={null}

618Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

517```619```

518 620 

519追加のヘルプについては、[troubleshooting guide](/ja/troubleshooting) を参照してください。621追加のヘルプについては、[トラブルシューティングガイド](/ja/troubleshooting)を参照してください。

520 622 

521## 次のステップ623<h2 id="next-steps">

624 次のステップ

625</h2>

522 626 

523VS Code で Claude Code をセットアップしたので:627VS Code で Claude Code をセットアップしたので:

524 628 

Details

49| **Uses your local config** | No, repo only | Yes | Yes | Yes for local, no for cloud |49| **Uses your local config** | No, repo only | Yes | Yes | Yes for local, no for cloud |

50| **Requires GitHub** | Yes, or [bundle a local repo](/ja/claude-code-on-the-web#send-local-repositories-without-github) via `--remote` | No | No | Only for cloud sessions |50| **Requires GitHub** | Yes, or [bundle a local repo](/ja/claude-code-on-the-web#send-local-repositories-without-github) via `--remote` | No | No | Only for cloud sessions |

51| **Keeps running if you disconnect** | Yes | While terminal stays open | No | Depends on session type |51| **Keeps running if you disconnect** | Yes | While terminal stays open | No | Depends on session type |

52| **[Permission modes](/ja/permission-modes)** | Auto accept edits, Plan | Ask, Auto accept edits, Plan | All modes | Depends on session type |52| **[Permission modes](/ja/permission-modes)** | Accept edits, Plan, Auto | Ask, Auto accept edits, Plan | All modes | Depends on session type |

53| **Network access** | Configurable per environment | Your machine's network | Your machine's network | Depends on session type |53| **Network access** | Configurable per environment | Your machine's network | Your machine's network | Depends on session type |

54 54 

55[terminal quickstart](/ja/quickstart)、[Desktop app](/ja/desktop)、または [Remote Control](/ja/remote-control) ドキュメントを参照して、それらをセットアップしてください。55[terminal quickstart](/ja/quickstart)、[Desktop app](/ja/desktop)、または [Remote Control](/ja/remote-control) ドキュメントを参照して、それらをセットアップしてください。


129 </Step>129 </Step>

130 130 

131 <Step title="permission mode を選択">131 <Step title="permission mode を選択">

132 入力の横の mode ドロップダウンは、デフォルトで **Auto accept edits** で、Claude は承認を待たずに変更を加えてブランチをプッシュします。Claude がアプローチを提案し、ファイルを編集する前にあなたの許可を待つようにしたい場合は、**Plan mode** に切り替えます。Cloud セッションは Ask permissions、Auto mode、または Bypass permissions を提供しません。完全なリストについては [Permission modes](/ja/permission-modes) を参照してください。132 入力の横の mode ドロップダウンは、デフォルトで **Accept edits** で、Claude は承認を待たずに変更を加えてブランチをプッシュします。Claude がアプローチを提案し、ファイルを編集する前にあなたの許可を待つようにしたい場合は、**Plan Mode** に切り替えます。Cloud セッションは Ask permissions または Bypass permissions を提供しません。完全なリストについては [Permission modes](/ja/permission-modes) を参照してください。

133 </Step>133 </Step>

134 134 

135 <Step title="タスクを説明して送信">135 <Step title="タスクを説明して送信">


174 </Step>174 </Step>

175 175 

176 <Step title="インラインコメントを残す">176 <Step title="インラインコメントを残す">

177 diff 内の任意の行を選択し、フィードバックを入力して Enter キーを押します。コメントは次のメッセージを送信するまでキューに入り、その後バンドルされます。Claude は'at `src/auth.ts:47`, don't catch the error here'をメインの指示と一緒に見るため、問題がどこにあるかを説明する必要はありません。177 diff 内の任意の行を選択し、フィードバックを入力して Enter キーを押します。コメントは次のメッセージを送信するまでキューに入り、その後バンドルされます。Claude は'`src/auth.ts:47` で、ここでエラーをキャッチしないでください'をメインの指示と一緒に見るため、問題がどこにあるかを説明する必要はありません。

178 </Step>178 </Step>

179 179 

180 <Step title="pull request を作成">180 <Step title="pull request を作成">

whats-new.md +16 −0

Details

8 8 

9週間開発ダイジェストは、あなたの仕事のやり方を変える可能性が最も高い機能をハイライトします。各エントリには実行可能なコード、短いデモ、および完全なドキュメントへのリンクが含まれています。すべてのバグ修正と軽微な改善については、[changelog](/ja/changelog) を参照してください。9週間開発ダイジェストは、あなたの仕事のやり方を変える可能性が最も高い機能をハイライトします。各エントリには実行可能なコード、短いデモ、および完全なドキュメントへのリンクが含まれています。すべてのバグ修正と軽微な改善については、[changelog](/ja/changelog) を参照してください。

10 10 

11<Update label="Week 24" description="June 8–12, 2026" tags={["v2.1.166–v2.1.176"]}>

12 **`/cd`**:プロンプトキャッシュを再構築することなく、会話の途中で現在のセッションを新しい作業ディレクトリに移動します。

13 

14 今週のその他の機能:**サブエージェントは独自のサブエージェントを生成できます**(バックグラウンドチェーンは 5 レベルの深さでキャップされています)。**`--safe-mode`** はすべてのカスタマイズを無効にした状態で Claude Code を起動してトラブルシューティングを行います。**`fallbackModel`** は順番に試される最大 3 つのフォールバックモデルを設定します。

15 

16 [Week 24 ダイジェストを読む →](/ja/whats-new/2026-w24)

17</Update>

18 

19<Update label="Week 23" description="June 1–5, 2026" tags={["v2.1.158–v2.1.165"]}>

20 **Bedrock、Vertex、Foundry での Auto mode**:auto mode は Opus 4.7 および Opus 4.8 のサードパーティプロバイダーで利用可能になり、許可プロンプトをバックグラウンド安全チェックに置き換えます。

21 

22 今週のその他の機能:**より安全な自動編集** は `acceptEdits` モードでコードを実行できるファイルを書き込む前にプロンプトを表示します。**`/plugin list`** はインストール済みプラグインをインラインで出力します。**バージョン要件** により、マネージドデプロイメントは承認された Claude Code バージョン範囲を要求できます。

23 

24 [Week 23 ダイジェストを読む →](/ja/whats-new/2026-w23)

25</Update>

26 

11<Update label="Week 22" description="May 25–29, 2026" tags={["v2.1.150–v2.1.157"]}>27<Update label="Week 22" description="May 25–29, 2026" tags={["v2.1.150–v2.1.157"]}>

12 **Claude Opus 4.8**:Max、Team Premium、Enterprise 従量課金制、および Anthropic API アカウント向けの新しいデフォルトモデル。デフォルトで高いエフォートレベルを備え、最も難しいタスク向けに `/effort xhigh` をサポートしています。28 **Claude Opus 4.8**:Max、Team Premium、Enterprise 従量課金制、および Anthropic API アカウント向けの新しいデフォルトモデル。デフォルトで高いエフォートレベルを備え、最も難しいタスク向けに `/effort xhigh` をサポートしています。

13 29 

whats-new/2026-w23.md +100 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Week 23 · 2026 年 6 月 1 日~5 日

6 

7> Bedrock、Vertex、Foundry で auto mode を実行し、acceptEdits モードでコードを実行できるファイルを書き込む前にプロンプトを表示し、/plugin list でインストール済みプラグインをリストアップし、マネージドデプロイメント向けに承認されたバージョン範囲を要求します。

8 

9<div className="digest-meta">

10 <span>Releases <a href="/ja/docs/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>

11 <span>4 features · 6 月 1 日~5 日</span>

12</div>

13 

14<div className="digest-feature">

15 <div className="digest-feature-header">

16 <span className="digest-feature-title">Bedrock、Vertex、Foundry での Auto mode</span>

17 <span className="digest-feature-pill">v2.1.158</span>

18 </div>

19 

20 <p className="digest-feature-lede">Auto mode は Opus 4.7 および Opus 4.8 向けに Bedrock、Vertex、Foundry で利用可能になり、パーミッションプロンプトをサードパーティプロバイダー上のバックグラウンドセーフティチェックに置き換えます。<code>CLAUDE\_CODE\_ENABLE\_AUTO\_MODE=1</code> を設定してオプトインしてください。</p>

21 

22 <p className="digest-feature-try">サードパーティプロバイダーでオプトインし、Shift+Tab で auto mode に切り替えます:</p>

23 

24 ```bash terminal theme={null}

25 export CLAUDE_CODE_ENABLE_AUTO_MODE=1

26 ```

27 

28 <a className="digest-feature-link" href="/ja/docs/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry">サードパーティプロバイダーで auto mode を有効にする</a>

29</div>

30 

31<div className="digest-feature">

32 <div className="digest-feature-header">

33 <span className="digest-feature-title">より安全な自動編集</span>

34 <span className="digest-feature-pill">v2.1.160</span>

35 </div>

36 

37 <p className="digest-feature-lede">Claude Code は <code>acceptEdits</code> モードでもコードを実行できるファイルを書き込む前にプロンプトを表示するようになりました。保護対象セットには <code>.zshenv</code> や <code>.bash\_login</code> などのシェルスタートアップファイル、<code>\~/.config/git/</code> 下の git config、および <code>.npmrc</code>、<code>.bazelrc</code>、<code>.pre-commit-config.yaml</code> などのビルドツール設定が含まれます。これらの書き込みは <code>bypassPermissions</code> を除くどのモードでも自動承認されることはありません。</p>

38 

39 <p className="digest-feature-try">acceptEdits モードで作業します。Claude はこれらのファイルを書き込む前に一時停止するようになりました:</p>

40 

41 ```bash terminal theme={null}

42 claude --permission-mode acceptEdits

43 ```

44 

45 <a className="digest-feature-link" href="/ja/docs/permission-modes#protected-paths">保護されたパス</a>

46</div>

47 

48<div className="digest-feature">

49 <div className="digest-feature-header">

50 <span className="digest-feature-title">/plugin list でインストール済みプラグインをリストアップ</span>

51 <span className="digest-feature-pill">v2.1.163</span>

52 </div>

53 

54 <p className="digest-feature-lede">新しい <code>/plugin list</code> コマンドは、<code>/plugin</code> メニューを開かずにインストール済みプラグインをインラインで出力し、シェルから <code>claude plugin list</code> としても利用可能です。対話形式では、`--enabled` または `--disabled` を追加して、その状態のプラグインのみを表示します。</p>

55 

56 <p className="digest-feature-try">現在有効になっているプラグインをリストアップします:</p>

57 

58 ```text Claude Code theme={null}

59 > /plugin list --enabled

60 ```

61 

62 <a className="digest-feature-link" href="/ja/docs/plugins-reference#plugin-list">プラグインコマンド</a>

63</div>

64 

65<div className="digest-feature">

66 <div className="digest-feature-header">

67 <span className="digest-feature-title">マネージドデプロイメント向けバージョン要件</span>

68 <span className="digest-feature-pill">v2.1.163</span>

69 </div>

70 

71 <p className="digest-feature-lede">2 つのマネージド設定 <code>requiredMinimumVersion</code> と <code>requiredMaximumVersion</code> により、組織は承認された Claude Code バージョン範囲を要求できます。範囲外のクライアントはスタートアップ時に終了し、ユーザーに組織の方法を通じて更新するよう指示します。<code>claude update</code>、<code>claude install</code>、<code>claude doctor</code> は引き続き機能するため、ユーザーは復旧できます。</p>

72 

73 <p className="digest-feature-try">マネージド設定に下限を追加して、古いクライアントが起動を拒否するようにします:</p>

74 

75 ```json managed-settings.json theme={null}

76 "requiredMinimumVersion": "2.1.163"

77 ```

78 

79 <a className="digest-feature-link" href="/ja/docs/admin-setup#decide-what-to-enforce">実施内容を決定する</a>

80</div>

81 

82<div className="digest-wins">

83 <p className="digest-wins-title">その他の改善</p>

84 

85 <div className="digest-wins-grid">

86 <div><a href="/ja/docs/workflows">動的ワークフロー</a>のトリガーキーワードが <code>workflow</code> から <code>ultracode</code> に変更されました。自分の言葉でワークフローをリクエストすることはまだ機能し、キーワードはプロンプトで紫色でハイライトされます</div>

87 <div><a href="/ja/docs/hooks">Stop および SubagentStop hooks</a> は <code>hookSpecificOutput.additionalContext</code> を返して Claude にフィードバックを提供し、エラーとして扱われるのではなく、ターンを続行できます</div>

88 <div><code>claude mcp</code> list、get、add はシークレットを出力しなくなりました。環境変数参照は展開されず、認証情報ヘッダーと URL シークレットは編集されます</div>

89 <div>並列ツールバッチ内の失敗した Bash コマンドは、他のコマンドをキャンセルしなくなりました。各ツールは独立して独自の結果を返します</div>

90 <div>単一ファイルの <code>grep</code>、<code>egrep</code>、または <code>fgrep</code> で表示した場合、ファイルを編集するために別の Read は不要になりました</div>

91 <div>オートコンプリートメニューのコマンドをクリックすると、すぐに実行するのではなく、プロンプトに入力されるようになりました。Enter キーを押して実行します</div>

92 <div>`--tools` に <code>Grep</code> または <code>Glob</code> をリストアップすると、埋め込み検索を備えたネイティブビルドで専用検索ツールが提供されるようになり、これらの名前を静かに無視することはなくなりました</div>

93 <div><code>/effort</code> は、選択したレベルが新しいセッションのデフォルトとして保持されることを確認するようになりました</div>

94 <div><code>OTEL\_RESOURCE\_ATTRIBUTES</code> 値はメトリックデータポイントのラベルとして添付されるようになり、チームやリポジトリなどのカスタムディメンションで使用メトリクスをスライスできます</div>

95 <div>Windsurf は <code>/ide</code>、<code>/terminal-setup</code>、<code>/scroll-speed</code> で Devin Desktop に名前変更されました。エディターのリブランドに従っています</div>

96 <div><code>/btw</code> は、生の markdown 回答をクリップボードにコピーする <code>c to copy</code> ショートカットを獲得しました</div>

97 </div>

98</div>

99 

100[v2.1.158–v2.1.165 の完全なチェンジログ →](/ja/changelog#2-1-158)

whats-new/2026-w24.md +84 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Week 24 · 2026年6月8日~12日

6 

7> /cd でセッションを新しいディレクトリに移動し、サブエージェントが独自のサブエージェントをスポーンでき、セーフモードで壊れた設定をトラブルシューティングします。

8 

9<div className="digest-meta">

10 <span>リリース <a href="/ja/docs/changelog#2-1-166">v2.1.166 → v2.1.176</a></span>

11 <span>3 つの機能 · 6月8日~12日</span>

12</div>

13 

14<div className="digest-feature">

15 <div className="digest-feature-header">

16 <span className="digest-feature-title">/cd でセッションを移動</span>

17 <span className="digest-feature-pill">v2.1.169</span>

18 </div>

19 

20 <p className="digest-feature-lede">新しい <code>/cd</code> コマンドは、プロンプトキャッシュを再構築することなく、現在のセッションを別の作業ディレクトリに移動します。新しいディレクトリの <code>CLAUDE.md</code> はシステムプロンプトを置き換えるのではなく、メッセージとして追加されます。セッションは新しいディレクトリのプロジェクトストレージに再配置されるため、`--resume` と `--continue` はそこで見つかります。以前そのディレクトリで作業していない場合、Claude はディレクトリを信頼するよう促します。</p>

21 

22 <p className="digest-feature-try">セッションを再起動せずに別のプロジェクトに移動します:</p>

23 

24 ```text Claude Code theme={null}

25 > /cd ../other-project

26 ```

27 

28 <a className="digest-feature-link" href="/ja/docs/commands#all-commands">コマンドリファレンス</a>

29</div>

30 

31<div className="digest-feature">

32 <div className="digest-feature-header">

33 <span className="digest-feature-title">サブエージェントが独自のサブエージェントをスポーンできます</span>

34 <span className="digest-feature-pill">v2.1.172</span>

35 </div>

36 

37 <p className="digest-feature-lede">サブエージェントは、独自のサブエージェントをスポーンできるようになりました。プロンプトの下のサブエージェントパネルは完全なツリーを表示します。各行は子孫のカウントと <code>main</code> へのパスを持ちます。バックグラウンドサブエージェントは、暴走する同時ツリーを防ぐため、5 レベルの深さに制限されています。フォアグラウンドチェーンは任意の深さでスポーンでき、自己制限されています。</p>

38 

39 <p className="digest-feature-try">エージェントビューを開いて、作業が広がるにつれてネストされたツリーを監視します:</p>

40 

41 ```text Claude Code theme={null}

42 > /agents

43 ```

44 

45 <a className="digest-feature-link" href="/ja/docs/sub-agents#spawn-nested-subagents">ネストされたサブエージェントをスポーン</a>

46</div>

47 

48<div className="digest-feature">

49 <div className="digest-feature-header">

50 <span className="digest-feature-title">セーフモードでトラブルシューティング</span>

51 <span className="digest-feature-pill">v2.1.169</span>

52 </div>

53 

54 <p className="digest-feature-lede">`--safe-mode` で Claude Code を起動するか、<code>CLAUDE\_CODE\_SAFE\_MODE</code> を設定して、すべてのカスタマイズを無効にして起動します。<code>CLAUDE.md</code>、skills、plugins、hooks、MCP サーバー、カスタムコマンドおよびエージェントは読み込まれません。認証、モデル選択、組み込みツール、およびアクセス許可は引き続き機能します。セーフモードで問題が消える場合、これらのサーフェスのいずれかが原因です。</p>

55 

56 <p className="digest-feature-try">クリーンセッションを起動して、壊れた設定を分離します:</p>

57 

58 ```bash terminal theme={null}

59 claude --safe-mode

60 ```

61 

62 <a className="digest-feature-link" href="/ja/docs/debug-your-config#test-against-a-clean-configuration">クリーン設定に対してテスト</a>

63</div>

64 

65<div className="digest-wins">

66 <p className="digest-wins-title">その他の改善</p>

67 

68 <div className="digest-wins-grid">

69 <div><a href="/ja/docs/model-config#fallback-model-chains"><code>fallbackModel</code></a> は、プライマリがオーバーロードされているか利用できない場合に順番に試される最大 3 つのフォールバックモデルを設定し、`--fallback-model` はインタラクティブセッションにも適用されるようになりました</div>

70 <div>セッションタイトルは、会話の言語で生成されるようになりました。<code>language</code> 設定で特定のものをピン留めします</div>

71 <div>`claude agents --json` は、完了したセッションを含める `--all` と新しい <code>id</code> および <code>state</code> フィールドを追加し、ブロックされたセッションまたは新しくディスパッチされたセッションを省略しなくなりました</div>

72 <div><code>/plugin</code> でマーケットプレイスのプラグインを参照する際に、検索バーが追加されました</div>

73 <div>新しい <code>disableBundledSkills</code> 設定と <code>CLAUDE\_CODE\_DISABLE\_BUNDLED\_SKILLS</code> は、バンドルされたスキル、ワークフロー、および組み込みコマンドをモデルから非表示にします</div>

74 <div>拒否ルールはツール名の位置でグロブを受け入れるため、<code>"\*"</code> はすべてのツールを拒否し、拒否ルール内の不明なツール名は起動時に警告を表示するようになりました</div>

75 <div>クロスセッションメッセージングが強化されました。他のセッションから <code>SendMessage</code> 経由で中継されるメッセージはユーザー権限を持たなくなり、オートモードはそれらをブロックします</div>

76 <div>Amazon Bedrock は、<code>AWS\_REGION</code> が設定されていない場合、<code>\~/.aws</code> 設定ファイルから AWS リージョンを読み取り、<code>/status</code> はリージョンがどこから来たかを表示します</div>

77 <div>新しい <code>enforceAvailableModels</code> マネージド設定により、<code>availableModels</code> 許可リストはデフォルトモデルも制限するようになりました</div>

78 <div>Chrome ブラウザツールの Claude は、ツールごとに 1 つずつではなく、単一のバッチ呼び出しで読み込まれるようになりました</div>

79 <div><code>claude update</code> は、ダウンロードを開始する前に、沈黙するのではなくターゲットバージョンを発表するようになりました</div>

80 <div>新しい <code>footerLinksRegexes</code> 設定は、正規表現でマッチしたリンクバッジをフッター行に追加します</div>

81 </div>

82</div>

83 

84[v2.1.166–v2.1.176 の完全なチェンジログ →](/ja/changelog#2-1-166)

workflows.md +9 −7

Details

9{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}9{/* plan-availability: feature=workflows plans=pro,max,team,enterprise providers=all */}

10 10 

11<Note>11<Note>

12 動的ワークフローはリサーチプレビュー段階です。Claude Code v2.1.154 以降が必要で、すべての有料プランで利用可能です。Anthropic API アクセス、Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry で利用できます。Pro では、`/config` の Dynamic workflows 行からオンにしてください。12 動的ワークフローは Claude Code v2.1.154 以降が必要で、すべての有料プランで利用可能です。Anthropic API アクセス、Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry で利用できます。Pro では、`/config` の Dynamic workflows 行からオンにしてください。

13</Note>13</Note>

14 14 

15動的ワークフローは、[サブエージェント](/ja/sub-agents)を大規模にオーケストレーションする JavaScript スクリプトです。Claude は説明したタスク用のスクリプトを作成し、ランタイムはバックグラウンドで実行しながら、セッションは応答性を保ちます。15動的ワークフローは、[サブエージェント](/ja/sub-agents)を大規模にオーケストレーションする JavaScript スクリプトです。Claude は説明したタスク用のスクリプトを作成し、ランタイムはバックグラウンドで実行しながら、セッションは応答性を保ちます。


46 バンドルされたワークフローを実行する46 バンドルされたワークフローを実行する

47</h2>47</h2>

48 48 

49ワークフローの動作を確認する最速の方法は、Claude Code に含まれている組み込みワークフロー `/deep-research` を実行することです。これは多くのソースにわたって質問を調査するためのものです。セッションが無料のままで、ターンバイターンのトランスクリプトの代わりに 1 つのレポートを取得しながら、エージェントがバックグラウンドで一連のフェーズを処理するのを見ることができます。49ワークフローの動作を確認する最速の方法は、Claude Code に含まれている組み込みワークフロー `/deep-research` を実行することです。これは[バンドルされたワークフロー](#bundled-workflows)で、多くのソースにわたって質問を調査するためのものです。セッションが無料のままで、ターンバイターンのトランスクリプトの代わりに 1 つのレポートを取得しながら、エージェントがバックグラウンドで一連のフェーズを処理するのを見ることができます。

50 50 

51<Steps>51<Steps>

52 <Step title="ワークフローを実行する">52 <Step title="ワークフローを実行する">


78 </Step>78 </Step>

79</Steps>79</Steps>

80 80 

81独自のタスク用にワークフローを実行するには、[Claude にワークフローを作成](#have-claude-write-a-workflow)させ、実行が必要なことを実行したら、[保存](#save-the-workflow-for-reuse)して独自のコマンドとして使用できます81独自のタスク用にワークフローを実行するには、[Claude にワークフローを作成させ](#have-claude-write-a-workflow)、実行が必要なことを実行したら、[保存して](#save-the-workflow-for-reuse)独自のコマンドとして使用できます

82 82 

83<h3 id="bundled-workflows">83<h3 id="bundled-workflows">

84 バンドルされたワークフロー84 バンドルされたワークフロー


152/effort ultracode152/effort ultracode

153```153```

154 154 

155ultracode がオンの場合、Claude はタスクがワークフローを保証するかどうかを決定します。単一のリクエストは複数のワークフローに変わる可能性があります。コードを理解するためのワークフロー、変更を加えるためのワークフロー、検証するためのワークフロー。これはセッション内のすべてのタスクに適用されるため、各リクエストはより多くのトークンを使用し、より低い努力レベルより長くかかります。155ultracode がオンの場合、Claude はタスクがワークフローを必要とするかどうかを決定します。単一のリクエストは複数のワークフローに変わる可能性があります。コードを理解するためのワークフロー、変更を加えるためのワークフロー、検証するためのワークフロー。これはセッション内のすべてのタスクに適用されるため、各リクエストはより多くのトークンを使用し、より低い努力レベルより長くかかります。

156 156 

157Ultracode は現在のセッション用に続き、新しいセッションを開始するときにリセットされます。ルーチンワークに戻るときは `/effort high` でドロップバックします。`xhigh` [努力](/ja/model-config#adjust-effort-level)をサポートするモデルで利用可能です。他のモデルでは、`/effort` メニューはそれを提供しません。157Ultracode は現在のセッション用に続き、新しいセッションを開始するときにリセットされます。ルーチンワークに戻るときは `/effort high` でドロップバックします。`xhigh` [努力](/ja/model-config#adjust-effort-level)をサポートするモデルで利用可能です。他のモデルでは、`/effort` メニューはそれを提供しません。

158 158 


198 198 

199Enter キーを押して保存します。ワークフローは、どちらかの場所から今後のセッションで `/<name>` として実行されます。199Enter キーを押して保存します。ワークフローは、どちらかの場所から今後のセッションで `/<name>` として実行されます。

200 200 

201{/* min-version: 2.1.178 */}v2.1.178 以降、プロジェクトの場所に保存すると、作業ディレクトリとリポジトリルートの間に既に存在する最も近い `.claude/workflows/` ディレクトリに書き込まれるか、まだ存在しない場合はリポジトリルートに書き込まれます。プロジェクトワークフローはその経路に沿ったすべての `.claude/workflows/` から読み込まれ、複数が同じ名前を定義する場合、Claude Code は作業ディレクトリに最も近いものを実行します。

202 

201プロジェクトワークフローと個人ワークフローが名前を共有する場合、プロジェクトワークフローが実行されます。203プロジェクトワークフローと個人ワークフローが名前を共有する場合、プロジェクトワークフローが実行されます。

202 204 

203<h3 id="pass-input-to-a-saved-workflow">205<h3 id="pass-input-to-a-saved-workflow">


284 関連リソース286 関連リソース

285</h2>287</h2>

286 288 

287* [エージェントを並列実行](/ja/agents)サブエージェント、エージェントビュー、エージェントチーム、ワークフローを比較289* [エージェントを並列実行](/ja/agents)サブエージェント、エージェントビュー、エージェントチーム、ワークフローを比較

288* [カスタムサブエージェントを作成](/ja/sub-agents)ワークフローがオーケストレーションするワーカープリミティブ290* [カスタムサブエージェントを作成](/ja/sub-agents)ワークフローがオーケストレーションするワーカープリミティブ

289* [コストを管理](/ja/costs)マルチエージェント実行が使用制限にカウントされる方法291* [コストを管理](/ja/costs)マルチエージェント実行が使用制限にカウントされる方法

worktrees.md +4 −2

Details

36 36 

37セッション中に Claude に「worktree で作業する」と指示することもでき、[`EnterWorktree`](/ja/tools-reference) ツールを使用して作成します。Worktree に入ると、Claude は `.claude/worktrees/` の下の別の worktree に `EnterWorktree` をターゲットパスで呼び出すことで直接切り替えることができます。前の worktree はディスク上に変更されずに残ります。37セッション中に Claude に「worktree で作業する」と指示することもでき、[`EnterWorktree`](/ja/tools-reference) ツールを使用して作成します。Worktree に入ると、Claude は `.claude/worktrees/` の下の別の worktree に `EnterWorktree` をターゲットパスで呼び出すことで直接切り替えることができます。前の worktree はディスク上に変更されずに残ります。

38 38 

39初めてディレクトリで `--worktree` を使用する前に、そのディレクトリで `claude` を 1 回実行してワークスペース信頼ダイアログを受け入れてください。信頼がまだ受け入れられていない場合、`--worktree` はエラーで終了し、最初にディレクトリで `claude` を実行するよう求めるプロンプトが表示されます。これは `-p` と組み合わせた場合も含まれます39初めてディレクトリで `--worktree` をインタラクティブに使用する前に、そのディレクトリで `claude` を 1 回実行してワークスペース信頼ダイアログを受け入れてください。信頼がまだ受け入れられていない場合、`--worktree` はエラーで終了し、最初にディレクトリで `claude` を実行するよう求めるプロンプトが表示されます。`-p` を使用した非インタラクティブ実行は[信頼チェック](/ja/security)をスキップするため、`claude -p --worktree` はそれなしで進行します

40 40 

41<Tip>41<Tip>

42 `.claude/worktrees/` を `.gitignore` に追加して、worktree の内容がメインのチェックアウトで追跡されていないファイルとして表示されないようにします。42 `.claude/worktrees/` を `.gitignore` に追加して、worktree の内容がメインのチェックアウトで追跡されていないファイルとして表示されないようにします。


102 102 

103Claude が subagent および[バックグラウンドセッション](/ja/agent-view#how-file-edits-are-isolated)用に作成した worktree は、[`cleanupPeriodDays`](/ja/settings#available-settings)設定より古い場合、コミットされていない変更、追跡されていないファイル、およびプッシュされていないコミットがない場合、自動的に削除されます。`--worktree` で作成した worktree は、このスイープによって削除されることはありません。103Claude が subagent および[バックグラウンドセッション](/ja/agent-view#how-file-edits-are-isolated)用に作成した worktree は、[`cleanupPeriodDays`](/ja/settings#available-settings)設定より古い場合、コミットされていない変更、追跡されていないファイル、およびプッシュされていないコミットがない場合、自動的に削除されます。`--worktree` で作成した worktree は、このスイープによって削除されることはありません。

104 104 

105エージェントが実行中の間、Claude は worktree に対して `git worktree lock` を実行するため、同時実行クリーンアップがそれを削除することはできません。ロックはエージェントが完了すると解放されます。スイープが保持する worktree をクリーンアップするには、`git worktree remove` を実行し、worktree にコミットされていない変更または追跡されていないファイルがある場合は `--force` を追加します。

106 

105<h2 id="manage-worktrees-manually">107<h2 id="manage-worktrees-manually">

106 worktree を手動で管理する108 worktree を手動で管理する

107</h2>109</h2>


144 非 git バージョン管理146 非 git バージョン管理

145</h2>147</h2>

146 148 

147Worktree の分離はデフォルトで git を使用します。SVN、Perforce、Mercurial、またはその他のシステムの場合、[`WorktreeCreate` および `WorktreeRemove` フック](/ja/hooks#worktreecreate) を設定して、カスタム作成およびクリーンアップロジックを提供します。フックはデフォルトの git 動作を置き換えるため、`--worktree` を使用する場合、[`.worktreeinclude`](#copy-gitignored-files-into-worktrees) は処理されません。フックスクリプト内でローカル設定ファイルをコピーします149Worktree の分離はデフォルトで git を使用します。SVN、Perforce、Mercurial、またはその他のシステムの場合、[`WorktreeCreate` および `WorktreeRemove` フック](/ja/hooks#worktreecreate) を設定して、カスタム作成およびクリーンアップロジックを提供します。フックはデフォルトの git 動作を置き換えるため、`--worktree` を使用する場合、[`.worktreeinclude`](#copy-gitignored-files-into-worktrees) は処理されません。フックスクリプト内でローカル設定ファイルをコピーしてください

148 150 

149この `WorktreeCreate` フックは stdin から worktree 名を読み取り、新しい SVN 作業コピーをチェックアウトし、ディレクトリパスを出力して Claude Code がセッションの作業ディレクトリとして使用できるようにします。151この `WorktreeCreate` フックは stdin から worktree 名を読み取り、新しい SVN 作業コピーをチェックアウトし、ディレクトリパスを出力して Claude Code がセッションの作業ディレクトリとして使用できるようにします。

150 152 

Details

8 8 

9ゼロデータ保持(ZDR)は、Claude for Enterprise を通じて使用される Claude Code で利用可能です。ZDR が有効になると、Claude Code セッション中に生成されたプロンプトとモデル応答はリアルタイムで処理され、法令遵守またはミスユース対策が必要な場合を除き、応答が返された後は Anthropic によって保存されません。9ゼロデータ保持(ZDR)は、Claude for Enterprise を通じて使用される Claude Code で利用可能です。ZDR が有効になると、Claude Code セッション中に生成されたプロンプトとモデル応答はリアルタイムで処理され、法令遵守またはミスユース対策が必要な場合を除き、応答が返された後は Anthropic によって保存されません。

10 10 

11<Note>

12 ZDR は標準的な Claude for Enterprise プランに含まれておらず、管理者設定から有効化することはできません。適格なアカウントで利用可能であり、Anthropic による個別の有効化が必要です。組織が ZDR を必要とする場合は、[営業に連絡](https://www.anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=zero_data_retention_request)するか、Anthropic アカウントチームに連絡して適格性を確認してください。

13</Note>

14 

11Claude for Enterprise 上の ZDR により、エンタープライズカスタマーは Claude Code をゼロデータ保持で使用し、管理機能にアクセスできます:15Claude for Enterprise 上の ZDR により、エンタープライズカスタマーは Claude Code をゼロデータ保持で使用し、管理機能にアクセスできます:

12 16 

13* ユーザーごとのコスト管理17* ユーザーごとのコスト管理


31 ZDR がカバーする内容35 ZDR がカバーする内容

32</h3>36</h3>

33 37 

34ZDR は Claude for Enterprise 上の Claude Code を通じて行われたモデル推論呼び出しをカバーします。ターミナルで Claude Code を使用する場合、送信するプロンプトと Claude が生成する応答は Anthropic によって保持されません。これは、どの Claude モデルが使用されているかに関係なく適用されます38ZDR は Claude for Enterprise 上の Claude Code を通じて行われたモデル推論呼び出しをカバーします。ターミナルで Claude Code を使用する場合、送信するプロンプトと Claude が生成する応答は Anthropic によって保持されません。これは、ZDR 組織で利用可能なすべてのモデルに適用されます。一部のモデルはデータ保持を必要とし、ZDR では利用できません[ZDR でのモデル利用可能性](#model-availability-under-zdr)を参照してください。

35 39 

36<h3 id="what-zdr-does-not-cover">40<h3 id="what-zdr-does-not-cover">

37 ZDR がカバーしない内容41 ZDR がカバーしない内容


54Claude for Enterprise 上の Claude Code 組織に対して ZDR が有効化されると、プロンプトまたは完了を保存する必要がある特定の機能はバックエンドレベルで自動的に無効化されます:58Claude for Enterprise 上の Claude Code 組織に対して ZDR が有効化されると、プロンプトまたは完了を保存する必要がある特定の機能はバックエンドレベルで自動的に無効化されます:

55 59 

56| 機能 | 理由 |60| 機能 | 理由 |

57| ------------------------------------------------------ | --------------------------------------- |61| ----------------------------------------------------- | --------------------------------------- |

58| [Web 上の Claude Code](/ja/claude-code-on-the-web) | 会話履歴のサーバー側ストレージが必要です。 |62| [Web 上の Claude Code](/ja/claude-code-on-the-web) | 会話履歴のサーバー側ストレージが必要です。 |

59| Desktop アプリからの[リモートセッション](/ja/desktop#remote-sessions) | プロンプトと完了を含む永続的なセッションデータが必要です。 |63| Desktop アプリからの[クラウドセッション](/ja/desktop#cloud-sessions) | プロンプトと完了を含む永続的なセッションデータが必要です。 |

60| フィードバック送信(`/feedback`) | フィードバックを送信すると、会話データが Anthropic に送信されます。 |64| フィードバック送信(`/feedback`) | フィードバックを送信すると、会話データが Anthropic に送信されます。 |

61 65 

62これらの機能はクライアント側の表示に関係なく、バックエンドでブロックされます。Claude Code ターミナルの起動中に無効化された機能が表示される場合、それを使用しようとするとエラーが返され、組織のポリシーがそのアクションを許可していないことが示されます。66これらの機能はクライアント側の表示に関係なく、バックエンドでブロックされます。Claude Code ターミナルの起動中に無効化された機能が表示される場合、それを使用しようとするとエラーが返され、組織のポリシーがそのアクションを許可していないことが示されます。

63 67 

64プロンプトまたは完了を保存する必要がある場合、将来の機能も無効化される可能性があります。68プロンプトまたは完了を保存する必要がある場合、将来の機能も無効化される可能性があります。

65 69 

70<h3 id="model-availability-under-zdr">

71 ZDR の下でのモデルの利用可能性

72</h3>

73 

74Claude Fable 5 は、ゼロデータ保持が有効化されている組織では利用できません。このモデルクラスは[データ保持が必要](https://platform.claude.com/docs/en/manage-claude/api-and-data-retention#model-specific-data-retention-requirements)であるため、ZDR 組織からのリクエストはそれによって処理することができません。モデルは ZDR 組織の `/model` ピッカーに表示されないか、ZDR を無効化する必要があることを示す通知付きで無効化として表示され、クライアント設定に関係なくサーバーはそれに対するリクエストを拒否します。

75 

76その他のモデルは ZDR の下で利用可能なままです。Fable 5 はデフォルトモデルではなく、利用可能な場所では Fable 5 に解決される `best` エイリアスは、ZDR 組織を含む利用できない場所では Opus に解決されます。

77 

66<h2 id="data-retention-for-policy-violations">78<h2 id="data-retention-for-policy-violations">

67 ポリシー違反のためのデータ保持79 ポリシー違反のためのデータ保持

68</h2>80</h2>