Documentation 2026-10-13 23:57 UTC to 2026-10-14 22:58 UTC

855 855 

856リモートサーバーのステータスは、`"connected"` を報告した後でも変わる可能性があります。セッション中に接続が切れると、Claude Code はサーバーを `"pending"` に戻して [再接続](/docs/ja/mcp#automatic-reconnection) します。その後、TypeScript で `mcpServerStatus()` を呼び出すか、Python で [`ClaudeSDKClient.get_mcp_status()`](/docs/ja/agent-sdk/python#methods) を呼び出すと、あなた側で設定変更がなくても、以前に接続されていたサーバーに対して `"pending"` を報告できます。856リモートサーバーのステータスは、`"connected"` を報告した後でも変わる可能性があります。セッション中に接続が切れると、Claude Code はサーバーを `"pending"` に戻して [再接続](/docs/ja/mcp#automatic-reconnection) します。その後、TypeScript で `mcpServerStatus()` を呼び出すか、Python で [`ClaudeSDKClient.get_mcp_status()`](/docs/ja/agent-sdk/python#methods) を呼び出すと、あなた側で設定変更がなくても、以前に接続されていたサーバーに対して `"pending"` を報告できます。

857 857 

8585 回の再接続試行が失敗した後、サーバーは `"failed"` を報告するか、再度認可が必要な場合は `"needs-auth"` を報告します。手動で再試行するには、TypeScript で [`reconnectMcpServer()`](/docs/ja/agent-sdk/typescript#methods) を呼び出すか、Python で [`ClaudeSDKClient.reconnect_mcp_server()`](/docs/ja/agent-sdk/python#methods) を呼び出してください。8585 回の再接続試行が失敗した後、サーバーは `"failed"` を報告するか、再度認可が必要な場合は `"needs-auth"` を報告します。一時的なエラーの後も Claude Code は [バックグラウンドで再試行](/docs/ja/mcp#mid-session-drops-of-a-remote-server) を続けるため、`"failed"` の HTTP または SSE サーバーは、呼び出しを行わなくても `"connected"` に戻ることがあります。手動で再試行するには、TypeScript で [`reconnectMcpServer()`](/docs/ja/agent-sdk/typescript#methods) を呼び出すか、Python で [`ClaudeSDKClient.reconnect_mcp_server()`](/docs/ja/agent-sdk/python#methods) を呼び出してください。

859 859 

860<h2 id="troubleshooting">860<h2 id="troubleshooting">

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

424 Claude Code がシステムプロンプト外に追加するコンテキスト424 Claude Code がシステムプロンプト外に追加するコンテキスト

425</h2>425</h2>

426 426 

427システムリマインダーは、Claude Code がセッション中に会話に追加するメッセージで、CLAUDE.md ファイルの内容やファイルがディスク上で変更されたというメモなど、Claude にコンテキストを提供します。Claude Code はシステムプロンプトではなく会話内でそれらを送信するため、`claude_code` プリセットを使用するか、`systemPrompt` として独自の文字列を渡すかに関わらず、Claude に到達します。427システムリマインダーは、Claude Code がセッション中に会話に追加するメッセージで、CLAUDE.md ファイルの内容やファイルがディスク上で変更されたというメモなど、Claude にコンテキストを提供します。Claude Code はシステムプロンプトではなく会話内でそれらを送信するため、`claude_code` プリセットを使用するか、`systemPrompt` として独自の文字列を渡すかに関わらず、そのほとんどは Claude に到達します。

428 428 

429このセクションでは、[エージェントの動作を変更する可能性が最も高いリマインダー](#reminders-claude-code-adds-to-the-conversation)、[エージェントが置き換えるコンテキストをオフにする方法](#turn-off-the-context-your-agent-replaces)、および[特定のリクエストで Claude が受け取ったもの](#see-what-claude-received)を確認する方法について説明します。429このセクションでは、[エージェントの動作を変更する可能性が最も高いリマインダー](#reminders-claude-code-adds-to-the-conversation)、[エージェントが置き換えるコンテキストをオフにする方法](#turn-off-the-context-your-agent-replaces)、および[特定のリクエストで Claude が受け取ったもの](#see-what-claude-received)を確認する方法について説明します。

430 430 

467| すべての CLAUDE.md ファイル | `CLAUDE_CODE_DISABLE_CLAUDE_MDS=1` を設定します |467| すべての CLAUDE.md ファイル | `CLAUDE_CODE_DISABLE_CLAUDE_MDS=1` を設定します |

468| タスクリストナッジ、ファイル変更メモ、およびスキルリスト | `CLAUDE_CODE_DISABLE_ATTACHMENTS=1` を設定します |468| タスクリストナッジ、ファイル変更メモ、およびスキルリスト | `CLAUDE_CODE_DISABLE_ATTACHMENTS=1` を設定します |

469 469 

470Claude Code の組み込みコミットおよびプルリクエスト指示はリマインダーではありません。これらは Bash ツールの説明の一部であるため、カスタム `systemPrompt` を渡す場合にも Claude に到達します。470組み込みのコミットおよびプルリクエスト指示を除外するには、`includeGitInstructions` を `false` に設定します。これらの指示は Bash ツールの説明の一部であり、カスタム `systemPrompt` を使用する場合でも Claude に到達します。ただし、最小限のデフォルト、カスタム `systemPrompt`、または独自のプロンプトを持つカスタムメインスレッドエージェントを使用する場合、セッションは git ステータススナップショットなしで開始されます。

471 471 

472`CLAUDE_CODE_DISABLE_ATTACHMENTS` を設定する場合、Claude Code は `@` ファイルメンションをプレーンテキストとして送信し、ファイルコンテンツに展開しません。利用可能なサブエージェントのリストとバックグラウンドタスク通知は依然として到達します。472`CLAUDE_CODE_DISABLE_ATTACHMENTS` を設定する場合、Claude Code は `@` ファイルメンションをプレーンテキストとして送信し、ファイルコンテンツに展開しません。利用可能なサブエージェントのリストとバックグラウンドタスク通知は依然として到達します。`@` ファイルメンションの展開のみを停止するには、Claude Code v2.1.299 以降で代わりに [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/ja/env-vars#variables) を設定します。その場合、Claude はメンションされたパスと、ファイルツールでそれらを読み込むよう促すメモを受け取ります。

473 473 

474以下の例は、`append` に独自のコミットルールを持つエージェント用です。トレーラーとフッターを削除するために両方の `attribution` キーを空の文字列に設定し、`includeGitInstructions` をオフにして、Claude Code 独自のコミットワークフロー指示があなたのものと競合しないようにします。474以下の例は、`append` に独自のコミットルールを持つエージェント用です。トレーラーとフッターを削除するために両方の `attribution` キーを空の文字列に設定し、`includeGitInstructions` をオフにして、Claude Code 独自のコミットワークフロー指示があなたのものと競合しないようにします。

475 475 

164| `mcpServers` | `(string \| object)[]` | いいえ | このエージェントで利用可能な MCP サーバー（名前またはインライン設定） |164| `mcpServers` | `(string \| object)[]` | いいえ | このエージェントで利用可能な MCP サーバー（名前またはインライン設定） |

165| `initialPrompt` | `string` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます。エージェントがサブエージェントとして呼び出される場合は無視されます |165| `initialPrompt` | `string` | いいえ | このエージェントがメインスレッドエージェントとして実行される場合、最初のユーザーターンとして自動送信されます。エージェントがサブエージェントとして呼び出される場合は無視されます |

166| `maxTurns` | `number` | いいえ | エージェントが停止する前の最大 agentic ターン数。エージェントが制限に達すると、Claude Code は出力を部分的としてマークして返し、[エージェントを再開](#resume-subagents)して続行できます。部分的なマーキングには Claude Code v2.1.246 以降が必要です |166| `maxTurns` | `number` | いいえ | エージェントが停止する前の最大 agentic ターン数。エージェントが制限に達すると、Claude Code は出力を部分的としてマークして返し、[エージェントを再開](#resume-subagents)して続行できます。部分的なマーキングには Claude Code v2.1.246 以降が必要です |

167| `autoCompactWindow` | `number` | いいえ | このエージェントがサブエージェントとして実行される場合の[自動圧縮ウィンドウ](/docs/ja/sub-agents#subagent-auto-compact-window)を、`100000` から `1000000` までのトークン数に引き下げます。TypeScript Agent SDK v0.3.296 以降が必要です。Python SDK の [`AgentDefinition`](/docs/ja/agent-sdk/python#agentdefinition) にはこのフィールドがありません |

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

168| `omitClaudeMd` | `boolean` | いいえ | このエージェントがサブエージェントとして実行される場合、ユーザー、プロジェクト、およびローカル CLAUDE.md ファイルなしでこのエージェントを実行します。管理ポリシーファイルは引き続き読み込まれます。エージェントがメインスレッドエージェントとして実行される場合は無視されます。TypeScript Agent SDK v0.3.271 以降が必要です。Python SDK の [`AgentDefinition`](/docs/ja/agent-sdk/python#agentdefinition) にはこのフィールドがありません |169| `omitClaudeMd` | `boolean` | いいえ | ユーザー、プロジェクト、およびローカルの CLAUDE.md ファイルをこのエージェントの初期コンテキストから除外します。管理ポリシーファイルは引き続き読み込まれます。エージェントがメインスレッドエージェントとして実行される場合は無視されます。TypeScript Agent SDK v0.3.271 以降が必要です。Python SDK の [`AgentDefinition`](/docs/ja/agent-sdk/python#agentdefinition) にはこのフィールドがありません |

169| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max' \| number` | いいえ | このエージェントの推論努力レベル |170| `effort` | `'low' \| 'medium' \| 'high' \| 'xhigh' \| 'max' \| number` | いいえ | このエージェントの推論努力レベル |

170| `permissionMode` | `PermissionMode` | いいえ | このエージェント内のツール実行の権限モード。[サブエージェント継承ルール](/docs/ja/agent-sdk/permissions#available-modes)は、それが適用される場合を決定します |171| `permissionMode` | `PermissionMode` | いいえ | このエージェント内のツール実行の権限モード。[サブエージェント継承ルール](/docs/ja/agent-sdk/permissions#available-modes)は、それが適用される場合を決定します |

171 172 

200| サブエージェントが受け取るもの | サブエージェントが受け取らないもの |201| サブエージェントが受け取るもの | サブエージェントが受け取らないもの |

201| :- | :- |202| :- | :- |

202| 独自のシステムプロンプト（`AgentDefinition.prompt`）と Agent ツールのプロンプト | 親の会話履歴またはツール結果 |203| 独自のシステムプロンプト（`AgentDefinition.prompt`）と Agent ツールのプロンプト | 親の会話履歴またはツール結果 |

203| Project CLAUDE.md（[`settingSources`](/docs/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) 経由でロード）（[`omitClaudeMd`](#agentdefinition-configuration) をエージェントが設定しない限り） | プリロードされたスキルコンテンツ（`AgentDefinition.skills` にリストされている場合を除く） |204| Project CLAUDE.md（[`settingSources`](/docs/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) 経由でロード）。[`omitClaudeMd`](#agentdefinition-configuration) を設定したエージェントは、これなしで開始します | プリロードされたスキルコンテンツ（`AgentDefinition.skills` にリストされている場合を除く） |

204| ツール定義（親から継承、または `tools` のサブセット、[バックグラウンド実行用にフィルタリング](/docs/ja/sub-agents#available-tools)） | 親のシステムプロンプト |205| ツール定義（親から継承、または `tools` のサブセット、[バックグラウンド実行用にフィルタリング](/docs/ja/sub-agents#available-tools)） | 親のシステムプロンプト |

205 206 

206<Note>207<Note>

44 44 

45| 値 | 動作 |45| 値 | 動作 |

46| :- | :- |46| :- | :- |

47| （未設定） | ツール検索はオンです。ツール定義は遅延され、オンデマンドで検出されます。Google Cloud の Agent Platform の Claude 4.5 世代より前のモデル、非ファーストパーティ `ANTHROPIC_BASE_URL`、または Microsoft Foundry デプロイ（Azure でホストされている場合）では、事前読み込みにフォールバックします。 |47| （未設定） | ツール検索はオンです。ツール定義は遅延され、オンデマンドで検出されます。Opus 4 および Sonnet 4 より前のモデル、Opus 4.5、Sonnet 4.5、Haiku 4.5 より前の Google Cloud の Agent Platform モデル、非ファーストパーティの `ANTHROPIC_BASE_URL`、または Azure でホストされている Microsoft Foundry デプロイでは、事前読み込みにフォールバックします。 |

48| `true` | ツール検索は常にオンです。ただし、Microsoft Foundry デプロイ（Azure でホストされている場合）ではサーバー側の拒否により事前読み込みが強制され、Google Cloud の Agent Platform の Claude 4.5 世代より前のモデルでは SDK がツール定義を事前に読み込み続けます。SDK はプロキシ経由でベータヘッダーを送信し、`tool_reference` ブロックをサポートしないプロキシではリクエストが失敗します。 |48| `true` | 非ファーストパーティの `ANTHROPIC_BASE_URL` でもツール検索はオンのままです。（未設定）のその他のフォールバックは引き続き適用されます。SDK はプロキシ経由でベータヘッダーを送信し、`tool_reference` ブロックをサポートしないプロキシではリクエストが失敗します。 |

49| `auto` | ツール検索が遅延できるツール定義のトークン数をカウントし、合計をモデルのコンテキストウィンドウと比較します。合計がウィンドウの 10% に達すると、ツール検索がアクティブになります。それ以下の場合、SDK はすべてのツール定義をコンテキストに事前読み込みします。 |49| `auto` | ツール検索が遅延できるツール定義のトークン数をカウントし、合計をモデルのコンテキストウィンドウと比較します。合計がウィンドウの 10% に達すると、ツール検索がアクティブになります。それ以下の場合、SDK はすべてのツール定義をコンテキストに事前読み込みします。 |

50| `auto:N` | カスタム割合を使用した `auto` と同じです。`auto:5` はそれらの定義がコンテキストウィンドウの 5% に達するとアクティブになります。値が低いほど、より早くアクティブになります。 |50| `auto:N` | カスタム割合を使用した `auto` と同じです。`auto:5` はそれらの定義がコンテキストウィンドウの 5% に達するとアクティブになります。値が低いほど、より早くアクティブになります。 |

51| `false` | ツール検索はオフです。すべてのツール定義がすべてのターンでコンテキストに読み込まれます。 |51| `false` | ツール検索はオフです。すべてのツール定義がすべてのターンでコンテキストに読み込まれます。 |

52 52 

53[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ja/env-vars) を設定するとツール検索がオフになります。`ENABLE_TOOL_SEARCH` を自分で設定してそれを上書きすることはできません。組織は [管理設定](/docs/ja/managed-settings)を通じてツール検索をオンに保つことができます。Claude Code v2.1.227 以降で可能です。[プレリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)は、上書きが適用される場所と変数が削除する内容をカバーしています。53[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](/docs/ja/env-vars) を設定するとツール検索がオフになります。`ENABLE_TOOL_SEARCH` を自分で設定してそれを上書きすることはできません。Claude Code v2.1.227 以降では、組織は[管理設定](/docs/ja/managed-settings)を通じて、この変数が設定されている場合でもツール検索をオンに保つことができます。[HIPAA 設定が適用される](/docs/ja/hipaa-setup#check-how-developers-sign-in-and-connect)セッションではツール検索はオフになり、`ENABLE_TOOL_SEARCH` でも管理設定でも再びオンにすることはできません。[プレリリース機能を無効にする](/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities)は、上書きが適用される場所と変数が削除する内容をカバーしています。

54 54 

55ツール検索は、リモート MCP サーバーから来るか、[カスタム SDK MCP サーバー](/docs/ja/agent-sdk/custom-tools)から来るかに関わらず、すべての登録ツールに適用されます。`auto` を使用する場合、SDK はツール検索が遅延できるすべての定義をカウントして、1 つの結合された閾値に向かってカウントします。[`alwaysLoad`](/docs/ja/mcp#exempt-a-server-from-deferral)とマークされていない各 MCP ツール（任意のサーバーから）、およびオンデマンドで読み込まれる組み込みツール。SDK は Bash、Read、Edit などのコア組み込みツールを事前に読み込み、閾値に向かってカウントしません。プラグインのいずれかに含まれる [mod](/docs/ja/plugins/mods/reference#tools) も、ツールを遅延させたり事前に読み込んだりでき、それによってこのカウントが変わります。55ツール検索は、リモート MCP サーバーから来るか、[カスタム SDK MCP サーバー](/docs/ja/agent-sdk/custom-tools)から来るかに関わらず、すべての登録ツールに適用されます。`auto` を使用する場合、SDK はツール検索が遅延できるすべての定義をカウントして、1 つの結合された閾値に向かってカウントします。[`alwaysLoad`](/docs/ja/mcp#exempt-a-server-from-deferral)とマークされていない各 MCP ツール（任意のサーバーから）、およびオンデマンドで読み込まれる組み込みツール。SDK は Bash、Read、Edit などのコア組み込みツールを事前に読み込み、閾値に向かってカウントしません。プラグインのいずれかに含まれる [mod](/docs/ja/plugins/mods/reference#tools) も、ツールを遅延させたり事前に読み込んだりでき、それによってこのカウントが変わります。

56 56 

167 167 

168* **最大ツール数：** カタログ内の 10,000 個のツール168* **最大ツール数：** カタログ内の 10,000 個のツール

169* **検索結果：** デフォルトでは検索ごとに最も関連性の高い 5 つのツールを返します169* **検索結果：** デフォルトでは検索ごとに最も関連性の高い 5 つのツールを返します

170* **モデルサポート：** Claude Sonnet 4.5、Claude Haiku 4.5、Claude Opus 4.5、およびそれ以降のモデル。現在のリストについては、[API ドキュメントのモデル互換性](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/tool-search-tool#model-compatibility)を参照してください。Google Cloud の Agent Platform でも同じ最小要件が適用されます。170* **モデルサポート：** Opus 4、Sonnet 4、Haiku 4.5、およびそれ以降のモデル。Google Cloud の Agent Platform では Opus 4.5、Sonnet 4.5、Haiku 4.5、およびそれ以降のモデル。それより前のモデルでは、[ツール検索を設定する](#configure-tool-search)で説明しているとおり、SDK はツール定義を事前に読み込みます。

171 171 

172<h2 id="related-documentation">172<h2 id="related-documentation">

173 関連ドキュメント173 関連ドキュメント

908 | "malformed"908 | "malformed"

909 | "not_honoured"909 | "not_honoured"

910 >;910 >;

911 claude_code_version?: string;

911};912};

912```913```

913 914 

922 923 

923リクエストの `sdkMcpServerManifests` フィールドとレスポンスの `sdk_mcp_manifests_parked` フィールドは、[`createSdkMcpServer()`](#createsdkmcpserver) で作成したインプロセスの [SDK MCP サーバー](/docs/ja/agent-sdk/custom-tools)用です。アプリケーションがどちらのフィールドを設定したり読み取ったりすることはありません。924リクエストの `sdkMcpServerManifests` フィールドとレスポンスの `sdk_mcp_manifests_parked` フィールドは、[`createSdkMcpServer()`](#createsdkmcpserver) で作成したインプロセスの [SDK MCP サーバー](/docs/ja/agent-sdk/custom-tools)用です。アプリケーションがどちらのフィールドを設定したり読み取ったりすることはありません。

924 925 

926`claude_code_version` は、セッションのターンを実行するプロセスの Claude Code のバージョンです。これは [`SDKSystemMessage`](#sdksystemmessage) の init メッセージに含まれる値と同じであるため、最初のターンの前に CLI のバージョンを読み取ることができます。

927 

928* このフィールドには Agent SDK v0.3.296 以降が必要です。このバージョンには Claude Code v2.1.296 がバンドルされています。

929* フィールドが `undefined` で、`pathToClaudeCodeExecutable` を設定している場合は、Claude Code v2.1.296 以降を指すようにしてください。

930 

925レスポンスは常に `fast_mode_state` を報告し、何かが [fast mode](/docs/ja/fast-mode) をブロックしている場合は `fast_mode_disabled_reason` がそれと併せて理由コードを伝えるため、利用可能性を再導出する代わりに、ブロックされた状態を説明できます。どちらの動作にも Claude Code v2.1.219 以降が必要です。v2.1.219 より前は、fast mode が利用できない場合にレスポンスは `fast_mode_state` を省略し、理由が含まれることはありませんでした。理由コードとその意味については、結果メッセージの [`fast_mode_disabled_reason`](#sdkresultmessage) を参照してください。931レスポンスは常に `fast_mode_state` を報告し、何かが [fast mode](/docs/ja/fast-mode) をブロックしている場合は `fast_mode_disabled_reason` がそれと併せて理由コードを伝えるため、利用可能性を再導出する代わりに、ブロックされた状態を説明できます。どちらの動作にも Claude Code v2.1.219 以降が必要です。v2.1.219 より前は、fast mode が利用できない場合にレスポンスは `fast_mode_state` を省略し、理由が含まれることはありませんでした。理由コードとその意味については、結果メッセージの [`fast_mode_disabled_reason`](#sdkresultmessage) を参照してください。

926 932 

927成功した `initialize` の制御レスポンスのラッパーには、`pending_permission_requests` 配列も含まれます。このフィールドはレスポンスのラッパー自体にあり、上記の `SDKControlInitializeResponse` ペイロード内にはありません。各エントリは完全な `control_request` メッセージで、実行中にセッションが権限リクエストのためにストリーミングするのと同じ `{ type: "control_request", request_id, request }` の形状をしています。933成功した `initialize` の制御レスポンスのラッパーには、`pending_permission_requests` 配列も含まれます。このフィールドはレスポンスのラッパー自体にあり、上記の `SDKControlInitializeResponse` ペイロード内にはありません。各エントリは完全な `control_request` メッセージで、実行中にセッションが権限リクエストのためにストリーミングするのと同じ `{ type: "control_request", request_id, request }` の形状をしています。

1218 skills?: string[];1224 skills?: string[];

1219 initialPrompt?: string;1225 initialPrompt?: string;

1220 maxTurns?: number;1226 maxTurns?: number;

1227 autoCompactWindow?: number;

1221 background?: boolean;1228 background?: boolean;

1222 omitClaudeMd?: boolean;1229 omitClaudeMd?: boolean;

1223 memory?: "user" | "project" | "local";1230 memory?: "user" | "project" | "local";

1238| `skills` | いいえ | エージェントのコンテキストにプリロードするスキル名の配列 |1245| `skills` | いいえ | エージェントのコンテキストにプリロードするスキル名の配列 |

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

1240| `maxTurns` | いいえ | 停止するまでのエージェントの最大ターン数（API ラウンドトリップ） |1247| `maxTurns` | いいえ | 停止するまでのエージェントの最大ターン数（API ラウンドトリップ） |

1248| `autoCompactWindow` | いいえ | このエージェントがサブエージェントとして実行される場合の[自動圧縮のウィンドウ](/docs/ja/sub-agents#subagent-auto-compact-window)を、`100000` から `1000000` までのトークン数に引き下げます。TypeScript Agent SDK v0.3.296 以降が必要です |

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

1242| `omitClaudeMd` | いいえ | このエージェントがサブエージェントとして実行される場合に、ユーザー、プロジェクト、ローカルの CLAUDE.md ファイルなしで実行します。管理ポリシーファイルは引き続き読み込まれます。必要なものをすべて Agent ツールのプロンプトから受け取るエージェントに使用します。このエージェントがメインスレッドのエージェントとして実行される場合は無視されます。TypeScript Agent SDK v0.3.271 以降が必要です |1250| `omitClaudeMd` | いいえ | ユーザー、プロジェクト、ローカルの CLAUDE.md ファイルをこのエージェントの初期コンテキストから除外します。管理ポリシーファイルは引き続き読み込まれます。必要なものをすべて Agent ツールのプロンプトから受け取るエージェントに使用してください。このエージェントがメインスレッドのエージェントとして実行される場合は無視されます。TypeScript Agent SDK v0.3.271 以降が必要です |

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

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

1245| `permissionMode` | いいえ | このエージェント内でのツール実行の権限モード。適用されるタイミングは[サブエージェントの継承ルール](/docs/ja/agent-sdk/permissions#available-modes)によって決まります。[`PermissionMode`](#permissionmode) を参照してください |1253| `permissionMode` | いいえ | このエージェント内でのツール実行の権限モード。適用されるタイミングは[サブエージェントの継承ルール](/docs/ja/agent-sdk/permissions#available-modes)によって決まります。[`PermissionMode`](#permissionmode) を参照してください |

2434* `fromMode`：送信元セッションの権限クラス（`bypass` または `prompting`）で、[デスクトップアプリ](/docs/ja/desktop#work-across-sessions)など、ユーザーのセッション間でピアメッセージを中継するホストによって宣言されます。Claude Code は、受信側セッションで[受信メッセージの制御](/docs/ja/cross-session-messaging#control-inbound-messages)を適用する際にこの値を読み取ります。Agent SDK v0.3.234 以降が必要です。2442* `fromMode`：送信元セッションの権限クラス（`bypass` または `prompting`）で、[デスクトップアプリ](/docs/ja/desktop#work-across-sessions)など、ユーザーのセッション間でピアメッセージを中継するホストによって宣言されます。Claude Code は、受信側セッションで[受信メッセージの制御](/docs/ja/cross-session-messaging#control-inbound-messages)を適用する際にこの値を読み取ります。Agent SDK v0.3.234 以降が必要です。

2435* `senderTaskId`：チームメイトのタスク ID です。クロスセッションピアの場合は存在しません。2443* `senderTaskId`：チームメイトのタスク ID です。クロスセッションピアの場合は存在しません。

2436* `name`：Claude Code によって正規化された送信元の表示名です。Unicode の制御文字、書式文字、サロゲート、および行区切り文字や段落区切り文字のコードポイントを除去したうえで、前後の空白を削除し、64 コードポイントを上限として超過分を省略記号で切り詰めます。Claude Code v2.1.205 以降が必要です。2444* `name`：Claude Code によって正規化された送信元の表示名です。Unicode の制御文字、書式文字、サロゲート、および行区切り文字や段落区切り文字のコードポイントを除去したうえで、前後の空白を削除し、64 コードポイントを上限として超過分を省略記号で切り詰めます。Claude Code v2.1.205 以降が必要です。

2437* `body`：ピアエンベロープを除去してデコードしたメッセージ本文で、モデルが見る内容とバイト単位で一致します。チームメイトからのメッセージでは常に存在します。クロスセッションピアの場合は、ターンが Claude Code によって形成されたちょうど 1 つのピアエンベロープである場合にのみ存在します。メッセージテキストを再解析するのではなく、`name` と `body` を表示してください。Claude Code v2.1.205 以降が必要です。2445* `body`：ピアエンベロープを取り除いてデコードしたメッセージ本文で、モデルが見る内容とバイト単位で一致します。単一のチームメイトメッセージの場合は存在し、複数がマージされた場合は存在しません。クロスセッションピアの場合は、ターンが Claude Code によって形成されたちょうど 1 つのピアエンベロープである場合にのみ存在します。メッセージテキストを再解析するのではなく、`name` と `body` を表示してください。v2.1.299 より前は、マージされたメッセージは最初のメッセージの `body` を保持していました。Claude Code v2.1.205 以降が必要です。

2438* `fromSession`：ホストで開くことができる送信元のセッション ID で、UI から送信元セッションへリンクできるように送信元のホストによって設定されます。`from` と同様に送信元が主張する値であるため、ナビゲーション先としてのみ使用し、送信元の身元の証明として扱わないでください。Claude Code v2.1.216 以降が必要です。2446* `fromSession`：ホストで開くことができる送信元のセッション ID で、UI から送信元セッションへリンクできるように送信元のホストによって設定されます。`from` と同様に送信元が主張する値であるため、ナビゲーション先としてのみ使用し、送信元の身元の証明として扱わないでください。Claude Code v2.1.216 以降が必要です。

2439* `verifiedPeerPid`：このセッションのクロスセッションメッセージングソケットに接続したプロセスのプロセス ID です。カーネルによって検証され、ペイロードからではなく常に接続そのものから読み取られます。送信元の識別には `from` ではなくこの値を使用してください。`from` は同じユーザーの任意のプロセスによって偽装される可能性があります。Windows やソケット以外の経路での受信など、Claude Code が検証できない場合はこのフィールドは存在しないため、値が存在しないことは送信元が未検証であることを意味します。中継されたトラフィックの場合、この値はメッセージの作成者ではなく中継元を識別します。また、プロセス ID は再利用される可能性があるため、認証トークンではなく来歴情報として扱ってください。Claude Code v2.1.216 以降が必要です。2447* `verifiedPeerPid`：このセッションのクロスセッションメッセージングソケットに接続したプロセスのプロセス ID です。カーネルによって検証され、ペイロードからではなく常に接続そのものから読み取られます。送信元の識別には `from` ではなくこの値を使用してください。`from` は同じユーザーの任意のプロセスによって偽装される可能性があります。Windows やソケット以外の経路での受信など、Claude Code が検証できない場合はこのフィールドは存在しないため、値が存在しないことは送信元が未検証であることを意味します。中継されたトラフィックの場合、この値はメッセージの作成者ではなく中継元を識別します。また、プロセス ID は再利用される可能性があるため、認証トークンではなく来歴情報として扱ってください。Claude Code v2.1.216 以降が必要です。

2440 2448 

3444 offset?: number;3452 offset?: number;

3445 limit?: number;3453 limit?: number;

3446 pages?: string;3454 pages?: string;

3455 allow_large?: boolean;

3447};3456};

3448```3457```

3449 3458 

3450テキスト、画像、PDF、Jupyter ノートブックを含むローカルファイルシステムからファイルを読み取ります。PDF ページ範囲には `pages` を使用します（例：`"1-5"`）。3459テキスト、画像、PDF、Jupyter ノートブックを含むローカルファイルシステムからファイルを読み取ります。

3460 

3461* PDF ページ範囲には `pages` を使用します（例：`"1-5"`）。

3462* `allow_large` を使用すると、セッションのコンテキストウィンドウに余裕がある場合に、Claude は [通常のサイズ制限](/docs/ja/tools-reference#large-files) を超えてテキストファイルを読み取れます。Agent SDK v0.3.296 以降が必要で、これには Claude Code v2.1.296 がバンドルされています。

3451 3463 

3452PDF の場合、Claude は Read 呼び出しの `tool_result` コンテンツ内のファイルの内容を受け取ります。`pdf` [出力](#tool-output-types) を返す読み取りは、サマリー `text` ブロックの後に `document` ブロックを含みます。`parts` 出力を返す読み取りは、サマリー `text` ブロックの後に抽出されたページごとに 1 つのブロックを含みます。`image` ブロック、または Claude Code がそれを画像としてレンダリングできなかった場合はページを名前付けする `text` ブロック。Agent SDK v0.3.242 より前は、Claude Code はファイルの内容をツール結果の後の別の `user` メッセージとして配信していました。3464PDF の場合、Claude は Read 呼び出しの `tool_result` コンテンツ内のファイルの内容を受け取ります。`pdf` [出力](#tool-output-types) を返す読み取りは、サマリー `text` ブロックの後に `document` ブロックを含みます。`parts` 出力を返す読み取りは、サマリー `text` ブロックの後に抽出されたページごとに 1 つのブロックを含みます。`image` ブロック、または Claude Code がそれを画像としてレンダリングできなかった場合はページを名前付けする `text` ブロック。Agent SDK v0.3.242 より前は、Claude Code はファイルの内容をツール結果の後の別の `user` メッセージとして配信していました。

3453 3465 

270| **タスクリスト** | チームメンバーが要求して完了する共有作業項目リスト |270| **タスクリスト** | チームメンバーが要求して完了する共有作業項目リスト |

271| **メールボックス** | エージェント間の通信用メッセージングシステム |271| **メールボックス** | エージェント間の通信用メッセージングシステム |

272 272 

273各エージェントのメールボックスは `~/.claude/teams/{team-name}/inboxes/{agent-name}.json` にある JSON ファイルです。Claude Code はメールボックスファイルを読み取るときにすべてのエントリを検証します。メッセージ形式と一致しないエントリはエラーとして報告され、ファイルから削除されます。有効なメッセージは引き続き配信されます。v2.1.207 より前では、1 つの不正なメールボックスエントリが毎秒繰り返しエラーを引き起こし、ファイルを手動で削除するまでそのメールボックスの配信をブロックしていました。273各エージェントのメールボックスは `~/.claude/teams/{team-name}/inboxes/{agent-name}.json` にある JSON ファイルです。Claude Code はメールボックスファイルを読み取るときにすべてのエントリを検証します。メッセージ形式と一致しないエントリはエラーとして報告され、ファイルから削除されます。有効なメッセージは引き続き配信されます。

274 274 

275Claude Code は、メッセージがプレーンテキストであるか、プラン承認やシャットダウンリクエストなどの構造化プロトコルメッセージであるかに関わらず、受信者のメールボックスファイルへの書き込みが成功した場合にのみメッセージを送信済みとして報告します。ディスクがいっぱいであるか、メールボックスディレクトリが書き込み可能でないなど、書き込みが失敗した場合、送信エージェントはエラーを受け取り、何も送信されません。エラーメッセージと復旧手順については、[チームメンバーのインボックスへの書き込みに失敗しました](/docs/ja/errors#failed-to-write-to-a-teammate-inbox) を参照してください。275Claude Code は、メッセージがプレーンテキストであるか、プラン承認やシャットダウンリクエストなどの構造化プロトコルメッセージであるかに関わらず、受信者のメールボックスファイルへの書き込みが成功した場合にのみメッセージを送信済みとして報告します。ディスクがいっぱいであるか、メールボックスディレクトリが書き込み可能でないなど、書き込みが失敗した場合、送信エージェントはエラーを受け取り、何も送信されません。エラーメッセージと復旧手順については、[チームメンバーのインボックスへの書き込みに失敗しました](/docs/ja/errors#failed-to-write-to-a-teammate-inbox) を参照してください。

276 276 

309* **`model`**：Claude Code は、生成プロンプトが 1 つを名前で指定しない場合、どちらの表示モードでも定義の `model` を使用します。[Claude Code がチームメンバーのモデルを選択する方法](#specify-teammates-and-models) を参照してください。309* **`model`**：Claude Code は、生成プロンプトが 1 つを名前で指定しない場合、どちらの表示モードでも定義の `model` を使用します。[Claude Code がチームメンバーのモデルを選択する方法](#specify-teammates-and-models) を参照してください。

310* **`disallowedTools`**：インプロセスのチームメイトの場合、Claude Code は定義の `disallowedTools` にあるツールをチームメイトのツールセットから削除します。`SendMessage` と Claude Code が追加する Task ツールは、リストに記載されていても引き続き使用できます。310* **`disallowedTools`**：インプロセスのチームメイトの場合、Claude Code は定義の `disallowedTools` にあるツールをチームメイトのツールセットから削除します。`SendMessage` と Claude Code が追加する Task ツールは、リストに記載されていても引き続き使用できます。

311* **`effort`**：インプロセスのチームメイトの場合、Claude Code は [フロントマターの effort ルール](/docs/ja/model-config#set-the-effort-level) に従って定義の [`effort`](/docs/ja/sub-agents#supported-frontmatter-fields) を適用します。311* **`effort`**：インプロセスのチームメイトの場合、Claude Code は [フロントマターの effort ルール](/docs/ja/model-config#set-the-effort-level) に従って定義の [`effort`](/docs/ja/sub-agents#supported-frontmatter-fields) を適用します。

312* **`autoCompactWindow`**：インプロセスのチームメイトの場合、Claude Code は [そのフィールドのルール](/docs/ja/sub-agents#subagent-auto-compact-window) に従って定義の [`autoCompactWindow`](/docs/ja/sub-agents#supported-frontmatter-fields) を適用します。分割ペインのチームメイトはこのフィールドを無視します。Claude Code v2.1.296 以降が必要です。

312* **本体**：インプロセスチームメンバーの場合、Claude Code は定義の本体をデフォルトシステムプロンプトに追加の指示として追加します。分割ペインチームメンバーの場合、Claude Code はデフォルトシステムプロンプトの代わりに本体を使用します。313* **本体**：インプロセスチームメンバーの場合、Claude Code は定義の本体をデフォルトシステムプロンプトに追加の指示として追加します。分割ペインチームメンバーの場合、Claude Code はデフォルトシステムプロンプトの代わりに本体を使用します。

313* **`skills`**：Claude Code はどちらの表示モードでもチームメンバーに定義の `skills` を適用しません。チームメンバーはプロジェクトおよびユーザー設定から skills をロードします。314* **`skills`**：Claude Code はどちらの表示モードでもチームメンバーに定義の `skills` を適用しません。チームメンバーはプロジェクトおよびユーザー設定から skills をロードします。

314* **`mcpServers`**：分割ペインチームメンバーの場合、Claude Code は [そのフィールドのルール](/docs/ja/sub-agents#scope-mcp-servers-to-a-subagent) に従って定義の `mcpServers` を適用します。これは `--agent` で開始されたセッションもカバーします。インプロセスチームメンバーはフィールドを無視し、プロジェクトおよびユーザー設定から MCP サーバーをロードします。315* **`mcpServers`**：分割ペインチームメンバーの場合、Claude Code は [そのフィールドのルール](/docs/ja/sub-agents#scope-mcp-servers-to-a-subagent) に従って定義の `mcpServers` を適用します。これは `--agent` で開始されたセッションもカバーします。インプロセスチームメンバーはフィールドを無視し、プロジェクトおよびユーザー設定から MCP サーバーをロードします。

38 38 

39 まだディレクトリの[ワークスペーストラストダイアログ](/docs/ja/permissions#project-allow-rules-and-workspace-trust)を受け入れていない場合、Claude Code はエージェントビューが開く前にそれを表示します。これは `claude` が表示するのと同じダイアログです。受け入れてワークスペースの信頼を保存して続行します。拒否すると、Claude Code はエージェントビューを開かずに終了します。39 まだディレクトリの[ワークスペーストラストダイアログ](/docs/ja/permissions#project-allow-rules-and-workspace-trust)を受け入れていない場合、Claude Code はエージェントビューが開く前にそれを表示します。これは `claude` が表示するのと同じダイアログです。受け入れてワークスペースの信頼を保存して続行します。拒否すると、Claude Code はエージェントビューを開かずに終了します。

40 40 

41 エージェントビューが開き、下部に入力フィールドが表示され、セッションが開始されるとテーブルが埋まります。いつでも `Esc` を押してシェルに戻ります。`←` でセッションをバックグラウンドにして開いた場合、`Esc` はそのセッションの会話に戻ります。セッションは離れている間も実行し続け、次にエージェントビューを開いたときに再度表示されます。41 エージェントビューが開き、下部に入力フィールドが表示され、セッションが開始されるとテーブルが埋まります。`Esc` を押すとシェルに戻ります。`←` でセッションをバックグラウンドにしてエージェントビューを開いた場合、`Esc` はそのセッションの会話に戻ります。セッションは離れている間も実行し続け、次にエージェントビューを開いたときに再度表示されます。

42 </Step>42 </Step>

43 43 

44 <Step title="セッションをディスパッチする">44 <Step title="セッションをディスパッチする">

219 認証情報キャッシングと解決タイムアウト219 認証情報キャッシングと解決タイムアウト

220</h4>220</h4>

221 221 

222Claude Code は AWS デフォルト認証情報プロバイダーチェーンを 1 回解決し、解決された認証情報をメモリに保持します。認証情報の有効期限の 5 分前まで、または有効期限がない場合は 1 時間の間、それらを再利用するため、SSO でサポートされたプロファイルは認証情報の有効期間ごとに約 1 回 IAM Identity Center から認証情報をリクエストします。API からの認証情報エラーはキャッシュをクリアし、再試行は新しい認証情報を解決します。Claude Code v2.1.207 以降が必要です。222Claude Code は AWS デフォルト認証情報プロバイダーチェーンを 1 回解決し、解決された認証情報をメモリに保持します。認証情報の有効期限の 5 分前まで、または有効期限がない場合は 1 時間の間、それらを再利用するため、SSO でサポートされたプロファイルは認証情報の有効期間ごとに約 1 回 IAM Identity Center から認証情報をリクエストします。API からの認証情報エラーはキャッシュをクリアし、再試行は新しい認証情報を解決します。

223 223 

224キャッシュはこのステップの冒頭に挙げたすべての認証情報の方法をカバーしていますが、Amazon Bedrock API キーはプロバイダーチェーンを使用しないため除外されます。代わりにすべてのリクエストでチェーンを解決するには、[`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/docs/ja/env-vars) を設定してください。224キャッシュはこのステップの冒頭に挙げたすべての認証情報の方法をカバーしていますが、Amazon Bedrock API キーはプロバイダーチェーンを使用しないため除外されます。代わりにすべてのリクエストでチェーンを解決するには、[`CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1`](/docs/ja/env-vars) を設定してください。

225 225 

276 276 

277`Expiration` はオプションです。コマンドが有効な ISO 8601 `Expiration` を返すと、Claude Code はその時刻の 5 分前まで認証情報をキャッシュします。それがない場合、認証情報は 1 時間キャッシュされます。277`Expiration` はオプションです。コマンドが有効な ISO 8601 `Expiration` を返すと、Claude Code はその時刻の 5 分前まで認証情報をキャッシュします。それがない場合、認証情報は 1 時間キャッシュされます。

278 278 

279`awsCredentialExport` を `awsAuthRefresh` なしで設定する場合、Claude Code はエクスポートされた認証情報を直接使用し、スタートアップで AWS デフォルト認証情報プロバイダーチェーンを再解決しません。Claude Code v2.1.206 以降が必要です。279`awsCredentialExport` を `awsAuthRefresh` なしで設定する場合、Claude Code はエクスポートされた認証情報を直接使用し、スタートアップで AWS デフォルト認証情報プロバイダーチェーンを再解決しません。

280 280 

281<h3 id="3-configure-claude-code">281<h3 id="3-configure-claude-code">

282 3. Claude Code を設定する282 3. Claude Code を設定する

358* バックグラウンドタスクに Haiku を使用するには、`ANTHROPIC_DEFAULT_HAIKU_MODEL` をアカウントで利用可能なモデル ID に設定してください。358* バックグラウンドタスクに Haiku を使用するには、`ANTHROPIC_DEFAULT_HAIKU_MODEL` をアカウントで利用可能なモデル ID に設定してください。

359 359 

360<Warning>360<Warning>

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

362</Warning>362</Warning>

363 363 

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

365 365 

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

367 367 

188 188 

189[権限モード](/docs/ja/permission-modes)によって、送信されたコメントが到着したときに Claude が何をするかが決まります。189[権限モード](/docs/ja/permission-modes)によって、送信されたコメントが到着したときに Claude が何をするかが決まります。

190 190 

191* **Claude が自動で返信する**：権限モードで Claude が確認を求めずに返信を投稿できる場合、Claude はスレッドを読んで返信し、コメントが変更を求めている場合はアーティファクトを編集します。`Auto-replied to comment thread on Artifact: <name>` または `Auto-edited Artifact: <name> in response to a comment thread` が表示されます。191* **Claude が自動で返信する**：権限モードで Claude が確認を求めずに返信を投稿できる場合、Claude はスレッドを読んで返信します。`Auto-replied to comment thread on Artifact: <name>` が表示されます。

192* **Claude があなたを待つ**：プランモード外で、返信の投稿に承認が必要な場合、`Comments are waiting on Artifact: <name>` が表示されます。その後、Claude はスレッドを読む承認を求め、返信を投稿する承認を再度求めます。192* **Claude があなたを待つ**：プランモード外で、返信の投稿に承認が必要な場合、`Comments are waiting on Artifact: <name>` が表示されます。その後、Claude はスレッドを読む承認を求め、返信を投稿する承認を再度求めます。

193* **Claude がプランモードで一時停止する**：`Comments are waiting on Artifact: <name>` が表示され、Claude はプランモードを終了して読んで返信するよう求めるまで返信しません。193* **Claude がプランモードで一時停止する**：`Comments are waiting on Artifact: <name>` が表示され、Claude はプランモードを終了して読んで返信するよう求めるまで返信しません。

194 194 

782 782 

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

784| - | - | - |784| - | - | - |

785| `fail_closed_on_error` | いいえ | デフォルト `false`。支出強制は Postgres 停止時にフェイルオープンするため、推論は稼働し続けます。`true` に設定するとフェイルクローズになります：キャップを超えたデベロッパーはブロックされますが、ストアに到達できない場合は他のすべてのユーザーもブロックされます。[`admin:`](#admin) ブロックが必要です：支出強制は `admin` が設定されている場合にのみ実行され、`admin` ブロックなしでこれを `true` に設定するとゲートウェイは起動を拒否します。 |785| `fail_closed_on_error` | いいえ | デフォルトは `false`。Postgres の障害時には支出制限の適用はフェイルオープンになり、推論は継続します。フェイルクローズにするには `true` に設定します。上限超過の開発者はブロックされますが、ストアに到達できない場合は他の全員もブロックされます。[`admin:`](#admin) ブロックが必要です。支出制限の適用は `admin` が設定されている場合にのみ実行され、これなしでこの値を `true` に設定するとゲートウェイは起動を拒否します。 |

786 786 

787<h3 id="pricing">787<h3 id="pricing">

788 `pricing`788 `pricing`

1072 1072 

1073ゲートウェイの [テレメトリ](#telemetry) 設定は `OTEL_EXPORTER_OTLP_ENDPOINT` をプッシュするため、`telemetry.forward_to` を設定すると各インタラクティブクライアントでダイアログが表示されます。このダイアログは、侵害されたゲートウェイや悪意のあるゲートウェイからデベロッパーのマシンを保護するものであり、デベロッパーから組織を保護するものではありません。1073ゲートウェイの [テレメトリ](#telemetry) 設定は `OTEL_EXPORTER_OTLP_ENDPOINT` をプッシュするため、`telemetry.forward_to` を設定すると各インタラクティブクライアントでダイアログが表示されます。このダイアログは、侵害されたゲートウェイや悪意のあるゲートウェイからデベロッパーのマシンを保護するものであり、デベロッパーから組織を保護するものではありません。

1074 1074 

1075`claude -p`、Agent SDK のセッション、Claude Desktop の Code タブのセッションなどの [非対話型の実行](/docs/ja/server-managed-settings#security-approval-dialogs) では、ダイアログを表示できません。プッシュされた設定はその実行にのみ適用され、承認済みとして記録されないため、開発者の次の対話型セッションでは引き続きダイアログが表示されます。v2.1.207 より前は、非対話型の実行で設定が承認済みとして保存され、以降の対話型セッションでそれらについてダイアログが表示されることはありませんでした。1075`claude -p`、Agent SDK セッション、Claude Desktop の Code タブのセッションなどの[非インタラクティブ実行](/docs/ja/server-managed-settings#security-approval-dialogs)では、ダイアログを表示できません。その実行に限りプッシュされた設定を適用し、承認済みとして記録しないため、開発者の次のインタラクティブセッションでは引き続きダイアログが表示されます。

1076 1076 

1077デベロッパーが拒否した場合、Claude Code はポリシーを適用せずにそのセッションを終了します。そのため、新しいフックやダイアログが表示される env 変数を広範なポリシーにプッシュすると、マッチするすべてのデベロッパーのインタラクティブセッションでダイアログが表示されます。実行中のインタラクティブセッションでは次の 1 時間ごとのポーリング時に表示され、それ以外の場合はデベロッパーの次のインタラクティブ起動時に表示されます。1077デベロッパーが拒否した場合、Claude Code はポリシーを適用せずにそのセッションを終了します。そのため、新しいフックやダイアログが表示される env 変数を広範なポリシーにプッシュすると、マッチするすべてのデベロッパーのインタラクティブセッションでダイアログが表示されます。実行中のインタラクティブセッションでは次の 1 時間ごとのポーリング時に表示され、それ以外の場合はデベロッパーの次のインタラクティブ起動時に表示されます。

1078 1078 

167* ディレクトリは少なくとも 1 つのコミットを持つ git リポジトリである必要があります167* ディレクトリは少なくとも 1 つのコミットを持つ git リポジトリである必要があります

168* バンドルされたリポジトリは 100 MB 未満である必要があります。より大きなリポジトリは現在のブランチのみをバンドルすることにフォールバックし、その後ワーキングツリーの単一の圧縮スナップショットにフォールバックし、スナップショットがまだ大きすぎる場合のみ失敗します168* バンドルされたリポジトリは 100 MB 未満である必要があります。より大きなリポジトリは現在のブランチのみをバンドルすることにフォールバックし、その後ワーキングツリーの単一の圧縮スナップショットにフォールバックし、スナップショットがまだ大きすぎる場合のみ失敗します

169* 追跡されていないファイルは含まれません。クラウドセッションが見るべきファイルで `git add` を実行します169* 追跡されていないファイルは含まれません。クラウドセッションが見るべきファイルで `git add` を実行します

170* macOS、Linux、WSL では、Claude Code は属性ルールがファイルに適用される方法に影響する git 設定（インクルードされた設定ファイルで設定された `core.attributesFile` など）に従うことができない場合、アップロードを拒否します。[拒否メッセージ](/docs/ja/errors#the-repository-upload-cant-follow-a-git-setting)は設定と修正に名前を付けます170* macOS、Linux、WSL では、Claude Code は属性ルールがファイルに適用される方法に影響する git 設定（インクルードされた設定ファイルで設定された `core.attributesFile` など）に従うことができない場合、アップロードを拒否します。[拒否メッセージ](/docs/ja/errors#the-repository-upload-cant-follow-a-git-setting)は設定と修正方法を示します

171* バンドルから作成されたセッションは、[GitHub 接続](#github-authentication-options)がそのリポジトリへのプッシュアクセスを持つ場合にのみ、GitHub リモートにプッシュバックできます171* バンドルから作成されたセッションは、[GitHub 接続](#github-authentication-options)がそのリポジトリへのプッシュアクセスを持つ場合にのみ、GitHub リモートにプッシュバックできます

172 172 

173macOS、Linux、WSL では、アップロードには git 2.31 以降と、サポートされているチェックアウト構成も必要です。一方、ネイティブ Windows では、Claude Code はどちらのチェックも行わずにアップロードします。チェックアウトがこれらの要件を満たさない場合、Claude Code はセッションを開始しません。`Not uploading this working tree:` を含むエラーを出力し、原因と変更すべき点を示します。主な原因は次のとおりです：173macOS、Linux、WSL では、アップロードには git 2.31 以降と、サポートされているチェックアウト構成も必要です。一方、ネイティブ Windows では、Claude Code はどちらのチェックも行わずにアップロードします。チェックアウトがこれらの要件を満たさない場合、Claude Code はセッションを開始しません。`Not uploading this working tree:` を含むエラーを出力し、原因と変更すべき点を示します。主な原因は次のとおりです：

298 298 

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

300 300 

301* **`/model`、`/effort`、`/color`、`/rename`**：ターミナルピッカーまたはスライダーを開く代わりに、引数として値を渡します。例えば `/model sonnet` のように使用します。引数形式はセッションの環境で Claude Code v2.1.205 以降が必要であり、各コマンドの[利用可能性に関する注記](/docs/ja/commands#all-commands)に従います。301* **`/model`、`/effort`、`/color`、`/rename`**：ターミナルピッカーまたはスライダーを開く代わりに、引数として値を渡します。例えば `/model sonnet` のように使用します。引数形式は各コマンドの[利用可能性に関する注記](/docs/ja/commands#all-commands)に従います。

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

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

304 304 

420* **分離された仮想マシン**：各セッションは分離された Anthropic 管理 VM で実行されます。セッションが組織によってルーティングされる[セルフホスト環境](/docs/ja/self-hosted-environments)は、代わりに独自のインフラストラクチャで実行され、分離はデプロイメントの責任です420* **分離された仮想マシン**：各セッションは分離された Anthropic 管理 VM で実行されます。セッションが組織によってルーティングされる[セルフホスト環境](/docs/ja/self-hosted-environments)は、代わりに独自のインフラストラクチャで実行され、分離はデプロイメントの責任です

421* <span id="default-allowed-domains" />**ネットワークアクセス制御**：Anthropic ホスト型環境では、ネットワークアクセスはデフォルトで制限され、無効にできます。[ネットワークアクセス](/docs/ja/cloud-environments#network-access)でアクセスレベル、[デフォルト許可ドメイン](/docs/ja/cloud-environments#default-allowed-domains)、および許可リストを通過しないトラフィックを参照してください。セルフホスト型環境では、独自のネットワーク境界でセッション出力を制限します。ネットワークアクセスを無効にして実行する場合、Claude Code は Anthropic API と通信できます。これにより VM からデータが出ることを許可する可能性があります。421* <span id="default-allowed-domains" />**ネットワークアクセス制御**：Anthropic ホスト型環境では、ネットワークアクセスはデフォルトで制限され、無効にできます。[ネットワークアクセス](/docs/ja/cloud-environments#network-access)でアクセスレベル、[デフォルト許可ドメイン](/docs/ja/cloud-environments#default-allowed-domains)、および許可リストを通過しないトラフィックを参照してください。セルフホスト型環境では、独自のネットワーク境界でセッション出力を制限します。ネットワークアクセスを無効にして実行する場合、Claude Code は Anthropic API と通信できます。これにより VM からデータが出ることを許可する可能性があります。

422* **認証情報保護**：Anthropic ホスト型環境では、git 認証情報と署名キーはサンドボックスの外に留まり、プロキシはスコープ付き認証情報で認証します。セルフホスト型環境では、デプロイメントが git 認証情報を提供します；[git を設定](/docs/ja/self-hosted-environments-deploy#configure-git)を参照してください422* **認証情報保護**：Anthropic ホスト型環境では、git 認証情報と署名キーはサンドボックスの外に留まり、プロキシはスコープ付き認証情報で認証します。セルフホスト型環境では、デプロイメントが git 認証情報を提供します；[git を設定](/docs/ja/self-hosted-environments-deploy#configure-git)を参照してください

423* **ネットワークシークレット**：Anthropic ホスト型環境の Pro および Max プランでは、[クラウド環境に追加](/docs/ja/cloud-environments#add-network-secrets)したキーも同様にサンドボックスの外に留まり、セッションを離れた後に一致するリクエストに添付されます。セルフホスト型環境にはネットワークシークレットがなく、Team および Enterprise プランではまだ利用できません423* **ネットワークシークレット**：Anthropic ホスト型環境では、[クラウド環境に追加](/docs/ja/cloud-environments#add-network-secrets)したキーも同様にサンドボックスの外に留まり、セッションを離れた後に一致するリクエストに添付されます。セルフホスト型環境にはネットワークシークレットはありません

424* **セキュアな分析**：コードは PR を作成する前に分離されたセッション環境内で分析および変更されます424* **セキュアな分析**：コードは PR を作成する前に分離されたセッション環境内で分析および変更されます

425 425 

426<h2 id="troubleshooting">426<h2 id="troubleshooting">

472| メッセージ | 意味 |472| メッセージ | 意味 |

473| - | - |473| - | - |

474| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code がサードパーティプロバイダー向けに設定されています。メッセージには、`Amazon Bedrock` や `Google Vertex AI` など、設定で使用されているラベルでプロバイダー名が示されます。たとえば `CLAUDE_CODE_USE_BEDROCK` の設定を解除するなどしてそのプロバイダーの設定を削除し、Anthropic アカウントでサインインしてください（`claude auth login`）。 |474| `Cloud sessions aren't available with <provider>. They run on Anthropic's infrastructure and require an Anthropic account.` | Claude Code がサードパーティプロバイダー向けに設定されています。メッセージには、`Amazon Bedrock` や `Google Vertex AI` など、設定で使用されているラベルでプロバイダー名が示されます。たとえば `CLAUDE_CODE_USE_BEDROCK` の設定を解除するなどしてそのプロバイダーの設定を削除し、Anthropic アカウントでサインインしてください（`claude auth login`）。 |

475| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | `allow_remote_sessions` 組織ポリシーがオフになっています。 |475| `Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.` | `allow_remote_sessions` 組織ポリシーがオフになっています。[Cloud sessions are disabled by your organization's policy](/docs/ja/errors#cloud-sessions-are-disabled-by-your-organizations-policy) を参照してください。メッセージに、このセッションが使用している認証情報の名前が示されている場合は、[クラウドセッションは claude.ai のログインを使用する](/docs/ja/errors#cloud-sessions-use-your-claude-ai-login)を参照してください。 |

476| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code が組織のポリシーを取得できなかったため、クラウドセッションが許可されていると仮定せずに送信を拒否しています。ネットワーク接続を確認して再試行してください。 |476| `Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.` | Claude Code が組織のポリシーの読み込みを完了していないため、クラウドセッションが許可されていると仮定せずに送信を拒否しています。ネットワーク接続を確認して再試行してください。 |

477| `Cloud sessions aren't available:` の後に原因が続くもの | 組織のポリシーの読み込みに失敗しました。メッセージの残りの部分に失敗の内容が示されています。示された原因に対処してください。[Couldn't verify your organization's policy for cloud sessions](/docs/ja/errors#couldnt-verify-your-organizations-policy-for-cloud-sessions) を参照してください。 |

477| `Attaching to an existing cloud session is not enabled for your account.` | `-p` なしで `--cloud <session-id>` を実行しました。`claude -p "your message" --cloud <session-id>` でメッセージを送信してください。 |478| `Attaching to an existing cloud session is not enabled for your account.` | `-p` なしで `--cloud <session-id>` を実行しました。`claude -p "your message" --cloud <session-id>` でメッセージを送信してください。 |

478| `Session not found: <id>` | ID または URL が、アクセス可能なセッションと一致しません。セッションの claude.ai/code URL と照合してください。 |479| `Session not found: <id>` | ID または URL が、アクセス可能なセッションと一致しません。セッションの claude.ai/code URL と照合してください。 |

479| `cloud session <id> is archived and cannot accept new messages` | セッションはアーカイブされています。代わりに新しいセッションを開始してください。 |480| `cloud session <id> is archived and cannot accept new messages` | セッションはアーカイブされています。代わりに新しいセッションを開始してください。 |

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

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

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

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

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

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

1531 1531 

291 291 

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

293 293 

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

295 295 

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

297 297 

414 414 

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

416* プラグイン：**プロジェクト設定 > プラグイン** で追加します。各新しいクラウドスレッドに読み込まれます。リポジトリが `.claude/settings.json` で宣言するプラグインは、クラウドスレッドでは [読み込まれません](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。416* プラグイン：**プロジェクト設定 > プラグイン** で追加します。各新しいクラウドスレッドに読み込まれます。リポジトリが `.claude/settings.json` で宣言するプラグインは、クラウドスレッドでは [読み込まれません](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。

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

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

419 419 

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

435| プロジェクト指示 | Memory | [立ち上がりルール](#give-a-project-standing-context) すべての新しいスレッドが受け取ります |435| プロジェクト指示 | Memory | [立ち上がりルール](#give-a-project-standing-context) すべての新しいスレッドが受け取ります |

436| プロジェクトリポジトリ | Environment | 新しいスレッドがクローンするリポジトリ |436| プロジェクトリポジトリ | Environment | 新しいスレッドがクローンするリポジトリ |

437| クラウド環境 | Environment | 新しいスレッドが実行する [クラウド環境](#choose-an-environment-for-threads) |437| クラウド環境 | Environment | 新しいスレッドが実行する [クラウド環境](#choose-an-environment-for-threads) |

438| コネクタ | Environment | claude.ai コネクタを管理するリンク。スレッドが取得します |

439| プラグイン | Plugins | 各新しいスレッドに読み込まれるプラグイン |438| プラグイン | Plugins | 各新しいスレッドに読み込まれるプラグイン |

440| 使用量 | Usage | スレッドおよびモデル別の [トークン使用量](#usage-and-cost) |439| 使用量 | Usage | スレッドおよびモデル別の [トークン使用量](#usage-and-cost) |

441| Memory | Memory | プロジェクトの [メモリファイル](#give-a-project-standing-context) |440| Memory | Memory | プロジェクトの [メモリファイル](#give-a-project-standing-context) |

10 クラウド環境は [クラウドセッション](/docs/ja/claude-code-on-the-web) に適用されます。これは Pro、Max、Team プランで利用可能であり、[プレミアムシートまたは Chat + Claude Code シートを持つ](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan) Enterprise ユーザー向けです。10 クラウド環境は [クラウドセッション](/docs/ja/claude-code-on-the-web) に適用されます。これは Pro、Max、Team プランで利用可能であり、[プレミアムシートまたは Chat + Claude Code シートを持つ](https://support.claude.com/en/articles/11845131-use-claude-code-with-your-team-or-enterprise-plan) Enterprise ユーザー向けです。

11</Note>11</Note>

12 12 

13各 [クラウドセッション](/docs/ja/claude-code-on-the-web) はクラウド環境で実行されます。環境を設定して [ネットワークアクセス](#access-levels) を許可または拒否し、セッション用に [環境変数を設定](#set-environment-variables) し、Pro および Max プランではセッションが内容を見ずに使用できる [ネットワークシークレット](#add-network-secrets) を保存し、Claude が作業を開始する前に [セットアップスクリプト](#setup-scripts) を実行できます。13各 [クラウドセッション](/docs/ja/claude-code-on-the-web) はクラウド環境で実行されます。環境を設定して [ネットワークアクセス](#access-levels) を許可または拒否し、セッション用に [環境変数を設定](#set-environment-variables) し、セッションが内容を見ずに使用できる [ネットワークシークレット](#add-network-secrets) を保存し、Claude が作業を開始する前に [セットアップスクリプト](#setup-scripts) を実行できます。

14 14 

15同じ環境は、クラウドセッションを開始する場所に関係なく適用されます。[Desktop アプリ](/docs/ja/desktop)、[Claude モバイルアプリ](/docs/ja/mobile)、[claude.ai/code](https://claude.ai/code) のブラウザ、[`claude --cloud`](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud) を使用したターミナル、[ルーチン](/docs/ja/routines)、[Claude Tag](https://claude.com/docs/claude-tag/overview) です。これらの各サーフェスは [セルフホスト環境](/docs/ja/self-hosted-environments) にもルーティングできます。[利用可能性と制限](/docs/ja/self-hosted-environments#availability-and-limitations) は、Claude Tag セッションがセルフホスト環境で実行される場合に Claude がまだ使用できないものをカバーしています。15同じ環境は、クラウドセッションを開始する場所に関係なく適用されます。[Desktop アプリ](/docs/ja/desktop)、[Claude モバイルアプリ](/docs/ja/mobile)、[claude.ai/code](https://claude.ai/code) のブラウザ、[`claude --cloud`](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud) を使用したターミナル、[ルーチン](/docs/ja/routines)、[Claude Tag](https://claude.com/docs/claude-tag/overview) です。これらの各サーフェスは [セルフホスト環境](/docs/ja/self-hosted-environments) にもルーティングできます。[利用可能性と制限](/docs/ja/self-hosted-environments#availability-and-limitations) は、Claude Tag セッションがセルフホスト環境で実行される場合に Claude がまだ使用できないものをカバーしています。

16 16 

44 環境を設定する44 環境を設定する

45</h2>45</h2>

46 46 

47[web onboarding](/docs/ja/web-quickstart) 後に [claude.ai/code](https://claude.ai/code) で、または [Desktop app](/docs/ja/desktop#cloud-sessions) のプロンプトボックスから環境セレクターにアクセスして、環境を作成、編集、アーカイブできます。作成した環境はアカウントに個人的なものです。Owner が作成した [共有環境](#organization-shared-environments) は同じセレクターに表示されます。設定なしで利用可能な内容については、[インストール済みツール](#installed-tools) を参照してください。47[claude.ai/code](https://claude.ai/code) で新しいセッションを開始する画面のメッセージボックスの下にある環境セレクターから、環境を追加、編集、アーカイブできます。この画面にアクセスするには、[Web オンボーディング](/docs/ja/web-quickstart) を完了してください。Desktop アプリについては、[クラウドセッション](/docs/ja/desktop#cloud-sessions) を参照してください。作成した環境はアカウントに個人的なものです。Owner が作成した [共有環境](#organization-shared-environments) も、それらと並んでセレクターに表示されます。設定なしで利用可能な内容については、[インストール済みツール](#installed-tools) を参照してください。

48 

49セレクターは、新しいセッションの最初のメッセージを送信するまでしか表示されません。実行中の自分のクラウドセッションの環境を編集するには、上部のセッションタイトルの後にあるキャレットを選択し、**クラウド環境を編集** を選択します。

48 50 

49<Steps>51<Steps>

50 <Step title="環境セレクターを開く">52 <Step title="環境セレクターを開く">

51 [claude.ai/code](https://claude.ai/code) で、メッセージボックスの上の行にある現在の環境名を表示するクラウドアイコンを選択します。セレクターの設定ページや直接 URL はありません。53 新しいセッションの画面で、メッセージボックスの下の行にある最初のコントロールを選択します。

52 

53 <Frame>

54 <img src="https://mintcdn.com/claude-code/ZFId6l95856c5LSw/images/cloud-environment-selector.png?fit=max&auto=format&n=ZFId6l95856c5LSw&q=85&s=cc2813a5664519eaf5a89d793ce5af26" alt="claude.ai/code のメッセージボックスの上に開いた環境セレクター。環境名 Default を表示するクラウドボタンがメッセージボックスの上の行にあります。開いたメニューには、Download と Desktop only ラベルを持つ Local 行、Default 環境がチェックマークで選択され、ホバー時に設定ギアアイコンを表示する Cloud セクション、クラウド環境を追加オプション、セットアップ手順を含む Remote Control セクションが表示されます。" width="1672" height="682" data-path="images/cloud-environment-selector.png" />

55 </Frame>

56 </Step>54 </Step>

57 55 

58 <Step title="環境を追加または編集する">56 <Step title="環境を追加または編集する">

59 **Cloud** を選択して環境をリストします。その後、**クラウド環境を追加** を選択するか、既存の環境にホバーして右に表示される設定アイコンを選択します。57 * **環境を追加する**: メニュー下部の **新しい環境** を選択して **新しい環境** ダイアログを開きます。フォームに入力し、**環境を追加** を選択します。新しいセッションでは、追加した環境が使用されます。

58 * **環境を編集する**: **Cloud** の下でその環境の行を見つけます。**Cloud** が 1 行だけの場合は、それを選択してリストを開きます。環境が **Cloud** の下に表示されていない場合は、その見出しの下の **その他** 行を選択します。環境の行にホバーし、右側に表示される設定アイコンを選択してダイアログを開きます。

60 59 

61 ダイアログには名前、ネットワークアクセスレベル、環境変数、セットアップスクリプトが含まれます。Pro または Max プランで既存のクラウド環境を編集する場合、ダイアログには [ネットワークシークレット](#add-network-secrets) も含まれます。60 ダイアログには名前、ネットワークアクセスレベル、環境変数、セットアップスクリプトが含まれます。セッションがキーを見ることなく使用できるようにキーを保存するには、[ネットワークシークレットを追加する](#add-network-secrets) を参照してください。

62 

63 <Frame>

64 <img src="https://mintcdn.com/claude-code/ZFId6l95856c5LSw/images/cloud-environment-dialog.png?fit=max&auto=format&n=ZFId6l95856c5LSw&q=85&s=30d4478b31d1f879f7ee287ddab32505" alt="新しいクラウド環境ダイアログ。プレースホルダー Default を持つ Name フィールド、ネットワークアクセスセレクターが Trusted に設定され、ネットワークポリシーとアクセスレベルへのリンク、.env 形式プレースホルダーテキストを表示する環境変数ボックス（環境を使用する誰もが値を見ることができるという注記付き）、新しいセッションが開始され Claude Code が起動する前に実行される Bash スクリプトとして説明されるセットアップスクリプトボックス、キャンセルと環境を作成ボタン。" width="874" height="1372" data-path="images/cloud-environment-dialog.png" />

65 </Frame>

66 </Step>61 </Step>

67</Steps>62</Steps>

68 63 

91 86 

92クラウドセッションは起動時に自身でいくつかの変数も設定します。[`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/ja/claude-code-on-the-web#manage-context) の場合、セッションが設定する値はここで追加した値をオーバーライドするため、ここでそのキーを追加しても効果がありません。87クラウドセッションは起動時に自身でいくつかの変数も設定します。[`CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`](/docs/ja/claude-code-on-the-web#manage-context) の場合、セッションが設定する値はここで追加した値をオーバーライドするため、ここでそのキーを追加しても効果がありません。

93 88 

94環境を使用する誰もが値を読み取ることができます。Pro および Max プランでは、エージェントプロキシがリクエストに添付できるキーに対して [ネットワークシークレット](#add-network-secrets) を代わりに使用してください。[シークレットを取得しないリクエスト](#requests-that-never-get-the-credential) はそこにリストされています。89環境を使用する誰もが値を読み取ることができます。Anthropic ホスト型環境では、エージェントプロキシがリクエストに添付できるキーに対しては、代わりに [ネットワークシークレット](#add-network-secrets) を使用してください。[シークレットを取得しないリクエスト](#requests-that-never-get-the-credential) はそこにリストされています。

95 90 

96<span id="add-api-credentials" />91<span id="add-api-credentials" />

97 92 

101 96 

102ネットワークシークレットは、クラウド環境に保存する API キーまたはトークンで、Claude が環境内の任意のセッションからそのキーを見ることなく API を呼び出すことができます。Anthropic のエージェントプロキシは、各リクエストがセッションの VM を離れた後、リストしたホストへのリクエストにキーを追加するため、キー自体は VM の外部にとどまります。97ネットワークシークレットは、クラウド環境に保存する API キーまたはトークンで、Claude が環境内の任意のセッションからそのキーを見ることなく API を呼び出すことができます。Anthropic のエージェントプロキシは、各リクエストがセッションの VM を離れた後、リストしたホストへのリクエストにキーを追加するため、キー自体は VM の外部にとどまります。

103 98 

104ネットワークシークレットは Pro および Max プランで利用可能です。Team および Enterprise プランではまだ利用できないため、**ネットワークシークレット** セクションはこれらのプランの環境ダイアログに表示されません。99ネットワークシークレットは Pro、Max、Team、Enterprise プランで利用可能です。自分で追加できるかどうかを確認するには、[要件](#requirements) を参照してください。

105 100 

106<h4 id="requirements">101<h4 id="requirements">

107 要件102 要件

109 104 

110これらの要件によって、シークレットを追加できるかどうか、および追加後にエージェントプロキシがそれを使用できるかどうかが決まります。105これらの要件によって、シークレットを追加できるかどうか、および追加後にエージェントプロキシがそれを使用できるかどうかが決まります。

111 106 

112* **ロール**: claude.ai 組織内の組織管理者ロール107* **ロール**: Pro、Max、Team プランでは、ロールに関係なく自分の環境でシークレットを追加および削除できます。Team および Enterprise では、Owner は claude.ai 組織内で組織管理者ロールを保持し、Admin は保持しません。これにより、次のケースで表示される内容が変わります。

113 * Team および Enterprise では、Owner がそれを保持し、Admin は保持しません108 * **Enterprise での自分の環境**: 組織管理者ロールがあれば、シークレットを追加および削除できます。ない場合、**ネットワークシークレット** セクションには「Only an organization admin can add or delete network secrets」という注記の下にシークレットが一覧表示され、**シークレットを追加** ボタンや削除ボタンはありません。Owner に [共有環境](#organization-shared-environments) へのシークレットの追加を依頼し、そこでセッションを実行してください

114 * Pro および Max では、独自の組織でそれを保持します109 * **共有環境**: Owner が管理設定から [シークレットを追加および削除](#add-a-credential) します。組織管理者ロールがない場合は、環境のダイアログに **ネットワークシークレット** セクションがないため、Owner にシークレットの追加を依頼してください

110 * **Team での自分の環境**: 組織管理者ロールがない場合、**シークレットを追加** を選択すると、1 つのホストを指定する [短いフォーム](#add-a-secret-without-the-role) が開きます

115* **環境タイプ**: 既に存在する Anthropic ホスト型クラウド環境。[自己ホスト型環境](/docs/ja/self-hosted-environments) にはネットワークシークレットがありません111* **環境タイプ**: 既に存在する Anthropic ホスト型クラウド環境。[自己ホスト型環境](/docs/ja/self-hosted-environments) にはネットワークシークレットがありません

116* **API 到達可能性**: API がインターネットからの接続を受け入れます。リクエストは Anthropic のネットワークから離れるためです112* **API 到達可能性**: API がインターネットからの接続を受け入れます。リクエストは Anthropic のネットワークから離れるためです

117* **暗号化キー**: 組織が顧客管理の暗号化キーを使用する場合、ネットワークシークレットを保存できません113* **暗号化キー**: 組織が顧客管理の暗号化キーを使用する場合、ネットワークシークレットを保存できません

122 118 

123シークレットは一度に 1 つずつ追加し、追加後にシークレットを編集することはできません。シークレットのホストまたは値を変更するには、削除して再度追加します。119シークレットは一度に 1 つずつ追加し、追加後にシークレットを編集することはできません。シークレットのホストまたは値を変更するには、削除して再度追加します。

124 120 

121[共有環境](#organization-shared-environments) にシークレットを追加するには、[管理設定](https://claude.ai/admin-settings) の **クラウド環境** ページから環境を編集用に開き、**ネットワークシークレット** セクションから手順 1 を続けます。Team プランで [組織管理者ロール](#requirements) を持っていない場合は、自分の環境で手順 1 に従い、その後 [短いフォームに入力](#add-a-secret-without-the-role) します。

122 

125<Steps>123<Steps>

126 <Step title="環境のネットワークシークレットを開く">124 <Step title="環境のネットワークシークレットを開く">

127 [claude.ai/code](https://claude.ai/code) で [環境を編集用に開きます](#configure-your-environment)。**環境を編集** ダイアログで、**ネットワークシークレット** セクションを見つけます。環境に既にあるシークレットが表示され、それぞれが適用されるホストが表示されます。125 [claude.ai/code](https://claude.ai/code) で [環境を編集用に開きます](#configure-your-environment)。**環境を編集** ダイアログで、**ネットワークシークレット** セクションを見つけます。環境に既にあるシークレットが表示され、それぞれが適用されるホストが表示されます。

128 </Step>126 </Step>

129 127 

130 <Step title="シークレットを追加する">128 <Step title="シークレットを追加する">

131 **シークレットを追加** を選択してフォームに入力します。API キーがリクエストヘッダーで移動する場合はデフォルトの **認証情報タイプ**、**Bearer** を保持し、これらのフィールドに入力します。129 **シークレットを追加** を選択してフォームに入力します。API キーがリクエストヘッダーで移動する場合はデフォルトの **シークレットタイプ**、**Bearer** を保持し、これらのフィールドに入力します。

132 130 

133 * **名前**: `Internal billing API` などのシークレットのラベル131 * **名前**: `Internal billing API` などのシークレットのラベル

134 * **許可されたウェブサイト**: `api.example.com` などの API のホスト。先頭の `*.` はすべてのサブドメインと一致します132 * **許可されたウェブサイト**: `api.example.com` などの API のホスト。先頭の `*.` はすべてのサブドメインと一致します

135 * **カスタムヘッダー**: キーを運ぶヘッダーの 1 行。行は `Authorization` をヘッダーの **名前** として、`Bearer` を **プレフィックス** として開始します。キー自体を **値** として貼り付けます。`X-Api-Key` のようなベア値を取得するヘッダーの場合、名前を変更してプレフィックスをクリアします133 * **カスタムヘッダー**: キーを運ぶヘッダーの 1 行。行は `Authorization` をヘッダーの **名前** として、`Bearer` を **プレフィックス** として開始します。キー自体を **値** として貼り付けます。`X-Api-Key` のようなベア値を取得するヘッダーの場合、名前を変更してプレフィックスをクリアします

136 134 

137 別の方法で認証する API の場合、別の **認証情報タイプ** を選択します。リストは [Claude Tag](https://claude.com/docs/claude-tag/overview)（Team および Enterprise プランの Slack 統合）が [接続](https://claude.com/docs/claude-tag/admins/add-connections) に提供するものと同じです。135 別の方法で認証する API の場合、別の **シークレットタイプ** を選択します。リストは [Claude Tag](https://claude.com/docs/claude-tag/overview)（Team および Enterprise プランの Slack 統合）が [接続](https://claude.com/docs/claude-tag/admins/add-connections) に提供するものと同じです。

138 </Step>136 </Step>

139 137 

140 <Step title="シークレットを保存する">138 <Step title="シークレットを保存する">

141 **接続** を選択します。シークレットはリストにホストと共に表示され、ダイアログの **変更を保存** ボタンなしで保存されます。保存後に値を再度表示することはできません。139 **追加** を選択します。シークレットはリストにホストと共に表示され、ダイアログの **変更を保存** ボタンなしで保存されます。保存後に値を再度表示することはできません。

142 </Step>140 </Step>

143</Steps>141</Steps>

144 142 

145シークレットが機能することを確認するには、環境でセッションを開始して Claude に API を呼び出すよう依頼します。例えば `curl` を使用します。API はキーがリクエストにあるかのように応答し、キーはセッションの環境変数またはファイルに表示されません。リストがシークレットを **送信されていません** とマークしている場合、その下のメモは理由と対処方法を説明しています。ホストが正確に一致せずに重複する 2 つのシークレットはマーカーを取得せず、エージェントプロキシはそのうちの 1 つだけを送信します。143シークレットが機能することを確認するには、環境でセッションを開始して Claude に API を呼び出すよう依頼します。例えば `curl` を使用します。API はキーがリクエストにあるかのように応答し、キーはセッションの環境変数またはファイルに表示されません。リストがシークレットを **送信されていません** とマークしている場合、その下のメモは理由と対処方法を説明しています。ホストが正確に一致せずに重複する 2 つのシークレットはマーカーを取得せず、エージェントプロキシはそのうちの 1 つだけを送信します。

146 144 

145<h4 id="add-a-secret-without-the-role">

146 組織管理者ロールなしで Team プランでシークレットを追加する

147</h4>

148 

149Team プランで [組織管理者ロール](#requirements) を持っていない場合、**シークレットを追加** フォームでは 1 つのホストに対して 1 つのシークレットを指定します。環境の [**ネットワークシークレット** セクション](#add-a-credential) で **シークレットを追加** を選択し、次のフィールドに入力してから、フォームの **シークレットを追加** ボタンを選択します。

150 

151* **ホスト**: シークレットを受け取る 1 つのホスト（`api.example.com` など）。フォームは `*.` ワイルドカードを受け付けません

152* **名前**: シークレットの任意のラベル

153* **シークレットタイプ**: リクエストヘッダーで送信されるキーの場合は **トークン**、または **ユーザー名とパスワード**。トークンの場合は、キーを **値** として貼り付けます

154 

147<h4 id="which-requests-get-the-credential">155<h4 id="which-requests-get-the-credential">

148 どのリクエストがシークレットを取得するか156 どのリクエストがシークレットを取得するか

149</h4>157</h4>

175 環境をアーカイブする183 環境をアーカイブする

176</h3>184</h3>

177 185 

178独自の環境の 1 つをアーカイブするには、編集用に開いて **アーカイブ** を選択します。Owner は管理設定の **クラウド環境** ページから [共有環境](#organization-shared-environments) をアーカイブします。環境を削除することはできず、アーカイブのみできます。186自分の環境の 1 つをアーカイブするには、編集用に開いて **環境をアーカイブ** を選択し、確認します。環境が [組織と共有](#organization-shared-environments) されている場合は、代わりに Owner が [管理設定](https://claude.ai/admin-settings) の **クラウド環境** ページからアーカイブするため、自分が Owner でない場合は Owner に依頼してください。環境を削除することはできず、アーカイブのみできます。

179 187 

180アーカイブは新しいセッションに影響し、実行中のセッションには影響しません。188アーカイブは新しいセッションに影響し、実行中のセッションには影響しません。

181 189 

199 207 

200Owner は [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) で組織の [デフォルト環境](#the-default-environment) を別途選択します。208Owner は [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) で組織の [デフォルト環境](#the-default-environment) を別途選択します。

201 209 

202すべてのメンバーのセッションは共有環境でその変数を読み取るため、シークレットを含めないでください。[ネットワークシークレット](#add-network-secrets)（セッションが読み取ることができないキーを提供）は Team および Enterprise プランではまだ利用できません。210共有環境のセッションに読み取れないキーを提供するには、**クラウド環境** ページで環境を編集する際に [ネットワークシークレット](#add-network-secrets) を追加します。すべてのメンバーのセッションが変数を読み取るため、変数にシークレットを含めないでください。

203 211 

204<h3 id="set-the-environment-a-claude-tag-channel-uses">212<h3 id="set-the-environment-a-claude-tag-channel-uses">

205 Claude Tag チャネルが使用する環境を設定する213 Claude Tag チャネルが使用する環境を設定する

216 224 

217各環境は 1 つのネットワークアクセスレベルを設定します。これは、セッションが行える送信接続を制御します。デフォルトレベルの **Trusted** は、パッケージレジストリおよび他の [許可リストに登録されたドメイン](#default-allowed-domains) を許可します。**Custom** はカスタムドメインリストを使用します。225各環境は 1 つのネットワークアクセスレベルを設定します。これは、セッションが行える送信接続を制御します。デフォルトレベルの **Trusted** は、パッケージレジストリおよび他の [許可リストに登録されたドメイン](#default-allowed-domains) を許可します。**Custom** はカスタムドメインリストを使用します。

218 226 

219環境のネットワークアクセスを変更するには、[編集用に開き](#configure-your-environment)、ダイアログの **Network access** セレクターを使用します。[共有環境](#organization-shared-environments) はそこで読み取り専用で開くため、Owner は [admin settings](https://claude.ai/admin-settings) の **Cloud environments** ページからネットワークアクセスを変更します。クラウドアイコンはセレクターを開き、[The Default environment](#the-default-environment) に記載されているアプリサーフェスと [routine editor](/docs/ja/routines#environments-and-network-access) に表示されます。個人環境は claude.ai アカウント設定に別ページを持ちません。227環境のネットワークアクセスを変更するには、[編集用に開き](#configure-your-environment)、ダイアログの **Network access** セレクターを使用します。[共有環境](#organization-shared-environments) はそこで読み取り専用で開くため、Owner は [admin settings](https://claude.ai/admin-settings) の **Cloud environments** ページからネットワークアクセスを変更します。セレクターを開くコントロールは、[The Default environment](#the-default-environment) に記載されているアプリサーフェスと [routine editor](/docs/ja/routines#environments-and-network-access) に表示されます。個人環境は claude.ai アカウント設定に別ページを持ちません。

220 228 

221Anthropic ホスト環境のネットワークアクセスを変更すると、既存のセッションはセッションの [network allowlist](#access-levels) を通じて行くリクエストについて、約 1 分以内に新しい設定に従います。新しいセッションを開始する必要はありません。229Anthropic ホスト環境のネットワークアクセスを変更すると、既存のセッションはセッションの [network allowlist](#access-levels) を通じて行くリクエストについて、約 1 分以内に新しい設定に従います。新しいセッションを開始する必要はありません。

222 230 

274* **Git credentials**：VM 内の git クライアントはスコープ付き認証情報を使用し、プロキシはそれを検証して実際の GitHub トークンと交換します。282* **Git credentials**：VM 内の git クライアントはスコープ付き認証情報を使用し、プロキシはそれを検証して実際の GitHub トークンと交換します。

275* **API requests**：組み込み GitHub ツールからのリクエスト、および [`proxy-injected` placeholder](#work-with-github-issues-and-pull-requests) の下の `gh` からのリクエストは、実際の認証情報が置き換えられて送信されます。283* **API requests**：組み込み GitHub ツールからのリクエスト、および [`proxy-injected` placeholder](#work-with-github-issues-and-pull-requests) の下の `gh` からのリクエストは、実際の認証情報が置き換えられて送信されます。

276* **Push restrictions**：プロキシは、ブランチの削除と、タグなどブランチ以外のもののプッシュを拒否します。プッシュで更新できるブランチは制限しません。それを制限するには、GitHub のブランチ保護ルールまたはルールセットを使用してください。284* **Push restrictions**：プロキシは、ブランチの削除と、タグなどブランチ以外のもののプッシュを拒否します。プッシュで更新できるブランチは制限しません。それを制限するには、GitHub のブランチ保護ルールまたはルールセットを使用してください。

277* **Repository scope**：プロキシは、セッションに接続されたリポジトリに対する GitHub API リクエストを処理します。他のリポジトリに対する API リクエストは、`GitHub access to` で始まり `is not enabled for this session` を含むメッセージとともに 403 を受け取ります。285* **Repository scope**：プロキシは、セッションに接続されたリポジトリに対する GitHub API リクエストを処理します。他のリポジトリに対する API リクエストは、`GitHub access to` で始まり `is not enabled for this session` を含むメッセージとともに 403 を受け取ります。`github.com/{owner}/{repo}/archive/` または `codeload.github.com` の URL 経由で取得するソースアーカイブも、リポジトリが接続されていない場合は、パブリックリポジトリであっても同じ 403 を受け取ります。

278* **GraphQL restrictions**：プロキシは GitHub の GraphQL エンドポイントへのリクエストを、`GitHub GraphQL is not available from Claude Code sessions` で始まり REST フォールバック `gh api repos/{owner}/{repo}/...` を示すメッセージとともに 403 で拒否します。`gh pr` や `gh issue` など GraphQL を使用する `gh` サブコマンドも同じ 403 を受け取ります。制限は、提供する認証情報に関係なく、プロキシを通じたすべてのリクエストに適用されるため、設定した `GH_TOKEN` は同じ 403 を取得します。Claude はプロキシを通じて Projects v2 などの GraphQL にのみ存在する GitHub API に到達できません。286* **GraphQL restrictions**：プロキシは GitHub の GraphQL エンドポイントへのリクエストを、`GitHub GraphQL is not available from Claude Code sessions` で始まり REST フォールバック `gh api repos/{owner}/{repo}/...` を示すメッセージとともに 403 で拒否します。`gh pr` や `gh issue` など GraphQL を使用する `gh` サブコマンドも同じ 403 を受け取ります。制限は、提供する認証情報に関係なく、プロキシを通じたすべてのリクエストに適用されるため、設定した `GH_TOKEN` は同じ 403 を取得します。Claude はプロキシを通じて Projects v2 などの GraphQL にのみ存在する GitHub API に到達できません。

279 287 

280パブリックリポジトリからのコミットされたファイルは `raw.githubusercontent.com` を通じて到着し、[security proxy](#security-proxy) が代わりに処理します。そのドメインはデフォルト [Trusted list](#default-allowed-domains) にあるため、環境の [access level](#access-levels) がそれを除外しない限り、それらのファイルは到達可能なままです。288パブリックリポジトリからのコミットされたファイルは `raw.githubusercontent.com` を通じて到着し、[security proxy](#security-proxy) が代わりに処理します。そのドメインはデフォルト [Trusted list](#default-allowed-domains) にあるため、環境の [access level](#access-levels) がそれを除外しない限り、それらのファイルは到達可能なままです。

318| ユーザー設定でのみ有効なプラグイン | いいえ | ユーザースコープの `enabledPlugins` はマシンの `~/.claude/settings.json` に存在します |326| ユーザー設定でのみ有効なプラグイン | いいえ | ユーザースコープの `enabledPlugins` はマシンの `~/.claude/settings.json` に存在します |

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

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

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

322| AWS SSO のようなインタラクティブ認証 | いいえ | サポートされていません。SSO はクラウドセッションで実行できないブラウザベースのログインが必要です |330| AWS SSO のようなインタラクティブ認証 | いいえ | サポートされていません。SSO はクラウドセッションで実行できないブラウザベースのログインが必要です |

323 331 

324クラウドセッションで独自の構成を利用可能にするには、リポジトリにコミットしてください。332クラウドセッションで独自の構成を利用可能にするには、リポジトリにコミットしてください。

325 333 

326環境を使用する誰もが環境変数とセットアップスクリプトを読むことができます。ダイアログの**環境変数**の下のメモはそのことを述べており、シークレットをそこに置かないよう警告しています。Pro および Max プランでは、代わりにエージェントプロキシが添付できるキーを[ネットワークシークレット](#add-network-secrets)として保存してください。334環境を使用する誰もが環境変数とセットアップスクリプトを読むことができます。ダイアログの**環境変数**の下のメモはそのことを述べており、シークレットをそこに置かないよう警告しています。Anthropic ホスト環境では、代わりにエージェントプロキシが添付できるキーを[ネットワークシークレット](#add-network-secrets)として保存してください。

327 335 

328<h4 id="add-personal-preferences-without-committing-to-the-repo">336<h4 id="add-personal-preferences-without-committing-to-the-repo">

329 リポジトリにコミットせずに個人設定を追加する337 リポジトリにコミットせずに個人設定を追加する

155* リポジトリへの書き込み、メンテナンス、または管理者権限を持つ必要があります155* リポジトリへの書き込み、メンテナンス、または管理者権限を持つ必要があります

156* PR は開いている必要があります156* PR は開いている必要があります

157 157 

158リポジトリが組織に属し、その組織でのメンバーシップが非公開である場合（GitHub のデフォルト）、GitHub は Claude にメンバーとして識別されません。Claude はコメントに 👀 で反応する可能性がありますが、チームまたは組織のベース権限が書き込みアクセスを提供している場合でも、リポジトリに直接コラボレーターとして追加されていない限り、レビューは開始されません。これを修正するには、[組織のメンバーシップを公開](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/publicizing-or-hiding-organization-membership)するか、リポジトリ管理者にリポジトリにコラボレーターとして追加するよう依頼してください。

159 

160自動トリガーとは異なり、手動トリガーはドラフト PR で実行されます。明示的なリクエストはドラフトステータスに関係なく、今すぐレビューが必要であることを示すためです。158自動トリガーとは異なり、手動トリガーはドラフト PR で実行されます。明示的なリクエストはドラフトステータスに関係なく、今すぐレビューが必要であることを示すためです。

161 159 

162その PR でレビューが既に実行されている場合、リクエストは進行中のレビューが完了するまでキューに入ります。PR のチェック実行を通じて進捗を監視できます。160その PR でレビューが既に実行されている場合、リクエストは進行中のレビューが完了するまでキューに入ります。PR のチェック実行を通じて進捗を監視できます。

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

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

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

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

71| `/chrome` | [Claude in Chrome](/docs/ja/chrome) 設定を構成します |71| `/chrome` | [Claude in Chrome](/docs/ja/chrome) 設定を構成します |

72| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトの言語用に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み込みます。コードが `anthropic` または `@anthropic-ai/sdk` をインポートするときも自動的にアクティブになります。各サブコマンドが何をするか、および必要なバージョンについては、[Claude API プロジェクトで作業する](/docs/ja/skills#work-on-claude-api-projects)を参照してください |72| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb\|preserved-thinking-migration]` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトの言語用に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み込みます。コードが `anthropic` または `@anthropic-ai/sdk` をインポートするときも自動的にアクティブになります。各サブコマンドが何をするか、および必要なバージョンについては、[Claude API プロジェクトで作業する](/docs/ja/skills#work-on-claude-api-projects)を参照してください |

73| `/claude-in-chrome [task]` | **[Skill](/docs/ja/skills#bundled-skills).** Claude にブラウザでタスクを実行させます。ページのテスト、フォームの入力、コンソールログの読み取りなど、[Claude in Chrome](/docs/ja/chrome) を通じて。Chrome 統合がセッションで有効な場合（たとえば `claude --chrome` など）、または Claude Code が[拡張機能をインストール](/docs/ja/chrome#install-the-extension-when-claude-asks)することを提案できる場合に利用可能です |73| `/claude-in-chrome [task]` | **[Skill](/docs/ja/skills#bundled-skills).** Claude にブラウザでタスクを実行させます。ページのテスト、フォームの入力、コンソールログの読み取りなど、[Claude in Chrome](/docs/ja/chrome) を通じて。Chrome 統合がセッションで有効な場合（たとえば `claude --chrome` など）、または Claude Code が[拡張機能をインストール](/docs/ja/chrome#install-the-extension-when-claude-asks)することを提案できる場合に利用可能です |

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

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

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

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

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

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

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

92| `/exit` | CLI を終了します。アタッチされた[バックグラウンドセッション](/docs/ja/agent-view#attach-to-a-session)では、これはデタッチし、セッションは実行し続けます。エイリアス：`/quit` |92| `/exit` | CLI を終了します。アタッチされた[バックグラウンドセッション](/docs/ja/agent-view#attach-to-a-session)では、これはデタッチし、セッションは実行し続けます。エイリアス：`/quit` |

93| `/export [filename]` | 現在の会話をプレーンテキストとしてエクスポートします。ファイル名を指定すると、そのファイルに直接書き込みます。指定しない場合、クリップボードにコピーするか、ファイルに保存するためのダイアログが開きます |93| `/export [filename]` | 現在の会話をプレーンテキストとしてエクスポートします。ファイル名を指定すると、そのファイルに直接書き込みます。指定しない場合、クリップボードにコピーするか、ファイルに保存するためのダイアログが開きます |

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

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

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

97| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、1 行のツール呼び出し要約と編集 diffstats、および最終応答のみを表示します。ツール呼び出し要約はターンで起動されたサブエージェントもカウントし、完了したバックグラウンドタスク通知を 1 つのカウントに折りたたみます。選択はセッション間で永続化されます。設定で [`viewMode`](/docs/ja/settings-reference#viewmode) を設定して上書きします。[フルスクリーンレンダリング](/docs/ja/fullscreen)でのみ利用可能です。[Remote Control](/docs/ja/remote-control) クライアントから、`/focus [on\|off]` を実行して、保存された選択を変更せずに現在のセッションのみのフォーカスビューをオンまたはオフにします。これには Claude Code v2.1.281 以降が必要です。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)は独自のフォーカスビューをコマンドメニューの切り替えとして提供し、拡張機能設定として保存され、`viewMode` とは独立しています |97| `/focus` | フォーカスビューを切り替えます。最後のプロンプト、1 行のツール呼び出し要約と編集 diffstats、および最終応答のみを表示します。ツール呼び出し要約はターンで起動されたサブエージェントもカウントし、完了したバックグラウンドタスク通知を 1 つのカウントに折りたたみます。選択はセッション間で永続化されます。設定で [`viewMode`](/docs/ja/settings-reference#viewmode) を設定して上書きします。[フルスクリーンレンダリング](/docs/ja/fullscreen)でのみ利用可能です。[Remote Control](/docs/ja/remote-control) クライアントから、`/focus [on\|off]` を実行して、保存された選択を変更せずに現在のセッションのみのフォーカスビューをオンまたはオフにします。これには Claude Code v2.1.281 以降が必要です。[VS Code 拡張機能](/docs/ja/vs-code#use-the-prompt-box)は独自のフォーカスビューをコマンドメニューの切り替えとして提供し、拡張機能設定として保存され、`viewMode` とは独立しています |

111| `/login` | Anthropic アカウントにサインインします |111| `/login` | Anthropic アカウントにサインインします |

112| `/logout` | Anthropic アカウントからサインアウトします |112| `/logout` | Anthropic アカウントからサインアウトします |

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

114| `/mcp [reconnect (<server>\|all)\|enable\|disable [<server>\|all]]` | MCP サーバー接続と OAuth 認証を管理します。引数なしで実行してインタラクティブなリストを開くか、`reconnect`、`enable`、または `disable` をサーバー名または `all` とともに渡して、リストを開かずに接続状態を変更します。`reconnect all` は[失敗したサーバーまたは認証が必要なサーバーをすべて再試行](/docs/ja/mcp#retry-failed-servers-yourself)します。非対話モード（`-p`）では、引数なしで実行するとリストを開く代わりにサーバー状態のテキスト要約を出力します。Claude Code v2.1.205 以降が必要です |114| `/mcp [reconnect (<server>\|all)\|enable\|disable [<server>\|all]]` | MCP サーバー接続と OAuth 認証を管理します。引数なしで実行してインタラクティブなリストを開くか、`reconnect`、`enable`、または `disable` をサーバー名または `all` とともに渡して、リストを開かずに接続状態を変更します。`reconnect all` は[失敗したサーバーまたは認証が必要なサーバーをすべて再試行](/docs/ja/mcp#retry-failed-servers-yourself)します。非対話モード（`-p`）では、引数なしで実行するとリストを開く代わりにサーバー状態のテキスト要約を出力します |

115| `/memory` | `CLAUDE.md` ファイルを編集し、[自動メモリ](/docs/ja/memory#auto-memory)を有効または無効にし、自動メモリのエントリを表示します |115| `/memory` | `CLAUDE.md` ファイルを編集し、[自動メモリ](/docs/ja/memory#auto-memory)を有効または無効にし、自動メモリのエントリを表示します |

116| `/mobile` | Claude モバイルアプリをダウンロードするための QR コードを表示します。エイリアス：`/ios`、`/android` |116| `/mobile` | Claude モバイルアプリをダウンロードするための QR コードを表示します。エイリアス：`/ios`、`/android` |

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

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

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

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

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

134| `/remote-env` | CLI から開始するクラウドセッションのデフォルト[クラウド環境](/docs/ja/cloud-environments#select-an-environment-from-the-cli)を選択します |134| `/remote-env` | CLI から開始するクラウドセッションのデフォルト[クラウド環境](/docs/ja/cloud-environments#select-an-environment-from-the-cli)を選択します |

135| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非対話モード（`-p`）でも利用可能です。Claude Code v2.1.205 以降が必要です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字に制限します。非表示文字を削除すると名前が空になる場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さ制限には Claude Code v2.1.221 以降が必要です |135| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非対話モード（`-p`）でも利用可能です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字に制限します。非表示文字を削除すると名前が空になる場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さ制限には Claude Code v2.1.221 以降が必要です |

136| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。[バックグラウンドセッション](/docs/ja/agent-view)はピッカーに `bg` でマークされて表示されます。実行中のセッションをピッカーから、または ID または名前で再開すると、[そのセッションが開きます](/docs/ja/sessions#resume-a-running-background-session)：現在の会話はバックグラウンドに移動し、このターミナルは実行中のセッションにアタッチされます。空のプロンプトで `←` を押すとエージェントビューに戻ります。エージェントビューには離れた会話も一覧表示されます。v2.1.285 より前は、Claude Code は拒否し、`claude attach` でセッションを開くか、先にそれを停止するよう指示していました。エイリアス：`/continue` |136| `/resume [session]` | ID または名前で会話を再開するか、セッションピッカーを開きます。[バックグラウンドセッション](/docs/ja/agent-view)はピッカーに `bg` でマークされて表示されます。実行中のセッションをピッカーから、または ID または名前で再開すると、[そのセッションが開きます](/docs/ja/sessions#resume-a-running-background-session)：現在の会話はバックグラウンドに移動し、このターミナルは実行中のセッションにアタッチされます。空のプロンプトで `←` を押すとエージェントビューに戻ります。エージェントビューには離れた会話も一覧表示されます。v2.1.285 より前は、Claude Code は拒否し、`claude attach` でセッションを開くか、先にそれを停止するよう指示していました。エイリアス：`/continue` |

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

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

413 ヒント：413 ヒント：

414 414 

415 * ファイルパスは相対パスまたは絶対パスにできます415 * ファイルパスは相対パスまたは絶対パスにできます

416 * @ を入力してパス提案メニューを開き、Enter または Tab キーを押してハイライトされたパスを受け入れ、もう一度 Enter キーを押してメッセージを送信します416 * `@` を入力してパス提案メニューを開き、Enter または Tab キーを押してハイライトされたパスを受け入れ、もう一度 Enter キーを押してメッセージを送信します

417 * @ ファイル参照は、ファイルのディレクトリと親ディレクトリに `CLAUDE.md` を追加してコンテキストに含めます417 * @ ファイル参照は、ファイルのディレクトリと親ディレクトリに `CLAUDE.md` を追加してコンテキストに含めます

418 * ディレクトリ参照はコンテンツではなくファイルリストを表示します418 * ディレクトリ参照はコンテンツではなくファイルリストを表示します

419 * 単一のメッセージで複数のファイルを参照できます（例：「@file1.js and @file2.js」）419 * 単一のメッセージで複数のファイルを参照できます（例：「@file1.js and @file2.js」）

420</Tip>420</Tip>

421 421 

422`@` 参照によってメッセージにファイルの内容やディレクトリリストが含まれないようにするには、シェルまたはユーザー設定で [`CLAUDE_CODE_DISABLE_FILE_MENTIONS=1`](/docs/ja/env-vars#variables) を設定してください。その場合、Claude は参照されたパスを、ファイルツールを使って読み込むよう促すメモとともに受け取ります。この変数には Claude Code v2.1.299 以降が必要です。また、プロジェクト設定とローカル設定では Claude Code はこの変数を無視します。

423 

422***424***

423 425 

424<h3 id="run-claude-on-a-schedule">426<h3 id="run-claude-on-a-schedule">

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

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

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

1605| [Git ステータススナップショット](/docs/ja/settings-reference#includegitinstructions) | Claude Code はリポジトリから新しいものを読み込みます |1605| [Git ステータススナップショット](/docs/ja/settings-reference#includegitinstructions) | セッション開始時にスナップショットがあった場合、Claude Code はリポジトリから新しいものを読み込みます |

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

1607| `paths:` フロントマターを持つルール | Claude Code が[必要に応じて](/docs/ja/memory#path-specific-rules)再度読み込みます |1607| `paths:` フロントマターを持つルール | Claude Code が[必要に応じて](/docs/ja/memory#path-specific-rules)再度読み込みます |

1608| サブディレクトリ内のネストされた CLAUDE.md | Claude Code が[必要に応じて](/docs/ja/memory#how-claude-md-files-load)再度読み込みます |1608| サブディレクトリ内のネストされた CLAUDE.md | Claude Code が[必要に応じて](/docs/ja/memory#how-claude-md-files-load)再度読み込みます |

1622 コンテキストがいっぱいになるとき1622 コンテキストがいっぱいになるとき

1623</h2>1623</h2>

1624 1624 

1625Claude Code はコンテキストウィンドウの制限に近づくと自動的にコンパクションを実行するため、コンテキストウィンドウがいっぱいになってもセッションが終了することはありません。自動パスはタイムラインの `/compact` ステップと同じ方法で機能します。保持される内容については、[コンテキストがいっぱいになるとき](/docs/ja/how-claude-code-works#when-context-fills-up)を参照してください。1625Claude Code はコンテキストウィンドウの制限に近づくと自動的にコンテキスト圧縮を実行するため、コンテキストウィンドウがいっぱいになってもセッションが終了することはありません。自動パスはタイムラインの `/compact` ステップと同じ方法で機能します。保持される内容については、[コンテキストがいっぱいになるとき](/docs/ja/how-claude-code-works#when-context-fills-up)を参照してください。アイドル状態のまま放置した会話を Claude Code が圧縮する場合については、[アイドル時の圧縮](/docs/ja/settings-reference#idlecompaction)を参照してください。

1626 1626 

1627自動パスが実行される前に対応することもできます。1627自動パスが実行される前に対応することもできます。

1628 1628 

128* **自身の内部から呼び出されることに耐える。** Claude Code はすべてのネストされた自己生成にランチャーを適用するため、排他的リソースを取得するランチャーはそれが既に保持していることを検出する必要があります。128* **自身の内部から呼び出されることに耐える。** Claude Code はすべてのネストされた自己生成にランチャーを適用するため、排他的リソースを取得するランチャーはそれが既に保持していることを検出する必要があります。

129* **Claude Code が起動する前にターミナルに書き込まない。** `exec` の前に出力されたものはすべて、セッションが初期化前に終了した場合のクラッシュ原因として報告されます。129* **Claude Code が起動する前にターミナルに書き込まない。** `exec` の前に出力されたものはすべて、セッションが初期化前に終了した場合のクラッシュ原因として報告されます。

130* **引数の表記方法に依存しない。** フラグの値は、独立した引数（`--flag value`）として渡される場合もあれば、フラグに結合された形（`--flag=value`）で渡される場合もあります。フラグがどちらの形式を使用するかは、バージョン間で変わる可能性があります。130* **引数の表記方法に依存しない。** フラグの値は、独立した引数（`--flag value`）として渡される場合もあれば、フラグに結合された形（`--flag=value`）で渡される場合もあります。フラグがどちらの形式を使用するかは、バージョン間で変わる可能性があります。

131* **ランチャーが起動したディレクトリから `exec` を実行する。** Claude Code は起動したディレクトリで作業するため、ディレクトリを変更するランチャーは誤ったプロジェクトでセッションを開始する可能性があります。ランチャーが作業ディレクトリをリセットするネームスペースまたはサンドボックスに入る必要がある場合は、`exec` の前に、その内部で起動時のディレクトリに戻ります。

131 132 

132<h3 id="format-of-the-launcher-value">133<h3 id="format-of-the-launcher-value">

133 ランチャー値の形式134 ランチャー値の形式

170| Skill が `/skills` に表示されない | Skill ファイルがフォルダ内ではなく `.claude/skills/name.md` にある | フォルダを使用して、その中に `SKILL.md` を配置してください。`.claude/skills/name/SKILL.md` です。 |170| Skill が `/skills` に表示されない | Skill ファイルがフォルダ内ではなく `.claude/skills/name.md` にある | フォルダを使用して、その中に `SKILL.md` を配置してください。`.claude/skills/name/SKILL.md` です。 |

171| Skill が `/skills` に表示されるが Claude が呼び出さない | Skill の frontmatter に `disable-model-invocation: true` がある、またはその説明がリクエストの表現方法と一致しない | `/skills` のバッジを確認してください。「user-only」ラベルは Claude が自動的にトリガーしないことを意味します。[skill 呼び出し](/docs/ja/skills)を参照してください。 |171| Skill が `/skills` に表示されるが Claude が呼び出さない | Skill の frontmatter に `disable-model-invocation: true` がある、またはその説明がリクエストの表現方法と一致しない | `/skills` のバッジを確認してください。「user-only」ラベルは Claude が自動的にトリガーしないことを意味します。[skill 呼び出し](/docs/ja/skills)を参照してください。 |

172| サブディレクトリの `CLAUDE.md` 指示が無視されているように見える | サブディレクトリファイルはセッション開始時ではなく、オンデマンドで読み込まれます | サブディレクトリの `CLAUDE.md` を読み込むには、そのサブディレクトリ内の別のファイルを読むよう Claude に依頼してください。[サブディレクトリファイルが読み込まれるタイミング](/docs/ja/memory#how-claude-md-files-load)を参照してください。 |172| サブディレクトリの `CLAUDE.md` 指示が無視されているように見える | サブディレクトリファイルはセッション開始時ではなく、オンデマンドで読み込まれます | サブディレクトリの `CLAUDE.md` を読み込むには、そのサブディレクトリ内の別のファイルを読むよう Claude に依頼してください。[サブディレクトリファイルが読み込まれるタイミング](/docs/ja/memory#how-claude-md-files-load)を参照してください。 |

173| サブエージェントが `CLAUDE.md` 指示を無視する | 組み込みの Explore および Plan エージェントは `CLAUDE.md` をスキップします。カスタムサブエージェントは、その定義が [`omitClaudeMd`](/docs/ja/sub-agents#supported-frontmatter-fields) を設定しない限り、メイン会話と同じ方法で読み込みます | Explore または Plan の場合、委譲プロンプトで指示を再度述べてください。`omitClaudeMd` を設定するサブエージェントの場合、フィールドを削除してください。その他のカスタムサブエージェントの場合、重要な指示をエージェントファイルの本体に配置してください。これはエージェントのシステムプロンプトになります。[起動時に読み込まれるもの](/docs/ja/sub-agents#what-loads-at-startup)を参照してください。 |173| サブエージェントが `CLAUDE.md` 指示を無視する | 組み込みの Explore および Plan エージェントは起動時に `CLAUDE.md` をスキップします。カスタムサブエージェントは、その定義が [`omitClaudeMd`](/docs/ja/sub-agents#supported-frontmatter-fields) を設定しない限り、メイン会話と同じ方法で読み込みます | Explore または Plan の場合、委譲プロンプトで指示を再度述べてください。`omitClaudeMd` を設定するサブエージェントの場合、フィールドを削除してください。その他のカスタムサブエージェントの場合、重要な指示をエージェントファイルの本体に配置してください。これはエージェントのシステムプロンプトになります。[起動時に読み込まれるもの](/docs/ja/sub-agents#what-loads-at-startup)を参照してください。 |

174| クリーンアップロジックがセッション終了時に実行されない | `SessionEnd` hook が設定されていない | `settings.json` に `SessionEnd` hook を追加してください。[hook イベントリスト](/docs/ja/hooks#hook-events)を参照してください。 |174| クリーンアップロジックがセッション終了時に実行されない | `SessionEnd` hook が設定されていない | `settings.json` に `SessionEnd` hook を追加してください。[hook イベントリスト](/docs/ja/hooks#hook-events)を参照してください。 |

175| `.mcp.json` の MCP サーバーが読み込まれない | ファイルが `.claude/` の下にあるか、そのサーバーが VS Code の `mcp.json` のように、`mcpServers` ではなくトップレベルの `servers` キーの下にある | プロジェクト MCP 設定はリポジトリルートの `.mcp.json` に配置され、`.claude/` 内ではなく、`mcpServers` キーの下にサーバーがあります。[MCP 設定](/docs/ja/mcp)を参照してください。 |175| `.mcp.json` の MCP サーバーが読み込まれない | ファイルが `.claude/` の下にあるか、そのサーバーが VS Code の `mcp.json` のように、`mcpServers` ではなくトップレベルの `servers` キーの下にある | プロジェクト MCP 設定はリポジトリルートの `.mcp.json` に配置され、`.claude/` 内ではなく、`mcpServers` キーの下にサーバーがあります。[MCP 設定](/docs/ja/mcp)を参照してください。 |

176| `settings.json` の `mcpServers` の下に追加された MCP サーバーが表示されない | `settings.json` が `mcpServers` キーを読み込まない | プロジェクトサーバーをリポジトリルートの `.mcp.json` で定義するか、ユーザースコープのサーバーの場合は `claude mcp add --scope user` を実行してください。[MCP 設定](/docs/ja/mcp)を参照してください。 |176| `settings.json` の `mcpServers` の下に追加された MCP サーバーが表示されない | `settings.json` が `mcpServers` キーを読み込まない | プロジェクトサーバーをリポジトリルートの `.mcp.json` で定義するか、ユーザースコープのサーバーの場合は `claude mcp add --scope user` を実行してください。[MCP 設定](/docs/ja/mcp)を参照してください。 |

101| **Accept edits** | `acceptEdits` | Claude はファイル編集と`mkdir`、`touch`、`mv`などの一般的なファイルシステムコマンドを自動的に受け入れますが、他のターミナルコマンドの実行前には確認を求めます。ファイル変更を信頼し、より高速な反復を望む場合に使用します。 |101| **Accept edits** | `acceptEdits` | Claude はファイル編集と`mkdir`、`touch`、`mv`などの一般的なファイルシステムコマンドを自動的に受け入れますが、他のターミナルコマンドの実行前には確認を求めます。ファイル変更を信頼し、より高速な反復を望む場合に使用します。 |

102| **Plan** | `plan` | Claude はファイルを読み取り、コマンドを実行して探索してから、ソースコードを編集せずにプランを提案します。アプローチを最初に確認したい複雑なタスクに適しています。 |102| **Plan** | `plan` | Claude はファイルを読み取り、コマンドを実行して探索してから、ソースコードを編集せずにプランを提案します。アプローチを最初に確認したい複雑なタスクに適しています。 |

103| **Auto** | `auto` | Claude は日常的なプロンプトなしで実行されます。シェルコマンドやネットワークリクエストなどのアクションが実行される前に、バックグラウンド分類器がリクエストとの整合性を確認します。[auto モードが利用可能](#auto-mode-availability)な場合に表示されます。設定用の個別トグルはありません。 |103| **Auto** | `auto` | Claude は日常的なプロンプトなしで実行されます。シェルコマンドやネットワークリクエストなどのアクションが実行される前に、バックグラウンド分類器がリクエストとの整合性を確認します。[auto モードが利用可能](#auto-mode-availability)な場合に表示されます。設定用の個別トグルはありません。 |

104| **Bypass permissions** | `bypassPermissions` | Claude は権限プロンプトなしで実行されます。ただし、[どのモードも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)、Claude が[外部サイトで機能する](#browse-external-sites)場合の安全分類器、またはデスクトップアクション（[セッションをアーカイブする](#work-across-sessions)など Claude が常に最初に確認するもの）は除きます。CLI の`--dangerously-skip-permissions`と同等です。Pro および Max プランでは、Settings → Claude Code の「Allow bypass permissions mode」で有効にします。Team および Enterprise プランでは設定トグルはなく、組織ポリシーで制御されます。サンドボックス化されたコンテナまたは VM でのみ使用してください。 |104| **Bypass permissions** | `bypassPermissions` | Claude は権限プロンプトなしで実行されます。ただし、[どのモードも自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)、Claude が[外部サイトで機能する](#browse-external-sites)場合の安全分類器、またはセッションの削除などのデスクトップアクション（[セッションのアーカイブ](#work-across-sessions)は含みません）は除きます。CLI の`--dangerously-skip-permissions`と同等です。Pro および Max プランでは、Settings → Claude Code の「Allow bypass permissions mode」で有効にします。Team および Enterprise プランでは設定トグルはなく、組織ポリシーで制御されます。サンドボックス化されたコンテナまたは VM でのみ使用してください。 |

105 105 

106Code タブの以前のバージョンでは、これらのモードを Ask permissions、Auto accept edits、および Plan mode というラベルが付けられていました。106Code タブの以前のバージョンでは、これらのモードを Ask permissions、Auto accept edits、および Plan mode というラベルが付けられていました。

107 107 

131 131 

132Browser ペインは、プロジェクトから静的 HTML ファイル、PDF、画像、およびビデオを開くこともできます。チャットで HTML、PDF、画像、またはビデオパスをクリックして、Browser ペインで開きます。132Browser ペインは、プロジェクトから静的 HTML ファイル、PDF、画像、およびビデオを開くこともできます。チャットで HTML、PDF、画像、またはビデオパスをクリックして、Browser ペインで開きます。

133 133 

134<Note>

135 [SSH セッション](#ssh-sessions)では、Claude は Browser ペインのツールを利用できないため、Browser ペインでアプリを開くことができません。アプリを自分で確認するには、[そのポートをコンピューターに転送](#reach-a-port-on-the-remote-machine)します。

136</Note>

137 

134Browser ペインから、以下を実行できます：138Browser ペインから、以下を実行できます：

135 139 

136* Browser ペインで実行中のアプリと直接対話する140* Browser ペインで実行中のアプリと直接対話する

218 222 

219<Note>223<Note>

220 PR 監視には、[GitHub CLI（`gh`）](https://cli.github.com/)がマシンにインストールされ、認証されている必要があります。`gh`がインストールされていない場合、Desktop は PR を作成しようとする最初の時点でインストールを促します。224 PR 監視には、[GitHub CLI（`gh`）](https://cli.github.com/)がマシンにインストールされ、認証されている必要があります。`gh`がインストールされていない場合、Desktop は PR を作成しようとする最初の時点でインストールを促します。

225 

226 [SSH セッション](#ssh-sessions)では、Claude はリモートマシン上でブランチをプッシュし、`gh pr create` を実行するため、**Create PR** をクリックする前にリモートマシンで `git` と `gh` をセットアップしてください。SSH セッションでは Desktop がインストールを促さないため、`gh` はリモートマシンに自分でインストールしてください。その後、リモートマシンで `git push` が機能すること、および `gh auth status` がログイン済みであると報告することを確認してください。

221</Note>227</Note>

222 228 

223<h2 id="arrange-your-workspace">229<h2 id="arrange-your-workspace">

453 459 

454Claude Code はセッション間で 4 つの安全動作を適用します：460Claude Code はセッション間で 4 つの安全動作を適用します：

455 461 

456* セッションをアーカイブする前に、Claude はまずユーザーに確認します。Auto および Bypass 権限を含むすべての権限モードで承認カードが表示されます。462* Claude がセッションをアーカイブする前に承認カードが表示されます。ただし、auto モードと Bypass permissions モードでは、Claude は承認カードなしでセッションをアーカイブできます。確認を求められるようにするには、Manual に切り替えてください。

457* このサーフェスを通じて、Claude はスケジュールタスクの実行など、誰も見ていないセッションからクロスセッションメッセージを送信できず、そのようなセッションにメッセージを配信することもできません。463* このサーフェスを通じて、Claude はスケジュールタスクの実行など、誰も見ていないセッションからクロスセッションメッセージを送信できず、そのようなセッションにメッセージを配信することもできません。

458* Claude Code は、受信セッションが[クロスセッションメッセージング](/docs/ja/cross-session-messaging#availability)自体を持たない場合でも、このサーフェスからの各メッセージを受信セッションの[インバウンドコントロール](/docs/ja/cross-session-messaging#control-inbound-messages)に対してチェックします。受信セッションで[`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound)を`refuse`に設定した場合、Claude Code はこのサーフェスからのメッセージをドロップします。Claude Code は拒否を Claude デスクトップアプリに報告します。v2.1.234 より前では、Claude Code はこのサーフェスからクロスセッションメッセージングを持たない受信セッションへのすべてのメッセージをドロップしました。464* Claude Code は、受信セッションが[クロスセッションメッセージング](/docs/ja/cross-session-messaging#availability)自体を持たない場合でも、このサーフェスからの各メッセージを受信セッションの[インバウンドコントロール](/docs/ja/cross-session-messaging#control-inbound-messages)に対してチェックします。受信セッションで[`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound)を`refuse`に設定した場合、Claude Code はこのサーフェスからのメッセージをドロップします。Claude Code は拒否を Claude デスクトップアプリに報告します。v2.1.234 より前では、Claude Code はこのサーフェスからクロスセッションメッセージングを持たない受信セッションへのすべてのメッセージをドロップしました。

459* Claude Code は各受信メッセージを引用して送信元のセッションを明示し、Claude はメッセージに基づいて行動する際も受信セッション自体の権限設定に従います。465* Claude Code は各受信メッセージを引用して送信元のセッションを明示し、Claude はメッセージに基づいて行動する際も受信セッション自体の権限設定に従います。

546 552 

547[スキル](/docs/ja/skills)は Claude ができることを拡張します。Claude は関連する場合に自動的にロードするか、直接呼び出すことができます：プロンプトボックスで `/` を入力するか、**+**ボタンをクリックして**Slash commands**を選択して、利用可能なものを参照します。これには [組み込みコマンド](/docs/ja/commands)、[カスタムスキル](/docs/ja/skills#create-your-first-skill)、コードベースからのプロジェクトスキル、および [インストール済みプラグイン](/docs/ja/plugins/install)からのスキルが含まれます。1 つを選択すると、入力フィールドで強調表示されます。その後にタスクを入力して、通常どおり送信します。553[スキル](/docs/ja/skills)は Claude ができることを拡張します。Claude は関連する場合に自動的にロードするか、直接呼び出すことができます：プロンプトボックスで `/` を入力するか、**+**ボタンをクリックして**Slash commands**を選択して、利用可能なものを参照します。これには [組み込みコマンド](/docs/ja/commands)、[カスタムスキル](/docs/ja/skills#create-your-first-skill)、コードベースからのプロジェクトスキル、および [インストール済みプラグイン](/docs/ja/plugins/install)からのスキルが含まれます。1 つを選択すると、入力フィールドで強調表示されます。その後にタスクを入力して、通常どおり送信します。

548 554 

549Claude が作業中でも、他のメッセージと同じようにコマンドを送信でき、ターンが終了するとセッションはアイドル状態に戻ります。v2.1.206 より前では、ターン中に送信されたコマンドはセッションを実行中として表示したままにし、その後に送信したメッセージは配信されませんでした。555Claude が作業中でも、他のメッセージと同じようにコマンドを送信でき、ターンが終了するとセッションはアイドル状態に戻ります。

550 556 

551ローカルセッションは `~/.claude/skills/` からパーソナルスキルをロードします。[SSH](#ssh-sessions) セッションは、マシンからではなく、リモートホストのホームディレクトリから `~/.claude/skills/` を読み取ります。557ローカルセッションは `~/.claude/skills/` からパーソナルスキルをロードします。[SSH](#ssh-sessions) セッションは、マシンからではなく、リモートホストのホームディレクトリから `~/.claude/skills/` を読み取ります。

552 558 

693 699 

694* **`true`**：Claude は自動的に空きポートを見つけて使用します。ほとんどの dev サーバーに適しています。700* **`true`**：Claude は自動的に空きポートを見つけて使用します。ほとんどの dev サーバーに適しています。

695* **`false`**：Claude はエラーで失敗します。OAuth コールバックまたは CORS 許可リストなど、サーバーが特定のポートを使用する必要がある場合に使用します。701* **`false`**：Claude はエラーで失敗します。OAuth コールバックまたは CORS 許可リストなど、サーバーが特定のポートを使用する必要がある場合に使用します。

696* **設定されていない（デフォルト）**：Claude はサーバーがそのポートを必要とするかどうかを尋ねてから、答えを保存します。702* **設定されていない（デフォルト）**：`true` の場合と同様に、サーバーには次の空きポートが割り当てられます。ただし、以下の 1 つのケースは例外です。Claude Desktop v2.37337.0 より前では、代わりに Claude がサーバーにそのポートが必要かどうかを尋ね、回答を `launch.json` に保存します。

697 703 

698Claude が別のポートを選択すると、割り当てられたポートを `PORT` 環境変数を通じてサーバーに渡します。704優先ポートが使用中で `autoPort` が設定されていない場合、以下の条件がすべて当てはまると、サーバーは停止したままになります：

705 

706* `npm`、`yarn`、`pnpm`、または `bun` のスクリプトを通じてサーバーを起動している。

707* 優先ポートがそのスクリプトにハードコードされている、または Claude がスクリプトを検査できない。

708* `runtimeArgs` でポートを渡していない。

709 

710その場合は、ポートを解放するか、ハードコードされた値を削除するか、スクリプトに合わせて `port` を変更します。代わりに `"autoPort": true` を設定する方法は、`PORT` を読み取るスクリプトでのみ機能します。

711 

712サーバーが `PORT` 環境変数からポートを読み取るようにしてください。この環境変数には割り当てられたポートが格納されます。Claude がサーバーを別のポートに移動する場合、`runtimeArgs` 内の `--port` または `-p` の値もそれに合わせて書き換えます。

699 713 

700<h4 id="examples">714<h4 id="examples">

701 例715 例

785 ローカルセッション799 ローカルセッション

786</h3>800</h3>

787 801 

788デスクトップアプリは常にシェル環境全体を継承するわけではありません。macOS では、Dock または Finder からアプリを起動すると、`~/.zshrc` または `~/.bashrc` などのシェルプロファイルを読み取り、`PATH` と固定された Claude Code 変数セットを抽出しますが、そこでエクスポートする他の変数は取得されません。Windows では、アプリはユーザーおよびシステム環境変数を継承しますが、PowerShell プロファイルは読み取りません。802デスクトップアプリは常にシェル環境全体を継承するわけではありません。macOS では、Dock または Finder からアプリを起動すると、`~/.zshrc` または `~/.bashrc` などのシェルプロファイルを読み取り、Claude Code に `PATH` と固定された Claude Code 変数セットを渡しますが、そこでエクスポートする他の変数は渡しません。Windows では、アプリはユーザーおよびシステム環境変数を継承しますが、PowerShell プロファイルは読み取りません。

789 803 

790ローカルセッションと dev サーバーの環境変数を設定するには、プロンプトボックスの環境ドロップダウンを開き、**Local** にマウスを合わせて、ギアアイコンをクリックしてローカル環境エディタを開きます。ここで保存する変数は、マシンに暗号化されて保存され、開始するすべてのローカルセッションとプレビューサーバーに適用されます。また、`~/.claude/settings.json` ファイルの `env` キーに変数を追加することもできます。ただし、これらは Claude セッションにのみ到達し、dev サーバーには到達しません。サポートされている変数の完全なリストについては、[環境変数](/docs/ja/env-vars)を参照してください。804ローカルセッションと dev サーバーの環境変数を設定するには、プロンプトボックスの環境ドロップダウンを開き、**Local** にマウスを合わせて、ギアアイコンをクリックしてローカル環境エディタを開きます。ここで保存する変数は、マシンに暗号化されて保存され、開始するすべてのローカルセッションとプレビューサーバーに適用されます。また、`~/.claude/settings.json` ファイルの `env` キーに変数を追加することもできます。ただし、これらは Claude セッションにのみ到達し、dev サーバーには到達しません。サポートされている変数の完全なリストについては、[環境変数](/docs/ja/env-vars)を参照してください。

791 805 

840 854 

841Linux または macOS のリモートマシンには、サポートされているプロセッサ、SFTP を備えた SSH サーバー、`noexec` でマウントされていないインストールフォルダ、動作するシェル、およびネットワークアクセスが必要です。接続する前に、またはログイン後に接続が失敗した場合に、各要件を確認してください：855Linux または macOS のリモートマシンには、サポートされているプロセッサ、SFTP を備えた SSH サーバー、`noexec` でマウントされていないインストールフォルダ、動作するシェル、およびネットワークアクセスが必要です。接続する前に、またはログイン後に接続が失敗した場合に、各要件を確認してください：

842 856 

843* **システム**：x86\_64 または arm64 プロセッサ。マシンは Claude Code の[システム要件](/docs/ja/setup#system-requirements)も満たす必要があります。857* **システム**：x86\_64 または arm64 プロセッサ。マシンは Claude Code の[システム要件](/docs/ja/setup#system-requirements)も満たす必要があります。Linux では、Claude Code には glibc 2.17 以降、または musl が必要です。マシンがどちらを使用しているかを確認するには、そのマシンで `ldd --version` を実行します。Alpine Linux などの musl ベースのディストリビューションでは、[Claude Code が必要とするパッケージ](/docs/ja/setup#alpine-linux-and-musl-based-distributions)もインストールしてください。

844* **SFTP**：SSH サーバーが SFTP サブシステムを提供している必要があります。これは `sshd_config` の `Subsystem sftp` 行で有効になります。確認するには、コンピューターのターミナルで `sftp` を使用して同じホストとポートに接続します。正常に動作しているサーバーでは `sftp>` プロンプトが表示されます。858* **SFTP**：SSH サーバーが SFTP サブシステムを提供している必要があります。これは `sshd_config` の `Subsystem sftp` 行で有効になります。確認するには、コンピューターのターミナルで `sftp` を使用して同じホストとポートに接続します。正常に動作しているサーバーでは `sftp>` プロンプトが表示されます。

845* **接続あたりのセッション数**：macOS と Linux の Desktop は、1 つの SSH 接続で複数のセッションを開きます。サーバーの `sshd_config` で `MaxSessions 1` が設定されている場合は、OpenSSH のデフォルトである 10 などに引き上げてください。859* **接続あたりのセッション数**：macOS と Linux の Desktop は、1 つの SSH 接続で複数のセッションを開きます。サーバーの `sshd_config` で `MaxSessions 1` が設定されている場合は、OpenSSH のデフォルトである 10 などに引き上げてください。

846* **インストールフォルダ**：Desktop は、ホームディレクトリの `~/.claude/remote/` の下にヘルパープログラムと Claude Code をインストールします。そこからそれらを実行するため、そのフォルダを `noexec` でマウントされたファイルシステム上に置くことはできません。接続する各ユーザーのホームディレクトリに約 1 GB のディスク容量を確保してください。860* **インストールフォルダ**：Desktop は、ホームディレクトリの `~/.claude/remote/` の下にヘルパープログラムと Claude Code をインストールします。そこからそれらを実行するため、そのフォルダを `noexec` でマウントされたファイルシステム上に置くことはできません。接続する各ユーザーのホームディレクトリに約 1 GB のディスク容量を確保してください。そのフォルダに含まれる内容については、[リモートマシン上のファイルとプロセス](#files-and-processes-on-the-remote-machine)を参照してください。

847* **シェル**：リモートマシン上のアカウントに設定されているシェルは、Bash、Zsh、`sh` と同様に、SSH 経由で送信されたコマンドを実行できる必要があります861* **シェル**：リモートマシン上のアカウントに設定されているシェルは、Bash、Zsh、`sh` と同様に、SSH 経由で送信されたコマンドを実行できる必要があります

848* **ネットワーク**：Claude Code はリモートマシンで実行され、そこからネットワークリクエストを行うため、マシンには [Claude Code が必要とするネットワークアクセス](/docs/ja/network-config#network-access-requirements)が必要です。マシンが Claude Code をダウンロードできない場合、Desktop はコンピューター上でダウンロードしてアップロードします。Claude Code のその他のリクエストは引き続きリモートマシンから送信されます。862* **ネットワーク**：Claude Code はリモートマシンで実行され、そこからネットワークリクエストを行うため、マシンには [Claude Code が必要とするネットワークアクセス](/docs/ja/network-config#network-access-requirements)が必要です。マシンが Claude Code をダウンロードできない場合、Desktop はコンピューター上でダウンロードしてアップロードします。Claude Code のその他のリクエストは引き続きリモートマシンから送信されます。

849 863 

878 892 

879**SSH host** フィールドに `devbox` と入力します。893**SSH host** フィールドに `devbox` と入力します。

880 894 

895<h5 id="use-variables-from-your-shell-in-a-proxycommand">

896 `ProxyCommand` でシェルの変数を使用する

897</h5>

898 

899`ProxyCommand` または `Match exec` コマンドで独自の環境変数を使用するには、`~/.zshrc` などのシェル起動ファイルでその変数をエクスポートしてから、Desktop を終了して再度開きます。Desktop は起動時にログインシェルがエクスポートする内容を読み取り、終了するまでその値を保持します。

900 

901これには Claude Desktop v2.37337.0 以降と、`-0` を受け付ける `env` コマンドが必要です。これはコンピューターのターミナルで `env -0` を実行して確認できます。

902 

881<h5 id="raise-the-ssh-connection-timeout">903<h5 id="raise-the-ssh-connection-timeout">

882 SSH 接続のタイムアウトを延長する904 SSH 接続のタイムアウトを延長する

883</h5>905</h5>

894 916 

895`ssh` はホストに対して最初に見つかった値を使用するため、このエントリは `ConnectTimeout` を設定する `Host *` エントリよりも上に配置してください。確認するには、コンピューターのターミナルで `ssh -G devbox` を実行します。その出力には `connecttimeout 120` が含まれます。値を変更した後は、Desktop を終了して再度開いてください。917`ssh` はホストに対して最初に見つかった値を使用するため、このエントリは `ConnectTimeout` を設定する `Host *` エントリよりも上に配置してください。確認するには、コンピューターのターミナルで `ssh -G devbox` を実行します。その出力には `connecttimeout 120` が含まれます。値を変更した後は、Desktop を終了して再度開いてください。

896 918 

919<h5 id="forwarding-settings-that-desktop-leaves-off">

920 Desktop がオフにする転送設定

921</h5>

922 

923リモートマシンへの接続では、SSH 設定でオンになっている場合でも、Desktop は `ForwardAgent`、`ForwardX11`、`LocalForward`、`RemoteForward`、`DynamicForward`、`Tunnel` をオフのままにします。[ターミナル](#run-commands-in-the-terminal)や `!` コマンドでは、Desktop がそれらの設定に従う別の `ssh` を起動することがあるため、転送設定は[一部の場合にのみ](#limits-while-desktop-is-disconnected)適用されると考えてください。

924 

925* **リモートマシン上のポートに接続するには**：[自分で転送します](#reach-a-port-on-the-remote-machine)

926* **リモートマシンから自分の鍵を使用するには**：`git push` 用など、リモートマシン自体に認証情報を設定します

927 

928Desktop が SSH エージェントやポートを転送しないようにするには、コンピューターのターミナルで `ssh -G devbox` を実行します。次に、出力された `hostname` と `user` の値を使用して、`ssh -G -o HostName=devbox.internal.example.com -l alice devbox` のように、Desktop が実行しうる形でもう一度実行します。2 回目の出力には、1 回目ではスキップされる `Match` ブロックの設定が表示されることがあります。

929 

930両方の出力で、`no` 以外の値を示す `forwardagent` 行と、`localforward`、`remoteforward`、または `dynamicforward` で始まる行を探します。見つかった場合は、その設定を SSH 設定から削除してください。`ProxyCommand` が `ssh` で接続するホストについても同様に行ってください。

931 

932<h4 id="reach-a-port-on-the-remote-machine">

933 リモートマシン上のポートに接続する

934</h4>

935 

936ポート 3000 の dev サーバーなど、リモートマシンで実行されているサーバーを開くには、ポートを自分で転送します。コンピューターのターミナルで、`-L` と接続先のホスト（`devbox` など）を指定して `ssh` を実行します：

937 

938```bash theme={null}

939ssh -N -L 3000:localhost:3000 devbox

940```

941 

942接続で **SSH port** または **SSH key (optional)** を入力した場合は、同じ値で `-p` または `-i` を追加します。そのコマンドを実行したままにし、コンピューターのブラウザで `http://localhost:3000` を開くと、リモートマシンのポート 3000 に接続できます。`ssh` が `open failed: administratively prohibited` と出力した場合は、マシンの管理者に TCP 転送を許可するよう依頼してください。TCP 転送は SSH サーバーの `sshd_config` の `AllowTcpForwarding` で制御されます。

943 

897<h4 id="windows-remote-machines">944<h4 id="windows-remote-machines">

898 Windows リモートマシン945 Windows リモートマシン

899</h4>946</h4>

925Claude Code は、Desktop がリモートマシンにインストールするバックグラウンドヘルパーの下でプロセスとして実行されるため、実行を続けるのに SSH 接続は必要ありません。このセクションで説明する動作には Claude Desktop v2.31226.0 以降が必要です。972Claude Code は、Desktop がリモートマシンにインストールするバックグラウンドヘルパーの下でプロセスとして実行されるため、実行を続けるのに SSH 接続は必要ありません。このセクションで説明する動作には Claude Desktop v2.31226.0 以降が必要です。

926 973 

927<Warning>974<Warning>

928 Claude アカウントで Desktop にサインインしている場合、タスクが一晩中実行されることを当てにしないでください。Desktop は、Desktop が実行中かつ接続中の間のみタスクのサインインを更新するため、切断後にタスクのサインインの期限が切れ、タスクが停止することがあります。切断時に残っている時間は状況によって異なります。975 Claude アカウントで Desktop にサインインしている場合、タスクが一晩中実行されることを当てにしないでください。Desktop は、Desktop が実行中かつ接続中の間のみタスクのサインインを更新するため、切断後にタスクのサインインの期限が切れ、タスクが停止することがあります。切断時に残っている時間は状況によって異なり、数分しかない場合もあります。

929 976 

930 それまでに行われた作業はリモートマシンに残り、戻ったときにメッセージを送信して続行できます。977 それまでに行われた作業はリモートマシンに残り、戻ったときにメッセージを送信して続行できます。

931 978 

1076 1123 

1077このフィールドには Claude Desktop v1.44121.0 以降が必要です。組織がセッションで使用できるフォルダを制限している場合、Desktop はこのフィールドを非表示にし、worktree をプロジェクト内に作成します。1124このフィールドには Claude Desktop v1.44121.0 以降が必要です。組織がセッションで使用できるフォルダを制限している場合、Desktop はこのフィールドを非表示にし、worktree をプロジェクト内に作成します。

1078 1125 

1126<h4 id="files-and-processes-on-the-remote-machine">

1127 リモートマシン上のファイルとプロセス

1128</h4>

1129 

1130Desktop は、Linux または macOS のリモートマシンに接続する各ユーザーのホームディレクトリの `~/.claude/remote/` の下に、ヘルパープログラムと Claude Code をインストールします。ヘルパーはどのネットワークポートもリッスンしませんが、Claude Code と、MCP サーバーや開発サーバーなど Claude Code が起動するプログラムはリッスンすることがあります。

1131 

1132| フォルダ | 内容 |

1133| - | - |

1134| `~/.claude/remote/srv/` | ヘルパー（バージョンごとに 1 つのフォルダ） |

1135| `~/.claude/remote/ccd-cli/` | Claude Code（バージョンごとに 1 つのファイル） |

1136| `~/.claude/remote/run/` | ソケットやログなど、ヘルパーのランタイムファイル（接続するコンピューターごとに 1 つのフォルダ） |

1137| `~/.claude/remote/plugins/` | Desktop がユーザーのコンピューターからコピーするプラグイン |

1138| [`~/.claude/uploads/`](/docs/ja/claude-directory#clear-local-data) | ユーザーがメッセージに添付するファイル（セッションごとに 1 つのフォルダ） |

1139 

11401 人のユーザーのプロセスを一覧表示するには、リモートマシン上でそのユーザーとして `pgrep -fl "$HOME/.claude/remote/"` を実行するか、`$HOME` の代わりにそのユーザーのホームディレクトリを指定して実行します：

1141 

1142* **ヘルパー**：接続するコンピューターごとに 1 つ以上の `server` プロセス

1143* **Claude Code**：ヘルパーがユーザーのセッションのために起動するプロセス。それぞれ `2.1.295-…` のように、バージョンにちなんだ名前のファイルから起動されます

1144 

1145Desktop は、ユーザーの SSH 接続を通じて、`~/.claude/remote/run/` の下にあるヘルパーのフォルダ内の Unix ソケット `rpc.sock` を経由してヘルパーに到達します。ソケットのモードは 600、そのフォルダのモードは 700 であるため、root を除き、マシン上の他のユーザーはそのソケットに接続できません。

1146 

1147ヘルパーが自動的に停止する場合については、[Desktop の切断中の制限](#limits-while-desktop-is-disconnected)を参照してください。

1148 

11491 人のユーザーのヘルパーと Claude Code を削除するには：

1150 

1151<Steps>

1152 <Step title="Desktop を終了する">

1153 ユーザーが接続する各コンピューターで Desktop を終了します。Desktop は次回接続時に両方のプログラムを再度インストールし、自動的に再接続することがあります。

1154 </Step>

1155 

1156 <Step title="プロセスを終了する">

1157 リモートマシンにそのユーザーとしてログインし、[`pgrep`](#files-and-processes-on-the-remote-machine) が一覧表示する各プロセス ID を指定して `kill` を実行します。

1158 </Step>

1159 

1160 <Step title="フォルダを削除する">

1161 `~/.claude/remote/` を削除します。`~/.claude/` と `~/.claude.json` にある Claude Code 自体のファイルを削除するには、[設定ファイルを削除する](/docs/ja/setup#remove-configuration-files)を参照してください。

1162 </Step>

1163</Steps>

1164 

1165<h5 id="end-one-session’s-process">

1166 1 つのセッションのプロセスを終了する

1167</h5>

1168 

11691 つのセッションの Claude Code プロセスを終了するには、Desktop がリモートマシンに接続している間に、Desktop で[セッションをアーカイブ](#work-in-parallel-with-sessions)します。プロセスは、タスクの完了後も、Desktop を終了した後も実行を続けます。

1170 

1171worktree を持つセッションをアーカイブする前に、[セッションで並行作業する](#work-in-parallel-with-sessions)を参照してください。

1172 

1173<h5 id="see-who-connected-to-the-remote-machine">

1174 リモートマシンに接続したユーザーを確認する

1175</h5>

1176 

1177リモートマシンに誰が接続したかを確認するには、そのマシン上の SSH サーバーのログを読みます。ログでは、Desktop からのログインはターミナルからのログインと同じように表示されます。macOS または Linux の Desktop では、エントリはセッションごとではなく、Desktop が接続するたびに記録されます。

1178 

1179<h4 id="use-mcp-servers-set-up-on-the-remote-machine">

1180 リモートマシンで設定した MCP サーバーを使用する

1181</h4>

1182 

1183SSH セッションで `~/.claude.json` またはプロジェクトの `.mcp.json` の [MCP サーバー](/docs/ja/mcp)を使用するには、リモートマシン上のそれらのファイルで設定します。Claude Code はそれらの stdio サーバーをリモートマシンで起動するため、それらのサーバーが実行するコマンドをリモートマシンにインストールしてください。`claude_desktop_config.json` のサーバーについては、[Desktop の切断中の制限](#limits-while-desktop-is-disconnected)を参照してください。

1184 

1079<h4 id="open-an-ssh-session-from-a-link">1185<h4 id="open-an-ssh-session-from-a-link">

1080 リンクから SSH セッションを開く1186 リンクから SSH セッションを開く

1081</h4>1187</h4>

1207* **Cowork**：どのキーも [Cowork](https://claude.com/docs/cowork/overview) セッションや Cowork のスケジュールタスクには適用されません1313* **Cowork**：どのキーも [Cowork](https://claude.com/docs/cowork/overview) セッションや Cowork のスケジュールタスクには適用されません

1208* **クラウドセッション**：どのキーも[クラウドセッション](#cloud-sessions)を利用できるかどうかを変更しません。クラウドセッションをオフにするには、[Admin console controls](#admin-console-controls) の **Cloud sessions** 設定を使用します。1314* **クラウドセッション**：どのキーも[クラウドセッション](#cloud-sessions)を利用できるかどうかを変更しません。クラウドセッションをオフにするには、[Admin console controls](#admin-console-controls) の **Cloud sessions** 設定を使用します。

1209 1315 

1210この例を応用する場合は、ホスト名と Desktop のバージョンを確認してください：1316この例を応用する場合は、ホスト名、Desktop のバージョン、およびファイルの権限を確認してください：

1211 1317 

1212* **ホスト名**：`sshHostAllowlist` のパターンが、`user@` を除いた各 `sshConfigs` エントリのホスト名と一致することを確認してください。一致しない場合、開発者はその接続に接続できません。Desktop がホスト名を照合する方法については、[ユーザーが接続できる SSH ホストを制限する](#restrict-which-ssh-hosts-users-can-connect-to)を参照してください。1318* **ホスト名**：`sshHostAllowlist` のパターンが、`user@` を除いた各 `sshConfigs` エントリのホスト名と一致することを確認してください。一致しない場合、開発者はその接続に接続できません。Desktop がホスト名を照合する方法については、[ユーザーが接続できる SSH ホストを制限する](#restrict-which-ssh-hosts-users-can-connect-to)を参照してください。

1213* **バージョン**：`disableDesktopLocalSessions` には Claude Desktop v1.37937.0 以降が必要です1319* **バージョン**：`disableDesktopLocalSessions` には Claude Desktop v1.37937.0 以降が必要です

1320* **ファイルの権限**：コンピューター上の各開発者のアカウントが管理設定ファイルを読み取れることを確認してください。アカウントが読み取れないファイル内のキーは Desktop によって適用されず、Claude Code も[それらのキーなしで起動します](/docs/ja/managed-settings#find-entries-claude-code-dropped)。

1214 1321 

12153 つのキーは、配信する[管理ソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)のうち最上位のもの 1 つにまとめて記述してください。[サーバー管理設定](/docs/ja/server-managed-settings)を配信する場合は、各コンピューターの最上位の MDM ポリシーまたは管理設定ファイルにも 3 つのキーのコピーを保持してください。Desktop は起動時にサーバー管理設定を取得し、取得が成功するまではコンピューター上のコピーが適用されます。13223 つのキーは、配信する[管理ソース](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)のうち最上位のもの 1 つにまとめて記述してください。[サーバー管理設定](/docs/ja/server-managed-settings)を配信する場合は、各コンピューターの最上位の MDM ポリシーまたは管理設定ファイルにも 3 つのキーのコピーを保持してください。Desktop は起動時にサーバー管理設定を取得し、取得が成功するまではコンピューター上のコピーが適用されます。

1216 1323 

1558 1665 

1559MCP サーバートグルが応答しない場合、または Windows でサーバーが接続に失敗する場合、サーバーが設定で正しく設定されていることを確認し、アプリを再起動し、Task Manager でサーバープロセスが実行されていることを確認し、接続エラーについてサーバーログを確認します。1666MCP サーバートグルが応答しない場合、または Windows でサーバーが接続に失敗する場合、サーバーが設定で正しく設定されていることを確認し、アプリを再起動し、Task Manager でサーバープロセスが実行されていることを確認し、接続エラーについてサーバーログを確認します。

1560 1667 

1668<h3 id="ssh-connection-fails-after-you-log-in">

1669 ログイン後に SSH 接続が失敗する

1670</h3>

1671 

1672カードのタイトル、またはエラーメッセージの末尾にあるコードをこの表で探し、最後の列の指示に従ってください。メッセージを確認するには、失敗カードで **View details** を選択します。

1673 

1674| カードのタイトル | コード | 対処方法 |

1675| - | - | - |

1676| `<host>'s SSH server has SFTP turned off` | `[SFTP_UNAVAILABLE]` | [リモートマシンの要件](#remote-machine-requirements-for-ssh-sessions)で説明されているとおり、サーバーの `sshd_config` で SFTP をオンにします |

1677| `SFTP doesn't start on <host>` | `[SFTP_NOT_STARTED]` | コンピューターのターミナルで `sftp` を使用して同じホストに接続し、何が起動を妨げているかを確認してから、Desktop のメッセージに示されている設定とファイルを確認します |

1678| `<host> allows too few SSH sessions per connection` | `[SESSION_LIMIT]` | サーバーの `sshd_config` で `MaxSessions` を引き上げます（例：OpenSSH のデフォルトである 10） |

1679| `<host> is out of disk space` | `[ENOSPC]` または `[EDQUOT]` | リモートマシンのホームディレクトリまたは `/tmp` で空き容量またはクォータを確保します |

1680| `This computer is out of disk space` | `[ENOSPC]` または `[EDQUOT]`（`Couldn't prepare the deploy locally` で始まるメッセージ内） | コンピューターの空き容量を確保します |

1681| `Claude Code won't start on <host>` | `[CLI_UNRESPONSIVE]` | 1 分待ってから、もう一度試してください。失敗が続く場合は、メッセージに示されているコマンドをリモートマシンで実行し、そこで Claude Code が応答するかどうかを確認します。 |

1682 

1683その他のメッセージについては、[リモートマシンの要件](#remote-machine-requirements-for-ssh-sessions)を確認してください。

1684 

1561<h3 id="app-won’t-quit">1685<h3 id="app-won’t-quit">

1562 アプリが終了しない1686 アプリが終了しない

1563</h3>1687</h3>

268| `CLAUDE_CODE_DISABLE_FAST_MODE` | `1` に設定すると、[fast モード](/docs/ja/fast-mode)を無効にします |268| `CLAUDE_CODE_DISABLE_FAST_MODE` | `1` に設定すると、[fast モード](/docs/ja/fast-mode)を無効にします |

269| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | `1` に設定すると、「How is Claude doing?」というセッション品質アンケートを無効にします。`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合も、`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` で再度オプトインしない限り、アンケートは無効になります。完全に無効にする代わりにサンプルレートを設定するには、[`feedbackSurveyRate`](/docs/ja/settings-reference#feedbacksurveyrate) 設定を使用します。[セッション品質アンケート](/docs/ja/data-usage#session-quality-surveys)を参照してください |269| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | `1` に設定すると、「How is Claude doing?」というセッション品質アンケートを無効にします。`DISABLE_TELEMETRY`、`DO_NOT_TRACK`、または `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が設定されている場合も、`CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` で再度オプトインしない限り、アンケートは無効になります。完全に無効にする代わりにサンプルレートを設定するには、[`feedbackSurveyRate`](/docs/ja/settings-reference#feedbacksurveyrate) 設定を使用します。[セッション品質アンケート](/docs/ja/data-usage#session-quality-surveys)を参照してください |

270| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | `1` に設定すると、ファイルの[チェックポイント機能](/docs/ja/checkpointing)を無効にします。`/rewind` コマンドでコードの変更を復元できなくなります。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定を上書きします |270| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | `1` に設定すると、ファイルの[チェックポイント機能](/docs/ja/checkpointing)を無効にします。`/rewind` コマンドでコードの変更を復元できなくなります。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定を上書きします |

271| `CLAUDE_CODE_DISABLE_FILE_MENTIONS` | `1` に設定すると、Claude Code がファイルとディレクトリの [`@` メンション](/docs/ja/common-workflows#reference-files-and-directories)を展開しないようにします。代わりに Claude は、ファイルツールを使って読み取るよう指示するメモとともに、メンションされたパスを受け取ります。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます。Claude Code v2.1.299 以降が必要です |

271| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | `1` に設定すると、組み込みのコミットおよび PR ワークフローの指示と git ステータスのスナップショットを Claude のコンテキストから削除します。独自の git ワークフロースキルを使用する場合に便利です。設定すると、[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定より優先されます |272| `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS` | `1` に設定すると、組み込みのコミットおよび PR ワークフローの指示と git ステータスのスナップショットを Claude のコンテキストから削除します。独自の git ワークフロースキルを使用する場合に便利です。設定すると、[`includeGitInstructions`](/docs/ja/settings-reference#includegitinstructions) 設定より優先されます |

272| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | `1` に設定すると、`bash -c 'rm -rf ~'` のように `-c` でシェルに渡されるスクリプトを、Claude Code が[クリティカルパス](/docs/ja/permission-modes#removals-inside-nested-commands-and-inline-scripts)の削除について読み取らないようにします。Claude Code はそれらのスクリプト内のシェル変数と位置パラメーターの対象は引き続きチェックし、その他のクリティカルパスのチェックも引き続き実行されます。Claude Code は設定の `env` ブロックを通じて配信されたコピーを無視するため、Claude Code を起動する環境で設定してください。Claude Code v2.1.288 以降が必要です |273| `CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT` | `1` に設定すると、`bash -c 'rm -rf ~'` のように `-c` でシェルに渡されるスクリプトを、Claude Code が[クリティカルパス](/docs/ja/permission-modes#removals-inside-nested-commands-and-inline-scripts)の削除について読み取らないようにします。Claude Code はそれらのスクリプト内のシェル変数と位置パラメーターの対象は引き続きチェックし、その他のクリティカルパスのチェックも引き続き実行されます。Claude Code は設定の `env` ブロックを通じて配信されたコピーを無視するため、Claude Code を起動する環境で設定してください。Claude Code v2.1.288 以降が必要です |

273| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | `1` に設定すると、Anthropic API で Opus 4 と Opus 4.1 が現在の Opus バージョンに自動的に再マッピングされるのを防ぎます。意図的に古いモデルを固定したい場合に使用します。再マッピングは Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry では実行されません |274| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | `1` に設定すると、Anthropic API で Opus 4 と Opus 4.1 が現在の Opus バージョンに自動的に再マッピングされるのを防ぎます。意図的に古いモデルを固定したい場合に使用します。再マッピングは Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry では実行されません |

328| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 拡張機能への接続に使用するホストアドレスを上書きします。デフォルトでは、Claude Code は WSL から Windows へのルーティングを含め、正しいアドレスを自動検出します |329| `CLAUDE_CODE_IDE_HOST_OVERRIDE` | IDE 拡張機能への接続に使用するホストアドレスを上書きします。デフォルトでは、Claude Code は WSL から Windows へのルーティングを含め、正しいアドレスを自動検出します |

329| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | `1` に設定すると、IDE 拡張機能の自動インストールをスキップします。[`autoInstallIdeExtension`](/docs/ja/settings-reference#autoinstallideextension) を `false` に設定するのと同等です |330| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | `1` に設定すると、IDE 拡張機能の自動インストールをスキップします。[`autoInstallIdeExtension`](/docs/ja/settings-reference#autoinstallideextension) を `false` に設定するのと同等です |

330| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | `1` に設定すると、接続時の IDE ロックファイルエントリの検証をスキップします。IDE が実行中にもかかわらず、自動接続で IDE が見つからない場合に使用します |331| `CLAUDE_CODE_IDE_SKIP_VALID_CHECK` | `1` に設定すると、接続時の IDE ロックファイルエントリの検証をスキップします。IDE が実行中にもかかわらず、自動接続で IDE が見つからない場合に使用します |

332| `CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS` | [アイドル時のコンテキスト圧縮](/docs/ja/settings-reference#idlecompaction)が会話に適用されるコンテキストサイズ（トークン数）（デフォルト: `200000`）。正の整数を受け付け、それ以外は無視されます。`100000` 未満の値は、最小しきい値である `100000` に引き上げられます。アイドル時の圧縮は、条件を満たす会話ではデフォルトでオンです。オフにするには、`idleCompaction` を `false` に設定してください。Claude Code v2.1.290 以降が必要です |

331| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent ツールが新たな生成を拒否するまでに、1 つのセッションで同時に実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数（デフォルト: 20）。正の整数を数字のみで受け付けます。それ以外の値は無視されるため、この変数で上限を調整することはできますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |333| `CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS` | Agent ツールが新たな生成を拒否するまでに、1 つのセッションで同時に実行できる [サブエージェント](/docs/ja/sub-agents#concurrent-subagent-limit) の数（デフォルト: 20）。正の整数を数字のみで受け付けます。それ以外の値は無視されるため、この変数で上限を調整することはできますが、無効にすることはできません。Claude Code v2.1.217 以降が必要です |

332| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルについて想定するコンテキストウィンドウのサイズを上書きします。v2.1.193 以降、適用方法は Claude Code がモデル ID をどのように解決するかによって異なります。[ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。`ANTHROPIC_BASE_URL` を介してルーティングするモデルのコンテキストウィンドウが、その名前に対応する組み込みのサイズと一致しない場合に使用します |334| `CLAUDE_CODE_MAX_CONTEXT_TOKENS` | Claude Code がアクティブなモデルについて想定するコンテキストウィンドウのサイズを上書きします。v2.1.193 以降、適用方法は Claude Code がモデル ID をどのように解決するかによって異なります。[ゲートウェイまたはカスタムモデル ID のウィンドウを修正する](/docs/ja/model-config#correct-the-window-for-a-gateway-or-custom-model-id) を参照してください。`ANTHROPIC_BASE_URL` を介してルーティングするモデルのコンテキストウィンドウが、その名前に対応する組み込みのサイズと一致しない場合に使用します |

333| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code がモデルに送信する、各 MCP ツールの説明および各 MCP サーバーの指示の最大長（文字数）（デフォルト: 2048）。Claude Code は [それより長いテキストを切り詰めます](/docs/ja/mcp#for-mcp-server-authors)。正の整数を数字のみで受け付けます。それ以外の値は無視され、デフォルトが適用されます。Claude Code v2.1.280 以降が必要です |335| `CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH` | Claude Code がモデルに送信する、各 MCP ツールの説明と各 MCP サーバーの指示の最大長（文字数）。設定した値は、両方の [デフォルトの制限](/docs/ja/mcp#for-mcp-server-authors)（4096、および Claude がツール検索を通じて読み込むツールの説明については 16384）を置き換えます。Claude Code はそれより長いテキストを切り詰めます。数字のみの正の整数を受け付けます。それ以外は無視され、デフォルトが適用されます。Claude Code v2.1.280 以降が必要です |

334| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトと上限はモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。モデルの上限を超える値は、Claude Code によって上限まで引き下げられます。Claude Code が既知のモデルに解決できないモデル ID の場合、デフォルトは 32000、上限は 128000 です。この値を増やすと、[自動圧縮](/docs/ja/costs#reduce-token-usage) が発生するまでに利用できる実質的なコンテキストウィンドウが小さくなります |336| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | ほとんどのリクエストの最大出力トークン数を設定します。デフォルトと上限はモデルによって異なります。[最大出力トークン](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison) を参照してください。モデルの上限を超える値は、Claude Code によって上限まで引き下げられます。Claude Code が既知のモデルに解決できないモデル ID の場合、デフォルトは 32000、上限は 128000 です。この値を増やすと、[自動圧縮](/docs/ja/costs#reduce-token-usage) が発生するまでに利用できる実質的なコンテキストウィンドウが小さくなります |

335| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数を上書きします（デフォルト: 10）。v2.1.186 以降は上限が 15 です。v2.1.199 以降は、`CLAUDE_CODE_RETRY_WATCHDOG` によってデフォルトが引き上げられ、上限が撤廃されます。より長い障害を待ち続ける必要がある無人セッションでは、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定してください |337| `CLAUDE_CODE_MAX_RETRIES` | 失敗した API リクエストを再試行する回数を上書きします（デフォルト: 10）。v2.1.186 以降は上限が 15 です。v2.1.199 以降は、`CLAUDE_CODE_RETRY_WATCHDOG` によってデフォルトが引き上げられ、上限が撤廃されます。より長い障害を待ち続ける必要がある無人セッションでは、代わりに `CLAUDE_CODE_RETRY_WATCHDOG` を設定してください |

336| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削除され、現在は何も行いません。以前は、1 つのセッションで Claude が Agent ツールで生成できる [サブエージェント](/docs/ja/sub-agents) の総数を制限していました（デフォルト: 200）。上限を超えて生成しようとすると `Subagent spawn limit reached` で失敗していました。[同時実行サブエージェントの制限](/docs/ja/sub-agents#concurrent-subagent-limit) と [深さの制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は引き続き適用されます |338| `CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION` | v2.1.224 で削除され、現在は何も行いません。以前は、1 つのセッションで Claude が Agent ツールで生成できる [サブエージェント](/docs/ja/sub-agents) の総数を制限していました（デフォルト: 200）。上限を超えて生成しようとすると `Subagent spawn limit reached` で失敗していました。[同時実行サブエージェントの制限](/docs/ja/sub-agents#concurrent-subagent-limit) と [深さの制限](/docs/ja/sub-agents#let-subagents-spawn-their-own-subagents) は引き続き適用されます |

359| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的な OpenTelemetry ヘッダーを更新する間隔（ミリ秒）（デフォルト: 1740000 / 29 分）。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers) を参照してください |361| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | 動的な OpenTelemetry ヘッダーを更新する間隔（ミリ秒）（デフォルト: 1740000 / 29 分）。[動的ヘッダー](/docs/ja/monitoring-usage#dynamic-headers) を参照してください |

360| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | シャットダウン時に OpenTelemetry エクスポーターが完了するまでのタイムアウト（ミリ秒）（デフォルト: 2000）。終了時にメトリクスが失われる場合は値を増やしてください。[モニタリング](/docs/ja/monitoring-usage) を参照してください |362| `CLAUDE_CODE_OTEL_SHUTDOWN_TIMEOUT_MS` | シャットダウン時に OpenTelemetry エクスポーターが完了するまでのタイムアウト（ミリ秒）（デフォルト: 2000）。終了時にメトリクスが失われる場合は値を増やしてください。[モニタリング](/docs/ja/monitoring-usage) を参照してください |

361| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | API が `529` 過負荷エラーで拒否したリクエストの [自動再試行](/docs/ja/errors#tune-retry-behavior) の間の指数バックオフの開始遅延（ミリ秒）。デフォルトの 500 の代わりに使用されます。API の容量が逼迫しているときに、より長い時間枠に再試行を分散させるには値を増やしてください。500 から 32000 までの整数のミリ秒を数字のみで指定します。Claude Code はそれ以外の値を未設定として扱います。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.292 以降が必要です |363| `CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS` | API が `529` 過負荷エラーで拒否したリクエストの [自動再試行](/docs/ja/errors#tune-retry-behavior) の間の指数バックオフの開始遅延（ミリ秒）。デフォルトの 500 の代わりに使用されます。API の容量が逼迫しているときに、より長い時間枠に再試行を分散させるには値を増やしてください。500 から 32000 までの整数のミリ秒を数字のみで指定します。Claude Code はそれ以外の値を未設定として扱います。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.292 以降が必要です |

364| `CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS` | API が `529` overloaded エラーで拒否したリクエストの[自動再試行](/docs/ja/errors#tune-retry-behavior)間の指数バックオフの上限（ミリ秒）。デフォルトの 32000 の代わりに使用されます。API が容量の上限に達しているときに、後の再試行の間隔を広げ続けるには値を引き上げてください。32000 から 64000 までの整数のミリ秒を数字のみで指定します。それ以外の値は未設定として扱われます。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.296 以降が必要です |

362| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | `1` に設定すると、新しいバージョンが利用可能になったときに、Claude Code がパッケージマネージャーのアップグレードコマンドをバックグラウンドで実行できるようにします。Homebrew および WinGet でのインストールに適用されます。その他のパッケージマネージャーでは、引き続きアップグレードコマンドが実行されずに表示されます。[自動更新](/docs/ja/setup#auto-updates) を参照してください |365| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | `1` に設定すると、新しいバージョンが利用可能になったときに、Claude Code がパッケージマネージャーのアップグレードコマンドをバックグラウンドで実行できるようにします。Homebrew および WinGet でのインストールに適用されます。その他のパッケージマネージャーでは、引き続きアップグレードコマンドが実行されずに表示されます。[自動更新](/docs/ja/setup#auto-updates) を参照してください |

363| `CLAUDE_CODE_PERFORCE_MODE` | `1` に設定すると、Perforce 対応の書き込み保護を有効にします。設定すると、対象ファイルに所有者の書き込みビットがない場合、Edit、Write、NotebookEdit は `p4 edit <file>` のヒントを表示して失敗します。Perforce は、同期されたファイルを `p4 edit` で開くまでこのビットをクリアします。これにより、Claude Code が Perforce の変更追跡をバイパスすることを防ぎます |366| `CLAUDE_CODE_PERFORCE_MODE` | `1` に設定すると、Perforce 対応の書き込み保護を有効にします。設定すると、対象ファイルに所有者の書き込みビットがない場合、Edit、Write、NotebookEdit は `p4 edit <file>` のヒントを表示して失敗します。Perforce は、同期されたファイルを `p4 edit` で開くまでこのビットをクリアします。これにより、Claude Code が Perforce の変更追跡をバイパスすることを防ぎます |

364| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | プラグインのルートディレクトリを上書きします。名前に反して、これはキャッシュ自体ではなく親ディレクトリを設定します。マーケットプレイスとプラグインキャッシュは、このパスの下のサブディレクトリに配置されます。デフォルトは `~/.claude/plugins` です |367| `CLAUDE_CODE_PLUGIN_CACHE_DIR` | プラグインのルートディレクトリを上書きします。名前に反して、これはキャッシュ自体ではなく親ディレクトリを設定します。マーケットプレイスとプラグインキャッシュは、このパスの下のサブディレクトリに配置されます。デフォルトは `~/.claude/plugins` です |

380| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/docs/ja/claude-code-on-the-web) で、現在のセッションの ID に自動的に設定されます。これを読み取って、セッションのトランスクリプトへのリンクを作成できます。[出力をセッションにリンクする](/docs/ja/cloud-environments#link-output-back-to-the-session) を参照してください |383| `CLAUDE_CODE_REMOTE_SESSION_ID` | [クラウドセッション](/docs/ja/claude-code-on-the-web) で、現在のセッションの ID に自動的に設定されます。これを読み取って、セッションのトランスクリプトへのリンクを作成できます。[出力をセッションにリンクする](/docs/ja/cloud-environments#link-output-back-to-the-session) を参照してください |

381| `CLAUDE_CODE_RESTRICTED` | `1` に設定すると、[`--restricted`](/docs/ja/cli-reference#cli-flags) を渡した場合と同様に、制限モードでセッションを開始します。Claude Code は設定ファイルの `env` ブロック内のこの変数を無視します。Claude Code v2.1.248 以降が必要です |384| `CLAUDE_CODE_RESTRICTED` | `1` に設定すると、[`--restricted`](/docs/ja/cli-reference#cli-flags) を渡した場合と同様に、制限モードでセッションを開始します。Claude Code は設定ファイルの `env` ブロック内のこの変数を無視します。Claude Code v2.1.248 以降が必要です |

382| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | `1` に設定すると、前のセッションがターンの途中で終了した場合に自動的に再開します。SDK モードで使用され、SDK がプロンプトを再送信しなくてもモデルが続行できるようにします。これをオフにするには、変数を未設定にするか `0` に設定してください。VS Code のチャットパネルについては、[再読み込み後に会話を続ける](/docs/ja/vs-code#continue-conversations-after-a-reload) を参照してください |385| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` | `1` に設定すると、前のセッションがターンの途中で終了した場合に自動的に再開します。SDK モードで使用され、SDK がプロンプトを再送信しなくてもモデルが続行できるようにします。これをオフにするには、変数を未設定にするか `0` に設定してください。VS Code のチャットパネルについては、[再読み込み後に会話を続ける](/docs/ja/vs-code#continue-conversations-after-a-reload) を参照してください |

383| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | ターンの途中で終了したセッションが再開時に自動的に続行するための、トランスクリプトの最後のメッセージの最大経過時間（ミリ秒）。最後のメッセージがこの上限より古い場合、Claude Code は `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` による自動再開とその `CLAUDE_CODE_RESUME_PROMPT` 継続メッセージをスキップし、セッションはアイドル状態で開始されるため、ユーザーが明示的に続行します。未設定または `0` の場合は上限なしを意味します。ただし、最後のリクエストが API エラーで失敗したターンは、そのエラーの発生から 6 時間未満の間のみ再開されます。正の値は、そうしたターンを含むすべてのターンに上限を設けます。負の値や数値でない値の場合は 1 時間の上限が適用されます。長時間実行されるエージェントの起動スクリプトでこれを設定すると、古いトランスクリプトに対する再起動で古いプロンプトが再実行されるのを防げます。対話セッションから会話を引き継いだ [エージェントビュー](/docs/ja/agent-view) セッションがクラッシュして再起動する場合、Claude Code は自身で 1 時間の上限を設定します。Claude Code v2.1.211 以降が必要です |386| `CLAUDE_CODE_RESUME_INTERRUPTED_TURN_MAX_AGE_MS` | ターンの途中で終了したセッションが再開時に自動的に続行されるための、最後のトランスクリプトメッセージの最大経過時間（ミリ秒）。最後のメッセージがこの上限より古い場合、Claude Code は `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` による自動再開とその `CLAUDE_CODE_RESUME_PROMPT` 継続メッセージをスキップし、セッションはアイドル状態で開始するため、ユーザーが明示的に続行します。未設定または `0` の場合は上限がありませんが、API エラーで終了したターンなど、一部のターンは最後のメッセージから 6 時間以内の場合にのみ再開されます。正の値は、それらを含むすべてのターンに上限を設定します。負の値または数値以外の値では 1 時間の上限が適用されます。長時間実行されるエージェントの起動スクリプトでこれを設定すると、古いトランスクリプトに対して再起動しても古いプロンプトが再実行されないようにできます。対話セッションから会話を引き継いだ [エージェントビュー](/docs/ja/agent-view) セッションがクラッシュして再起動する際には、Claude Code 自身が 1 時間の上限を設定します。Claude Code v2.1.211 以降が必要です |

384| `CLAUDE_CODE_RESUME_PROMPT` | `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` が中断されたターンをプロンプトの再送信なしで続行する場合、または `-p` で [遅延されたツール呼び出し](/docs/ja/hooks#defer-a-tool-call-for-later) を再開する場合に、Claude Code が Claude に送信する継続メッセージを上書きします。デフォルトは `Continue from where you left off.` です。空の文字列を指定するとデフォルトが使用されます |387| `CLAUDE_CODE_RESUME_PROMPT` | `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` が中断されたターンをプロンプトの再送信なしで続行する場合、または `-p` で [遅延されたツール呼び出し](/docs/ja/hooks#defer-a-tool-call-for-later) を再開する場合に、Claude Code が Claude に送信する継続メッセージを上書きします。デフォルトは `Continue from where you left off.` です。空の文字列を指定するとデフォルトが使用されます |

385| `CLAUDE_CODE_RETRY_WATCHDOG` | 評価ハーネス、CI ジョブ、リモートワーカーなどの無人セッションでは `1` に設定します。`429` および `529` の容量エラーを、`CLAUDE_CODE_MAX_RETRIES` 回の試行後に失敗させるのではなく、無期限に再試行します。標準速度のリクエストが、支出制限や使用クレジットの枯渇を報告する `429` を受け取った場合、それがスケジュールに従ってリセットされる [ゲートウェイの支出上限](/docs/ja/errors#spend-limit-reached) によるものであっても、Claude Code は直ちに失敗します。v2.1.239 より前は、ウォッチドッグはこれらを無期限に再試行していました。fast mode のリクエストについては、[レート制限の処理](/docs/ja/fast-mode#handle-rate-limits) を参照してください。ウォッチドッグは試行の間に最大 5 分、またはレスポンスにレート制限のリセット時刻が含まれている場合は制限がリセットされるまでバックオフするため、使用制限に達したセッションは残りの時間枠が過ぎるのを待ちます。v2.1.199 以降では、サーバーエラー、タイムアウト、接続の切断など、その他の一時的なエラーに対するデフォルトの再試行回数も 300（約 3 時間のバックオフ）に引き上げ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合の上限 15 を撤廃します。Claude Code v2.1.186 以降が必要です |388| `CLAUDE_CODE_RETRY_WATCHDOG` | 評価ハーネス、CI ジョブ、リモートワーカーなどの無人セッションでは `1` に設定します。`429` および `529` の容量エラーを、`CLAUDE_CODE_MAX_RETRIES` 回の試行後に失敗させるのではなく、無期限に再試行します。標準速度のリクエストが、支出制限や使用クレジットの枯渇を報告する `429` を受け取った場合、それがスケジュールに従ってリセットされる [ゲートウェイの支出上限](/docs/ja/errors#spend-limit-reached) によるものであっても、Claude Code は直ちに失敗します。v2.1.239 より前は、ウォッチドッグはこれらを無期限に再試行していました。fast mode のリクエストについては、[レート制限の処理](/docs/ja/fast-mode#handle-rate-limits) を参照してください。ウォッチドッグは試行の間に最大 5 分、またはレスポンスにレート制限のリセット時刻が含まれている場合は制限がリセットされるまでバックオフするため、使用制限に達したセッションは残りの時間枠が過ぎるのを待ちます。v2.1.199 以降では、サーバーエラー、タイムアウト、接続の切断など、その他の一時的なエラーに対するデフォルトの再試行回数も 300（約 3 時間のバックオフ）に引き上げ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合の上限 15 を撤廃します。Claude Code v2.1.186 以降が必要です |

386| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | `CLAUDE_CODE_RETRY_WATCHDOG` が設定されている場合に、各 API リクエストが `429` および `529` エラーをやり過ごすために待機する最大時間（ミリ秒）。その時間を使い切ると、次に同様のエラーが発生した時点でリクエストは終了します。30 分を表す `1800000` のように、正の整数を数字のみで指定します。未設定の場合、待機時間に制限はありません。Claude Code v2.1.295 以降が必要です |389| `CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS` | `CLAUDE_CODE_RETRY_WATCHDOG` が設定されている場合に、各 API リクエストが `429` および `529` エラーをやり過ごすために待機する最大時間（ミリ秒）。その時間を使い切ると、次に同様のエラーが発生した時点でリクエストは終了します。30 分を表す `1800000` のように、正の整数を数字のみで指定します。未設定の場合、待機時間に制限はありません。Claude Code v2.1.295 以降が必要です |

437| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | `CLAUDE_AUTO_BACKGROUND_TASKS` が `1` に設定されている場合に、まだ実行中の[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を確認するよう Claude にリマインドするまでに Claude Code が待機する時間。`600` や `600,1800,3600` のように、`1` から `86400` までの整数秒による待機時間を 1 つ以上カンマ区切りで指定します。各値は次のリマインダーまでの待機時間で、最後の値が繰り返されます。数字のみを受け付けます。その他の値や表記は未設定として扱われます。未設定の場合、リマインダーはありません。Claude Code v2.1.283 以降が必要です |440| `CLAUDE_CODE_WORKER_CHECKIN_SCHEDULE` | `CLAUDE_AUTO_BACKGROUND_TASKS` が `1` に設定されている場合に、まだ実行中の[バックグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)を確認するよう Claude にリマインドするまでに Claude Code が待機する時間。`600` や `600,1800,3600` のように、`1` から `86400` までの整数秒による待機時間を 1 つ以上カンマ区切りで指定します。各値は次のリマインダーまでの待機時間で、最後の値が繰り返されます。数字のみを受け付けます。その他の値や表記は未設定として扱われます。未設定の場合、リマインダーはありません。Claude Code v2.1.283 以降が必要です |

438| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 1 回の[ワークフロー](/docs/ja/workflows)実行で同時に実行するエージェントの数（`1` から `256`）。デフォルトでは、1 回の実行で最大 16 個のエージェントを同時に実行し、Claude Code が利用できる CPU が少ない場合はそれより少なくなります。キューに入った `agent()` 呼び出しは空きスロットを待ちます。実行中の各エージェントのトランスクリプトは Claude Code のメモリに保持されるため、値を大きくするとメモリ使用量が増えます。数字のみを受け付けます。範囲外の値やその他の表記ではデフォルトが維持されます。Claude Code v2.1.269 以降が必要です |441| `CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS` | 1 回の[ワークフロー](/docs/ja/workflows)実行で同時に実行するエージェントの数（`1` から `256`）。デフォルトでは、1 回の実行で最大 16 個のエージェントを同時に実行し、Claude Code が利用できる CPU が少ない場合はそれより少なくなります。キューに入った `agent()` 呼び出しは空きスロットを待ちます。実行中の各エージェントのトランスクリプトは Claude Code のメモリに保持されるため、値を大きくするとメモリ使用量が増えます。数字のみを受け付けます。範囲外の値やその他の表記ではデフォルトが維持されます。Claude Code v2.1.269 以降が必要です |

439| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [ワークフロー](/docs/ja/workflows)のエージェントが自身の最初のリクエストを送信する前に、同じプレフィックスを持つ兄弟エージェントの最初の応答が始まるのを待機する時間の上限（ミリ秒）。ファンアウトで[プロンプトキャッシュのプレフィックス](/docs/ja/workflows#prompt-caching-in-a-fan-out)を共有する複数のエージェントが開始されると、Claude Code は最初のエージェント以外を最大この時間だけ保留し、残りのエージェントがそれぞれキャッシュなしでプレフィックスを処理する代わりに、キャッシュされたプレフィックスを読み取れるようにします。デフォルトは `5000` です。待機を無効にするには `0` に設定します。`DISABLE_PROMPT_CACHING` が設定されている場合、エージェントは待機しません。Claude Code v2.1.229 以降が必要です |442| `CLAUDE_CODE_WORKFLOW_PREFIX_STAGGER_MS` | [ワークフロー](/docs/ja/workflows)のエージェントが自身の最初のリクエストを送信する前に、同じプレフィックスを持つ兄弟エージェントの最初の応答が始まるのを待機する時間の上限（ミリ秒）。ファンアウトで[プロンプトキャッシュのプレフィックス](/docs/ja/workflows#prompt-caching-in-a-fan-out)を共有する複数のエージェントが開始されると、Claude Code は最初のエージェント以外を最大この時間だけ保留し、残りのエージェントがそれぞれキャッシュなしでプレフィックスを処理する代わりに、キャッシュされたプレフィックスを読み取れるようにします。デフォルトは `5000` です。待機を無効にするには `0` に設定します。`DISABLE_PROMPT_CACHING` が設定されている場合、エージェントは待機しません。Claude Code v2.1.229 以降が必要です |

443| `CLAUDE_CODE_YOU_SHOULD_KNOW_DEBUG` | `1` に設定すると、このセッションで [You should know mod](/docs/ja/interactive-mode#you-should-know-suggestions) が行った直近 3 回のチェックそれぞれについて、プロンプトの上に 1 行ずつ表示します。メモが表示されないときに、mod がチェックを行っていることを確認するために使用します。Claude Code v2.1.287 以降が必要です |

440| `CLAUDE_CONFIG_DIR` | 設定ディレクトリを上書きします（デフォルト: `~/.claude`）。すべての設定、セッション履歴、プラグインはこのパスの下に保存されます。認証情報については、[Claude Code が認証情報を保存する場所](/docs/ja/authentication#credential-management)を参照してください。複数のアカウントを並行して使用する場合に便利です。例: `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ユーザー設定、または管理設定で設定します。設定ファイルでは[絶対パス](#in-settings-files)を記述します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |444| `CLAUDE_CONFIG_DIR` | 設定ディレクトリを上書きします（デフォルト: `~/.claude`）。すべての設定、セッション履歴、プラグインはこのパスの下に保存されます。認証情報については、[Claude Code が認証情報を保存する場所](/docs/ja/authentication#credential-management)を参照してください。複数のアカウントを並行して使用する場合に便利です。例: `alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'`。シェル、ユーザー設定、または管理設定で設定します。設定ファイルでは[絶対パス](#in-settings-files)を記述します。[プロジェクト設定とローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)では無視されます |

441| `CLAUDE_DISABLE_ADOPT` | `1` に設定すると、`←` を押すか [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンドに移したときに、進行中のバックグラウンド作業を引き継ぐ代わりに停止します。Claude Code はバックグラウンドに移す前に確認を求め、本来なら引き継がれるタスクを停止します。Claude Code v2.1.195 以降が必要です |445| `CLAUDE_DISABLE_ADOPT` | `1` に設定すると、`←` を押すか [`/background`](/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラウンドに移したときに、進行中のバックグラウンド作業を引き継ぐ代わりに停止します。Claude Code はバックグラウンドに移す前に確認を求め、本来なら引き継がれるタスクを停止します。Claude Code v2.1.195 以降が必要です |

442| `CLAUDE_EFFORT` | Bash ツールのサブプロセスとフックコマンドで、サブプロセスの開始時に有効な [effort レベル](/docs/ja/model-config#adjust-effort-level)（`low`、`medium`、`high`、`xhigh`、または `max`）に自動的に設定されます。[フック](/docs/ja/hooks)に渡される `effort.level` フィールドと一致します。現在のモデルが effort パラメーターをサポートしている場合にのみ設定されます |446| `CLAUDE_EFFORT` | Bash ツールのサブプロセスとフックコマンドで、サブプロセスの開始時に有効な [effort レベル](/docs/ja/model-config#adjust-effort-level)（`low`、`medium`、`high`、`xhigh`、または `max`）に自動的に設定されます。[フック](/docs/ja/hooks)に渡される `effort.level` フィールドと一致します。現在のモデルが effort パラメーターをサポートしている場合にのみ設定されます |

452| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | v2.1.260 で削除され、現在は何の効果もありません。以前は、[サブエージェント](/docs/ja/sub-agents)が開始した[バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands)を実行できる時間の上限をミリ秒で設定していました（デフォルトは 60 分）。[バックグラウンドコマンドの存続期間のルール](/docs/ja/tools-reference#background-commands)を参照してください |456| `CLAUDE_SUBAGENT_BG_SHELL_MAX_MS` | v2.1.260 で削除され、現在は何の効果もありません。以前は、[サブエージェント](/docs/ja/sub-agents)が開始した[バックグラウンドシェルコマンド](/docs/ja/interactive-mode#background-bash-commands)を実行できる時間の上限をミリ秒で設定していました（デフォルトは 60 分）。[バックグラウンドコマンドの存続期間のルール](/docs/ja/tools-reference#background-commands)を参照してください |

453| `DEBUG` | `1` に設定するとデバッグモードを有効にします。[`--debug`](/docs/ja/cli-reference#cli-flags) で起動するのと同等です。デバッグログは `~/.claude/debug/<session-id>.txt`、または `CLAUDE_CODE_DEBUG_LOGS_DIR` で設定されたパスに書き込まれます。デバッグモードを有効にするのは真の値 `1`、`true`、`yes`、`on` のみであるため、他のツール向けに設定された `DEBUG=express:*` のような名前空間パターンではトリガーされません |457| `DEBUG` | `1` に設定するとデバッグモードを有効にします。[`--debug`](/docs/ja/cli-reference#cli-flags) で起動するのと同等です。デバッグログは `~/.claude/debug/<session-id>.txt`、または `CLAUDE_CODE_DEBUG_LOGS_DIR` で設定されたパスに書き込まれます。デバッグモードを有効にするのは真の値 `1`、`true`、`yes`、`on` のみであるため、他のツール向けに設定された `DEBUG=express:*` のような名前空間パターンではトリガーされません |

454| `DISABLE_AUTOUPDATER` | `1` に設定すると、バックグラウンドでの自動更新を無効にします。手動の `claude update` は引き続き機能します。両方をブロックするには `DISABLE_UPDATES` を使用します |458| `DISABLE_AUTOUPDATER` | `1` に設定すると、バックグラウンドでの自動更新を無効にします。手動の `claude update` は引き続き機能します。両方をブロックするには `DISABLE_UPDATES` を使用します |

455| `DISABLE_AUTO_COMPACT` | `1` に設定すると、コンテキストの上限に近づいたときの自動圧縮を無効にします。手動の `/compact` コマンドは引き続き使用できます。コンテキスト圧縮を行うタイミングを明示的に制御したい場合に使用します。[`autoCompactEnabled`](/docs/ja/settings-reference#autocompactenabled) 設定を上書きします |459| `DISABLE_AUTO_COMPACT` | `1` に設定すると、コンテキストの上限に近づいたときの自動的なコンテキスト圧縮を、[アイドル時の圧縮](/docs/ja/settings-reference#idlecompaction)とともに無効にします。手動の `/compact` コマンドは引き続き使用できます。圧縮が行われるタイミングを明示的に制御したい場合に使用します。[`autoCompactEnabled`](/docs/ja/settings-reference#autocompactenabled) 設定を上書きします |

456| `DISABLE_COMPACT` | `1` に設定すると、自動圧縮と手動の `/compact` コマンドの両方を含む、すべてのコンテキスト圧縮を無効にします |460| `DISABLE_COMPACT` | `1` に設定すると、自動圧縮と手動の `/compact` コマンドの両方を含む、すべてのコンテキスト圧縮を無効にします |

457| `DISABLE_COST_WARNINGS` | `1` に設定すると、コストに関する警告メッセージを無効にします |461| `DISABLE_COST_WARNINGS` | `1` に設定すると、コストに関する警告メッセージを無効にします |

458| `DISABLE_DOCTOR_COMMAND` | `1` に設定すると、[`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップスキルとそのエイリアス `/checkup` を非表示にします。ユーザーがセッションからセットアップ診断を実行すべきでない管理されたデプロイで役立ちます。`claude doctor` ターミナルコマンドには影響しません。v2.1.205 より前は、この変数は `/doctor` 診断画面コマンドを非表示にしていました |462| `DISABLE_DOCTOR_COMMAND` | `1` に設定すると、[`/doctor`](/docs/ja/commands#all-commands) セットアップチェックアップスキルとそのエイリアス `/checkup` を非表示にします。ユーザーがセッションからセットアップ診断を実行すべきでない管理されたデプロイで役立ちます。`claude doctor` ターミナルコマンドには影響しません。v2.1.205 より前は、この変数は `/doctor` 診断画面コマンドを非表示にしていました |

478| `ENABLE_CLAUDEAI_MCP_SERVERS` | `false` に設定すると、Claude Code が [claude.ai の MCP サーバー](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を取得しないようにします。ログインしているユーザーに対してはデフォルトで有効です。プロジェクト単位または組織単位で無効にするには、代わりに設定で [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) を設定します |482| `ENABLE_CLAUDEAI_MCP_SERVERS` | `false` に設定すると、Claude Code が [claude.ai の MCP サーバー](/docs/ja/mcp#use-mcp-servers-from-claude-ai)を取得しないようにします。ログインしているユーザーに対してはデフォルトで有効です。プロジェクト単位または組織単位で無効にするには、代わりに設定で [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) を設定します |

479| `ENABLE_PROMPT_CACHING_1H` | `1` に設定すると、デフォルトの 5 分ではなく 1 時間の[プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) をリクエストします。API キー、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud's Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のユーザーを対象としています。含まれる使用量の範囲内のサブスクリプションユーザーは、[メインの会話](/docs/ja/prompt-caching#which-ttl-each-request-gets)で自動的に 1 時間の TTL を受け取ります。[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を利用しているサブスクリプションユーザーは、これを設定すると 1 時間の TTL を維持できます。1 時間のキャッシュ書き込みにはより高い料金が課金されます。代わりにリクエストのバケットごとに TTL を選択するには、`CLAUDE_CODE_PROMPT_CACHE_TTL` と `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` を使用します。これらはこの変数より優先されます |483| `ENABLE_PROMPT_CACHING_1H` | `1` に設定すると、デフォルトの 5 分ではなく 1 時間の[プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) をリクエストします。API キー、[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud's Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws) のユーザーを対象としています。含まれる使用量の範囲内のサブスクリプションユーザーは、[メインの会話](/docs/ja/prompt-caching#which-ttl-each-request-gets)で自動的に 1 時間の TTL を受け取ります。[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)を利用しているサブスクリプションユーザーは、これを設定すると 1 時間の TTL を維持できます。1 時間のキャッシュ書き込みにはより高い料金が課金されます。代わりにリクエストのバケットごとに TTL を選択するには、`CLAUDE_CODE_PROMPT_CACHE_TTL` と `CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL` を使用します。これらはこの変数より優先されます |

480| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非推奨です。代わりに `ENABLE_PROMPT_CACHING_1H` を使用してください |484| `ENABLE_PROMPT_CACHING_1H_BEDROCK` | 非推奨です。代わりに `ENABLE_PROMPT_CACHING_1H` を使用してください |

481| `ENABLE_TOOL_SEARCH` | [MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search)を制御します。未設定の場合、Claude Code はデフォルトですべての MCP ツールを遅延読み込みします。ただし、Claude 4.5 世代より前の Google Cloud's Agent Platform モデル、Azure でホストされている Microsoft Foundry デプロイ、および `ANTHROPIC_BASE_URL` がファーストパーティ以外のホストを指している場合は、引き続き事前に読み込みます。`true` は常に遅延読み込みしてベータヘッダーを送信しますが、同じ Agent Platform モデルと Microsoft Foundry デプロイは例外です。`tool_reference` をサポートしないプロキシではリクエストが失敗します。`auto` は、ツール定義がコンテキストの 10% 以内に収まる場合に事前に読み込みます。`auto:N` はカスタムのしきい値を設定します（例: 5% の場合は `auto:5`）。`false` はすべてのツールを事前に読み込みます。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` が設定されている場合、自分で設定した値は無視されます。v2.1.221 より前は、この変数を `true` に設定しない限り、Claude Code は Google Cloud's Agent Platform のすべてのモデルでツール検索を無効にしていました |485| `ENABLE_TOOL_SEARCH` | [MCP ツール検索](/docs/ja/mcp#scale-with-mcp-tool-search)を制御します。未設定の場合、Claude Code はデフォルトですべての MCP ツールを遅延読み込みしますが、`ANTHROPIC_BASE_URL` がファーストパーティ以外のホストを指している場合は代わりに事前に読み込みます。`true` は、そのようなホストでも遅延読み込みを維持します。`auto` は、ツール定義がコンテキストの 10% 以内に収まる場合に事前に読み込みます。`auto:N` はカスタムのしきい値を設定します（5% の場合は `auto:5` など）。`false` はすべてのツールを事前に読み込みます。この値にかかわらずすべてのツールを事前に読み込むモデルとデプロイについては、[ツール検索を設定する](/docs/ja/mcp#configure-tool-search)を参照してください |

482| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | `1` などの空でない任意の値に設定すると、フォールバックモデルが設定されていない場合に、Claude Code がすべてのモデルで過負荷エラーが繰り返されたときに再試行を停止するようにします。ほとんどのオン/オフ変数とは異なり、**`0` や `false` に設定してもこれは有効になります**。デフォルトの再試行動作に戻すには、変数の設定を解除してください。この変数がない場合、Claude Code がこのように再試行を停止するのは、Claude のサブスクリプションではなく API キーまたは[サードパーティプロバイダー](/docs/ja/third-party-integrations)で認証しているときに、Opus、Fable、または Mythos モデルと認識したモデルに対してのみです。Claude Code v2.1.160 以降では、Claude Code はどのプライマリモデルでも過負荷エラーが繰り返されると、設定された[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)に切り替えるため、この変数はフォールバックモデルへの切り替えには影響しません |486| `FALLBACK_FOR_ALL_PRIMARY_MODELS` | `1` などの空でない任意の値に設定すると、フォールバックモデルが設定されていない場合に、Claude Code がすべてのモデルで過負荷エラーが繰り返されたときに再試行を停止するようにします。ほとんどのオン/オフ変数とは異なり、**`0` や `false` に設定してもこれは有効になります**。デフォルトの再試行動作に戻すには、変数の設定を解除してください。この変数がない場合、Claude Code がこのように再試行を停止するのは、Claude のサブスクリプションではなく API キーまたは[サードパーティプロバイダー](/docs/ja/third-party-integrations)で認証しているときに、Opus、Fable、または Mythos モデルと認識したモデルに対してのみです。Claude Code v2.1.160 以降では、Claude Code はどのプライマリモデルでも過負荷エラーが繰り返されると、設定された[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)に切り替えるため、この変数はフォールバックモデルへの切り替えには影響しません |

483| `FORCE_AUTOUPDATE_PLUGINS` | `1` に設定すると、メインの自動更新が `DISABLE_AUTOUPDATER` で無効になっている場合でも、プラグインの自動更新を強制します |487| `FORCE_AUTOUPDATE_PLUGINS` | `1` に設定すると、メインの自動更新が `DISABLE_AUTOUPDATER` で無効になっている場合でも、プラグインの自動更新を強制します |

484| `FORCE_HYPERLINK` | ターミナルがクリック可能な OSC 8 ハイパーリンクをサポートしているのに自動検出されない場合、`1` に設定すると有効になり、`0` に設定すると無効になります。未設定の場合、Claude Code はターミナルのサポートを検出した場合にのみハイパーリンクを有効にします。Claude Code はこの値をブール値ではなく数値として解析するため、`false`、`no`、`off` などの値はハイパーリンクを無効にするのではなく有効にします。フッターの [PR またはマージリクエストのバッジ](/docs/ja/interactive-mode#pr-review-status)は、SSH 経由など Claude Code がターミナルのサポートを検出できない場合でもハイパーリンクとして表示されます。バッジをプレーンテキストとして表示するには `0` に設定します |488| `FORCE_HYPERLINK` | ターミナルがクリック可能な OSC 8 ハイパーリンクをサポートしているのに自動検出されない場合、`1` に設定すると有効になり、`0` に設定すると無効になります。未設定の場合、Claude Code はターミナルのサポートを検出した場合にのみハイパーリンクを有効にします。Claude Code はこの値をブール値ではなく数値として解析するため、`false`、`no`、`off` などの値はハイパーリンクを無効にするのではなく有効にします。フッターの [PR またはマージリクエストのバッジ](/docs/ja/interactive-mode#pr-review-status)は、SSH 経由など Claude Code がターミナルのサポートを検出できない場合でもハイパーリンクとして表示されます。バッジをプレーンテキストとして表示するには `0` に設定します |

593* [`claude import` または `/import` コマンド](/docs/ja/cli-reference#cli-commands)を実行する597* [`claude import` または `/import` コマンド](/docs/ja/cli-reference#cli-commands)を実行する

594* [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行する、またはそのレポートを `/plugin` の **Stats** タブで開く598* [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行する、またはそのレポートを `/plugin` の **Stats** タブで開く

595* claude.ai アカウントで有効にした[スキル](/docs/ja/skills#where-synced-skills-load)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)をターミナルセッションに同期する599* claude.ai アカウントで有効にした[スキル](/docs/ja/skills#where-synced-skills-load)と[プラグイン](/docs/ja/plugins/loading#synced-plugins)をターミナルセッションに同期する

600* [You should know mod](/docs/ja/interactive-mode#you-should-know-suggestions) をオンにする

596* [アドバイザーツール](/docs/ja/advisor#requirements)を使用する601* [アドバイザーツール](/docs/ja/advisor#requirements)を使用する

597* [アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読む、または返信する602* [アーティファクトへのコメント](/docs/ja/artifacts#collect-comments-on-an-artifact)を読む、または返信する

598* Claude に[別の組織の公開アーティファクト](/docs/ja/artifacts#read-an-artifact-shared-with-you)を読ませる603* Claude に[別の組織の公開アーティファクト](/docs/ja/artifacts#read-an-artifact-shared-with-you)を読ませる

600* [Claude が下書きするフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を利用する。この機能は、Claude Code が取得したフラグによってオンにします605* [Claude が下書きするフィードバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を利用する。この機能は、Claude Code が取得したフラグによってオンにします

601* Claude に[大きな貼り付けを、入力したテキストではなく貼り付けたテキストとして扱わせる](/docs/ja/terminal-config#how-claude-treats-pasted-text)。`[Pasted text #N]` プレースホルダーの背後にあるコンテンツは、マークなしで Claude に届きます606* Claude に[大きな貼り付けを、入力したテキストではなく貼り付けたテキストとして扱わせる](/docs/ja/terminal-config#how-claude-treats-pasted-text)。`[Pasted text #N]` プレースホルダーの背後にあるコンテンツは、マークなしで Claude に届きます

602* Claude Code に [API が拒否する入力スキーマを持つ MCP ツールを除外させる](/docs/ja/mcp#tools-with-invalid-input-schemas)。Claude Code はそのスキーマをそのまま送信し、それを含むリクエストは[ツールを位置で示す 400 エラー](/docs/ja/errors#tool-input-schema-is-invalid)で失敗します607* Claude Code に [API が拒否する入力スキーマを持つ MCP ツールを除外させる](/docs/ja/mcp#tools-with-invalid-input-schemas)。Claude Code はそのスキーマをそのまま送信し、それを含むリクエストは[ツールを位置で示す 400 エラー](/docs/ja/errors#tool-input-schema-is-invalid)で失敗します

608* ターミナルセッションがアイドル状態の間に、1 時間のプロンプトキャッシュの有効期限が切れる少し前に、Claude Code に[長い会話をコンパクト化させる](/docs/ja/settings-reference#idlecompaction)

603 609 

604<h3 id="first-session-after-an-install-or-upgrade">610<h3 id="first-session-after-an-install-or-upgrade">

605 インストールまたはアップグレード後の最初のセッション611 インストールまたはアップグレード後の最初のセッション

134| `proxy refused the connection` | [ネットワーク](#the-proxy-refused-the-connection) |134| `proxy refused the connection` | [ネットワーク](#the-proxy-refused-the-connection) |

135| `403` with `GitHub GraphQL is not available from Claude Code sessions` in a cloud session | [GitHub proxy](/docs/ja/cloud-environments#github-proxy) |135| `403` with `GitHub GraphQL is not available from Claude Code sessions` in a cloud session | [GitHub proxy](/docs/ja/cloud-environments#github-proxy) |

136| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [ネットワーク](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |136| `The cloud environments service returned an empty response` / `The cloud environments service returned a response in an unexpected format` | [ネットワーク](#the-cloud-environments-service-returned-an-empty-or-unexpected-response) |

137| `Failed to fetch session from Sessions API: Failed to fetch session logs` | [ネットワーク](#failed-to-fetch-session-from-sessions-api) |

137| `Couldn't reconnect to your Remote Control session` | [ネットワーク](#couldnt-reconnect-to-your-remote-control-session) |138| `Couldn't reconnect to your Remote Control session` | [ネットワーク](#couldnt-reconnect-to-your-remote-control-session) |

138| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [ネットワーク](#sessions-ended-while-this-machine-was-offline) |139| `N sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.` | [ネットワーク](#sessions-ended-while-this-machine-was-offline) |

139| `Couldn't share the transcript.` | [ネットワーク](#couldnt-share-the-transcript) |140| `Couldn't share the transcript.` | [ネットワーク](#couldnt-share-the-transcript) |

153| `Request too large for the API's 32MB request limit` | [リクエストエラー](#request-too-large) |154| `Request too large for the API's 32MB request limit` | [リクエストエラー](#request-too-large) |

154| `Image was too large` | [リクエストエラー](#image-was-too-large) |155| `Image was too large` | [リクエストエラー](#image-was-too-large) |

155| `Unable to resize image` | [リクエストエラー](#unable-to-resize-image) |156| `Unable to resize image` | [リクエストエラー](#unable-to-resize-image) |

157| `Request rejected as unprocessable by the model` | [リクエストエラー](#request-rejected-as-unprocessable-by-the-model) |

156| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [リクエストエラー](#pdf-errors) |158| `PDF too large` / `PDF is password protected` / `pdftoppm is not installed` | [リクエストエラー](#pdf-errors) |

157| `Extra inputs are not permitted` | [リクエストエラー](#extra-inputs-are-not-permitted) |159| `Extra inputs are not permitted` | [リクエストエラー](#extra-inputs-are-not-permitted) |

158| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [リクエストエラー](#tool-input-schema-is-invalid) |160| `API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid` / `Property keys should match pattern` | [リクエストエラー](#tool-input-schema-is-invalid) |

161| `Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128` | [リクエストエラー](#mcp-tool-name-over-128-characters) |

162| `tools.N.custom.name: String should have at most 128 characters` | [リクエストエラー](#mcp-tool-name-over-128-characters) |

159| `tool_use.name: String should have at most 200 characters` | [リクエストエラー](#tool-use-name-over-200-characters) |163| `tool_use.name: String should have at most 200 characters` | [リクエストエラー](#tool-use-name-over-200-characters) |

160| `There's an issue with the selected model` | [リクエストエラー](#theres-an-issue-with-the-selected-model) |164| `There's an issue with the selected model` | [リクエストエラー](#theres-an-issue-with-the-selected-model) |

161| `Model ... is not a recognized model id` | [リクエストエラー](#model-is-not-a-recognized-model-id) |165| `Model ... is not a recognized model id` | [リクエストエラー](#model-is-not-a-recognized-model-id) |

198| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [コマンドラインエラー](#conflict-between-a-system-prompt-flag-and-its-file-form) |202| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [コマンドラインエラー](#conflict-between-a-system-prompt-flag-and-its-file-form) |

199| `Cloud sessions cannot be created from a --restricted session` | [コマンドラインエラー](#cloud-sessions-cannot-be-created-from-a-restricted-session) |203| `Cloud sessions cannot be created from a --restricted session` | [コマンドラインエラー](#cloud-sessions-cannot-be-created-from-a-restricted-session) |

200| `Cloud sessions are disabled by your organization's policy` | [コマンドラインエラー](#cloud-sessions-are-disabled-by-your-organizations-policy) |204| `Cloud sessions are disabled by your organization's policy` | [コマンドラインエラー](#cloud-sessions-are-disabled-by-your-organizations-policy) |

201| `Couldn't verify your organization's policy for cloud sessions` | [コマンドラインエラー](#cloud-sessions-are-disabled-by-your-organizations-policy) |205| `Cloud sessions use your claude.ai login`、認証情報を挙げるポリシー拒否メッセージの末尾に表示される | [コマンドラインエラー](#cloud-sessions-use-your-claude-ai-login) |

206| `Couldn't verify your organization's policy for cloud sessions` | [コマンドラインエラー](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |

207| `Cloud sessions aren't available:` の後に組織のポリシーを読み込めなかった理由が続く | [コマンドラインエラー](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |

202| `Cloud sessions need a claude.ai sign-in` | [Unable to get organization UUID](/docs/ja/claude-code-on-the-web#unable-to-get-organization-uuid) |208| `Cloud sessions need a claude.ai sign-in` | [Unable to get organization UUID](/docs/ja/claude-code-on-the-web#unable-to-get-organization-uuid) |

209| `Nothing was stashed: "<path>" is now a folder in place of a tracked file or link` / `are now folders in place of tracked files or links` | [コマンドラインエラー](#nothing-was-stashed-because-a-folder-replaced-a-tracked-file) |

203| `Error: --json-schema is not a valid JSON Schema` | [コマンドラインエラー](#the-json-schema-value-is-not-a-valid-json-schema) |210| `Error: --json-schema is not a valid JSON Schema` | [コマンドラインエラー](#the-json-schema-value-is-not-a-valid-json-schema) |

204| `Error: Invalid --agents configuration:` | [コマンドラインエラー](#invalid-agents-configuration) |211| `Error: Invalid --agents configuration:` | [コマンドラインエラー](#invalid-agents-configuration) |

205| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [コマンドラインエラー](#invalid-agents-configuration) |212| `Error: --agents takes a JSON object, or a file path only with --print (-p)` | [コマンドラインエラー](#invalid-agents-configuration) |

259| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [コマンドラインエラー](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |266| `Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load` | [コマンドラインエラー](#output-styles-are-saved-to-local-settings-which-this-session-doesnt-load) |

260| `/recap only runs when you ask for it yourself in this session` | [コマンドラインエラー](#recap-only-runs-when-you-ask-for-it-yourself) |267| `/recap only runs when you ask for it yourself in this session` | [コマンドラインエラー](#recap-only-runs-when-you-ask-for-it-yourself) |

261| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [プラグインエラー](#plugin-eval-is-currently-in-early-access) |268| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [プラグインエラー](#plugin-eval-is-currently-in-early-access) |

269| `cannot be evaluated where sessions load it` | [eval でプラグインをテストする](/docs/ja/plugin-evals#cannot-be-evaluated-where-sessions-load-it) |

262| `Marketplace "<name>" is registered from an untrusted source` | [プラグインエラー](#marketplace-is-registered-from-an-untrusted-source) |270| `Marketplace "<name>" is registered from an untrusted source` | [プラグインエラー](#marketplace-is-registered-from-an-untrusted-source) |

263| `Claude Code refuses the marketplace name "<name>"` | [プラグインエラー](#claude-code-refuses-the-marketplace-name) |271| `Claude Code refuses the marketplace name "<name>"` | [プラグインエラー](#claude-code-refuses-the-marketplace-name) |

264| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [プラグインエラー](#claude-code-refuses-the-marketplace-name) |272| `Marketplace name impersonates an official Anthropic/Claude marketplace` | [プラグインエラー](#claude-code-refuses-the-marketplace-name) |

358| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [フルスクリーンレンダリング](/docs/ja/fullscreen#fullscreen-renderer-didnt-finish-starting) |366| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [フルスクリーンレンダリング](/docs/ja/fullscreen#fullscreen-renderer-didnt-finish-starting) |

359| `Claude Code exited after an unrecoverable interface error (...)` | [設定の警告](#exited-after-an-unrecoverable-interface-error) |367| `Claude Code exited after an unrecoverable interface error (...)` | [設定の警告](#exited-after-an-unrecoverable-interface-error) |

360| `Agent descriptions are over the 15.0k-token limit` | [設定の警告](#agent-descriptions-are-over-the-15000-token-limit) |368| `Agent descriptions are over the 15.0k-token limit` | [設定の警告](#agent-descriptions-are-over-the-15000-token-limit) |

369| `hook needs quotes around a path with a space` | [設定の警告](#hook-needs-quotes-around-a-path-with-a-space) |

361| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [設定の警告](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |370| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [設定の警告](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |

371| `N skill or command names refused: run with --debug to see which ([names]), rename, then restart` | [設定の警告](#skill-or-command-name-refused) |

362| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [設定の警告](#workspace-has-not-been-trusted) |372| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [設定の警告](#workspace-has-not-been-trusted) |

363| `is a network path, which cannot be added as a working directory` | [設定の警告](#working-directory-is-a-network-path) |373| `is a network path, which cannot be added as a working directory` | [設定の警告](#working-directory-is-a-network-path) |

364| `Remote managed settings failed to load (<cause>)` | [設定の警告](#remote-managed-settings-failed-to-load) |374| `Remote managed settings failed to load (<cause>)` | [設定の警告](#remote-managed-settings-failed-to-load) |

447| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ja/env-vars) | 未設定 | CI ジョブなどの無人セッションで `1` に設定すると、`429` および `529` の容量エラーを、`CLAUDE_CODE_MAX_RETRIES` 回の試行後に失敗させる代わりに無期限に再試行します。標準速度のリクエストが支出上限または使用クレジットの枯渇を報告する `429` を受け取った場合、スケジュールに従ってリセットされる[ゲートウェイの支出上限](#spend-limit-reached)によるものであっても、Claude Code は即座に失敗します。v2.1.239 より前は、ウォッチドッグはこれらを無期限に再試行していました。fast mode のリクエストについては、[Handle rate limits](/docs/ja/fast-mode#handle-rate-limits) を参照してください。v2.1.199 以降では、サーバーエラー、タイムアウト、切断された接続など、その他の一時的なエラーのデフォルトの再試行回数も 300 (約 3 時間分のバックオフ) に引き上げられ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合の上限 15 も撤廃されます。 |457| [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/ja/env-vars) | 未設定 | CI ジョブなどの無人セッションで `1` に設定すると、`429` および `529` の容量エラーを、`CLAUDE_CODE_MAX_RETRIES` 回の試行後に失敗させる代わりに無期限に再試行します。標準速度のリクエストが支出上限または使用クレジットの枯渇を報告する `429` を受け取った場合、スケジュールに従ってリセットされる[ゲートウェイの支出上限](#spend-limit-reached)によるものであっても、Claude Code は即座に失敗します。v2.1.239 より前は、ウォッチドッグはこれらを無期限に再試行していました。fast mode のリクエストについては、[Handle rate limits](/docs/ja/fast-mode#handle-rate-limits) を参照してください。v2.1.199 以降では、サーバーエラー、タイムアウト、切断された接続など、その他の一時的なエラーのデフォルトの再試行回数も 300 (約 3 時間分のバックオフ) に引き上げられ、`CLAUDE_CODE_MAX_RETRIES` を明示的に設定した場合の上限 15 も撤廃されます。 |

448| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/ja/env-vars) | 未設定 | `CLAUDE_CODE_RETRY_WATCHDOG` が設定されている場合に、各 API リクエストが `429` および `529` エラーの解消を待つのに費やす最大時間。単位はミリ秒です。未設定の場合、待機時間に制限はありません。Claude Code v2.1.295 以降が必要です。 |458| [`CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS`](/docs/ja/env-vars) | 未設定 | `CLAUDE_CODE_RETRY_WATCHDOG` が設定されている場合に、各 API リクエストが `429` および `529` エラーの解消を待つのに費やす最大時間。単位はミリ秒です。未設定の場合、待機時間に制限はありません。Claude Code v2.1.295 以降が必要です。 |

449| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/ja/env-vars) | 500 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、開始時の遅延 (ミリ秒)。API が容量の上限に達している場合に、再試行をより長い期間に分散させるには、最大 32000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.292 以降が必要です。 |459| [`CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS`](/docs/ja/env-vars) | 500 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、開始時の遅延 (ミリ秒)。API が容量の上限に達している場合に、再試行をより長い期間に分散させるには、最大 32000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.292 以降が必要です。 |

460| [`CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS`](/docs/ja/env-vars) | 32000 | API が `529` 過負荷エラーで拒否したリクエストの再試行間のバックオフにおける、遅延の上限 (ミリ秒)。API が容量の上限に達している場合に、後の再試行の間隔が引き続き広がるようにするには、最大 64000 まで値を引き上げてください。`CLAUDE_CODE_RETRY_WATCHDOG` が `1` に設定されている場合、または拒否されたリクエストが [fast mode](/docs/ja/fast-mode#handle-rate-limits) で送信された場合は効果がありません。Claude Code v2.1.296 以降が必要です。 |

450| [`API_TIMEOUT_MS`](/docs/ja/env-vars) | 600000 | リクエストごとのタイムアウト (ミリ秒)。低速なネットワークやプロキシを使用する場合は値を引き上げてください。[No response from API](#no-response-from-api) で説明しているように、Claude Code がレスポンスヘッダーを待機する時間の上限にもなります。 |461| [`API_TIMEOUT_MS`](/docs/ja/env-vars) | 600000 | リクエストごとのタイムアウト (ミリ秒)。低速なネットワークやプロキシを使用する場合は値を引き上げてください。[No response from API](#no-response-from-api) で説明しているように、Claude Code がレスポンスヘッダーを待機する時間の上限にもなります。 |

451| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](/docs/ja/env-vars) | 未設定 | タイムアウトした[非ストリーミングリクエスト](#streaming-response-ended-before-any-complete-data-was-received)の再送信回数の上限。上限に達すると、リクエストは失敗します。生成にタイムアウトより長い時間がかかる Claude の応答は、再送信のたびに再びタイムアウトするため、より早く失敗させるには `0` などの小さな値を設定してください。非ストリーミングの各試行は、ローカルセッションでは 300 秒後に、`API_TIMEOUT_MS` に正の値を設定している場合はその時間の経過後にタイムアウトします。Claude Code v2.1.285 以降が必要です。 |462| [`CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES`](/docs/ja/env-vars) | 未設定 | タイムアウトした[非ストリーミングリクエスト](#streaming-response-ended-before-any-complete-data-was-received)の再送信回数の上限。上限に達すると、リクエストは失敗します。生成にタイムアウトより長い時間がかかる Claude の応答は、再送信のたびに再びタイムアウトするため、より早く失敗させるには `0` などの小さな値を設定してください。非ストリーミングの各試行は、ローカルセッションでは 300 秒後に、`API_TIMEOUT_MS` に正の値を設定している場合はその時間の経過後にタイムアウトします。Claude Code v2.1.285 以降が必要です。 |

452| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/ja/env-vars) | 未設定 | ストリーミングリクエストの最初のレスポンスバイトの期限 (ミリ秒)。Claude Code v2.1.242 以降が必要です。これが未設定の場合に Claude Code が期限をどのように決定するかについては、[No response from API](#no-response-from-api) を参照してください。 |463| [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/ja/env-vars) | 未設定 | ストリーミングリクエストの最初のレスポンスバイトの期限 (ミリ秒)。Claude Code v2.1.242 以降が必要です。これが未設定の場合に Claude Code が期限をどのように決定するかについては、[No response from API](#no-response-from-api) を参照してください。 |

2045これらのステップは、自身の環境の 1 つを変更します。[組織共有環境](/docs/ja/cloud-environments#organization-shared-environments) はセレクターで読み取り専用で開くため、[管理設定](https://claude.ai/admin-settings) の **Cloud environments** ページから Owner にネットワークアクセスを変更するよう依頼してください。2056これらのステップは、自身の環境の 1 つを変更します。[組織共有環境](/docs/ja/cloud-environments#organization-shared-environments) はセレクターで読み取り専用で開くため、[管理設定](https://claude.ai/admin-settings) の **Cloud environments** ページから Owner にネットワークアクセスを変更するよう依頼してください。

2046 2057 

2047* 環境を編集用に開きます。[ルーティンのフォーム](/docs/ja/routines#environments-and-network-access) から、またはクラウドセッションを開始する [環境セレクター](/docs/ja/cloud-environments#configure-your-environment) から開きます。2058* 環境を編集用に開きます。[ルーティンのフォーム](/docs/ja/routines#environments-and-network-access) から、またはクラウドセッションを開始する [環境セレクター](/docs/ja/cloud-environments#configure-your-environment) から開きます。

2048* **Edit environment** ダイアログで、**Network access** を **Trusted** から **Custom** に変更し、ブロックされたドメインを **Allowed domains** に追加してください。1 行に 1 つのドメインを入力してください。**Also include default list of common package managers** をチェックして、カスタムドメインと共に [デフォルト許可リスト](/docs/ja/cloud-environments#default-allowed-domains) を保持してください。無制限のアクセスが必要な場合は、代わりに **Full** を選択してください。2059* **Edit cloud environment** ダイアログで、**Network access** を **Trusted** から **Custom** に変更し、ブロックされたドメインを **Allowed domains** に追加してください。1 行に 1 つのドメインを入力してください。**Also include default list of common package managers** をチェックして、カスタムドメインと共に [デフォルト許可リスト](/docs/ja/cloud-environments#default-allowed-domains) を保持してください。無制限のアクセスが必要な場合は、代わりに **Full** を選択してください。

2049* **Save changes** をクリックしてください。次の実行は更新された許可リストを使用します。既に開いているクラウドセッションについては、[ネットワークアクセスの変更が既存セッションに反映されるタイミング](/docs/ja/cloud-environments#network-access) を参照してください。2060* **Save changes** をクリックしてください。次の実行は更新された許可リストを使用します。既に開いているクラウドセッションについては、[ネットワークアクセスの変更が既存セッションに反映されるタイミング](/docs/ja/cloud-environments#network-access) を参照してください。

2050 2061 

2051アクセスレベルとデフォルト許可リストについては、[ネットワークアクセス](/docs/ja/cloud-environments#network-access) を参照してください。ローカル CLI セッションはこのポリシーの影響を受けません。2062アクセスレベルとデフォルト許可リストについては、[ネットワークアクセス](/docs/ja/cloud-environments#network-access) を参照してください。ローカル CLI セッションはこのポリシーの影響を受けません。

2097 2108 

2098v2.1.236 より前では、Claude Code はこれらのメッセージの代わりに生の JavaScript TypeError を表示しました。2109v2.1.236 より前では、Claude Code はこれらのメッセージの代わりに生の JavaScript TypeError を表示しました。

2099 2110 

2111<h3 id="failed-to-fetch-session-from-sessions-api">

2112 Failed to fetch session from Sessions API

2113</h3>

2114 

2115このメッセージは、Claude Code が [ターミナルに取り込むよう指定したクラウドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal) を見つけたものの、Anthropic のサーバーからその会話履歴を読み取れなかったため、セッションを開かなかったことを意味します。

2116 

2117```text theme={null}

2118Failed to fetch session from Sessions API: Failed to fetch session logs

2119```

2120 

2121このメッセージは、`claude --teleport` や `/teleport` を実行した後、または [`/tasks`](/docs/ja/commands) リストでセッションを選択した後に表示されます。`claude --teleport <session-id>` はこのメッセージを出力し、終了コード 1 で終了します。

2122 

2123**対応方法：**

2124 

2125* 同じ teleport をもう一度実行してください。同じように失敗する場合は、[問題を報告](#report-an-error) してください。

2126 

2127v2.1.296 より前では、Claude Code は失敗した読み取りを再試行せず、読み取りに失敗した後、このメッセージを出力する代わりに、空の会話でセッションを開いて成功を報告することがありました。

2128 

2100<h3 id="couldnt-reconnect-to-your-remote-control-session">2129<h3 id="couldnt-reconnect-to-your-remote-control-session">

2101 Couldn't reconnect to your Remote Control session2130 Couldn't reconnect to your Remote Control session

2102</h3>2131</h3>

2344* メッセージが寸法またはサイズ制限を報告する場合は、その制限を下回るように画像をリサイズまたは再圧縮してから添付してください。2373* メッセージが寸法またはサイズ制限を報告する場合は、その制限を下回るように画像をリサイズまたは再圧縮してから添付してください。

2345* メッセージが CMYK JPEG、アニメーション WebP、または破損している可能性のあるファイルなどの原因を示す場合は、メッセージが提案する形式で画像を再保存して再度添付してください。2374* メッセージが CMYK JPEG、アニメーション WebP、または破損している可能性のあるファイルなどの原因を示す場合は、メッセージが提案する形式で画像を再保存して再度添付してください。

2346 2375 

2376<h3 id="request-rejected-as-unprocessable-by-the-model">

2377 Request rejected as unprocessable by the model

2378</h3>

2379 

2380API は、モデルが処理できないものとしてリクエストを拒否しました。メッセージは API 自体のものです。

2381 

2382```text theme={null}

2383API Error: 400 Request rejected as unprocessable by the model (too many or oversized images, or unsupported parameters)

2384```

2385 

2386Claude Code は、拒否されたリクエストから最も古い画像とドキュメントを削除して再送信できます。v2.1.290 より前は、この拒否に対して Claude Code が画像を削除しなかったため、数百枚の画像が蓄積された長いセッションではターンごとにこのエラーで失敗することがありました。

2387 

2388**対処方法：**

2389 

2390* 画像やドキュメントを含む会話でメッセージが繰り返し表示される場合は、自分でそれらを削除します。Esc を 2 回押してそれらを追加したターンより前に戻るか、`/clear` を実行して新しく始めます。

2391 

2347<h3 id="pdf-errors">2392<h3 id="pdf-errors">

2348 PDF エラー2393 PDF エラー

2349</h3>2394</h3>

2413* 無効なスキーマを宣言する MCP サーバーを削除するか、[無効にしてください](/docs/ja/mcp#disable-a-server-without-removing-it)。エラーはツールを位置でのみ示します。v2.1.216 以降では、各サーバーのログで、入力スキーマが拒否されるツールを示す行を確認してください。どのログにもそれが示されていない場合は、サーバーを 1 つずつ無効にしてください。2458* 無効なスキーマを宣言する MCP サーバーを削除するか、[無効にしてください](/docs/ja/mcp#disable-a-server-without-removing-it)。エラーはツールを位置でのみ示します。v2.1.216 以降では、各サーバーのログで、入力スキーマが拒否されるツールを示す行を確認してください。どのログにもそれが示されていない場合は、サーバーを 1 つずつ無効にしてください。

2414* サーバーを保守している場合は、ツールの `input_schema` を修正してください。スキーマは有効な JSON Schema である必要があり、トップレベルのプロパティ名は 1 ～ 64 文字で、ASCII 文字と数字、`_`、`.`、`-` のみを使用する必要があります。[無効な入力スキーマを持つツール](/docs/ja/mcp#tools-with-invalid-input-schemas)を参照してください。2459* サーバーを保守している場合は、ツールの `input_schema` を修正してください。スキーマは有効な JSON Schema である必要があり、トップレベルのプロパティ名は 1 ～ 64 文字で、ASCII 文字と数字、`_`、`.`、`-` のみを使用する必要があります。[無効な入力スキーマを持つツール](/docs/ja/mcp#tools-with-invalid-input-schemas)を参照してください。

2415 2460 

2461<h3 id="mcp-tool-name-over-128-characters">

2462 MCP ツール名が 128 文字を超えています

2463</h3>

2464 

2465MCP サーバーが、`mcp__<server>__<tool>` などの完全な名前が API が受け入れる 128 文字を超えるツールを一覧表示しています。Claude Code は [そのツールを Claude に送信するツールから除外](/docs/ja/mcp#tools-with-names-longer-than-128-characters)し、サーバーの他のツールは引き続き機能します。シェルから `claude --debug` で開始したセッションでは、Claude Code は `~/.claude/debug/<session-id>.txt` のデバッグログに次のメッセージを書き込みます：

2466 

2467```text theme={null}

2468Tool "mcp__<server>__<tool>" is not sent to Claude: its name has <N> characters and the API accepts at most 128

2469```

2470 

2471**対応方法：**

2472 

2473* サーバーを保守している場合は、ツールの名前を短くしてください。

2474* サーバーが [MCP 設定](/docs/ja/mcp#mcp-installation-scopes)にある場合は、そこでより短い名前（`analytics-database` の代わりに `db` など）を付けてください。その後、[権限ルール](/docs/ja/permissions#mcp)や [フック matcher](/docs/ja/hooks#match-mcp-tools) など、古い名前でサーバーまたはそのツールを参照しているものを更新してください。

2475* [プラグインがサーバーをバンドルしている](/docs/ja/mcp#plugin-provided-mcp-servers)場合、ツールの完全な名前にはプラグイン名も含まれます。プラグインの保守担当者にサーバー名またはツール名を短くするよう依頼してください。

2476 

2477v2.1.292 より前では、Claude Code はそれでもツールを送信し、API はそのツールを含むすべてのリクエストを `API Error: 400 ... tools.N.custom.name: String should have at most 128 characters` で拒否していました。

2478 

2416<h3 id="tool-use-name-over-200-characters">2479<h3 id="tool-use-name-over-200-characters">

2417 tool\_use.name が 200 文字を超えています2480 tool\_use.name が 200 文字を超えています

2418</h3>2481</h3>

2932 コマンドラインエラー2995 コマンドラインエラー

2933</h2>2996</h2>

2934 2997 

2935これらのエラーは、`claude` コマンドラインとそのサブコマンド、プロンプトで送信したコマンド名、および `/security-review` のようにプロンプトの実行前にシェルコマンドを実行してコンテキストを収集するコマンドから発生します。CLI を再起動する `/tui` からも発生します。2998これらのエラーは、`claude` コマンドラインとそのサブコマンド、プロンプトで送信したコマンド名、そして `/security-review` のようにプロンプトの実行前にシェルコマンドを実行してコンテキストを収集するコマンドから発生します。CLI を再起動する `/tui` からも発生します。

2936 2999 

2937<h3 id="conflict-between-bg-and-print">3000<h3 id="conflict-between-bg-and-print">

2938 `--bg` と `--print` の競合3001 `--bg` と `--print` の競合

2939</h3>3002</h3>

2940 3003 

2941このメッセージには Claude Code v2.1.198 以降が必要です。同じ `claude` の呼び出しで `--bg` と `-p` または `--print` を組み合わせています。`--bg` は後で `claude agents` からアタッチする[バックグラウンドセッション](/docs/ja/agent-view#from-your-shell)を開始しますが、`--print` は[非対話](/docs/ja/headless)で実行され、`claude agents` がアタッチする対話セッションを開始しません。v2.1.198 より前は、この組み合わせによって、決してアタッチできないバックグラウンドジョブが何も通知されずに作成されていました。3004このメッセージには Claude Code v2.1.198 以降が必要です。同じ `claude` の呼び出しで `--bg` と `-p` または `--print` を組み合わせました。`--bg` は後から `claude agents` でアタッチする[バックグラウンドセッション](/docs/ja/agent-view#from-your-shell)を開始しますが、`--print` は[非対話](/docs/ja/headless)で実行され、`claude agents` がアタッチする対話セッションを開始しません。v2.1.198 より前は、この組み合わせによって、アタッチできないバックグラウンドジョブが何も通知されずに作成されていました。

2942 3005 

2943```text theme={null}3006```text theme={null}

2944--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.3007--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.

2946 3009 

2947**対処方法:**3010**対処方法:**

2948 3011 

2949* `-p` または `--print` を削除します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` だけで完全なコマンドになります。[シェルから新しいエージェントを Dispatch する](/docs/ja/agent-view#from-your-shell)を参照してください。3012* `-p` または `--print` を削除します。`--bg` はプロンプトを位置引数として受け取るため、`claude --bg "<task>"` だけで完全なコマンドになります。[シェルから新しいエージェントをディスパッチする](/docs/ja/agent-view#from-your-shell)を参照してください。

2950* バックグラウンドセッションを作成する代わりにプロンプトを非対話で実行して結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行します3013* バックグラウンドセッションを作成せずにプロンプトを非対話で実行して結果を出力するには、`--bg` を削除して `claude -p "<task>"` を実行します

2951 3014 

2952<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">3015<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">

2953 システムプロンプトフラグとそのファイル形式の競合3016 システムプロンプトフラグとそのファイル形式の競合

2954</h3>3017</h3>

2955 3018 

29561 回の `claude` の呼び出しで [`--append-subagent-system-prompt`](/docs/ja/cli-reference#cli-flags) と `--append-subagent-system-prompt-file` を一緒に渡したため、`claude` はセッションを開始せずに終了コード 1 で終了します:30191 回の `claude` の呼び出しで [`--append-subagent-system-prompt`](/docs/ja/cli-reference#cli-flags) と `--append-subagent-system-prompt-file` を同時に渡したため、`claude` はセッションを開始せずに終了コード 1 で終了します:

2957 3020 

2958```text theme={null}3021```text theme={null}

2959Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.3022Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.

2960```3023```

2961 3024 

2962v2.1.283 より前は、`--system-prompt` と `--system-prompt-file`、または `--append-system-prompt` と `--append-system-prompt-file` を一緒に渡した場合も、`claude` は同じように終了していました。これらのペアは[組み合わせる](/docs/ja/cli-reference#system-prompt-flags)のではなく競合していたためです。これらのバージョンでは、メッセージに組み合わせたペアの名前が表示されます。3025v2.1.283 より前は、`--system-prompt` と `--system-prompt-file`、または `--append-system-prompt` と `--append-system-prompt-file` を渡した場合にも、`claude` は同じように終了していました。これらの組み合わせは[結合](/docs/ja/cli-reference#system-prompt-flags)されずに競合していたためです。これらのバージョンでは、メッセージに組み合わせたフラグのペアが表示されます。

2963 3026 

2964**対処方法:**3027**対処方法:**

2965 3028 

2966* フラグの一方の形式を残し、もう一方を削除します。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡すのではなく、起動前にテキストをファイルにマージします3029* フラグの一方の形式だけを残し、もう一方を削除します。固定のプロンプトファイルと実行ごとのテキストを組み合わせるには、両方のフラグを渡すのではなく、起動前にテキストをファイルにマージします

2967 3030 

2968<h3 id="invalid-agents-configuration">3031<h3 id="invalid-agents-configuration">

2969 Invalid `--agents` configuration3032 Invalid `--agents` configuration

2970</h3>3033</h3>

2971 3034 

2972`--agents` に渡した値が無効なため、`claude` はセッションを開始せずに終了コード 1 で終了します。`--safe-mode` を渡すか [`CLAUDE_CODE_SAFE_MODE`](/docs/ja/env-vars#variables) を設定すると、Claude Code は `--agents` を完全に無視します。`--resume` または `--continue` を使用した場合、インラインの JSON 値はチェックされずにセッションが開始されますが、ファイルから読み取った値は起動のたびにチェックされます。v2.1.242 より前は、Claude Code はそれでもセッションを開始していました。3035`--agents` に渡した値が無効なため、`claude` はセッションを開始せずに終了コード 1 で終了します。`--safe-mode` を渡すか [`CLAUDE_CODE_SAFE_MODE`](/docs/ja/env-vars#variables) を設定すると、Claude Code は `--agents` を完全に無視します。`--resume` または `--continue` を使用する場合、インライン JSON の値はチェックされずにセッションが開始されますが、ファイルから読み込んだ値は起動のたびにチェックされます。v2.1.242 より前は、Claude Code はそれでもセッションを開始していました。

2973 3036 

2974```text theme={null}3037```text theme={null}

2975Error: Invalid --agents configuration:3038Error: Invalid --agents configuration:

2976<what failed>3039<what failed>

2977```3040```

2978 3041 

29791 行目に続く内容は、値がどのように失敗したかによって異なります。Claude Code は以下のチェックを順に実行し、最初に失敗したチェックで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にのみ表示されます:30421 行目以降の内容は、値がどのように無効だったかによって異なります。Claude Code は以下のチェックを順番に実行し、最初に失敗したチェックで停止します。値に 2 種類の問題がある場合、2 つ目の問題は 1 つ目を修正した後にはじめて表示されます:

2980 3043 

29811. 値が `{` で始まるものの JSON として解析できない場合、または `--agents` ファイルの内容を解析できない場合、Claude Code は JSON パーサー自身のメッセージを含む `invalid JSON:` 行を 1 行出力します30441. 値が `{` で始まるのに JSON として解析できない場合、または `--agents` ファイルの内容を解析できない場合、Claude Code は JSON パーサー自身のメッセージを含む `invalid JSON:` 行を 1 行出力します

29822. 解析はできたものの、エージェント定義が [CLI で定義されたサブエージェント](/docs/ja/sub-agents#choose-the-subagent-scope)のスキーマに一致しない場合、Claude Code は問題ごとに 1 行を出力します30452. 解析はできるものの、エージェント定義が [CLI で定義されたサブエージェント](/docs/ja/sub-agents#choose-the-subagent-scope)のスキーマに一致しない場合、Claude Code は問題ごとに 1 行を出力します

29833. エージェント名が `-` で始まる場合、Claude Code は `<name>: agent names must not start with '-'` を出力します30463. エージェント名が `-` で始まる場合、Claude Code は `<name>: agent names must not start with '-'` を出力します

2984 3047 

2985問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを `…and N more` に置き換えます。3048問題の行が 20 行を超える場合、Claude Code は最初の 20 行を出力し、残りを `…and N more` に置き換えます。

2986 3049 

2987`--print` を使用する場合、`--agents` はインラインのオブジェクトの代わりに [JSON ファイルへのパス](/docs/ja/sub-agents#choose-the-subagent-scope)も受け付けます。v2.1.281 より前は、`--agents` はインラインの JSON のみを受け付け、ファイルパスを無効な JSON として扱っていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。以下がその例です:3050`--print` を使用する場合、`--agents` はインラインのオブジェクトの代わりに [JSON ファイルへのパス](/docs/ja/sub-agents#choose-the-subagent-scope)も受け付けます。v2.1.281 より前は、`--agents` はインライン JSON のみを受け付け、ファイルパスを無効な JSON として扱っていました。ファイル形式には独自の拒否メッセージがあり、このメッセージの代わりに出力されます。たとえば次のようなものがあります:

2988 3051 

2989* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code が対話セッションで値をファイルパスとして読み取りました。定義をインラインの JSON として渡すか、`-p` を追加してファイルから読み取ります。3052* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code が対話セッションで値をファイルパスとして読み取りました。定義をインライン JSON として渡すか、`-p` を追加してファイルから読み込ませてください。

2990* **`Error: --agents file not found: <path>`**: そのパスにファイルが存在しません。`{` で始まらず有効な JSON でもない値はパスとして読み取られるため、シェルによって崩れたインラインの JSON もこの形で失敗することがあります。パスまたはクォートを確認して、コマンドを再度実行します。3053* **`Error: --agents file not found: <path>`**: そのパスにファイルが存在しません。`{` で始まらず有効な JSON でもない値はパスとして読み取られるため、シェルによって崩れたインライン JSON でもこのように失敗することがあります。パスまたはクォートを確認して、コマンドを再実行してください。

2991 3054 

2992**対処方法:**3055**対処方法:**

2993 3056 

2994* メッセージに列挙された各問題を修正してから、コマンドを再度実行します。[CLI で定義されたサブエージェントが受け付けるフィールド](/docs/ja/sub-agents#choose-the-subagent-scope)を参照してください。3057* メッセージに列挙された各問題を修正してから、コマンドを再実行します。[CLI で定義されたサブエージェントが受け付けるフィールド](/docs/ja/sub-agents#choose-the-subagent-scope)を参照してください。

2995 3058 

2996<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">3059<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">

2997 Cloud sessions cannot be created from a `--restricted` session3060 Cloud sessions cannot be created from a `--restricted` session

2998</h3>3061</h3>

2999 3062 

3000[`--restricted`](/docs/ja/cli-reference#cli-flags) でセッションを開始すると、Claude Code はそのセッションから[クラウドセッション](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)を作成することを拒否します。新しいセッションは制限されたプロセスの外部で実行され、制限モードを適用しないためです。Claude Code はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません:3063[`--restricted`](/docs/ja/cli-reference#cli-flags) でセッションを開始した場合、Claude Code はそのセッションから[クラウドセッション](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)を作成することを拒否します。新しいセッションは制限されたプロセスの外部で実行され、制限モードを適用しないためです。Claude Code はサーバーに接続する前にクライアント側で拒否するため、クラウドセッションは作成されません:

3001 3064 

3002```text theme={null}3065```text theme={null}

3003Cloud sessions cannot be created from a --restricted session: they would not enforce it.3066Cloud sessions cannot be created from a --restricted session: they would not enforce it.

3005 3068 

3006**対処方法:**3069**対処方法:**

3007 3070 

3008* 制限されたセッションでタスクをローカルに実行します3071* 制限されたセッション内でタスクをローカルに実行します

3009* セッションの起動方法を制御できる場合は、`--restricted` なしで新しい `claude` セッションを開始し、そこからクラウドセッションを作成します3072* セッションの起動方法を制御できる場合は、`--restricted` を付けずに新しい `claude` セッションを開始し、そこからクラウドセッションを作成します

3010 3073 

3011v2.1.248 より前の Claude Code には `--restricted` フラグがありません。それより前のバージョンでは、フラグ自体が不明なオプションのエラーで拒否されます。3074v2.1.248 より前の Claude Code には `--restricted` フラグがありません。それ以前のバージョンでは、フラグ自体が不明なオプションのエラーとして拒否されます。

3012 3075 

3013<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">3076<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">

3014 Cloud sessions are disabled by your organization's policy3077 Cloud sessions are disabled by your organization's policy

3020Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.3083Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.

3021```3084```

3022 3085 

3023このメッセージは、[ターミナルからクラウドセッションを作成](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)したとき、および `/teleport`、`/remote-env`、`/web-setup` など、クラウドセッションを必要とするコマンドを送信したときに表示されます。v2.1.268 より前は、これらのコマンドのいずれかを送信すると、代わりに [`Unknown command`](#unknown-command) が返されていました。3086このメッセージは、[ターミナルからクラウドセッションを作成する](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)とき、および`/teleport`、`/remote-env`、`/web-setup` など、クラウドセッションを必要とするコマンドを送信したときに表示されます。v2.1.268 より前は、これらのコマンドを送信すると代わりに [`Unknown command`](#unknown-command) が返されていました。

3087 

3088メッセージが、このセッションで使用している認証情報を挙げ、`Cloud sessions use your claude.ai login.` で終わっている場合は、[Cloud sessions use your claude.ai login](#cloud-sessions-use-your-claude-ai-login) を参照してください。Claude Code が組織のポリシーをまったく読み込めなかった場合は、代わりに[別のメッセージ](#couldnt-verify-your-organizations-policy-for-cloud-sessions)が表示されます。

3089 

3090**対処方法:**

3091 

3092* 組織の [Owner](/docs/ja/server-managed-settings#access-control) に、[claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) の Claude Code 管理設定でクラウドセッションを有効にするよう依頼します

3093 

3094<h3 id="cloud-sessions-use-your-claude-ai-login">

3095 Cloud sessions use your claude.ai login

3096</h3>

3097 

3098[ポリシーによる拒否](#cloud-sessions-are-disabled-by-your-organizations-policy)のメッセージが、このセッションで使用している認証情報を挙げ、この文で終わっている場合、Claude Code はその認証情報を発行した組織のクラウドセッションポリシーをチェックしています。その組織は、claude.ai のログインが属する組織とは異なる場合があります:

3099 

3100```text theme={null}

3101Cloud sessions are disabled by your organization's policy. This session is using ANTHROPIC_API_KEY, so Claude Code checked the policy for the organization that key belongs to. Cloud sessions use your claude.ai login.

3102```

3103 

3104最後の文は、クラウドセッションがその認証情報ではなく claude.ai のログインで実行されることを意味します。この形式は、`--cloud` や `--teleport` などを使用して、シェルからクラウドセッションを開始、再開、またはメッセージを送信したときに表示されます。v2.1.296 より前は、この場合にも、組織の管理者に連絡するよう求める形式が出力されていました。

3024 3105 

3025これはサーバー側の組織ポリシーであるため、ローカル設定、環境変数、CLI フラグで上書きすることはできません。3106<h3 id="couldnt-verify-your-organizations-policy-for-cloud-sessions">

3107 Couldn't verify your organization's policy for cloud sessions

3108</h3>

3109 

3110これらのメッセージは、Claude Code が組織のポリシーを読み込めなかったことを意味します。Claude Code は、[クラウドセッション](/docs/ja/claude-code-on-the-web)を作成、再開、またはメッセージを送信する前にこのポリシーをチェックします。ポリシーのリクエストが完了していない間は、次のメッセージが表示されます:

3111 

3112```text theme={null}

3113Couldn't verify your organization's policy for cloud sessions. Check your network connection and try again.

3114```

3115 

3116セッション内では、`/teleport` や `/web-setup` など、クラウドセッションを必要とするコマンドでもこのメッセージが表示されます。シェルであれば `Cloud sessions aren't available:` の形式が出力される場合でもこのメッセージが表示され、2 文目は `Check your network connection, then restart Claude Code and try again.` となります。

3026 3117 

3027Claude Code が組織のポリシーをまだ読み込んでいない場合や取得できない場合、これらのコマンドは代わりに `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.` と応答します。3118ポリシーのリクエストが失敗した後は、メッセージに何が失敗したかが示されます。これは、`--cloud` や `--teleport` などのフラグを使用して、シェルからクラウドセッションを開始、再開、またはメッセージを送信した場合に該当します。API への経路がない場合は、次のように表示されます:

3119 

3120```text theme={null}

3121Cloud sessions aren't available: couldn't reach api.anthropic.com to load your organization's policy. Check your network or proxy.

3122```

3123 

3124その他の失敗も同じ書き出しで始まり、その後にそれぞれの原因が続きます。たとえば、プロキシが HTTP 403 でリクエストを拒否した場合、サーバーエラー、API が受け付けなかった認証情報などです。`ANTHROPIC_API_KEY` 環境変数など、このセッションが claude.ai のログインの代わりに使用している認証情報を API が受け付けなかった場合、メッセージにはその認証情報の名前と、その設定を解除するよう求める内容も含まれることがあります:

3125 

3126```text theme={null}

3127Cloud sessions aren't available: api.anthropic.com didn't accept this session's credentials when Claude Code asked for your organization's policy. Cloud sessions use your claude.ai login. ANTHROPIC_API_KEY is set, so this session is using API-key auth — unset it (or run in a shell without it) to use cloud sessions.

3128```

3129 

3130v2.1.296 より前は、これらの失敗でも `Couldn't verify` メッセージが出力されていました。

3131 

3132**対処方法:**

3133 

3134* `Couldn't verify` メッセージの場合は、ネットワーク接続を確認して再試行します。セッション内の場合は、まず Claude Code を再起動します

3135* `Cloud sessions aren't available:` メッセージの場合は、プロキシの確認や、メッセージに示された認証情報の設定解除など、原因に応じた対処を行ってから、コマンドを再実行します

3136 

3137<h3 id="nothing-was-stashed-because-a-folder-replaced-a-tracked-file">

3138 追跡対象のファイルがフォルダーに置き換わったため何もスタッシュされなかった

3139</h3>

3140 

3141このメッセージは、チェックアウト内で、git が追跡しているファイルまたはリンクがあった場所にフォルダーが存在するようになったことを意味します。これは、`claude --teleport` や `/teleport` などで[クラウドセッション](/docs/ja/claude-code-on-the-web#from-cloud-to-terminal)をターミナルに取り込む際にスタッシュのオプションを選択した後に表示されます。その状態をスタッシュするとフォルダー内のファイルが削除される可能性があるため、Claude Code はスタッシュを拒否し、チェックアウトとインデックスを変更せずにそのままにします:

3142 

3143```text wrap theme={null}

3144Error: Nothing was stashed: "f" is now a folder in place of a tracked file or link, and stashing could delete what's in it for good. Commit the change or move the folder somewhere else, then try again.

3145```

3028 3146 

3029**対処方法:**3147**対処方法:**

3030 3148 

3031* 組織の [Owner](/docs/ja/server-managed-settings#access-control) に依頼して、[claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) の Claude Code 管理設定でクラウドセッションを有効にしてもらいます3149* メッセージのとおり、変更をコミットするかフォルダーを別の場所に移動してから、teleport を再実行します

3032* メッセージにポリシーを確認できなかったと表示されている場合は、ネットワーク接続を確認してから Claude Code を再起動し、再度試します

3033 3150 

3034<h3 id="the-json-schema-value-is-not-a-valid-json-schema">3151<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

3035 The `--json-schema` value is not a valid JSON Schema3152 The `--json-schema` value is not a valid JSON Schema

3036</h3>3153</h3>

3037 3154 

3038[非対話モード](/docs/ja/headless#get-structured-output)で [`--json-schema`](/docs/ja/cli-reference#cli-flags) に渡したスキーマが JSON Schema のコンパイルに失敗したため、`claude` はプロンプトを実行せずに終了コード 1 で終了します。v2.1.205 より前は、無効なスキーマによってエラーなしで非構造化の出力が生成され、`format` キーワードを使用するスキーマはすべて無効として扱われていました。3155[非対話モード](/docs/ja/headless#get-structured-output)で [`--json-schema`](/docs/ja/cli-reference#cli-flags) に渡したスキーマが JSON Schema のコンパイルに失敗したため、`claude` はプロンプトを実行せずに終了コード 1 で終了します。v2.1.205 より前は、無効なスキーマはエラーなしに構造化されていない出力を生成し、`format` キーワードを使用するスキーマはすべて無効として扱われていました。

3039 3156 

3040```text theme={null}3157```text theme={null}

3041Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values3158Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

3042```3159```

3043 3160 

30442 つ目のコロンの後のテキストはバリデーターの診断メッセージで、失敗したキーワードまたは場所を示します。`"format": "email"` のように `format` キーワードを使用するスキーマは有効です。Claude Code は `format` をアノテーションとして受け付け、それを強制しません。31612 つ目のコロンの後のテキストはバリデーターの診断メッセージで、失敗したキーワードまたは場所を示します。`"format": "email"` のように `format` キーワードを使用するスキーマは有効です。Claude Code は `format` を注釈として受け付け、その内容を強制しません。

3045 3162 

3046Claude Code はスキーマのコンパイル前に 2 つのチェックを実行します。解析可能な JSON でない値は `Error: --json-schema is not valid JSON` で拒否し、オブジェクトでない有効な JSON は `Error: --json-schema must be a JSON object` で拒否します。3163Claude Code はスキーマのコンパイルの前に 2 つのチェックを行います。解析可能な JSON でない値は `Error: --json-schema is not valid JSON` で、オブジェクトではない有効な JSON は `Error: --json-schema must be a JSON object` で拒否されます。

3047 3164 

3048**対処方法:**3165**対処方法:**

3049 3166 

3050* 診断メッセージが示すスキーマの箇所を修正してから、コマンドを再実行します3167* 診断メッセージが示すスキーマの部分を修正してから、コマンドを再実行します

3051* 動作するスキーマとコマンドについては、[構造化出力を取得する](/docs/ja/headless#get-structured-output)を参照してください3168* 動作するスキーマとコマンドの例については、[構造化された出力を取得する](/docs/ja/headless#get-structured-output)を参照してください

3052 3169 

3053<h3 id="settings-file-exceeds-the-2mib-limit">3170<h3 id="settings-file-exceeds-the-2mib-limit">

3054 Settings file exceeds the 2MiB limit3171 Settings file exceeds the 2MiB limit

3055</h3>3172</h3>

3056 3173 

3057[`--settings`](/docs/ja/cli-reference#cli-flags) に渡したファイルが 2 MiB を超えているため、`claude` はファイルを読み込まずに起動時に終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズチェックなしでファイルを読み取っていたため、数ギガバイトのファイルや `/dev/zero` のようなデバイスファイルによってメモリが際限なく増加していました。3174[`--settings`](/docs/ja/cli-reference#cli-flags) に渡したファイルが 2 MiB を超えているため、`claude` はファイルを読み込まずに起動時に終了コード 1 で終了します。v2.1.214 より前は、Claude Code はサイズをチェックせずにファイルを読み込んでいたため、数ギガバイトのファイルや `/dev/zero` などのデバイスファイルによってメモリが際限なく増加していました。

3058 3175 

3059```text theme={null}3176```text theme={null}

3060Error: Settings file exceeds the 2MiB limit: /path/to/settings.json3177Error: Settings file exceeds the 2MiB limit: /path/to/settings.json

3061```3178```

3062 3179 

3063Claude Code は、通常のファイルではない `--settings` パスも同様に拒否します。デバイス、FIFO、ソケットの場合はパスに続けて `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` が表示され、ディレクトリの場合は `EISDIR` の理由が表示されます。3180Claude Code は、通常のファイルではない `--settings` のパスも同じように拒否します。デバイス、FIFO、ソケットの場合は `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` の後にパスが表示され、ディレクトリの場合は `EISDIR` という理由が表示されます。

3064 3181 

3065**対処方法:**3182**対処方法:**

3066 3183 

3067* `--settings` には、2 MiB 未満の通常の JSON 設定ファイルを指定します。形式については[設定](/docs/ja/settings)を参照してください。3184* `--settings` には 2 MiB 未満の通常の JSON 設定ファイルを指定します。形式については[設定](/docs/ja/settings)を参照してください。

3068 3185 

3069<h3 id="the-current-directory-no-longer-exists">3186<h3 id="the-current-directory-no-longer-exists">

3070 The current directory no longer exists3187 The current directory no longer exists

3071</h3>3188</h3>

3072 3189 

3073シェルがディレクトリに入った後に削除または移動されたディレクトリ（たとえば、別のシェルが削除した worktree や一時ディレクトリ）から `claude` を開始しました。Claude Code は作業ディレクトリを読み取れないため、対話モードと[非対話](/docs/ja/headless)モードのどちらでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、Claude Code はこのメッセージの代わりに、圧縮されたバンドルのソースと生の `ENOENT ... uv_cwd` スタックを stderr に出力してクラッシュしていました。3190シェルがディレクトリに入った後に削除または移動されたディレクトリ（たとえば、別のシェルが削除した worktree や一時ディレクトリ）から `claude` を開始しました。Claude Code は作業ディレクトリを読み取れないため、対話モードでも[非対話](/docs/ja/headless)モードでも、セッションを開始する前に終了コード 1 で終了します。v2.1.239 より前は、このメッセージの代わりに、Claude Code はミニファイされたバンドルのソースと生の `ENOENT ... uv_cwd` スタックを stderr に出力してクラッシュしていました。

3074 3191 

3075```text theme={null}3192```text theme={null}

3076The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3193The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.

3077error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.3194error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.

3078```3195```

3079 3196 

3080どちらの形式も、原因と修正方法は同じです。3197どちらの形式でも、原因と修正方法は同じです。

3081 3198 

3082権限の変更など別の理由で Claude Code が作業ディレクトリを読み取れない場合、メッセージには代わりにエラーコードが表示されます: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`3199権限の変更など、別の理由で Claude Code が作業ディレクトリを読み取れない場合は、代わりにメッセージにエラーコードが示されます: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`

3083 3200 

3084macOS で、`~/Desktop`、`~/Documents`、`~/Downloads`、または iCloud Drive 内のディレクトリに対して `EPERM` が発生する場合、通常は macOS がターミナルアプリからそのフォルダへのアクセスをブロックしていることを意味します。そのフォルダを読み取る他のコマンドも同様に失敗します。そこで `ls` を実行すると、`sudo` を使用しても `Operation not permitted` が報告されます。3201macOS で、`~/Desktop`、`~/Documents`、`~/Downloads`、または iCloud Drive 内のディレクトリに対して `EPERM` が表示される場合、通常は macOS がターミナルアプリによるそのフォルダーへのアクセスをブロックしています。そのフォルダーを読み取る他のコマンドも同じように失敗します。そこで `ls` を実行すると、`sudo` を付けても `Operation not permitted` が表示されます。

3085 3202 

3086**対処方法:**3203**対処方法:**

3087 3204 

3088* ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、`claude` を再度実行します3205* ホームディレクトリやプロジェクトディレクトリなど、存在するディレクトリに移動してから、`claude` を再実行します

3089* 同じパスにディレクトリが再作成された場合、シェルはまだ削除されたディレクトリを保持しています。`cd "$PWD"` を実行するか、ディレクトリを出てから再度入り、`claude` を再度実行します3206* ディレクトリが同じパスに再作成された場合、シェルはまだ削除されたディレクトリを保持しています。`cd "$PWD"` を実行するか、ディレクトリから出て再び入ってから、`claude` を再実行します

3090* macOS で `EPERM` が発生する場合は、Cmd+Q でターミナルアプリを終了してから再度開き、そのフォルダに戻って `claude` を実行します。そのフォルダでまだ `ls` が失敗する場合は、**システム設定 > プライバシーとセキュリティ > ファイルとフォルダ** を開き、ターミナルアプリに対してそのフォルダをオンにしてから、ターミナルを開き直します3207* macOS で `EPERM` が表示される場合は、Cmd+Q でターミナルアプリを終了し、再度開いてそのフォルダーに戻ってから `claude` を実行します。それでもそのフォルダーで `ls` が失敗する場合は、**システム設定 > プライバシーとセキュリティ > ファイルとフォルダ** を開き、ターミナルアプリに対してそのフォルダーをオンにしてから、ターミナルを開き直します

3091 3208 

3092<h3 id="temp-directory-refused-or-cannot-be-created">3209<h3 id="temp-directory-refused-or-cannot-be-created">

3093 一時ディレクトリが拒否された、または作成できない3210 一時ディレクトリが拒否される、または作成できない

3094</h3>3211</h3>

3095 3212 

3096macOS と Linux では、Claude Code は起動時に、システムの一時ディレクトリまたは [`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) で上書きされたディレクトリの下に、プライベートな一時ディレクトリ `claude-<uid>` を作成します。ディレクトリを作成できない場合、またはそのパスに既に存在するエントリが安全性チェックに失敗した場合、Claude Code は失敗内容を stderr に出力し、セッションを開始せずに終了コード 1 で終了します:3213macOS と Linux では、Claude Code は起動時に、システムの一時ディレクトリまたは [`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) による上書き先の下に、専用の一時ディレクトリ `claude-<uid>` を作成します。ディレクトリを作成できない場合、またはそのパスにすでに存在するエントリが安全性チェックに失敗した場合、Claude Code はセッションを開始せずに、失敗内容を stderr に出力して終了コード 1 で終了します:

3097 3214 

3098```text wrap theme={null}3215```text wrap theme={null}

3099ENOSPC: no space left on device, mkdir '/tmp/claude-501'3216ENOSPC: no space left on device, mkdir '/tmp/claude-501'

3107 3224 

3108**対処方法:**3225**対処方法:**

3109 3226 

3110* `ENOSPC` の場合は、一時ディレクトリを含むボリュームのディスク容量を空けます3227* `ENOSPC` の場合は、一時ディレクトリがあるボリュームのディスク容量を空けます

3111* `Refusing to use it` の形式の場合は、リンクの参照先ではなく、表示されたエントリ自体を削除して Claude Code を再度開始します。`owned by uid` の形式の場合、削除できるのは管理者またはそのユーザーのみです3228* `Refusing to use it` を含む形式の場合は、リンクの参照先ではなく、示されたエントリ自体を削除してから、Claude Code を再起動します。`owned by uid` の形式の場合、削除できるのは管理者またはそのユーザーのみです

3112* `is not readable` の場合は、表示されたディレクトリに対して `chmod 0700` を実行するか、ディレクトリを削除して再度開始します3229* `is not readable` の場合は、示されたディレクトリに対して `chmod 0700` を実行するか、ディレクトリを削除してから再起動します

3113* いずれの場合も、拒否されたパスには手を付けずに、[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) を自分が管理するディレクトリに設定して Claude Code を再度開始できます3230* いずれの場合も、拒否されたパスには手を触れずに、[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) を自分が管理するディレクトリに設定して Claude Code を再起動することもできます

3114 3231 

3115<h3 id="directory-couldnt-be-resolved-to-a-real-location">3232<h3 id="directory-couldnt-be-resolved-to-a-real-location">

3116 Directory couldn't be resolved to a real location3233 Directory couldn't be resolved to a real location

3117</h3>3234</h3>

3118 3235 

3119作業ディレクトリのサブディレクトリに対して `/add-dir` を実行しましたが、Claude Code はそのディレクトリを実際の場所に解決できませんでした。3236作業ディレクトリのサブディレクトリに対して `/add-dir` を実行しましたが、Claude Code がそのディレクトリを実際の場所に解決できませんでした。

3120 3237 

3121作業ディレクトリのサブディレクトリには既にファイルアクセス権があるため、`/add-dir` はそのスキル、コマンド、エージェントのみを読み込みます。これらを読み込む前に、Claude Code はシンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることを確認します。その場所を解決できない場合、Claude Code は何も読み込まず、次のメッセージを表示します:3238作業ディレクトリのサブディレクトリにはすでにファイルアクセス権があるため、`/add-dir` はそのスキル、コマンド、エージェントを読み込むだけです。読み込む前に、Claude Code はシンボリックリンクを解決したディレクトリの実際の場所が作業ディレクトリ内にあることをチェックします。その場所を解決できない場合、Claude Code は何も読み込まずに次のメッセージを表示します:

3122 3239 

3123```text theme={null}3240```text theme={null}

3124packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.3241packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.

3126 3243 

3127**対処方法:**3244**対処方法:**

3128 3245 

3129* パスが作業ディレクトリ内の実在するディレクトリを指していることを確認してから、`/add-dir` を再度実行します3246* パスが作業ディレクトリ内の実在するディレクトリを指していることを確認してから、`/add-dir` を再実行します

3130* このメッセージはファイルアクセスを変更しません。ディレクトリの `.claude/` の内容が読み込まれなかったことを報告するだけです3247* このメッセージはファイルアクセスを変更しません。ディレクトリの `.claude/` の内容が読み込まれなかったことを報告しているだけです

3131 3248 

3132v2.1.261 より前は、作業ディレクトリが `/net/<host>` のオートマウント上にある場合、すべての `/add-dir <subdirectory>` でもこのメッセージが表示されていました。そこでは Claude Code は設計上パスの解決を行わないため、ディレクトリに問題はなく、再試行しても解決しませんでした。3249v2.1.261 より前は、作業ディレクトリが `/net/<host>` の自動マウント上にある場合、すべての `/add-dir <subdirectory>` でもこのメッセージが表示されていました。Claude Code は設計上そのようなパスを解決しないためで、ディレクトリには問題がなく、再試行しても解決しませんでした。

3133 3250 

3134<h3 id="workspace-not-trusted-when-starting-remote-control">3251<h3 id="workspace-not-trusted-when-starting-remote-control">

3135 Workspace not trusted when starting Remote Control3252 Workspace not trusted when starting Remote Control

3136</h3>3253</h3>