Documentation 2026-09-30 23:00 UTC to 2026-10-01 05:00 UTC

2884 2884 

2885**ツール名：** `Bash`2885**ツール名：** `Bash`

2886 2886 

2887フォアグラウンドの上限については、[タイムアウトと出力制限](/docs/ja/tools-reference#timeout-and-output-limits) を参照してください。バックグラウンド時間制限については、[バックグラウンドコマンド](/docs/ja/tools-reference#background-commands) を参照してください。2887フォアグラウンドの上限については、[タイムアウトと出力制限](/docs/ja/tools-reference#timeout-and-output-limits) を参照してください。バックグラウンド時間制限については、[バックグラウンドコマンドの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) を参照してください。

2888 2888 

2889**入力：**2889**入力：**

2890 2890 

716| `reloadOutputStyles()` | ディスクから [出力スタイル](/docs/ja/output-styles) を再読み込みして、ミッドセッション中に追加または編集したスタイルファイルが実行中のセッションで利用可能になるようにします。再読み込み後に利用可能なスタイル名をリストする [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) で解決します。Agent SDK v0.3.261 以降が必要です |716| `reloadOutputStyles()` | ディスクから [出力スタイル](/docs/ja/output-styles) を再読み込みして、ミッドセッション中に追加または編集したスタイルファイルが実行中のセッションで利用可能になるようにします。再読み込み後に利用可能なスタイル名をリストする [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) で解決します。Agent SDK v0.3.261 以降が必要です |

717| `accountInfo()` | アカウント情報を返します |717| `accountInfo()` | アカウント情報を返します |

718| `reconnectMcpServer(serverName)` | MCP サーバーを名前で再接続します。名前が `.mcp.json` または `~/.claude.json` などの設定ファイルのエントリとも一致する場合、Claude Code は [`mcpServers`](#options) または `setMcpServers()` を通じて設定したサーバーを再接続し、設定ファイルエントリではありません。その解決順序には Claude Code v2.1.257 以降が必要です |718| `reconnectMcpServer(serverName)` | MCP サーバーを名前で再接続します。名前が `.mcp.json` または `~/.claude.json` などの設定ファイルのエントリとも一致する場合、Claude Code は [`mcpServers`](#options) または `setMcpServers()` を通じて設定したサーバーを再接続し、設定ファイルエントリではありません。その解決順序には Claude Code v2.1.257 以降が必要です |

719| `toggleMcpServer(serverName, enabled)` | `reconnectMcpServer()` と同じ名前解決で MCP サーバーを名前で有効または無効にします。無効にするとサーバーが切断されます |719| `toggleMcpServer(serverName, enabled)` | `reconnectMcpServer()` と同じ名前解決で MCP サーバーを名前で有効または無効にします。無効にするとサーバーが切断されます。ミッドセッション中に `setMcpServers()` で追加したサーバーの場合、ツール削除には Claude Code v2.1.285 以降が必要です |

720| `setMcpServers(servers)` | このセッションの MCP サーバーセットを動的に置き換えます。追加および削除されたサーバーと任意のエラーを指定する [`McpSetServersResult`](#mcpsetserversresult) で解決します |720| `setMcpServers(servers)` | このセッションの MCP サーバーセットを動的に置き換えます。追加および削除されたサーバーと任意のエラーを指定する [`McpSetServersResult`](#mcpsetserversresult) で解決します |

721| `readMcpResource(serverName, uri)` | *アルファ。* 接続された MCP サーバーから 1 つの MCP Apps `ui://` リソースを読み取り、アプリケーションがツールのウィジェットをレンダリングできるようにします。[`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse) で解決します。TypeScript Agent SDK v0.3.280 以降が必要です |721| `readMcpResource(serverName, uri)` | *アルファ。* 接続された MCP サーバーから 1 つの MCP Apps `ui://` リソースを読み取り、アプリケーションがツールのウィジェットをレンダリングできるようにします。[`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse) で解決します。TypeScript Agent SDK v0.3.280 以降が必要です |

722| `streamInput(stream)` | マルチターン会話のためにクエリにメッセージをストリーミングします |722| `streamInput(stream)` | マルチターン会話のためにクエリにメッセージをストリーミングします |

1768 1768 

1769* 最初の返信以外の返信フレーム1769* 最初の返信以外の返信フレーム

1770* サブエージェントフレーム1770* サブエージェントフレーム

1771* `uuid` を持つメッセージに答えないターン：ターンが `uuid` なしで送信したメッセージに答えたか、Claude Code がターンを開始し、`uuid` を持つ通常のメッセージを取得しなかった1771* `uuid` を持つメッセージに答えないターン：ターンが `uuid` を持つ通常のメッセージに答えないか、Claude Code がターンを開始し、`uuid` を持つ通常のメッセージを取得しなかった

1772* 送信したメッセージに答えない結果。クラッシュしたワーカープロセス後のゼロ化された結果など1772* 送信したメッセージに答えない結果。クラッシュしたワーカープロセス後のゼロ化された結果など

1773 1773 

1774<h4 id="user_message_uuids">1774<h4 id="user_message_uuids">

1821```typescript theme={null}1821```typescript theme={null}

1822type SDKStartupFailureReason =1822type SDKStartupFailureReason =

1823 | "org_pin_api_key_conflict"1823 | "org_pin_api_key_conflict"

1824 | "provider_not_allowed"

1824 | "org_verify_failed"1825 | "org_verify_failed"

1825 | "org_pin_mismatch"1826 | "org_pin_mismatch"

1826 | "managed_settings_invalid"1827 | "managed_settings_invalid"

1843| 値 | セッションを停止したもの |1844| 値 | セッションを停止したもの |

1844| :- | :- |1845| :- | :- |

1845| `org_pin_api_key_conflict` | 管理設定が [ファーストパーティまたはクラウドゲートウェイサインイン](/docs/ja/authentication#restrict-login-to-your-organization) を必要とし、Anthropic API キー、認証トークン、または `apiKeyHelper` が代わりに設定されている |1846| `org_pin_api_key_conflict` | 管理設定が [ファーストパーティまたはクラウドゲートウェイサインイン](/docs/ja/authentication#restrict-login-to-your-organization) を必要とし、Anthropic API キー、認証トークン、または `apiKeyHelper` が代わりに設定されている |

1847| `provider_not_allowed` | 管理設定が [このマシンが使用できる API プロバイダーをリストアップ](/docs/ja/settings-reference#allowedproviders) し、セッションがリストされていないプロバイダー、または設定がピンしないエンドポイント用に設定されている。Claude Code v2.1.285 以降が必要です |

1846| `org_verify_failed` | サインインの組織をピンに対して検証できなかった。例えば、ネットワーク障害または失効したトークンのため |1848| `org_verify_failed` | サインインの組織をピンに対して検証できなかった。例えば、ネットワーク障害または失効したトークンのため |

1847| `org_pin_mismatch` | サインインがピンが許可しない組織に属している |1849| `org_pin_mismatch` | サインインがピンが許可しない組織に属している |

1848| `managed_settings_invalid` | 管理ポリシー設定を読み取ることができず、ピンが組織に名前を付けず、または [管理モデル制限](/docs/ja/errors#managed-settings-block-the-default-model) がデフォルトオプションに許可されたモデルを残していない |1850| `managed_settings_invalid` | 管理ポリシー設定を読み取ることができず、ピンが組織に名前を付けず、または [管理モデル制限](/docs/ja/errors#managed-settings-block-the-default-model) がデフォルトオプションに許可されたモデルを残していない |

1908 1910 

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

1910 1912 

1911* 努力レベル：`effort` は、[努力レベル](/docs/ja/model-config#adjust-effort-level)。Claude Code がセッションの次のリクエストで送信するか、何も送信しない場合は `null`。Claude Code は、[リモートコントロール](/docs/ja/remote-control) クライアントに送信する初期化メッセージでのみフィールドを設定し、アプリケーションが読み取る初期化メッセージから省略します。Agent SDK v0.3.234 以降が必要です。1913* 努力レベル：`effort` は、[努力レベル](/docs/ja/model-config#adjust-effort-level) Claude Code がセッションの次のリクエストで送信するか、何も送信しない場合は `null`。Claude Code は、[リモートコントロール](/docs/ja/remote-control) クライアントに送信する初期化メッセージでのみフィールドを設定し、アプリケーションが読み取る初期化メッセージから省略します。Agent SDK v0.3.234 以降が必要です。

1912 1914 

1913`capabilities` 配列は、この CLI が実装するプロトコル動作に名前を付けるため、`claude_code_version` 文字列を比較する代わりに機能検出できます。これはオープンセットです：認識しない値は無視し、依存する動作の特定の機能をチェックしてください。フィールドには Claude Code v2.1.205 以降が必要であり、以前の CLI では不在です。1915`capabilities` 配列は、この CLI が実装するプロトコル動作に名前を付けるため、`claude_code_version` 文字列を比較する代わりに機能検出できます。これはオープンセットです：認識しない値は無視し、依存する動作の特定の機能をチェックしてください。フィールドには Claude Code v2.1.205 以降が必要であり、以前の CLI では不在です。

1914 1916 

3184};3186};

3185```3187```

3186 3188 

3187オプションのタイムアウトとバックグラウンド実行を備えた Bash コマンドを実行します。作業ディレクトリはコマンド間で永続化されます。マルチターンセッションの後のターンで実行されるコマンドも含まれます。エクスポートされた環境変数などのシェル状態は永続化されません。ディレクトリ変更がどの程度引き継がれるかの制限については、[コマンド間で永続化されるもの](/docs/ja/tools-reference#what-persists-between-commands) を参照してください。フォアグラウンドの上限を設定するものについては、[タイムアウトと出力の制限](/docs/ja/tools-reference#timeout-and-output-limits) を参照してください。バックグラウンド時間制限については、[バックグラウンドコマンド](/docs/ja/tools-reference#background-commands) を参照してください。3189オプションのタイムアウトとバックグラウンド実行を備えた Bash コマンドを実行します。作業ディレクトリはコマンド間で永続化されます。マルチターンセッションの後のターンで実行されるコマンドも含まれます。エクスポートされた環境変数などのシェル状態は永続化されません。ディレクトリ変更がどの程度引き継がれるかの制限については、[コマンド間で永続化されるもの](/docs/ja/tools-reference#what-persists-between-commands) を参照してください。フォアグラウンドの上限を設定するものについては、[タイムアウトと出力の制限](/docs/ja/tools-reference#timeout-and-output-limits) を参照してください。バックグラウンド時間制限については、[バックグラウンドコマンドの時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) を参照してください。

3188 3190 

3189<h3 id="monitor">3191<h3 id="monitor">

3190 Monitor3192 Monitor

4088 4090 

4089`timedOutAfterMs` はタイムアウト（ミリ秒単位）で、コマンドがタイムアウトに達し、明示的に開始するのではなくバックグラウンドに移動した場合に設定されます。`backgroundCwdHint` はバックグラウンド化されたコマンドに `cd`、`pushd`、`popd`、`chdir` などのディレクトリ変更組み込みが含まれていた場合に設定され、セッション作業ディレクトリが変更されなかったことを注記します。両方のフィールドは Claude Code v2.1.210 以降が必要です。4091`timedOutAfterMs` はタイムアウト（ミリ秒単位）で、コマンドがタイムアウトに達し、明示的に開始するのではなくバックグラウンドに移動した場合に設定されます。`backgroundCwdHint` はバックグラウンド化されたコマンドに `cd`、`pushd`、`popd`、`chdir` などのディレクトリ変更組み込みが含まれていた場合に設定され、セッション作業ディレクトリが変更されなかったことを注記します。両方のフィールドは Claude Code v2.1.210 以降が必要です。

4090 4092 

4091フォアグラウンドで実行されているサブエージェントがバックグラウンド化されたコマンドを所有している場合、コマンドは[そのサブエージェントの実行が終了するときに終了します](/docs/ja/tools-reference#background-commands)。Claude Code はそのようなコマンドで `backgroundEndsWithFinalResponse` を `true` に設定し、コマンドがターンを超えて存続する場合はフィールドを省略します。メインの会話またはバックグラウンドサブエージェントによって開始されたコマンドと同様です。このフィールドは Claude Code v2.1.227 以降が必要です。4093フォアグラウンドで実行されているサブエージェントがバックグラウンド化されたコマンドを所有している場合、コマンドは[そのサブエージェントの実行が終了するときに終了します](/docs/ja/tools-reference#when-a-background-command-stops)。Claude Code はそのようなコマンドで `backgroundEndsWithFinalResponse` を `true` に設定し、コマンドがターンを超えて存続する場合はフィールドを省略します。メインの会話またはバックグラウンドサブエージェントによって開始されたコマンドと同様です。このフィールドは Claude Code v2.1.227 以降が必要です。

4092 4094 

4093Claude Code は `gitOperation.commit.branch` を git のコミットサマリー行で名付けられたブランチに設定し、デタッチされた HEAD でコミットされたブランチの場合は省略します。このフィールドは Agent SDK v0.3.227 以降が必要です。Claude Code は `gh pr reopen` コマンドを `reopened` PR アクションとして報告します。これは Agent SDK v0.3.234 以降が必要です。4095Claude Code は `gitOperation.commit.branch` を git のコミットサマリー行で名付けられたブランチに設定し、デタッチされた HEAD でコミットされたブランチの場合は省略します。このフィールドは Agent SDK v0.3.227 以降が必要です。Claude Code は `gh pr reopen` コマンドを `reopened` PR アクションとして報告します。これは Agent SDK v0.3.234 以降が必要です。

4094 4096 

8 8 

9`claude agents` で開くエージェントビューは、すべてのバックグラウンドセッションの 1 つの画面です。実行中のもの、入力が必要なもの、完了したものが表示されます。新しいセッションをディスパッチし、トランスクリプトをスクロールする代わりに一目でセッションの状態を確認し、セッションが必要とするときだけ介入します。各バックグラウンドセッションは完全な Claude Code の会話であり、ターミナルが接続されていなくてもバックグラウンドで実行し続けるため、いつでも開いて、返信して、去ることができます。9`claude agents` で開くエージェントビューは、すべてのバックグラウンドセッションの 1 つの画面です。実行中のもの、入力が必要なもの、完了したものが表示されます。新しいセッションをディスパッチし、トランスクリプトをスクロールする代わりに一目でセッションの状態を確認し、セッションが必要とするときだけ介入します。各バックグラウンドセッションは完全な Claude Code の会話であり、ターミナルが接続されていなくてもバックグラウンドで実行し続けるため、いつでも開いて、返信して、去ることができます。

10 10 

11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="ターミナルのエージェントビュー：ヘッダーは Claude Code v2.1.140、モデル、作業ディレクトリ、および概要カウントを表示します。セッションは「入力が必要」、「実行中」、「完了」の下にグループ化され、下部にディスパッチ入力とキーボードヒントのフッターがあります。" width="1772" height="780" data-path="images/agent-view-light.png" />11<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-light.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=d6905012bee31f3e6b3920b09c05dd02" className="dark:hidden" alt="ターミナルのエージェントビュー。上部の行は、入力を待機しているセッション、実行中のセッション、完了したセッションの数をカウントします。4 つのセッションは「入力が必要」、「実行中」、「完了」の下にグループ化されています。各行はセッションの名前、最新のステータスまたは質問、および時間を表示します。下部には新しいタスクを説明するための入力と、キーボードヒントの行があります。" width="1872" height="680" data-path="images/agent-view-light.png" />

12 12 

13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="ターミナルのエージェントビュー：ヘッダーは Claude Code v2.1.140、モデル、作業ディレクトリ、および概要カウントを表示します。セッションは「入力が必要」、「実行中」、「完了」の下にグループ化され、下部にディスパッチ入力とキーボードヒントのフッターがあります。" width="1772" height="780" data-path="images/agent-view-dark.png" />13<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-dark.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=fc3c195bfc57e313ced1f1beb36cee93" className="hidden dark:block" alt="ターミナルのエージェントビュー。上部の行は、入力を待機しているセッション、実行中のセッション、完了したセッションの数をカウントします。4 つのセッションは「入力が必要」、「実行中」、「完了」の下にグループ化されています。各行はセッションの名前、最新のステータスまたは質問、および時間を表示します。下部には新しいタスクを説明するための入力と、キーボードヒントの行があります。" width="1872" height="680" data-path="images/agent-view-dark.png" />

14 14 

15Claude が複数の独立したタスクに対して、あなたが毎ステップを監視することなく作業できる場合に、エージェントビューを使用します。バグ修正、プルリクエストレビュー、不安定なテストの調査を 3 つの行としてディスパッチし、別のウィンドウで作業を続け、行が入力が必要であることを示すか、結果が得られたときに確認します。15Claude が複数の独立したタスクに対して、あなたが毎ステップを監視することなく作業できる場合に、エージェントビューを使用します。バグ修正、プルリクエストレビュー、不安定なテストの調査を 3 つの行としてディスパッチし、別のウィンドウで作業を続け、行が入力が必要であることを示すか、結果が得られたときに確認します。

16 16 

384 384 

385`opus` などのモデルエイリアスはピンとして機能せず、Claude Code が認識しないモデル ID（アプリケーション推論プロファイル ARN など）も同様です。385`opus` などのモデルエイリアスはピンとして機能せず、Claude Code が認識しないモデル ID（アプリケーション推論プロファイル ARN など）も同様です。

386 386 

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

388 

389<h3 id="when-a-model-is-disabled-mid-session">

390 モデルがセッション中に無効化される場合

391</h3>

392 

393セッションが実行されているモデルへのアカウントアクセスが失われた場合（例えば、管理者が Amazon Bedrock アカウントでそれを無効化した場合）、Claude Code は各リクエストが失敗する代わりにセッションを別のモデルに切り替え、`Switched to <fallback> because <model> is not available` を表示します。スタートアップフォールバックと同じモデルを試します。同じティアの以前のバージョンを最初に試し、Opus セッションで Opus バージョンが利用できない場合、デフォルト Sonnet モデルを試します。

394 

395切り替えは、ピン留めしていないティアにのみ適用されます。これはスタートアップフォールバックと同じ条件です。選択した特定のバージョン、または[アプリケーション推論プロファイル ARN](#map-each-model-version-to-an-inference-profile)でセッションを実行している場合、そのモデルを保持し、フォールバックモデルチェーンがないため、リクエストは失敗します。[自動モード](/docs/ja/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)では、Claude Code は Amazon Bedrock で自動モードがサポートするモデルにのみ切り替えます。それらのモデルも利用できない場合、リクエストは[AWS 認証失敗](/docs/ja/errors#aws-authentication-failed)で失敗し、モデルを有効にするためのヒントが表示されます。

396 

397設定した[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)はティア切り替えを置き換えます。これらの拒否では Claude Code は設定したフォールバックに切り替えます。拒否されたリクエストが切り替わるのではなく失敗するようにするには、[`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/ja/env-vars)を設定してください。設定したフォールバックチェーンはこれらの拒否で切り替わります。すべての拒否されたリクエストが失敗するようにしたい場合は、チェーンも削除してください。

398 

387<h2 id="cross-region-inference-profile-prefixes">399<h2 id="cross-region-inference-profile-prefixes">

388 クロスリージョン推論プロファイルプレフィックス400 クロスリージョン推論プロファイルプレフィックス

389</h2>401</h2>

194* **Amazon Bedrock などのクラウドプロバイダーセッション**: `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` 認証情報、または以前の Claude Console ログインによって保存された API キーがマシン上にまだ存在する間のみブロックされます。それを削除するとセッションが開始します。これらのセッションはクラウドプロバイダーに対して認証され、クラウドプロバイダーのアクセスポリシーがそれらを管理します194* **Amazon Bedrock などのクラウドプロバイダーセッション**: `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` 認証情報、または以前の Claude Console ログインによって保存された API キーがマシン上にまだ存在する間のみブロックされます。それを削除するとセッションが開始します。これらのセッションはクラウドプロバイダーに対して認証され、クラウドプロバイダーのアクセスポリシーがそれらを管理します

195* **[Anthropic プロファイルまたはフェデレーション認証情報](#anthropic-profiles-and-federation-credentials)**: `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` 認証情報、または以前の Claude Console ログインによって保存された API キーもマシン上に存在する場合を除き、ブロックされません。キーはプロファイルが属する組織を確認しません195* **[Anthropic プロファイルまたはフェデレーション認証情報](#anthropic-profiles-and-federation-credentials)**: `ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、または `apiKeyHelper` 認証情報、または以前の Claude Console ログインによって保存された API キーもマシン上に存在する場合を除き、ブロックされません。キーはプロファイルが属する組織を確認しません

196 196 

197<h3 id="restrict-which-api-providers-a-machine-may-use">

198 マシンが使用できる API プロバイダーを制限する

199</h3>

200 

201[管理設定](/docs/ja/managed-settings)の [`allowedProviders`](/docs/ja/settings-reference#allowedproviders) は、Anthropic API、Amazon Bedrock、LLM ゲートウェイなど、管理マシンが Claude に到達できるサービスをリストします。これは `forceLoginMethod` と `forceLoginOrgUUID` を補完します。これらは、セッションが Anthropic と通信するときに使用するアカウントを管理します。Claude Code v2.1.285 以降が必要です。

202 

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

204{

205 "forceLoginMethod": "claudeai",

206 "forceLoginOrgUUID": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"],

207 "allowedProviders": ["anthropic", "bedrock"]

208}

209```

210 

211このファイルを使用すると、claude.ai 組織にサインインした開発者または Amazon Bedrock 用に設定された開発者は正常に起動します。他のプロバイダー用に設定されたセッションは起動時に拒否され、実行中のセッションがそのセッションに切り替わると、次のリクエストで拒否されます。[管理設定がこの API プロバイダーを許可していません](/docs/ja/errors#managed-settings-dont-allow-this-api-provider)は各メッセージを表示します。

212 

213* **LLM ゲートウェイまたはプロキシを許可する**: `"customEndpoint"` をリストし、同じソースの管理 `env` ブロックでゲートウェイの URL を設定します。[設定リファレンス](/docs/ja/settings-reference#allowedproviders)はすべての値をリストし、どのエンドポイント変数が管理 `env` ピンを必要とするかを示します。

214* **管理マシンにデプロイする**: リストをポリシーの残りを含む管理ソースに配置します。エントリの [スコープ注記](/docs/ja/settings-reference#allowedproviders)は、サーバー管理リストがそれとどのように組み合わされるかを示します。

215* **サーバー管理設定のみ**: [サーバー管理設定](/docs/ja/server-managed-settings)でのみ設定するリストは、組織の設定を取得するセッションにのみ到達するため、デバイス管理で到達できないマシンの利便性として扱い、強制として扱わないでください。[プラットフォーム可用性](/docs/ja/server-managed-settings#platform-availability)はどのセッションがそれらを取得するかをリストします。

216 

197<h2 id="credential-management">217<h2 id="credential-management">

198 認証情報管理218 認証情報管理

199</h2>219</h2>

84| `--dangerously-skip-permissions` | 権限プロンプトをスキップします。`--permission-mode bypassPermissions` と同等です。[権限モード](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)でこれが何をスキップし、何をスキップしないかを参照してください。`--bg` で開始されたセッションの場合、モードは[スーパーバイザーがセッションを再開するときに保持](/docs/ja/agent-view#permission-mode-model-and-effort)されます | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | 権限プロンプトをスキップします。`--permission-mode bypassPermissions` と同等です。[権限モード](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)でこれが何をスキップし、何をスキップしないかを参照してください。`--bg` で開始されたセッションの場合、モードは[スーパーバイザーがセッションを再開するときに保持](/docs/ja/agent-view#permission-mode-model-and-effort)されます | `claude --dangerously-skip-permissions` |

85| `--debug` | デバッグモードを有効にします。オプションのカテゴリフィルタリング（`--debug='mcp,startup'` または `--debug='!1p'` など）を使用します。フィルターは `=` 形式でのみバインドされます。スペース区切りフィルターはフィルタリングなしでデバッグモードを有効にします | `claude --debug='mcp,startup'` |85| `--debug` | デバッグモードを有効にします。オプションのカテゴリフィルタリング（`--debug='mcp,startup'` または `--debug='!1p'` など）を使用します。フィルターは `=` 形式でのみバインドされます。スペース区切りフィルターはフィルタリングなしでデバッグモードを有効にします | `claude --debug='mcp,startup'` |

86| `--debug-file <path>` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします。`CLAUDE_CODE_DEBUG_LOGS_DIR` よりも優先されます | `claude --debug-file /tmp/claude-debug.log` |86| `--debug-file <path>` | デバッグログを特定のファイルパスに書き込みます。暗黙的にデバッグモードを有効にします。`CLAUDE_CODE_DEBUG_LOGS_DIR` よりも優先されます | `claude --debug-file /tmp/claude-debug.log` |

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

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

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

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

116| `--permission-prompts` | プリントモードで権限プロンプトに誰が答えるかを設定します。デフォルトの `host` を使用すると、Claude Code はそれらをエージェント SDK ホストまたは `--permission-prompt-tool` ツールに送信します。誰も答えられない場合は `none` を渡し、Claude Code は代わりにそれらを拒否します。[無人実行で権限プロンプトをオフにする](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)を参照してください。Claude Code v2.1.259 以降が必要です | `claude -p --permission-prompts none "query"` |117| `--permission-prompts` | プリントモードで権限プロンプトに誰が答えるかを設定します。デフォルトの `host` を使用すると、Claude Code はそれらをエージェント SDK ホストまたは `--permission-prompt-tool` ツールに送信します。誰も答えられない場合は `none` を渡し、Claude Code は代わりにそれらを拒否します。[無人実行で権限プロンプトをオフにする](/docs/ja/headless#turn-off-permission-prompts-in-unattended-runs)を参照してください。Claude Code v2.1.259 以降が必要です | `claude -p --permission-prompts none "query"` |

117| `--plugin-dir` | ディレクトリまたは `.zip` アーカイブからプラグインを読み込むか、[プラグインのフォルダ](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session)から複数を読み込みます。このセッションのみ。各フラグは 1 つのパスを取ります。より多くのパスについてはフラグを繰り返します。`--plugin-dir A --plugin-dir B.zip`。プラグインのフォルダを渡すには Claude Code v2.1.265 以降が必要です | `claude --plugin-dir ./my-plugin` |118| `--plugin-dir` | ディレクトリまたは `.zip` アーカイブからプラグインを読み込むか、[プラグインのフォルダ](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session)から複数を読み込みます。このセッションのみ。各フラグは 1 つのパスを取ります。より多くのパスについてはフラグを繰り返します。`--plugin-dir A --plugin-dir B.zip`。プラグインのフォルダを渡すには Claude Code v2.1.265 以降が必要です | `claude --plugin-dir ./my-plugin` |

118| `--plugin-url` | URL からプラグイン `.zip` アーカイブをフェッチします。このセッションのみ。複数のプラグインについてはフラグを繰り返すか、単一の引用値でスペース区切り URL を渡します | `claude --plugin-url https://example.com/plugin.zip` |119| `--plugin-url` | URL からプラグイン `.zip` アーカイブをフェッチします。このセッションのみ。複数のプラグインについてはフラグを繰り返すか、単一の引用値でスペース区切り URL を渡します | `claude --plugin-url https://example.com/plugin.zip` |

119| `--print`, `-p` | 対話モードなしで応答を出力します（プログラム的な使用の詳細については[エージェント SDK ドキュメント](/docs/ja/agent-sdk/overview)を参照してください） | `claude -p "query"` |120| `--print`, `-p` | 対話モードなしで応答を出力します（プログラム的な使用の詳細については[エージェント SDK ドキュメント](/docs/ja/agent-sdk/overview)を参照してください）。バックグラウンドセッションで `--resume` を実行している場合で、まだ実行中の場合は、[セッションを再開](/docs/ja/sessions#resume-a-running-background-session)を参照してください | `claude -p "query"` |

120| `--prompt-suggestions` | 各ターンの後に予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを出力します。非常に短い会話は何も生成しない可能性があります。`--print`、`--output-format stream-json`、`--verbose` が必要です。[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions)を参照してください | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |121| `--prompt-suggestions` | 各ターンの後に予測される次のユーザープロンプトを含む `prompt_suggestion` メッセージを出力します。非常に短い会話は何も生成しない可能性があります。`--print`、`--output-format stream-json`、`--verbose` が必要です。[プロンプト提案](/docs/ja/interactive-mode#prompt-suggestions)を参照してください | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

121| `--ref <branch>` | `--environment` を使用して、新しいセッションのチェックアウトをローカル `HEAD` の代わりに名前付きリファレンスに基づかせます | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |122| `--ref <branch>` | `--environment` を使用して、新しいセッションのチェックアウトをローカル `HEAD` の代わりに名前付きリファレンスに基づかせます | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |

122| `--remote` | `--cloud` の非推奨エイリアス。既存セッション形式を含みます | `claude --remote "Fix the login bug"` |123| `--remote` | `--cloud` の非推奨エイリアス。既存セッション形式を含みます | `claude --remote "Fix the login bug"` |

124| `--remote-control-session-name-prefix <prefix>` | 明示的な名前が設定されていない場合、自動生成された[リモートコントロール](/docs/ja/remote-control)セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` などの名前を生成します。`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を設定して同じ効果を得ます | `claude remote-control --remote-control-session-name-prefix dev-box` |125| `--remote-control-session-name-prefix <prefix>` | 明示的な名前が設定されていない場合、自動生成された[リモートコントロール](/docs/ja/remote-control)セッション名のプレフィックス。デフォルトはマシンのホスト名で、`myhost-graceful-unicorn` などの名前を生成します。`CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` を設定して同じ効果を得ます | `claude remote-control --remote-control-session-name-prefix dev-box` |

125| `--replay-user-messages` | stdin からのユーザーメッセージを stdout に再出力して確認します。`--input-format stream-json` と `--output-format stream-json` が必要です | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |126| `--replay-user-messages` | stdin からのユーザーメッセージを stdout に再出力して確認します。`--input-format stream-json` と `--output-format stream-json` が必要です | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

126| `--restricted` | 制限モードで開始します。評価ハーネスが共有マシン上で `claude` を駆動し、Claude Code がそのマシンのコマンドを実行したり、ユーザーおよびプロジェクト設定を読み取ったりしてはいけない場合に使用します。Claude Code は、`--tools` で個別に名前を付けない限り、`default` プリセットを通じて、コマンドまたはコードを実行するビルトインツールと WebFetch を削除します。また、ビルトインファイルツールを[作業ディレクトリ](/docs/ja/permissions#working-directories)に限定し、[管理設定](/docs/ja/managed-settings)と `--settings` のみを読み込み、[`bypassPermissions`](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)を拒否し、[クラウドセッションの作成を拒否](/docs/ja/errors#cloud-sessions-cannot-be-created-from-a-restricted-session)します。Claude Code v2.1.248 以降が必要です | `claude --restricted -p "query"` |127| `--restricted` | 制限モードで開始します。評価ハーネスが共有マシン上で `claude` を駆動し、Claude Code がそのマシンのコマンドを実行したり、ユーザーおよびプロジェクト設定を読み取ったりしてはいけない場合に使用します。Claude Code は、`--tools` で個別に名前を付けない限り、`default` プリセットを通じて、コマンドまたはコードを実行するビルトインツールと WebFetch を削除します。また、ビルトインファイルツールを[作業ディレクトリ](/docs/ja/permissions#working-directories)に限定し、[管理設定](/docs/ja/managed-settings)と `--settings` のみを読み込み、[`bypassPermissions`](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)を拒否し、[クラウドセッションの作成を拒否](/docs/ja/errors#cloud-sessions-cannot-be-created-from-a-restricted-session)します。Claude Code v2.1.248 以降が必要です | `claude --restricted -p "query"` |

127| `--resume`, `-r` | ID または名前で特定のセッションを再開するか、セッションを選択するための対話型ピッカーを表示します。ID の代わりに、セッションの `.jsonl` [トランスクリプトファイル](/docs/ja/sessions#where-transcripts-are-stored)への絶対パスを渡すことができます。ピッカーと名前検索には、このディレクトリを `/add-dir` で追加したセッションが含まれます。セッション ID を渡すと、Claude Code は現在のプロジェクトディレクトリとその git ワークツリーを検索してから、このマシン上の他のすべてのプロジェクトを検索します。v2.1.223 より前は、ID 検索は現在のプロジェクトディレクトリとその git ワークツリーのみをカバーしていました。[バックグラウンドセッション](/docs/ja/agent-view)はピッカーに `bg` でマークされて表示されます | `claude --resume auth-refactor` |128| `--resume`, `-r` | ID または名前で特定のセッションを再開するか、セッションを選択するための対話型ピッカーを表示します。ID の代わりに、セッションの `.jsonl` [トランスクリプトファイル](/docs/ja/sessions#where-transcripts-are-stored)への絶対パスを渡すことができます。ピッカーと名前検索には、このディレクトリを `/add-dir` で追加したセッションが含まれます。セッション ID を渡すと、Claude Code は現在のプロジェクトディレクトリとその git ワークツリーを検索してから、このマシン上の他のすべてのプロジェクトを検索します。v2.1.223 より前は、ID 検索は現在のプロジェクトディレクトリとその git ワークツリーのみをカバーしていました。[バックグラウンドセッション](/docs/ja/agent-view)はピッカーに `bg` でマークされて表示されます。まだ実行中のセッションを再開すると、[そのセッション](/docs/ja/sessions#resume-a-running-background-session)を `claude attach` を通じてこのターミナルで開き、コマンドラインで渡すプロンプトはそれに次のターンとして送信されます。v2.1.285 より前は、Claude Code は拒否し、代わりに実行する `claude attach` コマンドを出力しました | `claude --resume auth-refactor` |

128| `--safe-mode` | 壊れた設定をトラブルシューティングするためにすべてのカスタマイズを無効にして開始します。CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインとファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。認証、モデル選択、ビルトインツール、権限は通常どおり機能します。これは [`--bare`](/docs/ja/headless#start-faster-with-bare-mode) と異なります。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含みます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは含まれません。[自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)をトリガーするカスタマイズかどうかを確認するのに役立ちます。[`CLAUDE_CODE_SAFE_MODE`](/docs/ja/env-vars) を設定します | `claude --safe-mode` |129| `--safe-mode` | 壊れた設定をトラブルシューティングするためにすべてのカスタマイズを無効にして開始します。CLAUDE.md、スキル、プラグイン、フック、MCP サーバー、カスタムコマンドとエージェント、出力スタイル、ワークフロー、カスタムテーマ、カスタムキーバインディング、ステータスラインとファイル提案コマンド、LSP サーバー、自動メモリは読み込まれません。認証、モデル選択、ビルトインツール、権限は通常どおり機能します。これは [`--bare`](/docs/ja/headless#start-faster-with-bare-mode) と異なります。管理設定ポリシーは引き続き適用されます。ポリシー設定フック、ステータスライン、ファイル提案コマンドを含みます。管理プラグイン、管理スキル、管理 CLAUDE.md、ポリシー設定 MCP サーバーは含まれません。[自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback)をトリガーするカスタマイズかどうかを確認するのに役立ちます。[`CLAUDE_CODE_SAFE_MODE`](/docs/ja/env-vars) を設定します | `claude --safe-mode` |

129| `--session-id` | 会話に特定のセッション ID を使用します（有効な UUID である必要があります） | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |130| `--session-id` | 会話に特定のセッション ID を使用します（有効な UUID である必要があります） | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

130| `--setting-sources` | 読み込む設定ソースのコンマ区切りリスト（`user`、`project`、`local`）。[エージェントビュー](/docs/ja/agent-view#what-carries-over-when-you-background)と[エージェントチーム](/docs/ja/agent-teams#context-and-communication)を参照してください。このセッションから開始するセッションがリストを継承します | `claude --setting-sources user,project` |131| `--setting-sources` | 読み込む設定ソースのコンマ区切りリスト（`user`、`project`、`local`）。[エージェントビュー](/docs/ja/agent-view#what-carries-over-when-you-background)と[エージェントチーム](/docs/ja/agent-teams#context-and-communication)を参照してください。このセッションから開始するセッションがリストを継承します | `claude --setting-sources user,project` |

439 439 

440* **Claude が実行するコマンド**：クラウド環境は独自のコマンドタイムアウトを設定しないため、Bash ツールのデフォルトが適用されます。Claude はデフォルトでコマンドを 2 分間待機し、最大 10 分間要求できます。440* **Claude が実行するコマンド**：クラウド環境は独自のコマンドタイムアウトを設定しないため、Bash ツールのデフォルトが適用されます。Claude はデフォルトでコマンドを 2 分間待機し、最大 10 分間要求できます。

441 441 

442 コマンドが[タイムアウト](/docs/ja/tools-reference#timeout-and-output-limits)に達すると、Claude Code は `sleep` で始まるコマンドを除き、それを停止する代わりに[バックグラウンドに移動](/docs/ja/tools-reference#background-commands)します。この方法で移動されたコマンドは、Claude Code がそれを[バックグラウンド時間制限](/docs/ja/tools-reference#background-commands)で停止する前に、最大 30 分間実行し続けることができます。`BASH_DEFAULT_TIMEOUT_MS` を `1800000` ミリ秒より上に設定すると、その制限とフォアグラウンドデフォルトの両方が長くなります。442 コマンドが[タイムアウト](/docs/ja/tools-reference#timeout-and-output-limits)に達すると、Claude Code は `sleep` で始まるコマンドを除き、それを停止する代わりに[バックグラウンドに移動](/docs/ja/tools-reference#foreground-commands-that-move-to-the-background)します。この方法で移動されたコマンドは、Claude Code がそれを[バックグラウンド時間制限](/docs/ja/tools-reference#time-limit-for-background-commands)で停止する前に、最大 30 分間実行し続けることができます。`BASH_DEFAULT_TIMEOUT_MS` を `1800000` ミリ秒より上に設定すると、その制限とフォアグラウンドデフォルトの両方が長くなります。

443* **SessionStart hooks**：Claude Code は、hook エントリで[`timeout`](/docs/ja/hooks#common-fields)（秒単位）を設定しない限り、600 秒後に `command` hook をキャンセルします。Claude Code は[`async: true`](/docs/ja/hooks#run-hooks-in-the-background)で実行する hook に対してタイムアウトを適用しません。443* **SessionStart hooks**：Claude Code は、hook エントリで[`timeout`](/docs/ja/hooks#common-fields)（秒単位）を設定しない限り、600 秒後に `command` hook をキャンセルします。Claude Code は[`async: true`](/docs/ja/hooks#run-hooks-in-the-background)で実行する hook に対してタイムアウトを適用しません。

444* **セットアップスクリプト**：約 5 分以上かかるスクリプトはキャッシュされません。[スクリプト要件](#script-requirements)は、その制限内に留まる方法をカバーしています。444* **セットアップスクリプト**：約 5 分以上かかるスクリプトはキャッシュされません。[スクリプト要件](#script-requirements)は、その制限内に留まる方法をカバーしています。

445* **アイドルセッション**：数分間アクティビティがない場合、セッションの VM はファイルが保存された状態で一時停止され、一時停止された VM は後で回収される可能性があります。[環境変数の設定](#set-environment-variables)は、各ケースでセッションが何を取得するかについて説明し、[Environment expired](/docs/ja/claude-code-on-the-web#environment-expired)は VM が回収されたセッションを再度開く方法をカバーしています。445* **アイドルセッション**：数分間アクティビティがない場合、セッションの VM はファイルが保存された状態で一時停止され、一時停止された VM は後で回収される可能性があります。[環境変数の設定](#set-environment-variables)は、各ケースでセッションが何を取得するかについて説明し、[Environment expired](/docs/ja/claude-code-on-the-web#environment-expired)は VM が回収されたセッションを再度開く方法をカバーしています。

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

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

134| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非インタラクティブモード（`-p`）でも利用可能です。Claude Code v2.1.205 以降が必要です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字でキャップします。非表示文字が削除されると名前が空の場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さキャップには Claude Code v2.1.221 以降が必要です。このマシン上の別のライブセッションが既に渡した名前を使用している場合、Claude Code は[その変種](/docs/ja/sessions#name-your-sessions)を代わりに適用します |134| `/rename [name]` | 現在のセッションの名前を変更し、プロンプトバーに名前を表示します。名前がない場合、会話履歴から自動生成されます。非インタラクティブモード（`-p`）でも利用可能です。Claude Code v2.1.205 以降が必要です。claude.ai とデスクトップアプリを含むすべての名前変更サーフェスから、Claude Code は新しい名前の制御文字と非表示文字をスペースに置き換え、名前を 200 文字でキャップします。非表示文字が削除されると名前が空の場合、Claude Code はそれを拒否し、`That name is empty once invisible characters are removed. Usage: /rename <name>` を表示します。文字置換と長さキャップには Claude Code v2.1.221 以降が必要です。このマシン上の別のライブセッションが既に渡した名前を使用している場合、Claude Code は[その変種](/docs/ja/sessions#name-your-sessions)を代わりに適用します |

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

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

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

138| `/run` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトのアプリを起動して駆動し、テストに合格するだけでなく、変更が機能しているのを確認します。[アプリを実行して検証する](/docs/ja/skills#run-and-verify-your-app)を参照してください |138| `/run` | **[Skill](/docs/ja/skills#bundled-skills).** プロジェクトのアプリを起動して駆動し、テストに合格するだけでなく、変更が機能しているのを確認します。[アプリを実行して検証する](/docs/ja/skills#run-and-verify-your-app)を参照してください |

967 967 

968CLI セッションを Desktop に移動するには、ターミナルで `/desktop` を実行します。Claude はセッションを保存し、デスクトップアプリで開いてから CLI を終了します。このコマンドは、Claude サブスクリプションでサインインしている場合、macOS と x64 Windows で利用可能です。API キー認証、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。968CLI セッションを Desktop に移動するには、ターミナルで `/desktop` を実行します。Claude はセッションを保存し、デスクトップアプリで開いてから CLI を終了します。このコマンドは、Claude サブスクリプションでサインインしている場合、macOS と x64 Windows で利用可能です。API キー認証、Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。

969 969 

970シェルから、[`claude --desktop`](/docs/ja/cli-reference#cli-flags) は Desktop を直接開き、ターミナルセッションを開始しません。Claude Code v2.1.285 以降が必要で、`/desktop` と同じプラットフォームおよびサインイン要件があります。他の引数がない場合、現在のディレクトリで Desktop を開きます。既存の CLI セッションを Desktop で開くには、このディレクトリの最新の会話に対して `--continue` を追加するか、`/status` が表示するセッション ID で `--resume` を追加します：

971 

972```bash theme={null}

973claude --desktop --resume <session-id>

974```

975 

976Claude Code は `Opening session <session-id> in Claude Desktop` を出力し、セッションはアプリで開き、コマンドは終了します。セッション名は ID の代わりに機能しません。Claude Code は別のターミナルで開いているセッションや、バックグラウンドで実行中のセッションを移動しません。Claude Desktop がインストールされていない場合、コマンドはダウンロードリンクを出力して終了します。

977 

970Desktop 内から CLI セッションを再開することもできます。`/resume` を使用します。このコマンドはローカルセッションで利用可能で、SSH、WSL、またはクラウドセッションでは利用できません。978Desktop 内から CLI セッションを再開することもできます。`/resume` を使用します。このコマンドはローカルセッションで利用可能で、SSH、WSL、またはクラウドセッションでは利用できません。

971 979 

972Desktop でターミナルセッションを続行するには：980Desktop でターミナルセッションを続行するには：

192| `API_FORCE_IDLE_TIMEOUT` | ストリーミングモデル応答がバイトを受け取らないときに中止する 5 分間のボディアイドルタイムアウトをオーバーライドします。`0` に設定してタイムアウトをオフにします。例えば、遅い [ゲートウェイ](/docs/ja/llm-gateway) またはローカルモデルがチャンク間で 5 分以上一時停止する場合、または `1` に設定してすべてのプロバイダーに対してオンに保ちます。設定されていない場合、タイムアウトは直接 Anthropic API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` が設定された Amazon Bedrock 以外のプロバイダーでアクティブです。[ストリーム監視犬](/docs/ja/network-config#streaming-idle-watchdogs) は独立して実行され、ここで `0` を設定した場合でも長い無音の一時停止を中止します |192| `API_FORCE_IDLE_TIMEOUT` | ストリーミングモデル応答がバイトを受け取らないときに中止する 5 分間のボディアイドルタイムアウトをオーバーライドします。`0` に設定してタイムアウトをオフにします。例えば、遅い [ゲートウェイ](/docs/ja/llm-gateway) またはローカルモデルがチャンク間で 5 分以上一時停止する場合、または `1` に設定してすべてのプロバイダーに対してオンに保ちます。設定されていない場合、タイムアウトは直接 Anthropic API、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および `CLAUDE_ENABLE_BYTE_WATCHDOG_BEDROCK=1` が設定された Amazon Bedrock 以外のプロバイダーでアクティブです。[ストリーム監視犬](/docs/ja/network-config#streaming-idle-watchdogs) は独立して実行され、ここで `0` を設定した場合でも長い無音の一時停止を中止します |

193| `API_TIMEOUT_MS` | API リクエストのタイムアウト（ミリ秒単位）（デフォルト：600000、または 10 分；最大：2147483647）。遅いネットワークでリクエストがタイムアウトする場合、またはプロキシを通じてルーティングする場合は増加させます。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが直ちに失敗します |193| `API_TIMEOUT_MS` | API リクエストのタイムアウト（ミリ秒単位）（デフォルト：600000、または 10 分；最大：2147483647）。遅いネットワークでリクエストがタイムアウトする場合、またはプロキシを通じてルーティングする場合は増加させます。最大値を超える値は基盤となるタイマーをオーバーフローさせ、リクエストが直ちに失敗します |

194| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock 認証用の API キー（[Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照） |194| `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock 認証用の API キー（[Amazon Bedrock API キー](https://aws.amazon.com/blogs/machine-learning/accelerate-ai-development-with-amazon-bedrock-api-keys/) を参照） |

195| `BASH_DEFAULT_TIMEOUT_MS` | Bash または PowerShell ツールコマンドのデフォルトタイムアウト（ミリ秒単位）（デフォルト：120000、または 2 分）。30 分より長いデフォルトは、バックグラウンドコマンドの [デフォルト時間制限](/docs/ja/tools-reference#background-commands) にもなります。バックグラウンド時間制限には Claude Code v2.1.285 以降が必要です |195| `BASH_DEFAULT_TIMEOUT_MS` | Bash または PowerShell ツールコマンドのデフォルトタイムアウト（ミリ秒単位）（デフォルト：120000、または 2 分）。30 分より長いデフォルトは、バックグラウンドコマンドの [デフォルト時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) にもなります。バックグラウンド時間制限には Claude Code v2.1.285 以降が必要です |

196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数（デフォルト：30000；最大：150000）。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を設定した場合、Claude Code はこの変数を無視します。[出力制限](/docs/ja/tools-reference#output-limits) を参照してください |196| `BASH_MAX_OUTPUT_LENGTH` | Claude Code がコマンドの結果に読み込む bash 出力の最大文字数（デフォルト：30000；最大：150000）。[`bashOutputMaxChars`](/docs/ja/settings-reference#bashoutputmaxchars) 設定を設定した場合、Claude Code はこの変数を無視します。[出力制限](/docs/ja/tools-reference#output-limits) を参照してください |

197| `BASH_MAX_TIMEOUT_MS` | モデルが Bash または PowerShell ツールコマンドに設定できる最大タイムアウト（ミリ秒単位）（デフォルト：600000、または 10 分）。有効な上限は、これと `BASH_DEFAULT_TIMEOUT_MS` の大きい方です。有効な上限が 2 時間より長い場合、バックグラウンドコマンドの [最大時間制限](/docs/ja/tools-reference#background-commands) にもなります。バックグラウンド時間制限には Claude Code v2.1.285 以降が必要です |197| `BASH_MAX_TIMEOUT_MS` | モデルが Bash または PowerShell ツールコマンドに設定できる最大タイムアウト（ミリ秒単位）（デフォルト：600000、または 10 分）。有効な上限は、これと `BASH_DEFAULT_TIMEOUT_MS` の大きい方です。有効な上限が 2 時間より長い場合、バックグラウンドコマンドの [最大時間制限](/docs/ja/tools-reference#time-limit-for-background-commands) にもなります。バックグラウンド時間制限には Claude Code v2.1.285 以降が必要です |

198| `BETA_TRACING_ENDPOINT` | [詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) の OTLP エンドポイント：`ENABLE_BETA_TRACING_DETAILED=1` を使用すると、ログとトレースは設定されたエクスポーターではなくそこに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |198| `BETA_TRACING_ENDPOINT` | [詳細ベータトレーシング](/docs/ja/monitoring-usage#traces-beta) の OTLP エンドポイント：`ENABLE_BETA_TRACING_DETAILED=1` を使用すると、ログとトレースは設定されたエクスポーターではなくそこに送信されます。シェル、ユーザー設定、または管理設定で設定します。[プロジェクトおよびローカル設定](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) では無視されます |

199| `CCR_FORCE_BUNDLE` | [`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモートから複製する代わりにローカルリポジトリをバンドルしてアップロードするように強制するには `1` に設定します |199| `CCR_FORCE_BUNDLE` | [`claude --cloud`](/docs/ja/claude-code-on-the-web#send-local-repositories-without-github) がリモートから複製する代わりにローカルリポジトリをバンドルしてアップロードするように強制するには `1` に設定します |

200| `CLAUDECODE` | Claude Code が生成するサブプロセス（Bash および PowerShell ツール、tmux セッション、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) サブプロセス）で `1` に設定されます。IDE 拡張機能は統合ターミナルでもこれを設定します。Claude Code が生成したサブプロセス内でスクリプトが実行されているかどうかを検出するために使用します。Claude Code が開始した stdio MCP サーバー内ではなく、ツール呼び出しまたはフックによって直接生成されたプロセスであるかどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |200| `CLAUDECODE` | Claude Code が生成するサブプロセス（Bash および PowerShell ツール、tmux セッション、[フック](/docs/ja/hooks) コマンド、[ステータスライン](/docs/ja/statusline) コマンド、stdio [MCP サーバー](/docs/ja/mcp) サブプロセス）で `1` に設定されます。IDE 拡張機能は統合ターミナルでもこれを設定します。Claude Code が生成したサブプロセス内でスクリプトが実行されているかどうかを検出するために使用します。Claude Code が開始した stdio MCP サーバー内ではなく、ツール呼び出しまたはフックによって直接生成されたプロセスであるかどうかを確認するには、代わりに `CLAUDE_CODE_CHILD_SESSION` を使用します |

263| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | ファイル [チェックポイント](/docs/ja/checkpointing) を無効にするには `1` に設定します。`/rewind` コマンドはコード変更を復元できません。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定をオーバーライドします |263| `CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING` | ファイル [チェックポイント](/docs/ja/checkpointing) を無効にするには `1` に設定します。`/rewind` コマンドはコード変更を復元できません。[`fileCheckpointingEnabled`](/docs/ja/settings-reference#filecheckpointingenabled) 設定をオーバーライドします |

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

265| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Anthropic API で Opus 4.0 および 4.1 を現在の Opus バージョンに自動的にリマップするのを防ぐには `1` に設定します。古いモデルを意図的にピン留めしたい場合に使用します。リマップは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では実行されません |265| `CLAUDE_CODE_DISABLE_LEGACY_MODEL_REMAP` | Anthropic API で Opus 4.0 および 4.1 を現在の Opus バージョンに自動的にリマップするのを防ぐには `1` に設定します。古いモデルを意図的にピン留めしたい場合に使用します。リマップは Amazon Bedrock、Google Cloud の Agent Platform、または Microsoft Foundry では実行されません |

266| `CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK` | [Amazon Bedrock](/docs/ja/amazon-bedrock#when-a-model-is-disabled-mid-session) および [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai#when-a-model-is-disabled-mid-session) で Claude Code がセッション中にアカウントがモデルへのアクセスを失ったときに古いモデルに切り替わるのを停止するには `1` に設定します。拒否されたリクエストは直ちに失敗します。設定した [フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains) はその拒否で切り替わり、[スタートアップモデルチェック](/docs/ja/amazon-bedrock#startup-model-checks) は引き続き起動時に切り替わります。Claude Code v2.1.285 以降が必要です |

266| `CLAUDE_CODE_DISABLE_MOUSE` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウストラッキングを無効にするには `1` に設定します。`PgUp` および `PgDn` を使用したキーボードスクロールは引き続き機能します。ターミナルのネイティブコピーオンセレクト動作を保持するために使用します |267| `CLAUDE_CODE_DISABLE_MOUSE` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウストラッキングを無効にするには `1` に設定します。`PgUp` および `PgDn` を使用したキーボードスクロールは引き続き機能します。ターミナルのネイティブコピーオンセレクト動作を保持するために使用します |

267| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウスホイールスクロールを保持しながら、クリック、ドラッグ、ホバー処理を無効にするには `1` に設定します。ホイールスクロールが Claude Code 内で機能するが、クリックがカーソルを配置したり、ツール出力を展開したり、リンクを開いたりしないようにしたい場合に使用します。両方が設定されている場合、`CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |268| `CLAUDE_CODE_DISABLE_MOUSE_CLICKS` | [フルスクリーンレンダリング](/docs/ja/fullscreen) でマウスホイールスクロールを保持しながら、クリック、ドラッグ、ホバー処理を無効にするには `1` に設定します。ホイールスクロールが Claude Code 内で機能するが、クリックがカーソルを配置したり、ツール出力を展開したり、リンクを開いたりしないようにしたい場合に使用します。両方が設定されている場合、`CLAUDE_CODE_DISABLE_MOUSE` が優先されます。Claude Code v2.1.195 以降が必要です |

268| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | 接続リセットや TLS ハンドシェイクエラーなどの接続レベルエラーで API リクエストが失敗した場合、Claude Code が [mTLS クライアント証明書とキー](/docs/ja/network-config#mtls-authentication) を再読み込みするのを停止するには `1` に設定します。リロードが無効な場合、Claude Code は回転されたファイルを次に設定を適用するか、次のスタートアップ時にのみ読み込みます。Claude Code v2.1.232 以降が必要です |269| `CLAUDE_CODE_DISABLE_MTLS_RELOAD_ON_STALE_CONNECTION` | 接続リセットや TLS ハンドシェイクエラーなどの接続レベルエラーで API リクエストが失敗した場合、Claude Code が [mTLS クライアント証明書とキー](/docs/ja/network-config#mtls-authentication) を再読み込みするのを停止するには `1` に設定します。リロードが無効な場合、Claude Code は回転されたファイルを次に設定を適用するか、次のスタートアップ時にのみ読み込みます。Claude Code v2.1.232 以降が必要です |

381| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | クライアント側 [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックをスキップするには `1` に設定します。プロキシがチェックのリクエストを拒否するのではなく傍受する場合。API は、組織が高速モードを無効にしている場合、高速モードリクエストを引き続き拒否します |382| `CLAUDE_CODE_SKIP_FAST_MODE_ORG_CHECK` | クライアント側 [高速モード](/docs/ja/fast-mode#use-fast-mode-behind-proxies-and-llm-gateways) 可用性チェックをスキップするには `1` に設定します。プロキシがチェックのリクエストを拒否するのではなく傍受する場合。API は、組織が高速モードを無効にしている場合、高速モードリクエストを引き続き拒否します |

382| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry の Azure 認証をスキップします。プロキシまたはゲートウェイが独自の `Authorization` ヘッダーを挿入する場合。Claude Code は Azure 認証情報なしでリクエストを送信し、例えば `ANTHROPIC_CUSTOM_HEADERS` を通じて提供する `Authorization` ヘッダーを保持します。`ANTHROPIC_FOUNDRY_API_KEY` または `ANTHROPIC_FOUNDRY_AUTH_TOKEN` が設定されている場合は無視されます。v2.1.203 より前は、この変数は API キーも設定されていない限り、Microsoft Foundry クライアントがリクエストを送信できないままにしました |383| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Microsoft Foundry の Azure 認証をスキップします。プロキシまたはゲートウェイが独自の `Authorization` ヘッダーを挿入する場合。Claude Code は Azure 認証情報なしでリクエストを送信し、例えば `ANTHROPIC_CUSTOM_HEADERS` を通じて提供する `Authorization` ヘッダーを保持します。`ANTHROPIC_FOUNDRY_API_KEY` または `ANTHROPIC_FOUNDRY_AUTH_TOKEN` が設定されている場合は無視されます。v2.1.203 より前は、この変数は API キーも設定されていない限り、Microsoft Foundry クライアントがリクエストを送信できないままにしました |

383| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle の AWS 認証をスキップします（例えば、LLM ゲートウェイを使用する場合） |384| `CLAUDE_CODE_SKIP_MANTLE_AUTH` | Amazon Bedrock Mantle の AWS 認証をスキップします（例えば、LLM ゲートウェイを使用する場合） |

385| `CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY` | [スタートアップモデルチェック](/docs/ja/amazon-bedrock#startup-model-checks) が [Amazon Bedrock](/docs/ja/amazon-bedrock) および [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai) でこのマシンで見つかったモデルをアカウントが呼び出せないことを記憶するのを停止するには `1` に設定します。最大 1 日間。Claude Code v2.1.285 以降が必要です |

384| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | プロンプト履歴とセッショントランスクリプトをディスクに書き込むのをスキップするには `1` に設定します。この変数で開始されたセッションは `--resume`、`--continue`、または上矢印履歴に表示されません。一時的なスクリプト化されたセッションに便利です |386| `CLAUDE_CODE_SKIP_PROMPT_HISTORY` | プロンプト履歴とセッショントランスクリプトをディスクに書き込むのをスキップするには `1` に設定します。この変数で開始されたセッションは `--resume`、`--continue`、または上矢印履歴に表示されません。一時的なスクリプト化されたセッションに便利です |

385| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud の Agent Platform の Google 認証をスキップします（例えば、LLM ゲートウェイを使用する場合） |387| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Google Cloud の Agent Platform の Google 認証をスキップします（例えば、LLM ゲートウェイを使用する場合） |

386| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `--output-format stream-json` で開始されたセッションが、スタートアップ失敗の場合、[Claude Code が開始を拒否した理由を名前で示す結果メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込むようにするには `1` に設定します。それ以外の場合は stderr のみで終了します。Claude Code v2.1.274 以降が必要です |388| `CLAUDE_CODE_STARTUP_FAILURE_RESULTS` | `--output-format stream-json` で開始されたセッションが、スタートアップ失敗の場合、[Claude Code が開始を拒否した理由を名前で示す結果メッセージ](/docs/ja/agent-sdk/typescript#startup_failure_reason) を書き込むようにするには `1` に設定します。それ以外の場合は stderr のみで終了します。Claude Code v2.1.274 以降が必要です |

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

332| `Managed settings were not approved; exiting without applying them.` | [設定の警告](#managed-settings-were-not-approved) |332| `Managed settings were not approved; exiting without applying them.` | [設定の警告](#managed-settings-were-not-approved) |

333| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [設定の警告](#managed-settings-block-the-default-model) |333| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [設定の警告](#managed-settings-block-the-default-model) |

334| `Your organization's managed settings allow Claude Code to use: <providers>` | [設定の警告](#managed-settings-dont-allow-this-api-provider) |

335| `Your organization's managed settings allow Claude Code to use no API provider at all` | [設定の警告](#managed-settings-dont-allow-this-api-provider) |

334| `MCP server <name> is blocked by enterprise managed policy` | [設定の警告](#mcp-server-is-blocked-by-enterprise-managed-policy) |336| `MCP server <name> is blocked by enterprise managed policy` | [設定の警告](#mcp-server-is-blocked-by-enterprise-managed-policy) |

335| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [設定の警告](#managed-settings-document-could-not-be-parsed) |337| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [設定の警告](#managed-settings-document-could-not-be-parsed) |

336| `Managed settings drop-in directory could not be read` | [設定の警告](#managed-settings-document-could-not-be-parsed) |338| `Managed settings drop-in directory could not be read` | [設定の警告](#managed-settings-document-could-not-be-parsed) |

339| `Unable to read managed policy settings` | [設定の警告](#unable-to-read-managed-policy-settings) |

337| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [設定の警告](#otelheadershelper-failed) |340| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [設定の警告](#otelheadershelper-failed) |

338| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [設定の警告](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |341| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [設定の警告](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |

339| `headersHelper not run — this workspace has no persisted trust` | [設定の警告](#headershelper-not-run) |342| `headersHelper not run — this workspace has no persisted trust` | [設定の警告](#headershelper-not-run) |

3657 Claude Desktop を開くことができませんでした3660 Claude Desktop を開くことができませんでした

3658</h3>3661</h3>

3659 3662 

3660[`/desktop`](/docs/ja/desktop#coming-from-the-cli)またはそのエイリアス `/app` を実行しましたが、Claude Desktop を開くために Claude Code が使用するシステムコマンドが失敗しました。セッションはターミナルに留まります。3663[`/desktop`](/docs/ja/desktop#coming-from-the-cli)またはそのエイリアス `/app` をセッションで実行しました。または [`claude --desktop`](/docs/ja/cli-reference#cli-flags)をシェルで実行しました。Claude Desktop を開くために Claude Code が使用するシステムコマンドが失敗しました。`/desktop` の後、セッションはターミナルに留まります。`claude --desktop` はメッセージを `Error:` プレフィックスなしで出力し、ステータス 1 で終了します。

3664 

3665括弧内のテキストは失敗したコマンドを示し、その終了ステータスと最初の行のエラー出力（生成された場合）を示します。macOS ではそのコマンドは `open` です。この例のように。Windows では `rundll32` です。

3661 3666 

3662```text theme={null}3667```text theme={null}

3663Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.3668Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.

3664```3669```

3665 3670 

3666**対処方法：**3671**対処方法：**

3667 3672 

3668* Claude Desktop を自分で開いてから、`/desktop` を再度実行してください。3673* Claude Desktop を自分で開いてから、`/desktop` または `claude --desktop` を再度実行してください。

3669* そのコマンドの完全なエラー出力を読むには、`/debug` でデバッグログをオンにし、`/desktop` を再度実行してから、デバッグログを確認してください。3674* 失敗したコマンドの完全なエラー出力を読むには、`/debug` でデバッグログをオンにし、`/desktop` を再度実行するか、`claude --desktop --debug-file <path>` を実行してから、デバッグログを確認してください。

3670 3675 

3671v2.1.275 より前は、メッセージは `Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかを言いませんでした。3676v2.1.285 より前は、メッセージは `Open Claude Desktop and run /desktop again.` で終わりました。v2.1.275 より前は、`Failed to open Claude Desktop. Please try opening it manually.` で、何が失敗したかを言いませんでした。

3672 3677 

3673<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3678<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3674 /terminal-setup は Zed キーマップを変更しませんでした3679 /terminal-setup は Zed キーマップを変更しませんでした

5193* 設定を管理している場合は、ユーザーが実行できるモデルを `availableModels` に追加するか、すべてのフォールバックをブロックする `deniedModels` エントリを絞り込んでください。[特定のモデルまたはバージョンをブロック](/docs/ja/model-config#block-specific-models-or-versions) はデフォルトオプションがどのようにステップダウンするかを説明しています。5198* 設定を管理している場合は、ユーザーが実行できるモデルを `availableModels` に追加するか、すべてのフォールバックをブロックする `deniedModels` エントリを絞り込んでください。[特定のモデルまたはバージョンをブロック](/docs/ja/model-config#block-specific-models-or-versions) はデフォルトオプションがどのようにステップダウンするかを説明しています。

5194* 設定を管理していない場合は、メッセージを管理者に送信してください。独自の設定ファイルは、管理された `availableModels` または `deniedModels` リストを拡大することはできません。5199* 設定を管理していない場合は、メッセージを管理者に送信してください。独自の設定ファイルは、管理された `availableModels` または `deniedModels` リストを拡大することはできません。

5195 5200 

5201<h3 id="managed-settings-dont-allow-this-api-provider">

5202 管理設定がこの API プロバイダーを許可していません

5203</h3>

5204 

5205組織の [管理設定](/docs/ja/managed-settings) は [`allowedProviders`](/docs/ja/settings-reference#allowedproviders) リストを設定し、セッションの API プロバイダーがそれにないか、セッションがそのエントリが要求する方法でピン留めされていないエンドポイントを使用しています。Claude Code はスタートアップ前、ログイン前、またはセッションが次に API に接続するときに拒否します。メッセージは許可されたプロバイダーで始まります。

5206 

5207```text theme={null}

5208Your organization's managed settings allow Claude Code to use: Anthropic API, Amazon Bedrock.

5209```

5210 

5211リストが空の場合、メッセージは代わりに以下のように読みます。

5212 

5213```text theme={null}

5214Your organization's managed settings allow Claude Code to use no API provider at all (allowedProviders is an empty list), so it cannot start on this machine.

5215```

5216 

5217すべてのエントリが認識されない場合、括弧内は `(allowedProviders lists only unrecognized entries)` と読みます。

5218 

5219**対応方法：**

5220 

5221* メッセージの `To continue:` ステップに従ってください。

5222* 設定を管理している場合、メッセージの `Admins:` で始まる行は、追加するエントリまたはピン留めする値に名前を付け、[`allowedProviders`](/docs/ja/settings-reference#allowedproviders) エントリは、どのソースの `env` ブロックがそれをピン留めできるかを示しています。

5223 

5196<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">5224<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">

5197 MCP サーバーはエンタープライズ管理ポリシーによってブロックされています5225 MCP サーバーはエンタープライズ管理ポリシーによってブロックされています

5198</h3>5226</h3>

5246* マシンを管理している場合は、名前が付けられたドキュメントを JSON オブジェクトとして解析するように修正するか、ファイル、プロファイル、またはレジストリ値を削除してください。空の `managed-settings.json` は `{}` としてカウントされ、起動をブロックしません。5274* マシンを管理している場合は、名前が付けられたドキュメントを JSON オブジェクトとして解析するように修正するか、ファイル、プロファイル、またはレジストリ値を削除してください。空の `managed-settings.json` は `{}` としてカウントされ、起動をブロックしません。

5247* そうでない場合は、管理者に、デプロイされたドキュメントを修正するよう依頼してください。独自の設定ファイルの何もこのエラーを引き起こしたり、クリアしたりしません。5275* そうでない場合は、管理者に、デプロイされたドキュメントを修正するよう依頼してください。独自の設定ファイルの何もこのエラーを引き起こしたり、クリアしたりしません。

5248 5276 

5277<h3 id="unable-to-read-managed-policy-settings">

5278 管理ポリシー設定を読み取ることができません

5279</h3>

5280 

5281組織は [管理設定](/docs/ja/managed-settings) をデプロイしており、デプロイされたソースの 1 つが存在しますが、オペレーティングシステムが読み取りを拒否するのではなく、I/O エラーなどの理由で読み取ることができませんでした。他の管理ソースがポリシーを供給していない場合、Claude Code はポリシーが実行される可能性があるソースなしで実行するのではなく、スタートアップで終了します。

5282 

5283```text theme={null}

5284Unable to read managed policy settings.

5285This machine may require organization login enforcement, but the policy file failed to load.

5286Contact your administrator.

5287 

5288Detail: <source>: <reason>

5289```

5290 

5291同じ状態で、サインインフロー、既に実行中のセッションからの API リクエスト、および [`claude gateway`](/docs/ja/claude-apps-gateway) サーバーは、[`allowedProviders`](/docs/ja/settings-reference#allowedproviders) に名前を付ける最初の行のバリアントで拒否されます。

5292 

5293オペレーティングシステムが拒否した読み取り（ルートのみのファイルなど）はこの終了を生成しません。[セッションはそのソースのポリシーなしで開始します](/docs/ja/managed-settings#find-entries-claude-code-dropped)。解析できないソースの場合、Claude Code は [ソースに名前を付ける別のメッセージで終了します](#managed-settings-document-could-not-be-parsed)。

5294 

5295**対応方法：**

5296 

5297* マシンを管理している場合は、`Detail:` 行が名前を付ける問題を修正して、デプロイされたソースを読み取ることができるようにするか、ソースを削除してください。

5298* そうでない場合は、メッセージを管理者に送信してください。独自の設定ファイルの何もこのエラーを引き起こしたり、クリアしたりしません。

5299 

5300v2.1.285 より前では、claude.ai または Claude Console 認証情報でサインインしたセッションのみがこのメッセージで終了し、オペレーティングシステムが拒否した読み取りもそれを生成していました。

5301 

5249<h3 id="otelheadershelper-failed">5302<h3 id="otelheadershelper-failed">

5250 otelHeadersHelper が失敗しました5303 otelHeadersHelper が失敗しました

5251</h3>5304</h3>

5458 応答の品質がいつもより低いように見える5511 応答の品質がいつもより低いように見える

5459</h2>5512</h2>

5460 5513 

5461Claude の回答がいつもより能力が低いように見えるが、エラーが表示されていない場合、原因は通常、モデル自体ではなく会話の状態です。Claude Code はモデルバージョンを静かに変更することはありません。3 つの特定のケースでフォールバックモデルに切り替わることができます。5514Claude の回答がいつもより能力が低いように見えるが、エラーが表示されていない場合、原因は通常、モデル自体ではなく会話の状態です。Claude Code はモデルバージョンを静かに変更することはありません。これらのケースでフォールバックモデルに切り替わることができます。

5462 5515 

5463* 設定された [`--fallback-model`](/docs/ja/cli-reference#cli-flags) は可用性エラーの後、そのターンのみ引き継ぎ、トランスクリプトに通知が表示されます5516* 設定された [`--fallback-model`](/docs/ja/cli-reference#cli-flags) は可用性エラーの後、そのターンのみ引き継ぎ、トランスクリプトに通知が表示されます

5464* Amazon Bedrock または Google Cloud の Agent Platform スタートアップチェックがデフォルトモデルが利用不可であることを検出します5517* Amazon Bedrock または Google Cloud の Agent Platform スタートアップチェックがデフォルトモデルが利用不可であることを検出するか、アカウントが [セッション中にそれへのアクセスを失う](/docs/ja/amazon-bedrock#when-a-model-is-disabled-mid-session)

5465* [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) は Fable 5.1、Fable 5、Opus 5.5、Sonnet 5.5、Opus 5 でセッションをフラグが付いたカテゴリのフォールバックモデルに移動し、そのカテゴリにフォールバックモデルがある場合、トランスクリプトに通知が表示されます5518* [自動モデルフォールバック](/docs/ja/model-config#automatic-model-fallback) は Fable 5.1、Fable 5、Opus 5.5、Sonnet 5.5、Opus 5 でセッションをフラグが付いたカテゴリのフォールバックモデルに移動し、そのカテゴリにフォールバックモデルがある場合、トランスクリプトに通知が表示されます

5466 5519 

5467以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします。最初のケースはトランスクリプト通知として表示され、`/model` の変更ではなく表示されます。[モデル設定](/docs/ja/model-config) は各フォールバックが適用される時期を説明しています。5520以下のモデル選択チェックは 2 番目と 3 番目のケースをキャッチします。最初のケースはトランスクリプト通知として表示され、`/model` の変更ではなく表示されます。[モデル設定](/docs/ja/model-config) は各フォールバックが適用される時期を説明しています。

293 293 

294`opus` などのモデルエイリアスはピンとして機能せず、Claude Code が認識しないモデル ID も同様です。294`opus` などのモデルエイリアスはピンとして機能せず、Claude Code が認識しないモデル ID も同様です。

295 295 

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

297 

298<h3 id="when-a-model-is-disabled-mid-session">

299 セッション中にモデルが無効化された場合

300</h3>

301 

302プロジェクトがセッションで実行しているモデルへのアクセスを失った場合（例えば、管理者が [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)で無効化した場合）、Claude Code は各リクエストが失敗する代わりにセッションを別のモデルに切り替え、`Switched to <fallback> because <model> is not available` を表示します。起動時フォールバックと同じモデルを試します。同じティアの以前のバージョンを最初に試し、Opus セッションで Opus バージョンが利用できない場合は、デフォルト Sonnet モデルを試します。

303 

304切り替えは、ピン留めしていないティアにのみ適用されます。これは起動時フォールバックと同じ条件です。選択した特定のバージョンでのセッションはそのモデルを保持し、フォールバックモデルチェーンがない場合、リクエストは失敗します。[auto モード](/docs/ja/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry)では、Claude Code は Agent Platform で auto モードがサポートするモデルにのみ切り替えます。それらのモデルも利用できない場合、リクエストは失敗します。

305 

306設定した[フォールバックモデルチェーン](/docs/ja/model-config#fallback-model-chains)はティア切り替えを置き換えます。これらの拒否時に Claude Code は設定したフォールバックに切り替えます。拒否されたリクエストが切り替わらずに失敗するようにするには、[`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/ja/env-vars)を設定してください。設定したフォールバックチェーンはこれらの拒否時に切り替わります。すべての拒否されたリクエストが失敗するようにしたい場合は、チェーンも削除してください。

307 

296<h2 id="iam-configuration">308<h2 id="iam-configuration">

297 IAM 設定309 IAM 設定

298</h2>310</h2>

298 ツールを自動承認する298 ツールを自動承認する

299</h3>299</h3>

300 300 

301`--allowedTools` を使用して、Claude が特定のツールをプロンプトなしで使用できるようにします。この例はテストスイートを実行して失敗を修正し、Claude が Bash コマンドを実行してファイルを読み書きできるようにします（権限を求めずに）。301`--allowedTools` を使用して、Claude が特定のツールをプロンプトなしで使用できるようにします。`Read` と `Edit` をリストすると、Claude はファイルを読み書きできます。`Bash` をリストすると、シェルコマンドについても同じことができます。ただし、[auto mode](/docs/ja/permission-modes#how-auto-mode-evaluates-actions) で開始される実行では、Claude Code は広いアロー ルールとして裸の `Bash` エントリをドロップし、auto mode が代わりに各コマンドを評価します。この例はテストスイートを実行して失敗を修正し、これら 3 つのツールをリストします。

302 302 

303```bash theme={null}303```bash theme={null}

304claude -p "Run the test suite and fix any failures" \304claude -p "Run the test suite and fix any failures" \

305 --allowedTools "Bash,Read,Edit"305 --allowedTools "Bash,Read,Edit"

306```306```

307 307 

308個別のツールをリストする代わりにセッション全体のベースラインを設定するには、[permission mode](/docs/ja/permission-modes) を渡します。`-p` の場合、[built-in starting permission mode](/docs/ja/permission-modes#which-mode-a-session-starts-in) はすべてのプランで Manual なので、必要な権限モードを渡します。308個別のツールをリストする代わりにセッション全体のベースラインを設定するには、[permission mode](/docs/ja/permission-modes) を渡します。権限モードを設定しない実行は、[built-in starting permission mode](/docs/ja/permission-modes#which-mode-a-session-starts-in) を取得します。これは `auto` の場合があるため、必要な権限モードを渡します。

309 309 

310* **`auto`**：`--permission-mode auto` を渡して、ほとんどのアクションをあなたの代わりに分類器にレビューさせます310* **`auto`**：`--permission-mode auto` を渡して、ほとんどのアクションをあなたの代わりに分類器にレビューさせます

311* **`dontAsk`**：Claude Code はそれ以外の場合はプロンプトするすべての呼び出しを拒否します。これはロックダウンされた CI 実行に役立ちます。Manual モードで承認が不要なアクション（作業ディレクトリでのファイル読み取りや [read-only command set](/docs/ja/permissions#read-only-commands)）は依然として実行され、`--allowedTools` エントリまたは `permissions.allow` ルールがカバーするアクションも実行されます。`AskUserQuestion`、connector tools [your organization set to `ask`](/docs/ja/mcp#organization-controls-on-connector-tools)、および [`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツールは、許可ルールが一致する場合でも拒否されます311* **`dontAsk`**：Claude Code はそれ以外の場合はプロンプトするすべての呼び出しを拒否します。これはロックダウンされた CI 実行に役立ちます。Manual モードで承認が不要なアクション（作業ディレクトリでのファイル読み取りや [read-only command set](/docs/ja/permissions#read-only-commands)）は依然として実行され、`--allowedTools` エントリまたは `permissions.allow` ルールがカバーするアクションも実行されます。`AskUserQuestion`、connector tools [your organization set to `ask`](/docs/ja/mcp#organization-controls-on-connector-tools)、および [`requiresUserInteraction`](/docs/ja/mcp#require-approval-for-a-specific-tool) とマークされた MCP ツールは、許可ルールが一致する場合でも拒否されます

346* Claude Code にコマンドをバックグラウンドで実行するよう指示する346* Claude Code にコマンドをバックグラウンドで実行するよう指示する

347* `Ctrl+B` を押して、通常の Bash ツール呼び出しをバックグラウンドに移動する。Tmux ユーザーは tmux のプリフィックスキーのため、`Ctrl+B` を 2 回押す必要があります。347* `Ctrl+B` を押して、通常の Bash ツール呼び出しをバックグラウンドに移動する。Tmux ユーザーは tmux のプリフィックスキーのため、`Ctrl+B` を 2 回押す必要があります。

348 348 

349コマンドが完了する前にタイムアウトに達した場合、Claude Code は自動的に[それをバックグラウンドに移動](/docs/ja/tools-reference#background-commands)します。停止する代わりにバックグラウンドに移動します。ただし、コマンドが `sleep` で始まる場合は除きます。コマンドが実行される時間を変更するには、[Bash タイムアウト環境変数](/docs/ja/tools-reference#timeout-and-output-limits)を設定してください。349コマンドが完了する前にタイムアウトに達した場合、Claude Code は自動的に[それをバックグラウンドに移動](/docs/ja/tools-reference#foreground-commands-that-move-to-the-background)します。停止する代わりにバックグラウンドに移動します。ただし、コマンドが `sleep` で始まる場合は除きます。[`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/ja/env-vars#variables)でバックグラウンドタスクをオフにしているか、[ベアモード](/docs/ja/headless#start-faster-with-bare-mode)で開始している場合、コマンドはタイムアウト時に停止します。タイムアウトを変更するには、[Bash タイムアウト環境変数](/docs/ja/tools-reference#timeout-and-output-limits)を設定してください。

350 350 

351**主な機能：**351**主な機能：**

352 352 

358* macOS と Linux では、オペレーティングシステムが重大なメモリプレッシャーを報告する場合、Claude Code はバックグラウンドタスクを停止します。ただし、セッションが少なくとも 30 分間アイドル状態にあり、ターンまたはサブエージェントが実行されていない場合に限ります。Claude Code v2.1.193 以降が必要です358* macOS と Linux では、オペレーティングシステムが重大なメモリプレッシャーを報告する場合、Claude Code はバックグラウンドタスクを停止します。ただし、セッションが少なくとも 30 分間アイドル状態にあり、ターンまたはサブエージェントが実行されていない場合に限ります。Claude Code v2.1.193 以降が必要です

359 * [デバッグログ](/docs/ja/debug-your-config)には、タスクが停止された理由、またはプレッシャーイベントがそれらを実行し続けた理由が記載されています359 * [デバッグログ](/docs/ja/debug-your-config)には、タスクが停止された理由、またはプレッシャーイベントがそれらを実行し続けた理由が記載されています

360 * [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/ja/env-vars)を `1` に設定して、メモリプレッシャー停止をオフにします360 * [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/ja/env-vars)を `1` に設定して、メモリプレッシャー停止をオフにします

361* バックグラウンド Bash および PowerShell コマンドには時間制限があり、コマンドがバックグラウンドに入った時点から数えられます。30 分、またはコマンドがバックグラウンドで開始されるときに Claude が要求する `timeout`（最大 2 時間まで）。例えば `Ctrl+B` で実行中にバックグラウンドに移動するコマンドは、移動から 30 分を取得します。コマンドが制限に達すると、Claude Code はそれを停止し、Claude に理由を伝えます。Claude は、作業がまだ必要な場合、より長い `timeout` で再度開始できます。2 つの環境変数は制限をミリ秒単位で引き上げ、どちらも短縮することはできません。361* バックグラウンド Bash および PowerShell コマンドには時間制限があり、コマンドがバックグラウンドに入った時点から数えられます。30 分、またはコマンドがバックグラウンドで開始されるときに Claude が要求する `timeout`（最大 2 時間まで）。例えば `Ctrl+B` で実行中にバックグラウンドに移動するコマンドは、移動から 30 分を取得します。コマンドが制限に達すると、Claude Code はそれを停止し、Claude に理由を伝えます。Claude は、作業がまだ必要な場合、より長い `timeout` で再度開始できます。制限を引き上げるには、[バックグラウンドコマンドの時間制限を引き上げる](/docs/ja/tools-reference#raise-the-time-limit-for-background-commands)を参照してください。ツール参照を参照してください

362 * [`BASH_DEFAULT_TIMEOUT_MS`](/docs/ja/env-vars)を `1800000` より上に設定して、30 分のデフォルトをその値に置き換えます。移動されたコマンドにも適用されます362* フォアグラウンド[サブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)が開始したバックグラウンドコマンドは、そのサブエージェントの実行が終了するときに終了します。完了、失敗、または中断されたかどうかに関わらず。ツール参照の[バックグラウンドコマンドが停止するとき](/docs/ja/tools-reference#when-a-background-command-stops)を参照してください

363 * [`BASH_MAX_TIMEOUT_MS`](/docs/ja/env-vars)を `7200000` より上に設定して、2 時間の最大値を引き上げます。`BASH_DEFAULT_TIMEOUT_MS` を `7200000` より上に設定すると、同じ方法で引き上げられます

364* フォアグラウンド[サブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)が開始したバックグラウンドコマンドは、そのサブエージェントの実行が終了するときに終了します。完了、失敗、または中断されたかどうかに関わらず。ツール参照の[バックグラウンドコマンド](/docs/ja/tools-reference#background-commands)を参照してください

365 363 

366すべてのバックグラウンドタスク機能を無効にするには、`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` 環境変数を `1` に設定します。詳細は[環境変数](/docs/ja/env-vars)を参照してください。364すべてのバックグラウンドタスク機能を無効にするには、[`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/ja/env-vars#variables)環境変数を `1` に設定してください。[ベアモード](/docs/ja/headless#start-faster-with-bare-mode)で開始することでもオフになります。

367 365 

368**一般的なバックグラウンド実行コマンド：**366**一般的なバックグラウンド実行コマンド：**

369 367 

45 45 

46[組織向けの LLM gateway をロールアウト](/docs/ja/llm-gateway-rollout)では、各ステップを説明し、各ステップで配布する設定ファイルを示しています。ゲートウェイは組織セットアップの 1 つの部分です。ポリシー実施、使用状況の可視性、データ処理の決定については、[組織向けに Claude Code をセットアップ](/docs/ja/admin-setup)を参照してください。46[組織向けの LLM gateway をロールアウト](/docs/ja/llm-gateway-rollout)では、各ステップを説明し、各ステップで配布する設定ファイルを示しています。ゲートウェイは組織セットアップの 1 つの部分です。ポリシー実施、使用状況の可視性、データ処理の決定については、[組織向けに Claude Code をセットアップ](/docs/ja/admin-setup)を参照してください。

47 47 

48`ANTHROPIC_BASE_URL` を通じて到達するゲートウェイを、管理対象マシンが使用できる唯一の宛先にするには、同じ管理設定ファイルで [`allowedProviders`](/docs/ja/settings-reference#allowedproviders) を `["customEndpoint"]` に設定し、ゲートウェイの `ANTHROPIC_BASE_URL` をそのファイルの `env` ブロックに配置します。Claude Code はその後、Anthropic に直接接続する場合や開発者独自のプロキシを含む他の場所を指すセッションを拒否し、`ANTHROPIC_BASE_URL` をそこに設定した値でのみ受け入れます。`ANTHROPIC_BEDROCK_BASE_URL` などのプロバイダー固有のエンドポイント変数を通じて到達するゲートウェイの場合、`allowedProviders` エントリはどの変数をピン留めするかを指定します。Claude Code v2.1.285 以降が必要です。

49 

48<h2 id="subscriptions-and-gateways">50<h2 id="subscriptions-and-gateways">

49 サブスクリプションとゲートウェイ51 サブスクリプションとゲートウェイ

50</h2>52</h2>

321 321 

322* **隠れた空白**: Claude Code は MCP 設定値が隠れた先頭または末尾の空白を持つときに警告します。これはしばしば末尾の改行を持つトークンを貼り付けることから来ます。Claude Code は `command`、`url`、各 `args` エントリ、および `env` と `headers` の下の値とキー名をチェックします。Claude Code は警告を `claude mcp list` 出力と `/mcp` に表示し、影響を受けたフィールドに名前を付けます。例えば `Leading or trailing whitespace in: headers.Authorization`。Claude Code は空白をトリムしません。書き込まれたとおりに値を使用するため、設定を編集してそれを削除してください。322* **隠れた空白**: Claude Code は MCP 設定値が隠れた先頭または末尾の空白を持つときに警告します。これはしばしば末尾の改行を持つトークンを貼り付けることから来ます。Claude Code は `command`、`url`、各 `args` エントリ、および `env` と `headers` の下の値とキー名をチェックします。Claude Code は警告を `claude mcp list` 出力と `/mcp` に表示し、影響を受けたフィールドに名前を付けます。例えば `Leading or trailing whitespace in: headers.Authorization`。Claude Code は空白をトリムしません。書き込まれたとおりに値を使用するため、設定を編集してそれを削除してください。

323* **複数のスコープで同じ名前**: 異なるエンドポイントで複数の [スコープ](#mcp-installation-scopes) で同じサーバー名を定義する場合、Claude Code は `claude mcp list` 出力と `/mcp` で競合について警告します。Claude Code は OAuth サインインをエンドポイントごとに保存するため、1 つのプロジェクトで読み込まれる定義を認証すると、別の定義が読み込まれるプロジェクトで別にサインインする必要があります。必要なエンドポイントを保持し、他を `claude mcp remove <name> --scope <scope>` で削除してください。警告では、Claude Code は各スコープのエンドポイントを設定に書き込まれたとおりに引用します。[`${VAR}` 参照](#environment-variable-expansion-in-mcp-json) は展開されないため、API キーなどの解決された値を表示しません。323* **複数のスコープで同じ名前**: 異なるエンドポイントで複数の [スコープ](#mcp-installation-scopes) で同じサーバー名を定義する場合、Claude Code は `claude mcp list` 出力と `/mcp` で競合について警告します。Claude Code は OAuth サインインをエンドポイントごとに保存するため、1 つのプロジェクトで読み込まれる定義を認証すると、別の定義が読み込まれるプロジェクトで別にサインインする必要があります。必要なエンドポイントを保持し、他を `claude mcp remove <name> --scope <scope>` で削除してください。警告では、Claude Code は各スコープのエンドポイントを設定に書き込まれたとおりに引用します。[`${VAR}` 参照](#environment-variable-expansion-in-mcp-json) は展開されないため、API キーなどの解決された値を表示しません。

324* **予約名**: Claude Code は `workspace`、`claude-in-chrome`、`computer-use`、`Claude Preview`、`Claude Browser` を含む組み込みサーバーの名前を予約しています。設定が予約名を持つサーバーを定義する場合、Claude Code はロード時にそれをスキップし、名前を変更するよう求める警告を表示します。`claude mcp add` は予約名を拒否します。`Claude Preview` と `Claude Browser` は両方とも [Claude Code デスクトップアプリのプレビューペイン](/docs/ja/desktop#preview-your-app) が使用する組み込みサーバーに名前を付けます。v2.1.205 より前では、`Claude Browser` は予約されていなかったため、ユーザー設定サーバーはその名前で登録できました。324* **予約名**: Claude Code は `workspace`、`claude-in-chrome`、`computer-use`、`Claude Preview`、`Claude Browser` を含む組み込みサーバーの名前を予約しています。設定が予約名を持つサーバーを定義する場合、Claude Code はロード時にそれをスキップし、名前を変更するよう求める警告を表示します。`claude mcp add` は予約名を拒否します。`Claude Preview` と `Claude Browser` は両方とも [Claude Code デスクトップアプリのプレビューペイン](/docs/ja/desktop#preview-your-app) が使用する組み込みサーバーに名前を付けます。

325* **環境変数の欠落**: サーバーの設定の [`${VAR}` 参照](#environment-variable-expansion-in-mcp-json) が設定されていない変数に名前を付け、`:-default` がない場合、Claude Code は `claude mcp list` 出力と `/mcp` で警告し、変数に名前を付けます。`${VAR}` テキストは展開されないままサーバーを読み込みます。変数を設定するか、`${VAR:-default}` フォールバックを追加してください。リモートサーバーの `url` と `headers` では、一部の認証情報変数 [空として読み込まれます](#credential-variables-that-read-as-empty) 代わりに、警告なしで。325* **環境変数の欠落**: サーバーの設定の [`${VAR}` 参照](#environment-variable-expansion-in-mcp-json) が設定されていない変数に名前を付け、`:-default` がない場合、Claude Code は `claude mcp list` 出力と `/mcp` で警告し、変数に名前を付けます。`${VAR}` テキストは展開されないままサーバーを読み込みます。変数を設定するか、`${VAR:-default}` フォールバックを追加してください。リモートサーバーの `url` と `headers` では、一部の認証情報変数 [空として読み込まれます](#credential-variables-that-read-as-empty) 代わりに、警告なしで。

326 326 

327<h4 id="tool-availability">327<h4 id="tool-availability">

553 553 

554プラグインサーバーは `/mcp` に表示され、プラグインから来ることを示すインジケータが付きます。554プラグインサーバーは `/mcp` に表示され、プラグインから来ることを示すインジケータが付きます。

555 555 

556プラグインの stdio サーバーの場合、`claude mcp get` は `Command: stdio`、空の `Args:` 行、および各環境変数を `NAME=[REDACTED]` として出力します。値は認証情報を運ぶことができるため、隠されています。

557 

556**プラグイン MCP ツール名**：558**プラグイン MCP ツール名**：

557 559 

558プラグインにバンドルされた MCP サーバーからのツールは、呼び出し可能な名前にプラグイン名とサーバーキーの両方を含めます。完全な形式は `mcp__plugin_<plugin-name>_<server-name>__<tool-name>` です。`A-Z`、`a-z`、`0-9`、`_`、`-` の外の任意の文字は `_` に置き換えられます。`my-plugin` という名前のプラグインにバンドルされた `database-tools` サーバーの場合、`query` ツールは以下のように呼び出し可能です。560プラグインにバンドルされた MCP サーバーからのツールは、呼び出し可能な名前にプラグイン名とサーバーキーの両方を含めます。完全な形式は `mcp__plugin_<plugin-name>_<server-name>__<tool-name>` です。`A-Z`、`a-z`、`0-9`、`_`、`-` の外の任意の文字は `_` に置き換えられます。`my-plugin` という名前のプラグインにバンドルされた `database-tools` サーバーの場合、`query` ツールは以下のように呼び出し可能です。

360 360 

361 次に起こることは、問題がどこにあるかを示します。361 次に起こることは、問題がどこにあるかを示します。

362 362 

363 * コマンドが開始され、入力を待ちます。サーバー自体は機能しています。`claude mcp get <name>` を実行し、そこに表示されるコマンドが実行したばかりのコマンドと一致することを確認します。表示されるコマンドが入力したものと異なる場合、サーバーコマンドの前に `--` セパレーターを省略した可能性があります。サーバーを削除し、`--` を配置して再度追加します。`.mcp.json` を手で書いた場合は、その構文と場所を確認します。363 * コマンドが開始され、入力を待ちます。サーバー自体は機能しています。

364 

365 `claude mcp get <name>` を実行し、そこに表示されるコマンドが実行したばかりのコマンドと一致することを確認します。表示されるコマンドが入力したものと異なる場合、サーバーコマンドの前に `--` セパレーターを省略した可能性があります。サーバーを削除し、`--` を配置して再度追加します。`.mcp.json` を手で書いた場合は、その構文と場所を確認します。v2.1.285 より前は、`claude mcp get` は `type` フィールドなしで保存された stdio エントリ（手書きの `.mcp.json` エントリなど）に対して `Command` 行を出力しませんでした。これらのバージョンでは、代わりに `claude mcp list` を実行します。これはどちらの方法でもコマンドラインを出力します。

364 * コマンドエラー：メッセージは Node.js やブラウザなど、不足しているものに名前を付けます。366 * コマンドエラー：メッセージは Node.js やブラウザなど、不足しているものに名前を付けます。

365 </Accordion>367 </Accordion>

366 368 

1430* `error.type`: Claude Code がセッションを停止した理由。`refused` イベントでのみ存在。1430* `error.type`: Claude Code がセッションを停止した理由。`refused` イベントでのみ存在。

1431 * `"helper_failed"`: [ポリシーヘルパー実行が失敗](/docs/ja/settings-reference#helper-failures)1431 * `"helper_failed"`: [ポリシーヘルパー実行が失敗](/docs/ja/settings-reference#helper-failures)

1432 * `"policy_invalid"`: 管理設定に Claude Code が開始するのを停止するエラーが含まれるか、管理ソースが読み込みに失敗したため、Claude Code は組織ログイン強制を確認できません1432 * `"policy_invalid"`: 管理設定に Claude Code が開始するのを停止するエラーが含まれるか、管理ソースが読み込みに失敗したため、Claude Code は組織ログイン強制を確認できません

1433 * `"provider_not_allowed"`: セッションが API プロバイダーを使用するか、プロバイダーのトラフィックをホストに送信するため、管理 [`allowedProviders`](/docs/ja/settings-reference#allowedproviders) リストが許可しません。Claude Code v2.1.285 以降が必要

1433 * `"consent_rejected"`: ユーザーがサーバー管理設定の[セキュリティ承認ダイアログ](/docs/ja/server-managed-settings#security-approval-dialogs)を拒否1434 * `"consent_rejected"`: ユーザーがサーバー管理設定の[セキュリティ承認ダイアログ](/docs/ja/server-managed-settings#security-approval-dialogs)を拒否

1434 * `"force_refresh_failed"`: [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh) が必要とする設定フェッチが失敗1435 * `"force_refresh_failed"`: [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh) が必要とする設定フェッチが失敗

1435 * `"gateway_rejected"`: [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway)が管理設定ロードに HTTP 403 で応答1436 * `"gateway_rejected"`: [Claude アプリゲートウェイ](/docs/ja/claude-apps-gateway)が管理設定ロードに HTTP 403 で応答

86| Claude Code の実行方法 | 組み込み開始権限モード |86| Claude Code の実行方法 | 組み込み開始権限モード |

87| :- | :- |87| :- | :- |

88| 設定ファイルが `disableAutoMode` を `"disable"` に設定 | `default` |88| 設定ファイルが `disableAutoMode` を `"disable"` に設定 | `default` |

89| `claude -p` または [Agent SDK](/docs/ja/agent-sdk/permissions) | `default` |89| `claude -p`、または [Python Agent SDK](/docs/ja/agent-sdk/python#claudeagentoptions)（`permission_mode` なし） | [フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)するセッションでは `default`。テレメトリがオフの場合やサードパーティプロバイダーなど、フィーチャーフラグを取得しないセッションでは、Claude Code v2.1.285 以降では `auto`、以前のバージョンでは `default` |

90| ターミナルまたは [VS Code 拡張機能](/docs/ja/vs-code)を通じて | `auto`（Claude Code v2.1.283 以降）。以前のバージョンでは、Pro、Max、または Team プランで [フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)するセッションでは `auto`、それ以外は `default` |90| ターミナルまたは [VS Code 拡張機能](/docs/ja/vs-code)を通じて | `auto`（Claude Code v2.1.283 以降）。以前のバージョンでは、Pro、Max、または Team プランで [フィーチャーフラグを取得](/docs/ja/env-vars#features-that-need-feature-flag-fetching)するセッションでは `auto`、それ以外は `default` |

91 91 

92[インストールまたはアップグレード後の最初のセッション](/docs/ja/env-vars#first-session-after-an-install-or-upgrade)では、Claude Code はフィーチャーフラグが到達する前に開始権限モードを選択できます。そのセッションは表が示すものとは異なる権限モードで開始する可能性があり、次のセッションは表に一致します。92[インストールまたはアップグレード後の最初のセッション](/docs/ja/env-vars#first-session-after-an-install-or-upgrade)では、Claude Code はフィーチャーフラグが到達する前に開始権限モードを選択できます。そのセッションは表が示すものとは異なる権限モードで開始する可能性があり、次のセッションは表に一致します。

98* ターミナルでは、セッションの上部に 1 回98* ターミナルでは、セッションの上部に 1 回

99* VS Code 拡張機能では、新しい会話画面のカードとして、却下するまで表示されます99* VS Code 拡張機能では、新しい会話画面のカードとして、却下するまで表示されます

100 100 

101Pro、Max、Team プランでは、`~/.claude/settings.json` が `auto` 以外の `defaultMode` を設定し、他の設定ファイルが設定しない場合、セッションはそのモードで開始し続けます。Claude Code はターミナルまたは VS Code 拡張機能で 1 回、設定を auto モードに変更するかどうかを尋ねます。却下した場合、設定はそのままです。101`~/.claude/settings.json` が `auto` 以外の `defaultMode` を設定し、他の設定ファイルが設定しない場合、Pro、Max、Team プランおよび [フィーチャーフラグを取得しない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッションでは、セッションはそのモードで開始し続けます。Claude Code はターミナルまたは VS Code 拡張機能で 1 回、設定を auto モードに変更するかどうかを尋ねます。却下した場合、設定はそのままです。

102 102 

103<h3 id="start-in-a-different-mode">103<h3 id="start-in-a-different-mode">

104 異なる権限モードで開始する104 異なる権限モードで開始する

322 Bedrock、Agent Platform、または Foundry での auto モード322 Bedrock、Agent Platform、または Foundry での auto モード

323</h3>323</h3>

324 324 

325[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、およびサインイン済みの[Claude apps gateway](/docs/ja/claude-apps-gateway)セッションでは、auto モードはデフォルトで利用可能です。Claude Code v2.1.283 以降では、インタラクティブターミナルと[VS Code](/docs/ja/vs-code)セッションの[組み込みの開始権限モード](#which-mode-a-session-starts-in)でもあります。開始権限モードを自分で選択するには、[別の権限モードで開始](#start-in-a-different-mode)で説明されているように `permissions.defaultMode` を設定するか、VS Code 拡張機能のモード指示器から権限モードを選択します。325[Amazon Bedrock](/docs/ja/amazon-bedrock)、[Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)、[Microsoft Foundry](/docs/ja/microsoft-foundry)、およびサインイン済みの[Claude apps gateway](/docs/ja/claude-apps-gateway)セッションでは、auto モードはデフォルトで利用可能です。何も権限モードを設定しない場合、これらのプロバイダーでは、インタラクティブターミナルと VS Code セッションの[組み込みの開始権限モード](#which-mode-a-session-starts-in)でもあります。開始権限モードを自分で選択するには、[別の権限モードで開始](#start-in-a-different-mode)で説明されているように `permissions.defaultMode` を設定するか、VS Code 拡張機能のモード指示器から権限モードを選択します。

326 326 

327これらのプロバイダーでは、Claude Sonnet 5 以降、Opus 4.7 以降、および Fable モデルのみがサポートされています。他のモデルでは、セッションは代わりに Manual で開始します。327これらのプロバイダーでは、Claude Sonnet 5 以降、Opus 4.7 以降、および Fable モデルのみがサポートされています。他のモデルでは、セッションは代わりに Manual で開始します。

328 328 

29すべてのサブコマンドは、これらの終了コード、プラグイン引数、およびスコープ値を共有します：29すべてのサブコマンドは、これらの終了コード、プラグイン引数、およびスコープ値を共有します：

30 30 

31* **終了コード**: 成功時は `0`、失敗時は `1`。`validate` は予期しないエラーに対して終了 `2` を追加し、`eval` は[そのセクション](#plugin-eval)にリストされたコードを追加します。31* **終了コード**: 成功時は `0`、失敗時は `1`。`validate` は予期しないエラーに対して終了 `2` を追加し、`eval` は[そのセクション](#plugin-eval)にリストされたコードを追加します。

32* **プラグイン引数**: `<plugin>` 引数はプラグイン `name` または `name@marketplace` です。2 つのマーケットプレイスが同じ名前を提供する場合は、修飾形式を使用してください。32* **プラグイン引数**: `<plugin>` 引数はプラグイン `name` または `name@marketplace` です。2 つのマーケットプレイスが同じ名前を提供する場合は、修飾形式を使用してください。`configure` は修飾形式のみを取ります。

33* **スコープ**: `--scope` は `user`、`project`、または `local` を取り、コマンドが書き込む設定ファイルに名前を付けます。`update` は `managed` も取ります。33* **スコープ**: `--scope` は `user`、`project`、または `local` を取り、コマンドが書き込む設定ファイルに名前を付けます。`update` は `managed` も取ります。

34 34 

35<h3 id="plugin-init">35<h3 id="plugin-init">

87| フラグ | 説明 |87| フラグ | 説明 |

88| :- | :- |88| :- | :- |

89| `-s, --scope <scope>` | インストールスコープ: `user`、`project`、または `local`。デフォルトは `user` |89| `-s, --scope <scope>` | インストールスコープ: `user`、`project`、または `local`。デフォルトは `user` |

90| `--config <key=value>` | プラグインのマニフェストが宣言する [`userConfig`](/docs/ja/plugins/manifest-reference) オプションを設定します。各オプションについてフラグを繰り返します。Claude Code v2.1.147 以降が必要です |90| `--config <key=value>` | プラグインのマニフェストが宣言する [`userConfig`](/docs/ja/plugins/manifest-reference) オプションを設定します。各オプションについてフラグを繰り返します。Claude Code v2.1.147 以降が必要です。`<server>.<key>` として書かれたキーは、プラグイン内に同梱されたバンドルファイルの[バンドル MCP サーバー](/docs/ja/plugins/components#include-a-packaged-mcpb-server)が独自の `user_config` で宣言する設定を設定します。`<server>.<key>` 形式には Claude Code v2.1.285 以降が必要です |

91| `-y, --yes` | `Run this command now?` プロンプトなしで表示されたインストールコマンドを受け入れます。Bash ツールまたはフックからなど、Claude Code セッション内で実行されるコマンドでは無視されます。Claude Code v2.1.229 以降が必要です |91| `-y, --yes` | `Run this command now?` プロンプトなしで表示されたインストールコマンドを受け入れます。Bash ツールまたはフックからなど、Claude Code セッション内で実行されるコマンドでは無視されます。Claude Code v2.1.229 以降が必要です |

92| `--accept-command <sha256>` | 前の [`--json` 実行](#plugin-json-result)が `shownCommand` で報告した `sha256` を持つ表示されたインストールコマンドを受け入れます。`-y` の代わりに使用します。`-y` と組み合わせることはできません。[表示されたインストールコマンドを受け入れる](#accept-a-displayed-install-command)を参照してください。Claude Code v2.1.271 以降が必要です |92| `--accept-command <sha256>` | 前の [`--json` 実行](#plugin-json-result)が `shownCommand` で報告した `sha256` を持つ表示されたインストールコマンドを受け入れます。`-y` の代わりに使用します。`-y` と組み合わせることはできません。[表示されたインストールコマンドを受け入れる](#accept-a-displayed-install-command)を参照してください。Claude Code v2.1.271 以降が必要です |

93| `--json` | スクリプトで使用するために、人間が読める形式のメッセージの代わりに、stdout の最後の行に 1 つの JSON オブジェクトとして結果を出力します。[JSON 結果形式](#plugin-json-result)を参照してください。Claude Code v2.1.268 以降が必要です |93| `--json` | スクリプトで使用するために、人間が読める形式のメッセージの代わりに、stdout の最後の行に 1 つの JSON オブジェクトとして結果を出力します。[JSON 結果形式](#plugin-json-result)を参照してください。Claude Code v2.1.268 以降が必要です |

293| :- | :- |293| :- | :- |

294| `--json` | リストを JSON として出力 |294| `--json` | リストを JSON として出力 |

295| `--available` | マーケットプレイスが提供するがインストールしていないプラグインもリストします。`--json` なしでは効果がありません |295| `--available` | マーケットプレイスが提供するがインストールしていないプラグインもリストします。`--json` なしでは効果がありません |

296| `--data-size [plugin]` | 各インストール済みプラグインの[保存されたデータディレクトリ](#what-an-uninstall-deletes-and-keeps)を測定するか、`name@marketplace` として指定された名前付きプラグインのみを測定します。`--json` なしでは効果がありません。名前にインストールレコードがない場合、コマンドは `--data-size names a plugin that is not installed` を出力し、リストの代わりに `1` で終了します。Claude Code v2.1.285 以降が必要です |

296 297 

297Claude Code は、各プラグインがどのようにロードされるかでグループ化された人間が読める出力を出力します：298Claude Code は、各プラグインがどのようにロードされるかでグループ化された人間が読める出力を出力します：

298 299 

324| `notes` | 文字列の配列 | ロードして機能するプラグインのオーサリング警告 |325| `notes` | 文字列の配列 | ロードして機能するプラグインのオーサリング警告 |

325| `errorDetails` | オブジェクトの配列 | 各 `errors` エントリごとに 1 つのオブジェクト。診断 `type` と、プラグイン、マーケットプレイス、サーバー、またはファイルなど、それが参照する名前を提供します。Claude Code v2.1.268 以降が必要です |326| `errorDetails` | オブジェクトの配列 | 各 `errors` エントリごとに 1 つのオブジェクト。診断 `type` と、プラグイン、マーケットプレイス、サーバー、またはファイルなど、それが参照する名前を提供します。Claude Code v2.1.268 以降が必要です |

326| `noteDetails` | オブジェクトの配列 | 各 `notes` エントリの同じ詳細オブジェクト。Claude Code v2.1.268 以降が必要です |327| `noteDetails` | オブジェクトの配列 | 各 `notes` エントリの同じ詳細オブジェクト。Claude Code v2.1.268 以降が必要です |

328| `hasUserConfig` | ブール値 | プラグインがロードされ、そのマニフェストが [`userConfig` オプション](/docs/ja/plugins/manifest-reference#user-configuration)を宣言する場合に存在し、`true`。ロードに失敗したプラグインの場合は存在しません。マニフェストが何を宣言しても。保存された値は含まれません。Claude Code v2.1.285 以降が必要です |

329| `projectEnabled` | ブール値 | プロジェクトの共有 `.claude/settings.json` がプラグインをオンにするかどうか。マーケットプレイスインストールのみ。Claude Code v2.1.285 以降が必要です |

330| `dataDirSize` | オブジェクト | `--data-size` を使用すると、プラグインの[保存されたデータディレクトリ](#what-an-uninstall-deletes-and-keeps)のサイズが `bytes` および `human` として表示されます。ディレクトリが見つからないか空の場合は存在しません。マーケットプレイスインストールのみ。Claude Code v2.1.285 以降が必要です |

331| `dataDirUnreadable` | ブール値 | `--data-size` を使用すると、保存されたデータディレクトリが存在するが測定できない場合は `true`。マーケットプレイスインストールのみ。Claude Code v2.1.285 以降が必要です |

327 332 

328`--json --available` を使用すると、Claude Code は配列の代わりに 1 つのオブジェクトを出力します。その `installed` フィールドはインストール済みプラグインオブジェクトの配列を保持し、その `available` フィールドはインストールされていない各マーケットプレイスプラグインを以下のフィールドを持つオブジェクトとして保持します。333`--json --available` を使用すると、Claude Code は配列の代わりに 1 つのオブジェクトを出力します。その `installed` フィールドはインストール済みプラグインオブジェクトの配列を保持し、その `available` フィールドはインストールされていない各マーケットプレイスプラグインを以下のフィールドを持つオブジェクトとして保持します。

329 334 

367 372 

368ロードされていないプラグインの場合、Claude Code は ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` を出力し、`1` で終了します。373ロードされていないプラグインの場合、Claude Code は ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` を出力し、`1` で終了します。

369 374 

375<h3 id="plugin-configure">

376 plugin configure

377</h3>

378 

379インストール済みプラグインの [`userConfig`](/docs/ja/plugins/manifest-reference#user-configuration) オプションを表示し、どれが設定されているか、または stdin でパイプされた値を保存します。Claude Code v2.1.285 以降が必要です。

380 

381```bash theme={null}

382claude plugin configure <plugin>

383```

384 

385| フラグ | 説明 |

386| :- | :- |

387| `--values-stdin` | stdin から JSON オブジェクトとしてオプション値を読み込み、保存します。省略したオプションは保存された値を保持します |

388| `--json` | stdout に 1 つの JSON オブジェクトとして結果を出力します。`--values-stdin` なしで、オブジェクトはオプションの `schema` と `choices`、開始 `inputs`、および `configured` と `unconfigured` オプション名を含みます。`--values-stdin` を使用すると、`saved` オプション名と、読み込める場合は `unconfigured` オプション名を含みます |

389 

390フラグなしで、コマンドは各オプションを最大 3 つのラベルでリストします：`required` または `optional`、その後マニフェストが機密として宣言するオプションの場合は `sensitive`、その後 `set` または `not set`。保存された値は出力されません。`--json` を使用すると、出力には機密でないオプションの保存された値が含まれ、機密オプションのテキストは含まれません。

391 

392値を保存するには、JSON オブジェクトとしてファイルに書き込み、オプションキーを文字列値にマップし、ファイルを stdin で渡します。`formatter@my-marketplace` を `claude plugin list` が表示するプラグインの id に置き換えます。この例は、`{"api_url": "https://example.com"}` を含むファイル `values.json` から `api_url` という名前の 1 つのオプションを設定します：

393 

394```bash theme={null}

395claude plugin configure formatter@my-marketplace --values-stdin < values.json

396```

397 

398Claude Code は各値をオプションの宣言された型に対して検証し、`Configuration saved. Restart Claude Code to apply it.` を出力します。マニフェストが宣言しないキーを渡すか、検証に失敗する値を渡す場合、コマンドは何も保存せず、`Failed to save configuration:` を理由と共に出力し、`1` で終了します。`--json` を使用すると、拒否された値は `message` を含む `refused` フィールドを持つ stdout のオブジェクトも出力し、1 つのオプションが原因の場合はその `option` キーを含みます。

399 

400`claude plugin list` が表示するプラグインの完全な `name@marketplace` id を渡します。`configure` はベア `name` を受け入れません。ロードされたプラグインにそのような id がない場合、コマンドは `No installed plugin has the id "<plugin>".` を出力し、`1` で終了します。

401 

402バンドル MCP サーバーの設定については、[`plugin install --config`](#plugin-install) または `/plugin` の **Configure** 項目を参照してください。

403 

370<h3 id="plugin-prune">404<h3 id="plugin-prune">

371 plugin prune405 plugin prune

372</h3>406</h3>

868 868 

869サーバーはバンドルのマニフェストの `name` からその名前を取ります。869サーバーはバンドルのマニフェストの `name` からその名前を取ります。

870 870 

871バンドルのマニフェスト自体は、サーバーがユーザーから必要とする設定を `user_config` ブロックで宣言できます。保存された値がない必須設定を持つバンドルされたサーバーは開始されません。`/plugin` **Errors** タブは `Bundled MCP server "<name>" was not started: it needs configuration` を表示します。

872 

873ユーザーは 2 つの方法のいずれかで値を提供します。

874 

875* **`/plugin` で**: **Installed** タブでプラグインを選択し、**Configure** を選択します。

876* **インストール時、シェルから**: `claude plugin install` に [`--config <server>.<key>=<value>`](/docs/ja/plugins/cli-reference#plugin-install) を渡します。Claude Code v2.1.285 以降が必要で、プラグイン内にパッケージ化されたバンドルに対してのみ機能します。

877 

871トランスポートと認証については、[MCP](/docs/ja/mcp#plugin-provided-mcp-servers) を参照してください。878トランスポートと認証については、[MCP](/docs/ja/mcp#plugin-provided-mcp-servers) を参照してください。

872 879 

873<h3 id="lsp-servers">880<h3 id="lsp-servers">

1071 設定ダイアログが表示されるとき1078 設定ダイアログが表示されるとき

1072</h3>1079</h3>

1073 1080 

1074ダイアログは対話型の `/plugin` インターフェースにのみ表示されます。ユーザーが以下のいずれかを実行したときに、まだ設定されていないオプションに対して開きます。1081ダイアログは対話型の `/plugin` インターフェースの一部です。ユーザーが以下のいずれかを実行したときに、まだ設定されていないオプションに対して開きます。

1075 1082 

1076* `/plugin` でプラグインをインストールする1083* `/plugin` でプラグインをインストールする

1077* セッション内で `/plugin install <plugin>@<marketplace>` を実行する1084* セッション内で `/plugin install <plugin>@<marketplace>` を実行する

1079 1086 

1080ユーザーがいつでも同じダイアログを開くには、`/plugin configure <plugin>@<marketplace>` を実行します。1087ユーザーがいつでも同じダイアログを開くには、`/plugin configure <plugin>@<marketplace>` を実行します。

1081 1088 

1082`claude plugin install` シェルコマンドは `userConfig` 値のプロンプトを表示しません。シェルから値を設定するには、各値を `--config KEY=VALUE` として渡します。オプションが設定されていない場合、コマンドは `userConfig options not yet set` という行を出力し、それらを設定する両方の方法を示します。[`userConfig` ダイアログが表示されない](/docs/ja/plugins/troubleshooting#the-userconfig-dialog-never-appears)場合、その行が引用されます。1089VS Code 拡張機能の [プラグイン管理ダイアログ](/docs/ja/vs-code#install-plugins)は、インストール後にフォームとして未設定のオプションを求め、プラグインの行のギアアイコンはすべてのオプションを含むフォームを再度開きます。

1090 

1091`claude plugin install` シェルコマンドは `userConfig` 値のプロンプトを表示しません。シェルから値を設定するには、インストール時に各値を `--config KEY=VALUE` として渡すか、その後 [`claude plugin configure --values-stdin`](/docs/ja/plugins/cli-reference#plugin-configure) にJSON オブジェクトをパイプします。

1092 

1093オプションが設定されていない場合、`claude plugin install` は `userConfig options not yet set` という行を出力します。その行の正確なテキストについては、[`userConfig` ダイアログが表示されない](/docs/ja/plugins/troubleshooting#the-userconfig-dialog-never-appears)を参照してください。

1083 1094 

1084オプションフィールド、各値が保存される場所、コンポーネントが保存された値を参照する方法、および `${user_config.*}` を拒否するフィールドについては、[ユーザー設定](/docs/ja/plugins/manifest-reference#user-configuration)を参照してください。1095オプションフィールド、各値が保存される場所、コンポーネントが保存された値を参照する方法、および `${user_config.*}` を拒否するフィールドについては、[ユーザー設定](/docs/ja/plugins/manifest-reference#user-configuration)を参照してください。

1085 1096 

72 概要の最後の文は、このセッションでプラグインが使用可能かどうかを示しています。72 概要の最後の文は、このセッションでプラグインが使用可能かどうかを示しています。

73 73 

74 * **Active now**: `Plugin is now active.` リロードは不要です。74 * **Active now**: `Plugin is now active.` リロードは不要です。

75 * **Active, but a server needs setup**: `Plugin is now active.` の後に `Its bundled MCP server needs configuration before it can start` が続きます。プラグインの[バンドルされた MCP サーバー](/docs/ja/plugins/components#include-a-packaged-mcpb-server)は、オプションを設定するまで開始できません。`/plugin` の **Installed** タブでプラグインを選択し、**Configure** を選択してサーバーのオプションを設定します。

75 * **Reload needed**: `Run /reload-plugins to activate.` パネルが閉じ、Claude Code がそのリロードを実行します。リロードが[プロンプトキャッシュを無効化](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)する場合、警告が表示され、代わりにプラグインは保留中のままになります。`/reload-plugins --force` を実行してアクティブ化すると、キャッシュされていない 1 つのリクエストがかかります。76 * **Reload needed**: `Run /reload-plugins to activate.` パネルが閉じ、Claude Code がそのリロードを実行します。リロードが[プロンプトキャッシュを無効化](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)する場合、警告が表示され、代わりにプラグインは保留中のままになります。`/reload-plugins --force` を実行してアクティブ化すると、キャッシュされていない 1 つのリクエストがかかります。

76 * **Load failed**: `The plugin couldn't be loaded`。`/plugin` の **Errors** タブを開いて理由を確認し、[インストール後: プラグインが機能しない](/docs/ja/plugins/troubleshooting#plugin-installed-but-not-working)を参照してください。77 * **Load failed**: `The plugin couldn't be loaded`。`/plugin` の **Errors** タブを開いて理由を確認し、[インストール後: プラグインが機能しない](/docs/ja/plugins/troubleshooting#plugin-installed-but-not-working)を参照してください。

77 </Step>78 </Step>

288 289 

289* 入力して名前または説明でフィルタリングします。290* 入力して名前または説明でフィルタリングします。

290* **Space** を押して選択したプラグインを有効化または無効化し、**f** でお気に入りにします。291* **Space** を押して選択したプラグインを有効化または無効化し、**f** でお気に入りにします。

291* **Enter** を押してプラグインの詳細を開きます。そこのメニューは **Disable plugin** または **Enable plugin**、**Update now**、および **Uninstall** を提供します。設定を取得するプラグインは **Configure options** も提供します。292* **Enter** を押してプラグインの詳細を開きます。

293 

294プラグインの詳細メニューは **Disable plugin** または **Enable plugin**、**Update now**、および **Uninstall** を提供します。設定を取得するプラグインには 2 つの追加項目が表示され、プラグインは両方を表示できます。

295 

296* **Configure options**: プラグインのマニフェストが [`userConfig` オプション](/docs/ja/plugins/manifest-reference#user-configuration)を宣言するときに表示されます。これらのオプションのダイアログを開きます

297* **Configure**: プラグインが[バンドルされた MCP サーバー](/docs/ja/plugins/components#include-a-packaged-mcpb-server)を含むときに表示されます。そのサーバー自体の `user_config` 設定を設定します

292 298 

293タブは **Managed** スコープのプラグインも表示できます。組織は [管理設定](/docs/ja/settings#settings-files)を通じてそれらをインストールし、ここでそれらを有効化、無効化、またはアンインストールすることはできません。299タブは **Managed** スコープのプラグインも表示できます。組織は [管理設定](/docs/ja/settings#settings-files)を通じてそれらをインストールし、ここでそれらを有効化、無効化、またはアンインストールすることはできません。

294 300 

201 201 

202成功した追加は `Successfully added marketplace: <name>` を出力します。202成功した追加は `Successfully added marketplace: <name>` を出力します。

203 203 

204<h3 id="invalid-git-url">

205 `Invalid git URL`

206</h3>

207 

208マーケットプレイスを追加したか、プラグインをインストールしたか、git アドレスから更新を実行し、コマンドが `Invalid git URL` で失敗しました。

209 

210Claude Code は git アドレスを実行する前にすべてのチェックを行います。サポートしていないプロトコルを持つアドレスを拒否します。また、git がアドレスが示すものとは異なるサーバーまたはフォルダに名前を付けるとして読むことができるアドレスも拒否します。

211 

212アドレスの後のテキストは、変更する内容を名前付けします。メッセージが言うようにアドレスを書き直し、コマンドを再度実行してください。

213 

214代わりに `is blocked by enterprise policy` と言う拒否は、組織の設定から来ています。[マーケットプレイスソースはエンタープライズポリシーによってブロックされています](#marketplace-source-is-blocked-by-enterprise-policy)を参照してください。

215 

204<h3 id="path-does-not-exist">216<h3 id="path-does-not-exist">

205 `Path does not exist: <path>`217 `Path does not exist: <path>`

206</h3>218</h3>

410 422 

411シェルで `claude plugin install` は別のメッセージを出力します。ターゲットスコープで既にインストールされているプラグインの場合、`Plugin "<name>@<marketplace>" is already installed (scope: user)` を出力して終了 0 で終了します。キャッシュディレクトリが見つからない場合、同じコマンドは再度ダウンロードします。423シェルで `claude plugin install` は別のメッセージを出力します。ターゲットスコープで既にインストールされているプラグインの場合、`Plugin "<name>@<marketplace>" is already installed (scope: user)` を出力して終了 0 で終了します。キャッシュディレクトリが見つからない場合、同じコマンドは再度ダウンロードします。

412 424 

425<h3 id="plugin-would-share-its-folder">

426 `"<plugin>" was not installed: it would share its folder with "<other>"`

427</h3>

428 

429`claude plugin install`、`/plugin`、またはセッション内のインストール提案を通じてプラグインをインストールし、Claude Code はこの行で拒否しました。または、`would share its saved data with` で拒否しました。

430 

431拒否されたプラグインの id と、インストールされたプラグインの id はディスク上の同じフォルダにマップされます。`.` と `@` が `-` として書き込まれると、それらは同じです。macOS と Windows では、大文字のみが異なる id も同じフォルダにマップされます。両方をインストールすると、1 つのプラグインのファイルが他のプラグインのフォルダに入るため、Claude Code は拒否し、インストールされたプラグインはそのファイルを保持します。

432 

433メッセージは方法を名前付けします：

434 

435* **他のプラグインがインストールされている**：メッセージは `Only one of the two can be installed.` と言い、`claude plugin uninstall` コマンド、または `/plugin` のアンインストール手順を名前付けします。それを実行し、再度インストールしてください。アンインストールが削除するものについては、[アンインストールが削除して保持するもの](/docs/ja/plugins/cli-reference#what-an-uninstall-deletes-and-keeps)を参照してください。

436* **両方の id が 1 つのインストールで到着する**。例えば、プラグインとそれが必要とする依存関係：インストール順序は役に立ちません。マーケットプレイスの 2 つのプラグインをリストしている保守者のみが、それらの 1 つの名前を変更することで修正できます。2 つが異なるマーケットプレイスから来る場合、どちらかの保守者が修正できます。

437 

413<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">438<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">

414 `This plugin uses a source type your Claude Code version does not support`439 `This plugin uses a source type your Claude Code version does not support`

415</h3>440</h3>

790* **`URL is unset or invalid`**: URL が使用する `${user_config.*}` オプションが設定されていません。`/plugin configure <plugin>` を実行して設定してください815* **`URL is unset or invalid`**: URL が使用する `${user_config.*}` オプションが設定されていません。`/plugin configure <plugin>` を実行して設定してください

791* **`has an invalid MCP url`** または **`headersHelper for MCP server '<server>' references ${user_config.*}`**: プラグイン自体の設定に問題があります。プラグインの MCP 設定で `url` または `headersHelper` を修正するか、プラグインがあなたのものでない場合はプラグインの作成者に報告してください。`headersHelper` の場合は、[プラグイン コマンドが user\_config を参照](/docs/ja/errors#plugin-command-references-user-config) の下に独自のエントリがあります816* **`has an invalid MCP url`** または **`headersHelper for MCP server '<server>' references ${user_config.*}`**: プラグイン自体の設定に問題があります。プラグインの MCP 設定で `url` または `headersHelper` を修正するか、プラグインがあなたのものでない場合はプラグインの作成者に報告してください。`headersHelper` の場合は、[プラグイン コマンドが user\_config を参照](/docs/ja/errors#plugin-command-references-user-config) の下に独自のエントリがあります

792 817 

818<h4 id="bundled-mcp-server-name-was-not-started-it-needs-configuration">

819 `Bundled MCP server "<name>" was not started: it needs configuration`

820</h4>

821 

822プラグインは、サーバーを [MCPB バンドル](/docs/ja/plugins/components#include-a-packaged-mcpb-server) として含めており、`user_config` を宣言し、必須の設定に保存された値がないか、保存された値がバンドル自体の検証に失敗しているため、Claude Code はサーバーの起動をスキップします。プラグインの残りは機能します。

823 

824`/plugin` の **Installed** タブでプラグインを選択し、**Configure** を選択して値を指定してください。保存した後、`/plugin` は `Configuration saved.` を表示して閉じ、Claude Code は [インストール済みプラグインの管理](/docs/ja/plugins/install#manage-installed-plugins) の下で説明されているようにプラグインをリロードします。そのリロードが適用されると、サーバーが起動します。v2.1.285 より前では、Claude Code はこの行を表示せずにサーバーをスキップしました。

825 

793<h4 id="server-is-configured-but-never-connects">826<h4 id="server-is-configured-but-never-connects">

794 サーバーが設定されているが接続しない827 サーバーが設定されているが接続しない

795</h4>828</h4>

934 967 

935プラグインは `userConfig` オプションを宣言しますが、インストール時に設定ダイアログが表示されません。968プラグインは `userConfig` オプションを宣言しますが、インストール時に設定ダイアログが表示されません。

936 969 

937インタラクティブインストールはダイアログを表示し、シェルコマンドは代わりに値をフラグとして取得します：970インストール時に値を要求するかどうかは、それを実行する場所によって異なります：

938 971 

939* **セッションで `/plugin install`、または `/plugin` の Discover タブ**：ダイアログはこのインタラクティブインストールの一部です972* **セッションで `/plugin install`、または `/plugin` の Discover タブ**：ダイアログはこのインタラクティブインストールの一部です

973* **VS Code 拡張機能の Manage plugins ダイアログ**：インストール後に設定されていないオプションをフォームとして要求します。v2.1.285 より前では、そこでインストールしても設定オプションフォームが表示されなかったため、ターミナルセッションから `/plugin configure <plugin>@<marketplace>` で値を設定してください

940* **シェルで `claude plugin install`**：`userConfig` 値を要求しません。渡す `--config KEY=VALUE` 値を保存し、オプションが設定されたままの場合、`N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` を出力します。設定されていないオプションが必須の場合、`(M required)` は `not yet set` に従います。974* **シェルで `claude plugin install`**：`userConfig` 値を要求しません。渡す `--config KEY=VALUE` 値を保存し、オプションが設定されたままの場合、`N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` を出力します。設定されていないオプションが必須の場合、`(M required)` は `not yet set` に従います。

941 975 

942シェルからインストールした場合は、`--config` で値を渡してください。オプションごとに 1 つのフラグ：976シェルからインストールした場合は、`--config` で値を渡してください。オプションごとに 1 つのフラグ：

945claude plugin install my-plugin@my-marketplace --config api_url=https://example.com979claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

946```980```

947 981 

948すべてのオプションが設定されている場合、インストール出力は `not yet set` 行を運びません。代わりに後でダイアログを開くには、セッションで `/plugin configure my-plugin@my-marketplace` を実行してください。982すべてのオプションが設定されている場合、インストール出力は `not yet set` 行を運びません。

983 

984代わりに後でダイアログを開くには、セッションで `/plugin configure my-plugin@my-marketplace` を実行してください。シェルから、[`claude plugin configure`](/docs/ja/plugins/cli-reference#plugin-configure)は設定されていないオプションを表示し、stdin でパイプされた値を保存します。Claude Code v2.1.285 以降が必要です。

949 985 

950マニフェストが宣言しない `--config` キーを渡す場合、プラグインはまだインストールされ、コマンドは `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` を出力し、その後にプラグインが宣言するキーが続きます。986マニフェストが宣言しない `--config` キーを渡す場合、プラグインはまだインストールされ、コマンドは `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` を出力し、その後にプラグインが宣言するキーが続きます。

951 987 

988[MCPB バンドルファイル](/docs/ja/plugins/components#include-a-packaged-mcpb-server)を配布するプラグインの場合、独自の `user_config` を宣言し、メッセージは `isn't declared in this plugin's userConfig or by its bundled MCP servers.` を代わりに読み込み、既知のキーはそのサーバーのキーを含み、`<server>.<key>` として書き込まれます。マニフェストが URL で参照するバンドルはインストール時に読み込まれないため、そのキーはリストされず、メッセージは `/plugin` で設定するように指示します。`<server>.<key>` キーを設定するには Claude Code v2.1.285 以降が必要です。

989 

952<h3 id="claude-plugin-validate-reports-errors">990<h3 id="claude-plugin-validate-reports-errors">

953 `claude plugin validate` がエラーを報告991 `claude plugin validate` がエラーを報告

954</h3>992</h3>

163 管理ソース全体でのキー単位の例外163 管理ソース全体でのキー単位の例外

164</h3>164</h3>

165 165 

1663 つの種類のキーがマージなしルールの例外です。166これらのキーはマージなしルールの例外です。

167 167 

168* **クロスソースロックキー**：サンドボックスホワイトリストロックなど、[管理設定ページに記載されている](/docs/ja/managed-settings#precedence-within-the-managed-tier)小さなキーセット。Claude Code は、管理者が管理する管理ソースがそれらを設定する場合にそれらを尊重します。ユーザーが書き込み可能な HKCU レジストリ層は除外されます。168* **クロスソースロックキー**：サンドボックスホワイトリストロックなど、[管理設定ページに記載されている](/docs/ja/managed-settings#precedence-within-the-managed-tier)小さなキーセット。Claude Code は、管理者が管理する管理ソースがそれらを設定する場合にそれらを尊重します。ユーザーが書き込み可能な HKCU レジストリ層は除外されます。

169 169 

171* **`env` ブロック**：テレメトリユニットと認証情報キーとペアになったルーティング変数を除き、以下で説明するように、管理者が管理するソース全体でキーごとにマージされます。各環境変数について、それを定義する最優先ソースが優先され、下位の管理ソースは上位のソースが設定しない変数を埋めます。したがって、エンドポイント管理 `env` エントリは、サーバー管理構成がその変数を設定しない場合、またはキャッシュされたサーバー値が[サーバー確認待ちで保留中](#fetch-and-caching-behavior)の場合に適用されます。Claude Code v2.1.223 以降が必要です。v2.1.223 より前は、Claude Code は選択されたソースの全体 `env` ブロックのみを適用します。171* **`env` ブロック**：テレメトリユニットと認証情報キーとペアになったルーティング変数を除き、以下で説明するように、管理者が管理するソース全体でキーごとにマージされます。各環境変数について、それを定義する最優先ソースが優先され、下位の管理ソースは上位のソースが設定しない変数を埋めます。したがって、エンドポイント管理 `env` エントリは、サーバー管理構成がその変数を設定しない場合、またはキャッシュされたサーバー値が[サーバー確認待ちで保留中](#fetch-and-caching-behavior)の場合に適用されます。Claude Code v2.1.223 以降が必要です。v2.1.223 より前は、Claude Code は選択されたソースの全体 `env` ブロックのみを適用します。

172 * **テレメトリユニット**：`OTEL_EXPORTER_OTLP_*` エクスポーターキー、`OTEL_LOG_*` コンテンツキャプチャトグル、`OTEL_LOGS_EXPORTER`、およびベータトレーシング変数 `ENABLE_BETA_TRACING_DETAILED` と `BETA_TRACING_ENDPOINT` は、それらのいずれかを設定する最優先ソースをユニットとして従います。`otelHeadersHelper` 認証情報キーを配信するソースもユニットを要求しますが、これらの変数は選択されたソースである場合にのみ配置されます。選択されていないが、キーを配信するソースはそれらのいずれも提供せず、下位のソースがそれらを埋めるのをブロックします。いずれにせよ、1 つのソースからのエクスポーターエンドポイントは、別のソースからの認証情報とペアになることはできません。172 * **テレメトリユニット**：`OTEL_EXPORTER_OTLP_*` エクスポーターキー、`OTEL_LOG_*` コンテンツキャプチャトグル、`OTEL_LOGS_EXPORTER`、およびベータトレーシング変数 `ENABLE_BETA_TRACING_DETAILED` と `BETA_TRACING_ENDPOINT` は、それらのいずれかを設定する最優先ソースをユニットとして従います。`otelHeadersHelper` 認証情報キーを配信するソースもユニットを要求しますが、これらの変数は選択されたソースである場合にのみ配置されます。選択されていないが、キーを配信するソースはそれらのいずれも提供せず、下位のソースがそれらを埋めるのをブロックします。いずれにせよ、1 つのソースからのエクスポーターエンドポイントは、別のソースからの認証情報とペアになることはできません。

173 * **認証情報ペアのルーティング**：`apiKeyHelper` または `otelHeadersHelper` などの選択されたソースのみの認証情報キーとペアになったルーティング変数を配信するソースは、それがスロットに勝つ場合にのみそれらのルーティング変数を提供します。173 * **認証情報ペアのルーティング**：`apiKeyHelper` または `otelHeadersHelper` などの選択されたソースのみの認証情報キーとペアになったルーティング変数を配信するソースは、それがスロットに勝つ場合にのみそれらのルーティング変数を提供します。

174* **`allowedProviders`**：マシンに設定されたリストとサーバー管理リストは、[そのエントリの Scope ノート](/docs/ja/settings-reference#allowedproviders)に記載されているように組み合わされます。Claude Code v2.1.285 以降が必要です。

174* **ゲートウェイサインインキー**：Claude Code は [`forceLoginGatewayUrl`](/docs/ja/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](/docs/ja/settings-reference#gatewayinternalnetworks)、または [`forceLoginMethod`](/docs/ja/settings-reference#forceloginmethod) の `"gateway"` 値をサーバー管理設定から読み取ることはありません。したがって、サーバー管理設定の値は適用されず、MDM ポリシーまたは管理設定ファイルで設定されたものも隠されません。[`managedSourcesBehavior` エントリ](/docs/ja/settings-reference#managedsourcesbehavior)は、マシン上のどの管理ソースがそれらを提供するかを説明しています。175* **ゲートウェイサインインキー**：Claude Code は [`forceLoginGatewayUrl`](/docs/ja/settings-reference#forcelogingatewayurl)、[`gatewayInternalNetworks`](/docs/ja/settings-reference#gatewayinternalnetworks)、または [`forceLoginMethod`](/docs/ja/settings-reference#forceloginmethod) の `"gateway"` 値をサーバー管理設定から読み取ることはありません。したがって、サーバー管理設定の値は適用されず、MDM ポリシーまたは管理設定ファイルで設定されたものも隠されません。[`managedSourcesBehavior` エントリ](/docs/ja/settings-reference#managedsourcesbehavior)は、マシン上のどの管理ソースがそれらを提供するかを説明しています。

175 176 

176<h3 id="fetch-and-caching-behavior">177<h3 id="fetch-and-caching-behavior">

179 180 

180Claude Code は起動時に Anthropic のサーバーから設定をフェッチし、アクティブなセッション中は 1 時間ごとに更新をポーリングします。181Claude Code は起動時に Anthropic のサーバーから設定をフェッチし、アクティブなセッション中は 1 時間ごとに更新をポーリングします。

181 182 

182[Claude apps gateway](#platform-availability) を通じてサインインしたクライアントは、ゲートウェイから設定をフェッチし、セッションが開始される前にそのフェッチを待つため、以下のリストのフェッチはそれに適用されません。[フェッチが失敗した場合の処理](#enforce-fail-closed-startup)については、「強制的にクローズされた起動を適用する」を参照してください。183[Claude apps gateway](#platform-availability) を通じてサインインしたクライアントは、ゲートウェイから設定をフェッチし、セッションが開始される前にそのフェッチを待つため、以下のリストのフェッチはそれに適用されません。[強制的にクローズされた起動を適用する](#enforce-fail-closed-startup)は、そのフェッチが失敗した場合に何が起こるかをカバーしています。

183 184 

184**キャッシュされた設定なしの初回起動：**185**キャッシュされた設定なしの初回起動：**

185 186 

29 29 

30`claude --continue` は完了した [バックグラウンドセッション](/docs/ja/agent-view)を開きますが、実行中のセッションは開きません。完了したバックグラウンドセッションを開くには Claude Code v2.1.257 以降が必要です。最新の会話が [バックグラウンドに移動した](/docs/ja/agent-view#send-the-session-to-the-background)セッションで、そこで実行中の場合、Claude Code は `Your most recent conversation is running in the background` と終了し、そのセッションの ID を表示します。[`claude agents`](/docs/ja/agent-view#attach-to-a-session)からセッションにアタッチするか、`claude --resume` を実行して別のセッションを選択します。30`claude --continue` は完了した [バックグラウンドセッション](/docs/ja/agent-view)を開きますが、実行中のセッションは開きません。完了したバックグラウンドセッションを開くには Claude Code v2.1.257 以降が必要です。最新の会話が [バックグラウンドに移動した](/docs/ja/agent-view#send-the-session-to-the-background)セッションで、そこで実行中の場合、Claude Code は `Your most recent conversation is running in the background` と終了し、そのセッションの ID を表示します。[`claude agents`](/docs/ja/agent-view#attach-to-a-session)からセッションにアタッチするか、`claude --resume` を実行して別のセッションを選択します。

31 31 

32<span id="resume-a-running-background-session" />

33 

34`claude --resume` または `/resume` で再開する会話が、実行中の [バックグラウンドセッション](/docs/ja/agent-view)に属する場合、Claude Code は実行中のセッション自体を開きます。コマンドラインで `--bg` を使用すると、再開は [バックグラウンドディスパッチ](/docs/ja/agent-view#from-your-shell)になります。v2.1.285 より前は、Claude Code は拒否し、`claude attach <id>` でセッションを開くか、`claude stop <id>` で最初に停止するよう指示していました。

35 

36* **シェルから**：`claude --resume <session>` は、トランスクリプト自体を読み込む代わりに、同じターミナルでそのセッションに対して [`claude attach`](/docs/ja/agent-view#attach-to-a-session)を実行します。`claude --resume <session> "check the tests too"` のようにコマンドラインで渡すプロンプトは、最初にセッションの次のターンとして送信され、Claude Code は `Sent your prompt to the background session (<id>); opening it…` を出力してからアタッチします。ターミナルで入力した `claude -p --resume <session> "prompt"` も同じように動作するため、`-p` はその実行を非対話型に保ちません。

37 

38 Claude Code は、コマンドラインに以下のいずれかがある場合、セッションを開きません。

39 

40 * パイプまたはリダイレクトされた入力または出力

41 * `--permission-mode`、`--model`、`--settings` などのセッションを設定するフラグ

42 * `--output-format json` または `--json-schema` などの出力を読み込むフラグ

43 * `--max-turns` または `--max-budget-usd` などの実行を制限またはリワインドするフラグ

44 

45 これらのいずれかがある場合、または [エージェントビューがオフになっている](/docs/ja/agent-view#turn-off-agent-view)場合、Claude Code は何も送信せず、ステータス 1 で終了し、セッションがバックグラウンドで実行中であることを出力し、それを開く `claude attach <id>` コマンドを表示するか、ID を判定できない場合は `claude agents` で見つけるよう指示します。`--fork-session` を追加して、会話のコピーを再開します。セッション自体で会話を続行するには、フラグを適用して、`claude stop <id>` を実行してからコマンドを繰り返します。

46 

47 `/` または `!` で始まるプロンプトは送信されず、セッションが質問への回答を待っている間のプロンプトも送信されません。どちらの場合も Claude Code はセッションを開かず、メッセージには `Your prompt was not sent to it` と理由が含まれます。

48* **セッション内から**：`/resume` は現在の会話をバックグラウンドに移動し、このターミナルを実行中のセッションにアタッチし、`Opening "<title>", running in the background (<id>)` を出力します。空のプロンプトで `←` を押すとエージェントビューに戻ります。これは、残した会話もリストします。現在の会話がバックグラウンドに移動できない場合（例えば、バックグラウンドセッションにすでにアタッチしている場合、またはセッション永続性がオフの場合）、`/resume` は代わりに実行する `claude attach` コマンドを出力します。

49 

32任意のディレクトリから `claude --resume <session-id>` を実行できます。Claude Code は現在のプロジェクトディレクトリとその git worktrees でまず ID を検索し、次にこのマシン上の他のすべてのプロジェクトで検索するため、他の場所で開始されたセッションや [`/cd`](/docs/ja/commands)で移動したセッションを見つけます。クロスプロジェクト検索は、正確に 1 つの他のプロジェクトがそれのメッセージを含むトランスクリプトを保持している場合にのみ ID を解決するため、手動でコピーされた重複は Claude Code が見つからないと報告し、任意のコピーを再開するのではなく、見つかりません。保存されたセッションが ID と一致しない場合、Claude Code は `No conversation found with session ID: <session-id>` と報告します。v2.1.223 より前は、ルックアップは現在のプロジェクトディレクトリとその git worktrees で停止したため、セッションが最後に機能していたディレクトリから再開する必要がありました。50任意のディレクトリから `claude --resume <session-id>` を実行できます。Claude Code は現在のプロジェクトディレクトリとその git worktrees でまず ID を検索し、次にこのマシン上の他のすべてのプロジェクトで検索するため、他の場所で開始されたセッションや [`/cd`](/docs/ja/commands)で移動したセッションを見つけます。クロスプロジェクト検索は、正確に 1 つの他のプロジェクトがそれのメッセージを含むトランスクリプトを保持している場合にのみ ID を解決するため、手動でコピーされた重複は Claude Code が見つからないと報告し、任意のコピーを再開するのではなく、見つかりません。保存されたセッションが ID と一致しない場合、Claude Code は `No conversation found with session ID: <session-id>` と報告します。v2.1.223 より前は、ルックアップは現在のプロジェクトディレクトリとその git worktrees で停止したため、セッションが最後に機能していたディレクトリから再開する必要がありました。

33 51 

34<h3 id="what-a-resumed-session-restores">52<h3 id="what-a-resumed-session-restores">

35 再開されたセッションが復元するもの53 再開されたセッションが復元するもの

36</h3>54</h3>

37 55 

38再開されたセッションは、会話とそれに保存された状態を復元します。56Claude Code がトランスクリプトから会話を読み込むと、再開されたセッションは会話とそれに保存された状態を復元します。

39 57 

40* 会話履歴：ツール呼び出しと結果を含む完全な履歴。前のプロセスが終了したときに実行中だったツール（例えばクラッシュ）は、再開時に完了または再実行されません。Claude はその呼び出しが結果が記録される前に切断されたとマークされているのを見て、再度実行する前に有効になったかどうかを確認するよう指示されます。ただし、[`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars#variables)が設定されている場合は除きます。v2.1.281 より前は、Claude Code は切断された呼び出しを会話から削除するか、中断したものとして Claude に表示していました。58* 会話履歴：ツール呼び出しと結果を含む完全な履歴。前のプロセスが終了したときに実行中だったツール（例えばクラッシュ）は、再開時に完了または再実行されません。Claude はその呼び出しが結果が記録される前に切断されたとマークされているのを見て、再度実行する前に有効になったかどうかを確認するよう指示されます。ただし、[`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/ja/env-vars#variables)が設定されている場合は除きます。v2.1.281 より前は、Claude Code は切断された呼び出しを会話から削除するか、中断したものとして Claude に表示していました。

41* モデル：セッションは使用していたモデルで続行されます。モデルが廃止されたか `availableModels` で許可されていない場合、`--model` フラグまたは `ANTHROPIC_MODEL` ファミリー環境変数が起動時に 1 つを選択する場合、または [Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry](/docs/ja/third-party-integrations)などのプロバイダー固有のデプロイ ID を使用するプロバイダーの場合は復元されません。[モデル設定](/docs/ja/model-config#setting-your-model)の解決順序を参照してください。59* モデル：セッションは使用していたモデルで続行されます。モデルが廃止されたか `availableModels` で許可されていない場合、`--model` フラグまたは `ANTHROPIC_MODEL` ファミリー環境変数が起動時に 1 つを選択する場合、または [Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry](/docs/ja/third-party-integrations)などのプロバイダー固有のデプロイ ID を使用するプロバイダーの場合は復元されません。[モデル設定](/docs/ja/model-config#setting-your-model)の解決順序を参照してください。

51 再開時の権限モード69 再開時の権限モード

52</h4>70</h4>

53 71 

54再開されたセッションが開始される権限モードは、再開方法によって異なります。72再開されたセッションが開始される権限モードは、再開方法によって異なります。以下の場合は、Claude Code がトランスクリプトから会話を読み込むときに適用されます。[実行中のバックグラウンドセッションを開く](#resume-a-running-background-session)場合、そのセッションは存在する権限モードを保持します。

55 73 

56* ターミナル：`claude --continue`、`claude --resume <session-id>`、または `claude --resume <name>`（名前が 1 つのセッションと一致する場合）で `-p` なし。Claude Code はセッションが存在していた権限モードを復元します。ただし、表の場合は除きます。`--permission-mode` または `--dangerously-skip-permissions` を渡して復元されたモードをオーバーライドします。74* ターミナル：`claude --continue`、`claude --resume <session-id>`、または `claude --resume <name>`（名前が 1 つのセッションと一致する場合）で `-p` なし。Claude Code はセッションが存在していた権限モードを復元します。ただし、表の場合は除きます。`--permission-mode` または `--dangerously-skip-permissions` を渡して復元されたモードをオーバーライドします。

57* 非対話型：`claude -p --resume` または `claude -p --continue`。Claude Code は新しい `claude -p` 実行が開始される権限モードで実行を開始します。ただし、プランモードで終了したセッションは [以下の条件](#resume-in-plan-mode-with-p)下でプランモードで再開されます。75* 非対話型：`claude -p --resume` または `claude -p --continue`。Claude Code は新しい `claude -p` 実行が開始される権限モードで実行を開始します。ただし、プランモードで終了したセッションは [以下の条件](#resume-in-plan-mode-with-p)下でプランモードで再開されます。

599| [`allowedChannelPlugins`](#allowedchannelplugins) | メッセージをプッシュできる[チャネルプラグイン](/docs/ja/channels#restrict-which-channel-plugins-can-run)のデフォルト許可リストを置き換えます | Plugins and skills | Managed |599| [`allowedChannelPlugins`](#allowedchannelplugins) | メッセージをプッシュできる[チャネルプラグイン](/docs/ja/channels#restrict-which-channel-plugins-can-run)のデフォルト許可リストを置き換えます | Plugins and skills | Managed |

600| [`allowedHttpHookUrls`](#allowedhttphookurls) | [HTTP フック](/docs/ja/hooks)がターゲットできる URL を制限します | Hooks and automation | Any file |600| [`allowedHttpHookUrls`](#allowedhttphookurls) | [HTTP フック](/docs/ja/hooks)がターゲットできる URL を制限します | Hooks and automation | Any file |

601| [`allowedMcpServers`](#allowedmcpservers) | ユーザーが追加できる[MCP サーバー](/docs/ja/mcp)を許可リストに登録します | MCP | Any file |601| [`allowedMcpServers`](#allowedmcpservers) | ユーザーが追加できる[MCP サーバー](/docs/ja/mcp)を許可リストに登録します | MCP | Any file |

602| [`allowedProviders`](#allowedproviders) | マシンが使用できる[API プロバイダー](/docs/ja/third-party-integrations)を制限します | Authentication and providers | Managed |

602| [`allowManagedHooksOnly`](#allowmanagedhooksonly) | 組織がデプロイする[フック](/docs/ja/hooks)のみを実行します | Hooks and automation | Managed |603| [`allowManagedHooksOnly`](#allowmanagedhooksonly) | 組織がデプロイする[フック](/docs/ja/hooks)のみを実行します | Hooks and automation | Managed |

603| [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) | マネージド[MCP](/docs/ja/mcp)許可リストが適用される唯一のものにします | MCP | Managed |604| [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) | マネージド[MCP](/docs/ja/mcp)許可リストが適用される唯一のものにします | MCP | Managed |

604| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | [マネージド設定](/docs/ja/managed-settings)を[権限ルール](/docs/ja/permissions#managed-settings)の唯一の設定ソースにします | Permission settings | Managed |605| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | [マネージド設定](/docs/ja/managed-settings)を[権限ルール](/docs/ja/permissions#managed-settings)の唯一の設定ソースにします | Permission settings | Managed |

5876 5877 

5877ヘルパースクリプトを通じて認証情報を提供し、組織の場合はログイン方法または組織を強制します。[認証](/docs/ja/authentication)を参照してください。5878ヘルパースクリプトを通じて認証情報を提供し、組織の場合はログイン方法または組織を強制します。[認証](/docs/ja/authentication)を参照してください。

5878 5879 

5880<h3 id="allowedproviders">

5881 `allowedProviders`

5882</h3>

5883 

5884マシンが Claude に到達できるサービス（Anthropic API、Amazon Bedrock、LLM ゲートウェイなど）をリストアップします。リストに記載されていないプロバイダー上のセッションは、スタートアップ時、ログイン時、および次に API に接続するときに拒否されるため、セッション中にリストに記載されていないプロバイダーに切り替えることも拒否されます。[拒否メッセージ](/docs/ja/errors#managed-settings-dont-allow-this-api-provider)には、プロバイダーを選択したものと続行するためのステップが記載されています。Claude Code v2.1.285 以降が必要です。

5885 

5886* **スコープ**: [`Managed`](#scopes)。マシン自身の管理者ソースが設定したリスト、MDM ポリシーおよび管理設定ファイルが適用し続けます。サーバー管理設定もリストを配信する場合、セッションは両方のリスト上のプロバイダーのみを使用できるため、サーバー管理リストはマシンが許可するものを狭めることはできますが、広げることはできません。マシンソースの `allowedProviders` のどれが数えられるかは、[Claude Code が管理ソースを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)に従います。サーバー管理設定のみを通じて配信されたリストは、[サーバー管理設定を取得する](/docs/ja/server-managed-settings#platform-availability)セッションのみに到達します。

5887* **タイプ**: 文字列の配列。各要素は以下のいずれか：

5888 * `"anthropic"`: claude.ai または Console サインイン、または API キーを通じた Anthropic 独自のホスト上の Anthropic API。[`forceLoginMethod`](#forceloginmethod) または [`forceLoginOrgUUID`](#forceloginorguuid) と組み合わせてサインインも制限します

5889 * `"bedrock"`: [Amazon Bedrock](/docs/ja/amazon-bedrock)

5890 * `"vertex"`: [Google Cloud の Agent Platform](/docs/ja/google-vertex-ai)（旧 Vertex AI）

5891 * `"foundry"`: [Microsoft Foundry](/docs/ja/microsoft-foundry)

5892 * `"anthropicAws"`: [AWS 上の Claude Platform](/docs/ja/claude-platform-on-aws)

5893 * `"mantle"`: Amazon Bedrock [Mantle エンドポイント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)。[Invoke API と並行して Mantle を実行する](/docs/ja/amazon-bedrock#run-mantle-alongside-the-invoke-api)セッションは両方のプロバイダーを使用するため、`"bedrock"` と `"mantle"` をまとめてリストアップします

5894 * `"customEndpoint"`: Anthropic API またはクラウドプロバイダーの API を別のホストに送信します。[LLM ゲートウェイ](/docs/ja/llm-gateway)（`ANTHROPIC_BASE_URL` で指定）、プロバイダーの `ANTHROPIC_*_BASE_URL` 変数、またはベアリソース名ではない `ANTHROPIC_FOUNDRY_RESOURCE` 値。Claude Code はそれを管理 [`env`](#env) ブロックがピンで留めた正確な値に対してのみ許可します

5895 * `"gateway"`: [Cloud ゲートウェイ](/docs/ja/claude-apps-gateway)サインイン

5896* **デフォルト**: 未設定。任意のプロバイダーを使用できます

5897 

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

5899{

5900 "allowedProviders": ["anthropic", "bedrock"]

5901}

5902```

5903 

5904各クラウドプロバイダーのエントリは、そのプロバイダー独自のサービス（地域、FIPS、プライベートエンドポイントを含む）を意味します。

5905 

5906Claude Code がプロバイダー名として認識しないエントリは削除され、報告され、リストの残りは強制されます。空のリスト、またはすべてのエントリが認識されないリストの場合、Claude Code はすべてのプロバイダーを拒否し、マシン上で起動しません。

5907 

5908<h4 id="endpoints-that-need-a-pin-in-managed-env">

5909 管理 `env` でピンが必要なエンドポイント

5910</h4>

5911 

5912ピンは、管理 [`env`](#env) ブロックで設定されたエンドポイント変数の値です。セッションがプロバイダーのトラフィックをそのプロバイダー独自のサービス以外の場所に送信する場合、Claude Code はセッションの値がピンと同じ場合にのみそれを許可します。これらのエンドポイントには 1 つが必要です：

5913 

5914* **`"customEndpoint"` セッション**: ホストを指定する変数（`ANTHROPIC_BASE_URL` など）

5915* **Amazon Bedrock**: AWS SDK の `AWS_ENDPOINT_URL`、`AWS_ENDPOINT_URL_BEDROCK`、および `AWS_ENDPOINT_URL_BEDROCK_RUNTIME` 変数が Bedrock 独自のサービス外を指す場合。セッションは `"customEndpoint"` ではなく `"bedrock"` の下に留まります

5916* **ゲートウェイサインイン URL**: セッションは `"gateway"` の下に留まり、[`forceLoginGatewayUrl`](#forcelogingatewayurl) もピンとしてカウントされます

5917 

5918どの `env` ブロックがピンとしてカウントされるかは、リストが設定されている場所によって異なります：

5919 

5920* **マシン上の管理者ソースがリストを設定**: マシン独自の管理者ソースの `env` ブロックのみがカウントされます

5921* **サーバー管理設定のみがリストを設定**: これらのサーバー管理設定の `env` 値もカウントされます

5922 

5923リストは、クラウドプロバイダーの認証情報とテナンシー変数、または `HTTPS_PROXY` と証明書設定などのネットワークパスを判定しません。管理 `env` ブロックでフロート用にそれらを設定します。

5924 

5879<h3 id="apikeyhelper">5925<h3 id="apikeyhelper">

5880 `apiKeyHelper`5926 `apiKeyHelper`

5881</h3>5927</h3>

6398| :- | :- | :- |6444| :- | :- | :- |

6399| リスト | すべてのソースからのエントリを組み合わせます | [`permissions.allow`](#permissions-allow)、[`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains)、およびその他のリストキー |6445| リスト | すべてのソースからのエントリを組み合わせます | [`permissions.allow`](#permissions-allow)、[`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains)、およびその他のリストキー |

6400| ロック | ソースが設定する最も厳密な値を適用します。ソースが厳密な値を設定しない場合、最優先度のソースからのみより緩い値を適用します | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly)、[`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode)、およびその他のブール値または列挙型ロック |6446| ロック | ソースが設定する最も厳密な値を適用します。ソースが厳密な値を設定しない場合、最優先度のソースからのみより緩い値を適用します | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly)、[`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode)、およびその他のブール値または列挙型ロック |

6401| 制限許可リスト | 下位ソースからのエントリを追加せずに、それを設定する最優先度のソースから全体を取得します。最優先度のソースが設定しない場合、次のソースから全体を取得します | [`availableModels`](#availablemodels)、[`allowedMcpServers`](#allowedmcpservers)、[`strictKnownMarketplaces`](#strictknownmarketplaces)、[`allowedChannelPlugins`](#allowedchannelplugins)、および [`fallbackModel`](#fallbackmodel) チェーン |6447| 制限許可リスト | 下位ソースからのエントリを追加せずに、それを設定する最優先度のソースから全体を取得します。最優先度のソースが設定しない場合、次のソースから全体を取得します | [`availableModels`](#availablemodels)、[`allowedMcpServers`](#allowedmcpservers)、[`allowedProviders`](#allowedproviders)、[`strictKnownMarketplaces`](#strictknownmarketplaces)、[`allowedChannelPlugins`](#allowedchannelplugins)、および [`fallbackModel`](#fallbackmodel) チェーン |

6402| 値全体取得 | 下位ソースからのエントリまたはフィールドを組み合わせずに、それを設定する最優先度のソースから全体を取得します。最優先度のソースが設定しない場合、次のソースから全体を取得します | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs)、[`sandbox.ripgrep`](#sandbox-ripgrep) |6448| 値全体取得 | 下位ソースからのエントリまたはフィールドを組み合わせずに、それを設定する最優先度のソースから全体を取得します。最優先度のソースが設定しない場合、次のソースから全体を取得します | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs)、[`sandbox.ripgrep`](#sandbox-ripgrep) |

6403| 提供される MCP サーバー | すべてのソースからサーバー名を組み合わせます。2 つのソースが同じ名前を設定する場合、上位ソースの全体エントリを適用します | [`managedMcpServers`](#managedmcpservers) |6449| 提供される MCP サーバー | すべてのソースからサーバー名を組み合わせます。2 つのソースが同じ名前を設定する場合、上位ソースの全体エントリを適用します | [`managedMcpServers`](#managedmcpservers) |

6404| 最優先度のソースからのみ読み取ります | ポリシーキーを含む最優先度のソースからのみキーを読み取るため、最優先度のソースが何も設定しない場合でも、下位ソースの値は無視されます | [`apiKeyHelper`](#apikeyhelper)、[`awsAuthRefresh`](#awsauthrefresh)、[`awsCredentialExport`](#awscredentialexport)、[`gcpAuthRefresh`](#gcpauthrefresh)、[`otelHeadersHelper`](#otelheadershelper)、`proxyAuthHelper`、[`forceLoginOrgUUID`](#forceloginorguuid)、[`forceLoginMethod`](#forceloginmethod) の `"claudeai"` および `"console"` 値、[`parentSettingsBehavior`](#parentsettingsbehavior)、[`modelPicker`](#modelpicker)、[`policyHelper`](#policyhelper)、[`permissions.defaultMode`](#permissions-defaultmode) |6450| 最優先度のソースからのみ読み取ります | ポリシーキーを含む最優先度のソースからのみキーを読み取るため、最優先度のソースが何も設定しない場合でも、下位ソースの値は無視されます | [`apiKeyHelper`](#apikeyhelper)、[`awsAuthRefresh`](#awsauthrefresh)、[`awsCredentialExport`](#awscredentialexport)、[`gcpAuthRefresh`](#gcpauthrefresh)、[`otelHeadersHelper`](#otelheadershelper)、`proxyAuthHelper`、[`forceLoginOrgUUID`](#forceloginorguuid)、[`forceLoginMethod`](#forceloginmethod) の `"claudeai"` および `"console"` 値、[`parentSettingsBehavior`](#parentsettingsbehavior)、[`modelPicker`](#modelpicker)、[`policyHelper`](#policyhelper)、[`permissions.defaultMode`](#permissions-defaultmode) |

6412* **[`policyHelper`](#policyhelper)**: Claude Code は、ポリシーキーを含む最優先度のソースが MDM ポリシーまたは管理設定ファイルである場合にのみそれを尊重します。サーバー管理設定では適用されません。6458* **[`policyHelper`](#policyhelper)**: Claude Code は、ポリシーキーを含む最優先度のソースが MDM ポリシーまたは管理設定ファイルである場合にのみそれを尊重します。サーバー管理設定では適用されません。

6413* **[`modelOverrides`](#modeloverrides)**: `availableModels` とペアになります。Claude Code は、それを設定する最優先度のソースから `modelOverrides` を取得します。ただし、上位ソースが `modelOverrides` なしで `availableModels` を設定する場合は除きます。その場合、すべてのソースから `modelOverrides` を無視します。6459* **[`modelOverrides`](#modeloverrides)**: `availableModels` とペアになります。Claude Code は、それを設定する最優先度のソースから `modelOverrides` を取得します。ただし、上位ソースが `modelOverrides` なしで `availableModels` を設定する場合は除きます。その場合、すべてのソースから `modelOverrides` を無視します。

6414* **[`forceLoginGatewayUrl`](#forcelogingatewayurl)、[`gatewayInternalNetworks`](#gatewayinternalnetworks)、および [`forceLoginMethod`](#forceloginmethod) の `"gateway"` 値**: Claude Code はサーバー管理設定からそれらのいずれも読み取りません。そのため、そこでの値は適用されず、MDM ポリシーまたは管理設定ファイルで設定されたものを隠しません。マシン上の管理ソースの中で、ポリシーキーを含む最優先度のソースのみがそれらを提供します。サーバー管理設定も存在するかどうかに関わらず。6460* **[`forceLoginGatewayUrl`](#forcelogingatewayurl)、[`gatewayInternalNetworks`](#gatewayinternalnetworks)、および [`forceLoginMethod`](#forceloginmethod) の `"gateway"` 値**: Claude Code はサーバー管理設定からそれらのいずれも読み取りません。そのため、そこでの値は適用されず、MDM ポリシーまたは管理設定ファイルで設定されたものを隠しません。マシン上の管理ソースの中で、ポリシーキーを含む最優先度のソースのみがそれらを提供します。サーバー管理設定も存在するかどうかに関わらず。

6461* **[`allowedProviders`](#allowedproviders)**: テーブルのルールの後、マシン自体のリストは結果を制限し続けます。そのエントリの Scope ノートが述べているように。

6415 6462 

6416マシンで組み合わせたソースを確認するには、`/status` を実行し、[`Setting sources` 行を読んでください](/docs/ja/managed-settings#read-the-source-in-/status)。6463マシンで組み合わせたソースを確認するには、`/status` を実行し、[`Setting sources` 行を読んでください](/docs/ja/managed-settings#read-the-source-in-/status)。

6417 6464 

740 740 

741* **作業ディレクトリ**：Claude Code は各コマンドをセッションシェルの現在の作業ディレクトリで実行します。Claude が `cd` を実行するとそのディレクトリが移動します。毎回同じ方法で解決する必要があるパスで [`${CLAUDE_SKILL_DIR}` または `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) を使用します。741* **作業ディレクトリ**：Claude Code は各コマンドをセッションシェルの現在の作業ディレクトリで実行します。Claude が `cd` を実行するとそのディレクトリが移動します。毎回同じ方法で解決する必要があるパスで [`${CLAUDE_SKILL_DIR}` または `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) を使用します。

742* **stderr**：デフォルトの `bash` シェルでは、Claude Code は stderr を stdout にマージします。コマンドが stderr に書き込むすべてのものが注入されたテキストに表示されます。742* **stderr**：デフォルトの `bash` シェルでは、Claude Code は stderr を stdout にマージします。コマンドが stderr に書き込むすべてのものが注入されたテキストに表示されます。

743* **タイムアウト**：各コマンドは Bash ツールのデフォルト 2 分 [timeout](/docs/ja/tools-reference#timeout-and-output-limits) の下で実行されます。Bash ツールが [タイムアウトしたコマンドをバックグラウンドに移動](/docs/ja/tools-reference#background-commands) する場合、スキルは引き続きレンダリングされます。注入されたテキストは移動を報告し、バックグラウンドタスクとコマンドの出力を収集するファイルに名前を付けます。コマンドが Bash ツールが自動的にバックグラウンドに移動しないコマンドの場合、Claude Code はタイムアウト時にそれを強制終了します。その失敗は [呼び出しを中止します](#when-an-injected-command-fails)。743* **タイムアウト**：各コマンドは Bash ツールのデフォルト 2 分 [timeout](/docs/ja/tools-reference#timeout-and-output-limits) の下で実行されます。Bash ツールが [タイムアウトしたコマンドをバックグラウンドに移動](/docs/ja/tools-reference#foreground-commands-that-move-to-the-background) する場合、スキルは引き続きレンダリングされます。注入されたテキストは移動を報告し、バックグラウンドタスクとコマンドの出力を収集するファイルに名前を付けます。コマンドが Bash ツールが自動的にバックグラウンドに移動しないコマンドの場合、Claude Code はタイムアウト時にそれを強制終了します。その失敗は [呼び出しを中止します](#when-an-injected-command-fails)。

744* **出力サイズ**：Bash ツールのインライン上限を超える出力は、切り詰められたテキストではなく、ファイルパスと短いプレビューとして到着します。[出力制限](/docs/ja/tools-reference#output-limits) は上限とそれぞれの境界を調整する方法をカバーしています。744* **出力サイズ**：Bash ツールのインライン上限を超える出力は、切り詰められたテキストではなく、ファイルパスと短いプレビューとして到着します。[出力制限](/docs/ja/tools-reference#output-limits) は上限とそれぞれの境界を調整する方法をカバーしています。

745 745 

746PowerShell ツールは、実行するコマンドに同じタイムアウト、バックグラウンド処理、および出力上限の動作を適用します。その詳細については、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) セクションを参照してください。746PowerShell ツールは、実行するコマンドに同じタイムアウト、バックグラウンド処理、および出力上限の動作を適用します。その詳細については、[PowerShell ツール](/docs/ja/tools-reference#powershell-tool) セクションを参照してください。

20以下は、最初の行に git 情報を表示し、2 番目の行にカラーコード化されたコンテキストバーを表示する [複数行ステータスライン](#display-multiple-lines) の例です。20以下は、最初の行に git 情報を表示し、2 番目の行にカラーコード化されたコンテキストバーを表示する [複数行ステータスライン](#display-multiple-lines) の例です。

21 21 

22<Frame>22<Frame>

23 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="最初の行にモデル名、ディレクトリ、git ブランチを表示し、2 番目の行にコンテキスト使用状況プログレスバー、コスト、期間を表示する複数行ステータスライン" width="776" height="212" data-path="images/statusline-multiline.png" />23 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="最初の行にモデル名、ディレクトリ、git ブランチを表示し、2 番目の行にコンテキスト使用状況プログレスバー、コスト、期間を表示する複数行ステータスライン" width="1224" height="262" data-path="images/statusline-multiline.png" />

24</Frame>24</Frame>

25 25 

26このページでは、[基本的なステータスラインの設定](#set-up-a-status-line) について説明し、Claude Code からスクリプトへの [データフロー](#how-status-lines-work) について説明し、[表示できるすべてのフィールド](#available-data) をリストアップし、git ステータス、コスト追跡、プログレスバーなどの一般的なパターンの [すぐに使える例](#examples) を提供します。26このページでは、[基本的なステータスラインの設定](#set-up-a-status-line) について説明し、Claude Code からスクリプトへの [データフロー](#how-status-lines-work) について説明し、[表示できるすべてのフィールド](#available-data) をリストアップし、git ステータス、コスト追跡、プログレスバーなどの一般的なパターンの [すぐに使える例](#examples) を提供します。

93これらの例では Bash スクリプトを使用しており、macOS と Linux で動作します。Windows では、[Windows 設定](#windows-configuration) で PowerShell と Git Bash の例を参照してください。93これらの例では Bash スクリプトを使用しており、macOS と Linux で動作します。Windows では、[Windows 設定](#windows-configuration) で PowerShell と Git Bash の例を参照してください。

94 94 

95<Frame>95<Frame>

96 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-quickstart.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=696445e59ca0059213250651ad23db6b" alt="モデル名、ディレクトリ、コンテキスト割合を表示するステータスライン" width="726" height="164" data-path="images/statusline-quickstart.png" />96 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-quickstart.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=88a7eab9c1038dd098ee8e284d96b7e6" alt="モデル名、ディレクトリ、コンテキスト割合を表示するステータスライン" width="1224" height="224" data-path="images/statusline-quickstart.png" />

97</Frame>97</Frame>

98 98 

99<Steps>99<Steps>

444現在のモデルとコンテキストウィンドウの使用状況を視覚的なプログレスバーで表示します。各スクリプトは stdin から JSON を読み取り、`used_percentage` フィールドを抽出し、塗りつぶされたブロック（▓）が使用状況を表す 10 文字のバーを構築します：444現在のモデルとコンテキストウィンドウの使用状況を視覚的なプログレスバーで表示します。各スクリプトは stdin から JSON を読み取り、`used_percentage` フィールドを抽出し、塗りつぶされたブロック（▓）が使用状況を表す 10 文字のバーを構築します：

445 445 

446<Frame>446<Frame>

447 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-context-window-usage.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=15b58ab3602f036939145dde3165c6f7" alt="モデル名とパーセンテージ付きプログレスバーを表示するステータスライン" width="448" height="152" data-path="images/statusline-context-window-usage.png" />447 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-context-window-usage.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f3918a549912dc47e90f2b69e68bc847" alt="モデル名とパーセンテージ付きプログレスバーを表示するステータスライン" width="1224" height="224" data-path="images/statusline-context-window-usage.png" />

448</Frame>448</Frame>

449 449 

450<CodeGroup>450<CodeGroup>

513ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを使用して git ブランチを表示します。このスクリプトはターミナルの色に [ANSI エスケープコード](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) を使用します：`\033[32m` は緑、`\033[33m` は黄、`\033[0m` はデフォルトにリセットします。513ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを使用して git ブランチを表示します。このスクリプトはターミナルの色に [ANSI エスケープコード](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) を使用します：`\033[32m` は緑、`\033[33m` は黄、`\033[0m` はデフォルトにリセットします。

514 514 

515<Frame>515<Frame>

516 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-git-context.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e656f34f90d1d9a1d0e220988914345f" alt="モデル、ディレクトリ、git ブランチ、ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを表示するステータスライン" width="742" height="178" data-path="images/statusline-git-context.png" />516 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-git-context.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f13c190724d9ec7188c17cd2f98b7bf4" alt="モデル、ディレクトリ、git ブランチ、ステージングされたファイルと変更されたファイルのカラーコード化されたインジケーターを表示するステータスライン" width="1224" height="224" data-path="images/statusline-git-context.png" />

517</Frame>517</Frame>

518 518 

519各スクリプトは現在のディレクトリが git リポジトリであるかどうかを確認し、ステージングされたファイルと変更されたファイルをカウントし、カラーコード化されたインジケーターを表示します：519各スクリプトは現在のディレクトリが git リポジトリであるかどうかを確認し、ステージングされたファイルと変更されたファイルをカウントし、カラーコード化されたインジケーターを表示します：

611各スクリプトはコストを通貨としてフォーマットし、ミリ秒を分と秒に変換します：611各スクリプトはコストを通貨としてフォーマットし、ミリ秒を分と秒に変換します：

612 612 

613<Frame>613<Frame>

614 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-cost-tracking.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e3444a51fe6f3440c134bd5f1f08ad29" alt="モデル名、セッションコスト、期間を表示するステータスライン" width="588" height="180" data-path="images/statusline-cost-tracking.png" />614 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-cost-tracking.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=925f7024c3b38be0f0eca63564bfb52f" alt="モデル名、セッションコスト、期間を表示するステータスライン" width="1224" height="224" data-path="images/statusline-cost-tracking.png" />

615</Frame>615</Frame>

616 616 

617<CodeGroup>617<CodeGroup>

672スクリプトは複数の行を出力して、より豊かなディスプレイを作成できます。672スクリプトは複数の行を出力して、より豊かなディスプレイを作成できます。

673 673 

674<Frame>674<Frame>

675 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="最初の行にモデル名、ディレクトリ、git ブランチを表示し、2 番目の行にコンテキスト使用状況プログレスバー、コスト、期間を表示する複数行ステータスライン" width="776" height="212" data-path="images/statusline-multiline.png" />675 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="最初の行にモデル名、ディレクトリ、git ブランチを表示し、2 番目の行にコンテキスト使用状況プログレスバー、コスト、期間を表示する複数行ステータスライン" width="1224" height="262" data-path="images/statusline-multiline.png" />

676</Frame>676</Frame>

677 677 

678この例は複数のテクニックを組み合わせています：閾値ベースの色（70% 未満は緑、70～89% は黄、90% 以上は赤）、プログレスバー、git ブランチ情報。各 `print` または `echo` ステートメントは別の行を作成します：678この例は複数のテクニックを組み合わせています：閾値ベースの色（70% 未満は緑、70～89% は黄、90% 以上は赤）、プログレスバー、git ブランチ情報。各 `print` または `echo` ステートメントは別の行を作成します：

781この例は GitHub リポジトリへのクリック可能なリンクを作成します。Cmd（macOS）または Ctrl（Windows/Linux）を押しながらクリックして、ブラウザでリンクを開きます。781この例は GitHub リポジトリへのクリック可能なリンクを作成します。Cmd（macOS）または Ctrl（Windows/Linux）を押しながらクリックして、ブラウザでリンクを開きます。

782 782 

783<Frame>783<Frame>

784 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-links.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=4bcc6e7deb7cf52f41ab85a219b52661" alt="GitHub リポジトリへのクリック可能なリンクを表示するステータスライン" width="726" height="198" data-path="images/statusline-links.png" />784 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-links.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=4778a144a28cb498c99d5fa018bb374a" alt="GitHub リポジトリへのクリック可能なリンクを表示するステータスライン" width="1224" height="224" data-path="images/statusline-links.png" />

785</Frame>785</Frame>

786 786 

787各スクリプトは git リモート URL を取得し、SSH 形式を HTTPS に変換し、リポジトリ名を OSC 8 エスケープコードでラップします。Bash バージョンは `printf '%b'` を使用します。これはバックスラッシュエスケープを異なるシェル間でより確実に解釈します：787各スクリプトは git リモート URL を取得し、SSH 形式を HTTPS に変換し、リポジトリ名を OSC 8 エスケープコードでラップします。Bash バージョンは `printf '%b'` を使用します。これはバックスラッシュエスケープを異なるシェル間でより確実に解釈します：

253 253 

254セキュリティチームは、Claude Code が実行できることと実行できないことに対する管理権限を構成できます。これはローカル構成によって上書きされません。[詳細をご覧ください](/docs/ja/security)。254セキュリティチームは、Claude Code が実行できることと実行できないことに対する管理権限を構成できます。これはローカル構成によって上書きされません。[詳細をご覧ください](/docs/ja/security)。

255 255 

256これらのデプロイメントオプションのうち、管理対象マシンが使用できるものを制限するには、管理設定で [`allowedProviders`](/docs/ja/settings-reference#allowedproviders) を設定します。たとえば、`["bedrock"]` は Amazon Bedrock のみを許可します。Mantle エンドポイントも有効にする Bedrock フリートは `"mantle"` も一覧に含めます。このエントリは、管理対象の `env` ピン留めも必要なエンドポイント変数を示します。Claude Code v2.1.285 以降が必要です。

257 

256<h3 id="leverage-mcp-for-integrations">258<h3 id="leverage-mcp-for-integrations">

257 統合に MCP を活用する259 統合に MCP を活用する

258</h3>260</h3>

172* `BASH_DEFAULT_TIMEOUT_MS` — Claude がタイムアウトを渡さない場合のデフォルト。デフォルトでは 2 分です。172* `BASH_DEFAULT_TIMEOUT_MS` — Claude がタイムアウトを渡さない場合のデフォルト。デフォルトでは 2 分です。

173* `BASH_MAX_TIMEOUT_MS` — デフォルトでは、Claude が要求するものを上限で制限します。有効な上限は 2 つの値の大きい方です。デフォルトでは 10 分です。173* `BASH_MAX_TIMEOUT_MS` — デフォルトでは、Claude が要求するものを上限で制限します。有効な上限は 2 つの値の大きい方です。デフォルトでは 10 分です。

174 174 

175バックグラウンドで実行される Claude が開始するコマンドの場合、`timeout` は代わりにコマンドがそこで実行される期間を設定し、[バックグラウンドコマンド](#background-commands)の下で説明されている別のデフォルトと最大値があります。[PowerShell ツール](#powershell-tool)は同じタイムアウトルールに従い、同じ 2 つの変数を読み取ります。175バックグラウンドで実行される Claude が開始するコマンドの場合、`timeout` は代わりにコマンドがそこで実行される期間を設定し、[バックグラウンドコマンドの時間制限](#time-limit-for-background-commands)の下で説明されている別のデフォルトと最大値があります。[PowerShell ツール](#powershell-tool)は同じタイムアウトルールに従い、同じ 2 つの変数を読み取ります。

176 176 

177<h4 id="output-limits">177<h4 id="output-limits">

178 出力制限178 出力制限

197 197 

198開発サーバーやウォッチビルドなどの長時間実行プロセスの場合、Claude は `run_in_background: true` を設定してコマンドをバックグラウンドタスクとして開始し、実行中に作業を続けることができます。`/tasks` でバックグラウンドタスクをリストアップして停止します。そこから停止するか、デスクトップアプリなどの接続されたクライアントから停止すると、Claude は待機する代わりに先に進みます。サブエージェントがコマンドを開始した場合、先に進むのはそのサブエージェントです。198開発サーバーやウォッチビルドなどの長時間実行プロセスの場合、Claude は `run_in_background: true` を設定してコマンドをバックグラウンドタスクとして開始し、実行中に作業を続けることができます。`/tasks` でバックグラウンドタスクをリストアップして停止します。そこから停止するか、デスクトップアプリなどの接続されたクライアントから停止すると、Claude は待機する代わりに先に進みます。サブエージェントがコマンドを開始した場合、先に進むのはそのサブエージェントです。

199 199 

200[フォアグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)が開始したコマンドは、そのサブエージェントの実行が終了すると停止します。完了したか、失敗したか、中断されたかに関係なく。メインの会話またはバックグラウンドサブエージェントが開始したコマンドは、最終応答の後も実行し続けます。終了するまで、停止されるまで、またはその時間制限に達するまで。`-p` フラグを使用した非対話型モードでは、[バックグラウンドコマンドは実行の最終結果の直後に終了します](/docs/ja/headless#background-tasks-at-exit)。200<h4 id="when-a-background-command-stops">

201 バックグラウンドコマンドが停止するとき

202</h4>

203 

204[フォアグラウンドサブエージェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background)が開始したコマンドは、そのサブエージェントの実行が終了すると停止します。完了したか、失敗したか、中断されたかに関係なく。メインの会話またはバックグラウンドサブエージェントが開始したコマンドは、最終応答の後も実行し続けます。終了するまで、停止されるまで、またはその[時間制限](#time-limit-for-background-commands)に達するまで。`-p` フラグを使用した非対話型モードでは、[バックグラウンドコマンドは実行の最終結果の直後に終了します](/docs/ja/headless#background-tasks-at-exit)。

205 

206<h4 id="time-limit-for-background-commands">

207 バックグラウンドコマンドの時間制限

208</h4>

201 209 

202Bash および PowerShell バックグラウンドコマンドには時間制限があり、コマンドがバックグラウンドに入った時点からカウントされます。210Bash および PowerShell バックグラウンドコマンドには時間制限があり、コマンドがバックグラウンドに入った時点からカウントされます。

203 211 

204* Claude がバックグラウンドで開始するコマンドは 30 分、または Claude が `run_in_background` で渡す `timeout` を取得します。最大 2 時間まで。212* Claude がバックグラウンドで開始するコマンドは 30 分、または Claude が `run_in_background` で渡す `timeout` を取得します。最大 2 時間まで。

205* フォアグラウンドで開始してからバックグラウンドに移動するコマンド。例えば `Ctrl+B` で、またはそのタイムアウトで、移動から 30 分を取得します。213* フォアグラウンドで開始してからバックグラウンドに移動するコマンド。例えば `Ctrl+B` で、またはそのタイムアウトで、移動から 30 分を取得します。

206 214 

215バックグラウンドコマンドが時間制限に達すると、Claude Code はそれを停止し、Claude に理由を伝えます。Claude は、作業がまだ必要な場合、より長い `timeout` でコマンドを再度開始できます。停止通知は `Background command "<description>" was stopped after reaching its background time limit` と読みます。

216 

217<h4 id="raise-the-time-limit-for-background-commands">

218 バックグラウンドコマンドの時間制限を上げる

219</h4>

220 

2072 つの[環境変数](/docs/ja/env-vars)がこれらの制限を上げます。Bash および PowerShell コマンド同様。両方ともミリ秒を取得し、どちらも制限を短縮することはできません。低い値は 30 分のデフォルトと 2 時間の最大値を保ちます。2212 つの[環境変数](/docs/ja/env-vars)がこれらの制限を上げます。Bash および PowerShell コマンド同様。両方ともミリ秒を取得し、どちらも制限を短縮することはできません。低い値は 30 分のデフォルトと 2 時間の最大値を保ちます。

208 222 

209* `BASH_DEFAULT_TIMEOUT_MS` を `1800000` より上に設定して、30 分のデフォルトをその値に置き換えます。Claude が `timeout` なしで開始するコマンドと移動されたコマンドの両方に対して。223* `BASH_DEFAULT_TIMEOUT_MS` を `1800000` より上に設定して、30 分のデフォルトをその値に置き換えます。Claude が `timeout` なしで開始するコマンドと移動されたコマンドの両方に対して。

210* `BASH_MAX_TIMEOUT_MS` を `7200000` より上に設定して、2 時間の最大値をその値に上げます。`BASH_DEFAULT_TIMEOUT_MS` を `7200000` より上に設定すると、最大値が同じ方法で上がります。224* `BASH_MAX_TIMEOUT_MS` を `7200000` より上に設定して、2 時間の最大値をその値に上げます。`BASH_DEFAULT_TIMEOUT_MS` を `7200000` より上に設定すると、最大値が同じ方法で上がります。

211 225 

212バックグラウンドコマンドが時間制限に達すると、Claude Code はそれを停止し、Claude に理由を伝えます。Claude は、作業がまだ必要な場合、より長い `timeout` でコマンドを再度開始できます。停止通知は `Background command "<description>" was stopped after reaching its background time limit` と読みます。226<h4 id="foreground-commands-that-move-to-the-background">

227 フォアグラウンドコマンドがバックグラウンドに移動する

228</h4>

213 229 

214フォアグラウンドコマンドが完了せずにタイムアウトに達すると、Claude Code はそれを停止する代わりにバックグラウンドに移動します。ただし、コマンドが `sleep` で始まる場合は除きます。移動されたコマンドの時間制限は移動からカウントされ、フォアグラウンドサブエージェントの移動されたコマンドはそのサブエージェントの実行が終了すると停止します。230フォアグラウンドコマンドが完了せずにタイムアウトに達すると、Claude Code はそれを停止する代わりにバックグラウンドに移動します。ただし、コマンドが `sleep` で始まる場合は除きます。移動されたコマンドの[時間制限](#time-limit-for-background-commands)は移動からカウントされ、フォアグラウンドサブエージェントの移動されたコマンドはそのサブエージェントの実行が終了すると停止します。

215 231 

216[`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/ja/env-vars#variables) を設定すると、バックグラウンドタスク機能の残りと共に自動バックグラウンド化を無効にします。232[`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/ja/env-vars#variables) を設定すると、バックグラウンドタスク機能の残りと共に自動バックグラウンド化を無効にします。

217 233 

58 58 

59 * **アクティビティバー**：左サイドバーの Spark アイコンをクリックしてセッションリストを開きます。任意のセッションをクリックして[優先位置](#extension-settings)で開くか、新しいセッションを開始します。このアイコンはアクティビティバーに常に表示されます。59 * **アクティビティバー**：左サイドバーの Spark アイコンをクリックしてセッションリストを開きます。任意のセッションをクリックして[優先位置](#extension-settings)で開くか、新しいセッションを開始します。このアイコンはアクティビティバーに常に表示されます。

60 * **コマンドパレット**：`Cmd+Shift+P`（Mac）または `Ctrl+Shift+P`（Windows/Linux）を押し、「Claude Code」と入力して、「Open in New Tab」などのオプションを選択します。60 * **コマンドパレット**：`Cmd+Shift+P`（Mac）または `Ctrl+Shift+P`（Windows/Linux）を押し、「Claude Code」と入力して、「Open in New Tab」などのオプションを選択します。

61 * **ステータスバー**：[`preferredLocation`](#extension-settings) を `sidebar` に設定した場合、または **Claude Code: Open in Side Bar** で Claude を開いた場合、ウィンドウの右下隅の **✻ Claude Code** をクリックします。ファイルが開いていない場合でも機能します。61 * **ステータスバー**：ウィンドウの右下隅の **✻ Claude Code** をクリックします。ファイルが開いていない場合でも機能します。

62 62 

63 Claude パネルをドラッグして VS Code 内の任意の場所に移動できます。詳細は[ワークフローをカスタマイズする](#customize-your-workflow)を参照してください。63 Claude パネルをドラッグして VS Code 内の任意の場所に移動できます。詳細は[ワークフローをカスタマイズする](#customize-your-workflow)を参照してください。

64 </Step>64 </Step>

362 362 

363プラグインタブでは、以下のことができます。363プラグインタブでは、以下のことができます。

364 364 

365* **インストール済みプラグイン**がトップに表示され、トグルスイッチで有効または無効にできます365* **インストール済みプラグイン**がトップに表示され、トグルスイッチで有効または無効にできます。

366 * プロジェクトの共有 `.claude/settings.json` で有効になっているプラグインをオフにすると、拡張機能は最初に確認を求めます。**自分のみ無効にする**はあなただけのためにオフにし、**全員のために無効にする**は共有ファイルを変更します。

366* 設定されたマーケットプレイスからの**利用可能なプラグイン**が下に表示されます367* 設定されたマーケットプレイスからの**利用可能なプラグイン**が下に表示されます

367* 名前または説明でプラグインをフィルタリングするために検索します368* 名前または説明でプラグインをフィルタリングするために検索します

368* 利用可能なプラグインの**インストール**をクリックします369* 利用可能なプラグインの**インストール**をクリックします

373* **このプロジェクトのためにインストール**：プロジェクト協力者と共有（プロジェクトスコープ）374* **このプロジェクトのためにインストール**：プロジェクト協力者と共有（プロジェクトスコープ）

374* **ローカルにインストール**：このリポジトリのみ、あなただけ（ローカルスコープ）375* **ローカルにインストール**：このリポジトリのみ、あなただけ（ローカルスコープ）

375 376 

377インストールが完了すると、フォームはまだ設定されていないプラグインの[設定オプション](/docs/ja/plugins/components#user-configuration)を求めます。後でオプションを確認または変更するには、プラグインの行の歯車アイコンをクリックします。

378 

379機密テキストフィールドはマスクされ、以前保存したシークレットは\*\*（変更なし）\*\*と表示されます。保存された値を保持するには、フィールドを空白のままにします。

380 

381変更を保存した後、開いているセッションはプラグインをリロードし、ダイアログは**プラグイン変更を適用するために Claude を再起動してください**と表示します。

382 

383<h3 id="uninstall-plugins">

384 プラグインをアンインストールする

385</h3>

386 

387各インストール済み行は、それがインストールされている[スコープ](/docs/ja/plugins/install#choose-an-install-scope)を示します。そのインストールをアンインストールするには、行のゴミ箱アイコンをクリックします。薄いゴミ箱アイコンは、このワークスペースからアンインストールできない行（組織が管理するプラグインや別のプロジェクト用にインストールされたプラグインなど）を示します。

388 

389拡張機能は 2 つのケースで最初に確認を求めます：

390 

391* **プロジェクトの共有 `.claude/settings.json` で有効になっているプラグイン**：**自分のみ無効にする**を選択します。これはプラグインを協力者のためにインストール状態に保ちます。または**全員のためにアンインストール**を選択します。これはプロジェクトのインストールを [`--keep-data`](/docs/ja/plugins/cli-reference#what-an-uninstall-deletes-and-keeps) で削除するため、プラグインの保存されたデータディレクトリは残ります。既にプラグインを自分のためにオフにしている場合、ゴミ箱アイコンは質問なしにあなた自身のインストールを削除します。

392* **それ以外の場合、保存されたデータを持つプラグインの最後のインストール**：データを保持するか削除するかを選択します。**保持**がデフォルトです

393 

376<h3 id="share-a-plugin-install-link">394<h3 id="share-a-plugin-install-link">

377 プラグインインストールリンクを共有する395 プラグインインストールリンクを共有する

378</h3>396</h3>

407 425 

408* GitHub リポジトリ、URL、またはローカルパスを入力して、新しいマーケットプレイスを追加します426* GitHub リポジトリ、URL、またはローカルパスを入力して、新しいマーケットプレイスを追加します

409* 更新アイコンをクリックして、マーケットプレイスのプラグインリストを更新します427* 更新アイコンをクリックして、マーケットプレイスのプラグインリストを更新します

410* ゴミ箱アイコンをクリックして、マーケットプレイスを削除します428* ゴミ箱アイコンをクリックして、マーケットプレイスを削除します。削除すると[それからインストールしたすべてのプラグインがアンインストールされます](/docs/ja/plugins/install#manage-marketplaces)。そのため、確認ではそれらのプラグインが最初に名前で示されます

429 

430ダイアログで加えたプラグイン変更は、その VS Code ウィンドウで開いている Claude Code セッションにすぐに適用されます。

411 431 

412ダイアログで加えたプラグイン変更は、その VS Code ウィンドウで開いている Claude Code セッションにすぐに適用されます。ダイアログを開いたセッションがプラグインをリロードできない場合、ダイアログは再度試すか、そのセッションで Claude を再起動するオプションを提供します。432ダイアログを開いたセッションがプラグインをリロードできない場合、ダイアログは再度試すか、そのセッションで Claude を再起動するオプションを提供します。

413 433 

414<Note>434<Note>

415 VS Code のプラグイン管理は、内部的に同じ CLI コマンドを使用しています。拡張機能で設定したプラグインとマーケットプレイスは CLI でも利用でき、その逆も同様です。435 VS Code のプラグイン管理は、内部的に同じ CLI コマンドを使用しています。拡張機能で設定したプラグインとマーケットプレイスは CLI でも利用でき、その逆も同様です。

7884. **競合する拡張機能を無効にする**：他の AI 拡張機能（Cline、Continue など）を一時的に無効にしてください8084. **競合する拡張機能を無効にする**：他の AI 拡張機能（Cline、Continue など）を一時的に無効にしてください

7895. **ワークスペースの信頼を確認する**：拡張機能は制限モードでは動作しません8095. **ワークスペースの信頼を確認する**：拡張機能は制限モードでは動作しません

790 810 

791または、[`preferredLocation`](#extension-settings) を `sidebar` に設定している場合、または **Claude Code: Open in Side Bar** で Claude を開いている場合は、**Status Bar**（右下隅）の「✻ Claude Code」をクリックしてください。これはファイルを開いていなくても動作します。**Command Palette**（`Cmd+Shift+P` / `Ctrl+Shift+P`）を使用して「Claude Code」と入力することもできます。811または、ウィンドウの右下隅の **Status Bar** にある **✻ Claude Code** をクリックしてください。これはファイルを開いていなくても動作します。**Command Palette**（`Cmd+Shift+P` / `Ctrl+Shift+P`）を使用して「Claude Code」と入力することもできます。

792 812 

793<h3 id="cmd-esc-does-nothing-on-macos">813<h3 id="cmd-esc-does-nothing-on-macos">

794 macOS で Cmd+Esc が機能しない814 macOS で Cmd+Esc が機能しない