Documentation 2026-11-11 22:59 UTC to 2026-11-12 22:01 UTC

298 298 

299### ミラー書き込みはベストエフォート299### ミラー書き込みはベストエフォート

300 300 

301`append()` が拒否した場合、SDK は短いバックオフで最大 2 回まで再試行し、合計で最大 3 回の試行を行います。タイムアウトした呼び出しは再試行されません。元の呼び出しがまだ到達する可能性があるためです。バッチがまだ失敗した場合、SDK はエラーをログに記録し、`{ type: "system", subtype: "mirror_error" }` メッセージをイテレータに発行し、バッチを削除して、クエリを続行します。再試行されたバッチは既に到達したエントリを再配信できるため、`append()` 実装で `entry.uuid` によって重複排除してください。301`append()` が拒否した場合、SDK は短いバックオフで最大 2 回まで再試行し、合計で最大 3 回の試行を行います。タイムアウトした呼び出しは再試行されません。元の呼び出しがまだ到達する可能性があるためです。再試行されたバッチは既に到達したエントリを再配信する可能性があるため、`append()` 実装で `entry.uuid` によって重複排除し、`uuid` を持たないエントリはすべて保持してください。

302 302 

303ストア障害はエージェントを中断しません。サブプロセスはローカルに最初に書き込むためです。ストアデータ損失を検出する必要がある場合は `mirror_error` を監視してください。[ストアから再開](#resume-from-the-store)した実行では、削除されたバッチは実行終了後に存続するコピーがありません。303それでもバッチが失敗した場合、SDK はエラーをログに記録し、`{ type: "system", subtype: "mirror_error" }` メッセージをイテレータに発行し、バッチを破棄して、クエリを続行します。ストア障害はエージェントを中断しません。サブプロセスはローカルに最初に書き込むためです。ストアのデータ損失を検出するには `mirror_error` を監視してください。[ストアから再開](#resume-from-the-store)した実行では、破棄されたバッチは実行終了後に存続するコピーがありません。

304 304 

305### `getSessionMessages` は圧縮後のチェーンを返す305### `getSessionMessages` は圧縮後のチェーンを返す

306 306 

148 148 

149#### 組織の SSH および WSL プレビューでスクリプトをオフにする149#### 組織の SSH および WSL プレビューでスクリプトをオフにする

150 150 

151[SSH および WSL セッションでの HTML プレビュー](#preview-html-files-in-ssh-and-wsl-sessions)でスクリプトが実行されないようにするには、[`disableBrowserExternalNavigation` 管理設定](#managed-settings)を `true` に設定します。この設定を有効にすると、ユーザーは Browser ペインで[外部サイトを閲覧する](#restrict-external-browsing-for-your-organization)こともできなくなります。151[SSH および WSL セッションでの HTML プレビュー](#preview-html-files-in-ssh-and-wsl-sessions)でスクリプトが実行されないようにするには、[`disableRemotePreviewScripts` 管理設定](#managed-settings)を `true` に設定します。ユーザーは引き続き外部サイトを閲覧できます。Claude Desktop v5.1231.0 以降が必要です。

152 152 

153この設定は、[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)で行うか、Desktop を実行するコンピューター上の [Claude Code MDM ポリシーまたは管理設定ファイル](https://code.claude.com/docs/ja/managed-settings.md#where-each-mechanism-stores-the-policy)で行います。Desktop はリモートマシンや WSL ディストリビューションからこの設定を読み取りません。[サードパーティプロバイダー](https://code.claude.com/docs/ja/third-party-integrations.md)を使用する場合は、MDM ポリシーまたはファイルを使用します。153> [!NOTE]

154>

155> 以前のバージョンは `disableRemotePreviewScripts` を無視します。それらのバージョンでスクリプトを停止するには、Desktop を更新するか、`disableBrowserExternalNavigation` も `true` に設定します。その場合、`disableBrowserExternalNavigation` を受け取るすべてのコンピューターで、ユーザーは[外部サイトを閲覧できなくなります](#restrict-external-browsing-for-your-organization)。

156 

157各キーは、[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)で設定するか、Desktop を実行するコンピューター上の [Claude Code MDM ポリシーまたは管理設定ファイル](https://code.claude.com/docs/ja/managed-settings.md#where-each-mechanism-stores-the-policy)で設定します。Desktop は、リモートマシン、WSL ディストリビューション、[`policyHelper`](https://code.claude.com/docs/ja/settings-reference#policyhelper)、または [Desktop 独自のポリシー](#device-management-policies)からこれらのキーを読み取りません。[サードパーティプロバイダー](https://code.claude.com/docs/ja/third-party-integrations.md)を使用する場合は、MDM ポリシーまたはファイルを使用します。

154 158 

155> [!WARNING]159> [!WARNING]

156>160>

160 164 

161その後、設定が確実に適用されるようにユーザーに Desktop を再起動してもらい、次の動作について伝えます：165その後、設定が確実に適用されるようにユーザーに Desktop を再起動してもらい、次の動作について伝えます：

162 166 

163* **ユーザーが開くファイル**：プレビューでスクリプトが実行されないため、スクリプトで描画されるグラフや表は空のままになります167* **ユーザーが開くファイル**：プレビューでスクリプトが実行されないため、スクリプトで描画されるグラフや表は空のままになります。通知は `This preview doesn't run scripts` で始まります。

164* **スクリプトを実行中のプレビュー**：再起動前に Desktop が設定を取得した場合、プレビューは閉じます。ユーザーには `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.` と表示されます168* **スクリプトを実行中のプレビュー**：再起動前に Desktop が設定を取得した場合、プレビューは閉じます。ユーザーには `This preview closed because scripts are turned off for previews. Open the file again to view it without scripts.` と表示されます

165* **ユーザーがエクスポートするファイル**：ユーザーが[ファイルをエクスポート](#preview-html-files-in-ssh-and-wsl-sessions)してブラウザで開いた場合、この設定の有無にかかわらず、そのファイルのスクリプトはブラウザで実行されます169* **ユーザーがエクスポートするファイル**：ユーザーが[ファイルをエクスポート](#preview-html-files-in-ssh-and-wsl-sessions)してブラウザで開いた場合、この設定の有無にかかわらず、そのファイルのスクリプトはブラウザで実行されます

166 170 

171##### スクリプトがまだ実行されるコンピューターを確認する

172 

173再起動後、そのコンピューターで SSH または WSL セッションから HTML ファイルを開きます。プレビューの上の通知が `This preview doesn't load anything from the web` で始まる場合、そのコンピューターではまだスクリプトが実行されています。[Desktop のバージョン](#check-your-version)、キーを配置した場所、およびその値が JSON のブール値 `true` であることを確認してください。

174 

167### 外部サイトを閲覧する175### 外部サイトを閲覧する

168 176 

169Browser ペインはタブ付きブラウザなので、ドキュメント、issue トラッカー、または実行中のアプリの横に他のサイトを開くことができます。Browser を開くには、macOS で**Cmd+Shift+B**、Windows で**Ctrl+Shift+B**を押すか、セッションのタイトルバーにある **Browser** をクリックします。Google OAuth などのポップアップサインインフローを含め、ペイン内でサイトにサインインできます。177Browser ペインはタブ付きブラウザなので、ドキュメント、issue トラッカー、または実行中のアプリの横に他のサイトを開くことができます。Browser を開くには、macOS で**Cmd+Shift+B**、Windows で**Ctrl+Shift+B**を押すか、セッションのタイトルバーにある **Browser** をクリックします。Google OAuth などのポップアップサインインフローを含め、ペイン内でサイトにサインインできます。

2037| `browserExternalPageTools` | Claude が[Browser ペイン](#browse-external-sites)の外部ページを読み取るまたは操作するためのツールを使用するのを防ぐには`"disabled"`に設定します。ユーザーは引き続き外部サイトに自分でナビゲートできます。ローカル開発サーバープレビューは影響を受けません。 |2045| `browserExternalPageTools` | Claude が[Browser ペイン](#browse-external-sites)の外部ページを読み取るまたは操作するためのツールを使用するのを防ぐには`"disabled"`に設定します。ユーザーは引き続き外部サイトに自分でナビゲートできます。ローカル開発サーバープレビューは影響を受けません。 |

2038| `disableMobileSimulatorTools` | Claude の[iOS Simulator ペイン](https://code.claude.com/docs/ja/desktop-ios-simulator.md#turn-off-simulator-access)でデバイスを制御およびキャプチャするためのツールをブロックするには`true`に設定します。ペインはユーザー自身のタップに対して使用可能なままです。Claude のアクセスのみが削除されます。値は JSON ブール値`true`である必要があります。文字列`"true"`は無視されます。 |2046| `disableMobileSimulatorTools` | Claude の[iOS Simulator ペイン](https://code.claude.com/docs/ja/desktop-ios-simulator.md#turn-off-simulator-access)でデバイスを制御およびキャプチャするためのツールをブロックするには`true`に設定します。ペインはユーザー自身のタップに対して使用可能なままです。Claude のアクセスのみが削除されます。値は JSON ブール値`true`である必要があります。文字列`"true"`は無視されます。 |

2039| `disableBrowserExternalNavigation` | [Browser ペイン](#browse-external-sites)の外部ブラウジングを完全にオフにするには`true`に設定します。ユーザーも Claude も外部サイトにナビゲートできません。localhost 開発サーバープレビューは影響を受けません。SSH および WSL セッションの HTML プレビューでは[スクリプトは実行されません](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)。値は JSON ブール値`true`である必要があります。文字列`"true"`は無視されます。 |2047| `disableBrowserExternalNavigation` | [Browser ペイン](#browse-external-sites)の外部ブラウジングを完全にオフにするには`true`に設定します。ユーザーも Claude も外部サイトにナビゲートできません。localhost 開発サーバープレビューは影響を受けません。SSH および WSL セッションの HTML プレビューでは[スクリプトは実行されません](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)。値は JSON ブール値`true`である必要があります。文字列`"true"`は無視されます。 |

2048| `disableRemotePreviewScripts` | SSH および WSL セッションの HTML プレビューで[スクリプトのみをオフにする](#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization)には`true`に設定します。Desktop はこれをリモートマシンや WSL ディストリビューションからは読み取りません。値は JSON ブール値`true`である必要があります。文字列`"true"`は無視されます。Claude Desktop v5.1231.0 以降が必要です。 |

2040| `sshConfigs` | 環境セレクタに表示される[SSH 接続](#pre-configure-ssh-connections-for-your-team)を事前設定します。ユーザーは管理接続を削除できず、自分の **Worktree folder** 以外は編集できません。 |2049| `sshConfigs` | 環境セレクタに表示される[SSH 接続](#pre-configure-ssh-connections-for-your-team)を事前設定します。ユーザーは管理接続を削除できず、自分の **Worktree folder** 以外は編集できません。 |

2041| `sshHostCommands` | ユーザー自身の接続に加えて、[ホストがコマンドから取得される SSH 接続](#distribute-commands-to-your-team)をユーザーに提供します。Desktop はこれをコンピューター上の管理設定ファイルまたは MDM ポリシーから読み取り、[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)では無視します。macOS または Linux では Claude Desktop v3.6556.0 以降、Windows では v4.16336.0 以降が必要で、Claude アカウントでサインインしている必要があります。Windows では、Desktop が[OpenSSH クライアントを通じて接続する](#use-your-ssh-configuration)必要もあります。 |2050| `sshHostCommands` | ユーザー自身の接続に加えて、[ホストがコマンドから取得される SSH 接続](#distribute-commands-to-your-team)をユーザーに提供します。Desktop はこれをコンピューター上の管理設定ファイルまたは MDM ポリシーから読み取り、[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)では無視します。macOS または Linux では Claude Desktop v3.6556.0 以降、Windows では v4.16336.0 以降が必要で、Claude アカウントでサインインしている必要があります。Windows では、Desktop が[OpenSSH クライアントを通じて接続する](#use-your-ssh-configuration)必要もあります。 |

2042| `sshHostAllowlist` | [SSH セッション](#restrict-which-ssh-hosts-users-can-connect-to)を、解決されたホスト名がこれらのパターンのいずれかと一致するホストに制限します。管理設定からのみ読み取られます。 |2051| `sshHostAllowlist` | [SSH セッション](#restrict-which-ssh-hosts-users-can-connect-to)を、解決されたホスト名がこれらのパターンのいずれかと一致するホストに制限します。管理設定からのみ読み取られます。 |

2044| `disableSshSavedPasswords` | Desktop が SSH パスワードの保存を提案したり、以前に保存したパスワードを使用または表示したりしないようにするには`true`に設定します。オンにしても、保存済みのパスワードは削除されません。管理設定からのみ読み取られます。Claude Desktop v1.49585.0 以降が必要です。 |2053| `disableSshSavedPasswords` | Desktop が SSH パスワードの保存を提案したり、以前に保存したパスワードを使用または表示したりしないようにするには`true`に設定します。オンにしても、保存済みのパスワードは削除されません。管理設定からのみ読み取られます。Claude Desktop v1.49585.0 以降が必要です。 |

2045| `managedMcpServers` | MCP サーバー設定をすべてのユーザーにプッシュします。サードパーティ（3P）Desktop デプロイでのみ利用可能です。各エントリで、`"http"`、`"sse"`、または`"stdio"`のトランスポート、接続詳細、およびオプションで、そのサーバーのどのツールをユーザーが呼び出せるかを制限する`toolPolicy`マップを設定します。管理設定ファイル、MDM、または Claude apps gateway ポリシーの[`desktop`ブロック](https://code.claude.com/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)を通じて配信します。3P デプロイは管理コンソール設定を受け取らないためです。ゲートウェイを通じて配信するには、ゲートウェイサーバーで Claude Code v2.1.232 以降が必要です。これはデスクトップアプリ自体のキーです。Claude Code は、異なるエントリ形状を持つ、同じ名前の[管理設定](https://code.claude.com/docs/ja/managed-mcp.md#provide-servers-through-managed-settings)を読み取ります。 |2054| `managedMcpServers` | MCP サーバー設定をすべてのユーザーにプッシュします。サードパーティ（3P）Desktop デプロイでのみ利用可能です。各エントリで、`"http"`、`"sse"`、または`"stdio"`のトランスポート、接続詳細、およびオプションで、そのサーバーのどのツールをユーザーが呼び出せるかを制限する`toolPolicy`マップを設定します。管理設定ファイル、MDM、または Claude apps gateway ポリシーの[`desktop`ブロック](https://code.claude.com/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)を通じて配信します。3P デプロイは管理コンソール設定を受け取らないためです。ゲートウェイを通じて配信するには、ゲートウェイサーバーで Claude Code v2.1.232 以降が必要です。これはデスクトップアプリ自体のキーです。Claude Code は、異なるエントリ形状を持つ、同じ名前の[管理設定](https://code.claude.com/docs/ja/managed-mcp.md#provide-servers-through-managed-settings)を読み取ります。 |

2046 2055 

2047コンピューターの[最上位の MDM ポリシーまたは管理設定ファイル](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources)で`browserExternalPageTools`、`disableMobileSimulatorTools`、または`disableBrowserExternalNavigation`を使用して機能をオフにすると、そのコンピューターではその機能がオフのままになります。[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)でそのキーが未設定の場合や、その機能が許可されている場合でも、オフのままです。この目的でユーザーレベルの`HKCU`レジストリ値を使用しないでください。機能をオンに戻すには、値を設定した場所からその値を削除してください。Claude Desktop v4.4212.0 以降が必要です。2056コンピューターの[最上位の MDM ポリシーまたは管理設定ファイル](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources)でこれら 4 つのキーのいずれかを使用して機能をオフにすると、そのコンピューターではその機能がオフのままになります：

2057 

2058* **`browserExternalPageTools`、`disableMobileSimulatorTools`、`disableBrowserExternalNavigation`**：Claude Desktop v4.4212.0 以降が必要です

2059* **`disableRemotePreviewScripts`**：Claude Desktop v5.1231.0 以降が必要です

2060 

2061[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)でそのキーが未設定の場合や、その機能が許可されている場合でも、オフのままです。この目的でユーザーレベルの`HKCU`レジストリ値を使用しないでください。機能をオンに戻すには、値を設定した場所からその値を削除してください。

2048 2062 

2049Desktop セッションがどこで実行されるかに応じて、どの管理設定がそのセッションに到達するかが異なります。[`availableModels`](https://code.claude.com/docs/ja/model-config#restrict-model-selection)などのモデル制限は、Desktop の Claude Code セッションでターミナル CLI と同じ方法で適用されます。[surface coverage](https://code.claude.com/docs/ja/model-config.md#surface-coverage)を参照してください。2063Desktop セッションがどこで実行されるかに応じて、どの管理設定がそのセッションに到達するかが異なります。[`availableModels`](https://code.claude.com/docs/ja/model-config#restrict-model-selection)などのモデル制限は、Desktop の Claude Code セッションでターミナル CLI と同じ方法で適用されます。[surface coverage](https://code.claude.com/docs/ja/model-config.md#surface-coverage)を参照してください。

2050 2064 

2109>2123>

2110> デプロイする前に`forceLoginOrgUUID`の値を確認してください。ID が自組織のものでない場合、組織のメンバーは、その ID を持つ組織にも所属していない限り Claude Desktop を使用できません。復旧するには、正しい ID をデプロイし、メンバーに Claude Desktop を再起動してもらってください。2124> デプロイする前に`forceLoginOrgUUID`の値を確認してください。ID が自組織のものでない場合、組織のメンバーは、その ID を持つ組織にも所属していない限り Claude Desktop を使用できません。復旧するには、正しい ID をデプロイし、メンバーに Claude Desktop を再起動してもらってください。

2111 2125 

2112Claude Code の[管理設定](https://code.claude.com/docs/ja/managed-settings.md)で`forceLoginMethod`と`forceLoginOrgUUID`を設定しても、Claude Desktop のサインイン画面は変わりません。2126Claude Code の[管理設定](https://code.claude.com/docs/ja/managed-settings.md)で`forceLoginMethod`と`forceLoginOrgUUID`を設定しても、Claude Desktop のサインイン画面は変わりません。ユーザーは引き続き、自分の Claude API キーまたは[Claude Console アカウント](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in)で Claude Desktop を使用し、その方法で Code タブセッションを実行できます。

2127 

2128これを防ぐには、Claude Desktop ポリシー（Windows では`HKLM`）にも、claude.ai 組織 ID を指定して`forceLoginOrgUUID`をデプロイしてください。ポリシー自体が[Claude API を選択](https://claude.com/docs/third-party/claude-desktop/claude-api#choose-an-authentication-approach)している場合を除き、Claude Desktop はアプリの次回起動時から、ユーザー自身の API キーまたは Console アカウントを使用しなくなります。

2129 

2130デプロイする前に、次の 2 つのケースを確認してください：

2131 

2132* **Claude Console 組織**：Claude Console 組織の ID を指定して`forceLoginOrgUUID`を単独でデプロイしないでください。そうすると、組織のメンバーが Claude Desktop を使用できなくなります。代わりに[Which devices offer the Claude API account sign-in](https://claude.com/docs/third-party/claude-desktop/claude-api#which-devices-offer-the-claude-api-account-sign-in)を参照してください。

2133* **Enterprise Admin Console**：これがコンピューターの Claude Desktop 設定を配信している場合は、先にそれらのコンピューターを Claude Desktop v2.37337.0 以降に更新してください。それより前のバージョンでは、このキーが設定されるとその設定が無視されるためです。[Keep a device on its managed profile](https://claude.com/docs/third-party/claude-desktop/admin-console#keep-a-device-on-its-managed-profile)を参照してください。

2113 2134 

2114### ネットワークアクセス要件2135### ネットワークアクセス要件

2115 2136 

5466This conversation is already open in another running Claude session — use that one, or close it and try again5466This conversation is already open in another running Claude session — use that one, or close it and try again

5467```5467```

5468 5468 

5469* **`running in another terminal`**：ターミナルが会話を保持しています。例えば、`claude --resume` または `/resume` で再開したターミナル。行には `Open in a terminal` も表示されます。5469* **`running in another terminal`**：バックグラウンドセッション以外のプロセスが会話を保持しています。例えば、`claude -p` の実行や、`claude --resume` または `/resume` で会話を再開したターミナルです。行には `Open in a terminal` も表示されます。

5470* **`already open in another running Claude session`**：別の非対話型 Claude Code プロセスがそれを保持しています。例えば、同じ会話の[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#the-supervisor-process)プロセスがまだ終了していません。5470* **`already open in another running Claude session`**：別の[バックグラウンドセッション](https://code.claude.com/docs/ja/agent-view.md#the-supervisor-process)が会話を保持しています。

5471 5471 

5472**対処方法：**5472**対処方法：**

5473 5473 

5474* 会話を開いているプロセスで会話を続けるか、そのプロセスを終了して行を再度開きます5474* `running in another terminal` の場合：そのターミナルで続行するか、そのプロセスを終了するか完了させてから、再度試します

5475* `already open in another running Claude session` の場合：そのセッションを使用するか、そのセッションを停止してから、再度試します

5475 5476 

5476v2.1.248 より前では、`already open in another running Claude session` 拒否のみが存在していました：ターミナルで再開された会話は開いているとはカウントされず、行を開くと同じ会話に書き込む 2 番目の Claude Code プロセスが開始されました。5477v2.1.248 より前では、`already open in another running Claude session` 拒否のみが存在していました：ターミナルで再開された会話は開いているとはカウントされず、行を開くと同じ会話に書き込む 2 番目の Claude Code プロセスが開始されました。

5477 5478 

218 218 

219## Claude Code に組み込まれた Mod219## Claude Code に組み込まれた Mod

220 220 

221Claude Code 独自の機能の一部は mod です。セッションが持つものを確認するには、Claude Code プロンプトで `/plugin` を実行し、**Installed** タブに移動します。これは **Built-in** の下にリストしています。組み込み mod を更新またはアンインストールすることはできず、テーブルの最後の列は各々をオフにする方法を示しています。[`mods active` 行](#see-which-mods-a-session-loaded) は組み込み mod を除外しています。221Claude Code 独自の機能の一部は mod です。セッションが持つものを確認するには、Claude Code プロンプトで `/plugin` を実行し、**Installed** タブに移動します。これは **Built-in** の下にリストしています。組み込み mod を更新またはアンインストールすることはできません。[`mods active` 行](#see-which-mods-a-session-loaded) は組み込み mod を除外しています。

222 222 

223このテーブルは `/plugin` が表示する名前で各エントリをリストしています。223このテーブルは、**Built-in** のエントリの一部を `/plugin` が表示する名前でリストしています。

224 224 

225| `/plugin` の名前 | 何をするか | どこでオンか | オフにする方法 |225| `/plugin` の名前 | 何をするか | どこでオンか | オフにする方法 |

226| :- | :- | :- | :- |226| :- | :- | :- | :- |

231| `cc-plugin-telemetry` | Claude Code とその組み込み mod がログするアナリティクスレコードを送信する | Claude Code 独自のアナリティクスがオンの場所 | `/plugin` で無効化するか、アナリティクスをオフにします。たとえば [`DISABLE_TELEMETRY`](https://code.claude.com/docs/ja/env-vars) で |231| `cc-plugin-telemetry` | Claude Code とその組み込み mod がログするアナリティクスレコードを送信する | Claude Code 独自のアナリティクスがオンの場所 | `/plugin` で無効化するか、アナリティクスをオフにします。たとえば [`DISABLE_TELEMETRY`](https://code.claude.com/docs/ja/env-vars) で |

232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/ja/interactive-mode.md#you-should-know-suggestions): サイドエージェントが、ユーザーが見落としている可能性のあるものを見つけると、プロンプトの上にメモを表示する | [オンにする](https://code.claude.com/docs/ja/interactive-mode.md#you-should-know-suggestions)までオフ | `/plugin` で無効化 |232| `cc-plugin-you-should-know` | [You should know](https://code.claude.com/docs/ja/interactive-mode.md#you-should-know-suggestions): サイドエージェントが、ユーザーが見落としている可能性のあるものを見つけると、プロンプトの上にメモを表示する | [オンにする](https://code.claude.com/docs/ja/interactive-mode.md#you-should-know-suggestions)までオフ | `/plugin` で無効化 |

233 233 

234テーブルにない **Built-in** プラグインについては、[`/plugin` でその詳細を開き](https://code.claude.com/docs/ja/plugins/install#manage-installed-plugins)、何をするかを確認するか、無効化します。

235 

234`disableAllHooks`、`--bare`、`--safe-mode` など、インストール済み mod を停止する設定やフラグは、組み込み mod を停止しません。236`disableAllHooks`、`--bare`、`--safe-mode` など、インストール済み mod を停止する設定やフラグは、組み込み mod を停止しません。

235 237 

236### 組み込み mod のソースを読む238### 組み込み mod のソースを読む

194| `session.receive` | `($, e) => ({ text: e.text })`。`$.session.receive({ origin: { kind: 'peer-send-message' }, text })` で発生させます。 |194| `session.receive` | `($, e) => ({ text: e.text })`。`$.session.receive({ origin: { kind: 'peer-send-message' }, text })` で発生させます。 |

195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |195| `ui.render` | `() => ({ type: 'Text', props: {}, children: ['...'] })` |

196 196 

197`expect` には `toBe`、`toEqual`、`toMatch`、`toMatchObject`、`toContain`、`toBeDefined`、`toBeUndefined`、`toThrow` のアサーションがあり、いずれの前にも `.not` を付けられます。197### `expect` で結果を確認する

198 

199キットには次のアサーションがあります。選んだアサーションは、`expect(answer.text).toBe('ok')` のように、確認する値の後に続けます。

200 

201* **等価性**: 同じ値またはオブジェクトには `toBe`、構造には `toEqual`、構造に加えて `undefined` フィールドとプロトタイプも比較するには `toStrictEqual`、指定したフィールドには `toMatchObject`

202* **テキスト**: 正規表現または部分文字列を受け取る `toMatch`、`toStartWith`、`toEndWith`

203* **数値**: `toBeGreaterThan`、`toBeGreaterThanOrEqual`、`toBeLessThan`、`toBeLessThanOrEqual`

204* **内容**: 部分文字列またはメンバーには `toContain`、構造で比較するメンバーには `toContainEqual`、`toHaveLength`、`toHaveProperty`

205* **存在と型**: `toBeDefined`、`toBeUndefined`、`toBeNull`、`toBeTruthy`、`toBeFalsy`、`toBeNaN`、`toBeInstanceOf`

206* **スロー**: `toThrow`。`expect` が呼び出す関数、または `.rejects` で確認する promise に対して使います

207 

208アサーションの前に `.not` を付けると逆の条件を確認でき、`.resolves` または `.rejects` を付けると promise が何で確定するかを確認できます。

198 209 

199非同期ジェネレーターではなくプレーンな関数として `on` に渡したスタブまたはフックの中で `expect` が失敗すると、テストは失敗します。エンジンはそのフックをスキップし、失敗時の出力には `in the test's store.set hook` のようにそのフックの名前が示されます。210非同期ジェネレーターではなくプレーンな関数として `on` に渡したスタブまたはフックの中で `expect` が失敗すると、テストは失敗します。エンジンはそのフックをスキップし、失敗時の出力には `in the test's store.set hook` のようにそのフックの名前が示されます。

200 211 

86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | プロジェクトの [`.mcp.json`](https://code.claude.com/docs/ja/mcp#project-scope) にある特定のサーバーを拒否します | MCP | Any file |86| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | プロジェクトの [`.mcp.json`](https://code.claude.com/docs/ja/mcp#project-scope) にある特定のサーバーを拒否します | MCP | Any file |

87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | [デスクトップ](https://code.claude.com/docs/ja/desktop.md)の iOS Simulator ペインで Claude のツールをブロックします | ツール | Managed |87| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | [デスクトップ](https://code.claude.com/docs/ja/desktop.md)の iOS Simulator ペインで Claude のツールをブロックします | ツール | Managed |

88| [`disableRemoteControl`](#disableremotecontrol) | [Remote Control](https://code.claude.com/docs/ja/remote-control.md) を、起動可能なすべての場所でオフにします | リモート、デスクトップ、通知 | Any file |88| [`disableRemoteControl`](#disableremotecontrol) | [Remote Control](https://code.claude.com/docs/ja/remote-control.md) を、起動可能なすべての場所でオフにします | リモート、デスクトップ、通知 | Any file |

89| [`disableRemotePreviewScripts`](#disableremotepreviewscripts) | SSH および WSL セッションで、[デスクトップ](https://code.claude.com/docs/ja/desktop.md#preview-html-files-in-ssh-and-wsl-sessions)アプリの HTML プレビュー内のスクリプトをオフにします | リモート、デスクトップ、通知 | Managed |

89| [`disableSideloadFlags`](#disablesideloadflags) | [プラグイン](https://code.claude.com/docs/ja/plugins/overview.md)、[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)、[MCP サーバー](https://code.claude.com/docs/ja/mcp.md)をサイドロードする CLI フラグを拒否します | エンタープライズと管理設定 | Managed |90| [`disableSideloadFlags`](#disablesideloadflags) | [プラグイン](https://code.claude.com/docs/ja/plugins/overview.md)、[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)、[MCP サーバー](https://code.claude.com/docs/ja/mcp.md)をサイドロードする CLI フラグを拒否します | エンタープライズと管理設定 | Managed |

90| [`disableSkillShellExecution`](#disableskillshellexecution) | [スキル](https://code.claude.com/docs/ja/skills.md)とカスタムコマンドがインラインでシェルを実行しないようにします | プラグインとスキル | Any file |91| [`disableSkillShellExecution`](#disableskillshellexecution) | [スキル](https://code.claude.com/docs/ja/skills.md)とカスタムコマンドがインラインでシェルを実行しないようにします | プラグインとスキル | Any file |

91| [`disableWorkflows`](#disableworkflows) | 全員に対して[動的ワークフロー](https://code.claude.com/docs/ja/workflows.md)をオフにします。自分だけに適用する場合は `enableWorkflows` を使用します | フックと自動化 | Any file |92| [`disableWorkflows`](#disableworkflows) | 全員に対して[動的ワークフロー](https://code.claude.com/docs/ja/workflows.md)をオフにします。自分だけに適用する場合は `enableWorkflows` を使用します | フックと自動化 | Any file |

147| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | [Claude Code 自身の一部のファイル](#what-the-write-block-refuses-and-what-stays-writable)を除き、すべての権限モードで `Write`、`Edit`、`NotebookEdit` ツールが[作業ディレクトリ](https://code.claude.com/docs/ja/permissions.md#working-directories)外のパスを拒否するようにします | 権限設定 | Any file |148| [`permissions.blockWritesOutsideWorkingDirectories`](#permissions-blockwritesoutsideworkingdirectories) | [Claude Code 自身の一部のファイル](#what-the-write-block-refuses-and-what-stays-writable)を除き、すべての権限モードで `Write`、`Edit`、`NotebookEdit` ツールが[作業ディレクトリ](https://code.claude.com/docs/ja/permissions.md#working-directories)外のパスを拒否するようにします | 権限設定 | Any file |

148| [`permissions.defaultMode`](#permissions-defaultmode) | 新しいセッションのデフォルトの[権限モード](https://code.claude.com/docs/ja/permission-modes.md#which-mode-a-session-starts-in)を設定します | 権限設定 | Any file |149| [`permissions.defaultMode`](#permissions-defaultmode) | 新しいセッションのデフォルトの[権限モード](https://code.claude.com/docs/ja/permission-modes.md#which-mode-a-session-starts-in)を設定します | 権限設定 | Any file |

149| [`permissions.deny`](#permissions-deny) | シークレットを含むファイルの読み取りなど、列挙した[ツールの使用](https://code.claude.com/docs/ja/permissions.md#permission-rule-syntax)をブロックします | 権限設定 | Any file |150| [`permissions.deny`](#permissions-deny) | シークレットを含むファイルの読み取りなど、列挙した[ツールの使用](https://code.claude.com/docs/ja/permissions.md#permission-rule-syntax)をブロックします | 権限設定 | Any file |

151| [`permissions.denyInsteadOfPrompting`](#permissions-denyinsteadofprompting) | [権限プロンプト](https://code.claude.com/docs/ja/permissions.md#permission-system)で待機することになるツール呼び出しを拒否し、誰も見ていないセッションでも作業を続けられるようにします | 権限設定 | User or managed |

150| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 誰も [bypassPermissions モード](https://code.claude.com/docs/ja/permission-modes.md#skip-all-checks-with-bypasspermissions-mode)に入れないようにします | 権限設定 | Any file |152| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 誰も [bypassPermissions モード](https://code.claude.com/docs/ja/permission-modes.md#skip-all-checks-with-bypasspermissions-mode)に入れないようにします | 権限設定 | Any file |

151| [`plansDirectory`](#plansdirectory) | [plan モード](https://code.claude.com/docs/ja/permission-modes.md#analyze-before-you-edit-with-plan-mode)がプランファイルを書き込む場所を選択します | メモリとコンテキスト | Any file |153| [`plansDirectory`](#plansdirectory) | [plan モード](https://code.claude.com/docs/ja/permission-modes.md#analyze-before-you-edit-with-plan-mode)がプランファイルを書き込む場所を選択します | メモリとコンテキスト | Any file |

152| [`pluginConfigs`](#pluginconfigs) | [プラグイン](https://code.claude.com/docs/ja/plugins/overview.md)の設定ダイアログで入力した回答を保存します | プラグインとスキル | User or managed |154| [`pluginConfigs`](#pluginconfigs) | [プラグイン](https://code.claude.com/docs/ja/plugins/overview.md)の設定ダイアログで入力した回答を保存します | プラグインとスキル | User or managed |

228| [`statusLine`](#statusline) | 独自のコマンドを実行して、プロンプトの下に[ステータスライン](https://code.claude.com/docs/ja/statusline.md)をレンダリングします | インターフェースとターミナル | Any file |230| [`statusLine`](#statusline) | 独自のコマンドを実行して、プロンプトの下に[ステータスライン](https://code.claude.com/docs/ja/statusline.md)をレンダリングします | インターフェースとターミナル | Any file |

229| [`strictKnownMarketplaces`](#strictknownmarketplaces) | ユーザーが追加してインストール元にできる[マーケットプレイス](https://code.claude.com/docs/ja/plugins/overview.md)のソースの許可リストを指定します | プラグインとスキル | Managed |231| [`strictKnownMarketplaces`](#strictknownmarketplaces) | ユーザーが追加してインストール元にできる[マーケットプレイス](https://code.claude.com/docs/ja/plugins/overview.md)のソースの許可リストを指定します | プラグインとスキル | Managed |

230| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | ユーザーとプロジェクトのソースからの[スキル](https://code.claude.com/docs/ja/skills.md)、[エージェント](https://code.claude.com/docs/ja/sub-agents.md)、[フック](https://code.claude.com/docs/ja/hooks.md)、[MCP サーバー](https://code.claude.com/docs/ja/mcp.md)をブロックします | プラグインとスキル | Managed |232| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | ユーザーとプロジェクトのソースからの[スキル](https://code.claude.com/docs/ja/skills.md)、[エージェント](https://code.claude.com/docs/ja/sub-agents.md)、[フック](https://code.claude.com/docs/ja/hooks.md)、[MCP サーバー](https://code.claude.com/docs/ja/mcp.md)をブロックします | プラグインとスキル | Managed |

231| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | [エージェント](https://code.claude.com/docs/ja/sub-agents.md)をプラグインと管理ソースに限定します | プラグインとスキル | Managed |233| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | ユーザーとプロジェクトのソースからの[エージェント](https://code.claude.com/docs/ja/sub-agents.md)をブロックします | プラグインとスキル | Managed |

232| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | [フック](https://code.claude.com/docs/ja/hooks.md)をプラグインと管理ソースに限定します | プラグインとスキル | Managed |234| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | ユーザーとプロジェクトのソースからの[フック](https://code.claude.com/docs/ja/hooks.md)をブロックします | プラグインとスキル | Managed |

233| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | [MCP サーバー](https://code.claude.com/docs/ja/mcp.md)をプラグインと管理ソースに限定します | プラグインとスキル | Managed |235| [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | ユーザーとプロジェクトのソースからの [MCP サーバー](https://code.claude.com/docs/ja/mcp.md)をブロックします | プラグインとスキル | Managed |

234| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | [スキル](https://code.claude.com/docs/ja/skills.md)をプラグインと管理ソースに限定します | プラグインとスキル | Managed |236| [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | ユーザーとプロジェクトのソースからの[スキル](https://code.claude.com/docs/ja/skills.md)をブロックします | プラグインとスキル | Managed |

235| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | サブエージェントおよびメイン会話以外のリクエストの[プロンプトキャッシュの有効期間](https://code.claude.com/docs/ja/prompt-caching.md#cache-lifetime)を選択します | モデルと応答 | Any file |237| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | サブエージェントおよびメイン会話以外のリクエストの[プロンプトキャッシュの有効期間](https://code.claude.com/docs/ja/prompt-caching.md#cache-lifetime)を選択します | モデルと応答 | Any file |

236| [`subagentStatusLine`](#subagentstatusline) | 独自のコマンドで、[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)のタスク表示の行を書き換えます | インターフェースとターミナル | Any file |238| [`subagentStatusLine`](#subagentstatusline) | 独自のコマンドで、[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)のタスク表示の行を書き換えます | インターフェースとターミナル | Any file |

237| [`switchModelsOnFlag`](#switchmodelsonflag) | [安全性分類器](https://code.claude.com/docs/ja/model-config.md#ask-before-switching)がリクエストを警告したときに、モデルを自動で切り替えるか一時停止します | モデルと応答 | Any file |239| [`switchModelsOnFlag`](#switchmodelsonflag) | [安全性分類器](https://code.claude.com/docs/ja/model-config.md#ask-before-switching)がリクエストを警告したときに、モデルを自動で切り替えるか一時停止します | モデルと応答 | Any file |

288}290}

289```291```

290 292 

291このキーは、Amazon Bedrock や Claude Platform on AWS など、advisor が[利用できない](https://code.claude.com/docs/ja/advisor.md#requirements)プロバイダーでは効果がありません。`"fable"` には [Fable へのアクセス](https://code.claude.com/docs/ja/advisor.md#choose-an-advisor-model)が必要です。293このキーは、Amazon Bedrock など、advisor が[利用できない](https://code.claude.com/docs/ja/advisor.md#requirements)プロバイダーでは効果がありません。Claude Platform on AWS では、このキーには Claude Code v2.1.300 以降が必要です。`"fable"` には [Fable へのアクセス](https://code.claude.com/docs/ja/advisor.md#choose-an-advisor-model)が必要です。

292 294 

293### `alwaysThinkingEnabled`295### `alwaysThinkingEnabled`

294 296 

448 450 

449利用可能なセッションで [fast mode](https://code.claude.com/docs/ja/fast-mode.md) をオンにします。トークンあたりのコストが高くても速度を優先したい、迅速な反復作業やライブデバッグなどの対話的な作業向けです。通常、このキーを手動で編集することはありません。`/fast` を実行すると `~/.claude/settings.json` に `fastMode: true` が書き込まれ、もう一度実行して fast mode をオフにするとキーが削除されます。451利用可能なセッションで [fast mode](https://code.claude.com/docs/ja/fast-mode.md) をオンにします。トークンあたりのコストが高くても速度を優先したい、迅速な反復作業やライブデバッグなどの対話的な作業向けです。通常、このキーを手動で編集することはありません。`/fast` を実行すると `~/.claude/settings.json` に `fastMode: true` が書き込まれ、もう一度実行して fast mode をオフにするとキーが削除されます。

450 452 

451fast mode をサポートしているのは Fable 5.2、Opus 5.5、Opus 5、Opus 4.8 のみです。他のモデルで `/fast` を実行すると Opus に切り替わり、サポートされていないモデルに切り替えると fast mode はオフになります。[fast mode がオンの状態でモデルを切り替える](https://code.claude.com/docs/ja/fast-mode.md#switch-models-while-fast-mode-is-on)を参照してください。453Anthropic API で fast mode をサポートしているのは Fable 5.2、Opus 5.5、Opus 5、Opus 4.8 のみです。他のモデルで `/fast` を実行すると Opus に切り替わり、サポートされていないモデルに切り替えると fast mode はオフになります。[fast mode がオンの状態でモデルを切り替える](https://code.claude.com/docs/ja/fast-mode.md#switch-models-while-fast-mode-is-on)を参照してください。Google Cloud's Agent Platform では、代わりに [`/fast` によって Fable 5.2 に切り替わり](https://code.claude.com/docs/ja/fast-mode#use-fast-mode-on-agent-platform)、このキーは書き込まれません。また、Claude Code は保存された `true` を無視します。

452 454 

453* **スコープ**: [`Any file`](#scopes)455* **スコープ**: [`Any file`](#scopes)

454* **型**: Boolean456* **型**: Boolean

904Claude が確認なしで使用できるツール、プロンプトを表示するツール、ブロックされるツールを制御します。また、新しいセッションのデフォルトの[権限モード](https://code.claude.com/docs/ja/permission-modes.md)も設定します。以下のすべての `permissions.*` キーはこのオブジェクトの下にネストされます。906Claude が確認なしで使用できるツール、プロンプトを表示するツール、ブロックされるツールを制御します。また、新しいセッションのデフォルトの[権限モード](https://code.claude.com/docs/ja/permission-modes.md)も設定します。以下のすべての `permissions.*` キーはこのオブジェクトの下にネストされます。

905 907 

906* **スコープ**: [`Any file`](#scopes)908* **スコープ**: [`Any file`](#scopes)

907* **タイプ**: `allow`、`ask`、`deny`、`additionalDirectories`、`blockReadsOutsideWorkingDirectories`、`blockWritesOutsideWorkingDirectories`、`defaultMode`、`disableBypassPermissionsMode`、`disableAutoMode` を含むオブジェクト909* **タイプ**: `allow`、`ask`、`deny`、`additionalDirectories`、`blockReadsOutsideWorkingDirectories`、`blockWritesOutsideWorkingDirectories`、`defaultMode`、`denyInsteadOfPrompting`、`disableBypassPermissionsMode`、`disableAutoMode` を含むオブジェクト

908* **デフォルト**: 未設定910* **デフォルト**: 未設定

909 911 

910この例は `npm run` コマンドを確認なしで承認し、`git push` の前にプロンプトを表示し、`.env` の読み取りをブロックし、セッションを `acceptEdits` で開始します。912この例は `npm run` コマンドを確認なしで承認し、`git push` の前にプロンプトを表示し、`.env` の読み取りをブロックし、セッションを `acceptEdits` で開始します。

1163 1165 

1164権限ルールはすべてのモードの上に重ねて適用されます。`deny` ルールは `bypassPermissions` を含むすべてのモードでブロックします。[権限モード](https://code.claude.com/docs/ja/permission-modes.md)を参照してください。クラウドセッションでは、Claude Code はこのキーのうち `acceptEdits`、`plan`、`default`、`auto` のみを尊重します。VS Code 拡張機能が開始する会話については、[拡張機能が開始権限モードとして読み取る設定](https://code.claude.com/docs/ja/permission-modes.md#switch-permission-modes)を参照してください。1166権限ルールはすべてのモードの上に重ねて適用されます。`deny` ルールは `bypassPermissions` を含むすべてのモードでブロックします。[権限モード](https://code.claude.com/docs/ja/permission-modes.md)を参照してください。クラウドセッションでは、Claude Code はこのキーのうち `acceptEdits`、`plan`、`default`、`auto` のみを尊重します。VS Code 拡張機能が開始する会話については、[拡張機能が開始権限モードとして読み取る設定](https://code.claude.com/docs/ja/permission-modes.md#switch-permission-modes)を参照してください。

1165 1167 

1168### `permissions.denyInsteadOfPrompting`

1169 

1170権限プロンプトに応答する人がいないときにセッションを実行し続けるには、これを `true` に設定します。Claude Code は、本来であればプロンプトを待つツール呼び出しを拒否し、ターンは続行されます。Claude Code v2.1.319 以降が必要です。

1171 

1172許可ルール、[権限モード](https://code.claude.com/docs/ja/permission-modes.md)、または auto モードの分類器が承認した呼び出しは実行されます。本来であればプロンプトを表示するほとんどの呼び出しを許可するには、[`PermissionRequest` フック](https://code.claude.com/docs/ja/hooks#permissionrequest)から応答します。

1173 

1174* **スコープ**: [`User or managed`](#scopes)、および `--settings`。リポジトリがこれを設定することはできません。

1175* **タイプ**: ブール値

1176 * `true`: Claude Code は本来であればプロンプトを表示する呼び出しを拒否します

1177 * `false`: 未設定と同じです。これらのソースの別のものが `true` を設定している場合、呼び出しは引き続き拒否されます

1178* **デフォルト**: 未設定。承認が必要な呼び出しではプロンプトが表示されます

1179 

1180`~/.claude/settings.json` でのこの例は、セッションを auto モードで開始し、それでもプロンプトにフォールバックするものをすべて拒否します。

1181 

1182```json settings.json theme={null}

1183{

1184 "permissions": {

1185 "defaultMode": "auto",

1186 "denyInsteadOfPrompting": true

1187 }

1188}

1189```

1190 

1191このキーは、`-p` 実行、対話型ターミナルセッション、[VS Code 拡張機能](https://code.claude.com/docs/ja/vs-code.md)、[Desktop アプリ](https://code.claude.com/docs/ja/desktop.md)のローカルセッション、[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)、[エージェントチーム](https://code.claude.com/docs/ja/agent-teams.md)に適用されます。代わりに単一の[非対話型](https://code.claude.com/docs/ja/headless.md)実行でプロンプトを表示するものを拒否するには、`-p` とともに [`--permission-prompts none`](https://code.claude.com/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs) を渡します。

1192 

1193#### `denyInsteadOfPrompting` が他に停止するもの

1194 

1195この設定がオンの場合、Claude Code は応答を求める次のリクエストも停止します。

1196 

1197* **質問ツールと計画ツール**: Claude Code は [`AskUserQuestion`](https://code.claude.com/docs/ja/tools-reference#askuserquestion-tool-behavior)、`EnterPlanMode`、`ExitPlanMode` を除外するため、plan モードのセッションは自力で plan モードを終了できません。エージェントチームのチームメイトは `EnterPlanMode` と `ExitPlanMode` を保持します

1198* **MCP elicitation**: [`Elicitation` フック](https://code.claude.com/docs/ja/hooks#elicitation)が応答しない限り、Claude Code は [elicitation リクエスト](https://code.claude.com/docs/ja/mcp.md#respond-to-mcp-elicitation-requests)をキャンセルします

1199* **権限ホスト**: Claude Code は [`canUseTool` コールバック](https://code.claude.com/docs/ja/agent-sdk/user-input)や [`--permission-prompt-tool`](https://code.claude.com/docs/ja/cli-reference#cli-flags) に問い合わせません。コードから呼び出しを承認するには、`PermissionRequest` フックから応答します。一部の呼び出しは、フックに問い合わせる前に拒否されます。たとえば、どの確認ルールも対象としていない、`auto` モードでの[重要パスの削除](https://code.claude.com/docs/ja/permission-modes.md#critical-path-removals-in-each-permission-mode)などです。

1200* **分類器の課金通知**: [課金される分類器リクエストに関する通知](https://code.claude.com/docs/ja/auto-mode-classifier-billing.md)がダイアログを開く場合、Claude Code はそれを表示せず、それらのリクエストを必要とするアクションを拒否します

1201 

1202セッションは、[ワークスペース信頼ダイアログ](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)と[プロジェクト MCP サーバーの承認](https://code.claude.com/docs/ja/mcp.md#project-server-approvals-and-workspace-trust)では引き続き待機する可能性があります。セッションを実行したまま離れる前に、両方に応答してください。

1203 

1204#### `denyInsteadOfPrompting` からのメッセージ

1205 

1206これらのメッセージは拒否された呼び出しを報告します。プロンプトではないため、応答を待つものはありません。

1207 

1208Claude が読み取る拒否は、次のテキストで始まる場合があります。

1209 

1210```text theme={null}

1211Permission for this tool use was denied. It requires approval, and this session has no approval surface

1212```

1213 

1214`stream-json` 出力では、[`permission_denied` メッセージを出力する実行](https://code.claude.com/docs/ja/agent-sdk/typescript#sdkpermissiondeniedmessage)は次の `decision_reason` を報告します。

1215 

1216```text theme={null}

1217no approval surface in this session; permission request denied automatically

1218```

1219 

1220この設定がオンの auto モードでは、分類器がブロックした、または[安全性チェックが拒否した](https://code.claude.com/docs/ja/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)呼び出しが 20 回連続するとターンが終了し、次のメッセージが表示されます。

1221 

1222```text theme={null}

122320 actions were refused and no work went ahead in between, so Claude stopped.

1224```

1225 

1226`-p` 実行は、そのターンを `error_during_execution` として報告します。

1227 

1166### `permissions.disableBypassPermissionsMode`1228### `permissions.disableBypassPermissionsMode`

1167 1229 

1168誰も `bypassPermissions` モードに入れないようにします。Claude Code は `--dangerously-skip-permissions` フラグを拒否し、[エージェント定義](https://code.claude.com/docs/ja/sub-agents.md#permission-modes)の `permissionMode: bypassPermissions` を無視するため、サブエージェントは親セッションの権限モードで実行されます。1230誰も `bypassPermissions` モードに入れないようにします。Claude Code は `--dangerously-skip-permissions` フラグを拒否し、[エージェント定義](https://code.claude.com/docs/ja/sub-agents.md#permission-modes)の `permissionMode: bypassPermissions` を無視するため、サブエージェントは親セッションの権限モードで実行されます。

1202 1264 

1203`--dangerously-skip-permissions` からか `defaultMode: "bypassPermissions"` からかに関わらず、セッションが `bypassPermissions` モードに入る前に Claude Code が表示する確認ダイアログをスキップします。そのダイアログを一度受け入れると、Claude Code はユーザー設定のこのキーに `true` を書き込みます。1265`--dangerously-skip-permissions` からか `defaultMode: "bypassPermissions"` からかに関わらず、セッションが `bypassPermissions` モードに入る前に Claude Code が表示する確認ダイアログをスキップします。そのダイアログを一度受け入れると、Claude Code はユーザー設定のこのキーに `true` を書き込みます。

1204 1266 

1205* **スコープ**: [`User, local, or managed`](#scopes)。信頼されていないリポジトリがダイアログをスキップさせることはできません。1267* **スコープ**: [`User, local, or managed`](#scopes)、および `--settings` で渡されたファイル。[バックグラウンドセッション](https://code.claude.com/docs/ja/permission-modes.md#bypass-permissions-ignored-in-a-background-session)ではユーザー設定と管理設定のみが考慮されます。信頼されていないリポジトリがダイアログをスキップさせることはできません。

1206* **タイプ**: ブール値1268* **タイプ**: ブール値

1207 * `true`: Claude Code はセッションが `bypassPermissions` モードに入る前の確認ダイアログをスキップします1269 * `true`: Claude Code はセッションが `bypassPermissions` モードに入る前の確認ダイアログをスキップします

1208 * `false`: 未設定と同じです。これらのファイルのいずれかが `true` を設定しない限り、ダイアログが表示されます1270 * `false`: 未設定と同じです。これらのファイルのいずれかが `true` を設定しない限り、ダイアログが表示されます

3132 3194 

3133### `syntaxHighlightingDisabled`3195### `syntaxHighlightingDisabled`

3134 3196 

3135Claude Code は、ターミナルに表示する差分、コードブロック、ファイルプレビューのコードを、組み込みのハイライターで言語ごとに色分けします。プラグインや言語サーバーは関与しません。代わりにプレーンテキストとして表示するには、このキーを `true` に設定します。たとえば、色がターミナルのテーマと合わない場合や、スクリーンリーダーの動作が遅くなる場合に使用します。3197Claude Code は、ターミナルに表示する差分、コードブロック、ファイルプレビューのコードを、組み込みのハイライターで言語ごとに色分けします。代わりにプレーンテキストとして表示するには、このキーを `true` に設定します。たとえば、色がターミナルのテーマと合わない場合や、スクリーンリーダーの動作が遅くなる場合に使用します。

3136 3198 

3137* **スコープ**: [`Any file`](#scopes)3199* **スコープ**: [`Any file`](#scopes)

3138* **型**: Boolean3200* **型**: Boolean

4110 4172 

4111### `strictPluginOnlyCustomization`4173### `strictPluginOnlyCustomization`

4112 4174 

4113ユーザーソースとプロジェクトソースからのスキル、エージェント、フック、MCP サーバーをブロックし、それらがプラグインまたは管理設定からのみ提供されるようにします。[`strictKnownMarketplaces`](#strictknownmarketplaces) と組み合わせると、カスタマイズのサプライチェーン全体を制御できます。マーケットプレイスの許可リストは、ユーザーがインストールできるプラグインを制御します。4175ユーザーソースとプロジェクトソースからのスキル、エージェント、フック、MCP サーバーをブロックします。[`strictKnownMarketplaces`](#strictknownmarketplaces) と組み合わせると、ユーザーがプラグインをインストールできるマーケットプレイスを選択できます。[`disableSideloadFlags`](#disablesideloadflags) を追加すると、1 回の実行に限ってプラグイン、エージェント、MCP サーバーをサイドロードする CLI フラグを拒否できます。

4114 4176 

4115* **スコープ**: [`管理`](#scopes)4177* **スコープ**: [`管理`](#scopes)

4116* **型**: 4 種類のカスタマイズすべてをロックする場合は `true`、またはロックする種類を `"skills"`、`"agents"`、`"hooks"`、`"mcp"` から指定する配列4178* **型**: すべてをロックする場合は `true`、またはロックするものを `"skills"`、`"agents"`、`"hooks"`、`"mcp"` から指定する配列

4117* **デフォルト**: 未設定。何もロックされません4179* **デフォルト**: 未設定。何もロックされません

4118 4180 

4119この例では、スキルとフックをロックし、エージェントと MCP サーバーはロックしません。4181この例では、スキルとフックをロックし、エージェントと MCP サーバーはロックしません。

4216各スコープはそれぞれ異なる目的を持ちます。4278各スコープはそれぞれ異なる目的を持ちます。

4217 4279 

4218* **ユーザー設定**: 個人のプラグインの設定4280* **ユーザー設定**: 個人のプラグインの設定

4219* **プロジェクト設定**: リポジトリの全員と共有するプラグイン4281* **プロジェクト設定**: リポジトリの全員に対してオンにするプラグイン。これによってプラグインがインストールされるわけではないため、各ユーザーが[それらをインストールします](https://code.claude.com/docs/ja/plugins/org.md#require-plugins-per-repository)。

4220* **ローカル設定**: マシンごとの上書き。Claude Code がここに設定を保存するときに gitignore されます4282* **ローカル設定**: マシンごとの上書き。Claude Code がここに設定を保存するときに gitignore されます

4221* **管理設定**: 組織全体のポリシー。ここで `false` に設定されたプラグインは、すべてのスコープでインストールがブロックされ、マーケットプレイスから非表示になります4283* **管理設定**: 組織全体のポリシー。ここで `false` に設定されたプラグインは、すべてのスコープでインストールがブロックされ、マーケットプレイスから非表示になります

4222 4284 

4223プロジェクト設定はユーザー設定より優先されるため、`~/.claude/settings.json` でプラグインを `false` に設定しても、プロジェクトの `.claude/settings.json` で有効にされているプラグインは無効になりません。自分のマシンでプロジェクトが有効にしたプラグインを使わないようにするには、代わりに `.claude/settings.local.json` で `false` に設定してください。管理設定によって強制的に有効にされたプラグインは、管理設定がローカル設定を上書きするため、この方法では無効にできません。4285プロジェクト設定はユーザー設定より優先されるため、`~/.claude/settings.json` でプラグインを `false` に設定しても、プロジェクトの `.claude/settings.json` で有効にされているプラグインは無効になりません。自分のマシンでプロジェクトが有効にしたプラグインを使わないようにするには、代わりに `.claude/settings.local.json` で `false` に設定してください。管理設定によって強制的に有効にされたプラグインは、管理設定がローカル設定を上書きするため、この方法では無効にできません。

4224 4286 

4225プロジェクトの `.claude/settings.json` で GitHub リポジトリや npm パッケージなどの外部ソースのプラグインを有効にしても、他のユーザーにはインストールされません。プラグインを読み込むすべての経路で、各ユーザーが[自分でインストールする](https://code.claude.com/docs/ja/plugins/org.md#require-plugins-per-repository)まで、Claude Code はそのプラグインを未インストールとして報告します。

4226 

4227### `extraKnownMarketplaces`4287### `extraKnownMarketplaces`

4228 4288 

4229追加のプラグインマーケットプレイスを名前で登録し、リポジトリを開いたユーザーや管理設定が届くすべてのユーザーが、自分で追加しなくてもマーケットプレイスを利用できるようにします。Claude Code は、まだ認識していない各マーケットプレイスを登録します。そこから [`enabledPlugins`](#enabledplugins) が指定したプラグインがインストールされるかどうかは、プラグインのソースとそれを有効にしているファイルによって異なります。ルールについてはそのエントリを参照してください。4289追加のプラグインマーケットプレイスを名前で登録し、リポジトリを開いたユーザーや管理設定が届くすべてのユーザーが、自分で追加しなくてもマーケットプレイスを利用できるようにします。Claude Code は、まだ認識していない各マーケットプレイスを登録します。そこから [`enabledPlugins`](#enabledplugins) が指定したプラグインがインストールされるかどうかは、プラグインのソースとそれを有効にしているファイルによって異なります。ルールについては[プロジェクト設定で有効になっているがインストールされていない](https://code.claude.com/docs/ja/plugins/loading.md#enabled-in-project-settings-but-not-installed)を参照してください。

4230 4290 

4231* **スコープ**: [`任意のファイル`](#scopes)。Claude Code は、リポジトリの `.claude/settings.json` または `.claude/settings.local.json` のエントリを、そのフォルダのワークスペースの信頼ダイアログを承認した後にのみ反映します。信頼していないフォルダ（そこでの `-p` 実行を含む）では、メッセージを表示せずにそれらを無視します。4291* **スコープ**: [`任意のファイル`](#scopes)。Claude Code は、リポジトリの `.claude/settings.json` または `.claude/settings.local.json` のエントリを、そのフォルダのワークスペースの信頼ダイアログを承認した後にのみ反映します。信頼していないフォルダ（そこでの `-p` 実行を含む）では、メッセージを表示せずにそれらを無視します。

4232* **型**: マーケットプレイス名を、`source` オブジェクトとオプションの `autoUpdate` Boolean を持つオブジェクトにマッピングするオブジェクト4292* **型**: マーケットプレイス名を、`source` オブジェクトとオプションの `autoUpdate` Boolean を持つオブジェクトにマッピングするオブジェクト

4354 4414 

4355ユーザーがインストールしたすべての mod より前に、記載順で [mod](https://code.claude.com/docs/ja/plugins/mods/overview.md) が実行される管理対象プラグインを列挙します。このキーを管理設定で設定する場合は、組み込みガードを維持するためにリストに `sec-default@builtin` を含めてください。管理設定では、Claude Code は組織のものとみなされないプラグインの id をスキップします。その条件と、2 つの順序指定キーがどのように連携するかについては、[組織の mod をインストールして順序を設定する](https://code.claude.com/docs/ja/plugins/mods/admin.md#install-your-organizations-mods)を参照してください。4415ユーザーがインストールしたすべての mod より前に、記載順で [mod](https://code.claude.com/docs/ja/plugins/mods/overview.md) が実行される管理対象プラグインを列挙します。このキーを管理設定で設定する場合は、組み込みガードを維持するためにリストに `sec-default@builtin` を含めてください。管理設定では、Claude Code は組織のものとみなされないプラグインの id をスキップします。その条件と、2 つの順序指定キーがどのように連携するかについては、[組織の mod をインストールして順序を設定する](https://code.claude.com/docs/ja/plugins/mods/admin.md#install-your-organizations-mods)を参照してください。

4356 4416 

4357* **スコープ**: [`ユーザーまたは管理`](#scopes)。Claude Code は管理設定からこのキーを読み込みます。ユーザー設定からこのキーを読み込むのは、管理設定のないマシンで、認証情報が Team または Enterprise の `/login` ではないセッションの場合のみです。プロジェクト設定、ローカル設定、および `--settings` ファイル内のこのキーは無視します。4417* **スコープ**: [`ユーザーまたは管理`](#scopes)。Claude Code は管理設定からこのキーを読み込みます。ユーザー設定からこのキーを読み込むのは、管理設定も `managed-mcp.json` ファイルもないマシンで、認証情報が Team または Enterprise の `/login` ではないセッションの場合のみです。プロジェクト設定、ローカル設定、および `--settings` ファイル内のこのキーは無視します。

4358* **型**: `plugin-name@marketplace-name` 文字列の配列4418* **型**: `plugin-name@marketplace-name` 文字列の配列

4359* **デフォルト**: 未設定4419* **デフォルト**: 未設定

4360 4420 

4374 4434 

4375ユーザーがインストールしたすべての mod の後に、記載順で [mod](https://code.claude.com/docs/ja/plugins/mods/overview.md) が実行される管理対象プラグインを列挙します。`prependPlugins` と `appendPlugins` の両方に記載された id は先頭に追加されます。管理設定では、Claude Code は[組織のものとみなされない](https://code.claude.com/docs/ja/plugins/mods/admin.md#install-your-organizations-mods)プラグインの id をスキップします。4435ユーザーがインストールしたすべての mod の後に、記載順で [mod](https://code.claude.com/docs/ja/plugins/mods/overview.md) が実行される管理対象プラグインを列挙します。`prependPlugins` と `appendPlugins` の両方に記載された id は先頭に追加されます。管理設定では、Claude Code は[組織のものとみなされない](https://code.claude.com/docs/ja/plugins/mods/admin.md#install-your-organizations-mods)プラグインの id をスキップします。

4376 4436 

4377* **スコープ**: [`ユーザーまたは管理`](#scopes)。Claude Code は管理設定からこのキーを読み込みます。ユーザー設定からこのキーを読み込むのは、管理設定のないマシンで、認証情報が Team または Enterprise の `/login` ではないセッションの場合のみです。プロジェクト設定、ローカル設定、および `--settings` ファイル内のこのキーは無視します。4437* **スコープ**: [`ユーザーまたは管理`](#scopes)。Claude Code は管理設定からこのキーを読み込みます。ユーザー設定からこのキーを読み込むのは、管理設定も `managed-mcp.json` ファイルもないマシンで、認証情報が Team または Enterprise の `/login` ではないセッションの場合のみです。プロジェクト設定、ローカル設定、および `--settings` ファイル内のこのキーは無視します。

4378* **型**: `plugin-name@marketplace-name` 文字列の配列4438* **型**: `plugin-name@marketplace-name` 文字列の配列

4379* **デフォルト**: 未設定4439* **デフォルト**: 未設定

4380 4440 

4612 4672 

4613### `crossSessionInbound`4673### `crossSessionInbound`

4614 4674 

4615このセッションが[他の Claude Code セッションから到着するメッセージ](https://code.claude.com/docs/ja/cross-session-messaging.md#control-inbound-messages)に対して何を行うかを選択します。値が適用されない場合、Claude Code は 2 つのセッションの権限モードクラスからメッセージごとに決定します。Claude Code v2.1.224 以降が必要です。4675このセッションが[他の Claude Code セッションから到着するメッセージ](https://code.claude.com/docs/ja/cross-session-messaging.md#control-inbound-messages)に対して何を行うかを選択します。値が適用されない場合、Claude Code は 2 つのセッションの権限モードクラスからメッセージごとに決定します。

4616 4676 

4617* **スコープ**: [`任意のファイル`](#scopes)。プロジェクトまたはローカル値は、管理設定、`--settings` フラグ、またはユーザー設定が提供する値より厳密な場合にのみ適用されます。4677* **スコープ**: [`任意のファイル`](#scopes)。プロジェクトまたはローカル値は、管理設定、`--settings` フラグ、またはユーザー設定が提供する値より厳密な場合にのみ適用されます。

4618* **タイプ**: 文字列、以下のいずれか：4678* **タイプ**: 文字列、以下のいずれか：

4946}5006}

4947```5007```

4948 5008 

5009### `disableRemotePreviewScripts`

5010 

5011デスクトップアプリで SSH または WSL セッションから [HTML ファイルをプレビュー](https://code.claude.com/docs/ja/desktop.md#preview-html-files-in-ssh-and-wsl-sessions) するときに、スクリプトが実行されないようにします。Browser ペインでの外部ブラウジングには影響しません。

5012 

5013デスクトップアプリはこのキーを読み取ります。ターミナル CLI は無視します。Claude Desktop v5.1231.0 以降が必要です。それより前のバージョンはこのキーを無視します。それらのバージョンでスクリプトを停止するには、[`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation) も設定してください。これにより外部ブラウジングもオフになります。

5014 

5015* **Scope**: [`Managed`](#scopes)。デスクトップアプリは、リモートマシンや WSL ディストリビューションからはこのキーを読み取りません。

5016* **Type**: Boolean。JSON Boolean `true` のみが有効です

5017 * `true`: SSH および WSL セッションの HTML プレビューではスクリプトが実行されません

5018 * `false`: このキーはスクリプトをオフにしません

5019* **Default**: 未設定なので、このキーは効果がありません

5020 

5021デスクトップアプリを実行するコンピューターが他の Claude Code 管理設定を受け取っていない場合は、作成する管理設定で [`parentSettingsBehavior`](#parentsettingsbehavior) も `"merge"` に設定してください。Windows では、管理設定ファイルを作成すると、[許可する](https://code.claude.com/docs/ja/admin-setup.md#wsl-sessions-in-claude-code-desktop) までユーザーは WSL セッションも使用できなくなります。[Turn off scripts in SSH and WSL previews for your organization](https://code.claude.com/docs/ja/desktop.md#turn-off-scripts-in-ssh-and-wsl-previews-for-your-organization) では、この両方について説明し、キーを設定する場所を示しています。

5022 

5023この例は、コンピューターがすでに受け取っている管理設定に追加する場合のように、キーのみを示しています：

5024 

5025```json managed-settings.json theme={null}

5026{

5027 "disableRemotePreviewScripts": true

5028}

5029```

5030 

5031デスクトップアプリは他の値を無視し、文字列 `"true"` や `1` などの Boolean ではない値の場合は警告もログに記録します。

5032 

4949### `enableArtifact`5033### `enableArtifact`

4950 5034 

4951セッション出力を claude.ai 上のプライベート Web ページとして公開する [Artifact](https://code.claude.com/docs/ja/artifacts.md) ツールをオフにします。`/config` で **Artifacts** 行をオフにすると、Claude Code はこのキーをユーザー設定に書き込むため、通常は手動で編集しません。5035セッション出力を claude.ai 上のプライベート Web ページとして公開する [Artifact](https://code.claude.com/docs/ja/artifacts.md) ツールをオフにします。`/config` で **Artifacts** 行をオフにすると、Claude Code はこのキーをユーザー設定に書き込むため、通常は手動で編集しません。

5219 5303 

5220### `forceLoginMethod`5304### `forceLoginMethod`

5221 5305 

5222ユーザーがログインできるアカウントの種類を制限します。`"claudeai"` を設定して claude.ai アカウントのみを許可するか、`"console"` を設定して Claude Console アカウントのみを許可するか、`"gateway"` を設定してファーストパーティログインの代わりに [クラウドゲートウェイ](https://code.claude.com/docs/ja/claude-apps-gateway)にユーザーを送信します。管理者は管理設定で設定し、[`forceLoginOrgUUID`](#forceloginorguuid) と組み合わせて開発者の claude.ai ログインを 1 つの組織内に保つことができます。5306ユーザーがログインに使用できるアカウントの種類を制限します。claude.ai サインインには `"claudeai"`、Claude Console サインインには `"console"` を指定します。`"gateway"` を設定すると、ファーストパーティログインの代わりに [クラウドゲートウェイ](https://code.claude.com/docs/ja/claude-apps-gateway)にユーザーを送信します。管理者は管理設定で設定し、[`forceLoginOrgUUID`](#forceloginorguuid) と組み合わせて開発者の claude.ai ログインを 1 つの組織内に保ちます。

5223 5307 

5224任意の設定ファイルで `"claudeai"` に設定した場合、Claude Code はそのファイルが適用されるセッションで [キーレス Console サインイン](https://code.claude.com/docs/ja/authentication.md#sign-in-without-an-api-key)の提供も停止します。`"console"` のみの場合、ユーザーはログインに失敗した後も引き続きキーレスサインインに到達できます。Claude Code による提供を停止するには、[管理対象マシンでキーレスサインインの提供を停止する](https://code.claude.com/docs/ja/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines)を参照してください。このセクションには、`forceLoginOrgUUID` が他に何を変更するかも記載されています。5308任意の設定ファイルで `"claudeai"` に設定した場合、Claude Code はそのファイルが適用されるセッションで [キーレス Console サインイン](https://code.claude.com/docs/ja/authentication.md#sign-in-without-an-api-key)の提供も停止します。`"console"` のみの場合、ユーザーはログインに失敗した後も引き続きキーレスサインインに到達できます。Claude Code による提供を停止するには、[管理対象マシンでキーレスサインインの提供を停止する](https://code.claude.com/docs/ja/authentication.md#stop-offering-the-keyless-sign-in-on-managed-machines)を参照してください。このセクションには、`forceLoginOrgUUID` が他に何を変更するかも記載されています。

5225 5309 

5226* **スコープ**: [`Any file`](#scopes)。Claude Code は `"gateway"` を [`forceLoginGatewayUrl`](#forcelogingatewayurl) と同じソースからのみ受け入れ、それ以外の場所では未設定として扱います。5310* **スコープ**: [`Any file`](#scopes)。Claude Code は `"gateway"` を [`forceLoginGatewayUrl`](#forcelogingatewayurl) と同じソースからのみ受け入れ、それ以外の場所では未設定として扱います。

5227* **タイプ**: 文字列、以下のいずれか：5311* **タイプ**: 文字列、以下のいずれか：

5228 * `"claudeai"`: claude.ai アカウントのみがログインできます5312 * `"claudeai"`: claude.ai サインイン

5229 * `"console"`: Claude Console アカウントのみがログインできます5313 * `"console"`: Claude Console サインイン

5230 * `"gateway"`: Claude Code はユーザーをファーストパーティログインの代わりにクラウドゲートウェイに送信します5314 * `"gateway"`: Claude Code はユーザーをファーストパーティログインの代わりにクラウドゲートウェイに送信します

5231* **デフォルト**: 未設定。ユーザーはログイン方法を選択します5315* **デフォルト**: 未設定。ユーザーはログイン方法を選択します

5232 5316 

5471 5555 

5472Claude Code が [セッショントランスクリプトおよび他のアプリケーションデータ](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically) を削除する前に保持する日数を設定します。Claude Code はセッション開始後にバックグラウンド削除を実行します。保持期間を安全に判定できる限り実行されます。削除スイープはメッセージを表示せずにトランスクリプトを削除するため、保持期間より長く使用していないセッションは [`/resume`](https://code.claude.com/docs/ja/sessions#resume-a-session) ピッカーに表示されなくなります。5556Claude Code が [セッショントランスクリプトおよび他のアプリケーションデータ](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically) を削除する前に保持する日数を設定します。Claude Code はセッション開始後にバックグラウンド削除を実行します。保持期間を安全に判定できる限り実行されます。削除スイープはメッセージを表示せずにトランスクリプトを削除するため、保持期間より長く使用していないセッションは [`/resume`](https://code.claude.com/docs/ja/sessions#resume-a-session) ピッカーに表示されなくなります。

5473 5557 

5558デフォルトでは、Claude Code は Claude Desktop または Cowork で開始または最後に続行したセッションのトランスクリプトを、このキーを自分で設定した場合でも、この期間を過ぎても保持します。HIPAA 設定の場合など、[一部のケースではこの期間が引き続き適用されます](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)。v2.1.248 より前は、Claude Code はこの期間の経過後にそれらを削除していました。

5559 

5474* **スコープ**: [`Any file`](#scopes)5560* **スコープ**: [`Any file`](#scopes)

5475* **タイプ**: 日数、整数、最小値 `1`5561* **タイプ**: 日数、整数、最小値 `1`

5476* **デフォルト**: `30`5562* **デフォルト**: `30`

5485 5571 

5486### `desktopSessionCleanupPeriodDays`5572### `desktopSessionCleanupPeriodDays`

5487 5573 

5488Claude Desktop または Cowork で開始または最後に続行したセッションのトランスクリプトに対して、日数での年齢制限を設定します。このキーがない場合、Claude Code は [それらのトランスクリプトを任意の年齢で保持します](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)。Claude Code は各トランスクリプトが、この制限と [`cleanupPeriodDays`](#cleanupperioddays) の両方より古い場合に削除します。したがって、`cleanupPeriodDays` がデフォルトの 30 の場合、`7` の値でも 30 日間保持されます。[自動クリーンアップ](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically) には、代わりに `cleanupPeriodDays` が適用され、Claude Code がこのキーを無視するケースが記載されています。Claude Code v2.1.248 以降が必要です。5574Claude Desktop または Cowork で開始または最後に続行したセッションのトランスクリプトに対して、日数での年齢制限を設定します。このキーがない場合、Claude Desktop で削除したセッションなどのケースを除き、Claude Code は [それらのトランスクリプトを任意の年齢で保持します](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)。Claude Code v2.1.248 以降が必要です。

5575 

5576Claude Code は各トランスクリプトが、この制限と [`cleanupPeriodDays`](#cleanupperioddays) の両方より古い場合に削除します。したがって、`cleanupPeriodDays` がデフォルトの 30 の場合、`7` の値でも 30 日間保持されます。[自動クリーンアップ](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically) には、代わりに `cleanupPeriodDays` が適用され、Claude Code がこのキーを無視するケースが記載されています。

5489 5577 

5490* **スコープ**: [`User or managed`](#scopes)。Claude Code は `--settings` で渡すファイルからキーを読み込み、プロジェクトおよびローカル設定では無視します。5578* **スコープ**: [`User or managed`](#scopes)。Claude Code は `--settings` で渡すファイルからキーを読み込み、プロジェクトおよびローカル設定では無視します。

5491* **タイプ**: 日数、整数、最小値 `0`5579* **タイプ**: 日数、整数、最小値 `0`