Documentation 2026-10-28 23:57 UTC to 2026-10-29 23:57 UTC

75| :- | :- | :- |75| :- | :- | :- |

76| `"project"` | プロジェクト `settings.json` とフック；プロジェクト CLAUDE.md と `.claude/rules/*.md`；プロジェクトスキル、コマンド、サブエージェント | `<cwd>/.claude/` （`settings.json` とフック用）；CLAUDE.md とルール用に `<cwd>` と全親ディレクトリ；スキル、コマンド、サブエージェント用に `<cwd>` とリポジトリルートまでの全親ディレクトリ、および `additionalDirectories` または `add_dirs` オプション経由で渡す各ディレクトリの `.claude/skills/`、`.claude/commands/`、`.claude/agents/` フォルダ（SDK は Claude Code に [`--add-dir`](https://code.claude.com/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) として渡します） |76| `"project"` | プロジェクト `settings.json` とフック；プロジェクト CLAUDE.md と `.claude/rules/*.md`；プロジェクトスキル、コマンド、サブエージェント | `<cwd>/.claude/` （`settings.json` とフック用）；CLAUDE.md とルール用に `<cwd>` と全親ディレクトリ；スキル、コマンド、サブエージェント用に `<cwd>` とリポジトリルートまでの全親ディレクトリ、および `additionalDirectories` または `add_dirs` オプション経由で渡す各ディレクトリの `.claude/skills/`、`.claude/commands/`、`.claude/agents/` フォルダ（SDK は Claude Code に [`--add-dir`](https://code.claude.com/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) として渡します） |

77| `"user"` | ユーザー `settings.json`；ユーザー CLAUDE.md と `~/.claude/rules/*.md`；ユーザースキル、コマンド、サブエージェント | `~/.claude/` （`settings.json`、CLAUDE.md、ルール用）；`~/.claude/skills/`、`~/.claude/commands/`、`~/.claude/agents/` （スキル、コマンド、サブエージェント用） |77| `"user"` | ユーザー `settings.json`；ユーザー CLAUDE.md と `~/.claude/rules/*.md`；ユーザースキル、コマンド、サブエージェント | `~/.claude/` （`settings.json`、CLAUDE.md、ルール用）；`~/.claude/skills/`、`~/.claude/commands/`、`~/.claude/agents/` （スキル、コマンド、サブエージェント用） |

78| `"local"` | CLAUDE.local.md、`.claude/settings.local.json` | `<cwd>/.claude/` （`settings.local.json` 用）；CLAUDE.local.md 用に `<cwd>` と全親ディレクトリ |78| `"local"` | CLAUDE.local.md、`.claude/settings.local.json` | `<cwd>/.claude/` （`settings.local.json` 用。`<cwd>` が git リポジトリ内にある場合は[リポジトリのルートから読み込まれることもあります](https://code.claude.com/docs/ja/settings.md#where-claude-code-keeps-the-local-file-in-a-git-repository)）；CLAUDE.local.md 用に `<cwd>` と全親ディレクトリ |

79 79 

80`settingSources` を省略することは `["user", "project", "local"]` と同等です。80`settingSources` を省略することは `["user", "project", "local"]` と同等です。

81 81 

82`cwd` オプションは、SDK がプロジェクトレベルの入力を探す場所を決定します。プロジェクト `settings.json` とフックは `<cwd>/.claude/` からのみ読み込まれ、親ディレクトリへのフォールバックはありません。82`cwd` オプションは、SDK がプロジェクトレベルの入力を探す場所を決定します。プロジェクト `settings.json` は `<cwd>/.claude/` から読み込まれ、親ディレクトリへのフォールバックはありません。

83 83 

84### settingSources が制御しないもの84### settingSources が制御しないもの

85 85 

3321 3321 

3322### TaskStop3322### TaskStop

3323 3323 

3324**ツール名：** `TaskStop`。以前の名前 `KillShell` と `KillBash` はまだエイリアスとして受け入れられています。3324**ツール名：** `TaskStop`。以前の名前 `KillShell` と `KillBash` は、権限ルール、フックの matcher、および `tools`、`allowed_tools`、`disallowed_tools` オプションで引き続き使用できます。

3325 3325 

3326**入力：**3326**入力：**

3327 3327 

263* **新規セッション、またはストアがセッションに何も持っていない場合の再開**：設定ディレクトリの下のローカルトランスクリプトが実行を超えて存続し、ストアはコピーを受け取ります。263* **新規セッション、またはストアがセッションに何も持っていない場合の再開**：設定ディレクトリの下のローカルトランスクリプトが実行を超えて存続し、ストアはコピーを受け取ります。

264* **[ストアから再開](#resume-from-the-store)**：ローカルコピーは実行終了時に削除されるため、ストアが唯一の耐久性のあるコピーを保持します。264* **[ストアから再開](#resume-from-the-store)**：ローカルコピーは実行終了時に削除されるため、ストアが唯一の耐久性のあるコピーを保持します。

265 265 

266新規セッションがローカルディスクにトランスクリプトを残さないようにしたい場合は、`options.env` の一時ディレクトリに `CLAUDE_CONFIG_DIR` を設定します。ストアから再開した実行は既にローカルコピーを削除するため、そのような設定は必要ありません。TypeScript では、[`env` オプション](https://code.claude.com/docs/ja/agent-sdk/typescript#options)がサブプロセス環境を置き換えるため、`process.env` を `env` に展開します。266新規セッションがローカルディスクにトランスクリプトを残さないようにしたい場合は、`options.env` で `CLAUDE_CONFIG_DIR` を新しいプライベートな一時ディレクトリに設定します。ストアから再開した実行は既にローカルコピーを削除するため、そのような設定は必要ありません。TypeScript では、[`env` オプション](https://code.claude.com/docs/ja/agent-sdk/typescript#options)がサブプロセス環境を置き換えるため、`process.env` も `env` に展開します。

267 267 

268アプリが設定ディレクトリ内のファイル（OAuth 認証情報や user `settings.json` の `apiKeyHelper` など）を通じてサインインする場合は、これらのファイルを一時ディレクトリに最初にコピーするか、代わりに `env` で `ANTHROPIC_API_KEY` を設定します。そうしないと、実行は `Not logged in` で失敗します。268`CLAUDE_CONFIG_DIR` を一時ディレクトリに設定し、[claude.ai ログイン](https://code.claude.com/docs/ja/authentication.md#credential-management)または user `settings.json` の [`apiKeyHelper`](https://code.claude.com/docs/ja/settings-reference#apikeyhelper) でサインインしている場合、実行は `Not logged in` で失敗します。実行を認証するには、長期間有効なトークンを設定するか、API キーを設定するか、設定ファイルをコピーします。

269 

270* **長期間有効なトークン**：自分の Claude サブスクリプションでエージェントを自分で実行する場合は、`env` で `CLAUDE_CODE_OAUTH_TOKEN` を [`claude setup-token`](https://code.claude.com/docs/ja/authentication#generate-a-long-lived-token) で取得したトークンに設定します。そのトークンではモデルリクエストしか行えないため、その実行では [claude.ai コネクタ](https://code.claude.com/docs/ja/mcp.md#use-mcp-servers-from-claude-ai)を利用できません。

271* **API キー**：`env` で `ANTHROPIC_API_KEY` を設定します。

272* **設定ファイル**：OAuth 認証情報や user `settings.json` の `apiKeyHelper` など、通常の設定ディレクトリ内のファイルを通じてサインインする場合は、それらを一時ディレクトリにコピーします。

269 273 

2702 つのオプションはミラーと競合し、SDK はいずれかをストアと組み合わせた場合、スタートアップ時にスローします。2742 つのオプションはミラーと競合し、SDK はいずれかをストアと組み合わせた場合、スタートアップ時にスローします。

271 275 

730 730 

731セッション途中で有効になるのは一部のキーのみです。731セッション途中で有効になるのは一部のキーのみです。

732 732 

733* **次のターンで適用**：`effortLevel`、`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`agent`。`agent` を切り替えると、そのエージェントのモデルの上書きとフックも次のターンで適用されます。そのエージェントのシステムプロンプトは次のターンで適用されます。ただし、[記録されたシステムプロンプトを再利用する](https://code.claude.com/docs/ja/agent-sdk/modifying-system-prompts.md#change-the-prompt-of-an-existing-session)セッションでは、セッションが圧縮された時点で適用されます。733* **次のターンで適用**：`ultracode`、`permissions`、`hooks`、`skillOverrides`、`fastMode`、`agent`。`agent` を切り替えると、そのエージェントのモデルの上書きとフックも次のターンで適用されます。そのシステムプロンプトは次のターンで適用されます。[記録されたシステムプロンプトを再利用する](https://code.claude.com/docs/ja/agent-sdk/modifying-system-prompts.md#change-the-prompt-of-an-existing-session)セッションでは、セッションが圧縮された時点で適用されます。

734* **現在のターン中に適用**：`model`。Claude がターンの処理中に `model` を切り替えた場合、Claude がすでに生成中の応答は古いモデルで完了し、Claude Code がモデルに対して行う次の呼び出しから始まるターンの残りの部分では新しいモデルが使用されます。サブエージェントは独自のモデルを維持します。v2.1.212 より前は、ターン途中の切り替えは次のターンまで待機していました。734* **現在のターン中に適用**：`model`。Claude がターンの処理中に `model` を切り替えた場合、Claude がすでに生成中の応答は古いモデルで完了し、Claude Code がモデルに対して行う次の呼び出しから始まるターンの残りの部分では新しいモデルが使用されます。サブエージェントは独自のモデルを維持します。v2.1.212 より前は、ターン途中の切り替えは次のターンまで待機していました。

735* **次のターンまでに適用**：`effortLevel`。レベルは Claude Code によるモデルへの次の呼び出しから適用されます。API キーまたは Claude のサブスクリプションを使用した Claude Opus 5.5 のように、[effort を変更してもプロンプトキャッシュが維持される](https://code.claude.com/docs/ja/prompt-caching.md#changing-effort-level)場合は、代わりに次のターンで適用されると考えてください。

735* **セッション途中では効果なし**：システムプロンプトのオプション。これらは起動時に一度だけ解決されるため、呼び出しが成功しても実行中のセッションは元の値を保持します。変更するには新しいセッションを開始してください。736* **セッション途中では効果なし**：システムプロンプトのオプション。これらは起動時に一度だけ解決されるため、呼び出しが成功しても実行中のセッションは元の値を保持します。変更するには新しいセッションを開始してください。

736 737 

737`effortLevel` は [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)の名前を受け付けます。また、[ultracode](https://code.claude.com/docs/ja/workflows.md#let-claude-decide-with-ultracode) をオンにした状態で `xhigh` effort を要求する `"ultracode"` も受け付けます。`applyFlagSettings()` は `effortLevel` をこの値を含めずに宣言しているため、TypeScript で同じ結果を得るには `{ ultracode: true, effortLevel: "xhigh" }` を渡すか、セッションの現在の effort レベルで ultracode をオンにするには [`ultracode`](https://code.claude.com/docs/ja/settings-reference#ultracode) キーのみを渡します。`ultracode` 値には Claude Code v2.1.203 以降が必要で、`applyFlagSettings()` でのみ受け付けられ、設定ファイルの `effortLevel` キーでは受け付けられません。v2.1.284 より前は、`ultracode` キーのみを指定した場合もレベルが `xhigh` に設定されていました。738`effortLevel` は [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)の名前を受け付けます。また、[ultracode](https://code.claude.com/docs/ja/workflows.md#let-claude-decide-with-ultracode) をオンにした状態で `xhigh` effort を要求する `"ultracode"` も受け付けます。`applyFlagSettings()` は `effortLevel` をこの値を含めずに宣言しているため、TypeScript で同じ結果を得るには `{ ultracode: true, effortLevel: "xhigh" }` を渡すか、セッションの現在の effort レベルで ultracode をオンにするには [`ultracode`](https://code.claude.com/docs/ja/settings-reference#ultracode) キーのみを渡します。`ultracode` 値には Claude Code v2.1.203 以降が必要で、`applyFlagSettings()` でのみ受け付けられ、設定ファイルの `effortLevel` キーでは受け付けられません。v2.1.284 より前は、`ultracode` キーのみを指定した場合もレベルが `xhigh` に設定されていました。

738 739 

739値はフラグ設定レイヤーに書き込まれ、`query()` のインライン `settings` オプションが起動時に設定した内容の上にマージされます。これは、[このページの優先順位セクション](#settings-precedence)でプログラムによるオプションと呼んでいる階層と同じです。740値はフラグ設定レイヤーに書き込まれ、`query()` のインライン `settings` オプションが起動時に設定した内容の上にマージされます。これは、[このページの優先順位セクション](#settings-precedence)でプログラムによるオプションと呼んでいるのと同じ階層です。`effortLevel` は例外で、[effort の解決順序](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)が示すように、渡したレベルは `--effort` や設定（管理設定を含む）で指定されたレベルを置き換えます。

740 741 

741連続した呼び出しでは、トップレベルのキーが浅くマージされます。`{ permissions: {...} }` を指定した 2 回目の呼び出しは、前回の呼び出しの `permissions` オブジェクトに深くマージされるのではなく、オブジェクト全体を置き換えます。742連続した呼び出しでは、トップレベルのキーが浅くマージされます。`{ permissions: {...} }` を指定した 2 回目の呼び出しは、前回の呼び出しの `permissions` オブジェクトに深くマージされるのではなく、オブジェクト全体を置き換えます。

742 743 

13272. プロジェクト設定（`.claude/settings.json`）13282. プロジェクト設定（`.claude/settings.json`）

13283. ユーザー設定（`~/.claude/settings.json`）13293. ユーザー設定（`~/.claude/settings.json`）

1329 1330 

1330`agents`、`allowedTools`、`settings` などのプログラムによるオプションは、ユーザー、プロジェクト、ローカルのファイルシステム設定を上書きします。管理ポリシー設定は、プログラムによるオプションよりも優先されます。1331`agents`、`allowedTools`、`settings` などのプログラムによるオプションは、ユーザー、プロジェクト、ローカルのファイルシステム設定を上書きします。管理ポリシーの設定とプログラムによるオプションが同じキーを設定している場合は管理側の値が適用されますが、[`applyFlagSettings()`](#applyflagsettings) に渡された `effortLevel` などの例外があります。

1331 1332 

1332### `PermissionMode`1333### `PermissionMode`

1333 1334 

2095`terminal_slash_commands` は、`slash_commands` のエントリのうち、`exit` など、インターフェースがローカルターミナルに結び付いているものを示します。これらは `slash_commands` の他のエントリと同様に送信できます。このフィールドは、リモートクライアントやモバイルクライアントがコマンドメニューからそれらを非表示にできるようにするために存在します。このフィールドは空でない場合にのみ存在し、Agent SDK v0.3.229 以降が必要です。2096`terminal_slash_commands` は、`slash_commands` のエントリのうち、`exit` など、インターフェースがローカルターミナルに結び付いているものを示します。これらは `slash_commands` の他のエントリと同様に送信できます。このフィールドは、リモートクライアントやモバイルクライアントがコマンドメニューからそれらを非表示にできるようにするために存在します。このフィールドは空でない場合にのみ存在し、Agent SDK v0.3.229 以降が必要です。

2096 2097 

2097* 各 `mcp_servers` エントリの `source`: サーバーの定義の取得元で、[`McpServerStatus`](#mcpserverstatus) の `source` と同じ値を取ります。Agent SDK v0.3.274 以降が必要です。2098* 各 `mcp_servers` エントリの `source`: サーバーの定義の取得元で、[`McpServerStatus`](#mcpserverstatus) の `source` と同じ値を取ります。Agent SDK v0.3.274 以降が必要です。

2098* `effort`: Claude Code がセッションの次のリクエストで送信する [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)、または送信しない場合は `null`。Claude Code はこのフィールドを [Remote Control](https://code.claude.com/docs/ja/remote-control.md) クライアントに送信する init メッセージにのみ設定し、アプリケーションが読み取る init メッセージからは省略します。Agent SDK v0.3.234 以降が必要です。2099* `effort`: セッションの次のターンに設定された [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)、または Claude Code がレベルを送信しない場合は `null` です。Claude Code はこのフィールドを [Remote Control](https://code.claude.com/docs/ja/remote-control.md) クライアントに送信する init メッセージにのみ設定し、アプリケーションが読み取る init メッセージからは省略します。Agent SDK v0.3.234 以降が必要です。

2099 2100 

2100`capabilities` 配列は、この CLI が実装しているプロトコルの動作を示すため、`claude_code_version` の文字列を比較する代わりに機能検出を行えます。これはオープンな集合です。認識できない値は無視し、依存する動作に対応する特定の capability があるかを確認してください。このフィールドには Claude Code v2.1.205 以降が必要で、それより前の CLI には存在しません。2101`capabilities` 配列は、この CLI が実装しているプロトコルの動作を示すため、`claude_code_version` の文字列を比較する代わりに機能検出を行えます。これはオープンな集合です。認識できない値は無視し、依存する動作に対応する特定の capability があるかを確認してください。このフィールドには Claude Code v2.1.205 以降が必要で、それより前の CLI には存在しません。

2101 2102 

369| 要件 | 利用可能な場合 |369| 要件 | 利用可能な場合 |

370| :- | :- |370| :- | :- |

371| プラン | Pro、Max、Team、または Enterprise。Pro および Max プランでは、Artifacts は共有するまであなたのみがアクセスでき、管理者管理は適用されません。Team および Enterprise プランでは、Artifacts はデフォルトで有効です。Owner が claude.ai 管理設定で[それらを組織に対して無効にする](#manage-artifacts-for-your-organization)ことができます。 |371| プラン | Pro、Max、Team、または Enterprise。Pro および Max プランでは、Artifacts は共有するまであなたのみがアクセスでき、管理者管理は適用されません。Team および Enterprise プランでは、Artifacts はデフォルトで有効です。Owner が claude.ai 管理設定で[それらを組織に対して無効にする](#manage-artifacts-for-your-organization)ことができます。 |

372| 認証 | セッションが claude.ai アカウントでサポートされています。CLI またはデスクトップアプリで `/login` でサインインします。Claude Tag セッションはエージェントの ID を通じてサインインするため、追加の手順は不要です。API キー、[ゲートウェイトークン](https://code.claude.com/docs/ja/llm-gateway)、またはクラウドプロバイダー認証情報を使用するセッションは公開できません。 |372| 認証 | セッションが claude.ai アカウントでサポートされています。CLI またはデスクトップアプリで `/login` でサインインします。Claude Tag セッションではサインイン手順は不要です。API キー、[ゲートウェイトークン](https://code.claude.com/docs/ja/llm-gateway)、またはクラウドプロバイダー認証情報を使用するセッションは公開できません。 |

373| モデルプロバイダー | Anthropic API。[Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md)、[Google Cloud の Agent Platform](https://code.claude.com/docs/ja/google-vertex-ai.md)、または[Microsoft Foundry](https://code.claude.com/docs/ja/microsoft-foundry.md)では利用できません。 |373| モデルプロバイダー | Anthropic API。[Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md)、[Google Cloud の Agent Platform](https://code.claude.com/docs/ja/google-vertex-ai.md)、または[Microsoft Foundry](https://code.claude.com/docs/ja/microsoft-foundry.md)では利用できません。 |

374| 組織ポリシー | カスタマー管理暗号化キー（CMEK）、HIPAA、および[Zero Data Retention](https://code.claude.com/docs/ja/zero-data-retention.md)は組織に対して有効になっていません。 |374| 組織ポリシー | カスタマー管理暗号化キー（CMEK）、HIPAA、および[Zero Data Retention](https://code.claude.com/docs/ja/zero-data-retention.md)は組織に対して有効になっていません。 |

375| サーフェス | Claude Code CLI、または Claude デスクトップアプリバージョン 1.13576.0 以降。[Claude Tag](https://claude.com/docs/claude-tag/overview) セッションは、Claude Tag とアーティファクトの両方が組織に対して有効な場合にもアーティファクトを公開できます。[`claude remote-control`](https://code.claude.com/docs/ja/remote-control) によって提供されるセッションは、自分でセッションを開始した場合にアーティファクトを公開できます。Claude Code v2.1.281 以降が必要です。[Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md)、GitHub Action、および MCP サーバーコンテキストではデフォルトで無効です。また、自分のターミナルやスクリプトから [`-p`](https://code.claude.com/docs/ja/headless) を付けて Claude Code を実行する場合、および [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars) が設定されている場合も無効です。 |375| サーフェス | Claude Code CLI、または Claude デスクトップアプリバージョン 1.13576.0 以降。[Claude Tag](https://claude.com/docs/claude-tag/overview) セッションは、Claude Tag とアーティファクトの両方が組織に対して有効な場合にもアーティファクトを公開できます。[`claude remote-control`](https://code.claude.com/docs/ja/remote-control) によって提供されるセッションは、自分でセッションを開始した場合にアーティファクトを公開できます。Claude Code v2.1.281 以降が必要です。[Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview.md)、GitHub Action、および MCP サーバーコンテキストではデフォルトで無効です。また、自分のターミナルやスクリプトから [`-p`](https://code.claude.com/docs/ja/headless) を付けて Claude Code を実行する場合、および [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars) が設定されている場合も無効です。 |

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

28* **Claude Console**: Console 認証情報でログインします。管理者が事前に[招待](#claude-console-authentication)している必要があります。[API キーを作成せずにサインイン](#sign-in-without-an-api-key)することも、API キーを作成することもできます。28* **Claude Console**: Console 認証情報でログインします。管理者が事前に[招待](#claude-console-authentication)している必要があります。[API キーを作成せずにサインイン](#sign-in-without-an-api-key)することも、API キーを作成することもできます。

29* **クラウドプロバイダー**: 組織が [Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md)、[Google Cloud の Agent Platform](https://code.claude.com/docs/ja/google-vertex-ai.md)、または [Microsoft Foundry](https://code.claude.com/docs/ja/microsoft-foundry.md) を使用している場合は、`claude` を実行する前に必要な環境変数を設定するか、ログインプロンプトで **3rd-party platform** を選択してください。これにより、Bedrock と Vertex AI 向けのインタラクティブセットアップウィザードが起動します。ブラウザログインは不要です。29* **クラウドプロバイダー**: 組織が [Amazon Bedrock](https://code.claude.com/docs/ja/amazon-bedrock.md)、[Google Cloud の Agent Platform](https://code.claude.com/docs/ja/google-vertex-ai.md)、または [Microsoft Foundry](https://code.claude.com/docs/ja/microsoft-foundry.md) を使用している場合は、`claude` を実行する前に必要な環境変数を設定するか、ログインプロンプトで **3rd-party platform** を選択してください。これにより、Bedrock と Vertex AI 向けのインタラクティブセットアップウィザードが起動します。ブラウザログインは不要です。

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

31 31 

32管理者は、どのログイン方法を開発者が使用するかを指定し、claude.ai ログインが特定の組織に属することを要求できます。[ログインを組織に制限する](#restrict-login-to-your-organization)を参照してください。32管理者は、どのログイン方法を開発者が使用するかを指定し、claude.ai ログインが特定の組織に属することを要求できます。[ログインを組織に制限する](#restrict-login-to-your-organization)を参照してください。

33 33 

353 353 

354| 機能 | 何をするか | 適している用途 |354| 機能 | 何をするか | 適している用途 |

355| - | - | - |355| - | - | - |

356| [ウェブ上の Claude Code](https://code.claude.com/docs/ja/claude-code-on-the-web.md) | GitHub からクローンされた新しいクラウドサンドボックスでタスクを実行 | 後で確認する自己完結型の非同期作業を委任する |356| [クラウドセッション](https://code.claude.com/docs/ja/claude-code-on-the-web.md) | GitHub からクローンされた新しいクラウドサンドボックスでタスクを実行 | 後で確認する自己完結型の非同期作業を委任する |

357| [Slack の Claude](https://code.claude.com/docs/ja/slack.md) | チャネルまたはスレッドの `@Claude` メンションからクラウドセッションを生成 | チームの会話コンテキストから直接タスクを開始する |357| [Slack の Claude](https://code.claude.com/docs/ja/slack.md) | チャネルまたはスレッドの `@Claude` メンションからクラウドセッションを生成 | チームの会話コンテキストから直接タスクを開始する |

358| 標準 [MCP サーバー](https://code.claude.com/docs/ja/mcp.md) | Claude はタスク中にそれをクエリします。セッションには何もプッシュされません | Claude にシステムを読み取るまたはクエリするオンデマンドアクセスを提供する |358| 標準 [MCP サーバー](https://code.claude.com/docs/ja/mcp.md) | Claude はタスク中にそれをクエリします。セッションには何もプッシュされません | Claude にシステムを読み取るまたはクエリするオンデマンドアクセスを提供する |

359| [リモートコントロール](https://code.claude.com/docs/ja/remote-control.md) | claude.ai または Claude モバイルアプリからローカルセッションを駆動 | デスクから離れている間に進行中のセッションを操舵する |359| [Remote Control](https://code.claude.com/docs/ja/remote-control.md) | claude.ai または Claude モバイルアプリからローカルセッションを駆動 | デスクから離れている間に進行中のセッションを操舵する |

360 360 

361チャネルは、Claude 以外のソースからのイベントをすでに実行中のローカルセッションにプッシュすることで、そのリストのギャップを埋めます。361チャネルは、Claude 以外のソースからのイベントをすでに実行中のローカルセッションにプッシュすることで、そのリストのギャップを埋めます。

362 362 

368チャネルが実行されたら、これらの関連機能を探索してください。368チャネルが実行されたら、これらの関連機能を探索してください。

369 369 

370* [独自のチャネルを構築](https://code.claude.com/docs/ja/channels-reference.md)して、まだプラグインがないシステムに対応する370* [独自のチャネルを構築](https://code.claude.com/docs/ja/channels-reference.md)して、まだプラグインがないシステムに対応する

371* [リモートコントロール](https://code.claude.com/docs/ja/remote-control.md)を使用して、イベントをそれに転送する代わりに電話からローカルセッションを駆動する371* [Remote Control](https://code.claude.com/docs/ja/remote-control.md) を使用して、イベントをそれに転送する代わりに電話からローカルセッションを駆動する

372* [セッションスコープのスケジュールタスク](https://code.claude.com/docs/ja/scheduled-tasks.md)を使用して、プッシュされたイベントに対応する代わりにタイマーでポーリングする372* [セッションスコープのスケジュールタスク](https://code.claude.com/docs/ja/scheduled-tasks.md)を使用して、プッシュされたイベントに対応する代わりにタイマーでポーリングする

76 76 

77いつでも `/chrome` を実行して、接続ステータスの確認、権限の管理、拡張機能の再接続、または使用する接続済みブラウザの選択を行えます。ステータスパネルに「ステータス: 有効」と「拡張機能: インストール済み」が表示されていれば、統合は正常に動作しています。77いつでも `/chrome` を実行して、接続ステータスの確認、権限の管理、拡張機能の再接続、または使用する接続済みブラウザの選択を行えます。ステータスパネルに「ステータス: 有効」と「拡張機能: インストール済み」が表示されていれば、統合は正常に動作しています。

78 78 

79複数のブラウザが接続されている場合は、Claude が使用するブラウザを選択します。選択する前にブラウザアクションが開始されると、Claude はいずれかを選択するよう促します。後でブラウザを切り替えるには、`/chrome` を実行して **ブラウザを選択…** を選びます。別のブラウザが接続された場合でも、Claude は選択したブラウザを使い続けます。79複数のブラウザが接続されている場合は、Claude が使用するブラウザを選択します。選択する前にブラウザアクションが開始されると、Claude はいずれかを選択するよう促します。後でブラウザを切り替えるには、`/chrome` を実行して **Select browser…** を選びます。別のブラウザが接続された場合でも、Claude は選択したブラウザを使い続けます。

80 80 

81VS Code については、[VS Code でのブラウザ自動化](https://code.claude.com/docs/ja/vs-code.md#automate-browser-tasks-with-chrome) を参照してください。81VS Code については、[VS Code でのブラウザ自動化](https://code.claude.com/docs/ja/vs-code.md#automate-browser-tasks-with-chrome) を参照してください。

82 82 

83### Claude から求められたときに拡張機能をインストールする83### Claude から求められたときに拡張機能をインストールする

84 84 

85対話型セッションで Claude がブラウザを必要とし、Claude Code が拡張機能を検出できない場合、Claude Code は「Claude がブラウザの使用を求めています」というタイトルのインストールプロンプトを表示します。Claude Code が確認するのは 1 セッションにつき最大 1 回です。85対話型セッションで Claude がブラウザを必要とし、Claude Code が拡張機能を検出できない場合、Claude Code は「Claude wants to use your browser」というタイトルのインストールプロンプトを表示します。Claude Code が確認するのは 1 セッションにつき最大 1 回です。

86 86 

87プロンプトには 3 つの選択肢があります。87プロンプトには 3 つの選択肢があります。

88 88 

89* **拡張機能をインストール**: ブラウザで拡張機能のインストールページを開き、ガイド付きセットアップを開始します。Claude Code はインストールを待機し、拡張機能を接続して、同じセッション内でブラウザツールを有効にします。接続の準備ができたら「ブラウザツールを使用して続行」を選択すると、Claude はブラウザでタスクを再開します。「ブラウザツールなしで続行」を選択してセットアップを中断し、後で `/chrome` で完了することもできます。89* **Install extension**: ブラウザで拡張機能のインストールページを開き、ガイド付きセットアップを開始します。Claude Code はインストールを待機し、拡張機能を接続して、同じセッション内でブラウザツールを有効にします。接続の準備ができたら「Continue with browser tools」を選択すると、Claude はブラウザでタスクを再開します。「Continue without browser tools」を選択してセットアップを中断し、後で `/chrome` で完了することもできます。

90* **今はしない**: ブラウザツールなしでタスクを続行します。Claude Code は後のセッションで再度確認することがあります。90* **Not now**: ブラウザツールなしでタスクを続行します。Claude Code は後のセッションで再度確認することがあります。

91* **今後確認しない**: 今後のセッションでプロンプトを表示しないようにします。`/chrome` を使えば、いつでも統合をセットアップできます。91* **Don't ask again**: 今後のセッションでプロンプトを表示しないようにします。`/chrome` を使えば、いつでも統合をセットアップできます。

92 92 

93次の 2 つの管理 MCP ポリシーによってプロンプトはオフになります。93次の 2 つの管理 MCP ポリシーによってプロンプトはオフになります。

94 94 

107>107>

108> Chrome をデフォルトで有効にすると、ブラウザツールとその指示が常にロードされるため、コンテキスト使用量が増加します。コンテキスト消費の増加に気付いた場合は、この設定をオフにして、必要なときにのみ接続してください。CLI では `--chrome` を使用し、VS Code ではプロンプトボックスに [`@browser`](https://code.claude.com/docs/ja/vs-code#automate-browser-tasks-with-chrome) と入力します。108> Chrome をデフォルトで有効にすると、ブラウザツールとその指示が常にロードされるため、コンテキスト使用量が増加します。コンテキスト消費の増加に気付いた場合は、この設定をオフにして、必要なときにのみ接続してください。CLI では `--chrome` を使用し、VS Code ではプロンプトボックスに [`@browser`](https://code.claude.com/docs/ja/vs-code#automate-browser-tasks-with-chrome) と入力します。

109 109 

110### 起動時のダイアログに回答する

111 

112`claude` の起動時に「Claude in Chrome extension detected」ダイアログが表示された場合、その回答によって [**デフォルトで有効** 設定](#enable-chrome-by-default)が変更されます。

113 

114* **Yes, use my browser**: 設定をオンにして、このセッションを接続します

115* **No, keep browser tools off**、または Esc: 設定をオフにし、Claude Code は Chrome のセットアップを提案しなくなります

116 

117以降のセッションに向けて回答を変更するには、`/chrome` を実行します。

118 

110### サイト権限を管理する119### サイト権限を管理する

111 120 

112サイトレベルの権限は Chrome 拡張機能から継承されます。Chrome 拡張機能の設定で権限を管理して、Claude がブラウズ、クリック、入力できるサイトを制御します。[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)では、auto モードの分類器自体があるサイトへのブラウザ呼び出しを承認した場合、権限ルールで Claude in Chrome に対していずれかのサイトを拒否していない限り、拡張機能はその呼び出しについて独自のサイトごとのチェックを省略します。121サイトレベルの権限は Chrome 拡張機能から継承されます。Chrome 拡張機能の設定で権限を管理して、Claude がブラウズ、クリック、入力できるサイトを制御します。[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)では、auto モードの分類器自体があるサイトへのブラウザ呼び出しを承認した場合、権限ルールで Claude in Chrome に対していずれかのサイトを拒否していない限り、拡張機能はその呼び出しについて独自のサイトごとのチェックを省略します。

35* **テレメトリ**：各設定先は、デフォルトではトークン数、モデル、ユーザーアイデンティティ、レイテンシを含む[OpenTelemetry Protocol（OTLP）メトリクス](https://code.claude.com/docs/ja/monitoring-usage.md)を受け取り、ログとトレースは宛先ごとのオプトインです。35* **テレメトリ**：各設定先は、デフォルトではトークン数、モデル、ユーザーアイデンティティ、レイテンシを含む[OpenTelemetry Protocol（OTLP）メトリクス](https://code.claude.com/docs/ja/monitoring-usage.md)を受け取り、ログとトレースは宛先ごとのオプトインです。

36* **アップストリームルーティング**：クライアントは Anthropic Messages API をゲートウェイに話しかけ、ゲートウェイは各アップストリーム（Amazon Bedrock、[Claude Platform on AWS](https://code.claude.com/docs/ja/claude-platform-on-aws.md)、Google Cloud の Agent Platform、Microsoft Foundry、または Anthropic API）に対して変換し、それらの間でフェイルオーバーします。開発者が気付いたり再設定したりすることなく、リージョン、プロバイダー、またはフェイルオーバー順序を変更できます。36* **アップストリームルーティング**：クライアントは Anthropic Messages API をゲートウェイに話しかけ、ゲートウェイは各アップストリーム（Amazon Bedrock、[Claude Platform on AWS](https://code.claude.com/docs/ja/claude-platform-on-aws.md)、Google Cloud の Agent Platform、Microsoft Foundry、または Anthropic API）に対して変換し、それらの間でフェイルオーバーします。開発者が気付いたり再設定したりすることなく、リージョン、プロバイダー、またはフェイルオーバー順序を変更できます。

37 37 

38![Claude Code クライアントと Claude Desktop の Chat、Cowork、Code タブがベアラートークンを使用して HTTPS 経由でインフラストラクチャ内の自己ホスト型 Claude apps ゲートウェイに接続し、IdP に対してユーザーにサインインし、PostgreSQL に認証状態を保存し、テレメトリを OTLP コレクターにリレーし、Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry、または Anthropic API に推論を転送する図](https://mintcdn.com/claude-code/VbyXug8hBU9UK6oT/images/claude-gateway-architecture.svg?fit=max\&auto=format\&n=VbyXug8hBU9UK6oT\&q=85\&s=9e4f1190fc56718144190a3db61c63af)38![Claude Code クライアントと Claude Desktop がベアラートークンを使用して HTTPS 経由でインフラストラクチャ内の自己ホスト型 Claude apps gateway に接続し、ゲートウェイが IdP に対してユーザーをサインインさせ、PostgreSQL に認証状態を保存し、テレメトリを OTLP コレクターにリレーし、Amazon Bedrock、Claude Platform on AWS、Google Cloud、Microsoft Foundry、または Anthropic API に推論を転送する図](https://mintcdn.com/claude-code/VbyXug8hBU9UK6oT/images/claude-gateway-architecture.svg?fit=max\&auto=format\&n=VbyXug8hBU9UK6oT\&q=85\&s=9e4f1190fc56718144190a3db61c63af)

39 39 

40> [!NOTE]40> [!NOTE]

41>41>

350 350 

351### Claude Desktop セッションにポリシーを配信する351### Claude Desktop セッションにポリシーを配信する

352 352 

353Claude Desktop は Cowork タブと Code タブ、および有効にした場合は Chat タブを、埋め込み Claude Code セッションで実行し、それらのモデルリクエストをゲートウェイを通じて送信します。ゲートウェイが `/user/bootstrap` で提供する設定から構築されたポリシーを各セッションに渡します。モデル許可リスト、無効化されたツール、および一致したポリシーの `cli` または `code` ブロックから派生した出力許可リスト、および[`desktop` オーバーレイ](https://code.claude.com/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)です。353Claude Desktop は、Cowork タブと Code タブ、および有効にした場合は Chat を、組み込みの Claude Code セッション上で実行し、それらのモデルリクエストをゲートウェイ経由で送信します。Claude Desktop は、ゲートウェイが `/user/bootstrap` で提供する設定から構築したポリシーを、これらの各セッションに渡します。このポリシーには、一致したポリシーの `cli` ブロックまたは `code` ブロックから導出されるモデル許可リスト、無効化されたツール、エグレス許可リストに加えて、[`desktop` オーバーレイ](https://code.claude.com/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)が含まれます。

354 354 

355フック、`env`、および `Bash(npm *)` のようなスコープ付き権限ルールなど、ブロックの他のキーは、`/login` を通じてサインインするクライアントに到達します。`code` の下にある場合、[Code タブの条件](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#apply-code-settings-in-the-code-tab)が満たされていれば、Code タブのセッションにも到達します。Cowork セッションや Chat セッションには到達しません。Claude Desktop はゲートウェイ URL を独自の管理設定から読み取り、[ゲートウェイ URL を設定する](#set-the-gateway-url)の `forceLoginMethod` と `forceLoginGatewayUrl` キーとは別の独自のフローでサインインします。355フック、`env`、および `Bash(npm *)` のようなスコープ付き権限ルールなど、ブロックの他のキーは、`/login` を通じてサインインするクライアントに到達します。`code` の下にある場合、[Code タブの条件](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#apply-code-settings-in-the-code-tab)が満たされていれば、Code タブのセッションにも到達します。Cowork セッションや Chat セッションには到達しません。Claude Desktop はゲートウェイ URL を独自の管理設定から読み取り、[ゲートウェイ URL を設定する](#set-the-gateway-url)の `forceLoginMethod` と `forceLoginGatewayUrl` キーとは別の独自のフローでサインインします。

356 356 

480 480 

481Claude Desktop は同じブラウザ SSO ステップでゲートウェイのアイデンティティプロバイダーを通じて開発者にサインインし、Anthropic ではなくゲートウェイから設定をフェッチします。モデルアクセスとポリシーは CLI と同じグループごとのルールに従います。CLI と Claude Desktop の両方を使用する開発者は各々に個別にサインインします。ゲートウェイセッションはそれらの間で共有されません。481Claude Desktop は同じブラウザ SSO ステップでゲートウェイのアイデンティティプロバイダーを通じて開発者にサインインし、Anthropic ではなくゲートウェイから設定をフェッチします。モデルアクセスとポリシーは CLI と同じグループごとのルールに従います。CLI と Claude Desktop の両方を使用する開発者は各々に個別にサインインします。ゲートウェイセッションはそれらの間で共有されません。

482 482 

483接続すると、Claude Desktop は有効なすべてのタブからモデルリクエストをゲートウェイを通じて送信します。デフォルトで Cowork タブと Code タブを表示します。Chat タブもオンにするには、Claude Desktop の[管理設定](https://claude.com/docs/third-party/claude-desktop/configuration)で `chatTabEnabled` を `true` に設定するか、Claude Code v2.1.227 以降を実行しているゲートウェイのポリシーの [`desktop` ブロック](https://code.claude.com/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)で設定します。483接続すると、Claude Desktop は有効なすべてのタブからモデルリクエストをゲートウェイを通じて送信します。デフォルトで Cowork タブと Code タブを表示します。Chat も利用できるようにするには、Claude Code v2.1.227 以降を実行しているゲートウェイで、ポリシーの [`desktop` ブロック](https://code.claude.com/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)で `chatTabEnabled` を `true` に設定します。Cowork がオンの場合、Claude Desktop は Chat と Cowork を 1 つのタブにまとめて表示します。

484 484 

485### CI パイプラインとリモートマシン485### CI パイプラインとリモートマシン

486 486 

523| 推論の転送（Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform、Microsoft Foundry、Anthropic） | 利用可能 | アップストリームごとのモデル変換とフェイルオーバーに対応しています。Amazon Bedrock アップストリームは `bedrock-runtime` エンドポイントと AWS のデフォルト認証情報チェーンを使用します。[Amazon Bedrock Mantle アップストリーム](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#amazon-bedrock-mantle-endpoint)にはゲートウェイサーバー上で Claude Code v2.1.283 以降が、[Claude Platform on AWS アップストリーム](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#claude-platform-on-aws)には v2.1.198 以降が必要です。 |523| 推論の転送（Amazon Bedrock、Claude Platform on AWS、Google Cloud's Agent Platform、Microsoft Foundry、Anthropic） | 利用可能 | アップストリームごとのモデル変換とフェイルオーバーに対応しています。Amazon Bedrock アップストリームは `bedrock-runtime` エンドポイントと AWS のデフォルト認証情報チェーンを使用します。[Amazon Bedrock Mantle アップストリーム](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#amazon-bedrock-mantle-endpoint)にはゲートウェイサーバー上で Claude Code v2.1.283 以降が、[Claude Platform on AWS アップストリーム](https://code.claude.com/docs/ja/claude-apps-gateway-config.md#claude-platform-on-aws)には v2.1.198 以降が必要です。 |

524| 100 万トークンのコンテキストウィンドウ | 利用可能 | Fable モデル、Sonnet 5 以降、Opus 4.7 以降は、デフォルトで 100 万トークンのウィンドウで動作します。[拡張コンテキスト](https://code.claude.com/docs/ja/model-config.md#extended-context)を参照してください。Fable モデルと Opus モデルで 100 万トークンをデフォルトにするには、開発者のマシン上で Claude Code v2.1.287 以降が必要です |524| 100 万トークンのコンテキストウィンドウ | 利用可能 | Fable モデル、Sonnet 5 以降、Opus 4.7 以降は、デフォルトで 100 万トークンのウィンドウで動作します。[拡張コンテキスト](https://code.claude.com/docs/ja/model-config.md#extended-context)を参照してください。Fable モデルと Opus モデルで 100 万トークンをデフォルトにするには、開発者のマシン上で Claude Code v2.1.287 以降が必要です |

525| IdP グループごとのモデルアクセスと管理設定 | 利用可能 | モデルアクセスはサーバー側で適用されます。管理設定は IdP グループごとに配信され、CLI によって[管理設定の階層](https://code.claude.com/docs/ja/settings.md#settings-precedence)で適用されます |525| IdP グループごとのモデルアクセスと管理設定 | 利用可能 | モデルアクセスはサーバー側で適用されます。管理設定は IdP グループごとに配信され、CLI によって[管理設定の階層](https://code.claude.com/docs/ja/settings.md#settings-precedence)で適用されます |

526| Claude Desktop | オプトインで利用可能 | ポリシーで [`desktop` キーによりオプトイン](https://code.claude.com/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)すると、ゲートウェイは `/user/bootstrap` で Claude Desktop の設定を提供し、Claude Desktop は Cowork タブと Code タブから、および有効にした場合は Chat タブから、ゲートウェイ経由でモデルリクエストを送信します。Chat タブをオンにするには、[Claude Desktop を接続する](#connect-claude-desktop)を参照してください。ゲートウェイサーバー上で Claude Code v2.1.203 以降が必要です。 |526| Claude Desktop | オプトインで利用可能 | ポリシーで [`desktop` キーによりオプトイン](https://code.claude.com/docs/ja/claude-apps-gateway-config#claude-desktop-overlay)すると、ゲートウェイは `/user/bootstrap` で Claude Desktop の設定を提供し、Claude Desktop はゲートウェイ経由でモデルリクエストを送信します。Chat をオンにするには、[Claude Desktop を接続する](#connect-claude-desktop)を参照してください。ゲートウェイサーバー上で Claude Code v2.1.203 以降が必要です。 |

527| テレメトリのファンアウト（OTLP/HTTP） | 利用可能 | エクスポートごとに ID が付与されます。protobuf と JSON の両方のエンコーディングに対応しています |527| テレメトリのファンアウト（OTLP/HTTP） | 利用可能 | エクスポートごとに ID が付与されます。protobuf と JSON の両方のエンコーディングに対応しています |

528| OIDC ID プロバイダー | 利用可能 | OIDC に準拠した任意の IdP に対応しています。ゲートウェイは標準の OIDC ディスカバリーと認可コードフローを実行します。IdP ごとの設定については [ID プロバイダーのセットアップ](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#identity-provider-setup)を参照してください |528| OIDC ID プロバイダー | 利用可能 | OIDC に準拠した任意の IdP に対応しています。ゲートウェイは標準の OIDC ディスカバリーと認可コードフローを実行します。IdP ごとの設定については [ID プロバイダーのセットアップ](https://code.claude.com/docs/ja/claude-apps-gateway-deploy.md#identity-provider-setup)を参照してください |

529| ユーザーごとおよびグループごとの支出上限 | 利用可能 | [支出上限](https://code.claude.com/docs/ja/claude-apps-gateway-spend-limits.md)を参照してください |529| ユーザーごとおよびグループごとの支出上限 | 利用可能 | [支出上限](https://code.claude.com/docs/ja/claude-apps-gateway-spend-limits.md)を参照してください |

201 201 

202次のいずれかの方法で、クラウドセッションをターミナルに取り込みます。202次のいずれかの方法で、クラウドセッションをターミナルに取り込みます。

203 203 

204* **`--teleport` を使用する**: コマンドラインから `claude --teleport` を実行すると対話型のセッション選択画面が開き、`claude --teleport <session-id>` を実行すると特定のセッションを直接再開できます。コミットされていない変更がある場合は、先に stash するよう求められます。204* **`--teleport` を使用する**: コマンドラインから `claude --teleport` を実行すると対話型のセッション選択画面が開き、`claude --teleport <session-id>` を実行すると特定のセッションを直接再開できます。コミットされていない変更がある場合は、先に stash するよう求められます。[`--resume`](https://code.claude.com/docs/ja/sessions#resume-a-session) はこのマシンのローカル履歴から会話を再開するもので、クラウドセッションは一覧に表示されません。

205* **`/teleport` を使用する**: 既存の CLI セッション内で `/teleport` または `/tp` を実行すると、Claude Code を再起動せずに同じセッション選択画面を開けます。205* **`/teleport` を使用する**: 既存の CLI セッション内で `/teleport` または `/tp` を実行すると、Claude Code を再起動せずに同じセッション選択画面を開けます。

206* **`/tasks` から**: `/tasks` を実行してバックグラウンドセッションを表示し、`t` を押してセッションに teleport します。206* **`/tasks` から**: `/tasks` を実行してバックグラウンドセッションを表示し、`t` を押してセッションに teleport します。

207* **claude.ai/code から**: セッションメニューから **Open in > Terminal** を選択すると、ターミナルに貼り付けられるコマンドがコピーされます。207* **claude.ai/code から**: セッションメニューから **Open in > Terminal** を選択すると、ターミナルに貼り付けられるコマンドがコピーされます。

208* **クラウドセッション内から**: `/teleport` と入力すると、Claude Code がそのセッション用の正確な `claude --teleport <session-id>` コマンドを返します。このコマンドはリポジトリのチェックアウトからすぐに実行できます。セッションの環境に Claude Code v2.1.223 以降が必要です。208* **クラウドセッション内から**: `/teleport` と入力すると、Claude Code がそのセッション用の正確な `claude --teleport <session-id>` コマンドを返します。このコマンドはリポジトリのチェックアウトからすぐに実行できます。セッションの環境に Claude Code v2.1.223 以降が必要です。

209 209 

210セッションを teleport すると、Claude は正しいリポジトリにいることを確認し、クラウドセッションのブランチをフェッチしてチェックアウトし、会話の全履歴をターミナルに読み込みます。ターミナルはセッションの独自のコピーを取得します。そこで行った新しい作業はローカルにとどまり、claude.ai や Claude モバイルアプリのクラウドセッションには表示されません。teleport 後もスマートフォンから操作を続けるには、ローカルセッションで [`/remote-control`](https://code.claude.com/docs/ja/remote-control) を開始してください。210セッションを teleport すると、Claude は正しいリポジトリにいることを確認し、クラウドセッションのブランチをフェッチしてチェックアウトし、会話をターミナルに読み込みます。

211 211 

212`--teleport` は `--resume` とは異なります。`--resume` はこのマシンのローカル履歴から会話を再開するもので、クラウドセッションは一覧に表示されません。`--teleport` はクラウドセッションとそのブランチを取り込みます。212> [!NOTE]

213>

214> Claude Code がクラウドセッションを[コンパクト化](https://code.claude.com/docs/ja/context-window.md#what-survives-compaction)している場合（長いセッションでは自動的に行われます）、要約された以前のメッセージはターミナルにコピーされません。Claude は要約から続行します。元のメッセージを読むには、claude.ai または Claude モバイルアプリのクラウドセッションで上にスクロールしてください。

215 

216ターミナルはセッションの独自のコピーを取得します。そこで行った新しい作業はローカルにとどまり、claude.ai や Claude モバイルアプリのクラウドセッションには表示されません。teleport 後もスマートフォンから操作を続けるには、ローカルセッションで [`/remote-control`](https://code.claude.com/docs/ja/remote-control) を開始してください。

213 217 

214#### Teleport の要件218#### Teleport の要件

215 219 

495* **レート制限**: クラウドセッションは、アカウント内のすべての Claude および Claude Code の使用状況とレート制限を共有します。複数のタスクを並行実行すると、レート制限がそれに応じてより多く消費されます。499* **レート制限**: クラウドセッションは、アカウント内のすべての Claude および Claude Code の使用状況とレート制限を共有します。複数のタスクを並行実行すると、レート制限がそれに応じてより多く消費されます。

496* **時間制限**: Claude が実行するコマンドと SessionStart フックにはデフォルトのタイムアウトがあり、変更できます。セットアップスクリプトはおよそ 5 分以内に完了した場合のみキャッシュされます。[時間制限](https://code.claude.com/docs/ja/cloud-environments.md#time-limits) を参照してください。500* **時間制限**: Claude が実行するコマンドと SessionStart フックにはデフォルトのタイムアウトがあり、変更できます。セットアップスクリプトはおよそ 5 分以内に完了した場合のみキャッシュされます。[時間制限](https://code.claude.com/docs/ja/cloud-environments.md#time-limits) を参照してください。

497* **リポジトリ認証**: クラウドセッションをターミナルに取り込むことができるのは、同じアカウントで認証されている場合のみです。501* **リポジトリ認証**: クラウドセッションをターミナルに取り込むことができるのは、同じアカウントで認証されている場合のみです。

498* **プラットフォーム制限**: リポジトリのクローンとプルリクエストの作成には GitHub が必要です。自己ホスト型の [GitHub Enterprise Server](https://code.claude.com/docs/ja/github-enterprise-server.md) インスタンスは Team および Enterprise プランでサポートされています。GitLab、Bitbucket、またはその他の非 GitHub リポジトリをクラウドセッションに [ローカルバンドル](#send-local-repositories-without-github) として送信できます。これは `CCR_FORCE_BUNDLE=1` を設定することで実現できますが、セッションはその結果をリモートにプッシュバックできません。502* **プラットフォーム制限**: Anthropic ホスト環境でのリポジトリのクローンとプルリクエストの作成には GitHub が必要です。自己ホスト型の [GitHub Enterprise Server](https://code.claude.com/docs/ja/github-enterprise-server.md) インスタンスは Team および Enterprise プランでサポートされています。GitLab、Bitbucket、またはその他の非 GitHub リポジトリをクラウドセッションに [ローカルバンドル](#send-local-repositories-without-github) として送信できます。これは `CCR_FORCE_BUNDLE=1` を設定することで実現できますが、セッションはその結果をリモートにプッシュバックできません。

503 * **自己ホスト環境**: 他の git ホスト上のリポジトリについては、[`--environment` でセッションを開始するための要件](https://code.claude.com/docs/ja/self-hosted-environments-deploy#start-a-session-on-a-repository-outside-github) を参照してください。

499* **組織 IP 許可リスト**: クラウドセッションは、ユーザーのネットワークではなく Anthropic 管理のインフラストラクチャから Anthropic API を呼び出します。一方、[自己ホスト環境](https://code.claude.com/docs/ja/self-hosted-environments) のセッションは自身のネットワークから呼び出します。組織で [IP 許可リスト](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) が有効になっている場合、Anthropic ホスト型のすべてのクラウドセッションは認証エラーで失敗します。504* **組織 IP 許可リスト**: クラウドセッションは、ユーザーのネットワークではなく Anthropic 管理のインフラストラクチャから Anthropic API を呼び出します。一方、[自己ホスト環境](https://code.claude.com/docs/ja/self-hosted-environments) のセッションは自身のネットワークから呼び出します。組織で [IP 許可リスト](https://support.claude.com/en/articles/13200993-restrict-access-to-claude-with-ip-allowlisting) が有効になっている場合、Anthropic ホスト型のすべてのクラウドセッションは認証エラーで失敗します。

500 * **Code Review とスケジュールタスク**: 同じことが [Code Review](https://code.claude.com/docs/ja/code-review.md) と、Anthropic ホスト環境で実行される [クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md) にも当てはまります。自己ホスト環境にルーティングされたスケジュールタスクは、自身のネットワークから API を呼び出します。505 * **Code Review とスケジュールタスク**: 同じことが [Code Review](https://code.claude.com/docs/ja/code-review.md) と、Anthropic ホスト環境で実行される [クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md) にも当てはまります。自己ホスト環境にルーティングされたスケジュールタスクは、自身のネットワークから API を呼び出します。

501 * **除外の取得**: Anthropic ホスト型サービスを組織の IP 許可リストから除外するには、[Anthropic サポート](https://support.claude.com/) にお問い合わせください。506 * **除外の取得**: Anthropic ホスト型サービスを組織の IP 許可リストから除外するには、[Anthropic サポート](https://support.claude.com/) にお問い合わせください。

8 8 

9Claude Code は、プロジェクトディレクトリとホームディレクトリの `~/.claude` から、指示、設定、skills、subagents、メモリを読み込みます。プロジェクトファイルを git にコミットしてチームと共有します。`~/.claude` 内のファイルは、すべてのプロジェクトに適用される個人設定です。9Claude Code は、プロジェクトディレクトリとホームディレクトリの `~/.claude` から、指示、設定、skills、subagents、メモリを読み込みます。プロジェクトファイルを git にコミットしてチームと共有します。`~/.claude` 内のファイルは、すべてのプロジェクトに適用される個人設定です。

10 10 

11Windows では、`~/.claude` は `%USERPROFILE%\.claude` に解決されます。[`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) を設定した場合、このページのすべての `~/.claude` パスはそのディレクトリの下に存在します。11Windows では、`~/.claude` は `%USERPROFILE%\.claude` に解決されます。[`CLAUDE_CONFIG_DIR`](https://code.claude.com/docs/ja/env-vars) を設定した場合、このページのすべての `~/.claude` パスはそのディレクトリの下に存在します。同じことが `.claude.json` にも当てはまります。このファイルは、設定しない場合は `~/.claude.json` に配置されます。

12 12 

13ほとんどのユーザーは `CLAUDE.md` と `settings.json` のみを編集します。リポジトリに他のコーディングエージェント用の `AGENTS.md` が既にある場合、Claude Code は `CLAUDE.md` の代わりに[それを読み込むことができます](https://code.claude.com/docs/ja/memory.md#agents-md)。ディレクトリの残りはオプションです。必要に応じてスキル、ルール、またはサブエージェントを追加してください。13ほとんどのユーザーは `CLAUDE.md` と `settings.json` のみを編集します。リポジトリに他のコーディングエージェント用の `AGENTS.md` が既にある場合、Claude Code は `CLAUDE.md` の代わりに[それを読み込むことができます](https://code.claude.com/docs/ja/memory.md#agents-md)。ディレクトリの残りはオプションです。必要に応じてスキル、ルール、またはサブエージェントを追加してください。

14 14 

76| [`agents/*.md`](#ce-agents) | プロジェクトおよびグローバル | ✓ | 独自のプロンプトとツールを持つ subagent 定義 | [Subagents](https://code.claude.com/docs/ja/sub-agents.md) |76| [`agents/*.md`](#ce-agents) | プロジェクトおよびグローバル | ✓ | 独自のプロンプトとツールを持つ subagent 定義 | [Subagents](https://code.claude.com/docs/ja/sub-agents.md) |

77| [`workflows/*.js`](#ce-workflows) | プロジェクトおよびグローバル | ✓ | Claude によって書かれた動的ワークフロースクリプト、`/workflows` から保存。各ファイルは `/<name>` コマンドになります | [動的ワークフロー](https://code.claude.com/docs/ja/workflows.md) |77| [`workflows/*.js`](#ce-workflows) | プロジェクトおよびグローバル | ✓ | Claude によって書かれた動的ワークフロースクリプト、`/workflows` から保存。各ファイルは `/<name>` コマンドになります | [動的ワークフロー](https://code.claude.com/docs/ja/workflows.md) |

78| [`agent-memory/<name>/`](#ce-agent-memory) | プロジェクトおよびグローバル | ✓ | subagents の永続メモリ | [永続メモリ](https://code.claude.com/docs/ja/sub-agents.md#enable-persistent-memory) |78| [`agent-memory/<name>/`](#ce-agent-memory) | プロジェクトおよびグローバル | ✓ | subagents の永続メモリ | [永続メモリ](https://code.claude.com/docs/ja/sub-agents.md#enable-persistent-memory) |

79| [`~/.claude.json`](#ce-claude-json) | グローバルのみ | | アプリ状態、アカウント詳細、UI トグル、個人 MCP サーバー | [グローバル設定](https://code.claude.com/docs/ja/settings-reference.md#global-config-settings) |79| [`~/.claude.json`](#ce-claude-json) | グローバルのみ | | アプリ状態、アカウント詳細、UI トグル、個人 MCP サーバー。存在しない場合、Claude Code はセッションの開始時や `claude auth status` などのサブコマンドの実行時に作成しますが、`--version` や `--help` では作成しません。 | [グローバル設定](https://code.claude.com/docs/ja/settings-reference.md#global-config-settings) |

80| [`projects/<project>/memory/`](#ce-global-projects) | グローバルのみ | | Auto memory：Claude のセッション間のメモ | [Auto memory](https://code.claude.com/docs/ja/memory.md#auto-memory) |80| [`projects/<project>/memory/`](#ce-global-projects) | グローバルのみ | | Auto memory：Claude のセッション間のメモ | [Auto memory](https://code.claude.com/docs/ja/memory.md#auto-memory) |

81| [`keybindings.json`](#ce-keybindings) | グローバルのみ | | カスタムキーボードショートカット | [キーバインディング](https://code.claude.com/docs/ja/keybindings.md) |81| [`keybindings.json`](#ce-keybindings) | グローバルのみ | | カスタムキーボードショートカット | [キーバインディング](https://code.claude.com/docs/ja/keybindings.md) |

82| [`themes/*.json`](#ce-themes) | グローバルのみ | | カスタムカラーテーマ | [カスタムテーマ](https://code.claude.com/docs/ja/terminal-config.md#create-a-custom-theme) |82| [`themes/*.json`](#ce-themes) | グローバルのみ | | カスタムカラーテーマ | [カスタムテーマ](https://code.claude.com/docs/ja/terminal-config.md#create-a-custom-theme) |

411 411 

412プロジェクトは単一のセッションよりも速くプランの制限を消費し、特に Pro プランでは、プロジェクトを実行する日には制限に到達するのが早くなることが予想されます。プロジェクトのプランを使用する部分は以下の通りです。412プロジェクトは単一のセッションよりも速くプランの制限を消費し、特に Pro プランでは、プロジェクトを実行する日には制限に到達するのが早くなることが予想されます。プロジェクトのプランを使用する部分は以下の通りです。

413 413 

414* **実行中のスレッド**: それぞれが完全なセッションであり、複数が同時に実行できます。固定数はなく、Claude は作業が必要とする数だけスレッドを開始し、[要求する](#tune-how-claude-runs-a-project)制限は上限ではなく優先度です。実施される制限は、プロジェクト全体で 1 日あたり 200 個の新しいスレッドです。414* **実行中のスレッド**: それぞれが完全なセッションであり、複数が同時に実行できます。固定数はなく、Claude は作業が必要とする数だけスレッドを開始し、[要求する](#tune-how-claude-runs-a-project)制限は上限ではなく希望です。実施される制限は、プロジェクト全体で 1 日あたり 500 個の新しいスレッドです。

415* **会話**: Claude はスレッドが報告する内容を読み、次に何をするかを決定するために独自のトークンを使用します。415* **会話**: Claude はスレッドが報告する内容を読み、次に何をするかを決定するために独自のトークンを使用します。

416* **プルリクエストを監視しているスレッド**: CI が失敗するか、プルリクエストにレビューコメントが到着すると、アイドル状態のスレッドが起動し、プランを再度使用します。これを停止するには、スレッドでプルリクエストの監視を停止するよう要求してください。416* **プルリクエストを監視しているスレッド**: CI が失敗するか、プルリクエストにレビューコメントが到着すると、アイドル状態のスレッドが起動し、プランを再度使用します。これを停止するには、スレッドでプルリクエストの監視を停止するよう要求してください。

417 417 

25 25 

26> [!NOTE]26> [!NOTE]

27>27>

28> [Remote Control](https://code.claude.com/docs/ja/remote-control.md) セッションは Web とモバイルインターフェイスを自分のマシン上のセッションに接続します。これはクラウド環境ではなく、自分のマシンのネットワークとファイルを使用します。Claude Tag チャネルセッションは [共有環境](#organization-shared-environments) または [セルフホスト環境](https://code.claude.com/docs/ja/self-hosted-environments) のいずれかの組織レベルの環境のみを使用します。28> [Remote Control](https://code.claude.com/docs/ja/remote-control.md) セッションは Web とモバイルインターフェイスを自分のマシン上のセッションに接続します。これはクラウド環境ではなく、自分のマシンのネットワークとファイルを使用します。Claude Tag チャネルが使用する環境を選択するには、[Claude Tag チャネルが使用する環境を設定する](#set-the-environment-a-claude-tag-channel-uses) を参照してください。

29 29 

30## Default 環境30## Default 環境

31 31 

64| PRs reviewed | 選択した期間にレビューされたプルリクエストの日ごとの件数 |64| PRs reviewed | 選択した期間にレビューされたプルリクエストの日ごとの件数 |

65| Code Review cost | 今月これまでの Code Review の支出 |65| Code Review cost | 今月これまでの Code Review の支出 |

66| Feedback | 開発者が問題に対処したために自動的に解決されたレビューコメントの件数 |66| Feedback | 開発者が問題に対処したために自動的に解決されたレビューコメントの件数 |

67| Code Review findings | 選択した期間に Claude が投稿したレビューにおける、[重大度レベル別の検出結果](https://code.claude.com/docs/ja/code-review-pull-requests.md#severity-levels)の日ごとの件数 |

67| Repository breakdown | リポジトリごとのレビューされた PR、解決されたコメント、レビュー実行の件数と、推定コストおよび PR ごとのビュー |68| Repository breakdown | リポジトリごとのレビューされた PR、解決されたコメント、レビュー実行の件数と、推定コストおよび PR ごとのビュー |

68 69 

69Code Review cost カードには、当月が選択されている場合にのみ金額が表示されます。分析のコスト数値は請求書と異なる場合があります。Repository breakdown のコストは割引やクレジットを適用する前の定価で推定されており、Claude がプルリクエストに投稿したレビューのみが対象です。請求書と一致する正確な支出については、Anthropic の請求書を参照してください。70Code Review cost カードには、当月が選択されている場合にのみ金額が表示されます。分析のコスト数値は請求書と異なる場合があります。Repository breakdown のコストは割引やクレジットを適用する前の定価で推定されており、Claude がプルリクエストに投稿したレビューのみが対象です。請求書と一致する正確な支出については、Anthropic の請求書を参照してください。

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

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

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

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

115| `/output-style [style]` | [出力スタイル](https://code.claude.com/docs/ja/output-styles.md)を一覧表示するか、1 つに切り替えます。たとえば `/output-style concise`。[出力スタイルを変更する](https://code.claude.com/docs/ja/output-styles.md#change-your-output-style)を参照してください。Claude Code v2.1.269 以降が必要です |115| `/output-style [style]` | [出力スタイル](https://code.claude.com/docs/ja/output-styles.md)を一覧表示するか、1 つに切り替えます。たとえば `/output-style concise`。[出力スタイルを変更する](https://code.claude.com/docs/ja/output-styles.md#change-your-output-style)を参照してください。Claude Code v2.1.269 以降が必要です |

116| `/passes` | 友人と Claude Code の無料 1 週間を共有します。アカウントが適格な場合のみ表示されます |116| `/passes` | 友人と Claude Code の無料 1 週間を共有します。アカウントが適格な場合のみ表示されます |

117| `/permissions` | ツール権限の許可、質問、拒否ルールを管理します。スコープ別にルールを表示し、ルールを追加または削除し、作業ディレクトリを管理し、[最近の auto モードの拒否](https://code.claude.com/docs/ja/auto-mode-config.md#review-denials)を確認できるインタラクティブなダイアログが開きます。ダイアログの **Auto mode** タブから [auto モード分類器ルール](https://code.claude.com/docs/ja/auto-mode-config.md#edit-rules-from-permissions)を表示および編集することもできます。Claude が応答している間に実行すると、Claude Code はダイアログをすぐに開き、同じターンで Claude の次のツール呼び出しから変更を適用します。v2.1.234 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました。エイリアス：`/allowed-tools` |117| `/permissions` | ツール権限の許可、質問、拒否ルールを管理します。スコープ別にルールを表示し、ルールを追加または削除し、作業ディレクトリを管理し、[最近の auto モードの拒否](https://code.claude.com/docs/ja/auto-mode-config.md#review-denials)を確認できるインタラクティブなダイアログが開きます。ダイアログの **Auto mode** タブから [auto モード分類器ルール](https://code.claude.com/docs/ja/auto-mode-config.md#edit-rules-from-permissions)を表示および編集することもできます。Claude が応答している間に実行すると、Claude Code はダイアログをすぐに開き、同じターンで Claude の次のツール呼び出しから変更を適用します。v2.1.234 より前は、Claude Code はターンが終了するまでコマンドをキューに入れていました。エイリアス：`/allowed-tools` |

130| `/remote-control` | このセッションを claude.ai から [Remote Control](https://code.claude.com/docs/ja/remote-control.md) で利用可能にします。サインアウト状態で実行すると、Remote Control に claude.ai サブスクリプションが必要であることを出力し、サインイン方法を示します。エイリアス：`/rc` |130| `/remote-control` | このセッションを claude.ai から [Remote Control](https://code.claude.com/docs/ja/remote-control.md) で利用可能にします。サインアウト状態で実行すると、Remote Control に claude.ai サブスクリプションが必要であることを出力し、サインイン方法を示します。エイリアス：`/rc` |

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

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

133| `/restart` | Claude Code を再起動してこのセッションを再開し、インストール済みのアップデートを適用します。アップデートのインストール後にフッターで提案されたときに実行してください。Pro または Max プランと、macOS または Linux 上のネイティブインストール（WSL は不可）が必要です。Claude Code v2.1.288 以降が必要です。エイリアス：`/update` |

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

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

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

377 377 

378## バックグラウンドトークン使用量378## バックグラウンドトークン使用量

379 379 

380Claude Code はアイドル状態でも、バックグラウンド機能にトークンを使用します。380セッション要約とアイドル時のコンテキスト圧縮は、アイドル状態の間もトークンを使用する場合があります。それぞれが実行されるタイミングとオフにする方法については、[セッション要約](https://code.claude.com/docs/ja/interactive-mode.md#session-recap)と[アイドル時のコンテキスト圧縮](https://code.claude.com/docs/ja/settings-reference.md#idlecompaction)を参照してください。

381 

382* **会話要約**: `claude --resume` 機能の前の会話を要約するバックグラウンドジョブ

383* **コマンド処理**: `/usage` などの一部のコマンドは、ステータスを確認するためにリクエストを生成する場合があります

384 

385これらのバックグラウンドプロセスは、アクティブなインタラクションがなくても、少量のトークン（通常はセッションあたり \$0.04 未満）を消費します。

386 381 

387プロンプト提案がオンの場合、Claude Code は Claude が応答した後、セッションが使用しているモデルに短いリクエストを送信して、[次のプロンプトを提案](https://code.claude.com/docs/ja/interactive-mode.md#prompt-suggestions)します。そのリクエストは会話のプロンプトキャッシュを再利用するため、ほぼキャッシュ読み取りと少数の出力トークンです。Claude Code は[アカウントが使用量制限に近い、または達している場合、提案をスキップ](https://code.claude.com/docs/ja/interactive-mode.md#when-claude-code-skips-suggestions)します。これらのリクエストを停止するには、[プロンプト提案をオフにしてください](https://code.claude.com/docs/ja/interactive-mode.md#turn-prompt-suggestions-off)。382プロンプト提案がオンの場合、Claude Code は Claude が応答した後、セッションが使用しているモデルに短いリクエストを送信して、[次のプロンプトを提案](https://code.claude.com/docs/ja/interactive-mode.md#prompt-suggestions)します。そのリクエストは会話のプロンプトキャッシュを再利用するため、ほぼキャッシュ読み取りと少数の出力トークンです。Claude Code は[アカウントが使用量制限に近い、または達している場合、提案をスキップ](https://code.claude.com/docs/ja/interactive-mode.md#when-claude-code-skips-suggestions)します。これらのリクエストを停止するには、[プロンプト提案をオフにしてください](https://code.claude.com/docs/ja/interactive-mode.md#turn-prompt-suggestions-off)。

388 383 

108 108 

109### シェルからリンクを開く109### シェルからリンクを開く

110 110 

111クリックする代わりに、シェルスクリプト、エイリアス、または自動化からディープリンクを開くこともできます。オペレーティングシステムの URL を開くコマンドをリンクを引数として呼び出します。これらのコマンドは、Claude Code が[インタラクティブセッションの最初のプロンプトを送信するときにマシンに登録](#registration-and-supported-platforms)するハンドラーに依存しています。111クリックする代わりに、シェルスクリプト、エイリアス、または自動化からディープリンクを開くこともできます。オペレーティングシステムの URL を開くコマンドをリンクを引数として呼び出します。これらのコマンドは、Claude Code がマシンに[登録](#registration-and-supported-platforms)するハンドラーに依存しています。

112 112 

113**macOS**113**macOS**

114 114 

148 148 

149## 登録とサポートされているプラットフォーム149## 登録とサポートされているプラットフォーム

150 150 

151Claude Code は、macOS、Linux、Windows で対話的セッションの最初のプロンプトを送信するときに、`claude-cli://` ハンドラーをオペレーティングシステムに登録します。`claude` を起動してプロンプトを送信せずに終了しても、ハンドラーは登録されません。別のインストールコマンドを実行する必要はありません。登録はユーザーレベルの場所にのみ書き込みます。151Claude Code は、macOS、Linux、Windows で次のいずれかを行ったときに、`claude-cli://` ハンドラーをオペレーティングシステムに登録します。

152 

153* 対話的な `claude` セッションに、メッセージや `/help` など何かを送信する。セッションを開始しても何も送信しなければ、ハンドラーは登録されません。

154* [信頼](https://code.claude.com/docs/ja/permissions.md#project-allow-rules-and-workspace-trust)済みのフォルダーで、`claude agents` などを使用して [agent view](https://code.claude.com/docs/ja/agent-view.md) で Claude Code を起動する

155 

156別のインストールコマンドを実行する必要はありません。登録はユーザーレベルの場所にのみ書き込みます。

152 157 

153| プラットフォーム | ハンドラーの場所 |158| プラットフォーム | ハンドラーの場所 |

154| - | - |159| - | - |

172 177 

173### リンクをクリックしても何も起こらない178### リンクをクリックしても何も起こらない

174 179 

175ハンドラーはまだ登録されていない可能性があります。登録はセッションの開始時ではなく、対話的セッションで最初のプロンプトを送信するときに行われます。そのマシンで対話的な `claude` セッションを開始し、任意のプロンプトを送信して終了してから、リンクを再度試してください。Linux でデスクトップ環境がない場合、`xdg-open` はディスパッチするものがない可能性があります。180ハンドラーはまだ登録されていない可能性があります。対話的セッションでは、登録はセッションの開始時ではなく、何かを送信したときに行われます。そのマシンで対話的な `claude` セッションを開始し、任意のプロンプトを送信して終了してから、リンクを再度試してください。Linux でデスクトップ環境がない場合、`xdg-open` はディスパッチするものがない可能性があります。

176 181 

177### Linux で xdg-open が見つからない182### Linux で xdg-open が見つからない

178 183 

1930* **Windows**：`SOFTWARE\Policies\Claude`のレジストリを通じて設定します1930* **Windows**：`SOFTWARE\Policies\Claude`のレジストリを通じて設定します

1931* **Linux**：`/etc/claude-desktop/managed-settings.json`にある root 所有のファイルを通じて設定します。このファイルはポリシーキーを JSON オブジェクトとして保持します。root 以外のユーザーがファイルまたはそのフォルダに書き込める場合、Desktop はそのファイルを拒否します。これは Claude Code の[管理設定ファイル](https://code.claude.com/docs/ja/managed-settings.md)とは別のファイルです。1931* **Linux**：`/etc/claude-desktop/managed-settings.json`にある root 所有のファイルを通じて設定します。このファイルはポリシーキーを JSON オブジェクトとして保持します。root 以外のユーザーがファイルまたはそのフォルダに書き込める場合、Desktop はそのファイルを拒否します。これは Claude Code の[管理設定ファイル](https://code.claude.com/docs/ja/managed-settings.md)とは別のファイルです。

1932 1932 

1933#### 組織へのサインインを制限する

1934 

1935Claude Desktop にサインインできる claude.ai 組織を制限するには、Claude Desktop ポリシーで`forceLoginOrgUUID`を設定します。

1936 

1937このキーには Claude Desktop v1.2581.0 以降が必要です。

1938 

1939Linux では、このキーのみを設定するポリシーファイルは次のようになります：

1940 

1941```json /etc/claude-desktop/managed-settings.json theme={null}

1942{

1943 "forceLoginOrgUUID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

1944}

1945```

1946 

1947プレースホルダーを、[claude.ai 管理設定](https://claude.ai/admin-settings/organization)に表示される claude.ai 組織 ID に置き換えてください。これは Claude Code の[`forceLoginOrgUUID`](https://code.claude.com/docs/ja/settings-reference#forceloginorguuid)設定が受け取るものと同じ ID です。このキーを設定する macOS および Windows のサンプルについては、HIPAA 対応組織向け Cowork ガイドの[Deploy the Claude Desktop policy](https://claude.com/docs/cowork/hipaa-setup#deploy-the-claude-desktop-policy)を参照してください。

1948 

1949Claude Code の[管理設定](https://code.claude.com/docs/ja/managed-settings.md)で`forceLoginMethod`と`forceLoginOrgUUID`を設定しても、Claude Desktop のサインイン画面は変わりません。

1950 

1933### ネットワークアクセス要件1951### ネットワークアクセス要件

1934 1952 

1935Desktop はアプリケーションコードとユーザーコンテンツを Anthropic CDN ホストから読み込みます。1953Desktop はアプリケーションコードとユーザーコンテンツを Anthropic CDN ホストから読み込みます。

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

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

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

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

432| `CLAUDE_ENABLE_BYTE_WATCHDOG` | `1` に設定するとバイトレベルのストリーミングアイドルウォッチドッグを強制的に有効にし、`0` に設定すると強制的に無効にします。`0` は、[最初のバイトの期限](https://code.claude.com/docs/ja/network-config.md#streaming-idle-watchdogs)が適用される接続でその期限もオフにします。未設定の場合、ウォッチドッグは Anthropic API と [Claude Platform on AWS](https://code.claude.com/docs/ja/claude-platform-on-aws.md) への直接接続、および `ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` を介して到達する[ゲートウェイ](https://code.claude.com/docs/ja/gateways.md)接続でのストリーミングレスポンスに対して、デフォルトで有効になります。v2.1.222 より前はこれらのゲートウェイ接続では実行されなかったため、キープアライブの ping が届いている間でも、イベントレベルのウォッチドッグが停止を報告することがありました。タイムアウトとタイマーの相互作用については、[ストリーミングアイドルウォッチドッグ](https://code.claude.com/docs/ja/network-config.md#streaming-idle-watchdogs)を参照してください |432| `CLAUDE_ENABLE_BYTE_WATCHDOG` | `1` に設定するとバイトレベルのストリーミングアイドルウォッチドッグを強制的に有効にし、`0` に設定すると強制的に無効にします。`0` は、[最初のバイトの期限](https://code.claude.com/docs/ja/network-config.md#streaming-idle-watchdogs)が適用される接続でその期限もオフにします。未設定の場合、ウォッチドッグは Anthropic API と [Claude Platform on AWS](https://code.claude.com/docs/ja/claude-platform-on-aws.md) への直接接続、および `ANTHROPIC_BASE_URL` または `ANTHROPIC_AWS_BASE_URL` を介して到達する[ゲートウェイ](https://code.claude.com/docs/ja/gateways.md)接続でのストリーミングレスポンスに対して、デフォルトで有効になります。v2.1.222 より前はこれらのゲートウェイ接続では実行されなかったため、キープアライブの ping が届いている間でも、イベントレベルのウォッチドッグが停止を報告することがありました。タイムアウトとタイマーの相互作用については、[ストリーミングアイドルウォッチドッグ](https://code.claude.com/docs/ja/network-config.md#streaming-idle-watchdogs)を参照してください |

433| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | `1` に設定すると、Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでバイトレベルのストリーミングアイドルウォッチドッグを有効にし、Bedrock のストリーミングリクエストで[最初のバイトの期限](https://code.claude.com/docs/ja/network-config.md#streaming-idle-watchdogs)も有効にします。デフォルトではオフです。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します |433| `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK` | `1` に設定すると、Amazon Bedrock の `vnd.amazon.eventstream` レスポンスでバイトレベルのストリーミングアイドルウォッチドッグを有効にし、Bedrock のストリーミングリクエストで[最初のバイトの期限](https://code.claude.com/docs/ja/network-config.md#streaming-idle-watchdogs)も有効にします。デフォルトではオフです。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します |

434| `CLAUDE_ENABLE_STREAM_WATCHDOG` | `0` に設定するとイベントレベルのストリーミングアイドルウォッチドッグを強制的に無効にし、`1` に設定すると強制的に有効にします。未設定の場合、ウォッチドッグはすべてのプロバイダーでデフォルトでオンになります。v2.1.196 より前は、未設定時のデフォルトは Anthropic API への直接接続ではサーバー側で制御され、その他のプロバイダーではオフでした。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します。これと並行して動作するその他の停止タイマーについては、[ストリーミングアイドルウォッチドッグ](https://code.claude.com/docs/ja/network-config.md#streaming-idle-watchdogs)を参照してください |434| `CLAUDE_ENABLE_STREAM_WATCHDOG` | `0` に設定するとイベントレベルのストリーミングアイドルウォッチドッグを強制的に無効にし、`1` に設定すると強制的に有効にします。未設定の場合、ウォッチドッグはすべてのプロバイダーでデフォルトでオンになります。v2.1.196 より前は、未設定時のデフォルトは Anthropic API への直接接続ではサーバー側で制御され、その他のプロバイダーではオフでした。タイムアウトは `CLAUDE_STREAM_IDLE_TIMEOUT_MS` で設定します。これと並行して動作するその他の停止タイマーについては、[ストリーミングアイドルウォッチドッグ](https://code.claude.com/docs/ja/network-config.md#streaming-idle-watchdogs)を参照してください |

575* [Remote Control](https://code.claude.com/docs/ja/remote-control.md#requirements) が利用できない場合に、[このマシン以外のセッションにメッセージを送る](https://code.claude.com/docs/ja/cross-session-messaging.md#message-sessions-on-other-machines)。このマシン上のセッション間のメッセージングは、取得がオフでも機能します575* [Remote Control](https://code.claude.com/docs/ja/remote-control.md#requirements) が利用できない場合に、[このマシン以外のセッションにメッセージを送る](https://code.claude.com/docs/ja/cross-session-messaging.md#message-sessions-on-other-machines)。このマシン上のセッション間のメッセージングは、取得がオフでも機能します

576* [`claude import` または `/import` コマンド](https://code.claude.com/docs/ja/cli-reference#cli-commands)を実行する576* [`claude import` または `/import` コマンド](https://code.claude.com/docs/ja/cli-reference#cli-commands)を実行する

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

578* Pro プランおよび Max プランで [`/restart`](https://code.claude.com/docs/ja/commands) を実行する

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

579* [You should know mod](https://code.claude.com/docs/ja/interactive-mode.md#you-should-know-suggestions) をオンにする580* [You should know mod](https://code.claude.com/docs/ja/interactive-mode.md#you-should-know-suggestions) をオンにする

580* [アドバイザーツール](https://code.claude.com/docs/ja/advisor.md#requirements)を使用する581* [アドバイザーツール](https://code.claude.com/docs/ja/advisor.md#requirements)を使用する

277| `Windows reported an error (EBADF) when Claude Code read this session's transcript file` | [コマンドラインエラー](#windows-reported-an-error-ebadf) |277| `Windows reported an error (EBADF) when Claude Code read this session's transcript file` | [コマンドラインエラー](#windows-reported-an-error-ebadf) |

278| `Cannot switch renderers in this session` | [コマンドラインエラー](#cannot-switch-renderers-in-this-session) |278| `Cannot switch renderers in this session` | [コマンドラインエラー](#cannot-switch-renderers-in-this-session) |

279| `Cannot switch renderers while work is running in the background` | [コマンドラインエラー](#cannot-switch-renderers-in-this-session) |279| `Cannot switch renderers while work is running in the background` | [コマンドラインエラー](#cannot-switch-renderers-in-this-session) |

280| `Can't restart while work is running in the background — wait for it to finish (or stop it via /tasks), then try again.` | [コマンドラインエラー](#cant-restart-while-work-is-running-or-remote-control-is-connected) |

281| `Can't restart while Remote Control is connected. To use the installed version, exit and start Claude Code again, then run /resume.` | [コマンドラインエラー](#cant-restart-while-work-is-running-or-remote-control-is-connected) |

280| `Claude Code couldn't restart` | [コマンドラインエラー](#claude-code-couldnt-restart) |282| `Claude Code couldn't restart` | [コマンドラインエラー](#claude-code-couldnt-restart) |

281| `Couldn't open Claude Desktop` | [コマンドラインエラー](#couldnt-open-claude-desktop) |283| `Couldn't open Claude Desktop` | [コマンドラインエラー](#couldnt-open-claude-desktop) |

282| `Failed to open Claude Desktop. Please try opening it manually.` | [コマンドラインエラー](#couldnt-open-claude-desktop) |284| `Failed to open Claude Desktop. Please try opening it manually.` | [コマンドラインエラー](#couldnt-open-claude-desktop) |

858 860 

859### The prompt to confirm went unanswered861### The prompt to confirm went unanswered

860 862 

861アカウントが [Fable 使用クレジット同意](https://code.claude.com/docs/ja/model-config.md#fable-and-usage-credits) を必要とする場合、Claude Code は Fable リクエストが使用クレジットに課金する前に確認するよう求めます。同意プロンプトが誰も答えないまま閉じられた場合、Claude Code はターンを次のいずれかのメッセージで終了します。863[Fable 使用クレジット同意プロンプト](https://code.claude.com/docs/ja/model-config.md#fable-and-usage-credits) が誰も答えないまま閉じられた場合、Claude Code はターンを次のいずれかのメッセージで終了します。

862 864 

863```text theme={null}865```text theme={null}

864Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change866Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

3298* **`Error: Workspace not trusted. <folder> is your home directory`**: ホームディレクトリに対する信頼は保存されないため、先にそこで `claude` を実行しても解決しません。代わりに、プロジェクトディレクトリで一度 `claude` を実行して信頼ダイアログを承認した後、そこから `claude ultrareview` を実行するか、`--trust-workspace` を追加します。3300* **`Error: Workspace not trusted. <folder> is your home directory`**: ホームディレクトリに対する信頼は保存されないため、先にそこで `claude` を実行しても解決しません。代わりに、プロジェクトディレクトリで一度 `claude` を実行して信頼ダイアログを承認した後、そこから `claude ultrareview` を実行するか、`--trust-workspace` を追加します。

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

3300* **`Ultrareview did not start: <folder> is not trusted`**: `n` と答えるか Enter を押すなどして、`Trust <folder>? [y/N]` の質問で拒否しました。レビューを開始するには、`claude ultrareview` を再実行して `y` と答えます。3302* **`Ultrareview did not start: <folder> is not trusted`**: `n` と答えるか Enter を押すなどして、`Trust <folder>? [y/N]` の質問で拒否しました。レビューを開始するには、`claude ultrareview` を再実行して `y` と答えます。

3301* **``Ultrareview did not start: `--trust-workspace` takes no value``**：PR 番号や `false` など、フラグ以外のものが `--trust-workspace` の後に続いています。フォルダーを信頼しない場合は、フラグを省略します。この実行に限り信頼するには、PR 番号またはベースブランチをフラグの前に置きます：`claude ultrareview 1234 --trust-workspace`。3303* **``Ultrareview did not start: `--trust-workspace` takes no value``**: PR 番号や `false` など、フラグ以外のものが `--trust-workspace` の後に続いています。フォルダを信頼しない場合は、フラグを省略します。この実行に限り信頼するには、PR 番号またはベースブランチをフラグの前に置きます：`claude ultrareview 1234 --trust-workspace`。

3302 3304 

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

3304 3306 

3590 3592 

3591関連するメッセージは、コマンドが実行される前に発生します:3593関連するメッセージは、コマンドが実行される前に発生します:

3592 3594 

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

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

3595 3597 

3596**対処方法:**3598**対処方法:**

3597 3599 

3744 3746 

3745* **ベースブランチを渡さなかった場合**：Claude Code はリポジトリのデフォルトブランチと比較しており、上記の例のようにベースを明示的に渡すよう提案します3747* **ベースブランチを渡さなかった場合**：Claude Code はリポジトリのデフォルトブランチと比較しており、上記の例のようにベースを明示的に渡すよう提案します

3746* **クローン内にすでに存在するベースブランチを渡した場合**：ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります3748* **クローン内にすでに存在するベースブランチを渡した場合**：ヒントは ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)`` となります

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

3748 3750 

3749**対処方法：**3751**対処方法：**

3750 3752 

3974 3976 

3975* それらの制限なしで開始したセッションで `/tui fullscreen` を実行するか、元に戻すには `/tui default` を実行します。Claude Code はそこで [`tui` 設定](https://code.claude.com/docs/ja/settings-reference#tui)を保存します3977* それらの制限なしで開始したセッションで `/tui fullscreen` を実行するか、元に戻すには `/tui default` を実行します。Claude Code はそこで [`tui` 設定](https://code.claude.com/docs/ja/settings-reference#tui)を保存します

3976 3978 

3979### Can't restart while work is running or Remote Control is connected

3980 

3981Claude Code は再起動せず、セッションはそのまま実行を続けています。メッセージに示された修正方法に従ってください。

3982 

3977### Claude Code couldn't restart3983### Claude Code couldn't restart

3978 3984 

3979このメッセージで会話が保存されていると表示された場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は、たとえば [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) の実行後にフルスクリーンレンダリングとの切り替えを行うために自身を再起動しようとしましたが、新しいプロセスを開始できなかったため、ステータス 1 で終了しました。3985このメッセージで会話が保存されていると表示された場合、会話はディスク上にあり、中断したところから再開できます。Claude Code は、たとえば [`/tui`](https://code.claude.com/docs/ja/fullscreen#enable-fullscreen-rendering) の実行後にフルスクリーンレンダリングとの切り替えを行うために自身を再起動しようとしましたが、新しいプロセスを開始できなかったため、ステータス 1 で終了しました。

168 168 

169> [!WARNING]169> [!WARNING]

170>170>

171> Claude Code は `/goal` 評価だけでなく、小型高速モデルを使用するあらゆる場所で `ANTHROPIC_DEFAULT_HAIKU_MODEL` を読み取ります。これを設定すると、Claude Code は [`haiku` エイリアス](https://code.claude.com/docs/ja/model-config#model-aliases) をそのモデルに解決し、会話要約などの [バックグラウンド機能](https://code.claude.com/docs/ja/costs.md#background-token-usage) をそれで実行します。171> Claude Code は `/goal` 評価だけでなく、小型高速モデルを使用するあらゆる場所で `ANTHROPIC_DEFAULT_HAIKU_MODEL` を読み取ります。これを設定すると、Claude Code は [`haiku` エイリアス](https://code.claude.com/docs/ja/model-config#model-aliases) もそのモデルに解決し、セッションタイトルの生成やその他の一部のバックグラウンドタスクをそのモデルで実行します。

172 172 

173評価者は、セッションが設定されているプロバイダーで実行されます。ツールを呼び出さないため、Claude が既に会話で表示したものだけを判定できます。173評価者は、セッションが設定されているプロバイダーで実行されます。ツールを呼び出さないため、Claude が既に会話で表示したものだけを判定できます。

174 174 

26 26 

27| 時期 | 行うこと |27| 時期 | 行うこと |

28| :- | :- |28| :- | :- |

29| 設定が適用される前 | [コンピューターを準備する](#prepare-computers-before-the-hipaa-configuration-is-applied)：開発者の接続方法を確認し、アプリを更新し、ネットワークアクセスを許可し、管理設定をデプロイします |29| 設定が適用される前 | [コンピューターを準備する](#prepare-computers-before-the-hipaa-configuration-is-applied)：開発者の接続方法を確認し、アプリを更新し、ネットワークアクセスを許可し、管理設定をデプロイし、Claude Desktop へのサインインを制限します |

30| 適用された後 | Owner が再びオンにするまで Code タブはオフになります。[コンピューター上で設定を確認する](#confirm-the-configuration-on-a-computer) |30| 適用された後 | Owner が再びオンにするまで Code タブはオフになります。[コンピューター上で設定を確認する](#confirm-the-configuration-on-a-computer) |

31| 継続的に | [ローカルセッションデータを管理する](#manage-local-session-data) |31| 継続的に | [ローカルセッションデータを管理する](#manage-local-session-data) |

32 32 

161 161 

162HIPAA 設定なしで実行されるセッションが BAA の対象となるかどうかについては、[HIPAA 対応 Enterprise プランで Claude Code（ローカルモード）と Cowork（ローカルモード）を使用する](https://support.claude.com/en/articles/17318731)を参照してください。162HIPAA 設定なしで実行されるセッションが BAA の対象となるかどうかについては、[HIPAA 対応 Enterprise プランで Claude Code（ローカルモード）と Cowork（ローカルモード）を使用する](https://support.claude.com/en/articles/17318731)を参照してください。

163 163 

164### Claude Desktop のサインインを制限する

165 

166開発者が Claude Desktop の Code タブを使用する場合は、[サインインを組織に制限する](https://code.claude.com/docs/ja/desktop.md#restrict-sign-in-to-your-organization)の説明に従って、Claude Desktop のポリシーにも `forceLoginOrgUUID` を設定してください。管理設定で `forceLoginMethod` と `forceLoginOrgUUID` をデプロイしても、Claude Desktop のサインイン画面は変わりません。

167 

164## コンピューター上で設定を確認する168## コンピューター上で設定を確認する

165 169 

166組織に設定が適用された後、管理対象のコンピューター 1 台でこの確認を行ってください。170組織に設定が適用された後、管理対象のコンピューター 1 台でこの確認を行ってください。

735| `cwd` | フックが呼び出されるときの現在の作業ディレクトリ |735| `cwd` | フックが呼び出されるときの現在の作業ディレクトリ |

736| `scratchpad_dir` | セッションの[スクラッチパッド ディレクトリ](https://code.claude.com/docs/ja/claude-directory.md#session-scratchpad-directory)へのパス。Claude はここに一時的な作業ファイルを保持します。セッションにスクラッチパッドがない場合、または一時ディレクトリが利用できない場合は存在しません。Claude Code v2.1.257 以降が必要です |736| `scratchpad_dir` | セッションの[スクラッチパッド ディレクトリ](https://code.claude.com/docs/ja/claude-directory.md#session-scratchpad-directory)へのパス。Claude はここに一時的な作業ファイルを保持します。セッションにスクラッチパッドがない場合、または一時ディレクトリが利用できない場合は存在しません。Claude Code v2.1.257 以降が必要です |

737| `permission_mode` | 現在の[権限モード](https://code.claude.com/docs/ja/permissions.md#permission-modes): `"default"`、`"plan"`、`"acceptEdits"`、`"auto"`、`"dontAsk"`、または `"bypassPermissions"`。**Manual** というラベルが付いたモードは `"default"` として到着し、`"manual"` として到着することはないため、`"default"` と一致するスクリプトは引き続き機能します。すべてのイベントがこのフィールドを受け取るわけではありません。各[フック イベント](#hook-events)セクションの JSON 例を確認してください |737| `permission_mode` | 現在の[権限モード](https://code.claude.com/docs/ja/permissions.md#permission-modes): `"default"`、`"plan"`、`"acceptEdits"`、`"auto"`、`"dontAsk"`、または `"bypassPermissions"`。**Manual** というラベルが付いたモードは `"default"` として到着し、`"manual"` として到着することはないため、`"default"` と一致するスクリプトは引き続き機能します。すべてのイベントがこのフィールドを受け取るわけではありません。各[フック イベント](#hook-events)セクションの JSON 例を確認してください |

738| `effort` | フックの実行時に有効な [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)を保持する `level` フィールドを持つオブジェクト: `"low"`、`"medium"`、`"high"`、`"xhigh"`、または `"max"`。アクティブなモデルがサポートしていないレベルを設定した場合、`level` は Claude Code が代わりに実行したレベルを報告します。そのレベルの選び方については [effort レベルを調整](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)を参照してください。オブジェクトは[ステータスライン](https://code.claude.com/docs/ja/statusline.md#available-data)の `effort` フィールドと一致します。現在のモデルが effort パラメータをサポートしている場合、`PreToolUse`、`PostToolUse`、`Stop`、`SubagentStop` などのツール使用コンテキスト内で発火するイベントに存在します。レベルは、フック コマンドと Bash ツールでも `$CLAUDE_EFFORT` 環境変数として利用可能です。 |738| `effort` | フックの実行時の [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)設定（スキル、サブエージェント、または `ultrathink` のレベルを含む）を `level` とするオブジェクト: `"low"`、`"medium"`、`"high"`、`"xhigh"`、または `"max"`。effort をサポートするモデルで、`PreToolUse`、`PostToolUse`、`Stop`、`SubagentStop`、およびツール使用コンテキストを持つその他のイベントに存在します。設定したレベルをモデルがサポートしていない場合、`level` は実際に実行されたレベルになります。変更したレベルは、[適用が開始される](https://code.claude.com/docs/ja/model-config.md#when-a-new-effort-level-starts)前にここに表示されることがあります。`$CLAUDE_EFFORT` も同じレベルを保持します。 |

739| `hook_event_name` | 発火したイベントの名前 |739| `hook_event_name` | 発火したイベントの名前 |

740 740 

741`agent_id` と `agent_type` は、サブエージェント、[インプロセスのチームメイト](https://code.claude.com/docs/ja/agent-teams.md#choose-a-display-mode)、`--agent` で選択したエージェントなど、フックがどのエージェント内で発火したかをスクリプトに伝えます。741`agent_id` と `agent_type` は、サブエージェント、[インプロセスのチームメイト](https://code.claude.com/docs/ja/agent-teams.md#choose-a-display-mode)、`--agent` で選択したエージェントなど、フックがどのエージェント内で発火したかをスクリプトに伝えます。

1898| `query` | string | `"react hooks best practices"` | 検索クエリ |1898| `query` | string | `"react hooks best practices"` | 検索クエリ |

1899| `allowed_domains` | array | `["docs.example.com"]` | 任意：これらのドメインの結果のみを含めます |1899| `allowed_domains` | array | `["docs.example.com"]` | 任意：これらのドメインの結果のみを含めます |

1900| `blocked_domains` | array | `["spam.example.com"]` | 任意：これらのドメインの結果を除外します |1900| `blocked_domains` | array | `["spam.example.com"]` | 任意：これらのドメインの結果を除外します |

1901| `mode` | string | `"extended"` | オプション：検索の種類。`"standard"` は軽量な検索を、`"extended"` は完全な検索を要求します。`mode` を送信しないセッションもあり、指定のない呼び出しは完全な検索を実行します。Claude Code v2.1.282 以降が必要です |

1901 1902 

1902##### Agent1903##### Agent

1903 1904 

1968 1969 

1969フックが `"ask"` を返すと、ユーザーに表示される権限プロンプトには、フックの出所を示すラベルが含まれます。任意の設定ファイルまたはエージェントのフロントマターからのフックでは `[settings]`、プラグインのフックでは `[plugin:<name>]`、スキルのフロントマターからのフックでは `[skill]` です。これにより、どの設定ソースが確認を求めているかをユーザーが把握できます。1970フックが `"ask"` を返すと、ユーザーに表示される権限プロンプトには、フックの出所を示すラベルが含まれます。任意の設定ファイルまたはエージェントのフロントマターからのフックでは `[settings]`、プラグインのフックでは `[plugin:<name>]`、スキルのフロントマターからのフックでは `[skill]` です。これにより、どの設定ソースが確認を求めているかをユーザーが把握できます。

1970 1971 

1971フックの `"ask"` は、[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)でも権限プロンプトを強制します。分類器は引き続きツール呼び出しを拒否できますが、呼び出しを黙って承認することはできません。

1972 

1973```json theme={null}1972```json theme={null}

1974{1973{

1975 "hookSpecificOutput": {1974 "hookSpecificOutput": {

1988>1987>

1989> 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` を現在の形式として使用します。

1990 1989 

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

1991 

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)はその判断を行いません。一部の呼び出しは異なる経路をたどります。

1993 

1994* **Claude Code 自身のチェックでも警告される呼び出し**：これには、[保護されたパス](https://code.claude.com/docs/ja/permission-modes.md#protected-paths)への書き込みや、[サンドボックスの外で実行する](https://code.claude.com/docs/ja/sandboxing.md#the-unsandboxed-retry-escape-hatch)ことを求めるコマンドが含まれます。分類器は、プロンプトが表示される前にこれらの呼び出しを拒否できます。分類器が承認した場合でも、呼び出しは通常プロンプトに送られます。

1995* **`SubagentHandback` の呼び出し**：このツールはサブエージェントのレポートを配信します。これに対してプロンプトは表示されず、分類器が異議を唱えても呼び出しは実行されます。

1996 

1997`SubagentHandback` の呼び出しを停止するには、`"deny"` を返します。すると Claude Code はサブエージェントに対し、レポートが配信されなかったのでツールを再度呼び出すよう、最大 3 回まで伝えます。フックが拒否し続けると、サブエージェントはこのツールを通じてレポートを配信しないまま終了し、それを待っている会話にはその旨の注記が届きます。

1998 

1991#### ユーザーの操作を必要とするツール1999#### ユーザーの操作を必要とするツール

1992 2000 

1993`AskUserQuestion` と `ExitPlanMode` はユーザーの操作を必要とします。`-p` フラグを使用した[非対話モード](https://code.claude.com/docs/ja/headless.md)では、Claude Code は、Agent SDK の `canUseTool` コールバックなど、プロンプトを受け取る[権限ホスト](https://code.claude.com/docs/ja/headless.md#turn-off-permission-prompts-in-unattended-runs)が実行にある場合にのみ、これらのツールを提供します。2001`AskUserQuestion` と `ExitPlanMode` はユーザーの操作を必要とします。`-p` フラグを使用した[非対話モード](https://code.claude.com/docs/ja/headless.md)では、Claude Code は、Agent SDK の `canUseTool` コールバックなど、プロンプトを受け取る[権限ホスト](https://code.claude.com/docs/ja/headless.md#turn-off-permission-prompts-in-unattended-runs)が実行にある場合にのみ、これらのツールを提供します。

395 395 

396Claude Code は、キューに入れる代わりに、送信直後に実行するコマンドがあります。その中には `/model`、`/effort`、`/fast` があります。これら 3 つはそれぞれ設定を変更します。モデル、effort レベル、または fast mode です。Claude Code が新しい設定を Claude が既に作業しているターンに適用するか、次のターンからのみ適用するかは、コマンドによって異なります。396Claude Code は、キューに入れる代わりに、送信直後に実行するコマンドがあります。その中には `/model`、`/effort`、`/fast` があります。これら 3 つはそれぞれ設定を変更します。モデル、effort レベル、または fast mode です。Claude Code が新しい設定を Claude が既に作業しているターンに適用するか、次のターンからのみ適用するかは、コマンドによって異なります。

397 397 

398* [`/model`](https://code.claude.com/docs/ja/model-config#setting-your-model)：Claude Code が[キャッシュ警告](https://code.claude.com/docs/ja/prompt-caching.md#switching-models)を表示する場合は、確認後、Claude Code はそのターン内で次に行うリクエストに変更を適用します。398* [`/model`](https://code.claude.com/docs/ja/model-config#setting-your-model)：Claude Code が[キャッシュ警告](https://code.claude.com/docs/ja/prompt-caching.md#switching-models)を表示する場合は、確認後、Claude Code はそのターン内で次に行うリクエストから新しいモデルを使用します。

399* `/effort`：次に送信するメッセージが新しいレベルで実行されます。[Claude が既に作業しているターンで新しいレベルを開始する](https://code.claude.com/docs/ja/model-config.md#when-a-new-effort-level-starts)には、Claude がツール呼び出しを実行している間にメッセージをキューに入れます。399* `/effort`：次に送信するメッセージが新しいレベルで実行されます。[Claude が既に作業しているターンで新しいレベルを開始する](https://code.claude.com/docs/ja/model-config.md#when-a-new-effort-level-starts)には、Claude がツール呼び出しを実行している間にメッセージをキューに入れます。

400* [`/fast`](https://code.claude.com/docs/ja/fast-mode#toggle-fast-mode)：Claude Code はターンが開始されたときにアクティブだった fast mode 設定を保持するため、速度の変更は次のターンから適用されます。現在のモデルが fast mode をサポートしていない場合、それをオンにすると[モデルも切り替わり](https://code.claude.com/docs/ja/prompt-caching.md#turning-on-fast-mode)、Claude Code はそのターン内で次に行うリクエストから新しいモデルを使用します。400* [`/fast`](https://code.claude.com/docs/ja/fast-mode#toggle-fast-mode)：Claude Code はターンが開始されたときにアクティブだった fast mode 設定を保持するため、速度の変更は次のターンから適用されます。現在のモデルが fast mode をサポートしていない場合、それをオンにすると[モデルも切り替わり](https://code.claude.com/docs/ja/prompt-caching.md#turning-on-fast-mode)、Claude Code はそのターン内で次に行うリクエストから新しいモデルを使用します。

401 401 

761 761 

762* **プロンプトを送信する**：Claude Code は待機する代わりにプロンプトを送信します。そのプロンプトも制限に達した場合、プロンプトは会話に残り、Claude Code は再び待機を開始します。762* **プロンプトを送信する**：Claude Code は待機する代わりにプロンプトを送信します。そのプロンプトも制限に達した場合、プロンプトは会話に残り、Claude Code は再び待機を開始します。

763* **Claude Code を終了する**：セッションを再開しても待機は再開されません。763* **Claude Code を終了する**：セッションを再開しても待機は再開されません。

764* **会話の所有者が変わる**：`/login` でアカウントを切り替えたり、会話をクリアまたはリワインドしたり、`/resume` で別のセッションを再開したり、`/teleport` で取得したり、`/tui` で再起動したり、セッションを Claude Desktop、バックグラウンドセッション、またはクラウドに渡したりします。764* **会話の所有者が変わる**：`/login` でアカウントを切り替えたり、会話をクリアまたはリワインドしたり、`/resume` で別のセッションを再開したり、`/teleport` で取得したり、`/tui` または [`/restart`](https://code.claude.com/docs/ja/commands#all-commands) で再起動したり、セッションを Claude Desktop、バックグラウンドセッション、またはクラウドに渡したりします。

765* **設定がオフになるか、リセットが 24 時間を超える**：これは Claude Code が自動的に開始した待機のみを終了します。`/rate-limit-options` から選択した待機はカウントダウンを続けます。765* **設定がオフになるか、リセットが 24 時間を超える**：これは Claude Code が自動的に開始した待機のみを終了します。`/rate-limit-options` から選択した待機はカウントダウンを続けます。

766* **続行がブロックされる**：続行プロンプトをブロックする[`UserPromptSubmit` フック](https://code.claude.com/docs/ja/hooks#userpromptsubmit)、またはモデルに到達する前の失敗により、待機が終了します。Claude Code は続行が実行されなかったことを通知します。プロンプトを送信して続行してください。766* **続行がブロックされる**：続行プロンプトをブロックする[`UserPromptSubmit` フック](https://code.claude.com/docs/ja/hooks#userpromptsubmit)、またはモデルに到達する前の失敗により、待機が終了します。Claude Code は続行が実行されなかったことを通知します。プロンプトを送信して続行してください。

767 767 

92 92 

93プランやシート階層によっては、Fable の使用量がプランに含まれる上限から差し引かれるのではなく、[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)に課金される場合があります。その場合、`/model` ピッカーの Fable の行に「Requires usage credits」と表示されます。使用クレジットを管理するには、[サブスクリプションに使用クレジットを追加する](https://code.claude.com/docs/ja/costs.md#add-usage-credits-to-your-subscription)を参照してください。93プランやシート階層によっては、Fable の使用量がプランに含まれる上限から差し引かれるのではなく、[使用クレジット](https://support.claude.com/en/articles/12429409-extra-usage-for-paid-claude-plans)に課金される場合があります。その場合、`/model` ピッカーの Fable の行に「Requires usage credits」と表示されます。使用クレジットを管理するには、[サブスクリプションに使用クレジットを追加する](https://code.claude.com/docs/ja/costs.md#add-usage-credits-to-your-subscription)を参照してください。

94 94 

95対話セッションでは、Fable のリクエストが使用クレジットに課金される前に、Claude Code が同意プロンプトを表示します。組織請求を利用している Enterprise プランのメンバーには、このプロンプトは表示されません。使用クレジットを使って Fable で続行するか、デフォルトモデルに切り替えることができます。プロンプトを閉じることもできます。95対話セッションでは、Claude Code が Fable の使用クレジットに関する同意プロンプトを表示することがあります。組織請求を利用している Enterprise プランのメンバーには、このプロンプトは表示されません。使用クレジットを使って Fable で続行するか、デフォルトモデルに切り替えることができます。プロンプトを閉じることもできます。

96 96 

97* `/model` で Fable モデルを選択した場合は、現在のモデルが維持されます。97* `/model` で Fable モデルを選択した場合は、現在のモデルが維持されます。

98* セッションの途中では、Claude Code はデフォルトモデルでそのターンを続行します。98* セッションの途中では、Claude Code はデフォルトモデルでそのターンを続行します。

544* **ユーザー自身による変更**：effort レベルを選択したり、`/model` でモデルを選んだり、後でセッションを再開したりすると、警告されたリクエストのレベルは引き継がれなくなります。544* **ユーザー自身による変更**：effort レベルを選択したり、`/model` でモデルを選んだり、後でセッションを再開したりすると、警告されたリクエストのレベルは引き継がれなくなります。

545* **1 ターンだけに設定された effort**：警告されたターンを `ultrathink` で引き上げた場合や、スキルの `effort` フロントマターがそのレベルを設定した場合、そのレベルはそのターンに適用されます。以降のターンは、[effort の解決順序](#adjust-effort-level)がフォールバックモデルに与えるレベルで実行されます。545* **1 ターンだけに設定された effort**：警告されたターンを `ultrathink` で引き上げた場合や、スキルの `effort` フロントマターがそのレベルを設定した場合、そのレベルはそのターンに適用されます。以降のターンは、[effort の解決順序](#adjust-effort-level)がフォールバックモデルに与えるレベルで実行されます。

546 546 

547セッション内で `/effort status` を実行すると有効なレベルを確認でき、`/effort` を実行すると変更できます。547フォールバック後にセッションに設定されているレベルを確認するには、`/effort status` を実行します。変更するには、`/effort` を実行します。

548 548 

549#### フォールバックのきっかけを確認する549#### フォールバックのきっかけを確認する

550 550 

607 607 

608Claude Code は、次の順序でセッションの effort レベルを解決し、最初に該当したものを採用します。608Claude Code は、次の順序でセッションの effort レベルを解決し、最初に該当したものを採用します。

609 609 

6101. 明示的な選択：[`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/ja/env-vars#variables) 環境変数、`--effort` を付けた起動、またはセッション内での `/effort`（[非対話の `/effort` は効果の範囲が狭くなります](#non-interactive-effort)）6101. [`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/ja/env-vars#variables) 環境変数

6112. 設定：モデルに対して保存したレベルまたは [`effortLevel`](https://code.claude.com/docs/ja/settings-reference#effortlevel) キー。これらの間および設定ファイル間の優先順位は [`modelSettings`](https://code.claude.com/docs/ja/settings-reference#modelsettings) に記載されています6112. `/effort`、`/model` ピッカー、[`applyFlagSettings()`](https://code.claude.com/docs/ja/agent-sdk/typescript#applyflagsettings) などでセッション内で選んだレベル

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

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 レベルを設定している場合、そのモデルを実行するときはそのレベルがデフォルトになります

613 615 

614自動モデルフォールバックの後に適用されるレベルについては、[フォールバック後の effort レベル](#effort-level-after-a-fallback)を参照してください。616自動モデルフォールバックの後に適用されるレベルについては、[フォールバック後の effort レベル](#effort-level-after-a-fallback)を参照してください。

615 617 

687effort は次のいずれかの方法で変更できます。689effort は次のいずれかの方法で変更できます。

688 690 

689* **`/effort`**：引数なしで `/effort` を実行するとインタラクティブなスライダーが開き、`/effort` の後にレベル名を続けると直接設定でき、`/effort auto` を実行するとアクティブなモデルの保存済みレベルがクリアされます691* **`/effort`**：引数なしで `/effort` を実行するとインタラクティブなスライダーが開き、`/effort` の後にレベル名を続けると直接設定でき、`/effort auto` を実行するとアクティブなモデルの保存済みレベルがクリアされます

690* **`/model` 内**：モデルを選択する際に、左右の矢印キーで effort スライダーを調整します692* **`/model` 内**：モデルを選択する際に、左右の矢印キーで effort スライダーを調整します。新しいレベルは、遅くとも次のメッセージから適用されます。それまでは、新しいモデルであっても Claude が以前のレベルで作業を続けることがあります。`CLAUDE_CODE_EFFORT_LEVEL` など、[選択したレベルより優先されるソース](#adjust-effort-level)が適用されている間は、Claude は代わりにそのソースのレベルで作業します。

691* **`--effort` フラグ**：Claude Code の起動時にレベル名を渡して、1 つのセッションに設定します693* **`--effort` フラグ**：Claude Code の起動時にレベル名を渡して、1 つのセッションに設定します

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

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

694* **接続されたデバイスから**：[Remote Control](https://code.claude.com/docs/ja/remote-control.md#what-connected-devices-see) セッションで、スマートフォンまたはブラウザの effort コントロールからレベルを選びます。レベルは現在のセッションにのみ適用されます。Claude Code v2.1.234 以降が必要です696* **接続されたデバイスから**：[Remote Control](https://code.claude.com/docs/ja/remote-control.md#what-connected-devices-see) セッションで、スマートフォンまたはブラウザの effort コントロールからレベルを選びます。レベルは現在のセッションにのみ適用されます。Claude Code v2.1.234 以降が必要です

695* **スキルとサブエージェントのフロントマター**：[スキル](https://code.claude.com/docs/ja/skills.md#frontmatter-reference)または[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md#supported-frontmatter-fields)の markdown ファイルで `effort` を設定すると、そのスキルまたはサブエージェントの実行時に effort レベルを上書きします697* **スキルとサブエージェントのフロントマター**：[スキル](https://code.claude.com/docs/ja/skills.md#frontmatter-reference)または[サブエージェント](https://code.claude.com/docs/ja/sub-agents.md#supported-frontmatter-fields)の markdown ファイルで `effort` を設定すると、そのスキルまたはサブエージェントの実行時に effort レベルを上書きします

696 698 

697フロントマターの effort は、そのスキルまたはサブエージェントがアクティブなときに適用され、セッションのレベルは上書きしますが、環境変数は上書きしません。[`maxEffortLevel`](https://code.claude.com/docs/ja/settings-reference#maxeffortlevel) または[組織の effort 上限](#organization-effort-limits)は、スキルやサブエージェントが実行されるレベルを引き続き制限します。699スキルの `effort` は、そのスキルが実行されたターンの終了まで適用されます。`context: fork` の場合は、フォークされたサブエージェントの実行中に適用されます。サブエージェントの `effort` は、[呼び出し時に上書きされない](https://code.claude.com/docs/ja/sub-agents.md#choose-an-effort-level)限り、サブエージェントの実行中に適用されます。いずれかが適用されている間、スキルまたはサブエージェントは、起動時に指定したレベル、保存したレベル、選択したレベルにかかわらず、そのレベルで実行されます。`CLAUDE_CODE_EFFORT_LEVEL` が設定されている場合は、代わりにそのレベルが適用されます。

698 700 

699[管理設定](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) を設定します。

700 702 

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

702 704 

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

704 706 

705#### 新しい effort レベルが適用されるタイミング707#### 新しい effort レベルが適用されるタイミング

706 708 

556クラウドセッションのテレメトリを設定する際は、これらの制約を念頭に置いてください。556クラウドセッションのテレメトリを設定する際は、これらの制約を念頭に置いてください。

557 557 

558* **セッションがコレクターに到達できるようにする**: Claude Code はセッションのネットワークを通じてエクスポートを送信するため、`OTEL_EXPORTER_OTLP_ENDPOINT` のホストに到達できるかどうかは、環境の [ネットワークアクセスレベル](https://code.claude.com/docs/ja/cloud-environments.md#access-levels) によって異なります。セッションが選択したレベルでコレクターのドメインに到達できない場合は、[ドメインを環境のアローリストに追加してください](https://code.claude.com/docs/ja/cloud-environments.md#allow-specific-domains)。サーバー管理設定はドメインを環境のネットワークアローリストに追加しないためです。558* **セッションがコレクターに到達できるようにする**: Claude Code はセッションのネットワークを通じてエクスポートを送信するため、`OTEL_EXPORTER_OTLP_ENDPOINT` のホストに到達できるかどうかは、環境の [ネットワークアクセスレベル](https://code.claude.com/docs/ja/cloud-environments.md#access-levels) によって異なります。セッションが選択したレベルでコレクターのドメインに到達できない場合は、[ドメインを環境のアローリストに追加してください](https://code.claude.com/docs/ja/cloud-environments.md#allow-specific-domains)。サーバー管理設定はドメインを環境のネットワークアローリストに追加しないためです。

559* **Claude Tag チャネルは組織レベルの環境を使用します**: チャネルセッションはメンバーの個人環境ではなく組織レベルの環境で実行されるため、[共有環境](https://code.claude.com/docs/ja/cloud-environments.md#organization-shared-environments) でアローリストと環境変数の変更を行い、組織のデフォルトとして設定するか、チャネルにピン留めしてください。559* **Claude Tag チャネル**: 組織のデフォルトとして設定されている、またはチャネルにピン留めされている [共有環境](https://code.claude.com/docs/ja/cloud-environments.md#organization-shared-environments) で、許可リストと環境変数の変更を行ってください。

560* **Cowork は個別に設定されます**: [サーフェスカバレッジテーブル](https://code.claude.com/docs/ja/model-config.md#surface-coverage) に示されているように、Cowork セッションはサーバー管理設定を受け取らないため、サーバー管理 `env` ブロックはそれらのテレメトリを設定しません。560* **Cowork は個別に設定されます**: [サーフェスカバレッジテーブル](https://code.claude.com/docs/ja/model-config.md#surface-coverage) に示されているように、Cowork セッションはサーバー管理設定を受け取らないため、サーバー管理 `env` ブロックはそれらのテレメトリを設定しません。

561 561 

562### クラウドセッションにテレメトリを属性付けする562### クラウドセッションにテレメトリを属性付けする

1467* `result`: スイープが実行された場合は `"complete"`、Claude Code が一時停止した場合は `"skipped"`1467* `result`: スイープが実行された場合は `"complete"`、Claude Code が一時停止した場合は `"skipped"`

1468* `period_days`: マージされた設定の `cleanupPeriodDays` の値（日数）、またはどのソースも設定していない場合は `30`。スキップされたイベントでは、Claude Code が読み取れた設定ソースから計算された、スイープが使用するはずだった値1468* `period_days`: マージされた設定の `cleanupPeriodDays` の値（日数）、またはどのソースも設定していない場合は `30`。スキップされたイベントでは、Claude Code が読み取れた設定ソースから計算された、スイープが使用するはずだった値

1469* `used_default`: 読み取り可能な設定ソースが `cleanupPeriodDays` を設定していない場合は `"true"`、それ以外の場合は `"false"`。完了イベントでは、`"true"` は 30 日のデフォルトが適用されたことを意味します1469* `used_default`: 読み取り可能な設定ソースが `cleanupPeriodDays` を設定していない場合は `"true"`、それ以外の場合は `"false"`。完了イベントでは、`"true"` は 30 日のデフォルトが適用されたことを意味します

1470* `skip_reason`: Claude Code がスイープを一時停止した理由。`result` が `"skipped"` の場合にのみ存在します:1470* `skip_reason`: Claude Code がクリーンアップを一時停止した理由。`result` が `"skipped"` の場合にのみ含まれます:

1471 * `"user_source_disabled"`: [`--setting-sources`](https://code.claude.com/docs/ja/cli-reference#cli-flags) フラグや SDK の [`settingSources`](https://code.claude.com/docs/ja/agent-sdk/typescript#options) オプションなどによってユーザー設定が除外されており、有効なソースのいずれも `cleanupPeriodDays` を提供していない1471 * `"user_source_disabled"`: [`--setting-sources`](https://code.claude.com/docs/ja/cli-reference#cli-flags) フラグや SDK の [`settingSources`](https://code.claude.com/docs/ja/agent-sdk/typescript#options) オプションなどによってユーザー設定が除外されており、有効なソースのいずれも `cleanupPeriodDays` を提供していない

1472 * `"settings_unknowable"`: 設定ファイルを読み取りまたは解析できなかったため、Claude Code が確認できない値に `cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が設定されている可能性がある1472 * `"settings_unknowable"`: 設定ファイルを読み取りまたは解析できなかったため、`cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が Claude Code から見えない値に設定されている可能性がある

1473 * `"settings_invalid_key_set"`: 設定に検証エラーがあり、かつ `cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が明示的に設定されているため、デフォルトにフォールバックするとその設定に反してファイルを削除または保持してしまう可能性がある1473 * `"settings_invalid_key_set"`: 設定に検証エラーがあり、かつ `cleanupPeriodDays` または `desktopSessionCleanupPeriodDays` が明示的に設定されているため、デフォルトにフォールバックすると、その設定に反してファイルを削除または保持してしまう可能性がある

1474 * `"remote_settings_unknowable"`: サードパーティのデプロイ上の Claude Desktop の Code タブのセッションが[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)を要求したが、使用可能なレスポンスを受け取れなかったため、`cleanupPeriodDays` が Claude Code から見えない値に設定されている可能性がある

1474* `transcripts_deleted`: スイープが削除したセッショントランスクリプト（最上位の `~/.claude/projects/*/*.jsonl` ファイル）の数1475* `transcripts_deleted`: スイープが削除したセッショントランスクリプト（最上位の `~/.claude/projects/*/*.jsonl` ファイル）の数

1475* `transcripts_exempted_desktop`: 保持期間を過ぎているものの、[Claude Desktop と Cowork のルール](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)に基づいてスイープが保持したトランスクリプトの数。これらは `files_past_cutoff` にはカウントされません。Claude Code v2.1.248 以降が必要です1476* `transcripts_exempted_desktop`: 保持期間を過ぎているものの、[Claude Desktop と Cowork のルール](https://code.claude.com/docs/ja/claude-directory.md#cleaned-up-automatically)に基づいてスイープが保持したトランスクリプトの数。これらは `files_past_cutoff` にはカウントされません。Claude Code v2.1.248 以降が必要です

1476* `session_files_deleted`: セッションファイルのスイープが削除したアーティファクトの数。トランスクリプトに加え、サイドカー、録画、ツール結果などのセッションごとの付随ファイルが含まれます1477* `session_files_deleted`: セッションファイルのスイープが削除したアーティファクトの数。トランスクリプトに加え、サイドカー、録画、ツール結果などのセッションごとの付随ファイルが含まれます

403 403 

404バージョン範囲、`<plugin>--v<version>` git タグ規約がそれらに対して解決される方法、およびクロスマーケットプレイス信頼については、[Plugin dependencies](https://code.claude.com/docs/ja/plugins/dependencies.md) を参照してください。404バージョン範囲、`<plugin>--v<version>` git タグ規約がそれらに対して解決される方法、およびクロスマーケットプレイス信頼については、[Plugin dependencies](https://code.claude.com/docs/ja/plugins/dependencies.md) を参照してください。

405 405 

406Claude Code がプロジェクトに一致するときにプラグインを提案するようにするには、プロジェクトを識別するシグナルを含む `relevance` ブロックをエントリに追加します。ユーザーにこれらの提案が表示されるのは、管理者が自分のマーケットプレイスを `pluginSuggestionMarketplaces` にリストしている場合のみです。シグナルと有効化ステップについては、[Plugin relevance](https://code.claude.com/docs/ja/plugins/relevance.md) を参照してください。406Claude Code がプロジェクトに一致するときにプラグインを提案するようにするには、プロジェクトを識別するシグナルを含む `relevance` ブロックをエントリに追加します。ユーザーにこれらの提案が表示されるのは、管理者がお客様のマーケットプレイスを `pluginSuggestionMarketplaces` にリストしている場合のみです。シグナルと有効化ステップについては、[Plugin relevance](https://code.claude.com/docs/ja/plugins/relevance.md) を参照してください。

407 407 

408## マーケットプレイスができないことへの対応408## マーケットプレイスができないことへの対応

409 409 

338| CronCreate などのツールでスケジュールされた定期ジョブで、ユーザーの次の入力より前に実行時刻になるもの | その時点ではターンを開始しません。ジョブはその回の実行を失いますが、スケジュールは維持されます。 | 対応は不要です |338| CronCreate などのツールでスケジュールされた定期ジョブで、ユーザーの次の入力より前に実行時刻になるもの | その時点ではターンを開始しません。ジョブはその回の実行を失いますが、スケジュールは維持されます。 | 対応は不要です |

339| mod が開始したモニターからのイベント | モニターは実行され続けます。ユーザーの次の入力より前にモニターが発生させたイベントはドロップされます。ただし、モニターの終了通知は例外で、その入力の後に届きます。 | 対処する方法はありません |339| mod が開始したモニターからのイベント | モニターは実行され続けます。ユーザーの次の入力より前にモニターが発生させたイベントはドロップされます。ただし、モニターの終了通知は例外で、その入力の後に届きます。 | 対処する方法はありません |

340| mod が生成し、後で `$.session.send` で再開したサブエージェントで、ユーザーの次の入力より前に終了するもの | 終了通知は待機し、その入力の後に会話に届きます | 対応は不要です |340| mod が生成し、後で `$.session.send` で再開したサブエージェントで、ユーザーの次の入力より前に終了するもの | 終了通知は待機し、その入力の後に会話に届きます | 対応は不要です |

341| ユーザーがターンを停止した時点ですでに実行中で、ユーザーの次の入力より前にタイムアウトに達する、`$.tool.call` からのフォアグラウンドの Bash または PowerShell コマンド | [バックグラウンドに移動する](https://code.claude.com/docs/ja/tools-reference.md#foreground-commands-that-move-to-the-background)代わりに、タイムアウトで停止されます。呼び出しは `isError` が設定された状態で解決し、出力には `Ended instead of moving to the background: plugins' input is held, by a Stop or by the host's limits.` という行が含まれます。 | ユーザーの次の入力の後に、[拒否またはドロップされた呼び出しを再試行する](#retry-a-refused-or-dropped-call)の方法で再実行します |

341 342 

342ユーザーの次の入力より前にスケジュールされたジョブが実行時刻になるか、モニターがイベントを発生させた場合、ユーザーには [`Stopped:` トースト](https://code.claude.com/docs/ja/plugins/mods/troubleshoot#stopped-type-a-message-to-continue)が表示されることがあります。343ユーザーの次の入力より前にスケジュールされたジョブが実行時刻になるか、モニターがイベントを発生させた場合、ユーザーには [`Stopped:` トースト](https://code.claude.com/docs/ja/plugins/mods/troubleshoot#stopped-type-a-message-to-continue)が表示されることがあります。

343 344 

94 94 

95ほとんどのモデルでは、セッション中に [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level) を変更すると、次のリクエストはキャッシュヒットなしで会話履歴全体を読み込みます。キャッシュがまだ温かい間、Claude Code は最初に変更を確認するよう求めます。95ほとんどのモデルでは、セッション中に [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level) を変更すると、次のリクエストはキャッシュヒットなしで会話履歴全体を読み込みます。キャッシュがまだ温かい間、Claude Code は最初に変更を確認するよう求めます。

96 96 

97API キーまたは Claude サブスクリプションを使用する Opus 5.5、Sonnet 5.5、Haiku 5.5、および Fable 5.1 では、effort を変更してもキャッシュが保持され、Claude Code は確認なしに新しいレベルを適用します。これは Amazon Bedrock、Google Cloud の Agent Platform、または [Claude アプリゲートウェイ](https://code.claude.com/docs/ja/claude-apps-gateway) には適用されません。また、[`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) を設定した場合、または組織が HIPAA 構成を持つ場合にも適用されません。97API キーまたは Claude サブスクリプションを使用する Opus 5.5、Sonnet 5.5、Haiku 5.5、および Fable 5.1 では、effort を変更してもキャッシュが保持されます。Claude Code は確認なしに [新しいレベルを適用](https://code.claude.com/docs/ja/model-config.md#when-a-new-effort-level-starts) します。Amazon Bedrock、Google Cloud の Agent Platform、または [Claude アプリゲートウェイ](https://code.claude.com/docs/ja/claude-apps-gateway) を使用する場合、あるいは [`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`](https://code.claude.com/docs/ja/llm-gateway-protocol#disable-pre-release-capabilities) を設定した場合や組織が HIPAA 構成を持つ場合は、ほとんどのモデルと同じように動作します。

98 98 

99v2.1.260 より前では、API キーまたは Claude サブスクリプションを使用する Fable 5.1 の effort を変更すると、キャッシュも無効化されていました。99v2.1.260 より前では、API キーまたは Claude サブスクリプションを使用する Fable 5.1 の effort を変更すると、キャッシュも無効化されていました。

100 100 

565 565 

566macOS では、拒否されたパスがシンボリックリンクを経由する場合（dotfiles リポジトリへのリンクである `~/.claude` など）、サンドボックスはそのパスの実際の場所も拒否します。これは、サンドボックス自体による拒否と、ユーザーがリテラルで記述した `denyWrite` および `denyRead` エントリに適用されます。566macOS では、拒否されたパスがシンボリックリンクを経由する場合（dotfiles リポジトリへのリンクである `~/.claude` など）、サンドボックスはそのパスの実際の場所も拒否します。これは、サンドボックス自体による拒否と、ユーザーがリテラルで記述した `denyWrite` および `denyRead` エントリに適用されます。

567 567 

568`*`、`?`、または `[` を含む `denyWrite` エントリも、これらの文字のうち最初に現れるものより前にあるフォルダーがシンボリックリンクである場合は対象となります。たとえば、`~/.claude/*.json` は `~/.claude` の実際の場所の下でも拒否されます。

569 

568### ネットワークの分離570### ネットワークの分離

569 571 

570サンドボックス化されたコマンドには、ネットワークへの直接の経路がありません。572サンドボックス化されたコマンドには、ネットワークへの直接の経路がありません。

40* **ゼロデータ保持と HIPAA**: [ゼロデータ保持](https://code.claude.com/docs/ja/zero-data-retention.md)が有効になっている組織、または [HIPAA 設定](https://code.claude.com/docs/ja/hipaa-setup.md)が適用されている組織では利用できません。40* **ゼロデータ保持と HIPAA**: [ゼロデータ保持](https://code.claude.com/docs/ja/zero-data-retention.md)が有効になっている組織、または [HIPAA 設定](https://code.claude.com/docs/ja/hipaa-setup.md)が適用されている組織では利用できません。

41* **モデル推論**: ランナーを [Amazon Bedrock または Google Cloud の Agent Platform にモデルリクエストを送信する](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#send-model-requests-to-bedrock-or-agent-platform)ように構成しない限り、セッションは Anthropic API を使用します。いずれの場合も、セッションのコンテンツは Anthropic に送信されます。このように構成されたランナーでは、claude.ai の[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)と組織ポリシーはセッションに適用されません。41* **モデル推論**: ランナーを [Amazon Bedrock または Google Cloud の Agent Platform にモデルリクエストを送信する](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#send-model-requests-to-bedrock-or-agent-platform)ように構成しない限り、セッションは Anthropic API を使用します。いずれの場合も、セッションのコンテンツは Anthropic に送信されます。このように構成されたランナーでは、claude.ai の[サーバー管理設定](https://code.claude.com/docs/ja/server-managed-settings.md)と組織ポリシーはセッションに適用されません。

42* **サーフェス**: [claude.ai/code](https://claude.ai/code)、モバイルおよびデスクトップアプリ、[クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md)、およびターミナルから開始されたセッション（[`claude --cloud`](https://code.claude.com/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)または[`--environment`ディスパッチ](https://code.claude.com/docs/ja/self-hosted-environments-testing#run-the-test-loop)を使用）は、自己ホスト環境で実行できます。[Claude Tag](https://claude.com/docs/claude-tag/overview)セッションもそれらで実行できますが、Claude はまだそれらのセッションで[アクセスバンドル](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle)を使用できません。[Claude Security](https://code.claude.com/docs/ja/claude-security.md)および[Code Review](https://code.claude.com/docs/ja/code-review.md)セッションはまだそれらにルーティングされません。これら 2 つのサーフェスのサポートは別途提供されます。42* **サーフェス**: [claude.ai/code](https://claude.ai/code)、モバイルおよびデスクトップアプリ、[クラウドスケジュールタスク](https://code.claude.com/docs/ja/routines.md)、およびターミナルから開始されたセッション（[`claude --cloud`](https://code.claude.com/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)または[`--environment`ディスパッチ](https://code.claude.com/docs/ja/self-hosted-environments-testing#run-the-test-loop)を使用）は、自己ホスト環境で実行できます。[Claude Tag](https://claude.com/docs/claude-tag/overview)セッションもそれらで実行できますが、Claude はまだそれらのセッションで[アクセスバンドル](https://claude.com/docs/claude-tag/concepts/glossary#access-bundle)を使用できません。[Claude Security](https://code.claude.com/docs/ja/claude-security.md)および[Code Review](https://code.claude.com/docs/ja/code-review.md)セッションはまだそれらにルーティングされません。これら 2 つのサーフェスのサポートは別途提供されます。

43* **リポジトリ**: セッションは GitHub からリポジトリをチェックアウトします。[GitHub 認証オプション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#github-authentication-options)を参照してください。GitHub Enterprise Server ホストについては、その[ネットワーク要件](https://code.claude.com/docs/ja/github-enterprise-server.md#network-requirements)を参照してください。43* **リポジトリ**: セッションは GitHub または GitHub Enterprise Server からリポジトリをチェックアウトします。`--environment` ディスパッチで開始されたセッションでは、他の git ホストも使用できます。

44 * **GitHub**: [GitHub 認証オプション](https://code.claude.com/docs/ja/claude-code-on-the-web.md#github-authentication-options)を参照してください。

45 * **GitHub Enterprise Server**: その[ネットワーク要件](https://code.claude.com/docs/ja/github-enterprise-server.md#network-requirements)を参照してください。

46 * **その他の git ホスト**: [`--environment` でセッションを開始するための要件](https://code.claude.com/docs/ja/self-hosted-environments-deploy#start-a-session-on-a-repository-outside-github)を参照してください。

44* **請求**: 自己ホスト環境のセッションは、Anthropic ホスト環境のセッションと同じ方法で組織の Claude Code 使用量を消費します。47* **請求**: 自己ホスト環境のセッションは、Anthropic ホスト環境のセッションと同じ方法で組織の Claude Code 使用量を消費します。

45 48 

46## 自己ホスティングを選ぶ理由49## 自己ホスティングを選ぶ理由

113 116 

114* **コントロールプレーン**：ランナーは `api.anthropic.com` をポーリングして作業を取得し、セットアップの進行状況や失敗のイベントを送信します。これらはすべてアウトバウンドの HTTPS です。ポーリングはランナーのハートビートも兼ねます。117* **コントロールプレーン**：ランナーは `api.anthropic.com` をポーリングして作業を取得し、セットアップの進行状況や失敗のイベントを送信します。これらはすべてアウトバウンドの HTTPS です。ポーリングはランナーのハートビートも兼ねます。

115* **Git**：ランナーは、デプロイによって提供される認証情報で認証し、HTTPS または SSH 経由で git ホストからクローンおよびプッシュを行います。セッションごとに発行される認証情報を含むオプションについては、[git の設定](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#configure-git)を参照してください。[Anthropic git プロキシ](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#use-the-anthropic-git-proxy)を使用する場合、github.com 上のリポジトリに対する git トラフィックは代わりに `api.anthropic.com` を経由します。118* **Git**：ランナーは、デプロイによって提供される認証情報で認証し、HTTPS または SSH 経由で git ホストからクローンおよびプッシュを行います。セッションごとに発行される認証情報を含むオプションについては、[git の設定](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#configure-git)を参照してください。[Anthropic git プロキシ](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#use-the-anthropic-git-proxy)を使用する場合、github.com 上のリポジトリに対する git トラフィックは代わりに `api.anthropic.com` を経由します。

116* **セッションの子プロセス**：子 Claude Code プロセスは `api.anthropic.com` へのセッションのイベントストリームを保持し、モデル推論とセッション中に実行される git コマンドのために独自のアウトバウンド呼び出しを行います。[Anthropic が管理する git](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#use-the-anthropic-git-proxy) を使用するセッションでは、子プロセスは github.com 向けの `git` および `gh` のトラフィックを、自身が `api.anthropic.com` に対して開く WebSocket 接続経由で送信します。119* **セッションの子プロセス**：子 Claude Code プロセスは、`api.anthropic.com` へのセッションのイベントストリームを保持し、モデル推論とセッション中に実行される Git コマンドのために独自のアウトバウンド呼び出しを行います。[Anthropic 管理の Git](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#use-the-anthropic-git-proxy) を使用するセッションでは、子プロセスは `api.anthropic.com` への WebSocket 接続を開き、`git` と `gh` からの github.com トラフィックを伝送します。

117* **SCM コネクタ**：オプションのオーケストレーター [SCM コネクタ](https://code.claude.com/docs/ja/self-hosted-environments-reference.md#scm-connector-flags)は利用できないため、そのトンネルは開かれません。このトンネルは `api.anthropic.com` への WebSocket 接続です。120* **SCM コネクタ**：オプションのオーケストレーター [SCM コネクタ](https://code.claude.com/docs/ja/self-hosted-environments-reference.md#scm-connector-flags)は利用できないため、そのトンネルは開かれません。このトンネルは `api.anthropic.com` への WebSocket 接続です。

118 121 

119エグレスの完全な一覧については[ネットワーク要件](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#network-requirements)を参照してください。[上の図](#how-self-hosted-environments-work)は、オプションの SCM コネクタと Anthropic が管理する git 接続を除く、これらの経路を示しています。122エグレスの完全な一覧については[ネットワーク要件](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#network-requirements)を参照してください。[上の図](#how-self-hosted-environments-work)は、オプションの SCM コネクタと Anthropic が管理する git 接続を除く、これらの経路を示しています。

42| `CLAUDE_CODE_REMOTE_MCP_CONFIG` | Anthropic のコントロールプレーンがこのセッション用に配信した MCP サーバー定義を保持する、`CLAUDE_CONFIG_DIR` 内のファイルへのパス。ラッパーが子の環境を再構築する場合は、この変数を引き継いでください。この変数がないと、コントロールプレーンが配信するサーバーを更新したときに、ラッパーが [`--mcp-config`](https://code.claude.com/docs/ja/cli-reference#cli-flags) で追加した stdio、HTTP、SSE サーバーのうち更新に含まれないものを子がシャットダウンします。Claude Code v2.1.299 以降が必要です。 |42| `CLAUDE_CODE_REMOTE_MCP_CONFIG` | Anthropic のコントロールプレーンがこのセッション用に配信した MCP サーバー定義を保持する、`CLAUDE_CONFIG_DIR` 内のファイルへのパス。ラッパーが子の環境を再構築する場合は、この変数を引き継いでください。この変数がないと、コントロールプレーンが配信するサーバーを更新したときに、ラッパーが [`--mcp-config`](https://code.claude.com/docs/ja/cli-reference#cli-flags) で追加した stdio、HTTP、SSE サーバーのうち更新に含まれないものを子がシャットダウンします。Claude Code v2.1.299 以降が必要です。 |

43| `ANTHROPIC_BASE_URL` | こどもが使用する API ベース URL。コントロールプレーンによってセッションごとに配信され、通常は `https://api.anthropic.com` です。上書きしないでください。セッションの推論認証情報は Anthropic が発行した OAuth トークンであり、他のプロバイダーはこれを受け入れません。 |43| `ANTHROPIC_BASE_URL` | こどもが使用する API ベース URL。コントロールプレーンによってセッションごとに配信され、通常は `https://api.anthropic.com` です。上書きしないでください。セッションの推論認証情報は Anthropic が発行した OAuth トークンであり、他のプロバイダーはこれを受け入れません。 |

44| `CLAUDE_CODE_OAUTH_TOKEN` | 子がモデル推論に使用する短期 OAuth アクセストークン。約 30 分の有効期限があります。ランナーは有効期限前に再発行し、子の stdin を介して更新を配信するため、[stdin を接続したままにしない](#keep-stdin-and-file-descriptor-3-attached) ラッパーは初期値のみを見ます。組織の IP 許可リストに依存してこのトークンの使用を制限しないでください。リークした場合に約 30 分間使用可能なままのベアラー認証情報として扱い、ログに記録したり、ディスクに書き込んだり、セッションコンテナの外に転送したりしないでください。 |44| `CLAUDE_CODE_OAUTH_TOKEN` | 子がモデル推論に使用する短期 OAuth アクセストークン。約 30 分の有効期限があります。ランナーは有効期限前に再発行し、子の stdin を介して更新を配信するため、[stdin を接続したままにしない](#keep-stdin-and-file-descriptor-3-attached) ラッパーは初期値のみを見ます。組織の IP 許可リストに依存してこのトークンの使用を制限しないでください。リークした場合に約 30 分間使用可能なままのベアラー認証情報として扱い、ログに記録したり、ディスクに書き込んだり、セッションコンテナの外に転送したりしないでください。 |

45| `CLAUDE_RUNNER_ALIVE_EVERY_MS` | [子の初期化前にターンが開始した](https://code.claude.com/docs/ja/self-hosted-environments-reference.md#session-startup-timeout)場合に、子が生存を報告する間隔（ミリ秒）をランナーが設定します。ラッパーが子の環境を再構築する場合は、この変数を引き継いでください。引き継がないと、ランナーがそのターン中にセッションを解放し、`no child output for <n> — releasing` をログに記録する可能性があります。ランナーと子の両方で v2.1.309 以降が必要です。 |

45 46 

46ラッパーはこどもの管理環境の残りの部分も継承します。これには、サーバーが提供する環境変数が含まれます。`exec` はすべてを自動的に伝播します。ラッパーが別の方法でこどもをスポーンする場合、完全な環境を転送します。47ラッパーはこどもの管理環境の残りの部分も継承します。これには、サーバーが提供する環境変数が含まれます。`exec` はすべてを自動的に伝播します。ラッパーが別の方法でこどもをスポーンする場合、完全な環境を転送します。

47 48 

307| `CLAUDE_RUNNER_ATTEMPT` | ログ記録に使用するセッションごとのカウンター。再試行回数でもリクエスト数でもありません。事前ウォーミング要求では `0` ですが、セッションに対する要求でも `0` になる場合があります。 |308| `CLAUDE_RUNNER_ATTEMPT` | ログ記録に使用するセッションごとのカウンター。再試行回数でもリクエスト数でもありません。事前ウォーミング要求では `0` ですが、セッションに対する要求でも `0` になる場合があります。 |

308| `CLAUDE_RUNNER_ORDER_SERVER_TIME` | ポーリング応答の HTTP `Date` ヘッダーからのサーバー時刻。フックがワークオーダー JWT の `exp` を検証する場合、ローカルクロックの代わりにこの値と比較して、スキューを許容してください。ゲートウェイがヘッダーを省略した場合は空です。 |309| `CLAUDE_RUNNER_ORDER_SERVER_TIME` | ポーリング応答の HTTP `Date` ヘッダーからのサーバー時刻。フックがワークオーダー JWT の `exp` を検証する場合、ローカルクロックの代わりにこの値と比較して、スキューを許容してください。ゲートウェイがヘッダーを省略した場合は空です。 |

309| `CLAUDE_RUNNER_POOL_ID` | 新しいランナーが参加する環境の ID。`ccpool_...` 形式です。 |310| `CLAUDE_RUNNER_POOL_ID` | 新しいランナーが参加する環境の ID。`ccpool_...` 形式です。 |

310| `CLAUDE_RUNNER_ACCOUNT_ID` | セッションをエンキューしたアカウントのタグ付き ID。アカウントごとのルーティング、クォータ、またはチャージバックに使用し、重複排除キーとしては使用しないでください。利用できない場合は空で、Claude Tag チャネルセッションでは常に空です。どのアカウントもこれらのセッションをエンキューしません。 |311| `CLAUDE_RUNNER_ACCOUNT_ID` | セッションをエンキューしたアカウントのタグ付き ID。アカウントごとのルーティング、クォータ、またはチャージバックに使用し、重複排除キーとしては使用しないでください。利用できない場合は空です。 |

311| `CLAUDE_RUNNER_ACCOUNT_EMAIL` | セッションをエンキューしたアカウントのメール。利用できない場合は空です。メールを個人識別情報として扱い、ログに記録しないでください。 |312| `CLAUDE_RUNNER_ACCOUNT_EMAIL` | セッションをエンキューしたアカウントのメール。利用できない場合は空です。メールを個人識別情報として扱い、ログに記録しないでください。 |

312| `CLAUDE_RUNNER_PRIMARY_REPO_URL` | セッションの最初の git ソースの URL。そのリポジトリが事前ウォーミングされたランナーへのルーティング用です。セッションに git ソースがない場合は空です。 |313| `CLAUDE_RUNNER_PRIMARY_REPO_URL` | セッションの最初の git ソースの URL。そのリポジトリが事前ウォーミングされたランナーへのルーティング用です。セッションに git ソースがない場合は空です。 |

313| `CLAUDE_RUNNER_PRIMARY_REPO_REVISION` | セッションの最初の git ソースのリビジョン。ブランチ、SHA、タグ、または完全な参照名です。指定されていない場合は空です。 |314| `CLAUDE_RUNNER_PRIMARY_REPO_REVISION` | セッションの最初の git ソースのリビジョン。ブランチ、SHA、タグ、または完全な参照名です。指定されていない場合は空です。 |

381 382 

382| フラグ（値の例） | 渡す対象 | 動作 |383| フラグ（値の例） | 渡す対象 | 動作 |

383| :- | :- | :- |384| :- | :- | :- |

384| `--release-idle-session-min 30` | フックが起動するすべてのランナー | ランナーは指定した分数アイドル状態が続くとセッションを解放し、その後 0 で終了します。セッションはユーザーが次のメッセージを送信すると再開されますが、[プッシュされていなかった作業は失われます](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#additional-limitations)。セッションが実行したままにしたプロセスについては、[セッションを保持](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#keep-an-idle-session-while-its-processes-run)してください。 |385| `--release-idle-session-min 30` | フックが起動するすべてのランナー | ランナーは指定した分数アイドル状態が続くとセッションを解放し、その後 0 で終了します。セッションはユーザーが次のメッセージを送信すると再開されますが、[プッシュされていなかった作業は失われます](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#resumed-sessions-lose-unpushed-work)。セッションが実行したままにしたプロセスについては、[セッションを保持](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#keep-an-idle-session-while-its-processes-run)してください。 |

385| `--kill-session-after-min 480` | フックが起動するすべてのランナー | 各セッションをその分数に制限します。[アイドルとしてカウントされないセッション](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#some-sessions-don’t-count-as-idle)に対するバックストップとして機能するため、想定される最長のセッションより大きい値を設定してください。 |386| `--kill-session-after-min 480` | フックが起動するすべてのランナー | 各セッションをその分数に制限します。[アイドルとしてカウントされないセッション](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#some-sessions-don’t-count-as-idle)に対するバックストップとして機能するため、想定される最長のセッションより大きい値を設定してください。 |

386| `--exit-if-unused-min 60` | スタンバイランナー（事前ウォーミング要求に対してフックが起動するもの） | セッションを一度も受け取らないスタンバイは、その分数が経過すると終了します。[`--min-idle`](https://code.claude.com/docs/ja/self-hosted-environments-reference#orchestrator-cli-flags) を設定している場合、スタンバイが余剰でない限り代わりのランナーが起動されるため、ブート時間を十分に上回る値を使用してください。 |387| `--exit-if-unused-min 60` | スタンバイランナー（事前ウォーミング要求に対してフックが起動するもの） | セッションを一度も受け取らないスタンバイは、その分数が経過すると終了します。[`--min-idle`](https://code.claude.com/docs/ja/self-hosted-environments-reference#orchestrator-cli-flags) を設定している場合、スタンバイが余剰でない限り代わりのランナーが起動されるため、ブート時間を十分に上回る値を使用してください。 |

387 388 

766 767 

767* **git ID**：ランナーイメージで `user.name` と `user.email` を設定するか、[`--configure-git`](https://code.claude.com/docs/ja/self-hosted-environments-deploy#let-the-runner-configure-git) を付けてランナーを起動します768* **git ID**：ランナーイメージで `user.name` と `user.email` を設定するか、[`--configure-git`](https://code.claude.com/docs/ja/self-hosted-environments-deploy#let-the-runner-configure-git) を付けてランナーを起動します

768* **プッシュ用の認証情報**：[Anthropic 管理の git](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#use-the-anthropic-git-proxy) を使用するか、[イメージに git 設定を含める](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#ship-git-config-in-your-image)の説明に従って認証情報を提供します769* **プッシュ用の認証情報**：[Anthropic 管理の git](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#use-the-anthropic-git-proxy) を使用するか、[イメージに git 設定を含める](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#ship-git-config-in-your-image)の説明に従って認証情報を提供します

769* **再開されたセッションの場合**：環境内のすべてのランナーで [`--push-outcome-on-release`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) を設定します。これにより、再開されたセッションは、Claude がセッションのブランチにプッシュしたコミットから開始されます。このフラグの制限については、[再開されたセッションはプッシュされていない作業を失う](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#additional-limitations)を参照してください。770* **再開されたセッションの場合**：環境内のすべてのランナーで [`--push-outcome-on-release`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) を設定します。これにより、再開されたセッションは、Claude がセッションのブランチにプッシュしたコミットから開始されます。このフラグの制限については、[再開されたセッションはプッシュされていない作業を失う](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#resumed-sessions-lose-unpushed-work)を参照してください。

770 771 

771Stop フックが促すのは 1 ターンにつき最大 1 回です。コミットまたはプッシュが失敗しても、ターンは終了します。セッション内で git のエラーを探し、それが示す問題を修正してください。772Stop フックが促すのは 1 ターンにつき最大 1 回です。コミットまたはプッシュが失敗しても、ターンは終了します。セッション内で git のエラーを探し、それが示す問題を修正してください。

772 773 

63 63 

64| ホスト | ポート | 必須の場合 |64| ホスト | ポート | 必須の場合 |

65| :- | :- | :- |65| :- | :- | :- |

66| `api.github.com` | 443 | `--use-anthropic-git-proxy` の有無にかかわらず、ランナーイメージに [GitHub CLI](#github-api-access-with-the-github-cli) が含まれており、セッションに `GH_TOKEN` などの github.com 認証情報を渡す場合 |

66| `downloads.claude.ai` | 443 | インストール時に、ネイティブインストーラーでホストに Claude Code をインストールまたは更新する場合。`install.sh` スクリプト自体は `claude.ai` から提供されます。セッション実行時には、セッションが公式 Anthropic マーケットプレイスからプラグインをインストールする場合のみです。 |67| `downloads.claude.ai` | 443 | インストール時に、ネイティブインストーラーでホストに Claude Code をインストールまたは更新する場合。`install.sh` スクリプト自体は `claude.ai` から提供されます。セッション実行時には、セッションが公式 Anthropic マーケットプレイスからプラグインをインストールする場合のみです。 |

67| `storage.googleapis.com` | 443 | セッション実行時に、`/plugin` に表示されるプラグインインストール数とメタデータの場合。 |68| `storage.googleapis.com` | 443 | セッション実行時に、`/plugin` に表示されるプラグインインストール数とメタデータの場合。 |

68| `code.claude.com` および `claude.com` | 443 | 組み込みの claude-code-guide エージェントによるドキュメント検索と、セッション中の事前承認された WebFetch リクエストの場合。これらのホストをブロックするとドキュメント検索のみに影響します。 |69| `code.claude.com` および `claude.com` | 443 | 組み込みの claude-code-guide エージェントによるドキュメント検索と、セッション中の事前承認された WebFetch リクエストの場合。これらのホストをブロックするとドキュメント検索のみに影響します。 |

167 168 

168* ランナーは `GIT_TERMINAL_PROMPT=0` を設定するため、git はユーザー名またはパスワードを要求しません。169* ランナーは `GIT_TERMINAL_PROMPT=0` を設定するため、git はユーザー名またはパスワードを要求しません。

169* ランナーは `BatchMode=yes` で SSH を実行します。`GIT_SSH_COMMAND` を設定した場合は追加されます。SSH はパスフレーズまたはホスト確認を要求しません。170* ランナーは `BatchMode=yes` で SSH を実行します。`GIT_SSH_COMMAND` を設定した場合は追加されます。SSH はパスフレーズまたはホスト確認を要求しません。

170* ランナーは `GCM_INTERACTIVE=never` を設定するため、Git Credential Manager はサインインダイアログを開きません。171* ランナーは `GCM_INTERACTIVE=never` を設定するため、Git Credential Manager はサインインダイアログを開きません。v2.1.229 より前は、リポジトリの準備が Git Credential Manager のプロンプトで停止することがありました。

171* ランナーは `core.askPass` をクリアするため、askpass ヘルパーを使用する場合は、`GIT_ASKPASS` 環境変数を通じて設定してください。172* ランナーは `core.askPass` をクリアするため、askpass ヘルパーを使用する場合は、`GIT_ASKPASS` 環境変数を通じて設定してください。

172 173 

173git ホストが認証情報を拒否するか、認証情報を設定しなかった場合、ランナーは数回再試行してから失敗します。リポジトリがセッションがプッシュする結果のリポジトリである場合、ランナーはリポジトリ準備に失敗します。セッションが読み取り専用のリポジトリの場合、[トラブルシューティング](#troubleshooting)はランナーがスキップする場合をカバーしています。ランナーはこれらの設定をセッション環境に渡しません。174git ホストが認証情報を拒否するか、認証情報を設定しなかった場合、ランナーは数回再試行してから失敗します。リポジトリがセッションがプッシュする結果のリポジトリである場合、ランナーはリポジトリ準備に失敗します。セッションが読み取り専用のリポジトリの場合、[トラブルシューティング](#troubleshooting)はランナーがスキップする場合をカバーしています。ランナーはこれらの設定をセッション環境に渡しません。

287* **`jq`**：`--jq` を使用したい場合は、イメージに `jq` をインストールしてください288* **`jq`**：`--jq` を使用したい場合は、イメージに `jq` をインストールしてください

288* **[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars)**：セッション環境でこれが設定されている場合、Claude Code は組み込みの `gh` を提供せず、セッションには `gh` がありません289* **[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](https://code.claude.com/docs/ja/env-vars)**：セッション環境でこれが設定されている場合、Claude Code は組み込みの `gh` を提供せず、セッションには `gh` がありません

289 290 

290イメージに GitHub CLI が含まれている場合、セッションはそれを使用します。291#### GitHub CLI で GitHub API にアクセスする

292 

293セッションで使用するために GitHub CLI をランナーイメージに含める場合は、[ラッパースクリプト](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#provision-credentials-scoped-to-the-session-creator)で、セッションの作成者用に短期的で最小スコープの `GH_TOKEN` をセッションごとにミントしてください。Claude Code の起動時の `PATH` に `gh` がある場合、セッションはその `gh` を使用し、[組み込みの `gh`](#github-api-access-without-the-github-cli) は提供されません。トークンを使用すると、その `gh` はトークンが付与するアクセス権で、Anthropic 管理の git を経由せずに GitHub に到達するため、[`api.github.com`](#network-requirements) を許可してください。

294 

295Anthropic 管理の git を使用する場合は、イメージに GitHub CLI を含めず、代わりに組み込みの `gh` を使用してください。

291 296 

292#### Anthropic 管理の git でプライベート認証局を信頼する297#### Anthropic 管理の git でプライベート認証局を信頼する

293 298 

343 348 

344ホスト書き直しが最初に実行されるため、両方が必要な場合は `--git-ssh-rewrite` に内部ホスト名をリストします。チェックアウトを完全に制御するには、[`checkout` ライフサイクルフック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#checkout)を使用してください。349ホスト書き直しが最初に実行されるため、両方が必要な場合は `--git-ssh-rewrite` に内部ホスト名をリストします。チェックアウトを完全に制御するには、[`checkout` ライフサイクルフック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#checkout)を使用してください。

345 350 

351### GitHub 以外のリポジトリでセッションを開始する

352 

353GitHub 以外の git ホストにあるリポジトリでセッションを実行するには、そのリポジトリのチェックアウト内で、ターミナルからセッションを開始します。まず、ランナーの git 認証情報、ネットワークと git プロキシ、リポジトリのアドレス、ブランチを確認してください：

354 

355* **Git 認証情報とネットワーク**：ランナーがクローンするアドレスである `https://<host>/<owner>/<name>` に対して、[プロンプトなしで動作する](#git-must-work-without-a-prompt)[認証情報を提供](#ship-git-config-in-your-image)し、[ネットワーク要件](#network-requirements)に記載されているとおり、ランナーが git ホストに到達できるようにしてください。SSH のみを受け入れる git ホストについては、[`--git-ssh-rewrite`](#rewrite-git-urls-for-private-networks) を参照してください。

356* **Git プロキシ**：環境のランナーが Anthropic git プロキシを使用している場合は、[オフにしてください](#turn-the-anthropic-git-proxy-off)。

357* **リポジトリのアドレス**：チェックアウトの `origin` リモートを確認してください。ホストは `git.example.com` のようなドメイン名である必要があり、パスは `<owner>/<name>` の形式である必要があります。`group/subgroup/name` のようなネストされたパスは条件を満たしません。

358* **ブランチ**：ランナーは現在のブランチをクローンするため、そのブランチを git ホストにプッシュしてください。

359 

360チェックアウト内で、[CI から認証する](https://code.claude.com/docs/ja/self-hosted-environments-testing.md#authenticate-from-ci)の説明に従って claude.ai にサインインした状態で、[`--environment`](https://code.claude.com/docs/ja/self-hosted-environments-testing#run-the-test-loop) と環境の `ccpool_...` ID を指定して `claude -p` を実行します：

361 

362```bash theme={null}

363claude -p "Fix the login bug" --environment ccpool_abc123 --output-format json

364```

365 

366セッションが作成されると、コマンドは `{"ok":true` で始まる 1 行の JSON を出力します。`origin` リモートが条件に合わない場合、コマンドは `requires a git source, but no GitHub remote was detected` で失敗します。

367 

368セッションが[プッシュ](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#prompt-sessions-to-push-their-work)したブランチは、git ホスト上でレビューしてマージしてください。

369 

346## ランナーイメージをビルドする370## ランナーイメージをビルドする

347 371 

348Anthropic はビルド済みのランナーイメージを公開していません。`claude` バイナリを中心に独自のイメージをビルドし、リポジトリに必要なツールチェーン（言語ランタイム、コンパイラ、パッケージマネージャー、[MCP](https://code.claude.com/docs/ja/mcp.md) サイドカーなど）を重ねてください。372Anthropic はビルド済みのランナーイメージを公開していません。`claude` バイナリを中心に独自のイメージをビルドし、リポジトリに必要なツールチェーン（言語ランタイム、コンパイラ、パッケージマネージャー、[MCP](https://code.claude.com/docs/ja/mcp.md) サイドカーなど）を重ねてください。

617 641 

618### 再起動の前に実行中のターンを終了させる642### 再起動の前に実行中のターンを終了させる

619 643 

620ローリング再起動の前に実行中のターンを終了させるには、`--drain-wait-sec` を設定し、停止タイムアウトを少なくともその待機時間に 80 秒を加えた値に引き上げてください。デフォルトの待機時間 `0` では、再起動によってまだ実行中のターンが中断され、セッションは[プッシュされていない作業](#additional-limitations)を失った状態で別のランナーで再開されます。644ローリング再起動の前に実行中のターンを終了させるには、`--drain-wait-sec` を設定し、停止タイムアウトを少なくともその待機時間に 80 秒を加えた値に引き上げてください。デフォルトの待機時間 `0` では、再起動によってまだ実行中のターンが中断され、セッションは[プッシュされていない作業](#resumed-sessions-lose-unpushed-work)を失った状態で別のランナーで再開されます。

621 645 

622* **`--drain-wait-sec`**：終了させたいターンとバックグラウンドタスクにかかる時間と同程度に設定します。これは最大値です：それらが先に終了した場合、待機は早めに終わります。646* **`--drain-wait-sec`**：終了させたいターンとバックグラウンドタスクにかかる時間と同程度に設定します。これは最大値です：それらが先に終了した場合、待機は早めに終わります。

623* **停止タイムアウト**：Kubernetes では `terminationGracePeriodSeconds`、Docker Compose では `stop_grace_period` です。例えば `--drain-wait-sec 120` の場合、[Kubernetes](#kubernetes) または [Docker Compose](#docker-compose) のレシピの `90` を `200` に置き換えます。647* **停止タイムアウト**：Kubernetes では `terminationGracePeriodSeconds`、Docker Compose では `stop_grace_period` です。例えば `--drain-wait-sec 120` の場合、[Kubernetes](#kubernetes) または [Docker Compose](#docker-compose) のレシピの `90` を `200` に置き換えます。

735 759 

736アイドル状態のセッションを解放するには、すべてのランナーを [`--release-idle-session-min`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) とその時間（分単位）を指定して起動します（例: `--release-idle-session-min 30`）。ランナーは、スケジュールタスクと人のどちらが開始したかにかかわらず、その時間アイドル状態が続いたセッションを解放します。ただし、[残したプロセスのためにセッションを保持する](#keep-an-idle-session-while-its-processes-run)場合は除きます。760アイドル状態のセッションを解放するには、すべてのランナーを [`--release-idle-session-min`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) とその時間（分単位）を指定して起動します（例: `--release-idle-session-min 30`）。ランナーは、スケジュールタスクと人のどちらが開始したかにかかわらず、その時間アイドル状態が続いたセッションを解放します。ただし、[残したプロセスのためにセッションを保持する](#keep-an-idle-session-while-its-processes-run)場合は除きます。

737 761 

738* **プッシュされていない作業**: 解放されたセッションは次のメッセージで再開されますが、プッシュしていなかった作業は失われます。コミットを保持するには、[再開されたセッションはプッシュされていない作業を失う](#additional-limitations)を参照してください。762* **プッシュされていない作業**: 解放されたセッションは次のメッセージで再開されますが、プッシュしていなかった作業は失われます。コミットを保持するには、[再開されたセッションはプッシュされていない作業を失う](#resumed-sessions-lose-unpushed-work)を参照してください。

739* **ランナーの終了**: 最後のセッションを解放したランナーは[通常の終了](#when-the-runner-exits)を開始します。[デプロイを強化する](#harden-your-deployment)で説明しているように、スーパーバイザーが新しいファイルシステム上でランナーを再起動するようにしてください。763* **ランナーの終了**: 最後のセッションを解放したランナーは[通常の終了](#when-the-runner-exits)を開始します。[デプロイを強化する](#harden-your-deployment)で説明しているように、スーパーバイザーが新しいファイルシステム上でランナーを再起動するようにしてください。

740* **アイドル状態にならないセッション**: [一部のセッションはアイドル状態としてカウントされない](#some-sessions-don’t-count-as-idle)ため、[`--kill-session-after-min`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) も設定します764* **アイドル状態にならないセッション**: [一部のセッションはアイドル状態としてカウントされない](#some-sessions-don’t-count-as-idle)ため、[`--kill-session-after-min`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) も設定します

741 765 

811* ターンがまだ実行中の場合、ランナーはターンが完了するか、セッションが次にユーザーを待つ状態になるまで待ってから、セッションを解放します。835* ターンがまだ実行中の場合、ランナーはターンが完了するか、セッションが次にユーザーを待つ状態になるまで待ってから、セッションを解放します。

812* 猶予期間が終了した時点でセッションがまだランナー上にある場合、ランナーはセッションを終了し、実行中のターンの作業は失われます。実行中のツール呼び出しの内部から要求された承認をターンが待っている場合は、セッションが猶予期間を超えて残る一例です。836* 猶予期間が終了した時点でセッションがまだランナー上にある場合、ランナーはセッションを終了し、実行中のターンの作業は失われます。実行中のツール呼び出しの内部から要求された承認をターンが待っている場合は、セッションが猶予期間を超えて残る一例です。

813 837 

814解放されたセッションは新しいクローンから再開されるため、いずれの場合もプッシュしていなかった作業は失われます。[再開されたセッションではプッシュしていない作業が失われる](#additional-limitations)を参照してください。v2.1.260 より前では、ランナーは実行中のターンの完了を最大で猶予期間だけ待った後、上限に達したすべてのセッションを終了していました。838解放されたセッションは新しいクローンから再開されるため、いずれの場合もプッシュしていなかった作業は失われます。[再開されたセッションではプッシュしていない作業が失われる](#resumed-sessions-lose-unpushed-work)を参照してください。v2.1.260 より前では、ランナーは実行中のターンの完了を最大で猶予期間だけ待った後、上限に達したすべてのセッションを終了していました。

815 839 

816このフラグは、想定される最長のセッションよりも長い値に設定してください。たとえば 8 時間の場合は `--kill-session-after-min 480` とします。アイドル状態になった会話からスロットを解放するには、代わりに `--release-idle-session-min` を使用してください。840このフラグは、想定される最長のセッションよりも長い値に設定してください。たとえば 8 時間の場合は `--kill-session-after-min 480` とします。アイドル状態になった会話からスロットを解放するには、代わりに `--release-idle-session-min` を使用してください。

817 841 

842### 再開されたセッションではプッシュしていない作業が失われる

843 

844新しいランナーで再開されたセッションでは、プッシュしていなかった作業が失われます。そのランナーがリポジトリを開始ブランチから再度クローンするためです。

845 

846コミット済みの作業を保持するには、環境内のすべてのランナーで [`--push-outcome-on-release`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) を設定してください。このフラグを設定したランナーは、解放する前にセッションの成果ブランチのプッシュをベストエフォートで行い、再開されたセッションはそれらのコミットから開始されます。このフラグのないランナーは、セッションを開始ブランチから再開します。プッシュにはランナーホスト自身の git 認証情報が使用されます。これは [Anthropic 管理の git](#use-the-anthropic-git-proxy) を使用するランナーでも同様です。

847 

848> [!WARNING]

849>

850> このフラグを設定する前に、ソースリモート上の `claude/*` ref にプッシュできるユーザーを制限してください。再開時、ランナーは以前にプッシュされたブランチを、誰がプッシュしたかを検証せずにフェッチします。

851 

852フラグを設定していても、次の作業は別の方法で保存してください。

853 

854* **コミットされていない変更**: これらは引き続き失われます。[セッションに作業のプッシュを促す](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#prompt-sessions-to-push-their-work)を参照してください。

855* **[`checkout` ライフサイクルフック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#checkout)でチェックアウトされたリポジトリ**: これらはプッシュされません。[`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)からスナップショットを取得してください。

856* **誰かがアーカイブまたは削除したセッション、またはセッションのメニューからランナーが解放されたセッションのコミット**: フラグによるプッシュは当てにしないでください。これらを保存するには、[`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)から `HEAD` を退避用ブランチにプッシュしてください。そこにある例はスナップショットのコミットを作成した後にのみプッシュするため、コミットされていない変更が何もないときでもプッシュするようにしてください。

857 

818### その他の制限事項858### その他の制限事項

819 859 

820* **再開されたセッションではプッシュしていない作業が失われる**: 新しいランナーはリポジトリを開始ブランチから再度クローンするため、セッションがプッシュしていなかった作業は失われます。

821 * **コミット済みの作業を保持するには**: 環境内のすべてのランナーで [`--push-outcome-on-release`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) を設定してください。このフラグのないランナーは、セッションを開始ブランチから再開するためです。このフラグを設定したランナーは、解放する前にセッションの成果ブランチのプッシュをベストエフォートで行い、再開されたセッションはそれらのコミットから開始されます。プッシュにはランナーホスト自身の git 認証情報が使用されます。これは [Anthropic 管理の git](#use-the-anthropic-git-proxy) を使用するランナーでも同様です。

822 * **`checkout` フックを使用する場合**: [`checkout` ライフサイクルフック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#checkout)でチェックアウトされたリポジトリはプッシュされません。代わりに [`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)からそれらのスナップショットを取得してください。

823 * **フラグを有効にする前に**: ソースリモート上の `claude/*` ref にプッシュできるユーザーを制限してください。再開時、ランナーは以前にプッシュされたブランチを、誰がプッシュしたかを検証せずにフェッチします。

824 * **コミットされていない変更は引き続き失われる**: Claude が応答を終えたときにコミットとプッシュを行うよう促すには、[セッションに作業のプッシュを促す](https://code.claude.com/docs/ja/self-hosted-environments-configuration.md#prompt-sessions-to-push-their-work)を参照してください。

825* **ランナーの喪失によって中断されたコマンドが再度実行されることがある**: セッションが別のランナーで再開されると、中断されたツール呼び出しが、その成否が不明であることを示す結果とともに Claude に表示されます。860* **ランナーの喪失によって中断されたコマンドが再度実行されることがある**: セッションが別のランナーで再開されると、中断されたツール呼び出しが、その成否が不明であることを示す結果とともに Claude に表示されます。

826* **セッションの途中で追加したリポジトリのクローンが失敗することがある**: Claude は HTTPS 経由の `git clone` でリポジトリをクローンします。[`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) を使用していないランナーでは、ホスト上にリポジトリを読み取れるものが何もない場合、クローンは git の認証エラーで失敗します。可能であれば、セッションの作成時に、セッションで必要なすべてのリポジトリを選択してください。861* **セッションの途中で追加したリポジトリのクローンが失敗することがある**: Claude は HTTPS 経由の `git clone` でリポジトリをクローンします。[`--use-anthropic-git-proxy`](#use-the-anthropic-git-proxy) を使用していないランナーでは、ホスト上にリポジトリを読み取れるものが何もない場合、クローンは git の認証エラーで失敗します。可能であれば、セッションの作成時に、セッションで必要なすべてのリポジトリを選択してください。

827 * **セッションが再開されるとき**: 追加したリポジトリに対しても [`checkout` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#checkout)が実行され、その際 [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/ja/self-hosted-environments-configuration#checkout) は空になります。フックでこれを処理できるようにしてください。862 * **セッションが再開されるとき**: 追加したリポジトリに対しても [`checkout` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#checkout)が実行され、その際 [`CLAUDE_RUNNER_REPO_REF`](https://code.claude.com/docs/ja/self-hosted-environments-configuration#checkout) は空になります。フックでこれを処理できるようにしてください。

828* **一部のコネクタがセルフホストセッションに表示されない**: claude.ai の設定でまだ接続していないコネクタはセルフホストセッションに表示されず、セッションから接続を求められることもありません。まず設定で接続してから、新しいセッションを開始してください。また、すでに実行中のセッションにコネクタを追加しても、そのツールは Claude で使用できるようになりません。新しく追加したコネクタを反映するには、新しいセッションを開始してください。863* **一部のコネクタがセルフホストセッションに表示されない**: claude.ai の設定でまだ接続していないコネクタはセルフホストセッションに表示されず、セッションから接続を求められることもありません。まず設定で接続してから、新しいセッションを開始してください。また、すでに実行中のセッションにコネクタを追加しても、そのツールは Claude で使用できるようになりません。新しく追加したコネクタを反映するには、新しいセッションを開始してください。

829* **誰かがセッションをアーカイブまたは削除した場合、またはセッションのメニューからランナーを解放した場合**: [`--push-outcome-on-release`](https://code.claude.com/docs/ja/self-hosted-environments-reference#runner-cli-flags) によるプッシュは当てにしないでください。このような場合にコミットを保存するには、[`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)から `HEAD` を退避用ブランチにプッシュしてください。そこにある例をもとにする場合は、コミットされていない変更が何もないときでもプッシュするように変更してください。この例はスナップショットのコミットを作成した後にのみプッシュするためです。

830 864 

831### 問題を報告する865### 問題を報告する

832 866 

84 84 

85**7. ID を読む**85**7. ID を読む**

86 86 

87作成ユーザーの ID は `act` クレームにあります。`act.sub` はプレフィックス形式 `user:<id>` の Anthropic ユーザー ID で、`act.email` は作成サーフェスが記録した場合、メールアドレスです。組織のサービス ID が作成するセッション（Claude Tag チャネルセッションを含む）は代わりに `agent:` サブジェクトを持つため、ID クレームが存在しないかどうかをテストするのではなく、`act.sub` が `user:` プレフィックスを持つ場合にのみセッションをユーザー作成として扱います。完全な構造とフラット重複クレームについては、[クレームリファレンス](#claims-reference)を参照してください。87作成ユーザーの ID は `act` クレームにあります。`act.sub` はプレフィックス形式 `user:<id>` の Anthropic ユーザー ID で、`act.email` は作成サーフェスが記録した場合、メールアドレスです。組織のサービス ID が作成するセッションは代わりに `agent:` サブジェクトを持ちます。ID クレームが存在しないかどうかをテストするのではなく、`act.sub` が `user:` プレフィックスを持つ場合にのみセッションをユーザー作成として扱います。

88 

89完全な構造とフラット重複クレームについては、[クレームリファレンス](#claims-reference)を参照してください。

88 90 

89チェックは標準 JWT ライブラリに直接マップされます。以下の例は、JWKS フェッチ、キャッシング、および `kid` 選択を処理する [`jose`](https://www.npmjs.com/package/jose) を使用した Node.js での完全なシーケンスと、[`PyJWT`](https://pyjwt.readthedocs.io/) とその組み込み JWKS クライアントを使用した Python で実装しています。91チェックは標準 JWT ライブラリに直接マップされます。以下の例は、JWKS フェッチ、キャッシング、および `kid` 選択を処理する [`jose`](https://www.npmjs.com/package/jose) を使用した Node.js での完全なシーケンスと、[`PyJWT`](https://pyjwt.readthedocs.io/) とその組み込み JWKS クライアントを使用した Python で実装しています。

90 92 

185 187 

186## クレームリファレンス188## クレームリファレンス

187 189 

188以下の表は、検証に関連するセッショントークンクレームをリストしています。`ccr:*` 名前空間と `act` チェーンから ID を読み取ります。フラット `account_email`、`organization_uuid`、および `account_uuid` クレームは、削除される可能性のある後方互換性の重複です。組織のサービス ID が作成するセッション（Claude Tag チャネルセッションを含む）は、`act.sub` に `agent:` サブジェクトを持ち、`act.email`、`ccr:account_id`、`account_email`、および `account_uuid` を省略します。2 つのメールクレームはユーザー作成セッションでもオプションです。Anthropic はセッション作成時にそれらを記録するのは、作成リクエストの認証情報がメールを持つ場合のみで、CLI からディスパッチされたセッションは両方を欠く可能性があるため、メールではなく `act.sub` または `ccr:account_id` で ID をキーにします。トークンはこのテーブルを超えて追加のクレームを持つこともできます。認識しないクレームは無視します。190`ccr:*` 名前空間と `act` チェーンから ID を読み取ります。フラット `account_email`、`organization_uuid`、および `account_uuid` クレームは、削除される可能性のある後方互換性の重複です。組織のサービス ID が作成するセッションは、`act.sub` に `agent:` サブジェクトを持ち、`act.email`、`ccr:account_id`、`account_email`、および `account_uuid` を省略します。

191 

1922 つのメールクレームはユーザー作成セッションでもオプションです。Anthropic がセッション作成時にそれらを記録するのは、作成リクエストの認証情報がメールを持つ場合のみであり、CLI からディスパッチされたセッションは両方を欠く可能性があります。メールではなく `act.sub` または `ccr:account_id` で ID をキーにします。トークンはこのテーブルを超えて追加のクレームを持つこともできます。認識しないクレームは無視します。以下の表は、検証に関連するセッショントークンクレームをリストしています。

189 193 

190| クレーム | 型 | 説明 |194| クレーム | 型 | 説明 |

191| :- | :- | :- |195| :- | :- | :- |

211 215 

212| パス | 説明 |216| パス | 説明 |

213| :- | :- |217| :- | :- |

214| `act.sub` | 作成ユーザーの Anthropic ユーザー ID（`user:<id>` の形式）、または組織のサービス ID がセッションを作成した場合は `agent:<id>`（Claude Tag チャネルセッションの場合）。 |218| `act.sub` | 作成ユーザーの Anthropic ユーザー ID（`user:<id>` の形式）、または組織のサービス ID がセッションを作成した場合は `agent:<id>`。 |

215| `act.email` | 作成ユーザーのメールアドレス（セッション作成時に記録された場合）。それを要求しないでください。`act.sub` でキーにします。 |219| `act.email` | 作成ユーザーのメールアドレス（セッション作成時に記録された場合）。それを要求しないでください。`act.sub` でキーにします。 |

216| `act.attested_by` | 作成ユーザーに対するアップストリーム ID プロバイダーの証明のために予約されています。存在しないものと想定し、これに依存しないでください。`act.sub` でキーにします。アドレスが必要な場合は、`act.email` が存在するときにそれを読み取ります。 |220| `act.attested_by` | 作成ユーザーに対するアップストリーム ID プロバイダーの証明のために予約されています。存在しないものと想定し、これに依存しないでください。`act.sub` でキーにします。アドレスが必要な場合は、`act.email` が存在するときにそれを読み取ります。 |

217| `act.act` | セッションを生成したランナー。`act.act.sub` は `ccr:runner:<runner_id>`。 |221| `act.act` | セッションを生成したランナー。`act.act.sub` は `ccr:runner:<runner_id>`。 |

48| `--post-session-hook-timeout-sec <n>` | `SELF_HOSTED_RUNNER_POST_SESSION_HOOK_TIMEOUT_MS` | `60` | ランナーのシャットダウンを含む、すべてのセッション終了時の [`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)に割り当てる時間 |48| `--post-session-hook-timeout-sec <n>` | `SELF_HOSTED_RUNNER_POST_SESSION_HOOK_TIMEOUT_MS` | `60` | ランナーのシャットダウンを含む、すべてのセッション終了時の [`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)に割り当てる時間 |

49| `--proxy-authorization-command <command>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_COMMAND` | 未設定 | エグレスプロキシへの接続ごとにランナーが実行するシェルコマンド。前後の空白を除去した stdout を `Proxy-Authorization` ヘッダーの値として使用します。`HTTPS_PROXY` または `HTTP_PROXY` が必要で、`--proxy-authorization-file` と組み合わせることはできません。[エグレスプロキシに認証する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy)を参照してください。Claude Code v2.1.238 以降が必要です。 |49| `--proxy-authorization-command <command>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_COMMAND` | 未設定 | エグレスプロキシへの接続ごとにランナーが実行するシェルコマンド。前後の空白を除去した stdout を `Proxy-Authorization` ヘッダーの値として使用します。`HTTPS_PROXY` または `HTTP_PROXY` が必要で、`--proxy-authorization-file` と組み合わせることはできません。[エグレスプロキシに認証する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy)を参照してください。Claude Code v2.1.238 以降が必要です。 |

50| `--proxy-authorization-file <path>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_FILE` | 未設定 | エグレスプロキシへの接続ごとにランナーが読み取るファイル。前後の空白を除去した内容を `Proxy-Authorization` ヘッダーの値として使用します。別のプロセスがその場でローテーションするトークンには、このフラグを使用してください。`--proxy-authorization-command` と同じ要件があり、それと組み合わせることはできません。[エグレスプロキシに認証する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy)を参照してください。Claude Code v2.1.238 以降が必要です。 |50| `--proxy-authorization-file <path>` | `SELF_HOSTED_RUNNER_PROXY_AUTHORIZATION_FILE` | 未設定 | エグレスプロキシへの接続ごとにランナーが読み取るファイル。前後の空白を除去した内容を `Proxy-Authorization` ヘッダーの値として使用します。別のプロセスがその場でローテーションするトークンには、このフラグを使用してください。`--proxy-authorization-command` と同じ要件があり、それと組み合わせることはできません。[エグレスプロキシに認証する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#authenticate-to-an-egress-proxy)を参照してください。Claude Code v2.1.238 以降が必要です。 |

51| `--push-outcome-on-release` | `SELF_HOSTED_RUNNER_PUSH_OUTCOME_ON_RELEASE` | オフ | ドレインやアイドル解放など、ランナー主導でセッションが終了する際に、ワークスペースを削除する前に追跡中の成果ブランチを `origin` にプッシュし、進行中のコミットが再起動後も失われないようにします。ベストエフォートで行われます。シャットダウンの時間枠に 30 秒が追加され、プッシュされたブランチから再開するには git 2.29 以降が必要です。有効にする前に、プッシュアクセスを `claude/*` の ref に制限してください。[再開されたセッションではプッシュされていない作業が失われる](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#additional-limitations)を参照してください。`checkout` ライフサイクルフックでチェックアウトされたリポジトリはプッシュされません。それらについては、代わりに [`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)からスナップショットを取得してください。 |51| `--push-outcome-on-release` | `SELF_HOSTED_RUNNER_PUSH_OUTCOME_ON_RELEASE` | オフ | ドレインやアイドル解放など、ランナー主導でセッションが終了する際に、ランナーはワークスペースを削除する前に、新しいコミットを含むプライマリセッションブランチを `origin` にプッシュします。ベストエフォートで行われ、シャットダウンの時間枠に 30 秒が追加されます。プッシュされたブランチから再開するには git 2.29 以降が必要です。プッシュアクセスを `claude/*` の ref に制限してください。[再開されたセッションではプッシュされていない作業が失われる](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#resumed-sessions-lose-unpushed-work)を参照してください。`checkout` フックのリポジトリはプッシュされません。それらについては [`post-session` フック](https://code.claude.com/docs/ja/self-hosted-environments-configuration#post-session)からスナップショットを取得してください。 |

52| `--release-idle-session-min <n>` | `SELF_HOSTED_RUNNER_SESSION_IDLE_MS` | `0` | ターンが終了するか、セッションがユーザーのアクションを待つ状態になった後、N 分間操作がなければセッションスロットを解放します。[アイドルとしてカウントされないセッションがある](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#some-sessions-don’t-count-as-idle)ため、`--kill-session-after-min` と組み合わせてください。完了したバックグラウンドタスクは、最大 [`SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS`](#environment-variable-only-settings) の期間、セッションをビジー状態に保ちます。解放を遅らせるには、[`--hold-idle-file`](https://code.claude.com/docs/ja/self-hosted-environments-deploy#keep-an-idle-session-while-its-processes-run) を設定してください。`0` で無効になります。 |52| `--release-idle-session-min <n>` | `SELF_HOSTED_RUNNER_SESSION_IDLE_MS` | `0` | ターンが終了するか、セッションがユーザーのアクションを待つ状態になった後、N 分間操作がなければセッションスロットを解放します。[アイドルとしてカウントされないセッションがある](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#some-sessions-don’t-count-as-idle)ため、`--kill-session-after-min` と組み合わせてください。完了したバックグラウンドタスクは、最大 [`SELF_HOSTED_RUNNER_BG_RESULT_GRACE_MS`](#environment-variable-only-settings) の期間、セッションをビジー状態に保ちます。解放を遅らせるには、[`--hold-idle-file`](https://code.claude.com/docs/ja/self-hosted-environments-deploy#keep-an-idle-session-while-its-processes-run) を設定してください。`0` で無効になります。 |

53| `--remove-session-state [bool]` | `SELF_HOSTED_RUNNER_REMOVE_SESSION_STATE` | オフ | このランナー上でセッションが終了したとき、結果にかかわらず、`<base-dir>/_sessions/` 配下のセッションごとのディレクトリを削除します。これらのディレクトリに何が保存され、残った場合に誰が読み取れるかについては、[事前ウォームアップされたチェックアウトを再利用する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)で説明しています。削除はベストエフォートで行われます。クリーンアップが実行される前にランナーが強制終了されたり、ドレインの期限に達したりした場合、セッションごとのディレクトリはそのまま残ります。このフラグをオンにすると、失敗または中断されたセッションのデバッグログはディスクに保持されません。Claude Code v2.1.268 以降が必要です。 |53| `--remove-session-state [bool]` | `SELF_HOSTED_RUNNER_REMOVE_SESSION_STATE` | オフ | このランナー上でセッションが終了したとき、結果にかかわらず、`<base-dir>/_sessions/` 配下のセッションごとのディレクトリを削除します。これらのディレクトリに何が保存され、残った場合に誰が読み取れるかについては、[事前ウォームアップされたチェックアウトを再利用する](https://code.claude.com/docs/ja/self-hosted-environments-deploy.md#reuse-a-pre-warmed-checkout)で説明しています。削除はベストエフォートで行われます。クリーンアップが実行される前にランナーが強制終了されたり、ドレインの期限に達したりした場合、セッションごとのディレクトリはそのまま残ります。このフラグをオンにすると、失敗または中断されたセッションのデバッグログはディスクに保持されません。Claude Code v2.1.268 以降が必要です。 |

54| `--retire-at <epoch-seconds>` | `SELF_HOSTED_RUNNER_RETIRE_AT` | 未設定 | 既知の時刻にランナーを強制終了するインフラ向けに、秒単位の絶対 Unix タイムスタンプでランナーを退役させます。解放の手順とマージンの見積もり方については、[ランナーのライフサイクル](https://code.claude.com/docs/ja/self-hosted-environments#runner-lifecycle)で説明しています。2001 年より前または 5138 年より後の値は、フラグでは拒否され、環境変数では無視されます。 |54| `--retire-at <epoch-seconds>` | `SELF_HOSTED_RUNNER_RETIRE_AT` | 未設定 | 既知の時刻にランナーを強制終了するインフラ向けに、秒単位の絶対 Unix タイムスタンプでランナーを退役させます。解放の手順とマージンの見積もり方については、[ランナーのライフサイクル](https://code.claude.com/docs/ja/self-hosted-environments#runner-lifecycle)で説明しています。2001 年より前または 5138 年より後の値は、フラグでは拒否され、環境変数では無視されます。 |

4846 4846 

4847### `disableDeepLinkRegistration`4847### `disableDeepLinkRegistration`

4848 4848 

4849Claude Code が `claude-cli://` プロトコルハンドラーをオペレーティングシステムに登録することを停止します。通常、対話セッションの最初のプロンプトを送信した後に登録されます。[Deep links](https://code.claude.com/docs/ja/deep-links.md) により、外部ツールは事前入力されたプロンプトで Claude Code セッションを開くことができます。プロトコルハンドラー登録が制限されているか、別途管理されている環境でこれを設定します。4849Claude Code が `claude-cli://` プロトコルハンドラーをオペレーティングシステムに登録することを停止します。[Deep links](https://code.claude.com/docs/ja/deep-links.md) により、外部ツールは事前入力されたプロンプトで Claude Code セッションを開くことができます。プロトコルハンドラー登録が制限されているか、別途管理されている環境でこれを設定します。

4850 4850 

4851* **Scope**: [`Any file`](#scopes)4851* **Scope**: [`Any file`](#scopes)

4852* **Type**: 文字列 `"disable"`4852* **Type**: 文字列 `"disable"`

5801 5801 

5802[Chrome 統合](https://code.claude.com/docs/ja/chrome.md)をオンにして、毎回 `--chrome` を渡さずにすべてのインタラクティブ CLI セッションを開始します。[`claude remote-control`](https://code.claude.com/docs/ja/remote-control) を実行する場合、[プロジェクト](https://code.claude.com/docs/ja/claude-projects.md)スレッドの 1 つに対して開始するセッションもこのキーに従います。ただし、`bypassPermissions` モードの場合は除きます。Claude Code v2.1.287 以降では、このキーは [VS Code 拡張機能](https://code.claude.com/docs/ja/vs-code.md#automate-browser-tasks-with-chrome)のセッションにも適用されます。詳しくは [Chrome をデフォルトで有効にする](https://code.claude.com/docs/ja/chrome.md#enable-chrome-by-default)を参照してください。5802[Chrome 統合](https://code.claude.com/docs/ja/chrome.md)をオンにして、毎回 `--chrome` を渡さずにすべてのインタラクティブ CLI セッションを開始します。[`claude remote-control`](https://code.claude.com/docs/ja/remote-control) を実行する場合、[プロジェクト](https://code.claude.com/docs/ja/claude-projects.md)スレッドの 1 つに対して開始するセッションもこのキーに従います。ただし、`bypassPermissions` モードの場合は除きます。Claude Code v2.1.287 以降では、このキーは [VS Code 拡張機能](https://code.claude.com/docs/ja/vs-code.md#automate-browser-tasks-with-chrome)のセッションにも適用されます。詳しくは [Chrome をデフォルトで有効にする](https://code.claude.com/docs/ja/chrome.md#enable-chrome-by-default)を参照してください。

5803 5803 

5804`/chrome` を実行して **Enabled by default** を選択すると、このキーが設定されます。`/config` に **Claude in Chrome enabled by default** として表示されます。5804`/chrome` を実行して **Enabled by default** を選択すると、このキーが設定されます。[「Claude in Chrome extension detected」ダイアログ](https://code.claude.com/docs/ja/chrome.md#answer-the-startup-dialog)に応答した場合も同様です。`/config` に **Claude in Chrome enabled by default** として表示されます。

5805 5805 

5806* **スコープ**: [`グローバル設定`](#scopes)5806* **スコープ**: [`グローバル設定`](#scopes)

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

39 39 

40**macOS、Linux、WSL：**40**macOS、Linux、WSL：**

41 41 

42```bash theme={null}42```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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

43curl -fsSL https://claude.ai/install.sh | bash43curl -fsSL https://claude.ai/install.sh | bash

44```44```

45 45 

47 47 

48**Windows PowerShell：**48**Windows PowerShell：**

49 49 

50```powershell theme={null}50```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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

51irm https://claude.ai/install.ps1 | iex51irm https://claude.ai/install.ps1 | iex

52```52```

53 53 

54**Windows CMD：**54**Windows CMD：**

55 55 

56```batch theme={null}56```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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

57curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd57curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

58```58```

59 59 

71 71 

72**Homebrew**72**Homebrew**

73 73 

74```bash theme={null}74```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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

75brew install --cask claude-code75brew install --cask claude-code

76```76```

77 77 

83 83 

84**WinGet**84**WinGet**

85 85 

86```powershell theme={null}86```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} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null} theme={null}

87winget install Anthropic.ClaudeCode87winget install Anthropic.ClaudeCode

88```88```

89 89 

458 458 

459### npm でのインストール459### npm でのインストール

460 460 

461> [!NOTE]

462>

463> シェルで `npm --version` が `12` から始まるバージョンを出力する場合は、代わりに [npm 12 でのインストールを修正する](https://code.claude.com/docs/ja/troubleshoot-install.md#fix-an-npm-12-install)の手順に従ってください。`sudo` でインストールしないでください。Claude Code は自身を更新する際に `sudo` なしで npm を実行するため、`sudo` を必要とするインストールは自動更新できません。

464 

461Claude Code をグローバル npm パッケージとしてインストールすることもできます。npm パッケージには [Node.js 22 以上](https://nodejs.org/en/download)が必要です。古い Node.js バージョンでは、npm はインストール中に失敗するのではなく `EBADENGINE` 警告を出力します。インストールは完了し、パッケージがランタイムで Node.js を使用しないネイティブバイナリをダウンロードするため、`claude` は引き続き実行されます。465Claude Code をグローバル npm パッケージとしてインストールすることもできます。npm パッケージには [Node.js 22 以上](https://nodejs.org/en/download)が必要です。古い Node.js バージョンでは、npm はインストール中に失敗するのではなく `EBADENGINE` 警告を出力します。インストールは完了し、パッケージがランタイムで Node.js を使用しないネイティブバイナリをダウンロードするため、`claude` は引き続き実行されます。

462 466 

463```bash theme={null}467```bash theme={null}

404| `allowed-tools` | いいえ | このスキルを呼び出したターンの間、Claude が権限を求めずに使用できるツール。この付与は次のメッセージを送信するとクリアされます。スペース区切りまたはカンマ区切りの文字列、あるいは YAML リストを受け付けます。[スキルのツールを事前承認する](#pre-approve-tools-for-a-skill)を参照してください。 |404| `allowed-tools` | いいえ | このスキルを呼び出したターンの間、Claude が権限を求めずに使用できるツール。この付与は次のメッセージを送信するとクリアされます。スペース区切りまたはカンマ区切りの文字列、あるいは YAML リストを受け付けます。[スキルのツールを事前承認する](#pre-approve-tools-for-a-skill)を参照してください。 |

405| `disallowed-tools` | いいえ | このスキルがアクティブな間、Claude が使用可能なツールから除外されるツール。バックグラウンドループにおける `AskUserQuestion` など、特定のツールを決して呼び出すべきではない自律型スキルに使用します。スペース区切りまたはカンマ区切りの文字列、あるいは YAML リストを受け付けます。この制限は次のメッセージを送信するとクリアされます。拒否ルールと同様に、他のツールが残っている間はこのフィールドで [`EndConversation`](https://code.claude.com/docs/ja/tools-reference#endconversation-tool-behavior) を除外することはできません。 |405| `disallowed-tools` | いいえ | このスキルがアクティブな間、Claude が使用可能なツールから除外されるツール。バックグラウンドループにおける `AskUserQuestion` など、特定のツールを決して呼び出すべきではない自律型スキルに使用します。スペース区切りまたはカンマ区切りの文字列、あるいは YAML リストを受け付けます。この制限は次のメッセージを送信するとクリアされます。拒否ルールと同様に、他のツールが残っている間はこのフィールドで [`EndConversation`](https://code.claude.com/docs/ja/tools-reference#endconversation-tool-behavior) を除外することはできません。 |

406| `model` | いいえ | このスキルがアクティブなときに使用するモデル。この上書きは現在のターンの残りの間に適用され、設定には保存されません。次のプロンプトを送信すると、セッションのモデルに戻ります。[`/model`](https://code.claude.com/docs/ja/model-config) と同じ値、またはアクティブなモデルを維持する `inherit` を受け付けます。組織の [`availableModels`](https://code.claude.com/docs/ja/model-config#restrict-model-selection) 許可リストで除外されている値は使用されず、セッションは現在のモデルを維持します。[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)、および[分類器がコマンドをレビューしている間の plan モード](https://code.claude.com/docs/ja/permission-modes.md#analyze-before-you-edit-with-plan-mode)では、auto モードがサポートしていないモデルも使用されず、セッションは現在のモデルを維持します。`context: fork` の場合、この値は代わりに[フォークされたサブエージェントのモデル](#run-skills-in-a-subagent)を設定し、除外された値は[サブエージェントのモデル上書きと同じルール](https://code.claude.com/docs/ja/model-config.md#restrict-model-selection)に従います。 |406| `model` | いいえ | このスキルがアクティブなときに使用するモデル。この上書きは現在のターンの残りの間に適用され、設定には保存されません。次のプロンプトを送信すると、セッションのモデルに戻ります。[`/model`](https://code.claude.com/docs/ja/model-config) と同じ値、またはアクティブなモデルを維持する `inherit` を受け付けます。組織の [`availableModels`](https://code.claude.com/docs/ja/model-config#restrict-model-selection) 許可リストで除外されている値は使用されず、セッションは現在のモデルを維持します。[auto モード](https://code.claude.com/docs/ja/permission-modes.md#eliminate-prompts-with-auto-mode)、および[分類器がコマンドをレビューしている間の plan モード](https://code.claude.com/docs/ja/permission-modes.md#analyze-before-you-edit-with-plan-mode)では、auto モードがサポートしていないモデルも使用されず、セッションは現在のモデルを維持します。`context: fork` の場合、この値は代わりに[フォークされたサブエージェントのモデル](#run-skills-in-a-subagent)を設定し、除外された値は[サブエージェントのモデル上書きと同じルール](https://code.claude.com/docs/ja/model-config.md#restrict-model-selection)に従います。 |

407| `effort` | いいえ | このスキルがアクティブなときの [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)。セッションの effort レベルを上書きします。省略した場合、レベルは [effort の解決順序](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)によって決まります。オプション：`low`、`medium`、`high`、`xhigh`、`max`。使用可能なレベルはモデルによって異なります。 |407| `effort` | いいえ | 現在のターンの残りの間の [effort レベル](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)。セッションの effort レベルを上書きしますが、[`CLAUDE_CODE_EFFORT_LEVEL`](https://code.claude.com/docs/ja/env-vars#variables) 環境変数は上書きしません。`context: fork` の場合、この値は代わりにフォークされたサブエージェントの effort レベルを設定します。省略した場合、レベルは [effort の解決順序](https://code.claude.com/docs/ja/model-config.md#adjust-effort-level)によって決まります。オプション：`low`、`medium`、`high`、`xhigh`、`max`。使用可能なレベルはモデルによって異なります。 |

408| `context` | いいえ | `fork` に設定すると、フォークされたサブエージェントコンテキストで実行されます。[サブエージェントでスキルを実行する](#run-skills-in-a-subagent)を参照してください。 |408| `context` | いいえ | `fork` に設定すると、フォークされたサブエージェントコンテキストで実行されます。[サブエージェントでスキルを実行する](#run-skills-in-a-subagent)を参照してください。 |

409| `agent` | いいえ | `context: fork` が設定されている場合に使用するサブエージェントの種類。 |409| `agent` | いいえ | `context: fork` が設定されている場合に使用するサブエージェントの種類。 |

410| `background` | いいえ | `context: fork` の場合にのみ適用されます。`false` に設定すると、[バックグラウンドで実行する](#run-skills-in-a-subagent)代わりに、スキルを呼び出したターンでフォークされたサブエージェントの結果を待ちます。デフォルト：`true`。 |410| `background` | いいえ | `context: fork` の場合にのみ適用されます。`false` に設定すると、[バックグラウンドで実行する](#run-skills-in-a-subagent)代わりに、スキルを呼び出したターンでフォークされたサブエージェントの結果を待ちます。デフォルト：`true`。 |

200 200 

201### Claude Tag チャンネルからのセッションが開始に失敗する201### Claude Tag チャンネルからのセッションが開始に失敗する

202 202 

203このエントリは [Claude Tag](https://claude.com/docs/claude-tag/overview) を使用しているワークスペースに適用されます。Claude Tag では、Claude はメンバーのアカウントではなく、組織の共有 ID としてチャンネルで機能します。[claude.ai/code](https://claude.ai/code) でチャンネルのクラウド環境を作成した場合、それは個人アカウントに属しており、Claude は個人環境でチャンネルセッションを開始できません。Claude Code はセッションを直ちに失敗させ、再試行しても役に立ちません。203このエントリは [Claude Tag](https://claude.com/docs/claude-tag/overview) を使用しているワークスペースに適用されます。[claude.ai/code](https://claude.ai/code) でチャンネルのクラウド環境を作成した場合、それは個人アカウントに属しており、Claude は個人環境でチャンネルセッションを開始できません。Claude Code はセッションを直ちに失敗させ、再試行しても役に立ちません。

204 204 

205Owner であり、環境が自分のものである場合は、環境セレクターから[組織と共有](https://code.claude.com/docs/ja/cloud-environments.md#organization-shared-environments)してください。それ以外の場合は、Owner が[管理設定](https://claude.ai/admin-settings)の **Cloud environments** ページから組織共有環境として再作成します。205Owner であり、環境が自分のものである場合は、環境セレクターから[組織と共有](https://code.claude.com/docs/ja/cloud-environments.md#organization-shared-environments)してください。それ以外の場合は、Owner が[管理設定](https://claude.ai/admin-settings)の **Cloud environments** ページから組織共有環境として再作成します。

206 206 

188| `context_window.current_usage` | 最後の API 呼び出しからのトークン数。[コンテキストウィンドウのフィールド](#context-window-fields)で説明しています |188| `context_window.current_usage` | 最後の API 呼び出しからのトークン数。[コンテキストウィンドウのフィールド](#context-window-fields)で説明しています |

189| `exceeds_200k_tokens` | 直近の API レスポンスからの合計トークン数（入力、キャッシュ、出力トークンの合計）が 200k を超えているかどうか。これは実際のコンテキストウィンドウサイズに関係なく固定されたしきい値です。 |189| `exceeds_200k_tokens` | 直近の API レスポンスからの合計トークン数（入力、キャッシュ、出力トークンの合計）が 200k を超えているかどうか。これは実際のコンテキストウィンドウサイズに関係なく固定されたしきい値です。 |

190| `fast_mode` | セッションで [fast mode](https://code.claude.com/docs/ja/fast-mode.md) が有効かどうか |190| `fast_mode` | セッションで [fast mode](https://code.claude.com/docs/ja/fast-mode.md) が有効かどうか |

191| `effort.level` | 現在の推論エフォート（`low`、`medium`、`high`、`xhigh`、または `max`）。セッション途中の `/effort` による変更を含め、セッションの現在の値を反映します。現在のモデルが effort パラメータをサポートしていない場合は存在しません |191| `effort.level` | セッションに設定された推論 effort レベル（`low`、`medium`、`high`、`xhigh`、または `max`）。スキル、サブエージェント、または `ultrathink` が設定したレベルではありません。モデルがサポートしていないレベルを設定した場合は、代わりに Claude Code が実行したレベルが表示されます。変更したレベルは、それが[開始](https://code.claude.com/docs/ja/model-config.md#when-a-new-effort-level-starts)される前でもここに表示されます。`CLAUDE_CODE_EFFORT_LEVEL` でレベルを指定している場合は、そのレベルが表示されます。現在のモデルが effort パラメータをサポートしていない場合は存在しません |

192| `thinking.enabled` | セッションで拡張思考が有効かどうか |192| `thinking.enabled` | セッションで拡張思考が有効かどうか |

193| `rate_limits.five_hour.used_percentage`, `rate_limits.seven_day.used_percentage` | 5 時間または 7 日間のレート制限の消費率（0 から 100） |193| `rate_limits.five_hour.used_percentage`, `rate_limits.seven_day.used_percentage` | 5 時間または 7 日間のレート制限の消費率（0 から 100） |

194| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | 5 時間または 7 日間のレート制限ウィンドウがリセットされる時刻（Unix エポック秒） |194| `rate_limits.five_hour.resets_at`, `rate_limits.seven_day.resets_at` | 5 時間または 7 日間のレート制限ウィンドウがリセットされる時刻（Unix エポック秒） |

72 72 

73Claude がタスクを完了するか権限プロンプトで一時停止し、ターミナルから離れているように見える場合、通知イベントが発火します。[各通知タイプが発火するタイミング](https://code.claude.com/docs/ja/hooks.md#notification)を参照して、正確なタイミングを確認してください。これをターミナルベルまたはデスクトップ通知として表示することで、長いタスクが実行されている間に他の作業に切り替えることができます。73Claude がタスクを完了するか権限プロンプトで一時停止し、ターミナルから離れているように見える場合、通知イベントが発火します。[各通知タイプが発火するタイミング](https://code.claude.com/docs/ja/hooks.md#notification)を参照して、正確なタイミングを確認してください。これをターミナルベルまたはデスクトップ通知として表示することで、長いタスクが実行されている間に他の作業に切り替えることができます。

74 74 

75デフォルトでは Claude Code は Ghostty、Kitty、および iTerm2 でのみデスクトップ通知を送信します。他のターミナルでは、[`preferredNotifChannel`](https://code.claude.com/docs/ja/settings-reference#preferrednotifchannel)を`"terminal_bell"`に設定してターミナルベルを鳴らすか、カスタム音またはコマンド用に[通知フック](#play-a-sound-with-a-notification-hook)を設定してください。次の設定エントリはターミナルベルをオンにします：75デフォルトでは、Claude Code は一部のターミナルではデスクトップ通知を送信し、それ以外のターミナルではベル文字を送信するか、何も送信しません：

76 

77* **Ghostty、Kitty、および iTerm2**：デスクトップ通知を送信します。iTerm2 では、アラート設定をオンにした後にのみ表示されます。

78* **Apple Terminal**：音は鳴りません。Claude Code が最前面の Terminal ウィンドウのプロファイルで「Audible bell」がオフになっていることを検出した場合は無音のベル文字を送信し、それ以外の場合は何も送信しません。このベル文字は、そのプロファイルの「Visual bell」または Dock のバウンスオプションがオンになっている場合、ウィンドウのフラッシュとして、または Terminal がバックグラウンドにあるときは Dock アイコンのバウンスとして表示されます。

79* **その他のターミナル**：何も送信しません。

80 

81ターミナルやプロファイルに関係なく Claude Code にベル文字を送信させるには、[`preferredNotifChannel`](https://code.claude.com/docs/ja/settings-reference#preferrednotifchannel) を `"terminal_bell"` に設定します。Apple Terminal では、音を聞くために **Settings > Profiles > Advanced** で **Audible bell** もオンにしてください。次の設定エントリでチャネルを設定します：

76 82 

77```json ~/.claude/settings.json theme={null}83```json ~/.claude/settings.json theme={null}

78{84{

995 995 

996### WSL での npm インストールエラー996### WSL での npm インストールエラー

997 997 

998これらの問題は、WSL 内で `npm install -g` を使用して Claude Code をインストールした場合に適用されます。[ネイティブインストーラー](https://code.claude.com/docs/ja/setup.md)を使用した場合は、このセクションをスキップしてください。998これらの問題は、WSL 内で `npm install -g` を使用して Claude Code をインストールした場合に適用されます。[ネイティブインストーラー](https://code.claude.com/docs/ja/setup.md)を使用した場合は、このセクションをスキップしてください。npm 12 の場合は、[npm 12 のインストールを修正する](#fix-an-npm-12-install)の説明に従ってインストールしてください。

999 999 

1000**OS またはプラットフォーム検出の問題。** npm がインストール中にプラットフォームの不一致を報告する場合、WSL は Windows `npm` を選択している可能性があります。最初に `npm config set os linux` を実行してから、`npm install -g @anthropic-ai/claude-code --force` でインストールしてください。`sudo` を使用しないでください。1000**OS またはプラットフォーム検出の問題。** npm がインストール中にプラットフォームの不一致を報告する場合、WSL は Windows `npm` を選択している可能性があります。最初に `npm config set os linux` を実行してから、`npm install -g @anthropic-ai/claude-code --force` でインストールしてください。`sudo` を使用しないでください。

1001 1001 

1037 1037 

1038### npm インストール後にネイティブバイナリが見つからない1038### npm インストール後にネイティブバイナリが見つからない

1039 1039 

1040`@anthropic-ai/claude-code` npm パッケージは、`@anthropic-ai/claude-code-darwin-arm64` などのプラットフォーム固有のオプション依存関係としてネイティブバイナリをダウンロードします。npm はパッケージの postinstall スクリプトを実行し、そのバイナリを `claude` コマンドとしてその場所にコピーします。実行されるまで、`claude` はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーはその場所に残り、macOS と Linux で `claude` を実行すると次のように出力されます。1040`@anthropic-ai/claude-code` npm パッケージは、`@anthropic-ai/claude-code-darwin-arm64` などのプラットフォーム固有のオプション依存関係としてネイティブバイナリをダウンロードします。`@anthropic-ai/claude-code` パッケージの postinstall ステップが実行され、プレースホルダーをそのバイナリに置き換えるまで、`claude` はプレースホルダースクリプトです。ダウンロードまたは postinstall ステップのいずれかがスキップされた場合、プレースホルダーはその場所に残り、macOS と Linux で `claude` を実行すると次のように出力されます。

1041 1041 

1042```text theme={null}1042```text theme={null}

1043Error: claude native binary not installed.1043Error: claude native binary not installed.

1056 1056 

1057次の原因を確認してください。1057次の原因を確認してください。

1058 1058 

1059* **npm 12 はデフォルトで postinstall ステップをスキップする。** npm 12 で Claude Code をインストールまたは更新すると、npm はこのステップを実行しないままインストールを完了します。[npm 12 のインストールを修正する](#fix-an-npm-12-install)を参照してください。

1059* **オプション依存関係が無効になっている。** npm インストールコマンドから `--omit=optional` を削除し、pnpm から `--no-optional` を削除し、yarn から `--ignore-optional` を削除し、`.npmrc` が `optional=false` を設定していないことを確認してください。次に再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックがなく、`install.cjs` を再度実行してもダウンロードされなかったバイナリを配置できません。1060* **オプション依存関係が無効になっている。** npm インストールコマンドから `--omit=optional` を削除し、pnpm から `--no-optional` を削除し、yarn から `--ignore-optional` を削除し、`.npmrc` が `optional=false` を設定していないことを確認してください。次に再インストールしてください。ネイティブバイナリはオプション依存関係としてのみ配信されるため、スキップされた場合は JavaScript フォールバックがなく、`install.cjs` を再度実行してもダウンロードされなかったバイナリを配置できません。

1060* **インストールスクリプトが無効になっている。** `--ignore-scripts` と一部の pnpm 設定は postinstall ステップをスキップしますが、プラットフォームパッケージはダウンロードします。メッセージが示唆するように `node node_modules/@anthropic-ai/claude-code/install.cjs` を実行するか、フラグなしで再インストールしてください。postinstall が環境でまったく実行できない場合、`node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` はダウンロードされたパッケージを見つけて起動します。ただし、起動のたびに追加の Node プロセスが必要になります。ラッパーが代わりに `Could not find native binary package` を出力する場合、プラットフォームパッケージはダウンロードされなかったため、最初に上記のオプション依存関係の原因を修正してください。1061* **インストールスクリプトが無効になっている。** `--ignore-scripts` と一部の pnpm 設定は postinstall ステップをスキップしますが、プラットフォームパッケージはダウンロードします。メッセージが示唆するように `node node_modules/@anthropic-ai/claude-code/install.cjs` を実行するか、フラグなしで再インストールしてください。postinstall が環境でまったく実行できない場合、`node node_modules/@anthropic-ai/claude-code/cli-wrapper.cjs` はダウンロードされたパッケージを見つけて起動します。ただし、起動のたびに追加の Node プロセスが必要になります。ラッパーが代わりに `Could not find native binary package` を出力する場合、プラットフォームパッケージはダウンロードされなかったため、最初に上記のオプション依存関係の原因を修正してください。

1061* **サポートされていないプラットフォーム。** プリビルトバイナリは `darwin-arm64`、`darwin-x64`、`linux-x64`、`linux-arm64`、`linux-x64-musl`、`linux-arm64-musl`、`win32-x64`、`win32-arm64` に対して公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。[システム要件](https://code.claude.com/docs/ja/setup.md#system-requirements)を参照してください。FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。1062* **サポートされていないプラットフォーム。** プリビルトバイナリは `darwin-arm64`、`darwin-x64`、`linux-x64`、`linux-arm64`、`linux-x64-musl`、`linux-arm64-musl`、`win32-x64`、`win32-arm64` に対して公開されています。Claude Code は他のプラットフォーム用のバイナリを出荷しません。[システム要件](https://code.claude.com/docs/ja/setup.md#system-requirements)を参照してください。FreeBSD では、インストーラーはプラットフォームをサポートされていないと報告します。v2.1.205 より前では、FreeBSD を Linux として扱い、実行できないバイナリをダウンロードしました。

1062* **企業 npm ミラーがプラットフォームパッケージを欠落している。** レジストリがメタパッケージに加えて 8 つすべての `@anthropic-ai/claude-code-*` プラットフォームパッケージをミラーしていることを確認してください。1063* **企業 npm ミラーがプラットフォームパッケージを欠落している。** レジストリがメタパッケージに加えて 8 つすべての `@anthropic-ai/claude-code-*` プラットフォームパッケージをミラーしていることを確認してください。

1063 1064 

1065#### npm 12 のインストールを修正する

1066 

1067npm でのインストールまたは更新後に `claude` が `Error: claude native binary not installed.` を出力する場合、または Windows でシェルがそれを実行できない場合は、`npm --version` を実行してください。バージョンが `12` で始まる場合、npm の設定で許可していない限り、npm はバイナリを配置する Claude Code の postinstall ステップをスキップしています。その他のバージョンの場合は、[その他の原因](#native-binary-not-found-after-npm-install)を確認してください。

1068 

1069npm 12 のインストールを修正するには、ネイティブインストーラーに切り替えるか、このステップを許可します。

1070 

1071* **ネイティブインストーラーに切り替える**：[ネイティブインストーラーでインストール](https://code.claude.com/docs/ja/setup.md#install-claude-code)してから、[npm パッケージをアンインストール](https://code.claude.com/docs/ja/setup.md#uninstall-with-npm)します。以降の更新では npm を使用しないため、このエラーは再発しません。

1072* **npm を使い続ける**：グローバル npm インストールの場合は、ユーザーの npm 設定の `allow-scripts` に Claude Code を追加します。これにより npm は、以降のすべてのインストールと更新、および `package.json` で `allowScripts` を設定していないプロジェクトインストールで、Claude Code のインストールスクリプトを実行します。

1073 

1074 `~/.claude/local` へのローカルインストールには、ネイティブインストーラーを使用してください。`package.json` のスクリプトが `npm install` を呼び出し、それを pnpm 9、pnpm 10、Yarn 1、またはこの設定をスクリプトに渡すその他のツールで実行する場合も、ネイティブインストーラーを使用してください。npm 12.1 以降では、この設定が保存されると、これらのインストールが `EALLOWSCRIPTS` で失敗することがあります。

1075 

1076 1. `npm --version` が 12.0.x を出力した場合は、`npm install -g npm@latest` などで npm を 12.1 以降に更新してください。12.0.x では、この設定が保存されると、`npx` ツールや `npm run` スクリプトが開始するプロジェクトインストールが `EALLOWSCRIPTS` で失敗することがあります。

1077 

1078 2. 次のコマンドは値全体を置き換えるため、`npm config get allow-scripts` を実行し、一覧表示されたパッケージを控えておいてください。`"allow-scripts=@anthropic-ai/claude-code,<package>"` のように、それらのパッケージを引用符内に含めて設定を保存します。

1079 

1080 ```bash theme={null}

1081 npm config set "allow-scripts=@anthropic-ai/claude-code" --location=user

1082 ```

1083 

1084 3. 再インストールします。

1085 

1086 ```bash theme={null}

1087 npm install -g @anthropic-ai/claude-code

1088 ```

1089 

1090 このコマンドまたは手順 1 が `EACCES` で失敗する場合は、`sudo` を付けて再実行するのではなく、ネイティブインストーラーに切り替えてください。Claude Code は自身を更新する際に `sudo` なしで npm を実行するため、自動更新も同じように失敗します。

1091 

1092 4. `claude --version` がバージョン番号を出力しない場合は、[その他の原因](#native-binary-not-found-after-npm-install)を確認してください。

1093 

1094 元に戻すには、`@anthropic-ai/claude-code` を除いたリストを再設定するか、`npm config delete allow-scripts --location=user` でリスト全体を削除してください。npm 12 では、次回の更新後にエラーが再発します。

1095 

1064### npm `ENOTEMPTY` エラー（更新または再インストール中）1096### npm `ENOTEMPTY` エラー（更新または再インストール中）

1065 1097 

1066既存のインストールに対して `npm install -g @anthropic-ai/claude-code` を実行すると、npm は古いパッケージディレクトリを移動しようとしている間に失敗する可能性があります。1098既存のインストールに対して `npm install -g @anthropic-ai/claude-code` を実行すると、npm は古いパッケージディレクトリを移動しようとしている間に失敗する可能性があります。

1094Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"1126Remove-Item -Recurse -Force "$(npm root -g)/@anthropic-ai/claude-code", "$(npm root -g)/@anthropic-ai/.claude-code-*"

1095```1127```

1096 1128 

1097次に再インストールしてください。1129次に再インストールしてください。npm 12 の場合は、[npm 12 のインストールを修正する](#fix-an-npm-12-install)に従ってください。それ以外の場合は、次を実行してください。

1098 1130 

1099```bash theme={null}1131```bash theme={null}

1100npm install -g @anthropic-ai/claude-code1132npm install -g @anthropic-ai/claude-code

133 133 

134## 実行中のレビューを追跡する134## 実行中のレビューを追跡する

135 135 

136レビューは通常 15 ～ 25 分かかります。レビューはバックグラウンドタスクとして実行されるため、セッションで作業を続けたり、他のコマンドを開始したりできます。[プルリクエストに検出結果を投稿](#post-findings-to-the-pull-request)することを選択した場合は、レビューが完了するまでセッションを開いたままにしてください。セッションが先に終了した場合、Claude Code は何も投稿しません。136レビューは通常 5 ～ 15 分かかります。レビューはバックグラウンドタスクとして実行されるため、セッションで作業を続けたり、他のコマンドを開始したりできます。[プルリクエストに検出結果を投稿](#post-findings-to-the-pull-request)することを選択した場合は、レビューが完了するまでセッションを開いたままにしてください。セッションが先に終了した場合、Claude Code は何も投稿しません。

137 137 

138`/tasks` を使用して、実行中および完了したレビューを表示し、レビューの詳細ビューを開くか、進行中のレビューを停止します。レビューを停止すると、Claude Code はクラウドセッションをアーカイブし、部分的な検出結果は返されません。138`/tasks` を使用して、実行中および完了したレビューを表示し、レビューの詳細ビューを開くか、進行中のレビューを停止します。レビューを停止すると、Claude Code はクラウドセッションをアーカイブし、部分的な検出結果は返されません。

139 139 

211| 対象 | 作業中の diff、プルリクエスト、ブランチ、またはパス | 作業中の diff またはプルリクエスト |211| 対象 | 作業中の diff、プルリクエスト、ブランチ、またはパス | 作業中の diff またはプルリクエスト |

212| 実行場所 | セッション内でローカルに実行 | クラウドサンドボックスで実行 |212| 実行場所 | セッション内でローカルに実行 | クラウドサンドボックスで実行 |

213| 深さ | effort 引数でスケール | 独立した検証を備えたマルチエージェントフリート |213| 深さ | effort 引数でスケール | 独立した検証を備えたマルチエージェントフリート |

214| 所要時間 | 数秒から数分 | 約 15 ～ 25 分 |214| 所要時間 | 数秒から数分 | 約 5 ～ 15 分 |

215| コスト | 通常の使用量にカウント | 無料実行、その後使用クレジットで約 $5 ～ $25 / レビュー |215| コスト | 通常の使用量にカウント | 無料実行、その後使用クレジットで約 $5 ～ $25 / レビュー |

216| 最適な用途 | 反復中の迅速なフィードバック | 大幅な変更のマージ前の確信度向上 |216| 最適な用途 | 反復中の迅速なフィードバック | 大幅な変更のマージ前の確信度向上 |

217 217