SpyBara
Go Premium

Documentation 2026-07-09 23:58 UTC to 2026-07-10 17:00 UTC

112 files changed +1,814 −1,041. View all changes and history on the product overview
2026
Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

admin-setup.md +6 −6

Details

15</Note>15</Note>

16 16 

17| 決定 | 選択内容 | 参照 |17| 決定 | 選択内容 | 参照 |

18| :-------------------------------------------------------- | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------ |18| :-------------------------------------------------------- | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

19| [API プロバイダーを選択する](#choose-your-api-provider) | Claude Code が認証される場所と課金方法 | [Authentication](/ja/authentication)、[Bedrock](/ja/amazon-bedrock)、[Vertex AI](/ja/google-vertex-ai)、[Foundry](/ja/microsoft-foundry) |19| [API プロバイダーを選択する](#choose-your-api-provider) | Claude Code が認証される場所と課金方法 | [Authentication](/ja/authentication)、[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry) |

20| [設定がデバイスに到達する方法を決定する](#decide-how-settings-reach-devices) | マネージドポリシーが開発者マシンに到達する方法 | [Server-managed settings](/ja/server-managed-settings)、[Settings files](/ja/settings#settings-files) |20| [設定がデバイスに到達する方法を決定する](#decide-how-settings-reach-devices) | マネージドポリシーが開発者マシンに到達する方法 | [Server-managed settings](/ja/server-managed-settings)、[Settings files](/ja/settings#settings-files) |

21| [実行する内容を決定する](#decide-what-to-enforce) | どのツール、コマンド、統合が許可されるか | [Permissions](/ja/permissions)、[Sandboxing](/ja/sandboxing) |21| [実行する内容を決定する](#decide-what-to-enforce) | どのツール、コマンド、統合が許可されるか | [Permissions](/ja/permissions)、[Sandboxing](/ja/sandboxing) |

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) |


33| Claude for Teams / Enterprise | Claude Code と claude.ai を 1 つのシート単位のサブスクリプションで実行したい場合。実行するインフラストラクチャは不要です。これがデフォルトの推奨事項です。 |33| Claude for Teams / Enterprise | Claude Code と claude.ai を 1 つのシート単位のサブスクリプションで実行したい場合。実行するインフラストラクチャは不要です。これがデフォルトの推奨事項です。 |

34| Claude Console | API ファーストまたは従量課金を希望する場合 |34| Claude Console | API ファーストまたは従量課金を希望する場合 |

35| Amazon Bedrock | 既存の AWS コンプライアンス制御と課金を継承したい場合 |35| Amazon Bedrock | 既存の AWS コンプライアンス制御と課金を継承したい場合 |

36| Google Vertex AI | 既存の GCP コンプライアンス制御と課金を継承したい場合 |36| Google Cloud の Agent Platform | 既存の GCP コンプライアンス制御と課金を継承したい場合 |

37| Microsoft Foundry | 既存の Azure コンプライアンス制御と課金を継承したい場合 |37| Microsoft Foundry | 既存の Azure コンプライアンス制御と課金を継承したい場合 |

38 38 

39一部の Claude Code 機能には claude.ai アカウントが必要です。[web 上の Claude Code](/ja/claude-code-on-the-web)、[Routines](/ja/routines)、[Code Review](/ja/code-review)、[Remote Control](/ja/remote-control)、および [Chrome 拡張機能](/ja/chrome) は、Console API キーまたはクラウドプロバイダーの認証情報だけでは利用できません。Bedrock、Vertex、または Foundry を通じてデプロイする場合は、開発者が Claude for Teams または Enterprise シートも必要かどうかを検討してください。各機能ページにはプラン要件が記載されています。39一部の Claude Code 機能には claude.ai アカウントが必要です。[web 上の Claude Code](/ja/claude-code-on-the-web)、[Routines](/ja/routines)、[Code Review](/ja/code-review)、[Remote Control](/ja/remote-control)、および [Chrome 拡張機能](/ja/chrome) は、Console API キーまたはクラウドプロバイダーの認証情報だけでは利用できません。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を通じてデプロイする場合は、開発者が Claude for Teams または Enterprise シートも必要かどうかを検討してください。各機能ページにはプラン要件が記載されています。

40 40 

41認証、リージョン、機能パリティをカバーする完全なプロバイダー比較については、[エンタープライズ展開概要](/ja/third-party-integrations) を参照してください。各プロバイダーの認証セットアップは [Authentication](/ja/authentication) にあります。41認証、リージョン、機能パリティをカバーする完全なプロバイダー比較については、[エンタープライズ展開概要](/ja/third-party-integrations) を参照してください。各プロバイダーの認証セットアップは [Authentication](/ja/authentication) にあります。

42 42 


57 57 

58設定済みの [`policyHelper`](/ja/settings#compute-managed-settings-with-a-policy-helper) は 4 つのソースすべてに優先します。その出力は実行時のマネージド設定の唯一のものになります。[設定の優先度](/ja/settings#settings-precedence) を参照してください。58設定済みの [`policyHelper`](/ja/settings#compute-managed-settings-with-a-policy-helper) は 4 つのソースすべてに優先します。その出力は実行時のマネージド設定の唯一のものになります。[設定の優先度](/ja/settings#settings-precedence) を参照してください。

59 59 

60Server-managed 設定はデバイスが認証されるときに到達し、アクティブなセッション中は 1 時間ごとに更新されます。エンドポイントインフラストラクチャは不要です。claude.ai 管理コンソール経由の配信には Claude for Teams または Enterprise プランが必要です。Bedrock、Vertex AI、または Foundry での展開は、[Claude apps gateway](/ja/claude-apps-gateway) を実行することで同じリモート配信を取得できます。または、代わりにファイルベースまたは OS レベルのメカニズムのいずれかを使用してください。60Server-managed 設定はデバイスが認証されるときに到達し、アクティブなセッション中は 1 時間ごとに更新されます。エンドポイントインフラストラクチャは不要です。claude.ai 管理コンソール経由の配信には Claude for Teams または Enterprise プランが必要です。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry での展開は、[Claude apps gateway](/ja/claude-apps-gateway) を実行することで同じリモート配信を取得できます。または、代わりにファイルベースまたは OS レベルのメカニズムのいずれかを使用してください。

61 61 

62組織が複数のプロバイダーを混在させている場合、claude.ai ユーザー向けに [server-managed settings](/ja/server-managed-settings) を設定し、他のユーザーがマネージドポリシーを受け取るように [ファイルベースまたは plist/registry フォールバック](/ja/settings#settings-files) を設定してください。62組織が複数のプロバイダーを混在させている場合、claude.ai ユーザー向けに [server-managed settings](/ja/server-managed-settings) を設定し、他のユーザーがマネージドポリシーを受け取るように [ファイルベースまたは plist/registry フォールバック](/ja/settings#settings-files) を設定してください。

63 63 


153* [Server-managed settings](/ja/server-managed-settings): Claude 管理コンソールからマネージドポリシーを配信する153* [Server-managed settings](/ja/server-managed-settings): Claude 管理コンソールからマネージドポリシーを配信する

154* [Settings reference](/ja/settings): すべての設定キー、ファイルの場所、優先度ルール154* [Settings reference](/ja/settings): すべての設定キー、ファイルの場所、優先度ルール

155* [Monorepos and large repos](/ja/large-codebases): 大規模リポジトリをデプロイする組織向けのディレクトリごとの設定パターン155* [Monorepos and large repos](/ja/large-codebases): 大規模リポジトリをデプロイする組織向けのディレクトリごとの設定パターン

156* [Amazon Bedrock](/ja/amazon-bedrock)、[Google Vertex AI](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry): プロバイダー固有のデプロイメント156* [Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud's Agent Platform](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry): プロバイダー固有のデプロイメント

157* [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO、SCIM、シート管理、ロールアウトプレイブック157* [Claude Enterprise Administrator Guide](https://claude.com/resources/tutorials/claude-enterprise-administrator-guide): SSO、SCIM、シート管理、ロールアウトプレイブック

advisor.md +2 −2

Details

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

10 10 

11<Note>11<Note>

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

13</Note>13</Note>

14 14 

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


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

163 163 

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

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

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

167 167 

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

Details

202 202 

203どちらかの制限に達すると、SDK は対応するエラーサブタイプ(`error_max_turns` または `error_max_budget_usd`)を含む `ResultMessage` を返します。これらのサブタイプをチェックする方法については[結果を処理する](#handle-the-result)を、構文については[`ClaudeAgentOptions`](/ja/agent-sdk/python#claudeagentoptions) / [`Options`](/ja/agent-sdk/typescript#options)を参照してください。203どちらかの制限に達すると、SDK は対応するエラーサブタイプ(`error_max_turns` または `error_max_budget_usd`)を含む `ResultMessage` を返します。これらのサブタイプをチェックする方法については[結果を処理する](#handle-the-result)を、構文については[`ClaudeAgentOptions`](/ja/agent-sdk/python#claudeagentoptions) / [`Options`](/ja/agent-sdk/typescript#options)を参照してください。

204 204 

205[ストリーミング入力](/ja/agent-sdk/streaming-vs-single-mode)を使用する場合、ターンがまだ実行中に送信したメッセージは、そのターンが最大ターン制限で終了するときにキューに入ったままになり、独自の最大ターン制限を持つ独自のターンを開始します。v2.1.205 より前では、ターンの最終イテレーションに到着したメッセージは終了ターンに消費され、モデルに到達することなく失われる可能性がありました。

206 

205<h3 id="effort-level">207<h3 id="effort-level">

206 努力レベル208 努力レベル

207</h3>209</h3>


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

210 212 

211| レベル | 動作 | 適している用途 |213| レベル | 動作 | 適している用途 |

212| :--------- | :---------- | :-------------------------------------------------- |214| :--------- | :---------- | :---------------------------------------------------------- |

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

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

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

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

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

218 220 

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


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

232 234 

233| モード | 動作 |235| モード | 動作 |

234| :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |236| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

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

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

237| `"plan"` | Claude はソースファイルを編集せずに探索して計画を作成します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトされます |239| `"plan"` | Claude はソースファイルを編集せずに探索して計画を作成します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトされます |

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

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

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

241 243 

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


260SDK でのコンテキストへの各コンポーネントの影響は次のとおりです。262SDK でのコンテキストへの各コンポーネントの影響は次のとおりです。

261 263 

262| ソース | ロード時期 | 影響 |264| ソース | ロード時期 | 影響 |

263| :----------------- | :---------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |265| :----------------- | :---------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

264| **システムプロンプト** | すべてのリクエスト | 小さい固定コスト、常に存在 |266| **システムプロンプト** | すべてのリクエスト | 小さい固定コスト、常に存在 |

265| **CLAUDE.md ファイル** | セッション開始時、[`settingSources`](/ja/agent-sdk/claude-code-features)経由 | すべてのリクエストで完全なコンテンツ(ただしプロンプトキャッシュされるため、最初のリクエストのみが完全なコストを支払う) |267| **CLAUDE.md ファイル** | セッション開始時、[`settingSources`](/ja/agent-sdk/claude-code-features)経由 | すべてのリクエストで完全なコンテンツ(ただしプロンプトキャッシュされるため、最初のリクエストのみが完全なコストを支払う) |

266| **ツール定義** | すべてのリクエスト。MCP スキーマはデフォルトで遅延 | 組み込みツールスキーマはすべてのリクエストをロードします。[ツール検索](/ja/agent-sdk/mcp#mcp-tool-search)は、デフォルトで MCP ツールスキーマを遅延させ、Vertex AI または非ファーストパーティの `ANTHROPIC_BASE_URL` でのアップフロントロードにフォールバックします。完全なマトリックスについては、[ツール検索を構成](/ja/agent-sdk/tool-search#configure-tool-search)を参照してください |268| **ツール定義** | すべてのリクエスト。MCP スキーマはデフォルトで遅延 | 組み込みツールスキーマはすべてのリクエストをロードします。[ツール検索](/ja/agent-sdk/mcp#mcp-tool-search)は、デフォルトで MCP ツールスキーマを遅延させ、Google Cloud の Agent Platform または非ファーストパーティの `ANTHROPIC_BASE_URL` でのアップフロントロードにフォールバックします。完全なマトリックスについては、[ツール検索を構成](/ja/agent-sdk/tool-search#configure-tool-search)を参照してください |

267| **会話履歴** | ターン間で蓄積 | 各ターンで増加。プロンプト、応答、ツール入力、ツール出力 |269| **会話履歴** | ターン間で蓄積 | 各ターンで増加。プロンプト、応答、ツール入力、ツール出力 |

268| **スキル説明** | セッション開始時、設定ソース経由 | 短い要約。完全なコンテンツは呼び出し時のみロード |270| **スキル説明** | セッション開始時、設定ソース経由 | 短い要約。完全なコンテンツは呼び出し時のみロード |

269 271 


305 307 

306* **サブタスク用にサブエージェントを使用します。** 各サブエージェントは新しい会話で開始されます(以前のメッセージ履歴はありませんが、独自のシステムプロンプトとプロジェクトレベルのコンテキスト(CLAUDE.md など)をロードします)。親のターンは表示されず、最終応答のみが親にツール結果として返されます。メインエージェントのコンテキストは完全なサブタスクトランスクリプトではなく、その要約で増加します。詳細については、[サブエージェントが継承するもの](/ja/agent-sdk/subagents#what-subagents-inherit)を参照してください。308* **サブタスク用にサブエージェントを使用します。** 各サブエージェントは新しい会話で開始されます(以前のメッセージ履歴はありませんが、独自のシステムプロンプトとプロジェクトレベルのコンテキスト(CLAUDE.md など)をロードします)。親のターンは表示されず、最終応答のみが親にツール結果として返されます。メインエージェントのコンテキストは完全なサブタスクトランスクリプトではなく、その要約で増加します。詳細については、[サブエージェントが継承するもの](/ja/agent-sdk/subagents#what-subagents-inherit)を参照してください。

307* **ツールを選別します。** すべてのツール定義はコンテキストスペースを取ります。[`AgentDefinition`](/ja/agent-sdk/subagents#agentdefinition-configuration)の `tools` フィールドを使用してサブエージェントを必要な最小セットにスコープします。309* **ツールを選別します。** すべてのツール定義はコンテキストスペースを取ります。[`AgentDefinition`](/ja/agent-sdk/subagents#agentdefinition-configuration)の `tools` フィールドを使用してサブエージェントを必要な最小セットにスコープします。

308* **MCP サーバーコストを監視します。** [MCP ツール検索](/ja/agent-sdk/mcp#mcp-tool-search)はデフォルトで MCP ツールスキーマを遅延させ、オンデマンドでロードします。ツール検索がオフの場合、Vertex AI 上の場合、または非ファーストパーティの `ANTHROPIC_BASE_URL` の背後にある場合、各 MCP サーバーはすべてのツールスキーマをすべてのリクエストに追加するため、多くのツールを持つ少数のサーバーは、エージェントが何か作業を行う前に大量のコンテキストを消費できます。310* **MCP サーバーコストを監視します。** [MCP ツール検索](/ja/agent-sdk/mcp#mcp-tool-search)はデフォルトで MCP ツールスキーマを遅延させ、オンデマンドでロードします。ツール検索がオフの場合、Google Cloud の Agent Platform 上の場合、または非ファーストパーティの `ANTHROPIC_BASE_URL` の背後にある場合、各 MCP サーバーはすべてのツールスキーマをすべてのリクエストに追加するため、多くのツールを持つ少数のサーバーは、エージェントが何か作業を行う前に大量のコンテキストを消費できます。

309* **ルーチンタスクに低い努力を使用します。** ファイルを読み取るか、ディレクトリをリストするだけで済むエージェント用に[努力](#effort-level)を `"low"` に設定します。これはトークン使用量とコストを削減します。311* **ルーチンタスクに低い努力を使用します。** ファイルを読み取るか、ディレクトリをリストするだけで済むエージェント用に[努力](#effort-level)を `"low"` に設定します。これはトークン使用量とコストを削減します。

310 312 

311機能ごとのコンテキストコストの詳細な内訳については、[コンテキストコストを理解する](/ja/features-overview#understand-context-costs)を参照してください。313機能ごとのコンテキストコストの詳細な内訳については、[コンテキストコストを理解する](/ja/features-overview#understand-context-costs)を参照してください。

Details

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

293</h3>293</h3>

294 294 

295SDK によって書き込まれたキャッシュエントリは、API キーで認証するか、Amazon Bedrock、Google Cloud Vertex AI、または Microsoft Foundry で実行する場合、デフォルトで 5 分の TTL を使用します。ワークロードが同じシステムプロンプトとコンテキストに対して多くの短いセッションを実行し、セッション間に 5 分以上のギャップがある場合、キャッシュはセッション間で期限切れになり、各新しいセッションは完全な入力価格を支払います。295SDK によって書き込まれたキャッシュエントリは、API キーで認証するか、Amazon Bedrock、Google Cloud Agent Platform、または Microsoft Foundry で実行する場合、デフォルトで 5 分の TTL を使用します。ワークロードが同じシステムプロンプトとコンテキストに対して多くの短いセッションを実行し、セッション間に 5 分以上のギャップがある場合、キャッシュはセッション間で期限切れになり、各新しいセッションは完全な入力価格を支払います。

296 296 

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

298 298 

299次の例は、Bedrock で実行されているエージェントの 1 時間 TTL を有効にします。299次の例は、Amazon Bedrock で実行されているエージェントの 1 時間 TTL を有効にします。

300 300 

301<CodeGroup>301<CodeGroup>

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

Details

21| ツールを事前承認する | 許可されたツールに追加します。[許可されたツールを設定する](#configure-allowed-tools)を参照してください。 |21| ツールを事前承認する | 許可されたツールに追加します。[許可されたツールを設定する](#configure-allowed-tools)を参照してください。 |

22| Claude のコンテキストから組み込みツールを削除する | 必要な組み込みのみをリストする `tools` 配列を渡します。[許可されたツールを設定する](#configure-allowed-tools)を参照してください。 |22| Claude のコンテキストから組み込みツールを削除する | 必要な組み込みのみをリストする `tools` 配列を渡します。[許可されたツールを設定する](#configure-allowed-tools)を参照してください。 |

23| Claude がツールを並列で呼び出せるようにする | 副作用のないツールに `readOnlyHint: true` を設定します。[ツール注釈を追加する](#add-tool-annotations)を参照してください。 |23| Claude がツールを並列で呼び出せるようにする | 副作用のないツールに `readOnlyHint: true` を設定します。[ツール注釈を追加する](#add-tool-annotations)を参照してください。 |

24| ループを停止せずにエラーを処理する | throw の代わりに `isError: true` を返します。[エラーを処理する](#handle-errors)を参照してください。 |24| Claude が読むエラーメッセージを制御する | `isError: true` を返して、生の例外をサーフェスする代わりにメッセージを作成します。[エラーを処理する](#handle-errors)を参照してください。 |

25| 画像またはファイルを返す | コンテンツ配列で `image` または `resource` ブロックを使用します。[画像とリソースを返す](#return-images-and-resources)を参照してください。 |25| 画像またはファイルを返す | コンテンツ配列で `image` または `resource` ブロックを使用します。[画像とリソースを返す](#return-images-and-resources)を参照してください。 |

26| マシン可読 JSON 結果を返す | 結果に `structuredContent` を設定します。[構造化データを返す](#return-structured-data)を参照してください。 |26| マシン可読 JSON 結果を返す | 結果に `structuredContent` を設定します。[構造化データを返す](#return-structured-data)を参照してください。 |

27| 多くのツールにスケーリングする | [ツール検索](/ja/agent-sdk/tool-search)を使用して、オンデマンドでツールを読み込みます。 |27| 多くのツールにスケーリングする | [ツール検索](/ja/agent-sdk/tool-search)を使用して、オンデマンドでツールを読み込みます。 |


356 エラーを処理する356 エラーを処理する

357</h2>357</h2>

358 358 

359ハンドラーがエラーを報告する方法はエージェントループが続行するか停止するかを決定します359ハンドラーエラーはエージェントループを停止しません。SDK のインプロセス MCP サーバーはキャッチされない例外をキャッチしエラー結果として返すため、エラーをどのように報告するかによって Claude が読む内容が決まりますクエリが失敗するかどうかではなく:

360 360 

361| 何が起こるか | 結果 |361| 何が起こるか | 結果 |

362| :------------------------------------------------------------------ | :-------------------------------------------------------------- |362| :------------------------------------------------------------------ | :---------------------------------------------------------------------------- |

363| ハンドラーがキャッチされない例外をスロー | エージェントループが停止します。Claude はエラーを見ず`query` 呼び出しが失敗します |363| ハンドラーがキャッチされない例外をスロー | MCP サーバーはそれをエラー結果に変換し、生の例外メッセージを含みます。Claude はそのメッセージを見てエージェントループが続行します |

364| ハンドラーがエラーをキャッチして `isError: true`(TS)/ `"is_error": True`(Python)を返す | エージェントループが続行します。Claude はエラーをデータとして見て、再試行、別のツールを試すまたは失敗を説明できます。 |364| ハンドラーがエラーをキャッチして `isError: true`(TS)/ `"is_error": True`(Python)を返す | Claude はあなたが作成したメッセージを見ます。生の例外が欠けているコンテキスト(どのリクエストが失敗したか代わりに何を試すかなど)を追加できます。 |

365 365 

366以下の例は、スロー させる代わりに、ハンドラー内で 2 種類の障害をキャッチします。200 以外の HTTP ステータスは応答からキャッチされエラー結果として返されます。ネットワークエラーまたは無効な JSON は周囲の `try/except`(Python)または `try/catch`(TypeScript)でキャッチされ、エラー結果としても返されます。どちらの場合も、ハンドラーは正常に返されエージェントループが続行されます366どちらの場合も Claude は再試行したり別のツールを試したり失敗を説明したりできます。生の例外メッセージが Claude が対応するのに十分でない場合は自分でエラーをキャッチしてください

367 

368以下の例は、ハンドラー内で 2 種類の障害をキャッチし、Claude が読むエラーメッセージを作成します。200 以外の HTTP ステータスは応答からキャッチされ、エラー結果として返されます。ネットワークエラーまたは無効な JSON は、周囲の `try/except`(Python)または `try/catch`(TypeScript)でキャッチされ、エラー結果としても返されます。どちらの場合も Claude は、生の例外文字列ではなく、失敗を説明するメッセージを受け取ります。

367 369 

368<CodeGroup>370<CodeGroup>

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


375 @tool(377 @tool(

376 "fetch_data",378 "fetch_data",

377 "Fetch data from an API",379 "Fetch data from an API",

378 {"endpoint": str}, # シンプルなスキーマ380 {"endpoint": str}, # Simple schema

379 )381 )

380 async def fetch_data(args: dict[str, Any]) -> dict[str, Any]:382 async def fetch_data(args: dict[str, Any]) -> dict[str, Any]:

381 try:383 try:


397 data = response.json()399 data = response.json()

398 return {"content": [{"type": "text", "text": json.dumps(data, indent=2)}]}400 return {"content": [{"type": "text", "text": json.dumps(data, indent=2)}]}

399 except Exception as e:401 except Exception as e:

400 # ここでキャッチすることでエージェントループを生かしておきますキャッチされない例外402 # Claude が読むメッセージを作成しますキャッチされない例外は

401 # query() 呼び出し全体を終了させます403 # コンテキストなしで生の str(e) として Claude に到達します

402 return {404 return {

403 "content": [{"type": "text", "text": f"Failed to fetch data: {str(e)}"}],405 "content": [{"type": "text", "text": f"Failed to fetch data: {str(e)}"}],

404 "is_error": True,406 "is_error": True,


440 ]442 ]

441 };443 };

442 } catch (error) {444 } catch (error) {

443 // ここでキャッチすることでエージェントループを生かしておきます。キャッチされない throw445 // Claude が読むメッセージを作成します。キャッチされない throw

444 // query() 呼び出し全体を終了させます446 // コンテキストなしで生のエラーメッセージとして Claude に到達します

445 return {447 return {

446 content: [448 content: [

447 {449 {


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

462</h2>464</h2>

463 465 

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

465 467 

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

467 画像469 画像


535リソースブロックは URI で識別されるコンテンツを埋め込みます。URI は Claude が参照するためのラベルです。実際のコンテンツはブロックの `text` または `blob` フィールドに含まれます。これは、生成されたファイルや外部システムのレコードなど、後で名前で対処することが理にかなっているツールが生成するものを使用します。537リソースブロックは URI で識別されるコンテンツを埋め込みます。URI は Claude が参照するためのラベルです。実際のコンテンツはブロックの `text` または `blob` フィールドに含まれます。これは、生成されたファイルや外部システムのレコードなど、後で名前で対処することが理にかなっているツールが生成するものを使用します。

536 538 

537| フィールド | 型 | 注釈 |539| フィールド | 型 | 注釈 |

538| :------------------ | :----------- | :--------------------------------- |540| :------------------ | :----------- | :------------------------------------------------------------------------------------- |

539| `type` | `"resource"` | |541| `type` | `"resource"` | |

540| `resource.uri` | `string` | コンテンツの識別子。任意の URI スキーム |542| `resource.uri` | `string` | コンテンツの識別子。任意の URI スキーム |

541| `resource.text` | `string` | テキストの場合のコンテンツ。`blob` ではなく、これを提供します |543| `resource.text` | `string` | テキストの場合のコンテンツ。`blob` ではなく、これを提供します |

542| `resource.blob` | `string` | バイナリの場合、base64 エンコードされたコンテンツ |544| `resource.blob` | `string` | バイナリの場合、base64 エンコードされたコンテンツ。TypeScript のみ:Python SDK はツール結果からバイナリリソースを削除し、警告をログに記録します |

543| `resource.mimeType` | `string` | オプション |545| `resource.mimeType` | `string` | オプション |

544 546 

545この例は、ツールハンドラー内から返されるリソースブロックを示しています。URI `file:///tmp/report.md` は Claude が後で参照できるラベルです。SDK はそのパスから読み取りません。547この例は、ツールハンドラー内から返されるリソースブロックを示しています。URI `file:///tmp/report.md` は Claude が後で参照できるラベルです。SDK はそのパスから読み取りません。

Details

250 250 

251* **入力データ:** イベント詳細を含む型付きオブジェクト。各フック型には独自の入力形状があります。たとえば、`PreToolUseHookInput` には `tool_name` と `tool_input` が含まれ、`NotificationHookInput` には `message` が含まれます。[TypeScript](/ja/agent-sdk/typescript#hookinput) および [Python](/ja/agent-sdk/python#hookinput) SDK リファレンスで完全な型定義を参照してください。251* **入力データ:** イベント詳細を含む型付きオブジェクト。各フック型には独自の入力形状があります。たとえば、`PreToolUseHookInput` には `tool_name` と `tool_input` が含まれ、`NotificationHookInput` には `message` が含まれます。[TypeScript](/ja/agent-sdk/typescript#hookinput) および [Python](/ja/agent-sdk/python#hookinput) SDK リファレンスで完全な型定義を参照してください。

252 * すべてのフック入力は `session_id`、`cwd`、および `hook_event_name` を共有します。252 * すべてのフック入力は `session_id`、`cwd`、および `hook_event_name` を共有します。

253 * `agent_id` と `agent_type` は、フックがサブエージェント内で発火するときに入力されます。TypeScript では、これらはベースフック入力にあり、すべてのフック型で利用可能です。Python では、`PreToolUse`、`PostToolUse`、および `PostToolUseFailure` のみにあります253 * `agent_id` と `agent_type` は、フックがサブエージェント内で発火するときに入力されます。TypeScript では、これらはベースフック入力にあり、すべてのフック型で利用可能です。Python では、これらは `PreToolUse`、`PostToolUse`、`PostToolUseFailure`、および `PermissionRequest` のオプションフィールドであり、`SubagentStart` および `SubagentStop` の必須フィールドです

254* **ツール使用 ID**(`str | None` / `string | undefined`):同じツール呼び出しの `PreToolUse` と `PostToolUse` イベントを相関させます。254* **ツール使用 ID**(`str | None` / `string | undefined`):同じツール呼び出しの `PreToolUse` と `PostToolUse` イベントを相関させます。

255* **コンテキスト:** TypeScript では、キャンセル用の `signal` プロパティ(`AbortSignal`)を含みます。Python では、この引数は将来の使用のために予約されています。255* **コンテキスト:** TypeScript では、キャンセル用の `signal` プロパティ(`AbortSignal`)を含みます。Python では、この引数は将来の使用のために予約されています。

256 256 

Details

189 ネットワーク189 ネットワーク

190</h3>190</h3>

191 191 

192SDK は `api.anthropic.com` へのアウトバウンド HTTPS、または Bedrock または Vertex で実行する場合はプロバイダーのリージョナルエンドポイントへのアウトバウンド HTTPS が必要です。エージェントが [MCP サーバー](/ja/agent-sdk/mcp)または外部ツールを使用する場合、それらのエンドポイントへのアウトバウンドアクセスも必要です。本番環境では、ドメイン許可リストを適用し、認証情報を挿入し、リクエストをログに記録する出力プロキシを通じてアウトバウンドトラフィックをルーティングしてください。完全なパターンについては、[セキュアデプロイメント](/ja/agent-sdk/secure-deployment)を参照してください。192SDK は `api.anthropic.com` へのアウトバウンド HTTPS、または Amazon Bedrock または Google Cloud の Agent Platform で実行する場合はプロバイダーのリージョナルエンドポイントへのアウトバウンド HTTPS が必要です。エージェントが [MCP サーバー](/ja/agent-sdk/mcp)または外部ツールを使用する場合、それらのエンドポイントへのアウトバウンドアクセスも必要です。本番環境では、ドメイン許可リストを適用し、認証情報を挿入し、リクエストをログに記録する出力プロキシを通じてアウトバウンドトラフィックをルーティングしてください。完全なパターンについては、[セキュアデプロイメント](/ja/agent-sdk/secure-deployment)を参照してください。

193 193 

194インバウンドトラフィックの場合、コンテナ上の HTTP または WebSocket ポートを公開します。アプリケーションはそのポート上のクライアントリクエストを処理し、SDK を内部的に呼び出します。サブプロセス自体はネットワーク上でリッスンしません。194インバウンドトラフィックの場合、コンテナ上の HTTP または WebSocket ポートを公開します。アプリケーションはそのポート上のクライアントリクエストを処理し、SDK を内部的に呼び出します。サブプロセス自体はネットワーク上でリッスンしません。

195 195 

Details

823 接続タイムアウト823 接続タイムアウト

824</h3>824</h3>

825 825 

826MCP SDK のサーバー接続のデフォルトタイムアウトは 60 秒です。サーバーの起動に時間がかかる場合、接続は失敗します。より多くの起動時間が必要なサーバーの場合は、以下を検討してください826MCP サーバー接続のデフォルトタイムアウトは 30 秒です。サーバーの起動に時間がかかる場合、接続は失敗します。[`MCP_TIMEOUT`](/ja/env-vars) 環境変数でリミットを上げてください(ミリ秒単位)。より多くの起動時間が必要なサーバーの場合は、以下も検討してください

827 827 

828* 利用可能な場合は、より軽量なサーバーを使用する828* 利用可能な場合は、より軽量なサーバーを使用する

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

Details

152 152 

153* **CLI**:`/config` を実行し、出力スタイルを選択153* **CLI**:`/config` を実行し、出力スタイルを選択

154* **設定**:`.claude/settings.local.json` で `outputStyle` を設定154* **設定**:`.claude/settings.local.json` で `outputStyle` を設定

155* **TypeScript SDK**:`query()` に渡されるインラインの `settings` オブジェクト内で `outputStyle` を設定するか、`settings` を `outputStyle` を設定する設定ファイルに指定します。`outputStyle` はトップレベルの `Options` フィールドではありません155* **TypeScript SDK**:`query()` に渡されるインラインの `settings` オブジェクト内で `outputStyle` を設定するか、`settings` を `outputStyle` を設定する設定ファイルに指定します。`outputStyle` はトップレベルの `Options` フィールドではありません

156 

157 ```typescript theme={null}

158 const options = { settings: { outputStyle: "Explanatory" } };

159 ```

156 160 

157Python SDK には、出力スタイルをプログラムで選択するオプションはありません。`.claude/settings.local.json` に書き込めないコードのみのデプロイメントの場合は、`append` またはカスタムプロンプト文字列を代わりに使用してください。161Python SDK には、出力スタイルをプログラムで選択するオプションはありません。`.claude/settings.local.json` に書き込めないコードのみのデプロイメントの場合は、`append` またはカスタムプロンプト文字列を代わりに使用してください。

158 162 

Details

206 206 

207CLI は、Anthropic を呼び出すために使用する認証情報に基づいて、すべてのイベントに [ID 属性](/ja/monitoring-usage#standard-attributes)を添付します。1 つのデプロイメントから多くのエンドユーザーにサービスを提供するアプリケーションを構築する場合、これらの属性はサービスの認証情報を識別し、エージェントが代わりに機能したエンドユーザーを識別しません。207CLI は、Anthropic を呼び出すために使用する認証情報に基づいて、すべてのイベントに [ID 属性](/ja/monitoring-usage#standard-attributes)を添付します。1 つのデプロイメントから多くのエンドユーザーにサービスを提供するアプリケーションを構築する場合、これらの属性はサービスの認証情報を識別し、エージェントが代わりに機能したエンドユーザーを識別しません。

208 208 

209ツール呼び出しと MCP アクティビティをアプリケーションのエンドユーザーに属性付けるには、各 `query()` 呼び出しでエンドユーザー ID をリソース属性として注入します。`OTEL_RESOURCE_ATTRIBUTES` は [コンマ、スペース、等号記号を予約](/ja/monitoring-usage#multi-team-organization-support)しているため、値を補間する前にパーセントエンコードします。次の例では、要求するユーザーとテナントを 1 つのリクエストからのすべてのスパンとイベントに添付します。209ツール呼び出しと MCP アクティビティをアプリケーションのエンドユーザーに属性付けるには、各 `query()` 呼び出しでエンドユーザー ID をリソース属性として注入します。`OTEL_RESOURCE_ATTRIBUTES` は [コンマ、スペース、等号記号を予約](/ja/monitoring-usage#multi-team-organization-support)しているため、値を補間する前にパーセントエンコードします。次の例では、要求するユーザーとテナントを 1 つのリクエストからのすべてのスパンとイベントに添付します。ここでは、ユーザー ID とテナント ID を含む web フレームワークからの `request` オブジェクトを想定しています。

210 210 

211<CodeGroup>211<CodeGroup>

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


231 ```231 ```

232</CodeGroup>232</CodeGroup>

233 233 

234エンドユーザー ID が添付されると、`tool_decision`、`tool_result`、`mcp_server_connection`、`permission_mode_changed` イベントはユーザーごとの監査証跡になり、Security Information and Event Management(SIEM)プラットフォームに転送できます。Monitoring リファレンスの [セキュリティイベントの監査](/ja/monitoring-usage#audit-security-events)を参照して、セキュリティ関連イベントの完全なリストと各イベントが持つ属性を確認してください。234エンドユーザー ID が添付されると、`tool_decision`、`tool_result`、`mcp_server_connection`、`permission_mode_changed` イベント(`claude_code.` プレフィックス付きのログレコードとしてエクスポートされる)はユーザーごとの監査証跡になり、Security Information and Event Management(SIEM)プラットフォームに転送できます。Monitoring リファレンスの [セキュリティイベントの監査](/ja/monitoring-usage#audit-security-events)を参照して、セキュリティ関連イベントの完全なリストと各イベントが持つ属性を確認してください。

235 235 

236<h2 id="control-sensitive-data-in-exports">236<h2 id="control-sensitive-data-in-exports">

237 エクスポートの機密データを制御237 エクスポートの機密データを制御

Details

87 87 

88 * **Amazon Bedrock**: `CLAUDE_CODE_USE_BEDROCK=1` 環境変数を設定し、AWS 認証情報を構成します88 * **Amazon Bedrock**: `CLAUDE_CODE_USE_BEDROCK=1` 環境変数を設定し、AWS 認証情報を構成します

89 * **Claude Platform on AWS**: `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` と `ANTHROPIC_AWS_WORKSPACE_ID` を設定し、AWS 認証情報を構成します89 * **Claude Platform on AWS**: `CLAUDE_CODE_USE_ANTHROPIC_AWS=1` と `ANTHROPIC_AWS_WORKSPACE_ID` を設定し、AWS 認証情報を構成します

90 * **Google Vertex AI**: `CLAUDE_CODE_USE_VERTEX=1` 環境変数を設定し、Google Cloud 認証情報を構成します90 * **Google Cloud の Agent Platform**: `CLAUDE_CODE_USE_VERTEX=1` 環境変数を設定し、Google Cloud 認証情報を構成します

91 * **Microsoft Azure**: `CLAUDE_CODE_USE_FOUNDRY=1` 環境変数を設定し、Azure 認証情報を構成します91 * **Microsoft Azure**: `CLAUDE_CODE_USE_FOUNDRY=1` 環境変数を設定し、Azure 認証情報を構成します

92 92 

93 詳細については、[Bedrock](/ja/amazon-bedrock)、[Claude Platform on AWS](/ja/claude-platform-on-aws)、[Vertex AI](/ja/google-vertex-ai)、または [Azure AI Foundry](/ja/microsoft-foundry) のセットアップガイドを参照してください。93 詳細については、[Amazon Bedrock](/ja/amazon-bedrock)、[Claude Platform on AWS](/ja/claude-platform-on-aws)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、または [Microsoft Foundry](/ja/microsoft-foundry) のセットアップガイドを参照してください。

94 94 

95 <Note>95 <Note>

96 事前に承認されていない限り、Anthropic は、Claude Agent SDK で構築されたエージェントを含む、サードパーティ開発者が claude.ai ログインまたはレート制限を提供することを許可していません。代わりに、このドキュメントで説明されている API キー認証方法を使用してください。96 事前に承認されていない限り、Anthropic は、Claude Agent SDK で構築されたエージェントを含む、サードパーティ開発者が claude.ai ログインまたはレート制限を提供することを許可していません。代わりに、このドキュメントで説明されている API キー認証方法を使用してください。

Details

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

110 110 

111| モード | 説明 | ツール動作 |111| モード | 説明 | ツール動作 |

112| :-------------------- | :--------------- | :----------------------------------------------------------------------------------------------------------- |112| :------------------ | :--------------- | :----------------------------------------------------------------------------------------------------------- |

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

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

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

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

117| `plan` | 計画モード | Claude はソースファイルを編集せずにコードベースを探索および計画します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトが表示されます |117| `plan` | 計画モード | Claude はソースファイルを編集せずにコードベースを探索および計画します。ファイル編集は自動承認されず、`canUseTool` コールバックを通じてプロンプトが表示されます |

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

119 119 

120<Warning>120<Warning>

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

Details

854class ClaudeAgentOptions:854class ClaudeAgentOptions:

855 tools: list[str] | ToolsPreset | None = None855 tools: list[str] | ToolsPreset | None = None

856 allowed_tools: list[str] = field(default_factory=list)856 allowed_tools: list[str] = field(default_factory=list)

857 system_prompt: str | SystemPromptPreset | None = None857 system_prompt: str | SystemPromptPreset | SystemPromptFile | None = None

858 mcp_servers: dict[str, McpServerConfig] | str | Path = field(default_factory=dict)858 mcp_servers: dict[str, McpServerConfig] | str | Path = field(default_factory=dict)

859 strict_mcp_config: bool = False859 strict_mcp_config: bool = False

860 permission_mode: PermissionMode | None = None860 permission_mode: PermissionMode | None = None


897```897```

898 898 

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

900| :---------------------------- | :------------------------------------------------------------------------------------ | :------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |900| :---------------------------- | :------------------------------------------------------------------------------------ | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

901| `tools` | `list[str] \| ToolsPreset \| None` | `None` | ツール設定。Claude Code のデフォルトツールには `{"type": "preset", "preset": "claude_code"}` を使用します |901| `tools` | `list[str] \| ToolsPreset \| None` | `None` | ツール設定。Claude Code のデフォルトツールには `{"type": "preset", "preset": "claude_code"}` を使用します |

902| `allowed_tools` | `list[str]` | `[]` | プロンプトなしで自動承認するツール。これは Claude をこれらのツールのみに制限しません。リストされていないツールは `permission_mode` と `can_use_tool` にフォールスルーします。`disallowed_tools` を使用してツールをブロックします。[パーミッション](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照 |902| `allowed_tools` | `list[str]` | `[]` | プロンプトなしで自動承認するツール。これは Claude をこれらのツールのみに制限しません。リストされていないツールは `permission_mode` と `can_use_tool` にフォールスルーします。`disallowed_tools` を使用してツールをブロックします。[パーミッション](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照 |

903| `system_prompt` | `str \| SystemPromptPreset \| None` | `None` | システムプロンプト設定。カスタムプロンプトの場合は文字列を渡すか、Claude Code のシステムプロンプトの場合は `{"type": "preset", "preset": "claude_code"}` を使用します。プリセットを拡張するには `"append"` を追加します |903| `system_prompt` | `str \| SystemPromptPreset \| SystemPromptFile \| None` | `None` | システムプロンプト設定。カスタムプロンプトの場合は文字列を渡すか、Claude Code のシステムプロンプトの場合は `{"type": "preset", "preset": "claude_code"}` を使用します。オプションの `"append"` を含めるか、`{"type": "file", "path": "..."}` を使用してディスクから大きなプロンプトを読み込みます。[`SystemPromptPreset`](#systempromptpreset) と [`SystemPromptFile`](#systempromptfile) を参照 |

904| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | MCP サーバー設定または設定ファイルへのパス |904| `mcp_servers` | `dict[str, McpServerConfig] \| str \| Path` | `{}` | MCP サーバー設定または設定ファイルへのパス |

905| `strict_mcp_config` | `bool` | `False` | `True` の場合、`mcp_servers` で渡されたサーバーのみを使用し、プロジェクト `.mcp.json`、ユーザー設定、プラグイン提供の MCP サーバー、および [claude.ai コネクタ](/ja/mcp#use-mcp-servers-from-claude-ai) を無視します。CLI `--strict-mcp-config` フラグにマップされます |905| `strict_mcp_config` | `bool` | `False` | `True` の場合、`mcp_servers` で渡されたサーバーのみを使用し、プロジェクト `.mcp.json`、ユーザー設定、プラグイン提供の MCP サーバー、および [claude.ai コネクタ](/ja/mcp#use-mcp-servers-from-claude-ai) を無視します。CLI `--strict-mcp-config` フラグにマップされます |

906| `permission_mode` | `PermissionMode \| None` | `None` | ツール使用のパーミッションモード |906| `permission_mode` | `PermissionMode \| None` | `None` | ツール使用のパーミッションモード |


924| `max_buffer_size` | `int \| None` | `None` | CLI stdout をバッファリングする場合の最大バイト数 |924| `max_buffer_size` | `int \| None` | `None` | CLI stdout をバッファリングする場合の最大バイト数 |

925| `debug_stderr` | `Any` | `sys.stderr` | *非推奨* - デバッグ出力用のファイルのようなオブジェクト。代わりに `stderr` コールバックを使用してください |925| `debug_stderr` | `Any` | `sys.stderr` | *非推奨* - デバッグ出力用のファイルのようなオブジェクト。代わりに `stderr` コールバックを使用してください |

926| `stderr` | `Callable[[str], None] \| None` | `None` | CLI からの stderr 出力用のコールバック関数 |926| `stderr` | `Callable[[str], None] \| None` | `None` | CLI からの stderr 出力用のコールバック関数 |

927| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | ツールパーミッションコールバック関数。[パーミッション評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) が プロンプトに解決される場合にのみ呼び出されます。`allowed_tools` エントリ、設定許可ルール、または `permission_mode` によって事前承認されたツール呼び出しは呼び出されません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` hook](/ja/agent-sdk/hooks) を使用してください。[`CanUseTool`](#canusetool) を参照 |927| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | ツールパーミッションコールバック関数。[パーミッション評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトに解決される場合にのみ呼び出されます。`allowed_tools` エントリ、設定許可ルール、または `permission_mode` によって事前承認されたツール呼び出しは呼び出されません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` hook](/ja/agent-sdk/hooks) を使用してください。[`CanUseTool`](#canusetool) を参照 |

928| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | イベントをインターセプトするための hook 設定 |928| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | イベントをインターセプトするための hook 設定 |

929| `user` | `str \| None` | `None` | ユーザー識別子 |929| `user` | `str \| None` | `None` | ユーザー識別子 |

930| `include_partial_messages` | `bool` | `False` | 部分的なメッセージストリーミングイベントを含めます。有効にすると、[`StreamEvent`](#streamevent) メッセージが生成されます |930| `include_partial_messages` | `bool` | `False` | 部分的なメッセージストリーミングイベントを含めます。有効にすると、[`StreamEvent`](#streamevent) メッセージが生成されます |


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

1003| `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) を参照 |

1004 1004 

1005<h3 id="systempromptfile">

1006 `SystemPromptFile`

1007</h3>

1008 

1009ファイルからカスタムシステムプロンプトを読み込むための設定。文字列として渡す代わりに、ファイル形式を使用します。SDK はこれを CLI [`--system-prompt-file`](/ja/cli-reference#system-prompt-flags) フラグにマップします。プロンプトが大きい場合はファイル形式を使用します:SDK は文字列 `system_prompt` を CLI サブプロセス argv に渡します。これは OS コマンドライン長制限の対象となり、SDK が API リクエストを送信する前に失敗します。Linux では、単一の引数が約 128 KB より長い場合、`Argument list too long` でプロセス生成に失敗します。Windows では、コマンドライン全体が約 32 KB に制限されているため、文字列形式はより低いしきい値で失敗します。

1010 

1011```python theme={null}

1012class SystemPromptFile(TypedDict):

1013 type: Literal["file"]

1014 path: str

1015```

1016 

1017| フィールド | 必須 | 説明 |

1018| :----- | :- | :------------------------------------- |

1019| `type` | はい | プロンプトをディスクから読み込むには `"file"` である必要があります |

1020| `path` | はい | システムプロンプトを含むファイルへのパス |

1021 

1005<h3 id="settingsource">1022<h3 id="settingsource">

1006 `SettingSource`1023 `SettingSource`

1007</h3>1024</h3>


1192 "plan", # Planning mode - explore without editing1209 "plan", # Planning mode - explore without editing

1193 "dontAsk", # Deny anything not pre-approved instead of prompting1210 "dontAsk", # Deny anything not pre-approved instead of prompting

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

1212 "auto", # A model classifier approves or denies each tool call

1195]1213]

1196```1214```

1197 1215 


1755```1773```

1756 1774 

1757| フィールド | 型 | 説明 |1775| フィールド | 型 | 説明 |

1758| :------------------- | :--------------- | :----------------------------- |1776| :------------------- | :--------------- | :-------------------------------------------------------------------------------------------------------------------- |

1759| `uuid` | `str` | このイベントの一意の識別子 |1777| `uuid` | `str` | このイベントの一意の識別子 |

1760| `session_id` | `str` | セッション識別子 |1778| `session_id` | `str` | セッション識別子 |

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

1762| `parent_tool_use_id` | `str \| None` | このイベントがサブエージェントからの場合の親ツール使用 ID |1780| `parent_tool_use_id` | `str \| None` | 常に `None`。ストリームイベントはメインセッションのみに対して発行されます。サブエージェント属性については、[`AssistantMessage`](#assistantmessage) などの完全なメッセージを使用してください |

1763 1781 

1764<h3 id="ratelimitevent">1782<h3 id="ratelimitevent">

1765 `RateLimitEvent`1783 `RateLimitEvent`


2393 tool_name: str2411 tool_name: str

2394 tool_input: dict[str, Any]2412 tool_input: dict[str, Any]

2395 permission_suggestions: NotRequired[list[Any]]2413 permission_suggestions: NotRequired[list[Any]]

2414 agent_id: NotRequired[str]

2415 agent_type: NotRequired[str]

2396```2416```

2397 2417 

2398| フィールド | 型 | 説明 |2418| フィールド | 型 | 説明 |

2399| :----------------------- | :----------------------------- | :--------------------- |2419| :----------------------- | :----------------------------- | :------------------------------------ |

2400| `hook_event_name` | `Literal["PermissionRequest"]` | 常に "PermissionRequest" |2420| `hook_event_name` | `Literal["PermissionRequest"]` | 常に "PermissionRequest" |

2401| `tool_name` | `str` | パーミッションをリクエストするツールの名前 |2421| `tool_name` | `str` | パーミッションをリクエストするツールの名前 |

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

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

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

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

2404 2426 

2405<h3 id="hookjsonoutput">2427<h3 id="hookjsonoutput">

2406 `HookJSONOutput`2428 `HookJSONOutput`

Details

121 121 

122 * **Amazon Bedrock**:`CLAUDE_CODE_USE_BEDROCK=1` 環境変数を設定し、AWS 認証情報を構成します122 * **Amazon Bedrock**:`CLAUDE_CODE_USE_BEDROCK=1` 環境変数を設定し、AWS 認証情報を構成します

123 * **Claude Platform on AWS**:`CLAUDE_CODE_USE_ANTHROPIC_AWS=1` と `ANTHROPIC_AWS_WORKSPACE_ID` を設定し、AWS 認証情報を構成します123 * **Claude Platform on AWS**:`CLAUDE_CODE_USE_ANTHROPIC_AWS=1` と `ANTHROPIC_AWS_WORKSPACE_ID` を設定し、AWS 認証情報を構成します

124 * **Google Vertex AI**:`CLAUDE_CODE_USE_VERTEX=1` 環境変数を設定し、Google Cloud 認証情報を構成します124 * **Google Cloud の Agent Platform**:`CLAUDE_CODE_USE_VERTEX=1` 環境変数を設定し、Google Cloud 認証情報を構成します

125 * **Microsoft Azure**:`CLAUDE_CODE_USE_FOUNDRY=1` 環境変数を設定し、Azure 認証情報を構成します125 * **Microsoft Azure**:`CLAUDE_CODE_USE_FOUNDRY=1` 環境変数を設定し、Azure 認証情報を構成します

126 126 

127 詳細については、[Bedrock](/ja/amazon-bedrock)、[Claude Platform on AWS](/ja/claude-platform-on-aws)、[Vertex AI](/ja/google-vertex-ai)、または [Azure AI Foundry](/ja/microsoft-foundry) のセットアップガイドを参照してください。127 詳細については、[Amazon Bedrock](/ja/amazon-bedrock)、[Claude Platform on AWS](/ja/claude-platform-on-aws)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、または [Microsoft Foundry](/ja/microsoft-foundry) のセットアップガイドを参照してください。

128 128 

129 <Note>129 <Note>

130 事前に承認されていない限り、Anthropic は、Claude Agent SDK で構築されたエージェントを含む、サードパーティ開発者が claude.ai ログインまたはレート制限を提供することを許可していません。代わりに、このドキュメントで説明されている API キー認証方法を使用してください。130 事前に承認されていない限り、Anthropic は、Claude Agent SDK で構築されたエージェントを含む、サードパーティ開発者が claude.ai ログインまたはレート制限を提供することを許可していません。代わりに、このドキュメントで説明されている API キー認証方法を使用してください。


368**権限モード** は、必要な人間の監視の量を制御します:368**権限モード** は、必要な人間の監視の量を制御します:

369 369 

370| モード | 動作 | ユースケース |370| モード | 動作 | ユースケース |

371| --------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------- |371| ------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------- |

372| `acceptEdits` | ファイル編集と一般的なファイルシステムコマンドを自動承認し、他のアクションについては確認します | 信頼できる開発ワークフロー |372| `acceptEdits` | ファイル編集と一般的なファイルシステムコマンドを自動承認し、他のアクションについては確認します | 信頼できる開発ワークフロー |

373| `plan` | 読み取り専用ツールを実行します。ファイル編集は自動承認されず、`canUseTool` コールバックに到達します | 実行を承認する前にタスクをスコープする |373| `plan` | 読み取り専用ツールを実行します。ファイル編集は自動承認されず、`canUseTool` コールバックに到達します | 実行を承認する前にタスクをスコープする |

374| `dontAsk` | `allowedTools` にないものを拒否します | ロックダウンされたヘッドレスエージェント |374| `dontAsk` | `allowedTools` にないものを拒否します | ロックダウンされたヘッドレスエージェント |

375| `auto`(TypeScript のみ) | モデル分類器が各ツール呼び出しを承認または拒否します | 安全ガードレール付きの自律エージェント |375| `auto` | モデル分類器が各ツール呼び出しを承認または拒否します | 安全ガードレール付きの自律エージェント |

376| `bypassPermissions` | 明示的な [`ask` ルール](/ja/agent-sdk/permissions#how-permissions-are-evaluated) に一致しない限り、プロンプトなしですべてのツールを実行します | サンドボックス化された CI、完全に信頼できる環境 |376| `bypassPermissions` | 明示的な [`ask` ルール](/ja/agent-sdk/permissions#how-permissions-are-evaluated) に一致しない限り、プロンプトなしですべてのツールを実行します | サンドボックス化された CI、完全に信頼できる環境 |

377| `default` | 承認を処理するために `canUseTool` コールバックが必要です | カスタム承認フロー |377| `default` | 承認を処理するために `canUseTool` コールバックが必要です | カスタム承認フロー |

378 378 

Details

91 uuid: str # このイベントの一意の識別子91 uuid: str # このイベントの一意の識別子

92 session_id: str # セッション識別子92 session_id: str # セッション識別子

93 event: dict[str, Any] # 生の Claude API ストリームイベント93 event: dict[str, Any] # 生の Claude API ストリームイベント

94 parent_tool_use_id: str | None # サブエージェントからの場合は親ツール ID94 parent_tool_use_id: str | None # 常に None

95 ```95 ```

96 96 

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


106 ```106 ```

107</CodeGroup>107</CodeGroup>

108 108 

109`parent_tool_use_id` フィールドは Python では常に `None`、TypeScript では `null` です。ストリームイベントはメインセッションのみに対して発行されます。サブエージェントからのトークンレベルのデルタは転送されません。出力をサブエージェントに属性付けするには、`parent_tool_use_id` を含む完全なメッセージを使用してください。[サブエージェント呼び出しの検出](/ja/agent-sdk/subagents#detect-subagent-invocation)を参照してください。

110 

109`event` フィールドには、[Claude API](https://platform.claude.com/docs/ja/build-with-claude/streaming#event-types) からの生のストリーミングイベントが含まれます。一般的なイベントタイプは以下の通りです:111`event` フィールドには、[Claude API](https://platform.claude.com/docs/ja/build-with-claude/streaming#event-types) からの生のストリーミングイベントが含まれます。一般的なイベントタイプは以下の通りです:

110 112 

111| イベントタイプ | 説明 |113| イベントタイプ | 説明 |

Details

247 247 

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) を参照してください。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有効な JSON Schema ではないスキーマは、問題を示すエラーで起動時に実行に失敗します。v2.1.205 より前は、無効なスキーマは暗黙的に無視され、エージェントは非構造化テキストを返していました。

251 

252`"format": "email"` などの `format` キーワードは、注釈として受け入れられ、SDK のバリデーターによって強制されません。v2.1.205 より前は、`format` を含むスキーマは無効として扱われていました。

253 

250<h2 id="example-todo-tracking-agent">254<h2 id="example-todo-tracking-agent">

251 例:TODO トラッキングエージェント255 例:TODO トラッキングエージェント

252</h2>256</h2>

Details

234 親はサブエージェントの最終メッセージを Agent ツール結果として逐語的に受け取りますが、独自の応答で要約する場合があります。サブエージェント出力を逐語的にユーザー向けの応答で保持するには、メイン `query()` 呼び出しに渡すプロンプトまたは `systemPrompt` オプションに指示を含めてください。234 親はサブエージェントの最終メッセージを Agent ツール結果として逐語的に受け取りますが、独自の応答で要約する場合があります。サブエージェント出力を逐語的にユーザー向けの応答で保持するには、メイン `query()` 呼び出しに渡すプロンプトまたは `systemPrompt` オプションに指示を含めてください。

235</Note>235</Note>

236 236 

237Claude Code v2.1.199 以降、レート制限などでサブエージェントを早期に終了させる API エラーは、その結果として配信されることはありません。サブエージェントが既に出力を生成している場合、Agent ツールはサブエージェントが完了しなかったというメモ付きでその部分的な出力を返します。それ以外の場合ツール結果はエラーメッセージ「Agent terminated early due to an API error」の後にエラーの詳細が続きますバックグラウンドおよびフォアグラウンドの動作については、[サブエージェントの API エラー](/ja/sub-agents#api-errors-in-subagents)を参照してください。237サブエージェントを早期に終了させるレート制限などの API エラーは、その結果として配信されることはありません。レート制限オーバーロード、またはサーバーエラーがすでにテキスト出力を生成しているフォアグラウンドサブエージェントを遮断した場合、Agent ツールはサブエージェントが完了しなかったというメモ付きでその部分的な出力を返します。何も出力しなかったサブエージェントまたはテキストのないツール呼び出しのみが出力だったサブエージェントは、エラーメッセージ「Agent terminated early due to an API error」の後にエラーの詳細が続いて失敗しますフォアグラウンドおよびバックグラウンドの動作については、[サブエージェントの API エラー](/ja/sub-agents#api-errors-in-subagents)を参照してください。

238 

239この部分的な出力処理には Claude Code v2.1.199 以降が必要です。v2.1.199 では、レート制限、オーバーロード、またはサーバーエラーは、ツール呼び出しのみの形状を遮断メモのみを含む空の部分的な結果のままにしました。

238 240 

239<h2 id="invoke-subagents">241<h2 id="invoke-subagents">

240 サブエージェントの呼び出し242 サブエージェントの呼び出し

Details

296</h4>296</h4>

297 297 

298| プロパティ | 型 | 説明 |298| プロパティ | 型 | 説明 |

299| :------------------- | :---------------------- | :---------------------------------------------------------------------------------------- |299| :------------------- | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

300| `type` | `"user" \| "assistant"` | メッセージロール |300| `type` | `"user" \| "assistant"` | メッセージロール |

301| `uuid` | `string` | 一意のメッセージ識別子 |301| `uuid` | `string` | 一意のメッセージ識別子 |

302| `session_id` | `string` | このメッセージが属するセッション |302| `session_id` | `string` | このメッセージが属するセッション |

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| `parent_agent_id` | `string \| null` | [ネストされたサブエージェント](/ja/sub-agents#spawn-nested-subagents)からのメッセージの場合、それをスポーンしたサブエージェントの `agentId`。メインセッションメッセージ、トップレベルサブエージェントからのメッセージ、および古いセッションの場合は `null`。{/* min-version: 2.1.202 */}Claude Code v2.1.202 以降が必要です |

305 306 

306<h4 id="example-2">307<h4 id="example-2">

307308


472| `agent` | `string` | `undefined` | メインスレッドのエージェント名。エージェントは `agents` オプションまたは設定で定義される必要があります |473| `agent` | `string` | `undefined` | メインスレッドのエージェント名。エージェントは `agents` オプションまたは設定で定義される必要があります |

473| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | プログラムでサブエージェントを定義します |474| `agents` | `Record<string, [`AgentDefinition`](#agentdefinition)>` | `undefined` | プログラムでサブエージェントを定義します |

474| `agentProgressSummaries` | `boolean` | `false` | `true` の場合、サブエージェントの 1 行の進捗サマリーを生成し、`summary` フィールドを介して [`task_progress`](#sdktaskprogressmessage) イベントで転送します。フォアグラウンドおよびバックグラウンドサブエージェントに適用されます |475| `agentProgressSummaries` | `boolean` | `false` | `true` の場合、サブエージェントの 1 行の進捗サマリーを生成し、`summary` フィールドを介して [`task_progress`](#sdktaskprogressmessage) イベントで転送します。フォアグラウンドおよびバックグラウンドサブエージェントに適用されます |

475| `allowDangerouslySkipPermissions` | `boolean` | `false` | パーミッションのバイパスを有効にします。`permissionMode: 'bypassPermissions'` を使用する場合に必須です |476| `allowDangerouslySkipPermissions` | `boolean` | `false` | 権限のバイパスを有効にします。`permissionMode: 'bypassPermissions'` を使用する場合に必須です |

476| `allowedTools` | `string[]` | `[]` | プロンプトなしで自動承認するツール。これは Claude をこれらのツールのみに制限しません。リストされていないツールは `permissionMode` と `canUseTool` にフォールスルーします。ツールをブロックするには `disallowedTools` を使用します。[パーミッション](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照してください |477| `allowedTools` | `string[]` | `[]` | プロンプトなしで自動承認するツール。これは Claude をこれらのツールのみに制限しません。リストされていないツールは `permissionMode` と `canUseTool` にフォールスルーします。ツールをブロックするには `disallowedTools` を使用します。[権限](/ja/agent-sdk/permissions#allow-and-deny-rules) を参照してください |

477| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | ベータ機能を有効にします |478| `betas` | [`SdkBeta`](#sdkbeta)`[]` | `[]` | ベータ機能を有効にします |

478| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | カスタム権限関数。[権限フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) が プロンプトにフォールスルーする場合にのみ呼び出されます。`allowedTools`、許可ルール、または `permissionMode` によって自動承認されたツール呼び出しに対しては呼び出されません。詳細は [`CanUseTool`](#canusetool) を参照してください |479| `canUseTool` | [`CanUseTool`](#canusetool) | `undefined` | カスタム権限関数。[権限フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトにフォールスルーする場合にのみ呼び出されます。`allowedTools`、許可ルール、または `permissionMode` によって自動承認されたツール呼び出しに対しては呼び出されません。詳細は [`CanUseTool`](#canusetool) を参照してください |

479| `continue` | `boolean` | `false` | 最新の会話を続けます |480| `continue` | `boolean` | `false` | 最新の会話を続けます |

480| `cwd` | `string` | `process.cwd()` | 現在の作業ディレクトリ |481| `cwd` | `string` | `process.cwd()` | 現在の作業ディレクトリ |

481| `debug` | `boolean` | `false` | Claude Code プロセスのデバッグモードを有効にします |482| `debug` | `boolean` | `false` | Claude Code プロセスのデバッグモードを有効にします |

482| `debugFile` | `string` | `undefined` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします |483| `debugFile` | `string` | `undefined` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします |

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

484| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | モデルのデフォルト | Claude がその応答にどれだけの努力を費やすかを制御します。適応的思考と連携して思考の深さをガイドします。[努力レベルを調整](/ja/model-config#adjust-effort-level) を参照してください |485| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max'` | モデルのデフォルト | Claude がその応答にどれだけの努力を費やすかを制御します。適応的思考と連携して思考の深さをガイドします。[努力レベルを調整](/ja/model-config#adjust-effort-level) を参照してください |

485| `enableFileCheckpointing` | `boolean` | `false` | ファイル変更追跡を有効にして巻き戻します。[ファイルチェックポイント](/ja/agent-sdk/file-checkpointing) を参照してください |486| `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` を設定します |487| `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` を設定します |


504| `outputFormat` | `{ type: 'json_schema', schema: JSONSchema }` | `undefined` | エージェント結果の出力形式を定義します。詳細は [構造化出力](/ja/agent-sdk/structured-outputs) を参照してください |505| `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) を参照してください |506| `outputStyle` | `string` | `undefined` | `Options` フィールドではありません。インライン [`settings`](/ja/settings) オブジェクトまたは設定ファイルで `outputStyle` を設定してください。[出力スタイルをアクティブにする](/ja/agent-sdk/modifying-system-prompts#activate-an-output-style) を参照してください |

506| `pathToClaudeCodeExecutable` | `string` | バンドルされたネイティブバイナリから自動解決 | Claude Code 実行可能ファイルへのパス。インストール中にオプション依存関係がスキップされた場合、またはプラットフォームがサポートされているセットにない場合にのみ必要です |507| `pathToClaudeCodeExecutable` | `string` | バンドルされたネイティブバイナリから自動解決 | Claude Code 実行可能ファイルへのパス。インストール中にオプション依存関係がスキップされた場合、またはプラットフォームがサポートされているセットにない場合にのみ必要です |

507| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | セッションのパーミッションモード |508| `permissionMode` | [`PermissionMode`](#permissionmode) | `'default'` | セッションの権限モード |

508| `permissionPromptToolName` | `string` | `undefined` | パーミッションプロンプト用の MCP ツール名 |509| `permissionPromptToolName` | `string` | `undefined` | 権限プロンプト用の MCP ツール名 |

509| `persistSession` | `boolean` | `true` | `false` の場合、セッション永続化をディスクに無効にします。セッションは後で再開できません |510| `persistSession` | `boolean` | `true` | `false` の場合、セッション永続化をディスクに無効にします。セッションは後で再開できません |

510| `planModeInstructions` | `string` | `undefined` | プランモードのカスタムワークフロー指示。`permissionMode` が `'plan'` の場合、この文字列はデフォルトのプランモードワークフロー本体を置き換えます。CLI は引き続き読み取り専用強制プリアンブルと ExitPlanMode プロトコルフッターでラップします |511| `planModeInstructions` | `string` | `undefined` | プランモードのカスタムワークフロー指示。`permissionMode` が `'plan'` の場合、この文字列はデフォルトのプランモードワークフロー本体を置き換えます。CLI は引き続き読み取り専用強制プリアンブルと ExitPlanMode プロトコルフッターでラップします |

511| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | ローカルパスからカスタムプラグインをロードします。詳細は [プラグイン](/ja/agent-sdk/plugins) を参照してください |512| `plugins` | [`SdkPluginConfig`](#sdkpluginconfig)`[]` | `[]` | ローカルパスからカスタムプラグインをロードします。詳細は [プラグイン](/ja/agent-sdk/plugins) を参照してください |


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

518| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *アルファ版。* `sessionStore` のフラッシュモード。`sessionStore` が設定されていない場合は無視されます |519| `sessionStoreFlush` | `'batched' \| 'eager'` | `'batched'` | *アルファ版。* `sessionStore` のフラッシュモード。`sessionStore` が設定されていない場合は無視されます |

519| `settings` | `string \| Settings` | `undefined` | インライン [設定](/ja/settings) オブジェクトまたは設定ファイルへのパス。[優先順位](/ja/settings#settings-precedence) のフラグ設定レイヤーを入力します。[`applyFlagSettings()`](#applyflagsettings) でランタイムに変更します |520| `settings` | `string \| Settings` | `undefined` | インライン [設定](/ja/settings) オブジェクトまたは設定ファイルへのパス。[優先順位](/ja/settings#settings-precedence) のフラグ設定レイヤーを入力します。[`applyFlagSettings()`](#applyflagsettings) でランタイムに変更します |

520| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI デフォルト(すべてのソース) | ロードするファイルシステム設定を制御します。ユーザー、プロジェクト、ローカル設定を無効にするには `[]` を渡します。管理ポリシー設定は関係なくロードされます。サーバー管理設定は、[適格な設定](/ja/server-managed-settings#platform-availability) で組織認証情報を使用してセッションが認証されるときにフェッチされます。[Claude Code 機能を使用](/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照してください |521| `settingSources` | [`SettingSource`](#settingsource)`[]` | CLI デフォルト(すべてのソース) | ロードするファイルシステム設定を制御します。ユーザー、プロジェクト、ローカル設定を無効にするには `[]` を渡します。[エンドポイント管理ポリシー](/ja/settings#settings-files) は関係なくロードされます。サーバー管理設定は、[適格な設定](/ja/server-managed-settings#platform-availability) で組織認証情報を使用してセッションが認証されるときにフェッチされます。[Claude Code 機能を使用](/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control) を参照してください |

521| `skills` | `string[] \| 'all'` | `undefined` | セッションで利用可能なスキル。すべての検出されたスキルを有効にするには `'all'` を渡すか、スキル名のリストを渡します。設定すると、SDK は `allowedTools` に `'Skill'` を含めていなくても Skill ツールを自動的に追加します。`tools` も渡す場合は、そのリストに `'Skill'` を含めます。[スキル](/ja/agent-sdk/skills) を参照してください |522| `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 を実行するために使用します |523| `spawnClaudeCodeProcess` | `(options: SpawnOptions) => SpawnedProcess` | `undefined` | Claude Code プロセスをスポーンするカスタム関数。VM、コンテナ、またはリモート環境で Claude Code を実行するために使用します |

523| `stderr` | `(data: string) => void` | `undefined` | stderr 出力のコールバック |524| `stderr` | `(data: string) => void` | `undefined` | stderr 出力のコールバック |


563 564 

564```typescript theme={null}565```typescript theme={null}

565interface Query extends AsyncGenerator<SDKMessage, void> {566interface Query extends AsyncGenerator<SDKMessage, void> {

566 interrupt(): Promise<void>;567 interrupt(): Promise<SDKControlInterruptResponse | undefined>;

567 rewindFiles(568 rewindFiles(

568 userMessageId: string,569 userMessageId: string,

569 options?: { dryRun?: boolean }570 options?: { dryRun?: boolean }


593</h4>594</h4>

594 595 

595| メソッド | 説明 |596| メソッド | 説明 |

596| :------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |597| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

597| `interrupt()` | クエリを中断します(ストリーミング入力モードでのみ利用可能) |598| `interrupt()` | クエリを中断します。ストリーミング入力モードでのみ利用可能です。{/* min-version: 2.1.205 */}CLI が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機能をアドバタイズする場合、中断を生き残るキューに入れられたメッセージをリストする [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) で解決します。v2.1.205 より前の CLI では `undefined` で解決します |

598| `rewindFiles(userMessageId, options?)` | ファイルを指定されたユーザーメッセージの状態に復元します。`{ dryRun: true }` を渡して変更をプレビューします。`enableFileCheckpointing: true` が必須です。[ファイルチェックポイント](/ja/agent-sdk/file-checkpointing) を参照してください |599| `rewindFiles(userMessageId, options?)` | ファイルを指定されたユーザーメッセージの状態に復元します。`{ dryRun: true }` を渡して変更をプレビューします。`enableFileCheckpointing: true` が必須です。[ファイルチェックポイント](/ja/agent-sdk/file-checkpointing) を参照してください |

599| `setPermissionMode()` | パーミッションモードを変更します(ストリーミング入力モードでのみ利用可能) |600| `setPermissionMode()` | 権限モードを変更します(ストリーミング入力モードでのみ利用可能) |

600| `setModel()` | モデルを変更します(ストリーミング入力モードでのみ利用可能) |601| `setModel()` | モデルを変更します(ストリーミング入力モードでのみ利用可能) |

601| `setMaxThinkingTokens()` | *非推奨:* 代わりに `thinking` オプションを使用してください。最大思考トークン数を変更します |602| `setMaxThinkingTokens()` | *非推奨:* 代わりに `thinking` オプションを使用してください。最大思考トークン数を変更します |

602| `applyFlagSettings(settings)` | ランタイムにセッションのフラグ設定レイヤーに設定をマージします(ストリーミング入力モードでのみ利用可能)。[`applyFlagSettings()`](#applyflagsettings) を参照してください |603| `applyFlagSettings(settings)` | ランタイムにセッションのフラグ設定レイヤーに設定をマージします(ストリーミング入力モードでのみ利用可能)。[`applyFlagSettings()`](#applyflagsettings) を参照してください |

603| `initializationResult()` | サポートされているコマンド、モデル、アカウント情報、出力スタイル設定を含む完全な初期化結果を返します |604| `initializationResult()` | サポートされているコマンド、モデル、アカウント情報、出力スタイル設定を含む完全な初期化結果を返します |

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

605| `supportedCommands()` | 利用可能なスラッシュコマンドを返します |606| `supportedCommands()` | 利用可能なスラッシュコマンドを返します |

606| `supportedModels()` | 表示情報を含む利用可能なモデルを返します |607| `supportedModels()` | 表示情報を含む利用可能なモデルを返します |

607| `supportedAgents()` | 利用可能なサブエージェントを [`AgentInfo`](#agentinfo)`[]` として返します |608| `supportedAgents()` | 利用可能なサブエージェントを [`AgentInfo`](#agentinfo)`[]` として返します |


625* **次のターンで適用される**:`model`、`effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`awaySummaryEnabled`、`agent`。`agent` を切り替えると、そのエージェントのモデルオーバーライド、フック、システムプロンプトも次のターンで適用されます。626* **次のターンで適用される**:`model`、`effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`awaySummaryEnabled`、`agent`。`agent` を切り替えると、そのエージェントのモデルオーバーライド、フック、システムプロンプトも次のターンで適用されます。

626* **ミッドセッションで効果なし**:システムプロンプトオプション。これらはスタートアップ時に 1 回解決されるため、実行中のセッションは呼び出しが成功しても元の値を保持します。それらを変更するには、新しいセッションを開始してください。627* **ミッドセッションで効果なし**:システムプロンプトオプション。これらはスタートアップ時に 1 回解決されるため、実行中のセッションは呼び出しが成功しても元の値を保持します。それらを変更するには、新しいセッションを開始してください。

627 628 

629`effortLevel` は [努力レベル](/ja/model-config#adjust-effort-level) 名を受け入れます。また、`"ultracode"` も受け入れます。これはセッションを `xhigh` 努力で実行し、[ultracode](/ja/workflows#let-claude-decide-with-ultracode) をオンにします。`Settings` 型はその値なしで `effortLevel` を宣言しているため、TypeScript では同等の `{ ultracode: true }` を渡します。{/* min-version: 2.1.203 */}`ultracode` 値には Claude Code v2.1.203 以降が必要であり、設定ファイルの `effortLevel` キーではなく、`applyFlagSettings()` によってのみ受け入れられます。

630 

628値はフラグ設定レイヤーに書き込まれます。これは、`query()` のインライン `settings` オプションがスタートアップ時に入力するのと同じレイヤーです。フラグ設定は [設定優先順位](/ja/settings#settings-precedence) の上部付近に位置します。ユーザー、プロジェクト、ローカル設定をオーバーライドし、管理ポリシー設定のみがそれらをオーバーライドできます。これは、[優先順位セクション](#settings-precedence) がプログラム的なオプションと呼ぶのと同じティアです。631値はフラグ設定レイヤーに書き込まれます。これは、`query()` のインライン `settings` オプションがスタートアップ時に入力するのと同じレイヤーです。フラグ設定は [設定優先順位](/ja/settings#settings-precedence) の上部付近に位置します。ユーザー、プロジェクト、ローカル設定をオーバーライドし、管理ポリシー設定のみがそれらをオーバーライドできます。これは、[優先順位セクション](#settings-precedence) がプログラム的なオプションと呼ぶのと同じティアです。

629 632 

630連続した呼び出しは、トップレベルキーを浅くマージします。`{ permissions: {...} }` を含む 2 番目の呼び出しは、前の呼び出しから `permissions` オブジェクト全体を置き換えます。深くマージするのではなく。フラグレイヤーからキーをクリアして、より低い優先度のソースにフォールバックするには、そのキーに `null` を渡します。`undefined` を渡すと、JSON シリアル化がそれをドロップするため、効果がありません。633連続した呼び出しは、トップレベルキーを浅くマージします。`{ permissions: {...} }` を含む 2 番目の呼び出しは、前の呼び出しから `permissions` オブジェクト全体を置き換えます。深くマージするのではなく。フラグレイヤーからキーをクリアして、より低い優先度のソースにフォールバックするには、そのキーに `null` を渡します。`undefined` を渡すと、JSON シリアル化がそれをドロップするため、効果がありません。


689};692};

690```693```

691 694 

692クライアントが既に実行中のセッションに `initialize` を送信する場合、コントロールレスポンスラッパーは、オプションの `pending_permission_requests` 配列も含みます。フィールドはレスポンスラッパー自体にあり、上記の `SDKControlInitializeResponse` ペイロードにはありません。各エントリは、セッションが実行中にストリーミングするパーミッションリクエストと同じ `{ type: "control_request", request_id, request }` 形状を持つ完全な `control_request` メッセージです。695クライアントが既に実行中のセッションに `initialize` を送信する場合、コントロールレスポンスラッパーは、オプションの `pending_permission_requests` 配列も含みます。フィールドはレスポンスラッパー自体にあり、上記の `SDKControlInitializeResponse` ペイロードにはありません。各エントリは、セッションが実行中にストリーミングする権限リクエストと同じ `{ type: "control_request", request_id, request }` 形状を持つ完全な `control_request` メッセージです。

693 696 

694これらは、クライアントが接続する前に発行され、まだ返信を待っているリクエストです。SDK はこの配列を読み取り、各エントリを [`canUseTool`](#canusetool) コールバックにディスパッチします。これは、トランスポートギャップ後に [`reinitialize()`](#query-object) がトリガーする再配信と同じです。繰り返されたリクエスト ID をべき等に処理してください。接続が切断される前にコールバックが既に受け取ったリクエストを繰り返すエントリが存在する可能性があるためです。697これらは、クライアントが接続する前に発行され、まだ返信を待っているリクエストです。SDK はこの配列を読み取り、各エントリを [`canUseTool`](#canusetool) コールバックにディスパッチします。これは、トランスポートギャップ後に [`reinitialize()`](#query-object) がトリガーする再配信と同じです。繰り返されたリクエスト ID をべき等に処理してください。接続が切断される前にコールバックが既に受け取ったリクエストを繰り返すエントリが存在する可能性があるためです。

695 698 

699<h3 id="sdkcontrolinterruptresponse">

700 `SDKControlInterruptResponse`

701</h3>

702 

703中断レシート:[`interrupt()`](#query-object) が [`SDKSystemMessage.capabilities`](#sdksystemmessage) で `interrupt_receipt_v1` 機能をアドバタイズする CLI で解決する値。Claude Code v2.1.205 以降が必要です。以前の CLI は中断に空の成功ペイロードで応答するため、`interrupt()` は `undefined` で解決します。

704 

705```typescript theme={null}

706type SDKControlInterruptResponse = {

707 still_queued: string[];

708};

709```

710 

711`still_queued` は中断を生き残るユーザーメッセージの UUID をリストします:キューに残っているメッセージ、および次のターンのためにすでにデキューされたが、まだ中止によって到達できないバッチ。各メッセージは、中断後に独自のターンとして実行されます。最初にキャンセルしない限り。レシートを使用して、何かを再送信するかどうかを決定します。既にリストされているメッセージを再送信すると、重複したターンが生成されます。

712 

713これらの注意事項でリストを解釈します:

714 

715* UUID が付いてエンキューされたメッセージのみが表示されます。空の配列は、他に何も実行されないことを意味しません。

716* メインスレッドメッセージのみがリストされます。サブエージェントにアドレス指定されたメッセージはスコープ外です。

717* リストには、クライアントが送信しなかった UUID([スケジュール済みタスク](/ja/scheduled-tasks) トリガーなど)が含まれる場合があります。認識しない UUID は、エラーとして扱う代わりに無視してください。

718 

719レシートは中断が処理される瞬間に取得されたスナップショットであり、クリーンな中断では、中断されたターンの [`SDKResultMessage`](#sdkresultmessage) の前に到着します。その結果の後にキューを検査するのではなく、レシートを読んでください。ループは次のキューに入れられたターンをすぐに開始するため、結果の後に検査するキューは既に変更されています。

720 

696<h3 id="agentdefinition">721<h3 id="agentdefinition">

697 `AgentDefinition`722 `AgentDefinition`

698</h3>723</h3>


732| `background` | いいえ | 呼び出されたときにこのエージェントをノンブロッキングバックグラウンドタスクとして実行します |757| `background` | いいえ | 呼び出されたときにこのエージェントをノンブロッキングバックグラウンドタスクとして実行します |

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

734| `effort` | いいえ | このエージェントの推論努力レベル。名前付きレベルまたは整数を受け入れます |759| `effort` | いいえ | このエージェントの推論努力レベル。名前付きレベルまたは整数を受け入れます |

735| `permissionMode` | いいえ | このエージェント内のツール実行のパーミッションモード。[`PermissionMode`](#permissionmode) を参照してください |760| `permissionMode` | いいえ | このエージェント内のツール実行の権限モード。[`PermissionMode`](#permissionmode) を参照してください |

736| `criticalSystemReminder_EXPERIMENTAL` | いいえ | 実験的:システムプロンプトに追加される重要なリマインダー |761| `criticalSystemReminder_EXPERIMENTAL` | いいえ | 実験的:システムプロンプトに追加される重要なリマインダー |

737 762 

738<h3 id="agentmcpserverspec">763<h3 id="agentmcpserverspec">


874 899 

875```typescript theme={null}900```typescript theme={null}

876type PermissionMode =901type PermissionMode =

877 | "default" // 標準的なパーミッション動作902 | "default" // 標準的な権限動作

878 | "acceptEdits" // ファイル編集を自動承認903 | "acceptEdits" // ファイル編集を自動承認

879 | "bypassPermissions" // パーミッションチェックをバイパス;明示的な質問ルールはまだプロンプトします904 | "bypassPermissions" // 権限チェックをバイパス;明示的な質問ルールはまだプロンプトします

880 | "plan" // 計画モード - 編集なしで探索905 | "plan" // 計画モード - 編集なしで探索

881 | "dontAsk" // パーミッションをプロンプトしない、事前承認されていない場合は拒否906 | "dontAsk" // 権限をプロンプトしない、事前承認されていない場合は拒否

882 | "auto"; // モデル分類器を使用して各ツール呼び出しを承認または拒否907 | "auto"; // モデル分類器を使用して各ツール呼び出しを承認または拒否

883```908```

884 909 


886 `CanUseTool`911 `CanUseTool`

887</h3>912</h3>

888 913 

889ツール使用を制御するためのカスタムパーミッション関数型914ツール使用を制御するためのカスタム権限関数型

890 915 

891関数は、インタラクティブな権限プロンプトの SDK 置き換えです。[権限評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトに解決される場合にのみ呼び出されます。`allowedTools` エントリ、設定許可ルール、または `acceptEdits` や `bypassPermissions` などの権限モードによって既に承認されたツール呼び出しは、それを呼び出しません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` フック](/ja/agent-sdk/hooks) を使用します。916関数は、インタラクティブな権限プロンプトの SDK 置き換えです。[権限評価フロー](/ja/agent-sdk/permissions#how-permissions-are-evaluated) がプロンプトに解決される場合にのみ呼び出されます。`allowedTools` エントリ、設定許可ルール、または `acceptEdits` や `bypassPermissions` などの権限モードによって既に承認されたツール呼び出しは、それを呼び出しません。すべてのツール呼び出しをゲートするには、代わりに [`PreToolUse` フック](/ja/agent-sdk/hooks) を使用します。

892 917 


910| :--------------- | :------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |935| :--------------- | :------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

911| `signal` | `AbortSignal` | 操作を中止する必要がある場合にシグナルされます |936| `signal` | `AbortSignal` | 操作を中止する必要がある場合にシグナルされます |

912| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | 提案されたパーミッション更新。ユーザーがこのツールに対して再度プロンプトされないようにします。Bash プロンプトには `localSettings` [宛先](#permissionupdatedestination) を含む提案が含まれているため、`updatedPermissions` で返すと、ルールを `.claude/settings.local.json` に書き込み、セッション全体で永続化します。 |937| `suggestions` | [`PermissionUpdate`](#permissionupdate)`[]` | 提案されたパーミッション更新。ユーザーがこのツールに対して再度プロンプトされないようにします。Bash プロンプトには `localSettings` [宛先](#permissionupdatedestination) を含む提案が含まれているため、`updatedPermissions` で返すと、ルールを `.claude/settings.local.json` に書き込み、セッション全体で永続化します。 |

913| `blockedPath` | `string` | パーミッションリクエストをトリガーしたファイルパス(該当する場合) |938| `blockedPath` | `string` | 権限リクエストをトリガーしたファイルパス(該当する場合) |

914| `decisionReason` | `string` | このパーミッションリクエストがトリガーされた理由を説明します |939| `decisionReason` | `string` | この権限リクエストがトリガーされた理由を説明します |

915| `toolUseID` | `string` | アシスタントメッセージ内のこの特定のツール呼び出しの一意の識別子 |940| `toolUseID` | `string` | アシスタントメッセージ内のこの特定のツール呼び出しの一意の識別子 |

916| `agentID` | `string` | サブエージェント内で実行している場合、サブエージェントの ID |941| `agentID` | `string` | サブエージェント内で実行している場合、サブエージェントの ID |

917| `requestId` | `string` | `control_request` エンベロープの `request_id`。アプリケーションが送信する `control_response`(署名付き HTTP POST など)は、Claude Code プロセスが返信をリクエストと照合できるようにこの値をエコーする必要があります |942| `requestId` | `string` | `control_request` エンベロープの `request_id`。アプリケーションが送信する `control_response`(署名付き HTTP POST など)は、Claude Code プロセスが返信をリクエストと照合できるようにこの値をエコーする必要があります |


924 `PermissionResult`949 `PermissionResult`

925</h3>950</h3>

926 951 

927パーミッションチェックの結果952権限チェックの結果

928 953 

929```typescript theme={null}954```typescript theme={null}

930type PermissionResult =955type PermissionResult =


1097 | SDKTaskStartedMessage1122 | SDKTaskStartedMessage

1098 | SDKTaskProgressMessage1123 | SDKTaskProgressMessage

1099 | SDKTaskUpdatedMessage1124 | SDKTaskUpdatedMessage

1125 | SDKBackgroundTasksChangedMessage

1100 | SDKSessionStateChangedMessage1126 | SDKSessionStateChangedMessage

1101 | SDKWorkerShuttingDownMessage1127 | SDKWorkerShuttingDownMessage

1102 | SDKCommandsChangedMessage1128 | SDKCommandsChangedMessage


1110 | SDKPromptSuggestionMessage1136 | SDKPromptSuggestionMessage

1111 | SDKAPIRetryMessage1137 | SDKAPIRetryMessage

1112 | SDKMirrorErrorMessage1138 | SDKMirrorErrorMessage

1113 | SDKInformationalMessage;1139 | SDKInformationalMessage

1140 | SDKConversationResetMessage;

1114```1141```

1115 1142 

1116<h3 id="sdkassistantmessage">1143<h3 id="sdkassistantmessage">


1273 output_style: string;1300 output_style: string;

1274 skills: string[];1301 skills: string[];

1275 plugins: { name: string; path: string }[];1302 plugins: { name: string; path: string }[];

1303 capabilities?: string[];

1276};1304};

1277```1305```

1278 1306 

1307{/* min-version: 2.1.205 */}

1308 

1309`capabilities` 配列は、この CLI が実装するプロトコル動作に名前を付けるため、`claude_code_version` 文字列を比較する代わりに機能検出を行うことができます。これはオープンセットです:認識しない値は無視し、依存する特定の動作の機能をチェックしてください。このフィールドには Claude Code v2.1.205 以降が必要で、以前の CLI では存在しません。

1310 

1311| 機能 | 意味 |

1312| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |

1313| `interrupt_receipt_v1` | [`interrupt()`](#query-object) は、割り込みを生き残るキューに入れられたメッセージに名前を付ける [`SDKControlInterruptResponse`](#sdkcontrolinterruptresponse) レシートで解決します |

1314 

1279<h3 id="sdkpartialassistantmessage">1315<h3 id="sdkpartialassistantmessage">

1280 `SDKPartialAssistantMessage`1316 `SDKPartialAssistantMessage`

1281</h3>1317</h3>

1282 1318 

1283ストリーミング部分メッセージ(`includePartialMessages` が true の場合のみ)。1319ストリーミング部分メッセージ(`includePartialMessages` が true の場合のみ)。`parent_tool_use_id` フィールドは常に `null` です:ストリームイベントはメインセッションのみに対して発行されます。サブエージェント属性については、`parent_tool_use_id` を持つ完全なメッセージを使用するか、[`forwardSubagentText`](#options) を有効にして、サブエージェントテキストと思考を完全なメッセージとして受け取ります。

1284 1320 

1285```typescript theme={null}1321```typescript theme={null}

1286type SDKPartialAssistantMessage = {1322type SDKPartialAssistantMessage = {


1421type SDKMessageOrigin =1457type SDKMessageOrigin =

1422 | { kind: "human" }1458 | { kind: "human" }

1423 | { kind: "channel"; server: string }1459 | { kind: "channel"; server: string }

1424 | { kind: "peer"; from: string; name?: string; senderTaskId?: string }1460 | {

1461 kind: "peer";

1462 from: string;

1463 name?: string;

1464 senderTaskId?: string;

1465 body?: string;

1466 }

1425 | { kind: "task-notification" }1467 | { kind: "task-notification" }

1426 | { kind: "coordinator" }1468 | { kind: "coordinator" }

1427 | { kind: "auto-continuation" };1469 | { kind: "auto-continuation" };

1428```1470```

1429 1471 

1430| `kind` | 意味 |1472| `kind` | 意味 |

1431| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1473| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1432| `human` | エンドユーザーからの直接入力。ユーザーメッセージでは、`origin` が存在しないこともヒューマン入力を意味します。 |1474| `human` | エンドユーザーからの直接入力。ユーザーメッセージでは、`origin` が存在しないこともヒューマン入力を意味します。 |

1433| `channel` | [チャネル](/ja/channels)に到着するメッセージ。`server` はソース MCP サーバー名です。 |1475| `channel` | [チャネル](/ja/channels)に到着するメッセージ。`server` はソース MCP サーバー名です。 |

1434| `peer` | 別のエージェントからのメッセージ。プロセス内の [teammate](/ja/agent-teams) が `SendMessage` 経由で `main` に送信する場合、`from` は teammate の名前で、`senderTaskId` はそのタスク ID です。別のローカル Claude Code プロセスなどのクロスセッションピアの場合、`from` は送信者アドレスで、`senderTaskId` は存在しません。`name` フィールドは予約されています。 |1476| `peer` | 別のエージェントからのメッセージ。プロセス内の [teammate](/ja/agent-teams) が `SendMessage` 経由で `main` に送信する場合、`from` は teammate の名前で、`senderTaskId` はそのタスク ID です。別のローカル Claude Code プロセスなどのクロスセッションピアの場合、`from` は送信者アドレスで、`senderTaskId` は存在しません。{/* min-version: 2.1.205 */}`name` と `body` には Claude Code v2.1.205 以降が必要です`name` は送信者の表示名で、Claude Code によって正規化されます:Unicode 制御、形式、サロゲート、および行または段落区切り文字コードポイントを削除し、結果をトリミングして 64 コードポイントで上限に達し、省略記号を付けます。`body` はピアエンベロープを削除したデコードされたメッセージ本体で、モデルが見るものとバイト単位で正確です。teammate メッセージの場合、`body` は常に存在します。クロスセッションピアの場合、ターンが Claude Code によって形成された正確に 1 つのピアエンベロープである場合にのみ存在します。メッセージテキストを再解析する代わりに、`name` と `body` をレンダリングします。 |

1435| `task-notification` | バックグラウンドタスク完了後に注入される合成ターン。[`SDKTaskNotificationMessage`](#sdktasknotificationmessage) を参照してください。 |1477| `task-notification` | バックグラウンドタスク完了後に注入される合成ターン。[`SDKTaskNotificationMessage`](#sdktasknotificationmessage) を参照してください。 |

1436| `coordinator` | [エージェントチーム](/ja/agent-teams)のチームコーディネーターからのメッセージ。 |1478| `coordinator` | [エージェントチーム](/ja/agent-teams)のチームコーディネーターからのメッセージ。 |

1437| `auto-continuation` | セッションが新しいユーザー入力なしで続行するときに注入される合成ターン(コマンド結果がフォローアッププロンプトをトリガーするなど)。 |1479| `auto-continuation` | セッションが新しいユーザー入力なしで続行するときに注入される合成ターン(コマンド結果がフォローアッププロンプトをトリガーするなど)。 |


2185};2227};

2186```2228```

2187 2229 

2188ID でバックグラウンドタスクまたはシェルを停止します。{/* min-version: 2.1.198 */}v2.1.198 以降、`task_id` はエージェントチームのチームメイト、または エージェント ID または名前で名前付きバックグラウンドエージェントも受け入れます。2230ID でバックグラウンドタスクまたはシェルを停止します。{/* min-version: 2.1.198 */}v2.1.198 以降、`task_id` はエージェントチームのチームメイト、またはエージェント ID または名前で名前付きバックグラウンドエージェントも受け入れます。

2189 2231 

2190<h3 id="notebookedit">2232<h3 id="notebookedit">

2191 NotebookEdit2233 NotebookEdit


2357 2399 

2358```typescript theme={null}2400```typescript theme={null}

2359type ExitPlanModeInput = {2401type ExitPlanModeInput = {

2402 /** 非推奨:使用されなくなりました。 */

2360 allowedPrompts?: Array<{2403 allowedPrompts?: Array<{

2361 tool: "Bash";2404 tool: "Bash";

2362 prompt: string;2405 prompt: string;


2364};2407};

2365```2408```

2366 2409 

2367計画モードを終了します。オプションで計画を実装するために必要なプロンプトベースのパーミッションを指定します2410計画モードを終了します。`allowedPrompts` フィールドは非推奨で無視されます。Claude Code は既存の呼び出し元とトランスクリプトが検証されるようにそれでも受け入れます。v2.1.205 より前は計画を実装するためのプロンプトベースの Bash パーミッションをリクエストしていました

2368 2411 

2369<h3 id="listmcpresources">2412<h3 id="listmcpresources">

2370 ListMcpResources2413 ListMcpResources


2408};2451};

2409```2452```

2410 2453 

2411分離された作業用の一時的な git worktree を作成して入力します。新しい worktree を作成する代わりに、現在のリポジトリの既存の worktree に切り替えるには `path` を渡します。`name` と `path` は相互に排他的です。2454分離された作業用の一時的な git worktree を作成して入力します。新しい worktree を作成する代わりに、現在のリポジトリの既存の worktree に切り替えるには `path` を渡します。最初の入力時、ターゲットは現在のリポジトリの登録済み worktree、またはマルチリポジトリワークスペースの場合はその中にネストされたリポジトリの worktree である必要があります。worktree セッション内からは、セッションのリポジトリの `.claude/worktrees/` の下にある必要があります。`name` と `path` は相互に排他的です。

2412 2455 

2413<h2 id="tool-output-types">2456<h2 id="tool-output-types">

2414 ツール出力型2457 ツール出力型


3656};3699};

3657```3700```

3658 3701 

3702<h3 id="sdkbackgroundtaskschangedmessage">

3703 `SDKBackgroundTasksChangedMessage`

3704</h3>

3705 

3706ライブバックグラウンドタスクのセットが変更されるたびに発行されます。タスクが開始、完了、キル、またはフォアグラウンドエージェントがバックグラウンド化されるときです。`tasks` 配列はライブセット全体です。`task_started` および `task_notification` イベントをペアリングするのではなく、各ペイロードでキャッシュされたセットを置き換えてください。そのため、次のメンバーシップ変更は、逃したイベントを修正します。

3707 

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

3709 

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

3711 

3712{/* min-version: 2.1.203 */}Claude Code v2.1.203 以降が必要です。

3713 

3714```typescript theme={null}

3715type SDKBackgroundTasksChangedMessage = {

3716 type: "system";

3717 subtype: "background_tasks_changed";

3718 tasks: {

3719 task_id: string;

3720 task_type: string;

3721 description: string;

3722 }[];

3723 uuid: UUID;

3724 session_id: string;

3725};

3726```

3727 

3659<h3 id="sdkfilespersistedevent">3728<h3 id="sdkfilespersistedevent">

3660 `SDKFilesPersistedEvent`3729 `SDKFilesPersistedEvent`

3661</h3>3730</h3>


3745};3814};

3746```3815```

3747 3816 

3817<h3 id="sdkconversationresetmessage">

3818 `SDKConversationResetMessage`

3819</h3>

3820 

3821セッションの会話がセッションを終了せずに置き換えられたときに発行されます。例えば、`/clear` の後、プランモード終了時、または新しい会話が開始されるときなど。`new_conversation_id` の下に空のトランスクリプトをマウントし、キャッシュされたセッションタイトルを破棄してください。

3822 

3823```typescript theme={null}

3824type SDKConversationResetMessage = {

3825 type: "conversation_reset";

3826 new_conversation_id: UUID;

3827 uuid: UUID;

3828 session_id: string;

3829};

3830```

3831 

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

3833 

3748<h3 id="aborterror">3834<h3 id="aborterror">

3749 `AbortError`3835 `AbortError`

3750</h3>3836</h3>

Details

198</CodeGroup>198</CodeGroup>

199 199 

200<Note>200<Note>

201 Python では、`can_use_tool` は [ストリーミングモード](/ja/agent-sdk/streaming-vs-single-mode) `{"continue_": True}` を返す `PreToolUse` フックが必要で、ストリームを開いたままにしますこのフックがないと許可コールバックが呼び出される前にストリームが閉じます201 Python では、`can_use_tool` は [ストリーミングモード](/ja/agent-sdk/streaming-vs-single-mode)が必要です。有限のメッセージストリームを `query(prompt=generator)` または `ClaudeSDKClient.connect(prompt=async_iterable)` を通じて渡すと、登録されたフックまたはプロセス内 MCP サーバーがストリームを開いたままにしていない限り、SDK は最後のメッセージの後、許可コールバックが呼び出される前にストリームを閉じます。上記の例は、`{"continue_": True}` を返す `PreToolUse` フックでストリームを開いたままにしますプロンプトなしで接続し`ClaudeSDKClient.query()` を通じてメッセージを送信すると、ストリームは自動的に開いたままになり、フックは不要です

202</Note>202</Note>

203 203 

204この例では y/n フローを使用しており、`y` 以外の入力は拒否として扱われます。実際には、ユーザーがリクエストを変更したり、フィードバックを提供したり、Claude を完全にリダイレクトしたりできるより豊富な UI を構築する可能性があります。すべての応答方法については [ツールリクエストに応答する](#respond-to-tool-requests)を参照してください。204この例では y/n フローを使用しており、`y` 以外の入力は拒否として扱われます。実際には、ユーザーがリクエストを変更したり、フィードバックを提供したり、Claude を完全にリダイレクトしたりできるより豊富な UI を構築する可能性があります。すべての応答方法については [ツールリクエストに応答する](#respond-to-tool-requests)を参照してください。


6864. **回答をマップする**:コードは入力が数値(オプションのラベルを使用)か自由テキスト(テキストを直接使用)かをチェックします6864. **回答をマップする**:コードは入力が数値(オプションのラベルを使用)か自由テキスト(テキストを直接使用)かをチェックします

6875. **Claude に返す**:応答には元の `questions` 配列と `answers` マッピングの両方が含まれます6875. **Claude に返す**:応答には元の `questions` 配列と `answers` マッピングの両方が含まれます

688 688 

689TypeScript バージョンを `ask.ts` として保存して `npx tsx ask.ts` で実行するか、Python バージョンを `ask.py` として保存して `python ask.py` で実行してください。

690 

689<CodeGroup>691<CodeGroup>

690 ```python Python theme={null}692 ```python Python theme={null}

691 import asyncio693 import asyncio

agent-view.md +73 −29

Details

90 90 

91```text theme={null}91```text theme={null}

92Pinned92Pinned

93 ✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m93 ✽ clawd walk cycle Drawing the walk-cycle sprite frames 3m

94 94 

95Ready for review95Ready for review

96 ∙ jump physics Opened PR with collision fix #2048 2h96 ∙ jump physics Opened PR with collision fix #2048 2h

97 97 

98Needs input98Needs input

99 ✻ power-up design needs input: double jump or wall climb? 1m99 ✻ power-up design double jump or wall climb? 1m

100 100 

101Working101Working

102 ✽ collision detection Edit src/physics/CollisionSystem.ts 2m102 ✽ collision detection Adding swept-AABB checks to CollisionSystem 2m

103 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m103 ✢ playtest level 3 run 12 · all checkpoints cleared in 4m

104 104 

105Completed105Completed


141 141 

142セッション状態はディスク上に永続化され、自動更新とスーパーバイザー再起動を通じて保存されます。セッションはマシンがスリープするときも保存されます。プロセスはウェイク時に再開され、スーパーバイザーはアイドルとして時間ギャップを扱う代わりにそれらに再接続します。シャットダウンはまだ実行中のセッションを停止します。[シャットダウン後にセッションが失敗として表示される](#sessions-show-as-failed-after-shutdown) を参照して、それらを復旧する方法を確認してください。142セッション状態はディスク上に永続化され、自動更新とスーパーバイザー再起動を通じて保存されます。セッションはマシンがスリープするときも保存されます。プロセスはウェイク時に再開され、スーパーバイザーはアイドルとして時間ギャップを扱う代わりにそれらに再接続します。シャットダウンはまだ実行中のセッションを停止します。[シャットダウン後にセッションが失敗として表示される](#sessions-show-as-failed-after-shutdown) を参照して、それらを復旧する方法を確認してください。

143 143 

144応答しなくなったセッションを開くと、スーパーバイザーはそのプロセスを再起動し、セッションは中断した応答を中断したところから続行します。マシンがスリープしている間に応答の途中でセッションがその状態になる可能性があります。Claude Code v2.1.200 以降が必要です。

145 

144<h3 id="row-summaries">146<h3 id="row-summaries">

145 行の概要147 行の概要

146</h3>148</h3>

147 149 

148各行の 1 行の概要は [Haiku クラスモデル](/ja/model-config) によって生成されるため、行はトランスクリプトを開かずにセッションが何をしているか、何が必要か、または何を生成したかを伝えることができます。セッションがアクティブに作業している間、概要は最大 15 秒ごとに 1 および各ターンが終了したときに 1 回更新されます150各行の 1 行の概要は [Haiku クラスモデル](/ja/model-config) によって生成されるため、トランスクリプトを開かずにセッションが何をしているか、何が必要か、または何を生成したかを伝えることができます。セッションがアクティブに作業している間、行テキストはセッション自身の最近の出力から最大 15 秒ごとに 1 回更新されモデルリクエストを送信せず、各ターンが終了したときに新しい概要を書きます

151 

152作業中の行はセッションが何をしているかを示し、ブロックされた行は質問を示します。長いターンの間、モデルは約 1 分ごとに概要を書き直し、各書き直しの後に 2 倍待機して最大 4 分まで待機するため、ビジーな行は古い概要を表示し続けません。テキストは 64 列で切り詰められます。[ピークパネル](#peek-and-reply) を開いて文全体を読みます。v2.1.205 より前では、作業中の行は生のツール呼び出しの代わりにレポートを表示でき、並列作業項目を実行しているセッションはテキストの前に `2/5` などの `done/total` カウントを表示していました。

153 

154リストが [ディレクトリでグループ化](#organize-the-list) されている場合、概要はセッションの状態を色付きの単語で開きます。例えば `Needs input · double jump or wall climb?` のようになります。デフォルトの状態グループ化では、グループヘッダーはすでに状態を名前付けするため、行は概要のみを表示します。v2.1.205 より前では、ディレクトリでグループ化された行は状態の単語を持ちませんでした。

149 155 

150セッションが subagents、バックグラウンドシェルコマンド、またはモニターなど、2 つ以上の並列作業項目を実行している場合、`2/5` などの `done/total` カウントが概要テキストの前に表示されます156出力全体に文字または数字が含まれていないターン。例えば [`/loop`](/ja/scheduled-tasks) セッションが静かなイテレーションで単一の記号を出力する場合、行は前の概要と状態を保持します。v2.1.205 より前では、そのターンは再分類され、入力を待機していたセッションを `Working` に戻す可能性がありました

151 157 

152各更新は通常のプロバイダーを通じた 1 つの短い Haiku クラスリクエストであり、セッション自体と同じ [データ使用条件](/ja/data-usage) の下で請求および処理されます。Bedrock、Vertex AI、Microsoft Foundry、カスタムゲートウェイなどのサードパーティプロバイダーでは、Haiku モデルが設定されていない場合、リクエストはセッションのメインモデルにフォールバックします。これらのプロバイダーでこれらの概要のモデルを選択するには、[`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/ja/model-config#environment-variables) を設定します。158ターン終了時の概要と各ミッドターン書き直しは、通常のプロバイダーを通じた 1 つの短い Haiku クラスリクエストであり、セッション自体と同じ [データ使用条件](/ja/data-usage) の下で請求および処理されます。15 秒の更新はモデル書き直しの間にセッション自身の出力を再利用し、リクエストを送信しません。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、カスタムゲートウェイなどのサードパーティプロバイダーでは、Haiku モデルが設定されていない場合、リクエストはセッションのメインモデルにフォールバックします。これらのプロバイダーでこれらの概要のモデルを選択するには、[`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/ja/model-config#environment-variables) を設定します。

153 159 

154<h3 id="pull-request-status">160<h3 id="pull-request-status">

155 プルリクエストステータス161 プルリクエストステータス


157 163 

158セッションがプルリクエストを開くと、`#1234` ラベルが行の右端に表示され、ハイパーリンクをサポートするターミナルではプルリクエストにリンクされます。セッションにフォローアップを送信するときもラベルは保存されるため、行がライブプログレスに戻るときもプルリクエストは表示されたままです。ワークツリーで変更を分離したバックグラウンドセッションはこれらのプルリクエストを自分で開きます。[ファイル編集がどのように分離されるか](#how-file-edits-are-isolated) はそれが起こるときと、セッションが尋ねずに何をしないかをカバーしています。164セッションがプルリクエストを開くと、`#1234` ラベルが行の右端に表示され、ハイパーリンクをサポートするターミナルではプルリクエストにリンクされます。セッションにフォローアップを送信するときもラベルは保存されるため、行がライブプログレスに戻るときもプルリクエストは表示されたままです。ワークツリーで変更を分離したバックグラウンドセッションはこれらのプルリクエストを自分で開きます。[ファイル編集がどのように分離されるか](#how-file-edits-are-isolated) はそれが起こるときと、セッションが尋ねずに何をしないかをカバーしています。

159 165 

160セッションが複数のプルリクエストを開いた場合ラベルはカウントを表示します例えば `3 PRs` のようになり最も注意が必要なオープンプルリクエストで色付けされます[ピークパネル](#peek-and-reply) を開いてすべてを表示します166既存のプルリクエストで作業しているセッションは同じ方法でリンクされます。`gh` でプルリクエストを編集コメント、クローズ、またはマージ準備完了にマークすると、コマンド自身の出力が名前付けするプルリクエストがリンクされるため、キャプチャされた出力がプルリクエストを名前付けしない `gh` コマンドはリンクを作成しません`gh pr merge` は一般的なケースです。なぜなら、結果をインタラクティブターミナルにのみ出力するためです。`gh pr checkout` でプルリクエストをチェックアウトするかオープンなプルリクエストを持つブランチにプッシュすると、代わりに `gh pr view` でそのブランチを検索してリンクしますv2.1.205 より前では、セッションが作成またはチェックアウトしたプルリクエストのみがリンクされ、プッシュはローカルブランチ名が一致した場合にのみリンクされました

167 

168Claude Code はコマンド出力全体からプルリクエストを読み取ります。コマンドの出力がインライン制限を超えた場合、ファイルに保存された部分を含みます。v2.1.205 より前では、出力が約 30,000 文字を超えた Bash 呼び出しで作成されたプルリクエストはリンクされませんでした。

169 

170セッションが複数のプルリクエストにリンクされている場合、ラベルはカウントを表示します。例えば `3 PRs` のようになり、最も注意が必要なオープンプルリクエストで色付けされます。[ピークパネル](#peek-and-reply) を開いてすべてを表示します。

161 171 

162プルリクエスト番号はそのステータスで色付けされます:172プルリクエスト番号はそのステータスで色付けされます:

163 173 


174 ピーク表示と返信184 ピーク表示と返信

175</h3>185</h3>

176 186 

177選択した行で `Space` を押してピークパネルを開きます。セッションが何を必要としているか最新の出力および開いたプルリクエストが表示されます。ほとんどの場合、これで十分であり、フルトランスクリプトを開く必要はありません。187選択した行で `Space` を押してピークパネルを開きます。セッションの完全なステータス文で開き行が切り詰める部分と変更されてからの経過時間、その後にセッションにリンクされたプルリクエストが続きます入力を待機しているセッションの場合、尋ねている正確な質問も返信入力の上に表示されます。ほとんどの場合、ピークパネルで十分であり、フルトランスクリプトを開く必要はありません。

178 188 

179セッションが並列作業項目を実行している場合パネルは最も長く実行されているものとその実行時間を名前で表示するためアタッチせずにセッションが何を待機しているかを確認できます189v2.1.205 より前ではパネルはステータス文を繰り返すのは他に表示するものがない場合のみであり最も長く実行されている並列作業項目を名前付けしていました

180 190 

181ピークパネルに返信を入力して `Enter` を押すと、そのセッションに送信されます。セッションが複数選択肢の質問をしている場合、ピークパネルはオプションを表示し、数字キーを押して 1 つを選択できます。他のブロックされたセッションの場合は、`Tab` を押して入力に提案された返信を入力し、送信前に編集できます。返信の前に `!` を付けて Bash コマンドを代わりに送信します。191ピークパネルに返信を入力して `Enter` を押すと、そのセッションに送信されます。セッションが複数選択肢の質問をしている場合、ピークパネルはオプションを表示し、数字キーを押して 1 つを選択できます。他のブロックされたセッションの場合は、`Tab` を押して入力に提案された返信を入力し、送信前に編集できます。返信の前に `!` を付けて Bash コマンドを代わりに送信します。

182 192 


206 216 

207`←` を押すときにツールが実行されている場合、Claude Code はそれが完了するまで約 10 秒待機してからバックグラウンドにし、応答はバックグラウンドセッションで続きます。代わりに待機せずにすぐにバックグラウンドにするには、`←` を再度押します。進行中の作業がバックグラウンドセッションに引き継ぐことができない場合、`Background this session?` ダイアログが最初に表示されます。これは [`/background`](#from-inside-a-session) と同じです。217`←` を押すときにツールが実行されている場合、Claude Code はそれが完了するまで約 10 秒待機してからバックグラウンドにし、応答はバックグラウンドセッションで続きます。代わりに待機せずにすぐにバックグラウンドにするには、`←` を再度押します。進行中の作業がバックグラウンドセッションに引き継ぐことができない場合、`Background this session?` ダイアログが最初に表示されます。これは [`/background`](#from-inside-a-session) と同じです。

208 218 

209行は会話履歴がない新しいセッションからでも作成されるため、`` はそれに戻りますその行が唯一の行である場合エージェントビューはその下にオンボーディングヒントを表示します21910 秒の制限は [subagents](/ja/sub-agents) が実行されている間は適用されません。Claude Code は待機を続けるためそれらの作業が引き継がれ、待機中に `Still backgrounding after the current tool` 通知が表示されます代わりに待機せずにすぐにバックグラウンドにするには`←` を再度押しますこれにより subagents が最初から再開されます。v2.1.203 より前では、待機は 10 秒後に終了し、実行中の subagents は警告なしに最初から再開されました。

220 

221行は会話履歴がない新しいセッションからでも作成されるため、`→` はそれに戻ります。{/* max-version: 2.1.202 */}v2.1.203 より前では、エージェントビューはその行が唯一の行である場合、その下にオンボーディングヒントを表示していました。

210 222 

211このショートカットは `/config` の `leftArrowOpensAgents` 設定でオフにできます。223このショートカットは `/config` の `leftArrowOpensAgents` 設定でオフにできます。

212 224 


302* `/model` は [ディスパッチモデル](#set-the-model) を設定します314* `/model` は [ディスパッチモデル](#set-the-model) を設定します

303* {/* min-version: 2.1.198 */}v2.1.198 以降、`/login` はサインインダイアログを開き、セッションにアタッチせずに再度サインインできます315* {/* min-version: 2.1.198 */}v2.1.198 以降、`/login` はサインインダイアログを開き、セッションにアタッチせずに再度サインインできます

304 316 

305skills、独自のコマンド、および `/init` などのプロンプト展開組み込みは、新しいバックグラウンドセッションにその最初のプロンプトとして送信されます。その他の組み込みコマンドは、代わりに `attach to a session to run it` ヒントを表示します。317skills、独自のコマンド、および `/init` などのプロンプト展開組み込みは、新しいバックグラウンドセッションにその最初のプロンプトとして送信されます。その他の組み込みコマンドは、代わりに `attach to a session to run it` ヒントを表示します。{/* min-version: 2.1.203 */}入力したテキストはヒントの横に入力に残るため、編集できます。v2.1.203 より前は、ヒントが入力をクリアし、入力したテキストが失われました。

306 318 

307繰り返しタスクを [skill](/ja/skills) としてパッケージ化すると、プロンプトを再入力せずにエージェントビューから同じワークフローを何度も開始できます。319繰り返しタスクを [skill](/ja/skills) としてパッケージ化すると、プロンプトを再入力せずにエージェントビューから同じワークフローを何度も開始できます。

308 320 


315新しいセッションはエージェントビューを開いたディレクトリで実行されます。別のディレクトリをターゲットにするには、以下のいずれかを実行します:327新しいセッションはエージェントビューを開いたディレクトリで実行されます。別のディレクトリをターゲットにするには、以下のいずれかを実行します:

316 328 

317* そのディレクトリで `claude agents` を開きます。329* そのディレクトリで `claude agents` を開きます。

318* 親ディレクトリで `claude agents` を開き、プロンプトで `@<repo>` を使用して子リポジトリを言及します。`@` を入力すると、起動ディレクトリの 1 レベル下の git リポジトリ、およびリスト内に既にセッションがあるディレクトリがリストされます。名前にスペースが含まれるディレクトリはリストされません。330* 親ディレクトリで `claude agents` を開き、プロンプトで `@<repo>` を使用して子リポジトリを言及します。`@` を入力すると、これらのターゲットがリストされます:

331 

332 * 起動ディレクトリの 1 レベル下の Git リポジトリ

333 * 起動元のリポジトリの登録済み [git worktrees](/ja/worktrees)。`.claude/worktrees/` の下に Claude が作成したものなど、そのディレクトリツリー内に存在し、チェックアウトされたブランチでラベル付けされたもの。`git worktree add ../feature` などのリポジトリの外に追加された worktree はリストされません

334 * リスト内に既にセッションがあるディレクトリ

335 

336 名前にスペースが含まれるディレクトリはリストされません。{/* min-version: 2.1.203 */}v2.1.203 より前は、登録済み worktree がリストされていなかったため、worktree にディスパッチするには、その worktree のディレクトリから `claude --bg` を実行する必要がありました。

319* シェルから、ディレクトリに `cd` して `claude --bg "<prompt>"` を実行します。337* シェルから、ディレクトリに `cd` して `claude --bg "<prompt>"` を実行します。

320 338 

321エージェントビューがディレクトリでグループ化されている場合、ハイライトされた行のディレクトリがディスパッチターゲットになるため、グループにスクロールしてパスを再入力せずにそこにディスパッチできます。339エージェントビューがディレクトリでグループ化されている場合、ハイライトされた行のディレクトリがディスパッチターゲットになるため、グループにスクロールしてパスを再入力せずにそこにディスパッチできます。


425 443 

426git リポジトリの外では、セッションは作業ディレクトリに直接書き込み、互いに分離されていないため、同じファイルを編集する並列セッションのディスパッチを避けます。別のバージョン管理システムを使用する場合は、[`WorktreeCreate` hook](/ja/worktrees#non-git-version-control) を設定して、Claude は git の場合と同じ方法で編集を分離します。444git リポジトリの外では、セッションは作業ディレクトリに直接書き込み、互いに分離されていないため、同じファイルを編集する並列セッションのディスパッチを避けます。別のバージョン管理システムを使用する場合は、[`WorktreeCreate` hook](/ja/worktrees#non-git-version-control) を設定して、Claude は git の場合と同じ方法で編集を分離します。

427 445 

446フックが git リポジトリではないディレクトリで失敗した場合、セッションはそのディレクトリの分離をスキップし、作業ディレクトリを所定の位置で編集します。git リポジトリ内では、セッションが分離されるまで書き込みはブロックされたままです。v2.1.203 より前は、その状態のバックグラウンドセッションはファイルを編集できませんでした。すべての書き込みは分離されるまで拒否され、フックはそのディレクトリを分離できませんでした。

447 

428エージェントビューでセッションを削除する(`Ctrl+X` を 2 回)と、Claude が作成したワークツリーが削除されます。コミットされていない変更を含めて削除されるため、保持したい変更をマージまたはプッシュしてから削除します。シェルから [`claude rm`](#manage-sessions-from-the-shell) で削除すると、コミットされていない変更があるワークツリーが保持され、そのパスが出力されるため、自分でクリーンアップできます。自分で作成したワークツリーとセッションを開始した場合は、どちらの方法でも所定の位置に残されます。448エージェントビューでセッションを削除する(`Ctrl+X` を 2 回)と、Claude が作成したワークツリーが削除されます。コミットされていない変更を含めて削除されるため、保持したい変更をマージまたはプッシュしてから削除します。シェルから [`claude rm`](#manage-sessions-from-the-shell) で削除すると、コミットされていない変更があるワークツリーが保持され、そのパスが出力されるため、自分でクリーンアップできます。自分で作成したワークツリーとセッションを開始した場合は、どちらの方法でも所定の位置に残されます。

429 449 

430セッションのワークツリーパスを見つけるには、セッションをピークするか、アタッチして作業ディレクトリを確認します。450セッションのワークツリーパスを見つけるには、セッションをピークするか、アタッチして作業ディレクトリを確認します。


464 484 

465バックグラウンドセッションは、そこで `claude` を開始した場合と同じように、実行されるディレクトリから [settings](/ja/settings) を読み取ります。これには、プロジェクト設定の [`env` values](/ja/settings#available-settings) が含まれるため、そこで設定された `ANTHROPIC_MODEL` またはプロバイダー変数がそのディレクトリのバックグラウンドセッションに適用されます。485バックグラウンドセッションは、そこで `claude` を開始した場合と同じように、実行されるディレクトリから [settings](/ja/settings) を読み取ります。これには、プロジェクト設定の [`env` values](/ja/settings#available-settings) が含まれるため、そこで設定された `ANTHROPIC_MODEL` またはプロバイダー変数がそのディレクトリのバックグラウンドセッションに適用されます。

466 486 

467`CLAUDE_CODE_USE_BEDROCK` または `CLAUDE_CODE_USE_VERTEX` などのクラウドプロバイダー選択、および `ANTHROPIC_DEFAULT_*_MODEL` エイリアスは、セッションをディスパッチしたシェルに従います。`ANTHROPIC_BASE_URL` およびそのペアの `ANTHROPIC_AUTH_TOKEN` などのゲートウェイエンドポイント変数は従いません。バックグラウンドセッションがプロバイダー設定と認証情報をどのようにソースするかについては、[スーパーバイザープロセス](#the-supervisor-process) を参照してください。487`CLAUDE_CODE_USE_BEDROCK` または `CLAUDE_CODE_USE_VERTEX` などのクラウドプロバイダー選択、および `ANTHROPIC_DEFAULT_*_MODEL` エイリアスは、セッションをディスパッチしたシェルに従います。ゲートウェイ `ANTHROPIC_BASE_URL` はそのシェルで エクスポートされ、スーパーバイザーが同じゲートウェイ環境で実行され、セッションがディスパッチ元のディレクトリで実行されるか、`` または `/background` でバックグラウンド化された独自のセッションである場合、`ANTHROPIC_CUSTOM_HEADERS` と一緒に従いますこれは、エージェントビューを開くか、バックグラウンドセッションをディスパッチする最初のシェルがゲートウェイシェルである場合の通常のケースです。`@repo` または `--cwd` で別のディレクトリにディスパッチすると、シェルのゲートウェイは実行されません。そのプロジェクトの [settings](/ja/settings) がエンドポイントを提供します。バックグラウンドセッションがプロバイダー設定と認証情報をどのようにソースするかについては、[スーパーバイザープロセス](#the-supervisor-process) を参照してください。

468 488 

469[permission mode](/ja/permissions) は、セッションをどのように開始したかによって異なります。`/bg` または `←` でインタラクティブセッションをバックグラウンド化すると、現在の権限モードが保持されるため、`acceptEdits` または `auto` に切り替えたセッションはデタッチ後もそのモードのままです。エージェントビュー入力からディスパッチするか、シェルから `claude --bg` を実行すると、そのディレクトリの設定から `defaultMode` を使用するか、ディスパッチされた [subagent の frontmatter](/ja/sub-agents#supported-frontmatter-fields) から `permissionMode` を使用します。489[permission mode](/ja/permissions) は、セッションをどのように開始したかによって異なります。`/bg` または `←` でインタラクティブセッションをバックグラウンド化すると、現在の権限モードが保持されるため、`acceptEdits` または `auto` に切り替えたセッションはデタッチ後もそのモードのままです。エージェントビュー入力からディスパッチするか、シェルから `claude --bg` を実行すると、そのディレクトリの設定から `defaultMode` を使用するか、ディスパッチされた [subagent の frontmatter](/ja/sub-agents#supported-frontmatter-fields) から `permissionMode` を使用します。

470 490 

471バックグラウンドセッションを開始するときの権限モード、モデル、および努力は、スーパーバイザーが後で [セッションのプロセスを停止して再開](#the-supervisor-process) するときに、[設定フラグ](#from-inside-a-session) とともに保持されます。`claude --bg --dangerously-skip-permissions` または `claude --bg --permission-mode bypassPermissions` で起動したセッションは、ディレクトリの `defaultMode` にフォールバックする代わりに、その再開後も `bypassPermissions` のままです。また、セッション中に `/model` または `/effort` で変更したモデルまたは努力は保持されます。491バックグラウンドセッションを開始するときの権限モード、モデル、および努力は、スーパーバイザーが後で [セッションのプロセスを停止して再開](#the-supervisor-process) するときに、[設定フラグ](#from-inside-a-session) とともに保持されます。`claude --bg --dangerously-skip-permissions` または `claude --bg --permission-mode bypassPermissions` で起動したセッションは、ディレクトリの `defaultMode` にフォールバックする代わりに、その再開後も `bypassPermissions` のままです。また、セッション中に `/model` または `/effort` で変更したモデルまたは努力は保持されます。

472 492 

493セッションが [`effortLevel` setting](/ja/settings#available-settings) から取得した努力は、`--effort` または `/effort` からではなく、ディスパッチで固定されません。セッションのために開始された各プロセスは設定を再度読み取るため、`settings.json` で `effortLevel` を編集すると、`←` または `/bg` でバックグラウンド化したセッションとそれらの後の再開に到達します。v2.1.203 より前は、セッションをバックグラウンド化すると、`--effort` を渡したかのように、その設定から派生した努力が記録されたため、後の `effortLevel` 編集は到達しませんでした。

494 

495[`/rename`](/ja/commands) または `Ctrl+R` で設定した名前も、その再開全体で保持されるため、[`claude --resume <name>`](/ja/sessions#name-your-sessions) はセッションを解決します。v2.1.202 より前は、再開はセッションをディスパッチされた名前に戻し、新しい名前は解決を停止しました。

496 

473エージェントビューを開く際に `--permission-mode`、`--model`、`--effort`、または `--agent` のいずれかを渡して、エージェントビューからディスパッチするすべてのセッションのデフォルトを設定します:497エージェントビューを開く際に `--permission-mode`、`--model`、`--effort`、または `--agent` のいずれかを渡して、エージェントビューからディスパッチするすべてのセッションのデフォルトを設定します:

474 498 

475```bash theme={null}499```bash theme={null}


544 568 

545スーパーバイザーとそのセッションはインタラクティブセッションと同じ認証情報で認証され、モデル API を超えて追加のネットワーク接続を行いません。`CLAUDE_CODE_USE_BEDROCK` や `ANTHROPIC_DEFAULT_*_MODEL` エイリアスなどのプロバイダー選択変数は、各セッションをディスパッチしたシェルから読み取られ、そのワーカーに適用されます。569スーパーバイザーとそのセッションはインタラクティブセッションと同じ認証情報で認証され、モデル API を超えて追加のネットワーク接続を行いません。`CLAUDE_CODE_USE_BEDROCK` や `ANTHROPIC_DEFAULT_*_MODEL` エイリアスなどのプロバイダー選択変数は、各セッションをディスパッチしたシェルから読み取られ、そのワーカーに適用されます。

546 570 

547バックグラウンドセッションは、スーパーバイザーを開始したシェルまたはディスパッチシェルから `ANTHROPIC_BASE_URL`、同等の Bedrock、VertexFoundry ベース URL 変数またはペアの `ANTHROPIC_AUTH_TOKEN` などのゲートウェイエンドポイント変数を継承しません。セッションは保存された認証情報とプロジェクトディレクトリの[設定](/ja/settings)内の `env` 値を使用します。プロジェクト内のバックグラウンドセッションを[LLM ゲートウェイ](/ja/llm-gateway)に指定するには、シェルでエクスポートするのではなくそのプロジェクトの `.claude/settings.json` `env` ブロックに `ANTHROPIC_BASE_URL` を設定します571ディスパッチシェルの `PATH` はワーカーに同じ方法で適用されるためセッションが実行するシェルコマンドはターミナルと同じツールを見つけます。v2.1.203 より前はバックグラウンドセッションはスーパーバイザーを最初に開始したシェルの `PATH` を保持していたためその後 `PATH` に追加されたツールが見つからない可能性があり特に Windows では見つかりません

572 

573バックグラウンドセッションは、スーパーバイザーを開始したシェルから `ANTHROPIC_BASE_URL` またはそれに相当する Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry ベース URL 変数などのゲートウェイエンドポイント変数を継承しません。ディスパッチするシェルでゲートウェイがエクスポートされていない場合、セッションは保存された認証情報とプロジェクトディレクトリの[設定](/ja/settings)内の `env` 値を使用します。プロジェクト内のすべてのセッションを[LLM ゲートウェイ](/ja/llm-gateway)に指定するには、そのプロジェクトの `.claude/settings.json` `env` ブロックに `ANTHROPIC_BASE_URL` を設定します。

574 

575{/* min-version: 2.1.203 */}ディスパッチするシェルでエクスポートされたゲートウェイ `ANTHROPIC_BASE_URL` はそのセッションのワーカーに到達し、`ANTHROPIC_CUSTOM_HEADERS` とそれらと一緒にエクスポートされた認証情報も到達します。スーパーバイザーが同じゲートウェイを持つ環境から開始された場合です。スーパーバイザーはエージェントビューを開くか、バックグラウンドセッションをディスパッチする最初のシェルからその環境をキャプチャするため、ゲートウェイシェルから開始するとそれにその環境を与えます。転送はまた、ディスパッチするディレクトリまたは `←` または `/background` でセッションからバックグラウンド化されたディレクトリにディスパッチされたセッションにのみ適用されます。`@repo` または `--cwd` で別のディレクトリにディスパッチすると、シェルのゲートウェイは実行されず、そのプロジェクトの `settings.json` `env` ブロックがエンドポイントを提供します。スーパーバイザーの環境が異なるゲートウェイまたはゲートウェイなしを実行する場合、ワーカーは 1 つの環境の認証情報を別の環境のエンドポイントと混ぜるのではなく、デフォルトエンドポイントに対して保存された認証情報を保持します。v2.1.203 より前は、ディスパッチシェルの `ANTHROPIC_BASE_URL` は削除されましたが、それと一緒にエクスポートされた `ANTHROPIC_API_KEY` は保持されたため、ゲートウェイのキーはデフォルトエンドポイントに送信され、すべてのリクエストは 401 で失敗しました。

576 

577転送されたエンドポイントはそのライブプロセスにのみ適用され、ディスクに書き込まれることはありません。スーパーバイザーがアイドルセッションを停止し、後で再開すると、再開されたプロセスは設定から再度エンドポイントを読み取ります。ゲートウェイ `ANTHROPIC_AUTH_TOKEN` を使用すると、保存された認証情報にフォールバックし、ゲートウェイが発行した `ANTHROPIC_API_KEY` を使用すると、ゲートウェイが設定で設定されるまで認証に失敗する可能性があります。

548 578 

549各バックグラウンドセッションは独自の Claude Code プロセスであり、ターミナルではなくスーパーバイザーによって管理されます。アクティブに作業しているセッション、入力を待機しているセッション、またはターミナルが接続されているセッションはプロセスを実行し続けます。実行中のバックグラウンドシェルコマンド、subagent、動的ワークフロー、またはモニターはアクティブな作業としてカウントされるため、開発サーバーなどの長時間実行プロセスはセッションを生かし続けます。579各バックグラウンドセッションは独自の Claude Code プロセスであり、ターミナルではなくスーパーバイザーによって管理されます。アクティブに作業しているセッション、入力を待機しているセッション、またはターミナルが接続されているセッションはプロセスを実行し続けます。実行中のバックグラウンドシェルコマンド、subagent、動的ワークフロー、またはモニターはアクティブな作業としてカウントされるため、開発サーバーなどの長時間実行プロセスはセッションを生かし続けます。

550 580 


570 600 

571スーパーバイザーはディスク上にインストールされた Claude Code バイナリを監視し、通常の[自動更新プログラム](/ja/setup#auto-updates)がそれを置き換えた後、新しいバージョンに再開します。これはネットワークチェックではなく、ローカルファイルウォッチです。バックグラウンドセッションはデタッチされたプロセスであるため、再開を通じて実行し続け、新しいスーパーバイザーはそれらに再接続します。アイドル状態のピン留めセッションも新しいバージョンに再開されるため、再度アタッチすることなく更新を取得します。601スーパーバイザーはディスク上にインストールされた Claude Code バイナリを監視し、通常の[自動更新プログラム](/ja/setup#auto-updates)がそれを置き換えた後、新しいバージョンに再開します。これはネットワークチェックではなく、ローカルファイルウォッチです。バックグラウンドセッションはデタッチされたプロセスであるため、再開を通じて実行し続け、新しいスーパーバイザーはそれらに再接続します。アイドル状態のピン留めセッションも新しいバージョンに再開されるため、再度アタッチすることなく更新を取得します。

572 602 

603スーパーバイザーがセッションを再開している間に `claude attach` を実行すると、更新、スタール、またはマイグレーションのいずれであっても、失敗するのではなく置き換えプロセスを待機します。`Agent is updating to the new Claude Code…` などのステータス行は、待機している内容を名前付けし、経過秒数をカウントし、セッションの準備ができるとすぐにコマンドが接続されます。約 60 秒後、待機を停止してエラーを報告します。v2.1.205 より前は、`claude attach` は数秒後に再試行を停止し、セッションがまだ再開している間にエラーを出力しました。

604 

573<h3 id="where-state-is-stored">605<h3 id="where-state-is-stored">

574 状態が保存される場所606 状態が保存される場所

575</h3>607</h3>


585 617 

586各バックグラウンドセッションには `CLAUDE_JOB_DIR` 環境変数が `~/.claude/jobs/<id>` ディレクトリに設定されているため、セッションが実行するシェルコマンドは並列セッションと衝突することなく `$CLAUDE_JOB_DIR/tmp` に一時ファイルを書き込むことができます。618各バックグラウンドセッションには `CLAUDE_JOB_DIR` 環境変数が `~/.claude/jobs/<id>` ディレクトリに設定されているため、セッションが実行するシェルコマンドは並列セッションと衝突することなく `$CLAUDE_JOB_DIR/tmp` に一時ファイルを書き込むことができます。

587 619 

588この状態を直接ファイルを読むことなく検査するには、`claude daemon status` を実行します。スーパーバイザーに到達可能かどうか、そのプロセス ID とバージョン、ソケットディレクトリ、およびライブのバックグラウンドセッション数を報告します。`/doctor` には同じチェックの概要が含まれます。620この状態を直接ファイルを読むことなく検査するには、`claude daemon status` を実行します。スーパーバイザーに到達可能かどうか、そのプロセス ID とバージョン、ソケットディレクトリ、およびライブのバックグラウンドセッション数を報告します。

589 621 

590このコマンドは、実行中のスーパーバイザーが呼び出した `claude` とは異なるバージョンにある場合に警告を表示します。これはスーパーバイザーがまだ再開していない更新後に発生します。警告は両方のバージョンを表示し、`claude daemon stop --any` を実行して新しいバージョンを取得するよう指示します。Claude Code が OS サービスとしてインストールされている場合、推奨されるコマンドはフラグなしの `claude daemon stop` です。622このコマンドは、実行中のスーパーバイザーが呼び出した `claude` とは異なるバージョンにある場合に警告を表示します。これはスーパーバイザーがまだ再開していない更新後に発生します。警告は両方のバージョンを表示し、`claude daemon stop --any` を実行して新しいバージョンを取得するよう指示します。Claude Code が OS サービスとしてインストールされている場合、推奨されるコマンドはフラグなしの `claude daemon stop` です。

591 623 

592セッションはそのバージョンの不一致を無傷で生き残ります。セッションの `state.json` を更新する古い Claude Code バージョンは、認識しないフィールドを保持し、セッションをリストに保持します。624セッションはそのバージョンの不一致を無傷で生き残ります。セッションの `state.json` を更新する古い Claude Code バージョンは、認識しないフィールドを保持し、セッションをリストに保持します。{/* min-version: 2.1.200 */}`roster.json` のセッションリストは同じルールに従います。それを書き直す古いバージョンは、新しいバージョンが書き込んだフィールドを保持するため、新しいバージョンで開始されたセッションは到達可能なままで、スーパーバイザーが再開した後も入力を受け付け続けます。v2.1.200 より前は、古いバージョンは書き直し時にそれらのフィールドをドロップできました。

593 625 

594Windows では、`claude daemon status` はデーモンのパイプキーファイルがロックされているか読み取り不可の場合、一般的な接続失敗を報告する代わりに、基になるファイルエラーを表示します。626Windows では、`claude daemon status` はデーモンのパイプキーファイルがロックされているか読み取り不可の場合、一般的な接続失敗を報告する代わりに、基になるファイルエラーを表示します。

595 627 


615 エージェントビューがセッションなしで開く647 エージェントビューがセッションなしで開く

616</h3>648</h3>

617 649 

618最初のセッションをディスパッチする前に、エージェントビューはセッションリストの代わりに例のプロンプトを含む短いオンボーディングヒントを表示します。下部の入力にプロンプトを入力して `Enter` を押して、最初のセッションをディスパッチします。650最初のセッションをディスパッチする前に、エージェントビューは空のセクションヘッダーを表示し各セクションの下に説明があり、セッションリストの代わりに入力の上に 1 行の説明があります。下部の入力にプロンプトを入力して `Enter` を押して、最初のセッションをディスパッチします。

619 651 

620<h3 id="backgrounding-shows-a-background-this-session-dialog">652<h3 id="backgrounding-shows-a-background-this-session-dialog">

621 バックグラウンド化がダイアログを表示する653 バックグラウンド化が `Background this session?` ダイアログを表示する

622</h3>654</h3>

623 655 

624`←` を押して現在のセッションをバックグラウンドに移すと `Background this session?` ダイアログが表示される場合、セッションには実行中の [monitor](/ja/tools-reference#monitor-tool) などの転送できない実行中の作業があり、Claude Code はそれを静かに停止しません。ダイアログは停止される作業を名前で表示し、別に転送されるタスクをカウントします。`/tasks` を実行してすべての実行中のものを確認し、確認してバックグラウンド化するか、`Stay` を選択して作業が完了するまで待機します。[セッション内から](#from-inside-a-session) を参照して、どのタスク種が転送され、どのタスク種が停止されるかを確認してください。656`←` を押して現在のセッションをバックグラウンドに移すと `Background this session?` ダイアログが表示される場合、セッションには実行中の [monitor](/ja/tools-reference#monitor-tool) などのバックグラウンドセッションに移動できない実行中の作業があり、Claude Code はそれを静かに停止しません。ダイアログは停止される作業を名前で表示し、別に転送されるタスクをカウントします。`/tasks` を実行してすべての実行中のものを確認し、確認してバックグラウンド化するか、`Stay` を選択して作業が完了するまで待機します。[セッション内から](#from-inside-a-session)を参照して、どのタスク種が転送され、どのタスク種が停止されるかを確認してください。

625 657 

626<h3 id="prompt-rejected-as-too-short">658<h3 id="prompt-rejected-as-too-short">

627 プロンプトが短すぎるとして拒否される659 プロンプトが短すぎるとして拒否される


637 669 

638スリープだけではこれは発生しません。セッションはスリープ全体で保持され、スーパーバイザーはウェイク時にそれらに再接続します。670スリープだけではこれは発生しません。セッションはスリープ全体で保持され、スーパーバイザーはウェイク時にそれらに再接続します。

639 671 

672<h3 id="opening-a-session-says-the-conversation-is-already-open">

673 セッションを開くと、会話が既に開いていると表示される

674</h3>

675 

676停止した行を開く場合、その会話が別の実行中の非インタラクティブ Claude Code プロセス(例えば、同じ会話のバックグラウンドワーカーがまだシャットダウン中)によっても開かれている場合、2 つのプロセスが同じトランスクリプトに書き込むことができないため、行のプロセスを開始する代わりに `This conversation is already open in another running Claude session` が表示されます。既に会話を開いているセッションで返信するか、それを終了して行を再度開きます。拒否された試みで入力した返信は失われません。セッションが次に開始するときに送信されます。

677 

678v2.1.203 より前は、この状態は 2 番目のプロセスを開始していました。そのプロセスは `currently running as a background agent` エラーで終了し、行は失敗として表示されました。

679 

640<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">680<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

641 セッションが開始前に `possibly low memory` ノートで失敗する681 セッションが `possibly low memory` ノートで開始前に失敗する

642</h3>682</h3>

643 683 

644v2.1.199 以降、バックグラウンドセッションのプロセスが開始を完了する前に終了し、ホストのメモリが不足している場合、行のステータスは終了を名前で表示し、`possibly low memory — free some up and retry` を追加します。以前のバージョンでは、この失敗に対して終了理由のみを表示していました。684v2.1.199 以降、バックグラウンドセッションのプロセスが開始を完了する前に終了し、ホストのメモリが不足している場合、行のステータスは終了を名前で表示し、`possibly low memory — free some up and retry` を追加します。以前のバージョンでは、この失敗に対して終了理由のみを表示していました。


659 699 

660新しいスーパーバイザーは実行中のセッションに再接続します。`--keep-workers` がない場合、コマンドはバックグラウンドセッションも終了します。`--any` フラグは、デフォルトであるインストール済みサービスではなく、オンデマンドで開始されたスーパーバイザーを停止したいことを確認します。700新しいスーパーバイザーは実行中のセッションに再接続します。`--keep-workers` がない場合、コマンドはバックグラウンドセッションも終了します。`--any` フラグは、デフォルトであるインストール済みサービスではなく、オンデマンドで開始されたスーパーバイザーを停止したいことを確認します。

661 701 

662Windows では、スーパーバイザーが停止要求に応答しない場合、コマンドはそのプロセス ID を出力します。`taskkill /PID <pid>` でそのプロセスを終了して復旧を完了します。`--keep-workers` を渡した場合、バックグラウンドセッションは引き続き保持されます。

663 

664スーパーバイザーが起動しても接続を受け入れることができない場合は、独自に終了してロックを解放するため、次の `claude agents` は手動停止なしで新しいものを開始します。上記の手順は、実行中のスーパーバイザーがスタールしている場合に適用されます。702スーパーバイザーが起動しても接続を受け入れることができない場合は、独自に終了してロックを解放するため、次の `claude agents` は手動停止なしで新しいものを開始します。上記の手順は、実行中のスーパーバイザーがスタールしている場合に適用されます。

665 703 

704Windows では、スーパーバイザーが停止要求に応答しない場合、コマンドはそのプロセス ID を出力します。`taskkill /PID <pid>` でそのプロセスを終了して復旧を完了します。`--keep-workers` を渡した場合、バックグラウンドセッションは引き続き保持されます。

705 

666<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">706<h3 id="dispatch-fails-with-could-not-resolve-authentication-method">

667 ディスパッチが `Could not resolve authentication method` で失敗する707 ディスパッチが `Could not resolve authentication method` で失敗する

668</h3>708</h3>


689 macOS でバックグラウンドセッションがローカルネットワークホストに到達できない729 macOS でバックグラウンドセッションがローカルネットワークホストに到達できない

690</h3>730</h3>

691 731 

692macOS 15 以降では、ローカルネットワークアクセス権限を付与するまで、システムはプロセスがローカルネットワーク上のデバイスに到達することをブロックします。v2.1.198 より前は、バックグラウンドセッションホストはその権限をリクエストしなかったため、LAN アドレスをターゲットとするコマンドは、同じコマンドがフォアグラウンドターミナルで機能していても `connect: no route to host` で失敗しました。v2.1.198 以降、バックグラウンドセッションでローカルネットワークアドレスに接続する最初のコマンドは、Claude Code の macOS ローカルネットワークアクセス権限プロンプトをトリガーします。一度許可すると、これらのコマンドはフォアグラウンドターミナルと同じ方法で LAN ホストに到達します。732macOS 15 以降では、ローカルネットワークアクセス権限を付与するまで、システムはプロセスがローカルネットワーク上のデバイスに到達することをブロックします。v2.1.198 より前は、バックグラウンドセッションホストはその権限をリクエストしなかったため、LAN アドレスをターゲットとするコマンドは、同じコマンドがフォアグラウンドターミナルで機能していても `connect: no route to host` で失敗しました。{/* min-version: 2.1.198 */}v2.1.198 以降、バックグラウンドセッションでローカルネットワークアドレスに接続する最初のコマンドは、Claude Code の macOS ローカルネットワークアクセス権限プロンプトをトリガーします。一度許可すると、これらのコマンドはフォアグラウンドターミナルと同じ方法で LAN ホストに到達します。

693 733 

694<h3 id="a-session-is-slow-to-respond-after-attaching">734<h3 id="a-session-is-slow-to-respond-after-attaching">

695 セッションがアタッチ後に応答が遅い735 セッションがアタッチ後に応答が遅い

696</h3>736</h3>

697 737 

698セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。アタッチすると、中断したところから新しいプロセスが開始されます。作業中または入力を待機しているセッション、または[ピン留めされた](#organize-the-list)セッションはこの方法で停止されることはありません。セッションを `Ctrl+T` でピン留めして、応答性を保つことができます。738セッションが完了し、約 1 時間アタッチされていない状態で待機すると、スーパーバイザーはリソースを解放するためにプロセスを停止します。アタッチすると、中断したところから新しいプロセスが開始され、プロセスが再起動している間にセッションにすぐに切り替わります。作業中または入力を待機しているセッション、または[ピン留めされた](#organize-the-list)セッションはこの方法で停止されることはありません。セッションを `Ctrl+T` でピン留めして、応答性を保つことができます。

699 739 

700<h3 id="claude/worktrees/-is-filling-up">740<h3 id="claude/worktrees/-is-filling-up">

701 `.claude/worktrees/` が満杯になっている741 `.claude/worktrees/` が満杯になっている


731 771 

732| バージョン | 変更 |772| バージョン | 変更 |

733| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |773| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

774| v2.1.205 | {/* min-version: 2.1.205 */}行の概要はセッション自体の 1 行レポートを表示し、64 列で切り詰められます。生のツール呼び出しまたは `done/total` カウントの代わりに表示されます。ディレクトリグループ化された行は色付きの状態単語で開きます。ピークパネルは完全なステータス文で開き、あなたを待っているセッションの場合、返信入力の上にその正確な質問が表示されます。`gh` でプルリクエストを編集、コメント、クローズ、またはレディマークするセッションはそれにリンクされます。プルリクエストを作成またはチェックアウトするセッションだけではなく、プッシュはローカルブランチ名が一致しない場合でもプルリクエストをリンクし、作成コマンドの出力がインライン制限を超えたプルリクエストもリンクされます。読み取り可能なテキストがないターンは、セッションの前の状態を保持し、`Working` に戻すのではなく、フリップします。`claude attach` は再開中のセッションを約 60 秒間待機し、理由を名前で示すステータス行を表示します。失敗する代わりに。 |

775| v2.1.203 | {/* min-version: 2.1.203 */}ディスパッチシェルでエクスポートされたゲートウェイ `ANTHROPIC_BASE_URL` は、スーパーバイザーがそのゲートウェイ環境を共有する場合、それと同じディレクトリにディスパッチされたセッションに到達します。これは、それと一緒にエクスポートされた API キーが保持されている間にドロップされるのではなく、到達します。ディスパッチシェルの `PATH` は各セッションのワーカーに適用されます。サブエージェントが実行中に `←` を押すと、10 秒後に再開する代わりに、それらが完了するのを待ちます。空のリストは常にセクションヘッダーを各ヘッダーの下に説明とともに表示します。ディスパッチ入力で `@` を入力すると、起動リポジトリの登録済み git worktrees もそのディレクトリツリー内に存在するものをリストします。`effortLevel` 設定から継承された努力は、ディスパッチで固定されるのではなく、その設定への後の編集に従います。別の実行中のセッションで会話がすでに開いている停止されたセッションを開くと、行が失敗するのではなく、メッセージで拒否されます。agent view で利用できないコマンドは、入力に入力されたテキストを残します。git リポジトリの外で失敗する `WorktreeCreate` フックは、セッションがファイルを編集するのをもはやブロックしません。 |

776| v2.1.202 | {/* min-version: 2.1.202 */}`/rename` または `Ctrl+R` でバックグラウンドセッションに設定された名前は、スーパーバイザーがそのプロセスを停止して再開しても、セッションがディスパッチされた時の名前に戻るのではなく、永続化されます。 |

777| v2.1.200 | {/* min-version: 2.1.200 */}古い Claude Code バージョンが `roster.json` のセッションリストを書き直す場合、新しいバージョンによって書き込まれたフィールドを保持し、既存の `state.json` 保証と一致するため、新しいバージョンで開始されたセッションはスーパーバイザーが再開した後も入力を受け入れ続けます。応答を停止したセッションを開くと、スーパーバイザーはそのプロセスを再開し、セッションは中断された応答を中断した場所から続行します。 |

734| v2.1.199 | {/* min-version: 2.1.199 */}プロセスが低メモリホストで起動を完了する前に終了するバックグラウンドセッションは、単に終了理由だけではなく、その行ステータスに `possibly low memory — free some up and retry` を表示します。`←` または `/background` でセッションをバックグラウンド化すると、その `/color` が新しい行に引き継がれます。 |778| v2.1.199 | {/* min-version: 2.1.199 */}プロセスが低メモリホストで起動を完了する前に終了するバックグラウンドセッションは、単に終了理由だけではなく、その行ステータスに `possibly low memory — free some up and retry` を表示します。`←` または `/background` でセッションをバックグラウンド化すると、その `/color` が新しい行に引き継がれます。 |

735| v2.1.198 | {/* min-version: 2.1.198 */}Agent view はバックグラウンドセッションが入力を必要とする場合、完了する場合、または失敗する場合に `preferredNotifChannel` を通じて通知を送信し、`agent_needs_input` または `agent_completed` タイプで `Notification` フックを発火します。`claude attach <id>` 内の `←` と `/exit` はシェルに終了するのではなく agent view に戻ります。`Ctrl+Z` はシェルに戻ります。バックグラウンドセッションは作業を worktree に分離し、コミットして独自の分離ブランチをプッシュし、`main` または `master` をプッシュしません。完了時に最初に確認するのではなく、ドラフトプルリクエストを開きます。`/login` は agent view で実行され、サインインダイアログを開きます。`Background work is running` 終了ダイアログは `Move to background and exit` を提供します。終了ハンドオフはバックグラウンドサブエージェントもカバーし、失敗として報告される代わりに次の起動時にトランスクリプトから再開します。`claude --bg` を `-p` または `--print` と組み合わせるとエラーで拒否されます。 |779| v2.1.198 | {/* min-version: 2.1.198 */}Agent view はバックグラウンドセッションが入力を必要とする場合、完了する場合、または失敗する場合に `preferredNotifChannel` を通じて通知を送信し、`agent_needs_input` または `agent_completed` タイプで `Notification` フックを発火します。`claude attach <id>` 内の `←` と `/exit` はシェルに終了するのではなく agent view に戻ります。`Ctrl+Z` はシェルに戻ります。バックグラウンドセッションは作業を worktree に分離し、コミットして独自の分離ブランチをプッシュし、`main` または `master` をプッシュしません。完了時に最初に確認するのではなく、ドラフトプルリクエストを開きます。`/login` は agent view で実行され、サインインダイアログを開きます。`Background work is running` 終了ダイアログは `Move to background and exit` を提供します。終了ハンドオフはバックグラウンドサブエージェントもカバーし、失敗として報告される代わりに次の起動時にトランスクリプトから再開します。`claude --bg` を `-p` または `--print` と組み合わせるとエラーで拒否されます。 |

736| v2.1.196 | {/* min-version: 2.1.196 */}単一の `←` 押下がフォアグラウンドセッションをバックグラウンド化します。以前のバージョンでは 2 回の押下が必要で、フッターヒントと確認がありました。`claude agents` に渡された `--dangerously-skip-permissions` は、静かにドロップされるのではなく、バイパス免責事項を表示します。対話的なセッションで名前を付けたことがない場合は、セッションリストと `claude agents --json` で `my-app-3f` などのデフォルト名を持ちます。バックグラウンドシェルコマンドと動的ワークフローはセッションのプロセスが停止、再開、または更新されても生き残ります。Windows を含みます。ハンドオフをオフにするには `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` を設定します。再開時に空として誤読されたトランスクリプトは削除される代わりに `.orphaned-` サフィックスで名前が変更されます。 |780| v2.1.196 | {/* min-version: 2.1.196 */}単一の `←` 押下がフォアグラウンドセッションをバックグラウンド化します。以前のバージョンでは 2 回の押下が必要で、フッターヒントと確認がありました。`claude agents` に渡された `--dangerously-skip-permissions` は、静かにドロップされるのではなく、バイパス免責事項を表示します。対話的なセッションで名前を付けたことがない場合は、セッションリストと `claude agents --json` で `my-app-3f` などのデフォルト名を持ちます。バックグラウンドシェルコマンドと動的ワークフローはセッションのプロセスが停止、再開、または更新されても生き残ります。Windows を含みます。ハンドオフをオフにするには `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF=1` を設定します。再開時に空として誤読されたトランスクリプトは削除される代わりに `.orphaned-` サフィックスで名前が変更されます。 |

737| v2.1.195 | {/* min-version: 2.1.195 */}実行中の作業は Windows でセッションをバックグラウンド化するときに転送されます。`CLAUDE_DISABLE_ADOPT=1` を設定して代わりに停止します。`Completed` グループは残りの垂直スペースを埋め、ヘッダーは短いターミナルでコンパクトになります。古い Claude Code バージョンはもはや新しいセッションの `state.json` フィールドをドロップしたり、それらのセッションを `claude agents` から隠したりしません。停止されたセッションにアタッチすると、最大 5 秒間の空白画面を表示する代わりに直ちに切り替わります。接続を受け入けることができないスーパーバイザーは独自に終了してロックを解放します。 |781| v2.1.195 | {/* min-version: 2.1.195 */}実行中の作業は Windows でセッションをバックグラウンド化するときに転送されます。`CLAUDE_DISABLE_ADOPT=1` を設定して代わりに停止します。`Completed` グループは残りの垂直スペースを埋め、ヘッダーは短いターミナルでコンパクトになります。古い Claude Code バージョンはもはや新しいセッションの `state.json` フィールドをドロップしたり、それらのセッションを `claude agents` から隠したりしません。停止されたセッションにアタッチすると、最大 5 秒間の空白画面を表示する代わりに直ちに切り替わります。接続を受け入れることができないスーパーバイザーは独自に終了してロックを解放します。 |

738| v2.1.174 | {/* min-version: 2.1.174 */}バックグラウンドセッションはスーパーバイザーの起動シェルからゲートウェイエンドポイント変数(`ANTHROPIC_BASE_URL` など)を継承しなくなります。スーパーバイザーはプリウォーミングされたワーカーに新しい認証情報スナップショットを提供し、誤った `Could not resolve authentication method` エラーを修正します。 |782| v2.1.174 | {/* min-version: 2.1.174 */}バックグラウンドセッションはスーパーバイザーの起動シェルからゲートウェイエンドポイント変数(`ANTHROPIC_BASE_URL` など)を継承しなくなります。スーパーバイザーはプリウォーミングされたワーカーに新しい認証情報スナップショットを提供し、誤った `Could not resolve authentication method` エラーを修正します。 |

739| v2.1.172 | {/* min-version: 2.1.172 */}ディスパッチ入力の `/model` はセッションスコープのディスパッチモデルオーバーライドを設定します。 |783| v2.1.172 | {/* min-version: 2.1.172 */}ディスパッチ入力の `/model` はセッションスコープのディスパッチモデルオーバーライドを設定します。 |

740| v2.1.161 | {/* min-version: 2.1.161 */}行の概要は並列作業項目の `done/total` カウントを表示します。ピークパネルは最も長く実行されている並列作業項目を名前で表示します。 |784| v2.1.161 | {/* min-version: 2.1.161 */}行の概要は並列作業項目の `done/total` カウントを表示します。ピークパネルは最も長く実行されている並列作業項目を名前で表示します。 |

741| v2.1.157 | {/* min-version: 2.1.157 */}ディスパッチされたセッションは `agent` 設定を尊重します。`claude agents` は `--agent` を受け入れます。 |785| v2.1.157 | {/* min-version: 2.1.157 */}`claude agents` は `--agent` を受け入れます。ディスパッチされたセッションは `agent` 設定を尊重します。 |

742| v2.1.145 | {/* min-version: 2.1.145 */}ピークパネル返信入力とディスパッチ入力でサポートされている音声ディクテーション。 |786| v2.1.145 | {/* min-version: 2.1.145 */}ピークパネル返信入力とディスパッチ入力でサポートされている音声ディクテーション。 |

743| v2.1.143 | {/* min-version: 2.1.143 */}追加された `worktree.bgIsolation` 設定。`claude agents` は `--allow-dangerously-skip-permissions` を受け入れます。 |787| v2.1.143 | {/* min-version: 2.1.143 */}`worktree.bgIsolation` 設定が追加されました。`claude agents` は `--allow-dangerously-skip-permissions` を受け入れます。 |

744| v2.1.142 | {/* min-version: 2.1.142 */}ディスパッチされたセッションは `agent` 設定を尊重します。`claude agents` は `--permission-mode`、`--model`、`--effort`、`--dangerously-skip-permissions`、`--settings`、`--add-dir`、`--plugin-dir`、`--mcp-config`、`--strict-mcp-config` を受け入れます。 |788| v2.1.142 | {/* min-version: 2.1.142 */}`claude agents` は `--permission-mode`、`--model`、`--effort`、`--dangerously-skip-permissions`、`--settings`、`--add-dir`、`--plugin-dir`、`--mcp-config`、`--strict-mcp-config` を受け入れます。 |

745| v2.1.141 | {/* min-version: 2.1.141 */}ディスパッチされたセッションは `agent` 設定を尊重します。`claude agents` は `--cwd` を受け入れてリストを 1 つのプロジェクトにスコープします。 |789| v2.1.141 | {/* min-version: 2.1.141 */}`claude agents` は `--cwd` を受け入れてリストを 1 つのプロジェクトにスコープします。 |

746| v2.1.139 | {/* min-version: 2.1.139 */}Agent view はリサーチプレビューとして導入されました。 |790| v2.1.139 | {/* min-version: 2.1.139 */}Agent view はリサーチプレビューとして導入されました。 |

amazon-bedrock.md +33 −33

Details

82 前提条件82 前提条件

83</h2>83</h2>

84 84 

85Claude Code を Bedrock で設定する前に、以下を確認してください。85Claude Code を Amazon Bedrock で設定する前に、以下を確認してください。

86 86 

87* Bedrock アクセスが有効になっている AWS アカウント87* Amazon Bedrock アクセスが有効になっている AWS アカウント

88* Bedrock で目的の Claude モデル(例:Claude Sonnet 4.6)へのアクセス88* Amazon Bedrock で目的の Claude モデル(例:Claude Sonnet 4.6)へのアクセス

89* AWS CLI がインストールされ、設定されていること(オプション - 認証情報を取得する別のメカニズムがない場合のみ必要)89* AWS CLI がインストールされ、設定されていること(オプション - 認証情報を取得する別のメカニズムがない場合のみ必要)

90* 適切な IAM 権限90* 適切な IAM 権限

91 91 

92Bedrock 認証情報を使用してサインインするには、以下の [Bedrock でサインイン](#sign-in-with-bedrock)に従ってください。チーム全体に Claude Code をデプロイするには、[手動でセットアップ](#set-up-manually)の手順を使用し、ロールアウト前に[モデルバージョンをピン留め](#4-pin-model-versions)してください。92Amazon Bedrock 認証情報を使用してサインインするには、以下の [Amazon Bedrock でサインイン](#sign-in-with-bedrock)に従ってください。チーム全体に Claude Code をデプロイするには、[手動でセットアップ](#set-up-manually)の手順を使用し、ロールアウト前に[モデルバージョンをピン留め](#4-pin-model-versions)してください。

93 93 

94<h2 id="sign-in-with-bedrock">94<h2 id="sign-in-with-bedrock">

95 Bedrock でサインイン95 Bedrock でサインイン

96</h2>96</h2>

97 97 

98AWS 認証情報を持っていて、Bedrock を通じて Claude Code の使用を開始したい場合、ログインウィザードがそれをガイドします。AWS 側の前提条件はアカウントごとに 1 回完了します。ウィザードは Claude Code 側を処理します。98AWS 認証情報を持っていて、Amazon Bedrock を通じて Claude Code の使用を開始したい場合、ログインウィザードがそれをガイドします。AWS 側の前提条件はアカウントごとに 1 回完了します。ウィザードは Claude Code 側を処理します。

99 99 

100<Steps>100<Steps>

101 <Step title="AWS アカウントで Anthropic モデルを有効にする">101 <Step title="AWS アカウントで Anthropic モデルを有効にする">

102 [Amazon Bedrock コンソール](https://console.aws.amazon.com/bedrock/)で、モデルカタログを開き、Anthropic モデルを選択して、ユースケースフォームを送信します。送信直後にアクセスが付与されます。AWS Organizations については[ユースケースの詳細を送信](#1-submit-use-case-details)を、権限については [IAM 設定](#iam-configuration)を参照してください。102 [Amazon Bedrock コンソール](https://console.aws.amazon.com/bedrock/)で、モデルカタログを開き、Anthropic モデルを選択して、ユースケースフォームを送信します。送信直後にアクセスが付与されます。AWS Organizations については[ユースケースの詳細を送信](#1-submit-use-case-details)を、権限については [IAM 設定](#iam-configuration)を参照してください。

103 </Step>103 </Step>

104 104 

105 <Step title="Claude Code を開始して Bedrock を選択する">105 <Step title="Claude Code を開始して Amazon Bedrock を選択する">

106 `claude` を実行します。ログインプロンプトで、**3rd-party platform**、次に **Amazon Bedrock** を選択します。106 `claude` を実行します。ログインプロンプトで、**3rd-party platform**、次に **Amazon Bedrock** を選択します。

107 </Step>107 </Step>

108 108 

109 <Step title="ウィザードプロンプトに従う">109 <Step title="ウィザードプロンプトに従う">

110 AWS に認証する方法を選択します。`~/.aws` ディレクトリから検出された AWS プロファイル、Bedrock API キー、アクセスキーとシークレット、または環境内に既にある認証情報です。ウィザードはリージョンを取得し、アカウントが呼び出せる Claude モデルを確認し、それらをピン留めできます。結果は [user settings file](/ja/settings) の `env` ブロックに保存されるため、環境変数を自分でエクスポートする必要はありません。110 AWS に認証する方法を選択します。`~/.aws` ディレクトリから検出された AWS プロファイル、Amazon Bedrock API キー、アクセスキーとシークレット、または環境内に既にある認証情報です。ウィザードはリージョンを取得し、アカウントが呼び出せる Claude モデルを確認し、それらをピン留めできます。結果は [user settings file](/ja/settings) の `env` ブロックに保存されるため、環境変数を自分でエクスポートする必要はありません。

111 </Step>111 </Step>

112</Steps>112</Steps>

113 113 


117 手動でセットアップ117 手動でセットアップ

118</h2>118</h2>

119 119 

120ウィザードの代わりに環境変数を通じて Bedrock を設定するには、例えば CI またはスクリプト化されたエンタープライズロールアウトで、以下の手順に従ってください。120ウィザードの代わりに環境変数を通じて Amazon Bedrock を設定するには、例えば CI またはスクリプト化されたエンタープライズロールアウトで、以下の手順に従ってください。

121 121 

122<h3 id="1-submit-use-case-details">122<h3 id="1-submit-use-case-details">

123 1. ユースケースの詳細を送信123 1. ユースケースの詳細を送信


168 168 

169`aws login` について[詳しく学習](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html)してください。169`aws login` について[詳しく学習](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html)してください。

170 170 

171**オプション E:Bedrock API キー**171**オプション E:Amazon Bedrock API キー**

172 172 

173```bash theme={null}173```bash theme={null}

174export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key174export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

175```175```

176 176 

177Bedrock API キーは、完全な AWS 認証情報を必要としない、より簡単な認証方法を提供します。[Bedrock API キーについて詳しく学習](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)してください。177Amazon Bedrock API キーは、完全な AWS 認証情報を必要としない、より簡単な認証方法を提供します。[Amazon Bedrock API キーについて詳しく学習](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/)してください。

178 178 

179<h4 id="advanced-credential-configuration">179<h4 id="advanced-credential-configuration">

180 高度な認証情報設定180 高度な認証情報設定


185これら 2 つの設定には異なるトリガー条件があります。185これら 2 つの設定には異なるトリガー条件があります。

186 186 

187* **`awsAuthRefresh`**:Claude Code がローカルのタイムスタンプに基づくか、API が認証情報エラーを返した場合に AWS 認証情報の有効期限が切れていることを検出した場合にのみ実行され、更新された認証情報でリクエストを再試行します。187* **`awsAuthRefresh`**:Claude Code がローカルのタイムスタンプに基づくか、API が認証情報エラーを返した場合に AWS 認証情報の有効期限が切れていることを検出した場合にのみ実行され、更新された認証情報でリクエストを再試行します。

188* **`awsCredentialExport`**:セッション開始時および各認証情報リロード時に実行されます。AWS デフォルト認証情報プロバイダーチェーン内の認証情報がまだ有効な場合でも実行されます。Bedrock アカウントがデフォルトプロバイダーチェーンが解決するものと異なるクロスアカウント認証情報を必要とする場合に使用します。188* **`awsCredentialExport`**:セッション開始時および各認証情報リロード時に実行されます。AWS デフォルト認証情報プロバイダーチェーン内の認証情報がまだ有効な場合でも実行されます。Amazon Bedrock アカウントがデフォルトプロバイダーチェーンが解決するものと異なるクロスアカウント認証情報を必要とする場合に使用します。

189 189 

190<h5 id="example-configuration">190<h5 id="example-configuration">

191 設定例191 設定例


243# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com243# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

244```244```

245 245 

246Claude Code で Bedrock を有効にする場合は、以下に注意してください。246Claude Code で Amazon Bedrock を有効にする場合は、以下に注意してください。

247 247 

248* {/* min-version: 2.1.172 */}v2.1.172 以降では、AWS プロファイルのリージョンをオーバーライドする場合、またはプロファイルにリージョンがない場合にのみ `AWS_REGION` を設定する必要があります。Claude Code はこの順序でリージョンを解決します。248* {/* min-version: 2.1.172 */}v2.1.172 以降では、AWS プロファイルのリージョンをオーバーライドする場合、またはプロファイルにリージョンがない場合にのみ `AWS_REGION` を設定する必要があります。Claude Code はこの順序でリージョンを解決します。

249 249 


253 * `us-east-1`253 * `us-east-1`

254 254 

255 アクティブなプロファイルは、設定されている場合は `AWS_PROFILE`、そうでない場合は `default` です。`AWS_SHARED_CREDENTIALS_FILE` または `AWS_CONFIG_FILE` を設定して、デフォルト以外のファイルパスを指定します。`/status` を実行して、解決されたリージョンを確認します。リージョンが AWS 設定ファイルまたはデフォルトフォールバックから取得された場合、`/status` はソースも記載します。v2.1.171 以前では、Claude Code は AWS 設定ファイルを読み込まないため、`AWS_REGION` を明示的に設定してください。255 アクティブなプロファイルは、設定されている場合は `AWS_PROFILE`、そうでない場合は `default` です。`AWS_SHARED_CREDENTIALS_FILE` または `AWS_CONFIG_FILE` を設定して、デフォルト以外のファイルパスを指定します。`/status` を実行して、解決されたリージョンを確認します。リージョンが AWS 設定ファイルまたはデフォルトフォールバックから取得された場合、`/status` はソースも記載します。v2.1.171 以前では、Claude Code は AWS 設定ファイルを読み込まないため、`AWS_REGION` を明示的に設定してください。

256* Bedrock を使用する場合、`/logout` コマンドは無効になります。認証は AWS 認証情報を通じて処理されるためです。256* Amazon Bedrock を使用する場合、`/logout` コマンドは無効になります。認証は AWS 認証情報を通じて処理されるためです。

257* WebSearch ツールは Bedrock では利用できません。[WebSearch ツールの動作](/ja/tools-reference#websearch-tool-behavior)を参照してください。257* WebSearch ツールは Amazon Bedrock では利用できません。[WebSearch ツールの動作](/ja/tools-reference#websearch-tool-behavior)を参照してください。

258* 他のプロセスに漏らしたくない `AWS_PROFILE` などの環境変数に設定ファイルを使用できます。詳細については [Settings](/ja/settings) を参照してください。258* 他のプロセスに漏らしたくない `AWS_PROFILE` などの環境変数に設定ファイルを使用できます。詳細については [Settings](/ja/settings) を参照してください。

259 259 

260<h3 id="4-pin-model-versions">260<h3 id="4-pin-model-versions">


262</h3>262</h3>

263 263 

264<Warning>264<Warning>

265 複数のユーザーにデプロイする場合は、特定のモデルバージョンをピン留めしてください。ピン留めなしでは、`sonnet` や `opus` などのモデルエイリアスは Claude Code の Bedrock 用の組み込みデフォルトに解決されます。これは最新リリースより遅れる可能性があり、アカウントでまだ利用できない場合があります。Claude Code は、デフォルトが利用できない場合、スタートアップで[前のバージョンにフォールバック](#startup-model-checks)しますが、ピン留めするとユーザーが新しいモデルに移行するタイミングを制御できます。265 複数のユーザーにデプロイする場合は、特定のモデルバージョンをピン留めしてください。ピン留めなしでは、`sonnet` や `opus` などのモデルエイリアスは Claude Code の Amazon Bedrock 用の組み込みデフォルトに解決されます。これは最新リリースより遅れる可能性があり、アカウントでまだ利用できない場合があります。Claude Code は、デフォルトが利用できない場合、スタートアップで[前のバージョンにフォールバック](#startup-model-checks)しますが、ピン留めするとユーザーが新しいモデルに移行するタイミングを制御できます。

266</Warning>266</Warning>

267 267 

268これらの環境変数を特定の Bedrock モデル ID に設定します。268これらの環境変数を特定の Amazon Bedrock モデル ID に設定します。

269 269 

270`ANTHROPIC_DEFAULT_OPUS_MODEL` なしでは、Bedrock の `opus` エイリアスは Opus 4.6 に解決されます。最新モデルを使用するには、Opus 4.8 ID に設定します。270`ANTHROPIC_DEFAULT_OPUS_MODEL` なしでは、Amazon Bedrock の `opus` エイリアスは Opus 4.6 に解決されます。最新モデルを使用するには、Opus 4.8 ID に設定します。

271 271 

272```bash theme={null}272```bash theme={null}

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


284| プライマリモデル | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |284| プライマリモデル | `us.anthropic.claude-sonnet-4-5-20250929-v1:0` |

285| 小型/高速モデル | プライマリモデルと同じ |285| 小型/高速モデル | プライマリモデルと同じ |

286 286 

287セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル(通常は Haiku クラスモデル)を使用します。Bedrock では、すべてのアカウントまたはリージョンで Haiku が有効になっていない可能性があるため、Claude Code はこれをプライマリモデルにデフォルト設定します。バックグラウンドタスクに Haiku を使用するには、`ANTHROPIC_DEFAULT_HAIKU_MODEL` をアカウントで利用可能なモデル ID に設定してください。287セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル(通常は Haiku クラスモデル)を使用します。Amazon Bedrock では、すべてのアカウントまたはリージョンで Haiku が有効になっていない可能性があるため、Claude Code はこれをプライマリモデルにデフォルト設定します。バックグラウンドタスクに Haiku を使用するには、`ANTHROPIC_DEFAULT_HAIKU_MODEL` をアカウントで利用可能なモデル ID に設定してください。

288 288 

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

290 290 


305 305 

3061 時間のキャッシュ TTL は、5 分のデフォルトよりも高いレートで課金されます。[キャッシュライフタイム](/ja/prompt-caching#cache-lifetime)を参照してください。3061 時間のキャッシュ TTL は、5 分のデフォルトよりも高いレートで課金されます。[キャッシュライフタイム](/ja/prompt-caching#cache-lifetime)を参照してください。

307 307 

308<Note>プロンプトキャッシングは、すべての Bedrock リージョンで利用できない場合があります。キャッシュトークンカウントがゼロのままの場合は、Bedrock ドキュメントの[サポートされているモデル、リージョン、および制限](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models)を確認してください。</Note>308<Note>プロンプトキャッシングは、すべての Amazon Bedrock リージョンで利用できない場合があります。キャッシュトークンカウントがゼロのままの場合は、Amazon Bedrock ドキュメントの[サポートされているモデル、リージョン、および制限](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models)を確認してください。</Note>

309 309 

310<h4 id="map-each-model-version-to-an-inference-profile">310<h4 id="map-each-model-version-to-an-inference-profile">

311 各モデルバージョンを推論プロファイルにマップ311 各モデルバージョンを推論プロファイルにマップ


326}326}

327```327```

328 328 

329ユーザーが `/model` でこれらのバージョンのいずれかを選択すると、Claude Code はマップされた ARN で Bedrock を呼び出します。オーバーライドのないバージョンは、組み込みの Bedrock モデル ID またはスタートアップで検出された一致する推論プロファイルにフォールバックします。オーバーライドが `availableModels` および他のモデル設定とどのように相互作用するかについては、[Override model IDs per version](/ja/model-config#override-model-ids-per-version) を参照してください。329ユーザーが `/model` でこれらのバージョンのいずれかを選択すると、Claude Code はマップされた ARN で Amazon Bedrock を呼び出します。{/* min-version: 2.1.200 */}同じマッピングは、`--model` または `ANTHROPIC_MODEL` を通じて Anthropic モデル ID を直接渡す場合にも適用されます。オーバーライドのないバージョンは、組み込みの Amazon Bedrock モデル ID またはスタートアップで検出された一致する推論プロファイルにフォールバックします。v2.1.200 より前では、`--model` および `ANTHROPIC_MODEL` の値はオーバーライドマップを通さずに Amazon Bedrock に到達しました。オーバーライドが `availableModels` および他のモデル設定とどのように相互作用するかについては、[Override model IDs per version](/ja/model-config#override-model-ids-per-version) を参照してください。

330 330 

331<h2 id="startup-model-checks">331<h2 id="startup-model-checks">

332 スタートアップモデルチェック332 スタートアップモデルチェック

333</h2>333</h2>

334 334 

335Claude Code が Bedrock で設定されて起動すると、使用するモデルがアカウントでアクセス可能であることを確認します。このチェックには Claude Code v2.1.94 以降が必要です。335Claude Code が Amazon Bedrock で設定されて起動すると、使用するモデルがアカウントでアクセス可能であることを確認します。このチェックには Claude Code v2.1.94 以降が必要です。

336 336 

337現在の Claude Code デフォルトより古いモデルバージョンをピン留めしていて、アカウントが新しいバージョンを呼び出せる場合、Claude Code はピンを更新するよう促します。受け入れると、新しいモデル ID が [user settings file](/ja/settings) に書き込まれ、Claude Code が再起動されます。拒否すると、次のデフォルトバージョン変更まで記憶されます。[アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile)を指す PIN は、管理者によって管理されるため、スキップされます。337現在の Claude Code デフォルトより古いモデルバージョンをピン留めしていて、アカウントが新しいバージョンを呼び出せる場合、Claude Code はピンを更新するよう促します。受け入れると、新しいモデル ID が [user settings file](/ja/settings) に書き込まれ、Claude Code が再起動されます。拒否すると、次のデフォルトバージョン変更まで記憶されます。[アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile)を指す PIN は、管理者によって管理されるため、スキップされます。

338 338 

339モデルをピン留めしていなくて、現在のデフォルトがアカウントで利用できない場合、Claude Code は現在のセッションで前のバージョンにフォールバックし、通知を表示します。フォールバックは永続化されません。Bedrock アカウントで新しいモデルを有効にするか、[バージョンをピン留め](#4-pin-model-versions)して選択を永続化してください。339モデルをピン留めしていなくて、現在のデフォルトがアカウントで利用できない場合、Claude Code は現在のセッションで前のバージョンにフォールバックし、通知を表示します。フォールバックは永続化されません。Amazon Bedrock アカウントで新しいモデルを有効にするか、[バージョンをピン留め](#4-pin-model-versions)して選択を永続化してください。

340 340 

341<h2 id="iam-configuration">341<h2 id="iam-configuration">

342 IAM 設定342 IAM 設定


387 387 

388トークンにこの権限がない場合、Claude Code は代替形状で 1 回再試行することで自動的に復旧するため、リクエストは成功しますが、新しいモデルが追加されるたびに追加のラウンドトリップが発生します。権限を付与することで再試行を回避できます。これは `AWS_BEARER_TOKEN_BEDROCK` デプロイメントに最も頻繁に適用され、トークンのポリシーは通常、完全な IAM ロールよりも狭くなります。388トークンにこの権限がない場合、Claude Code は代替形状で 1 回再試行することで自動的に復旧するため、リクエストは成功しますが、新しいモデルが追加されるたびに追加のラウンドトリップが発生します。権限を付与することで再試行を回避できます。これは `AWS_BEARER_TOKEN_BEDROCK` デプロイメントに最も頻繁に適用され、トークンのポリシーは通常、完全な IAM ロールよりも狭くなります。

389 389 

390詳細については、[Bedrock IAM documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam.html)を参照してください。390詳細については、[Amazon Bedrock IAM ドキュメント](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam.html)を参照してください。

391 391 

392<Note>392<Note>

393 コスト追跡とアクセス制御を簡素化するために、Claude Code 用の専用 AWS アカウントを作成してください。393 コスト追跡とアクセス制御を簡素化するために、Claude Code 用の専用 AWS アカウントを作成してください。


450export AWS_REGION=us-east-1450export AWS_REGION=us-east-1

451```451```

452 452 

453Claude Code は AWS リージョンからエンドポイント URL を構築します。{/* min-version: 2.1.172 */}v2.1.172 以降では、リージョンは [上記の Bedrock](#3-configure-claude-code) と同じ優先順位で解決されます。以前のバージョンは `AWS_REGION` のみを使用します。カスタムエンドポイントまたはゲートウェイの URL をオーバーライドするには、`ANTHROPIC_BEDROCK_MANTLE_BASE_URL` を設定します。453Claude Code は AWS リージョンからエンドポイント URL を構築します。{/* min-version: 2.1.172 */}v2.1.172 以降では、リージョンは [上記の Amazon Bedrock](#3-configure-claude-code) と同じ優先順位で解決されます。以前のバージョンは `AWS_REGION` のみを使用します。カスタムエンドポイントまたはゲートウェイの URL をオーバーライドするには、`ANTHROPIC_BEDROCK_MANTLE_BASE_URL` を設定します。

454 454 

455Claude Code 内で `/status` を実行して確認します。Mantle がアクティブな場合、プロバイダー行は `Amazon Bedrock (Mantle)` を表示します。455Claude Code 内で `/status` を実行して確認します。Mantle がアクティブな場合、プロバイダー行は `Amazon Bedrock (Mantle)` を表示します。

456 456 


470 Mantle を Invoke API と並行して実行する470 Mantle を Invoke API と並行して実行する

471</h3>471</h3>

472 472 

473Mantle で利用可能なモデルは、今日使用するすべてのモデルを含まない場合があります。`CLAUDE_CODE_USE_BEDROCK` と `CLAUDE_CODE_USE_MANTLE` の両方を設定すると、Claude Code は同じセッションから両方のエンドポイントを呼び出せます。Mantle 形式に一致するモデル ID は Mantle にルーティングされ、他のすべてのモデル ID は Bedrock Invoke API に移動します。473Mantle で利用可能なモデルは、今日使用するすべてのモデルを含まない場合があります。`CLAUDE_CODE_USE_BEDROCK` と `CLAUDE_CODE_USE_MANTLE` の両方を設定すると、Claude Code は同じセッションから両方のエンドポイントを呼び出せます。Mantle 形式に一致するモデル ID は Mantle にルーティングされ、他のすべてのモデル ID は Amazon Bedrock Invoke API に移動します。

474 474 

475```bash theme={null}475```bash theme={null}

476export CLAUDE_CODE_USE_BEDROCK=1476export CLAUDE_CODE_USE_BEDROCK=1


540 540 

541* モデルを [inference profile](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html) ID として指定します541* モデルを [inference profile](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html) ID として指定します

542 542 

543Claude Code は Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) を使用し、Converse API はサポートしていません。543Claude Code は Amazon Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) を使用し、Converse API はサポートしていません。

544 544 

545<h3 id="zero-token-counts-in-/context">545<h3 id="zero-token-counts-in-/context">

546 /context でのゼロトークンカウント546 /context でのゼロトークンカウント

547</h3>547</h3>

548 548 

549`/context` コマンドは、ツールスキーマを Bedrock count-tokens API に送信することで、各ツールグループのトークンをカウントします。{/* min-version: 2.1.196 */}Claude Code v2.1.196 より前のバージョンでは、スキーマが count-tokens API が受け入れないフィールドを含んでいたため、Bedrock がそのリクエストを拒否し、すべてのツールグループが 0 トークンを表示していました。メッセージやメモリファイルなど、内訳の他の行は影響を受けません。549`/context` コマンドは、ツールスキーマを Amazon Bedrock count-tokens API に送信することで、各ツールグループのトークンをカウントします。{/* min-version: 2.1.196 */}Claude Code v2.1.196 より前のバージョンでは、スキーマが count-tokens API が受け入れないフィールドを含んでいたため、Amazon Bedrock がそのリクエストを拒否し、すべてのツールグループが 0 トークンを表示していました。メッセージやメモリファイルなど、内訳の他の行は影響を受けません。

550 550 

551v2.1.196 以降に更新してください。551v2.1.196 以降に更新してください。

552 552 


558 558 

559有効な認証情報を持つ Mantle エンドポイントからの `403` は、AWS アカウントがリクエストしたモデルへのアクセスを許可されていないことを意味します。AWS アカウントチームに連絡してアクセスをリクエストしてください。559有効な認証情報を持つ Mantle エンドポイントからの `403` は、AWS アカウントがリクエストしたモデルへのアクセスを許可されていないことを意味します。AWS アカウントチームに連絡してアクセスをリクエストしてください。

560 560 

561モデル ID を名前付ける `400` は、そのモデルが Mantle で提供されていないことを意味します。Mantle は標準 Bedrock カタログとは別の独自のモデルラインアップを持っているため、`us.anthropic.claude-sonnet-4-6` などの推論プロファイル ID は機能しません。Mantle 形式の ID を使用するか、[両方のエンドポイントを有効にして](#run-mantle-alongside-the-invoke-api)、Claude Code が各リクエストをモデルが利用可能なエンドポイントにルーティングするようにしてください。561モデル ID を名前付ける `400` は、そのモデルが Mantle で提供されていないことを意味します。Mantle は標準 Amazon Bedrock カタログとは別の独自のモデルラインアップを持っているため、`us.anthropic.claude-sonnet-4-6` などの推論プロファイル ID は機能しません。Mantle 形式の ID を使用するか、[両方のエンドポイントを有効にして](#run-mantle-alongside-the-invoke-api)、Claude Code が各リクエストをモデルが利用可能なエンドポイントにルーティングするようにしてください。

562 562 

563<h2 id="additional-resources">563<h2 id="additional-resources">

564 追加リソース564 追加リソース

565</h2>565</h2>

566 566 

567* [Bedrock documentation](https://docs.aws.amazon.com/bedrock/)567* [Amazon Bedrock ドキュメント](https://docs.aws.amazon.com/bedrock/)

568* [Bedrock pricing](https://aws.amazon.com/bedrock/pricing/)568* [Amazon Bedrock 料金](https://aws.amazon.com/bedrock/pricing/)

569* [Bedrock inference profiles](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)569* [Amazon Bedrock 推論プロファイル](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html)

570* [Bedrock token burndown and quotas](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)570* [Amazon Bedrock トークンバーンダウンとクォータ](https://docs.aws.amazon.com/bedrock/latest/userguide/quotas-token-burndown.html)

571* [Claude Code on Amazon Bedrock: Quick Setup Guide](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)571* [Claude Code on Amazon Bedrock: Quick Setup Guide](https://community.aws/content/2tXkZKrZzlrlu0KfH8gST5Dkppq/claude-code-on-amazon-bedrock-quick-setup-guide)

572* [Claude Code Monitoring Implementation (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)572* [Claude Code Monitoring Implementation(Amazon Bedrock](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)

artifacts.md +1 −1

Details

192| :-------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |192| :-------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

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

194| 認証 | `/login` で claude.ai にサインインしています。API キー、[ゲートウェイトークン](/ja/llm-gateway)、またはクラウドプロバイダー認証情報を使用するセッションは公開できません。 |194| 認証 | `/login` で claude.ai にサインインしています。API キー、[ゲートウェイトークン](/ja/llm-gateway)、またはクラウドプロバイダー認証情報を使用するセッションは公開できません。 |

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

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

197| サーフェス | Claude Code CLI、または Claude デスクトップアプリバージョン 1.13576.0 以降。[Agent SDK](/ja/agent-sdk/overview)、GitHub Action、MCP サーバーコンテキストではデフォルトでオフになっており、[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/ja/env-vars) が設定されている場合もオフになります。 |197| サーフェス | Claude Code CLI、または Claude デスクトップアプリバージョン 1.13576.0 以降。[Agent SDK](/ja/agent-sdk/overview)、GitHub Action、MCP サーバーコンテキストではデフォルトでオフになっており、[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/ja/env-vars) が設定されている場合もオフになります。 |

198 198 

Details

6 6 

7> Claude Code にログインし、個人、チーム、組織向けの認証を設定します。7> Claude Code にログインし、個人、チーム、組織向けの認証を設定します。

8 8 

9Claude Code は、セットアップに応じて複数の認証方法をサポートしています。個人ユーザーは Claude.ai アカウントでログインでき、チームは Claude for Teams または Enterprise、Claude Console、または Amazon Bedrock、Google Vertex AI、Microsoft Foundry などのクラウドプロバイダーを使用できます。9Claude Code は、セットアップに応じて複数の認証方法をサポートしています。個人ユーザーは Claude.ai アカウントでログインでき、チームは Claude for Teams または Enterprise、Claude Console、または Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry などのクラウドプロバイダーを使用できます。

10 10 

11<h2 id="log-in-to-claude-code">11<h2 id="log-in-to-claude-code">

12 Claude Code にログインする12 Claude Code にログインする


23* **Claude Pro または Max サブスクリプション**: Claude.ai アカウントでログインします。[claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max) で購読してください。23* **Claude Pro または Max サブスクリプション**: Claude.ai アカウントでログインします。[claude.com/pricing](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=authentication_pro_max) で購読してください。

24* **Claude for Teams または Enterprise**: チーム管理者が招待した Claude.ai アカウントでログインします。24* **Claude for Teams または Enterprise**: チーム管理者が招待した Claude.ai アカウントでログインします。

25* **Claude Console**: Console 認証情報でログインします。管理者が事前に[招待](#claude-console-authentication)している必要があります。25* **Claude Console**: Console 認証情報でログインします。管理者が事前に[招待](#claude-console-authentication)している必要があります。

26* **クラウドプロバイダー**: 組織が [Amazon Bedrock](/ja/amazon-bedrock)、[Google Vertex AI](/ja/google-vertex-ai)、または [Microsoft Foundry](/ja/microsoft-foundry) を使用している場合は、`claude` を実行する前に必要な環境変数を設定してください。ブラウザログインは不要です。26* **クラウドプロバイダー**: 組織が [Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、または [Microsoft Foundry](/ja/microsoft-foundry) を使用している場合は、`claude` を実行する前に必要な環境変数を設定してください。ブラウザログインは不要です。

27* **クラウドゲートウェイ**: 組織がセルフホストされた [Claude apps gateway](/ja/claude-apps-gateway) を実行している場合は、`/login` を通じて企業 SSO でサインインします。ゲートウェイが発行したトークンはセッションの唯一の認証情報です。27* **クラウドゲートウェイ**: 組織がセルフホストされた [Claude apps gateway](/ja/claude-apps-gateway) を実行している場合は、`/login` を通じて企業 SSO でサインインします。ゲートウェイが発行したトークンはセッションの唯一の認証情報です。

28 28 

29ログアウトして再認証するには、Claude Code プロンプトで `/logout` と入力します。29ログアウトして再認証するには、Claude Code プロンプトで `/logout` と入力します。


40* [Claude Console](#claude-console-authentication)40* [Claude Console](#claude-console-authentication)

41* [Claude apps gateway](/ja/claude-apps-gateway)(開発者を IdP でサインインさせ、設定したクラウドプロバイダーに推論をルーティングする自己ホスト型ゲートウェイ)41* [Claude apps gateway](/ja/claude-apps-gateway)(開発者を IdP でサインインさせ、設定したクラウドプロバイダーに推論をルーティングする自己ホスト型ゲートウェイ)

42* [Amazon Bedrock](/ja/amazon-bedrock)42* [Amazon Bedrock](/ja/amazon-bedrock)

43* [Google Vertex AI](/ja/google-vertex-ai)43* [Google Cloud の Agent Platform](/ja/google-vertex-ai)

44* [Microsoft Foundry](/ja/microsoft-foundry)44* [Microsoft Foundry](/ja/microsoft-foundry)

45 45 

46<h3 id="claude-for-teams-or-enterprise">46<h3 id="claude-for-teams-or-enterprise">


105 クラウドプロバイダー認証105 クラウドプロバイダー認証

106</h3>106</h3>

107 107 

108Amazon Bedrock、Google Vertex AI、または Microsoft Foundry を使用するチームの場合。108Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を使用するチームの場合。

109 109 

110<Steps>110<Steps>

111 <Step title="プロバイダーセットアップに従う">111 <Step title="プロバイダーセットアップに従う">

112 [Bedrock ドキュメント](/ja/amazon-bedrock)、[Vertex ドキュメント](/ja/google-vertex-ai)、または [Microsoft Foundry ドキュメント](/ja/microsoft-foundry)に従ってください。112 [Amazon Bedrock ドキュメント](/ja/amazon-bedrock)、[Google Cloud の Agent Platform ドキュメント](/ja/google-vertex-ai)、または [Microsoft Foundry ドキュメント](/ja/microsoft-foundry)に従ってください。

113 </Step>113 </Step>

114 114 

115 <Step title="設定を配布">115 <Step title="設定を配布">


140 140 

141`apiKeyHelper`、`ANTHROPIC_API_KEY`、および `ANTHROPIC_AUTH_TOKEN` は CLI およびそれをラップするサーフェス(VS Code 拡張機能、Agent SDK、GitHub Actions を含む)に適用されます。Claude Desktop とクラウドセッションは `apiKeyHelper` を呼び出したり、これらの環境変数を読み込んだりしません。OAuth を使用します。ただし、[組織配布のサードパーティ推論設定](/ja/llm-gateway-connect#desktop-app)を実行しているデスクトップセッションは、その設定の認証情報で認証します。141`apiKeyHelper`、`ANTHROPIC_API_KEY`、および `ANTHROPIC_AUTH_TOKEN` は CLI およびそれをラップするサーフェス(VS Code 拡張機能、Agent SDK、GitHub Actions を含む)に適用されます。Claude Desktop とクラウドセッションは `apiKeyHelper` を呼び出したり、これらの環境変数を読み込んだりしません。OAuth を使用します。ただし、[組織配布のサードパーティ推論設定](/ja/llm-gateway-connect#desktop-app)を実行しているデスクトップセッションは、その設定の認証情報で認証します。

142 142 

143<h3 id="renew-an-expiring-login">

144 期限切れ間近のログインを更新する

145</h3>

146 

147`/login` で作成したログインが期限切れまで 5 日以内になると、Claude Code はスタートアップ時に警告を表示します。`Your login expires in 3 days · run /login to renew`。Claude Code v2.1.203 以降が必要です。

148 

149`/login` を実行して更新します。警告は情報提供のみであり、リクエストをブロックすることはありません。ログインが実際に期限切れになるまで認証は機能し続けます。ログインの有効期間自体は変わりません。事前警告は v2.1.203 が追加するものです。

150 

151警告は claude.ai または Claude Console ログインがアクティブな認証情報である場合にのみ表示され、クラウドプロバイダー、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` が認証情報を提供する場合には表示されません。

152 

153更新を早期に行うことは、無人で実行されるセッションにとって最も重要です。[agent view のバックグラウンドセッション](/ja/agent-view)または [Remote Control](/ja/remote-control) セッションがログインより長く実行される場合、認証情報が期限切れになると進行が停止し、再度サインインするまで復旧できません。

154 

143<h3 id="authentication-precedence">155<h3 id="authentication-precedence">

144 認証の優先順位156 認証の優先順位

145</h3>157</h3>


1535. `CLAUDE_CODE_OAUTH_TOKEN` 環境変数。[`claude setup-token`](#generate-a-long-lived-token) によって生成された長期 OAuth トークン。ブラウザログインが利用できない CI パイプラインとスクリプトに使用します。1655. `CLAUDE_CODE_OAUTH_TOKEN` 環境変数。[`claude setup-token`](#generate-a-long-lived-token) によって生成された長期 OAuth トークン。ブラウザログインが利用できない CI パイプラインとスクリプトに使用します。

1546. `/login` からのサブスクリプション OAuth 認証情報。これは Claude Pro、Max、Team、および Enterprise ユーザーのデフォルトです。1666. `/login` からのサブスクリプション OAuth 認証情報。これは Claude Pro、Max、Team、および Enterprise ユーザーのデフォルトです。

155 167 

156署名済みの [Claude apps gateway](/ja/claude-apps-gateway) セッションはこのリストの外に位置します。これは Bedrock または Vertex のようなプロバイダー選択であり、それらより優先されます。ゲートウェイセッションが存在する場合、CLI は `CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_VERTEX`、または `CLAUDE_CODE_USE_FOUNDRY` が設定されていても、ゲートウェイトークンで認証され、上記のベアラートークン、API キー、および `apiKeyHelper` エントリは使用されません。168署名済みの [Claude apps gateway](/ja/claude-apps-gateway) セッションはこのリストの外に位置します。これは Amazon Bedrock または Google Cloud の Agent Platform のようなプロバイダー選択であり、それらより優先されます。ゲートウェイセッションが存在する場合、CLI は `CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_VERTEX`、または `CLAUDE_CODE_USE_FOUNDRY` が設定されていても、ゲートウェイトークンで認証され、上記のベアラートークン、API キー、および `apiKeyHelper` エントリは使用されません。

157 169 

158アクティブな Claude サブスクリプションがあり、環境に `ANTHROPIC_API_KEY` も設定されている場合、API キーは承認されると優先されます。キーが無効または期限切れの組織に属している場合、これは認証エラーを引き起こす可能性があります。`unset ANTHROPIC_API_KEY` を実行してサブスクリプションにフォールバックし、`/status` をチェックしてどの方法がアクティブであるかを確認します。170アクティブな Claude サブスクリプションがあり、環境に `ANTHROPIC_API_KEY` も設定されている場合、API キーは承認されると優先されます。キーが無効または期限切れの組織に属している場合、これは認証エラーを引き起こす可能性があります。`unset ANTHROPIC_API_KEY` を実行してサブスクリプションにフォールバックし、`/status` をチェックしてどの方法がアクティブであるかを確認します。

159 171 

Details

9[オートモード](/ja/permission-modes#eliminate-prompts-with-auto-mode)を使用すると、Claude Code は各ツール呼び出しを分類器にルーティングして、不可逆的、破壊的、または環境外を対象とした操作をブロックすることで、権限プロンプトなしで実行できます。Deny ルールと explicit ask ルールは分類器の前に評価され、引き続きブロックまたはプロンプトを表示します。`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 アプリゲートウェイ](/ja/claude-apps-gateway)セッションでは、まず [`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 プランの Owner 有効化も含まれます。12 オートモードは、Anthropic API を通じてすべてのユーザーが利用できます。Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry、およびサインイン済みの[Claude アプリゲートウェイ](/ja/claude-apps-gateway)セッションでは、まず [`CLAUDE_CODE_ENABLE_AUTO_MODE`](/ja/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry) を[設定](/ja/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)する必要があります。Claude Code がアカウントでオートモードが利用不可と報告する場合は、[完全な要件](/ja/permission-modes#eliminate-prompts-with-auto-mode)を確認してください。これには、サポートされているモデルと Team および Enterprise プランの Owner 有効化も含まれます。

13</Note>13</Note>

14 14 

15デフォルトでは、分類器は作業ディレクトリと現在のリポジトリの設定されたリモートのみを信頼します。会社のソース管理組織へのプッシュやチームクラウドバケットへの書き込みなどのアクションは、`autoMode.environment` に追加するまでブロックされます。15デフォルトでは、分類器は作業ディレクトリと現在のリポジトリの設定されたリモートのみを信頼します。会社のソース管理組織へのプッシュやチームクラウドバケットへの書き込みなどのアクションは、`autoMode.environment` に追加するまでブロックされます。


60 * **Organization**60 * **Organization**

61 * **Primary use of Claude Code**:デフォルトはソフトウェア開発61 * **Primary use of Claude Code**:デフォルトはソフトウェア開発

62 * **Cloud provider(s)**62 * **Cloud provider(s)**

63 * **Repository visibility**:リポジトリはリモートホストと名前が別途示さない限り、プライベートと見なされます63 * **Repository visibility**:リポジトリはリモートホストと名前が別途示さない限り、プライベートと見なされます。{/* min-version: 2.1.200 */}または、会話内で分類器が読み込む前のトランスクリプト内の可視性チェックがそれが公開されていることを示している場合。分類器はメッセージと Claude が実行するコマンドを読み込みますが、その出力は読み込みません。そのため、証拠はリポジトリを公開として指定するあなた自身のメッセージなど、読み込める何かである必要があります。`gh repo view` の出力だけではそこに到達しません。トランスクリプト証拠チェックには Claude Code v2.1.200 以降が必要です

64 * **Internal sharing / snippet hosting**:パブリックペーストおよび gist サービスは、指定するまで信頼境界の外側として扱われます64 * **Internal sharing / snippet hosting**:パブリックペーストおよび gist サービスは、指定するまで信頼境界の外側として扱われます

65 * **Org-specific CLIs**65 * **Org-specific CLIs**

66 * **Secrets management**66 * **Secrets management**


69 * **Network posture**69 * **Network posture**

70 * **Protected deployment namespaces / environments**:指定するまで、機密リモートターゲットヒューリスティックにフォールバックします70 * **Protected deployment namespaces / environments**:指定するまで、機密リモートターゲットヒューリスティックにフォールバックします

71 * **Data retention / declassification**71 * **Data retention / declassification**

72* **信頼スロット**:分類器が境界内として扱うものを指定します。スロットは「信頼できるリポジトリ」、「ソース管理」、「信頼できる内部ドメイン」、「信頼できるクラウドバケット」、「主要な内部サービス」、および「内部パッケージレジストリ」です。リポジトリとソース管理エントリはデフォルトで作業リポジトリとその設定されたリモートになります。他のすべての信頼スロットはデフォルトで `None configured` になるため、追加するまで他には何も信頼されません。72* **信頼スロット**:分類器が境界内として扱うものを指定します。スロットは「信頼できるリポジトリ」、「ソース管理」、「信頼できる内部ドメイン」、「信頼できるクラウドバケット」、「主要な内部サービス」、および「内部パッケージレジストリ」です。リポジトリとソース管理エントリはデフォルトで作業リポジトリとその設定されたリモートになります。他のすべての信頼スロットはデフォルトで `None configured` になるため、追加するまで他には何も信頼されません。{/* min-version: 2.1.203 */}リポジトリの可視性は機密情報のみをスコープします。プライベートリポジトリは機密情報の許容可能な宛先ですが、リポジトリをプライベートにしても、秘密、個人データ、または信頼されたデータをそこにクリアすることはなく、分類器は、作業リポジトリの外から移植、再ポイント、または最初に読み込まれたコンテンツを、そのリポジトリ自体の作業として扱いません。このスコープには Claude Code v2.1.203 以降が必要です。

73* **感度スロット**:保護ルールが高リスクとして扱うものを指定します。スロットは「機密データの場所とオーディエンス」、「機密リモートターゲット」、および「保護された IaC スコープ」です。各スロットはデフォルトで広いヒューリスティックになります。例えば、名前に `prod` または `production` を含むホストまたはネームスペースを機密リモートターゲットとして扱うため、保護ルールは何も設定する前にアクティブになります。感度スロットで具体的なターゲットを指定すると、これらのルールはヒューリスティックではなく指定されたターゲットに適用されます。73* **感度スロット**:保護ルールが高リスクとして扱うものを指定します。スロットは「機密データの場所とオーディエンス」、「機密リモートターゲット」、および「保護された IaC スコープ」です。各スロットはデフォルトで広いヒューリスティックになります。例えば、名前に `prod` または `production` を含むホストまたはネームスペースを機密リモートターゲットとして扱うため、保護ルールは何も設定する前にアクティブになります。感度スロットで具体的なターゲットを指定すると、これらのルールはヒューリスティックではなく指定されたターゲットに適用されます。

74 74 

75デフォルトと一緒に独自のエントリを追加するには、配列にリテラル文字列 `"$defaults"` を含めます。デフォルトエントリはその位置に挿入されるため、カスタムエントリはそれらの前後に配置できます。75デフォルトと一緒に独自のエントリを追加するには、配列にリテラル文字列 `"$defaults"` を含めます。デフォルトエントリはその位置に挿入されるため、カスタムエントリはそれらの前後に配置できます。


98* **信頼できる内部ドメイン**:ネットワーク内の API、ダッシュボード、サービスのホスト名(`*.internal.example.com` など)98* **信頼できる内部ドメイン**:ネットワーク内の API、ダッシュボード、サービスのホスト名(`*.internal.example.com` など)

99* **主要な内部サービス**:CI、アーティファクトレジストリ、内部パッケージインデックス、インシデント対応ツール99* **主要な内部サービス**:CI、アーティファクトレジストリ、内部パッケージインデックス、インシデント対応ツール

100* **内部パッケージレジストリ**:インストールがルーティングされるべき private npm、PyPI、またはその他のレジストリ。パブリックレジストリをバイパスするインストールはブロックされます100* **内部パッケージレジストリ**:インストールがルーティングされるべき private npm、PyPI、またはその他のレジストリ。パブリックレジストリをバイパスするインストールはブロックされます

101* **Sensitive data locations & audiences**:個人データ、機密ビジネスデータ、認証情報、規制対象データ、または同様に機密性の高い情報を保持するバケット、データベース、またはパス。各場所のデータが共有される可能性があるオーディエンス。分類器がコンテンツから推測する代わりにこれらの場所を保護します。{/* min-version: 2.1.195 */}{/* max-version: 2.1.197 */}Claude Code v2.1.195 から v2.1.197 はこのエントリを PII / 規制対象データの場所として指定し、オーディエンスディメンションなしで個人データまたは規制対象データを保持する場所のみをカバーします101* **機密データの場所とオーディエンス**:個人データ、機密ビジネスデータ、認証情報、規制対象データ、または同様に機密性の高い情報を保持するバケット、データベース、またはパス。各場所のデータが共有される可能性があるオーディエンス。分類器がコンテンツから推測する代わりにこれらの場所を保護します。{/* min-version: 2.1.195 */}{/* max-version: 2.1.197 */}Claude Code v2.1.195 から v2.1.197 はこのエントリを PII / 規制対象データの場所として指定し、オーディエンスディメンションなしで個人データまたは規制対象データを保持する場所のみをカバーします

102* **機密リモートターゲット**:本番環境としてカウントされるネームスペース、ホスト、またはコンテナ。リモートシェルとポートフォワードはこれらへの明示的な承認が必要です102* **機密リモートターゲット**:本番環境としてカウントされるネームスペース、ホスト、またはコンテナ。リモートシェルとポートフォワードはこれらへの明示的な承認が必要です

103* **保護された IaC スコープ**:apply または destroy が常にあなたが変更を指定する必要があるインフラストラクチャリソース103* **保護された IaC スコープ**:apply または destroy が常にあなたが変更を指定する必要があるインフラストラクチャリソース

104* **追加コンテキスト**:規制業界の制約、マルチテナントインフラストラクチャ、または分類器がリスクとして扱うべき内容に影響するコンプライアンス要件104* **追加コンテキスト**:規制業界の制約、マルチテナントインフラストラクチャ、または分類器がリスクとして扱うべき内容に影響するコンプライアンス要件

channels.md +1 −1

Details

7> チャネルを使用して、MCP サーバーから実行中の Claude Code セッションにメッセージ、アラート、ウェブフックをプッシュします。CI 結果、チャットメッセージ、監視イベントを転送して、あなたが不在の間に Claude が対応できるようにします。7> チャネルを使用して、MCP サーバーから実行中の Claude Code セッションにメッセージ、アラート、ウェブフックをプッシュします。CI 結果、チャットメッセージ、監視イベントを転送して、あなたが不在の間に Claude が対応できるようにします。

8 8 

9<Note>9<Note>

10 チャネルは[リサーチプレビュー](#research-preview)段階にあり、Claude Code v2.1.80 以降が必要です。Anthropic 認証が claude.ai または Console API キーを通じて必要で、Amazon Bedrock、Google Vertex AI、Microsoft Foundry では利用できません。Team および Enterprise 組織は[明示的に有効にする](#enterprise-controls)必要があります。10 チャネルは[リサーチプレビュー](#research-preview)段階にあり、Claude Code v2.1.80 以降が必要です。Anthropic 認証が claude.ai または Console API キーを通じて必要で、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では利用できません。Team および Enterprise 組織は[明示的に有効にする](#enterprise-controls)必要があります。

11</Note>11</Note>

12 12 

13チャネルは MCP サーバーで、実行中の Claude Code セッションにイベントをプッシュするため、あなたがターミナルにいない間に起こることに Claude が対応できます。チャネルは双方向にすることができます。Claude がイベントを読み取り、同じチャネルを通じて返信します。チャットブリッジのようなものです。イベントはセッションが開いている間だけ到着するため、常時稼働セットアップの場合は、Claude をバックグラウンドプロセスまたは永続的なターミナルで実行します。13チャネルは MCP サーバーで、実行中の Claude Code セッションにイベントをプッシュするため、あなたがターミナルにいない間に起こることに Claude が対応できます。チャネルは双方向にすることができます。Claude がイベントを読み取り、同じチャネルを通じて返信します。チャットブリッジのようなものです。イベントはセッションが開いている間だけ到着するため、常時稼働セットアップの場合は、Claude をバックグラウンドプロセスまたは永続的なターミナルで実行します。

Details

36* **チャットプラットフォーム**(Telegram、Discord):プラグインはローカルで実行され、プラットフォームの API をポーリングして新しいメッセージを取得します。誰かがボットに DM を送信すると、プラグインはメッセージを受け取り、Claude に転送します。公開する URL は不要です。36* **チャットプラットフォーム**(Telegram、Discord):プラグインはローカルで実行され、プラットフォームの API をポーリングして新しいメッセージを取得します。誰かがボットに DM を送信すると、プラグインはメッセージを受け取り、Claude に転送します。公開する URL は不要です。

37* **Webhook**(CI、監視):サーバーはローカル HTTP ポートでリッスンします。外部システムがそのポートに POST し、サーバーはペイロードを Claude にプッシュします。37* **Webhook**(CI、監視):サーバーはローカル HTTP ポートでリッスンします。外部システムがそのポートに POST し、サーバーはペイロードを Claude にプッシュします。

38 38 

39<img src="https://mintlify.s3.us-west-1.amazonaws.com/claude-code/ja/images/channel-architecture.svg" alt="外部システムがローカルチャネルサーバーに接続し、stdio 経由で Claude Code と通信するアーキテクチャ図" />39<img src="https://mintcdn.com/claude-code/9FG0ZKj9uKYiHmbi/images/channel-architecture.svg?fit=max&auto=format&n=9FG0ZKj9uKYiHmbi&q=85&s=9a037b7da80184ae49015c0256b21a1f" alt="外部システムがローカルチャネルサーバーに接続し、stdio 経由で Claude Code と通信するアーキテクチャ図" width="600" height="220" data-path="images/channel-architecture.svg" />

40 40 

41<h2 id="what-you-need">41<h2 id="what-you-need">

42 必要なもの42 必要なもの


474 474 

475ローカルターミナルダイアログはこのすべてを通じて開いたままです。ターミナルの誰かがリモート判定が到着する前に答えた場合、その答えが代わりに適用され、保留中のリモートリクエストはドロップされます。475ローカルターミナルダイアログはこのすべてを通じて開いたままです。ターミナルの誰かがリモート判定が到着する前に答えた場合、その答えが代わりに適用され、保留中のリモートリクエストはドロップされます。

476 476 

477<img src="https://mintlify.s3.us-west-1.amazonaws.com/claude-code/ja/images/channel-permission-relay.svg" alt="シーケンス図:Claude Code は権限リクエスト通知をチャネルサーバーに送信し、サーバーはプロンプトと ID をチャットアプリにフォーマットして送信し、人間は判定で返信し、サーバーはその返信を権限通知に解析して Claude Code に戻す" />477<img src="https://mintcdn.com/claude-code/9FG0ZKj9uKYiHmbi/images/channel-permission-relay.svg?fit=max&auto=format&n=9FG0ZKj9uKYiHmbi&q=85&s=97d57f128f0da55f105ab1e3a7e10240" alt="シーケンス図:Claude Code は権限リクエスト通知をチャネルサーバーに送信し、サーバーはプロンプトと ID をチャットアプリにフォーマットして送信し、人間は判定で返信し、サーバーはその返信を権限通知に解析して Claude Code に戻す" width="600" height="230" data-path="images/channel-permission-relay.svg" />

478 478 

479<h3 id="permission-request-fields">479<h3 id="permission-request-fields">

480 権限リクエストフィールド480 権限リクエストフィールド

chrome.md +1 −1

Details

40* 直接 Anthropic プラン(Pro、Max、Team、または Enterprise)40* 直接 Anthropic プラン(Pro、Max、Team、または Enterprise)

41 41 

42<Note>42<Note>

43 Chrome 統合は Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry などのサードパーティプロバイダーを通じては利用できません。Claude にサードパーティプロバイダーを通じてのみアクセスする場合、この機能を使用するには別の claude.ai アカウントが必要です。43 Chrome 統合は Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry などのサードパーティプロバイダーを通じては利用できません。Claude にサードパーティプロバイダーを通じてのみアクセスする場合、この機能を使用するには別の claude.ai アカウントが必要です。

44</Note>44</Note>

45 45 

46<h2 id="get-started-in-the-cli">46<h2 id="get-started-in-the-cli">

Details

4 4 

5# Claude apps gateway 設定5# Claude apps gateway 設定

6 6 

7> gateway.yaml のすべてのオプションのリファレンス:リスナーと TLS、OIDC、セッション、Postgres ストア、Bedrock/Claude Platform on AWS/Agent Platform/Foundry アップストリーム、モデルルーティング、マネージドポリシー、テレメトリー。7> gateway.yaml のすべてのオプションのリファレンス:リスナーと TLS、OIDC、セッション、Postgres ストア、Amazon BedrockClaude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry アップストリーム、モデルルーティング、マネージドポリシー、テレメトリー。

8 8 

9Claude apps gateway デプロイメントは、慣例的に `gateway.yaml` という 1 つの YAML ファイルで設定されます。このファイルは、ゲートウェイが行うすべてのことを定義します:どこでリッスンするか、開発者がどのようにサインインするか、推論がどこに行くか、どのポリシーとテレメトリーが適用されるかです。このページは、そのファイル内のすべてのオプションのリファレンスです。最初のファイルを作成するには、[クイックスタート](/ja/claude-apps-gateway#quickstart)から始めてください。これは最小限の動作設定を構築して実行します。設定に満足したら、[デプロイメントガイド](/ja/claude-apps-gateway-deploy)で、Kubernetes、Cloud Run、または独自のプラットフォームでのコンテナ化とホスティングについて説明しています。9Claude apps gateway デプロイメントは、慣例的に `gateway.yaml` という 1 つの YAML ファイルで設定されます。このファイルは、ゲートウェイが行うすべてのことを定義します:どこでリッスンするか、開発者がどのようにサインインするか、推論がどこに行くか、どのポリシーとテレメトリーが適用されるかです。このページは、そのファイル内のすべてのオプションのリファレンスです。最初のファイルを作成するには、[クイックスタート](/ja/claude-apps-gateway#quickstart)から始めてください。これは最小限の動作設定を構築して実行します。設定に満足したら、[デプロイメントガイド](/ja/claude-apps-gateway-deploy)で、Kubernetes、Cloud Run、または独自のプラットフォームでのコンテナ化とホスティングについて説明しています。

10 10 


24* [`oidc`](#oidc):ID プロバイダー(IdP)、発行者、クライアント、クレームマッピング、サインイン可能なユーザーを含む24* [`oidc`](#oidc):ID プロバイダー(IdP)、発行者、クライアント、クレームマッピング、サインイン可能なユーザーを含む

25* [`session`](#session):ゲートウェイが発行するベアラートークン、シークレット、有効期間25* [`session`](#session):ゲートウェイが発行するベアラートークン、シークレット、有効期間

26* [`store`](#store):デバイスグラント、レート制限カウンターの PostgreSQL26* [`store`](#store):デバイスグラント、レート制限カウンターの PostgreSQL

27* [`upstreams`](#upstreams):推論がどこに行くか、Anthropic、Bedrock、Claude Platform on AWS、Agent Platform、または Foundry かどうか27* [`upstreams`](#upstreams):推論がどこに行くか、Anthropic、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、または Microsoft Foundry かどうか

28 28 

29**オプションセクション:**29**オプションセクション:**

30 30 


129 129 

130同じプロバイダーの複数のアップストリームは、異なる `name:` を設定する必要があります。130同じプロバイダーの複数のアップストリームは、異なる `name:` を設定する必要があります。

131 131 

132Bedrock、Claude Platform on AWS、Agent Platform、Foundry クライアントはスタートアップ時に 1 回構築され、SDK は内部的に認証情報をリフレッシュするため、クラウド認証情報のローテーションは再起動を必要としません。静的 Anthropic API キーとベアラーはスタートアップ時に読み込まれます。[Anthropic API](#anthropic-api) を参照してください。132Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry クライアントはスタートアップ時に 1 回構築され、SDK は内部的に認証情報をリフレッシュするため、クラウド認証情報のローテーションは再起動を必要としません。静的 Anthropic API キーとベアラーはスタートアップ時に読み込まれます。[Anthropic API](#anthropic-api)を参照してください。

133 133 

134<h4 id="anthropic-api">134<h4 id="anthropic-api">

135 Anthropic API135 Anthropic API


169 Amazon Bedrock169 Amazon Bedrock

170</h4>170</h4>

171 171 

172ゲートウェイが置き換えるまたはフロントする、クライアント側の Bedrock デプロイメントについては、[Amazon Bedrock の Claude Code](/ja/amazon-bedrock) を参照してください。ゲートウェイ側のアップストリーム:172ゲートウェイが置き換えるまたはフロントする、クライアント側の Amazon Bedrock デプロイメントについては、[Amazon Bedrock の Claude Code](/ja/amazon-bedrock)を参照してください。ゲートウェイ側のアップストリーム:

173 173 

174```yaml theme={null}174```yaml theme={null}

175upstreams:175upstreams:


270 Microsoft Foundry270 Microsoft Foundry

271</h4>271</h4>

272 272 

273クライアント側の Foundry デプロイメントについては、[Microsoft Foundry の Claude Code](/ja/microsoft-foundry) を参照してください。ゲートウェイ側のアップストリーム:273クライアント側の Foundry デプロイメントについては、[Microsoft Foundry の Claude Code](/ja/microsoft-foundry)を参照してください。ゲートウェイ側のアップストリーム:

274 274 

275```yaml theme={null}275```yaml theme={null}

276upstreams:276upstreams:


287| セットアップ | 方法 |287| セットアップ | 方法 |

288| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |288| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |

289| RBAC | ゲートウェイのアイデンティティに `Azure AI User` または `Cognitive Services User` を Foundry リソースに付与 |289| RBAC | ゲートウェイのアイデンティティに `Azure AI User` または `Cognitive Services User` を Foundry リソースに付与 |

290| デプロイメント | Foundry は正規モデル ID ではなく、管理者が選択したデプロイメント名を使用します。各正規 ID をデプロイメント名にマップする [`models:`](#models) ブロックを追加します。 |290| デプロイメント | Foundry は正規モデル ID ではなく、管理者が選択したデプロイメント名を使用します。各正規 ID をデプロイメント名にマップする [`models:`](#models)ブロックを追加します。 |

291| AKS(ワークロードアイデンティティ) | User-Assigned Managed Identity をクラスターの OIDC 発行者とフェデレーションし、ゲートウェイのサービスアカウントにバインドします。`use_azure_ad: true` は `WorkloadIdentityCredential` を通じてそれを取得します。 |291| AKS(ワークロードアイデンティティ) | User-Assigned Managed Identity をクラスターの OIDC 発行者とフェデレーションし、ゲートウェイのサービスアカウントにバインドします。`use_azure_ad: true` は `WorkloadIdentityCredential` を通じてそれを取得します。 |

292| ACI / App Service | リソースでシステム割り当てまたはユーザー割り当てマネージドアイデンティティを有効にします。`use_azure_ad: true` がそれを取得します。 |292| ACI / App Service | リソースでシステム割り当てまたはユーザー割り当てマネージドアイデンティティを有効にします。`use_azure_ad: true` がそれを取得します。 |

293| その他の場所 | `auth: { api_key: "${FOUNDRY_API_KEY}" }`。`{ }` 内の `${…}` をクォートします。 |293| その他の場所 | `auth: { api_key: "${FOUNDRY_API_KEY}" }`。`{ }` 内の `${…}` をクォートします。 |


302 302 

303`429` はアップストリーム容量ごとです。プロビジョニングスループット(PT)枯渇はオンデマンドにフェイルオーバーします。`404` はアップストリームモデル可用性ごとです。モデルを有効にしていないアップストリームは、後のアップストリームがそれを提供するのをブロックしません。要求されたモデルを解決できないアップストリームはネットワークラウンドトリップなしでスキップされます。303`429` はアップストリーム容量ごとです。プロビジョニングスループット(PT)枯渇はオンデマンドにフェイルオーバーします。`404` はアップストリームモデル可用性ごとです。モデルを有効にしていないアップストリームは、後のアップストリームがそれを提供するのをブロックしません。要求されたモデルを解決できないアップストリームはネットワークラウンドトリップなしでスキップされます。

304 304 

305この例は、プロビジョニングスループット Bedrock 割り当てを最初にルーティングし、オンデマンドと 2 番目のアカウントにオーバーフロー、最後に Anthropic API にフォールバックします:305この例は、プロビジョニングスループット Amazon Bedrock 割り当てを最初にルーティングし、オンデマンドと 2 番目のアカウントにオーバーフロー、最後に Anthropic API にフォールバックします:

306 306 

307```yaml theme={null}307```yaml theme={null}

308upstreams:308upstreams:


341```341```

342 342 

343| レバー | 方法 |343| レバー | 方法 |

344| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |344| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

345| 異なるリージョン | リージョンごとに 1 つの Bedrock アップストリーム。それぞれ独自の `region:` を持ちます。[`auto_include_builtin_models: true`](#models) を使用すると、クロスリージョン推論プロファイルは自動的にルーティングされます。リージョンピンデプロイメントの場合、`models:` ブロックを使用します。 |345| 異なるリージョン | リージョンごとに 1 つの Amazon Bedrock アップストリーム。それぞれ独自の `region:` を持ちます。[`auto_include_builtin_models: true`](#models)を使用すると、クロスリージョン推論プロファイルは自動的にルーティングされます。リージョンピンデプロイメントの場合、`models:` ブロックを使用します。 |

346| 異なるアカウント | アカウントごとに 1 つの Bedrock アップストリーム。それぞれ `auth:` で独自の認証情報を持ちます。デフォルトチェーン(`auth: {}`)はポッドのアイデンティティを使用します。2 番目のアカウントの場合、明示的な認証情報またはベアラートークンを設定します。 |346| 異なるアカウント | アカウントごとに 1 つの Amazon Bedrock アップストリーム。それぞれ `auth:` で独自の認証情報を持ちます。デフォルトチェーン(`auth: {}`)はポッドのアイデンティティを使用します。2 番目のアカウントの場合、明示的な認証情報またはベアラートークンを設定します。 |

347| プロビジョニングスループット | そのアップストリームの名前の `models:` でプロビジョニングスループット ARN にモデルをマップします。他のアップストリームはオンデマンド ID を保持するため、PT 容量はフェイルオーバー前に枯渇します。 |347| プロビジョニングスループット | そのアップストリームの名前の `models:` でプロビジョニングスループット ARN にモデルをマップします。他のアップストリームはオンデマンド ID を保持するため、PT 容量はフェイルオーバー前に枯渇します。 |

348| VPC / FIPS エンドポイント | アップストリームで `base_url:` を VPC エンドポイントまたは FIPS エンドポイント URL に設定します。 |348| VPC / FIPS エンドポイント | アップストリームで `base_url:` を VPC エンドポイントまたは FIPS エンドポイント URL に設定します。 |

349| モデルスコープルーティング | モデルの `upstream_model:` マップからアップストリームを省略し、そのアップストリームはそのモデルでスキップされます。例えば、Opus をプロビジョニングスループットにルーティングし、Sonnet と Haiku をオンデマンドにルーティングします。 |349| モデルスコープルーティング | モデルの `upstream_model:` マップからアップストリームを省略し、そのアップストリームはそのモデルでスキップされます。例えば、Opus をプロビジョニングスループットにルーティングし、Sonnet と Haiku をオンデマンドにルーティングします。 |


403 `models`403 `models`

404</h3>404</h3>

405 405 

406`models` ブロックはオプションの管理者がキュレーションしたモデルリストで、`/v1/models` で提供され、アップストリームごとのモデル ID を変換するために使用されます。US 以外の Bedrock リージョン、Bedrock プロビジョニングスループット ARN、Foundry デプロイメント名に必須です。406`models` ブロックはオプションの管理者がキュレーションしたモデルリストで、`/v1/models` で提供され、アップストリームごとのモデル ID を変換するために使用されます。US 以外の Amazon Bedrock リージョン、Amazon Bedrock プロビジョニングスループット ARN、Microsoft Foundry デプロイメント名に必須です。

407 407 

408```yaml theme={null}408```yaml theme={null}

409auto_include_builtin_models: true # false:以下のリストのみを公開409auto_include_builtin_models: true # false:以下のリストのみを公開

Details

283| ブートは Postgres パーミッションエラーで終了 | アプリロールに `CREATE TABLE` がない | 管理ロールでスキーマを事前作成し、アプリロールに DML を付与するか、新しいマイグレーションを適用するブートのために DDL を一時的に付与します |283| ブートは Postgres パーミッションエラーで終了 | アプリロールに `CREATE TABLE` がない | 管理ロールでスキーマを事前作成し、アプリロールに DML を付与するか、新しいマイグレーションを適用するブートのために DDL を一時的に付与します |

284| `/oauth/callback` は「Sign-in could not be completed」を表示 | メールドメインが拒否されました。id\_token 検証が失敗しました。または `email_verified` が明示的に `false` です。ゲートウェイは常にオーバーライドなしで拒否します | `allowed_email_domains` を確認し、IdP が検証済み `email` クレームを返すことを確認します。`email_verified: false` の場合は、IdP 側の検証を修正します。IdP がメールを別のクレーム名の下で発行する場合は、`oidc.email_claim` を設定します。 |284| `/oauth/callback` は「Sign-in could not be completed」を表示 | メールドメインが拒否されました。id\_token 検証が失敗しました。または `email_verified` が明示的に `false` です。ゲートウェイは常にオーバーライドなしで拒否します | `allowed_email_domains` を確認し、IdP が検証済み `email` クレームを返すことを確認します。`email_verified: false` の場合は、IdP 側の検証を修正します。IdP がメールを別のクレーム名の下で発行する場合は、`oidc.email_claim` を設定します。 |

285| ログ:`token exchange failed: id_token missing email claim` | IdP はデフォルトで id\_token に `email` を含めていません。この拒否は `allowed_email_domains` が設定されている場合にのみ発火します。なしでは、欠落したメールはメールなしでセッションをミントします | IdP を設定して id\_token で `email` を発行します。Okta:カスタム認可サーバーの ID トークンクレームに `email` を追加します。Entra:アプリ登録でオプションクレームとして `email` を追加します。PingFederate:`email` を発行する OpenID Connect ポリシーを有効にします。IdP が userinfo エンドポイントから `email` を提供するが、id\_token に含めない場合(Okta org 認可サーバーなど)、`oidc.userinfo_fallback: true` を設定します。 |285| ログ:`token exchange failed: id_token missing email claim` | IdP はデフォルトで id\_token に `email` を含めていません。この拒否は `allowed_email_domains` が設定されている場合にのみ発火します。なしでは、欠落したメールはメールなしでセッションをミントします | IdP を設定して id\_token で `email` を発行します。Okta:カスタム認可サーバーの ID トークンクレームに `email` を追加します。Entra:アプリ登録でオプションクレームとして `email` を追加します。PingFederate:`email` を発行する OpenID Connect ポリシーを有効にします。IdP が userinfo エンドポイントから `email` を提供するが、id\_token に含めない場合(Okta org 認可サーバーなど)、`oidc.userinfo_fallback: true` を設定します。 |

286| すべての Bedrock リクエストは 502 を返します。ログは `Could not load credentials from any providers` を表示 | EC2 では、IMDSv2 のデフォルトホップリミット 1 がコンテナ内からのインスタンスメタデータリクエストをブロックします。ブートと `/readyz` はクライアント構築時ではなく最初のリクエストで AWS SDK がインスタンス認証情報を解決するため、とにかく合格します | `aws ec2 modify-instance-metadata-options --instance-id <id> --http-put-response-hop-limit 2` でホップリミットを上げるか、起動テンプレートで設定します。変更はインスタンス上のすべてのコンテナに適用されます。利用可能な場合は ECS タスクロールを優先します。ECS コンテナ認証情報エンドポイントから認証情報を読み込み、変更を完全に回避するか、専用ゲートウェイインスタンスで変更を適用して露出を制限します。 |286| すべての Amazon Bedrock リクエストは 502 を返します。ログは `Could not load credentials from any providers` を表示 | EC2 では、IMDSv2 のデフォルトホップリミット 1 がコンテナ内からのインスタンスメタデータリクエストをブロックします。ブートと `/readyz` はクライアント構築時ではなく最初のリクエストで AWS SDK がインスタンス認証情報を解決するため、とにかく合格します | `aws ec2 modify-instance-metadata-options --instance-id <id> --http-put-response-hop-limit 2` でホップリミットを上げるか、起動テンプレートで設定します。変更はインスタンス上のすべてのコンテナに適用されます。利用可能な場合は ECS タスクロールを優先します。ECS コンテナ認証情報エンドポイントから認証情報を読み込み、変更を完全に回避するか、専用ゲートウェイインスタンスで変更を適用して露出を制限します。 |

287| IdP エラー:unknown or unsupported scope | IdP は認識しないスコープを拒否します | `oidc.scopes` を IdP が受け入れる正確なリストに設定します。`openid` を含める必要があります。デフォルトは `openid profile email offline_access` です。 |287| IdP エラー:unknown or unsupported scope | IdP は認識しないスコープを拒否します | `oidc.scopes` を IdP が受け入れる正確なリストに設定します。`openid` を含める必要があります。デフォルトは `openid profile email offline_access` です。 |

288| `oidc.scopes` を設定した後、セッションはサイレントに更新されません | `offline_access` がオーバーライドからドロップされました | IdP がサポートしている場合は `offline_access` を戻します。リフレッシュトークンなしでは、開発者は `session.ttl_hours` ごとにブラウザログインを再実行します。 |288| `oidc.scopes` を設定した後、セッションはサイレントに更新されません | `offline_access` がオーバーライドからドロップされました | IdP がサポートしている場合は `offline_access` を戻します。リフレッシュトークンなしでは、開発者は `session.ttl_hours` ごとにブラウザログインを再実行します。 |

289| ブラウザは「This request came from another site and was blocked」を表示 | クロスサイトフォーム POST。CSRF 保護としてブロックされました。埋め込みまたはプロキシされたページの場合は予想されます | 検証リンクを直接開きます |289| ブラウザは「This request came from another site and was blocked」を表示 | クロスサイトフォーム POST。CSRF 保護としてブロックされました。埋め込みまたはプロキシされたページの場合は予想されます | 検証リンクを直接開きます |

Details

61 61 

62各レスポンスの後、使用量メーターはレスポンスからトークンカウントを読み取り、クライアントにストリーミングされ、USD リスト価格で価格設定され、3 つの期間バケットすべての Postgres カウンターをインクリメントします。メーターはストリーム上の単一リーダーなので、クライアントのバイトは変更されず、メーリング障害はレスポンスを破壊しません。62各レスポンスの後、使用量メーターはレスポンスからトークンカウントを読み取り、クライアントにストリーミングされ、USD リスト価格で価格設定され、3 つの期間バケットすべての Postgres カウンターをインクリメントします。メーターはストリーム上の単一リーダーなので、クライアントのバイトは変更されず、メーリング障害はレスポンスを破壊しません。

63 63 

64支出制限は USD リスト価格のトークンカウントから支出を推定します。これはサーキットブレーカーであり、請求書ではありません。権限のある請求については、Anthropic Usage & Cost Admin API、Bedrock の呼び出しログ、または Google Cloud の Cloud Monitoring など、プロバイダー独自の使用状況レポートに対して調整してください。64支出制限は USD リスト価格のトークンカウントから支出を推定します。これはサーキットブレーカーであり、請求書ではありません。権限のある請求については、Anthropic Usage & Cost Admin API、Amazon Bedrock の呼び出しログ、または Google Cloud の Cloud Monitoring など、プロバイダー独自の使用状況レポートに対して調整してください。

65 65 

66価格設定は Claude Code CLI が独自のコスト表示に使用するのと同じテーブルを使用し、Anthropic、Bedrock(`us.anthropic.…-v1:0`)、Agent Platform(`claude-…@date`)、および Foundry ID フォーム全体で同じモデル ID 正規化を使用します。テーブルが配置できないモデル ID(Foundry デプロイメント名または推論プロファイル ARN など)は、ゼロではなく、不明なモデルのデフォルトティアである 100 万入力/出力トークンあたり 5 ドル/25 ドルで価格設定されるため、認識されない ID は計測されないことで上限をバイパスできません。gateway はブート時と実行時に ID ごとに 1 回、フォールバックを通じて価格設定されるモデルについて警告します。66価格設定は Claude Code CLI が独自のコスト表示に使用するのと同じテーブルを使用し、Anthropic、Amazon Bedrock(`us.anthropic.…-v1:0`)、Google Cloud の Agent Platform(`claude-…@date`)、および Microsoft Foundry ID フォーム全体で同じモデル ID 正規化を使用します。テーブルが配置できないモデル ID(Microsoft Foundry デプロイメント名または推論プロファイル ARN など)は、ゼロではなく、不明なモデルのデフォルトティアである 100 万入力/出力トークンあたり 5 ドル/25 ドルで価格設定されるため、認識されない ID は計測されないことで上限をバイパスできません。gateway はブート時と実行時に ID ごとに 1 回、フォールバックを通じて価格設定されるモデルについて警告します。

67 67 

68クライアント中止も請求されます。アップストリームはストリームの終端フレームでのみ出力トークンを報告するため、中止されたストリームはそれらを持ちません。メーターはストリーミングされたコンテンツサイズから保守的なフロア推定値(トークンあたり約 4 文字)を保持し、終端使用量フレームが欠落している場合にのみそれを請求します。完全なストリームは常にアップストリーム報告カウントを請求します。これがない場合、上限のある開発者は出力をストリーミングし、終了直前に各リクエストを中止して、カウントされることなく支出できます。68クライアント中止も請求されます。アップストリームはストリームの終端フレームでのみ出力トークンを報告するため、中止されたストリームはそれらを持ちません。メーターはストリーミングされたコンテンツサイズから保守的なフロア推定値(トークンあたり約 4 文字)を保持し、終端使用量フレームが欠落している場合にのみそれを請求します。完全なストリームは常にアップストリーム報告カウントを請求します。これがない場合、上限のある開発者は出力をストリーミングし、終了直前に各リクエストを中止して、カウントされることなく支出できます。

69 69 

Details

4 4 

5# ウェブ上の Claude Code を使用する5# ウェブ上の Claude Code を使用する

6 6 

7> Anthropic のサンドボックスでクラウド環境、セットアップスクリプト、ネットワークアクセス、Docker を設定します。`--remote` と `--teleport` を使用してウェブとターミナル間でセッションを移動します。7> Anthropic のサンドボックスでクラウド環境、セットアップスクリプト、ネットワークアクセス、Docker を設定します。`--cloud` と `--teleport` を使用してウェブとターミナル間でセッションを移動します。

8 8 

9<Note>9<Note>

10 ウェブ上の Claude Code は Pro、Max、Team ユーザー、およびプレミアムシートまたは Chat + Claude Code シートを持つ Enterprise ユーザーを対象としたリサーチプレビュー段階です。10 ウェブ上の Claude Code は Pro、Max、Team ユーザー、およびプレミアムシートまたは Chat + Claude Code シートを持つ Enterprise ユーザーを対象としたリサーチプレビュー段階です。


22* [クラウド環境](#the-cloud-environment):どの設定が引き継がれるか、どのツールがインストールされているか、環境を設定する方法22* [クラウド環境](#the-cloud-environment):どの設定が引き継がれるか、どのツールがインストールされているか、環境を設定する方法

23* [セットアップスクリプト](#setup-scripts)と依存関係管理23* [セットアップスクリプト](#setup-scripts)と依存関係管理

24* [ネットワークアクセス](#network-access):レベル、プロキシ、デフォルト許可リスト24* [ネットワークアクセス](#network-access):レベル、プロキシ、デフォルト許可リスト

25* [`--remote` と `--teleport` を使用してウェブとターミナル間でタスクを移動](#move-tasks-between-web-and-terminal)25* [`--cloud` と `--teleport` を使用してウェブとターミナル間でタスクを移動](#move-tasks-between-web-and-terminal)

26* [セッションの操作](#work-with-sessions):確認、共有、アーカイブ、削除26* [セッションの操作](#work-with-sessions):確認、共有、アーカイブ、削除

27* [プルリクエストの自動修正](#auto-fix-pull-requests):CI 失敗とレビューコメントに自動的に応答27* [プルリクエストの自動修正](#auto-fix-pull-requests):CI 失敗とレビューコメントに自動的に応答

28* [セキュリティと分離](#security-and-isolation):セッションの分離方法28* [セキュリティと分離](#security-and-isolation):セッションの分離方法


180環境は[ネットワークアクセス](#network-access)、環境変数、セッション開始前に実行される[セットアップスクリプト](#setup-scripts)を制御します。設定なしで利用可能なものについては [Installed tools](#installed-tools) を参照してください。ウェブインターフェースまたはターミナルから環境を管理できます:180環境は[ネットワークアクセス](#network-access)、環境変数、セッション開始前に実行される[セットアップスクリプト](#setup-scripts)を制御します。設定なしで利用可能なものについては [Installed tools](#installed-tools) を参照してください。ウェブインターフェースまたはターミナルから環境を管理できます:

181 181 

182| アクション | 方法 |182| アクション | 方法 |

183| :------------------- | :--------------------------------------------------------------------------------------------------------------------- |183| :----------------------- | :------------------------------------------------------------------------------------------------------------------------ |

184| 環境を追加 | 現在の環境を選択して環境セレクターを開き、**Add environment** を選択します。ダイアログには名前、ネットワークアクセスレベル、環境変数、セットアップスクリプトが含まれます。 |184| 環境を追加 | 現在の環境を選択して環境セレクターを開き、**Add environment** を選択します。ダイアログには名前、ネットワークアクセスレベル、環境変数、セットアップスクリプトが含まれます。 |

185| 環境を編集 | クラウドアイコンを選択して現在の環境の名前を表示し、セレクターを開き、環境にマウスを合わせて、右側に表示される設定アイコンをクリックします。 |185| 環境を編集 | クラウドアイコンを選択して現在の環境の名前を表示し、セレクターを開き、環境にマウスを合わせて、右側に表示される設定アイコンをクリックします。 |

186| 環境をアーカイブ | 環境を編集用に開き、**Archive** を選択します。アーカイブされた環境はセレクターから非表示になりますが、既存のセッションは実行を続けます。 |186| 環境をアーカイブ | 環境を編集用に開き、**Archive** を選択します。アーカイブされた環境はセレクターから非表示になりますが、既存のセッションは実行を続けます。 |

187| `--remote` のデフォルトを設定 | ターミナルで `/remote-env` を実行します。単一の環境がある場合、このコマンドは現在の設定を表示します。`/remote-env` はデフォルトのみを選択します。ウェブインターフェースから環境を追加、編集、アーカイブします。 |187| CLI クラウドセッションのデフォルト環境を設定 | ターミナルで `/remote-env` を実行します。単一の環境がある場合、このコマンドは現在の設定を表示します。`/remote-env` はデフォルトのみを選択します。ウェブインターフェースから環境を追加、編集、アーカイブしてください。 |

188 188 

189環境変数は `.env` 形式を使用し、1 行に 1 つの `KEY=value` ペアです。値を引用符で囲まないでください。引用符は値の一部として保存されるためです。この例は 3 つの変数を定義しています:189環境変数は `.env` 形式を使用し、1 行に 1 つの `KEY=value` ペアです。値を引用符で囲まないでください。引用符は値の一部として保存されるためです。この例は 3 つの変数を定義しています:

190 190 


627これらのワークフローには [Claude Code CLI](/ja/quickstart) が同じ claude.ai アカウントにサインインしている必要があります。ターミナルから新しいクラウドセッションを開始するか、クラウドセッションをターミナルにプルしてローカルで続行できます。クラウドセッションはラップトップを閉じても保持され、Claude モバイルアプリを含む任意の場所から監視できます。627これらのワークフローには [Claude Code CLI](/ja/quickstart) が同じ claude.ai アカウントにサインインしている必要があります。ターミナルから新しいクラウドセッションを開始するか、クラウドセッションをターミナルにプルしてローカルで続行できます。クラウドセッションはラップトップを閉じても保持され、Claude モバイルアプリを含む任意の場所から監視できます。

628 628 

629<Note>629<Note>

630 CLI からのセッションハンドオフは一方向です:`--teleport` でクラウドセッションをターミナルにプルできますが、既存のターミナルセッションをウェブにプッシュすることはできません。`--remote` フラグは現在のリポジトリの新しいクラウドセッションを作成します。[Desktop アプリ](/ja/desktop#continue-in-another-surface)は別のサーフェスに送信できる Continue in メニューを提供します。630 CLI からのセッションハンドオフは一方向です:`--teleport` でクラウドセッションをターミナルにプルできますが、既存のターミナルセッションをウェブにプッシュすることはできません。`--cloud` フラグは現在のリポジトリの新しいクラウドセッションを作成します。[Desktop アプリ](/ja/desktop#continue-in-another-surface)は別のサーフェスに送信できる Continue in メニューを提供します。

631</Note>631</Note>

632 632 

633<h3 id="from-terminal-to-web">633<h3 id="from-terminal-to-web">

634 ターミナルからウェブへ634 ターミナルからウェブへ

635</h3>635</h3>

636 636 

637`--remote` フラグを使用してコマンドラインからクラウドセッションを開始します:637`--cloud` フラグを使用してコマンドラインからクラウドセッションを開始します:

638 638 

639```bash theme={null}639```bash theme={null}

640claude --remote "Fix the authentication bug in src/auth/login.ts"640claude --cloud "Fix the authentication bug in src/auth/login.ts"

641```641```

642 642 

643これにより claude.ai 上に新しいクラウドセッションが作成されます。セッションは現在のディレクトリの GitHub リモートを現在のブランチでクローンするため、VM は GitHub からクローンするため、ローカルコミットがある場合は最初にプッシュしてください。`--remote` は一度に 1 つのリポジトリで機能します。タスクはクラウドで実行され、ローカルで作業を続行できます。643これにより claude.ai 上に新しいクラウドセッションが作成されます。セッションは現在のディレクトリの GitHub リモートを現在のブランチでクローンするため、VM は GitHub からクローンするため、ローカルコミットがある場合は最初にプッシュしてください。`--cloud` は一度に 1 つのリポジトリで機能します。タスクはクラウドで実行され、ローカルで作業を続行できます。古い `--remote` スペルは `--cloud` の非推奨エイリアスとしてまだ機能します。

644 644 

645{/* min-version: 2.1.195 */}v2.1.195 以降、CLI はリポジトリのクローンや [セットアップスクリプト](#setup-scripts)の実行などのセットアップステップのライブチェックリストを表示し、クラウドコンテナが起動します。コンテナがプロビジョニング中に入力したメッセージはキューに入れられ、セッションの準備ができたら送信されます。645{/* min-version: 2.1.195 */}v2.1.195 以降、CLI はリポジトリのクローンや [セットアップスクリプト](#setup-scripts)の実行などのセットアップステップのライブチェックリストを表示し、クラウドコンテナが起動します。コンテナがプロビジョニング中に入力したメッセージはキューに入れられ、セッションの準備ができたら送信されます。

646 646 

647<Note>647<Note>

648 `--remote` はクラウドセッションを作成します。`--remote-control` は無関係です:ウェブから監視するためにローカル CLI セッションを公開します。[Remote Control](/ja/remote-control)を参照してください。648 `--cloud` はクラウドセッションを作成します。`--remote-control` は無関係です:ウェブから監視するためにローカル CLI セッションを公開します。[Remote Control](/ja/remote-control)を参照してください。

649</Note>649</Note>

650 650 

651Claude Code CLI で `/tasks` を使用して進捗をチェックするか、claude.ai または Claude モバイルアプリでセッションを開いて直接対話します。そこから Claude を操舵し、フィードバックを提供するか、他のすべての会話と同じように質問に答えることができます。651Claude Code CLI で `/tasks` を使用して進捗をチェックするか、claude.ai または Claude モバイルアプリでセッションを開いて直接対話します。そこから Claude を操舵し、フィードバックを提供するか、他のすべての会話と同じように質問に答えることができます。


663プランモードでは、Claude はファイルを読み取り、コマンドを実行して探索し、ソースコードを編集せずにプランを提案します。計画に満足したら、リポジトリにプランを保存し、コミットしてプッシュし、クラウド VM がそれをクローンできるようにします。その後、自律実行のためにクラウドセッションを開始します:663プランモードでは、Claude はファイルを読み取り、コマンドを実行して探索し、ソースコードを編集せずにプランを提案します。計画に満足したら、リポジトリにプランを保存し、コミットしてプッシュし、クラウド VM がそれをクローンできるようにします。その後、自律実行のためにクラウドセッションを開始します:

664 664 

665```bash theme={null}665```bash theme={null}

666claude --remote "Execute the migration plan in docs/migration-plan.md"666claude --cloud "Execute the migration plan in docs/migration-plan.md"

667```667```

668 668 

669このパターンにより、戦略を制御しながら Claude がクラウドで自律的に実行できます。669このパターンにより、戦略を制御しながら Claude がクラウドで自律的に実行できます。

670 670 

671**クラウドで ultraplan を使用してプランを作成**:ウェブセッション自体でプランを起案およびレビューするには、[ultraplan](/ja/ultraplan)を使用します。Claude はウェブ上の Claude Code でプランを生成し、作業を続行し、ブラウザでセクションにコメントし、リモートで実行するか、プランをターミナルに送り返すことを選択します。671**クラウドで ultraplan を使用してプランを作成**:ウェブセッション自体でプランを起案およびレビューするには、[ultraplan](/ja/ultraplan)を使用します。Claude はウェブ上の Claude Code でプランを生成し、作業を続行し、ブラウザでセクションにコメントし、リモートで実行するか、プランをターミナルに送り返すことを選択します。

672 672 

673**タスクを並列で実行**:各 `--remote` コマンドは独立して実行される独自のクラウドセッションを作成します。複数のタスクを開始でき、すべて別々のセッションで同時に実行されます:673**タスクを並列で実行**:各 `--cloud` コマンドは独立して実行される独自のクラウドセッションを作成します。複数のタスクを開始でき、すべて別々のセッションで同時に実行されます:

674 674 

675```bash theme={null}675```bash theme={null}

676claude --remote "Fix the flaky test in auth.spec.ts"676claude --cloud "Fix the flaky test in auth.spec.ts"

677claude --remote "Update the API documentation"677claude --cloud "Update the API documentation"

678claude --remote "Refactor the logger to use structured output"678claude --cloud "Refactor the logger to use structured output"

679```679```

680 680 

681Claude Code CLI で `/tasks` を使用してすべてのセッションを監視します。セッションが完了したら、ウェブインターフェースから PR を作成するか、[セッションをテレポート](#from-web-to-terminal)してターミナルで作業を続行できます。681Claude Code CLI で `/tasks` を使用してすべてのセッションを監視します。セッションが完了したら、ウェブインターフェースから PR を作成するか、[セッションをテレポート](#from-web-to-terminal)してターミナルで作業を続行できます。


684 GitHub なしでローカルリポジトリを送信684 GitHub なしでローカルリポジトリを送信

685</h4>685</h4>

686 686 

687GitHub に接続されていないリポジトリから `claude --remote` を実行する場合、Claude Code はローカルリポジトリをバンドルしてクラウドセッションに直接アップロードします。バンドルにはすべてのブランチ全体のリポジトリ履歴と、追跡されたファイルへのコミットされていない変更が含まれます。687GitHub に接続されていないリポジトリから `claude --cloud` を実行する場合、Claude Code はローカルリポジトリをバンドルしてクラウドセッションに直接アップロードします。バンドルにはすべてのブランチ全体のリポジトリ履歴と、追跡されたファイルへのコミットされていない変更が含まれます。

688 688 

689GitHub アクセスが利用できない場合、このフォールバックは自動的にアクティブになります。GitHub が接続されている場合でも強制するには、`CCR_FORCE_BUNDLE=1` を設定します:689GitHub アクセスが利用できない場合、このフォールバックは自動的にアクティブになります。GitHub が接続されている場合でも強制するには、`CCR_FORCE_BUNDLE=1` を設定します:

690 690 

691```bash theme={null}691```bash theme={null}

692CCR_FORCE_BUNDLE=1 claude --remote "Run the test suite and fix any failures"692CCR_FORCE_BUNDLE=1 claude --cloud "Run the test suite and fix any failures"

693```693```

694 694 

695バンドルされたリポジトリはこれらの制限を満たす必要があります:695バンドルされたリポジトリはこれらの制限を満たす必要があります:


731 `--teleport` が利用できない731 `--teleport` が利用できない

732</h4>732</h4>

733 733 

734テレポートには claude.ai サブスクリプション認証が必要です。API キー、Bedrock、Vertex AI、または Microsoft Foundry 経由で認証されている場合は、代わりに claude.ai アカウントでサインインするために `/login` を実行してください。claude.ai 経由で既にサインインしており、`--teleport` がまだ利用できない場合は、組織がクラウドセッションを無効にしている可能性があります。734テレポートには claude.ai サブスクリプション認証が必要です。API キー、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 経由で認証されている場合は、代わりに claude.ai アカウントでサインインするために `/login` を実行してください。claude.ai 経由で既にサインインしており、`--teleport` がまだ利用できない場合は、組織がクラウドセッションを無効にしている可能性があります。

735 735 

736<h2 id="work-with-sessions">736<h2 id="work-with-sessions">

737 セッションの操作737 セッションの操作


743 コンテキストを管理743 コンテキストを管理

744</h3>744</h3>

745 745 

746クラウドセッションは[組み込みコマンド](/ja/commands)をサポートしており、テキスト出力を生成します。`/model` や `/config` のようなインタラクティブターミナルピッカーを開くコマンドは利用できません746クラウドセッションは[組み込みコマンド](/ja/commands)をサポートしており、テキスト出力を生成します。ターミナルインターフェイスでのみ実行されるコマンド(`/plugin` や `/resume` など)は利用できません。{/* min-version: 2.1.205 */}}`/model`、`/effort`、`/fast`、`/color`、`/rename` はターミナルピッカーまたはスライダーを開く代わりに、引数として値を使用して機能します。例えば `/model sonnet` のように使用します。引数形式はセッションの環境で Claude Code v2.1.205 以降が必要であり、各コマンドの[利用可能性に関する注記](/ja/commands#all-commands)に従います。そのため、`/effort` はモデルの[起動デフォルト努力保持](/ja/model-config#adjust-effort-level)が有効な場合は `Not applied` を報告し、`/fast` はファストモードを有効にして開始されたセッションでのみ機能します`/config` は `key=value` を渡すときに設定を設定します。

747 747 

748コンテキスト管理の場合:748コンテキスト管理の場合:

749 749 


755 755 

756自動圧縮はコンテキストウィンドウが容量に近づくと自動的に実行されます。より早くトリガーするには、[環境変数](#configure-your-environment)で [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/ja/env-vars)を設定します。例えば、`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70` はウィンドウがほぼいっぱいになるまで待つのではなく、70% 容量で圧縮します。圧縮計算の有効なウィンドウサイズを変更するには、[`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/ja/env-vars)を使用します。756自動圧縮はコンテキストウィンドウが容量に近づくと自動的に実行されます。より早くトリガーするには、[環境変数](#configure-your-environment)で [`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/ja/env-vars)を設定します。例えば、`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70` はウィンドウがほぼいっぱいになるまで待つのではなく、70% 容量で圧縮します。圧縮計算の有効なウィンドウサイズを変更するには、[`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/ja/env-vars)を使用します。

757 757 

758[Subagents](/ja/sub-agents)はローカルと同じように機能します。Claude は Task ツールでそれらをスポーンして、研究または並列作業を別のコンテキストウィンドウにオフロードし、メイン会話を軽くすることができます。リポジトリの `.claude/agents/` で定義された Subagents は自動的にピックアップされます。[Agent teams](/ja/agent-teams)はデフォルトでオフですが、[環境変数](#configure-your-environment)に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を追加することで有効にできます。758[Subagents](/ja/sub-agents)はローカルと同じように機能します。Claude は Task ツールでそれらをスポーンして、研究または並列作業を別のコンテキストウィンドウにオフロードし、メイン会話を軽くすることができます。リポジトリの `.claude/agents/` で定義された Subagents は自動的にピックアップされます。

759 

760[Agent teams](/ja/agent-teams)はデフォルトでオフですが、[環境変数](#configure-your-environment)に `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` を追加することで有効にできます。

759 761 

760<h3 id="review-changes">762<h3 id="review-changes">

761 変更を確認763 変更を確認

Details

270 270 

271`ANTHROPIC_AWS_WORKSPACE_ID` は必須であり、すべてのリクエストで `anthropic-workspace-id` ヘッダーとして送信されます。ベース URL は `AWS_REGION` から `https://aws-external-anthropic.{region}.api.aws` として計算されます。URL を直接オーバーライドするには、`ANTHROPIC_AWS_BASE_URL` を設定します。271`ANTHROPIC_AWS_WORKSPACE_ID` は必須であり、すべてのリクエストで `anthropic-workspace-id` ヘッダーとして送信されます。ベース URL は `AWS_REGION` から `https://aws-external-anthropic.{region}.api.aws` として計算されます。URL を直接オーバーライドするには、`ANTHROPIC_AWS_BASE_URL` を設定します。

272 272 

273AWS 上の Claude Platform は、環境に AWS 認証情報が存在する場合でもオプトインです。Bedrock と Foundry はプロバイダールーティングで優先されるため、設定されている場合は `CLAUDE_CODE_USE_BEDROCK` と `CLAUDE_CODE_USE_FOUNDRY` をアンセットします。273AWS 上の Claude Platform は、環境に AWS 認証情報が存在する場合でもオプトインです。Amazon Bedrock と Microsoft Foundry はプロバイダールーティングで優先されるため、設定されている場合は `CLAUDE_CODE_USE_BEDROCK` と `CLAUDE_CODE_USE_FOUNDRY` をアンセットします。

274 274 

275<h3 id="3-pin-model-versions">275<h3 id="3-pin-model-versions">

276 3. モデルバージョンをピン留めする276 3. モデルバージョンをピン留めする

cli-reference.md +10 −7

Details

22| `claude -c -p "query"` | SDK 経由で続行 | `claude -c -p "Check for type errors"` |22| `claude -c -p "query"` | SDK 経由で続行 | `claude -c -p "Check for type errors"` |

23| `claude -r "<session>" "query"` | セッション ID または名前でセッションを再開 | `claude -r "auth-refactor" "Finish this PR"` |23| `claude -r "<session>" "query"` | セッション ID または名前でセッションを再開 | `claude -r "auth-refactor" "Finish this PR"` |

24| `claude update` | 最新バージョンに更新 | `claude update` |24| `claude update` | 最新バージョンに更新 | `claude update` |

25| `claude gateway` | 自己ホスト型 [Claude apps gateway](/ja/claude-apps-gateway) サーバーを開始します。Bedrock、Vertex AI、または Foundry 上の Claude Code の前に SSO とポリシーをデプロイする管理者向けです。`--config` で [`gateway.yaml`](/ja/claude-apps-gateway-config) を指す必要があります。Claude Code v2.1.195 以降で利用可能です。 | `claude gateway --config gateway.yaml` |25| `claude gateway` | 自己ホスト型 [Claude apps gateway](/ja/claude-apps-gateway) サーバーを開始します。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 上の Claude Code の前に SSO とポリシーをデプロイする管理者向けです。`--config` で [`gateway.yaml`](/ja/claude-apps-gateway-config) を指す必要があります。Claude Code v2.1.195 以降で利用可能です。 | `claude gateway --config gateway.yaml` |

26| `claude install [version]` | ネイティブバイナリをインストールまたは再インストールします。`2.1.118` のようなバージョン、または `stable` または `latest` を受け入れます。[特定のバージョンをインストール](/ja/setup#install-a-specific-version) を参照してください | `claude install stable` |26| `claude install [version]` | ネイティブバイナリをインストールまたは再インストールします。`2.1.118` のようなバージョン、または `stable` または `latest` を受け入れます。[特定のバージョンをインストール](/ja/setup#install-a-specific-version) を参照してください | `claude install stable` |

27| `claude auth login` | Anthropic アカウントにサインインします。`--email` を使用してメールアドレスを事前入力し、`--sso` を使用して SSO 認証を強制し、`--console` を使用して Claude サブスクリプションの代わりに Anthropic Console で API 使用料金をサインインできます | `claude auth login --console` |27| `claude auth login` | Anthropic アカウントにサインインします。`--email` を使用してメールアドレスを事前入力し、`--sso` を使用して SSO 認証を強制し、`--console` を使用して Claude サブスクリプションの代わりに Anthropic Console で API 使用料金をサインインできます | `claude auth login --console` |

28| `claude auth logout` | Anthropic アカウントからログアウト | `claude auth logout` |28| `claude auth logout` | Anthropic アカウントからログアウト | `claude auth logout` |


32| `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 auto-mode defaults` | 組み込み [auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode) 分類器ルールを JSON として出力します。`claude auto-mode config` を使用して、設定が適用された有効な設定を確認してください | `claude auto-mode defaults > rules.json` |

33| `claude daemon status` | バックグラウンドセッション [スーパーバイザー](/ja/agent-view#the-supervisor-process) の状態、バージョン、ソケットディレクトリ、および診断用のワーカー数を出力します。スーパーバイザーが実行されていない場合は 1 で終了します | `claude daemon status` |33| `claude daemon status` | バックグラウンドセッション [スーパーバイザー](/ja/agent-view#the-supervisor-process) の状態、バージョン、ソケットディレクトリ、および診断用のワーカー数を出力します。スーパーバイザーが実行されていない場合は 1 で終了します | `claude daemon status` |

34| `claude daemon stop --any` | バックグラウンドセッション [スーパーバイザー](/ja/agent-view#the-supervisor-process) とそれがホストするセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次のスーパーバイザーが再接続できるようにします。`--any` はオンデマンドスーパーバイザーの停止を確認します。これはデフォルトです。これを使用して、[応答しないスーパーバイザー](/ja/agent-view#agent-view-says-the-background-service-did-not-respond) から回復します | `claude daemon stop --any --keep-workers` |34| `claude daemon stop --any` | バックグラウンドセッション [スーパーバイザー](/ja/agent-view#the-supervisor-process) とそれがホストするセッションを停止します。`--keep-workers` を渡して、バックグラウンドセッションを実行したままにして、次のスーパーバイザーが再接続できるようにします。`--any` はオンデマンドスーパーバイザーの停止を確認します。これはデフォルトです。これを使用して、[応答しないスーパーバイザー](/ja/agent-view#agent-view-says-the-background-service-did-not-respond) から回復します | `claude daemon stop --any --keep-workers` |

35| `claude doctor` | セッションを開始せずにターミナルから読み取り専用のインストールおよび設定診断を出力します。インストール正常性、設定ファイル検証エラー、およびリモートコントロール適格性を含みます。セッション内のセットアップチェックアップで修正を適用することもできます。[`/doctor`](/ja/commands#all-commands) を実行してください | `claude doctor` |

35| `claude logs <id>` | [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) からの最近の出力を出力します | `claude logs 7c5dcf5d` |36| `claude logs <id>` | [バックグラウンドセッション](/ja/agent-view#manage-sessions-from-the-shell) からの最近の出力を出力します | `claude logs 7c5dcf5d` |

36| `claude mcp` | Model Context Protocol(MCP)サーバーを設定 | [Claude Code MCP ドキュメント](/ja/mcp) を参照してください。 |37| `claude mcp` | Model Context Protocol(MCP)サーバーを設定 | [Claude Code MCP ドキュメント](/ja/mcp) を参照してください。 |

37| `claude mcp login <name>` | {/* min-version: 2.1.186 */}設定済み MCP サーバーの OAuth フローを実行します。インタラクティブな `/mcp` パネルを開きません。HTTP、SSE、および claude.ai コネクタサーバーで機能します。SSH 経由で `--no-browser` を追加して、ブラウザを開く代わりに認可 URL を出力し、リダイレクト URL をプロンプトに貼り付けます。Claude Code v2.1.186 以降が必要です。[コマンドラインから認証](/ja/mcp#authenticate-from-the-command-line) を参照してください | `claude mcp login sentry` |38| `claude mcp login <name>` | {/* min-version: 2.1.186 */}設定済み MCP サーバーの OAuth フローを実行します。インタラクティブな `/mcp` パネルを開きません。HTTP、SSE、および claude.ai コネクタサーバーで機能します。SSH 経由で `--no-browser` を追加して、ブラウザを開く代わりに認可 URL を出力し、リダイレクト URL をプロンプトに貼り付けます。Claude Code v2.1.186 以降が必要です。[コマンドラインから認証](/ja/mcp#authenticate-from-the-command-line) を参照してください | `claude mcp login sentry` |


47 48 

48サブコマンドを誤入力した場合、Claude Code は最も近い一致を提案して、セッションを開始せずに終了します。たとえば、`claude udpate` は `Did you mean claude update?` と出力します。49サブコマンドを誤入力した場合、Claude Code は最も近い一致を提案して、セッションを開始せずに終了します。たとえば、`claude udpate` は `Did you mean claude update?` と出力します。

49 50 

50{/* min-version: 2.1.199 */}v2.1.199 以降、`claude --dangerously-skip-permissions daemon <subcommand>` は `daemon` サブコマンドを実行します。以前のバージョンでは、`daemon <subcommand>` を新しいインタラクティブセッションのプロンプトとして扱ったため、フラグが最初に来た場合、サブコマンドは実行されませんでした。これは `claude` が フラグを含むようにエイリアスされている場合の一般的なセットアップです。先頭の `--dangerously-skip-permissions` または `--allow-dangerously-skip-permissions` のみが `daemon` にこの方法でルーティングされます。他の先頭フラグはまだインタラクティブセッションを開始します。51{/* min-version: 2.1.199 */}v2.1.199 以降、`claude --dangerously-skip-permissions daemon <subcommand>` は `daemon` サブコマンドを実行します。以前のバージョンでは、`daemon <subcommand>` を新しいインタラクティブセッションのプロンプトとして扱ったため、フラグが最初に来た場合、サブコマンドは実行されませんでした。これは `claude` がフラグを含むようにエイリアスされている場合の一般的なセットアップです。先頭の `--dangerously-skip-permissions` または `--allow-dangerously-skip-permissions` のみが `daemon` にこの方法でルーティングされます。他の先頭フラグはまだインタラクティブセッションを開始します。

51 52 

52<h2 id="cli-flags">53<h2 id="cli-flags">

53 CLI フラグ54 CLI フラグ


63| `--agents` | JSON 経由でカスタム subagents を動的に定義します。subagent [frontmatter](/ja/sub-agents#supported-frontmatter-fields) と同じフィールド名を使用し、さらにエージェントの指示用の `prompt` フィールドを追加します | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |64| `--agents` | JSON 経由でカスタム subagents を動的に定義します。subagent [frontmatter](/ja/sub-agents#supported-frontmatter-fields) と同じフィールド名を使用し、さらにエージェントの指示用の `prompt` フィールドを追加します | `claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'` |

64| `--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` |65| `--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` |

65| `--allowedTools`、`--allowed-tools` | 権限を求めずに実行するツール。パターンマッチングについては [権限ルール構文](/ja/settings#permission-rule-syntax) を参照してください。利用可能なツールを制限するには、代わりに `--tools` を使用してください | `"Bash(git log *)" "Bash(git diff *)" "Read"` |66| `--allowedTools`、`--allowed-tools` | 権限を求めずに実行するツール。パターンマッチングについては [権限ルール構文](/ja/settings#permission-rule-syntax) を参照してください。利用可能なツールを制限するには、代わりに `--tools` を使用してください | `"Bash(git log *)" "Bash(git diff *)" "Read"` |

67| `--append-subagent-system-prompt` | {/* min-version: 2.1.205 */}ネストされた subagents を含むすべての [subagent](/ja/sub-agents) のシステムプロンプトの末尾にカスタムテキストを追加します。`-p` を使用した非インタラクティブモードでのみ適用されます。Claude Code v2.1.205 以降が必要です | `claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"` |

66| `--append-system-prompt` | デフォルトシステムプロンプトの末尾にカスタムテキストを追加します | `claude --append-system-prompt "Always use TypeScript"` |68| `--append-system-prompt` | デフォルトシステムプロンプトの末尾にカスタムテキストを追加します | `claude --append-system-prompt "Always use TypeScript"` |

67| `--append-system-prompt-file` | ファイルから追加のシステムプロンプトテキストを読み込み、デフォルトプロンプトに追加します | `claude --append-system-prompt-file ./extra-rules.txt` |69| `--append-system-prompt-file` | ファイルから追加のシステムプロンプトテキストを読み込み、デフォルトプロンプトに追加します | `claude --append-system-prompt-file ./extra-rules.txt` |

68| `--ax-screen-reader` | {/* min-version: 2.1.181 */}スクリーンリーダーフレンドリーな出力をレンダリングします:装飾的なボーダーやアニメーションなしのフラットテキスト。クラシックレンダラーを強制するため、このセッションでは [`tui`](/ja/settings#available-settings) 設定は効果がありません。[`CLAUDE_AX_SCREEN_READER`](/ja/env-vars) と [`axScreenReader`](/ja/settings#available-settings) 設定より優先されます。Claude Code v2.1.181 以降が必要です | `claude --ax-screen-reader` |70| `--ax-screen-reader` | {/* min-version: 2.1.181 */}スクリーンリーダーフレンドリーな出力をレンダリングします:装飾的なボーダーやアニメーションなしのフラットテキスト。クラシックレンダラーを強制するため、このセッションでは [`tui`](/ja/settings#available-settings) 設定は効果がありません。[`CLAUDE_AX_SCREEN_READER`](/ja/env-vars) と [`axScreenReader`](/ja/settings#available-settings) 設定より優先されます。Claude Code v2.1.181 以降が必要です | `claude --ax-screen-reader` |


71| `--bg`、`--background` | セッションを [バックグラウンドエージェント](/ja/agent-view) として開始し、すぐに戻ります。セッション ID と管理コマンドを出力します。`--exec` と組み合わせて、Claude セッションの代わりにシェルコマンドをバックグラウンドジョブとして実行するか、`--agent` と組み合わせて特定の subagent を実行します。{/* min-version: 2.1.198 */}`-p`/`--print` と組み合わせることはできません。[エラーリファレンス](/ja/errors#command-line-errors) を参照してください | `claude --bg "investigate the flaky test"` |73| `--bg`、`--background` | セッションを [バックグラウンドエージェント](/ja/agent-view) として開始し、すぐに戻ります。セッション ID と管理コマンドを出力します。`--exec` と組み合わせて、Claude セッションの代わりにシェルコマンドをバックグラウンドジョブとして実行するか、`--agent` と組み合わせて特定の subagent を実行します。{/* min-version: 2.1.198 */}`-p`/`--print` と組み合わせることはできません。[エラーリファレンス](/ja/errors#command-line-errors) を参照してください | `claude --bg "investigate the flaky test"` |

72| `--channels` | (研究プレビュー)Claude がこのセッションでリッスンすべき [channel](/ja/channels) 通知を持つ MCP サーバー。`plugin:<name>@<marketplace>` エントリのスペース区切りリスト。Claude.ai 認証が必要です | `claude --channels plugin:my-notifier@my-marketplace` |74| `--channels` | (研究プレビュー)Claude がこのセッションでリッスンすべき [channel](/ja/channels) 通知を持つ MCP サーバー。`plugin:<name>@<marketplace>` エントリのスペース区切りリスト。Claude.ai 認証が必要です | `claude --channels plugin:my-notifier@my-marketplace` |

73| `--chrome` | Web 自動化とテストのための [Chrome ブラウザ統合](/ja/chrome) を有効にします | `claude --chrome` |75| `--chrome` | Web 自動化とテストのための [Chrome ブラウザ統合](/ja/chrome) を有効にします | `claude --chrome` |

76| `--cloud` | 提供されたタスク説明で claude.ai に新しい [Web セッション](/ja/claude-code-on-the-web) を作成します | `claude --cloud "Fix the login bug"` |

74| `--continue`、`-c` | 現在のディレクトリで最新の会話を読み込みます。このディレクトリを `/add-dir` で追加したセッションを含みます | `claude --continue` |77| `--continue`、`-c` | 現在のディレクトリで最新の会話を読み込みます。このディレクトリを `/add-dir` で追加したセッションを含みます | `claude --continue` |

75| `--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` |78| `--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` |

76| `--dangerously-skip-permissions` | すべての権限プロンプトをスキップします。`--permission-mode bypassPermissions` と同等です。[権限モード](/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) を参照して、これが何をスキップし、何をスキップしないかを確認してください | `claude --dangerously-skip-permissions` |79| `--dangerously-skip-permissions` | すべての権限プロンプトをスキップします。`--permission-mode bypassPermissions` と同等です。[権限モード](/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) を参照して、これが何をスキップし、何をスキップしないかを確認してください | `claude --dangerously-skip-permissions` |


78| `--debug-file <path>` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします。`CLAUDE_CODE_DEBUG_LOGS_DIR` より優先されます | `claude --debug-file /tmp/claude-debug.log` |81| `--debug-file <path>` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします。`CLAUDE_CODE_DEBUG_LOGS_DIR` より優先されます | `claude --debug-file /tmp/claude-debug.log` |

79| `--disable-slash-commands` | このセッションのすべてのスキルとコマンドを無効にします | `claude --disable-slash-commands` |82| `--disable-slash-commands` | このセッションのすべてのスキルとコマンドを無効にします | `claude --disable-slash-commands` |

80| `--disallowedTools`、`--disallowed-tools` | 拒否ルール。ベアツール名はそのツールをモデルのコンテキストから削除します:`"Edit"` は Edit を削除し、`"*"` はすべてのツールを削除し、`"mcp__*"` はすべての MCP ツールを削除します。`Bash(rm *)` のようなスコープ付きルールはツールを利用可能なままにし、一致する呼び出しのみを拒否します | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |83| `--disallowedTools`、`--disallowed-tools` | 拒否ルール。ベアツール名はそのツールをモデルのコンテキストから削除します:`"Edit"` は Edit を削除し、`"*"` はすべてのツールを削除し、`"mcp__*"` はすべての MCP ツールを削除します。`Bash(rm *)` のようなスコープ付きルールはツールを利用可能なままにし、一致する呼び出しのみを拒否します | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

81| `--effort` | 現在のセッションの [努力レベル](/ja/model-config#adjust-effort-level) を設定します。オプション:`low`、`medium`、`high`、`xhigh`、`max`。利用可能なレベルはモデルによって異なります。[`effortLevel`](/ja/settings#available-settings) 設定をこのセッションでオーバーライドし、永続化されません | `claude --effort high` |84| `--effort` | 現在のセッションの [努力レベル](/ja/model-config#adjust-effort-level) を設定します。オプション:`low`、`medium`、`high`、`xhigh`、`max`、または {/* min-version: 2.1.203 */}`ultracode`。利用可能なレベルはモデルによって異なります。`ultracode` は [ultracode](/ja/workflows#let-claude-decide-with-ultracode) をオンにして `xhigh` 努力でセッションを開始し、Claude Code v2.1.203 以降が必要です。このセッションの [`effortLevel`](/ja/settings#available-settings) 設定をオーバーライドし、永続化されません | `claude --effort high` |

82| `--enable-auto-mode` | {/* max-version: 2.1.110 */}v2.1.111 で削除されました。Auto mode は現在 `Shift+Tab` サイクルにデフォルトで含まれています。`--permission-mode auto` を使用して開始してください | `claude --permission-mode auto` |85| `--enable-auto-mode` | {/* max-version: 2.1.110 */}v2.1.111 で削除されました。Auto mode は現在 `Shift+Tab` サイクルにデフォルトで含まれています。`--permission-mode auto` を使用して開始してください | `claude --permission-mode auto` |

83| `--exclude-dynamic-system-prompt-sections` | システムプロンプトからマシンごとのセクション(作業ディレクトリ、環境情報、メモリパス、git リポジトリフラグ)を最初のユーザーメッセージに移動します。異なるユーザーとマシンで同じタスクを実行する場合、prompt-cache の再利用を改善します。デフォルトシステムプロンプトにのみ適用されます。`--system-prompt` または `--system-prompt-file` が設定されている場合は無視されます。スクリプト化された複数ユーザーのワークロードの場合は `-p` と一緒に使用してください | `claude -p --exclude-dynamic-system-prompt-sections "query"` |86| `--exclude-dynamic-system-prompt-sections` | システムプロンプトからマシンごとのセクション(作業ディレクトリ、環境情報、メモリパス、git リポジトリフラグ)を最初のユーザーメッセージに移動します。異なるユーザーとマシンで同じタスクを実行する場合、prompt-cache の再利用を改善します。デフォルトシステムプロンプトにのみ適用されます。`--system-prompt` または `--system-prompt-file` が設定されている場合は無視されます。スクリプト化された複数ユーザーのワークロードの場合は `-p` と一緒に使用してください | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

84| `--exec` | シェルコマンドを PTY バックアップのバックグラウンドジョブとして実行します。Claude セッションを開始する代わりに `--bg` と一緒に使用してください | `claude --bg --exec 'pytest -x'` |87| `--exec` | シェルコマンドを PTY バックアップのバックグラウンドジョブとして実行します。Claude セッションを開始する代わりに `--bg` と一緒に使用してください | `claude --bg --exec 'pytest -x'` |


91| `--include-hook-events` | すべてのフックライフサイクルイベントを出力ストリームに含めます。`--output-format stream-json` が必要です | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |94| `--include-hook-events` | すべてのフックライフサイクルイベントを出力ストリームに含めます。`--output-format stream-json` が必要です | `claude -p --output-format stream-json --verbose --include-hook-events "query"` |

92| `--include-partial-messages` | 部分的なストリーミングイベントを出力に含めます。`--print` と `--output-format stream-json` が必要です | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |95| `--include-partial-messages` | 部分的なストリーミングイベントを出力に含めます。`--print` と `--output-format stream-json` が必要です | `claude -p --output-format stream-json --verbose --include-partial-messages "query"` |

93| `--input-format` | プリントモードの入力形式を指定します(オプション:`text`、`stream-json`) | `claude -p --output-format json --input-format stream-json` |96| `--input-format` | プリントモードの入力形式を指定します(オプション:`text`、`stream-json`) | `claude -p --output-format json --input-format stream-json` |

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

95| `--maintenance` | セッション開始前に `maintenance` マッチャーで [Setup hooks](/ja/hooks#setup) を実行します(プリントモードのみ) | `claude -p --maintenance "query"` |98| `--maintenance` | セッション開始前に `maintenance` マッチャーで [Setup hooks](/ja/hooks#setup) を実行します(プリントモードのみ) | `claude -p --maintenance "query"` |

96| `--max-budget-usd` | 停止する前に API 呼び出しに費やす最大ドル金額(プリントモードのみ) | `claude -p --max-budget-usd 5.00 "query"` |99| `--max-budget-usd` | 停止する前に API 呼び出しに費やす最大ドル金額(プリントモードのみ) | `claude -p --max-budget-usd 5.00 "query"` |

97| `--max-turns` | agentic ターンの数を制限します(プリントモードのみ)。制限に達するとエラーで終了します。デフォルトでは制限なし | `claude -p --max-turns 3 "query"` |100| `--max-turns` | agentic ターンの数を制限します(プリントモードのみ)。制限に達するとエラーで終了します。デフォルトでは制限なし。{/* min-version: 2.1.205 */}`--input-format stream-json` を使用する場合、Claude が作業中に送信されたメッセージはキューに入り、制限が現在のターンを終了するときに独自のターンとして実行されます。独自の制限があります。v2.1.205 より前は、Claude Code はそのメッセージを破棄しました | `claude -p --max-turns 3 "query"` |

98| `--mcp-config` | JSON ファイルまたは文字列から MCP サーバーを読み込みます(スペース区切り) | `claude --mcp-config ./mcp.json` |101| `--mcp-config` | JSON ファイルまたは文字列から MCP サーバーを読み込みます(スペース区切り) | `claude --mcp-config ./mcp.json` |

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

100| `--name`、`-n` | セッションの表示名を設定します。`/resume` とターミナルタイトルに表示されます。`claude --resume <name>` で名前付きセッションを再開できます。<br /><br />[`/rename`](/ja/commands) はセッション中に名前を変更し、プロンプトバーにも表示します | `claude -n "my-feature-work"` |103| `--name`、`-n` | セッションの表示名を設定します。`/resume` とターミナルタイトルに表示されます。`claude --resume <name>` で名前付きセッションを再開できます。<br /><br />[`/rename`](/ja/commands) はセッション中に名前を変更し、プロンプトバーにも表示します | `claude -n "my-feature-work"` |

101| `--no-chrome` | このセッションの [Chrome ブラウザ統合](/ja/chrome) を無効にします | `claude --no-chrome` |104| `--no-chrome` | このセッションの [Chrome ブラウザ統合](/ja/chrome) を無効にします | `claude --no-chrome` |

102| `--no-session-persistence` | セッション永続化を無効にして、セッションがディスクに保存されず、再開できないようにします(プリントモードのみ)。[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ja/env-vars) 環境変数は任意のモードで同じことを行います | `claude -p --no-session-persistence "query"` |105| `--no-session-persistence` | セッション永続化を無効にして、セッションがディスクに保存されず、再開できないようにします(プリントモードのみ)。[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ja/env-vars) 環境変数は任意のモードで同じことを行います | `claude -p --no-session-persistence "query"` |

103| `--output-format` | プリントモードの出力形式を指定します(オプション:`text`、`json`、`stream-json`) | `claude -p "query" --output-format json` |106| `--output-format` | プリントモードの出力形式を指定します(オプション:`text`、`json`、`stream-json`) | `claude -p "query" --output-format json` |

104| `--permission-mode` | 指定された [権限モード](/ja/permission-modes) で開始します。`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、または `bypassPermissions` を受け入れます。設定ファイルの `defaultMode` をオーバーライドします | `claude --permission-mode plan` |107| `--permission-mode` | 指定された [権限モード](/ja/permission-modes) で開始します。`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`、または {/* min-version: 2.1.200 */}`manual` を `default` のエイリアスとして受け入れます`manual` エイリアスは UI が Manual とラベル付けするモードを選択し、Claude Code v2.1.200 以降が必要です。`claude --help` は `default` の代わりにそれをリストし、両方の値が機能します。設定ファイルの `defaultMode` をオーバーライドします | `claude --permission-mode plan` |

105| `--permission-prompt-tool` | 非インタラクティブモードで権限プロンプトを処理する MCP ツールを指定します。{/* min-version: 2.1.199 */}v2.1.199 以降、プロンプトツールは [ユーザーインタラクションが必要](/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツールを承認できません:そのようなツールの `allow` 結果は拒否に変換されます | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |108| `--permission-prompt-tool` | 非インタラクティブモードで権限プロンプトを処理する MCP ツールを指定します。{/* min-version: 2.1.199 */}v2.1.199 以降、プロンプトツールは [ユーザーインタラクションが必要](/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツールを承認できません:そのようなツールの `allow` 結果は拒否に変換されます | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

106| `--plugin-dir` | このセッションのみのプラグインをディレクトリまたは `.zip` アーカイブから読み込みます。各フラグは 1 つのパスを取ります。複数のプラグインの場合はフラグを繰り返します:`--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |109| `--plugin-dir` | このセッションのみのプラグインをディレクトリまたは `.zip` アーカイブから読み込みます。各フラグは 1 つのパスを取ります。複数のプラグインの場合はフラグを繰り返します:`--plugin-dir A --plugin-dir B.zip` | `claude --plugin-dir ./my-plugin` |

107| `--plugin-url` | このセッションのみのプラグイン `.zip` アーカイブを URL から取得します。複数のプラグインの場合はフラグを繰り返すか、スペース区切りの URL を単一の引用符で囲まれた値で渡します | `claude --plugin-url https://example.com/plugin.zip` |110| `--plugin-url` | このセッションのみのプラグイン `.zip` アーカイブを URL から取得します。複数のプラグインの場合はフラグを繰り返すか、スペース区切りの URL を単一の引用符で囲まれた値で渡します | `claude --plugin-url https://example.com/plugin.zip` |

108| `--print`、`-p` | インタラクティブモードなしで応答を出力します(プログラムによる使用の詳細については [Agent SDK ドキュメント](/ja/agent-sdk/overview) を参照) | `claude -p "query"` |111| `--print`、`-p` | インタラクティブモードなしで応答を出力します(プログラムによる使用の詳細については [Agent SDK ドキュメント](/ja/agent-sdk/overview) を参照) | `claude -p "query"` |

109| `--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"` |112| `--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"` |

110| `--remote` | 提供されたタスク説明で claude.ai に新しい [Web セッション](/ja/claude-code-on-the-web) を作成します | `claude --remote "Fix the login bug"` |113| `--remote` | `--cloud` の廃止されたエイリアス | `claude --remote "Fix the login bug"` |

111| `--remote-control`、`--rc` | [Remote Control](/ja/remote-control#start-a-remote-control-session) を有効にしてインタラクティブセッションを開始し、claude.ai または Claude アプリからも制御できるようにします。オプションでセッションの名前を渡すことができます | `claude --remote-control "My Project"` |114| `--remote-control`、`--rc` | [Remote Control](/ja/remote-control#start-a-remote-control-session) を有効にしてインタラクティブセッションを開始し、claude.ai または Claude アプリからも制御できるようにします。オプションでセッションの名前を渡すことができます | `claude --remote-control "My Project"` |

112| `--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` |115| `--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` |

113| `--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` |116| `--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` |

code-review.md +1 −1

Details

270 270 

271どのモードでも、`@claude review` と[コメント](#manually-trigger-reviews)すると、PR がプッシュトリガーレビューにオプトインされるため、そのコメント後のプッシュごとに追加コストが発生します。今後のプッシュにサブスクライブせずに単一のレビューを実行するには、代わりに `@claude review once` とコメントしてください。271どのモードでも、`@claude review` と[コメント](#manually-trigger-reviews)すると、PR がプッシュトリガーレビューにオプトインされるため、そのコメント後のプッシュごとに追加コストが発生します。今後のプッシュにサブスクライブせずに単一のレビューを実行するには、代わりに `@claude review once` とコメントしてください。

272 272 

273コストは、組織が他の Claude Code 機能に Amazon Bedrock または Google Vertex AI を使用しているかどうかに関係なく、Anthropic の請求書に表示されます。Code Review の月次支出上限を設定するには、[claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) にアクセスして、Claude Code Review サービスの制限を設定します。273コストは、組織が他の Claude Code 機能に Amazon Bedrock または Google Cloud Agent Platform を使用しているかどうかに関係なく、Anthropic の請求書に表示されます。Code Review の月次支出上限を設定するには、[claude.ai/admin-settings/usage](https://claude.ai/admin-settings/usage) にアクセスして、Claude Code Review サービスの制限を設定します。

274 274 

275[analytics](#view-usage) の週次コストチャートまたは管理設定のリポジトリごとの平均コスト列を通じて支出を監視します。275[analytics](#view-usage) の週次コストチャートまたは管理設定のリポジトリごとの平均コスト列を通じて支出を監視します。

276 276 

commands.md +22 −22

Details

24 24 

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

26 26 

27**リリース前。** `/diff` は変更内容を表示し、`/code-review` は diff の正確性のバグをチェックし、`--fix` で検出結果を適用できます。`/review` は GitHub プルリクエストで同じ読み取り専用レビューを実行し、`/security-review` はより深い読み取り専用パスを提供します。`/code-review ultra` はクラウドでマルチエージェントレビューを実行します。27**リリース前。** `/diff` は変更内容を表示し、`/code-review` は diff の正確性のバグをチェックしてクリーンアップを行い、`--fix` で検出結果を適用できます。`/review` は GitHub プルリクエストの高速な単一パスの読み取り専用レビューを提供し、`/code-review <level> <pr#>` はマルチエージェントレビューを実行し、`/security-review` は diff のセキュリティ脆弱性をチェックします。`/code-review ultra` はクラウドでマルチエージェントレビューを実行します。

28 28 

29**セッション間。** `/clear` は新しいタスクで新しく開始しながらプロジェクトメモリを保持します。`/resume` と `/branch` を使用して、以前の会話に戻るか、フォークできます。`/teleport` はウェブセッションをこのターミナルに引き込み、`/remote-control` を使用してこのローカルセッションを別のデバイスから続行できます。29**セッション間。** `/clear` は新しいタスクで新しく開始しながらプロジェクトメモリを保持します。`/resume` と `/branch` を使用して、以前の会話に戻るか、フォークできます。`/teleport` はウェブセッションをこのターミナルに引き込み、`/remote-control` を使用してこのローカルセッションを別のデバイスから続行できます。

30 30 

31**何か問題がある場合。** `/rewind` はコードと会話をチェックポイントに巻き戻すか、会話の一部を要約します。`/doctor` `/debug` はインストールとランタイムの問題を診断し、`/feedback` はセッションコンテキストが添付されたバグを報告します。31**何か問題がある場合。** `/rewind` はコードと会話をチェックポイントに巻き戻すか、会話の一部を要約します。`/doctor` はセットアップチェックアップを実行してインストールと設定の問題を診断し、修正できます。`/debug` はランタイムの問題を診断し、`/feedback` はセッションコンテキストが添付されたバグを報告します。

32 32 

33<h2 id="all-commands">33<h2 id="all-commands">

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


48</Note>48</Note>

49 49 

50| コマンド | 目的 |50| コマンド | 目的 |

51| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |51| :--------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

52| `/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 以降が必要です |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 以降が必要です |

54| `/agents` | {/* min-version: 2.1.198 */}v2.1.198 以降、`/agents` を実行すると、Claude に[サブエージェント](/ja/sub-agents)を作成または管理するよう依頼するか、`.claude/agents/` または `~/.claude/agents/` を直接編集するよう促すリマインダーが出力されます。{/* max-version: 2.1.197 */}v2.1.197 以前では、サブエージェント設定を作成および管理するためのインタラクティブインターフェースを開きます |54| `/agents` | {/* min-version: 2.1.198 */}v2.1.198 以降、`/agents` を実行すると、Claude に[サブエージェント](/ja/sub-agents)を作成または管理するよう依頼するか、`.claude/agents/` または `~/.claude/agents/` を直接編集するよう促すリマインダーが出力されます。{/* max-version: 2.1.197 */}v2.1.197 以前では、サブエージェント設定を作成および管理するためのインタラクティブインターフェースを開きます |


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 をゼロから作成するインタラクティブなウォークスルーを実施します |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 をゼロから作成するインタラクティブなウォークスルーを実施します |

63| `/clear [name]` | 空のコンテキストで新しい会話を開始します。前の会話は `/resume` で利用可能なままです。前の会話にラベルを付けるために名前を渡します。`/resume` ピッカーで。同じ会話を続けながらコンテキストを解放するには、代わりに `/compact` を使用してください。エイリアス: `/reset`、`/new` |63| `/clear [name]` | 空のコンテキストで新しい会話を開始します。前の会話は `/resume` で利用可能なままです。前の会話にラベルを付けるために名前を渡します。`/resume` ピッカーで。同じ会話を続けながらコンテキストを解放するには、代わりに `/compact` を使用してください。エイリアス: `/reset`、`/new` |

64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[スキル](/ja/skills#bundled-skills)。** 現在の diff を正確性バグについてレビューし、再利用、簡潔化、効率化のクリーンアップについてレビューします。`--fix` を渡して結果を作業ツリーに適用し、`--comment` を渡して GitHub PR にインラインコメントとして投稿し、`ultra` を渡してディープ[クラウドレビュー](/ja/ultrareview)を実行します。{/* min-version: 2.1.154 */}v2.1.154 以降、`/simplify` は別のクリーンアップのみのレビューを実行し、バグを探さずに修正を適用します。[diff をローカルでレビュー](/ja/code-review#review-a-diff-locally)を参照して、努力レベルとターゲット設定を確認してください |64| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [target]` | **[スキル](/ja/skills#bundled-skills)。** 現在の diff を正確性バグについてレビューし、再利用、簡潔化、効率化のクリーンアップについてレビューします。`--fix` を渡して結果を作業ツリーに適用し、`--comment` を渡して GitHub PR にインラインコメントとして投稿し、`ultra` を渡してディープ[クラウドレビュー](/ja/ultrareview)を実行します。{/* min-version: 2.1.154 */}v2.1.154 以降、`/simplify` は別のクリーンアップのみのレビューを実行し、バグを探さずに修正を適用します。[diff をローカルでレビュー](/ja/code-review#review-a-diff-locally)を参照して、努力レベルとターゲット設定を確認してください |

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

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

67| `/config [key=value ...]` | [設定](/ja/settings)インターフェースを開いて、テーマ、モデル、[出力スタイル](/ja/output-styles)、およびその他の設定を調整します。{/* min-version: 2.1.181 */}v2.1.181 以降、1 つ以上の `key=value` ペアを渡して、インターフェースを開かずに設定を直接設定できます。例えば `/config thinking=false`。{/* min-version: 2.1.182 */}v2.1.182 以降、`/config theme=dark` や `/config model=sonnet` などの名前付きショートハンドキーも受け入れられます。`key=value` 形式は非対話モード(`-p`)と[リモートコントロール](/ja/remote-control)からも機能します。`/config --help` を実行して設定できるキーをリストします。エイリアス: `/settings` |67| `/config [key=value ...]` | [設定](/ja/settings)インターフェースを開いて、テーマ、モデル、[出力スタイル](/ja/output-styles)、およびその他の設定を調整します。{/* min-version: 2.1.181 */}v2.1.181 以降、1 つ以上の `key=value` ペアを渡して、インターフェースを開かずに設定を直接設定できます。例えば `/config thinking=false`。{/* min-version: 2.1.182 */}v2.1.182 以降、`/config theme=dark` や `/config model=sonnet` などの名前付きショートハンドキーも受け入れられます。`key=value` 形式は非対話モード(`-p`)と[リモートコントロール](/ja/remote-control)からも機能します。`/config --help` を実行して設定できるキーをリストします。エイリアス: `/settings` |

68| `/context [all]` | 現在のコンテキスト使用状況をカラーグリッドとして視覚化します。コンテキストが多いツール、メモリ肥大化、容量警告の最適化提案を表示します。[フルスクリーンモード](/ja/fullscreen)では、項目ごとの内訳はグリッドを表示したままにするために折りたたまれます。`all` を渡して展開します |68| `/context [all]` | 現在のコンテキスト使用状況をカラーグリッドとして視覚化します。コンテキストが多いツール、メモリ肥大化、容量警告の最適化提案を表示します。[フルスクリーンモード](/ja/fullscreen)では、項目ごとの内訳はグリッドを表示したままにするために折りたたまれます。`all` を渡して展開します |

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

70| `/cost` | `/usage` のエイリアス |70| `/cost` | `/usage` のエイリアス |

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

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

73| `/deep-research <question>` | **[ワークフロー](/ja/workflows#bundled-workflows)。** 質問に関するウェブ検索をファンアウトし、ソースをフェッチして相互検証し、引用されたレポートを合成します |73| `/deep-research <question>` | **[ワークフロー](/ja/workflows#bundled-workflows)。** 質問に関するウェブ検索をファンアウトし、ソースをフェッチして相互検証し、引用されたレポートを合成します |

74| `/design-login` | `/design-sync` のための design-system アクセスを claude.ai アカウントで認可します |74| `/design-login` | `/design-sync` のための design-system アクセスを claude.ai アカウントで認可します |

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

76| `/desktop` | 現在のセッションを Claude Code デスクトップアプリで続行します。macOS と Windows が必要で、Claude サブスクリプションが必要です。エイリアス: `/app` |76| `/desktop` | 現在のセッションを Claude Code デスクトップアプリで続行します。macOS と Windows が必要で、Claude サブスクリプションが必要です。エイリアス: `/app` |

77| `/diff` | コミットされていない変更と各ターンの diff を表示するインタラクティブ diff ビューアを開きます。左右矢印を使用して現在の git diff と個別の Claude ターンを切り替え、上下矢印でファイルをブラウズします。{/* min-version: 2.1.198 */}v2.1.198 以降、開いているビューアは、別のターミナルでのブランチ切り替えやコミットなど、セッション外でリポジトリの git 状態が変更されたときに自動的に更新されます |77| `/diff` | コミットされていない変更と各ターンの diff を表示するインタラクティブ diff ビューアを開きます。左右矢印を使用して現在の git diff と個別の Claude ターンを切り替え、上下矢印でファイルをブラウズします。{/* min-version: 2.1.198 */}v2.1.198 以降、開いているビューアは、別のターミナルでのブランチ切り替えやコミットなど、セッション外でリポジトリの git 状態が変更されたときに自動的に更新されます |

78| `/doctor` | Claude Code のインストールと設定を診断および検証します結果はステータスアイコン付きで表示されます。`f` を押して Claude に報告された問題を修正させます |78| `/doctor` | **[スキル](/ja/skills#bundled-skills)。** セットアップチェックアップを実行して、問題を診断し、修正できます。インストール正常性をチェックします。重複またはレフトオーバーインストール、`PATH` の問題、解析不可能な設定ファイルを含みます未使用のスキル、MCP サーバー、プラグインとそのコンテキストコストを見つけ、ローカル `CLAUDE.md` ファイルをチェックイン済みのものに対して重複排除し、常に読み込まれるガイダンスを[スキル](/ja/skills)と必要に応じて読み込まれるネストされた `CLAUDE.md` ファイルに移行し、遅い[フック](/ja/hooks)にフラグを立て、新しいバージョンをチェックしますまた、[自動モード](/ja/permissions#permission-modes)をデフォルトにすることを提案し、頻繁に拒否される読み取り専用コマンドを[事前承認](/ja/permissions)することを提案します。最初に結果を報告し、何かを変更する前に確認を求めます。ターミナルから、`claude doctor` は読み取り専用インストール診断を出力し、セッションを開始しません。エイリアス: `/checkup`。{/* min-version: 2.1.205 */}v2.1.205 より前では、`/doctor` は読み取り専用診断画面を開き、`f` を押すとレポートを Claude に送信しました |

79| `/effort [level\|auto]` | モデルの[努力レベル](/ja/model-config#adjust-effort-level)を設定します。`low`、`medium`、`high`、`xhigh`、`max`、または `ultracode` を受け入れます。利用可能なレベルはモデルに依存し、`max` と `ultracode` はセッションのみです。`ultracode` は Claude Code 設定で、`xhigh` 推論と自動[ワークフロー](/ja/workflows#let-claude-decide-with-ultracode)オーケストレーションを組み合わせています。`auto` はモデルのデフォルトにリセットします。引数なしで、インタラクティブスライダーを開きます。左右矢印でレベルを選択し、`Enter` で適用します。現在の応答の完了を待たずに即座に有効になります |79| `/effort [level\|auto]` | モデルの[努力レベル](/ja/model-config#adjust-effort-level)を設定します。`low`、`medium`、`high`、`xhigh`、`max`、または `ultracode` を受け入れます。利用可能なレベルはモデルに依存し、`max` と `ultracode` はセッションのみです。`ultracode` は Claude Code 設定で、`xhigh` 推論と自動[ワークフロー](/ja/workflows#let-claude-decide-with-ultracode)オーケストレーションを組み合わせています。`auto` はモデルのデフォルトにリセットします。引数なしで、インタラクティブスライダーを開きます。左右矢印でレベルを選択し、`Enter` で適用します。現在の応答の完了を待たずに即座に有効になります。{/* min-version: 2.1.205 */}非対話モード(`-p`)でもレベル引数で利用可能です。現在のセッションのみに適用され、デフォルトとして保存されません。Claude Code v2.1.205 以降が必要です。Fable 5、Opus 4.8、Opus 4.7 では、非対話的な `/effort` は [モデルデフォルト努力ホールド](/ja/model-config#adjust-effort-level)が有効な間は `Not applied` を報告するため、代わりに起動時に `--effort` を渡してください |

80| `/exit` | CLI を終了します。接続されている[バックグラウンドセッション](/ja/agent-view#attach-to-a-session)では、これはデタッチされ、セッションは実行を続けます。エイリアス: `/quit` |80| `/exit` | CLI を終了します。接続されている[バックグラウンドセッション](/ja/agent-view#attach-to-a-session)では、これはデタッチされ、セッションは実行を続けます。エイリアス: `/quit` |

81| `/export [filename]` | 現在の会話をプレーンテキストとしてエクスポートします。ファイル名を指定すると、そのファイルに直接書き込みます。指定しない場合、クリップボードにコピーするか、ファイルに保存するダイアログを開きます |81| `/export [filename]` | 現在の会話をプレーンテキストとしてエクスポートします。ファイル名を指定すると、そのファイルに直接書き込みます。指定しない場合、クリップボードにコピーするか、ファイルに保存するダイアログを開きます |

82| `/fast [on\|off]` | [高速モード](/ja/fast-mode)のオン/オフを切り替えます |82| `/fast [on\|off]` | [高速モード](/ja/fast-mode)のオン/オフを切り替えます。{/* min-version: 2.1.205 */}非対話モード(`-p`)では、`/fast` は高速モードを [`--settings`](/ja/cli-reference#cli-flags) 値で起動したセッションでのみ機能します。例えば `claude -p --settings '{"fastMode": true}'`。トグルは現在のセッションのみに適用され、デフォルトとして保存されません。他の非対話セッションでは、コマンドは高速モードが利用できないことを報告します。Claude Code v2.1.205 以降が必要です |

83| `/feedback [report]` | フィードバックを送信し、バグを報告するか、会話を共有します。エイリアス: `/bug`、`/share` |83| `/feedback [report]` | フィードバックを送信し、バグを報告するか、会話を共有します。エイリアス: `/bug`、`/share` |

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

85| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、編集 diffstats を含む 1 行のツール呼び出し要約、および最終応答のみを表示します。{/* min-version: 2.1.198 */}v2.1.198 以降、ツール呼び出し要約はターン内で起動されたサブエージェントの数もカウントし、完了したバックグラウンドタスク通知を単一のカウントに折りたたみます。選択は複数セッション間で保持されます。設定で [`viewMode`](/ja/settings#available-settings) を設定してオーバーライドします。[フルスクリーンレンダリング](/ja/fullscreen)でのみ利用可能です |85| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、編集 diffstats を含む 1 行のツール呼び出し要約、および最終応答のみを表示します。{/* min-version: 2.1.198 */}v2.1.198 以降、ツール呼び出し要約はターン内で起動されたサブエージェントの数もカウントし、完了したバックグラウンドタスク通知を単一のカウントに折りたたみます。選択は複数セッション間で保持されます。設定で [`viewMode`](/ja/settings#available-settings) を設定してオーバーライドします。[フルスクリーンレンダリング](/ja/fullscreen)でのみ利用可能です |


97| `/login` | Anthropic アカウントにサインインします |97| `/login` | Anthropic アカウントにサインインします |

98| `/logout` | Anthropic アカウントからサインアウトします |98| `/logout` | Anthropic アカウントからサインアウトします |

99| `/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` |99| `/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` |

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

101| `/memory` | `CLAUDE.md` メモリファイルを編集し、[自動メモリ](/ja/memory#auto-memory)を有効または無効にし、自動メモリエントリを表示します |101| `/memory` | `CLAUDE.md` メモリファイルを編集し、[自動メモリ](/ja/memory#auto-memory)を有効または無効にし、自動メモリエントリを表示します |

102| `/mobile` | Claude モバイルアプリをダウンロードするための QR コードを表示します。エイリアス: `/ios`、`/android` |102| `/mobile` | Claude モバイルアプリをダウンロードするための QR コードを表示します。エイリアス: `/ios`、`/android` |

103| `/model [model]` | AI モデルを切り替えて、新しいセッションのデフォルトとして保存します。サポートしているモデルの場合、左右矢印を使用して[努力レベルを調整](/ja/model-config#adjust-effort-level)します。引数なしで、ピッカーを開きます。`s` をピッカーの行で押して、現在のセッションのみのモデルを切り替えます。会話に前の出力がある場合、ピッカーは確認を求めます。次の応答はキャッシュされたコンテキストなしで完全な履歴を再読み込みするためです。確認されると、現在の応答の完了を待たずに変更が適用されます |103| `/model [model]` | AI モデルを切り替えて、新しいセッションのデフォルトとして保存します。サポートしているモデルの場合、左右矢印を使用して[努力レベルを調整](/ja/model-config#adjust-effort-level)します。引数なしで、ピッカーを開きます。`s` をピッカーの行で押して、現在のセッションのみのモデルを切り替えます。会話に前の出力がある場合、ピッカーは確認を求めます。次の応答はキャッシュされたコンテキストなしで完全な履歴を再読み込みするためです。確認されると、現在の応答の完了を待たずに変更が適用されます。{/* min-version: 2.1.205 */}非対話モード(`-p`)でもモデル引数で利用可能です。現在のセッションのみに適用され、デフォルトとして保存されません。Claude Code v2.1.205 以降が必要です |

104| `/passes` | Claude Code の無料 1 週間を友人と共有します。アカウントが対象の場合のみ表示されます |104| `/passes` | Claude Code の無料 1 週間を友人と共有します。アカウントが対象の場合のみ表示されます |

105| `/permissions` | ツール権限のアクセス許可、確認、および拒否ルールを管理します。スコープ別にルールを表示し、ルールを追加または削除し、作業ディレクトリを管理し、[最近の自動モード拒否](/ja/auto-mode-config#review-denials)を確認できるインタラクティブダイアログを開きます。エイリアス: `/allowed-tools` |105| `/permissions` | ツール権限のアクセス許可、確認、および拒否ルールを管理します。スコープ別にルールを表示し、ルールを追加または削除し、作業ディレクトリを管理し、[最近の自動モード拒否](/ja/auto-mode-config#review-denials)を確認できるインタラクティブダイアログを開きます。エイリアス: `/allowed-tools` |

106| `/plan [description]` | プロンプトから直接 Plan Mode に入ります。オプションの説明を渡して Plan Mode に入り、すぐにそのタスクで開始します。例えば `/plan fix the auth bug` |106| `/plan [description]` | プロンプトから直接 Plan Mode に入ります。オプションの説明を渡して Plan Mode に入り、すぐにそのタスクで開始します。例えば `/plan fix the auth bug` |


108| `/powerup` | アニメーション化されたデモを使用したクイックインタラクティブレッスンを通じて Claude Code 機能を発見します |108| `/powerup` | アニメーション化されたデモを使用したクイックインタラクティブレッスンを通じて Claude Code 機能を発見します |

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

110| `/privacy-settings` | プライバシー設定を表示および更新します。Pro および Max プランサブスクライバーのみ利用可能です |110| `/privacy-settings` | プライバシー設定を表示および更新します。Pro および Max プランサブスクライバーのみ利用可能です |

111| `/radio` | Claude FM lo-fi ラジオをブラウザで開きます。ブラウザが利用できない場合、ストリーム URL を出力します。Bedrock、Vertex、または Foundry では利用できません |111| `/radio` | Claude FM lo-fi ラジオをブラウザで開きます。ブラウザが利用できない場合、ストリーム URL を出力します。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません |

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

113| `/release-notes` | インタラクティブバージョンピッカーでチェンジログを表示します。特定のバージョンを選択してそのリリースノートを表示するか、すべてのバージョンを表示することを選択します |113| `/release-notes` | インタラクティブバージョンピッカーでチェンジログを表示します。特定のバージョンを選択してそのリリースノートを表示するか、すべてのバージョンを表示することを選択します |

114| `/reload-plugins [--force]` | すべてのアクティブな[プラグイン](/ja/plugins)を再読み込みして、再起動せずに保留中の変更を適用します。読み込まれた各コンポーネントのカウントを報告し、読み込みエラーをフラグします。再読み込みが読み込まれた MCP ツールを変更し、プロンプトキャッシュを無効にする場合、コマンドは警告を表示し、`--force` を渡さない限りスキップします |114| `/reload-plugins [--force]` | すべてのアクティブな[プラグイン](/ja/plugins)を再読み込みして、再起動せずに保留中の変更を適用します。読み込まれた各コンポーネントのカウントを報告し、読み込みエラーをフラグします。再読み込みが読み込まれた MCP ツールを変更し、プロンプトキャッシュを無効にする場合、コマンドは警告を表示し、`--force` を渡さない限りスキップします |

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

116| `/remote-control` | このセッションを claude.ai から[リモートコントロール](/ja/remote-control)できるようにします。エイリアス: `/rc` |116| `/remote-control` | このセッションを claude.ai から[リモートコントロール](/ja/remote-control)できるようにします。エイリアス: `/rc` |

117| `/remote-env` | [クラウドエージェント](/ja/claude-code-on-the-web#configure-your-environment)のデフォルト環境を選択します |117| `/remote-env` | [クラウドエージェント](/ja/claude-code-on-the-web#configure-your-environment)のデフォルト環境を選択します |

118| `/rename [name]` | 現在のセッションの名前を変更してプロンプトバーに名前を表示します。名前を指定しない場合、会話履歴から自動生成されます |118| `/rename [name]` | 現在のセッションの名前を変更してプロンプトバーに名前を表示します。名前を指定しない場合、会話履歴から自動生成されます。{{/* min-version: 2.1.205 */}}非対話モード(`-p`)でも利用可能です。Claude Code v2.1.205 以降が必要です |

119| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。v2.1.144 以降、[バックグラウンドセッション](/ja/agent-view)はピッカーに `bg` とマークされて表示されます。エイリアス: `/continue` |119| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。v2.1.144 以降、[バックグラウンドセッション](/ja/agent-view)はピッカーに `bg` とマークされて表示されます。エイリアス: `/continue` |

120| `/review [PR]` | GitHub プルリクエストを番号でレビューします。`/code-review` と同じレビューエンジンを使用します引数なしで選択するオープン PR をリストします。クラウドベースのレビューについては、[`/code-review ultra`](/ja/ultrareview)を参照してください |120| `/review [PR]` | {{/* min-version: 2.1.202 */}}GitHub プルリクエストを番号で高速シングルパス読み取り専用レビューを実行します引数なしで、選択するオープン PR をリストします。PR 番号の後のテキストは追加のレビュー指示になります。v2.1.186 から v2.1.201 まで、`/review` は代わりに `/code-review medium` と同じマルチエージェントエンジンを実行していました選択した努力レベルでマルチエージェントレビューを実行するには[`/code-review <level> <pr#>`](/ja/code-review#review-a-diff-locally)を使用してください。クラウドベースのレビューについては、[`/code-review ultra`](/ja/ultrareview)を参照してください |

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

122| `/run` | **[スキル](/ja/skills#bundled-skills)。** プロジェクトのアプリを起動して実行し、テストだけでなく実行中のアプリで変更が機能しているのを確認します。[アプリを実行して検証](/ja/skills#run-and-verify-your-app)を参照してください。{/* min-version: 2.1.145 */}Claude Code v2.1.145 以降が必要です |122| `/run` | **[スキル](/ja/skills#bundled-skills)。** プロジェクトのアプリを起動して実行し、テストだけでなく実行中のアプリで変更が機能しているのを確認します。[アプリを実行して検証](/ja/skills#run-and-verify-your-app)を参照してください。{{/* min-version: 2.1.145 */}}Claude Code v2.1.145 以降が必要です |

123| `/run-skill-generator` | **[スキル](/ja/skills#bundled-skills)。** クリーンな環境からプロジェクトのアプリをビルド、起動、実行する方法を `/run` と `/verify` に教えるために、プロジェクトごとの[スキル](/ja/skills#run-and-verify-your-app)を作成します。{/* min-version: 2.1.145 */}Claude Code v2.1.145 以降が必要です |123| `/run-skill-generator` | **[スキル](/ja/skills#bundled-skills)。** クリーンな環境からプロジェクトのアプリをビルド、起動、実行する方法を `/run` と `/verify` に教えるために、プロジェクトごとの[スキル](/ja/skills#run-and-verify-your-app)を作成します。{{/* min-version: 2.1.145 */}}Claude Code v2.1.145 以降が必要です |

124| `/sandbox` | [サンドボックスモード](/ja/sandboxing)を切り替えます。サポートされているプラットフォームでのみ利用可能です |124| `/sandbox` | [サンドボックスモード](/ja/sandboxing)を切り替えます。サポートされているプラットフォームでのみ利用可能です |

125| `/schedule [description]` | [ルーチン](/ja/routines)を作成、更新、リスト表示、または実行します。Claude がセットアップを会話形式でガイドします。エイリアス: `/routines` |125| `/schedule [description]` | [ルーチン](/ja/routines)を作成、更新、リスト表示、または実行します。Claude がセットアップを会話形式でガイドします。エイリアス: `/routines` |

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

127| `/security-review` | 現在のブランチの保留中の変更をセキュリティ脆弱性について分析します。git diff をレビューし、インジェクション、認証の問題、データ露出などのリスクを特定します |127| `/security-review` | 現在のブランチの保留中の変更をセキュリティ脆弱性について分析します。git diff をレビューし、インジェクション、認証の問題、データ露出などのリスクを特定します |

128| `/setup-bedrock` | [Amazon Bedrock](/ja/amazon-bedrock) 認証、リージョン、モデルピンをインタラクティブウィザードで構成します。`CLAUDE_CODE_USE_BEDROCK=1` が設定されている場合のみ表示されます。初回 Bedrock ユーザーはログイン画面からこのウィザードにアクセスすることもできます |128| `/setup-bedrock` | [Amazon Bedrock](/ja/amazon-bedrock) 認証、リージョン、モデルピンをインタラクティブウィザードで構成します。`CLAUDE_CODE_USE_BEDROCK=1` が設定されている場合のみ表示されます。初回 Amazon Bedrock ユーザーはログイン画面からこのウィザードにアクセスすることもできます |

129| `/setup-vertex` | [Google Vertex AI](/ja/google-vertex-ai) 認証、プロジェクト、リージョン、モデルピンをインタラクティブウィザードで構成します。`CLAUDE_CODE_USE_VERTEX=1` が設定されている場合のみ表示されます。初回 Vertex AI ユーザーはログイン画面からこのウィザードにアクセスすることもできます |129| `/setup-vertex` | [Google Cloud の Agent Platform](/ja/google-vertex-ai) 認証、プロジェクト、リージョン、モデルピンをインタラクティブウィザードで構成します。`CLAUDE_CODE_USE_VERTEX=1` が設定されている場合のみ表示されます。初回 Google Cloud の Agent Platform ユーザーはログイン画面からこのウィザードにアクセスすることもできます |

130| `/simplify [target]` | {/* min-version: 2.1.154 */}**[スキル](/ja/skills#bundled-skills)。** 変更されたコードをクリーンアップの機会についてレビューし、修正を適用します。4 つのレビュー[エージェント](/ja/sub-agents)が並列で実行され、既存のヘルパーの再利用、簡潔化、効率化、および変更が抽象化の正しいレベルにあるかどうかをカバーします。v2.1.154 以降、レビューは正確性バグを探しません。バグを見つけるには `/code-review` を使用してください。以前のバージョンでは `/simplify` は `/code-review --fix` と同等です。特定のターゲットをレビューするためにパスまたは PR リファレンスを渡します |130| `/simplify [target]` | {{/* min-version: 2.1.154 */}}**[スキル](/ja/skills#bundled-skills)。** 変更されたコードをクリーンアップの機会についてレビューし、修正を適用します。4 つのレビュー[エージェント](/ja/sub-agents)が並列で実行され、既存のヘルパーの再利用、簡潔化、効率化、および変更が抽象化の正しいレベルにあるかどうかをカバーします。v2.1.154 以降、レビューは正確性バグを探しません。バグを見つけるには `/code-review` を使用してください。以前のバージョンでは `/simplify` は `/code-review --fix` と同等です。特定のターゲットをレビューするためにパスまたは PR リファレンスを渡します |

131| `/skills` | 利用可能な[スキル](/ja/skills)をリスト表示します。{/* min-version: 2.1.121 */}v2.1.121 以降、名前でリストをフィルタリングするために入力します。`t` を押してトークン数でソートします。`Space` を押して[スキルを Claude または `/` メニューから非表示にし](/ja/skills#override-skill-visibility-from-settings)、`Enter` で保存します |131| `/skills` | 利用可能な[スキル](/ja/skills)をリスト表示します。{{/* min-version: 2.1.121 */}}v2.1.121 以降、名前でリストをフィルタリングするために入力します。`t` を押してトークン数でソートします。`Space` を押して[スキルを Claude または `/` メニューから非表示にし](/ja/skills#override-skill-visibility-from-settings)、`Enter` で保存します |

132| `/stats` | `/usage` のエイリアス。Stats タブで開きます |132| `/stats` | `/usage` のエイリアス。Stats タブで開きます |

133| `/status` | 設定インターフェース(ステータスタブ)を開いて、バージョン、モデル、アカウント、および接続性を表示します。Claude が応答中でも機能し、現在の応答の完了を待ちません |133| `/status` | 設定インターフェース(ステータスタブ)を開いて、バージョン、モデル、アカウント、および接続性を表示します。Claude が応答中でも機能し、現在の応答の完了を待ちません |

134| `/statusline` | Claude Code の[ステータスライン](/ja/statusline)を構成します。必要な内容を説明するか、引数なしで実行してシェルプロンプトから自動構成します |134| `/statusline` | Claude Code の[ステータスライン](/ja/statusline)を構成します。必要な内容を説明するか、引数なしで実行してシェルプロンプトから自動構成します |


144| `/ultrareview [PR]` | [ultrareview](/ja/ultrareview) を使用してクラウドサンドボックスで深い複数エージェントコードレビューを実行します。推奨される呼び出しは `/code-review ultra` であり、`/ultrareview` はエイリアスとして残ります。Pro と Max に 3 つの無料実行が含まれ、その後は [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) が必要です |144| `/ultrareview [PR]` | [ultrareview](/ja/ultrareview) を使用してクラウドサンドボックスで深い複数エージェントコードレビューを実行します。推奨される呼び出しは `/code-review ultra` であり、`/ultrareview` はエイリアスとして残ります。Pro と Max に 3 つの無料実行が含まれ、その後は [usage credits](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans) が必要です |

145| `/upgrade` | アップグレードページを開いて、より高いプランティアに切り替えます |145| `/upgrade` | アップグレードページを開いて、より高いプランティアに切り替えます |

146| `/usage` | セッションコスト、プラン使用制限、およびアクティビティ統計を表示します。Pro、Max、Team、または Enterprise プランの場合、スキル、サブエージェント、プラグイン、MCP サーバーごとの使用状況の内訳が含まれます。詳細については、[コスト追跡ガイド](/ja/costs#using-the-%2Fusage-command)を参照してください。`/cost` と `/stats` はエイリアスです |146| `/usage` | セッションコスト、プラン使用制限、およびアクティビティ統計を表示します。Pro、Max、Team、または Enterprise プランの場合、スキル、サブエージェント、プラグイン、MCP サーバーごとの使用状況の内訳が含まれます。詳細については、[コスト追跡ガイド](/ja/costs#using-the-%2Fusage-command)を参照してください。`/cost` と `/stats` はエイリアスです |

147| `/usage-credits` | 制限に達したときに作業を続行するための usage credits を構成します。以前は `/extra-usage` |147| `/usage-credits` | 制限に達したときに作業を続行するための usage credits を構成します。ブラウザを開いて usage-credits 請求ページを開きます。{{/* min-version: 2.1.205 */}}ブラウザが開けない場合(例えば SSH 経由)、コマンドは代わりに訪問する URL を出力します。これには Claude Code v2.1.205 以降が必要です。以前のバージョンではその場合何も表示されませんでした。以前は `/extra-usage` |

148| `/verify` | **[スキル](/ja/skills#bundled-skills)。** プロジェクトのアプリをビルドして実行し、結果を観察することで、コード変更が期待通りに機能することを確認します。テストまたは型チェックに依存するのではなく。[アプリを実行して検証](/ja/skills#run-and-verify-your-app)を参照してください。{/* min-version: 2.1.145 */}Claude Code v2.1.145 以降が必要です |148| `/verify` | **[スキル](/ja/skills#bundled-skills)。** プロジェクトのアプリをビルドして実行し、結果を観察することで、コード変更が期待通りに機能することを確認します。テストまたは型チェックに依存するのではなく。[アプリを実行して検証](/ja/skills#run-and-verify-your-app)を参照してください。{{/* min-version: 2.1.145 */}}Claude Code v2.1.145 以降が必要です |

149| `/vim` | {/* max-version: 2.1.91 */}v2.1.92 で削除。Vim と通常編集モード間を切り替えるには、`/config` → エディタモードを使用してください |149| `/vim` | {{/* max-version: 2.1.91 */}}v2.1.92 で削除。Vim と通常編集モード間を切り替えるには、`/config` → エディタモードを使用してください |

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

151| `/web-setup` | ローカル `gh` CLI 認証情報を使用して GitHub アカウントを [Claude Code on the web](/ja/web-quickstart#connect-from-your-terminal) に接続します。GitHub が接続されていない場合、`/schedule` は自動的にこれを求めます |151| `/web-setup` | ローカル `gh` CLI 認証情報を使用して GitHub アカウントを [Claude Code on the web](/ja/web-quickstart#connect-from-your-terminal) に接続します。GitHub が接続されていない場合、`/schedule` は自動的にこれを求めます |

152| `/workflows` | [ワークフロー](/ja/workflows#watch-the-run)進捗ビューを開いて、実行中および完了したワークフローを監視、一時停止、再開、または保存します |152| `/workflows` | [ワークフロー](/ja/workflows#watch-the-run)進捗ビューを開いて、実行中および完了したワークフローを監視、一時停止、再開、または保存します |

Details

255 </Step>255 </Step>

256</Steps>256</Steps>

257 257 

258`gh pr create` を使用して PR を作成すると、セッションはその PR に自動的にリンクされます。後で `claude --from-pr <number>` で再開するか、[`/resume` ピッカー](/ja/sessions#use-the-session-picker)の検索に PR URL を貼り付けることで再開できます。258`gh pr create` を使用して PR を作成すると、セッションはその PR に自動的にリンクされます。後で `claude --from-pr 123` で再開するか(123 を PR 番号に置き換えます)、[`/resume` ピッカー](/ja/sessions#use-the-session-picker)の検索に PR URL を貼り付けることで再開できます。

259 259 

260<Tip>260<Tip>

261 Claude が生成した PR を送信する前にレビューし、Claude に潜在的なリスクや考慮事項を強調するよう依頼してください。261 Claude が生成した PR を送信する前にレビューし、Claude に潜在的なリスクや考慮事項を強調するよう依頼してください。

Details

327時々、Claude に編集する前に尋ねてもらいたいことがあります。時々、327時々、Claude に編集する前に尋ねてもらいたいことがあります。時々、

328それを出荷させたいだけです。永遠に 1 つを選ぶ必要はありません。328それを出荷させたいだけです。永遠に 1 つを選ぶ必要はありません。

329 329 

330*Shift+Tab* は Claude が得るリーシュの量を循環させます:*default* 330*Shift+Tab* は Claude が得る権限の量を循環させます。*Manual*(`default` 設定値)

331危険なものの前に尋ねます、*acceptEdits* はファイル編集と一般的なファイル331は各アクションの前に尋ね、*acceptEdits* はファイル編集と一般的なファイル

332システムコマンドがフローを通して流れることを許可しながら、他のシェル332システムコマンドがフローを通して流れることを許可しながら、他のシェル

333コマンドの前にチェックし、*plan* は何かに触れる前に承認のための変更を333コマンドの前にチェックし、*plan* は何かに触れる前に承認のための変更を

334提案します。Plan モードは信頼構築者なので、複数のファイルに触れるもの334提案します。Plan モードは信頼構築者なので、複数のファイルに触れるもの


338を押してから、変更を説明してください。単一のファイルが移動する前に完全な338を押してから、変更を説明してください。単一のファイルが移動する前に完全な

339提案が得られます。339提案が得られます。

340 340 

341📖 許可モード → https://code.claude.com/docs/ja/permissions341📖 権限モード → https://code.claude.com/docs/ja/permissions

342```342```

343 343 

344**チェックポイントと `/rewind`**344**チェックポイントと `/rewind`**

computer-use.md +1 −1

Details

240* macOS を使用しています。コンピュータ使用は Linux または Windows では利用できません。Windows では、代わりに [Desktop でのコンピュータ使用](/ja/desktop#let-claude-use-your-computer)を使用してください。240* macOS を使用しています。コンピュータ使用は Linux または Windows では利用できません。Windows では、代わりに [Desktop でのコンピュータ使用](/ja/desktop#let-claude-use-your-computer)を使用してください。

241* Claude Code v2.1.85 以降を実行しています。`claude --version` を実行して確認します。241* Claude Code v2.1.85 以降を実行しています。`claude --version` を実行して確認します。

242* Pro または Max プランを使用しています。`/status` を実行してサブスクリプションを確認します。242* Pro または Max プランを使用しています。`/status` を実行してサブスクリプションを確認します。

243* claude.ai を通じて認証されています。コンピュータ使用は Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry などのサードパーティプロバイダーでは利用できません。サードパーティプロバイダーのみを通じて Claude にアクセスする場合、この機能を使用するには別の claude.ai アカウントが必要です。243* claude.ai を通じて認証されています。コンピュータ使用は Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry などのサードパーティプロバイダーでは利用できません。サードパーティプロバイダーのみを通じて Claude にアクセスする場合、この機能を使用するには別の claude.ai アカウントが必要です。

244* インタラクティブセッションを使用しています。コンピュータ使用は `-p` フラグを使用した非インタラクティブモードでは利用できません。244* インタラクティブセッションを使用しています。コンピュータ使用は `-p` フラグを使用した非インタラクティブモードでは利用できません。

245 245 

246<h2 id="see-also">246<h2 id="see-also">

costs.md +1 −1

Details

51 カスタムレート制限を持つ組織の場合、このワークスペースの Claude Code トラフィックは組織全体の API レート制限にカウントされます。Claude Console の Limits ページでこのワークスペースに [ワークスペースレート制限](https://platform.claude.com/docs/ja/api/rate-limits#setting-lower-limits-for-workspaces) を設定して、Claude Code の共有をキャップし、他の本番ワークロードを保護できます。51 カスタムレート制限を持つ組織の場合、このワークスペースの Claude Code トラフィックは組織全体の API レート制限にカウントされます。Claude Console の Limits ページでこのワークスペースに [ワークスペースレート制限](https://platform.claude.com/docs/ja/api/rate-limits#setting-lower-limits-for-workspaces) を設定して、Claude Code の共有をキャップし、他の本番ワークロードを保護できます。

52</Note>52</Note>

53 53 

54Bedrock、Vertex、および Foundry では、Claude Code はクラウドからメトリクスを送信しません。セルフホストされた [Claude apps gateway](/ja/claude-apps-gateway) は、ユーザーごとの使用状況の帰属、トークンカウント付きの OTLP メトリクス、およびこれらのプロバイダーの [ユーザーごとの支出制限](/ja/claude-apps-gateway-spend-limits) を提供します。別の [LLM gateway](/ja/llm-gateway) を通じて Claude Code をルーティングしている組織は、ゲートウェイがすべてのリクエストを確認するため、そこでコストを追跡できます。54Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry では、Claude Code はクラウドからメトリクスを送信しません。セルフホストされた [Claude apps gateway](/ja/claude-apps-gateway) は、ユーザーごとの使用状況の帰属、トークンカウント付きの OTLP メトリクス、およびこれらのプロバイダーの [ユーザーごとの支出制限](/ja/claude-apps-gateway-spend-limits) を提供します。別の [LLM gateway](/ja/llm-gateway) を通じて Claude Code をルーティングしている組織は、ゲートウェイがすべてのリクエストを確認するため、そこでコストを追跡できます。

55 55 

56<h3 id="rate-limit-recommendations">56<h3 id="rate-limit-recommendations">

57 レート制限の推奨事項57 レート制限の推奨事項

data-usage.md +8 −8

Details

23 Development Partner Program23 Development Partner Program

24</h3>24</h3>

25 25 

26[Development Partner Program](https://support.claude.com/ja/articles/11174108-about-the-development-partner-program) などを通じて、トレーニング用の資料を提供する方法に明示的にオプトインした場合、提供された資料を使用してモデルをトレーニングする可能性があります。組織管理者は、組織の Development Partner Program に明示的にオプトインできます。このプログラムは Anthropic ファーストパーティ API でのみ利用可能であり、Bedrock または Vertex ユーザーは利用できないことに注意してください。26[Development Partner Program](https://support.claude.com/ja/articles/11174108-about-the-development-partner-program) などを通じて、トレーニング用の資料を提供する方法に明示的にオプトインした場合、提供された資料を使用してモデルをトレーニングする可能性があります。組織管理者は、組織の Development Partner Program に明示的にオプトインできます。このプログラムは Anthropic ファーストパーティ API でのみ利用可能であり、Amazon Bedrock または Google Cloud の Agent Platform ユーザーは利用できないことに注意してください。

27 27 

28<h3 id="feedback-using-the-/feedback-command">28<h3 id="feedback-using-the-/feedback-command">

29 `/feedback` コマンドを使用したフィードバック29 `/feedback` コマンドを使用したフィードバック


39 39 

40数値評価プロンプトの後、「Can Anthropic look at your session transcript to help us improve Claude Code?」と尋ねる別の追加フォローアップが表示される場合があります。これは数値評価とは異なるオプションの 2 番目のステップです。40数値評価プロンプトの後、「Can Anthropic look at your session transcript to help us improve Claude Code?」と尋ねる別の追加フォローアップが表示される場合があります。これは数値評価とは異なるオプションの 2 番目のステップです。

41 41 

42* **Yes**:会話トランスクリプト、サブエージェントトランスクリプト、ディスクからの生のセッションログファイルを Anthropic にアップロードします。既知の API キーとトークンパターンはアップロード前に削除されます。ソースコード、ファイルコンテンツ、およびその他の会話コンテンツはそのままアップロードされます。共有されたトランスクリプトは最大 6 ヶ月間保持されます。Bedrock、Vertex AI、Foundry、およびサインイン済みの [Claude apps gateway](/ja/claude-apps-gateway) セッションでは、Yes は同じペイロードを `~/.claude/feedback-bundles/` の下のローカルアーカイブに書き込みます。アップロードの代わりに、ファイルを転送するまで何もマシンから出ません。42* **Yes**:会話トランスクリプト、サブエージェントトランスクリプト、ディスクからの生のセッションログファイルを Anthropic にアップロードします。既知の API キーとトークンパターンはアップロード前に削除されます。ソースコード、ファイルコンテンツ、およびその他の会話コンテンツはそのままアップロードされます。共有されたトランスクリプトは最大 6 ヶ月間保持されます。Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、およびサインイン済みの [Claude apps gateway](/ja/claude-apps-gateway) セッションでは、Yes は同じペイロードを `~/.claude/feedback-bundles/` の下のローカルアーカイブに書き込みます。アップロードの代わりに、ファイルを転送するまで何もマシンから出ません。

43* **No**:何も送信せずに拒否します43* **No**:何も送信せずに拒否します

44* **Don't ask again**:拒否し、今後のセッションでこのフォローアップが表示されなくなります44* **Don't ask again**:拒否し、今後のセッションでこのフォローアップが表示されなくなります

45 45 


90保存時の暗号化はモデルプロバイダーによって異なります:90保存時の暗号化はモデルプロバイダーによって異なります:

91 91 

92| プロバイダー | 保存時の暗号化 |92| プロバイダー | 保存時の暗号化 |

93| ---------------------- | --------------------------------------------------------------------------------------------------------- |93| ----------------------------- | --------------------------------------------------------------------------------------------------------- |

94| Anthropic API | インフラストラクチャレベルのディスク暗号化(AES-256)。サーバー側の永続化がない場合は [Zero Data Retention](/ja/zero-data-retention) を有効にしてください。 |94| Anthropic API | インフラストラクチャレベルのディスク暗号化(AES-256)。サーバー側の永続化がない場合は [Zero Data Retention](/ja/zero-data-retention) を有効にしてください。 |

95| Amazon Bedrock | AWS 管理キーを使用した AES-256。AWS KMS を通じてカスタマー管理キーが利用可能です。 |95| Amazon Bedrock | AWS 管理キーを使用した AES-256。AWS KMS を通じてカスタマー管理キーが利用可能です。 |

96| Google Cloud Vertex AI | Google 管理の暗号化キー。CMEK が利用可能です。 |96| Google Cloud's Agent Platform | Google 管理の暗号化キー。CMEK が利用可能です。 |

97| Microsoft Foundry | リクエストは AES-256 ディスク暗号化を備えた Anthropic インフラストラクチャにルーティングされます。 |97| Microsoft Foundry | リクエストは AES-256 ディスク暗号化を備えた Anthropic インフラストラクチャにルーティングされます。 |

98 98 

99Claude Code は Anthropic の API 上に構築されています。API のセキュリティ制御(API ロギング手順を含む)の詳細については、[Anthropic Trust Center](https://trust.anthropic.com) のコンプライアンスアーティファクトを参照してください。99Claude Code は Anthropic の API 上に構築されています。API のセキュリティ制御(API ロギング手順を含む)の詳細については、[Anthropic Trust Center](https://trust.anthropic.com) のコンプライアンスアーティファクトを参照してください。


121 121 

122`/feedback` コマンドを実行すると、コードを含む会話履歴のコピーが Anthropic に送信されます。送信前に、含める履歴の量を選択できます。デフォルトは現在のセッションのみですが、同じプロジェクトの過去 24 時間または 7 日間の他のセッションも含めることができます。データは TLS 経由で転送中に暗号化され、Google Cloud Storage に保存されます。Google Cloud Storage はデフォルトで保存時のデータを暗号化します。オプションで、公開リポジトリに 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 アカウント担当者にファイルを送信するか、サポートリクエストに添付するまで、何もマシンから出ません。124Amazon Bedrock や Google Cloud の Agent Platform などのサードパーティプロバイダーを使用している場合、または Anthropic 認証情報が設定されていない場合、`/feedback` はレポートを Anthropic に送信する代わりに、`~/.claude/feedback-bundles/` の下のローカルアーカイブに書き込みます。既知の API キーおよびトークンパターンは、アーカイブが書き込まれる前に削除されます。Anthropic アカウント担当者にファイルを送信するか、サポートリクエストに添付するまで、何もマシンから出ません。

125 125 

126<h2 id="default-behaviors-by-api-provider">126<h2 id="default-behaviors-by-api-provider">

127 API プロバイダーのデフォルト動作127 API プロバイダーのデフォルト動作

128</h2>128</h2>

129 129 

130デフォルトでは、Bedrock、Vertex、Foundry、または Claude Platform on AWS を使用する場合、エラーレポート、テレメトリ、およびバグレポートは無効になります。セッション品質調査と WebFetch ドメインセーフティチェックは例外であり、プロバイダーに関係なく実行されます。署名済みの [Claude apps gateway](/ja/claude-apps-gateway) セッションでは、Anthropic への使用分析、エラーレポート、および調査評価はゲートウェイ認証情報自体によって無効になり、それらを再度有効にする設定はありません。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` を設定することで、調査を含むすべての非必須トラフィックをオプトアウトできます。この変数は WebFetch チェックに影響を与えません。WebFetch チェックには独自のオプトアウトがあります。以下は完全なデフォルト動作です:130デフォルトでは、Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、または Claude Platform on AWS を使用する場合、エラーレポート、テレメトリ、およびバグレポートは無効になります。セッション品質調査と WebFetch ドメインセーフティチェックは例外であり、プロバイダーに関係なく実行されます。署名済みの [Claude apps gateway](/ja/claude-apps-gateway) セッションでは、Anthropic への使用分析、エラーレポート、および調査評価はゲートウェイ認証情報自体によって無効になり、それらを再度有効にする設定はありません。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` を設定することで、調査を含むすべての非必須トラフィックをオプトアウトできます。この変数は WebFetch チェックに影響を与えません。WebFetch チェックには独自のオプトアウトがあります。以下は完全なデフォルト動作です:

131 131 

132| サービス | Claude API | Vertex API | Bedrock API | Foundry API | Claude Platform on AWS |132| サービス | Claude API | Google Cloud の Agent Platform API | Amazon Bedrock API | Microsoft Foundry API | Claude Platform on AWS |

133| -------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |133| -------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |

134| **Anthropic(メトリクス)** | デフォルトオン。<br />`DISABLE_TELEMETRY=1` で無効にします。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_VERTEX` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_BEDROCK` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_FOUNDRY` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` は 1 である必要があります。 |134| **Anthropic(メトリクス)** | デフォルトオン。<br />`DISABLE_TELEMETRY=1` で無効にします。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_VERTEX` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_BEDROCK` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_FOUNDRY` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` は 1 である必要があります。 |

135| **Sentry(エラー)** | デフォルトオン。<br />`DISABLE_ERROR_REPORTING=1` で無効にします。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_VERTEX` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_BEDROCK` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_FOUNDRY` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` は 1 である必要があります。 |135| **Sentry(エラー)** | デフォルトオン。<br />`DISABLE_ERROR_REPORTING=1` で無効にします。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_VERTEX` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_BEDROCK` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_FOUNDRY` は 1 である必要があります。 | デフォルトオフ。<br />`CLAUDE_CODE_USE_ANTHROPIC_AWS` は 1 である必要があります。 |


139 139 

140すべての環境変数は `settings.json` にチェックインできます([settings reference](/ja/settings) を参照)。140すべての環境変数は `settings.json` にチェックインできます([settings reference](/ja/settings) を参照)。

141 141 

142v2.1.126 以降、ホストプラットフォームが `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` を設定する場合、メトリクスは Vertex、Bedrock、および Foundry でデフォルトでオンになり、標準の `DISABLE_TELEMETRY` オプトアウトに従います。Sentry エラーレポートと `/feedback` レポートは、これらのプロバイダーではデフォルトでオフのままです。142v2.1.126 以降、ホストプラットフォームが `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` を設定する場合、メトリクスは Google Cloud の Agent PlatformAmazon Bedrock、および Microsoft Foundry でデフォルトでオンになり、標準の `DISABLE_TELEMETRY` オプトアウトに従います。Sentry エラーレポートと `/feedback` レポートは、これらのプロバイダーではデフォルトでオフのままです。

143 143 

144<h3 id="webfetch-domain-safety-check">144<h3 id="webfetch-domain-safety-check">

145 WebFetch ドメインセーフティチェック145 WebFetch ドメインセーフティチェック

Details

19特定のカテゴリの詳細については、専用コマンドで確認してください:19特定のカテゴリの詳細については、専用コマンドで確認してください:

20 20 

21| コマンド | 表示内容 |21| コマンド | 表示内容 |

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

23| `/memory` | 読み込まれた `CLAUDE.md` とルールファイル、およびオートメモリエントリ |23| `/memory` | 読み込まれた `CLAUDE.md` とルールファイル、およびオートメモリエントリ |

24| `/skills` | プロジェクト、ユーザー、プラグインソースから利用可能なスキル |24| `/skills` | プロジェクト、ユーザー、プラグインソースから利用可能なスキル |

25| `/hooks` | アクティブなフック設定 |25| `/hooks` | アクティブなフック設定 |

26| `/mcp` | 接続された MCP サーバーとそのステータス |26| `/mcp` | 接続された MCP サーバーとそのステータス |

27| `/permissions` | 現在有効な許可と拒否ルール |27| `/permissions` | 現在有効な許可と拒否ルール |

28| `/doctor` | 設定診断無効なキースキーマエラーインストール状態。{/* min-version: 2.1.196 */}v2.1.196 以降同じスコープで定義された重複する [サブエージェント](/ja/sub-agents) 名も報告しどれがアクティブかをマークします |28| `/doctor` | セットアップチェックインストール状態無効な設定ファイル未使用の拡張機能同じディレクトリ内の重複する [サブエージェント](/ja/sub-agents) および提案される修正 |

29| `/debug [issue]` | セッションのデバッグログを有効にし、Claude にログ出力と設定パスを使用して診断するよう促します |29| `/debug [issue]` | セッションのデバッグログを有効にし、Claude にログ出力と設定パスを使用して診断するよう促します |

30| `/status` | アクティブな設定ソース(マネージド設定が有効かどうかを含む) |30| `/status` | アクティブな設定ソース(マネージド設定が有効かどうかを含む) |

31 31 


45 45 

46設定はマネージド、ユーザー、プロジェクト、ローカルスコープ全体でマージされます。マネージド設定が存在する場合は常に優先されます。その他の場合、より近いスコープが、ローカル、プロジェクト、ユーザーの順序でより広いスコープをオーバーライドします。一部の設定は、コマンドラインフラグまたは [環境変数](/ja/env-vars) で設定することもでき、これは別のオーバーライドレイヤーとして機能します。設定が適用されないように見える場合、設定した値は通常、別のスコープまたは環境変数によってオーバーライドされています。46設定はマネージド、ユーザー、プロジェクト、ローカルスコープ全体でマージされます。マネージド設定が存在する場合は常に優先されます。その他の場合、より近いスコープが、ローカル、プロジェクト、ユーザーの順序でより広いスコープをオーバーライドします。一部の設定は、コマンドラインフラグまたは [環境変数](/ja/env-vars) で設定することもでき、これは別のオーバーライドレイヤーとして機能します。設定が適用されないように見える場合、設定した値は通常、別のスコープまたは環境変数によってオーバーライドされています。

47 47 

48`/doctor` を実行して設定ファイルを検証し無効なキーまたはスキーマエラーを表示します。`/doctor` が問題を報告する場合は、`f` を押して診断レポートを Claude に送信し、修正を一緒に進めてもらいます48`/doctor` を実行して設定とインストールを確認します。無効な設定ファイル重複したインストール、未使用の拡張機能など、検出した内容をレポートし、確認後にのみ適用される修正を提案しますv2.1.205 より前では、`/doctor` は読み取り専用の診断画面を開き、`f` を押すとレポートが Claude に送信されて修正されました

49 

50ターミナルから、`claude doctor` はセッションを開始せずに、読み取り専用のインストールと設定の診断をプリントします。

49 51 

50`/status` を実行して、マネージド設定が有効かどうかを含む、どの設定ソースがアクティブかを確認します。特定のキーに対してどのスコープが優先されるかを理解するには、[スコープの相互作用方法](/ja/settings#how-scopes-interact) を参照してください。52`/status` を実行して、マネージド設定が有効かどうかを含む、どの設定ソースがアクティブかを確認します。特定のキーに対してどのスコープが優先されるかを理解するには、[スコープの相互作用方法](/ja/settings#how-scopes-interact) を参照してください。

51 53 


67 69 

68`/hooks` を実行して、現在のセッションに登録されているすべてのフックをイベント別にグループ化して一覧表示します。定義したフックが表示されない場合、それは読み込まれていません:hooks は設定ファイルの `"hooks"` キーの下に置かれ、スタンドアロンファイルではありません。70`/hooks` を実行して、現在のセッションに登録されているすべてのフックをイベント別にグループ化して一覧表示します。定義したフックが表示されない場合、それは読み込まれていません:hooks は設定ファイルの `"hooks"` キーの下に置かれ、スタンドアロンファイルではありません。

69 71 

70フックが表示されても発火しない場合、通常の原因はマッチャーです。`matcher` フィールドは、複数のツール名をマッチするために `|` を使用する単一の文字列です。例えば `"Edit|Write"` です。{/* min-version: 2.1.191 */}Claude Code v2.1.191 以降では、`,` もセパレータとして機能するため、`"Edit,Write"` は同等です。それより前のバージョンではカンマは正規表現評価にフォールスルーし、マッチャーは一致しないため、v2.1.191 をまだ使用していない場合は `|` を使用してください。ツール名のスペルミスはマッチャーが一致しないため、サイレントに失敗します。配列値はスキーマエラーですClaude Code は設定エラー通知を表示し、`/doctor` は検証失敗を報告し、フックエントリは削除されるため `/hooks` に表示されません。72フックが表示されても発火しない場合、通常の原因はマッチャーです。以下の間違いがないか確認してください

73 

74* `matcher` フィールドは、複数のツール名をマッチするために `|` を使用する単一の文字列です。例えば `"Edit|Write"` です。{/* min-version: 2.1.191 */}`,` セパレータは同等であるため、`"Edit,Write"` は同じツールをマッチします。v2.1.191 より前では、カンマは正規表現評価にフォールスルーし、マッチャーは一致しないため、v2.1.191 をまだ使用していない場合は `|` を使用してください。

75* ツール名のスペルミスはマッチャーが何もマッチしないため、フックはサイレントに失敗します。

76* 配列値はスキーマエラーです:Claude Code は設定エラー通知を表示し、ユーザー、プロジェクト、またはローカル設定ファイル全体を拒否し、`claude doctor` は検証失敗を報告し、そのファイルからのフックは `/hooks` に表示されません。[管理設定](/ja/settings#settings-files)では、無効なエントリのみが削除され、ファイルの他のフックは引き続き適用されます。

71 77 

72`settings.json` への編集は、短いファイル安定性遅延後に実行中のセッションで有効になります。再起動する必要はありません。保存後数秒経っても `/hooks` が古い定義を表示している場合は、`/hooks` を再度実行してビューをリフレッシュします78`settings.json` への編集は、短いファイル安定性遅延後に実行中のセッションで有効になります。再起動する必要はありません。保存後数秒経っても `/hooks` が古い定義を表示している場合は、`/hooks` を再度実行してビューをリフレッシュしてください

73 79 

74`/hooks` がフックを表示しても発火しない場合、次のステップはフック評価をライブで監視することです。`claude --debug hooks` でセッションを開始し、ツール呼び出しをトリガーします。デバッグログは各イベント、チェックされたマッチャー、フックの終了コードと出力を記録します。ログ形式については [フックをデバッグする](/ja/hooks#debug-hooks) を、一般的な失敗パターンについては [hooks トラブルシューティング](/ja/hooks-guide#limitations-and-troubleshooting) を参照してください。80`/hooks` がフックを表示しても発火しない場合、次のステップはフック評価をライブで監視することです。`claude --debug hooks` でセッションを開始し、ツール呼び出しをトリガーします。デバッグログは各イベント、チェックされたマッチャー、フックの終了コードと出力を記録します。ログ形式については [フックをデバッグする](/ja/hooks#debug-hooks) を、一般的な失敗パターンについては [hooks トラブルシューティング](/ja/hooks-guide#limitations-and-troubleshooting) を参照してください。

75 81 


77 クリーン設定に対してテストする83 クリーン設定に対してテストする

78</h2>84</h2>

79 85 

80{/* min-version: 2.1.169 */}[`claude --safe-mode`](/ja/cli-reference#cli-flags) で開始します。これにより、`CLAUDE.md`、skills、plugins、hooks、MCP サーバー、カスタムコマンド、エージェントを含むすべてのカスタマイズが無効になった状態でセッションが起動します。認証、モデル選択、組み込みツール、権限は通常通り機能します。セーフモードで問題が消える場合、これらのサーフェスのいずれかが原因です。上記のターゲット化されたチェックを使用して、どれが原因かを特定してください。組織によってデプロイされたマネージド設定は部分的に適用されるためポリシー設定された hooks とステータスラインはセーフモードでも実行されます86{/* min-version: 2.1.169 */}[`claude --safe-mode`](/ja/cli-reference#cli-flags) で開始します。これにより、`CLAUDE.md`、skills、plugins、hooks、MCP サーバー、カスタムコマンド、エージェントを含むすべてのカスタマイズが無効になった状態でセッションが起動します。認証、モデル選択、組み込みツール、権限は通常通り機能します。セーフモードで問題が消える場合、これらのサーフェスのいずれかが原因です。上記のターゲット化されたチェックを使用して、どれが原因かを特定してください。セーフモードは組織からのマネージド hooks と設定ポリシーを引き続き適用しますマネージド plugins、skills、`CLAUDE.md`、MCP サーバーはオフになります。

81 87 

82セーフモードで問題が続く場合、または設定自体が疑わしい場合は、通常のセットアップから何も読み込まないセッションと比較してください。[`CLAUDE_CONFIG_DIR`](/ja/env-vars) を空のディレクトリに指定して `~/.claude` の下のすべてをバイパスし、`.claude` フォルダ、`.mcp.json`、または `CLAUDE.md` がないディレクトリから起動して、プロジェクト設定もスキップします。88セーフモードで問題が続く場合、または設定自体が疑わしい場合は、通常のセットアップから何も読み込まないセッションと比較してください。[`CLAUDE_CONFIG_DIR`](/ja/env-vars) を空のディレクトリに指定して `~/.claude` の下のすべてをバイパスし、`.claude` フォルダ、`.mcp.json`、または `CLAUDE.md` がないディレクトリから起動して、プロジェクト設定もスキップします。

83 89 

desktop.md +60 −26

Details

78 権限モードを選択する78 権限モードを選択する

79</h3>79</h3>

80 80 

81権限モードは、セッション中に Claude がどの程度の自律性を持つかを制御します:ファイルの編集、コマンドの実行、またはその両方の前に確認するかどうかです。送信ボタンの横のモードセレクタを使用して、いつでもモードを切り替えることができます。Ask permissions で開始して Claude が実行する内容を正確に確認してから、慣れてきたら Auto accept edits または Plan mode に移動します。81権限モードは、セッション中に Claude がどの程度の自律性を持つかを制御します:ファイルの編集、コマンドの実行、またはその両方の前に確認するかどうかです。送信ボタンの横のモードセレクタを使用して、いつでもモードを切り替えることができます。Manual で開始して Claude が実行する内容を正確に確認してから、慣れてきたら Accept edits または Plan に移動します。

82 82 

83| モード | 設定キー | 動作 |83| モード | 設定キー | 動作 |

84| ---------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |84| ---------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

85| **Ask permissions** | `default` | Claude はファイルの編集またはコマンドの実行の前に確認を求めます。diff を確認し、各変更を受け入れるか拒否できます。新規ユーザーに推奨されます。 |85| **Manual** | `default` | Claude はファイルの編集またはコマンドの実行の前に確認を求めます。diff を確認し、各変更を受け入れるか拒否できます。新規ユーザーに推奨されます。 |

86| **Auto accept edits** | `acceptEdits` | Claude はファイル編集と`mkdir`、`touch`、`mv`などの一般的なファイルシステムコマンドを自動的に受け入れますが、他のターミナルコマンドの実行前には確認を求めます。ファイル変更を信頼し、より高速な反復を望む場合に使用します。 |86| **Accept edits** | `acceptEdits` | Claude はファイル編集と`mkdir`、`touch`、`mv`などの一般的なファイルシステムコマンドを自動的に受け入れますが、他のターミナルコマンドの実行前には確認を求めます。ファイル変更を信頼し、より高速な反復を望む場合に使用します。 |

87| **Plan mode** | `plan` | Claude はファイルを読み取り、コマンドを実行して探索してから、ソースコードを編集せずにプランを提案します。アプローチを最初に確認したい複雑なタスクに適しています。 |87| **Plan** | `plan` | Claude はファイルを読み取り、コマンドを実行して探索してから、ソースコードを編集せずにプランを提案します。アプローチを最初に確認したい複雑なタスクに適しています。 |

88| **Auto** | `auto` | Claude はすべてのアクションをバックグラウンド安全チェック付きで実行し、リクエストとの整合性を確認します。権限プロンプトを削減しながら監視を維持します。Settings → Claude Code で有効にします。[利用可能性要件](#auto-mode-availability)以下を参照してください。 |88| **Auto** | `auto` | Claude はすべてのアクションをバックグラウンド安全チェック付きで実行し、リクエストとの整合性を確認します。権限プロンプトを削減しながら監視を維持します。Settings → Claude Code で有効にします。[利用可能性要件](#auto-mode-availability)以下を参照してください。 |

89| **Bypass permissions** | `bypassPermissions` | Claude は権限プロンプトなしで実行され、明示的な[ask ルール](/ja/permissions#manage-permissions)によって強制されるもの以外は、CLI の`--dangerously-skip-permissions`と同等です。Settings → Claude Code の「Allow bypass permissions mode」で有効にします。サンドボックス化されたコンテナまたは VM でのみ使用してください。エンタープライズ管理者はこのオプションを無効にできます。 |89| **Bypass permissions** | `bypassPermissions` | Claude は権限プロンプトなしで実行され、明示的な[ask ルール](/ja/permissions#manage-permissions)によって強制されるもの以外は、CLI の`--dangerously-skip-permissions`と同等です。Settings → Claude Code の「Allow bypass permissions mode」で有効にします。サンドボックス化されたコンテナまたは VM でのみ使用してください。エンタープライズ管理者はこのオプションを無効にできます。 |

90 90 

91Code タブの以前のバージョンでは、これらのモードを Ask permissions、Auto accept edits、および Plan mode というラベルが付けられていました。

92 

91`dontAsk`権限モードは[CLI](/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode)でのみ利用可能です。93`dontAsk`権限モードは[CLI](/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode)でのみ利用可能です。

92 94 

93<span id="auto-mode-availability" />95<span id="auto-mode-availability" />

94 96 

95Auto mode は Anthropic API のすべてのユーザーが利用できる研究プレビューです。Claude Opus 4.6 以降、または Sonnet 4.6 以降が必要です。Google Cloud Vertex AI にルーティングするエンタープライズデプロイメントでは、[`CLAUDE_CODE_ENABLE_AUTO_MODE`を設定](/ja/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry)するまで auto mode はオフになり、そこでは Claude Sonnet 5、Opus 4.7、および Opus 4.8 のみがサポートされています。97Auto mode は Anthropic API のすべてのユーザーが利用できる研究プレビューです。Claude Opus 4.6 以降、または Sonnet 4.6 以降が必要です。Google Cloud Agent Platform にルーティングするエンタープライズデプロイメントでは、[`CLAUDE_CODE_ENABLE_AUTO_MODE`を設定](/ja/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)するまで auto mode はオフになり、そこでは Claude Sonnet 5、Opus 4.7、および Opus 4.8 のみがサポートされています。

96 98 

97<Tip title="ベストプラクティス">99<Tip title="ベストプラクティス">

98 複雑なタスクを Plan mode で開始して、Claude が変更を加える前にアプローチをマップアウトするようにします。プランを承認したら、Auto accept edits または Ask permissions に切り替えて実行します。このワークフローの詳細については、[最初に探索してからプランしてからコード化する](/ja/best-practices#explore-first-then-plan-then-code)を参照してください。100 複雑なタスクを Plan で開始して、Claude が変更を加える前にアプローチをマップアウトするようにします。プランを承認したら、Accept edits または Manual に切り替えて実行します。このワークフローの詳細については、[最初に探索してからプランしてからコード化する](/ja/best-practices#explore-first-then-plan-then-code)を参照してください。

99</Tip>101</Tip>

100 102 

101クラウドセッションは Accept edits、Plan mode、および Auto mode をサポートしています。Accept edits は`default`モードに対応しています:クラウドセッションはファイル編集を事前に承認するため、セレクタは Ask permissions ではなく Accept edits を表示します。Bypass permissions はクラウド環境が既にサンドボックス化されているため利用できません。103クラウドセッションは Accept edits、Plan、および Auto をサポートしています。Accept edits は`default`モードに対応しています:クラウドセッションはファイル編集を事前に承認するため、セレクタは Manual ではなく Accept edits を表示します。Bypass permissions はクラウド環境が既にサンドボックス化されているため利用できません。

102 104 

103エンタープライズ管理者は利用可能な権限モードを制限できます。詳細については、[エンタープライズ設定](#enterprise-configuration)を参照してください。105エンタープライズ管理者は利用可能な権限モードを制限できます。詳細については、[エンタープライズ設定](#enterprise-configuration)を参照してください。

104 106 


106 アプリをプレビューする108 アプリをプレビューする

107</h3>109</h3>

108 110 

109Claude は dev サーバーを起動し、埋め込みブラウザを開いて変更を確認できます。これはフロントエンド Web アプリとバックエンドサーバーの両方で機能します:Claude は API エンドポイントをテストし、サーバーログを表示し、見つけた問題を反復処理できます。ほとんどの場合、Claude はプロジェクトファイルを編集した後、サーバーを自動的に起動します。いつでも Claude にプレビューを要求することもできます。デフォルトでは、Claude は編集後に[変更を自動検証](#auto-verify-changes)します。111Claude は dev サーバーを起動し、Browser ペインで開いて変更を確認できます。これはフロントエンド Web アプリとバックエンドサーバーの両方で機能します:Claude は API エンドポイントをテストし、サーバーログを表示し、見つけた問題を反復処理できます。ほとんどの場合、Claude はプロジェクトファイルを編集した後、サーバーを自動的に起動します。いつでも Claude にプレビューを要求することもできます。デフォルトでは、Claude は編集後に[変更を自動検証](#auto-verify-changes)します。

110 112 

111プレビューペインは、プロジェクトから静的 HTML ファイル、PDF、画像、およびビデオを開くこともできます。チャットで HTML、PDF、画像、またはビデオパスをクリックして、プレビューで開きます113Browser ペインは、プロジェクトから静的 HTML ファイル、PDF、画像、およびビデオを開くこともできます。チャットで HTML、PDF、画像、またはビデオパスをクリックして、Browser ペインで開きます

112 114 

113プレビューペインから、以下を実行できます:115Browser ペインから、以下を実行できます:

114 116 

115* 埋め込みブラウザで実行中のアプリと直接対話する117* Browser ペインで実行中のアプリと直接対話する

116* Claude が自動的に独自の変更を検証するのを監視する:スクリーンショットを撮影し、DOM を検査し、要素をクリックし、フォームに入力し、見つけた問題を修正します118* Claude が自動的に独自の変更を検証するのを監視する:スクリーンショットを撮影し、DOM を検査し、要素をクリックし、フォームに入力し、見つけた問題を修正します

117* セッションツールバーの**Preview**ドロップダウンからサーバーを開始または停止する119* セッションツールバーのサーバードロップダウンからサーバーを開始または停止する

118* ドロップダウンで**Persist sessions**を選択して、サーバーの再起動時にクッキーとローカルストレージを保持し、開発中に再度ログインする必要がないようにする120* ドロップダウンで**Persist sessions**を選択して、サーバーの再起動時にクッキーとローカルストレージを保持し、開発中に再度ログインする必要がないようにする

119* サーバー設定を編集するか、すべてのサーバーを一度に停止する121* サーバー設定を編集するか、すべてのサーバーを一度に停止する

120 122 

121Claude はプロジェクトに基づいて初期サーバー設定を作成します。アプリがカスタム dev コマンドを使用する場合、`.claude/launch.json`を編集してセットアップに合わせます。完全なリファレンスについては、[プレビューサーバーを設定する](#configure-preview-servers)を参照してください。123Claude はプロジェクトに基づいて初期サーバー設定を作成します。アプリがカスタム dev コマンドを使用する場合、`.claude/launch.json`を編集してセットアップに合わせます。完全なリファレンスについては、[プレビューサーバーを設定する](#configure-preview-servers)を参照してください。

122 124 

123保存されたセッションデータをクリアするには、Settings → Claude Code で**Persist preview sessions**をオフに切り替えます。プレビューを完全に無効にするには、Settings → Claude Code で**Preview**をオフに切り替えます。125保存されたセッションデータをクリアするには、Settings → Claude Code で**Persist sessions**をオフに切り替えます。Browser を完全に無効にするには、Settings → Claude Code で**Browser**をオフに切り替えます。

126 

127<h3 id="browse-external-sites">

128 外部サイトを閲覧する

129</h3>

130 

131Browser ペインはタブ付きブラウザなので、ドキュメント、issue トラッカー、または実行中のアプリの横に他のサイトを開くことができます。Browser を開くには、macOS で**Cmd+Shift+B**、Windows で**Ctrl+Shift+B**を押すか、**Views**メニューから選択します。チャットで外部リンクをクリックすると、Browser ペインを使用する**Open in app**または自分のブラウザを使用する**Default browser**を提供するチューザーが表示されます。macOS で**Cmd**キーを押しながらクリックするか、Windows で**Ctrl**キーを押しながらクリックすると、システムブラウザでリンクが直接開きます。Google OAuth などのポップアップサインインフローを含む、ペインのサイトにサインインできます。

132 

133Claude は[アプリを検証](#preview-your-app)するために使用するのと同じツールを使用して外部ページを読み取り、対話できます。2 つの追加の安全チェックがあります:

134 

135* 安全分類器は、すべての権限モードで、クリックやタイピングなど、外部ページでの Claude の書き込みアクションを確認します。これらは[auto mode](#choose-a-permission-mode)が使用するのと同じ分類器であり、アクションにフラグが立てられた場合、モードに関係なく権限プロンプトが表示されます。

136* Auto および Bypass permissions 以外の権限モードでは、Claude が新しいサイトに移動する前にドメイン許可リストチェックも適用されます。

137 

138<h4 id="approve-claude’s-actions-on-a-site">

139 サイトで Claude のアクションを承認する

140</h4>

141 

142Claude が外部サイトで初めてアクションを実行すると、権限カードが表示され、Claude は選択を待ちます:**Allow once**、**Always allow**、または**Deny**。**Allow once**は何も保存せずにアクションを承認します。**Always allow**はそのサイトの承認をデバイスに保存し、Settings で取り消すことができます。サブドメインを含む各サイトは独自の承認が必要です。ローカル dev サーバーとプロジェクトファイルは承認が不要なため、[auto-verify](#auto-verify-changes)はプロンプトなしで機能し続けます。

143 

144承認されたサイトでも、Claude はあなたの入力なしに商品を購入したり、アカウントを作成したり、CAPTCHA をバイパスしたりしません。Browser ペインでの閲覧は、[Claude in Chrome 拡張機能](/ja/chrome)と同じ安全モデルを使用します。Claude が機密サイトとリスクのあるアクションをどのように処理するかについては、[Claude in Chrome を安全に使用する](https://support.claude.com/en/articles/12902428-using-claude-in-chrome-safely)を参照してください。

145 

146<h4 id="choose-between-the-browser-and-the-chrome-extension">

147 Browser と Chrome 拡張機能を選択する

148</h4>

149 

150Browser ペインは、個人用ブラウザとは別の、保存されたログインや履歴がないクリーンなブラウザプロファイルを使用します。アプリの構築とテスト、および ID が不要なサイトに使用します。Claude があなたのログイン済みセッションであなたとして機能するようにしたい場合は、代わりにブラウザのログイン状態を共有する[Claude in Chrome 拡張機能](/ja/chrome)を使用します。

151 

152<h4 id="restrict-external-browsing-for-your-organization">

153 組織の外部閲覧を制限する

154</h4>

155 

156Browser は、Claude in Chrome 拡張機能と同じ[サイト許可リストとブロックリストコントロール](https://support.claude.com/en/articles/13065128-claude-in-chrome-admin-controls)に従います。組織が既に拡張機能用にこれらのリストを設定している場合、Browser は自動的にそれらを尊重します。管理者は、[`browserExternalPageTools`マネージド設定](#managed-settings)で外部ページの Claude のツールをオフにすることもできます。ツールが無効になっている場合、ユーザーは外部サイトに移動できます。Claude のツールはそれらを読み取ったり、アクションを実行したりできません。

124 157 

125<h3 id="review-changes-with-diff-view">158<h3 id="review-changes-with-diff-view">

126 diff ビューで変更を確認する159 diff ビューで変更を確認する


164 ワークスペースを配置する197 ワークスペースを配置する

165</h2>198</h2>

166 199 

167Code タブはペインを任意のレイアウトで配置できるように構築されています:チャット、diff、プレビュー、ターミナル、ファイル、プラン、タスク、およびサブエージェント。ペインをヘッダーでドラッグして位置を変更するか、ペインエッジをドラッグしてサイズを変更します。macOS では**Cmd+\\**を、Windows では**Ctrl+\\**を押してフォーカスされたペインを閉じます。セッションツールバーの**Views**メニューから追加のペインを開きます。200Code タブはペインを任意のレイアウトで配置できるように構築されています:チャット、diff、ブラウザ、ターミナル、ファイル、プラン、タスク、およびサブエージェント。ペインをヘッダーでドラッグして位置を変更するか、ペインエッジをドラッグしてサイズを変更します。macOS では**Cmd+\\**を、Windows では**Ctrl+\\**を押してフォーカスされたペインを閉じます。セッションツールバーの**Views**メニューから追加のペインを開きます。

168 201 

169<Note>202<Note>

170 このセクションのペインレイアウト、ターミナル、ファイルエディタ、およびビューモードには Claude Desktop v1.2581.0 以降が必要です。macOS では**Claude → Check for Updates**を、Windows では**Help → Check for Updates**を開いて更新してください。203 このセクションのペインレイアウト、ターミナル、ファイルエディタ、およびビューモードには Claude Desktop v1.2581.0 以降が必要です。macOS では**Claude → Check for Updates**を、Windows では**Help → Check for Updates**を開いて更新してください。


180 ファイルを開いて編集する213 ファイルを開いて編集する

181</h3>214</h3>

182 215 

183チャットまたは diff ビューアのファイルパスをクリックして、ファイルペインで開きます。HTML、PDF、画像、およびビデオパスは代わりに[プレビューペイン](#preview-your-app)で開きます。スポット編集を行い、**Save**をクリックして書き戻します。ファイルを開いてからディスク上で変更された場合、ペインは警告を表示し、オーバーライドまたは破棄できます。**Discard**をクリックして編集を元に戻すか、ペインヘッダーのパスをクリックして絶対パスをコピーします。216チャットまたは diff ビューアのファイルパスをクリックして、ファイルペインで開きます。HTML、PDF、画像、およびビデオパスは代わりに[ブラウザペイン](#preview-your-app)で開きます。スポット編集を行い、**Save**をクリックして書き戻します。ファイルを開いてからディスク上で変更された場合、ペインは警告を表示し、オーバーライドまたは破棄できます。**Discard**をクリックして編集を元に戻すか、ペインヘッダーのパスをクリックして絶対パスをコピーします。

184 217 

185ファイルペインはローカルおよび SSH セッションで利用可能です。クラウドセッションの場合、Claude に変更を加えるよう依頼します。218ファイルペインはローカルおよび SSH セッションで利用可能です。クラウドセッションの場合、Claude に変更を加えるよう依頼します。

186 219 


224| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | 次または前のセッション |257| `Cmd` `Shift` `]` / `Cmd` `Shift` `[` | 次または前のセッション |

225| `Esc` | Claude の応答を停止 |258| `Esc` | Claude の応答を停止 |

226| `Cmd` `Shift` `D` | diff ペインを切り替え |259| `Cmd` `Shift` `D` | diff ペインを切り替え |

227| `Cmd` `Shift` `P` | プレビューペインを切り替え |260| `Cmd` `Shift` `B` | ブラウザペインを切り替え |

228| `Cmd` `Shift` `S` | プレビューで要素を選択 |261| `Cmd` `Shift` `S` | ブラウザで要素を選択 |

229| `Ctrl` `` ` `` | ターミナルペインを切り替え |262| `Ctrl` `` ` `` | ターミナルペインを切り替え |

230| `Cmd` `\` | フォーカスされたペインを閉じる |263| `Cmd` `\` | フォーカスされたペインを閉じる |

231| `Cmd` `;` | サイドチャットを開く |264| `Cmd` `;` | サイドチャットを開く |


437 470 

438Claude は dev サーバーセットアップを自動的に検出し、セッションを開始するときに選択したフォルダのルートの`.claude/launch.json`に設定を保存します。Preview はこのフォルダを作業ディレクトリとして使用するため、親フォルダを選択した場合、独自の dev サーバーを持つサブフォルダは自動的に検出されません。サブフォルダのサーバーで作業するには、そのフォルダで直接セッションを開始するか、設定を手動で追加します。471Claude は dev サーバーセットアップを自動的に検出し、セッションを開始するときに選択したフォルダのルートの`.claude/launch.json`に設定を保存します。Preview はこのフォルダを作業ディレクトリとして使用するため、親フォルダを選択した場合、独自の dev サーバーを持つサブフォルダは自動的に検出されません。サブフォルダのサーバーで作業するには、そのフォルダで直接セッションを開始するか、設定を手動で追加します。

439 472 

440サーバーの起動方法をカスタマイズするには、たとえば`npm run dev`の代わりに`yarn dev`を使用するか、ポートを変更するには、ファイルを手動で編集するか、Preview ドロップダウンの**Edit configuration**をクリックしてコードエディタで開きます。ファイルはコメント付き JSON をサポートしています。473サーバーの起動方法をカスタマイズするには、たとえば`npm run dev`の代わりに`yarn dev`を使用するか、ポートを変更するには、ファイルを手動で編集するか、サーバードロップダウンの**Edit configuration**をクリックしてコードエディタで開きます。ファイルはコメント付き JSON をサポートしています。

441 474 

442```json theme={null}475```json theme={null}

443{476{


461 494 

462`autoVerify`が有効な場合、Claude はファイルを編集した後、コード変更を自動的に検証します。スクリーンショットを撮影し、エラーをチェックし、応答を完了する前に変更が機能することを確認します。495`autoVerify`が有効な場合、Claude はファイルを編集した後、コード変更を自動的に検証します。スクリーンショットを撮影し、エラーをチェックし、応答を完了する前に変更が機能することを確認します。

463 496 

464Auto-verify はデフォルトで有効です。`.claude/launch.json`に`"autoVerify": false`を追加してプロジェクトごとに無効にするか、**Preview**ドロップダウンメニューから切り替えます497Auto-verify はデフォルトで有効です。`.claude/launch.json`に`"autoVerify": false`を追加してプロジェクトごとに無効にするか、サーバードロップダウンメニューから切り替えます

465 498 

466```json theme={null}499```json theme={null}

467{500{


695 管理設定728 管理設定

696</h3>729</h3>

697 730 

698管理設定はプロジェクトおよびユーザー設定をオーバーライドし、Claude Code セッションに Desktop で適用されます。これらのキーを組織の[管理設定](/ja/settings#settings-precedence)ファイルで設定するか、管理コンソールを通じてリモートでプッシュできます。731管理設定はプロジェクトおよびユーザー設定をオーバーライドし、Desktop Claude Code セッションに適用されます。これらのキーを組織の[管理設定](/ja/settings#settings-precedence)ファイルで設定するか、管理コンソールを通じてリモートでプッシュできます。

699 732 

700| キー | 説明 |733| キー | 説明 |

701| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |734| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

702| `permissions.disableBypassPermissionsMode` | ユーザーが Bypass permissions モードを有効にするのを防ぐには`"disable"`に設定します。 |735| `permissions.disableBypassPermissionsMode` | ユーザーが Bypass permissions モードを有効にするのを防ぐには`"disable"`に設定します。 |

703| `disableAutoMode` | ユーザーが[Auto](/ja/permission-modes#eliminate-prompts-with-auto-mode)モードを有効にするのを防ぐには`"disable"`に設定します。モードセレクタから Auto を削除します。`permissions`の下でも受け入れられます。 |736| `disableAutoMode` | ユーザーが[Auto](/ja/permission-modes#eliminate-prompts-with-auto-mode)モードを有効にするのを防ぐには`"disable"`に設定します。モードセレクタから Auto を削除します。`permissions`の下でも受け入れられます。 |

704| `autoMode` | 組織全体で auto mode 分類器が信頼およびブロックするものをカスタマイズします。[auto mode を設定する](/ja/auto-mode-config)を参照してください。 |737| `autoMode` | 組織全体で auto mode 分類器が信頼およびブロックするものをカスタマイズします。[auto mode を設定する](/ja/auto-mode-config)を参照してください。 |

738| `browserExternalPageTools` | Claude が[Browser ペイン](#browse-external-sites)の外部ページを読み取るまたは操作するためのツールを使用するのを防ぐには`"disabled"`に設定します。ユーザーは引き続き外部サイトに自分でナビゲートできます。ローカル開発サーバープレビューは影響を受けません。 |

705| `sshConfigs` | 環境ドロップダウンに表示される[SSH 接続](#pre-configure-ssh-connections-for-your-team)を事前設定します。ユーザーは管理接続を編集または削除できません。 |739| `sshConfigs` | 環境ドロップダウンに表示される[SSH 接続](#pre-configure-ssh-connections-for-your-team)を事前設定します。ユーザーは管理接続を編集または削除できません。 |

706| `sshHostAllowlist` | [SSH セッション](#restrict-which-ssh-hosts-users-can-connect-to)を、解決されたホスト名がこれらのパターンのいずれかと一致するホストに制限します。空の配列は SSH セッションを無効にします。管理設定からのみ読み取られます。 |740| `sshHostAllowlist` | [SSH セッション](#restrict-which-ssh-hosts-users-can-connect-to)を、解決されたホスト名がこれらのパターンのいずれかと一致するホストに制限します。空の配列は SSH セッションを無効にします。管理設定からのみ読み取られます。 |

707| `managedMcpServers` | MCP サーバー設定をサードパーティデプロイメント内のすべてのユーザーにプッシュします。各エントリは`"http"`、`"sse"`、または`"stdio"`のトランスポート、接続詳細、およびオプションで、そのサーバー内のどのツールをユーザーが呼び出せるかを制限する`toolPolicy`マップを指定します。サードパーティ(3P)Desktop デプロイメントでのみ利用可能です。管理設定ファイルまたは MDM を通じてこのキーを配信してください。サードパーティデプロイメントは管理コンソール設定を受け取らないためです。 |741| `managedMcpServers` | MCP サーバー設定をサードパーティデプロイメント内のすべてのユーザーにプッシュします。各エントリは`"http"`、`"sse"`、または`"stdio"`のトランスポート、接続詳細、およびオプションで、そのサーバー内のどのツールをユーザーが呼び出せるかを制限する`toolPolicy`マップを指定します。サードパーティ(3P)Desktop デプロイメントでのみ利用可能です。管理設定ファイルまたは MDM を通じてこのキーを配信してください。サードパーティデプロイメントは管理コンソール設定を受け取らないためです。 |


754 788 

755既に Claude Code CLI を使用している場合、Desktop は同じ基盤となるエンジンをグラフィカルインターフェイスで実行します。同じマシン上で、同じプロジェクト上でも、両方を同時に実行できます。各々は個別のセッション履歴を保持しますが、CLAUDE.md ファイルを通じて設定とプロジェクトメモリを共有します。789既に Claude Code CLI を使用している場合、Desktop は同じ基盤となるエンジンをグラフィカルインターフェイスで実行します。同じマシン上で、同じプロジェクト上でも、両方を同時に実行できます。各々は個別のセッション履歴を保持しますが、CLAUDE.md ファイルを通じて設定とプロジェクトメモリを共有します。

756 790 

757CLI セッションを Desktop に移動するには、ターミナルで `/desktop` を実行します。Claude はセッションを保存し、デスクトップアプリで開いてから CLI を終了します。このコマンドは macOS と Windows でのみ利用可能です。Claude サブスクリプションでサインインしている場合に利用できます。API キー認証では利用できず、Bedrock、Vertex、Foundry でも利用できません。791CLI セッションを Desktop に移動するには、ターミナルで `/desktop` を実行します。Claude はセッションを保存し、デスクトップアプリで開いてから CLI を終了します。このコマンドは macOS と Windows でのみ利用可能です。Claude サブスクリプションでサインインしている場合に利用できます。API キー認証では利用できず、Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry でも利用できません。

758 792 

759<Tip>793<Tip>

760 Desktop と CLI をいつ使用するか:並列セッションをウィンドウで管理したい場合、ペインを並べて配置したい場合、または変更をビジュアルで確認したい場合は Desktop を使用します。スクリプト、自動化、またはターミナルワークフローが必要な場合は CLI を使用します。794 Desktop と CLI をいつ使用するか:並列セッションをウィンドウで管理したい場合、ペインを並べて配置したい場合、または変更をビジュアルで確認したい場合は Desktop を使用します。スクリプト、自動化、またはターミナルワークフローが必要な場合は CLI を使用します。


804このテーブルは、CLI と Desktop の間のコア機能を比較しています。CLI フラグの完全なリストについては、[CLI リファレンス](/ja/cli-reference)を参照してください。838このテーブルは、CLI と Desktop の間のコア機能を比較しています。CLI フラグの完全なリストについては、[CLI リファレンス](/ja/cli-reference)を参照してください。

805 839 

806| 機能 | CLI | Desktop |840| 機能 | CLI | Desktop |

807| --------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |841| --------------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

808| 権限モード | `dontAsk` を含むすべてのモード | Ask permissionsAuto accept edits、Plan mode、Auto、および Settings 経由の Bypass permissions |842| 権限モード | `dontAsk` を含むすべてのモード | ManualAccept edits、および Plan。Auto Bypass permissions は Settings で有効にした後、モードセレクタに表示されます |

809| `--dangerously-skip-permissions` | CLI フラグ | Bypass permissions モード。Settings → Claude Code → 「Allow bypass permissions mode」で有効にします |843| `--dangerously-skip-permissions` | CLI フラグ | Bypass permissions モード。Settings → Claude Code → 「Allow bypass permissions mode」で有効にします |

810| [サードパーティプロバイダー](/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)を参照してください。 |844| [サードパーティプロバイダー](/ja/third-party-integrations) | Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry | Anthropic の API がデフォルト。エンタープライズデプロイメントは Google Cloud の Agent Platform とゲートウェイプロバイダーを設定できます。[エンタープライズ設定ガイド](https://support.claude.com/en/articles/12622667-enterprise-configuration)を参照してください。Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、または自己ホスト型 LLM ゲートウェイで Code タブを実行するには、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)を参照してください。 |

811| [MCP サーバー](/ja/mcp) | 設定ファイルで設定 | ローカルおよび SSH セッションの Connectors UI、または設定ファイル |845| [MCP サーバー](/ja/mcp) | 設定ファイルで設定 | ローカルおよび SSH セッションの Connectors UI、または設定ファイル |

812| [Plugins](/ja/plugins) | `/plugin` コマンド | プラグインマネージャー UI |846| [Plugins](/ja/plugins) | `/plugin` コマンド | プラグインマネージャー UI |

813| @mention ファイル | テキストベース | オートコンプリート付き;ローカルおよび SSH セッションのみ |847| @mention ファイル | テキストベース | オートコンプリート付き;ローカルおよび SSH セッションのみ |


825 859 

826以下の機能は CLI または VS Code 拡張機能でのみ利用可能です。ただし、以下の場合を除きます:860以下の機能は CLI または VS Code 拡張機能でのみ利用可能です。ただし、以下の場合を除きます:

827 861 

828* **サードパーティプロバイダー**: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 タブを実行します。862* **サードパーティプロバイダー**:Desktop は Anthropic の API に直接接続します。エンタープライズデプロイメントは Google Cloud の Agent Platform とゲートウェイプロバイダーを [管理設定](https://support.claude.com/en/articles/12622667-enterprise-configuration)経由で設定できます。Amazon Bedrock または Microsoft Foundry の場合は、[クイックスタート](/ja/quickstart)を参照してください。上記のセクションの例外として、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)は Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、または自己ホスト型 LLM ゲートウェイで Code タブを実行します。

829* **Linux(ベータ版)**:Linux デスクトップアプリではコンピュータ使用はまだ利用できません。[Claude Desktop on Linux](/ja/desktop-linux)を参照してください。863* **Linux(ベータ版)**:Linux デスクトップアプリではコンピュータ使用はまだ利用できません。[Claude Desktop on Linux](/ja/desktop-linux)を参照してください。

830* **インラインコード提案**:Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。864* **インラインコード提案**:Desktop はオートコンプリートスタイルの提案を提供しません。会話型プロンプトと明示的なコード変更を通じて機能します。

831* **エージェントチーム**:並列 Claude Code セッションが互いにメッセージを送信するのは [CLI](/ja/agent-teams) で利用可能であり、Desktop では利用できません。1 つのセッション内でマルチエージェント作業を行う場合は、[動的ワークフロー](/ja/workflows)を使用します。これは Desktop で実行されます。865* **エージェントチーム**:並列 Claude Code セッションが互いにメッセージを送信するのは [CLI](/ja/agent-teams) で利用可能であり、Desktop では利用できません。1 つのセッション内でマルチエージェント作業を行う場合は、[動的ワークフロー](/ja/workflows)を使用します。これは Desktop で実行されます。

832* **ターミナルダイアログコマンド**:`/permissions``/config`、`/doctor` などのターミナルで対話型パネルを開く組み込みコマンドは、Code タブでは利用できず、`isn't available in this environment` で応答します。[設定ファイル](/ja/settings)を直接編集して権限ルールと設定を管理するか、スタンドアロン CLI からコマンドを実行します。866* **ターミナルダイアログコマンド**:`/permissions``/config` などのターミナルで対話型パネルを開く組み込みコマンドは、Code タブでは利用できず、`isn't available in this environment` で応答します。`/config` は `key=value` を渡すときに設定を設定します。例えば `/config theme=dark`;ピッカーフォームのみが利用できません。[設定ファイル](/ja/settings)を直接編集して権限ルールと設定を管理するか、スタンドアロン CLI からコマンドを実行します。

833 867 

834<h2 id="troubleshooting">868<h2 id="troubleshooting">

835 トラブルシューティング869 トラブルシューティング

desktop-linux.md +26 −2

Details

25 インストール25 インストール

26</h2>26</h2>

27 27 

28Anthropic の apt リポジトリからインストールして、更新がシステムの通常のパッケージ更新を通じて提供されるようにします。28Anthropic の apt リポジトリからインストールして、更新がシステムの通常のパッケージ更新を通じて提供されるようにします。ターミナルを開き、各ステップのコマンドを実行してください。

29 29 

30<Steps>30<Steps>

31 <Step title="Anthropic の apt リポジトリを追加する">31 <Step title="Anthropic の apt リポジトリを追加する">

32 このステップでは `curl` を使用して署名キーをダウンロードします。新しい Debian および Ubuntu インストールには `curl` が含まれていない場合があります。ダウンロードコマンドが `sudo: curl: command not found` で失敗する場合は、まず curl をインストールしてください。

33 

34 ```bash theme={null}

35 sudo apt install curl

36 ```

37 

32 Anthropic の署名キーをダウンロードします。38 Anthropic の署名キーをダウンロードします。

33 39 

34 ```bash theme={null}40 ```bash theme={null}


69 ダウンロードしたファイルからインストールする75 ダウンロードしたファイルからインストールする

70</h3>76</h3>

71 77 

72apt リポジトリを使用できない場合は、[claude.com/download](https://claude.com/download) からアーキテクチャ(x64 または arm64)に対応した `.deb` パッケージをダウンロードしてソフトウェアインストーラーで開くかダウンロードディレクトリから実行します78apt リポジトリを使用できない場合は、まず [claude.com/download](https://claude.com/download) からアーキテクチャ(x64 または arm64)に対応した `.deb` パッケージをダウンロードしてからダウンロードしたファイルをソフトウェアインストーラーで開くかダウンロードしたファイルが含まれているディレクトリから apt でインストールします

73 79 

74```bash theme={null}80```bash theme={null}

75sudo apt install ./claude-desktop_*.deb81sudo apt install ./claude-desktop_*.deb

76```82```

77 83 

84apt が `E: Unsupported file ./claude-desktop_*.deb given on commandline` を報告する場合、パターンが現在のディレクトリ内の `.deb` ファイルと一致しませんでした。ダウンロードが完了したことを確認してから、ファイルが含まれているディレクトリからコマンドを再度実行してください。

85 

78この方法でインストールされた `.deb` は更新を受け取りません。apt を通じて更新を取得するには、上記のようにリポジトリを追加するか、パッケージが `/etc/apt/sources.list.d/claude-desktop.list` に書き込むプレースホルダーエントリの `deb` 行をコメント解除します。86この方法でインストールされた `.deb` は更新を受け取りません。apt を通じて更新を取得するには、上記のようにリポジトリを追加するか、パッケージが `/etc/apt/sources.list.d/claude-desktop.list` に書き込むプレースホルダーエントリの `deb` 行をコメント解除します。

79 87 

80<h2 id="update">88<h2 id="update">


103sudo rm /etc/apt/sources.list.d/claude-desktop.list111sudo rm /etc/apt/sources.list.d/claude-desktop.list

104```112```

105 113 

114<h2 id="troubleshoot">

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

116</h2>

117 

118<h3 id="unable-to-locate-package-claude-desktop">

119 claude-desktop パッケージが見つからない

120</h3>

121 

122`sudo apt install claude-desktop` が `E: Unable to locate package claude-desktop` で失敗する場合、apt が追加したリポジトリを見つけられていません。以下を確認してください。

123 

124* リポジトリエントリが書き込まれたことを確認します。`cat /etc/apt/sources.list.d/claude-desktop.list` は [Anthropic の apt リポジトリを追加](#install) ステップの `deb` 行を表示する必要があります。ファイルが空または見つからない場合は、そのステップを再度実行してください。

125* アーキテクチャがサポートされていることを確認します。`dpkg --print-architecture` は `amd64` または `arm64` を出力する必要があります。リポジトリは他のアーキテクチャのパッケージを公開していません。

126* `sudo apt update` を再度実行し、`downloads.claude.ai` に関連するエラーの出力を確認します。そこでネットワークまたはキーエラーが発生している場合は、リポジトリが追加されましたが、到達またはベリファイできなかったことを意味します。

127 

128リポジトリが配置されており到達可能で、パッケージがまだ見つからない場合は、代わりに [ダウンロードしたファイルからインストール](#install-from-a-downloaded-file) してください。

129 

106<h2 id="what’s-not-in-the-linux-beta-yet">130<h2 id="what’s-not-in-the-linux-beta-yet">

107 Linux ベータ版にまだ含まれていない機能131 Linux ベータ版にまだ含まれていない機能

108</h2>132</h2>

Details

89 </Step>89 </Step>

90 90 

91 <Step title="変更をレビューして受け入れる">91 <Step title="変更をレビューして受け入れる">

92 デフォルトでは、Code タブは [Ask permissions モード](/ja/desktop#choose-a-permission-mode) で開始されます。このモードでは、Claude が変更を提案し、適用する前にあなたの承認を待ちます。以下が表示されます。92 デフォルトでは、Code タブは [Manual mode](/ja/desktop#choose-a-permission-mode) で開始されます。このモードでは、Claude が変更を提案し、適用する前にあなたの承認を待ちます。以下が表示されます。

93 93 

94 1. 各ファイルで何が変わるかを正確に示す [diff ビュー](/ja/desktop#review-changes-with-diff-view)94 1. 各ファイルで何が変わるかを正確に示す [diff ビュー](/ja/desktop#review-changes-with-diff-view)

95 2. 各変更を承認または拒否する Accept/Reject ボタン95 2. 各変更を承認または拒否する Accept/Reject ボタン


113 113 

114**コミット前に変更をレビューする。** Claude がファイルを編集した後、`+12 -1` インジケーターが表示されます。それをクリックして [diff ビュー](/ja/desktop#review-changes-with-diff-view)を開き、ファイルごとに変更をレビューし、特定の行にコメントします。Claude はあなたのコメントを読んで修正します。**Review code** をクリックして、Claude に diff を評価させ、インライン提案を残させます。114**コミット前に変更をレビューする。** Claude がファイルを編集した後、`+12 -1` インジケーターが表示されます。それをクリックして [diff ビュー](/ja/desktop#review-changes-with-diff-view)を開き、ファイルごとに変更をレビューし、特定の行にコメントします。Claude はあなたのコメントを読んで修正します。**Review code** をクリックして、Claude に diff を評価させ、インライン提案を残させます。

115 115 

116**コントロール量を調整する。** [権限モード](/ja/desktop#choose-a-permission-mode)は、バランスを制御します。Ask permissions(デフォルト)は、すべての編集の前に承認が必要です。Auto accept edits は、ファイル編集を自動的に受け入れて、より高速な反復を実現します。Plan mode では、Claude がファイルに触れずにアプローチをマップアウトできます。これは大規模なリファクタリング前に便利です116**コントロール量を調整する。** [権限モード](/ja/desktop#choose-a-permission-mode)は、Claude が承認を求めずにどの程度実行できるかを設定します

117 

118* **Manual**: デフォルトです。Claude はファイルを編集またはコマンドを実行する前に確認を求めます。

119* **Accept edits**: Claude はファイル編集を自動的に受け入れて、より高速な反復を実現します。

120* **Plan**: Claude はファイルを編集せずにアプローチを提案します。これは大規模なリファクタリング前に便利です。

117 121 

118**プラグインを追加してさらに多くの機能を追加する。** プロンプトボックスの横の **+** ボタンをクリックして **Plugins** を選択し、スキル、エージェント、MCP servers などを追加する [プラグイン](/ja/desktop#install-plugins)を参照してインストールします。122**プラグインを追加してさらに多くの機能を追加する。** プロンプトボックスの横の **+** ボタンをクリックして **Plugins** を選択し、スキル、エージェント、MCP servers などを追加する [プラグイン](/ja/desktop#install-plugins)を参照してインストールします。

119 123 

120**ワークスペースを配置する。** チャット、diff、ターミナル、ファイル、プレビューペインを好きなレイアウトにドラッグします。**Ctrl+\`** でターミナルを開いてセッションと一緒にコマンドを実行するか、ファイルパスをクリックしてファイルペインで開きます。[ワークスペースを配置する](/ja/desktop#arrange-your-workspace)を参照してください。124**ワークスペースを配置する。** チャット、diff、ターミナル、ファイル、ブラウザペインを好きなレイアウトにドラッグします。**Ctrl+\`** でターミナルを開いてセッションと一緒にコマンドを実行するか、ファイルパスをクリックしてファイルペインで開きます。[ワークスペースを配置する](/ja/desktop#arrange-your-workspace)を参照してください。

121 125 

122**アプリをプレビューする。** **Preview** ドロップダウンをクリックしてデスクトップで直接開発サーバーを実行します。Claude は実行中のアプリを表示し、エンドポイントをテストし、ログを検査し、見たものに対して反復できます。[アプリをプレビューする](/ja/desktop#preview-your-app)を参照してください。126**アプリをプレビューする。** デスクトップで開発サーバーを実行するとアプリはブラウザペインで開きますブラウザペインは [外部サイトを開く](/ja/desktop#browse-external-sites)こともできます。Claude は実行中のアプリを表示し、エンドポイントをテストし、ログを検査し、見たものに対して反復できます。[アプリをプレビューする](/ja/desktop#preview-your-app)を参照してください。

123 127 

124**プルリクエストを追跡する。** PR を開いた後、Claude Code は CI チェック結果を監視し、失敗を自動的に修正するか、すべてのチェックが成功したら PR をマージできます。[プルリクエストステータスを監視する](/ja/desktop#monitor-pull-request-status)を参照してください。128**プルリクエストを追跡する。** PR を開いた後、Claude Code は CI チェック結果を監視し、失敗を自動的に修正するか、すべてのチェックが成功したら PR をマージできます。[プルリクエストステータスを監視する](/ja/desktop#monitor-pull-request-status)を参照してください。

125 129 

devcontainer.md +2 −2

Details

75認証プロンプトで表示される内容は、プロバイダーによって異なります:75認証プロンプトで表示される内容は、プロバイダーによって異なります:

76 76 

77* **Anthropic**:Claude または Anthropic Console アカウントでブラウザ経由でサインイン77* **Anthropic**:Claude または Anthropic Console アカウントでブラウザ経由でサインイン

78* **[Amazon Bedrock、Google Vertex AI、または Microsoft Foundry](/ja/third-party-integrations)**:Claude Code はクラウドプロバイダーの認証情報を使用し、ブラウザプロンプトはありません78* **[Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry](/ja/third-party-integrations)**:Claude Code はクラウドプロバイダーの認証情報を使用し、ブラウザプロンプトはありません

79 79 

80クラウドプロバイダーの場合、ホストから認証情報ファイルをマウントするのではなく、`containerEnv`、Codespaces シークレット、またはクラウドのワークロード ID を通じて認証情報をコンテナに渡します。Claude Code が読み取る認証情報チェーンについては、[Amazon Bedrock](/ja/amazon-bedrock)、[Google Vertex AI](/ja/google-vertex-ai)、または [Microsoft Foundry](/ja/microsoft-foundry) を参照してください。80クラウドプロバイダーの場合、ホストから認証情報ファイルをマウントするのではなく、`containerEnv`、Codespaces シークレット、またはクラウドのワークロード ID を通じて認証情報をコンテナに渡します。Claude Code が読み取る認証情報チェーンについては、[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、または [Microsoft Foundry](/ja/microsoft-foundry) を参照してください。

81 81 

82どのパスが組織に適しているかを決定するには、[API プロバイダーを選択する](/ja/admin-setup#choose-your-api-provider)を参照してください。82どのパスが組織に適しているかを決定するには、[API プロバイダーを選択する](/ja/admin-setup#choose-your-api-provider)を参照してください。

83 83 

Details

332* 入力してプラグイン名または説明でフィルタリング332* 入力してプラグイン名または説明でフィルタリング

333* Enter を押してプラグインの詳細ビューを開き、有効化、無効化、またはアンインストール333* Enter を押してプラグインの詳細ビューを開き、有効化、無効化、またはアンインストール

334 334 

335プロジェクトの `.claude/settings.json` が有効化しているプラグインをアンインストールすると、どのスコープを意図しているかを尋ねます。自分だけのために無効化する場合は、`.claude/settings.local.json` にオーバーライドを書き込み、プラグインはプロジェクトにインストールされたままになります。または、すべてのユーザーのためにアンインストールする場合は、共有の `.claude/settings.json` から削除されます。Claude Code v2.1.203 以降が必要です。v2.1.203 より前では、ダイアログはローカル無効化のみを提供していました。

336 

335詳細ビューには、プラグインが提供するコンポーネントが表示されます。コマンド、skills、agents、hooks、MCP サーバー、LSP サーバーです。同じインベントリは、コマンドラインから `claude plugin details` で利用できます。337詳細ビューには、プラグインが提供するコンポーネントが表示されます。コマンド、skills、agents、hooks、MCP サーバー、LSP サーバーです。同じインベントリは、コマンドラインから `claude plugin details` で利用できます。

336 338 

337Claude Code v2.1.187 以降では、Installed タブに **Not used recently** グループが追加されます。これはマーケットプレイスから自分でインストールしたプラグインのうち、少なくとも 2 週間以上、かつ少なくとも 10 セッション以上にわたって呼び出していないプラグインを表示します。詳細ビューには、各プラグインの **Last used** 行が表示されます。これらを使用して、もう使用していないが、それでもスタートアップとコンテキストコストを追加しているプラグインを見つけ、無効化またはアンインストールできます。339**Installed** タブはマーケットプレイスから自分でインストールしたが、少なくとも 2 週間以上、かつ少なくとも 10 セッション以上にわたって使用していないプラグインも収集し、**Not used recently** ヘッダーの下に表示します。詳細ビューには、各プラグインの **Last used** 行が表示されます。これらを使用して、もう使用していないが、それでもスタートアップとコンテキストコストを追加しているプラグインを見つけ、無効化またはアンインストールできます。Claude Code v2.1.187 以降が必要です。

340 

3412 種類のプラグインは、未使用として一覧表示されることはありません:

342 

343* 組織が管理するプラグイン、または `--plugin-dir` で読み込むプラグイン

344* テーマ、出力スタイル、モニター、またはワークフローを提供するプラグイン。これらは追跡する呼び出しなしで価値を提供するため

345 

346**Not used recently** ヘッダーと **Last used** 行は、組織が [`strictKnownMarketplaces`](/ja/settings#strictknownmarketplaces) でマーケットプレイスを制限している場合、両方とも非表示になります。

338 347 

339組織が管理するプラグイン、または `--plugin-dir` で読み込むプラグインは未使用として一覧表示されることはありませんまた、LSP サーバー、テーマ、出力スタイル、モニター、またはワークフローを提供するプラグインも、追跡する呼び出しなしで価値を提供するため一覧表示されることはありませんグループと **Last used** 行は組織が [`strictKnownMarketplaces`](/ja/settings#strictknownmarketplaces) でマーケットプレイスを制限している場合、両方とも非表示になります348プラグインの [言語サーバー](/ja/plugins#add-lsp-servers-to-your-plugin) 診断を提供するか、コード ナビゲーション リクエストに応答するときに使用済みとしてカウントされますそのため、LSP プラグインのサーバーがセッションでアクティブな場合未使用として一覧表示されませんv2.1.203 より前では、言語サーバー アクティビティを使用としてカウントできなかったためLSP サーバーを提供するプラグインはグループ全体から除外されていました。これはテーマと出力スタイル プラグインと同じ方法です

340 349 

341依存関係を宣言するプラグインをインストールすると、インストール出力には、それと共に自動インストールされた依存関係が一覧表示されます。350依存関係を宣言するプラグインをインストールすると、インストール出力には、それと共に自動インストールされた依存関係が一覧表示されます。

342 351 

errors.md +487 −282

Details

53| `SSL certificate verification failed` | [ネットワーク](#ssl-certificate-errors) |53| `SSL certificate verification failed` | [ネットワーク](#ssl-certificate-errors) |

54| `SSL certificate error (...)` during login or startup | [ネットワーク](#ssl-certificate-errors) |54| `SSL certificate error (...)` during login or startup | [ネットワーク](#ssl-certificate-errors) |

55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [ネットワーク](#host-not-allowed-in-a-cloud-session) |55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [ネットワーク](#host-not-allowed-in-a-cloud-session) |

56| `Couldn't reconnect to your Remote Control session` | [ネットワーク](#couldn%E2%80%99t-reconnect-to-your-remote-control-session) |

56| `Prompt is too long` | [リクエストエラー](#prompt-is-too-long) |57| `Prompt is too long` | [リクエストエラー](#prompt-is-too-long) |

57| `Error during compaction: Conversation too long` | [リクエストエラー](#error-during-compaction-conversation-too-long) |58| `Error during compaction: Conversation too long` | [リクエストエラー](#error-during-compaction-conversation-too-long) |

58| `Request too large` | [リクエストエラー](#request-too-large) |59| `Request too large` | [リクエストエラー](#request-too-large) |


61| `PDF too large` / `PDF is password protected` | [リクエストエラー](#pdf-errors) |62| `PDF too large` / `PDF is password protected` | [リクエストエラー](#pdf-errors) |

62| `Extra inputs are not permitted` | [リクエストエラー](#extra-inputs-are-not-permitted) |63| `Extra inputs are not permitted` | [リクエストエラー](#extra-inputs-are-not-permitted) |

63| `There's an issue with the selected model` | [リクエストエラー](#there%E2%80%99s-an-issue-with-the-selected-model) |64| `There's an issue with the selected model` | [リクエストエラー](#there%E2%80%99s-an-issue-with-the-selected-model) |

65| `Model ... is not a recognized model id` | [リクエストエラー](#model-is-not-a-recognized-model-id) |

64| `Claude Opus is not available with the Claude Pro plan` | [リクエストエラー](#claude-opus-is-not-available-with-the-claude-pro-plan) |66| `Claude Opus is not available with the Claude Pro plan` | [リクエストエラー](#claude-opus-is-not-available-with-the-claude-pro-plan) |

65| `Model ... is restricted by your organization's settings` | [リクエストエラー](#model-is-restricted-by-your-organization%E2%80%99s-settings) |67| `Model ... is restricted by your organization's settings` | [リクエストエラー](#model-is-restricted-by-your-organization%E2%80%99s-settings) |

66| `thinking.type.enabled is not supported for this model` | [リクエストエラー](#thinking-type-enabled-is-not-supported-for-this-model) |68| `thinking.type.enabled is not supported for this model` | [リクエストエラー](#thinking-type-enabled-is-not-supported-for-this-model) |

67| `max_tokens must be greater than thinking.budget_tokens` | [リクエストエラー](#thinking-budget-exceeds-output-limit) |69| `max_tokens must be greater than thinking.budget_tokens` | [リクエストエラー](#thinking-budget-exceeds-output-limit) |

68| `API Error: 400 due to tool use concurrency issues` | [リクエストエラー](#tool-use-or-thinking-block-mismatch) |70| `API Error: 400 due to tool use concurrency issues` | [リクエストエラー](#tool-use-or-thinking-block-mismatch) |

69| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [リクエストエラー](#usage-policy-refusal) |71| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [リクエストエラー](#usage-policy-refusal) |

72| `<model> has safety measures that flagged this message for a cybersecurity topic` | [リクエストエラー](#safety-measures-flagged-a-cybersecurity-topic) |

73| `Installation was killed before it could finish (exit code 137)` | [インストールエラー](#installation-was-killed-before-it-could-finish) |

74| `The connection dropped while downloading the update` | [インストールエラー](#the-connection-dropped-while-downloading-the-update) |

75| `Download timed out: exceeded the total deadline` | [インストールエラー](#the-connection-dropped-while-downloading-the-update) |

70| `--bg and --print conflict` | [コマンドラインエラー](#command-line-errors) |76| `--bg and --print conflict` | [コマンドラインエラー](#command-line-errors) |

77| `Error: --json-schema is not a valid JSON Schema` | [コマンドラインエラー](#command-line-errors) |

78| `Could not import <server>: <reason>` | [コマンドラインエラー](#could-not-import-a-server-from-claude-desktop) |

79| `Marketplace "<name>" is registered from an untrusted source` | [プラグインエラー](#marketplace-is-registered-from-an-untrusted-source) |

80| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [設定警告](#workspace-has-not-been-trusted) |

71| レスポンスの品質が通常より低いように見える | [レスポンス品質](#responses-seem-lower-quality-than-usual) |81| レスポンスの品質が通常より低いように見える | [レスポンス品質](#responses-seem-lower-quality-than-usual) |

72 82 

73<h2 id="automatic-retries">83<h2 id="automatic-retries">


99 サーバーエラー109 サーバーエラー

100</h2>110</h2>

101 111 

102これらのエラーは、アカウントまたはリクエストではなく、推論プロバイダーから発生します。Anthropic API では Anthropic インフラストラクチャを意味します。Bedrock、Vertex AI、Foundry、またはカスタムゲートウェイでは、そのプロバイダーのインフラストラクチャを意味します。112これらのエラーはアカウントまたはリクエストではなく、推論プロバイダーから発生します。Anthropic API の場合は Anthropic インフラストラクチャを意味します。Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、またはカスタムゲートウェイの場合は、そのプロバイダーのインフラストラクチャを意味します。

103 113 

104<h3 id="api-error-500-internal-server-error">114<h3 id="api-error-500-internal-server-error">

105 API Error: 500 Internal server error115 API Error: 500 Internal server error

106</h3>116</h3>

107 117 

108Claude Code は5xx レスポンスに対してステータスコードと API のエラーメッセージを表示します。以下の例は Anthropic API での 500 レスポンスを示しています。118Claude Code は 5xx レスポンスのステータスコードと API のエラーメッセージを表示します。以下の例は Anthropic API での 500 レスポンスを示しています。

109 119 

110```text theme={null}120```text theme={null}

111API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.121API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

112```122```

113 123 

114末尾の文は、サービスヘルスを確認する場所を示し、プロバイダーによって異なります。Bedrock、Vertex AIおよび Foundry の設定は、そのプロバイダーのサービスステータスを示します。カスタム `ANTHROPIC_BASE_URL` はゲートウェイホストを示します。124末尾の文はサービスヘルスを確認する場所を示し、プロバイダーによって異なります。Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry の設定はそのプロバイダーのサービスステータスを示します。カスタム `ANTHROPIC_BASE_URL` はゲートウェイホストを示します。

115 125 

116これは API 内の予期しない障害を示しています。プロンプト、設定、またはアカウントが原因ではありません。126これは API 内の予期しない障害を示しています。プロンプト、設定、またはアカウントが原因ではありません。

117 127 

118**対応方法:**128**対応方法:**

119 129 

120* [status.claude.com](https://status.claude.com) またはメッセージに示されているプロバイダーのステータスページで、アクティブなインシデントを確認してください130* [status.claude.com](https://status.claude.com) またはメッセージに示されているプロバイダーのステータスページで、アクティブなインシデントを確認してください

121* 1 分待ってからメッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は全体を貼り付ける代わりに `try again` と入力できます131* 1 分待ってからメッセージを再度送信してください。元のメッセージはまだ会話に残っているため、長いプロンプトの場合は全体を貼り付ける代わりに `try again` と入力できます

122* エラーが投稿されたインシデントなしで続く場合は、`/feedback` を実行してAnthropic がリクエスト詳細で調査できるようにしてください。環境で `/feedback` が利用できない場合は、[エラーを報告する](#report-an-error)を参照してください。132* エラーが投稿されたインシデントなしで続く場合は、`/feedback` を実行して Anthropic がリクエストの詳細で調査できるようにしてください。環境で `/feedback` が利用できない場合は、[エラーを報告する](#report-an-error)を参照してください。

123 133 

124<h3 id="api-error-repeated-529-overloaded-errors">134<h3 id="api-error-repeated-529-overloaded-errors">

125 API Error: Repeated 529 Overloaded errors135 API Error: Repeated 529 Overloaded errors

126</h3>136</h3>

127 137 

128API は、すべてのユーザー全体で一時的に容量に達しています。Claude Code は、このメッセージを表示する前に既に数回リトライしています138API はすべてのユーザー全体で一時的に容量に達しています。Claude Code はこのメッセージを表示する前に既に数回再試行しています

129 139 

130```text theme={null}140```text theme={null}

131API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.141API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

132```142```

133 143 

134末尾の文は500 エラーと同じ方法でプロバイダーによって異なります。144末尾の文は 500 エラーと同じ方法でプロバイダーによって異なります。

135 145 

136529 は使用制限ではなく、クォータに対してカウントされません。146529 はユーザーの使用制限ではなく、クォータに対してカウントされません。

137 147 

138**対応方法:**148**対応方法:**

139 149 

140* [status.claude.com](https://status.claude.com) またはメッセージに示されているプロバイダーのステータスページで、容量に関する通知を確認してください150* [status.claude.com](https://status.claude.com) またはメッセージに示されているプロバイダーのステータスページで、容量に関する通知を確認してください

141* 数分後に再度試してください151* 数分後に再度試してください

142* `/model` を実行して別のモデルに切り替えて、容量がモデルごとに追跡されるため、作業を続けてください。Claude Code は1 つのモデルが特に高い負荷を受けている場合、たとえば `Opus is experiencing high load, please use /model to switch to Sonnet` のようにこれを行うようにプロンプトを表示します152* `/model` を実行して別のモデルに切り替えて作業を続けてください容量はモデルごとに追跡されるためです。Claude Code は 1 つのモデルが特に高い負荷を受けている場合、例えば `Opus is experiencing high load, please use /model to switch to Sonnet` のようにプロンプトを表示します

143 153 

144<h3 id="request-timed-out">154<h3 id="request-timed-out">

145 Request timed out155 Request timed out


151Request timed out161Request timed out

152```162```

153 163 

154これは高負荷期間中または非常に大きなレスポンスが生成されている場合に発生する可能性があります。デフォルトのリクエストタイムアウトは 10 分です。164これは高負荷期間中またはモデルが非常に大きなレスポンスを生成している場合に発生する可能性があります。デフォルトのリクエストタイムアウトは 10 分です。

155 165 

156**対応方法:**166**対応方法:**

157 167 

158* リクエストを再試行してください168* リクエストを再試行してください

159* 長時間実行されるタスクの場合は、作業をより小さいプロンプトに分割してください169* 長時間実行されるタスクの場合は、作業をより小さなプロンプトに分割してください

160* 遅いネットワークまたはプロキシが原因の場合は、[自動リトライ](#automatic-retries)で説明されているように `API_TIMEOUT_MS` を上げてください170* 遅いネットワークまたはプロキシが原因の場合は、[自動再試行](#automatic-retries)で説明されているように `API_TIMEOUT_MS` を上げてください

161* タイムアウトが頻繁で、ネットワークが正常な場合は、以下の[ネットワークと接続エラー](#network-and-connection-errors)を参照してください171* タイムアウトが頻繁で、ネットワークが正常な場合は、以下の[ネットワークと接続エラー](#network-and-connection-errors)を参照してください

162 172 

163<h3 id="the-response-above-may-be-incomplete">173<h3 id="the-response-above-may-be-incomplete">

164 The response above may be incomplete174 The response above may be incomplete

165</h3>175</h3>

166 176 

167ストリーミングレスポンスが Claude が既に表示可能な出力を生成した後に失敗しました。リクエストを再送信すると同じツール呼び出しが 2 回実行される可能性があるため、Claude Code は既にストリームされたものを保持しターンを破棄する代わりに不完全なレスポンス通知を追加します表示されるバリアントは原因を示します177ストリーミングレスポンスが Claude が既に表示可能な出力を生成した後に失敗しました。リクエストを再送信すると同じツール呼び出しが 2 回実行される可能性があるため、Claude Code は既にストリーミングされたものを保持しターンを破棄する代わりにこの通知を追加します表示されるバリアントはどれが原因かを示します

168 178 

169```text theme={null}179```text theme={null}

170API Error: Server error mid-response. The response above may be incomplete.180API Error: Server error mid-response. The response above may be incomplete.


172API Error: Response stalled mid-stream. The response above may be incomplete.182API Error: Response stalled mid-stream. The response above may be incomplete.

173```183```

174 184 

175* {/* min-version: 2.1.199 */}` Server error mid-response`:ストリーム中のオーバーロードまたは 5xx サーバーエラー。このバリアントには Claude Code v2.1.199 以降が必要です。それより前ではそのケースは部分的な出力を破棄しターン全体をエラーとして報告しました185* {/* min-version: 2.1.199 */}`Server error mid-response`:ストリーム中のオーバーロードまたは 5xx サーバーエラー。このバリアントには Claude Code v2.1.199 以降が必要です。それ以前はその場合は部分的な出力を破棄しターン全体をエラーとして報告していました

176* `Connection closed mid-response`:接続が切断されました。186* `Connection closed mid-response`:接続が切断されました。

177* `Response stalled mid-stream`:ストリームがデータの送信を停止しました。187* `Response stalled mid-stream`:ストリームがデータの送信を停止しました。

178 188 

179**対応方法:**189**対応方法:**

180 190 

181* ストリームされたレスポンスを読んでください。何も失われていませんが、最後の文またはツール呼び出しが不足している可能性があります191* ストリーミングされたレスポンスを読んでください。何も失われていませんが、最後の文またはツール呼び出しが欠落している可能性があります

182* `continue` で返信して、Claude が停止した場所から再開するようにしてください192* `continue` で返信して、Claude が停止した場所から再開するようにしてください

183* 表示可能な出力の前に同じエラーが表示される場合、Claude Code はそれを最終化する代わりにリクエストをリトライします。[自動リトライ](#automatic-retries)を参照してください。193* 表示可能な出力の前に同じエラーが表示される場合、Claude Code はそれを最終化する代わりにリクエストを再試行します。[自動再試行](#automatic-retries)を参照してください。

184 194 

185<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">195<h3 id="auto-mode-cannot-determine-the-safety-of-an-action">

186 Auto mode cannot determine the safety of an action196 Auto mode cannot determine the safety of an action

187</h3>197</h3>

188 198 

189[auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode)がアクションを分類するために使用するモデルが決定を生成できなかったため、auto mode はアクションを自動的に承認しませんでした。表示されるメッセージは、分類器が失敗した理由によって異なります199[auto mode](/ja/permission-modes#eliminate-prompts-with-auto-mode)が使用するモデルがアクションを分類できず決定を生成できなかったため、auto mode はアクションを自動的に承認しませんでした。表示されるメッセージは分類器が失敗した理由によって異なります

190 200 

191読み取り、検索、および作業ディレクトリ内の編集は分類器をスキップするため、これらすべてのケースで機能し続けます201読み取り、検索、および作業ディレクトリ内の編集は分類器をスキップするため、これらすべてのケースで動作し続けます

192 202 

193分類器モデルがオーバーロードされている場合:203分類器モデルがオーバーロードされている場合:

194 204 


198 208 

199**対応方法:**209**対応方法:**

200 210 

201* 数秒後に再試行してください。Claude は同じメッセージを見て、通常は自動的に再試行します211* 数秒後に再試行してください。Claude は同じメッセージを表示し、通常は自動的に再試行します

202* リトライが失敗し続ける場合は、読み取り専用タスクを続行し、後でブロックされたアクションに戻ってください212* 再試行が失敗し続ける場合は、読み取り専用タスクを続行し、後でブロックされたアクションに戻ってください

203* これは一時的であり、[auto mode 適格性](/ja/permission-modes#eliminate-prompts-with-auto-mode)とは無関係です。設定を変更する必要はありません213* これは一時的で、[auto mode 適格性](/ja/permission-modes#eliminate-prompts-with-auto-mode)とは無関係です。設定を変更する必要はありません

204 214 

205分類器が解析不可能なレスポンスを返した場合:215分類器が解析不可能なレスポンスを返した場合:

206 216 


213* アクションを再試行してください。これは通常、次の試行で成功します223* アクションを再試行してください。これは通常、次の試行で成功します

214* `claude --debug` を実行してアクションを繰り返し、デバッグログで基になる分類器レスポンスを確認してください224* `claude --debug` を実行してアクションを繰り返し、デバッグログで基になる分類器レスポンスを確認してください

215 225 

216会話の前のコンテンツが原因で、別の API セーフティチェックが分類器リクエストをブロックした場合226別の API セーフティチェックが以前の会話コンテンツのため分類器リクエストをブロックした場合

217 227 

218```text theme={null}228```text theme={null}

219Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details229Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details


221 231 

222**対応方法:**232**対応方法:**

223 233 

224* これはアクションについての決定ではありません。会話に既にあるコンテンツが、auto mode が会話を分類器に送信したときに API のセーフティフィルターをトリガーしました234* これはアクションに関する決定ではありません。会話に既にあるコンテンツが、auto mode が会話を分類器に送信したときに API のセーフティフィルターをトリガーしました

225* リトライは役に立ちません。同じ会話コンテンツがフィルターを再度トリガーします235* 再試行は役に立ちません。同じ会話コンテンツがフィルターを再度トリガーします

226* 別の[権限モード](/ja/permission-modes)に切り替えて、プロンプトされたときにアクションを承認できるようにするかトリガーコンテンツなしで新しい会話を開始してください236* 別の[権限モード](/ja/permission-modes)に切り替えて、プロンプトが表示されたときにアクションを承認するかトリガーするコンテンツなしで新しい会話を開始してください

227 237 

228会話が分類器のコンテキストウィンドウより大きくなった場合:238会話が分類器のコンテキストウィンドウより大きくなった場合:

229 239 


231Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)241Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

232```242```

233 243 

234インタラクティブセッションでは、auto mode はそのアクションに対して通常の権限プロンプトにフォールバックするため、手動で承認または拒否できます。[非インタラクティブモード](/ja/headless)では、トランスクリプトのみが増加し、リトライが成功できないため実行が中止されます244インタラクティブセッションでは、auto mode はそのアクションに対して通常の権限プロンプトにフォールバックするため、手動で承認または拒否できます。[非インタラクティブモード](/ja/headless)では、トランスクリプトのみが増加し、再試行が成功できないため実行は中止されます

235 245 

236**対応方法:**246**対応方法:**

237 247 


242 Agent terminated early due to an API error252 Agent terminated early due to an API error

243</h3>253</h3>

244 254 

245{/* min-version: 2.1.199 */}[サブエージェント](/ja/sub-agents)の API リクエストが終了的に失敗しました。たとえば、使用制限に達したか、サーバーエラーのリトライが使い果たされたためサブエージェントはタスクを完了する前に停止しました。このメッセージには Claude Code v2.1.199 以降が必要です。それより前では、API エラーテキストはサブエージェントの結果であるかのように Claude に返されました255{/* min-version: 2.1.199 */}[subagent](/ja/sub-agents)の API リクエストが終了的に失敗しました。例えば、使用制限に達したか、サーバーエラーの再試行が終了したためsubagent はタスクを完了する前に停止しました。このメッセージには Claude Code v2.1.199 以降が必要です。それ以前は、API エラーテキストが subagent の結果であるかのように Claude に返されていました

246 256 

247```text theme={null}257```text theme={null}

248Agent terminated early due to an API error: <error detail>258Agent terminated early due to an API error: <error detail>


251**対応方法:**261**対応方法:**

252 262 

253* コロンの後のエラー詳細をこのページの独自のセクション([使用制限](#usage-limits)または[サーバーエラー](#server-errors)など)と照合し、そのセクションの手順に従ってください263* コロンの後のエラー詳細をこのページの独自のセクション([使用制限](#usage-limits)または[サーバーエラー](#server-errors)など)と照合し、そのセクションの手順に従ってください

254* 基になるエラーがクリアされたら、Claude にタスクを再試行するよう依頼するか、[サブエージェントを再開](/ja/sub-agents#resume-subagents)してください264* 基になるエラーがクリアされたら、Claude にタスクを再試行するか、[subagent を再開](/ja/sub-agents#resume-subagents)するよう依頼してください

255 265 

256レート制限、オーバーロード、またはサーバーエラーがすでに出力を生成したフォアグラウンドサブエージェントを中断する場合、Claude はその部分的な出力を不完全としてマークされて受け取りこのエラーではなく受け取ります。[サブエージェント内の API エラー](/ja/sub-agents#api-errors-in-subagents)を参照してください。266レート制限、オーバーロード、またはサーバーエラーが既にテキスト出力を生成したフォアグラウンド subagent を中断する場合、Claude はその部分的な出力を不完全としてマークされたものを受け取りこのエラーは受け取りません{/* min-version: 2.1.200 */}唯一の出力がツール呼び出しだった subagent もこのエラーを取得します。v2.1.199 ではその形状は空の部分的な結果を返していました。[subagent API エラー](/ja/sub-agents#api-errors-in-subagents)を参照してください。

257 267 

258<h2 id="usage-limits">268<h2 id="usage-limits">

259 使用制限269 使用制限

260</h2>270</h2>

261 271 

262これらのエラーは、アカウントまたはプランに関連するクォータに達したことを意味します。これらは、すべてに影響する[サーバーエラー](#server-errors)とは異なります。272これらのエラーは、アカウントまたはプランに関連するクォータに達したことを意味します。これらは、すべてのユーザーに影響する[サーバーエラー](#server-errors)とは異なります。

263 273 

264<h3 id="you’ve-hit-your-session-limit">274<h3 id="you’ve-hit-your-session-limit">

265 You've hit your session limit275 セッション制限に達しました

266</h3>276</h3>

267 277 

268サブスクリプションプランには、ローリング使用許容量が含まれています。使い果たされると次のいずれかのメッセージが表示されます278サブスクリプションプランには、ローリング使用許容量が含まれています。これが尽きると以下のいずれかのメッセージが表示されます

269 279 

270```text theme={null}280```text theme={null}

271You've hit your session limit · resets 3:45pm281You've hit your session limit · resets 3:45pm


273You've hit your Opus limit · resets 3:45pm283You've hit your Opus limit · resets 3:45pm

274```284```

275 285 

276Claude Code は、メッセージに表示されているリセット時刻までさらなるリクエストをブロックします286Claude Code は、メッセージに表示されたリセット時刻までさらなるリクエストをブロックします

277 287 

278**対応方法:**288**対応方法:**

279 289 

280* エラーに表示されているリセット時刻を待ってください290* エラーに表示されたリセット時刻まで待機してください

281* `/usage` を実行して、プランの制限とリセット時刻を確認してください291* `/usage` を実行して、プランの制限と、それらがいつリセットされるかを確認してください

282* `/usage-credits` を実行して、Pro および Max で追加使用量を購入するか、Team および Enterprise で管理者にリクエストしてください。[有料プランの使用量クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を参照して、これがどのように請求されるかを確認してください292* `/usage-credits` を実行して、Pro および Max で追加使用量を購入するか、Team および Enterprise で管理者にリクエストしてください。この請求方法については、[有料プランの使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を参照してください

283* プランをアップグレードしてより高いベース制限を取得するには、[claude.com/pricing](https://claude.com/pricing)を参照してください293* より高い基本制限のためにプランをアップグレードするには、[claude.com/pricing](https://claude.com/pricing) を参照してください

284 294 

285制限に達する前に残りの許容量を監視するには、`rate_limits` フィールドを[カスタムステータスライン](/ja/statusline#rate-limit-usage)に追加するか、デスクトップアプリでモデルピッカーの横にある[使用量リング](/ja/desktop#check-usage)をクリックしてください。295制限に達する前に残りの許容量を監視するには、`rate_limits` フィールドを[カスタムステータスライン](/ja/statusline#rate-limit-usage)に追加するか、Desktop アプリでモデルピッカーの横にある[使用量リング](/ja/desktop#check-usage)をクリックしてください。

286 296 

287<h3 id="usage-credits-required-for-1m-context">297<h3 id="usage-credits-required-for-1m-context">

288 Usage credits required for 1M context298 1M コンテキストに必要な使用クレジット

289</h3>299</h3>

290 300 

291選択されたモデルは 1M トークンの拡張コンテキストウィンドウを使用しており、お客様のプランではこれを使用量クレジットを通じてのみ含めています301選択されたモデルは 1M トークンの拡張コンテキストウィンドウを使用しており、プランではこれを使用クレジットを通じてのみ含めています

292 302 

293```text theme={null}303```text theme={null}

294API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context304API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

295```305```

296 306 

297これはクォータ枯渇ではなく、エンタイトルメントチェックです。セッションおよび週間許容量に容量が残っている場合でも発火します。[拡張コンテキスト](/ja/model-config#extended-context)を参照して、どのプランが 1M コンテキストを直接含めておりどのプランが使用量クレジットを必要とするかを確認してください307これはクォータ枯渇ではなく、エンタイトルメント チェックです。セッションおよび週間許容量に容量が残っている場合でも発火します。[拡張コンテキスト](/ja/model-config#extended-context)、どのプランが 1M コンテキストを直接含みどのプランが使用クレジットを必要とするかを確認してください

298 308 

299{/* min-version: 2.1.172 */}このエラーがコンテキストが 200K トークンを超えて成長したために会話の途中で表示される場合、Claude Code は自動的に会話を標準コンテキスト制限の下に圧縮し、その後セッションをその制限に保つため、アクションは不要です。v2.1.172 より前のバージョンでは、エラーは `/compact` を含むその後のすべてのリクエストで繰り返されました。これらのバージョンで復旧するには `/clear` を実行してください。以下の手順は、明示的に `[1m]` モデルを選択した場合に適用されます。309{/* min-version: 2.1.172 */}このエラーがコンテキストが 200K トークンを超えて成長したため会話の途中に表示される場合、Claude Code は自動的に会話を標準コンテキスト制限以下にコンパクト化し、その後セッションをその制限に保つため、アクションは不要です。v2.1.172 より前のバージョンでは、エラーは `/compact` を含むその後のすべてのリクエストで繰り返されました。これらのバージョンで復旧するには `/clear` を実行してください。以下の手順は、明示的に `[1m]` モデルを選択した場合に適用されます。

300 310 

301**対応方法:**311**対応方法:**

302 312 

303* `/model` を実行して、`[1m]` サフィックスのないバリアントを選択して、標準コンテキストウィンドウにフォールバックしてください313* `/model` を実行し、`[1m]` サフィックスなしのバリアントを選択して、標準コンテキストウィンドウにフォールバックしてください

304* `/usage-credits` を実行して、Pro および Max で 1M バリアントのメーター制課金をオンにするか、Team および Enterprise で管理者にリクエストしてください314* `/usage-credits` を実行して、Pro および Max で 1M バリアントのメータリング課金をオンにするか、Team および Enterprise で管理者にリクエストしてください

305* `/model` の後もエラーが続く場合は、1M モデル ID が他の場所に設定されている可能性があります。優先順位順に確認する設定場所については、[選択されたモデルに問題があります](#there%E2%80%99s-an-issue-with-the-selected-model)を参照してください。315* `/model` の後もエラーが続く場合、1M モデル ID が他の場所に設定されている可能性があります。優先順位順に確認する設定場所については、[選択されたモデルに問題があります](#there%E2%80%99s-an-issue-with-the-selected-model)を参照してください。

306* モデルピッカーから 1M バリアントを完全に削除するには、[`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/ja/env-vars)を設定してください316* モデルピッカーから 1M バリアントを完全に削除するには、[`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/ja/env-vars) を設定してください

307 317 

308<h3 id="server-is-temporarily-limiting-requests">318<h3 id="server-is-temporarily-limiting-requests">

309 Server is temporarily limiting requests319 サーバーが一時的にリクエストを制限しています

310</h3>320</h3>

311 321 

312API は、プランクォータとは無関係の短期的なスロットルを適用しました。322API は、プランクォータとは無関係の短期的なスロットルを適用しました。


315API Error: Server is temporarily limiting requests (not your usage limit)325API Error: Server is temporarily limiting requests (not your usage limit)

316```326```

317 327 

318Claude Code は、これらが実際の制限レスポンスが持つ統一クォータヘッダーの不在によって区別されます。{/* min-version: 2.1.199 */}v2.1.199 以降ではこれは[自動的にリトライ](#automatic-retries)されます。認証方法に関係なく、表示される前にバックオフしますそれより前のバージョンでは、claude.ai サブスクリプションでサインインしたセッションは最初の発生時にターンに失敗しました。API キーおよびエンタープライズサインインのみがリトライしました328Claude Code は、実際の制限応答が持つ統一クォータヘッダーの不在によって、これらをプラン制限と区別します。{/* min-version: 2.1.199 */}v2.1.199 以降これは認証方法に関係なく、表示される前に[自動的に再試行](#automatic-retries)されます(バックオフ付き)以前のバージョンでは、claude.ai サブスクリプションでサインインしたセッションは最初の発生時にターンに失敗しました。API キーと Enterprise サインインのみがこれを再試行しました

319 329 

320**対応方法:**330**対応方法:**

321 331 

322* 少し待ってから再度試してください332* しばらく待ってから再度試してください

323* 続く場合は [status.claude.com](https://status.claude.com)を確認してください333* 続く場合は [status.claude.com](https://status.claude.com) でサービスの状態を確認してください

324 334 

325<h3 id="request-rejected-429">335<h3 id="request-rejected-429">

326 Request rejected (429)336 リクエストが拒否されました(429

327</h3>337</h3>

328 338 

329API キー、Amazon Bedrock プロジェクト、または Google Vertex AI プロジェクト用に設定されたレート制限に達しました339API キー、Amazon Bedrock プロジェクト、または Google Cloud プロジェクトに設定されたレート制限に達しました

330 340 

331```text theme={null}341```text theme={null}

332API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.342API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

333```343```

334 344 

335末尾の文は、サービスの健全性を確認する場所を示し、プロバイダーによって異なります。Bedrock および Vertex AI 設定では、Anthropic ステータスページの代わりにそのプロバイダーのサービスステータスを示します。カスタム `ANTHROPIC_BASE_URL` はゲートウェイホストを示します。345末尾の文は、サービスの状態を確認する場所を示し、プロバイダーによって異なります。Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry 設定は、Anthropic ステータスページの代わりにそのプロバイダーのサービスステータスを示します。カスタム `ANTHROPIC_BASE_URL` はゲートウェイホストを示します。

336 346 

337**対応方法:**347**対応方法:**

338 348 

339* `/status` を実行して、アクティブな認証情報が予想されるものであることを確認してください。環境内の迷走した `ANTHROPIC_API_KEY` は、サブスクリプションではなく低層キーを通じてリクエストをルーティングできます349* `/status` を実行し、アクティブな認証情報が予想されるものであることを確認してください。環境内の迷走した `ANTHROPIC_API_KEY` は、サブスクリプションの代わりに低層キーを通じてリクエストをルーティングできます

340* プロバイダーコンソールでアクティブな制限を確認し、必要に応じてより高い層をリクエストしてください350* プロバイダーコンソールでアクティブな制限を確認し、必要に応じてより高い層をリクエストしてください

341* Anthropic API キーについては、[レート制限リファレンス](https://platform.claude.com/docs/en/api/rate-limits)を参照して、層がどのように機能し、ワークスペースごとのキャップを設定する方法を確認してください351* Anthropic API キーについては、[レート制限リファレンス](https://platform.claude.com/docs/en/api/rate-limits)を参照して、層がどのように機能し、ワークスペースごとのキャップを設定する方法を確認してください

342* 同時実行性を削減します。[`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ja/env-vars)を低くするか、多くの並列サブエージェントの実行を避けるか、高ボリュームのスクリプト実行用に `/model` で小さいモデルに切り替えてください352* 同時実行性を削減してください:[`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY`](/ja/env-vars) を低くするか、多くの並列サブエージェントの実行を避けるか、高ボリュームのスクリプト実行用に `/model` で小さいモデルに切り替えてください

343 353 

344<h3 id="credit-balance-is-too-low">354<h3 id="credit-balance-is-too-low">

345 Credit balance is too low355 クレジット残高が不足しています

346</h3>356</h3>

347 357 

348Console 組織は、プリペイドクレジットを使い果たしました358Console 組織のプリペイドクレジットが尽きました

349 359 

350```text theme={null}360```text theme={null}

351Credit balance is too low361Credit balance is too low


353 363 

354**対応方法:**364**対応方法:**

355 365 

356* [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing)でクレジットを追加し、そこで自動リロードを有効にして、残高がゼロに達する前に補充されるようにすることを検討してください366* [platform.claude.com/settings/billing](https://platform.claude.com/settings/billing) でクレジットを追加し、残高がゼロに達する前に自動リロードを有効にすることを検討してください

357* Pro、Max、Team、または Enterprise プランがある場合は、`/login` でサブスクリプション認証に切り替えてください367* Pro、Max、Team、または Enterprise プランがある場合は、`/login` でサブスクリプション認証に切り替えてください

358* Console でワークスペースごとの支出キャップを設定して、単一のプロジェクトが組織の残高を枯渇させるのを防いでください。[コストを効果的に管理する](/ja/costs)を参照してください。368* Console でワークスペースごとの支出キャップを設定して、単一のプロジェクトが組織の残高を枯渇させるのを防いでください。[コストを効果的に管理する](/ja/costs)を参照してください。

359 369 


361 認証エラー371 認証エラー

362</h2>372</h2>

363 373 

364これらのエラーはClaude Code が API に対して身元を証明できないことを意味しますいつでも `/status` を実行して、現在アクティブな認証情報を確認してください374これらのエラーは Claude Code が API に対してあなたの身元を証明できないことを意味します任意の時点で `/status` を実行して、現在アクティブな認証情報を確認できます

365 375 

366<h3 id="not-logged-in">376<h3 id="not-logged-in">

367 Not logged in377 ログインしていない

368</h3>378</h3>

369 379 

370このセッションで有効な認証情報は利用できません380このセッションで有効な認証情報が利用できません

371 381 

372```text theme={null}382```text theme={null}

373Not logged in · Please run /login383Not logged in · Please run /login


375 385 

376**対応方法:**386**対応方法:**

377 387 

378* `/login` を実行して、Claude サブスクリプションまたは Console アカウントで認証してください388* `/login` を実行して、Claude サブスクリプションまたは Console アカウントで認証します

379* 環境変数で認証されることを期待していた場合は、`ANTHROPIC_API_KEY` が設定され、`claude` を起動したシェルでエクスポートされていることを確認してください389* 環境変数で認証されることを想定していた場合は、`ANTHROPIC_API_KEY` `claude` を起動したシェルで設定およびエクスポートされていることを確認します

380* インタラクティブログインが不可能な CI または自動化の場合は起動時にキーをフェッチする[`apiKeyHelper`](/ja/settings#available-settings)スクリプトを設定してください390* CI または自動化で対話的ログインが不可能な場合は起動時にキーを取得する [`apiKeyHelper`](/ja/settings#available-settings) スクリプトを設定します

381* [認証の優先順位](/ja/authentication#authentication-precedence)を参照して、複数の認証情報が存在する場合にどの認証情報が優先されるかを理解してください391* [認証の優先順位](/ja/authentication#authentication-precedence) を参照して、複数の認証情報が存在する場合に Claude Code がどの認証情報を使用するかを理解します

382 392 

383ログインを繰り返しプロンプトされている場合は、[ログインしていないまたはトークンの有効期限が切れている](/ja/troubleshoot-install#not-logged-in-or-token-expired)を参照して、システムクロックと macOS キーチェーンの修正を確認してください。393ログインを繰り返し求められる場合は、[ログインしていないまたはトークンの有効期限が切れている](/ja/troubleshoot-install#not-logged-in-or-token-expired) を参照して、システムクロックと macOS キーチェーンの修正を確認してください。

384 394 

385<h3 id="could-not-resolve-authentication-method">395<h3 id="could-not-resolve-authentication-method">

386 Could not resolve authentication method396 認証方法を解決できない

387</h3>397</h3>

388 398 

389セッションが認証情報なしで API クライアントに到達しました。これは[バックグラウンドセッション](/ja/agent-view)、クラウドセッション、および最初のリクエストの前にインタラクティブログインチェックが実行されない Agent SDK コンテキストに表示されます。399セッションが認証情報なしで API クライアントに到達しました。これは [バックグラウンドセッション](/ja/agent-view)、クラウドセッション、および最初のリクエストの前に対話的ログインチェックが実行されない Agent SDK コンテキストに表示されます。

390 400 

391```text theme={null}401```text theme={null}

392Could 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 omitted402Could 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

393```403```

394 404 

395{/* min-version: 2.1.174 */}v2.1.174 より前では、バックグラウンドまたはクラウドセッションがアイドル状態の事前初期化ワーカーに割り当てられている場合、有効な認証情報が設定されていても、このように失敗する可能性がありました。アップグレードして復旧してください。現在のバージョンでは、エラーはワーカープロセスで認証情報が利用できなかったことを意味します405{/* min-version: 2.1.174 */}v2.1.174 より前では、アイドル状態の事前初期化ワーカーに割り当てられたバックグラウンドまたはクラウドセッションは、有効な認証情報が設定されていても、このように失敗する可能性がありました。アップグレードして復旧します。現在のバージョンでは、このエラーはワーカープロセスで認証情報が利用できなかったことを意味します

396 406 

397**対応方法:**407**対応方法:**

398 408 

399* バックグラウンドまたはクラウドセッションでこれが表示され、認証情報が既に設定されている場合は、v2.1.174 以降にアップグレードしてください409* バックグラウンドまたはクラウドセッションでこれが表示され、認証情報が既に設定されている場合は、v2.1.174 以降にアップグレードします

400* `ANTHROPIC_API_KEY`、`CLAUDE_CODE_OAUTH_TOKEN`、またはクラウドプロバイダーの認証情報が、インタラクティブシェルだけでなくワーカーを起動する環境で設定されていることを確認してください410* `ANTHROPIC_API_KEY`、`CLAUDE_CODE_OAUTH_TOKEN`、またはクラウドプロバイダーの認証情報が、対話的シェルだけでなくワーカーを起動する環境で設定されていることを確認します

401* Agent SDK については、[認証セットアップ](/ja/agent-sdk/overview#get-started)を参照してください411* Agent SDK については、[認証セットアップ](/ja/agent-sdk/overview#get-started) を参照してください

402* 同じ環境のインタラクティブセッションで `/status` を実行して、どの認証情報ソースが解決されるかを確認してください412* 同じ環境の対話的セッションで `/status` を実行して、どの認証情報ソースが解決されるかを確認します

403 413 

404<h3 id="invalid-api-key">414<h3 id="invalid-api-key">

405 Invalid API key415 無効な API キー

406</h3>416</h3>

407 417 

408`ANTHROPIC_API_KEY` 環境変数または `apiKeyHelper` スクリプトが、API が拒否したキーを返しました418`ANTHROPIC_API_KEY` 環境変数または `apiKeyHelper` スクリプトが返したキーが API に拒否されました

409 419 

410```text theme={null}420```text theme={null}

411Invalid API key · Fix external API key421Invalid API key · Fix external API key


413 423 

414**対応方法:**424**対応方法:**

415 425 

416* タイプミスを確認し、キーが [Console](https://platform.claude.com/settings/keys) で取り消されていないことを確認してください426* タイプミスがないか確認し、キーが [Console](https://platform.claude.com/settings/keys) で失効していないことを確認します

417* 同じシェルで `env | grep ANTHROPIC` を実行してください。direnv、dotenv シェルプラグイン、IDE ターミナルなどのツールは、明示的に設定せずにプロジェクト内の `.env` ファイルから古いキーをロードできます。427* 同じシェルで `env | grep ANTHROPIC` を実行します。direnv、dotenv シェルプラグイン、IDE ターミナルなどのツールは、プロジェクト内の `.env` ファイルから古いキーを明示的に設定せずに読み込むことができます

418* `ANTHROPIC_API_KEY` をアンセットして `/login` を実行し、代わりにサブスクリプション認証を使用してください428* `ANTHROPIC_API_KEY` をアンセットして `/login` を実行し、代わりにサブスクリプション認証を使用します

419* キーが[`apiKeyHelper`](/ja/settings#available-settings)スクリプトから来ている場合は、スクリプトを直接実行して、stdout に有効なキーを出力することを確認してください429* キーが [`apiKeyHelper`](/ja/settings#available-settings) スクリプトから来ている場合は、スクリプトを直接実行して、stdout に有効なキーが出力されることを確認します

420* `/status` を実行して、Claude Code が実際に使用している認証情報ソースを確認してください430* `/status` を実行して、Claude Code が実際に使用している認証情報ソースを確認します

421 431 

422<h3 id="this-organization-has-been-disabled">432<h3 id="this-organization-has-been-disabled">

423 This organization has been disabled433 この組織は無効になっています

424</h3>434</h3>

425 435 

426無効な Console 組織からの古い `ANTHROPIC_API_KEY` がサブスクリプションログインをオーバーライドしています。436無効な Console 組織からの古い `ANTHROPIC_API_KEY` がサブスクリプションログインをオーバーライドしています。


430API Error: 400 ... This organization has been disabled.440API Error: 400 ... This organization has been disabled.

431```441```

432 442 

433環境変数は `/login` より優先されるため、シェルプロファイルでエクスポートされたキーまたは `.env` ファイルからロードされたキーは機能する Pro または Max サブスクリプションがある場合でも使用されます。非インタラクティブモード(`-p`)では、キーが存在する場合は常に使用されます。443環境変数は `/login` より優先されるため、シェルプロファイルでエクスポートされたキーまたは `.env` ファイルから読み込まれたキーは動作する Pro または Max サブスクリプションがある場合でも使用されます。非対話モード(`-p`)では、キーが存在する場合は常に使用されます。

434 444 

435**対応方法:**445**対応方法:**

436 446 

437* 現在のシェルで `ANTHROPIC_API_KEY` をアンセットし、シェルプロファイルから削除してから、`claude` を再起動してください447* 現在のシェルで `ANTHROPIC_API_KEY` をアンセットし、シェルプロファイルから削除してから、`claude` を再起動します

438* その後 `/status` を実行して、アクティブな認証情報がサブスクリプションであることを確認してください448* その後 `/status` を実行して、アクティブな認証情報がサブスクリプションであることを確認します

439* 環境変数が設定されておらず、エラーが続く場合、無効な組織は `/login` に関連付けられているものです。サポートに連絡するか、別のアカウントでサインインしてください449* 環境変数が設定されておらず、エラーが続く場合は、無効な組織は `/login` に関連付けられています。サポートに連絡するか、別のアカウントでサインインします

440 450 

441<h3 id="your-organization-has-disabled-api-key-authentication">451<h3 id="your-organization-has-disabled-api-key-authentication">

442 Your organization has disabled API key authentication452 組織が API キー認証を無効にしました

443</h3>453</h3>

444 454 

445{/* min-version: 2.1.169 */}}455このメッセージには Claude Code v2.1.169 以降が必要です。Console 組織の管理者が API キー認証をオフにしたため、API が Claude Code が送信しているキーを拒否します。`·` の後の復旧ヒントは、キーがどこから来たかによって異なります:

446Console 組織の管理者が API キー認証をオフにしているため、API が Claude Code が送信しているキーを拒否しています。`·` の後の復旧ヒントは、キーがどこから来たかによって異なります。

447 456 

448```text theme={null}457```text theme={null}

449Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account458Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account


452Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account461Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

453```462```

454 463 

455環境変数と `apiKeyHelper` は `/login` より優先されるため、どちらかがキーを供給している間は `/login` を実行するだけでは役に立ちません。[認証の優先順位](/ja/authentication#authentication-precedence)を参照してください。464環境変数と `apiKeyHelper` は `/login` より優先されるため、どちらかがまだキーを供給している間は `/login` だけを実行しても役に立ちません。[認証の優先順位](/ja/authentication#authentication-precedence) を参照してください。

456 465 

457**対応方法:**466**対応方法:**

458 467 

459* メッセージが `ANTHROPIC_API_KEY` に言及している場合は、現在のシェルでアンセットし、シェルプロファイルまたは `.env` ファイルから削除してから、`claude` を再起動してください468* メッセージが `ANTHROPIC_API_KEY` を指定している場合は、現在のシェルでアンセットし、シェルプロファイルまたは `.env` ファイルから削除してから、`claude` を再起動します

460* メッセージが `apiKeyHelper` に言及している場合は、`settings.json` から[`apiKeyHelper`](/ja/settings#available-settings)設定を削除してください469* メッセージが `apiKeyHelper` を指定している場合は、`settings.json` から [`apiKeyHelper`](/ja/settings#available-settings) 設定を削除します

461* `/login` を実行してclaude.ai アカウントでサインインしてください470* `/login` を実行して claude.ai アカウントでサインインします

462* その後 `/status` を実行して、アクティブな認証情報が API キーではなくサブスクリプションであることを確認してください471* その後 `/status` を実行して、アクティブな認証情報が API キーではなくサブスクリプションであることを確認します

463* 自動化に API キー認証が必要な場合は、組織の管理者に Console で再度有効にするよう依頼してください472* 自動化に API キー認証が必要な場合は、組織の管理者に Console で再度有効にするよう依頼します

464 473 

465<h3 id="your-organization-has-disabled-claude-subscription-access">474<h3 id="your-organization-has-disabled-claude-subscription-access">

466 Your organization has disabled Claude subscription access475 組織が Claude サブスクリプションアクセスを無効にしました

467</h3>476</h3>

468 477 

469Claude 組織がサブスクリプションログインで Claude Code にサインインすることを許可していません。同じアカウントで `/login` を再度実行すると、同じエラーが返されます。478Claude 組織は、サブスクリプションログインで Claude Code にサインインすることを許可していません。同じアカウントで `/login` を再度実行すると、同じエラーが返されます。

470 479 

471```text theme={null}480```text theme={null}

472Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access481Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

473```482```

474 483 

475これはサーバー側の組織設定であるため、ローカル設定、環境変数、または CLI フラグからオーバーライドすることはできません。Agent SDK および `-p` 非インタラクティブモードは、これを `oauth_org_not_allowed` エラーコードとして表示します。484これはサーバー側の組織設定であるため、ローカル設定、環境変数、または CLI フラグからオーバーライドすることはできません。

485 

486Agent SDK と `-p` 非対話モードは、これを `oauth_org_not_allowed` エラーコードとして表示します。

476 487 

477**対応方法:**488**対応方法:**

478 489 

479* 管理者に組織の Claude Code アクセスを有効にするよう依頼してください490* 管理者に組織の Claude Code アクセスを有効にするよう依頼します

480* サブスクリプションの代わりに Console API キーで認証してください。セットアップについては[Claude Console 認証](/ja/authentication#claude-console-authentication)を参照してください491* サブスクリプションの代わりに Console API キーで認証します。セットアップについては [Claude Console 認証](/ja/authentication#claude-console-authentication) を参照してください

481* 管理者であり、アクセスを有効にするオプションが表示されない場合は、[Anthropic サポート](https://support.claude.com)に連絡してください492* あなたが管理者で、アクセスを有効にするオプションが表示されない場合は、[Anthropic サポート](https://support.claude.com) に連絡してください

482 493 

483<h3 id="routines-are-disabled-by-your-organization’s-policy">494<h3 id="routines-are-disabled-by-your-organization’s-policy">

484 Routines are disabled by your organization's policy495 ルーチンは組織のポリシーで無効になっています

485</h3>496</h3>

486 497 

487チームまたはエンタープライズ組織の Owner が、組織レベルでルーチンをオフにしています。エラーは、`/schedule` および claude.ai/code の [Routines](/ja/routines) UI を含め、ルーチンを作成または実行しようとするときに表示されます498Team または Enterprise 組織の Owner がルーチンを組織レベルで無効にしました。エラーは、`/schedule` および claude.ai/code の [ルーチン](/ja/routines) UI からルーチンを作成または実行しようとするときに表示されます

488 499 

489```text theme={null}500```text theme={null}

490Routines are disabled by your organization's policy.501Routines are disabled by your organization's policy.


494 505 

495**対応方法:**506**対応方法:**

496 507 

497* 組織の Owner に [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) で **Routines** トグルを有効にするよう依頼してください508* 組織の Owner に [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) で **ルーチン** トグルを有効にするよう依頼します

498* 組織レベルのルーチンを必要としない 1 回限りのスケジュール済み作業については、[スケジュール済みタスク](/ja/scheduled-tasks)を参照してください509* 組織レベルのルーチンを必要としない 1 回限りのスケジュール済み作業については、[スケジュール済みタスク](/ja/scheduled-tasks) を参照してください

499 510 

500<h3 id="remote-control-requires-the-anthropic-api">511<h3 id="remote-control-requires-the-anthropic-api">

501 Remote Control requires the Anthropic API512 リモートコントロールには Anthropic API が必要です

502</h3>513</h3>

503 514 

504セッションが Anthropic API と直接通信していないため、[Remote Control](/ja/remote-control)がペアリングする claude.ai バックエンドがありません。515セッションが Anthropic API と直接通信していないため、[リモートコントロール](/ja/remote-control) がペアリングする claude.ai バックエンドがありません。

505 516 

506```text theme={null}517```text theme={null}

507Remote Control is only available when using Claude via api.anthropic.com.518Remote Control is only available when using Claude via api.anthropic.com.

508```519```

509 520 

510これは Amazon Bedrock、Google Vertex AI、Microsoft Foundry に表示されます。{/* min-version: 2.1.196 */}v2.1.196 以降では、[`ANTHROPIC_BASE_URL`](/ja/env-vars)が `api.anthropic.com` 以外のホスト([LLM ゲートウェイ](/ja/llm-gateway)やプロキシなど)を指している場合にも表示されます。claude.ai でサインインしている場合でも表示されます。521これは Amazon Bedrock、Google Cloud の Agent Platformおよび Microsoft Foundry に表示されます。{/* min-version: 2.1.196 */}v2.1.196 以降では、[`ANTHROPIC_BASE_URL`](/ja/env-vars) が `api.anthropic.com` 以外のホスト([LLM ゲートウェイ](/ja/llm-gateway) やプロキシなど)を指している場合にも表示されます。claude.ai でサインインしている場合でも表示されます。

511 522 

512**対応方法:**523**対応方法:**

513 524 

514* `ANTHROPIC_BASE_URL` をアンセットしてセッションを再起動するか、Anthropic API と直接通信するセッションから Remote Control を起動してください525* `ANTHROPIC_BASE_URL` をアンセットしてセッションを再起動するか、Anthropic API と直接通信するセッションからリモートコントロールを起動します

515* このおよび他の Remote Control スタートアップメッセージについては、[Remote Control のトラブルシューティング](/ja/remote-control#troubleshooting)を参照してください526* このおよび他のリモートコントロール起動メッセージについては、[リモートコントロールのトラブルシューティング](/ja/remote-control#troubleshooting) を参照してください

516 527 

517<h3 id="oauth-token-revoked-or-expired">528<h3 id="oauth-token-revoked-or-expired">

518 OAuth token revoked or expired529 OAuth トークンが失効または期限切れです

519</h3>530</h3>

520 531 

521保存されたログインは有効ではなくなりました。取り消されたトークンはどこかでサインアウトしたか、管理者がアクセスを削除したことを意味します。期限切れのトークンは、自動リフレッシュがセッション中に失敗したことを意味します532保存されたログインは有効ではなくなりました。失効したトークンはどこからでもサインアウトしたか、管理者がアクセスを削除したことを意味します。期限切れのトークンは、自動更新がセッション中に失敗したことを意味します

522 533 

523```text theme={null}534```text theme={null}

524OAuth token revoked · Please run /login535OAuth token revoked · Please run /login


528 539 

529**対応方法:**540**対応方法:**

530 541 

531* `/login` を実行して再度サインインしてください542* `/login` を実行して再度サインインします

532* 再認証後、同じセッション内でエラーが返される場合は、最初に `/logout` を実行して保存されたトークンを完全にクリアしてから、`/login` を実行してください543* 再認証後、同じセッション内でエラーが返される場合は、まず `/logout` を実行して保存されたトークンを完全にクリアしてから、`/login` を実行します

533* 起動全体でログインを繰り返しプロンプトされている場合は、[トラブルシューティング](/ja/troubleshoot-install#not-logged-in-or-token-expired)のシステムクロックと macOS キーチェーンチェックを参照してください544* 起動全体でログインを繰り返し求められる場合は、[トラブルシューティング](/ja/troubleshoot-install#not-logged-in-or-token-expired) のシステムクロックと macOS キーチェーンチェックを参照してください

534* `403 Forbidden` や OAuth ブラウザの問題を含む他の障害については、[ログインと認証](/ja/troubleshoot-install#login-and-authentication)を参照してください545* `403 Forbidden` や OAuth ブラウザーの問題を含む他の障害については、[ログインと認証](/ja/troubleshoot-install#login-and-authentication) を参照してください

535 546 

536<h3 id="oauth-scope-requirement">547<h3 id="oauth-scope-requirement">

537 OAuth scope requirement548 OAuth スコープ要件

538</h3>549</h3>

539 550 

540保存されたトークンは、新しい機能が必要とする権限スコープより前のものです。これは`/usage` とステータスラインの使用量インジケーターから最も頻繁に表示されます。551保存されたトークンは、新しい機能が必要とする権限スコープより前のものです。これは `/usage` とステータス行の使用状況インジケーターから最も頻繁に表示されます:

541 552 

542```text theme={null}553```text theme={null}

543OAuth token does not meet scope requirement: user:profile554OAuth token does not meet scope requirement: user:profile


545 556 

546**対応方法:**557**対応方法:**

547 558 

548* `/login` を実行して、現在のスコープで新しいトークンを作成してください。ログアウトする必要はありません。559* `/login` を実行して、現在のスコープを持つ新しいトークンを取得します。ログアウトする必要はありません。

549 560 

550<h3 id="aws-credentials-expired-or-invalid">561<h3 id="aws-credentials-expired-or-invalid">

551 AWS credentials expired or invalid562 AWS 認証情報の有効期限切れまたは無効

552</h3>563</h3>

553 564 

554{/* min-version: 2.1.198 */}}このメッセージには Claude Code v2.1.198 以降が必要であり、[`awsAuthRefresh`](/ja/amazon-bedrock#advanced-credential-configuration)が設定ファイルで設定されている場合のみ表示されます。AWS セッショントークンが期限切れになったか拒否されました。Claude Code が既に実行した自動リフレッシュが、API が受け入れる認証情報を生成しませんでした。これは [Claude Platform on AWS](/ja/claude-platform-on-aws) または [Mantle エンドポイント](/ja/amazon-bedrock#use-the-mantle-endpoint)からの 401 に表示されます。これらのプロバイダーが期限切れのセキュリティトークンを報告する方法です。565{/* min-version: 2.1.198 */}このメッセージには Claude Code v2.1.198 以降が必要で設定ファイルで [`awsAuthRefresh`](/ja/amazon-bedrock#advanced-credential-configuration) が設定されている場合にのみ表示されます。AWS セッショントークンの有効期限が切れたか拒否され、Claude Code が既に実行した自動更新が API が受け入れる認証情報を生成しませんでした。[AWS 上の Claude Platform](/ja/claude-platform-on-aws) または [Mantle エンドポイント](/ja/amazon-bedrock#use-the-mantle-endpoint) からの 401 に表示されます。これらのプロバイダーが期限切れのセキュリティトークンを報告する方法です。

555 566 

556中央のアクション ヒントは設定からの `awsAuthRefresh` コマンドを示すため、異なります。安定した部分は先頭の `AWS credentials expired or invalid` です567中央のアクションヒントは設定からの `awsAuthRefresh` コマンドに名前を付けるため、異なります。安定した部分は先頭の `AWS credentials expired or invalid` です

557 568 

558```text theme={null}569```text theme={null}

559AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...570AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

560```571```

561 572 

562`awsAuthRefresh` が設定されていない場合、同じ 401 は代わりに汎用の `Please run /login` メッセージを表示し、AWS 認証情報をリフレッシュできません573`awsAuthRefresh` が設定されていない場合、同じ 401 は代わりに汎用の `Please run /login` メッセージを表示し、AWS 認証情報を更新できません

563 574 

564**対応方法:**575**対応方法:**

565 576 

566* メッセージに示されている `awsAuthRefresh` コマンド(`aws sso login --profile myprofile` など)を別のターミナルで実行し、ブラウザサインインを完了してから、再試行してください577* メッセージで指定された `awsAuthRefresh` コマンド(`aws sso login --profile myprofile` など)を別のターミナルで実行し、ブラウザーサインインを完了してから再試行します

567* インタラクティブセッションでは、`/login` を実行し、**3 番目のパーティプラットフォーム**を選択してから、**3 番目のパーティプラットフォームを使用**の下で **Claude Platform on AWS · refresh credentials** を選択して、Claude Code を再起動せずに同じコマンドを実行してください。[AWS 認証情報を設定](/ja/claude-platform-on-aws#1-configure-aws-credentials)を参照してください578* 対話的セッションで `/login` を実行し、**3 番目のパーティプラットフォーム** を選択してから、**3 番目のパーティプラットフォームを使用** の下で **Claude Platform on AWS · 認証情報を更新** を選択して、Claude Code を再起動せずに同じコマンドを実行します。[AWS 認証情報を設定](/ja/claude-platform-on-aws#1-configure-aws-credentials) を参照してください

568* リフレッシュコマンドが成功した後もエラーが繰り返される場合は、同じシェルとプロファイルで `aws sts get-caller-identity` を使用して Claude Code の外で ID が有効であることを確認してください579* 更新コマンドが成功した後もエラーが繰り返される場合は、同じシェルとプロファイルで `aws sts get-caller-identity` を使用して Claude Code の外で ID が有効であることを確認します

569 580 

570<h3 id="aws-authentication-failed">581<h3 id="aws-authentication-failed">

571 AWS authentication failed582 AWS 認証に失敗しました

572</h3>583</h3>

573 584 

574{/* min-version: 2.1.198 */}}このメッセージには Claude Code v2.1.198 以降が必要であり、[`awsAuthRefresh`](/ja/amazon-bedrock#advanced-credential-configuration)が設定ファイルで設定されている場合のみ表示されます。AWS プロバイダーが 403 を返したか、[Amazon Bedrock](/ja/amazon-bedrock)が 401 を返しました。585{/* min-version: 2.1.198 */}このメッセージには Claude Code v2.1.198 以降が必要で設定ファイルで [`awsAuthRefresh`](/ja/amazon-bedrock#advanced-credential-configuration) が設定されている場合にのみ表示されます。AWS プロバイダーが 403 を返したか、[Amazon Bedrock](/ja/amazon-bedrock) が 401 を返しました。

575 586 

576Claude Code はどの原因に当たったかを判断できません。Amazon Bedrock は期限切れのセキュリティトークンを 403 として報告しますが、403 `AccessDeniedException` からの不足している IAM 権限やアカウントで有効になっていないモデルなどの認可拒否も報告する方法です587Claude Code はどの原因に当たったかを判断できません。Amazon Bedrock は期限切れのセキュリティトークンを 403 として報告しますが、403 は認可拒否(IAM 権限の欠落またはアカウントで有効になっていないモデルからの `AccessDeniedException` など)を報告する方法でもあります

577 588 

578Amazon Bedrock からの 401 も [AWS credentials expired or invalid](#aws-credentials-expired-or-invalid) の下ではなくここに着地します。Bedrock は期限切れのトークンを 401 として報告しないためです。そのエンドポイントからの 401 は通常、企業プロキシなど、リクエストパスの他の何かから来ます589Amazon Bedrock からの 401 も [AWS 認証情報の有効期限切れまたは無効](#aws-credentials-expired-or-invalid) の下ではなくここに該当しますAmazon Bedrock は期限切れのトークンを 401 として報告しないためです。そのエンドポイントからの 401 は通常、企業プロキシなどのリクエストパス内の他の何かから来ています

579 590 

580認証情報リフレッシュは期限切れのトークンを修正し、他の原因を修正できないため、メッセージは両方を提供します591認証情報の更新は期限切れのトークンを修正でき、他の原因を修正できないため、メッセージは両方を提供します

581 592 

582```text theme={null}593```text theme={null}

583AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...594AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

584```595```

585 596 

586中央のアクション ヒントは設定からの `awsAuthRefresh` コマンドを示すため、異なります。安定した部分は先頭の `AWS authentication failed` です。597中央のアクションヒントは設定からの `awsAuthRefresh` コマンドに名前を付けるため、異なります。安定した部分は先頭の `AWS authentication failed` です。

587 598 

588**対応方法:**599**対応方法:**

589 600 

590* メッセージに示されている `awsAuthRefresh` コマンドまたは `aws sso login` を実行します。期限切れの認証情報が原因である可能性があります601* メッセージで指定された `awsAuthRefresh` コマンドまたは `aws sso login` を実行します。期限切れの認証情報が原因である可能性があります

591* 認証情報が最新の場合は、[IAM 設定](/ja/amazon-bedrock#iam-configuration)の IAM 権限が使用している ID に接続されていることを確認し、選択したモデルがアカウントとリージョンで有効になっていることを確認してください602* 認証情報が最新の場合は、[IAM 設定](/ja/amazon-bedrock#iam-configuration) の IAM 権限が使用している ID に接続されていることを確認し、選択したモデルがアカウントとリージョンで有効になっていることを確認します

592* `aws sts get-caller-identity` を実行して、リクエストが使用する ID を確認してください。古い `AWS_PROFILE` またはデフォルトプロファイルは、権限の不一致の一般的な原因です603* `aws sts get-caller-identity` を実行して、リクエストが使用する ID を確認します。古い `AWS_PROFILE` またはデフォルトプロファイルは、権限の不一致の一般的な原因です

593 604 

594<h2 id="network-and-connection-errors">605<h2 id="network-and-connection-errors">

595 ネットワークと接続エラー606 ネットワークと接続エラー

596</h2>607</h2>

597 608 

598これらのエラーは、Claude Code からのネットワークリクエストが宛先に到達できなかったことを意味します。これらは通常、ローカルネットワーク、プロキシ、またはファイアウォールあるいはクラウド環境のネットワークポリシーから発生します609これらのエラーは、Claude Code からのネットワークリクエストが宛先に到達できなかったことを意味します。通常、ローカルネットワーク、プロキシ、ファイアウォールまたはクラウド環境のネットワークポリシーに起因します

599 610 

600<h3 id="unable-to-connect-to-api">611<h3 id="unable-to-connect-to-api">

601 Unable to connect to API612 API に接続できない

602</h3>613</h3>

603 614 

604API への TCP 接続に失敗したか、完了しませんでした。615API への TCP 接続に失敗したか、完了しませんでした。


617**対応方法:**628**対応方法:**

618 629 

619* 同じシェルから `curl -I https://api.anthropic.com` を実行して、API ホストに到達できることを確認してください。Windows PowerShell では、組み込みの `Invoke-WebRequest` エイリアスが使用されないように `curl.exe -I https://api.anthropic.com` を使用してください。630* 同じシェルから `curl -I https://api.anthropic.com` を実行して、API ホストに到達できることを確認してください。Windows PowerShell では、組み込みの `Invoke-WebRequest` エイリアスが使用されないように `curl.exe -I https://api.anthropic.com` を使用してください。

620* 企業プロキシの背後にある場合は、Claude Code を起動する前に `HTTPS_PROXY` を設定し、[ネットワーク設定](/ja/network-config)を参照してください631* 企業プロキシの背後にいる場合は、Claude Code を起動する前に `HTTPS_PROXY` を設定し、[ネットワーク設定](/ja/network-config)を参照してください

621* LLM ゲートウェイまたはリレーを通じてルーティングする場合は、[`ANTHROPIC_BASE_URL`](/ja/env-vars)をそのアドレスに設定してください。セットアップについては、[LLM ゲートウェイに Claude Code を接続する](/ja/llm-gateway-connect)を参照してください。632* LLM ゲートウェイまたはリレーを経由してルーティングする場合は、[`ANTHROPIC_BASE_URL`](/ja/env-vars)をそのアドレスに設定してください。セットアップについては、[Claude Code を LLM ゲートウェイに接続する](/ja/llm-gateway-connect)を参照してください。

622* ファイアウォールが[ネットワークアクセス要件](/ja/network-config#network-access-requirements)に記載されているホストを許可していることを確認してください633* ファイアウォールが[ネットワークアクセス要件](/ja/network-config#network-access-requirements)に記載されているホストを許可していることを確認してください

623* 一時的な障害は[自動的にリトライ](#automatic-retries)されます。永続的な障害はローカルネットワークの問題を指しています634* 一時的な障害は[自動的に再試行](#automatic-retries)されます。永続的な障害はローカルネットワークの問題を示しています。

624 635 

625`curl` は成功しても Claude Code が失敗する場合、原因は通常、ネットワーク自体ではなく、ランタイムとネットワークの間にあります636`curl` は成功するが Claude Code は失敗する場合、原因は通常、ネットワーク自体ではなく、ランタイムとネットワークの間にあります

626 637 

627* Linux および WSL では、`/etc/resolv.conf` で到達不可能なネームサーバーを確認してください。特に WSL はホストから壊れたリゾルバーを継承できます638* Linux WSL では、`/etc/resolv.conf` で到達不可能なネームサーバーを確認してください。特に WSL はホストから壊れたリゾルバーを継承する可能性があります

628* macOS では、切断または削除された VPN クライアントがトンネルインターフェースまたはルーティングルールを残す可能性があります。`ifconfig` で古い `utun` インターフェースを確認し、システム設定で VPN のネットワーク拡張を削除してください639* macOS では、切断またはアンインストールされた VPN クライアントがトンネルインターフェースまたはルーティングルールを残す可能性があります。`ifconfig` で古い `utun` インターフェースを確認し、システム設定から VPN のネットワーク拡張機能を削除してください

629* Docker Desktop および同様のコンテナランタイムは、アウトバウンドトラフィックをインターセプトできます。それらを終了して再試行しこれを除外してください640* Docker Desktop および同様のコンテナランタイムは、アウトバウンドトラフィックをインターセプトできます。これを除外するためにそれらを終了して再試行してください

630 641 

631<h3 id="ssl-certificate-errors">642<h3 id="ssl-certificate-errors">

632 SSL certificate errors643 SSL 証明書エラー

633</h3>644</h3>

634 645 

635ネットワーク上のプロキシまたはセキュリティアプライアンスが、独自の証明書で TLS トラフィックをインターセプトしており、Claude Code がそれを信頼していません。646ネットワーク上のプロキシまたはセキュリティアプライアンスが TLS トラフィックを独自の証明書でインターセプトしており、Claude Code がそれを信頼していません。

636 647 

637```text theme={null}648```text theme={null}

638Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates649Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates

639Unable to connect to API: Self-signed certificate detected650Unable to connect to API: Self-signed certificate detected

640```651```

641 652 

642{/* min-version: 2.1.199 */}}v2.1.199 以降では証明書検証の失敗はリトライされないため、このエラーは完全な[リトライ予算](#automatic-retries)の後ではなく最初の試行で表示されますそれより前のバージョンでは表示する前に数分間リトライしました。ハンドシェイクタイムアウトなどの一時的な TLS 条件はまだリトライされます653{/* min-version: 2.1.199 */}v2.1.199 以降証明書検証の失敗は再試行されないため、このエラーは完全な[再試行予算](#automatic-retries)の後ではなく、最初の試行時に表示されます以前のバージョンでは表示する前に数分間再試行していました。ハンドシェイクタイムアウトなどの一時的な TLS 条件は、引き続き再試行されます

643 654 

644`/login` とスタートアップ接続チェック中に、同じ障害は OpenSSL コードと修正がインラインで報告されます。655`/login` とスタートアップ接続チェック中に、同じ障害が OpenSSL コードとインラインの修正とともに報告されます:

645 656 

646```text theme={null}657```text theme={null}

647SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run /doctor for details.658SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

648```659```

649 660 

650**対応方法:**661**対応方法:**

651 662 

652* 組織の CA バンドルをエクスポートし、`NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem` で Claude Code をポイントしてください663* 組織の CA バンドルをエクスポートし、`NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem` で Claude Code に指定してください。

653* 完全なセットアップ手順については、[ネットワーク設定](/ja/network-config#custom-ca-certificates)を参照してください664* 完全なセットアップ手順については、[ネットワーク設定](/ja/network-config#custom-ca-certificates)を参照してください

654* 証明書検証を完全に無効にする `NODE_TLS_REJECT_UNAUTHORIZED=0` を設定しないでください665* `NODE_TLS_REJECT_UNAUTHORIZED=0` を設定しないでください。これは証明書検証を完全に無効にします。

655 666 

656<h3 id="host-not-allowed-in-a-cloud-session">667<h3 id="host-not-allowed-in-a-cloud-session">

657 Host not allowed in a cloud session668 クラウドセッションでホストが許可されていない

658</h3>669</h3>

659 670 

660クラウドセッションまたはルーチンからのアウトバウンド HTTP リクエストが、環境のネットワークポリシーによってブロックされました。671クラウドセッションまたはルーチンからのアウトバウンド HTTP リクエストが、環境のネットワークポリシーによってブロックされました。


664x-deny-reason: host_not_allowed675x-deny-reason: host_not_allowed

665```676```

666 677 

667宛先の実際の証明書と一致しない TLS 証明書が表示される場合もあります。クラウド環境はアウトバウンドトラフィックをプロキシを通じてルーティングしてネットワークポリシーを適用するため、証明書の不一致は宛先ではなくプロキシが接続を終了したことを意味します。678宛先の実際の証明書と一致しない TLS 証明書も表示される場合があります。クラウド環境はアウトバウンドトラフィックをプロキシを通じてルーティングしてネットワークポリシーを適用するため、証明書の不一致は宛先ではなくプロキシが接続を終了したことを意味します。

668 679 

669これはクライアント側のネットワーク問題ではありません。クラウドセッションと[ルーチン](/ja/routines)アウトバウンドトラフィックが環境のアローリストにフィルタリングされるサンドボックス環境内で実行されます。**デフォルト**環境は**信頼済み**アクセスを使用し、パッケージレジストリ、クラウドプロバイダー API、コンテナレジストリ、および一般的な開発ドメインの[デフォルトアローリスト](/ja/claude-code-on-the-web#default-allowed-domains)を許可しますが、その他すべてをブロックします。680これはクライアント側のネットワーク問題ではありません。クラウドセッションと[ルーチン](/ja/routines)はサンドボックス環境内で実行されアウトバウンドトラフィックは環境のアローリストにフィルタリングされます。**Default** 環境は**Trusted** アクセスを使用し、パッケージレジストリ、クラウドプロバイダー API、コンテナレジストリ、および一般的な開発ドメインの[デフォルトアローリスト](/ja/claude-code-on-the-web#default-allowed-domains)を許可しますが、その他すべてをブロックします。

670 681 

671**対応方法:**682**対応方法:**

672 683 

673* ルーチンを編集用に開くか、クラウドセッションを開始してください。**デフォルト**などの環境名を表示しているクラウドアイコンを選択して、セレクターを開いてください。環境にマウスを置き、設定アイコンをクリックしてください。684* ルーチンを編集用に開くか、クラウドセッションを開始してください。**Default** などの環境名を示すクラウドアイコンを選択して、セレクターを開いてください。環境にマウスを置き、設定アイコンをクリックしてください。

674* **クラウド環境を更新**ダイアログで、**ネットワークアクセス**を**信頼済み**から**カスタム**に変更し、ブロックされたドメインを**許可されたドメイン**に追加してください。1 行に 1 つのドメインを入力してください。**デフォルトリストの一般的なパッケージマネージャーも含める**をチェックして、カスタムドメインと共に[デフォルトアローリスト](/ja/claude-code-on-the-web#default-allowed-domains)を保持してください。無制限アクセスが必要な場合は、代わりに**フル**を選択してください。685* **Update cloud environment** ダイアログで、**Network access** を**Trusted** から**Custom** に変更し、ブロックされたドメインを**Allowed domains** に追加してください。1 行に 1 つのドメインを入力してください。**Also include default list of common package managers** をチェックして、カスタムドメインと共に[デフォルトアローリスト](/ja/claude-code-on-the-web#default-allowed-domains)を保持してください。無制限のアクセスが必要な場合は、代わりに**Full** を選択してください。

675* **変更を保存**をクリックしてください。次の実行は更新されたアローリストを使用します。686* **Save changes** をクリックしてください。次の実行は更新されたアローリストを使用します。

676 687 

677アクセスレベルとデフォルトアローリストについては、[ネットワークアクセス](/ja/claude-code-on-the-web#network-access)を参照してください。ローカル CLI セッションはこのポリシーの影響を受けません。688アクセスレベルとデフォルトアローリストについては、[ネットワークアクセス](/ja/claude-code-on-the-web#network-access)を参照してください。ローカル CLI セッションはこのポリシーの影響を受けません。

678 689 

690<h3 id="couldn’t-reconnect-to-your-remote-control-session">

691 Remote Control セッションに再接続できませんでした

692</h3>

693 

694```text theme={null}

695Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

696```

697 

698`claude --resume` または `claude --continue` で再開すると、その会話に記録された[Remote Control](/ja/remote-control)セッションに再接続します。このメッセージは、ネットワーク中断またはサーバーエラーなどの一時的な理由で再接続に失敗したことを意味し、Claude Code はリモートセッションがまだ存在するかどうかを確認できません。ローカルセッションは Remote Control なしで実行を続けます。

699 

700**対応方法:**

701 

702* `/remote-control` を実行して接続を再試行してください。

703* `--resume` なしで Claude Code を開始して、新しい Remote Control セッションを作成してください。

704* その他の Remote Control スタートアップメッセージについては、[Remote Control のトラブルシューティング](/ja/remote-control#troubleshooting)を参照してください。

705 

706サーバーが前のセッションがもう存在しないことを確認した場合、このメッセージは表示されません。Claude Code はその場合に新しいセッションを作成します。{/* min-version: 2.1.200 */}v2.1.200 より前では、再接続の失敗により新しい Remote Control セッションが作成され、claude.ai/code のセッションリストに余分なセッションが残されました。

707 

679<h2 id="request-errors">708<h2 id="request-errors">

680 リクエストエラー709 リクエストエラー

681</h2>710</h2>

682 711 

683これらのエラーは、API がリクエストを受け取ったが、その内容を拒否したことを意味します712これらのエラーはリクエストの内容に関連しています。ほとんどはリクエストを拒否した後に API から返されますいくつかはリクエストが送信される前に Claude Code によってローカルで生成されます。

684 713 

685<h3 id="prompt-is-too-long">714<h3 id="prompt-is-too-long">

686 Prompt is too long715 プロンプトが長すぎます

687</h3>716</h3>

688 717 

689会話と添付ファイルがモデルのコンテキストウィンドウを超えています。718会話と添付ファイルがモデルのコンテキストウィンドウを超えています。


692Prompt is too long721Prompt is too long

693```722```

694 723 

695**対応方法:**724**対処方法:**

696 725 

697* `/compact` を実行して以前のターンを要約し、スペースを解放するか、`/clear` を実行して新しく開始してください726* `/compact` を実行して以前のターンを要約し、スペースを解放するか、`/clear` を実行して新しく開始します

698* `/context` を実行して、ウィンドウを消費しているものの内訳を確認してください。システムプロンプト、ツール、メモリファイル、およびメッセージです727* `/context` を実行して、ウィンドウを消費しているものの内訳を確認します。システムプロンプト、ツール、メモリファイル、メッセージです

699* `/mcp disable <name>` で使用していない MCP サーバーを無効にして、コンテキストからツール定義を削除してください728* `/mcp disable <name>` で使用していない MCP サーバーを無効にして、コンテキストからツール定義を削除します

700* 大きな `CLAUDE.md` メモリファイルをトリミングするか、関連する場合にのみロードされる[パススコープルール](/ja/memory#path-specific-rules)に指示を移動してください729* 大きな `CLAUDE.md` メモリファイルをトリミングするか、指示を [パススコープ規則](/ja/memory#path-specific-rules) に移動して、関連する場合にのみ読み込みます

701* サブエージェントは親セッションからすべての MCP ツール定義を継承します。これにより、最初のターンの前にコンテキストウィンドウが満杯になる可能性があります。サブエージェントを生成する前に、使用していない MCP サーバーを無効にしてください。730* サブエージェントは親セッションからすべての MCP ツール定義を継承します。これにより、最初のターンの前にコンテキストウィンドウが満杯になる可能性があります。サブエージェントを生成する前に、使用していない MCP サーバーを無効にします

702* 自動コンパクトはデフォルトで有効になっており、通常このエラーを防ぎます。[`DISABLE_AUTO_COMPACT`](/ja/env-vars)を設定している場合は、再度有効にするか、ウィンドウが満杯になる前に `/compact` を手動で実行してください。731* オートコンパクトはデフォルトで有効になっており、通常このエラーを防ぎます。[`DISABLE_AUTO_COMPACT`](/ja/env-vars) を設定している場合は、再度有効にするか、ウィンドウが満杯になる前に `/compact` を手動で実行します

703 732 

704[コンテキストウィンドウを探索する](/ja/context-window)を参照して、コンテキストがどのように満杯になるかのインタラクティブビューを確認してください。733[コンテキストウィンドウを探索](/ja/context-window) を参照して、コンテキストがどのように満杯になるかのインタラクティブビューを確認してください。

705 734 

706<h3 id="error-during-compaction-conversation-too-long">735<h3 id="error-during-compaction-conversation-too-long">

707 Error during compaction: Conversation too long736 コンパクション中のエラー:会話が長すぎます

708</h3>737</h3>

709 738 

710`/compact` 自体が失敗しました。これは、生成される要約を保持するのに十分な空きコンテキストがないためです。739`/compact` 自体が失敗しました。生成される要約を保持するのに十分な空きコンテキストがないためです。

711 740 

712```text theme={null}741```text theme={null}

713Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.742Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

714```743```

715 744 

716これは、ウィンドウが自動コンパクトがトリガーされる時点で既に満杯の場合、または `Prompt is too long` を見た後に `/compact` を実行する場合に発生する可能性があります745これは、ウィンドウがオートコンパクトをトリガーする時点で既に満杯の場合、または `Prompt is too long` を見た後に `/compact` を実行した場合に発生する可能性があります

717 746 

718**対応方法:**747**対処方法:**

719 748 

720* Esc 2 回押してメッセージリストを開き、数ターン戻ってください。これにより、最新のメッセージがコンテキストから削除されます。その後、`/compact` を再度実行してください。749* Esc キーを 2 回押してメッセージリストを開き、数ターン戻ります。これにより、最新のメッセージがコンテキストから削除されます。その後、`/compact` を再度実行します

721* 戻ることで十分なスペースが解放されない場合は、`/clear` を実行して新しいセッションを開始してください以前の会話は保存され、`/resume` で再度開くことができます750* 戻ることで十分なスペースが解放されない場合は、`/clear` を実行して新しいセッションを開始します以前の会話は保持され、`/resume` で再度開くことができます

722 751 

723<h3 id="request-too-large">752<h3 id="request-too-large">

724 Request too large753 リクエストが大きすぎます

725</h3>754</h3>

726 755 

727生のリクエストボディが、トークン化前に API のバイト制限を超えました。通常大きく貼り付けられたファイルまたは添付ファイルが原因です756トークン化前の生のリクエストボディが API のバイト制限を超えました。通常は大きなペーストファイルまたは添付ファイルが原因です

728 757 

729```text theme={null}758```text theme={null}

730Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.759Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

731```760```

732 761 

733これは、[コンテキストウィンドウ制限](#prompt-is-too-long)とは別の HTTP リクエストのサイズ制限です762これは HTTP リクエストのサイズ制限であり、[コンテキストウィンドウ制限](#prompt-is-too-long) とは別です

734 763 

735**対応方法:**764**対処方法:**

736 765 

737* Esc 2 回押して、サイズを超えたコンテンツを追加したターンを過ぎて戻ってください766* Esc キーを 2 回押して、サイズが大きすぎるコンテンツを追加したターンを戻ります

738* 大きなファイルをパスで参照して内容を貼り付けるのではなく、Claude がチャンク単位で読み取ることができるようにしてください767* 大きなファイルの内容をペーストするのではなくパスで参照して、Claude がチャンク単位で読み込めるようにします

739* 画像については、以下の[画像が大きすぎました](#image-was-too-large)を参照してください768* 画像については、以下の [画像が大きすぎました](#image-was-too-large) を参照してください

740 769 

741<h3 id="image-was-too-large">770<h3 id="image-was-too-large">

742 Image was too large771 画像が大きすぎました

743</h3>772</h3>

744 773 

745貼り付けられた、または添付された画像が API のサイズまたは寸法制限を超えています。774ペーストまたは添付された画像が API のサイズまたは寸法制限を超えています。

746 775 

747```text theme={null}776```text theme={null}

748Image was too large. Double press esc to go back and try again with a smaller image.777Image was too large. Double press esc to go back and try again with a smaller image.

749API Error: 400 ... image dimensions exceed max allowed size778API Error: 400 ... image dimensions exceed max allowed size

750```779```

751 780 

752{/* min-version: 2.1.142 */}}Claude Code は処理できない画像をテキストプレースホルダーに置き換えて再試行するため、後続のメッセージは成功します。v2.1.142 より前のバージョンでは、貼り付けられた画像は会話に残る可能性があり後続のすべてのメッセージで同じエラーが繰り返される可能性があります。これらのバージョンで復旧するには、Esc 2 回押して、画像が追加されたターンを過ぎて戻ってください781{/* min-version: 2.1.142 */}Claude Code は処理できない画像をテキストプレースホルダーに置き換えて再試行するため、後続のメッセージは成功します。2.1.142 より前のバージョンでは、ペーストされた画像が会話に残り後続のすべてのメッセージで同じエラーが繰り返される可能性がありました。これらのバージョンで復旧するには、Esc キーを 2 回押して、画像が追加されたターンを戻ります

753 782 

754**対応方法:**783**対処方法:**

755 784 

756* 貼り付ける前に画像をリサイズしてください。API は、単一の画像の場合は最長辺で最大 8000 ピクセルまたはコンテキストに多くの画像がある場合は 2000 ピクセルの画像を受け入れます。785* ペーストする前に画像をリサイズします。API は単一の画像の場合は最長辺で 8000 ピクセルまで多くの画像がコンテキストにある場合は 2000 ピクセルまでの画像を受け入れます

757* 全画面ではなく、関連する領域のより厳密なスクリーンショットを撮ってください786* 全画面ではなく、関連する領域のより厳密なスクリーンショットを撮ります

758 787 

759<h3 id="unable-to-resize-image">788<h3 id="unable-to-resize-image">

760 Unable to resize image789 画像をリサイズできません

761</h3>790</h3>

762 791 

763Claude Code は、API に送信する前に添付された画像をダウンスケールできませんでした792Claude Code は添付された画像を API に送信する前にダウンスケールできませんでした

764 793 

765```text theme={null}794```text theme={null}

766Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.795Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.


769Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.798Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

770```799```

771 800 

772Claude Code は通常、大きな画像を自動的にリサイズします。これらのエラーは、ネイティブ画像プロセッサーがロードに失敗したか、エラーを返したため、画像を API 制限内に収まるようにリサイズできなかったことを意味します。801Claude Code は通常、大きな画像を自動的にリサイズします。これらのエラーは、ネイティブ画像プロセッサーが読み込みに失敗したか、エラーを返したため、画像を API 制限内に収まるようにリサイズできなかったことを意味します。

773 802 

774**対応方法:**803**対処方法:**

775 804 

776* メッセージが画像の変換を求めている場合は、PNG、JPEG、GIF、または WebP に変換して、再度添付してください。Claude Code はこれらの形式の寸法を画像プロセッサーなしで検証できます805* メッセージで画像を変換するよう求められた場合は、PNG、JPEG、GIF、または WebP に変換して再度添付します。Claude Code はこれらの形式の寸法を画像プロセッサーなしで検証できます

777* メッセージが寸法またはサイズ制限を報告している場合はその制限以下に画像をリサイズまたは再圧縮してから添付してください。806* メッセージが寸法またはサイズ制限を報告する場合はその制限以下に画像をリサイズまたは再圧縮してから添付します

778 807 

779<h3 id="pdf-errors">808<h3 id="pdf-errors">

780 PDF errors809 PDF エラー

781</h3>810</h3>

782 811 

783添付した PDF を処理できませんでした。812添付した PDF を処理できませんでした。


788The PDF file was not valid. Try converting to a different format first.817The PDF file was not valid. Try converting to a different format first.

789```818```

790 819 

791**対応方法:**820**対処方法:**

792 821 

793* サイズの大きい PDF の場合は、ファイル全体を添付する代わりに Read ツールでページ範囲を読み取るよう Claude に依頼するか、`pdftotext` などのツールでテキストを抽出しパスでファイルを参照してください822* サイズが大きい PDF の場合は、ファイル全体を添付するのではなく、Read ツールでページ範囲を読み込むよう Claude に依頼するか、`pdftotext` などのツールでテキストを抽出して出力ファイルをパスで参照します

794* 保護されたまたは無効な PDF の場合は、パスワードを削除するか、ソースアプリケーションからファイルを再度エクスポートしてから、再度試してください823* 保護されている、または無効な PDF の場合は、パスワードを削除するか、ソースアプリケーションからファイルを再度エクスポートしてから、もう一度試します

795 824 

796<h3 id="extra-inputs-are-not-permitted">825<h3 id="extra-inputs-are-not-permitted">

797 Extra inputs are not permitted826 追加の入力は許可されていません

798</h3>827</h3>

799 828 

800Claude Code と API の間のプロキシまたは LLM ゲートウェイが `anthropic-beta` リクエストヘッダーをストリップしたため、API はそれに依存するフィールドを拒否しました。829Claude Code と API の間のプロキシまたは LLM ゲートウェイが `anthropic-beta` リクエストヘッダーを削除したため、API はそれに依存するフィールドを拒否しました。

801 830 

802```text theme={null}831```text theme={null}

803API Error: 400 ... Extra inputs are not permitted ... context_management832API Error: 400 ... Extra inputs are not permitted ... context_management


805API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header834API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

806```835```

807 836 

808Claude Code は`context_management`、`effort`、ツール `input_examples` などのベータのみのフィールドを、それらを有効にする `anthropic-beta` ヘッダーと共に送信します。ゲートウェイがボディを転送しますがヘッダーをドロップすると、API は認識しないフィールドを見ます。837Claude Code は `context_management`、`effort`、ツール `input_examples` などのベータのみのフィールドを、それらを有効にする `anthropic-beta` ヘッダーと共に送信します。ゲートウェイがボディを転送してもヘッダーを削除すると、API は認識しないフィールドを見ます。

809 838 

810**対応方法:**839**対処方法:**

811 840 

812* `anthropic-beta` ヘッダーを転送するようにゲートウェイを設定してください。[機能パススルー](/ja/llm-gateway-protocol#feature-pass-through)を参照して、ゲートウェイが転送する必要があるものを確認してください。841* `anthropic-beta` ヘッダーを転送するようにゲートウェイを設定しますゲートウェイが転送する必要があるものについては、[機能パススルー](/ja/llm-gateway-protocol#feature-pass-through) を参照してください

813* フォールバックとして、起動前に[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ja/env-vars)を設定してください。これにより、ベータヘッダーが必要な機能が無効になり、リクエストはそれを転送できないゲートウェイを通じて成功します。842* フォールバックとして、起動前に [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ja/env-vars) を設定します。これにより、ベータヘッダーが必要な機能が無効になり、ヘッダーを転送できないゲートウェイを通じてリクエストが成功します

814 843 

815<h3 id="there’s-an-issue-with-the-selected-model">844<h3 id="there’s-an-issue-with-the-selected-model">

816 There's an issue with the selected model845 選択されたモデルに問題があります

817</h3>846</h3>

818 847 

819{/* min-version: 2.1.160 */}}848設定されたモデル名が認識されなかったか、アカウントがそれへのアクセス権を持っていません。v2.1.160 以降、ここに対話形式で示されている末尾のヒントはサーフェスによって異なります。

820設定されたモデル名が認識されなかったか、アカウントがそれへのアクセスを持っていません。v2.1.160 以降、表示される末尾のヒントはサーフェスによって異なります。

821 849 

822```text theme={null}850```text theme={null}

823There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.851There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.

824```852```

825 853 

826**対応方法:**854**対処方法:**

855 

856* **対話型 CLI**:`/model` を実行して、アカウントで利用可能なモデルから選択します

857* **非対話型モード(`-p`)**:`--model` に有効なエイリアスまたは ID を渡すか、[`ANTHROPIC_MODEL`](/ja/env-vars) を設定します。エラーテキストはこのサーフェスで `Run --model` を表示します

858* **Agent SDK**:モデルがプログラムで設定されているため、エラーテキストはヒントを省略します。TypeScript で [`Options` の `model`](/ja/agent-sdk/typescript#options) を設定するか、Python で [`ClaudeAgentOptions(model=...)`](/ja/agent-sdk/python#claudeagentoptions) を設定し、構造化された `model_not_found` エラーを処理して、独自の再試行またはモデルピッカーを表示します

859* 完全なバージョン付き ID ではなく、`sonnet` や `opus` などのエイリアスを使用します。エイリアスは保守されたデフォルトに解決されるため、古くなりません。[モデル設定](/ja/model-config) を参照してください

860* CLI で間違ったモデルが戻り続ける場合は、どこかに古い ID が設定されています。[優先順位順](/ja/model-config#setting-your-model) で確認します:`--model` フラグ、`ANTHROPIC_MODEL` 環境変数、次に `.claude/settings.local.json` の `model` フィールド、プロジェクトの `.claude/settings.json`、および `~/.claude/settings.json`。古い値を削除すると、Claude Code はアカウントのデフォルトにフォールバックします

861* Google Cloud の Agent Platform デプロイメントについては、[Google Cloud の Agent Platform トラブルシューティング](/ja/google-vertex-ai#troubleshooting) を参照してください

862 

863<h3 id="model-is-not-a-recognized-model-id">

864 モデルは認識されたモデル ID ではありません

865</h3>

866 

867モデルスイッチに渡したモデル文字列は、モデルエイリアス、この Claude Code バージョンが認識するモデル ID、または `claude-` で始まる ID ではありません。通常の原因は、ID のタイプミス、`Sonnet 5` などの表示名(ID `claude-sonnet-5` が必要)、または新しい Claude Code バージョンのみが認識するエイリアスです。Claude Code はスイッチを即座に拒否します。v2.1.200 より前は、Claude Code は文字列を保存し、[選択されたモデルに問題があります](#there%E2%80%99s-an-issue-with-the-selected-model) で次のリクエストで失敗しました。

868 

869```text theme={null}

870Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

871```

872 

873末尾のヒントは、最も近いマッチングエイリアスまたはモデル ID に名前を付けます。十分に近いものがない場合は、代わりに `Run /model to see available models.` と表示されます。

874 

875Claude Code はこのエラーをローカルで生成します。スイッチが要求された時点で、API リクエストが行われる前です。これは、[Agent SDK](/ja/agent-sdk/typescript) `setModel()` メソッドを通じてモデルが設定されるか、[Desktop app](/ja/desktop) などのアプリケーションが Claude Code CLI を実行する場合に適用されます。

876 

877**対処方法:**

827 878 

828* **インタラクティブ CLI**:`/model` を実行してアカウントで利用可能なモデルから選択してください。879* 引数なしで `/model` を実行してピッカーを開きアカウントで利用可能なモデルから選択してから、そこに表示されているエイリアスまたは ID を渡します

829* **非対話型モード(`-p`)**:`--model` に有効なエイリアスまたは ID を渡すか、[`ANTHROPIC_MODEL`](/ja/env-vars)を設定してくださいエラーテキストはこのサーフェスで `Run --model` を表示します。880* 新しい Claude Code バージョンがサポートするエイリアスを使用した場合は、`claude update` を実行します。`claude-` で始まる完全な ID はこのチェックに合格しますモデルが Claude Code バージョンより新しい場合でも、アップグレードは不要です

830* **Agent SDK**:モデルがプログラムで設定されているため、エラーテキストはヒントを省略しますTypeScript で[`Options` の `model`](/ja/agent-sdk/typescript#options)を設定するかPython で[`ClaudeAgentOptions(model=...)`](/ja/agent-sdk/python#claudeagentoptions)を設定し、構造化された `model_not_found` エラーを処理して、独自の再試行またはモデルピッカーを表示してください。881* v2.1.200 より前に保存されたモデルはこのチェックで修復されません古い値が戻り続ける場合は、[選択されたモデルに問題があります](#there%E2%80%99s-an-issue-with-the-selected-model) に記載されている場所から削除します

831* `sonnet` `opus` などのエイリアスを完全なバージョン ID ではなく使用してください。エイリアスは最新リリースを追跡するため古くなりません。[モデル設定](/ja/model-config)を参照してください。882* チェックは Anthropic API でのみ実行されます。Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、[Claude Platform on AWS](/ja/claude-platform-on-aws)、および [LLM ゲートウェイ](/ja/llm-gateway) または カスタム `ANTHROPIC_BASE_URL` の背後では、プロバイダーまたはゲートウェイがモデル名を定義するため、Claude Code は任意の文字列を受け入れて渡します

832* 間違ったモデルが戻り続ける場合は、古い ID がどこかに設定されています。[優先順位順](/ja/model-config#setting-your-model)で確認してください。`--model` フラグ、`ANTHROPIC_MODEL` 環境変数、その後 `.claude/settings.local.json`、プロジェクトの `.claude/settings.json`、および `~/.claude/settings.json` の `model` フィールド。古い値を削除すると、Claude Code はアカウントのデフォルトにフォールバックします。

833* Vertex AI デプロイメントについては、[Vertex AI トラブルシューティング](/ja/google-vertex-ai#troubleshooting)を参照してください。

834 883 

835<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">884<h3 id="claude-opus-is-not-available-with-the-claude-pro-plan">

836 Claude Opus is not available with the Claude Pro plan885 Claude Opus Claude Pro プランでは利用できません

837</h3>886</h3>

838 887 

839アクティブなサブスクリプションプランには、選択したモデルが含まれていません。888アクティブなサブスクリプションプランに、選択したモデルが含まれていません。

840 889 

841```text theme={null}890```text theme={null}

842Claude Opus is not available with the Claude Pro plan · Select a different model in /model891Claude Opus is not available with the Claude Pro plan · Select a different model in /model

843```892```

844 893 

845**対応方法:**894**対処方法:**

846 895 

847* `/model` を実行して、プランに含まれるモデルを選択してください896* `/model` を実行して、プランに含まれるモデルを選択します

848* 最近プランをアップグレードしてもこれが表示される場合は、`/logout` を実行してから `/login` を実行してください保存されたトークンはサインイン時のプランを反映しているためウェブでアップグレードしても既存のセッションで有効になるまで再認証する必要があります。897* 最近プランをアップグレードしてもこれが表示される場合は、`/logout` を実行してから `/login` を実行します保存されたトークンはサインイン時のプランを反映するためWeb でアップグレードしても、再認証するまで既存のセッションで有効になりません

849* [claude.com/pricing](https://claude.com/pricing)を参照して、各プランに含まれるモデルを確認してください898* 各プランに含まれるモデルについては、[claude.com/pricing](https://claude.com/pricing) を参照してください

850 899 

851<h3 id="model-is-restricted-by-your-organization’s-settings">900<h3 id="model-is-restricted-by-your-organization’s-settings">

852 Model is restricted by your organization's settings901 モデルは組織の設定によって制限されています

853</h3>902</h3>

854 903 

855{/* min-version: 2.1.187 */}}904組織の管理者が claude.ai 管理コンソールでこのモデルを無効にしたか、管理設定の [`availableModels`](/ja/model-config#restrict-model-selection) 許可リストで除外されています。制限されたモデルが `--model`、`ANTHROPIC_MODEL`、または `model` 設定で設定された場合、Claude Code は許可されたモデルに置き換えて続行します。制限されたモデルに対して `/model <name>` を入力すると、`Run /model to choose a different model.` で拒否され、セッションは現在のモデルを保持します。

856組織の管理者が Claude Console でこのモデルを無効にしたか、管理設定の [`availableModels`](/ja/model-config#restrict-model-selection) 許可リストで除外されています。制限されたモデルが `--model`、`ANTHROPIC_MODEL`、または `model` 設定で設定された場合、Claude Code は許可されたモデルに置き換えて続行します。制限されたモデルに対して `/model <name>` を入力すると、`Run /model to choose a different model.` で拒否され、セッションは現在のモデルを保持します。

857 905 

858```text theme={null}906```text theme={null}

859Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.907Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

860```908```

861 909 

862**対応方法:**910Claude Code は、`opus`、`sonnet`、`haiku`、または `fable` の 1 つであるモデルファミリーエイリアスを、最新バージョンへのリクエストではなく、そのファミリーへのリクエストとして扱います。Anthropic API および [Claude Platform on AWS](/ja/claude-platform-on-aws) では、制限されたファミリーエイリアスは、組織と `availableModels` 許可リストが許可するファミリーの最新バージョンに解決され、置き換え通知がそのバージョンに名前を付けます。Claude Code は、ファミリーのすべてのバージョンが制限されている場合にのみ `/model <alias>` を拒否します。v2.1.205 より前は、ファミリーエイリアスは同じファミリーの古いバージョンが許可されている場合でも、最新バージョンのみに基づいて置き換えられるか拒否されました。

863 911 

864* `/model` を実行して、組織が許可するモデルから選択してください。制限されたモデルはピッカーから非表示になります。912**対処方法:**

865* 制限されたモデルが `--model`、`ANTHROPIC_MODEL`、または設定ファイルの `model` フィールドで設定された場合は、その値を削除または更新して、起動するたびに通知が繰り返されないようにしてください913 

866* 制限されたモデルへのアクセスが必要な場合は、組織の管理者に有効にするよう依頼してください。[組織モデル制限](/ja/model-config#organization-model-restrictions)を参照してください914* `/model` を実行して、組織が許可するモデルから選択します制限されたモデルはピッカーから非表示になります

915* 制限されたモデルが `--model`、`ANTHROPIC_MODEL`、または設定ファイルの `model` フィールドで設定された場合は、その値を削除または更新して、起動するたびに通知が繰り返されないようにします

916* 制限されたモデルへのアクセスが必要な場合は、組織の管理者に有効にするよう依頼します。[組織モデル制限](/ja/model-config#organization-model-restrictions) を参照してください

867 917 

868<h3 id="thinking-type-enabled-is-not-supported-for-this-model">918<h3 id="thinking-type-enabled-is-not-supported-for-this-model">

869 thinking.type.enabled is not supported for this model919 thinking.type.enabled はこのモデルではサポートされていません

870</h3>920</h3>

871 921 

872Claude Code バージョンが Sonnet 5、Opus 4.8、または Opus 4.7 の最小値より古いです。CLI は、モデルが受け入れなくなった思考設定を送信しました。922Claude Code バージョンが Sonnet 5、Opus 4.8、または Opus 4.7 の最小値より古いです。CLI は、モデルが受け入れなくなった思考設定を送信しました。


875API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.925API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

876```926```

877 927 

878**対応方法:**928**対処方法:**

879 

880{/* min-version: 2.1.197 */}}

881 929 

882* `claude update` を実行して Claude Code を再起動してください。Opus 4.7 v2.1.111 以降が必要です。Opus 4.8 v2.1.154 以降が必要です。Sonnet 5 v2.1.197 以降が必要です930* `claude update` を実行して Claude Code を再起動します。Opus 4.7 には v2.1.111 以降が必要です。Opus 4.8 には v2.1.154 以降が必要です。Sonnet 5 には v2.1.197 以降が必要です

883* アップグレードできない場合は、`/model` を実行して Opus 4.6 または Sonnet 4.6 を選択してください931* アップグレードできない場合は、`/model` を実行して Opus 4.6 または Sonnet 4.6 を選択します

884* {/* min-version: agent-sdk@0.3.197 */}}[Agent SDK](/ja/agent-sdk/overview)でこれに遭遇した場合は、SDK パッケージをアップグレードしてください。Opus 4.8 TypeScript SDK v0.3.154 以降と Python SDK v0.2.88 以降が必要です。Sonnet 5 TypeScript SDK v0.3.197 以降が必要です932* {/* min-version: agent-sdk@0.3.197 */}[Agent SDK](/ja/agent-sdk/overview) でこれが発生した場合は、SDK パッケージをアップグレードします。Opus 4.8 には TypeScript SDK v0.3.154 以降と Python SDK v0.2.88 以降が必要です。Sonnet 5 には TypeScript SDK v0.3.197 以降が必要です

885 933 

886<h3 id="thinking-budget-exceeds-output-limit">934<h3 id="thinking-budget-exceeds-output-limit">

887 Thinking budget exceeds output limit935 思考予算が出力制限を超えています

888</h3>936</h3>

889 937 

890設定された拡張思考予算が最大レスポンス長を超えているため、実際の回答用のスペースが残っていません。938設定された拡張思考予算が最大応答長を超えているため、実際の回答用のスペースが残っていません。

891 939 

892```text theme={null}940```text theme={null}

893API Error: 400 ... max_tokens must be greater than thinking.budget_tokens941API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

894```942```

895 943 

896Claude Code は Anthropic API でこれらの値を自動的に調整します。通常、Amazon Bedrock または Google Vertex AI でこのエラーが表示されるのは、[`MAX_THINKING_TOKENS`](/ja/env-vars)がプロバイダーの出力制限より高く設定されている場合、またはプランモードが思考予算を上げる場合です944Claude Code は Anthropic API でこれらの値を自動的に調整します。通常、Amazon Bedrock または Google Cloud Agent Platform でこのエラーが表示されるのは、[`MAX_THINKING_TOKENS`](/ja/env-vars) がプロバイダーの出力制限より高く設定されている場合、またはプランモードが思考予算を引き上げた場合です

897 945 

898**対応方法:**946**対処方法:**

899 947 

900* `MAX_THINKING_TOKENS` を低くするか、[`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/ja/env-vars)を思考予算より上に上げてください948* `MAX_THINKING_TOKENS` を下げるか、[`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/ja/env-vars) を思考予算より上に上げます

901* [拡張思考](/ja/model-config#extended-thinking)を参照して、予算が出力長とどのように相互作用するかを確認してください949* 予算が出力長とどのように相互作用するかについては、[拡張思考](/ja/model-config#extended-thinking) を参照してください

902 950 

903<h3 id="tool-use-or-thinking-block-mismatch">951<h3 id="tool-use-or-thinking-block-mismatch">

904 Tool use or thinking block mismatch952 ツール使用または思考ブロックの不一致

905</h3>953</h3>

906 954 

907会話履歴が矛盾した状態で API に到達しました通常、ツール呼び出しが中断されたか、ターンがストリーム中に編集された後です。955会話履歴が API に矛盾した状態で到達しました通常は、ツール呼び出しが中断されたか、ターンがストリーム中に編集された後です。

908 956 

909```text theme={null}957```text theme={null}

910API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.958API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.


912API Error: 400 ... thinking blocks ... cannot be modified960API Error: 400 ... thinking blocks ... cannot be modified

913```961```

914 962 

9153 つのバリアントはすべて同じことを意味します。履歴内の `tool_use`、`tool_result`、および `thinking` ブロックのシーケンスが、API が期待するものと一致しなくなりました。9633 つのバリアントすべてが同じことを意味します。履歴内の `tool_use`、`tool_result`、および `thinking` ブロックのシーケンスが、API が期待するものと一致しなくなりました。

916 964 

917**対応方法:**965**対処方法:**

918 966 

919* {/* max-version: 2.1.155 */}}Opus 4.7 または Opus 4.8 を使用している場合は、まず `claude update` を実行してください。v2.1.156 より前のバージョンは、通常のツール使用中にこのエラーをトリガーでき、`/rewind` はそれをクリアしません967* {/* max-version: 2.1.155 */}Opus 4.7 または Opus 4.8 を使用している場合は、最初に `claude update` を実行します。v2.1.156 より前のバージョンは、通常のツール使用中にこのエラーをトリガーでき、`/rewind` はそれをクリアしません

920* `/rewind` を実行するか、Esc 2 回押して、破損したターンの前のチェックポイントに戻り、そこから続行してください。[チェックポイント](/ja/checkpointing)を参照して、チェックポイントがどのように作成および復元されるかを確認してください。968* `/rewind` を実行するか、Esc キーを 2 回押して、破損したターンの前のチェックポイントに戻り、そこから続行しますチェックポイントがどのように作成および復元されるかについては、[チェックポイント](/ja/checkpointing) を参照してください

921 969 

922<h3 id="usage-policy-refusal">970<h3 id="usage-policy-refusal">

923 Usage Policy refusal971 使用ポリシー拒否

924</h3>972</h3>

925 973 

926API は、会話内のコンテンツが[利用規約](https://www.anthropic.com/legal/aup)チェックをトリガーしたため、応答を拒否しました。メッセージには、拒否が正しくないと思われる場合にサポートに引用できるリクエスト ID が含まれています。974API は、会話内のコンテンツが [使用ポリシー](https://www.anthropic.com/legal/aup) チェックをトリガーしたため、応答を拒否しました。メッセージには、拒否が正しくないと思われる場合にサポートに引用できるリクエスト ID が含まれています。

927 975 

928```text theme={null}976```text theme={null}

929API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.977API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

930```978```

931 979 

932チェックは最新のプロンプトだけでなく、会話全体を評価するため、同じセッションで新しいメッセージを送信すると、通常は同じ拒否が再度トリガーされます。`--continue` または `--resume` でセッションを終了して再度開いた後も同じことが当てはまります。ディスク上のトランスクリプトにはまだトリガーコンテンツが含まれているためです。980チェックは最新のプロンプトだけでなく、完全な会話を評価するため、同じセッションで新しいメッセージを送信すると、通常は同じ拒否が再度トリガーされます。同じことは、`--continue` または `--resume` でセッションを終了して再度開いた後にも適用されます。ディスク上のトランスクリプトにはまだトリガーコンテンツが含まれているためです。[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、および [Microsoft Foundry](/ja/microsoft-foundry) では、このメッセージはモデルのセーフティ対策がサイバーセキュリティトピックとしてフラグを立てたリクエストもカバーします。[セーフティ対策がサイバーセキュリティトピックをフラグ立てしました](#safety-measures-flagged-a-cybersecurity-topic) を参照してください。

933 981 

934**対応方法:**982**対処方法:**

935 983 

936* Esc 2 回押すか `/rewind` を実行して、拒否をトリガーしたターンの前のチェックポイントに戻り、その後、別の方法で言い換えるか、別のアプローチを取ってください。[チェックポイント](/ja/checkpointing)を参照してください984* Esc キーを 2 回押すか `/rewind` を実行して、拒否をトリガーしたターンの前のチェックポイントに戻り、別の方法で言い換えるか試します。[チェックポイント](/ja/checkpointing) を参照してください

937* どのターンが原因かを特定できない場合は、`/clear` を実行して同じプロジェクト内で新しい会話を開始してください以前の会話はディスクに保存され、`/resume` で利用可能なままです985* どのターンが原因かを特定できない場合は、`/clear` を実行して同じプロジェクトで新しい会話を開始します以前の会話はディスクに保持され、`/resume` で利用可能なままです

938* [非対話型モード](/ja/headless)(`-p`)では、巻き戻しが利用できないため、言い換えたプロンプトで再試行するか、`--continue` なしで新しいセッションを開始してください。ポリシーチェックはモデルによって異なるため、`--model` で別のモデルに切り替えると、場合によっては拒否が解決される可能性があります986* [非対話型モード](/ja/headless)(`-p`)では、巻き戻しが利用できないため、`--continue` なしの新しいセッションで言い換えたプロンプトで再試行します。ポリシーチェックはモデルによって異なるため、`--model` で別のモデルに切り替えると、場合によっては拒否が解決される可能性があります

987 

988<h3 id="safety-measures-flagged-a-cybersecurity-topic">

989 セーフティ対策がサイバーセキュリティトピックをフラグ立てしました

990</h3>

991 

992モデルのセーフティ対策が会話内のコンテンツをサイバーセキュリティトピックとしてフラグ立てしました。メッセージはリクエストをフラグ立てしたモデルに名前を付けます:

993 

994```text theme={null}

995API Error: Opus 4.8 has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.

996 

997If you were not engaging in a cybersecurity topic, please send feedback via /feedback.

998```

999 

1000メッセージは [Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude) にリンクしており、正当なサイバーセキュリティ作業へのアクセスを許可します。セーフガード自体はサーバー側であり、v2.1.203 より前のものです。このリリースはメッセージの文言とそれがリンクするページのみを変更しました。

1001 

1002表示内容はプロバイダーとモードによって異なります:

1003 

1004* [Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、および [Microsoft Foundry](/ja/microsoft-foundry) では、サイバーセキュリティフラグは代わりに [使用ポリシー拒否](#usage-policy-refusal) メッセージを生成します

1005* [非対話型モード](/ja/headless) は `/feedback` 文を省略します

1006 

1007{/* max-version: 2.1.202 */}v2.1.203 より前は、メッセージは `<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:` の後に免除フォームリンクが続きました。

1008 

1009**対処方法:**

1010 

1011* このコンテンツが必要な場合は、[Cyber Verification Program](https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude) を通じてアクセスを申請します

1012* リクエストがサイバーセキュリティトピックではなかった場合は、`/feedback` を実行して誤検知を報告します

1013* 同じセッションで作業を続けるには、Esc キーを 2 回押すか `/rewind` を実行して、フラグをトリガーしたターンの前のチェックポイントに戻り、別の方法を試します。[チェックポイント](/ja/checkpointing) を参照してください

1014 

1015<h2 id="installation-errors">

1016 インストールエラー

1017</h2>

1018 

1019これらのエラーは、[インストールスクリプト](/ja/setup#install-claude-code)、`claude install`、または `claude update` から Claude Code をインストールまたは更新する際に表示されます。セットアップ中の `command not found`、PATH、権限、および TLS の問題については、[インストールとログインのトラブルシューティング](/ja/troubleshoot-install)を参照してください。

1020 

1021<h3 id="installation-was-killed-before-it-could-finish">

1022 インストールが完了する前に終了しました

1023</h3>

1024 

1025インストールスクリプトは、`claude install` ステップがシグナルによって終了された場合に報告します。Linux では、終了コード 137 はプロセスが SIGKILL を受け取ったことを意味し、メモリが少ないホストでは通常、カーネルのメモリ不足(OOM)キラーです。スクリプトはこの説明を出力し、コード 137 で終了します。

1026 

1027```text theme={null}

1028Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

1029Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

1030```

1031 

1032その他の致命的なシグナルの場合、および macOS でのコード 137 の場合、スクリプトは `Installation was killed before it could finish (exit code <N>)` を出力し、実際の終了コードを表示し、メモリ不足の説明は省略します。メッセージは macOS と Linux が使用するインストールスクリプトから来ており、WSL 内のインストールもカバーしています。ネイティブ Windows インストールスクリプトはこれを出力しません。v2.1.200 より前では、スクリプトはシェルの単なる `Killed` 行でのみ終了していました。

1033 

1034**対処方法:**

1035 

1036* 他のプロセスを停止してメモリを解放し、インストーラーを再実行します

1037* スワップスペースを追加するか、より大きなインスタンスに移動します。[低メモリ Linux サーバーでのインストール終了](/ja/troubleshoot-install#install-killed-on-low-memory-linux-servers)を参照して、スワップファイルコマンドを確認してください。

1038 

1039<h3 id="the-connection-dropped-while-downloading-the-update">

1040 更新のダウンロード中に接続が切断されました

1041</h3>

1042 

1043`claude install`、`claude update`、または[自動アップデーター](/ja/setup#auto-updates)が Claude Code バイナリをフェッチしている間にダウンロードサーバーへの接続が閉じられ、リトライが回復しませんでした。Claude Code は、接続がドロップされた場合、転送が停止した場合、またはダウンロードされたファイルがチェックサムに失敗した場合、最大 3 回の試行でダウンロードを再試行します。404 などの完了した HTTP エラーは、サーバーが既に応答しているため再試行されません。{/* min-version: 2.1.202 */}v2.1.202 より前では、単一の接続ドロップはダウンロードを即座に失敗させ、リトライの代わりに単なるエラー `aborted` を表示していました。

1044 

1045```text theme={null}

1046The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

1047```

1048 

1049括弧内のテキストは、失敗した試行と基になるネットワークエラーを示します。`claude update` は stderr でメッセージの前に `Error: Failed to install native update` を付けます。

1050 

1051接続は保持されているがダウンロードが 10 分以内に完了しない場合、代わりに `Download timed out: exceeded the total deadline` で失敗します。Claude Code はタイムアウトしたダウンロードを再試行しません。これは、期限内に完了するのに十分な速度がない接続は、即座に再試行しても完了しないためです。以下の手順は両方のメッセージに適用されます。v2.1.205 より前では、同じ 10 分のデッドラインは HTTP クライアントの汎用 `timeout of 600000ms exceeded` として報告されていました。

1052 

1053通常の原因は、長い転送が完了する前に接続を閉じるプロキシまたはゲートウェイです。Claude Code バイナリは大きなダウンロードであるため、通常の API トラフィックに影響を与えないプロキシ接続制限でも、それでも中断される可能性があります。

1054 

1055**対処方法:**

1056 

1057* `claude update` を再度実行します。それ以外の場合は健全なネットワークで、ダウンロードは通常、次の実行で成功します。タイムアウトメッセージの場合は、より高速またはスロットルされていないネットワークから再度実行します。

1058* ネットワークがプロキシを必要とする場合は、インストーラーまたは `claude update` を実行する前に `HTTPS_PROXY` を設定します。[ネットワーク接続の確認](/ja/troubleshoot-install#check-network-connectivity)を参照してください。

1059* 企業プロキシが転送を閉じ続ける場合は、ネットワークチームに `downloads.claude.ai` からの完全なダウンロードを許可するよう依頼します。[ネットワークアクセス要件](/ja/network-config#network-access-requirements)を参照してください。

1060* インストール診断のためにシェルから `claude doctor` を実行します

939 1061 

940<h2 id="command-line-errors">1062<h2 id="command-line-errors">

941 Command-line errors1063 コマンドラインエラー

942</h2>1064</h2>

943 1065 

944これらのエラーは、Claude Code の `claude` コマンドラインの独自の検証から発生します。Claude Code はそれらを直ちに出力し、セッションを作成したり、API リクエストを送信したりする前に出力します1066これらのエラーは `claude` コマンドラインとそのサブコマンドから発生します。Claude Code はプロンプトを実行する前またはAPI リクエストを送信する前にこれらを出力します

945 1067 

946<h3 id="conflict-between-bg-and-print">1068<h3 id="conflict-between-bg-and-print">

947 Conflict between --bg and --print1069 \--bg --print の競合

948</h3>1070</h3>

949 1071 

950{/* min-version: 2.1.198 */}}1072このメッセージは Claude Code v2.1.198 以降が必要です。同じ `claude` 呼び出しで `--bg` を `-p` または `--print` と組み合わせました。`--bg` は[バックグラウンドセッション](/ja/agent-view#from-your-shell)を開始し、後で `claude agents` で接続できます。一方、`--print` は[非対話的に](/ja/headless)実行され、`claude agents` が接続するインタラクティブセッションを開始しません。v2.1.198 より前では、この組み合わせは接続できないバックグラウンドジョブを静かに作成していました。

951このメッセージには Claude Code v2.1.198 以降が必要です。同じ `claude` 呼び出しで `--bg` を `-p` または `--print` と組み合わせました。`--bg` は[バックグラウンドセッション](/ja/agent-view#from-your-shell)を開始し、後で `claude agents` で接続します。`--print` は[非対話的に](/ja/headless)実行され、`claude agents` が接続するインタラクティブセッションを開始しません。v2.1.198 より前では、この組み合わせは静かに接続できないバックグラウンドジョブを作成しました。

952 1073 

953```text theme={null}1074```text theme={null}

1075--bg と --print の競合: --print は `claude agents` が接続するインタラクティブセッションを開始しないため、ジョブは接続不可能になります。プロンプトは位置引数です — --print を削除してください: `claude --bg '<task>'`。

1076```

1077 

1078**対応方法:**

1079 

1080* `-p` または `--print` を削除してください。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` が完全なコマンドです。[シェルから新しいエージェントをディスパッチする](/ja/agent-view#from-your-shell)を参照してください。

1081* プロンプトを非対話的に実行し、バックグラウンドセッションを作成する代わりに結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行してください。

1082 

1083<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

1084 \--json-schema 値が有効な JSON Schema ではありません

1085</h3>

1086 

1087[非対話的モード](/ja/headless#get-structured-output)で [`--json-schema`](/ja/cli-reference#cli-flags) に渡したスキーマが JSON Schema コンパイルに失敗したため、`claude` はプロンプトを実行する代わりに終了コード 1 で終了します。v2.1.205 より前では、無効なスキーマは エラーなしで非構造化出力を生成し、`format` キーワードを使用したスキーマはすべて無効として扱われていました。

1088 

1089```text theme={null}

1090Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

1091```

1092 

10932 番目のコロンの後のテキストはバリデータの診断で、失敗したキーワードまたは場所を示します。`"format": "email"` などの `format` キーワードを使用するスキーマは有効です。Claude Code は `format` を注釈として受け入れ、強制しません。

1094 

1095Claude Code はスキーマコンパイルの前に 2 つのチェックを実行します。解析不可能な JSON の値は `Error: --json-schema is not valid JSON` で拒否され、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否されます。

1096 

1097**対応方法:**

1098 

1099* 診断が示すスキーマの部分を修正し、コマンドを再実行してください。

1100* 診断が `schema too large` の場合は、スキーマのネストと `$ref` の再利用を減らしてください。

1101* [構造化出力を取得する](/ja/headless#get-structured-output)で動作するスキーマとコマンドを参照してください。

1102 

1103<h3 id="could-not-import-a-server-from-claude-desktop">

1104 Claude Desktop からサーバーをインポートできませんでした

1105</h3>

1106 

1107Claude Code は `claude mcp add-from-claude-desktop` で選択したサーバーの 1 つを追加できませんでした。コマンドは他の選択されたサーバーをインポートし、追加できなかったサーバーごとに 1 行出力します。v2.1.205 より前では、失敗した最初のサーバーがインポートを停止し、選択されたサーバーは追加されませんでした。

1108 

1109```text theme={null}

1110Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

1111```

1112 

1113サーバー名の後のテキストは理由です。最も一般的なのは名前チェックです。Claude Desktop はサーバー名にスペースやピリオドなどの文字を許可していますが、`claude mcp` はこれらを文字、数字、ハイフン、アンダースコアのみに制限しています。その他の理由には、検証に失敗するサーバー設定と、組織の [MCP ポリシー](/ja/managed-mcp)によってブロックされたサーバーが含まれます。

1114 

1115**対応方法:**

1116 

1117* `claude_desktop_config.json` でサーバーの名前を変更して、文字、数字、ハイフン、アンダースコアのみを使用するようにしてから、`claude mcp add-from-claude-desktop` を再度実行してください。

1118* 有効な名前で `claude mcp add` または `claude mcp add-json` を使用してそのサーバーを直接追加してください。[Claude Desktop から MCP サーバーをインポートする](/ja/mcp#import-mcp-servers-from-claude-desktop)を参照してください。

1119 

1120<h2 id="plugin-errors">

1121 プラグインエラー

1122</h2>

1123 

1124これらのエラーは、[プラグイン](/ja/plugins)と[マーケットプレイス](/ja/plugin-marketplaces)の設定から発生します。このページのメッセージを生成しないプラグインの問題(マーケットプレイス URL が読み込まれない、またはプラグインがインストールされても表示されないなど)については、[プラグインのトラブルシューティング](/ja/discover-plugins#troubleshooting)を参照してください。

1125 

1126<h3 id="marketplace-is-registered-from-an-untrusted-source">

1127 マーケットプレイスが信頼されていないソースから登録されている

1128</h3>

1129 

1130マーケットプレイスは、[公式 Anthropic マーケットプレイス用に予約されている](/ja/plugin-marketplaces#marketplace-schema)名前で登録されていますが、登録されたソースが `anthropics` GitHub リポジトリではありません。Claude Code は、マーケットプレイスを読み込むか更新するたびに予約名を再確認するため、マーケットプレイスとそこからインストールされたプラグインの読み込みが停止します。v2.1.205 より前では、マーケットプレイスが追加されたときにのみ名前がチェックされていたため、その名前が予約される前に登録されたエントリは読み込み続けていました。

1131 

1132```text theme={null}

1133Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

1134```

1135 

1136**対処方法:**

1137 

1138* `claude plugin marketplace remove <name>` を実行してから、公式の `github.com/anthropics` リポジトリからマーケットプレイスを再度追加してください

1139* 名前が予約される前にその名前を使用していたサードパーティマーケットプレイスを公開している場合は、名前を変更し、ユーザーにあなたのソースから再度追加するよう依頼してください

1140* [マーケットプレイススキーマ](/ja/plugin-marketplaces#marketplace-schema)の予約名リストを参照してください

1141 

1142<h2 id="configuration-warnings">

1143 設定に関する警告

1144</h2>

1145 

1146Claude Code は、会話内にエラーを表示するのではなく、起動時にこれらのメッセージを stderr に書き込みます。これらは読み込まれたが適用されなかった設定を報告します。

1147 

1148<h3 id="workspace-has-not-been-trusted">

1149 ワークスペースが信頼されていません

1150</h3>

1151 

1152Claude Code は、プロジェクトの `.claude/settings.json` または `.claude/settings.local.json` で `permissions.allow` ルールまたは `permissions.additionalDirectories` エントリを見つけましたが、[プロジェクト設定からの allow ルールはワークスペース信頼が必要](/ja/permissions#project-allow-rules-and-workspace-trust)であるため、それらを適用しませんでした。メッセージに表示されるカウント、設定名、ファイル名は、設定によって異なります。`deny` ルールと `ask` ルールは影響を受けません。

1153 

1154```text theme={null}

1155Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

954```1156```

955 1157 

956**対応方法:**1158**対応方法:**

957 1159 

958* `-p` または `--print` をドロップしてください。`--bg` はプロンプトを位置引数として取るため`claude --bg "<task>"` が完全なコマンドです。[シェルから新しいエージェントをディスパッチ](/ja/agent-view#from-your-shell)を参照してください1160* ディレクトリで `claude` を実行し信頼ダイアログを受け入れます。{/* min-version: 2.1.200 */}親ディレクトリが既に信頼されている場合でも、ダイアログが表示され、保留中のルールが一覧表示され、それらなしで作業を続けることを拒否できますv2.1.200 より前では、その状況ではダイアログが表示されなかったため、そこではこのステップを完了できませんでした。

959* プロンプトを非対話的に実行し、バックグラウンドセッションを作成する代わりに結果を出力するには、`--bg` をドロップして `claude -p "<task>"` を実行してください1161* [非対話型モード](/ja/headless)で `-p` を使用する場合、ダイアログは表示されません。メッセージが出力する正確な `projects` キーを使用して、`~/.claude.json` `hasTrustDialogAccepted` エントリを設定します。

1162* {/* min-version: 2.1.200 */}メッセージが `.claude/settings.local.json` という名前で、git リポジトリの外またはホームディレクトリで Claude Code を起動した場合は、v2.1.200 以降に更新してください。バージョン 2.1.196 から 2.1.199 では、これらのワークスペースで独自の `.claude/settings.local.json` をリポジトリ提供として扱いました。[プロジェクト allow ルールとワークスペース信頼](/ja/permissions#project-allow-rules-and-workspace-trust)を参照してください。

960 1163 

961<h2 id="responses-seem-lower-quality-than-usual">1164<h2 id="responses-seem-lower-quality-than-usual">

962 Responses seem lower quality than usual1165 応答の品質がいつもより低いように見える

963</h2>1166</h2>

964 1167 

965Claude の回答がエラーなしで予想より能力が低いように見える場合、原因は通常、モデル自体ではなく会話状態です。Claude Code はモデルバージョンを静かに変更しません。3 つの特定のケースでフォールバックモデルに切り替えることができます1168Claude の回答がいつもより能力が低いように見えるがエラーが表示されていない場合、原因は通常、モデル自体ではなく会話の状態です。Claude Code はモデルバージョンを静かに変更することはありません。3 つの特定のケースでフォールバックモデルに切り替わることができます

1169 

1170* 設定された [`--fallback-model`](/ja/cli-reference#cli-flags) は可用性エラーの後、そのターンのみ引き継ぎ、トランスクリプトに通知が表示されます

1171* Amazon Bedrock または Google Cloud の Agent Platform スタートアップチェックがデフォルトモデルが利用不可であることを検出します

1172* [自動モデルフォールバック](/ja/model-config#automatic-model-fallback) は Fable 5 でセッションをデフォルトの Opus モデルに移動し、トランスクリプトに通知を表示します

966 1173 

967* 設定された [`--fallback-model`](/ja/cli-reference#cli-flags) は可用性エラーの後にそのターンのみ引き継ぎ、トランスクリプトに通知が表示されます1174以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします。最初のケースは `/model` の変更ではなくトランスクリプト通知として表示されます。[モデル設定](/ja/model-config) は各フォールバックが適用される時期を説明しています。

968* Bedrock または Vertex AI スタートアップチェックがデフォルトモデルが利用不可であることを検出します

969* [Automatic model fallback](/ja/model-config#automatic-model-fallback) on Fable 5 はセッションをデフォルト Opus モデルに移動し、トランスクリプトに通知を表示します

970 1175 

971以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします。最初のケースはトランスクリプト通知として表示され、`/model` 変更ではなく表示されます。[Model configuration](/ja/model-config) はそれぞれのフォールバックが適用される場合を説明しています1176まずこれらを確認してください

972 1177 

973最初にこれらを確認してください1178* **モデル選択**: `/model` を実行して、期待するモデルにいることを確認します以前の `/model` の選択または `ANTHROPIC_MODEL` 環境変数により、意図したより小さいモデルにいる可能性があります。

1179* **努力レベル**: `/effort` を実行して現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げます。デフォルトはモデルによって異なるため、最大値以下であると仮定する前に確認してください。[努力レベルを調整](/ja/model-config#adjust-effort-level) でモデルごとのデフォルトと `ultrathink` ショートカットを参照してください。

1180* **コンテキスト圧力**: `/context` を実行してウィンドウがどの程度満杯かを確認します。容量に近い場合は、自然な区切り点で `/compact` を実行するか、新しく開始するために `/clear` を実行します。[コンテキストウィンドウを探索](/ja/context-window) で自動コンパクトが以前のターンにどのように影響するかを参照してください。

1181* **古い指示**: 大きいまたは古い `CLAUDE.md` ファイルと MCP ツール定義はコンテキストを消費し、応答を操作できます。{/* min-version: 2.1.205 */}`/doctor` チェックアップは過度に大きいメモリファイルと未使用の拡張機能にフラグを立て、`/context` は MCP ツールトークン使用量を表示します。v2.1.205 より前では、`/doctor` は過度に大きいメモリファイルとサブエージェント定義にフラグを立てた診断画面を開きました。

974 1182 

975* **モデル選択**:`/model` を実行して予想されるモデルにいることを確認してください以前の `/model` 選択または `ANTHROPIC_MODEL` 環境変数により意図したより小さいモデルにいる可能性があります1183応答がうまくいかない場合修正で返信するよりも通常は巻き戻しの方がうまく機能しますEsc 2 回押すか `/rewind` を実行して悪いターンの前に戻りより具体的なプロンプトで言い換えますスレッド内で修正すると、間違った試みがコンテキストに残り、後の回答をそれに固定する可能性があります。[チェックポイント](/ja/checkpointing) を参照してください。

976* **努力レベル**:`/effort` を実行して、現在の推論レベルを確認し、難しいデバッグまたは設計作業のためにそれを上げてください。デフォルトはモデルによって異なるため、最大値より下にあると仮定する前に確認してください。[Adjust effort level](/ja/model-config#adjust-effort-level)を参照して、モデルごとのデフォルトと `ultrathink` ショートカットを確認してください。

977* **コンテキスト圧力**:`/context` を実行して、ウィンドウがどの程度満杯かを確認してください。容量に近い場合は、自然な区切り点で `/compact` を実行するか、`/clear` を実行して新しく開始してください。[Explore the context window](/ja/context-window)を参照して、自動コンパクトが以前のターンにどのように影響するかを確認してください。

978* **古い指示**:大きなまたは古い `CLAUDE.md` ファイルと MCP ツール定義はコンテキストを消費し、レスポンスを操作できます。`/doctor` は大きなメモリファイルとサブエージェント定義にフラグを立てます。`/context` は MCP ツールトークン使用量を表示します。

979 1184 

980レスポンスが間違っている場合修正で返信するより巻き戻しの方が通常うまくいきますEsc を 2 回押すか、`/rewind` を実行して悪いターンの前に戻り、より詳細なプロンプトで言い換えてください。スレッド内で修正すると、間違った試みがコンテキストに残り後の回答をそれに固定できます。[Checkpointing](/ja/checkpointing)を参照してください。1185上記を確認した後も品質がまだおかしいように見える場合は`/feedback` を実行して期待したものと得たものを説明してくださいこの方法で送信されたフィードバックには会話トランスクリプトが含まれており、Anthropic が実際の回帰を診断する最速の方法です。環境で `/feedback` が利用できない場合は、[エラーを報告](#report-an-error) を参照してください。

981 1186 

982上記を確認した後も品質が異常に見える場合は、`/feedback` を実行して、期待したものと得たものを説明してください。このように送信されたフィードバックには会話トランスクリプトが含まれておりAnthropic が実際の回帰を診断する最速の方法です。環境で `/feedback` が利用できない場合は、[Report an error](#report-an-error)を参照してください1187{/* min-version: 2.1.201 */}Sonnet 5 がリクエストを拒否しClaude Code v2.1.200 以前で疑わしいプロンプトインジェクションを引用する場合は、`claude update` を実行して v2.1.201 修正を取得します

983 1188 

984<h2 id="report-an-error">1189<h2 id="report-an-error">

985 Report an error1190 エラーを報告する

986</h2>1191</h2>

987 1192 

988このページでは Claude API からのエラーについて説明しています。Claude Code の他のコンポーネントからのエラーについては、関連するガイドを参照してください。1193このページでカバーされていないコンポーネントからのエラーについては、関連するガイドを参照してください。

989 1194 

990* MCP サーバーが接続または認証に失敗しました:[MCP](/ja/mcp)1195* MCP サーバーが接続またはアテンティケーションに失敗した場合:[MCP](/ja/mcp)

991* フックスクリプトが失敗したかツールをブロックしました:[フックをデバッグする](/ja/hooks#debug-hooks)1196* フック スクリプトが失敗したかツールをブロックした場合:[フックのデバッグ](/ja/hooks#debug-hooks)

992* インストール中に権限が拒否されたか、ファイルシステムエラーが発生しました:[インストールとログインのトラブルシューティング](/ja/troubleshoot-install)1197* インストール中にパーミッション拒否またはファイルシステム エラーが発生した場合:[インストールとログインのトラブルシューティング](/ja/troubleshoot-install)

993 1198 

994エラーがここに記載されていない場合、または提案された修正が役に立たない場合:1199ここにエラーが記載されていない場合、または提案された修正が役に立たない場合:

995 1200 

996* Claude Code 内で `/feedback` を実行して、トランスクリプトと説明を Anthropic に送信してくださいコマンドは、事前入力された GitHub イシューを開くことも提供します。Bedrock、Vertex AI、Foundry、およびその他のサードパーティプロバイダーでは、`/feedback` はローカルアーカイブを保存し、Anthropic アカウント担当者に送信できます。1201* Claude Code 内で `/feedback` を実行して、トランスクリプトと説明を Anthropic に送信しますこのコマンドは、事前入力された GitHub issue を開くオプションも提供しますAmazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、およびその他のサードパーティ プロバイダーでは、`/feedback` はローカル アーカイブを保存し、Anthropic アカウント担当者に送信できます。

997* `/doctor` を実行してローカル設定の問題を確認してください1202* シェルから `claude doctor` を実行して、インストールの読み取り専用診断を実行するか、Claude Code 内で `/doctor` チェックアップを実行してセットアップの問題を検出して修正します。

998* [status.claude.com](https://status.claude.com)でアクティブなインシデントを確認してください1203* [status.claude.com](https://status.claude.com) で有効なインシデントを確認します。

999* GitHub の[既存のイシュー](https://github.com/anthropics/claude-code/issues)を検索してください1204* GitHub の[既存の issue](https://github.com/anthropics/claude-code/issues) を検索します。

fast-mode.md +3 −3

Details

38* `/fast` と入力して Tab キーを押してオンまたはオフに切り替える38* `/fast` と入力して Tab キーを押してオンまたはオフに切り替える

39* [ユーザー設定ファイル](/ja/settings)で `"fastMode": true` を設定する39* [ユーザー設定ファイル](/ja/settings)で `"fastMode": true` を設定する

40 40 

41デフォルトでは、高速モードはセッション全体で保持されます。管理者は高速モードを各セッションでリセットするように構成できます。詳細は[セッションごとのオプトインが必要](#require-per-session-opt-in)を参照してください。41デフォルトでは、インタラクティブセッションで有効にした高速モードはセッション全体で保持されます{/* min-version: 2.1.205 */}[非インタラクティブモード](/ja/headless)では、`-p` フラグを使用して、`/fast` は [`--settings`](/ja/cli-reference#cli-flags) 値で高速モードを使用して起動されたセッションでのみ機能します。例えば `claude -p --settings '{"fastMode": true}'` のように使用します。その場合、切り替えはそのセッションにのみ適用され、デフォルトとして保存されず、他の非インタラクティブセッションではコマンドが高速モードが利用できないことを報告します。管理者は高速モードを各セッションでリセットするように構成できます。詳細は[セッションごとのオプトインが必要](#require-per-session-opt-in)を参照してください。

42 42 

43最高のコスト効率を得るには、会話の途中で切り替えるのではなく、セッションの開始時に高速モードを有効にします。詳細は[コストのトレードオフを理解する](#understand-the-cost-tradeoff)を参照してください。43最高のコスト効率を得るには、会話の途中で切り替えるのではなく、セッションの開始時に高速モードを有効にします。詳細は[コストのトレードオフを理解する](#understand-the-cost-tradeoff)を参照してください。

44 44 


103 103 

104高速モードには以下のすべてが必要です:104高速モードには以下のすべてが必要です:

105 105 

106* **Anthropic API またはサブスクリプションのみ**:高速モードは Anthropic Console API および使用量クレジットを使用する Claude サブスクリプションプランで利用可能です。Amazon Bedrock、Google Vertex AI、Microsoft Azure Foundry、または AWS 上の Claude Platform では利用できません。106* **Anthropic API またはサブスクリプションのみ**:高速モードは Anthropic Console API および使用量クレジットを使用する Claude サブスクリプションプランで利用可能です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform では利用できません。

107* **使用量クレジットが有効**:アカウントで使用量クレジットが有効になっている必要があります。これにより、プランに含まれる使用量を超えて請求できます。個人アカウントの場合、[Console 請求設定](https://platform.claude.com/settings/organization/billing)で有効にします。Team および Enterprise の場合、管理者が組織の使用量クレジットを有効にする必要があります。107* **使用量クレジットが有効**:アカウントで使用量クレジットが有効になっている必要があります。これにより、プランに含まれる使用量を超えて請求できます。個人アカウントの場合、[Console 請求設定](https://platform.claude.com/settings/organization/billing)で有効にします。Team および Enterprise の場合、管理者が組織の使用量クレジットを有効にする必要があります。

108 108 

109<Note>109<Note>


131 セッションごとのオプトインが必要131 セッションごとのオプトインが必要

132</h3>132</h3>

133 133 

134デフォルトでは、高速モードはセッション全体で保持されますユーザーが高速モードを有効にすると、将来のセッションでもオンのままです。[Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) または [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) プランの管理者は、[管理設定](/ja/settings#settings-files)または[サーバー管理設定](/ja/server-managed-settings)で `fastModePerSessionOptIn` を `true` に設定することでこれを防ぐことができます。これにより、各セッションは高速モードがオフで開始され、ユーザーが `/fast` で明示的に有効にする必要があります。134デフォルトでは、ユーザーがインタラクティブセッションで有効にした高速モードはセッション全体で保持されます:将来のセッションでもオンのままです。[Team](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_teams#team-&-enterprise) または [Enterprise](https://anthropic.com/contact-sales?utm_source=claude_code\&utm_medium=docs\&utm_content=fast_mode_enterprise) プランの管理者は、[管理設定](/ja/settings#settings-files)または[サーバー管理設定](/ja/server-managed-settings)で `fastModePerSessionOptIn` を `true` に設定することでこれを防ぐことができます。これにより、各セッションは高速モードがオフで開始され、ユーザーが `/fast` で明示的に有効にする必要があります。

135 135 

136```json theme={null}136```json theme={null}

137{137{

Details

4 4 

5# 機能の利用可能性5# 機能の利用可能性

6 6 

7> Anthropic のサブスクリプションプラン、Anthropic Console、Amazon Bedrock、Claude Platform on AWS、Google Vertex AI、Microsoft Foundry 全体で利用可能な Claude Code 機能を比較します。7> Anthropic のサブスクリプションプラン、Anthropic Console、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry 全体で利用可能な Claude Code 機能を比較します。

8 8 

9Claude Code CLI とローカルで実行されるすべてのものは、すべてのプロバイダーで同じように動作します。プロバイダーごとのセットアップ手順については、[エンタープライズデプロイメント概要](/ja/third-party-integrations)を参照してください。プロバイダーで不足している機能に直接進みたい場合は、[プロバイダー別サマリー](#summary-by-provider)タブを参照してください。9Claude Code CLI とローカルで実行されるすべてのものは、すべてのプロバイダーで同じように動作します。プロバイダーごとのセットアップ手順については、[エンタープライズデプロイメント概要](/ja/third-party-integrations)を参照してください。プロバイダーで不足している機能に直接進みたい場合は、[プロバイダー別サマリー](#summary-by-provider)タブを参照してください。

10 10 


18 18 

19* **Claude サブスクリプション**:Pro、Max、Team、または Enterprise プランで claude.ai アカウントでサインインします19* **Claude サブスクリプション**:Pro、Max、Team、または Enterprise プランで claude.ai アカウントでサインインします

20* **Anthropic Console**:Anthropic API キーで認証します20* **Anthropic Console**:Anthropic API キーで認証します

21* **Amazon Bedrock**:Bedrock モデルカタログから Claude モデルを使用し、`CLAUDE_CODE_USE_BEDROCK` を設定します。[Mantle エンドポイント](/ja/amazon-bedrock#use-the-mantle-endpoint)(`CLAUDE_CODE_USE_MANTLE`)はこの列でカバーされています21* **Amazon Bedrock**:Amazon Bedrock モデルカタログから Claude モデルを使用し、`CLAUDE_CODE_USE_BEDROCK` を設定します。[Mantle エンドポイント](/ja/amazon-bedrock#use-the-mantle-endpoint)(`CLAUDE_CODE_USE_MANTLE`)はこの列でカバーされています

22* **Claude Platform on AWS**:AWS Marketplace を通じて Claude を購入しましたが、Anthropic API を呼び出し、`CLAUDE_CODE_USE_ANTHROPIC_AWS` を設定します22* **Claude Platform on AWS**:AWS Marketplace を通じて Claude を購入しましたが、Anthropic API を呼び出し、`CLAUDE_CODE_USE_ANTHROPIC_AWS` を設定します

23* **Google Vertex AI**:Google が運営しており、`CLAUDE_CODE_USE_VERTEX` を設定します23* **Google Cloud の Agent Platform**:Google が運営しており、`CLAUDE_CODE_USE_VERTEX` を設定します

24* **Microsoft Foundry**:Azure 上で Anthropic が運営しており、`CLAUDE_CODE_USE_FOUNDRY` を設定します24* **Microsoft Foundry**:Azure 上で Anthropic が運営しており、`CLAUDE_CODE_USE_FOUNDRY` を設定します

25 25 

26<h3 id="features-available-on-every-provider">26<h3 id="features-available-on-every-provider">


53* [Artifacts](/ja/artifacts):Pro、Max、Team、および Enterprise プラン53* [Artifacts](/ja/artifacts):Pro、Max、Team、および Enterprise プラン

54* [Voice dictation](/ja/voice-dictation)54* [Voice dictation](/ja/voice-dictation)

55 55 

56Desktop は部分的な例外です:Enterprise デプロイメントは、[管理設定](https://support.claude.com/en/articles/12622667-enterprise-configuration)を介して Desktop を Vertex AI またはゲートウェイプロバイダーにルーティングでき、[Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview) は Code タブを Bedrock、Vertex AI、Foundry、または自己ホスト型 LLM ゲートウェイで実行します。これらの機能のプラン別利用可能性については、[サブスクリプションプラン別の利用可能性](#availability-by-subscription-plan)を参照してください。56Desktop は部分的な例外です:Enterprise デプロイメントは、[管理設定](https://support.claude.com/en/articles/12622667-enterprise-configuration)を介して Desktop を Google Cloud の Agent Platform またはゲートウェイプロバイダーにルーティングでき、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) は Code タブを Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、または自己ホスト型 LLM ゲートウェイで実行します。これらの機能のプラン別利用可能性については、[サブスクリプションプラン別の利用可能性](#availability-by-subscription-plan)を参照してください。

57 57 

58<h3 id="cli-capabilities-that-vary-by-provider">58<h3 id="cli-capabilities-that-vary-by-provider">

59 プロバイダーによって異なる CLI 機能59 プロバイダーによって異なる CLI 機能


69 <th>Anthropic Console</th>69 <th>Anthropic Console</th>

70 <th>Amazon Bedrock</th>70 <th>Amazon Bedrock</th>

71 <th>Claude Platform on AWS</th>71 <th>Claude Platform on AWS</th>

72 <th>Google Vertex AI</th>72 <th>Google Cloud の Agent Platform</th>

73 <th>Microsoft Foundry</th>73 <th>Microsoft Foundry</th>

74 </tr>74 </tr>

75 </thead>75 </thead>


161 <th>Anthropic Console</th>161 <th>Anthropic Console</th>

162 <th>Amazon Bedrock</th>162 <th>Amazon Bedrock</th>

163 <th>Claude Platform on AWS</th>163 <th>Claude Platform on AWS</th>

164 <th>Google Vertex AI</th>164 <th>Google Cloud の Agent Platform</th>

165 <th>Microsoft Foundry</th>165 <th>Microsoft Foundry</th>

166 </tr>166 </tr>

167 </thead>167 </thead>


199 </tbody>199 </tbody>

200</table>200</table>

201 201 

202<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Vertex AI では、Claude 4 モデル以降で Web 検索が利用可能です。<br />202<span id="fn1" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>1</sup> Google Cloud の Agent Platform では、Claude 4 モデル以降で Web 検索が利用可能です。<br />

203<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> `CLAUDE_CODE_ENABLE_AUTO_MODE` が必要です。[Auto mode 設定](/ja/auto-mode-config)を参照してください。<br />203<span id="fn2" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>2</sup> `CLAUDE_CODE_ENABLE_AUTO_MODE` が必要です。[Auto mode 設定](/ja/auto-mode-config)を参照してください。<br />

204<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> `/loop every 2 hours` などの明示的な間隔はすべてのプロバイダーで動作します。Bedrock、Vertex AI、および Foundry では、`/loop` は独自の間隔を選択したり、デフォルトのメンテナンスプロンプトを提供したりできないため、間隔のないプロンプトは 10 分ごとに実行され、引数のない `/loop` は使用メッセージを表示します。[スケジュール済みタスク](/ja/scheduled-tasks)を参照してください。<br />204<span id="fn3" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>3</sup> `/loop every 2 hours` などの明示的な間隔はすべてのプロバイダーで動作します。Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry では、`/loop` は独自の間隔を選択したり、デフォルトのメンテナンスプロンプトを提供したりできないため、間隔のないプロンプトは 10 分ごとに実行され、引数のない `/loop` は使用メッセージを表示します。[スケジュール済みタスク](/ja/scheduled-tasks)を参照してください。<br />

205<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> クラウドプロバイダーとの契約に従います。<br />205<span id="fn4" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>4</sup> クラウドプロバイダーとの契約に従います。<br />

206<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> ダッシュボードと API のみ。[貢献メトリクス](/ja/analytics#enable-contribution-metrics)には claude.ai Team または Enterprise 組織が必要です。206<span id="fn5" style={{display: 'block', position: 'relative', top: '-120px'}} /><sup>5</sup> ダッシュボードと API のみ。[貢献メトリクス](/ja/analytics#enable-contribution-metrics)には claude.ai Team または Enterprise 組織が必要です。

207 207 


213 プロバイダー別サマリー213 プロバイダー別サマリー

214</h3>214</h3>

215 215 

216各タブには、そのプロバイダーで利用不可または部分的にサポートされている機能と、存在する場合は代替案が記載されています。記載されていないすべてのものは Claude サブスクリプションと同じように動作します。Bedrock、Vertex AI、Foundry、および Claude Platform on AWS では、Anthropic へのエラー報告とテレメトリはデフォルトでオフです。[API プロバイダー別のデフォルト動作](/ja/data-usage#default-behaviors-by-api-provider)を参照して、どのトラフィックが Anthropic に到達し、オプトアウトする方法を確認してください。216各タブには、そのプロバイダーで利用不可または部分的にサポートされている機能と、存在する場合は代替案が記載されています。記載されていないすべてのものは Claude サブスクリプションと同じように動作します。Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、および Claude Platform on AWS では、Anthropic へのエラー報告とテレメトリはデフォルトでオフです。[API プロバイダー別のデフォルト動作](/ja/data-usage#default-behaviors-by-api-provider)を参照して、どのトラフィックが Anthropic に到達し、オプトアウトする方法を確認してください。

217 217 

218<Tabs>218<Tabs>

219 <Tab title="Amazon Bedrock">219 <Tab title="Amazon Bedrock">


221 221 

222 **部分的なサポート:**222 **部分的なサポート:**

223 223 

224 * [Desktop](/ja/desktop):[Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview) 経由のみ224 * [Desktop](/ja/desktop):[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) 経由のみ

225 * [Auto mode](/ja/auto-mode-config):`CLAUDE_CODE_ENABLE_AUTO_MODE` を設定225 * [Auto mode](/ja/auto-mode-config):`CLAUDE_CODE_ENABLE_AUTO_MODE` を設定

226 * [`/loop`](/ja/scheduled-tasks):明示的な間隔のみ226 * [`/loop`](/ja/scheduled-tasks):明示的な間隔のみ

227 * [Zero Data Retention](/ja/zero-data-retention):AWS 契約に従う227 * [Zero Data Retention](/ja/zero-data-retention):AWS 契約に従う


237 **代替案:** スケジューリングの場合、`/schedule` の代わりに [`/loop`](/ja/scheduled-tasks) を使用してください。クラウドセッションの場合、[GitHub Actions](/ja/github-actions) または [GitLab CI/CD](/ja/gitlab-ci-cd) を使用してください。237 **代替案:** スケジューリングの場合、`/schedule` の代わりに [`/loop`](/ja/scheduled-tasks) を使用してください。クラウドセッションの場合、[GitHub Actions](/ja/github-actions) または [GitLab CI/CD](/ja/gitlab-ci-cd) を使用してください。

238 </Tab>238 </Tab>

239 239 

240 <Tab title="Google Vertex AI">240 <Tab title="Google Cloud の Agent Platform">

241 **利用不可:** すべての [Claude サブスクリプションが必要な機能](#features-that-require-a-claude-subscription)、および [Fast mode](/ja/fast-mode)、[Advisor](/ja/advisor)、[Channels](/ja/channels)、[アナリティクスダッシュボード](/ja/analytics)、および [サーバー管理設定](/ja/server-managed-settings)。241 **利用不可:** すべての [Claude サブスクリプションが必要な機能](#features-that-require-a-claude-subscription)、および [Fast mode](/ja/fast-mode)、[Advisor](/ja/advisor)、[Channels](/ja/channels)、[アナリティクスダッシュボード](/ja/analytics)、および [サーバー管理設定](/ja/server-managed-settings)。

242 242 

243 **部分的なサポート:**243 **部分的なサポート:**

244 244 

245 * [Desktop](/ja/desktop):[管理設定](https://support.claude.com/en/articles/12622667-enterprise-configuration)または [Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview) 経由245 * [Desktop](/ja/desktop):[管理設定](https://support.claude.com/en/articles/12622667-enterprise-configuration)または [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) 経由

246 * [Web 検索](/ja/tools-reference#websearch-tool-behavior):Claude 4 モデル以降246 * [Web 検索](/ja/tools-reference#websearch-tool-behavior):Claude 4 モデル以降

247 * [Auto mode](/ja/auto-mode-config):`CLAUDE_CODE_ENABLE_AUTO_MODE` を設定247 * [Auto mode](/ja/auto-mode-config):`CLAUDE_CODE_ENABLE_AUTO_MODE` を設定

248 * [`/loop`](/ja/scheduled-tasks):明示的な間隔のみ248 * [`/loop`](/ja/scheduled-tasks):明示的な間隔のみ


256 256 

257 **部分的なサポート:**257 **部分的なサポート:**

258 258 

259 * [Desktop](/ja/desktop):[Cowork on 3P research preview](https://claude.com/docs/cowork/3p/overview) 経由のみ259 * [Desktop](/ja/desktop):[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview) 経由のみ

260 * [Auto mode](/ja/auto-mode-config):`CLAUDE_CODE_ENABLE_AUTO_MODE` を設定260 * [Auto mode](/ja/auto-mode-config):`CLAUDE_CODE_ENABLE_AUTO_MODE` を設定

261 * [`/loop`](/ja/scheduled-tasks):明示的な間隔のみ261 * [`/loop`](/ja/scheduled-tasks):明示的な間隔のみ

262 * [Zero Data Retention](/ja/zero-data-retention):Azure 契約に従う262 * [Zero Data Retention](/ja/zero-data-retention):Azure 契約に従う


275 サブスクリプションプラン別の利用可能性275 サブスクリプションプラン別の利用可能性

276</h2>276</h2>

277 277 

278Bedrock、Vertex AI、Foundry、または Anthropic Console API キーを通じて認証する場合、このセクションは適用されません。claude.ai アカウントでサインインすると、プランによって以下の機能の利用可能性が決まります。278Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、または Anthropic Console API キーを通じて認証する場合、このセクションは適用されません。claude.ai アカウントでサインインすると、プランによって以下の機能の利用可能性が決まります。

279 279 

280| 機能 | Pro | Max | Team | Enterprise |280| 機能 | Pro | Max | Team | Enterprise |

281| :-------------------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |281| :-------------------------------------------------------------------------------------- | :-- | :-- | :------------ | :-------------------------------- |


303 モデルの利用可能性303 モデルの利用可能性

304</h2>304</h2>

305 305 

306プロバイダーとリージョンごとに利用可能な Claude モデルとコンテキストウィンドウサイズについては、[モデル設定](/ja/model-config)と [モデル概要](https://platform.claude.com/docs/en/about-claude/models/overview)を参照してください。Vision、PDF 入力、および拡張思考はモデル機能であり Claude Code 機能ではなく、モデルを提供するすべてのプロバイダーで動作します。[Prompt caching](/ja/prompt-caching) はほとんどのプロバイダーで同じように動作します。Bedrock では、サポートはモデルによって異なります。306プロバイダーとリージョンごとに利用可能な Claude モデルとコンテキストウィンドウサイズについては、[モデル設定](/ja/model-config)と [モデル概要](https://platform.claude.com/docs/en/about-claude/models/overview)を参照してください。Vision、PDF 入力、および拡張思考はモデル機能であり Claude Code 機能ではなく、モデルを提供するすべてのプロバイダーで動作します。[Prompt caching](/ja/prompt-caching) はほとんどのプロバイダーで同じように動作します。Amazon Bedrock では、サポートはモデルによって異なります。

307 307 

308<h2 id="related-resources">308<h2 id="related-resources">

309 関連リソース309 関連リソース

310</h2>310</h2>

311 311 

312* [エンタープライズデプロイメント概要](/ja/third-party-integrations):プロバイダー全体で認証、請求、およびリージョンを比較312* [エンタープライズデプロイメント概要](/ja/third-party-integrations):プロバイダー全体で認証、請求、およびリージョンを比較

313* プロバイダーセットアップガイド:[Amazon Bedrock](/ja/amazon-bedrock)、[Claude Platform on AWS](/ja/claude-platform-on-aws)、[Google Vertex AI](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry)313* プロバイダーセットアップガイド:[Amazon Bedrock](/ja/amazon-bedrock)、[Claude Platform on AWS](/ja/claude-platform-on-aws)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry)

314* [プラットフォームと統合](/ja/platforms):CLI、Desktop、IDE 拡張機能、Web、モバイル、CI/CD を含む Claude Code が実行される場所314* [プラットフォームと統合](/ja/platforms):CLI、Desktop、IDE 拡張機能、Web、モバイル、CI/CD を含む Claude Code が実行される場所

fullscreen.md +3 −1

Details

168 168 

169フルスクリーンレンダリングは iTerm2 の tmux 統合モード(`tmux -CC` で入るモード)と互換性がありません。統合モードでは、iTerm2 は各 tmux ペインをネイティブスプリットとしてレンダリングし、tmux がターミナルに描画することを許可しません。代替スクリーンバッファとマウストラッキングはそこで正しく機能しません。マウスホイールは何もしませんし、ダブルクリックはターミナル状態を破損する可能性があります。`tmux -CC` セッションでフルスクリーンレンダリングを有効にしないでください。`-CC` なしの iTerm2 内の通常の tmux は正常に機能します。169フルスクリーンレンダリングは iTerm2 の tmux 統合モード(`tmux -CC` で入るモード)と互換性がありません。統合モードでは、iTerm2 は各 tmux ペインをネイティブスプリットとしてレンダリングし、tmux がターミナルに描画することを許可しません。代替スクリーンバッファとマウストラッキングはそこで正しく機能しません。マウスホイールは何もしませんし、ダブルクリックはターミナル状態を破損する可能性があります。`tmux -CC` セッションでフルスクリーンレンダリングを有効にしないでください。`-CC` なしの iTerm2 内の通常の tmux は正常に機能します。

170 170 

171tmux は同期出力をサポートしていないため、Claude Code を直接ターミナルで実行する場合よりも、再描画中により多くのちらつきが見える可能性があります。特に SSH 経由でちらつきが目立つ場合は、Claude Code を tmux の外の独自のターミナルタブで実行してください。171すべての tmux バージョンがアプリケーションからの同期出力を適用するわけではないため、Claude Code を直接ターミナルで実行する場合よりも、tmux 下での再描画中により多くのちらつきが見える可能性があります。特に SSH 経由でちらつきが目立つ場合は、最新の tmux にアップグレードするか、Claude Code を tmux の外の独自のターミナルタブで実行してください。tmux のバージョンは `tmux -V` で確認できます。

172 

173{/* min-version: 2.1.200 */}Claude Code は `TERM_PROGRAM_VERSION` 変数から tmux 3.4 以降を検出すると、同期出力を自動的にオンにします。バージョンを判定できない場合は、ターミナルに直接クエリを実行して同期出力サポートにフォールバックします。再描画が実際にアトミックになるかどうかは、tmux が同期出力を尊重するかどうかによって異なります。tmux 3.4 以降でもちらつきが見える場合は、最新の tmux にアップグレードしてください。この検出には Claude Code v2.1.200 以降が必要です。

172 174 

173<h2 id="keep-native-text-selection">175<h2 id="keep-native-text-selection">

174 ネイティブテキスト選択を保持する176 ネイティブテキスト選択を保持する

github-actions.md +25 −25

Details

51<Note>51<Note>

52 * GitHub アプリをインストールしてシークレットを追加するには、リポジトリ管理者である必要があります52 * GitHub アプリをインストールしてシークレットを追加するには、リポジトリ管理者である必要があります

53 * GitHub アプリは、Contents、Issues、Pull requests に対する読み取りと書き込みのアクセス許可をリクエストします53 * GitHub アプリは、Contents、Issues、Pull requests に対する読み取りと書き込みのアクセス許可をリクエストします

54 * このクイックスタート方法は、直接 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 Cloud Agent Platform を使用している場合は、[Amazon Bedrock と Google Cloud での使用](#using-with-amazon-bedrock-and-google-cloud) セクションを参照してください。

55</Note>55</Note>

56 56 

57<h2 id="manual-setup">57<h2 id="manual-setup">


320 イシューまたは PR コメントに応答する場合、Claude は自動的に @claude メンションに応答します。その他のイベントについては、`prompt` パラメータを使用して指示を提供します。320 イシューまたは PR コメントに応答する場合、Claude は自動的に @claude メンションに応答します。その他のイベントについては、`prompt` パラメータを使用して指示を提供します。

321</Tip>321</Tip>

322 322 

323<h2 id="using-with-amazon-bedrock--google-vertex-ai">323<h2 id="using-with-amazon-bedrock-and-google-cloud">

324 Amazon Bedrock と Google Vertex AI での使用324 Amazon Bedrock と Google Cloud での使用

325</h2>325</h2>

326 326 

327エンタープライズ環境では、Claude Code GitHub Actions を独自のクラウドインフラストラクチャで使用できます。このアプローチにより、データレジデンシーと請求を制御しながら、同じ機能を維持できます。327エンタープライズ環境では、Claude Code GitHub Actions を独自のクラウドインフラストラクチャで使用できます。このアプローチにより、データレジデンシーと請求を制御しながら、同じ機能を維持できます。


332 332 

333クラウドプロバイダーで Claude Code GitHub Actions をセットアップする前に、以下が必要です。333クラウドプロバイダーで Claude Code GitHub Actions をセットアップする前に、以下が必要です。

334 334 

335<h4 id="for-google-cloud-vertex-ai">335<h4 id="for-google-cloud’s-agent-platform">

336 Google Cloud Vertex AI の場合:336 Google Cloud Agent Platform の場合:

337</h4>337</h4>

338 338 

3391. Vertex AI が有効な Google Cloud プロジェクト3391. Google Cloud の Agent Platform が有効な Google Cloud プロジェクト

3402. GitHub Actions 用に設定された Workload Identity Federation3402. GitHub Actions 用に設定された Workload Identity Federation

3413. 必要なアクセス許可を持つサービスアカウント3413. 必要なアクセス許可を持つサービスアカウント

3424. GitHub App(推奨)または デフォルトの GITHUB\_TOKEN を使用3424. GitHub App(推奨)または デフォルトの GITHUB\_TOKEN を使用


347 347 

3481. Amazon Bedrock が有効な AWS アカウント3481. Amazon Bedrock が有効な AWS アカウント

3492. AWS で設定された GitHub OIDC Identity Provider3492. AWS で設定された GitHub OIDC Identity Provider

3503. Bedrock アクセス許可を持つ IAM ロール3503. Amazon Bedrock アクセス許可を持つ IAM ロール

3514. GitHub App(推奨)または デフォルトの GITHUB\_TOKEN を使用3514. GitHub App(推奨)または デフォルトの GITHUB\_TOKEN を使用

352 352 

353<Steps>353<Steps>

354 <Step title="カスタム GitHub App を作成(3P プロバイダーに推奨)">354 <Step title="カスタム GitHub App を作成(3P プロバイダーに推奨)">

355 Vertex AI や Bedrock などの 3P プロバイダーを使用する場合、最適な制御とセキュリティのために、独自の GitHub App を作成することをお勧めします。355 Google Cloud の Agent Platform Amazon Bedrock などの 3P プロバイダーを使用する場合、最適な制御とセキュリティのために、独自の GitHub App を作成することをお勧めします。

356 356 

357 1. [https://github.com/settings/apps/new](https://github.com/settings/apps/new) にアクセスします357 1. [https://github.com/settings/apps/new](https://github.com/settings/apps/new) にアクセスします

358 2. 基本情報を入力します。358 2. 基本情報を入力します。


428 詳細な OIDC セットアップ手順については、[AWS ドキュメント](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) を参照してください。428 詳細な OIDC セットアップ手順については、[AWS ドキュメント](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_create_oidc.html) を参照してください。

429 </Accordion>429 </Accordion>

430 430 

431 <Accordion title="Google Vertex AI">431 <Accordion title="Google Cloud の Agent Platform">

432 **GitHub Actions が認証情報を保存せずに安全に認証できるように Google Cloud を設定します。**432 **GitHub Actions が認証情報を保存せずに安全に認証できるように Google Cloud を設定します。**

433 433 

434 > **セキュリティに関する注意**: リポジトリ固有の設定を使用し、最小限の必要なアクセス許可のみを付与します。434 > **セキュリティに関する注意**: リポジトリ固有の設定を使用し、最小限の必要なアクセス許可のみを付与します。


438 1. **Google Cloud プロジェクトで API を有効にします**:438 1. **Google Cloud プロジェクトで API を有効にします**:

439 * IAM Credentials API439 * IAM Credentials API

440 * Security Token Service(STS)API440 * Security Token Service(STS)API

441 * Vertex AI API441 * Google Cloud の Agent Platform API

442 442 

443 2. **Workload Identity Federation リソースを作成します**:443 2. **Workload Identity Federation リソースを作成します**:

444 * Workload Identity Pool を作成します444 * Workload Identity Pool を作成します


483 * `APP_ID`: GitHub App の ID483 * `APP_ID`: GitHub App の ID

484 * `APP_PRIVATE_KEY`: プライベートキー(.pem)の内容484 * `APP_PRIVATE_KEY`: プライベートキー(.pem)の内容

485 485 

486 #### Google Cloud Vertex AI の場合486 #### Google Cloud Agent Platform の場合

487 487 

488 1. **GCP 認証の場合**:488 1. **GCP 認証の場合**:

489 * `GCP_WORKLOAD_IDENTITY_PROVIDER`489 * `GCP_WORKLOAD_IDENTITY_PROVIDER`


504 </Step>504 </Step>

505 505 

506 <Step title="ワークフローファイルを作成">506 <Step title="ワークフローファイルを作成">

507 クラウドプロバイダーと統合する GitHub Actions ワークフローファイルを作成します。以下の例は、Amazon Bedrock と Google Vertex AI の両方の完全な設定を示しています。507 クラウドプロバイダーと統合する GitHub Actions ワークフローファイルを作成します。以下の例は、Amazon Bedrock と Google Cloud Agent Platform の両方の完全な設定を示しています。

508 508 

509 <AccordionGroup>509 <AccordionGroup>

510 <Accordion title="Amazon Bedrock ワークフロー">510 <Accordion title="Amazon Bedrock ワークフロー">


512 512 

513 * Amazon Bedrock アクセスが有効で、Claude モデルのアクセス許可がある513 * Amazon Bedrock アクセスが有効で、Claude モデルのアクセス許可がある

514 * GitHub が AWS で OIDC ID プロバイダーとして設定されている514 * GitHub が AWS で OIDC ID プロバイダーとして設定されている

515 * Bedrock アクセス許可を持つ IAM ロールが GitHub Actions を信頼している515 * Amazon Bedrock アクセス許可を持つ IAM ロールが GitHub Actions を信頼している

516 516 

517 **必要な GitHub シークレット:**517 **必要な GitHub シークレット:**

518 518 

519 | Secret Name | Description |519 | Secret Name | Description |

520 | -------------------- | --------------------------- |520 | -------------------- | ---------------------------------- |

521 | `AWS_ROLE_TO_ASSUME` | Bedrock アクセス用の IAM ロールの ARN |521 | `AWS_ROLE_TO_ASSUME` | Amazon Bedrock アクセス用の IAM ロールの ARN |

522 | `APP_ID` | GitHub App ID(アプリ設定から) |522 | `APP_ID` | GitHub App ID(アプリ設定から) |

523 | `APP_PRIVATE_KEY` | GitHub App 用に生成したプライベートキー |523 | `APP_PRIVATE_KEY` | GitHub App 用に生成したプライベートキー |

524 524 


573 ```573 ```

574 574 

575 <Tip>575 <Tip>

576 Bedrock のモデル ID 形式には、リージョンプレフィックスが含まれます(例:`us.anthropic.claude-sonnet-4-6`)。576 Amazon Bedrock のモデル ID 形式には、リージョンプレフィックスが含まれます(例:`us.anthropic.claude-sonnet-4-6`)。

577 </Tip>577 </Tip>

578 </Accordion>578 </Accordion>

579 579 

580 <Accordion title="Google Vertex AI ワークフロー">580 <Accordion title="Google Cloud Agent Platform ワークフロー">

581 **前提条件:**581 **前提条件:**

582 582 

583 * GCP プロジェクトで Vertex AI API が有効583 * GCP プロジェクトで Google Cloud の Agent Platform API が有効

584 * GitHub 用に Workload Identity Federation が設定されている584 * GitHub 用に Workload Identity Federation が設定されている

585 * Vertex AI アクセス許可を持つサービスアカウント585 * Google Cloud の Agent Platform アクセス許可を持つサービスアカウント

586 586 

587 **必要な GitHub シークレット:**587 **必要な GitHub シークレット:**

588 588 

589 | Secret Name | Description |589 | Secret Name | Description |

590 | -------------------------------- | -------------------------------- |590 | -------------------------------- | -------------------------------------------------- |

591 | `GCP_WORKLOAD_IDENTITY_PROVIDER` | Workload identity provider リソース名 |591 | `GCP_WORKLOAD_IDENTITY_PROVIDER` | Workload identity provider リソース名 |

592 | `GCP_SERVICE_ACCOUNT` | Vertex AI アクセス権を持つサービスアカウントメール |592 | `GCP_SERVICE_ACCOUNT` | Google Cloud の Agent Platform アクセス権を持つサービスアカウントメール |

593 | `APP_ID` | GitHub App ID(アプリ設定から) |593 | `APP_ID` | GitHub App ID(アプリ設定から) |

594 | `APP_PRIVATE_KEY` | GitHub App 用に生成したプライベートキー |594 | `APP_PRIVATE_KEY` | GitHub App 用に生成したプライベートキー |

595 595 


675 認証エラー675 認証エラー

676</h3>676</h3>

677 677 

678API キーが有効で十分なアクセス許可があることを確認します。Bedrock/Vertex の場合、認証情報の設定を確認し、シークレットがワークフロー内で正しく名前付けされていることを確認します。678API キーが有効で十分なアクセス許可があることを確認します。Amazon Bedrock または Google Cloud の Agent Platform の場合、認証情報の設定を確認し、シークレットがワークフロー内で正しく名前付けされていることを確認します。

679 679 

680<h2 id="advanced-configuration">680<h2 id="advanced-configuration">

681 高度な設定681 高度な設定


688Claude Code Action v1 は、簡素化された設定を使用します。688Claude Code Action v1 は、簡素化された設定を使用します。

689 689 

690| Parameter | Description | 必須 |690| Parameter | Description | 必須 |

691| --------------------- | --------------------------------------------- | ------ |691| --------------------- | -------------------------------------------------- | ------ |

692| `prompt` | Claude の指示(プレーンテキストまたは [skill](/ja/skills) 名) | いいえ\* |692| `prompt` | Claude の指示(プレーンテキストまたは [skill](/ja/skills) 名) | いいえ\* |

693| `claude_args` | Claude Code に渡される CLI 引数 | いいえ |693| `claude_args` | Claude Code に渡される CLI 引数 | いいえ |

694| `plugin_marketplaces` | プラグインマーケットプレイス Git URL の改行区切りリスト | いいえ |694| `plugin_marketplaces` | プラグインマーケットプレイス Git URL の改行区切りリスト | いいえ |


697| `github_token` | API アクセス用の GitHub トークン | いいえ |697| `github_token` | API アクセス用の GitHub トークン | いいえ |

698| `trigger_phrase` | カスタムトリガーフレーズ(デフォルト:「@claude」) | いいえ |698| `trigger_phrase` | カスタムトリガーフレーズ(デフォルト:「@claude」) | いいえ |

699| `use_bedrock` | Claude API の代わりに Amazon Bedrock を使用 | いいえ |699| `use_bedrock` | Claude API の代わりに Amazon Bedrock を使用 | いいえ |

700| `use_vertex` | Claude API の代わりに Google Vertex AI を使用 | いいえ |700| `use_vertex` | Claude API の代わりに Google Cloud Agent Platform を使用 | いいえ |

701 701 

702\*プロンプトはオプションです。イシュー/PR コメントで省略された場合、Claude はトリガーフレーズに応答します\702\*プロンプトはオプションです。イシュー/PR コメントで省略された場合、Claude はトリガーフレーズに応答します\

703\*\*直接 Claude API に必要です。Bedrock/Vertex には不要です703\*\*直接 Claude API に必要です。Amazon Bedrock または Google Cloud の Agent Platform には不要です

704 704 

705<h4 id="pass-cli-arguments">705<h4 id="pass-cli-arguments">

706 CLI 引数を渡す706 CLI 引数を渡す

Details

10 GitHub Enterprise Server サポートは Team プランと Enterprise プランで利用できます。10 GitHub Enterprise Server サポートは Team プランと Enterprise プランで利用できます。

11</Note>11</Note>

12 12 

13GitHub Enterprise Server(GHES)サポートにより、組織は github.com ではなく自社管理の GitHub インスタンスでホストされているリポジトリで Claude Code を使用できます。管理者が GHES インスタンスを接続すると、開発者はリポジトリごとの設定なしで Web セッションを実行し、自動コードレビューを取得し内部マーケットプレイスからプラグインをインストールできます13GitHub Enterprise Server(GHES)サポートにより、組織は github.com ではなく自社管理の GitHub インスタンスでホストされているリポジトリで Claude Code を使用できます。管理者が GHES インスタンスを接続すると、開発者はリポジトリごとの設定なしで Web セッションを実行し、自動コードレビューを取得できます。インスタンスでホストされているプラグインマーケットプレイスもサポートされており認証情報の要件は [GHES 上のプラグインマーケットプレイス](#plugin-marketplaces-on-ghes) で説明されているように、サーフェスによって異なります

14 14 

15github.com 上のリポジトリについては、[Claude Code on the web](/ja/claude-code-on-the-web) および [Code Review](/ja/code-review) を参照してください。Claude を独自の CI インフラストラクチャで実行するには、[GitHub Actions](/ja/github-actions) を参照してください。15github.com 上のリポジトリについては、[Claude Code on the web](/ja/claude-code-on-the-web) および [Code Review](/ja/code-review) を参照してください。Claude を独自の CI インフラストラクチャで実行するには、[GitHub Actions](/ja/github-actions) を参照してください。

16 16 


21以下の表は、Claude Code のどの機能が GHES をサポートしているか、および github.com の動作との違いを示しています。21以下の表は、Claude Code のどの機能が GHES をサポートしているか、および github.com の動作との違いを示しています。

22 22 

23| 機能 | GHES サポート | 注記 |23| 機能 | GHES サポート | 注記 |

24| :--------------------- | :-------- | :--------------------------------------------------------------------------------------------------------- |24| :--------------------- | :-------- | :-------------------------------------------------------------------------------------------------------- |

25| Claude Code on the web | ✅ サポート | 管理者が GHES インスタンスを 1 回接続すると、開発者は通常通り `claude --remote` または [claude.ai/code](https://claude.ai/code) を使用できます |25| Claude Code on the web | ✅ サポート | 管理者が GHES インスタンスを 1 回接続すると、開発者は通常通り `claude --cloud` または [claude.ai/code](https://claude.ai/code) を使用できます |

26| Code Review | ✅ サポート | github.com と同じ自動 PR レビュー |26| Code Review | ✅ サポート | github.com と同じ自動 PR レビュー |

27| Claude Security | ✅ サポート | Enterprise プランの公開ベータで [claude.ai/security](https://claude.ai/security) で利用可能 |27| Claude Security | ✅ サポート | Enterprise プランの公開ベータで [claude.ai/security](https://claude.ai/security) で利用可能 |

28| Teleport セッション | ✅ サポート | `--teleport` で Web とターミナル間でセッションを移動 |28| Teleport セッション | ✅ サポート | `--teleport` で Web とターミナル間でセッションを移動 |

29| プラグインマーケットプレイス | ✅ サポート | `owner/repo` ショートハンドの代わりに完全な git URL を使用 |29| プラグインマーケットプレイス | ✅ サポート | 表面によって認証情報の要件が異なります。[GHES 上のプラグインマーケットプレイス](#plugin-marketplaces-on-ghes)を参照してください |

30| 貢献度メトリクス | ✅ サポート | [分析ダッシュボード](/ja/analytics) への Webhook 経由で配信 |30| 貢献度メトリクス | ✅ サポート | [分析ダッシュボード](/ja/analytics) への Webhook 経由で配信 |

31| GitHub Actions | ✅ サポート | 手動ワークフロー設定が必要。`/install-github-app` は github.com のみ |31| GitHub Actions | ✅ サポート | 手動ワークフロー設定が必要。`/install-github-app` は github.com のみ |

32| GitHub MCP サーバー | ❌ サポートなし | GitHub MCP サーバーは GHES インスタンスでは動作しません |32| GitHub MCP サーバー | ❌ サポートなし | GitHub MCP サーバーは GHES インスタンスでは動作しません |


107次に Web セッションを開始します。Claude は git リモートから GHES ホストを検出し、セッションを組織の設定されたインスタンスを通じてルーティングします。107次に Web セッションを開始します。Claude は git リモートから GHES ホストを検出し、セッションを組織の設定されたインスタンスを通じてルーティングします。

108 108 

109```bash theme={null}109```bash theme={null}

110claude --remote "Add retry logic to the payment webhook handler"110claude --cloud "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) を参照してください。[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) を参照してください。


122 GHES 上のプラグインマーケットプレイス122 GHES 上のプラグインマーケットプレイス

123</h2>123</h2>

124 124 

125GHES インスタンスでプラグインマーケットプレイスをホストして、組織全体に内部ツールを配布します。マーケットプレイス構造は github.com でホストされているマーケットプレイスと同じです。唯一の違いはそれらを参照する方法です125GHES インスタンスでプラグインマーケットプレイスをホストして、組織全体に内部ツールを配布します。マーケットプレイス構造は github.com でホストされているマーケットプレイスと同じですが、マーケットプレイスを追加する場所によってインストール方法が異なり、サーフェス全体で認証情報が異なります

126 

127| サーフェス | インストール方法 | 各ユーザーに必要なもの |

128| :----------------------------- | :------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------- |

129| Claude Code CLI とデスクトップ | Claude Code はマシンの既存の git 認証情報を使用してマーケットプレイスリポジトリをクローンします | マシンから GHES ホストへの Git アクセス |

130| 管理設定(`extraKnownMarketplaces`) | Claude Code はエントリを登録し、マシンの既存の git 認証情報を使用してリポジトリをクローンします | マシンから GHES ホストへの Git アクセス |

131| claude.ai 組織プラグイン設定 | Owner が GHES インスタンスをソースとして選択します。Anthropic のバックエンドが [admin setup](#admin-setup) の GitHub App を使用してリポジトリをフェッチして同期します | 追加後はユーザーごとに不要です。それを追加する Owner は、アクセスチェックとして独自の GitHub Enterprise アカウントを接続する必要があり、GitHub App をマーケットプレイスリポジトリにインストールする必要があります |

132| claude.ai ユーザー設定 | Anthropic のバックエンドが送信ユーザーの GitHub Enterprise 接続を使用してリポジトリをフェッチします | Claude に接続された独自の GitHub Enterprise アカウント |

133| Claude Code on the web | クラウドセッションはセッションサンドボックス内でマーケットプレイスをクローンします。サンドボックスは、セッションのリポジトリが同じインスタンス上にある場合にのみ GHES インスタンスに到達でき、git 認証情報はセッションのリポジトリにスコープされます | GHES でホストされているマーケットプレイスには信頼できません。セッションのリポジトリとは異なるホストに到達できず、同じインスタンスのインストールでも失敗する可能性があります。代わりに CLI、管理設定、または claude.ai を使用してください |

134 

135<Warning>

136 claude.ai 上の GitHub Enterprise 接続は、ユーザー設定からマーケットプレイスが追加される場合、ユーザーごとです。[admin setup](#admin-setup) は GHES インスタンスを組織に接続しますが、個別のユーザーアカウントは接続しません。独自の設定から GHES マーケットプレイスを追加する各ユーザーは、最初に独自の GitHub Enterprise アカウントを接続する必要があり、Owner を含む 1 人のユーザーの接続は他のユーザーをカバーしません。組織プラグイン設定で Owner が追加したマーケットプレイスは、継続的なフェッチが組織の GitHub App を使用するため、ユーザーにこの要件を課しません。マーケットプレイスを追加する Owner は、追加時に独自の GitHub Enterprise アカウントを接続する必要があります。

137</Warning>

126 138 

127<h3 id="add-a-ghes-marketplace">139<h3 id="add-a-ghes-marketplace">

128 GHES マーケットプレイスを追加140 GHES マーケットプレイスを追加

129</h3>141</h3>

130 142 

131`owner/repo` ショートハンドは常に github.com に解決されます。GHES でホストされているマーケットプレイスの場合は、完全な git URL を使用します。143`owner/repo` ショートハンドは常に github.com に解決されます。GHES でホストされているマーケットプレイスの場合は、完全な git URL を使用します。HTTPS URL が推奨されます。

132 144 

133```bash theme={null}145```bash theme={null}

134/plugin marketplace add git@github.example.com:platform/claude-plugins.git146/plugin marketplace add https://github.example.com/platform/claude-plugins.git

135```147```

136 148 

137HTTPS URL も機能します149マシンが既に GHES ホストを信頼している場合、SSH URL が機能します

138 150 

139```bash theme={null}151```bash theme={null}

140/plugin marketplace add https://github.example.com/platform/claude-plugins.git152/plugin marketplace add git@github.example.com:platform/claude-plugins.git

141```153```

142 154 

155Claude Code は git を非対話的に実行し、マシンの `known_hosts` ファイルにないホストへの SSH 接続を拒否します。git 認証情報ヘルパーを備えた HTTPS URL は `known_hosts` 要件を回避します。

156 

143マーケットプレイスの構築の完全なガイドについては、[プラグインマーケットプレイスの作成と配布](/ja/plugin-marketplaces) を参照してください。157マーケットプレイスの構築の完全なガイドについては、[プラグインマーケットプレイスの作成と配布](/ja/plugin-marketplaces) を参照してください。

144 158 

159<h3 id="pre-register-ghes-marketplaces-with-managed-settings">

160 管理設定で GHES マーケットプレイスを事前登録

161</h3>

162 

163`extraKnownMarketplaces` 設定はマーケットプレイスを事前登録して、開発者が手動セットアップなしでそれを取得できるようにします。これは [任意の設定ファイル](/ja/settings#extraknownmarketplaces) から機能します。リポジトリの `.claude/settings.json` を含めて、管理設定はそれを組織全体に配信します。

164 

165```json theme={null}

166{

167 "extraKnownMarketplaces": {

168 "internal-tools": {

169 "source": {

170 "source": "git",

171 "url": "https://github.example.com/platform/claude-plugins.git"

172 }

173 }

174 }

175}

176```

177 

178Claude Code はこれらのマーケットプレイスをローカルにインストールします。各エントリを登録し、マシンの既存の git 認証情報を使用してリポジトリをクローンします。このパスは claude.ai を通過しないため、ユーザーごとの GitHub Enterprise 接続は不要です。成功したロールアウトのために。

179 

180* **完全な git URL を使用します。** `owner/repo` ショートハンドは常に github.com に解決され、GHES ホストを参照できません。

181* **HTTPS URL を優先します。** SSH クローンは GHES ホストキーを既に信頼していないマシンで失敗します。組織の標準 git 認証情報ヘルパーを備えた HTTPS URL は、認証情報が設定されているすべてのマシンで機能します。

182* **各マシンが GHES ホストからクローンできることを確認します。** マシンに認証情報がない場合、マーケットプレイスは登録されますが、インストールされず、そのプラグインは認証情報を求めるのではなく見つからないと報告されます。

183* **設定が各マシンに到達することを確認します。** 管理設定ファイルは、デバイス管理システムを通じて配置されたマシンなど、配置されたマシンにのみ有効です。[管理設定](/ja/settings#settings-files) のファイルの場所を参照してください。

184 

145<h3 id="allowlist-ghes-marketplaces-in-managed-settings">185<h3 id="allowlist-ghes-marketplaces-in-managed-settings">

146 管理設定で GHES マーケットプレイスをホワイトリストに登録186 管理設定で GHES マーケットプレイスをホワイトリストに登録

147</h3>187</h3>


159}199}

160```200```

161 201 

162開発者向けにマーケットプレイスを事前登録して、手動セットアップなしで表示されるようにすることもできます。この例は、内部ツールマーケットプレイスを組織全体で利用可能にします。

163 

164```json theme={null}

165{

166 "extraKnownMarketplaces": {

167 "internal-tools": {

168 "source": {

169 "source": "git",

170 "url": "git@github.example.com:platform/claude-plugins.git"

171 }

172 }

173 }

174}

175```

176 

177完全なスキーマについては、[strictKnownMarketplaces](/ja/settings#strictknownmarketplaces) および [extraKnownMarketplaces](/ja/settings#extraknownmarketplaces) 設定リファレンスを参照してください。202完全なスキーマについては、[strictKnownMarketplaces](/ja/settings#strictknownmarketplaces) および [extraKnownMarketplaces](/ja/settings#extraknownmarketplaces) 設定リファレンスを参照してください。

178 203 

179<h2 id="limitations">204<h2 id="limitations">


193 Web セッションがリポジトリのクローンに失敗218 Web セッションがリポジトリのクローンに失敗

194</h3>219</h3>

195 220 

196`claude --remote` がクローンエラーで失敗する場合は、Owner が GHES インスタンスのセットアップを完了し、GitHub App が作業しているリポジトリにインストールされていることを確認してください。インスタンスを接続した Owner に確認して、Claude 設定に登録されているホスト名が git リモートのホスト名と一致することを確認してください。221`claude --cloud` がクローンエラーで失敗する場合は、Owner が GHES インスタンスのセットアップを完了し、GitHub App が作業しているリポジトリにインストールされていることを確認してください。インスタンスを接続した Owner に確認して、Claude 設定に登録されているホスト名が git リモートのホスト名と一致することを確認してください。

197 222 

198<h3 id="marketplace-add-fails-with-a-policy-error">223<h3 id="marketplace-add-fails-with-a-policy-error">

199 マーケットプレイス追加がポリシーエラーで失敗224 マーケットプレイス追加がポリシーエラーで失敗


201 226 

202GHES URL の `/plugin marketplace add` がブロックされている場合、組織はマーケットプレイスソースを制限しています。管理者に [管理設定](#allowlist-ghes-marketplaces-in-managed-settings) で GHES ホスト名の `hostPattern` エントリを追加するよう依頼してください。227GHES URL の `/plugin marketplace add` がブロックされている場合、組織はマーケットプレイスソースを制限しています。管理者に [管理設定](#allowlist-ghes-marketplaces-in-managed-settings) で GHES ホスト名の `hostPattern` エントリを追加するよう依頼してください。

203 228 

229<h3 id="marketplace-add-on-claude-ai-fails-with-a-github-access-error">

230 claude.ai でのマーケットプレイス追加が GitHub アクセスエラーで失敗

231</h3>

232 

233ユーザー設定から GHES マーケットプレイスを追加する際に「Marketplace couldn't be added」のような一般的なエラーで失敗する場合は、まず GitHub Enterprise 接続を確認してください。これは、組織の GHES インスタンスが設定されており他のユーザーが接続されている場合でも、独自の GitHub Enterprise アカウントが Claude に接続されていない場合に表示されます。ダイアログは GitHub Enterprise 接続フローを指していません。また、Browse タブの「Connect to GitHub」オプションは github.com にサインインするため、GHES リポジトリへのアクセス権を付与しません。

234 

235GitHub Enterprise アカウントを接続するには、[claude.ai/code](https://claude.ai/code) のリポジトリピッカーが設定済みの各 GHES インスタンスの接続オプションを提供します。また、Owner は [Claude Code 管理設定](https://claude.ai/admin-settings/claude-code) の GitHub Enterprise セクションからも接続できます。その後、マーケットプレイスを再度追加してください。または、Owner に組織プラグイン設定でマーケットプレイスを追加するよう依頼してください。これにより、ユーザーごとの接続要件が削除されます。

236 

237他の claude.ai サーフェスでは、GHES マーケットプレイスの「Repository not found. If it's private, GitHub access is required」エラーは通常、同じ接続の欠落を示しています。上記のいずれかのパスを通じて GitHub Enterprise アカウントを接続してから、もう一度試してください。

238 

204<h3 id="ghes-instance-not-reachable">239<h3 id="ghes-instance-not-reachable">

205 GHES インスタンスに到達不可240 GHES インスタンスに到達不可

206</h3>241</h3>

gitlab-ci-cd.md +30 −30

Details

24* **自動実装**: 単一のコマンドまたはメンションで issue を実行可能なコードに変換します24* **自動実装**: 単一のコマンドまたはメンションで issue を実行可能なコードに変換します

25* **プロジェクト対応**: Claude は `CLAUDE.md` ガイドラインと既存のコードパターンに従います25* **プロジェクト対応**: Claude は `CLAUDE.md` ガイドラインと既存のコードパターンに従います

26* **シンプルなセットアップ**: `.gitlab-ci.yml` に 1 つのジョブとマスクされた CI/CD 変数を追加します26* **シンプルなセットアップ**: `.gitlab-ci.yml` に 1 つのジョブとマスクされた CI/CD 変数を追加します

27* **エンタープライズ対応**: Claude API、Amazon Bedrock、または Google Vertex AI を選択して、データレジデンシーと調達のニーズを満たします27* **エンタープライズ対応**: Claude API、Amazon Bedrock、または Google Cloud Agent Platform を選択して、データレジデンシーと調達のニーズを満たします

28* **デフォルトでセキュア**: GitLab ランナーで実行され、ブランチ保護と承認が適用されます28* **デフォルトでセキュア**: GitLab ランナーで実行され、ブランチ保護と承認が適用されます

29 29 

30<h2 id="how-it-works">30<h2 id="how-it-works">


382. **プロバイダー抽象化**: 環境に適したプロバイダーを使用します。382. **プロバイダー抽象化**: 環境に適したプロバイダーを使用します。

39 * Claude API(SaaS)39 * Claude API(SaaS)

40 * Amazon Bedrock(IAM ベースのアクセス、クロスリージョンオプション)40 * Amazon Bedrock(IAM ベースのアクセス、クロスリージョンオプション)

41 * Google Vertex AI(GCP ネイティブ、Workload Identity Federation)41 * Google Cloud の Agent Platform(GCP ネイティブ、Workload Identity Federation)

42 42 

433. **サンドボックス実行**: 各インタラクションは厳密なネットワークとファイルシステムルールを持つコンテナで実行されます。Claude Code はワークスペーススコープの権限を適用して書き込みを制限します。すべての変更は MR を通じてフローするため、レビュアーは diff を確認でき、承認が引き続き適用されます。433. **サンドボックス実行**: 各インタラクションは厳密なネットワークとファイルシステムルールを持つコンテナで実行されます。Claude Code はワークスペーススコープの権限を適用して書き込みを制限します。すべての変更は MR を通じてフローするため、レビュアーは diff を確認でき、承認が引き続き適用されます。

44 44 


108ジョブと `ANTHROPIC_API_KEY` 変数を追加した後、**CI/CD** → **Pipelines** からジョブを手動で実行してテストするか、MR からトリガーして Claude が変更を提案し、必要に応じて MR を開くようにします。108ジョブと `ANTHROPIC_API_KEY` 変数を追加した後、**CI/CD** → **Pipelines** からジョブを手動で実行してテストするか、MR からトリガーして Claude が変更を提案し、必要に応じて MR を開くようにします。

109 109 

110<Note>110<Note>

111 Claude API の代わりに Amazon Bedrock または Google Vertex AI で実行するには、以下の [Using with Amazon Bedrock & Google Vertex AI](#using-with-amazon-bedrock-%26-google-vertex-ai) セクションを参照して、認証と環境セットアップを確認してください。111 Claude API の代わりに Amazon Bedrock または Google Cloud Agent Platform で実行するには、以下の [Using with Amazon Bedrock and Google Cloud](#using-with-amazon-bedrock-and-google-cloud) セクションを参照して、認証と環境セットアップを確認してください。

112</Note>112</Note>

113 113 

114<h3 id="manual-setup-recommended-for-production">114<h3 id="manual-setup-recommended-for-production">


119 119 

1201. **プロバイダーアクセスを構成します**。1201. **プロバイダーアクセスを構成します**。

121 * **Claude API**: `ANTHROPIC_API_KEY` を作成してマスクされた CI/CD 変数として保存します121 * **Claude API**: `ANTHROPIC_API_KEY` を作成してマスクされた CI/CD 変数として保存します

122 * **Amazon Bedrock**: **Configure GitLab** → **AWS OIDC** を実行し、Bedrock 用の IAM ロールを作成します122 * **Amazon Bedrock**: **Configure GitLab** → **AWS OIDC** を実行し、Amazon Bedrock 用の IAM ロールを作成します

123 * **Google Vertex AI**: **Configure Workload Identity Federation for GitLab** → **GCP** を実行します123 * **Google Cloud の Agent Platform**: **Configure Workload Identity Federation for GitLab** → **GCP** を実行します

124 124 

1252. **GitLab API 操作用のプロジェクト認証情報を追加します**。1252. **GitLab API 操作用のプロジェクト認証情報を追加します**。

126 * デフォルトで `CI_JOB_TOKEN` を使用するか、`api` スコープを持つ Project Access Token を作成します126 * デフォルトで `CI_JOB_TOKEN` を使用するか、`api` スコープを持つ Project Access Token を作成します


172 172 

173Claude はバグを特定し、修正を実装し、ブランチを更新するか新しい MR を開きます。173Claude はバグを特定し、修正を実装し、ブランチを更新するか新しい MR を開きます。

174 174 

175<h2 id="using-with-amazon-bedrock--google-vertex-ai">175<h2 id="using-with-amazon-bedrock-and-google-cloud">

176 Amazon Bedrock & Google Vertex AI での使用176 Amazon Bedrock Google Cloud での使用

177</h2>177</h2>

178 178 

179エンタープライズ環境では、同じ開発者エクスペリエンスで Claude Code をクラウドインフラストラクチャ全体で実行できます。179エンタープライズ環境では、同じ開発者エクスペリエンスで Claude Code をクラウドインフラストラクチャ全体で実行できます。


186 186 

187 1. 目的の Claude モデルへのアクセス権を持つ Amazon Bedrock を備えた AWS アカウント187 1. 目的の Claude モデルへのアクセス権を持つ Amazon Bedrock を備えた AWS アカウント

188 2. AWS IAM で OIDC ID プロバイダーとして構成された GitLab188 2. AWS IAM で OIDC ID プロバイダーとして構成された GitLab

189 3. Bedrock 権限と GitLab プロジェクト/refs に制限された信頼ポリシーを持つ IAM ロール189 3. Amazon Bedrock 権限と GitLab プロジェクト/refs に制限された信頼ポリシーを持つ IAM ロール

190 4. ロール仮定用の GitLab CI/CD 変数:190 4. ロール仮定用の GitLab CI/CD 変数:

191 * `AWS_ROLE_TO_ASSUME`(ロール ARN)191 * `AWS_ROLE_TO_ASSUME`(ロール ARN)

192 * `AWS_REGION`(Bedrock リージョン)192 * `AWS_REGION`(Amazon Bedrock リージョン)

193 193 

194 ### セットアップ手順194 ### セットアップ手順

195 195 


200 1. Amazon Bedrock を有効にし、ターゲット Claude モデルへのアクセスをリクエストします200 1. Amazon Bedrock を有効にし、ターゲット Claude モデルへのアクセスをリクエストします

201 2. GitLab 用の IAM OIDC プロバイダーを作成します(まだ存在しない場合)201 2. GitLab 用の IAM OIDC プロバイダーを作成します(まだ存在しない場合)

202 3. GitLab OIDC プロバイダーによって信頼され、プロジェクトと保護された refs に制限された IAM ロールを作成します202 3. GitLab OIDC プロバイダーによって信頼され、プロジェクトと保護された refs に制限された IAM ロールを作成します

203 4. Bedrock invoke API に対する最小権限権限を付与します203 4. Amazon Bedrock invoke API に対する最小権限権限を付与します

204 204 

205 **CI/CD 変数に保存する必須値:**205 **CI/CD 変数に保存する必須値:**

206 206 


218 上記の Amazon Bedrock ジョブの例を使用して、GitLab ジョブトークンを実行時に一時的な AWS 認証情報と交換します。218 上記の Amazon Bedrock ジョブの例を使用して、GitLab ジョブトークンを実行時に一時的な AWS 認証情報と交換します。

219 </Tab>219 </Tab>

220 220 

221 <Tab title="Google Vertex AI">221 <Tab title="Google Cloud's Agent Platform">

222 ### 前提条件222 ### 前提条件

223 223 

224 Google Vertex AI で Claude Code をセットアップする前に、以下が必要です。224 Google Cloud Agent Platform で Claude Code をセットアップする前に、以下が必要です。

225 225 

226 1. 以下を備えた Google Cloud プロジェクト:226 1. 以下を備えた Google Cloud プロジェクト:

227 * Vertex AI API が有効227 * Google Cloud の Agent Platform API が有効

228 * GitLab OIDC を信頼するように構成された Workload Identity Federation228 * GitLab OIDC を信頼するように構成された Workload Identity Federation

229 2. 必要な Vertex AI ロールのみを持つ専用サービスアカウント229 2. 必要な Google Cloud の Agent Platform ロールのみを持つ専用サービスアカウント

230 3. WIF 用の GitLab CI/CD 変数:230 3. WIF 用の GitLab CI/CD 変数:

231 * `GCP_WORKLOAD_IDENTITY_PROVIDER`(完全なリソース名)231 * `GCP_WORKLOAD_IDENTITY_PROVIDER`(完全なリソース名)

232 * `GCP_SERVICE_ACCOUNT`(サービスアカウントメール)232 * `GCP_SERVICE_ACCOUNT`(サービスアカウントメール)


237 237 

238 **必須セットアップ:**238 **必須セットアップ:**

239 239 

240 1. IAM Credentials API、STS API、および Vertex AI API を有効にします240 1. IAM Credentials API、STS API、および Google Cloud の Agent Platform API を有効にします

241 2. GitLab OIDC 用の Workload Identity Pool とプロバイダーを作成します241 2. GitLab OIDC 用の Workload Identity Pool とプロバイダーを作成します

242 3. Vertex AI ロールを持つ専用サービスアカウントを作成します242 3. Google Cloud の Agent Platform ロールを持つ専用サービスアカウントを作成します

243 4. WIF プリンシパルにサービスアカウントを偽装する権限を付与します243 4. WIF プリンシパルにサービスアカウントを偽装する権限を付与します

244 244 

245 **CI/CD 変数に保存する必須値:**245 **CI/CD 変数に保存する必須値:**


250 Settings → CI/CD → Variables で変数を追加します。250 Settings → CI/CD → Variables で変数を追加します。

251 251 

252 ```yaml theme={null}252 ```yaml theme={null}

253 # Google Vertex AI の場合:253 # Google Cloud Agent Platform の場合:

254 - GCP_WORKLOAD_IDENTITY_PROVIDER254 - GCP_WORKLOAD_IDENTITY_PROVIDER

255 - GCP_SERVICE_ACCOUNT255 - GCP_SERVICE_ACCOUNT

256 - CLOUD_ML_REGION(例:us-east5)256 - CLOUD_ML_REGION(例:us-east5)

257 ```257 ```

258 258 

259 上記の Google Vertex AI ジョブの例を使用して、キーを保存せずに認証します。259 上記の Google Cloud Agent Platform ジョブの例を使用して、キーを保存せずに認証します。

260 </Tab>260 </Tab>

261</Tabs>261</Tabs>

262 262 


305 305 

306* Amazon Bedrock が有効で、選択した Claude モデルへのアクセス権がある306* Amazon Bedrock が有効で、選択した Claude モデルへのアクセス権がある

307* GitLab OIDC が AWS で構成され、GitLab プロジェクトと refs を信頼するロールがある307* GitLab OIDC が AWS で構成され、GitLab プロジェクトと refs を信頼するロールがある

308* Bedrock 権限を持つ IAM ロール(最小権限を推奨)308* Amazon Bedrock 権限を持つ IAM ロール(最小権限を推奨)

309 309 

310**必須 CI/CD 変数:**310**必須 CI/CD 変数:**

311 311 

312* `AWS_ROLE_TO_ASSUME`: Bedrock アクセス用の IAM ロールの ARN312* `AWS_ROLE_TO_ASSUME`: Amazon Bedrock アクセス用の IAM ロールの ARN

313* `AWS_REGION`: Bedrock リージョン(例:`us-west-2`)313* `AWS_REGION`: Amazon Bedrock リージョン(例:`us-west-2`)

314 314 

315```yaml theme={null}315```yaml theme={null}

316claude-bedrock:316claude-bedrock:


347```347```

348 348 

349<Note>349<Note>

350 Bedrock のモデル ID にはリージョン固有のプレフィックスが含まれます(例:`us.anthropic.claude-sonnet-4-6`)。ワークフローがサポートしている場合は、ジョブ構成またはプロンプト経由で目的のモデルを渡します。350 Amazon Bedrock のモデル ID にはリージョン固有のプレフィックスが含まれます(例:`us.anthropic.claude-sonnet-4-6`)。ワークフローがサポートしている場合は、ジョブ構成またはプロンプト経由で目的のモデルを渡します。

351</Note>351</Note>

352 352 

353<h3 id="google-vertex-ai-job-example-workload-identity-federation">353<h3 id="agent-platform-job-example-workload-identity-federation">

354 Google Vertex AI ジョブの例(Workload Identity Federation)354 Agent Platform ジョブの例(Workload Identity Federation)

355</h3>355</h3>

356 356 

357**前提条件:**357**前提条件:**

358 358 

359* GCP プロジェクトで Vertex AI API が有効359* GCP プロジェクトで Google Cloud の Agent Platform API が有効

360* GitLab OIDC を信頼するように構成された Workload Identity Federation360* GitLab OIDC を信頼するように構成された Workload Identity Federation

361* Vertex AI 権限を持つサービスアカウント361* Google Cloud の Agent Platform 権限を持つサービスアカウント

362 362 

363**必須 CI/CD 変数:**363**必須 CI/CD 変数:**

364 364 

365* `GCP_WORKLOAD_IDENTITY_PROVIDER`: 完全なプロバイダーリソース名365* `GCP_WORKLOAD_IDENTITY_PROVIDER`: 完全なプロバイダーリソース名

366* `GCP_SERVICE_ACCOUNT`: サービスアカウントメール366* `GCP_SERVICE_ACCOUNT`: サービスアカウントメール

367* `CLOUD_ML_REGION`: Vertex リージョン(例:`us-east5`)367* `CLOUD_ML_REGION`: Google Cloud の Agent Platform リージョン(例:`us-east5`)

368 368 

369```yaml theme={null}369```yaml theme={null}

370claude-vertex:370claude-vertex:


490</h3>490</h3>

491 491 

492* **Claude API の場合**: `ANTHROPIC_API_KEY` が有効で期限切れでないことを確認します492* **Claude API の場合**: `ANTHROPIC_API_KEY` が有効で期限切れでないことを確認します

493* **Bedrock/Vertex の場合**: OIDC/WIF 構成、ロール偽装、シークレット名を確認します。リージョンとモデルの可用性を確認します493* **Amazon Bedrock または Google Cloud の Agent Platform の場合**: OIDC/WIF 構成、ロール偽装、シークレット名を確認します。リージョンとモデルの可用性を確認します

494 494 

495<h2 id="advanced-configuration">495<h2 id="advanced-configuration">

496 高度な構成496 高度な構成


505* `prompt` / `prompt_file`: インライン(`-p`)またはファイル経由で指示を提供します505* `prompt` / `prompt_file`: インライン(`-p`)またはファイル経由で指示を提供します

506* `max_turns`: バックアンドフォース反復の数を制限します506* `max_turns`: バックアンドフォース反復の数を制限します

507* `timeout_minutes`: 総実行時間を制限します507* `timeout_minutes`: 総実行時間を制限します

508* `ANTHROPIC_API_KEY`: Claude API に必須(Bedrock/Vertex では使用されません)508* `ANTHROPIC_API_KEY`: Claude API に必須(Amazon Bedrock または Google Cloud の Agent Platform では使用されません)

509* プロバイダー固有の環境: `AWS_REGION`、Vertex のプロジェクト/リージョン変数509* プロバイダー固有の環境: `AWS_REGION`、Google Cloud の Agent Platform のプロジェクト/リージョン変数

510 510 

511<Note>511<Note>

512 正確なフラグとパラメータは `@anthropic-ai/claude-code` のバージョンによって異なる場合があります。ジョブで `claude --help` を実行して、サポートされているオプションを確認してください。512 正確なフラグとパラメータは `@anthropic-ai/claude-code` のバージョンによって異なる場合があります。ジョブで `claude --help` を実行して、サポートされているオプションを確認してください。

glossary.md +3 −1

Details

262 262 

263セッションのベースライン承認動作。CLI で `Shift+Tab` でサイクルするか、VS Code、Desktop、claude.ai のモードセレクターを使用します。利用可能なモードは `default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions` です。263セッションのベースライン承認動作。CLI で `Shift+Tab` でサイクルするか、VS Code、Desktop、claude.ai のモードセレクターを使用します。利用可能なモードは `default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions` です。

264 264 

265`default` モードは CLI および VS Code と JetBrains 拡張機能では Manual とラベル付けされており、Claude Code は値の `manual` をエイリアスとして受け入れます。

266 

265詳細情報: [Permission mode を選択する](/ja/permission-modes)267詳細情報: [Permission mode を選択する](/ja/permission-modes)

266 268 

267<h3 id="permission-rule">269<h3 id="permission-rule">


388 Teleport390 Teleport

389</h3>391</h3>

390 392 

391コマンド `/teleport`。クラウド Claude Code セッションをローカルターミナルにプルします。Claude はブランチをフェッチし、会話履歴をロードし、web セッションの最後の状態から再開します。逆方向は `--remote` です。ローカルタスクを web で実行するために送信します。393コマンド `/teleport`。クラウド Claude Code セッションをローカルターミナルにプルします。Claude はブランチをフェッチし、会話履歴をロードし、web セッションの最後の状態から再開します。逆方向は `--cloud` です。ローカルタスクを web で実行するために送信します。

392 394 

393詳細情報: [From web to terminal](/ja/claude-code-on-the-web#from-web-to-terminal)395詳細情報: [From web to terminal](/ja/claude-code-on-the-web#from-web-to-terminal)

394 396 

Details

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt2> 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.3> Use this file to discover all available pages before exploring further.

4 4 

5# Google Vertex AI 上の Claude Code5# Google Cloud Agent Platform 上の Claude Code

6 6 

7> Google Vertex AI を通じた Claude Code の設定方法について学びます。セットアップ、IAM 設定、トラブルシューティングを含みます。7> Google Cloud の Agent Platform(旧 Vertex AIを通じた Claude Code の設定方法について学びます。セットアップ、IAM 設定、トラブルシューティングを含みます。

8 8 

9export const ContactSalesCard = ({surface}) => {9export const ContactSalesCard = ({surface}) => {

10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;


82 前提条件82 前提条件

83</h2>83</h2>

84 84 

85Claude Code を Vertex AI で設定する前に、以下を確認してください。85Claude Code を Google Cloud の Agent Platform(旧 Vertex AIで設定する前に、以下を確認してください。

86 86 

87* 請求が有効になっている Google Cloud Platform(GCP)アカウント87* 請求が有効になっている Google Cloud Platform(GCP)アカウント

88* Vertex AI API が有効になっている GCP プロジェクト88* Google Cloud の Agent Platform API が有効になっている GCP プロジェクト

89* 目的の Claude モデルへのアクセス(例:Claude Sonnet 4.6)89* 目的の Claude モデルへのアクセス(例:Claude Sonnet 4.6)

90* Google Cloud SDK(`gcloud`)がインストールされ、設定されていること90* Google Cloud SDK(`gcloud`)がインストールされ、設定されていること

91* 目的の GCP リージョンに割り当てられたクォータ91* 目的の GCP リージョンに割り当てられたクォータ

92 92 

93Vertex AI 認証情報でサインインするには、以下の[Vertex AI でサインイン](#sign-in-with-vertex-ai)に従ってください。チーム全体に Claude Code をデプロイするには、[手動セットアップ](#set-up-manually)の手順を使用し、ロールアウト前に[モデルバージョンをピン留めして](#5-pin-model-versions)ください。93Google Cloud の Agent Platform 認証情報でサインインするには、以下の[Agent Platform でサインイン](#sign-in-with-agent-platform)に従ってください。チーム全体に Claude Code をデプロイするには、[手動セットアップ](#set-up-manually)の手順を使用し、ロールアウト前に[モデルバージョンをピン留めして](#5-pin-model-versions)ください。

94 94 

95<h2 id="sign-in-with-vertex-ai">95<h2 id="sign-in-with-agent-platform">

96 Vertex AI でサインイン96 Agent Platform でサインイン

97</h2>97</h2>

98 98 

99Google Cloud 認証情報を持っていて、Vertex AI を通じて Claude Code の使用を開始したい場合、ログインウィザードがそれをガイドします。GCP 側の前提条件はプロジェクトごとに 1 回完了します。ウィザードが Claude Code 側を処理します。99Google Cloud 認証情報を持っていて、Google Cloud の Agent Platform を通じて Claude Code の使用を開始したい場合、ログインウィザードがそれをガイドします。GCP 側の前提条件はプロジェクトごとに 1 回完了します。ウィザードが Claude Code 側を処理します。

100 100 

101<Note>101<Note>

102 Vertex AI セットアップウィザードには Claude Code v2.1.98 以降が必要です。`claude --version` を実行して確認してください。102 Google Cloud の Agent Platform セットアップウィザードには Claude Code v2.1.98 以降が必要です。`claude --version` を実行して確認してください。

103</Note>103</Note>

104 104 

105<Steps>105<Steps>

106 <Step title="GCP プロジェクトで Claude モデルを有効にする">106 <Step title="GCP プロジェクトで Claude モデルを有効にする">

107 プロジェクトの[Vertex AI API を有効にして](#1-enable-vertex-ai-api)、[Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)で必要な Claude モデルへのアクセスをリクエストしてください。アカウントに必要な権限については、[IAM 設定](#iam-configuration)を参照してください。107 プロジェクトの[Google Cloud の Agent Platform API を有効にして](#1-enable-agent-platform-api)、[Google Cloud の Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)で必要な Claude モデルへのアクセスをリクエストしてください。アカウントに必要な権限については、[IAM 設定](#iam-configuration)を参照してください。

108 </Step>108 </Step>

109 109 

110 <Step title="Claude Code を起動して Vertex AI を選択する">110 <Step title="Claude Code を起動して Google Cloud の Agent Platform を選択する">

111 `claude` を実行します。ログインプロンプトで、**3rd-party platform**、次に **Google Vertex AI** を選択します。111 `claude` を実行します。ログインプロンプトで、**3rd-party platform**、次に **Google Vertex AI** を選択します。これはログインプロンプトが Google Cloud の Agent Platform に対して使用しているラベルです。

112 </Step>112 </Step>

113 113 

114 <Step title="ウィザードプロンプトに従う">114 <Step title="ウィザードプロンプトに従う">


122 リージョン設定122 リージョン設定

123</h2>123</h2>

124 124 

125Claude Code は Vertex AI の[グローバル](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai)、マルチリージョン、および地域別エンドポイントをサポートしています。`CLOUD_ML_REGION` を `global`、`eu` または `us` などのマルチリージョンロケーション、または `us-east5` などの特定のリージョンに設定します。Claude Code は各フォームの正しい Vertex AI ホスト名を選択します。これには、マルチリージョンロケーション用の `aiplatform.eu.rep.googleapis.com` および `aiplatform.us.rep.googleapis.com` ホストが含まれます。125Claude Code は Google Cloud Agent Platform の[グローバル](https://cloud.google.com/blog/products/ai-machine-learning/global-endpoint-for-claude-models-generally-available-on-vertex-ai)、マルチリージョン、および地域別エンドポイントをサポートしています。`CLOUD_ML_REGION` を `global`、`eu` または `us` などのマルチリージョンロケーション、または `us-east5` などの特定のリージョンに設定します。Claude Code は各フォームの正しい Google Cloud の Agent Platform ホスト名を選択します。これには、マルチリージョンロケーション用の `aiplatform.eu.rep.googleapis.com` および `aiplatform.us.rep.googleapis.com` ホストが含まれます。

126 126 

127<Note>127<Note>

128 Vertex AI は、すべてのエンドポイントタイプで Claude Code デフォルトモデルをサポートしていない場合があります。モデルの可用性は、[特定のリージョン](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#genai-partner-models)、マルチリージョンロケーション、および[グローバルエンドポイント](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#supported_models)によって異なります。サポートされているロケーションに切り替えるか、サポートされているモデルを指定する必要がある場合があります。128 Google Cloud の Agent Platform は、すべてのエンドポイントタイプで Claude Code デフォルトモデルをサポートしていない場合があります。モデルの可用性は、[特定のリージョン](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/locations#genai-partner-models)、マルチリージョンロケーション、および[グローバルエンドポイント](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-partner-models#supported_models)によって異なります。サポートされているロケーションに切り替えるか、サポートされているモデルを指定する必要がある場合があります。

129</Note>129</Note>

130 130 

131<h2 id="set-up-manually">131<h2 id="set-up-manually">

132 手動でセットアップする132 手動でセットアップする

133</h2>133</h2>

134 134 

135ウィザードの代わりに環境変数を通じて Vertex AI を設定するには、例えば CI またはスクリプト化されたエンタープライズロールアウトで、以下の手順に従ってください。135ウィザードの代わりに環境変数を通じて Google Cloud の Agent Platform を設定するには、例えば CI またはスクリプト化されたエンタープライズロールアウトで、以下の手順に従ってください。

136 136 

137<h3 id="1-enable-vertex-ai-api">137<h3 id="1-enable-agent-platform-api">

138 1. Vertex AI API を有効にする138 1. Agent Platform API を有効にする

139</h3>139</h3>

140 140 

141GCP プロジェクトで Vertex AI API を有効にします。141GCP プロジェクトで Google Cloud の Agent Platform API を有効にします。

142 142 

143```bash theme={null}143```bash theme={null}

144# プロジェクト ID を設定144# プロジェクト ID を設定

145gcloud config set project YOUR-PROJECT-ID145gcloud config set project YOUR-PROJECT-ID

146 146 

147# Vertex AI API を有効にする147# Agent Platform API を有効にする

148gcloud services enable aiplatform.googleapis.com148gcloud services enable aiplatform.googleapis.com

149```149```

150 150 


152 2. モデルアクセスをリクエストする152 2. モデルアクセスをリクエストする

153</h3>153</h3>

154 154 

155Vertex AI で Claude モデルへのアクセスをリクエストします。155Google Cloud の Agent Platform で Claude モデルへのアクセスをリクエストします。

156 156 

1571. [Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)に移動します1571. [Google Cloud の Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)に移動します

1582. 'Claude'モデルを検索します1582. 'Claude'モデルを検索します

1593. 目的の Claude モデルへのアクセスをリクエストします(例:Claude Sonnet 4.6)1593. 目的の Claude モデルへのアクセスをリクエストします(例:Claude Sonnet 4.6)

1604. 承認を待ちます(24 ~ 48 時間かかる場合があります)1604. 承認を待ちます(24 ~ 48 時間かかる場合があります)


170Claude Code v2.1.121 以降は、同じ Application Default Credentials チェーンを通じて [X.509 証明書ベースのワークロード ID フェデレーション](https://cloud.google.com/iam/docs/workload-identity-federation-with-x509-certificates)をサポートしています。`GOOGLE_APPLICATION_CREDENTIALS` を認証情報設定ファイルのパスに設定します。170Claude Code v2.1.121 以降は、同じ Application Default Credentials チェーンを通じて [X.509 証明書ベースのワークロード ID フェデレーション](https://cloud.google.com/iam/docs/workload-identity-federation-with-x509-certificates)をサポートしています。`GOOGLE_APPLICATION_CREDENTIALS` を認証情報設定ファイルのパスに設定します。

171 171 

172<Note>172<Note>

173 Claude Code は Vertex AI リクエストのプロジェクト ID として `ANTHROPIC_VERTEX_PROJECT_ID` を使用します。`GCLOUD_PROJECT` および `GOOGLE_CLOUD_PROJECT` 環境変数と `GOOGLE_APPLICATION_CREDENTIALS` で参照される認証情報ファイルがこれより優先されます。これらのいずれも設定されていない場合、プロジェクト ID は `gcloud` 設定またはアタッチされたサービスアカウントから解決されます。173 Claude Code は Google Cloud の Agent Platform リクエストのプロジェクト ID として `ANTHROPIC_VERTEX_PROJECT_ID` を使用します。`GCLOUD_PROJECT` および `GOOGLE_CLOUD_PROJECT` 環境変数と `GOOGLE_APPLICATION_CREDENTIALS` で参照される認証情報ファイルがこれより優先されます。これらのいずれも設定されていない場合、プロジェクト ID は `gcloud` 設定またはアタッチされたサービスアカウントから解決されます。

174</Note>174</Note>

175 175 

176<h4 id="advanced-credential-configuration">176<h4 id="advanced-credential-configuration">


197次の環境変数を設定します。197次の環境変数を設定します。

198 198 

199```bash theme={null}199```bash theme={null}

200# Vertex AI 統合を有効にする200# Agent Platform 統合を有効にする

201export CLAUDE_CODE_USE_VERTEX=1201export CLAUDE_CODE_USE_VERTEX=1

202export CLOUD_ML_REGION=global202export CLOUD_ML_REGION=global

203export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID203export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

204 204 

205# オプション:カスタムエンドポイントまたはゲートウェイ用に Vertex エンドポイント URL をオーバーライドする205# オプション:カスタムエンドポイントまたはゲートウェイ用に Agent Platform エンドポイント URL をオーバーライドする

206# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com206# export ANTHROPIC_VERTEX_BASE_URL=https://aiplatform.googleapis.com

207 207 

208# オプション:必要に応じてプロンプトキャッシングを無効にする208# オプション:必要に応じてプロンプトキャッシングを無効にする


216export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1216export VERTEX_REGION_CLAUDE_4_6_SONNET=europe-west1

217```217```

218 218 

219ほとんどのモデルバージョンには、対応する `VERTEX_REGION_CLAUDE_*` 変数があります。完全なリストについては、[環境変数リファレンス](/ja/env-vars)を参照してください。どのモデルがグローバルエンドポイントをサポートしているか、または地域別のみをサポートしているかを確認するには、[Vertex Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)を確認してください。219ほとんどのモデルバージョンには、対応する `VERTEX_REGION_CLAUDE_*` 変数があります。完全なリストについては、[環境変数リファレンス](/ja/env-vars)を参照してください。どのモデルがグローバルエンドポイントをサポートしているか、または地域別のみをサポートしているかを確認するには、[Google Cloud の Agent Platform Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)を確認してください。

220 220 

221[prompt caching](/ja/prompt-caching)は自動的に有効になります。これを無効にするには、`DISABLE_PROMPT_CACHING=1` を設定します。デフォルトの 5 分ではなく 1 時間のキャッシュ TTL をリクエストするには、`ENABLE_PROMPT_CACHING_1H=1` を設定します。1 時間の TTL でのキャッシュ書き込みはより高いレートで課金されます。レート制限を高くするには、Google Cloud サポートに連絡してください。Vertex AI を使用する場合、Google Cloud 認証情報を通じて認証が処理されるため、`/logout` コマンドは無効になります。221[prompt caching](/ja/prompt-caching)は自動的に有効になります。これを無効にするには、`DISABLE_PROMPT_CACHING=1` を設定します。デフォルトの 5 分ではなく 1 時間のキャッシュ TTL をリクエストするには、`ENABLE_PROMPT_CACHING_1H=1` を設定します。1 時間の TTL でのキャッシュ書き込みはより高いレートで課金されます。レート制限を高くするには、Google Cloud サポートに連絡してください。Google Cloud の Agent Platform を使用する場合、Google Cloud 認証情報を通じて認証が処理されるため、`/logout` コマンドは無効になります。

222 222 

223Claude Code は Vertex AI でデフォルトで [MCP tool search](/ja/mcp#scale-with-mcp-tool-search)を無効にしているため、MCP ツール定義は事前にロードされます。Vertex AI は Claude Sonnet 4.5 以降および Claude Opus 4.5 以降のツール検索をサポートしています。`ENABLE_TOOL_SEARCH=true` を設定して、これらのモデルで有効にします。Vertex AI の以前のモデルは必要なベータヘッダーを受け入れず、これらのモデルでツール検索を有効にするとリクエストが失敗します。223Claude Code は Google Cloud の Agent Platform でデフォルトで [MCP tool search](/ja/mcp#scale-with-mcp-tool-search)を無効にしているため、MCP ツール定義は事前にロードされます。Google Cloud の Agent Platform は Claude Sonnet 4.5 以降および Claude Opus 4.5 以降のツール検索をサポートしています。`ENABLE_TOOL_SEARCH=true` を設定して、これらのモデルで有効にします。Google Cloud の Agent Platform の以前のモデルは必要なベータヘッダーを受け入れず、これらのモデルでツール検索を有効にするとリクエストが失敗します。

224 224 

225<h3 id="5-pin-model-versions">225<h3 id="5-pin-model-versions">

226 5. モデルバージョンをピン留めする226 5. モデルバージョンをピン留めする

227</h3>227</h3>

228 228 

229<Warning>229<Warning>

230 複数のユーザーにデプロイする場合は、特定のモデルバージョンをピン留めしてください。ピン留めなしでは、`sonnet` および `opus` などのモデルエイリアスは Claude Code の Vertex AI 用の組み込みデフォルトに解決され、最新リリースより遅れる可能性があり、プロジェクトでまだ有効になっていない可能性があります。Claude Code は、デフォルトが利用できない場合、起動時に[前のバージョンにフォールバック](#startup-model-checks)しますが、ピン留めすることで、ユーザーが新しいモデルに移行するタイミングを制御できます。230 複数のユーザーにデプロイする場合は、特定のモデルバージョンをピン留めしてください。ピン留めなしでは、`sonnet` および `opus` などのモデルエイリアスは Claude Code の Google Cloud の Agent Platform 用の組み込みデフォルトに解決され、最新リリースより遅れる可能性があり、プロジェクトでまだ有効になっていない可能性があります。Claude Code は、デフォルトが利用できない場合、起動時に[前のバージョンにフォールバック](#startup-model-checks)しますが、ピン留めすることで、ユーザーが新しいモデルに移行するタイミングを制御できます。

231</Warning>231</Warning>

232 232 

233これらの環境変数を特定の Vertex AI モデル ID に設定します。233これらの環境変数を特定の Google Cloud の Agent Platform モデル ID に設定します。

234 234 

235`ANTHROPIC_DEFAULT_OPUS_MODEL` がない場合、Vertex 上の `opus` エイリアスは Opus 4.6 に解決されます。最新モデルを使用するには、Opus 4.8 ID に設定します。235`ANTHROPIC_DEFAULT_OPUS_MODEL` がない場合、Google Cloud の Agent Platform 上の `opus` エイリアスは Opus 4.6 に解決されます。最新モデルを使用するには、Opus 4.8 ID に設定します。

236 236 

237```bash theme={null}237```bash theme={null}

238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'238export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'


249| プライマリモデル | `claude-sonnet-4-5@20250929` |249| プライマリモデル | `claude-sonnet-4-5@20250929` |

250| 小型/高速モデル | プライマリモデルと同じ |250| 小型/高速モデル | プライマリモデルと同じ |

251 251 

252セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル(通常は Haiku クラスモデル)を使用します。Vertex AI では、Haiku がすべてのプロジェクトまたはリージョンで有効になっていない可能性があるため、Claude Code はこれをプライマリモデルにデフォルト設定します。バックグラウンドタスクに Haiku を使用するには、`ANTHROPIC_DEFAULT_HAIKU_MODEL` をプロジェクトで利用可能なモデル ID に設定します。252セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル(通常は Haiku クラスモデル)を使用します。Google Cloud の Agent Platform では、Haiku がすべてのプロジェクトまたはリージョンで有効になっていない可能性があるため、Claude Code はこれをプライマリモデルにデフォルト設定します。バックグラウンドタスクに Haiku を使用するには、`ANTHROPIC_DEFAULT_HAIKU_MODEL` をプロジェクトで利用可能なモデル ID に設定します。

253 253 

254モデルをさらにカスタマイズするには、以下を実行します。254モデルをさらにカスタマイズするには、以下を実行します。

255 255 


262 起動時のモデルチェック262 起動時のモデルチェック

263</h2>263</h2>

264 264 

265Claude Code が Vertex AI で設定されて起動すると、使用するモデルがプロジェクトでアクセス可能であることを確認します。このチェックには Claude Code v2.1.98 以降が必要です。265Claude Code が Google Cloud の Agent Platform で設定されて起動すると、使用するモデルがプロジェクトでアクセス可能であることを確認します。このチェックには Claude Code v2.1.98 以降が必要です。

266 266 

267Claude Code デフォルトより古いモデルバージョンをピン留めしていて、プロジェクトが新しいバージョンを呼び出せる場合、Claude Code はピンを更新するよう促します。受け入れると、新しいモデル ID が[ユーザー設定ファイル](/ja/settings)に書き込まれ、Claude Code が再起動されます。拒否すると、次のデフォルトバージョン変更まで記憶されます。267Claude Code デフォルトより古いモデルバージョンをピン留めしていて、プロジェクトが新しいバージョンを呼び出せる場合、Claude Code はピンを更新するよう促します。受け入れると、新しいモデル ID が[ユーザー設定ファイル](/ja/settings)に書き込まれ、Claude Code が再起動されます。拒否すると、次のデフォルトバージョン変更まで記憶されます。

268 268 


280 280 

281より制限的な権限については、上記の権限のみを持つカスタムロールを作成してください。281より制限的な権限については、上記の権限のみを持つカスタムロールを作成してください。

282 282 

283詳細については、[Vertex IAM ドキュメント](https://cloud.google.com/vertex-ai/docs/general/access-control)を参照してください。283詳細については、[Google Cloud の Agent Platform IAM ドキュメント](https://cloud.google.com/vertex-ai/docs/general/access-control)を参照してください。

284 284 

285<Note>285<Note>

286 Claude Code 用に専用の GCP プロジェクトを作成して、コスト追跡とアクセス制御を簡素化してください。286 Claude Code 用に専用の GCP プロジェクトを作成して、コスト追跡とアクセス制御を簡素化してください。


290 100 万トークンコンテキストウィンドウ290 100 万トークンコンテキストウィンドウ

291</h2>291</h2>

292 292 

293Claude Sonnet 5、Opus 4.6 以降、および Sonnet 4.6 は、Vertex AI で[100 万トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。Sonnet 5 は常に 100 万ウィンドウで実行され、選択する `[1m]` バリアントはありません。その他のモデルについては、Claude Code は 100 万トークンモデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。293Claude Sonnet 5、Opus 4.6 以降、および Sonnet 4.6 は、Google Cloud の Agent Platform で[100 万トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。Sonnet 5 は常に 100 万ウィンドウで実行され、選択する `[1m]` バリアントはありません。その他のモデルについては、Claude Code は 100 万トークンモデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。

294 294 

295[セットアップウィザード](#sign-in-with-vertex-ai)は、モデルをピン留めするときに 100 万トークンコンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[サードパーティデプロイメント用のモデルをピン留めする](/ja/model-config#pin-models-for-third-party-deployments)を参照してください。295[セットアップウィザード](#sign-in-with-agent-platform)は、モデルをピン留めするときに 100 万トークンコンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[サードパーティデプロイメント用のモデルをピン留めする](/ja/model-config#pin-models-for-third-party-deployments)を参照してください。

296 296 

297<h2 id="troubleshooting">297<h2 id="troubleshooting">

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


325 追加リソース325 追加リソース

326</h2>326</h2>

327 327 

328* [Vertex AI ドキュメント](https://cloud.google.com/vertex-ai/docs)328* [Google Cloud の Agent Platform ドキュメント](https://cloud.google.com/vertex-ai/docs)

329* [Vertex AI 価格](https://cloud.google.com/vertex-ai/pricing)329* [Google Cloud の Agent Platform 価格](https://cloud.google.com/vertex-ai/pricing)

330* [Vertex AI クォータと制限](https://cloud.google.com/vertex-ai/docs/quotas)330* [Google Cloud の Agent Platform クォータと制限](https://cloud.google.com/vertex-ai/docs/quotas)

headless.md +9 −3

Details

56| カスタムエージェント | `--agents <json>` |56| カスタムエージェント | `--agents <json>` |

57| プラグイン | `--plugin-dir <path>`、`--plugin-url <url>` |57| プラグイン | `--plugin-dir <path>`、`--plugin-url <url>` |

58 58 

59ベアモードは OAuth とキーチェーン読み取りをスキップします。Anthropic 認証は `ANTHROPIC_API_KEY` または `--settings` に渡される JSON の `apiKeyHelper` から取得する必要があります。Bedrock、Vertex、および Foundry は通常のプロバイダー認証情報を使用します。59ベアモードは OAuth とキーチェーン読み取りをスキップします。Anthropic 認証は `ANTHROPIC_API_KEY` または `--settings` に渡される JSON の `apiKeyHelper` から取得する必要があります。Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry は通常のプロバイダー認証情報を使用します。

60 60 

61<Note>61<Note>

62 `--bare` はスクリプトおよび SDK 呼び出しの推奨モードであり、将来のリリースで `-p` のデフォルトになります。62 `--bare` はスクリプトおよび SDK 呼び出しの推奨モードであり、将来のリリースで `-p` のデフォルトになります。


136 --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'136 --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}'

137```137```

138 138 

139値が有効な JSON Schema でない場合、`claude` は `Error: --json-schema is not a valid JSON Schema` で終了し、その後にバリデータの診断が続きます。Claude Code は `format` キーワード(例:`"format": "email"`)を使用するスキーマを受け入れますが、`format` を注釈として扱い、強制しません。v2.1.205 より前では、Claude Code は無効なスキーマを黙って無視し、構造化されていないテキストを返し、`format` を含むスキーマを無効として扱いました。

140 

139<Tip>141<Tip>

140 [jq](https://jqlang.github.io/jq/) などのツールを使用して応答を解析し、特定のフィールドを抽出します。142 [jq](https://jqlang.github.io/jq/) などのツールを使用して応答を解析し、特定のフィールドを抽出します。

141 143 


182| `uuid` | 文字列 | 一意のイベント識別子 |184| `uuid` | 文字列 | 一意のイベント識別子 |

183| `session_id` | 文字列 | イベントが属するセッション |185| `session_id` | 文字列 | イベントが属するセッション |

184 186 

185`system/init` イベントは、モデル、ツール、MCP サーバー、および読み込まれたプラグインを含むセッションメタデータを報告します。[`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ja/env-vars) が設定されていない限り、ストリームの最初のイベントです。その場合、`plugin_install` イベントがそれより前にあります。プラグインフィールドを使用して、プラグインが読み込まれなかった場合に CI を失敗させます。187`system/init` イベントは、モデル、ツール、MCP サーバー、および読み込まれたプラグインを含むセッションメタデータを報告します。[`CLAUDE_CODE_SYNC_PLUGIN_INSTALL`](/ja/env-vars) が設定されていない限り、ストリームの最初のイベントです。その場合、`plugin_install` イベントがそれより前にあります。

188 

189イベントは、このバージョンの Claude Code が実装するプロトコル動作(例:`interrupt_receipt_v1`)の名前を付けるオプションの `capabilities` 文字列配列も含みます。バージョン文字列を比較する代わりに、機能検出に使用し、認識しない値は無視してください。このフィールドは Claude Code v2.1.205 以降が必要であり、以前のバージョンでは存在しません。機能リストについては、[`SDKSystemMessage`](/ja/agent-sdk/typescript#sdksystemmessage) を参照してください。

190 

191プラグインフィールドを使用して、プラグインが読み込まれなかった場合に CI を失敗させます。

186 192 

187| フィールド | 型 | 説明 |193| フィールド | 型 | 説明 |

188| --------------- | -- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |194| --------------- | -- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |


234`--allowedTools` フラグは [パーミッションルール構文](/ja/settings#permission-rule-syntax) を使用します。末尾の ` *` はプレフィックスマッチングを有効にするため、`Bash(git diff *)` は `git diff` で始まるすべてのコマンドを許可します。スペースは重要です。スペースがない場合、`Bash(git diff*)` は `git diff-index` にも一致します。240`--allowedTools` フラグは [パーミッションルール構文](/ja/settings#permission-rule-syntax) を使用します。末尾の ` *` はプレフィックスマッチングを有効にするため、`Bash(git diff *)` は `git diff` で始まるすべてのコマンドを許可します。スペースは重要です。スペースがない場合、`Bash(git diff*)` は `git diff-index` にも一致します。

235 241 

236<Note>242<Note>

237 ユーザーが呼び出した [skills](/ja/skills) およびカスタムコマンドは `-p` モードで機能します。プロンプト文字列に `/skill-name` を含めると、Claude Code は実行前にそれを展開します。`/login` などの対話ダイアログを開く組み込みコマンドは、`-p` モードでは利用できません。{/* min-version: 2.1.181 */}`-p` 呼び出しから設定を変更するには、`/config` に `key=value` を渡します。例えば `/config thinking=false` です。243 ユーザーが呼び出した [skills](/ja/skills) およびカスタムコマンドは `-p` モードで機能します。プロンプト文字列に `/skill-name` を含めると、Claude Code は実行前にそれを展開します。`/login` などの対話ダイアログを開く組み込みコマンドは、`-p` モードでは利用できません。{/* min-version: 2.1.205 */}`/model`、`/effort`、`/fast`、`/color`、および `/rename` は値を引数として受け入れます。例えば `/model sonnet` のように、`/mcp` は引数なしでサーバーステータスのテキスト概要を出力します。これらの形式は Claude Code v2.1.205 以降が必要であり、各コマンドの [利用可能性に関する注記](/ja/commands#all-commands) に従います。{/* min-version: 2.1.181 */}`-p` 呼び出しから設定を変更するには、`/config` に `key=value` を渡します。例えば `/config thinking=false` です。

238</Note>244</Note>

239 245 

240<h3 id="customize-the-system-prompt">246<h3 id="customize-the-system-prompt">

hooks.md +21 −13

Details

164フックは JSON 設定ファイルで定義されます。設定には 3 つのネストレベルがあります。164フックは JSON 設定ファイルで定義されます。設定には 3 つのネストレベルがあります。

165 165 

1661. 応答する[フック イベント](#hook-events)を選択します(`PreToolUse` や `Stop` など)1661. 応答する[フック イベント](#hook-events)を選択します(`PreToolUse` や `Stop` など)

1672. 発火するタイミングをフィルタリングする[マッチャー グループ](#matcher-patterns)を追加します('Bash ツールのみ'など)1672. 発火するタイミングをフィルタリングする[マッチャー グループ](#matcher-patterns)を追加します(Bash ツールのみなど)

1683. マッチしたときに実行する 1 つ以上の[フック ハンドラー](#hook-handler-fields)を定義します1683. マッチしたときに実行する 1 つ以上の[フック ハンドラー](#hook-handler-fields)を定義します

169 169 

170完全なウォークスルーと注釈付きの例については、上記の[フックがどのように解決されるか](#how-a-hook-resolves)を参照してください。170完全なウォークスルーと注釈付きの例については、上記の[フックがどのように解決されるか](#how-a-hook-resolves)を参照してください。

171 171 

172<Note>172<Note>

173 このページでは各レベルに特定の用語を使用しています。**フック イベント**はライフサイクル ポイント、**マッチャー グループ**はフィルター、**フック ハンドラー**はシェル コマンド、HTTP エンドポイント、MCP ツール、プロンプト、または実行されるエージェントです。'フック'単独は一般的な機能を指します。173 このページでは各レベルに特定の用語を使用しています。**フック イベント**はライフサイクル ポイント、**マッチャー グループ**はフィルター、**フック ハンドラー**はシェル コマンド、HTTP エンドポイント、MCP ツール、プロンプト、または実行されるエージェントです。フック単独は一般的な機能を指します。

174</Note>174</Note>

175 175 

176<h3 id="hook-locations">176<h3 id="hook-locations">


280 280 

281完全一致セット内のハイフンには Claude Code v2.1.195 以降が必要です。以前のバージョンでは、`mcp__brave-search` のようなベアのハイフン付きプレフィックスはアンカーなしの正規表現として評価され、そのサーバーのすべてのツールにマッチします。`mcp__brave-search__.*` 形式はすべてのバージョンで機能します。281完全一致セット内のハイフンには Claude Code v2.1.195 以降が必要です。以前のバージョンでは、`mcp__brave-search` のようなベアのハイフン付きプレフィックスはアンカーなしの正規表現として評価され、そのサーバーのすべてのツールにマッチします。`mcp__brave-search__.*` 形式はすべてのバージョンで機能します。

282 282 

283[プラグイン バンドル MCP サーバー](/ja/mcp#plugin-provided-mcp-servers)からのツールは、プラグイン名を含むスコープ付きサーバー セグメントを使用します。`mcp__plugin_<plugin-name>_<server-name>__<tool>`。ベア サーバー キーに対して記述されたマッチャーは、これらのツールに対して発火しません。`db` キーの下でサーバーをバンドルする `my-plugin` という名前のプラグインの場合、`query` ツールは `mcp__plugin_my-plugin_db__query` として表示されるため、そのサーバーのすべてのツールのマッチャーは `mcp__plugin_my-plugin_db__.*` です。ハンドラーの [`if` フィールド](#common-fields)で同じスコープ付きツール名を使用します。スコープ付き名がどのように構築されるかについては、[プラグイン提供 MCP サーバー](/ja/mcp#plugin-provided-mcp-servers)を参照してください。

284 

283この例は、すべてのメモリ サーバー操作をログし、任意の MCP サーバーからの書き込み操作を検証します。285この例は、すべてのメモリ サーバー操作をログし、任意の MCP サーバーからの書き込み操作を検証します。

284 286 

285```json theme={null}287```json theme={null}


321* **[プロンプト フック](#prompt-and-agent-hook-fields)** (`type: "prompt"`): Claude モデルにプロンプトを送信して、単一ターンの評価を行います。モデルは yes/no 決定を JSON として返します。[プロンプト ベースのフック](#prompt-based-hooks)を参照してください。323* **[プロンプト フック](#prompt-and-agent-hook-fields)** (`type: "prompt"`): Claude モデルにプロンプトを送信して、単一ターンの評価を行います。モデルは yes/no 決定を JSON として返します。[プロンプト ベースのフック](#prompt-based-hooks)を参照してください。

322* **[エージェント フック](#prompt-and-agent-hook-fields)** (`type: "agent"`): Read、Grep、Glob などのツールを使用して条件を検証してから決定を返すことができるサブエージェントを生成します。エージェント フックは実験的であり、変更される可能性があります。[エージェント ベースのフック](#agent-based-hooks)を参照してください。324* **[エージェント フック](#prompt-and-agent-hook-fields)** (`type: "agent"`): Read、Grep、Glob などのツールを使用して条件を検証してから決定を返すことができるサブエージェントを生成します。エージェント フックは実験的であり、変更される可能性があります。[エージェント ベースのフック](#agent-based-hooks)を参照してください。

323 325 

324すべてのマッチング フックは並列で実行され、同一のハンドラーは自動的に重複排除されます。コマンド フックはコマンド文字列と `args` で重複排除され、HTTP フックは URL で重複排除されます。ハンドラーは Claude Code の環境を持つ現在のディレクトリで実行されます。`$CLAUDE_CODE_REMOTE` 環境変数はリモート Web 環境で `"true"` に設定され、ローカル CLI では設定されません。{/* min-version: 2.1.199 */}v2.1.199 以降、[`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/ja/env-vars)は、ローカル セッションがアクティブな Remote Control 接続を持つ間、[Remote Control](/ja/remote-control)セッション ID に設定されます。326すべてのマッチング フックは並列で実行され、同一のハンドラーは自動的に重複排除されます。コマンド フックはコマンド文字列と `args` で重複排除され、HTTP フックは URL で重複排除されます。

327 

328ハンドラーは Claude Code の環境を持つ現在のディレクトリで実行されます。`$CLAUDE_CODE_REMOTE` 環境変数はリモート Web 環境で `"true"` に設定され、ローカル CLI では設定されません。{/* min-version: 2.1.199 */}v2.1.199 以降、[`$CLAUDE_CODE_BRIDGE_SESSION_ID`](/ja/env-vars)は、ローカル セッションがアクティブな Remote Control 接続を持つ間、[Remote Control](/ja/remote-control)セッション ID に設定されます。

325 329 

326<h4 id="common-fields">330<h4 id="common-fields">

327 共通フィールド331 共通フィールド


454[共通フィールド](#common-fields)に加えて、MCP ツール フックはこれらのフィールドを受け入れます。458[共通フィールド](#common-fields)に加えて、MCP ツール フックはこれらのフィールドを受け入れます。

455 459 

456| フィールド | 必須 | 説明 |460| フィールド | 必須 | 説明 |

457| :------- | :-- | :----------------------------------------------------------------------------------------------------------- |461| :------- | :-- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

458| `server` | はい | 設定された MCP サーバーの名前。サーバーは既に接続されている必要があります。フックは OAuth または接続フローをトリガーしません |462| `server` | はい | 設定された MCP サーバーの名前。[プラグイン バンドル サーバー](/ja/mcp#plugin-provided-mcp-servers)の場合、これはスコープ付き名前 `plugin:<plugin-name>:<server-name>`(例:`plugin:my-plugin:db`)であり、ベア サーバー キーではありません。サーバーは既に接続されている必要があります。フックは OAuth または接続フローをトリガーしません |

459| `tool` | はい | そのサーバー上で呼び出すツールの名前 |463| `tool` | はい | そのサーバー上で呼び出すツールの名前 |

460| `input` | いいえ | ツールに渡される引数。文字列値は、フックの[JSON 入力](#hook-input-and-output)から `${path}` 置換をサポートします(例:`"${tool_input.file_path}"`) |464| `input` | いいえ | ツールに渡される引数。文字列値は、フックの[JSON 入力](#hook-input-and-output)から `${path}` 置換をサポートします(例:`"${tool_input.file_path}"`) |

461 465 


636| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |640| :---------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

637| `session_id` | 現在のセッション識別子 |641| `session_id` | 現在のセッション識別子 |

638| `prompt_id` | 現在処理中のユーザー プロンプトを識別する UUID。[OpenTelemetry イベントの `prompt.id` 属性](/ja/monitoring-usage#event-correlation-attributes)と一致するため、単一のプロンプトのテレメトリでフック出力を相関させることができます。最初のユーザー入力まで存在しません。{/* min-version: 2.1.196 */}Claude Code v2.1.196 以降が必要です |642| `prompt_id` | 現在処理中のユーザー プロンプトを識別する UUID。[OpenTelemetry イベントの `prompt.id` 属性](/ja/monitoring-usage#event-correlation-attributes)と一致するため、単一のプロンプトのテレメトリでフック出力を相関させることができます。最初のユーザー入力まで存在しません。{/* min-version: 2.1.196 */}Claude Code v2.1.196 以降が必要です |

639| `transcript_path` | 会話 JSON へのパス |643| `transcript_path` | 会話 JSON へのパス。トランスクリプト ファイルは非同期に書き込まれ、メモリ内の会話に遅れる可能性があるため、フックが発火するときに現在のターンの最新メッセージがまだ含まれていない可能性があります。現在のターンの最終的なアシスタント テキストが必要なフックは、トランスクリプトを読む代わりに[Stop](#stop)と[SubagentStop](#subagentstop)の `last_assistant_message` を使用する必要があります |

640| `cwd` | フックが呼び出されるときの現在の作業ディレクトリ |644| `cwd` | フックが呼び出されるときの現在の作業ディレクトリ |

641| `permission_mode` | 現在の[権限モード](/ja/permissions#permission-modes): `"default"`、`"plan"`、`"acceptEdits"`、`"auto"`、`"dontAsk"`、または `"bypassPermissions"`。すべてのイベントがこのフィールドを受け取るわけではありません。各イベントの JSON 例を確認してください |645| `permission_mode` | 現在の[権限モード](/ja/permissions#permission-modes): `"default"`、`"plan"`、`"acceptEdits"`、`"auto"`、`"dontAsk"`、または `"bypassPermissions"`。**Manual** というラベルが付いたモードは `"default"` として到着し、`"manual"` として到着することはないため、`"default"` と一致するスクリプトは引き続き機能します。すべてのイベントがこのフィールドを受け取るわけではありません。各[フック イベント](#hook-events)セクションの JSON 例を確認してください |

642| `effort` | アクティブな[努力レベル](/ja/model-config#adjust-effort-level)を保持する `level` フィールドを持つオブジェクト。ターンの場合: `"low"`、`"medium"`、`"high"`、`"xhigh"`、または `"max"`。リクエストされたモデル努力が現在のモデルがサポートしているものを超える場合、これはモデルが実際に使用したダウングレードされたレベルです。Ultracode は異なるレベルではなく、`"xhigh"` として報告されます。オブジェクトは[ステータス ライン](/ja/statusline#available-data)の `effort` フィールドと一致します。`PreToolUse`、`PostToolUse`、`Stop`、`SubagentStop` などのツール使用コンテキスト内で発火するイベント、および現在のモデルが努力パラメータをサポートする場合に存在します。レベルは、フック コマンドと Bash ツールに `$CLAUDE_EFFORT` 環境変数として利用可能です。 |646| `effort` | アクティブな[努力レベル](/ja/model-config#adjust-effort-level)を保持する `level` フィールドを持つオブジェクト。ターンの場合: `"low"`、`"medium"`、`"high"`、`"xhigh"`、または `"max"`。リクエストされたモデル努力が現在のモデルがサポートしているものを超える場合、これはモデルが実際に使用したダウングレードされたレベルです。Ultracode は異なるレベルではなく、`"xhigh"` として報告されます。オブジェクトは[ステータス ライン](/ja/statusline#available-data)の `effort` フィールドと一致します。`PreToolUse`、`PostToolUse`、`Stop`、`SubagentStop` などのツール使用コンテキスト内で発火するイベント、および現在のモデルが努力パラメータをサポートする場合に存在します。レベルは、フック コマンドと Bash ツールに `$CLAUDE_EFFORT` 環境変数として利用可能です。 |

643| `hook_event_name` | 発火したイベントの名前 |647| `hook_event_name` | 発火したイベントの名前 |

644 648 


1589 ExitPlanMode1593 ExitPlanMode

1590</h5>1594</h5>

1591 1595 

1592Claude が[プラン モード](/ja/permission-modes#analyze-before-you-edit-with-plan-mode)を離れる前にプランを提示し、ユーザーに承認を求めます。Claude はツールを呼び出す前にプランをディスク上のファイルに書き込むため、モデルからのリテラル `tool_input` は `allowedPrompts` のみを含みます。Claude Code はプラン コンテンツとファイル パスをフックに渡す前に注入します。1596Claude が[プラン モード](/ja/permission-modes#analyze-before-you-edit-with-plan-mode)を離れる前にプランを提示し、ユーザーに承認を求めます。Claude はツールを呼び出す前にプランをディスク上のファイルに書き込むため、モデルからのリテラル `tool_input` は通常空です。Claude Code はプラン コンテンツとファイル パスをフックに渡す前に注入します。

1593 1597 

1594| フィールド | タイプ | 例 | 説明 |1598| フィールド | タイプ | 例 | 説明 |

1595| :--------------- | :-- | :------------------------------------------ | :----------------------------------------------------------------------------------------- |1599| :--------------- | :-- | :------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------- |

1596| `plan` | 文字列 | `"## Refactor auth\n1. Extract..."` | Markdown のプラン コンテンツ。ディスク上のプラン ファイルから注入 |1600| `plan` | 文字列 | `"## Refactor auth\n1. Extract..."` | Markdown のプラン コンテンツ。ディスク上のプラン ファイルから注入 |

1597| `planFilePath` | 文字列 | `"/Users/.../plans/refactor-auth.md"` | プラン ファイルへのパス。注入 |1601| `planFilePath` | 文字列 | `"/Users/.../plans/refactor-auth.md"` | プラン ファイルへのパス。注入 |

1598| `allowedPrompts` | 配列 | `[{"tool": "Bash", "prompt": "run tests"}]` | オプション。Claude がプランを実装するために要求しているプロンプト ベースの権限各エントリは `tool` 名とアクションのカテゴリを説明する `prompt` を含みます |1602| `allowedPrompts` | 配列 | `[{"tool": "Bash", "prompt": "run tests"}]` | {/* min-version: 2.1.205 */}非推奨。Claude Code はフィールドを受け入れますが無視しますv2.1.205 より前では、プランを実装するために Claude が要求していたプロンプト ベースの権限を含みました |

1599 1603 

1600`PostToolUse` では、`tool_response` は `plan` と `filePath` フィールドを含むオブジェクトで、承認されたプランと内部ステータス フラグを保持します。ディスクからファイルを再度読み取るのではなく、`tool_response.plan` でプラン コンテンツを読み取ります。1604`PostToolUse` では、`tool_response` は `plan` と `filePath` フィールドを含むオブジェクトで、承認されたプランと内部ステータス フラグを保持します。ディスクからファイルを再度読み取るのではなく、`tool_response.plan` でプラン コンテンツを読み取ります。

1601 1605 


1755`updatedPermissions` 出力フィールドと[`permission_suggestions` 入力フィールド](#permissionrequest-input)の両方が同じエントリ オブジェクトの配列を使用します。各エントリには、その他のフィールドを決定する `type` と、変更が書き込まれる場所を制御する `destination` があります。1759`updatedPermissions` 出力フィールドと[`permission_suggestions` 入力フィールド](#permissionrequest-input)の両方が同じエントリ オブジェクトの配列を使用します。各エントリには、その他のフィールドを決定する `type` と、変更が書き込まれる場所を制御する `destination` があります。

1756 1760 

1757| `type` | フィールド | 効果 |1761| `type` | フィールド | 効果 |

1758| :------------------ | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------ |1762| :------------------ | :------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1759| `addRules` | `rules`、`behavior`、`destination` | 権限ルールを追加します。`rules` は `{toolName, ruleContent?}` オブジェクトの配列です。ツール全体にマッチするには `ruleContent` を省略します。`behavior` は `"allow"`、`"deny"`、または `"ask"` |1763| `addRules` | `rules`、`behavior`、`destination` | 権限ルールを追加します。`rules` は `{toolName, ruleContent?}` オブジェクトの配列です。ツール全体にマッチするには `ruleContent` を省略します。`behavior` は `"allow"`、`"deny"`、または `"ask"` |

1760| `replaceRules` | `rules`、`behavior`、`destination` | `destination` で指定された `behavior` のすべてのルールを提供されたルールに置き換えます |1764| `replaceRules` | `rules`、`behavior`、`destination` | `destination` で指定された `behavior` のすべてのルールを提供されたルールに置き換えます |

1761| `removeRules` | `rules`、`behavior`、`destination` | 指定された `behavior` の一致するルールを削除 |1765| `removeRules` | `rules`、`behavior`、`destination` | 指定された `behavior` の一致するルールを削除 |

1762| `setMode` | `mode`、`destination` | 権限モードを変更します。有効なモードは `default`、`auto`、`acceptEdits`、`dontAsk`、`bypassPermissions`、`plan` |1766| `setMode` | `mode`、`destination` | 権限モードを変更します。有効なモードは `default`、`auto`、`acceptEdits`、`dontAsk`、`bypassPermissions`、`plan`、{/* min-version: 2.1.200 */}`manual`(`default` のエイリアス)です。`manual` エイリアスには Claude Code v2.1.200 以降が必要です |

1763| `addDirectories` | `directories`、`destination` | 作業ディレクトリを追加します。`directories` はパス文字列の配列 |1767| `addDirectories` | `directories`、`destination` | 作業ディレクトリを追加します。`directories` はパス文字列の配列 |

1764| `removeDirectories` | `directories`、`destination` | 作業ディレクトリを削除 |1768| `removeDirectories` | `directories`、`destination` | 作業ディレクトリを削除 |

1765 1769 


2674 WorktreeCreate 入力2678 WorktreeCreate 入力

2675</h4>2679</h4>

2676 2680 

2677[共通入力フィールド](#common-input-fields)に加えて、Workt reeCreate フックは `name` フィールドを受け取ります。これは新しいワークツリーのスラッグ識別子で、ユーザーが指定するか自動生成されます(例えば、`bold-oak-a3f2`)。2681[共通入力フィールド](#common-input-fields)に加えて、WorktreeCreate フックは `name` フィールドを受け取ります。これは新しいワークツリーのスラッグ識別子で、ユーザーが指定するか自動生成されます(例えば、`bold-oak-a3f2`)。

2678 2682 

2679```json theme={null}2683```json theme={null}

2680{2684{


2697 2701 

2698フックが失敗するか出力を生成しない場合、ワークツリー作成はエラーで失敗します。2702フックが失敗するか出力を生成しない場合、ワークツリー作成はエラーで失敗します。

2699 2703 

2704Claude Code は相対パスを、フックが実行されたディレクトリに対して解決します。結果のパスが Claude Code が入力できるディレクトリでない場合、セッションはパスを名前付けするエラーを出力し、終了コード 1 で終了します。v2.1.205 より前では、相対パスまたはディスク上に存在しないパスはセッション スタートアップでクラッシュし、`-p` を使用すると約 30 秒停止してから終了コード 0 で終了しました。

2705 

2700<h3 id="worktreeremove">2706<h3 id="worktreeremove">

2701 WorktreeRemove2707 WorktreeRemove

2702</h3>2708</h3>


3216 3222 

3217バックグラウンド プロセスが終了した後、フックが `additionalContext` フィールドを含む JSON レスポンスを生成した場合、そのコンテンツは次の会話ターンで Claude にコンテキストとして配信されます。`systemMessage` フィールドは Claude ではなく、あなたに表示されます。3223バックグラウンド プロセスが終了した後、フックが `additionalContext` フィールドを含む JSON レスポンスを生成した場合、そのコンテンツは次の会話ターンで Claude にコンテキストとして配信されます。`systemMessage` フィールドは Claude ではなく、あなたに表示されます。

3218 3224 

3225Claude Code は JSON レスポンスを同期フックと同じ[出力スキーマ](#json-output)に対して検証し、`systemMessage` が文字列でないなど、値の型が間違っているフィールドをドロップします。これは配信する代わりに行われます。`--debug` で実行すると、ドロップされた各フィールドに名前を付けた警告が表示されます。v2.1.202 より前では、非同期フックからの不正な形式の JSON 出力はセッションをクラッシュさせる可能性があり、セッションが再開されるたびにクラッシュが再発生していました。

3226 

3219非同期フック完了通知はデフォルトで抑制されます。これらを表示するには、`Ctrl+O` で詳細モードを有効にするか、`--verbose` で Claude Code を開始します。3227非同期フック完了通知はデフォルトで抑制されます。これらを表示するには、`Ctrl+O` で詳細モードを有効にするか、`--verbose` で Claude Code を開始します。

3220 3228 

3221<h3 id="run-tests-after-file-changes">3229<h3 id="run-tests-after-file-changes">

hooks-guide.md +1 −1

Details

695 </Tab>695 </Tab>

696 696 

697 <Tab title="MCP ツールをマッチさせる">697 <Tab title="MCP ツールをマッチさせる">

698 MCP ツールは組み込みツールとは異なる命名規則を使用します:`mcp__<server>__<tool>`。ここで `<server>` は MCP サーバー名で、`<tool>` はそれが提供するツールです。たとえば、`mcp__github__search_repositories` または `mcp__filesystem__read_file`。特定のサーバーからすべてのツールをターゲットするために正規表現マッチャーを使用するか、`mcp__.*__write.*` のようなパターンでサーバー全体でマッチします。リファレンスの [MCP ツールをマッチさせる](/ja/hooks#match-mcp-tools) を参照して、完全な例のリストを確認してください。698 MCP ツールは組み込みツールとは異なる命名規則を使用します:`mcp__<server>__<tool>`。ここで `<server>` は MCP サーバー名で、`<tool>` はそれが提供するツールです。たとえば、`mcp__github__search_repositories` または `mcp__filesystem__read_file`。[プラグインバンドルサーバー](/ja/mcp#plugin-provided-mcp-servers) からのツールは、`mcp__plugin_my-plugin_db__query` などのスコープ付きサーバーセグメントを使用します。特定のサーバーからすべてのツールをターゲットするために正規表現マッチャーを使用するか、`mcp__.*__write.*` のようなパターンでサーバー全体でマッチします。リファレンスの [MCP ツールをマッチさせる](/ja/hooks#match-mcp-tools) を参照して、完全な例のリストを確認してください。

699 699 

700 以下のコマンドは hook の JSON 入力からツール名を `jq` で抽出し、stderr に書き込みます。stderr に書き込むことで stdout をクリーンに保ち、メッセージを [デバッグログ](/ja/hooks#debug-hooks) に送信します:700 以下のコマンドは hook の JSON 入力からツール名を `jq` で抽出し、stderr に書き込みます。stderr に書き込むことで stdout をクリーンに保ち、メッセージを [デバッグログ](/ja/hooks#debug-hooks) に送信します:

701 701 

Details

186 186 

187`Shift+Tab` を押して権限モードをサイクルします。187`Shift+Tab` を押して権限モードをサイクルします。

188 188 

189* **デフォルト**:Claude はファイル編集とシェルコマンドの前に求めます189* **Manual**:Claude はファイル編集とシェルコマンドの前に求めます

190* **自動受け入れ編集**:Claude はファイルを編集し、`mkdir` や `mv` などの一般的なファイルシステムコマンドを実行するよう求めず、他のコマンドはまだ求めます190* **Accept edits**:Claude はファイルを編集し、`mkdir` や `mv` などの一般的なファイルシステムコマンドを実行するよう求めず、他のコマンドはまだ求めます

191* **Plan Mode**:Claude は読み取り専用ツールのみを使用し実行前に承認できるプランを作成します191* **Plan**:Claude はソースファイルを編集せずに探索しプランを提案します。権限プロンプトは Manual モードと同様に適用されます

192* **Auto mode**:Claude はバックグラウンド安全チェック付きですべてのアクションを評価します。現在は研究プレビューです192* **Auto**:Claude はバックグラウンド安全チェック付きですべてのアクションを評価します。現在は研究プレビューです

193 193 

194`.claude/settings.json` で特定のコマンドを許可することもできます。これにより、Claude は毎回求めません。これは `npm test` や `git status` などの信頼できるコマンドに便利です。設定は組織全体のポリシーから個人的な設定までスコープできます。詳細については、[権限](/ja/permissions) を参照してください。194`.claude/settings.json` で特定のコマンドを許可することもできます。これにより、Claude は毎回求めません。これは `npm test` や `git status` などの信頼できるコマンドに便利です。設定は組織全体のポリシーから個人的な設定までスコープできます。詳細については、[権限](/ja/permissions) を参照してください。

195 195 


210組み込みコマンドもセットアップをガイドします:210組み込みコマンドもセットアップをガイドします:

211 211 

212* `/init` はプロジェクト用の CLAUDE.md を作成するプロセスをウォークスルーします212* `/init` はプロジェクト用の CLAUDE.md を作成するプロセスをウォークスルーします

213* `/doctor` はインストールの一般的な問題を診断します213* `/doctor` はインストールと設定の問題を診断し、修正することができるセットアップチェックアップを実行します

214 214 

215<h3 id="it’s-a-conversation">215<h3 id="it’s-a-conversation">

216 会話です216 会話です

Details

27</h3>27</h3>

28 28 

29| ショートカット | 説明 | コンテキスト |29| ショートカット | 説明 | コンテキスト |

30| :------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |30| :------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

31| `Ctrl+C` | 割り込み、または入力をクリア | 実行中の操作を割り込みます。何も実行されていない場合、最初の押下でプロンプト入力をクリアし、2 回目の押下で Claude Code を終了します |31| `Ctrl+C` | 割り込み、または入力をクリア | 実行中の操作を割り込みます。何も実行されていない場合、最初の押下でプロンプト入力をクリアし、2 回目の押下で Claude Code を終了します |

32| `Ctrl+X Ctrl+K` | このセッション内のすべてのバックグラウンド [サブエージェント](/ja/sub-agents#run-subagents-in-foreground-or-background) を終了します。3 秒以内に 2 回押して確認 | サブエージェント制御 |32| `Ctrl+X Ctrl+K` | このセッション内のすべてのバックグラウンド [サブエージェント](/ja/sub-agents#run-subagents-in-foreground-or-background) を終了します。3 秒以内に 2 回押して確認 | サブエージェント制御 |

33| `Ctrl+D` | Claude Code セッションを終了 | EOF シグナル |33| `Ctrl+D` | Claude Code セッションを終了 | EOF シグナル |


40| `Ctrl+T` | Claude のタスクチェックリストを切り替え | ステータス領域の [Claude のタスクチェックリスト](#task-list) を表示または非表示にします。これはバックグラウンドタスクビューではありません。実行中のシェルとサブエージェントを確認するには [`/tasks`](/ja/commands) を使用してください |40| `Ctrl+T` | Claude のタスクチェックリストを切り替え | ステータス領域の [Claude のタスクチェックリスト](#task-list) を表示または非表示にします。これはバックグラウンドタスクビューではありません。実行中のシェルとサブエージェントを確認するには [`/tasks`](/ja/commands) を使用してください |

41| `Left/Right 矢印` | ダイアログタブを循環 | 権限ダイアログとメニューのタブ間を移動 |41| `Left/Right 矢印` | ダイアログタブを循環 | 権限ダイアログとメニューのタブ間を移動 |

42| `Up/Down 矢印` または `Ctrl+P`/`Ctrl+N` | カーソルを移動またはコマンド履歴を移動 | 複数行入力では、最初にカーソルをプロンプト内で移動します。カーソルが既に上端または下端にある場合、もう一度押すとコマンド履歴を移動します。{/* min-version: 2.1.169 */}v2.1.169 以降、折り返された単一行入力は複数行入力と同じように動作します |42| `Up/Down 矢印` または `Ctrl+P`/`Ctrl+N` | カーソルを移動またはコマンド履歴を移動 | 複数行入力では、最初にカーソルをプロンプト内で移動します。カーソルが既に上端または下端にある場合、もう一度押すとコマンド履歴を移動します。{/* min-version: 2.1.169 */}v2.1.169 以降、折り返された単一行入力は複数行入力と同じように動作します |

43| `Esc` | Claude を割り込み | 現在の応答またはツール呼び出しを途中で停止して、リダイレクトできます。Claude はこれまでの作業を保持します |43| `Esc` | Claude を割り込み、またはダイアログを閉じる | 現在の応答またはツール呼び出しを途中で停止して、リダイレクトできます。Claude はこれまでの作業を保持します。権限プロンプトなどのダイアログが開いている場合、`Esc` は Claude を割り込みするのではなく、ダイアログを閉じます。{/* min-version: 2.1.202 */}v2.1.202 より前は、一部のダイアログで `Esc` が 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`(モード指標で「Manual」とラベル付け)、`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) | 拡張思考を切り替え | 拡張思考モードを有効または無効にします。Fable 5 には効果がなく、常に拡張思考を使用します。{/* 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) を有効または無効にします |


270 270 

271検索は選択されたスコープ内の 100 個の最新の一意なプロンプトを読み込み、重複は最新の出現に折りたたまれます。マッチングプロンプトは検索用語が強調表示されて表示されるため、前の入力を見つけて再利用できます。271検索は選択されたスコープ内の 100 個の最新の一意なプロンプトを読み込み、重複は最新の出現に折りたたまれます。マッチングプロンプトは検索用語が強調表示されて表示されるため、前の入力を見つけて再利用できます。

272 272 

273一致を受け入れるか検索をキャンセルすると、Claude Code がまだ履歴を読み込んでいる場合でも、すぐに有効になります。v2.1.202 より前では、その読み込み中に受け入れるかキャンセルすると、内部エラーが報告される可能性がありました。

274 

273<h2 id="background-bash-commands">275<h2 id="background-bash-commands">

274 バックグラウンド Bash コマンド276 バックグラウンド Bash コマンド

275</h2>277</h2>

keybindings.md +12 −13

Details

71| `Select` | 汎用選択/リストコンポーネント |71| `Select` | 汎用選択/リストコンポーネント |

72| `Plugin` | プラグインダイアログ(参照、発見、管理) |72| `Plugin` | プラグインダイアログ(参照、発見、管理) |

73| `Scroll` | 会話スクロールとフルスクリーンモードでのテキスト選択 |73| `Scroll` | 会話スクロールとフルスクリーンモードでのテキスト選択 |

74| `Doctor` | `/doctor` 診断スクリーン |74 

75{/* max-version: 2.1.204 */}v2.1.205 より前では、`Doctor` コンテキストと `/doctor` 診断スクリーン用の `doctor:fix` アクションが存在していました。

75 76 

76<h2 id="available-actions">77<h2 id="available-actions">

77 利用可能なアクション78 利用可能なアクション


356| `select:accept` | Enter、Space | 選択した設定を変更するか、そのサブメニューを開く |357| `select:accept` | Enter、Space | 選択した設定を変更するか、そのサブメニューを開く |

357| `confirm:no` | Escape | パネルを閉じます。変更は既に保存されています |358| `confirm:no` | Escape | パネルを閉じます。変更は既に保存されています |

358 359 

359<h3 id="doctor-actions">

360 Doctor アクション

361</h3>

362 

363`Doctor` コンテキストで利用可能なアクション:

364 

365| アクション | デフォルト | 説明 |

366| :----------- | :---- | :--------------------------------------------------- |

367| `doctor:fix` | F | 診断レポートを Claude に送信して、報告された問題を修正します。問題が見つかった場合のみアクティブ |

368 

369<h3 id="voice-actions">360<h3 id="voice-actions">

370 音声アクション361 音声アクション

371</h3>362</h3>


477}468}

478```469```

479 470 

480これはコード バインディングでも機能します。プレフィックスを共有するすべてのコードをアンバインドすると、そのプレフィックスを単一キー バインディングとして使用できるようになります。471これはコード バインディングでも機能します。プレフィックスを共有するすべてのコードをアンバインドすると、そのプレフィックスを単一キー バインディングとして使用できるようになります。コード バインディングは任意のアクティブなコンテキストに存在し、そのプレフィックスを予約したままにするため、それを定義するコンテキストで各コードをアンバインドする必要があります。

472 

473デフォルトの `Ctrl+X` ファミリーは 2 つのコンテキストにまたがります。`Chat` では `ctrl+x ctrl+k` と `ctrl+x ctrl+e`、`Task` では `ctrl+x ctrl+b` です。`ctrl+x` 自体を単一キー バインディングとして再利用するには、すべてをアンバインドします。

481 474 

482```json theme={null}475```json theme={null}

483{476{

484 "bindings": [477 "bindings": [

478 {

479 "context": "Task",

480 "bindings": {

481 "ctrl+x ctrl+b": null

482 }

483 },

485 {484 {

486 "context": "Chat",485 "context": "Chat",

487 "bindings": {486 "bindings": {


546* ターミナルマルチプレクサの競合545* ターミナルマルチプレクサの競合

547* 同じコンテキスト内の重複バインディング546* 同じコンテキスト内の重複バインディング

548 547 

549`/doctor` を実行してキーバインディングの警告を確認します548Claude Code はファイルが読み込まれるときに警告を報告し、各警告をデバッグログに書き込みます。Claude Code を [`--debug`](/ja/cli-reference#cli-flags) で起動して詳細を確認してください

Details

209 デスクトップアプリ209 デスクトップアプリ

210</h3>210</h3>

211 211 

212デスクトップアプリは、`ANTHROPIC_BASE_URL` または `settings.json` ではなく、[管理者配布設定](https://claude.com/docs/cowork/3p/gateway)からゲートウェイルーティングを読み取ります。組織がそれを配布している場合、デスクトップアプリはゲートウェイを通じてルーティングされ、設定は不要です。そうでない場合は、ゲートウェイセッションのためにターミナル CLI または VS Code 拡張機能を使用してください。管理者は[組織ロールアウト](/ja/llm-gateway-rollout#distribute-through-managed-settings)で説明されているように設定を配布します。212デスクトップアプリは、`ANTHROPIC_BASE_URL` または `settings.json` ではなく、[管理者配布設定](https://claude.com/docs/third-party/claude-desktop/gateway)からゲートウェイルーティングを読み取ります。組織がそれを配布している場合、デスクトップアプリはゲートウェイを通じてルーティングされ、設定は不要です。そうでない場合は、ゲートウェイセッションのためにターミナル CLI または VS Code 拡張機能を使用してください。管理者は[組織ロールアウト](/ja/llm-gateway-rollout#distribute-through-managed-settings)で説明されているように設定を配布します。

213 213 

214デスクトップアプリが `Gateway was unreachable` を表示する場合、アプリは起動時に設定された基本 URL に到達できませんでした。URL とネットワークパスを上記の [curl テスト](#verify-the-connection)で確認してください。214デスクトップアプリが `Gateway was unreachable` を表示する場合、アプリは起動時に設定された基本 URL に到達できませんでした。URL とネットワークパスを上記の [curl テスト](#verify-the-connection)で確認してください。

215 215 


287 287 

288[Remote Control](/ja/remote-control) と[音声ディクテーション](/ja/voice-dictation)は両方とも claude.ai ID に依存します。Remote Control はライブセッションをアカウントとペアリングし、音声ディクテーションは claude.ai トランスクリプションエンドポイントに到達します。`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` がアクティブな間は利用できません。v2.1.196 以降では、`ANTHROPIC_BASE_URL` が Anthropic 以外のホストを指している場合、Remote Control も無効になるため、claude.ai でサインインするだけでは十分ではありません。288[Remote Control](/ja/remote-control) と[音声ディクテーション](/ja/voice-dictation)は両方とも claude.ai ID に依存します。Remote Control はライブセッションをアカウントとペアリングし、音声ディクテーションは claude.ai トランスクリプションエンドポイントに到達します。`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` がアクティブな間は利用できません。v2.1.196 以降では、`ANTHROPIC_BASE_URL` が Anthropic 以外のホストを指している場合、Remote Control も無効になるため、claude.ai でサインインするだけでは十分ではありません。

289 289 

290どちらかの機能を復元するには、claude.ai でログインし、チェックするゲートウェイ変数を設定解除してください。`/doctor` は設定解除する認証情報変数の名前を表示します290どちらかの機能を復元するには、claude.ai でログインし、チェックするゲートウェイ変数を設定解除してください。`claude doctor` の Remote Control セクションは設定解除する認証情報変数の名前を表示します

291 291 

292* 音声ディクテーション:ゲートウェイ認証情報を設定解除する292* 音声ディクテーション:ゲートウェイ認証情報を設定解除する

293* Remote Control:ゲートウェイ認証情報と `ANTHROPIC_BASE_URL` を設定解除する293* Remote Control:ゲートウェイ認証情報と `ANTHROPIC_BASE_URL` を設定解除する


393 クラウドプロバイダーをゲートウェイ経由でルーティングする393 クラウドプロバイダーをゲートウェイ経由でルーティングする

394</h3>394</h3>

395 395 

396これらの設定は Claude Code を `ANTHROPIC_BASE_URL` の代わりにプロバイダー固有の基本 URL 変数を通じてゲートウェイに指定します。Bedrock と Agent Platform ゲートウェイはそれらのプロバイダーのネイティブリクエスト形式を受け入れます。Foundry と AWS 上の Claude Platform ゲートウェイは Anthropic Messages 形式を受け入れ、どの基本 URL 変数がそれらに到達するかでのみ異なります。396これらの設定は Claude Code を `ANTHROPIC_BASE_URL` の代わりにプロバイダー固有の基本 URL 変数を通じてゲートウェイに指定します。Amazon Bedrock と Google Cloud の Agent Platform ゲートウェイはそれらのプロバイダーのネイティブリクエスト形式を受け入れます。Microsoft Foundry と AWS 上の Claude Platform ゲートウェイは Anthropic Messages 形式を受け入れ、どの基本 URL 変数がそれらに到達するかでのみ異なります。

397 397 

398ゲートウェイチームが Bedrock、Agent Platform、Foundry、または AWS 上の Claude Platform という名前を付けた場合のみ 1 つを使用します。上記の[検証リクエスト](#verify-the-connection)が JSON を返した場合、このセクションをスキップできます。398ゲートウェイチームが Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform という名前を付けた場合のみ 1 つを使用します。上記の[検証リクエスト](#verify-the-connection)が JSON を返した場合、このセクションをスキップできます。

399 399 

400ゲートウェイチームが名前を付けたプロバイダーのブロックを設定します。skip-auth 変数は Claude Code にプロバイダー認証情報でリクエストに署名しないよう指示します。ゲートウェイがそれらを保持しているため。ゲートウェイが独自のトークンが必要な場合、Foundry を除いて、ブロックの後に `ANTHROPIC_AUTH_TOKEN` を追加します。Foundry は示されているように `ANTHROPIC_FOUNDRY_API_KEY` を使用します。400ゲートウェイチームが名前を付けたプロバイダーのブロックを設定します。skip-auth 変数は Claude Code にプロバイダー認証情報でリクエストに署名しないよう指示します。ゲートウェイがそれらを保持しているため。ゲートウェイが独自のトークンが必要な場合、Foundry を除いて、ブロックの後に `ANTHROPIC_AUTH_TOKEN` を追加します。Microsoft Foundry は示されているように `ANTHROPIC_FOUNDRY_API_KEY` を使用します。{/* min-version: 2.1.203 */}Bearer トークンを期待する Microsoft Foundry ゲートウェイは、代わりに [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/ja/env-vars) を使用できます。これは両方が設定されている場合、`ANTHROPIC_FOUNDRY_API_KEY` より優先されます。`ANTHROPIC_FOUNDRY_AUTH_TOKEN` には Claude Code v2.1.203 以降が必要です。

401 401 

402<h4 id="amazon-bedrock">402<h4 id="amazon-bedrock">

403 Amazon Bedrock403 Amazon Bedrock


451 Microsoft Foundry451 Microsoft Foundry

452</h4>452</h4>

453 453 

454ゲートウェイの認証情報を `ANTHROPIC_FOUNDRY_API_KEY` に入れます。`x-api-key` ヘッダーとしてゲートウェイに送信されます。`CLAUDE_CODE_SKIP_FOUNDRY_AUTH` はここでは適用されませんAPI キーがないとFoundry クライアントはマシンを離れる前にすべてのリクエストに失敗します454ゲートウェイの認証情報を `ANTHROPIC_FOUNDRY_API_KEY` に入れます。`x-api-key` ヘッダーとしてゲートウェイに送信されます。{/* min-version: 2.1.203 */}Bearer トークンを期待するゲートウェイは、代わりに [`ANTHROPIC_FOUNDRY_AUTH_TOKEN`](/ja/env-vars) を使用できますClaude Code はその値を `Authorization: Bearer` ヘッダーとして送信し両方が設定されている場合、`ANTHROPIC_FOUNDRY_API_KEY` より優先されますClaude Code v2.1.203 以降が必要です。

455 

456独自の `Authorization` ヘッダーを挿入するゲートウェイの場合、`CLAUDE_CODE_SKIP_FOUNDRY_AUTH=1` を設定し、両方の認証情報変数を設定しないままにします。Claude Code はその後、Azure 認証情報なしでリクエストを送信し、たとえば `ANTHROPIC_CUSTOM_HEADERS` を通じて提供する `Authorization` ヘッダーを保持します。{/* min-version: 2.1.203 */}v2.1.203 より前では、API キーなしの `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` は Microsoft Foundry クライアントがリクエストを送信できないままにしました。

455 457 

456<Tabs>458<Tabs>

457 <Tab title="Bash または Zsh">459 <Tab title="Bash または Zsh">

Details

34 API フォーマット34 API フォーマット

35</h2>35</h2>

36 36 

37ゲートウェイは、Claude Code クライアントに対して以下の API フォーマットの少なくとも 1 つを公開する必要があります。Claude Code が使用するフォーマットは、クライアントの設定によって決定されます。以下の表の「選択者」列の変数は、Claude Code をそのフォーマットでゲートウェイに指定します。Agent Platform は Google Cloud の Claude エンドポイントで、以前は Vertex AI でした。その変数名は `VERTEX` のスペルを保持しています。37ゲートウェイは、Claude Code クライアントに対して以下の API フォーマットの少なくとも 1 つを公開する必要があります。Claude Code が使用するフォーマットは、クライアントの設定によって決定されます。以下の表の「選択者」列の変数は、Claude Code をそのフォーマットでゲートウェイに指定します。Google Cloud の Agent Platform は Google Cloud の Claude エンドポイントで、以前は Vertex AI でした。その変数名は `VERTEX` のスペルを保持しています。

38 38 

39| フォーマット | 選択者 | エンドポイント | 変更なしで転送 |39| フォーマット | 選択者 | エンドポイント | 変更なしで転送 |

40| :------------------------ | :--------------------------------------------------------- | :------------------------------------------------------------------- | :--------------------------------------------------------------------------------------- |40| :--------------------------------------- | :--------------------------------------------------------- | :------------------------------------------------------------------- | :--------------------------------------------------------------------------------------- |

41| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`、`/v1/messages/count_tokens`(オプション) | `anthropic-beta` および `anthropic-version` リクエストヘッダー |41| Anthropic Messages | `ANTHROPIC_BASE_URL` | `/v1/messages`、`/v1/messages/count_tokens`(オプション) | `anthropic-beta` および `anthropic-version` リクエストヘッダー |

42| Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` と `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`、`/model/{model}/invoke-with-response-stream` | `anthropic_beta` および `anthropic_version` リクエストボディフィールド |42| Amazon Bedrock InvokeModel | `ANTHROPIC_BEDROCK_BASE_URL` と `CLAUDE_CODE_USE_BEDROCK=1` | `/model/{model}/invoke`、`/model/{model}/invoke-with-response-stream` | `anthropic_beta` および `anthropic_version` リクエストボディフィールド |

43| Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` と `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`、`:streamRawPredict`、`count-tokens:rawPredict`(オプション) | `anthropic-beta` および `anthropic-version` リクエストヘッダー、および `anthropic_version` リクエストボディフィールド |43| Google Cloud の Agent Platform rawPredict | `ANTHROPIC_VERTEX_BASE_URL` と `CLAUDE_CODE_USE_VERTEX=1` | `:rawPredict`、`:streamRawPredict`、`count-tokens:rawPredict`(オプション) | `anthropic-beta` および `anthropic-version` リクエストヘッダー、および `anthropic_version` リクエストボディフィールド |

44 44 

45<h3 id="foundry-and-claude-platform-on-aws">45<h3 id="foundry-and-claude-platform-on-aws">

46 Foundry および AWS 上の Claude Platform46 Foundry および AWS 上の Claude Platform


52 オプションエンドポイントとスタートアップトラフィック52 オプションエンドポイントとスタートアップトラフィック

53</h3>53</h3>

54 54 

55トークンカウントエンドポイントは唯一のオプションです。存在しない場合、Claude Code はコンテキスト使用量をローカルで推定します。推論リクエストは `/v1/messages?beta=true` に POST されるため、完全な URL ではなくパスで一致させてください。Agent Platform メソッドのサフィックスは、`/projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict` のようにパブリッシャーモデルパスに付加されます。55トークンカウントエンドポイントは唯一のオプションです。存在しない場合、Claude Code はコンテキスト使用量をローカルで推定します。推論リクエストは `/v1/messages?beta=true` に POST されるため、完全な URL ではなくパスで一致させてください。Google Cloud の Agent Platform メソッドのサフィックスは、`/projects/{project}/locations/{location}/publishers/anthropic/models/{model}:streamRawPredict` のようにパブリッシャーモデルパスに付加されます。

56 56 

57ゲートウェイは、拒否しても何も壊さないベストエフォート型のスタートアップトラフィックも受け取ります:`HEAD /` 接続プローブ、および Bedrock フォーマットゲートウェイの場合は `GET /inference-profiles?type=SYSTEM_DEFINED` リクエスト。57ゲートウェイは、拒否しても何も壊さないベストエフォート型のスタートアップトラフィックも受け取ります:`HEAD /` 接続プローブ、および Amazon Bedrock フォーマットゲートウェイの場合は `GET /inference-profiles?type=SYSTEM_DEFINED` リクエスト。

58 58 

59<h3 id="streaming">59<h3 id="streaming">

60 ストリーミング60 ストリーミング


68 68 

69クライアントが使用するフォーマットは、ゲートウェイが受け取るものを決定します。一般的な障害モードは、クライアントがゲートウェイに送信するフォーマットと、その背後にあるアップストリームプロバイダーが受け入れるフォーマット間の不一致です。69クライアントが使用するフォーマットは、ゲートウェイが受け取るものを決定します。一般的な障害モードは、クライアントがゲートウェイに送信するフォーマットと、その背後にあるアップストリームプロバイダーが受け入れるフォーマット間の不一致です。

70 70 

71* クライアントが Bedrock または Agent Platform フォーマットを使用する場合、Claude Code はそれらのプロバイダーが受け入れる完全な機能セットのサブセットのみを送信します71* クライアントが Amazon Bedrock または Google Cloud の Agent Platform フォーマットを使用する場合、Claude Code はそれらのプロバイダーが受け入れる完全な機能セットのサブセットのみを送信します

72* クライアントが Anthropic Messages フォーマットを使用する場合、ゲートウェイが Bedrock または Agent Platform アップストリームに転送する場合でも、Claude Code は完全なセットを送信します72* クライアントが Anthropic Messages フォーマットを使用する場合、ゲートウェイが Amazon Bedrock または Google Cloud の Agent Platform アップストリームに転送する場合でも、Claude Code は完全なセットを送信します

73 73 

74その違いを橋渡けするのはゲートウェイの仕事です。[機能パススルー](#feature-pass-through)では、転送されない場合に何が壊れるかについて説明しています。74その違いを橋渡けするのはゲートウェイの仕事です。[機能パススルー](#feature-pass-through)では、転送されない場合に何が壊れるかについて説明しています。

75 75 


82| ヘッダー | 説明 |82| ヘッダー | 説明 |

83| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |83| :------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

84| `Authorization`、`x-api-key` | 開発者のゲートウェイクレデンシャル。設定した[クレデンシャル変数](/ja/llm-gateway-connect#set-the-credential-variable)に応じて、1 つまたは両方のヘッダーに含まれます |84| `Authorization`、`x-api-key` | 開発者のゲートウェイクレデンシャル。設定した[クレデンシャル変数](/ja/llm-gateway-connect#set-the-credential-variable)に応じて、1 つまたは両方のヘッダーに含まれます |

85| `anthropic-version` | API バージョン。現在は `2023-06-01`。Bedrock および Agent Platform フォーマットリクエストは、`anthropic_version` ボディフィールドも含みます。その値はこのヘッダーの値ではなく、プロバイダー方言文字列です |85| `anthropic-version` | API バージョン。現在は `2023-06-01`。Amazon Bedrock および Google Cloud の Agent Platform フォーマットリクエストは、`anthropic_version` ボディフィールドも含みます。その値はこのヘッダーの値ではなく、プロバイダー方言文字列です |

86| `anthropic-beta` | リクエストの機能値をカンマで区切ったもの。ヘッダーをそのまま転送してください。個別の値をホワイトリストに登録しないでください。セットは Claude Code リリースで変わるためです。開発者が claude.ai ログインで認証する場合(`ANTHROPIC_BASE_URL` がゲートウェイクレデンシャル変数なしで設定されている場合に可能)、このヘッダーはアップストリームが必要とする OAuth 機能も含み、それを削除するとそれらのリクエストは `401` で失敗します |86| `anthropic-beta` | リクエストの機能値をカンマで区切ったもの。ヘッダーをそのまま転送してください。個別の値をホワイトリストに登録しないでください。セットは Claude Code リリースで変わるためです。開発者が claude.ai ログインで認証する場合(`ANTHROPIC_BASE_URL` がゲートウェイクレデンシャル変数なしで設定されている場合に可能)、このヘッダーはアップストリームが必要とする OAuth 機能も含み、それを削除するとそれらのリクエストは `401` で失敗します |

87| `x-claude-code-session-id` | 現在の Claude Code セッションの一意の識別子。リクエストボディを解析せずに 1 つのセッションからのすべてのリクエストを集約するために使用してください |87| `x-claude-code-session-id` | 現在の Claude Code セッションの一意の識別子。リクエストボディを解析せずに 1 つのセッションからのすべてのリクエストを集約するために使用してください |

88| `x-claude-code-agent-id` | リクエストを発行した[サブエージェント](/ja/sub-agents)の識別子。セッション内で Claude Code が生成したエージェントからのリクエストにのみ存在します。セッション ID と共に使用して、並列エージェントにコストを属性付けしてください |88| `x-claude-code-agent-id` | リクエストを発行した[サブエージェント](/ja/sub-agents)の識別子。セッション内で Claude Code が生成したエージェントからのリクエストにのみ存在します。セッション ID と共に使用して、並列エージェントにコストを属性付けしてください |


100 100 

101Anthropic フォーマットアップストリームに転送する場合、今日見ている値をホワイトリストに登録するのではなく、`anthropic-*` リクエストヘッダーとリクエストボディフィールドを変更なしで渡してください。観察されたリストに固定されたゲートウェイは、次の機能のヘッダーまたはフィールドを削除し、それを導入するリリースで壊します。101Anthropic フォーマットアップストリームに転送する場合、今日見ている値をホワイトリストに登録するのではなく、`anthropic-*` リクエストヘッダーとリクエストボディフィールドを変更なしで渡してください。観察されたリストに固定されたゲートウェイは、次の機能のヘッダーまたはフィールドを削除し、それを導入するリリースで壊します。

102 102 

103例外は Bedrock や Agent Platform などの非 Anthropic アップストリームです。スキーマの違いを橋渡けするのはゲートウェイの仕事です。[機能パススルー](#feature-pass-through)を参照してください。103例外は Amazon Bedrock や Google Cloud の Agent Platform などの非 Anthropic アップストリームです。スキーマの違いを橋渡けするのはゲートウェイの仕事です。[機能パススルー](#feature-pass-through)を参照してください。

104 104 

105<h2 id="system-prompt-attribution-block">105<h2 id="system-prompt-attribution-block">

106 システムプロンプト属性ブロック106 システムプロンプト属性ブロック


129きめ細かいツールストリーミングは直接接続デフォルトの 1 つです。リクエストがカスタムベース URL を通じてルーティングされるときはデフォルトでオフになり、開発者が [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/ja/env-vars) を設定するとゲートウェイはそれを受け取ります。129きめ細かいツールストリーミングは直接接続デフォルトの 1 つです。リクエストがカスタムベース URL を通じてルーティングされるときはデフォルトでオフになり、開発者が [`CLAUDE_CODE_ENABLE_FINE_GRAINED_TOOL_STREAMING=1`](/ja/env-vars) を設定するとゲートウェイはそれを受け取ります。

130 130 

131| 機能 | ヘッダーとボディペア | 壊れた場合の症状 | 修復 |131| 機能 | ヘッダーとボディペア | 壊れた場合の症状 | 修復 |

132| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------- |132| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------- |

133| [適応的推論](/ja/model-config#adjust-effort-level) | ベータヘッダーなし。Claude Code は Claude 4.6 以降に `thinking: {"type": "adaptive"}` を送信し、ゲートウェイエイリアスなど認識しないモデル名を、フィールドを受け取る現在のモデルとして扱います | `thinking` フィールドまたは `adaptive` タグを命名する `400`。アップストリームモデルビルドがそれを受け入れない場合 | アップストリームをアップグレードしてください。Opus 4.6 および Sonnet 4.6 では、開発者は代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` を設定できます |133| [適応的推論](/ja/model-config#adjust-effort-level) | ベータヘッダーなし。Claude Code は Claude 4.6 以降に `thinking: {"type": "adaptive"}` を送信し、ゲートウェイエイリアスなど認識しないモデル名を、フィールドを受け取る現在のモデルとして扱います | `thinking` フィールドまたは `adaptive` タグを命名する `400`。アップストリームモデルビルドがそれを受け入れない場合 | アップストリームをアップグレードしてください。Opus 4.6 および Sonnet 4.6 では、開発者は代わりに `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` を設定できます |

134| [コンテキスト管理](https://platform.claude.com/docs/en/build-with-claude/context-management) | コンテキスト管理ベータヘッダーは `context_management` ボディフィールドと組み合わされます | `Extra inputs are not permitted` を含む `400`。ゲートウェイが Anthropic フォーマットリクエストを受け入れるが Bedrock に転送する場合に一般的です | 両方を転送するか、[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ja/env-vars) |134| [コンテキスト管理](https://platform.claude.com/docs/en/build-with-claude/context-management) | コンテキスト管理ベータヘッダーは `context_management` ボディフィールドと組み合わされます | `Extra inputs are not permitted` を含む `400`。ゲートウェイが Anthropic フォーマットリクエストを受け入れるが Bedrock に転送する場合に一般的です | 両方を転送するか、[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`](/ja/env-vars) |

135| [拡張コンテキスト](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window)および[インターリーブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | ベータヘッダーのみ。ボディフィールドなし | ヘッダーが削除されると静かに利用不可。アップストリームは機能リクエストを見ません | `anthropic-beta` をそのまま転送してください |135| [拡張コンテキスト](https://platform.claude.com/docs/en/build-with-claude/context-windows#1m-token-context-window)および[インターリーブ思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking#interleaved-thinking) | ベータヘッダーのみ。ボディフィールドなし | ヘッダーが削除されると静かに利用不可。アップストリームは機能リクエストを見ません | `anthropic-beta` をそのまま転送してください |

136| ベータ[ツールフィールド](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | ツール関連ベータヘッダーは `strict` および `defer_loading` などのツールスキーマフィールドと組み合わされます | ボディがヘッダーなしで渡される場合、認識されないツールスキーマフィールドを命名する `400` | 両方を転送するか、`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |136| ベータ[ツールフィールド](https://platform.claude.com/docs/en/agents-and-tools/tool-use/overview) | ツール関連ベータヘッダーは `strict` および `defer_loading` などのツールスキーマフィールドと組み合わされます | ボディがヘッダーなしで渡される場合、認識されないツールスキーマフィールドを命名する `400` | 両方を転送するか、`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |

137| [努力](https://platform.claude.com/docs/en/build-with-claude/effort)および[構造化出力](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | `output_config` ボディフィールドは努力、構造化出力フォーマット、およびタスク予算設定を含みます。各々は独自のベータヘッダーと組み合わされます | `output_config` を命名する `400`。多くの場合 `Extra inputs are not permitted`。Bedrock および Agent Platform アップストリーム上 | フィールドとそのヘッダーを一緒に転送してください |137| [努力](https://platform.claude.com/docs/en/build-with-claude/effort)および[構造化出力](https://platform.claude.com/docs/en/build-with-claude/structured-outputs) | `output_config` ボディフィールドは努力、構造化出力フォーマット、およびタスク予算設定を含みます。各々は独自のベータヘッダーと組み合わされます | `output_config` を命名する `400`。多くの場合 `Extra inputs are not permitted`。Amazon Bedrock および Google Cloud の Agent Platform アップストリーム上 | フィールドとそのヘッダーを一緒に転送してください |

138| [トークンカウント](https://platform.claude.com/docs/en/build-with-claude/token-counting) | ベータペアリングなし。`count_tokens` エンドポイントを使用 | Claude Code はコンテキスト使用量をローカルで推定するようにフォールバックします | 正確なカウントが必要な場合、エンドポイントを公開してください |138| [トークンカウント](https://platform.claude.com/docs/en/build-with-claude/token-counting) | ベータペアリングなし。`count_tokens` エンドポイントを使用 | Claude Code はコンテキスト使用量をローカルで推定するようにフォールバックします | 正確なカウントが必要な場合、エンドポイントを公開してください |

139 139 

140`ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` [変数](/ja/model-config)は、プロバイダー設定でのみモデル機能を宣言します:`CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_VERTEX`、`CLAUDE_CODE_USE_FOUNDRY`、および [`CLAUDE_CODE_USE_MANTLE`](/ja/amazon-bedrock#use-the-mantle-endpoint)。`ANTHROPIC_BASE_URL` ゲートウェイの背後では効果がありません。140`ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES` [変数](/ja/model-config)は、プロバイダー設定でのみモデル機能を宣言します:`CLAUDE_CODE_USE_BEDROCK`、`CLAUDE_CODE_USE_VERTEX`、`CLAUDE_CODE_USE_FOUNDRY`、および [`CLAUDE_CODE_USE_MANTLE`](/ja/amazon-bedrock#use-the-mantle-endpoint)。`ANTHROPIC_BASE_URL` ゲートウェイの背後では効果がありません。

Details

160claude -p "Reply with one word: connected"160claude -p "Reply with one word: connected"

161```161```

162 162 

163**チェックポイント**:プロンプトはレスポンスを返し、リクエストはゲートウェイのログに `/v1/messages` パスへの `POST` として状態 `200` で表示されます。Claude Code は `?beta=true` などのクエリ文字列を追加するため、完全な URL ではなくパスで一致させます。 2 つの失敗メッセージは異なる方向を指します。163**チェックポイント**:プロンプトはレスポンスを返し、リクエストはゲートウェイのログに `/v1/messages` パスへの `POST` として状態 `200` で表示されます。Claude Code は `?beta=true` などのクエリ文字列を追加するため、完全な URL ではなくパスで一致させます。2 つの失敗メッセージは異なる方向を指します。

164 164 

165* `Not logged in`:ゲートウェイログをチェックして 2 つの原因を区別します。空の場合、認証情報がセッションに到達せず、リクエストがマシンを離れません。テストしているシェルでエクスポートを再実行してください。`401` 本文に `x-api-key` を示す拒否されたリクエストが表示される場合、ゲートウェイはそのヘッダーでキーを期待しています。`ANTHROPIC_API_KEY` に切り替えてください165* `Not logged in`:ゲートウェイログをチェックして 2 つの原因を区別します。空の場合、認証情報がセッションに到達せず、リクエストがマシンを離れません。テストしているシェルでエクスポートを再実行してください。`401` 本文に `x-api-key` を示す拒否されたリクエストが表示される場合、ゲートウェイはそのヘッダーでキーを期待しています。`ANTHROPIC_API_KEY` に切り替えてください

166* `Failed to authenticate. API Error: 401` は認証情報が送信され、拒否されたことを意味し、ゲートウェイログはどこかを示します。`api.anthropic.com` またはプロバイダーのエンドポイントに名前を付ける `401` は、ゲートウェイがアップストリームに到達したが、保持するプロバイダー認証情報が拒否されたことを意味するため、開発者キーは機能し、ゲートウェイが保持するプロバイダー認証情報が間違っているか、プレースホルダーです166* `Failed to authenticate. API Error: 401` は認証情報が送信され、拒否されたことを意味し、ゲートウェイログはどこかを示します。`api.anthropic.com` またはプロバイダーのエンドポイントに名前を付ける `401` は、ゲートウェイがアップストリームに到達したが、保持するプロバイダー認証情報が拒否されたことを意味するため、開発者キーは機能し、ゲートウェイが保持するプロバイダー認証情報が間違っているか、プレースホルダーです


180どのパスを選択するかに関わらず、同じ変数セットが適用されます。ほとんどのロールアウトは `ANTHROPIC_BASE_URL` と認証情報のみが必要です。ゲートウェイセットアップが必要とする場合は、条件付き行を含めます。180どのパスを選択するかに関わらず、同じ変数セットが適用されます。ほとんどのロールアウトは `ANTHROPIC_BASE_URL` と認証情報のみが必要です。ゲートウェイセットアップが必要とする場合は、条件付き行を含めます。

181 181 

182| 変数または設定 | 機能 | 含める場合 |182| 変数または設定 | 機能 | 含める場合 |

183| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |183| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

184| `ANTHROPIC_BASE_URL` | Claude Code の API リクエストを `api.anthropic.com` の代わりにゲートウェイに送信します | 常に |184| `ANTHROPIC_BASE_URL` | Claude Code の API リクエストを `api.anthropic.com` の代わりにゲートウェイに送信します | 常に |

185| `apiKeyHelper`、または `ANTHROPIC_AUTH_TOKEN` または `ANTHROPIC_API_KEY` の認証情報 | ゲートウェイへの各リクエストを認証します。ヘルパーはキーを取得するコマンドを実行します。変数は静的キーを保持し、`Authorization: Bearer` および `x-api-key` としてそれぞれ送信されます | 常に。3 つのうち 1 つ |185| `apiKeyHelper`、または `ANTHROPIC_AUTH_TOKEN` または `ANTHROPIC_API_KEY` の認証情報 | ゲートウェイへの各リクエストを認証します。ヘルパーはキーを取得するコマンドを実行します。変数は静的キーを保持し、`Authorization: Bearer` および `x-api-key` としてそれぞれ送信されます | 常に。3 つのうち 1 つ |

186| `ANTHROPIC_CUSTOM_HEADERS` | すべての API リクエストに追加の HTTP ヘッダーを追加します | ゲートウェイがすべてのリクエストでテナントまたはルーティングヘッダーを必要とする場合 |186| `ANTHROPIC_CUSTOM_HEADERS` | すべての API リクエストに追加の HTTP ヘッダーを追加します | ゲートウェイがすべてのリクエストでテナントまたはルーティングヘッダーを必要とする場合 |

187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 起動時にゲートウェイの `/v1/models` をクエリし、返された名前を `/model` ピッカーに追加します | ゲートウェイが `/v1/models` を提供し、開発者のピッカーをそこから入力したい場合 |187| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | 起動時にゲートウェイの `/v1/models` をクエリし、返された名前を `/model` ピッカーに追加します | ゲートウェイが `/v1/models` を提供し、開発者のピッカーをそこから入力したい場合 |

188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Claude Code がプリリリース機能ヘッダーと本文フィールドを送信するのを停止します | ゲートウェイが Bedrock または Agent Platform アップストリームに転送し、ベータフィールドを拒否する場合。[ゲートウェイ要件](#gateway-requirements)を参照してください |188| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` | Claude Code がプリリリース機能ヘッダーと本文フィールドを送信するのを停止します | ゲートウェイが Amazon Bedrock または Google Cloud の Agent Platform アップストリームに転送し、ベータフィールドを拒否する場合。[ゲートウェイ要件](#gateway-requirements)を参照してください |

189| `ANTHROPIC_MODEL` または [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/ja/model-config) | Claude Code がメインセッションとバックグラウンドトラフィックに要求するモデル名を設定します | ゲートウェイが Claude Code のデフォルトと一致しないモデル名をルーティングするか、[バックグラウンド機能](/ja/costs#background-token-usage)を別のモデルにルーティングする場合。オーバーライド名と Claude Code がオーバーライドが設定されていないときにリクエストする組み込みモデル ID の両方をゲートウェイでルーティングします。一部のバックグラウンドサブコールはオーバーライドに関わらず組み込み ID をリクエストできるため。[モデル設定](/ja/model-config)は各セッション部分が使用するモデルをカバーしています |189| `ANTHROPIC_MODEL` または [`ANTHROPIC_DEFAULT_HAIKU_MODEL`](/ja/model-config) | Claude Code がメインセッションとバックグラウンドトラフィックに要求するモデル名を設定します | ゲートウェイが Claude Code のデフォルトと一致しないモデル名をルーティングするか、[バックグラウンド機能](/ja/costs#background-token-usage)を別のモデルにルーティングする場合。オーバーライド名と Claude Code がオーバーライドが設定されていないときにリクエストする組み込みモデル ID の両方をゲートウェイでルーティングします。一部のバックグラウンドサブコールはオーバーライドに関わらず組み込み ID をリクエストできるため。[モデル設定](/ja/model-config)は各セッション部分が使用するモデルをカバーしています |

190| `ANTHROPIC_BEDROCK_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、`ANTHROPIC_FOUNDRY_BASE_URL`、または `ANTHROPIC_AWS_BASE_URL` と [そのプロバイダーの変数](/ja/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) | Claude Code をプロバイダー固有のベース URL を通じてゲートウェイに指します。Bedrock と Agent Platform はそれらのプロバイダーのネイティブリクエスト形式にも切り替わります | ゲートウェイが Bedrock、Agent Platform、Foundry、または AWS 上の Claude Platform の前にある場合。[API 形式](/ja/llm-gateway-protocol#api-formats)を参照してください |190| `ANTHROPIC_BEDROCK_BASE_URL`、`ANTHROPIC_VERTEX_BASE_URL`、`ANTHROPIC_FOUNDRY_BASE_URL`、または `ANTHROPIC_AWS_BASE_URL` と [そのプロバイダーの変数](/ja/llm-gateway-connect#route-to-a-cloud-provider-through-a-gateway) | Claude Code をプロバイダー固有のベース URL を通じてゲートウェイに指します。Amazon Bedrock と Google Cloud の Agent Platform はそれらのプロバイダーのネイティブリクエスト形式にも切り替わります | ゲートウェイが Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、または AWS 上の Claude Platform の前にある場合。[API 形式](/ja/llm-gateway-protocol#api-formats)を参照してください |

191 191 

192<h4 id="distribute-through-managed-settings">192<h4 id="distribute-through-managed-settings">

193 マネージド設定を通じて配布する193 マネージド設定を通じて配布する


214 214 

215一部の環境には個別の配信が必要です。215一部の環境には個別の配信が必要です。

216 216 

217* デスクトップアプリはゲートウェイルーティングをマネージド設定ファイルの MDM 配信サードパーティ推論設定からのみ読み取ります。デスクトップセッションもゲートウェイを通じてルーティングするように、マネージド設定と一緒にそのファイルをデプロイします。[デスクトップサードパーティ設定ドキュメント](https://claude.com/docs/cowork/3p/configuration)と [デスクトップゲートウェイドキュメント](https://claude.com/docs/cowork/3p/gateway)を参照してください217* デスクトップアプリはゲートウェイルーティングをマネージド設定ファイルの MDM 配信サードパーティ推論設定からのみ読み取ります。デスクトップセッションもゲートウェイを通じてルーティングするように、マネージド設定と一緒にそのファイルをデプロイします。[デスクトップサードパーティ設定ドキュメント](https://claude.com/docs/third-party/claude-desktop/configuration)と [デスクトップゲートウェイドキュメント](https://claude.com/docs/third-party/claude-desktop/gateway)を参照してください

218* CI ランナーは [ランナーの環境](/ja/llm-gateway-connect#configure-each-surface)で `ANTHROPIC_BASE_URL` と認証情報を設定する必要があります218* CI ランナーは [ランナーの環境](/ja/llm-gateway-connect#configure-each-surface)で `ANTHROPIC_BASE_URL` と認証情報を設定する必要があります

219* マネージド Windows マシン上の WSL は、[`wslInheritsWindowsSettings`](/ja/settings#available-settings) が `true` の場合にのみ Windows マネージド設定を読み取ります219* マネージド Windows マシン上の WSL は、[`wslInheritsWindowsSettings`](/ja/settings#available-settings) が `true` の場合にのみ Windows マネージド設定を読み取ります

220 220 

mcp.md +33 −16

Details

85 85 

86MCP サーバーを `.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` という名前を使用しているため、サーバードキュメントからコピーされた設定は変更なしで機能します。

87 87 

88`url` を持つが `type` を持たない JSON エントリは設定エラーです。Claude Code は `type` を持たないエントリを stdio サーバーとして読み取るためです。Claude Code はそのサーバーをスキップし、`MCP server "<name>" has a "url" but no "type"; add "type": "http" (or "sse" / "ws") to this entry` と報告します。v2.1.202 より前は、Claude Code はこの設定ミスを `command: expected string, received undefined` と報告していました。

89 

88<h3 id="option-2-add-a-remote-sse-server">90<h3 id="option-2-add-a-remote-sse-server">

89 オプション 2:リモート SSE サーバーを追加する91 オプション 2:リモート SSE サーバーを追加する

90</h3>92</h3>


113 115 

114Claude Code は、生成されたサーバーの環境に `CLAUDE_PROJECT_DIR` を設定して、プロジェクトルートを指定するため、サーバーは作業ディレクトリに依存することなくプロジェクト相対パスを解決できます。これは hooks が `CLAUDE_PROJECT_DIR` 変数で受け取るのと同じディレクトリです。サーバープロセス内から読み取ります。例えば、Node では `process.env.CLAUDE_PROJECT_DIR`、Python では `os.environ["CLAUDE_PROJECT_DIR"]` です。116Claude Code は、生成されたサーバーの環境に `CLAUDE_PROJECT_DIR` を設定して、プロジェクトルートを指定するため、サーバーは作業ディレクトリに依存することなくプロジェクト相対パスを解決できます。これは hooks が `CLAUDE_PROJECT_DIR` 変数で受け取るのと同じディレクトリです。サーバープロセス内から読み取ります。例えば、Node では `process.env.CLAUDE_PROJECT_DIR`、Python では `os.environ["CLAUDE_PROJECT_DIR"]` です。

115 117 

116サーバーは MCP `roots/list` リクエストを呼び出すこともでき、Claude Code が起動されたディレクトリを返します118`CLAUDE_PROJECT_DIR` は安定したプロジェクトルートであり、セッション中に作業ディレクトリを追加または削除しても変わりません。ファイルシステムアクセスを許可されたディレクトリのセットに制限するサーバーは、代わりに MCP `roots/list` リクエストを実装する必要があります。Claude Code は `roots/list` にセッションの起動ディレクトリと、`--add-dir`、`/add-dir`、または `additionalDirectories` 設定で付与した [追加の作業ディレクトリ](/ja/permissions#working-directories) をすべて返します。Claude Code は、そのセットが変わるときに `notifications/roots/list_changed` を送信しますv2.1.203 より前は、`roots/list` は起動ディレクトリのみを返し、Claude Code は `notifications/roots/list_changed` を送信していませんでした。

117 119 

118この変数はサーバーの環境に設定され、Claude Code 自体の環境には設定されないため、プロジェクトスコープまたはユーザースコープの `.mcp.json` `command` または `args` で `${VAR}` 展開を使用して参照するには、`${CLAUDE_PROJECT_DIR:-.}` などのデフォルトが必要です。プラグイン提供の MCP 設定は `${CLAUDE_PROJECT_DIR}` を直接置換し、デフォルトは必要ありません。120この変数はサーバーの環境に設定され、Claude Code 自体の環境には設定されないため、プロジェクトスコープまたはユーザースコープの `.mcp.json` `command` または `args` で `${VAR}` 展開を使用して参照するには、`${CLAUDE_PROJECT_DIR:-.}` などのデフォルトが必要です。プラグイン提供の MCP 設定は `${CLAUDE_PROJECT_DIR}` を直接置換し、デフォルトは必要ありません。

119 121 


191 193 

192`/mcp` パネルは、接続されている各サーバーの横にツール数を表示し、ツール機能をアドバタイズしているが、ツールを公開していないサーバーにフラグを立てます。194`/mcp` パネルは、接続されている各サーバーの横にツール数を表示し、ツール機能をアドバタイズしているが、ツールを公開していないサーバーにフラグを立てます。

193 195 

194リクエストがまだバックグラウンドで接続中のサーバーからのツールを必要とする場合、Claude はそのサーバーが接続されるまで待機してから続行します。デフォルトで有効になっている [ツール検索](#scale-with-mcp-tool-search) を使用すると、待機は `ToolSearch` 呼び出し内で発生します。Vertex AI、カスタム `ANTHROPIC_BASE_URL`、または `ENABLE_TOOL_SEARCH=false` などのツール検索がない設定では、Claude は代わりに `WaitForMcpServers` ツールを使用します。196リクエストがまだバックグラウンドで接続中のサーバーからのツールを必要とする場合、Claude はそのサーバーが接続されるまで待機してから続行します。デフォルトで有効になっている [ツール検索](#scale-with-mcp-tool-search) を使用すると、待機は `ToolSearch` 呼び出し内で発生します。Google Cloud の Agent Platform、カスタム `ANTHROPIC_BASE_URL`、または `ENABLE_TOOL_SEARCH=false` などのツール検索がない設定では、Claude は代わりに `WaitForMcpServers` ツールを使用します。

197 

198一部のサーバー名は Claude Code の組み込みサーバー用に予約されています:`workspace`、`claude-in-chrome`、`computer-use`、`Claude Preview`、`Claude Browser`。設定がこれらの予約名のいずれかでサーバーを定義している場合、Claude Code はロード時にそれをスキップし、名前を変更するよう求める警告を表示します。`claude mcp add` は予約名をエラーで拒否します。

195 199 

196サーバー名 `workspace` は内部使用のために予約されています。設定がその名前のサーバーを定義している場合、Claude Code はロード時にそれをスキップし名前を変更するよう求める警告を表示します200`Claude Preview``Claude Browser` は両方とも[Claude Code デスクトップアプリのプレビューペイン](/ja/desktop#preview-your-app) が使用する組み込みサーバーに名前を付けます。v2.1.205 より前は`Claude Browser` は予約されていなかったため、ユーザーが設定したサーバーはその名前で登録できました

197 201 

198<h3 id="dynamic-tool-updates">202<h3 id="dynamic-tool-updates">

199 動的ツール更新203 動的ツール更新


209 213 

210同じバックオフは、HTTP または SSE サーバーが起動時に初期接続に失敗した場合にも適用されます。v2.1.121 以降、Claude Code は 5xx レスポンス、接続拒否、タイムアウトなどの一時的なエラーで初期接続を最大 3 回再試行し、それでも接続できない場合はサーバーを失敗としてマークします。認証エラーと見つからないエラーは、解決するために設定変更が必要なため、再試行されません。214同じバックオフは、HTTP または SSE サーバーが起動時に初期接続に失敗した場合にも適用されます。v2.1.121 以降、Claude Code は 5xx レスポンス、接続拒否、タイムアウトなどの一時的なエラーで初期接続を最大 3 回再試行し、それでも接続できない場合はサーバーを失敗としてマークします。認証エラーと見つからないエラーは、解決するために設定変更が必要なため、再試行されません。

211 215 

216設定されたサーバーが接続に失敗した場合、Claude Code は Claude にどのサーバーが失敗したかとその接続エラーを伝えます。これは、マッチするツールが見つからない `ToolSearch` 結果を含みます。そのため、Claude は応答で接続失敗を報告します。[ツール検索](#scale-with-mcp-tool-search) が必要です。これはデフォルトで有効になっています。カスタム `ANTHROPIC_BASE_URL`、`ENABLE_TOOL_SEARCH=false`、または Haiku モデルなどのツール検索がない設定、および Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では、Claude Code は失敗したサーバー接続を Claude に報告しません。v2.1.205 より前は、Claude Code は接続エラーを Claude に渡さず、Claude は失敗したサーバーのツールが設定されていないかのように応答できました。

217 

212v2.1.191 以降、接続成功後に実行される機能検出リクエスト(`tools/list`、`prompts/list`、`resources/list` など)も、一時的なネットワークおよびサーバーエラーを短いバックオフで最大 3 回再試行します。認証エラー、4xx レスポンス、リクエストタイムアウトは再試行されません。218v2.1.191 以降、接続成功後に実行される機能検出リクエスト(`tools/list`、`prompts/list`、`resources/list` など)も、一時的なネットワークおよびサーバーエラーを短いバックオフで最大 3 回再試行します。認証エラー、4xx レスポンス、リクエストタイムアウトは再試行されません。

213 219 

214<h3 id="push-messages-with-channels">220<h3 id="push-messages-with-channels">


220<Tip>226<Tip>

221 ヒント:227 ヒント:

222 228 

223 * `--scope` フラグを使用して、設定が保存される場所を指定します:229 * `-s` または `--scope` フラグを使用して、設定が保存される場所を指定します:

224 * `local`(デフォルト):現在のプロジェクトでのみ利用可能。古いバージョンではこのスコープを `project` と呼んでいました230 * `local`(デフォルト):現在のプロジェクトでのみ利用可能。古いバージョンではこのスコープを `project` と呼んでいました

225 * `project`:`.mcp.json` ファイルを通じてプロジェクト内のすべてのユーザーと共有231 * `project`:`.mcp.json` ファイルを通じてプロジェクト内のすべてのユーザーと共有

226 * `user`:すべてのプロジェクト全体で利用可能。古いバージョンではこのスコープを `global` と呼んでいました232 * `user`:すべてのプロジェクト全体で利用可能。古いバージョンではこのスコープを `global` と呼んでいました

227 * `--env` フラグで環境変数を設定します(例:`--env KEY=value`)233 * `-e` または `--env` フラグで環境変数を設定します(例:`-e KEY=value`)

234 * `--transport` と `--header` フラグは `-t` と `-H` の短い形式も受け入れます

228 * `MCP_TIMEOUT` 環境変数を使用して MCP サーバーのスタートアップタイムアウトを設定します(例:`MCP_TIMEOUT=10000 claude` は 10 秒のタイムアウトを設定します)235 * `MCP_TIMEOUT` 環境変数を使用して MCP サーバーのスタートアップタイムアウトを設定します(例:`MCP_TIMEOUT=10000 claude` は 10 秒のタイムアウトを設定します)

229 * サーバーごとのツール実行タイムアウトを設定するには、そのサーバーの `.mcp.json` エントリに `timeout` フィールドをミリ秒単位で追加します。例えば、10 分の場合は `"timeout": 600000` です。これはそのサーバーのみの `MCP_TOOL_TIMEOUT` 環境変数をオーバーライドします236 * サーバーごとのツール実行タイムアウトを設定するには、そのサーバーの `.mcp.json` エントリにミリ秒単位で `timeout` フィールドを追加します。例えば、10 分の場合は `"timeout": 600000` です。これはそのサーバーのみの `MCP_TOOL_TIMEOUT` 環境変数をオーバーライドします

230 * Claude Code は MCP ツール出力が 10,000 トークンを超えると警告を表示します。この制限を増やすには、`MAX_MCP_OUTPUT_TOKENS` 環境変数を設定します(例:`MAX_MCP_OUTPUT_TOKENS=50000`)237 * Claude Code は MCP ツール出力が 10,000 トークンを超えると警告を表示します。この制限を増やすには、`MAX_MCP_OUTPUT_TOKENS` 環境変数を設定します(例:`MAX_MCP_OUTPUT_TOKENS=50000`)

231 * `/mcp` を使用して、OAuth 2.0 認証が必要なリモートサーバーで認証します238 * `/mcp` を使用して、OAuth 2.0 認証が必要なリモートサーバーで認証します

232</Tip>239</Tip>

233 240 

234サーバーごとの `timeout` はツール呼び出しごとのハードウォールクロック制限であり、サーバーからの進捗通知はそれを延長しません。1000 未満の値は無視され、`MCP_TOOL_TIMEOUT` にフォールスルーするか、その変数が設定されていない場合は約 28 時間のデフォルトにフォールスルーします。{/* min-version: 2.1.162 */}v2.1.162 より前は、1000 未満の値は 1 秒に切り下げられていました。HTTP および SSE サーバーの場合、リクエストごとのフェッチ最初バイト予算には 60 秒の最小値があります。241サーバーごとの `timeout` はツール呼び出しごとのハードウォールクロック制限であり、サーバーからの進捗通知はそれを延長しません。1000 未満の値は無視され、`MCP_TOOL_TIMEOUT` にフォールスルーするか、その変数が設定されていない場合は約 28 時間のデフォルトにフォールスルーします。{/* min-version: 2.1.162 */}v2.1.162 より前は、1000 未満の値は 1 秒に切り下げられていました。

242 

243サーバーごとの `timeout` が少なくとも 1000 の場合、以下で説明するアイドルタイムアウトのフロアとしても機能します:Claude Code はそのサーバーのツール呼び出しをアイドルのために、サーバーごとの `timeout` より早く中止することはありません。Claude Code v2.1.203 以降が必要です。

235 244 

236v2.1.187 以降、リモート HTTP、SSE、WebSocket、または [claude.ai コネクタ](#use-mcp-servers-from-claude-ai) サーバーへのツール呼び出しで、5 分間応答も進捗通知も送信されない場合、ウォールクロック制限を待つ代わりにエラーで中止されます。[`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/ja/env-vars) 環境変数をミリ秒単位で設定して、アイドルウィンドウを変更するか`0` に設定してチェックを無効にしてください。Stdio サーバーはローカルプロセスであり、アイドルタイムアウトの対象ではありません245HTTP および SSE サーバーの場合リクエストごとのフェッチ最初バイト予算には 60 秒の最小値があります

246 

247MCP サーバーへのツール呼び出しで、アイドルウィンドウ中に応答も進捗通知も送信されない場合、ウォールクロック制限を待つ代わりにエラーで中止されます。アイドルタイムアウトには Claude Code v2.1.187 以降が必要です。{/* min-version: 2.1.203 */}IDE サーバーと SDK インプロセスサーバーを除く、すべてのサーバータイプに適用されます。アイドルウィンドウは HTTP、SSE、WebSocket、および [claude.ai コネクタ](#use-mcp-servers-from-claude-ai) サーバーの場合は 5 分、stdio サーバーの場合は 30 分がデフォルトです。v2.1.203 より前は、stdio サーバーはアイドルタイムアウトの対象外でした。

248 

249[`CLAUDE_CODE_MCP_TOOL_IDLE_TIMEOUT`](/ja/env-vars) 環境変数をミリ秒単位で設定してアイドルウィンドウを変更するか、`0` に設定してチェックを無効にしてください。

237 250 

238<h3 id="plugin-provided-mcp-servers">251<h3 id="plugin-provided-mcp-servers">

239 プラグイン提供の MCP サーバー252 プラグイン提供の MCP サーバー


304mcp__plugin_my-plugin_database-tools__query317mcp__plugin_my-plugin_database-tools__query

305```318```

306 319 

307[権限ルール](/ja/permissions)、スキルの `allowed-tools` リスト、または [サブエージェントの `tools` フィールド](/ja/sub-agents#available-tools) でツールを参照する場合は、この完全な名前を使用してください。320[権限ルール](/ja/permissions)、スキルの `allowed-tools` リスト、[サブエージェントの `tools` フィールド](/ja/sub-agents#available-tools)、または [hook マッチャー](/ja/hooks#match-mcp-tools) でツールを参照する場合は、この完全な名前を使用してください。`mcp__database-tools__.*` などのベアサーバーキーに対して記述された hook マッチャーは、プラグインでバンドルされたサーバーに対しては発火しません。

321 

322サーバー自体は、`plugin:<plugin-name>:<server-name>`(例:`plugin:my-plugin:database-tools`)などのスコープ付き名前で登録されます。設定されたサーバー名が予想される場所(例:[`mcp_tool` hook の `server` フィールド](/ja/hooks#mcp-tool-hook-fields))でその名前を使用してください。

308 323 

309**プラグイン MCP サーバーの利点**:324**プラグイン MCP サーバーの利点**:

310 325 


858 </Step>873 </Step>

859</Steps>874</Steps>

860 875 

876`claude mcp` コマンドで追加されたサーバー名には、文字、数字、ハイフン、アンダースコアのみを含めることができます。Claude Desktop はその制限を適用しないため、スペースなどの他の文字を含む名前を持つ Claude Desktop サーバーはインポートできません。インポートは拒否された各名前を報告し、選択した他のサーバーはインポートします。v2.1.205 より前では、最初の無効な名前がインポートを停止し、選択されたサーバーは追加されませんでした。

877 

861<Tip>878<Tip>

862 ヒント:879 ヒント:

863 880 

864 * この機能は macOS と Windows Subsystem for Linux(WSL)でのみ機能します881 * この機能は macOS と Windows Subsystem for Linux(WSL)でのみ機能します

865 * これらのプラットフォームの標準的な場所から Claude Desktop 設定ファイルを読み取ります882 * これらのプラットフォームの標準的な場所から Claude Desktop 設定ファイルを読み取ります

866 * `--scope user` フラグを使用してサーバーをユーザー設定に追加します883 * `--scope user` フラグを使用してサーバーをユーザー設定に追加します

867 * インポートされたサーバーは Claude Desktop と同じ名前を持ちます884 * インポートされたサーバーは、名前に文字、数字、ハイフン、アンダースコアのみが含まれている場合、Claude Desktop と同じ名前を保持します。Claude Code は他の文字を含む名前を持つサーバーを報告し、スキップします

868 * 同じ名前のサーバーが既に存在する場合、数値サフィックスが付与されます(例:`server_1`)885 * 同じ名前のサーバーが既に存在する場合、数値サフィックスが付与されます(例:`server_1`)

869</Tip>886</Tip>

870 887 


896 913 

897v2.1.161 以降、以前にサインインしたことのないコネクタは、claude.ai セクションの最後にある `Show unused connectors` 行の背後に折りたたまれているため、組織がプロビジョニングしたリストがパネルを埋めることはありません。その行を選択して展開します。以前にサインインしたコネクタは、現在再認証が必要な場合でも表示されたままです。914v2.1.161 以降、以前にサインインしたことのないコネクタは、claude.ai セクションの最後にある `Show unused connectors` 行の背後に折りたたまれているため、組織がプロビジョニングしたリストがパネルを埋めることはありません。その行を選択して展開します。以前にサインインしたコネクタは、現在再認証が必要な場合でも表示されたままです。

898 915 

899Claude.ai コネクタは、アクティブな [認証方法](/ja/authentication#authentication-precedence) が Claude.ai サブスクリプションである場合にのみ取得されます。`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、`apiKeyHelper`、または Bedrock や Vertex などのサードパーティプロバイダーがアクティブな場合は読み込まれません。以前に `/login` を実行した場合でも同様です。`/mcp` で追加したコネクタがリストされない場合は、`/status` を実行してアクティブな認証方法を確認し、その環境変数を設定解除するか `apiKeyHelper` 設定を削除してから、`/login` を実行して Claude.ai アカウントを選択します。916Claude.ai コネクタは、アクティブな [認証方法](/ja/authentication#authentication-precedence) が Claude.ai サブスクリプションである場合にのみ取得されます。`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、`apiKeyHelper`、または Amazon Bedrock や Google Cloud の Agent Platform などのサードパーティプロバイダーがアクティブな場合は読み込まれません。以前に `/login` を実行した場合でも同様です。`/mcp` で追加したコネクタがリストされない場合は、`/status` を実行してアクティブな認証方法を確認し、その環境変数を設定解除するか `apiKeyHelper` 設定を削除してから、`/login` を実行して Claude.ai アカウントを選択します。

900 917 

901Claude Code で追加したサーバーは、同じ URL を指す claude.ai コネクタより [優先](#scope-hierarchy-and-precedence) されます。この場合、`/mcp` はコネクタを非表示としてリストし、代わりにコネクタを使用する場合は重複を削除する方法を表示します。918Claude Code で追加したサーバーは、同じ URL を指す claude.ai コネクタより [優先](#scope-hierarchy-and-precedence) されます。この場合、`/mcp` はコネクタを非表示としてリストし、代わりにコネクタを使用する場合は重複を削除する方法を表示します。

902 919 


1172 ツール検索を設定する1189 ツール検索を設定する

1173</h3>1190</h3>

1174 1191 

1175ツール検索はデフォルトで有効です:MCP ツールは遅延され、オンデマンドで検出されます。Claude Code は Vertex AI ではデフォルトで無効にします。`ANTHROPIC_BASE_URL` が非ファーストパーティホストを指している場合も無効です。ほとんどのプロキシは `tool_reference` ブロックを転送しないためです。`ENABLE_TOOL_SEARCH` を明示的に設定して、いずれかのフォールバックをオーバーライドしてください。1192ツール検索はデフォルトで有効です:MCP ツールは遅延され、オンデマンドで検出されます。Claude Code は Google Cloud の Agent Platform ではデフォルトで無効にします。`ANTHROPIC_BASE_URL` が非ファーストパーティホストを指している場合も無効です。ほとんどのプロキシは `tool_reference` ブロックを転送しないためです。`ENABLE_TOOL_SEARCH` を明示的に設定して、いずれかのフォールバックをオーバーライドしてください。

1176 1193 

1177ツール検索には、`tool_reference` ブロックをサポートするモデルが必要です。Haiku モデルはツール検索をサポートしていません。Vertex AI では、Claude Sonnet 4.5 以降および Claude Opus 4.5 以降でツール検索がサポートされています。1194ツール検索には、`tool_reference` ブロックをサポートするモデルが必要です。Haiku モデルはツール検索をサポートしていません。Google Cloud の Agent Platform では、Claude Sonnet 4.5 以降および Claude Opus 4.5 以降でツール検索がサポートされています。

1178 1195 

1179`ENABLE_TOOL_SEARCH` 環境変数でツール検索の動作を制御します:1196`ENABLE_TOOL_SEARCH` 環境変数でツール検索の動作を制御します:

1180 1197 

1181| 値 | 動作 |1198| 値 | 動作 |

1182| :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------ |1199| :------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1183| (未設定) | すべての MCP ツールが遅延され、オンデマンドでロードされます。Vertex AI または `ANTHROPIC_BASE_URL` が非ファーストパーティホストの場合は事前ロードにフォールバック |1200| (未設定) | すべての MCP ツールが遅延され、オンデマンドでロードされます。Google Cloud の Agent Platform または `ANTHROPIC_BASE_URL` が非ファーストパーティホストの場合は事前ロードにフォールバック |

1184| `true` | すべての MCP ツールが遅延。Claude Code は Vertex AI およびプロキシ経由でもベータヘッダーを送信します。Vertex AI モデルが Sonnet 4.5 または Opus 4.5 より前の場合、または `tool_reference` ブロックをサポートしないプロキシの場合、リクエストは失敗します |1201| `true` | すべての MCP ツールが遅延。Claude Code は Google Cloud の Agent Platform およびプロキシ経由でもベータヘッダーを送信します。Google Cloud の Agent Platform モデルが Sonnet 4.5 または Opus 4.5 より前の場合、または `tool_reference` ブロックをサポートしないプロキシの場合、リクエストは失敗します |

1185| `auto` | しきい値モード:ツールがコンテキストウィンドウの 10% 以内に収まる場合は事前ロード、そうでない場合は遅延 |1202| `auto` | しきい値モード:ツールがコンテキストウィンドウの 10% 以内に収まる場合は事前ロード、そうでない場合は遅延 |

1186| `auto:N` | カスタムパーセンテージ付きしきい値モード。`N` は 0-100(例:5% の場合は `auto:5`) |1203| `auto:N` | カスタムパーセンテージ付きしきい値モード。`N` は 0-100(例:5% の場合は `auto:5`) |

1187| `false` | すべての MCP ツールが事前ロード、遅延なし |1204| `false` | すべての MCP ツールが事前ロード、遅延なし |

Details

315 Claude Code は現在のディレクトリのサーバーを見つけませんでした。最も一般的な原因:315 Claude Code は現在のディレクトリのサーバーを見つけませんでした。最も一般的な原因:

316 316 

317 * 別のプロジェクトから `claude mcp add` を実行しました。ローカルスコープのサーバーは追加したプロジェクトに関連付けられています。リポジトリルート、または git リポジトリにいなかった場合は正確なディレクトリ。現在いるプロジェクトからサーバーを再度追加するか、`--scope user` で追加してプロジェクトに関連付けられないようにします。317 * 別のプロジェクトから `claude mcp add` を実行しました。ローカルスコープのサーバーは追加したプロジェクトに関連付けられています。リポジトリルート、または git リポジトリにいなかった場合は正確なディレクトリ。現在いるプロジェクトからサーバーを再度追加するか、`--scope user` で追加してプロジェクトに関連付けられないようにします。

318 * 設定ファイルを間違ったパスで編集しました。正しいファイルは `~/.claude.json` と `<project>/.mcp.json` です。Claude Code は `~/.claude/config/mcp.json`、`~/.claude/mcp.json`、`%APPDATA%\Claude\mcp.json` などのパスを読み込みません。318 * 設定ファイルを間違ったパスで編集しました。正しいファイルは `~/.claude.json` と `<project>/.mcp.json` です。Claude Code は `~/.claude/.mcp.json`、`~/.claude/config/mcp.json`、`~/.claude/mcp.json`、`%APPDATA%\Claude\mcp.json` などのパスを読み込みません。ユーザースコープのサーバーの場合は、`claude mcp add --scope user` を実行します。これは `~/.claude.json` の `mcpServers` キーに書き込みます。プロジェクトスコープのサーバーの場合は、プロジェクトルートの `.mcp.json` を編集します。

319 </Accordion>319 </Accordion>

320 320 

321 <Accordion title="ステータスは「Failed to connect」または「Connection error」を表示します">321 <Accordion title="ステータスは「Failed to connect」または「Connection error」を表示します">

Details

113 2) Azure 認証情報を構成する113 2) Azure 認証情報を構成する

114</h3>114</h3>

115 115 

116Claude Code は Microsoft Foundry の 2 つの認証方法をサポートしています。セキュリティ要件に最適な方法を選択してください。116Claude Code は Microsoft Foundry の 3 つの認証方法をサポートしています。セキュリティ要件に最適な方法を選択してください。

117 117 

118**オプション A:API キー認証**118**オプション A:API キー認証**

119 119 


128 128 

129**オプション B:Microsoft Entra ID 認証**129**オプション B:Microsoft Entra ID 認証**

130 130 

131`ANTHROPIC_FOUNDRY_API_KEY` が設定されていない場合、Claude Code は Azure SDK [デフォルト認証情報チェーン](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview)を自動的に使用します。131`ANTHROPIC_FOUNDRY_API_KEY` も `ANTHROPIC_FOUNDRY_AUTH_TOKEN` も設定されていない場合、Claude Code は Azure SDK [デフォルト認証情報チェーン](https://learn.microsoft.com/en-us/azure/developer/javascript/sdk/authentication/credential-chains#defaultazurecredential-overview)を自動的に使用します。

132これは、ローカルおよびリモートワークロードを認証するためのさまざまな方法をサポートしています。132これは、ローカルおよびリモートワークロードを認証するためのさまざまな方法をサポートしています。

133 133 

134ローカル環境では、一般的に Azure CLI を使用できます:134ローカル環境では、一般的に Azure CLI を使用できます:


137az login137az login

138```138```

139 139 

140**オプション C:ベアラートークン認証**

141 

142{/* min-version: 2.1.203 */}Claude Code は、すべてのリクエストで `ANTHROPIC_FOUNDRY_AUTH_TOKEN` の値を `Authorization: Bearer` ヘッダーとして送信します。ホストアプリケーションやサインインスクリプトなど、別のプロセスがすでにアクセストークンを取得している場合に、このオプションを使用します。Claude Code v2.1.203 以降が必要です。

143 

144変数を、Microsoft Entra ID がリソース用に発行したベアラートークンに設定します:

145 

146```bash theme={null}

147export ANTHROPIC_FOUNDRY_AUTH_TOKEN=your-entra-access-token

148```

149 

150`ANTHROPIC_FOUNDRY_AUTH_TOKEN` は `ANTHROPIC_FOUNDRY_API_KEY` およびデフォルト認証情報チェーンより優先されます。

151 

140<Note>152<Note>

141 Microsoft Foundry を使用する場合、認証が Azure 認証情報を通じて処理されるため、`/logout` コマンドは利用できません。153 Microsoft Foundry を使用する場合、認証が Azure 認証情報を通じて処理されるため、`/logout` コマンドは利用できません。

142</Note>154</Note>


195claude207claude

196```208```

197 209 

198Claude Code は環境から `CLAUDE_CODE_USE_FOUNDRY` およびその他の Foundry 変数を読み込み、最初のプロンプトで Azure リソースに接続します。Bedrock および Vertex AI とは異なり、Foundry には対話型セットアップウィザードがないため、ステップ 3 およびステップ 4 の環境変数が唯一の構成パスです。210Claude Code は環境から `CLAUDE_CODE_USE_FOUNDRY` およびその他の Foundry 変数を読み込み、最初のプロンプトで Azure リソースに接続します。Amazon Bedrock および Google Cloud の Agent Platform とは異なり、Foundry には対話型セットアップウィザードがないため、ステップ 3 およびステップ 4 の環境変数が唯一の構成パスです。

199 211 

200<h2 id="azure-rbac-configuration">212<h2 id="azure-rbac-configuration">

201 Azure RBAC 構成213 Azure RBAC 構成

model-config.md +120 −63

Details

15* **モデルエイリアス**15* **モデルエイリアス**

16* **モデル名**16* **モデル名**

17 * Anthropic API:完全な **[モデル名](https://platform.claude.com/docs/ja/about-claude/models/overview)**17 * Anthropic API:完全な **[モデル名](https://platform.claude.com/docs/ja/about-claude/models/overview)**

18 * Bedrock:推論プロファイル ARN18 * Amazon Bedrock:推論プロファイル ARN

19 * Foundry:デプロイメント名19 * Microsoft Foundry:デプロイメント名

20 * Vertex:バージョン名20 * Google Cloud の Agent Platform:バージョン名

21 21 

22<Note>22<Note>

23 `ANTHROPIC_BASE_URL` は、リクエストの送信先を変更しますが、どのモデルが応答するかは変更しません。Claude を LLM ゲートウェイ経由でルーティングするには、[LLM ゲートウェイ](/ja/llm-gateway)を参照してください。23 `ANTHROPIC_BASE_URL` は、リクエストの送信先を変更しますが、どのモデルが応答するかは変更しません。Claude を LLM ゲートウェイ経由でルーティングするには、[LLM ゲートウェイ](/ja/llm-gateway)を参照してください。


41| **`opus[1m]`** | 長いセッション用に [100 万トークンのコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window) を備えた Opus を使用 |41| **`opus[1m]`** | 長いセッション用に [100 万トークンのコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window) を備えた Opus を使用 |

42| **`opusplan`** | Plan Mode 中は `opus` を使用し、実行中は `sonnet` に自動的に切り替わる特別なモード |42| **`opusplan`** | Plan Mode 中は `opus` を使用し、実行中は `sonnet` に自動的に切り替わる特別なモード |

43 43 

44Anthropic API では、`opus` は Opus 4.8 に解決され、`sonnet` は Sonnet 5 に解決されます。[Claude Platform on AWS](/ja/claude-platform-on-aws) では、`opus` は Opus 4.7 に解決され、`sonnet` は Sonnet 4.6 に解決されます。Bedrock、Vertex、Foundry では、`opus` は Opus 4.6 に解決され、`sonnet` は Sonnet 4.5 に解決されます。より新しいモデルは、完全なモデル名を明示的に選択するか、`ANTHROPIC_DEFAULT_OPUS_MODEL` または `ANTHROPIC_DEFAULT_SONNET_MODEL` を設定することで、これらのプロバイダーで利用可能です。44Anthropic API では、`opus` は Opus 4.8 に解決され、`sonnet` は Sonnet 5 に解決されます。[Claude Platform on AWS](/ja/claude-platform-on-aws) では、`opus` は Opus 4.7 に解決され、`sonnet` は Sonnet 4.6 に解決されます。Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry では、`opus` は Opus 4.6 に解決され、`sonnet` は Sonnet 4.5 に解決されます。より新しいモデルは、完全なモデル名を明示的に選択するか、`ANTHROPIC_DEFAULT_OPUS_MODEL` または `ANTHROPIC_DEFAULT_SONNET_MODEL` を設定することで、これらのプロバイダーで利用可能です。

45 45 

46エイリアスはプロバイダーの推奨バージョンを指し、時間とともに更新されます。特定のバージョンに固定するには、完全なモデル名(例:`claude-opus-4-8`)を使用するか、`ANTHROPIC_DEFAULT_OPUS_MODEL` などの対応する環境変数を設定します。46エイリアスはプロバイダーの推奨バージョンを指し、時間とともに更新されます。特定のバージョンに固定するには、完全なモデル名(例:`claude-opus-4-8`)を使用するか、`ANTHROPIC_DEFAULT_OPUS_MODEL` などの対応する環境変数を設定します。

47 47 


84* `Enter`:モデルを切り替えてデフォルトとして保存84* `Enter`:モデルを切り替えてデフォルトとして保存

85* `s`:このセッションのみモデルを切り替え85* `s`:このセッションのみモデルを切り替え

86 86 

87`/model <name>` を直接入力すると、`Enter` のように動作します。プロジェクトおよび管理設定は引き続き優先され、次の起動時に再度適用されます。{/* min-version: 2.1.196 */}管理者が設定した[組織デフォルトモデル](#organization-default-model)も次の起動時に再度適用されます。87`/model <name>` を直接入力すると、`Enter` のように動作します。{/* min-version: 2.1.205 */}[非インタラクティブモード](/ja/headless)で `/model` を使用して設定されたモデルは、`-p` フラグで現在のセッションにのみ適用され、デフォルトとして保存されません。プロジェクトおよび管理設定は引き続き優先され、次の起動時に再度適用されます。{/* min-version: 2.1.196 */}管理者が設定した[組織デフォルトモデル](#organization-default-model)も次の起動時に再度適用されます。

88 88 

89v2.1.144 から v2.1.152 では、`/model` は現在のセッションにのみ適用され、ピッカーで `d` を押すとデフォルトが保存されました。89v2.1.144 から v2.1.152 では、`/model` は現在のセッションにのみ適用され、ピッカーで `d` を押すとデフォルトが保存されました。

90 90 


92 92 

93`claude --resume`、`--continue`、または `/resume` ピッカーで開始された再開セッションは、現在の `model` 設定に関係なく、トランスクリプトが保存されたときに使用していたモデルを保持します。そのモデルが廃止されている場合、または [`availableModels`](#restrict-model-selection) によって除外されている場合、セッションは通常の優先度順序にフォールスルーします。これにより、別のセッションの `/model` 選択が再開時のモデルを変更するのを防ぎます。93`claude --resume`、`--continue`、または `/resume` ピッカーで開始された再開セッションは、現在の `model` 設定に関係なく、トランスクリプトが保存されたときに使用していたモデルを保持します。そのモデルが廃止されている場合、または [`availableModels`](#restrict-model-selection) によって除外されている場合、セッションは通常の優先度順序にフォールスルーします。これにより、別のセッションの `/model` 選択が再開時のモデルを変更するのを防ぎます。

94 94 

95新しい起動で `--model` または `ANTHROPIC_MODEL` で選択したモデルは、復元されたモデルよりも優先されます。{/* min-version: 2.1.195 */}v2.1.195 以降では、[`ANTHROPIC_DEFAULT_OPUS_MODEL`](#environment-variables) ファミリー変数も同様です。

96 

95起動時のアクティブなモデルがあなた自身の選択ではなく、プロジェクトまたは管理設定から来ている場合、起動ヘッダーはどの設定ファイルがそれを設定したかを表示します。`/model` を実行してオーバーライドします。プロジェクトまたは管理設定は次の起動時に再度適用されます。97起動時のアクティブなモデルがあなた自身の選択ではなく、プロジェクトまたは管理設定から来ている場合、起動ヘッダーはどの設定ファイルがそれを設定したかを表示します。`/model` を実行してオーバーライドします。プロジェクトまたは管理設定は次の起動時に再度適用されます。

96 98 

99モデル切り替えが [Agent SDK](/ja/agent-sdk/overview) の `setModel()` メソッドを通じて、または Claude Code CLI を実行する [Desktop app](/ja/desktop) などのアプリケーションによって要求される場合、Claude Code はその文字列が認識できるものであることを確認してから保存します。このチェックには Claude Code v2.1.200 以降が必要です。Anthropic API では、Claude Code は以下を認識します。

100 

101* モデルエイリアス

102* `/model` ピッカーからのエントリ

103* `claude-` で始まる任意の名前

104* [カスタムモデルオプション](#add-a-custom-model-option)として自分で設定した値、または [`modelOverrides`](#override-model-ids-per-version) で設定した値

105 

106Claude Code は認識されない文字列を `Model "<name>" is not a recognized model id.` で拒否し、セッションは現在のモデルを保持します。文字列を保存して次のリクエストで失敗する代わりに。回復手順については [エラーリファレンス](/ja/errors#model-is-not-a-recognized-model-id) を参照してください。

107 

108チェックは Anthropic API でのみ実行されます。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、[Claude Platform on AWS](/ja/claude-platform-on-aws)、および [LLM ゲートウェイ](/ja/llm-gateway) またはカスタム `ANTHROPIC_BASE_URL` の背後では、プロバイダーまたはゲートウェイがモデル名を定義するため、Claude Code はチェックなしで任意の文字列を通します。チェックは `--model` フラグ、`ANTHROPIC_MODEL` 環境変数、または `model` 設定もカバーしません。そこでの入力ミスは、最初のリクエストで代わりに [There's an issue with the selected model](/ja/errors#there%E2%80%99s-an-issue-with-the-selected-model) を生成します。

109 

97要求されたモデルにスケジュール済みの廃止日がある場合、または自動的に新しいバージョンに再マップされる場合、Claude Code は要求されたモデルに名前を付ける警告を表示します。インタラクティブセッションはそれをスタートアップ通知として表示します。v2.1.182 以降では、デフォルトのテキスト出力形式を使用して [非インタラクティブモード](/ja/headless) で stderr に同じ警告が書き込まれます。チェックは [サブエージェントフロントマター](/ja/sub-agents) に設定された `model` もカバーします。stderr 警告は `--output-format json` および `stream-json` に対して抑制されます。代わりに [結果メッセージ](/ja/headless#get-structured-output) の `modelUsage` フィールドから実際のモデルを読み取ります。110要求されたモデルにスケジュール済みの廃止日がある場合、または自動的に新しいバージョンに再マップされる場合、Claude Code は要求されたモデルに名前を付ける警告を表示します。インタラクティブセッションはそれをスタートアップ通知として表示します。v2.1.182 以降では、デフォルトのテキスト出力形式を使用して [非インタラクティブモード](/ja/headless) で stderr に同じ警告が書き込まれます。チェックは [サブエージェントフロントマター](/ja/sub-agents) に設定された `model` もカバーします。stderr 警告は `--output-format json` および `stream-json` に対して抑制されます。代わりに [結果メッセージ](/ja/headless#get-structured-output) の `modelUsage` フィールドから実際のモデルを読み取ります。

98 111 

99使用例:112使用例:


133* **アドバイザーモデル**:設定された [`advisorModel`](/ja/advisor) 設定および `--advisor` フラグ146* **アドバイザーモデル**:設定された [`advisorModel`](/ja/advisor) 設定および `--advisor` フラグ

134* **バックグラウンドエージェントモデル**:[ディスパッチピッカー](/ja/agent-view) で選択されたモデル147* **バックグラウンドエージェントモデル**:[ディスパッチピッカー](/ja/agent-view) で選択されたモデル

135 148 

136`/model` でブロックされたモデルに切り替えるとエラーで拒否されますが、ブロックされた `--model` フラグ、`ANTHROPIC_MODEL`、または `model` 設定値は起動時に警告とともに置き換えられ要求されたモデルと置き換えられたモデルの両方を名前で示し、セッションはデフォルトモデルで開始されます。ブロックされたサブエージェント、スキル、またはコマンドのオーバーライドは、リクエストを失敗させるのではなく継承またはデフォルトモデルにフォールバックします。ブロックされた `advisorModel` 設定はセッションのアドバイザーを無効にしブロックされた `--advisor` フラグ値は起動時にエラーで終了します。除外されたモデルは `/model` ピッカーから非表示になります。{/* min-version: 2.1.199 */}v2.1.199 以降ではリストに組み込みピッカー行がない完全なモデル ID(リストがピン留めする古いバージョンなど)は`/model` ピッカーに独自のラベル付き行として表示されます。以前のバージョンではそのような ID は `/model <id>` を入力することでのみ選択可能です149Anthropic API および [Claude Platform on AWS](/ja/claude-platform-on-aws) ではモデルファミリーエイリアス `opus`、`sonnet`、`haiku`または `fable` アローリストが許可する最新バージョンに解決されます。アローリストが特定のバージョンをピン留めする場合(例:`["sonnet", "claude-opus-4-6"]`)、`/model opus` `--model opus` の両方が Claude Opus 4.6(許可される最新の Opus)を選択し、要求されたモデルと置き換えられたモデルの両方を名前で示す通知を表示します。v2.1.205 より前では最新リリースバージョンがリスト外のエイリアスはリストが古いバージョンを許可している場合でも、他のブロックされた選択と同様に拒否または置き換えられていました

150 

151Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および [Mantle](/ja/amazon-bedrock#use-the-mantle-endpoint) は、Anthropic モデル ID ではなくプロバイダー固有のデプロイメント ID を使用するため、ブロックされたエイリアスはそこで以下の拒否および置き換え動作に従います。

137 152 

138自動モデル変更は同じ方法でチェックされます。[フォールバックモデルチェーン](#fallback-model-chains) のアローリスト外の要素は削除され、[`opusplan`](#opusplan-model-setting) などのプランモードアップグレードが除外されたモデルに対して実行される場合、計画はセッションのモデルで続行されるようにスキップされ、ターゲットが除外されている [自動モデルフォールバック](#automatic-model-fallback) は実行されないためフラグが付けられたリクエストは拒否で終了します。[高速モード](/ja/fast-mode) を有効にすることはセッションが実行されるモデルがアローリスト外にある場合に拒否されます153Claude Code モデルが設定された場所に応じて他のブロックされた選択を処理します

154 

155* **`/model`**:切り替えはエラーで拒否されます

156* **`--model` フラグ、`ANTHROPIC_MODEL`、または `model` 設定**:値は起動時に警告とともに置き換えられ、要求されたモデルと置き換えられたモデルの両方を名前で示し、セッションはデフォルトモデルで開始されます

157* **サブエージェント、スキル、またはコマンドのオーバーライド**:オーバーライドはリクエストを失敗させるのではなく、継承またはデフォルトモデルにフォールバックします

158* **`advisorModel` 設定**:アドバイザーはセッションで無効になります

159* **`--advisor` フラグ**:Claude Code は起動時にエラーで終了します

160 

161除外されたモデルは `/model` ピッカーから非表示になります。{/* min-version: 2.1.199 */}リストに組み込みピッカー行がない完全なモデル ID(リストがピン留めする古いバージョンなど)は、`/model` ピッカーに独自のラベル付き行として表示されます。v2.1.199 より前では、そのような ID は `/model <id>` を入力することでのみ選択可能でした。

162 

163Claude Code があなたに代わって行うモデル変更は、同じ方法でチェックされます。

164 

165* **[フォールバックモデルチェーン](#fallback-model-chains)**:アローリスト外の要素は削除されます

166* **Plan モードアップグレード**:Anthropic API および Claude Platform on AWS では、[`opusplan`](#opusplan-model-setting) などのアップグレードが除外されたモデルに対して実行される場合、アップグレードファミリーの最新許可バージョンを使用します。プロバイダー固有のモデル ID を持つプロバイダーで、バージョンが許可されていない場合、アップグレードはスキップされ、計画はセッションのモデルで続行されます

167* **[自動モデルフォールバック](#automatic-model-fallback)**:ターゲットが除外されているフォールバックは実行されないため、フラグが付けられたリクエストは拒否で終了します

168* **[高速モード](/ja/fast-mode)**:セッションが実行されるモデルがアローリスト外にある場合、高速モードを有効にすることは拒否されます

139 169 

140```json theme={null}170```json theme={null}

141{171{


156 186 

157* クラウドセッション([Claude Code on the web](/ja/claude-code-on-the-web) または Desktop アプリ内)は Anthropic 管理 VM で実行されます。デバイスにデプロイされた設定はそれらに到達しないため、サーバー管理設定を通じてアローリストを配信してください。クラウドセッション内の中途のモデル切り替えは、要求されたモデルがアローリストで除外されている場合に拒否されます。セッション作成時のサーバー側拒否は、`availableModels` 設定キーではなく、[組織モデル制限](#organization-model-restrictions) に適用されます。187* クラウドセッション([Claude Code on the web](/ja/claude-code-on-the-web) または Desktop アプリ内)は Anthropic 管理 VM で実行されます。デバイスにデプロイされた設定はそれらに到達しないため、サーバー管理設定を通じてアローリストを配信してください。クラウドセッション内の中途のモデル切り替えは、要求されたモデルがアローリストで除外されている場合に拒否されます。セッション作成時のサーバー側拒否は、`availableModels` 設定キーではなく、[組織モデル制限](#organization-model-restrictions) に適用されます。

158* Cowork(Claude Desktop アプリの agentic-work タブ)は Claude Code サーフェスではなく、設計上サーバー管理設定を受け取りません。管理設定ファイルは、セッションが実行される場所に存在する場合、Cowork セッションに適用されます。リモート Cowork セッションは Anthropic 管理 VM で実行され、デバイスにデプロイされたファイルは存在しません。188* Cowork(Claude Desktop アプリの agentic-work タブ)は Claude Code サーフェスではなく、設計上サーバー管理設定を受け取りません。管理設定ファイルは、セッションが実行される場所に存在する場合、Cowork セッションに適用されます。リモート Cowork セッションは Anthropic 管理 VM で実行され、デバイスにデプロイされたファイルは存在しません。

159* [Bedrock、Vertex AI、Foundry、および Claude Platform on AWS](/ja/claude-platform-on-aws) などの [サードパーティプロバイダー](/ja/server-managed-settings#platform-availability) 上のセッションはサーバー管理設定を受け取らないため、MDM または管理設定ファイルを通じてアローリストを配信してください。189* [Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、および Claude Platform on AWS](/ja/claude-platform-on-aws) などの [サードパーティプロバイダー](/ja/server-managed-settings#platform-availability) 上のセッションはサーバー管理設定を受け取らないため、MDM または管理設定ファイルを通じてアローリストを配信してください。

160* サーバー管理配信には、セッションが組織ログインまたは直接設定された API キーで認証することも必要です。[`apiKeyHelper`](/ja/settings#available-settings) スクリプトを通じてのみキーを生成するフリートは、MDM または管理設定ファイルを通じてアローリストを配信する必要があります。190* サーバー管理配信には、セッションが組織ログインまたは直接設定された API キーで認証することも必要です。[`apiKeyHelper`](/ja/settings#available-settings) スクリプトを通じてのみキーを生成するフリートは、MDM または管理設定ファイルを通じてアローリストを配信する必要があります。

161* Desktop Code タブは、実行するリモートホストから管理設定ファイルを読み取る [SSH セッション](/ja/desktop#ssh-sessions) もホストします。[Desktop 管理設定](/ja/desktop#managed-settings) を参照してください。191* Desktop Code タブは、実行するリモートホストから管理設定ファイルを読み取る [SSH セッション](/ja/desktop#ssh-sessions) もホストします。[Desktop 管理設定](/ja/desktop#managed-settings) を参照してください。

162* claude.ai および Desktop アプリのモデルピッカーは、組織のアローリストで除外されたモデルを非表示にするか、グレーアウトします。ピッカーの状態はユーザーの利便性です。強制はセッション内で発生します。192* claude.ai および Desktop アプリのモデルピッカーは、組織のアローリストで除外されたモデルを非表示にするか、グレーアウトします。ピッカーの状態はユーザーの利便性です。強制はセッション内で発生します。


182}212}

183```213```

184 214 

185ユーザーのアカウントタイプのデフォルトモデルがアローリストにない場合、Default オプションは代わりに、許可され利用可能なモデルを名前で指定する最初の `availableModels` エントリに解決され、`/model` ピッカーの Default 行はそのモデルを表示します。これはデフォルトに到達するすべての場所に適用されます。セッション起動、`/model` で Default を選択、[フォールバックモデルチェーン](#fallback-model-chains) の `"default"` キーワード、および除外された選択がドロップされたときに使用されるフォールバック。215Default オプションはアカウントタイプのデフォルトまたは管理者が設定した場合は [組織デフォルトモデル](#organization-default-model) に解決されます。そのモデルがアローリストにない場合、Default オプションは代わりに、許可され利用可能なモデルを名前で指定する最初の `availableModels` エントリに解決され、`/model` ピッカーの Default 行はそのモデルを表示します。これはデフォルトに到達するすべての場所に適用されます。セッション起動、`/model` で Default を選択、[フォールバックモデルチェーン](#fallback-model-chains) の `"default"` キーワード、および除外された選択がドロップされたときに使用されるフォールバック。

186 216 

187`enforceAvailableModels` は `availableModels` が設定されていないか空の場合、効果がありません。`availableModels: []` の場合、アカウントタイプの Default モデルは使用可能なままなので、設定はユーザーをすべてのモデルからロックアウトすることはできません。`availableModels` が空でないが、許可され利用可能なモデルに解決するエントリがない場合、強制は低下し、Default はアカウントタイプのデフォルトにフォールスルーし、`--debug` の下でのみ表示される警告が表示されます。これを避けるために、リストに少なくとも 1 つの保証された利用可能なエントリを保持してください。217`enforceAvailableModels` は `availableModels` が設定されていないか空の場合、効果がありません。`availableModels: []` の場合、アカウントタイプの Default モデルは使用可能なままなので、設定はユーザーをすべてのモデルからロックアウトすることはできません。`availableModels` が空でないが、許可され利用可能なモデルに解決するエントリがない場合、強制はスキップされ、Default はアカウントタイプのデフォルトに解決され、`--debug` の下でのみ表示される警告が表示されます。これを避けるために、リストに少なくとも 1 つの保証された利用可能なエントリを保持してください。

188 218 

189両方のキーを [最高優先度の管理ソース](/ja/settings#settings-precedence) にデプロイします。管理デプロイされたソースはマージされないため、管理設定ファイルに配置されたペアは、管理コンソールが任意の設定を配信する場合に無視されます。219両方のキーを [最高優先度の管理ソース](/ja/settings#settings-precedence) にデプロイします。管理デプロイされたソースはマージされないため、管理設定ファイルに配置されたペアは、管理コンソールが任意の設定を配信する場合に無視されます。

190 220 


192 ユーザーが実行するモデルの制御222 ユーザーが実行するモデルの制御

193</h3>223</h3>

194 224 

195`model` 設定は初期選択であり、強制ではありません。セッション開始時にアクティブなモデルを設定しますが、ユーザーは `/model` を開いて Default を選択することができ、これは [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) がそれをリダイレクトしない限り、`model` が何に設定されているかに関係なく、そのティアのシステムデフォルトに解決されます225`model` 設定は初期選択であり、強制ではありません。セッション開始時にアクティブなモデルを設定しますが、ユーザーは `/model` を開いて Default を選択することができ、これは [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) がそれをリダイレクトしない限り、`model` が何に設定されているかに関係なく、システムの [ランタイムデフォルト](#default-model-setting) に解決されます

196 226 

197モデル体験を完全に制御するには、これらの設定を組み合わせます。227モデル体験を完全に制御するには、これらの設定を組み合わせます。

198 228 


228 Mantle モデル ID258 Mantle モデル ID

229</h3>259</h3>

230 260 

231[Bedrock Mantle エンドポイント](/ja/amazon-bedrock#use-the-mantle-endpoint) が有効な場合、`availableModels` の `anthropic.` で始まるエントリは、カスタムオプションとして `/model` ピッカーに追加され、Mantle エンドポイントにルーティングされます。これは、[サードパーティデプロイメント用のモデルをピン留めする](#pin-models-for-third-party-deployments) で説明されているエイリアスマッチングの例外です。設定はピッカーをリストされたエントリに制限し、Mantle ID はファミリー名を埋め込むため、特定のエントリとしてカウントされ、そのファミリーのワイルドカードを無効にします。任意の Mantle ID と一緒に、保持したいバージョンプレフィックスまたは完全な ID をリストします。[マージ動作](#merge-behavior) を参照してください。261[Amazon Bedrock Mantle エンドポイント](/ja/amazon-bedrock#use-the-mantle-endpoint) が有効な場合、`availableModels` の `anthropic.` で始まるエントリは、カスタムオプションとして `/model` ピッカーに追加され、Mantle エンドポイントにルーティングされます。これは、[サードパーティデプロイメント用のモデルをピン留めする](#pin-models-for-third-party-deployments) で説明されているエイリアスマッチングの例外です。設定はピッカーをリストされたエントリに制限し、Mantle ID はファミリー名を埋め込むため、特定のエントリとしてカウントされ、そのファミリーのワイルドカードを無効にします。任意の Mantle ID と一緒に、保持したいバージョンプレフィックスまたは完全な ID をリストします。[マージ動作](#merge-behavior) を参照してください。

232 262 

233<h3 id="organization-model-restrictions">263<h3 id="organization-model-restrictions">

234 組織モデル制限264 組織モデル制限


240 270 

241Claude Console にはモデル制限制御がありません。Claude Enterprise プランを持たない組織(Anthropic API を通じて認証するメンバーを持つ組織を含む)は、[管理設定](/ja/settings#settings-files) で [`availableModels`](#restrict-model-selection) を使用してモデルを制限し、Default オプションをカバーするために [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) を追加します。これらの設定は、サーバーではなく Claude Code 自体によって適用されます。271Claude Console にはモデル制限制御がありません。Claude Enterprise プランを持たない組織(Anthropic API を通じて認証するメンバーを持つ組織を含む)は、[管理設定](/ja/settings#settings-files) で [`availableModels`](#restrict-model-selection) を使用してモデルを制限し、Default オプションをカバーするために [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) を追加します。これらの設定は、サーバーではなく Claude Code 自体によって適用されます。

242 272 

243制限されたモデルは `/model` ピッカーから非表示になります。`--model`、`ANTHROPIC_MODEL` 環境変数、または `model` 設定で名前で選択すると、`Model "<name>" is restricted by your organization's settings. Using <model> instead.`という通知が表示され、セッションは許可されたモデルで開始されます。制限されたモデルに対して `/model <name>` と入力すると、`Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.`で拒否され、セッションは現在のモデルを保持します。273制限されたモデルは `/model` ピッカーから非表示になります。`--model`、`ANTHROPIC_MODEL` 環境変数、または `model` 設定で名前で選択すると、`Model "<name>" is restricted by your organization's settings. Using <model> instead.` という通知が表示され、セッションは許可されたモデルで開始されます。制限されたモデルに対して `/model <name>` と入力すると、`Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` で拒否され、セッションは現在のモデルを保持します。

274 

275`opus`、`sonnet`、`haiku`、`fable` などの [モデルファミリーエイリアス](#restrict-model-selection) は、組織が許可するそのファミリーの最新バージョンに解決され、同じ置き換え通知が表示されます。`/model <alias>` は、そのファミリーのすべてのバージョンが制限されている場合にのみ拒否されます。`--model`、`ANTHROPIC_MODEL`、または `model` 設定で設定されたエイリアスは、その場合でも起動時に置き換えられます。v2.1.205 より前では、ファミリーエイリアスは最新リリースバージョンのみに基づいて置き換えられたか拒否されていました。古いバージョンが許可されている場合でも同様です。

244 276 

2452 つの制限は一緒に適用されます。モデルは `availableModels` で許可され、組織によって制限されていない場合にのみ選択可能です。組織制限は Anthropic API および [LLM ゲートウェイ](/ja/llm-gateway) デプロイメント上のセッションに配信されます。Bedrock、Vertex AI、Foundry、および Claude Platform on AWS 上のセッションはそれらを受け取らないため、代わりにそれらのプロバイダーで `availableModels` を使用してください277制限は組織全体またはロールごとに適用されます

278 

279* 組織レベルでモデルを無効にすると、すべてのメンバーから削除されます。

280* ロールレベルのアクセスは異なるカスタムロールに異なるモデルを付与し、複数のロールを保持するメンバーは、そのロールの 1 つが付与するモデルを使用できます。

281* Haiku モデルは常に利用可能であり、無効にすることはできないため、すべてのメンバーは少なくとも 1 つの使用可能なモデルを保持します。

282* アクセス変更は約 1 分以内に新しいリクエストに有効になります。`/model` ピッカーはセッションが次に開始するときにそれを反映します。

283 

284両方の制限が一緒に適用されます。モデルは `availableModels` で許可され、組織によって制限されていない場合にのみ選択可能です。組織制限は Anthropic API および [LLM ゲートウェイ](/ja/llm-gateway) デプロイメント上のセッションに配信されます。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS 上のセッションはそれらを受け取らないため、代わりにそれらのプロバイダーで `availableModels` を使用してください。

246 285 

247<h2 id="organization-default-model">286<h2 id="organization-default-model">

248 組織デフォルトモデル287 組織デフォルトモデル


301* **Max、Team Premium、Enterprise 従量課金、Anthropic API**:Opus 4.8 がデフォルト340* **Max、Team Premium、Enterprise 従量課金、Anthropic API**:Opus 4.8 がデフォルト

302* **AWS 上の Claude Platform**:Opus 4.7 がデフォルト341* **AWS 上の Claude Platform**:Opus 4.7 がデフォルト

303* **Pro、Team Standard、Enterprise サブスクリプションシート**:Sonnet 5 がデフォルト342* **Pro、Team Standard、Enterprise サブスクリプションシート**:Sonnet 5 がデフォルト

304* **Bedrock、Vertex、Foundry**:Sonnet 4.5 がデフォルト343* **Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry**:Sonnet 4.5 がデフォルト

305 344 

306Enterprise 従量課金とは、サブスクリプションシートではなく使用量で請求される Enterprise 組織を意味します。345Enterprise 従量課金とは、サブスクリプションシートではなく使用量で請求される Enterprise 組織を意味します。

307 346 


324 363 

325Plan Mode の Opus フェーズは `opus` モデル設定と同じコンテキストウィンドウを使用します。[自動アップグレード](#extended-context)で Opus が 1M コンテキストに自動アップグレードされるサブスクリプション層では、`opusplan` も Plan Mode でアップグレードを受け取ります。自動アップグレード層にない場合に両方のフェーズで 1M コンテキストを強制するには、モデルを `opusplan[1m]` に設定します。364Plan Mode の Opus フェーズは `opus` モデル設定と同じコンテキストウィンドウを使用します。[自動アップグレード](#extended-context)で Opus が 1M コンテキストに自動アップグレードされるサブスクリプション層では、`opusplan` も Plan Mode でアップグレードを受け取ります。自動アップグレード層にない場合に両方のフェーズで 1M コンテキストを強制するには、モデルを `opusplan[1m]` に設定します。

326 365 

327[`availableModels`](#restrict-model-selection) Opus を除外する場合、`opusplan` Plan Mode で切り替える代わりに Sonnet に留まります。Sonnet が除外される場合の暗黙的な Haiku から Sonnet への Plan Mode アップグレードにも同じことが適用されます366[`availableModels`](#restrict-model-selection) が最新の Opus を除外しますが古いバージョン(例えば `["sonnet", "claude-opus-4-6"]`)を許可する場合、`opusplan` は計画用に許可された最新の Opus を使用し、すべての Opus が除外されている場合のみ Sonnet に留まります。通常は Plan Mode で Sonnet にアップグレードする Haiku セッションは同様に、許可された最新の Sonnet を使用し、すべての Sonnet が除外されている場合のみ Haiku に留まります。v2.1.205 より前では、許可リストが古いバージョンを許可していても、アップグレードファミリーの最新バージョンが除外されている場合、Plan Mode はセッションのモデルに留まっていました

367 

368古いバージョンの置き換えは Anthropic API と [Claude Platform on AWS](/ja/claude-platform-on-aws) に適用されます。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Mantle では、プロバイダー固有のモデル ID を使用するデプロイメントのため、アップグレードモデルが除外されている場合、Plan Mode はセッションのモデルに留まります。

328 369 

329Claude がタスク途中で 2 番目のモデルを参照するかどうかを決定するハイブリッドアプローチについては、[advisor tool](/ja/advisor)を参照してください。370Claude がタスク途中で 2 番目のモデルを参照するかどうかを決定するハイブリッドアプローチについては、[advisor tool](/ja/advisor) を参照してください。

330 371 

331<h3 id="fallback-model-chains">372<h3 id="fallback-model-chains">

332 フォールバックモデルチェーン373 フォールバックモデルチェーン


342claude --fallback-model sonnet,haiku383claude --fallback-model sonnet,haiku

343```384```

344 385 

345セッション全体でチェーンを保持するには、[settings](/ja/settings)で `fallbackModel` を配列として設定します。386セッション全体でチェーンを保持するには、[settings](/ja/settings) で `fallbackModel` を配列として設定します。

346 387 

347```json theme={null}388```json theme={null}

348{389{


355要素がスキップされる 2 つのケース:396要素がスキップされる 2 つのケース:

356 397 

357* **利用不可能なモデル**:設定にピン留めされた廃止されたモデルなど、到達できないモデルはスキップされ、Claude Code は次の要素に続きます。398* **利用不可能なモデル**:設定にピン留めされた廃止されたモデルなど、到達できないモデルはスキップされ、Claude Code は次の要素に続きます。

358* **許可リストの外**:[`availableModels`](#restrict-model-selection)で許可されていない要素は、チェーンが読み込まれるときにドロップされ、試行されません。399* **許可リストの外**:[`availableModels`](#restrict-model-selection) で許可されていない要素は、チェーンが読み込まれるときにドロップされ、試行されません。

359 400 

360<h3 id="automatic-model-fallback">401<h3 id="automatic-model-fallback">

361 自動モデルフォールバック402 自動モデルフォールバック

362</h3>403</h3>

363 404 

364このセクションは Fable 5 からのコンテンツベースのフォールバックをカバーしています。モデルが過負荷状態または利用不可の場合の可用性ベースのフォールバックについては、[フォールバックモデルチェーン](#fallback-model-chains)を参照してください。405このセクションは Fable 5 からのコンテンツベースのフォールバックをカバーしています。モデルが過負荷状態または利用不可の場合の可用性ベースのフォールバックについては、[フォールバックモデルチェーン](#fallback-model-chains) を参照してください。

365 406 

366Fable 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。407Fable 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。

367 408 

368セッションはその Opus モデルで続行されます。Fable 5 に戻るには、`/model fable` を実行します。409セッションはその Opus モデルで続行されます。Fable 5 に戻るには、`/model fable` を実行します。

369 410 

370フォールバックターゲットは [`availableModels`](#restrict-model-selection)に対してチェックされます。ブロックされている場合、フォールバックは発生しません。拒否は通常のエラーとして表示され、セッションのモデルは変更されません。411フォールバックターゲットは [`availableModels`](#restrict-model-selection) に対してチェックされます。ブロックされている場合、フォールバックは発生しません。拒否は通常のエラーとして表示され、セッションのモデルは変更されません。

371 412 

372<h4 id="check-what-triggered-fallback">413<h4 id="check-what-triggered-fallback">

373 フォールバックをトリガーしたものを確認414 フォールバックをトリガーしたものを確認


386いくつかのケースは異なる動作をします。427いくつかのケースは異なる動作をします。

387 428 

388* 両方のモデルが同じリクエストにフラグを立てた場合、プロンプトを編集して再試行するか、新しいセッションを開始できます。429* 両方のモデルが同じリクエストにフラグを立てた場合、プロンプトを編集して再試行するか、新しいセッションを開始できます。

389* モバイル[Claude Code on the web](/ja/claude-code-on-the-web)セッションでは、編集と再試行はサポートされていません。モデルを切り替えるか、デスクトップブラウザまたはデスクトップアプリからセッションを続行します。430* モバイル [Claude Code on the web](/ja/claude-code-on-the-web) セッションでは、編集と再試行はサポートされていません。モデルを切り替えるか、デスクトップブラウザまたはデスクトップアプリからセッションを続行します。

390* [非対話モード](/ja/cli-reference#cli-flags)と、プロンプトを表示できない SDK 統合では、フラグが立てられたリクエストは拒否で終了します。431* [非対話モード](/ja/cli-reference#cli-flags) と、プロンプトを表示できない SDK 統合では、フラグが立てられたリクエストは拒否で終了します。

391* フォールバックターゲットが [`availableModels`](#restrict-model-selection)でブロックされている場合、プロンプトは表示されません。フラグが立てられたリクエストは拒否で終了し、ターゲットがブロックされている場合の自動フォールバックと同じです。432* フォールバックターゲットが [`availableModels`](#restrict-model-selection) でブロックされている場合、プロンプトは表示されません。フラグが立てられたリクエストは拒否で終了し、ターゲットがブロックされている場合の自動フォールバックと同じです。

392 433 

393<h4 id="enable-fallback-on-bedrock-vertex-ai-and-foundry">434<h4 id="enable-fallback-on-bedrock-agent-platform-and-foundry">

394 Bedrock、Vertex AI、Foundry でフォールバックを有効化435 Bedrock、Agent Platform、Foundry でフォールバックを有効化

395</h4>436</h4>

396 437 

397[Amazon Bedrock](/ja/amazon-bedrock)、[Google Vertex AI](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry)では、モデル ID はプロバイダー固有であるため、自動フォールバックは Claude Code が関連する両方のモデルを識別できる場合にのみ動作します。438[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry) では、モデル ID はプロバイダー固有であるため、自動フォールバックは Claude Code が関連する両方のモデルを識別できる場合にのみ動作します。

398 439 

399* Claude Code は現在のモデルを Fable 5 として認識する必要があります。モデル ID に `claude-fable-5` が含まれるか、`ANTHROPIC_DEFAULT_FABLE_MODEL` の値と一致するか、[`modelOverrides`](#override-model-ids-per-version)でマップされています。440* Claude Code は現在のモデルを Fable 5 として認識する必要があります。モデル ID に `claude-fable-5` が含まれるか、`ANTHROPIC_DEFAULT_FABLE_MODEL` の値と一致するか、[`modelOverrides`](#override-model-ids-per-version) でマップされています。

400* フォールバックターゲットは Opus モデルに解決される必要があります。`ANTHROPIC_DEFAULT_OPUS_MODEL` が設定されている場合はその値、それ以外はプロバイダーのモデルリストの Opus 4.8 エントリ。441* フォールバックターゲットは Opus モデルに解決される必要があります。`ANTHROPIC_DEFAULT_OPUS_MODEL` が設定されている場合はその値、それ以外はプロバイダーのモデルリストの Opus 4.8 エントリ。

401 442 

402どちらかのモデルが識別できない場合、Claude Code は自動的に切り替わりません。フラグが立てられたリクエストは拒否メッセージで終了し、[`/model`](#setting-your-model)でモデルを切り替えて再試行できます。これらのプロバイダーで自動フォールバックを有効にするには、`ANTHROPIC_DEFAULT_FABLE_MODEL` を Fable 5 モデル ID に、`ANTHROPIC_DEFAULT_OPUS_MODEL` を Opus 4.8 モデル ID に設定します。443どちらかのモデルが識別できない場合、Claude Code は自動的に切り替わりません。フラグが立てられたリクエストは拒否メッセージで終了し、[`/model`](#setting-your-model) でモデルを切り替えて再試行できます。これらのプロバイダーで自動フォールバックを有効にするには、`ANTHROPIC_DEFAULT_FABLE_MODEL` を Fable 5 モデル ID に、`ANTHROPIC_DEFAULT_OPUS_MODEL` を Opus 4.8 モデル ID に設定します。

403 444 

404<h4 id="security-research-and-biology-workloads">445<h4 id="security-research-and-biology-workloads">

405 セキュリティ研究と生物学ワークロード446 セキュリティ研究と生物学ワークロード


413 努力レベルの調整454 努力レベルの調整

414</h3>455</h3>

415 456 

416[努力レベル](https://platform.claude.com/docs/ja/build-with-claude/effort)は適応的推論を制御し、タスクの複雑さに基づいて各ステップで思考するかどうか、どの程度思考するかをモデルが決定できるようにします。低い努力はシンプルなタスクではより高速で安価ですが、高い努力は複雑な問題に対してより深い推論を提供します。457[努力レベル](https://platform.claude.com/docs/ja/build-with-claude/effort) は適応的推論を制御し、タスクの複雑さに基づいて各ステップで思考するかどうか、どの程度思考するかをモデルが決定できるようにします。低い努力はシンプルなタスクではより高速で安価ですが、高い努力は複雑な問題に対してより深い推論を提供します。

417 458 

418利用可能な努力レベルはモデルによって異なります。ここに記載されていないモデルは努力をサポートしていません。459利用可能な努力レベルはモデルによって異なります。ここに記載されていないモデルは努力をサポートしていません。

419 460 


423| Sonnet 5、Opus 4.8、Opus 4.7 | `low`、`medium`、`high`、`xhigh`、`max` |464| Sonnet 5、Opus 4.8、Opus 4.7 | `low`、`medium`、`high`、`xhigh`、`max` |

424| Opus 4.6 と Sonnet 4.6 | `low`、`medium`、`high`、`max` |465| Opus 4.6 と Sonnet 4.6 | `low`、`medium`、`high`、`max` |

425 466 

426アクティブなモデルがサポートしないレベルを設定した場合、Claude Code は設定したレベル以下の最高サポートレベルにフォールバックします。例えば、`xhigh` は Opus 4.6 では `high` として実行されます。組織は、モデルに対して利用可能なレベルをキャップすることもできます。[組織努力制限](#organization-effort-limits)を参照してください。467アクティブなモデルがサポートしないレベルを設定した場合、Claude Code は設定したレベル以下の最高サポートレベルにフォールバックします。例えば、`xhigh` は Opus 4.6 では `high` として実行されます。組織は、モデルに対して利用可能なレベルをキャップすることもできます。[組織努力制限](#organization-effort-limits) を参照してください。

427 468 

428デフォルト努力は Fable 5、Sonnet 5、Opus 4.8、Opus 4.6、Sonnet 4.6 では `high` で、Opus 4.7 では `xhigh` です。469デフォルト努力は Fable 5、Sonnet 5、Opus 4.8、Opus 4.6、Sonnet 4.6 では `high` で、Opus 4.7 では `xhigh` です。

429 470 

430Fable 5、Opus 4.8、または Opus 4.7 を初めて実行する場合、Claude Code は、別のモデルに対して以前に異なるレベルを設定していても、そのモデルのデフォルト努力を適用します。Fable 5 と Opus 4.8 では `high`、Opus 4.7 では `xhigh` です。切り替え後に `/effort` を再度実行して、別のレベルを選択します。471Fable 5、Opus 4.8、または Opus 4.7 を初めて実行する場合、Claude Code は、別のモデルに対して以前に異なるレベルを設定していても、そのモデルのデフォルト努力を適用します。Fable 5 と Opus 4.8 では `high`、Opus 4.7 では `xhigh` です。切り替え後に `/effort` を再度実行して、別のレベルを選択します。そのデフォルトはセッション全体で保持され、明示的な努力選択(インタラクティブセッションで `/effort` を実行するか、`--effort` で起動するなど)を行うまで保持されます。

472 

473`low`、`medium`、`high`、`xhigh` はセッション全体で保持されます。[非対話モード](/ja/headless) で `/effort` を実行するか、`-p` フラグで設定されたレベルは現在のセッションのみに適用され、デフォルトとして保存されません。非対話 `/effort` は上記のモデルデフォルトホールドをリリースすることもできません。Fable 5、Opus 4.8、Opus 4.7 では `Not applied` を報告し、セッションはモデルのデフォルト努力に留まるため、代わりに起動時に `--effort` を渡します。`max` は制約なしで最も深い推論を提供し、現在のセッションのみに適用されます。ただし、`CLAUDE_CODE_EFFORT_LEVEL` 環境変数を通じて設定された場合を除きます。

474 

475`/effort` メニューは `ultracode` も提供します。Ultracode はモデル努力レベルではなく Claude Code 設定です。モデルに `xhigh` を送信し、さらに Claude が実質的なタスク用に [dynamic workflows](/ja/workflows) をオーケストレートします。現在のセッションのみに適用されます。

431 476 

432`low`、`medium`、`high`、`xhigh` はセッション全体で保持されます。`max` はトークン支出に制約がない最も深い推論を提供し、`CLAUDE_CODE_EFFORT_LEVEL` 環境変数を通じて設定された場合を除き、現在のセッションのみに適用されます477以下のいずれかを通じて ultracode をオンにできます

433 478 

434`/effort` メニューは `ultracode` も提供します。Ultracode はモデル努力レベルではなく Claude Code 設定です。モデルに `xhigh` を送信し、さらに Claude が実質的なタスク用に[動的ワークフロー](/ja/workflows)をオーケストレートします。現在のセッションのみに適用されます。`/effort` を通じて設定するか、`--settings` または Agent SDK 制御リクエストを通じて `"ultracode": true` を渡します。これは `effortLevel` 設定、`--effort` フラグ`CLAUDE_CODE_EFFORT_LEVEL` の一部ではありません。479* **`/effort`**:`/effort ultracode` を実行するかメニューから選択

480* **`--effort` フラグ**:`claude --effort ultracode` で起動します。これはセッションを `xhigh` 努力で開始し、ultracode をオンにします

481* **`--settings` または Agent SDK 制御リクエスト**:`"ultracode": true` を渡します。[`applyFlagSettings()`](/ja/agent-sdk/typescript#applyflagsettings) リクエストは `effortLevel: "ultracode"` も受け入れます

482 

483`--effort` フラグまたは Agent SDK `effortLevel` 値に `ultracode` を渡すには、Claude Code v2.1.203 以降が必要です。v2.1.203 より前では、`--effort ultracode` は `Unknown --effort value 'ultracode'` を出力し、セッションはデフォルト努力で開始されました。

484 

485保持された `effortLevel` 設定と `CLAUDE_CODE_EFFORT_LEVEL` 環境変数は `ultracode` を受け入れません。

486 

487ultracode が利用不可の場合(例えば [workflows がオフ](/ja/workflows#turn-workflows-off) の場合)、`--effort ultracode` は `xhigh` 努力のみを設定します。

435 488 

436<h4 id="choose-an-effort-level">489<h4 id="choose-an-effort-level">

437 努力レベルの選択490 努力レベルの選択


440各レベルはトークン支出と機能をトレードオフします。デフォルトはほとんどのコーディングタスクに適しています。別のバランスが必要な場合は調整します。493各レベルはトークン支出と機能をトレードオフします。デフォルトはほとんどのコーディングタスクに適しています。別のバランスが必要な場合は調整します。

441 494 

442| レベル | 使用する場合 |495| レベル | 使用する場合 |

443| :---------- | :---------------------------------------------------------------------------------- |496| :---------- | :-------------------------------------------------------------------------------------------- |

444| `low` | インテリジェンスに敏感でない短くスコープされたレイテンシに敏感なタスク用に予約 |497| `low` | インテリジェンスに敏感でない短くスコープされたレイテンシに敏感なタスク用に予約 |

445| `medium` | インテリジェンスをトレードオフできるコスト敏感な作業のトークン使用量を削減 |498| `medium` | インテリジェンスをトレードオフできるコスト敏感な作業のトークン使用量を削減 |

446| `high` | トークン使用量とインテリジェンスのバランス。Fable 5、Sonnet 5、Opus 4.8、Opus 4.6、Sonnet 4.6 でのデフォルト |499| `high` | トークン使用量とインテリジェンスのバランス。Fable 5、Sonnet 5、Opus 4.8、Opus 4.6、Sonnet 4.6 でのデフォルト |

447| `xhigh` | より高いトークン支出での深い推論。Opus 4.7 でのデフォルト |500| `xhigh` | より高いトークン支出での深い推論。Opus 4.7 でのデフォルト |

448| `max` | 難しいタスクのパフォーマンスを改善できますが、収益逓減を示す可能性があり、過度な思考の傾向があります。広く採用する前にテスト |501| `max` | 難しいタスクのパフォーマンスを改善できますが、収益逓減を示す可能性があり、過度な思考の傾向があります。広く採用する前にテスト |

449| `ultracode` | 各実質的なタスク用に `xhigh` ごとのメッセージ推論で[動的ワークフロー](/ja/workflows)を計画する Claude Code 設定。セッションのみ |502| `ultracode` | 各実質的なタスク用に `xhigh` ごとのメッセージ推論で [dynamic workflow](/ja/workflows) を計画する Claude Code 設定。セッションのみ |

450 503 

451努力スケールはモデルごとに調整されるため、同じレベル名はモデル全体で同じ基盤値を表しません。504努力スケールはモデルごとに調整されるため、同じレベル名はモデル全体で同じ基盤値を表しません。

452 505 


466* **`/model` 内**:モデルを選択する際に左右矢印キーを使用して努力スライダーを調整519* **`/model` 内**:モデルを選択する際に左右矢印キーを使用して努力スライダーを調整

467* **`--effort` フラグ**:Claude Code を起動する際にレベル名を渡して、単一セッションのレベルを設定520* **`--effort` フラグ**:Claude Code を起動する際にレベル名を渡して、単一セッションのレベルを設定

468* **環境変数**:`CLAUDE_CODE_EFFORT_LEVEL` をレベル名または `auto` に設定521* **環境変数**:`CLAUDE_CODE_EFFORT_LEVEL` をレベル名または `auto` に設定

469* **設定**:設定ファイルで `effortLevel` を `low`、`medium`、`high`、`xhigh` に設定します。`max` と `ultracode` は[セッションのみ](#adjust-effort-level)であり、ここでは受け入れられません522* **設定**:設定ファイルで `effortLevel` を `low`、`medium`、`high`、`xhigh` に設定します。`max` と `ultracode` は [セッションのみ](#adjust-effort-level) であり、ここでは受け入れられません

470* **Skill と subagent frontmatter**:[skill](/ja/skills#frontmatter-reference)または[subagent](/ja/sub-agents#supported-frontmatter-fields)markdown ファイルで `effort` を設定して、その skill または subagent が実行される際の努力レベルをオーバーライド523* **Skill と subagent frontmatter**:[skill](/ja/skills#frontmatter-reference) または [subagent](/ja/sub-agents#supported-frontmatter-fields) markdown ファイルで `effort` を設定して、その skill または subagent が実行される際の努力レベルをオーバーライド

471 524 

472環境変数がすべての他の方法より優先され、次に設定されたレベル、次にモデルのデフォルトが優先されます。Frontmatter 努力は、その skill または subagent がアクティブな場合に適用され、セッションレベルをオーバーライドしますが、環境変数はオーバーライドしません。525環境変数がすべての他の方法より優先され、次に設定されたレベル、次にモデルのデフォルトが優先されます。Frontmatter 努力は、その skill または subagent がアクティブな場合に適用され、セッションレベルをオーバーライドしますが、環境変数はオーバーライドしません。

473 526 


481 534 

482Fable 5、Sonnet 5、Opus 4.7 以降は常に適応的推論を使用します。固定思考予算モードと `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` はそれらに適用されません。535Fable 5、Sonnet 5、Opus 4.7 以降は常に適応的推論を使用します。固定思考予算モードと `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` はそれらに適用されません。

483 536 

484Opus 4.6 と Sonnet 4.6 では、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` を設定して、`MAX_THINKING_TOKENS` で制御される以前の固定思考予算に戻すことができます。[環境変数](/ja/env-vars)を参照してください。537Opus 4.6 と Sonnet 4.6 では、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1` を設定して、`MAX_THINKING_TOKENS` で制御される以前の固定思考予算に戻すことができます。[環境変数](/ja/env-vars) を参照してください。

485 538 

486<h3 id="extended-thinking">539<h3 id="extended-thinking">

487 拡張思考540 拡張思考

488</h3>541</h3>

489 542 

490拡張思考は、Claude が応答する前に発する推論です。[適応的推論](#adjust-effort-level)をサポートするモデルでは、努力レベルは思考がどの程度発生するかの主要な制御です。以下の設定は思考をオンまたはオフにし、それがどのように表示されるかを制御します。543拡張思考は、Claude が応答する前に発する推論です。[適応的推論](#adjust-effort-level) をサポートするモデルでは、努力レベルは思考がどの程度発生するかの主要な制御です。以下の設定は思考をオンまたはオフにし、それがどのように表示されるかを制御します。

491 544 

492| 制御 | 設定方法 |545| 制御 | 設定方法 |

493| :------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |546| :------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

494| 現在のセッションのトグル | macOS では `Option+T`、Windows と Linux では `Alt+T` を押します |547| 現在のセッションのトグル | macOS では `Option+T`、Windows と Linux では `Alt+T` を押します |

495| グローバルデフォルトを設定 | `/config` を実行して思考モードをトグルします。`~/.claude/settings.json` に `alwaysThinkingEnabled` として保存されます |548| グローバルデフォルトを設定 | `/config` を実行して思考モードをトグルします。`~/.claude/settings.json` に `alwaysThinkingEnabled` として保存されます |

496| 努力に関係なく無効化 | [`MAX_THINKING_TOKENS=0`](/ja/env-vars)を設定します。これは Anthropic API 上の Fable 5 を除いて思考をオフにします。[サードパーティプロバイダー](/ja/third-party-integrations)ではこれは `thinking` パラメータを省略し、適応的推論モデルは引き続き思考する可能性があります。他の値は[固定思考予算](#adaptive-reasoning-and-fixed-thinking-budgets)でのみ適用されます |549| 努力に関係なく無効化 | [`MAX_THINKING_TOKENS=0`](/ja/env-vars) を設定します。これは Anthropic API 上の Fable 5 を除いて思考をオフにします。[サードパーティプロバイダー](/ja/third-party-integrations) ではこれは `thinking` パラメータを省略し、適応的推論モデルは引き続き思考する可能性があります。他の値は [固定思考予算](#adaptive-reasoning-and-fixed-thinking-budgets) でのみ適用されます |

497 550 

498思考は Fable 5 でオフにすることはできません。セッショントグル、`alwaysThinkingEnabled`、`MAX_THINKING_TOKENS=0` はそこに効果がなく、Fable 5 は努力レベルに基づいて各ステップでどの程度思考するかを決定します。551思考は Fable 5 でオフにすることはできません。セッショントグル、`alwaysThinkingEnabled`、`MAX_THINKING_TOKENS=0` はそこに効果がなく、Fable 5 は努力レベルに基づいて各ステップでどの程度思考するかを決定します。

499 552 

500思考出力はデフォルトで折りたたまれています。`Ctrl+O` を押して詳細モードをトグルし、推論をグレーのイタリック体テキストとして表示します。Anthropic API 上のインタラクティブセッションはデフォルトで編集された思考ブロックを受け取るため、展開時に完全な要約を利用可能にしたい場合は[設定](/ja/settings)で `showThinkingSummaries: true` を設定します。折りたたまれたまたは編集された場合でも、生成されたすべての思考トークンに対して課金されます。553思考出力はデフォルトで折りたたまれています。`Ctrl+O` を押して詳細モードをトグルし、推論をグレーのイタリック体テキストとして表示します。Anthropic API 上のインタラクティブセッションはデフォルトで編集された思考ブロックを受け取るため、展開時に完全な要約を利用可能にしたい場合は [設定](/ja/settings) で `showThinkingSummaries: true` を設定します。折りたたまれたまたは編集された場合でも、生成されたすべての思考トークンに対して課金されます。

501 554 

502<h3 id="extended-context">555<h3 id="extended-context">

503 拡張コンテキスト556 拡張コンテキスト

504</h3>557</h3>

505 558 

506Fable 5、Sonnet 5、Opus 4.6 以降、Sonnet 4.6 は、大規模なコードベースを持つ長いセッション用に[100 万トークンのコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。559Fable 5、Sonnet 5、Opus 4.6 以降、Sonnet 4.6 は、大規模なコードベースを持つ長いセッション用に [100 万トークンのコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window) をサポートしています。

507 560 

508利用可能性はモデルとプランによって異なります。Anthropic API では、Fable 5、Sonnet 5、Opus 4.8、Opus 4.7 は常に 1M ウィンドウで実行されます。Max、Team、Enterprise プランでは、Opus は追加設定なしで自動的に 1M コンテキストにアップグレードされます。これは Team Standard と Team Premium の両方のシートに適用されます。Sonnet 4.6 with 1M context は自動アップグレードの一部ではなく、Max を含むすべてのサブスクリプションプランで[使用クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)が必要です。561利用可能性はモデルとプランによって異なります。Anthropic API では、Fable 5、Sonnet 5、Opus 4.8、Opus 4.7 は常に 1M ウィンドウで実行されます。Max、Team、Enterprise プランでは、Opus は追加設定なしで自動的に 1M コンテキストにアップグレードされます。これは Team Standard と Team Premium の両方のシートに適用されます。Sonnet 4.6 with 1M context は自動アップグレードの一部ではなく、Max を含むすべてのサブスクリプションプランで [使用クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans) が必要です。

509 562 

510| プラン | Opus with 1M context | Sonnet 4.6 with 1M context |563| プラン | Opus with 1M context | Sonnet 4.6 with 1M context |

511| ------------------- | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |564| ------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |

512| Max、Team、Enterprise | サブスクリプションに含まれる | [使用クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)が必要 |565| Max、Team、Enterprise | サブスクリプションに含まれる | [使用クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans) が必要 |

513| Pro | [使用クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)が必要 | [使用クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans)が必要 |566| Pro | [使用クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans) が必要 | [使用クレジット](https://support.claude.com/ja/articles/12429409-extra-usage-for-paid-claude-plans) が必要 |

514| API と従量課金 | フルアクセス | フルアクセス |567| API と従量課金 | フルアクセス | フルアクセス |

515 568 

5161M コンテキストを完全に無効にするには、`CLAUDE_CODE_DISABLE_1M_CONTEXT=1` を設定します。これにより、1M モデルバリアントがモデルピッカーから削除されます。[環境変数](/ja/env-vars)を参照してください。5691M コンテキストを完全に無効にするには、`CLAUDE_CODE_DISABLE_1M_CONTEXT=1` を設定します。これにより、1M モデルバリアントがモデルピッカーから削除されます。[環境変数](/ja/env-vars) を参照してください。

517 570 

5181M コンテキストウィンドウは標準モデル価格を使用し、200K を超えるトークンに対するプレミアムはありません。拡張コンテキストがサブスクリプションに含まれているプランでは、使用量はサブスクリプションでカバーされたままです。拡張コンテキストに使用クレジットでアクセスするプランでは、トークンは使用クレジットに請求されます。5711M コンテキストウィンドウは標準モデル価格を使用し、200K を超えるトークンに対するプレミアムはありません。拡張コンテキストがサブスクリプションに含まれているプランでは、使用量はサブスクリプションでカバーされたままです。拡張コンテキストに使用クレジットでアクセスするプランでは、トークンは使用クレジットに請求されます。

519 572 


538 591 

539以下の 2 つの設定では、代わりにウィンドウが 200K として割り当てられ、その境界で自動コンパクトされます。592以下の 2 つの設定では、代わりにウィンドウが 200K として割り当てられ、その境界で自動コンパクトされます。

540 593 

541* **LLM ゲートウェイ**:`ANTHROPIC_BASE_URL` が[ゲートウェイ](/ja/llm-gateway)を指す場合、Claude Code は 1M サポートを検証できません。完全なウィンドウを使用するには、モデルピッカーで Sonnet 5 (1M context) を選択します。これは `sonnet[1m]` にマップされます。594* **LLM ゲートウェイ**:`ANTHROPIC_BASE_URL` が [ゲートウェイ](/ja/llm-gateway) を指す場合、Claude Code は 1M サポートを検証できません。完全なウィンドウを使用するには、モデルピッカーで Sonnet 5 (1M context) を選択します。これは `sonnet[1m]` にマップされます。

542* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**:コンテキストを制限する必要があるデプロイメント用に、Sonnet 5 セッションを 200K ウィンドウを持つものとして扱います。595* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**:コンテキストを制限する必要があるデプロイメント用に、Sonnet 5 セッションを 200K ウィンドウを持つものとして扱います。

543 596 

544<h2 id="checking-your-current-model">597<h2 id="checking-your-current-model">


588 サードパーティデプロイメント用のモデルのピン留め641 サードパーティデプロイメント用のモデルのピン留め

589</h3>642</h3>

590 643 

591[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 をデプロイする場合、ユーザーへのロールアウト前にモデルバージョンをピン留めします。644[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry)、または [Claude Platform on AWS](/ja/claude-platform-on-aws) を通じて Claude Code をデプロイする場合、ユーザーへのロールアウト前にモデルバージョンをピン留めします。

592 645 

593ピン留めなしでは、Claude Code は `fable`、`opus`、`sonnet`、`haiku` などのモデルエイリアスを使用し、各プロバイダーの組み込みデフォルトモデル ID に解決されます。そのデフォルトは最新の Anthropic リリースより遅れる可能性があり、それが指すモデルはまだユーザーのアカウントで有効になっていない可能性があります。デフォルトが利用できない場合、Bedrock と Vertex AI ユーザーは通知を見て、そのセッションの以前のバージョンにフォールバックしますが、Foundry ユーザーはエラーを見ます。Foundry には同等のスタートアップチェックがないためです。646ピン留めなしでは、Claude Code は `fable`、`opus`、`sonnet`、`haiku` などのモデルエイリアスを使用し、各プロバイダーの組み込みデフォルトモデル ID に解決されます。そのデフォルトは最新の Anthropic リリースより遅れる可能性があり、それが指すモデルはまだユーザーのアカウントで有効になっていない可能性があります。デフォルトが利用できない場合、Amazon Bedrock と Google Cloud の Agent Platform ユーザーは通知を見て、そのセッションの以前のバージョンにフォールバックしますが、Microsoft Foundry ユーザーはエラーを見ます。Microsoft Foundry には同等のスタートアップチェックがないためです。

594 647 

595<Warning>648<Warning>

596 初期セットアップの一部として、モデル環境変数を特定のバージョン ID に設定します。ピン留めにより、ユーザーが新しいモデルに移行するタイミングを制御できます。649 初期セットアップの一部として、モデル環境変数を特定のバージョン ID に設定します。ピン留めにより、ユーザーが新しいモデルに移行するタイミングを制御できます。


599プロバイダーのバージョン固有のモデル ID を使用して、以下の環境変数を使用します。652プロバイダーのバージョン固有のモデル ID を使用して、以下の環境変数を使用します。

600 653 

601| プロバイダー | 例 |654| プロバイダー | 例 |

602| :-------- | :------------------------------------------------------------------- |655| :---------------------------- | :------------------------------------------------------------------- |

603| Bedrock | `export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` |656| Amazon Bedrock | `export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'` |

604| Vertex AI | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |657| Google Cloud の Agent Platform | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

605| Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |658| Microsoft Foundry | `export ANTHROPIC_DEFAULT_OPUS_MODEL='claude-opus-4-8'` |

606 659 

607`ANTHROPIC_DEFAULT_FABLE_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL` に同じパターンを適用します。すべてのプロバイダー全体の現在および従来のモデル ID については、[モデル概要](https://platform.claude.com/docs/ja/about-claude/models/overview) を参照してください。ユーザーを新しいモデルバージョンにアップグレードするには、これらの環境変数を更新して再デプロイします。660`ANTHROPIC_DEFAULT_FABLE_MODEL`、`ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL` に同じパターンを適用します。すべてのプロバイダー全体の現在および従来のモデル ID については、[モデル概要](https://platform.claude.com/docs/ja/about-claude/models/overview) を参照してください。ユーザーを新しいモデルバージョンにアップグレードするには、これらの環境変数を更新して再デプロイします。

608 661 


616 669 

617* Claude Code は、モデル ID をプロバイダーに送信する前にサフィックスを削除します。670* Claude Code は、モデル ID をプロバイダーに送信する前にサフィックスを削除します。

618* 基盤となるモデルが [1M コンテキストをサポート](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window) する場合にのみ `[1m]` を追加します。671* 基盤となるモデルが [1M コンテキストをサポート](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window) する場合にのみ `[1m]` を追加します。

619* サフィックスはモデルごとではなく、変数ごとに読み取られます。Bedrock、Vertex、Foundry では、1 つの変数で `[1m]` なしのモデル ID は、別の変数が同じモデルをサフィックス付きで設定している場合でも、200K コンテキストを使用します。Sonnet 5 は常にこれらのプロバイダーで 1M ウィンドウで実行され、サフィックスは必要ありません。672* サフィックスはモデルごとではなく、変数ごとに読み取られます。Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry では、1 つの変数で `[1m]` なしのモデル ID は、別の変数が同じモデルをサフィックス付きで設定している場合でも、200K コンテキストを使用します。Sonnet 5 は常にこれらのプロバイダーで 1M ウィンドウで実行され、サフィックスは必要ありません。

620 673 

621<Note>674<Note>

622 `availableModels` アローリストは、サードパーティプロバイダーを使用する場合でも適用されます。[サーバー管理設定はそこに配信されません](/ja/server-managed-settings#platform-availability)。フィルタリングは `opus` などのモデルエイリアス、`claude-opus-4-8` などのバージョンプレフィックス、または完全なプロバイダー形式のモデル ID で一致します。`us.anthropic.` などのプロバイダー固有のプレフィックスは削除されないため、特定のモデルを許可するには、ピッカーが表示する同じプロバイダー形式 ID をリストするか、[`modelOverrides`](#override-model-ids-per-version) を通じてマップします。任意の `[1m]` サフィックスはアローリストエントリと要求されたモデルの両方から削除されます。675 `availableModels` アローリストは、サードパーティプロバイダーを使用する場合でも適用されます。[サーバー管理設定はそこに配信されません](/ja/server-managed-settings#platform-availability)。フィルタリングは `opus` などのモデルエイリアス、`claude-opus-4-8` などのバージョンプレフィックス、または完全なプロバイダー形式のモデル ID で一致します。`us.anthropic.` などのプロバイダー固有のプレフィックスは削除されないため、特定のモデルを許可するには、ピッカーが表示する同じプロバイダー形式 ID をリストするか、[`modelOverrides`](#override-model-ids-per-version) を通じてマップします。任意の `[1m]` サフィックスはアローリストエントリと要求されたモデルの両方から削除されます。


628 681 

629サードパーティプロバイダーでモデルをピン留めする場合、プロバイダー固有の ID は `/model` ピッカーにそのまま表示され、Claude Code はモデルがサポートする機能を認識しない可能性があります。ピン留めされた各モデルの表示名と機能を宣言するコンパニオン環境変数でオーバーライドできます。682サードパーティプロバイダーでモデルをピン留めする場合、プロバイダー固有の ID は `/model` ピッカーにそのまま表示され、Claude Code はモデルがサポートする機能を認識しない可能性があります。ピン留めされた各モデルの表示名と機能を宣言するコンパニオン環境変数でオーバーライドできます。

630 683 

631これらの変数は、Bedrock、Vertex AI、Foundry などのサードパーティプロバイダーでのみ有効です。`ANTHROPIC_BASE_URL` が [LLM ゲートウェイ](/ja/llm-gateway) を指す場合、`_NAME` と `_DESCRIPTION` 変数も有効です。`api.anthropic.com` に直接接続する場合は効果がありません。684これらの変数は、Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry などのサードパーティプロバイダーでのみ有効です。`ANTHROPIC_BASE_URL` が [LLM ゲートウェイ](/ja/llm-gateway) を指す場合、`_NAME` と `_DESCRIPTION` 変数も有効です。`api.anthropic.com` に直接接続する場合は効果がありません。

632 685 

633| 環境変数 | 説明 |686| 環境変数 | 説明 |

634| ----------------------------------------------------- | -------------------------------------------------------------------------- |687| ----------------------------------------------------- | -------------------------------------------------------------------------- |


638 691 

639同じ `_NAME`、`_DESCRIPTION`、`_SUPPORTED_CAPABILITIES` サフィックスは `ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`、`ANTHROPIC_DEFAULT_FABLE_MODEL`、`ANTHROPIC_CUSTOM_MODEL_OPTION` で利用可能です。692同じ `_NAME`、`_DESCRIPTION`、`_SUPPORTED_CAPABILITIES` サフィックスは `ANTHROPIC_DEFAULT_SONNET_MODEL`、`ANTHROPIC_DEFAULT_HAIKU_MODEL`、`ANTHROPIC_DEFAULT_FABLE_MODEL`、`ANTHROPIC_CUSTOM_MODEL_OPTION` で利用可能です。

640 693 

641Claude Code は、モデル ID を既知のパターンと照合することで、[努力レベル](#adjust-effort-level) や [拡張思考](#extended-thinking) などの機能を有効にします。Bedrock ARN やカスタムデプロイメント名などのプロバイダー固有の ID は、これらのパターンと一致しないことが多く、サポートされている機能が無効のままになります。`_SUPPORTED_CAPABILITIES` を設定して、Claude Code にモデルが実際にサポートする機能を伝えます。694Claude Code は、モデル ID を既知のパターンと照合することで、[努力レベル](#adjust-effort-level) や [拡張思考](#extended-thinking) などの機能を有効にします。Amazon Bedrock ARN やカスタムデプロイメント名などのプロバイダー固有の ID は、これらのパターンと一致しないことが多く、サポートされている機能が無効のままになります。`_SUPPORTED_CAPABILITIES` を設定して、Claude Code にモデルが実際にサポートする機能を伝えます。

642 695 

643| 機能値 | 有効にするもの |696| 機能値 | 有効にするもの |

644| ---------------------- | ---------------------------------------------- |697| ---------------------- | ---------------------------------------------- |


651 704 

652`_SUPPORTED_CAPABILITIES` が設定されている場合、リストされた機能は有効になり、リストされていない機能はマッチングされたピン留めされたモデルに対して無効になります。変数が設定されていない場合、Claude Code はモデル ID に基づいた組み込み検出にフォールバックします。705`_SUPPORTED_CAPABILITIES` が設定されている場合、リストされた機能は有効になり、リストされていない機能はマッチングされたピン留めされたモデルに対して無効になります。変数が設定されていない場合、Claude Code はモデル ID に基づいた組み込み検出にフォールバックします。

653 706 

654この例では、Bedrock カスタムモデル ARN に Opus をピン留めし、フレンドリーな名前を設定し、その機能を宣言します。707この例では、Amazon Bedrock カスタムモデル ARN に Opus をピン留めし、フレンドリーな名前を設定し、その機能を宣言します。

655 708 

656```bash theme={null}709```bash theme={null}

657export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'710export ANTHROPIC_DEFAULT_OPUS_MODEL='arn:aws:bedrock:us-east-1:123456789012:custom-model/abc'


668 721 

669`modelOverrides` は個別の Anthropic モデル ID をプロバイダー固有の文字列にマップし、Claude Code がプロバイダーの API に送信します。ユーザーが `/model` ピッカーでマップされたモデルを選択すると、Claude Code は組み込みのデフォルトの代わりに設定された値を使用します。722`modelOverrides` は個別の Anthropic モデル ID をプロバイダー固有の文字列にマップし、Claude Code がプロバイダーの API に送信します。ユーザーが `/model` ピッカーでマップされたモデルを選択すると、Claude Code は組み込みのデフォルトの代わりに設定された値を使用します。

670 723 

671これにより、エンタープライズ管理者は、ガバナンス、コスト配分、または地域的なルーティングのために、各モデルバージョンを特定の Bedrock 推論プロファイル ARN、Vertex AI バージョン名、または Foundry デプロイメント名にルーティングできます。724これにより、エンタープライズ管理者は、ガバナンス、コスト配分、または地域的なルーティングのために、各モデルバージョンを特定の Amazon Bedrock 推論プロファイル ARN、Google Cloud の Agent Platform バージョン名、または Microsoft Foundry デプロイメント名にルーティングできます。

672 725 

673[設定ファイル](/ja/settings#settings-files) で `modelOverrides` を設定します。726[設定ファイル](/ja/settings#settings-files) で `modelOverrides` を設定します。

674 727 


684 737 

685キーは [モデル概要](https://platform.claude.com/docs/ja/about-claude/models/overview) にリストされている Anthropic モデル ID である必要があります。日付付きモデル ID の場合、そこに表示されるとおりに日付サフィックスを含めます。不明なキーは無視されます。738キーは [モデル概要](https://platform.claude.com/docs/ja/about-claude/models/overview) にリストされている Anthropic モデル ID である必要があります。日付付きモデル ID の場合、そこに表示されるとおりに日付サフィックスを含めます。不明なキーは無視されます。

686 739 

687オーバーライドは、`/model` ピッカーの各エントリをサポートする組み込みモデル ID を置き換えます。Bedrock では、オーバーライドは Claude Code が起動時に自動的に検出する推論プロファイルより優先されます。`ANTHROPIC_MODEL`、`--model`、または `ANTHROPIC_DEFAULT_*_MODEL` 環境変数を通じて直接提供される値は、プロバイダーにそのまま渡され`modelOverrides` によって変換されません740オーバーライドは、`/model` ピッカーの各エントリをサポートする組み込みモデル ID を置き換えます。Amazon Bedrock では、`modelOverrides` エントリは Claude Code が起動時に自動的に検出する推論プロファイルより優先されます。Claude Code Amazon Bedrock 推論プロファイル ARN や Microsoft Foundry デプロイメント名などのプロバイダーネイティブである値をプロバイダーにそのまま渡します

741 

742{/* min-version: 2.1.200 */}オーバーライドは、`--model`、`ANTHROPIC_MODEL` 環境変数、または `ANTHROPIC_DEFAULT_*_MODEL` 環境変数を通じて Anthropic モデル ID を直接渡す場合にも適用されます。Amazon Bedrock、Google Cloud の Agent Platform、[Mantle](/ja/amazon-bedrock#use-the-mantle-endpoint) では、`modelOverrides` エントリのない Anthropic モデル ID は、プロバイダーがそのバージョンをサポートしている場合、`/model` ピッカー行のそのバージョンと同じプロバイダー固有の ID に解決されます。Mantle はバージョンのサブセットをサポートしています。そのサブセット外の Anthropic モデル ID の場合、Claude Code は `modelOverrides` エントリでカバーされていない限り、生の ID を Mantle に送信します。v2.1.200 より前では、`--model` と環境変数の値はオーバーライドマップを通さずにプロバイダーに到達しました。

688 743 

689`modelOverrides` は `availableModels` と一緒に機能します。アローリストは Anthropic モデル ID に対して評価され、オーバーライド値に対してではないため、`availableModels` の `"opus"` などのエントリは、Opus バージョンが ARN にマップされている場合でも一致し続けます。`enforceAvailableModels` が管理設定で設定されている場合、強制されたデフォルトは [最も優先度の高い管理ソース](/ja/server-managed-settings#settings-precedence) からのみ `modelOverrides` を通じて解決されます。推論プロファイル ARN にピン留めされたバージョンなど、管理者のマッピングは強制されたデフォルトで尊重されます。ユーザーまたはプロジェクト設定からのオーバーライドはそれに影響しません。744`modelOverrides` は `availableModels` と一緒に機能します。アローリストは Anthropic モデル ID に対して評価され、オーバーライド値に対してではないため、`availableModels` の `"opus"` などのエントリは、Opus バージョンが ARN にマップされている場合でも一致し続けます。`enforceAvailableModels` が管理設定で設定されている場合、強制されたデフォルトは [最も優先度の高い管理ソース](/ja/server-managed-settings#settings-precedence) からのみ `modelOverrides` を通じて解決されます。推論プロファイル ARN にピン留めされたバージョンなど、管理者のマッピングは強制されたデフォルトで尊重されます。ユーザーまたはプロジェクト設定からのオーバーライドはそれに影響しません。

690 745 

746{/* min-version: 2.1.200 */}`availableModels` が [管理設定](/ja/settings#settings-files) で設定されている場合、`--model` または上記の環境変数を通じて直接渡された Anthropic モデル ID には、その管理ソースからの `modelOverrides` のみが適用されます。Claude Code はユーザーまたはプロジェクト設定のオーバーライドをそれらの ID に対して無視し、管理リストが除外する ID を任意の設定ソースからの `modelOverrides` を通じて解決することはありません。この管理ソース制限には Claude Code v2.1.200 以降が必要です。ブロックされた ID がどのように処理されるかについては、[モデル選択の制限](#restrict-model-selection) を参照してください。

747 

691<h3 id="prompt-caching-configuration">748<h3 id="prompt-caching-configuration">

692 プロンプトキャッシング設定749 プロンプトキャッシング設定

693</h3>750</h3>

Details

94| `OTEL_LOGS_EXPORT_INTERVAL` | ログエクスポート間隔 (ミリ秒単位、デフォルト: 5000) | `1000`、`10000` |94| `OTEL_LOGS_EXPORT_INTERVAL` | ログエクスポート間隔 (ミリ秒単位、デフォルト: 5000) | `1000`、`10000` |

95| `OTEL_LOG_USER_PROMPTS` | ユーザープロンプトコンテンツのログを有効にする (デフォルト: 無効) | `1` で有効化 |95| `OTEL_LOG_USER_PROMPTS` | ユーザープロンプトコンテンツのログを有効にする (デフォルト: 無効) | `1` で有効化 |

96| `OTEL_LOG_ASSISTANT_RESPONSES` | `assistant_response` イベントでアシスタント応答テキストのログを有効にする (デフォルト: 無効)。設定されていない場合、`OTEL_LOG_USER_PROMPTS` の値にフォールバックします。{/* min-version: 2.1.193 */}Claude Code v2.1.193 以降が必要です | `1` で有効化、`0` でマスク状態を保持 |96| `OTEL_LOG_ASSISTANT_RESPONSES` | `assistant_response` イベントでアシスタント応答テキストのログを有効にする (デフォルト: 無効)。設定されていない場合、`OTEL_LOG_USER_PROMPTS` の値にフォールバックします。{/* min-version: 2.1.193 */}Claude Code v2.1.193 以降が必要です | `1` で有効化、`0` でマスク状態を保持 |

97| `OTEL_LOG_TOOL_DETAILS` | ツールイベントでツールパラメーターと入力引数のログを有効にする: Bash コマンド、MCP サーバーとツール名、スキル名、ツール入力。また、`user_prompt` イベントでカスタム、プラグイン、MCP コマンド名を有効にします (デフォルト: 無効) | `1` で有効化 |97| `OTEL_LOG_TOOL_DETAILS` | ツールイベントでツールパラメーターと入力引数のログを有効にする: Bash コマンド、MCP サーバーとツール名、スキル名、ユーザー作成ワークフロー名、ツール入力。また、`user_prompt` イベントでカスタム、プラグイン、MCP コマンド名を有効にします (デフォルト: 無効) | `1` で有効化 |

98| `OTEL_LOG_TOOL_CONTENT` | スパンイベントでツール入力と出力コンテンツのログを有効にする (デフォルト: 無効)。[トレース](#traces-beta)が必要です。コンテンツは 60 KB で切り詰められます | `1` で有効化 |98| `OTEL_LOG_TOOL_CONTENT` | スパンイベントでツール入力と出力コンテンツのログを有効にする (デフォルト: 無効)。[トレース](#traces-beta)が必要です。コンテンツは 60 KB で切り詰められます | `1` で有効化 |

99| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストとレスポンス JSON 全体を `api_request_body` / `api_response_body` ログイベントとして出力します (デフォルト: 無効)。ボディには会話履歴全体が含まれます。これを有効にすることは、`OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、および `OTEL_LOG_TOOL_CONTENT` が明かすすべてのものに同意することを意味します | `1` で 60 KB で切り詰められたインラインボディ、または `file:<dir>` でディスク上の切り詰められていないボディと、イベント内の `body_ref` ポインター |99| `OTEL_LOG_RAW_API_BODIES` | Anthropic Messages API リクエストとレスポンス JSON 全体を `api_request_body` / `api_response_body` ログイベントとして出力します (デフォルト: 無効)。ボディには会話履歴全体が含まれます。これを有効にすることは、`OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_DETAILS`、および `OTEL_LOG_TOOL_CONTENT` が明かすすべてのものに同意することを意味します | `1` で 60 KB で切り詰められたインラインボディ、または `file:<dir>` でディスク上の切り詰められていないボディと、イベント内の `body_ref` ポインター |

100| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | メトリクスの時間性設定 (デフォルト: `delta`)。バックエンドが累積時間性を期待する場合は `cumulative` に設定 | `delta`、`cumulative` |100| `OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE` | メトリクスの時間性設定 (デフォルト: `delta`)。バックエンドが累積時間性を期待する場合は `cumulative` に設定 | `delta`、`cumulative` |


191**`claude_code.llm_request`**191**`claude_code.llm_request`**

192 192 

193| 属性 | 説明 | ゲート |193| 属性 | 説明 | ゲート |

194| -------------------------------- | -------------------------------------------------------------------------------------------------------- | --- |194| -------------------------------- | -------------------------------------------------------------------------------------------------------- | ----------------------- |

195| `model` | モデル識別子 | |195| `model` | モデル識別子 | |

196| `gen_ai.system` | 常に `anthropic`。OpenTelemetry GenAI セマンティック規約 | |196| `gen_ai.system` | 常に `anthropic`。OpenTelemetry GenAI セマンティック規約 | |

197| `gen_ai.request.model` | `model` と同じ値。OpenTelemetry GenAI セマンティック規約 | |197| `gen_ai.request.model` | `model` と同じ値。OpenTelemetry GenAI セマンティック規約 | |

198| `query_source` | リクエストを発行したサブシステム。例: `repl_main_thread` またはサブエージェント名 | |198| `query_source` | リクエストを発行したサブシステム。例: `repl_main_thread` またはサブエージェント名 | |

199| `agent_id` | リクエストを発行したサブエージェントまたはチームメイトの識別子。メインセッションでは存在しません | |199| `agent_id` | リクエストを発行したサブエージェントまたはチームメイトの識別子。メインセッションでは存在しません | |

200| `parent_agent_id` | このエージェントを生成したエージェントの識別子。メインセッションおよびそこから直接生成されたエージェントでは存在しません | |200| `parent_agent_id` | このエージェントを生成したエージェントの識別子。メインセッションおよびそこから直接生成されたエージェントでは存在しません | |

201| `workflow.run_id` | このエージェントを生成した [Workflow](/ja/workflows) ツール実行の実行識別子。`wf_` で始まります。ワークフローによって生成されていないエージェントでは存在しません | |

202| `workflow.name` | このエージェントを生成したワークフローの名前。ユーザー作成名はゲートが設定されていない限り `custom` に置き換えられます | `OTEL_LOG_TOOL_DETAILS` |

201| `speed` | `fast` または `normal` | |203| `speed` | `fast` または `normal` | |

202| `llm_request.context` | 親スパンに応じて `interaction`、`tool`、または `standalone` | |204| `llm_request.context` | 親スパンに応じて `interaction`、`tool`、または `standalone` | |

203| `duration_ms` | 再試行を含む実時間 | |205| `duration_ms` | 再試行を含む実時間 | |


228| `result_tokens` | ツール結果のおおよそのトークンサイズ | |230| `result_tokens` | ツール結果のおおよそのトークンサイズ | |

229| `agent_id` | ツールを実行したサブエージェントまたはチームメイトの識別子。メインセッションでは存在しません | |231| `agent_id` | ツールを実行したサブエージェントまたはチームメイトの識別子。メインセッションでは存在しません | |

230| `parent_agent_id` | このエージェントを生成したエージェントの識別子。メインセッションおよびそこから直接生成されたエージェントでは存在しません | |232| `parent_agent_id` | このエージェントを生成したエージェントの識別子。メインセッションおよびそこから直接生成されたエージェントでは存在しません | |

233| `workflow.run_id` | このエージェントを生成した Workflow ツール実行の実行識別子。`wf_` で始まります。ワークフローによって生成されていないエージェントでは存在しません | |

234| `workflow.name` | このエージェントを生成したワークフローの名前。ユーザー作成名はゲートが設定されていない限り `custom` に置き換えられます | `OTEL_LOG_TOOL_DETAILS` |

231| `tool_use_id` | このコールのモデルの `tool_use` ブロック ID。[tool\_result](#tool-result-event) および [tool\_decision](#tool-decision-event) イベントおよびフックペイロード内の `tool_use_id` と一致するため、スパンをこれらのレコードに結合できます | |235| `tool_use_id` | このコールのモデルの `tool_use` ブロック ID。[tool\_result](#tool-result-event) および [tool\_decision](#tool-decision-event) イベントおよびフックペイロード内の `tool_use_id` と一致するため、スパンをこれらのレコードに結合できます | |

232| `gen_ai.tool.call.id` | `tool_use_id` と同じ値。OpenTelemetry GenAI セマンティック規約 | |236| `gen_ai.tool.call.id` | `tool_use_id` と同じ値。OpenTelemetry GenAI セマンティック規約 | |

233| `file_path` | Read、Edit、Write ツールのターゲットファイルパス | `OTEL_LOG_TOOL_DETAILS` |237| `file_path` | Read、Edit、Write ツールのターゲットファイルパス | `OTEL_LOG_TOOL_DETAILS` |


309 313 

310ヘルパーが失敗するか、これらの要件を満たさない出力を出力する場合、Claude Code は以下のエラーを報告します:314ヘルパーが失敗するか、これらの要件を満たさない出力を出力する場合、Claude Code は以下のエラーを報告します:

311 315 

312* `/doctor` 出力316* `/status` 出力

313* [`--debug`](/ja/cli-reference#cli-flags) で実行するか、セッション内で `/debug` を実行した後のデバッグログ317* [`--debug`](/ja/cli-reference#cli-flags) で実行するか、セッション内で `/debug` を実行した後のデバッグログ

314* stderr、`-p` で開始された非対話型セッション内318* stderr、`-p` で開始された非対話型セッション内

315 319 


443 447 

444* `prompt.id`: ユーザープロンプトを次のプロンプトまでのすべての後続イベントと相関させる UUID。[イベント相関属性](#event-correlation-attributes)を参照してください。448* `prompt.id`: ユーザープロンプトを次のプロンプトまでのすべての後続イベントと相関させる UUID。[イベント相関属性](#event-correlation-attributes)を参照してください。

445* `workspace.host_paths`: デスクトップアプリで選択されたホストワークスペースディレクトリ (文字列配列として)449* `workspace.host_paths`: デスクトップアプリで選択されたホストワークスペースディレクトリ (文字列配列として)

450* `workflow.run_id`: 実行識別子。プレフィックス `wf_` が付いており、API とツールイベントで出力されます。[Workflow](/ja/workflows) ツール実行に属するエージェントによって出力されます。1 つの `workflow.run_id` でイベントをフィルタリングすると、その実行の API リクエストとツール結果が再構成されます。識別子は、ワークフロースクリプトがスポーンするエージェントと、それらがスポーンするエージェント (スキル呼び出しなど) をカバーします。Workflow ツール結果で報告される実行識別子と一致します。他のすべてのイベントには存在しません。{/* min-version: 2.1.202 */}Claude Code v2.1.202 以降が必要です

451* `workflow.name`: ワークフローの名前。スクリプトの `meta.name`。`workflow.run_id` と一緒に出力されます。組み込みワークフロー名は、実行が変更されていない組み込みスクリプトを実行する場合、そのまま表示されます。ユーザー作成の名前 (組み込みスクリプトの編集されたコピーを含む) は、`OTEL_LOG_TOOL_DETAILS=1` が設定されていない限り `custom` に置き換えられます。{/* min-version: 2.1.202 */}Claude Code v2.1.202 以降が必要です

446 452 

447<h3 id="metrics">453<h3 id="metrics">

448 メトリクス454 メトリクス


884 内部エラーイベント890 内部エラーイベント

885</h4>891</h4>

886 892 

887Claude Code が予期しない内部エラーをキャッチするときにログされます。エラークラス名と errno スタイルコードのみが記録されます。エラーメッセージとスタックトレースは含まれません。このイベントは、Bedrock、Vertex、Foundry に対して実行している場合、または `DISABLE_ERROR_REPORTING` が設定されている場合は出力されません。893Claude Code が予期しない内部エラーをキャッチするときにログされます。エラークラス名と errno スタイルコードのみが記録されます。エラーメッセージとスタックトレースは含まれません。このイベントは、Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry に対して実行している場合、または `DISABLE_ERROR_REPORTING` が設定されている場合は出力されません。

888 894 

889**イベント名**: `claude_code.internal_error`895**イベント名**: `claude_code.internal_error`

890 896 


1163* `skill.name`、`plugin.name`、および `agent.name` 属性を介して、特定のスキル、プラグイン、またはサブエージェントタイプへの支出を属性付けする1169* `skill.name`、`plugin.name`、および `agent.name` 属性を介して、特定のスキル、プラグイン、またはサブエージェントタイプへの支出を属性付けする

1164 1170 

1165<Note>1171<Note>

1166 コストメトリクスは概算です。公式な請求データについては、API プロバイダー (Claude Console、Amazon Bedrock、または Google Cloud Vertex) を参照してください。1172 コストメトリクスは概算です。公式な請求データについては、API プロバイダー (Claude Console、Amazon Bedrock、または Google Cloud の Agent Platform) を参照してください。

1167</Note>1173</Note>

1168 1174 

1169<h3 id="alerting-and-segmentation">1175<h3 id="alerting-and-segmentation">


1217 1223 

1218MCP ツール呼び出し、Bash コマンド、ファイル編集は、セッションを開始した開発者に属性付けられます。Claude Code は個別のサービスアカウントの下では機能しません。各イベントに記録される ID は、開発者自身の Claude アカウント、または [Claude apps gateway](/ja/claude-apps-gateway) セッションでの開発者の IdP ID です。1224MCP ツール呼び出し、Bash コマンド、ファイル編集は、セッションを開始した開発者に属性付けられます。Claude Code は個別のサービスアカウントの下では機能しません。各イベントに記録される ID は、開発者自身の Claude アカウント、または [Claude apps gateway](/ja/claude-apps-gateway) セッションでの開発者の IdP ID です。

1219 1225 

1220Claude Code が直接 API キーで認証する場合、または Bedrock、Vertex AI、または Microsoft Foundry に対して認証する場合、セッションに Claude アカウントはなく、`user.id` と `session.id` のみが入力されます。これらのデプロイメントでは、`OTEL_RESOURCE_ATTRIBUTES` を使用してユーザー ID を自分で添付し、[管理設定](#administrator-configuration) ファイルまたはローンチラッパーを通じてユーザーごとに設定します。Claude apps gateway セッションはこれを必要としません:CLI は [標準属性](#standard-attributes) で説明されているように、IdP ID を自動的にスタンプします。1226Claude Code が直接 API キーで認証する場合、または Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry に対して認証する場合、セッションに Claude アカウントはなく、`user.id` と `session.id` のみが入力されます。これらのデプロイメントでは、`OTEL_RESOURCE_ATTRIBUTES` を使用してユーザー ID を自分で添付し、[管理設定](#administrator-configuration) ファイルまたはローンチラッパーを通じてユーザーごとに設定します。Claude apps gateway セッションはこれを必要としません:CLI は [標準属性](#standard-attributes) で説明されているように、IdP ID を自動的にスタンプします。

1221 1227 

1222```bash theme={null}1228```bash theme={null}

1223export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."1229export OTEL_RESOURCE_ATTRIBUTES="enduser.id=jdoe@example.com,enduser.directory_id=S-1-5-21-..."


1352 Amazon Bedrock での Claude Code の監視1358 Amazon Bedrock での Claude Code の監視

1353</h2>1359</h2>

1354 1360 

1355Amazon Bedrock での Claude Code 使用状況監視ガイダンスの詳細については、[Claude Code 監視実装 (Bedrock)](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)を参照してください。1361Amazon Bedrock での Claude Code 使用状況監視ガイダンスの詳細については、[Claude Code 監視実装(Amazon Bedrock](https://github.com/aws-solutions-library-samples/guidance-for-claude-code-with-amazon-bedrock/blob/main/assets/docs/MONITORING.md)を参照してください。

Details

110export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"110export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"

111```111```

112 112 

113Claude Code はスタートアップ時に証明書とキーファイルを読み込み、セッション中の設定変更を含め、設定を適用するたびにそれらを再度読み込みます。証明書とキーをローテーションするには、同じパスのファイルを置き換えます。

114 

113<h2 id="network-access-requirements">115<h2 id="network-access-requirements">

114 ネットワークアクセス要件116 ネットワークアクセス要件

115</h2>117</h2>


131 133 

132Claude Code はデフォルトでオプションの運用テレメトリを送信します。これは環境変数で無効にできます。ホワイトリストを最終化する前に、[テレメトリサービス](/ja/data-usage#telemetry-services) を参照して無効にする方法を確認してください。134Claude Code はデフォルトでオプションの運用テレメトリを送信します。これは環境変数で無効にできます。ホワイトリストを最終化する前に、[テレメトリサービス](/ja/data-usage#telemetry-services) を参照して無効にする方法を確認してください。

133 135 

134[Amazon Bedrock](/ja/amazon-bedrock)、[Google Vertex AI](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry)、または署名済みの [Claude apps gateway](/ja/claude-apps-gateway) セッションを使用する場合、モデルトラフィックと認証は `api.anthropic.com`、`claude.ai`、または `platform.claude.com` ではなくプロバイダーまたはゲートウェイに送信されます。WebFetch ツールは、[settings](/ja/settings) で `skipWebFetchPreflight: true` を設定しない限り、[ドメイン安全性チェック](/ja/data-usage#webfetch-domain-safety-check) のために `api.anthropic.com` を呼び出します。136[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry)、または署名済みの [Claude apps gateway](/ja/claude-apps-gateway) セッションを使用する場合、モデルトラフィックと認証は `api.anthropic.com`、`claude.ai`、または `platform.claude.com` ではなくプロバイダーまたはゲートウェイに送信されます。WebFetch ツールは、[settings](/ja/settings) で `skipWebFetchPreflight: true` を設定しない限り、[ドメイン安全性チェック](/ja/data-usage#webfetch-domain-safety-check) のために `api.anthropic.com` を呼び出します。

135 137 

136[Claude Code on the web](/ja/claude-code-on-the-web) および [Code Review](/ja/code-review) は、Anthropic が管理するインフラストラクチャからリポジトリに接続します。GitHub Enterprise Cloud 組織が IP アドレスによるアクセスを制限している場合は、[インストール済み GitHub Apps の IP 許可リスト継承を有効にします](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)。Claude GitHub App は IP 範囲を登録するため、この設定を有効にするとマニュアル設定なしでアクセスが可能になります。代わりに[範囲を許可リストに手動で追加する](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address)場合、または他のファイアウォールを設定する場合は、[Anthropic API IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses) を参照してください。138[Claude Code on the web](/ja/claude-code-on-the-web) および [Code Review](/ja/code-review) は、Anthropic が管理するインフラストラクチャからリポジトリに接続します。GitHub Enterprise Cloud 組織が IP アドレスによるアクセスを制限している場合は、[インストール済み GitHub Apps の IP 許可リスト継承を有効にします](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps)。Claude GitHub App は IP 範囲を登録するため、この設定を有効にするとマニュアル設定なしでアクセスが可能になります。代わりに[範囲を許可リストに手動で追加する](https://docs.github.com/en/enterprise-cloud@latest/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address)場合、または他のファイアウォールを設定する場合は、[Anthropic API IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses) を参照してください。

137 139 

overview.md +3 −3

Details

12 はじめに12 はじめに

13</h2>13</h2>

14 14 

15環境を選択してはじめましょう。ほとんどのサーフェスには [Claude サブスクリプション](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing)または [Anthropic Console](https://console.anthropic.com/) アカウントが必要です。Terminal CLI と VS Code は [サードパーティプロバイダー](/ja/third-party-integrations)もサポートしています。15Claude Code は複数のサーフェスで実行されますターミナル、IDE 拡張機能、デスクトップアプリ、Web です。下のタブから 1 つを選択してはじめましょう。ほとんどのサーフェスには [Claude サブスクリプション](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=overview_pricing)または [Anthropic Console](https://console.anthropic.com/) アカウントが必要です。Terminal CLI と VS Code は [サードパーティプロバイダー](/ja/third-party-integrations)もサポートしています。

16 16 

17<Tabs>17<Tabs>

18 <Tab title="Terminal">18 <Tab title="Terminal">


221 Claude Code をどこでも使用する221 Claude Code をどこでも使用する

222</h2>222</h2>

223 223 

224各サーフェスは同じ基盤となる Claude Code エンジンに接続するため、CLAUDE.md ファイル、設定、MCP サーバーはすべてのサーフェスで機能します。224 [サーフェス](/ja/glossary#surface) は同じ基盤となる Claude Code エンジンに接続するため、CLAUDE.md ファイル、設定、MCP サーバーはすべてのサーフェスで機能します。

225 225 

226上記の [Terminal](/ja/quickstart)、[VS Code](/ja/vs-code)、[JetBrains](/ja/jetbrains)、[Desktop](/ja/desktop)、[Web](/ja/claude-code-on-the-web) 環境を超えて、Claude Code は CI/CD、チャット、ブラウザワークフローと統合します:226上記の [Terminal](/ja/quickstart)、[VS Code](/ja/vs-code)、[JetBrains](/ja/jetbrains)、[Desktop](/ja/desktop)、[Web](/ja/claude-code-on-the-web) サーフェスを超えて、Claude Code は CI/CD、チャット、ブラウザワークフローと統合します:

227 227 

228| 実現したいこと | 最適なオプション |228| 実現したいこと | 最適なオプション |

229| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |229| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |

Details

6 6 

7> Claude がファイルを編集またはコマンドを実行する前に確認するかどうかを制御します。CLI で Shift+Tab でモードをサイクルするか、VS Code、Desktop、claude.ai のモードセレクターを使用します。7> Claude がファイルを編集またはコマンドを実行する前に確認するかどうかを制御します。CLI で Shift+Tab でモードをサイクルするか、VS Code、Desktop、claude.ai のモードセレクターを使用します。

8 8 

9Claude がファイルを編集、シェルコマンドを実行、またはネットワークリクエストを行いたい場合、一時停止してアクションを承認するよう求めます。権限モードは、その一時停止がどのくらいの頻度で発生するかを制御します。選択するモードはセッションのフローを形作ります。デフォルトモードではアクションが来るたびにレビューし、より緩いモードでは Claude が長い中断のない作業を行い、完了時に報告できます。機密作業には監視を強化し、信頼できる方向性には中断を減らしてください。9Claude がファイルを編集、シェルコマンドを実行、またはネットワークリクエストを行いたい場合、一時停止してアクションを承認するよう求めます。権限モードは、その一時停止がどのくらいの頻度で発生するかを制御します。選択するモードはセッションのフローを形作ります。Manual モードではアクションが来るたびにレビューし、より緩いモードでは Claude が長い中断のない作業を行い、完了時に報告できます。機密作業には監視を強化し、信頼できる方向性には中断を減らしてください。

10 10 

11<h2 id="available-modes">11<h2 id="available-modes">

12 利用可能なモード12 利用可能なモード


16 16 

17| モード | 確認なしで実行されるもの | 最適な用途 |17| モード | 確認なしで実行されるもの | 最適な用途 |

18| :------------------------------------------------------------------ | :--------------------------------------------------------- | :---------------- |18| :------------------------------------------------------------------ | :--------------------------------------------------------- | :---------------- |

19| `default` | 読み取りのみ | 開始、機密作業 |19| `default` | 読み取りのみ。CLI と IDE 拡張機能では **Manual** とラベル付けされています | 開始、機密作業 |

20| [`acceptEdits`](#auto-approve-file-edits-with-acceptedits-mode) | 読み取り、ファイル編集、一般的なファイルシステムコマンド(`mkdir`、`touch`、`mv`、`cp` など) | レビュー中のコードの反復処理 |20| [`acceptEdits`](#auto-approve-file-edits-with-acceptedits-mode) | 読み取り、ファイル編集、一般的なファイルシステムコマンド(`mkdir`、`touch`、`mv`、`cp` など) | レビュー中のコードの反復処理 |

21| [`plan`](#analyze-before-you-edit-with-plan-mode) | 読み取りのみ | コードベースの探索、変更前 |21| [`plan`](#analyze-before-you-edit-with-plan-mode) | 読み取りのみ | コードベースの探索、変更前 |

22| [`auto`](#eliminate-prompts-with-auto-mode) | すべて、バックグラウンド安全チェック付き | 長時間タスク、プロンプト疲労の軽減 |22| [`auto`](#eliminate-prompts-with-auto-mode) | すべて、バックグラウンド安全チェック付き | 長時間タスク、プロンプト疲労の軽減 |

23| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | 事前承認済みツールのみ | ロックダウン CI とスクリプト |23| [`dontAsk`](#allow-only-pre-approved-tools-with-dontask-mode) | 事前承認済みツールのみ | ロックダウン CI とスクリプト |

24| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | すべて | 隔離されたコンテナと VM のみ |24| [`bypassPermissions`](#skip-all-checks-with-bypasspermissions-mode) | すべて | 隔離されたコンテナと VM のみ |

25 25 

26すべてのアクションをレビューするモードは、CLI、`claude --help`、VS Code と JetBrains 拡張機能では **Manual** という名前です。その設定値は `default` で、これは hooks と SDK 統合が使用するものです。CLI は値を入力する場所ならどこでも `manual` をエイリアスとして受け入れます。例えば `claude --permission-mode manual` または `"defaultMode": "manual"` です。Manual ラベルと `manual` エイリアスには Claude Code v2.1.200 以降が必要です。

27 

26`bypassPermissions` を除くすべてのモードで、[保護されたパス](#protected-paths)への書き込みは自動承認されることはなく、リポジトリ状態と Claude 独自の設定を偶発的な破損から保護します。28`bypassPermissions` を除くすべてのモードで、[保護されたパス](#protected-paths)への書き込みは自動承認されることはなく、リポジトリ状態と Claude 独自の設定を偶発的な破損から保護します。

27 29 

28モードはベースラインを設定します。[権限ルール](/ja/permissions#manage-permissions)を上に層状にして、特定のツールを事前承認またはブロックします。拒否ルールと明示的な確認ルールは `bypassPermissions` を含むすべてのモードで適用されます。許可ルールはそのモードでは効果がありません。他のすべてが既に承認されているためです。30モードはベースラインを設定します。[権限ルール](/ja/permissions#manage-permissions)を上に層状にして、特定のツールを事前承認またはブロックします。拒否ルールと明示的な確認ルールは `bypassPermissions` を含むすべてのモードで適用されます。許可ルールはそのモードでは効果がありません。他のすべてが既に承認されているためです。


35 37 

36<Tabs>38<Tabs>

37 <Tab title="CLI">39 <Tab title="CLI">

38 **セッション中**:`Shift+Tab` を押して `default` → `acceptEdits` → `plan` をサイクルします。現在のモードはステータスバーに表示されます。すべてのモードがデフォルトサイクルに含まれるわけではありません40 **セッション中**:`Shift+Tab` を押して `default` → `acceptEdits` → `plan` をサイクルします。現在のモードはステータスバーに表示されます。{/* min-version: 2.1.203 */}Manual モード(そのサイクルのデフォルト)は、グレーの `⏸ manual mode on` バッジを表示しますv2.1.203 より前では、ステータスバーは Manual モードでバッジを表示していませんでした。

41 

42 すべてのモードがデフォルトサイクルに含まれるわけではありません。

39 43 

40 * `auto`:アカウントが [auto モード要件](#eliminate-prompts-with-auto-mode)を満たす場合に表示されます。auto へのサイクルはオプトインプロンプトを表示し、それを受け入れるか、**いいえ、今後は聞かないでください** を選択して auto をサイクルから削除するまで続きます44 * `auto`:アカウントが [auto モード要件](#eliminate-prompts-with-auto-mode)を満たす場合に表示されます。auto へのサイクルは確認プロンプトなしでモードを切り替えます

41 * `bypassPermissions`:`--permission-mode bypassPermissions`、`--dangerously-skip-permissions`、または `--allow-dangerously-skip-permissions` で開始した後に表示されます。`--allow-` バリアントはモードをサイクルに追加しますが、アクティブ化しません45 * `bypassPermissions`:`--permission-mode bypassPermissions`、`--dangerously-skip-permissions`、または `--allow-dangerously-skip-permissions` で開始した後に表示されます。`--allow-` バリアントはモードをサイクルに追加しますが、アクティブ化しません

42 * `dontAsk`:サイクルに表示されることはありません。`--permission-mode dontAsk` で設定します46 * `dontAsk`:サイクルに表示されることはありません。`--permission-mode dontAsk` で設定します

43 47 


71 75 

72 | UI ラベル | モード |76 | UI ラベル | モード |

73 | :------ | :------------------ |77 | :------ | :------------------ |

74 | 編集前に確認 | `default` |78 | 手動 | `default` |

75 | 自動編集 | `acceptEdits` |79 | 自動編集 | `acceptEdits` |

76 | 計画モード | `plan` |80 | 計画モード | `plan` |

77 | 自動モード | `auto` |81 | 自動モード | `auto` |

78 | 権限をバイパス | `bypassPermissions` |82 | 権限をバイパス | `bypassPermissions` |

79 83 

80 自動モードは拡張機能設定で **Allow dangerously skip permissions** を有効にした後、モード指示器に表示されますがアカウントが [auto モードセクション](#eliminate-prompts-with-auto-mode)にリストされているすべての要件を満たすまで利用不可のままです。`claudeCode.initialPermissionMode` 設定は `auto` を受け入れません。デフォルトで自動モードで開始するには代わりに [ユーザー設定](/ja/settings#settings-files)で `defaultMode` を設定します。Claude Code はプロジェクトおよびローカル設定の `defaultMode: "auto"` を無視します84 v2.1.205 より前では拡張機能は `plan` Plan mode、`auto` Auto mode とラベル付けしていました

85 

86 自動モードは、アカウントが [auto モードセクション](#eliminate-prompts-with-auto-mode)にリストされているすべての要件を満たす場合、モード指示器に表示されます。`claudeCode.initialPermissionMode` 設定は `auto` を受け入れません。デフォルトで自動モードで開始するには、代わりに [ユーザー設定](/ja/settings#settings-files)で `defaultMode` を設定します。Claude Code はプロジェクトおよびローカル設定の `defaultMode: "auto"` を無視します。

81 87 

82 権限のバイパスもモード指示器に表示される前に **Allow dangerously skip permissions** トグルが必要です。88 権限をバイパスするには、拡張機能設定で **Allow dangerously skip permissions** トグルが必要です。その後、モード指示器に表示されます。

83 89 

84 拡張機能固有の詳細については、[VS Code ガイド](/ja/vs-code)を参照してください。90 拡張機能固有の詳細については、[VS Code ガイド](/ja/vs-code)を参照してください。

85 </Tab>91 </Tab>


89 </Tab>95 </Tab>

90 96 

91 <Tab title="Desktop">97 <Tab title="Desktop">

92 送信ボタンの横にあるモードセレクターを使用します。自動と権限のバイパスは Desktop 設定で有効にした後にのみ表示されます。[Desktop ガイド](/ja/desktop#choose-a-permission-mode)を参照してください。98 送信ボタンの横にあるモードセレクターを使用します。自動と権限をバイパスは Desktop 設定で有効にした後にのみ表示されます。[Desktop ガイド](/ja/desktop#choose-a-permission-mode)を参照してください。

93 </Tab>99 </Tab>

94 100 

95 <Tab title="Web and mobile">101 <Tab title="Web and mobile">

96 [claude.ai/code](https://claude.ai/code) のプロンプトボックスの横またはモバイルアプリのモードドロップダウンを使用します。権限プロンプトは承認のために claude.ai に表示されます。どのモードが表示されるかはセッションが実行される場所によります。102 [claude.ai/code](https://claude.ai/code) のプロンプトボックスの横またはモバイルアプリのモードドロップダウンを使用します。権限プロンプトは承認のために claude.ai に表示されます。どのモードが表示されるかはセッションが実行される場所によります。

97 103 

98 * **[Claude Code on the web](/ja/claude-code-on-the-web) のクラウドセッション**:編集を受け入れる、計画モード、および自動モード。編集を受け入れるはクラウド環境がモードに関係なくファイル編集を事前承認するためドロップダウンは権限を確認の代わりに編集を受け入れるを表示します。設定からの `defaultMode: "acceptEdits"` は依然として尊重されます。自動モードは組織がそれを許可し、選択されたモデルがそれをサポートする場合にのみ表示されます。権限のバイパスは利用できません104 * **[Claude Code on the web](/ja/claude-code-on-the-web) のクラウドセッション**:編集を受け入れる、計画モード、および自動モード。編集を受け入れるは `default` モードに対応します。クラウド環境はモードに関係なくファイル編集を事前承認するためドロップダウンは手動の代わりに編集を受け入れるを表示します。設定からの `defaultMode: "acceptEdits"` は依然として尊重されます。自動モードは組織がそれを許可し、選択されたモデルがそれをサポートする場合にのみ表示されます。権限をバイパスは利用できません

99 * **ローカルマシンの [Remote Control](/ja/remote-control) セッション**:権限を確認自動編集受け入れ、および計画モード。自動と権限のバイパスは利用できません105 * **ローカルマシンの [Remote Control](/ja/remote-control) セッション**:手動編集を受け入れる、および計画モード。アプリから自動と権限をバイパスを選択することはできません{/* min-version: 2.1.202 */}ドロップダウンはローカルセッションが実行されているモードを表示します。これにはターミナルから設定されたモードが含まれ、アプリまたはターミナルでモードが変更されると更新されます。唯一の例外は権限をバイパスです。セッションはそのモードを claude.ai に報告することはないため、ターミナルからそれに切り替えてもドロップダウンに表示される内容は変わりません。v2.1.202 より前では、`/remote-control` または `claude --remote-control` で接続されたセッションはモードをまったく報告しなかったため、claude.ai とモバイルアプリはセッションが実行されていないモードを表示する可能性がありました。不一致はラベルのみに影響しました。Claude Code は権限プロンプトをセッションの実際のモードから生成し、それらは依然としてアプリに表示されて承認されました。

100 106 

101 Remote Control の場合、ホストを起動するときに開始モードを設定することもできます。107 Remote Control の場合、ホストを起動するときに開始モードを設定することもできます。

102 108 


116 122 

117[PowerShell ツール](/ja/tools-reference#powershell-tool)が有効な場合、`acceptEdits` モードはスコープ内のパスに対して `Set-Content`、`Add-Content`、`Clear-Content`、`Remove-Item` も自動承認し、それらの一般的なエイリアスも承認します。同じスコープと保護されたパスのルールが適用されます。123[PowerShell ツール](/ja/tools-reference#powershell-tool)が有効な場合、`acceptEdits` モードはスコープ内のパスに対して `Set-Content`、`Add-Content`、`Clear-Content`、`Remove-Item` も自動承認し、それらの一般的なエイリアスも承認します。同じスコープと保護されたパスのルールが適用されます。

118 124 

119事実後にエディターまたは `git diff` 経由で変更をレビューしたい場合、各編集をインラインで承認するのではなく `acceptEdits` を使用します。デフォルトモードから `Shift+Tab` を 1 回押して入るか、直接開始します。125事実後にエディターまたは `git diff` 経由で変更をレビューしたい場合、各編集をインラインで承認するのではなく `acceptEdits` を使用します。Manual モードから `Shift+Tab` を 1 回押して入るか、直接開始します。

120 126 

121```bash theme={null}127```bash theme={null}

122claude --permission-mode acceptEdits128claude --permission-mode acceptEdits


126 計画モードで編集前に分析する132 計画モードで編集前に分析する

127</h2>133</h2>

128 134 

129計画モードは Claude に変更を加えずに調査と提案を行うよう指示します。Claude はファイルを読み、シェルコマンドを実行して探索し、計画を書きますが、ソースを編集しません。権限プロンプトはデフォルトモードと同じように適用されます135計画モードは Claude に変更を加えずに調査と提案を行うよう指示します。Claude はファイルを読み、シェルコマンドを実行して探索し、計画を書きますが、ソースを編集しません。権限プロンプトはマニュアルモードと同じように適用されます

130 136 

131`Shift+Tab` を押すか、単一のプロンプトに `/plan` をプレフィックスして計画モードに入ります。CLI から計画モードで開始することもできます。137`Shift+Tab` を押すか、単一のプロンプトに `/plan` をプレフィックスして計画モードに入ります。CLI から計画モードで開始することもできます。

132 138 


188 194 

189* **プラン**:すべてのプラン。195* **プラン**:すべてのプラン。

190* **所有者**:Team と Enterprise では、所有者がユーザーがオンにできるようにする前に [Claude Code 管理設定](https://claude.ai/admin-settings/claude-code) で有効にする必要があります。管理者は [管理設定](/ja/permissions#managed-settings) で `permissions.disableAutoMode` を `"disable"` に設定することでロックオフすることもできます。196* **所有者**:Team と Enterprise では、所有者がユーザーがオンにできるようにする前に [Claude Code 管理設定](https://claude.ai/admin-settings/claude-code) で有効にする必要があります。管理者は [管理設定](/ja/permissions#managed-settings) で `permissions.disableAutoMode` を `"disable"` に設定することでロックオフすることもできます。

191* **モデル**:Anthropic API では Claude Opus 4.6 以降、または Sonnet 4.6 以降。Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry、および署名済み [Claude apps gateway](/ja/claude-apps-gateway) セッションでは、Claude Sonnet 5、Opus 4.7、および Opus 4.8 のみ。Sonnet 4.5、Opus 4.5、Haiku、claude-3 モデルを含む古いモデルはどのプロバイダーでもサポートされていません。197* **モデル**:Anthropic API では Claude Opus 4.6 以降、または Sonnet 4.6 以降。Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry、および署名済み [Claude apps gateway](/ja/claude-apps-gateway) セッションでは、Claude Sonnet 5、Opus 4.7、および Opus 4.8 のみ。Sonnet 4.5、Opus 4.5、Haiku、claude-3 モデルを含む古いモデルはどのプロバイダーでもサポートされていません。

192* **プロバイダー**:Anthropic API ではデフォルトで利用可能です。Amazon Bedrock、Google Cloud Vertex AI、Microsoft Foundry、および署名済み Claude apps gateway セッションでは、[`CLAUDE_CODE_ENABLE_AUTO_MODE` を設定](#enable-auto-mode-on-bedrock-vertex-ai-or-foundry) するまで自動モードはオフです。198* **プロバイダー**:Anthropic API ではデフォルトで利用可能です。Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry、および署名済み Claude apps gateway セッションでは、[`CLAUDE_CODE_ENABLE_AUTO_MODE` を設定](#enable-auto-mode-on-bedrock-agent-platform-or-foundry) するまで自動モードはオフです。

193 199 

194Claude Code が自動モードを利用不可と報告する場合、これらの要件のいずれかが満たされていません。これは一時的な停止ではありません。モデルに名前を付けて自動モードが「アクションの安全性を判断できない」と言う別のメッセージは一時的な分類器停止です。[エラーリファレンス](/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action) を参照してください。200Claude Code が自動モードを利用不可と報告する場合、これらの要件のいずれかが満たされていません。これは一時的な停止ではありません。モデルに名前を付けて自動モードが「アクションの安全性を判断できない」と言う別のメッセージは一時的な分類器停止です。[エラーリファレンス](/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action) を参照してください。

195 201 

196[設定](/ja/settings#available-settings) で `defaultMode: "auto"` を設定し、セッションがエラーなしで `default` モードで開始する場合、設定は `.claude/settings.json` または `.claude/settings.local.json` にある可能性があります。Claude Code v2.1.142 以降はこれらのファイルから `auto` を無視するため、リポジトリは自動モードを自身に付与することはできません。`~/.claude/settings.json` に移動してください。202[設定](/ja/settings#available-settings) で `defaultMode: "auto"` を設定し、セッションがエラーなしで `default` モードで開始する場合、設定は `.claude/settings.json` または `.claude/settings.local.json` にある可能性があります。Claude Code v2.1.142 以降はこれらのファイルから `auto` を無視するため、リポジトリは自動モードを自身に付与することはできません。`~/.claude/settings.json` に移動してください。

197 203 

198<h3 id="enable-auto-mode-on-bedrock-vertex-ai-or-foundry">204<h3 id="enable-auto-mode-on-bedrock-agent-platform-or-foundry">

199 Bedrock、Vertex AI、または Foundry で自動モードを有効にする205 Bedrock、Agent Platform、または Foundry で自動モードを有効にする

200</h3>206</h3>

201 207 

202[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud Vertex AI](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry)、および署名済み [Claude apps gateway](/ja/claude-apps-gateway) セッションでは、`CLAUDE_CODE_ENABLE_AUTO_MODE` が `1` に設定されるまで自動モードは `Shift+Tab` サイクルに表示されません。変数は Claude Code v2.1.158 以降で機能します。これらのプロバイダーでは Claude Sonnet 5、Opus 4.7、および Opus 4.8 のみがサポートされています。208[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud Agent Platform](/ja/google-vertex-ai)、[Microsoft Foundry](/ja/microsoft-foundry)、および署名済み [Claude apps gateway](/ja/claude-apps-gateway) セッションでは、`CLAUDE_CODE_ENABLE_AUTO_MODE` が `1` に設定されるまで自動モードは `Shift+Tab` サイクルに表示されません。変数は Claude Code v2.1.158 以降で機能します。これらのプロバイダーでは Claude Sonnet 5、Opus 4.7、および Opus 4.8 のみがサポートされています。

203 209 

2041 人の開発者に対して有効にするには、`~/.claude/settings.json` の `env` ブロックに変数を追加します。2101 人の開発者に対して有効にするには、`~/.claude/settings.json` の `env` ブロックに変数を追加します。

205 211 


223 分類器がデフォルトでブロックするもの229 分類器がデフォルトでブロックするもの

224</h3>230</h3>

225 231 

226分類器は作業ディレクトリとリポジトリの設定されたリモートを信頼しますその他すべては [信頼できるインフラストラクチャを設定](/ja/auto-mode-config) するまで外部として扱われます232分類器は作業ディレクトリとセッション開始時に設定されたリモートを信頼します{/* min-version: 2.1.200 */}セッション中に `git remote add` または `git remote set-url` で追加またはリポイントされたリモートは信頼されず、[信頼できるインフラストラクチャを設定](/ja/auto-mode-config) するまで他のすべては外部として扱われますv2.1.200 より前では、セッション中に追加されたリモートも信頼されていました。

227 233 

228**デフォルトでブロック**:234**デフォルトでブロック**:

229 235 


234* IAM またはリポジトリ権限の付与240* IAM またはリポジトリ権限の付与

235* 共有インフラストラクチャの変更241* 共有インフラストラクチャの変更

236* セッション前に存在していたファイルを不可逆的に破壊242* セッション前に存在していたファイルを不可逆的に破壊

237* フォースプッシュ、または `main` への直接プッシュ243* フォースプッシュ

244* {/* min-version: 2.1.203 */}リポジトリのデフォルトブランチへのプッシュ。プッシュがシークレットや個人情報または信頼されたデータなどの機密コンテンツを含む場合、変更があなたが求めたものに対して隠蔽または誤表示されている場合、コンテンツがリポジトリ外からポートインまたは最初に読み込まれた場合、またはあなたが求めたプルリクエスト、レビュー、またはチェックの周りをルーティングする場合。デフォルトブランチへのプレーンプッシュはそれ自体ではブロックされず、フラグが立てられたプッシュをクリアするにはプッシュだけではなく、フラグが立てられたコンテンツまたはバイパスされたレビューに名前を付ける必要があります。分類器は 1 つのレイヤーです。[`permissions.deny` ルール](/ja/permissions#manage-permissions) はすべてのモードで適用され、デフォルトブランチへのプッシュを完全にブロックでき、リモート独自のブランチ保護は依然として適用されます。v2.1.203 より前では、デフォルトブランチへの直接プッシュはすべてブロックされていました

238* {/* min-version: 2.1.182 */}`git reset --hard`、`git checkout -- .`、`git restore .`、`git clean -fd`、`git stash drop`、または `git stash clear`。分類器はこれらがコミットされていない変更を破棄すると推定します245* {/* min-version: 2.1.182 */}`git reset --hard`、`git checkout -- .`、`git restore .`、`git clean -fd`、`git stash drop`、または `git stash clear`。分類器はこれらがコミットされていない変更を破棄すると推定します

239* `git commit --amend`。HEAD のコミットがこのセッションで作成されていない場合246* `git commit --amend`。HEAD のコミットがこのセッションで作成されていない場合

240* {/* min-version: 2.1.198 */}v2.1.198 から、`git commit --amend`。HEAD のコミットが既にプッシュされている場合。メッセージのみの言い換えはブロックされません。`--amend -m` で新たにステージされたものがなく、Claude がこのセッション中に作成したコミット上247* {/* min-version: 2.1.198 */}v2.1.198 から、`git commit --amend`。HEAD のコミットが既にプッシュされている場合。メッセージのみの言い換えはブロックされません。`--amend -m` で新たにステージされたものがなく、Claude がこのセッション中に作成したコミット上


261Claude Code v2.1.198 以降はこれらもデフォルトでブロックします。268Claude Code v2.1.198 以降はこれらもデフォルトでブロックします。

262 269 

263* `/tmp`、`$TMPDIR`、または別の共有スクラッチまたはキャッシュディレクトリ内のファイルを、特定の名前付きパスではなく、ワイルドカード、glob、または年齢フィルターで削除270* `/tmp`、`$TMPDIR`、または別の共有スクラッチまたはキャッシュディレクトリ内のファイルを、特定の名前付きパスではなく、ワイルドカード、glob、または年齢フィルターで削除

264* 自身のメッセージがその受信者にそれらの詳細を認可しなかった場合、送信、アップロード、公開、または他の人または共有システムに書き込まれるコンテンツに機密詳細を含める271* 自身のメッセージがその受信者にそれらの詳細を認可しなかった場合、送信、アップロード、公開、または他の人または共有システムに書き込まれるコンテンツに機密詳細を含める。{/* min-version: 2.1.200 */}PR およびイシュー本文、コミットメッセージ、およびコメントは、リポジトリが信頼境界外またはパブリックである場合、この種の送信コンテンツとしてカウントされます。組織独自のパブリックリポジトリを含む。内部ファイルパス、コード名、メールやアカウント識別子などのライブ API レスポンスデータ、およびインフラストラクチャ識別子は機密詳細としてカウントされます。PR、イシュー、およびコミットメッセージのスコープには Claude Code v2.1.200 以降が必要です。{/* min-version: 2.1.203 */}PR またはイシュー本文内のメールアドレス、アカウントまたは組織識別子、または使用メトリックなどのライブ個人データは、リポジトリの可視性または信頼境界に関係なく、それらの詳細と受信者に名前を付ける必要があります。そのチェックには Claude Code v2.1.203 以降が必要です

265* Claude Code 独自の tmux ペインにキーストロークを送信して独自のインターフェースを駆動。分類器はこれを Claude が独自の権限または監視を変更することとして扱います272* Claude Code 独自の tmux ペインにキーストロークを送信して独自のインターフェースを駆動。分類器はこれを Claude が独自の権限または監視を変更することとして扱います

266 273 

274Claude Code v2.1.200 以降はこれらもデフォルトでブロックします。

275 

276* セキュリティ動作を保護するテストまたはアサーションをコメントアウト、削除、または強制パス。例えば認証、アクセス制御、入力検証、またはサンドボックス

277* Claude がセッションで作成しなかった状態リソースの削除またはティアダウン。より具体的な削除ルールが適用されず、リソースに名前を付けなかった場合

278* API ベース URL、プロキシエンドポイント、webhook レシーバー、またはレジストリミラーを、タスクに適さない第三者ホストにリポイント。`.env.example` のようなサンプルファイルを含む

279* `git remote set-url` または `git remote add` でプッシュ先を変更。新しいリモートに名前を付けた場合を除く

280* パブリックであることが知られているリポジトリにシークレットをプッシュ、またはそのリポジトリ独自の作業の一部ではない他の機密または機密材料をプッシュ。{/* min-version: 2.1.203 */}ドットファイルリポジトリ独自の主題は個人情報または信頼されたデータの唯一の例外であり、プライベートリポジトリからのコンテンツがパブリックサーフェスに到達することは同じ方法でブロックされます。両方の改善には Claude Code v2.1.203 以降が必要です。v2.1.203 より前では、個人データは機密材料とグループ化され、そのリポジトリ独自の作業の一部ではない場合にのみブロックされていました。リポジトリの可視性が確立されていない場合、分類器はそれだけではブロックしません。代わりに他のルールに対してコンテンツを判断します

281* 異なるリポジトリまたは組織に対するプルリクエストを開く、`gh repo fork` でフォーク、または第三者リポジトリにプッシュ。外部ターゲットに名前を付けた場合を除く

282 

283Claude Code v2.1.203 以降はこれらもデフォルトでブロックします。

284 

285* 機密ローカルストアからのコンテンツ、またはファイル名、パス、またはタイプが機密としてマークしているファイルからのコンテンツ。コミット、プッシュ、PR またはイシューテキスト、gist またはペースト、またはパッケージ公開に入る。ソースと宛先の両方に名前を付けない限り。セッショントランスクリプトと会話ログ、SSH キー、クラウド認証情報、ブラウザプロファイル、シェル履歴などの認証情報と設定ドットフォルダ、およびユーザーデータエクスポートはすべてカウントされ、リポジトリがプライベートであることはそれをクリアしません

286 

287Claude Code v2.1.205 以降はこれらもデフォルトでブロックします。

288 

289* Claude Code セッショントランスクリプト、`~/.claude/projects/` の `.jsonl` 履歴ファイル、または設定ディレクトリへの書き込み。直接またはシェルコマンドを通じて。ルールはまた Claude Code が独自のチェック用に各トランスクリプトエントリに追加するメタデータ行もカバーします。トランスクリプトは Claude Code が書き込むセッション状態であり、作業ファイルではなく、改ざんされたエントリはセッションを再開すると後のすべてのチェックに到達するため、自動モードは防御の深さとしてこれらの書き込みをブロックします。トランスクリプトの読み取りはブロックされません

290* `rm -rf "$VAR"` または `Remove-Item -Recurse -Force $dir` のような再帰的な強制削除。ターゲットがシェル変数である場合、または分類器が見る会話のどこにも割り当てられていない変数に根ざしている glob。値は以前のコマンド出力からのみ来ており、分類器は決してコマンド出力を受け取らないため、分類器は削除ターゲットを他の削除ルールに対して検証できません。分類器は設計上、コマンド出力ではなく会話を読むため、推測する代わりにコールをブロックします。ブロックは削除されている正確なパスに名前を付けるか、Claude が削除をコマンドに書き込まれた解決済みリテラルパスで再実行するときにクリアされます。分類器が解決できるターゲットを持つ削除は影響を受けません

291 

267**デフォルトで許可**:292**デフォルトで許可**:

268 293 

269* 作業ディレクトリ内のローカルファイル操作294* 作業ディレクトリ内のローカルファイル操作

permissions.md +31 −5

Details

45Claude Code は、ツール呼び出しの承認方法を制御するいくつかの権限モードをサポートしています。[権限モード](/ja/permission-modes)を参照して、各モードをいつ使用するかを確認してください。[設定ファイル](/ja/settings#settings-files)で `defaultMode` を設定します。45Claude Code は、ツール呼び出しの承認方法を制御するいくつかの権限モードをサポートしています。[権限モード](/ja/permission-modes)を参照して、各モードをいつ使用するかを確認してください。[設定ファイル](/ja/settings#settings-files)で `defaultMode` を設定します。

46 46 

47| モード | 説明 |47| モード | 説明 |

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

49| `default` | 標準動作。各ツールの最初の使用時に権限を促します |49| `default` | 標準動作。各ツールの最初の使用時に権限を促します。{/* min-version: 2.1.200 */}CLI および VS Code と JetBrains 拡張機能では「Manual」とラベル付けされており、Claude Code は `manual` をエイリアスとして受け入れます。ラベルとエイリアスには Claude Code v2.1.200 以降が必要です |

50| `acceptEdits` | ファイル編集と一般的なファイルシステムコマンド(`mkdir`、`touch`、`mv`、`cp` など)を、作業ディレクトリまたは `additionalDirectories` 内のパスに対して自動的に受け入れます |50| `acceptEdits` | ファイル編集と一般的なファイルシステムコマンド(`mkdir`、`touch`、`mv`、`cp` など)を、作業ディレクトリまたは `additionalDirectories` 内のパスに対して自動的に受け入れます |

51| `plan` | Plan Mode。Claude はファイルを読み取り、読み取り専用シェルコマンドを実行して探索しますが、ソースファイルを編集しません |51| `plan` | Claude はファイルを読み取り、読み取り専用シェルコマンドを実行して探索しますが、ソースファイルを編集しません。CLI および VS Code 拡張機能では Plan とラベル付けされています |

52| `auto` | バックグラウンド安全チェック付きでツール呼び出しを自動承認し、アクションがリクエストと一致することを確認します。現在は研究プレビューです |52| `auto` | バックグラウンド安全チェック付きでツール呼び出しを自動承認し、アクションがリクエストと一致することを確認します。現在は研究プレビューです |

53| `dontAsk` | `/permissions` または `permissions.allow` ルールで事前に承認されていない限り、ツールを自動的に拒否します |53| `dontAsk` | `/permissions` または `permissions.allow` ルールで事前に承認されていない限り、ツールを自動的に拒否します |

54| `bypassPermissions` | 権限プロンプトをスキップします。ただし、明示的な `ask` ルールで強制されたプロンプトは除きます。ファイルシステムルートまたはホームディレクトリの削除(`rm -rf /` など)も回路遮断器として引き続きプロンプトを表示します |54| `bypassPermissions` | 権限プロンプトをスキップします。ただし、明示的な `ask` ルールで強制されたプロンプトは除きます。ファイルシステムルートまたはホームディレクトリの削除(`rm -rf /` など)も回路遮断器として引き続きプロンプトを表示します |


213 213 

214すべてのフラグが読み取り専用であるコマンドに対しては、引用符なしのグロブパターンが許可されるため、`ls *.ts` および `wc -l src/*.py` はプロンプトなしで実行されます。`find`、`sort`、`sed`、`git` などの書き込み可能または実行可能なフラグを持つコマンドは、グロブが `-delete` のようなフラグに展開される可能性があるため、引用符なしのグロブが存在する場合でもプロンプトを表示します。214すべてのフラグが読み取り専用であるコマンドに対しては、引用符なしのグロブパターンが許可されるため、`ls *.ts` および `wc -l src/*.py` はプロンプトなしで実行されます。`find`、`sort`、`sed`、`git` などの書き込み可能または実行可能なフラグを持つコマンドは、グロブが `-delete` のようなフラグに展開される可能性があるため、引用符なしのグロブが存在する場合でもプロンプトを表示します。

215 215 

216作業ディレクトリまたは[追加ディレクトリ](#working-directories)内のパスへの `cd` も読み取り専用です。`cd packages/api && ls` のような複合コマンドは、各部分が独立して適格である場合、プロンプトなしで実行されます。複合コマンドで `cd` と `git` を組み合わせると、ターゲットディレクトリに関係なく常にプロンプトが表示されます216作業ディレクトリまたは[追加ディレクトリ](#working-directories)内のパスへの `cd` も読み取り専用です。`cd packages/api && ls` のような複合コマンドは、各部分が独立して適格である場合、プロンプトなしで実行されます。複合コマンドで `cd` と `git` を組み合わせると、`cd` が異なるディレクトリに変更される場合、プロンプトが表示されますこれは、新しいディレクトリで `git` を実行するとそのディレクトリのフックを実行できるためです。ターゲットが現在の作業ディレクトリに解決される `cd` は、操作なしであり、このプロンプトをトリガーしません。

217 217 

218<Warning>218<Warning>

219 コマンド引数を制約しようとする Bash 権限パターンは脆弱です。たとえば、`Bash(curl http://github.com/ *)` は curl を GitHub URL に制限することを意図していますが、次のようなバリエーションにはマッチしません。219 コマンド引数を制約しようとする Bash 権限パターンは脆弱です。たとえば、`Bash(curl http://github.com/ *)` は curl を GitHub URL に制限することを意図していますが、次のようなバリエーションにはマッチしません。


228 228 

229 * **Bash ネットワークツールを制限する**:deny ルールを使用して `curl`、`wget` などのコマンドをブロックし、許可されたドメインに対して `WebFetch(domain:github.com)` 権限で WebFetch ツールを使用します229 * **Bash ネットワークツールを制限する**:deny ルールを使用して `curl`、`wget` などのコマンドをブロックし、許可されたドメインに対して `WebFetch(domain:github.com)` 権限で WebFetch ツールを使用します

230 * **PreToolUse フックを使用する**:Bash コマンドの URL を検証し、許可されていないドメインをブロックするフックを実装します230 * **PreToolUse フックを使用する**:Bash コマンドの URL を検証し、許可されていないドメインをブロックするフックを実装します

231 * **CLAUDE.md ガイダンスを追加する**:`CLAUDE.md` で Claude Code に許可された curl パターンについて説明します。これは Claude が試みることを形作りますが、境界を強制しないため、上記のオプションの 1 つと組み合わせてください231 * **CLAUDE.md ガイダンスを追加する**:`CLAUDE.md` で許可された curl パターンについて説明します。これは Claude が試みることを形作りますが、境界を強制しないため、上記のオプションの 1 つと組み合わせてください

232 232 

233 WebFetch のみを使用しても、ネットワークアクセスは防止されません。Bash が許可されている場合、Claude は `curl`、`wget` または他のツールを使用して任意の URL に到達できます。233 WebFetch のみを使用しても、ネットワークアクセスは防止されません。Bash が許可されている場合、Claude は `curl`、`wget` または他のツールを使用して任意の URL に到達できます。

234</Warning>234</Warning>


311 gitignore パターンでは、`*` は単一のディレクトリ内のファイルをマッチさせ、`**` はディレクトリ全体で再帰的にマッチさせます。すべてのファイルアクセスを許可するには、括弧なしでツール名を使用します。`Read`、`Edit`、または `Write`。311 gitignore パターンでは、`*` は単一のディレクトリ内のファイルをマッチさせ、`**` はディレクトリ全体で再帰的にマッチさせます。すべてのファイルアクセスを許可するには、括弧なしでツール名を使用します。`Read`、`Edit`、または `Write`。

312</Note>312</Note>

313 313 

314「はい、今後は聞かない」でファイルパスを承認すると、Claude Code は `[`、`]`、`*` などの gitignore パターン文字をそのパスでエスケープするため、生成されたルールは承認したリテラルパスのみをマッチさせます。自分で記述したルールはエスケープされません。v2.1.202 より前では、Claude Code はパスをエスケープなしで保存していたため、`[2024-06] Reports` という名前のディレクトリの生成されたルールは、独自のパスをマッチさせできなかったり、意図しない兄弟ディレクトリをマッチさせたりする可能性がありました。

315 

314Claude がシンボリックリンクにアクセスするとき、権限ルールは 2 つのパスをチェックします。シンボリックリンク自体と、それが解決するファイルです。Allow ルールと deny ルールはそのペアを異なる方法で扱います。allow ルールはプロンプトにフォールバックし、deny ルールは完全にブロックします。316Claude がシンボリックリンクにアクセスするとき、権限ルールは 2 つのパスをチェックします。シンボリックリンク自体と、それが解決するファイルです。Allow ルールと deny ルールはそのペアを異なる方法で扱います。allow ルールはプロンプトにフォールバックし、deny ルールは完全にブロックします。

315 317 

316* **Allow ルール**:シンボリックリンクパスとそのターゲットの両方がマッチする場合にのみ適用されます。許可されたディレクトリ内のシンボリックリンクがそれの外を指している場合でも、プロンプトが表示されます。318* **Allow ルール**:シンボリックリンクパスとそのターゲットの両方がマッチする場合にのみ適用されます。許可されたディレクトリ内のシンボリックリンクがそれの外を指している場合でも、プロンプトが表示されます。


503 505 

504埋め込みホストは、[`parentSettingsBehavior`](/ja/settings#settings-precedence)が `"merge"` に設定されている場合、SDK の `managedSettings` オプションを介して追加の管理ポリシーを提供できます。埋め込み元の値はポリシーを厳しくできますが、緩和することはできません。506埋め込みホストは、[`parentSettingsBehavior`](/ja/settings#settings-precedence)が `"merge"` に設定されている場合、SDK の `managedSettings` オプションを介して追加の管理ポリシーを提供できます。埋め込み元の値はポリシーを厳しくできますが、緩和することはできません。

505 507 

508<h2 id="project-allow-rules-and-workspace-trust">

509 プロジェクトの許可ルールとワークスペーストラスト

510</h2>

511 

512プロジェクトの `.claude/settings.json` 内の `permissions.allow` ルールと `permissions.additionalDirectories` エントリは機能を付与するため、Claude Code はそのワークスペースの[ワークスペーストラストダイアログ](/ja/security#additional-safeguards)を受け入れた後にのみ適用します。それまでの間、Claude Code はルールを読み込みますが適用しません。トラストダイアログには、フォルダが付与する許可ルールと追加ディレクトリが表示されるため、受け入れる前に確認できます。`deny` ルールと `ask` ルールは制限のみを行うため、影響を受けません。

513 

514Claude Code はワークスペーストを git リポジトリルートをキーとして保存するか、リポジトリ外の場合は Claude Code を起動したディレクトリをキーとして保存します。ホームディレクトリから起動した場合、トラストは現在のセッションのみ保持され、ディスクに書き込まれません。[追加のセーフガード](/ja/security#additional-safeguards)に関する注記を参照してください。親ディレクトリを信頼しても、ネストされたプロジェクトの許可ルールは適用されません。

515 

516`.claude/settings.local.json` はあなた自身のファイルであるため、ワークスペーストラストチェックは通常適用されません。リポジトリが git にコミットされている場合や `.claude` がシンボリックリンクである場合など、リポジトリがファイルを提供できる場合、その許可ルールと追加ディレクトリはプロジェクト設定と同様にトラストチェックを通ります。

517 

518`.claude/settings.local.json` の許可ルールと追加ディレクトリは、2 つのケースではワークスペーストラストなしで適用されます。

519 

520* Claude Code を起動したディレクトリが git リポジトリ内にない。

521* セッションがあなた自身の設定ホームで実行される。つまり、ホームディレクトリ、または `.claude` サブディレクトリを [`CLAUDE_CONFIG_DIR`](/ja/env-vars) として設定したディレクトリ。

522 

523どちらの場合も、ファイルはリポジトリが提供できるものではなく、あなたが作成したものです。リポジトリにコミットされた `.claude/settings.local.json` は依然としてワークスペーストラストが必要です。バージョン 2.1.196 から 2.1.199 では、これらのワークスペースでファイルをリポジトリ提供と見なし、その許可ルールを無視し、stderr に [`this workspace has not been trusted`](/ja/errors#workspace-has-not-been-trusted) 警告を出力していました。上記の 2 つの例外は v2.1.195 以前と一致し、v2.1.200 で復元されました。

524 

525また v2.1.200 以降、許可ルールまたは追加ディレクトリがまだ適用されていないワークスペースで、親ディレクトリが既に信頼されていたためトラストダイアログが表示されなかった場合、次に Claude Code をそこで対話的に起動したときにダイアログが表示されます。ダイアログは 2 つの選択肢を提供します。

526 

527* **Yes, I trust this folder**: そのワークスペースのトラストを保存し、同じセッション内でルールを適用します。

528* **No, continue without these permissions**: これらのルールを無視して作業を続けます。ダイアログは次のセッションで再度表示されます。

529 

530[非対話モード](/ja/headless)で `-p` を使用する場合、ダイアログは表示されず、ルールは無視されたままになります。

531 

506<h2 id="example-configurations">532<h2 id="example-configurations">

507 設定例533 設定例

508</h2>534</h2>

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 の場合は、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 にタスクを送信できます。26CLI はターミナルネイティブな作業に最も完全なサーフェスです。スクリプティングと Agent SDK は CLI のみです。サードパーティプロバイダーは[VS Code](/ja/vs-code#use-third-party-providers)でも機能します。Enterprise [Desktop](/ja/desktop) デプロイメントは Google Cloud の Agent Platform およびゲートウェイプロバイダーをサポートしています。Amazon Bedrock または Microsoft Foundry の場合は、CLI または VS Code を使用するか、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)を使用してください。これは、それらのプロバイダーで Code タブを実行します。Desktop と IDE 拡張機能は、CLI のみの機能の一部をビジュアルレビューとより緊密なエディター統合と引き換えにします。Web は Anthropic のクラウドで実行されるため、切断後もタスクが続行されます。モバイルは、これらの同じクラウドセッションへのシンクライアント、または Remote Control 経由のローカルセッションへのシンクライアントであり、Dispatch で Desktop にタスクを送信できます。

27 27 

28同じプロジェクトで複数のサーフェスを混在させることができます。設定、プロジェクトメモリ、MCP サーバーはローカルサーフェス全体で共有されます。28同じプロジェクトで複数のサーフェスを混在させることができます。設定、プロジェクトメモリ、MCP サーバーはローカルサーフェス全体で共有されます。

29 29 

Details

125| `~2.1` | `~3.0` | プラグイン B のインストールが `range-conflict` で失敗します。プラグイン A と依存関係は以前のままです。 |125| `~2.1` | `~3.0` | プラグイン B のインストールが `range-conflict` で失敗します。プラグイン A と依存関係は以前のままです。 |

126| `=2.1.0` | なし | 依存関係は `2.1.0` に留まります。プラグイン A がインストールされている間、自動更新は新しいバージョンをスキップします。 |126| `=2.1.0` | なし | 依存関係は `2.1.0` に留まります。プラグイン A がインストールされている間、自動更新は新しいバージョンをスキップします。 |

127 127 

128自動更新は、制約付き依存関係を、マーケットプレイスの最新バージョンではなく、インストール済みプラグインのすべての範囲を満たす最高 git タグで取得するため、依存関係は許可された範囲内で更新を受け続けます。すべての範囲を満たすタグがない場合、更新はスキップされスキップは `/doctor` と `/plugin` エラータブに表示され、制約するプラグインに名前を付けます。128自動更新は、制約付き依存関係を、マーケットプレイスの最新バージョンではなく、インストール済みプラグインのすべての範囲を満たす最高 git タグで取得するため、依存関係は許可された範囲内で更新を受け続けます。すべての範囲を満たすタグがない場合、自動更新はその依存関係をスキップしスキップを `/plugin` エラータブに表示し、制約するプラグインに名前を付けます。

129 129 

130依存関係を制約する最後のプラグインをアンインストールすると、依存関係は保持されなくなり、次の更新でマーケットプレイスエントリの追跡を再開します。130依存関係を制約する最後のプラグインをアンインストールすると、依存関係は保持されなくなり、次の更新でマーケットプレイスエントリの追跡を再開します。

131 131 


181 依存関係エラーを解決する181 依存関係エラーを解決する

182</h2>182</h2>

183 183 

184依存関係の問題は、`claude plugin list`、`/plugin` インターフェイス、および `/doctor` に表示されます影響を受けるプラグインはエラーを解決するまで無効になります最も一般的なエラーとその修正は以下にリストされています184依存関係の問題は、`claude plugin list` `/plugin` インターフェイスに表示されますClaude Code はエラーを解決するまで影響を受けたプラグインを無効にします以下の表は、最も一般的なエラーとその解決方法を示しています

185 185 

186| エラー | 意味 | 解決方法 |186| エラー | 意味 | 解決方法 |

187| :------------------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |187| :------------------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

Details

170| `plugins` | array | 利用可能なプラグインのリスト | 以下を参照 |170| `plugins` | array | 利用可能なプラグインのリスト | 以下を参照 |

171 171 

172<Note>172<Note>

173 **予約名**:以下のマーケットプレイス名は 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` など)もブロックされています。173 **予約名**:以下のマーケットプレイス名は 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`、`first-party-plugins`、`healthcare`。公式マーケットプレイスになりすましている名前(`official-claude-plugins` や `anthropic-plugins-v2` など)もブロックされています。これらの名前を予約することで、サードパーティのマーケットプレイスが Anthropic 公開ソースとして自らを提示することを防ぎます。

174 

175 Claude Code は、マーケットプレイスを追加するときだけでなく、マーケットプレイスをロードするたびに予約名を再チェックします。これらの名前の 1 つの下に登録されていたマーケットプレイスが、その名前が予約されるようになると、ロードが停止し、[信頼できないソースから登録されている](/ja/errors#marketplace-is-registered-from-an-untrusted-source)ことを報告します。そのマーケットプレイスを削除し、公式 Anthropic ソースから再度追加してください。新しく予約された名前の影響を受けるサードパーティのマーケットプレイスは、別の名前の下で再度追加するとすぐにロードされます。v2.1.205 より前では、`first-party-plugins` と `healthcare` は予約されておらず、予約名の下に既に登録されているマーケットプレイスはロードされ続けていました。

174</Note>176</Note>

175 177 

176<h3 id="owner-fields">178<h3 id="owner-fields">

plugins.md +2 −0

Details

203 203 

204<Warning>204<Warning>

205 **よくある間違い**:`commands/`、`agents/`、`skills/`、`hooks/` を `.claude-plugin/` ディレクトリ内に配置しないでください。`plugin.json` のみが `.claude-plugin/` 内に入ります。他のすべてのディレクトリはプラグインルートレベルにある必要があります。205 **よくある間違い**:`commands/`、`agents/`、`skills/`、`hooks/` を `.claude-plugin/` ディレクトリ内に配置しないでください。`plugin.json` のみが `.claude-plugin/` 内に入ります。他のすべてのディレクトリはプラグインルートレベルにある必要があります。

206 

207 プラグインルートは個別プラグイン自体のディレクトリです。`.claude-plugin/plugin.json` を含むディレクトリです。`~/.claude/` ではありません。例えば、Claude Code は `~/.claude/.mcp.json` に配置された `.mcp.json` を読み込みません。

206</Warning>208</Warning>

207 209 

208| ディレクトリ | 場所 | 目的 |210| ディレクトリ | 場所 | 目的 |

Details

159* `prompt`: LLM でプロンプトを評価(コンテキストの `$ARGUMENTS` プレースホルダーを使用)159* `prompt`: LLM でプロンプトを評価(コンテキストの `$ARGUMENTS` プレースホルダーを使用)

160* `agent`: 複雑な検証タスク用のツール付き agentic verifier を実行160* `agent`: 複雑な検証タスク用のツール付き agentic verifier を実行

161 161 

162プラグイン自体の[バンドルされた MCP server](#mcp-servers)をターゲットとする Hooks は、スコープ付き名を使用する必要があります。ツールマッチャーと `if` フィールドはスコープ付きツール名 `mcp__plugin_<plugin-name>_<server-name>__<tool>` を取り、`mcp_tool` hook の `server` フィールドは `plugin:<plugin-name>:<server-name>` を取ります。ベアサーバーキーに対して記述されたマッチャーは発火しません。[MCP ツールをマッチ](/ja/hooks#match-mcp-tools)および[プラグイン提供 MCP servers](/ja/mcp#plugin-provided-mcp-servers)を参照してください。

163 

162<h3 id="mcp-servers">164<h3 id="mcp-servers">

163 MCP servers165 MCP servers

164</h3>166</h3>


266| `settings` | `workspace/didChangeConfiguration` 経由で渡される設定 |268| `settings` | `workspace/didChangeConfiguration` 経由で渡される設定 |

267| `workspaceFolder` | サーバーのワークスペースフォルダーパス |269| `workspaceFolder` | サーバーのワークスペースフォルダーパス |

268| `startupTimeout` | サーバー起動を待つ最大時間(ミリ秒) |270| `startupTimeout` | サーバー起動を待つ最大時間(ミリ秒) |

271| `shutdownTimeout` | グレースフルシャットダウンを待つ最大時間(ミリ秒)。タイムアウトが経過すると、Claude Code はサーバープロセスを終了します。設定されていない場合、タイムアウトは適用されません |

272| `restartOnCrash` | クラッシュ後にサーバーを再起動するかどうか。デフォルトは `true` です。クラッシュしたサーバーを再起動する代わりに停止したままにするには `false` に設定します |

269| `maxRestarts` | 諦める前の最大再起動試行回数 |273| `maxRestarts` | 諦める前の最大再起動試行回数 |

270| `diagnostics` | 編集後に診断を Claude のコンテキストにプッシュするかどうか(デフォルト `true`)。コードナビゲーションは保持しながら自動診断注入を抑制するには `false` に設定します。 |274| `diagnostics` | 編集後に診断を Claude のコンテキストにプッシュするかどうか(デフォルト `true`)。コードナビゲーションは保持しながら自動診断注入を抑制するには `false` に設定します。 |

271 275 

276`restartOnCrash` と `shutdownTimeout` には Claude Code v2.1.205 以降が必要です。v2.1.205 より前では、設定スキーマは両方のオプションを受け入れていましたが、どちらかを設定すると Claude Code は起動時にその LSP サーバーをスキップしていました。理由は `claude --debug` 出力でのみ表示されます。

277 

278**同じ拡張子に対する複数のサーバー**: 複数の有効な LSP サーバーが `extensionToLanguage` で同じファイル拡張子を宣言する場合、サーバーが 1 つのプラグインから来ているか異なるプラグインから来ているかに関わらず、最初に登録されたサーバーがその拡張子を持つファイルを処理し、他のサーバーは起動しません。`/plugin` インターフェイスは、アクティブなサーバーを持つプラグインに名前を付ける警告を表示します。

279 

280**初期化に失敗するサーバー**: Claude Code は、`command` または `extensionToLanguage` が欠落しているなど、設定が無効なサーバーをスキップし、他の設定されたサーバーは引き続き起動します。`claude --debug` を実行して、サーバーがスキップされた理由を確認してください。

281 

282スキップされたサーバーはそのファイル拡張子を要求しないため、同じ拡張子を宣言する別の有効なサーバーが、同じプラグインまたは異なるプラグインから来ていても、引き続きそれらのファイルを処理します。v2.1.205 より前では、初期化に失敗したサーバーは引き続きその拡張子を要求し、同じ拡張子に対する別の有効なサーバーをブロックしていました。

283 

272<Warning>284<Warning>

273 **言語サーバーバイナリを別途インストールする必要があります。** LSP プラグインは Claude Code が言語サーバーに接続する方法を設定しますが、サーバー自体は含まれていません。`/plugin` Errors タブに `Executable not found in $PATH` が表示される場合は、言語に必要なバイナリをインストールしてください。285 **言語サーバーバイナリを別途インストールする必要があります。** LSP プラグインは Claude Code が言語サーバーに接続する方法を設定しますが、サーバー自体は含まれていません。`/plugin` Errors タブに `Executable not found in $PATH` が表示される場合は、言語に必要なバイナリをインストールしてください。

274</Warning>286</Warning>


635* **デフォルトに追加**: `skills`。デフォルト `skills/` ディレクトリは常にスキャンされ、`skills` にリストされているディレクトリはそれと一緒に読み込まれます。例外: [マーケットプレイスエントリの `source` がマーケットプレイスルートに解決される](/ja/plugin-marketplaces#advanced-plugin-entries)場合、特定のサブディレクトリを宣言するとスキャンが置き換えられます647* **デフォルトに追加**: `skills`。デフォルト `skills/` ディレクトリは常にスキャンされ、`skills` にリストされているディレクトリはそれと一緒に読み込まれます。例外: [マーケットプレイスエントリの `source` がマーケットプレイスルートに解決される](/ja/plugin-marketplaces#advanced-plugin-entries)場合、特定のサブディレクトリを宣言するとスキャンが置き換えられます

636* **独自のマージルール**: [hooks](#hooks)、[MCP servers](#mcp-servers)、[LSP servers](#lsp-servers)。各セクションで複数のソースがどのように結合されるかを参照してください648* **独自のマージルール**: [hooks](#hooks)、[MCP servers](#mcp-servers)、[LSP servers](#lsp-servers)。各セクションで複数のソースがどのように結合されるかを参照してください

637 649 

638プラグインがデフォルトフォルダと一致するマニフェストキーの両方を持つ場合、Claude Code v2.1.140 以降は無視されたフォルダを `/doctor`、`claude plugin list`および `/plugin` 詳細ビューでフラグします。プラグインはマニフェストパスを使用して読み込まれます。マニフェストキーがデフォルトフォルダを指す場合(例: `"commands": ["./commands/deploy.md"]`)は警告は表示されません。その場合、フォルダは明示的にアドレス指定されているためです。650プラグインがデフォルトフォルダと一致するマニフェストキーの両方を持つ場合、Claude Code v2.1.140 以降は無視されたフォルダを `claude plugin list` および `/plugin` 詳細ビューで警告します。プラグインはマニフェストパスを使用して読み込まれます。マニフェストキーがデフォルトフォルダを指す場合(例: `"commands": ["./commands/deploy.md"]`)は警告は表示されません。その場合、フォルダは明示的にアドレス指定されているためです。

639 651 

640すべてのパスフィールドについて:652すべてのパスフィールドについて:

641 653 


673 685 

674**`${CLAUDE_PLUGIN_DATA}`**: 更新後も保持される永続ディレクトリ。`node_modules` または Python 仮想環境などのインストール済み依存関係、生成されたコード、キャッシュ、およびプラグインバージョン全体で保持する必要があるその他のファイルに使用します。このディレクトリは、この変数が最初に参照されるときに自動的に作成されます。686**`${CLAUDE_PLUGIN_DATA}`**: 更新後も保持される永続ディレクトリ。`node_modules` または Python 仮想環境などのインストール済み依存関係、生成されたコード、キャッシュ、およびプラグインバージョン全体で保持する必要があるその他のファイルに使用します。このディレクトリは、この変数が最初に参照されるときに自動的に作成されます。

675 687 

676**`${CLAUDE_PROJECT_DIR}`**: プロジェクトルート。これは hook が `CLAUDE_PROJECT_DIR` 変数で受け取るのと同じディレクトリです。プロジェクトローカルスクリプトまたは設定ファイルを参照するために使用します。スペースを含むパスを処理するためにクォートで囲みます。たとえば `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`。MCP サーバーは MCP `roots/list` リクエストを呼び出すこともでき、Claude Code が起動されたディレクトリを返します688**`${CLAUDE_PROJECT_DIR}`**: プロジェクトルート。これは hook が `CLAUDE_PROJECT_DIR` 変数で受け取るのと同じディレクトリです。プロジェクトローカルスクリプトまたは設定ファイルを参照するために使用します。スペースを含むパスを処理するためにクォートで囲みます。たとえば `"${CLAUDE_PROJECT_DIR}/scripts/server.sh"`。MCP サーバーは `roots/list` リクエストを呼び出すこともでき、セッションの作業ディレクトリを実行時に読み取ることができます。[`roots/list` が返すもの、および Claude Code がサーバーに変更を通知するタイミング](/ja/mcp#option-3-add-a-local-stdio-server)を参照してください

677 689 

678```json theme={null}690```json theme={null}

679{691{

Details

50キャッシングはサーバー側で行われ、モデルを提供するインフラストラクチャで行われます。その場所は、認証方法によって異なります。50キャッシングはサーバー側で行われ、モデルを提供するインフラストラクチャで行われます。その場所は、認証方法によって異なります。

51 51 

52* **API キー、Claude サブスクリプション、または[Claude Platform on AWS](/ja/claude-platform-on-aws)**: キャッシュは Anthropic のインフラストラクチャに存在し、[Claude API](https://platform.claude.com/docs) を通じてアクセスされます52* **API キー、Claude サブスクリプション、または[Claude Platform on AWS](/ja/claude-platform-on-aws)**: キャッシュは Anthropic のインフラストラクチャに存在し、[Claude API](https://platform.claude.com/docs) を通じてアクセスされます

53* **Bedrock または Vertex AI**: キャッシュはクラウドプロバイダーのサービングインフラストラクチャに存在します53* **Amazon Bedrock または Google Cloud の Agent Platform**: キャッシュはクラウドプロバイダーのサービングインフラストラクチャに存在します

54* **Foundry**: リクエストは Anthropic のインフラストラクチャにルーティングされます54* **Microsoft Foundry**: リクエストは Anthropic のインフラストラクチャにルーティングされます

55* **カスタム `ANTHROPIC_BASE_URL` または[LLM gateway](/ja/llm-gateway)**: キャッシュはリクエストが転送される場所に存在し、キャッシングが機能するかどうかはゲートウェイに依存します55* **カスタム `ANTHROPIC_BASE_URL` または[LLM gateway](/ja/llm-gateway)**: キャッシュはリクエストが転送される場所に存在し、キャッシングが機能するかどうかはゲートウェイに依存します

56 56 

57各プロバイダーが保存および処理するものについては、[データ使用](/ja/data-usage)を参照してください。キャッシュがどこに存在するかに関わらず、エントリは非アクティブ期間後に期限切れになり、以下の[キャッシュライフタイム](#cache-lifetime)は TTL とそれを延長する方法について説明します。57各プロバイダーが保存および処理するものについては、[データ使用](/ja/data-usage)を参照してください。キャッシュがどこに存在するかに関わらず、エントリは非アクティブ期間後に期限切れになり、以下の[キャッシュライフタイム](#cache-lifetime)は TTL とそれを延長する方法について説明します。


106ツール定義はシステムプロンプトレイヤーに存在するため、リクエスト間でリクエスト内のツール定義のセットが変更されるとキャッシュが無効になります。[advisor ツール](/ja/advisor)のトグルは例外です。その定義はキャッシュブレークポイントの後に存在するため、`/advisor` を有効化または無効化してもキャッシュされたプリフィックスはそのままです。[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)によって遅延されるか、プリフィックスに読み込まれるかによって異なります。

107 107 

108* **遅延ツール**、サポートされているモデルのデフォルト:サーバーの接続、切断、またはツールリストの変更は、新しいコンテンツのみを追加し、既にキャッシュされているものを妨害しません。108* **遅延ツール**、サポートされているモデルのデフォルト:サーバーの接続、切断、またはツールリストの変更は、新しいコンテンツのみを追加し、既にキャッシュされているものを妨害しません。

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)によって前もって保持される定義についても発生します。109* **プリフィックスに読み込まれるツール**:それらへの変更はキャッシュを無効にします。これは[ツール検索が利用不可または無効](/ja/mcp#configure-tool-search)な場合に発生します。Haiku モデル、Google Cloud の Agent Platform、またはカスタム `ANTHROPIC_BASE_URL` ゲートウェイなど。また、[`alwaysLoad`](/ja/mcp#exempt-a-server-from-deferral)とマークされたサーバーまたはツール、および[しきい値ベースの読み込み](/ja/mcp#configure-tool-search)によって前もって保持される定義についても発生します。

110 110 

111ツールがプリフィックスに読み込まれる場合、無効化の最も一般的な原因は、セッション中にサーバーが接続または切断されることです。これはアクションなしで発生する可能性があります。stdio サーバーのプロセスが終了するか、HTTP セッションが期限切れになるか、サーバーが[一時的な障害後に自動的に再接続](/ja/mcp#automatic-reconnection)します。接続されたサーバーは、ツールリストを変更する[動的ツール更新](/ja/mcp#dynamic-tool-updates)をプッシュすることもできます。111ツールがプリフィックスに読み込まれる場合、無効化の最も一般的な原因は、セッション中にサーバーが接続または切断されることです。これはアクションなしで発生する可能性があります。stdio サーバーのプロセスが終了するか、HTTP セッションが期限切れになるか、サーバーが[一時的な障害後に自動的に再接続](/ja/mcp#automatic-reconnection)します。接続されたサーバーは、ツールリストを変更する[動的ツール更新](/ja/mcp#dynamic-tool-updates)をプッシュすることもできます。

112 112 


235 API キーまたはサードパーティプロバイダー上235 API キーまたはサードパーティプロバイダー上

236</h3>236</h3>

237 237 

238API キー、Bedrock、Vertex、Foundry、または Claude Platform on AWS では、トークンごとのレートを支払うため、TTL はデフォルトでより安い 5 分のままです。[1 時間の TTL](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching#1-hour-cache-duration)にオプトインするには、`ENABLE_PROMPT_CACHING_1H=1` を設定します。238API キー、Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、または Claude Platform on AWS では、トークンごとのレートを支払うため、TTL はデフォルトでより安い 5 分のままです。[1 時間の TTL](https://platform.claude.com/docs/ja/build-with-claude/prompt-caching#1-hour-cache-duration)にオプトインするには、`ENABLE_PROMPT_CACHING_1H=1` を設定します。

239 239 

240Bedrock では、プロンプトキャッシングサポート、最小キャッシュ可能プリフィックス長、および 1 時間の TTL 可用性はすべてモデルによって異なります。キャッシュトークン数がゼロのままの場合は、Bedrock ドキュメントの[サポートされているモデル、リージョン、制限](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models)を確認してください。240Amazon Bedrock では、プロンプトキャッシングサポート、最小キャッシュ可能プリフィックス長、および 1 時間の TTL 可用性はすべてモデルによって異なります。キャッシュトークン数がゼロのままの場合は、Amazon Bedrock ドキュメントの[サポートされているモデル、リージョン、制限](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html#prompt-caching-models)を確認してください。

241 241 

242<h3 id="override-the-ttl">242<h3 id="override-the-ttl">

243 TTL をオーバーライドする243 TTL をオーバーライドする

quickstart.md +1 −1

Details

105 105 

106* [Claude Pro、Max、Team、または Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login)(推奨)106* [Claude Pro、Max、Team、または Enterprise](https://claude.com/pricing?utm_source=claude_code\&utm_medium=docs\&utm_content=quickstart_login)(推奨)

107* [Claude Console](https://console.anthropic.com/)(プリペイドクレジット付き API アクセス)。初回ログイン時に、コスト追跡を一元化するために「Claude Code」ワークスペースが Console に自動的に作成されます。107* [Claude Console](https://console.anthropic.com/)(プリペイドクレジット付き API アクセス)。初回ログイン時に、コスト追跡を一元化するために「Claude Code」ワークスペースが Console に自動的に作成されます。

108* [Amazon Bedrock、Google Vertex AI、または Microsoft Foundry](/ja/third-party-integrations)(エンタープライズクラウドプロバイダー)108* [Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry](/ja/third-party-integrations)(エンタープライズクラウドプロバイダー)

109* 組織が実行している自己ホスト型の [Claude apps gateway](/ja/claude-apps-gateway):管理者がゲートウェイ URL を事前に設定し、`/login` で **Cloud gateway** 画面が直接開き、企業 SSO でサインインできます109* 組織が実行している自己ホスト型の [Claude apps gateway](/ja/claude-apps-gateway):管理者がゲートウェイ URL を事前に設定し、`/login` で **Cloud gateway** 画面が直接開き、企業 SSO でサインインできます

110 110 

111ログイン後、認証情報が保存され、再度ログインする必要はありません。111ログイン後、認証情報が保存され、再度ログインする必要はありません。

Details

16 16 

17* **ローカル環境全体をリモートで使用する**: ファイルシステム、[MCP サーバー](/ja/mcp)、ツール、プロジェクト設定がすべて利用可能なままです。また、`@` を入力するとローカルプロジェクトのファイルパスが自動補完されます17* **ローカル環境全体をリモートで使用する**: ファイルシステム、[MCP サーバー](/ja/mcp)、ツール、プロジェクト設定がすべて利用可能なままです。また、`@` を入力するとローカルプロジェクトのファイルパスが自動補完されます

18* **両方のサーフェスから同時に作業する**: 会話はすべての接続されたデバイス間で同期されるため、ターミナル、ブラウザ、電話から相互に交換可能にメッセージを送信できます18* **両方のサーフェスから同時に作業する**: 会話はすべての接続されたデバイス間で同期されるため、ターミナル、ブラウザ、電話から相互に交換可能にメッセージを送信できます

19* **電話またはブラウザから画像とファイルを送信する**: Claude アプリまたは claude.ai/code に添付ファイルを追加すると、Claude Code はそれをマシンにダウンロードし、キャプション付きまたはキャプションなしで `@` ファイル参照として Claude に渡します。{/* min-version: 2.1.202 */}v2.1.202 より前では、キャプションなしで送信された添付ファイルがセッションに到達する前に Claude Code がドロップする可能性がありました。

19* **中断に対応する**: ラップトップがスリープ状態になったり、ネットワークが切断されたりした場合、マシンがオンラインに戻ると、セッションは自動的に再接続されます20* **中断に対応する**: ラップトップがスリープ状態になったり、ネットワークが切断されたりした場合、マシンがオンラインに戻ると、セッションは自動的に再接続されます

20 21 

21クラウドインフラストラクチャで実行される [Web 上の Claude Code](/ja/claude-code-on-the-web) とは異なり、Remote Control セッションはマシン上で直接実行され、ローカルファイルシステムと相互作用します。Web およびモバイルインターフェースは、そのローカルセッションへのウィンドウにすぎません。22クラウドインフラストラクチャで実行される [Web 上の Claude Code](/ja/claude-code-on-the-web) とは異なり、Remote Control セッションはマシン上で直接実行され、ローカルファイルシステムと相互作用します。Web およびモバイルインターフェースは、そのローカルセッションへのウィンドウにすぎません。


34 35 

35* **サブスクリプション**: Pro、Max、Team、および Enterprise プランで利用可能です。API キーはサポートされていません。Team および Enterprise では、Owner が [Claude Code 管理設定](https://claude.ai/admin-settings/claude-code) で Remote Control トグルを最初に有効にする必要があります。36* **サブスクリプション**: Pro、Max、Team、および Enterprise プランで利用可能です。API キーはサポートされていません。Team および Enterprise では、Owner が [Claude Code 管理設定](https://claude.ai/admin-settings/claude-code) で Remote Control トグルを最初に有効にする必要があります。

36* **認証**: `claude` を実行し、まだサインインしていない場合は `/login` を使用して claude.ai 経由でサインインします。37* **認証**: `claude` を実行し、まだサインインしていない場合は `/login` を使用して claude.ai 経由でサインインします。

37* **API エンドポイント**: Amazon Bedrock、Google Vertex AI、または Microsoft Foundry では利用できません。{/* min-version: 2.1.196 */}v2.1.196 以降、[`ANTHROPIC_BASE_URL`](/ja/env-vars) が `api.anthropic.com` 以外のホスト([LLM gateway](/ja/llm-gateway) やプロキシなど)を指している場合、Remote Control も無効になります。Remote Control を使用するには、この変数を設定解除してください。38* **API エンドポイント**: Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。{/* min-version: 2.1.196 */}v2.1.196 以降、[`ANTHROPIC_BASE_URL`](/ja/env-vars) が `api.anthropic.com` 以外のホスト([LLM gateway](/ja/llm-gateway) やプロキシなど)を指している場合、Remote Control も無効になります。Remote Control を使用するには、この変数を設定解除してください。

38* **ワークスペース信頼**: プロジェクトディレクトリで少なくとも 1 回 `claude` を実行して、ワークスペース信頼ダイアログを受け入れます。39* **ワークスペース信頼**: プロジェクトディレクトリで少なくとも 1 回 `claude` を実行して、ワークスペース信頼ダイアログを受け入れます。

39 40 

40<h2 id="start-a-remote-control-session">41<h2 id="start-a-remote-control-session">


59 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |60 | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

60 | `--name "My Project"` | claude.ai/code のセッションリストに表示されるカスタムセッションタイトルを設定します。 |61 | `--name "My Project"` | claude.ai/code のセッションリストに表示されるカスタムセッションタイトルを設定します。 |

61 | `--remote-control-session-name-prefix <prefix>` | 明示的な名前が設定されていない場合の自動生成セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前が生成されます。同じ効果のために `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を設定します。 |62 | `--remote-control-session-name-prefix <prefix>` | 明示的な名前が設定されていない場合の自動生成セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` のような名前が生成されます。同じ効果のために `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を設定します。 |

63 | `-c`, `--continue` | {/* min-version: 2.1.200 */}このディレクトリから開始された最新の Remote Control セッションを再開します。新しいセッションを作成する代わりに使用します。`--session-id`、`--spawn`、`--capacity`、または `--create-session-in-dir` と組み合わせることはできません。Claude Code v2.1.200 以降が必要です。それより前のバージョンはこのフラグを未知の引数として拒否します。 |

64 | `--session-id <id>` | {/* min-version: 2.1.200 */}特定の Remote Control セッションをその ID で再開します。`--continue`、`--spawn`、`--capacity`、または `--create-session-in-dir` と組み合わせることはできません。Claude Code v2.1.200 以降が必要です。それより前のバージョンはこのフラグを未知の引数として拒否します。 |

62 | `--spawn <mode>` | サーバーがセッションを作成する方法。<br />• `same-dir`(デフォルト): すべてのセッションが現在の作業ディレクトリを共有するため、同じファイルを編集している場合は競合する可能性があります。<br />• `worktree`: オンデマンドセッションごとに独自の [git worktree](/ja/worktrees) を取得します。git リポジトリが必要です。<br />• `session`: シングルセッションモード。正確に 1 つのセッションを提供し、追加の接続を拒否します。スタートアップ時にのみ設定します。<br />実行時に `w` を押して `same-dir` と `worktree` の間でトグルします。 |65 | `--spawn <mode>` | サーバーがセッションを作成する方法。<br />• `same-dir`(デフォルト): すべてのセッションが現在の作業ディレクトリを共有するため、同じファイルを編集している場合は競合する可能性があります。<br />• `worktree`: オンデマンドセッションごとに独自の [git worktree](/ja/worktrees) を取得します。git リポジトリが必要です。<br />• `session`: シングルセッションモード。正確に 1 つのセッションを提供し、追加の接続を拒否します。スタートアップ時にのみ設定します。<br />実行時に `w` を押して `same-dir` と `worktree` の間でトグルします。 |

63 | `--capacity <N>` | 同時セッションの最大数。デフォルトは 32 です。`--spawn=session` では使用できません。 |66 | `--capacity <N>` | 同時セッションの最大数。デフォルトは 32 です。`--spawn=session` では使用できません。 |

67 | `--[no-]create-session-in-dir` | サーバーの起動時に現在のディレクトリに 1 つのセッションを事前作成し、すぐに入力できる場所を用意します。`worktree` モードでは、このセッションは現在のディレクトリに留まり、オンデマンドセッションは分離された worktree を取得します。デフォルトではオンです。`--no-create-session-in-dir` を渡して、何も作成しない状態で開始します。 |

64 | `--verbose` | 詳細な接続とセッションログを表示します。 |68 | `--verbose` | 詳細な接続とセッションログを表示します。 |

65 | `--sandbox` / `--no-sandbox` | ファイルシステムとネットワーク分離のための [サンドボックス](/ja/sandboxing)を有効または無効にします。デフォルトではオフです。 |69 | `--sandbox` / `--no-sandbox` | ファイルシステムとネットワーク分離のための [サンドボックス](/ja/sandboxing)を有効または無効にします。デフォルトではオフです。 |

66 </Tab>70 </Tab>


149 すべてのセッションで Remote Control を有効にする153 すべてのセッションで Remote Control を有効にする

150</h3>154</h3>

151 155 

152デフォルトでは、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** からこれをトグルすることもできます。156Remote 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** からこれをトグルすることもできます。{/* min-version: 2.1.203 */}[VS Code 拡張機能](/ja/vs-code#use-the-prompt-box)では、同じトグルがコマンドメニューの Settings セクションに **Enable Remote Control for all sessions** として表示されます。Claude Code v2.1.203 以降が必要です。

153 157 

154この設定がオンの場合、各対話型 Claude Code プロセスは 1 つのリモートセッションを登録します。複数のインスタンスを実行する場合、各インスタンスは独自の環境とセッションを取得します。単一のプロセスから複数の同時セッションを実行するには、[サーバーモード](#start-a-remote-control-session)を使用します。158この設定がオンの場合、各対話型 Claude Code プロセスは 1 つのリモートセッションを登録します。複数のインスタンスを実行する場合、各インスタンスは独自の環境とセッションを取得します。単一のプロセスから複数の同時セッションを実行するには、[サーバーモード](#start-a-remote-control-session)を使用します。

155 159 


280* **ローカルプロセスは実行し続ける必要があります**: Remote Control はローカルプロセスとして実行されます。ターミナルを閉じるか、VS Code を終了するか、または `claude` プロセスを停止すると、セッションは終了します。284* **ローカルプロセスは実行し続ける必要があります**: Remote Control はローカルプロセスとして実行されます。ターミナルを閉じるか、VS Code を終了するか、または `claude` プロセスを停止すると、セッションは終了します。

281* **長時間のネットワーク障害**: マシンが起動しているがおよそ 10 分以上ネットワークに到達できない場合、セッションはタイムアウトしてプロセスは終了します。新しいセッションを開始するには、`claude remote-control` を再度実行します。285* **長時間のネットワーク障害**: マシンが起動しているがおよそ 10 分以上ネットワークに到達できない場合、セッションはタイムアウトしてプロセスは終了します。新しいセッションを開始するには、`claude remote-control` を再度実行します。

282* **Ultraplan は Remote Control を切断します**: [ultraplan](/ja/ultraplan) セッションを開始すると、アクティブな Remote Control セッションが切断されます。両方の機能が claude.ai/code インターフェースを占有し、一度に 1 つだけ接続できるためです。286* **Ultraplan は Remote Control を切断します**: [ultraplan](/ja/ultraplan) セッションを開始すると、アクティブな Remote Control セッションが切断されます。両方の機能が claude.ai/code インターフェースを占有し、一度に 1 つだけ接続できるためです。

283* **一部のコマンドはローカルのみです**: ターミナルで対話型ピッカーを開くコマンド(`/plugin` や `/resume` など)はローカル CLI からのみ機能します。以下がモバイルと Web から機能します:287* **一部のコマンドはローカルのみです**: ターミナルインターフェースでのみ実行されるコマンド(`/plugin` や `/resume` など)は、引数を渡すかどうかに関わらず、ローカル CLI からのみ機能します。以下がモバイルと Web から機能します:

284 * テキスト出力コマンド: `/compact`、`/clear`、`/context`、`/usage`、`/exit`、`/usage-credits`、`/recap`、`/reload-plugins`288 * テキスト出力コマンド: `/compact`、`/clear`、`/context`、`/usage`、`/exit`、`/usage-credits`、`/recap`、`/reload-plugins`

285 * {/* min-version: 2.1.166 */}v2.1.166 以降の `/mcp`: ピッカーを開く代わりにサーバーステータスのテキスト概要を返し、`reconnect`、`enable`、`disable` [サブコマンド](/ja/commands#all-commands)を受け入れますローカル CLI と異なり、`/mcp reconnect` をサーバー名なしで実行すると失敗したか認証が必要なすべてのサーバーを再接続します289 * `/model`、`/effort`、`/fast`、`/color`、`/rename`: 値を引数として渡します。例えば `/model sonnet` または `/effort high` のようにしますモバイルと Web からは、`/model` `/effort` ターミナルピッカーまたはスライダーの代わりに引数を受け取ります

286 * {/* min-version: 2.1.181 */}v2.1.181 以降の `/config`: `key=value` を渡して設定を行うか引数なしで実行して設定できるキーのリストを表示します290 * {/* min-version: 2.1.166 */}`/mcp`、v2.1.166 以降: ピッカーを開く代わりにサーバーステータスのテキスト概要を返し、`reconnect`、`enable`、`disable` [サブコマンド](/ja/commands#all-commands)を受け入れます。ローカル CLI と異なり、`/mcp reconnect` をサーバー名なしで実行すると失敗したか認証が必要なすべてのサーバーを再接続します

291 * {/* min-version: 2.1.181 */}`/config`、v2.1.181 以降: `key=value` を渡して設定を行うか、引数なしで実行して設定できるキーのリストを表示します。

287 292 

288<h2 id="troubleshooting">293<h2 id="troubleshooting">

289 トラブルシューティング294 トラブルシューティング


323 「Remote Control は Claude 経由で api.anthropic.com を使用している場合にのみ利用可能です」328 「Remote Control は Claude 経由で api.anthropic.com を使用している場合にのみ利用可能です」

324</h3>329</h3>

325 330 

326セッションが Anthropic API に直接通信していないため、ペアリングする claude.ai バックエンドがありません。これは Amazon Bedrock、Google Vertex AI、および Microsoft Foundry で発生します。{/* min-version: 2.1.196 */}v2.1.196 以降、[`ANTHROPIC_BASE_URL`](/ja/env-vars) が `api.anthropic.com` 以外のホスト([LLM ゲートウェイ](/ja/llm-gateway)やプロキシなど)を指している場合にも発生します。claude.ai でサインインしている場合でも同様です。`ANTHROPIC_BASE_URL` を設定解除してセッションを再開し、Remote Control を使用してください。331セッションが Anthropic API に直接通信していないため、ペアリングする claude.ai バックエンドがありません。これは Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry で発生します。{/* min-version: 2.1.196 */}v2.1.196 以降、[`ANTHROPIC_BASE_URL`](/ja/env-vars) が `api.anthropic.com` 以外のホスト([LLM ゲートウェイ](/ja/llm-gateway)やプロキシなど)を指している場合にも発生します。claude.ai でサインインしている場合でも同様です。`ANTHROPIC_BASE_URL` を設定解除してセッションを再開し、Remote Control を使用してください。

327 332 

328<h3 id="remote-control-is-disabled-by-your-organization’s-policy">333<h3 id="remote-control-is-disabled-by-your-organization’s-policy">

329 「Remote Control は組織のポリシーで無効になっています」334 「Remote Control は組織のポリシーで無効になっています」


352* ネットワークまたはプロキシの問題: ファイアウォールまたはプロキシがアウトバウンド HTTPS リクエストをブロックしている可能性があります。Remote Control はポート 443 で Anthropic API へのアクセスが必要です。357* ネットワークまたはプロキシの問題: ファイアウォールまたはプロキシがアウトバウンド HTTPS リクエストをブロックしている可能性があります。Remote Control はポート 443 で Anthropic API へのアクセスが必要です。

353* セッション作成に失敗: `Session creation failed — see debug log` も表示される場合、失敗はセットアップの前の段階で発生しました。サブスクリプションがアクティブであることを確認してください。358* セッション作成に失敗: `Session creation failed — see debug log` も表示される場合、失敗はセットアップの前の段階で発生しました。サブスクリプションがアクティブであることを確認してください。

354 359 

360<h3 id="couldn’t-reconnect-to-your-remote-control-session">

361 「Remote Control セッションに再接続できませんでした」

362</h3>

363 

364`claude --resume` または `claude --continue` で会話を再開すると、Claude Code はその会話に記録された Remote Control セッションに再接続します。このメッセージは、ネットワーク中断またはサーバーエラーなど、一時的な理由で再接続に失敗したことを意味します。そのため、Claude Code はリモートセッションがまだ存在するかどうかを確認できません。サーバーが前のセッションがもう存在しないことを確認すると、Claude Code はこのメッセージを表示せずに新しい Remote Control セッションを作成します。

365 

366ローカルセッションは Remote Control なしで実行を続けます。`/remote-control` を実行して接続を再試行するか、`--resume` なしで Claude Code を開始して新しい Remote Control セッションを作成してください。

367 

368{/* min-version: 2.1.200 */}v2.1.200 より前では、再接続の失敗により新しい Remote Control セッションが作成され、このメッセージが表示されず、claude.ai/code のセッションリストに余分なセッションが残されていました。

369 

355<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">370<h3 id="your-organization-requires-trusted-devices-for-remote-control-but-this-device-is-not-enrolled">

356 「組織は Remote Control に信頼できるデバイスを要求していますが、このデバイスは登録されていません」371 「組織は Remote Control に信頼できるデバイスを要求していますが、このデバイスは登録されていません」

357</h3>372</h3>

routines.md +1 −1

Details

416 416 

417CLI は、その要件の 1 つが満たされていない場合、`/schedule` を非表示にします。入力中はコマンドメニューに `No commands match "/schedule"` が表示され、送信すると `Unknown command: /schedule` が返されます。原因は通常、以下のいずれかです。417CLI は、その要件の 1 つが満たされていない場合、`/schedule` を非表示にします。入力中はコマンドメニューに `No commands match "/schedule"` が表示され、送信すると `Unknown command: /schedule` が返されます。原因は通常、以下のいずれかです。

418 418 

419* Console API キーまたは Bedrock、Vertex、Foundry などのクラウドプロバイダーで認証されています。`/schedule` には claude.ai サブスクリプションログインが必要です。`ANTHROPIC_API_KEY` または `ANTHROPIC_AUTH_TOKEN` がシェルに設定されている場合、または `apiKeyHelper` が `settings.json` に設定されている場合は、これらが claude.ai ログインより優先されるため、まず削除してください419* Console API キーまたは Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry などのクラウドプロバイダーで認証されています。`/schedule` には claude.ai サブスクリプションログインが必要です。`ANTHROPIC_API_KEY` または `ANTHROPIC_AUTH_TOKEN` がシェルに設定されている場合、または `apiKeyHelper` が `settings.json` に設定されている場合は、これらが claude.ai ログインより優先されるため、まず削除してください

420* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、または `DISABLE_GROWTHBOOK` がシェル環境または [`settings.json` ファイル](/ja/settings#available-settings)の `env` ブロックに設定されています。これらは機能フラグの取得を無効にします。`/schedule` はこれに依存しています420* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`、または `DISABLE_GROWTHBOOK` がシェル環境または [`settings.json` ファイル](/ja/settings#available-settings)の `env` ブロックに設定されています。これらは機能フラグの取得を無効にします。`/schedule` はこれに依存しています

421* Claude Code のウェブセッション内にいます。代わりに [ウェブ UI](https://claude.ai/code/routines) からルーティンを管理してください421* Claude Code のウェブセッション内にいます。代わりに [ウェブ UI](https://claude.ai/code/routines) からルーティンを管理してください

422* {/* min-version: 2.1.81 */}CLI が v2.1.81 より古いバージョンです。`claude update` を実行してください422* {/* min-version: 2.1.81 */}CLI が v2.1.81 より古いバージョンです。`claude update` を実行してください

sandboxing.md +1 −1

Details

237 237 

238`mask` を使用すると、サンドボックス化されたコマンドは実際の値の代わりにセッションごとのセンチネル値を見ます。リクエストが認証情報の `injectHosts` の 1 つに対してサンドボックスを離れるとき、[サンドボックスプロキシ](#network-isolation) はセンチネルを実際の値に置き換えます。コマンドとそれがログに記録するものは実際の認証情報を保持しませんが、そのリクエストは依然として認証されます。238`mask` を使用すると、サンドボックス化されたコマンドは実際の値の代わりにセッションごとのセンチネル値を見ます。リクエストが認証情報の `injectHosts` の 1 つに対してサンドボックスを離れるとき、[サンドボックスプロキシ](#network-isolation) はセンチネルを実際の値に置き換えます。コマンドとそれがログに記録するものは実際の認証情報を保持しませんが、そのリクエストは依然として認証されます。

239 239 

240プロキシはリクエストコンテンツ内の認証情報を置き換えるため、それらを見る必要があります。[`network.tlsTerminate`](/ja/settings#sandbox-settings) を設定して、プロキシが HTTPS 自体を終了するようにします。それなしでは、マスキングは安全に失敗します。コマンドはセンチネルのみを見ますが、センチネルは変更されずにサーバーに到達し、認証は失敗します。Claude Code はこの設定ミスをスタートアップ時と `/doctor` で報告します240プロキシはリクエストコンテンツ内の認証情報を置き換えるため、それらを見る必要があります。[`network.tlsTerminate`](/ja/settings#sandbox-settings) を設定して、プロキシが TLS 自体を終了するようにします。それなしでは、マスキングは安全に失敗します。コマンドはセンチネルのみを見ますが、センチネルは変更されずにサーバーに到達し、認証は失敗します。Claude Code はこの設定ミスをスタートアップ時に報告します

241 241 

242以下の例は 2 つのトークンをマスクします。`GH_TOKEN` は `api.github.com` へのリクエストでのみ置き換えられ、`NPM_TOKEN` は `injectHosts` を持たず、`network.allowedDomains` 内のすべてのホストへのリクエストで置き換えられます。各 `injectHosts` エントリ自体が `network.allowedDomains` でカバーされている必要があります。242以下の例は 2 つのトークンをマスクします。`GH_TOKEN` は `api.github.com` へのリクエストでのみ置き換えられ、`NPM_TOKEN` は `injectHosts` を持たず、`network.allowedDomains` 内のすべてのホストへのリクエストで置き換えられます。各 `injectHosts` エントリ自体が `network.allowedDomains` でカバーされている必要があります。

243 243 

Details

86動的にスケジュールされたループは、他のタスクと同様に[スケジュール済みタスクリスト](#manage-scheduled-tasks)に表示されるため、同じ方法でリストまたはキャンセルできます。[ジッタールール](#jitter)は適用されませんが、[7 日間の有効期限](#seven-day-expiry)は適用されます。ループは開始後 7 日で自動的に終了します。86動的にスケジュールされたループは、他のタスクと同様に[スケジュール済みタスクリスト](#manage-scheduled-tasks)に表示されるため、同じ方法でリストまたはキャンセルできます。[ジッタールール](#jitter)は適用されませんが、[7 日間の有効期限](#seven-day-expiry)は適用されます。ループは開始後 7 日で自動的に終了します。

87 87 

88<Note>88<Note>

89 Bedrock、Vertex AI、Microsoft Foundry では、間隔なしのプロンプトは固定 10 分スケジュールで実行されます。89 Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では、間隔なしのプロンプトは固定 10 分スケジュールで実行されます。

90</Note>90</Note>

91 91 

92<h3 id="run-the-built-in-maintenance-prompt">92<h3 id="run-the-built-in-maintenance-prompt">


108裸の `/loop` は、このプロンプトを[動的に選択された間隔](#let-claude-choose-the-interval)で実行します。例えば `/loop 15m` のように間隔を追加して、代わりに固定スケジュールで実行します。組み込みプロンプトを独自のデフォルトに置き換えるには、[loop.md でデフォルトプロンプトをカスタマイズする](#customize-the-default-prompt-with-loop-md)を参照してください。108裸の `/loop` は、このプロンプトを[動的に選択された間隔](#let-claude-choose-the-interval)で実行します。例えば `/loop 15m` のように間隔を追加して、代わりに固定スケジュールで実行します。組み込みプロンプトを独自のデフォルトに置き換えるには、[loop.md でデフォルトプロンプトをカスタマイズする](#customize-the-default-prompt-with-loop-md)を参照してください。

109 109 

110<Note>110<Note>

111 Bedrock、Vertex AI、Microsoft Foundry では、プロンプトなしの `/loop` は使用メッセージを出力する代わりにメンテナンスプロンプトを実行します。111 Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では、プロンプトなしの `/loop` は使用メッセージを出力する代わりにメンテナンスプロンプトを実行します。

112</Note>112</Note>

113 113 

114<h3 id="customize-the-default-prompt-with-loop-md">114<h3 id="customize-the-default-prompt-with-loop-md">


136`loop.md` への編集は次の反復で有効になるため、ループが実行中に指示を改善できます。どちらの場所にも `loop.md` が存在しない場合、ループは組み込みメンテナンスプロンプトにフォールバックします。ファイルは簡潔に保ってください。25,000 バイトを超えるコンテンツは切り詰められます。136`loop.md` への編集は次の反復で有効になるため、ループが実行中に指示を改善できます。どちらの場所にも `loop.md` が存在しない場合、ループは組み込みメンテナンスプロンプトにフォールバックします。ファイルは簡潔に保ってください。25,000 バイトを超えるコンテンツは切り詰められます。

137 137 

138<Note>138<Note>

139 Bedrock、Vertex AI、Microsoft Foundry では、`loop.md` は読み込まれず、プロンプトなしの `/loop` は使用メッセージを出力する代わりにメンテナンスプロンプトを実行します。139 Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では、`loop.md` は読み込まれず、プロンプトなしの `/loop` は使用メッセージを出力する代わりにメンテナンスプロンプトを実行します。

140</Note>140</Note>

141 141 

142<h3 id="stop-a-loop">142<h3 id="stop-a-loop">


145 145 

146`/loop` が次の反復を待機している間に停止するには、`Esc` を押してください。これにより、保留中のウェイクアップがクリアされるため、ループは再度実行されません。[Claude に直接依頼](#manage-scheduled-tasks)してスケジュールしたタスクは `Esc` の影響を受けず、削除するまで存在し続けます。146`/loop` が次の反復を待機している間に停止するには、`Esc` を押してください。これにより、保留中のウェイクアップがクリアされるため、ループは再度実行されません。[Claude に直接依頼](#manage-scheduled-tasks)してスケジュールしたタスクは `Esc` の影響を受けず、削除するまで存在し続けます。

147 147 

148[自分のペースモード](#let-claude-choose-the-interval)では、Claude はタスクが確実に完了したら次のウェイクアップをスケジュールしないことで、ループを自分で終了することもできます固定間隔のループは、停止するか[7 日が経過](#seven-day-expiry)するまで実行し続けます148[自分のペースモード](#let-claude-choose-the-interval)では、Claude はタスクが完了したら自分でループを終了することもできますClaude は [`ScheduleWakeup` ツール](/ja/tools-reference)を `stop: true` で呼び出し、保留中のウェイクアップを直ちにキャンセルします反復がスケジュール変更またはスケジュール停止のいずれも行わずに終了した場合、Claude Code は約 20 分後にフォールバックウェイクアップをスケジュールし、その反復がスケジュール変更も行わない場合にループを終了します。v2.1.202 より前は、スケジュール変更を行わないことが Claude がループを自分で終了できる唯一の方法でした。

149 

150固定間隔のループは、停止するか[7 日が経過](#seven-day-expiry)するまで実行し続けます。

149 151 

150<h2 id="set-a-one-time-reminder">152<h2 id="set-a-one-time-reminder">

151 1 回限りのリマインダーを設定する153 1 回限りのリマインダーを設定する

Details

219/plugin uninstall security-guidance@claude-plugins-official219/plugin uninstall security-guidance@claude-plugins-official

220```220```

221 221 

222プラグインがプロジェクトの `.claude/settings.json` を通じて有効化された場合、`/plugin` から無効化すると、チェックインファイルを編集するのではなく、`.claude/settings.local.json` にオーバーライドを書き込むため、プラグインはあなたにとってオフのままで、チームメイトは影響を受けません。[管理設定](/ja/admin-setup) を通じて有効化された場合、管理者のみがそれを無効化できます。222プラグインがプロジェクトの `.claude/settings.json` を通じて有効化された場合、`/plugin` から無効化すると、チェックインファイルを編集するのではなく、`.claude/settings.local.json` にオーバーライドを書き込むため、プラグインはあなたにとってオフのままで、チームメイトは影響を受けません。{/* min-version: 2.1.203 */}同じダイアログでは、共有 `.claude/settings.json` から削除することでプラグインをすべてのユーザーに対してアンインストールするオプションも提供されます。そのオプションには Claude Code v2.1.203 以降が必要です。[管理設定](/ja/admin-setup) を通じて有効化された場合、管理者のみがそれを無効化できます。

223 223 

224<h2 id="how-the-plugin-integrates-with-claude-code">224<h2 id="how-the-plugin-integrates-with-claude-code">

225 プラグインが Claude Code とどのように統合されるか225 プラグインが Claude Code とどのように統合されるか

Details

249サーバー管理設定は、サードパーティのモデルプロバイダーを使用する場合は利用できません。249サーバー管理設定は、サードパーティのモデルプロバイダーを使用する場合は利用できません。

250 250 

251* Amazon Bedrock251* Amazon Bedrock

252* Google Vertex AI252* Google Cloud の Agent Platform

253* Microsoft Foundry253* Microsoft Foundry

254* [Claude Platform on AWS](/ja/claude-platform-on-aws)254* [Claude Platform on AWS](/ja/claude-platform-on-aws)

255* `ANTHROPIC_BASE_URL` または [LLM ゲートウェイ](/ja/llm-gateway)を通じたカスタム API エンドポイント255* `ANTHROPIC_BASE_URL` または [LLM ゲートウェイ](/ja/llm-gateway)を通じたカスタム API エンドポイント

256 256 

257Bedrock、Vertex AI、および Foundry デプロイメントの場合、自己ホスト型の [Claude apps ゲートウェイ](/ja/claude-apps-gateway)は同等のリモート管理設定配信を提供します。ゲートウェイにサインインしたクライアントは、`api.anthropic.com` の代わりにゲートウェイから管理設定をフェッチします。起動時の失敗セマンティクスは異なります。ゲートウェイに到達できないゲートウェイクライアントはキャッシュされた設定にフォールバックする代わりにエラーで終了しますが、時間ごとのバックグラウンド更新は両方のチャネルで fail-open です。257Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry デプロイメントの場合、自己ホスト型の [Claude apps ゲートウェイ](/ja/claude-apps-gateway)は同等のリモート管理設定配信を提供します。ゲートウェイにサインインしたクライアントは、`api.anthropic.com` の代わりにゲートウェイから管理設定をフェッチします。起動時の失敗セマンティクスは異なります。ゲートウェイに到達できないゲートウェイクライアントはキャッシュされた設定にフォールバックする代わりにエラーで終了しますが、時間ごとのバックグラウンド更新は両方のチャネルで fail-open です。

258 258 

259<h2 id="audit-logging">259<h2 id="audit-logging">

260 監査ログ260 監査ログ

settings.md +22 −17

Details

95* **プロジェクト設定**はプロジェクトディレクトリに保存されます:95* **プロジェクト設定**はプロジェクトディレクトリに保存されます:

96 * `.claude/settings.json` ソース管理にチェックインされ、チームと共有される設定用96 * `.claude/settings.json` ソース管理にチェックインされ、チームと共有される設定用

97 * `.claude/settings.local.json` チェックインされない設定用。個人設定と実験に役立ちます。Claude Code は作成時に `.claude/settings.local.json` を無視するように git を構成します。自分でファイルを作成する場合は、gitignore に手動で追加してください。97 * `.claude/settings.local.json` チェックインされない設定用。個人設定と実験に役立ちます。Claude Code は作成時に `.claude/settings.local.json` を無視するように git を構成します。自分でファイルを作成する場合は、gitignore に手動で追加してください。

98 

99 このファイルはリポジトリのものではなく、あなたのものであるため、その権限 `allow` ルールは、`.claude/settings.json` allow ルールが必要とする[ワークスペース信頼](/ja/permissions#project-allow-rules-and-workspace-trust)ステップなしで有効になります。リポジトリがファイルを提供する場合(たとえば、コミットすることで)、ワークスペース信頼は引き続き適用されます。

98* **Managed 設定**:集中管理が必要な組織向けに、Claude Code は managed 設定の複数の配信メカニズムをサポートしています。すべて同じ JSON 形式を使用し、ユーザー設定またはプロジェクト設定でオーバーライドできません:100* **Managed 設定**:集中管理が必要な組織向けに、Claude Code は managed 設定の複数の配信メカニズムをサポートしています。すべて同じ JSON 形式を使用し、ユーザー設定またはプロジェクト設定でオーバーライドできません:

99 101 

100 * **サーバー管理設定**:Anthropic のサーバーから Claude.ai 管理コンソール経由で配信されるか、自己ホスト型の [Claude apps gateway](/ja/claude-apps-gateway)から配信されます。[サーバー管理設定](/ja/server-managed-settings)を参照してください。102 * **サーバー管理設定**:Anthropic のサーバーから Claude.ai 管理コンソール経由で配信されるか、自己ホスト型の [Claude apps gateway](/ja/claude-apps-gateway)から配信されます。[サーバー管理設定](/ja/server-managed-settings)を参照してください。


211`settings.json` は多くのオプションをサポートしています:213`settings.json` は多くのオプションをサポートしています:

212 214 

213| キー | 説明 | 例 |215| キー | 説明 | 例 |

214| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------------------ |216| :-------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |

215| `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"` |217| `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"` |

216| `agent` | メインスレッドを名前付き subagent として実行し、`claude agents` から派遣されたセッションのデフォルト agent を設定します。その subagent のシステムプロンプト、ツール制限、およびモデルを適用します。[subagents を明示的に呼び出す](/ja/sub-agents#invoke-subagents-explicitly)を参照してください | `"code-reviewer"` |218| `agent` | メインスレッドを名前付き subagent として実行し、`claude agents` から派遣されたセッションのデフォルト agent を設定します。その subagent のシステムプロンプト、ツール制限、およびモデルを適用します。[subagents を明示的に呼び出す](/ja/sub-agents#invoke-subagents-explicitly)を参照してください | `"code-reviewer"` |

217| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**デフォルト**:`false`。[リモートコントロール](/ja/remote-control)が接続されている場合、Claude がプロアクティブなプッシュ通知をスマートフォンに送信することを許可します。たとえば、長いタスクが完了したときなど。`/config` に**Claude が決定したときにプッシュ**として表示されます。[モバイルプッシュ通知](/ja/remote-control#mobile-push-notifications)を参照してください。Claude Code v2.1.119 以降が必要です | `true` |219| `agentPushNotifEnabled` | {/* min-version: 2.1.119 */}**デフォルト**:`false`。[リモートコントロール](/ja/remote-control)が接続されている場合、Claude がプロアクティブなプッシュ通知をスマートフォンに送信することを許可します。たとえば、長いタスクが完了したときなど。`/config` に**Claude が決定したときにプッシュ**として表示されます。[モバイルプッシュ通知](/ja/remote-control#mobile-push-notifications)を参照してください。Claude Code v2.1.119 以降が必要です | `true` |


224| `allowManagedPermissionRulesOnly` | (Managed 設定のみ)ユーザーおよびプロジェクト設定が `allow`、`ask`、または `deny` 権限ルールを定義するのを防止します。managed 設定のルールのみが適用されます。[Managed のみの設定](/ja/permissions#managed-only-settings)を参照してください | `true` |226| `allowManagedPermissionRulesOnly` | (Managed 設定のみ)ユーザーおよびプロジェクト設定が `allow`、`ask`、または `deny` 権限ルールを定義するのを防止します。managed 設定のルールのみが適用されます。[Managed のみの設定](/ja/permissions#managed-only-settings)を参照してください | `true` |

225| `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` |227| `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` |

226| `apiKeyHelper` | システムシェル(macOS と Linux では `/bin/sh`、Windows では `cmd`)を通じて実行される認証値を生成するカスタムコマンド。この値は、モデルリクエストの `X-Api-Key` および `Authorization: Bearer` ヘッダーとして送信されます。[`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/ja/env-vars)でリフレッシュ間隔を設定します | `/bin/generate_temp_api_key.sh` |228| `apiKeyHelper` | システムシェル(macOS と Linux では `/bin/sh`、Windows では `cmd`)を通じて実行される認証値を生成するカスタムコマンド。この値は、モデルリクエストの `X-Api-Key` および `Authorization: Bearer` ヘッダーとして送信されます。[`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](/ja/env-vars)でリフレッシュ間隔を設定します | `/bin/generate_temp_api_key.sh` |

229| `askUserQuestionTimeout` | {/* min-version: 2.1.200 */}**デフォルト**:`"never"`。アイドル時間。未回答の [`AskUserQuestion`](/ja/tools-reference)ダイアログが、既に選択したオプションで自動的に続行するまで。`"60s"`、`"5m"`、`"10m"`、または `"never"` を受け入れます。デフォルトでは、質問は回答するまで待機します。`/config` に**質問自動継続タイムアウト**として表示されます。プロジェクトまたはローカル設定から読み込まれません。Claude Code v2.1.200 以降が必要です | `"5m"` |

227| `attribution` | git コミットとプルリクエストの属性をカスタマイズします。[属性設定](#attribution-settings)を参照してください | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |230| `attribution` | git コミットとプルリクエストの属性をカスタマイズします。[属性設定](#attribution-settings)を参照してください | `{"commit": "🤖 Generated with Claude Code", "pr": ""}` |

228| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**デフォルト**:`true`。コンテキストが制限に近づくと、会話を自動的にコンパクトにします。`/config` に**自動コンパクト**として表示されます。環境変数で無効にするには、`env` で [`DISABLE_AUTO_COMPACT`](/ja/env-vars)を設定します | `false` |231| `autoCompactEnabled` | {/* min-version: 2.1.119 */}**デフォルト**:`true`。コンテキストが制限に近づくと、会話を自動的にコンパクトにします。`/config` に**自動コンパクト**として表示されます。環境変数で無効にするには、`env` で [`DISABLE_AUTO_COMPACT`](/ja/env-vars)を設定します | `false` |

229| `autoMemoryDirectory` | [自動メモリ](/ja/memory#storage-location)ストレージ用のカスタムディレクトリ。絶対パスまたは `~/` プレフィックス付きパスを受け入れます。プロジェクトまたはローカル設定からは、ワークスペース信頼ダイアログを受け入れた後にのみ尊重されます。クローンされたリポジトリがこのファイルを提供できるため | `"~/my-memory-dir"` |232| `autoMemoryDirectory` | [自動メモリ](/ja/memory#storage-location)ストレージ用のカスタムディレクトリ。絶対パスまたは `~/` プレフィックス付きパスを受け入れます。プロジェクトまたはローカル設定からは、ワークスペース信頼ダイアログを受け入れた後にのみ尊重されます。クローンされたリポジトリがこのファイルを提供できるため | `"~/my-memory-dir"` |


238| `awsCredentialExport` | AWS 認証情報を含む JSON を出力するカスタムスクリプト([高度な認証情報構成](/ja/amazon-bedrock#advanced-credential-configuration)を参照) | `/bin/generate_aws_grant.sh` |241| `awsCredentialExport` | AWS 認証情報を含む JSON を出力するカスタムスクリプト([高度な認証情報構成](/ja/amazon-bedrock#advanced-credential-configuration)を参照) | `/bin/generate_aws_grant.sh` |

239| `axScreenReader` | {/* min-version: 2.1.181 */}スクリーンリーダーフレンドリーな出力をレンダリングします:装飾的なボーダーやアニメーションのないフラットテキスト。スクリーンリーダーモードは常にクラシックレンダラーを使用するため、`tui` 設定はアクティブな間は効果がありません。[`CLAUDE_AX_SCREEN_READER`](/ja/env-vars)環境変数と [`--ax-screen-reader`](/ja/cli-reference#cli-flags)フラグが優先されます。Claude Code v2.1.181 以降が必要です | `true` |242| `axScreenReader` | {/* min-version: 2.1.181 */}スクリーンリーダーフレンドリーな出力をレンダリングします:装飾的なボーダーやアニメーションのないフラットテキスト。スクリーンリーダーモードは常にクラシックレンダラーを使用するため、`tui` 設定はアクティブな間は効果がありません。[`CLAUDE_AX_SCREEN_READER`](/ja/env-vars)環境変数と [`--ax-screen-reader`](/ja/cli-reference#cli-flags)フラグが優先されます。Claude Code v2.1.181 以降が必要です | `true` |

240| `blockedMarketplaces` | (Managed 設定のみ)マーケットプレイスソースのブロックリスト。マーケットプレイス追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時に適用されるため、ポリシーが設定される前に追加されたマーケットプレイスは使用できません。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れることはありません。[Managed マーケットプレイス制限](/ja/plugin-marketplaces#managed-marketplace-restrictions)を参照してください | `[{ "source": "github", "repo": "untrusted/plugins" }]` |243| `blockedMarketplaces` | (Managed 設定のみ)マーケットプレイスソースのブロックリスト。マーケットプレイス追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時に適用されるため、ポリシーが設定される前に追加されたマーケットプレイスは使用できません。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れることはありません。[Managed マーケットプレイス制限](/ja/plugin-marketplaces#managed-marketplace-restrictions)を参照してください | `[{ "source": "github", "repo": "untrusted/plugins" }]` |

244| `browserExternalPageTools` | (Managed 設定のみ)デスクトップアプリの [Browser ペイン](/ja/desktop#browse-external-sites)で外部ページを読み取ったり操作したりするツールを使用するのを防ぐために `"disabled"` に設定します。ユーザーは引き続き外部サイトに自分で移動できます。ローカル開発サーバープレビューは影響を受けません | `"disabled"` |

241| `channelsEnabled` | (Managed 設定のみ)組織に対して[チャネル](/ja/channels)を許可します。Claude.ai Team および Enterprise プランでは、これが未設定または `false` の場合、チャネルはブロックされます。[Anthropic Console](/ja/authentication#claude-console-authentication)アカウントで API キー認証を使用している場合、チャネルはデフォルトで許可されます。ただし、組織が managed 設定をデプロイしている場合は、このキーを `true` に設定する必要があります | `true` |245| `channelsEnabled` | (Managed 設定のみ)組織に対して[チャネル](/ja/channels)を許可します。Claude.ai Team および Enterprise プランでは、これが未設定または `false` の場合、チャネルはブロックされます。[Anthropic Console](/ja/authentication#claude-console-authentication)アカウントで API キー認証を使用している場合、チャネルはデフォルトで許可されます。ただし、組織が managed 設定をデプロイしている場合は、このキーを `true` に設定する必要があります | `true` |

242| `claudeMd` | (Managed 設定のみ)CLAUDE.md スタイルの命令が組織管理メモリとして注入されます。managed またはポリシー設定で設定されている場合のみ尊重され、ユーザー、プロジェクト、およびローカル設定では無視されます。[組織全体の CLAUDE.md](/ja/memory#deploy-organization-wide-claude-md)を参照してください | `"Always run make lint before committing."` |246| `claudeMd` | (Managed 設定のみ)CLAUDE.md スタイルの命令が組織管理メモリとして注入されます。managed またはポリシー設定で設定されている場合のみ尊重され、ユーザー、プロジェクト、およびローカル設定では無視されます。[組織全体の CLAUDE.md](/ja/memory#deploy-organization-wide-claude-md)を参照してください | `"Always run make lint before committing."` |

243| `claudeMdExcludes` | [メモリ](/ja/memory)を読み込むときにスキップする `CLAUDE.md` ファイルの Glob パターンまたは絶対パス。パターンは絶対ファイルパスに対してマッチします。ユーザー、プロジェクト、およびローカルメモリのみに適用されます。managed ポリシーファイルは除外できません | `["**/vendor/**/CLAUDE.md"]` |247| `claudeMdExcludes` | [メモリ](/ja/memory)を読み込むときにスキップする `CLAUDE.md` ファイルの Glob パターンまたは絶対パス。パターンは絶対ファイルパスに対してマッチします。ユーザー、プロジェクト、およびローカルメモリのみに適用されます。managed ポリシーファイルは除外できません | `["**/vendor/**/CLAUDE.md"]` |

244| `cleanupPeriodDays` | **デフォルト**:`30` 日、最小 `1`。この期間より長く非アクティブなセッションは起動時に削除されます。`0` に設定するとバリデーションエラーで拒否されます。また、起動時に[孤立した subagent worktrees](/ja/worktrees#clean-up-worktrees)の自動削除の年齢カットオフも制御します。トランスクリプト書き込みを完全に無効にするには、[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ja/env-vars)環境変数を設定するか、非インタラクティブモード(`-p`)で `--no-session-persistence` フラグまたは `persistSession: false` SDK オプションを使用します。 | `20` |248| `cleanupPeriodDays` | **デフォルト**:`30` 日、最小 `1`。この期間より長く非アクティブなセッションは起動時に削除されます。`0` に設定するとバリデーションエラーで拒否されます。また、起動時に[孤立した worktrees](/ja/worktrees#clean-up-worktrees)の自動削除の年齢カットオフも制御します。{/* min-version: 2.1.203 */}Claude Code が設定ファイルを読み込めないか解析できない場合、保持クリーンアップスイープを一時停止し、ファイルを修正するまで `/status` に警告を表示します。ただし、[managed 設定](/ja/server-managed-settings)が `cleanupPeriodDays` を提供する場合は、スイープは managed 値で実行されます。v2.1.203 より前では、クリーンアップは 30 日のデフォルトでその状態で実行され、より長い `cleanupPeriodDays` が保持することを意図していたトランスクリプトを削除できました。30 日より新しいファイルは削除されませんでした。トランスクリプト書き込みを完全に無効にするには、[`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/ja/env-vars)環境変数を設定するか、非インタラクティブモード(`-p`)で `--no-session-persistence` フラグまたは `persistSession: false` SDK オプションを使用します。 | `20` |

245| `companyAnnouncements` | 起動時にユーザーに表示するアナウンス。複数のアナウンスが提供される場合、ランダムにサイクルされます。 | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |249| `companyAnnouncements` | 起動時にユーザーに表示するアナウンス。複数のアナウンスが提供される場合、ランダムにサイクルされます。 | `["Welcome to Acme Corp! Review our code guidelines at docs.acme.com"]` |

246| `defaultShell` | **デフォルト**:`"bash"`、または Bash が利用できない場合は Windows で `"powershell"`。入力ボックス `!` コマンドのデフォルトシェル。`"bash"` または `"powershell"` を受け入れます。`"powershell"` を設定すると、インタラクティブ `!` コマンドが Windows 上の PowerShell を通じてルーティングされます。`CLAUDE_CODE_USE_POWERSHELL_TOOL=1` が必要です。[PowerShell ツール](/ja/tools-reference#powershell-tool)を参照してください | `"powershell"` |250| `defaultShell` | **デフォルト**:`"bash"`、または Bash が利用できない場合は Windows で `"powershell"`。入力ボックス `!` コマンドのデフォルトシェル。`"bash"` または `"powershell"` を受け入れます。`"powershell"` を設定すると、インタラクティブ `!` コマンドが Windows 上の PowerShell を通じてルーティングされます。`CLAUDE_CODE_USE_POWERSHELL_TOOL=1` が必要です。[PowerShell ツール](/ja/tools-reference#powershell-tool)を参照してください | `"powershell"` |

247| `deniedMcpServers` | managed-settings.json で設定されている場合、明示的にブロックされた MCP サーバーの拒否リスト。managed サーバーを含むすべてのスコープに適用されます。拒否リストがホワイトリストよりも優先されます。[Managed MCP 構成](/ja/managed-mcp)を参照してください | `[{ "serverName": "filesystem" }]` |251| `deniedMcpServers` | managed-settings.json で設定されている場合、明示的にブロックされた MCP サーバーの拒否リスト。managed サーバーを含むすべてのスコープに適用されます。拒否リストがホワイトリストよりも優先されます。[Managed MCP 構成](/ja/managed-mcp)を参照してください | `[{ "serverName": "filesystem" }]` |


266| `env` | すべてのセッションに適用される環境変数。{/* min-version: 2.1.143 */}v2.1.143 以降、`NO_COLOR` と `FORCE_COLOR` がここで設定されている場合、サブプロセスに渡されますが、Claude Code 自体のインターフェイスの色は変更されません。インターフェイスの色を変更するには、`claude` を起動する前にシェルでこれらを設定します。{/* min-version: 2.1.195 */}v2.1.195 以降、Claude Code のホスティング環境が設定する ID 変数(`CLAUDE_CODE_REMOTE` や `CLAUDE_CODE_ACCOUNT_UUID` など)は、ここで設定されている場合は無視されます | `{"FOO": "bar"}` |270| `env` | すべてのセッションに適用される環境変数。{/* min-version: 2.1.143 */}v2.1.143 以降、`NO_COLOR` と `FORCE_COLOR` がここで設定されている場合、サブプロセスに渡されますが、Claude Code 自体のインターフェイスの色は変更されません。インターフェイスの色を変更するには、`claude` を起動する前にシェルでこれらを設定します。{/* min-version: 2.1.195 */}v2.1.195 以降、Claude Code のホスティング環境が設定する ID 変数(`CLAUDE_CODE_REMOTE` や `CLAUDE_CODE_ACCOUNT_UUID` など)は、ここで設定されている場合は無視されます | `{"FOO": "bar"}` |

267| `fallbackModel` | プライマリモデルがオーバーロードされているか利用できない場合に順番に試すフォールバックモデル。Claude Code はチェーン内の次の利用可能なモデルに切り替え、ターンの残りを表示し、通知を表示します。`"default"` はデフォルトモデルに展開されます。チェーンは 3 つのモデルに制限されます。余分なエントリは無視されます。ほとんどの配列設定とは異なり、このキーはスコープ全体でマージされません:これを定義する最高優先度ファイルが全体の値を提供します。[`--fallback-model`](/ja/cli-reference#cli-flags)フラグはこれを 1 セッション間オーバーライドします。[フォールバックモデルチェーン](/ja/model-config#fallback-model-chains)を参照してください | `["claude-sonnet-5", "claude-haiku-4-5"]` |271| `fallbackModel` | プライマリモデルがオーバーロードされているか利用できない場合に順番に試すフォールバックモデル。Claude Code はチェーン内の次の利用可能なモデルに切り替え、ターンの残りを表示し、通知を表示します。`"default"` はデフォルトモデルに展開されます。チェーンは 3 つのモデルに制限されます。余分なエントリは無視されます。ほとんどの配列設定とは異なり、このキーはスコープ全体でマージされません:これを定義する最高優先度ファイルが全体の値を提供します。[`--fallback-model`](/ja/cli-reference#cli-flags)フラグはこれを 1 セッション間オーバーライドします。[フォールバックモデルチェーン](/ja/model-config#fallback-model-chains)を参照してください | `["claude-sonnet-5", "claude-haiku-4-5"]` |

268| `fastModePerSessionOptIn` | `true` の場合、高速モードはセッション全体で永続化されません。各セッションは高速モードがオフで開始され、ユーザーが `/fast` で有効にする必要があります。ユーザーの高速モード設定は引き続き保存されます。[セッションごとのオプトインを要求](/ja/fast-mode#require-per-session-opt-in)を参照してください | `true` |272| `fastModePerSessionOptIn` | `true` の場合、高速モードはセッション全体で永続化されません。各セッションは高速モードがオフで開始され、ユーザーが `/fast` で有効にする必要があります。ユーザーの高速モード設定は引き続き保存されます。[セッションごとのオプトインを要求](/ja/fast-mode#require-per-session-opt-in)を参照してください | `true` |

269| `feedbackSurveyRate` | [セッション品質調査](/ja/data-usage#session-quality-surveys)が適格な場合に表示される確率(0~1)。完全に抑制するには `0` に設定するか、`env` で [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/ja/env-vars)を設定します。Bedrock、Vertex、または Foundry を使用する場合に役立ちます。デフォルトのサンプルレートは適用されません | `0.05` |273| `feedbackSurveyRate` | [セッション品質調査](/ja/data-usage#session-quality-surveys)が適格な場合に表示される確率(0~1)。完全に抑制するには `0` に設定するか、`env` で [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](/ja/env-vars)を設定します。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を使用する場合に役立ちます。デフォルトのサンプルレートは適用されません | `0.05` |

270| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**デフォルト**:`true`。各編集の前にファイルをスナップショットして、[`/rewind`](/ja/checkpointing)でそれらを復元できるようにします。`/config` に\*\*コードを巻き戻す(チェックポイント)\*\*として表示されます。環境変数で無効にするには、`env` で [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/ja/env-vars)を設定します | `false` |274| `fileCheckpointingEnabled` | {/* min-version: 2.1.119 */}**デフォルト**:`true`。各編集の前にファイルをスナップショットして、[`/rewind`](/ja/checkpointing)でそれらを復元できるようにします。`/config` に\*\*コードを巻き戻す(チェックポイント)\*\*として表示されます。環境変数で無効にするには、`env` で [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](/ja/env-vars)を設定します | `false` |

271| `fileSuggestion` | `@` ファイルオートコンプリート用のカスタムスクリプトを構成します。[ファイル提案設定](#file-suggestion-settings)を参照してください | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |275| `fileSuggestion` | `@` ファイルオートコンプリート用のカスタムスクリプトを構成します。[ファイル提案設定](#file-suggestion-settings)を参照してください | `{"type": "command", "command": "~/.claude/file-suggestion.sh"}` |

272| `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}"}]` |276| `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}"}]` |

273| `forceLoginMethod` | `claudeai` を使用して Claude.ai アカウントへのログインを制限するか、`console` を使用して Claude Console アカウントへのログインを制限するか、`gateway` を使用してクラウドゲートウェイへのログインを制限します。[Claude apps gateway](/ja/claude-apps-gateway)を参照してください。managed 設定で設定されている場合、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` で認証されたセッションは起動時にブロックされます。環境認証情報は必須のログイン方法を満たすことができないため。Bedrock、Vertex、Foundry などのサードパーティプロバイダーセッションはブロックされません:これらはクラウドプロバイダーではなく Anthropic に対して認証されます | `claudeai` |277| `forceLoginMethod` | `claudeai` を使用して Claude.ai アカウントへのログインを制限するか、`console` を使用して Claude Console アカウントへのログインを制限するか、`gateway` を使用してクラウドゲートウェイへのログインを制限します。[Claude apps gateway](/ja/claude-apps-gateway)を参照してください。managed 設定で設定されている場合、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` で認証されたセッションは起動時にブロックされます。環境認証情報は必須のログイン方法を満たすことができないため。Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry などのサードパーティプロバイダーセッションはブロックされません:これらはクラウドプロバイダーではなく Anthropic に対して認証されます | `claudeai` |

274| `forceLoginGatewayUrl` | `/login` クラウドゲートウェイ画面でゲートウェイ URL を事前入力してロックします。このキーまたは `forceLoginMethod: "gateway"` のいずれかがその画面を表示します。両方を設定して URL が入力されるようにします。managed ポリシーティアでのみ尊重されます。ユーザーおよびプロジェクト設定では無視されます。[Claude apps gateway](/ja/claude-apps-gateway#set-the-gateway-url)を参照してください | `"https://claude-gateway.example.com"` |278| `forceLoginGatewayUrl` | `/login` クラウドゲートウェイ画面でゲートウェイ URL を事前入力してロックします。このキーまたは `forceLoginMethod: "gateway"` のいずれかがその画面を表示します。両方を設定して URL が入力されるようにします。managed ポリシーティアでのみ尊重されます。ユーザーおよびプロジェクト設定では無視されます。[Claude apps gateway](/ja/claude-apps-gateway#set-the-gateway-url)を参照してください | `"https://claude-gateway.example.com"` |

275| `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"]` |279| `forceLoginOrgUUID` | ログインが特定の Anthropic 組織に属することを要求します。単一の UUID 文字列を受け入れます。これはログイン中にその組織を自動的に事前選択するか、リストされた組織のいずれかが受け入れられる UUID の配列を受け入れます。事前選択なし。managed 設定で設定されている場合、認証されたアカウントがリストされた組織に属していない場合、ログインは失敗します。`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` で認証されたセッションは起動時にブロックされます。これらのセッションでは組織メンバーシップを検証できないため。Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry などのサードパーティプロバイダーセッションはブロックされません:クラウド IAM を使用して、どのクラウドアカウントを使用できるかを制限します。空配列は失敗して閉じられ、ログインを設定ミスメッセージでブロックします | `"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"` または `["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]` |

276| `forceRemoteSettingsRefresh` | (Managed 設定のみ)リモート managed 設定がサーバーから新しく取得されるまで CLI スタートアップをブロックします。フェッチが失敗した場合、キャッシュされた設定または設定なしで続行するのではなく、CLI は終了します。設定されていない場合、スタートアップはリモート設定を待たずに続行します。[fail-closed 強制](/ja/server-managed-settings#enforce-fail-closed-startup)を参照してください | `true` |280| `forceRemoteSettingsRefresh` | (Managed 設定のみ)リモート managed 設定がサーバーから新しく取得されるまで CLI スタートアップをブロックします。フェッチが失敗した場合、キャッシュされた設定または設定なしで続行するのではなく、CLI は終了します。設定されていない場合、スタートアップはリモート設定を待たずに続行します。[fail-closed 強制](/ja/server-managed-settings#enforce-fail-closed-startup)を参照してください | `true` |

277| `gcpAuthRefresh` | GCP Application Default Credentials が期限切れになったか読み込めない場合にリフレッシュするカスタムスクリプト。[高度な認証情報構成](/ja/google-vertex-ai#advanced-credential-configuration)を参照してください | `gcloud auth application-default login` |281| `gcpAuthRefresh` | GCP Application Default Credentials が期限切れになったか読み込めない場合にリフレッシュするカスタムスクリプト。[高度な認証情報構成](/ja/google-vertex-ai#advanced-credential-configuration)を参照してください | `gcloud auth application-default login` |

278| `hooks` | ライフサイクルイベントで実行するカスタムコマンドを構成します。形式については [hooks ドキュメント](/ja/hooks)を参照してください | [hooks](/ja/hooks)を参照 |282| `hooks` | ライフサイクルイベントで実行するカスタムコマンドを構成します。形式については [hooks ドキュメント](/ja/hooks)を参照してください | [hooks](/ja/hooks)を参照 |


282| `language` | Claude の優先応答言語を構成します(例:`"japanese"`、`"spanish"`、`"french"`)。Claude はデフォルトでこの言語で応答します。また、[音声ディクテーション](/ja/voice-dictation#change-the-dictation-language)言語も設定します。{/* min-version: 2.1.176 */}v2.1.176 以降、設定されていない場合、セッションタイトルは会話の言語と一致します | `"japanese"` |286| `language` | Claude の優先応答言語を構成します(例:`"japanese"`、`"spanish"`、`"french"`)。Claude はデフォルトでこの言語で応答します。また、[音声ディクテーション](/ja/voice-dictation#change-the-dictation-language)言語も設定します。{/* min-version: 2.1.176 */}v2.1.176 以降、設定されていない場合、セッションタイトルは会話の言語と一致します | `"japanese"` |

283| `minimumVersion` | バックグラウンド自動更新と `claude update` が特定のバージョン以下にインストールするのを防止するフロア。`"latest"` チャネルから `"stable"` に `/config` を通じて切り替えると、現在のバージョンに留まるか、ダウングレードを許可するかを求めるプロンプトが表示されます。留まることを選択すると、この値が設定されます。また、[managed 設定](/ja/permissions#managed-settings)で組織全体の最小値をピンするのに役立ちます。ハードフロアについては、`requiredMinimumVersion` を参照してください | `"2.1.100"` |287| `minimumVersion` | バックグラウンド自動更新と `claude update` が特定のバージョン以下にインストールするのを防止するフロア。`"latest"` チャネルから `"stable"` に `/config` を通じて切り替えると、現在のバージョンに留まるか、ダウングレードを許可するかを求めるプロンプトが表示されます。留まることを選択すると、この値が設定されます。また、[managed 設定](/ja/permissions#managed-settings)で組織全体の最小値をピンするのに役立ちます。ハードフロアについては、`requiredMinimumVersion` を参照してください | `"2.1.100"` |

284| `model` | Claude Code に使用するデフォルトモデルをオーバーライドします。`--model` と [`ANTHROPIC_MODEL`](/ja/model-config#environment-variables)はこれを 1 セッション間オーバーライドします | `"claude-sonnet-5"` |288| `model` | Claude Code に使用するデフォルトモデルをオーバーライドします。`--model` と [`ANTHROPIC_MODEL`](/ja/model-config#environment-variables)はこれを 1 セッション間オーバーライドします | `"claude-sonnet-5"` |

285| `modelOverrides` | Anthropic モデル ID を Bedrock 推論プロファイル ARN などのプロバイダー固有のモデル ID にマップします。各モデルピッカーエントリは、プロバイダー API を呼び出すときにマップされた値を使用します。[バージョンごとにモデル ID をオーバーライド](/ja/model-config#override-model-ids-per-version)を参照してください | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |289| `modelOverrides` | Anthropic モデル ID を Amazon Bedrock 推論プロファイル ARN などのプロバイダー固有のモデル ID にマップします。各モデルピッカーエントリは、プロバイダー API を呼び出すときにマップされた値を使用します。[バージョンごとにモデル ID をオーバーライド](/ja/model-config#override-model-ids-per-version)を参照してください | `{"claude-opus-4-6": "arn:aws:bedrock:..."}` |

286| `otelHeadersHelper` | 動的 OpenTelemetry ヘッダーを生成するスクリプト。起動時および定期的に実行されます。[`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/ja/env-vars)でリフレッシュ間隔を設定します。[動的ヘッダー](/ja/monitoring-usage#dynamic-headers)を参照してください | `/bin/generate_otel_headers.sh` |290| `otelHeadersHelper` | 動的 OpenTelemetry ヘッダーを生成するスクリプト。起動時および定期的に実行されます。[`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](/ja/env-vars)でリフレッシュ間隔を設定します。[動的ヘッダー](/ja/monitoring-usage#dynamic-headers)を参照してください | `/bin/generate_otel_headers.sh` |

287| `outputStyle` | システムプロンプトを調整するための出力スタイルを構成します。[出力スタイルドキュメント](/ja/output-styles)を参照してください | `"Explanatory"` |291| `outputStyle` | システムプロンプトを調整するための出力スタイルを構成します。[出力スタイルドキュメント](/ja/output-styles)を参照してください | `"Explanatory"` |

288| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Managed 設定のみ)**デフォルト**:`"first-wins"`。Agent SDK または IDE 拡張機能などの埋め込みホストプロセスによってプログラム的に提供される managed 設定が、管理者デプロイ済みの managed ティアも存在する場合に適用されるかどうかを制御します。`"first-wins"`:親提供の設定は削除され、管理者ティアのみが適用されます。`"merge"`:親提供の設定は管理者ティアの下で適用され、ポリシーを厳しくできるが緩くすることはできないようにフィルタリングされます。管理者ティアがデプロイされていない場合は効果がありません。Claude Code v2.1.133 以降が必要です | `"merge"` |292| `parentSettingsBehavior` | {/* min-version: 2.1.133 */}(Managed 設定のみ)**デフォルト**:`"first-wins"`。Agent SDK または IDE 拡張機能などの埋め込みホストプロセスによってプログラム的に提供される managed 設定が、管理者デプロイ済みの managed ティアも存在する場合に適用されるかどうかを制御します。`"first-wins"`:親提供の設定は削除され、管理者ティアのみが適用されます。`"merge"`:親提供の設定は管理者ティアの下で適用され、ポリシーを厳しくできるが緩くすることはできないようにフィルタリングされます。管理者ティアがデプロイされていない場合は効果がありません。Claude Code v2.1.133 以降が必要です | `"merge"` |


305| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**デフォルト**:`0.01`(1%)。[スキルリスティング](/ja/skills#skill-descriptions-are-cut-short)Claude が各ターンで見るモデルのコンテキストウィンドウ用に予約されたフラクション。リスティングが予算を超える場合、最も使用頻度の低いスキルの説明は、Claude が引き続き呼び出すことができるが理由を見ることができないように、ベアネームに折りたたまれます。より多くの説明を表示するために上げるか、より多くのスキルを収めるために下げます。`/doctor` は現在の切り詰めカウントと影響を受けるスキルを表示します。Claude Code v2.1.105 以降が必要です | `0.02` |309| `skillListingBudgetFraction` | {/* min-version: 2.1.105 */}**デフォルト**:`0.01`(1%)。[スキルリスティング](/ja/skills#skill-descriptions-are-cut-short)Claude が各ターンで見るモデルのコンテキストウィンドウ用に予約されたフラクション。リスティングが予算を超える場合、最も使用頻度の低いスキルの説明は、Claude が引き続き呼び出すことができるが理由を見ることができないように、ベアネームに折りたたまれます。より多くの説明を表示するために上げるか、より多くのスキルを収めるために下げます。`/doctor` は現在の切り詰めカウントと影響を受けるスキルを表示します。Claude Code v2.1.105 以降が必要です | `0.02` |

306| `skillListingMaxDescChars` | {/* min-version: 2.1.105 */}**デフォルト**:`1536`。[スキルリスティング](/ja/skills#skill-descriptions-are-cut-short)Claude が各ターンで見る `description` と `when_to_use` テキストの結合されたスキルごとの文字上限。この長さより長いテキストは切り詰められます。長い説明を保持するために上げるか、より多くのスキルを [`skillListingBudgetFraction`](#available-settings)の下に収めるために下げます。Claude Code v2.1.105 以降が必要です | `2048` |310| `skillListingMaxDescChars` | {/* min-version: 2.1.105 */}**デフォルト**:`1536`。[スキルリスティング](/ja/skills#skill-descriptions-are-cut-short)Claude が各ターンで見る `description` と `when_to_use` テキストの結合されたスキルごとの文字上限。この長さより長いテキストは切り詰められます。長い説明を保持するために上げるか、より多くのスキルを [`skillListingBudgetFraction`](#available-settings)の下に収めるために下げます。Claude Code v2.1.105 以降が必要です | `2048` |

307| `skillOverrides` | {/* min-version: 2.1.129 */}スキル名でキー付けされたスキルごとの可視性オーバーライド。値は `"on"`、`"name-only"`、`"user-invocable-only"`、または `"off"` です。スキルの SKILL.md を編集することなく、スキルを非表示または折りたたむことができます。プラグインスキルには適用されません。これらは `/plugin` を通じて管理されます。`/skills` メニューはこれらを `.claude/settings.local.json` に書き込みます。[設定からスキルの可視性をオーバーライド](/ja/skills#override-skill-visibility-from-settings)を参照してください。Claude Code v2.1.129 以降が必要です | `{"legacy-context": "name-only", "deploy": "off"}` |311| `skillOverrides` | {/* min-version: 2.1.129 */}スキル名でキー付けされたスキルごとの可視性オーバーライド。値は `"on"`、`"name-only"`、`"user-invocable-only"`、または `"off"` です。スキルの SKILL.md を編集することなく、スキルを非表示または折りたたむことができます。プラグインスキルには適用されません。これらは `/plugin` を通じて管理されます。`/skills` メニューはこれらを `.claude/settings.local.json` に書き込みます。[設定からスキルの可視性をオーバーライド](/ja/skills#override-skill-visibility-from-settings)を参照してください。Claude Code v2.1.129 以降が必要です | `{"legacy-context": "name-only", "deploy": "off"}` |

308| `skipWebFetchPreflight` | [WebFetch ドメイン安全チェック](/ja/data-usage#webfetch-domain-safety-check)をスキップします。このチェックは、フェッチ前に各リクエストされたホスト名を `api.anthropic.com` に送信します。Bedrock、Vertex AI、または制限的な出力を持つ Foundry デプロイメントなど、Anthropic へのトラフィックをブロックする環境で `true` に設定します。スキップされた場合、WebFetch はブロックリストを参照せずに任意の URL を試みます | `true` |312| `skipWebFetchPreflight` | [WebFetch ドメイン安全チェック](/ja/data-usage#webfetch-domain-safety-check)をスキップします。このチェックは、フェッチ前に各リクエストされたホスト名を `api.anthropic.com` に送信します。Amazon Bedrock、Google Cloud の Agent Platform、または制限的な出力を持つ Microsoft Foundry デプロイメントなど、Anthropic へのトラフィックをブロックする環境で `true` に設定します。スキップされた場合、WebFetch はブロックリストを参照せずに任意の URL を試みます | `true` |

309| `spinnerTipsEnabled` | **デフォルト**:`true`。Claude が作業中にスピナーにヒントを表示します。ヒントを無効にするには `false` に設定します | `false` |313| `spinnerTipsEnabled` | **デフォルト**:`true`。Claude が作業中にスピナーにヒントを表示します。ヒントを無効にするには `false` に設定します | `false` |

310| `spinnerTipsOverride` | スピナーヒントをカスタム文字列でオーバーライドします。`tips`:ヒント文字列の配列。`excludeDefault`:`true` の場合、カスタムヒントのみを表示します。`false` または不在の場合、カスタムヒントは組み込みヒントとマージされます | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |314| `spinnerTipsOverride` | スピナーヒントをカスタム文字列でオーバーライドします。`tips`:ヒント文字列の配列。`excludeDefault`:`true` の場合、カスタムヒントのみを表示します。`false` または不在の場合、カスタムヒントは組み込みヒントとマージされます | `{ "excludeDefault": true, "tips": ["Use our internal tool X"] }` |

311| `spinnerVerbs` | スピナーに表示されるアクション動詞をカスタマイズします。`mode` を `"replace"` に設定して動詞のみを使用するか、`"append"` に設定してデフォルトに追加します | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |315| `spinnerVerbs` | スピナーに表示されるアクション動詞をカスタマイズします。`mode` を `"replace"` に設定して動詞のみを使用するか、`"append"` に設定してデフォルトに追加します | `{"mode": "append", "verbs": ["Pondering", "Crafting"]}` |


314| `strictKnownMarketplaces` | (Managed 設定のみ)プラグインマーケットプレイスソースのホワイトリスト。未定義 = 制限なし、空配列 = ロックダウン。マーケットプレイス追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時に適用されるため、ポリシーが設定される前に追加されたマーケットプレイスは使用できません。[Managed マーケットプレイス制限](/ja/plugin-marketplaces#managed-marketplace-restrictions)を参照してください | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |318| `strictKnownMarketplaces` | (Managed 設定のみ)プラグインマーケットプレイスソースのホワイトリスト。未定義 = 制限なし、空配列 = ロックダウン。マーケットプレイス追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時に適用されるため、ポリシーが設定される前に追加されたマーケットプレイスは使用できません。[Managed マーケットプレイス制限](/ja/plugin-marketplaces#managed-marketplace-restrictions)を参照してください | `[{ "source": "github", "repo": "acme-corp/plugins" }]` |

315| `strictPluginOnlyCustomization` | (Managed 設定のみ)ユーザーおよびプロジェクトソースからの skills、agents、hooks、および MCP サーバーをブロックして、プラグインまたは managed 設定からのみ取得できるようにします。`true` は 4 つすべてをロックします。配列は名前付きのものだけをロックします。[`strictPluginOnlyCustomization`](#strictpluginonlycustomization)を参照してください | `["skills", "hooks"]` |319| `strictPluginOnlyCustomization` | (Managed 設定のみ)ユーザーおよびプロジェクトソースからの skills、agents、hooks、および MCP サーバーをブロックして、プラグインまたは managed 設定からのみ取得できるようにします。`true` は 4 つすべてをロックします。配列は名前付きのものだけをロックします。[`strictPluginOnlyCustomization`](#strictpluginonlycustomization)を参照してください | `["skills", "hooks"]` |

316| `syntaxHighlightingDisabled` | diff、コードブロック、ファイルプレビューの構文強調表示を無効にします | `true` |320| `syntaxHighlightingDisabled` | diff、コードブロック、ファイルプレビューの構文強調表示を無効にします | `true` |

317| `teammateMode` | **デフォルト**:`in-process`。[エージェントチーム](/ja/agent-teams)チームメイトの表示方法:`in-process`、`auto`(tmux または iTerm2 で分割ペインを選択、それ以外の場合はインプロセス)、`tmux`(tmux または iTerm2 を使用して分割ペインを選択、ターミナルから検出)、または {/* min-version: 2.1.186 */}`iterm2`(iTerm2 ネイティブ分割ペイン。v2.1.186 で追加された `it2` CLI 経由)。デフォルトは v2.1.179 で `auto` から変更されました。`--teammate-mode` はこれを 1 セッション間オーバーライドします。[表示モードを選択](/ja/agent-teams#choose-a-display-mode)を参照してください | `"auto"` |321| `teammateMode` | **デフォルト**:`in-process`。[エージェントチーム](/ja/agent-teams)チームメイトの表示方法:`in-process`、`auto`(tmux または iTerm2 で分割ペインを選択、それ以外の場合はインプロセス)、`tmux`(tmux または iTerm2 を使用して分割ペインを選択、ターミナルから検出)、または {/* min-version: 2.1.186 */}}`iterm2`(iTerm2 ネイティブ分割ペイン。v2.1.186 で追加された `it2` CLI 経由)。デフォルトは v2.1.179 で `auto` から変更されました。`--teammate-mode` はこれを 1 セッション間オーバーライドします。[表示モードを選択](/ja/agent-teams#choose-a-display-mode)を参照してください | `"auto"` |

318| `terminalProgressBarEnabled` | **デフォルト**:`true`。サポートされているターミナルでターミナル進行状況バーを表示します:ConEmu、Ghostty 1.2.0 以降、および iTerm2 3.6.6 以降。`/config` に**ターミナル進行状況バー**として表示されます | `false` |322| `terminalProgressBarEnabled` | **デフォルト**:`true`。サポートされているターミナルでターミナル進行状況バーを表示します:ConEmu、Ghostty 1.2.0 以降、および iTerm2 3.6.6 以降。`/config` に**ターミナル進行状況バー**として表示されます | `false` |

319| `theme` | {/* min-version: 2.1.119 */}**デフォルト**:`"dark"`。インターフェイスのカラーテーマ:`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"`、または `"custom:<slug>"` または `"custom:<plugin-name>:<slug>"` などのカスタムテーマリファレンス。[カスタムテーマを作成](/ja/terminal-config#create-a-custom-theme)を参照してください。`/config` に**テーマ**として表示されます | `"dark"` |323| `theme` | {/* min-version: 2.1.119 */}**デフォルト**:`"dark"`。インターフェイスのカラーテーマ:`"auto"`、`"dark"`、`"light"`、`"dark-daltonized"`、`"light-daltonized"`、`"dark-ansi"`、`"light-ansi"`、または `"custom:<slug>"` または `"custom:<plugin-name>:<slug>"` などのカスタムテーマリファレンス。[カスタムテーマを作成](/ja/terminal-config#create-a-custom-theme)を参照してください。`/config` に**テーマ**として表示されます | `"dark"` |

320| `tui` | ターミナル UI レンダラー。フリッカーのない[alt-screen レンダラー](/ja/fullscreen)を備えた仮想スクロールバック用に `"fullscreen"` を使用します。クラシックメインスクリーンレンダラー用に `"default"` を使用します。`/tui` で設定します。[`CLAUDE_CODE_NO_FLICKER`](/ja/env-vars)環境変数を設定することもできます。[エージェントビュー](/ja/agent-view)から開かれたバックグラウンドセッションは、この設定に関係なく常にフルスクリーンレンダラーを使用します | `"fullscreen"` |324| `tui` | ターミナル UI レンダラー。フリッカーのない[alt-screen レンダラー](/ja/fullscreen)を備えた仮想スクロールバック用に `"fullscreen"` を使用します。クラシックメインスクリーンレンダラー用に `"default"` を使用します。`/tui` で設定します。[`CLAUDE_CODE_NO_FLICKER`](/ja/env-vars)環境変数を設定することもできます。[エージェントビュー](/ja/agent-view)から開かれたバックグラウンドセッションは、この設定に関係なく常にフルスクリーンレンダラーを使用します | `"fullscreen"` |

321| `ultracode` | セッションの [ultracode](/ja/workflows#let-claude-decide-with-ultracode)をオンにします。セッションのみで `settings.json` から読み込まれません。`/effort ultracode`、`--settings`、または Agent SDK 制御リクエストを通じて設定します | `true` |325| `ultracode` | セッションの [ultracode](/ja/workflows#let-claude-decide-with-ultracode)をオンにします。セッションのみで `settings.json` から読み込まれません。`/effort ultracode`、`--settings`、または Agent SDK 制御リクエストを通じて設定します。{/* min-version: 2.1.203 */}ultracode をオンで開始するには、`claude --effort ultracode` で起動します。Claude Code v2.1.203 以降が必要です | `true` |

322| `useAutoModeDuringPlan` | **デフォルト**:`true`。プラン モードが自動モードが利用可能な場合に自動モードセマンティクスを使用するかどうか。共有プロジェクト設定から読み込まれません。`/config` に「プラン中に自動モードを使用」として表示されます | `false` |326| `useAutoModeDuringPlan` | **デフォルト**:`true`。プラン モードが自動モードが利用可能な場合に自動モードセマンティクスを使用するかどうか。共有プロジェクト設定から読み込まれません。`/config` に「プラン中に自動モードを使用」として表示されます | `false` |

323| `verbose` | {/* min-version: 2.1.119 */}**デフォルト**:`false`。切り詰められたサマリーの代わりに完全なツール出力を表示します。`/config` に**詳細出力**として表示されます。`--verbose` フラグはこれを 1 セッション間オーバーライドします | `true` |327| `verbose` | {/* min-version: 2.1.119 */}**デフォルト**:`false`。切り詰められたサマリーの代わりに完全なツール出力を表示します。`/config` に**詳細出力**として表示されます。`--verbose` フラグはこれを 1 セッション間オーバーライドします | `true` |

324| `viewMode` | 起動時のデフォルトトランスクリプトビューモード:`"default"`、`"verbose"`、または `"focus"`。設定されている場合、スティッキー `/focus` 選択をオーバーライドします。`--verbose` フラグはこれを 1 セッション間オーバーライドします | `"verbose"` |328| `viewMode` | 起動時のデフォルトトランスクリプトビューモード:`"default"`、`"verbose"`、または `"focus"`。設定されている場合、スティッキー `/focus` 選択をオーバーライドします。`--verbose` フラグはこれを 1 セッション間オーバーライドします | `"verbose"` |


339</Note>343</Note>

340 344 

341| キー | 説明 | 例 |345| キー | 説明 | 例 |

342| :------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |346| :------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |

343| `autoConnectIde` | **デフォルト**:`false`。Claude Code が外部ターミナルから起動するときに、実行中の IDE に自動的に接続します。VS Code または JetBrains ターミナルの外で実行する場合、`/config` に\*\*IDE に自動接続(外部ターミナル)\*\*として表示されます。[`CLAUDE_CODE_AUTO_CONNECT_IDE`](/ja/env-vars)環境変数が設定されている場合、これをオーバーライドします | `true` |347| `autoConnectIde` | **デフォルト**:`false`。Claude Code が外部ターミナルから起動するときに、実行中の IDE に自動的に接続します。VS Code または JetBrains ターミナルの外で実行する場合、`/config` に\*\*IDE に自動接続(外部ターミナル)\*\*として表示されます。[`CLAUDE_CODE_AUTO_CONNECT_IDE`](/ja/env-vars)環境変数が設定されている場合、これをオーバーライドします | `true` |

344| `autoInstallIdeExtension` | **デフォルト**:`true`。VS Code ターミナルから実行するときに Claude Code IDE 拡張機能を自動的にインストールします。VS Code または JetBrains ターミナル内で実行する場合、`/config` に**IDE 拡張機能を自動インストール**として表示されます。[`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/ja/env-vars)環境変数を設定することもできます | `false` |348| `autoInstallIdeExtension` | **デフォルト**:`true`。VS Code ターミナルから実行するときに Claude Code IDE 拡張機能を自動的にインストールします。VS Code または JetBrains ターミナル内で実行する場合、`/config` に**IDE 拡張機能を自動インストール**として表示されます。[`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](/ja/env-vars)環境変数を設定することもできます | `false` |

345| `externalEditorContext` | **デフォルト**:`false`。`Ctrl+G` で外部エディターを開くときに Claude の前の応答を `#` コメント付きコンテキストとして先頭に追加します。`/config` に**外部エディターに最後の応答を表示**として表示されます | `true` |349| `externalEditorContext` | **デフォルト**:`false`。`Ctrl+G` で外部エディターを開くときに Claude の前の応答を `#` コメント付きコンテキストとして先頭に追加します。`/config` に**外部エディターに最後の応答を表示**として表示されます | `true` |

346| `teammateDefaultModel` | [エージェントチーム](/ja/agent-teams)チームメイトのデフォルトモデル。spawn プロンプトが指定しない場合。`"sonnet"` などのモデルエイリアスに設定するか、リーダーの現在の `/model` 選択を継承するために `null` に設定します。`/config` に**デフォルトチームメイトモデル**として表示されます | `"sonnet"` |350| `teammateDefaultModel` | [エージェントチーム](/ja/agent-teams)チームメイトのデフォルトモデル。spawn プロンプトが指定しない場合。`"sonnet"` などのモデルエイリアスに設定するか、リーダーの現在の `/model` 選択を継承するために `null` に設定します。`/config` に**デフォルトチームメイトモデル**として表示されます | `"sonnet"` |

351| `workflowSizeGuideline` | {/* min-version: 2.1.202 */}**デフォルト**:`unrestricted`。ガイドラインを送信しません。[エージェント数 Claude が目指す](/ja/workflows#set-a-size-guideline)動的ワークフローで書き込みます。Claude Code は値を Claude にアドバイスとして送信し、強制されたキャップではありません。`unrestricted`、`small`、`medium`、または `large` を受け入れます。`/config` に**動的ワークフローサイズ**として表示されます。`/config workflowSizeGuideline=small` で直接設定することもできます。Claude Code v2.1.202 以降が必要です。{/* min-version: 2.1.203 */}ガイドラインのエージェント数は、[`Large workflow` 警告](/ja/workflows#cost)のデフォルト閾値も置き換えます。その動作は Claude Code v2.1.203 以降が必要です | `"small"` |

347 352 

348<h3 id="worktree-settings">353<h3 id="worktree-settings">

349 Worktree 設定354 Worktree 設定


352`--worktree` が git worktrees を作成および管理する方法を構成します。357`--worktree` が git worktrees を作成および管理する方法を構成します。

353 358 

354| キー | 説明 | 例 |359| キー | 説明 | 例 |

355| :---------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |360| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

356| `worktree.baseRef` | 新しい worktrees がブランチする ref。`"fresh"`(デフォルト)は `origin/<default-branch>` からブランチして、リモートと一致するクリーンツリーを取得します。`"head"` は現在のローカル `HEAD` からブランチするため、プッシュされていないコミットとフィーチャーブランチの状態が worktree に存在します。`--worktree`、`EnterWorktree` ツール、および subagent 分離に適用されます | `"head"` |361| `worktree.baseRef` | 新しい worktrees がブランチする ref。`"fresh"`(デフォルト)は `origin/<default-branch>` からブランチして、リモートと一致するクリーンツリーを取得します。`"head"` は現在のローカル `HEAD` からブランチするため、プッシュされていないコミットとフィーチャーブランチの状態が worktree に存在します。`--worktree`、`EnterWorktree` ツール、および subagent 分離に適用されます | `"head"` |

357| `worktree.symlinkDirectories` | メインリポジトリから各 worktree にシンボリックリンクするディレクトリ。ディスク上の大規模なディレクトリの重複を避けるため。デフォルトではディレクトリはシンボリックリンクされません | `["node_modules", ".cache"]` |362| `worktree.symlinkDirectories` | メインリポジトリから各 worktree にシンボリックリンクするディレクトリ。ディスク上の大規模なディレクトリの重複を避けるため。デフォルトではディレクトリはシンボリックリンクされません | `["node_modules", ".cache"]` |

358| `worktree.sparsePaths` | git sparse-checkout を通じて各 worktree でチェックアウトするディレクトリ。リストされたパスのみがディスク上に書き込まれます。大規模なモノレポではより高速です | `["packages/my-app", "shared/utils"]` |363| `worktree.sparsePaths` | git sparse-checkout を通じて各 worktree でチェックアウトするディレクトリ。リストされたパスのみがディスク上に書き込まれます。大規模なモノレポではより高速です | `["packages/my-app", "shared/utils"]` |

359| `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"` |364| `worktree.bgIsolation` | {/* min-version: 2.1.143 */}[バックグラウンドセッション](/ja/agent-view#how-file-edits-are-isolated)の分離モード。`"worktree"`(デフォルト)は `EnterWorktree` が呼び出されるまでメインチェックアウトで `Edit`/`Write` をブロックします。{/* min-version: 2.1.203 */}git リポジトリの外では、失敗する [`WorktreeCreate` hook](/ja/worktrees#non-git-version-control)がブロックを解放して、セッションが作業ディレクトリを所定の位置で編集できるようにします。Claude Code v2.1.203 以降が必要です。`"none"` はバックグラウンドジョブがワーキングコピーを直接編集できるようにします。Claude Code v2.1.143 以降が必要です | `"none"` |

360 365 

361gitignored ファイル(`.env` など)を新しい worktrees にコピーするには、設定の代わりにプロジェクトルートの [`.worktreeinclude` ファイル](/ja/worktrees#copy-gitignored-files-into-worktrees)を使用します。366gitignored ファイル(`.env` など)を新しい worktrees にコピーするには、設定の代わりにプロジェクトルートの [`.worktreeinclude` ファイル](/ja/worktrees#copy-gitignored-files-into-worktrees)を使用します。

362 367 


365</h3>370</h3>

366 371 

367| キー | 説明 | 例 |372| キー | 説明 | 例 |

368| :---------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------- |373| :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------- |

369| `allow` | ツール使用を許可する権限ルールの配列。ツール名 glob はリテラル `mcp__<server>__` プレフィックスの後のツール位置でのみサポートされます。たとえば `mcp__github__get_*`。サーバーセグメントは glob フリーである必要があります。パターンマッチングの詳細については、以下の[権限ルール構文](#permission-rule-syntax)を参照してください | `[ "Bash(git diff *)" ]` |374| `allow` | ツール使用を許可する権限ルールの配列。ツール名 glob はリテラル `mcp__<server>__` プレフィックスの後のツール位置でのみサポートされます。たとえば `mcp__github__get_*`。サーバーセグメントは glob フリーである必要があります。パターンマッチングの詳細については、以下の[権限ルール構文](#permission-rule-syntax)を参照してください | `[ "Bash(git diff *)" ]` |

370| `ask` | ツール使用時に確認を求める権限ルールの配列。[権限ルール構文](#permission-rule-syntax)を参照してください | `[ "Bash(git push *)" ]` |375| `ask` | ツール使用時に確認を求める権限ルールの配列。[権限ルール構文](#permission-rule-syntax)を参照してください | `[ "Bash(git push *)" ]` |

371| `deny` | ツール使用を拒否する権限ルールの配列。これを使用して、機密ファイルを Claude Code アクセスから除外します。ツール名は glob パターンを受け入れます:`"*"` はすべてのツールを拒否し、`"mcp__*"` はすべての MCP ツールを拒否します。[権限ルール構文](#permission-rule-syntax)と [Bash 権限制限](/ja/permissions#tool-specific-permission-rules)を参照してください | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |376| `deny` | ツール使用を拒否する権限ルールの配列。これを使用して、機密ファイルを Claude Code アクセスから除外します。ツール名は glob パターンを受け入れます:`"*"` はすべてのツールを拒否し、`"mcp__*"` はすべての MCP ツールを拒否します。[権限ルール構文](#permission-rule-syntax)と [Bash 権限制限](/ja/permissions#tool-specific-permission-rules)を参照してください | `[ "WebFetch", "Bash(curl *)", "Read(./.env)", "Read(./secrets/**)" ]` |

372| `additionalDirectories` | Claude がアクセスできる追加の[作業ディレクトリ](/ja/permissions#working-directories)。ほとんどの `.claude/` 構成は[これらのディレクトリから検出されません](/ja/permissions#additional-directories-grant-file-access-not-configuration) | `[ "../docs/" ]` |377| `additionalDirectories` | Claude がアクセスできる追加の[作業ディレクトリ](/ja/permissions#working-directories)。ほとんどの `.claude/` 構成は[これらのディレクトリから検出されません](/ja/permissions#additional-directories-grant-file-access-not-configuration) | `[ "../docs/" ]` |

373| `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"` |378| `defaultMode` | Claude Code を開くときのデフォルト[権限モード](/ja/permission-modes)。有効な値:`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`、および {/* min-version: 2.1.200 */}}`manual` は `default` のエイリアス。CLI および VS Code と JetBrains 拡張機能で Manual とラベル付けされたモード。manual エイリアスは Claude Code v2.1.200 以降が必要です。{/* min-version: 2.1.142 */}v2.1.142 以降、`auto` はプロジェクトまたはローカル設定(`.claude/settings.json`、`.claude/settings.local.json`)で設定されている場合は無視されるため、リポジトリはそれ自体に自動モードを付与できません。代わりに `~/.claude/settings.json` で設定します。`--permission-mode` CLI フラグは単一セッションのこの設定をオーバーライドします | `"acceptEdits"` |

374| `disableBypassPermissionsMode` | `"disable"` に設定して `bypassPermissions` モードの有効化を防止します。これにより `--dangerously-skip-permissions` フラグが無効になります。通常は [managed 設定](/ja/permissions#managed-settings)に配置されます。ユーザーはこれをオーバーライドできません | `"disable"` |379| `disableBypassPermissionsMode` | `"disable"` に設定して `bypassPermissions` モードの有効化を防止します。これにより `--dangerously-skip-permissions` フラグが無効になります。通常は [managed 設定](/ja/permissions#managed-settings)に配置されます。ユーザーはこれをオーバーライドできません | `"disable"` |

375| `skipDangerousModePermissionPrompt` | `--dangerously-skip-permissions` または `defaultMode: "bypassPermissions"` を通じてバイパス権限モードに入る前に表示される確認プロンプトをスキップします。信頼されていないリポジトリがプロンプトを自動バイパスするのを防ぐため、プロジェクト設定(`.claude/settings.json`)で設定されている場合は無視されます | `true` |380| `skipDangerousModePermissionPrompt` | `--dangerously-skip-permissions` または `defaultMode: "bypassPermissions"` を通じてバイパス権限モードに入る前に表示される確認プロンプトをスキップします。信頼されていないリポジトリがプロンプトを自動バイパスするのを防ぐため、プロジェクト設定(`.claude/settings.json`)で設定されている場合は無視されます | `true` |

376 381 


398高度なサンドボックス動作を構成します。サンドボックスは bash コマンドをファイルシステムとネットワークから分離します。詳細については [サンドボックス](/ja/sandboxing)を参照してください。403高度なサンドボックス動作を構成します。サンドボックスは bash コマンドをファイルシステムとネットワークから分離します。詳細については [サンドボックス](/ja/sandboxing)を参照してください。

399 404 

400| キー | 説明 | 例 |405| キー | 説明 | 例 |

401| :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------- |406| :------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

402| `enabled` | bash サンドボックスを有効にします(macOS、Linux、WSL2)。デフォルト:false | `true` |407| `enabled` | bash サンドボックスを有効にします(macOS、Linux、WSL2)。デフォルト:false | `true` |

403| `failIfUnavailable` | `sandbox.enabled` が true だがサンドボックスが起動できない場合(依存関係の欠落、サポートされていないプラットフォーム)、起動時にエラーで終了します。false(デフォルト)の場合、警告が表示され、コマンドはサンドボックス化されずに実行されます。managed 設定デプロイメント用で、サンドボックスをハードゲートとして必要とします | `true` |408| `failIfUnavailable` | `sandbox.enabled` が true だがサンドボックスが起動できない場合(依存関係の欠落、サポートされていないプラットフォーム)、起動時にエラーで終了します。false(デフォルト)の場合、警告が表示され、コマンドはサンドボックス化されずに実行されます。managed 設定デプロイメント用で、サンドボックスをハードゲートとして必要とします | `true` |

404| `autoAllowBashIfSandboxed` | サンドボックス化されている場合、bash コマンドを自動承認します。デフォルト:true | `true` |409| `autoAllowBashIfSandboxed` | サンドボックス化されている場合、bash コマンドを自動承認します。デフォルト:true | `true` |


410| `filesystem.allowRead` | `denyRead` 領域内での読み取りを再度許可するパス。`denyRead` よりも優先されます。配列はすべての設定スコープ全体でマージされます。これを使用してワークスペースのみの読み取りアクセスパターンを作成します。 | `["."]` |415| `filesystem.allowRead` | `denyRead` 領域内での読み取りを再度許可するパス。`denyRead` よりも優先されます。配列はすべての設定スコープ全体でマージされます。これを使用してワークスペースのみの読み取りアクセスパターンを作成します。 | `["."]` |

411| `filesystem.allowManagedReadPathsOnly` | (Managed 設定のみ)managed 設定からの `filesystem.allowRead` パスのみが尊重されます。`denyRead` はすべてのソースからマージされます。デフォルト:false | `true` |416| `filesystem.allowManagedReadPathsOnly` | (Managed 設定のみ)managed 設定からの `filesystem.allowRead` パスのみが尊重されます。`denyRead` はすべてのソースからマージされます。デフォルト:false | `true` |

412| `credentials.files` | {/* min-version: 2.1.187 */}サンドボックス化されたコマンドが読み取りできない認証情報ファイルまたはディレクトリ。`filesystem.denyRead` と同じ読み取りブロックを適用します。個別のキーは認証情報パスを `credentials.envVars` と一緒にグループ化し、一般的なファイルシステムルールから離します。各エントリは `{ "path": "...", "mode": "deny" }` です。パスは `filesystem.*` 設定と同じ[プレフィックス](#sandbox-path-prefixes)を使用します。配列はすべての設定スコープ全体でマージされます。`deny` のみがサポートされています。Claude Code v2.1.187 以降が必要です。 | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |417| `credentials.files` | {/* min-version: 2.1.187 */}サンドボックス化されたコマンドが読み取りできない認証情報ファイルまたはディレクトリ。`filesystem.denyRead` と同じ読み取りブロックを適用します。個別のキーは認証情報パスを `credentials.envVars` と一緒にグループ化し、一般的なファイルシステムルールから離します。各エントリは `{ "path": "...", "mode": "deny" }` です。パスは `filesystem.*` 設定と同じ[プレフィックス](#sandbox-path-prefixes)を使用します。配列はすべての設定スコープ全体でマージされます。`deny` のみがサポートされています。Claude Code v2.1.187 以降が必要です。 | `[{ "path": "~/.aws/credentials", "mode": "deny" }]` |

413| `credentials.envVars` | {/* min-version: 2.1.187 */}}[サンドボックス化されたコマンドから保護](/ja/sandboxing#protect-credentials)する環境変数。各エントリは `name` と `mode` を持ちます。名前は文字またはアンダースコアで始まり、文字、数字、アンダースコアのみを含む必要があります。`deny` は変数をサンドボックス化されたコマンドの環境から削除します。Claude Code v2.1.187 以降が必要です。{/* min-version: 2.1.199 */}}`mask` は変数をセッションごとのセンチネル値でサンドボックス内に置き換え、サンドボックスプロキシはそのエントリの `injectHosts` へのアウトバウンドリクエストで実際の値を置き換えます。`network.tlsTerminate` と Claude Code v2.1.199 以降が必要です。`mask` エントリはユーザー、managed、または CLI `--settings` 設定からのみ尊重され、`.claude/settings.json` または `.claude/settings.local.json` からは尊重されません。配列はすべての設定スコープ全体でマージされ、同じ変数が両方のモードで表示される場合、`deny` が優先されます。 | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |418| `credentials.envVars` | {/* min-version: 2.1.187 */}[サンドボックス化されたコマンドから保護](/ja/sandboxing#protect-credentials)する環境変数。各エントリは `name` と `mode` を持ちます。名前は文字またはアンダースコアで始まり、文字、数字、アンダースコアのみを含む必要があります。`deny` は変数をサンドボックス化されたコマンドの環境から削除します。Claude Code v2.1.187 以降が必要です。{/* min-version: 2.1.199 */}}`mask` は変数をセッションごとのセンチネル値でサンドボックス内に置き換え、サンドボックスプロキシはそのエントリの `injectHosts` へのアウトバウンドリクエストで実際の値を置き換えます。`network.tlsTerminate` と Claude Code v2.1.199 以降が必要です。`mask` エントリはユーザー、managed、または CLI `--settings` 設定からのみ尊重され、`.claude/settings.json` または `.claude/settings.local.json` からは尊重されません。配列はすべての設定スコープ全体でマージされ、同じ変数が両方のモードで表示される場合、`deny` が優先されます。 | `[{ "name": "GITHUB_TOKEN", "mode": "deny" }]` |

414| `credentials.envVars[].injectHosts` | {/* min-version: 2.1.199 */}サンドボックスプロキシが `mask` エントリの実際の値を置き換えるホスト。各ホストは `network.allowedDomains` でもカバーされている必要があります。正確にまたはワイルドカードで。未設定の場合、プロキシは `network.allowedDomains` のすべてのホストへのリクエストで値を置き換えます。`mode` が `deny` の場合は受け入れられますが無視されます。Claude Code v2.1.199 以降が必要です。 | `["api.github.com"]` |419| `credentials.envVars[].injectHosts` | {/* min-version: 2.1.199 */}サンドボックスプロキシが `mask` エントリの実際の値を置き換えるホスト。各ホストは `network.allowedDomains` でもカバーされている必要があります。正確にまたはワイルドカードで。未設定の場合、プロキシは `network.allowedDomains` のすべてのホストへのリクエストで値を置き換えます。`mode` が `deny` の場合は受け入れられますが無視されます。Claude Code v2.1.199 以降が必要です。 | `["api.github.com"]` |

415| `credentials.allowPlaintextInject` | {/* min-version: 2.1.199 */}TLS 終了 HTTPS だけでなく、プレーン HTTP リクエストでも `mask` 置換を許可します。プレーン HTTP ではアップストリーム ID が検証されず、認証情報がクリアテキストで移動するため、信頼されたテストネットワーク外ではこれをオフのままにしてください。ユーザー、managed、または CLI `--settings` 設定からのみ尊重され、`.claude/settings.json` または `.claude/settings.local.json` からは尊重されません。デフォルト:false。Claude Code v2.1.199 以降が必要です。 | `true` |420| `credentials.allowPlaintextInject` | {/* min-version: 2.1.199 */}TLS 終了 HTTPS だけでなく、プレーン HTTP リクエストでも `mask` 置換を許可します。プレーン HTTP ではアップストリーム ID が検証されず、認証情報がクリアテキストで移動するため、信頼されたテストネットワーク外ではこれをオフのままにしてください。ユーザー、managed、または CLI `--settings` 設定からのみ尊重され、`.claude/settings.json` または `.claude/settings.local.json` からは尊重されません。デフォルト:false。Claude Code v2.1.199 以降が必要です。 | `true` |

416| `network.allowUnixSockets` | (macOS のみ)サンドボックスでアクセス可能な Unix ソケットパス。Linux と WSL2 では無視されます。seccomp フィルターは `socket(AF_UNIX, ...)` 呼び出しをブロックできないため、代わりに `allowAllUnixSockets` を使用します。 | `["~/.ssh/agent-socket"]` |421| `network.allowUnixSockets` | (macOS のみ)サンドボックスでアクセス可能な Unix ソケットパス。Linux と WSL2 では無視されます。seccomp フィルターは `socket(AF_UNIX, ...)` 呼び出しをブロックできないため、代わりに `allowAllUnixSockets` を使用します。 | `["~/.ssh/agent-socket"]` |


590| バッジ数 | 最大 5 つのバッジがレンダリングされます。最も古いものは新しいマッチによって置き換えられ、`/clear` はそれらを削除します |595| バッジ数 | 最大 5 つのバッジがレンダリングされます。最も古いものは新しいマッチによって置き換えられ、`/clear` はそれらを削除します |

591| 設定スコープ | ユーザー設定、`--settings` フラグ、および managed 設定からのみ読み込まれます。プロジェクト `.claude/settings.json` およびローカル `.claude/settings.local.json` では無視されます |596| 設定スコープ | ユーザー設定、`--settings` フラグ、および managed 設定からのみ読み込まれます。プロジェクト `.claude/settings.json` およびローカル `.claude/settings.local.json` では無視されます |

592 597 

593ターンが完了すると、Claude Code はメインスレッドでターン出力に対して各エントリの `pattern` 正規表現をマッチします。そのため、遅い正規表現は UI をブロックしてセッションを凍結するまでブロックします。`(a+)+$` などのネストされた量指定子は、特定の入力に対して指数関数的に長くかかる可能性があるため、各 `pattern` を線形に保ち、`+` または `*` のネストを避けます598ターンが完了すると、Claude Code はメインスレッドでターン出力に対して各エントリの `pattern` 正規表現をマッチします。そのため、遅い正規表現は UI をブロックしてセッションを凍結するまでブロックします。`(a+)+$` などのネストされた量指定子は、特定の入力に対して指数関数的に長くかかる可能性があるため、各 `pattern` を線形に保ち、`+` または `*` の ネストを避けます

594 599 

595フッターバッジは、構成されている場合、[カスタムステータスライン](/ja/statusline)と並んでレンダリングされます。どちらも他方を置き換えません。セッションデータから独自のコンテンツを計算するスクリプト駆動行にはステータスラインを使用し、スクリプトなしで会話から ID をリンクに変換するにはフッターバッジを使用します。600フッターバッジは、構成されている場合、[カスタムステータスライン](/ja/statusline)と並んでレンダリングされます。どちらも他方を置き換えません。セッションデータから独自のコンテンツを計算するスクリプト駆動行にはステータスラインを使用し、スクリプトなしで会話から ID をリンクに変換するにはフッターバッジを使用します。

596 601 

setup.md +9 −3

Details

188 認証188 認証

189</h2>189</h2>

190 190 

191Claude Code には、Pro、Max、Team、Enterprise、または Console アカウントが必要です。無料の Claude.ai プランには Claude Code アクセスは含まれていません。[Amazon Bedrock](/ja/amazon-bedrock)、[Google Vertex AI](/ja/google-vertex-ai)、または[Microsoft Foundry](/ja/microsoft-foundry)などのサードパーティ API プロバイダーで Claude Code を使用することもできます。191Claude Code には、Pro、Max、Team、Enterprise、または Console アカウントが必要です。無料の Claude.ai プランには Claude Code アクセスは含まれていません。[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、または[Microsoft Foundry](/ja/microsoft-foundry)などのサードパーティ API プロバイダーで Claude Code を使用することもできます。

192 192 

193インストール後、`claude` を実行してブラウザーのプロンプトに従ってログインします。すべてのアカウントタイプとチームセットアップオプションについては、[認証](/ja/authentication)を参照してください。193インストール後、`claude` を実行してブラウザーのプロンプトに従ってログインします。すべてのアカウントタイプとチームセットアップオプションについては、[認証](/ja/authentication)を参照してください。

194 194 


376 376 

377<Tabs>377<Tabs>

378 <Tab title="apt">378 <Tab title="apt">

379 Debian および Ubuntu 用です。以下のコマンドは `stable` チャネルを構成します:379 Debian および Ubuntu 用です。以下のインストールコマンドは `curl` で署名キーをダウンロードします。新しい Debian および Ubuntu インストールには `curl` が含まれていない場合があります。ダウンロードが `sudo: curl: command not found` で失敗する場合は、まず curl をインストールしてください:

380 

381 ```bash theme={null}

382 sudo apt install curl

383 ```

384 

385 以下のコマンドは `stable` チャネルを構成します:

380 386 

381 ```bash theme={null}387 ```bash theme={null}

382 sudo install -d -m 0755 /etc/apt/keyrings388 sudo install -d -m 0755 /etc/apt/keyrings


526 </Step>532 </Step>

527 533 

528 <Step title="バイナリをマニフェストに対して確認">534 <Step title="バイナリをマニフェストに対して確認">

529 ダウンロードしたバイナリの SHA256 チェックサムを `manifest.json` の `platforms.<platform>.checksum` の下にリストされている値と比較します。535 バイナリの SHA256 チェックサムを `manifest.json` の `platforms.<platform>.checksum` の下にリストされている値と比較します。以下のコマンドは、現在のディレクトリに `claude` バイナリがあることを想定しています。代わりにインストールされたネイティブバイナリを検証するには、`~/.local/share/claude/versions/VERSION` に対してコマンドを実行します。VERSION をステップ 2 で設定したリリースに置き換えます。

530 536 

531 <Tabs>537 <Tabs>

532 <Tab title="Linux">538 <Tab title="Linux">

skills.md +13 −5

Details

22 バンドルされたスキル22 バンドルされたスキル

23</h2>23</h2>

24 24 

25Claude Code には、[`disableBundledSkills`](/ja/settings#available-settings) 設定で無効にしない限り、すべてのセッションで利用可能な一連のバンドルされたスキルが含まれています。これには `/code-review`、`/batch`、`/debug`、`/loop`、および `/claude-api` が含まれます。固定ロジックを直接実行する組み込みコマンドとは異なり、バンドルされたスキルはプロンプトベースです。Claude に詳細な指示を提供し、ツールを使用して作業を調整させます。他のスキルと同じ方法で呼び出します。`/` の後にスキル名を入力します。25Claude Code には、[`disableBundledSkills`](/ja/settings#available-settings) 設定で無効にしない限り、すべてのセッションで利用可能な一連のバンドルされたスキルが含まれています。これには `/doctor`、`/code-review`、`/batch`、`/debug`、`/loop`、および `/claude-api` が含まれます。固定ロジックを直接実行する組み込みコマンドとは異なり、バンドルされたスキルはプロンプトベースです。Claude に詳細な指示を提供し、ツールを使用して作業を調整させます。他のスキルと同じ方法で呼び出します。`/` の後にスキル名を入力します。

26 

27[`/doctor`](/ja/commands#all-commands) セットアップチェックアップは、Claude Code v2.1.205 以降では `disableBundledSkills` の唯一の例外です。この設定がオンの場合でも入力可能なままです。これを非表示にするには、`DISABLE_DOCTOR_COMMAND` 環境変数を設定するか、[`skillOverrides`](#override-skill-visibility-from-settings) エントリで `"doctor": "off"` を設定します。v2.1.205 より前では、`/doctor` は組み込みコマンドではなくバンドルされたスキルでした。

26 28 

27バンドルされたスキルは [コマンドリファレンス](/ja/commands) に組み込みコマンドと一緒にリストされており、目的列に**スキル**とマークされています。29バンドルされたスキルは [コマンドリファレンス](/ja/commands) に組み込みコマンドと一緒にリストされており、目的列に**スキル**とマークされています。

28 30 


117| Project | `.claude/skills/<skill-name>/SKILL.md` | このプロジェクトのみ |119| Project | `.claude/skills/<skill-name>/SKILL.md` | このプロジェクトのみ |

118| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | プラグインが有効な場所 |120| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | プラグインが有効な場所 |

119 121 

120スキルがレベル全体で同じ名前を共有する場合、enterprise は personal をオーバーライドし、personal はプロジェクトをオーバーライドします。プラグインスキルは `plugin-name:skill-name` 名前空間を使用するため、他のレベルと競合することはできません。`.claude/commands/` にファイルがある場合、それらは同じように機能しますが、スキルとコマンドが同じ名前を共有する場合、スキルが優先されます。122スキルがレベル全体で同じ名前を共有する場合、enterprise は personal をオーバーライドし、personal はプロジェクトをオーバーライドします。プロジェクトの `.claude/skills/` 内の `code-review` スキルなど、任意のレベルのスキルは、同じ名前のバンドルされたスキルもオーバーライドします。プラグインスキルは `plugin-name:skill-name` 名前空間を使用するため、他のレベルと競合することはできません。`.claude/commands/` にファイルがある場合、それらは同じように機能しますが、スキルとコマンドが同じ名前を共有する場合、スキルが優先されます。

121 123 

122スキルは作業ディレクトリの下のネストされた `.claude/skills/` ディレクトリからも読み込まれます。Claude がサブディレクトリ内のファイルを読み取りまたは編集する場合、そのサブディレクトリの `.claude/skills/` からのスキルが利用可能になります。これにより、モノレポパッケージがセッションがリポジトリルートで開始された場合でも、そのパッケージで作業するときに適用される独自のスキルを提供できます。124スキルは作業ディレクトリの下のネストされた `.claude/skills/` ディレクトリからも読み込まれます。Claude がサブディレクトリ内のファイルを読み取りまたは編集する場合、そのサブディレクトリの `.claude/skills/` からのスキルが利用可能になります。これにより、モノレポパッケージがセッションがリポジトリルートで開始された場合でも、そのパッケージで作業するときに適用される独自のスキルを提供できます。

123 125 


129 131 

130`/deploy` を入力するとプロジェクトルートスキルが実行されます。修飾名 `/apps/web:deploy` を入力してネストされたバリアントを明示的に実行します。132`/deploy` を入力するとプロジェクトルートスキルが実行されます。修飾名 `/apps/web:deploy` を入力してネストされたバリアントを明示的に実行します。

131 133 

134修飾されていない名前を呼び出すか Claude が呼び出すと、プロジェクトルートスキルが読み込まれ、Claude Code はディレクトリ修飾バリアントのリストをそのコンテンツに追加し、Claude が作業しているファイルを保持するディレクトリのバリアントも呼び出すように指示します。ネストされたスキルは、修飾されていない名前のみが呼び出される場合でも、そのディレクトリ内の作業に適用されます。Claude Code v2.1.203 以降が必要です。

135 

132`<skill-name>` エントリは enterprise、personal、またはプロジェクトの場所にあり、ディスク上の別の場所のディレクトリへのシンボリックリンクにすることができます。Claude Code はシンボリックリンクをたどり、ターゲットディレクトリから `SKILL.md` を読み取ります。同じターゲットが複数の場所から到達可能な場合、Claude Code はスキルを 1 回だけ読み込みます。プラグインスキルはシンボリックリンクを異なる方法で処理します。[シンボリックリンクを使用してマーケットプレイス内でファイルを共有する](/ja/plugins-reference#share-files-within-a-marketplace-with-symlinks)を参照してください。136`<skill-name>` エントリは enterprise、personal、またはプロジェクトの場所にあり、ディスク上の別の場所のディレクトリへのシンボリックリンクにすることができます。Claude Code はシンボリックリンクをたどり、ターゲットディレクトリから `SKILL.md` を読み取ります。同じターゲットが複数の場所から到達可能な場合、Claude Code はスキルを 1 回だけ読み込みます。プラグインスキルはシンボリックリンクを異なる方法で処理します。[シンボリックリンクを使用してマーケットプレイス内でファイルを共有する](/ja/plugins-reference#share-files-within-a-marketplace-with-symlinks)を参照してください。

133 137 

134<Note>138<Note>


175 179 

176`--add-dir` フラグと `/add-dir` コマンドは[ファイルアクセスを許可](/ja/permissions#additional-directories-grant-file-access-not-configuration)しますが、スキルは例外です。追加されたディレクトリ内の `.claude/skills/` は自動的に読み込まれます。この例外は `--add-dir` と `/add-dir` にのみ適用されます。`settings.json` の `permissions.additionalDirectories` 設定はファイルアクセスのみを許可し、スキルは読み込みません。[ライブ変更検出](#live-change-detection)を参照して、セッション中に編集がどのように取得されるかを確認してください。180`--add-dir` フラグと `/add-dir` コマンドは[ファイルアクセスを許可](/ja/permissions#additional-directories-grant-file-access-not-configuration)しますが、スキルは例外です。追加されたディレクトリ内の `.claude/skills/` は自動的に読み込まれます。この例外は `--add-dir` と `/add-dir` にのみ適用されます。`settings.json` の `permissions.additionalDirectories` 設定はファイルアクセスのみを許可し、スキルは読み込みません。[ライブ変更検出](#live-change-detection)を参照して、セッション中に編集がどのように取得されるかを確認してください。

177 181 

178その他の `.claude/` 設定(サブエージェント、コマンド、出力スタイル)は追加ディレクトリから読み込まれません。読み込まれるもの、読み込まれないもの、および設定をプロジェクト全体で共有するための推奨方法の完全なリストについては、[例外テーブル](/ja/permissions#additional-directories-grant-file-access-not-configuration)を参照してください。182その他の `.claude/` 設定(コマンド、出力スタイル)は追加ディレクトリから読み込まれません。読み込まれるもの、読み込まれないもの、および設定をプロジェクト全体で共有するための推奨方法の完全なリストについては、[例外テーブル](/ja/permissions#additional-directories-grant-file-access-not-configuration)を参照してください。

179 183 

180<Note>184<Note>

181 `--add-dir` ディレクトリの CLAUDE.md ファイルはデフォルトでは読み込まれません。読み込むには、`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` を設定します。[追加ディレクトリから読み込む](/ja/memory#load-from-additional-directories)を参照してください。185 `--add-dir` ディレクトリの CLAUDE.md ファイルはデフォルトでは読み込まれません。読み込むには、`CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` を設定します。[追加ディレクトリから読み込む](/ja/memory#load-from-additional-directories)を参照してください。


390 394 

391ユーザーまたは Claude がスキルを呼び出すと、レンダリングされた `SKILL.md` コンテンツは会話に単一のメッセージとして入力され、セッションの残りの間そこに留まります。Claude Code は後のターンでスキルファイルを再度読み込まないため、タスク全体を通じて適用すべきガイダンスを 1 回限りのステップではなく、スタンディング指示として記述します。395ユーザーまたは Claude がスキルを呼び出すと、レンダリングされた `SKILL.md` コンテンツは会話に単一のメッセージとして入力され、セッションの残りの間そこに留まります。Claude Code は後のターンでスキルファイルを再度読み込まないため、タスク全体を通じて適用すべきガイダンスを 1 回限りのステップではなく、スタンディング指示として記述します。

392 396 

397v2.1.202 以降では、Claude が、レンダリングされたコンテンツが既にコンテキストにある複製と同じスキルを再度呼び出すと、Claude Code はスキルが既に読み込まれていることを示す短いメモを追加します。レンダリングされたコンテンツが異なる場合(引数が変更されたか、[動的コンテキスト](#inject-dynamic-context)コマンドが新しい出力を生成したため)、Claude Code は完全なコンテンツを再度追加します。v2.1.202 より前では、すべての再呼び出しはスキルの指示の別の完全なコピーを追加していました。

398 

393[自動コンパクション](/ja/how-claude-code-works#when-context-fills-up)は、トークン予算内で呼び出されたスキルを前方に運びます。会話が要約されてコンテキストを解放するとき、Claude Code は各スキルの最新の呼び出しを要約の後に再度アタッチし、最初の 5,000 トークンを保持します。再度アタッチされたスキルは 25,000 トークンの合計予算を共有します。Claude Code はこの予算を最近呼び出されたスキルから開始して埋めるため、セッション内で多くのスキルを呼び出した場合、古いスキルはコンパクション後に完全にドロップされる可能性があります。399[自動コンパクション](/ja/how-claude-code-works#when-context-fills-up)は、トークン予算内で呼び出されたスキルを前方に運びます。会話が要約されてコンテキストを解放するとき、Claude Code は各スキルの最新の呼び出しを要約の後に再度アタッチし、最初の 5,000 トークンを保持します。再度アタッチされたスキルは 25,000 トークンの合計予算を共有します。Claude Code はこの予算を最近呼び出されたスキルから開始して埋めるため、セッション内で多くのスキルを呼び出した場合、古いスキルはコンパクション後に完全にドロップされる可能性があります。

394 400 

395スキルが最初の応答の後に動作に影響を与えるのを停止しているように見える場合、コンテンツは通常まだ存在し、モデルは他のツールまたはアプローチを選択しています。スキルの `description` と指示を強化して、モデルがそれを優先し続けるようにするか、[フック](/ja/hooks)を使用して動作を決定的に強制します。スキルが大きいか、その後に他のスキルを多く呼び出した場合、コンパクション後にそれを再度呼び出して、フルコンテンツを復元します。401スキルが最初の応答の後に動作に影響を与えるのを停止しているように見える場合、コンテンツは通常まだ存在し、モデルは他のツールまたはアプローチを選択しています。スキルの `description` と指示を強化して、モデルがそれを優先し続けるようにするか、[フック](/ja/hooks)を使用して動作を決定的に強制します。スキルが大きいか、その後に他のスキルを多く呼び出した場合、コンパクション後にそれを再度呼び出して、フルコンテンツを復元します。


908 スキルの説明が短縮される914 スキルの説明が短縮される

909</h3>915</h3>

910 916 

911スキルの説明がコンテキストに読み込まれるため、Claude は利用可能なものを知っています。すべてのスキル名は常に含まれていますが、多くのスキルがある場合、説明は文字予算に合わせて短縮される可能性があり、Claude が一致するために必要なキーワードを削除できます。予算はモデルのコンテキストウィンドウの 1% でスケーリングされます。オーバーフローすると、最も呼び出しが少ないスキルの説明が最初に削除され実際に使用するスキルは完全なテキストを保持します。`/doctor` を実行して、スキルの説明がどの程度短縮または削除されているかどのスキルが影響を受けているかを確認します917Claude Code はスキル名と説明のリストをコンテキストに読み込むため、Claude は利用可能なものを知っています。リストには常にすべてのスキル名が含まれていますが、多くのスキルがある場合、Claude Code はリストの文字予算に合わせて説明を短縮する可能性があり、Claude が要求と一致するために必要なキーワードを削除できます。予算はモデルのコンテキストウィンドウの 1% でスケーリングされます。リストがオーバーフローするとClaude Code は最も呼び出しが少ないスキルから説明を削除するため最も使用するスキルは完全なテキストを保持します

918 

919`/doctor` を実行して、リストのコンテキストコストとその最大の貢献者の推定値を確認します。リストが予算を超えると、Claude Code はデバッグログに警告も書き込みます。これは [`--debug`](/ja/cli-reference#cli-flags) で表示できます。

912 920 

913v2.1.196 以降、`/context` のスキル行は予算が適用された後のリストのサイズを報告するため、モデルが受け取るものと一致します。以前のバージョンではすべての説明の完全なテキストをカウントしていたため、この行は予算 `/doctor` が報告する値より数倍大きい値を表示できました921`/context` のスキル行は予算が適用された後のリストのサイズを報告するため、モデルが受け取るものと一致します。v2.1.196 より前は、この行はすべての説明の完全なテキストをカウントしていたため、設定された予算より数倍大きい値を表示できました

914 922 

915予算を上げるには、[`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 文字でキャップされているため、主要なユースケースを前置きしてください。キャップは [`skillListingMaxDescChars`](/ja/settings#available-settings) で設定可能です。923予算を上げるには、[`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 文字でキャップされているため、主要なユースケースを前置きしてください。キャップは [`skillListingMaxDescChars`](/ja/settings#available-settings) で設定可能です。

916 924 

statusline.md +3 −1

Details

1040}1040}

1041```1041```

1042 1042 

1043コマンドは、すべての表示されているサブエージェント行が stdin で単一の JSON オブジェクトとして渡される各リフレッシュティックで実行されます。入力には [基本フックフィールド](/ja/hooks#common-input-fields) に加えて、`columns`(使用可能な行幅)と `tasks` 配列が含まれます。各タスクには `id`、`name`、`type`、`status`、`description`、`label`、`startTime`、`tokenCount`、`tokenSamples`、`cwd` があります。1043コマンドは、すべての表示されているサブエージェント行が stdin で単一の JSON オブジェクトとして渡される各リフレッシュティックで実行されます。入力には [基本フックフィールド](/ja/hooks#common-input-fields)、使用可能な行幅を示す `columns` フィールド、および `tasks` 配列が含まれます。各タスクには `id`、`name`、`type`、`status`、`description`、`label`、`startTime`、`model`、`contextWindowSize`、`tokenCount`、`tokenSamples`、`cwd` があります。

1044 

1045タスクごとの `model` フィールドは、タスクが実行される解決済みモデル ID です。`contextWindowSize` はそのモデルのコンテキストウィンドウ(トークン単位)で、メインステータスラインの `context_window.context_window_size` と同じ方法で計算されるため、`tokenCount` から行ごとのパーセンテージをレンダリングできます。両方のフィールドには Claude Code v2.1.205 以降が必要で、モデルがまだ解決されていないタスクでは省略されます。

1044 1046 

1045オーバーライドしたい各行に対して stdout に 1 つの JSON 行を書き込みます。形式は `{"id": "<task id>", "content": "<row body>"}` です。`content` 文字列はそのままレンダリングされます。ANSI 色と OSC 8 ハイパーリンクを含みます。タスクの `id` を省略して、その行のデフォルトレンダリングを保持します。空の `content` 文字列を出力して、その行を非表示にします。1047オーバーライドしたい各行に対して stdout に 1 つの JSON 行を書き込みます。形式は `{"id": "<task id>", "content": "<row body>"}` です。`content` 文字列はそのままレンダリングされます。ANSI 色と OSC 8 ハイパーリンクを含みます。タスクの `id` を省略して、その行のデフォルトレンダリングを保持します。空の `content` 文字列を出力して、その行を非表示にします。

1046 1048 

sub-agents.md +13 −5

Details

183 183 

184Claude Code は `.claude/agents/` と `~/.claude/agents/` を再帰的にスキャンするため、`agents/review/` や `agents/research/` などのサブフォルダに定義を整理できます。サブディレクトリパスはサブエージェントの識別方法や呼び出し方法に影響しません。これは `name` フロントマターフィールドからのみ識別されるためです。184Claude Code は `.claude/agents/` と `~/.claude/agents/` を再帰的にスキャンするため、`agents/review/` や `agents/research/` などのサブフォルダに定義を整理できます。サブディレクトリパスはサブエージェントの識別方法や呼び出し方法に影響しません。これは `name` フロントマターフィールドからのみ識別されるためです。

185 185 

186`name` 値をツリー全体で一意に保ちます:1 つのスコープ内の 2 つのファイルが同じ名前を宣言する場合、Claude Code は 1 つのみを読み込みます。{/* min-version: 2.1.196 */}v2.1.196 以降、`/doctor` を実行すると同じスコープの重複するエージェント名が報告されどの定義がアクティブであるかが表示されます186`name` 値をツリー全体で一意に保ちます:1 つのスコープ内の 2 つのファイルが同じ名前を宣言する場合、Claude Code は 1 つのみを読み込みます。選択されるのはファイルシステムの読み取り順序によって決まります。ネストされたプロジェクトディレクトリ全体では、作業ディレクトリに最も近い定義が優先されます。{/* min-version: 2.1.205 */}[`/doctor`](/ja/commands#all-commands)セットアップチェックアップは、同じディレクトリ内で名前を共有するファイルを報告し、1 つを除くすべての名前を変更または削除することを提案します。v2.1.205 より前では、`/doctor` は診断画面を開き重複をリストしてどの定義がアクティブであるかを表示していました

187 187 

188プラグイン `agents/` ディレクトリも再帰的にスキャンされます。プロジェクトおよびユーザースコープとは異なり、プラグインの `agents/` ディレクトリ内のサブフォルダは[スコープ付き識別子](#invoke-subagents-explicitly)の一部になります:プラグイン `my-plugin` の `agents/review/security.md` にあるファイルは `my-plugin:review:security` として登録されます。188プラグイン `agents/` ディレクトリも再帰的にスキャンされます。プロジェクトおよびユーザースコープとは異なり、プラグインの `agents/` ディレクトリ内のサブフォルダは[スコープ付き識別子](#invoke-subagents-explicitly)の一部になります:プラグイン `my-plugin` の `agents/review/security.md` にあるファイルは `my-plugin:review:security` として登録されます。

189 189 


268 268 

269フロントマターはサブエージェントのメタデータと設定を定義します。本体はサブエージェントの動作をガイドするシステムプロンプトになります。サブエージェントは、このシステムプロンプト(作業ディレクトリなどの基本的な環境詳細を含む)のみを受け取り、完全な Claude Code システムプロンプトは受け取りません。269フロントマターはサブエージェントのメタデータと設定を定義します。本体はサブエージェントの動作をガイドするシステムプロンプトになります。サブエージェントは、このシステムプロンプト(作業ディレクトリなどの基本的な環境詳細を含む)のみを受け取り、完全な Claude Code システムプロンプトは受け取りません。

270 270 

271[非対話モード](/ja/headless)では、[`--append-subagent-system-prompt`](/ja/cli-reference#cli-flags)フラグはネストされたサブエージェントを含む、すべてのサブエージェントのシステムプロンプトの末尾に提供するテキストを追加します。Claude Code v2.1.205 以降が必要です。

272 

271サブエージェントはメイン会話の現在の作業ディレクトリで開始します。サブエージェント内では、`cd` コマンドは Bash または PowerShell ツール呼び出し間で永続化されず、メイン会話の作業ディレクトリに影響しません。代わりにサブエージェントにリポジトリの分離されたコピーを提供するには、[`isolation: worktree`](#supported-frontmatter-fields)を設定します。273サブエージェントはメイン会話の現在の作業ディレクトリで開始します。サブエージェント内では、`cd` コマンドは Bash または PowerShell ツール呼び出し間で永続化されず、メイン会話の作業ディレクトリに影響しません。代わりにサブエージェントにリポジトリの分離されたコピーを提供するには、[`isolation: worktree`](#supported-frontmatter-fields)を設定します。

272 274 

275{/* min-version: 2.1.203 */}`isolation: worktree` を持つサブエージェントは、その worktree 内で Bash および PowerShell コマンドを実行します。作業ディレクトリが主要なチェックアウトに解決されるコマンド(例えば、サブエージェントの実行中に worktree ディレクトリが削除された場合)は、エラーで失敗します。v2.1.203 より前では、そのようなコマンドは主要なチェックアウトで実行される可能性がありました。

276 

273<h4 id="supported-frontmatter-fields">277<h4 id="supported-frontmatter-fields">

274 サポートされているフロントマターフィールド278 サポートされているフロントマターフィールド

275</h4>279</h4>


277以下のフィールドは YAML フロントマターで使用できます。`name` と `description` のみが必須です。281以下のフィールドは YAML フロントマターで使用できます。`name` と `description` のみが必須です。

278 282 

279| フィールド | 必須 | 説明 |283| フィールド | 必須 | 説明 |

280| :---------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |284| :---------------- | :-- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

281| `name` | はい | 小文字とハイフンを使用した一意の識別子。[Hooks](/ja/hooks#subagentstart)はこの値を `agent_type` として受け取ります。ファイル名は一致する必要はありません |285| `name` | はい | 小文字とハイフンを使用した一意の識別子。[Hooks](/ja/hooks#subagentstart)はこの値を `agent_type` として受け取ります。ファイル名は一致する必要はありません |

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`、`fable`、完全なモデル 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`、または {/* min-version: 2.1.200 */}`manual`(`default` のエイリアス)`manual` エイリアスには Claude Code v2.1.200 以降が必要です。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

287| `maxTurns` | いいえ | サブエージェントが停止する前の最大 agentic ターン数 |291| `maxTurns` | いいえ | サブエージェントが停止する前の最大 agentic ターン数 |

288| `skills` | いいえ | [スキル](/ja/skills)スタートアップ時にサブエージェントのコンテキストに[プリロード](/ja/skills)します。完全なスキルコンテンツが注入されます。説明だけでなく、スキル全体が注入されます。サブエージェントは、Skill ツールを通じて、リストされていないプロジェクト、ユーザー、およびプラグインスキルを引き続き呼び出すことができます |292| `skills` | いいえ | [スキル](/ja/skills)スタートアップ時にサブエージェントのコンテキストにプリロードします。完全なスキルコンテンツが注入されます。説明だけでなく、スキル全体が注入されます。サブエージェントは、Skill ツールを通じて、リストされていないプロジェクト、ユーザー、およびプラグインスキルを引き続き呼び出すことができます |

289| `mcpServers` | いいえ | このサブエージェントで利用可能な[MCP サーバー](/ja/mcp)。各エントリは、既に設定されたサーバーを参照するサーバー名(例:`"slack"`)または、サーバー名をキーとし、完全な[MCP サーバー設定](/ja/mcp#installing-mcp-servers)を値とするインライン定義のいずれかです。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |293| `mcpServers` | いいえ | このサブエージェントで利用可能な[MCP サーバー](/ja/mcp)。各エントリは、既に設定されたサーバーを参照するサーバー名(例:`"slack"`)または、サーバー名をキーとし、完全な[MCP サーバー設定](/ja/mcp#installing-mcp-servers)を値とするインライン定義のいずれかです。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

290| `hooks` | いいえ | このサブエージェントにスコープされた[ライフサイクルフック](#define-hooks-for-subagents)。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |294| `hooks` | いいえ | このサブエージェントにスコープされた[ライフサイクルフック](#define-hooks-for-subagents)。[プラグインサブエージェント](#choose-the-subagent-scope)では無視されます |

291| `memory` | いいえ | [永続メモリスコープ](#enable-persistent-memory):`user`、`project`、または `local`。クロスセッション学習を有効にします |295| `memory` | いいえ | [永続メモリスコープ](#enable-persistent-memory):`user`、`project`、または `local`。クロスセッション学習を有効にします |


792 796 

793v2.1.199 以降、実行が API エラー(使用制限や繰り返されるサーバーエラーなど)で終了するサブエージェントは、エラーテキストをサブエージェントの検出結果のように返すのではなく、その失敗を Claude に報告します。Claude が受け取るものは、サブエージェントが実行された場所によって異なります:797v2.1.199 以降、実行が API エラー(使用制限や繰り返されるサーバーエラーなど)で終了するサブエージェントは、エラーテキストをサブエージェントの検出結果のように返すのではなく、その失敗を Claude に報告します。Claude が受け取るものは、サブエージェントが実行された場所によって異なります:

794 798 

795* **フォアグラウンド**:レート制限、オーバーロード、またはサーバーエラーが既に出力を生成したサブエージェントを遮断する場合、Agent ツールはその部分的な出力を、サブエージェントが遮断され、タスクを完了しなかったというメモ付きで返します。それ以外の場合、ツール呼び出しは [`Agent terminated early due to an API error`](/ja/errors#agent-terminated-early-due-to-an-api-error) で失敗し、その後にエラーの詳細が続きます。799* **フォアグラウンド**:レート制限、オーバーロード、またはサーバーエラーが既に出力を生成したサブエージェントを遮断する場合、Agent ツールはその部分的な出力を、サブエージェントが遮断され、タスクを完了しなかったというメモ付きで返します。v2.1.200 以降、何も出力しなかったサブエージェント、またはツール呼び出しのみが出力だったサブエージェントは、[`Agent terminated early due to an API error`](/ja/errors#agent-terminated-early-due-to-an-api-error)で失敗し、その後にエラーの詳細が続きます。v2.1.199 では、ツール呼び出しのみの形状を遮断したレート制限、オーバーロード、またはサーバーエラーは、遮断メモのみを含む空の部分的な結果を返していました。

796* **バックグラウンド**:サブエージェントは失敗とマークされ、Claude が終了時に受け取るメッセージは API エラーに名前を付け、サブエージェントの最後の出力を含むため、部分的な作業は失われません。800* **バックグラウンド**:サブエージェントは失敗とマークされ、Claude が終了時に受け取るメッセージは API エラーに名前を付け、サブエージェントの最後の出力を含むため、部分的な作業は失われません。

797 801 

798基礎となる API エラーがクリアされたら、Claude にタスクを再試行するか、[サブエージェントを再開](#resume-subagents)するよう依頼してください。802基礎となる API エラーがクリアされたら、Claude にタスクを再試行するか、[サブエージェントを再開](#resume-subagents)するよう依頼してください。


868 872 

869ネストされたサブエージェントは、トップレベルのものと同じ方法で設定され、同じ[スコープ](#choose-the-subagent-scope)から解決されます。873ネストされたサブエージェントは、トップレベルのものと同じ方法で設定され、同じ[スコープ](#choose-the-subagent-scope)から解決されます。

870 874 

875プロンプト入力の下のサブエージェントパネルは、完全なツリーを表示します:各行は子孫の `(+N)` カウントを表示し、v2.1.193 以降、行を開くとそのサブエージェントの兄弟と直接の子が `main` へのパスとともに表示されます。

876 

871深さは、各レベルが[フォアグラウンドまたはバックグラウンド](#run-subagents-in-foreground-or-background)で実行されるかどうかに関係なく、メイン会話の下のサブエージェントレベルの数として数えられます。深さ 5 のサブエージェントは Agent ツールを受け取らず、さらに生成することはできません。制限は固定されており、設定不可能です。877深さは、各レベルが[フォアグラウンドまたはバックグラウンド](#run-subagents-in-foreground-or-background)で実行されるかどうかに関係なく、メイン会話の下のサブエージェントレベルの数として数えられます。深さ 5 のサブエージェントは Agent ツールを受け取らず、さらに生成することはできません。制限は固定されており、設定不可能です。

872 878 

873Claude Code v2.1.187 以降、バックグラウンドサブエージェントの深さは最初に生成されるときに固定され、後で[再開](#resume-subagents)しても深さは変わりません。例えば、メイン会話がサブエージェント A を生成し、A が深さ 2 でバックグラウンドサブエージェント B を生成する場合、B はメイン会話から直接再開するときも深さ 2 のままです。サブエージェントをより浅いコンテキストから再開しても、深さ制限が既に防止した追加レベルを生成させることはできません。879Claude Code v2.1.187 以降、バックグラウンドサブエージェントの深さは最初に生成されるときに固定され、後で[再開](#resume-subagents)しても深さは変わりません。例えば、メイン会話がサブエージェント A を生成し、A が深さ 2 でバックグラウンドサブエージェント B を生成する場合、B はメイン会話から直接再開するときも深さ 2 のままです。サブエージェントをより浅いコンテキストから再開しても、深さ制限が既に防止した追加レベルを生成させることはできません。


922 928 

923停止したサブエージェントが `SendMessage` を受け取った場合、新しい `Agent` 呼び出しを必要とせずにバックグラウンドで自動再開します。929停止したサブエージェントが `SendMessage` を受け取った場合、新しい `Agent` 呼び出しを必要とせずにバックグラウンドで自動再開します。

924 930 

931v2.1.205 以降、再開は同じ ID の下でエージェントの新しい実行を開始するため、既に失敗または完了していたサブエージェントはタスクリストと Agent SDK のタスクイベントで再度実行中として表示されます。v2.1.205 より前は、再開実行が動作している間、以前の失敗または完了ステータスを表示し続けていました。

932 

925v2.1.199 以降、`SendMessage` は、名前が会話の前半で到達したのと同じエージェントを引き続き参照していることを確認します。より新しいエージェントが名前を取得した場合(例えば、名前を再利用した再生成されたバックグラウンドエージェント)、Claude Code は送信を拒否し、エラーは名前が現在到達するエージェントを報告するため、Claude は再ターゲットできます。チェックは現在の会話にスコープされ、`/clear` でリセットされます。933v2.1.199 以降、`SendMessage` は、名前が会話の前半で到達したのと同じエージェントを引き続き参照していることを確認します。より新しいエージェントが名前を取得した場合(例えば、名前を再利用した再生成されたバックグラウンドエージェント)、Claude Code は送信を拒否し、エラーは名前が現在到達するエージェントを報告するため、Claude は再ターゲットできます。チェックは現在の会話にスコープされ、`/clear` でリセットされます。

926 934 

927v2.1.198 以降、サブエージェントは、それを起動したエージェントからのメッセージを通常のタスク指示として扱い、その権限設定内で機能します。2 つの制限は、メッセージの送信者に関係なく引き続き保持されます:保留中の権限プロンプトに対するエージェントメッセージからの承認はカウントされず、エージェントメッセージはサブエージェントの権限設定、`CLAUDE.md`、または設定を変更することはできません。権限システムまたはあなた自身のメッセージのみが承認を付与できます。935v2.1.198 以降、サブエージェントは、それを起動したエージェントからのメッセージを通常のタスク指示として扱い、その権限設定内で機能します。2 つの制限は、メッセージの送信者に関係なく引き続き保持されます:保留中の権限プロンプトに対するエージェントメッセージからの承認はカウントされず、エージェントメッセージはサブエージェントの権限設定、`CLAUDE.md`、または設定を変更することはできません。権限システムまたはあなた自身のメッセージのみが承認を付与できます。

Details

102 <th>Anthropic Console</th>102 <th>Anthropic Console</th>

103 <th>Amazon Bedrock</th>103 <th>Amazon Bedrock</th>

104 <th>Claude Platform on AWS</th>104 <th>Claude Platform on AWS</th>

105 <th>Google Vertex AI</th>105 <th>Google Cloud の Agent Platform(旧 Vertex AI</th>

106 <th>Microsoft Foundry</th>106 <th>Microsoft Foundry</th>

107 </tr>107 </tr>

108 </thead>108 </thead>


196 196 

197* [Claude for Teams または Enterprise](/ja/authentication#claude-for-teams-or-enterprise)197* [Claude for Teams または Enterprise](/ja/authentication#claude-for-teams-or-enterprise)

198* [Anthropic Console](/ja/authentication#claude-console-authentication)198* [Anthropic Console](/ja/authentication#claude-console-authentication)

199* [Claude apps gateway](/ja/claude-apps-gateway)、Amazon Bedrock、Google Vertex AI、Microsoft Foundry、または Anthropic API の前に IdP サインインを追加するセルフホスト型ゲートウェイ199* [Claude apps gateway](/ja/claude-apps-gateway)、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry、または Anthropic API の前に IdP サインインを追加するセルフホスト型ゲートウェイ

200* [Amazon Bedrock](/ja/amazon-bedrock)200* [Amazon Bedrock](/ja/amazon-bedrock)

201* [Claude Platform on AWS](/ja/claude-platform-on-aws)201* [Claude Platform on AWS](/ja/claude-platform-on-aws)

202* [Google Vertex AI](/ja/google-vertex-ai)202* [Google Cloud の Agent Platform](/ja/google-vertex-ai)

203* [Microsoft Foundry](/ja/microsoft-foundry)203* [Microsoft Foundry](/ja/microsoft-foundry)

204 204 

205<h2 id="configure-proxies-and-gateways">205<h2 id="configure-proxies-and-gateways">


219 219 

220<Tabs>220<Tabs>

221 <Tab title="企業プロキシ">221 <Tab title="企業プロキシ">

222 以下の[環境変数](/ja/env-vars)を設定して、Bedrock トラフィックを企業プロキシを通じてルーティングします。222 以下の[環境変数](/ja/env-vars)を設定して、Amazon Bedrock トラフィックを企業プロキシを通じてルーティングします。

223 223 

224 ```bash theme={null}224 ```bash theme={null}

225 # Bedrock を有効化225 # Bedrock を有効化


232 </Tab>232 </Tab>

233 233 

234 <Tab title="LLM ゲートウェイ">234 <Tab title="LLM ゲートウェイ">

235 以下の[環境変数](/ja/env-vars)を設定して、Bedrock トラフィックを LLM ゲートウェイを通じてルーティングします。235 以下の[環境変数](/ja/env-vars)を設定して、Amazon Bedrock トラフィックを LLM ゲートウェイを通じてルーティングします。

236 236 

237 ```bash theme={null}237 ```bash theme={null}

238 # Bedrock を有効化238 # Bedrock を有効化


251 251 

252<Tabs>252<Tabs>

253 <Tab title="企業プロキシ">253 <Tab title="企業プロキシ">

254 以下の[環境変数](/ja/env-vars)を設定して、Foundry トラフィックを企業プロキシを通じてルーティングします。254 以下の[環境変数](/ja/env-vars)を設定して、Microsoft Foundry トラフィックを企業プロキシを通じてルーティングします。

255 255 

256 ```bash theme={null}256 ```bash theme={null}

257 # Microsoft Foundry を有効化257 # Microsoft Foundry を有効化


265 </Tab>265 </Tab>

266 266 

267 <Tab title="LLM ゲートウェイ">267 <Tab title="LLM ゲートウェイ">

268 以下の[環境変数](/ja/env-vars)を設定して、Foundry トラフィックを LLM ゲートウェイを通じてルーティングします。268 以下の[環境変数](/ja/env-vars)を設定して、Microsoft Foundry トラフィックを LLM ゲートウェイを通じてルーティングします。

269 269 

270 ```bash theme={null}270 ```bash theme={null}

271 # Microsoft Foundry を有効化271 # Microsoft Foundry を有効化


278 </Tab>278 </Tab>

279</Tabs>279</Tabs>

280 280 

281<h3 id="google-vertex-ai">281<h3 id="google-cloud’s-agent-platform">

282 Google Vertex AI282 Google Cloud の Agent Platform

283</h3>283</h3>

284 284 

285<Tabs>285<Tabs>

286 <Tab title="企業プロキシ">286 <Tab title="企業プロキシ">

287 以下の[環境変数](/ja/env-vars)を設定して、Vertex AI トラフィックを企業プロキシを通じてルーティングします。287 以下の[環境変数](/ja/env-vars)を設定して、Google Cloud の Agent Platform トラフィックを企業プロキシを通じてルーティングします。

288 288 

289 ```bash theme={null}289 ```bash theme={null}

290 # Vertex を有効化290 # Agent Platform を有効化

291 export CLAUDE_CODE_USE_VERTEX=1291 export CLAUDE_CODE_USE_VERTEX=1

292 export CLOUD_ML_REGION=us-east5292 export CLOUD_ML_REGION=us-east5

293 export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id293 export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id


298 </Tab>298 </Tab>

299 299 

300 <Tab title="LLM ゲートウェイ">300 <Tab title="LLM ゲートウェイ">

301 以下の[環境変数](/ja/env-vars)を設定して、Vertex AI トラフィックを LLM ゲートウェイを通じてルーティングします。301 以下の[環境変数](/ja/env-vars)を設定して、Google Cloud の Agent Platform トラフィックを LLM ゲートウェイを通じてルーティングします。

302 302 

303 ```bash theme={null}303 ```bash theme={null}

304 # Vertex を有効化304 # Agent Platform を有効化

305 export CLAUDE_CODE_USE_VERTEX=1305 export CLAUDE_CODE_USE_VERTEX=1

306 306 

307 # LLM ゲートウェイを構成307 # LLM ゲートウェイを構成


348 クラウドプロバイダーのモデルバージョンをピン留めする348 クラウドプロバイダーのモデルバージョンをピン留めする

349</h3>349</h3>

350 350 

351[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)を参照してください。351[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、[Microsoft 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)を参照してください。

352 352 

353<h3 id="configure-security-policies">353<h3 id="configure-security-policies">

354 セキュリティポリシーを構成する354 セキュリティポリシーを構成する

tools-reference.md +11 −11

Details

11カスタム ツールを追加するには、[MCP サーバー](/ja/mcp)を接続します。再利用可能なプロンプトベースのワークフローで Claude を拡張するには、[skill](/ja/skills)を作成します。これは新しいツール エントリを追加するのではなく、既存の `Skill` ツールを通じて実行されます。11カスタム ツールを追加するには、[MCP サーバー](/ja/mcp)を接続します。再利用可能なプロンプトベースのワークフローで Claude を拡張するには、[skill](/ja/skills)を作成します。これは新しいツール エントリを追加するのではなく、既存の `Skill` ツールを通じて実行されます。

12 12 

13| ツール | 説明 | 権限が必要 |13| ツール | 説明 | 権限が必要 |

14| :--------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---- |14| :--------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---- |

15| `Agent` | 独自のコンテキストウィンドウを持つ [subagent](/ja/sub-agents)を生成してタスクを処理します。[Agent ツールの動作](#agent-tool-behavior)を参照してください | いいえ |15| `Agent` | 独自のコンテキストウィンドウを持つ [subagent](/ja/sub-agents)を生成してタスクを処理します。[Agent ツールの動作](#agent-tool-behavior)を参照してください | いいえ |

16| `Artifact` | HTML または Markdown ファイルを [artifact](/ja/artifacts)として公開します:claude.ai 上の非公開でインタラクティブなページで、組織内で共有できます。{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Pro、Max、Team、または Enterprise プランが必要で、`/login` 認証が必要です。[可用性](/ja/artifacts#availability)を参照してください | はい |16| `Artifact` | HTML または Markdown ファイルを [artifact](/ja/artifacts)として公開します:claude.ai 上の非公開でインタラクティブなページで、組織内で共有できます。{/* plan-availability: feature=artifacts plans=pro,max,team,enterprise providers=anthropic */}Pro、Max、Team、または Enterprise プランが必要で、`/login` 認証が必要です。[可用性](/ja/artifacts#availability)を参照してください | はい |

17| `AskUserQuestion` | 要件を収集したり曖昧さを明確にするために複数選択肢の質問をします。{/* min-version: 2.1.198 */}v2.1.198 以降60 秒以内に応答しない場合、ダイアログは自動的に閉じます:既に選択したオプションを送信し、キーボードから離れている可能性があることを Claude に伝えるため、Claude は独自の判断で進行し、後で再度質問できます。最後の 20 秒間はカウントダウンが表示されます。キープレスはダイアログを開いたままにし、フォーカスを報告するターミナルのフォーカスされたウィンドウも同様です。[`CLAUDE_AFK_TIMEOUT_MS`](/ja/env-vars#variables)環境変数を設定して、Claude Code が待機する時間を変更するか、`86400000`(24 時間)などの大きな値に設定して、離席中もクエスチョンを開いたままにします。このタイムアウトは `AskUserQuestion` の複数選択肢の質問にのみ適用されます。権限プロンプト(プラン承認を含む)は、アイドル時に自動解決されることはありません | いいえ |17| `AskUserQuestion` | 要件を収集したり曖昧さを明確にするために複数選択肢の質問をします。{/* min-version: 2.1.200 */}質問は回答するまで開いたままです:デフォルトではアイドル タイムアウトはありません。アイドル ダイアログを自動的に続行させるには、ユーザー `settings.json` または `/config` の **Question auto-continue timeout** 行で [`askUserQuestionTimeout`](/ja/settings#available-settings) 設定を `60s``5m`、または `10m` に設定します。選択したアイドル時間が経過してから入力がない場合、ダイアログは自動的に閉じます:既に選択したオプションを送信し、キーボードから離れている可能性があることを Claude に伝えるため、Claude は独自の判断で進行し、後で再度質問できます。最後の 20 秒間はカウントダウンが表示されます。キープレスはタイマーを再開し、フォーカスを報告するターミナルのフォーカスされたウィンドウも同様です。タイムアウトは `AskUserQuestion` の複数選択肢の質問にのみ適用されます。権限プロンプト(プラン承認を含む)は、アイドル時に自動解決されることはありません。v2.1.198 および v2.1.199 では、ダイアログはデフォルトで 60 秒のアイドル後に自動的に続行され、[`CLAUDE_AFK_TIMEOUT_MS`](/ja/env-vars#variables)がそれを変更する唯一の方法でした | いいえ |

18| `Bash` | 環境でシェル コマンドを実行します。[Bash ツールの動作](#bash-tool-behavior)を参照してください | はい |18| `Bash` | 環境でシェル コマンドを実行します。[Bash ツールの動作](#bash-tool-behavior)を参照してください | はい |

19| `CronCreate` | 現在のセッション内で定期的または 1 回限りのプロンプトをスケジュールします。タスクはセッションスコープであり、`--resume` または `--continue` で復元されます(有効期限が切れていない場合)。[スケジュール済みタスク](/ja/scheduled-tasks)を参照してください | いいえ |19| `CronCreate` | 現在のセッション内で定期的または 1 回限りのプロンプトをスケジュールします。タスクはセッションスコープであり、`--resume` または `--continue` で復元されます(有効期限が切れていない場合)。[スケジュール済みタスク](/ja/scheduled-tasks)を参照してください | いいえ |

20| `CronDelete` | ID でスケジュール済みタスクをキャンセルします | いいえ |20| `CronDelete` | ID でスケジュール済みタスクをキャンセルします | いいえ |

21| `CronList` | セッション内のすべてのスケジュール済みタスクをリストします | いいえ |21| `CronList` | セッション内のすべてのスケジュール済みタスクをリストします | いいえ |

22| `Edit` | 特定のファイルに対して対象を絞った編集を行います。[Edit ツールの動作](#edit-tool-behavior)を参照してください | はい |22| `Edit` | 特定のファイルに対して対象を絞った編集を行います。[Edit ツールの動作](#edit-tool-behavior)を参照してください | はい |

23| `EnterPlanMode` | Plan Mode に切り替えてコーディング前にアプローチを設計します | いいえ |23| `EnterPlanMode` | Plan Mode に切り替えてコーディング前にアプローチを設計します | いいえ |

24| `EnterWorktree` | 分離された [git worktree](/ja/worktrees)を作成してそこに切り替えます。現在のリポジトリの既存の worktree に切り替えるには、新しいものを作成する代わりに `path` を渡します。[`isolation: worktree`](/ja/sub-agents#supported-frontmatter-fields)などで既に独自の作業ディレクトリで実行される subagent では、`path` フォームのみが利用可能で、ターゲットは `.claude/worktrees/` の下にある必要があります | いいえ |24| `EnterWorktree` | 分離された [git worktree](/ja/worktrees)を作成してそこに切り替えます。現在のリポジトリの既存の worktree に切り替えるには、新しいものを作成する代わりに `path` を渡します。{/* min-version: 2.1.203 */}最初のエントリでは、ターゲットは現在のリポジトリの worktree、またはマルチリポジトリ ワークスペースでは、その中にネストされたリポジトリの worktree である可能性があります。v2.1.203 より前では、ネストされたリポジトリの worktree は拒否されました。worktree セッション内から、または [`isolation: worktree`](/ja/sub-agents#supported-frontmatter-fields)などでピン留めされた作業ディレクトリを持つ subagent から、`path` フォームのみが利用可能で、ターゲットはセッションのリポジトリの `.claude/worktrees/` の下にある必要があります | いいえ |

25| `ExitPlanMode` | 承認用のプランを提示して Plan Mode を終了します | はい |25| `ExitPlanMode` | 承認用のプランを提示して Plan Mode を終了します | はい |

26| `ExitWorktree` | worktree セッションを終了して元のディレクトリに戻ります。[`isolation: worktree`](/ja/sub-agents#supported-frontmatter-fields)などで既に独自の作業ディレクトリで実行される subagent では利用できません | いいえ |26| `ExitWorktree` | worktree セッションを終了して元のディレクトリに戻ります。[`isolation: worktree`](/ja/sub-agents#supported-frontmatter-fields)などで既に独自の作業ディレクトリで実行される subagent では利用できません | いいえ |

27| `Glob` | パターン マッチングに基づいてファイルを検索します。[Glob ツールの動作](#glob-tool-behavior)を参照してください | いいえ |27| `Glob` | パターン マッチングに基づいてファイルを検索します。[Glob ツールの動作](#glob-tool-behavior)を参照してください | いいえ |


31| `Monitor` | コマンドをバックグラウンドで実行し、各出力行を Claude にフィードバックするため、会話の途中でログ エントリ、ファイル変更、またはポーリング ステータスに対応できます。WebSocket を開いて、各受信メッセージをイベントとして扱うこともできます。[Monitor ツール](#monitor-tool)を参照してください | はい |31| `Monitor` | コマンドをバックグラウンドで実行し、各出力行を Claude にフィードバックするため、会話の途中でログ エントリ、ファイル変更、またはポーリング ステータスに対応できます。WebSocket を開いて、各受信メッセージをイベントとして扱うこともできます。[Monitor ツール](#monitor-tool)を参照してください | はい |

32| `NotebookEdit` | Jupyter ノートブック セルを変更します。[NotebookEdit ツールの動作](#notebookedit-tool-behavior)を参照してください | はい |32| `NotebookEdit` | Jupyter ノートブック セルを変更します。[NotebookEdit ツールの動作](#notebookedit-tool-behavior)を参照してください | はい |

33| `PowerShell` | PowerShell コマンドをネイティブに実行します。[PowerShell ツール](#powershell-tool)の可用性を参照してください | はい |33| `PowerShell` | PowerShell コマンドをネイティブに実行します。[PowerShell ツール](#powershell-tool)の可用性を参照してください | はい |

34| `PushNotification` | デスクトップ通知を送信し、[Remote Control](/ja/remote-control)が接続されている場合は電話プッシュ通知を送信するため、長時間実行タスクまたは[スケジュール済みタスク](/ja/scheduled-tasks)が離席時に到達できます。{/* plan-availability: feature=push-notifications providers=anthropic */}プッシュ配信は Anthropic ホスト インフラストラクチャを通じて実行されます。これは Amazon Bedrock、Google Vertex AI、または Microsoft Foundry からはアクセスできません | いいえ |34| `PushNotification` | デスクトップ通知を送信し、[Remote Control](/ja/remote-control)が接続されている場合は電話プッシュ通知を送信するため、長時間実行タスクまたは[スケジュール済みタスク](/ja/scheduled-tasks)が離席時に到達できます。{/* plan-availability: feature=push-notifications providers=anthropic */}プッシュ配信は Anthropic ホスト インフラストラクチャを通じて実行されます。これは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry からはアクセスできません | いいえ |

35| `Read` | ファイルの内容を読み取ります。[Read ツールの動作](#read-tool-behavior)を参照してください | いいえ |35| `Read` | ファイルの内容を読み取ります。[Read ツールの動作](#read-tool-behavior)を参照してください | いいえ |

36| `ReadMcpResourceTool` | URI で特定の MCP リソースを読み取ります | いいえ |36| `ReadMcpResourceTool` | URI で特定の MCP リソースを読み取ります | いいえ |

37| `RemoteTrigger` | claude.ai で[ルーチン](/ja/routines)を作成、更新、実行、リストします。`/schedule` コマンドをサポートします。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}ルーチンは claude.ai に存在し、Pro、Max、Team、または Enterprise プランが必要なため、このツールは Amazon Bedrock、Google Vertex AI、または Microsoft Foundry からはアクセスできません | いいえ |37| `RemoteTrigger` | claude.ai で[ルーチン](/ja/routines)を作成、更新、実行、リストします。`/schedule` コマンドをサポートします。{/* plan-availability: feature=routines plans=pro,max,team,enterprise providers=anthropic */}ルーチンは claude.ai に存在し、Pro、Max、Team、または Enterprise プランが必要なため、このツールは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry からはアクセスできません | いいえ |

38| `ReportFindings` | コード レビューの検出結果を構造化されたリストとして報告します。検出結果ごとにファイル、概要、失敗シナリオがあり、Claude Code はテキストとして出力するのではなく、それらをレンダリングできます。アクティブなコード レビュー指示が Claude にそれを呼び出すよう指示した場合、Claude はそれを呼び出します。{/* min-version: 2.1.196 */}Claude Code v2.1.196 以降が必要です。{/* min-version: 2.1.199 */}v2.1.199 以降、検出結果はオプションの `category` スラッグ(`correctness` や `test-coverage` など)を含めることもでき、レンダリングされたリストのファイル位置の横に表示されます | いいえ |38| `ReportFindings` | コード レビューの検出結果を構造化されたリストとして報告します。検出結果ごとにファイル、概要、失敗シナリオがあり、Claude Code はテキストとして出力するのではなく、それらをレンダリングできます。アクティブなコード レビュー指示が Claude にそれを呼び出すよう指示した場合、Claude はそれを呼び出します。{/* min-version: 2.1.196 */}Claude Code v2.1.196 以降が必要です。{/* min-version: 2.1.199 */}v2.1.199 以降、検出結果はオプションの `category` スラッグ(`correctness` や `test-coverage` など)を含めることもでき、レンダリングされたリストのファイル位置の横に表示されます | いいえ |

39| `ScheduleWakeup` | [self-paced `/loop`](/ja/scheduled-tasks#let-claude-choose-the-interval)の次の反復をスケジュール変更します。Claude は各反復の終了時にこれを呼び出して、次の実行時刻を 1 分から 1 時間の間で選択します。直接呼び出すことはありません。保留中のウェイクアップは [Stop hook input](/ja/hooks#stop-input)の `session_crons` に表示されます。{/* plan-availability: feature=loop-dynamic providers=anthropic */}Amazon Bedrock、Google Vertex AI、または Microsoft Foundry では利用できません。これらでは、間隔のない `/loop` プロンプトは固定スケジュールで実行されます | いいえ |39| `ScheduleWakeup` | [self-paced `/loop`](/ja/scheduled-tasks#let-claude-choose-the-interval)の次の反復をスケジュール変更します。Claude は各反復の終了時にこれを呼び出して、次の実行時刻を 1 分から 1 時間の間で選択します。直接呼び出すことはありません。ループを終了する代わりに、Claude は `stop: true` で呼び出します。これにより、保留中のウェイクアップがキャンセルされます。{/* min-version: 2.1.202 */}}`stop` フィールドには Claude Code v2.1.202 以降が必要です。保留中のウェイクアップは [Stop hook input](/ja/hooks#stop-input)の `session_crons` に表示されます。{/* plan-availability: feature=loop-dynamic providers=anthropic */}Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。これらでは、間隔のない `/loop` プロンプトは固定スケジュールで実行されます | いいえ |

40| `SendMessage` | [agent team](/ja/agent-teams)メンバーにメッセージを送信するか、agent ID または名前で [subagent](/ja/sub-agents#resume-subagents)を再開します。停止した subagent はバックグラウンドで自動的に再開されます。構造化されたチーム プロトコル メッセージには agent teams が必要です。受信者は別のエージェントからのメッセージを、あなたの同意または承認として扱うことはありません。{/* min-version: 2.1.198 */}v2.1.198 以降、subagent はそれを起動したエージェントからのメッセージをピア リクエストではなく通常のタスク指示として扱います。{/* min-version: 2.1.199 */}v2.1.199 以降、会話の早い段階で解決された名前とは異なるエージェントに現在解決される名前への送信は、配信される代わりに拒否されます。[subagent を再開](/ja/sub-agents#resume-subagents)を参照してください | いいえ |40| `SendMessage` | [agent team](/ja/agent-teams)メンバーにメッセージを送信するか、agent ID または名前で [subagent](/ja/sub-agents#resume-subagents)を再開します。停止した subagent はバックグラウンドで自動的に再開されます。構造化されたチーム プロトコル メッセージには agent teams が必要です。受信者は別のエージェントからのメッセージを、あなたの同意または承認として扱うことはありません。{/* min-version: 2.1.198 */}v2.1.198 以降、subagent はそれを起動したエージェントからのメッセージをピア リクエストではなく通常のタスク指示として扱います。{/* min-version: 2.1.199 */}v2.1.199 以降、会話の早い段階で解決された名前とは異なるエージェントに現在解決される名前への送信は、配信される代わりに拒否されます。[subagent を再開](/ja/sub-agents#resume-subagents)を参照してください | いいえ |

41| `SendUserFile` | セッションからファイルをオプションのキャプション付きで送信するため、生成されたレポート、図、スクリーンショット、または構築されたアーティファクトがトランスクリプトでのみ言及されるのではなく、デバイスに到達します。{/* min-version: 2.1.196 */}v2.1.196 以降、オプションの `display` 入力がプレゼンテーションを制御します:`render` はファイルをクライアントにインラインで開き、`attach` はダウンロード カードのみを表示し、設定されていない場合はクライアントがファイル タイプで決定します。[Remote Control](/ja/remote-control)クライアントが接続されている場合、またはセッションが [Claude Code on the web](/ja/claude-code-on-the-web)などのマネージド クラウド環境で実行されている場合に利用可能です。配信は Anthropic ホスト インフラストラクチャを通じて実行されるため、このツールは Amazon Bedrock、Google Vertex AI、または Microsoft Foundry では利用できません | いいえ |41| `SendUserFile` | セッションからファイルをオプションのキャプション付きで送信するため、生成されたレポート、図、スクリーンショット、または構築されたアーティファクトがトランスクリプトでのみ言及されるのではなく、デバイスに到達します。{/* min-version: 2.1.196 */}v2.1.196 以降、オプションの `display` 入力がプレゼンテーションを制御します:`render` はファイルをクライアントにインラインで開き、`attach` はダウンロード カードのみを表示し、設定されていない場合はクライアントがファイル タイプで決定します。[Remote Control](/ja/remote-control)クライアントが接続されている場合、またはセッションが [Claude Code on the web](/ja/claude-code-on-the-web)などのマネージド クラウド環境で実行されている場合に利用可能です。配信は Anthropic ホスト インフラストラクチャを通じて実行されるため、このツールは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません | いいえ |

42| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}}`ONBOARDING.md` をアップロードし、チームメンバーが Claude Code で開くことができる共有リンクを返します。ガイドが作成された後、`/team-onboarding` から呼び出されます。claude.ai の Pro、Max、Team、および Enterprise プランのサブスクライバーが利用可能です | はい |42| `ShareOnboardingGuide` | {/* plan-availability: feature=onboarding-guide-share plans=pro,max,team,enterprise providers=anthropic */}}`ONBOARDING.md` をアップロードし、チームメンバーが Claude Code で開くことができる共有リンクを返します。ガイドが作成された後、`/team-onboarding` から呼び出されます。claude.ai の Pro、Max、Team、および Enterprise プランのサブスクライバーが利用可能です | はい |

43| `Skill` | メイン会話内で [skill](/ja/skills#control-who-invokes-a-skill)を実行します | はい |43| `Skill` | メイン会話内で [skill](/ja/skills#control-who-invokes-a-skill)を実行します | はい |

44| `TaskCreate` | タスク リストに新しいタスクを作成します | いいえ |44| `TaskCreate` | タスク リストに新しいタスクを作成します | いいえ |

45| `TaskGet` | 特定のタスクの完全な詳細を取得します | いいえ |45| `TaskGet` | 特定のタスクの完全な詳細を取得します | いいえ |

46| `TaskList` | すべてのタスクとその現在のステータスをリストします | いいえ |46| `TaskList` | すべてのタスクとその現在のステータスをリストします | いいえ |

47| `TaskOutput` | (非推奨)バックグラウンド タスクから出力を取得します。タスクの出力ファイル パスで `Read` を使用することをお勧めします | いいえ |47| `TaskOutput` | バックグラウンド タスクから出力を取得します。タスクの出力ファイル パスで `Read` を使用することをお勧めします。{/* min-version: 2.1.203 */}タスク ID が一致しない場合、エラーは実行中のバックグラウンド エージェントを ID と説明でリストします。v2.1.203 より前では、エラーは不足している ID のみを名前付けていました | いいえ |

48| `TaskStop` | ID で実行中のバックグラウンド タスクを終了します。{/* min-version: 2.1.198 */}v2.1.198 以降、[agent team メンバー](/ja/agent-teams)または agent ID または名前で名前付きバックグラウンド エージェントも受け入れます | いいえ |48| `TaskStop` | ID で実行中のバックグラウンド タスクを終了します。{/* min-version: 2.1.198 */}また、[agent team メンバー](/ja/agent-teams)または agent ID または名前で名前付きバックグラウンド エージェントも受け入れます。v2.1.198 より前では、バックグラウンド タスク ID のみを受け入れていました。{/* min-version: 2.1.203 */}タスク ID が一致しない場合、エラーは実行中のバックグラウンド エージェントを ID と説明でリストします。これには別のエージェントが生成したエージェントも含まれます。v2.1.203 より前では、エラーは実行中のチームメンバーと名前付きエージェントをリストしていましたが、別のエージェントが生成したバックグラウンド エージェントはリストしていなかったため、メイン会話から識別または停止できませんでした | いいえ |

49| `TaskUpdate` | タスク ステータス、依存関係、詳細を更新するか、タスクを削除します | いいえ |49| `TaskUpdate` | タスク ステータス、依存関係、詳細を更新するか、タスクを削除します | いいえ |

50| `TodoWrite` | {/* min-version: 2.1.142 */}セッション タスク チェックリストを管理します。v2.1.142 以降、`TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate` を優先するため、デフォルトで無効になっています。`CLAUDE_CODE_ENABLE_TASKS=0` を設定して再度有効にします | いいえ |50| `TodoWrite` | {/* min-version: 2.1.142 */}セッション タスク チェックリストを管理します。v2.1.142 以降、`TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate` を優先するため、デフォルトで無効になっています。`CLAUDE_CODE_ENABLE_TASKS=0` を設定して再度有効にします | いいえ |

51| `ToolSearch` | [ツール検索](/ja/mcp#scale-with-mcp-tool-search)が有効な場合、遅延ツールを検索してロードします | いいえ |51| `ToolSearch` | [ツール検索](/ja/mcp#scale-with-mcp-tool-search)が有効な場合、遅延ツールを検索してロードします | いいえ |


218 218 

219Monitor がコマンドを実行する場合、[Bash と同じ権限ルール](/ja/permissions#tool-specific-permission-rules)を使用するため、Bash に設定した `allow` および `deny` パターンがここにも適用されます。[WebSocket ソース](#websocket-source)には独自の承認プロンプトがあります。219Monitor がコマンドを実行する場合、[Bash と同じ権限ルール](/ja/permissions#tool-specific-permission-rules)を使用するため、Bash に設定した `allow` および `deny` パターンがここにも適用されます。[WebSocket ソース](#websocket-source)には独自の承認プロンプトがあります。

220 220 

221このツールは Amazon Bedrock、Google Vertex AI、または Microsoft Foundry では利用できません。`DISABLE_TELEMETRY` または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合も利用できません。221このツールは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。`DISABLE_TELEMETRY` または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合も利用できません。

222 222 

223プラグインは、Claude に開始するよう依頼する代わりに、プラグインがアクティブな場合に自動的に開始される Monitor を宣言できます。[プラグイン Monitor](/ja/plugins-reference#monitors)を参照してください。223プラグインは、Claude に開始するよう依頼する代わりに、プラグインがアクティブな場合に自動的に開始される Monitor を宣言できます。[プラグイン Monitor](/ja/plugins-reference#monitors)を参照してください。

224 224 


367WebSearch 権限ルールは指定子を取りません。`allow` または `deny` の裸の `WebSearch` エントリのみが唯一の形式です。367WebSearch 権限ルールは指定子を取りません。`allow` または `deny` の裸の `WebSearch` エントリのみが唯一の形式です。

368 368 

369<Note>369<Note>

370 WebSearch は Claude API、[Claude Platform on AWS](/ja/claude-platform-on-aws)、および Microsoft Foundry で利用可能です。Google Cloud Vertex AI では、Opus、Sonnet、Haiku を含む Claude 4 以降のモデルで機能します。Amazon Bedrock はサーバー側の Web 検索ツールを公開していません。370 WebSearch は Claude API、[Claude Platform on AWS](/ja/claude-platform-on-aws)、および Microsoft Foundry で利用可能です。Google Cloud Agent Platform では、Opus、Sonnet、Haiku を含む Claude 4 以降のモデルで機能します。Amazon Bedrock はサーバー側の Web 検索ツールを公開していません。

371</Note>371</Note>

372 372 

373<h2 id="write-tool-behavior">373<h2 id="write-tool-behavior">

Details

15表示されているエラーメッセージまたは症状を修正方法と照合してください:15表示されているエラーメッセージまたは症状を修正方法と照合してください:

16 16 

17| 表示内容 | 解決方法 |17| 表示内容 | 解決方法 |

18| :------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ |18| :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------ |

19| `command not found: claude` または `'claude' is not recognized` | [PATH を修正する](#command-not-found-claude-after-installation) |19| `command not found: claude` または `'claude' is not recognized` | [PATH を修正する](#command-not-found-claude-after-installation) |

20| `syntax error near unexpected token '<'` | [インストールスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |20| `syntax error near unexpected token '<'` | [インストールスクリプトが HTML を返す](#install-script-returns-html-instead-of-a-shell-script) |

21| `curl: (22) The requested URL returned error: 403` | [インストールスクリプトが 403 を返す](#install-script-returns-html-instead-of-a-shell-script) |21| `curl: (22) The requested URL returned error: 403` | [インストールスクリプトが 403 を返す](#install-script-returns-html-instead-of-a-shell-script) |

22| `curl: (23)` または `curl: (56) Failure writing output to destination` | [接続性を確認するか、別のインストーラーを使用する](#curl-56-failure-writing-output-to-destination) |22| `curl: (23)` または `curl: (56) Failure writing output to destination` | [接続性を確認するか、別のインストーラーを使用する](#curl-56-failure-writing-output-to-destination) |

23| Linux でのインストール中に `Killed` | [低メモリサーバーにスワップスペースを追加する](#install-killed-on-low-memory-linux-servers) |23| Linux でのインストール中に `Killed` または `Installation was killed before it could finish (exit code 137)` | [メモリを解放するか、スワップスペースを追加する](#install-killed-on-low-memory-linux-servers) |

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) |


39| `App unavailable in region` | Claude Code はお客様の国では利用できません。[サポートされている国](https://www.anthropic.com/supported-countries)を参照してください。 |39| `App unavailable in region` | Claude Code はお客様の国では利用できません。[サポートされている国](https://www.anthropic.com/supported-countries)を参照してください。 |

40| `unable to get local issuer certificate` | [企業 CA 証明書を設定する](#tls-or-ssl-connection-errors) |40| `unable to get local issuer certificate` | [企業 CA 証明書を設定する](#tls-or-ssl-connection-errors) |

41| `OAuth error` または `403 Forbidden` | [認証を修正する](#login-and-authentication) |41| `OAuth error` または `403 Forbidden` | [認証を修正する](#login-and-authentication) |

42| `Could not load the default credentials` または `Could not load credentials from any providers` | [Bedrock、Vertex、または Foundry 認証情報](#bedrock-vertex-or-foundry-credentials-not-loading) |42| `Could not load the default credentials` または `Could not load credentials from any providers` | [Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 認証情報](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

43| `ChainedTokenCredential authentication failed` または `CredentialUnavailableError` | [Bedrock、Vertex、または Foundry 認証情報](#bedrock-vertex-or-foundry-credentials-not-loading) |43| `ChainedTokenCredential authentication failed` または `CredentialUnavailableError` | [Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 認証情報](#bedrock-agent-platform-or-foundry-credentials-not-loading) |

44| `API Error: 500`、`529 Overloaded`、`429`、またはその他の 4xx および 5xx エラー(上記以外) | [エラーリファレンス](/ja/errors)を参照してください |44| `API Error: 500`、`529 Overloaded`、`429`、またはその他の 4xx および 5xx エラー(上記以外) | [エラーリファレンス](/ja/errors)を参照してください |

45 45 

46問題がリストに記載されていない場合は、以下の診断チェックを実行して、原因を特定してください。46問題がリストに記載されていない場合は、以下の診断チェックを実行して、原因を特定してください。


538 低メモリ Linux サーバーでインストール中に Killed538 低メモリ Linux サーバーでインストール中に Killed

539</h3>539</h3>

540 540 

541VPS またはクラウドインスタンスでインストール中に `Killed` が表示される場合541インストール中に `Killed` メッセージが表示される場合、通常は Linux のメモリ不足(OOM)キラーがシステムがメモリ不足になったため `claude install` ステップを終了したことを意味します。これは小規模な VPS とクラウドインスタンスで一般的です。インストールスクリプトは原因を報告し、終了コード 137 で終了します

542 542 

543```text theme={null}543```text theme={null}

544Setting up Claude Code...544Setting up Claude Code...

545Installing Claude Code native build latest...

546bash: line 142: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}545bash: line 142: 34803 Killed "$binary_path" install ${TARGET:+"$TARGET"}

546Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.

547Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

547```548```

548 549 

549Linux OOM キラーはシステムがメモリ不足になったためプロセスを終了しました。Claude Code には少なくとも 4 GB の利用可能な RAM が必要です550v2.1.200 より前では、スクリプトはシェルの単なる `Killed` 行と説明なしで終了しました

551 

552インストールには約 512 MB の空きメモリが必要で、Claude Code を実行するにはさらに多くが必要です。[システム要件](/ja/setup#system-requirements)を参照してください。

550 553 

551**解決策:**554**解決策:**

552 555 


781`@anthropic-ai/claude-code` npm パッケージは、`@anthropic-ai/claude-code-darwin-arm64` などのプラットフォーム固有のオプション依存関係を通じてネイティブバイナリを取得します。インストール後に `claude` を実行すると `Could not find native binary package "@anthropic-ai/claude-code-<platform>"` が出力される場合は、次の原因を確認してください:784`@anthropic-ai/claude-code` npm パッケージは、`@anthropic-ai/claude-code-darwin-arm64` などのプラットフォーム固有のオプション依存関係を通じてネイティブバイナリを取得します。インストール後に `claude` を実行すると `Could not find native binary package "@anthropic-ai/claude-code-<platform>"` が出力される場合は、次の原因を確認してください:

782 785 

783* **オプション依存関係が無効になっています。** npm インストールコマンドから `--omit=optional` を削除し、pnpm から `--no-optional` を削除し、yarn から `--ignore-optional` を削除し、`.npmrc` が `optional=false` を設定していないことを確認してから、再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックはありません。786* **オプション依存関係が無効になっています。** npm インストールコマンドから `--omit=optional` を削除し、pnpm から `--no-optional` を削除し、yarn から `--ignore-optional` を削除し、`.npmrc` が `optional=false` を設定していないことを確認してから、再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックはありません。

784* **サポートされていないプラットフォーム。** プリビルドバイナリは `darwin-arm64`、`darwin-x64`、`linux-x64`、`linux-arm64`、`linux-x64-musl`、`linux-arm64-musl`、`win32-x64`、および `win32-arm64` 用に公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。[システム要件](/ja/setup#system-requirements)を参照してください。787* **サポートされていないプラットフォーム。** プリビルドバイナリは `darwin-arm64`、`darwin-x64`、`linux-x64`、`linux-arm64`、`linux-x64-musl`、`linux-arm64-musl`、`win32-x64`、および `win32-arm64` 用に公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。[システム要件](/ja/setup#system-requirements)を参照してください。{/* min-version: 2.1.205 */}FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。

785* **企業 npm ミラーがプラットフォームパッケージを欠いています。** レジストリがメタパッケージに加えて 8 つすべての `@anthropic-ai/claude-code-*` プラットフォームパッケージをミラーしていることを確認してください。788* **企業 npm ミラーがプラットフォームパッケージを欠いています。** レジストリがメタパッケージに加えて 8 つすべての `@anthropic-ai/claude-code-*` プラットフォームパッケージをミラーしていることを確認してください。

786 789 

787`--ignore-scripts` でインストールしてもこのエラーはトリガーされません。バイナリを所定の位置にリンクする postinstall ステップはスキップされるため、Claude Code はプラットフォームバイナリを各起動時に検索して生成するラッパーにフォールバックします。これは機能しますが、より遅く開始します。スクリプトを有効にして再インストールして、直接実行してください。790`--ignore-scripts` でインストールしてもこのエラーはトリガーされません。バイナリを所定の位置にリンクする postinstall ステップはスキップされるため、Claude Code はプラットフォームバイナリを各起動時に検索して生成するラッパーにフォールバックします。これは機能しますが、より遅く開始します。スクリプトを有効にして再インストールして、直接実行してください。


876 879 

877macOS では、Keychain がロックされているか、パスワードがアカウントパスワードと同期していない場合、ログインが失敗する可能性があります。これにより、Claude Code が認証情報を保存できなくなります。`claude doctor` を実行して Keychain アクセスを確認してください。Keychain を手動でロック解除するには、`security unlock-keychain ~/Library/Keychains/login.keychain-db` を実行してください。ロック解除が役に立たない場合は、Keychain Access を開き、`login` キーチェーンを選択して、編集 > キーチェーン「login」のパスワードを変更を選択して、アカウントパスワードと再同期してください。880macOS では、Keychain がロックされているか、パスワードがアカウントパスワードと同期していない場合、ログインが失敗する可能性があります。これにより、Claude Code が認証情報を保存できなくなります。`claude doctor` を実行して Keychain アクセスを確認してください。Keychain を手動でロック解除するには、`security unlock-keychain ~/Library/Keychains/login.keychain-db` を実行してください。ロック解除が役に立たない場合は、Keychain Access を開き、`login` キーチェーンを選択して、編集 > キーチェーン「login」のパスワードを変更を選択して、アカウントパスワードと再同期してください。

878 881 

879<h3 id="bedrock-vertex-or-foundry-credentials-not-loading">882<h3 id="bedrock-agent-platform-or-foundry-credentials-not-loading">

880 Bedrock、Vertex、または Foundry 認証情報が読み込まれない883 Bedrock、Agent Platform、または Foundry 認証情報が読み込まれない

881</h3>884</h3>

882 885 

883Claude Code をクラウドプロバイダーを使用するように設定し、Bedrock で `Could not load credentials from any providers`、Vertex で `Could not load the default credentials`、または Foundry で `ChainedTokenCredential authentication failed` が表示される場合、クラウドプロバイダー CLI は現在のシェルで認証されていない可能性があります。886Claude Code をクラウドプロバイダーを使用するように設定し、Amazon Bedrock で `Could not load credentials from any providers`、Google Cloud の Agent Platform で `Could not load the default credentials`、または Microsoft Foundry で `ChainedTokenCredential authentication failed` が表示される場合、クラウドプロバイダー CLI は現在のシェルで認証されていない可能性があります。

884 887 

885Bedrock の場合、AWS 認証情報が有効であることを確認してください:888Amazon Bedrock の場合、AWS 認証情報が有効であることを確認してください:

886 889 

887```bash theme={null}890```bash theme={null}

888aws sts get-caller-identity891aws sts get-caller-identity

889```892```

890 893 

891Vertex AI の場合、`ANTHROPIC_VERTEX_PROJECT_ID` と `CLOUD_ML_REGION` がシェルに設定されていることを確認してから、アプリケーションのデフォルト認証情報を設定してください:894Google Cloud の Agent Platform の場合、`ANTHROPIC_VERTEX_PROJECT_ID` と `CLOUD_ML_REGION` がシェルに設定されていることを確認してから、アプリケーションのデフォルト認証情報を設定してください:

892 895 

893```bash theme={null}896```bash theme={null}

894gcloud auth application-default login897gcloud auth application-default login


902 905 

903認証情報がターミナルで機能するが VS Code または JetBrains 拡張機能では機能しない場合、IDE プロセスはおそらくシェル環境を継承していません。IDE 独自の設定でプロバイダー環境変数を設定するか、既にエクスポートされているターミナルから IDE を起動してください。906認証情報がターミナルで機能するが VS Code または JetBrains 拡張機能では機能しない場合、IDE プロセスはおそらくシェル環境を継承していません。IDE 独自の設定でプロバイダー環境変数を設定するか、既にエクスポートされているターミナルから IDE を起動してください。

904 907 

905完全なプロバイダーセットアップについては、[Amazon Bedrock](/ja/amazon-bedrock)、[Google Vertex AI](/ja/google-vertex-ai)、または [Microsoft Foundry](/ja/microsoft-foundry) を参照してください。908完全なプロバイダーセットアップについては、[Amazon Bedrock](/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/ja/google-vertex-ai)、または [Microsoft Foundry](/ja/microsoft-foundry) を参照してください。

906 909 

907<h2 id="still-stuck">910<h2 id="still-stuck">

908 まだ立ち往生している911 まだ立ち往生している

Details

9このページでは、Claude Code が実行中のパフォーマンス、安定性、検索の問題について説明します。その他の問題については、問題が発生している場所に一致するページから始めてください:9このページでは、Claude Code が実行中のパフォーマンス、安定性、検索の問題について説明します。その他の問題については、問題が発生している場所に一致するページから始めてください:

10 10 

11| 症状 | 移動先 |11| 症状 | 移動先 |

12| :------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------- |12| :-------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------- |

13| `command not found`、インストール失敗、PATH の問題、`EACCES`、TLS エラー | [インストールとログインのトラブルシューティング](/ja/troubleshoot-install) |13| `command not found`、インストール失敗、PATH の問題、`EACCES`、TLS エラー | [インストールとログインのトラブルシューティング](/ja/troubleshoot-install) |

14| ログインループ、OAuth エラー、`403 Forbidden`、「organization disabled」、Bedrock/Vertex/Foundry 認証情報 | [インストールとログインのトラブルシューティング](/ja/troubleshoot-install#login-and-authentication) |14| 更新またはインストールダウンロードが `The connection dropped while downloading the update` または `aborted` で失敗する | [エラーリファレンス](/ja/errors#the-connection-dropped-while-downloading-the-update) |

15| ログインループ、OAuth エラー、`403 Forbidden`、「organization disabled」、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 認証情報 | [インストールとログインのトラブルシューティング](/ja/troubleshoot-install#login-and-authentication) |

15| 設定が適用されない、hooks が実行されない、MCP サーバーがロードされない | [設定をデバッグする](/ja/debug-your-config) |16| 設定が適用されない、hooks が実行されない、MCP サーバーがロードされない | [設定をデバッグする](/ja/debug-your-config) |

16| `API Error: 5xx`、`529 Overloaded`、`429`、リクエスト検証エラー | [エラーリファレンス](/ja/errors) |17| `API Error: 5xx`、`529 Overloaded`、`429`、リクエスト検証エラー | [エラーリファレンス](/ja/errors) |

17| `model not found` または `you may not have access to it` | [エラーリファレンス](/ja/errors#there%E2%80%99s-an-issue-with-the-selected-model) |18| `model not found` または `you may not have access to it` | [エラーリファレンス](/ja/errors#there%E2%80%99s-an-issue-with-the-selected-model) |


19| JetBrains プラグインまたは IDE が検出されない | [JetBrains 統合](/ja/jetbrains#troubleshooting) |20| JetBrains プラグインまたは IDE が検出されない | [JetBrains 統合](/ja/jetbrains#troubleshooting) |

20| CPU またはメモリ使用量が多い、応答が遅い、ハング、検索がファイルを見つけられない | [パフォーマンスと安定性](#performance-and-stability)(下記) |21| CPU またはメモリ使用量が多い、応答が遅い、ハング、検索がファイルを見つけられない | [パフォーマンスと安定性](#performance-and-stability)(下記) |

21 22 

22どれが当てはまるかわからない場合は、Claude Code 内で `/doctor` を実行して、インストール、設定、MCP サーバー、コンテキスト使用量の自動チェックを実行してください。`claude` がまったく起動しない場合は、代わりにシェルから `claude doctor` を実行してください。23どれが当てはまるかわからない場合は、Claude Code 内で `/doctor` を実行して、インストール、設定、拡張機能、コンテキスト使用量の自動チェックを実行してください。確認後に適用できる修正を提案します。`claude` がまったく起動しない場合は、代わりにシェルから `claude doctor` を実行してください。MCP サーバーのステータスを確認するには `/mcp` を実行してください。

23 24 

24<h2 id="performance-and-stability">25<h2 id="performance-and-stability">

25 パフォーマンスと安定性26 パフォーマンスと安定性


119[WSL でファイルシステム間で作業する場合](https://learn.microsoft.com/en-us/windows/wsl/filesystems)のディスク読み取りパフォーマンスペナルティにより、WSL で Claude Code を使用する場合、Search ツール使用時に予想より少ないマッチが返される可能性があります。検索は機能しますが、ネイティブファイルシステムより少ない結果を返します。120[WSL でファイルシステム間で作業する場合](https://learn.microsoft.com/en-us/windows/wsl/filesystems)のディスク読み取りパフォーマンスペナルティにより、WSL で Claude Code を使用する場合、Search ツール使用時に予想より少ないマッチが返される可能性があります。検索は機能しますが、ネイティブファイルシステムより少ない結果を返します。

120 121 

121<Note>122<Note>

122 この場合、`/doctor` Search を OK として表示します。123 `claude doctor` はこの場合、Search を OK として表示します。

123</Note>124</Note>

124 125 

125**解決策:**126**解決策:**


136 137 

137ここで説明されていない問題が発生している場合:138ここで説明されていない問題が発生している場合:

138 139 

1391. `/doctor` を実行して、インストール状態、設定の有効性、MCP 設定、コンテキスト使用量を一度にチェックします1401. `/doctor` を実行してセットアップをチェックし`/mcp` を実行して MCP サーバーのステータスを確認します

1402. Claude Code 内で `/feedback` コマンドを使用して、Anthropic に問題を直接報告します1412. Claude Code 内で `/feedback` コマンドを使用して、Anthropic に問題を直接報告します

1413. [GitHub リポジトリ](https://github.com/anthropics/claude-code)で既知の問題を確認します1423. [GitHub リポジトリ](https://github.com/anthropics/claude-code)で既知の問題を確認します

1424. Claude に直接その機能と機能について質問します。Claude はドキュメントへの組み込みアクセスを持っています。1434. Claude に直接その機能と機能について質問します。Claude はドキュメントへの組み込みアクセスを持っています。

ultraplan.md +1 −1

Details

18* **ハンズオフ下書き**: 計画はリモートで生成されるため、ターミナルは他の作業に使用できます18* **ハンズオフ下書き**: 計画はリモートで生成されるため、ターミナルは他の作業に使用できます

19* **柔軟な実行**: ウェブで実行するプルリクエストを承認するか、ターミナルに送り返すことができます19* **柔軟な実行**: ウェブで実行するプルリクエストを承認するか、ターミナルに送り返すことができます

20 20 

21Ultraplan には、[ウェブ上の Claude Code](/ja/claude-code-on-the-web) アカウントと GitHub リポジトリが必要です。Anthropic のクラウドインフラストラクチャで実行されるため、Amazon Bedrock、Google Cloud Vertex AI、または Microsoft Foundry を使用している場合は利用できません。クラウドセッションは、アカウントのデフォルト[クラウド環境](/ja/claude-code-on-the-web#the-cloud-environment)で実行されます。クラウド環境がまだない場合、ultraplan は初回起動時に自動的に作成します。21Ultraplan には、[ウェブ上の Claude Code](/ja/claude-code-on-the-web) アカウントと GitHub リポジトリが必要です。Anthropic のクラウドインフラストラクチャで実行されるため、Amazon Bedrock、Google Cloud Agent Platform、または Microsoft Foundry を使用している場合は利用できません。クラウドセッションは、アカウントのデフォルト[クラウド環境](/ja/claude-code-on-the-web#the-cloud-environment)で実行されます。クラウド環境がまだない場合、ultraplan は初回起動時に自動的に作成します。

22 22 

23<h2 id="launch-ultraplan-from-the-cli">23<h2 id="launch-ultraplan-from-the-cli">

24 CLI から ultraplan を起動する24 CLI から ultraplan を起動する

ultrareview.md +4 −4

Details

15ローカルの `/code-review` または `/review` と比較して、ultrareview は以下を提供します。15ローカルの `/code-review` または `/review` と比較して、ultrareview は以下を提供します。

16 16 

17* **より高いシグナル**: 報告されたすべての検出結果は独立して再現および検証されるため、結果はスタイル提案ではなく実際のバグに焦点を当てています17* **より高いシグナル**: 報告されたすべての検出結果は独立して再現および検証されるため、結果はスタイル提案ではなく実際のバグに焦点を当てています

18* **より広いカバレッジ**: より大規模なレビュアーエージェントのフリートが並行して変更を探索するため、中程度の労力のローカルレビューでは見落とされる可能性のある問題が浮かび上がります18* **より広いカバレッジ**: より大規模なレビュアーエージェントのフリートが並行して変更を探索するため、ローカルレビューでは見落とされる可能性のある問題が浮かび上がります

19* **ローカルリソースの使用なし**: レビューはリモートサンドボックスで完全に実行されるため、実行中はターミナルが他の作業に使用可能なままです19* **ローカルリソースの使用なし**: レビューはリモートサンドボックスで完全に実行されるため、実行中はターミナルが他の作業に使用可能なままです

20 20 

21Ultrareview は Claude Code のウェブインフラストラクチャ上で実行されるため、Claude.ai アカウントでの認証が必要です。API キーのみで署名している場合は、`/login` を実行して Claude.ai で認証してください。Ultrareview は Amazon Bedrock、Google Cloud Vertex AI、または Microsoft Foundry で Claude Code を使用する場合は利用できず、Zero Data Retention を有効にしている組織でも利用できません。21Ultrareview は Claude Code のウェブインフラストラクチャ上で実行されるため、Claude.ai アカウントでの認証が必要です。API キーのみで署名している場合は、`/login` を実行して Claude.ai で認証してください。Ultrareview は Amazon Bedrock、Google Cloud Agent Platform、または Microsoft Foundry で Claude Code を使用する場合は利用できず、Zero Data Retention を有効にしている組織でも利用できません。

22 22 

23<h2 id="run-ultrareview-from-the-cli">23<h2 id="run-ultrareview-from-the-cli">

24 CLI から ultrareview を実行する24 CLI から ultrareview を実行する


107| ----- | -------------- | ------------------------ | ----------------------------- |107| ----- | -------------- | ------------------------ | ----------------------------- |

108| ターゲット | 作業中の diff | GitHub プルリクエスト | 作業中の diff またはプルリクエスト |108| ターゲット | 作業中の diff | GitHub プルリクエスト | 作業中の diff またはプルリクエスト |

109| 実行場所 | セッション内でローカルに実行 | セッション内でローカルに実行 | クラウドサンドボックスでリモートに実行 |109| 実行場所 | セッション内でローカルに実行 | セッション内でローカルに実行 | クラウドサンドボックスでリモートに実行 |

110| 深さ | effort 引数でスケール | 中程度の `/code-review` エンジン | 独立した検証を備えた複数エージェントフリート |110| 深さ | effort 引数でスケール | セッションの effort での単一パスレビュー | 独立した検証を備えた複数エージェントフリート |

111| 期間 | 数秒から数分 | 数分 | 約 5 ~ 10 分 |111| 期間 | 数秒から数分 | 数秒から数分 | 約 5 ~ 10 分 |

112| コスト | 通常の使用量にカウント | 通常の使用量にカウント | 無料実行回数、その後追加使用量として約 5 ~ 20 ドル |112| コスト | 通常の使用量にカウント | 通常の使用量にカウント | 無料実行回数、その後追加使用量として約 5 ~ 20 ドル |

113| 最適な用途 | 反復中の迅速なフィードバック | マージ前にチームメイトの PR をレビュー | 実質的な変更のマージ前の信頼度 |113| 最適な用途 | 反復中の迅速なフィードバック | マージ前にチームメイトの PR をレビュー | 実質的な変更のマージ前の信頼度 |

114 114 

Details

20 20 

21音声ディクテーションは、記録された音声を Anthropic のサーバーにストリーミングして文字起こしします。音声はローカルで処理されません。以下のすべてが必要です。21音声ディクテーションは、記録された音声を Anthropic のサーバーにストリーミングして文字起こしします。音声はローカルで処理されません。以下のすべてが必要です。

22 22 

23* **Claude.ai アカウント**:音声テキスト変換サービスは Claude.ai アカウントで認証した場合にのみ利用可能であり、Claude Code が Anthropic API キー、Amazon Bedrock、Google Vertex AI、または Microsoft Foundry を直接使用するように設定されている場合は利用できません。23* **Claude.ai アカウント**:音声テキスト変換サービスは Claude.ai アカウントで認証した場合にのみ利用可能であり、Claude Code が Anthropic API キー、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を直接使用するように設定されている場合は利用できません。

24* **HIPAA コンプライアンスが有効になっていない組織**:この制限が適用される場合、`/voice` は「Voice mode is disabled by your organization's policy」と表示されます。24* **HIPAA コンプライアンスが有効になっていない組織**:この制限が適用される場合、`/voice` は「Voice mode is disabled by your organization's policy」と表示されます。

25* **ローカルマイク**:音声ディクテーションは [Web 上の Claude Code](/ja/claude-code-on-the-web)や SSH セッションなどのリモート環境では機能しません。25* **ローカルマイク**:音声ディクテーションは [Web 上の Claude Code](/ja/claude-code-on-the-web)や SSH セッションなどのリモート環境では機能しません。

26* **WSL で Claude Code を実行する場合は WSLg**:WSLg は Windows 10 または 11 の Microsoft Store からインストールされた WSL2 に含まれています。WSLg が利用できない場合(例えば WSL1 など)は、代わりにネイティブ Windows で Claude Code を実行してください。26* **WSL で Claude Code を実行する場合は WSLg**:WSLg は Windows 10 または 11 の Microsoft Store からインストールされた WSL2 に含まれています。WSLg が利用できない場合(例えば WSL1 など)は、代わりにネイティブ Windows で Claude Code を実行してください。


183* **Linux で `No audio recording tool found`**: ネイティブ オーディオ モジュールが読み込めず、フォールバックがインストールされていません。エラー メッセージに表示されているコマンド(例:`sudo apt-get install sox`)で SoX をインストールしてください。183* **Linux で `No audio recording tool found`**: ネイティブ オーディオ モジュールが読み込めず、フォールバックがインストールされていません。エラー メッセージに表示されているコマンド(例:`sudo apt-get install sox`)で SoX をインストールしてください。

184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX はインストールされていますが、ホストにはオーディオ キャプチャ デバイスがありません。例えば、ヘッドレス サーバーまたはコンテナです。マイクを備えたマシンで Claude Code を実行してください。{/* min-version: 2.1.195 */}v2.1.195 以降、Linux 上の Claude Code はこの状況でこのメッセージを報告します。以前のバージョンでは、SoX が既にインストールされていても、インストールするよう求めていました。184* **`Voice mode requires a microphone, but SoX could not open an audio capture device`**: SoX はインストールされていますが、ホストにはオーディオ キャプチャ デバイスがありません。例えば、ヘッドレス サーバーまたはコンテナです。マイクを備えたマシンで Claude Code を実行してください。{/* min-version: 2.1.195 */}v2.1.195 以降、Linux 上の Claude Code はこの状況でこのメッセージを報告します。以前のバージョンでは、SoX が既にインストールされていても、インストールするよう求めていました。

185* **`Voice mode could not find a working audio recorder in WSL`**: WSLg は PulseAudio ではなく ALSA デバイスを経由してオーディオをルーティングするため、SoX は PulseAudio バックエンドを明示的にインストールする必要があります。`sudo apt install sox libsox-fmt-pulse` を実行してください。`sox` だけをインストールすると ALSA バックエンドが引き込まれますが、WSL には `/dev/snd` デバイスがないため、WSL で記録することはできません。185* **`Voice mode could not find a working audio recorder in WSL`**: WSLg は PulseAudio ではなく ALSA デバイスを経由してオーディオをルーティングするため、SoX は PulseAudio バックエンドを明示的にインストールする必要があります。`sudo apt install sox libsox-fmt-pulse` を実行してください。`sox` だけをインストールすると ALSA バックエンドが引き込まれますが、WSL には `/dev/snd` デバイスがないため、WSL で記録することはできません。

186* **`Voice input is failing repeatedly and has been paused`**: 音声ディクテーションが複数回の起動失敗に遭遇し、1 つが成功するまで新しいセッションの試行を停止しました。これは通常、このホストのマイクまたはオーディオ スタックがオーディオをキャプチャできないことを意味します。例えば、ヘッドレス サーバー、オーディオ パススルーのないリモート シェル、またはマイク権限が拒否されている場合です。動作する入力デバイスを確認し、上記のエントリから根本原因を修正してから、音声を再度トリガーしてください。186* **`Voice input is failing repeatedly and has been paused`**: 音声ディクテーションが複数回の起動失敗に遭遇し、1 つが成功するまで新しいセッションの試行を停止しました。失敗はマイクの起動に失敗したか、レコーダーが起動してからオーディオを生成せずに停止したかどうかに関係なくカウントされます。これは通常、このホストのマイクまたはオーディオ スタックがオーディオをキャプチャできないことを意味します。例えば、ヘッドレス サーバー、オーディオ パススルーのないリモート シェル、またはマイク権限が拒否されている場合です。動作する入力デバイスを確認し、上記のエントリから根本原因を修正してから、音声を再度トリガーしてください。{/* min-version: 2.1.202 */}v2.1.202 より前は、起動失敗のみが一時停止にカウントされていました。

187* **長押しモードで `Space` を長押ししても何も起こらない**: プロンプト入力を監視しながら長押ししてください。スペースが蓄積し続ける場合、音声ディクテーションはおそらくオフです。`/voice hold` を実行して有効にしてください。1 つまたは 2 つのスペースだけが表示されて何も起こらない場合、音声ディクテーションはオンですが、長押し検出がトリガーされていません。長押し検出はターミナルがキー リピート イベントを送信することが必要なため、OS レベルでキー リピートが無効になっている場合、押されたキーを検出できません。`/voice tap` でタップモードに切り替えて、キー リピート要件を回避してください。187* **長押しモードで `Space` を長押ししても何も起こらない**: プロンプト入力を監視しながら長押ししてください。スペースが蓄積し続ける場合、音声ディクテーションはおそらくオフです。`/voice hold` を実行して有効にしてください。1 つまたは 2 つのスペースだけが表示されて何も起こらない場合、音声ディクテーションはオンですが、長押し検出がトリガーされていません。長押し検出はターミナルがキー リピート イベントを送信することが必要なため、OS レベルでキー リピートが無効になっている場合、押されたキーを検出できません。`/voice tap` でタップモードに切り替えて、キー リピート要件を回避してください。

188* **タップモードで `Space` をタップするとスペースが入力される代わりに記録される**: 最初のタップはプロンプト入力が空の場合にのみ録音を開始します。入力を最初にクリアするか、`/voice tap` を実行してタップモードであることを確認してください。188* **タップモードで `Space` をタップするとスペースが入力される代わりに記録される**: 最初のタップはプロンプト入力が空の場合にのみ録音を開始します。入力を最初にクリアするか、`/voice tap` を実行してタップモードであることを確認してください。

189* **`No audio detected from microphone`**: 録音が開始されましたが、無音がキャプチャされました。正しい入力デバイスがシステム デフォルトとして設定されており、その入力レベルがミュートされていないか、ゼロに近くないことを確認してください。Windows では、\[設定] → \[システム] → \[サウンド] → \[入力]を開き、マイクを選択してください。macOS では、\[システム設定] → \[サウンド] → \[入力]を開いてください。189* **`No audio detected from microphone`**: 録音が開始されましたが、無音がキャプチャされました。正しい入力デバイスがシステム デフォルトとして設定されており、その入力レベルがミュートされていないか、ゼロに近くないことを確認してください。Windows では、\[設定] → \[システム] → \[サウンド] → \[入力]を開き、マイクを選択してください。macOS では、\[システム設定] → \[サウンド] → \[入力]を開いてください。

190* **`Voice connection failed`**: 接続に失敗したため、記録が文字起こしサービスに到達しませんでした。ネットワークを確認して、もう一度試してください。{/* min-version: 2.1.200 */}オーディオをキャプチャしない記録は、このメッセージの代わりに `No audio detected from microphone` を報告します。v2.1.200 より前は、無音マイクは接続失敗を報告する可能性があり、実際の問題が入力デバイスであるのに、ネットワーク問題を示唆していました。

190* **`No speech detected`**: オーディオは文字起こしサービスに到達しましたが、単語は認識されませんでした。マイクに近づいて話し、背景ノイズを減らし、[ディクテーション言語](#change-the-dictation-language)が話している言語と一致することを確認してください。191* **`No speech detected`**: オーディオは文字起こしサービスに到達しましたが、単語は認識されませんでした。マイクに近づいて話し、背景ノイズを減らし、[ディクテーション言語](#change-the-dictation-language)が話している言語と一致することを確認してください。

191* **文字起こしが乱れているか、間違った言語である**: ディクテーションはデフォルトで英語です。別の言語でディクテーションしている場合は、最初に `/config` で設定してください。[ディクテーション言語を変更する](#change-the-dictation-language)を参照してください。192* **文字起こしが乱れているか、間違った言語である**: ディクテーションはデフォルトで英語です。別の言語でディクテーションしている場合は、最初に `/config` で設定してください。[ディクテーション言語を変更する](#change-the-dictation-language)を参照してください。

192 193 

vs-code.md +11 −7

Details

19インストール前に、以下があることを確認してください。19インストール前に、以下があることを確認してください。

20 20 

21* VS Code 1.98.0 以上21* VS Code 1.98.0 以上

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)を参照してください。22* Anthropic アカウント:任意の有料 Claude サブスクリプション(Pro、Max、Team、または Enterprise)または Claude Console アカウントが機能し、API キーは不要です。拡張機能を初めて開くときに、このアカウントで[サインイン](/ja/authentication#log-in-to-claude-code)します。Amazon Bedrock や Google Cloud Agent Platform などのサードパーティプロバイダーを通じて Claude にアクセスする場合は、セットアップ手順について[サードパーティプロバイダーを使用する](#use-third-party-providers)を参照してください。

23 23 

24<Tip>24<Tip>

25 拡張機能には、チャットパネル用の CLI(コマンドラインインターフェース)の独自コピーが含まれています。VS Code の統合ターミナルで `claude` を実行するには、[スタンドアロン CLI インストール](/ja/setup)も必要です。詳細については、[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)を参照してください。


102 102 

103プロンプトボックスは複数の機能をサポートしています。103プロンプトボックスは複数の機能をサポートしています。

104 104 

105* **許可モード**:プロンプトボックスの下部のモード指示器をクリックしてモードを切り替えます。通常モードでは、Claude は各アクション前に許可を求めます。Plan モードでは、Claude は実行内容を説明し、変更を加える前に承認を待ちます。VS Code は自動的にプランをフルマークダウンドキュメントとして開き、Claude が開始する前にフィードバックを提供するためのインラインコメントを追加できます。自動受け入れモードではClaude は許可を求めずに編集を行います。VS Code 設定の `claudeCode.initialPermissionMode` でデフォルトを設定します。105* **権限モード**:プロンプトボックスの下部のモード指示器をクリックしてモードを切り替えるか、VS Code 設定の `claudeCode.initialPermissionMode` でデフォルトを設定します。指示器が提供するすべてのモードについては、[権限モード](/ja/permission-modes#switch-permission-modes)を参照してください。

106 * **Manual**:Claude は各アクション前に許可を求めます。

107 * **Plan**:Claude は実行内容を説明し、変更を加える前に承認を待ちます。VS Code は自動的にプランをフル Markdown ドキュメントとして開き、Claude が開始する前にフィードバックを提供するためのインラインコメントを追加できます。

108 * **Edit automatically**:Claude は許可を求めずに編集を行います。

106* **コマンドメニュー**:`/` をクリックするか `/` と入力してコマンドメニューを開きます。オプションには、ファイルの添付、モデルの切り替え、拡張思考の切り替え、プラン使用状況の表示(`/usage`)、および [Remote Control](/ja/remote-control) セッションの開始(`/remote-control`)が含まれます。カスタマイズセクションは、MCP サーバー、hooks、メモリ、権限、プラグインへのアクセスを提供します。ターミナルアイコン付きのアイテムは統合ターミナルで開きます。109* **コマンドメニュー**:`/` をクリックするか `/` と入力してコマンドメニューを開きます。オプションには、ファイルの添付、モデルの切り替え、拡張思考の切り替え、プラン使用状況の表示(`/usage`)、および [Remote Control](/ja/remote-control) セッションの開始(`/remote-control`)が含まれます。カスタマイズセクションは、MCP サーバー、hooks、メモリ、権限、プラグインへのアクセスを提供します。ターミナルアイコン付きのアイテムは統合ターミナルで開きます。

110 * {/* min-version: 2.1.203 */}設定セクションには **Enable Remote Control for all sessions** が含まれており、これは [`remoteControlAtStartup`](/ja/settings#available-settings) を設定して、[すべての新しいインタラクティブセッションが Remote Control に自動的に接続](/ja/remote-control#enable-remote-control-for-all-sessions)されるようにします。Claude Code v2.1.203 以降が必要です。

107* **コンテキスト指示器**:プロンプトボックスは、Claude のコンテキストウィンドウをどの程度使用しているかを表示します。Claude は必要に応じて自動的にコンパクト化するか、`/compact` を手動で実行できます。111* **コンテキスト指示器**:プロンプトボックスは、Claude のコンテキストウィンドウをどの程度使用しているかを表示します。Claude は必要に応じて自動的にコンパクト化するか、`/compact` を手動で実行できます。

108* **拡張思考**:Claude が複雑な問題を推論するためにより多くの時間を費やすことができます。コマンドメニュー(`/`)を使用してオンに切り替えます。Claude の推論は会話に折りたたまれたブロックとして表示されます。ブロックをクリックして読むか、`Ctrl+O` を押してセッション内のすべての思考ブロックを展開または折りたたみます。詳細については、[拡張思考](/ja/model-config#extended-thinking)を参照してください。112* **拡張思考**:Claude が複雑な問題を推論するためにより多くの時間を費やすことができます。コマンドメニュー(`/`)を使用してオンに切り替えます。Claude の推論は会話に折りたたまれたブロックとして表示されます。ブロックをクリックして読むか、`Ctrl+O` を押してセッション内のすべての思考ブロックを展開または折りたたみます。詳細については、[拡張思考](/ja/model-config#extended-thinking)を参照してください。

109* **複数行入力**:`Shift+Enter` を押して送信せずに新しい行を追加します。これは質問ダイアログの'その他'フリーテキスト入力でも機能します。113* **複数行入力**:`Shift+Enter` を押して送信せずに新しい行を追加します。これは質問ダイアログのその他フリーテキスト入力でも機能します。

110 114 

111<h3 id="reference-files-and-folders">115<h3 id="reference-files-and-folders">

112 ファイルとフォルダを参照する116 ファイルとフォルダを参照する


356</h3>360</h3>

357 361 

358| 設定 | デフォルト | 説明 |362| 設定 | デフォルト | 説明 |

359| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------ |363| ----------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

360| `useTerminal` | `false` | グラフィカルパネルの代わりにターミナルモードで Claude を起動します。 |364| `useTerminal` | `false` | グラフィカルパネルの代わりにターミナルモードで Claude を起動します。 |

361| `initialPermissionMode` | `default` | 新しい会話の承認プロンプトを制御します。`default`、`plan`、`acceptEdits`、または `bypassPermissions`。[permission modes](/ja/permission-modes) を参照してください。 |365| `initialPermissionMode` | `default` | 新しい会話の承認プロンプトを制御します。`default`、`plan`、`acceptEdits`、または `bypassPermissions`。{/* min-version: 2.1.200 */}`manual` は `default` のエイリアスであり、モード表示器で **Manual** というラベルが付いたモードを選択します。Claude Code v2.1.200 以降が必要です。[permission modes](/ja/permission-modes) を参照してください。 |

362| `preferredLocation` | `panel` | Claude が開く場所:`sidebar`(右)または `panel`(新しいタブ) |366| `preferredLocation` | `panel` | Claude が開く場所:`sidebar`(右)または `panel`(新しいタブ) |

363| `autosave` | `true` | Claude が読み取りまたは書き込みする前にファイルを自動保存します。 |367| `autosave` | `true` | Claude が読み取りまたは書き込みする前にファイルを自動保存します。 |

364| `useCtrlEnterToSend` | `false` | Enter の代わりに Ctrl/Cmd+Enter を使用してプロンプトを送信します。 |368| `useCtrlEnterToSend` | `false` | Enter の代わりに Ctrl/Cmd+Enter を使用してプロンプトを送信します。 |


479 サードパーティプロバイダーを使用する483 サードパーティプロバイダーを使用する

480</h2>484</h2>

481 485 

482デフォルトでは、Claude Code は Anthropic の API に直接接続します。組織が Amazon Bedrock、Google Vertex AI、または Microsoft Foundry を使用して Claude にアクセスする場合は、代わりにプロバイダーを使用するように拡張機能を設定します486デフォルトでは、Claude Code は Anthropic の API に直接接続します。組織が Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry を使用して Claude にアクセスする場合は、代わりにプロバイダーを使用するように拡張機能を設定してください

483 487 

484<Steps>488<Steps>

485 <Step title="ログインプロンプトを無効にする">489 <Step title="ログインプロンプトを無効にする">


492 プロバイダーのセットアップガイドに従います。496 プロバイダーのセットアップガイドに従います。

493 497 

494 * [Claude Code on Amazon Bedrock](/ja/amazon-bedrock)498 * [Claude Code on Amazon Bedrock](/ja/amazon-bedrock)

495 * [Claude Code on Google Vertex AI](/ja/google-vertex-ai)499 * [Claude Code on Google Cloud's Agent Platform](/ja/google-vertex-ai)

496 * [Claude Code on Microsoft Foundry](/ja/microsoft-foundry)500 * [Claude Code on Microsoft Foundry](/ja/microsoft-foundry)

497 501 

498 これらのガイドは、`~/.claude/settings.json` でプロバイダーを設定することをカバーしており、VS Code 拡張機能と CLI 間で設定が共有されることを保証します。502 これらのガイドは、`~/.claude/settings.json` でプロバイダーを設定することをカバーしており、VS Code 拡張機能と CLI 間で設定が共有されることを保証します。

Details

43Claude Code はどこでも同じように動作します。変わるのは、コードが実行される場所とローカル設定が利用可能かどうかです。Desktop app は local と cloud の両方のセッションを提供するため、以下の回答はどちらを選択するかによって異なります:43Claude Code はどこでも同じように動作します。変わるのは、コードが実行される場所とローカル設定が利用可能かどうかです。Desktop app は local と cloud の両方のセッションを提供するため、以下の回答はどちらを選択するかによって異なります:

44 44 

45| | On the web | Remote Control | Terminal CLI | Desktop app |45| | On the web | Remote Control | Terminal CLI | Desktop app |

46| :------------------------------------------- | :-------------------------------------------------------------------------------------------------------------- | :--------------------------- | :--------------------- | :-------------------------- |46| :------------------------------------------- | :------------------------------------------------------------------------------------------------------------- | :------------------------- | :--------------------- | :-------------------------- |

47| **Code runs on** | Anthropic cloud VM | Your machine | Your machine | Your machine or cloud VM |47| **Code runs on** | Anthropic cloud VM | Your machine | Your machine | Your machine or cloud VM |

48| **You chat from** | claude.ai or mobile app | claude.ai or mobile app | Your terminal | The Desktop UI |48| **You chat from** | claude.ai or mobile app | claude.ai or mobile app | Your terminal | The Desktop UI |

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 `--cloud` | 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)** | Accept edits, Plan, Auto | Ask, Auto accept edits, Plan | All modes | Depends on session type |52| **[Permission modes](/ja/permission-modes)** | Accept edits, Plan, Auto | Manual, 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) ドキュメントを参照して、それらをセットアップしてください。


113 /web-setup113 /web-setup

114 ```114 ```

115 115 

116 これにより、`gh` トークンが Claude アカウントに同期されます。cloud 環境がまだない場合、`/web-setup` は Trusted ネットワークアクセスと setup script なしで環境を作成します。後で [環境を編集したり、変数を追加](/ja/claude-code-on-the-web#configure-your-environment) できます。`/web-setup` が完了したら、[`--remote`](/ja/claude-code-on-the-web#from-terminal-to-web) でターミナルから cloud セッションを開始するか、[`/schedule`](/ja/routines) で定期的なタスクをセットアップできます。116 これにより、`gh` トークンが Claude アカウントに同期されます。cloud 環境がまだない場合、`/web-setup` は Trusted ネットワークアクセスと setup script なしで環境を作成します。後で [環境を編集したり、変数を追加](/ja/claude-code-on-the-web#configure-your-environment) できます。`/web-setup` が完了したら、[`--cloud`](/ja/claude-code-on-the-web#from-terminal-to-web) でターミナルから cloud セッションを開始するか、[`/schedule`](/ja/routines) で定期的なタスクをセットアップできます。

117 </Step>117 </Step>

118</Steps>118</Steps>

119 119 


128 [claude.ai/code](https://claude.ai/code) または Claude モバイルアプリの Code タブから、入力ボックスの下のリポジトリセレクターをクリックし、Claude が作業するリポジトリを選択します。各リポジトリはブランチセレクターを表示します。デフォルトの代わりに feature ブランチから Claude を開始するように変更します。複数のリポジトリを追加して、1 つのセッション内で複数のリポジトリで作業できます。128 [claude.ai/code](https://claude.ai/code) または Claude モバイルアプリの Code タブから、入力ボックスの下のリポジトリセレクターをクリックし、Claude が作業するリポジトリを選択します。各リポジトリはブランチセレクターを表示します。デフォルトの代わりに feature ブランチから Claude を開始するように変更します。複数のリポジトリを追加して、1 つのセッション内で複数のリポジトリで作業できます。

129 </Step>129 </Step>

130 130 

131 <Step title="permission mode を選択">131 <Step title="権限モードを選択">

132 入力の横の mode ドロップダウンは、デフォルトで **Accept edits** で、Claude は承認を待たずに変更を加えてブランチをプッシュします。Claude がアプローチを提案し、ファイルを編集する前にあなたの許可を待つようにしたい場合は、**Plan Mode** に切り替えます。Cloud セッションは Ask permissions または Bypass permissions を提供しません完全なリストについては [Permission modes](/ja/permission-modes) を参照してください。132 入力の横の mode ドロップダウンは、デフォルトで **Accept edits** で、Claude は承認を待たずに変更を加えてブランチをプッシュします。Claude がアプローチを提案し、ファイルを編集する前にあなたの許可を待つようにしたい場合は、**Plan Mode** に切り替えます。Cloud セッションは Manual または Bypass 権限を提供しません各権限モードが何を許可するかについては、[権限モードの完全なリスト](/ja/permission-modes#available-modes)を参照してください。

133 </Step>133 </Step>

134 134 

135 <Step title="タスクを説明して送信">135 <Step title="タスクを説明して送信">

136 実行したい内容の説明を入力して Enter キーを押します。具体的にしてください:136 実行したい内容の説明を入力して Enter キーを押します。具体的にしてください:

137 137 

138 * ファイルまたは関数に名前を付けます:'Add a README with setup instructions'または'Fix the failing auth test in `tests/test_auth.py`''fix tests'より良いです138 * ファイルまたは関数に名前を付けます:Add a README with setup instructionsまたはFix the failing auth test in `tests/test_auth.py`fix testsより良いです

139 * エラー出力がある場合は貼り付けます139 * エラー出力がある場合は貼り付けます

140 * 症状だけでなく、期待される動作を説明します140 * 症状だけでなく、期待される動作を説明します

141 141 


216 216 

217Claude Code 内で入力してコマンドメニューが `/web-setup` に対して'No commands match "/web-setup"」を表示するか、送信すると「Unknown command: /web-setup」が返される場合、要件が満たされていないため、コマンドは非表示になっています。原因は通常、CLI が v2.1.80 より古いか、API キーまたはサードパーティプロバイダーではなく claude.ai サブスクリプションで認証されていることです。`claude update` を実行してから `/login` を実行して、claude.ai アカウントでサインインします。217Claude Code 内で入力してコマンドメニューが `/web-setup` に対して'No commands match "/web-setup"」を表示するか、送信すると「Unknown command: /web-setup」が返される場合、要件が満たされていないため、コマンドは非表示になっています。原因は通常、CLI が v2.1.80 より古いか、API キーまたはサードパーティプロバイダーではなく claude.ai サブスクリプションで認証されていることです。`claude update` を実行してから `/login` を実行して、claude.ai アカウントでサインインします。

218 218 

219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-remote-or-ultraplan">219<h3 id="could-not-create-a-cloud-environment-or-no-cloud-environment-available-when-using-cloud-or-ultraplan">

220 `--remote` または ultraplan を使用する場合に「Could not create a cloud environment」または「No cloud environment available」220 `--cloud` または ultraplan を使用する場合に「Could not create a cloud environment」または「No cloud environment available」

221</h3>221</h3>

222 222 

223Remote セッション機能は、cloud 環境がない場合、デフォルトの cloud 環境を自動的に作成します。「Could not create a cloud environment」が表示される場合、自動作成に失敗しました。{/* max-version: 2.1.100 */}「No cloud environment available」が表示される場合、CLI は自動作成より前のものです。どちらの場合でも、Claude Code CLI で `/web-setup` を実行して手動で作成するか、[claude.ai/code](https://claude.ai/code) にアクセスして上記の **Create your environment** ステップに従ってください。223Remote セッション機能は、cloud 環境がない場合、デフォルトの cloud 環境を自動的に作成します。「Could not create a cloud environment」が表示される場合、自動作成に失敗しました。{/* max-version: 2.1.100 */}「No cloud environment available」が表示される場合、CLI は自動作成より前のものです。どちらの場合でも、Claude Code CLI で `/web-setup` を実行して手動で作成するか、[claude.ai/code](https://claude.ai/code) にアクセスして上記の **Create your environment** ステップに従ってください。

whats-new.md +1 −1

Details

33</Update>33</Update>

34 34 

35<Update label="Week 23" description="June 1–5, 2026" tags={["v2.1.158–v2.1.165"]}>35<Update label="Week 23" description="June 1–5, 2026" tags={["v2.1.158–v2.1.165"]}>

36 **Bedrock、Vertex、Foundry での Auto mode**:auto mode は Opus 4.7 および Opus 4.8 のサードパーティプロバイダーで利用可能になり、許可プロンプトをバックグラウンド安全チェックに置き換えます。36 **Amazon Bedrock、Google Cloud の Agent Platformおよび Microsoft Foundry での Auto mode**:auto mode は Opus 4.7 および Opus 4.8 のサードパーティプロバイダーで利用可能になり、許可プロンプトをバックグラウンド安全チェックに置き換えます。

37 37 

38 今週のその他の機能:**より安全な自動編集** は `acceptEdits` モードでコードを実行できるファイルを書き込む前にプロンプトを表示します。**`/plugin list`** はインストール済みプラグインをインラインで出力します。**バージョン要件** により、マネージドデプロイメントは承認された Claude Code バージョン範囲を要求できます。38 今週のその他の機能:**より安全な自動編集** は `acceptEdits` モードでコードを実行できるファイルを書き込む前にプロンプトを表示します。**`/plugin list`** はインストール済みプラグインをインラインで出力します。**バージョン要件** により、マネージドデプロイメントは承認された Claude Code バージョン範囲を要求できます。

39 39 

Details

102 102 

103 <div className="digest-wins-grid">103 <div className="digest-wins-grid">

104 <div>フォーカスビュー:フリッカーなしモードで <code>Ctrl+O</code> を押して、ビューを最後のプロンプト、1 行のツール概要(diffstats 付き)、および Claude の最終応答に折りたたみます</div>104 <div>フォーカスビュー:フリッカーなしモードで <code>Ctrl+O</code> を押して、ビューを最後のプロンプト、1 行のツール概要(diffstats 付き)、および Claude の最終応答に折りたたみます</div>

105 <div>ログイン画面での Bedrock と Vertex AI のガイド付きセットアップウィザード:「3rd-party platform」を選択して、ステップバイステップの認証、リージョン、認証情報チェック、およびモデルピニングを行います</div>105 <div>ログイン画面での Amazon Bedrock と Google Cloud の Agent Platform のガイド付きセットアップウィザード:「3rd-party platform」を選択して、ステップバイステップの認証、リージョン、認証情報チェック、およびモデルピニングを行います</div>

106 <div><code>/agents</code> はタブ付きレイアウトを取得します。「Running」タブは <code>● N running</code> カウント付きのライブサブエージェントを表示し、「Library」タブに「Run agent」と「View running instance」アクションがあります</div>106 <div><code>/agents</code> はタブ付きレイアウトを取得します。「Running」タブは <code>● N running</code> カウント付きのライブサブエージェントを表示し、「Library」タブに「Run agent」と「View running instance」アクションがあります</div>

107 <div>デフォルトの努力レベルは、API キー、Bedrock、Vertex、Foundry、Team、および Enterprise ユーザーの場合は <code>high</code> になりました(<code>/effort</code> で制御)</div>107 <div>デフォルトの努力レベルは、API キー、Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、Team、および Enterprise ユーザーの場合は <code>high</code> になりました(<code>/effort</code> で制御)</div>

108 <div><code>/cost</code> はサブスクリプションユーザーのモデルごとおよびキャッシュヒット分析を表示します</div>108 <div><code>/cost</code> はサブスクリプションユーザーのモデルごとおよびキャッシュヒット分析を表示します</div>

109 <div><code>/release-notes</code> はインタラクティブなバージョンピッカーになりました</div>109 <div><code>/release-notes</code> はインタラクティブなバージョンピッカーになりました</div>

110 <div>ステータスライン:新しい <code>refreshInterval</code> 設定は N 秒ごとにコマンドを再実行し、JSON 入力に <code>workspace.git\_worktree</code> があります</div>110 <div>ステータスライン:新しい <code>refreshInterval</code> 設定は N 秒ごとにコマンドを再実行し、JSON 入力に <code>workspace.git\_worktree</code> があります</div>

Details

123 <div><code>/fewer-permission-prompts</code> はトランスクリプトをスキャンして、一般的な読み取り専用 Bash および MCP 呼び出しを検出し、<code>.claude/settings.json</code> のアローリストを提案します</div>123 <div><code>/fewer-permission-prompts</code> はトランスクリプトをスキャンして、一般的な読み取り専用 Bash および MCP 呼び出しを検出し、<code>.claude/settings.json</code> のアローリストを提案します</div>

124 <div>Claude は、Skill ツールを介して <code>/init</code>、<code>/review</code>、<code>/security-review</code> などの組み込みコマンドを検出して実行できるようになりました</div>124 <div>Claude は、Skill ツールを介して <code>/init</code>、<code>/review</code>、<code>/security-review</code> などの組み込みコマンドを検出して実行できるようになりました</div>

125 <div><code>PreCompact</code> フックは、終了コード 2 で終了するか、<code>{"{"}"decision":"block"{"}"}</code> を返すことでコンパクションをブロックできます</div>125 <div><code>PreCompact</code> フックは、終了コード 2 で終了するか、<code>{"{"}"decision":"block"{"}"}</code> を返すことでコンパクションをブロックできます</div>

126 <div><code>ENABLE\_PROMPT\_CACHING\_1H</code> は API キー、Bedrock、Vertex、および Foundry ユーザーを 1 時間のプロンプトキャッシュ TTL にオプトインします</div>126 <div><code>ENABLE\_PROMPT\_CACHING\_1H</code> は API キー、Amazon Bedrock、Google Cloud の Agent Platform、および Microsoft Foundry ユーザーを 1 時間のプロンプトキャッシュ TTL にオプトインします</div>

127 <div><code>sandbox.network.deniedDomains</code> 設定は、より広い <code>allowedDomains</code> ワイルドカードから特定のドメインを除外します</div>127 <div><code>sandbox.network.deniedDomains</code> 設定は、より広い <code>allowedDomains</code> ワイルドカードから特定のドメインを除外します</div>

128 <div><code>/undo</code> は <code>/rewind</code> のエイリアスになり、<code>/proactive</code> は <code>/loop</code> のエイリアスになりました</div>128 <div><code>/undo</code> は <code>/rewind</code> のエイリアスになり、<code>/proactive</code> は <code>/loop</code> のエイリアスになりました</div>

129 <div>強化された Bash 権限:拒否ルールは <code>env</code>/<code>sudo</code>/<code>watch</code> ラッパーを通じてマッチするようになり、<code>Bash(find:\*)</code> 許可ルールは <code>-exec</code> または <code>-delete</code> を自動承認しなくなりました</div>129 <div>強化された Bash 権限:拒否ルールは <code>env</code>/<code>sudo</code>/<code>watch</code> ラッパーを通じてマッチするようになり、<code>Bash(find:\*)</code> 許可ルールは <code>-exec</code> または <code>-delete</code> を自動承認しなくなりました</div>

Details

103 <div><code>--dangerously-skip-permissions</code> は <code>.claude/</code>、<code>.git/</code>、<code>.vscode/</code>、シェル設定ファイル、およびその他の以前に保護されたパスへの書き込みのプロンプトをバイパスするようになりました。ただし、危険な削除コマンドは安全ネットとしてプロンプトが表示されます</div>103 <div><code>--dangerously-skip-permissions</code> は <code>.claude/</code>、<code>.git/</code>、<code>.vscode/</code>、シェル設定ファイル、およびその他の以前に保護されたパスへの書き込みのプロンプトをバイパスするようになりました。ただし、危険な削除コマンドは安全ネットとしてプロンプトが表示されます</div>

104 <div><code>/model</code> ピッカーは <code>ANTHROPIC\_BASE\_URL</code> が Anthropic 互換ゲートウェイを指している場合、ゲートウェイの <code>/v1/models</code> エンドポイントからモデルをリストできます。v2.1.129 以降、<code>CLAUDE\_CODE\_ENABLE\_GATEWAY\_MODEL\_DISCOVERY=1</code> でオプトインします</div>104 <div><code>/model</code> ピッカーは <code>ANTHROPIC\_BASE\_URL</code> が Anthropic 互換ゲートウェイを指している場合、ゲートウェイの <code>/v1/models</code> エンドポイントからモデルをリストできます。v2.1.129 以降、<code>CLAUDE\_CODE\_ENABLE\_GATEWAY\_MODEL\_DISCOVERY=1</code> でオプトインします</div>

105 <div>起動中に一時的なエラーが発生した MCP サーバーは、接続が切れたままになるのではなく、最大 3 回まで自動的に再試行するようになりました</div>105 <div>起動中に一時的なエラーが発生した MCP サーバーは、接続が切れたままになるのではなく、最大 3 回まで自動的に再試行するようになりました</div>

106 <div><code>ANTHROPIC\_BEDROCK\_SERVICE\_TIER</code> は Bedrock サービスティアを選択します:<code>default</code>、<code>flex</code>、または <code>priority</code></div>106 <div><code>ANTHROPIC\_BEDROCK\_SERVICE\_TIER</code> は Amazon Bedrock サービスティアを選択します:<code>default</code>、<code>flex</code>、または <code>priority</code></div>

107 <div><code>/terminal-setup</code> は iTerm2 のクリップボードアクセス設定を有効にして、<code>/copy</code> が機能するようにします。tmux からも含まれます</div>107 <div><code>/terminal-setup</code> は iTerm2 のクリップボードアクセス設定を有効にして、<code>/copy</code> が機能するようにします。tmux からも含まれます</div>

108 <div>Vertex AI は X.509 証明書ベースのワークロード ID フェデレーション(mTLS ADC)をサポートするようになりました</div>108 <div>Google Cloud の Agent Platform は X.509 証明書ベースのワークロード ID フェデレーション(mTLS ADC)をサポートするようになりました</div>

109 <div>重大なメモリリーク修正:画像が多いセッション、大きなトランスクリプト履歴での <code>/usage</code>、およびプログレスイベントなしの長時間実行ツール</div>109 <div>重大なメモリリーク修正:画像が多いセッション、大きなトランスクリプト履歴での <code>/usage</code>、およびプログレスイベントなしの長時間実行ツール</div>

110 </div>110 </div>

111</div>111</div>

Details

37 <div>新しい <a href="/ja/code-review"><code>/code-review</code></a> コマンドは、<code>/code-review high</code> などの選択した努力レベルで正確性バグを報告し、<code>--comment</code> は結果を GitHub PR インラインコメントとして投稿します。<code>/simplify</code> は別のクリーンアップのみのレビューとして残ります。</div>37 <div>新しい <a href="/ja/code-review"><code>/code-review</code></a> コマンドは、<code>/code-review high</code> などの選択した努力レベルで正確性バグを報告し、<code>--comment</code> は結果を GitHub PR インラインコメントとして投稿します。<code>/simplify</code> は別のクリーンアップのみのレビューとして残ります。</div>

38 <div>バックグラウンドセッションは <code>/resume</code> にインタラクティブセッションと一緒に表示され、<code>bg</code> でマークされ、<code>claude agents</code> で Ctrl+T でピン留めされたセッションはアイドル時に生存し続けます。</div>38 <div>バックグラウンドセッションは <code>/resume</code> にインタラクティブセッションと一緒に表示され、<code>bg</code> でマークされ、<code>claude agents</code> で Ctrl+T でピン留めされたセッションはアイドル時に生存し続けます。</div>

39 <div><code>claude agents --json</code> はステータスバーとセッションピッカーなどのスクリプティング用に、ライブセッションを JSON として一覧表示します。</div>39 <div><code>claude agents --json</code> はステータスバーとセッションピッカーなどのスクリプティング用に、ライブセッションを JSON として一覧表示します。</div>

40 <div>PowerShell ツールは Windows 上で Bedrock、Vertex、Foundry ユーザーに対してデフォルトで有効になりました。<code>CLAUDE\_CODE\_USE\_POWERSHELL\_TOOL=0</code> でオプトアウトします。</div>40 <div>PowerShell ツールは Windows 上で Amazon Bedrock、Google Cloud の Agent Platformおよび Microsoft Foundry ユーザーに対してデフォルトで有効になりました。<code>CLAUDE\_CODE\_USE\_POWERSHELL\_TOOL=0</code> でオプトアウトします。</div>

41 <div><code>claude plugin disable</code> は別の有効なプラグインがターゲットに依存している場合に拒否し、<code>claude plugin enable</code> は推移的な依存関係を強制的に有効にします。</div>41 <div><code>claude plugin disable</code> は別の有効なプラグインがターゲットに依存している場合に拒否し、<code>claude plugin enable</code> は推移的な依存関係を強制的に有効にします。</div>

42 <div><code>/plugin</code> マーケットプレイスの参照ペインは予測されるコンテキストコストを表示し、Discover および Browse スクリーンはインストール前にプラグインのコマンド、エージェント、スキル、フック、および MCP/LSP サーバーを一覧表示します。</div>42 <div><code>/plugin</code> マーケットプレイスの参照ペインは予測されるコンテキストコストを表示し、Discover および Browse スクリーンはインストール前にプラグインのコマンド、エージェント、スキル、フック、および MCP/LSP サーバーを一覧表示します。</div>

43 <div>新しい <code>worktree.bgIsolation: "none"</code> 設定により、バックグラウンドセッションは <code>EnterWorktree</code> なしで作業コピーを直接編集でき、worktree が実用的でないリポジトリの場合に使用できます。</div>43 <div>新しい <code>worktree.bgIsolation: "none"</code> 設定により、バックグラウンドセッションは <code>EnterWorktree</code> なしで作業コピーを直接編集でき、worktree が実用的でないリポジトリの場合に使用できます。</div>

Details

109 <div>Claude Code は、プライマリモデルが見つからない場合、すべてのリクエストで失敗する代わりに、セッションの残りの部分で設定された <code>--fallback-model</code> に切り替えるようになりました</div>109 <div>Claude Code は、プライマリモデルが見つからない場合、すべてのリクエストで失敗する代わりに、セッションの残りの部分で設定された <code>--fallback-model</code> に切り替えるようになりました</div>

110 <div>プラグインは <code>plugin.json</code> またはマーケットプレイスエントリで <code>defaultEnabled: false</code> を宣言できるため、有効にするまで有効にならずにインストールされます</div>110 <div>プラグインは <code>plugin.json</code> またはマーケットプレイスエントリで <code>defaultEnabled: false</code> を宣言できるため、有効にするまで有効にならずにインストールされます</div>

111 <div>Vim モード:NORMAL モードで <code>/</code> を押すと逆履歴検索が開き、Bash および Zsh vi-mode と一致します</div>111 <div>Vim モード:NORMAL モードで <code>/</code> を押すと逆履歴検索が開き、Bash および Zsh vi-mode と一致します</div>

112 <div>ストリーミングツール実行は常に有効になり、テレメトリが無効な場合、および Bedrock、Vertex、Foundry でも有効です</div>112 <div>ストリーミングツール実行は常に有効になり、テレメトリが無効な場合、および Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry でも有効です</div>

113 <div><code>←←</code> でエージェントビューを開くことは、Bedrock、Vertex、Foundry、およびテレメトリが無効な場合でも機能するようになりました</div>113 <div><code>←←</code> でエージェントビューを開くことは、Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry、およびテレメトリが無効な場合でも機能するようになりました</div>

114 <div>Chrome の Claude:<code>/chrome</code> → 「ブラウザを選択...」 で接続されたブラウザを選択するか、複数が接続されている場合はブラウザアクションが実行されるときにチャット内で選択できます</div>114 <div>Chrome の Claude:<code>/chrome</code> → 「ブラウザを選択...」 で接続されたブラウザを選択するか、複数が接続されている場合はブラウザアクションが実行されるときにチャット内で選択できます</div>

115 <div><code>claude mcp list</code> と <code>claude mcp get</code> は、出力がパイプされている場合、未承認の <code>.mcp.json</code> サーバーを自動承認して接続する代わりに、保留中の承認として表示するようになりました</div>115 <div><code>claude mcp list</code> と <code>claude mcp get</code> は、出力がパイプされている場合、未承認の <code>.mcp.json</code> サーバーを自動承認して接続する代わりに、保留中の承認として表示するようになりました</div>

116 </div>116 </div>

Details

4 4 

5# Week 23 · 2026 年 6 月 1 日~5 日5# Week 23 · 2026 年 6 月 1 日~5 日

6 6 

7> Bedrock、Vertex、Foundry で auto mode を実行し、acceptEdits モードでコードを実行できるファイルを書き込む前にプロンプトを表示し、/plugin list でインストール済みプラグインをリストアップし、マネージドデプロイメント向けに承認されたバージョン範囲を要求します。7> Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry で auto mode を実行し、acceptEdits モードでコードを実行できるファイルを書き込む前にプロンプトを表示し、/plugin list でインストール済みプラグインをリストアップし、マネージドデプロイメント向けに承認されたバージョン範囲を要求します。

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>Releases <a href="/ja/docs/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>10 <span>Releases <a href="/ja/docs/changelog#2-1-158">v2.1.158 → v2.1.165</a></span>


13 13 

14<div className="digest-feature">14<div className="digest-feature">

15 <div className="digest-feature-header">15 <div className="digest-feature-header">

16 <span className="digest-feature-title">Bedrock、Vertex、Foundry での Auto mode</span>16 <span className="digest-feature-title">Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry での Auto mode</span>

17 <span className="digest-feature-pill">v2.1.158</span>17 <span className="digest-feature-pill">v2.1.158</span>

18 </div>18 </div>

19 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>20 <p className="digest-feature-lede">Auto mode は Opus 4.7 および Opus 4.8 向けに Amazon Bedrock、Google Cloud の Agent PlatformMicrosoft Foundry で利用可能になり、パーミッションプロンプトをサードパーティプロバイダー上のバックグラウンドセーフティチェックに置き換えます。<code>CLAUDE\_CODE\_ENABLE\_AUTO\_MODE=1</code> を設定してオプトインしてください。</p>

21 21 

22 <p className="digest-feature-try">サードパーティプロバイダーでオプトインし、Shift+Tab で auto mode に切り替えます:</p>22 <p className="digest-feature-try">サードパーティプロバイダーでオプトインし、Shift+Tab で auto mode に切り替えます:</p>

23 23 


25 export CLAUDE_CODE_ENABLE_AUTO_MODE=125 export CLAUDE_CODE_ENABLE_AUTO_MODE=1

26 ```26 ```

27 27 

28 <a className="digest-feature-link" href="/ja/docs/permission-modes#enable-auto-mode-on-bedrock-vertex-ai-or-foundry">サードパーティプロバイダーで auto mode を有効にする</a>28 <a className="digest-feature-link" href="/ja/docs/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry">サードパーティプロバイダーで auto mode を有効にする</a>

29</div>29</div>

30 30 

31<div className="digest-feature">31<div className="digest-feature">

workflows.md +34 −8

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 Agent Platform、Microsoft Foundry で利用できます。Pro では、`/config` の Dynamic workflows 行からオンにしてください。

13</Note>13</Note>

14 14 

15動的ワークフローは、[サブエージェント](/ja/sub-agents)を大規模にオーケストレーションする JavaScript スクリプトです。Claude は説明したタスク用のスクリプトを作成し、ランタイムはバックグラウンドで実行しながら、セッションは応答性を保ちます。15動的ワークフローは、[サブエージェント](/ja/sub-agents)を大規模にオーケストレーションする JavaScript スクリプトです。Claude は説明したタスク用のスクリプトを作成し、ランタイムはバックグラウンドで実行しながら、セッションは応答性を保ちます。


148/effort ultracode148/effort ultracode

149```149```

150 150 

151ultracode がオンの状態でセッションを開始するには、`claude --effort ultracode` で起動します。Claude Code v2.1.203 以降が必要です。

152 

151ultracode がオンの場合、Claude はタスクがワークフローを必要とするかどうかを決定します。単一のリクエストは複数のワークフローに変わる可能性があります。コードを理解するためのワークフロー、変更を加えるためのワークフロー、検証するためのワークフロー。これはセッション内のすべてのタスクに適用されるため、各リクエストはより多くのトークンを使用し、より低い努力レベルより長くかかります。153ultracode がオンの場合、Claude はタスクがワークフローを必要とするかどうかを決定します。単一のリクエストは複数のワークフローに変わる可能性があります。コードを理解するためのワークフロー、変更を加えるためのワークフロー、検証するためのワークフロー。これはセッション内のすべてのタスクに適用されるため、各リクエストはより多くのトークンを使用し、より低い努力レベルより長くかかります。

152 154 

153Ultracode は現在のセッション用に続き、新しいセッションを開始するときにリセットされます。ルーチンワークに戻るときは `/effort high` でドロップバックします。`xhigh` [努力](/ja/model-config#adjust-effort-level)をサポートするモデルで利用可能です。他のモデルでは、`/effort` メニューはそれを提供しません。155Ultracode は現在のセッション用に続き、新しいセッションを開始するときにリセットされます。ルーチンワークに戻るときは `/effort high` でドロップバックします。`xhigh` [努力](/ja/model-config#adjust-effort-level)をサポートするモデルで利用可能です。他のモデルでは、`/effort` メニューはそれを提供しません。


165 167 

166`Ctrl+G` はエディターでスクリプトを開きます。`Tab` を使用すると、実行開始前にプロンプトを調整できます。168`Ctrl+G` はエディターでスクリプトを開きます。`Tab` を使用すると、実行開始前にプロンプトを調整できます。

167 169 

168このプロンプトを表示するかどうかは、[パーミッションモード](/ja/permission-modes)によって異なります。170このプロンプトを表示するかどうかは、[権限モード](/ja/permission-modes)によって異なります。

169 171 

170| パーミッションモード | プロンプトが表示される場合 |172| 権限モード | プロンプトが表示される場合 |

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

172| デフォルト、編集を受け入れ | すべての実行、そのワークフロー用に**Yes, and don't ask again** を選択していない限り |174| デフォルト、編集を受け入れ | すべての実行、そのワークフロー用に**Yes, and don't ask again** を選択していない限り |

173| 自動 | 最初の起動のみ。任意の **Yes** はユーザー設定に同意を記録し、後の起動はプロンプトなしで開始します。ultracode がオンの場合は完全にスキップされます |175| 自動 | 最初の起動のみ。任意の **Yes** はユーザー設定に同意を記録し、後の起動はプロンプトなしで開始します。ultracode がオンの場合は完全にスキップされます |

174| パーミッションをバイパス、`claude -p`、Agent SDK | なし。実行は直ちに開始 |176| 権限をバイパス、`claude -p`、Agent SDK | なし。実行は直ちに開始 |

175 177 

176Desktop アプリでは、承認カードはワークフロー名、フェーズリスト、トークン使用量の注意を表示し、**Once**、**Always**、**Deny** アクションがあります。進捗ビューは Background tasks サイドペインに表示されます。178Desktop アプリでは、承認カードはワークフロー名、フェーズリスト、トークン使用量の注意を表示し、**Once**、**Always**、**Deny** アクションがあります。進捗ビューは Background tasks サイドペインに表示されます。

177 179 

178パーミッションモードは上記の起動プロンプトのみを制御します。ワークフローが生成するサブエージェントは常に `acceptEdits` モードで実行され、セッションのモードに関係なく、[ツール許可リスト](/ja/settings#permission-settings)を継承します。ファイル編集は自動承認されます。180権限モードは上記の起動プロンプトのみを制御します。ワークフローが生成するサブエージェントは常に `acceptEdits` モードで実行され、セッションのモードに関係なく、[ツール許可リスト](/ja/settings#permission-settings)を継承します。ファイル編集は自動承認されます。

179 181 

180シェルコマンド、Web フェッチ、許可リストにない MCP ツールは、実行中にプロンプトを表示できます。長い実行でこれを回避するには、エージェントが必要とするコマンドを開始前に許可リストに追加します。182シェルコマンド、Web フェッチ、許可リストにない MCP ツールは、実行中にプロンプトを表示できます。長い実行でこれを回避するには、エージェントが必要とするコマンドを開始前に許可リストに追加します。

181 183 


194 196 

195Enter キーを押して保存します。ワークフローは、どちらかの場所から今後のセッションで `/<name>` として実行されます。197Enter キーを押して保存します。ワークフローは、どちらかの場所から今後のセッションで `/<name>` として実行されます。

196 198 

197{/* min-version: 2.1.178 */}複数の `.claude/` ディレクトリを持つモノレポでは、ワークフローをそれが適用されるパッケージの横に保持できます。v2.1.178 以降、プロジェクトの場所に保存すると、作業ディレクトリとリポジトリルートの間に既に存在する最も近い `.claude/workflows/` ディレクトリに書き込まれるか、まだ存在しない場合はリポジトリルートに書き込まれます。プロジェクトワークフローはその経路に沿ったすべての `.claude/workflows/` から読み込まれ、複数が同じ名前を定義する場合、Claude Code は作業ディレクトリに最も近いものを実行します。199複数の `.claude/` ディレクトリを持つモノレポでは、ワークフローをそれが適用されるパッケージの横に保持できます。v2.1.178 以降、プロジェクトの場所に保存すると、作業ディレクトリとリポジトリルートの間に既に存在する最も近い `.claude/workflows/` ディレクトリに書き込まれるか、まだ存在しない場合はリポジトリルートに書き込まれます。プロジェクトワークフローはその経路に沿ったすべての `.claude/workflows/` から読み込まれ、複数が同じ名前を定義する場合、Claude Code は作業ディレクトリに最も近いものを実行します。

198 200 

199プロジェクトワークフローと個人ワークフローが名前を共有する場合、プロジェクトワークフローが実行されます。201プロジェクトワークフローと個人ワークフローが名前を共有する場合、プロジェクトワークフローが実行されます。

200 202 


346 348 

347ワークフローは多くのエージェントを生成するため、単一の実行は会話で同じタスクを処理するより意味のあるほど多くのトークンを使用できます。実行は他のセッションと同様にプランの使用量とレート制限にカウントされます。349ワークフローは多くのエージェントを生成するため、単一の実行は会話で同じタスクを処理するより意味のあるほど多くのトークンを使用できます。実行は他のセッションと同様にプランの使用量とレート制限にカウントされます。

348 350 

349大規模なタスクにコミットする前に支出を見積もるには、まず小さなスライスでワークフローを実行します。リポジトリ全体ではなく 1 つのディレクトリ、または広い質問ではなく狭い質問です。`/workflows` ビューは実行の進行に伴い各エージェントのトークン使用量を表示し、完了した作業を失うことなくいつでも実行を停止できます。ランタイムの[エージェント上限](#behavior-and-limits)は単一の実行が生成できるエージェント数を制限し、暴走スクリプトのコストを制限します。351大規模なタスクにコミットする前に支出を見積もるには、まず小さなスライスでワークフローを実行します。リポジトリ全体ではなく 1 つのディレクトリ、または広い質問ではなく狭い質問です。`/workflows` ビューは実行の進行に伴い各エージェントのトークン使用量を表示し、完了した作業を失うことなくいつでも実行を停止できます。ランタイムの[エージェント上限](#behavior-and-limits)は単一の実行が生成できるエージェント数を制限し、暴走スクリプトのコストを制限します。デフォルトですべての実行をより小さく保つには、`/config` で[サイズガイドラインを設定](#set-a-size-guideline)します。

352 

353Claude Code はまた、異常に大きくなった実行にフラグを立てます。ワークフローが 25 個を超えるエージェントをスケジュールするか、その予想トークン合計が 150 万を超える場合、入力ボックスの下のタスクパネルの進捗行に `Large workflow` 警告が表示されます。警告は [`/workflows`](#watch-the-run) を指し、そこで実行を停止できます。Claude Code v2.1.203 以降が必要です。

354 

355警告は参考情報です。実行を一時停止または制限しません。警告が表示されたときに 2 つの設定が変わります。

356 

357* [サイズガイドラインを設定](#set-a-size-guideline)した場合、ガイドラインのエージェント数が 25 エージェントのしきい値に置き換わります。

358* [ultracode](#let-claude-decide-with-ultracode) がオンのセッションは警告を表示しません。ultracode をオンにすることで既に大規模な実行にオプトインしているためです。

350 359 

351ワークフロー内のすべてのエージェントは、スクリプトがステージを別のモデルにルーティングしない限り、セッションのモデルを使用します。モデルコストを制御するには:360ワークフロー内のすべてのエージェントは、スクリプトがステージを別のモデルにルーティングしない限り、セッションのモデルを使用します。モデルコストを制御するには:

352 361 

353* 通常、ルーチンワーク用に小さいモデルに切り替える場合は、大規模な実行前に `/model` を確認362* 通常、ルーチンワーク用に小さいモデルに切り替える場合は、大規模な実行前に `/model` を確認

354* タスクを説明するときに、最強のモデルが必要ないステージ用に小さいモデルを使用するよう Claude に依頼363* タスクを説明するときに、最強のモデルが必要ないステージ用に小さいモデルを使用するよう Claude に依頼

355 364 

365<h3 id="set-a-size-guideline">

366 サイズガイドラインを設定する

367</h3>

368 

369`/config` の Dynamic workflow size 設定は、Claude が作成するワークフローをデフォルトでより小さなスケールに保ちます。Claude Code は設定を Claude へのアドバイスとして送信するため、異なるスケールを要求するプロンプトはそれをオーバーライドします。Claude Code v2.1.202 以降が必要です。

370 

371各値は、Claude がスクリプトで目指すエージェント数を設定します。

372 

373| 値 | Claude に送信されるガイダンス |

374| :------------- | :------------------- |

375| `unrestricted` | ガイドラインなし。これがデフォルトです。 |

376| `small` | 5 未満のエージェントを目指します。 |

377| `medium` | 15 未満のエージェントを目指します。 |

378| `large` | 50 未満のエージェントを目指します。 |

379 

380変更は次のプロンプトで有効になります。[ランタイムエージェント上限](#behavior-and-limits)は設定に関係なく引き続き適用されます。

381 

356<h3 id="turn-workflows-off">382<h3 id="turn-workflows-off">

357 ワークフローをオフにする383 ワークフローをオフにする

358</h3>384</h3>

worktrees.md +11 −5

Details

22claude --worktree feature-auth22claude --worktree feature-auth

23```23```

24 24 

25Worktree を別の場所に配置するには、[`WorktreeCreate` フック](#non-git-version-control) を設定します。別のターミナルで異なる名前を使用してコマンドを再度実行して、2 番目の分離されたセッションを開始します。25Worktree を別の場所に配置するには、[`WorktreeCreate` フック](#non-git-version-control)を設定します。別のターミナルで異なる名前を使用してコマンドを再度実行して、2 番目の分離されたセッションを開始します。

26 26 

27```bash theme={null}27```bash theme={null}

28claude --worktree bugfix-12328claude --worktree bugfix-123


34claude --worktree34claude --worktree

35```35```

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{/* min-version: 2.1.198 */}v2.1.198 以降、worktree に入るか出るかは、セッショントランスクリプトをそのディレクトリのプロジェクトストレージに再配置します。これは [`/cd`](/ja/commands)と同じ方法で行われるため、`/desktop` と `--resume` はその後そこでセッションを見つけます。[`WorktreeCreate` フック](#non-git-version-control)によって作成された Worktree は除外され、トランスクリプトを起動ディレクトリに保持します。39{/* min-version: 2.1.198 */}v2.1.198 以降、worktree に入るか出るかは、セッショントランスクリプトをそのディレクトリのプロジェクトストレージに再配置します。これは [`/cd`](/ja/commands)と同じ方法で行われるため、`/desktop` と `--resume` はその後そこでセッションを見つけます。[`WorktreeCreate` フック](#non-git-version-control)によって作成された Worktree は除外され、トランスクリプトを起動ディレクトリに保持します。

40 40 

41初めてディレクトリで `--worktree` をインタラクティブに使用する前に、そのディレクトリで `claude` を 1 回実行してワークスペース信頼ダイアログを受け入れてください。信頼がまだ受け入れられていない場合、`--worktree` はエラーで終了し、最初にディレクトリで `claude` を実行するよう求めるプロンプトが表示されます。`-p` を使用した非インタラクティブ実行は[信頼チェック](/ja/security)をスキップするため、`claude -p --worktree` はそれなしで進行します。41初めてディレクトリで `--worktree` をインタラクティブに使用する前に、そのディレクトリで `claude` を 1 回実行してワークスペース信頼ダイアログを受け入れてください。信頼がまだ受け入れられていない場合、`--worktree` はエラーで終了し、最初にディレクトリで `claude` を実行するよう求めるプロンプトが表示されます。`-p` を使用した非インタラクティブ実行は[信頼チェック](/ja/security)をスキップするため、`claude -p --worktree` はそれなしで進行します。

42 42 

43{/* min-version: 2.1.205 */}Claude Code が起動時に worktree ディレクトリに入ることができない場合、たとえば [`WorktreeCreate` フック](/ja/hooks#worktreecreate)が作成したディレクトリ以外のものを出力した場合、またはセットアップ後にディレクトリが削除された場合、Claude Code はパスを名前として付けたエラーを出力し、コード 1 で終了します。v2.1.205 より前は、これはセッションをクラッシュさせ、`-p` を使用すると約 30 秒間スタールしてからコード 0 で終了していました。

44 

45{/* min-version: 2.1.200 */}メインチェックアウトから[プロジェクトスコープ](/ja/plugins-reference#plugin-installation-scopes)でインストールされたプラグインは、同じリポジトリの worktree でも読み込まれるため、worktree ごとに再インストールする必要はありません。これは `--worktree` で worktree を作成する場合でも、`git worktree add` で作成する場合でも適用されます。Claude Code v2.1.200 以降が必要です。

46 

43<Tip>47<Tip>

44 `.claude/worktrees/` を `.gitignore` に追加して、worktree の内容がメインのチェックアウトで追跡されていないファイルとして表示されないようにします。48 `.claude/worktrees/` を `.gitignore` に追加して、worktree の内容がメインのチェックアウトで追跡されていないファイルとして表示されないようにします。

45</Tip>49</Tip>


48 ベースブランチを選択する52 ベースブランチを選択する

49</h3>53</h3>

50 54 

51Worktree はリポジトリのデフォルトブランチ `origin/HEAD` からブランチするため、リモートと一致するクリーンなツリーから開始します。リモートが設定されていない場合、またはフェッチが失敗した場合、worktree は現在のローカル `HEAD` にフォールバックします。代わりにローカル `HEAD` から常にブランチするには、[設定](/ja/settings#worktree-settings) で `worktree.baseRef` を `"head"` に設定します。`baseRef` を `"head"` に設定すると、新しい worktree はプッシュされていないコミットと機能ブランチの状態を保持します。これは、進行中の作業で動作する必要がある subagent を分離する場合に便利です。この設定は `"fresh"` または `"head"` のみを受け入れ、任意の git ref は受け入れません。55Worktree はリポジトリのデフォルトブランチ `origin/HEAD` からブランチするため、リモートと一致するクリーンなツリーから開始します。リモートが設定されていない場合、またはフェッチが失敗した場合、worktree は現在のローカル `HEAD` にフォールバックします。代わりにローカル `HEAD` から常にブランチするには、[設定](/ja/settings#worktree-settings)で `worktree.baseRef` を `"head"` に設定します。`baseRef` を `"head"` に設定すると、新しい worktree はプッシュされていないコミットと機能ブランチの状態を保持します。これは、進行中の作業で動作する必要がある subagent を分離する場合に便利です。この設定は `"fresh"` または `"head"` のみを受け入れ、任意の git ref は受け入れません。

52 56 

53```json theme={null}57```json theme={null}

54{58{


64claude --worktree "#1234"68claude --worktree "#1234"

65```69```

66 70 

67Worktree の作成方法を完全に制御するには、[`WorktreeCreate` フック](/ja/hooks#worktreecreate) を設定します。これはデフォルトの `git worktree` ロジックを完全に置き換えます。71Worktree の作成方法を完全に制御するには、[`WorktreeCreate` フック](/ja/hooks#worktreecreate)を設定します。これはデフォルトの `git worktree` ロジックを完全に置き換えます。

68 72 

69<h2 id="copy-gitignored-files-into-worktrees">73<h2 id="copy-gitignored-files-into-worktrees">

70 gitignore されたファイルを worktree にコピーする74 gitignore されたファイルを worktree にコピーする


93Subagent worktree は `--worktree` と同じ[ベースブランチ](#choose-the-base-branch)を使用するため、`worktree.baseRef` が `"head"` に設定されていない限り、リポジトリのデフォルトブランチから分岐します。97Subagent worktree は `--worktree` と同じ[ベースブランチ](#choose-the-base-branch)を使用するため、`worktree.baseRef` が `"head"` に設定されていない限り、リポジトリのデフォルトブランチから分岐します。

94 98 

95<h2 id="clean-up-worktrees">99<h2 id="clean-up-worktrees">

96 worktree をクリーンアップする100 Worktree をクリーンアップする

97</h2>101</h2>

98 102 

99Worktree セッションを終了すると、クリーンアップは変更を加えたかどうかによって異なります。103Worktree セッションを終了すると、クリーンアップは変更を加えたかどうかによって異なります。


106 110 

107エージェントが実行中の間、Claude は worktree に対して `git worktree lock` を実行するため、同時実行クリーンアップがそれを削除することはできません。ロックはエージェントが完了すると解放されます。スイープが保持する worktree をクリーンアップするには、`git worktree remove` を実行し、worktree にコミットされていない変更または追跡されていないファイルがある場合は `--force` を追加します。111エージェントが実行中の間、Claude は worktree に対して `git worktree lock` を実行するため、同時実行クリーンアップがそれを削除することはできません。ロックはエージェントが完了すると解放されます。スイープが保持する worktree をクリーンアップするには、`git worktree remove` を実行し、worktree にコミットされていない変更または追跡されていないファイルがある場合は `--force` を追加します。

108 112 

113Windows では、worktree を削除する前に、Claude Code はその内部の任意の深さにある NTFS ジャンクションまたはディレクトリシンボリックリンクをリンクエントリとして削除するため、worktree を削除してもリンクが指すファイルは削除されません。v2.1.205 より前では、Claude Code はトップレベルのリンクのみをリンクエントリとして削除していたため、サブディレクトリにネストされたジャンクションを含む worktree を削除すると、worktree 外のリンクが指すディレクトリの内容が削除される可能性がありました。

114 

109<h2 id="manage-worktrees-manually">115<h2 id="manage-worktrees-manually">

110 worktree を手動で管理する116 worktree を手動で管理する

111</h2>117</h2>

Details

19* [Server-managed settings](/ja/server-managed-settings)19* [Server-managed settings](/ja/server-managed-settings)

20* 監査ログ20* 監査ログ

21 21 

22Claude for Enterprise 上の Claude Code の ZDR は、Anthropic の直接プラットフォームにのみ適用されます。Amazon Bedrock、Google Vertex AI、または Microsoft Foundry 上の Claude デプロイメントについては、これらのプラットフォームのデータ保持ポリシーを参照してください。22Claude for Enterprise 上の Claude Code の ZDR は、Anthropic の直接プラットフォームにのみ適用されます。Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry 上の Claude デプロイメントについては、これらのプラットフォームのデータ保持ポリシーを参照してください。

23 23 

24<h2 id="zdr-scope">24<h2 id="zdr-scope">

25 ZDR スコープ25 ZDR スコープ