SpyBara
Go Premium

Documentation 2026-09-23 23:57 UTC to 2026-09-24 22:57 UTC

9 files changed +41 −22. View all changes and history on the product overview
2026
Fri 25 23:58 Thu 24 22:57 Wed 23 23:57 Tue 22 23:59 Mon 21 22:59 Sun 20 23:59 Sat 19 23:57 Fri 18 23:58 Tue 15 23:58 Mon 14 22:58 Sat 12 03:02 Thu 10 23:00 Wed 9 22:58 Tue 8 20:00 Tue 1 21:02

costs.md +2 −0

Details

407 407 

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

409 409 

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

411 

410<h2 id="why-usage-climbs-in-a-long-session">412<h2 id="why-usage-climbs-in-a-long-session">

411 長いセッションで使用量が増加する理由413 長いセッションで使用量が増加する理由

412</h2>414</h2>

env-vars.md +3 −3

Details

349| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | ツール呼び出し、フック、ステータスラインコマンド用に PowerShell を生成するときに Claude Code が `-ExecutionPolicy Bypass` を渡すのを停止し、マシンの有効な実行ポリシーを尊重するには `1` に設定します。デフォルトでは Claude Code はプロセススコープで実行ポリシーをバイパスするため、`.ps1` スクリプトとモジュールインポートはデフォルト制限 Windows インストールで機能します。プロセススコープバイパスは、この設定に関係なく、グループポリシー `MachinePolicy` または `UserPolicy` をオーバーライドしません |349| `CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY` | ツール呼び出し、フック、ステータスラインコマンド用に PowerShell を生成するときに Claude Code が `-ExecutionPolicy Bypass` を渡すのを停止し、マシンの有効な実行ポリシーを尊重するには `1` に設定します。デフォルトでは Claude Code はプロセススコープで実行ポリシーをバイパスするため、`.ps1` スクリプトとモジュールインポートはデフォルト制限 Windows インストールで機能します。プロセススコープバイパスは、この設定に関係なく、グループポリシー `MachinePolicy` または `UserPolicy` をオーバーライドしません |

350| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | [非対話モード](/docs/ja/headless#background-tasks-at-exit) で `-p` フラグを使用した最終ターン後、バックグラウンドサブエージェントとワークフローを待機するアイドル待機の上限(ミリ秒単位)。アイドル待機は Claude がバックグラウンド結果を処理するターンを取るたびに再開されます。デフォルト:`600000`、または 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機を停止して終了します。`0` に設定して無期限に待機します。このキャップは、プレーンバックグラウンドシェルに適用される 5 秒の猶予期間とは別です。Claude Code v2.1.182 以降が必要です |350| `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` | [非対話モード](/docs/ja/headless#background-tasks-at-exit) で `-p` フラグを使用した最終ターン後、バックグラウンドサブエージェントとワークフローを待機するアイドル待機の上限(ミリ秒単位)。アイドル待機は Claude がバックグラウンド結果を処理するターンを取るたびに再開されます。デフォルト:`600000`、または 10 分。アイドル待機が上限に達すると、Claude Code は残りのバックグラウンドタスクの待機を停止して終了します。`0` に設定して無期限に待機します。このキャップは、プレーンバックグラウンドシェルに適用される 5 秒の猶予期間とは別です。Claude Code v2.1.182 以降が必要です |

351| `CLAUDE_CODE_PROCESS_WRAPPER` | Claude Code が独自のバイナリから開始するプロセス([エージェントビュー](/docs/ja/agent-view) セッションをホストするバックグラウンドサービスなど)を、`/opt/corp/launcher` などの argv プレフィックスとして指定されたコーポレートランチャーを通じて起動します。ユーザーまたは [管理設定](/docs/ja/managed-settings) の `env` ブロックで設定します。プロジェクトおよびローカル設定では設定できません。デタッチされたバックグラウンドサービスがそれを継承するため。[`processWrapper` 設定](/docs/ja/settings-reference#processwrapper) と同等です。Claude Code v2.1.210 以降が必要です。この変数は両方が設定されている場合に優先されます。VS Code 拡張機能は `claudeProcessWrapper` 設定を通じて独自のランチャーを個別に設定します。Windows では無視されます。値の形式、ランチャーがカバーするもの、ランチャーが満たす必要があるコントラクトについては、[コーポレートランチャーの背後で Claude Code を実行](/docs/ja/corporate-launcher) を参照してください。Claude Code v2.1.208 以降が必要です |351| `CLAUDE_CODE_PROCESS_WRAPPER` | Claude Code が独自のバイナリから開始するプロセス([エージェントビュー](/docs/ja/agent-view) セッションをホストするバックグラウンドサービスなど)を、`/opt/corp/launcher` などの argv プレフィックスとして指定されたコーポレートランチャーを通じて起動します。ユーザーまたは [管理設定](/docs/ja/managed-settings) の `env` ブロックで設定します。プロジェクトおよびローカル設定では設定できません。デタッチされたバックグラウンドサービスがそれを継承するため。[`processWrapper` 設定](/docs/ja/settings-reference#processwrapper) と同等です。Claude Code v2.1.210 以降が必要です。この変数は両方が設定されている場合に優先されます。VS Code 拡張機能は `claudeProcessWrapper` 設定を通じて独自のランチャーを個別に設定します。Windows では無視されます。値の形式、ランチャーがカバーするもの、ランチャーが満たす必要があるコントラクトについては、[コーポレートランチャーの背後で Claude Code を実行](/docs/ja/corporate-launcher) を参照してください。Claude Code v2.1.208 以降が必要です |

352| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR` と一緒に設定して、Claude Code がそのセッションのトランスクリプトと自動メモリを保存する `projects/` ディレクトリ名を選択します。作業ディレクトリパスから派生したものの代わりに。例えば、`CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` で開始すると、`/srv/tenant-a/projects/work/` の下に保存されます。`CLAUDE_CONFIG_DIR` が設定されていない場合、Claude Code はこの変数を無視し、`claude` を開始する環境からのみ読み取ります。設定ファイル `env` ブロックからは読み取りません。[プロジェクトディレクトリを自分で名前付け](/docs/ja/sessions#name-your-project-directory-yourself) を参照してください。Claude Code v2.1.234 以降が必要です |352| `CLAUDE_CODE_PROJECT_DIR_NAME` | `CLAUDE_CONFIG_DIR` と一緒に設定して、Claude Code がそのセッションのトランスクリプトと自動メモリを保存する `projects/` ディレクトリ名を選択します。作業ディレクトリパスから派生したものの代わりに。例えば、`CLAUDE_CONFIG_DIR=/srv/tenant-a CLAUDE_CODE_PROJECT_DIR_NAME=work claude` で開始すると、`/srv/tenant-a/projects/work/` の下に保存されます。`CLAUDE_CONFIG_DIR` が設定されていない場合、Claude Code はこの変数を無視します。また、この変数は `claude` を開始する環境からのみ読み取り、[設定ファイル `env` ブロック](#in-settings-files)からは読み取りません。[プロジェクトディレクトリを自分で名前付け](/docs/ja/sessions#name-the-project-directory-yourself) を参照してください。Claude Code v2.1.234 以降が必要です |

353| `CLAUDE_CODE_PROMPT_CACHE_TTL` | `5m` または `1h` に設定します。Claude Code が受け入れる唯一の値。メイン会話の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択します:対話的、`-p`、SDK ターン、およびそれらと一緒に実行されるヘルパー。`promptCacheTtl` 設定および `ENABLE_PROMPT_CACHING_1H` より優先されます。`FORCE_PROMPT_CACHING_5M` がそれをオーバーライドします。API は 1 時間のキャッシュ書き込みをより高いレートで請求します。Claude Code v2.1.242 以降が必要です |353| `CLAUDE_CODE_PROMPT_CACHE_TTL` | `5m` または `1h` に設定します。Claude Code が受け入れる唯一の値。メイン会話の [プロンプトキャッシュ TTL](/docs/ja/prompt-caching#cache-lifetime) を選択します:対話的、`-p`、SDK ターン、およびそれらと一緒に実行されるヘルパー。`promptCacheTtl` 設定および `ENABLE_PROMPT_CACHING_1H` より優先されます。`FORCE_PROMPT_CACHING_5M` がそれをオーバーライドします。API は 1 時間のキャッシュ書き込みをより高いレートで請求します。Claude Code v2.1.242 以降が必要です |

354| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | `ANTHROPIC_BASE_URL` がカスタムプロキシを指している場合、W3C トレースコンテキストを伝播するには `1` に設定します。伝播はモデルおよび HTTP MCP リクエストの `traceparent` ヘッダーと、Bash、PowerShell、フックサブプロセスの `TRACEPARENT` 環境変数をカバーします。デフォルトでは、伝播は Anthropic API への直接接続に接続されている場合にのみ有効になります。v2.1.152 で追加されました。[トレース(ベータ)](/docs/ja/monitoring-usage#traces-beta) を参照してください |354| `CLAUDE_CODE_PROPAGATE_TRACEPARENT` | `ANTHROPIC_BASE_URL` がカスタムプロキシを指している場合、W3C トレースコンテキストを伝播するには `1` に設定します。伝播はモデルおよび HTTP MCP リクエストの `traceparent` ヘッダーと、Bash、PowerShell、フックサブプロセスの `TRACEPARENT` 環境変数をカバーします。デフォルトでは、伝播は Anthropic API への直接接続に接続されている場合にのみ有効になります。v2.1.152 で追加されました。[トレース(ベータ)](/docs/ja/monitoring-usage#traces-beta) を参照してください |

355| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code をホストし、その代わりにモデルプロバイダーのルーティングを管理するホストプラットフォームによって設定されます。設定されている場合、Claude Code は `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` などの設定ファイルのプロバイダー選択、エンドポイント、認証変数を無視するため、ユーザー設定はホストのルーティングをオーバーライドできません。Claude Code は、[管理設定](/docs/ja/managed-settings) で配信されるマネージド設定ソースから、`model`、`fallbackModel`、`modelOverrides` などのモデル選択キーも無視するため、ホストのモデル設定は古い管理モデルピンより優先されます。Claude Code は、管理 `env` ブロックの `ANTHROPIC_MODEL` および `ANTHROPIC_DEFAULT_*_MODEL` ファミリーなどのモデル選択変数も無視します。管理設定の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストは、ホストが独自を提供しない限り、引き続き適用されます。Claude Code は、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry などのサードパーティプロバイダーで通常適用される自動テレメトリオプトアウトをスキップするため、テレメトリは標準 `DISABLE_TELEMETRY` オプトアウトに従います。[API プロバイダーごとのデフォルト動作](/docs/ja/data-usage#default-behaviors-by-api-provider) を参照してください |355| `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST` | Claude Code をホストし、その代わりにモデルプロバイダーのルーティングを管理するホストプラットフォームによって設定されます。設定されている場合、Claude Code は `CLAUDE_CODE_USE_BEDROCK`、`ANTHROPIC_BASE_URL`、`ANTHROPIC_API_KEY` などの設定ファイルのプロバイダー選択、エンドポイント、認証変数を無視するため、ユーザー設定はホストのルーティングをオーバーライドできません。Claude Code は、[管理設定](/docs/ja/managed-settings) で配信されるマネージド設定ソースから、`model`、`fallbackModel`、`modelOverrides` などのモデル選択キーも無視するため、ホストのモデル設定は古い管理モデルピンより優先されます。Claude Code は、管理 `env` ブロックの `ANTHROPIC_MODEL` および `ANTHROPIC_DEFAULT_*_MODEL` ファミリーなどのモデル選択変数も無視します。管理設定の [`availableModels`](/docs/ja/model-config#restrict-model-selection) 許可リストは、ホストが独自を提供しない限り、引き続き適用されます。Claude Code は、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry などのサードパーティプロバイダーで通常適用される自動テレメトリオプトアウトをスキップするため、テレメトリは標準 `DISABLE_TELEMETRY` オプトアウトに従います。[API プロバイダーごとのデフォルト動作](/docs/ja/data-usage#default-behaviors-by-api-provider) を参照してください |


461| `IS_DEMO` | デモモードを有効にするには、`1` などの空でない値に設定します:ヘッダーおよび `/status` 出力からメールアドレスと組織名を非表示にし、オンボーディングをスキップします。**`0` または `false` に設定してもデモモードを有効にします**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してオフにします。セッションをストリーミングまたは記録する場合に便利です |461| `IS_DEMO` | デモモードを有効にするには、`1` などの空でない値に設定します:ヘッダーおよび `/status` 出力からメールアドレスと組織名を非表示にし、オンボーディングをスキップします。**`0` または `false` に設定してもデモモードを有効にします**。ほとんどのオン/オフ変数とは異なり。変数を設定解除してオフにします。セッションをストリーミングまたは記録する場合に便利です |

462| `MAX_MCP_OUTPUT_TOKENS` | MCP ツール応答で許可される最大トークン数。Claude Code は出力が 10,000 トークンを超える場合に警告を表示します。[`anthropic/maxResultSizeChars`](/docs/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言するツールは、テキストコンテンツにはその文字制限を使用しますが、それらのツールからの画像コンテンツはこの変数の対象です(デフォルト:25000) |462| `MAX_MCP_OUTPUT_TOKENS` | MCP ツール応答で許可される最大トークン数。Claude Code は出力が 10,000 トークンを超える場合に警告を表示します。[`anthropic/maxResultSizeChars`](/docs/ja/mcp#raise-the-limit-for-a-specific-tool) を宣言するツールは、テキストコンテンツにはその文字制限を使用しますが、それらのツールからの画像コンテンツはこの変数の対象です(デフォルト:25000) |

463| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モードで `-p` フラグを使用して、モデルの応答が [`--json-schema`](/docs/ja/cli-reference#cli-flags) に対する検証に失敗した場合、Claude Code が許可する試行回数。その後、有効な出力がない場合、実行は失敗します。[ワークフロー](/docs/ja/workflows) サブエージェントの構造化出力が検証に失敗した場合にも同じキャップが適用されます。デフォルト 5。最初の試行と 4 回の再試行 |463| `MAX_STRUCTURED_OUTPUT_RETRIES` | 非対話モードで `-p` フラグを使用して、モデルの応答が [`--json-schema`](/docs/ja/cli-reference#cli-flags) に対する検証に失敗した場合、Claude Code が許可する試行回数。その後、有効な出力がない場合、実行は失敗します。[ワークフロー](/docs/ja/workflows) サブエージェントの構造化出力が検証に失敗した場合にも同じキャップが適用されます。デフォルト 5。最初の試行と 4 回の再試行 |

464| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) の固定トークン予算。Claude Code はそれを要求の最大出力トークンの 1 トークン下でキャップし、1,024 未満にはしません。[`CLAUDE_CODE_MAX_OUTPUT_TOKENS`](/docs/ja/model-config#adjust-effort-level) でそのリミットを設定する方法を参照してください。設定されていない場合、[適応的推論](/docs/ja/model-config#adjust-effort-level) を持つモデルは独自の思考深度を選択し、他のモデルはキャップを使用します。Anthropic API で思考を無効にするには `0` に設定します。Opus 5.5 および Fable モデルを除き、思考をオフにすることはできません。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`0` は代わりに `thinking` パラメーターを省略します。Anthropic API で思考がオフの場合、Claude Code は、Opus 5 などの [その組み合わせを受け入れないモデル](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off) に努力 `high` を送信します。Claude Code は、適応的推論モデルの非ゼロ値を無視します。ただし、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` が適応的推論をオフにするモデルを除きます |464| `MAX_THINKING_TOKENS` | [拡張思考](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) の固定トークン予算。Claude Code はそれを要求の最大出力トークンの 1 トークン下でキャップし、1,024 未満にはしません。そのリミットの設定方法については、`CLAUDE_CODE_MAX_OUTPUT_TOKENS` を参照してください。設定されておらず思考が有効な場合、[適応的推論](/docs/ja/model-config#adjust-effort-level) を持つモデルは独自の思考深度を選択し、他のモデルはキャップを使用します。Anthropic API で思考を無効にするには `0` に設定します。ただし、思考をオフにできない Opus 5.5 および Fable モデルは除きます。[サードパーティプロバイダー](/docs/ja/third-party-integrations) では、`0` は代わりに `thinking` パラメーターを省略します。Anthropic API で思考がオフの場合、Claude Code は、Opus 5 など、[その組み合わせを受け入れない](/docs/ja/errors#effort-isnt-available-with-thinking-turned-off) とわかっているモデルに、より高いレベルではなく努力 `high` を送信します。Claude Code は、適応的推論モデルの非ゼロ値を無視します。ただし、`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` が適応的推論をオフにするモデルを除きます |

465| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的なプロンプトを回避します |465| `MCP_CLIENT_SECRET` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) が必要な MCP サーバーの OAuth クライアントシークレット。`--client-secret` でサーバーを追加するときに対話的なプロンプトを回避します |

466| `MCP_CONNECTION_NONBLOCKING` | MCP サーバーが最初のクエリの前に接続するのを待機するかどうかを制御します。MCP スタートアップはデフォルトで非ブロッキングです:サーバーはバックグラウンドで接続し、完了するとそれらのツールが利用可能になります。最初のクエリの前にサーバーが接続するのを待機するには `0` に設定します。[`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、[検出キャッシュ](/docs/ja/mcp#server-status-detail) から提供される場合を除き、関係なくスタートアップを待機させます。ツールは最初のプロンプトが構築されるときに存在する必要があります。非対話モード(`-p`)で `--input-format stream-json` がない場合、Claude Code は最初のターンの前に保留中のサーバーを待機します。[`--mcp-config`](/docs/ja/cli-reference#cli-flags) を明示的に渡すと、待機にはより長いデッドラインがあります。キャッシュされたサーバーの例外については、そのフラグのエントリを参照してください |466| `MCP_CONNECTION_NONBLOCKING` | MCP サーバーが最初のクエリの前に接続するのを待機するかどうかを制御します。MCP スタートアップはデフォルトで非ブロッキングです:サーバーはバックグラウンドで接続し、完了するとそれらのツールが利用可能になります。最初のクエリの前にサーバーが接続するのを待機するには `0` に設定します。[`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) で設定されたサーバーは、[検出キャッシュ](/docs/ja/mcp#server-status-detail) から提供される場合を除き、関係なくスタートアップを待機させます。ツールは最初のプロンプトが構築されるときに存在する必要があります。非対話モード(`-p`)で `--input-format stream-json` がない場合、Claude Code は最初のターンの前に保留中のサーバーを待機します。[`--mcp-config`](/docs/ja/cli-reference#cli-flags) を明示的に渡すと、待機にはより長いデッドラインがあります。キャッシュされたサーバーの例外については、そのフラグのエントリを参照してください |

467| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップがツールリストをスナップショットする前に接続バッチを待機する時間(ミリ秒単位)(デフォルト:5000)。`MCP_CONNECTION_NONBLOCKING=0` または [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。デッドラインで保留中のサーバーはバックグラウンドで接続し続けます。`MCP_TIMEOUT` とは異なり、個別のサーバーの接続試行をバウンドします |467| `MCP_CONNECT_TIMEOUT_MS` | ブロッキング MCP スタートアップがツールリストをスナップショットする前に接続バッチを待機する時間(ミリ秒単位)(デフォルト:5000)。`MCP_CONNECTION_NONBLOCKING=0` または [`alwaysLoad: true`](/docs/ja/mcp#exempt-a-server-from-deferral) でマークされたサーバーに適用されます。デッドラインで保留中のサーバーはバックグラウンドで接続し続けます。`MCP_TIMEOUT` とは異なり、個別のサーバーの接続試行をバウンドします |


470| `MCP_DISCOVERY_CACHE_STRIKES` | 開始時に [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリが `MCP_DISCOVERY_CACHE_TTL_S` より古い場合、Claude Code はバックグラウンドでリフレッシュします。この変数は、Claude Code がエントリを破棄し、代わりに次の開始でサーバーに接続する前に、連続でリフレッシュが失敗できる回数を設定します(デフォルト:1)。ネットワーク接続が時々ドロップする場合は上げます。1 回の失敗したリフレッシュがエントリを破棄しないようにするため。Claude Code v2.1.238 以降が必要です |470| `MCP_DISCOVERY_CACHE_STRIKES` | 開始時に [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリが `MCP_DISCOVERY_CACHE_TTL_S` より古い場合、Claude Code はバックグラウンドでリフレッシュします。この変数は、Claude Code がエントリを破棄し、代わりに次の開始でサーバーに接続する前に、連続でリフレッシュが失敗できる回数を設定します(デフォルト:1)。ネットワーク接続が時々ドロップする場合は上げます。1 回の失敗したリフレッシュがエントリを破棄しないようにするため。Claude Code v2.1.238 以降が必要です |

471| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code が [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリをリフレッシュせずに使用する秒数(デフォルト:900)。エントリがそれより古い開始では、Claude Code は引き続きそれを使用しますが、バックグラウンドでリフレッシュします。エントリが `MCP_DISCOVERY_CACHE_MAX_STALE_S` より古い場合、Claude Code は代わりに破棄します。Claude Code は値を `MCP_DISCOVERY_CACHE_MAX_STALE_S`(デフォルト 4 時間)でキャップします。v2.1.238 より前は、Claude Code は値をキャップしませんでした |471| `MCP_DISCOVERY_CACHE_TTL_S` | Claude Code が [検出キャッシュ](/docs/ja/mcp#server-status-detail) エントリをリフレッシュせずに使用する秒数(デフォルト:900)。エントリがそれより古い開始では、Claude Code は引き続きそれを使用しますが、バックグラウンドでリフレッシュします。エントリが `MCP_DISCOVERY_CACHE_MAX_STALE_S` より古い場合、Claude Code は代わりに破棄します。Claude Code は値を `MCP_DISCOVERY_CACHE_MAX_STALE_S`(デフォルト 4 時間)でキャップします。v2.1.238 より前は、Claude Code は値をキャップしませんでした |

472| `MCP_OAUTH_CALLBACK_PORT` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) を使用して MCP サーバーを追加するときの OAuth リダイレクトコールバック用の固定ポート。`--callback-port` の代替 |472| `MCP_OAUTH_CALLBACK_PORT` | [事前設定された認証情報](/docs/ja/mcp#use-pre-configured-oauth-credentials) を使用して MCP サーバーを追加するときの OAuth リダイレクトコールバック用の固定ポート。`--callback-port` の代替 |

473| `MCP_PROTOCOL_NEGOTIATION` | [v2 MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) でのみ、Claude Code が MCP プロトコルリビジョン 2026-07-28 のサーバーをプローブするかどうか。HTTP、claude.ai コネクター、stdio サーバーをプローブするには `auto` に設定します。プローブに応答しないサーバーは以前のプロトコルで接続します。SSE および WebSocket サーバーは常にそうします。すべてのサーバーのプローブをスキップするには `legacy` に設定します。変数がない場合、Claude Code は HTTP サーバーをプローブし、[機能フラグを取得](/docs/ja/mcp#mcp-client-runtimes) するセッションで claude.ai コネクターサーバーもプローブします。その他の値は警告で無視されます。Claude Code v2.1.221 以降が必要です |473| `MCP_PROTOCOL_NEGOTIATION` | [v2 MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) でのみ、Claude Code が MCP プロトコルリビジョン 2026-07-28 のサーバーをプローブするかどうか。HTTP、claude.ai コネクター、stdio サーバーをプローブするには `auto` に設定します。プローブに応答しないサーバーは以前のプロトコルで接続します。SSE および WebSocket サーバーは常にそうします。すべてのサーバーのプローブをスキップするには `legacy` に設定します。変数がない場合、Claude Code は HTTP サーバーをプローブし、[機能フラグを取得](#features-that-need-feature-flag-fetching) するセッションで claude.ai コネクターサーバーもプローブします。その他の値は無視され、デバッグログに警告が書き込まれます。Claude Code v2.1.221 以降が必要です |

474| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列で接続するリモート MCP サーバー(HTTP/SSE)の最大数(デフォルト:20) |474| `MCP_REMOTE_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列で接続するリモート MCP サーバー(HTTP/SSE)の最大数(デフォルト:20) |

475| `MCP_SDK_GENERATION` | このプロセスが MCP サーバーに接続する [MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) をピン留めします:`v1`(MCP TypeScript SDK 1.x に基づく)または `v2`([MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) に基づく)。変数がない場合、Claude Code は v2 を使用します。そのセクションにリストされているバージョンから開始。Claude Code v2.1.221 以降では、v2 ランタイムは MCP OAuth サーバーが認可応答で返す発行者をチェックし、一致しない場合、`Issuer mismatch in authorization response` で始まるエラーでサインインに失敗します。v1 ランタイムはこのチェックを実行しません。認識されない値を設定すると、Claude Code はそれを無視し、デバッグログに警告を書き込みます。Claude Code はプロセスごとに値を 1 回読み取ります。Claude Code v2.1.218 以降が必要です |475| `MCP_SDK_GENERATION` | このプロセスが MCP サーバーに接続する [MCP クライアントランタイム](/docs/ja/mcp#mcp-client-runtimes) をピン留めします:`v1`(MCP TypeScript SDK 1.x に基づく)または `v2`([MCP TypeScript SDK 2.0](https://ts.sdk.modelcontextprotocol.io/v2/) に基づく)。変数がない場合、Claude Code は v2 を使用します。そのセクションにリストされているバージョンから開始。Claude Code v2.1.221 以降では、v2 ランタイムは MCP OAuth サーバーが認可応答で返す発行者をチェックし、一致しない場合、`Issuer mismatch in authorization response` で始まるエラーでサインインに失敗します。v1 ランタイムはこのチェックを実行しません。認識されない値を設定すると、Claude Code はそれを無視し、デバッグログに警告を書き込みます。Claude Code はプロセスごとに値を 1 回読み取ります。Claude Code v2.1.218 以降が必要です |

476| `MCP_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列で接続するローカル MCP サーバー(stdio)の最大数(デフォルト:3) |476| `MCP_SERVER_CONNECTION_BATCH_SIZE` | スタートアップ中に並列で接続するローカル MCP サーバー(stdio)の最大数(デフォルト:3) |

Details

439* `Tab` キーまたは `Right arrow` キーを押して提案をプロンプト入力に配置し、`Enter` キーを押して送信します439* `Tab` キーまたは `Right arrow` キーを押して提案をプロンプト入力に配置し、`Enter` キーを押して送信します

440* 入力を開始して提案を閉じます440* 入力を開始して提案を閉じます

441 441 

442Claude Code は、これらの次のプロンプト提案を、会話のプロンプトキャッシュを再利用するバックグラウンドリクエストで生成するため、追加コストは最小限です。442Claude Code は、これらの次のプロンプト提案を、セッションが使用しているのと同じモデルへのバックグラウンドリクエストで生成します。このリクエストはプランの使用制限または API コストにカウントされます。会話のプロンプトキャッシュを再利用するため、主にキャッシュ読み取りと少数の出力トークンで構成されるため、追加コストは最小限です。

443 443 

444<h3 id="when-claude-code-skips-suggestions">444<h3 id="when-claude-code-skips-suggestions">

445 Claude Code が提案をスキップする場合445 Claude Code が提案をスキップする場合

Details

95 * **完全な VM サンドボックス内**: Claude Desktop マネージド構成が [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox) を設定する場合、Claude Code は仮想マシン内で実行され、デバイスの MDM ポリシーおよびマネージド設定ファイルは存在しません。95 * **完全な VM サンドボックス内**: Claude Desktop マネージド構成が [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox) を設定する場合、Claude Code は仮想マシン内で実行され、デバイスの MDM ポリシーおよびマネージド設定ファイルは存在しません。

96 * **リモート Cowork セッション**: これらは Anthropic 管理 VM 上で実行され、Claude Code はデバイスポリシーを読み取ることができません。96 * **リモート Cowork セッション**: これらは Anthropic 管理 VM 上で実行され、Claude Code はデバイスポリシーを読み取ることができません。

97 97 

98 [サーフェスカバレッジ](/docs/ja/model-config#surface-coverage) テーブルは Cowork と他のサーフェスを比較しています。98 セッションが実行される場所に関係なく、claude.ai は管理コンソールの [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) および [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) リストを、誰かが claude.ai 上の git リポジトリからマーケットプレイスを追加するか、Cowork タブの **Customize** から追加する場合に自動的に適用します。[制限がどのように機能するか](/docs/ja/plugin-marketplaces#how-restrictions-work) はそのチェックについて説明しています。[サーフェスカバレッジ](/docs/ja/model-config#surface-coverage) テーブルは Cowork と他のサーフェスを比較しています。

99* **実行中のセッション**: ほとんどの変更は、[配信メカニズムテーブル](#choose-a-delivery-mechanism) のスケジュールに従って、再起動なしで実行中のセッションに到達します。99* **実行中のセッション**: ほとんどの変更は、[配信メカニズムテーブル](#choose-a-delivery-mechanism) のスケジュールに従って、再起動なしで実行中のセッションに到達します。

100 * [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh)、[`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion)、および [いくつかのユーザー編集可能キー](/docs/ja/settings#when-edits-take-effect) への変更は、次のセッション開始時に有効になります。100 * [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh)、[`requiredMinimumVersion`](/docs/ja/settings-reference#requiredminimumversion)、および [いくつかのユーザー編集可能キー](/docs/ja/settings#when-edits-take-effect) への変更は、次のセッション開始時に有効になります。

101 * 新規または変更された [`policyHelper`](/docs/ja/settings-reference#policyhelper) エントリは次の起動時に有効になります。ただし、起動時にサーバーマネージド設定によってシャドウされたヘルパーは、フェッチがそれらの設定が削除されたことを報告するとすぐに実行されます。101 * 新規または変更された [`policyHelper`](/docs/ja/settings-reference#policyhelper) エントリは次の起動時に有効になります。ただし、起動時にサーバーマネージド設定によってシャドウされたヘルパーは、フェッチがそれらの設定が削除されたことを報告するとすぐに実行されます。

memory.md +5 −7

Details

379既定の動作を変更する場合(例えば、Claude に常に両方のファイルを読み込ませたい、`CLAUDE.md` のみを読み込ませたい、または組織が管理する指示のみを読み込ませたい場合)は、[**Project instructions** セッティングを変更](#choose-which-instruction-files-load) してください。379既定の動作を変更する場合(例えば、Claude に常に両方のファイルを読み込ませたい、`CLAUDE.md` のみを読み込ませたい、または組織が管理する指示のみを読み込ませたい場合)は、[**Project instructions** セッティングを変更](#choose-which-instruction-files-load) してください。

380 380 

381<Note>381<Note>

382 `AGENTS.md` を直接読み込むには Claude Code v2.1.277 以降が必要です。Amazon Bedrock 上のセッションやテレメトリが無効になっているセッションなど、一部のセッションでは Claude が [`AGENTS.md` を読み込むことができない](#when-agents-md-support-is-unavailable) ため、代わりに [`CLAUDE.md` からインポート](#share-one-file-with-other-coding-tools) してください。382 `AGENTS.md` を直接読み込むには Claude Code v2.1.277 以降が必要です。一部のセッションでは Claude が [`AGENTS.md` を読み込むことができない](#when-agents-md-support-is-unavailable) ため、代わりに [`CLAUDE.md` からインポート](#share-one-file-with-other-coding-tools) してください。

383</Note>383</Note>

384 384 

385<h3 id="when-claude-code-reads-agents-md">385<h3 id="when-claude-code-reads-agents-md">


436これらのセッションでは Claude は `CLAUDE.md` ファイルのみを読み込み、**Project instructions** は `/config` セッティングパネルに表示されません。436これらのセッションでは Claude は `CLAUDE.md` ファイルのみを読み込み、**Project instructions** は `/config` セッティングパネルに表示されません。

437 437 

438* Claude Code v2.1.277 より前のバージョンを使用している438* Claude Code v2.1.277 より前のバージョンを使用している

439* セッション が Anthropic から [フィーチャーフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)(例えば Amazon Bedrock または別のサードパーティプロバイダーを使用している、またはテレメトリを無効にしている)。リンク先のセクションに完全なリストがあります

440* `AGENTS.md` サポート付きのバージョンに [インストールまたはアップグレード](/docs/ja/env-vars#first-session-after-an-install-or-upgrade) した後の最初のセッションです。次のセッションから Claude は `AGENTS.md` を読み込みます

441* 組み込み `agents-md` プラグインを `/plugin` で無効にしました439* 組み込み `agents-md` プラグインを `/plugin` で無効にしました

440* 一部の場合、v2.1.276 以前から [アップグレード](/docs/ja/env-vars#first-session-after-an-install-or-upgrade) した後の最初のセッションです。次のセッションから Claude は `AGENTS.md` を読み込みます

442 441 

443これらのセッションで Claude に `AGENTS.md` を提供するには、[`CLAUDE.md` からインポート](#share-one-file-with-other-coding-tools) してください。442v2.1.281 より前では、Amazon Bedrock 上のセッションやテレメトリが無効になっているセッションなど、一部のセッションは `CLAUDE.md` ファイルのみを読み込みます。これらのバージョンでは Claude Code を更新してください。これらのセッションのいずれかで Claude に `AGENTS.md` を提供するには、[`CLAUDE.md` からインポート](#share-one-file-with-other-coding-tools) してください。

444 443 

445<h3 id="where-agents-md-differs-from-claude-md">444<h3 id="where-agents-md-differs-from-claude-md">

446 AGENTS.md が CLAUDE.md と異なる点445 AGENTS.md が CLAUDE.md と異なる点


637リポジトリに `AGENTS.md` があり、Claude がそれが何を言っているかを知らないようである場合、通常の原因はプロジェクトパスのどこかに `CLAUDE.md` があることです。デフォルトでは、Claude は、作業ディレクトリまたはそれより上のディレクトリに `CLAUDE.md` または `CLAUDE.local.md` がない場合にのみ `AGENTS.md` を読み込みます(`~/.claude/CLAUDE.md` を除く)。以下の順序で確認します:636リポジトリに `AGENTS.md` があり、Claude がそれが何を言っているかを知らないようである場合、通常の原因はプロジェクトパスのどこかに `CLAUDE.md` があることです。デフォルトでは、Claude は、作業ディレクトリまたはそれより上のディレクトリに `CLAUDE.md` または `CLAUDE.local.md` がない場合にのみ `AGENTS.md` を読み込みます(`~/.claude/CLAUDE.md` を除く)。以下の順序で確認します:

638 637 

6391. 作業ディレクトリまたはそれより上のディレクトリ(`~/.claude/CLAUDE.md` を除く)で `CLAUDE.md`、`.claude/CLAUDE.md`、または `CLAUDE.local.md` を探します。見つかった場合、**Project instructions** を `claude-md-and-agents-md` に設定しない限り、Claude はそれを `AGENTS.md` の代わりに読み込みます。6381. 作業ディレクトリまたはそれより上のディレクトリ(`~/.claude/CLAUDE.md` を除く)で `CLAUDE.md`、`.claude/CLAUDE.md`、または `CLAUDE.local.md` を探します。見つかった場合、**Project instructions** を `claude-md-and-agents-md` に設定しない限り、Claude はそれを `AGENTS.md` の代わりに読み込みます。

6402. `claude --version` を実行し、v2.1.277 以降であることを確認します。6392. `claude --version` を実行し、v2.1.277 以降であることを確認します。v2.1.281 より前では、Amazon Bedrock 上のセッションやテレメトリが無効なセッションなど、一部のセッションは [AGENTS.md を読み込むことができない](#when-agents-md-support-is-unavailable) ため、これらのバージョンでは v2.1.281 以降に更新してください。

6413. セッションが [AGENTS.md を読み込むことができない](#when-agents-md-support-is-unavailable) セッション(サードパーティプロバイダーのセッションやテレメトリが無効なセッションなど)であるかどうかを確認します。6403. セッションで `/config` を入力して設定パネルを開き、**Project instructions** が `claude-md` または `managed-only` に設定されていないことを確認します。そこに設定が表示されない場合、セッションは [AGENTS.md を読み込むことができない](#when-agents-md-support-is-unavailable) セッションです。

6424. セッションで `/config` を入力して設定パネルを開き、**Project instructions** が `claude-md` または `managed-only` に設定されていないことを確認します。そこに設定が表示されない場合、セッションは [AGENTS.md を読み込むことができない](#when-agents-md-support-is-unavailable) セッションです。

643 641 

644Claude が `AGENTS.md` を読み込んだかどうかを確認するには、`/memory` を実行し、リストでそのパスを探します。642Claude が `AGENTS.md` を読み込んだかどうかを確認するには、`/memory` を実行し、リストでそのパスを探します。

645 643 

plugin-evals.md +19 −9

Details

459 実行がアクセスできるもの459 実行がアクセスできるもの

460</h2>460</h2>

461 461 

462`claude plugin eval` はターゲットプラグインのスキルとフックをロードし、マシン上で、あなたとして eval スイートを実行します。プラグインを指すことは `claude --plugin-dir` と同じ信頼決定であるため、信頼するプラグインのみを評価します。このセクションで説明されている分離は、テスト中のエージェントが到達できるものを制限します。これはプラグイン独自のコードに対する境界ではなく、スイートが合格することはプラグインが安全であるかどうかについて何も言いません。462`claude plugin eval` はターゲットプラグインのスキル、フック、エージェントを読み込み、あなたのマシン上で、あなたとして eval スイートを実行します。プラグインを指定することは `claude --plugin-dir` と同じ信頼判断であるため、信頼できるプラグインのみを評価してください。このセクションで説明する分離は、テスト中のエージェントが到達できるものを制限します。これはプラグイン自体のコードに対する境界ではなく、スイートが合格したことは、プラグインが安全であるかどうかについて何も述べていません。

463 463 

464<h3 id="trust-the-plugin-directory">464<h3 id="trust-the-plugin-directory">

465 プラグインディレクトリを信頼する465 プラグインディレクトリを信頼する

466</h3>466</h3>

467 467 

468プラグインに対して `claude plugin eval` を初めて実行するとき、Claude Code は `Trust this plugin directory?` と尋ねます。ただし、既に対話型 `claude` セッションでそこで信頼プロンプトを受け入れた場合を除きます。git リポジトリ内で、はいと答えるとリポジトリ全体を信頼し、対話型セッションも同様です。stdin または stdout がターミナルでない場合、または `--json` の下では、実行は尋ねることができず、終了 1 で拒否されます。`--trust-plugin` を渡して信頼を自分で主張します。これは自分のマシンで実行するプラグインの場合のみです。パスではなく名前を付けるターゲット(インストール済みプラグインまたは skills-directory プラグイン)はプロンプトをスキップします。468初めて `claude plugin eval` をディレクトリに対して実行する場合、Claude Code は何かを読み込む前に「このプラグインディレクトリを信頼しますか?」と尋ねます。ただし、インタラクティブな `claude` セッションでそこで既に信頼プロンプトを受け入れている場合は除きます。Git リポジトリ内では、「はい」と答えるとリポジトリ全体が信頼され、インタラクティブセッションでも同様です。stdin または stdout がターミナルでない場合、または `--json` の下では、実行は尋ねることができず、終了コード 1 で拒否されます。`--trust-plugin` を渡して、自分のマシンで実行するプラグインのみについて、信頼を自分で主張してください。パスとして与えるのではなく、インストール済みプラグインまたはスキルディレクトリプラグインを意味する名前を指定したターゲットは、プロンプトをスキップします。

469 469 

470プラグインとスイートの一部は、その実行のフラグを渡すときのみ実行されます。ケースの [`scaffold_script`](#add-setup-or-history-with-case-yaml) は `--scaffold` で、[読み取り専用セット以上のツール](#grant-tools) は `--allow-tools` で、プラグインの [実際の MCP サーバー](#mock-mcp-servers) は `--allow-real-servers` または `--mocks off` で。ケースの `allowed_tools` とスキル独自の `allowed-tools` frontmatter はそれらのいずれかも広げることはできません。プラグインが作成しなかったフックを出荷する場合、またはその実際の MCP サーバーを開始する場合、グレーダーが読むファイルに触れる可能性があるため、コンテナまたは CI ランナーなどの分離環境で実行しない限り、そのスコアを参考情報として扱います。フックとサーバーはエージェントのサンドボックスの外で実行されます。470プラグインとスイートの一部は、その実行のためにそのフラグを渡す場合にのみ実行されます。ケースの [`scaffold_script`](#add-setup-or-history-with-case-yaml) は `--scaffold` で、[読み取り専用セット以外のツール](#grant-tools)は `--allow-tools` で、プラグインの[実際の MCP サーバー](#mock-mcp-servers)は `--allow-real-servers` または `--mocks off` で実行されます。ケースの `allowed_tools` とスキル自体の `allowed-tools` frontmatter は、これらのいずれも拡大することはできません。プラグインが作成していないフックを配布する場合、または実際の MCP サーバーを開始する場合は、コンテナまたは CI ランナーなどの分離された環境で実行しない限り、スコアを参考情報として扱ってください。フックとサーバーはエージェントのサンドボックスの外で実行され、グレーダーが読み取るファイルに触れる可能性があるためです。

471 471 

472<h3 id="how-runs-are-isolated">472<h3 id="how-runs-are-isolated">

473 実行がどのように分離されるか473 実行がどのように分離されるか

474</h3>474</h3>

475 475 

476各実行は使い捨てのホームディレクトリ、作業ディレクトリ、Claude Code 設定を取得し、テスト中のエージェントはそこで `claude -p` 子プロセスとして実行され、プラグインのみをロードします。ケースを作成するときにこれらの結果を念頭に置いてください。476各実行は、使い捨てのホームディレクトリ、作業ディレクトリ、Claude Code 設定を取得し、テスト中のエージェントはそこで `claude -p` 子プロセスとして実行され、プラグインのみが読み込まれます。ケースを作成する際は、これらの結果を念頭に置いてください。

477 477 

478* **個人またはプロジェクトレベルは何もロードされません。** ユーザー設定、フック、`CLAUDE.md` ファイル、MCP サーバー、他のインストール済みプラグイン、メモリ、スキルは存在せず、サンドボックス上のプロジェクトスコープの `.claude/` または `.mcp.json` は読み取られません。ほとんどのシェル環境も保留されます。[許可リスト](#prompt-md-fields) と `EVAL_*` 変数のみが実行に到達します。プラグインがセットアップを必要とする場合は、プラグインに出荷するか、`scaffold_script` で作成するか、`EVAL_*` 変数を渡します。478* **個人またはプロジェクトレベルのものは読み込まれません。** ユーザー設定、フック、`CLAUDE.md` ファイル、MCP サーバー、その他のインストール済みプラグイン、メモリ、スキルは存在せず、サンドボックス上のプロジェクトスコープの `.claude/` または `.mcp.json` は読み取られません。シェル環境のほとんども保留されます。[許可リスト](#prompt-md-fields)と `EVAL_*` 変数のみが実行に到達します。プラグインがセットアップを必要とする場合は、プラグインに含める、`scaffold_script` で作成する、または `EVAL_*` 変数を渡してください。

479* **管理ポリシーは実行を制限できます。** 管理者がマシンに展開した [管理設定](/docs/ja/managed-settings) の制限は実行内に適用されるため、管理マシン上の結果は管理されていないマシンとそのポリシーによって異なる可能性があります。479* **管理ポリシーは実行を制限できます。** 管理者がマシンに展開した[管理設定](/docs/ja/managed-settings)の制限は実行内に適用されるため、管理マシン上の結果は、そのポリシーによって管理されていないマシンと異なる場合があります。

480* **アーティファクトツールはオフです。** [アーティファクト](/docs/ja/artifacts) を公開するスキルはそのステップの前に生成するものに対してのみグレード化できます。480* **アーティファクトツールはオフです。** [アーティファクト](/docs/ja/artifacts)を公開するスキルは、そのステップの前に生成するものについてのみグレード可能です。

481* **ケース定義はエージェントから隠されています。** 実行は eval ディレクトリを読むことができないため、Claude はケースのプロンプト、グレーダー、または兄弟ケースを見ることができません。481* **ケース定義はエージェントから隠されています。** 実行は eval ディレクトリを読み取ることができないため、Claude はケースのプロンプト、グレーダー、または兄弟ケースを見ることができません。

482* **シェルコマンド外のネットワークサンドボックスはありません。** 付与するシェルコマンドはサンドボックスのネットワークルールの下で実行されます。`WebFetch(domain:…)` 付与はそのドメインに直接到達し、プラグイン独自のフックと開始する実際の MCP サーバーはどのホストにも到達できます。482* **シェルコマンド外のネットワークサンドボックスはありません。** 付与するシェルコマンドはサンドボックスのネットワークルールの下で実行されます。`WebFetch(domain:…)` 付与はそのドメインに直接到達し、プラグイン自体のフックと開始する実際の MCP サーバーは任意のホストに到達できます。

483 483 

484<h2 id="eval-suite-reference">484<h2 id="eval-suite-reference">

485 Eval スイートリファレンス485 Eval スイートリファレンス


646 646 

647プラグインが読み込まれ、`Δ` が `tool_used: Skill` グレーダーが失敗している場合でもゼロに近い場合、これは通常、スキルの `description` がプロンプトの表現でトリガーされていないことを意味する実際の発見です。説明を調整して、同じスイートを再度実行してください。647プラグインが読み込まれ、`Δ` が `tool_used: Skill` グレーダーが失敗している場合でもゼロに近い場合、これは通常、スキルの `description` がプロンプトの表現でトリガーされていないことを意味する実際の発見です。説明を調整して、同じスイートを再度実行してください。

648 648 

649<h3 id="agent-type-’-’-not-found-for-one-of-your-plugin’s-agents">

650 プラグインのエージェントの 1 つに対して「Agent type '...' not found」

651</h3>

652 

653デフォルトでは、各ケースはプラグインを使用して実行され、プラグインなしで実行されます。プラグインなしの実行は[プラグインなしベースライン](#the-no-plugin-baseline)です。Claude がベースライン実行でプラグインのエージェントの 1 つをディスパッチする場合、Agent ツール呼び出しは `Agent type '<plugin>:<agent-name>' not found. Available agents: ...` で失敗します。リストは、[組み込みサブエージェント](/docs/ja/sub-agents#built-in-subagents)など、プラグインなしで存在するエージェントのみを名前付けします。

654 

655エラーは予期されています。`Δ` はプラグインの実行をベースラインと比較するためです。JSON 結果では、ベースライン実行は `cases[].arms.without` の下にあります。

656 

657プラグインが読み込まれた実行では、`allowed_tools` に `Agent` をリストするケースは、`my-plugin:code-reviewer` など、プラグイン内のエージェントの名前空間付き名前でプラグインのエージェントの 1 つをディスパッチできます。`my-plugin` という名前のプラグイン内の `code-reviewer` エージェント。ベースライン実行をスキップするには、`--ablation none` を渡してください。

658 

649<h3 id="everything-scores-zero-although-the-right-files-were-produced">659<h3 id="everything-scores-zero-although-the-right-files-were-produced">

650 正しいファイルが生成されたにもかかわらず、すべてがゼロスコアになる660 正しいファイルが生成されたにもかかわらず、すべてがゼロスコアになる

651</h3>661</h3>

Details

1128 1128 

1129制限はネットワークまたはファイルシステム操作の前にチェックされます。チェックはマーケットプレイス追加時およびプラグインのインストール、更新、更新、自動更新時に実行されます。マーケットプレイスがポリシーが設定される前に追加され、そのソースがホワイトリストと一致しなくなった場合、Claude Code はそれからプラグインをインストールまたは更新することを拒否します。同じ強制が `blockedMarketplaces` に適用されます。1129制限はネットワークまたはファイルシステム操作の前にチェックされます。チェックはマーケットプレイス追加時およびプラグインのインストール、更新、更新、自動更新時に実行されます。マーケットプレイスがポリシーが設定される前に追加され、そのソースがホワイトリストと一致しなくなった場合、Claude Code はそれからプラグインをインストールまたは更新することを拒否します。同じ強制が `blockedMarketplaces` に適用されます。

1130 1130 

11312 つのリストが強制される場所は、それらを設定する場所に依存します。

1132 

1133* **claude.ai admin コンソール**:Claude Code は [server-managed settings](/docs/ja/managed-settings#where-and-when-a-policy-applies) を読み取るセッションで両方のリストを強制します。claude.ai は、organization 内の誰かが claude.ai から git リポジトリの新しいマーケットプレイスを追加するか、Claude Desktop app の Code タブの外から **Customize** を追加するときにもチェックします。これは、メンバーが自分のアカウント用に追加するマーケットプレイスと、[**Organization settings > Plugins**](https://claude.ai/admin-settings/plugins) の下で organization 全体に追加されるマーケットプレイスをカバーします。claude.ai はホワイトリストが許可しないリポジトリ、またはブロックリストが名前付けするリポジトリを拒否します。どちらかの場所で設定される前に追加されたマーケットプレイスを再チェックしません。アップロードされたプラグインはチェックしません。

1134* **マネージド設定ファイル、OS レベルのポリシー、または他のマネージドソース**:Claude Code はそのソースを読み取る場所で両方のリストを強制します。claude.ai はそれを読み取りません。

1135 

1131GitHub 所有者の下のすべてのマーケットプレイスリポジトリをブロックするには、`blockedMarketplaces` エントリで owner-wildcard 形式を使用します。`{ "source": "github", "repo": "untrusted-org/*" }`。Claude Code v2.1.223 以降が必要です。マッチングルールについては、ブロックリストとホワイトリストの間で異なり、[Owner wildcards](/docs/ja/settings-reference#owner-wildcards) を参照してください。1136GitHub 所有者の下のすべてのマーケットプレイスリポジトリをブロックするには、`blockedMarketplaces` エントリで owner-wildcard 形式を使用します。`{ "source": "github", "repo": "untrusted-org/*" }`。Claude Code v2.1.223 以降が必要です。マッチングルールについては、ブロックリストとホワイトリストの間で異なり、[Owner wildcards](/docs/ja/settings-reference#owner-wildcards) を参照してください。

1132 1137 

1133ユーザーが Claude Code が [フェッチするのではなくクローンする](/docs/ja/discover-plugins#add-from-other-git-hosts) `https://` リポジトリ URL(裸の `github.com` または `gitlab.com` リポジトリ URL など)を追加する場合、Claude Code は `blockedMarketplaces` の `url` エントリに対してもチェックします。Claude Code はエントリが同じ URL を名前付けする場合、追加をブロックします。その比較では、Claude Code は `.git` サフィックスと、ユーザーが `#` の後に追加する任意の ref を無視します。Claude Code v2.1.232 以降が必要です。v2.1.232 より前では、Claude Code は `url` エントリをホストされた `marketplace.json` ファイルとしてフェッチした URL に対してのみマッチしました。1138ユーザーが Claude Code が [フェッチするのではなくクローンする](/docs/ja/discover-plugins#add-from-other-git-hosts) `https://` リポジトリ URL(裸の `github.com` または `gitlab.com` リポジトリ URL など)を追加する場合、Claude Code は `blockedMarketplaces` の `url` エントリに対してもチェックします。Claude Code はエントリが同じ URL を名前付けする場合、追加をブロックします。その比較では、Claude Code は `.git` サフィックスと、ユーザーが `#` の後に追加する任意の ref を無視します。Claude Code v2.1.232 以降が必要です。v2.1.232 より前では、Claude Code は `url` エントリをホストされた `marketplace.json` ファイルとしてフェッチした URL に対してのみマッチしました。

Details

338 338 

339[`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) スクリプトによって返されたキーも [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 認証情報も設定フェッチをトリガーしません。339[`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper) スクリプトによって返されたキーも [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) 認証情報も設定フェッチをトリガーしません。

340 340 

341Claude Desktop アプリの [Cowork](https://claude.com/docs/cowork/overview) セッションでは、ユーザーが Team または Enterprise アカウントでサインインしている場合でも、Claude Code は claude.ai 管理コンソールからサーバー管理設定をフェッチしません。[ポリシーが適用される場所と時期](/docs/ja/managed-settings#where-and-when-a-policy-applies) では、ユーザーのマシン上の Cowork セッションとリモート Cowork セッションにどのポリシーが適用されるかについて説明しています。341Claude Desktop アプリの [Cowork](https://claude.com/docs/cowork/overview) セッションでは、ユーザーが Team または Enterprise アカウントでサインインしている場合でも、Claude Code は claude.ai 管理コンソールからサーバー管理設定をフェッチしません。[ポリシーが適用される場所と時期](/docs/ja/managed-settings#where-and-when-a-policy-applies) では、ユーザーのマシン上の Cowork セッションとリモート Cowork セッションにどのポリシーが適用されるかについて説明しています。claude.ai は、Cowork ユーザーが claude.ai の git リポジトリからマーケットプレイスを追加するか、Cowork タブの **Customize** から追加する場合、[`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) および [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) リストを自身で適用します。[制限がどのように機能するか](/docs/ja/plugin-marketplaces#how-restrictions-work) がそのチェックについて説明しています。

342 342 

343シェルで `CLAUDE_CODE_USE_*` プロバイダー変数またはデフォルト以外の `ANTHROPIC_BASE_URL` をエクスポートする場合、Claude Code はセッションの設定フェッチをスキップします。[`claude doctor` と `/status` はスキップされたフェッチとその原因を報告します](#verify-settings-delivery)。343シェルで `CLAUDE_CODE_USE_*` プロバイダー変数またはデフォルト以外の `ANTHROPIC_BASE_URL` をエクスポートする場合、Claude Code はセッションの設定フェッチをスキップします。[`claude doctor` と `/status` はスキップされたフェッチとその原因を報告します](#verify-settings-delivery)。

344 344 

Details

4511 4511 

4512組織のプラグインマーケットプレイスソースをブロックします。Claude Code はマーケットプレイスの追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時にブロックリストをチェックするため、ポリシーを設定する前に誰かが追加したマーケットプレイスは、プラグインをフェッチするために使用することはできません。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れることはありません。4512組織のプラグインマーケットプレイスソースをブロックします。Claude Code はマーケットプレイスの追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時にブロックリストをチェックするため、ポリシーを設定する前に誰かが追加したマーケットプレイスは、プラグインをフェッチするために使用することはできません。ブロックされたソースはダウンロード前にチェックされるため、ファイルシステムに触れることはありません。

4513 4513 

4514[claude.ai 管理コンソール](/docs/ja/server-managed-settings)でこのキーを設定する場合、claude.ai は、[制限の仕組み](/docs/ja/plugin-marketplaces#how-restrictions-work)で説明されているように、組織内の誰かが claude.ai から git リポジトリからマーケットプレイスを追加するときにも適用します。

4515 

4514* **Scope**: [`Managed`](#scopes)4516* **Scope**: [`Managed`](#scopes)

4515* **Type**: [`strictKnownMarketplaces`](#allowed-source-types) と同じ形式のマーケットプレイスソースオブジェクトの配列4517* **Type**: [`strictKnownMarketplaces`](#allowed-source-types) と同じ形式のマーケットプレイスソースオブジェクトの配列

4516* **Default**: 未設定の場合、マーケットプレイスはブロックされません4518* **Default**: 未設定の場合、マーケットプレイスはブロックされません


4607 4609 

4608組織内のユーザーがプラグインを追加およびインストールできるプラグインマーケットプレイスソースを制限します。Claude Code はマーケットプレイスの追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時に許可リストを実施します。ネットワークまたはファイルシステム操作の前に実施されるため、ポリシーを設定する前に誰かが追加したマーケットプレイスは、そのソースが一致しなくなると使用できません。ブロックされたユーザーはマネージドポリシーに名前を付けるエラーを表示します。4610組織内のユーザーがプラグインを追加およびインストールできるプラグインマーケットプレイスソースを制限します。Claude Code はマーケットプレイスの追加時およびプラグインのインストール、更新、リフレッシュ、自動更新時に許可リストを実施します。ネットワークまたはファイルシステム操作の前に実施されるため、ポリシーを設定する前に誰かが追加したマーケットプレイスは、そのソースが一致しなくなると使用できません。ブロックされたユーザーはマネージドポリシーに名前を付けるエラーを表示します。

4609 4611 

4612[claude.ai 管理コンソール](/docs/ja/server-managed-settings)でこのキーを設定する場合、claude.ai は、[制限の仕組み](/docs/ja/plugin-marketplaces#how-restrictions-work)で説明されているように、組織内の誰かが claude.ai から git リポジトリからマーケットプレイスを追加するときにも適用します。

4613 

4610* **Scope**: [`Managed`](#scopes)4614* **Scope**: [`Managed`](#scopes)

4611* **Type**: マーケットプレイスソースオブジェクトの配列。[許可されたソースタイプ](#allowed-source-types)を参照してください4615* **Type**: マーケットプレイスソースオブジェクトの配列。[許可されたソースタイプ](#allowed-source-types)を参照してください

4612* **Default**: 未設定の場合、ユーザーは任意のマーケットプレイスを追加できます。空の配列は、公式 Anthropic マーケットプレイスを含むすべてのマーケットプレイスソースをブロックする完全なロックダウンです4616* **Default**: 未設定の場合、ユーザーは任意のマーケットプレイスを追加できます。空の配列は、公式 Anthropic マーケットプレイスを含むすべてのマーケットプレイスソースをブロックする完全なロックダウンです