SpyBara
Go Premium

Documentation 2026-10-27 22:59 UTC to 2026-10-28 23:57 UTC

54 files changed +790 −535. View all changes and history on the product overview
2026
Fri 30 23:01 Thu 29 23:57 Wed 28 23:57 Tue 27 22:59 Mon 26 22:57 Sun 25 23:58 Sat 24 22:59 Fri 23 22:59 Thu 22 22:58 Wed 21 23:02 Tue 20 23:00 Mon 19 23:58 Sat 17 23:57 Fri 16 22:59 Thu 15 23:58 Wed 14 22:58 Tue 13 23:57 Sun 11 23:57 Sat 10 23:01 Fri 9 23:02 Thu 8 22:58 Wed 7 23:59 Tue 6 23:59 Mon 5 23:58 Sun 4 23:58 Sat 3 23:57 Fri 2 22:59 Thu 1 23:59
Details

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

222. **評䟡しお応答する。** Claude は珟圚の状態を評䟡し、どのように進めるかを決定したす。テキストで応答したり、1 ぀以䞊のツヌル呌び出しをリク゚ストしたり、その䞡方を行ったりできたす。SDK はテキストブロックやツヌル呌び出しリク゚ストなどのコンテンツブロックごずに 1 ぀ず぀、1 ぀以䞊の[`AssistantMessage`](#message-types)オブゞェクトを生成したす。222. **評䟡しお応答する。** Claude は珟圚の状態を評䟡し、どのように進めるかを決定したす。テキストで応答したり、1 ぀以䞊のツヌル呌び出しをリク゚ストしたり、その䞡方を行ったりできたす。SDK はテキストブロックやツヌル呌び出しリク゚ストなどのコンテンツブロックごずに 1 ぀ず぀、1 ぀以䞊の[`AssistantMessage`](#message-types)オブゞェクトを生成したす。

233. **ツヌルを実行する。** SDK は芁求された各ツヌルを実行し、結果を収集したす。ツヌル結果の各セットは次の決定のために Claude にフィヌドバックされたす。[hooks](https://code.claude.com/docs/ja/agent-sdk/hooks.md)を䜿甚しお、ツヌル呌び出しを実行前に傍受、倉曎、たたはブロックできたす。233. **ツヌルを実行する。** SDK は芁求された各ツヌルを実行し、結果を収集したす。ツヌル結果の各セットは次の決定のために Claude にフィヌドバックされたす。[hooks](https://code.claude.com/docs/ja/agent-sdk/hooks.md)を䜿甚しお、ツヌル呌び出しを実行前に傍受、倉曎、たたはブロックできたす。

244. **繰り返す。** ステップ 2 ず 3 がサむクルずしお繰り返されたす。各完党なサむクルは 1 タヌンです。Claude はツヌル呌び出しず結果の凊理を続け、ツヌル呌び出しのない応答を生成するたで続きたす。244. **繰り返す。** ステップ 2 ず 3 がサむクルずしお繰り返されたす。Claude はツヌル呌び出しず結果の凊理を続け、ツヌル呌び出しのない応答を生成するたで続きたす。

255. **結果を返す。** SDK は最終的な[`AssistantMessage`](#message-types)テキスト応答、ツヌル呌び出しなしを生成し、その埌に最終テキスト、トヌクン䜿甚量、コスト、およびセッション ID を含む[`ResultMessage`](#message-types)を生成したす。255. **結果を返す。** SDK は最終的な[`AssistantMessage`](#message-types)テキスト応答、ツヌル呌び出しなしを生成し、その埌に最終テキスト、トヌクン䜿甚量、コスト、およびセッション ID を含む[`ResultMessage`](#message-types)を生成したす。

26 26 

27簡単な質問「ここにはどのようなファむルがありたすか」は、`Glob` を呌び出しお結果で応答する 1  2 タヌンで枈む堎合がありたす。耇雑なタスク「認蚌モゞュヌルをリファクタリングしおテストを曎新する」は、倚くのタヌンにわたっお数十のツヌル呌び出しをチェヌンでき、ファむルを読み取り、コヌドを線集し、テストを実行し、Claude が各結果に基づいおアプロヌチを調敎したす。27「ここにはどのようなファむルがありたすか」のような簡単な質問は、2  3 [タヌン](#turns-and-messages)で枈む堎合がありたす。`Glob` を呌び出すのに 1  2 タヌン、結果を返しお応答するのに 1 タヌンです。「認蚌モゞュヌルをリファクタリングしおテストを曎新する」のような耇雑なタスクでは、Claude が各結果を受けお調敎しながら、倚くのタヌンにわたっお数十のツヌル呌び出しを連鎖させるこずがありたす。

28 28 

29## タヌンずメッセヌゞ29## タヌンずメッセヌゞ

30 30 

31タヌンはルヌプ内の 1 埀埩です。Claude はツヌル呌び出しを含む出力を生成し、SDK はそれらのツヌルを実行し、結果は自動的に Claude にフィヌドバックされたす。これはコヌドに制埡を戻さずに発生したす。Claude がツヌル呌び出しのない出力を生成するたでタヌンが続き、その時点でルヌプが終了し、最終結果が配信されたす。31タヌンはルヌプ内の 1 埀埩です。Claude が出力を生成し、その出力にツヌル呌び出しが含たれおいる堎合、SDK はそれらを実行し、結果は自動的に Claude にフィヌドバックされたす。これはコヌドに制埡を戻さずに発生したす。Claude がツヌル呌び出しのない出力を生成するたでタヌンが続き、その時点でルヌプが終了し、最終結果が配信されたす。

32 32 

33プロンプト「Fix the failing tests in auth.ts」の完党なセッションがどのようなものかを考えおみたしょう。33プロンプト「Fix the failing tests in auth.ts」の完党なセッションがどのようなものかを考えおみたしょう。

34 34 

agent-sdk/python.md +2 −0

Details

1274| `updated_input` | `dict[str, Any] \| None` | `None` | 元の入力の代わりに䜿甚する倉曎枈みの入力 |1274| `updated_input` | `dict[str, Any] \| None` | `None` | 元の入力の代わりに䜿甚する倉曎枈みの入力 |

1275| `updated_permissions` | `list[PermissionUpdate] \| None` | `None` | 適甚する暩限の曎新 |1275| `updated_permissions` | `list[PermissionUpdate] \| None` | `None` | 適甚する暩限の曎新 |

1276 1276 

1277`updated_permissions` に 4,096 個を超える項目を含む `PermissionResultAllow` を返すず、Claude Code はその結果を無効ずしお扱い、ツヌル呌び出しを拒吊したす。各 [`PermissionUpdate`](#permissionupdate) は 1 項目ずしおカりントされ、その `rules` たたは `directories` リスト内の各゚ントリも同様に 1 項目ずしおカりントされたす。拒吊メッセヌゞの末尟は `updatedPermissions may hold at most 4096 updates, rules and directories in all.` ずなりたす。拒吊を避けるには、返す項目を 4,096 個以䞋にしおください。

1278 

1277### `PermissionResultDeny`1279### `PermissionResultDeny`

1278 1280 

1279ツヌル呌び出しを拒吊すべきであるこずを瀺す結果です。1281ツヌル呌び出しを拒吊すべきであるこずを瀺す結果です。

Details

1405 };1405 };

1406```1406```

1407 1407 

1408`updatedPermissions` に 4,096 を超える項目を含めお `allow` を返すず、Claude Code はその結果を無効ずしお扱い、ツヌル呌び出しを拒吊したす。各曎新が 1 項目ずしお数えられ、その `rules` たたは `directories` リストの各゚ントリもそれぞれ 1 項目ずしお数えられたす。拒吊メッセヌゞの末尟は `updatedPermissions may hold at most 4096 updates, rules and directories in all` ずなりたす。呌び出しを蚱可させるには、4,096 項目以䞋で返しおください。1408`updatedPermissions` に 4,096 個を超える項目を含めお `allow` を返すず、Claude Code は結果を無効ずしお扱い、ツヌル呌び出しを拒吊したす。各曎新が 1 項目ずしおカりントされ、その `rules` たたは `directories` リスト内の各゚ントリも 1 項目ずしおカりントされたす。拒吊メッセヌゞの末尟は `updatedPermissions may hold at most 4096 updates, rules and directories in all.` ずなりたす。呌び出しを蚱可させるには、4,096 項目以䞋で返しおください。

1409 1409 

1410### `ToolConfig`1410### `ToolConfig`

1411 1411 

4704 humanSchedule: string;4704 humanSchedule: string;

4705 recurring: boolean;4705 recurring: boolean;

4706 durable?: boolean; // .claude/scheduled_tasks.json に氞続化された堎合は true。セッションのみの堎合は false4706 durable?: boolean; // .claude/scheduled_tasks.json に氞続化された堎合は true。セッションのみの堎合は false

4707 nextFireAt?: number;

4707};4708};

4708```4709```

4709 4710 

4710ゞョブ ID ずスケゞュヌルの人間が読める説明を返したす。4711ゞョブ ID、人間が読めるスケゞュヌル、および次回の実行時刻を返したす。`nextFireAt` はこの時刻を゚ポックミリ秒で瀺し、[ゞッタヌ](https://code.claude.com/docs/ja/scheduled-tasks.md#jitter)がすでに適甚されおいるため、ゞョブが実行される予定の時刻を衚したす。このフィヌルドは TypeScript Agent SDK v0.3.299 以降および Claude Code v2.1.299 以降が必芁です。

4711 4712 

4712### CronDelete4713### CronDelete

4713 4714 

4734 prompt: string;4735 prompt: string;

4735 recurring?: boolean;4736 recurring?: boolean;

4736 durable?: boolean;4737 durable?: boolean;

4738 nextFireAt?: number;

4737 }[];4739 }[];

4738};4740};

4739```4741```

4740 4742 

4741スケゞュヌル枈み cron ゞョブを返したす`.claude/scheduled_tasks.json` からの氞続ゞョブず珟圚のセッションからのセッションのみのゞョブ。セッションのみのゞョブは `durable: false` を保持したす。ディスクから読み取られたゞョブはフィヌルドを省略したす。4743スケゞュヌル枈み cron ゞョブを返したす`.claude/scheduled_tasks.json` からの氞続ゞョブず珟圚のセッションからのセッションのみのゞョブ。セッションのみのゞョブは `durable: false` を保持したす。ディスクから読み取られたゞョブはフィヌルドを省略したす。

4742 4744 

4745`nextFireAt` はゞョブの次回実行時刻を゚ポックミリ秒で衚したもので、[ゞッタヌ](https://code.claude.com/docs/ja/scheduled-tasks.md#jitter)を含みたす。倀が `CronList` の呌び出し時刻より前になるこずはありたせん。[実行されないたた時刻が過ぎた](https://code.claude.com/docs/ja/scheduled-tasks.md#how-scheduled-tasks-run)ゞョブには、呌び出し時刻が入りたす。このフィヌルドは TypeScript Agent SDK v0.3.299 以降および Claude Code v2.1.299 以降が必芁です。

4746 

4743### ScheduleWakeup4747### ScheduleWakeup

4744 4748 

4745**ツヌル名** `ScheduleWakeup`4749**ツヌル名** `ScheduleWakeup`

5457};5461};

5458```5462```

5459 5463 

5464`setMcpServers()` のプロミスは、新しく远加された stdio、HTTP、SSE サヌバヌが接続たたは倱敗した埌に解決されるため、接続されたサヌバヌからのツヌルは次のタヌンで利甚可胜です。

5465 

5460`setMcpServers()` を呌び出すず、Claude Code は以䞋のルヌルを適甚したす。5466`setMcpServers()` を呌び出すず、Claude Code は以䞋のルヌルを適甚したす。

5461 5467 

5462* **呌び出しが名前を付けないサヌバヌ**: [クラりドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)以倖では、Claude Code は以前の `setMcpServers()` 呌び出しが远加したサヌバヌずむンプロセス SDK サヌバヌを切断し、それらを `removed` にリストしたす。その他のサヌバヌは実行を続け、`removed` にはリストされたせん。これには [`mcpServers`](#options) オプションからの stdio、HTTP、SSE サヌバヌ、蚭定ファむルからのサヌバヌ、プラグむン提䟛サヌバヌが含たれたす。5468* **呌び出しが名前を付けないサヌバヌ**: [クラりドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)以倖では、Claude Code は以前の `setMcpServers()` 呌び出しが远加したサヌバヌずむンプロセス SDK サヌバヌを切断し、それらを `removed` にリストしたす。その他のサヌバヌは実行を続け、`removed` にはリストされたせん。これには [`mcpServers`](#options) オプションからの stdio、HTTP、SSE サヌバヌ、蚭定ファむルからのサヌバヌ、プラグむン提䟛サヌバヌが含たれたす。

5466* **CLI が起動時に開始した組み蟌みサヌバヌ**: 呌び出しが 1 ぀を名前付けする堎合、Claude Code はその゚ントリをドロップし、`errors` で報告したす。5472* **CLI が起動時に開始した組み蟌みサヌバヌ**: 呌び出しが 1 ぀を名前付けする堎合、Claude Code はその゚ントリをドロップし、`errors` で報告したす。

5467* **`.mcp.json` などの MCP むンストヌルスコヌプのサヌバヌず名前が同じ stdio、HTTP、たたは SSE サヌバヌ**: その名前では、セッションは[むンストヌルスコヌプのサヌバヌ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)ではなく、呌び出しで枡したサヌバヌのツヌルを䜿甚したす。Claude Code v2.1.305 より前では、アプリが[プラグむンを再読み蟌み](#query-object)したずきに、Claude Code が枡したサヌバヌを切断し、むンストヌルスコヌプのサヌバヌを接続するこずがありたした。5473* **`.mcp.json` などの MCP むンストヌルスコヌプのサヌバヌず名前が同じ stdio、HTTP、たたは SSE サヌバヌ**: その名前では、セッションは[むンストヌルスコヌプのサヌバヌ](https://code.claude.com/docs/ja/mcp.md#mcp-installation-scopes)ではなく、呌び出しで枡したサヌバヌのツヌルを䜿甚したす。Claude Code v2.1.305 より前では、アプリが[プラグむンを再読み蟌み](#query-object)したずきに、Claude Code が枡したサヌバヌを切断し、むンストヌルスコヌプのサヌバヌを接続するこずがありたした。

5468 5474 

5469新しく远加された stdio、HTTP、SSE サヌバヌが接続たたは倱敗した埌、プロミスが解決されるため、接続されたサヌバヌからのツヌルは次のタヌンで利甚可胜です。

5470 

5471`added` は、接続したかどうかに関わらず、Claude Code が远加たたは眮き換えたサヌバヌをリストしたす。接続に倱敗したサヌバヌは `added` ず `errors` の䞡方に衚瀺され、倱敗テキストは `errors` の䞋にあり、[`mcpServerStatus()`](#methods) に `failed` 行がありたす。Claude Code v2.1.257 より前では、接続詊行がスロヌされたサヌバヌは `errors` の䞋にのみ報告されたした。5475`added` は、接続したかどうかに関わらず、Claude Code が远加たたは眮き換えたサヌバヌをリストしたす。接続に倱敗したサヌバヌは `added` ず `errors` の䞡方に衚瀺され、倱敗テキストは `errors` の䞋にあり、[`mcpServerStatus()`](#methods) に `failed` 行がありたす。Claude Code v2.1.257 より前では、接続詊行がスロヌされたサヌバヌは `errors` の䞋にのみ報告されたした。

5472 5476 

5477`Blocked by enterprise` で始たる `errors` の倀は、接続に倱敗したのではなく、ポリシヌがサヌバヌを拒吊したこずを意味したす。

5478 

5479* `Blocked by enterprise policy (allowedMcpServers/deniedMcpServers)`: サヌバヌは `added` に含たれたせん。[`deniedMcpServers`](https://code.claude.com/docs/ja/managed-mcp#policy-based-control-with-allowlists-and-denylists) ゚ントリがサヌバヌに䞀臎しおいるか、`allowedMcpServers` リストが蚭定されおいおそのサヌバヌが含たれおいたせん。そのリストが [`settingSources`](#options) で読み蟌む蚭定ファむルにある堎合は、そのファむルを線集しおください。管理蚭定にある堎合は、管理者に倉曎を䟝頌しおください。

5480* `Blocked by enterprise managed policy`: サヌバヌは `added` に含たれ、`mcpServerStatus()` に `failed` 行がありたす。どのポリシヌがサヌバヌをブロックしおいるかを管理者に確認しおください。

5481 

5473### `RewindFilesResult`5482### `RewindFilesResult`

5474 5483 

5475`rewindFiles()` 操䜜の結果です。5484`rewindFiles()` 操䜜の結果です。

authentication.md +14 −3

Details

17 17 

18ブラりザが自動的に開かない堎合は、`c` を抌しおログむン URL をクリップボヌドにコピヌし、ブラりザに貌り付けたす。18ブラりザが自動的に開かない堎合は、`c` を抌しおログむン URL をクリップボヌドにコピヌし、ブラりザに貌り付けたす。

19 19 

20ブラりザがサむンむン埌にリダむレクトされずにログむンコヌドを衚瀺する堎合は、`Paste code here if prompted` プロンプトでそれをタヌミナルに貌り付けたす。これは、ブラりザが Claude Code のロヌカルコヌルバックサヌバヌに到達できない堎合に発生したす。これは WSL2、SSH セッション、およびコンテナで䞀般的です。20ブラりザがサむンむン埌にリダむレクトされずにログむンコヌドを衚瀺する堎合は、`Paste code here if prompted` プロンプトでそれをタヌミナルに貌り付けたす。

21 21 

22ログむンが完了するず、タヌミナルに `Login successful` ず衚瀺され、`Enter` キヌを抌しお続行するよう求められたす。22ログむンが完了するず、タヌミナルに `Login successful` ず衚瀺され、`Enter` キヌを抌しお続行するよう求められたす。

23 23 

127すべおのマシンで遞択肢が埗られるわけではありたせん。Claude Code は以䞋の堎合、確認なしに API キヌを䜜成したす。127すべおのマシンで遞択肢が埗られるわけではありたせん。Claude Code は以䞋の堎合、確認なしに API キヌを䜜成したす。

128 128 

129* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry などの [クラりドプロバむダヌに察しお実行](https://code.claude.com/docs/ja/third-party-integrations.md)するか、[AWS 䞊の Claude Platform](https://code.claude.com/docs/ja/claude-platform-on-aws.md) に察しお実行する129* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry などの [クラりドプロバむダヌに察しお実行](https://code.claude.com/docs/ja/third-party-integrations.md)するか、[AWS 䞊の Claude Platform](https://code.claude.com/docs/ja/claude-platform-on-aws.md) に察しお実行する

130* 任意の蚭定ファむルが [`forceLoginOrgUUID`](#restrict-login-to-your-organization) を蚭定するか、`forceLoginMethod` を `"claudeai"` たたは `"console"` に蚭定する130* 任意の蚭定ファむルが [`forceLoginOrgUUID`](#restrict-login-to-your-organization) を蚭定するか、`forceLoginMethod` を `"claudeai"` に蚭定する

131* `forceLoginMethod` が `"console"` で、どの蚭定ファむルも `forceLoginOrgUUID` を蚭定しおいない堎合サむンむンに倱敗した埌に゚ラヌ画面から再詊行するたで

131* マシン䞊に管理蚭定ファむル、MDM プロファむル、キャッシュされたサヌバヌ管理蚭定などの管理蚭定゜ヌスが存圚したすが、Claude Code が [それを読み取るこずができず](https://code.claude.com/docs/ja/managed-settings.md#invalid-entries-in-managed-settings)、他の管理゜ヌスがポリシヌを提䟛しおいない132* マシン䞊に管理蚭定ファむル、MDM プロファむル、キャッシュされたサヌバヌ管理蚭定などの管理蚭定゜ヌスが存圚したすが、Claude Code が [それを読み取るこずができず](https://code.claude.com/docs/ja/managed-settings.md#invalid-entries-in-managed-settings)、他の管理゜ヌスがポリシヌを提䟛しおいない

132 133 

133キヌなしでサむンむンする前に `ANTHROPIC_API_KEY` を蚭定解陀しおください。134キヌなしでサむンむンする前に `ANTHROPIC_API_KEY` を蚭定解陀しおください。

140 141 

141プロファむルに関するその他すべおのこずがこのサむンむンに適甚されたす。これには、他の認蚌情報に察するランク付け、`/status` で取埗される `Profile` 行、および claude.ai ログむンが必芁な機胜が含たれたす。[Anthropic プロファむルずフェデレヌション認蚌情報](#anthropic-profiles-and-federation-credentials)を参照しおください。142プロファむルに関するその他すべおのこずがこのサむンむンに適甚されたす。これには、他の認蚌情報に察するランク付け、`/status` で取埗される `Profile` 行、および claude.ai ログむンが必芁な機胜が含たれたす。[Anthropic プロファむルずフェデレヌション認蚌情報](#anthropic-profiles-and-federation-credentials)を参照しおください。

142 143 

144#### 管理察象マシンでキヌレスサむンむンの提䟛を停止する

145 

146Claude Code が [キヌレスサむンむン](#sign-in-without-an-api-key)を提䟛しないようにするには、デバむス管理ツヌルを䜿甚しお、[管理蚭定](https://code.claude.com/docs/ja/managed-settings.md)の [`forceLoginOrgUUID`](https://code.claude.com/docs/ja/settings-reference#forceloginorguuid) を各開発者のマシンにデプロむしたす。倀には [Console の組織 ID](https://platform.claude.com/settings/organization) を蚭定したす。デプロむする前に、各開発者が [API キヌを䜜成できるロヌル](#claude-console-authentication)を持っおいるこずを確認しおください。デプロむ埌は、そのロヌルを持たない開発者は `/login` で Console にサむンむンできなくなりたす。

147 

148`forceLoginMethod` を `"console"` に蚭定しただけの堎合、開発者は倱敗したサむンむンを再詊行しおキヌレスのオプションを遞択できたす。`forceLoginOrgUUID` をデプロむするず、ログむン画面からそのオプションはなくなりたすが、開発者は既に持っおいる、たたは [`ant auth login`](https://platform.claude.com/docs/en/cli-sdks-libraries/cli/authentication) で䜜成した [Anthropic プロファむル](#anthropic-profiles-and-federation-credentials)を匕き続き䜿甚できたす。デプロむ埌は、各マシンで以䞋の認蚌情報ずログむンに察凊しおください。

149 

150* **キヌレスサむンむン**: 開発者を API キヌに移行するには、いったんログアりトしおから Console に再床ログむンしおもらいたす。これによりキヌが䜜成されたす。キヌレスサむンむンの堎合は、シェルで `claude auth logout` を実行したす。`ant auth login` のプロファむルの堎合は、`ant auth logout` を実行したす。プロファむルず API キヌの䞡方がマシン䞊にあるず Claude Code はセッションを拒吊するため、先にログアりトしおもらいたす。

151* **環境倉数およびヘルパヌの認蚌情報**: Claude Code は、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、たたは `apiKeyHelper` で認蚌するセッションを、管理蚭定がそれらを提䟛しおいる堎合でも拒吊したす。これらの認蚌情報を削陀しおから、開発者に `/login` を実行しお保存枈みの API キヌを䜜成しおもらいたす。

152* **claude.ai ログむン**: Claude Code は、リストにない組織ぞの [ログむンを拒吊](#restrict-login-to-your-organization)したす。これにはマシン䞊で既に䜿甚䞭の組織も含たれたす。その組織を維持するには、`forceLoginOrgUUID` 配列に远加したす。

153 

143### クラりドプロバむダヌ認蚌154### クラりドプロバむダヌ認蚌

144 155 

145Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry を䜿甚するチヌムの堎合。156Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry を䜿甚するチヌムの堎合。

172* **`claude setup-token` および `/install-github-app`**: `forceLoginMethod` のみを匷制するため、別の組織でトヌクンを生成できたす183* **`claude setup-token` および `/install-github-app`**: `forceLoginMethod` のみを匷制するため、別の組織でトヌクンを生成できたす

173* **[ゲヌトりェむ](https://code.claude.com/docs/ja/claude-apps-gateway)サむンむン**: `forceLoginMethod: "gateway"` によっお遞択され、それによっお制限されず、Anthropic 組織に察しお認蚌されないため、`forceLoginOrgUUID` は適甚されたせん。ゲヌトりェむ ID プロバむダヌを䜿甚しおアクセスを制限したす184* **[ゲヌトりェむ](https://code.claude.com/docs/ja/claude-apps-gateway)サむンむン**: `forceLoginMethod: "gateway"` によっお遞択され、それによっお制限されず、Anthropic 組織に察しお認蚌されないため、`forceLoginOrgUUID` は適甚されたせん。ゲヌトりェむ ID プロバむダヌを䜿甚しおアクセスを制限したす

174 185 

175デバむス管理ツヌルを通じおキヌをデプロむしたす。[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)は、既に組織に認蚌されおいるアカりントにのみ到達するため、開発者の最初のログむンをリダむレクトできたせん。組織がサヌバヌ管理蚭定も配垃する堎合、䞡方の堎所にキヌを蚭定したす。管理蚭定゜ヌスは [マヌゞされず](https://code.claude.com/docs/ja/server-managed-settings.md#settings-precedence)、キャッシュされたサヌバヌ管理蚭定はデバむス管理ファむルを眮き換えたす。ただし、いく぀かの [キヌごずの䟋倖](https://code.claude.com/docs/ja/server-managed-settings.md#per-key-exceptions-across-managed-sources)を陀いお。`forceLoginOrgUUID` ず `forceLoginMethod` の `"claudeai"` および `"console"` 倀はこれらの䟋倖に含たれおいないため、䞡方の堎所に保持したす。186`forceLoginMethod` ず `forceLoginOrgUUID` はデバむス管理ツヌルを通じおデプロむしたす。開発者が [サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)を受け取るのは組織ぞの認蚌埌に限られるため、これらの蚭定で最初のログむンをリダむレクトするこずはできたせん。claude.ai からサヌバヌ管理蚭定も配垃しおいる堎合は、すべおのクラむアントが v2.1.299 以降を実行するようになるたで、そちらにも䞡方のキヌを蚭定しおください。その埌キヌを蚭定する堎所ず、どの゜ヌスの倀が適甚されるかに぀いおは、[ログむンキヌを提䟛する管理゜ヌス](https://code.claude.com/docs/ja/managed-settings.md#which-managed-source-supplies-login-keys)を参照しおください。

176 187 

177[ゲヌトりェむ](https://code.claude.com/docs/ja/claude-apps-gateway)デプロむメントでは、`forceLoginMethod` ず `forceLoginOrgUUID` を [ゲヌトりェむが提䟛する蚭定](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#managed)から陀倖したたたにしおください。188[ゲヌトりェむ](https://code.claude.com/docs/ja/claude-apps-gateway)デプロむメントでは、`forceLoginMethod` ず `forceLoginOrgUUID` を [ゲヌトりェむが提䟛する蚭定](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#managed)から陀倖したたたにしおください。

178 189 

auto-mode-config.md +26 −26

Details

155 155 

156すべおを䞀床に入力する必芁はありたせん。合理的なロヌルアりト: デフォルトから始めお、゜ヌス管理組織ず䞻芁な内郚サヌビスを远加したす。これにより、独自のリポゞトリぞのプッシュなど、最も䞀般的な誀怜知が解決されたす。次に信頌できるドメむンずクラりドバケットを远加したす。ブロックが発生したら残りを入力したす。156すべおを䞀床に入力する必芁はありたせん。合理的なロヌルアりト: デフォルトから始めお、゜ヌス管理組織ず䞻芁な内郚サヌビスを远加したす。これにより、独自のリポゞトリぞのプッシュなど、最も䞀般的な誀怜知が解決されたす。次に信頌できるドメむンずクラりドバケットを远加したす。ブロックが発生したら残りを入力したす。

157 157 

158## `/auto-mode-setup` で環境゚ントリを生成する158## `/auto-mode-setup` で environment ゚ントリを生成する

159 159 

160`/auto-mode-setup` を実行するず、Claude Code がプロゞェクトず最近のセッションから `autoMode.environment` ゚ントリを䜜成し、時には[ルヌル゚ントリ](#override-the-block-and-allow-rules)も䜜成したす。ドラフトを承認するず、Claude Code は `~/.claude/settings.json` に曞き蟌みたす。160`/auto-mode-setup` を実行するず、Claude Code がプロゞェクトずそのプロゞェクトでの最近のセッションから `autoMode.environment` ゚ントリの草案を䜜成し、堎合によっおは[ルヌル゚ントリ](#override-the-block-and-allow-rules)の草案も䜜成したす。草案を承認するず、Claude Code はそれを `~/.claude/settings.json` に曞き蟌みたす。

161 161 

162> [!NOTE]162> [!NOTE]

163>163>

164> `/auto-mode-setup` は Pro、Max、Team、Enterprise プラン、および Claude Console API キヌで利甚できたす。Pro、Max、たたは Team プランでは v2.1.228 以降が必芁です。ネむティブ Windows では v2.1.233 以降が必芁です。Enterprise プランたたは Claude Console API キヌでは v2.1.283 以降が必芁です。セッションにこのコマンドが芋圓たらない堎合は、[`/auto-mode-setup` が "Unknown command" を返す](#auto-mode-setup-returns-unknown-command)を参照しおください。164> `/auto-mode-setup` は Pro、Max、Team、Enterprise プラン、および Claude Console の API キヌで利甚できたす。Pro、Max、Team プランでは v2.1.228 以降ネむティブ Windows では v2.1.233 以降が必芁です。Enterprise プランたたは Claude Console の API キヌでは v2.1.283 以降が必芁です。セッションでこのコマンドが芋぀からない堎合は、[`/auto-mode-setup` が「Unknown command」を返す](#auto-mode-setup-returns-unknown-command)を参照しおください。

165 165 

166### `/auto-mode-setup` が読み蟌むもの166### `/auto-mode-setup` が読み取る内容

167 167 

168`~/.claude/settings.json` に既に `autoMode` ゚ントリが含たれおいる堎合、Claude Code はたず環境リストに远加するか眮き換えるかを尋ね、どちらの堎合でも䜜成したルヌルを保持したす。その埌、Claude Code はこのプロゞェクトの䜿甚方法を尋ね、スキャンの前に 2 ぀のオプションスキャンを提䟛したす。スキャンでは、Claude Code は垞にこれらの゜ヌスを読み蟌みたす168`~/.claude/settings.json` にすでに `autoMode` ゚ントリがある堎合、Claude Code はたず environment リストに远加するか眮き換えるかを尋ねたす。どちらの堎合も、ナヌザヌが曞いたルヌルは保持されたす。次に Claude Code はこのプロゞェクトの䜿い方を尋ね、スキャンを始める前に 2 ぀の任意のスキャンを提瀺したす。スキャンでは、Claude Code は垞に次の゜ヌスを読み取りたす。

169 169 

170* このプロゞェクトの `CLAUDE.md`、`README.md`、蚭定ファむル、および git リモヌト170* このプロゞェクトの `CLAUDE.md`、`README.md`、蚭定ファむル、git リモヌト

171* `autoMode` および `permissions.allow` 蚭定171* `autoMode` および `permissions.allow` の蚭定

172* Claude がこのプロゞェクトの最近のセッションで実行したコマンドのホスト、バケット、コマンド名メッセヌゞは含たない172* このプロゞェクトでの最近のセッションで Claude が実行したコマンドに含たれるホスト、バケット、コマンド名ナヌザヌのメッセヌゞは読み取りたせん

173 173 

1742 ぀のオプションスキャンは各々1 ぀の゜ヌスを远加したす1742 ぀の任意のスキャンは、それぞれ次の゜ヌスを 1 ぀ず぀远加したす。

175 175 

176* シェル履歎内の各コマンドの最初の単語176* シェル履歎にある各コマンドの最初の単語

177* ホヌムディレクトリ䞋のリポゞトリのリモヌトホストず名前177* ホヌムディレクトリ配䞋にあるリポゞトリのリモヌトホストず名前

178 178 

179### ドラフトを確認しお保存する179### 草案を確認しお保存する

180 180 

181Claude Code はバックグラりンドでスキャンを実行し、ドラフトを衚瀺したす。ドラフト党䜓を承認たたは砎棄し、その埌 `~/.claude/settings.json` を線集しお個別の゚ントリを調敎したす。承認するず、Claude Code はドラフトを曞き蟌み、既に持っおいる蚭定ず調敎したす181Claude Code はバックグラりンドでスキャンを行い、その埌草案を衚瀺したす。草案は党䜓ずしお承認たたは砎棄するため、個々の゚ントリを調敎するには埌で `~/.claude/settings.json` を線集しおください。承認するず、Claude Code は草案を曞き蟌み、既存の蚭定ず敎合させたす。

182 182 

183* Claude Code は `"$defaults"` なしで `environment` リストを曞き蟌みたす。ドラフトが倉曎されおいない組み蟌み゚ントリを明瀺しおいるため183* Claude Code は `environment` リストを `"$defaults"` なしで曞き蟌みたす。草案には、倉曎されなかった組み蟌み゚ントリが明蚘されおいるためです

184* Claude Code は、ドラフトが゚ントリを远加する `allow`、`soft_deny`、および `hard_deny` リストのそれぞれに `"$defaults"` を含めたす。ただし、既に `allow` リストを `"$defaults"` なしで䜜成しおいる堎合は陀きたす。そのため、眮き換えおいない[組み蟌みルヌル](#override-the-block-and-allow-rules)は有効なたたです184* Claude Code は、草案が゚ントリを远加する `allow`、`soft_deny`、`hard_deny` の各リストに `"$defaults"` を含めたすただし、`"$defaults"` を含たない `allow` リストをすでに曞いおいる堎合を陀きたす。これにより、眮き換えおいない[組み蟌みルヌル](#override-the-block-and-allow-rules)が匕き続き有効になりたす

185* 保存埌、Claude Code は `~/.claude/settings.json` 内の `permissions.allow` ルヌルを削陀するこずを提案したす。オヌトモヌドが無芖するもの`Bash(*)` など、たたは砎壊的なコマンドを自動承認するもの185* 保存埌、Claude Code は `~/.claude/settings.json` 内の `permissions.allow` ルヌルのうち、`Bash(*)` のように auto モヌドが無芖するもの、たたは砎壊的なコマンドを自動承認するものを削陀するよう提案したす

186 186 

187その埌、`claude auto-mode config` を実行しお[有効な結果を確認](#inspect-the-defaults-and-your-effective-config)したす。187その埌、`claude auto-mode config` を実行しお[実際に適甚される結果を確認](#inspect-the-defaults-and-your-effective-config)しおください。

188 188 

189### `/auto-mode-setup` をオフにする189### `/auto-mode-setup` をオフにする

190 190 

191オヌトモヌドが耇数のアクションをブロックし、ただ `autoMode.environment` ゚ントリがない堎合、Claude Code はタヌンの終わりに「オヌトモヌドに環境に぀いお教えたすか」ずいうタむトルのダむアログを衚瀺し、`/auto-mode-setup` を実行するこずを提案したす。提案を停止しおコマンドを保持するには、そのダむアログで **\[今埌衚瀺しない]** を遞択したす。191auto モヌドが耇数のアクションをブロックし、か぀ `autoMode.environment` ゚ントリがただない堎合、Claude Code はタヌンの終わりに「Teach auto mode about your environment?」ずいうタむトルのダむアログを衚瀺し、`/auto-mode-setup` を代わりに実行するこずを提案したす。コマンドは残したたた提案だけを止めるには、そのダむアログで **Don't show again** を遞択したす。

192 192 

193コマンドず提案の䞡方をオフにするには、この[`skillOverrides`](https://code.claude.com/docs/ja/skills#override-skill-visibility-from-settings) ゚ントリを `~/.claude/settings.json` に远加したす193コマンドず提案の䞡方をオフにするには、次の [`skillOverrides`](https://code.claude.com/docs/ja/skills#override-skill-visibility-from-settings) ゚ントリを `~/.claude/settings.json` に远加したす。

194 194 

195```json theme={null}195```json theme={null}

196{196{

200}200}

201```201```

202 202 

203`/auto-mode-setup` は[バンドルされたスキル](https://code.claude.com/docs/ja/skills.md#bundled-skills)ではなく組み蟌みコマンドなため、この `skillOverrides` ゚ントリは匕き続き適甚されたすが、[`disableBundledSkills`](https://code.claude.com/docs/ja/settings-reference#disablebundledskills) はオフにしたせん。203`/auto-mode-setup` は[バンドルスキル](https://code.claude.com/docs/ja/skills.md#bundled-skills)ではなく組み蟌みコマンドであるため、この `skillOverrides` ゚ントリは適甚されたすが、[`disableBundledSkills`](https://code.claude.com/docs/ja/settings-reference#disablebundledskills) ではオフになりたせん。

204 204 

205### `/auto-mode-setup` が "Unknown command" を返す205### `/auto-mode-setup` が「Unknown command」を返す

206 206 

207Claude Code のプロンプトで `/auto-mode-setup` ず入力したずきに `Unknown command: /auto-mode-setup` ず衚瀺される堎合は、以䞋の原因を確認しおください207Claude Code のプロンプトで `/auto-mode-setup` ず入力するず `Unknown command: /auto-mode-setup` ず衚瀺される堎合は、次の原因を確認しおください。

208 208 

209* **むンストヌルたたはアップグレヌド埌の最初のセッション**新しいセッションを開始しおください。そこでもコマンドが芋圓たらない堎合は、[以降のセッションもコマンドなしで開始されるセットアップ](https://code.claude.com/docs/ja/env-vars.md#first-session-after-an-install-or-upgrade)を参照しおください。209* **むンストヌルたたはアップグレヌド埌の最初のセッション**新しいセッションを開始しおください。それでもコマンドが芋぀からない堎合は、[以降のセッションでもコマンドなしで開始されるセットアップ](https://code.claude.com/docs/ja/env-vars.md#first-session-after-an-install-or-upgrade)を参照しおください。

210* **叀いバヌゞョン**シェルで `claude --version` を実行しおください。バヌゞョンが[プランの最小芁件](#generate-environment-entries)を䞋回っおいる堎合は、[Claude Code を曎新](https://code.claude.com/docs/ja/setup.md#update-claude-code)しおください。210* **叀いバヌゞョン**シェルで `claude --version` を実行したす。バヌゞョンが[プランの最小芁件](#generate-environment-entries)を䞋回っおいる堎合は、[Claude Code を曎新](https://code.claude.com/docs/ja/setup.md#update-claude-code)しおください。

211* **テレメトリがオフ、サヌドパヌティプロバむダヌ、たたは Claude apps ゲヌトりェむ**v2.1.304 より前では、[フィヌチャヌフラグ取埗がオフのセッション](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)ではこのコマンドを利甚できたせん。セッションがこれに該圓する堎合は、[Claude Code を v2.1.304 以降に曎新](https://code.claude.com/docs/ja/setup.md#update-claude-code)しおください。211* **テレメトリがオフ、サヌドパヌティプロバむダヌ、たたは Claude アプリのゲヌトりェむ**v2.1.304 より前では、[フィヌチャヌフラグの取埗がオフになっおいるセッション](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)ではこのコマンドを利甚できたせん。セッションがこれに該圓する堎合は、[Claude Code を曎新](https://code.claude.com/docs/ja/setup.md#update-claude-code)しお v2.1.304 以降にしおください。

212 212 

213[クラりドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)では、代わりに `/auto-mode-setup isn't available in this environment.` ず出力されたす。タヌミナルの察話型セッションで実行しおください。213[クラりドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)では、このコマンドは代わりに `/auto-mode-setup isn't available in this environment.` ず衚瀺したす。タヌミナルの察話型セッションで実行しおください。

214 214 

215## ブロックルヌルず蚱可ルヌルをオヌバヌラむドする215## ブロックルヌルず蚱可ルヌルをオヌバヌラむドする

216 216 

channels-reference.md +37 −37

Details

50 50 

51リサヌチプレビュヌ䞭、カスタムチャネルは[承認蚱可リスト](https://code.claude.com/docs/ja/channels.md#supported-channels)にありたせん。ロヌカルでテストするには `--dangerously-load-development-channels` を䜿甚しおください。詳现に぀いおは、[リサヌチプレビュヌ䞭のテスト](#test-during-the-research-preview)を参照しおください。51リサヌチプレビュヌ䞭、カスタムチャネルは[承認蚱可リスト](https://code.claude.com/docs/ja/channels.md#supported-channels)にありたせん。ロヌカルでテストするには `--dangerously-load-development-channels` を䜿甚しおください。詳现に぀いおは、[リサヌチプレビュヌ䞭のテスト](#test-during-the-research-preview)を参照しおください。

52 52 

53## 䟋webhook レシヌバヌを構築53## 䟋webhook レシヌバヌを構築する

54 54 

55このりォヌクスルヌでは、HTTP リク゚ストをリッスンしお Claude Code セッションに転送する単䞀ファむルサヌバヌを構築したす。終了時には、CI パむプラむン、監芖アラヌト、たたは `curl` コマンドなど、HTTP POST を送信できるものはすべお、Claude にむベントをプッシュできたす。55このりォヌクスルヌでは、HTTP リク゚ストを埅ち受けお Claude Code セッションに転送する単䞀ファむルのサヌバヌを構築したす。最終的には、CI パむプラむン、監芖アラヌト、`curl` コマンドなど、HTTP POST を送信できるものであれば䜕でも Claude にむベントをプッシュできるようになりたす。

56 56 

57この䟋では、組み蟌み HTTP サヌバヌず TypeScript サポヌトのために [Bun](https://bun.sh) をランタむムずしお䜿甚しおいたす。代わりに [Node](https://nodejs.org) たたは [Deno](https://deno.com) を䜿甚できたす。唯䞀の芁件は [MCP SDK](https://www.npmjs.com/package/@modelcontextprotocol/sdk) です。57この䟋では、組み蟌みの HTTP サヌバヌず TypeScript サポヌトを備えた [Bun](https://bun.sh) をランタむムずしお䜿甚したす。代わりに [Node](https://nodejs.org) や [Deno](https://deno.com) を䜿甚するこずもできたす。唯䞀の芁件は [MCP SDK](https://www.npmjs.com/package/@modelcontextprotocol/sdk) です。

58 58 

59**1. プロゞェクトを䜜成**59**1. プロゞェクトを䜜成する**

60 60 

61[暩限リレヌ](#relay-permission-prompts) の䟋は `zod` を盎接むンポヌトするため、MCP SDK ず䞀緒にむンストヌルされたす。新しいディレクトリを䜜成しお䞡方をむンストヌルしたす61[暩限リレヌ](#relay-permission-prompts)の䟋では `zod` を盎接むンポヌトするため、MCP SDK ず䞀緒にむンストヌルしたす。新しいディレクトリを䜜成し、䞡方をむンストヌルしたす。

62 62 

63```bash theme={null}63```bash theme={null}

64mkdir webhook-channel && cd webhook-channel64mkdir webhook-channel && cd webhook-channel

65bun add @modelcontextprotocol/sdk zod65bun add @modelcontextprotocol/sdk zod

66```66```

67 67 

68**2. チャネルサヌバヌを蚘述**68**2. チャネルサヌバヌを䜜成する**

69 69 

70`webhook.ts` ずいうファむルを䜜成したす。これはチャネルサヌバヌ党䜓ですstdio 経由で Claude Code に接続し、ポヌト 8788 で HTTP POST をリッスンしたす。リク゚ストが到着するず、本文をチャネルむベントずしお Claude にプッシュしたす。70`webhook.ts` ずいう名前のファむルを䜜成したす。これがチャネルサヌバヌのすべおです。stdio 経由で Claude Code に接続し、ポヌト 8788 で HTTP POST を埅ち受けたす。リク゚ストが届くず、その本文をチャネルむベントずしお Claude にプッシュしたす。

71 71 

72```ts title="webhook.ts" theme={null}72```ts title="webhook.ts" theme={null}

73#!/usr/bin/env bun73#!/usr/bin/env bun

74import { Server } from '@modelcontextprotocol/sdk/server/index.js'74import { Server } from '@modelcontextprotocol/sdk/server/index.js'

75import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'75import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'

76 76 

77// MCP サヌバヌを䜜成しおチャネルずしお宣蚀77// Create the MCP server and declare it as a channel

78const mcp = new Server(78const mcp = new Server(

79 { name: 'webhook', version: '0.0.1' },79 { name: 'webhook', version: '0.0.1' },

80 {80 {

81 // このキヌがチャネルにする — Claude Code はそれのリスナヌを登録81 // this key is what makes it a channel — Claude Code registers a listener for it

82 capabilities: { experimental: { 'claude/channel': {} } },82 capabilities: { experimental: { 'claude/channel': {} } },

83 // Claude Code はサヌバヌが接続するずきこれを Claude にコンテキストずしお配信するため、これらのむベントの凊理方法を知っおいる83 // Claude Code delivers this to Claude as context when the server connects, so it knows how to handle these events

84 instructions: 'Events from the webhook channel arrive as <channel source="webhook" ...>. They are one-way: read them and act, no reply expected.',84 instructions: 'Events from the webhook channel arrive as <channel source="webhook" ...>. They are one-way: read them and act, no reply expected.',

85 },85 },

86)86)

87 87 

88// stdio 経由で Claude Code に接続Claude Code はこのプロセスを生成88// Connect to Claude Code over stdio (Claude Code spawns this process)

89await mcp.connect(new StdioServerTransport())89await mcp.connect(new StdioServerTransport())

90 90 

91// すべおの POST を Claude に転送する HTTP サヌバヌを開始91// Start an HTTP server that forwards every POST to Claude

92Bun.serve({92Bun.serve({

93 port: 8788, // 任意のオヌプンポヌトが機胜93 port: 8788, // any open port works

94 // localhost のみこのマシンの倖からは䜕も POST できない94 // localhost-only: nothing outside this machine can POST

95 hostname: '127.0.0.1',95 hostname: '127.0.0.1',

96 async fetch(req) {96 async fetch(req) {

97 const body = await req.text()97 const body = await req.text()

98 await mcp.notification({98 await mcp.notification({

99 method: 'notifications/claude/channel',99 method: 'notifications/claude/channel',

100 params: {100 params: {

101 content: body, // <channel> タグの本文になる101 content: body, // becomes the body of the <channel> tag

102 // 各キヌはタグ属性になる、䟋<channel path="/" method="POST">102 // each key becomes a tag attribute, e.g. <channel path="/" method="POST">

103 meta: { path: new URL(req.url).pathname, method: req.method },103 meta: { path: new URL(req.url).pathname, method: req.method },

104 },104 },

105 })105 })

108})108})

109```109```

110 110 

111ファむルは順番に 3 ぀のこずを実行したす111このファむルは、サヌバヌの蚭定、stdio 経由での接続、HTTP リスナヌの起動をこの順序で行いたす。

112 112 

113* **サヌバヌ蚭定**`claude/channel` をその機胜に含む MCP サヌバヌを䜜成したす。これが Claude Code にこれがチャネルであるこずを䌝えたす。Claude Code はサヌバヌが接続するずきに [`instructions`](#server-options) 文字列を Claude にコンテキストずしお配信したすClaude に期埅するむベント、返信するかどうか、返信する堎合はどのように返信をルヌティングするかを䌝えたす。113* **サヌバヌ蚭定**capabilities に `claude/channel` を含めお MCP サヌバヌを䜜成したす。これにより、Claude Code はこれがチャネルであるず認識したす。サヌバヌが接続するず、Claude Code は [`instructions`](#server-options) 文字列をコンテキストずしお Claude に枡したす。どのようなむベントが届くのか、返信すべきかどうか、返信する堎合はどのようにルヌティングするかを Claude に䌝えおください。

114* **Stdio 接続**stdin/stdout 経由で Claude Code に接続したす。これは任意の [MCP サヌバヌ](https://modelcontextprotocol.io/docs/concepts/transports#standard-io) の暙準です。114* **stdio 接続**stdin/stdout 経由で Claude Code に接続したす。これはあらゆる [MCP サヌバヌ](https://modelcontextprotocol.io/docs/concepts/transports#standard-io)で暙準的な方法です。

115* **HTTP リスナヌ**ポヌト 8788 でロヌカル Web サヌバヌを開始したす。すべおの POST 本文は `mcp.notification()` 経由でチャネルむベントずしお Claude に転送されたす。`content` はむベント本文になり、各 `meta` ゚ントリは `<channel>` タグの属性になりたす。リスナヌは `mcp` むンスタンスぞのアクセスが必芁なため、同じプロセスで実行されたす。より倧きなプロゞェクトの堎合は、別のモゞュヌルに分割できたす。115* **HTTP リスナヌ**ポヌト 8788 でロヌカル Web サヌバヌを起動したす。すべおの POST 本文は `mcp.notification()` を介しおチャネルむベントずしお Claude に転送されたす。`content` がむベント本文になり、各 `meta` ゚ントリは `<channel>` タグの属性になりたす。リスナヌは `mcp` むンスタンスにアクセスする必芁があるため、同じプロセス内で実行されたす。倧芏暡なプロゞェクトでは、別々のモゞュヌルに分割するこずもできたす。

116 116 

117**3. Claude Code にサヌバヌを登録**117**3. サヌバヌを Claude Code に登録する**

118 118 

119Claude Code がそれを開始する方法を知るように、MCP 蚭定にサヌバヌを远加したす。同じディレクトリのプロゞェクトレベル `.mcp.json` の堎合は、盞察パスを䜿甚したす。`~/.claude.json` のナヌザヌレベル蚭定の堎合は、サヌバヌが任意のプロゞェクトから芋぀かるように完党な絶察パスを䜿甚したす119Claude Code がサヌバヌの起動方法を認識できるように、MCP 蚭定にサヌバヌを远加したす。同じディレクトリ内のプロゞェクトレベルの `.mcp.json` では、盞察パスを䜿甚したす。`~/.claude.json` のナヌザヌレベルの蚭定では、どのプロゞェクトからでもサヌバヌを芋぀けられるように完党な絶察パスを䜿甚したす。

120 120 

121```json title=".mcp.json" theme={null}121```json title=".mcp.json" theme={null}

122{122{

126}126}

127```127```

128 128 

129Claude Code は起動時に MCP 蚭定を読み蟌み、各サヌバヌをサブプロセスずしお生成したす。129Claude Code は起動時に MCP 蚭定を読み蟌み、各サヌバヌをサブプロセスずしお起動したす。

130 130 

131**4. テスト**131**4. テストする**

132 132 

133リサヌチプレビュヌ䞭、カスタムチャネルは蚱可リストにないため、開発フラグで Claude Code を開始したす133リサヌチプレビュヌ期間䞭、カスタムチャネルは蚱可リストに含たれおいないため、開発甚フラグを付けお Claude Code を起動したす。

134 134 

135```bash theme={null}135```bash theme={null}

136claude --dangerously-load-development-channels server:webhook136claude --dangerously-load-development-channels server:webhook

137```137```

138 138 

139Claude Code は最初に、読み蟌んでいる開発チャネルをリストする党画面譊告ダむアログを衚瀺したす。**ロヌカル開発に䜿甚しおいたす** を遞択しお続行するか、**終了** を遞択しお終了したす。139Claude Code はたず、読み蟌もうずしおいる開発甚チャネルを䞀芧衚瀺する党画面の譊告ダむアログを衚瀺したす。続行するには **I am using this for local development** を、終了するには **Exit** を遞択したす。

140 140 

141このプロゞェクトで初めおセッションを開始するずき、Claude Code は `.mcp.json` から新しいサヌバヌを䜿甚する前に同意を求めたす。ダむアログは「このプロゞェクトで芋぀かった新しい MCP サヌバヌwebhook」ず報告したす。**このMCPサヌバヌを䜿甚** を遞択しお続行したす。141このプロゞェクトで初めおセッションを開始するずきは、Claude Code は `.mcp.json` の新しいサヌバヌを䜿甚する前に同意も求めたす。ダむアログには「New MCP server found in this project: webhook」ず衚瀺されたす。続行するには **Use this MCP server** を遞択したす。

142 142 

143同意した埌、Claude Code は `webhook.ts` をサブプロセスずしお生成し、HTTP リスナヌは蚭定したポヌトこの䟋では 8788で自動的に開始されたす。サヌバヌを自分で実行する必芁はありたせん。143同意するず、Claude Code は `webhook.ts` をサブプロセスずしお起動し、蚭定したポヌトこの䟋では 8788で HTTP リスナヌが自動的に起動したす。サヌバヌを自分で実行する必芁はありたせん。

144 144 

145スタヌトアップバナヌの䞋の薄い通知がチャネルが登録されたこずを確認したす`Channels (experimental) messages from server:webhook inject directly in this session · restart without --dangerously-load-development-channels to stop`。145起動バナヌの䞋に薄く衚瀺される通知で、チャネルが登録されたこずを確認できたす`Channels (experimental) messages from server:webhook inject directly in this session · restart without --dangerously-load-development-channels to stop`。

146 146 

147'組織ポリシヌによっおブロックされおいたす'が衚瀺される堎合は、組織管理者が最初に [チャネルを有効化](https://code.claude.com/docs/ja/channels.md#enterprise-controls) する必芁がありたす。147「blocked by org policy」ず衚瀺された堎合は、たず組織の管理者が[チャネルを有効化](https://code.claude.com/docs/ja/channels.md#enterprise-controls)する必芁がありたす。

148 148 

149別のタヌミナルで、HTTP POST でメッセヌゞを送信しお webhook をシミュレヌトしたす。この䟋は、CI 倱敗アラヌトをポヌト 8788たたは蚭定したポヌトに送信したす149別のタヌミナルで、メッセヌゞを含む HTTP POST をサヌバヌに送信しお webhook をシミュレヌトしたす。この䟋では、CI の倱敗アラヌトをポヌト 8788たたは蚭定したポヌトに送信したす。

150 150 

151```bash theme={null}151```bash theme={null}

152curl -X POST localhost:8788 -d "build failed on main: https://ci.example.com/run/1234"152curl -X POST localhost:8788 -d "build failed on main: https://ci.example.com/run/1234"

153```153```

154 154 

155ペむロヌドは Claude のコンテキストに `<channel>` タグずしお到着したす155ペむロヌドは `<channel>` タグずしお Claude のコンテキストに届きたす。

156 156 

157```text theme={null}157```text theme={null}

158<channel source="webhook" path="/" method="POST">158<channel source="webhook" path="/" method="POST">

160</channel>160</channel>

161```161```

162 162 

163タヌミナルはむベントを 1 行の抂芁ずしお、`← webhook: build failed on main: https://ci.example.com/run/1234` ずしおレンダリングしたす。これは生のタグではなく、その埌 Claude が応答を開始するのが芋えたすファむルを読み蟌み、コマンドを実行、たたはメッセヌゞが芁求するもの。これは䞀方向チャネルなので、Claude はセッションで動䜜したすが、webhook を通じお䜕も返送したせん。返信を远加するには、[返信ツヌルを公開](#expose-a-reply-tool) を参照しおください。163タヌミナルでは、むベントは生のタグではなく、`← webhook: build failed on main: https://ci.example.com/run/1234` ずいう 1 行の芁玄ずしお衚瀺されたす。その埌、Claude が応答を開始し、ファむルの読み取りやコマンドの実行など、メッセヌゞが必芁ずする䜜業を行う様子が確認できたす。これは䞀方向のチャネルなので、Claude はセッション内で動䜜したすが、webhook を通じお䜕かを送り返すこずはありたせん。返信を远加するには、[返信ツヌルを公開する](#expose-a-reply-tool)を参照しおください。

164 164 

165むベントが到着しない堎合、蚺断は `curl` が返したものに䟝存したす165むベントが届かない堎合、蚺断方法は `curl` が返した結果によっお異なりたす。

166 166 

167* **`curl` は成功するが Claude に䜕も到着しない**セッションで `/mcp` を実行しおサヌバヌのステヌタスを確認したす。`failed` ステヌタスは通垞、サヌバヌファむルの䟝存関係たたはむンポヌト゚ラヌを意味したす。stderr トレヌスを確認するには、`claude --debug --dangerously-load-development-channels server:webhook` で再開し、`~/.claude/debug/<session-id>.txt` のデバッグログを確認しおください。167* **`curl` は成功したが Claude に䜕も届かない**セッションで `/mcp` を実行しおサヌバヌのステヌタスを確認したす。`failed` ステヌタスは通垞、サヌバヌファむル内の䟝存関係たたはむンポヌトの゚ラヌを意味したす。stderr のトレヌスを確認するには、`claude --debug --dangerously-load-development-channels server:webhook` で再起動し、`~/.claude/debug/<session-id>.txt` のデバッグログを確認したす。

168* **`curl` が「接続が拒吊されたした」で倱敗**ポヌトはただバむンドされおいないか、以前の実行からの叀いプロセスがそれを保持しおいたす。`lsof -i :<port>` は䜕がリッスンしおいるかを瀺したす。セッションを再開する前に叀いプロセスを `kill` しおください。168* **`curl` が「connection refused」で倱敗する**ポヌトがただバむンドされおいないか、以前の実行で残った叀いプロセスがポヌトを占有しおいたす。`lsof -i :<port>` で埅ち受けおいるものを確認できたす。セッションを再起動する前に、叀いプロセスを `kill` しおください。

169 169 

170[fakechat サヌバヌ](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/fakechat) は、Web UI、ファむル添付、および双方向チャットの返信ツヌルでこのパタヌンを拡匵したす。170[fakechat サヌバヌ](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/fakechat)は、このパタヌンを拡匵し、Web UI、ファむル添付、双方向チャットのための返信ツヌルを远加しおいたす。

171 171 

172## リサヌチプレビュヌ䞭のテスト172## リサヌチプレビュヌ䞭のテスト

173 173 

checkpointing.md +25 −25

Details

10 10 

11## チェックポむントの仕組み11## チェックポむントの仕組み

12 12 

13Claude で䜜業する際、チェックポむント機胜は送信する各プロンプトがタヌンを開始する前のコヌド状態を自動的にキャプチャしたす。13Claude ず䜜業する際、チェックポむント機胜は、タヌンを開始するプロンプトを送信するたびに、その前のコヌドの状態を自動的に保存したす。

14 14 

15### 自動远跡15### 自動远跡

16 16 

17Claude Code は、ファむル線集ツヌルで行われたすべおの倉曎を远跡したす。17Claude Code は、ファむル線集ツヌルによっお行われたすべおの倉曎を远跡したす。

18 18 

19* 送信する各プロンプトがタヌンを開始するたびに新しいチェックポむントが䜜成されたす19* タヌンを開始するプロンプトを送信するたびに、新しいチェックポむントが䜜成されたす

20* Claude Code はセッション内の最新 100 個のチェックポむントのファむルスナップショットを保持したす。叀いチェックポむントを砎棄するず、残りのチェックポむントが参照しないスナップショットファむルが削陀されたす。ただし、各ファむルの最初のスナップショットは陀倖されたす。これは VS Code 拡匵機胜がセッション diff のベヌスラむンずしお䜿甚したす。20* Claude Code は、セッション内の盎近 100 個のチェックポむントに぀いおファむルのスナップショットを保持したす。叀いチェックポむントを砎棄するず、残っおいるどのチェックポむントからも参照されおいないスナップショットファむルが削陀されたす。ただし、各ファむルの最初のスナップショットは、VS Code 拡匵機胜がセッションの差分のベヌスラむンずしお䜿甚するため削陀されたせん。

21* チェックポむントはセッションず共に保存されるため、再開したセッションでも `/rewind` で戻るこずができたす21* Claude Code はチェックポむントを䌚話ずずもに保存するため、セッションを再開した埌でも `/rewind` を実行できたす

22* Claude Code は[保持期間スむヌプ](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)でセッションのファむルスナップショットを削陀したす。デフォルトではセッションが最埌に保存されおから玄 30 日埌です。スナップショットが削陀されたチェックポむントに巻き戻すず、[`No files were restored`](https://code.claude.com/docs/ja/errors#no-files-were-restored) ゚ラヌで倱敗する可胜性がありたす。スナップショットをより長く保持するには、[`cleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#cleanupperioddays) を蚭定しおください。22* Claude Code は、[保持期間のクリヌンアップ](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)でセッションのファむルスナップショットを削陀したす。デフォルトでは、セッションが最埌にスナップショットを保存しおから玄 30 日埌に削陀されたす。スナップショットが削陀されたチェックポむントに巻き戻そうずするず、[`No files were restored`](https://code.claude.com/docs/ja/errors#no-files-were-restored) で倱敗するこずがありたす。スナップショットをより長く保持するには、[`cleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#cleanupperioddays) を蚭定しおください。

23 23 

24### 巻き戻しず芁玄24### 巻き戻しず芁玄

25 25 

26`/rewind` を実行するか、プロンプト入力が空の状態で `Esc` キヌを 2 回抌しお、巻き戻しメニュヌを開きたす。26`/rewind` を実行するか、プロンプト入力が空のずきに `Esc` を 2 回抌すず、巻き戻しメニュヌが開きたす。

27 27 

28> [!NOTE]28> [!NOTE]

29>29>

30> プロンプト入力にテキストが含たれおいる堎合、ダブル `Esc` はメニュヌを開く代わりにテキストをクリアしたす。クリアされたテキストは入力履歎に保存されるため、巻き戻しメニュヌを終了した埌に `Up` キヌを抌しお呌び出すこずができたす。30> プロンプト入力にテキストが含たれおいる堎合、`Esc` を 2 回抌すずメニュヌは開かず、代わりにテキストがクリアされたす。クリアされたテキストは入力履歎に保存されるため、巻き戻しメニュヌでの操䜜を終えた埌に `Up` を抌すず呌び出せたす。

31 31 

32巻き戻しメニュヌには、セッション䞭に送信したプロンプトが䞀芧衚瀺されたす。操䜜したいポむントを遞択しおから、アクションを遞択したす。32巻き戻しメニュヌには、セッション䞭に送信したプロンプトが䞀芧衚瀺されたす。操䜜したい時点を遞択し、次のいずれかのアクションを遞びたす。

33 33 

34* **コヌドず䌚話を埩元**: コヌドず䌚話の䞡方をそのポむントに戻したす34* **Restore code and conversation**コヌドず䌚話の䞡方をその時点に戻したす

35* **䌚話を埩元**: 珟圚のコヌドを保持しながら、そのメッセヌゞに巻き戻したす35* **Restore conversation**珟圚のコヌドを維持したたた、そのメッセヌゞたで䌚話を巻き戻したす

36* **コヌドを埩元**: 䌚話を保持しながら、ファむルの倉曎を戻したす36* **Restore code**䌚話を維持したたた、ファむルの倉曎を元に戻したす

37* **ここから芁玄**: このポむント以降の䌚話を圧瞮しお芁玄し、コンテキストりィンドりスペヌスを解攟したす37* **Summarize from here**この時点以降の䌚話を芁玄に圧瞮し、コンテキストりィンドりの空きを確保したす

38* **ここたで芁玄**: このポむント前の䌚話を芁玄に圧瞮し、埌のメッセヌゞはそのたた保持したす38* **Summarize up to here**この時点より前の䌚話を芁玄に圧瞮し、それ以降のメッセヌゞはそのたた残したす

39* **キャンセル**: 倉曎を加えずにメッセヌゞリストに戻りたす39* **Never mind**倉曎を加えずにメッセヌゞ䞀芧に戻りたす

40 40 

412 ぀のコヌド埩元オプションは、遞択したチェックポむントが戻すべき远跡されたファむル倉曎を持぀堎合にのみ衚瀺されたす。そのポむント以降にファむル線集がキャプチャされおいない堎合、メニュヌは **䌚話を埩元**、芁玄オプション、および **キャンセル** のみを提䟛したす。412 ぀のコヌド埩元オプションは、遞択したチェックポむントに元に戻すべき远跡枈みのファむル倉曎がある堎合にのみ衚瀺されたす。その時点以降にファむル線集が蚘録されおいない堎合、メニュヌには **Restore conversation**、芁玄オプション、**Never mind** のみが衚瀺されたす。

42 42 

43䌚話を埩元たたは「ここから芁玄」を遞択した埌、遞択したメッセヌゞからの元のプロンプトが入力フィヌルドに埩元されるため、再送信たたは線集できたす。43䌚話を埩元するか Summarize from here を遞択するず、遞択したメッセヌゞの元のプロンプトが入力フィヌルドに埩元されるため、再送信したり線集したりできたす。

44 44 

45「ここたで芁玄」を遞択するず、䌚話の最埌に留たり、入力フィヌルドは空になりたす。どちらの芁玄オプションでも、圧瞮されたメッセヌゞがあった䌚話内に **芁玄された䌚話** マヌカヌが衚瀺されたす。45Summarize up to here を遞択するず、入力が空の状態で䌚話の末尟に戻りたす。どちらの芁玄オプションでも、圧瞮されたメッセヌゞがあった䜍眮に **Summarized conversation** マヌカヌが䌚話内に衚瀺されたす。

46 46 

47#### 巻き戻したメッセヌゞは、次のプロンプトの前に終了するず戻るこずがありたす47#### 次のプロンプトを送信する前に終了するず、巻き戻したメッセヌゞが戻るこずがある

48 48 

49戻ったメッセヌゞを再び削陀するには、セッションで `/rewind` を実行しお同じプロンプトを遞択し、**䌚話を埩元** を遞択したす。Claude Code は巻き戻した䌚話をそのプロンプトず共に保存するため、終了する前に Claude にプロンプトを送信しおください。埩元したファむルは巻き戻した時点の状態のたた保持されたす。49戻っおきたメッセヌゞを再び削陀するには、そのセッションで `/rewind` を実行しお同じプロンプトを遞択し、**Restore conversation** を遞びたす。終了する前に Claude にプロンプトを送信しおください。Claude Code は巻き戻した䌚話をそのプロンプトずずもに保存するためです。埩元したファむルは、巻き戻した時点の状態のたた残りたす。

50 50 

51#### クリアされた䌚話を超えお巻き戻す51#### クリアした䌚話より前に巻き戻す

52 52 

53同じ Claude Code プロセスの前の段階で `/clear` を実行した堎合、巻き戻しメニュヌはリストの最䞊郚に `/resume <session-id> (previous session)` ずいうラベルの远加゚ントリを衚瀺したす。これを遞択しお、`/clear` が実行される前にアクティブだった䌚話を再開したす。この゚ントリは Claude Code を終了するか別のセッションを再開するたで利甚可胜です。53同じ Claude Code プロセス内で以前に `/clear` を実行しおいた堎合、巻き戻しメニュヌの䞀芧の先頭に `/resume <session-id> (previous session)` ずいうラベルの項目が远加で衚瀺されたす。これを遞択するず、`/clear` を実行する前にアクティブだった䌚話を再開できたす。この項目は、Claude Code を終了するか別のセッションを再開するたで利甚できたす。

54 54 

55#### 芁玄をガむドする55#### 芁玄の内容を指瀺する

56 56 

57芁玄はディスク䞊のファむルを倉曎せず、元のメッセヌゞはセッショントランスクリプトに保持されるため、Claude は詳现を参照できたす。芁玄が焊点を圓おるべき内容をガむドするには、矢印キヌで **芁玄** オプションをハむラむトし、行が **コンテキストを远加オプション** ず衚瀺されおいる堎所に指瀺を入力しおから、`Enter` キヌを抌したす。数字キヌでオプションを遞択するず、指瀺なしで即座に芁玄されたす。57芁玄しおもディスク䞊のファむルは倉曎されず、元のメッセヌゞはセッションのトランスクリプトに残るため、Claude は匕き続き詳现を参照できたす。芁玄で重点を眮く内容を指瀺するには、矢印キヌで **Summarize** オプションをハむラむトし、**add context (optional)** ず衚瀺されおいる行に指瀺を入力しおから `Enter` を抌したす。数字キヌでオプションを遞択するず、指瀺なしですぐに芁玄されたす。

58 58 

59> [!NOTE]59> [!NOTE]

60>60>

61> 芁玄はセッションを同じ状態に保ち、コンテキストを圧瞮したす。これは察象を絞った `/compact` のようなものです。元のセッションを保持したたた異なるアプロヌチを詊したい堎合は、代わりに [`/branch`](https://code.claude.com/docs/ja/sessions#branch-a-session) たたは `claude --continue --fork-session` を䜿甚しおください。61> 芁玄は同じセッションにずどたったたたコンテキストを圧瞮するもので、察象を絞った `/compact` のように機胜したす。元のセッションをそのたた保持し぀぀分岐しお別のアプロヌチを詊すには、代わりに [`/branch`](https://code.claude.com/docs/ja/sessions#branch-a-session) たたは `claude --continue --fork-session` を䜿甚しおください。

62 62 

63## 䞀般的なナヌスケヌス63## 䞀般的なナヌスケヌス

64 64 

Details

397* **`deny` ゚ントリ**`path` たたは `name` ずモヌドのみで転送されたす。397* **`deny` ゚ントリ**`path` たたは `name` ずモヌドのみで転送されたす。

398* **[`mode: mask`](https://code.claude.com/docs/ja/sandboxing#mask-credential-files)を持぀ファむル゚ントリ**センチネルのみずしお転送され、`injectHosts` が空のリストである党ファむルマスクずしお。プロキシは芪が提䟛した゚ントリの実際の倀を任意のプラットフォヌムで眮き換えるこずはありたせん。すべおの構造化マスキングフィヌルドも削陀されるため、芪が提䟛した抜出パタヌンは別の゜ヌスが同じパスに蚭定するより厳密なマスクを眮き換えるこずはできたせん。398* **[`mode: mask`](https://code.claude.com/docs/ja/sandboxing#mask-credential-files)を持぀ファむル゚ントリ**センチネルのみずしお転送され、`injectHosts` が空のリストである党ファむルマスクずしお。プロキシは芪が提䟛した゚ントリの実際の倀を任意のプラットフォヌムで眮き換えるこずはありたせん。すべおの構造化マスキングフィヌルドも削陀されるため、芪が提䟛した抜出パタヌンは別の゜ヌスが同じパスに蚭定するより厳密なマスクを眮き換えるこずはできたせん。

399* **`mode: mask` を持぀ `envVars` ゚ントリ**転送されたせん。`deny` は芪チャネルが `envVars` ゚ントリを通じお衚珟できる唯䞀の制限です。399* **`mode: mask` を持぀ `envVars` ゚ントリ**転送されたせん。`deny` は芪チャネルが `envVars` ゚ントリを通じお衚珟できる唯䞀の制限です。

400* **[`awsPairs` ず `sigv4`](https://code.claude.com/docs/ja/sandboxing#re-sign-aws-requests)**制限のみ転送されたす。`sigv4` からは `deny` 倀のみが保持され、芪が `sigv4` ブロックをたったく定矩する堎合、すべおの 3 ぀のリク゚スト圢匏 `streaming`、`presigned`、および `sigv4a` を `deny` にピン留めしたす。`awsPairs` ペアは再眲名できる圢匏では転送されたせん。埓来の AWS 倉数の 1 ぀に名前を付けるペアは、`AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、および `AWS_SESSION_TOKEN` の自動ペアリングを抑制したたたにする䞍掻性゚ントリに眮き換えられたす。400* **[`awsPairs` ず `sigv4`](https://code.claude.com/docs/ja/sandboxing#re-sign-aws-requests)**制限のみ転送されたす。`sigv4` からは `deny` 倀のみが保持され、芪が `sigv4` ブロックを䜕らかの圢で定矩する堎合、すべおの 3 ぀のリク゚スト圢匏 `streaming`、`presigned`、および `sigv4a` を `deny` にピン留めしたす。`awsPairs` ペアは再眲名できる圢匏では転送されたせん。埓来の AWS 倉数の 1 ぀に名前を付けるペアは、`AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、および `AWS_SESSION_TOKEN` の自動ペアリングを抑制したたたにする䞍掻性゚ントリに眮き換えられたす。

401 401 

402#### ロックをデプロむする402#### ロックをデプロむする

403 403 

446 446 

4475 ぀のロックすべおが蚭定されおいおも、以䞋の芪が提䟛した蚭定はフィルタヌを通過したす。4475 ぀のロックすべおが蚭定されおいおも、以䞋の芪が提䟛した蚭定はフィルタヌを通過したす。

448 448 

449* **`forceLoginOrgUUID`**最優先の管理゜ヌスが組織 UUID を蚭定しない堎合、Claude Code は芪が提䟛した倀を尊重したす。ゲヌトりェむサむンむンはこのキヌをチェックしたせん。最優先の管理゜ヌスの組織 UUID は芪の倀をブロックし、Claude Code が匷制するものです。449* **`forceLoginOrgUUID`**Claude Code が適甚する管理蚭定が組織 UUID を蚭定しおいない堎合、Claude Code は芪が提䟛した倀を尊重したす。ゲヌトりェむサむンむンはこのキヌをチェックしたせん。Claude Code が適甚する管理蚭定内の組織 UUID は芪の倀をブロックし、Claude Code が匷制する組織 UUID になりたす。フリヌトで Anthropic 組織を固定しおいる堎合、`forceLoginOrgUUID` をどこに蚭定するかに぀いおは[ログむンキヌを提䟛する管理゜ヌス](https://code.claude.com/docs/ja/managed-settings.md#which-managed-source-supplies-login-keys)を参照しおください。

450* **`allowedMcpServers`**有効な管理リストがない堎合、Claude Code は芪が提䟛した蚱可リストを尊重したす。`allowManagedMcpServersOnly` はそれをブロックしたせん。ロックは勝者ずなったリストを管理倀ずしお匷制し、どの管理゜ヌスもリストを提䟛しない堎合は芪が提䟛したリストも含たれるためです。最優先の管理゜ヌスのリストは芪のリストをブロックし、Claude Code が匷制するリストになるため、ロックの隣のそこに `allowedMcpServers` を蚭定したす。v2.1.223 より前では、任意の管理゜ヌスのいずれかのキヌの倀は芪の倀をブロックしたした。450* **`allowedMcpServers`**有効な管理リストがない堎合、Claude Code は芪が提䟛した蚱可リストを尊重したす。`allowManagedMcpServersOnly` はそれをブロックしたせん。ロックは勝者ずなったリストを管理倀ずしお匷制し、どの管理゜ヌスもリストを提䟛しない堎合は芪が提䟛したリストも含たれるためです。最優先の管理゜ヌスのリストは芪のリストをブロックし、Claude Code が匷制するリストになるため、ロックの隣のそこに `allowedMcpServers` を蚭定したす。v2.1.223 より前では、任意の管理゜ヌスのいずれかのキヌの倀は芪の倀をブロックしたした。

451* **`availableModels`**勝者の管理゜ヌスが蚭定しない堎合、Claude Code は芪が提䟛したモデルリストを尊重したす。フリヌトがモデルを制限する堎合、勝者゜ヌスに `availableModels` を蚭定したす。451* **`availableModels`**勝者の管理゜ヌスが蚭定しない堎合、Claude Code は芪が提䟛したモデルリストを尊重したす。フリヌトがモデルを制限する堎合、勝者゜ヌスに `availableModels` を蚭定したす。

452* **`allowedProviders`**勝者の管理゜ヌスが蚭定しない堎合、Claude Code は芪が提䟛した API プロバむダヌ蚱可リストを尊重したす。フリヌトが開発者の䜿甚できる API プロバむダヌを制限する堎合、勝者゜ヌスに `allowedProviders` を蚭定したす。Claude Code v2.1.285 以降が必芁です。452* **`allowedProviders`**勝者の管理゜ヌスが蚭定しない堎合、Claude Code は芪が提䟛した API プロバむダヌ蚱可リストを尊重したす。フリヌトが開発者の䜿甚できる API プロバむダヌを制限する堎合、勝者゜ヌスに `allowedProviders` を蚭定したす。Claude Code v2.1.285 以降が必芁です。

454* **`blockedMarketplaces`**芪が提䟛したマヌケットプレむスブロックリストは通過し、管理゜ヌスが蚭定するブロックリストに远加されたす。ブロックリストはさらに制限するこずのみができるためです。Claude Code v2.1.282 以降が必芁です。454* **`blockedMarketplaces`**芪が提䟛したマヌケットプレむスブロックリストは通過し、管理゜ヌスが蚭定するブロックリストに远加されたす。ブロックリストはさらに制限するこずのみができるためです。Claude Code v2.1.282 以降が必芁です。

455* **`strictPluginOnlyCustomization`**このキヌはロックに関係なくフィルタヌを通過し、Claude Code が開発者独自のカスタマむズ保護フックを含むを無芖するようにしたす。ロックはそれをブロックしたせん。455* **`strictPluginOnlyCustomization`**このキヌはロックに関係なくフィルタヌを通過し、Claude Code が開発者独自のカスタマむズ保護フックを含むを無芖するようにしたす。ロックはそれをブロックしたせん。

456 456 

457デフォルトの最初の勝ちの蚭定の䞋では、管理倀が芪の倀をブロックするのは、それが最優先の管理゜ヌスにある堎合のみです。ただし、[MCP サヌバヌロック](#lock-behavior-across-sources)がオンの間の `allowedMcpServers` は陀きたす。`managedSourcesBehavior` マヌゞオプトむンの䞋では、[Claude Code が管理゜ヌスを組み合わせる方法](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources)が代わりにどの゜ヌスの倀が適甚されるかを瀺したす。457`managedSourcesBehavior` を `"merge"` に蚭定しおいる堎合は、[キヌの皮類ごずにどの゜ヌスの倀が適甚されるか](https://code.claude.com/docs/ja/managed-settings.md#compose-every-managed-source)を確認しおください。

458 458 

459#### 芪蚭定のフックキヌずスキルキヌがどのように有効になるか459#### 芪蚭定のフックキヌずスキルキヌがどのように有効になるか

460 460 

Details

419 419 

420```yaml theme={null}420```yaml theme={null}

421models:421models:

422 - id: claude-opus-restricted # a custom id, not a built-in model name422 - id: restricted-claude-opus-4-8 # a custom id, not a built-in model name

423 upstream_model:423 upstream_model:

424 bedrock-isolated: us.anthropic.claude-opus-4-8 # the only upstream that serves it424 bedrock-isolated: us.anthropic.claude-opus-4-8 # the only upstream that serves it

425```425```

629 629 

630ゲヌトりェむは倱敗したアップストリヌムの蚘録を保持しないため、アップストリヌムがダりンしおいる間、そこに到達するすべおのリク゚ストは匕き続きそのアップストリヌムを詊行し、倱敗するのを埅っおから次に進みたす。630ゲヌトりェむは倱敗したアップストリヌムの蚘録を保持しないため、アップストリヌムがダりンしおいる間、そこに到達するすべおのリク゚ストは匕き続きそのアップストリヌムを詊行し、倱敗するのを埅っおから次に進みたす。

631 631 

632Anthropic API アップストリヌムでは、[`timeouts.upstream_ttfb_ms`](#http-tuning) がダりンしたアップストリヌムでの埅機時間の䞊限を定めたす。この蚭定は他のプロバむダヌには適甚されず、それらのプロバむダヌでは、ゲヌトりェむはアップストリヌムが応答を開始するたで最倧 1 時間埅機したす。632ゲヌトりェむがレスポンスの開始を埅機する時間は次のずおりです。

633 

634* **`provider: anthropic` アップストリヌム**: [`timeouts.upstream_ttfb_ms`](#http-tuning)。デフォルトは 120 秒

635* **その他のプロバむダヌ**: 最倧 1 時間。ストリヌミングリク゚ストでこの埅機時間を短瞮するには、ゲヌトりェむ v2.1.295 以降で `timeouts.upstream_ttfb_ms` を蚭定したす。非ストリヌミングのモデルリク゚ストは、いずれの堎合も最倧 1 時間埅機したす

633 636 

634`404` はアップストリヌムごずのモデルの提䟛状況を衚すため、モデルを有効にしおいないアップストリヌムが、そのモデルを提䟛する埌続のアップストリヌムを劚げるこずはありたせん。芁求されたモデルを解決できないアップストリヌムは、ネットワヌクのラりンドトリップなしでスキップされたす。637`404` はアップストリヌムごずのモデルの提䟛状況を衚すため、モデルを有効にしおいないアップストリヌムが、そのモデルを提䟛する埌続のアップストリヌムを劚げるこずはありたせん。芁求されたモデルを解決できないアップストリヌムは、ネットワヌクのラりンドトリップなしでスキップされたす。

635 638 

873 policies:876 policies:

874 - match: { groups: [restricted-projects] }877 - match: { groups: [restricted-projects] }

875 cli:878 cli:

876 availableModels: [claude-opus-restricted]879 availableModels: [restricted-claude-opus-4-8]

877 enforceAvailableModels: true880 enforceAvailableModels: true

878 model: claude-opus-restricted881 model: restricted-claude-opus-4-8

882 env:

883 ANTHROPIC_DEFAULT_OPUS_MODEL: restricted-claude-opus-4-8 # opus and Default resolve to the ID too

879```884```

880 885 

881#### ゲヌトりェむをブヌト時に停止させる matcher 倀886#### ゲヌトりェむをブヌト時に停止させる matcher 倀

1146 1151 

1147`blockReadsOutsideWorkingDirectories`、`disableBypassPermissionsMode`、`configRecheckIntervalMinutes`、`sshClientPath` には、ゲヌトりェむサヌバヌ䞊の Claude Code v2.1.281 以降が必芁です。`microsoftAuthBroker` の `required` 倀ず、Microsoft 365 `managedMcpServers` ゚ントリの `continuousAccessEvaluation` フィヌルドも同様です。`required` 倀より前の Claude Desktop リリヌスはそれを `disabled` ずしお読み取るため、すべおのメンバヌの Claude Desktop がサポヌトしおから `required` を蚭定しおください。Claude Desktop の [管理蚭定リファレンス](https://claude.com/docs/third-party/claude-desktop/configuration) には、各キヌを最初に読み取るリリヌスがリストされおいたす。1152`blockReadsOutsideWorkingDirectories`、`disableBypassPermissionsMode`、`configRecheckIntervalMinutes`、`sshClientPath` には、ゲヌトりェむサヌバヌ䞊の Claude Code v2.1.281 以降が必芁です。`microsoftAuthBroker` の `required` 倀ず、Microsoft 365 `managedMcpServers` ゚ントリの `continuousAccessEvaluation` フィヌルドも同様です。`required` 倀より前の Claude Desktop リリヌスはそれを `disabled` ずしお読み取るため、すべおのメンバヌの Claude Desktop がサポヌトしおから `required` を蚭定しおください。Claude Desktop の [管理蚭定リファレンス](https://claude.com/docs/third-party/claude-desktop/configuration) には、各キヌを最初に読み取るリリヌスがリストされおいたす。

1148 1153 

1154> [!NOTE]

1155>

1156> [`sshTransport`](https://claude.com/docs/third-party/claude-desktop/configuration#sshtransport) には、ゲヌトりェむサヌバヌ䞊の Claude Code v2.1.293 以降が必芁です。

1157 

1149ポリシヌの `desktop` ブロックで `orgPluginSettings` を蚭定した堎合、ゲヌトりェむは Claude Desktop 1.15200.0 以降が読み取る配列圢匏で提䟛したす。叀いデスクトップは配列を無芖し、プラグむンツヌルポリシヌを匷制しないため、それに䟝存する前にメンバヌを 1.15200.0 以降に曎新しおください。1158ポリシヌの `desktop` ブロックで `orgPluginSettings` を蚭定した堎合、ゲヌトりェむは Claude Desktop 1.15200.0 以降が読み取る配列圢匏で提䟛したす。叀いデスクトップは配列を無芖し、プラグむンツヌルポリシヌを匷制しないため、それに䟝存する前にメンバヌを 1.15200.0 以降に曎新しおください。

1150 1159 

1151##### ロヌルポリシヌが基盀の `desktop` ブロックを継承する仕組み1160##### ロヌルポリシヌが基盀の `desktop` ブロックを継承する仕組み

1396| `limits` | `max_request_bytes` | 32 MiB | むンバりンドリク゚ストボディの最倧サむズ。サむズを超えたリク゚ストはボディがバッファリングされる前に `413` を受け取りたす。倧きなファむルや画像のリク゚ストの堎合は䞊げおください。 |1405| `limits` | `max_request_bytes` | 32 MiB | むンバりンドリク゚ストボディの最倧サむズ。サむズを超えたリク゚ストはボディがバッファリングされる前に `413` を受け取りたす。倧きなファむルや画像のリク゚ストの堎合は䞊げおください。 |

1397| `limits` | `max_request_header_bytes` | 未蚭定 | リク゚ストのヘッダヌ党䜓に察するゲヌトりェむの 256 KiB の制限を匕き䞋げたす。制限を超えたリク゚ストは `431` を返し、256 KiB を超える倀は効果がありたせん。サむンむン埌にデベロッパヌが `431` を受け取る堎合は、[サむンむン埌にリク゚ストヘッダヌが倧きすぎる](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#request-headers-too-large-after-sign-in) を参照しおください。 |1406| `limits` | `max_request_header_bytes` | 未蚭定 | リク゚ストのヘッダヌ党䜓に察するゲヌトりェむの 256 KiB の制限を匕き䞋げたす。制限を超えたリク゚ストは `431` を返し、256 KiB を超える倀は効果がありたせん。サむンむン埌にデベロッパヌが `431` を受け取る堎合は、[サむンむン埌にリク゚ストヘッダヌが倧きすぎる](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#request-headers-too-large-after-sign-in) を参照しおください。 |

1398| `limits` | `max_url_length` | 未蚭定 | 蚭定されおいる堎合、長すぎる URL は `414` を返したす |1407| `limits` | `max_url_length` | 未蚭定 | 蚭定されおいる堎合、長すぎる URL は `414` を返したす |

1399| `timeouts` | `upstream_ttfb_ms` | 120000 | 䞊流のレスポンスヘッダヌの最倧埅機時間最初のバむトたでの時間。その埌、レスポンスボディは経過時間の䞊限なしでストリヌミングされたす。盎接 Anthropic 䞊流パスに適甚されたす。他のすべおのプロバむダヌでは、ゲヌトりェむはレスポンスが開始されるたで最倧 1 時間埅機したす。 |1408| `timeouts` | `upstream_ttfb_ms` | 120000 | アップストリヌムのレスポンスヘッダヌを埅぀最倧時間最初のバむトたでの時間。その埌のレスポンス本文は経過時間の䞊限なしでストリヌミングされたす。キヌが未蚭定の堎合、デフォルトは `provider: anthropic` のアップストリヌムに適甚され、その他のプロバむダヌではゲヌトりェむはレスポンスの開始たで最倧 1 時間埅機したす。この埅機時間を短くするには、[耇数のアップストリヌム](#multiple-upstreams)を参照しおください。 |

1400| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | 認蚌されおいないデバむス認可゚ンドポむントの IP ごずのレヌト制限。共有出力 IP や NAT の背埌にある倧芏暡な組織の堎合は䞊げおください。サむズの決め方は [倧芏暡ロヌルアりト](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#large-rollouts) を参照しおください。これらの制限はデバむスグラントのサむンむンフロヌにのみ適甚され、`/v1/messages` の掚論には適甚されたせん。[ナヌザヌコヌドのブルヌトフォヌス耐性](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#user-code-brute-force-resistance) を参照しおください。 |1409| `rate_limits` | `device_authorization.max` / `.window_seconds` | 30 / 600 | 認蚌されおいないデバむス認可゚ンドポむントの IP ごずのレヌト制限。共有出力 IP や NAT の背埌にある倧芏暡な組織の堎合は䞊げおください。サむズの決め方は [倧芏暡ロヌルアりト](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#large-rollouts) を参照しおください。これらの制限はデバむスグラントのサむンむンフロヌにのみ適甚され、`/v1/messages` の掚論には適甚されたせん。[ナヌザヌコヌドのブルヌトフォヌス耐性](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#user-code-brute-force-resistance) を参照しおください。 |

1401| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | `/device` での `user_code` 送信の IP ごずのレヌト制限。他のデベロッパヌのコヌドの掚枬を防ぐものです。どこたで䞊げるかに぀いおは [倧芏暡ロヌルアりト](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#large-rollouts) を参照しおください。 |1410| `rate_limits` | `device_verify.max` / `.window_seconds` | 10 / 600 | `/device` での `user_code` 送信の IP ごずのレヌト制限。他のデベロッパヌのコヌドの掚枬を防ぐものです。どこたで䞊げるかに぀いおは [倧芏暡ロヌルアりト](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#large-rollouts) を参照しおください。 |

1402 1411 

Details

228 228 

229Teleport には claude.ai のサブスクリプション認蚌が必芁です。該圓するケヌスを確認しおください。229Teleport には claude.ai のサブスクリプション認蚌が必芁です。該圓するケヌスを確認しおください。

230 230 

231* **API キヌで認蚌しおいる**: 代わりに `/login` を実行しお claude.ai アカりントでサむンむンしおください231* **API キヌたたは Console アカりントでサむンむンしおいる**: シェルで `claude auth login` を実行し、claude.ai でサむンむンしおください

232* **゚ラヌにプロバむダヌ名が衚瀺される**: クラりドセッションはサヌドパヌティプロバむダヌ経由では利甚できたせん。[゚ラヌ衚](#errors-when-sending-to-a-cloud-session)を参照しおください232* **゚ラヌにプロバむダヌ名が衚瀺される**: クラりドセッションはサヌドパヌティプロバむダヌ経由では利甚できたせん。[゚ラヌ衚](#errors-when-sending-to-a-cloud-session)を参照しおください

233* **すでに claude.ai でサむンむンしおいる**: 組織がクラりドセッションを無効にしおいる可胜性がありたす233* **すでに claude.ai でサむンむンしおいる**: 組織がクラりドセッションを無効にしおいる可胜性がありたす

234 234 

437 437 

438### 組織 UUID を取埗できない438### 組織 UUID を取埗できない

439 439 

440`claude --cloud` ず `claude --teleport` には claude.ai アカりントでのサむンむンが必芁です。API キヌで認蚌しおいる堎合、たたは保存されたアカりント詳现が叀い堎合、次のいずれかが衚瀺されたす。440`claude --cloud` ず `claude --teleport` には claude.ai アカりントでのサむンむンが必芁です。代わりに API キヌたたは Console のサむンむンで認蚌しおいる堎合、あるいは保存されたアカりント詳现が叀い堎合、次のようなメッセヌゞが衚瀺されたす。

441 441 

442* `Unable to get organization UUID`442* `Unable to get organization UUID`

443* ``Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.``443* ``Cloud sessions need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.``

444* ``Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in. Run `claude auth login` (or /login in a local session), then try again.``

444* セッション ID なしで `claude --teleport` を実行した堎合、セッションピッカヌでの `Error loading Claude Code sessions`445* セッション ID なしで `claude --teleport` を実行した堎合、セッションピッカヌでの `Error loading Claude Code sessions`

445 446 

446シェルで [`claude auth login`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しお claude.ai アカりントでサむンむンし、コマンドを再詊行しおください。実行䞭のセッション内では、`/login` でも同じこずができたす。゚ラヌにプロバむダヌ名が瀺されおいる堎合は、[゚ラヌテヌブル](#errors-when-sending-to-a-cloud-session)を参照しおください。クラりドセッションはサヌドパヌティプロバむダヌを通じおは利甚できたせん。447シェルで [`claude auth login`](https://code.claude.com/docs/ja/cli-reference#cli-commands) を実行しお claude.ai アカりントでサむンむンし、コマンドを再詊行しおください。実行䞭のセッション内では、`/login` でも同じこずができたす。゚ラヌにプロバむダヌ名が瀺されおいる堎合は、[゚ラヌテヌブル](#errors-when-sending-to-a-cloud-session)を参照しおください。クラりドセッションはサヌドパヌティプロバむダヌを通じおは利甚できたせん。

claude-directory.md +1 −1

Details

132| `tasks/` | タスクツヌルで曞き蟌たれたタスクリスト。リストごずに 1 ぀のディレクトリ |132| `tasks/` | タスクツヌルで曞き蟌たれたタスクリスト。リストごずに 1 ぀のディレクトリ |

133| `shell-snapshots/` | 起動時にキャプチャされた゚むリアス、関数、シェルオプション。[Bash ツヌル](https://code.claude.com/docs/ja/tools-reference.md#bash-tool-behavior)によっお各コマンドに適甚されたす。クリヌンな終了時に削陀されたす。スむヌプはクラッシュ埌に残されたものをクリアしたす |133| `shell-snapshots/` | 起動時にキャプチャされた゚むリアス、関数、シェルオプション。[Bash ツヌル](https://code.claude.com/docs/ja/tools-reference.md#bash-tool-behavior)によっお各コマンドに適甚されたす。クリヌンな終了時に削陀されたす。スむヌプはクラッシュ埌に残されたものをクリアしたす |

134| `backups/` | `~/.claude.json` の以前のバヌゞョン。Claude Code がファむルを曞き盎すずきにコピヌされたす。Claude Code は最新の 5 ぀ず、解析できなかったバヌゞョンのコピヌを保持したす |134| `backups/` | `~/.claude.json` の以前のバヌゞョン。Claude Code がファむルを曞き盎すずきにコピヌされたす。Claude Code は最新の 5 ぀ず、解析できなかったバヌゞョンのコピヌを保持したす |

135| `feedback-bundles/` | `/feedback` でサヌドパヌティプロバむダヌに曞き蟌たれた、たたは Anthropic 認蚌情報が蚭定されおいない堎合に曞き蟌たれた、線集枈みトランスクリプトアヌカむブ。Anthropic アカりントチヌムに送信するため |135| `feedback-bundles/` | サヌドパヌティプロバむダヌ䞊で、たたは Anthropic 認蚌情報が蚭定されおいない堎合に `/feedback` によっお曞き蟌たれた、線集枈みトランスクリプトアヌカむブ。Anthropic アカりントチヌムに送信するため |

136| `feedback/drafts/` | キュヌに入った [Claude が䜜成したフィヌドバック](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior)。`/feedback` でのレビュヌを埅機䞭です。`cleanupPeriodDays` たたは 30 日のいずれか短い方の埌にスむヌプされたす。キュヌが 10 ドラフトの䞊限に達するず、Claude Code は最も叀いドラフトを削陀しお空き容量を䜜りたす |136| `feedback/drafts/` | キュヌに入った [Claude が䜜成したフィヌドバック](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior)。`/feedback` でのレビュヌを埅機䞭です。`cleanupPeriodDays` たたは 30 日のいずれか短い方の埌にスむヌプされたす。キュヌが 10 ドラフトの䞊限に達するず、Claude Code は最も叀いドラフトを削陀しお空き容量を䜜りたす |

137| `usage-data/` | `report.html` ず [`/insights`](https://code.claude.com/docs/ja/costs#analyze-your-usage-patterns)で曞き蟌たれたタむムスタンプ付きレポヌトコピヌ。それらを構築するために䜿甚されるキャッシュされたセッションごずの分析デヌタ |137| `usage-data/` | `report.html` ず [`/insights`](https://code.claude.com/docs/ja/costs#analyze-your-usage-patterns)で曞き蟌たれたタむムスタンプ付きレポヌトコピヌ。それらを構築するために䜿甚されるキャッシュされたセッションごずの分析デヌタ |

138| `skills/.trash/`、`plugins/.trash/` | [スキル](https://code.claude.com/docs/ja/skills.md#how-synced-skills-behave)ず [プラグむン](https://code.claude.com/docs/ja/plugins/loading.md#synced-plugins)。claude.ai 同期で削陀されたもの。䟋えば、claude.ai でオフにした埌、たたは同期を停止した埌。ファむルはここに残るため、スむヌプが削陀するたで埩元できたす |138| `skills/.trash/`、`plugins/.trash/` | [スキル](https://code.claude.com/docs/ja/skills.md#how-synced-skills-behave)ず [プラグむン](https://code.claude.com/docs/ja/plugins/loading.md#synced-plugins)。claude.ai 同期で削陀されたもの。䟋えば、claude.ai でオフにした埌、たたは同期を停止した埌。ファむルはここに残るため、スむヌプが削陀するたで埩元できたす |

Details

99 99 

100これらの芁件によっお、シヌクレットを远加できるかどうか、および远加埌に゚ヌゞェントプロキシがそれを䜿甚できるかどうかが決たりたす。100これらの芁件によっお、シヌクレットを远加できるかどうか、および远加埌に゚ヌゞェントプロキシがそれを䜿甚できるかどうかが決たりたす。

101 101 

102* **ロヌル**: Pro、Max、Team プランでは、ロヌルに関係なく自分の環境でシヌクレットを远加および削陀できたす。Team および Enterprise では、Owner は claude.ai 組織内で組織管理者ロヌルを保持し、Admin は保持したせん。これにより、次のケヌスで衚瀺される内容が倉わりたす。102* **ロヌル**: すべおのプランで、ロヌルに関係なく自分の環境でシヌクレットを远加および削陀できたす。Team および Enterprise では、Owner は claude.ai 組織内で組織管理者ロヌルを保持し、Admin は保持したせん。これにより、次のケヌスで衚瀺される内容が倉わりたす。

103 * **Enterprise での自分の環境**: 組織管理者ロヌルがあれば、シヌクレットを远加および削陀できたす。ない堎合、**ネットワヌクシヌクレット** 行を遞択するず「Only an organization admin can add or delete network secrets」ずいう泚蚘付きでシヌクレットのリストが開き、**シヌクレットを远加** ボタンや削陀ボタンはありたせん。Owner に [共有環境](#organization-shared-environments) ぞのシヌクレットの远加を䟝頌し、そこでセッションを実行しおください103 * **自分の環境**: 組織管理者ロヌルがない堎合、**シヌクレットを远加** を遞択するず [短いフォヌム](#add-a-secret-without-the-role) が開きたす

104 * **共有環境**: Owner が管理蚭定から [シヌクレットを远加および削陀](#add-a-credential) したす。組織管理者ロヌルがない堎合は、環境のダむアログに **ネットワヌクシヌクレット** セクションがないため、Owner にシヌクレットの远加を䟝頌しおください104 * **共有環境**: Owner が管理蚭定から [シヌクレットを远加および削陀](#add-a-credential) したす。組織管理者ロヌルがない堎合は、環境のダむアログに **ネットワヌクシヌクレット** セクションがないため、Owner にシヌクレットの远加を䟝頌しおください

105 * **Team での自分の環境**: 組織管理者ロヌルがない堎合、**シヌクレットを远加** を遞択するず、1 ぀のホストを指定する [短いフォヌム](#add-a-secret-without-the-role) が開きたす

106* **環境タむプ**: 既に存圚する Anthropic ホスト型クラりド環境。[自己ホスト型環境](https://code.claude.com/docs/ja/self-hosted-environments) にはネットワヌクシヌクレットがありたせん105* **環境タむプ**: 既に存圚する Anthropic ホスト型クラりド環境。[自己ホスト型環境](https://code.claude.com/docs/ja/self-hosted-environments) にはネットワヌクシヌクレットがありたせん

107* **API 到達可胜性**: API がむンタヌネットからの接続を受け入れたす。リク゚ストは Anthropic のネットワヌクから離れるためです106* **API 到達可胜性**: API がむンタヌネットからの接続を受け入れたす。リク゚ストは Anthropic のネットワヌクから離れるためです

108* **暗号化キヌ**: 組織が顧客管理の暗号化キヌを䜿甚する堎合、ネットワヌクシヌクレットを保存できたせん107* **暗号化キヌ**: 組織が顧客管理の暗号化キヌを䜿甚する堎合、ネットワヌクシヌクレットを保存できたせん

111 110 

112シヌクレットは䞀床に 1 ぀ず぀远加したす。シヌクレットのホストたたは倀を倉曎するには、削陀しお再床远加したす。111シヌクレットは䞀床に 1 ぀ず぀远加したす。シヌクレットのホストたたは倀を倉曎するには、削陀しお再床远加したす。

113 112 

114[共有環境](#organization-shared-environments) にシヌクレットを远加するには、[管理蚭定](https://claude.ai/admin-settings) の **クラりド環境** ペヌゞから環境を線集甚に開き、その **ネットワヌクシヌクレット** セクションで手順 2 から続けたす。Team プランで [組織管理者ロヌル](#requirements) を持っおいない堎合は、自分の環境で手順 1 に埓い、その埌 [短いフォヌムに入力](#add-a-secret-without-the-role) したす。113[共有環境](#organization-shared-environments) にシヌクレットを远加するには、[管理蚭定](https://claude.ai/admin-settings) の **クラりド環境** ペヌゞから環境を線集甚に開き、その **ネットワヌクシヌクレット** セクションで手順 2 から続けたす。Team たたは Enterprise プランで [組織管理者ロヌル](#requirements) を持っおいない堎合は、自分の環境で手順 1 に埓い、その埌 [短いフォヌムに入力](#add-a-secret-without-the-role) したす。

115 114 

116**1. 環境のネットワヌクシヌクレットを開く**115**1. 環境のネットワヌクシヌクレットを開く**

117 116 

133 132 

134シヌクレットが機胜するこずを確認するには、環境でセッションを開始しお Claude に API を呌び出すよう䟝頌したす。䟋えば `curl` を䜿甚したす。API はキヌがリク゚ストにあるかのように応答し、キヌはセッションの環境倉数たたはファむルに衚瀺されたせん。リストがシヌクレットを **送信されおいたせん** ずマヌクしおいる堎合、その䞋のメモは理由ず察凊方法を説明しおいたす。ホストが正確に䞀臎せずに重耇する 2 ぀のシヌクレットはマヌカヌを取埗せず、゚ヌゞェントプロキシはそのうちの 1 ぀だけを送信したす。133シヌクレットが機胜するこずを確認するには、環境でセッションを開始しお Claude に API を呌び出すよう䟝頌したす。䟋えば `curl` を䜿甚したす。API はキヌがリク゚ストにあるかのように応答し、キヌはセッションの環境倉数たたはファむルに衚瀺されたせん。リストがシヌクレットを **送信されおいたせん** ずマヌクしおいる堎合、その䞋のメモは理由ず察凊方法を説明しおいたす。ホストが正確に䞀臎せずに重耇する 2 ぀のシヌクレットはマヌカヌを取埗せず、゚ヌゞェントプロキシはそのうちの 1 ぀だけを送信したす。

135 134 

136#### 組織管理者ロヌルなしで Team プランでシヌクレットを远加する135#### 組織管理者ロヌルなしでシヌクレットを远加する

137 136 

138Team プランで [組織管理者ロヌル](#requirements) を持っおいない堎合、**シヌクレットを远加** フォヌムでは 1 ぀のホストに察しお 1 ぀のシヌクレットを指定したす。環境の [**ネットワヌクシヌクレット** 行](#add-a-credential) を遞択し、次に **シヌクレットを远加** を遞択したす。次のフィヌルドに入力し、フォヌムの **シヌクレットを远加** ボタンを遞択したす。137Team たたは Enterprise プランで [組織管理者ロヌル](#requirements) を持っおいない堎合、**シヌクレットを远加** フォヌムでは 1 ぀のホストに察しお 1 ぀のシヌクレットを指定したす。環境の [**ネットワヌクシヌクレット** 行](#add-a-credential) を遞択し、次に **シヌクレットを远加** を遞択したす。次のフィヌルドに入力し、フォヌムの **シヌクレットを远加** ボタンを遞択したす。

139 138 

140* **ホスト**: シヌクレットを受け取る 1 ぀のホスト`api.example.com` など。フォヌムは `*.` ワむルドカヌドを受け付けたせん139* **ホスト**: シヌクレットを受け取る 1 ぀のホスト`api.example.com` など。フォヌムは `*.` ワむルドカヌドを受け付けたせん

141* **名前**: シヌクレットの任意のラベル140* **名前**: シヌクレットの任意のラベル

context-window.md +10 −10

Details

43 43 

44スキル本䜓は圧瞮埌に再床泚入されたすが、倧きなスキルはスキルあたりのキャップに収たるようにトリミングされ、合蚈予算を超えるず最も叀い呌び出されたスキルがドロップされたす。トリミングはファむルの開始を保持するため、`SKILL.md` の䞊郚に最も重芁な指瀺を配眮しおください。44スキル本䜓は圧瞮埌に再床泚入されたすが、倧きなスキルはスキルあたりのキャップに収たるようにトリミングされ、合蚈予算を超えるず最も叀い呌び出されたスキルがドロップされたす。トリミングはファむルの開始を保持するため、`SKILL.md` の䞊郚に最も重芁な指瀺を配眮しおください。

45 45 

46## コンテキストがいっぱいになるずき46## コンテキストがいっぱいになったずき

47 47 

48Claude Code はコンテキストりィンドりの制限に近づくず自動的にコンテキスト圧瞮を実行するため、コンテキストりィンドりがいっぱいになっおもセッションが終了するこずはありたせん。自動パスはタむムラむンの `/compact` ステップず同じ方法で機胜したす。保持される内容に぀いおは、[コンテキストがいっぱいになるずき](https://code.claude.com/docs/ja/how-claude-code-works.md#when-context-fills-up)を参照しおください。アむドル状態のたた攟眮した䌚話を Claude Code が圧瞮する堎合に぀いおは、[アむドル時の圧瞮](https://code.claude.com/docs/ja/settings-reference.md#idlecompaction)を参照しおください。48Claude Code は䞊限に近づくず自動的にコンテキスト圧瞮を行うため、コンテキストりィンドりがいっぱいになっおもセッションが終了するこずはありたせん。自動圧瞮は、タむムラむンの `/compact` ステップず同じように動䜜したす。䜕が保持されるかに぀いおは、[コンテキストがいっぱいになったずき](https://code.claude.com/docs/ja/how-claude-code-works.md#when-context-fills-up)を参照しおください。攟眮された䌚話を Claude Code が圧瞮する堎合に぀いおは、[アむドル時の圧瞮](https://code.claude.com/docs/ja/settings-reference.md#idlecompaction)を参照しおください。

49 49 

50自動パスが実行される前に察応するこずもできたす。50自動圧瞮が実行される前に、自分で察凊するこずもできたす。

51 51 

52* **フォヌカスを絞っおコンパクション**: `/compact` を指瀺付きで実行したす。䟋えば、`/compact focus on the auth bug fix` のように、長い新しいタスクを開始する前に実行しおください。サマリヌは自動パスが重芁だず掚枬するものではなく、あなたが遞択したものを保持したす。52* **焊点を指定しお圧瞮する**: 長い新しいタスクを始める前に、`/compact focus on the auth bug fix` のように指瀺を付けお `/compact` を実行したす。芁玄には、自動圧瞮が重芁だず掚枬する内容ではなく、ナヌザヌが遞んだ内容が残りたす。

53* **䌚話の䞀郚をコンパクション**: `/rewind` を実行し、メッセヌゞを遞択しお、**ここから芁玄** たたは **ここたで芁玄** を遞択しおください。各オプションが保持する内容ず芁玄をガむドする方法に぀いおは、[リワむンドず芁玄](https://code.claude.com/docs/ja/checkpointing.md#rewind-and-summarize)を参照しおください。53* **䌚話の䞀郚を圧瞮する**: `/rewind` を実行しおメッセヌゞを遞択し、**Summarize from here** たたは **Summarize up to here** を遞びたす。各オプションで䜕が保持されるか、たた芁玄をどのように誘導するかに぀いおは、[巻き戻しず芁玄](https://code.claude.com/docs/ja/checkpointing.md#rewind-and-summarize)を参照しおください。

54* **より早くコンパクション**: [`/autocompact`](https://code.claude.com/docs/ja/commands#all-commands) をトヌクン数付きで実行したす。䟋えば `/autocompact 500k` のように、自動パスが実行される前にコンテキストりィンドりがどの皋床いっぱいになるかを蚭定しおください。受け入れられる倀ずオヌバヌラむドに぀いおは、[自動コンパクトりィンドりを蚭定](https://code.claude.com/docs/ja/model-config.md#set-the-auto-compact-window)を参照しおください。54* **早めに圧瞮する**: `/autocompact 500k` のようにトヌクン数を指定しお [`/autocompact`](https://code.claude.com/docs/ja/commands#all-commands) を実行し、自動圧瞮が実行されるたでにコンテキストりィンドりがどれだけ埋たるかを蚭定したす。指定できる倀ず䞊曞きに぀いおは、[自動圧瞮のりィンドりを蚭定する](https://code.claude.com/docs/ja/model-config.md#set-the-auto-compact-window)を参照しおください。

55* **タスク間でクリア**: 関連のない䜜業に切り替えるずきに `/clear` を実行しおください。叀い䌚話は次に必芁なファむルを圧迫し、すべおのメッセヌゞでトヌクンを消費したす。55* **タスクの合間にクリアする**: 関係のない䜜業に切り替えるずきは `/clear` を実行したす。叀い䌚話は次に必芁なファむルを抌し出し、メッセヌゞごずにトヌクンを消費したす。

56* **倧きな読み蟌みを委譲**: 研究を[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md)に送信しお、ファむルコンテンツがあなたのコンテキストりィンドりではなく、そのコンテキストりィンドりに留たるようにしおください。56* **倧量の読み蟌みを委任する**: 調査を[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md)に任せるず、ファむルの内容はナヌザヌのコンテキストりィンドりではなく、サブ゚ヌゞェントのコンテキストりィンドりにずどたりたす。

57 57 

58より小さな䌚話ではなく、より倧きなりィンドりが必芁な堎合、Fable モデル、Sonnet 5 以降、Haiku 5.5、Opus 4.6 以降、および Sonnet 4.6 は 100 䞇トヌクンのコンテキストりィンドりをサポヌトしおいたす。プランごずの利甚可胜性ず `[1m]` モデルバリアントの遞択方法に぀いおは、[拡匵コンテキスト](https://code.claude.com/docs/ja/model-config.md#extended-context)を参照しおください。コンテキスト圧瞮はより倧きな制限でも同じ方法で機胜したす。58䌚話を小さくするのではなく、より倧きなりィンドりが必芁な堎合は、Fable モデル、Sonnet 5 以降、Haiku 5.5、Opus 4.6 以降、Sonnet 4.6 が 100 䞇トヌクンのコンテキストりィンドりに察応しおいたす。プランごずの利甚可吊ず `[1m]` モデルバリアントの遞択方法に぀いおは、[拡匵コンテキスト](https://code.claude.com/docs/ja/model-config.md#extended-context)を参照しおください。䞊限が倧きくなっおも、圧瞮は同じように動䜜したす。

59 59 

60自動コンパクションが実行される時点は、あなたのモデルず蚭定によっお異なりたす。モデルごずの境界に぀いおは[デフォルト自動コンパクトしきい倀](https://code.claude.com/docs/ja/model-config.md#default-auto-compact-thresholds)を参照しおください。Claude Code があなたのモデル ID[LLM ゲヌトりェむ](https://code.claude.com/docs/ja/llm-gateway)゚むリアスなどに察しお間違ったりィンドりを想定しおいる堎合は、[ゲヌトりェむたたはカスタムモデル ID のりィンドりを修正](https://code.claude.com/docs/ja/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id)を参照しおください。60自動圧瞮が実行されるタむミングは、モデルず蚭定によっお異なりたす。モデルごずの境界に぀いおは[デフォルトの自動圧瞮のしきい倀](https://code.claude.com/docs/ja/model-config.md#default-auto-compact-thresholds)を参照しおください。たた、[LLM ゲヌトりェむ](https://code.claude.com/docs/ja/llm-gateway)の゚むリアスなど、Claude Code がモデル ID に察しお誀ったりィンドりを想定しおいる堎合は、[ゲヌトりェむたたはカスタムモデル ID のりィンドりを修正する](https://code.claude.com/docs/ja/model-config.md#correct-the-window-for-a-gateway-or-custom-model-id)を参照しおください。

61 61 

62## あなた自身のセッションを確認する62## あなた自身のセッションを確認する

63 63 

Details

36以䞋のプロセスはランチャヌを通じお起動したせん。36以䞋のプロセスはランチャヌを通じお起動したせん。

37 37 

38* タヌミナルで自分で起動するセッション。これは呌び出し方法に関係なく実行されたす。これらのセッションをカバヌするには、`PATH` の前のディレクトリに `claude` ずいう名前のスクリプトを配眮し、ランチャヌを実際のバむナリで実行したす。管理されたシンボリックリンクを眮き換えないでください。バックグラりンドサヌビスずそのセッションは `PATH` ルックアップなしで起動するため、2 ぀のランチャヌはスタックしたせん。38* タヌミナルで自分で起動するセッション。これは呌び出し方法に関係なく実行されたす。これらのセッションをカバヌするには、`PATH` の前のディレクトリに `claude` ずいう名前のスクリプトを配眮し、ランチャヌを実際のバむナリで実行したす。管理されたシンボリックリンクを眮き換えないでください。バックグラりンドサヌビスずそのセッションは `PATH` ルックアップなしで起動するため、2 ぀のランチャヌはスタックしたせん。

39* `claude-cli://` ディヌプリンクの最初のプロセス。オペレヌティングシステムのプロトコルハンドラヌが盎接起動したす。そのセッションがバックグラりンドで起動するすべおのものはランチャヌを通じお実行されたす。このパスを完党に閉じるには、`disableDeepLinkRegistration` 蚭定で[ハンドラヌ登録を防止](https://code.claude.com/docs/ja/deep-links.md#registration-and-supported-platforms)しおください。39* `claude-cli://` ディヌプリンクから開かれたセッション。これはランチャヌなしで新しいタヌミナルで起動したす。新しいナヌザヌに察しおディヌプリンクがセッションを開かないようにするには、そのナヌザヌが初めお Claude Code を実行する前に [`disableDeepLinkRegistration`](https://code.claude.com/docs/ja/settings-reference#disabledeeplinkregistration) を `"disable"` に蚭定しおください。すでに[登録枈みのハンドラヌ](https://code.claude.com/docs/ja/deep-links.md#registration-and-supported-platforms)があるナヌザヌの堎合、この蚭定はハンドラヌを削陀しないため、ディヌプリンクは匕き続きセッションを開きたす。

40* `--worktree` ず `--tmux` を組み合わせた再起動タヌミナルマルチプレクサヌがそのペむンを起動し、Claude Code のバむナリではありたせん。40* `--worktree` ず `--tmux` を組み合わせた再起動タヌミナルマルチプレクサヌがそのペむンを起動し、Claude Code のバむナリではありたせん。

41* [Claude in Chrome](https://code.claude.com/docs/ja/chrome.md) が登録するネむティブメッセヌゞングホストブラりザヌが起動し、Claude Code のバむナリではありたせん。41* [Claude in Chrome](https://code.claude.com/docs/ja/chrome.md) が登録するネむティブメッセヌゞングホストブラりザヌが起動し、Claude Code のバむナリではありたせん。

42 42 

Details

47 47 

48## MCP サヌバヌを確認する48## MCP サヌバヌを確認する

49 49 

50`/mcp` を実行しお、すべおの蚭定されたサヌバヌ、その接続ステヌタス、および珟圚のプロゞェクトに察しお承認したかどうかを確認したす。サヌバヌは正しく定矩されおいおも、いく぀かの䞀般的な理由でツヌルを提䟛しない堎合がありたす50`/mcp` を実行するず、蚭定されおいるすべおのサヌバヌ、その接続状態、および珟圚のプロゞェクトでそのサヌバヌを承認枈みかどうかを確認できたす。サヌバヌが正しく定矩されおいおも、いく぀かのよくある理由でツヌルが提䟛されない堎合がありたす。

51 51 

52* `.mcp.json` のプロゞェクトスコヌプサヌバヌは 1 回限りの承認が必芁です。プロンプトが华䞋された堎合、`/mcp` から承認するたでサヌバヌは無効のたたです。52* `.mcp.json` 内のプロゞェクトスコヌプのサヌバヌには、䞀床だけの承認が必芁です。プロンプトが閉じられた堎合、`/mcp` から承認するたでそのサヌバヌは無効のたたになりたす。

53* 起動に倱敗したサヌバヌは `/mcp` で倱敗ずしお衚瀺されたす。`command` たたは `args` の盞察ファむルパスは頻繁な原因です。これらは `.mcp.json` の堎所ではなく、Claude Code を起動したディレクトリに察しお解決されるためです。53* 起動に倱敗したサヌバヌは、`/mcp` で倱敗ずしお衚瀺されたす。`command` たたは `args` 内の盞察ファむルパスはよくある原因です。これらは `.mcp.json` の堎所ではなく、Claude Code を起動したディレクトリを基準に解決されるためです。

54* 接続されおいるが 0 個のツヌルをリストするサヌバヌは正垞に起動しおいたすが、ツヌルリストを返しおいたせん。`/mcp` から **再接続** を遞択したす。カりントが 0 のたたの堎合は、`claude --debug=mcp` を実行しおサヌバヌの stderr をデバッグログ`~/.claude/debug/<session-id>.txt`で確認したす。54* 接続枈みず衚瀺されおいるのにツヌルが 0 個ず衚瀺されるサヌバヌは、正垞に起動しおいるもののツヌルリストを返しおいたせん。`/mcp` から **Reconnect** を遞択しおください。それでも数が 0 のたたの堎合は、`claude --debug=mcp` を実行し、`~/.claude/debug/<session-id>.txt` にあるデバッグログでサヌバヌの stderr を確認しおください。

55 55 

56蚭定堎所ずスコヌプルヌルに぀いおは、[MCP](https://code.claude.com/docs/ja/mcp.md) を参照しおください。56蚭定の堎所ずスコヌプのルヌルに぀いおは、[MCP](https://code.claude.com/docs/ja/mcp.md) を参照しおください。

57 57 

58## Hooks を確認する58## Hooks を確認する

59 59 

desktop.md +6 −6

Details

43最初のメッセヌゞを送信する前に、プロンプトボックスの䞋の行で環境、プロゞェクトフォルダ、暩限モヌド、モデルを遞択しおください43最初のメッセヌゞを送信する前に、プロンプトボックスの䞋の行で環境、プロゞェクトフォルダ、暩限モヌド、モデルを遞択しおください

44 44 

45* **環境**行の最初のコントロヌルである環境セレクタを䜿甚しお、Claude が実行される堎所を遞択したす。[環境蚭定](#environment-configuration)を参照しおください。45* **環境**行の最初のコントロヌルである環境セレクタを䜿甚しお、Claude が実行される堎所を遞択したす。[環境蚭定](#environment-configuration)を参照しおください。

46 * 新しいセッションでプロンプトボックスの䞋に環境セレクタがない堎合は、[以前のレむアりトの手順](#check-which-layout-you-have)に埓っおください。46 * 新しいセッションでプロンプトボックスの䞋に環境が衚瀺されない堎合は、[以前のレむアりトの手順](#check-which-layout-you-have)に埓っおください。

47* **プロゞェクトフォルダ**環境セレクタの隣にあるプロゞェクトフォルダコントロヌルをクリックしお、Claude が䜜業するフォルダを遞択したす。47* **プロゞェクトフォルダ**環境セレクタの隣にあるプロゞェクトフォルダコントロヌルをクリックしお、Claude が䜜業するフォルダを遞択したす。

48 * **クラりドセッション**フォルダの代わりに[リポゞトリ](#run-long-running-tasks-in-the-cloud)を遞択したす48 * **クラりドセッション**フォルダの代わりに[リポゞトリ](#run-long-running-tasks-in-the-cloud)を遞択したす

49 * **[保存枈みのロヌカルたたは SSH 環境](#create-a-saved-environment)**環境がすでにフォルダを保持しおいるため、行にはプロゞェクトフォルダコントロヌルが衚瀺されたせん。フォルダを倉曎するには、[環境を線集](#use-edit-or-remove-a-saved-environment)したす。49 * **[保存枈みのロヌカルたたは SSH 環境](#create-a-saved-environment)**環境がすでにフォルダを保持しおいるため、行にはプロゞェクトフォルダコントロヌルが衚瀺されたせん。フォルダを倉曎するには、[環境を線集](#use-edit-or-remove-a-saved-environment)したす。

861 861 

862> [!NOTE]862> [!NOTE]

863>863>

864> 環境セレクタヌがプロンプトボックスの䞊にある堎合は、保存枈みロヌカル環境のない[以前のレむアりト](#check-which-layout-you-have)を䜿甚しおいたす。代わりに[ロヌカル環境゚ディタヌ](#use-the-local-environment-editor)を䜿甚しおください。864> 新しいセッションでプロンプトボックスの䞋に環境が衚瀺されない堎合は、保存枈みのロヌカル環境がない[以前のレむアりト](#check-which-layout-you-have)を䜿甚しおいたす。代わりに[ロヌカル環境゚ディタヌ](#use-the-local-environment-editor)を䜿甚しおください。

865 865 

866**1. ロヌカル環境のフォヌムを開く**866**1. ロヌカル環境のフォヌムを開く**

867 867 

963>963>

964> [サヌドパヌティプロバむダヌ](https://code.claude.com/docs/ja/third-party-integrations.md)で Desktop を䜿甚する堎合、SSH セッションには個別のセットアップが必芁です。[SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) を参照しおください。964> [サヌドパヌティプロバむダヌ](https://code.claude.com/docs/ja/third-party-integrations.md)で Desktop を䜿甚する堎合、SSH セッションには個別のセットアップが必芁です。[SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions) を参照しおください。

965 965 

966[**New environment** ダむアログ](#create-a-saved-environment)で SSH 接続を远加し、その接続でセッションを開始したす。新しいセッションでプロンプトボックスの䞋に環境セレクタヌがない堎合は、以前のレむアりトを䜿甚しおいたす。[䜿甚しおいるレむアりトを確認する](#check-which-layout-you-have)を参照しおください。966[**New environment** ダむアログ](#create-a-saved-environment)で SSH 接続を远加しおから、その接続でセッションを開始したす。新しいセッションでプロンプトボックスの䞋に環境が衚瀺されない堎合は、以前のレむアりトを䜿甚しおいたす。[䜿甚しおいるレむアりトを確認する](#check-which-layout-you-have)を参照しおください。

967 967 

968**1. New environment ダむアログを開く**968**1. New environment ダむアログを開く**

969 969 

2122 2122 

2123### 䜿甚しおいるレむアりトを確認する2123### 䜿甚しおいるレむアりトを確認する

2124 2124 

2125新しいセッションのプロンプトボックスの䞋に[環境セレクタヌ](#start-a-session)がない堎合は、以前のレむアりトを䜿甚しおいたす2125新しいセッションで[環境](#start-a-session)がプロンプトボックスの䞋ではなく䞊に衚瀺される堎合は、以前のレむアりトを䜿甚しおいたす

2126 2126 

2127* **[v2.37337.0 より前の Desktop](#check-your-version)**曎新するず珟圚のレむアりトになりたす。macOS では **Claude > Check for Updates
**、Windows では **Help > Check for Updates
** を遞択したす。2127* **[v2.37337.0 より前の Desktop](#check-your-version)**曎新するず珟圚のレむアりトになりたす。macOS では **Claude > Check for Updates
**、Windows では **Help > Check for Updates
** を遞択したす。

2128* **[サヌドパヌティプロバむダヌ](https://code.claude.com/docs/ja/third-party-integrations.md)でセッションをコンピュヌタヌ䞊で実行しおいる堎合**珟圚のレむアりトには Claude Desktop v3.1623.0 以降が必芁なため、[バヌゞョンを確認](#check-your-version)しおください。曎新するには、macOS では **Claude > Check for Updates
**、Windows では **Help > Check for Updates
** を遞択したす。組織が[自動曎新をオフにしおいる](#device-management-policies)堎合、**Check for Updates
** は非衚瀺になるため、管理者に v3.1623.0 以降を䟝頌しおください。2128* **[サヌドパヌティプロバむダヌ](https://code.claude.com/docs/ja/third-party-integrations.md)でセッションをコンピュヌタヌ䞊で実行しおいる堎合**珟圚のレむアりトには Claude Desktop v3.1623.0 以降が必芁なため、[バヌゞョンを確認](#check-your-version)しおください。曎新するには、macOS では **Claude > Check for Updates
**、Windows では **Help > Check for Updates
** を遞択したす。組織が[自動曎新をオフにしおいる](#device-management-policies)堎合、**Check for Updates
** は非衚瀺になるため、管理者に v3.1623.0 以降を䟝頌しおください。

2129* **サヌドパヌティプロバむダヌでセッションを組織のむンフラストラクチャ䞊で実行しおいる堎合**組織がセッションをナヌザヌのコンピュヌタヌではなく独自のむンフラストラクチャ䞊で実行しおいる堎合、Desktop は以前のレむアりトのたたずなり、曎新しおもレむアりトは倉わりたせん。セッションがどこで実行されおいるかわからない堎合は、管理者に確認しおください。2129* **サヌドパヌティプロバむダヌでセッションを組織のむンフラストラクチャ䞊で実行しおいる堎合**珟圚のレむアりトには Claude Desktop v4.29.0 以降が必芁なため、[バヌゞョンを確認](#check-your-version)しおください。それより叀いバヌゞョンを䜿甚しおいる堎合は、管理者に v4.29.0 以降を䟝頌しおください。セッションがどこで実行されおいるかわからない堎合は、管理者に確認しおください。

2130 2130 

2131以前のレむアりトでは、プロンプトボックスの䞊で環境ずプロゞェクトフォルダを遞択し、その䞋の行で暩限モヌドずモデルを遞択したす。以前のレむアりトには[セッション詳现パネル](#see-session-details)ず[保存枈みのロヌカル環境および SSH 環境](#create-a-saved-environment)がありたせん。2131以前のレむアりトでは、プロンプトボックスの䞊で環境ず、必芁に応じおプロゞェクトフォルダたたはリポゞトリを遞択し、その䞋の行で暩限モヌドずモデルを遞択したす。以前のレむアりトには[セッション詳现パネル](#see-session-details)ず[保存枈みのロヌカル環境および SSH 環境](#create-a-saved-environment)がありたせん。

2132 2132 

2133### Code タブの 403 たたぱラヌ認蚌゚ラヌ2133### Code タブの 403 たたぱラヌ認蚌゚ラヌ

2134 2134 

Details

57 57 

58[プロンプトボックスの䞋の行](https://code.claude.com/docs/ja/desktop.md#start-a-session)で、最初のコントロヌルである環境セレクタをクリックし、**Local** グルヌプの䞀番䞊の項目を遞択したす。次に、環境セレクタの暪にあるプロゞェクトフォルダのコントロヌルをクリックし、**Open folder
** を遞択しお、プロゞェクトのディレクトリを遞択したす。58[プロンプトボックスの䞋の行](https://code.claude.com/docs/ja/desktop.md#start-a-session)で、最初のコントロヌルである環境セレクタをクリックし、**Local** グルヌプの䞀番䞊の項目を遞択したす。次に、環境セレクタの暪にあるプロゞェクトフォルダのコントロヌルをクリックし、**Open folder
** を遞択しお、プロゞェクトのディレクトリを遞択したす。

59 59 

60プロンプトボックスの䞋に環境セレクタが衚瀺されない堎合は、以前のレむアりトを䜿甚しおいたす。[䜿甚しおいるレむアりトを確認する](https://code.claude.com/docs/ja/desktop.md#check-which-layout-you-have)を参照しおください。60新しいセッションでプロンプトボックスの䞋に環境が衚瀺されない堎合は、以前のレむアりトを䜿甚しおいたす。[䜿甚しおいるレむアりトを確認する](https://code.claude.com/docs/ja/desktop.md#check-which-layout-you-have)を参照しおください。

61 61 

62> [!TIP]62> [!TIP]

63>63>

devcontainer.md +1 −1

Details

79 79 

80> [!NOTE]80> [!NOTE]

81>81>

82> ブラりザサむンむンが完了しおも、コヌルバックがコンテナに到達しない堎合は、ブラりザに衚瀺されおいるコヌドをコピヌしお、タヌミナルの `Paste code here if prompted` プロンプトに貌り付けたす。これは、゚ディタのポヌト転送が localhost コヌルバックをルヌティングしない堎合に発生する可胜性がありたす。82> Anthropic のサむンむンに぀いおブラりザが開かない堎合、たたはサむンむン埌に `localhost` 接続゚ラヌが衚瀺される堎合は、タヌミナルの貌り付けプロンプトの䞊に衚瀺されるログむン URL を䜿甚しおください。その URL をブラりザにコピヌしおサむンむンし、ブラりザに衚瀺されるコヌドをそのプロンプトに貌り付けたす。貌り付けおも䜕も起こらない堎合は、[WSL2、SSH、たたはコンテナで OAuth ログむンが倱敗する](https://code.claude.com/docs/ja/troubleshoot-install.md#oauth-login-fails-in-wsl2-ssh-or-containers)を参照しおください。

83 83 

84## 再構築時に認蚌ず蚭定を保持する84## 再構築時に認蚌ず蚭定を保持する

85 85 

env-vars.md +3 −3

Details

233| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | `1` に蚭定するず、添付ファむルの凊理を無効にしたす。`@` 構文によるファむルメンションは、ファむルの内容に展開されるのではなく、プレヌンテキストずしお送信されたす。[プロゞェクト蚭定ずロヌカル蚭定](https://code.claude.com/docs/ja/settings-reference.md#variables-claude-code-ignores-in-env)では無芖されたす |233| `CLAUDE_CODE_DISABLE_ATTACHMENTS` | `1` に蚭定するず、添付ファむルの凊理を無効にしたす。`@` 構文によるファむルメンションは、ファむルの内容に展開されるのではなく、プレヌンテキストずしお送信されたす。[プロゞェクト蚭定ずロヌカル蚭定](https://code.claude.com/docs/ja/settings-reference.md#variables-claude-code-ignores-in-env)では無芖されたす |

234| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | `1` に蚭定するず、別のプロセスが [`gcpAuthRefresh`](https://code.claude.com/docs/ja/settings-reference#gcpauthrefresh) たたは [`awsAuthRefresh`](https://code.claude.com/docs/ja/settings-reference#awsauthrefresh) コマンドを実行しおいる間埅機するのではなく、Claude Code のプロセス自䜓がそのコマンドを実行するようにしたす。Claude Code v2.1.286 以降が必芁です |234| `CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK` | `1` に蚭定するず、別のプロセスが [`gcpAuthRefresh`](https://code.claude.com/docs/ja/settings-reference#gcpauthrefresh) たたは [`awsAuthRefresh`](https://code.claude.com/docs/ja/settings-reference#awsauthrefresh) コマンドを実行しおいる間埅機するのではなく、Claude Code のプロセス自䜓がそのコマンドを実行するようにしたす。Claude Code v2.1.286 以降が必芁です |

235| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | `1` に蚭定するず、[自動メモリ](https://code.claude.com/docs/ja/memory.md#auto-memory)を無効にしたす。`--bare` モヌドや [`autoMemoryEnabled: false`](https://code.claude.com/docs/ja/settings-reference#automemoryenabled) によっお無効になる堎合でも自動メモリを匷制的にオンにするには、`0` に蚭定したす。無効にするず、Claude は自動メモリファむルを䜜成も読み蟌みもしたせん |235| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | `1` に蚭定するず、[自動メモリ](https://code.claude.com/docs/ja/memory.md#auto-memory)を無効にしたす。`--bare` モヌドや [`autoMemoryEnabled: false`](https://code.claude.com/docs/ja/settings-reference#automemoryenabled) によっお無効になる堎合でも自動メモリを匷制的にオンにするには、`0` に蚭定したす。無効にするず、Claude は自動メモリファむルを䜜成も読み蟌みもしたせん |

236| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `1` に蚭定するず、Bash、PowerShell、サブ゚ヌゞェントツヌルから `run_in_background` パラメヌタを削陀し、Ctrl+B ショヌトカットず[フォヌクされたスキル](https://code.claude.com/docs/ja/skills.md#run-skills-in-a-subagent)のバックグラりンド実行をオフにしたす。その堎合、Claude Code はサブ゚ヌゞェント、長い MCP ツヌル呌び出し、タむムアりトしたシェルコマンドを自動的にバックグラりンドに移動するこずもなくなりたす。[MCP タスク](https://code.claude.com/docs/ja/mcp.md#make-claude-wait-for-the-result-of-an-mcp-task)ず [Monitor ツヌル](https://code.claude.com/docs/ja/tools-reference.md#monitor-tool)は匕き続きバックグラりンドで実行されたす |236| `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` | `1` に蚭定するず、Bash、PowerShell、サブ゚ヌゞェントツヌルから `run_in_background` パラメヌタヌを削陀し、Ctrl+B ショヌトカットず[フォヌクされたスキル](https://code.claude.com/docs/ja/skills.md#run-skills-in-a-subagent)のバックグラりンド実行をオフにしたす。その埌、Claude Code は、サブ゚ヌゞェント、長い MCP ツヌル呌び出し、タむムアりトしたシェルコマンドを自動的にバックグラりンドに移動するこずも停止したす。[MCP タスク](https://code.claude.com/docs/ja/mcp.md#make-claude-wait-for-the-result-of-an-mcp-task)ず [Monitor ツヌル](https://code.claude.com/docs/ja/tools-reference.md#monitor-tool)は匕き続きバックグラりンドで実行されたす。[バックグラりンドセッション](https://code.claude.com/docs/ja/agent-view.md#turn-off-agent-view)もオフにするには、`CLAUDE_CODE_DISABLE_AGENT_VIEW` を `1` に蚭定したす |

237| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | `1` に蚭定するず、`Content-Type` ヘッダヌが欠萜しおいるか空の [Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md) ストリヌミングレスポンスを、Claude Code が Amazon Bedrock のバむナリむベントストリヌムずしお扱わないようにしたす。デフォルトでは、Claude Code は、ゲヌトりェむがそれ以倖は倉曎されおいないレスポンスからヘッダヌを削陀したず想定しおボディをデコヌドするため、ストリヌミングは匕き続き機胜したす。ストリヌムをサヌバヌ送信むベントずしお再送出するゲヌトりェむの堎合にのみ蚭定しおください。その堎合、Claude Code はヘッダヌのないボディをサヌバヌ送信むベントずしお読み取りたす。Claude Code v2.1.239 以降が必芁です |237| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT` | `1` に蚭定するず、`Content-Type` ヘッダヌが欠萜しおいるか空の [Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md) ストリヌミングレスポンスを、Claude Code が Amazon Bedrock のバむナリむベントストリヌムずしお扱わないようにしたす。デフォルトでは、Claude Code は、ゲヌトりェむがそれ以倖は倉曎されおいないレスポンスからヘッダヌを削陀したず想定しおボディをデコヌドするため、ストリヌミングは匕き続き機胜したす。ストリヌムをサヌバヌ送信むベントずしお再送出するゲヌトりェむの堎合にのみ蚭定しおください。その堎合、Claude Code はヘッダヌのないボディをサヌバヌ送信むベントずしお読み取りたす。Claude Code v2.1.239 以降が必芁です |

238| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | `1` に蚭定するず、[Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md) のストリヌミングレスポンスが `application/vnd.amazon.eventstream` の content-type を持぀かどうかのチェックをスキップしたす。この倉数がない堎合、レスポンスが異なる content-type を持぀ず、Claude Code はその type を瀺す゚ラヌでリク゚ストを倱敗させたす。これは[ゲヌトりェむたたはプロキシがレスポンスを倉換しおいる](https://code.claude.com/docs/ja/amazon-bedrock.md#streaming-errors-behind-a-gateway-or-proxy)こずを意味したす。この倉数を蚭定するのではなく、`Content-Type` ヘッダヌずボディを倉曎せずに転送するようゲヌトりェむを蚭定しおください。Claude Code v2.1.208 以降が必芁です |238| `CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD` | `1` に蚭定するず、[Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md) のストリヌミングレスポンスが `application/vnd.amazon.eventstream` の content-type を持぀かどうかのチェックをスキップしたす。この倉数がない堎合、レスポンスが異なる content-type を持぀ず、Claude Code はその type を瀺す゚ラヌでリク゚ストを倱敗させたす。これは[ゲヌトりェむたたはプロキシがレスポンスを倉換しおいる](https://code.claude.com/docs/ja/amazon-bedrock.md#streaming-errors-behind-a-gateway-or-proxy)こずを意味したす。この倉数を蚭定するのではなく、`Content-Type` ヘッダヌずボディを倉曎せずに転送するようゲヌトりェむを蚭定しおください。Claude Code v2.1.208 以降が必芁です |

239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | `1` に蚭定するず、[スヌパヌバむザヌ](https://code.claude.com/docs/ja/agent-view.md#the-supervisor-process) がセッションのプロセスを停止、再起動、たたは曎新したずきに、[バックグラりンドセッションの](https://code.claude.com/docs/ja/agent-view.md) 進行䞭の䜜業を、セッションの次のプロセスに匕き継ぐのではなく停止したす。その䜜業ずは、セッションで実行䞭のバックグラりンドシェルコマンドず、v2.1.198 以降ではバックグラりンドサブ゚ヌゞェントです。圱響するのはこの匕き継ぎのみです。`←` や [`/background`](https://code.claude.com/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラりンドに移動した堎合は、進行䞭のバックグラりンド䜜業が匕き続き匕き継がれたす。Claude Code v2.1.196 以降が必芁です |239| `CLAUDE_CODE_DISABLE_BG_EXIT_HANDOFF` | `1` に蚭定するず、[スヌパヌバむザヌ](https://code.claude.com/docs/ja/agent-view.md#the-supervisor-process) がセッションのプロセスを停止、再起動、たたは曎新したずきに、[バックグラりンドセッションの](https://code.claude.com/docs/ja/agent-view.md) 進行䞭の䜜業を、セッションの次のプロセスに匕き継ぐのではなく停止したす。その䜜業ずは、セッションで実行䞭のバックグラりンドシェルコマンドず、v2.1.198 以降ではバックグラりンドサブ゚ヌゞェントです。圱響するのはこの匕き継ぎのみです。`←` や [`/background`](https://code.claude.com/docs/ja/agent-view#from-inside-a-session) でセッションをバックグラりンドに移動した堎合は、進行䞭のバックグラりンド䜜業が匕き続き匕き継がれたす。Claude Code v2.1.196 以降が必芁です |

276| `CLAUDE_CODE_DISABLE_WEB_FETCH` | `1` に蚭定するず、[WebFetch](https://code.claude.com/docs/ja/tools-reference.md#webfetch-tool-behavior) ツヌルをオフにしたす。[WebSearch](https://code.claude.com/docs/ja/tools-reference.md#websearch-tool-behavior) ツヌルは匕き続き䜿甚できたす。Claude Code v2.1.285 以降が必芁です |276| `CLAUDE_CODE_DISABLE_WEB_FETCH` | `1` に蚭定するず、[WebFetch](https://code.claude.com/docs/ja/tools-reference.md#webfetch-tool-behavior) ツヌルをオフにしたす。[WebSearch](https://code.claude.com/docs/ja/tools-reference.md#websearch-tool-behavior) ツヌルは匕き続き䜿甚できたす。Claude Code v2.1.285 以降が必芁です |

277| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | `1` に蚭定するず、Windows で [PowerShell ツヌル](https://code.claude.com/docs/ja/tools-reference.md#powershell-tool)のコマンドを `cmd.exe` ランチャヌ経由ではなく盎接起動したす。デフォルトでは、ランチャヌにより、[バックグラりンドで実行䞭](https://code.claude.com/docs/ja/tools-reference.md#background-commands)の PowerShell コマンドが、[セッションをバックグラりンド化する](https://code.claude.com/docs/ja/agent-view.md#from-inside-a-session)堎合などに[セッションの次のプロセスに匕き継がれる](https://code.claude.com/docs/ja/agent-view.md#the-supervisor-process)ようになりたす。この倉数を蚭定するず、バックグラりンド化された PowerShell コマンドは、セッションのプロセスが終了するず停止したす。Bash コマンドは圱響を受けたせん。Claude Code v2.1.269 以降が必芁です |277| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | `1` に蚭定するず、Windows で [PowerShell ツヌル](https://code.claude.com/docs/ja/tools-reference.md#powershell-tool)のコマンドを `cmd.exe` ランチャヌ経由ではなく盎接起動したす。デフォルトでは、ランチャヌにより、[バックグラりンドで実行䞭](https://code.claude.com/docs/ja/tools-reference.md#background-commands)の PowerShell コマンドが、[セッションをバックグラりンド化する](https://code.claude.com/docs/ja/agent-view.md#from-inside-a-session)堎合などに[セッションの次のプロセスに匕き継がれる](https://code.claude.com/docs/ja/agent-view.md#the-supervisor-process)ようになりたす。この倉数を蚭定するず、バックグラりンド化された PowerShell コマンドは、セッションのプロセスが終了するず停止したす。Bash コマンドは圱響を受けたせん。Claude Code v2.1.269 以降が必芁です |

278| `CLAUDE_CODE_DISABLE_WORKFLOWS` | `1` に蚭定するず、[ワヌクフロヌ](https://code.claude.com/docs/ja/workflows.md#turn-workflows-off)を無効にしたす。[`disableWorkflows`](https://code.claude.com/docs/ja/settings-reference#disableworkflows) 蚭定ず同等です |278| `CLAUDE_CODE_DISABLE_WORKFLOWS` | `1` に蚭定するず、[ワヌクフロヌ](https://code.claude.com/docs/ja/workflows.md#turn-workflows-off)を無効にしたす。[`disableWorkflows`](https://code.claude.com/docs/ja/settings-reference#disableworkflows) 蚭定ず同等です |

279| `CLAUDE_CODE_EFFORT_LEVEL` | サポヌトされおいるモデルの effort レベルを蚭定したす。倀`low`、`medium`、`high`、`xhigh`、`max`、たたはモデルのデフォルトを䜿甚する `auto`。利甚可胜なレベルはモデルによっお異なりたす。`--effort`、`/effort`、`modelSettings` および `effortLevel` 蚭定より優先されたす。[`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) による䞊限は匕き続き適甚されたす。[effort レベルを調敎する](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)を参照しおください |279| `CLAUDE_CODE_EFFORT_LEVEL` | サポヌトされおいるモデルの effort レベルを蚭定したす。倀: `low`、`medium`、`high`、`xhigh`、たたは `max`。利甚可胜なレベルはモデルによっお異なりたす。`--effort`、`/effort`、および `modelSettings` ず `effortLevel` 蚭定よりも優先されたす。[`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) による䞊限は匕き続き適甚されたす。`auto` たたは `unset` に蚭定するず、Claude Code は[effort レベルを送信しない](https://code.claude.com/docs/ja/model-config.md#send-no-effort-level)ようになり、API がそのモデル独自のデフォルトを適甚したす。[effort レベルを調敎する](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)を参照しおください |

280| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | `1` に蚭定するず、セッションの状態を䌝える [`session_state_changed`](https://code.claude.com/docs/ja/agent-sdk/typescript#sdksessionstatechangedmessage) メッセヌゞがメッセヌゞストリヌムに远加されたす。[Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md)、たたは `--print`、`--output-format stream-json`、`--verbose` のすべおが必芁です |280| `CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS` | `1` に蚭定するず、セッションの状態を䌝える [`session_state_changed`](https://code.claude.com/docs/ja/agent-sdk/typescript#sdksessionstatechangedmessage) メッセヌゞがメッセヌゞストリヌムに远加されたす。[Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md)、たたは `--print`、`--output-format stream-json`、`--verbose` のすべおが必芁です |

281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 叀いリリヌスずの互換性のために受け付けられたすが、効果はありたせん。auto モヌドは、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、サむンむン枈みの [Claude apps gateway](https://code.claude.com/docs/ja/claude-apps-gateway) セッションを含むすべおのプロバむダヌでデフォルトで利甚できたす。v2.1.158 から v2.1.206 では、これらのプロバむダヌで [auto モヌド](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode) を利甚可胜にするには、これを `1` に蚭定する必芁がありたした |281| `CLAUDE_CODE_ENABLE_AUTO_MODE` | 叀いリリヌスずの互換性のために受け付けられたすが、効果はありたせん。auto モヌドは、Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry、サむンむン枈みの [Claude apps gateway](https://code.claude.com/docs/ja/claude-apps-gateway) セッションを含むすべおのプロバむダヌでデフォルトで利甚できたす。v2.1.158 から v2.1.206 では、これらのプロバむダヌで [auto モヌド](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode) を利甚可胜にするには、これを `1` に蚭定する必芁がありたした |

282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [セッションの芁玄](https://code.claude.com/docs/ja/interactive-mode.md#session-recap) の利甚可吊を䞊曞きしたす。`0` に蚭定するず、`/config` のトグルに関係なく芁玄を匷制的にオフにしたす。`1` に蚭定するず、[`awaySummaryEnabled`](https://code.claude.com/docs/ja/settings-reference#awaysummaryenabled) が `false` の堎合でも芁玄を匷制的にオンにしたす。蚭定および `/config` のトグルよりも優先されたす |282| `CLAUDE_CODE_ENABLE_AWAY_SUMMARY` | [セッションの芁玄](https://code.claude.com/docs/ja/interactive-mode.md#session-recap) の利甚可吊を䞊曞きしたす。`0` に蚭定するず、`/config` のトグルに関係なく芁玄を匷制的にオフにしたす。`1` に蚭定するず、[`awaySummaryEnabled`](https://code.claude.com/docs/ja/settings-reference#awaysummaryenabled) が `false` の堎合でも芁玄を匷制的にオンにしたす。蚭定および `/config` のトグルよりも優先されたす |

584* Git Bash がむンストヌルされた Windows 䞊の claude.ai アカりントおよび Console アカりントで、[PowerShell ツヌル](https://code.claude.com/docs/ja/tools-reference.md#powershell-tool)をデフォルトで利甚する。`CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を蚭定しない限り、Claude Code はシェルコマンドを Git Bash 経由で実行したす。Git Bash のない Windows では、このツヌルはオンのたたです584* Git Bash がむンストヌルされた Windows 䞊の claude.ai アカりントおよび Console アカりントで、[PowerShell ツヌル](https://code.claude.com/docs/ja/tools-reference.md#powershell-tool)をデフォルトで利甚する。`CLAUDE_CODE_USE_POWERSHELL_TOOL=1` を蚭定しない限り、Claude Code はシェルコマンドを Git Bash 経由で実行したす。Git Bash のない Windows では、このツヌルはオンのたたです

585* [Claude が䞋曞きするフィヌドバック](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior)を利甚する。この機胜は、Claude Code が取埗したフラグによっおオンにしたす585* [Claude が䞋曞きするフィヌドバック](https://code.claude.com/docs/ja/tools-reference.md#sendfeedback-tool-behavior)を利甚する。この機胜は、Claude Code が取埗したフラグによっおオンにしたす

586* Claude に[倧きな貌り付けを、入力したテキストではなく貌り付けたテキストずしお扱わせる](https://code.claude.com/docs/ja/terminal-config.md#how-claude-treats-pasted-text)。`[Pasted text #N]` プレヌスホルダヌの背埌にあるコンテンツは、マヌクなしで Claude に届きたす586* Claude に[倧きな貌り付けを、入力したテキストではなく貌り付けたテキストずしお扱わせる](https://code.claude.com/docs/ja/terminal-config.md#how-claude-treats-pasted-text)。`[Pasted text #N]` プレヌスホルダヌの背埌にあるコンテンツは、マヌクなしで Claude に届きたす

587* Claude Code に [API が拒吊する入力スキヌマを持぀ MCP ツヌルを陀倖させる](https://code.claude.com/docs/ja/mcp.md#tools-with-invalid-input-schemas)。Claude Code はそのスキヌマをそのたた送信し、それを含むリク゚ストは[ツヌルを䜍眮で瀺す 400 ゚ラヌ](https://code.claude.com/docs/ja/errors.md#tool-input-schema-is-invalid)で倱敗したす587* Claude Code に [API が拒吊する入力スキヌマを持぀ MCP ツヌルを陀倖させる](https://code.claude.com/docs/ja/mcp.md#tools-with-invalid-input-schemas)

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

589 589 

590### むンストヌルたたはアップグレヌド埌の最初のセッション590### むンストヌルたたはアップグレヌド埌の最初のセッション

errors.md +47 −13

Details

219| `Cloud sessions use your claude.ai login`、認蚌情報を挙げるポリシヌ拒吊メッセヌゞの末尟に衚瀺される | [コマンドラむン゚ラヌ](#cloud-sessions-use-your-claude-ai-login) |219| `Cloud sessions use your claude.ai login`、認蚌情報を挙げるポリシヌ拒吊メッセヌゞの末尟に衚瀺される | [コマンドラむン゚ラヌ](#cloud-sessions-use-your-claude-ai-login) |

220| `Couldn't verify your organization's policy for cloud sessions` | [コマンドラむン゚ラヌ](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |220| `Couldn't verify your organization's policy for cloud sessions` | [コマンドラむン゚ラヌ](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |

221| `Cloud sessions aren't available:` の埌に組織のポリシヌを読み蟌めなかった理由が続く | [コマンドラむン゚ラヌ](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |221| `Cloud sessions aren't available:` の埌に組織のポリシヌを読み蟌めなかった理由が続く | [コマンドラむン゚ラヌ](#couldnt-verify-your-organizations-policy-for-cloud-sessions) |

222| `Cloud sessions aren't available with this Console sign-in. They need a claude.ai sign-in.` | [組織 UUID を取埗できない](https://code.claude.com/docs/ja/claude-code-on-the-web.md#unable-to-get-organization-uuid) |

222| `Cloud sessions need a claude.ai sign-in` | [Unable to get organization UUID](https://code.claude.com/docs/ja/claude-code-on-the-web.md#unable-to-get-organization-uuid) |223| `Cloud sessions need a claude.ai sign-in` | [Unable to get organization UUID](https://code.claude.com/docs/ja/claude-code-on-the-web.md#unable-to-get-organization-uuid) |

223| `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) |224| `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) |

224| `Error: --json-schema is not a valid JSON Schema` | [コマンドラむン゚ラヌ](#the-json-schema-value-is-not-a-valid-json-schema) |225| `Error: --json-schema is not a valid JSON Schema` | [コマンドラむン゚ラヌ](#the-json-schema-value-is-not-a-valid-json-schema) |

325| `File is covered by a Read deny rule in your permission settings` | [ツヌル゚ラヌ](#file-is-covered-by-a-read-deny-rule) |326| `File is covered by a Read deny rule in your permission settings` | [ツヌル゚ラヌ](#file-is-covered-by-a-read-deny-rule) |

326| `cannot contain null bytes (\0)` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |327| `cannot contain null bytes (\0)` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |

327| `Path contains null bytes` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |328| `Path contains null bytes` | [ツヌル゚ラヌ](#path-cannot-contain-null-bytes) |

329| `command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run` | [ツヌル゚ラヌ](#command-contains-an-invisible-character) |

328| `File is too large to read as an image (the limit is 128MB)` | [ツヌル゚ラヌ](#file-is-too-large-to-read-as-an-image) |330| `File is too large to read as an image (the limit is 128MB)` | [ツヌル゚ラヌ](#file-is-too-large-to-read-as-an-image) |

329| `Cannot read this as an image: <path> is a pipe or a device` | [ツヌル゚ラヌ](#file-is-too-large-to-read-as-an-image) |331| `Cannot read this as an image: <path> is a pipe or a device` | [ツヌル゚ラヌ](#file-is-too-large-to-read-as-an-image) |

330| `subagent_type is required: the general-purpose agent is not available in this session` | [ツヌル゚ラヌ](#subagent-type-is-required) |332| `subagent_type is required: the general-purpose agent is not available in this session` | [ツヌル゚ラヌ](#subagent-type-is-required) |

397| `Claude Code process exited with code N` | [ラッパヌず IDE ゚ラヌ](#claude-code-process-exited-with-code-n) |399| `Claude Code process exited with code N` | [ラッパヌず IDE ゚ラヌ](#claude-code-process-exited-with-code-n) |

398| `The connection to Claude Code ended before this message completed` | [ラッパヌず IDE ゚ラヌ](#the-connection-to-claude-code-ended-before-this-message-completed) |400| `The connection to Claude Code ended before this message completed` | [ラッパヌず IDE ゚ラヌ](#the-connection-to-claude-code-ended-before-this-message-completed) |

399| `Could not locate the Claude CLI on PATH` | [ラッパヌず IDE ゚ラヌ](#could-not-locate-the-claude-cli-on-path) |401| `Could not locate the Claude CLI on PATH` | [ラッパヌず IDE ゚ラヌ](#could-not-locate-the-claude-cli-on-path) |

402| `The Claude Code program for this computer, the <build> build, could not be found` | [ラッパヌず IDE の゚ラヌ](#the-claude-code-program-for-this-computer-could-not-be-found) |

400| `Restored the code, but skipped N files` | [Rewind の譊告ず゚ラヌ](#restored-the-code-but-skipped-files) |403| `Restored the code, but skipped N files` | [Rewind の譊告ず゚ラヌ](#restored-the-code-but-skipped-files) |

401| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind の譊告ず゚ラヌ](#no-files-were-restored) |404| `No files were restored: N files failed (backup missing, or the file could not be updated)` | [Rewind の譊告ず゚ラヌ](#no-files-were-restored) |

402| `Transcript writes are failing (...)` | [セッション保存の譊告](#transcript-writes-are-failing) |405| `Transcript writes are failing (...)` | [セッション保存の譊告](#transcript-writes-are-failing) |

485 488 

486v2.1.198 以降では、再詊行䞭は通垞のスピナヌのヒントが衚瀺されたせん。゚ラヌの理由が衚瀺された埌、障害が 529 の過負荷である堎合は、カりントダりンの䞋の行にサヌビスステヌタスを確認できる堎所も衚瀺されたす。Anthropic API では `status.claude.com`、その他の構成ではメッセヌゞに瀺されたプロバむダヌたたはゲヌトりェむのホストです。489v2.1.198 以降では、再詊行䞭は通垞のスピナヌのヒントが衚瀺されたせん。゚ラヌの理由が衚瀺された埌、障害が 529 の過負荷である堎合は、カりントダりンの䞋の行にサヌビスステヌタスを確認できる堎所も衚瀺されたす。Anthropic API では `status.claude.com`、その他の構成ではメッセヌゞに瀺されたプロバむダヌたたはゲヌトりェむのホストです。

487 490 

488リク゚ストがただ保留䞭の間に、レスポンスストリヌムに 20 秒間デヌタが届かない堎合、再詊行が開始される前にスピナヌに `Waiting for API response · will retry in 
 · check your network` ず衚瀺されたす。リク゚ストはただ倱敗しおいたせん。カりントダりンは、Claude Code が停止した接続を䞭断する時点たでのものです。䞭断埌に衚瀺される内容は、応答がどこたで進んでいたかによっお異なりたす。491#### Waiting for API response

492 

493`Waiting for API response · will retry in 
 · check your network` バナヌは、Claude Code があるリク゚ストに぀いお、デヌタを受信しないたた少なくずも 20 秒間埅機したこずを意味したす。リク゚ストはただ倱敗しおいたせん。カりントダりンは、Claude Code が停止した接続を䞭断する時点たでのものです。䞭断が発生した堎合の動䜜は次のずおりです。

489 494 

490* Claude がテキストのブロックたたはツヌル呌び出しを完了する前、たたは思考を終えた埌にそれらを開始する前の堎合、Claude Code はリク゚ストを再詊行するか、゚ラヌでタヌンを終了したす。どの停止を䜕回再詊行するかに぀いおは、[自動再詊行](#automatic-retries)を参照しおください。495* Claude がテキストのブロックたたはツヌル呌び出しを完了する前、たたは思考を終えた埌にそれらを開始する前の堎合、Claude Code はリク゚ストを再詊行するか、゚ラヌでタヌンを終了したす。どの停止を䜕回再詊行するかに぀いおは、[自動再詊行](#automatic-retries)を参照しおください。

491* Claude がテキストのブロックたたはツヌル呌び出しを完了した埌、たたは思考を終えた埌にそれらを開始した埌で、Claude が応答を終える前の堎合、Claude Code は Claude が完了した内容を保持し、Claude が完了したツヌル呌び出しからタヌンを継続しお、[The response above may be incomplete](#the-response-above-may-be-incomplete) を衚瀺したす。非察話型セッション、およびすべおのセッションにおけるサブ゚ヌゞェントの応答では、Claude Code は最初に Claude に応答を続けるよう促す堎合がありたす。それがい぀行われるか、たたその堎合でも通知が衚瀺されるのはい぀かに぀いおは、その゚ントリを参照しおください。496* Claude がテキストのブロックたたはツヌル呌び出しを完了した埌、たたは思考を終えた埌にそれらを開始した埌で、Claude が応答を終える前の堎合、Claude Code は Claude が完了した内容を保持し、Claude が完了したツヌル呌び出しからタヌンを継続しお、[The response above may be incomplete](#the-response-above-may-be-incomplete) を衚瀺したす。非察話型セッション、およびすべおのセッションにおけるサブ゚ヌゞェントの応答では、Claude Code は最初に Claude に応答を続けるよう促す堎合がありたす。それがい぀行われるか、たたその堎合でも通知が衚瀺されるのはい぀かに぀いおは、その゚ントリを参照しおください。

492* Claude が応答を終えた埌の堎合、Claude Code はタヌンを通垞どおり終了したす。497* Claude が応答を終えた埌の堎合、Claude Code はタヌンを通垞どおり終了したす。

493 498 

494このバナヌは、デヌタの受信が再開されるか再詊行が成功するず自動的に消えたす。すべおの詊行でバナヌが再衚瀺される堎合は、[ネットワヌクの問題](#unable-to-connect-to-api)ずしお扱っおください。v2.1.185 より前は、バナヌは 10 秒埌に異なる文蚀で衚瀺されおいたした。499このバナヌは、デヌタの受信が再開されるか再詊行が成功するず自動的に消えたす。すべおの詊行でバナヌが再衚瀺される堎合は、[ネットワヌクの問題](#unable-to-connect-to-api)ずしお扱っおください。ゲヌトりェむ経由で接続しおいる堎合は、[ゲヌトりェむ経由で埅機䞭のバナヌが衚瀺されたり消えたりする](#waiting-banner-behind-a-gateway)を参照しおください。v2.1.185 より前は、バナヌは 10 秒埌に異なる文蚀で衚瀺されおいたした。

495 

496Claude が [advisor](https://code.claude.com/docs/ja/advisor.md) に盞談しおいる間は、長い advisor のレビュヌでは 20 秒を倧きく超えお䜕も送信されないこずがあるため、バナヌは 20 秒ではなく、デヌタのない状態が 90 秒続いた埌に衚瀺されたす。v2.1.214 より前は、advisor の呌び出し䞭にも 20 秒のしきい倀が適甚されおいたため、䜕も問題がない堎合でも advisor のレビュヌ䞭にバナヌが衚瀺されおいたした。

497 500 

498#### ゲヌトりェむ経由で埅機䞭のバナヌが衚瀺されたり消えたりする501#### ゲヌトりェむ経由で埅機䞭のバナヌが衚瀺されたり消えたりする

499 502 

2495 2498 

2496**察応方法**2499**察応方法**

2497 2500 

2498* Claude Code バヌゞョンが v2.1.216 より前の堎合は、`claude update` を実行しおください。2501* Claude Code のバヌゞョンが v2.1.300 より前の堎合は、シェルで [`claude update`](https://code.claude.com/docs/ja/setup#update-claude-code) を実行したす。v2.1.300 より前は、Claude Code は[拒吊されたツヌルのパラメヌタヌを陀いおリク゚ストを再詊行する](https://code.claude.com/docs/ja/mcp.md#tools-whose-input-schema-the-api-refuses)こずをしなかったため、そのツヌルを含むすべおのリク゚ストでこの゚ラヌが繰り返されおいたした。

2499* 無効なスキヌマを宣蚀する MCP サヌバヌを削陀するか、[無効にしおください](https://code.claude.com/docs/ja/mcp.md#disable-a-server-without-removing-it)。゚ラヌはツヌルを䜍眮でのみ瀺したす。v2.1.216 以降では、各サヌバヌのログで、入力スキヌマが拒吊されるツヌルを瀺す行を確認しおください。どのログにもそれが瀺されおいない堎合は、サヌバヌを 1 ぀ず぀無効にしおください。2502* 無効なスキヌマを宣蚀する MCP サヌバヌを削陀するか、[無効にしおください](https://code.claude.com/docs/ja/mcp.md#disable-a-server-without-removing-it)。゚ラヌはツヌルを䜍眮でのみ瀺したす。v2.1.216 以降では、各サヌバヌのログで、入力スキヌマが拒吊されるツヌルを瀺す行を確認しおください。どのログにもそれが瀺されおいない堎合は、サヌバヌを 1 ぀ず぀無効にしおください。

2500* サヌバヌを保守しおいる堎合は、ツヌルの `input_schema` を修正しおください。スキヌマは有効な JSON Schema である必芁があり、トップレベルのプロパティ名は 1  64 文字で、ASCII 文字ず数字、`_`、`.`、`-` のみを䜿甚する必芁がありたす。[無効な入力スキヌマを持぀ツヌル](https://code.claude.com/docs/ja/mcp.md#tools-with-invalid-input-schemas)を参照しおください。2503* サヌバヌを保守しおいる堎合は、ツヌルの `input_schema` を修正しおください。スキヌマは有効な JSON Schema である必芁があり、トップレベルのプロパティ名は 1  64 文字で、ASCII 文字ず数字、`_`、`.`、`-` のみを䜿甚する必芁がありたす。[無効な入力スキヌマを持぀ツヌル](https://code.claude.com/docs/ja/mcp.md#tools-with-invalid-input-schemas)を参照しおください。

2501 2504 

3295* **`Error: Workspace not trusted. <folder> is your home directory`**: ホヌムディレクトリに察する信頌は保存されないため、先にそこで `claude` を実行しおも解決したせん。代わりに、プロゞェクトディレクトリで䞀床 `claude` を実行しお信頌ダむアログを承認した埌、そこから `claude ultrareview` を実行するか、`--trust-workspace` を远加したす。3298* **`Error: Workspace not trusted. <folder> is your home directory`**: ホヌムディレクトリに察する信頌は保存されないため、先にそこで `claude` を実行しおも解決したせん。代わりに、プロゞェクトディレクトリで䞀床 `claude` を実行しお信頌ダむアログを承認した埌、そこから `claude ultrareview` を実行するか、`--trust-workspace` を远加したす。

3296* **`No answer in time.` に続いお `Error: Workspace not trusted`**: `Trust <folder>? [y/N]` の質問に 5 分間回答がありたせんでした。`claude ultrareview` を再実行しお回答しおください。3299* **`No answer in time.` に続いお `Error: Workspace not trusted`**: `Trust <folder>? [y/N]` の質問に 5 分間回答がありたせんでした。`claude ultrareview` を再実行しお回答しおください。

3297* **`Ultrareview did not start: <folder> is not trusted`**: `n` ず答えるか Enter を抌すなどしお、`Trust <folder>? [y/N]` の質問で拒吊したした。レビュヌを開始するには、`claude ultrareview` を再実行しお `y` ず答えたす。3300* **`Ultrareview did not start: <folder> is not trusted`**: `n` ず答えるか Enter を抌すなどしお、`Trust <folder>? [y/N]` の質問で拒吊したした。レビュヌを開始するには、`claude ultrareview` を再実行しお `y` ず答えたす。

3298* **``Ultrareview did not start: `--trust-workspace` takes no value``**: PR 番号や `false` など、フラグ以倖のものが `--trust-workspace` の埌に続いおいたす。フォルダヌを信頌しない堎合は、フラグを省略したす。この実行に限り信頌する堎合は、PR 番号たたはベヌスブランチをフラグの前に眮きたす: `claude ultrareview 1234 --trust-workspace`。3301* **``Ultrareview did not start: `--trust-workspace` takes no value``**PR 番号や `false` など、フラグ以倖のものが `--trust-workspace` の埌に続いおいたす。フォルダヌを信頌しない堎合は、フラグを省略したす。この実行に限り信頌するには、PR 番号たたはベヌスブランチをフラグの前に眮きたす`claude ultrareview 1234 --trust-workspace`。

3299 3302 

3300v2.1.309 より前は、`claude ultrareview` は `--trust-workspace` を受け付けたせんでした。3303v2.1.309 より前は、`claude ultrareview` は `--trust-workspace` を受け付けたせんでした。

3301 3304 

3587 3590 

3588関連するメッセヌゞは、コマンドが実行される前に発生したす:3591関連するメッセヌゞは、コマンドが実行される前に発生したす:

3589 3592 

3590* `Shell command permission check failed for pattern "..."`: コマンドの暩限チェックで蚱可されたせんでした。[挿入されたコマンドの暩限チェック](https://code.claude.com/docs/ja/skills.md#permission-checks-on-injected-commands)では、各暩限モヌドでどの結果が䞭止を匕き起こすか、および `allowed-tools` でコマンドを事前承認する方法を説明しおいたす3593* `Shell command permission check failed for pattern "..."`コマンドの暩限チェックで蚱可されたせんでした。[挿入されたコマンドの暩限チェック](https://code.claude.com/docs/ja/skills.md#permission-checks-on-injected-commands)では、各暩限モヌドでどの結果が䞭止に぀ながるか、および `allowed-tools` でコマンドを事前承認する方法に぀いお説明しおいたす

3591* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: スキルのフロントマタヌが、bash のないマシンで bash を芁求しおいたす。Git for Windows をむンストヌルするか、フロントマタヌを `shell: powershell` に倉曎したす。[挿入されたコマンドの実行方法](https://code.claude.com/docs/ja/skills.md#how-injected-commands-run)を参照しおください3594* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``スキルのフロントマタヌが、bash がないマシンで bash を芁求しおいたす。Git for Windows をむンストヌルするか、フロントマタヌを `shell: powershell` に倉曎したす。[挿入されたコマンドの実行方法](https://code.claude.com/docs/ja/skills.md#how-injected-commands-run)を参照しおください

3592* `No shell command in <name> was run`: ファむルの `!` コマンドのいずれかに、タブや改行以倖の生の制埡文字が含たれおいるため、どのコマンドも実行されたせん。[文字を芋぀けお削陀する方法](#no-shell-command-was-run)を参照しおください

3593 3595 

3594**察凊方法:**3596**察凊方法:**

3595 3597 

3599 3601 

3600### スキルたたはコマンド内のシェルコマンドが実行されなかった3602### スキルたたはコマンド内のシェルコマンドが実行されなかった

3601 3603 

3602スキルたたはカスタムコマンドのファむル内にある `` !`<command>` `` [動的コンテキストコマンド](https://code.claude.com/docs/ja/skills.md#inject-dynamic-context)のいずれかに、タブや改行以倖の生の制埡文字が含たれおいたす。Claude Code は、ファむルのどのコマンドも実行する前に、呌び出し党䜓を拒吊したす。3604`No shell command in <name> was run` は、そのスキルたたはコマンドファむル内の `` !`<command>` `` [動的コンテキストコマンド](https://code.claude.com/docs/ja/skills.md#inject-dynamic-context)に、Bash ツヌルたたは PowerShell ツヌルが拒吊する文字が含たれおいるこずを意味したす

3605 

3606* **どちらのツヌルでも**タブたたは改行以倖の生の制埡文字

3607* **PowerShell ツヌル**さらに U+FEFF たたは U+180E

3603 3608 

3604メッセヌゞには、コマンドを実行するはずだったシェルツヌルBash たたは PowerShellが瀺され、最埌に拒吊されたコマンドが衚瀺されたす。該圓する各文字は `ï¿œ` に眮き換えられるため、その䜍眮を確認できたす:3609メッセヌゞの末尟には拒吊されたコマンドが衚瀺され、拒吊された各文字は `ï¿œ` ずしお瀺されたす。次は Bash ツヌルの䟋です

3605 3610 

3606```text theme={null}3611```text theme={null}

3607No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as ￜ below: remove them from the skill or command file, or from the arguments or options substituted into it.3612No shell command in /my-skill was run, because the Bash tool does not accept one of them: command contains control characters that would be hidden in the approval dialog. Unprintable characters are shown as ￜ below: remove them from the skill or command file, or from the arguments or options substituted into it.

3610 3615 

3611**察凊方法:**3616**察凊方法:**

3612 3617 

3613* メッセヌゞの最埌に匕甚されたコマンド内の各 `ï¿œ` を芋぀けたす。それが衚す文字を、スキルたたはコマンドのファむルから、あるいはファむルに代入される匕数やオプションから削陀したす。3618* メッセヌゞの末尟に匕甚されたコマンド内の各 `ï¿œ` を芋぀けたす。それが衚す文字を、[スキルたたはコマンドファむル](https://code.claude.com/docs/ja/skills.md#where-skills-live)から、たたはファむルに代入される匕数や[オプション](https://code.claude.com/docs/ja/plugins/manifest-reference.md#user-configuration)から削陀したす。

3614 3619 

3615### Input must be provided when using `--print`3620### Input must be provided when using `--print`

3616 3621 

3739 3744 

3740* **ベヌスブランチを枡さなかった堎合**Claude Code はリポゞトリのデフォルトブランチず比范しおおり、䞊蚘の䟋のようにベヌスを明瀺的に枡すよう提案したす3745* **ベヌスブランチを枡さなかった堎合**Claude Code はリポゞトリのデフォルトブランチず比范しおおり、䞊蚘の䟋のようにベヌスを明瀺的に枡すよう提案したす

3741* **クロヌン内にすでに存圚するベヌスブランチを枡した堎合**ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` ずなりたす3746* **クロヌン内にすでに存圚するベヌスブランチを枡した堎合**ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` ずなりたす

3742* **クロヌン内に存圚しないベヌスブランチを枡した堎合**Claude Code は比范の前に origin からそのブランチをフェッチしおいたす。ヒントは ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)`` ずなりたす。クロヌンがシャロヌクロヌンかどうかを Claude Code が刀断できない堎合は、代わりに `git fetch --unshallow origin` を提案したす。v2.1.221 より前は、フェッチしたすべおのベヌスブランチに぀いお `git fetch --unshallow origin` を提案しおいたしたが、完党なクロヌンではこのコマンドは `fatal: --unshallow on a complete repository does not make sense` で倱敗したす。3747* **クロヌン内に存圚しないベヌスブランチを指定した堎合**Claude Code は比范の前に origin からそのブランチをフェッチしたす。ヒントは ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)`` ずなりたす。クロヌンがシャロヌクロヌンかどうかを Claude Code が刀断できない堎合は、代わりに `git fetch --unshallow origin` を提案したす。v2.1.221 より前は、フェッチしたすべおのベヌスブランチに察しお `git fetch --unshallow origin` が提案されおいたしたが、完党なクロヌンではこのコマンドは `fatal: --unshallow on a complete repository does not make sense` で倱敗したす。

3743 3748 

3744**察凊方法**3749**察凊方法**

3745 3750 

4568 4573 

4569v2.1.281 より前は、Read、Write、Edit、たたは NotebookEdit パスの null バむトがタヌン党䜓を `Path contains null bytes` ずいう名前の゚ラヌで終了し、ツヌルは実行されたせんでした。4574v2.1.281 より前は、Read、Write、Edit、たたは NotebookEdit パスの null バむトがタヌン党䜓を `Path contains null bytes` ずいう名前の゚ラヌで終了し、ツヌルは実行されたせんでした。

4570 4575 

4576### Command contains an invisible character

4577 

4578[PowerShell ツヌル](https://code.claude.com/docs/ja/tools-reference.md#powershell-tool) が、U+FEFF たたは U+180E を含むコマンドの実行を拒吊したした。

4579 

4580```text theme={null}

4581Error: command contains the invisible character U+FEFF (byte order mark) or U+180E (Mongolian vowel separator), and was not run. Remove the character, keep the text that needs it in a file that the command reads, or write it as $([char]0xFEFF) or $([char]0x180E) inside a double-quoted string

4582```

4583 

4584**What to do:**

4585 

4586* **Claude が曞いたコマンドの堎合**: 修正する必芁はありたせん。メッセヌゞが Claude にコマンドの曞き盎し方を䌝えたす。

4587* **スキルたたはコマンドファむルの堎合**: メッセヌゞは `No shell command in <name> was run` の埌に続きたす。[文字の堎所ず削陀方法](#no-shell-command-was-run) を参照しおください。

4588 

4571### File is too large to read as an image4589### File is too large to read as an image

4572 4590 

4573Claude が [Read ツヌル](https://code.claude.com/docs/ja/tools-reference.md#read-tool-behavior) でファむルを画像ずしお読み取ろうずしたしたが、そのファむルは Read が画像ファむルから読み蟌める䞊限である 128 MB を超えおいたす。䜕も読み取られず、Claude はこの゚ラヌをツヌル結果ずしお受け取りたす。4591Claude が [Read ツヌル](https://code.claude.com/docs/ja/tools-reference.md#read-tool-behavior) でファむルを画像ずしお読み取ろうずしたしたが、そのファむルは Read が画像ファむルから読み蟌める䞊限である 128 MB を超えおいたす。䜕も読み取られず、Claude はこの゚ラヌをツヌル結果ずしお受け取りたす。

5431* PATH ゚ントリを PowerShell プロファむルではなく、ナヌザヌたたはシステム環境倉数ずしお蚭定しおください。拡匵機胜はプロファむルを実行しないため、そこにのみ存圚する PATH 線集は拡匵機胜に到達したせん。5449* PATH ゚ントリを PowerShell プロファむルではなく、ナヌザヌたたはシステム環境倉数ずしお蚭定しおください。拡匵機胜はプロファむルを実行しないため、そこにのみ存圚する PATH 線集は拡匵機胜に到達したせん。

5432* PATH を倉曎した埌、VS Code を再起動しおください。拡匵機胜は VS Code が起動時にキャプチャした PATH をチェックするため、PATH 倉曎は再起動埌にのみ有効になりたす。5450* PATH を倉曎した埌、VS Code を再起動しおください。拡匵機胜は VS Code が起動時にキャプチャした PATH をチェックするため、PATH 倉曎は再起動埌にのみ有効になりたす。

5433 5451 

5452### The Claude Code program for this computer could not be found

5453 

5454[VS Code 拡匵機胜](https://code.claude.com/docs/ja/vs-code.md) は、内郚にバンドルされおいる Claude Code のコピヌを探したしたが、このコンピュヌタヌ向けにビルドされたものが芋぀かりたせんでした。メッセヌゞには、このコンピュヌタヌに必芁なビルドが瀺されたす。

5455 

5456```text theme={null}

5457The Claude Code program for this computer, the Linux (linux-x64) build, could not be found.

5458```

5459 

5460**察応方法**

5461 

5462* 拡匵機胜が保持しおいるビルドがメッセヌゞに瀺されおいる堎合、別のプラットフォヌム向けの拡匵機胜パッケヌゞがむンストヌルされおいたす。メッセヌゞに瀺されおいるビルド向けに䜜られたパッケヌゞをむンストヌルしおください

5463* 拡匵機胜が保持しおいるビルドがメッセヌゞに瀺されおいない堎合は、゚ディタヌの Extensions ビュヌから Claude Code 拡匵機胜を再むンストヌルしおください

5464* たたは、いずれの堎合も、[`claudeCode.claudeProcessWrapper`](https://code.claude.com/docs/ja/vs-code#extension-settings) を別途むンストヌルした `claude` バむナリに蚭定しおください

5465 

5466v2.1.290 より前では、これは `Unsupported platform: <platform>-<arch>. No compatible Claude Code binary found.` ずしお衚瀺されおいたした。

5467 

5434### Claude Code ぞの接続がこのメッセヌゞの完了前に終了したした5468### Claude Code ぞの接続がこのメッセヌゞの完了前に終了したした

5435 5469 

5436[VS Code 拡匵機胜](https://code.claude.com/docs/ja/vs-code.md) はメッセヌゞを `claude` プロセスに送信し、プロセスが確認たたは完了する前に接続が゚ラヌなしで終了したした。拡匵機胜はメッセヌゞが凊理されたかどうかを刀断できないため、再床送信するよう求めたす。5470[VS Code 拡匵機胜](https://code.claude.com/docs/ja/vs-code.md) はメッセヌゞを `claude` プロセスに送信し、プロセスが確認たたは完了する前に接続が゚ラヌなしで終了したした。拡匵機胜はメッセヌゞが凊理されたかどうかを刀断できないため、再床送信するよう求めたす。

fast-mode.md +10 −8

Details

8 8 

9> [!NOTE]9> [!NOTE]

10>10>

11> 高速モヌドは[リサヌチプレビュヌ](#research-preview)段階です。機胜、䟡栌蚭定、および利甚可胜性はフィヌドバックに基づいお倉曎される可胜性がありたす。11> Claude Opus 5.5 の fast mode は利甚可胜です。Claude Opus 5 および Claude Opus 4.8 の fast mode は[リサヌチプレビュヌ](#research-preview)段階です。

12 12 

13高速モヌドは Claude Opus の高速構成で、モデルを最倧 2.5 倍高速化したすが、トヌクンあたりのコストは高くなりたす。迅速な反埩やラむブデバッグなどのむンタラクティブな䜜業で速床が必芁な堎合は `/fast` でオンにし、コストがレむテンシヌより重芁な堎合はオフにしたす。13高速モヌドは Claude Opus の高速構成で、モデルを最倧 2.5 倍高速化したすが、トヌクンあたりのコストは高くなりたす。迅速な反埩やラむブデバッグなどのむンタラクティブな䜜業で速床が必芁な堎合は `/fast` でオンにし、コストがレむテンシヌより重芁な堎合はオフにしたす。

14 14 

20 20 

21* Claude Code CLI で `/fast` を䜿甚しお高速モヌドをオンにしたす。[VS Code 拡匵機胜](https://code.claude.com/docs/ja/vs-code.md)は、遞択したモデルが高速モヌドをサポヌトしおいる堎合、**高速モヌドを切り替え**コマンドを提䟛したす。Claude Code はそのトグルを [`fastMode` 蚭定](#toggle-fast-mode)に保存したす。21* Claude Code CLI で `/fast` を䜿甚しお高速モヌドをオンにしたす。[VS Code 拡匵機胜](https://code.claude.com/docs/ja/vs-code.md)は、遞択したモデルが高速モヌドをサポヌトしおいる堎合、**高速モヌドを切り替え**コマンドを提䟛したす。Claude Code はそのトグルを [`fastMode` 蚭定](#toggle-fast-mode)に保存したす。

22* 高速モヌド䟡栌は Opus 5.5 で入力/出力あたり $8/$40 MTok、Opus 5 および Opus 4.8 で入力/出力あたり $10/$50 MTok です。22* 高速モヌド䟡栌は Opus 5.5 で入力/出力あたり $8/$40 MTok、Opus 5 および Opus 4.8 で入力/出力あたり $10/$50 MTok です。

23* サブスクリプションプランPro/Max/Team/Enterpriseの Claude Code ナヌザヌず Claude Console のすべおのナヌザヌが利甚可胜です。Team および Enterprise 組織は Owner が最初に有効にする必芁があり、Console 組織はアクセスを最初にプロビゞョニングする必芁がありたす。どちらも[芁件](#requirements)に蚘茉されおいたす。23* サブスクリプションプランPro/Max/Team/Enterpriseの Claude Code ナヌザヌず Claude Console で利甚可胜です。Team および Enterprise 組織は Owner が最初に有効にする必芁があり、Console 組織は Opus 5 たたは Opus 4.8 で䜿甚するために、最初にアクセスをプロビゞョニングする必芁がありたす。どちらも[芁件](#requirements)に蚘茉されおいたす。

24* サブスクリプションプランPro/Max/Team/Enterpriseの Claude Code ナヌザヌの堎合、高速モヌドは䜿甚量クレゞットのみで利甚可胜であり、サブスクリプションレヌト制限に含たれおいたせん。24* サブスクリプションプランPro/Max/Team/Enterpriseの Claude Code ナヌザヌの堎合、高速モヌドは䜿甚量クレゞットのみで利甚可胜であり、サブスクリプションレヌト制限に含たれおいたせん。

25 25 

26## 高速モヌドの切り替え26## 高速モヌドの切り替え

119 119 

120高速モヌドには以䞋のすべおが必芁です120高速モヌドには以䞋のすべおが必芁です

121 121 

122* **Anthropic API たたはサブスクリプションのみ**高速モヌドは Anthropic Console API および䜿甚量クレゞットを䜿甚する Claude サブスクリプションプランで利甚可胜です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは AWS 䞊の Claude Platform では利甚できたせん。Console 組織は、[高速モヌドアクセスをプロビゞョニング](#enable-fast-mode-for-your-organization)する必芁もありたす。122* **Anthropic API たたはサブスクリプションのみ**fast mode は Anthropic Console API および䜿甚クレゞットを䜿甚する Claude サブスクリプションプランで利甚可胜です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは AWS 䞊の Claude Platform では利甚できたせん。Console 組織が Opus 5 たたは Opus 4.8 で fast mode を䜿甚するには、[fast mode アクセスをプロビゞョニング](#enable-fast-mode-for-your-organization)する必芁もありたす。

123* **サブスクリプションプランで䜿甚クレゞットが有効**Pro、Max、Team、たたは Enterprise プランでは、アカりントで[䜿甚クレゞット](https://code.claude.com/docs/ja/costs.md#add-usage-credits-to-your-subscription)が有効になっおいる必芁がありたす。これにより、プランに含たれる䜿甚量を超えお課金できるようになりたす。有効になるたで、`/fast` は「Fast mode requires usage credits」ず衚瀺したす。有効にする方法はプランによっお異なりたす123* **サブスクリプションプランで䜿甚クレゞットが有効**Pro、Max、Team、たたは Enterprise プランでは、アカりントで[䜿甚クレゞット](https://code.claude.com/docs/ja/costs.md#add-usage-credits-to-your-subscription)が有効になっおいる必芁がありたす。これにより、プランに含たれる䜿甚量を超えお課金できるようになりたす。有効になるたで、`/fast` は「Fast mode requires usage credits」ず衚瀺したす。有効にする方法はプランによっお異なりたす

124 * Pro および Max では、claude.ai の [**Settings > Usage**](https://claude.ai/settings/usage) の **Usage credits** セクションで有効にするか、`/usage-credits` を実行しおそのペヌゞを開きたす。124 * Pro および Max では、claude.ai の [**Settings > Usage**](https://claude.ai/settings/usage) の **Usage credits** セクションで有効にするか、`/usage-credits` を実行しおそのペヌゞを開きたす。

125 * Team および Enterprise では、請求アクセス暩を持぀メンバヌが [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) で組織の䜿甚クレゞットを有効にし、アクセス暩を持たないメンバヌは `/usage-credits` を実行しお組織の管理者にリク゚ストを送信したす。125 * Team および Enterprise では、請求アクセス暩を持぀メンバヌが [**Organization settings > Usage**](https://claude.ai/admin-settings/usage) で組織の䜿甚クレゞットを有効にし、アクセス暩を持たないメンバヌは `/usage-credits` を実行しお組織の管理者にリク゚ストを送信したす。

129> 高速モヌド䜿甚量は、プランに残りの䜿甚量がある堎合でも、䜿甚量クレゞットに盎接請求されたす。129> 高速モヌド䜿甚量は、プランに残りの䜿甚量がある堎合でも、䜿甚量クレゞットに盎接請求されたす。

130 130 

131* **有料 Console 組織**Claude Console アカりントは䜿甚量クレゞットを䜿甚せず、組織は API 䜿甚量の残りず同じようにトヌクンごずに高速モヌドの料金を支払いたす。Console の無料 Evaluation プランでは、`/fast` は「Fast mode unavailable during evaluation. Please purchase credits.」ず衚瀺されたす。これをクリアするには、[Console 請求蚭定](https://platform.claude.com/settings/billing)でクレゞットを賌入したす。131* **有料 Console 組織**Claude Console アカりントは䜿甚量クレゞットを䜿甚せず、組織は API 䜿甚量の残りず同じようにトヌクンごずに高速モヌドの料金を支払いたす。Console の無料 Evaluation プランでは、`/fast` は「Fast mode unavailable during evaluation. Please purchase credits.」ず衚瀺されたす。これをクリアするには、[Console 請求蚭定](https://platform.claude.com/settings/billing)でクレゞットを賌入したす。

132 

133 Opus 5.5 での fast mode は、組織の[䜿甚量ティア](https://platform.claude.com/docs/en/api/rate-limits)にも䟝存したす。

132* **Team および Enterprise の所有者による有効化**高速モヌドは Team および Enterprise 組織ではデフォルトで無効になっおいたす。ナヌザヌがアクセスできるようにするには、所有者が明瀺的に[高速モヌドを有効にする](#enable-fast-mode-for-your-organization)必芁がありたす。134* **Team および Enterprise の所有者による有効化**高速モヌドは Team および Enterprise 組織ではデフォルトで無効になっおいたす。ナヌザヌがアクセスできるようにするには、所有者が明瀺的に[高速モヌドを有効にする](#enable-fast-mode-for-your-organization)必芁がありたす。

133 135 

134> [!NOTE]136> [!NOTE]

144 146 

145組織で高速モヌドを有効にする堎所は、組織が䜿甚する補品によっお異なりたす147組織で高速モヌドを有効にする堎所は、組織が䜿甚する補品によっお異なりたす

146 148 

147* **Console**API カスタマヌ管理者が [Claude Code preferences](https://platform.claude.com/claude-code/preferences) で有効にしたす。高速モヌドは[リサヌチプレビュヌ](#research-preview)にあるため、組織は高速モヌドリク゚ストが成功する前に高速モヌドアクセスをプロビゞョニングする必芁がありたす。アクセスを取埗するには、アカりントマネヌゞャヌに連絡するか、[Claude API の高速モヌド](https://platform.claude.com/docs/en/build-with-claude/fast-mode)で説明されおいるようにりェむトリストに参加したす。149* **Console**API 顧客管理者が [Claude Code preferences](https://platform.claude.com/claude-code/preferences) で有効にしたす

148 

149 プロビゞョニングされたアクセスがない堎合、API は各高速モヌドリク゚ストを 429 で拒吊し、Claude Code は各拒吊を[高速モヌドレヌト制限](#handle-rate-limits)ずしお扱いたす。レヌト制限のクヌルダりンずは異なり、アクセスがプロビゞョニングされるたで拒吊は続きたす。

150* **Claude AI**Team および EnterpriseOwner が [**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code) で有効にしたす150* **Claude AI**Team および EnterpriseOwner が [**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code) で有効にしたす

151 151 

152Claude Opus 5 たたは Claude Opus 4.8 を䜿甚する Console 組織は、[Claude API の fast mode](https://platform.claude.com/docs/en/build-with-claude/fast-mode) で説明されおいるように、プロビゞョニングされたアクセスも必芁です。そのアクセスがない堎合、これらのモデルでの fast mode リク゚ストは [fast mode レヌト制限](#handle-rate-limits)に達し、アクセスがプロビゞョニングされるたで暙準速床にフォヌルバックしたす。

153 

152高速モヌドを完党に無効にするもう 1 ぀のオプションは、`CLAUDE_CODE_DISABLE_FAST_MODE=1` を蚭定するこずです。[環境倉数](https://code.claude.com/docs/ja/env-vars.md)を参照しおください。154高速モヌドを完党に無効にするもう 1 ぀のオプションは、`CLAUDE_CODE_DISABLE_FAST_MODE=1` を蚭定するこずです。[環境倉数](https://code.claude.com/docs/ja/env-vars.md)を参照しおください。

153 155 

154### プロキシず LLM ゲヌトりェむの背埌で高速モヌドを䜿甚する156### プロキシず LLM ゲヌトりェむの背埌で高速モヌドを䜿甚する

201 203 

202## レヌト制限の凊理204## レヌト制限の凊理

203 205 

204高速モヌドは暙準 Opus ずは別のレヌト制限がありたす。サポヌトされおいるすべおの Opus モデルは 1 ぀の高速モヌドレヌト制限プヌルを共有したすどのモデルでの䜿甚も同じ制限から匕き出されたす。高速モヌドレヌト制限に達した堎合206fast mode には暙準の Opus ずは別のレヌト制限がありたす。Console の組織の堎合、そのレヌト制限に぀いおは Claude Platform の[レヌト制限](https://platform.claude.com/docs/en/api/rate-limits)ペヌゞで説明されおいたす。fast mode のレヌト制限に達した堎合

205 207 

2061. 高速モヌドは自動的に暙準速床にフォヌルバックしたす2081. 高速モヌドは自動的に暙準速床にフォヌルバックしたす

2072. `↯` アむコンがグレヌに倉わっおクヌルダりンを瀺したす2092. `↯` アむコンがグレヌに倉わっおクヌルダりンを瀺したす

217 219 

218## リサヌチプレビュヌ220## リサヌチプレビュヌ

219 221 

220高速モヌドはリサヌチプレビュヌ機胜です。これは以䞋を意味したす222Claude Opus 5 および Claude Opus 4.8 の fast mode はリサヌチプレビュヌ機胜です。これは以䞋を意味したす

221 223 

222* 機胜はフィヌドバックに基づいお倉曎される可胜性がありたす224* 機胜はフィヌドバックに基づいお倉曎される可胜性がありたす

223* 利甚可胜性ず䟡栌蚭定は倉曎される可胜性がありたす225* 利甚可胜性ず䟡栌蚭定は倉曎される可胜性がありたす

Details

90 <tr>90 <tr>

91 <td>[fast mode](https://code.claude.com/docs/ja/fast-mode.md)</td>91 <td>[fast mode](https://code.claude.com/docs/ja/fast-mode.md)</td>

92 <td>✓Team および Enterprise では [Owner による有効化](https://code.claude.com/docs/ja/fast-mode.md#enable-fast-mode-for-your-organization)が必芁</td>92 <td>✓Team および Enterprise では [Owner による有効化](https://code.claude.com/docs/ja/fast-mode.md#enable-fast-mode-for-your-organization)が必芁</td>

93 <td>✓プロビゞョニング枈みの組織</td>93 <td>✓Opus 5 および 4.8 ではプロビゞョニングが必芁</td>

94 <td>✗</td>94 <td>✗</td>

95 <td>✗</td>95 <td>✗</td>

96 <td>✗</td>96 <td>✗</td>

285 285 

286\*\*利甚䞍可\*\*すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)。286\*\*利甚䞍可\*\*すべおの [Claude サブスクリプションが必芁な機胜](#features-that-require-a-claude-subscription)。

287 287 

288[プロバむダヌによっお異なる CLI の機胜](#cli-capabilities-that-vary-by-provider)はすべお利甚できたすが、[fast mode](https://code.claude.com/docs/ja/fast-mode.md) には[プロビゞョニングされたアクセス](https://code.claude.com/docs/ja/fast-mode.md#enable-fast-mode-for-your-organization)が必芁です。claude.ai の Team たたは Enterprise 組織で構成した[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)は、Console の API キヌで認蚌するセッションには適甚されたせん。それらのセッションにも適甚する方法に぀いおは、[プラットフォヌムの利甚可胜性](https://code.claude.com/docs/ja/server-managed-settings.md#platform-availability)を参照しおください。288[プロバむダヌによっお異なる CLI の機胜](#cli-capabilities-that-vary-by-provider)はすべお利甚できたすが、Claude Opus 5 たたは Claude Opus 4.8 で [fast mode](https://code.claude.com/docs/ja/fast-mode.md) を䜿甚するには[プロビゞョニングされたアクセス](https://code.claude.com/docs/ja/fast-mode.md#enable-fast-mode-for-your-organization)が必芁です。claude.ai の Team たたは Enterprise 組織で構成した[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)は、Console の API キヌで認蚌するセッションには適甚されたせん。それらのセッションにも適甚する方法に぀いおは、[プラットフォヌムの利甚可胜性](https://code.claude.com/docs/ja/server-managed-settings.md#platform-availability)を参照しおください。

289 289 

290**郚分的なサポヌト**290**郚分的なサポヌト**

291 291 

github-actions.md +2 −2

Details

241 - uses: anthropics/claude-code-action@v1241 - uses: anthropics/claude-code-action@v1

242 with:242 with:

243 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}243 anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

244 plugin_marketplaces: "https://github.com/anthropics/claude-code.git"244 plugin_marketplaces: "https://github.com/anthropics/claude-plugins-official.git"

245 plugins: "code-review@claude-code-plugins"245 plugins: "code-review@claude-plugins-official"

246 prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"246 prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}"

247 claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'247 claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'

248```248```

Details

221 221 

222レビュヌや Anthropic がホストするクラりドセッションがタむムアりトする堎合、Anthropic のむンフラストラクチャから GHES むンスタンスに到達できない可胜性がありたす。ファむアりォヌルが Anthropic の[送信元 IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses)からのむンバりンド接続を蚱可しおいるこずを確認しおください。[セルフホスト環境](https://code.claude.com/docs/ja/self-hosted-environments)のセッションはネットワヌク内郚から GHES に到達するため、そうしたセッションでクロヌンできない堎合は、代わりにランナヌ自䜓のネットワヌク経路を確認しおください。リポゞトリピッカヌやその他のホスト型のセッション開始前フロヌに぀いおは、[ネットワヌク芁件](#network-requirements)を参照しおください。222レビュヌや Anthropic がホストするクラりドセッションがタむムアりトする堎合、Anthropic のむンフラストラクチャから GHES むンスタンスに到達できない可胜性がありたす。ファむアりォヌルが Anthropic の[送信元 IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses)からのむンバりンド接続を蚱可しおいるこずを確認しおください。[セルフホスト環境](https://code.claude.com/docs/ja/self-hosted-environments)のセッションはネットワヌク内郚から GHES に到達するため、そうしたセッションでクロヌンできない堎合は、代わりにランナヌ自䜓のネットワヌク経路を確認しおください。リポゞトリピッカヌやその他のホスト型のセッション開始前フロヌに぀いおは、[ネットワヌク芁件](#network-requirements)を参照しおください。

223 223 

224### 接続テストは成功するが 2 回目のテストが倱敗する

225 

2262 回目のテストは、Anthropic がホストするクラりドセッションず同じ方法で GHES むンスタンスに接続したす。衚瀺されたメッセヌゞを探し、ファむアりォヌルを確認すべきか再詊行すべきかを確認しおください。

227 

228* **`Connection test passed, but a second test failed.`**むンスタンスがファむアりォヌルの内偎にある堎合は、Anthropic のすべおの[送信元 IP アドレス](https://platform.claude.com/docs/en/api/ip-addresses#outbound-ip-addresses)を蚱可しおください。ファむアりォヌルがその䞀郚をブロックしおいおも、接続テストが成功するこずがあるためです。数分埌に再詊行するこずもできたす。

229* **`Connection test passed, but a second test could not run.`**数分埌に再詊行しおください。

230 

231再床テストするには、[**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control#github-enterprise) で接続の **More options** メニュヌを開き、**Test connection** を遞択したす。

232 

224### セッションの開始が `Unable to get organization UUID` で倱敗する233### セッションの開始が `Unable to get organization UUID` で倱敗する

225 234 

226Claude Code が認蚌情報から claude.ai の組織を読み取れたせんでした。GitHub Enterprise Server のサポヌトは Team プランず Enterprise プランに限定されおいるため、Team たたは Enterprise 組織のアカりントを䜿甚しお `/login` でサむンむンしおください。原因およびこの状態で衚瀺されるその他のメッセヌゞに぀いおは、[Unable to get organization UUID](https://code.claude.com/docs/ja/claude-code-on-the-web.md#unable-to-get-organization-uuid) を参照しおください。235Claude Code が認蚌情報から claude.ai の組織を読み取れたせんでした。GitHub Enterprise Server のサポヌトは Team プランず Enterprise プランに限定されおいるため、Team たたは Enterprise 組織のアカりントを䜿甚しお `/login` でサむンむンしおください。原因およびこの状態で衚瀺されるその他のメッセヌゞに぀いおは、[Unable to get organization UUID](https://code.claude.com/docs/ja/claude-code-on-the-web.md#unable-to-get-organization-uuid) を参照しおください。

hooks-guide.md +47 −47

Details

75 75 

76## 自動化できるこず76## 自動化できるこず

77 77 

78フックを䜿うず、Claude Code のラむフサむクルの重芁なタむミングでコヌドを実行できたす。たずえば、線集埌にファむルをフォヌマットする、コマンドを実行前にブロックする、Claude が入力を必芁ずしおいるずきに通知を送る、セッション開始時にコンテキストを泚入する、などです。フックむベントの完党な䞀芧は、[フックリファレンス](https://code.claude.com/docs/ja/hooks.md#hook-lifecycle)を参照しおください。78フックを䜿うず、Claude Code のラむフサむクルの重芁なポむントでコヌドを実行できたす。線集埌のファむルのフォヌマット、実行前のコマンドのブロック、Claude が入力を必芁ずしたずきの通知送信、セッション開始時のコンテキスト泚入などが可胜です。フックむベントの党䞀芧に぀いおは、[フックリファレンス](https://code.claude.com/docs/ja/hooks.md#hook-lifecycle)を参照しおください。

79 79 

80各䟋には、[蚭定ファむル](#configure-hook-location)に远加するだけで䜿える蚭定ブロックが含たれおいたす。80各䟋には、[蚭定ファむル](#configure-hook-location)に远加するだけで䜿える蚭定ブロックが含たれおいたす。

81 81 

82別のモデルによるレビュヌを実行し、その結果をセッションにフィヌドバックするフックの本番環境での䟋に぀いおは、[`security-guidance` プラグむンが Claude Code ず統合する仕組み](https://code.claude.com/docs/ja/security-guidance#how-the-plugin-integrates-with-claude-code)を参照しおください。82別のモデルによるレビュヌを実行し、その結果をセッションにフィヌドバックするフックの本番環境での䟋に぀いおは、[`security-guidance` プラグむンが Claude Code ず統合される仕組み](https://code.claude.com/docs/ja/security-guidance#how-the-plugin-integrates-with-claude-code)を参照しおください。

83 83 

84### Claude が入力を必芁ずしおいるずきに通知を受け取る84### Claude が入力を必芁ずしたずきに通知を受け取る

85 85 

86Claude が䜜業を終えお入力を必芁ずしおいるずきにデスクトップ通知を受け取れるようにしたす。これにより、タヌミナルを確認しなくおも他のタスクに切り替えられたす。86Claude が䜜業を終えお入力を必芁ずするたびにデスクトップ通知を受け取れるため、タヌミナルを確認しなくおも他のタスクに切り替えられたす。

87 87 

88このフックは `Notification` むベントを䜿甚したす。このむベントは、Claude が入力たたは暩限を埅っおいるずきに Claude Code が発火させたす。正確なタむミングに぀いおは、[各通知タむプが発火するタむミング](https://code.claude.com/docs/ja/hooks.md#notification)を参照しおください。88このフックは `Notification` むベントを䜿甚したす。このむベントは、Claude が入力たたは暩限を埅っおいるずきに Claude Code が発火させたす。正確なタむミングに぀いおは、[各通知タむプが発火するタむミング](https://code.claude.com/docs/ja/hooks.md#notification)を参照しおください。

89 89 

90以䞋の各タブでは、プラットフォヌムのネむティブな通知コマンドを䜿甚しおいたす。これを `~/.claude/settings.json` に远加したす。90以䞋の各タブでは、プラットフォヌムネむティブの通知コマンドを䜿甚しおいたす。これを `~/.claude/settings.json` に远加したす。

91 91 

92**macOS**92**macOS**

93 93 

111 111 

112> **通知が衚瀺されない堎合**112> **通知が衚瀺されない堎合**

113>113>

114> `osascript` は、組み蟌みの Script Editor アプリを経由しお通知を送りたす。Script Editor に通知の暩限がない堎合、コマンドは䜕も衚瀺せずに倱敗し、macOS は暩限を付䞎するよう求めおきたせん。114> `osascript` は、組み蟌みのスクリプト゚ディタアプリを経由しお通知を送りたす。スクリプト゚ディタに通知の暩限がない堎合、コマンドは䜕も衚瀺せずに倱敗し、macOS は暩限の付䞎を求めるプロンプトを衚瀺したせん。

115>115>

116> タヌミナルで次のコマンドを䞀床実行しお、Script Editor を通知蚭定に衚瀺させたす。116> タヌミナルで次のコマンドを䞀床実行しお、スクリプト゚ディタが通知蚭定に衚瀺されるようにしたす。

117>117>

118> ```bash theme={null}118> ```bash theme={null}

119> osascript -e 'display notification "test"'119> osascript -e 'display notification "test"'

120> ```120> ```

121>121>

122> この時点ではただ䜕も衚瀺されたせん。**システム蚭定 > 通知** を開き、䞀芧から **Script Editor** を芋぀けお **通知を蚱可** をオンにしたす。コマンドを再床実行しお、テスト通知が衚瀺されるこずを確認したす。122> この時点ではただ䜕も衚瀺されたせん。**システム蚭定 > 通知**を開き、䞀芧から**スクリプト゚ディタ**を芋぀けお、**通知を蚱可**をオンにしたす。コマンドを再床実行しお、テスト通知が衚瀺されるこずを確認したす。

123 123 

124**Linux**124**Linux**

125 125 

143 143 

144> **通知が衚瀺されない堎合**144> **通知が衚瀺されない堎合**

145>145>

146> `notify-send` にはデスクトップ通知デヌモンが必芁ですが、ヘッドレスサヌバヌ、SSH セッション、ほずんどのコンテナにはこれがありたせん。たずコマンドを盎接テストしおください。146> `notify-send` にはデスクトップ通知デヌモンが必芁ですが、ヘッドレスサヌバヌ、SSH セッション、およびほずんどのコンテナにはこれがありたせん。たずコマンドを盎接テストしたす。

147>147>

148> ```bash theme={null}148> ```bash theme={null}

149> notify-send 'Claude Code' 'test'149> notify-send 'Claude Code' 'test'

150> ```150> ```

151>151>

152> コマンドが芋぀からない堎合は、Debian や Ubuntu では `libnotify-bin` パッケヌゞを、その他のディストリビュヌションでは同等のパッケヌゞをむンストヌルしおください。152> コマンドが芋぀からない堎合は、Debian および Ubuntu では `libnotify-bin` パッケヌゞを、それ以倖ではディストリビュヌションの同等のパッケヌゞをむンストヌルしたす。

153 153 

154**Windows (PowerShell)**154**Windows (PowerShell)**

155 155 

173 173 

174> **ダむアログが衚瀺されない堎合**174> **ダむアログが衚瀺されない堎合**

175>175>

176> このコマンドは画面の隅に通知を衚瀺するのではなくダむアログボックスを開くため、ダむアログがタヌミナルりィンドりの背埌に開くこずがありたす。たず PowerShell でコマンドを盎接テストしおください。176> このコマンドは画面の隅に衚瀺される通知ではなくダむアログボックスを開くため、ダむアログがタヌミナルりィンドりの背埌に開くこずがありたす。たず PowerShell でコマンドを盎接テストしおください。

177>177>

178> WSL 内で Claude Code を実行しおいる堎合は、Windows の盞互運甚機胜を通じお `powershell.exe` が `PATH` 䞊で利甚可胜である必芁がありたす。178> WSL 内で Claude Code を実行しおいる堎合は、Windows の盞互運甚機胜を通じお `powershell.exe` が `PATH` 䞊で利甚可胜である必芁がありたす。

179 179 

180空の `matcher` は、すべおの通知タむプで発火したす。特定のむベントでのみ発火させるには、次のいずれかの倀を蚭定したす。180空の `matcher` はすべおの通知タむプで発火したす。特定のむベントでのみ発火させるには、次のいずれかの倀を蚭定したす。

181 181 

182| Matcher | 発火するタむミング |182| Matcher | 発火するタむミング |

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

184| `permission_prompt` | Claude がツヌルの䜿甚たたはサンドボックス化されたコマンドの[ネットワヌクリク゚スト](https://code.claude.com/docs/ja/sandboxing.md#network-isolation)の承認を必芁ずしおいお、プロンプトが玄 6 秒間埅機したずき |184| `permission_prompt` | Claude がツヌルの䜿甚、たたはサンドボックス化されたコマンドの[ネットワヌクリク゚スト](https://code.claude.com/docs/ja/sandboxing.md#network-isolation)の承認を必芁ずし、プロンプトが玄 6 秒間埅機したずき |

185| `idle_prompt` | Claude が玄 60 秒前に応答を終え、それ以降ナヌザヌが入力しおいないずき |185| `idle_prompt` | Claude が玄 60 秒前に応答を終え、それ以降ナヌザヌが入力しおいないずき |

186| `auth_success` | 認蚌が完了したずき |186| `auth_success` | 認蚌が完了したずき |

187| `elicitation_dialog` | MCP サヌバヌが elicitation フォヌムを開き、ナヌザヌが玄 6 秒間入力しおいないずき |187| `elicitation_dialog` | MCP サヌバヌが elicitation フォヌムを開き、ナヌザヌが玄 6 秒間入力しおいないずき |

188| `elicitation_url_dialog` | MCP サヌバヌがブラりザで URL を開くよう求め、ナヌザヌが玄 6 秒間入力しおいないずき |188| `elicitation_url_dialog` | MCP サヌバヌがブラりザで URL を開くよう求め、ナヌザヌが玄 6 秒間入力しおいないずき |

189| `elicitation_complete` | MCP サヌバヌが [URL モヌドの elicitation](https://code.claude.com/docs/ja/hooks.md#elicitation-input) の完了を報告したずき |189| `elicitation_complete` | MCP サヌバヌが [URL モヌドの elicitation](https://code.claude.com/docs/ja/hooks.md#elicitation-input) の完了を報告したずき |

190| `elicitation_response` | MCP elicitation の応答がサヌバヌに返送されたずき |190| `elicitation_response` | MCP の elicitation ぞの応答がサヌバヌに送り返されたずき |

191| `agent_needs_input` | [゚ヌゞェントビュヌ](https://code.claude.com/docs/ja/agent-view.md)が開いおいる間に、バックグラりンドセッションがナヌザヌの入力埅ちを開始したずき。たた、タヌミナルセッションが[゚ヌゞェントチヌムのチヌムメむトのタヌミナルセットアップに関する質問](https://code.claude.com/docs/ja/agent-teams.md#choose-a-display-mode)や、auto モヌドの[分類噚リク゚ストの料金](https://code.claude.com/docs/ja/auto-mode-classifier-billing.md)に関するお知らせを衚瀺し、ナヌザヌが玄 6 秒間入力しおいないずきにも発火したす |191| `agent_needs_input` | [゚ヌゞェントビュヌ](https://code.claude.com/docs/ja/agent-view.md)が開いおいる間に、バックグラりンドセッションがナヌザヌの入力埅ちを開始したずき。たた、タヌミナルセッションで[゚ヌゞェントチヌムのチヌムメむトのタヌミナル蚭定に関する質問](https://code.claude.com/docs/ja/agent-teams.md#choose-a-display-mode)や、auto モヌドの[分類噚リク゚ストの料金](https://code.claude.com/docs/ja/auto-mode-classifier-billing.md)に関するお知らせが衚瀺され、ナヌザヌが玄 6 秒間入力しおいないずきにも発火したす |

192| `agent_completed` | バックグラりンドセッションが終了たたは倱敗したずき。[゚ヌゞェントビュヌ](https://code.claude.com/docs/ja/agent-view.md)が開いおいる間にのみ発火したす |192| `agent_completed` | バックグラりンドセッションが完了たたは倱敗したずき。[゚ヌゞェントビュヌ](https://code.claude.com/docs/ja/agent-view.md)が開いおいる間のみ発火したす |

193| `quota_auto_resume_fired` | claude.ai の䜿甚制限によっお䞀時停止したタスクを Claude Code が続行したずき。続行はリセット時に行われるか、埅機䞭に Claude Code で行った操䜜䜿甚クレゞットの远加、プランのアップグレヌド、モデルの切り替えなどによっお䜿甚量が再び利甚可胜になった堎合はそれより早く行われたす。ただし、[モデル蚭定の䟋倖](https://code.claude.com/docs/ja/interactive-mode.md#wait-for-a-usage-limit-to-reset)がありたす |193| `quota_auto_resume_fired` | claude.ai の䜿甚制限によっお䞀時停止されたタスクを Claude Code が続行したずき。リセット時、たたは埅機䞭に Claude Code で行った操䜜䜿甚クレゞットの远加、プランのアップグレヌド、モデルの切り替えなどによっお䜿甚量が再び利甚可胜になった堎合はそれより早く続行したす。ただし[モデル蚭定に関する䟋倖](https://code.claude.com/docs/ja/interactive-mode.md#wait-for-a-usage-limit-to-reset)がありたす |

194| `quota_auto_resume_stale` | コンピュヌタヌが玄 30 分以䞊スリヌプしおいる間に claude.ai の䜿甚制限がリセットされたずき。Claude Code は続行せず、ナヌザヌが `Enter` を抌すのを埅ちたす。スリヌプがそれより短い堎合は続行し、代わりに `quota_auto_resume_fired` を発火させたす |194| `quota_auto_resume_stale` | コンピュヌタヌが玄 30 分を超えおスリヌプしおいる間に claude.ai の䜿甚制限がリセットされたずき。Claude Code は続行せず、ナヌザヌが `Enter` を抌すのを埅ちたす。スリヌプがそれより短い堎合は続行し、代わりに `quota_auto_resume_fired` を発火させたす |

195| `quota_auto_resume_disabled` | Claude Code がタスクを続行せずに claude.ai の䜿甚制限の埅機を終了したずき。これは、Claude Code が自ら開始した埅機䞭に [`autoContinueAtUsageLimit`](https://code.claude.com/docs/ja/settings-reference#autocontinueatusagelimit) がオフになった堎合やリセットが 24 時間以䞊先に移動した堎合、続行したタスクが繰り返し制限に達した堎合、たたは続行がモデルに到達する前にブロックされた堎合です。ナヌザヌが `Esc` たたは `Ctrl+C` を抌した堎合や、**自動的に続行しない** を遞んだ堎合は発火したせん |195| `quota_auto_resume_disabled` | Claude Code がタスクを続行せずに claude.ai の䜿甚制限の埅機を終了したずき。具䜓的には、[`autoContinueAtUsageLimit`](https://code.claude.com/docs/ja/settings-reference#autocontinueatusagelimit) がオフにされた堎合、Claude Code が自ら開始した埅機䞭にリセットが 24 時間以䞊先に移動した堎合、続行したタスクが繰り返し制限に達した堎合、たたは続行がモデルに届く前にブロックされた堎合です。ナヌザヌが `Esc` たたは `Ctrl+C` を抌した堎合や、**Don't continue automatically** を遞択した堎合は発火したせん |

196| `plugin_notification` | [mod](https://code.claude.com/docs/ja/plugins/mods/api.md#show-something-without-starting-a-turn) が `$.ui.notify` で通知を発行したずき。mod がタむトルを蚭定しおいない限り、フックの `title` は mod の名前になりたす |196| `plugin_notification` | [mod](https://code.claude.com/docs/ja/plugins/mods/api.md#show-something-without-starting-a-turn) が `$.ui.notify` で通知を発行したずき。mod がタむトルを蚭定しおいない限り、フックの `title` は mod の名前になりたす |

197 197 

198Claude Code は、タヌミナルず、Claude Desktop、VS Code 拡匵機胜、その他 Agent SDK を通じお暩限リク゚ストに応答するホストずで、`permission_prompt` のタむミングを異なる方法で蚈枬したす。䞡方のタむミングに぀いおは、[各通知タむプが発火するタむミング](https://code.claude.com/docs/ja/hooks.md#notification)を参照しおください。198Claude Code は、タヌミナルず、Claude Desktop、VS Code 拡匵機胜、および Agent SDK を通じお暩限リク゚ストに応答するその他のホストずで、`permission_prompt` のタむミングを異なる方法で蚈枬したす。䞡方のタむミングに぀いおは、[各通知タむプが発火するタむミング](https://code.claude.com/docs/ja/hooks.md#notification)を参照しおください。

199 199 

200`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled` の matcher には Claude Code v2.1.234 以降が必芁です。200`quota_auto_resume_fired`、`quota_auto_resume_stale`、`quota_auto_resume_disabled` の各 matcher には Claude Code v2.1.234 以降が必芁です。

201 201 

202タヌミナルセッションでは、サンドボックス化されたコマンドのネットワヌクリク゚ストに察する `permission_prompt` には Claude Code v2.1.246 以降が必芁です。202タヌミナルセッションでは、サンドボックス化されたコマンドのネットワヌクリク゚ストに察する `permission_prompt` には Claude Code v2.1.246 以降が必芁です。

203 203 

204チヌムメむトのタヌミナルセットアップに関する質問に察する `agent_needs_input` には Claude Code v2.1.248 以降が必芁です。204チヌムメむトのタヌミナル蚭定に関する質問に察する `agent_needs_input` には Claude Code v2.1.248 以降が必芁です。

205 205 

206Claude Code のプロンプトで `/hooks` ず入力し、フックが `Notification` の䞋に衚瀺されるこずを確認したす。206Claude Code のプロンプトで `/hooks` ず入力し、フックが `Notification` の䞋に衚瀺されるこずを確認したす。

207 207 

208### 線集埌にコヌドを自動フォヌマットする208### 線集埌にコヌドを自動フォヌマットする

209 209 

210Claude が線集するすべおのファむルに察しお [Prettier](https://prettier.io/) を自動的に実行し、手䜜業なしでフォヌマットの䞀貫性を保ちたす。210Claude が線集するすべおのファむルに察しお [Prettier](https://prettier.io/) を自動的に実行し、手動で介入しなくおもフォヌマットの䞀貫性を保ちたす。

211 211 

212このフックは `Edit|Write` matcher を指定した `PostToolUse` むベントを䜿甚するため、ファむル線集ツヌルの埌にのみ実行されたす。コマンドは [`jq`](https://jqlang.org/) で線集されたファむルのパスを抜出し、Prettier に枡したす。これをプロゞェクトルヌトの `.claude/settings.json` に远加したす。212このフックは `Edit|Write` matcher を指定した `PostToolUse` むベントを䜿甚するため、ファむル線集ツヌルの埌にのみ実行されたす。コマンドは [`jq`](https://jqlang.org/) で線集されたファむルのパスを抜出し、Prettier に枡したす。これをプロゞェクトルヌトの `.claude/settings.json` に远加したす。

213 213 

229}229}

230```230```

231 231 

232フックをテストするには、JavaScript ファむルにシングルクォヌトの文字列を含む行を远加するよう Claude に䟝頌しおから、ファむルを開きたす。Prettier のデフォルト蚭定では、フックがそれらをダブルクォヌトに曞き換えたす。232フックをテストするには、シングルクォヌトの文字列を含む行を JavaScript ファむルに远加するよう Claude に䟝頌しおから、そのファむルを開きたす。Prettier のデフォルト蚭定では、フックがそれらをダブルクォヌトに曞き換えたす。

233 233 

234フックが成功した堎合、Claude Code は䌚話に䜕も衚瀺したせん。フックが実行されたこずを確認するには、線集されたファむルが再フォヌマットされおいるこずを確認するか、[フックの動䜜を確認する](#check-what-a-hook-did)を参照しおください。234フックが成功した堎合、Claude Code は䌚話に䜕も衚瀺したせん。フックが実行されたこずを確認するには、線集したファむルが再フォヌマットされおいるこずを確認するか、[フックが䜕をしたかを確認する](#check-what-a-hook-did)を参照しおください。

235 235 

236`Bash` コマンドによる曞き換えを含め、どのような方法で倉曎されおも特定のファむルを再フォヌマットするには、代わりに [FileChanged](https://code.claude.com/docs/ja/hooks.md#filechanged) フックを䜿甚したす。236`Bash` コマンドによる曞き換えを含め、特定のファむルがどのように倉曎されおも再フォヌマットするには、代わりに [FileChanged](https://code.claude.com/docs/ja/hooks.md#filechanged) フックを䜿甚したす。

237 237 

238> [!NOTE]238> [!NOTE]

239>239>

240> このペヌゞの Bash の䟋では、JSON の解析に `jq` を䜿甚しおいたす。macOS では `brew install jq`、Debian や Ubuntu では `apt-get install jq` でむンストヌルするか、[`jq` のダりンロヌド](https://jqlang.org/download/)を参照しおください。240> このペヌゞの Bash の䟋では、JSON の解析に `jq` を䜿甚しおいたす。macOS では `brew install jq`、Debian および Ubuntu では `apt-get install jq` でむンストヌルするか、[`jq` のダりンロヌド](https://jqlang.org/download/)を参照しおください。

241 241 

242### 保護されたファむルぞの線集をブロックする242### 保護されたファむルぞの線集をブロックする

243 243 

244Claude が `.env`、`package-lock.json`、`.git/` 内のファむルなど、機密性の高いファむルを倉曎しないようにしたす。Claude は線集がブロックされた理由を説明するフィヌドバックを受け取るため、アプロヌチを調敎できたす。244`.env`、`package-lock.json`、たたは `.git/` 内のファむルなど、機密性の高いファむルを Claude が倉曎しないようにしたす。Claude は線集がブロックされた理由を説明するフィヌドバックを受け取るため、アプロヌチを調敎できたす。

245 245 

246この䟋では、フックが呌び出す別のスクリプトファむルを䜿甚したす。スクリプトは察象のファむルパスを保護パタヌンのリストず照合し、終了コヌド 2 で終了しお線集をブロックしたす。246この䟋では、フックが呌び出す別のスクリプトファむルを䜿甚したす。スクリプトは察象のファむルパスを保護パタヌンのリストず照合し、終了コヌド 2 で終了しお線集をブロックしたす。

247 247 

281 281 

282**3. フックを登録する**282**3. フックを登録する**

283 283 

284`Edit` たたは `Write` ツヌルの呌び出しの前にスクリプトを実行する `PreToolUse` フックを `.claude/settings.json` に远加したす。284`Edit` たたは `Write` のツヌル呌び出しの前にスクリプトを実行する `PreToolUse` フックを `.claude/settings.json` に远加したす。

285 285 

286```json theme={null}286```json theme={null}

287{287{

303 303 

304**4. フックをテストする**304**4. フックをテストする**

305 305 

306`.env` ファむルにコメントを远加するよう Claude に䟝頌したす。Claude Code は線集が実行される前にそれをブロックし、スクリプトの `Blocked:` メッセヌゞをフィヌドバックずしお Claude に枡したす。306`.env` ファむルにコメントを远加するよう Claude に䟝頌したす。Claude Code は線集が実行される前にブロックし、スクリプトの `Blocked:` メッセヌゞをフィヌドバックずしお Claude に枡したす。

307 307 

308### コンテキスト圧瞮埌にコンテキストを再泚入する308### コンテキスト圧瞮埌にコンテキストを再泚入する

309 309 

310Claude のコンテキストりィンドりがいっぱいになるず、コンテキスト圧瞮によっお䌚話が芁玄され、空き領域が確保されたす。このずき重芁な詳现が倱われるこずがありたす。`compact` matcher を指定した `SessionStart` フックを䜿甚するず、圧瞮のたびに重芁なコンテキストを再泚入できたす。310Claude のコンテキストりィンドりがいっぱいになるず、コンテキスト圧瞮によっお䌚話が芁玄され、空き容量が確保されたす。これにより重芁な詳现が倱われるこずがありたす。`compact` matcher を指定した `SessionStart` フックを䜿甚しお、圧瞮のたびに重芁なコンテキストを再泚入したす。

311 311 

312Claude Code は、コマンドが stdout に曞き出したプレヌンテキストを Claude のコンテキストに远加したす。この䟋では、プロゞェクトの芏玄ず最近の䜜業を Claude に思い出させたす。これをプロゞェクトルヌトの `.claude/settings.json` に远加したす。312Claude Code は、コマンドが stdout に曞き蟌んだプレヌンテキストを Claude のコンテキストに远加したす。この䟋では、プロゞェクトの芏玄ず最近の䜜業を Claude にリマむンドしたす。これをプロゞェクトルヌトの `.claude/settings.json` に远加したす。

313 313 

314```json theme={null}314```json theme={null}

315{315{

329}329}

330```330```

331 331 

332`echo` は、最近のコミットを衚瀺する `git log --oneline -5` のように、動的な出力を生成する任意のコマンドに眮き換えられたす。セッション開始のたびにコンテキストを泚入する堎合は、代わりに [CLAUDE.md](https://code.claude.com/docs/ja/memory.md) の䜿甚を怜蚎しおください。環境倉数に぀いおは、リファレンスの [`CLAUDE_ENV_FILE`](https://code.claude.com/docs/ja/hooks#persist-environment-variables) を参照しおください。332`echo` は、最近のコミットを衚瀺する `git log --oneline -5` など、動的な出力を生成する任意のコマンドに眮き換えられたす。すべおのセッション開始時にコンテキストを泚入する堎合は、代わりに [CLAUDE.md](https://code.claude.com/docs/ja/memory.md) の䜿甚を怜蚎しおください。環境倉数に぀いおは、リファレンスの [`CLAUDE_ENV_FILE`](https://code.claude.com/docs/ja/hooks#persist-environment-variables) を参照しおください。

333 333 

334### 蚭定の倉曎を監査する334### 蚭定の倉曎を監査する

335 335 

336セッション䞭に蚭定ファむルやスキルファむルが倉曎されたタむミングを远跡したす。`ConfigChange` むベントは、倖郚プロセスや゚ディタヌが蚭定ファむルを倉曎したずきに発火するため、コンプラむアンスのために倉曎をログに蚘録したり、蚱可されおいない倉曎をブロックしたりできたす。336セッション䞭に蚭定ファむルやスキルファむルが倉曎されたタむミングを远跡したす。`ConfigChange` むベントは、倖郚プロセスや゚ディタが蚭定ファむルを倉曎したずきに発火するため、コンプラむアンスのために倉曎をログに蚘録したり、蚱可されおいない倉曎をブロックしたりできたす。

337 337 

338この䟋では、各倉曎を監査ログに远蚘したす。これを `~/.claude/settings.json` に远加したす。338この䟋では、各倉曎を監査ログに远蚘したす。これを `~/.claude/settings.json` に远加したす。

339 339 

355}355}

356```356```

357 357 

358matcher は蚭定の皮類でフィルタリングしたす。指定できる倀は `user_settings`、`project_settings`、`local_settings`、`policy_settings`、`skills` です。倉曎が反映されないようにブロックするには、終了コヌド 2 で終了するか、`{"decision": "block"}` を返したす。入力スキヌマの党䜓に぀いおは、[ConfigChange リファレンス](https://code.claude.com/docs/ja/hooks.md#configchange)を参照しおください。358matcher は蚭定の皮類でフィルタリングしたす。`user_settings`、`project_settings`、`local_settings`、`policy_settings`、`skills` のいずれかです。倉曎が反映されないようにブロックするには、終了コヌド 2 で終了するか、`{"decision": "block"}` を返したす。入力スキヌマの党䜓に぀いおは、[ConfigChange リファレンス](https://code.claude.com/docs/ja/hooks.md#configchange)を参照しおください。

359 359 

360フックが倉曎を蚘録しおいるこずを確認するには、セッションの実行䞭に別の゚ディタヌで蚭定ファむルを線集しおから、`~/claude-config-audit.log` を開きたす。フックは倉曎ごずに、タむムスタンプ、゜ヌス、ファむルパスを含む JSON を 1 行远蚘したす。360フックが倉曎を蚘録しおいるこずを確認するには、セッションの実行䞭に別の゚ディタで蚭定ファむルを線集しおから、`~/claude-config-audit.log` を開きたす。フックは倉曎ごずに、タむムスタンプ、゜ヌス、ファむルパスを含む JSON を 1 行远蚘したす。

361 361 

362### ディレクトリやファむルが倉曎されたずきに環境を再読み蟌みする362### ディレクトリやファむルが倉曎されたずきに環境を再読み蟌みする

363 363 

364プロゞェクトによっおは、どのディレクトリにいるかに応じお異なる環境倉数を蚭定したす。[direnv](https://direnv.net/) などのツヌルはシェルでこれを自動的に行いたすが、Claude の Bash ツヌルはそれらの倉曎を自動的には取り蟌みたせん。364プロゞェクトによっおは、どのディレクトリにいるかに応じお異なる環境倉数を蚭定したす。[direnv](https://direnv.net/) などのツヌルはシェルでこれを自動的に行いたすが、Claude の Bash ツヌルはそれらの倉曎を自動的には取り蟌みたせん。

365 365 

366`SessionStart` フックず `CwdChanged` フックを組み合わせるず、この問題を解決できたす。`SessionStart` は起動したディレクトリの倉数を読み蟌み、`CwdChanged` は Claude がディレクトリを倉曎するたびに倉数を再読み蟌みしたす。どちらも `CLAUDE_ENV_FILE` に曞き蟌み、Claude Code はこれを各 Bash コマンドの前にスクリプトのプリアンブルずしお実行したす。これを `~/.claude/settings.json` に远加したす。366`SessionStart` フックず `CwdChanged` フックを組み合わせるず、この問題を解決できたす。`SessionStart` は起動時のディレクトリの倉数を読み蟌み、`CwdChanged` は Claude がディレクトリを倉曎するたびに倉数を再読み蟌みしたす。どちらも `CLAUDE_ENV_FILE` に曞き蟌み、Claude Code はこれを各 Bash コマンドの前にスクリプトのプリアンブルずしお実行したす。これを `~/.claude/settings.json` に远加したす。

367 367 

368```json theme={null}368```json theme={null}

369{369{

392}392}

393```393```

394 394 

395`.envrc` があるディレクトリごずに䞀床 `direnv allow` を実行し、direnv がそのファむルを読み蟌めるようにしたす。direnv の代わりに devbox や nix を䜿甚しおいる堎合は、`direnv export bash` の代わりに `devbox shellenv` たたは `devbox global shellenv` を䜿甚すれば、同じパタヌンが機胜したす。395`.envrc` があるディレクトリごずに `direnv allow` を䞀床実行し、direnv がそれを読み蟌めるように蚱可したす。direnv の代わりに devbox や nix を䜿甚しおいる堎合は、`direnv export bash` の代わりに `devbox shellenv` たたは `devbox global shellenv` を䜿甚すれば同じパタヌンが䜿えたす。

396 396 

397ディレクトリの倉曎のたびではなく特定のファむルに反応させるには、監芖するファむル名を `|` で区切っお列挙した `matcher` を指定しお `FileChanged` を䜿甚したす。監芖リストを構築する際、Claude Code はこの倀を正芏衚珟ずしお評䟡するのではなく、リテラルのファむル名に分割したす。同じ倀が、ファむルの倉曎時にどのフックグルヌプを実行するかのフィルタリングにも䜿われる仕組みに぀いおは、[FileChanged](https://code.claude.com/docs/ja/hooks.md#filechanged) を参照しおください。この䟋では、䜜業ディレクトリ内の `.envrc` ず `.env` を監芖したす。397ディレクトリの倉曎のたびではなく特定のファむルに反応させるには、監芖するファむル名を `|` で区切っお列挙した `matcher` ずずもに `FileChanged` を䜿甚したす。監芖リストを䜜成する際、Claude Code はこの倀を正芏衚珟ずしお評䟡するのではなく、リテラルのファむル名に分割したす。ファむルが倉曎されたずきに実行されるフックグルヌプを同じ倀がどのようにフィルタリングするかに぀いおは、[FileChanged](https://code.claude.com/docs/ja/hooks.md#filechanged) を参照しおください。この䟋では、䜜業ディレクトリ内の `.envrc` ず `.env` を監芖したす。

398 398 

399```json theme={null}399```json theme={null}

400{400{

414}414}

415```415```

416 416 

417入力スキヌマ、`watchPaths` の出力、`CLAUDE_ENV_FILE` の詳现に぀いおは、[CwdChanged](https://code.claude.com/docs/ja/hooks.md#cwdchanged) ず [FileChanged](https://code.claude.com/docs/ja/hooks.md#filechanged) のリファレンス項目を参照しおください。417入力スキヌマ、`watchPaths` の出力、`CLAUDE_ENV_FILE` の詳现に぀いおは、[CwdChanged](https://code.claude.com/docs/ja/hooks.md#cwdchanged) および [FileChanged](https://code.claude.com/docs/ja/hooks.md#filechanged) のリファレンス項目を参照しおください。

418 418 

419### 特定の暩限プロンプトを自動承認する419### 特定の暩限プロンプトを自動承認する

420 420 

421垞に蚱可しおいるツヌル呌び出しに぀いお、承認ダむアログをスキップしたす。この䟋では、Claude が蚈画の提瀺を終えお続行の承認を求める際に呌び出すツヌルである `ExitPlanMode` を自動承認するため、蚈画が準備できるたびにプロンプトが衚瀺されるこずはなくなりたす。421垞に蚱可しおいるツヌル呌び出しに぀いお、承認ダむアログをスキップしたす。この䟋では、Claude がプランの提瀺を終えお続行の可吊を尋ねるずきに呌び出すツヌルである `ExitPlanMode` を自動承認するため、プランの準備ができるたびにプロンプトが衚瀺されるこずはありたせん。

422 422 

423䞊蚘の終了コヌドの䟋ずは異なり、自動承認を行うには、フックが JSON の決定を stdout に曞き出す必芁がありたす。Claude Code は暩限を求めようずするずきに `PermissionRequest` フックを実行し、フックが `"behavior": "allow"` を返した堎合は、ナヌザヌに代わっおリク゚ストに応答したす。423䞊蚘の終了コヌドの䟋ずは異なり、自動承認ではフックが JSON の決定を stdout に曞き蟌む必芁がありたす。Claude Code はナヌザヌに暩限を求めようずするずきに `PermissionRequest` フックを実行し、フックが `"behavior": "allow"` を返すず、Claude Code がナヌザヌに代わっおリク゚ストに応答したす。

424 424 

425matcher によっおフックのスコヌプが `ExitPlanMode` のみに限定されるため、他のプロンプトには圱響したせん。これを `~/.claude/settings.json` に远加したす。425matcher によっおフックのスコヌプが `ExitPlanMode` のみに限定されるため、他のプロンプトには圱響したせん。これを `~/.claude/settings.json` に远加したす。

426 426 

442}442}

443```443```

444 444 

445フックが承認するず、Claude Code は plan モヌドを終了し、plan モヌドに入る前に有効だった暩限モヌドを埩元したす。トランスクリプトには、ダむアログが衚瀺されるはずだった堎所に「Allowed by PermissionRequest hook」ず衚瀺されたす。フックを経由する堎合は垞に珟圚の䌚話が維持されたす。ダむアログのようにコンテキストをクリアしお新しい実装セッションを開始するこずはできたせん。445フックが承認するず、Claude Code は plan モヌドを終了し、plan モヌドに入る前に有効だった暩限モヌドを埩元したす。トランスクリプトには、ダむアログが衚瀺されるはずだった堎所に「Allowed by PermissionRequest hook」ず衚瀺されたす。フック経由の堎合は垞に珟圚の䌚話が維持されたす。ダむアログのようにコンテキストをクリアしお新しい実装セッションを開始するこずはできたせん。

446 446 

447代わりに特定の暩限モヌドを蚭定するには、フックの出力に `setMode` ゚ントリを含む `updatedPermissions` 配列を含めたす。`mode` の倀には `default`、`acceptEdits`、`bypassPermissions` などの任意の暩限モヌドを指定し、`destination: "session"` を指定するず珟圚のセッションにのみ適甚されたす。447代わりに特定の暩限モヌドを蚭定するには、フックの出力に `setMode` ゚ントリを含む `updatedPermissions` 配列を含めるこずができたす。`mode` の倀には `default`、`acceptEdits`、`bypassPermissions` などの任意の暩限モヌドを指定でき、`destination: "session"` を指定するず珟圚のセッションにのみ適甚されたす。

448 448 

449> [!NOTE]449> [!NOTE]

450>450>

451> `bypassPermissions` は、バむパスモヌドがすでに利甚可胜な状態でセッションを開始した堎合にのみ適甚されたす。具䜓的には、`--dangerously-skip-permissions`、`--permission-mode bypassPermissions`、`--allow-dangerously-skip-permissions`、たたは[ナヌザヌ蚭定、`--settings`、管理蚭定](https://code.claude.com/docs/ja/settings-reference#permissions-defaultmode)での `permissions.defaultMode: "bypassPermissions"` のいずれかを䜿甚した堎合です。[`permissions.disableBypassPermissionsMode`](https://code.claude.com/docs/ja/permissions#managed-settings) によっおバむパスモヌドが無効化されおいる堎合や、[制限モヌド](https://code.claude.com/docs/ja/cli-reference.md#cli-flags)でセッションを開始した堎合は適甚されたせん。451> `bypassPermissions` は、バむパスモヌドがすでに利甚可胜な状態でセッションを開始した堎合にのみ適甚されたす。具䜓的には、`--dangerously-skip-permissions`、`--permission-mode bypassPermissions`、`--allow-dangerously-skip-permissions`、たたは[ナヌザヌ蚭定、`--settings`、管理蚭定](https://code.claude.com/docs/ja/settings-reference#permissions-defaultmode)での `permissions.defaultMode: "bypassPermissions"` のいずれかです。[`permissions.disableBypassPermissionsMode`](https://code.claude.com/docs/ja/permissions#managed-settings) によっおバむパスモヌドが無効化されおいる堎合や、[制限モヌド](https://code.claude.com/docs/ja/cli-reference.md#cli-flags)でセッションを開始した堎合は適甚されたせん。

452>452>

453> Claude Code がこれを `defaultMode` ずしお保存するこずはありたせん。453> Claude Code がこれを `defaultMode` ずしお保存するこずはありたせん。

454 454 

455セッションを `acceptEdits` に切り替えるには、フックが次の JSON を stdout に曞き出したす。455セッションを `acceptEdits` に切り替えるには、フックが次の JSON を stdout に曞き蟌みたす。

456 456 

457```json theme={null}457```json theme={null}

458{458{

468}468}

469```469```

470 470 

471matcher はできるだけ限定的にしおください。`.*` でマッチさせたり matcher を空のたたにしたりするず、ファむルの曞き蟌みやシェルコマンドを含む、すべおのツヌルの暩限プロンプトが自動承認されおしたいたす。決定フィヌルドの党䜓に぀いおは、[PermissionRequest リファレンス](https://code.claude.com/docs/ja/hooks.md#permissionrequest-decision-control)を参照しおください。471matcher はできるだけ狭く保っおください。`.*` でマッチさせたり matcher を空のたたにしたりするず、ファむルの曞き蟌みやシェルコマンドを含むすべおのツヌルの暩限プロンプトが自動承認されおしたいたす。決定フィヌルドの党䜓に぀いおは、[PermissionRequest リファレンス](https://code.claude.com/docs/ja/hooks.md#permissionrequest-decision-control)を参照しおください。

472 472 

473## フックの仕組み473## フックの仕組み

474 474 

interactive-mode.md +3 −3

Details

332* タヌミナル、デスクトップアプリ、たたは VS Code 拡匵機胜から䜜業するロヌカルセッションでのバックグラりンドコマンドには時間制限がありたせん。`-p` 実行やクラりドセッションなど、無人で実行されるセッションでは、Claude Code はバックグラりンドコマンドを[時間制限](https://code.claude.com/docs/ja/tools-reference.md#time-limit-for-background-commands)に達した時点で停止したす332* タヌミナル、デスクトップアプリ、たたは VS Code 拡匵機胜から䜜業するロヌカルセッションでのバックグラりンドコマンドには時間制限がありたせん。`-p` 実行やクラりドセッションなど、無人で実行されるセッションでは、Claude Code はバックグラりンドコマンドを[時間制限](https://code.claude.com/docs/ja/tools-reference.md#time-limit-for-background-commands)に達した時点で停止したす

333* フォアグラりンド[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md#run-subagents-in-foreground-or-background)が開始したバックグラりンドコマンドは、そのサブ゚ヌゞェントの実行が終了するずきに終了したす。完了、倱敗、たたは䞭断されたかどうかに関わらず。ツヌル参照の[バックグラりンドコマンドが停止するずき](https://code.claude.com/docs/ja/tools-reference.md#when-a-background-command-stops)を参照しおください333* フォアグラりンド[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md#run-subagents-in-foreground-or-background)が開始したバックグラりンドコマンドは、そのサブ゚ヌゞェントの実行が終了するずきに終了したす。完了、倱敗、たたは䞭断されたかどうかに関わらず。ツヌル参照の[バックグラりンドコマンドが停止するずき](https://code.claude.com/docs/ja/tools-reference.md#when-a-background-command-stops)を参照しおください

334 334 

335バックグラりンドコマンドをオフにするには、[`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ja/env-vars#variables) 環境倉数を `1` に蚭定しおください。これを蚭定するず、バックグラりンドサブ゚ヌゞェント、バックグラりンドのフォヌクされたスキル、および `Ctrl+B` も䜿甚できなくなりたす。[bare モヌド](https://code.claude.com/docs/ja/headless.md#start-faster-with-bare-mode)で開始しおも同じ効果がありたす。335バックグラりンドコマンドをオフにするには、[`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ja/env-vars#variables) 環境倉数を `1` に蚭定しおください。これを蚭定するず、`Ctrl+B` ショヌトカットや、[スキルのバックグラりンド実行](https://code.claude.com/docs/ja/skills.md#run-skills-in-a-subagent)などの[その他のバックグラりンド機胜](https://code.claude.com/docs/ja/env-vars.md#variables)も䜿甚できなくなりたす。[bare モヌド](https://code.claude.com/docs/ja/headless.md#start-faster-with-bare-mode)で開始しおも同じ効果がありたす。

336 336 

337**䞀般的なバックグラりンド実行コマンド**337**䞀般的なバックグラりンド実行コマンド**

338 338 

738 738 

739```text theme={null}739```text theme={null}

740Usage limit reached · limit resets 3:45pm740Usage limit reached · limit resets 3:45pm

741Continuing automatically at 3:45pm · esc to cancel741Continuing automatically at 3:45pm · Esc to cancel

742```742```

743 743 

744いずれの行にも、これらの文蚀の埌に远加の内容が続く堎合がありたす。たずえば、1 行目にはヘルプリンク、2 行目には `/usage-credits to continue now` が衚瀺されるこずがありたす。埅機が自動的に開始された堎合は、䌚話にも `Usage limit reached · continuing automatically at 3:45pm · esc to cancel` ずいう行が蚘録されたす。744いずれの行にも、これらの文蚀の埌に远加の内容が続く堎合がありたす。たずえば、1 行目にはヘルプリンク、2 行目には `/usage-credits to continue now` が衚瀺されるこずがありたす。埅機が自動的に開始された堎合は、䌚話にも `Usage limit reached · continuing automatically at 3:45pm · esc to cancel` ずいう行が蚘録されたす。

745 745 

746セッションをオヌプンのたたにしおおいおください。その埌の動䜜は、埅機の終わり方によっお異なりたす。746セッションをオヌプンのたたにしおおいおください。その埌の動䜜は、埅機の終わり方によっお異なりたす。

747 747 

748* **リセット時**2 行目が `Continuing shortly · esc to cancel` に倉わりたす。その埌、䌚話に `Usage limit reset · continuing automatically` が衚瀺され、Claude Code は Claude に停止した堎所からタスクを再開するよう促したす。最埌のメッセヌゞは再送信されたせん。748* **リセット時**2 行目が `Continuing shortly · Esc to cancel` に倉わりたす。その埌、䌚話に `Usage limit reset · Continuing automatically` が衚瀺され、Claude Code は Claude に停止した堎所からタスクを再開するよう促したす。最埌のメッセヌゞは再送信されたせん。

749* **コンピュヌタヌがスリヌプした埌**玄 30 分以䞊スリヌプし、スリヌプ䞭に制限がリセットされた堎合、1 行目は `Your usage limit has reset`、2 行目は `Press enter to continue` ず衚瀺されたす。`Enter` キヌを抌しお続行しおください。スリヌプが短かった堎合や、リセット前にスリヌプが終了した堎合は、Claude Code が自動的に続行したす。749* **コンピュヌタヌがスリヌプした埌**玄 30 分以䞊スリヌプし、スリヌプ䞭に制限がリセットされた堎合、1 行目は `Your usage limit has reset`、2 行目は `Press enter to continue` ず衚瀺されたす。`Enter` キヌを抌しお続行しおください。スリヌプが短かった堎合や、リセット前にスリヌプが終了した堎合は、Claude Code が自動的に続行したす。

750* **早期**埅機䞭に `/usage-credits` で[䜿甚クレゞットを远加](https://code.claude.com/docs/ja/costs.md#add-usage-credits-to-your-subscription)したり、`/upgrade` の埌に再床サむンむンしたり、`/model` でモデルを切り替えたりした堎合、Claude Code は䜿甚可胜な䜿甚量があるかどうかを確認し、ある堎合はすぐに続行したす。ブラりザで自分で行ったアップグレヌドたたは賌入の埌は確認されたせん。[`opusplan`](https://code.claude.com/docs/ja/model-config#opusplan-model-setting) および他のモデル蚭定で異なるモデルでプランモヌドを実行する堎合、Claude Code はリセットを埅機したす。750* **早期**埅機䞭に `/usage-credits` で[䜿甚クレゞットを远加](https://code.claude.com/docs/ja/costs.md#add-usage-credits-to-your-subscription)したり、`/upgrade` の埌に再床サむンむンしたり、`/model` でモデルを切り替えたりした堎合、Claude Code は䜿甚可胜な䜿甚量があるかどうかを確認し、ある堎合はすぐに続行したす。ブラりザで自分で行ったアップグレヌドたたは賌入の埌は確認されたせん。[`opusplan`](https://code.claude.com/docs/ja/model-config#opusplan-model-setting) および他のモデル蚭定で異なるモデルでプランモヌドを実行する堎合、Claude Code はリセットを埅機したす。

751 751 

managed-settings.md +90 −80

Details

120* **[`extraKnownMarketplaces`](https://code.claude.com/docs/ja/settings-reference#extraknownmarketplaces) ず [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers)**: 同じ名前を持぀埌の゚ントリが前の゚ントリ党䜓を眮き換えたす120* **[`extraKnownMarketplaces`](https://code.claude.com/docs/ja/settings-reference#extraknownmarketplaces) ず [`managedMcpServers`](https://code.claude.com/docs/ja/settings-reference#managedmcpservers)**: 同じ名前を持぀埌の゚ントリが前の゚ントリ党䜓を眮き換えたす

121* **[`modelPicker`](https://code.claude.com/docs/ja/settings-reference#modelpicker)**: 埌のラむンナップが前のラむンナップ党䜓を眮き換えたす121* **[`modelPicker`](https://code.claude.com/docs/ja/settings-reference#modelpicker)**: 埌のラむンナップが前のラむンナップ党䜓を眮き換えたす

122 122 

123## Claude Code が管理された゜ヌスを組み合わせる方法123## Claude Code が管理゜ヌスを組み合わせる方法

124 124 

125組織が同じマシンに耇数の管理された゜ヌスを配信する堎合、[`managedSourcesBehavior`](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior) キヌは Claude Code が他の゜ヌスに察しお䜕を行うかを決定したす。125組織が同じマシンに耇数の管理゜ヌスを配信する堎合、[`managedSourcesBehavior`](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior) キヌによっお、Claude Code がそれ以倖の゜ヌスをどう扱うかが決たりたす。

126 126 

127* **`"first-wins"`、デフォルト**: Claude Code は、少なくずも 1 ぀のポリシヌキヌを配信する最も高いランクの゜ヌスを䜿甚し、[すべおの管理者゜ヌスから読み取られるキヌ](#keys-read-from-every-admin-source)内のキヌを陀いお、残りを無芖したす。Claude Code はスキップする゜ヌスに぀いお譊告を衚瀺したせん。`/status` は[䜿甚した゜ヌスずスキップした゜ヌスに名前を付けたす](#read-the-source-in-/status)。127* **`"first-wins"`デフォルト**Claude Code は、少なくずも 1 ぀のポリシヌキヌを配信する最䞊䜍の゜ヌスを䜿甚し、残りの゜ヌスはマヌゞせずに無芖したす。ただし、[すべおの管理゜ヌスから読み取られるキヌ](#keys-read-from-every-admin-source)に挙げたキヌは䟋倖です。Claude Code はスキップした゜ヌスに぀いお譊告を衚瀺したせん。`/status` は[䜿甚した゜ヌスずスキップした゜ヌスを瀺したす](#read-the-source-in-/status)。

128* **`"merge"`**: Claude Code はポリシヌキヌを配信するすべおの管理者゜ヌスを適甚し、キヌの皮類ごずに組み合わせたす。ほずんどのキヌでは高いランクの゜ヌスの倀が適甚され、リストは和集合、ロックは最も厳しい倀を取りたす。[すべおの管理された゜ヌスを構成する](#compose-every-managed-source)では、キヌを蚭定する堎所ず各皮類のキヌがどのように組み合わされるかを説明しおいたす。Claude Code v2.1.242 以降が必芁です。128* **`"merge"`**Claude Code はポリシヌキヌを配信するすべおの管理゜ヌスを適甚し、キヌの皮類ごずに組み合わせたす。ほずんどのキヌでは䞊䜍の゜ヌスの倀が適甚され、リストは和集合になり、ロックは最も厳しい倀を取りたす。このキヌを蚭定する堎所ず、各皮類のキヌの組み合わせ方に぀いおは、[すべおの管理゜ヌスを組み合わせる](#compose-every-managed-source)を参照しおください。Claude Code v2.1.242 以降が必芁です。

129 129 

130䞡方の蚭定は同じ方法で゜ヌスをランク付けしたす。これらの甚語はこのセクション党䜓で繰り返されたす。130どちらの蚭定でも、゜ヌスの順䜍付けは同じです。このセクションでは次の甚語が繰り返し登堎したす。

131 131 

132* **ポリシヌキヌ**: 2 ぀の制埡キヌ[`wslInheritsWindowsSettings`](https://code.claude.com/docs/ja/settings-reference#wslinheritswindowssettings) ず [`managedSourcesBehavior`](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior)以倖のすべおの蚭定キヌ。これらのキヌのみを含む管理蚭定ファむルたたは MDM ポリシヌはカりントされず、Claude Code は次の゜ヌスに移動したす。132* **ポリシヌキヌ**2 ぀の制埡キヌ、[`wslInheritsWindowsSettings`](https://code.claude.com/docs/ja/settings-reference#wslinheritswindowssettings) ず [`managedSourcesBehavior`](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior) 以倖のすべおの蚭定キヌです。これらのキヌしか含たない管理蚭定ファむルや MDM ポリシヌはカりントされず、Claude Code は次の゜ヌスに進みたす。

133* **管理者゜ヌス**: 以䞋の最初の 3 ぀の゜ヌスの 1 ぀。HKCU レゞストリはナヌザヌが曞き蟌み可胜であり、1 ぀ではありたせん。133* **管理゜ヌス**以䞋の最初の 3 ぀の゜ヌスのいずれかです。HKCU レゞストリはナヌザヌが曞き蟌み可胜であり、管理゜ヌスには含たれたせん。

134 134 

135Claude Code は、最初に最優先床の順で゜ヌスをチェックしたす。135Claude Code は、優先床の高い順に次の順序で゜ヌスを確認したす。

136 136 

1371. リモヌト蚭定。claude.ai から[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)ずしお、たたは[Claude アプリゲヌトりェむ](https://code.claude.com/docs/ja/claude-apps-gateway)によっお配信されたす。Claude Code は、セッションが[適栌な認蚌情報](https://code.claude.com/docs/ja/server-managed-settings.md#platform-availability)で Anthropic の API に盎接認蚌する堎合、`/login` でゲヌトりェむにサむンむンする堎合、たたは[そのセッションに蚭定を提䟛する](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#apply-code-settings-in-the-code-tab)ゲヌトりェむの背埌で Claude Desktop の Code タブで実行される堎合にのみ、この゜ヌスをフェッチしたす。他のプロバむダヌ、たたは `ANTHROPIC_BASE_URL` が Anthropic の API 以倖を指す堎合、次の゜ヌスから開始したす1371. リモヌト蚭定。claude.ai から[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)ずしお、たたは [Claude apps ゲヌトりェむ](https://code.claude.com/docs/ja/claude-apps-gateway)によっお配信されたす。Claude Code がこの゜ヌスを取埗するのは、セッションが[察象ずなる認蚌情報](https://code.claude.com/docs/ja/server-managed-settings.md#platform-availability)で Anthropic の API に盎接認蚌する堎合、`/login` でゲヌトりェむにサむンむンする堎合、たたは[そのセッションに蚭定を提䟛する](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#apply-code-settings-in-the-code-tab)ゲヌトりェむの背埌で Claude Desktop の Code タブで実行される堎合のみです。他のプロバむダヌの堎合、たたは `ANTHROPIC_BASE_URL` が Anthropic の API 以倖を指しおいる堎合は、次の゜ヌスから開始したす

1382. MDM たたは OS レベルのポリシヌ: macOS plist たたは HKLM レゞストリキヌ1382. MDM たたは OS レベルのポリシヌmacOS の plist たたは HKLM レゞストリキヌ

1393. 管理蚭定ファむル、`managed-settings.d/*.json` ず `managed-settings.json` をマヌゞしたもの1393. 管理蚭定ファむル。`managed-settings.d/*.json` ず `managed-settings.json` がマヌゞされたもの

1404. Windows 䞊の HKCU レゞストリ、および WSL 䞊で HKLM レゞストリたたは Windows 管理蚭定ファむルが [`wslInheritsWindowsSettings`](https://code.claude.com/docs/ja/settings-reference#wslinheritswindowssettings) をオンにし、HKCU 倀もそれを蚭定しおいる堎合の HKCU レゞストリ。Claude Code は、[それより䞊に管理者ドキュメントが存圚せず](#present-admin-documents)、[ホスト提䟛の芪蚭定](#let-an-embedding-host-add-policy)が制限的なキヌを提䟛しない堎合にのみこれを読み取りたす1404. HKCU レゞストリ。Windows の堎合、および WSL では HKLM レゞストリたたは Windows の管理蚭定ファむルが [`wslInheritsWindowsSettings`](https://code.claude.com/docs/ja/settings-reference#wslinheritswindowssettings) をオンにし、か぀ HKCU の倀でもそれが蚭定されおいる堎合です。Claude Code がこれを読み取るのは、[それより䞊䜍に管理ドキュメントが存圚せず](#present-admin-documents)、か぀[ホストが提䟛する芪蚭定](#let-an-embedding-host-add-policy)が制限的なキヌを提䟛しおいない堎合のみです

141 141 

142このダむアグラムはランク付けを瀺し、どちらの蚭定でも Claude Code が最初の 3 ぀の゜ヌスから読み取るクロス゜ヌスキヌの䟋を瀺しおいたす。142次の図は、この順䜍付けず、どちらの蚭定でも Claude Code が最初の 3 ぀の゜ヌスから読み取る゜ヌス暪断キヌの䟋を瀺しおいたす。

143 143 

144![リモヌト蚭定から䞊郚を通じお MDM、管理蚭定ファむル、および䞋郚の HKCU レゞストリにランク付けされた 4 ぀の管理蚭定゜ヌスを瀺すダむアグラム。デフォルトではポリシヌキヌを持぀最初の゜ヌスがポリシヌを提䟛し、残りはスキップされたす。managedSourcesBehavior を merge に蚭定するず、ポリシヌキヌを持぀すべおの管理者゜ヌスが寄䞎し、キヌの皮類ごずに組み合わされ、HKCU レゞストリは陀倖されたす。サむドパネルは、サンドボックスロック、forceRemoteSettingsRefresh、および倉数ごずの env マヌゞなどのクロス゜ヌスキヌが、HKCU レゞストリを陀倖するすべおの管理者゜ヌスから読み取られるこずを瀺しおいたす。](https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence.svg?fit=max\&auto=format\&n=zuWID2B-Rxm8DEC8\&q=85\&s=53f6be49f06eff48e01422c8ae1bc2e6)144![4 ぀の管理蚭定゜ヌスを、最䞊䜍のリモヌト蚭定から MDM、管理蚭定ファむルを経お最䞋䜍の HKCU レゞストリたで順䜍付けしお瀺した図。デフォルトでは、ポリシヌキヌを持぀最初の゜ヌスがポリシヌを提䟛し、残りはスキップされたす。managedSourcesBehavior を merge に蚭定するず、ポリシヌキヌを持぀すべおの管理゜ヌスがキヌの皮類ごずに組み合わされお反映され、HKCU レゞストリは察象倖のたたです。サむドパネルには、サンドボックスのロック、forceRemoteSettingsRefresh、倉数ごずの env マヌゞなどの゜ヌス暪断キヌが、HKCU レゞストリを陀くすべおの管理゜ヌスから読み取られるこずが瀺されおいたす。](https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence.svg?fit=max\&auto=format\&n=zuWID2B-Rxm8DEC8\&q=85\&s=53f6be49f06eff48e01422c8ae1bc2e6)

145 145 

146### 管理者ドキュメントが存圚するずみなされる堎合146### 管理ドキュメントが存圚するずみなされる堎合

147 147 

148[管理された゜ヌスのランク付け](#how-claude-code-combines-managed-sources)においお、Claude Code は、存圚する管理者ドキュメントの䞋にあるナヌザヌが曞き蟌み可胜な HKCU レゞストリを決しお適甚したせん。ドキュメントは次の堎合に存圚するずみなされたす。148[管理゜ヌスの順䜍付け](#how-claude-code-combines-managed-sources)においお、Claude Code は、存圚する管理ドキュメントの䞋䜍にあるナヌザヌ曞き蟌み可胜な HKCU レゞストリを適甚するこずはありたせん。ドキュメントは次の堎合に存圚するずみなされたす。

149 149 

150* ポリシヌキヌを `null` 以倖の倀に蚭定しおいる堎合Claude Code が読み取れない倀であっおも150* いずれかのポリシヌキヌを `null` 以倖の倀に蚭定しおいる堎合。Claude Code が読み取れない倀であっおも該圓したす

151* 存圚するものの読み取れない HKLM 倀、管理蚭定ファむル、たたは `managed-settings.d` ディレクトリである堎合151* 存圚するものの読み取れない HKLM の倀、管理蚭定ファむル、たたは `managed-settings.d` ディレクトリである堎合

152 152 

153WSL では、`/etc/claude-code` もナヌザヌが曞き蟌み可胜であり、[`wslInheritsWindowsSettings`](https://code.claude.com/docs/ja/settings-reference#wslinheritswindowssettings) ゚ントリに、Windows のドキュメントがそれより䞊に䜍眮する堎合が瀺されおいたす。153WSL では `/etc/claude-code` もナヌザヌが曞き蟌み可胜です。Windows のドキュメントがそれより䞊䜍になる条件に぀いおは、[`wslInheritsWindowsSettings`](https://code.claude.com/docs/ja/settings-reference#wslinheritswindowssettings) の項目を参照しおください。

154 154 

155### すべおの管理者゜ヌスから読み取られるキヌ155### すべおの管理゜ヌスから読み取られるキヌ

156 156 

157デフォルトの `"first-wins"` 蚭定では、Claude Code はほずんどのキヌを[遞択した゜ヌス](#how-claude-code-combines-managed-sources)からのみ読み取り、遞択した゜ヌスがそのキヌを蚭定しないたたにしおいる堎合でも、䜎いランクの゜ヌスの倀を無芖したす。157デフォルトの `"first-wins"` 蚭定では、Claude Code はほずんどのキヌを[遞択した゜ヌス](#how-claude-code-combines-managed-sources)からのみ読み取り、遞択した゜ヌスでそのキヌが未蚭定であっおも、䞋䜍の゜ヌスにある倀は無芖したす。

158 158 

159いく぀かのキヌは異なる動䜜をしたす。Claude Code はそれらをすべおの管理者゜ヌスから読み取るため、遞択した゜ヌスが蚭定しない堎合でも、䜎いランクの MDM ポリシヌたたは管理蚭定ファむルがそれらを蚭定できたす。Claude Code はナヌザヌが曞き蟌み可胜な HKCU レゞストリをそのスキャンから陀倖したす。HKCU が唯䞀の゜ヌスであり、ホストが芪蚭定を提䟛しない堎合、HKCU は遞択された゜ヌスのように適甚されたす。159いく぀かのキヌは異なる動䜜をしたす。Claude Code はこれらのキヌをすべおの管理゜ヌスから読み取るため、遞択した゜ヌスが蚭定しおいない堎合でも、䞋䜍の MDM ポリシヌや管理蚭定ファむルで蚭定できたす。Claude Code はナヌザヌ曞き蟌み可胜な HKCU レゞストリをこの走査の察象倖ずしたす。HKCU が唯䞀の゜ヌスであり、ホストが芪蚭定を提䟛しおいない堎合は、HKCU は遞択された他の゜ヌスず同様に適甚されたす。

160 160 

161クロス゜ヌスキヌには以䞋が含たれたす。161゜ヌス暪断キヌには次のものがありたす。

162 162 

163* `sandbox.network.allowManagedDomainsOnly` ず `sandbox.filesystem.allowManagedReadPathsOnly`: 任意の管理者゜ヌスの `true` がロックをオンにしたす。ロックがオンの間、Claude Code はロックするアロりリスト`sandbox.network.allowedDomains` ず `WebFetch(domain:...)` アロヌ ルの組み合わせ、たたは `sandbox.filesystem.allowRead`をすべおの管理者゜ヌスにたたがっお和集合にしたす。ロックがない堎合、Claude Code はアロりリストを他のキヌのように扱うため、`"first-wins"` では遞択されおいない管理者゜ヌスのアロりリストは無芖されたす。163* `sandbox.network.allowManagedDomainsOnly` ず `sandbox.filesystem.allowManagedReadPathsOnly`いずれかの管理゜ヌスで `true` が蚭定されおいるず、ロックがオンになりたす。ロックがオンの間、Claude Code はロック察象の蚱可リスト、぀たり `sandbox.network.allowedDomains` ず `WebFetch(domain:...)` 蚱可ルヌルの組み合わせ、たたは `sandbox.filesystem.allowRead` を、すべおの管理゜ヌスにわたっお和集合にしたす。ロックがない堎合、Claude Code は蚱可リストを他のキヌず同様に扱うため、`"first-wins"` では遞択されなかった管理゜ヌスの蚱可リストは無芖されたす

164* `allowAllClaudeAiMcps`164* `allowAllClaudeAiMcps`

165* `allowManagedMcpServersOnly`: 任意の管理者゜ヌスの `true` が MCP アロりリストロックをオンにしたす。ロックがオンの間、管理された `allowedMcpServers` リストは、1 ぀を蚭定する最も高いランクの管理者゜ヌスから取埗されたす。サヌバヌ管理リストは、䜎い゜ヌスのリストず組み合わせるのではなく、眮き換えたす。165* `allowManagedMcpServersOnly`いずれかの管理゜ヌスで `true` が蚭定されおいるず、MCP 蚱可リストのロックがオンになりたす。ロックがオンの間、管理された `allowedMcpServers` リストは、それを蚭定しおいる最䞊䜍の管理゜ヌスから取埗されたす。サヌバヌ管理のリストは、䞋䜍の゜ヌスのリストず組み合わされるのではなく、それを眮き換えたす。

166 166 

167 管理者゜ヌスがリストを蚭定しない堎合、[芪蚭定](#let-an-embedding-host-add-policy)がリストを提䟛しない限り、デニヌリストを通過するすべおのサヌバヌが読み蟌たれたす。167 どの管理゜ヌスもリストを蚭定しおいない堎合、[芪蚭定](#let-an-embedding-host-add-policy)がリストを提䟛しない限り、拒吊リストを通過するすべおのサヌバヌが読み蟌たれたす。

168 168 

169 ロックがない堎合、Claude Code は適甚する管理゜ヌスから `allowedMcpServers` を読み取るため、`"first-wins"` では遞択されおいない管理者゜ヌスのリストは無芖されたす。Claude Code v2.1.273 以降が必芁です。169 ロックがない堎合、Claude Code は適甚する管理゜ヌスから `allowedMcpServers` を読み取るため、`"first-wins"` では遞択されなかった管理゜ヌスのリストは無芖されたす。Claude Code v2.1.273 以降が必芁です

170* `deniedMcpServers` ず [`disableClaudeAiConnectors`](https://code.claude.com/docs/ja/settings-reference#disableclaudeaiconnectors): 任意の管理者゜ヌスの゚ントリたたは `true` が適甚されたす。Claude Code v2.1.273 以降が必芁です。170* `deniedMcpServers` ず [`disableClaudeAiConnectors`](https://code.claude.com/docs/ja/settings-reference#disableclaudeaiconnectors)いずれかの管理゜ヌスにある゚ントリたたは `true` が適甚されたす。Claude Code v2.1.273 以降が必芁です

171* サンドボックスバむナリパス `sandbox.bwrapPath` ず `sandbox.socatPath`171* サンドボックスのバむナリパス `sandbox.bwrapPath` ず `sandbox.socatPath`

172* サンドボックス `ripgrep` バむナリ、[`sandbox.ripgrep`](https://code.claude.com/docs/ja/settings-reference#sandbox-ripgrep)172* サンドボックスの `ripgrep` バむナリ、[`sandbox.ripgrep`](https://code.claude.com/docs/ja/settings-reference#sandbox-ripgrep)

173* `sandbox.filesystem.disabled` ず `sandbox.network.strictAllowlist`173* `sandbox.filesystem.disabled` ず `sandbox.network.strictAllowlist`

174* [`useAutoModeDuringPlan`](https://code.claude.com/docs/ja/settings-reference#useautomodeduringplan)、[`syncClaudeAiSkills`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiskills)、および [`syncClaudeAiPlugins`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiplugins)。任意の管理者゜ヌスの `false` が動䜜をオフにしたす。開発者のナヌザヌたたはロヌカル蚭定の `false` もそれをオフにしたす。各キヌは拒吊のみが可胜です。174* [`useAutoModeDuringPlan`](https://code.claude.com/docs/ja/settings-reference#useautomodeduringplan)、[`syncClaudeAiSkills`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiskills)、[`syncClaudeAiPlugins`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiplugins)。いずれかの管理゜ヌスからの `false` でその動䜜がオフになりたす。開発者のナヌザヌ蚭定たたはロヌカル蚭定の `false` でもオフになりたす。各キヌは拒吊するこずしかできたせん

175* [`enableArtifact`](https://code.claude.com/docs/ja/settings-reference#enableartifact)。任意の管理者゜ヌスの `false` が[Artifact ツヌル](https://code.claude.com/docs/ja/artifacts.md)をオフにしたす。開発者のナヌザヌ、プロゞェクト、たたはロヌカル蚭定の `false` もそれをオフにし、゜ヌスはそれをオンに戻したせん。[どの䞋䜍レベルの倀がただカりントされるか](https://code.claude.com/docs/ja/settings.md#exceptions-to-managed-settings-precedence)を参照しおください。Claude Code v2.1.242 以降が必芁です。175* [`enableArtifact`](https://code.claude.com/docs/ja/settings-reference#enableartifact)。いずれかの管理゜ヌスからの `false` で [Artifact ツヌル](https://code.claude.com/docs/ja/artifacts.md)がオフになりたす。開発者のナヌザヌ蚭定、プロゞェクト蚭定、たたはロヌカル蚭定の `false` でもオフになり、どの゜ヌスからも再びオンにするこずはできたせん。[䞋䜍レベルのどの倀が匕き続き有効か](https://code.claude.com/docs/ja/settings.md#exceptions-to-managed-settings-precedence)を参照しおください。Claude Code v2.1.242 以降が必芁です

176* [`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel)。任意の管理者゜ヌスの最も䜎いキャップが適甚されたす。開発者が自分の蚭定たたは `--settings` で䜎いキャップを蚭定する堎合、Claude Code はそれを適甚したす。゜ヌスはキャップを䞊げるこずはできたせん。Claude Code v2.1.267 以降が必芁です。176* [`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel)。いずれかの管理゜ヌスにある最も䜎い䞊限が適甚されたす。開発者が自身の蚭定たたは `--settings` でより䜎い䞊限を蚭定した堎合は、Claude Code はそちらを適甚したす。どの゜ヌスも䞊限を匕き䞊げるこずはできたせん。Claude Code v2.1.267 以降が必芁です

177* `attribution` のコミットトレヌラヌオプトアりト、たたは非掚奚の `includeCoAuthoredBy` から任意のティア177* 任意の階局からの、`attribution` たたは非掚奚の `includeCoAuthoredBy` におけるコミットトレヌラヌのオプトアりト

178* [`forceRemoteSettingsRefresh`](https://code.claude.com/docs/ja/server-managed-settings)178* [`forceRemoteSettingsRefresh`](https://code.claude.com/docs/ja/server-managed-settings)

179* `env`。管理者゜ヌス党䜓で倉数ごずにマヌゞされたす。各倉数は、それを定矩する最も高い優先床の゜ヌスから取埗されるため、䜎い゜ヌスは高い゜ヌスが蚭定しないたたにした倉数を埋めたす。いく぀かの倉数は独自のルヌルに埓いたす。[管理された゜ヌス党䜓のキヌごずの䟋倖](https://code.claude.com/docs/ja/server-managed-settings.md#per-key-exceptions-across-managed-sources)は各倉数に名前を付けたす。Claude Code v2.1.223 以降が必芁です。v2.1.223 より前では、Claude Code は遞択された゜ヌスの党䜓 `env` ブロックのみを適甚したした。179* `env`。管理゜ヌス党䜓で倉数ごずにマヌゞされたす。各倉数はそれを定矩しおいる最も優先床の高い゜ヌスから取埗されるため、䞊䜍の゜ヌスが未蚭定のたたにした倉数を䞋䜍の゜ヌスが補いたす。いく぀かの倉数は独自のルヌルに埓いたす。[管理゜ヌス間でのキヌごずの䟋倖](https://code.claude.com/docs/ja/server-managed-settings.md#per-key-exceptions-across-managed-sources)でそれぞれを挙げおいたす。Claude Code v2.1.223 以降が必芁です。v2.1.223 より前は、Claude Code は遞択した゜ヌスの `env` ブロック党䜓のみを適甚しおいたした

180 180 

181[ゲヌトりェむログむンキヌ](#choose-a-delivery-mechanism)は別のルヌルに埓いたす。Claude Code はサヌバヌ管理蚭定からそれらを読み取るこずはないため、サヌバヌ管理蚭定が遞択された゜ヌスである間、ポリシヌキヌを持぀マシン䞊の最も高いランクの管理者゜ヌスがそれらを提䟛したす。それより䞋にランク付けされた管理者゜ヌスの倀、たたは HKCU レゞストリの倀は無芖されたす。181[`allowedProviders`](https://code.claude.com/docs/ja/settings-reference#allowedproviders) には独自のルヌルがありたす。その項目のスコヌプに関する泚蚘で、マシンで蚭定されたリストがサヌバヌ管理のリストずどのように組み合わされるかを説明しおいたす。Claude Code v2.1.285 以降が必芁です。

182 182 

183[`allowedProviders`](https://code.claude.com/docs/ja/settings-reference#allowedproviders) には独自のルヌルがありたす。その゚ントリの Scope の泚蚘で、マシン䞊で蚭定されたリストがサヌバヌ管理のリストずどのように組み合わされるかを説明しおいたす。Claude Code v2.1.285 以降が必芁です。183管理゜ヌスが `allowManagedMcpServersOnly` たたは `allowedMcpServers` リストを蚭定しおいるものの、その倀が有効になっおいない堎合、`/status` ず `claude doctor` はその゜ヌスずキヌを衚瀺したす。

184 184 

185管理者゜ヌスが `allowManagedMcpServersOnly` たたは `allowedMcpServers` リストを蚭定し、その倀が実行䞭のものではない堎合、`/status` ず `claude doctor` はその゜ヌスずキヌに名前を付けたす。185#### どの管理゜ヌスがログむンキヌを提䟛するか

186 186 

187### すべおの管理された゜ヌスを構成する187MDM ポリシヌたたは管理蚭定ファむルがあるマシンでは、[リモヌト蚭定](#how-claude-code-combines-managed-sources)でも蚭定されおいるキヌであっおも、Claude Code はログむンキヌをそのポリシヌたたはファむルから取埗したす。claude.ai の管理コン゜ヌルからの蚭定はリモヌト蚭定であるため、[`forceLoginOrgUUID`](https://code.claude.com/docs/ja/settings-reference#forceloginorguuid) などのログむンキヌは MDM ポリシヌたたはファむルで蚭定しおください。

188 188 

189組織が配信するすべおの管理者゜ヌスを Claude Code に適甚させるには、デプロむする最も高いランクの゜ヌスで [`managedSourcesBehavior`](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior) を `"merge"` に蚭定したす。Claude Code はキヌたたはポリシヌキヌを持぀最も高いランクの゜ヌスからのみキヌを読み取るため、䜎い゜ヌスはそれ自䜓をそれより䞊の゜ヌスずのマヌゞにオプトむンするこずはできず、サヌバヌ管理蚭定を受け取らないマシンは MDM プロファむルにもキヌが必芁です。ナヌザヌが曞き蟌み可胜な HKCU レゞストリは別の゜ヌスずマヌゞされるこずはありたせん。Claude Code v2.1.242 以降が必芁です。189マシンに MDM ポリシヌず管理蚭定ファむルの䞡方がある堎合は、MDM ポリシヌを䜿甚しおください。そのポリシヌがいずれかの[ポリシヌキヌ](#how-claude-code-combines-managed-sources)を蚭定しおいる堎合、Claude Code は、[`managedSourcesBehavior: "merge"` の䞋でも](#compose-every-managed-source)、ファむル内のログむンキヌを無芖したす。

190 190 

191`"merge"` では、Claude Code は䜎い゜ヌスのリスト゚ントリ`permissions.allow` ルヌルやフック などをポリシヌに远加するため、最も高いランクより䞋にランク付けされたすべおの゜ヌスが管理者の制埡䞋にある堎合にのみオンにしたす。191ログむンキヌは次のずおりです。

192 192 

193この衚は、`"merge"` の䞋で Claude Code が各皮類のキヌをどのように組み合わせるかを瀺しおいたす。[`managedSourcesBehavior` ゚ントリ](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior)は 3 ぀の行のすべおのキヌに名前を付けたす。制限アロりリスト、党䜓で取埗される倀、および最も高いランクの゜ヌスからのみ読み取られるキヌ。193* `"claudeai"` たたは `"console"` に蚭定された `forceLoginOrgUUID` ず `forceLoginMethod`ポリシヌたたはファむルでいずれかのキヌが省略されおいる堎合は、リモヌト蚭定の倀が適甚されたす。すべおのクラむアントが v2.1.299 以降を実行するたでは、claude.ai の[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)でもこれらのキヌを蚭定しおください

194* [ゲヌトりェむのログむンキヌ](#choose-a-delivery-mechanism)Claude Code は、ゲヌトりェむぞのサむンむンにリモヌト蚭定の倀を䜿甚したせん

194 195 

195| キヌの皮類 | Claude Code がそれを組み合わせる方法 | 䟋 |196### すべおの管理゜ヌスを組み合わせる

197 

198組織が配信するすべおの管理゜ヌスを Claude Code に適甚させるには、デプロむする最䞊䜍の゜ヌスで [`managedSourcesBehavior`](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior) を `"merge"` に蚭定したす。Claude Code はこのキヌを、このキヌたたはポリシヌキヌのいずれかを含む最䞊䜍の゜ヌスからのみ読み取りたす。そのため、䞋䜍の゜ヌスが自らオプトむンしお䞊䜍の゜ヌスずマヌゞするこずはできず、サヌバヌ管理蚭定を䞀切受け取らないマシンでは MDM プロファむルにもこのキヌが必芁です。ナヌザヌ曞き蟌み可胜な HKCU レゞストリが他の゜ヌスずマヌゞされるこずはありたせん。Claude Code v2.1.242 以降が必芁です。

199 

200`"merge"` では、Claude Code は `permissions.allow` ルヌルやフックなど、䞋䜍の゜ヌスのリスト゚ントリをポリシヌに远加したす。そのため、最䞊䜍の゜ヌスより䞋䜍にあるすべおの゜ヌスが管理者の管理䞋にある堎合にのみ、これをオンにしおください。

201 

202次の衚は、`"merge"` で Claude Code が各皮類のキヌをどのように組み合わせるかを瀺しおいたす。[`managedSourcesBehavior` の項目](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior)では、制限甚の蚱可リスト、倀党䜓を取埗するもの、最䞊䜍の゜ヌスからのみ読み取られるキヌの 3 ぀の行に぀いお、すべおのキヌを挙げおいたす。

203 

204| キヌの皮類 | Claude Code での組み合わせ方 | 䟋 |

196| :- | :- | :- |205| :- | :- | :- |

197| リスト | すべおの゜ヌスからの゚ントリを組み合わせたす | `permissions.allow`、`hooks`、`sandbox.network.allowedDomains`、`deniedMcpServers`、`deniedModels` |206| リスト | すべおの゜ヌスの゚ントリを組み合わせたす | `permissions.allow`、`hooks`、`sandbox.network.allowedDomains`、`deniedMcpServers`、`deniedModels` |

198| ロック | 任意の゜ヌスが蚭定する最も厳しい倀を適甚したす。より緩い倀は最も高いランクの゜ヌスからのみ適甚されたす | `allowManagedHooksOnly`、`permissions.disableBypassPermissionsMode`、`crossSessionInbound`、`availableModelsMatch` |207| ロック | いずれかの゜ヌスが蚭定する最も厳しい倀を適甚したす。より緩い倀は最䞊䜍の゜ヌスからの堎合のみ適甚されたす | `allowManagedHooksOnly`、`permissions.disableBypassPermissionsMode`、`crossSessionInbound`、`availableModelsMatch` |

199| 制限アロりリスト | それを蚭定する最も高いランクの゜ヌスから党䜓でリストを取埗し、䜎い゜ヌスから゚ントリを远加したせん | `availableModels`、`allowedMcpServers`、`strictKnownMarketplaces`、`allowedChannelPlugins`、および `fallbackModel` チェヌン |208| 制限甚の蚱可リスト | それを蚭定しおいる最䞊䜍の゜ヌスからリスト党䜓を取埗し、䞋䜍の゜ヌスの゚ントリは远加したせん | `availableModels`、`allowedMcpServers`、`strictKnownMarketplaces`、`allowedChannelPlugins`、および `fallbackModel` チェヌン |

200| 党䜓で取埗される倀 | それを蚭定する最も高いランクの゜ヌスから党䜓で倀を取埗し、䜎い゜ヌスから゚ントリたたはフィヌルドを組み合わせたせん | `sandbox.credentials.awsPairs`、`sandbox.ripgrep` |209| 倀党䜓を取埗するもの | それを蚭定しおいる最䞊䜍の゜ヌスから倀党䜓を取埗し、䞋䜍の゜ヌスの゚ントリやフィヌルドは組み合わせたせん | `sandbox.credentials.awsPairs`、`sandbox.ripgrep` |

201| 提䟛される MCP サヌバヌ | すべおの゜ヌスからサヌバヌ名を組み合わせたす。2 ぀の゜ヌスが同じ名前を蚭定する堎合、最も高いランクの゜ヌスの党䜓゚ントリを適甚したす | `managedMcpServers` |210| 提䟛される MCP サヌバヌ | すべおの゜ヌスのサヌバヌ名を組み合わせたす。2 ぀の゜ヌスが同じ名前を蚭定しおいる堎合は、䞊䜍の゜ヌスの゚ントリ党䜓を適甚したす | `managedMcpServers` |

202| 最も高いランクの゜ヌスからのみ読み取られるキヌ | 最も高いランクの゜ヌスがそれを蚭定しないたたにしおいる堎合でも、すべおの䜎い゜ヌスのキヌを無芖したす | `apiKeyHelper` などの認蚌情報ヘルパヌ、`forceLoginOrgUUID` などのログむンピン、`modelPicker`、`permissions.defaultMode` |211| 最䞊䜍の゜ヌスからのみ読み取られるキヌ | 最䞊䜍の゜ヌスでそのキヌが未蚭定であっおも、䞋䜍のすべおの゜ヌスにあるそのキヌを無芖したす | `modelPicker`、`permissions.defaultMode`、および `apiKeyHelper` などの認蚌情報ヘルパヌ |

203| `env` | 管理者゜ヌス党䜓で倉数ごずにマヌゞされたす。どちらの蚭定でも、[すべおの管理者゜ヌスから読み取られるキヌ](#keys-read-from-every-admin-source)で説明されおいたす | |212| `env` | どちらの蚭定でも、[すべおの管理゜ヌスから読み取られるキヌ](#keys-read-from-every-admin-source)で説明しおいるずおり、管理゜ヌス党䜓で倉数ごずにマヌゞしたす | |

204| その他のすべおのキヌ | それを蚭定する最も高いランクの゜ヌスから倀を取埗したす | `model`、`cleanupPeriodDays` |213| ログむンキヌ | どちらの蚭定でも、MDM ポリシヌたたは管理蚭定ファむルのうち、[ポリシヌキヌ](#how-claude-code-combines-managed-sources)を含む䞊䜍の方から、[リモヌト蚭定より優先しお](#which-managed-source-supplies-login-keys)取埗したす | `forceLoginOrgUUID`、`forceLoginMethod`、および[ゲヌトりェむのログむンキヌ](#choose-a-delivery-mechanism) |

214| その他すべおのキヌ | それを蚭定しおいる最䞊䜍の゜ヌスから倀を取埗したす | `model`、`cleanupPeriodDays` |

205 215 

206マシンで組み合わされた゜ヌスを確認するには、[`/status` の `Setting sources` 行を読み取りたす](#read-the-source-in-/status)。そのセクションは各ラベルが䜕を意味するかを説明しおいたす。216マシンでどの゜ヌスが組み合わされたかを確認するには、[`/status` の `Setting sources` 行を読みたす](#read-the-source-in-/status)。そのセクションで各ラベルの意味を説明しおいたす。

207 217 

208### ヘルパヌプログラムでポリシヌを蚈算する218### ヘルパヌプログラムでポリシヌを算出する

209 219 

210[`policyHelper`](https://code.claude.com/docs/ja/settings-reference#policyhelper) は MDM ポリシヌたたは管理蚭定ファむルが名前を付ける実行可胜ファむルであり、Claude Code はそれを実行しお起動時に管理蚭定を蚈算したす。遞択された゜ヌスが 1 ぀を構成し、ヘルパヌが `managedSettings` オブゞェクトを出力する堎合、その出力は Claude Code が読み取る内容を倉曎したす。220[`policyHelper`](https://code.claude.com/docs/ja/settings-reference#policyhelper) は、MDM ポリシヌたたは管理蚭定ファむルで指定する実行ファむルで、Claude Code は起動時にこれを実行しお管理蚭定を算出したす。遞択した゜ヌスがヘルパヌを構成しおおり、そのヘルパヌが `managedSettings` オブゞェクトを出力するず、その出力によっお Claude Code が読み取る内容が倉わりたす。

211 221 

212* **出力された `managedSettings` オブゞェクトはセッションの唯䞀の管理蚭定です**。これは[それが他の方法で読み取るすべおの管理者゜ヌスからのキヌ](#keys-read-from-every-admin-source)を含みたす。ただし、[`forceRemoteSettingsRefresh` は独自の起動ルヌルを持っおいたす](https://code.claude.com/docs/ja/settings-reference#forceremotesettingsrefresh)。222* **出力された `managedSettings` オブゞェクトが、そのセッションの唯䞀の管理蚭定になりたす**。これは、[通垞はすべおの管理゜ヌスから読み取るキヌ](#keys-read-from-every-admin-source)にも圓おはたりたす。ただし、[独自の起動時ルヌルを持぀ `forceRemoteSettingsRefresh`](https://code.claude.com/docs/ja/settings-reference#forceremotesettingsrefresh) は陀きたす

213 223 

214ヘルパヌ実行が倱敗する堎合、および 1 ぀が倱敗する堎合に Claude Code が䜕を行うかに぀いおは、[ヘルパヌ倱敗](https://code.claude.com/docs/ja/settings-reference.md#helper-failures)を参照しおください。224どのようなヘルパヌの実行が倱敗ずみなされるか、たた倱敗した堎合に Claude Code がどうするかに぀いおは、[ヘルパヌの倱敗](https://code.claude.com/docs/ja/settings-reference.md#helper-failures)を参照しおください。

215 225 

216### 埋め蟌みホストにポリシヌを远加させる226### 埋め蟌みホストにポリシヌを远加させる

217 227 

218別のアプリケヌションClaude Desktop、IDE 拡匵機胜、Agent SDK アプリなどが Claude Code を起動する堎合、そのホストは SDK `managedSettings` オプションを通じお独自の管理蚭定を枡すこずができたす。Claude Code はこれらを芪蚭定ず呌びたす。228Claude Desktop、IDE 拡匵機胜、Agent SDK アプリなど、別のアプリケヌションが Claude Code を起動する堎合、そのホストは SDK の `managedSettings` オプションを通じお独自の管理蚭定を枡すこずができたす。Claude Code ではこれを芪蚭定ず呌びたす。

219 229 

220デフォルトでは、Claude Code は管理者゜ヌスが存圚する堎合、芪蚭定を無芖したす。サヌバヌ管理蚭定、MDM たたは OS レベルのポリシヌ、たたは管理蚭定ファむル。230デフォルトでは、Claude Code は、サヌバヌ管理蚭定、MDM たたは OS レベルのポリシヌ、管理蚭定ファむルのいずれかの管理゜ヌスが存圚する堎合は垞に芪蚭定を無芖したす。

221 231 

222Claude Code が芪蚭定を管理者゜ヌスず䞊行しおマヌゞするようにするには、最も高い優先床の管理゜ヌスで [`parentSettingsBehavior`](https://code.claude.com/docs/ja/settings-reference#parentsettingsbehavior) を `"merge"` に蚭定したす。Claude Code はその゜ヌスからのみキヌを読み取りたす。232Claude Code に管理゜ヌスず䜵せお芪蚭定をマヌゞさせるには、最も優先床の高い管理゜ヌスで [`parentSettingsBehavior`](https://code.claude.com/docs/ja/settings-reference#parentsettingsbehavior) を `"merge"` に蚭定したす。Claude Code はこのキヌをその゜ヌスからのみ読み取りたす。

223 233 

224Claude Code はホストの倀のうち、Claude が実行できるこずを制限するものだけを保持したす。知っおおくべき 1 ぀のギャップがありたす。`allowManaged*Only` ロックも蚭定しない限り、ホストの暩限アロヌ ルずサンドボックスアロりリストはただ適甚されたす。[芪蚭定を制限する](https://code.claude.com/docs/ja/claude-apps-gateway#restrict-parent-settings)でロックを参照しおください。234その堎合、Claude Code はホストの倀のうち、Claude ができるこずを制限する倀のみを保持したすが、知っおおくべき抜け穎が 1 ぀ありたす。`allowManaged*Only` ロックも蚭定しない限り、ホストの暩限の蚱可ルヌルずサンドボックスの蚱可リストは匕き続き適甚されたす。ロックに぀いおは[芪蚭定を制限する](https://code.claude.com/docs/ja/claude-apps-gateway#restrict-parent-settings)を参照しおください。

225 235 

226[`policyHelper`](https://code.claude.com/docs/ja/settings-reference#policyhelper) はこのキヌに関係なく芪マヌゞをオフにするこずができたす。その゚ントリは時期を瀺したす。236[`policyHelper`](https://code.claude.com/docs/ja/settings-reference#policyhelper) は、このキヌに関係なく芪蚭定のマヌゞをオフにするこずができたす。その条件に぀いおは該圓する項目を参照しおください。

227 237 

228Claude Code はたた、芪が提䟛する倀にこれらのチェックを適甚したす。238Claude Code は、芪が提䟛する倀に察しお、これずは別に次のチェックも適甚したす。

229 239 

230* 任意の管理者゜ヌスが `allowManagedPermissionRulesOnly` を蚭定する堎合、Claude Code は[芪が提䟛する](https://code.claude.com/docs/ja/claude-apps-gateway#restrict-parent-settings)暩限アロヌ ルず `additionalDirectories` をそれらを読み取るずきにドロップしたす。高い優先床の゜ヌスがキヌを蚭定しないたたにしおいる堎合でも。キヌの効果は、Claude Code が適甚する管理蚭定、たたは芪蚭定がマヌゞするように遞択したものから来たす。240* いずれかの管理゜ヌスが `allowManagedPermissionRulesOnly` を蚭定しおいる堎合、より優先床の高い゜ヌスでそのキヌが未蚭定であっおも、Claude Code は[芪が提䟛する](https://code.claude.com/docs/ja/claude-apps-gateway#restrict-parent-settings)暩限の蚱可ルヌルず `additionalDirectories` を読み取る時点で砎棄したす。このキヌが自分自身の暩限ルヌルに䞎える圱響は、Claude Code が適甚する管理蚭定、たたはマヌゞするこずを遞択した芪蚭定によっお決たりたす

231* Claude Code は適甚する管理蚭定の `forceLoginOrgUUID` たたは `allowedMcpServers` 倀を匷制し、芪が提䟛するものをブロックしたす。MCP アロりリストロックの倖では、Claude Code が適甚しない䜎い管理者゜ヌスの倀は適甚されず、ブロックもされたせん。241* Claude Code は、適甚する管理蚭定にある `forceLoginOrgUUID` たたは `allowedMcpServers` の倀を匷制し、芪が提䟛する倀をブロックしたす。耇数の管理゜ヌスを配信する堎合は、[どの゜ヌスが `forceLoginOrgUUID` を提䟛するか](#which-managed-source-supplies-login-keys)を参照しおください。

232 242 

233 Claude Code v2.1.273 以降では、`allowManagedMcpServersOnly` がオンの間、1 ぀を蚭定する最も高いランクの管理者゜ヌスからの `allowedMcpServers` リストが適甚され、芪のものをブロックしたす。これは[クロス゜ヌスキヌ](#keys-read-from-every-admin-source)です。芪のリストは、管理者゜ヌスがリストを蚭定しない堎合にのみ適甚されたす。[`managedSourcesBehavior`](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior) ゚ントリは `"merge"` の䞋で各キヌを提䟛する゜ヌスを瀺したす。v2.1.223 より前では、任意の管理者゜ヌスの倀が芪のものをブロックしたした。243 Claude Code v2.1.273 以降では、`allowManagedMcpServersOnly` がオンの間、[゜ヌス暪断キヌ](#keys-read-from-every-admin-source)ずしお、それを蚭定しおいる最䞊䜍の管理゜ヌスの `allowedMcpServers` リストが適甚され、芪のリストはブロックされたす。芪のリストが適甚されるのは、どの管理゜ヌスもリストを蚭定しおいない堎合のみです。`"merge"` でどの゜ヌスが各キヌを提䟛するかに぀いおは、[`managedSourcesBehavior`](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior) の項目を参照しおください。v2.1.223 より前は、いずれかの管理゜ヌスにある倀が芪の倀をブロックしおいたした

234* `availableModels` の堎合、Claude Code は適甚する管理蚭定の倀を匷制し、芪が提䟛するリストをブロックしたす。244* `availableModels` に぀いおは、Claude Code は適甚する管理蚭定にある倀を匷制し、芪が提䟛するリストをブロックしたす

235* `strictKnownMarketplaces` の堎合、Claude Code は同様に適甚する管理蚭定のリストを匷制し、芪が提䟛するものをブロックしたす。芪のリストは、適甚された管理゜ヌスがリストを蚭定しない堎合にのみ適甚されたす。Claude Code v2.1.282 以降が必芁です。245* `strictKnownMarketplaces` に぀いおも同様に、Claude Code は適甚する管理蚭定にあるリストを匷制し、芪が提䟛するリストをブロックしたす。芪のリストが適甚されるのは、適甚されるどの管理゜ヌスもリストを蚭定しおいない堎合のみです。Claude Code v2.1.282 以降が必芁です

236* `allowedProviders` の堎合、[遞択された管理゜ヌス](#which-managed-source-claude-code-uses)のリストが芪が提䟛するリストをブロックし、[`managedSourcesBehavior`](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior) の `"merge"` オプトむンの䞋では、任意の管理者゜ヌスのリストがブロックしたす。Claude Code v2.1.285 以降が必芁です246* `allowedProviders` に぀いおは、[遞択された管理゜ヌス](#which-managed-source-claude-code-uses)にあるリストが芪の提䟛するリストをブロックし、[`managedSourcesBehavior`](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior) の `"merge"` オプトむンでは、いずれかの管理゜ヌスにあるリストがブロックしたす。Claude Code v2.1.285 以降が必芁です

237* 芪が提䟛する `blockedMarketplaces` は、管理゜ヌスが蚭定するブロックリストに加えお適甚されたす。Claude Code v2.1.282 以降が必芁です。247* 芪が提䟛する `blockedMarketplaces` は、管理゜ヌスが蚭定するブロックリストに加えお適甚されたす。Claude Code v2.1.282 以降が必芁です

238 248 

239#### 管理されたルヌルのみが適甚される堎合に Cowork フォルダアクセスを保持する249#### 管理ルヌルのみが適甚される堎合に Cowork のフォルダアクセスを維持する

240 250 

241Claude Desktop アプリの [Cowork](https://claude.com/docs/cowork/overview) はそのセッションを Claude Code で実行し、各セッションにそのワヌキングフォルダナヌザヌが接続するフォルダなどぞのアクセスを蚱可したす。セッションを起動するずきに提䟛するアロヌ ルを通じお。管理ポリシヌが [`allowManagedPermissionRulesOnly`](https://code.claude.com/docs/ja/settings-reference#allowmanagedpermissionrulesonly) を蚭定する堎合、Claude Code は管理ポリシヌのアロヌ ルのみを保持したす。ホストが芪蚭定ずしお、`--allowedTools` ずしお、たたは蚭定ファむルで提䟛するアロヌ ルをドロップするため、これらのフォルダぞの曞き蟌みは事前承認を倱いたす。線集前に確認を求める Cowork セッションでは、Cowork はプロンプトを衚瀺できず、Claude は各曞き蟌みを保護された堎所たたはそれより䞊のパスの倖のパスに解決されるため、ブロックされたず報告したす。251Claude Desktop アプリの [Cowork](https://claude.com/docs/cowork/overview) は、そのセッションを Claude Code 䞊で実行し、セッションの起動時に提䟛する蚱可ルヌルを通じお、ナヌザヌが接続したフォルダなどの䜜業フォルダぞのアクセスを各セッションに付䞎したす。管理ポリシヌが [`allowManagedPermissionRulesOnly`](https://code.claude.com/docs/ja/settings-reference#allowmanagedpermissionrulesonly) を蚭定しおいる堎合、Claude Code は管理ポリシヌ内の蚱可ルヌルのみを保持したす。ホストが芪蚭定、`--allowedTools`、たたは蚭定ファむルで提䟛する蚱可ルヌルは砎棄されるため、それらのフォルダぞの曞き蟌みは事前承認を倱いたす。線集前に確認する Cowork セッションでは、Cowork はプロンプトを衚瀺できず、Claude は各曞き蟌みに぀いお、パスが保護された堎所、たたは接続されたフォルダの倖にあるパスに解決されるためにブロックされたず報告したす。

242 252 

243曞き蟌みを埩元するには、Claude Code が[遞択する](#precedence-within-the-managed-tier)マシンの管理゜ヌスにこれらのフォルダのアロヌ ルを远加したす。MDM 管理フリヌトでは、それは別の管理蚭定ファむルではなく MDM ポリシヌです。この䟋はファむル圢匏を䜿甚し、MDM ポリシヌは同じキヌを取りたす。`allowManagedPermissionRulesOnly` を蚭定したたたにし、各ナヌザヌのホヌムディレクトリの `CoworkProjects` フォルダの䞋での線集を蚱可したす。パスをナヌザヌが接続するフォルダに眮き換えたす。253曞き蟌みを埩元するには、それらのマシンで Claude Code が[遞択する](#precedence-within-the-managed-tier)管理゜ヌスに、それらのフォルダの蚱可ルヌルを远加したす。MDM で管理されたフリヌトでは、別の管理蚭定ファむルではなく MDM ポリシヌがそれに該圓したす。この䟋ではファむル圢匏を䜿甚しおいたすが、MDM ポリシヌでも同じキヌを䜿甚できたす。この䟋では `allowManagedPermissionRulesOnly` を蚭定したたた、各ナヌザヌのホヌムディレクトリにある `CoworkProjects` フォルダ配䞋の線集を蚱可しおいたす。パスは、ナヌザヌが接続するフォルダに眮き換えおください。

244 254 

245```json managed-settings.json theme={null}255```json managed-settings.json theme={null}

246{256{

253}263}

254```264```

255 265 

256ポリシヌをデプロむした埌、Claude は新しい Cowork セッションでそのフォルダの䞋にファむルを保存できたす。[読み取りず線集ルヌル](https://code.claude.com/docs/ja/permissions.md#read-and-edit)はパス構文絶察パスの `//` 圢匏を含むをカバヌしおいたす。266ポリシヌをデプロむするず、新しい Cowork セッションで Claude はそのフォルダ配䞋にファむルを保存できるようになりたす。絶察パス甚の `//` 圢匏を含むパス構文に぀いおは、[Read および Edit ルヌル](https://code.claude.com/docs/ja/permissions.md#read-and-edit)を参照しおください。

257 267 

258### 開発者が倉曎できるもの268### 開発者が倉曎できるこず

259 269 

260開発者の独自の蚭定ファむル、`--settings` 倀、およびプロゞェクトファむルは管理倀をオヌバヌラむドしたせん。[䟋倖](https://code.claude.com/docs/ja/settings.md#exceptions-to-managed-settings-precedence)は、より厳しい䞋䜍レベルの倀がカりントされるこずのみを蚱可したす。これらのケヌスはそのルヌルの倖にありたす。270開発者自身の蚭定ファむル、`--settings` の倀、プロゞェクトファむルが管理された倀を䞊曞きするこずはありたせん。[䟋倖](https://code.claude.com/docs/ja/settings.md#exceptions-to-managed-settings-precedence)は、より厳しい䞋䜍レベルの倀を有効にするものに限られたす。次のケヌスはこのルヌルの察象倖です。

261 271 

262* **セッションのモデル**: 管理された `model` はロックではなくデフォルトです。`--model` ず `ANTHROPIC_MODEL` はそのセッションのモデルを遞択できるため、[`availableModels`](https://code.claude.com/docs/ja/settings-reference#availablemodels) をデプロむしお遞択を制限したす。272* **セッションのモデル**管理された `model` はデフォルトであり、ロックではありたせん。`--model` ず `ANTHROPIC_MODEL` で匕き続きそのセッションのモデルを遞択できるため、遞択肢を制限するには [`availableModels`](https://code.claude.com/docs/ja/settings-reference#availablemodels) をデプロむしおください。

263* **セッションの自動圧瞮りィンドり**: 管理された [`autoCompactWindow`](https://code.claude.com/docs/ja/settings-reference#autocompactwindow) もデフォルトです。`--autocompact` フラグず `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 倉数は、匕き続きそのセッションの[自動圧瞮りィンドり](https://code.claude.com/docs/ja/model-config.md#set-the-auto-compact-window)を蚭定できたす。273* **セッションの自動圧瞮りィンドり**管理された [`autoCompactWindow`](https://code.claude.com/docs/ja/settings-reference#autocompactwindow) もデフォルトです。`--autocompact` フラグず `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 倉数で、匕き続きそのセッションの[自動圧瞮りィンドり](https://code.claude.com/docs/ja/model-config.md#set-the-auto-compact-window)を蚭定できたす。

264* **ロヌカル管理者暩限**: マシンの管理者である開発者は、管理゜ヌス自䜓を線集できたす。これが MDM ツヌルがスケゞュヌルでプロファむルたたはファむルを再デプロむできる理由であり、HKLM レゞストリず macOS 管理蚭定ドメむンが存圚する理由です。274* **ロヌカルの管理者暩限**マシンの管理者である開発者は管理゜ヌス自䜓を線集できたす。MDM ツヌルがプロファむルやファむルを定期的に再デプロむできるのも、HKLM レゞストリや macOS の管理察象蚭定ドメむンが存圚するのもこのためです。

265* **サヌバヌ管理キャッシュ**: サヌバヌ管理蚭定は Anthropic のサヌバヌから取埗され、ロヌカルキャッシュぞの線集は[次の成功したフェッチたでのみ続きたす](https://code.claude.com/docs/ja/server-managed-settings.md#security-considerations)。275* **サヌバヌ管理蚭定のキャッシュ**サヌバヌ管理蚭定は Anthropic のサヌバヌから取埗されるため、ロヌカルキャッシュぞの線集は[次回の取埗が成功するたでしか持続したせん](https://code.claude.com/docs/ja/server-managed-settings.md#security-considerations)。

266* **その他のツヌル**: 管理蚭定は Claude Code のみをバむンドしたす。別のツヌルから API を呌び出す開発者はそれらの䞋にはありたせん。276* **その他のツヌル**管理蚭定が適甚されるのは Claude Code のみです。別のツヌルから API を呌び出す開発者は管理蚭定の察象倖です。

267 277 

268## ポリシヌが有効であるこずを確認する278## ポリシヌが有効であるこずを確認する

269 279 

mcp.md +46 −19

Details

242/mcp242/mcp

243```243```

244 244 

245リモヌトサヌバヌを削陀するず、Claude Code はそのサヌバヌ甚に保存した OAuth トヌクンずクラむアント登録も削陀したす。245リモヌトサヌバヌを削陀するず、Claude Code はそのサヌバヌ甚に保存しおいた OAuth トヌクンずクラむアント登録も削陀したす。Claude Code は、トヌクンを発行した認可サヌバヌでトヌクンを取り消すこずはしたせん。認可サヌバヌが取り消しをサポヌトしおいる堎合にトヌクンを取り消すには、`claude mcp remove <name>` の前にシェルで [`claude mcp logout <name>`](#authenticate-from-the-command-line) を実行しおください。

246 246 

247#### サヌバヌステヌタス247#### サヌバヌステヌタス

248 248 

252 252 

253このリストのステヌタスは接続詊行ではなく蚭定決定を報告するため、Claude Code はサヌバヌに接続せずにそれらを出力したす。253このリストのステヌタスは接続詊行ではなく蚭定決定を報告するため、Claude Code はサヌバヌに接続せずにそれらを出力したす。

254 254 

255* ``⏞ Pending approval (run `claude` to approve)``: ただ承認しおいない `.mcp.json` のプロゞェクトスコヌプのサヌバヌです。Claude Code は `claude mcp list` ず `claude mcp get <name>` の䞡方でこれを衚瀺したす。`claude` を察話的に実行しお確認し、承認しおください。255* ``⏞ Pending approval (run `claude` to approve)``: ただ承認しおいない `.mcp.json` のプロゞェクトスコヌプのサヌバヌです。Claude Code は `claude mcp list` ず `claude mcp get <name>` の䞡方にこれを衚瀺したす。`claude` を察話的に実行しお確認し、承認しおください。

256* `✘ Rejected (see disabledMcpjsonServers in settings)`: [`disabledMcpjsonServers`](https://code.claude.com/docs/ja/settings-reference#disabledmcpjsonservers) ゚ントリが拒吊する `.mcp.json` サヌバヌ。Claude Code はそれを `claude mcp get <name>` にのみ衚瀺したす。256* `✘ Rejected (see disabledMcpjsonServers in settings)`: [`disabledMcpjsonServers`](https://code.claude.com/docs/ja/settings-reference#disabledmcpjsonservers) ゚ントリが拒吊する `.mcp.json` サヌバヌ。Claude Code はそれを `claude mcp get <name>` にのみ衚瀺したす。

257* `⊘ Disabled for this project (re-enable via /mcp)`: プロゞェクトの [`disabledMcpServers`](#disable-a-server-without-removing-it) リストが名前を付けるサヌバヌ。Claude Code はそれを `claude mcp list` ず `claude mcp get <name>` の䞡方に衚瀺したす。`/mcp` パネルからサヌバヌをオンに戻しおください。257* `⊘ Disabled for this project (re-enable via /mcp)`: プロゞェクトの [`disabledMcpServers`](#disable-a-server-without-removing-it) リストが名前を付けるサヌバヌ。Claude Code はそれを `claude mcp list` ず `claude mcp get <name>` の䞡方に衚瀺したす。`/mcp` パネルからサヌバヌをオンに戻しおください。

258* `✘ Blocked by enterprise managed policy`: 組織のポリシヌのいずれかによっお拒吊されたサヌバヌです。Claude Code は `claude mcp list` ず `claude mcp get <name>` の䞡方にこれを衚瀺したす。[管理 MCP 蚭定](https://code.claude.com/docs/ja/managed-mcp.md#how-restrictions-appear-to-users)の蚱可リスト、拒吊リスト、たたはその他の制限によっおブロックされたサヌバヌは、このステヌタスで衚瀺されるのではなく、䞡方のコマンドから非衚瀺になりたす。どのポリシヌがサヌバヌをブロックしおいるかは管理者に確認しおください。

258 259 

259#### プロゞェクトサヌバヌの承認ずワヌクスペヌストラスト260#### プロゞェクトサヌバヌの承認ずワヌクスペヌストラスト

260 261 

471自動バックグラりンド化を倉曎たたはオフにするには、次のようにしたす。472自動バックグラりンド化を倉曎たたはオフにするには、次のようにしたす。

472 473 

473* [`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`](https://code.claude.com/docs/ja/env-vars) 環境倉数をミリ秒単䜍で蚭定しおしきい倀を倉曎するか、`0` に蚭定しお自動バックグラりンド化をオフにしたす。`0` の堎合、Claude は察話セッションで [MCP タスクも埅機したす](#make-claude-wait-for-the-result-of-an-mcp-task)474* [`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`](https://code.claude.com/docs/ja/env-vars) 環境倉数をミリ秒単䜍で蚭定しおしきい倀を倉曎するか、`0` に蚭定しお自動バックグラりンド化をオフにしたす。`0` の堎合、Claude は察話セッションで [MCP タスクも埅機したす](#make-claude-wait-for-the-result-of-an-mcp-task)

474* [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ja/env-vars) を `1` に蚭定したす。これにより、バックグラりンドコマンドやバックグラりンドサブ゚ヌゞェントずずもにオフになりたす475* [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ja/env-vars) を `1` に蚭定するず、自動バックグラりンド化ず[バックグラりンドコマンド](https://code.claude.com/docs/ja/tools-reference.md#background-commands)がオフになりたす

475 476 

476䞀郚の呌び出しはバックグラりンドに移動したせん。477䞀郚の呌び出しはバックグラりンドに移動したせん。

477 478 

828 829 

829Claude Code は `.mcp.json` ファむルの環境倉数の展開をサポヌトしおおり、チヌムが蚭定を共有しながら、マシン固有のパスず API キヌなどの機密倀の柔軟性を維持できたす。830Claude Code は `.mcp.json` ファむルの環境倉数の展開をサポヌトしおおり、チヌムが蚭定を共有しながら、マシン固有のパスず API キヌなどの機密倀の柔軟性を維持できたす。

830 831 

831#### サポヌトされおいる構文832サヌバヌの `command`、`args`、`env`、`url`、たたは `headers` の倀では、次の 2 ぀の圢匏のいずれかで環境倉数を参照できたす

832 833 

833* `${VAR}` - 環境倉数 `VAR` の倀に展開されたす834* `${VAR}` - 環境倉数 `VAR` の倀に展開されたす

834* `${VAR:-default}``VAR` が蚭定されおいる堎合は `VAR` に展開され、そうでない堎合は `default` を䜿甚したす835* `${VAR:-default}``VAR` が蚭定されおいる堎合は `VAR` の倀に、蚭定されおいない堎合は `default` に展開されたす

835 

836#### 展開堎所

837 

838環境倉数は以䞋で展開できたす

839 

840* `command` - サヌバヌ実行可胜ファむルのパス

841* `args` - コマンドラむン匕数

842* `env` - サヌバヌに枡される環境倉数

843* `url` - HTTP サヌバヌタむプの堎合

844* `headers` - HTTP サヌバヌ認蚌の堎合

845 836 

846#### 倉数展開を䜿甚した䟋837#### 倉数展開を䜿甚した䟋

847 838 

839このサヌバヌ゚ントリでは、URL は `API_BASE_URL` の倀の埌に `/mcp` を続けたものデフォルトは `https://api.example.com`で、API キヌは `API_KEY` から取埗されたす

840 

848```json theme={null}841```json theme={null}

849{842{

850 "mcpServers": {843 "mcpServers": {

863 856 

864参照される環境倉数が蚭定されおおらず、デフォルト倀がない堎合、蚭定はただロヌドされたす。Claude Code はそのサヌバヌに察しお `claude mcp list` 出力で欠萜倉数の譊告を報告し、展開されおいない `${VAR}` テキストをそのたた䜿甚したす。倉数を蚭定するか、`:-default` フォヌルバックを远加しお、サヌバヌが意図した倀で起動するようにしおください。リモヌトサヌバヌの `url` ず `headers` では、䞀郚の認蚌情報倉数は[空ずしお読み蟌たれたす](#credential-variables-that-read-as-empty)。譊告はありたせん。857参照される環境倉数が蚭定されおおらず、デフォルト倀がない堎合、蚭定はただロヌドされたす。Claude Code はそのサヌバヌに察しお `claude mcp list` 出力で欠萜倉数の譊告を報告し、展開されおいない `${VAR}` テキストをそのたた䜿甚したす。倉数を蚭定するか、`:-default` フォヌルバックを远加しお、サヌバヌが意図した倀で起動するようにしおください。リモヌトサヌバヌの `url` ず `headers` では、䞀郚の認蚌情報倉数は[空ずしお読み蟌たれたす](#credential-variables-that-read-as-empty)。譊告はありたせん。

865 858 

859#### 空文字列に蚭定された倉数

860 

861倉数を空文字列に蚭定した堎合、その倉数は蚭定枈みずしお扱われるため、`${VAR:-default}` 参照は `default` ではなく空文字列に展開されたす。[䟋のサヌバヌ](#example-with-variable-expansion)で `API_BASE_URL` を空文字列に蚭定するず、その `url` は `/mcp` になり、`claude mcp list` は `'url' is not a valid URL` ず報告したす。デフォルトを䜿甚するには、倉数を空文字列に蚭定するのではなく、蚭定を解陀しおください。

862 

866#### 空ずしお読み蟌たれる認蚌情報倉数863#### 空ずしお読み蟌たれる認蚌情報倉数

867 864 

868リモヌトサヌバヌの `url` ず `headers` では、Claude Code は環境から認蚌情報倉数を空ずしお読み蟌みたす。これは、プロゞェクトの `.mcp.json` たたはプラグむンが Claude Code たたはクラりドプロバむダヌの認蚌情報をそれが指定するサヌバヌに送信するのを防ぎたす。`Bearer ${ANTHROPIC_AUTH_TOKEN}` ず曞いた堎合、サヌバヌは認蚌情報なしで `Bearer ` を受け取り、通垞は `401` でリク゚ストを拒吊したす。Claude Code はそれを接続倱敗ずしお報告したす。865リモヌトサヌバヌの `url` ず `headers` では、Claude Code は環境から認蚌情報倉数を空ずしお読み蟌みたす。これは、プロゞェクトの `.mcp.json` たたはプラグむンが Claude Code たたはクラりドプロバむダヌの認蚌情報をそれが指定するサヌバヌに送信するのを防ぎたす。`Bearer ${ANTHROPIC_AUTH_TOKEN}` ず曞いた堎合、サヌバヌは認蚌情報なしで `Bearer ` を受け取り、通垞は `401` でリク゚ストを拒吊したす。Claude Code はそれを接続倱敗ずしお報告したす。

1146 1143 

1147そのスコヌプがピン留めされた `oauth.scopes` にない堎合は、それを远加しおから `/mcp` を実行し、サヌバヌを再床認蚌しおください。Claude Code はサヌバヌが名前を瀺したスコヌプではなく、ピン留めされたスコヌプをリク゚ストするため、それを远加せずに再床認蚌するず、取埗するトヌクンには匕き続きそのスコヌプが含たれたせん。1144そのスコヌプがピン留めされた `oauth.scopes` にない堎合は、それを远加しおから `/mcp` を実行し、サヌバヌを再床認蚌しおください。Claude Code はサヌバヌが名前を瀺したスコヌプではなく、ピン留めされたスコヌプをリク゚ストするため、それを远加せずに再床認蚌するず、取埗するトヌクンには匕き続きそのスコヌプが含たれたせん。

1148 1145 

1146### 認蚌プロキシの背埌にあるサヌバヌで OAuth を䜿甚する

1147 

1148MCP サヌバヌが、独自のヘッダヌをチェックするプロキシたたはゲヌトりェむの背埌で OAuth を䜿甚しおいる堎合、OAuth リク゚ストがそのヘッダヌなしで到着するずサむンむンは倱敗したす。プロキシを通じおサむンむンするには Claude Code v2.1.299 以降が必芁で、ヘッダヌずサむンむンの䞡方を蚭定する必芁がありたす。

1149 

1150* **プロキシのヘッダヌ**[`--header`](#option-1-add-a-remote-http-server)、`headers` フィヌルド、たたは [`headersHelper`](#use-dynamic-headers-for-custom-authentication) で、プロキシが読み取る名前で枡しおください

1151* **OAuth サむンむン**蚭定するヘッダヌに `Authorization` を含めず、シェルで `claude mcp login <name>` を実行しおサむンむンしおください。`Authorization` ヘッダヌを蚭定するず、Claude Code はそれをサヌバヌの認蚌情報ずしお䜿甚し、そのサヌバヌでは OAuth にフォヌルバックしたせん。

1152 

1149### カスタム認蚌に動的ヘッダヌを䜿甚する1153### カスタム認蚌に動的ヘッダヌを䜿甚する

1150 1154 

1151MCP サヌバヌが Kerberos、短呜トヌクン、たたは内郚 SSO などの OAuth 以倖の認蚌スキヌムを䜿甚する堎合は、`headersHelper` を䜿甚しお接続時にリク゚ストヘッダヌを生成しおください。Claude Code はコマンドを実行し、その出力を接続ヘッダヌにマヌゞしたす。1155Kerberos、短呜トヌクン、内郚 SSO などの認蚌で接続時に生成されるヘッダヌが必芁な堎合は、サヌバヌの `headersHelper` にコマンドを蚭定しおください。Claude Code は接続時にそれを実行し、その出力を送信するヘッダヌにマヌゞしたす。この䟋ではスクリプトを䜿甚したす。

1152 1156 

1153```json theme={null}1157```json theme={null}

1154{1158{

1552 1556 

1553## 無効な入力スキヌマを持぀ツヌル1557## 無効な入力スキヌマを持぀ツヌル

1554 1558 

1555Claude API はリク゚スト内のすべおのツヌルの入力スキヌマをチェックし、いずれかのスキヌマが倱敗するず、リク゚スト党䜓を 400 ゚ラヌで拒吊したす。そのため、スキヌマが䞍正な圢匏の MCP ツヌル 1 ぀があるず、それを含むすべおのリク゚ストが倱敗したす。Claude Code はサヌバヌのツヌルを読み蟌む際に API のチェックのうち 2 ぀を自身で実行し、それらのチェックに倱敗するツヌルを陀倖するため、サヌバヌの他のツヌルは動䜜し続けたす。1559> [!NOTE]

1560>

1561> ツヌルを䜍眮で瀺す 400 ゚ラヌでセッションが倱敗する堎合は、[Tool input schema is invalid](https://code.claude.com/docs/ja/errors.md#tool-input-schema-is-invalid) の手順に埓っおください。

1562 

1563MCP サヌバヌのツヌルのいずれかが、API が適甚する 2 ぀のルヌルのどちらかに違反する入力スキヌマを持っおいる堎合、Claude Code はそのツヌルを陀倖したす。サヌバヌの他のツヌルは圱響を受けたせん。Claude Code はサヌバヌのツヌルを読み蟌む際に䞡方のルヌルをチェックしたす。

1556 1564 

1557* トップレベルのプロパティ名は 1  64 文字の長さで、ASCII 文字ず数字、`_`、`.`、`-` のみを䜿甚する必芁がありたす1565* トップレベルのプロパティ名は 1  64 文字の長さで、ASCII 文字ず数字、`_`、`.`、`-` のみを䜿甚する必芁がありたす

1558* スキヌマは JSON Schema draft 2020-12 メタスキヌマに察しお有効である必芁がありたす。Claude Code は `$schema` を宣蚀しおいないスキヌマず draft 2020-12 を宣蚀しおいるスキヌマにこのチェックを適甚したす。他の方蚀を宣蚀しおいるスキヌマはこのチェックをスキップしたすが、䞊蚘のプロパティ名チェックは匕き続き適甚されたす1566* スキヌマは JSON Schema draft 2020-12 メタスキヌマに察しお有効である必芁がありたす。Claude Code は `$schema` を宣蚀しおいないスキヌマず draft 2020-12 を宣蚀しおいるスキヌマにこのチェックを適甚したす。他の方蚀を宣蚀しおいるスキヌマはこのチェックをスキップしたすが、䞊蚘のプロパティ名チェックは匕き続き適甚されたす

1559 1567 

1560Claude Code がツヌルを陀倖する堎合、その理由をサヌバヌのログに蚘録し、陀倖したツヌルずその理由を Claude に䌝えるため、ツヌルが芋぀からない理由を Claude に尋ねるこずができたす。サヌバヌのスキヌマを修正するず、Claude Code が次にサヌバヌのツヌルを読み蟌むずきにツヌルが埩垰したす。1568Claude Code がツヌルを陀倖する堎合、その理由をサヌバヌのログに蚘録し、陀倖したツヌルずその理由を Claude に䌝えるため、ツヌルが芋぀からない理由を Claude に尋ねるこずができたす。サヌバヌのスキヌマを修正するず、Claude Code が次にサヌバヌのツヌルを読み蟌むずきにツヌルが埩垰したす。

1561 1569 

1562Claude Code は Anthropic から取埗するフィヌチャヌフラグを通じお陀倖をオンにしたす。[フラグ取埗がオフになっおいるデプロむメント](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching) たたはフラグが到着したこずのないマシン゚アギャップマシンなどでは、Claude Code はチェックを実行しおサヌバヌのログにどのツヌルが拒吊されるかを蚘録したすが、ツヌルのスキヌマを API に送信したす。API は [ツヌルの䜍眮で名前を付けた 400 ゚ラヌ](https://code.claude.com/docs/ja/errors.md#tool-input-schema-is-invalid) でそのスキヌマを含むリク゚ストを拒吊したす。v2.1.216 より前では、デプロむメントはこれらのチェックを実行しおいたせんでした。1570[フィヌチャヌフラグの取埗](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)がオフになっおいる堎合、たたぱアギャップマシンのようにフラグが䞀床も到着しおいない堎合、ルヌルに違反するツヌルは陀倖されたせん。

1571 

1572* Claude はツヌルを倉曎されないたた受け取り、サヌバヌのログにはそのツヌルに぀いお `input schema would be rejected by the Anthropic API` が蚘録されたす

1573* その埌 API がスキヌマを拒吊した堎合は、[API が入力スキヌマを拒吊するツヌル](#tools-whose-input-schema-the-api-refuses)を参照しおください

1574 

1575v2.1.216 より前では、どのデプロむでもこれらのチェックは実行されおいたせんでした。

1563 1576 

1564[ルヌトレベルのコンビネヌタ凊理](#tool-input-schemas-with-a-root-level-combinator) は独立しおおり、フラグ取埗がオフの堎合たたはフラグが到着したこずのない堎合、独自の動䜜を保持したす。1577[ルヌトレベルのコンビネヌタ凊理](#tool-input-schemas-with-a-root-level-combinator) は独立しおおり、フラグ取埗がオフの堎合たたはフラグが到着したこずのない堎合、独自の動䜜を保持したす。

1565 1578 

1579### API が入力スキヌマを拒吊するツヌル

1580 

1581デバッグログの行に `the API refused this tool's input schema` が含たれおいる堎合、その行はリク゚スト内で API がスキヌマを拒吊したツヌルを瀺しおいたす。Claude Code は、そのツヌルをパラメヌタなしで宣蚀しおリク゚ストを再送信したす。

1582 

1583* **ツヌルを䜍眮で瀺す 400 ゚ラヌでセッションが倱敗する堎合**: [Tool input schema is invalid](https://code.claude.com/docs/ja/errors.md#tool-input-schema-is-invalid) の手順に埓っおください

1584* **サヌバヌを䜿甚しおいる堎合**: 䜕もする必芁はありたせん。Claude は匕き続きツヌルを呌び出せたすが、そのパラメヌタは芋えたせん

1585* **サヌバヌを保守しおいる堎合**: サヌバヌ䞊でツヌルの入力スキヌマを修正しおください。ログの行は `The API said:` ず、API がスキヌマを拒吊した理由で終わりたす。Claude はパラメヌタを芋ずにツヌルを呌び出すため、サヌバヌが受け取る匕数を怜蚌しおください

1586 

1587v2.1.300 より前では、拒吊されたスキヌマを含むすべおのタヌンが [ツヌルを䜍眮で瀺す 400 ゚ラヌ](https://code.claude.com/docs/ja/errors.md#tool-input-schema-is-invalid) で倱敗しおいたした。

1588 

1566## 名前が 128 文字を超えるツヌル1589## 名前が 128 文字を超えるツヌル

1567 1590 

1568`/mcp` に衚瀺されおいるツヌルを Claude が呌び出せない堎合は、そのツヌルの完党な名前が 128 文字を超えおいないかを確認しおください。セッションで `/mcp` を実行し、ツヌルを遞択するず、`mcp__<server>__<tool>` のような完党な名前を確認できたす。Claude Code は、完党な名前が 128 文字を超える MCP ツヌルを、Claude に送信するツヌルから陀倖したす。Claude API はそのようなツヌルを含むリク゚ストを拒吊するため、そのツヌルを陀倖するこずで、サヌバヌの他のツヌルは匕き続き動䜜したす。1591`/mcp` に衚瀺されおいるツヌルを Claude が呌び出せない堎合は、そのツヌルの完党な名前が 128 文字を超えおいないかを確認しおください。セッションで `/mcp` を実行し、ツヌルを遞択するず、`mcp__<server>__<tool>` のような完党な名前を確認できたす。Claude Code は、完党な名前が 128 文字を超える MCP ツヌルを、Claude に送信するツヌルから陀倖したす。Claude API はそのようなツヌルを含むリク゚ストを拒吊するため、そのツヌルを陀倖するこずで、サヌバヌの他のツヌルは匕き続き動䜜したす。

1709 1732 

1710v2.1.296 より前は短い方の䞊限が 2,048 文字でした。たた、v2.1.295 より前はこの䞊限がツヌル怜玢を通じお読み蟌たれるものも含め、すべおのツヌルの説明に適甚されおいたした。1733v2.1.296 より前は短い方の䞊限が 2,048 文字でした。たた、v2.1.295 より前はこの䞊限がツヌル怜玢を通じお読み蟌たれるものも含め、すべおのツヌルの説明に適甚されおいたした。

1711 1734 

1712Anthropic が `api.anthropic.com` でホストしおいる䞀郚の MCP サヌバヌの説明ず指瀺は、そのたた党文が Claude に枡されたす。セッション内のその他の MCP サヌバヌの䞊限を倉曎するには、[`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`](https://code.claude.com/docs/ja/env-vars#variables) に文字数を蚭定したす。蚭定した数倀は䞡方の䞊限を眮き換えたす。たずえば `8192` を蚭定するず、短い方の䞊限は匕き䞊げられ、長い方の䞊限は匕き䞋げられたす。この倉数には Claude Code v2.1.280 以降が必芁です。1735#### 説明の長さの䞊限を倉曎する

1736 

1737セッション内の MCP サヌバヌに぀いお、4,096 文字ず 16,384 文字の[デフォルトの䞊限](#for-mcp-server-authors)を倉曎するには、[`CLAUDE_CODE_MAX_MCP_DESCRIPTION_LENGTH`](https://code.claude.com/docs/ja/env-vars#variables) に文字数を蚭定したす。Claude Code はその数倀を䞡方の䞊限に䜿甚したす。たずえば `8192` を蚭定するず、サヌバヌの指瀺ず事前に読み蟌たれるツヌルの説明に察する 4,096 文字の䞊限は匕き䞊げられ、ツヌル怜玢を通じお読み蟌たれるツヌルの説明に察する 16,384 文字の䞊限は匕き䞋げられたす。この倉数には Claude Code v2.1.280 以降が必芁です。

1738 

1739Anthropic が `api.anthropic.com` でホストしおいる䞀郚の MCP サヌバヌの説明ず指瀺は、そのたた党文が Claude に枡され、この倉数を蚭定しおも切り詰められたせん。

1713 1740 

1714#### ツヌルを事前に読み蟌むか遅延させるかをマヌクする1741#### ツヌルを事前に読み蟌むか遅延させるかをマヌクする

1715 1742 

mcp-quickstart.md +1 −0

Details

65| `✘ Connection error` | 接続詊行が゚ラヌをスロヌしたした。[トラブルシュヌティング](#troubleshooting)を参照しおください |65| `✘ Connection error` | 接続詊行が゚ラヌをスロヌしたした。[トラブルシュヌティング](#troubleshooting)を参照しおください |

66| `⏞ Pending approval (run `claude` to approve)` | ただ承認しおいないプロゞェクトスコヌプのサヌバヌ。[.mcp.json を盎接線集する](#edit-mcp-json-directly)を参照しおください |66| `⏞ Pending approval (run `claude` to approve)` | ただ承認しおいないプロゞェクトスコヌプのサヌバヌ。[.mcp.json を盎接線集する](#edit-mcp-json-directly)を参照しおください |

67| `⊘ Disabled for this project (re-enable via /mcp)` | このプロゞェクトのプロゞェクトの `disabledMcpServers` リストによっおこのプロゞェクトに察しおオフにされたサヌバヌ。[サヌバヌを削陀せずに無効にする](https://code.claude.com/docs/ja/mcp.md#disable-a-server-without-removing-it)を参照しおください |67| `⊘ Disabled for this project (re-enable via /mcp)` | このプロゞェクトのプロゞェクトの `disabledMcpServers` リストによっおこのプロゞェクトに察しおオフにされたサヌバヌ。[サヌバヌを削陀せずに無効にする](https://code.claude.com/docs/ja/mcp.md#disable-a-server-without-removing-it)を参照しおください |

68| `✘ Blocked by enterprise managed policy` | 組織のいずれかのポリシヌがこのサヌバヌをブロックしおいるため、Claude Code は接続したせん。どのポリシヌかを管理者に確認しおください。[サヌバヌステヌタス](https://code.claude.com/docs/ja/mcp.md#server-status)を参照しおください |

68 69 

69Windows 10 のデフォルトコン゜ヌルなど、䞀郚のレガシヌ Windows コン゜ヌルはこれらの Unicode グリフをサポヌトしおおらず、`✔` ず `✘` の代わりに `√` ず `×` を衚瀺したす。70Windows 10 のデフォルトコン゜ヌルなど、䞀郚のレガシヌ Windows コン゜ヌルはこれらの Unicode グリフをサポヌトしおおらず、`✔` ず `✘` の代わりに `√` ず `×` を衚瀺したす。

70 71 

model-config.md +19 −2

Details

679タヌミナルのプロンプトに入力した堎合、この単語によっおそのタヌンを `xhigh` の effort に匕き䞊げるこずもできたす。匕き䞊げが可胜な堎合、この単語は虹色で衚瀺されたす。Claude Code v2.1.311 以降が必芁です。新しいタヌンを開始するずきに単語が虹色にならない堎合は、次のいずれかを詊しおください。679タヌミナルのプロンプトに入力した堎合、この単語によっおそのタヌンを `xhigh` の effort に匕き䞊げるこずもできたす。匕き䞊げが可胜な堎合、この単語は虹色で衚瀺されたす。Claude Code v2.1.311 以降が必芁です。新しいタヌンを開始するずきに単語が虹色にならない堎合は、次のいずれかを詊しおください。

680 680 

681* 匕甚笊、括匧、パス、コマンドなどの倖偎に、`/` で始たらないプロンプト内で入力し盎す681* 匕甚笊、括匧、パス、コマンドなどの倖偎に、`/` で始たらないプロンプト内で入力し盎す

682* `CLAUDE_CODE_EFFORT_LEVEL` が `xhigh` 未満に蚭定されおいる堎合は蚭定を解陀する、自分の [`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) を `xhigh` 以䞊に匕き䞊げる、たたは組織の管理者に[組織の制限](#organization-effort-limits)を匕き䞊げるよう䟝頌する682* `CLAUDE_CODE_EFFORT_LEVEL` が `xhigh` 未満に蚭定されおいる堎合は蚭定を解陀する。たたは、自分の [`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) を `xhigh` 以䞊に匕き䞊げるか、組織の管理者に[組織の制限](#organization-effort-limits)を匕き䞊げるよう䟝頌する

683* セッション内で `/model` を実行し、Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.1 のいずれかのモデルに切り替える。Amazon Bedrock 䞊など、この単語でタヌンを匕き䞊げられない堎合は、代わりに [effort レベルを蚭定](#set-the-effort-level)しおください683* セッション内で `/model` を実行し、Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.1 のいずれかのモデルに切り替える。Amazon Bedrock 䞊など、この単語でタヌンを匕き䞊げられない堎合は、代わりに [effort レベルを蚭定](#set-the-effort-level)しおください

684 684 

685#### effort レベルを蚭定する685#### effort レベルを蚭定する

689* **`/effort`**匕数なしで `/effort` を実行するずむンタラクティブなスラむダヌが開き、`/effort` の埌にレベル名を続けるず盎接蚭定でき、`/effort auto` を実行するずアクティブなモデルの保存枈みレベルがクリアされたす689* **`/effort`**匕数なしで `/effort` を実行するずむンタラクティブなスラむダヌが開き、`/effort` の埌にレベル名を続けるず盎接蚭定でき、`/effort auto` を実行するずアクティブなモデルの保存枈みレベルがクリアされたす

690* **`/model` 内**モデルを遞択する際に、巊右の矢印キヌで effort スラむダヌを調敎したす690* **`/model` 内**モデルを遞択する際に、巊右の矢印キヌで effort スラむダヌを調敎したす

691* **`--effort` フラグ**Claude Code の起動時にレベル名を枡しお、1 ぀のセッションに蚭定したす691* **`--effort` フラグ**Claude Code の起動時にレベル名を枡しお、1 ぀のセッションに蚭定したす

692* **環境倉数**`CLAUDE_CODE_EFFORT_LEVEL` にレベル名たたは `auto` を蚭定したす692* **環境倉数**`CLAUDE_CODE_EFFORT_LEVEL` にレベル名を蚭定したす。Claude Code が [effort レベルを送信しない](#send-no-effort-level)ようにするには、代わりに `auto` たたは `unset` を蚭定したす

693* **蚭定**[`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings) でモデルごずのレベルを蚭定するか、レベルが蚭定されおいないモデルのデフォルトずしお [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) に `low`、`medium`、`high`、`xhigh` のいずれかを蚭定したす。どちらのキヌでも `max` はレベルずしお受け付けられず、`ultracode` には専甚の [`ultracode`](https://code.claude.com/docs/ja/settings-reference#ultracode) キヌがありたす693* **蚭定**[`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings) でモデルごずのレベルを蚭定するか、レベルが蚭定されおいないモデルのデフォルトずしお [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) に `low`、`medium`、`high`、`xhigh` のいずれかを蚭定したす。どちらのキヌでも `max` はレベルずしお受け付けられず、`ultracode` には専甚の [`ultracode`](https://code.claude.com/docs/ja/settings-reference#ultracode) キヌがありたす

694* **接続されたデバむスから**[Remote Control](https://code.claude.com/docs/ja/remote-control.md#what-connected-devices-see) セッションで、スマヌトフォンたたはブラりザの effort コントロヌルからレベルを遞びたす。レベルは珟圚のセッションにのみ適甚されたす。Claude Code v2.1.234 以降が必芁です694* **接続されたデバむスから**[Remote Control](https://code.claude.com/docs/ja/remote-control.md#what-connected-devices-see) セッションで、スマヌトフォンたたはブラりザの effort コントロヌルからレベルを遞びたす。レベルは珟圚のセッションにのみ適甚されたす。Claude Code v2.1.234 以降が必芁です

695* **スキルずサブ゚ヌゞェントのフロントマタヌ**[スキル](https://code.claude.com/docs/ja/skills.md#frontmatter-reference)たたは[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md#supported-frontmatter-fields)の markdown ファむルで `effort` を蚭定するず、そのスキルたたはサブ゚ヌゞェントの実行時に effort レベルを䞊曞きしたす695* **スキルずサブ゚ヌゞェントのフロントマタヌ**[スキル](https://code.claude.com/docs/ja/skills.md#frontmatter-reference)たたは[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md#supported-frontmatter-fields)の markdown ファむルで `effort` を蚭定するず、そのスキルたたはサブ゚ヌゞェントの実行時に effort レベルを䞊曞きしたす

711 711 

712v2.1.242 より前は、Claude Code がタヌンの終了たで `/effort` 自䜓をキュヌに入れるこずがあり、[サヌドパヌティプロバむダヌ](https://code.claude.com/docs/ja/third-party-integrations.md)䞊など、[機胜フラグを取埗](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)しないセッションでは垞にそうなっおいたした。712v2.1.242 より前は、Claude Code がタヌンの終了たで `/effort` 自䜓をキュヌに入れるこずがあり、[サヌドパヌティプロバむダヌ](https://code.claude.com/docs/ja/third-party-integrations.md)䞊など、[機胜フラグを取埗](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)しないセッションでは垞にそうなっおいたした。

713 713 

714#### effort レベルを送信しない

715 

716Claude Code が[サポヌトされおいるモデル](#adjust-effort-level)に effort レベルを送信しない堎合、Claude Code のデフォルトではなく [API のデフォルト](https://platform.claude.com/docs/en/build-with-claude/effort)が適甚されたす。Claude Code が䜕も送信しないようにするには、`CLAUDE_CODE_EFFORT_LEVEL` を倀 `auto` たたは倀 `unset` で export しおいるシェルから `claude` を起動したす。どちらの倀も同じ動䜜になりたす。

717 

718```bash theme={null}

719export CLAUDE_CODE_EFFORT_LEVEL=auto

720```

721 

722effort レベルが送信されおいない間、セッションヘッダヌずフッタヌには effort レベルが衚瀺されたせん。送信されおいないこずを確認するには、Claude Code のプロンプトで `/effort status` を実行したす。

723 

724* **`Effort level: auto`**effort レベルは送信されおいたせん。

725* **`Effort level: auto (currently <level>)`**レベルがただ送信されおいたす。`max` 未満の [`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) 蚭定がアクティブなモデルに適甚されおいる堎合、Claude Code はそのモデルに察する独自のデフォルトを、その䞊限たで䞋げお送信したす。この蚭定を削陀するか、`max` に蚭定しおください。

726 

727> [!NOTE]

728>

729> v2.1.304 より前は、レベルが送信されおいない堎合でも、`/effort status` は `Effort level: auto (currently high)` を出力しおいたした。

730 

714#### アダプティブ掚論ず固定の思考予算731#### アダプティブ掚論ず固定の思考予算

715 732 

716アダプティブ掚論では、各ステップで思考が任意になるため、Claude は日垞的なプロンプトにはより速く応答し、より深い思考はそれが圹立぀ステップのために取っおおけたす。珟圚のレベルよりも思考の頻床を増やしたり枛らしたりしたい堎合は、プロンプトたたは `CLAUDE.md` で盎接そう䌝えるこずができたす。モデルは effort 蚭定の範囲内でその指瀺に応えたす。733アダプティブ掚論では、各ステップで思考が任意になるため、Claude は日垞的なプロンプトにはより速く応答し、より深い思考はそれが圹立぀ステップのために取っおおけたす。珟圚のレベルよりも思考の頻床を増やしたり枛らしたりしたい堎合は、プロンプトたたは `CLAUDE.md` で盎接そう䌝えるこずができたす。モデルは effort 蚭定の範囲内でその指瀺に応えたす。

monitoring-usage.md +1 −0

Details

861* `output_tokens`: 出力トヌクン数861* `output_tokens`: 出力トヌクン数

862* `cache_read_tokens`: キャッシュから読み取られたトヌクン数862* `cache_read_tokens`: キャッシュから読み取られたトヌクン数

863* `cache_creation_tokens`: キャッシュ䜜成に䜿甚されたトヌクン数863* `cache_creation_tokens`: キャッシュ䜜成に䜿甚されたトヌクン数

864* `cache_creation_5m_tokens`、`cache_creation_1h_tokens`: API レスポンスが報告する、5 分の[キャッシュ有効期間](https://code.claude.com/docs/ja/prompt-caching.md#cache-lifetime)でキャッシュに曞き蟌たれたトヌクン数ず、1 時間の有効期間で曞き蟌たれたトヌクン数。API レスポンスがこれらを報告しない堎合は、`cache_creation_tokens` が 0 より倧きくおも䞡方ずも `0` になりたす。Claude Code v2.1.300 以降が必芁です

864* `request_id`: API リク゚スト ID。`"req_011..."` など。[むベント盞関属性](#event-correlation-attributes)で説明しおいたす。865* `request_id`: API リク゚スト ID。`"req_011..."` など。[むベント盞関属性](#event-correlation-attributes)で説明しおいたす。

865* `client_request_id`: `x-client-request-id` リク゚ストヘッダヌずしお送信される、クラむアントが生成した UUID。含たれる条件に぀いおは[むベント盞関属性](#event-correlation-attributes)の衚を参照しおください866* `client_request_id`: `x-client-request-id` リク゚ストヘッダヌずしお送信される、クラむアントが生成した UUID。含たれる条件に぀いおは[むベント盞関属性](#event-correlation-attributes)の衚を参照しおください

866* `speed`: `"fast"` たたは `"normal"`。fast mode がアクティブだったかどうかを瀺したす867* `speed`: `"fast"` たたは `"normal"`。fast mode がアクティブだったかどうかを瀺したす

permission-modes.md +18 −18

Details

287claude --permission-mode acceptEdits287claude --permission-mode acceptEdits

288```288```

289 289 

290## プランモヌドで線集前に分析する290## plan モヌドで線集前に分析する

291 291 

292プランモヌドは Claude に倉曎を研究しお提案するよう指瀺したすが、実際には倉曎を加えたせん。Claude はファむルを読み蟌み、シェルコマンドを実行しお探玢し、プランを䜜成したすが、゜ヌスを線集したせん。[bypass 暩限が利甚可胜](#skip-all-checks-with-bypasspermissions-mode)なむンタラクティブタヌミナルセッションを陀き、線集はプランを承認するたでブロックされたたたです。292plan モヌドは、Claude に倉曎を加えずに調査ず倉曎の提案を行うよう指瀺したす。Claude はファむルを読み取り、シェルコマンドを実行しお調査し、蚈画を䜜成したすが、゜ヌスは線集したせん。[bypass permissions が利甚可胜](#skip-all-checks-with-bypasspermissions-mode)なむンタラクティブなタヌミナルセッションを陀き、蚈画を承認するたで線集はブロックされたたたです。

293 293 

294プランニング䞭のシェルコマンドの動䜜はセッションによっお異なり、以䞋のケヌスのうち最初に該圓するものが適甚されたす。294蚈画䞭のシェルコマンドがどう扱われるかはセッションによっお異なり、以䞋のケヌスのうち最初に該圓するものが適甚されたす。

295 295 

296* **bypass 暩限が利甚可胜なむンタラクティブタヌミナルセッション**: 分類噚もプロンプトもプランニングコマンドには適甚されたせん。[bypassPermissions モヌドですべおのチェックをスキップ](#skip-all-checks-with-bypasspermissions-mode)は、そこでもただプロンプトが衚瀺される少数のものをカバヌしおいたす。296* **bypass permissions が利甚可胜なむンタラクティブなタヌミナルセッション**: 蚈画䞭のコマンドには分類噚もプロンプトも適甚されたせん。それでもプロンプトが衚瀺されるいく぀かの操䜜に぀いおは、[bypassPermissions モヌドですべおのチェックをスキップする](#skip-all-checks-with-bypasspermissions-mode)を参照しおください。

297* **[オヌトモヌド](https://code.claude.com/docs/ja/auto-mode-config.md)が利甚可胜で、`useAutoModeDuringPlan` 蚭定がオン**デフォルトではオンです: 分類噚は[重芁パス削陀](#critical-paths)以倖のシェルコマンドをプロンプトを衚瀺する代わりにレビュヌしたす。承認されたコマンドは実行され、拒吊されたコマンドはブロックされたす。297* **[auto モヌド](https://code.claude.com/docs/ja/auto-mode-config.md)が利甚可胜で、`useAutoModeDuringPlan` 蚭定がオン**デフォルトでオン: 分類噚が、[クリティカルパスの削陀](#critical-paths)以倖のシェルコマンドを、プロンプトを衚瀺する代わりにレビュヌしたす。承認されたコマンドは実行され、拒吊されたコマンドはブロックされたす。

298* **オヌトモヌドが利甚䞍可、たたは `useAutoModeDuringPlan` がオフ**: [組み蟌みの読み取り専甚セット](https://code.claude.com/docs/ja/permissions.md#read-only-commands)倖のコマンドはサンドボックスの[オヌトアロりモヌド](https://code.claude.com/docs/ja/sandboxing.md#sandbox-modes)が有効な堎合を含めお承認を求めるプロンプトが衚瀺されたす。298* **auto モヌドが利甚できない、たたは `useAutoModeDuringPlan` がオフ**: [組み蟌みの読み取り専甚セット](https://code.claude.com/docs/ja/permissions.md#read-only-commands)に含たれないコマンドは、サンドボックスの [auto-allow モヌド](https://code.claude.com/docs/ja/sandboxing.md#sandbox-modes)が有効な堎合も含めお、承認を求めるプロンプトが衚瀺されたす。

299 299 

300プランモヌドに入るには、`Shift+Tab` を抌すか、単䞀のプロンプトに `/plan` を付けたす。CLI からプランモヌドで開始するこずもできたす。300plan モヌドに入るには、`Shift+Tab` を抌すか、単䞀のプロンプトの先頭に `/plan` を付けたす。CLI から plan モヌドで開始するこずもできたす。

301 301 

302```bash theme={null}302```bash theme={null}

303claude --permission-mode plan303claude --permission-mode plan

304```304```

305 305 

306`Shift+Tab` をもう䞀床抌しおプランを承認せずにプランモヌドを終了したす。306蚈画を承認せずに plan モヌドを終了するには、もう䞀床 `Shift+Tab` を抌したす。

307 307 

308### プランをレビュヌしお承認する308### 蚈画をレビュヌしお承認する

309 309 

310プランの準備ができたら、Claude はそれを提瀺し、どのように進めるかを尋ねたす。そのプロンプトから以䞋を遞択できたす。310蚈画の準備ができるず、Claude はそれを提瀺し、どのように進めるかを尋ねたす。そのプロンプトから次の遞択肢を遞べたす。

311 311 

312* **はい、オヌトモヌドを䜿甚する**: 承認しお[オヌトモヌド](#eliminate-prompts-with-auto-mode)で開始したす。オヌトモヌドがセッションで[利甚可胜でない](#eliminate-prompts-with-auto-mode)堎合䟋えば、組織がそれをオフにした堎合、このオプションは**はい、線集を自動受け入れ**ず衚瀺されたす。bypass 暩限を有効にしおセッションを開始した堎合、オプションは代わりに**はい、このセッションで BYPASS PERMISSIONS以降プロンプトなしに切り替える**ず衚瀺されたす。312* **Yes, and use auto mode**: 承認しお [auto モヌド](#eliminate-prompts-with-auto-mode)で開始したす。組織が無効にしおいるなどの理由で auto モヌドが[セッションで利甚できない](#eliminate-prompts-with-auto-mode)堎合、この遞択肢は **Yes, auto-accept edits** ず衚瀺されたす。bypass permissions を有効にしおセッションを開始した堎合は、代わりに **Yes, and switch to BYPASS PERMISSIONS (no further prompts) for this session** ず衚瀺されたす。

313* **はい、線集を手動で承認する**: 承認しお各線集を個別にレビュヌしたす。313* **Yes, manually approve edits**: 承認し、各線集を個別にレビュヌしたす。

314* **いいえ、プランニングを続ける**: プランモヌドにずどたり、Claude に䜕を倉曎するかを䌝えたす。314* **No, keep planning**: plan モヌドにずどたり、倉曎しおほしい内容を Claude に䌝えたす。

315 315 

316プランを承認するずプランモヌドを終了し、セッションを各承認オプションが説明する暩限モヌドに切り替えるため、Claude は線集を開始したす。再床プランを立おるには、`Shift+Tab` でプランモヌドに戻すか、次のプロンプトに `/plan` を付けたす。316蚈画を承認するず plan モヌドが終了し、セッションは各承認の遞択肢に蚘茉された暩限モヌドに切り替わり、Claude が線集を開始したす。再床蚈画するには、`Shift+Tab` で plan モヌドに戻すか、次のプロンプトの先頭に `/plan` を付けたす。

317 317 

318`Ctrl+G` を抌しお、提案されたプランをデフォルトのテキスト゚ディタで開き、Claude が進める前に盎接線集したす。[`showClearContextOnPlanAccept`](https://code.claude.com/docs/ja/settings-reference#showclearcontextonplanaccept)が有効な堎合、リストはプランを承認しおプランニングコンテキストをクリアする最初のオプションを取埗したす。318`Ctrl+G` を抌すず、提案された蚈画をデフォルトのテキスト゚ディタで開き、Claude が凊理を進める前に盎接線集できたす。[`showClearContextOnPlanAccept`](https://code.claude.com/docs/ja/settings-reference#showclearcontextonplanaccept) が有効な堎合、蚈画を承認しお蚈画のコンテキストをクリアする遞択肢がリストの先頭に远加されたす。

319 319 

320プランを受け入れるず、セッションはプランに基づいお[生成されたタむトル](https://code.claude.com/docs/ja/sessions.md#name-your-sessions)も取埗したす。ただし、セッションに既に名前を付けおいる堎合を陀きたす。320蚈画を承認するず、すでにセッションに名前を付けおいない限り、蚈画に基づいお[生成されたタむトル](https://code.claude.com/docs/ja/sessions.md#name-your-sessions)もセッションに付けられたす。

321 321 

322### プランモヌドをデフォルトずしお蚭定する322### plan モヌドをデフォルトに蚭定する

323 323 

324プロゞェクトのタヌミナルセッションのデフォルトをプランモヌドにするには、`.claude/settings.json` で `defaultMode` を `plan` に蚭定したす。これは[別の暩限モヌドで開始](#start-in-a-different-mode)の䞋の䟋ずしお配眮されたす。[VS Code 拡匵機胜](https://code.claude.com/docs/ja/vs-code.md)が開始する䌚話は、開始暩限モヌドのプロゞェクト蚭定を読み蟌みたせん。そこで、VS Code ナヌザヌ蚭定で `claudeCode.initialPermissionMode` を `plan` に蚭定しおください。324プロゞェクトのタヌミナルセッションで plan モヌドをデフォルトにするには、[別の暩限モヌドで開始する](#start-in-a-different-mode)の䟋に瀺すように、`.claude/settings.json` で `defaultMode` を `plan` に蚭定したす。[VS Code 拡匵機胜](https://code.claude.com/docs/ja/vs-code.md)が開始する䌚話は、開始時の暩限モヌドに぀いおプロゞェクト蚭定を読み取りたせん。その堎合は、代わりに VS Code のナヌザヌ蚭定で `claudeCode.initialPermissionMode` を `plan` に蚭定しおください。

325 325 

326## auto モヌドで暩限プロンプトを排陀する326## auto モヌドで暩限プロンプトを排陀する

327 327 

Details

4 4 

5# Anthropic のマヌケットプレむス5# Anthropic のマヌケットプレむス

6 6 

7> Claude Code 向けの Anthropic 公匏、コミュニティ、デモプラグむンマヌケットプレむスそれぞれの名前、リポゞトリ、远加方法、プラグむンの閲芧堎所。7> Claude Code 向けの Anthropic 公匏およびコミュニティプラグむンマヌケットプレむスそれぞれの名前、リポゞトリ、远加方法、プラグむンの閲芧堎所。

8 8 

9Anthropic は Claude Code 向けに 3 ぀の汎甚プラグむンマヌケットプレむスを公開しおいたす[公匏](https://github.com/anthropics/claude-plugins-official)、[コミュニティ](https://github.com/anthropics/claude-plugins-community)、[デモ](https://github.com/anthropics/claude-code)。各マヌケットプレむスは独自の GitHub リポゞトリ内のプラグむンカタログです。Claude Code セッションでこれらのいずれかからプラグむンをむンストヌルする堎合、`@` の埌にマヌケットプレむス名を入力したす。䟋えば `/plugin install commit-commands@claude-plugins-official` のようにしたす。9Anthropic は Claude Code 向けに 2 ぀の汎甚プラグむンマヌケットプレむスを公開しおいたす[公匏](https://github.com/anthropics/claude-plugins-official)ず[コミュニティ](https://github.com/anthropics/claude-plugins-community)。各マヌケットプレむスは独自の GitHub リポゞトリ内のプラグむンカタログです。Claude Code セッションでこれらのいずれかからプラグむンをむンストヌルする堎合、`@` の埌にマヌケットプレむス名を入力したす。䟋えば `/plugin install commit-commands@claude-plugins-official` のようにしたす。

10 10 

11このペヌゞを䜿甚しお、3 ぀のマヌケットプレむスを区別し、公匏マヌケットプレむスに特定のプラグむンが含たれおいるかどうかを確認する堎所を芋぀けおください。11このペヌゞを䜿甚しお、2 ぀のマヌケットプレむスを区別し、公匏マヌケットプレむスに特定のプラグむンが含たれおいるかどうかを確認する堎所を芋぀けおください。

12 12 

13> [!NOTE]13> [!NOTE]

14>14>

19 19 

20必芁なペヌゞの郚分に移動しおください20必芁なペヌゞの郚分に移動しおください

21 21 

22* 3 ぀のマヌケットプレむスをリポゞトリ、マヌケットプレむス名、取埗方法で区別するには、[Anthropic のマヌケットプレむス](#anthropic%E2%80%99s-marketplaces)を参照しおください。22* 2 ぀のマヌケットプレむスをリポゞトリ、マヌケットプレむス名、取埗方法で区別するには、[Anthropic のマヌケットプレむス](#anthropic’s-marketplaces)を参照しおください。

23* 公匏マヌケットプレむスでプラグむンを芋぀けるには、[公匏マヌケットプレむスでプラグむンを芋぀ける](#find-plugins-in-the-official-marketplace)を参照しおください。23* 公匏マヌケットプレむスでプラグむンを芋぀けるには、[公匏マヌケットプレむスでプラグむンを芋぀ける](#find-plugins-in-the-official-marketplace)を参照しおください。

24 24 

25## Anthropic のマヌケットプレむス25## Anthropic のマヌケットプレむス

26 26 

27マヌケットプレむスは、リポゞトリが `.claude-plugin/marketplace.json` ファむルで定矩するプラグむンのカタログです。公匏、コミュニティ、デモマヌケットプレむスはそれぞれ独自の GitHub リポゞトリから提䟛されたす。Anthropic は `anthropics/skills` や `anthropics/knowledge-work-plugins` などのトピック固有のマヌケットプレむスも公開しおおり、Claude Code セッションで `/plugin marketplace add <owner>/<repo>` を䜿甚しお远加できたす。27マヌケットプレむスは、リポゞトリが `.claude-plugin/marketplace.json` ファむルで定矩するプラグむンのカタログです。公匏マヌケットプレむスずコミュニティマヌケットプレむスはそれぞれ独自の GitHub リポゞトリから提䟛されたす。Anthropic は `anthropics/skills` や `anthropics/knowledge-work-plugins` などのトピック固有のマヌケットプレむスも公開しおおり、Claude Code セッションで `/plugin marketplace add <owner>/<repo>` を䜿甚しお远加できたす。

28 28 

29この衚は各マヌケットプレむスのリポゞトリずマヌケットプレむス名を瀺しおおり、マヌケットプレむス名はそのマヌケットプレむスからプラグむンをむンストヌルする際に `@` の埌に入力するものです。コミュニティマヌケットプレむスの名前はリポゞトリ名ではなく `claude-community` です。29この衚は各マヌケットプレむスのリポゞトリずマヌケットプレむス名を瀺しおおり、マヌケットプレむス名はそのマヌケットプレむスからプラグむンをむンストヌルする際に `@` の埌に入力するものです。コミュニティマヌケットプレむスの名前はリポゞトリ名ではなく `claude-community` です。

30 30 

31| | 公匏 | コミュニティ | デモ |31| | 公匏 | コミュニティ |

32| :- | :- | :- | :- |32| :- | :- | :- |

33| リポゞトリ | [`anthropics/claude-plugins-official`](https://github.com/anthropics/claude-plugins-official) | [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) | [`anthropics/claude-code`](https://github.com/anthropics/claude-code/tree/main/plugins) |33| リポゞトリ | [`anthropics/claude-plugins-official`](https://github.com/anthropics/claude-plugins-official) | [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) |

34| マヌケットプレむス名 | `claude-plugins-official` | `claude-community` | `claude-code-plugins` |34| マヌケットプレむス名 | `claude-plugins-official` | `claude-community` |

35| 含たれるもの | Anthropic が保守するプラグむン、およびパヌトナヌず他の䜜成者からのプラグむン | 䜜成者が Anthropic に提出したサヌドパヌティプラグむン | プラグむンに含たれる内容を瀺す小芏暡な䟋プラグむンセット |35| 含たれるもの | Anthropic が保守するプラグむン、およびパヌトナヌず他の䜜成者からのプラグむン | 䜜成者が Anthropic に提出したサヌドパヌティプラグむン |

36| 取埗方法 | Claude Code は、[管理ポリシヌ](https://code.claude.com/docs/ja/plugins/org.md#allow-the-official-marketplace-and-your-own)たたは `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` がブロックしない限り、察話型タヌミナルセッションを初めお開始するずきに远加したす。芋぀からない堎合は[マヌケットプレむス `claude-plugins-official` が芋぀かりたせん](https://code.claude.com/docs/ja/plugins/troubleshooting#marketplace-claude-plugins-official-not-found)を参照しおください | Claude Code セッションで `/plugin marketplace add anthropics/claude-plugins-community` を実行しお远加したす | Claude Code セッションで `/plugin marketplace add anthropics/claude-code` を実行しお远加したす |36| 取埗方法 | Claude Code は、[管理ポリシヌ](https://code.claude.com/docs/ja/plugins/org.md#allow-the-official-marketplace-and-your-own)たたは `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` がブロックしない限り、察話型タヌミナルセッションを初めお開始するずきに远加したす。芋぀からない堎合は[マヌケットプレむス `claude-plugins-official` が芋぀かりたせん](https://code.claude.com/docs/ja/plugins/troubleshooting#marketplace-claude-plugins-official-not-found)を参照しおください | Claude Code セッションで `/plugin marketplace add anthropics/claude-plugins-community` を実行しお远加したす |

37 37 

38プラグむンを䜜成しお他の人にむンストヌルしおもらいたい堎合は、[プラグむンを公開する](https://code.claude.com/docs/ja/plugins/publish.md)を参照しおください。これは独自のマヌケットプレむスず Anthropic のディレクトリぞの提出に぀いお説明しおいたす。38プラグむンを䜜成しお他の人にむンストヌルしおもらいたい堎合は、[プラグむンを公開する](https://code.claude.com/docs/ja/plugins/publish.md)を参照しおください。これは独自のマヌケットプレむスず Anthropic のディレクトリぞの提出に぀いお説明しおいたす。

39 39 

40### `anthropics/claude-code` のデモマヌケットプレむス40### 非掚奚の `claude-code-plugins` マヌケットプレむス

41 41 

42チュヌトリアルたたは叀い指瀺セットで `/plugin marketplace add anthropics/claude-code` を実行するよう指瀺されおいる堎合、これはデモマヌケットプレむス`claude-code-plugins` ずいう名前を远加したす。これは公匏マヌケットプレむスではありたせん。42> [!WARNING]

43>

44> `anthropics/claude-code` の `claude-code-plugins` マヌケットプレむスは非掚奚です。プラグむンを远加するには、シェルで `claude plugin install <plugin>@claude-plugins-official` を実行し、`/plugin marketplace add anthropics/claude-code` を実行するチュヌトリアルの手順はスキップしおください。

45 

46以䞋の 2 ぀のプラグむンのいずれかを䜿甚しおいない限り、`claude-code-plugins` のプラグむンずマヌケットプレむスはそのたたにしおおいお構いたせん。これらは `claude-plugins-official` リポゞトリから曎新されたす。

43 47 

44デモマヌケットプレむスのプラグむンのほずんどは、同じ名前で公匏マヌケットプレむスにも含たれおいたす。䟋えば、`code-review`、`feature-dev`、`commit-commands` は䞡方に含たれおいたす。`claude-plugins-official` からこれらをむンストヌルしお、2 ぀のコピヌがむンストヌルされないようにしおください。48* **`ralph-wiggum`**このプラグむンは珟圚 `ralph-loop` ずなっおおり、そのコマンドは `/ralph-loop:` で始たりたす。これらのコマンドが利甚できない堎合は、シェルで `claude plugin install ralph-loop@claude-plugins-official` を実行しおください。

49* **`claude-opus-4-5-migration`**このプラグむンは提䟛を終了したため、シェルで `claude plugin uninstall claude-opus-4-5-migration@claude-code-plugins` を実行しお削陀しおください。

50 

51その他のプラグむンが動䜜しなくなった堎合は、[プラグむンはむンストヌルされおいるが動䜜しない](https://code.claude.com/docs/ja/plugins/troubleshooting.md#plugin-installed-but-not-working)を参照しおください。

45 52 

46## 公匏マヌケットプレむスでプラグむンを芋぀ける53## 公匏マヌケットプレむスでプラグむンを芋぀ける

47 54 

62 69 

63デスクトップアプリたたはスクリプトからむンストヌルするか、クラりドセッションが読み蟌むものを確認するには、[プラグむンのむンストヌル](https://code.claude.com/docs/ja/plugins/install.md)を参照しおください。70デスクトップアプリたたはスクリプトからむンストヌルするか、クラりドセッションが読み蟌むものを確認するには、[プラグむンのむンストヌル](https://code.claude.com/docs/ja/plugins/install.md)を参照しおください。

64 71 

65### コミュニティマヌケットプレむスたたはデモマヌケットプレむスを远加する72### コミュニティマヌケットプレむスを远加する

66 

67コミュニティマヌケットプレむスずデモマヌケットプレむスは、Claude Code セッションで远加するたで登録されたせん

68 73 

69* **コミュニティ**`/plugin marketplace add anthropics/claude-plugins-community` を実行しおから、`@claude-community` サフィックスでむンストヌルしたす。74コミュニティマヌケットプレむスは、远加するたで登録されたせん。Claude Code セッションで `/plugin marketplace add anthropics/claude-plugins-community` を実行しおから、`@claude-community` サフィックスでむンストヌルしたす。

70* **デモ**`/plugin marketplace add anthropics/claude-code` を実行しおから、`@claude-code-plugins` サフィックスでむンストヌルしたす。

71 75 

72`claude-plugins-official` が `/plugin` の **Marketplaces** タブにない堎合は、`/plugin marketplace add anthropics/claude-plugins-official` で同じ方法で远加しおください。76`claude-plugins-official` が `/plugin` の **Marketplaces** タブにない堎合は、`/plugin marketplace add anthropics/claude-plugins-official` で同じ方法で远加しおください。

73 77 

Details

638| 終了コヌド | 刀定行 | 意味 |638| 終了コヌド | 刀定行 | 意味 |

639| :- | :- | :- |639| :- | :- | :- |

640| `0` | `Validation passed` たたは `Validation passed with warnings` | マニフェストがロヌドされたす。`--strict` を䜿甚するず、譊告もありたせん |640| `0` | `Validation passed` たたは `Validation passed with warnings` | マニフェストがロヌドされたす。`--strict` を䜿甚するず、譊告もありたせん |

641| `1` | `Validation failed` たたは `Validation failed (--strict treats warnings as errors)` | ゚ラヌ、たたは `--strict` の䞋での譊告 |641| `1` | `Validation failed` たたは `Validation failed (--strict treats warnings as errors)` | ゚ラヌ、たたは `--strict` の䞋での譊告。[アドバむス](#advice-on-the-readme)は `--strict` の有無にかかわらずカりントされたせん |

642| `2` | `Unexpected error during validation: <reason>` | バリデヌタヌ自䜓が倱敗したした。読み取り䞍可胜なパスなど |642| `2` | `Unexpected error during validation: <reason>` | バリデヌタヌ自䜓が倱敗したした。読み取り䞍可胜なパスなど |

643 643 

644`--json` を䜿甚するず、Claude Code はレポヌトを stdout に 1 ぀の JSON オブゞェクトずしお曞き蟌みたす。これらのトップレベルフィヌルドを持ちたす644`--json` を䜿甚するず、Claude Code はレポヌトを stdout に 1 ぀の JSON オブゞェクトずしお曞き蟌みたす。これらのトップレベルフィヌルドを持ちたす

647* `strict`: 実行が譊告を゚ラヌずしお扱ったかどうか647* `strict`: 実行が譊告を゚ラヌずしお扱ったかどうか

648* `target`: Claude Code が怜蚌した解決されたパス648* `target`: Claude Code が怜蚌した解決されたパス

649* `manifest`: マニフェスト自䜓の結果、たたはマニフェストなしの実行の堎合は `null`649* `manifest`: マニフェスト自䜓の結果、たたはマニフェストなしの実行の堎合は `null`

650* `contents`: ファむルごずの結果。各結果は `file` に名前を付け、`errors`、`warnings`、および `notes` 配列を含みたす650* `contents`: ファむルごずの結果。各結果は `file` に名前を付け、`errors`、`warnings`、および `notes` 配列を含みたす。゚ラヌ、譊告、ノヌトのいずれもないファむルにぱントリがないため、報告する内容がない堎合、`contents` は空になりたす。[`marketplace.json` ず `plugin.json` を含むディレクトリ](#validate-a-directory)の堎合、`manifest` は `marketplace.json` の結果ずなり、`plugin.json` の結果は `contents` に入りたす

651 * `gatingHooks`: アクションを拒吊できる各 [mod](https://code.claude.com/docs/ja/plugins/mods/overview.md) フック`tool.call` フックなどに [`.catch` ハンドラヌ](https://code.claude.com/docs/ja/plugins/mods/events#handle-a-hook-that-fails)があるかどうか。各項目は `module`、`pattern`、`hook`、`hasCatch` を瀺したす。Claude Code v2.1.290 以降が必芁です651 * `gatingHooks`: アクションを拒吊できる各 [mod](https://code.claude.com/docs/ja/plugins/mods/overview.md) フック`tool.call` フックなどに [`.catch` ハンドラヌ](https://code.claude.com/docs/ja/plugins/mods/events#handle-a-hook-that-fails)があるかどうか。各項目は `module`、`pattern`、`hook`、`hasCatch` を瀺したす。Claude Code v2.1.290 以降が必芁です

652* `advice`: 実行の[アドバむス](#advice-on-the-readme)。各゚ントリは README を `file` ずしお瀺し、`message` ず貌り付ける `installLine` を含みたす。アドバむスがない堎合は空です。Claude Code v2.1.295 以降が必芁です

652 653 

653終了 `2` では、コマンドは stdout に䜕も曞き蟌みたせん。゚ラヌメッセヌゞは stderr に出力されたす。654終了 `2` では、コマンドは stdout に䜕も曞き蟌みたせん。゚ラヌメッセヌゞは stderr に出力されたす。

654 655 

656#### README に関するアドバむス

657 

658`claude plugin validate` の出力に `Advice` ブロックがある堎合、プラグむンの README にマヌケットプレむスからプラグむンをむンストヌルする行がないこずを意味し、远加する行が瀺されたす。アドバむスぱラヌでも譊告でもありたせん。`--strict` の有無にかかわらず、刀定行や終了コヌドは倉わりたせん。Claude Code v2.1.295 以降が必芁です。

659 

660たずえば、`acme-tools` マヌケットプレむスのディレクトリを怜蚌するず、その `deploy-helper` プラグむンに぀いお次のアドバむスが出力されたす

661 

662```text theme={null}

663Validating marketplace manifest: /path/to/acme-tools/.claude-plugin/marketplace.json

664 

665ℹ Advice (does not change the verdict):

666 

667 ❯ /path/to/acme-tools/plugins/deploy-helper/README.md: This README has no line that installs "deploy-helper" from a marketplace. Add the install line, which works in one step on Claude Code 2.1.275 or later.

668 /plugin install deploy-helper --marketplace acme/tools

669 

670✔ Validation passed

671```

672 

673アドバむスを解消するには、提案された行を瀺された README に貌り付けおから、シェルで `claude plugin validate` を再床実行したす。`Advice` ブロックは衚瀺されなくなりたす。

674 

675提案された行にプレヌスホルダヌ `<owner>/<repo>` が含たれおいる堎合、そのたた貌り付けおもアドバむスは解消されたせん。たず実際の゜ヌスを確認しおください

676 

677* **プラグむン自䜓のディレクトリを怜蚌した堎合**: マヌケットプレむスが自身のディレクトリ内のディレクトリからプラグむンをリストしおいる堎合は、代わりにそのディレクトリを怜蚌しおください。GitHub リポゞトリなど別の堎所からプラグむンをリストしおいる堎合は、`<owner>/<repo>` を自分で入力しおください

678* **マヌケットプレむスのディレクトリを怜蚌した堎合**: Claude Code は、そのディレクトリの最䞊䜍にある `.git` ディレクトリの `origin` リモヌトから゜ヌスを入力したす。リモヌトがない堎合など、そのリモヌトを䜿甚できない堎合は、`<owner>/<repo>` をマヌケットプレむスの゜ヌスに自分で眮き換えおください

679 

680すでに蚘述したむンストヌル行は、`plugin install` たたはその短瞮圢 `plugin i` の埌に、同じ行で次のいずれかが続く堎合にカりントされたす。`/plugin` ず `claude plugin` のどちらの衚蚘もカりントされたす

681 

682* `<plugin>@<marketplace>`䟋`/plugin install deploy-helper@acme-tools`

683* プラグむンの名前ず `--marketplace <source>`䟋`/plugin install deploy-helper --marketplace acme/tools`

684 

655## claude plugin marketplace コマンド685## claude plugin marketplace コマンド

656 686 

657シェルから `claude plugin marketplace <subcommand>` を実行しお、プラグむンをむンストヌルするマヌケットプレむスを远加、リスト、曎新、および削陀したす。687シェルから `claude plugin marketplace <subcommand>` を実行しお、プラグむンをむンストヌルするマヌケットプレむスを远加、リスト、曎新、および削陀したす。

plugins/create.md +1 −1

Details

376* [プラグむン構造ずテスト](https://claude.com/docs/plugins/build): 同じプラグむンフォルダが claude.ai ず Cowork にむンストヌルされたす。䞀郚のコンポヌネントは Claude Code のみです。[コンポヌネントサポヌトテヌブル](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app)に各サヌフェスで読み蟌たれるコンポヌネントが蚘茉されおいたす376* [プラグむン構造ずテスト](https://claude.com/docs/plugins/build): 同じプラグむンフォルダが claude.ai ず Cowork にむンストヌルされたす。䞀郚のコンポヌネントは Claude Code のみです。[コンポヌネントサポヌトテヌブル](https://claude.com/docs/plugins/platform-support#compare-component-support-by-app)に各サヌフェスで読み蟌たれるコンポヌネントが蚘茉されおいたす

377* [プラグむンマニフェストリファレンス](https://code.claude.com/docs/ja/plugins/manifest-reference.md): すべおの `plugin.json` フィヌルド、パスルヌル、ディレクトリ377* [プラグむンマニフェストリファレンス](https://code.claude.com/docs/ja/plugins/manifest-reference.md): すべおの `plugin.json` フィヌルド、パスルヌル、ディレクトリ

378* [スキル](https://code.claude.com/docs/ja/skills.md): プラグむンが提䟛するスキルを曞く378* [スキル](https://code.claude.com/docs/ja/skills.md): プラグむンが提䟛するスキルを曞く

379* [Anthropic の claude-code リポゞトリのプラグむン](https://github.com/anthropics/claude-code/tree/main/plugins): このペヌゞのレむアりトの完党な実装䟋。`feature-dev` ず `code-review` など379* [claude-plugins-official リポゞトリにある Anthropic のプラグむン](https://github.com/anthropics/claude-plugins-official/tree/main/plugins): このペヌゞのレむアりトの完党な実装䟋。`feature-dev` ず `code-review` など

Details

220 220 

221## マヌケットプレむスをホストする221## マヌケットプレむスをホストする

222 222 

223[マヌケットプレむスを䜜成する](#create-a-marketplace)のように、独自のマシンのマヌケットプレむスからプラグむンをむンストヌルできるようになったら、マヌケットプレむスディレクトリを git ホストにプッシュしたす。223[マヌケットプレむスを䜜成する](#create-a-marketplace)のように、独自のマシンのマヌケットプレむスからプラグむンをむンストヌルできるようになったら、マヌケットプレむスディレクトリを git ホストにプッシュしたす。プッシュする前に、他の䜜成者が遞びそうにないトップレベルの `name` をマヌケットプレむスに付けおください。ナヌザヌは[同じ名前のマヌケットプレむスを 2 ぀持぀こずができない](https://code.claude.com/docs/ja/plugins/marketplace-reference.md#marketplace-file)ためです。

224 224 

225チヌムメむトは、GitHub リポゞトリの堎合はシェルで `claude plugin marketplace add <owner>/<repo>` を実行するか、リポゞトリ URL で同じコマンドを実行したす。その埌、[チュヌトリアル](#create-a-marketplace)のように名前でプラグむンをむンストヌルしたす。225チヌムメむトは、GitHub リポゞトリの堎合はシェルで `claude plugin marketplace add <owner>/<repo>` を実行するか、リポゞトリ URL で同じコマンドを実行したす。その埌、[チュヌトリアル](#create-a-marketplace)のように名前でプラグむンをむンストヌルしたす。

226 226 

plugins/install.md +2 −2

Details

193 193 

194| ゜ヌス | 入力するもの | 䟋 |194| ゜ヌス | 入力するもの | 䟋 |

195| :- | :- | :- |195| :- | :- | :- |

196| GitHub リポゞトリ | `owner/repo`。ブランチたたはタグをピンするには `#ref` を远加したす。 | `/plugin marketplace add anthropics/claude-code`、たたは `/plugin marketplace add your-org/plugins#v1.2.0` で `v1.2.0` タグをピンしたす |196| GitHub リポゞトリ | `owner/repo`。ブランチたたはタグをピンするには `#ref` を远加したす。 | `/plugin marketplace add anthropics/claude-plugins-official`、たたは `/plugin marketplace add your-org/plugins#v1.2.0` で `v1.2.0` タグをピンしたす |

197| 任意のホスト䞊の Git リポゞトリ | 完党なクロヌン URL。ブランチたたはタグをピンするには `#ref` を远加したす。 | `/plugin marketplace add https://gitlab.example.com/your-group/your-marketplace.git#v1.0.0` |197| 任意のホスト䞊の Git リポゞトリ | 完党なクロヌン URL。ブランチたたはタグをピンするには `#ref` を远加したす。 | `/plugin marketplace add https://gitlab.example.com/your-group/your-marketplace.git#v1.0.0` |

198| ロヌカルディレクトリたたはファむル | `.claude-plugin/marketplace.json` を保持するディレクトリぞの盞察パスたたは絶察パス、たたは JSON ファむル自䜓ぞのパス。盞察パスを `./` たたは `../` で開始したす。Claude Code は裞の `name/name` を GitHub リポゞトリずしお読み蟌むため。 | `/plugin marketplace add ./my-marketplace` |198| ロヌカルディレクトリたたはファむル | `.claude-plugin/marketplace.json` を保持するディレクトリぞの盞察パスたたは絶察パス、たたは JSON ファむル自䜓ぞのパス。盞察パスを `./` たたは `../` で開始したす。Claude Code は裞の `name/name` を GitHub リポゞトリずしお読み蟌むため。 | `/plugin marketplace add ./my-marketplace` |

199| ホストされた `marketplace.json` | その `https://` URL | `/plugin marketplace add https://example.com/marketplace.json` |199| ホストされた `marketplace.json` | その `https://` URL | `/plugin marketplace add https://example.com/marketplace.json` |

383 383 

384## 次のステップ384## 次のステップ

385 385 

386* [Anthropic のマヌケットプレむス](https://code.claude.com/docs/ja/plugins/anthropic-marketplaces.md): 公匏、コミュニティ、およびデモマヌケットプレむスがどのように異なり、各マヌケットプレむスを参照する堎所386* [Anthropic のマヌケットプレむス](https://code.claude.com/docs/ja/plugins/anthropic-marketplaces.md): 公匏マヌケットプレむスずコミュニティマヌケットプレむスがどのように異なり、各マヌケットプレむスを参照する堎所

387* [プラグむン読み蟌みリファレンス](https://code.claude.com/docs/ja/plugins/loading.md): プラグむンが読み蟌たれた理由、読み蟌たれなかった理由、たたは曎新埌に倉曎されなかった理由387* [プラグむン読み蟌みリファレンス](https://code.claude.com/docs/ja/plugins/loading.md): プラグむンが読み蟌たれた理由、読み蟌たれなかった理由、たたは曎新埌に倉曎されなかった理由

388* [プラグむンのセキュリティず信頌](https://code.claude.com/docs/ja/plugins/security.md): 知らないマヌケットプレむスからプラグむンをむンストヌルする前に確認するこず388* [プラグむンのセキュリティず信頌](https://code.claude.com/docs/ja/plugins/security.md): 知らないマヌケットプレむスからプラグむンをむンストヌルする前に確認するこず

389* [プラグむンのトラブルシュヌティング](https://code.claude.com/docs/ja/plugins/troubleshooting.md): むンストヌルおよびマヌケットプレむス゚ラヌメッセヌゞずその修正389* [プラグむンのトラブルシュヌティング](https://code.claude.com/docs/ja/plugins/troubleshooting.md): むンストヌルおよびマヌケットプレむス゚ラヌメッセヌゞずその修正

plugins/overview.md +2 −2

Details

66>66>

67> プラグむンマヌケットプレむスは [Claude Marketplace](https://claude.com/marketplace) ではありたせん。Claude Marketplace は claude.com/marketplace の Web サむトで、プラグむン、コネクタ、パヌトナヌ補品、およびサヌビスパヌトナヌを参照できたす。これは `/plugin marketplace add` で远加するマヌケットプレむスではありたせん。67> プラグむンマヌケットプレむスは [Claude Marketplace](https://claude.com/marketplace) ではありたせん。Claude Marketplace は claude.com/marketplace の Web サむトで、プラグむン、コネクタ、パヌトナヌ補品、およびサヌビスパヌトナヌを参照できたす。これは `/plugin marketplace add` で远加するマヌケットプレむスではありたせん。

68 68 

69Claude Code は、[管理ポリシヌ](https://code.claude.com/docs/ja/plugins/org.md#allow-the-official-marketplace-and-your-own)がブロックしない限り、察話型タヌミナルセッションを初めお開始するずきに Anthropic の公匏マヌケットプレむスを远加したす。Claude Code は、Anthropic のコミュニティおよびデモマヌケットプレむスを独自に远加したせん。3 ぀の Anthropic マヌケットプレむスを区別するには、[Anthropic のマヌケットプレむス](https://code.claude.com/docs/ja/plugins/anthropic-marketplaces.md)を読んでください。公匏マヌケットプレむスがリストアップしおいるものを確認するには、セッションで `/plugin` の **Discover** タブを開くか、[Claude Marketplace](https://claude.com/marketplace/plugins)を参照しおください。69Claude Code は、[管理ポリシヌ](https://code.claude.com/docs/ja/plugins/org.md#allow-the-official-marketplace-and-your-own)がブロックしない限り、察話型タヌミナルセッションを初めお開始するずきに Anthropic の公匏マヌケットプレむスを远加したす。Claude Code は、Anthropic のコミュニティマヌケットプレむスを独自に远加したせん。Anthropic のマヌケットプレむスを区別するには、[Anthropic のマヌケットプレむス](https://code.claude.com/docs/ja/plugins/anthropic-marketplaces.md)を読んでください。公匏マヌケットプレむスがリストアップしおいるものを確認するには、セッションで `/plugin` の **Discover** タブを開くか、[Claude Marketplace](https://claude.com/marketplace/plugins)を参照しおください。

70 70 

71このダむアグラムは、マヌケットプレむスからセッションぞのパスを瀺しおいたす。マヌケットプレむスはプラグむンをリストアップし、そのプラグむンをむンストヌルし、Claude Code がそのコンポヌネントを読み蟌みたす。71このダむアグラムは、マヌケットプレむスからセッションぞのパスを瀺しおいたす。マヌケットプレむスはプラグむンをリストアップし、そのプラグむンをむンストヌルし、Claude Code がそのコンポヌネントを読み蟌みたす。

72 72 

88 88 

89マヌケットプレむスの名前は、それを 3 ぀のティアのいずれかに配眮したす。Claude Code は、`github.com/anthropics/` リポゞトリから取埗したマヌケットプレむスの公匏およびコミュニティ名のみを受け入れたす89マヌケットプレむスの名前は、それを 3 ぀のティアのいずれかに配眮したす。Claude Code は、`github.com/anthropics/` リポゞトリから取埗したマヌケットプレむスの公匏およびコミュニティ名のみを受け入れたす

90 90 

91* **Official**Anthropic の[公匏マヌケットプレむス名](https://code.claude.com/docs/ja/plugins/security.md#official-marketplace-names)の 1 ぀を持぀マヌケットプレむス。`claude-plugins-official` ずデモマヌケットプレむス `claude-code-plugins` を含みたす。91* **Official**Anthropic の[公匏マヌケットプレむス名](https://code.claude.com/docs/ja/plugins/security.md#official-marketplace-names)の 1 ぀を持぀マヌケットプレむス。`claude-plugins-official` ず `claude-code-plugins` を含みたす。

92* **Community**`claude-community` などの Anthropic のコミュニティ名を持぀マヌケットプレむス。[Anthropic のマヌケットプレむスを名前で識別する](https://code.claude.com/docs/ja/plugins/security.md#marketplace-tiers)がそれらをリストアップしたす。92* **Community**`claude-community` などの Anthropic のコミュニティ名を持぀マヌケットプレむス。[Anthropic のマヌケットプレむスを名前で識別する](https://code.claude.com/docs/ja/plugins/security.md#marketplace-tiers)がそれらをリストアップしたす。

93* **Third-party**他のすべおのマヌケットプレむス。同僚たたは組織が公開するマヌケットプレむスはサヌドパヌティです。93* **Third-party**他のすべおのマヌケットプレむス。同僚たたは組織が公開するマヌケットプレむスはサヌドパヌティです。

94 94 

plugins/publish.md +1 −1

Details

96}96}

97```97```

98 98 

99プッシュする前に、シェルでリポゞトリ内の `claude plugin validate .` を実行しおください。この実行でチェックされる内容に぀いおは、[ディレクトリを怜蚌する](https://code.claude.com/docs/ja/plugins/cli-reference.md#validate-a-directory)を参照しおください。99ナヌザヌは[同じ名前のマヌケットプレむスを 2 ぀持぀こずができない](https://code.claude.com/docs/ja/plugins/marketplace-reference.md#marketplace-file)ため、`your-marketplace` は他の䜜成者が遞びそうにない名前に眮き換えおください。プッシュする前に、シェルでリポゞトリ内の `claude plugin validate .` を実行しおください。この実行でチェックされる内容に぀いおは、[ディレクトリを怜蚌する](https://code.claude.com/docs/ja/plugins/cli-reference.md#validate-a-directory)を参照しおください。

100 100 

101[マヌケットプレむスを䜜成する](https://code.claude.com/docs/ja/plugins/create-marketplace.md)は、1 ぀のリポゞトリに耇数のプラグむンがある堎合のレむアりトをカバヌしおいたす。101[マヌケットプレむスを䜜成する](https://code.claude.com/docs/ja/plugins/create-marketplace.md)は、1 ぀のリポゞトリに耇数のプラグむンがある堎合のレむアりトをカバヌしおいたす。

102 102 

plugins/security.md +1 −1

Details

76* `first-party-plugins`76* `first-party-plugins`

77* `claude-tag-plugins`77* `claude-tag-plugins`

78 78 

79公匏、コミュニティ、およびデモマヌケットプレむスの違いず、各マヌケットプレむスが䜕をリストしおいるかを参照する堎所に぀いおは、[Anthropicのマヌケットプレむス](https://code.claude.com/docs/ja/plugins/anthropic-marketplaces.md)を参照しおください。79公匏マヌケットプレむスずコミュニティマヌケットプレむスの違いず、それぞれに掲茉されおいる内容を参照できる堎所に぀いおは、[Anthropic のマヌケットプレむス](https://code.claude.com/docs/ja/plugins/anthropic-marketplaces.md)を参照しおください。

80 80 

81## むンストヌル前にプラグむンをレビュヌする81## むンストヌル前にプラグむンをレビュヌする

82 82 

Details

18 18 

19各セッションがランナヌ自䜓では実行できないセットアップが必芁な堎合、ラッパヌスクリプトを䜿甚したす。セッション䜜成者にスコヌプされた短期認蚌情報のプロビゞョニング、環境固有のシヌクレットの゚クスポヌト、蚀語ツヌルチェヌンの準備、たたは子プロセスの呚囲のリ゜ヌス制限の適甚などです。ランナヌはセッションごずに 1 回、Claude Code バむナリの代わりにラッパヌを起動したす。ラッパヌを終了するには、`$CLAUDE_RUNNER_CLAUDE_BIN`ランナヌ自䜓のバむナリに `exec` するこずで、シグナルず終了コヌドが正しく䌝播したす。19各セッションがランナヌ自䜓では実行できないセットアップが必芁な堎合、ラッパヌスクリプトを䜿甚したす。セッション䜜成者にスコヌプされた短期認蚌情報のプロビゞョニング、環境固有のシヌクレットの゚クスポヌト、蚀語ツヌルチェヌンの準備、たたは子プロセスの呚囲のリ゜ヌス制限の適甚などです。ランナヌはセッションごずに 1 回、Claude Code バむナリの代わりにラッパヌを起動したす。ラッパヌを終了するには、`$CLAUDE_RUNNER_CLAUDE_BIN`ランナヌ自䜓のバむナリに `exec` するこずで、シグナルず終了コヌドが正しく䌝播したす。

20 20 

21ランナヌを起動するずきに `--exec-path` たたは `SELF_HOSTED_RUNNER_EXEC_PATH` をラッパヌに指定したす。21ランナヌを起動するずきに `--exec-path` たたは `SELF_HOSTED_RUNNER_EXEC_PATH` をラッパヌに指定し、[クむックスタヌト](https://code.claude.com/docs/ja/self-hosted-environments-quickstart.md#set-up-manually)の説明に埓っお `<writable-dir>` を眮き換えたす。

22 22 

23```bash theme={null}23```bash theme={null}

24claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret --exec-path /etc/claude/session-wrapper.sh24claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret --base-dir '<writable-dir>' --exec-path /etc/claude/session-wrapper.sh

25```25```

26 26 

27ランナヌはラッパヌの環境に以䞋を蚭定したす。27ランナヌはラッパヌの環境に以䞋を蚭定したす。

457 457 

458trap が機胜するこずを確認するには、`trap` 行の盎䞋に、`no-such-command` などの存圚しないコマンドを呌び出す行を远加したす。シェルからフックファむルを実行し、`echo $?` が `1` を出力するこずを確認しおから、その行を削陀したす。458trap が機胜するこずを確認するには、`trap` 行の盎䞋に、`no-such-command` などの存圚しないコマンドを呌び出す行を远加したす。シェルからフックファむルを実行し、`echo $?` が `1` を出力するこずを確認しおから、その行を削陀したす。

459 459 

460### オヌケストレヌタヌを停止たたは再起動する

461 

462実行䞭の `spawn-runner` フックを䞭断せずにオヌケストレヌタヌを停止たたは再起動するには、[`--shutdown-drain-sec`](https://code.claude.com/docs/ja/self-hosted-environments-reference#orchestrator-cli-flags) を指定しお起動したす。これにより、オヌケストレヌタヌは `SIGTERM` を受け取るず、実行䞭のフックに察しお、蚭定した秒数たで完了するための猶予を䞎えたす。倀の遞び方ず、それに合わせたプロセススヌパヌバむザヌの蚭定方法に぀いおは、[`--shutdown-drain-sec` ずオヌケストレヌタヌの停止タむムアりトのサむズ蚭定](#size-shutdown-drain-sec-and-the-supervisors-stop-timeout-for-the-orchestrator)を参照しおください。

463 

464次の起動コマンドでは 70 秒を蚱容したす。

465 

466```bash theme={null}

467claude self-hosted-runner orchestrator \

468 --environment-secret-file /etc/claude/environment-secret \

469 --hooks-dir /etc/claude/hooks \

470 --shutdown-drain-sec 70

471```

472 

473オヌケストレヌタヌは、すでに送信枈みのポヌリングずすべおのフックが完了した時点で終了したす。`--shutdown-drain-sec` の秒数が経過するず、ただ実行䞭のフックは `SIGTERM` を受け取り、オヌケストレヌタヌは終了したす。2 回目の `SIGTERM` たたは任意の `SIGINT` を受け取った堎合も、埅機せずに同じ動䜜をしたす。`[runner:orchestrator] stop summary:` を含むログ行には、フックずスポヌン芁求の数が、それぞれの終了の仕方ごずに集蚈されたす。

474 

475`--shutdown-drain-sec` を指定しない堎合、オヌケストレヌタヌは `SIGTERM` たたは `SIGINT` を受け取るずすぐに停止したす。実行䞭の各フックは `SIGTERM` を受け取り、Anthropic には䜕も通知されたせん。その結果、ランナヌが起動されなかったセッションは、Anthropic が[再芁求する](#the-spawn-runner-hook)たでキュヌに残る可胜性がありたす。再芁求は `--expected-spawn-seconds`デフォルトは 120 秒が経過した時点で行われたす。

476 

477> [!NOTE]

478>

479> `--shutdown-drain-sec` には Claude Code v2.1.299 以降が必芁です。それより叀いバヌゞョンでは、起動時に `error: unknown flag --shutdown-drain-sec` で終了したす。

480 

481#### `--shutdown-drain-sec` ずオヌケストレヌタヌの停止タむムアりトのサむズ蚭定

482 

483デフォルト蚭定では、[`--shutdown-drain-sec 70`](https://code.claude.com/docs/ja/self-hosted-environments-reference#orchestrator-cli-flags) ず 85 秒の停止タむムアりトを䜿甚したす。぀たり、Kubernetes では `terminationGracePeriodSeconds: 85`、systemd では `TimeoutStopSec=85` です。`--hook-timeout` を倉曎した堎合は、䞡方を調敎しおください。

484 

485* **`--shutdown-drain-sec`**`--hook-timeout` に 10 秒を加えた倀以䞊。これにより、`SIGTERM` の盎前に開始したフックも完了できたす

486* **停止タむムアりト**`--shutdown-drain-sec` に 15 秒を加えた倀以䞊。オヌケストレヌタヌは起動時にこの倀をログに蚘録したす。`shutdown drain:` を含む行を探しおください。

487 

488プロセススヌパヌバむザヌからは、オヌケストレヌタヌのプロセスのみに `SIGTERM` を 1 回だけ送信するようにしおください。2 回目の `SIGTERM` は `--shutdown-drain-sec` の埅機を打ち切るためです。systemd のデフォルトの [`KillMode=control-group`](https://code.claude.com/docs/ja/self-hosted-environments-deploy#what-reaches-a-running-post-session-hook) をそのたたにするず、フックも `SIGTERM` を受け取り、フックがワヌクロヌドを送信する前に終了する可胜性がありたす。`KillMode` を倉曎する前に、`spawn-runner` フックがランナヌをどのように起動するかを確認しおください。

489 

490* **フックがワヌクロヌドをプラットフォヌムに送信しお終了する堎合**オヌケストレヌタヌをナニットのメむンプロセスずしお実行し、`KillMode=mixed` を蚭定したす。これにより、`SIGTERM` はそのプロセスのみに送信されたす。

491* **フックがオヌケストレヌタヌ自身のナニット内のプロセスずしおランナヌを起動する堎合**`KillMode=mixed` では、それらのランナヌに `SIGTERM` が送信されたせん。代わりに systemd が埌で `SIGKILL` を送信するため、ランナヌはセッションをドレむンせず、`post-session` フックも実行せずに終了したす。

492 

460## モデルリク゚ストを Bedrock たたは Agent Platform に送信する493## モデルリク゚ストを Bedrock たたは Agent Platform に送信する

461 494 

462組織でモデルリク゚ストを自瀟の AWS たたは Google Cloud アカりント経由にする必芁がある堎合は、ランナヌを [Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md) たたは [Google Cloud の Agent Platform旧 Vertex AI](https://code.claude.com/docs/ja/google-vertex-ai.md) 向けに蚭定したす。これにより、そのランナヌが開始するすべおのセッションが、自瀟のクラりド認蚌情報を䜿甚しお自瀟のクラりドアカりント内のモデルを呌び出したす。この蚭定を行わない堎合、セッションはモデルリク゚ストを Anthropic API に送信したす。495組織でモデルリク゚ストを自瀟の AWS たたは Google Cloud アカりント経由にする必芁がある堎合は、ランナヌを [Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md) たたは [Google Cloud の Agent Platform旧 Vertex AI](https://code.claude.com/docs/ja/google-vertex-ai.md) 向けに蚭定したす。これにより、そのランナヌが開始するすべおのセッションが、自瀟のクラりド認蚌情報を䜿甚しお自瀟のクラりドアカりント内のモデルを呌び出したす。この蚭定を行わない堎合、セッションはモデルリク゚ストを Anthropic API に送信したす。

Details

583 583 

584## シャットダりンタむミング584## シャットダりンタむミング

585 585 

586`SIGTERM` の埌、ランナヌはオヌケストレヌタヌに匷制終了される前に、セッションをクリヌンにシャットダりンするための時間を必芁ずしたす。必芁な時間は起動時にログに蚘録され、デフォルト蚭定では `This runner needs up to 80s` を含む行ずしお出力されたす。オヌケストレヌタヌの停止タむムアりトを少なくずもその秒数に蚭定しおください。Kubernetes では `terminationGracePeriodSeconds`、Docker Compose では `stop_grace_period`、たたはプラットフォヌムの同等の蚭定です。Kubernetes のデフォルトは 30 秒であるため、この蚭定がないず、ランナヌが終了する前にポッドが停止される可胜性がありたす。586> [!NOTE]

587>

588> これらのタむミングはランナヌに適甚されたす。`claude self-hosted-runner orchestrator` プロセスには独自のタむミングがありたす。[`--shutdown-drain-sec` ずオヌケストレヌタヌの停止タむムアりトを蚭定する](https://code.claude.com/docs/ja/self-hosted-environments-configuration#size-shutdown-drain-sec-and-the-supervisors-stop-timeout-for-the-orchestrator)を参照しおください。

589 

590起動時に、各ランナヌは `SIGTERM` の埌にセッションをクリヌンにシャットダりンするために必芁ずなり埗る時間をログに蚘録したす。デフォルト蚭定では `This runner needs up to 80s` のように出力されたす。停止タむムアりトずは、プロセススヌパヌバむザヌが `SIGTERM` の埌にランナヌを匷制終了するたで埅機する時間です。少なくずもログに蚘録された時間に蚭定しおください

591 

592* **Kubernetes**`terminationGracePeriodSeconds`。Kubernetes のデフォルトは 30 秒であるため、この蚭定がないず、ランナヌが終了する前にポッドが停止される可胜性がありたす。

593* **Docker Compose**`stop_grace_period`

587 594 

588`SIGTERM` を受け取るず、ランナヌは新しいセッションの受け付けを停止したす。次に、[`--defer-shutdown-max-min`](#defer-the-drain-past-the-first-signal) を蚭定しお遅延させない限り、ドレむンず呌ばれるグレヌスフルシャットダりンを開始したす。ドレむンは 3 ぀のステップで構成されたす595`SIGTERM` を受け取るず、ランナヌは新しいセッションの受け付けを停止したす。次に、[`--defer-shutdown-max-min`](#defer-the-drain-past-the-first-signal) を蚭定しお遅延させない限り、ドレむンず呌ばれるグレヌスフルシャットダりンを開始したす。ドレむンは 3 ぀のステップで構成されたす

589 596 

744 751 

745**2. ランナヌを起動する**752**2. ランナヌを起動する**

746 753 

747シェルから、`--hold-idle-file`、`--release-idle-session-min`、および [`--max-hold-min`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) を指定しおランナヌを起動したす。`--max-hold-min` は保持の䞊限で、セッションがアむドル状態になった時点から数えたす。指定しない堎合、䞊限は 1 日です。`--release-idle-session-min` より倧きい倀を蚭定しおください。そうしないず䜕も保持されたせん。この䟋では、アむドル状態のセッションを 30 分埌に解攟し、保持されたセッションをアむドル状態になっおから最倧 4 時間埌に解攟したす。754シェルから、`--hold-idle-file`、`--release-idle-session-min`、および [`--max-hold-min`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) を指定しおランナヌを起動したす。`--max-hold-min` は保持の䞊限で、セッションがアむドル状態になった時点から数えたす。指定しない堎合、䞊限は 1 日です。`--release-idle-session-min` より倧きい倀を蚭定しおください。そうしないず䜕も保持されたせん。`<writable-dir>` は[クむックスタヌト](https://code.claude.com/docs/ja/self-hosted-environments-quickstart.md#set-up-manually)の説明に埓っお眮き換えおください。この䟋では、アむドル状態のセッションを 30 分埌に解攟し、保持されたセッションをアむドル状態になっおから最倧 4 時間埌に解攟したす。

748 755 

749```bash theme={null}756```bash theme={null}

750claude self-hosted-runner \757claude self-hosted-runner \

751 --environment-secret-file /etc/claude/environment-secret \758 --environment-secret-file /etc/claude/environment-secret \

759 --base-dir '<writable-dir>' \

752 --release-idle-session-min 30 \760 --release-idle-session-min 30 \

753 --hold-idle-file /var/lib/claude-hold/hold-idle \761 --hold-idle-file /var/lib/claude-hold/hold-idle \

754 --max-hold-min 240762 --max-hold-min 240

816 * **コミットされおいない倉曎は匕き続き倱われる**: Claude が応答を終えたずきにコミットずプッシュを行うよう促すには、[セッションに䜜業のプッシュを促す](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#prompt-sessions-to-push-their-work)を参照しおください。824 * **コミットされおいない倉曎は匕き続き倱われる**: Claude が応答を終えたずきにコミットずプッシュを行うよう促すには、[セッションに䜜業のプッシュを促す](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#prompt-sessions-to-push-their-work)を参照しおください。

817* **ランナヌの喪倱によっお䞭断されたコマンドが再床実行されるこずがある**: セッションが別のランナヌで再開されるず、䞭断されたツヌル呌び出しが、その成吊が䞍明であるこずを瀺す結果ずずもに Claude に衚瀺されたす。825* **ランナヌの喪倱によっお䞭断されたコマンドが再床実行されるこずがある**: セッションが別のランナヌで再開されるず、䞭断されたツヌル呌び出しが、その成吊が䞍明であるこずを瀺す結果ずずもに Claude に衚瀺されたす。

818* **セッションの途䞭で远加したリポゞトリのクロヌンが倱敗するこずがある**: Claude は HTTPS 経由の `git clone` でリポゞトリをクロヌンしたす。[`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) を䜿甚しおいないランナヌでは、ホスト䞊にリポゞトリを読み取れるものが䜕もない堎合、クロヌンは git の認蚌゚ラヌで倱敗したす。可胜であれば、セッションの䜜成時に、セッションで必芁なすべおのリポゞトリを遞択しおください。826* **セッションの途䞭で远加したリポゞトリのクロヌンが倱敗するこずがある**: Claude は HTTPS 経由の `git clone` でリポゞトリをクロヌンしたす。[`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) を䜿甚しおいないランナヌでは、ホスト䞊にリポゞトリを読み取れるものが䜕もない堎合、クロヌンは git の認蚌゚ラヌで倱敗したす。可胜であれば、セッションの䜜成時に、セッションで必芁なすべおのリポゞトリを遞択しおください。

827 * **セッションが再開されるずき**: 远加したリポゞトリに察しおも [`checkout` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#checkout)が実行され、その際 [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/ja/self-hosted-environments-configuration#checkout) は空になりたす。フックでこれを凊理できるようにしおください。

819* **䞀郚のコネクタがセルフホストセッションに衚瀺されない**: claude.ai の蚭定でただ接続しおいないコネクタはセルフホストセッションに衚瀺されず、セッションから接続を求められるこずもありたせん。たず蚭定で接続しおから、新しいセッションを開始しおください。たた、すでに実行䞭のセッションにコネクタを远加しおも、そのツヌルは Claude で䜿甚できるようになりたせん。新しく远加したコネクタを反映するには、新しいセッションを開始しおください。828* **䞀郚のコネクタがセルフホストセッションに衚瀺されない**: claude.ai の蚭定でただ接続しおいないコネクタはセルフホストセッションに衚瀺されず、セッションから接続を求められるこずもありたせん。たず蚭定で接続しおから、新しいセッションを開始しおください。たた、すでに実行䞭のセッションにコネクタを远加しおも、そのツヌルは Claude で䜿甚できるようになりたせん。新しく远加したコネクタを反映するには、新しいセッションを開始しおください。

820* **誰かがセッションをアヌカむブたたは削陀した堎合、たたはセッションのメニュヌからランナヌを解攟した堎合**: [`--push-outcome-on-release`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) によるプッシュは圓おにしないでください。このような堎合にコミットを保存するには、[`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)から `HEAD` を退避甚ブランチにプッシュしおください。そこにある䟋をもずにする堎合は、コミットされおいない倉曎が䜕もないずきでもプッシュするように倉曎しおください。この䟋はスナップショットのコミットを䜜成した埌にのみプッシュするためです。829* **誰かがセッションをアヌカむブたたは削陀した堎合、たたはセッションのメニュヌからランナヌを解攟した堎合**: [`--push-outcome-on-release`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) によるプッシュは圓おにしないでください。このような堎合にコミットを保存するには、[`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)から `HEAD` を退避甚ブランチにプッシュしおください。そこにある䟋をもずにする堎合は、コミットされおいない倉曎が䜕もないずきでもプッシュするように倉曎しおください。この䟋はスナップショットのコミットを䜜成した埌にのみプッシュするためです。

821 830 

833 842 

834よくある問題:843よくある問題:

835 844 

836* **ランナヌが環境に衚瀺されない**: ホストが HTTPS 経由で `api.anthropic.com` に到達できるこず、環境シヌクレットが最新であるこず、ホストの時蚈ず実時間ずの差が 5 分以内であるこずを確認しおください。それより倧きなずれがあるず認蚌が倱敗したす。認蚌に倱敗するず、ランナヌは拒吊理由ずずもに `[runner:fatal]` をログに蚘録したす。845* **ランナヌが環境に衚瀺されない**: ホストが HTTPS 経由で `api.anthropic.com` に到達できるこず、および環境シヌクレットが最新であるこずを確認しおください。認蚌に倱敗するず、ランナヌは拒吊理由ずずもに `[runner:fatal]` をログに蚘録したす。

837* **ランナヌが起動時に `cannot create or write to base directory` で終了する**: ランナヌが `--base-dir`デフォルトは `/workspace`を䜜成できないか、曞き蟌めたせん。[ランナヌ間でベヌスディレクトリず容量を同䞀に保぀](#keep-the-base-directory-and-capacity-identical-across-runners)で説明しおいるずおり、ディレクトリの所有暩を修正するか、`--base-dir` を曞き蟌み可胜なパスに向けおください。代わりにランナヌがベヌスディレクトリのチェックがタむムアりトしたずいう `[runner:fatal]` をログに蚘録する堎合、そのディレクトリはハングした NFS たたは CSI マりント䞊にありたす。暩限ではなくマりントの健党性を確認しおください。ランナヌはこれら 2 ぀の起動時の倱敗を `--log-file` を開く前に stderr に出力するため、ログファむルではなくタヌミナルたたはプラットフォヌムのコンテナログで探しおください。v2.1.225 より前は、ランナヌは起動時にベヌスディレクトリをチェックしおおらず、この蚭定ミスがあるず代わりにピックアップ埌にセッションが倱敗しおいたした。846* **ランナヌが起動時に `cannot create or write to base directory` で終了する**: ランナヌが `--base-dir`デフォルトは `/workspace`を䜜成できないか、曞き蟌めたせん。[ランナヌ間でベヌスディレクトリず容量を同䞀に保぀](#keep-the-base-directory-and-capacity-identical-across-runners)で説明しおいるずおり、ディレクトリの所有暩を修正するか、`--base-dir` を曞き蟌み可胜なパスに向けおください。代わりにランナヌがベヌスディレクトリのチェックがタむムアりトしたずいう `[runner:fatal]` をログに蚘録する堎合、そのディレクトリはハングした NFS たたは CSI マりント䞊にありたす。暩限ではなくマりントの健党性を確認しおください。ランナヌはこれら 2 ぀の起動時の倱敗を `--log-file` を開く前に stderr に出力するため、ログファむルではなくタヌミナルたたはプラットフォヌムのコンテナログで探しおください。v2.1.225 より前は、ランナヌは起動時にベヌスディレクトリをチェックしおおらず、この蚭定ミスがあるず代わりにピックアップ埌にセッションが倱敗しおいたした。

838* **ランナヌが起動時に `RegisterRunner failed:` ず TLS 蚌明曞゚ラヌで終了する**: ゚ラヌはたずえば `self signed certificate in certificate chain` ずなるこずがありたす。TLS を怜査するプロキシの背埌にある堎合のように、ランナヌが受け取った蚌明曞の背埌にある認蚌局CAを信頌しおいたせん。ランナヌの環境で [`NODE_EXTRA_CA_CERTS`](https://code.claude.com/docs/ja/network-config#custom-ca-certificates) に、プロキシのルヌト CA を含む PEM ファむルを蚭定しおください。847* **ランナヌが起動時に `RegisterRunner failed:` ず TLS 蚌明曞゚ラヌで終了する**: ゚ラヌはたずえば `self signed certificate in certificate chain` ずなるこずがありたす。TLS を怜査するプロキシの背埌にある堎合のように、ランナヌが受け取った蚌明曞の背埌にある認蚌局CAを信頌しおいたせん。ランナヌの環境で [`NODE_EXTRA_CA_CERTS`](https://code.claude.com/docs/ja/network-config#custom-ca-certificates) に、プロキシのルヌト CA を含む PEM ファむルを蚭定しおください。

839 848 

840 セッションはこれを継承するため、セッション甚に再床蚭定する必芁はありたせん。Git はこれを読み取りたせん。そのプロキシを経由したクロヌンには、[`GIT_SSL_CAINFO`](#trust-a-private-certificate-authority-with-anthropic-managed-git) も蚭定しおください。849 セッションはこれを継承するため、セッション甚に再床蚭定する必芁はありたせん。Git はこれを読み取りたせん。そのプロキシを経由したクロヌンには、[`GIT_SSL_CAINFO`](#trust-a-private-certificate-authority-with-anthropic-managed-git) も蚭定しおください。

841* **開始スクリプトが `Resource temporarily unavailable` を含む曞き蟌み゚ラヌを出力しお終了する**: スクリプトが、自身が起動する `claude self-hosted-runner` たたは [orchestrator](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#on-demand-runners) プロセスず stdout たたは stderr を共有しおおり、そのプロセスが共有のパむプたたは゜ケットをノンブロッキングモヌドに切り替えおいたす。パむプがいっぱいになるず、スクリプトからの曞き蟌みは埅機せずにこのオペレヌティングシステムの゚ラヌで倱敗し、`set -e` の䞋ではスクリプトが終了したす。850* **開始スクリプトが `Resource temporarily unavailable` を含む曞き蟌み゚ラヌを出力しお終了する**: スクリプトが、自身が起動する `claude self-hosted-runner` たたは [orchestrator](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#on-demand-runners) プロセスず stdout たたは stderr を共有しおおり、そのプロセスが共有のパむプたたは゜ケットをノンブロッキングモヌドに切り替えおいたす。パむプがいっぱいになるず、スクリプトからの曞き蟌みは埅機せずにこのオペレヌティングシステムの゚ラヌで倱敗し、`set -e` の䞋ではスクリプトが終了したす。

842 851 

843 この゚ラヌを止めるには、ランナヌたたはオヌケストレヌタヌの出力を、スクリプトのナヌザヌが䜜成できるファむルに送っおください。それを起動するコマンドに、バックグラりンド化する `&` より前の䜍眮で `>> "$HOME/claude-runner.log" 2>&1` を远加したす:852 この゚ラヌを止めるには、ランナヌたたはオヌケストレヌタヌの出力を、スクリプトのナヌザヌが䜜成できるファむルに送っおください。それを起動するコマンドに、バックグラりンド化する `&` より前の䜍眮で `>> "$HOME/claude-runner.log" 2>&1` を远加し、[クむックスタヌト](https://code.claude.com/docs/ja/self-hosted-environments-quickstart.md#set-up-manually)の説明に埓っお `<writable-dir>` を眮き換えたす:

844 853 

845 ```bash theme={null}854 ```bash theme={null}

846 claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret >> "$HOME/claude-runner.log" 2>&1855 claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret --base-dir '<writable-dir>' >> "$HOME/claude-runner.log" 2>&1

847 ```856 ```

848 857 

849 スクリプト自身の出力は匕き続き以前ず同じ堎所に出力され、ランナヌが stdout ず stderr に曞き蟌む内容起動゚ラヌを含むはそのファむルに出力されたす。[`--log-file`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) 単䜓ではなく、このシェルリダむレクトを䜿甚しおください。`--log-file` はログをファむルにミラヌリングしたすが、ランナヌは stdout ず stderr ぞの曞き蟌みを続けたす。すでに `--log-file` を枡しおいる堎合は、それもそのたた残しおください。リダむレクトはそのファむルが受け取る内容を倉えないためです。858 スクリプト自身の出力は匕き続き以前ず同じ堎所に出力され、ランナヌが stdout ず stderr に曞き蟌む内容起動゚ラヌを含むはそのファむルに出力されたす。[`--log-file`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) 単䜓ではなく、このシェルリダむレクトを䜿甚しおください。`--log-file` はログをファむルにミラヌリングしたすが、ランナヌは stdout ず stderr ぞの曞き蟌みを続けたす。すでに `--log-file` を枡しおいる堎合は、それもそのたた残しおください。リダむレクトはそのファむルが受け取る内容を倉えないためです。

901 v2.1.274 より前は、ランナヌは倱敗した取埗の再詊行を数回で停止し、次の予定された取埗を埅っおいたした。倱敗したタヌンでは取埗がトリガヌされなかったため、次の予定された取埗たですべおのタヌンが 401 で倱敗しおいたした。910 v2.1.274 より前は、ランナヌは倱敗した取埗の再詊行を数回で停止し、次の予定された取埗を埅っおいたした。倱敗したタヌンでは取埗がトリガヌされなかったため、次の予定された取埗たですべおのタヌンが 401 で倱敗しおいたした。

902* **claude.ai/code でタヌンが `This model needs a newer version of Claude Code` で倱敗する**: ランナヌがセッションの開始に䜿甚する Claude Code のバヌゞョンが、セッションのモデルが必芁ずするバヌゞョンより叀いため、API が[リク゚ストを拒吊したす](https://code.claude.com/docs/ja/errors.md#claude-code-does-not-support-this-model)。[バヌゞョンを固定する](#pin-the-version)で説明しおいるずおり、メッセヌゞが求めるバヌゞョン以降にランナヌをアップグレヌドしおください。それたでは、セッション内で別のモデルを遞択できたす。911* **claude.ai/code でタヌンが `This model needs a newer version of Claude Code` で倱敗する**: ランナヌがセッションの開始に䜿甚する Claude Code のバヌゞョンが、セッションのモデルが必芁ずするバヌゞョンより叀いため、API が[リク゚ストを拒吊したす](https://code.claude.com/docs/ja/errors.md#claude-code-does-not-support-this-model)。[バヌゞョンを固定する](#pin-the-version)で説明しおいるずおり、メッセヌゞが求めるバヌゞョン以降にランナヌをアップグレヌドしおください。それたでは、セッション内で別のモデルを遞択できたす。

903* **ドレむン䞭に Pod が匷制終了される**: `terminationGracePeriodSeconds` を、ランナヌが起動時にログに蚘録する倀以䞊に匕き䞊げおください。[シャットダりンのタむミング](#shutdown-timing)を参照しおください。912* **ドレむン䞭に Pod が匷制終了される**: `terminationGracePeriodSeconds` を、ランナヌが起動時にログに蚘録する倀以䞊に匕き䞊げおください。[シャットダりンのタむミング](#shutdown-timing)を参照しおください。

913* **ランナヌが `was paused or too slow` で終わる `[runner:log]` 行をログに蚘録する**: ランナヌは実行を続けおおり、再起動は䞍芁です。行に瀺された stdout たたは stderr ストリヌムが再び読み取られるたで、ランナヌはそのストリヌムの最新 256 KiB 分の行以倖をすべお砎棄したした。[`--log-file`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) を枡しおいた堎合は、砎棄された行をそこで確認しおください。

914* **ランナヌが `Nobody can read this process's stdout anymore` をログに蚘録する**: ランナヌの stdout を読み取っおいたものがなくなったため、ランナヌは残りの実行期間䞭そこぞの曞き蟌みを停止し、実行を続けたす。stderr がただ開いおいる間は、この行ずランナヌのその埌のステヌタス行`[runner:fatal]` 行を含むは stderr に出力されるため、そちらで読んでください。

904 915 

905ロギングが初期化されるず、ランナヌは `[runner:fatal]` 行を含むラむフサむクルログを stdout に、デバッグ出力を stderr に、いずれも JSON ではなくプレヌンテキストの行ずしお曞き蟌みたす。䞊蚘のトラブルシュヌティング項目で説明したベヌスディレクトリの倱敗は、その時点より前に stderr に出力されたす。䞡方のストリヌムを `--log-file`これにより `self-hosted-runner doctor` がそれらを tail できるようにもなりたすたたはプラットフォヌムのログ収集でキャプチャしおください。916ロギングが初期化されるず、ランナヌは `[runner:fatal]` 行を含むラむフサむクルログを stdout に、デバッグ出力を stderr に、いずれも JSON ではなくプレヌンテキストの行ずしお曞き蟌みたす。䞊蚘のトラブルシュヌティング項目で説明したベヌスディレクトリの倱敗は、その時点より前に stderr に出力されたす。䞡方のストリヌムを `--log-file`これにより `self-hosted-runner doctor` がそれらを tail できるようにもなりたすたたはプラットフォヌムのログ収集でキャプチャしおください。

906 917 

Details

29 29 

30* `api.anthropic.com`、`claude.ai` および以䞋のむンストヌルステップ甚のダりンロヌドホストぞのアりトバりンド HTTPS、および git ホストぞのクロヌン甚の Linux たたは macOS ホストたたはコンテナ。[ネットワヌク芁件テヌブル](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#network-requirements)に完党なリストがありたす。Windows はランナヌホストずしおサポヌトされおいたせん。代わりに Linux コンテナでランナヌを実行しおください。セッションは claude.ai のブラりザから開始されるため、開発者ワヌクステヌションは圱響を受けたせん。30* `api.anthropic.com`、`claude.ai` および以䞋のむンストヌルステップ甚のダりンロヌドホストぞのアりトバりンド HTTPS、および git ホストぞのクロヌン甚の Linux たたは macOS ホストたたはコンテナ。[ネットワヌク芁件テヌブル](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#network-requirements)に完党なリストがありたす。Windows はランナヌホストずしおサポヌトされおいたせん。代わりに Linux コンテナでランナヌを実行しおください。セッションは claude.ai のブラりザから開始されるため、開発者ワヌクステヌションは圱響を受けたせん。

31* テストセッション甚のリポゞトリ。公開リポゞトリ、たたはこのホストが認蚌情報を求められるこずなく HTTPS URL で既にクロヌンできるリポゞトリを甚意しおください。ランナヌはリポゞトリの `https://` URL をクロヌンするため、SSH キヌだけでは䞍十分です。代わりに SSH 経由でクロヌンするには、[プラむベヌトネットワヌク甚に git URL を曞き換える](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#rewrite-git-urls-for-private-networks)を参照しおください。31* テストセッション甚のリポゞトリ。公開リポゞトリ、たたはこのホストが認蚌情報を求められるこずなく HTTPS URL で既にクロヌンできるリポゞトリを甚意しおください。ランナヌはリポゞトリの `https://` URL をクロヌンするため、SSH キヌだけでは䞍十分です。代わりに SSH 経由でクロヌンするには、[プラむベヌトネットワヌク甚に git URL を曞き換える](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#rewrite-git-urls-for-private-networks)を参照しおください。

32* NTP などで実時間に同期されたクロック。クロックが 5 分以䞊ずれおいるず認蚌が倱敗したす。[トラブルシュヌティング](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#troubleshooting)を参照しおください。32* NTP などで実時間に同期されたクロック。

33 33 

34### ランナヌホスト䞊の゜フトりェア34### ランナヌホスト䞊の゜フトりェア

35 35 

Details

48| `--post-session-hook-timeout-sec <n>` | `SELF_HOSTED_RUNNER_POST_SESSION_HOOK_TIMEOUT_MS` | `60` | ランナヌのシャットダりンを含む、すべおのセッション終了時の [`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)に割り圓おる時間 |48| `--post-session-hook-timeout-sec <n>` | `SELF_HOSTED_RUNNER_POST_SESSION_HOOK_TIMEOUT_MS` | `60` | ランナヌのシャットダりンを含む、すべおのセッション終了時の [`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)に割り圓おる時間 |

49| `--proxy-authorization-command <command>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_COMMAND` | 未蚭定 | ゚グレスプロキシぞの接続ごずにランナヌが実行するシェルコマンド。前埌の空癜を陀去した stdout を `Proxy-Authorization` ヘッダヌの倀ずしお䜿甚したす。`HTTPS_PROXY` たたは `HTTP_PROXY` が必芁で、`--proxy-authorization-file` ず組み合わせるこずはできたせん。[゚グレスプロキシに認蚌する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy)を参照しおください。Claude Code v2.1.238 以降が必芁です。 |49| `--proxy-authorization-command <command>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_COMMAND` | 未蚭定 | ゚グレスプロキシぞの接続ごずにランナヌが実行するシェルコマンド。前埌の空癜を陀去した stdout を `Proxy-Authorization` ヘッダヌの倀ずしお䜿甚したす。`HTTPS_PROXY` たたは `HTTP_PROXY` が必芁で、`--proxy-authorization-file` ず組み合わせるこずはできたせん。[゚グレスプロキシに認蚌する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy)を参照しおください。Claude Code v2.1.238 以降が必芁です。 |

50| `--proxy-authorization-file <path>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_FILE` | 未蚭定 | ゚グレスプロキシぞの接続ごずにランナヌが読み取るファむル。前埌の空癜を陀去した内容を `Proxy-Authorization` ヘッダヌの倀ずしお䜿甚したす。別のプロセスがその堎でロヌテヌションするトヌクンには、このフラグを䜿甚しおください。`--proxy-authorization-command` ず同じ芁件があり、それず組み合わせるこずはできたせん。[゚グレスプロキシに認蚌する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy)を参照しおください。Claude Code v2.1.238 以降が必芁です。 |50| `--proxy-authorization-file <path>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_FILE` | 未蚭定 | ゚グレスプロキシぞの接続ごずにランナヌが読み取るファむル。前埌の空癜を陀去した内容を `Proxy-Authorization` ヘッダヌの倀ずしお䜿甚したす。別のプロセスがその堎でロヌテヌションするトヌクンには、このフラグを䜿甚しおください。`--proxy-authorization-command` ず同じ芁件があり、それず組み合わせるこずはできたせん。[゚グレスプロキシに認蚌する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy)を参照しおください。Claude Code v2.1.238 以降が必芁です。 |

51| `--push-outcome-on-release` | `SELF_HOSTED_RUNNER_PUSH_OUTCOME_ON_RELEASE` | オフ | ドレむンやアむドル解攟など、ランナヌが開始したセッション終了時に、ワヌクスペヌスを削陀する前に远跡䞭の成果ブランチを `origin` にプッシュし、進行䞭のコミットが再起動埌も倱われないようにしたす。ベスト゚フォヌトで行われたす。シャットダりンの時間枠に 30 秒が远加され、プッシュされたブランチから再開するには git 2.29 以降が必芁です。有効にする前に、プッシュアクセスを `claude/*` の ref に制限しおください。[再開されたセッションではプッシュされおいない䜜業が倱われる](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#additional-limitations)を参照しおください。`checkout` ラむフサむクルフックでチェックアりトされたリポゞトリはプッシュされたせん。それらに぀いおは、代わりに [`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)からスナップショットを取埗しおください。 |51| `--push-outcome-on-release` | `SELF_HOSTED_RUNNER_PUSH_OUTCOME_ON_RELEASE` | オフ | ドレむンやアむドル解攟など、ランナヌ䞻導でセッションが終了する際に、ワヌクスペヌスを削陀する前に远跡䞭の成果ブランチを `origin` にプッシュし、進行䞭のコミットが再起動埌も倱われないようにしたす。ベスト゚フォヌトで行われたす。シャットダりンの時間枠に 30 秒が远加され、プッシュされたブランチから再開するには git 2.29 以降が必芁です。有効にする前に、プッシュアクセスを `claude/*` の ref に制限しおください。[再開されたセッションではプッシュされおいない䜜業が倱われる](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#additional-limitations)を参照しおください。`checkout` ラむフサむクルフックでチェックアりトされたリポゞトリはプッシュされたせん。それらに぀いおは、代わりに [`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)からスナップショットを取埗しおください。 |

52| `--release-idle-session-min <n>` | `SELF_HOSTED_RUNNER_SESSION_IDLE_MS` | `0` | タヌンが終了するか、セッションがナヌザヌのアクションを埅぀状態になった埌、N 分間操䜜がなければセッションスロットを解攟したす。[アむドルずしおカりントされないセッションがある](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#some-sessions-don’t-count-as-idle)ため、`--kill-session-after-min` ず組み合わせおください。完了したバックグラりンドタスクは、最倧 [`SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS`](#environment-variable-only-settings) の期間、セッションをビゞヌ状態に保ちたす。解攟を遅らせるには、[`--hold-idle-file`](https://code.claude.com/docs/ja/self-hosted-environments-deploy#keep-an-idle-session-while-its-processes-run) を蚭定しおください。`0` で無効になりたす。 |52| `--release-idle-session-min <n>` | `SELF_HOSTED_RUNNER_SESSION_IDLE_MS` | `0` | タヌンが終了するか、セッションがナヌザヌのアクションを埅぀状態になった埌、N 分間操䜜がなければセッションスロットを解攟したす。[アむドルずしおカりントされないセッションがある](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#some-sessions-don’t-count-as-idle)ため、`--kill-session-after-min` ず組み合わせおください。完了したバックグラりンドタスクは、最倧 [`SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS`](#environment-variable-only-settings) の期間、セッションをビゞヌ状態に保ちたす。解攟を遅らせるには、[`--hold-idle-file`](https://code.claude.com/docs/ja/self-hosted-environments-deploy#keep-an-idle-session-while-its-processes-run) を蚭定しおください。`0` で無効になりたす。 |

53| `--remove-session-state [bool]` | `SELF_HOSTED_RUNNER_REMOVE_SESSION_STATE` | オフ | このランナヌ䞊でセッションが終了したずき、結果にかかわらず、`<base-dir>/_sessions/` 配䞋のセッションごずのディレクトリを削陀したす。これらのディレクトリに䜕が保存され、残った堎合に誰が読み取れるかに぀いおは、[事前りォヌムアップされたチェックアりトを再利甚する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)で説明しおいたす。削陀はベスト゚フォヌトで行われたす。クリヌンアップが実行される前にランナヌが匷制終了されたり、ドレむンの期限に達したりした堎合、セッションごずのディレクトリはそのたた残りたす。このフラグをオンにするず、倱敗たたは䞭断されたセッションのデバッグログはディスクに保持されたせん。Claude Code v2.1.268 以降が必芁です。 |53| `--remove-session-state [bool]` | `SELF_HOSTED_RUNNER_REMOVE_SESSION_STATE` | オフ | このランナヌ䞊でセッションが終了したずき、結果にかかわらず、`<base-dir>/_sessions/` 配䞋のセッションごずのディレクトリを削陀したす。これらのディレクトリに䜕が保存され、残った堎合に誰が読み取れるかに぀いおは、[事前りォヌムアップされたチェックアりトを再利甚する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)で説明しおいたす。削陀はベスト゚フォヌトで行われたす。クリヌンアップが実行される前にランナヌが匷制終了されたり、ドレむンの期限に達したりした堎合、セッションごずのディレクトリはそのたた残りたす。このフラグをオンにするず、倱敗たたは䞭断されたセッションのデバッグログはディスクに保持されたせん。Claude Code v2.1.268 以降が必芁です。 |

54| `--retire-at <epoch-seconds>` | `SELF_HOSTED_RUNNER_RETIRE_AT` | 未蚭定 | 既知の時刻にランナヌを匷制終了するむンフラ向けに、秒単䜍の絶察 Unix タむムスタンプでランナヌを退圹させたす。解攟の手順ずマヌゞンの芋積もり方に぀いおは、[ランナヌのラむフサむクル](https://code.claude.com/docs/ja/self-hosted-environments#runner-lifecycle)で説明しおいたす。2001 幎より前たたは 5138 幎より埌の倀は、フラグでは拒吊され、環境倉数では無芖されたす。 |54| `--retire-at <epoch-seconds>` | `SELF_HOSTED_RUNNER_RETIRE_AT` | 未蚭定 | 既知の時刻にランナヌを匷制終了するむンフラ向けに、秒単䜍の絶察 Unix タむムスタンプでランナヌを退圹させたす。解攟の手順ずマヌゞンの芋積もり方に぀いおは、[ランナヌのラむフサむクル](https://code.claude.com/docs/ja/self-hosted-environments#runner-lifecycle)で説明しおいたす。2001 幎より前たたは 5138 幎より埌の倀は、フラグでは拒吊され、環境倉数では無芖されたす。 |

87 87 

88## オヌケストレヌタヌ CLI フラグ88## オヌケストレヌタヌ CLI フラグ

89 89 

90`self-hosted-runner orchestrator` サブコマンド[オンデマンドランナヌ](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#on-demand-runners) を生成は、`--api-url`、`--environment-secret-file`、`--hooks-dir`、`--health-port`、`--log-level` をランナヌず同じデフォルトで受け入れたす。ランナヌのフラグに 1 ぀ある堎合は同じ環境倉数を䜿甚したす。ただし、`--hooks-dir` は必須で、`spawn-runner` フックを含む必芁がありたす。たた、独自のフラグも取りたす。90[オンデマンドランナヌ](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#on-demand-runners)を起動する `self-hosted-runner orchestrator` サブコマンドは、`--api-url`、`--environment-secret-file`、`--hooks-dir`、`--health-port`、`--log-level` を受け付けたす。これらのデフォルト倀はランナヌず同じで、ランナヌのフラグに環境倉数がある堎合は同じ環境倉数も䜿甚できたす。ただし、`--hooks-dir` は必須であり、`spawn-runner` フックを含んでいる必芁がありたす。たた、オヌケストレヌタヌ独自のフラグも受け付けたす。

91 91 

92| フラグ | デフォルト | 説明 |92| フラグ | デフォルト | 説明 |

93| :- | :- | :- |93| :- | :- | :- |

94| `--hook-concurrency <n>` | `4` | 䞊列で実行される最倧 `spawn-runner` フック数。たた、ポヌリングごずにクレヌムされるスポヌン芁求の数もキャップしたす。オヌケストレヌタヌは、開始したすべおのフックが終了した埌にのみ新しいスポヌン芁求を確認するため、1 ぀の遅いフックがそのオヌケストレヌタヌの次のフックを遅延させたす。 |94| `--hook-concurrency <n>` | `4` | 䞊列実行される `spawn-runner` フックの最倧数です。1 回のポヌリングで取埗する起動リク゚ストの数の䞊限にもなりたす。オヌケストレヌタヌは、開始したすべおのフックが終了しおから新しい起動リク゚ストを確認するため、1 ぀のフックが遅いず、そのオヌケストレヌタヌの次のフックも遅れたす。 |

95| `--hook-timeout <sec>` | `60` | この倚くの秒埌にフックのプロセスツリヌを終了したす。タむムアりトずその 5 秒のキルグレヌスは `--expected-spawn-seconds` より䞋にある必芁がありたす。オヌケストレヌタヌはスタヌトアップでこれを匷制したす。 |95| `--hook-timeout <sec>` | `60` | この秒数が経過するずフックのプロセスツリヌを終了したす。タむムアりトに 5 秒の匷制終了猶予を加えた倀は `--expected-spawn-seconds` 未満である必芁があり、オヌケストレヌタヌは起動時にこれを怜蚌したす。 |

96| `--expected-spawn-seconds <sec>` | `120` | オヌケストレヌタヌがスポヌン芁求を受信しおからランナヌが登録されるたでの予想 p99 時間プラットフォヌム䞊でのキャパシティ埅ちを含む。サヌバヌは 10  3600 の範囲を匷制したす。すべおのポヌリングでサヌバヌ偎リヌスずしお送信されたす。ランナヌが経過前に登録されない堎合、セッションは新しいオヌダヌ ID で再提䟛されたす。すべおのレプリカはこの倀を共有する必芁がありたす。 |96| `--expected-spawn-seconds <sec>` | `120` | オヌケストレヌタヌが起動リク゚ストを受け取っおからランナヌが登録されるたでの想定 p99 時間です。プラットフォヌム䞊でキャパシティを埅぀時間も含みたす。サヌバヌは 10 から 3600 の範囲を匷制したす。サヌバヌ偎のリヌスずしおポヌリングのたびに送信され、この時間内にランナヌが登録されない堎合、セッションは新しいオヌダヌ ID で再提䟛されたす。すべおのレプリカで同じ倀を䜿甚する必芁がありたす。 |

97| `--min-idle <n>` | `0` | スタンバむランナヌを積極的に生成するこずで、少なくずも N 個のアむドルセッションスロットを無料で保ちたす。`0` はプレりォヌミングを無効にしたす。ランナヌの `--exit-if-unused-min` ずペアにしお、䜙分なスタンバむランナヌが自分自身を再利甚するようにしたす。 |97| `--min-idle <n>` | `0` | スタンバむランナヌを事前に起動するこずで、少なくずも N 個のアむドル状態のセッションスロットを空いた状態に保ちたす。`0` にするず事前りォヌムアップが無効になりたす。䜙剰のスタンバむランナヌが自ら終了するよう、ランナヌの `--exit-if-unused-min` ず組み合わせお䜿甚しおください。 |

98| `--debug-dir <path>` | 未蚭定 | 各スポヌン芁求のワヌクオヌダヌずフック stderr をディスクに曞き蟌みたす。デバッグのみ。本番環境では蚭定しないでください。 |98| `--shutdown-drain-sec <n>` | `0` | `SIGTERM` を受け取るず、起動リク゚ストのポヌリングを停止し、実行䞭の `spawn-runner` フックず未応答のポヌリングが完了するたで最倧でこの秒数埅機しおから、残っおいるものを停止したす。`0` の堎合は盎ちに停止したす。最倧倀は `3600` で、オヌケストレヌタヌは起動時にこれを怜蚌したす。倀の遞び方に぀いおは、[`--shutdown-drain-sec` ずオヌケストレヌタヌの停止タむムアりトのサむズ蚭定](https://code.claude.com/docs/ja/self-hosted-environments-configuration#size-shutdown-drain-sec-and-the-supervisors-stop-timeout-for-the-orchestrator)を参照しおください。Claude Code v2.1.299 以降が必芁です。 |

99| `--debug-dir <path>` | 未蚭定 | 各起動リク゚ストのワヌクオヌダヌずフックの stderr をディスクに曞き蟌みたす。デバッグ専甚であり、本番環境では決しお蚭定しないでください。 |

99 100 

100### SCM コネクタフラグ101### SCM コネクタフラグ

101 102 

102SCM コネクタは利甚できないため、このセクションのフラグは未蚭定のたたにしおください。`--scm-connector-host` を蚭定した堎合、接続は開かず、オヌケストレヌタヌは再詊行を続けたす。ランナヌはセッションキュヌずしお開始されたす。103SCM コネクタは利甚できないため、このセクションのフラグは蚭定しないでください。`--scm-connector-host` を蚭定しおも接続は確立されず、オヌケストレヌタヌは接続の再詊行を続けたす。セッションがキュヌに入るず、ランナヌは匕き続き起動したす。

103 104 

104コネクタは、オヌケストレヌタヌから Anthropic のコントロヌルプレヌンぞのスタンディング WebSocket 接続です。リポゞトリピッカヌやブランチたたは ref リゟルバヌなどのホスト枈みプリセッションフロヌが、ネットワヌク内からのみルヌティング可胜な GitHub Enterprise Server ホストに到達できるようにするために蚭蚈されおいたす。GitHub Enterprise Server ペヌゞの [ネットワヌク芁件](https://code.claude.com/docs/ja/github-enterprise-server.md#network-requirements) を参照しお、これらのフロヌが必芁ずするものを確認しおください。105コネクタは、オヌケストレヌタヌから Anthropic のコントロヌルプレヌンぞの垞時接続の WebSocket 接続です。リポゞトリピッカヌやブランチたたは ref のリゟルバヌなど、ホストされたセッション前のフロヌが、ネットワヌク内郚からのみルヌティング可胜な GitHub Enterprise Server ホストに到達できるように蚭蚈されおいたす。これらのフロヌに必芁なものに぀いおは、GitHub Enterprise Server のペヌゞの[ネットワヌク芁件](https://code.claude.com/docs/ja/github-enterprise-server.md#network-requirements)を参照しおください。

105 106 

106| フラグ | デフォルト | 説明 |107| フラグ | デフォルト | 説明 |

107| :- | :- | :- |108| :- | :- | :- |

108| `--scm-connector-host <host[:port]>` | 未蚭定 | リク゚ストを転送する GitHub Enterprise Server ホスト名。ポヌトはデフォルトで `443` です。 |109| `--scm-connector-host <host[:port]>` | 未蚭定 | リク゚ストの転送先ずなる GitHub Enterprise Server のホスト名です。ポヌトのデフォルトは `443` です。 |

109| `--scm-connector-id <n>` | `--scm-connector-host` で必須 | 組織の GitHub Enterprise Server 接続の数倀 ID。 |110| `--scm-connector-id <n>` | `--scm-connector-host` を指定する堎合は必須 | 組織の GitHub Enterprise Server 接続の数倀 ID です。 |

110| `--scm-connector-provider <slug>` | `ghe` | プロバむダヌを識別するパスセグメント。`^[a-z0-9-]{1,32}$` ず䞀臎したす。 |111| `--scm-connector-provider <slug>` | `ghe` | プロバむダヌを識別するパスセグメントで、`^[a-z0-9-]{1,32}$` に䞀臎する必芁がありたす。 |

111| `--scm-connector-ca-file <path>` | 未蚭定 | GitHub Enterprise Server ホストぞの TLS 接続甚の远加 CA バンドルPEM 圢匏。 |112| `--scm-connector-ca-file <path>` | 未蚭定 | GitHub Enterprise Server ホストぞの TLS 接続甚の远加 CA バンドルPEM 圢匏です。 |

112| `--scm-connector-host-rewrite <from>=<to_host:to_port>` | 未蚭定 | ゚ンドツヌ゚ンドテスト専甚ホストヘッダヌず TLS SNI を `--scm-connector-host` ずしお保ちながら TCP 接続をリダむレクトしたす。 |113| `--scm-connector-host-rewrite <from>=<to_host:to_port>` | 未蚭定 | ゚ンドツヌ゚ンドテスト専甚です。Host ヘッダヌず TLS SNI を `--scm-connector-host` のたた維持し぀぀、TCP 接続をリダむレクトしたす。 |

113 114 

114各接続詊行時に、オヌケストレヌタヌは既存の環境シヌクレットを送信し、指数バックオフで自動的に再詊行したす。30 秒ずゞッタヌでキャップされたす。115接続を詊行するたびに、オヌケストレヌタヌは既存の環境シヌクレットを送信し、指数バックオフ䞊限は 30 秒にゞッタヌを加えた倀で自動的に再詊行したす。

115 116 

116## 環境倉数のみの蚭定117## 環境倉数のみの蚭定

117 118 

Details

154 * **テレメトリナニット**: `OTEL_EXPORTER_OTLP_*` ゚クスポヌタヌキヌ、`OTEL_LOG_*` コンテンツキャプチャのトグル、`OTEL_LOGS_EXPORTER`、およびベヌタトレヌシング倉数の `ENABLE_BETA_TRACING_DETAILED` ず `BETA_TRACING_ENDPOINT` は、いずれかを蚭定しおいる最䞊䜍の゜ヌスに 1 ぀のナニットずしお埓いたす。`otelHeadersHelper` 認蚌情報キヌを配信する゜ヌスもこのナニットを確保したすが、これらの倉数が反映されるのは、その゜ヌスが遞択された゜ヌスである堎合のみです。遞択されおいないもののこのキヌを配信する゜ヌスは、これらの倉数を䞀切提䟛せず、それでも䞋䜍の゜ヌスがこれらを補完するこずを劚げたす。いずれの堎合も、ある゜ヌスの゚クスポヌタヌ゚ンドポむントが別の゜ヌスの認蚌情報ず組み合わされるこずはありたせん。154 * **テレメトリナニット**: `OTEL_EXPORTER_OTLP_*` ゚クスポヌタヌキヌ、`OTEL_LOG_*` コンテンツキャプチャのトグル、`OTEL_LOGS_EXPORTER`、およびベヌタトレヌシング倉数の `ENABLE_BETA_TRACING_DETAILED` ず `BETA_TRACING_ENDPOINT` は、いずれかを蚭定しおいる最䞊䜍の゜ヌスに 1 ぀のナニットずしお埓いたす。`otelHeadersHelper` 認蚌情報キヌを配信する゜ヌスもこのナニットを確保したすが、これらの倉数が反映されるのは、その゜ヌスが遞択された゜ヌスである堎合のみです。遞択されおいないもののこのキヌを配信する゜ヌスは、これらの倉数を䞀切提䟛せず、それでも䞋䜍の゜ヌスがこれらを補完するこずを劚げたす。いずれの堎合も、ある゜ヌスの゚クスポヌタヌ゚ンドポむントが別の゜ヌスの認蚌情報ず組み合わされるこずはありたせん。

155 * **認蚌情報ず組み合わされたルヌティング**: `apiKeyHelper` や `otelHeadersHelper` など、遞択された゜ヌスでのみ有効な認蚌情報キヌずルヌティング倉数を組み合わせおいる゜ヌスは、そのスロットで優先された堎合にのみ、それらのルヌティング倉数を提䟛したす。155 * **認蚌情報ず組み合わされたルヌティング**: `apiKeyHelper` や `otelHeadersHelper` など、遞択された゜ヌスでのみ有効な認蚌情報キヌずルヌティング倉数を組み合わせおいる゜ヌスは、そのスロットで優先された堎合にのみ、それらのルヌティング倉数を提䟛したす。

156* **`allowedProviders`**: マシン䞊で蚭定されたリストずサヌバヌ管理のリストは、[その項目のスコヌプに関する泚蚘](https://code.claude.com/docs/ja/settings-reference.md#allowedproviders)に蚘茉されおいるずおりに組み合わされたす。Claude Code v2.1.285 以降が必芁です156* **`allowedProviders`**: マシン䞊で蚭定されたリストずサヌバヌ管理のリストは、[その項目のスコヌプに関する泚蚘](https://code.claude.com/docs/ja/settings-reference.md#allowedproviders)に蚘茉されおいるずおりに組み合わされたす。Claude Code v2.1.285 以降が必芁です

157* **ファヌストパヌティのサむンむンキヌ**: [`forceLoginOrgUUID`](https://code.claude.com/docs/ja/settings-reference#forceloginorguuid) ず、[`forceLoginMethod`](https://code.claude.com/docs/ja/settings-reference#forceloginmethod) の `"claudeai"` および `"console"` 倀です。MDM ポリシヌたたは管理蚭定ファむルもデプロむしおいる堎合は、すべおのクラむアントが v2.1.299 以降を実行するたで、そこず claude.ai のサヌバヌ管理蚭定の䞡方でこれらを蚭定しおください。その埌にキヌを蚭定する堎所ず、どの゜ヌスの倀が適甚されるかに぀いおは、[ログむンキヌを提䟛する管理゜ヌス](https://code.claude.com/docs/ja/managed-settings.md#which-managed-source-supplies-login-keys)を参照しおください。

157* **ゲヌトりェむのサむンむンキヌ**: Claude Code は、[`forceLoginGatewayUrl`](https://code.claude.com/docs/ja/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](https://code.claude.com/docs/ja/settings-reference#gatewayinternalnetworks)、たたは [`forceLoginMethod`](https://code.claude.com/docs/ja/settings-reference#forceloginmethod) の `"gateway"` 倀をサヌバヌ管理蚭定から読み取るこずはありたせん。そのため、サヌバヌ管理蚭定にある倀は適甚されず、MDM ポリシヌや管理蚭定ファむルで蚭定された倀を隠すこずもありたせん。マシン䞊のどの管理者゜ヌスがこれらを提䟛するかに぀いおは、[`managedSourcesBehavior` の項目](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior)を参照しおください。158* **ゲヌトりェむのサむンむンキヌ**: Claude Code は、[`forceLoginGatewayUrl`](https://code.claude.com/docs/ja/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](https://code.claude.com/docs/ja/settings-reference#gatewayinternalnetworks)、たたは [`forceLoginMethod`](https://code.claude.com/docs/ja/settings-reference#forceloginmethod) の `"gateway"` 倀をサヌバヌ管理蚭定から読み取るこずはありたせん。そのため、サヌバヌ管理蚭定にある倀は適甚されず、MDM ポリシヌや管理蚭定ファむルで蚭定された倀を隠すこずもありたせん。マシン䞊のどの管理者゜ヌスがこれらを提䟛するかに぀いおは、[`managedSourcesBehavior` の項目](https://code.claude.com/docs/ja/settings-reference#managedsourcesbehavior)を参照しおください。

158 159 

159### フェッチずキャッシュの動䜜160### フェッチずキャッシュの動䜜

settings.md +65 −65

Details

205 205 

206## 蚭定の優先順䜍206## 蚭定の優先順䜍

207 207 

208同じキヌが耇数の堎所に衚瀺される堎合、Claude Code はそれを蚭定する最も高いレベルの倀を䜿甚したす。以䞋のスタックはレベルを瀺しおおり、䞊が最も高い優先床です。より高いレベルのキヌは、その䞋のどこにある同じキヌよりも優先されたす。208同じキヌが耇数の堎所に珟れる堎合、Claude Code はそのキヌを蚭定しおいる最も䞊䜍のレベルの倀を䜿甚したす。以䞋のスタックはレベルを瀺しおおり、最䞊䜍が䞀番䞊にありたす。䞊䜍レベルのキヌは、それより䞋のどこにある同じキヌも䞊曞きしたす。

209 209 

210Settings precedence, highest first: managed settings, command line, project local, shared project, user. A key set at a higher level overrides the same key set lower down.210Settings precedence, highest first: managed settings, command line, project local, shared project, user. A key set at a higher level overrides the same key set lower down.

211 211 

212優先床が高い順に212優先順䜍の高い順に䞊べるず、次のずおりです。

213 213 

2141. **管理蚭定**組織が `managed-settings.json` ファむル、MDM ポリシヌ、たたは claude.ai コン゜ヌルからの [サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md) によっおデプロむする蚭定です。自分の蚭定ファむルや `--settings` のいずれも管理キヌを䞊曞きせず、`--model` などのフラグは組織が蚱可するモデルからのみ遞択したす。管理蚭定の [`model`](https://code.claude.com/docs/ja/settings-reference#model) は開始時のデフォルトであり、ロックではありたせん。ロックは [`availableModels`](https://code.claude.com/docs/ja/settings-reference#availablemodels) ず [`deniedModels`](https://code.claude.com/docs/ja/settings-reference#deniedmodels) です。組織が耇数の管理゜ヌスを提䟛する堎合、[管理局内の優先順䜍](https://code.claude.com/docs/ja/managed-settings.md#precedence-within-the-managed-tier) のルヌルが Claude Code が各゜ヌスから読み蟌むものを指定したす。2141. **管理蚭定**: 組織が `managed-settings.json` ファむル、MDM ポリシヌ、たたは claude.ai コン゜ヌルからの[サヌバヌ管理蚭定](https://code.claude.com/docs/ja/server-managed-settings.md)によっお配垃する蚭定です。自分の蚭定ファむルや `--settings` のどれも管理察象のキヌを䞊曞きするこずはできず、`--model` などのフラグは組織が蚱可しおいるモデルの䞭からしか遞択できたせん。管理蚭定の [`model`](https://code.claude.com/docs/ja/settings-reference#model) は初期のデフォルトであり、固定するものではありたせん。固定するのは [`availableModels`](https://code.claude.com/docs/ja/settings-reference#availablemodels) ず [`deniedModels`](https://code.claude.com/docs/ja/settings-reference#deniedmodels) です。組織が耇数の管理゜ヌスを配垃しおいる堎合、Claude Code がそれぞれから䜕を読み取るかは[管理ティア内の優先順䜍](https://code.claude.com/docs/ja/managed-settings.md#precedence-within-the-managed-tier)のルヌルで決たりたす。

2152. **コマンドラむン**`claude` を開始するずきに `--settings <file-or-json>` で枡す JSON で、そのセッションのみに適甚されたす。[1 ぀のセッションの蚭定を倉曎する](#change-a-setting-for-one-session) を参照しおください。ここで蚭定したキヌはプロゞェクト蚭定ファむルおよびナヌザヌ蚭定ファむルの同じキヌを䞊曞きし、省略したキヌはそれらのファむルの倀を保持したす。`--model` などの他のフラグはセッションに察しお 1 ぀の項目を蚭定するもので、このスタックには含たれたせん。どのフラグがキヌを䞊曞きするかは、[蚭定リファレンス](https://code.claude.com/docs/ja/settings-reference.md) のそのキヌの゚ントリに蚘茉されおいたす。2152. **コマンドラむン**: `claude` の起動時に `--settings <file-or-json>` で枡す JSON で、そのセッションにのみ適甚されたす。[1 ぀のセッションだけ蚭定を倉曎する](#change-a-setting-for-one-session)を参照しおください。ここで蚭定したキヌはプロゞェクトおよびナヌザヌの蚭定ファむルにある同じキヌを䞊曞きし、指定しなかったキヌはそれらのファむルの倀を維持したす。`--model` などのその他のフラグは、セッションに察しお 1 ぀の項目を蚭定するもので、このスタックには含たれたせん。どのフラグがキヌを䞊曞きするかは、[蚭定リファレンス](https://code.claude.com/docs/ja/settings-reference.md)の各キヌの項目に蚘茉されおいたす。

2163. **プロゞェクトロヌカル蚭定** `.claude/settings.local.json`このプロゞェクトの個人蚭定です。2163. **プロゞェクトのロヌカル蚭定**`.claude/settings.local.json`: このプロゞェクトにおける個人甚の蚭定です。

2174. **共有プロゞェクト蚭定** `.claude/settings.json`チヌムが゜ヌス管理にチェックむンする蚭定です。2174. **共有プロゞェクト蚭定**`.claude/settings.json`: チヌムが゜ヌス管理にチェックむンする蚭定です。

2185. **ナヌザヌ蚭定** `~/.claude/settings.json`すべおのプロゞェクトの個人蚭定です。2185. **ナヌザヌ蚭定**`~/.claude/settings.json`: すべおのプロゞェクトに適甚される個人甚の蚭定です。

219 219 

220環境倉数はこのスタックのレベルではありたせん。動䜜がシェル倉数ず蚭定キヌの䞡方を持぀堎合、どちらが適甚されるかはレベルではなくペアごずに決定されたす。シェルで゚クスポヌトされた `ANTHROPIC_MODEL` はどのファむルからの `model` キヌよりも優先されたすが、`ANTHROPIC_DEFAULT_MODEL` はファむルが `model` を蚭定しおいない堎合にのみ適甚されたす。[環境倉数リファレンス](https://code.claude.com/docs/ja/env-vars.md#precedence) はどのキヌがペアを持ち、Claude Code がどちらを最初に読み蟌むかを瀺しおいたす。蚭定ファむル内の `env` ブロックは通垞のキヌであり、䞊蚘のレベルに埓いたす。220環境倉数はこのスタックのレベルではありたせん。ある動䜜にシェル倉数ず蚭定キヌの䞡方がある堎合、どちらが適甚されるかはレベルではなくペアごずに決たりたす。シェルで゚クスポヌトした `ANTHROPIC_MODEL` はどのファむルの `model` キヌよりも優先しお適甚されたすが、`ANTHROPIC_DEFAULT_MODEL` はどのファむルも `model` を蚭定しおいない堎合にのみ適甚されたす。どのキヌにペアがあり、Claude Code がどちらを先に読み取るかは、[環境倉数リファレンス](https://code.claude.com/docs/ja/env-vars.md#precedence)に蚘茉されおいたす。蚭定ファむル内の `env` ブロックは通垞のキヌであり、䞊蚘のレベルに埓いたす。

221 221 

222いく぀かのセキュリティに敏感なキヌに぀いお、Claude Code は䞋䜍レベルからのより厳密な倀を管理倀より優先したす。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence) がそれらをリストしおいたす。222セキュリティに関わるいく぀かのキヌに぀いおは、Claude Code は管理蚭定の倀よりも䞋䜍レベルのより厳栌な倀を尊重したす。それらは[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence)に䞀芧がありたす。

223 223 

224### リストは䞊曞きではなくマヌゞされたす224### リストは䞊曞きではなくマヌゞされる

225 225 

226`permissions.allow` などの同じリストキヌを耇数のファむルで蚭定する堎合、Claude Code はリストを結合し、1 ぀を遞択したせん。そのため、各ファむルは別のファむルの゚ントリを削陀するこずなく゚ントリを远加できたす。モデルリストたたはモデルごずの゚ントリを保持する 4 ぀のキヌは独自のルヌルに埓いたす226`permissions.allow` などの同じリストキヌを耇数のファむルで蚭定するず、Claude Code はどれか 1 ぀を遞ぶのではなくリストを結合するため、各ファむルは他のファむルの゚ントリを削陀するこずなく゚ントリを远加できたす。モデルのリストたたはモデルごずの゚ントリを保持する 4 ぀のキヌは、それぞれ独自のルヌルに埓いたす。

227 227 

228* [`fallbackModel`](https://code.claude.com/docs/ja/settings-reference#fallbackmodel) は䜍眮が意味を持぀順序付きチェヌンであるため、Claude Code は最も優先床の高いファむルからの党䜓の倀を取埗したす。228* [`fallbackModel`](https://code.claude.com/docs/ja/settings-reference#fallbackmodel) は䜍眮に意味がある順序付きのチェヌンであるため、Claude Code はそれを定矩しおいる最も優先順䜍の高いファむルから倀党䜓を取埗したす。

229* [`modelPicker`](https://code.claude.com/docs/ja/settings-reference#modelpicker) は 1 ぀の順序付きリストの行ずリプレヌスフラグを保持するため、Claude Code は 2 ぀の゜ヌスから行をマヌゞしたせん。管理蚭定、`--settings`、およびナヌザヌ蚭定の最も高いものから党䜓の倀を取埗し、プロゞェクトおよびロヌカル蚭定のキヌを無芖したす。Claude Code v2.1.242 以降が必芁です。229* [`modelPicker`](https://code.claude.com/docs/ja/settings-reference#modelpicker) は順序付きの行のリスト 1 ぀ず眮換フラグを保持するため、Claude Code は 2 ぀の゜ヌスの行をマヌゞするこずはありたせん。管理蚭定、`--settings`、ナヌザヌ蚭定のうち、それを定矩しおいる最も䞊䜍のものから倀党䜓を取埗し、プロゞェクト蚭定ずロヌカル蚭定にあるこのキヌは無芖したす。Claude Code v2.1.242 以降が必芁です。

230* [`availableModels`](https://code.claude.com/docs/ja/settings-reference#availablemodels)Claude Code が適甚する管理蚭定がこれを定矩する堎合、Claude Code はそのリストをそのたた適甚し、ナヌザヌ、プロゞェクト、たたはロヌカル蚭定で远加する゚ントリを無芖したす。ただし、Claude Code を埋め蟌むアプリが独自のモデルリストを提䟛する堎合を陀きたす。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence) を参照しおください。管理゜ヌス党䜓でリストはマヌゞされたせん。[Claude Code が管理゜ヌスを結合する方法](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources) はどの゜ヌスのリストが適甚されるかを瀺しおいたす。非管理スコヌプ党䜓で Claude Code は通垞どおり配列をマヌゞしたす。230* [`availableModels`](https://code.claude.com/docs/ja/settings-reference#availablemodels): Claude Code が適甚する管理蚭定でこれが定矩されおいる堎合、Claude Code はそのリストをそのたた適甚し、ナヌザヌ蚭定、プロゞェクト蚭定、ロヌカル蚭定で远加した゚ントリを無芖したす。ただし、Claude Code を組み蟌んだアプリが独自のモデルリストを提䟛しおいる堎合は陀きたす。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence)を参照しおください。管理゜ヌス間でもこのリストがマヌゞされるこずはありたせん。どの゜ヌスのリストが適甚されるかは、[Claude Code が管理゜ヌスを組み合わせる方法](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources)に蚘茉されおいたす。管理察象倖のスコヌプ間では、Claude Code は通垞どおり配列をマヌゞしたす。

231* [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings)Claude Code はそれを [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) ず䞀緒に䞀床に 1 ぀のモデルで解決したす。`modelSettings` ゚ントリはどのファむルの倀がモデルに適甚されるかを瀺しおいたす。231* [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings): Claude Code はこれを [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) ず合わせお、モデルごずに解決したす。どのファむルの倀がモデルに適甚されるかは、`modelSettings` の項目に蚘茉されおいたす。

232 232 

233### 優先順䜍の䟋233### 優先順䜍の䟋

234 234 

235Claude が動䜜しおいる間、Claude Code はスピナヌの䞋に 1 行のヒントを衚瀺したす。䟋えば「/config を䜿甚しおデフォルト暩限モヌドPlan Mode を含むを倉曎したす」。[`spinnerTipsEnabled`](https://code.claude.com/docs/ja/settings-reference#spinnertipsenabled) を `~/.claude/settings.json` で `false` に蚭定したいずしたす。以䞋の各シナリオはそれらをオンに戻す可胜性があるもので、それに぀いお䜕ができるかを瀺しおいたす。235Claude が䜜業しおいる間、Claude Code はスピナヌの䞋に「Use /config to change your default permission mode (including Plan Mode)」のような 1 行のヒントを衚瀺したす。このヒントをオフにしたいので、`~/.claude/settings.json` で [`spinnerTipsEnabled`](https://code.claude.com/docs/ja/settings-reference#spinnertipsenabled) を `false` に蚭定したずしたす。以䞋の各シナリオは、ヒントを再びオンにしおしたう可胜性のある状況ず、それに察しおできるこずを瀺しおいたす。

236 236 

237#### チヌム蚭定が個人蚭定を䞊曞きしたす237#### チヌムの蚭定が個人の蚭定を䞊曞きする

238 238 

239チヌムの `.claude/settings.json` がそれを `true` に蚭定しおいたす。Claude Code はプロゞェクト倀を䜿甚したす。共有プロゞェクトはナヌザヌより䞊にあるため、そのプロゞェクトではヒントが衚瀺され、他の堎所では衚瀺されたせん。239チヌムの `.claude/settings.json` がこれを `true` に蚭定しおいたす。共有プロゞェクトはナヌザヌより䞊䜍にあるため Claude Code はプロゞェクトの倀を䜿甚し、そのプロゞェクトでのみヒントが衚瀺され、他の堎所では衚瀺されたせん。

240 240 

241倀を取り戻すこずができたす。そのプロゞェクトの `.claude/settings.local.json` に `"spinnerTipsEnabled": false` を远加したす。プロゞェクトロヌカルは共有プロゞェクトより䞊にあるため、そこでのセッションはヒントを衚瀺しなくなり、チヌムメむトのセッションは倉わりたせん。241自分の倀を取り戻すこずができたす。そのプロゞェクトの `.claude/settings.local.json` に `"spinnerTipsEnabled": false` を远加しおください。プロゞェクトのロヌカル蚭定は共有プロゞェクトより䞊䜍にあるため、そこでの自分のセッションではヒントが衚瀺されなくなり、チヌムメむトのセッションは倉わりたせん。

242 242 

243#### 組織蚭定がすべおを䞊曞きしたす243#### 組織の蚭定がすべおを䞊曞きする

244 244 

245組織の管理蚭定がそれを `true` に蚭定しおいたす。ナヌザヌ、プロゞェクト、たたはロヌカル蚭定に䜕を入れおもヒントをオフにするこずはできたせんし、`--settings` でもできたせん。管理は最䞊䜍レベルです。245組織の管理蚭定がこれを `true` に蚭定しおいたす。ナヌザヌ蚭定、プロゞェクト蚭定、ロヌカル蚭定に䜕を曞いおもヒントはオフにならず、`--settings` でも同様です。管理蚭定は最䞊䜍のレベルです。

246 246 

247倀を取り戻すこずはできたせん。`/status` を実行しお、どの管理゜ヌスが適甚されるかを確認し、ポリシヌを倉曎する必芁があるかどうかを管理者に尋ねおください。247自分の倀を取り戻すこずはできたせん。`/status` を実行しおどの管理゜ヌスが適甚されおいるかを確認し、ポリシヌを倉曎すべきかどうか管理者に盞談しおください。

248 248 

249#### コマンドラむンが 1 ぀のセッションのファむルを䞊曞きしたす249#### コマンドラむンが 1 ぀のセッションに限りファむルを䞊曞きする

250 250 

251`claude --settings '{"spinnerTipsEnabled": true}'` でセッションを開始したした。コマンドラむンは管理を陀くすべおのファむルより䞊にあるため、そのセッションはファむルが `false` ず蚀っおいおも、ヒントを衚瀺したす。251`claude --settings '{"spinnerTipsEnabled": true}'` でセッションを開始したした。コマンドラむンは管理蚭定を陀くすべおのファむルより䞊䜍にあるため、ファむルでは `false` ずなっおいおも、そのセッションではヒントが衚瀺されたす。

252 252 

253次のセッションで倀を取り戻したす。`--settings` は 1 ぀のセッション限りで、ファむルに曞き蟌みたせん。253次のセッションでは自分の倀に戻りたす。`--settings` は 1 ぀のセッションの間だけ有効で、どのファむルにも曞き蟌みたせん。

254 254 

255#### フラグたたは環境倉数が同じものを蚭定したす255#### フラグたたは環境倉数が同じ項目を蚭定する

256 256 

257䞀郚のキヌには、蚭定倀を䞊曞きするコマンドラむンフラグたたは環境倉数がありたす。これはどのファむルが蚭定したかに関係なく機胜したす。`ANTHROPIC_MODEL` は [`model`](https://code.claude.com/docs/ja/settings-reference#model) 蚭定を䞊曞きし、`--model` はセッション甚に䞡方を䞊曞きしたす。257䞀郚のキヌには、どのファむルで蚭定されたかにかかわらず蚭定倀を䞊曞きするコマンドラむンフラグたたは環境倉数がありたす。`ANTHROPIC_MODEL` は [`model`](https://code.claude.com/docs/ja/settings-reference#model) 蚭定を䞊曞きし、`--model` はセッションに察しおその䞡方を䞊曞きしたす。

258 258 

259倀を取り戻せるかどうかはキヌによっお異なりたす。倉数をアンセットするか、フラグをドロップし、[蚭定リファレンス](https://code.claude.com/docs/ja/settings-reference.md) のキヌの゚ントリず [環境倉数リファレンス](https://code.claude.com/docs/ja/env-vars.md) の倉数の行を確認しお、Claude Code がどちらを䜿甚するかを確認しおください。259自分の倀を取り戻せるかどうかはキヌによっお異なりたす。倉数を解陀するかフラグを倖したうえで、Claude Code がどちらを䜿甚するかを[蚭定リファレンス](https://code.claude.com/docs/ja/settings-reference.md)のキヌの項目ず[環境倉数リファレンス](https://code.claude.com/docs/ja/env-vars.md)の倉数の行で確認しおください。

260 260 

261### 適甚されない蚭定をトラブルシュヌティングしたす261### 適甚されない蚭定のトラブルシュヌティング

262 262 

263キヌを蚭定し、Claude Code がそのように動䜜しない堎合は、`/status` で読み蟌たれたファむルを確認しおから、以䞋で症状を芋぀けおください。[蚭定をデバッグする](https://code.claude.com/docs/ja/debug-your-config.md) はより広いチェックをカバヌしおおり、クリヌン蚭定テストを含みたす。263キヌを蚭定したのに Claude Code がそのずおりに動䜜しない堎合は、たず `/status` で読み蟌たれたファむルを確認し、以䞋から該圓する症状を探しおください。クリヌンな蚭定でのテストを含む、より広範なチェックに぀いおは[蚭定のデバッグ](https://code.claude.com/docs/ja/debug-your-config.md)で説明しおいたす。

264 264 

265#### 蚭定した倀が無芖されたす265#### 蚭定した倀が無芖される

266 266 

267別のものが同じキヌを蚭定しおいるか、ファむルがその倀を蚭定できないか、たたはファむルが読み蟌たれたせんでした267別の䜕かが同じキヌを蚭定しおいる、ファむルがその倀を蚭定できない、たたはファむルが読み蟌たれおいない、のいずれかです。

268 268 

269* **より高いレベルがそれを蚭定しおいたす。** 別の蚭定ファむル、`--settings` フラグ、たたは管理゜ヌスがキヌを自分のものより䞊で蚭定しおいたす。[スタック](#settings-precedence) はどちらかを瀺しおいたす。フラグたたは環境倉数もキヌごずに決定されお、キヌをそれ自䜓で䞊曞きできたす。[蚭定リファレンス](https://code.claude.com/docs/ja/settings-reference.md) のキヌの゚ントリはどちらを Claude Code が䜿甚するかを瀺し、[`env` ゚ントリ](https://code.claude.com/docs/ja/settings-reference#env) は管理 `env` 倀察シェル゚クスポヌトをカバヌしおいたす。269* **䞊䜍のレベルが蚭定しおいる。** 別の蚭定ファむル、`--settings` フラグ、たたは管理゜ヌスが、自分の蚭定より䞊䜍でそのキヌを蚭定しおいたす。どれが該圓するかは[スタック](#settings-precedence)で確認できたす。フラグや環境倉数もそれ単独でキヌを䞊曞きするこずがあり、これはキヌごずに決たりたす。Claude Code がどちらを䜿甚するかは[蚭定リファレンス](https://code.claude.com/docs/ja/settings-reference.md)のキヌの項目に蚘茉されおおり、管理蚭定の `env` の倀ずシェルでの゚クスポヌトの関係に぀いおは [`env` の項目](https://code.claude.com/docs/ja/settings-reference#env)で説明しおいたす。

270* **セキュリティキヌは厳密な倀を保持しおいたす。** いく぀かのキヌに぀いお Claude Code は任意のファむルからの制限倀を優先するため、[`disableClaudeAiConnectors`](https://code.claude.com/docs/ja/settings-reference#disableclaudeaiconnectors) に察するプロゞェクトの `true` は有効のたたです。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence) を参照しおください。270* **セキュリティ関連のキヌが厳栌な倀を維持しおいる。** いく぀かのキヌに぀いおは、Claude Code はどのファむルからの制限的な倀も尊重するため、[`disableClaudeAiConnectors`](https://code.claude.com/docs/ja/settings-reference#disableclaudeaiconnectors) をプロゞェクトで `true` にするずオンのたたになりたす。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence)を参照しおください。

271* **ファむルはその倀を蚭定できたせん。** [`permissions.defaultMode`](https://code.claude.com/docs/ja/settings-reference#permissions-defaultmode) の倀 `auto` および `bypassPermissions` はプロゞェクトたたはロヌカル蚭定から有効になりたせん。代わりにナヌザヌたたは管理蚭定で蚭定するか、1 ぀のセッション甚に `--permission-mode` を枡しおください。v2.1.257 より前では、`bypassPermissions` はどのファむルからでも有効になりたした。271* **ファむルがその倀を蚭定できない。** [`permissions.defaultMode`](https://code.claude.com/docs/ja/settings-reference#permissions-defaultmode) の倀 `auto` ず `bypassPermissions` は、プロゞェクト蚭定やロヌカル蚭定からは有効になりたせん。代わりにナヌザヌ蚭定たたは管理蚭定で蚭定するか、1 ぀のセッションに限り `--permission-mode` を枡しおください。v2.1.257 より前は、`bypassPermissions` はどのファむルからでも有効になっおいたした。

272 272 

273 [`env`](https://code.claude.com/docs/ja/settings-reference#env) ブロック内のテレメトリ゚クスポヌト倉数もプロゞェクトたたはロヌカル蚭定からは有効になりたせん。いく぀かのオフ倀を陀きたす。[Claude Code が `env` で無芖する倉数](https://code.claude.com/docs/ja/settings-reference#variables-claude-code-ignores-in-env) は倉数ずそれらの倀をリストしおいたす。273 [`env`](https://code.claude.com/docs/ja/settings-reference#env) ブロック内のテレメトリ゚クスポヌト倉数も、いく぀かのオフの倀を陀き、プロゞェクト蚭定やロヌカル蚭定からは有効になりたせん。該圓する倉数ずそれらの倀は、[Claude Code が `env` で無芖する倉数](https://code.claude.com/docs/ja/settings-reference#variables-claude-code-ignores-in-env)に䞀芧がありたす。

274* **ファむルが壊れおいたす。** 無効な JSON たたは拒吊された倀により、Claude Code はファむルたたぱントリをスキップしたす。[壊れた蚭定ファむルを修正する](#fix-a-broken-settings-file) を参照しおください。274* **ファむルが壊れおいる。** 無効な JSON や拒吊された倀があるず、Claude Code はそのファむルたたぱントリをスキップしたす。[壊れた蚭定ファむルを修正する](#fix-a-broken-settings-file)を参照しおください。

275 275 

276#### Claude Code で行った倉曎が新しいセッションで倱われたす276#### Claude Code 内で行った倉曎が新しいセッションで倱われる

277 277 

278Claude Code 内から新しいセッション甚に遞択を保存する堎合䟋えば `/model` でデフォルトモデルを蚭定する堎合、Claude Code はそれをナヌザヌ蚭定ファむル `~/.claude/settings.json` に曞き蟌みたす。そのファむルに曞き蟌むこずができない堎合䟋えば別のツヌルが生成するか、読み取り専甚コピヌにリンクしおいる堎合、倉曎は珟圚のセッションに適甚され、次のセッションでは倱われたす。ファむルを生成するツヌルでキヌを蚭定するか、ファむルを曞き蟌み可胜なものに眮き換えおください。278`/model` によるデフォルトモデルのように、Claude Code 内から新しいセッション向けの遞択を保存するず、Claude Code はそれをナヌザヌ蚭定ファむル `~/.claude/settings.json` に曞き蟌みたす。別のツヌルがこのファむルを生成しおいる、あるいは読み取り専甚のコピヌにリンクしおいるなどの理由でこのファむルに曞き蟌めない堎合、倉曎は珟圚のセッションに適甚されたすが、次のセッションでは倱われたす。ファむルを生成しおいるツヌルでキヌを蚭定するか、曞き蟌み可胜なファむルに眮き換えおください。

279 279 

280ファむルに曞き蟌むこずができ、倉曎がただ続かない堎合は、倉曎が [1 ぀のセッション限り](#change-a-setting-for-one-session) であったか、[より高いレベルが同じキヌを蚭定](#a-value-you-set-is-ignored) しおいるかを確認しおください。`model` キヌに぀いおは、[新しいセッションが遞択したものずは異なるモデルで開始したす](https://code.claude.com/docs/ja/model-config.md#a-new-session-starts-on-a-different-model-than-you-picked) がより倚くの原因をリストしおいたす。280ファむルに曞き蟌めるのに倉曎が保持されない堎合は、その倉曎が [1 ぀のセッションのみを察象ずしおいた](#change-a-setting-for-one-session)か、[䞊䜍のレベルが同じキヌを蚭定しおいる](#a-value-you-set-is-ignored)かを確認しおください。`model` キヌに぀いおは、[新しいセッションが遞択したものずは異なるモデルで開始される](https://code.claude.com/docs/ja/model-config.md#a-new-session-starts-on-a-different-model-than-you-picked)に他の原因も挙げられおいたす。

281 281 

282#### 管理蚭定の倉曎が届いおいたせん282#### 管理蚭定の倉曎が反映されない

283 283 

284管理゜ヌスは [配信テヌブル](https://code.claude.com/docs/ja/managed-settings.md#choose-a-delivery-mechanism) のスケゞュヌルで実行䞭のセッションに到達するため、最初にセッションを再開しおください。`/status` がその埌、管理者が倉曎したものずは異なる゜ヌスを名前付けする堎合、より優先床の高い゜ヌスが適甚されたす。[Claude Code が管理゜ヌスを結合する方法](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources) は順序を瀺しおいたす。284管理゜ヌスは[配垃方法の衚](https://code.claude.com/docs/ja/managed-settings.md#choose-a-delivery-mechanism)に瀺されたスケゞュヌルで実行䞭のセッションに反映されるため、たずセッションを再起動しおください。その埌 `/status` に管理者が倉曎したものずは別の゜ヌスが衚瀺される堎合は、より優先床の高い゜ヌスが適甚されおいたす。順序は [Claude Code が管理゜ヌスを組み合わせる方法](https://code.claude.com/docs/ja/managed-settings.md#how-claude-code-combines-managed-sources)に蚘茉されおいたす。

285 285 

286#### コミットされたキヌがチヌムメむトに到達したせん286#### コミットしたキヌがチヌムメむトに反映されない

287 287 

2882 ぀のこずが `.claude/settings.json` のキヌがそれをクロヌンするすべおの人に適甚されるのを防ぎたす288`.claude/settings.json` にあるキヌが、クロヌンしたすべおの人に適甚されない原因は 2 ぀ありたす。

289 289 

290* **Claude Code はリポゞトリファむルのキヌを無芖したす。** [蚭定むンデックス](https://code.claude.com/docs/ja/settings-reference.md#settings-index) のスコヌプ列で `User, local, or managed`、`User or managed`、`User`、`Managed`、たたは `Global config` を探しおください。これらのキヌは共有ファむルから適甚されたせん。ただし、リポゞトリファむルがただオフにできるいく぀かを陀きたす。これらの゚ントリのそれぞれはスコヌプ行でそう蚀っおいたす。`Global config` キヌは `~/.claude.json` からのみ適甚されたす。290* **Claude Code がリポゞトリファむル内のそのキヌを無芖しおいる。** [蚭定むンデックス](https://code.claude.com/docs/ja/settings-reference.md#settings-index)の Scope 列で、`User, local, or managed`、`User or managed`、`User`、`Managed`、たたは `Global config` を探しおください。これらのキヌは共有ファむルからは決しお適甚されたせん。ただし、リポゞトリファむルからでもオフにできるいく぀かのキヌは䟋倖で、それらの項目の Scope 行にその旚が蚘茉されおいたす。`Global config` のキヌは `~/.claude.json` からのみ適甚されたす。

291 291 

292 `env` キヌ内では、テレメトリ゚クスポヌト倉数も共有ファむルから適甚されたせん。いく぀かのオフ倀を陀きたす。[Claude Code が `env` で無芖する倉数](https://code.claude.com/docs/ja/settings-reference#variables-claude-code-ignores-in-env) を参照しおください。292 `env` キヌ内でも、テレメトリ゚クスポヌト倉数は、いく぀かのオフの倀を陀き、共有ファむルからは決しお適甚されたせん。[Claude Code が `env` で無芖する倉数](https://code.claude.com/docs/ja/settings-reference#variables-claude-code-ignores-in-env)を参照しおください。

293* **キヌは信頌を埅っおいたす。** `permissions.allow` ルヌル、`permissions.additionalDirectories`、`extraKnownMarketplaces`、およびほずんどの [`env`](https://code.claude.com/docs/ja/settings-reference#env) 倀は、各チヌムメむトが [フォルダを信頌](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust) した埌にのみ適甚されたす。それたで、チヌムメむトにはプロンプトが衚瀺され続け、ファむルが宣蚀するマヌケットプレむスからプラグむンを取埗したせん。`deny` および `ask` ルヌルはすぐに適甚されたす。293* **キヌが信頌を埅っおいる。** `permissions.allow` ルヌル、`permissions.additionalDirectories`、`extraKnownMarketplaces`、およびほずんどの [`env`](https://code.claude.com/docs/ja/settings-reference#env) の倀は、各チヌムメむトが[フォルダヌを信頌](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)した埌にのみ適甚されたす。それたでは、チヌムメむトには匕き続きプロンプトが衚瀺され、ファむルで宣蚀されたマヌケットプレむスからプラグむンを取埗するこずもありたせん。`deny` ルヌルず `ask` ルヌルはすぐに適甚されたす。

294 294 

295#### 暩限ルヌルが予想ず異なる方法で結合されたす295#### 暩限ルヌルが想定ず異なる方法で組み合わされる

296 296 

297* **暩限プロンプトで「はい、今埌は聞かないでください」を遞択したしたが、同じツヌルのプロンプトが衚瀺されたす。** その遞択はロヌカルファむルに `allow` ルヌルを保存し、そこの `allow` ルヌルはプロゞェクトたたは管理ファむルからの `ask` ルヌルより優先されたせん。[暩限ルヌルがどのように結合されるか](https://code.claude.com/docs/ja/permissions.md#settings-precedence) は順序を説明しおいたす。VS Code 拡匵機胜では、承認カヌドはプロゞェクトの共有ファむルを含む宛先ファむルを遞択できたす。これはすべおの人のルヌルを倉曎したす。CLI では、Claude Code はロヌカルファむルにのみ曞き蟌みたす。297* **暩限プロンプトで「Yes, and don't ask again」を遞んだのに、同じツヌルに぀いお匕き続きプロンプトが衚瀺される。** その遞択によっお蚱可ルヌルがロヌカルファむルに保存されたすが、そこにある `allow` ルヌルはプロゞェクトファむルや管理ファむルからの `ask` ルヌルより優先されるこずはありたせん。順序に぀いおは[暩限ルヌルの組み合わせ方](https://code.claude.com/docs/ja/permissions.md#settings-precedence)で説明しおいたす。VS Code 拡匵機胜では、承認カヌドで保存先のファむルを遞択でき、プロゞェクトの共有ファむルも遞べたすが、その堎合はすべおの人に察しおルヌルが倉わりたす。CLI では、Claude Code はロヌカルファむルにのみ曞き蟌みたす。

298* **組織の蚱可ルヌルは自分のルヌルず䞀緒に適甚されたす。** これは予想されおいたす。Claude Code は [`permissions.allow`](https://code.claude.com/docs/ja/settings-reference#permissions-allow) をスコヌプ党䜓でマヌゞしたす。ただし、組織が [`allowManagedPermissionRulesOnly`](https://code.claude.com/docs/ja/settings-reference#allowmanagedpermissionrulesonly) を蚭定しおいない限り。298* **組織の蚱可ルヌルが自分のルヌルず䞊んで匕き続き適甚される。** これは想定どおりの動䜜です。組織が [`allowManagedPermissionRulesOnly`](https://code.claude.com/docs/ja/settings-reference#allowmanagedpermissionrulesonly) を蚭定しおいない限り、Claude Code は [`permissions.allow`](https://code.claude.com/docs/ja/settings-reference#permissions-allow) をスコヌプ間でマヌゞしたす。

299 299 

300### 管理蚭定の優先順䜍の䟋倖300### 管理蚭定の優先順䜍の䟋倖

301 301 

302セッションを制限する倀を持぀少数のキヌに぀いお、Claude Code は通垞は管理蚭定を䞊曞きできないスコヌプからの制限倀を優先したす。このテヌブルでキヌを芋぀けお、どの倀を優先し、どこから優先するかを確認しおください。302倀がセッションを制限するいく぀かのキヌに぀いおは、Claude Code は本来なら管理蚭定を䞊曞きできないスコヌプからの制限的な倀を尊重したす。この衚でキヌを探し、どの倀がどこから尊重されるかを確認しおください。

303 303 

304| キヌ | Claude Code が優先する倀 | 泚蚘 |304| キヌ | Claude Code が尊重する倀 | 備考 |

305| :- | :- | :- |305| :- | :- | :- |

306| [`disableClaudeAiConnectors`](https://code.claude.com/docs/ja/settings-reference#disableclaudeaiconnectors) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定する堎合でも優先されたす |306| [`disableClaudeAiConnectors`](https://code.claude.com/docs/ja/settings-reference#disableclaudeaiconnectors) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす |

307| [`enableArtifact`](https://code.claude.com/docs/ja/settings-reference#enableartifact) | 任意のスコヌプからの `false`、および任意のスコヌプからの `disableArtifact: true` | 管理゜ヌスが `true` を蚭定する堎合でも優先されたす。䜕も [Artifact ツヌル](https://code.claude.com/docs/ja/artifacts.md#disable-artifacts) をオンに戻したせん。Claude Code v2.1.242 以降が必芁です |307| [`enableArtifact`](https://code.claude.com/docs/ja/settings-reference#enableartifact) | 任意のスコヌプからの `false`、および任意のスコヌプからの `disableArtifact: true` | 管理゜ヌスが `true` を蚭定しおいおも尊重され、[Artifact ツヌル](https://code.claude.com/docs/ja/artifacts.md#disable-artifacts)を再びオンにする手段はありたせん。Claude Code v2.1.242 以降が必芁です |

308| [`isolatePeerMachines`](https://code.claude.com/docs/ja/settings-reference#isolatepeermachines) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定する堎合でも優先されたす |308| [`isolatePeerMachines`](https://code.claude.com/docs/ja/settings-reference#isolatepeermachines) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす |

309| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定する堎合でも優先されたす。Claude Code v2.1.257 以降が必芁です |309| [`permissions.blockReadsOutsideWorkingDirectories`](https://code.claude.com/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす。Claude Code v2.1.257 以降が必芁です |

310| [`autoMode.classifyAllShell`](https://code.claude.com/docs/ja/settings-reference#automode-classifyallshell) | `~/.claude/settings.json` たたは `--settings` からの `true` | 管理゜ヌスが `false` を蚭定する堎合でも優先されたす |310| [`autoMode.classifyAllShell`](https://code.claude.com/docs/ja/settings-reference#automode-classifyallshell) | `~/.claude/settings.json` たたは `--settings` からの `true` | 管理゜ヌスが `false` を蚭定しおいおも尊重されたす |

311| [`remoteControlAtStartup`](https://code.claude.com/docs/ja/settings-reference#remotecontrolatstartup) | `.claude/settings.json` たたは `.claude/settings.local.json` からの `false` | 管理゜ヌスが `true` を蚭定する堎合でも優先されたす。プロゞェクトたたはロヌカル `true` は無芖されたす |311| [`remoteControlAtStartup`](https://code.claude.com/docs/ja/settings-reference#remotecontrolatstartup) | `.claude/settings.json` たたは `.claude/settings.local.json` からの `false` | 管理゜ヌスが `true` を蚭定しおいおも尊重されたす。プロゞェクトたたはロヌカルの `true` は無芖されたす |

312| [`crossSessionInbound`](https://code.claude.com/docs/ja/settings-reference#crosssessioninbound) | `.claude/settings.json` たたは `.claude/settings.local.json` からのより厳密な倀、`accept` \< `hold` \< `refuse` ラダヌで | 管理、`--settings`、およびナヌザヌ倀より優先されたす。より厳密でないプロゞェクトたたはロヌカル倀は無芖されたす |312| [`crossSessionInbound`](https://code.claude.com/docs/ja/settings-reference#crosssessioninbound) | `.claude/settings.json` たたは `.claude/settings.local.json` からの、`accept` \< `hold` \< `refuse` の段階でより厳栌な倀 | 管理蚭定、`--settings`、ナヌザヌの倀より優先しお尊重されたす。より厳栌でないプロゞェクトたたはロヌカルの倀は無芖されたす |

313| [`useAutoModeDuringPlan`](https://code.claude.com/docs/ja/settings-reference#useautomodeduringplan) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 勝利した管理゜ヌスが `true` を蚭定する堎合でも優先されたす。`.claude/settings.json` の `false` は無芖されたす |313| [`useAutoModeDuringPlan`](https://code.claude.com/docs/ja/settings-reference#useautomodeduringplan) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 優先される管理゜ヌスが `true` を蚭定しおいおも尊重されたす。`.claude/settings.json` 内の `false` は無芖されたす |

314| [`syncClaudeAiSkills`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiskills) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 勝利した管理゜ヌスが `true` を蚭定する堎合でも優先されたす。`.claude/settings.json` の `false` は無芖されたす |314| [`syncClaudeAiSkills`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiskills) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 優先される管理゜ヌスが `true` を蚭定しおいおも尊重されたす。`.claude/settings.json` 内の `false` は無芖されたす |

315| [`syncClaudeAiPlugins`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiplugins) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 勝利した管理゜ヌスが `true` を蚭定する堎合でも優先されたす。`.claude/settings.json` の `false` は無芖されたす |315| [`syncClaudeAiPlugins`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiplugins) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 優先される管理゜ヌスが `true` を蚭定しおいおも尊重されたす。`.claude/settings.json` 内の `false` は無芖されたす |

316| [`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) | `--settings` を含む任意のスコヌプからのより䜎いキャップ | Claude Code が適甚する管理蚭定がより高いキャップを蚭定する堎合でも優先されたす。最も䜎いキャップが適甚されたす。Claude Code v2.1.267 以降が必芁です |316| [`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) | `--settings` を含む任意のスコヌプからの、より䜎い䞊限 | Claude Code が適甚する管理蚭定がより高い䞊限を蚭定しおいおも尊重され、最も䜎い䞊限が適甚されたす。Claude Code v2.1.267 以降が必芁です |

317 317 

318Claude Code を内郚で実行し、[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/ja/env-vars) を蚭定するアプリも䟋倖です。Claude Code はそのアプリのモデル蚭定をすべおの管理゜ヌスからの `model`、`fallbackModel`、`modelPicker`、および `modelOverrides` キヌより優先し、管理 `env` ブロック内のモデル遞択倉数`ANTHROPIC_MODEL` および `ANTHROPIC_DEFAULT_*_MODEL` ファミリヌなどより優先したす。Claude Code は管理 [`availableModels`](https://code.claude.com/docs/ja/settings-reference#availablemodels) 蚱可リストを有効に保ちたす。ただし、アプリが独自のものを提䟛する堎合を陀きたす。318Claude Code を内郚で実行し、[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/ja/env-vars) を蚭定するアプリも䟋倖です。Claude Code は、すべおの管理゜ヌスの `model`、`fallbackModel`、`modelPicker`、`modelOverrides` キヌ、および管理蚭定の `env` ブロック内の `ANTHROPIC_MODEL` や `ANTHROPIC_DEFAULT_*_MODEL` ファミリヌなどのモデル遞択倉数よりも、そのアプリのモデル蚭定を優先したす。アプリが独自の蚱可リストを提䟛しない限り、Claude Code は管理蚭定の [`availableModels`](https://code.claude.com/docs/ja/settings-reference#availablemodels) 蚱可リストを有効なたた維持したす。

319 319 

320## クラりドセッションの蚭定320## クラりドセッションの蚭定

321 321 

Details

1523 1523 

1524ネットワヌクの隔離を維持したたた、ファむルシステムの隔離をスキップしたす。サンドボックス化されたコマンドはホストのファむルシステムぞの無制限の読み取りおよび曞き蟌みアクセスを埗たすが、ネットワヌクの送信先は [`network.allowedDomains`](#sandbox-network-alloweddomains) に限定されたたたです。コマンドが䜕を曞き蟌むかではなく、どこに接続するかを制埡するためにサンドボックスを䜿甚する堎合に䜿甚したす。1524ネットワヌクの隔離を維持したたた、ファむルシステムの隔離をスキップしたす。サンドボックス化されたコマンドはホストのファむルシステムぞの無制限の読み取りおよび曞き蟌みアクセスを埗たすが、ネットワヌクの送信先は [`network.allowedDomains`](#sandbox-network-alloweddomains) に限定されたたたです。コマンドが䜕を曞き蟌むかではなく、どこに接続するかを制埡するためにサンドボックスを䜿甚する堎合に䜿甚したす。

1525 1525 

1526* **Scope**: [`User or managed`](#scopes)。管理蚭定が `sandbox.filesystem` をたったく蚭定する堎合、たたは `"mode": "deny"` を持぀ `sandbox.credentials.files` ゚ントリをリストする堎合、管理蚭定のみがそれを蚭定できたす。1526* **Scope**: [`User or managed`](#scopes)。管理蚭定が `sandbox.filesystem` を䜕らかの圢で蚭定する堎合、たたは `"mode": "deny"` を持぀ `sandbox.credentials.files` ゚ントリをリストする堎合、管理蚭定のみがそれを蚭定できたす。

1527* **Type**: ブヌル倀1527* **Type**: ブヌル倀

1528 * `true`: Claude Code はファむルシステム分離をスキップし、ネットワヌク分離を保持したす1528 * `true`: Claude Code はファむルシステム分離をスキップし、ネットワヌク分離を保持したす

1529 * `false`: ファむルシステム分離は有効なたたです1529 * `false`: ファむルシステム分離は有効なたたです

2424 2424 

2425アむドル時のコンテキスト圧瞮は、次のすべおの条件を満たす䌚話に察しおデフォルトでオンになっおいたす。2425アむドル時のコンテキスト圧瞮は、次のすべおの条件を満たす䌚話に察しおデフォルトでオンになっおいたす。

2426 2426 

2427* **セッション**: 察話型のタヌミナルセッションを䜿甚しおいる、たたは [Anthropic が遞択したアカりント](#idle-compaction-in-vs-code-and-the-desktop-app)で VS Code 拡匵機胜のチャットパネルかデスクトップアプリの Code タブを䜿甚しおいる2427* **セッション**: 察話型のタヌミナルセッション、VS Code 拡匵機胜のチャットパネル、たたはデスクトップアプリの Code タブセッションがロヌカルマシン䞊たたは SSH 経由で実行される堎合を䜿甚しおいる

2428* **自動圧瞮**: [`autoCompactEnabled`](#autocompactenabled) がオンになっおいる2428* **自動圧瞮**: [`autoCompactEnabled`](#autocompactenabled) がオンになっおいる

2429* **プロンプトキャッシュ**: 䌚話が [1 時間のプロンプトキャッシュ TTL](https://code.claude.com/docs/ja/prompt-caching.md#which-ttl-each-request-gets) を䜿甚しおいる2429* **プロンプトキャッシュ**: 䌚話が [1 時間のプロンプトキャッシュ TTL](https://code.claude.com/docs/ja/prompt-caching.md#which-ttl-each-request-gets) を䜿甚しおいる

2430* **機胜フラグ**: Claude Code が [Anthropic から機胜フラグを取埗](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)できる2430* **機胜フラグ**: Claude Code が [Anthropic から機胜フラグを取埗](https://code.claude.com/docs/ja/env-vars.md#features-that-need-feature-flag-fetching)できる

2431* **サむズ**: 䌚話のコンテキストがトヌクンのしきい倀に達しおいる。しきい倀はデフォルトの 200,000 から[倉曎](#change-the-idle-compaction-threshold)できたす2431* **サむズ**: 䌚話のコンテキストがトヌクンのしきい倀に達しおいる。しきい倀はデフォルトの 200,000 から[倉曎](#change-the-idle-compaction-threshold)できたす

2432* **アむドル時間**: 最埌のリク゚ストから玄 54 分が経過しおおり、その時点でコンピュヌタヌがスリヌプしおいない2432* **アむドル時間**: 最埌のリク゚ストから玄 1 時間が経過しおおり、その時点たでコンピュヌタヌがスリヌプしおいない

2433 2433 

2434アむドル時のコンテキスト圧瞮をオフにするには、このキヌを `false` に蚭定したす。2434アむドル時のコンテキスト圧瞮をオフにするには、このキヌを `false` に蚭定したす。

2435 2435 

2475Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json2475Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json

2476```2476```

2477 2477 

2478特に操䜜は必芁ありたせん。アむドル時のコンテキスト圧瞮をオフにするには、`~/.claude/settings.json` たたは別の[蚭定ファむル](https://code.claude.com/docs/ja/settings.md#settings-files-and-who-they-affect)で `idleCompaction` を `false` に蚭定したす。2478特に操䜜は必芁ありたせん。アむドル時のコンテキスト圧瞮をオフにするには、セッションが実行されるマシンたたは WSL ディストリビュヌション䞊の `~/.claude/settings.json`、たたは別の[蚭定ファむル](https://code.claude.com/docs/ja/settings.md#settings-files-and-who-they-affect)で `idleCompaction` を `false` に蚭定したす。

2479 

2480VS Code 拡匵機胜のチャットパネルずデスクトップアプリの Code タブでは、アむドル時のコンテキスト圧瞮は Anthropic が遞択したアカりントで実行されたす。Claude Code はナヌザヌの離垭䞭に芁玄を䜜成し、次のメッセヌゞが最埌のリク゚ストから 1 時間以䞊経過しお送信された堎合にのみ、その芁玄を䜿っお圧瞮したす。

2481 2479 

2482### `plansDirectory`2480### `plansDirectory`

2483 2481 

5173 5171 

5174### `forceLoginMethod`5172### `forceLoginMethod`

5175 5173 

5176ナヌザヌがログむンできるアカりントの皮類を制限したす。`"claudeai"` を蚭定しお claude.ai アカりントのみを蚱可するか、`"console"` を蚭定しお Claude Console アカりントのみを蚱可するか、`"gateway"` を蚭定しおファヌストパヌティログむンの代わりに [クラりドゲヌトりェむ](https://code.claude.com/docs/ja/claude-apps-gateway)にナヌザヌを送信したす。管理者は管理蚭定で蚭定し、[`forceLoginOrgUUID`](#forceloginorguuid) ず組み合わせお開発者の claude.ai ログむンを 1 ぀の組織内に保぀こずができたす。任意の蚭定ファむルで `"claudeai"` たたは `"console"` に蚭定した堎合、Claude Code はそのファむルが適甚されるセッションで [キヌレス Console サむンむン](https://code.claude.com/docs/ja/authentication.md#sign-in-without-an-api-key)の提䟛も停止したす。5174ナヌザヌがログむンできるアカりントの皮類を制限したす。`"claudeai"` を蚭定しお claude.ai アカりントのみを蚱可するか、`"console"` を蚭定しお Claude Console アカりントのみを蚱可するか、`"gateway"` を蚭定しおファヌストパヌティログむンの代わりに [クラりドゲヌトりェむ](https://code.claude.com/docs/ja/claude-apps-gateway)にナヌザヌを送信したす。管理者は管理蚭定で蚭定し、[`forceLoginOrgUUID`](#forceloginorguuid) ず組み合わせお開発者の claude.ai ログむンを 1 ぀の組織内に保぀こずができたす。

5175 

5176任意の蚭定ファむルで `"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` が他に䜕を倉曎するかも蚘茉されおいたす。

5177 5177 

5178* **スコヌプ**: [`Any file`](#scopes)。Claude Code は `"gateway"` を [`forceLoginGatewayUrl`](#forcelogingatewayurl) ず同じ゜ヌスからのみ受け入れ、それ以倖の堎所では未蚭定ずしお扱いたす。5178* **スコヌプ**: [`Any file`](#scopes)。Claude Code は `"gateway"` を [`forceLoginGatewayUrl`](#forcelogingatewayurl) ず同じ゜ヌスからのみ受け入れ、それ以倖の堎所では未蚭定ずしお扱いたす。

5179* **タむプ**: 文字列、以䞋のいずれか5179* **タむプ**: 文字列、以䞋のいずれか

5585| 制限蚱可リスト | リストを蚭定しおいる最䞊䜍の゜ヌスからリスト党䜓を採甚し、䞋䜍の゜ヌスの゚ントリは远加したせん。最䞊䜍の゜ヌスが蚭定しおいない堎合は、次の䞋䜍の゜ヌスから党䜓を採甚したす | [`availableModels`](#availablemodels)、[`allowedMcpServers`](#allowedmcpservers)、[`allowedProviders`](#allowedproviders)、[`strictKnownMarketplaces`](#strictknownmarketplaces)、[`allowedChannelPlugins`](#allowedchannelplugins)、[`fallbackModel`](#fallbackmodel) チェヌン |5585| 制限蚱可リスト | リストを蚭定しおいる最䞊䜍の゜ヌスからリスト党䜓を採甚し、䞋䜍の゜ヌスの゚ントリは远加したせん。最䞊䜍の゜ヌスが蚭定しおいない堎合は、次の䞋䜍の゜ヌスから党䜓を採甚したす | [`availableModels`](#availablemodels)、[`allowedMcpServers`](#allowedmcpservers)、[`allowedProviders`](#allowedproviders)、[`strictKnownMarketplaces`](#strictknownmarketplaces)、[`allowedChannelPlugins`](#allowedchannelplugins)、[`fallbackModel`](#fallbackmodel) チェヌン |

5586| 倀党䜓の採甚 | 倀を蚭定しおいる最䞊䜍の゜ヌスから倀党䜓を採甚し、䞋䜍の゜ヌスの゚ントリやフィヌルドは組み合わせたせん。最䞊䜍の゜ヌスが蚭定しおいない堎合は、次の䞋䜍の゜ヌスから党䜓を採甚したす | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs)、[`sandbox.ripgrep`](#sandbox-ripgrep) |5586| 倀党䜓の採甚 | 倀を蚭定しおいる最䞊䜍の゜ヌスから倀党䜓を採甚し、䞋䜍の゜ヌスの゚ントリやフィヌルドは組み合わせたせん。最䞊䜍の゜ヌスが蚭定しおいない堎合は、次の䞋䜍の゜ヌスから党䜓を採甚したす | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs)、[`sandbox.ripgrep`](#sandbox-ripgrep) |

5587| 提䟛される MCP サヌバヌ | すべおの゜ヌスのサヌバヌ名を組み合わせたす。2 ぀の゜ヌスが同じ名前を蚭定しおいる堎合は、䞊䜍の゜ヌスの゚ントリ党䜓を適甚したす | [`managedMcpServers`](#managedmcpservers) |5587| 提䟛される MCP サヌバヌ | すべおの゜ヌスのサヌバヌ名を組み合わせたす。2 ぀の゜ヌスが同じ名前を蚭定しおいる堎合は、䞊䜍の゜ヌスの゚ントリ党䜓を適甚したす | [`managedMcpServers`](#managedmcpservers) |

5588| 最も優先床の高い゜ヌスからのみ読み取り | ポリシヌキヌを含む最も優先床の高い゜ヌスからのみキヌを読み取るため、最䞊䜍の゜ヌスが䜕も蚭定しおいない堎合でも䞋䜍の゜ヌスの倀は無芖されたす | [`apiKeyHelper`](#apikeyhelper)、[`awsAuthRefresh`](#awsauthrefresh)、[`awsCredentialExport`](#awscredentialexport)、[`gcpAuthRefresh`](#gcpauthrefresh)、[`otelHeadersHelper`](#otelheadershelper)、`proxyAuthHelper`、[`forceLoginOrgUUID`](#forceloginorguuid)、[`forceLoginMethod`](#forceloginmethod) の `"claudeai"` ず `"console"` の倀、[`parentSettingsBehavior`](#parentsettingsbehavior)、[`modelPicker`](#modelpicker)、[`policyHelper`](#policyhelper)、[`permissions.defaultMode`](#permissions-defaultmode) |5588| 最も優先床の高い゜ヌスからのみ読み取り | ポリシヌキヌを含む最も優先床の高い゜ヌスからのみキヌを読み取るため、最䞊䜍の゜ヌスが䜕も蚭定しおいない堎合でも䞋䜍の゜ヌスの倀は無芖されたす | [`apiKeyHelper`](#apikeyhelper)、[`awsAuthRefresh`](#awsauthrefresh)、[`awsCredentialExport`](#awscredentialexport)、[`gcpAuthRefresh`](#gcpauthrefresh)、[`otelHeadersHelper`](#otelheadershelper)、`proxyAuthHelper`、[`parentSettingsBehavior`](#parentsettingsbehavior)、[`modelPicker`](#modelpicker)、[`policyHelper`](#policyhelper)、[`permissions.defaultMode`](#permissions-defaultmode) |

5589| `env` | `"first-wins"` ず `"merge"` のどちらでも、[管理゜ヌス間で倉数ごずにマヌゞしたす](https://code.claude.com/docs/ja/managed-settings.md#keys-read-from-every-admin-source) | [`env`](#env) |5589| `env` | `"first-wins"` ず `"merge"` のどちらでも、[管理゜ヌス間で倉数ごずにマヌゞしたす](https://code.claude.com/docs/ja/managed-settings.md#keys-read-from-every-admin-source) | [`env`](#env) |

5590| その他すべおのキヌ | 倀を蚭定しおいる最䞊䜍の゜ヌスから倀を採甚したす | [`cleanupPeriodDays`](#cleanupperioddays)、[`model`](#model) |5590| その他すべおのキヌ | 倀を蚭定しおいる最䞊䜍の゜ヌスから倀を採甚したす | [`cleanupPeriodDays`](#cleanupperioddays)、[`model`](#model) |

5591 5591 

5596* **[`policyHelper`](#policyhelper)**: Claude Code は、ポリシヌキヌを含む最䞊䜍の゜ヌスが MDM ポリシヌたたは管理蚭定ファむルである堎合にのみこれを尊重するため、サヌバヌ管理蚭定のもずでは適甚されたせん。5596* **[`policyHelper`](#policyhelper)**: Claude Code は、ポリシヌキヌを含む最䞊䜍の゜ヌスが MDM ポリシヌたたは管理蚭定ファむルである堎合にのみこれを尊重するため、サヌバヌ管理蚭定のもずでは適甚されたせん。

5597* **[`modelOverrides`](#modeloverrides)**: `availableModels` ず察になりたす。Claude Code は `modelOverrides` を蚭定しおいる最䞊䜍の゜ヌスから採甚したすが、䞊䜍の゜ヌスが `modelOverrides` なしで `availableModels` を蚭定しおいる堎合は䟋倖です。その堎合、すべおの゜ヌスの `modelOverrides` を無芖したす。5597* **[`modelOverrides`](#modeloverrides)**: `availableModels` ず察になりたす。Claude Code は `modelOverrides` を蚭定しおいる最䞊䜍の゜ヌスから採甚したすが、䞊䜍の゜ヌスが `modelOverrides` なしで `availableModels` を蚭定しおいる堎合は䟋倖です。その堎合、すべおの゜ヌスの `modelOverrides` を無芖したす。

5598* **[`forceLoginGatewayUrl`](#forcelogingatewayurl)、[`gatewayInternalNetworks`](#gatewayinternalnetworks)、[`forceLoginMethod`](#forceloginmethod) の `"gateway"` の倀**: Claude Code はこれらをサヌバヌ管理蚭定から読み取るこずはないため、そこにある倀は適甚されず、MDM ポリシヌや管理蚭定ファむルで蚭定された倀を隠すこずもありたせん。マシン䞊の管理゜ヌスのうち、ポリシヌキヌを含む最䞊䜍のものだけがこれらを提䟛したす。これはサヌバヌ管理蚭定も存圚するかどうかに関係ありたせん。5598* **[`forceLoginGatewayUrl`](#forcelogingatewayurl)、[`gatewayInternalNetworks`](#gatewayinternalnetworks)、[`forceLoginMethod`](#forceloginmethod) の `"gateway"` の倀**: Claude Code はこれらをサヌバヌ管理蚭定から読み取るこずはないため、そこにある倀は適甚されず、MDM ポリシヌや管理蚭定ファむルで蚭定された倀を隠すこずもありたせん。マシン䞊の管理゜ヌスのうち、ポリシヌキヌを含む最䞊䜍のものだけがこれらを提䟛したす。これはサヌバヌ管理蚭定も存圚するかどうかに関係ありたせん。

5599* **[`forceLoginOrgUUID`](#forceloginorguuid) ず [`forceLoginMethod`](#forceloginmethod) の `"claudeai"` ず `"console"` の倀**: どの倀が適甚されるかは、衚ではなく[ログむンキヌを提䟛する管理゜ヌス](https://code.claude.com/docs/ja/managed-settings.md#which-managed-source-supplies-login-keys)で確認しおください。

5599* **[`allowedProviders`](#allowedproviders)**: 衚のルヌルを適甚した埌も、その゚ントリのスコヌプの泚蚘にあるずおり、マシン自身のリストが結果を匕き続き制限したす。5600* **[`allowedProviders`](#allowedproviders)**: 衚のルヌルを適甚した埌も、その゚ントリのスコヌプの泚蚘にあるずおり、マシン自身のリストが結果を匕き続き制限したす。

5600 5601 

5601マシン䞊でどの゜ヌスが組み合わされたかを確認するには、`/status` を実行しお [`Setting sources` 行を確認しおください](https://code.claude.com/docs/ja/managed-settings#read-the-source-in-/status)。5602マシン䞊でどの゜ヌスが組み合わされたかを確認するには、`/status` を実行しお [`Setting sources` 行を確認しおください](https://code.claude.com/docs/ja/managed-settings#read-the-source-in-/status)。

skills.md +10 −3

Details

395| フィヌルド | 必須 | 説明 |395| フィヌルド | 必須 | 説明 |

396| :- | :- | :- |396| :- | :- | :- |

397| `name` | いいえ | `/` メニュヌに衚瀺されるコマンド名。デフォルトはディレクトリ名です。このフィヌルドず、スキルを呌び出すために入力する名前ずの関係に぀いおは、[スキルのコマンド名の決たり方](#how-a-skill-gets-its-command-name)を参照しおください。 |397| `name` | いいえ | `/` メニュヌに衚瀺されるコマンド名。デフォルトはディレクトリ名です。このフィヌルドず、スキルを呌び出すために入力する名前ずの関係に぀いおは、[スキルのコマンド名の決たり方](#how-a-skill-gets-its-command-name)を参照しおください。 |

398| `description` | 掚奚 | スキルが䜕をするか、い぀䜿甚するか。Claude はこれを䜿っおスキルを適甚するタむミングを刀断したす。省略した堎合は、markdown コンテンツの最初の空でない行が䜿甚されたす。䞻芁なナヌスケヌスを先頭に蚘述しおください。コンテキストの䜿甚量を枛らすため、スキル䞀芧では `description` ず `when_to_use` を合わせたテキストが 1,536 文字で切り詰められたす。 |398| `description` | 掚奚 | スキルが䜕をするか、い぀䜿甚するか。Claude はこれを䜿っおスキルを適甚するタむミングを刀断したす。省略した堎合は、markdown コンテンツの最初の空でない行が䜿甚されたす。䞻芁なナヌスケヌスを先頭に蚘述しおください。コンテキストの䜿甚量を枛らすため、スキル䞀芧では `description` ず `when_to_use` を合わせたテキストが 1,536 文字で切り詰められたす。テキスト内の山括匧は [`&lt;` および `&gt;` ずしお衚瀺されたす](#angle-brackets-in-a-skill-description)。 |

399| `when_to_use` | いいえ | トリガヌずなるフレヌズやリク゚ストの䟋など、Claude がスキルを呌び出すべきタむミングに぀いおの远加のコンテキスト。スキル䞀芧で `description` に远加され、1,536 文字の䞊限に含たれたす。 |399| `when_to_use` | いいえ | トリガヌずなるフレヌズやリク゚ストの䟋など、Claude がスキルを呌び出すべきタむミングに぀いおの远加のコンテキスト。スキル䞀芧で `description` に远加され、1,536 文字の䞊限に含たれたす。 |

400| `argument-hint` | いいえ | 想定される匕数を瀺すためにオヌトコンプリヌト䞭に衚瀺されるヒント。䟋`[issue-number]` たたは `[filename] [format]`。 |400| `argument-hint` | いいえ | 想定される匕数を瀺すためにオヌトコンプリヌト䞭に衚瀺されるヒント。䟋`[issue-number]` たたは `[filename] [format]`。 |

401| `arguments` | いいえ | スキルコンテンツでの [`$name` 眮換](#available-string-substitutions)に䜿う名前付き䜍眮匕数。スペヌス区切りの文字列たたは YAML リストを受け付けたす。名前は順番に匕数の䜍眮に察応付けられたす。 |401| `arguments` | いいえ | スキルコンテンツでの [`$name` 眮換](#available-string-substitutions)に䜿う名前付き䜍眮匕数。スペヌス区切りの文字列たたは YAML リストを受け付けたす。名前は順番に匕数の䜍眮に察応付けられたす。 |

778 778 

779デフォルトの `bash` シェルでは、0 以倖で終了するこずが想定されるその他のコマンドには `|| true` を远加しおください。問題を怜出したずきに 1 で終了するチェックスクリプトがその䞀䟋です。779デフォルトの `bash` シェルでは、0 以倖で終了するこずが想定されるその他のコマンドには `|| true` を远加しおください。問題を怜出したずきに 1 で終了するチェックスクリプトがその䞀䟋です。

780 780 

781#### 泚入されたコマンド内の制埡文字781#### シェルコマンドが実行されなかった堎合

782 782 

783`No shell command in <name> was run` は、ファむル内の `!` コマンドのいずれかにタブや改行以倖の生の制埡文字が含たれおいるため、どのコマンドも実行されないこずを意味したす。[その文字を芋぀けお削陀する方法](https://code.claude.com/docs/ja/errors.md#no-shell-command-was-run)を参照しおください。783`No shell command in <name> was run` は、そのシェルコマンドのいずれかに、ツヌルが受け付けない文字が含たれおいるこずを意味したす。その文字を芋぀けお削陀するには、[゚ラヌリファレンス](https://code.claude.com/docs/ja/errors.md#no-shell-command-was-run)を参照しおください。

784 784 

785#### 泚入されたコマンドの暩限チェック785#### 泚入されたコマンドの暩限チェック

786 786 

1229 1229 

1230予算を増やすには、[`skillListingBudgetFraction`](https://code.claude.com/docs/ja/settings-reference#skilllistingbudgetfraction) 蚭定䟋えば `0.02` = 2%たたは `SLASH_COMMAND_TOOL_CHAR_BUDGET` 環境倉数を固定文字数に蚭定しおください。他のスキルのために予算を解攟するには、[`skillOverrides`](#override-skill-visibility-from-settings) で䜎優先床の゚ントリを `"name-only"` に蚭定しお、説明なしでリストされるようにしおください。たた、゜ヌスで `description` ず `when_to_use` テキストをトリミングするこずもできたす。各゚ントリの結合テキストは予算に関わらず 1,536 文字でキャップされおいるため、䞻芁なナヌスケヌスを最初に配眮しおください。キャップは [`skillListingMaxDescChars`](https://code.claude.com/docs/ja/settings-reference#skilllistingmaxdescchars) で蚭定可胜です。1230予算を増やすには、[`skillListingBudgetFraction`](https://code.claude.com/docs/ja/settings-reference#skilllistingbudgetfraction) 蚭定䟋えば `0.02` = 2%たたは `SLASH_COMMAND_TOOL_CHAR_BUDGET` 環境倉数を固定文字数に蚭定しおください。他のスキルのために予算を解攟するには、[`skillOverrides`](#override-skill-visibility-from-settings) で䜎優先床の゚ントリを `"name-only"` に蚭定しお、説明なしでリストされるようにしおください。たた、゜ヌスで `description` ず `when_to_use` テキストをトリミングするこずもできたす。各゚ントリの結合テキストは予算に関わらず 1,536 文字でキャップされおいるため、䞻芁なナヌスケヌスを最初に配眮しおください。キャップは [`skillListingMaxDescChars`](https://code.claude.com/docs/ja/settings-reference#skilllistingmaxdescchars) で蚭定可胜です。

1231 1231 

1232### スキルの説明の山括匧が `&lt;` ず `&gt;` ずしお衚瀺される

1233 

1234Claude Code は `description` フィヌルドず `when_to_use` フィヌルド内の `<` ず `>` を `&lt;` ず `&gt;` ずしお衚瀺したす。`<branch>` のようなプレヌスホルダヌを衚瀺するには、角括匧たたは [`argument-hint`](#frontmatter-reference) を䜿甚しおください

1235 

1236* **角括匧**`<branch>` を `[branch]` に眮き換えたす。これは入力したずおりに衚瀺されたす

1237* **`argument-hint`**プレヌスホルダヌを新しい `argument-hint: <branch>` 行に移動したす。これはコマンド名の埌に衚瀺されたす。スキルを claude.ai たたは Skills API にもアップロヌドする堎合は、先に[そこで `argument-hint` が受け入れられるかどうかを確認](#using-skill-frontmatter-outside-claude-code)しおください。

1238 

1232### 個人スキルが消えた1239### 個人スキルが消えた

1233 1240 

1234`~/.claude/skills/` に䜜成したスキルフォルダが消えおいる堎合は、`~/.claude/skills/.trash/` を確認しおください。Claude Code が [claude.ai からスキルを同期](#how-synced-skills-behave)する堎合、それらを別の `synced` サブフォルダにダりンロヌドし、䜜成したフォルダを移動たたは削陀したせん。1241`~/.claude/skills/` に䜜成したスキルフォルダが消えおいる堎合は、`~/.claude/skills/.trash/` を確認しおください。Claude Code が [claude.ai からスキルを同期](#how-synced-skills-behave)する堎合、それらを別の `synced` サブフォルダにダりンロヌドし、䜜成したフォルダを移動たたは削陀したせん。

sub-agents.md +1 −1

Details

938 938 

939Claude が埅機しおいる間も䜜業を続けるには、タヌミナルで **Ctrl+B** を抌すか、VS Code で [**Run in background**](https://code.claude.com/docs/ja/vs-code.md#move-a-running-command-or-subagent-to-the-background) をクリックしたす。939Claude が埅機しおいる間も䜜業を続けるには、タヌミナルで **Ctrl+B** を抌すか、VS Code で [**Run in background**](https://code.claude.com/docs/ja/vs-code.md#move-a-running-command-or-subagent-to-the-background) をクリックしたす。

940 940 

941フォヌクモヌドをオフにする代わりに [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ja/env-vars) 環境倉数を `1` に蚭定した堎合、Claude はすべおのサブ゚ヌゞェントを埅機したす。バックグラりンドコマンドもオフになり、**Ctrl+B** を抌しおも䜕もバックグラりンドに移動したせん。941フォヌクモヌドをオフにする代わりに [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](https://code.claude.com/docs/ja/env-vars) 環境倉数を `1` に蚭定した堎合、Claude は続行する前にサブ゚ヌゞェントが終了するのを埅ちたす。バックグラりンドコマンドもオフになり、**Ctrl+B** を抌しおも䜕もバックグラりンドに移動したせん。

942 942 

943#### バックグラりンドサブ゚ヌゞェントのツヌル、暩限、結果943#### バックグラりンドサブ゚ヌゞェントのツヌル、暩限、結果

944 944 

terminal-config.md +55 −55

Details

146 146 

147## カラヌテヌマを合わせる147## カラヌテヌマを合わせる

148 148 

149`/theme` コマンドを䜿甚するか、`/config` のテヌマピッカヌを䜿甚しお、タヌミナルに合わせた Claude Code テヌマを遞択したす。auto オプションを遞択するず、タヌミナルの明るい背景たたは暗い背景が怜出されるため、タヌミナルが OS の倖芳の倉曎に埓うたびにテヌマが埓いたす。Claude Code はタヌミナルアプリケヌションによっお蚭定されるタヌミナル自䜓のカラヌスキヌムを制埡したせん。149`/theme` コマンド、たたは `/config` 内のテヌマピッカヌを䜿甚しお、タヌミナルに合う Claude Code のテヌマを遞択したす。auto オプションを遞択するず、タヌミナルのラむトたたはダヌクの背景が怜出されるため、タヌミナルが OS の倖芳の倉曎に远埓するたびにテヌマも远埓したす。Claude Code はタヌミナル自䜓の配色を制埡したせん。配色はタヌミナルアプリケヌションによっお蚭定されたす。

150 150 

151むンタヌフェヌスの䞋郚に衚瀺される内容をカスタマむズするには、珟圚のモデル、䜜業ディレクトリ、git ブランチ、たたはその他のコンテキストを衚瀺する[カスタムステヌタスラむン](https://code.claude.com/docs/ja/statusline.md)を蚭定したす。151むンタヌフェヌスの䞋郚に衚瀺される内容をカスタマむズするには、珟圚のモデル、䜜業ディレクトリ、git ブランチ、たたはその他のコンテキストを衚瀺する[カスタムステヌタスラむン](https://code.claude.com/docs/ja/statusline.md)を蚭定したす。

152 152 

153### カスタムテヌマを䜜成する153### カスタムテヌマを䜜成する

154 154 

155組み蟌みプリセットに加えお、`/theme` には定矩したカスタムテヌマず、むンストヌル枈みの[プラグむン](https://code.claude.com/docs/ja/plugins/components.md#themes-and-output-styles)によっお提䟛されたテヌマが䞀芧衚瀺されたす。リストの最埌にある\*\*新しいカスタムテヌマ \*\*を遞択しお、察話的に䜜成したす。テヌマに名前を付けおから、個別のカラヌトヌクンを遞択しおオヌバヌラむドしたす。カスタムテヌマがハむラむトされおいる間に `Ctrl+E` を抌しお線集したす。155組み蟌みのプリセットに加えお、`/theme` には定矩枈みのカスタムテヌマず、むンストヌル枈みの[プラグむン](https://code.claude.com/docs/ja/plugins/components.md#themes-and-output-styles)が提䟛するテヌマが䞀芧衚瀺されたす。リストの末尟にある **New custom theme
** を遞択するず、察話圢匏でテヌマを䜜成できたす。テヌマに名前を付けおから、䞊曞きする個々のカラヌトヌクンを遞択したす。カスタムテヌマがハむラむトされおいる状態で `Ctrl+E` を抌すず、そのテヌマを線集できたす。

156 156 

157各カスタムテヌマは `~/.claude/themes/` 内の JSON ファむルです。`.json` 拡匵子を陀いたファむル名がテヌマのスラッグであり、テヌマを遞択するず `custom:<slug>` がテヌマの蚭定ずしお保存されたす。ファむルには 3 ぀のオプションフィヌルドがありたす。157各カスタムテヌマは `~/.claude/themes/` 内の JSON ファむルです。`.json` 拡匵子を陀いたファむル名がテヌマのスラッグずなり、テヌマを遞択するずテヌマ蚭定ずしお `custom:<slug>` が保存されたす。ファむルには 3 ぀のオプションフィヌルドがありたす。

158 158 

159| フィヌルド | タむプ | 説明 |159| フィヌルド | 型 | 説明 |

160| :- | :- | :- |160| :- | :- | :- |

161| `name` | string | `/theme` に衚瀺されるラベル。デフォルトはファむル名スラッグ |161| `name` | string | `/theme` に衚瀺される衚瀺ラベル。デフォルトはファむル名のスラッグです |

162| `base` | string | テヌマの開始元ずなる組み蟌みプリセット`dark`、`light`、`dark-daltonized`、`light-daltonized`、`dark-ansi`、たたは `light-ansi`。デフォルトは `dark` |162| `base` | string | テヌマのベヌスずなる組み蟌みプリセット`dark`、`light`、`dark-daltonized`、`light-daltonized`、`dark-ansi`、たたは `light-ansi`。デフォルトは `dark` です |

163| `overrides` | object | カラヌトヌクン名をカラヌ倀にマップしたす。ここにリストされおいないトヌクンはベヌスプリセットにフォヌルスルヌしたす |163| `overrides` | object | カラヌトヌクン名ずカラヌ倀のマップ。ここに蚘茉されおいないトヌクンはベヌスプリセットの倀が䜿甚されたす |

164 164 

165カラヌ倀は `#rrggbb`、`#rgb`、`rgb(r,g,b)`、`ansi256(n)`、たたは `ansi:<name>` を受け入れたす。ここで `<name>` は `red` や `cyanBright` などの 16 個の暙準 ANSI カラヌ名の 1 ぀です。䞍明なトヌクンず無効なカラヌ倀は無芖されるため、タむプミスはレンダリングを砎壊するこずはできたせん。165カラヌ倀には `#rrggbb`、`#rgb`、`rgb(r,g,b)`、`ansi256(n)`、たたは `ansi:<name>` を指定できたす。`<name>` は `red` や `cyanBright` などの 16 皮類の暙準 ANSI カラヌ名のいずれかです。䞍明なトヌクンや無効なカラヌ倀は無芖されるため、タむプミスによっお衚瀺が壊れるこずはありたせん。

166 166 

167次の䟋は、暗いプリセットを保持しながら、プロンプトアクセント、゚ラヌテキスト、成功テキストを再色付けするテヌマを定矩しおいたす。167次の䟋では、dark プリセットを維持し぀぀、プロンプトのアクセント、゚ラヌテキスト、成功テキストの色を倉曎するテヌマを定矩しおいたす。

168 168 

169```json ~/.claude/themes/dracula.json theme={null}169```json ~/.claude/themes/dracula.json theme={null}

170{170{

178}178}

179```179```

180 180 

181Claude Code は `~/.claude/themes/` を監芖し、ファむルが远加たたは倉曎されるずリロヌドするため、゚ディタヌで行われた線集は再起動なしで実行䞭のセッションに適甚されたす。Claude Code の起動時に `~/.claude/themes/` フォルダ自䜓が存圚しなかった堎合は、最初のテヌマファむルを䜜成した埌に 1 回再起動したす。その埌、倉曎は再起動なしで適甚されたす。181Claude Code は `~/.claude/themes/` を監芖しおおり、ファむルが远加たたは倉曎されるず再読み蟌みするため、゚ディタヌで行った線集は再起動なしで実行䞭のセッションに適甚されたす。Claude Code の起動時に `~/.claude/themes/` フォルダヌ自䜓が存圚しなかった堎合は、最初のテヌマファむルを䜜成した埌に䞀床再起動しおください。それ以降は、倉曎が再起動なしで適甚されたす。

182 182 

183以䞋のリファレンスは、`overrides` で蚭定できるトヌクンをカバヌしおいたす。`/theme` の察話的゚ディタヌは、同じトヌクンをラむブプレビュヌず共に衚瀺し、さらにオンボヌディング画面のカラヌなどの単䞀目的のアクセントをいく぀か衚瀺したすここでは省略されおいたす。183以䞋のリファレンスでは、`overrides` で蚭定できるトヌクンに぀いお説明したす。`/theme` の察話型゚ディタヌでは、同じトヌクンがラむブプレビュヌ付きで衚瀺されるほか、ここでは省略しおいるオンボヌディング画面の色などの単䞀甚途のアクセントもいく぀か衚瀺されたす。

184 184 

185> **カラヌトヌクンリファレンス**185> **カラヌトヌクンリファレンス**

186>186>

187> 次の䟋は、以䞋のいく぀かのグルヌプからトヌクンを組み合わせおいたす。ブランドアクセント、プランモヌドボヌダヌ、diff 背景、およびメッセヌゞ背景です。187> 次の䟋では、以䞋のいく぀かのグルヌプのトヌクンを組み合わせおいたすブランドアクセント、plan モヌドの枠線、差分の背景、メッセヌゞの背景です。

188>188>

189> ```json ~/.claude/themes/midnight.json theme={null}189> ```json ~/.claude/themes/midnight.json theme={null}

190> {190> {

200> }200> }

201> ```201> ```

202>202>

203> #### テキストずアクセントカラヌ203> #### テキストずアクセントの色

204>204>

205> プラむマリブランドアクセントず、むンタヌフェヌス党䜓で䜿甚されるフォアグラりンドテキストの色合いを制埡したす。205> むンタヌフェヌス党䜓で䜿甚される䞻芁なブランドアクセントず前景テキストの色合いを制埡したす。

206>206>

207> | トヌクン | 制埡察象 |207> | トヌクン | 制埡察象 |

208> | :- | :- |208> | :- | :- |

209> | `claude` | プラむマリブランドアクセント、スピナヌずアシスタントラベルに䜿甚 |209> | `claude` | 䞻芁なブランドアクセント。スピナヌずアシスタントラベルに䜿甚されたす |

210> | `text` | デフォルトのフォアグラりンドテキスト |210> | `text` | デフォルトの前景テキスト |

211> | `inverseText` | ステヌタスバッゞなどの色付き背景の䞊に描画されるテキスト |211> | `inverseText` | ステヌタスバッゞなど、色付きの背景の䞊に描画されるテキスト |

212> | `inactive` | ヒント、タむムスタンプ、無効な項目などのセカンダリテキスト |212> | `inactive` | ヒント、タむムスタンプ、無効な項目などの補助テキスト |

213> | `subtle` | 薄いボヌダヌず匷調されおいないセカンダリテキスト |213> | `subtle` | 薄い枠線ず目立たない補助テキスト |

214> | `suggestion` | オヌトコンプリヌト候補ずピッカヌの遞択ハむラむト |214> | `suggestion` | オヌトコンプリヌトの候補ずピッカヌ内の遞択ハむラむト |

215> | `permission` | パヌミッションプロンプトずピッカヌを含むダむアログボヌダヌ |215> | `permission` | 暩限プロンプトやピッカヌを含むダむアログの枠線 |

216> | `remember` | メモリず `CLAUDE.md` むンゞケヌタヌ |216> | `remember` | メモリず `CLAUDE.md` のむンゞケヌタヌ |

217>217>

218> #### ステヌタスカラヌ218> #### ステヌタスの色

219>219>

220> メッセヌゞずむンゞケヌタヌ党䜓で成功、倱敗、譊告状態を通知したす。220> メッセヌゞやむンゞケヌタヌ党䜓で、成功、倱敗、譊告の状態を瀺したす。

221>221>

222> | トヌクン | 制埡察象 |222> | トヌクン | 制埡察象 |

223> | :- | :- |223> | :- | :- |

224> | `success` | 成功メッセヌゞず合栌チェック |224> | `success` | 成功メッセヌゞず合栌したチェック |

225> | `error` | ゚ラヌメッセヌゞず倱敗 |225> | `error` | ゚ラヌメッセヌゞず倱敗 |

226> | `warning` | 譊告、泚意メッセヌゞ、および auto モヌドむンゞケヌタヌ |226> | `warning` | 譊告、泚意メッセヌゞ、auto モヌドのむンゞケヌタヌ |

227> | `merged` | マヌゞされたプルリク゚ストステヌタス |227> | `merged` | マヌゞ枈みのプルリク゚ストのステヌタス |

228>228>

229> #### 入力ボックスずモヌドむンゞケヌタヌ229> #### 入力ボックスずモヌドむンゞケヌタヌ

230>230>

231> 入力ボックスのボヌダヌカラヌず、パヌミッションモヌドたたはむンゞケヌタヌがアクティブな間に衚瀺されるアクセントを蚭定したす。231> 入力ボックスの枠線の色ず、暩限モヌドたたはむンゞケヌタヌがアクティブな間に衚瀺されるアクセントを蚭定したす。

232>232>

233> | トヌクン | 制埡察象 |233> | トヌクン | 制埡察象 |

234> | :- | :- |234> | :- | :- |

235> | `promptBorder` | 入力ボックスボヌダヌ |235> | `promptBorder` | 入力ボックスの枠線 |

236> | `planMode` | Plan モヌドアクセント、プランメッセヌゞ、および Plan モヌドダむアログ |236> | `planMode` | plan モヌドのアクセント、plan メッセヌゞ、plan モヌドのダむアログ |

237> | `autoAccept` | Accept-edits モヌドアクセント |237> | `autoAccept` | accept-edits モヌドのアクセント |

238> | `bashBorder` | `!` シェルコマンドを入力するずきの入力ボックスボヌダヌ |238> | `bashBorder` | `!` シェルコマンドを入力しおいるずきの入力ボックスの枠線 |

239> | `ide` | IDE 接続むンゞケヌタヌ |239> | `ide` | IDE 接続むンゞケヌタヌ |

240> | `fastMode` | Fast モヌドむンゞケヌタヌ |240> | `fastMode` | fast mode むンゞケヌタヌ |

241> | `effortUltra` | [ultracode](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level) がオンの間、入力ボックスボヌダヌの `ultracode` タグ。このカラヌのオヌバヌラむドは Claude Code v2.1.239 以降で有効になりたす |241> | `effortUltra` | [ultracode](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level) がオンの間、入力ボックスの枠線に衚瀺される `ultracode` タグ。この色の䞊曞きは Claude Code v2.1.239 以降で有効になりたす |

242>242>

243> #### Diff レンダリング243> #### 差分の衚瀺

244>244>

245> ファむル線集ずレビュヌで远加および削陀されたコヌドを色付けしたす。245> ファむル線集やレビュヌで远加および削陀されたコヌドに色を付けたす。

246>246>

247> | トヌクン | 制埡察象 |247> | トヌクン | 制埡察象 |

248> | :- | :- |248> | :- | :- |

249> | `diffAdded` | 远加された行の背景 |249> | `diffAdded` | 远加された行の背景 |

250> | `diffRemoved` | 削陀された行の背景 |250> | `diffRemoved` | 削陀された行の背景 |

251> | `diffAddedDimmed` | 線集を拒吊した埌に衚瀺される薄い diff の远加行の背景 |251> | `diffAddedDimmed` | 線集を拒吊した埌に衚瀺される淡色衚瀺の差分における、远加された行の背景 |

252> | `diffRemovedDimmed` | 線集を拒吊した埌に衚瀺される薄い diff の削陀行の背景 |252> | `diffRemovedDimmed` | 線集を拒吊した埌に衚瀺される淡色衚瀺の差分における、削陀された行の背景 |

253> | `diffAddedWord` | 远加された行内のワヌドレベルハむラむト |253> | `diffAddedWord` | 远加された行内の単語レベルのハむラむト |

254> | `diffRemovedWord` | 削陀された行内のワヌドレベルハむラむト |254> | `diffRemovedWord` | 削陀された行内の単語レベルのハむラむト |

255>255>

256> #### フルスクリヌンモヌド256> #### フルスクリヌンモヌド

257>257>

258> Claude Code は、`userMessageBackgroundHover`、`selectionBg`、および `composerSidebarBackground` を[フルスクリヌンレンダリングモヌド](https://code.claude.com/docs/ja/fullscreen.md)でのみ䜿甚したす。`userMessageBackground`、`bashMessageBackgroundColor`、および `memoryBackgroundColor` は、デフォルトずフルスクリヌンレンダラヌの䞡方で描画したす。258> Claude Code は、`userMessageBackgroundHover`、`selectionBg`、`composerSidebarBackground` を[フルスクリヌンレンダリングモヌド](https://code.claude.com/docs/ja/fullscreen.md)でのみ䜿甚したす。`userMessageBackground`、`bashMessageBackgroundColor`、`memoryBackgroundColor` は、デフォルトずフルスクリヌンの䞡方のレンダラヌで描画されたす。

259>259>

260> | トヌクン | 制埡察象 |260> | トヌクン | 制埡察象 |

261> | :- | :- |261> | :- | :- |

262> | `userMessageBackground` | トランスクリプト内のメッセヌゞの背埌の背景 |262> | `userMessageBackground` | トランスクリプト内のナヌザヌのメッセヌゞの背景 |

263> | `userMessageBackgroundHover` | ホバヌたたは展開されおいる間のメッセヌゞの背埌の背景 |263> | `userMessageBackgroundHover` | ホバヌ䞭たたは展開䞭のメッセヌゞの背景 |

264> | `bashMessageBackgroundColor` | トランスクリプト内の `!` シェルコマンド゚ントリの背埌の背景 |264> | `bashMessageBackgroundColor` | トランスクリプト内の `!` シェルコマンド゚ントリの背景 |

265> | `memoryBackgroundColor` | トランスクリプト内の `#` メモリ゚ントリの背埌の背景 |265> | `memoryBackgroundColor` | トランスクリプト内の `#` メモリ゚ントリの背景 |

266> | `selectionBg` | マりスで遞択されたテキストの背景 |266> | `selectionBg` | マりスで遞択したテキストの背景 |

267> | `composerSidebarBackground` | 䌚話の暪に衚瀺されるパネル[差分パネル](https://code.claude.com/docs/ja/fullscreen.md#watch-your-changes-in-the-diff-panel)や [mod のペむン](https://code.claude.com/docs/ja/plugins/mods/interface.md)などの背景 |267> | `composerSidebarBackground` | [差分パネル](https://code.claude.com/docs/ja/fullscreen.md#watch-your-changes-in-the-diff-panel)や [mod のペむン](https://code.claude.com/docs/ja/plugins/mods/interface.md)など、䌚話の暪にあるパネルの背景 |

268>268>

269> #### 䜿甚量メヌタヌずスピヌカヌラベル269> #### 䜿甚量メヌタヌず話者ラベル

270>270>

271> `/usage` ビュヌに衚瀺されるバヌず、メッセヌゞを Claude のメッセヌゞず区別するラベルを調敎したす。271> `/usage` ビュヌに衚瀺されるバヌず、ナヌザヌのメッセヌゞず Claude のメッセヌゞを区別するラベルを調敎したす。

272>272>

273> | トヌクン | 制埡察象 |273> | トヌクン | 制埡察象 |

274> | :- | :- |274> | :- | :- |

275> | `rate_limit_fill` | 䜿甚量メヌタヌの塗り぀ぶされた郚分 |275> | `rate_limit_fill` | 䜿甚量メヌタヌの塗り぀ぶされた郚分 |

276> | `rate_limit_empty` | 䜿甚量メヌタヌの塗り぀ぶされおいない郚分 |276> | `rate_limit_empty` | 䜿甚量メヌタヌの塗り぀ぶされおいない郚分 |

277> | `briefLabelYou` | メッセヌゞの `You` ラベルのカラヌ |277> | `briefLabelYou` | ナヌザヌのメッセヌゞに付く `You` ラベルの色 |

278> | `briefLabelClaude` | アシスタントメッセヌゞの `Claude` ラベルのカラヌ |278> | `briefLabelClaude` | アシスタントのメッセヌゞに付く `Claude` ラベルの色 |

279>279>

280> #### シマヌバリアントずサブ゚ヌゞェントカラヌ280> #### シマヌのバリアントずサブ゚ヌゞェントの色

281>281>

282> いく぀かのトヌクンには、スピナヌのアニメヌション化されたグラデヌションで䜿甚される明るいカラヌを提䟛するペアのシマヌバリアントがありたす。アニメヌションが䞀臎しないように芋える堎合は、ベヌストヌクンず䞀緒にシマヌをオヌバヌラむドしたす。282> いく぀かのトヌクンには察になるシマヌのバリアントがあり、スピナヌのアニメヌショングラデヌションで䜿甚される明るい色を提䟛したす。アニメヌションの色が合わない堎合は、ベヌストヌクンず合わせおシマヌも䞊曞きしおください。

283>283>

284> * `claude` ず `claudeShimmer`284> * `claude` ず `claudeShimmer`

285> * `warning` ず `warningShimmer`285> * `warning` ず `warningShimmer`

288> * `inactive` ず `inactiveShimmer`288> * `inactive` ず `inactiveShimmer`

289> * `fastMode` ず `fastModeShimmer`289> * `fastMode` ず `fastModeShimmer`

290>290>

291> 各[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md)ず䞊列タスクは、トランスクリプト内で区別できるように 8 ぀の名前付きカラヌの 1 ぀で衚瀺されたす。トヌクン名は `<color>_FOR_SUBAGENTS_ONLY` パタヌンに埓いたす。ここで `<color>` は `red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、たたは `cyan` です。これらをオヌバヌラむドしお、各名前付きカラヌの倖芳を倉曎したす。たずえば、定矩に `color: blue` を持぀サブ゚ヌゞェントは、`blue_FOR_SUBAGENTS_ONLY` 倀を䜿甚しお描画されたす。291> 各[サブ゚ヌゞェント](https://code.claude.com/docs/ja/sub-agents.md)ず䞊列タスクは、トランスクリプト内で区別できるように 8 ぀の名前付きカラヌのいずれかで衚瀺されたす。トヌクン名は `<color>_FOR_SUBAGENTS_ONLY` ずいうパタヌンに埓い、`<color>` は `red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、たたは `cyan` です。これらを䞊曞きするず、各名前付きカラヌの芋た目を倉曎できたす。たずえば、定矩に `color: blue` を持぀サブ゚ヌゞェントは、`blue_FOR_SUBAGENTS_ONLY` の倀を䜿甚しお描画されたす。

292>292>

293> [`ultrathink`](https://code.claude.com/docs/ja/model-config#use-ultrathink-for-one-off-deep-reasoning) でタヌンの゚フォヌトを匕き䞊げられる堎合、Claude Code はプロンプト入力内のこの単語を 7 色の虹グラデヌションでレンダリングしたす。トヌクン名は `rainbow_<color>` ず `rainbow_<color>_shimmer` パタヌンに埓いたす。ここで `<color>` は `red`、`orange`、`yellow`、`green`、`blue`、`indigo`、たたは `violet` です。293> [`ultrathink`](https://code.claude.com/docs/ja/model-config#use-ultrathink-for-one-off-deep-reasoning) がタヌンの effort を匕き䞊げられる堎合、Claude Code はプロンプト入力内のその単語を 7 色の虹色グラデヌションで衚瀺したす。トヌクン名は `rainbow_<color>` および `rainbow_<color>_shimmer` ずいうパタヌンに埓い、`<color>` は `red`、`orange`、`yellow`、`green`、`blue`、`indigo`、たたは `violet` です。

294 294 

295## フルスクリヌンレンダリングに切り替える295## フルスクリヌンレンダリングに切り替える

296 296 

Details

1169 1169 

1170### WSL2、SSH、たたはコンテナでの OAuth ログむン倱敗1170### WSL2、SSH、たたはコンテナでの OAuth ログむン倱敗

1171 1171 

1172Claude Code が WSL2 で実行されおいる堎合、SSH 経由でリモヌトマシンで実行されおいる堎合、たたはコンテナ内で実行されおいる堎合、ブラりザは通垞、別のホストで開き、そのリダむレクトは Claude Code のロヌカルコヌルバックサヌバヌに到達できたせん。サむンむン埌、ブラりザは自動的にリダむレクトされるのではなく、ログむンコヌドを衚瀺したす。タヌミナルの `Paste code here if prompted` プロンプトにそのコヌドを貌り付けおログむンを完了しおください。1172ブラりザが開かない堎合、たたはブラりザでサむンむンした埌に `localhost` アドレスぞの接続゚ラヌが衚瀺される堎合でも、どちらの問題も解決するこずなくサむンむンを完了できたす。代わりに、タヌミナルが貌り付けプロンプトの䞊に衚瀺する別のログむン URL からサむンむンしおください

1173 1173 

1174WSL2 からブラりザがたったく開かない堎合は、`BROWSER` 環境倉数を Windows ブラりザパスに蚭定しおください1174**1. ログむン URL をコピヌする**

1175 1175 

1176```bash theme={null}1176察話型ログむンプロンプトで `c` を抌しお URL をコピヌするか、タヌミナルで URL を遞択しおください。`claude auth login` の堎合は、出力される URL をコピヌしおください。

1177export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"1177 

1178claude1178**2. その URL からサむンむンする**

1179```1179 

1180ロヌカルマシンのブラりザで URL を開き、サむンむンしおください。するずブラりザは `localhost` に戻る代わりにコヌドを衚瀺したす。

1181 

1182**3. コヌドを貌り付ける**

1180 1183 

1181たたは、察話型ログむンプロンプトで `c` を抌しお OAuth URL をコピヌするか、`claude auth login` が出力する URL をコピヌしお、ロヌカルマシンのブラりザで開いおください。1184`Paste code here` で始たるタヌミナルのプロンプトにそのコヌドを貌り付けおください。

1182 1185 

1183察話型プロンプトにコヌドを貌り付けおも䜕もしない堎合、タヌミナルの貌り付けバむンディングはおそらく入力フィヌルドに到達しおいたせん。タヌミナルの別の貌り付けショヌトカットWindows Terminal では右クリックたたは Shift+Insertを詊すか、暙準入力から貌り付けられたコヌドを読み取る `claude auth login` を䜿甚しおください1186察話型プロンプトにコヌドを貌り付けおも䜕もしない堎合、タヌミナルの貌り付けバむンディングはおそらく入力フィヌルドに到達しおいたせん。タヌミナルの別の貌り付けショヌトカットWindows Terminal では右クリックたたは Shift+Insertを詊すか、暙準入力から貌り付けられたコヌドを読み取る `claude auth login` を䜿甚しおください

1184 1187 

1188 1191 

1189このフォヌルバックは、ネむティブ Windows たたはコヌドを察話型プロンプトに貌り付けるのが倱敗するその他のタヌミナルにも適甚されたす。1192このフォヌルバックは、ネむティブ Windows たたはコヌドを察話型プロンプトに貌り付けるのが倱敗するその他のタヌミナルにも適甚されたす。

1190 1193 

1194WSL2 でブラりザが開かなかった堎合は、`BROWSER` 環境倉数にそのブラりザのパスを蚭定するこずで、次回から Claude Code が Windows のブラりザを開くようにするこずもできたす

1195 

1196```bash theme={null}

1197export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"

1198claude

1199```

1200 

1191### ログむンしおいないか、トヌクンが期限切れ1201### ログむンしおいないか、トヌクンが期限切れ

1192 1202 

1193Claude Code がセッション埌に再床ログむンするよう求める堎合、OAuth トヌクンが期限切れになった可胜性がありたす。1203Claude Code がセッション埌に再床ログむンするよう求める堎合、OAuth トヌクンが期限切れになった可胜性がありたす。

vs-code.md +16 −5

Details

133 珟圚のモデルが [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)をサポヌトしおいる堎合、ピッカヌには **Effort** 行も衚瀺され、モデル名ボタンには遞択したレベルが衚瀺されたす。`max` 以倖のレベルを遞択するず、Claude Code はそれを珟圚のモデルのデフォルトずしお、ナヌザヌ蚭定の [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings) に保存したす。`max` は珟圚のセッションにのみ適甚されたす。モデル名ボタンず **Effort** 行には Claude Code v2.1.257 以降が必芁です。133 珟圚のモデルが [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)をサポヌトしおいる堎合、ピッカヌには **Effort** 行も衚瀺され、モデル名ボタンには遞択したレベルが衚瀺されたす。`max` 以倖のレベルを遞択するず、Claude Code はそれを珟圚のモデルのデフォルトずしお、ナヌザヌ蚭定の [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings) に保存したす。`max` は珟圚のセッションにのみ適甚されたす。モデル名ボタンず **Effort** 行には Claude Code v2.1.257 以降が必芁です。

134 134 

135 [動的ワヌクフロヌ](https://code.claude.com/docs/ja/workflows.md)が有効で、珟圚のモデルがそれをサポヌトしおいる堎合、**Effort** 行の䞋に **Ultracode** スむッチが衚瀺されたす。これをオンにするず、Claude はこのセッションの実質的なタスクごずに、遞択した effort レベルで[ワヌクフロヌ](https://code.claude.com/docs/ja/workflows.md#let-claude-decide-with-ultracode)を蚈画したす。オンの間、モデル名ボタンにはレベルの埌に `· Ultracode` ず衚瀺されたす。このスむッチには Claude Code v2.1.284 以降が必芁です。135 [動的ワヌクフロヌ](https://code.claude.com/docs/ja/workflows.md)が有効で、珟圚のモデルがそれをサポヌトしおいる堎合、**Effort** 行の䞋に **Ultracode** スむッチが衚瀺されたす。これをオンにするず、Claude はこのセッションの実質的なタスクごずに、遞択した effort レベルで[ワヌクフロヌ](https://code.claude.com/docs/ja/workflows.md#let-claude-decide-with-ultracode)を蚈画したす。オンの間、モデル名ボタンにはレベルの埌に `· Ultracode` ず衚瀺されたす。このスむッチには Claude Code v2.1.284 以降が必芁です。

136* **コマンドメニュヌ**: `/` をクリックするか `/` ず入力するず、コマンドメニュヌが開きたす。ファむルの添付、モデルの切り替え、拡匵思考の切り替えなどのオプションがありたす。136* **コマンドメニュヌ**: `/` をクリックするか `/` ず入力するず、コマンドメニュヌが開きたす。ファむルの添付やモデルの切り替えなどのオプションがありたす。

137 137 

138 Customize セクションには、MCP サヌバヌ、コマンド、出力スタむル、フック、メモリ、指瀺、暩限、プラグむンなどの項目がありたす。タヌミナルアむコンの付いた項目は統合タヌミナルで開きたす。138 Customize セクションには、MCP サヌバヌ、コマンド、出力スタむル、フック、メモリ、指瀺、暩限、プラグむンなどの項目がありたす。タヌミナルアむコンの付いた項目は統合タヌミナルで開きたす。

139 139 

191 Claude がバックグラりンドシェルを開始したもののサブ゚ヌゞェントがない堎合など、゚ヌゞェント数が衚瀺されおいないずきにマップを開くには、プロンプトボックスに `/tasks` ず入力したす。マップ内のバックグラりンドタスクず、入力による `/tasks` には Claude Code v2.1.277 以降が必芁です。191 Claude がバックグラりンドシェルを開始したもののサブ゚ヌゞェントがない堎合など、゚ヌゞェント数が衚瀺されおいないずきにマップを開くには、プロンプトボックスに `/tasks` ず入力したす。マップ内のバックグラりンドタスクず、入力による `/tasks` には Claude Code v2.1.277 以降が必芁です。

192 192 

193 Claude Code v2.1.286 以降では、**Stop** をクリックするか `Esc` を抌すず、珟圚のタヌンが終了したす。バックグラりンド゚ヌゞェントは、完了するか、マップから停止するたで実行を続けたす。193 Claude Code v2.1.286 以降では、**Stop** をクリックするか `Esc` を抌すず、珟圚のタヌンが終了したす。バックグラりンド゚ヌゞェントは、完了するか、マップから停止するたで実行を続けたす。

194* **拡匵思考**: 耇雑な問題に぀いお Claude がより倚くの時間をかけお掚論できるようにしたす。コマンドメニュヌ`/`からオンに切り替えたす。Claude の掚論は䌚話内に折りたたたれたブロックずしお衚瀺されたす。ブロックをクリックするず内容を読むこずができ、`Ctrl+O` を抌すずセッション内のすべおの思考ブロックを展開たたは折りたたむこずができたす。詳现は[拡匵思考](https://code.claude.com/docs/ja/model-config.md#extended-thinking)を参照しおください。194* **拡匵思考**: 耇雑な問題に぀いお Claude がより倚くの時間をかけお掚論できるようにしたす。オフにしたり再びオンにしたりするには、コマンドメニュヌ`/`の Model セクションにある **Thinking** スむッチを䜿甚したす。[思考をオフにできない](https://code.claude.com/docs/ja/model-config.md#extended-thinking)モデルでは、メニュヌに **Thinking** スむッチはなく、思考はオンのたたになりたす。

195 

196 `Thought for 12s` のようなラベルだけが衚瀺される思考ブロックにはテキストがなく、クリックしおも開きたせん。思考の芁玄を衚瀺するには、`~/.claude/settings.json` で [`showThinkingSummaries`](https://code.claude.com/docs/ja/settings-reference#showthinkingsummaries) を `true` に蚭定し、コマンドパレットから **Developer: Reload Window** を実行したす。

197 

198 既存の思考ブロックは空のたたです。再読み蟌み埌の応答では、ブロックをクリックするか、`Ctrl+O` を抌しおすべおを展開したす。

195* **耇数行入力**: `Shift+Enter` を抌すず、送信せずに改行を远加できたす。これは質問ダむアログの「Other」自由蚘述入力でも機胜したす。199* **耇数行入力**: `Shift+Enter` を抌すず、送信せずに改行を远加できたす。これは質問ダむアログの「Other」自由蚘述入力でも機胜したす。

196 200 

197### ファむルずフォルダヌを参照する201### ファむルずフォルダヌを参照する

333 337 

334`/usage` を実行するず Account & usage ダむアログが開き、サむンむンしおいるアカりントず䜿甚量が衚瀺されたす。䜿甚量の数倀はサむンむン方法に応じお異なりたす。338`/usage` を実行するず Account & usage ダむアログが開き、サむンむンしおいるアカりントず䜿甚量が衚瀺されたす。䜿甚量の数倀はサむンむン方法に応じお異なりたす。

335 339 

336* **claude.ai プラン**: 珟圚のセッションや週など、プランの制限ごずの䜿甚量バヌが衚瀺されたす。各バヌには、その制限がリセットされるたでの時間が衚瀺されたす。340* **claude.ai プラン**: 珟圚のセッションや週など、プランの制限ごずの䜿甚量バヌが衚瀺されたす。

337 341 

338 ダむアログでは、プランの制限に圱響しおいる芁因の内蚳も確認できたす。342 ダむアログでは、プランの制限に圱響しおいる芁因の内蚳も確認できたす。

339 343 

580 584 

581プルリク゚ストを䜜成する堎合、Claude は実際のコヌド倉曎に基づいお説明を生成し、テストたたは実装の決定に関するコンテキストを远加できたす。585プルリク゚ストを䜜成する堎合、Claude は実際のコヌド倉曎に基づいお説明を生成し、テストたたは実装の決定に関するコンテキストを远加できたす。

582 586 

587### worktree に移動した䌚話を再床開く

588 

589再床開いた䌚話に **This session is in worktree** バナヌが衚瀺される堎合、その䌚話の䜜業ディレクトリは、このりィンドりで開いおいるフォルダではなく、バナヌに瀺された [worktree](https://code.claude.com/docs/ja/worktrees.md) です。新しい VS Code りィンドりで worktree を開くには、バナヌの **Open worktree** をクリックしたす。

590 

591䌚話が worktree に移動するのは、たずえば [Claude に worktree で䜜業するよう䟝頌した](https://code.claude.com/docs/ja/worktrees.md#ask-claude-to-create-a-worktree)堎合です。䌚話を再床開いたずき、たたはパネルが[りィンドりの再読み蟌み埌に䌚話を再床開いた](#continue-conversations-after-a-reload)ずき、Claude Code がその worktree を `.claude/worktrees/` 配䞋に䜜成しおおり、か぀それがただ存圚する堎合は、䌚話は worktree 内で再開されたす。Claude Code v2.1.300 より前のバヌゞョンでは、代わりに空の䌚話が開かれおいたした。これらのバヌゞョンを䜿甚しおいる堎合は、拡匵機胜を曎新しおください。

592 

583## バックグラりンドで䜜業を実行する593## バックグラりンドで䜜業を実行する

584 594 

585長時間実行されるコマンドやサブ゚ヌゞェントをバックグラりンドに送り、プロンプトボックスから状況を確認したす。595長時間実行されるコマンドやサブ゚ヌゞェントをバックグラりンドに送り、プロンプトボックスから状況を確認したす。

633| Insert @-Mention Reference | `Option+K`Mac/ `Alt+K`Windows/Linux | 珟圚のファむルず遞択範囲ぞの参照を挿入したす゚ディタヌがフォヌカスされおいる必芁がありたす |643| Insert @-Mention Reference | `Option+K`Mac/ `Alt+K`Windows/Linux | 珟圚のファむルず遞択範囲ぞの参照を挿入したす゚ディタヌがフォヌカスされおいる必芁がありたす |

634| Accept Change at Cursor | - | [提案された線集を倉曎ごずにレビュヌ](#get-started)しおいるずきに、カヌ゜ル䜍眮の倉曎を承認したす。Claude Code v2.1.275 以降が必芁です |644| Accept Change at Cursor | - | [提案された線集を倉曎ごずにレビュヌ](#get-started)しおいるずきに、カヌ゜ル䜍眮の倉曎を承認したす。Claude Code v2.1.275 以降が必芁です |

635| Reject Change at Cursor | - | 提案された線集を倉曎ごずにレビュヌしおいるずきに、カヌ゜ル䜍眮の倉曎を元に戻したす。Claude Code v2.1.275 以降が必芁です |645| Reject Change at Cursor | - | 提案された線集を倉曎ごずにレビュヌしおいるずきに、カヌ゜ル䜍眮の倉曎を元に戻したす。Claude Code v2.1.275 以降が必芁です |

636| Toggle Focus view | `Ctrl+Option+F`Mac/ `Ctrl+Alt+F`Windows/Linux | 䌚話内のツヌルのアクティビティを非衚瀺たたは衚瀺にしたす。Claude パネルたたはサむドバヌが衚瀺されおいる間に機胜したす。Claude Code v2.1.221 以降が必芁です |646| Toggle Focus view | `Ctrl+Option+F`Mac/ `Ctrl+Alt+F`Windows/Linux | 䌚話内のツヌルのアクティビティを非衚瀺たたは衚瀺にしたす。Claude パネルたたはサむドバヌが衚瀺されおいる間に機胜したす。Windows/Linux では、フォヌカスがデバッグコン゜ヌルたたぱクスプロヌラヌなどの怜玢可胜なリストにある間は、`Ctrl+Alt+F` を抌すず代わりに VS Code の怜玢が開きたす。゚ディタヌたたは Claude パネルにフォヌカスしおから、もう䞀床抌しおください。Claude Code v2.1.221 以降が必芁です |

637| Rename Session Tab | - | アクティブな Claude タブのセッション名を倉曎したす。Claude Code v2.1.257 以降が必芁です |647| Rename Session Tab | - | アクティブな Claude タブのセッション名を倉曎したす。Claude Code v2.1.257 以降が必芁です |

638| Add Session Tab to Group | - | アクティブな Claude タブのセッションを、遞択たたは䜜成した[セッショングルヌプ](#organize-sessions-into-groups)に远加したす。Claude Code v2.1.257 以降が必芁です |648| Add Session Tab to Group | - | アクティブな Claude タブのセッションを、遞択たたは䜜成した[セッショングルヌプ](#organize-sessions-into-groups)に远加したす。Claude Code v2.1.257 以降が必芁です |

639| Mark Session as Unread | - | アクティブな Claude タブのセッションを、セッション䞀芧で未読ずしおマヌクしたす。Claude Code v2.1.257 以降が必芁です |649| Mark Session as Unread | - | アクティブな Claude タブのセッションを、セッション䞀芧で未読ずしおマヌクしたす。Claude Code v2.1.257 以降が必芁です |

679| パラメヌタヌ | 説明 |689| パラメヌタヌ | 説明 |

680| - | - |690| - | - |

681| `prompt` | プロンプトボックスに事前入力するテキスト。URL ゚ンコヌドされおいる必芁がありたす。プロンプトは事前入力されたすが、自動的には送信されたせん。 |691| `prompt` | プロンプトボックスに事前入力するテキスト。URL ゚ンコヌドされおいる必芁がありたす。プロンプトは事前入力されたすが、自動的には送信されたせん。 |

682| `session` | 新しい䌚話を開始する代わりに再開するセッション ID。セッションは VS Code で珟圚開いおいるワヌクスペヌスに属しおいる必芁がありたす。セッションが芋぀からない堎合は、代わりに新しい䌚話が開始されたす。セッションがすでにタブで開いおいる堎合は、そのタブにフォヌカスが移りたす。セッション ID をプログラムで取埗するには、[䌚話を続ける](https://code.claude.com/docs/ja/headless.md#continue-conversations)を参照しおください。 |692| `session` | 再開するセッションの ID。VS Code で開いおいるフォルダヌのセッションを指定したす。Claude Code v2.1.300 以降では、そのフォルダヌのリポゞトリのメむンチェックアりトたたは [worktree](https://code.claude.com/docs/ja/worktrees.md) のセッションも再開できたす。セッションが芋぀からない堎合は、代わりに新しい䌚話が開始されたす。セッションがすでにタブで開いおいる堎合は、そのタブにフォヌカスが移りたす。セッション ID をプログラムで取埗するには、[䌚話を続ける](https://code.claude.com/docs/ja/headless.md#continue-conversations)を参照しおください。 |

683 693 

684たずえば、「review my changes」が事前入力されたタブを開くには次のようにしたす。694たずえば、「review my changes」が事前入力されたタブを開くには次のようにしたす。

685 695 

916| `Claude Code process exited with code 1` たたはその他のコヌド | [Claude Code process exited with code N](https://code.claude.com/docs/ja/errors.md#claude-code-process-exited-with-code-n) |926| `Claude Code process exited with code 1` たたはその他のコヌド | [Claude Code process exited with code N](https://code.claude.com/docs/ja/errors.md#claude-code-process-exited-with-code-n) |

917| `Could not locate the Claude CLI on PATH` | [Could not locate the Claude CLI on PATH](https://code.claude.com/docs/ja/errors.md#could-not-locate-the-claude-cli-on-path) |927| `Could not locate the Claude CLI on PATH` | [Could not locate the Claude CLI on PATH](https://code.claude.com/docs/ja/errors.md#could-not-locate-the-claude-cli-on-path) |

918| `The connection to Claude Code ended before this message completed` | [The connection to Claude Code ended before this message completed](https://code.claude.com/docs/ja/errors.md#the-connection-to-claude-code-ended-before-this-message-completed) |928| `The connection to Claude Code ended before this message completed` | [The connection to Claude Code ended before this message completed](https://code.claude.com/docs/ja/errors.md#the-connection-to-claude-code-ended-before-this-message-completed) |

929| `The Claude Code program for this computer, the <build> build, could not be found` | [The Claude Code program for this computer could not be found](https://code.claude.com/docs/ja/errors.md#the-claude-code-program-for-this-computer-could-not-be-found) |

919| VS Code の統合タヌミナルで `claude` が芋぀からない | [VS Code で CLI を実行する](#run-cli-in-vs-code) |930| VS Code の統合タヌミナルで `claude` が芋぀からない | [VS Code で CLI を実行する](#run-cli-in-vs-code) |

920 931 

921### 拡匵機胜をむンストヌルできない932### 拡匵機胜をむンストヌルできない

worktrees.md +15 −1

Details

214 214 

215### worktree 名を再利甚する215### worktree 名を再利甚する

216 216 

217既にディレクトリが存圚する名前を `--worktree` に枡すず、新しい worktree を䜜成する代わりに、その既存の worktree が開きたす。217`--worktree` に枡した名前の worktree が既に存圚する堎合、Claude Code は新しい worktree を䜜成する代わりにその worktree を開きたす。Claude Code が `belongs to a different repository` たたは `is a leftover worktree` を含む゚ラヌで停止した堎合は、[worktree ディレクトリが `belongs to a different repository` ずなる](#belongs-to-a-different-repository)を参照しおください。

218 218 

219デフォルトの `"fresh"` [ベヌス](#choose-the-base-branch)では、以䞋のすべおが圓おはたる堎合、再床開かれた worktree は叀いチップで続行する代わりにリポゞトリのデフォルトブランチにリセットされたす。219デフォルトの `"fresh"` [ベヌス](#choose-the-base-branch)では、以䞋のすべおが圓おはたる堎合、再床開かれた worktree は叀いチップで続行する代わりにリポゞトリのデフォルトブランチにリセットされたす。

220 220 

353 353 

354`This repository is a partial clone` を含む゚ラヌは、worktree の開始コミットに必芁なすべおの git オブゞェクトを Claude Code が取埗できなかったこずを意味したす。メッセヌゞ内の `try again` で終わる文に瀺された手順を実行しおください。その埌、その手順を実行したシェルから再詊行したす。`claude --worktree` を実行するか、そこで `claude` を起動しお再床䟝頌しおください。354`This repository is a partial clone` を含む゚ラヌは、worktree の開始コミットに必芁なすべおの git オブゞェクトを Claude Code が取埗できなかったこずを意味したす。メッセヌゞ内の `try again` で終わる文に瀺された手順を実行しおください。その埌、その手順を実行したシェルから再詊行したす。`claude --worktree` を実行するか、そこで `claude` を起動しお再床䟝頌しおください。

355 355 

356### `Can only use --worktree in a git repository`

357 

358この゚ラヌは、git チェックアりトではないディレクトリで `--worktree` を枡し、か぀ [`WorktreeCreate` フック](#non-git-version-control)が有効になっおいないこずを意味したす。

359 

360* バヌゞョン管理を䜿甚しおいないフォルダヌでは、そこで `git init` を実行し、最初のコミットを䜜成しおから再詊行しおください。

361* 別のバヌゞョン管理システムのチェックアりトでは、メッセヌゞが提案するフックをセットアップしおください。

362* ディレクトリで盎接䜜業するには、`--worktree` を付けずに Claude を起動しおください。

363 

364### worktree ディレクトリが `belongs to a different repository` ず衚瀺される

365 

366゚ラヌ `belongs to a different repository` ず `is a leftover worktree` はどちらも、枡した worktree 名に察応するディレクトリを git が別の堎所に結び付けおいるこずを意味したす。これは、プロゞェクトをコピヌたたは移動した埌に発生する可胜性がありたす。

367 

368別の worktree 名を枡しおください。ディレクトリに残すべき䜜業がなく、プロゞェクトをコピヌも移動もしおいない堎合は、そのディレクトリを削陀しお同じ名前で再詊行できたす。コピヌたたは移動の埌では、この再詊行が `is already checked out elsewhere in this repository` で倱敗するこずがあるため、別の名前を䜿甚しおください。

369 

356### Claude Code が worktree の䜿甚を拒吊する370### Claude Code が worktree の䜿甚を拒吊する

357 371 

358`Refusing to use <path> as an isolation worktree` で始たる゚ラヌは、Claude Code がディレクトリをセッションたたはサブ゚ヌゞェントの分離されたチェックアりトずしお採甚する前にそのディレクトリの git ID を確認し、拒吊したこずを意味したす。このチェックは、Claude Code が worktree を䜜成する堎合、既存の worktree に入る堎合、以前の実行の worktree を再利甚する堎合のいずれでも実行されたす。372`Refusing to use <path> as an isolation worktree` で始たる゚ラヌは、Claude Code がディレクトリをセッションたたはサブ゚ヌゞェントの分離されたチェックアりトずしお採甚する前にそのディレクトリの git ID を確認し、拒吊したこずを意味したす。このチェックは、Claude Code が worktree を䜜成する堎合、既存の worktree に入る堎合、以前の実行の worktree を再利甚する堎合のいずれでも実行されたす。