Documentation 2026-11-02 23:57 UTC to 2026-11-03 23:58 UTC

79* HKLM レジストリまたは `C:\Program Files\ClaudeCode` ファイルを通じて `wslInheritsWindowsSettings: true` をデプロイして、WSL セッションがホストセッションと同じポリシーを継承するようにしてください。79* HKLM レジストリまたは `C:\Program Files\ClaudeCode` ファイルを通じて `wslInheritsWindowsSettings: true` をデプロイして、WSL セッションがホストセッションと同じポリシーを継承するようにしてください。

80* WSL セッション内で `/status` を実行して検証し、`Setting sources` 行を読んでください。それを解釈する方法については、[/status で出力を読む](https://code.claude.com/docs/ja/managed-settings.md#read-the-source-in-/status)を参照してください。80* WSL セッション内で `/status` を実行して検証し、`Setting sources` 行を読んでください。それを解釈する方法については、[/status で出力を読む](https://code.claude.com/docs/ja/managed-settings.md#read-the-source-in-/status)を参照してください。

81 81 

82Claude Desktop の [`allowedWorkspaceFolders`](https://claude.com/docs/third-party/claude-desktop/configuration#allowedworkspacefolders) リストが設定されたデバイスで WSL セッションが開始される場合、`~` エントリはディストリビューション内のホームディレクトリを意味します。

83 

82WSL 2 ユーティリティ VM 内のプロセスは、Windows 側のエンドポイント検出センサーに表示されません。ディストリビューション内のプロセスとファイルアクティビティを観察するには、エンドポイント検出ベンダーの WSL ガイダンスで、ディストリビューション内で実行できる Linux センサーと、それが必要とする除外を確認してください。Claude Code の [OpenTelemetry ツール実行テレメトリ](https://code.claude.com/docs/ja/monitoring-usage.md)は WSL とネイティブセッションで同じように出力されます。84WSL 2 ユーティリティ VM 内のプロセスは、Windows 側のエンドポイント検出センサーに表示されません。ディストリビューション内のプロセスとファイルアクティビティを観察するには、エンドポイント検出ベンダーの WSL ガイダンスで、ディストリビューション内で実行できる Linux センサーと、それが必要とする除外を確認してください。Claude Code の [OpenTelemetry ツール実行テレメトリ](https://code.claude.com/docs/ja/monitoring-usage.md)は WSL とネイティブセッションで同じように出力されます。

83 85 

84## 適用する内容を決める86## 適用する内容を決める

127 129 

128### 接続された GitHub アカウント130### 接続された GitHub アカウント

129 131 

130Team プランと Enterprise プランでは、[**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control) の GitHub セクションに、[Claude GitHub App](https://github.com/apps/claude) を通じて Claude 組織にリンクされた GitHub 組織と個人アカウントが一覧表示されます。Claude Code、[Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github)、Claude Security はこの一覧を共有します。このページを開くには、Claude 組織の管理者ロールが必要です。132Team プランと Enterprise プランでは、[**Organization settings > Git providers**](https://claude.ai/admin-settings/source-control) の GitHub セクションに、[Claude GitHub App](https://github.com/apps/claude) を通じて Claude 組織にリンクされた GitHub 組織と個人アカウントが一覧表示されます。Claude Code、[Claude Tag](https://claude.com/docs/claude-tag/admins/configure-github)、Claude Security はこの一覧を共有します。このページを開くには、Claude 組織の [Owner ロール](https://code.claude.com/docs/ja/server-managed-settings.md#access-control)が必要です。Admin ロールではこのページを開けません。

131 133 

132アカウントは管理者またはメンバーがリンクできます。134アカウントは、Git プロバイダーページから、または GitHub を Claude に接続することでリンクできます。

133 135 

134* **管理者による接続**：管理者がそのセクションで **Connect** をクリックするか、アカウントが接続済みの場合は **Add organization** をクリックし、GitHub 組織に Claude GitHub App をインストールします。この方法で組織をリンクするには、GitHub 組織の Owner であり、かつ Claude 組織の管理者でもあるユーザーが必要です。136* **Owner による接続**：Owner がそのセクションで **Connect** をクリックするか、アカウントが接続済みの場合は **Add organization** をクリックし、GitHub 組織に Claude GitHub App をインストールします。この方法で組織をリンクするには、Claude 組織の Owner であり、かつ GitHub 組織の所有者でもあるユーザーが必要です。

135* **メンバーによる接続**：メンバーが自分の GitHub アカウントを Claude に接続すると（たとえば[クラウドセッションのセットアップ](https://code.claude.com/docs/ja/web-quickstart.md#connect-github)中）、Claude は、そのメンバーが所有し、Claude GitHub App がすでにインストールされている GitHub アカウントをリンクします。これには、メンバーの個人アカウントや、メンバーが所有する GitHub 組織が含まれる場合があります。137* **メンバーによる接続**：メンバーが自分の GitHub アカウントを Claude に接続すると（たとえば[クラウドセッションのセットアップ](https://code.claude.com/docs/ja/web-quickstart.md#connect-github)中）、Claude は、そのメンバーが所有し、Claude GitHub App がすでにインストールされている GitHub アカウントをリンクします。これには、メンバーの個人アカウントや、メンバーが所有する GitHub 組織が含まれる場合があります。

136 138 

137**Not linked** と表示されている行は、自分自身の GitHub サインインに由来するものです。これは、GitHub 上で自分が参照でき、Claude GitHub App がインストールされているアカウントです。139**Not linked** と表示されている行は、自分自身の GitHub サインインに由来するものです。これは、GitHub 上で自分が参照でき、Claude GitHub App がインストールされているアカウントです。

222>222>

223> `effort` は、各応答内でレイテンシとトークンコストを推論の深さと引き換えにするものです。[拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)は出力に `thinking` ブロックを生成する別の機能であり、[Python](https://code.claude.com/docs/ja/agent-sdk/python.md#thinkingconfig) または [TypeScript](https://code.claude.com/docs/ja/agent-sdk/typescript.md#thinkingconfig) の `ThinkingConfig` にある `display` フィールドで、そのテキストを受け取るかどうかを制御します。両者は独立しており、拡張思考を有効にした状態で `effort: "low"` を設定することも、拡張思考なしで `effort: "max"` を設定することもできます。223> `effort` は、各応答内でレイテンシとトークンコストを推論の深さと引き換えにするものです。[拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking)は出力に `thinking` ブロックを生成する別の機能であり、[Python](https://code.claude.com/docs/ja/agent-sdk/python.md#thinkingconfig) または [TypeScript](https://code.claude.com/docs/ja/agent-sdk/typescript.md#thinkingconfig) の `ThinkingConfig` にある `display` フィールドで、そのテキストを受け取るかどうかを制御します。両者は独立しており、拡張思考を有効にした状態で `effort: "low"` を設定することも、拡張思考なしで `effort: "max"` を設定することもできます。

224 224 

225シンプルで範囲が明確なタスク（ファイルの一覧表示や単一の grep の実行など）を行うエージェントには、低い effort を使用してコストとレイテンシを削減してください。`effort` は、セッション全体に対してはトップレベルの `query()` オプションで設定し、サブエージェントごとには [`AgentDefinition`](https://code.claude.com/docs/ja/agent-sdk/subagents#agentdefinition-configuration) の `effort` フィールドで設定してセッションレベルの値を上書きします。225ファイルの一覧表示や単一の grep の実行など、シンプルで範囲が明確なタスクを行うエージェントには、低い effort を使用してコストとレイテンシを削減してください。`effort` は、[セッション](https://code.claude.com/docs/ja/sub-agents.md#choose-an-effort-level)に対してトップレベルの `query()` オプションで設定するか、サブエージェントごとに [`AgentDefinition`](https://code.claude.com/docs/ja/agent-sdk/subagents#agentdefinition-configuration) の `effort` フィールドで設定してセッションレベルを上書きします。

226 226 

227### 権限モード227### 権限モード

228 228 

224| `matcher` | `string` | `undefined` | イベントのフィルタフィールドに対してマッチングされるパターン。[設定ファイルの matcher のルール](https://code.claude.com/docs/ja/hooks.md#matcher-patterns)に従います。ツールフックの場合、これはツール名です。組み込みツールには `Bash`、`Read`、`Write`、`Edit`、`Glob`、`Grep`、`WebFetch`、`Agent` などが含まれます（完全なリストについては[ツール入力型](https://code.claude.com/docs/ja/agent-sdk/typescript.md#tool-input-types)を参照）。MCP ツールはパターン `mcp__<server>__<action>` を使用します。ここで `<server>` は `mcpServers` 設定で使用するキーで、[ツールの命名規則](https://code.claude.com/docs/ja/agent-sdk/mcp.md#tool-naming-convention)で説明されている表記に従います。 |224| `matcher` | `string` | `undefined` | イベントのフィルタフィールドに対してマッチングされるパターン。[設定ファイルの matcher のルール](https://code.claude.com/docs/ja/hooks.md#matcher-patterns)に従います。ツールフックの場合、これはツール名です。組み込みツールには `Bash`、`Read`、`Write`、`Edit`、`Glob`、`Grep`、`WebFetch`、`Agent` などが含まれます（完全なリストについては[ツール入力型](https://code.claude.com/docs/ja/agent-sdk/typescript.md#tool-input-types)を参照）。MCP ツールはパターン `mcp__<server>__<action>` を使用します。ここで `<server>` は `mcpServers` 設定で使用するキーで、[ツールの命名規則](https://code.claude.com/docs/ja/agent-sdk/mcp.md#tool-naming-convention)で説明されている表記に従います。 |

225| `hooks` | `HookCallback[]` | - | 必須。パターンがマッチしたときに実行するコールバック関数の配列 |225| `hooks` | `HookCallback[]` | - | 必須。パターンがマッチしたときに実行するコールバック関数の配列 |

226| `timeout` | `number` | `undefined` | タイムアウト（秒単位）。省略した場合、Claude Code は[イベントのデフォルトタイムアウト](#hook-timeout)を適用します。SDK コールバックは `command` フックのデフォルトに従います |226| `timeout` | `number` | `undefined` | タイムアウト（秒単位）。省略した場合、Claude Code は[イベントのデフォルトタイムアウト](#hook-timeout)を適用します。SDK コールバックは `command` フックのデフォルトに従います |

227| `onFailure` | `"continue" \| "block"` | `undefined` | コールバックが失敗したときの動作。`"block"` を設定すると、[コールバックが失敗したときにアクションをブロック](#block-the-action-when-a-callback-fails)します。Python では `on_failure` を使用します |

227 228 

228可能な限り `matcher` パターンを使用して特定のツールをターゲットにします。`'Bash'` のマッチャーは Bash コマンドに対してのみ実行されますが、パターンを省略するとコールバックはそのイベントのすべての発生に対して実行されます。229可能な限り `matcher` パターンを使用して特定のツールをターゲットにします。`'Bash'` のマッチャーは Bash コマンドに対してのみ実行されますが、パターンを省略するとコールバックはそのイベントのすべての発生に対して実行されます。

229 230 

283>284>

284> 非同期出力はエージェントが既に先に進んでいるため、ブロック、変更、またはコンテキストを注入することはできません。ログ、メトリクス、または通知などの副作用にのみ使用します。285> 非同期出力はエージェントが既に先に進んでいるため、ブロック、変更、またはコンテキストを注入することはできません。ログ、メトリクス、または通知などの副作用にのみ使用します。

285 286 

287### コールバックが失敗したときにアクションをブロックする

288 

289ほとんどのイベントでは、コールバックが例外をスローするか、検証に失敗する出力を返した場合、アクションはそのまま実行され、アプリは `tag` が `hook_callback_failed` である [`SDKInformationalMessage`](https://code.claude.com/docs/ja/agent-sdk/typescript#sdkinformationalmessage) 警告を受け取ります。そのため、クラッシュした `PreToolUse` ガードは、ツール呼び出しを通常の権限フローに進ませてしまいます。`return` のないパスのように何も返さないコールバックも、失敗として扱われます。Python では、`SystemMessage.data` から `tag` を読み取ります。

290 

291代わりにアクションをブロックするには、matcher に TypeScript では `onFailure: "block"`、Python では `on_failure="block"` を設定します。TypeScript Agent SDK v0.3.317 以降、または Python Agent SDK v0.2.177 以降が必要です。この例では、Python の `check_policy` または TypeScript の `checkPolicy` が失敗したときに Bash の呼び出しをブロックします。

292 

293```python Python theme={null}

294options = ClaudeAgentOptions(

295 hooks={

296 "PreToolUse": [

297 HookMatcher(matcher="Bash", hooks=[check_policy], on_failure="block")

298 ]

299 }

300)

301```

302 

303```typescript TypeScript theme={null}

304import type { Options } from "@anthropic-ai/claude-agent-sdk";

305 

306const options: Options = {

307 hooks: {

308 PreToolUse: [{ matcher: "Bash", hooks: [checkPolicy], onFailure: "block" }]

309 }

310};

311```

312 

313テストするには、コールバックでエラーを発生させ、Claude に Bash コマンドの実行を依頼します。ツール結果には `failed; blocking because onFailure is "block"` が含まれ、Claude にはエラーテキストは表示されません。

314 

315コールバックに判断すべき内容がない場合は `{}` を返します。`"block"` を設定している場合、`return` のないパスはアクションをブロックします。自身のエラーをキャッチして `{}` を返すコールバックは失敗とは見なされないため、ガードではエラーを伝播させてください。

316 

317#### 異なる動作をするイベント

318 

319以下のイベントは、`"block"` を設定していても常にブロックするとは限りません。

320 

321* **`Stop`、`SubagentStop`、`TaskCompleted`、および `TeammateIdle`**：これらのイベントはこのオプションを無視するため、アクションはそのまま実行されます。

322* **`PermissionRequest`**：ブロックは、`canUseTool` コールバックが応答する前に届いた場合にのみ有効です。

323* **`PostToolUse`**：ツールは既に実行されているため、Claude は失敗をフィードバックとして受け取ります。

324 

325タイムアウトを超過したコールバックは、[フックのタイムアウト](#hook-timeout)に従います。`"block"` を設定している場合、タイムアウトは `PreCompact`、`Elicitation`、および `WorktreeCreate` もブロックします。

326 

327#### `onFailure` の起動時エラー

328 

329`"block"` を設定している場合、このオプションを適用できないときは、クエリは起動時に失敗し、プロンプトは送信されません。

330 

331* **Claude Code がこのオプションをサポートしていない**：エラーに `does not honor` が含まれます。Claude Code を更新するか、オプションを削除してください。

332* **セッションが既に実行中で、フックが登録されなかった**：エラーに `did not register your hooks` が含まれます。新しいセッションを開始してください。

333 

286## 例334## 例

287 335 

288このセクションのいくつかの例では、コールバック関数のみを示しています。実行するには、[フックを設定する](#configure-hooks)で示すように、オプションの `hooks` フィールドで対応するイベントの下にコールバックを登録してください。336このセクションのいくつかの例では、コールバック関数のみを示しています。実行するには、[フックを設定する](#configure-hooks)で示すように、オプションの `hooks` フィールドで対応するイベントの下にコールバックを登録してください。

779* `Stop` および `SubagentStop`：タイムアウトしたコールバックは決定を返さないとカウントされます。エージェントまたはサブエージェントは、そのコールバックがそれを許可したかのように停止し、イベントの他のフックからの決定が適用されます。Claude Code v2.1.273 より前では、タイムアウトした `Stop` または `SubagentStop` コールバックは失敗したフック実行としてカウントされ、Claude Code はイベントの他のフックの決定を破棄していました。827* `Stop` および `SubagentStop`：タイムアウトしたコールバックは決定を返さないとカウントされます。エージェントまたはサブエージェントは、そのコールバックがそれを許可したかのように停止し、イベントの他のフックからの決定が適用されます。Claude Code v2.1.273 より前では、タイムアウトした `Stop` または `SubagentStop` コールバックは失敗したフック実行としてカウントされ、Claude Code はイベントの他のフックの決定を破棄していました。

780* `SessionStart`：タイムアウトしたコールバックは出力を返さないとカウントされ、セッションは他の `SessionStart` フックの出力で続行されます。828* `SessionStart`：タイムアウトしたコールバックは出力を返さないとカウントされ、セッションは他の `SessionStart` フックの出力で続行されます。

781* `PreModelSwitch`：Claude Code はモデルスイッチをブロックします。応答しないフックはスイッチを承認していません。829* `PreModelSwitch`：Claude Code はモデルスイッチをブロックします。応答しないフックはスイッチを承認していません。

782* `Notification`、`PreCompact`、`PostModelSwitch` などの他のイベント：Claude Code は失敗をログに記録して続行します。830* `Notification`、`PreCompact`、`PostModelSwitch` などの他のイベント：Claude Code は失敗をログに記録して続行します。[`onFailure: "block"`](#block-the-action-when-a-callback-fails) を使用すると、`PreCompact`、`Elicitation`、または `WorktreeCreate` でのタイムアウトはそのアクションをブロックします。

783 831 

784メインセッションで `Stop` または `SessionStart` コールバックが初めてタイムアウトした場合、Claude Code はメッセージストリームに [`SDKInformationalMessage`](https://code.claude.com/docs/ja/agent-sdk/typescript#sdkinformationalmessage) も追加します。これはセッションを駆動するアプリが応答しなかったことを示します。その後のタイムアウトはアプリが応答しない間、そのメッセージを繰り返しません。832メインセッションで `Stop` または `SessionStart` コールバックが初めてタイムアウトした場合、Claude Code はメッセージストリームに [`SDKInformationalMessage`](https://code.claude.com/docs/ja/agent-sdk/typescript#sdkinformationalmessage) も追加します。これはセッションを駆動するアプリが応答しなかったことを示します。その後のタイムアウトはアプリが応答しない間、そのメッセージを繰り返しません。

785 833 

2161 None # Timeout in seconds. When omitted, the per-event default applies:2161 None # Timeout in seconds. When omitted, the per-event default applies:

2162 # 600 for most events, 30 for UserPromptSubmit2162 # 600 for most events, 30 for UserPromptSubmit

2163 )2163 )

2164 on_failure: Literal["continue", "block"] | None = (

2165 None # "block" blocks the action when a callback fails

2166 )

2164```2167```

2165 2168 

2169`on_failure` の対象範囲を判断するには、[コールバックが失敗したときにアクションをブロックする](https://code.claude.com/docs/ja/agent-sdk/hooks.md#block-the-action-when-a-callback-fails) を参照してください。

2170 

2166### `HookInput`2171### `HookInput`

2167 2172 

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

2437 2442 

2438#### `HookSpecificOutput`2443#### `HookSpecificOutput`

2439 2444 

2440イベント固有の出力型の判別 union。`hookEventName` フィールドはどのフィールドが有効かを決定します。hook イベントごとに利用可能なフィールドの詳細については、[hooks で実行を制御](https://code.claude.com/docs/ja/agent-sdk/hooks.md#outputs) を参照してください。2445イベント固有の `TypedDict` 出力型の判別 union。`hookEventName` フィールドはどのフィールドが有効かを決定します。hook イベントごとに利用可能なフィールドの詳細については、[hooks で実行を制御](https://code.claude.com/docs/ja/agent-sdk/hooks.md#outputs) を参照してください。

2441 2446 

2442```python theme={null}2447```python theme={null}

2443class PreToolUseHookSpecificOutput(TypedDict):2448class PreToolUseHookSpecificOutput(TypedDict):

2183 level: "info" | "notice" | "suggestion" | "warning";2183 level: "info" | "notice" | "suggestion" | "warning";

2184 tool_use_id?: string;2184 tool_use_id?: string;

2185 prevent_continuation?: boolean;2185 prevent_continuation?: boolean;

2186 tag?: string;

2186 uuid: UUID;2187 uuid: UUID;

2187 session_id: string;2188 session_id: string;

2188};2189};

2558 matcher?: string;2559 matcher?: string;

2559 hooks: HookCallback[];2560 hooks: HookCallback[];

2560 timeout?: number; // このマッチャーのすべてのフックのタイムアウト（秒）2561 timeout?: number; // このマッチャーのすべてのフックのタイムアウト（秒）

2562 onFailure?: "continue" | "block"; // "block" はコールバックが失敗したときにアクションをブロックします

2561}2563}

2562```2564```

2563 2565 

2566`onFailure` が対象とする範囲を判断するには、[コールバックが失敗したときにアクションをブロックする](https://code.claude.com/docs/ja/agent-sdk/hooks.md#block-the-action-when-a-callback-fails) を参照してください。

2567 

2564### `HookInput`2568### `HookInput`

2565 2569 

2566すべてのフック入力型の共用体型。2570すべてのフック入力型の共用体型。

158* **`opus` などのファミリーエイリアス**：Anthropic API および AWS 上の Claude Platform では、Claude Code はチームメンバーを許可リストが許可するそのファミリーの最新バージョンで実行します。プロバイダー固有のモデル ID を持つプロバイダーでは、[代替が動作しない](https://code.claude.com/docs/ja/model-config.md#restrict-model-selection)場合、ブロックされたエイリアスは次の箇条書きに従って他のブロックされた値のようにフォールバックします。158* **`opus` などのファミリーエイリアス**：Anthropic API および AWS 上の Claude Platform では、Claude Code はチームメンバーを許可リストが許可するそのファミリーの最新バージョンで実行します。プロバイダー固有のモデル ID を持つプロバイダーでは、[代替が動作しない](https://code.claude.com/docs/ja/model-config.md#restrict-model-selection)場合、ブロックされたエイリアスは次の箇条書きに従って他のブロックされた値のようにフォールバックします。

159* **プロバイダー固有のモデル ID を持つプロバイダーで代替が動作しないファミリーエイリアス、またはそのファミリーに許可されたバージョンがないもの、またはその他のブロックされた値**：Claude Code はチームメンバーをリーダーのモデルで実行します。`CLAUDE_CODE_SUBAGENT_MODEL` を設定した場合、Claude Code はそのモデルを最初に試し、これらの同じルールの下で実行します。159* **プロバイダー固有のモデル ID を持つプロバイダーで代替が動作しないファミリーエイリアス、またはそのファミリーに許可されたバージョンがないもの、またはその他のブロックされた値**：Claude Code はチームメンバーをリーダーのモデルで実行します。`CLAUDE_CODE_SUBAGENT_MODEL` を設定した場合、Claude Code はそのモデルを最初に試し、これらの同じルールの下で実行します。

160 160 

161デフォルトでは、チームメンバーはリーダーの [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)を継承します。分割ペインモードではこれは v2.1.186 から適用されます。それより前のバージョンではリーダーのセッションの effort を分割ペインのチームメンバーに渡していませんでした。161デフォルトでは、リーダーのモデルで動作するチームメイトはリーダーの [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)を継承します。分割ペインモードではこれは v2.1.186 から適用されます。それより前のバージョンではリーダーのセッションの effort を分割ペインのチームメイトに渡していませんでした。別のモデルで動作するチームメイトについては、[サブエージェントとチームメイトの effort レベル](https://code.claude.com/docs/ja/model-config.md#effort-level-of-subagents-and-teammates)を参照してください。

162 162 

163### チームメンバーが実装前にプランを立てるようにする163### チームメンバーが実装前にプランを立てるようにする

164 164 

165複雑またはリスクの高いタスクの場合、チームメンバーが実装前にプランを立てることができます。リーダーが[プランモード](https://code.claude.com/docs/ja/permission-modes.md#analyze-before-you-edit-with-plan-mode)にある間に Claude がスポーンするチームメンバーは、プランが準備できるまで読み取り専用プランモードで動作します。まずリーダーをプランモードに切り替えてから、チームメンバーを要求してください。165複雑またはリスクの高いタスクの場合、チームメンバーが実装前にプランを立てることができます。リーダーが [plan モード](https://code.claude.com/docs/ja/permission-modes.md#analyze-before-you-edit-with-plan-mode)にある間に Claude がスポーンするチームメンバーも、プランが準備できるまで plan モードで動作します。まずリーダーを plan モードに切り替えてから、チームメンバーを要求してください。

166 166 

167```text wrap theme={null}167```text wrap theme={null}

168Spawn an architect teammate to refactor the authentication module.168Spawn an architect teammate to refactor the authentication module.

169```169```

170 170 

171そのチームメイトがプランを完了すると、リーダーにプラン承認リクエストを送信します。スポーン後にそのチームメイトの権限モードを変更していない場合、Claude Code はリクエストが到着するとすぐにプランを承認し、リーダーがそれをレビューすることはありません。チームメイトの編集とコマンドは、引き続き[権限](#permissions)で説明されている権限プロンプトを通過します。承認されると、チームメイトは plan モードを終了し、実装を開始します。171そのチームメイトがプランを完了すると、リーダーにプラン承認リクエストを送信します。スポーン後にそのチームメイトの権限モードを変更していない場合、Claude Code はリクエストが到着するとすぐにプランを承認し、リーダーがそれをレビューすることはありません。承認されると、チームメイトは plan モードを終了し、実装を開始します。Claude Code はチームメイトにリーダーの現在の[権限モード](#permissions)を渡します。それが plan モードの場合は Manual を渡します。

172 172 

173実行中の in-process チームメイトのセッションを表示している間に [`Shift+Tab`](https://code.claude.com/docs/ja/permission-modes#switch-permission-modes) を押してそのチームメイトを plan モードにした場合、その実行のプランは Claude Code が承認するのではなく、リーダーがレビューします。ユーザーに承認は求められません。リーダーがプランを承認するか、修正のために差し戻します。173実行中の in-process チームメイトのセッションを表示している間に [`Shift+Tab`](https://code.claude.com/docs/ja/permission-modes#switch-permission-modes) を押してそのチームメイトを plan モードにした場合、その実行のプランは Claude Code が承認するのではなく、リーダーがレビューします。ユーザーに承認は求められません。リーダーがプランを承認するか、修正のために差し戻します。

174 174 

219* [`TaskCreated`](https://code.claude.com/docs/ja/hooks#taskcreated)：タスクが作成されているときに実行されます。終了コード 2 で作成を防止し、フィードバックを送信してください。219* [`TaskCreated`](https://code.claude.com/docs/ja/hooks#taskcreated)：タスクが作成されているときに実行されます。終了コード 2 で作成を防止し、フィードバックを送信してください。

220* [`TaskCompleted`](https://code.claude.com/docs/ja/hooks#taskcompleted)：タスクが完了としてマークされているときに実行されます。終了コード 2 で完了を防止し、フィードバックを送信してください。220* [`TaskCompleted`](https://code.claude.com/docs/ja/hooks#taskcompleted)：タスクが完了としてマークされているときに実行されます。終了コード 2 で完了を防止し、フィードバックを送信してください。

221 221 

222## エージェントチームの動作方法222## エージェントチームの仕組み

223 223 

224このセクションでは、エージェントチームの背後にあるアーキテクチャとメカニクスについて説明します。使用を開始したい場合は、上記の [エージェントチームを制御する](#control-your-agent-team) を参照してください。224このセクションでは、エージェントチームの背後にあるアーキテクチャと仕組みについて説明します。使い始めたい場合は、上記の[エージェントチームを制御する](#control-your-agent-team)を参照してください。

225 225 

226### Claude がエージェントチームを開始する方法226### Claude がエージェントチームを開始する方法

227 227 

228チームを開始するには、Claude にチームメンバーをリクエストしてください。Claude は [Agent ツール](https://code.claude.com/docs/ja/tools-reference.md) を呼び出して [`name`](https://code.claude.com/docs/ja/sub-agents#subagent-names) を指定し、エージェントチームが有効になっている場合にチームメンバーを起動します。ただし、呼び出しが [fork](https://code.claude.com/docs/ja/sub-agents.md#fork-the-current-conversation) であるか、呼び出し自体で `isolation` を渡す場合は除きます。Claude Code があなたに確認を求めることはありません。228チームを開始するには、Claude にチームメイトを依頼します。エージェントチームが有効な状態で、Claude が [`name`](https://code.claude.com/docs/ja/sub-agents#subagent-names) を指定して [Agent ツール](https://code.claude.com/docs/ja/tools-reference.md)を呼び出すと、Claude はチームメイトを起動します。ただし、その呼び出しが[フォーク](https://code.claude.com/docs/ja/sub-agents.md#fork-the-current-conversation)である場合や、呼び出し自体に `isolation` を渡している場合は除きます。Claude Code は起動の確認を求めません。

229 229 

230Claude は通常の subagent にも独自に名前を付けるため、後でメッセージを送信できます。これらの呼び出しは同じルールに従うため、チームメンバーをリクエストしなくてもチームが形成される可能性があります。subagent の代わりに使用したい場合は、[エージェントチームをオフにしてください](#claude-spawns-teammates-instead-of-subagents)。230Claude は、後でメッセージを送れるように、通常のサブエージェントにも自ら名前を付けます。これらの呼び出しにも同じルールが適用されるため、ユーザーがチームを依頼していなくてもチームが形成されることがあります。チームではなくサブエージェントを使いたい場合は、[エージェントチームをオフにしてください](#claude-spawns-teammates-instead-of-subagents)。

231 231 

232### アーキテクチャ232### アーキテクチャ

233 233 

234エージェントチームは以下で構成されています。234エージェントチームは次の要素で構成されます。

235 235 

236| コンポーネント | 役割 |236| コンポーネント | 役割 |

237| :- | :- |237| :- | :- |

238| **チームリーダー** | チームメンバーを生成し、作業を調整するメイン Claude Code セッション |238| **チームリーダー** | チームメイトを生成し、作業を調整するメインの Claude Code セッション |

239| **チームメンバー** | 割り当てられたタスクで動作する個別の Claude Code インスタンス |239| **チームメイト** | それぞれ割り当てられたタスクに取り組む個別の Claude Code インスタンス |

240| **タスクリスト** | チームメンバーが要求して完了する共有作業項目リスト |240| **タスクリスト** | チームメイトが引き受けて完了させる作業項目の共有リスト |

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

242 242 

243各エージェントのメールボックスは `~/.claude/teams/{team-name}/inboxes/{agent-name}.json` にある JSON ファイルです。Claude Code はメールボックスファイルを読み取るときにすべてのエントリを検証します。メッセージ形式と一致しないエントリはエラーとして報告され、ファイルから削除されます。有効なメッセージは引き続き配信されます。243各エージェントのメールボックスは、`~/.claude/teams/{team-name}/inboxes/{agent-name}.json` にある JSON ファイルです。Claude Code はメールボックスファイルを読み込む際に、すべてのエントリを検証します。メッセージ形式に一致しないエントリはエラーとして報告され、ファイルから削除されます。有効なメッセージは引き続き配信されます。

244 244 

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

246 246 

247Claude Code はタスク依存関係を自動的に管理します。チームメンバーが他のタスクが依存するタスクを完了すると、ブロックされたタスクはあなたからのアクションなしにブロック解除されます。247Claude Code はタスクの依存関係を自動的に管理します。他のタスクが依存しているタスクをチームメイトが完了すると、ユーザーが何も操作しなくても、依存しているタスクのブロックが解除されます。

248 248 

249チームとタスクはセッション派生名でローカルに保存されます。名前は `session-` の後にセッション ID の最初の 8 文字が続きます。249チームとタスクは、セッションから派生した名前でローカルに保存されます。名前は `session-` の後にセッション ID の最初の 8 文字が続く形式です。

250 250 

251* **チーム設定**：`~/.claude/teams/{team-name}/config.json`。Claude Code はセッション終了時にチーム設定ディレクトリを削除します。251* **チーム設定**: `~/.claude/teams/{team-name}/config.json`。Claude Code はセッション終了時にチーム設定ディレクトリを削除します。

252* **タスクリスト**：`~/.claude/tasks/{team-name}/`。このディレクトリはセッション終了後もディスク上に残ります。[Claude Code が保持する期間](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically) を変更するには、[`cleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#cleanupperioddays) を設定してください。252* **タスクリスト**: `~/.claude/tasks/{team-name}/`。このディレクトリはセッション終了後もディスク上に残ります。[Claude Code がこれを保持する期間](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)を変更するには、[`cleanupPeriodDays`](https://code.claude.com/docs/ja/settings-reference#cleanupperioddays) を設定してください。

253 253 

254Claude Code はセッション起動時にこれらの両方を自動的に生成し、チームメンバーが参加、アイドル状態になる、または離脱するときに更新します。254Claude Code は、セッション開始時にこれらの両方を自動的に生成し、チームメイトの参加、アイドル状態への移行、離脱に応じて更新します。

255 255 

256チーム設定はセッション ID と tmux ペイン ID などのランタイム状態を保持しているため、手動で編集したり、事前に作成したりしないでください。次の状態更新時に変更が上書きされます。256チーム設定にはセッション ID や tmux ペイン ID などのランタイム状態が保持されているため、手動で編集したり事前に作成したりしないでください。変更内容は次の状態更新時に上書きされます。

257 257 

258再利用可能なチームメンバーロールを定義するには、代わりに [subagent 定義を使用](#use-subagent-definitions-for-teammates) してください。258再利用可能なチームメイトの役割を定義するには、代わりに[サブエージェント定義](#use-subagent-definitions-for-teammates)を使用してください。

259 259 

260チーム設定には、各メンバーの名前とエージェント ID を含む `members` 配列が含まれています。リーダーのエントリは常にエージェントタイプ `team-lead` を持ちます。チームメンバーのエントリは、リーダーが生成時に名前を付けたエージェントタイプ（[組み込みタイプ](https://code.claude.com/docs/ja/sub-agents.md#built-in-subagents) または [subagent 定義](#use-subagent-definitions-for-teammates) のいずれか）を持ち、リーダーが何も名前を付けなかった場合はフィールドを省略します。チームメンバーはこのファイルを読み取って、他のチームメンバーを発見できます。260チーム設定には、各メンバーの名前とエージェント ID を含む `members` 配列が含まれています。リーダーのエントリには、常にエージェントタイプ `team-lead` が付きます。チームメイトのエントリには、リーダーが生成時に指定したエージェントタイプが付きます。これは[組み込みタイプ](https://code.claude.com/docs/ja/sub-agents.md#built-in-subagents)の場合も[サブエージェント定義](#use-subagent-definitions-for-teammates)の場合もあり、リーダーが何も指定しなかった場合はこのフィールドは省略されます。チームメイトはこのファイルを読み取って、他のチームメンバーを把握できます。

261 261 

262プロジェクトレベルのチーム設定に相当するものはありません。プロジェクトディレクトリ内の `.claude/teams/teams.json` のようなファイルは設定として認識されません。Claude はそれを通常のファイルとして扱います。262チーム設定に相当するプロジェクトレベルの設定はありません。プロジェクトディレクトリ内の `.claude/teams/teams.json` のようなファイルは設定として認識されず、Claude は通常のファイルとして扱います。

263 263 

264### チームメンバーに subagent 定義を使用する264### チームメイトにサブエージェント定義を使用する

265 265 

266どちらの表示モードでもチームメイトを生成するときに、プロジェクト、ユーザー、管理対象、またはプラグインの [サブエージェントスコープ](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope) から [サブエージェント](https://code.claude.com/docs/ja/sub-agents.md) タイプを参照できます。これにより、セキュリティレビュアーやテストランナーなどのロールを 1 回定義し、委任されたサブエージェントとエージェントチームのチームメイトの両方として再利用できます。266どちらの表示モードでチームメイトを生成する場合でも、プロジェクト、ユーザー、管理、またはプラグインの[サブエージェントスコープ](https://code.claude.com/docs/ja/sub-agents.md#choose-the-subagent-scope)にある[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)タイプを参照できます。これにより、security-reviewer や test-runner などの役割を一度定義するだけで、委任されたサブエージェントとしても、エージェントチームのチームメイトとしても再利用できます。

267 267 

268subagent 定義を使用するには、Claude にチームメンバーを生成するよう指示するときに名前で言及してください。268サブエージェント定義を使用するには、Claude にチームメイトの生成を依頼する際にその名前を指定します。

269 269 

270```text wrap theme={null}270```text wrap theme={null}

271Spawn a teammate using the security-reviewer agent type to audit the auth module.271Spawn a teammate using the security-reviewer agent type to audit the auth module.

272```272```

273 273 

274Claude Code は名前を付けた subagent 定義を読み取り、これらの部分をチームメンバーに適用します。部分がチームメンバーの [表示モード](#choose-a-display-mode) に依存する場合、エントリはそのことを示します。274Claude Code は指定されたサブエージェント定義を読み込み、その次の部分をチームメイトに適用します。ある部分がチームメイトの[表示モード](#choose-a-display-mode)に依存する場合は、その項目に記載しています。

275 275 

276* **`tools`**：Claude Code はチームメンバーを定義の `tools` リスト内のツールに制限します。インプロセスチームメンバーの場合、Claude Code はそのリストに `SendMessage` を追加し、[Task ツールを持つセッション](https://code.claude.com/docs/ja/tools-reference.md#task-tool-availability) では `TaskCreate`、`TaskGet`、`TaskList`、および `TaskUpdate` も追加します。276* **`tools`**: Claude Code は、チームメイトが使用できるツールを定義の `tools` リストにあるツールに限定します。インプロセスのチームメイトの場合、Claude Code はそのリストに `SendMessage` を追加し、[Task ツールを持つセッション](https://code.claude.com/docs/ja/tools-reference.md#task-tool-availability)では `TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate` も追加します。

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

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

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

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

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

282* **`skills`**：Claude Code はどちらの表示モードでもチームメンバーに定義の `skills` を適用しません。チームメンバーはプロジェクトおよびユーザー設定から skills をロードします。282* **`skills`**: Claude Code は、どちらの表示モードでも定義の `skills` をチームメイトに適用しません。チームメイトはプロジェクト設定とユーザー設定からスキルを読み込みます。

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

284 284 

285Claude がインプロセスチームメンバーにメッセージを送信し、そのチームメンバーがもう実行されていない場合、Claude Code はそれを同じセッション内に戻し、保存されている会話を復元し、メッセージを次のプロンプトとして提供します。セッションを再開した後、チームメンバーはこの方法では戻されません。[再開の制限](#limitations) に従います。285Claude がすでに実行されていないインプロセスのチームメイトにメッセージを送ると、Claude Code は同じセッション内でそのチームメイトを復帰させ、保存されている会話があれば復元し、そのメッセージを次のプロンプトとして渡します。セッションを再開した後は、[再開に関する制限](#limitations)により、チームメイトはこの方法では復帰しません。

286 286 

287Claude Code が戻すチームメンバーについて、プロジェクトの `.claude/agents/` ディレクトリまたは `--add-dir` ディレクトリから来た定義は、[エージェントファイルが存在するフォルダを信頼している](https://code.claude.com/docs/ja/permissions.md#what-runs-before-you-trust-a-folder) 場合にのみ再適用されます。親フォルダを信頼することはカウントされません。それまで、チームメンバーはすべてのインプロセスチームメンバーに Claude Code が追加するツールのみを保持して、定義のツールまたは指示なしで戻ります。[チームメンバーのエージェント定義が復元されませんでした](https://code.claude.com/docs/ja/errors.md#teammate-agent-definition-not-restored) を参照して、通知テキストを確認してください。287復帰させたチームメイトについて、Claude Code は、プロジェクトの `.claude/agents/` ディレクトリまたは `--add-dir` ディレクトリから取得した定義を、[エージェントファイルがあるフォルダーを信頼](https://code.claude.com/docs/ja/permissions.md#what-runs-before-you-trust-a-folder)している場合にのみ再適用します。親フォルダーを信頼していても対象にはなりません。信頼するまでは、チームメイトは定義のツールや指示を一切持たずに復帰し、Claude Code がすべてのインプロセスのチームメイトに追加するツールのみを保持します。通知テキストについては、[チームメイトのエージェント定義が復元されなかった場合](https://code.claude.com/docs/ja/errors.md#teammate-agent-definition-not-restored)を参照してください。

288 288 

289### 権限289### 権限

290 290 

291チームメンバーはリーダーの権限モードで開始します。ただし、[`dontAsk` モード](https://code.claude.com/docs/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode) は継承しません。リーダーが `--dangerously-skip-permissions` で実行する場合、すべてのチームメンバーも同様に実行します。生成後、個別のチームメンバーの権限モードを変更できますが、生成時にチームメンバーごとの権限モードを設定することはできません。291実行中のチームメイトの権限モードを切り替えるには、[`Shift+Tab`](https://code.claude.com/docs/ja/permission-modes#switch-permission-modes) を押します。ただし、インプロセスのチームメイトは代わりにリーダーのモードで実行される場合があります。分割ペインのチームメイトの場合は、そのペインで押します。[インプロセス](#choose-a-display-mode)のチームメイトの場合は、[そのセッションを表示](#talk-to-teammates-directly)している間に押すと、チームメイトは次のターンを開始する際にモードを確認します。

292 292 

293[インプロセス](#choose-a-display-mode) のチームメイトはリーダーの現在の許可ルールと拒否ルールの下で実行されるため、[`--disallowedTools`](https://code.claude.com/docs/ja/cli-reference#cli-flags)、`--tools`、`--allowedTools` はすべて適用されます。分割ペインのチームメイトについては、フラグごとに確認してください。293> [!NOTE]

294>

295> [plan モード](#have-teammates-plan-before-implementing)ではないインプロセスのチームメイトは、リーダーが [`acceptEdits`](https://code.claude.com/docs/ja/permission-modes#auto-approve-file-edits-with-acceptedits-mode)、[`auto`](https://code.claude.com/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)、または [`bypassPermissions`](https://code.claude.com/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) モードである間、リーダーのモードで実行されます。チームメイトを Manual に切り替えても、ステータスバーに Manual と表示されていても、この動作は変わりません。

296>

297> 編集前に確認を求めるようにするには、エージェントパネルの `main` 行で Enter を押し、リーダーも Manual モードに切り替えてください。これにより、リーダーも確認を求めるようになり、Manual モードの他のチームメイトも同様に確認を求めます。

298 

299生成時にチームメイトごとの権限モードを設定することはできません。新しいチームメイトはリーダーのモードで開始されます。これには、`--dangerously-skip-permissions` によってオンになる `bypassPermissions` モードも含まれます。リーダーが [`dontAsk` モード](https://code.claude.com/docs/ja/permission-modes#allow-only-pre-approved-tools-with-dontask-mode)の場合、チームメイトは代わりに [Manual モード](https://code.claude.com/docs/ja/permission-modes.md#available-modes)で開始されます。

300 

301[インプロセス](#choose-a-display-mode)のチームメイトはリーダーの現在の許可ルールと拒否ルールの下で実行されるため、[`--disallowedTools`](https://code.claude.com/docs/ja/cli-reference#cli-flags)、`--tools`、`--allowedTools` はすべてこのチームメイトに適用されます。分割ペインのチームメイトの場合は、フラグごとに確認してください。

294 302 

295* **`--disallowedTools` と `--tools`**：チームメイトはリーダーのコマンドラインの拒否ルールとツールリストを引き継いで開始します。Claude Code v2.1.309 以降が必要です。303* **`--disallowedTools` と `--tools`**: チームメイトは、リーダーのコマンドラインの拒否ルールとツールリストを持った状態で開始されます。Claude Code v2.1.309 以降が必要です。

296* **`--allowedTools`**：Claude Code はこのフラグを分割ペインのチームメイトに渡さないため、このフラグだけで許可したアクションは分割ペインのチームメイトでは事前承認されません。これらのアクションを事前に承認するには、リーダーを開始するときに [`--settings`](https://code.claude.com/docs/ja/settings#change-a-setting-for-one-session) の `permissions.allow` にルールを記述してください。たとえば、シェルで `claude --settings '{"permissions":{"allow":["Bash(npm *)"]}}'` を実行します。これらのルールは、そのセッションのリーダーと各分割ペインのチームメイトに適用されます。304* **`--allowedTools`**: Claude Code はこのフラグを分割ペインのチームメイトに渡さないため、このフラグだけで許可したアクションは、分割ペインのチームメイトでは事前承認されません。これらのアクションを事前に承認するには、リーダーを開始する際に [`--settings`](https://code.claude.com/docs/ja/settings#change-a-setting-for-one-session) の `permissions.allow` にルールを記述します。たとえば、シェルで `claude --settings '{"permissions":{"allow":["Bash(npm *)"]}}'` を実行します。このルールは、そのセッションのリーダーと各分割ペインのチームメイトに適用されます。

297 305 

298チームメイトの権限プロンプトはリーダーセッションに表示されるため、そこで自分で承認してください。[チームメイトのプラン](#have-teammates-plan-before-implementing) を承認する必要はありません。306チームメイトの権限プロンプトはリーダーのセッションに表示されるため、そこでユーザー自身が承認してください。[チームメイトのプラン](#have-teammates-plan-before-implementing)を承認する必要はありません。

299 307 

300#### エージェント間のメッセージ308#### エージェント間のメッセージ

301 309 

3021 つのエージェントが `SendMessage` 経由で別のエージェントにメッセージを送信する場合、受信エージェントには、あなたからではなく別の Claude セッションから来たことが通知されます。チームメンバーは権限プロンプトを承認したり、あなたに代わって同意を提供したりすることはできません。また、アクションが拒否されたチームメンバーは、チェックをバイパスするために別のチームメンバーにそれをリレーすることはできません。[チーム外の他の Claude Code セッション](https://code.claude.com/docs/ja/cross-session-messaging.md#how-a-session-treats-an-incoming-message) から到着するメッセージにも同じルールが適用されます。310あるエージェントが `SendMessage` を介して別のエージェントにメッセージを送ると、Claude Code は受信側のエージェントに、そのメッセージがユーザーからではなく別の Claude セッションから来たものであることを伝えます。チームメイトはユーザーに代わって権限プロンプトを承認したり同意を与えたりすることはできず、アクションを拒否されたチームメイトがチェックを回避するためにそのアクションを別のチームメイトに中継することもできません。チームの外部にある[ユーザーの他の Claude Code セッションのいずれか](https://code.claude.com/docs/ja/cross-session-messaging.md#how-a-session-treats-an-incoming-message)から届いたメッセージにも、同じルールが適用されます。

303 311 

304[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode) では、分類器はエージェント間のメッセージに 2 つのチェックを適用します。312[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)では、分類器はエージェント間のメッセージに 2 つのチェックを適用します。

305 313 

306* 別のエージェントからリレーされた承認クレームは、あなたからの確認ではなく、信頼できない入力として扱われます。314* 別のエージェントから中継された承認の主張を、ユーザーからの確認ではなく、信頼できない入力として扱います。

307* シャットダウンリクエストやプラン承認応答などの構造化プロトコルメッセージであるかどうかに関わらず、プレーンメッセージであるかどうかに関わらず、各メッセージを Claude Code が配信する前にレビューします。ブロックされたメッセージは受信者に到達することはありません。315* プレーンなメッセージであっても、シャットダウン要求やプラン承認の応答などの構造化プロトコルメッセージであっても、Claude Code が配信する前に各メッセージを確認します。ブロックされたメッセージが受信者に届くことはありません。

308 316 

309### コンテキストと通信317### コンテキストと通信

310 318 

311各チームメンバーは独自のコンテキストウィンドウを持っています。生成されると、チームメンバーは通常のセッションと同じプロジェクトコンテキストをロードします。CLAUDE.md、MCP サーバー、および skills。[`--setting-sources`](https://code.claude.com/docs/ja/cli-reference#cli-flags) でリーダーを開始する場合、チームメンバーは同じ制限されたソースリストからロードします。v2.1.281 より前では、[分割ペイン](#choose-a-display-mode) チームメンバーはすべての設定ソースをロードしていました。319各チームメイトは独自のコンテキストウィンドウを持ちます。生成されると、チームメイトは通常のセッションと同じプロジェクトコンテキスト（CLAUDE.md、MCP サーバー、スキル）を読み込みます。[`--setting-sources`](https://code.claude.com/docs/ja/cli-reference#cli-flags) を指定してリーダーを開始した場合、チームメイトも同じ制限されたソースのリストから読み込みます。v2.1.281 より前は、[分割ペイン](#choose-a-display-mode)のチームメイトはすべての設定ソースを読み込んでいました。

312 320 

313チームメンバーはまた、リーダーからの生成プロンプトを受け取ります。リーダーの会話履歴は引き継がれません。321チームメイトはリーダーから生成プロンプトも受け取ります。リーダーの会話履歴は引き継がれません。

314 322 

315**チームメンバーが情報を共有する方法：**323**チームメイトが情報を共有する方法:**

316 324 

317* **自動メッセージ配信**：チームメンバーがメッセージを送信すると、受信者に自動的に配信されます。リーダーは更新をポーリングする必要はありません。325* **メッセージの自動配信**: チームメイトがメッセージを送信すると、受信者に自動的に配信されます。リーダーが更新をポーリングする必要はありません。

318* **アイドル通知**：チームメンバーが完了して停止すると、リーダーに自動的に通知し、最終的な回答を通知に含めます。ターンが API エラーで終了するチームメンバーは、リーダーに失敗したことを通知し、エラーテキストを含めます。326* **アイドル通知**: チームメイトは作業を終えて停止すると、自動的にリーダーに通知し、その通知に最終的な回答を含めます。API エラーでターンが終了したチームメイトは、失敗したことをリーダーに通知し、エラーテキストを含めます。

319* **共有タスクリスト**：[Task ツールを持つエージェント](https://code.claude.com/docs/ja/tools-reference.md#task-tool-availability) はタスクステータスを表示でき、利用可能な作業を要求できます。327* **共有タスクリスト**: [Task ツールを持つエージェント](https://code.claude.com/docs/ja/tools-reference.md#task-tool-availability)は、タスクのステータスを確認し、引き受け可能な作業を引き受けることができます。

320* **チームメンバーメッセージング**：その名前で特定のチームメンバーにメッセージを送信します。全員に到達するには、受信者ごとに 1 つのメッセージを送信してください。328* **チームメイトへのメッセージ送信**: 特定のチームメイト 1 人に名前を指定してメッセージを送信します。全員に届けるには、受信者ごとに 1 通ずつメッセージを送信します。

321 329 

322リーダーは生成時に各チームメンバーに名前を割り当て、任意のチームメンバーはその名前で他のチームメンバーにメッセージを送信できます。後のプロンプトで参照できる予測可能な名前を取得するには、生成指示でリーダーに各チームメンバーを何と呼ぶかを指示してください。330リーダーはチームメイトを生成する際に全員に名前を割り当て、どのチームメイトもその名前で他のチームメイトにメッセージを送ることができます。後のプロンプトで参照できる予測可能な名前にするには、生成の指示の中で各チームメイトを何と呼ぶかをリーダーに伝えてください。

323 331 

324### トークン使用量332### トークン使用量

325 333 

326エージェントチームは単一セッションよりも大幅に多くのトークンを使用します。各チームメンバーは独自のコンテキストウィンドウを持ち、トークン使用量はアクティブなチームメンバーの数でスケールします。調査、レビュー、および新機能作業の場合、追加のトークンは通常価値があります。ルーチンタスクの場合、単一セッションがより費用効果的です。使用ガイダンスについては、[エージェントチームトークンコスト](https://code.claude.com/docs/ja/costs.md#agent-team-token-costs) を参照してください。334エージェントチームは、単一のセッションよりも大幅に多くのトークンを使用します。各チームメイトは独自のコンテキストウィンドウを持ち、トークン使用量はアクティブなチームメイトの数に比例して増加します。調査、レビュー、新機能の開発では、通常、追加のトークンに見合う価値があります。日常的なタスクでは、単一のセッションの方が費用対効果に優れています。使用量のガイダンスについては、[エージェントチームのトークンコスト](https://code.claude.com/docs/ja/costs.md#agent-team-token-costs)を参照してください。

327 335 

328インプロセスチームメンバーのリクエストはメイン会話の [キャッシュ TTL バケット](https://code.claude.com/docs/ja/prompt-caching.md#which-ttl-each-request-gets) の外にあるため、Claude サブスクリプションを含め、デフォルトで 5 分間キャッシュが保持されます。1 時間保持するには、[`subagentPromptCacheTtl`](https://code.claude.com/docs/ja/settings-reference#subagentpromptcachettl) を `1h` に設定してください。API は 1 時間のキャッシュ書き込みをより高いレートで請求します。336インプロセスのチームメイトのリクエストはメインの会話の[キャッシュ TTL バケット](https://code.claude.com/docs/ja/prompt-caching.md#which-ttl-each-request-gets)の対象外となるため、Claude サブスクリプションを利用している場合も含め、そのキャッシュはデフォルトで 5 分間保持されます。1 時間保持するには、[`subagentPromptCacheTtl`](https://code.claude.com/docs/ja/settings-reference#subagentpromptcachettl) を `1h` に設定してください。API では、1 時間のキャッシュ書き込みはより高い料金で課金されます。

329 337 

330## ユースケース例338## ユースケース例

331 339 

488* **ネストされたチーム非対応**: teammates は独自の teammates をスポーンできません。lead のみがチームを管理できます。496* **ネストされたチーム非対応**: teammates は独自の teammates をスポーンできません。lead のみがチームを管理できます。

489* **インプロセスのチームメイトからのバックグラウンドサブエージェント非対応**: インプロセスのチームメイト自身のサブエージェントはフォアグラウンドで実行されます。これはチームメイトのバックグラウンド作業がチームリーダーのプロセスより長く存続できないためです。Claude Code は、チームメイトが `background: true` を設定する定義を持つサブエージェントをスポーンする場合、エラーを返します。チームメイトの `run_in_background: true` リクエストも失敗し、エラーが発生するか、フォアグラウンドで静かに実行されます。メイン会話から起動されたサブエージェントは[バックグラウンドのデフォルト](https://code.claude.com/docs/ja/sub-agents.md#run-subagents-in-foreground-or-background)に従います。497* **インプロセスのチームメイトからのバックグラウンドサブエージェント非対応**: インプロセスのチームメイト自身のサブエージェントはフォアグラウンドで実行されます。これはチームメイトのバックグラウンド作業がチームリーダーのプロセスより長く存続できないためです。Claude Code は、チームメイトが `background: true` を設定する定義を持つサブエージェントをスポーンする場合、エラーを返します。チームメイトの `run_in_background: true` リクエストも失敗し、エラーが発生するか、フォアグラウンドで静かに実行されます。メイン会話から起動されたサブエージェントは[バックグラウンドのデフォルト](https://code.claude.com/docs/ja/sub-agents.md#run-subagents-in-foreground-or-background)に従います。

490* **Lead は固定**: メインセッションはその存続期間中、lead です。teammate を lead に昇格させたり、リーダーシップを譲渡したりすることはできません。498* **Lead は固定**: メインセッションはその存続期間中、lead です。teammate を lead に昇格させたり、リーダーシップを譲渡したりすることはできません。

491* **権限はスポーン時に設定**: teammates は[権限](#permissions)の下で説明されている権限モードで開始します。スポーン後に個別の teammate の権限モードを変更できますが、スポーン時に teammate ごとの権限モードを設定することはできません。499* **スポーン時のチームメイトごとの権限モード設定非対応**: チームメイトは[権限](#permissions)で説明されている権限モードで開始します。

492* **分割ペインは tmux または iTerm2 が必要**: デフォルトのインプロセスモードはすべてのターミナルで機能します。分割ペインモードは VS Code の統合ターミナル、Windows Terminal、または Ghostty ではサポートされていません。500* **分割ペインは tmux または iTerm2 が必要**: デフォルトのインプロセスモードはすべてのターミナルで機能します。分割ペインモードは VS Code の統合ターミナル、Windows Terminal、または Ghostty ではサポートされていません。

493 501 

494## 次のステップ502## 次のステップ

442 442 

443`/background` またはそのエイリアス `/bg` を実行すると、現在の会話がバックグラウンドセッションに移動します。`/bg run the test suite and fix any failures` のようにプロンプトを渡すと、先にもう 1 つ指示を与えられます。`/bg` の実行時に Claude が応答中の場合、応答はバックグラウンドセッションで続行されます。443`/background` またはそのエイリアス `/bg` を実行すると、現在の会話がバックグラウンドセッションに移動します。`/bg run the test suite and fix any failures` のようにプロンプトを渡すと、先にもう 1 つ指示を与えられます。`/bg` の実行時に Claude が応答中の場合、応答はバックグラウンドセッションで続行されます。

444 444 

445サブエージェント、バックグラウンドシェルコマンド、ワークフロー、[モニター](https://code.claude.com/docs/ja/tools-reference.md#monitor-tool) などのバックグラウンド作業がまだ実行中のセッションを終了しようとすると、すぐに終了する代わりに `Background work is running` ダイアログが表示されます。`Move to background and exit` を選択すると、`/background` と同じ方法でセッションをバックグラウンドに移動してシェルに戻ります。エージェントビューが [オフになっている](#turn-off-agent-view) 場合、このオプションは表示されません。445サブエージェントやワークフローなど、特定の種類のバックグラウンド作業が実行中にセッションを終了すると、`Background work is running` ダイアログが表示され、その作業が停止することを警告します。`Move to background and exit` を選択すると、`/background` と同じ方法でセッションをバックグラウンドに移動してシェルに戻ります。エージェントビューが [オフになっている](#turn-off-agent-view) 場合、このオプションは表示されません。

446 446 

447リスト上のバックグラウンドセッションが既にその会話の名前を持っている場合、Claude Code は新しい行の名前に `my-session (2)` のような番号を付け、既存の行の名前はそのままにします。新しい行の名前を変更するには、エージェントビューでその行を選択して `Ctrl+R` を押します。447リスト上のバックグラウンドセッションが既にその会話の名前を持っている場合、Claude Code は新しい行の名前に `my-session (2)` のような番号を付け、既存の行の名前はそのままにします。新しい行の名前を変更するには、エージェントビューでその行を選択して `Ctrl+R` を押します。

448 448 

315* [管理設定](https://code.claude.com/docs/ja/managed-settings.md)の `env` ブロック内のピン315* [管理設定](https://code.claude.com/docs/ja/managed-settings.md)の `env` ブロック内のピン

316* [アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile) を指すピン（管理者が管理しているため）316* [アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile) を指すピン（管理者が管理しているため）

317 317 

318管理設定のピンについて更新の促しが引き続き表示される場合は、Claude Code を v2.1.314 以降に更新してください。v2.1.314 より前では、受け入れた後も管理設定のピンが有効なままだったため、次回の起動時に再び促しが表示されていました。

319 

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

319 321 

322### 特定のモデルでセッションを開始する

323 

320特定の Sonnet または Opus バージョンでセッションを開始する場合（例えば `--model`、`ANTHROPIC_MODEL`、または[`model` 設定](https://code.claude.com/docs/ja/settings-reference#model)を使用）、そのバージョンは一致する `sonnet` または `opus` エイリアスのセッションのピン留めされたデフォルトとして機能します。Claude Code は、設定したモデルが置き換える組み込みデフォルトの可用性チェックをスキップし、設定したモデルで起動し、フォールバック通知はありません。324特定の Sonnet または Opus バージョンでセッションを開始する場合（例えば `--model`、`ANTHROPIC_MODEL`、または[`model` 設定](https://code.claude.com/docs/ja/settings-reference#model)を使用）、そのバージョンは一致する `sonnet` または `opus` エイリアスのセッションのピン留めされたデフォルトとして機能します。Claude Code は、設定したモデルが置き換える組み込みデフォルトの可用性チェックをスキップし、設定したモデルで起動し、フォールバック通知はありません。

321 325 

322次のものでセッションを開始しても、ピンとしては機能しません。326次のものでセッションを開始しても、ピンとしては機能しません。

324* `opus` などのモデルエイリアス328* `opus` などのモデルエイリアス

325* Claude Code が認識しないモデル ID（アプリケーション推論プロファイル ARN など）329* Claude Code が認識しないモデル ID（アプリケーション推論プロファイル ARN など）

326 330 

327これらのチェックがアカウントが呼び出せないモデルを見つけた場合、Claude Code はこのマシンで最大 1 日間その拒否を記憶し、その時間中は Amazon Bedrock に再度問い合わせることなく記憶されたモデルをスキップして起動します。Claude Code は、現在のデフォルトモデルの記憶された拒否を、最後のチェック以降 10 分が経過すると起動時に再度チェックするため、管理者が再度有効にしたデフォルトが戻ります。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/ja/env-vars)を設定してください。331### 記憶されたモデルの拒否

332 

333スタートアップモデルチェックでアカウントが呼び出せないモデルが見つかった場合、Claude Code はこのマシンで最大 1 日間その拒否を記憶できます。最後のチェックから 10 分が経過すると、Claude Code は現在のデフォルトモデルについて記憶された拒否を起動時に再度チェックします。これにより、管理者が再度有効にしたデフォルトが戻ります。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/ja/env-vars)を設定してください。

328 334 

329### 組織がモデルの許可リストを強制する場合335### 組織がモデルの許可リストを強制する場合

330 336 

458 464 

459## AWS Guardrails465## AWS Guardrails

460 466 

461[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html)を使用すると、Claude Code のコンテンツフィルタリングを実装できます。[Amazon Bedrock コンソール](https://console.aws.amazon.com/bedrock/)で Guardrail を作成し、バージョンを公開してから、Guardrail ヘッダーを [settings file](https://code.claude.com/docs/ja/settings.md) に追加します。クロスリージョン推論プロファイルを使用している場合は、Guardrail でクロスリージョン推論を有効にしてください。467[Amazon Bedrock Guardrails](https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html)を使用すると、Claude Code のコンテンツフィルタリングを実装できます。[Amazon Bedrock コンソール](https://console.aws.amazon.com/bedrock/)で Guardrail を作成し、バージョンを公開します。クロスリージョン推論プロファイルを使用している場合は、Guardrail でクロスリージョン推論を有効にしてください。

462 468 

463設定例：469[Claude apps gateway](https://code.claude.com/docs/ja/claude-apps-gateway) を通じて Guardrail を適用するには、[Amazon Bedrock guardrail を適用する](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#apply-an-amazon-bedrock-guardrail)の手順に従ってください。Claude apps gateway を使用しない場合は、Guardrail ヘッダーを[設定ファイル](https://code.claude.com/docs/ja/settings.md)に追加します。

470 

471設定ファイルの設定例：

464 472 

465```json theme={null}473```json theme={null}

466{474{

470}478}

471```479```

472 480 

473組織が [Claude apps gateway](https://code.claude.com/docs/ja/claude-apps-gateway) ポリシーを通じて guardrail ヘッダーを配信する場合、それらは [承認が必要な設定](https://code.claude.com/docs/ja/server-managed-settings.md#environment-variables-and-the-approval-dialog)としてカウントされます。

474 

475guardrail が応答を途中でブロックした場合、それまでにストリーミングされたテキストはそのまま残り、応答はブロックされた応答用に guardrail で設定されたメッセージで終了します。481guardrail が応答を途中でブロックした場合、それまでにストリーミングされたテキストはそのまま残り、応答はブロックされた応答用に guardrail で設定されたメッセージで終了します。

476 482 

477## Mantle エンドポイントを使用する483## Mantle エンドポイントを使用する

2512. `ANTHROPIC_AUTH_TOKEN` 環境変数。`Authorization: Bearer` ヘッダーとして送信されます。Anthropic API キーではなくベアラートークンで認証する [LLM ゲートウェイまたはプロキシ](https://code.claude.com/docs/ja/llm-gateway)を通じてルーティングする場合に使用します。2512. `ANTHROPIC_AUTH_TOKEN` 環境変数。`Authorization: Bearer` ヘッダーとして送信されます。Anthropic API キーではなくベアラートークンで認証する [LLM ゲートウェイまたはプロキシ](https://code.claude.com/docs/ja/llm-gateway)を通じてルーティングする場合に使用します。

2523. `ANTHROPIC_API_KEY` 環境変数。`X-Api-Key` ヘッダーとして送信されます。[Claude Console](https://platform.claude.com) からのキーを使用して Anthropic API に直接アクセスする場合に使用します。対話モードでは、キーを承認または拒否するよう 1 回プロンプトが表示され、選択が記憶されます。後で変更するには、`/config` の「Use custom API key」トグルを使用します。トグルは `ANTHROPIC_API_KEY` が環境に設定されている間のみ表示されます。非対話モード（`-p`）では、キーが存在する場合は常に使用されます。2523. `ANTHROPIC_API_KEY` 環境変数。`X-Api-Key` ヘッダーとして送信されます。[Claude Console](https://platform.claude.com) からのキーを使用して Anthropic API に直接アクセスする場合に使用します。対話モードでは、キーを承認または拒否するよう 1 回プロンプトが表示され、選択が記憶されます。後で変更するには、`/config` の「Use custom API key」トグルを使用します。トグルは `ANTHROPIC_API_KEY` が環境に設定されている間のみ表示されます。非対話モード（`-p`）では、キーが存在する場合は常に使用されます。

2534. [`apiKeyHelper`](https://code.claude.com/docs/ja/settings-reference#apikeyhelper) スクリプト出力。動的または回転する認証情報（ボルトから取得した短期トークンなど）に使用します。2534. [`apiKeyHelper`](https://code.claude.com/docs/ja/settings-reference#apikeyhelper) スクリプト出力。動的または回転する認証情報（ボルトから取得した短期トークンなど）に使用します。

2545. `CLAUDE_CODE_OAUTH_TOKEN` 環境変数。[`claude setup-token`](#generate-a-long-lived-token) によって生成された長期 OAuth トークン。ブラウザログインが利用できない CI パイプラインとスクリプトに使用します。この変数が設定されている間に `/login` を実行すると、Claude Code は現在のセッションを新しいログインに切り替えますが、シェルプロファイルまたは[設定ファイル](https://code.claude.com/docs/ja/settings.md)の `env` ブロックから変数を削除するまで、新しいセッションのたびに変数を再度読み込みます。2545. `CLAUDE_CODE_OAUTH_TOKEN` 環境変数。[`claude setup-token`](#generate-a-long-lived-token) によって生成された長期 OAuth トークン。ブラウザログインが利用できない CI パイプラインとスクリプトに使用します。この変数が設定されている間に `/login` を実行すると、Claude Code は現在のセッションを新しいログインに切り替えます。新しいセッションでもそのログインを維持するには、シェルプロファイルと、ユーザー設定など[この変数を設定できる設定ファイル](https://code.claude.com/docs/ja/settings-reference.md#variables-claude-code-ignores-in-env)から変数を削除してください。

2556. Anthropic プロファイルおよびフェデレーション認証情報。`ant` CLI および Workload Identity Federation が使用する認証情報。`ant auth login` が書き込んだプロファイルは、`ANTHROPIC_PROFILE` で名前を付けた場合にのみここにランク付けされます。そうでない場合は `/login` より下にランク付けされます。[Anthropic プロファイルおよびフェデレーション認証情報](#anthropic-profiles-and-federation-credentials)を参照してください。2556. Anthropic プロファイルおよびフェデレーション認証情報。`ant` CLI および Workload Identity Federation が使用する認証情報。`ant auth login` が書き込んだプロファイルは、`ANTHROPIC_PROFILE` で名前を付けた場合にのみここにランク付けされます。そうでない場合は `/login` より下にランク付けされます。[Anthropic プロファイルおよびフェデレーション認証情報](#anthropic-profiles-and-federation-credentials)を参照してください。

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

257 257 

603>603>

604> `claude -p --worktree` の実行は確認せずに終了するため、自分でクリーンアップする必要があります。`git worktree remove <path>` で削除し、worktree がロックされているために git が拒否する場合は、先に `git worktree unlock <path>` を実行します。604> `claude -p --worktree` の実行は確認せずに終了するため、自分でクリーンアップする必要があります。`git worktree remove <path>` で削除し、worktree がロックされているために git が拒否する場合は、先に `git worktree unlock <path>` を実行します。

605 605 

606多数のファイルにわたる 1 つの大きな機械的変更には、[`/batch migrate every handler to the v2 response helpers`](https://code.claude.com/docs/ja/commands) が作業を 5～30 個の単位に分割し、計画を表示します。その後、各単位を専用の worktree で実行し、それぞれについて PR を作成します。シェルからは、[`claude agents`](https://code.claude.com/docs/ja/agent-view)（まだリサーチプレビュー）で、マシン上のバックグラウンドで実行中のすべてを 1 つの画面で確認できます。606多数のファイルにわたる 1 つの大きな機械的変更には、[`/batch migrate every handler to the v2 response helpers`](https://code.claude.com/docs/ja/commands) が作業を 5～30 個の単位に分割し、計画を表示します。計画を承認すると、各単位に専用の worktree が割り当てられ、PR を作成するか、何が起きたかを報告します。シェルからは、[`claude agents`](https://code.claude.com/docs/ja/agent-view)（まだリサーチプレビュー）で、マシン上のバックグラウンドで実行中のすべてを 1 つの画面で確認できます。

607 607 

6082 つ目のセッションは、手に入る中で最も手軽な独立レビュアーでもあります。一方のセッションがレートリミッターを書き、もう一方が書かれる過程を見ずに `@src/middleware/rateLimiter.ts` をレビューし、その指摘を最初のセッションに貼り付けます。`/code-review` と同じ考え方で、メッセージの受け渡しをユーザーが行う形です。6082 つ目のセッションは、手に入る中で最も手軽な独立レビュアーでもあります。一方のセッションがレートリミッターを書き、もう一方が書かれる過程を見ずに `@src/middleware/rateLimiter.ts` をレビューし、その指摘を最初のセッションに貼り付けます。`/code-review` と同じ考え方で、メッセージの受け渡しをユーザーが行う形です。

609 609 

85| `--desktop` | [Claude Desktop アプリ](https://code.claude.com/docs/ja/desktop.md)を現在のディレクトリで開き、ターミナルでセッションを開始せずに終了します。`--continue` を追加するか、セッション ID を使用して `--resume` を追加して、[代わりに Desktop でそのセッションを開く](https://code.claude.com/docs/ja/desktop.md#coming-from-the-cli)ことができます。ここで `--resume` はセッション ID のみを取り、名前またはトランスクリプトパスは取りません。プロンプトと `--verbose` および `--debug` フラグ以外の他のフラグは取りません。アプリがセッション自体を開始するため。macOS および x64 Windows で Claude サブスクリプションでサインインしている場合に利用可能です。Claude Code v2.1.285 以降が必要です | `claude --desktop` |85| `--desktop` | [Claude Desktop アプリ](https://code.claude.com/docs/ja/desktop.md)を現在のディレクトリで開き、ターミナルでセッションを開始せずに終了します。`--continue` を追加するか、セッション ID を使用して `--resume` を追加して、[代わりに Desktop でそのセッションを開く](https://code.claude.com/docs/ja/desktop.md#coming-from-the-cli)ことができます。ここで `--resume` はセッション ID のみを取り、名前またはトランスクリプトパスは取りません。プロンプトと `--verbose` および `--debug` フラグ以外の他のフラグは取りません。アプリがセッション自体を開始するため。macOS および x64 Windows で Claude サブスクリプションでサインインしている場合に利用可能です。Claude Code v2.1.285 以降が必要です | `claude --desktop` |

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

87| `--disallowedTools`, `--disallowed-tools` | 拒否ルール。ベアツール名は一致するツールを Claude のコンテキストから削除します。`"Edit"` は Edit を削除し、`"*"` はすべてのツールを削除し、`"mcp__*"` はすべての MCP ツールを削除します。`Bash(rm *)` などのスコープ付きルールはツールを利用可能なままにし、[書かれたとおりに](https://code.claude.com/docs/ja/permissions.md#bash-rule-limits)一致する呼び出しのみを拒否します。[`EndConversation`](https://code.claude.com/docs/ja/tools-reference#endconversation-tool-behavior)という名前のルールは、他のツールが残っている間はそれを削除できません | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |87| `--disallowedTools`, `--disallowed-tools` | 拒否ルール。ベアツール名は一致するツールを Claude のコンテキストから削除します。`"Edit"` は Edit を削除し、`"*"` はすべてのツールを削除し、`"mcp__*"` はすべての MCP ツールを削除します。`Bash(rm *)` などのスコープ付きルールはツールを利用可能なままにし、[書かれたとおりに](https://code.claude.com/docs/ja/permissions.md#bash-rule-limits)一致する呼び出しのみを拒否します。[`EndConversation`](https://code.claude.com/docs/ja/tools-reference#endconversation-tool-behavior)という名前のルールは、他のツールが残っている間はそれを削除できません | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

88| `--effort` | 現在のセッションの[努力レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)を設定します。オプション：`low`、`medium`、`high`、`xhigh`、`max`、または `ultracode`。利用可能なレベルはモデルによって異なります。`ultracode` は [ultracode](https://code.claude.com/docs/ja/workflows.md#let-claude-decide-with-ultracode) をオンにして `xhigh` 努力をリクエストし、Claude Code v2.1.203 以降が必要です。このセッションの [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings) と [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) 設定をオーバーライドし、保持されません | `claude --effort high` |88| `--effort` | 現在のセッションの [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)を設定します。オプション：`low`、`medium`、`high`、`xhigh`、`max`、または `ultracode`。利用可能なレベルはモデルによって異なります。`ultracode` は [ultracode](https://code.claude.com/docs/ja/workflows.md#let-claude-decide-with-ultracode) をオンにして `xhigh` effort を要求し、Claude Code v2.1.203 以降が必要です。メイン会話のモデルでは、このセッションの [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings) と [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) 設定を上書きし、保持されません | `claude --effort high` |

89| `--enable-auto-mode` | v2.1.111 で削除されました。オートモードはデフォルトで `Shift+Tab` サイクルに含まれるようになりました。`--permission-mode auto` を使用して開始します | `claude --permission-mode auto` |89| `--enable-auto-mode` | v2.1.111 で削除されました。オートモードはデフォルトで `Shift+Tab` サイクルに含まれるようになりました。`--permission-mode auto` を使用して開始します | `claude --permission-mode auto` |

90| `--environment <environment-id>` | 指定された ID の[自己ホスト環境](https://code.claude.com/docs/ja/self-hosted-environments)で実行される新しいクラウドセッションを作成します。環境 ID は `ccpool_` で始まります。ディスパッチ動作とそれが拒否するフラグの組み合わせについては、[`--environment` ディスパッチ動作](https://code.claude.com/docs/ja/self-hosted-environments-testing#environment-dispatch-behavior)を参照してください。Claude Code v2.1.224 以降が必要です | `claude -p "Fix the login bug" --environment ccpool_abc123` |90| `--environment <environment-id>` | 指定された ID の[自己ホスト環境](https://code.claude.com/docs/ja/self-hosted-environments)で実行される新しいクラウドセッションを作成します。環境 ID は `ccpool_` で始まります。ディスパッチ動作とそれが拒否するフラグの組み合わせについては、[`--environment` ディスパッチ動作](https://code.claude.com/docs/ja/self-hosted-environments-testing#environment-dispatch-behavior)を参照してください。Claude Code v2.1.224 以降が必要です | `claude -p "Fix the login bug" --environment ccpool_abc123` |

91| `--exclude-dynamic-system-prompt-sections` | ユーザーごとのコンテキスト（自動メモリの場所など）をシステムプロンプトから最初のユーザーメッセージに移動します。異なるユーザーとマシンで同じタスクを実行する場合、プロンプトキャッシュの再利用を改善します。デフォルトシステムプロンプトでのみ適用されます。`--system-prompt` または `--system-prompt-file` が設定されている場合は無視されます。スクリプト化された、マルチユーザーワークロードで `-p` を使用します | `claude -p --exclude-dynamic-system-prompt-sections "query"` |91| `--exclude-dynamic-system-prompt-sections` | ユーザーごとのコンテキスト（自動メモリの場所など）をシステムプロンプトから最初のユーザーメッセージに移動します。異なるユーザーとマシンで同じタスクを実行する場合、プロンプトキャッシュの再利用を改善します。デフォルトシステムプロンプトでのみ適用されます。`--system-prompt` または `--system-prompt-file` が設定されている場合は無視されます。スクリプト化された、マルチユーザーワークロードで `-p` を使用します | `claude -p --exclude-dynamic-system-prompt-sections "query"` |

33 33 

34**2. 作業を続ける**34**2. 作業を続ける**

35 35 

36レビューは独自のコンテキストウィンドウを持つバックグラウンドの[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)として実行されるため、会話を圧迫しません。指摘事項はレビューが完了すると会話に届きます。36ターミナルセッションでは、レビューは独自のコンテキストウィンドウを持つバックグラウンドの[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md)として実行されるため、会話を圧迫しません。指摘事項はレビューが完了すると会話に届きます。

37 37 

38**3. 指摘事項に対応する**38**3. 指摘事項に対応する**

39 39 

59| `/autocompact [auto\|<tokens>]` | 自動圧縮ウィンドウを設定します：Claude Code が自動的に圧縮する前にコンテキストウィンドウがどのくらい満杯になるかです。`500k` などのサイズを渡すか、`auto` を渡してモデル用に調整されたウィンドウに戻します。Claude Code は値をユーザー設定に保存し、現在のセッションに適用します。受け入れられる値と何がそれを上書きするかについては、[自動圧縮ウィンドウを設定する](https://code.claude.com/docs/ja/model-config.md#set-the-auto-compact-window)を参照してください。引数がない場合、現在のウィンドウを表示するダイアログが開きます。Claude Code v2.1.221 以降が必要です |59| `/autocompact [auto\|<tokens>]` | 自動圧縮ウィンドウを設定します：Claude Code が自動的に圧縮する前にコンテキストウィンドウがどのくらい満杯になるかです。`500k` などのサイズを渡すか、`auto` を渡してモデル用に調整されたウィンドウに戻します。Claude Code は値をユーザー設定に保存し、現在のセッションに適用します。受け入れられる値と何がそれを上書きするかについては、[自動圧縮ウィンドウを設定する](https://code.claude.com/docs/ja/model-config.md#set-the-auto-compact-window)を参照してください。引数がない場合、現在のウィンドウを表示するダイアログが開きます。Claude Code v2.1.221 以降が必要です |

60| `/autofix-pr [prompt]` | 現在のブランチの PR を監視し、CI が失敗するか、レビュアーがコメントを残すと修正をプッシュする[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#auto-fix-pull-requests)を生成します。`gh pr view` で現在チェックアウトされているブランチから開いている PR を検出します。別の PR を監視するには、最初にそのブランチをチェックアウトします。デフォルトでは、クラウドセッションはすべての CI 失敗とレビューコメントを修正するよう指示されます。別の指示を与えるためにプロンプトを渡します。たとえば `/autofix-pr only fix lint and type errors`。`gh` CLI と[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)へのアクセスが必要です |60| `/autofix-pr [prompt]` | 現在のブランチの PR を監視し、CI が失敗するか、レビュアーがコメントを残すと修正をプッシュする[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#auto-fix-pull-requests)を生成します。`gh pr view` で現在チェックアウトされているブランチから開いている PR を検出します。別の PR を監視するには、最初にそのブランチをチェックアウトします。デフォルトでは、クラウドセッションはすべての CI 失敗とレビューコメントを修正するよう指示されます。別の指示を与えるためにプロンプトを渡します。たとえば `/autofix-pr only fix lint and type errors`。`gh` CLI と[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)へのアクセスが必要です |

61| `/background [prompt]` | 現在のセッションをデタッチして[バックグラウンドエージェント](https://code.claude.com/docs/ja/agent-view.md)として実行し、このターミナルを解放します。デタッチする前に別の指示を送るためにプロンプトを渡します。`claude agents` でセッションを監視します。このセッションが実行し続けている間に会話を新しいバックグラウンドセッションにコピーするには、`/fork` を使用します。エイリアス：`/bg` |61| `/background [prompt]` | 現在のセッションをデタッチして[バックグラウンドエージェント](https://code.claude.com/docs/ja/agent-view.md)として実行し、このターミナルを解放します。デタッチする前に別の指示を送るためにプロンプトを渡します。`claude agents` でセッションを監視します。このセッションが実行し続けている間に会話を新しいバックグラウンドセッションにコピーするには、`/fork` を使用します。エイリアス：`/bg` |

62| `/batch <instruction>` | **[Skill](https://code.claude.com/docs/ja/skills.md#bundled-skills).** コードベース全体で大規模な変更を並列に調整します。コードベースを調査し、作業を 5 ～ 30 個の独立したユニットに分解し、計画を提示します。承認されると、分離された [worktree](https://code.claude.com/docs/ja/worktrees.md) 内でユニットごとに 1 つの[バックグラウンドサブエージェント](https://code.claude.com/docs/ja/sub-agents.md#run-subagents-in-foreground-or-background)を生成します。各サブエージェントはそのユニットを実装し、テストを実行し、その変更を公開します。git リポジトリまたは worktree を作成する [`WorktreeCreate` フック](https://code.claude.com/docs/ja/worktrees#non-git-version-control)が必要です。git リポジトリの外では、`/batch` には Claude Code v2.1.281 以降が必要です。例：`/batch migrate src/ from JavaScript to TypeScript` |62| `/batch <instruction>` | **[Skill](https://code.claude.com/docs/ja/skills.md#bundled-skills).** コードベース全体で大規模な変更を並列に調整します。コードベースを調査し、作業を 5 ～ 30 個の独立したユニットに分解し、計画を提示します。承認されると、分離された [worktree](https://code.claude.com/docs/ja/worktrees.md) 内でユニットごとに 1 つの[バックグラウンドサブエージェント](https://code.claude.com/docs/ja/sub-agents.md#run-subagents-in-foreground-or-background)を生成します。各サブエージェントはそのユニットを実装し、テストを実行し、PR を開くか、何が起きたかを報告します。git リポジトリまたは worktree を作成する [`WorktreeCreate` フック](https://code.claude.com/docs/ja/worktrees#non-git-version-control)が必要です。git リポジトリの外では、`/batch` には Claude Code v2.1.281 以降が必要です。例：`/batch migrate src/ from JavaScript to TypeScript` |

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

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

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

335| `CLAUDE_CODE_NONBLOCKING_STDOUT` | `1` に設定すると、ターミナル出力を 2 つ目のノンブロッキングファイルディスクリプタ経由で書き込みます。これにより、一時停止した tmux コントロールモードのペインや停止した SSH 接続など、読み取りを停止したターミナルによって Claude Code がセッションの途中でフリーズすることがなくなります。stdout がターミナルである場合に、macOS、Linux、WSL で適用されます。Claude Code v2.1.261 以降が必要です |335| `CLAUDE_CODE_NONBLOCKING_STDOUT` | `1` に設定すると、ターミナル出力を 2 つ目のノンブロッキングファイルディスクリプタ経由で書き込みます。これにより、一時停止した tmux コントロールモードのペインや停止した SSH 接続など、読み取りを停止したターミナルによって Claude Code がセッションの途中でフリーズすることがなくなります。stdout がターミナルである場合に、macOS、Linux、WSL で適用されます。Claude Code v2.1.261 以降が必要です |

336| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | タイムアウトした [非ストリーミングリクエスト](https://code.claude.com/docs/ja/errors.md#streaming-response-ended-before-any-complete-data-was-received) を Claude Code が再送信する回数を制限します。`0` の場合、最初のタイムアウトでリクエストは失敗します。タイムアウトについては [再試行の動作を調整する](https://code.claude.com/docs/ja/errors.md#tune-retry-behavior) を参照してください。Claude Code v2.1.285 以降が必要です |336| `CLAUDE_CODE_NONSTREAMING_TIMEOUT_RETRIES` | タイムアウトした [非ストリーミングリクエスト](https://code.claude.com/docs/ja/errors.md#streaming-response-ended-before-any-complete-data-was-received) を Claude Code が再送信する回数を制限します。`0` の場合、最初のタイムアウトでリクエストは失敗します。タイムアウトについては [再試行の動作を調整する](https://code.claude.com/docs/ja/errors.md#tune-retry-behavior) を参照してください。Claude Code v2.1.285 以降が必要です |

337| `CLAUDE_CODE_NO_FLICKER` | `1` に設定すると、ちらつきを減らし、長い会話でもメモリ使用量を一定に保つリサーチプレビューである [フルスクリーンレンダリング](https://code.claude.com/docs/ja/fullscreen.md) を有効にします。[`tui`](https://code.claude.com/docs/ja/settings-reference#tui) 設定を上書きします。`/tui fullscreen` で切り替えることもできます |337| `CLAUDE_CODE_NO_FLICKER` | `1` に設定すると、ちらつきを減らし、長い会話でもメモリ使用量を一定に保つリサーチプレビューである [フルスクリーンレンダリング](https://code.claude.com/docs/ja/fullscreen.md) を有効にします。[`tui`](https://code.claude.com/docs/ja/settings-reference#tui) 設定を上書きします。`/tui fullscreen` で切り替えることもできます |

338| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | Claude.ai 認証用の OAuth リフレッシュトークン。設定すると、`claude auth login` はブラウザを開く代わりにこのトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必要です。自動化された環境で認証をプロビジョニングするのに便利です |338| `CLAUDE_CODE_OAUTH_REFRESH_TOKEN` | claude.ai 認証用の OAuth リフレッシュトークン。設定すると、`claude auth login` はブラウザを開く代わりにこのトークンを直接交換します。`CLAUDE_CODE_OAUTH_SCOPES` が必要です。自動化された環境で認証をプロビジョニングする場合に便利です。[プロジェクト設定とローカル設定](https://code.claude.com/docs/ja/settings-reference.md#variables-claude-code-ignores-in-env)では無視されます |

339| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンの発行時に指定された、スペース区切りの OAuth スコープ（`"user:profile user:inference user:sessions:claude_code"` など）。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` を設定する場合に必要です |339| `CLAUDE_CODE_OAUTH_SCOPES` | リフレッシュトークンの発行時に付与された、スペース区切りの OAuth スコープ（例: `"user:profile user:inference user:sessions:claude_code"`）。`CLAUDE_CODE_OAUTH_REFRESH_TOKEN` を設定する場合は必須です。[プロジェクト設定とローカル設定](https://code.claude.com/docs/ja/settings-reference.md#variables-claude-code-ignores-in-env)では無視されます |

340| `CLAUDE_CODE_OAUTH_TOKEN` | claude.ai 認証用の OAuth アクセストークン。SDK や自動化された環境で `/login` の代わりに使用します。キーチェーンに保存された認証情報よりも優先されます。[`claude setup-token`](https://code.claude.com/docs/ja/authentication#generate-a-long-lived-token) で生成します。[`/login`](https://code.claude.com/docs/ja/authentication#authentication-precedence) を実行しない限り、Claude Code はセッション全体を通じて設定したトークンを使用します。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動してください |340| `CLAUDE_CODE_OAUTH_TOKEN` | claude.ai 認証用の OAuth アクセストークン。SDK や自動化された環境で `/login` の代わりに使用します。[プロジェクト設定とローカル設定](https://code.claude.com/docs/ja/settings-reference.md#variables-claude-code-ignores-in-env)では無視されます。キーチェーンに保存された認証情報よりも優先されます。[`claude setup-token`](https://code.claude.com/docs/ja/authentication#generate-a-long-lived-token) で生成できます。[`/login`](https://code.claude.com/docs/ja/authentication#authentication-precedence) を実行しない限り、Claude Code はセッション全体で設定したトークンを使用します。期限切れのトークンを置き換えるには、新しいトークンを生成して再起動してください |

341| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160 で削除され、現在は何も行いません。以前は、現在のデフォルトではなく Claude Opus 4.6 に [fast mode](https://code.claude.com/docs/ja/fast-mode.md) を固定していました。Opus 4.6 は fast mode をサポートしなくなりました |341| `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE` | v2.1.160 で削除され、現在は何も行いません。以前は、現在のデフォルトではなく Claude Opus 4.6 に [fast mode](https://code.claude.com/docs/ja/fast-mode.md) を固定していました。Opus 4.6 は fast mode をサポートしなくなりました |

342| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツを含む OpenTelemetry 属性（モデルの応答、ツールのコンテンツ、システムプロンプト、生の API ボディ）の最大長。切り詰めマーカーを含み、UTF-16 コードユニット単位です（デフォルト: 61440、つまり 60 KB）。テレメトリバックエンドが 64 KB を超える属性値を受け付ける場合にのみ値を増やし、テレメトリの量を減らす場合は値を小さくしてください。Claude Code v2.1.214 以降が必要です。[モニタリング](https://code.claude.com/docs/ja/monitoring-usage.md) を参照してください |342| `CLAUDE_CODE_OTEL_CONTENT_MAX_LENGTH` | コンテンツを含む OpenTelemetry 属性（モデルの応答、ツールのコンテンツ、システムプロンプト、生の API ボディ）の最大長。切り詰めマーカーを含み、UTF-16 コードユニット単位です（デフォルト: 61440、つまり 60 KB）。テレメトリバックエンドが 64 KB を超える属性値を受け付ける場合にのみ値を増やし、テレメトリの量を減らす場合は値を小さくしてください。Claude Code v2.1.214 以降が必要です。[モニタリング](https://code.claude.com/docs/ja/monitoring-usage.md) を参照してください |

343| `CLAUDE_CODE_OTEL_DIAG_STDERR` | `1` に設定すると、OpenTelemetry エクスポーターの診断エラーを stderr に書き込みます。デフォルトではこれらのエラーは `--debug` の使用時にのみ表示されるため、Prometheus のポート衝突など設定に誤りのあるエクスポーターは、これを設定しないと何も表示されずに失敗します。Claude Code v2.1.179 以降が必要です。[モニタリング](https://code.claude.com/docs/ja/monitoring-usage.md) を参照してください |343| `CLAUDE_CODE_OTEL_DIAG_STDERR` | `1` に設定すると、OpenTelemetry エクスポーターの診断エラーを stderr に書き込みます。デフォルトではこれらのエラーは `--debug` の使用時にのみ表示されるため、Prometheus のポート衝突など設定に誤りのあるエクスポーターは、これを設定しないと何も表示されずに失敗します。Claude Code v2.1.179 以降が必要です。[モニタリング](https://code.claude.com/docs/ja/monitoring-usage.md) を参照してください |

66| `This organization has been disabled` | [認証](#this-organization-has-been-disabled) |66| `This organization has been disabled` | [認証](#this-organization-has-been-disabled) |

67| `Your organization has disabled API key authentication` | [認証](#your-organization-has-disabled-api-key-authentication) |67| `Your organization has disabled API key authentication` | [認証](#your-organization-has-disabled-api-key-authentication) |

68| `Your organization has disabled Claude subscription access` | [認証](#your-organization-has-disabled-claude-subscription-access) |68| `Your organization has disabled Claude subscription access` | [認証](#your-organization-has-disabled-claude-subscription-access) |

69| `Routines are disabled by your organization's policy` | [認証](#routines-are-disabled-by-your-organizations-policy) |69| `Scheduled tasks are off for your organization` | [認証](#routines-are-disabled-by-your-organizations-policy) |

70| `Routines are off for your organization` | [認証](#routines-are-disabled-by-your-organizations-policy) |

70| `Remote Control is only available when using Claude via api.anthropic.com` | [認証](#remote-control-requires-the-anthropic-api) |71| `Remote Control is only available when using Claude via api.anthropic.com` | [認証](#remote-control-requires-the-anthropic-api) |

71| `OAuth token refresh failed — run /login to re-authenticate` | [認証](#remote-control-couldnt-refresh-your-login) |72| `OAuth token refresh failed — run /login to re-authenticate` | [認証](#remote-control-couldnt-refresh-your-login) |

72| `JWT refresh failed: no OAuth token — run /login` | [認証](#remote-control-couldnt-refresh-your-login) |73| `JWT refresh failed: no OAuth token — run /login` | [認証](#remote-control-couldnt-refresh-your-login) |

755Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.756Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

756```757```

757 758 

759[フックまたは mod による変更に起因する拒否](#hook-changed-input-after-review) を含め、一部の拒否はこの 10 回にカウントされません。

760 

758停止メッセージは、セッションの種類ごとに異なる場所に表示されます。761停止メッセージは、セッションの種類ごとに異なる場所に表示されます。

759 762 

760* 対話セッションでは、メッセージはトランスクリプトに警告として表示され、ターンが終了します763* 対話セッションでは、メッセージはトランスクリプトに警告として表示され、ターンが終了します

774 777 

775v2.1.302 より前では、Anthropic API への直接接続において、Claude Code はサーバーのチェックには長くなりすぎた会話を圧縮しませんでした。778v2.1.302 より前では、Anthropic API への直接接続において、Claude Code はサーバーのチェックには長くなりすぎた会話を圧縮しませんでした。

776 779 

780#### `a hook changed this call's input after auto mode reviewed it`

781 

782この拒否は、サーバーがレビューした後にフックまたは mod が [呼び出しの入力を変更した](https://code.claude.com/docs/ja/hooks.md#pretooluse-updatedinput-in-auto-mode) ため、実際に実行される内容がレビューの対象外になっていることを意味します。アクションが安全でないという判断ではありません。

783 

784同じ Claude の応答内の後続の呼び出しも、次の理由で拒否されることがあります。

785 

786```text theme={null}

787another call in this response was changed by a hook after auto mode reviewed it, or could not be confirmed unchanged

788```

789 

790その後 Claude は、拒否された各呼び出しを再度発行して、サーバーにレビューさせることができます。権限プロンプトが開いた場合は、それに応答してください。Claude が応答の中で auto モードが呼び出しをチェックできなかったと述べない限り、他に何もする必要はありません。そう述べた場合は、変更を止めるか呼び出しを自分で承認してから、Claude にその呼び出しを再試行するよう依頼してください。

791 

792* **変更を止める**: その呼び出し、または同じ Claude の応答内のそれより前の呼び出しを変更した [フック](https://code.claude.com/docs/ja/hooks.md#disable-or-remove-hooks) または [mod](https://code.claude.com/docs/ja/plugins/mods/overview.md#turn-mods-on-or-off) をオフにするか、管理者にオフにするよう依頼してください。フックを探すには、Claude Code のプロンプトで [`/hooks`](https://code.claude.com/docs/ja/hooks#the-%2Fhooks-menu) を実行します。ターミナルセッションでは、`/plugin` を実行してアクティブな mod を確認できます。

793* **呼び出しを自分で承認する**: [Manual モードに切り替えてください](https://code.claude.com/docs/ja/permission-modes.md#switch-permission-modes)

794 

777### Was not reviewed and did not run795### Was not reviewed and did not run

778 796 

779`was not reviewed and did not run` 拒否は、会話が長すぎて [auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode) の分類器がアクションをチェックできず、アクションが実行されなかったことを意味します。Claude Code は次のメッセージを Claude に返します。797`was not reviewed and did not run` 拒否は、会話が長すぎて [auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode) の分類器がアクションをチェックできず、アクションが実行されなかったことを意味します。Claude Code は次のメッセージを Claude に返します。

1188* サブスクリプションではなく Console API キーで認証します。設定方法については、[Claude Console 認証](https://code.claude.com/docs/ja/authentication.md#claude-console-authentication)を参照してください。1206* サブスクリプションではなく Console API キーで認証します。設定方法については、[Claude Console 認証](https://code.claude.com/docs/ja/authentication.md#claude-console-authentication)を参照してください。

1189* 管理者であってもアクセスを有効にするオプションが表示されない場合は、[Anthropic サポート](https://support.claude.com)に問い合わせてください1207* 管理者であってもアクセスを有効にするオプションが表示されない場合は、[Anthropic サポート](https://support.claude.com)に問い合わせてください

1190 1208 

1191### ルーティンが組織のポリシーにより無効化されています1209### Scheduled tasks are off for your organization

1192 1210 

1193Team または Enterprise 組織の Owner が、組織レベルで[クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md)（旧ルーティン）をオフにしています。このエラーは、[claude.ai/code/routines](https://claude.ai/code/routines) などでタスクを作成または実行しようとしたときに表示されます。Claude Code v2.1.227 以降では、同じ設定により CLI の [`/schedule` も非表示になります](https://code.claude.com/docs/ja/routines#troubleshooting)。1211組織で[クラウドのスケジュールタスク](https://code.claude.com/docs/ja/routines.md)がオフになっているため、作成も実行もできません。claude.ai からのメッセージでは、これらをスケジュールタスクまたはルーティンと呼び、続けて管理者に関する一文が表示されます：

1194 1212 

1195```text theme={null}1213```text theme={null}

1196Routines are disabled by your organization's policy.1214Scheduled tasks are off for your organization. …

1215Routines are off for your organization. …

1197```1216```

1198 1217 

1199これはサーバー側の設定であるため、ローカル設定、環境変数、CLI フラグから上書きすることはできません。1218ローカル設定、環境変数、CLI フラグでオンにすることはできません。

1200 1219 

1201**対処方法：**1220**対処方法：**

1202 1221 

1203* 組織の Owner に、[**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) で **Scheduled tasks (Was Routines)** トグルをオンにするよう依頼します1222* Team または Enterprise の Owner に、[**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) で **Scheduled tasks (Was Routines)** または **Routines** というラベルのトグルをオンにできるか確認します

1204 1223 

1205### Remote Control には Anthropic API が必要です1224### Remote Control には Anthropic API が必要です

1206 1225 

197* **受け入れた場合**: Claude Code は新しいモデル ID を[ユーザー設定ファイル](https://code.claude.com/docs/ja/settings.md)に書き込み、再起動します197* **受け入れた場合**: Claude Code は新しいモデル ID を[ユーザー設定ファイル](https://code.claude.com/docs/ja/settings.md)に書き込み、再起動します

198* **拒否した場合**: Claude Code は次のデフォルトバージョン変更までその選択を記憶します198* **拒否した場合**: Claude Code は次のデフォルトバージョン変更までその選択を記憶します

199 199 

200[管理設定](https://code.claude.com/docs/ja/managed-settings.md)の `env` ブロックでのピンについては、Claude Code はチェックを実行せず、確認メッセージも表示しません。200[管理設定](https://code.claude.com/docs/ja/managed-settings.md)の `env` ブロックでのピンについては、Claude Code はチェックを実行せず、確認メッセージも表示しません。このピンに対して更新の確認メッセージが引き続き表示される場合は、Claude Code を v2.1.314 以降に更新してください。v2.1.314 より前は、受け入れた後も管理設定のピンが有効なままだったため、次回の起動時に確認メッセージが再び表示されていました。

201 201 

202モデルをピン留めしていなくて、現在のデフォルトがプロジェクトで利用できない場合、Claude Code は現在のセッション用にフォールバックし、通知を表示します。デフォルトモデルの以前のバージョンを最初に試し、デフォルトが Opus モデルで Opus バージョンが利用できない場合は、デフォルト Sonnet モデルにフォールバックします。フォールバックは永続化されません。[Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)で新しいモデルを有効にするか、[バージョンをピン留めして](#5-pin-model-versions)選択を永続化してください。202モデルをピン留めしていなくて、現在のデフォルトがプロジェクトで利用できない場合、Claude Code は現在のセッション用にフォールバックし、通知を表示します。デフォルトモデルの以前のバージョンを最初に試し、デフォルトが Opus モデルで Opus バージョンが利用できない場合は、デフォルト Sonnet モデルにフォールバックします。フォールバックは永続化されません。[Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)で新しいモデルを有効にするか、[バージョンをピン留めして](#5-pin-model-versions)選択を永続化してください。

203 203 

204### 特定のモデルでセッションを開始する

205 

204特定の Sonnet または Opus バージョンでセッションを開始する場合（例えば `--model`、`ANTHROPIC_MODEL`、または[`model` 設定](https://code.claude.com/docs/ja/settings-reference#model)を使用）、そのバージョンは一致する `sonnet` または `opus` エイリアスのセッションのピン留めされたデフォルトとして機能します。Claude Code は、設定したモデルが置き換える組み込みデフォルトの可用性チェックをスキップし、設定したモデルで起動します。フォールバック通知はありません。206特定の Sonnet または Opus バージョンでセッションを開始する場合（例えば `--model`、`ANTHROPIC_MODEL`、または[`model` 設定](https://code.claude.com/docs/ja/settings-reference#model)を使用）、そのバージョンは一致する `sonnet` または `opus` エイリアスのセッションのピン留めされたデフォルトとして機能します。Claude Code は、設定したモデルが置き換える組み込みデフォルトの可用性チェックをスキップし、設定したモデルで起動します。フォールバック通知はありません。

205 207 

206`opus` などのモデルエイリアスはピンとして機能せず、Claude Code が認識しないモデル ID も同様です。208`opus` などのモデルエイリアス、または Claude Code が認識しないモデル ID でセッションを開始した場合、その値はピンとして機能しません。

209 

210### 記憶されたモデルの拒否

207 211 

208これらのチェックがプロジェクトが呼び出せないモデルを見つけた場合、Claude Code はこのマシン上でその拒否を最大 1 日間記憶し、その間の起動時に記憶されたモデルをスキップして Agent Platform に再度問い合わせません。Claude Code は、現在のデフォルトモデルの記憶された拒否を、最後のチェック以降 10 分が経過した後に起動時に再度チェックするため、管理者が再度有効にしたデフォルトが戻ります。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/ja/env-vars)を設定してください。212起動時のモデルチェックでプロジェクトが呼び出せないモデルが見つかった場合、Claude Code はこのマシン上でその拒否を最大 1 日間記憶することがあります。最後のチェックから 10 分が経過すると、Claude Code は現在のデフォルトモデルの記憶された拒否を起動時に再度チェックします。これにより、管理者が再度有効にしたデフォルトが戻ります。メモリをオフにするには、[`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](https://code.claude.com/docs/ja/env-vars)を設定してください。

209 213 

210### 組織がモデル許可リストを強制している場合214### 組織がモデル許可リストを強制している場合

211 215 

901 901 

902#### フックが失敗したときにアクションをブロックする902#### フックが失敗したときにアクションをブロックする

903 903 

904ほとんどのイベントでは、フックが失敗またはタイムアウトしても Claude Code はアクションを実行するため、パスが間違っていたりスクリプトがクラッシュしたりするポリシー フックはすべてを通過させてしまいます。代わりにアクションをブロックするには、`command` または `http` フックに `"onFailure": "block"` を設定します。Claude Code v2.1.295 以降が必要です。904ほとんどのイベントでは、フックが失敗またはタイムアウトしても Claude Code はアクションを実行するため、パスが間違っていたりスクリプトがクラッシュしたりするポリシー フックはすべてを通過させてしまいます。代わりにアクションをブロックするには、`command` または `http` フックに `"onFailure": "block"` を設定します。Claude Code v2.1.295 以降が必要です。Agent SDK のコールバック フックについては、[コールバックが失敗したときにアクションをブロックする](https://code.claude.com/docs/ja/agent-sdk/hooks.md#block-the-action-when-a-callback-fails)を参照してください。

905 905 

906> [!NOTE]906> [!NOTE]

907>907>

1960| :- | :- |1960| :- | :- |

1961| `permissionDecision` | `"allow"` は権限プロンプトをスキップします。ただし、[どのモードでも自動承認されないアクション](https://code.claude.com/docs/ja/permission-modes.md#actions-no-mode-auto-approves)と[ネットワークパスからの読み取り](https://code.claude.com/docs/ja/permissions.md#network-paths)は除きます。また、[権限モードがその呼び出しを承認する](https://code.claude.com/docs/ja/agent-sdk/typescript.md#permission-modes-that-can-approve-an-always_ask-call)場合を除き、[Agent SDK アプリが `always_ask` とマークしたツール](https://code.claude.com/docs/ja/agent-sdk/custom-tools#require-approval-for-specific-tools)の呼び出しに対する承認もスキップしません。`AskUserQuestion` と `ExitPlanMode` には [`"allow"` と組み合わせた `updatedInput`](#allow-with-updatedinput) が必要です。plan モードについては、[plan モードでのフックによる承認](https://code.claude.com/docs/ja/permissions.md#hook-approvals-in-plan-mode)を参照してください。`"deny"` はツール呼び出しを防ぎます。`"ask"` はユーザーに確認を求めます。`"defer"` はツールを後で再開できるようにターンを終了し、`-p` フラグを使った[非対話モード](#defer-a-tool-call-for-later)が必要です。フックが何を返すかにかかわらず、[拒否ルールと確認ルール](https://code.claude.com/docs/ja/permissions.md#manage-permissions)は引き続き評価されます |1961| `permissionDecision` | `"allow"` は権限プロンプトをスキップします。ただし、[どのモードでも自動承認されないアクション](https://code.claude.com/docs/ja/permission-modes.md#actions-no-mode-auto-approves)と[ネットワークパスからの読み取り](https://code.claude.com/docs/ja/permissions.md#network-paths)は除きます。また、[権限モードがその呼び出しを承認する](https://code.claude.com/docs/ja/agent-sdk/typescript.md#permission-modes-that-can-approve-an-always_ask-call)場合を除き、[Agent SDK アプリが `always_ask` とマークしたツール](https://code.claude.com/docs/ja/agent-sdk/custom-tools#require-approval-for-specific-tools)の呼び出しに対する承認もスキップしません。`AskUserQuestion` と `ExitPlanMode` には [`"allow"` と組み合わせた `updatedInput`](#allow-with-updatedinput) が必要です。plan モードについては、[plan モードでのフックによる承認](https://code.claude.com/docs/ja/permissions.md#hook-approvals-in-plan-mode)を参照してください。`"deny"` はツール呼び出しを防ぎます。`"ask"` はユーザーに確認を求めます。`"defer"` はツールを後で再開できるようにターンを終了し、`-p` フラグを使った[非対話モード](#defer-a-tool-call-for-later)が必要です。フックが何を返すかにかかわらず、[拒否ルールと確認ルール](https://code.claude.com/docs/ja/permissions.md#manage-permissions)は引き続き評価されます |

1962| `permissionDecisionReason` | `"ask"` の場合、権限プロンプトでユーザーに表示されます。そのプロンプトに誰も応答できない `-p` の実行で Claude Code が[呼び出しを拒否する](https://code.claude.com/docs/ja/headless.md#turn-off-permission-prompts-in-unattended-runs)場合は、代わりに Claude がツールの結果でその理由を読み取ります。`"deny"` の場合、Claude に表示されます。`"allow"` と `"defer"` の場合、[デバッグログ](#debug-hooks)にのみ書き込まれます |1962| `permissionDecisionReason` | `"ask"` の場合、権限プロンプトでユーザーに表示されます。そのプロンプトに誰も応答できない `-p` の実行で Claude Code が[呼び出しを拒否する](https://code.claude.com/docs/ja/headless.md#turn-off-permission-prompts-in-unattended-runs)場合は、代わりに Claude がツールの結果でその理由を読み取ります。`"deny"` の場合、Claude に表示されます。`"allow"` と `"defer"` の場合、[デバッグログ](#debug-hooks)にのみ書き込まれます |

1963| `updatedInput` | 実行前にツールの入力パラメータを変更します。入力オブジェクト全体を置き換えるため、変更したフィールドとともに変更していないフィールドも含めてください。Claude Code は、権限ルールと Bash コマンドの[自動バックグラウンド化の適格性](https://code.claude.com/docs/ja/tools-reference.md#foreground-commands-that-move-to-the-background)を、Claude が送信した入力ではなく、フックが返した入力に対して評価します。自動承認するには `"allow"` と、変更した入力をユーザーに表示するには `"ask"` と組み合わせます。`"defer"` の場合は無視されます |1963| `updatedInput` | 実行前にツールの入力パラメーターを変更します。入力オブジェクト全体を置き換えるため、変更したフィールドとともに変更していないフィールドも含めてください。Claude Code は、Claude が送信した入力ではなく、フックが返した入力に対して権限ルールと Bash コマンドの[自動バックグラウンド化の適格性](https://code.claude.com/docs/ja/tools-reference.md#foreground-commands-that-move-to-the-background)を評価します。自動承認するには `"allow"` と、変更した入力をユーザーに表示するには `"ask"` と組み合わせてください。`"defer"` の場合は無視されます。`permissionDecision` がない場合、[auto モードが変更された呼び出しを拒否する](#pretooluse-updatedinput-in-auto-mode)ことがあります |

1964| `additionalContext` | ツールの結果とともに Claude のコンテキストに追加される文字列。`permissionDecision` が `"defer"` の場合は無視されます。[Claude にコンテキストを追加する](#add-context-for-claude)を参照してください |1964| `additionalContext` | ツールの結果とともに Claude のコンテキストに追加される文字列。`permissionDecision` が `"defer"` の場合は無視されます。[Claude にコンテキストを追加する](#add-context-for-claude)を参照してください |

1965 1965 

1966複数の PreToolUse フックが異なる決定を返した場合、優先順位は `deny` > `defer` > `ask` > `allow` です。1966複数の PreToolUse フックが異なる決定を返した場合、優先順位は `deny` > `defer` > `ask` > `allow` です。

1987>1987>

1988> PreToolUse は以前はトップレベルの `decision` と `reason` フィールドを使用していましたが、このイベントではこれらは非推奨です。代わりに `hookSpecificOutput.permissionDecision` と `hookSpecificOutput.permissionDecisionReason` を使用してください。非推奨の値 `"approve"` と `"block"` は、それぞれ `"allow"` と `"deny"` に対応します。PostToolUse や Stop などの他のイベントは、引き続きトップレベルの `decision` と `reason` を現在の形式として使用します。1988> PreToolUse は以前はトップレベルの `decision` と `reason` フィールドを使用していましたが、このイベントではこれらは非推奨です。代わりに `hookSpecificOutput.permissionDecision` と `hookSpecificOutput.permissionDecisionReason` を使用してください。非推奨の値 `"approve"` と `"block"` は、それぞれ `"allow"` と `"deny"` に対応します。PostToolUse や Stop などの他のイベントは、引き続きトップレベルの `decision` と `reason` を現在の形式として使用します。

1989 1989 

1990#### auto モードでの PreToolUse の `updatedInput`

1991 

1992[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)でフックが `permissionDecision` なしで `updatedInput` を返すと、Claude Code は変更された呼び出しを拒否することがあります。[サーバーがレビューした](https://code.claude.com/docs/ja/permission-modes.md#server-side-classifier-review)のは Claude が書いた入力であり、フックが返した入力ではないためです。Anthropic API に直接接続している対話ターミナルセッションと VS Code セッションでは、拒否に次のテキストが含まれます。

1993 

1994```text theme={null}

1995a hook changed this call's input after auto mode reviewed it

1996```

1997 

1998このテキストを含む拒否の後、Claude は変更された呼び出しを再度発行して、サーバーにレビューさせることができます。Claude が次の応答で変更された入力をそのまま繰り返した場合でも、フックは引き続き実行されます。

1999 

2000* フックは呼び出しを拒否したり、権限プロンプトに送ったりできます

2001* フックが返す `updatedInput` は破棄されるため、実行されるのはサーバーがレビューした内容です

2002 

2003[auto モードが呼び出しをチェックできなかったと Claude が応答で伝えた](https://code.claude.com/docs/ja/errors.md#hook-changed-input-after-review)場合を除き、この拒否のためにフックを変更する必要はありません。

2004 

2005このテキストが表示されるセッションでは、設定内またはプラグインのフックファイル内の [`command` フック](#command-hook-fields)は、この拒否を受けずに Bash、PowerShell、Monitor、Edit、Write、NotebookEdit の呼び出しを変更できます。ただし、同じ Claude の応答内の前の呼び出しをいずれかのフックが変更した場合や、Bash コマンドがサンドボックス外での実行を求める場合などには、拒否が表示されることがあります。

2006 

1990#### auto モードでの PreToolUse の `ask` 決定2007#### auto モードでの PreToolUse の `ask` 決定

1991 2008 

1992[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)では、PreToolUse フックの `"ask"` は通常ツール呼び出しを権限プロンプトに送り、[分類器](https://code.claude.com/docs/ja/permission-modes.md#how-the-classifier-evaluates-actions)はその判断を行いません。一部の呼び出しは異なる経路をたどります。2009[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)では、PreToolUse フックの `"ask"` は通常ツール呼び出しを権限プロンプトに送り、[分類器](https://code.claude.com/docs/ja/permission-modes.md#how-the-classifier-evaluates-actions)はその判断を行いません。一部の呼び出しは異なる経路をたどります。

287 287 

288### Ctrl+R での逆方向検索288### Ctrl+R での逆方向検索

289 289 

290`Ctrl+R` を押してコマンド履歴をインタラクティブに検索します。[フルスクリーンレンダリング](https://code.claude.com/docs/ja/fullscreen.md) では、`Ctrl+R` は検索ダイアログを開きます。入力してフィルタリングし、`Up` と `Down` を押してマッチを移動し、`Ctrl+S` を押してスコープをこのセッション、このプロジェクト、すべてのプロジェクトの間で循環させます。`Enter` または `Tab` を押してマッチをプロンプト入力に配置するか、`Esc` を押してキャンセルします。以下のステップは、クラシックレンダラーのインライン検索について説明しています。290`Ctrl+R` を押してコマンド履歴をインタラクティブに検索します。[フルスクリーンレンダリング](https://code.claude.com/docs/ja/fullscreen.md) では、`Ctrl+R` は検索ダイアログを開きます。ダイアログで入力してフィルタリングし、`Up` と `Down` を押してマッチのリストを移動します。プレビューペインには、ハイライトされたマッチの先頭部分が表示されます。

291 

292ダイアログで `Ctrl+S` を押すと、スコープをこのセッション、このプロジェクト、すべてのプロジェクトの間で循環させます。`Enter` または `Tab` を押してマッチをプロンプト入力に配置するか、`Esc` を押してキャンセルします。以下のステップは、クラシックレンダラーのインライン検索について説明しています。

291 293 

2921. **検索を開始**: `Ctrl+R` を押して逆方向履歴検索を有効にします2941. **検索を開始**: `Ctrl+R` を押して逆方向履歴検索を有効にします

2932. **クエリを入力**: 前のコマンドで検索するテキストを入力します。検索用語は一致する結果で強調表示されます2952. **クエリを入力**: 前のコマンドで検索するテキストを入力します。現在のマッチがプロンプト入力に表示されます。

2943. **マッチを移動**: `Ctrl+R` をもう一度押して、より古いマッチを循環させます2963. **マッチを移動**: `Ctrl+R` をもう一度押して、より古いマッチを循環させます

2954. **検索スコープ**: インライン検索は常にすべてのプロジェクトからプロンプトを検索します2974. **検索スコープ**: インライン検索は常にすべてのプロジェクトからプロンプトを検索します

2965. **マッチを受け入れる**:2985. **マッチを受け入れる**:

300 * `Ctrl+C` を押してキャンセルし、元の入力を復元します302 * `Ctrl+C` を押してキャンセルし、元の入力を復元します

301 * 空の検索で `Backspace` を押してキャンセルします303 * 空の検索で `Backspace` を押してキャンセルします

302 304 

303インライン検索は完全なプロンプト履歴をスキャンし、最新のものから順に、重複は最新の出現に折りたたまれます。フルスクリーン ダイアログは選択されたスコープ内の全プロンプト履歴を検索し、最新のものから順に、重複は最新の出現に折りたたまれます。最も最近のプロンプトが直ちに表示され、古いプロンプトからのマッチは Claude Code が残りの履歴を読み込むにつれて入力されます。マッチするプロンプトは検索用語が強調表示されて表示されるため、前の入力を見つけて再利用できます。

304 

305マッチを受け入れるか検索をキャンセルすると、Claude Code がまだ履歴を読み込んでいる場合でも、直ちに有効になります。305マッチを受け入れるか検索をキャンセルすると、Claude Code がまだ履歴を読み込んでいる場合でも、直ちに有効になります。

306 306 

307## バックグラウンド Bash コマンド307## バックグラウンド Bash コマンド

39 39 

40JetBrains マーケットプレイスから [Claude Code プラグイン](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) をインストールし、IDE を再起動します。40JetBrains マーケットプレイスから [Claude Code プラグイン](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) をインストールし、IDE を再起動します。

41 41 

42> [!NOTE]

43>

44> JetBrains マーケットプレイスはサードパーティ製のソフトウェアであり、Anthropic はこれを推奨、保守、または監査していません。Anthropic は Claude Code プラグインを JetBrains マーケットプレイスでの公開のために提出しています。

45 

42`claude` が IDE が見つけられない場所にインストールされている場合は、プラグインの [Claude コマンド設定](#general-settings) でフルパスを設定してください。46`claude` が IDE が見つけられない場所にインストールされている場合は、プラグインの [Claude コマンド設定](#general-settings) でフルパスを設定してください。

43 47 

44Claude Code は、任意の有料 Claude サブスクリプション（Pro、Max、Ultra、Team、または Enterprise）または Claude Console アカウントで動作し、API キーは不要です。`claude` を初めて実行するときに [ログイン](https://code.claude.com/docs/ja/authentication.md#log-in-to-claude-code) するよう求められます。48Claude Code は、任意の有料 Claude サブスクリプション（Pro、Max、Ultra、Team、または Enterprise）または Claude Console アカウントで動作し、API キーは不要です。`claude` を初めて実行するときに [ログイン](https://code.claude.com/docs/ja/authentication.md#log-in-to-claude-code) するよう求められます。

278 278 

279v2.1.305 以降では、ツール検索を挙げる `400` または `422`、あるいは原因を認識できない `400` または `422` の後に、Claude Code は [`defer_loading` フィールドと `tool_reference` ブロック](https://code.claude.com/docs/ja/mcp#tool-search-through-a-gateway)を除いてリクエストを再送信します。再試行が成功すると、その会話内の以降のリクエストでもそれらは省略されます。279v2.1.305 以降では、ツール検索を挙げる `400` または `422`、あるいは原因を認識できない `400` または `422` の後に、Claude Code は [`defer_loading` フィールドと `tool_reference` ブロック](https://code.claude.com/docs/ja/mcp#tool-search-through-a-gateway)を除いてリクエストを再送信します。再試行が成功すると、その会話内の以降のリクエストでもそれらは省略されます。

280 280 

281ゲートウェイ側で何も変更しなくても開発者のリクエストは引き続き機能し、MCP ツールは事前に読み込まれます。Claude Code がツール検索を再度試すと、ゲートウェイでは再び拒否されたリクエストとそれに続く再試行が見られます。ツール検索自体については、Claude Code はゲートウェイが `defer_loading` フィールドと `tool_reference` ブロックをその `anthropic-beta` 値とともに転送することを想定しています。281開発者のリクエストはゲートウェイ側で何も変更しなくても引き続き機能し、MCP ツールは事前に読み込まれます。Claude Code がツール検索を再度試みると、ゲートウェイでは、拒否されたリクエストとそれに続く再試行がもう一度確認されることがあります。ツール検索そのものについては、Claude Code はゲートウェイが `defer_loading` フィールドと `tool_reference` ブロックを、その `anthropic-beta` の値とともに転送することを想定しています。

282 282 

283### プレリリース機能を無効化283### プレリリース機能を無効化

284 284 

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` でその動作がオフになります。各キーは拒否することしかできません。

175 * 開発者のユーザー設定またはローカル設定の `false` でもオフになります

176 * `useAutoModeDuringPlan` については、開発者が [`--setting-sources`](https://code.claude.com/docs/ja/cli-reference#cli-flags) などのオプションで除外したユーザーファイルまたはローカルファイルの `false` はカウントされません。除外されたファイルを無視するには Claude Code v2.1.314 以降が必要です

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 以降が必要です177* [`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 以降が必要です178* [`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel)。いずれかの管理ソースにある最も低い上限が適用されます。開発者が自身の設定または `--settings` でより低い上限を設定した場合は、Claude Code はそちらを適用します。どのソースも上限を引き上げることはできません。Claude Code v2.1.267 以降が必要です

177* 任意の階層からの、`attribution` または非推奨の `includeCoAuthoredBy` におけるコミットトレーラーのオプトアウト179* 任意の階層からの、`attribution` または非推奨の `includeCoAuthoredBy` におけるコミットトレーラーのオプトアウト

6134. 設定：モデルに対して保存したレベルまたは [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) キー。これらの間および設定ファイル間の優先順位は [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings) に記載されています6134. 設定：モデルに対して保存したレベルまたは [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) キー。これらの間および設定ファイル間の優先順位は [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings) に記載されています

6145. モデルのデフォルトの effort：effort をサポートするすべてのモデルで `high`。ただし、Opus 5.5、Sonnet 5.5、Haiku 5.5 のデフォルトは `medium`、Opus 4.7 のデフォルトは `xhigh` です。また、組織が[組織のデフォルトモデル](#organization-default-model)にデフォルトの effort レベルを設定している場合、そのモデルを実行するときはそのレベルがデフォルトになります6145. モデルのデフォルトの effort：effort をサポートするすべてのモデルで `high`。ただし、Opus 5.5、Sonnet 5.5、Haiku 5.5 のデフォルトは `medium`、Opus 4.7 のデフォルトは `xhigh` です。また、組織が[組織のデフォルトモデル](#organization-default-model)にデフォルトの effort レベルを設定している場合、そのモデルを実行するときはそのレベルがデフォルトになります

615 615 

616自動モデルフォールバックの後に適用されるレベルについては、[フォールバック後の effort レベル](#effort-level-after-a-fallback)を参照してください。616自動モデルフォールバックの後に適用されるレベルについては、[フォールバック後の effort レベル](#effort-level-after-a-fallback)を参照してください。サブエージェントとチームメイトについては、[サブエージェントとチームメイトの effort レベル](#effort-level-of-subagents-and-teammates)を参照してください。

617 617 

618Opus 5.5 は、上記のいずれかのソースでレベルが設定されていない限り `medium` で開始され、ユーザー設定ファイルのトップレベルの `effortLevel` は Opus 5.5 には適用されません。このキーは、Claude Code がモデルごとにレベルを保存するようになる前に `/effort` が書き込んでいた古い形式です。Opus 5、Fable 5.1、およびそれ以前のモデルでは以前と同様に適用され続けますが、Opus 5.5 とそれ以降にリリースされたモデルは、`/effort` または `/model` ピッカーでレベルを選ぶまで、それぞれのデフォルトで開始されます。プロジェクト設定、ローカル設定、管理設定のトップレベルの `effortLevel`、または `--settings` で渡されたものは、すべてのモデルに適用されます。618Opus 5.5 は、上記のいずれかのソースでレベルが設定されていない限り `medium` で開始され、ユーザー設定ファイルのトップレベルの `effortLevel` は Opus 5.5 には適用されません。このキーは、Claude Code がモデルごとにレベルを保存するようになる前に `/effort` が書き込んでいた古い形式です。Opus 5、Fable 5.1、およびそれ以前のモデルでは以前と同様に適用され続けますが、Opus 5.5 とそれ以降にリリースされたモデルは、`/effort` または `/model` ピッカーでレベルを選ぶまで、それぞれのデフォルトで開始されます。プロジェクト設定、ローカル設定、管理設定のトップレベルの `effortLevel`、または `--settings` で渡されたものは、すべてのモデルに適用されます。

619 619 

700 700 

701[`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) または[組織の effort 上限](#organization-effort-limits)は、スキルやサブエージェントが実行されるレベルを引き続き制限します。[管理設定](https://code.claude.com/docs/ja/managed-settings.md)で `effortLevel` を設定した場合、Claude Code は[effort の解決順序](#adjust-effort-level)の設定のステップでそれを適用し、ユーザーは引き続き `/effort` や `--effort` でレベルを変更できます。ユーザーを特定のレベル以下に制限するには、[`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) を設定します。701[`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) または[組織の effort 上限](#organization-effort-limits)は、スキルやサブエージェントが実行されるレベルを引き続き制限します。[管理設定](https://code.claude.com/docs/ja/managed-settings.md)で `effortLevel` を設定した場合、Claude Code は[effort の解決順序](#adjust-effort-level)の設定のステップでそれを適用し、ユーザーは引き続き `/effort` や `--effort` でレベルを変更できます。ユーザーを特定のレベル以下に制限するには、[`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) を設定します。

702 702 

703#### サブエージェントとチームメイトの effort レベル

704 

705メインの会話と同じモデルでは、独自の `effort` を持たない[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md#choose-an-effort-level)または[チームメイト](https://code.claude.com/docs/ja/agent-teams.md#specify-teammates-and-models)は、セッション内で選んだレベル、または `--effort` で設定したレベルで実行されます。別のモデルでは、そのレベルは適用されません。サブエージェントのレベルを選ぶには、その定義で `effort` を設定します。

706 

703#### 設定した effort レベルを確認する707#### 設定した effort レベルを確認する

704 708 

705サポートされているモデルが選択されている場合、effort スライダーは `/model` に表示されます。セッションヘッダーに表示されるレベル（たとえば「with low effort」）は effort 設定に基づくもので、Claude が[まだ以前のレベルで作業している](#when-a-new-effort-level-starts)場合でも同様です。起動時と変更時には、フッターにもセッションに設定されたレベルが短時間表示されます。709サポートされているモデルが選択されている場合、effort スライダーは `/model` に表示されます。セッションヘッダーに表示されるレベル（たとえば「with low effort」）は effort 設定に基づくもので、Claude が[まだ以前のレベルで作業している](#when-a-new-effort-level-starts)場合でも同様です。起動時と変更時には、フッターにもセッションに設定されたレベルが短時間表示されます。

330 330 

331対話型 CLI セッションでは、詳細ベータトレースには、組織がこの機能の許可リストに登録されていることも必要です。Agent SDK および非対話型の `-p` セッションでは、許可リストへの登録は不要です。331対話型 CLI セッションでは、詳細ベータトレースには、組織がこの機能の許可リストに登録されていることも必要です。Agent SDK および非対話型の `-p` セッションでは、許可リストへの登録は不要です。

332 332 

333> [!WARNING]

334>

335> `ENABLE_BETA_TRACING_DETAILED` はデバッグ目的でのみ設定し、本番環境では設定しないでください。詳細ベータトレースはエクスポート量が多く、その[コンテンツ属性](#new-context-gates)は安定したスパンスキーマには含まれません。

336 

333| 属性 | 説明 | ゲート |337| 属性 | 説明 | ゲート |

334| - | - | - |338| - | - | - |

335| `hook_event` | フックイベントの種類（`PreToolUse` など） | |339| `hook_event` | フックイベントの種類（`PreToolUse` など） | |

131 131 

132Claude Code はセッションのデバッグログで無視された各キーを記録します。132Claude Code はセッションのデバッグログで無視された各キーを記録します。

133 133 

134アプリがプロバイダー接続を管理する [Claude Desktop](https://code.claude.com/docs/ja/desktop.md) セッション（[サードパーティプロバイダー](https://code.claude.com/docs/ja/third-party-integrations.md)の Code タブや Cowork セッションなど）では、Claude Code はこれらの変数とプロキシ変数 `HTTP_PROXY`、`HTTPS_PROXY`、および `NO_PROXY` を [管理設定](https://code.claude.com/docs/ja/managed-settings.md) と `~/.claude/settings.json` からのみ読み込みます。リポジトリ独自の設定ファイルではこれらを無視するため、チェックアウトされたリポジトリはアプリから認証情報が来るセッションの TLS またはプロキシパスをリダイレクトできません。claude.ai を通じてサインインしたローカル、SSH、または WSL Code タブセッションでは、アプリは接続を管理せず、Claude Code はすべての設定スコープからこれらの変数を読み込みます（任意のターミナルセッションと同様）。[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)はどこから開始しても上記のクラウドセッションルールに従います。v2.1.217 より前では、アプリが接続を管理していた場合、Claude Code はすべての設定ファイルでこれらの変数を無視していました。134アプリがプロバイダー接続を管理する [Claude Desktop](https://code.claude.com/docs/ja/desktop.md) セッション（[サードパーティプロバイダー](https://code.claude.com/docs/ja/third-party-integrations.md)の Code タブや Cowork セッションなど）では、Claude Code は `CLAUDE_CODE_OAUTH_SCOPES` を除くこれらの変数と、プロキシ変数 `HTTP_PROXY`、`HTTPS_PROXY`、および `NO_PROXY` を、[管理設定](https://code.claude.com/docs/ja/managed-settings.md)と `~/.claude/settings.json` からのみ読み込みます。リポジトリ独自の設定ファイルではこれらを無視するため、チェックアウトされたリポジトリはアプリから認証情報が来るセッションの TLS またはプロキシパスをリダイレクトできません。v2.1.217 より前では、アプリが接続を管理していた場合、Claude Code はすべての設定ファイルでこれらの変数を無視していました。

135 

136claude.ai を通じてサインインしたローカル、SSH、または WSL Code タブセッションでは、`CLAUDE_CODE_OAUTH_SCOPES` を除き、これらの変数とプロキシ変数を任意の設定ファイルで設定できます。Desktop は Code タブと Cowork セッションで `CLAUDE_CODE_OAUTH_SCOPES` を自ら設定するため、これを設定することはできません。

137 

138セッションの起動環境で既に変数が設定されている場合、Claude Code は[設定ファイルの値を無視](https://code.claude.com/docs/ja/settings-reference.md#how-env-values-interact-with-your-shell)し、[デバッグログ](https://code.claude.com/docs/ja/debug-your-config.md)にその変数名を記録します。ローカルセッションで独自のプロキシまたは証明書の値を使用するには、[保存済みのローカル環境に追加](https://code.claude.com/docs/ja/desktop.md#set-environment-variables-for-local-sessions)してください。[クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md)はどこから開始しても上記のクラウドセッションルールに従います。

135 139 

136## 設定を確認する140## 設定を確認する

137 141 

383* **サーバーがセッションをレビューしない**: レスポンスがレビュー結果なしで完了するか、サーバーがこのセッションをレビューしないと応答します。最も一般的な原因は、レビューの依頼や結果を破棄する LLM ゲートウェイまたはプロキシと、まだサーバー側チェックに対応していないプラットフォーム、リージョン、または認証情報です。Claude Code は独自の分類器リクエストにフォールバックします。そのフォールバックがセッションの残りの期間にわたって維持されることになると、分類器リクエストが課金対象となるアカウントでは、[分類器リクエストの料金に関する通知](https://code.claude.com/docs/ja/auto-mode-classifier-billing.md)が表示されます。383* **サーバーがセッションをレビューしない**: レスポンスがレビュー結果なしで完了するか、サーバーがこのセッションをレビューしないと応答します。最も一般的な原因は、レビューの依頼や結果を破棄する LLM ゲートウェイまたはプロキシと、まだサーバー側チェックに対応していないプラットフォーム、リージョン、または認証情報です。Claude Code は独自の分類器リクエストにフォールバックします。そのフォールバックがセッションの残りの期間にわたって維持されることになると、分類器リクエストが課金対象となるアカウントでは、[分類器リクエストの料金に関する通知](https://code.claude.com/docs/ja/auto-mode-classifier-billing.md)が表示されます。

384* **サーバーがアクションの判定を返さない**: Claude Code は、レビューなしで実行するのではなく、アクションを拒否します。どの接続でも、レビュー結果が届く前にレスポンスが終了した場合や、結果が Claude Code の読み取れない形式で届いた場合に発生します。レスポンスを途中で切ったり結果を書き換えたりする LLM ゲートウェイやプロキシは、どちらの原因にもなり得ます。Anthropic API への直接接続では、タイムアウトなどでサーバーのチェックがそのアクションについて失敗した場合にも発生します。拒否メッセージ、拒否が繰り返された場合の動作、および対処方法については、[サーバーが安全性の判定を返さなかった](https://code.claude.com/docs/ja/errors.md#the-server-returned-no-safety-verdict)を参照してください。384* **サーバーがアクションの判定を返さない**: Claude Code は、レビューなしで実行するのではなく、アクションを拒否します。どの接続でも、レビュー結果が届く前にレスポンスが終了した場合や、結果が Claude Code の読み取れない形式で届いた場合に発生します。レスポンスを途中で切ったり結果を書き換えたりする LLM ゲートウェイやプロキシは、どちらの原因にもなり得ます。Anthropic API への直接接続では、タイムアウトなどでサーバーのチェックがそのアクションについて失敗した場合にも発生します。拒否メッセージ、拒否が繰り返された場合の動作、および対処方法については、[サーバーが安全性の判定を返さなかった](https://code.claude.com/docs/ja/errors.md#the-server-returned-no-safety-verdict)を参照してください。

385 385 

386 サーバーのレビュー後に[フック](https://code.claude.com/docs/ja/hooks.md#pretooluse-updatedinput-in-auto-mode)または [mod](https://code.claude.com/docs/ja/plugins/mods/overview.md) がアクションの入力を変更した場合、Claude Code は判定なしでそのアクションを拒否することがあります。Anthropic API への直接接続でのインタラクティブなターミナルセッションと VS Code セッションでは、拒否のテキストに `a hook changed this call's input after auto mode reviewed it` が含まれます。対処方法については、[該当するエラー項目](https://code.claude.com/docs/ja/errors.md#hook-changed-input-after-review)を参照してください。

387 

386サーバーへの依頼をスキップして常に Claude Code 独自の分類器リクエストを使用するには、[`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/ja/env-vars) を設定します。Anthropic API への直接接続では、この変数には Claude Code v2.1.281 以降が必要です。そこで `1` に設定すると、`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` も設定していない限り、まだサーバーレビューが有効になっていないセッションでサーバーレビューがオンになります。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を設定して `CLAUDE_CODE_AUTO_MODE_SERVER` を未設定のままにすると、[プレリリース機能を無効にする](https://code.claude.com/docs/ja/llm-gateway-protocol.md#disable-pre-release-capabilities)で説明されている場合を除き、Claude Code はサーバーへの依頼も停止します。388サーバーへの依頼をスキップして常に Claude Code 独自の分類器リクエストを使用するには、[`CLAUDE_CODE_AUTO_MODE_SERVER=0`](https://code.claude.com/docs/ja/env-vars) を設定します。Anthropic API への直接接続では、この変数には Claude Code v2.1.281 以降が必要です。そこで `1` に設定すると、`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` も設定していない限り、まだサーバーレビューが有効になっていないセッションでサーバーレビューがオンになります。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を設定して `CLAUDE_CODE_AUTO_MODE_SERVER` を未設定のままにすると、[プレリリース機能を無効にする](https://code.claude.com/docs/ja/llm-gateway-protocol.md#disable-pre-release-capabilities)で説明されている場合を除き、Claude Code はサーバーへの依頼も停止します。

387 389 

388### デフォルトの分類器モデル390### デフォルトの分類器モデル

557* **アクションがブロックされた場合**: Claude Code は通知を表示し、そのアクションを `/permissions` の **Recently blocked** タブに表示します。そこで[アクションを承認して Claude が再試行できるようにする](https://code.claude.com/docs/ja/auto-mode-config.md#review-denials)ことができます。559* **アクションがブロックされた場合**: Claude Code は通知を表示し、そのアクションを `/permissions` の **Recently blocked** タブに表示します。そこで[アクションを承認して Claude が再試行できるようにする](https://code.claude.com/docs/ja/auto-mode-config.md#review-denials)ことができます。

558* **ブロックが繰り返された場合**: 分類器がアクションを 3 回連続、または合計 20 回ブロックすると、auto モードは一時停止し、Claude Code はプロンプトの表示を再開します。プロンプトで示されたアクションを承認すると auto モードが再開します。ブロックの数え方については、[繰り返しブロックのしきい値](#repeated-block-thresholds)を参照してください。560* **ブロックが繰り返された場合**: 分類器がアクションを 3 回連続、または合計 20 回ブロックすると、auto モードは一時停止し、Claude Code はプロンプトの表示を再開します。プロンプトで示されたアクションを承認すると auto モードが再開します。ブロックの数え方については、[繰り返しブロックのしきい値](#repeated-block-thresholds)を参照してください。

559* **分類器から判定が得られない場合**: auto モードとは別の安全チェックが分類器自体のリクエストを拒否した場合、または分類器の応答を解析できない場合、Claude Code は通知も **Recently blocked** のエントリもなしにアクションをブロックします。各ケースで表示されるメッセージと対処方法については、[auto モードがアクションの安全性を判断できない](https://code.claude.com/docs/ja/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)を参照してください。561* **分類器から判定が得られない場合**: auto モードとは別の安全チェックが分類器自体のリクエストを拒否した場合、または分類器の応答を解析できない場合、Claude Code は通知も **Recently blocked** のエントリもなしにアクションをブロックします。各ケースで表示されるメッセージと対処方法については、[auto モードがアクションの安全性を判断できない](https://code.claude.com/docs/ja/errors.md#auto-mode-cannot-determine-the-safety-of-an-action)を参照してください。

560* **サーバーから判定が得られない場合**: [サーバー側の分類器レビュー](#server-side-classifier-review)では、Claude Code はサーバーが判定を返さないアクションを拒否し、判定のないレスポンスが 10 回連続するとターンを停止します。[サーバーが安全性の判定を返さなかった](https://code.claude.com/docs/ja/errors.md#the-server-returned-no-safety-verdict)を参照してください。562* **サーバーからの判定がない場合**：[サーバー側の分類器によるレビュー](#server-side-classifier-review)では、サーバーから判定が返されないアクションを Claude Code は拒否し、判定のない応答が 10 回連続するとターンを停止することがあります。[The server returned no safety verdict](https://code.claude.com/docs/ja/errors.md#the-server-returned-no-safety-verdict) を参照してください。

561* **チェック中にモードを切り替えた場合**: 分類器のチェックが保留中に権限モードを切り替えると、Claude Code は新しいモードでは要求されなかったはずの判定を破棄します。代わりに承認を求めるプロンプトが表示されるか、[`dontAsk` モード](#allow-only-pre-approved-tools-with-dontask-mode)ではアクションが自動的に拒否されます。563* **チェック中にモードを切り替えた場合**: 分類器のチェックが保留中に権限モードを切り替えると、Claude Code は新しいモードでは要求されなかったはずの判定を破棄します。代わりに承認を求めるプロンプトが表示されるか、[`dontAsk` モード](#allow-only-pre-approved-tools-with-dontask-mode)ではアクションが自動的に拒否されます。

562 564 

563#### 繰り返しブロックのしきい値565#### 繰り返しブロックのしきい値

199 199 

200メッセージは Claude に記録されたとおりに呼び出しを再度発行するよう指示します。それも拒否された場合、hooks は毎回入力を変更するため、mod または hooks をオフにするか、自動モードを離れて呼び出しを自分で承認します。200メッセージは Claude に記録されたとおりに呼び出しを再度発行するよう指示します。それも拒否された場合、hooks は毎回入力を変更するため、mod または hooks をオフにするか、自動モードを離れて呼び出しを自分で承認します。

201 201 

202> [!NOTE]

203>

204> [一部のインタラクティブなターミナルセッションと VS Code セッション](https://code.claude.com/docs/ja/hooks.md#pretooluse-updatedinput-in-auto-mode) では、同じ拒否で `a hook changed this call's input after auto mode reviewed it` という理由が示されます。その場合、再発行された呼び出しには mod による最初の変更が含まれ、`tool.call` フックは引き続きその呼び出しに対して実行されますが、それ以上の変更は破棄されます。Claude が返答の中で [auto モードが呼び出しを確認できなかった](https://code.claude.com/docs/ja/errors.md#hook-changed-input-after-review) と伝えない限り、mod を変更する必要はありません。

205 

202### 設定の拒否ルールに関するメッセージ206### 設定の拒否ルールに関するメッセージ

203 207 

204`tried to lift a deny rule in your settings` と `the deny rules in your settings could not be checked for this call, so it is refused` は両方とも組み込みガードから来ます。208`tried to lift a deny rule in your settings` と `the deny rules in your settings could not be checked for this call, so it is refused` は両方とも組み込みガードから来ます。

31>31>

32> クラウドではなくマシン上で作業をスケジュールする機能が他に 2 つあります。[Desktop スケジュールタスク](https://code.claude.com/docs/ja/desktop-scheduled-tasks.md)と [`/loop`](https://code.claude.com/docs/ja/scheduled-tasks) です。3 つの中から選ぶには、[スケジューリングオプションを比較する](https://code.claude.com/docs/ja/scheduled-tasks.md#compare-scheduling-options)を参照してください。32> クラウドではなくマシン上で作業をスケジュールする機能が他に 2 つあります。[Desktop スケジュールタスク](https://code.claude.com/docs/ja/desktop-scheduled-tasks.md)と [`/loop`](https://code.claude.com/docs/ja/scheduled-tasks) です。3 つの中から選ぶには、[スケジューリングオプションを比較する](https://code.claude.com/docs/ja/scheduled-tasks.md#compare-scheduling-options)を参照してください。

33 33 

34Team および Enterprise の Owner は、[**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) の **Scheduled tasks (Was Routines)** トグルを使用して、すべてのメンバーのスケジュールタスクをオフにできます。トグルがオフの場合、既存のスケジュールタスクは実行を停止し、メンバーは新しいスケジュールタスクを作成できません。34Team および Enterprise の Owner は、[**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) の **Scheduled tasks (Was Routines)** または **Routines** トグルを使用して、すべてのメンバーのスケジュールタスクをオフにできます。トグルがオフの場合、既存のスケジュールタスクは実行を停止し、メンバーは新しいスケジュールタスクを作成できません。

35 35 

36Enterprise 組織が[カスタムロール](https://support.claude.com/en/articles/13930452)でアクセスを管理している場合は、スケジュールタスクの権限を含むロールも必要です。Owner は [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) でロールの **Remote sessions** セクションにこの権限を追加できます。36Enterprise 組織が[カスタムロール](https://support.claude.com/en/articles/13930452)でアクセスを管理している場合は、スケジュールタスクの権限を含むロールも必要です。Owner は [**Organization settings > Roles**](https://claude.ai/admin-settings/roles) でロールの **Remote sessions** セクションにこの権限を追加できます。

37 37 

485* **Web アドレス**: `claude.ai/code/routines`485* **Web アドレス**: `claude.ai/code/routines`

486* **CLI**: `/schedule` のエイリアス `/routines`、コマンドの説明、タスクのセットアップ中の Claude の返答486* **CLI**: `/schedule` のエイリアス `/routines`、コマンドの説明、タスクのセットアップ中の Claude の返答

487* **API**: `/fire` エンドポイントのパス、そのベータヘッダー、レスポンスの `type`、`<routine-fire-payload>` タグ、および [API 経由でルーティンをトリガーする](https://platform.claude.com/docs/en/api/claude-code/routines-fire)リファレンスページ487* **API**: `/fire` エンドポイントのパス、そのベータヘッダー、レスポンスの `type`、`<routine-fire-payload>` タグ、および [API 経由でルーティンをトリガーする](https://platform.claude.com/docs/en/api/claude-code/routines-fire)リファレンスページ

488* **組織設定**: **Scheduled tasks (Was Routines)** トグル488* **組織設定**: **Scheduled tasks (Was Routines)** または **Routines** トグル

489 489 

490## トラブルシューティング490## トラブルシューティング

491 491 

504 504 

505原因が CLI のサインインやクラウドセッション内にいることである場合でも、[claude.ai/code/routines](https://claude.ai/code/routines) でスケジュールタスクを作成・管理できます。そのためには Pro、Max、Ultra、Team、または Enterprise アカウントが必要です。組織でスケジュールタスクまたはクラウドセッションがオフになっている場合や、ロールにそれらが含まれていない場合は、Web でも作成できません。505原因が CLI のサインインやクラウドセッション内にいることである場合でも、[claude.ai/code/routines](https://claude.ai/code/routines) でスケジュールタスクを作成・管理できます。そのためには Pro、Max、Ultra、Team、または Enterprise アカウントが必要です。組織でスケジュールタスクまたはクラウドセッションがオフになっている場合や、ロールにそれらが含まれていない場合は、Web でも作成できません。

506 506 

507### "Routines are disabled by your organization's policy"507### 組織でスケジュールタスクがオフになっている

508 508 

509Team または Enterprise 組織の Owner が、[**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) の **Scheduled tasks (Was Routines)** トグルをオフにしている可能性があります。Claude Code v2.1.227 以降では、同じトグルで CLI の `/schedule` も非表示になります。これはサーバー側の組織設定であるため、ローカルの設定から上書きすることはできません。組織のスケジュールタスクを再びオンにするよう Owner に依頼してください。509組織でクラウドのスケジュールタスクがオフになっており、これはローカルの設定から変更することはできません。[**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) の **Scheduled tasks (Was Routines)** または **Routines** トグルをオンにできるかどうか、Team または Enterprise の Owner に問い合わせてください。

510 510 

511### "The last run" の警告511### "The last run" の警告

512 512 

1074* **ファイルシステム権限昇格**：過度に広いファイルシステム書き込み権限は権限昇格攻撃を有効にする可能性があります。`$PATH` の実行可能ファイルを含むディレクトリ、システム設定ディレクトリ、またはユーザーシェル設定ファイル（`.bashrc` または `.zshrc`）への書き込みを許可すると、他のユーザーまたはシステムプロセスがこれらのファイルにアクセスするときに異なるセキュリティコンテキストでコード実行につながる可能性があります。1074* **ファイルシステム権限昇格**：過度に広いファイルシステム書き込み権限は権限昇格攻撃を有効にする可能性があります。`$PATH` の実行可能ファイルを含むディレクトリ、システム設定ディレクトリ、またはユーザーシェル設定ファイル（`.bashrc` または `.zshrc`）への書き込みを許可すると、他のユーザーまたはシステムプロセスがこれらのファイルにアクセスするときに異なるセキュリティコンテキストでコード実行につながる可能性があります。

1075* **Linux サンドボックス強度**：Linux 実装は強力なファイルシステムとネットワーク分離を提供しますが、特権付き名前空間のない Docker 環境内で動作できるようにする `enableWeakerNestedSandbox` モードが含まれています。このオプションはセキュリティを大幅に弱め、追加の分離が別の方法で実施される場合にのみ使用する必要があります。1075* **Linux サンドボックス強度**：Linux 実装は強力なファイルシステムとネットワーク分離を提供しますが、特権付き名前空間のない Docker 環境内で動作できるようにする `enableWeakerNestedSandbox` モードが含まれています。このオプションはセキュリティを大幅に弱め、追加の分離が別の方法で実施される場合にのみ使用する必要があります。

1076* **macOS での Apple Events**：macOS サンドボックスはデフォルトで Apple Events をブロックします。`allowAppleEvents` 設定はこの制限を解除して、`open` や `osascript` などのツールが動作するようにしますが、コード実行分離を削除します。サンドボックス化されたコマンドは、ユーザープロンプトなしで他のアプリケーションをサンドボックス化されていない状態で起動でき、実行中のアプリケーションに AppleScript コマンドを送信できます。これはアプリごとの macOS オートメーション同意プロンプト（TCC）の対象です。これはユーザー、管理、または CLI 設定からのみ有効です。プロジェクト設定では有効にできません。1076* **macOS での Apple Events**：macOS サンドボックスはデフォルトで Apple Events をブロックします。`allowAppleEvents` 設定はこの制限を解除して、`open` や `osascript` などのツールが動作するようにしますが、コード実行分離を削除します。サンドボックス化されたコマンドは、ユーザープロンプトなしで他のアプリケーションをサンドボックス化されていない状態で起動でき、実行中のアプリケーションに AppleScript コマンドを送信できます。これはアプリごとの macOS オートメーション同意プロンプト（TCC）の対象です。これはユーザー、管理、または CLI 設定からのみ有効です。プロジェクト設定では有効にできません。

1077* **macOS での Mach および XPC サービス**：サンドボックス化されたコマンドは、[`network.allowMachLookup`](https://code.claude.com/docs/ja/settings-reference#sandbox-network-allowmachlookup) に列挙した各サービスにサンドボックスの外へ出てアクセスでき、それらのサービスがそのコマンドのために行う処理はサンドボックスによって制限されません。

1077* **Linux および WSL2 でのユーザー名前空間**：デフォルトでは、サンドボックス化されたコマンドはユーザー名前空間を作成できません。[`allowNestedUserNamespaces`](https://code.claude.com/docs/ja/settings-reference#sandbox-allownestedusernamespaces) を `true` に設定すると、セキュリティ境界をオフにすることになり、サンドボックス化されたコマンドのコードがサンドボックス外で実行される可能性があります。この設定をオンにする前に、[Linux のサンドボックス内で Chromium または rootless Podman が失敗する](#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux)の警告を確認してください。1078* **Linux および WSL2 でのユーザー名前空間**：デフォルトでは、サンドボックス化されたコマンドはユーザー名前空間を作成できません。[`allowNestedUserNamespaces`](https://code.claude.com/docs/ja/settings-reference#sandbox-allownestedusernamespaces) を `true` に設定すると、セキュリティ境界をオフにすることになり、サンドボックス化されたコマンドのコードがサンドボックス外で実行される可能性があります。この設定をオンにする前に、[Linux のサンドボックス内で Chromium または rootless Podman が失敗する](#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux)の警告を確認してください。

1078 1079 

1079### スコープ1080### スコープ

16 16 

17## ラッパースクリプト17## ラッパースクリプト

18 18 

19各セッションがランナー自体では実行できないセットアップが必要な場合、ラッパースクリプトを使用します。セッション作成者にスコープされた短期認証情報のプロビジョニング、環境固有のシークレットのエクスポート、言語ツールチェーンの準備、または子プロセスの周囲のリソース制限の適用などです。ランナーはセッションごとに 1 回、Claude Code バイナリの代わりにラッパーを起動します。ラッパーを終了するには、`$CLAUDE_RUNNER_CLAUDE_BIN`（ランナー自体のバイナリ）に `exec` することで、シグナルと終了コードが正しく伝播します。19各セッションでランナー単体では実行できないセットアップが必要な場合は、ラッパースクリプトを使用します。

20 

21* セッション作成者にスコープされた短期認証情報のプロビジョニング

22* 環境固有のシークレットのエクスポート

23* 言語ツールチェーンの準備

24* 子プロセスの周囲へのリソース制限の適用

25 

26ランナーは、セッションを開始するたびに（セッションの再開時や再キュー時を含む）、Claude Code バイナリの代わりにラッパーを起動します。ラッパーの最後で `$CLAUDE_RUNNER_CLAUDE_BIN`（ランナー自体のバイナリ）に `exec` することで、シグナルと終了コードが正しく伝播します。

20 27 

21ランナーを起動するときに `--exec-path` または `SELF_HOSTED_RUNNER_EXEC_PATH` をラッパーに指定し、[クイックスタート](https://code.claude.com/docs/ja/self-hosted-environments-quickstart.md#set-up-manually)の説明に従って `<writable-dir>` を置き換えます。28ランナーを起動するときに `--exec-path` または `SELF_HOSTED_RUNNER_EXEC_PATH` をラッパーに指定し、[クイックスタート](https://code.claude.com/docs/ja/self-hosted-environments-quickstart.md#set-up-manually)の説明に従って `<writable-dir>` を置き換えます。

22 29 

139 146 

140### checkout147### checkout

141 148 

142リポジトリごとに 1 回実行され、ランナーの組み込みクローンとフェッチの代わりになります。フックを使用して、HTTPS または SSH 経由でアクセスするリードスルーミラーからクローンしたり、アーカイブからワーキングツリーをシードしたり、セッションごとの git 認証を適用したりします。ランナーは以下の変数を設定します。また、表に記載されていない他の `CLAUDE_RUNNER_` 変数を設定する場合もあります。149ランナーがセッションを開始するたびに（セッションの再開時や再キュー時を含む）、リポジトリごとに実行され、ランナーの組み込みクローンとフェッチの代わりになります。フックを使用して、HTTPS または SSH 経由でアクセスするリードスルーミラーからクローンしたり、アーカイブからワーキングツリーをシードしたり、セッションごとの git 認証を適用したりします。

150 

151ランナーは以下の変数を設定します。また、表に記載されていない他の `CLAUDE_RUNNER_` 変数を設定する場合もあります。

143 152 

144| 変数 | 説明 |153| 変数 | 説明 |

145| :- | :- |154| :- | :- |

179 188 

180### post-session189### post-session

181 190 

182セッションごとに 1 回実行され、Claude Code 子プロセスが終了した後、ランナーがワークスペースを破棄する前に実行されます。このフックはコミットされていない作業を保存する唯一のチャンスです。`--capacity` が 1 より大きい場合、ランナーはフックが返された直後にセッションごとのワーキングツリーを削除し、`--capacity 1` の場合、再利用される[正規クローン](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)は次のセッションが開始されるときにハードリセットされるため、コミットされていない追跡変更はどちらのパスでも保存されません。典型的な用途は、コミットされていない変更のスナップショットブランチをプッシュしたり、ログをアーカイブしたり、セッション終了イベントを独自のシステムに発行したりすることです。191Claude Code 子プロセスが終了した後、ランナーがワークスペースを破棄する前に実行されます。コミットされていない追跡変更はどちらのパスでも保存されないため、このフックはコミットされていない作業を保存する唯一のチャンスです。

192 

193* **`--capacity` が 1 より大きい場合**：ランナーはフックが返された直後にセッションごとの worktree を削除します

194* **`--capacity 1` の場合**：再利用される[正規クローン](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)は次のセッションが開始されるときにハードリセットされます

195 

196典型的な用途は、コミットされていない変更のスナップショットブランチをプッシュしたり、ログをアーカイブしたり、セッション終了イベントを独自のシステムに発行したりすることです。

183 197 

184フックは子プロセスがスポーンされたセッション終了のたびに発火します。原因は何でもかまいません。以下の `CLAUDE_RUNNER_EXIT_REASON` 値がケースを列挙しています。ランナーが VM プリエンプションや停電などで突然終了する場合は発火できません。突然の終了に対する保証が必要な場合は、Claude Code `PostToolUse` フックを使用してセッション内から定期的にスナップショットを取得してください。ランナーは以下を設定します。198フックは子プロセスがスポーンされたセッション終了のたびに発火します。原因は何でもかまいません。以下の `CLAUDE_RUNNER_EXIT_REASON` 値がケースを列挙しています。ランナーが VM プリエンプションや停電などで突然終了する場合は発火できません。突然の終了に対する保証が必要な場合は、Claude Code `PostToolUse` フックを使用してセッション内から定期的にスナップショットを取得してください。ランナーは以下を設定します。

185 199 

275 289 

276### command290### command

277 291 

278セッションごとに 1 回実行され、チェックアウト後、組み込み子スポーン の代わりになります。フックは [ラッパースクリプト](#wrapper-scripts)と同じ環境を受け取り、同じ方法で `"$CLAUDE_RUNNER_CLAUDE_BIN"` に `exec` する必要があります。`command` フックを使用して、すべてのカスタマイズをフックディレクトリに保持します。ラッパーが別の場所にある場合は `--exec-path` を使用します。`--exec-path` も設定されている場合、フラグが優先され、`command` フックは無視されます。292セッションが開始または再開するたびにチェックアウト後に実行され、組み込みの子プロセスのスポーンの代わりになります。フックは[ラッパースクリプト](#wrapper-scripts)と同じ環境を受け取り、同じ方法で `"$CLAUDE_RUNNER_CLAUDE_BIN"` に `exec` する必要があります。`command` フックを使用すると、すべてのカスタマイズを 1 つのフックディレクトリに保持できます。ラッパーが別の場所にある場合は `--exec-path` を使用します。`--exec-path` も設定されている場合、フラグが優先され、`command` フックは無視されます。

279 293 

280PATH で解決された `claude` ではなく、ランナー自身のバイナリに常に `exec` してください。そうしないと、[バージョンピンニング](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#pin-the-version)を無効にしてしまいます。294PATH で解決された `claude` ではなく、ランナー自身のバイナリに常に `exec` してください。そうしないと、[バージョンピンニング](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#pin-the-version)を無効にしてしまいます。

281 295 

523 537 

524* **メタデータエンドポイント**：セッションに対して[クラウドメタデータエンドポイント](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#harden-your-deployment)を完全に拒否すると、インスタンスプロファイルなど、そこから提供される認証情報も Claude Code に届きません。Amazon EKS の IAM Roles for Service Accounts（IRSA）や Workload Identity Federation の認証情報ファイルなど、ファイルベースの Web ID はこれに依存しません。538* **メタデータエンドポイント**：セッションに対して[クラウドメタデータエンドポイント](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#harden-your-deployment)を完全に拒否すると、インスタンスプロファイルなど、そこから提供される認証情報も Claude Code に届きません。Amazon EKS の IAM Roles for Service Accounts（IRSA）や Workload Identity Federation の認証情報ファイルなど、ファイルベースの Web ID はこれに依存しません。

525* **更新**：セッションは認証情報よりも長く存続する場合があるため、ファイルベースの Web ID など、自動的に更新される方法を使用してください539* **更新**：セッションは認証情報よりも長く存続する場合があるため、ファイルベースの Web ID など、自動的に更新される方法を使用してください

526* **ラッパースクリプト**：ランナーは[ラッパースクリプト](#provision-credentials-scoped-to-the-session-creator)をセッションごとに 1 回起動するため、そこでエクスポートした認証情報は更新されません。Claude Code は環境から AWS 認証情報を読み取るため、ラッパーが他の作業のためにすでに AWS 認証情報をエクスポートしている場合、Claude Code はそれを使用してモデルリクエストに署名する可能性があります。540* **ラッパースクリプト**：[ラッパースクリプト](#provision-credentials-scoped-to-the-session-creator)がエクスポートする認証情報の値は Claude Code の実行中に更新されないため、長時間のセッションでは自動的に更新される方法を使用してください。Claude Code は環境から AWS 認証情報を読み取るため、ラッパーが他の作業のためにすでに AWS 認証情報をエクスポートしている場合、Claude Code はそれを使用してモデルリクエストに署名する可能性があります。

527 541 

528**3. ランナーの環境に 1 つのプロバイダーの変数を設定する**542**3. ランナーの環境に 1 つのプロバイダーの変数を設定する**

529 543 

827 827 

828### 一部のセッションはアイドルとみなされない828### 一部のセッションはアイドルとみなされない

829 829 

830終了しないバックグラウンドタスクを保持しているセッションはアイドルとみなされないため、`--release-idle-session-min` はそのセッションのスロットを解放しません。実行中のツール呼び出しの内部から要求された承認を待っているセッションも、アイドルとみなされません。どのセッションもスロットを無期限に保持できないように、厳格な安全策として必ず `--kill-session-after-min` を併せて設定してください。830実行し続けるバックグラウンドタスクを保持しているセッションはアイドルとみなされないため、`--release-idle-session-min` はそのセッションのスロットを解放しません。実行中のツール呼び出しの内部から要求された承認を待っているセッションも、アイドルとみなされません。厳格な安全策として、`--kill-session-after-min` を併せて設定してください。

831 831 

832`--kill-session-after-min` は、暴走したセッションに対する安全策です。v2.1.260 以降のランナーでは、上限に達したセッションはただちに終了されません。ランナーはそのセッションに猶予期間（デフォルトは 15 分）を与えます。この期間は [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](https://code.claude.com/docs/ja/self-hosted-environments-reference#environment-variable-only-settings) で変更できます。832`--kill-session-after-min` は、暴走したセッションに対する安全策です。v2.1.260 以降のランナーでは、上限に達したセッションはただちに終了されません。ランナーはそのセッションに猶予期間（デフォルトは 15 分）を与えます。この期間は [`SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS`](https://code.claude.com/docs/ja/self-hosted-environments-reference#environment-variable-only-settings) で変更できます。

833 833 

153}153}

154```154```

155 155 

156カスタムプローブでライブネスシグナルとして `last_poll_age_ms` を使用します。無限に増加する値は、ポーリングループがスタックしていることを示します。`last_poll_at` と `last_poll_age_ms` の両方は、最初のポーリングが完了するまで `null` です。156`last_poll_age_ms` に対してアラートを設定しますが、ライブネスプローブには使用しないでください。ライブネスプローブは HTTP ステータスコードに基づくようにしてください。この値は最後に成功したポーリングからの経過時間であるため、ランナーが Anthropic に到達できない間も増加します。`last_poll_at` と `last_poll_age_ms` の両方は、最初のポーリングが成功するまで `null` です。最初から失敗しているポーリングを検出するには、[Prometheus メトリクス](#prometheus-metrics)に記載されている `claude_code_self_hosted_runner_poll_errors_total` に対してもアラートを設定してください。

157 157 

158オーケストレーター自身の `/healthz` は、そのヘルスポート上で常に `200` を返します。ボディには、最新のポーリングが成功したかどうかを報告する `connected` フィールドと、`queue_counts` 内の状態ごとのスポーンキュー数が含まれます。`connected` が `false` である理由を確認するには、トップレベルの `last_error` フィールドを参照してください。このフィールドはポーリングが成功するたびに `null` にリセットされます。ステータスコードではなく `connected` でレディネスとアラートをゲートします。158オーケストレーター自身の `/healthz` は、そのヘルスポート上で常に `200` を返します。ボディには、最新のポーリングが成功したかどうかを報告する `connected` フィールドと、`queue_counts` 内の状態ごとのスポーンキュー数が含まれます。`connected` が `false` である理由を確認するには、トップレベルの `last_error` フィールドを参照してください。このフィールドはポーリングが成功するたびに `null` にリセットされます。ステータスコードではなく `connected` でレディネスとアラートをゲートします。

159 159 

313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/ja/settings-reference#automode-classifyallshell) | `~/.claude/settings.json` または `--settings` からの `true` | 管理ソースが `false` を設定していても尊重されます |313| [`autoMode.classifyAllShell`](https://code.claude.com/docs/ja/settings-reference#automode-classifyallshell) | `~/.claude/settings.json` または `--settings` からの `true` | 管理ソースが `false` を設定していても尊重されます |

314| [`remoteControlAtStartup`](https://code.claude.com/docs/ja/settings-reference#remotecontrolatstartup) | `.claude/settings.json` または `.claude/settings.local.json` からの `false` | 管理ソースが `true` を設定していても尊重されます。プロジェクトまたはローカルの `true` は無視されます |314| [`remoteControlAtStartup`](https://code.claude.com/docs/ja/settings-reference#remotecontrolatstartup) | `.claude/settings.json` または `.claude/settings.local.json` からの `false` | 管理ソースが `true` を設定していても尊重されます。プロジェクトまたはローカルの `true` は無視されます |

315| [`crossSessionInbound`](https://code.claude.com/docs/ja/settings-reference#crosssessioninbound) | `.claude/settings.json` または `.claude/settings.local.json` からの、`accept` \< `hold` \< `refuse` の段階でより厳格な値 | 管理設定、`--settings`、ユーザーの値より優先して尊重されます。より厳格でないプロジェクトまたはローカルの値は無視されます |315| [`crossSessionInbound`](https://code.claude.com/docs/ja/settings-reference#crosssessioninbound) | `.claude/settings.json` または `.claude/settings.local.json` からの、`accept` \< `hold` \< `refuse` の段階でより厳格な値 | 管理設定、`--settings`、ユーザーの値より優先して尊重されます。より厳格でないプロジェクトまたはローカルの値は無視されます |

316| [`useAutoModeDuringPlan`](https://code.claude.com/docs/ja/settings-reference#useautomodeduringplan) | 任意の管理ソース、`--settings`、`~/.claude/settings.json`、または `.claude/settings.local.json` からの `false` | 優先される管理ソースが `true` を設定していても尊重されます。`.claude/settings.json` 内の `false` は無視されます |316| [`useAutoModeDuringPlan`](https://code.claude.com/docs/ja/settings-reference#useautomodeduringplan) | 任意の管理ソース、`--settings`、`~/.claude/settings.json`、または `.claude/settings.local.json` からの `false` | 優先される管理ソースが `true` を設定していても尊重されます。`.claude/settings.json` 内の `false` は無視されます。起動時に除外するファイルについては[このキーの項目](https://code.claude.com/docs/ja/settings-reference.md#useautomodeduringplan)を参照してください |

317| [`syncClaudeAiSkills`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiskills) | 任意の管理ソース、`--settings`、`~/.claude/settings.json`、または `.claude/settings.local.json` からの `false` | 優先される管理ソースが `true` を設定していても尊重されます。`.claude/settings.json` 内の `false` は無視されます |317| [`syncClaudeAiSkills`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiskills) | 任意の管理ソース、`--settings`、`~/.claude/settings.json`、または `.claude/settings.local.json` からの `false` | 優先される管理ソースが `true` を設定していても尊重されます。`.claude/settings.json` 内の `false` は無視されます |

318| [`syncClaudeAiPlugins`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiplugins) | 任意の管理ソース、`--settings`、`~/.claude/settings.json`、または `.claude/settings.local.json` からの `false` | 優先される管理ソースが `true` を設定していても尊重されます。`.claude/settings.json` 内の `false` は無視されます |318| [`syncClaudeAiPlugins`](https://code.claude.com/docs/ja/settings-reference#syncclaudeaiplugins) | 任意の管理ソース、`--settings`、`~/.claude/settings.json`、または `.claude/settings.local.json` からの `false` | 優先される管理ソースが `true` を設定していても尊重されます。`.claude/settings.json` 内の `false` は無視されます |

319| [`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) | `--settings` を含む任意のスコープからの、より低い上限 | Claude Code が適用する管理設定がより高い上限を設定していても尊重され、最も低い上限が適用されます。Claude Code v2.1.267 以降が必要です |319| [`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) | `--settings` を含む任意のスコープからの、より低い上限 | Claude Code が適用する管理設定がより高い上限を設定していても尊重され、最も低い上限が適用されます。Claude Code v2.1.267 以降が必要です |

925Claude Code が plan モード中にシェルコマンドを確認するために auto モードの分類器を使用するかどうかを選択します。デフォルトの `true` では、auto モードが利用可能な場合、分類器は計画中に各コマンドを確認し、プロンプトは表示されません。ただし、[重要パスの削除](https://code.claude.com/docs/ja/permission-modes.md#critical-paths)を除きます。`false` に設定すると、組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトが表示されます。`/config` に **Use auto mode during plan** として表示されます。925Claude Code が plan モード中にシェルコマンドを確認するために auto モードの分類器を使用するかどうかを選択します。デフォルトの `true` では、auto モードが利用可能な場合、分類器は計画中に各コマンドを確認し、プロンプトは表示されません。ただし、[重要パスの削除](https://code.claude.com/docs/ja/permission-modes.md#critical-paths)を除きます。`false` に設定すると、組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトが表示されます。`/config` に **Use auto mode during plan** として表示されます。

926 926 

927* **スコープ**: [`User, local, or managed`](#scopes)。リポジトリがこれをオフにすることはできません。927* **スコープ**: [`User, local, or managed`](#scopes)。リポジトリがこれをオフにすることはできません。

928 * これらのファイルのいずれか、または `--settings` で `false` が設定されていると、オフになります。ただし、[`--setting-sources`](https://code.claude.com/docs/ja/cli-reference#cli-flags) などのオプションでそのユーザーまたはローカルファイルを除外した場合は除きます。除外されたファイルを無視するには Claude Code v2.1.314 以降が必要です

928* **タイプ**: ブール値929* **タイプ**: ブール値

929 * `true`: 未設定と同じです。auto モードが利用可能な場合、分類器は計画中に各シェルコマンドを確認し、プロンプトを表示しません。ただし、[重要パスの削除](https://code.claude.com/docs/ja/permission-modes.md#critical-paths)を除きます。これらのファイルのいずれかで `false` が設定されていれば、引き続きオフになります930 * `true`: 未設定と同じです。auto モードが利用可能な場合、分類器は計画中にシェルコマンドを確認します

930 * `false`: 組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトが表示されます931 * `false`: 組み込みの読み取り専用セット外のすべてのコマンドに対して権限プロンプトが表示されます

931* **デフォルト**: `true`932* **デフォルト**: `true`

932 933 

2073 2074 

2074### `sandbox.network.allowMachLookup`2075### `sandbox.network.allowMachLookup`

2075 2076 

2076macOS サンドボックスが検索できる追加の XPC および Mach サービス名をリストします。iOS Simulator や Playwright などの XPC を通じて通信するツールは、ここにサービスをリストする必要があります。2077macOS のサンドボックスが参照できる追加の XPC および Mach サービス名を記載します。iOS Simulator や Playwright など、XPC で通信するツールは、そのサービスをここに記載する必要があります。サンドボックス化されたコマンドは、記載した各サービスにサンドボックスの外からアクセスでき、サンドボックスは[それらのサービスがコマンドのために行う処理を制限しません](https://code.claude.com/docs/ja/sandboxing.md#security-limitations)。

2077 2078 

2078* **Scope**: [`Any file`](#scopes)（[プロジェクト設定とローカル設定には制限あり](https://code.claude.com/docs/ja/sandboxing.md#repository-settings-under-an-admin-required-sandbox)）2079* **Scope**: [`Any file`](#scopes)（[プロジェクト設定とローカル設定には制限あり](https://code.claude.com/docs/ja/sandboxing.md#repository-settings-under-an-admin-required-sandbox)）

2079* **Type**: 文字列の配列。各サービス名。単一の末尾 `*` はプレフィックスと一致し、`"*"` だけはすべてのサービスと一致します2080* **Type**: 文字列の配列。各サービス名。単一の末尾 `*` はプレフィックスと一致し、`"*"` だけはすべてのサービスと一致します

2422 2423 

2423 プロジェクト設定とローカル設定でこのグループを無視する動作には、Claude Code v2.1.282 以降が必要です。2424 プロジェクト設定とローカル設定でこのグループを無視する動作には、Claude Code v2.1.282 以降が必要です。

2424 * Claude Code の起動方法や同期方法を変更する変数（`CLAUDE_CODE_PROCESS_WRAPPER`、`CLAUDE_CODE_SYNC_SKILLS`、`CLAUDE_CODE_SYNC_PLUGINS`、`CLAUDE_CODE_PLUGIN_CACHE_DIR`、`CLAUDE_CODE_PLUGIN_SEED_DIR` など）。2425 * Claude Code の起動方法や同期方法を変更する変数（`CLAUDE_CODE_PROCESS_WRAPPER`、`CLAUDE_CODE_SYNC_SKILLS`、`CLAUDE_CODE_SYNC_PLUGINS`、`CLAUDE_CODE_PLUGIN_CACHE_DIR`、`CLAUDE_CODE_PLUGIN_SEED_DIR` など）。

2426 * claude.ai のサインインを設定する変数（[`CLAUDE_CODE_OAUTH_TOKEN`、`CLAUDE_CODE_OAUTH_REFRESH_TOKEN`、`CLAUDE_CODE_OAUTH_SCOPES`](https://code.claude.com/docs/ja/env-vars#variables) など）。

2425 * [スクリーンリーダーモード](https://code.claude.com/docs/ja/accessibility.md)の変数 `CLAUDE_AX_SCREEN_READER`、および名前が `CLAUDE_AX_` で始まるその他の変数（[`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/ja/env-vars#variables) など）。2427 * [スクリーンリーダーモード](https://code.claude.com/docs/ja/accessibility.md)の変数 `CLAUDE_AX_SCREEN_READER`、および名前が `CLAUDE_AX_` で始まるその他の変数（[`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/ja/env-vars#variables) など）。

2426 * 応答のないダイアログのタイマーを設定する [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/ja/env-vars#variables)。2428 * 応答のないダイアログのタイマーを設定する [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/ja/env-vars#variables)。

2427 * 添付ファイルの処理をオフにする [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/ja/env-vars#variables)。2429 * 添付ファイルの処理をオフにする [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/ja/env-vars#variables)。

40>40>

41> **macOS、Linux、WSL：**41> **macOS、Linux、WSL：**

42>42>

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

44> curl -fsSL https://claude.ai/install.sh | bash44> curl -fsSL https://claude.ai/install.sh | bash

45> ```45> ```

46>46>

48>48>

49> **Windows PowerShell：**49> **Windows PowerShell：**

50>50>

51> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}51> ```powershell theme={null}

52> irm https://claude.ai/install.ps1 | iex52> irm https://claude.ai/install.ps1 | iex

53> ```53> ```

54>54>

55> **Windows CMD：**55> **Windows CMD：**

56>56>

57> ```batch theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}57> ```batch theme={null}

58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd58> curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

59> ```59> ```

60>60>

72 72 

73> [tab] Homebrew73> [tab] Homebrew

74>74>

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

76> brew install --cask claude-code76> brew install --cask claude-code

77> ```77> ```

78>78>

84 84 

85> [tab] WinGet85> [tab] WinGet

86>86>

87> ```powershell theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}87> ```powershell theme={null}

88> winget install Anthropic.ClaudeCode88> winget install Anthropic.ClaudeCode

89> ```89> ```

90>90>

416 416 

417フォーク以外のサブエージェントを特定の effort レベルで実行するよう Claude に依頼すると、Claude はその呼び出しに `effort` パラメータを渡すこともできます。このパラメータは `effort` フィールドを上書きし、サブエージェントが[再開](#resume-subagents)されたときも有効なままです。[`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/ja/env-vars#variables) 環境変数は、その両方よりも優先されます。呼び出しごとのパラメータには Claude Code v2.1.292 以降が必要です。417フォーク以外のサブエージェントを特定の effort レベルで実行するよう Claude に依頼すると、Claude はその呼び出しに `effort` パラメータを渡すこともできます。このパラメータは `effort` フィールドを上書きし、サブエージェントが[再開](#resume-subagents)されたときも有効なままです。[`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/ja/env-vars#variables) 環境変数は、その両方よりも優先されます。呼び出しごとのパラメータには Claude Code v2.1.292 以降が必要です。

418 418 

419#### サブエージェントに `effort` フィールドもパラメータもない場合

420 

421メインの会話のモデルで実行される場合、サブエージェントは `/effort` などでセッション内で選択したレベル、または `--effort` で設定したレベルで実行されます。別のモデルでは、[そのレベルは適用されません](https://code.claude.com/docs/ja/model-config.md#effort-level-of-subagents-and-teammates)。レベルを選択するには、`effort` フィールドを設定します。

422 

419### サブエージェントの機能を制御する423### サブエージェントの機能を制御する

420 424 

421ツールへのアクセス、権限モード、条件付きルールによって、サブエージェントができることを制御できます。425ツールへのアクセス、権限モード、条件付きルールによって、サブエージェントができることを制御できます。

69 69 

70この接続により、セッションは任意のパブリックリポジトリをクローンできますが、プライベートリポジトリで機能するのは Claude GitHub App がインストールされている場合のみです。[Claude GitHub App をインストール](https://github.com/apps/claude/installations/new) してください。使用したいプライベートリポジトリを持つ各 GitHub アカウントまたは Organization に対してインストールします。GitHub Organization では、Organization オーナーがインストールを承認する必要がある場合があります。App をインストールすると、[Auto-fix](https://code.claude.com/docs/ja/claude-code-on-the-web.md#auto-fix-pull-requests) も有効になります。これにより、Claude はこれらのリポジトリの pull request の CI 失敗とレビューコメントに応答できます。70この接続により、セッションは任意のパブリックリポジトリをクローンできますが、プライベートリポジトリで機能するのは Claude GitHub App がインストールされている場合のみです。[Claude GitHub App をインストール](https://github.com/apps/claude/installations/new) してください。使用したいプライベートリポジトリを持つ各 GitHub アカウントまたは Organization に対してインストールします。GitHub Organization では、Organization オーナーがインストールを承認する必要がある場合があります。App をインストールすると、[Auto-fix](https://code.claude.com/docs/ja/claude-code-on-the-web.md#auto-fix-pull-requests) も有効になります。これにより、Claude はこれらのリポジトリの pull request の CI 失敗とレビューコメントに応答できます。

71 71 

72接続すると、Claude は、自分が所有する GitHub アカウントのうち Claude GitHub App がインストールされているものを Claude 組織にもリンクします。Team および Enterprise プランでは、管理者は [接続済み GitHub アカウントのリスト](https://code.claude.com/docs/ja/admin-setup.md#connected-github-accounts) でそれらのアカウントを確認できます。72接続すると、Claude は、自分が所有する GitHub アカウントのうち Claude GitHub App がインストールされているものを Claude 組織にもリンクします。Team および Enterprise プランでは、Claude 組織の Owner は [接続済み GitHub アカウントのリスト](https://code.claude.com/docs/ja/admin-setup.md#connected-github-accounts) でそれらのアカウントを確認できます。

73 73 

74オンボーディングがこの時点で Claude GitHub App をインストールするよう促し、後で実行したい場合は、**Skip** をクリックします。74オンボーディングがこの時点で Claude GitHub App をインストールするよう促し、後で実行したい場合は、**Skip** をクリックします。

75 75