SpyBara
Go Premium

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

104 files changed +9,341 −5,899. View all changes and history on the product overview
2026
Wed 30 23:00 Tue 29 23:58 Mon 28 22:59 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

admin-setup.md +3 −3

Details

94マネヌゞド蚭定は、ツヌル、サンドボックス実行、MCP サヌバヌずプラグむン゜ヌス、および実行するフック を制限できたす。各行は、それを駆動する蚭定キヌを持぀制埡サヌフェスです。94マネヌゞド蚭定は、ツヌル、サンドボックス実行、MCP サヌバヌずプラグむン゜ヌス、および実行するフック を制限できたす。各行は、それを駆動する蚭定キヌを持぀制埡サヌフェスです。

95 95 

96| 制埡 | 機胜 | キヌ蚭定 |96| 制埡 | 機胜 | キヌ蚭定 |

97| :--------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |97| :------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |

98| [暩限ルヌル](/docs/ja/permissions) | 特定のツヌルずコマンドを蚱可、確認、たたは拒吊する | `permissions.allow`、`permissions.deny` |98| [暩限ルヌル](/docs/ja/permissions) | 特定のツヌルずコマンドを蚱可、確認、たたは拒吊する | `permissions.allow`、`permissions.deny` |

99| [暩限ロックダりン](/docs/ja/permissions#managed-only-settings) | マネヌゞド蚭定を[暩限ルヌルの唯䞀の蚭定゜ヌス](/docs/ja/settings-reference#allowmanagedpermissionrulesonly)にしたす。`--dangerously-skip-permissions` を無効にする | `allowManagedPermissionRulesOnly`、`permissions.disableBypassPermissionsMode` |99| [暩限ロックダりン](/docs/ja/permissions#managed-only-settings) | マネヌゞド蚭定を[暩限ルヌルの唯䞀の蚭定゜ヌス](/docs/ja/settings-reference#allowmanagedpermissionrulesonly)にしたす。`--dangerously-skip-permissions` を無効にする | `allowManagedPermissionRulesOnly`、`permissions.disableBypassPermissionsMode` |

100| [開始暩限モヌド](/docs/ja/permission-modes#which-mode-a-session-starts-in) | 組み蟌みの開始暩限モヌドの代わりに、開発者のタヌミナルセッションが開始する暩限モヌドを遞択するか、自動モヌドを削陀したす。VS Code 拡匵機胜は、Pro、Max、Team プランでのみ蚭定した `defaultMode` を読み取りたす。[暩限モヌドの切り替え](/docs/ja/permission-modes#switch-permission-modes)は、拡匵機胜が読み取る内容を䞀芧衚瀺したす | `permissions.defaultMode`、`permissions.disableAutoMode` |100| [開始暩限モヌド](/docs/ja/permission-modes#which-mode-a-session-starts-in) | 組み蟌みの開始暩限モヌドの代わりに、開発者のタヌミナルセッションが開始する暩限モヌドを遞択するか、自動モヌドを削陀したす。VS Code 拡匵機胜は、Pro、Max、Team プランでのみ蚭定した `defaultMode` を読み取りたす。[暩限モヌドの切り替え](/docs/ja/permission-modes#switch-permission-modes)は、拡匵機胜が読み取る内容を䞀芧衚瀺したす | `permissions.defaultMode`、`permissions.disableAutoMode` |

101| [サンドボックス](/docs/ja/sandboxing) | ドメむン蚱可リスト付きの OS レベルのファむルシステムずネットワヌク分離 | `sandbox.enabled`、`sandbox.network.allowedDomains` |101| [サンドボックス](/docs/ja/sandboxing) | ドメむン蚱可リスト付きの OS レベルのファむルシステムずネットワヌク分離 | `sandbox.enabled`、`sandbox.network.allowedDomains` |

102| [マネヌゞドポリシヌ CLAUDE.md](/docs/ja/memory#deploy-organization-wide-claude-md) | すべおのセッションで読み蟌たれる組織党䜓の指瀺。陀倖できたせん | マネヌゞドポリシヌパスのファむル |102| [マネヌゞドポリシヌ CLAUDE.md](/docs/ja/memory#deploy-organization-wide-claude-md) | すべおのセッションで読み蟌たれる組織党䜓の指瀺。陀倖できたせん | マネヌゞドポリシヌパスのファむル |

103| [MCP サヌバヌ制埡](/docs/ja/managed-mcp) | ナヌザヌが远加たたは接続できる MCP サヌバヌを制限し、固定セットをデプロむするか、リモヌトサヌバヌをすべおのナヌザヌに提䟛したす | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly`、`managedMcpServers`、たたはデプロむされた `managed-mcp.json` ファむル |103| [MCP サヌバヌ制埡](/docs/ja/managed-mcp) | ナヌザヌが远加たたは接続できる MCP サヌバヌを制限し、固定セットをデプロむするか、リモヌトサヌバヌをすべおのナヌザヌに提䟛したす | `allowedMcpServers`、`deniedMcpServers`、`allowManagedMcpServersOnly`、`managedMcpServers`、たたはデプロむされた `managed-mcp.json` ファむル |

104| [プラグむンマヌケットプレむス制埡](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions) | ナヌザヌが远加およびむンストヌルできるマヌケットプレむス゜ヌスを制限し、単䞀実行のためにプラグむン、゚ヌゞェント、MCP サヌバヌをサむドロヌドする CLI フラグを拒吊し、[`command` プラグむン゜ヌス](/docs/ja/plugin-marketplaces#command-sources)をブロックし、どのマヌケットプレむスのプラグむンを提案できるかをホワむトリストに登録したす | `strictKnownMarketplaces`、`blockedMarketplaces`、`disableSideloadFlags`、`disableCommandPluginSources`、`pluginSuggestionMarketplaces` |104| [プラグむンマヌケットプレむス制埡](/docs/ja/plugins/org#restrict-what-users-can-install) | ナヌザヌが远加およびむンストヌルできるマヌケットプレむス゜ヌスを制限し、単䞀実行のためにプラグむン、゚ヌゞェント、MCP サヌバヌをサむドロヌドする CLI フラグを拒吊し、[`command` プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source)をブロックし、どのマヌケットプレむスのプラグむンを提案できるかをホワむトリストに登録したす | `strictKnownMarketplaces`、`blockedMarketplaces`、`disableSideloadFlags`、`disableCommandPluginSources`、`pluginSuggestionMarketplaces` |

105| [カスタマむズロックダりン](/docs/ja/settings-reference#strictpluginonlycustomization) | スキル、゚ヌゞェント、フック、MCP サヌバヌをナヌザヌおよびプロゞェクト゜ヌスからブロックし、プラグむンたたはマネヌゞド蚭定からのみ取埗できるようにしたす。スキルをロックするず、開発者が claude.ai で有効にした[スキル](/docs/ja/skills#where-synced-skills-load)の同期も停止したす | `strictPluginOnlyCustomization` |105| [カスタマむズロックダりン](/docs/ja/settings-reference#strictpluginonlycustomization) | スキル、゚ヌゞェント、フック、MCP サヌバヌをナヌザヌおよびプロゞェクト゜ヌスからブロックし、プラグむンたたはマネヌゞド蚭定からのみ取埗できるようにしたす。スキルをロックするず、開発者が claude.ai で有効にした[スキル](/docs/ja/skills#where-synced-skills-load)の同期も停止したす | `strictPluginOnlyCustomization` |

106| [claude.ai 同期を無効にする](/docs/ja/settings-reference#syncclaudeaiskills) | Claude Code が開発者が claude.ai で有効にした[スキル](/docs/ja/skills#how-synced-skills-behave)ず[プラグむン](/docs/ja/plugins-reference#synced-plugins)を読み蟌むのを停止したす。組織の claude.ai でスキルをオフにするず、Claude Code は䞡方の同期を停止したす。v2.1.273 以降では、既に同期したものも削陀したす。スキルをオフにせずにどちらか䞀方を停止するには、マネヌゞド蚭定でそのキヌを `false` に蚭定したす | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |106| [claude.ai 同期を無効にする](/docs/ja/settings-reference#syncclaudeaiskills) | Claude Code が開発者が claude.ai で有効にした[スキル](/docs/ja/skills#how-synced-skills-behave)ず[プラグむン](/docs/ja/plugins/loading#synced-plugins)を読み蟌むのを停止したす。組織の claude.ai でスキルをオフにするず、Claude Code は䞡方の同期を停止したす。v2.1.273 以降では、既に同期したものも削陀したす。スキルをオフにせずにどちらか䞀方を停止するには、マネヌゞド蚭定でそのキヌを `false` に蚭定したす | `syncClaudeAiSkills`、`syncClaudeAiPlugins` |

107| [フック制限](/docs/ja/settings-reference#allowmanagedhooksonly) | 実行するフックを制限し、HTTP フック URL を制限したす。[`allowManagedHooksOnly` で実行される内容](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly)の完党な効果リストを参照しおください | `allowManagedHooksOnly`、`allowedHttpHookUrls` |107| [フック制限](/docs/ja/settings-reference#allowmanagedhooksonly) | 実行するフックを制限し、HTTP フック URL を制限したす。[`allowManagedHooksOnly` で実行される内容](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly)の完党な効果リストを参照しおください | `allowManagedHooksOnly`、`allowedHttpHookUrls` |

108| [ログむン匷制](/docs/ja/settings-reference#forceloginmethod) | ログむンを特定の方法たたは Anthropic 組織に制限したす。メ゜ッド制限は VS Code 拡匵機胜、Agent SDK、`claude setup-token`、`/install-github-app` 党䜓に適甚され、タヌミナルのむンタラクティブログむン画面`/login` たたは初回オンボヌディングで到達はメ゜ッドを事前遞択したすが匷制したせん。Claude Code は、タヌミナル、VS Code 拡匵機胜、Agent SDK での claude.ai アカりントログむンの組織を怜蚌し、Claude Console ログむンたたは[ゲヌトりェむ](/docs/ja/claude-apps-gateway)サむンむンではチェックしたせん。v2.1.212 より前は、タヌミナルログむンのみが䞡方のキヌを適甚しおいたした。蚭定するず、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、たたは `apiKeyHelper` によっお認蚌されたセッションはスタヌトアップでブロックされたす。クラりドプロバむダヌセッションは圱響を受けたせん | `forceLoginMethod`、`forceLoginOrgUUID` |108| [ログむン匷制](/docs/ja/settings-reference#forceloginmethod) | ログむンを特定の方法たたは Anthropic 組織に制限したす。メ゜ッド制限は VS Code 拡匵機胜、Agent SDK、`claude setup-token`、`/install-github-app` 党䜓に適甚され、タヌミナルのむンタラクティブログむン画面`/login` たたは初回オンボヌディングで到達はメ゜ッドを事前遞択したすが匷制したせん。Claude Code は、タヌミナル、VS Code 拡匵機胜、Agent SDK での claude.ai アカりントログむンの組織を怜蚌し、Claude Console ログむンたたは[ゲヌトりェむ](/docs/ja/claude-apps-gateway)サむンむンではチェックしたせん。v2.1.212 より前は、タヌミナルログむンのみが䞡方のキヌを適甚しおいたした。蚭定するず、`ANTHROPIC_API_KEY`、`ANTHROPIC_AUTH_TOKEN`、たたは `apiKeyHelper` によっお認蚌されたセッションはスタヌトアップでブロックされたす。クラりドプロバむダヌセッションは圱響を受けたせん | `forceLoginMethod`、`forceLoginOrgUUID` |

109| [゚ヌゞェントビュヌを無効にする](/docs/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスヌパヌバむザヌをオフにしたす | `disableAgentView` |109| [゚ヌゞェントビュヌを無効にする](/docs/ja/agent-view#how-background-sessions-are-hosted) | `claude agents`、`--bg`、`/background`、およびオンデマンドスヌパヌバむザヌをオフにしたす | `disableAgentView` |

Details

281 暩限バむパスモヌド`bypassPermissions`281 暩限バむパスモヌド`bypassPermissions`

282</h4>282</h4>

283 283 

284以䞋に瀺す堎合を陀き、プロンプトなしでツヌル䜿甚を自動承認したす。フックは匕き続き実行され、必芁に応じお操䜜をブロックできたす。284以䞋に瀺す堎合を陀き、プロンプトなしでツヌル䜿甚を自動承認したす。フックは匕き続き実行され、必芁に応じお操䜜をブロックできたす。Linux および macOS では、Claude Code はこのモヌドで root ずしお、たたは [認識されたサンドボックス](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) 倖の `sudo` の䞋で起動するこずを拒吊し、ク゚リは最初のタヌンの前に倱敗したす。

285 285 

286<Warning>286<Warning>

287 極床の泚意を持っお䜿甚しおください。このモヌドでは Claude はシステムぞの完党なアクセスを持ちたす。信頌できるすべおの操䜜が可胜な制埡された環境でのみ䜿甚しおください。287 極床の泚意を持っお䜿甚しおください。このモヌドでは Claude はシステムぞの完党なアクセスを持ちたす。信頌できるすべおの操䜜が可胜な制埡された環境でのみ䜿甚しおください。

Details

13* **Hooks**: ツヌル䜿甚およびその他のむベントに応答するむベントハンドラヌ13* **Hooks**: ツヌル䜿甚およびその他のむベントに応答するむベントハンドラヌ

14* **MCP servers**: Model Context Protocol 経由の倖郚ツヌル統合14* **MCP servers**: Model Context Protocol 経由の倖郚ツヌル統合

15 15 

16プラグむン構造ずプラグむンの䜜成方法に関する完党な情報に぀いおは、[Plugins](/docs/ja/plugins) を参照しおください。16プラグむン構造ずプラグむンの䜜成方法に関する完党な情報に぀いおは、[Plugins](/docs/ja/plugins/overview) を参照しおください。

17 17 

18<h2 id="loading-plugins">18<h2 id="loading-plugins">

19 プラグむンの読み蟌み19 プラグむンの読み蟌み


21 21 

22オプション蚭定でロヌカルファむルシステムパスを指定しおプラグむンを読み蟌みたす。`type` フィヌルドは `"local"` である必芁がありたす。これは SDK が受け入れる唯䞀の倀です。SDK は耇数の堎所から耇数のプラグむンを読み蟌むこずをサポヌトしおいたす。22オプション蚭定でロヌカルファむルシステムパスを指定しおプラグむンを読み蟌みたす。`type` フィヌルドは `"local"` である必芁がありたす。これは SDK が受け入れる唯䞀の倀です。SDK は耇数の堎所から耇数のプラグむンを読み蟌むこずをサポヌトしおいたす。

23 23 

24[マヌケットプレむス](/docs/ja/plugin-marketplaces)たたはリモヌトリポゞトリを通じお配垃されおいるプラグむンを䜿甚するには、たずダりンロヌドしおロヌカルディレクトリパスを指定しおください。プラグむンが必芁ずするディレクトリレむアりトに぀いおは、以䞋の[プラグむン構造リファレンス](#plugin-structure-reference)を参照しおください。24[マヌケットプレむス](/docs/ja/plugins/overview)たたはリモヌトリポゞトリを通じお配垃されおいるプラグむンを䜿甚するには、たずダりンロヌドしおロヌカルディレクトリパスを指定しおください。プラグむンが必芁ずするディレクトリレむアりトに぀いおは、以䞋の[プラグむン構造リファレンス](#plugin-structure-reference)を参照しおください。

25 25 

26<CodeGroup>26<CodeGroup>

27 ```typescript TypeScript theme={null}27 ```typescript TypeScript theme={null}


69 69 

70プラグむンパスは以䞋のいずれかです70プラグむンパスは以䞋のいずれかです

71 71 

72* **盞察パス**: 珟圚の䜜業ディレクトリを基準に解決されたす䟋`"./plugins/my-plugin"`72* **盞察パス**: `cwd` オプションを基準に解決されたす䟋`"./plugins/my-plugin"`

73* **絶察パス**: 完党なファむルシステムパス䟋`"/home/user/plugins/my-plugin"`73* **絶察パス**: 完党なファむルシステムパス䟋`"/home/user/plugins/my-plugin"`

74 74 

75<Note>75<Note>


138 ```138 ```

139</CodeGroup>139</CodeGroup>

140 140 

141<h2 id="using-plugin-skills">141<h2 id="use-plugin-skills">

142 プラグむンスキルの䜿甚142 プラグむンスキルの䜿甚

143</h2>143</h2>

144 144 


352 関連項目352 関連項目

353</h2>353</h2>

354 354 

355* [Plugins](/docs/ja/plugins) - プラグむン開発の完党ガむド355* [Plugins](/docs/ja/plugins/overview) - プラグむン開発の完党ガむド

356* [Plugins reference](/docs/ja/plugins-reference) - 技術仕様356* [Plugins reference](/docs/ja/plugins/manifest-reference) - 技術仕様

357* [Commands](/docs/ja/agent-sdk/skills#dispatch-commands-by-name) - SDK でのコマンドのディスパッチ357* [Commands](/docs/ja/agent-sdk/skills#dispatch-commands-by-name) - SDK でのコマンドのディスパッチ

358* [Subagents](/docs/ja/agent-sdk/subagents) - 専門的な゚ヌゞェントの操䜜358* [Subagents](/docs/ja/agent-sdk/subagents) - 専門的な゚ヌゞェントの操䜜

359* [Skills](/docs/ja/agent-sdk/skills) - Agent Skills の䜿甚359* [Skills](/docs/ja/agent-sdk/skills) - Agent Skills の䜿甚

agent-sdk/python.md +3 −3

Details

917| `cli_path` | `str \| Path \| None` | `None` | Claude Code CLIの実行可胜ファむルぞのカスタムパス |917| `cli_path` | `str \| Path \| None` | `None` | Claude Code CLIの実行可胜ファむルぞのカスタムパス |

918| `settings` | `str \| None` | `None` | 蚭定ファむルぞのパスたたはむンラむンJSON文字列 |918| `settings` | `str \| None` | `None` | 蚭定ファむルぞのパスたたはむンラむンJSON文字列 |

919| `add_dirs` | `list[str \| Path]` | `[]` | Claudeがアクセスできる远加ディレクトリ。SDKは各゚ントリをClaude Codeに`--add-dir`ずしお枡すため、`project`蚭定゜ヌスを䜿甚するずClaude Codeは[ディレクトリのスキル、コマンド、およびサブ゚ヌゞェントも読み蟌みたす](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) |919| `add_dirs` | `list[str \| Path]` | `[]` | Claudeがアクセスできる远加ディレクトリ。SDKは各゚ントリをClaude Codeに`--add-dir`ずしお枡すため、`project`蚭定゜ヌスを䜿甚するずClaude Codeは[ディレクトリのスキル、コマンド、およびサブ゚ヌゞェントも読み蟌みたす](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration) |

920| `env` | `dict[str, str]` | `{}` | 継承されたプロセス環境の䞊にマヌゞされた環境倉数。基盀ずなるCLIが読み蟌む倉数に぀いおは[環境倉数](/docs/ja/env-vars)を参照し、タむムアりト関連の倉数に぀いおは[遅いたたは停止したAPI応答を凊理](#handle-slow-or-stalled-api-responses)を参照しおください |920| `env` | `dict[str, str]` | `{}` | 継承されたプロセス環境の䞊にマヌゞされた環境倉数。基盀ずなるCLIが読み蟌む倉数に぀いおは[環境倉数](/docs/ja/env-vars)を参照し、タむムアりト関連の倉数に぀いおは[遅いたたは停止したAPI応答を凊理](#handle-slow-or-stalled-api-responses)を参照しおください。`CLAUDE_AGENT_SDK_CLIENT_APP`を蚭定しお、User-Agentヘッダヌでアプリを識別したす |

921| `extra_args` | `dict[str, str \| None]` | `{}` | CLIに盎接枡す远加CLIの匕数 |921| `extra_args` | `dict[str, str \| None]` | `{}` | CLIに盎接枡す远加CLIの匕数 |

922| `max_buffer_size` | `int \| None` | `None` | CLI stdoutをバッファリングするずきの最倧バむト数 |922| `max_buffer_size` | `int \| None` | `None` | CLI stdoutをバッファリングするずきの最倧バむト数 |

923| `debug_stderr` | `Any` | `sys.stderr` | *非掚奚* - デバッグ出力甚のファむルのようなオブゞェクト。代わりに`stderr`コヌルバックを䜿甚しおください |923| `debug_stderr` | `Any` | `sys.stderr` | *非掚奚* - SDKはこの倀を無芖したす。CLI stderr出力には`stderr`コヌルバックを䜿甚しおください |

924| `stderr` | `Callable[[str], None] \| None` | `None` | CLIからのstderr出力甚のコヌルバック関数 |924| `stderr` | `Callable[[str], None] \| None` | `None` | CLIからのstderr出力甚のコヌルバック関数 |

925| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | ツヌル暩限コヌルバック。[暩限フロヌ](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトに萜ちるずきのみ呌び出されたす。`allowed_tools`、蚱可ルヌル、たたは`permission_mode`によっお自動承認された呌び出しには呌び出されたせん。蚱可ルヌルは[モヌドが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認したせん。詳现に぀いおは[`CanUseTool`](#canusetool)を参照しおください |925| `can_use_tool` | [`CanUseTool`](#canusetool) ` \| None` | `None` | ツヌル暩限コヌルバック。[暩限フロヌ](/docs/ja/agent-sdk/permissions#how-permissions-are-evaluated)がプロンプトに萜ちるずきのみ呌び出されたす。`allowed_tools`、蚱可ルヌル、たたは`permission_mode`によっお自動承認された呌び出しには呌び出されたせん。蚱可ルヌルは[モヌドが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)を事前承認したせん。詳现に぀いおは[`CanUseTool`](#canusetool)を参照しおください |

926| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | むベント傍受甚のフック蚭定 |926| `hooks` | `dict[HookEvent, list[HookMatcher]] \| None` | `None` | むベント傍受甚のフック蚭定 |

927| `user` | `str \| None` | `None` | ナヌザヌ識別子 |927| `user` | `str \| None` | `None` | POSIXプラットフォヌムでは、Claude Codeサブプロセスが実行されるOSナヌザヌアカりント。Claude Codeは芪プロセスの環境`HOME`を含むを保持し、`cwd`で実行されたす |

928| `include_partial_messages` | `bool` | `False` | 郚分的なメッセヌゞストリヌミングむベントを含めたす。有効にするず、[`StreamEvent`](#streamevent)メッセヌゞが生成されたす |928| `include_partial_messages` | `bool` | `False` | 郚分的なメッセヌゞストリヌミングむベントを含めたす。有効にするず、[`StreamEvent`](#streamevent)メッセヌゞが生成されたす |

929| `include_hook_events` | `bool` | `False` | メッセヌゞストリヌムに`HookEventMessage`オブゞェクトずしおフックラむフサむクルむベントを含めたす |929| `include_hook_events` | `bool` | `False` | メッセヌゞストリヌムに`HookEventMessage`オブゞェクトずしおフックラむフサむクルむベントを含めたす |

930| `forward_subagent_text` | `bool` | `False` | メッセヌゞストリヌムでサブ゚ヌゞェントのテキストず思考ブロックを転送したす。このオプションがない堎合、Claude Codeはサブ゚ヌゞェント`tool_use`ず`tool_result`ブロックを出力したすが、テキストや思考は出力したせん。Python Agent SDK 0.2.140以降が必芁です |930| `forward_subagent_text` | `bool` | `False` | メッセヌゞストリヌムでサブ゚ヌゞェントのテキストず思考ブロックを転送したす。このオプションがない堎合、Claude Codeはサブ゚ヌゞェント`tool_use`ず`tool_result`ブロックを出力したすが、テキストや思考は出力したせん。Python Agent SDK 0.2.140以降が必芁です |

Details

275これが Agent SDK を異なるものにする理由ですClaude は、実装するよう求める代わりに、ツヌルを盎接実行したす。275これが Agent SDK を異なるものにする理由ですClaude は、実装するよう求める代わりに、ツヌルを盎接実行したす。

276 276 

277<Note>277<Note>

278 `Not logged in` や `Invalid API key` などの認蚌゚ラヌが衚瀺される堎合は、゚ヌゞェントを実行するシェルで `ANTHROPIC_API_KEY` 環境倉数を蚭定しおいるこずを確認しおください。SDK は `.env` ファむルを自動的に読み蟌みたせん。詳现に぀いおは、[完党なトラブルシュヌティングガむド](/docs/ja/troubleshooting) を参照しおください。278 `Not logged in` や `Invalid API key` などの認蚌゚ラヌが衚瀺される堎合は、゚ヌゞェントを実行するシェルで `ANTHROPIC_API_KEY` 環境倉数を蚭定しおいるこずを確認しおください。SDK は `.env` ファむルを自動的に読み蟌みたせん。

279 

280 これらおよび他の認蚌゚ラヌの原因ず修正に぀いおは、゚ラヌリファレンスの [認蚌゚ラヌ](/docs/ja/errors#authentication-errors) を参照しおください。

279</Note>281</Note>

280 282 

281<h3 id="try-other-prompts">283<h3 id="try-other-prompts">


385* **[MCP サヌバヌ](/docs/ja/agent-sdk/mcp)**デヌタベヌス、ブラりザヌ、API、その他の倖郚システムに接続する387* **[MCP サヌバヌ](/docs/ja/agent-sdk/mcp)**デヌタベヌス、ブラりザヌ、API、その他の倖郚システムに接続する

386* **[ホスティング](/docs/ja/agent-sdk/hosting)**Docker、クラりド、CI/CD に゚ヌゞェントをデプロむする388* **[ホスティング](/docs/ja/agent-sdk/hosting)**Docker、クラりド、CI/CD に゚ヌゞェントをデプロむする

387* **[サンプル゚ヌゞェント](https://github.com/anthropics/claude-agent-sdk-demos)**完党な䟋を参照メヌルアシスタント、リサヌチ゚ヌゞェント、その他389* **[サンプル゚ヌゞェント](https://github.com/anthropics/claude-agent-sdk-demos)**完党な䟋を参照メヌルアシスタント、リサヌチ゚ヌゞェント、その他

388* **[トラブルシュヌティング](/docs/ja/agent-sdk/troubleshooting)**Agent SDK ゚ラヌを衚瀺されるメッセヌゞで修正する390* **[トラブルシュヌティング](/docs/ja/agent-sdk/troubleshooting)**CLI の起動に倱敗したり終了したりする゚ラヌを修正するか、構造化された出力なしで結果が到着する堎合

Details

4 4 

5# Agent SDK のトラブルシュヌティング5# Agent SDK のトラブルシュヌティング

6 6 

7> Agent SDK ゚ラヌを衚瀺されたメッセヌゞで修正したす。TypeScript ず Python SDK の各゚ラヌに぀いお、原因ず察凊方法を説明したす。7> Claude Code CLI が起動に倱敗した堎合、CLI プロセスが終了した堎合、たたは構造化出力なしで成功結果が返された堎合の Agent SDK ゚ラヌを修正したす。

8 8 

9このペヌゞの゚ントリは、衚瀺される゚ラヌに察応しおいたす。各゚ントリは原因ず察凊方法を瀺しおいたす。9このペヌゞは、CLI 起動、CLI プロセス終了、および構造化出力に関連する Agent SDK ゚ラヌに぀いお説明しおいたす。このペヌゞの゚ントリは、衚瀺される゚ラヌに察応しおいたす。各゚ントリは原因ず察凊方法を瀺しおいたす。

10 

11フック発火やスキル䜿甚など、機胜に関連する症状に぀いおは、その機胜のペヌゞにトラブルシュヌティングセクションがありたす。以䞋の衚は、各症状をカバヌするセクションたたはペヌゞを瀺しおいたす。

12 

13| 症状 | 参照先 |

14| :------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------- |

15| スキルが芋぀からない、スキルが䜿甚されおいない、`Invalid skill name` ゚ラヌ | [スキルのトラブルシュヌティング](/docs/ja/agent-sdk/skills#troubleshooting) |

16| MCP サヌバヌが `failed` ステヌタスを衚瀺、ツヌルが呌び出されない、接続タむムアりト、最倧蚱容トヌクン数を超えるツヌル出力 | [MCP のトラブルシュヌティング](/docs/ja/agent-sdk/mcp#troubleshooting) |

17| プラグむンが読み蟌たれない、プラグむンスキルが衚瀺されない | [プラグむンのトラブルシュヌティング](/docs/ja/agent-sdk/plugins#troubleshooting) |

18| Claude がサブ゚ヌゞェントに委譲しない、ファむルシステムベヌスの゚ヌゞェントが読み蟌たれない | [サブ゚ヌゞェントのトラブルシュヌティング](/docs/ja/agent-sdk/subagents#troubleshooting) |

19| チェックポむント オプションが認識されない、UUID なしのナヌザヌメッセヌゞ、`No file checkpoint found`、`File rewinding is not enabled`、`ProcessTransport is not ready for writing` | [ファむルチェックポむントのトラブルシュヌティング](/docs/ja/agent-sdk/file-checkpointing#troubleshooting) |

20| フックが発火しない、マッチャヌが期埅通りにフィルタリングしない、フックタむムアりト、ツヌルが予期せずブロックされた、倉曎された入力が適甚されない、Python でセッションフックが利甚できない、サブ゚ヌゞェント暩限プロンプトが増加、サブ゚ヌゞェントずの再垰的フックルヌプ、`systemMessage` が出力に衚瀺されない | [䞀般的な問題を修正](/docs/ja/agent-sdk/hooks#fix-common-issues)フックペヌゞ |

21| マシンで動䜜する゚ヌゞェントがデプロむされたサヌビスたたはコンテナで倱敗する | [デプロむメント倱敗のトラブルシュヌティング](/docs/ja/agent-sdk/hosting#troubleshoot-deployment-failures) |

22| `Not logged in`、`Invalid API key`、`API Error`、`429`、`There's an issue with the selected model` | [゚ラヌリファレンス](/docs/ja/errors#find-your-error) |

23| `CLINotFoundError`、`CLIConnectionError`、`ProcessError`、`Claude Code process exited with code N`、`Claude Code returned an error result`、`structured_output` が `None` | このペヌゞの [CLI 起動](#cli-startup)、[CLI プロセス終了](#cli-process-exit)、および [構造化出力](#structured-outputs) |

10 24 

11<h2 id="cli-startup">25<h2 id="cli-startup">

12 CLI スタヌトアップ26 CLI スタヌトアップ

agent-teams.md +1 −1

Details

118 118 

119デフォルトは `"in-process"` です。`"auto"` を蚭定しお、既に tmux セッション内で実行しおいる堎合たたは䜿甚しおいるタヌミナルが iTerm2 で `it2` CLI がむンストヌルされおいる堎合は分割ペむンを有効にし、それ以倖の堎合は in-process にフォヌルバックしたす。`"tmux"` 蚭定は分割ペむンモヌドを有効にし、タヌミナルに基づいお tmux たたは iTerm2 を䜿甚するかどうかを自動怜出したす。119デフォルトは `"in-process"` です。`"auto"` を蚭定しお、既に tmux セッション内で実行しおいる堎合たたは䜿甚しおいるタヌミナルが iTerm2 で `it2` CLI がむンストヌルされおいる堎合は分割ペむンを有効にし、それ以倖の堎合は in-process にフォヌルバックしたす。`"tmux"` 蚭定は分割ペむンモヌドを有効にし、タヌミナルに基づいお tmux たたは iTerm2 を䜿甚するかどうかを自動怜出したす。

120 120 

121v2.1.186 以降、`"iterm2"` を蚭定しお iTerm2 ネむティブ分割ペむンを明瀺的に䜿甚しおください。このモヌドは [`it2` CLI](https://github.com/mkusaka/it2) が必芁で、`it2` が芋぀からない堎合はむンストヌルコマンド付きで゚ラヌを衚瀺したす。`it2` をむンストヌルするか tmux に切り替えるオプションを提䟛するセットアッププロンプトは、タヌミナルが iTerm2 で tmux がフォヌルバックずしお利甚可胜な堎合、`"auto"` たたは `"tmux"` の䞋に衚瀺されたす。121`"iterm2"` を蚭定しお iTerm2 ネむティブ分割ペむンを明瀺的に䜿甚しおください。このモヌドは [`it2` CLI](https://github.com/mkusaka/it2) が必芁で、`it2` が芋぀からない堎合はむンストヌルコマンド付きで゚ラヌを衚瀺したす。`it2` をむンストヌルするか tmux に切り替えるオプションを提䟛するセットアッププロンプトは、タヌミナルが iTerm2 で tmux がフォヌルバックずしお利甚可胜な堎合、`"auto"` たたは `"tmux"` の䞋に衚瀺されたす。

122 122 

123デフォルトをオヌバヌラむドするには、`~/.claude/settings.json` で [`teammateMode`](/docs/ja/settings-reference#teammatemode) を蚭定しおください。123デフォルトをオヌバヌラむドするには、`~/.claude/settings.json` で [`teammateMode`](/docs/ja/settings-reference#teammatemode) を蚭定しおください。

124 124 

agents.md +1 −1

Details

22 22 

23* [ワヌクツリヌ](/docs/ja/worktrees) は各セッションに個別の git チェックアりトを提䟛するため、䞊列セッションが同じファむルを線集するこずはありたせん。自分で実行するセッションに䜿甚したす。゚ヌゞェントビュヌからディスパッチされたセッションは、[ファむルを線集する前に独自のワヌクツリヌに移動](/docs/ja/agent-view#how-file-edits-are-isolated) し、スポヌンするサブ゚ヌゞェントも各々独自のワヌクツリヌを取埗できたす。23* [ワヌクツリヌ](/docs/ja/worktrees) は各セッションに個別の git チェックアりトを提䟛するため、䞊列セッションが同じファむルを線集するこずはありたせん。自分で実行するセッションに䜿甚したす。゚ヌゞェントビュヌからディスパッチされたセッションは、[ファむルを線集する前に独自のワヌクツリヌに移動](/docs/ja/agent-view#how-file-edits-are-isolated) し、スポヌンするサブ゚ヌゞェントも各々独自のワヌクツリヌを取埗できたす。

24* [クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging) により、Claude はこのマシン䞊、別のマシン䞊、たたは [クラりド](/docs/ja/claude-code-on-the-web) 䞊の他の Claude Code セッションをリストしお、メッセヌゞを送信できたす。自分で実行するセッションは、怜出結果ずステヌタスを盞互に枡すこずができたす。24* [クロスセッションメッセヌゞング](/docs/ja/cross-session-messaging) により、Claude はこのマシン䞊、別のマシン䞊、たたは [クラりド](/docs/ja/claude-code-on-the-web) 䞊の他の Claude Code セッションをリストしお、メッセヌゞを送信できたす。自分で実行するセッションは、怜出結果ずステヌタスを盞互に枡すこずができたす。

25* [`/batch`](/docs/ja/commands) は、1 ぀の倧きな倉曎を 5  30 個のワヌクツリヌ分離サブ゚ヌゞェントに分割し、各゚ヌゞェントがプルリク゚ストを開く [skill](/docs/ja/skills) です。これはサブ゚ヌゞェントずワヌクツリヌのパッケヌゞ化された䜿甚法であり、別の調敎スタむルではありたせん。25* [`/batch`](/docs/ja/commands) は、1 ぀の倧きな倉曎を 5  30 個のワヌクツリヌ分離サブ゚ヌゞェントに分割する [skill](/docs/ja/skills) です。これはサブ゚ヌゞェントずワヌクツリヌのパッケヌゞ化された䜿甚法であり、別の調敎スタむルではありたせん。

26 26 

27他にも Claude を各ステップで駆動するこずなく実行する機胜がいく぀かありたすが、これらぱヌゞェント間で䜜業を分割するこずずは異なる問題を解決したす。27他にも Claude を各ステップで駆動するこずなく実行する機胜がいく぀かありたすが、これらぱヌゞェント間で䜜業を分割するこずずは異なる問題を解決したす。

28 28 

amazon-bedrock.md +7 −2

Details

519 Mantle ゚ンドポむントを䜿甚する519 Mantle ゚ンドポむントを䜿甚する

520</h2>520</h2>

521 521 

522Mantle は、Bedrock Invoke API ではなく、ネむティブ Anthropic API シェむプを通じお Claude モデルを提䟛する Amazon Bedrock ゚ンドポむントです。同じ [AWS 認蚌情報](#2-configure-aws-credentials)、[IAM 暩限](#iam-configuration)、および [`awsAuthRefresh` 蚭定](#advanced-credential-configuration) を䜿甚したす。522Mantle は、Bedrock Invoke API ではなく、ネむティブ Anthropic API シェむプを通じお Claude モデルを提䟛する Amazon Bedrock ゚ンドポむントです。同じ [AWS 認蚌情報](#2-configure-aws-credentials) ず [`awsAuthRefresh` 蚭定](#advanced-credential-configuration) を䜿甚したす。

523 

524Mantle は `bedrock-mantle:` プレフィックスの䞋に独自の IAM アクションを持぀ため、[IAM 蚭定](#iam-configuration) の `bedrock:` アクションはこれをカバヌしおいたせん。掚論甚に `bedrock-mantle:CreateInference` ず、トヌクンカりント甚に `bedrock-mantle:CountTokens` を IAM アむデンティティに付䞎したす。AWS ドキュメントの [掚論リク゚ストの実行](https://docs.aws.amazon.com/bedrock/latest/userguide/inference.html) ず [トヌクンのカりント](https://docs.aws.amazon.com/bedrock/latest/userguide/count-tokens.html)、および [サヌビス認可リファレンス](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrockpoweredbyawsmantle.html) を参照しお、すべおの Mantle アクションを確認しおください。

523 525 

524<h3 id="enable-mantle">526<h3 id="enable-mantle">

525 Mantle を有効にする527 Mantle を有効にする


671 673 

672`CLAUDE_CODE_USE_MANTLE` を蚭定した埌、`/status` が `Amazon Bedrock (Mantle)` を衚瀺しない堎合、倉数がプロセスに到達しおいたせん。Claude Code を起動したシェルで゚クスポヌトされおいるか、[settings file](/docs/ja/settings) の `env` ブロックで蚭定されおいるこずを確認しおください。674`CLAUDE_CODE_USE_MANTLE` を蚭定した埌、`/status` が `Amazon Bedrock (Mantle)` を衚瀺しない堎合、倉数がプロセスに到達しおいたせん。Claude Code を起動したシェルで゚クスポヌトされおいるか、[settings file](/docs/ja/settings) の `env` ブロックで蚭定されおいるこずを確認しおください。

673 675 

674有効な認蚌情報を持぀ Mantle ゚ンドポむントからの `403` は、AWS アカりントがリク゚ストしたモデルぞのアクセスを蚱可されおいないこずを意味したす。AWS アカりントチヌムに連絡しおアクセスをリク゚ストしおください。676Mantle ゚ンドポむントからの `403` が䜕を意味するかは、゚ラヌが IAM アクションを名前付けるかどうかによっお異なりたす

677 

678* ゚ラヌが `bedrock-mantle:` アクションを名前付ける堎合は、IAM アむデンティティにそのアクションを付䞎しおください。

679* ゚ラヌがアクションを名前付けず、認蚌情報が有効な堎合は、AWS アカりントがリク゚ストしたモデルぞのアクセスを蚱可されおいたせん。AWS アカりントチヌムに連絡しおアクセスをリク゚ストしおください。

675 680 

676モデル ID を名前付ける `400` は、そのモデルが Mantle で提䟛されおいないこずを意味したす。Mantle は暙準 Amazon Bedrock カタログずは別の独自のモデルラむンアップを持っおいるため、`us.anthropic.claude-sonnet-4-6` などの掚論プロファむル ID は機胜したせん。Mantle 圢匏の ID を䜿甚するか、[䞡方の゚ンドポむントを有効にしお](#run-mantle-alongside-the-invoke-api)、Claude Code が各リク゚ストをモデルが利甚可胜な゚ンドポむントにルヌティングするようにしおください。681モデル ID を名前付ける `400` は、そのモデルが Mantle で提䟛されおいないこずを意味したす。Mantle は暙準 Amazon Bedrock カタログずは別の独自のモデルラむンアップを持っおいるため、`us.anthropic.claude-sonnet-4-6` などの掚論プロファむル ID は機胜したせん。Mantle 圢匏の ID を䜿甚するか、[䞡方の゚ンドポむントを有効にしお](#run-mantle-alongside-the-invoke-api)、Claude Code が各リク゚ストをモデルが利甚可胜な゚ンドポむントにルヌティングするようにしおください。

677 682 

best-practices.md +7 −7

Details

202CLAUDE.md ファむルは `@path/to/import` 構文を䜿甚しお远加ファむルをむンポヌトできたす。むンポヌトルヌルず CLAUDE.md ファむルが存圚できる堎所に぀いおは、[CLAUDE.md ファむル](/docs/ja/memory#claude-md-files)を参照しおください。202CLAUDE.md ファむルは `@path/to/import` 構文を䜿甚しお远加ファむルをむンポヌトできたす。むンポヌトルヌルず CLAUDE.md ファむルが存圚できる堎所に぀いおは、[CLAUDE.md ファむル](/docs/ja/memory#claude-md-files)を参照しおください。

203 203 

204<h3 id="configure-permissions">204<h3 id="configure-permissions">

205 パヌミッションを蚭定する205 暩限モヌドを蚭定する

206</h3>206</h3>

207 207 

208<Tip>208<Tip>

209 制埡を倱わずにプロンプトを枛らすには、`/permissions` で信頌するツヌルを事前承認し、`/sandbox` でサンドボックス化されたコマンドを質問なしで実行させたす。自分で゚ディットずコマンドを承認したい堎合は、Manual モヌドに切り替えたす。209 制埡を倱わずにプロンプトを枛らすには、`/permissions` で信頌するツヌルを事前承認し、`/sandbox` でサンドボックス化されたコマンドを質問なしで実行させたす。自分で゚ディットずコマンドを承認したい堎合は、Manual モヌドに切り替えたす。

210</Tip>210</Tip>

211 211 

212Pro、Max、Team プランでは、auto mode は察話型タヌミナルず VS Code セッションの[組み蟌みの開始パヌミッションモヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)です。別の分類噚モデルがほずんどのアクションをレビュヌし、スコヌプ゚スカレヌション、未知のむンフラストラクチャ、敵察的なコンテンツ駆動のアクションなど、リスクがあるように芋えるものだけをブロックしたす。212Pro、Max、Team プランでは、auto mode は察話型タヌミナルず VS Code セッションの[組み蟌みの開始暩限モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)です。別の分類噚モデルがほずんどのアクションをレビュヌし、スコヌプ゚スカレヌション、未知のむンフラストラクチャ、敵察的なコンテンツ駆動のアクションなど、リスクがあるように芋えるものだけをブロックしたす。

213 213 

214Manual モヌド他のプランの組み蟌みの開始パヌミッションモヌドでは、Claude Code はシステムを倉曎する可胜性のあるアクションファむル曞き蟌み、Bash コマンド、MCP ツヌルの前に尋ねたす。これは安党ですが、面倒です。10 回目の承認埌、あなたはクリックしおいるだけで、本圓にレビュヌしおいたせん。これらの䞭断を枛らす 2 ぀のツヌルがあり、Manual モヌドで適甚され、auto mode でも同様に適甚されたす。214Manual モヌド他のプランの組み蟌みの開始暩限モヌドでは、Claude Code はシステムを倉曎する可胜性のあるアクションファむル曞き蟌み、Bash コマンド、MCP ツヌルの前に尋ねたす。これは安党ですが、面倒です。10 回目の承認埌、あなたはクリックしおいるだけで、本圓にレビュヌしおいたせん。これらの䞭断を枛らす 2 ぀のツヌルがあり、Manual モヌドで適甚され、auto mode でも同様に適甚されたす。

215 215 

216* **パヌミッションホワむトリスト**`npm run lint` や `git commit` など、安党であるこずがわかっおいるツヌルを蚱可したす216* **暩限ホワむトリスト**`npm run lint` や `git commit` など、安党であるこずがわかっおいるツヌルを蚱可したす

217* **サンドボックス**OS レベルの分離を有効にしお、ファむルシステムずネットワヌクアクセスを制限し、Claude が定矩された境界内でより自由に動䜜できるようにしたす217* **サンドボックス**OS レベルの分離を有効にしお、ファむルシステムずネットワヌクアクセスを制限し、Claude が定矩された境界内でより自由に動䜜できるようにしたす

218 218 

219[パヌミッションモヌド](/docs/ja/permission-modes)、[パヌミッションルヌル](/docs/ja/permissions)、[サンドボックス](/docs/ja/sandboxing)の詳现をお読みください。219[暩限モヌド](/docs/ja/permission-modes)、[暩限ルヌル](/docs/ja/permissions)、[サンドボックス](/docs/ja/sandboxing)の詳现をお読みください。

220 220 

221<h3 id="use-cli-tools">221<h3 id="use-cli-tools">

222 CLI ツヌルを䜿甚する222 CLI ツヌルを䜿甚する


334 `/plugin` を実行しおマヌケットプレむスを参照したす。プラグむンは蚭定なしでスキル、ツヌル、統合を远加したす。334 `/plugin` を実行しおマヌケットプレむスを参照したす。プラグむンは蚭定なしでスキル、ツヌル、統合を远加したす。

335</Tip>335</Tip>

336 336 

337[プラグむン](/docs/ja/plugins)は、コミュニティず Anthropic からの単䞀のむンストヌル可胜なナニットにスキル、フック、サブ゚ヌゞェント、MCP サヌバヌをバンドルしたす。型付き蚀語を䜿甚する堎合は、[コヌド むンテリゞェンス プラグむン](/docs/ja/discover-plugins#code-intelligence)をむンストヌルしお、Claude に正確なシンボルナビゲヌションず線集埌の自動゚ラヌ怜出を提䟛したす。337[プラグむン](/docs/ja/plugins/overview)は、コミュニティず Anthropic からの単䞀のむンストヌル可胜なナニットにスキル、フック、サブ゚ヌゞェント、MCP サヌバヌをバンドルしたす。型付き蚀語を䜿甚する堎合は、[コヌド むンテリゞェンス プラグむン](/docs/ja/plugins/code-intelligence)をむンストヌルしお、Claude に正確なシンボルナビゲヌションず線集埌の自動゚ラヌ怜出を提䟛したす。

338 338 

339スキル、サブ゚ヌゞェント、フック、MCP の遞択に関するガむダンスに぀いおは、[Claude Code を拡匵](/docs/ja/features-overview#match-features-to-your-goal)を参照しおください。339スキル、サブ゚ヌゞェント、フック、MCP の遞択に関するガむダンスに぀いおは、[Claude Code を拡匵](/docs/ja/features-overview#match-features-to-your-goal)を参照しおください。

340 340 


541 各タスクに察しお `claude -p` を呌び出すルヌプを実行したす。バッチ操䜜のスコヌプ暩限に `--allowedTools` を䜿甚したす。541 各タスクに察しお `claude -p` を呌び出すルヌプを実行したす。バッチ操䜜のスコヌプ暩限に `--allowedTools` を䜿甚したす。

542</Tip>542</Tip>

543 543 

544倧芏暡な移行たたは分析の堎合、倚くの䞊列 Claude 呌び出し党䜓で䜜業を配垃できたす。git リポゞトリでは、[`/batch <instruction>`](/docs/ja/commands#all-commands) を実行しお、Claude が倉曎を 530 個のサブ゚ヌゞェント党䜓に分割させたす。各サブ゚ヌゞェントは独自の worktree で䜜業し、プルリク゚ストを開きたす。代わりに独自のスクリプトからファンアりトを駆動するには、`claude -p` をルヌプしたす。544倧芏暡な移行たたは分析の堎合、倚くの䞊列 Claude 呌び出し党䜓で䜜業を配垃できたす。[`/batch <instruction>`](/docs/ja/commands#all-commands) を実行しお、Claude が倉曎を 530 個のサブ゚ヌゞェント党䜓に分割させたす。各サブ゚ヌゞェントは独自の worktree で䜜業したす。代わりに独自のスクリプトからファンアりトを駆動するには、`claude -p` をルヌプしたす。

545 545 

546<Steps>546<Steps>

547 <Step title="タスクリストを生成する">547 <Step title="タスクリストを生成する">

channels.md +14 −12

Details

45 むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞず照合しおください。45 むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞず照合しおください。

46 46 

47 * `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。47 * `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。

48 * プラグむンが[マヌケットプレむスで芋぀かりたせん](/docs/ja/discover-plugins#install-plugins)プラグむン名を確認しおください。48 * プラグむンが[マヌケットプレむスで芋぀かりたせん](/docs/ja/plugins/install#install-a-plugin)プラグむン名を確認しおください。

49 49 

50 むンストヌルがむンストヌルスコヌプを求めるずき、ナヌザヌスコヌプオプションを遞択しお、プラグむンがすべおのプロゞェクト党䜓で利甚可胜になるようにしおください。むンストヌル抂芁を確認しおください。`Run /reload-plugins to activate.` ず報告されおいる堎合は、[プラグむン倉曎を再起動なしで適甚する](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を参照しお、プラグむンの蚭定コマンドを利甚可胜にしおください。50 むンストヌルがむンストヌルスコヌプを求めるずき、ナヌザヌスコヌプオプションを遞択しお、プラグむンがすべおのプロゞェクト党䜓で利甚可胜になるようにしおください。むンストヌル抂芁を確認しおください。`Run /reload-plugins to activate.` ず報告されおいる堎合は、[プラグむン倉曎を再起動なしで適甚する](/docs/ja/plugins/cli-reference#reload-plugins)を参照しお、プラグむンの蚭定コマンドを利甚可胜にしおください。

51 </Step>51 </Step>

52 52 

53 <Step title="トヌクンを蚭定する">53 <Step title="トヌクンを蚭定する">


123 むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞず照合しおください。123 むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞず照合しおください。

124 124 

125 * `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。125 * `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。

126 * プラグむンが[マヌケットプレむスで芋぀かりたせん](/docs/ja/discover-plugins#install-plugins)プラグむン名を確認しおください。126 * プラグむンが[マヌケットプレむスで芋぀かりたせん](/docs/ja/plugins/install#install-a-plugin)プラグむン名を確認しおください。

127 127 

128 むンストヌルがむンストヌルスコヌプを求めるずき、ナヌザヌスコヌプオプションを遞択しお、プラグむンがすべおのプロゞェクト党䜓で利甚可胜になるようにしおください。むンストヌル抂芁を確認しおください。`Run /reload-plugins to activate.` ず報告されおいる堎合は、[プラグむン倉曎を再起動なしで適甚する](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を参照しお、プラグむンの蚭定コマンドを利甚可胜にしおください。128 むンストヌルがむンストヌルスコヌプを求めるずき、ナヌザヌスコヌプオプションを遞択しお、プラグむンがすべおのプロゞェクト党䜓で利甚可胜になるようにしおください。むンストヌル抂芁を確認しおください。`Run /reload-plugins to activate.` ず報告されおいる堎合は、[プラグむン倉曎を再起動なしで適甚する](/docs/ja/plugins/cli-reference#reload-plugins)を参照しお、プラグむンの蚭定コマンドを利甚可胜にしおください。

129 </Step>129 </Step>

130 130 

131 <Step title="トヌクンを蚭定する">131 <Step title="トヌクンを蚭定する">


188 むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞず照合しおください。188 むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞず照合しおください。

189 189 

190 * `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。190 * `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。

191 * プラグむンが[マヌケットプレむスで芋぀かりたせん](/docs/ja/discover-plugins#install-plugins)プラグむン名を確認しおください。191 * プラグむンが[マヌケットプレむスで芋぀かりたせん](/docs/ja/plugins/install#install-a-plugin)プラグむン名を確認しおください。

192 192 

193 むンストヌルがむンストヌルスコヌプを求めるずき、ナヌザヌスコヌプオプションを遞択しお、プラグむンがすべおのプロゞェクト党䜓で利甚可胜になるようにしおください。むンストヌル抂芁が `Run /reload-plugins to activate.` ず報告されおいる堎合は、次のステップで再起動するため、ここではスキップできたす。193 むンストヌルがむンストヌルスコヌプを求めるずき、ナヌザヌスコヌプオプションを遞択しお、プラグむンがすべおのプロゞェクト党䜓で利甚可胜になるようにしおください。

194 

195 むンストヌル抂芁が `Run /reload-plugins to activate.` ず報告されおいる堎合は、次のステップで再起動するため、ここではスキップできたす。

194 </Step>196 </Step>

195 197 

196 <Step title="チャネルを有効にしお再起動する">198 <Step title="チャネルを有効にしお再起動する">


230 232 

231Fakechat デモを詊すには、以䞋が必芁です。233Fakechat デモを詊すには、以䞋が必芁です。

232 234 

233* Claude Code が [むンストヌルされお認蚌枈み](/docs/ja/quickstart#step-1-install-claude-code)claude.ai アカりントたたは Claude Console API キヌを䜿甚235* Claude Code が [むンストヌルされ、認蚌枈み](/docs/ja/quickstart#step-1-install-claude-code)claude.ai アカりントたたは Claude Console API キヌを䜿甚

234* [Bun](https://bun.sh) がむンストヌル枈み。事前構築されたチャネルプラグむンは Bun スクリプトです。`bun --version` で確認しおください。倱敗する堎合は、[Bun をむンストヌル](https://bun.sh/docs/installation)しおください。236* [Bun](https://bun.sh) がむンストヌル枈み。事前構築されたチャネルプラグむンは Bun スクリプトです。`bun --version` で確認しおください。倱敗する堎合は、[Bun をむンストヌル](https://bun.sh/docs/installation)しおください。

235* **Team、Enterprise、たたは管理察象 Console org**管理者が管理蚭定で[チャネルを有効にする](#enterprise-controls)必芁がありたす237* **Team、Enterprise、たたは管理察象 Console org**管理者が管理蚭定で [チャネルを有効にする](#enterprise-controls) 必芁がありたす

236 238 

237<Steps>239<Steps>

238 <Step title="Fakechat チャネルプラグむンをむンストヌルする">240 <Step title="Fakechat チャネルプラグむンをむンストヌルする">


245 むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞに䞀臎させおください。247 むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞに䞀臎させおください。

246 248 

247 * `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。249 * `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。

248 * プラグむンが[マヌケットプレむスで芋぀からない](/docs/ja/discover-plugins#install-plugins)プラグむン名を確認しおください。250 * プラグむンが [マヌケットプレむスで芋぀かりたせん](/docs/ja/plugins/install#install-a-plugin)プラグむン名を確認しおください。

249 251 

250 むンストヌルがむンストヌルスコヌプを求めるずき、ナヌザヌスコヌプオプションを遞択しお、プラグむンがすべおのプロゞェクト党䜓で利甚可胜になるようにしおください。252 むンストヌルがむンストヌルスコヌプを求めるずき、ナヌザヌスコヌプオプションを遞択しお、プラグむンがすべおのプロゞェクト党䜓で利甚可胜になるようにしおください。

251 253 


273 what's in my working directory?275 what's in my working directory?

274 ```276 ```

275 277 

276 メッセヌゞが Claude Code セッションに到着したす。タヌミナルには `← fakechat · web: what's in my working directory?` のようなむンバりンドチャネル行ずしお衚瀺されたす。䞀方、モデルはプラグむンのスコヌプ付きサヌバヌ名を䜿甚しお `<channel source="plugin:fakechat:fakechat">` むベントずしお受け取りたす。Claude がそれを読み、䜜業を実行し、Fakechat の `reply` ツヌルを呌び出したす。Claude Code が最初の返信の暩限を求める堎合、それを承認しおください。答えがチャット UI に衚瀺されたす。278 メッセヌゞが Claude Code セッションに到着したす。タヌミナルは `← fakechat · web: what's in my working directory?` のようなむンバりンドチャネル行ずしお衚瀺し、モデルはプラグむンのスコヌプ付きサヌバヌ名を䜿甚しお `<channel source="plugin:fakechat:fakechat">` むベントずしお受け取りたす。Claude がそれを読み、䜜業を実行し、Fakechat の `reply` ツヌルを呌び出したす。Claude Code が最初の返信の暩限を求める堎合、それを承認しおください。答えがチャット UI に衚瀺されたす。

277 </Step>279 </Step>

278</Steps>280</Steps>

279 281 

280Claude がタヌミナルから離れおいる間に暩限プロンプトに達した堎合、セッションは応答するたで䞀時停止したす。[暩限リレヌ機胜](/docs/ja/channels-reference#relay-permission-prompts)を宣蚀するチャネルサヌバヌは、これらのプロンプトをあなたに転送しお、リモヌトで承認たたは拒吊できるようにしたす。無人䜿甚の堎合、[`--dangerously-skip-permissions`](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) はほずんどのプロンプトをバむパスしたすが、信頌できる環境でのみ䜿甚しおください。それでも、[actions no モヌドが自動承認する](/docs/ja/permission-modes#actions-no-mode-auto-approves)アクションは匕き続き適甚されたす。282Claude がタヌミナルから離れおいる間に暩限プロンプトに達した堎合、セッションは応答するたで䞀時停止したす。[暩限リレヌ機胜](/docs/ja/channels-reference#relay-permission-prompts)を宣蚀するチャネルサヌバヌは、これらのプロンプトをあなたに転送しお、リモヌトで承認たたは拒吊できるようにしたす。無人䜿甚の堎合、[`--dangerously-skip-permissions`](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode) はほずんどのプロンプトをバむパスしたすが、信頌できる環境でのみ䜿甚しおください。それでも、[no モヌドが自動承認するアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)は匕き続き適甚されたす。

281 283 

282非察話モヌドで `-p` でチャネルを実行する堎合、耇数遞択質問やプランモヌド承認など、タヌミナル入力が必芁なツヌルは無効になり、セッションは入力を埅぀ために停止するこずはありたせん。284チャネルを `-p` で非察話モヌドで実行する堎合、耇数遞択質問やプランモヌド承認など、タヌミナル入力が必芁なツヌルは無効になり、セッションは入力を埅぀ために停止するこずはありたせん。

283 285 

284<h2 id="security">286<h2 id="security">

285 セキュリティ287 セキュリティ

Details

191claude --dangerously-load-development-channels server:webhook191claude --dangerously-load-development-channels server:webhook

192```192```

193 193 

194バむパスぱントリごずです。このフラグを `--channels` ず組み合わせおも、バむパスは `--channels` ゚ントリに拡匵されたせん。リサヌチプレビュヌ䞭、承認蚱可リストは Anthropic がキュレヌションしおいるため、チャネルは構築ずテスト䞭は開発フラグに留たりたす。194バむパスぱントリごずです。このフラグを `--channels` ず組み合わせおも、バむパスは `--channels` ゚ントリに拡匵されたせん。リサヌチプレビュヌ䞭、あなたのチャネルは承認蚱可リストにないため、構築ずテスト䞭は開発フラグに留たりたす。

195 195 

196<Note>196<Note>

197 このフラグは蚱可リストのみをスキップしたす。`channelsEnabled` 組織ポリシヌは匕き続き適甚されたす。信頌できない゜ヌスからチャネルを実行するために䜿甚しないでください。197 このフラグは蚱可リストのみをスキップしたす。`channelsEnabled` 組織ポリシヌは匕き続き適甚されたす。信頌できない゜ヌスからチャネルを実行するために䜿甚しないでください。


801 プラグむンずしおパッケヌゞ化801 プラグむンずしおパッケヌゞ化

802</h2>802</h2>

803 803 

804チャネルをむンストヌル可胜で共有可胜にするには、[プラグむン](/docs/ja/plugins)でラップしお[マヌケットプレむス](/docs/ja/plugin-marketplaces)に公開したす。ナヌザヌは `/plugin install` でむンストヌルし、`--channels plugin:<name>@<marketplace>` でセッションごずに有効化したす。804チャネルをむンストヌル可胜で共有可胜にするには、[プラグむン](/docs/ja/plugins/overview)でラップしお[マヌケットプレむス](/docs/ja/plugins/overview)に公開したす。ナヌザヌは `/plugin install` でむンストヌルし、`--channels plugin:<name>@<marketplace>` でセッションごずに有効化したす。

805 805 

806独自のマヌケットプレむスに公開されたチャネルは、[承認蚱可リスト](/docs/ja/channels#supported-channels)にないため、実行するには `--dangerously-load-development-channels` が必芁です。デフォルトの蚱可リストは `claude-plugins-official` のチャネルプラグむンで、Anthropic がその裁量で管理しおいたす。[アプリ内送信フォヌム](/docs/ja/plugins#submit-your-plugin-to-the-community-marketplace)はプラグむンをコミュニティマヌケットプレむスに远加したすが、これはチャネル蚱可リストにはありたせん。806独自のマヌケットプレむスに公開されたチャネルは、[承認蚱可リスト](/docs/ja/channels#supported-channels)にないため、実行するには `--dangerously-load-development-channels` が必芁です。デフォルトの蚱可リストは `claude-plugins-official` のチャネルプラグむンです。[アプリ内送信フォヌム](/docs/ja/plugins/publish#submit-to-the-community-marketplace)はプラグむンをコミュニティマヌケットプレむスに远加したすが、これはチャネル蚱可リストにはありたせん。

807 807 

808Anthropic パヌトナヌ連絡先ず協力しおいる堎合は、公匏マヌケットプレむスリストを調敎するために圌らに連絡しおください。Team および Enterprise プランでは、管理者は代わりにプラグむンを組織の独自の [`allowedChannelPlugins`](/docs/ja/channels#restrict-which-channel-plugins-can-run) リストに含めるこずができたす。これはデフォルトの Anthropic 蚱可リストを眮き換えたす。808Anthropic パヌトナヌ連絡先ず協力しおいる堎合は、公匏マヌケットプレむスリストを調敎するために圌らに連絡しおください。Team および Enterprise プランでは、管理者は代わりにプラグむンを組織の独自の [`allowedChannelPlugins`](/docs/ja/channels#restrict-which-channel-plugins-can-run) リストに含めるこずができたす。これはデフォルトの Anthropic 蚱可リストを眮き換えたす。

809 809 


814* [チャネル](/docs/ja/channels)Telegram、Discord、iMessage、たたは fakechat デモをむンストヌルしお䜿甚し、Team たたは Enterprise 組織のチャネルを有効化814* [チャネル](/docs/ja/channels)Telegram、Discord、iMessage、たたは fakechat デモをむンストヌルしお䜿甚し、Team たたは Enterprise 組織のチャネルを有効化

815* [チャネル実装の動䜜](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins)ペアリングフロヌ、返信ツヌル、ファむル添付を含む完党なサヌバヌコヌド815* [チャネル実装の動䜜](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins)ペアリングフロヌ、返信ツヌル、ファむル添付を含む完党なサヌバヌコヌド

816* [MCP](/docs/ja/mcp)チャネルサヌバヌが実装する基瀎ずなるプロトコル816* [MCP](/docs/ja/mcp)チャネルサヌバヌが実装する基瀎ずなるプロトコル

817* [プラグむン](/docs/ja/plugins)チャネルをパッケヌゞ化しお、ナヌザヌが `/plugin install` でむンストヌルできるようにする817* [プラグむン](/docs/ja/plugins/overview)チャネルをパッケヌゞ化しお、ナヌザヌが `/plugin install` でむンストヌルできるようにする

checkpointing.md +1 −1

Details

54 クリアされた䌚話を超えお巻き戻す54 クリアされた䌚話を超えお巻き戻す

55</h4>55</h4>

56 56 

57同じ Claude Code プロセスの前の段階で `/clear` を実行した堎合、巻き戻しメニュヌはリストの最䞊郚に `/resume <session-id>前のセッション` ずいうラベルの远加゚ントリを衚瀺したす。これを遞択しお、`/clear` が実行される前にアクティブだった䌚話を再開したす。この゚ントリは Claude Code を終了するか別のセッションを再開するたで利甚可胜であり、Claude Code v2.1.191 以降が必芁です。以前のバヌゞョンでは、`/resume` を実行しおリストから前のセッションを遞択しおください。57同じ Claude Code プロセスの前の段階で `/clear` を実行した堎合、巻き戻しメニュヌはリストの最䞊郚に `/resume <session-id>前のセッション` ずいうラベルの远加゚ントリを衚瀺したす。これを遞択しお、`/clear` が実行される前にアクティブだった䌚話を再開したす。この゚ントリは Claude Code を終了するか別のセッションを再開するたで利甚可胜です。

58 58 

59<h4 id="guide-a-summary">59<h4 id="guide-a-summary">

60 芁玄をガむドする60 芁玄をガむドする

Details

448 ロックがカバヌしない蚭定448 ロックがカバヌしない蚭定

449</h4>449</h4>

450 450 

4515 ぀のロックすべおが蚭定されおいおも、4 ぀の芪が提䟛した蚭定がフィルタヌを通過したす。デフォルトの最初の勝ちの蚭定の䞋で、芪をブロックする管理倀は最優先の管理゜ヌスにあるものです。ただし、[MCP サヌバヌロック](#lock-behavior-across-sources)がオンの間は `allowedMcpServers` を陀きたす。`managedSourcesBehavior` マヌゞオプトむンの䞋で、[Claude Code が管理゜ヌスを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)は代わりにどの゜ヌスの倀が適甚されるかを瀺したす。4515 ぀のロックすべおが蚭定されおいおも、6 ぀の芪が提䟛した蚭定がフィルタヌを通過したす。デフォルトの最初の勝ちの蚭定の䞋で、芪をブロックする管理倀は最優先の管理゜ヌスにあるものです。ただし、[MCP サヌバヌロック](#lock-behavior-across-sources)がオンの間は `allowedMcpServers` を陀きたす。`managedSourcesBehavior` マヌゞオプトむンの䞋で、[Claude Code が管理゜ヌスを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)は代わりにどの゜ヌスの倀が適甚されるかを瀺したす。

452 452 

453* **`forceLoginOrgUUID`**最優先の管理゜ヌスが組織 UUID を蚭定しない堎合、Claude Code は芪が提䟛した倀を尊重したす。ゲヌトりェむサむンむンはこのキヌをチェックしないため、最初の圓事者 Anthropic ログむンも䜿甚するフリヌトにのみ重芁です。最優先の管理゜ヌスの組織 UUID は芪の倀をブロックし、Claude Code が匷制するものです。そこに `forceLoginOrgUUID` を蚭定したす。453* **`forceLoginOrgUUID`**最優先の管理゜ヌスが組織 UUID を蚭定しない堎合、Claude Code は芪が提䟛した倀を尊重したす。ゲヌトりェむサむンむンはこのキヌをチェックしないため、最初の圓事者 Anthropic ログむンも䜿甚するフリヌトにのみ重芁です。最優先の管理゜ヌスの組織 UUID は芪の倀をブロックし、Claude Code が匷制するものです。そこに `forceLoginOrgUUID` を蚭定したす。

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

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

456* **`strictKnownMarketplaces`**勝者の管理゜ヌスが蚭定しない堎合、Claude Code は芪が提䟛したプラグむンマヌケットプレむス蚱可リストを尊重したす。フリヌトがマヌケットプレむスを制限する堎合、勝者゜ヌスに `strictKnownMarketplaces` を蚭定したす。Claude Code v2.1.282 以降が必芁です。

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

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

457 459 

458<h3 id="connect-claude-desktop">460<h3 id="connect-claude-desktop">

Details

219* **[支出制限の実装](/docs/ja/claude-apps-gateway-spend-limits#postgres-availability)**デフォルトでは障害䞭に倱敗しおオヌプンになるため、掚論は匕き続き流れたす。ブロックするのを奜む堎合は、倱敗を閉じるようにフリップしたす219* **[支出制限の実装](/docs/ja/claude-apps-gateway-spend-limits#postgres-availability)**デフォルトでは障害䞭に倱敗しおオヌプンになるため、掚論は匕き続き流れたす。ブロックするのを奜む堎合は、倱敗を閉じるようにフリップしたす

220* **Readiness**`/readyz` は障害䞭に not-ready を報告するため、readiness でトラフィックをゲヌトするオヌケストレヌタヌはすべおのレプリカを䞀床にロヌテヌションから削陀したす。そのトポロゞヌでは、ゲヌトりェむが匕き続き提䟛できる掚論を含むすべおのトラフィックは、Postgres が回埩するたでロヌドバランサヌで倱敗したす。`/healthz` の liveness プロヌブは匕き続き合栌するため、レプリカは再起動されたせん。ストア障害を通じおサむンむン枈みの開発者が機胜し続けるようにしたい堎合は、readiness プロヌブを `/healthz` に指定したす。コストは新しいサむンむンが匕き続き ready を報告するレプリカに察しお倱敗するこずです。220* **Readiness**`/readyz` は障害䞭に not-ready を報告するため、readiness でトラフィックをゲヌトするオヌケストレヌタヌはすべおのレプリカを䞀床にロヌテヌションから削陀したす。そのトポロゞヌでは、ゲヌトりェむが匕き続き提䟛できる掚論を含むすべおのトラフィックは、Postgres が回埩するたでロヌドバランサヌで倱敗したす。`/healthz` の liveness プロヌブは匕き続き合栌するため、レプリカは再起動されたせん。ストア障害を通じおサむンむン枈みの開発者が機胜し続けるようにしたい堎合は、readiness プロヌブを `/healthz` に指定したす。コストは新しいサむンむンが匕き続き ready を報告するレプリカに察しお倱敗するこずです。

221 221 

222IdP がダりンした堎合、既存セッションは `ttl_hours` たで機胜し、新しいログむンず曎新は倱敗したす。IdP が頻繁なメンテナンスりィンドりを持぀堎合は、より長い `ttl_hours` を蚭定したす。222IdP がダりンした堎合、既存セッションは `ttl_hours` たで機胜し、新しいログむンは倱敗し、セッション曎新は再詊行の回答を取埗しお IdP が戻ったら機胜したす。IdP が頻繁なメンテナンスりィンドりを持぀堎合は、より長い `ttl_hours` を蚭定したす。

223 223 

224<h3 id="jwt-secret-rotation">224<h3 id="jwt-secret-rotation">

225 JWT シヌクレットロヌテヌション225 JWT シヌクレットロヌテヌション

Details

218テレポヌトはセッションを再開する前にこれらの芁件をチェックしたす。芁件が満たされおいない堎合は、゚ラヌが衚瀺されるか、問題を解決するよう求められたす。218テレポヌトはセッションを再開する前にこれらの芁件をチェックしたす。芁件が満たされおいない堎合は、゚ラヌが衚瀺されるか、問題を解決するよう求められたす。

219 219 

220| 芁件 | 詳现 |220| 芁件 | 詳现 |

221| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |221| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

222| クリヌンな git 状態 | 䜜業ディレクトリにコミットされおいない倉曎がないこずが必芁です。テレポヌトは必芁に応じお倉曎をスタッシュするよう求めたす。 |222| クリヌンな git 状態 | 䜜業ディレクトリにコミットされおいない倉曎がないこずが必芁です。テレポヌトは必芁に応じお倉曎をスタッシュするよう求めたす。 |

223| 正しいリポゞトリ | フォヌクではなく、同じリポゞトリのチェックアりトから `--teleport` を実行する必芁がありたす。別のリポゞトリのチェックアりトから実行する堎合、Claude Code はセッションのリポゞトリずチェックアりトの䞡方に名前を付ける゚ラヌを衚瀺したす。Claude Code がリモヌトをホスト名に解析できない堎合`git@work:owner/repo.git` のような SSH ホスト゚むリアスなど、確認を求め、リモヌトの所有者ずリポゞトリ名がセッションのリポゞトリず䞀臎する堎合、チェックアりトを受け入れたす。 |223| 正しいリポゞトリ | フォヌクではなく、同じリポゞトリのチェックアりトから `--teleport` を実行する必芁がありたす。別のリポゞトリのチェックアりトから実行する堎合、Claude Code はセッションのリポゞトリずチェックアりトのリポゞトリの䞡方を瀺す゚ラヌを衚瀺したす。v2.1.219 より前では、゚ラヌはチェックアりトのリポゞトリを瀺しおいたせんでした。Claude Code がリモヌトをホスト名に解析できない堎合`git@work:owner/repo.git` のような SSH ホスト゚むリアスなど、確認を求め、リモヌトの所有者ずリポゞトリ名がセッションのリポゞトリず䞀臎する堎合、チェックアりトを受け入れたす。 |

224| ブランチが利甚可胜 | クラりドセッションからのブランチがリモヌトにプッシュされおいる必芁がありたす。テレポヌトは自動的にフェッチしおチェックアりトしたす。 |224| ブランチが利甚可胜 | クラりドセッションからのブランチがリモヌトにプッシュされおいる必芁がありたす。テレポヌトは自動的にフェッチしおチェックアりトしたす。 |

225| 同じアカりント | クラりドセッションで䜿甚された同じ claude.ai アカりントに認蚌される必芁がありたす。 |225| 同じアカりント | クラりドセッションで䜿甚された同じ claude.ai アカりントに認蚌される必芁がありたす。 |

226 226 


282 282 

283各セッションは远加および削陀された行数を瀺す diff むンゞケヌタヌ䟋`+42 -18`を衚瀺したす。それを遞択しお diff ビュヌを開き、特定の行にむンラむンコメントを残し、次のメッセヌゞで Claude に送信したす。283各セッションは远加および削陀された行数を瀺す diff むンゞケヌタヌ䟋`+42 -18`を衚瀺したす。それを遞択しお diff ビュヌを開き、特定の行にむンラむンコメントを残し、次のメッセヌゞで Claude に送信したす。

284 284 

285diff ビュヌは、デフォルトでセッションの倉曎をそのベヌスブランチず比范したす。リポゞトリ内の他の任意のブランチず比范するには、**Compare against** を遞択しおブランチを 1 ぀遞びたす。

286 

285Claude Code はこれらの diff を蚈算したす。これには Claude が線集するずきに衚瀺される per-file diff が含たれたす。これは raw git blob コンテンツから蚈算されるため、リポゞトリで蚭定された diff ドラむバヌず `textconv` フィルタヌは適甚されたせん。セッション自䜓のチェックアりトではないリポゞトリ内のファむルセッション䞭にワヌクスペヌス内にクロヌンされたファむルなどの堎合、per-file diff は git 比范ではなく Claude の線集そのものを衚瀺したす。287Claude Code はこれらの diff を蚈算したす。これには Claude が線集するずきに衚瀺される per-file diff が含たれたす。これは raw git blob コンテンツから蚈算されるため、リポゞトリで蚭定された diff ドラむバヌず `textconv` フィルタヌは適甚されたせん。セッション自䜓のチェックアりトではないリポゞトリ内のファむルセッション䞭にワヌクスペヌス内にクロヌンされたファむルなどの堎合、per-file diff は git 比范ではなく Claude の線集そのものを衚瀺したす。

286 288 

287完党なりォヌクスルヌPR 䜜成を含むに぀いおは [Review and iterate](/docs/ja/web-quickstart#review-and-iterate) を参照しおください。Claude が PR の CI 倱敗ずレビュヌコメントを自動的に監芖するようにするには、[プルリク゚ストの自動修正](#auto-fix-pull-requests)を参照しおください。289完党なりォヌクスルヌPR 䜜成を含むに぀いおは [Review and iterate](/docs/ja/web-quickstart#review-and-iterate) を参照しおください。Claude が PR の CI 倱敗ずレビュヌコメントを自動的に監芖するようにするには、[プルリク゚ストの自動修正](#auto-fix-pull-requests)を参照しおください。

claude-directory.md +6 −6

Details

1451゚クスプロヌラヌは、あなたが䜜成および線集するファむルをカバヌしおいたす。いく぀かの関連ファむルは他の堎所にありたす。1451゚クスプロヌラヌは、あなたが䜜成および線集するファむルをカバヌしおいたす。いく぀かの関連ファむルは他の堎所にありたす。

1452 1452 

1453| ファむル | 堎所 | 目的 |1453| ファむル | 堎所 | 目的 |

1454| ----------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |1454| ----------------------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

1455| `managed-settings.json` | システムレベル、OS によっお異なる | ゚ンタヌプラむズが匷制する蚭定で、[限定的な䟋倖](/docs/ja/settings#security-keys-where-the-stricter-value-applies)を陀いおオヌバヌラむドできたせん。[ファむルの保存堎所](/docs/ja/managed-settings#deploy-a-managed-settings-file)ず [Claude Code が䜿甚する管理゜ヌス](/docs/ja/managed-settings#precedence-within-the-managed-tier)を参照しおください。 |1455| `managed-settings.json` | システムレベル、OS によっお異なる | ゚ンタヌプラむズが匷制する蚭定で、[限定的な䟋倖](/docs/ja/settings#security-keys-where-the-stricter-value-applies)を陀いおオヌバヌラむドできたせん。[ファむルの保存堎所](/docs/ja/managed-settings#deploy-a-managed-settings-file)ず [Claude Code が䜿甚する管理゜ヌス](/docs/ja/managed-settings#precedence-within-the-managed-tier)を参照しおください。 |

1456| `CLAUDE.local.md` | プロゞェクトルヌト | このプロゞェクトの個人的な蚭定で、CLAUDE.md ず䞀緒に読み蟌たれたす。手動で䜜成し、`.gitignore` に远加しおください。 |1456| `CLAUDE.local.md` | プロゞェクトルヌト | このプロゞェクトの個人的な蚭定で、CLAUDE.md ず䞀緒に読み蟌たれたす。手動で䜜成し、`.gitignore` に远加しおください。 |

1457| `AGENTS.md` | プロゞェクトルヌト、`.claude/`、たたは任意のディレクトリ | AI コヌディング゚ヌゞェント向けに䜜成するプロゞェクト指瀺。Claude Code は[それを読み蟌む](/docs/ja/memory#agents-md)こずができたす。これは独立しお、たたは `CLAUDE.md` ず䞀緒に読み蟌たれたす。 |1457| `AGENTS.md` | プロゞェクトルヌト、`.claude/`、たたは任意のディレクトリ | AI コヌディング゚ヌゞェント向けに䜜成するプロゞェクト指瀺。Claude Code は[それを読み蟌む](/docs/ja/memory#agents-md)こずができたす。これは独立しお、たたは `CLAUDE.md` ず䞀緒に読み蟌たれたす。 |

1458| むンストヌル枈みプラグむン | `~/.claude/plugins` | クロヌンされたマヌケットプレむス、むンストヌル枈みプラグむンバヌゞョン、`installed_plugins.json` むンストヌル蚘録、およびプラグむンごずのデヌタで、`claude plugin` コマンドで管理されたす。プラグむン[あなたの claude.ai アカりントから同期](/docs/ja/plugins-reference#synced-plugins)は `~/.claude/plugins/synced/` にダりンロヌドされたす。リンクモヌドでマヌケットプレむス [`command` ゜ヌス](/docs/ja/plugin-marketplaces#command-sources)からむンストヌルされたプラグむンの堎合、Claude Code はコピヌの代わりにここにリンクを保存し、プラグむンのファむルはコマンドが出力するディレクトリに留たりたす。`command` ゜ヌスには Claude Code v2.1.229 以降が必芁です。ロヌカルディレクトリマヌケットプレむスで盞察パスでリストされおいるプラグむンも、キャッシュコピヌではなく、゜ヌスディレクトリから[その堎で読み蟌たれたす](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)。[プラグむンキャッシング](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)を参照しお、孀立したバヌゞョンがどのようにクリヌンアップされるかを確認しおください。 |1458| むンストヌル枈みプラグむン | `~/.claude/plugins` | クロヌンされたマヌケットプレむス、むンストヌル枈みプラグむンバヌゞョン、`installed_plugins.json` むンストヌル蚘録、およびプラグむンごずのデヌタで、`claude plugin` コマンドで管理されたす。プラグむン[あなたの claude.ai アカりントから同期](/docs/ja/plugins/loading#synced-plugins)は `~/.claude/plugins/synced/` にダりンロヌドされたす。リンクモヌドでマヌケットプレむス [`command` ゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source)からむンストヌルされたプラグむンの堎合、Claude Code はコピヌの代わりにここにリンクを保存し、プラグむンのファむルはコマンドが出力するディレクトリに留たりたす。`command` ゜ヌスには Claude Code v2.1.229 以降が必芁です。ロヌカルディレクトリマヌケットプレむスで盞察パスでリストされおいるプラグむンも、キャッシュコピヌではなく、゜ヌスディレクトリから[その堎で読み蟌たれたす](/docs/ja/plugins/loading#find-plugins-on-disk)。[プラグむンキャッシング](/docs/ja/plugins/loading#find-plugins-on-disk)を参照しお、孀立したバヌゞョンがどのようにクリヌンアップされるかを確認しおください。 |

1459 1459 

1460`~/.claude` はたた、Claude Code があなたが䜜業する際に曞き蟌むデヌタも保持しおいたす。トランスクリプト、プロンプト履歎、ファむルスナップショット、キャッシュ、およびログです。䞋蚘の[アプリケヌションデヌタ](#application-data)を参照しおください。1460`~/.claude` はたた、Claude Code があなたが䜜業する際に曞き蟌むデヌタも保持しおいたす。トランスクリプト、プロンプト履歎、ファむルスナップショット、キャッシュ、およびログです。䞋蚘の[アプリケヌションデヌタ](#application-data)を参照しおください。

1461 1461 


1529| `output-styles/*.md` | `name`, `description`, `keep-coding-instructions`, `force-for-plugin` | [出力スタむルフロントマタヌ](/docs/ja/output-styles#frontmatter) |1529| `output-styles/*.md` | `name`, `description`, `keep-coding-instructions`, `force-for-plugin` | [出力スタむルフロントマタヌ](/docs/ja/output-styles#frontmatter) |

1530| `rules/*.md` | `paths` | [ルヌルフロントマタヌ](/docs/ja/memory#rules-frontmatter-reference) |1530| `rules/*.md` | `paths` | [ルヌルフロントマタヌ](/docs/ja/memory#rules-frontmatter-reference) |

1531 1531 

1532[プラグむン](/docs/ja/plugins-reference#plugin-agent-frontmatter)に含たれる゚ヌゞェントは、サブ゚ヌゞェントフィヌルドのサブセットに察応しおいたす。1532[プラグむン](/docs/ja/plugins/components#agents)に含たれる゚ヌゞェントは、サブ゚ヌゞェントフィヌルドのサブセットに察応しおいたす。

1533 1533 

1534<h2 id="troubleshoot-configuration">1534<h2 id="troubleshoot-configuration">

1535 蚭定をトラブルシュヌティングする1535 蚭定をトラブルシュヌティングする


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

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

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

1571| `skills/.trash/`、`plugins/.trash/` | claude.ai から同期された [Skills](/docs/ja/skills#how-synced-skills-behave) ず [plugins](/docs/ja/plugins-reference#synced-plugins)。Claude Code が削陀したもの。削陀する代わりにここに移動されるため、ファむルを埩元できたす |1571| `skills/.trash/`、`plugins/.trash/` | claude.ai から同期された [Skills](/docs/ja/skills#how-synced-skills-behave) ず [plugins](/docs/ja/plugins/loading#synced-plugins)。Claude Code が削陀したもの。削陀する代わりにここに移動されるため、ファむルを埩元できたす |

1572| `todos/`、`statsig/`、`logs/` | 叀いバヌゞョンのレガシヌディレクトリ。珟圚は曞き蟌たれおいたせん。スむヌプはその内容を削陀しおから空のディレクトリを削陀したす |1572| `todos/`、`statsig/`、`logs/` | 叀いバヌゞョンのレガシヌディレクトリ。珟圚は曞き蟌たれおいたせん。スむヌプはその内容を削陀しおから空のディレクトリを削陀したす |

1573 1573 

1574`sessions/` のセッションファむル、自動メモリ、Claude Desktop および Cowork トランスクリプトは、それぞれ独自の保持ルヌルに埓いたす1574`sessions/` のセッションファむル、自動メモリ、Claude Desktop および Cowork トランスクリプトは、それぞれ独自の保持ルヌルに埓いたす


1678[保持する状態ファむル](#state-files-to-keep) を陀いお、䞊蚘のアプリケヌションデヌタパスのいずれかを手動で削陀するこずもできたす。新しいセッションは圱響を受けたせん。以䞋の衚は、過去のセッションで倱うものを瀺しおいたす。1678[保持する状態ファむル](#state-files-to-keep) を陀いお、䞊蚘のアプリケヌションデヌタパスのいずれかを手動で削陀するこずもできたす。新しいセッションは圱響を受けたせん。以䞋の衚は、過去のセッションで倱うものを瀺しおいたす。

1679 1679 

1680| 削陀 | 倱うもの |1680| 削陀 | 倱うもの |

1681| ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |1681| ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |

1682| `~/.claude/projects/` | 過去のセッションの再開、続行、巻き戻し、およびすべおのプロゞェクトの自動メモリ |1682| `~/.claude/projects/` | 過去のセッションの再開、続行、巻き戻し、およびすべおのプロゞェクトの自動メモリ |

1683| `~/.claude/history.jsonl` | 䞊矢印プロンプトリコヌル、`Ctrl+R` 履歎怜玢、`!` シェルコマンド補完 |1683| `~/.claude/history.jsonl` | 䞊矢印プロンプトリコヌル、`Ctrl+R` 履歎怜玢、`!` シェルコマンド補完 |

1684| `~/.claude/paste-cache/` | リコヌルされたプロンプトの貌り付けたテキスト。[倧きなコンテンツを貌り付ける](/docs/ja/terminal-config#paste-large-content) を参照しおください |1684| `~/.claude/paste-cache/` | リコヌルされたプロンプトの貌り付けたテキスト。[倧きなコンテンツを貌り付ける](/docs/ja/terminal-config#paste-large-content) を参照しおください |


1692| `~/.claude/cache/changelog.md` | なし。バックグラりンドで曎新されたす |1692| `~/.claude/cache/changelog.md` | なし。バックグラりンドで曎新されたす |

1693| `~/.claude/policy-limits.json` | なし。自動的に曎新されたす |1693| `~/.claude/policy-limits.json` | なし。自動的に曎新されたす |

1694| `~/.claude/tasks/` | 再開されたセッションが取埗するタスクリスト |1694| `~/.claude/tasks/` | 再開されたセッションが取埗するタスクリスト |

1695| `~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/` | Claude Code が削陀した [同期されたスキル](/docs/ja/skills#how-synced-skills-behave) ず [同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins) を埩元する機䌚 |1695| `~/.claude/skills/.trash/`、`~/.claude/plugins/.trash/` | Claude Code が削陀した [同期されたスキル](/docs/ja/skills#how-synced-skills-behave) ず [同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins) を埩元する機䌚 |

1696| `~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/` | ナヌザヌ向けのなし |1696| `~/.claude/debug/`、`~/.claude/plans/`、`~/.claude/session-env/`、`~/.claude/shell-snapshots/`、`~/.claude/backups/` | ナヌザヌ向けのなし |

1697| `~/.claude/todos/`、`~/.claude/statsig/`、`~/.claude/logs/`、`~/.claude/image-cache/` | なし。珟圚のバヌゞョンで曞き蟌たれおいないレガシヌディレクトリ |1697| `~/.claude/todos/`、`~/.claude/statsig/`、`~/.claude/logs/`、`~/.claude/image-cache/` | なし。珟圚のバヌゞョンで曞き蟌たれおいないレガシヌディレクトリ |

1698 1698 

Details

242 242 

243Claude Code は起動時にこのコマンドを実行しお既存の AWS 認蚌情報を怜蚌できない堎合も実行し、ログむンが完了するたで `Authentication` パネルにコマンドの出力を衚瀺したす。243Claude Code は起動時にこのコマンドを実行しお既存の AWS 認蚌情報を怜蚌できない堎合も実行し、ログむンが完了するたで `Authentication` パネルにコマンドの出力を衚瀺したす。

244 244 

245`awsAuthRefresh` が蚭定されおいる堎合、`/login` を実行し、**3rd-party platform** を遞択しおから、**Using 3rd-party platforms** の䞋で **Claude Platform on AWS · refresh credentials** を遞択したす。Claude Code は蚭定されたコマンドを実行し、再起動せずに AWS 認蚌情報を再床読み蟌みたす。このオプションには Claude Code v2.1.186 以降が必芁です。245`awsAuthRefresh` が蚭定されおいる堎合、`/login` を実行し、**3rd-party platform** を遞択しおから、**Using 3rd-party platforms** の䞋で **Claude Platform on AWS · refresh credentials** を遞択したす。Claude Code は蚭定されたコマンドを実行し、再起動せずに AWS 認蚌情報を再床読み蟌みたす。

246 246 

247**オプション B: ワヌクスペヌス API キヌ**247**オプション B: ワヌクスペヌス API キヌ**

248 248 

claude-projects.md +102 −100

Details

10 Projects は Pro および Max プランで公開ベヌタ版であり、段階的にロヌルアりト䞭です。[クラりドセッション](/docs/ja/claude-code-on-the-web) を䜿甚したアカりントで、claude.ai チャットたたは Cowork に既存のプロゞェクトがないアカりントから始たり、段階的にロヌルアりト䞭です。Team たたは Enterprise プランではただ利甚できたせん。[claude.ai/code](https://claude.ai/code) のサむドバヌたたは [デスクトップアプリ](/docs/ja/desktop) の Code タブに **Projects** が衚瀺されない堎合、ロヌルアりトがただアカりントに到達しおいたせん。その堎合は [りェむトリストに参加](https://claude.com/form/projects) できたす。[゚ヌゞェントを䞊列実行する](/docs/ja/agents) で、その間に利甚可胜なオプションを確認しおください。10 Projects は Pro および Max プランで公開ベヌタ版であり、段階的にロヌルアりト䞭です。[クラりドセッション](/docs/ja/claude-code-on-the-web) を䜿甚したアカりントで、claude.ai チャットたたは Cowork に既存のプロゞェクトがないアカりントから始たり、段階的にロヌルアりト䞭です。Team たたは Enterprise プランではただ利甚できたせん。[claude.ai/code](https://claude.ai/code) のサむドバヌたたは [デスクトップアプリ](/docs/ja/desktop) の Code タブに **Projects** が衚瀺されない堎合、ロヌルアりトがただアカりントに到達しおいたせん。その堎合は [りェむトリストに参加](https://claude.com/form/projects) できたす。[゚ヌゞェントを䞊列実行する](/docs/ja/agents) で、その間に利甚可胜なオプションを確認しおください。

11</Note>11</Note>

12 12 

13プロゞェクトは、Claude が関連する䜜業のストリヌムを調敎する 1 ぀の進行䞭の䌚話です。実行する必芁があるこずを Claude に䌝えるず、各タスクのスレッドを開始したす。各スレッドは [クラりドセッション](/docs/ja/claude-code-on-the-web) です。Claude Code がマシンではなくクラりドで実行されたす。スレッドは䞊列実行され、ラップトップを閉じた埌も実行を続けたす。たた、スマヌトフォンからスレッドをチェックしお操舵するこずができたす。13プロゞェクトは、Claude が関連する䜜業のストリヌムを調敎する 1 ぀の進行䞭の䌚話です。実行する必芁があるこずを Claude に䌝えるず、各タスクのスレッドを開始したす。

14 

15各スレッドは通垞、[クラりドセッション](/docs/ja/claude-code-on-the-web) です。Claude Code がマシンではなくクラりドで実行されたす。タスクがコンピュヌタにしかないものが必芁な堎合は、Claude に [リモヌトコントロヌル](/docs/ja/remote-control) を通じおそのスレッドをコンピュヌタで実行するよう䟝頌できたす。スレッドは䞊列実行され、スマヌトフォンからスレッドをチェックしお操舵するこずができたす。クラりドスレッドはラップトップを閉じた埌も実行を続けたす。

14 16 

15プロゞェクトなしで耇数のセッションを実行する堎合、調敎は自分で行う必芁がありたす。各セッションが䜕に取り組むかを決定し、各セッションの開始時に同じバックグラりンド情報を繰り返し、どのセッションが完了したか、たたは回答が必芁かを確認したす。プロゞェクトを䜿甚するず、代わりに以䞋のこずができたす。17プロゞェクトなしで耇数のセッションを実行する堎合、調敎は自分で行う必芁がありたす。各セッションが䜕に取り組むかを決定し、各セッションの開始時に同じバックグラりンド情報を繰り返し、どのセッションが完了したか、たたは回答が必芁かを確認したす。プロゞェクトを䜿甚するず、代わりに以䞋のこずができたす。

16 18 

17* **䜜業を 1 ぀の堎所に送信する**: バグレポヌト、スタックトレヌス、たたはタスクのリストが発生するたびに䌚話に貌り付けたす。Claude は各䜜業のスレッドを開始するか、その領域で既に䜜業しおいるスレッドに枡し、その堎で簡単な質問に答えたす。19* **䜜業を 1 ぀の堎所に送信する**: バグレポヌト、スタックトレヌス、たたはタスクのリストが発生するたびに䌚話に貌り付けたす。Claude は各䜜業のスレッドを開始するか、その領域で既に䜜業しおいるスレッドに枡し、その堎で簡単な質問に答えたす。

18* **コンテキストを 1 回蚭定する**: すべおの新しいスレッドはプロゞェクトのリポゞトリ、指瀺、メモリで開始されるため、察象ブランチなどの 1 回述べたルヌルがすべおのスレッドに到達したす。20* **コンテキストを 1 回蚭定する**: すべおの新しいスレッドはプロゞェクトの指瀺で開始されるため、察象ブランチなどの 1 回述べたルヌルがすべおのスレッドに到達したす。

19* **立ち去っお完了した䜜業に戻る**: 1 時間埌たたは翌朝に戻るず、**Overview** ペむンに完了したスレッド、レビュヌ準備ができたプルリク゚スト、回答を埅っおいるスレッドが衚瀺されたす。21* **立ち去っお完了した䜜業に戻る**: 1 時間埌たたは翌朝に戻るず、**Overview** ペむンに完了したスレッド、レビュヌ準備ができたプルリク゚スト、回答を埅っおいるスレッドが衚瀺されたす。

20 22 

21プロゞェクトで実行する䜜業が既にわかっおいる堎合は、[プロゞェクトを䜜成する](#create-a-project) に盎接進んでください。23プロゞェクトで実行する䜜業が既にわかっおいる堎合は、[プロゞェクトを䜜成する](#create-a-project) に盎接進んでください。


37 別のものがより適切な堎合39 別のものがより適切な堎合

38</h3>40</h3>

39 41 

40スレッドは GitHub リポゞトリおよびプロゞェクトにアップロヌドしたファむル、フォルダ、Google Drive フォルダで機胜し、マシンにのみ存圚するファむルやツヌルでは機胜したせん。これらの堎合は別のものがより適切です。42Cloud スレッドは GitHub リポゞトリおよびプロゞェクトにアップロヌドしたファむル、フォルダ、Google Drive フォルダで機胜し、マシンにのみ存圚するファむルやツヌルでは機胜したせん。タスクがマシンを必芁ずする堎合は、[Remote Control](/docs/ja/remote-control) を通じおそのスレッドをそこで実行するよう Claude に䟝頌しおください。[制限事項](#limitations) にはそれに必芁なものが蚘茉されおいたす。これらの堎合は別のものがより適切です。

41 43 

42* **セッションに収たる 1 ぀のタスク**: 「䞍安定なログむンテストを修正する」。[クラりドセッション](/docs/ja/claude-code-on-the-web) を自分で開始したす。44* **セッションに収たる 1 ぀のタスク**: 「䞍安定なログむンテストを修正する」。[クラりドセッション](/docs/ja/claude-code-on-the-web) を自分で開始したす。

43* **マシンのみが到達できるツヌルたたはサヌビスが必芁な䜜業**: ロヌカルデヌタベヌス、デバむス゚ミュレヌタ、VPN の背埌にある API。ロヌカルセッションを䜿甚するか、[゚ヌゞェントビュヌ](/docs/ja/agent-view) を䜿甚しお耇数を同時に実行したす。䜜業がロヌカルファむルのみが必芁な堎合は、代わりにプロゞェクトにアップロヌドしおください。45* **すべおのタスクがマシンを必芁ずする䜜業**: ロヌカルデヌタベヌス、デバむス゚ミュレヌタ、たたは VPN の背埌にある API。ロヌカルセッションを䜿甚するか、[゚ヌゞェントビュヌ](/docs/ja/agent-view) を䜿甚しお耇数を同時に実行したす。䜜業がロヌカルファむルのみを必芁ずする堎合は、代わりにプロゞェクトにアップロヌドしおください。

44* **スケゞュヌルで繰り返される 1 ぀のタスク、その呚りに䌚話がない**: 「毎週月曜日に䟝存関係レポヌトを投皿する」。[ルヌチン](/docs/ja/routines) を単独で䜜成したす。46* **スケゞュヌルで繰り返される 1 ぀のタスク、その呚りに䌚話がない**: 「毎週月曜日に䟝存関係レポヌトを投皿する」。[ルヌチン](/docs/ja/routines) を単独で䜜成したす。

45* **耇数の人が Claude に䜜業を䞎え、Slack チャネルで䞀緒に操舵する**: [Claude Tag](https://claude.com/docs/claude-tag/overview) を参照しおください。47* **耇数の人が Claude に䜜業を䞎え、Slack チャネルで䞀緒に操舵する**: [Claude Tag](https://claude.com/docs/claude-tag/overview) を参照しおください。

46 48 


53プロゞェクトは Claude ずの 1 ぀の調敎䌚話ず、それが䜜業を行うために開始するスレッドです。これらはその郚分です。55プロゞェクトは Claude ずの 1 ぀の調敎䌚話ず、それが䜜業を行うために開始するスレッドです。これらはその郚分です。

54 56 

55* **プロゞェクト䌚話**: Claude がコヌディネヌタヌずしお機胜する 1 ぀の長時間実行セッション。送信したものを取埗し、䜕がスレッドになるかを決定し、開始したすべおのスレッドを远跡したす。スレッドが報告する内容を確認し、実行するすべおのステップは確認したせん。57* **プロゞェクト䌚話**: Claude がコヌディネヌタヌずしお機胜する 1 ぀の長時間実行セッション。送信したものを取埗し、䜕がスレッドになるかを決定し、開始したすべおのスレッドを远跡したす。スレッドが報告する内容を確認し、実行するすべおのステップは確認したせん。

56* **スレッド**: ワヌカヌ。各スレッドは独自のコンテキストりィンドりを持぀個別の [クラりドセッション](/docs/ja/claude-code-on-the-web) で、独自のブランチで 1 ぀の䜜業を実行し、䜜業が必芁な堎合はプルリク゚ストを開き、完了時に䌚話に報告したす。58* **スレッド**: ワヌカヌ。各スレッドは独自のコンテキストりィンドりを持぀個別のセッションで、1 ぀の䜜業を実行し、完了時に䌚話に報告したす。クラりドスレッドは独自のブランチで䜜業し、䜜業が必芁な堎合はプルリク゚ストを開きたす。

57* **すべおのスレッドが開始する内容**:59* **すべおのクラりドスレッドが開始する内容**:

58 * プロゞェクトのリポゞトリずファむル、およびその [指瀺ずメモリ](#give-a-project-standing-context)60 * プロゞェクトのリポゞトリずファむル、およびその [指瀺ずメモリ](#give-a-project-standing-context)

59 * `CLAUDE.md` ずスキル、および [プロゞェクトの各リポゞトリ](#what-threads-pick-up-from-your-repositories) のプラグむン、および 1 ぀のリポゞトリを持぀プロゞェクトでは、そのリポゞトリの暩限ルヌルずフックも61 * `CLAUDE.md` ずスキル、および [プロゞェクトの各リポゞトリ](#what-threads-pick-up-from-your-repositories) のスキル、および 1 ぀のリポゞトリを持぀プロゞェクトでは、そのリポゞトリの暩限ルヌルず hooks も

60 * [コネクタ](#get-skills-plugins-connectors-and-tools-into-threads) を claude.ai アカりントに62 * [コネクタ](#get-skills-plugins-connectors-and-tools-into-threads) を claude.ai アカりントに

61 * ネットワヌクアクセス、環境倉数、API 認蚌情報、むンストヌル枈みツヌルを蚭定する [クラりド環境](#choose-an-environment-for-threads)63 * ネットワヌクアクセス、環境倉数、API 認蚌情報、むンストヌル枈みツヌルを蚭定する [クラりド環境](#choose-an-environment-for-threads)

62* **Overview ペむン**: [すべおのスレッドを䞀床に確認](#see-what-needs-you-in-overview) でき、どのスレッドが必芁かを確認できる堎所。その他のタブは、远加したファむルずスレッドが生成したファむルの **Library**、スレッドが開いたプルリク゚ストの **Pull requests**、プロゞェクトのスケゞュヌル䜜業の **Routines** です。64* **Overview ペむン**: [すべおのスレッドを䞀床に確認](#see-what-needs-you-in-overview) でき、どのスレッドが必芁かを確認できる堎所。その他のタブは、远加したファむルずスレッドが生成したファむルの **Library**、スレッドが開いたプルリク゚ストの **Pull requests**、プロゞェクトのスケゞュヌル䜜業の **Routines** です。

63 65 

64スレッドは、独自のマシンの Claude Code セットアップから䜕も取埗したせん。[スキル、プラグむン、コネクタ、ツヌルをスレッドに取埗する](#get-skills-plugins-connectors-and-tools-into-threads) は、それらが䞍足しおいるものを提䟛する方法をカバヌしおいたす。66クラりドスレッドは、独自のマシンの Claude Code セットアップから䜕も取埗したせん。[スキル、プラグむン、コネクタ、ツヌルをスレッドに取埗する](#get-skills-plugins-connectors-and-tools-into-threads) は、それらが䞍足しおいるものを提䟛する方法をカバヌしおいたす。

65 67 

66これは、䌚話を通じおスレッドが䜜業を行う方法ず、**Overview** がその状態を远跡する方法です。68これは、䌚話を通じおスレッドが䜜業を行う方法ず、**Overview** がその状態を远跡する方法です。

67 69 

68<Frame>70<Frame>

69 <img src="https://mintcdn.com/claude-code/e8CLbxM17eD7cAiv/images/claude-projects-overview.svg?fit=max&auto=format&n=e8CLbxM17eD7cAiv&q=85&s=dbf446f69f0bbdb9961d21af207cb93b" className="dark:hidden" alt="プロゞェクトの図。プロゞェクト䌚話に曞き蟌み、Claude が回答するか、スレッドを開始したす。各スレッドは独自のブランチずプルリク゚ストで䜜業するクラりドセッションです。Overview ペむンはスレッドを状態別にリストしたす。䟋えば、レビュヌ準備完了、あなたを埅機䞭、䜜業䞭など。" width="600" height="250" data-path="images/claude-projects-overview.svg" />71 <img src="https://mintcdn.com/claude-code/e8CLbxM17eD7cAiv/images/claude-projects-overview.svg?fit=max&auto=format&n=e8CLbxM17eD7cAiv&q=85&s=dbf446f69f0bbdb9961d21af207cb93b" className="dark:hidden" alt="プロゞェクトの図。プロゞェクト䌚話に曞き蟌み、Claude が回答するか、スレッドを開始したす。各クラりドスレッドは独自のブランチずプルリク゚ストで䜜業したす。Overview ペむンはスレッドを状態別にリストしたす。䟋えば、レビュヌ準備完了、あなたを埅機䞭、䜜業䞭など。" width="600" height="250" data-path="images/claude-projects-overview.svg" />

70 72 

71 <img src="https://mintcdn.com/claude-code/e8CLbxM17eD7cAiv/images/claude-projects-overview-dark.svg?fit=max&auto=format&n=e8CLbxM17eD7cAiv&q=85&s=549a5ba9fea8433729babc37a1f6e9c8" className="hidden dark:block" alt="プロゞェクトの図。プロゞェクト䌚話に曞き蟌み、Claude が回答するか、スレッドを開始したす。各スレッドは独自のブランチずプルリク゚ストで䜜業するクラりドセッションです。Overview ペむンはスレッドを状態別にリストしたす。䟋えば、レビュヌ準備完了、あなたを埅機䞭、䜜業䞭など。" width="600" height="250" data-path="images/claude-projects-overview-dark.svg" />73 <img src="https://mintcdn.com/claude-code/e8CLbxM17eD7cAiv/images/claude-projects-overview-dark.svg?fit=max&auto=format&n=e8CLbxM17eD7cAiv&q=85&s=549a5ba9fea8433729babc37a1f6e9c8" className="hidden dark:block" alt="プロゞェクトの図。プロゞェクト䌚話に曞き蟌み、Claude が回答するか、スレッドを開始したす。各クラりドスレッドは独自のブランチずプルリク゚ストで䜜業したす。Overview ペむンはスレッドを状態別にリストしたす。䟋えば、レビュヌ準備完了、あなたを埅機䞭、䜜業䞭など。" width="600" height="250" data-path="images/claude-projects-overview-dark.svg" />

72</Frame>74</Frame>

73 75 

74<h2 id="create-a-project">76<h2 id="create-a-project">


160 プロゞェクトで䜜業する162 プロゞェクトで䜜業する

161</h2>163</h2>

162 164 

163プロゞェクト䌚話を通じお Claude に䜜業を提䟛したす。タスクを 1 ぀ず぀たたは耇数同時に、および曎新ず発生時の緩い考え。Claude は各メッセヌゞをルヌティングし、スレッドが䜜業を行い、報告したす。165プロゞェクト䌚話を通じお Claude に䜜業を䞎えたす。䞀床に 1 ぀のタスク、たたは耇数のタスクを同時に、さらに曎新や思い぀いたこずを送信したす。Claude は各メッセヌゞをルヌティングし、スレッドが䜜業を実行しお報告したす。

164 166 

165<h3 id="your-first-batch">167<h3 id="your-first-batch">

166 最初のバッチ168 最初のバッチ

167</h3>169</h3>

168 170 

169新しいプロゞェクトに䜜業のバッチを送信する前に、最初のスレッドが垌望する方法で戻っおくるようにセットアップしたす。171プロゞェクトに新しい䜜業バッチを送信する前に、最初のスレッドが垌望する方法で戻っおくるようにセットアップしたす。

170 172 

1711. [プロゞェクト指瀺を曞く](#write-project-instructions): 察象ブランチ、スレッドが䜜業をチェックする方法、䜕があなたの承認が必芁かなど、すべおのスレッドが開始する簡朔な指瀺。1731. [プロゞェクト指瀺を曞く](#write-project-instructions)すべおのスレッドが開始する簡朔な指瀺。察象ずするブランチ、スレッドが䜜業をチェックする方法、あなたの承認が必芁なものなどが含たれたす。

1722. 実際の䜜業の小さな郚分を 1 ぀送信するか、Claude が提案したスレッドの 1 ぀を開始し、完了時にスレッドを開いお、どのように報告し、ブランチで䜕をしたかを確認したす。間違った仮定をしたか、必芁なものに到達できなかった堎合、[スレッドが掚枬たたは停止した代わりに尋ねる](#threads-guessed-or-stalled-instead-of-asking) はそれを修正する堎所をカバヌしおいたす。1742. 実際の䜜業の小さな郚分を 1 ぀送信するか、Claude が提案したスレッドの 1 ぀を開始し、スレッドが完了したずきにスレッドを開いお、どのように報告し、ブランチで䜕を実行したかを確認したす。間違った仮定をしたか、必芁なものに到達できなかった堎合は、[スレッドが尋ねる代わりに掚枬たたは停止した](#threads-guessed-or-stalled-instead-of-asking)で修正する堎所をカバヌしおいたす。

1733. **Project settings > General** で **Thread model** ず **Thread effort** を確認しおください。新しいプロゞェクトはすべおのスレッドを Opus で高い努力で実行し、プランを最速で䜿甚したす。[モデルを遞択し、Claude にコンテキストを管理させる](#choose-models-and-let-claude-manage-context) は代替案をカバヌしおいたす。1753. **プロゞェクト蚭定 > 䞀般**で**スレッドモデル**ず**スレッド努力**を確認したす。新しいプロゞェクトはすべおのスレッドを Opus で高努力で実行したす。これはあなたのプランを最も速く消費したす。[モデルを遞択しお Claude にコンテキストを管理させる](#choose-models-and-let-claude-manage-context)は代替案をカバヌしおいたす。

1744. Claude に [スレッドを開始する前に提案し、䞀床に数個実行するよう求め](#tune-how-claude-runs-a-project)、数個のスレッドが垌望する方法で戻っおきたら、これらの制限を削陀したす。1764. Claude に[スレッドを開始する前に提案し、䞀床に数個実行する](#tune-how-claude-runs-a-project)こずを求め、数個のスレッドが垌望する方法で戻っおきたら、それらの制限を削陀したす。

175 177 

176<h3 id="send-work-and-read-results">178<h3 id="send-work-and-read-results">

177 䜜業を送信し、結果を読む179 䜜業を送信しお結果を読む

178</h3>180</h3>

179 181 

180Claude は䌚話で送信する各メッセヌゞがどこに行くかを決定したす。182Claude は䌚話で送信する各メッセヌゞがどこに行くかを決定したす。

181 183 

182* 簡単な質問は通垞、䌚話で回答を取埗したす。184* 簡単な質問は通垞、䌚話で答えが埗られたす。

183* 新しい䜜業は新しいスレッドたたは既にその領域で䜜業しおいるスレッドに移動し、Claude はどちらかを䌝えたす。各新しいスレッドはメッセヌゞの䞋にカヌドずしお衚瀺されたす。スレッドのタむトルず状態を含むボックスで、クリックしおスレッドを開きたす。185* 新しい䜜業は新しいスレッドたたはその領域で既に䜜業しおいるスレッドに送られ、Claude はどちらかを教えおくれたす。新しい各スレッドはあなたのメッセヌゞの䞋にカヌドずしお衚瀺されたす。スレッドのタむトルずステヌタスを含むボックスで、クリックしおスレッドを開きたす。

184* 1 ぀のメッセヌゞ内の耇数の関連のないタスクは個別のスレッドになりたす。186* 1 ぀のメッセヌゞ内の耇数の関連のないタスクは、別々のスレッドになりたす。

185 187 

186Claude がメッセヌゞを垌望ず異なるようにルヌティングする堎合は、そう蚀っおください。[Claude がプロゞェクトを実行する方法を調敎する](#tune-how-claude-runs-a-project) は、既存のスレッドをフォロヌアップに再利甚するか、代わりに回答するなど、䌝えるこずができるこずをリストしたす。188Claude がメッセヌゞを垌望ず異なる方法でルヌティングした堎合は、そう蚀っおください。[Claude がプロゞェクトを実行する方法を調敎する](#tune-how-claude-runs-a-project)は、既存のスレッドをフォロヌアップに再利甚するか、代わりにその堎で回答するなど、Claude に䌝えるこずができるこずをリストしおいたす。

187 189 

188スレッドの完党な結果はスレッドに留たり、䌚話でそのカヌドを開いお読みたす。スレッドが生成したファむルは **Overview** の **Library** タブにもありたす。190スレッドの完党な結果はスレッドに留たり、䌚話でそのカヌドを開いお読みたす。スレッドが生成したファむルは、**抂芁**の**ラむブラリ**タブにもありたす。

189 191 

190時々 Claude はスレッドを開始する代わりにスレッドを提案し、**Suggested threads** リストに衚瀺されたす。提案の矢印をクリックしおそのスレッドを開始したす。耇数がリストされおいる堎合、リストの䞋のボタンはすべおを開始したす。192時々 Claude はスレッドを開始する代わりに提案し、**提案されたスレッド**リストに衚瀺されたす。提案の矢印をクリックしおそのスレッドを開始したす。耇数がリストされおいる堎合、リストの䞋のボタンはすべおを開始したす。

191 193 

192<h3 id="review-a-thread’s-pull-request">194<h3 id="review-a-thread’s-pull-request">

193 スレッドのプルリク゚ストをレビュヌする195 スレッドのプルリク゚ストをレビュヌする

194</h3>196</h3>

195 197 

196スレッドがコヌドを倉曎する堎合、別の指瀺がない限り、これが行うこずです。198クラりドスレッドがコヌドを倉曎する堎合、別途指瀺しない限り、これが実行されたす。

197 199 

198* **Branch**: リポゞトリのデフォルトブランチから開始された新しいブランチで機胜したす。200* **ブランチ**リポゞトリのデフォルトブランチから開始された新しいブランチで䜜業したす。

199* **Pull request**: 芁求時に開き、バグ修正たたは別の具䜓的な倉曎のために独自に開くこずができたす。201* **プルリク゚スト**あなたが芁求したずきに開き、バグ修正たたは別の具䜓的な倉曎のために自動的に開くこずができたす。

200* **開いた埌**: 他のクラりドセッションで自動修正がオンかどうかに関わらず、[自動修正](/docs/ja/claude-code-on-the-web#auto-fix-pull-requests) をオンにしおプルリク゚ストを監芖したす。CI が倱敗するず修正をプッシュし、レビュヌコメントに察応し、チェックが成功し、プルリク゚ストがレビュヌ準備ができたずきにスレッドで返信したす。202* **開いた埌**[自動修正](/docs/ja/claude-code-on-the-web#auto-fix-pull-requests)をオンにしおプルリク゚ストを監芖したす。他のクラりドセッションで自動修正がオンかどうかに関わらず。CI が倱敗したずきに修正をプッシュし、レビュヌコメントに察凊し、チェックが成功しおプルリク゚ストがあなたの準備ができたずきにスレッドで返信したす。

201 203 

202䌚話のスレッドのカヌドは、次のステップのボタンを衚瀺できたす。204スレッドがブランチをプッシュしたか、プルリク゚ストを開いた堎合、䌚話でそのカヌドは次のステップのボタンを衚瀺できたす。

203 205 

204* **Resolve conflicts**、**Fix CI**、**Address comments**、および **Merge it** はその指瀺をスレッドにメッセヌゞずしお送信し、プルリク゚ストに反応するのを埅぀代わりにスレッドを自分でプロンプトできたす。206* **競合を解決**、**CI を修正**、**コメントに察凊**、および**マヌゞする**は、その指瀺をあなたからのメッセヌゞずしおスレッドに送信したす。プルリク゚ストに反応するのを埅぀代わりに、スレッド自䜓にプロンプトを出すこずができたす。

205* **Review PR** は GitHub でプルリク゚ストを開きたす。207* **PR をレビュヌ**は GitHub でプルリク゚ストを開きたす。

206* **Create PR** はアむドル状態のスレッドがブランチをプッシュしたがプルリク゚ストを開いおいない堎合に衚瀺されたす。クリックするずスレッドにプルリク゚ストを開くよう指瀺を送信する代わりに、そのブランチから盎接プルリク゚ストを䜜成したす。208* **PR を䜜成**は、アむドル状態のスレッドがブランチをプッシュしたが、プルリク゚ストを開いおいない堎合に衚瀺されたす。クリックするず、スレッドに開くように指瀺を送信するのではなく、そのブランチから盎接プルリク゚ストを䜜成したす。

207 209 

208スレッドがプルリク゚ストを開く堎合、䟋えば芁求時のみ、たたはどのブランチから開始するかを倉曎するには、タスクたたは [プロゞェクト指瀺](#write-project-instructions) で蚀っおください。210スレッドがプルリク゚ストを開く時期を倉曎するには、たずえば芁求したずきのみ、たたはどのブランチから開始するかを倉曎するには、タスクたたは[プロゞェクト指瀺](#write-project-instructions)で蚀っおください。

209 211 

210<h3 id="see-what-needs-you-in-overview">212<h3 id="see-what-needs-you-in-overview">

211 Overview であなたが必芁なものを確認する213 抂芁で必芁なものを確認する

212</h3>214</h3>

213 215 

214䌚話の暪の **Overview** ペむンはプロゞェクトのスレッドを远跡したす。新しいプロゞェクトを最初に開くずきは既に開いおいたす。プロゞェクトヘッダヌの **Overview** ボタンはそれを閉じお再床開き、スレッドがあなたを埅機䞭の堎合はドットを衚瀺したす。216䌚話の暪の**抂芁**ペむンは、プロゞェクトのスレッドを远跡したす。新しいプロゞェクトを初めお開いたずきは既に開いおいたす。プロゞェクトヘッダヌの**抂芁**ボタンはそれを閉じお再床開き、スレッドがあなたを埅っおいるずきにドットを衚瀺したす。

215 217 

216デスクトップアプリでは、Claude が䌚話に投皿するずき、スレッドが゚ラヌに圓たるずき、たたはスレッドが入力を必芁ずするずきにデスクトップ通知も取埗するため、プロゞェクトを開いたたたにしおそれを芋぀ける必芁はありたせん。スレッドが完了するたびに 1 ぀を取埗するか、プロゞェクトのためにそれらをオフにするには、プロゞェクトのサむドバヌメニュヌで **Notifications** を遞択したす。これらの通知はデスクトップのみです。ブラりザでは、**Overview** ボタンのドットを確認しおください。218デスクトップアプリでは、Claude が䌚話に投皿したずき、スレッドが゚ラヌに達したずき、たたはスレッドがあなたの入力を必芁ずするずきにデスクトップ通知も取埗したす。プロゞェクトを開いたたたにしおおく必芁はありたせん。スレッドが各タヌンを完了するたびに 1 ぀取埗するか、プロゞェクトの通知をオフにするには、プロゞェクトのサむドバヌメニュヌで**通知**を遞択したす。これらの通知はデスクトップのみです。ブラりザでは、**抂芁**ボタンのドットを確認しおください。

217 219 

218ペむンの **Threads** タブはスレッドを状態別にグルヌプ化したす。220ペむンの**スレッド**タブはスレッドを状態でグルヌプ化したす。

219 221 

220| グルヌプ | 含たれるもの |222| グルヌプ | 含たれるもの |

221| :------------------- | :-------------------------------------------------------------------------------------------------------------------- |223| :----------- | :---------------------------------------------------------------------------------------------------------------- |

222| **Ready for review** | プルリク゚ストが開いおおり、レビュヌ埅機䞭のスレッド |224| **レビュヌ準備完了** | プルリク゚ストが開いおおり、レビュヌを埅っおいるスレッド |

223| **Waiting on you** | 返信たたは承認が必芁、たたは倱敗したスレッド |225| **あなたを埅機䞭** | あなたの返信たたは承認が必芁、たたは倱敗したスレッド |

224| **Working** | ただ実行䞭のスレッド |226| **䜜業䞭** | ただ実行䞭のスレッド |

225| **Landing** | プルリク゚ストが承認されおいるか、マヌゞキュヌに入っおいるスレッド |227| **ランディング** | プルリク゚ストが承認されたか、マヌゞキュヌに入っおいるスレッド |

226| **Idle** | 完了し、䜕も埅機しおいないスレッド |228| **アむドル** | 完了し、䜕も埅っおいないスレッド |

227| **Resolved** | 完了ずマヌクされたスレッド: スレッドのメニュヌから、プルリク゚ストのマヌゞなど最埌のステップを実行した埌に Claude によっお、たたは 1 週間アクティビティがない堎合は自動的に。同じメニュヌから 1 ぀を再床開くこずができたす |229| **解決枈み** | 完了ずしおマヌクされたスレッド。スレッドのメニュヌからあなたが、プルリク゚ストのマヌゞなど最埌のステップを実行した埌に Claude が、たたは掻動がない 1 週間埌に自動的に。同じメニュヌから 1 ぀を再床開くこずができたす |

228 230 

229ペむンの他のタブは、远加したファむルずフォルダおよびスレッドが生成したファむルの **Library**、スレッドが開いたプルリク゚ストの **Pull requests**、このプロゞェクトの [ルヌチン](/docs/ja/routines) の **Routines** です。231ペむンの他のタブは、远加したファむルずフォルダ、およびスレッドが生成したファむルの**ラむブラリ**、スレッドが開いたら**プルリク゚スト**、およびこのプロゞェクトから Claude が蚭定した[ルヌチン](/docs/ja/routines)の**ルヌチン**です。

230 232 

231<h3 id="open-a-thread-when-you-need-control">233<h3 id="open-a-thread-when-you-need-control">

232 コントロヌルが必芁な堎合はスレッドを開く234 コントロヌルが必芁なずきにスレッドを開く

233</h3>235</h3>

234 236 

235䌚話のスレッドのカヌドたたは **Overview** の行をクリックしお、Overview ペむンでそのトランスクリプトを開きたす。そこから以䞋ができたす。237䌚話でスレッドのカヌドをクリックするか、**抂芁**でその行をクリックしお、抂芁ペむンでそのトランスクリプトを開きたす。そこから以䞋を実行できたす。

236 238 

237* Claude が䜕をしたかをステップバむステップで読みたす。239* Claude が䜕をしたかをステップバむステップで読みたす。

238* スレッド独自のメッセヌゞボックスに曞き蟌んでタスクを操舵したす。そこのメッセヌゞはそのスレッドに盎接移動し、䌚話のフォロヌアップはそのスレッドに Claude がフォロヌアップを䞀臎させるずきのみ到達したす。240* スレッド独自のメッセヌゞボックスに曞き蟌んでタスクを操舵したす。そこのメッセヌゞはそのスレッドに盎接送られ、プロゞェクト䌚話でのフォロヌアップは Claude がフォロヌアップをそのスレッドず䞀臎させるずきにのみそれに到達したす。

239* スレッドが埅機しおいる暩限プロンプトに答えたす。241* スレッドが埅機しおいる暩限プロンプトに答えたす。

240* **Stop** でスレッドを䞭断したす。これはスレッドが機胜しおいる間、送信ボタンを眮き換えるか、Esc を抌したす。242* **停止**でスレッドを䞭断したす。これはスレッドが䜜業䞭に送信ボタンを眮き換えるか、Esc を抌したす。

241 243 

242<h3 id="choose-models-and-let-claude-manage-context">244<h3 id="choose-models-and-let-claude-manage-context">

243 モデルを遞択し、Claude にコンテキストを管理させる245 モデルを遞択しお Claude にコンテキストを管理させる

244</h3>246</h3>

245 247 

246**Project settings > General** でモデルず努力を蚭定したす。新しいプロゞェクトはすべおの堎所で Opus を実行し、スレッドの高い [努力](/docs/ja/model-config#adjust-effort-level) ず䌚話の䜎い努力がありたす。248**プロゞェクト蚭定 > 䞀般**でモデルず努力を蚭定したす。新しいプロゞェクトはすべおの堎所で Opus を実行し、スレッドの高[努力](/docs/ja/model-config#adjust-effort-level)ず䌚話の䜎努力を実行したす。

247 249 

248* **Thread model** ず **Thread effort** はスレッドに適甚されたす。1 ぀のタスクに異なるモデルを䜿甚するには、タスクで芁求しおください。既に実行䞭のスレッドの堎合、そのスレッドのモデルピッカヌを䜿甚しおください。250* **スレッドモデル**ず**スレッド努力**はスレッドに適甚されたす。1 ぀のタスクに別のモデルを䜿甚するには、タスクで芁求したす。既に実行䞭のスレッドの堎合は、そのスレッドのモデルピッカヌを䜿甚したす。

249* **Coordinator model** ず **Coordinator effort** はプロゞェクト䌚話の Claude に適甚されたす。251* **コヌディネヌタヌモデル**ず**コヌディネヌタヌ努力**は、プロゞェクト䌚話で Claude に適甚されたす。

250 252 

251プロゞェクトではコンテキストりィンドりを管理したせん。スレッドは自動的にコンパクトになり、䌚話は完党な履歎ではなく最近のメッセヌゞ、最近のスレッド、プロゞェクトメモリから機胜するため、プロゞェクトが実行される限り続きたす。決しお削陀されおはいけないものを [プロゞェクトメモリ](#give-a-project-standing-context) に入れおください。1 ぀のスレッドがコンテキストを超える堎合、[Claude がこのタヌンでコンテキストを䜿い果たした](#context-limit) ず衚瀺されたす。253プロゞェクトではコンテキストりィンドりを管理したせん。スレッドは自動的にコンパクトになり、䌚話は最近のメッセヌゞ、最近のスレッド、およびプロゞェクトメモリから機胜し、完党な履歎ではなく、プロゞェクトが実行される限り続きたす。[プロゞェクトメモリ](#give-a-project-standing-context)に決しお削陀されおはいけないものを入れおください。1 ぀のスレッドがそのコンテキストを超える堎合、[Claude はこのタヌンでコンテキストを䜿い果たしたした](#context-limit)が衚瀺されたす。

252 254 

253<h3 id="tune-how-claude-runs-a-project">255<h3 id="tune-how-claude-runs-a-project">

254 Claude がプロゞェクトを実行する方法を調敎する256 Claude がプロゞェクトを実行する方法を調敎する

255</h3>257</h3>

256 258 

257䌚話で Claude に、䞀床に実行するスレッド数、曎新を投皿する時期、プルリク゚ストを開く時期を䌝えたす。Claude が垌望しない方法で調敎しおいる堎合は、そう蚀っおください。䟋えば、以䞋のように蚀うこずができたす。259䌚話で Claude に、䞀床に実行するスレッド数、曎新を投皿するタむミング、プルリク゚ストを開くタむミングを䌝えたす。Claude がコヌディネヌトしおいる方法が垌望ず異なる堎合は、そう蚀っおください。たずえば、以䞋のように蚀うこずができたす。

258 260 

259* 「スレッドを提案し、開始する前に承認を埅぀」たたは「確認なしで今すぐこれらを開始する」261* 「スレッドを提案し、開始する前に私の承認を埅っおください」たたは「これらを今すぐ開始しおください。確認を求めないでください」

260* 「䞀床に最倧 2 ぀のスレッドを実行する」たたは「同じ領域のフォロヌアップに既存のスレッドを再利甚する」262* 「䞀床に最倧 2 ぀のスレッドを実行しおください」たたは「同じ領域でのフォロヌアップに既存のスレッドを再利甚しおください」

261* 「より短い曎新を投皿する」たたは「䜕かが完了たたはブロックされたずきのみ投皿する」263* 「より短い曎新を投皿しおください」たたは「䜕かが完了たたはブロックされたずきのみ投皿しおください」

262* 「すべおのスレッドのステヌタス曎新をください」264* 「すべおのスレッドのステヌタス曎新をください」

263* 「このタスクをより小さいモデルで実行する」265* 「このタスクをより小さいモデルで実行しおください」

264* 「蚈画を芋るたでプルリク゚ストを開かない」266* 「蚈画を芋るたでプルリク゚ストを開かないでください」

265* 「これらのリポゞトリで䜕が間違っおいるかを教えおください、ただ䜕も修正しないでください」。スレッドになる前に調査結果を確認したい堎合267* 「これらのリポゞトリで䜕が間違っおいるかを教えおください。ただ䜕も修正しないでください」。スレッドになる前に調査結果を確認したい堎合

266* 「代わりにここで答えおください」。Claude が簡単な質問のためにスレッドを開始する堎合268* 「代わりにここで答えおください」。Claude が簡単な質問ずしお意図したものに察しおスレッドを開始する堎合

267 269 

268Claude はこれらのような蚭定を [プロゞェクトメモリ](#give-a-project-standing-context) に自動的に保存し、埌のスレッドで埓いたす。これらは Claude が守る指瀺であり、匷制蚭定ではないため、この方法で䞎えるスレッド制限はハヌドキャップではありたせん。最初からすべおのスレッドに適甚され、正確に文蚀されたい堎合は、プロゞェクト指瀺に 1 ぀を远加しおください。270Claude はこのような蚭定を[プロゞェクトメモリ](#give-a-project-standing-context)に自動的に保存し、埌のスレッドでそれに埓いたす。これらは Claude が守る指瀺であり、匷制される蚭定ではないため、この方法で䞎えるスレッド制限はハヌドキャップではありたせん。最初からすべおのスレッドに正確に適甚したい堎合は、プロゞェクト指瀺に 1 ぀を远加したす。

269 271 

270<h3 id="unblock-a-thread-waiting-on-approval">272<h3 id="unblock-a-thread-waiting-on-approval">

271 承認を埅機しおいるスレッドをブロック解陀する273 承認を埅機しおいるスレッドのブロックを解陀する

272</h3>274</h3>

273 275 

274スレッドはスレッドのモデルがサポヌトする堎合、[自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) で実行されるため、ほずんどのツヌル呌び出しは質問なしで実行されたす。スレッドが承認を必芁ずする堎合、プロンプトはそのスレッド内にあり、スレッドはそこで答えるたで埅機したす。プロゞェクト䌚話で Claude に先に進むよう䌝えるこずはそれに到達したせん。276スレッドはスレッドのモデルがサポヌトしおいる堎合、[自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で実行されるため、ほずんどのツヌル呌び出しはあなたに尋ねずに実行されたす。スレッドがあなたの承認を必芁ずする堎合、プロンプトはそのスレッド内にあり、スレッドはあなたがそこで答えるたで埅機したす。プロゞェクト䌚話で Claude に先に進むように䌝えるこずはそれに到達したせん。

275 277 

276各承認はそのプロンプト、たたはより広いオプションを遞択する堎合はそのスレッドの残りをカバヌしたす。すべおのスレッドが特定のコマンドを質問なしで実行できるようにするか、いく぀かをブロックするには、リポゞトリの `.claude/settings.json` に [暩限ルヌル](/docs/ja/permissions) を远加しおください。スレッドは 1 ぀のリポゞトリを持぀プロゞェクトでのみそれらを適甚したす。[スレッドがリポゞトリから取埗するもの](#what-threads-pick-up-from-your-repositories) を参照しおください。278各承認はそのプロンプト、たたはより広いオプションを遞択した堎合はそのスレッドの残りをカバヌしたす。すべおのスレッドが特定のコマンドを尋ねずに実行できるようにするか、いく぀かをブロックするには、リポゞトリの`.claude/settings.json`に[暩限ルヌル](/docs/ja/permissions)を远加したす。クラりドスレッドはそれらを 1 ぀のリポゞトリを持぀プロゞェクトでのみ適甚したす。[スレッドがリポゞトリから䜕を取埗するか](#what-threads-pick-up-from-your-repositories)を参照しおください。

277 279 

278<h2 id="give-a-project-standing-context">280<h2 id="give-a-project-standing-context">

279 プロゞェクトに垞時コンテキストを付䞎する281 プロゞェクトに垞時コンテキストを付䞎する


282プロゞェクトメモリ、プロゞェクト指瀺、およびプロゞェクトのリポゞトリ、ファむル、環境は、スレッド党䜓でコンテキストを保持したす。各項目を 1 回蚭定するず、すべおの新しいスレッドに適甚されたす。284プロゞェクトメモリ、プロゞェクト指瀺、およびプロゞェクトのリポゞトリ、ファむル、環境は、スレッド党䜓でコンテキストを保持したす。各項目を 1 回蚭定するず、すべおの新しいスレッドに適甚されたす。

283 285 

284| コンテキスト | 保持される内容 | 蚭定方法 |286| コンテキスト | 保持される内容 | 蚭定方法 |

285| :------------ | :-------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------- |287| :------------ | :------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------- |

286| プロゞェクトメモリ | Claude がプロゞェクトに぀いお保持するメモ芁件、決定、萜ずし穎などをファむルずしお保存したす。すべおのスレッドは開始時にむンデックスファむル `MEMORY.md` を読み蟌み、必芁に応じお他のファむルを開きたす | プロゞェクト䌚話たたはスレッド内で Claude に芁件、決定、萜ずし穎を蚘憶するよう䟝頌するか、忘れるよう䟝頌したす。**プロゞェクト蚭定 > メモリ** でファむルを読み蟌み、線集、削陀したす |288| プロゞェクトメモリ | Claude がプロゞェクトに぀いお保持するメモ芁件、決定、萜ずし穎などをファむルずしお保存したす。すべおのクラりドスレッドは開始時にむンデックスファむル `MEMORY.md` を読み蟌み、必芁に応じお他のファむルを開きたす | プロゞェクト䌚話たたはクラりドスレッド内で Claude に芁件、決定、萜ずし穎を蚘憶するよう䟝頌するか、忘れるよう䟝頌したす。**プロゞェクト蚭定 > メモリ** でファむルを読み蟌み、線集、削陀したす |

287| プロゞェクト指瀺 | 各新しいスレッドおよびプロゞェクト䌚話内の Claude に送信されるテキスト最倧 16,000 文字。[プロゞェクト指瀺を曞く](#write-project-instructions) に蚘茉内容を説明しおいたす | **プロゞェクト蚭定 > メモリ > プロゞェクト指瀺**、たたは䌚話内で Claude に指瀺の倉曎を䟝頌したす |289| プロゞェクト指瀺 | 各新しいスレッドおよびプロゞェクト䌚話内の Claude に送信されるテキスト最倧 16,000 文字。[プロゞェクト指瀺を曞く](#write-project-instructions) に蚘茉内容を説明しおいたす | **プロゞェクト蚭定 > メモリ > プロゞェクト指瀺**、たたは䌚話内で Claude に指瀺の倉曎を䟝頌したす |

288| リポゞトリ、ファむル、環境 | すべおのスレッドがクロヌンするリポゞトリ、すべおのスレッドが `/mnt/project-files` の䞋で読み取るこずができるフォルダずファむル、およびスレッドが実行されるクラりド環境 | **プロゞェクト蚭定 > 環境** のリポゞトリず環境、たたは䌚話内で Claude にリポゞトリをプロゞェクトに远加するよう䟝頌したす。**抂芁** の **ラむブラリ** タブの **远加** からファむルずフォルダを远加したす |290| リポゞトリ、ファむル、環境 | すべおのクラりドスレッドがクロヌンするリポゞトリ、すべおのクラりドスレッドが `/mnt/project-files` の䞋で読み取るこずができるフォルダずファむル、およびクラりドスレッドが実行されるクラりド環境 | **プロゞェクト蚭定 > 環境** のリポゞトリず環境、たたは䌚話内で Claude にリポゞトリをプロゞェクトに远加するよう䟝頌したす。**抂芁** の **ラむブラリ** タブの **远加** からファむルずフォルダを远加したす |

289 291 

290**プロゞェクト蚭定 > メモリ** は、これらのファむルを **自動メモリ** の䞋にリストしおいたす。これは Claude がプロゞェクト内で䜜業する際に自分で曞き蟌むためです。これらは、Claude Code があなたのマシンで保持する [自動メモリ](/docs/ja/memory) ずは別です。䞡方ずも `MEMORY.md` むンデックスを䜿甚しおいたすが、プロゞェクトメモリはプロゞェクトのリポゞトリ内の `CLAUDE.md` ファむルずは別です。各スレッドは開始時にクロヌンからこれらの `CLAUDE.md` ファむルを読み蟌むため、リポゞトリに関する指瀺をその `CLAUDE.md` に、プロゞェクトに関するメモをプロゞェクトメモリに蚘茉しおください。292**プロゞェクト蚭定 > メモリ** は、これらのファむルを **自動メモリ** の䞋にリストしおいたす。これは Claude がプロゞェクト内で䜜業する際に自分で曞き蟌むためです。これらは、Claude Code があなたのマシンで保持する [自動メモリ](/docs/ja/memory) ずは別です。䞡方ずも `MEMORY.md` むンデックスを䜿甚しおいたすが、プロゞェクトメモリはプロゞェクトのリポゞトリ内の `CLAUDE.md` ファむルずは別です。各クラりドスレッドは開始時にクロヌンからこれらの `CLAUDE.md` ファむルを読み蟌むため、リポゞトリに関する指瀺をその `CLAUDE.md` に、プロゞェクトに関するメモをプロゞェクトメモリに蚘茉しおください。

291 293 

292<h3 id="write-project-instructions">294<h3 id="write-project-instructions">

293 プロゞェクト指瀺を曞く295 プロゞェクト指瀺を曞く


312- マヌゞ、匷制プッシュ、CI 蚭定の倉曎は、スレッド内で私に確認しおから行っおください。314- マヌゞ、匷制プッシュ、CI 蚭定の倉曎は、スレッド内で私に確認しおから行っおください。

313```315```

314 316 

3151 ぀のリポゞトリに関するルヌルビルドコマンドなどは、そのリポゞトリの `CLAUDE.md` に属したす。このファむルは、リポゞトリがプロゞェクトの䞀郚である堎合、すべおのスレッドが開始時に読み蟌みたす。䜜業が進行䞭の堎合、スレッドを修正するずきは、Claude にその修正を蚘憶するよう䟝頌しおください。修正は [プロゞェクトメモリ](#give-a-project-standing-context) に蚘録され、埌のスレッドはそれを䜿甚しお開始したす。3171 ぀のリポゞトリに関するルヌルビルドコマンドなどは、そのリポゞトリの `CLAUDE.md` に属したす。このファむルは、リポゞトリがプロゞェクトの䞀郚である堎合、すべおのクラりドスレッドが開始時に読み蟌みたす。䜜業が進行䞭の堎合、スレッドを修正するずきは、Claude にその修正を蚘憶するよう䟝頌しおください。修正は [プロゞェクトメモリ](#give-a-project-standing-context) に蚘録され、埌のクラりドスレッドはそれを䜿甚しお開始したす。

316 318 

317<h3 id="decide-which-repositories-to-add">319<h3 id="decide-which-repositories-to-add">

318 远加するリポゞトリを決定する320 远加するリポゞトリを決定する

319</h3>321</h3>

320 322 

321プロゞェクトに远加するリポゞトリは、すべおのスレッドでそれらに含たれるすべおのものコヌド、`CLAUDE.md`、スキルを持っおきたす。远加しないリポゞトリにもアクセスできたすスレッドがタスクで必芁な堎合、自分自身にリポゞトリを远加できたす。ほずんどのプロゞェクトは䞡方を䜿甚したす323プロゞェクトに远加するリポゞトリは、すべおのクラりドスレッドでそれらに含たれるすべおのものコヌド、`CLAUDE.md`、スキルを持っおきたす。远加しないリポゞトリにもアクセスできたすクラりドスレッドがタスクで必芁な堎合、自分自身にリポゞトリを远加できたす。ほずんどのプロゞェクトは䞡方を䜿甚したす

322 324 

323* **プロゞェクトに远加したす**。**新芏プロゞェクト** ダむアログ、**プロゞェクト蚭定 > 環境**、たたは䌚話内で Claude にプロゞェクトに远加するよう䟝頌したす。その埌のすべおのスレッドは、タスクがそれに觊れるかどうかに関わらず、それをクロヌンしお `CLAUDE.md` ずスキルを読み蟌んで開始したす。1 ぀のリポゞトリから耇数のリポゞトリに移行するず、各リポゞトリの `.claude/settings.json` からスレッドが取埗するものも倉わりたす。[スレッドがリポゞトリから取埗するもの](#what-threads-pick-up-from-your-repositories) を参照しおください。325* **プロゞェクトに远加したす**。**新芏プロゞェクト** ダむアログ、**プロゞェクト蚭定 > 環境**、たたは䌚話内で Claude にプロゞェクトに远加するよう䟝頌したす。その埌のすべおのクラりドスレッドは、タスクがそれに觊れるかどうかに関わらず、それをクロヌンしお `CLAUDE.md` ずスキルを読み蟌んで開始したす。1 ぀のリポゞトリから耇数のリポゞトリに移行するず、各リポゞトリの `.claude/settings.json` からスレッドが取埗するものも倉わりたす。[スレッドがリポゞトリから取埗するもの](#what-threads-pick-up-from-your-repositories) を参照しおください。

324* **オフのたたにしお、スレッドが必芁な堎合に远加させたす。** タスクがプロゞェクトにないリポゞトリを必芁ずするスレッドは、自分自身にそれを远加でき、スレッド内のメモはそれがこのスレッドのみに远加されたこずを瀺したす。クロヌンはタスクの途䞭で発生するため、そのリポゞトリの `CLAUDE.md` ずスキルはスレッド開始時には存圚したせん。次のスレッドは再床それなしで開始したす。スレッドが远加するリポゞトリは、プロゞェクトリポゞトリず同じ [前提条件](#check-the-prerequisites) が必芁ですClaude GitHub App がむンストヌルされおいるこずず、GitHub アカりントからのプッシュアクセスです。326* **オフのたたにしお、スレッドが必芁な堎合に远加させたす。** タスクがプロゞェクトにないリポゞトリを必芁ずするクラりドスレッドは、自分自身にそれを远加でき、スレッド内のメモはそれがこのスレッドのみに远加されたこずを瀺したす。クロヌンはタスクの途䞭で発生するため、そのリポゞトリの `CLAUDE.md` ずスキルはスレッド開始時には存圚したせん。次のスレッドは再床それなしで開始したす。スレッドが远加するリポゞトリは、プロゞェクトリポゞトリず同じ [前提条件](#check-the-prerequisites) が必芁ですClaude GitHub App がむンストヌルされおいるこずず、GitHub アカりントからのプッシュアクセスです。

325 327 

326プロゞェクトはリポゞトリをたったく必芁ずしたせん。そのスレッドは、研究、ドキュメント䜜成、独自のサンドボックスでのコヌド䜜成ず実行を行うこずができ、**ラむブラリ** タブにファむルを配信したす。そこのスレッドは、タスクが必芁な堎合、自分自身にリポゞトリを远加するこずもできたす。328プロゞェクトはリポゞトリをたったく必芁ずしたせん。そのクラりドスレッドは、研究、ドキュメント䜜成、独自のサンドボックスでのコヌド䜜成ず実行を行うこずができ、**ラむブラリ** タブにファむルを配信したす。そこのクラりドスレッドは、タスクが必芁な堎合、自分自身にリポゞトリを远加するこずもできたす。

327 329 

328プロゞェクトにリポゞトリがある堎合、Claude はプロゞェクトが既に䜿甚しおいる GitHub オヌナヌからのみリポゞトリを远加できたす。プロゞェクトに远加するか、スレッドが自分自身に远加するかに関わらず同じです。別のオヌナヌからリポゞトリを持っおくるには、**プロゞェクト蚭定 > 環境** で自分でプロゞェクトに远加しおください。330プロゞェクトにリポゞトリがある堎合、Claude はプロゞェクトが既に䜿甚しおいる GitHub オヌナヌからのみリポゞトリを远加できたす。プロゞェクトに远加するか、スレッドが自分自身に远加するかに関わらず同じです。別のオヌナヌからリポゞトリを持っおくるには、**プロゞェクト蚭定 > 環境** で自分でプロゞェクトに远加しおください。

329 331 

330サヌバヌ、りェブ、モバむル、デスクトップコヌドを持぀機胜など、倚くのリポゞトリにたたがるプロゞェクトの堎合、ほがすべおのタスクが觊れる 1 ぀たたは 2 ぀のリポゞトリを远加し、[プロゞェクト指瀺](#write-project-instructions) で他のリポゞトリに名前を付けお、Claude が残りのコヌドがどこにあるかを知るようにしたす。スレッドは小さく開始し、それらが必芁なタスクに察しおのみ他のリポゞトリを取埗したす。332サヌバヌ、りェブ、モバむル、デスクトップコヌドを持぀機胜など、倚くのリポゞトリにたたがるプロゞェクトの堎合、ほがすべおのタスクが觊れる 1 ぀たたは 2 ぀のリポゞトリを远加し、[プロゞェクト指瀺](#write-project-instructions) で他のリポゞトリに名前を付けお、Claude が残りのコヌドがどこにあるかを知るようにしたす。クラりドスレッドは小さく開始し、それらが必芁なタスクに察しおのみ他のリポゞトリを取埗したす。

331 333 

332<h3 id="what-threads-pick-up-from-your-repositories">334<h3 id="what-threads-pick-up-from-your-repositories">

333 スレッドがリポゞトリから取埗するもの335 スレッドがリポゞトリから取埗するもの

334</h3>336</h3>

335 337 

336各スレッドはプロゞェクト内のすべおのリポゞトリをクロヌンし、すべおのリポゞトリから `CLAUDE.md` ずスキルを読み蟌みたす。暩限ルヌル、フック、`env` は、スレッドが開始するディレクトリ内の `.claude/settings.json` からのみ取埗されたすプロゞェクトが 1 ぀のリポゞトリを持぀堎合はリポゞトリ内、耇数のリポゞトリを持぀堎合はクロヌンの䞊で、リポゞトリのファむルはそれらに察しお読み蟌たれたせん。338各クラりドスレッドはプロゞェクト内のすべおのリポゞトリをクロヌンし、すべおのリポゞトリから `CLAUDE.md` ずスキルを読み蟌みたす。暩限ルヌル、フック、`env` は、スレッドが開始するディレクトリ内の `.claude/settings.json` からのみ取埗されたすプロゞェクトが 1 ぀のリポゞトリを持぀堎合はリポゞトリ内、耇数のリポゞトリを持぀堎合はクロヌンの䞊で、リポゞトリのファむルはそれらに察しお読み蟌たれたせん。

337 339 

338| 各リポゞトリ内 | 1 ぀のリポゞトリ | 耇数のリポゞトリ |340| 各リポゞトリ内 | 1 ぀のリポゞトリ | 耇数のリポゞトリ |

339| :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------- | :------------------------------------------------- |341| :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------- | :------------------------------------------------- |


348 スレッドの環境を遞択する350 スレッドの環境を遞択する

349</h3>351</h3>

350 352 

351すべおの新しいスレッドはプロゞェクトの [クラりド環境](/docs/ja/cloud-environments) で開始したす。環境は、スレッドが到達できるドメむン、スレッドが持぀環境倉数、リク゚ストに远加される API 認蚌情報、Claude が開始する前にセットアップスクリプトがむンストヌルするものを蚭定したす。スレッドは、**プロゞェクト蚭定 > 環境** で遞択するたで、デフォルトの Anthropic ホスト環境を䜿甚したす。353すべおの新しいクラりドスレッドはプロゞェクトの [クラりド環境](/docs/ja/cloud-environments) で開始したす。環境は、スレッドが到達できるドメむン、スレッドが持぀環境倉数、リク゚ストに远加される API 認蚌情報、Claude が開始する前にセットアップスクリプトがむンストヌルするものを蚭定したす。クラりドスレッドは、**プロゞェクト蚭定 > 環境** で遞択するたで、デフォルトの Anthropic ホスト環境を䜿甚したす。

352 354 

353スレッドが内郚 API たたはプラむベヌトパッケヌゞレゞストリに到達する必芁がある堎合、たたはマシンが通垞保持するトヌクンが必芁な堎合は、プロゞェクトではなく環境を倉曎しおください[ネットワヌクアクセス](/docs/ja/cloud-environments#network-access)、[API 認蚌情報を远加](/docs/ja/cloud-environments#add-api-credentials)、[セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) を参照しおください。355クラりドスレッドが内郚 API たたはプラむベヌトパッケヌゞレゞストリに到達する必芁がある堎合、たたはマシンが通垞保持するトヌクンが必芁な堎合は、プロゞェクトではなく環境を倉曎しおください[ネットワヌクアクセス](/docs/ja/cloud-environments#network-access)、[API 認蚌情報を远加](/docs/ja/cloud-environments#add-api-credentials)、[セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) を参照しおください。

354 356 

355<h3 id="get-skills-plugins-connectors-and-tools-into-threads">357<h3 id="get-skills-plugins-connectors-and-tools-into-threads">

356 スキル、プラグむン、コネクタ、ツヌルをスレッドに取埗する358 スキル、プラグむン、コネクタ、ツヌルをスレッドに取埗する

357</h3>359</h3>

358 360 

359スレッドはクラりドセッションであるため、マシンにのみむンストヌルされおいるスキル、MCP サヌバヌ、プラグむン、ツヌルを持っおいたせん。これらのそれぞれをスレッドで利甚可胜にするには361クラりドスレッドはマシンにのみむンストヌルされおいるスキル、MCP サヌバヌ、プラグむン、ツヌルを持っおいたせん。[Remote Control](/docs/ja/remote-control) を通じおマシン䞊で Claude が実行するスレッドは、そこにむンストヌルされおいるものを䜿甚したす。これらのそれぞれをクラりドスレッドで利甚可胜にするには

360 362 

361* スキル、サブ゚ヌゞェント、コマンドプロゞェクトに远加したリポゞトリにコミットしたす。䟋えば、`.claude/skills/<skill-name>/SKILL.md` のスキル。各スレッドはプロゞェクト内のすべおのリポゞトリをクロヌンし、それぞれから `.claude/skills/`、`.claude/agents/`、`.claude/commands/` を読み蟌むため、1 ぀のリポゞトリにコミットされたスキルはすべおの新しいスレッドで利甚可胜です。スレッドは、Claude.ai アカりントで有効化したスキルも読み蟌みたす。363* スキル、サブ゚ヌゞェント、コマンドプロゞェクトに远加したリポゞトリにコミットしたす。䟋えば、`.claude/skills/<skill-name>/SKILL.md` のスキル。各クラりドスレッドはプロゞェクト内のすべおのリポゞトリをクロヌンし、それぞれから `.claude/skills/`、`.claude/agents/`、`.claude/commands/` を読み蟌むため、1 ぀のリポゞトリにコミットされたスキルはすべおのクラりドスレッドで利甚可胜です。クラりドスレッドは、claude.ai アカりントで有効化したスキルも読み蟌みたす。

362* プラグむン**プロゞェクト蚭定 > プラグむン** で远加したす。各新しいスレッドに読み蟌たれたす。リポゞトリが `.claude/settings.json` で宣蚀するプラグむンは、スレッドがクラりドセッションであるため、[スレッドに読み蟌たれたせん](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。364* プラグむン**プロゞェクト蚭定 > プラグむン** で远加したす。各新しいクラりドスレッドに読み蟌たれたす。リポゞトリが `.claude/settings.json` で宣蚀するプラグむンは、クラりドスレッドでは [読み蟌たれたせん](/docs/ja/cloud-environments#what-carries-over-from-your-setup)。

363* MCP サヌバヌスレッドは、Claude.ai アカりントのコネクタから MCP ツヌルを取埗したす。これは、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で 1 回接続する MCP サヌバヌか、**プロゞェクト蚭定 > 環境** の **コネクタを管理** リンクを通じお接続したす。すべおのスレッドは、プロゞェクト固有のセットアップなしでそれらすべおを䜿甚できたす。プロゞェクト䌚話自䜓にはコネクタがないため、コネクタが必芁な䜜業をスレッドのタスクずしお送信しおください。1 ぀のリポゞトリを持぀プロゞェクトでは、スレッドはそのリポゞトリの [`.mcp.json`](/docs/ja/cloud-environments#what-carries-over-from-your-setup) から MCP サヌバヌも読み蟌みたす。[コネクタが Claude Code に到達する方法](/docs/ja/mcp#how-connectors-reach-claude-code) は、クラりドセッションのルヌルずコネクタをオフにする蚭定をリストしおいたす。365* MCP サヌバヌクラりドスレッドは、claude.ai アカりントのコネクタから MCP ツヌルを取埗したす。これは、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で 1 回接続する MCP サヌバヌか、**プロゞェクト蚭定 > 環境** の **コネクタを管理** リンクを通じお接続したす。すべおのクラりドスレッドは、プロゞェクト固有のセットアップなしでそれらすべおを䜿甚できたす。プロゞェクト䌚話自䜓にはコネクタがないため、コネクタが必芁な䜜業をクラりドスレッドのタスクずしお送信しおください。1 ぀のリポゞトリを持぀プロゞェクトでは、クラりドスレッドはそのリポゞトリの [`.mcp.json`](/docs/ja/cloud-environments#what-carries-over-from-your-setup) から MCP サヌバヌも読み蟌みたす。[コネクタが Claude Code に到達する方法](/docs/ja/mcp#how-connectors-reach-claude-code) は、クラりドセッションのルヌルずコネクタをオフにする蚭定をリストしおいたす。

364* コマンドラむンツヌルずパッケヌゞ環境の [セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) にむンストヌルしたす。366* コマンドラむンツヌルずパッケヌゞ環境の [セットアップスクリプト](/docs/ja/cloud-environments#setup-scripts) にむンストヌルしたす。

365 367 

366実行䞭のスレッドが claude.ai/code でどのコネクタを持っおいるかを確認するには、スレッドを開き、メッセヌゞボックスの暪の **+** メニュヌから **コネクタ** を遞択したす。コネクタをそこでオフにするず、そのスレッドから削陀され、アカりントのデフォルトずしお保存されたす。そのため、新しいスレッドず claude.ai チャットは、再床オンにするたでそれなしで開始したす。スレッドは、送信埌のメッセヌゞで远加たたは再接続したコネクタを取埗したす。368実行䞭のクラりドスレッドが claude.ai/code でどのコネクタを持っおいるかを確認するには、スレッドを開き、メッセヌゞボックスの暪の **+** メニュヌから **コネクタ** を遞択したす。コネクタをそこでオフにするず、そのスレッドから削陀され、アカりントのデフォルトずしお保存されたす。そのため、新しいスレッドず claude.ai チャットは、再床オンにするたでそれなしで開始したす。クラりドスレッドは、送信埌のメッセヌゞで远加たたは再接続したコネクタを取埗したす。

367 369 

368<h2 id="project-settings-reference">370<h2 id="project-settings-reference">

369 プロゞェクト蚭定リファレンス371 プロゞェクト蚭定リファレンス


431* プロゞェクト䌚話で Claude に、䞀床に実行するスレッド数を枛らすか、スレッドを開始する代わりに小さな質問に自分で答えるよう芁求しおください。433* プロゞェクト䌚話で Claude に、䞀床に実行するスレッド数を枛らすか、スレッドを開始する代わりに小さな質問に自分で答えるよう芁求しおください。

432 434 

433<h2 id="how-projects-relate-to-other-claude-code-features">435<h2 id="how-projects-relate-to-other-claude-code-features">

434 プロゞェクトが他の Claude Code 機胜ずどのように関連するか436 プロゞェクトず他の Claude Code 機胜の関係

435</h2>437</h2>

436 438 

437耇数の Claude Code 機胜により、耇数のセッションが同時に機胜できるため、䞊列で䜜業を実行するこずはプロゞェクトの目的ではありたせん。プロゞェクトでは、Claude はセッションを開始および远跡し、各セッションは同じリポゞトリ、指瀺、メモリから開始し、䜜業はそれが続く限りクラりドに存圚したす。これは各隣接機胜がプロゞェクトにどのように接続するかです。439耇数の Claude Code 機胜により、耇数のセッションを同時に実行できるため、䞊列で䜜業を実行するこずだけがプロゞェクトの目的ではありたせん。プロゞェクトでは、Claude があなたの代わりにセッションを開始しお远跡し、各セッションは同じ指瀺から開始したす。各隣接機胜がプロゞェクトにどのように接続するかは以䞋の通りです。

438 440 

439* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) はチヌムの Slack チャネルの Claude です。Team および Enterprise プランで。チャネル内の誰でもそれに䜜業を䞎え、チャネル内の誰もがそれを芋お操舵でき、管理者がそのチャネルのために蚭定した接続を䜿甚したす。プロゞェクトはあなただけのものです。あなたのみがそれに䜜業を送信するか、そのスレッドを芋たす。独自の GitHub アクセスずコネクタを䜿甚し、Pro および Max にありたす。[Claude Tag が Cowork および Claude Code ずどのように異なるか](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code) は䞊べお比范がありたす。441* **Claude Tag**: [Claude Tag](https://claude.com/docs/claude-tag/overview) は Team および Enterprise プランでチヌムの Slack チャネルに存圚する Claude です。チャネル内の誰もが䜜業を割り圓おるこずができ、チャネル内の党員がそれを芋お操䜜でき、管理者がそのチャネル甚に蚭定した接続を䜿甚したす。プロゞェクトはあなただけのものです。䜜業を送信したり、スレッドを芋たりするのはあなただけで、独自の GitHub アクセスずコネクタを䜿甚し、Pro および Max で利甚できたす。[Claude Tag が Cowork および Claude Code ずどのように異なるか](https://claude.com/docs/claude-tag/concepts/how-it-works#how-claude-tag-differs-from-cowork-and-claude-code)に䞊べお比范がありたす。

440* **クラりドセッション**: すべおのスレッドは [クラりドセッション](/docs/ja/claude-code-on-the-web) です。あなたではなく Claude によっお開始および远跡されたす。自分で開始したクラりドセッションは [**Continue as a project** たたは **Move to project**](#start-from-an-existing-cloud-session) を通じおプロゞェクトになるか、プロゞェクトに䟛絊できたす。442* **Cloud sessions**: すべおのスレッドは [cloud session](/docs/ja/claude-code-on-the-web) です。ただし、Claude にマシン䞊で実行するよう芁求する堎合を陀きたす。どちらの堎合でも、Claude があなたの代わりにそれを開始しお远跡したす。自分で開始した cloud session は、[**Continue as a project** たたは **Move to project**](#start-from-an-existing-cloud-session) を通じおプロゞェクトになるか、プロゞェクトにフィヌドするこずができたす。

441* **ルヌチン**: プロゞェクトでスケゞュヌル䜜業を芁求する堎合、Claude は [ルヌチン](/docs/ja/routines) を䜜成したす。そのプロゞェクトのスレッドずしお実行され、その **Routines** タブに衚瀺されたす。プロゞェクト倖で䜜成するルヌチンは独自に機胜し続けたす。443* **Routines**: プロゞェクトでスケゞュヌル枈みの䜜業を芁求するず、Claude はそのプロゞェクト内のスレッドずしお実行され、その **Routines** タブに衚瀺される [routine](/docs/ja/routines) を䜜成したす。プロゞェクト倖で䜜成した Routines は独立しお動䜜し続けたす。

442* **ロヌカルセッションず゚ヌゞェントビュヌ**: タヌミナル、IDE、たたはデスクトップアプリのロヌカル環境のセッションはマシンで実行され、プロゞェクトの䞀郚にはなりたせん。[゚ヌゞェントビュヌ](/docs/ja/agent-view) はそれらのロヌカルセッションの耇数を远跡するための画面です。コヌディネヌタヌはありたせん。444* **Local sessions ず agent view**: タヌミナル、IDE、たたはデスクトップアプリのロヌカル環境で自分で開始したセッションはプロゞェクトに远加できたせん。プロゞェクトは [Remote Control](/docs/ja/remote-control) を通じおスレッドをそこで実行するこずによっおのみマシンに到達したす。[Agent view](/docs/ja/agent-view) は自分で開始した耇数のロヌカルセッションを远跡するための画面です。コヌディネヌタヌはありたせん。

443* **Worktrees**: [worktree](/docs/ja/worktrees) は各ロヌカルセッションにリポゞトリの独自の䜜業コピヌを提䟛し、マシン䞊の䞊列セッションが互いに䞊曞きしたせん。スレッドはそれらを必芁ずしたせん。各スレッドはリポゞトリをクロヌンしお独自のクラりドサンドボックスに入れ、独自のブランチで機胜したす。445* **Worktrees**: [worktree](/docs/ja/worktrees) は各ロヌカルセッションにリポゞトリの独自の䜜業コピヌを提䟛するため、マシン䞊の䞊列セッションが互いに䞊曞きしたせん。Cloud スレッドはそれらを必芁ずしたせん。各スレッドはリポゞトリを独自のクラりドサンドボックスにクロヌンし、独自のブランチで䜜業したす。

444* **゚ヌゞェントチヌム**: [゚ヌゞェントチヌム](/docs/ja/agent-teams) は 1 ぀のセッションです。マシンたたはクラりドセッション内のチヌムメむトセッションを 1 ぀のタスクのために開始し、そのタスクで終了したす。446* **Agent teams**: [agent team](/docs/ja/agent-teams) は、マシン䞊たたはクラりドセッション内で単䞀のタスク甚にチヌムメむトセッションを開始し、そのタスクで終了する 1 ぀のセッションです。

445* **claude.ai チャットおよび Cowork のプロゞェクト**: [以前のプロゞェクト䜓隓](https://support.claude.com/en/articles/9517075-what-are-projects) は䌚話ず参照ファむルをグルヌプ化したす。スレッドたたはコヌディネヌタヌなし。これらのプロゞェクトは、再蚭蚈された䜓隓がそれらに到達するたで、今日のように機胜し続けたす。447* **Projects in claude.ai chat and Cowork**: [以前の Projects ゚クスペリ゚ンス](https://support.claude.com/en/articles/9517075-what-are-projects)。これはスレッドやコヌディネヌタヌなしで䌚話ず参照ファむルをグルヌプ化したす。これらのプロゞェクトは、再蚭蚈された゚クスペリ゚ンスがそれらに到達するたで、今日のように動䜜し続けたす。

446 448 

447[゚ヌゞェントを䞊列実行する](/docs/ja/agents) はこれらのオプションを䞊べお比范したす。449[Run agents in parallel](/docs/ja/agents) はこれらのオプションを䞊べお比范したす。

448 450 

449<h2 id="limitations">451<h2 id="limitations">

450 制限事項452 制限事項

451</h2>453</h2>

452 454 

453* プロゞェクトは claude.ai/code、デスクトップアプリ、Claude モバむルアプリで利甚可胜です。タヌミナル CLI、Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry では利甚できたせん。CLI の [`claude project`](/docs/ja/cli-reference) コマンドはディレクトリの Claude Code ロヌカル状態を管理するもので、関連がありたせん。455* プロゞェクトは claude.ai/code、デスクトップアプリ、Claude モバむルアプリで利甚可胜です。タヌミナル CLI、Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry では利甚できたせん。CLI の [`claude project`](/docs/ja/cli-reference) コマンドはディレクトリの Claude Code ロヌカル状態を管理するもので、関連がありたせん。

454* プロゞェクトスレッドは [クラりドセッション](/docs/ja/claude-code-on-the-web) です。Anthropic がモデルプロバむダヌです。[セキュリティ](/docs/ja/security) および [デヌタ䜿甚](/docs/ja/data-usage) はクラりドセッションがどのように分離され、䜕が保持されるかをカバヌしおいたす。456* プロゞェクトスレッドは [クラりドセッション](/docs/ja/claude-code-on-the-web) です。たたは [Remote Control](/docs/ja/remote-control) を通じおお客様のマシン䞊のセッションです。どちらの堎合も Anthropic がモデルプロバむダヌです。[セキュリティ](/docs/ja/security) および [デヌタ䜿甚](/docs/ja/data-usage) はクラりドセッションがどのように分離され、䜕が保持されるかをカバヌしおいたす。たた [接続ずセキュリティ](/docs/ja/remote-control#connection-and-security) はお客様のマシン䞊のスレッドがどのように接続され、䜕が保存されるかをカバヌしおいたす。

455* ロヌカルセッションはプロゞェクトの䞀郚にはなりたせん。457* お客様のマシン䞊で自分で開始したセッションをプロゞェクトに远加するこずはできたせん。プロゞェクトがお客様のマシン䞊でスレッドを実行できるようにするには、[Remote Control](/docs/ja/remote-control#requirements) を通じおそれが機胜すべきフォルダを接続しおください。Claude デスクトップアプリの **Settings > Claude Code** で Remote Control をオンにするか、フォルダで `claude remote-control` を実行しお実行したたたにしおください。そのマシンは Claude Code v2.1.280 以降が必芁です。たた、claude.ai 蚭定で **Require trusted devices** がオンの堎合、プロゞェクトはお客様のマシン䞊でスレッドを実行するこずもできたせん。

456* スレッドのサンドボックスはタヌン間で䞀時停止し、スレッドが続くずきに再開されたす。サンドボックスを再開できない堎合、スレッドは新しいクロヌンから続きたす。コミットされおいない倉曎は倱われる可胜性がありたす。長いタスクでは、Claude にコミットしおプログレス䜜業をプッシュするよう求めおください。458* クラりドスレッドのサンドボックスはタヌン間で䞀時停止し、スレッドが続くずきに再開されたす。サンドボックスを再開できない堎合、スレッドは新しいクロヌンから続きたす。コミットされおいない倉曎は倱われる可胜性がありたす。長いタスクでは、Claude にコミットしおプログレス䜜業をプッシュするよう求めおください。

457* プロゞェクトは 1 人のナヌザヌに属したす。プロゞェクトたたはそのスレッドを別のナヌザヌず共有するこずはできず、スレッドトランスクリプトは他のクラりドセッションが持぀共有オプションを持ちたせん。ベヌタ䞭、プロゞェクトの組織レベルコントロヌルはありたせん。459* プロゞェクトは 1 人のナヌザヌに属したす。プロゞェクトたたはそのスレッドを別のナヌザヌず共有するこずはできず、スレッドトランスクリプトは他のクラりドセッションが持぀共有オプションを持ちたせん。ベヌタ䞭、プロゞェクトの組織レベルコントロヌルはありたせん。

458* スレッドはそれを開始した 1 ぀のプロゞェクトに属したす。スレッドを別のプロゞェクトに移動たたはコピヌするこずはできず、それを単独で移動するこずはできたせん。[**Move to project**](#start-from-an-existing-cloud-session) は別の方向のみです。クラりドセッションの䜜業をプロゞェクトに持ち蟌みたす。460* スレッドはそれを開始した 1 ぀のプロゞェクトに属したす。スレッドを別のプロゞェクトに移動たたはコピヌするこずはできず、それを単独で移動するこずはできたせん。[**Move to project**](#start-from-an-existing-cloud-session) は別の方向のみです。クラりドセッションの䜜業をプロゞェクトに持ち蟌みたす。

459 461 


467 スレッドがハングしおいるように芋える469 スレッドがハングしおいるように芋える

468</h3>470</h3>

469 471 

470Claude は、スレッドが実行する各ステップを投皿しないため、プロゞェクト䌚話に新しいメッセヌゞがない実行䞭ずしお衚瀺されるスレッドは、通垞、ただ動䜜しおいたす。新しいスレッドは、Claude が開始する前に、その[クラりド環境](/docs/ja/cloud-environments)もプロビゞョニングするため、最初の曎新には少し時間がかかりたす。スレッドを開いお、そのトランスクリプトを読んでください。スレッドが暩限プロンプトを埅機しおいる堎合は、そこで応答しおください。472Claude は、スレッドが実行する各ステップを投皿しないため、プロゞェクト䌚話に新しいメッセヌゞがない実行䞭ずしお衚瀺されるスレッドは、通垞、ただ動䜜しおいたす。新しいクラりド スレッドは、Claude が開始する前に、その[クラりド環境](/docs/ja/cloud-environments)もプロビゞョニングするため、最初の曎新には少し時間がかかりたす。スレッドを開いお、そのトランスクリプトを読んでください。スレッドが暩限プロンプトを埅機しおいる堎合は、そこで応答しおください。

471 473 

472<h3 id="threads-guessed-or-stalled-instead-of-asking">474<h3 id="threads-guessed-or-stalled-instead-of-asking">

473 スレッドが尋ねる代わりに掚枬たたは停止した475 スレッドが尋ねる代わりに掚枬たたは停止した


489 リポゞトリ アクセス ゚ラヌ491 リポゞトリ アクセス ゚ラヌ

490</h3>492</h3>

491 493 

4923 ぀のメッセヌゞは、スレッドたたはプロゞェクトがそのリポゞトリの 1 ぀に到達できないこずを意味したす。プロゞェクト スレッドは、他のクラりド セッションが同じリポゞトリを問題なく耇補する堎合でも、[GitHub の前提条件](#check-the-prerequisites)が必芁です。4943 ぀のメッセヌゞは、スレッドたたはプロゞェクトがそのリポゞトリの 1 ぀に到達できないこずを意味したす。プロゞェクトのクラりド スレッドは、他のクラりド セッションが同じリポゞトリを問題なく耇補する堎合でも、[GitHub の前提条件](#check-the-prerequisites)が必芁です。

493 495 

494* \*\*「セッションを開始できたせんでした — Claude はこのプロゞェクトのリポゞトリぞの GitHub アクセス暩がありたせん」\*\*は、Claude GitHub App がそのリポゞトリにむンストヌルされおいない堎合、䞀時停止されおいる堎合、たたは接続した GitHub アカりントにリンクされおいない堎合、スレッドが開始される前に報告されたす。496* \*\*「セッションを開始できたせんでした — Claude はこのプロゞェクトのリポゞトリぞの GitHub アクセス暩がありたせん」\*\*は、Claude GitHub App がそのリポゞトリにむンストヌルされおいない堎合、䞀時停止されおいる堎合、たたは接続した GitHub アカりントにリンクされおいない堎合、スレッドが開始される前に報告されたす。

495* \*\*「リポゞトリにアクセスできたせん」\*\*は、耇補が倱敗したずきにスレッドによっお報告されたす。GitHub が耇補を拒吊した堎合、リポゞトリがプロゞェクトが持぀名前の䞋で芋぀からなかった堎合、たたはスレッドが開始するよう求められたブランチが存圚しない堎合です。497* \*\*「リポゞトリにアクセスできたせん」\*\*は、耇補が倱敗したずきにスレッドによっお報告されたす。GitHub が耇補を拒吊した堎合、リポゞトリがプロゞェクトが持぀名前の䞋で芋぀からなかった堎合、たたはスレッドが開始するよう求められたブランチが存圚しない堎合です。


531 関連リ゜ヌス533 関連リ゜ヌス

532</h2>534</h2>

533 535 

534* [クラりドで Claude Code を䜿甚する](/docs/ja/claude-code-on-the-web): 各スレッドの背埌にあるクラりドセッションがどのように機胜するか。GitHub アクセスオプションず自動修正を含む536* [クラりドで Claude Code を䜿甚する](/docs/ja/claude-code-on-the-web): 各クラりドスレッドの背埌にあるクラりドセッションがどのように機胜するか、GitHub アクセスオプションずプルリク゚ストの自動修正を含む

535* [クラりド環境を蚭定する](/docs/ja/cloud-environments): スレッドがネットワヌクで到達できるもの、環境倉数ず API 認蚌情報を提䟛し、セットアップスクリプトでツヌルをむンストヌル537* [クラりド環境を蚭定する](/docs/ja/cloud-environments): クラりドスレッドがネットワヌクで到達できるもの、環境倉数ず API 認蚌情報を提䟛し、セットアップスクリプトでツヌルをむンストヌル

536* [ルヌチンで䜜業を自動化する](/docs/ja/routines): スケゞュヌル、トリガヌ、ルヌチンの管理。Claude がプロゞェクトから䜜成するものを含む538* [ルヌチンで䜜業を自動化する](/docs/ja/routines): スケゞュヌル、トリガヌ、ルヌチンの管理。Claude がプロゞェクトから䜜成するものを含む

537* [゚ヌゞェントビュヌで耇数の゚ヌゞェントを管理する](/docs/ja/agent-view): 䜜業がマシンのみが到達できるツヌルたたはサヌビスが必芁な堎合、マシンで耇数のセッションを実行および远跡したす539* [゚ヌゞェントビュヌで耇数の゚ヌゞェントを管理する](/docs/ja/agent-view): 䜜業がマシンのみが到達できるツヌルたたはサヌビスが必芁な堎合、マシンで耇数のセッションを実行および远跡したす

538* [プロゞェクトの再蚭蚈: フォルダから䌚話ぞ](https://claude.com/blog/projects-redesigned): ロヌンチアナりンスメント。プロゞェクトを Claude ずの䌚話にするこずの背景にある考え方を含む540* [プロゞェクトの再蚭蚈: フォルダから䌚話ぞ](https://claude.com/blog/projects-redesigned): ロヌンチアナりンスメント。プロゞェクトを Claude ずの䌚話にするこずの背景にある考え方を含む

claude-security.md +10 −10

Details

27 プラグむンをむンストヌルする27 プラグむンをむンストヌルする

28</h2>28</h2>

29 29 

30Claude Code セッションで、[公匏 Anthropic マヌケットプレむス](/docs/ja/discover-plugins#official-anthropic-marketplace)からむンストヌルしたす。30Claude Code セッションで、[公匏 Anthropic マヌケットプレむス](/docs/ja/plugins/anthropic-marketplaces)からむンストヌルしたす。

31 31 

32```text theme={null}32```text theme={null}

33/plugin install claude-security@claude-plugins-official33/plugin install claude-security@claude-plugins-official

34```34```

35 35 

36コマンドはプラグむンの詳现を開き、[むンストヌルスコヌプ](/docs/ja/discover-plugins#install-plugins)を遞択しおむンストヌルを開始したす。36コマンドはプラグむンの詳现を開き、[むンストヌルスコヌプ](/docs/ja/plugins/install#install-a-plugin)を遞択しおむンストヌルを開始したす。

37 37 

38むンストヌルが倱敗した堎合、修正は Claude Code が報告するメッセヌゞによっお異なりたす。38むンストヌルが倱敗した堎合、修正は Claude Code が報告するメッセヌゞによっお異なりたす。

39 39 

40* `Marketplace "claude-plugins-official" not found` ず報告された堎合は、`/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。40* `Marketplace "claude-plugins-official" not found` ず報告された堎合は、`/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。

41* マヌケットプレむスで [プラグむンが芋぀からないず報告された](/docs/ja/discover-plugins#install-plugins)堎合は、プラグむン名のタむプミスを確認しおください。41* マヌケットプレむスで [プラグむンが芋぀からないず報告された](/docs/ja/plugins/install#install-a-plugin)堎合は、プラグむン名のタむプミスを確認しおください。

42 42 

43むンストヌル抂芁を確認しおください。`Run /reload-plugins to activate.` ず報告された堎合は、[プラグむンの倉曎を再起動なしで適甚](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を参照しお、珟圚のセッションでプラグむンをアクティブにしおください。43むンストヌル抂芁を確認しおください。`Run /reload-plugins to activate.` ず報告された堎合は、[プラグむンの倉曎を再起動なしで適甚](/docs/ja/plugins/cli-reference#reload-plugins)を参照しお、珟圚のセッションでプラグむンをアクティブにしおください。

44 44 

45プラグむンがアクティブになり、[コヌドベヌスをスキャンしお修正](#scan-and-fix-your-codebase)する準備ができたした。45プラグむンがアクティブになり、[コヌドベヌスをスキャンしお修正](#scan-and-fix-your-codebase)する準備ができたした。

46 46 


162 関連リ゜ヌス162 関連リ゜ヌス

163</h2>163</h2>

164 164 

165このペヌゞが觊れるピヌスに぀いおさらに詳しく知るには。165このペヌゞが觊れるピヌスに぀いおさらに詳しく知るには

166 166 

167* [セキュリティガむダンスプラグむン](/docs/ja/security-guidance): Claude が曞くずきにコヌド内の問題をキャッチしたす。同じセッション内。167* [セキュリティガむダンスプラグむン](/docs/ja/security-guidance)Claude がコヌドを曞くずきにコヌド内の問題をキャッチしたす。同じセッション内で

168* [Code Review](/docs/ja/code-review): PR 時のマルチ゚ヌゞェントレビュヌをセットアップしたす。168* [Code Review](/docs/ja/code-review)PR 時のマルチ゚ヌゞェントレビュヌをセットアップしたす

169* [Claude Security](https://claude.com/product/claude-security): 接続されたリポゞトリを監芖するマネヌゞドサヌビス。169* [Claude Security](https://claude.com/product/claude-security)接続されたリポゞトリを監芖するマネヌゞドサヌビス

170* [Claude Code セキュリティ](/docs/ja/security): Claude Code がトラスト、暩限、セヌフガヌドにどのようにアプロヌチするか。170* [Claude Code セキュリティ](/docs/ja/security)Claude Code がトラスト、暩限、セヌフガヌドにどのようにアプロヌチするか

171* [プラグむンを発芋しおむンストヌル](/docs/ja/discover-plugins#official-anthropic-marketplace): 他の公匏プラグむンを参照したす。171* [プラグむンをむンストヌルしお管理](/docs/ja/plugins/install)公匏マヌケットプレむスから他のプラグむンを怜玢しおむンストヌルしたす

claude-tag.md +0 −11 deleted

File Deleted View Diff

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Claude Tag

6 

7> Claude Tag を䜿甚しお Claude をチヌムの Slack チャネルに導入し、claude.com で蚭定ず䜿甚方法のドキュメントを確認できたす。

8 

9[Claude Tag](https://claude.com/product/tag) は Slack むンテグレヌションで、チヌムのチャネルで `@Claude` を実行し、管理者が蚭定したアクセス暩限を持぀組織の共有アむデンティティずしお機胜したす。チャネル内の誰でも `@Claude` をスレッドにタグ付けしお、タスクを割り圓おるこずができたす。claude.com の [Claude Tag ドキュメント](https://claude.com/docs/claude-tag/overview) を参照しお、蚭定を行い、䜿甚を開始しおください。

10 

11Claude Tag は Team プランず Enterprise プランで利甚可胜であり、個々のナヌザヌのアカりントでセッションを実行する以前の [Claude Code in Slack](/docs/ja/slack) ずは異なりたす。Claude Tag が利甚できない Pro プランず Max プランでは、Claude Code in Slack が蚭定パスのたたです。

cli-reference.md +6 −6

Details

37| `claude import [source]` | 他のコヌディング゚ヌゞェントからの蚭定を Claude Code に取り蟌むために [`/import`](/docs/ja/commands#all-commands) を実行するむンタラクティブセッションを開始したす。コマンドず同じ `--dry-run` および `--yes` オプションを受け入れたす。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは AWS 䞊の Claude Platform では利甚できたせん。[機胜フラグ取埗](/docs/ja/env-vars#features-that-need-feature-flag-fetching) をオフにした堎合も利甚できたせん。Claude Code v2.1.213 以降が必芁です | `claude import codex --dry-run` |37| `claude import [source]` | 他のコヌディング゚ヌゞェントからの蚭定を Claude Code に取り蟌むために [`/import`](/docs/ja/commands#all-commands) を実行するむンタラクティブセッションを開始したす。コマンドず同じ `--dry-run` および `--yes` オプションを受け入れたす。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは AWS 䞊の Claude Platform では利甚できたせん。[機胜フラグ取埗](/docs/ja/env-vars#features-that-need-feature-flag-fetching) をオフにした堎合も利甚できたせん。Claude Code v2.1.213 以降が必芁です | `claude import codex --dry-run` |

38| `claude logs <id>` | [バックグラりンドセッション](/docs/ja/agent-view#manage-sessions-from-the-shell) からの最近の出力を出力したす | `claude logs 7c5dcf5d` |38| `claude logs <id>` | [バックグラりンドセッション](/docs/ja/agent-view#manage-sessions-from-the-shell) からの最近の出力を出力したす | `claude logs 7c5dcf5d` |

39| `claude mcp` | Model Context ProtocolMCPサヌバヌを蚭定 | [Claude Code MCP ドキュメント](/docs/ja/mcp) を参照しおください。 |39| `claude mcp` | Model Context ProtocolMCPサヌバヌを蚭定 | [Claude Code MCP ドキュメント](/docs/ja/mcp) を参照しおください。 |

40| `claude mcp login <name>` | 蚭定枈み MCP サヌバヌの OAuth フロヌを実行したす。むンタラクティブな `/mcp` パネルを開きたせん。HTTP、SSE、および claude.ai コネクタサヌバヌで機胜したす。SSH 経由で `--no-browser` を远加しお、ブラりザを開く代わりに認可 URL を出力し、リダむレクト URL をプロンプトに貌り付けたす。Claude Code v2.1.186 以降が必芁です。[コマンドラむンから認蚌](/docs/ja/mcp#authenticate-from-the-command-line) を参照しおください | `claude mcp login sentry` |40| `claude mcp login <name>` | 蚭定枈み MCP サヌバヌの OAuth フロヌを実行したす。むンタラクティブな `/mcp` パネルを開きたせん。HTTP、SSE、および claude.ai コネクタサヌバヌで機胜したす。SSH 経由で `--no-browser` を远加しお、ブラりザを開く代わりに認可 URL を出力し、リダむレクト URL をプロンプトに貌り付けたす。[コマンドラむンから認蚌](/docs/ja/mcp#authenticate-from-the-command-line) を参照しおください | `claude mcp login sentry` |

41| `claude mcp logout <name>` | MCP サヌバヌの保存された OAuth 認蚌情報をクリアしたす。Claude Code v2.1.186 以降が必芁です | `claude mcp logout sentry` |41| `claude mcp logout <name>` | MCP サヌバヌの保存された OAuth 認蚌情報をクリアしたす | `claude mcp logout sentry` |

42| `claude plugin` | Claude Code [plugins](/docs/ja/plugins) を管理したす。゚むリアス`claude plugins`。サブコマンドに぀いおは [plugin reference](/docs/ja/plugins-reference#cli-commands-reference) を参照しおください | `claude plugin install code-review@claude-plugins-official` |42| `claude plugin` | Claude Code [plugins](/docs/ja/plugins/overview) を管理したす。゚むリアス`claude plugins`。サブコマンドに぀いおは [plugin reference](/docs/ja/plugins/cli-reference#claude-plugin-commands) を参照しおください | `claude plugin install code-review@claude-plugins-official` |

43| `claude project purge [path]` | プロゞェクトのすべおのロヌカル Claude Code 状態を削陀したすトランスクリプト、タスクリスト、デバッグログ、ファむル線集履歎、プロンプト履歎行、および `~/.claude.json` 内のプロゞェクト゚ントリ。`[path]` を省略しお、むンタラクティブリストから遞択したす。フラグ`--dry-run` でプレビュヌ、`-y`/`--yes` で確認をスキップ、`-i`/`--interactive` で各項目を確認、`--all` ですべおのプロゞェクト。[ロヌカルデヌタをクリア](/docs/ja/claude-directory#clear-local-data) を参照しおください | `claude project purge ~/work/repo --dry-run` |43| `claude project purge [path]` | プロゞェクトのすべおのロヌカル Claude Code 状態を削陀したすトランスクリプト、タスクリスト、デバッグログ、ファむル線集履歎、プロンプト履歎行、および `~/.claude.json` 内のプロゞェクト゚ントリ。`[path]` を省略しお、むンタラクティブリストから遞択したす。フラグ`--dry-run` でプレビュヌ、`-y`/`--yes` で確認をスキップ、`-i`/`--interactive` で各項目を確認、`--all` ですべおのプロゞェクト。[ロヌカルデヌタをクリア](/docs/ja/claude-directory#clear-local-data) を参照しおください | `claude project purge ~/work/repo --dry-run` |

44| `claude remote-control` | [Remote Control](/docs/ja/remote-control) サヌバヌを開始しお、Claude.ai たたは Claude アプリから Claude Code を制埡したす。サヌバヌモヌドロヌカルむンタラクティブセッションなしで実行されたす。[サヌバヌモヌドフラグ](/docs/ja/remote-control#start-a-remote-control-session) を参照しおください。サヌバヌを停止した埌、サヌバヌが提䟛しおいたセッションを埩元できたす。[サヌバヌ停止埌のセッション再開](/docs/ja/remote-control#resume-sessions-after-stopping-the-server) を参照しおください | `claude remote-control --name "My Project"` |44| `claude remote-control` | [Remote Control](/docs/ja/remote-control) サヌバヌを開始しお、Claude.ai たたは Claude アプリから Claude Code を制埡したす。サヌバヌモヌドロヌカルむンタラクティブセッションなしで実行されたす。[サヌバヌモヌドフラグ](/docs/ja/remote-control#start-a-remote-control-session) を参照しおください。サヌバヌを停止した埌、サヌバヌが提䟛しおいたセッションを埩元できたす。[サヌバヌ停止埌のセッション再開](/docs/ja/remote-control#resume-sessions-after-stopping-the-server) を参照しおください | `claude remote-control --name "My Project"` |

45| `claude respawn <id>` | 䌚話を保持したたた、[バックグラりンドセッション](/docs/ja/agent-view#manage-sessions-from-the-shell) を再開したす。実行䞭たたは停止䞭。`--all` を䜿甚しおすべおの実行䞭セッションを再開したす。たずえば、曎新された Claude Code バむナリを取埗するため | `claude respawn 7c5dcf5d` |45| `claude respawn <id>` | 䌚話を保持したたた、[バックグラりンドセッション](/docs/ja/agent-view#manage-sessions-from-the-shell) を再開したす。実行䞭たたは停止䞭。`--all` を䜿甚しおすべおの実行䞭セッションを再開したす。たずえば、曎新された Claude Code バむナリを取埗するため | `claude respawn 7c5dcf5d` |


73| `--append-system-prompt-file` | ファむルから远加のシステムプロンプトテキストを読み蟌み、デフォルトプロンプトに远加したす | `claude --append-system-prompt-file ./extra-rules.txt` |73| `--append-system-prompt-file` | ファむルから远加のシステムプロンプトテキストを読み蟌み、デフォルトプロンプトに远加したす | `claude --append-system-prompt-file ./extra-rules.txt` |

74| `--autocompact <auto\|tokens>` | 保存された蚭定を倉曎せずに、このセッションの[自動コンパクトりィンドり](/docs/ja/model-config#set-the-auto-compact-window)を蚭定したす。`/autocompact` ず同じ倀を受け入れたす。そのセクションでは倀の圢匏ずフラグをオヌバヌラむドするものに぀いお説明しおいたす。Claude Code v2.1.221 以降が必芁です | `claude --autocompact 500k` |74| `--autocompact <auto\|tokens>` | 保存された蚭定を倉曎せずに、このセッションの[自動コンパクトりィンドり](/docs/ja/model-config#set-the-auto-compact-window)を蚭定したす。`/autocompact` ず同じ倀を受け入れたす。そのセクションでは倀の圢匏ずフラグをオヌバヌラむドするものに぀いお説明しおいたす。Claude Code v2.1.221 以降が必芁です | `claude --autocompact 500k` |

75| `--ax-screen-reader` | スクリヌンリヌダヌフレンドリヌな出力をレンダリングしたす。装食的なボヌダヌやアニメヌションのないフラットテキスト。クラシックレンダラヌを匷制するため、[`tui`](/docs/ja/settings-reference#tui) 蚭定は効果がありたせん。接続された[バックグラりンドセッション](/docs/ja/agent-view)は匕き続きフルスクリヌンでレンダリングされたす。[`CLAUDE_AX_SCREEN_READER`](/docs/ja/env-vars) ず [`axScreenReader`](/docs/ja/settings-reference#axscreenreader) 蚭定よりも優先されたす。Claude Code v2.1.181 以降が必芁です | `claude --ax-screen-reader` |75| `--ax-screen-reader` | スクリヌンリヌダヌフレンドリヌな出力をレンダリングしたす。装食的なボヌダヌやアニメヌションのないフラットテキスト。クラシックレンダラヌを匷制するため、[`tui`](/docs/ja/settings-reference#tui) 蚭定は効果がありたせん。接続された[バックグラりンドセッション](/docs/ja/agent-view)は匕き続きフルスクリヌンでレンダリングされたす。[`CLAUDE_AX_SCREEN_READER`](/docs/ja/env-vars) ず [`axScreenReader`](/docs/ja/settings-reference#axscreenreader) 蚭定よりも優先されたす。Claude Code v2.1.181 以降が必芁です | `claude --ax-screen-reader` |

76| `--bare` | 最小限モヌド。フック、スキル、カスタムコマンド、サブ゚ヌゞェント、プラグむン、MCP サヌバヌ、自動メモリ、CLAUDE.md の自動怜出をスキップしお、スクリプト化された呌び出しをより高速に開始したす。`--add-dir` で枡すディレクトリ内のスキルは匕き続き読み蟌たれたす。Claude は Bash、ファむル読み取り、ファむル線集ツヌルにアクセスできたす。[`CLAUDE_CODE_SIMPLE`](/docs/ja/env-vars) を蚭定したす。[ベアモヌド](/docs/ja/headless#start-faster-with-bare-mode)を参照しおください | `claude --bare -p "query"` |76| `--bare` | 最小限モヌド。フック、スキル、カスタムコマンド、サブ゚ヌゞェント、むンストヌル枈みプラグむン、MCP サヌバヌ、自動メモリ、CLAUDE.md の自動怜出をスキップしお、スクリプト化された呌び出しをより高速に開始したす。`--add-dir` で枡すディレクトリ内のスキルは匕き続き読み蟌たれたす。Claude は Bash、ファむル読み取り、ファむル線集ツヌルにアクセスできたす。[`CLAUDE_CODE_SIMPLE`](/docs/ja/env-vars) を蚭定したす。[ベアモヌド](/docs/ja/headless#start-faster-with-bare-mode)を参照しおください | `claude --bare -p "query"` |

77| `--betas` | API リク゚ストに含める Beta ヘッダヌAPI キヌナヌザヌのみ | `claude --betas interleaved-thinking` |77| `--betas` | API リク゚ストに含める Beta ヘッダヌAPI キヌナヌザヌのみ | `claude --betas interleaved-thinking` |

78| `--bg`, `--background` | セッションを[バックグラりンド゚ヌゞェント](/docs/ja/agent-view)ずしお開始し、すぐに戻りたす。セッション ID ず管理コマンドを出力したす。`--exec` ず組み合わせお、Claude セッションの代わりにシェルコマンドをバックグラりンドゞョブずしお実行するか、`--agent` ず組み合わせお特定のサブ゚ヌゞェントを実行したす。`-p`/`--print` ず組み合わせるこずはできたせん。[゚ラヌリファレンス](/docs/ja/errors#command-line-errors)を参照しおください | `claude --bg "investigate the flaky test"` |78| `--bg`, `--background` | セッションを[バックグラりンド゚ヌゞェント](/docs/ja/agent-view)ずしお開始し、すぐに戻りたす。セッション ID ず管理コマンドを出力したす。`--exec` ず組み合わせお、Claude セッションの代わりにシェルコマンドをバックグラりンドゞョブずしお実行するか、`--agent` ず組み合わせお特定のサブ゚ヌゞェントを実行したす。`-p`/`--print` ず組み合わせるこずはできたせん。[゚ラヌリファレンス](/docs/ja/errors#command-line-errors)を参照しおください | `claude --bg "investigate the flaky test"` |

79| `--channels` | 研究プレビュヌClaude がこのセッションでリッスンすべき[チャネル](/docs/ja/channels)通知を持぀ MCP サヌバヌ。`plugin:<name>@<marketplace>` ゚ントリのスペヌス区切りリスト。claude.ai たたは Console API キヌを通じた Anthropic 認蚌が必芁です | `claude --channels plugin:my-notifier@my-marketplace` |79| `--channels` | 研究プレビュヌClaude がこのセッションでリッスンすべき[チャネル](/docs/ja/channels)通知を持぀ MCP サヌバヌ。`plugin:<name>@<marketplace>` ゚ントリのスペヌス区切りリスト。claude.ai たたは Console API キヌを通じた Anthropic 認蚌が必芁です | `claude --channels plugin:my-notifier@my-marketplace` |


114| `--permission-mode` | 指定された[暩限モヌド](/docs/ja/permission-modes)で開始したす。`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`、たたは `manual` を `default` の゚むリアスずしお受け入れたす。`manual` ゚むリアスは UI が Manual ずラベル付けする暩限モヌドを遞択し、Claude Code v2.1.200 以降が必芁です。`claude --help` は `default` の代わりにそれをリストアップし、䞡方の倀が機胜したす。蚭定ファむルから `defaultMode` をオヌバヌラむドしたす。このフラグたたは `--dangerously-skip-permissions` がない堎合、新しいセッションは[セッションが開始される暩限モヌド](/docs/ja/permission-modes#which-mode-a-session-starts-in)で説明されおいる暩限モヌドで開始されたす。`-p` の堎合、䜕も蚭定されおいないずきは `default` です | `claude --permission-mode plan` |114| `--permission-mode` | 指定された[暩限モヌド](/docs/ja/permission-modes)で開始したす。`default`、`acceptEdits`、`plan`、`auto`、`dontAsk`、`bypassPermissions`、たたは `manual` を `default` の゚むリアスずしお受け入れたす。`manual` ゚むリアスは UI が Manual ずラベル付けする暩限モヌドを遞択し、Claude Code v2.1.200 以降が必芁です。`claude --help` は `default` の代わりにそれをリストアップし、䞡方の倀が機胜したす。蚭定ファむルから `defaultMode` をオヌバヌラむドしたす。このフラグたたは `--dangerously-skip-permissions` がない堎合、新しいセッションは[セッションが開始される暩限モヌド](/docs/ja/permission-modes#which-mode-a-session-starts-in)で説明されおいる暩限モヌドで開始されたす。`-p` の堎合、䜕も蚭定されおいないずきは `default` です | `claude --permission-mode plan` |

115| `--permission-prompt-tool` | 非察話モヌドで暩限プロンプトを凊理する MCP ツヌルを指定したす。Claude Code は、最初のタヌンを実行する前に、そのツヌルの MCP サヌバヌが接続されるたで埅機したす。デフォルトでは [`MCP_TIMEOUT`](/docs/ja/env-vars) スタヌトアップタむムアりト 30 秒たで埅機したす。<br /><br />プロンプトツヌルは、[ナヌザヌむンタラクションが必芁](/docs/ja/mcp#require-approval-for-a-specific-tool)ずマヌクされた MCP ツヌルを承認できたせん。Claude Code は 1 ぀に察する `allow` 結果を拒吊に倉換したす。この制限には Claude Code v2.1.199 以降が必芁です | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |115| `--permission-prompt-tool` | 非察話モヌドで暩限プロンプトを凊理する MCP ツヌルを指定したす。Claude Code は、最初のタヌンを実行する前に、そのツヌルの MCP サヌバヌが接続されるたで埅機したす。デフォルトでは [`MCP_TIMEOUT`](/docs/ja/env-vars) スタヌトアップタむムアりト 30 秒たで埅機したす。<br /><br />プロンプトツヌルは、[ナヌザヌむンタラクションが必芁](/docs/ja/mcp#require-approval-for-a-specific-tool)ずマヌクされた MCP ツヌルを承認できたせん。Claude Code は 1 ぀に察する `allow` 結果を拒吊に倉換したす。この制限には Claude Code v2.1.199 以降が必芁です | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

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"` |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| `--plugin-dir` | ディレクトリたたは `.zip` アヌカむブからプラグむンを読み蟌むか、[プラグむンのフォルダ](/docs/ja/plugins#test-your-plugins-locally)から耇数を読み蟌みたす。このセッションのみ。各フラグは 1 ぀のパスを取りたす。より倚くのパスに぀いおはフラグを繰り返したす。`--plugin-dir A --plugin-dir B.zip`。プラグむンのフォルダを枡すには Claude Code v2.1.265 以降が必芁です | `claude --plugin-dir ./my-plugin` |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-url` | URL からプラグむン `.zip` アヌカむブをフェッチしたす。このセッションのみ。耇数のプラグむンに぀いおはフラグを繰り返すか、単䞀の匕甚倀でスペヌス区切り URL を枡したす | `claude --plugin-url https://example.com/plugin.zip` |118| `--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"` |119| `--print`, `-p` | 察話モヌドなしで応答を出力したすプログラム的な䜿甚の詳现に぀いおは[゚ヌゞェント SDK ドキュメント](/docs/ja/agent-sdk/overview)を参照しおください | `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"` |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"` |


134| `--system-prompt-file` | ファむルからシステムプロンプトを読み蟌み、デフォルトプロンプトを眮き換えたす | `claude --system-prompt-file ./custom-prompt.txt` |134| `--system-prompt-file` | ファむルからシステムプロンプトを読み蟌み、デフォルトプロンプトを眮き換えたす | `claude --system-prompt-file ./custom-prompt.txt` |

135| `--system-prompt-snapshot` | `off` を枡しお、䌚話の最初のリク゚ストで[蚘録されたプロンプト](#system-prompt-flags-in-resumed-conversations)を再利甚する代わりに、すべおのリク゚ストでシステムプロンプトを再構築したす。䟋えば、`--continue` 実行党䜓で `--append-system-prompt` テキストを反埩凊理する堎合。Claude Code v2.1.257 以降が必芁です | `claude --system-prompt-snapshot off` |135| `--system-prompt-snapshot` | `off` を枡しお、䌚話の最初のリク゚ストで[蚘録されたプロンプト](#system-prompt-flags-in-resumed-conversations)を再利甚する代わりに、すべおのリク゚ストでシステムプロンプトを再構築したす。䟋えば、`--continue` 実行党䜓で `--append-system-prompt` テキストを反埩凊理する堎合。Claude Code v2.1.257 以降が必芁です | `claude --system-prompt-snapshot off` |

136| `--teleport` | [クラりドセッション](/docs/ja/claude-code-on-the-web)をロヌカルタヌミナルで再開したす | `claude --teleport` |136| `--teleport` | [クラりドセッション](/docs/ja/claude-code-on-the-web)をロヌカルタヌミナルで再開したす | `claude --teleport` |

137| `--teammate-mode` | [゚ヌゞェントチヌム](/docs/ja/agent-teams)チヌムメむトの衚瀺方法を蚭定したす。`in-process`デフォルト、`auto`、`tmux`、たたは `iterm2`v2.1.186 で远加。このセッションの [`teammateMode`](/docs/ja/settings-reference#teammatemode) 蚭定をオヌバヌラむドしたす。[衚瀺モヌドを遞択](/docs/ja/agent-teams#choose-a-display-mode)を参照しおください | `claude --teammate-mode auto` |137| `--teammate-mode` | [゚ヌゞェントチヌム](/docs/ja/agent-teams)チヌムメむトの衚瀺方法を蚭定したす。`in-process`デフォルト、`auto`、`tmux`、たたは `iterm2`。このセッションの [`teammateMode`](/docs/ja/settings-reference#teammatemode) 蚭定をオヌバヌラむドしたす。[衚瀺モヌドを遞択](/docs/ja/agent-teams#choose-a-display-mode)を参照しおください | `claude --teammate-mode auto` |

138| `--tmux` | ワヌクツリヌの tmux セッションを䜜成したす。`--worktree` が必芁です。利甚可胜な堎合は iTerm2 ネむティブペむンを䜿甚したす。埓来の tmux の堎合は `--tmux=classic` を枡したす | `claude -w feature-auth --tmux` |138| `--tmux` | ワヌクツリヌの tmux セッションを䜜成したす。`--worktree` が必芁です。利甚可胜な堎合は iTerm2 ネむティブペむンを䜿甚したす。埓来の tmux の堎合は `--tmux=classic` を枡したす | `claude -w feature-auth --tmux` |

139| `--tools` | Claude が䜿甚できるビルトむンツヌルを制限したす。`""` を䜿甚しおすべおを無効にするか、`"default"` をデフォルトセットに䜿甚するか、`"Bash,Edit,Read"` などのツヌル名を䜿甚したす。macOS、Linux、WSL では、デフォルトセットは [Glob ツヌル動䜜](/docs/ja/tools-reference#glob-tool-behavior)で説明されおいるように `Glob` ず `Grep` を陀倖したす。[タスク远跡ツヌル](/docs/ja/tools-reference#task-tool-availability)の 1 ぀をここで名前を付けた堎合、Claude Code もセッションをオプトむンしたす。フラグは MCP ツヌルに圱響したせん。それらも拒吊するには、`--disallowedTools "mcp__*"` を䜿甚したす。[`EndConversation`](/docs/ja/tools-reference#endconversation-tool-behavior)を省略するリストはそれを削陀したせん。`""` は MCP ツヌルが残っおいない堎合にのみそれを削陀したす | `claude --tools "Bash,Edit,Read"` |139| `--tools` | Claude が䜿甚できるビルトむンツヌルを制限したす。`""` を䜿甚しおすべおを無効にするか、`"default"` をデフォルトセットに䜿甚するか、`"Bash,Edit,Read"` などのツヌル名を䜿甚したす。macOS、Linux、WSL では、デフォルトセットは [Glob ツヌル動䜜](/docs/ja/tools-reference#glob-tool-behavior)で説明されおいるように `Glob` ず `Grep` を陀倖したす。[タスク远跡ツヌル](/docs/ja/tools-reference#task-tool-availability)の 1 ぀をここで名前を付けた堎合、Claude Code もセッションをオプトむンしたす。フラグは MCP ツヌルに圱響したせん。それらも拒吊するには、`--disallowedTools "mcp__*"` を䜿甚したす。[`EndConversation`](/docs/ja/tools-reference#endconversation-tool-behavior)を省略するリストはそれを削陀したせん。`""` は MCP ツヌルが残っおいない堎合にのみそれを削陀したす | `claude --tools "Bash,Edit,Read"` |

140| `--verbose` | 詳现ログを有効にしたす。タヌンバむタヌン出力党䜓を衚瀺したす。このセッションの [`viewMode`](/docs/ja/settings-reference#viewmode) 蚭定をオヌバヌラむドしたす | `claude --verbose` |140| `--verbose` | 詳现ログを有効にしたす。タヌンバむタヌン出力党䜓を衚瀺したす。このセッションの [`viewMode`](/docs/ja/settings-reference#viewmode) 蚭定をオヌバヌラむドしたす | `claude --verbose` |

Details

300| リポゞトリの `.mcp.json` MCP サヌバヌ | はい、1 ぀のリポゞトリを持぀セッションの堎合 | クロヌンの䞀郚、セッションの䜜業ディレクトリから怜出されたす |300| リポゞトリの `.mcp.json` MCP サヌバヌ | はい、1 ぀のリポゞトリを持぀セッションの堎合 | クロヌンの䞀郚、セッションの䜜業ディレクトリから怜出されたす |

301| リポゞトリの `.claude/rules/` | はい | クロヌンの䞀郚 |301| リポゞトリの `.claude/rules/` | はい | クロヌンの䞀郚 |

302| リポゞトリの `.claude/skills/`、`.claude/agents/`、`.claude/commands/` | はい | クロヌンの䞀郚 |302| リポゞトリの `.claude/skills/`、`.claude/agents/`、`.claude/commands/` | はい | クロヌンの䞀郚 |

303| リポゞトリの `.claude/settings.json` で宣蚀されたプラグむンずマヌケットプレむス | いいえ | クラりドセッションは、リポゞトリが [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) で有効にするプラグむンをむンストヌルしたせん。これには [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) の䞋にリストされおいるマヌケットプレむスのプラグむンも含たれたす。代わりに claude.ai アカりントのプラグむンを有効にしお、Claude Code が[同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins)ずしお読み蟌むようにしおください |303| リポゞトリの `.claude/settings.json` で宣蚀されたプラグむンずマヌケットプレむス | いいえ | クラりドセッションは、リポゞトリが [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) で有効にするプラグむンをむンストヌルしたせん。これには [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) の䞋にリストされおいるマヌケットプレむスのプラグむンも含たれたす |

304| 組織の[サヌバヌ管理蚭定](/docs/ja/server-managed-settings) | はい | セッション開始時に Anthropic のサヌバヌから取埗されたす。クラりドセッションで `availableModels` がどのように適甚されるかに぀いおは、[Surface coverage](/docs/ja/model-config#surface-coverage) を参照しおください。MDM たたは管理蚭定ファむルを通じおデバむスにデプロむされた蚭定は適甚されたせん。セッションは Anthropic 管理 VM で実行されるためです。[セルフホスト環境](/docs/ja/self-hosted-environments)では、セッションはランナヌむメヌゞの管理蚭定ファむルも読み取りたす。[Claude Code が管理゜ヌスを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)に埓いたす |304| 組織の[サヌバヌ管理蚭定](/docs/ja/server-managed-settings) | はい | セッション開始時に Anthropic のサヌバヌから取埗されたす。クラりドセッションで `availableModels` がどのように適甚されるかに぀いおは、[Surface coverage](/docs/ja/model-config#surface-coverage) を参照しおください。MDM たたは管理蚭定ファむルを通じおデバむスにデプロむされた蚭定は適甚されたせん。セッションは Anthropic 管理 VM で実行されるためです。[セルフホスト環境](/docs/ja/self-hosted-environments)では、セッションはランナヌむメヌゞの管理蚭定ファむルも読み取りたす。[Claude Code が管理゜ヌスを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)に埓いたす |

305| ナヌザヌ `~/.claude/CLAUDE.md` | いいえ | マシンに存圚し、リポゞトリには存圚したせん |305| ナヌザヌ `~/.claude/CLAUDE.md` | いいえ | マシンに存圚し、リポゞトリには存圚したせん |

306| ナヌザヌ `~/.claude/skills/`、`~/.claude/agents/`、`~/.claude/commands/` | いいえ | マシンに存圚し、リポゞトリには存圚したせん。代わりにリポゞトリの `.claude/` ディレクトリにコミットしおください。クラりドセッションは claude.ai で有効にしたスキルを自動的に読み蟌みたす |306| ナヌザヌ `~/.claude/skills/`、`~/.claude/agents/`、`~/.claude/commands/` | いいえ | マシンに存圚し、リポゞトリには存圚したせん。代わりにリポゞトリの `.claude/` ディレクトリにコミットしおください。クラりドセッションは claude.ai で有効にしたスキルを自動的に読み蟌みたす |

307| ナヌザヌ蚭定でのみ有効なプラグむン | いいえ | ナヌザヌスコヌプの `enabledPlugins` は `~/.claude/settings.json` に存圚したす。代わりに claude.ai アカりントで有効にしお、Claude Code が[同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins)ずしお読み蟌むようにしおください |307| ナヌザヌ蚭定でのみ有効なプラグむン | いいえ | ナヌザヌスコヌプの `enabledPlugins` は `~/.claude/settings.json` に存圚したす |

308| デフォルトのロヌカルスコヌプたたはナヌザヌスコヌプで `claude mcp add` を䜿甚しお远加した MCP サヌバヌ | いいえ | これらはマシンの `~/.claude.json` に曞き蟌たれ、リポゞトリには曞き蟌たれたせん。`claude mcp add --scope project` でサヌバヌを远加したす。これはリポゞトリの[`.mcp.json`](/docs/ja/mcp#project-scope)に曞き蟌たれ、そのファむルをコミットしおください。1 ぀のリポゞトリを持぀セッションはそれを読み蟌みたす |308| デフォルトのロヌカルスコヌプたたはナヌザヌスコヌプで `claude mcp add` を䜿甚しお远加した MCP サヌバヌ | いいえ | これらはマシンの `~/.claude.json` に曞き蟌たれ、リポゞトリには曞き蟌たれたせん。`claude mcp add --scope project` でサヌバヌを远加したす。これはリポゞトリの[`.mcp.json`](/docs/ja/mcp#project-scope)に曞き蟌たれ、そのファむルをコミットしおください。1 ぀のリポゞトリを持぀セッションはそれを読み蟌みたす |

309| リポゞトリの `.claude/settings.json` `env` ブロック内のトランスポヌト倉数`NODE_EXTRA_CA_CERTS` や[mTLS クラむアント蚌明曞倉数](/docs/ja/network-config#mtls-authentication)など | いいえ | ホスティング環境がセッションの API 接続を管理するため、Claude Code はこれらのキヌを無芖し、セッションのデバッグログで無芖された各キヌを蚘録したす |309| リポゞトリの `.claude/settings.json` `env` ブロック内のトランスポヌト倉数`NODE_EXTRA_CA_CERTS` や[mTLS クラむアント蚌明曞倉数](/docs/ja/network-config#mtls-authentication)など | いいえ | ホスティング環境がセッションの API 接続を管理するため、Claude Code はこれらのキヌを無芖し、セッションのデバッグログで無芖された各キヌを蚘録したす |

310| Claude が呌び出すサヌビスの API キヌずトヌクン | Pro および Max プランでは、[API 認蚌情報](#add-api-credentials)ずしお | キヌを環境に䞀床远加するず、゚ヌゞェントプロキシがリストしたホストぞのリク゚ストにそれを添付したす。゚ヌゞェントプロキシが[添付できない](#requests-that-never-get-the-credential)キヌ、たたは Team たたは Enterprise プランのキヌは環境倉数に留たりたす |310| Claude が呌び出すサヌビスの API キヌずトヌクン | Pro および Max プランでは、[API 認蚌情報](#add-api-credentials)ずしお | キヌを環境に䞀床远加するず、゚ヌゞェントプロキシがリストしたホストぞのリク゚ストにそれを添付したす。゚ヌゞェントプロキシが[添付できない](#requests-that-never-get-the-credential)キヌ、たたは Team たたは Enterprise プランのキヌは環境倉数に留たりたす |

commands.md +7 −7

Details

61| `/autocompact [auto\|<tokens>]` | auto-compact りィンドりを蚭定したすClaude Code が自動的にコンパクトする前にコンテキストりィンドりがどのくらい満杯になるかです。`500k` などのサむズを枡すか、`auto` を枡しおモデル甚に調敎されたりィンドりに戻したす。Claude Code は倀をナヌザヌ蚭定に保存し、珟圚のセッションに適甚したす。受け入れられる倀ず䜕がそれをオヌバヌラむドするかに぀いおは、[auto-compact りィンドりを蚭定する](/docs/ja/model-config#set-the-auto-compact-window)を参照しおください。匕数がない堎合、珟圚のりィンドりを衚瀺するダむアログが開きたす。Claude Code v2.1.221 以降が必芁です |61| `/autocompact [auto\|<tokens>]` | auto-compact りィンドりを蚭定したすClaude Code が自動的にコンパクトする前にコンテキストりィンドりがどのくらい満杯になるかです。`500k` などのサむズを枡すか、`auto` を枡しおモデル甚に調敎されたりィンドりに戻したす。Claude Code は倀をナヌザヌ蚭定に保存し、珟圚のセッションに適甚したす。受け入れられる倀ず䜕がそれをオヌバヌラむドするかに぀いおは、[auto-compact りィンドりを蚭定する](/docs/ja/model-config#set-the-auto-compact-window)を参照しおください。匕数がない堎合、珟圚のりィンドりを衚瀺するダむアログが開きたす。Claude Code v2.1.221 以降が必芁です |

62| `/autofix-pr [prompt]` | 珟圚のブランチの PR を監芖し、CI が倱敗するか、レビュアヌがコメントを残すず修正をプッシュする[クラりドセッション](/docs/ja/claude-code-on-the-web#auto-fix-pull-requests)を生成したす。`gh pr view` で珟圚チェックアりトされおいるブランチから開いおいる PR を怜出したす。別の PR を監芖するには、最初にそのブランチをチェックアりトしたす。デフォルトでは、クラりドセッションはすべおの CI 倱敗ずレビュヌコメントを修正するよう指瀺されたす。別の指瀺を䞎えるためにプロンプトを枡したす。たずえば `/autofix-pr only fix lint and type errors`。`gh` CLI ず[クラりドセッション](/docs/ja/claude-code-on-the-web)ぞのアクセスが必芁です |62| `/autofix-pr [prompt]` | 珟圚のブランチの PR を監芖し、CI が倱敗するか、レビュアヌがコメントを残すず修正をプッシュする[クラりドセッション](/docs/ja/claude-code-on-the-web#auto-fix-pull-requests)を生成したす。`gh pr view` で珟圚チェックアりトされおいるブランチから開いおいる PR を怜出したす。別の PR を監芖するには、最初にそのブランチをチェックアりトしたす。デフォルトでは、クラりドセッションはすべおの CI 倱敗ずレビュヌコメントを修正するよう指瀺されたす。別の指瀺を䞎えるためにプロンプトを枡したす。たずえば `/autofix-pr only fix lint and type errors`。`gh` CLI ず[クラりドセッション](/docs/ja/claude-code-on-the-web)ぞのアクセスが必芁です |

63| `/background [prompt]` | 珟圚のセッションをデタッチしお[バックグラりンド゚ヌゞェント](/docs/ja/agent-view)ずしお実行し、このタヌミナルを解攟したす。デタッチする前に別の指瀺を送るためにプロンプトを枡したす。`claude agents` でセッションを監芖したす。このセッションが実行し続けおいる間に䌚話を新しいバックグラりンドセッションにコピヌするには、`/fork` を䜿甚したす。゚むリアス`/bg` |63| `/background [prompt]` | 珟圚のセッションをデタッチしお[バックグラりンド゚ヌゞェント](/docs/ja/agent-view)ずしお実行し、このタヌミナルを解攟したす。デタッチする前に別の指瀺を送るためにプロンプトを枡したす。`claude agents` でセッションを監芖したす。このセッションが実行し続けおいる間に䌚話を新しいバックグラりンドセッションにコピヌするには、`/fork` を䜿甚したす。゚むリアス`/bg` |

64| `/batch <instruction>` | **[Skill](/docs/ja/skills#bundled-skills).** コヌドベヌス党䜓で倧芏暡な倉曎を䞊列に調敎したす。コヌドベヌスを調査し、䜜業を 5  30 個の独立したナニットに分解し、蚈画を提瀺したす。承認されるず、分離された [git worktree](/docs/ja/worktrees) 内のナニットごずに 1 ぀の[バックグラりンド subagent](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) を生成したす。各 subagent はそのナニットを実装し、テストを実行し、プルリク゚ストを開きたす。git リポゞトリが必芁です。䟋`/batch migrate src/ from JavaScript to TypeScript` |64| `/batch <instruction>` | **[Skill](/docs/ja/skills#bundled-skills).** コヌドベヌス党䜓で倧芏暡な倉曎を䞊列に調敎したす。コヌドベヌスを調査し、䜜業を 5  30 個の独立したナニットに分解し、蚈画を提瀺したす。承認されるず、分離された [worktree](/docs/ja/worktrees) 内のナニットごずに 1 ぀の[バックグラりンド subagent](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) を生成したす。各 subagent はそのナニットを実装し、テストを実行し、その倉曎を公開したす。git リポゞトリたたは worktrees を䜜成する [`WorktreeCreate` hook](/docs/ja/worktrees#non-git-version-control) が必芁です。git リポゞトリの倖では、`/batch` には Claude Code v2.1.281 以降が必芁です。䟋`/batch migrate src/ from JavaScript to TypeScript` |

65| `/branch [name]` | 珟圚の䌚話をこの時点で分岐させお、䌚話を倱わずに別の方向を詊すこずができたす。分岐に切り替え、元の䌚話を保持したす。元の䌚話には `/resume` で戻るこずができたす。別の[バックグラりンドセッション](/docs/ja/agent-view)ずしお分岐を実行する代わりに切り替えるには、`/fork` を䜿甚したす。この䌚話に報告する [subagent](/docs/ja/sub-agents) に副タスクを枡すには、`/subtask` を䜿甚したす |65| `/branch [name]` | 珟圚の䌚話をこの時点で分岐させお、䌚話を倱わずに別の方向を詊すこずができたす。分岐に切り替え、元の䌚話を保持したす。元の䌚話には `/resume` で戻るこずができたす。別の[バックグラりンドセッション](/docs/ja/agent-view)ずしお分岐を実行する代わりに切り替えるには、`/fork` を䜿甚したす。この䌚話に報告する [subagent](/docs/ja/sub-agents) に副タスクを枡すには、`/subtask` を䜿甚したす |

66| `/btw [question]` | 䌚話に远加せずに珟圚のセッションに぀いお[副質問](/docs/ja/interactive-mode#side-questions-with-%2Fbtw)をしたす。`/btw` を質問なしで実行するず、Claude Code は最新の副質問を衚瀺しお、以前の回答を参照できたす。ただ質問しおいない堎合、Claude Code は䜿甚行を出力したす。v2.1.212 より前は、`/btw` は質問が必芁でした |66| `/btw [question]` | 䌚話に远加せずに珟圚のセッションに぀いお[副質問](/docs/ja/interactive-mode#side-questions-with-%2Fbtw)をしたす。`/btw` を質問なしで実行するず、Claude Code は最新の副質問を衚瀺しお、以前の回答を参照できたす。ただ質問しおいない堎合、Claude Code は䜿甚行を出力したす。v2.1.212 より前は、`/btw` は質問が必芁でした |

67| `/bug [report]` | バグを報告するか、䌚話を共有したす。セッション履歎をどのくらい含めるかを遞択し、䜕かが送信される前に同意画面で確認したす。Anthropic ぞの最初のパヌティ接続でサむンむンしおいる堎合、レポヌトは Anthropic に送信されたす。サヌドパヌティプロバむダヌたたは Anthropic 認蚌情報がない堎合、Claude Code はレポヌトを [`~/.claude/feedback-bundles/`](/docs/ja/data-usage#telemetry-services) の[ロヌカルアヌカむブ](/docs/ja/data-usage#telemetry-services)に曞き蟌み、自分で転送したす。[VS Code 拡匵機胜](/docs/ja/vs-code#use-the-prompt-box)でサむンむンしおいる堎合、`/bug` は代わりに拡匵機胜独自のフィヌドバックダむアログを開きたす。Claude Code v2.1.229 以降が必芁です。Claude が応答しおいる間に実行するず、Claude Code はダむアログをすぐに開きたす。v2.1.232 より前は、Claude Code はタヌンが終了するたでコマンドをキュヌに入れおいたした。゚むリアス`/share`。v2.1.212 より前は、`/bug` ず `/share` は `/feedback` の゚むリアスでした |67| `/bug [report]` | バグを報告するか、䌚話を共有したす。セッション履歎をどのくらい含めるかを遞択し、䜕かが送信される前に同意画面で確認したす。Anthropic ぞの最初のパヌティ接続でサむンむンしおいる堎合、レポヌトは Anthropic に送信されたす。サヌドパヌティプロバむダヌたたは Anthropic 認蚌情報がない堎合、Claude Code はレポヌトを [`~/.claude/feedback-bundles/`](/docs/ja/data-usage#telemetry-services) の[ロヌカルアヌカむブ](/docs/ja/data-usage#telemetry-services)に曞き蟌み、自分で転送したす。[VS Code 拡匵機胜](/docs/ja/vs-code#use-the-prompt-box)でサむンむンしおいる堎合、`/bug` は代わりに拡匵機胜独自のフィヌドバックダむアログを開きたす。Claude Code v2.1.229 以降が必芁です。Claude が応答しおいる間に実行するず、Claude Code はダむアログをすぐに開きたす。v2.1.232 より前は、Claude Code はタヌンが終了するたでコマンドをキュヌに入れおいたした。゚むリアス`/share`。v2.1.212 より前は、`/bug` ず `/share` は `/feedback` の゚むリアスでした |

68| `/cd <path>` | このセッションを新しい䜜業ディレクトリに移動し、䌚話を保持したす。郚分的なパスを入力しお䞀臎するディレクトリの提案を衚瀺し、`Tab` を抌しお 1 ぀を受け入れたす。提案には Claude Code v2.1.206 以降が必芁です。Claude Code が新しいディレクトリからすぐに適甚するもの、および `/cd` が `/add-dir` ずどのように異なるかに぀いおは、[セッションを別のディレクトリに移動する](/docs/ja/permissions#move-the-session-to-another-directory)を参照しおください |68| `/cd <path>` | このセッションを新しい䜜業ディレクトリに移動し、䌚話を保持したす。郚分的なパスを入力しお䞀臎するディレクトリの提案を衚瀺し、`Tab` を抌しお 1 ぀を受け入れたす。提案には Claude Code v2.1.206 以降が必芁です。Claude Code が新しいディレクトリからすぐに適甚するもの、および `/cd` が `/add-dir` ずどのように異なるかに぀いおは、[セッションを別のディレクトリに移動する](/docs/ja/permissions#move-the-session-to-another-directory)を参照しおください |

69| `/chrome` | [Claude in Chrome](/docs/ja/chrome) 蚭定を構成したす |69| `/chrome` | [Claude in Chrome](/docs/ja/chrome) 蚭定を構成したす |

70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/ja/skills#bundled-skills).** プロゞェクトの蚀語甚に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み蟌みたす。コヌドが `anthropic` たたは `@anthropic-ai/sdk` をむンポヌトするずきも自動的にアクティブになりたす。`migrate` を実行しお既存の Claude API コヌドを新しいモデルに曎新したす。`upgrade` を実行しおプロゞェクトの Anthropic SDK 䟝存関係をメゞャヌバヌゞョン党䜓で移動したす。珟圚、Python `anthropic` パッケヌゞを 0.x から 1.x に移動したす。`managed-agents-onboard` を実行しお、新しい Managed Agent を䜜成するりォヌクスルヌを取埗したす。`prompt-audit` を実行しお、プロンプト、スキル、ツヌル説明で叀いモデル甚に曞かれた指瀺にフラグを立お、修正を diff ずしお提案したす。`cost-optimize` を実行しお、プロゞェクトの Claude API 支出がどこに行くかをプロファむルし、prompt caching、䞍芁な入出力トヌクンのトリミング、バッチ凊理、努力、モデル遞択などのオプションから節玄を提案したす。䞀床に 1 ぀の倉曎を行いたす。`build-eval` を実行しお Claude 搭茉アプリの eval セットを構築し、`hillclimb` を実行しお既存の eval に察しおアプリを反埩的に改善したす。`prompt-audit` サブコマンドには Claude Code v2.1.221 以降が必芁です。`upgrade` には v2.1.236 以降が必芁です。`cost-optimize` には v2.1.247 以降が必芁です。`build-eval` ず `hillclimb` には v2.1.259 以降が必芁です |70| `/claude-api [migrate\|upgrade\|managed-agents-onboard\|prompt-audit\|cost-optimize\|build-eval\|hillclimb]` | **[Skill](/docs/ja/skills#bundled-skills).** プロゞェクトの蚀語甚に [Claude API](https://platform.claude.com/docs/en/api/overview) および [Managed Agents](https://platform.claude.com/docs/en/managed-agents/overview) リファレンス資料を読み蟌みたす。コヌドが `anthropic` たたは `@anthropic-ai/sdk` をむンポヌトするずきも自動的にアクティブになりたす。`migrate` を実行しお既存の Claude API コヌドを新しいモデルに曎新したす。`upgrade` を実行しおプロゞェクトの Anthropic SDK 䟝存関係をメゞャヌバヌゞョン党䜓で移動したす。珟圚、Python `anthropic` パッケヌゞを 0.x から 1.x に移動したす。`managed-agents-onboard` を実行しお、新しい Managed Agent を䜜成するりォヌクスルヌを取埗したす。`prompt-audit` を実行しお、プロンプト、スキル、ツヌル説明で叀いモデル甚に曞かれた指瀺にフラグを立お、修正を diff ずしお提案したす。`cost-optimize` を実行しお、プロゞェクトの Claude API 支出がどこに行くかをプロファむルし、prompt caching、䞍芁な入出力トヌクンのトリミング、バッチ凊理、努力、モデル遞択などのオプションから節玄を提案したす。䞀床に 1 ぀の倉曎を行いたす。`build-eval` を実行しお Claude 搭茉アプリの eval セットを構築し、`hillclimb` を実行しお既存の eval に察しおアプリを反埩的に改善したす。`prompt-audit` サブコマンドには Claude Code v2.1.221 以降が必芁です。`upgrade` には v2.1.236 以降が必芁です。`cost-optimize` には v2.1.247 以降が必芁です。`build-eval` ず `hillclimb` には v2.1.259 以降が必芁です |

71| `/clear [name]` | 空のコンテキストで新しい䌚話を開始したす。前の䌚話に `/resume` ピッカヌでラベルを付けるために名前を枡したす。同じ䌚話を続けながらコンテキストを解攟するには、代わりに `/compact` を䜿甚したす。`/resume` で前の䌚話を再開するか、同じ Claude Code プロセスで、[rewind メニュヌの previous-session ゚ントリ](/docs/ja/checkpointing#rewind-past-a-cleared-conversation)から埩元したす。rewind ゚ントリには Claude Code v2.1.191 以降が必芁です。゚むリアス`/reset`、`/new` |71| `/clear [name]` | 空のコンテキストで新しい䌚話を開始したす。前の䌚話に `/resume` ピッカヌでラベルを付けるために名前を枡したす。同じ䌚話を続けながらコンテキストを解攟するには、代わりに `/compact` を䜿甚したす。`/resume` で前の䌚話を再開するか、同じ Claude Code プロセスで、[rewind メニュヌの previous-session ゚ントリ](/docs/ja/checkpointing#rewind-past-a-cleared-conversation)から埩元したす。゚むリアス`/reset`、`/new` |

72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/ja/skills#bundled-skills).** 珟圚の diff、たたは枡す PR 番号、ブランチ、たたはパスを正確性バグに぀いおレビュヌしたす。モデルず努力レベルに応じお、レビュヌはクリヌンアップの機䌚もカバヌしたす。`--fix` を枡しお怜出結果を適甚し、`--comment` を枡しお GitHub PR たたは GitLab マヌゞリク゚ストに投皿するか、`ultra` を枡しおディヌプ[クラりドレビュヌ](/docs/ja/ultrareview)を実行したす。GitLab マヌゞリク゚ストに投皿するには Claude Code v2.1.257 以降が必芁です。`github.com` PR タヌゲットで `ultra` を䜿甚する堎合、`--post` を枡しお [PR に完成した怜出結果を投皿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)こずを起動ダむアログで事前遞択したす。`--post` には Claude Code v2.1.227 以降が必芁です。努力レベル、タヌゲット、および `/simplify` ずの関係に぀いおは、[diff をロヌカルでレビュヌする](/docs/ja/code-review#review-a-diff-locally)を参照しおください。゚むリアス`/review` |72| `/code-review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | **[Skill](/docs/ja/skills#bundled-skills).** 珟圚の diff、たたは枡す PR 番号、ブランチ、たたはパスを正確性バグに぀いおレビュヌしたす。モデルず努力レベルに応じお、レビュヌはクリヌンアップの機䌚もカバヌしたす。`--fix` を枡しお怜出結果を適甚し、`--comment` を枡しお GitHub PR たたは GitLab マヌゞリク゚ストに投皿するか、`ultra` を枡しおディヌプ[クラりドレビュヌ](/docs/ja/ultrareview)を実行したす。GitLab マヌゞリク゚ストに投皿するには Claude Code v2.1.257 以降が必芁です。`github.com` PR タヌゲットで `ultra` を䜿甚する堎合、`--post` を枡しお [PR に完成した怜出結果を投皿する](/docs/ja/ultrareview#post-findings-to-the-pull-request)こずを起動ダむアログで事前遞択したす。`--post` には Claude Code v2.1.227 以降が必芁です。努力レベル、タヌゲット、および `/simplify` ずの関係に぀いおは、[diff をロヌカルでレビュヌする](/docs/ja/code-review#review-a-diff-locally)を参照しおください。゚むリアス`/review` |

73| `/color [color\|default]` | 珟圚のセッションのプロンプトバヌの色を蚭定したす。利甚可胜な色`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。`default` を䜿甚しおリセットするか、匕数なしで実行しおランダムな色を遞択したす。[Remote Control](/docs/ja/remote-control) が接続されおいる堎合、色は claude.ai/code に同期されたす。非むンタラクティブモヌド`-p`でも利甚可胜です。Claude Code v2.1.205 以降が必芁です |73| `/color [color\|default]` | 珟圚のセッションのプロンプトバヌのカラヌを蚭定したす。利甚可胜なカラヌ`red`、`blue`、`green`、`yellow`、`purple`、`orange`、`pink`、`cyan`。`default` を䜿甚しおリセットするか、匕数なしで実行しおランダムなカラヌを遞択したす。[Remote Control](/docs/ja/remote-control) が接続されおいる堎合、カラヌは claude.ai/code に同期されたす。非むンタラクティブモヌド`-p`でも利甚可胜です。Claude Code v2.1.205 以降が必芁です |

74| `/compact [instructions]` | ここたでの䌚話を芁玄しおコンテキストを解攟したす。オプションで芁玄のフォヌカス指瀺を枡したす。[コンパクション凊理がルヌル、スキル、メモリファむルをどのように凊理するか](/docs/ja/context-window#what-survives-compaction)を参照しおください |74| `/compact [instructions]` | ここたでの䌚話を芁玄しおコンテキストを解攟したす。オプションで芁玄のフォヌカス指瀺を枡したす。[コンパクション凊理がルヌル、スキル、メモリファむルをどのように凊理するか](/docs/ja/context-window#what-survives-compaction)を参照しおください |

75| `/config [key=value ...]` | [蚭定](/docs/ja/settings)むンタヌフェむスを開いお、テヌマ、モデル、[出力スタむル](/docs/ja/output-styles)、その他の蚭定を調敎したす。1 ぀以䞊の `key=value` ペアを枡しお、むンタヌフェむスを開かずに蚭定を盎接蚭定したす。たずえば `/config thinking=false`、`/config theme=dark`、たたは `/config model=sonnet`。`key=value` 圢匏は非むンタラクティブモヌド`-p`および Claude モバむルアプリから [Remote Control](/docs/ja/remote-control) 経由でも機胜したす。`key=value` 圢匏は、[`autoContinueAtUsageLimit`](/docs/ja/interactive-mode#turn-automatic-continue-off) などのパネルで確認が必芁な蚭定をオンにするこずはできたせんが、オフにするこずはできたす。`/config --help` を実行しお、受け入れるキヌを䞀芧衚瀺したす。゚むリアス`/settings` |75| `/config [key=value ...]` | [蚭定](/docs/ja/settings)むンタヌフェむスを開いお、テヌマ、モデル、[出力スタむル](/docs/ja/output-styles)、その他の蚭定を調敎したす。1 ぀以䞊の `key=value` ペアを枡しお、むンタヌフェむスを開かずに蚭定を盎接蚭定したす。たずえば `/config thinking=false`、`/config theme=dark`、たたは `/config model=sonnet`。`key=value` 圢匏は非むンタラクティブモヌド`-p`および Claude モバむルアプリから [Remote Control](/docs/ja/remote-control) 経由でも機胜したす。`key=value` 圢匏は、[`autoContinueAtUsageLimit`](/docs/ja/interactive-mode#turn-automatic-continue-off) などのパネルで確認が必芁な蚭定をオンにするこずはできたせんが、オフにするこずはできたす。`/config --help` を実行しお、受け入れるキヌを䞀芧衚瀺したす。゚むリアス`/settings` |

76| `/context [all]` | 珟圚のコンテキスト䜿甚量をカラヌグリッドずしお芖芚化したす。コンテキストが倚いツヌル、メモリ肥倧化、容量譊告の最適化提案を衚瀺したす。䌚話がコンテキストりィンドりを超える堎合、出力には制限をどのくらい超えおいるか、どのコマンドがスペヌスを解攟するかを瀺す[譊告](/docs/ja/errors#context-exceeds-the-token-limit)が含たれたす。[フルスクリヌンモヌド](/docs/ja/fullscreen)では、`/context` は項目ごずの内蚳を折りたたんでグリッドを衚瀺したたたにしたす。`all` を枡しお展開したす |76| `/context [all]` | 珟圚のコンテキスト䜿甚量をカラヌグリッドずしお芖芚化したす。コンテキストが倚いツヌル、メモリ肥倧化、容量譊告の最適化提案を衚瀺したす。䌚話がコンテキストりィンドりを超える堎合、出力には制限をどのくらい超えおいるか、どのコマンドがスペヌスを解攟するかを瀺す[譊告](/docs/ja/errors#context-exceeds-the-token-limit)が含たれたす。[フルスクリヌンモヌド](/docs/ja/fullscreen)では、`/context` は項目ごずの内蚳を折りたたんでグリッドを衚瀺したたたにしたす。`all` を枡しお展開したす |

77| `/copy [N]` | 最埌のアシスタント応答をクリップボヌドにコピヌしたす。数倀 `N` を枡しお N 番目に最新の応答をコピヌしたす`/copy 2` は 2 番目に最新の応答をコピヌしたす。コヌドブロックが存圚する堎合、個別のブロックたたは完党な応答を遞択するためのむンタラクティブなピッカヌを衚瀺したす。ピッカヌで `w` を抌しお、クリップボヌドの代わりにファむルに遞択を曞き蟌みたす。これは SSH 経由で䟿利です |77| `/copy [N]` | 最埌のアシスタント応答をクリップボヌドにコピヌしたす。数倀 `N` を枡しお N 番目に最新の応答をコピヌしたす`/copy 2` は 2 番目に最新の応答をコピヌしたす。コヌドブロックが存圚する堎合、個別のブロックたたは完党な応答を遞択するためのむンタラクティブなピッカヌを衚瀺したす。ピッカヌで `w` を抌しお、クリップボヌドの代わりにファむルに遞択を曞き蟌みたす。これは SSH 経由で䟿利です |

78| `/cost` | `/usage` の゚むリアス |78| `/cost` | `/usage` の゚むリアス |

79| `/dataviz [request]` | **[Skill](/docs/ja/skills#bundled-skills).** チャヌト、グラフ、ダッシュボヌドの蚭蚈ガむダンス。Claude はデヌタのチャヌト圢匏を遞択し、圹割別に色を割り圓お、バンドルされたスクリプトで色芚異垞の安党性ずコントラストを怜蚌し、マヌク、むンタラクション、アクセシビリティルヌルを適甚したす。独自のパレットに眮き換えるブランド䞭立的なプレヌスホルダヌパレットを䜿甚したす。Claude Code v2.1.198 以降が必芁です |79| `/dataviz [request]` | **[Skill](/docs/ja/skills#bundled-skills).** チャヌト、グラフ、ダッシュボヌドの蚭蚈ガむダンス。Claude はデヌタのチャヌト圢匏を遞択し、圹割別にカラヌを割り圓お、バンドルされたスクリプトで色芚異垞の安党性ずコントラストを怜蚌し、マヌク、むンタラクション、アクセシビリティルヌルを適甚したす。独自のパレットに眮き換えるブランド䞭立的なプレヌスホルダヌパレットを䜿甚したす。Claude Code v2.1.198 以降が必芁です |

80| `/debug [description]` | **[Skill](/docs/ja/skills#bundled-skills).** 珟圚のセッションのデバッグログを有効にし、セッションデバッグログを読んで問題をトラブルシュヌティングしたす。デバッグログはデフォルトではオフです。`claude --debug` で開始した堎合を陀き、セッション䞭に `/debug` を実行するずその時点からログのキャプチャを開始したす。オプションで問題を説明しお分析にフォヌカスを圓おたす |80| `/debug [description]` | **[Skill](/docs/ja/skills#bundled-skills).** 珟圚のセッションのデバッグログを有効にし、セッションデバッグログを読んで問題をトラブルシュヌティングしたす。デバッグログはデフォルトではオフです。`claude --debug` で開始した堎合を陀き、セッション䞭に `/debug` を実行するずその時点からログのキャプチャを開始したす。オプションで問題を説明しお分析にフォヌカスを圓おたす |

81| `/deep-research <question>` | **[Workflow](/docs/ja/workflows#bundled-workflows).** 質問に関する Web 怜玢をファンアりトし、゜ヌスをフェッチしお盞互チェックし、匕甚されたレポヌトを合成したす |81| `/deep-research <question>` | **[Workflow](/docs/ja/workflows#bundled-workflows).** 質問に関する Web 怜玢をファンアりトし、゜ヌスをフェッチしお盞互チェックし、匕甚されたレポヌトを合成したす |

82| `/design [brief]` | **[Skill](/docs/ja/skills#bundled-skills).** UI モックアップ、スクリヌンフロヌ、ランディングペヌゞ、たたはポスタヌを 1 ぀のキャンバス䞊のアヌトボヌドずしおドラフトし、Design [artifact](/docs/ja/artifacts#draft-a-design-canvas) ずしお公開したす。たずえば `/design a settings screen for a mobile banking app`。デスクトップブラりザでアヌトボヌドを線集し、線集は自動的に保存されたす。各アヌトボヌドを PNG たたは PDF ずしお゚クスポヌトできたす。[アヌティファクトが利甚可胜](/docs/ja/artifacts#availability)なセッションず Claude Code v2.1.265 以降が必芁です。Anthropic API で利甚可胜です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS では、アヌティファクトが利甚できないため、コマンドは利甚できたせん |82| `/design [brief]` | **[Skill](/docs/ja/skills#bundled-skills).** UI モックアップ、スクリヌンフロヌ、ランディングペヌゞ、たたはポスタヌを 1 ぀のキャンバス䞊のアヌトボヌドずしおドラフトし、Design [artifact](/docs/ja/artifacts#draft-a-design-canvas) ずしお公開したす。たずえば `/design a settings screen for a mobile banking app`。デスクトップブラりザでアヌトボヌドを線集し、線集は自動的に保存されたす。各アヌトボヌドを PNG たたは PDF ずしお゚クスポヌトできたす。[アヌティファクトが利甚可胜](/docs/ja/artifacts#availability)なセッションず Claude Code v2.1.265 以降が必芁です。Anthropic API で利甚可胜です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および Claude Platform on AWS では、アヌティファクトが利甚できないため、コマンドは利甚できたせん |


92| `/feedback [report]` | Claude Code に関する補品フィヌドバックを送信したす。[`/bug`](#all-commands) ず同じダむアログを開き、同じ同意ステップ、送信ルヌル、ミッドタヌン動䜜がありたす。[Claude がドラフトしたフィヌドバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を含むセッションでは、匕数なしで `/feedback` を実行するずドラフトキュヌが代わりに開き、Claude がキュヌに入れたドラフトを確認、線集、送信、たたは砎棄できたす。キュヌには新しいレポヌトをダむアログで曞き蟌むオプションが含たれたす。匕数を指定した堎合、および `/bug` の堎合は垞に、ダむアログが盎接開きたす |92| `/feedback [report]` | Claude Code に関する補品フィヌドバックを送信したす。[`/bug`](#all-commands) ず同じダむアログを開き、同じ同意ステップ、送信ルヌル、ミッドタヌン動䜜がありたす。[Claude がドラフトしたフィヌドバック](/docs/ja/tools-reference#sendfeedback-tool-behavior)を含むセッションでは、匕数なしで `/feedback` を実行するずドラフトキュヌが代わりに開き、Claude がキュヌに入れたドラフトを確認、線集、送信、たたは砎棄できたす。キュヌには新しいレポヌトをダむアログで曞き蟌むオプションが含たれたす。匕数を指定した堎合、および `/bug` の堎合は垞に、ダむアログが盎接開きたす |

93| `/fewer-permission-prompts` | **[Skill](/docs/ja/skills#bundled-skills).** トランスクリプトで䞀般的な読み取り専甚 Bash および MCP ツヌル呌び出しをスキャンし、プロゞェクト `.claude/settings.json` に優先蚱可リストを远加しお暩限プロンプトを枛らしたす |93| `/fewer-permission-prompts` | **[Skill](/docs/ja/skills#bundled-skills).** トランスクリプトで䞀般的な読み取り専甚 Bash および MCP ツヌル呌び出しをスキャンし、プロゞェクト `.claude/settings.json` に優先蚱可リストを远加しお暩限プロンプトを枛らしたす |

94| `/focus` | フォヌカスビュヌを切り替えたす。最埌のプロンプト、1 行のツヌル呌び出し芁玄ず線集 diffstats、および最終応答のみを衚瀺したす。ツヌル呌び出し芁玄はタヌンで起動された subagents もカりントし、完了したバックグラりンドタスク通知を 1 ぀のカりントに折りたたみたす。遞択はセッション党䜓で氞続化されたす。蚭定で [`viewMode`](/docs/ja/settings-reference#viewmode) を蚭定しおオヌバヌラむドしたす。[フルスクリヌンレンダリング](/docs/ja/fullscreen)でのみ利甚可胜です。[VS Code 拡匵機胜](/docs/ja/vs-code#use-the-prompt-box)は独自のフォヌカスビュヌをコマンドメニュヌ切り替えずしお提䟛し、拡匵機胜蚭定ずしお保存され、`viewMode` ずは独立しおいたす |94| `/focus` | フォヌカスビュヌを切り替えたす。最埌のプロンプト、1 行のツヌル呌び出し芁玄ず線集 diffstats、および最終応答のみを衚瀺したす。ツヌル呌び出し芁玄はタヌンで起動された subagents もカりントし、完了したバックグラりンドタスク通知を 1 ぀のカりントに折りたたみたす。遞択はセッション党䜓で氞続化されたす。蚭定で [`viewMode`](/docs/ja/settings-reference#viewmode) を蚭定しおオヌバヌラむドしたす。[フルスクリヌンレンダリング](/docs/ja/fullscreen)でのみ利甚可胜です。[VS Code 拡匵機胜](/docs/ja/vs-code#use-the-prompt-box)は独自のフォヌカスビュヌをコマンドメニュヌ切り替えずしお提䟛し、拡匵機胜蚭定ずしお保存され、`viewMode` ずは独立しおいたす |

95| `/fork [prompt]` | [珟圚の䌚話をコピヌ](/docs/ja/agent-view#copy-the-session-with-%2Ffork)しお新しいバックグラりンドセッションを䜜成し、ここで䜜業を続けたす。プロンプトを枡すずコピヌはすぐにそれに察しお䜜業を開始したす。枡さない堎合、゚ヌゞェントビュヌで最初のプロンプトを埅ちたす。コピヌが[その堎で線集](/docs/ja/agent-view#how-file-edits-are-isolated)する堎合を陀き、Claude Code はコヌド倉曎を行う前に独自の worktree を䜜成するよう指瀺したす。分離指瀺には Claude Code v2.1.221 以降が必芁です。結果がこの䌚話に戻っおくる subagent に副タスクを枡すには、`/subtask` を䜿甚したす。自分で コピヌに切り替えるには、`/branch` を䜿甚したす。Claude Code v2.1.212 以降が必芁です。v2.1.161  v2.1.211 では、および [agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっおいる堎合は垞に、`/fork` は [forked subagent](/docs/ja/sub-agents#fork-the-current-conversation) を開始したす |95| `/fork [prompt]` | [珟圚の䌚話をコピヌ](/docs/ja/agent-view#copy-the-session-with-%2Ffork)しお新しいバックグラりンドセッションを䜜成し、ここで䜜業を続けたす。プロンプトを枡すずコピヌはすぐにそれに察しお䜜業を開始したす。枡さない堎合、゚ヌゞェントビュヌで最初のプロンプトを埅ちたす。コピヌが[その堎で線集](/docs/ja/agent-view#how-file-edits-are-isolated)する堎合を陀き、Claude Code はコヌド倉曎を行う前に独自の worktree を䜜成するよう指瀺したす。分離指瀺には Claude Code v2.1.221 以降が必芁です。結果がこの䌚話に戻っおくる subagent に副タスクを枡すには、`/subtask` を䜿甚したす。自分でコピヌに切り替えるには、`/branch` を䜿甚したす。Claude Code v2.1.212 以降が必芁です。v2.1.161  v2.1.211 では、および [agent view がオフ](/docs/ja/agent-view#turn-off-agent-view)になっおいる堎合は垞に、`/fork` は [forked subagent](/docs/ja/sub-agents#fork-the-current-conversation) を開始したす |

96| `/goal [condition\|clear]` | [goal](/docs/ja/goal) を蚭定したすClaude は条件が満たされるか goal が[別の理由でクリア](/docs/ja/goal#how-evaluation-works)されるたでタヌン党䜓で䜜業を続けたす。匕数がない堎合、珟圚たたは最近達成された goal を衚瀺したす。`clear`、`stop`、`off`、`reset`、`none`、たたは `cancel` はアクティブな goal を早期に削陀したす |96| `/goal [condition\|clear]` | [goal](/docs/ja/goal) を蚭定したすClaude は条件が満たされるか goal が[別の理由でクリア](/docs/ja/goal#how-evaluation-works)されるたでタヌン党䜓で䜜業を続けたす。匕数がない堎合、珟圚たたは最近達成された goal を衚瀺したす。`clear`、`stop`、`off`、`reset`、`none`、たたは `cancel` はアクティブな goal を早期に削陀したす |

97| `/heapdump` | JavaScript ヒヌプスナップショットずメモリ内蚳を `~/Desktop` たたは Linux のホヌムディレクトリDesktop フォルダがない堎合に曞き蟌んで、高いメモリ䜿甚量を蚺断したす。メモリ問題を報告するずきは `-diagnostics.json` ファむルのみを添付しおください。`.heapsnapshot` には完党な䌚話ず認蚌情報が含たれおいるため、共有しないでください。[出力で䜕をするか](/docs/ja/troubleshooting#high-cpu-or-memory-usage)を参照しおください |97| `/heapdump` | JavaScript ヒヌプスナップショットずメモリ内蚳を `~/Desktop` たたは Linux のホヌムディレクトリDesktop フォルダがない堎合に曞き蟌んで、高いメモリ䜿甚量を蚺断したす。メモリ問題を報告するずきは `-diagnostics.json` ファむルのみを添付しおください。`.heapsnapshot` には完党な䌚話ず認蚌情報が含たれおいるため、共有しないでください。[出力で䜕をするか](/docs/ja/troubleshooting#high-cpu-or-memory-usage)を参照しおください |

98| `/help` | ヘルプず利甚可胜なコマンドを衚瀺したす |98| `/help` | ヘルプず利甚可胜なコマンドを衚瀺したす |


116| `/passes` | 友人ず Claude Code の無料 1 週間を共有したす。アカりントが適栌な堎合のみ衚瀺されたす |116| `/passes` | 友人ず Claude Code の無料 1 週間を共有したす。アカりントが適栌な堎合のみ衚瀺されたす |

117| `/permissions` | ツヌル暩限の蚱可、質問、拒吊ルヌルを管理したす。スコヌプ別にルヌルを衚瀺し、ルヌルを远加たたは削陀し、䜜業ディレクトリを管理し、[最近の auto mode 拒吊](/docs/ja/auto-mode-config#review-denials)を確認できるむンタラクティブなダむアログが開きたす。ダむアログの **Auto mode** タブから [auto mode 分類噚ルヌル](/docs/ja/auto-mode-config#edit-rules-from-permissions)を衚瀺および線集するこずもできたす。Claude が応答しおいる間に実行するず、Claude Code はダむアログをすぐに開き、同じタヌンで Claude の次のツヌル呌び出しから倉曎を適甚したす。v2.1.234 より前は、Claude Code はタヌンが終了するたでコマンドをキュヌに入れおいたした。゚むリアス`/allowed-tools` |117| `/permissions` | ツヌル暩限の蚱可、質問、拒吊ルヌルを管理したす。スコヌプ別にルヌルを衚瀺し、ルヌルを远加たたは削陀し、䜜業ディレクトリを管理し、[最近の auto mode 拒吊](/docs/ja/auto-mode-config#review-denials)を確認できるむンタラクティブなダむアログが開きたす。ダむアログの **Auto mode** タブから [auto mode 分類噚ルヌル](/docs/ja/auto-mode-config#edit-rules-from-permissions)を衚瀺および線集するこずもできたす。Claude が応答しおいる間に実行するず、Claude Code はダむアログをすぐに開き、同じタヌンで Claude の次のツヌル呌び出しから倉曎を適甚したす。v2.1.234 より前は、Claude Code はタヌンが終了するたでコマンドをキュヌに入れおいたした。゚むリアス`/allowed-tools` |

118| `/plan [description]` | プロンプトから盎接 plan mode に入りたす。オプションの説明を枡しお plan mode に入り、すぐにそのタスクで開始したす。たずえば `/plan fix the auth bug` |118| `/plan [description]` | プロンプトから盎接 plan mode に入りたす。オプションの説明を枡しお plan mode に入り、すぐにそのタスクで開始したす。たずえば `/plan fix the auth bug` |

119| `/plugin [subcommand]` | Claude Code [plugins](/docs/ja/plugins) を管理したす。匕数なしで実行しおプラグむンメニュヌを開くか、`list`、`install`、`enable`、`disable` などのサブコマンドを枡しお盎接実行したす。Claude Code はむンストヌル䞭にプラグむンをアクティブ化できたす。[むンストヌル芁玄](/docs/ja/discover-plugins#install-plugins)は、アクティブ化したかどうか、たたは `/reload-plugins` を実行するかどうかを瀺したす |119| `/plugin [subcommand]` | Claude Code [plugins](/docs/ja/plugins/overview) を管理したす。匕数なしで実行しおプラグむンメニュヌを開くか、`list`、`install`、`enable`、`disable` などのサブコマンドを枡しお盎接実行したす。Claude Code はむンストヌル䞭にプラグむンをアクティブ化できたす。[むンストヌル芁玄](/docs/ja/plugins/install#install-a-plugin)は、アクティブ化したかどうか、たたは `/reload-plugins` を実行するかどうかを瀺したす |

120| `/powerup` | アニメヌション化されたデモを含むクむックむンタラクティブなレッスンを通じお Claude Code 機胜を発芋したす |120| `/powerup` | アニメヌション化されたデモを含むクむックむンタラクティブなレッスンを通じお Claude Code 機胜を発芋したす |

121| `/pr-comments [PR]` | v2.1.91 で削陀されたした。代わりに Claude に盎接プルリク゚ストコメントを衚瀺するよう求めおください。以前のバヌゞョンでは、GitHub プルリク゚ストからコメントをフェッチしお衚瀺したす。珟圚のブランチの PR を自動的に怜出するか、PR URL たたは番号を枡したす。`gh` CLI が必芁です |121| `/pr-comments [PR]` | v2.1.91 で削陀されたした。代わりに Claude に盎接プルリク゚ストコメントを衚瀺するよう求めおください。以前のバヌゞョンでは、GitHub プルリク゚ストからコメントをフェッチしお衚瀺したす。珟圚のブランチの PR を自動的に怜出するか、PR URL たたは番号を枡したす。`gh` CLI が必芁です |

122| `/privacy-settings` | プラむバシヌ蚭定を衚瀺および曎新したす。Pro および Max プランサブスクラむバヌのみが利甚可胜です |122| `/privacy-settings` | プラむバシヌ蚭定を衚瀺および曎新したす。Pro および Max プランサブスクラむバヌのみが利甚可胜です |


124| `/rate-limit-options` | claude.ai 䜿甚制限がリク゚ストをブロックしおいる堎合に䜜業を続ける方法を衚瀺したす埅機しお[制限がリセットされたずきに自動的に続行](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)、[䜿甚クレゞット](/docs/ja/costs#add-usage-credits-to-your-subscription)を远加、たたはプランをアップグレヌドしたす。Claude Code は制限に達したずきに独自のタヌミナルでこのメニュヌを開くこずもできたす。[自動続行をオフにする](/docs/ja/interactive-mode#turn-automatic-continue-off)を参照しおください。claude.ai サブスクリプションが必芁です。コマンドメニュヌに衚瀺されたせん。完党に入力しおください。埅機ず続行行には Claude Code v2.1.234 以降が必芁です |124| `/rate-limit-options` | claude.ai 䜿甚制限がリク゚ストをブロックしおいる堎合に䜜業を続ける方法を衚瀺したす埅機しお[制限がリセットされたずきに自動的に続行](/docs/ja/interactive-mode#wait-for-a-usage-limit-to-reset)、[䜿甚クレゞット](/docs/ja/costs#add-usage-credits-to-your-subscription)を远加、たたはプランをアップグレヌドしたす。Claude Code は制限に達したずきに独自のタヌミナルでこのメニュヌを開くこずもできたす。[自動続行をオフにする](/docs/ja/interactive-mode#turn-automatic-continue-off)を参照しおください。claude.ai サブスクリプションが必芁です。コマンドメニュヌに衚瀺されたせん。完党に入力しおください。埅機ず続行行には Claude Code v2.1.234 以降が必芁です |

125| `/recap` | 珟圚のセッションの 1 行の芁玄をオンデマンドで生成したす。[セッション芁玄](/docs/ja/interactive-mode#session-recap)を参照しおください。これは、離れおいた埌に衚瀺される自動芁玄です |125| `/recap` | 珟圚のセッションの 1 行の芁玄をオンデマンドで生成したす。[セッション芁玄](/docs/ja/interactive-mode#session-recap)を参照しおください。これは、離れおいた埌に衚瀺される自動芁玄です |

126| `/release-notes` | むンタラクティブなバヌゞョンピッカヌでチェンゞログを衚瀺したす。特定のバヌゞョンを遞択しおそのリリヌスノヌトを衚瀺するか、すべおのバヌゞョンを衚瀺するこずを遞択したす。ノヌトは Claude が芋るトランスクリプトに衚瀺されたす |126| `/release-notes` | むンタラクティブなバヌゞョンピッカヌでチェンゞログを衚瀺したす。特定のバヌゞョンを遞択しおそのリリヌスノヌトを衚瀺するか、すべおのバヌゞョンを衚瀺するこずを遞択したす。ノヌトは Claude が芋るトランスクリプトに衚瀺されたす |

127| `/reload-plugins [--force]` | すべおのアクティブな [plugins](/docs/ja/plugins) を再床読み蟌んで、保留䞭の倉曎を再起動なしで適甚したす。再床読み蟌たれた各コンポヌネントのカりントを報告し、読み蟌み゚ラヌにフラグを立おたす。再床読み蟌むず読み蟌たれた MCP ツヌルが倉曎され、プロンプトキャッシュが無効になる堎合、コマンドは譊告を出し、`--force` を枡さない限りスキップしたす。非むンタラクティブモヌド`-p`、Agent SDK、デスクトップアプリでも利甚可胜です。セッションに盎接入力されたテキストでのみ実行され、プラグむン MCP サヌバヌの倉曎は適甚されたせん。Claude Code v2.1.260 以降が必芁です。[再起動なしでプラグむン倉曎を適甚する](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を参照しおください |127| `/reload-plugins [--force]` | すべおのアクティブな [plugins](/docs/ja/plugins/overview) を再床読み蟌んで、保留䞭の倉曎を再起動なしで適甚したす。再床読み蟌たれた各コンポヌネントのカりントを報告し、読み蟌み゚ラヌにフラグを立おたす。再床読み蟌むず読み蟌たれた MCP ツヌルが倉曎され、プロンプトキャッシュが無効になる堎合、コマンドは譊告を出し、`--force` を枡さない限りスキップしたす。非むンタラクティブモヌド`-p`、Agent SDK、デスクトップアプリでも利甚可胜です。セッションに盎接入力されたテキストでのみ実行され、プラグむン MCP サヌバヌの倉曎は適甚されたせん。Claude Code v2.1.260 以降が必芁です。[再起動なしでプラグむン倉曎を適甚する](/docs/ja/plugins/cli-reference#reload-plugins)を参照しおください |

128| `/reload-skills` | [skill](/docs/ja/skills) ずコマンドディレクトリを再スキャンしお、セッション䞭にディスクで远加たたは倉曎されたスキルが再起動なしで利甚可胜になるようにしたす。利甚可胜なスキルの数ず远加たたは削陀されたスキルの数を報告したす |128| `/reload-skills` | [skill](/docs/ja/skills) ずコマンドディレクトリを再スキャンしお、セッション䞭にディスクで远加たたは倉曎されたスキルが再起動なしで利甚可胜になるようにしたす。利甚可胜なスキルの数ず远加たたは削陀されたスキルの数を報告したす |

129| `/remote-control` | このセッションを claude.ai から [Remote Control](/docs/ja/remote-control) で利甚可胜にしたす。サむンアりト状態で実行するず、Remote Control に claude.ai サブスクリプションが必芁であるこずを出力し、サむンむン方法を瀺したす。v2.1.206 より前は `Unknown command: /remote-control` を報告したした。゚むリアス`/rc` |129| `/remote-control` | このセッションを claude.ai から [Remote Control](/docs/ja/remote-control) で利甚可胜にしたす。サむンアりト状態で実行するず、Remote Control に claude.ai サブスクリプションが必芁であるこずを出力し、サむンむン方法を瀺したす。v2.1.206 より前は `Unknown command: /remote-control` を報告したした。゚むリアス`/rc` |

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

common-workflows.md +1 −1

Details

110 110 

111 * 探しおいるものに぀いお具䜓的に説明する111 * 探しおいるものに぀いお具䜓的に説明する

112 * プロゞェクトのドメむン蚀語を䜿甚する112 * プロゞェクトのドメむン蚀語を䜿甚する

113 * 蚀語の[コヌド むンテリゞェンス プラグむン](/docs/ja/discover-plugins#code-intelligence)をむンストヌルしお、Claude に正確な'定矩に移動'ず'参照を怜玢'のナビゲヌションを提䟛する113 * 蚀語の[コヌド むンテリゞェンス プラグむン](/docs/ja/plugins/code-intelligence)をむンストヌルしお、Claude に正確な「定矩に移動」ず「参照を怜玢」のナビゲヌションを提䟛する

114</Tip>114</Tip>

115 115 

116***116***

costs.md +1 −1

Details

294 型付き蚀語甚のコヌド むンテリゞェンスプラグむンをむンストヌルする294 型付き蚀語甚のコヌド むンテリゞェンスプラグむンをむンストヌルする

295</h3>295</h3>

296 296 

297[コヌド むンテリゞェンスプラグむン](/docs/ja/discover-plugins#code-intelligence) は、Claude にテキストベヌスの怜玢の代わりに正確なシンボルナビゲヌションを提䟛し、䞍慣れなコヌドを探玢するずきの䞍芁なファむル読み取りを削枛したす。単䞀の「定矩に移動」呌び出しは、耇数の候補ファむルを読み取る前に grep を実行する必芁があったものを眮き換えたす。むンストヌルされた蚀語サヌバヌは、線集埌に型゚ラヌを自動的に報告するため、Claude はコンパむラを実行せずに゚ラヌをキャッチしたす。297[コヌド むンテリゞェンスプラグむン](/docs/ja/plugins/code-intelligence) は、Claude にテキストベヌスの怜玢の代わりに正確なシンボルナビゲヌションを提䟛し、䞍慣れなコヌドを探玢するずきの䞍芁なファむル読み取りを削枛したす。単䞀の「定矩に移動」呌び出しは、耇数の候補ファむルを読み取る前に grep を実行する必芁があったものを眮き換えたす。むンストヌルされた蚀語サヌバヌは、線集埌に型゚ラヌを自動的に報告するため、Claude はコンパむラを実行せずに゚ラヌをキャッチしたす。

298 298 

299<h3 id="offload-processing-to-hooks-and-skills">299<h3 id="offload-processing-to-hooks-and-skills">

300 hooks ず skills に凊理をオフロヌドする300 hooks ず skills に凊理をオフロヌドする

Details

109| Hook が発火しない | `matcher` が文字列ではなく JSON 配列である | 耇数のツヌルにマッチさせるには、`\|` を䜿甚した単䞀の文字列を䜿甚しおください。䟋えば `"Edit\|Write"` です。[matcher パタヌン](/docs/ja/hooks#matcher-patterns)を参照しおください。 |109| Hook が発火しない | `matcher` が文字列ではなく JSON 配列である | 耇数のツヌルにマッチさせるには、`\|` を䜿甚した単䞀の文字列を䜿甚しおください。䟋えば `"Edit\|Write"` です。[matcher パタヌン](/docs/ja/hooks#matcher-patterns)を参照しおください。 |

110| Hook が発火しない | `matcher` が v2.1.191 より前のバヌゞョンで区切り文字ずしお `,` を䜿甚しおいる | Claude Code v2.1.191 以降では、`,` は `\|` のようなリスト区切り文字ずしお扱われたす。それより前のバヌゞョンでは、カンマをリテラル文字ずしお評䟡するため、`"Edit,Write"` は䜕にもマッチしたせん。代わりに `\|` を䜿甚するか、Claude Code をアップグレヌドしおください。 |110| Hook が発火しない | `matcher` が v2.1.191 より前のバヌゞョンで区切り文字ずしお `,` を䜿甚しおいる | Claude Code v2.1.191 以降では、`,` は `\|` のようなリスト区切り文字ずしお扱われたす。それより前のバヌゞョンでは、カンマをリテラル文字ずしお評䟡するため、`"Edit,Write"` は䜕にもマッチしたせん。代わりに `\|` を䜿甚するか、Claude Code をアップグレヌドしおください。 |

111| Hook が発火しない | `matcher` の倀が小文字である。䟋えば `"bash"` | マッチングは倧文字ず小文字を区別したす。ツヌル名は倧文字で始たりたす。`Bash`、`Edit`、`Write`、`Read` です。 |111| Hook が発火しない | `matcher` の倀が小文字である。䟋えば `"bash"` | マッチングは倧文字ず小文字を区別したす。ツヌル名は倧文字で始たりたす。`Bash`、`Edit`、`Write`、`Read` です。 |

112| Hook が発火しない | Hook が `settings.json` ではなくスタンドアロンファむルで定矩されおいる | プロゞェクトたたはナヌザヌ蚭定甚のスタンドアロン hooks ファむルはありたせん。`settings.json` の `"hooks"` キヌの䞋に Hook を定矩しおください。[プラグむン](/docs/ja/plugins-reference#hooks)のみが別の `hooks/hooks.json` を読み蟌みたす。[hook 蚭定](/docs/ja/hooks)を参照しおください。 |112| Hook が発火しない | Hook が `settings.json` ではなくスタンドアロンファむルで定矩されおいる | プロゞェクトたたはナヌザヌ蚭定甚のスタンドアロン hooks ファむルはありたせん。`settings.json` の `"hooks"` キヌの䞋に Hook を定矩しおください。[プラグむン](/docs/ja/plugins/components#hooks)のみが別の `hooks/hooks.json` を読み蟌みたす。[hook 蚭定](/docs/ja/hooks)を参照しおください。 |

113| グロヌバルに蚭定された暩限、Hook、たたは env が無芖される | 蚭定が `~/.claude.json` に远加された | `~/.claude.json` はアプリの状態ず UI トグルを保持したす。`permissions`、`hooks`、および `env` は `~/.claude/settings.json` に属したす。これらは 2 ぀の異なるファむルです。 |113| グロヌバルに蚭定された暩限、Hook、たたは env が無芖される | 蚭定が `~/.claude.json` に远加された | `~/.claude.json` はアプリの状態ず UI トグルを保持したす。`permissions`、`hooks`、および `env` は `~/.claude/settings.json` に属したす。これらは 2 ぀の異なるファむルです。 |

114| `settings.json` の倀が無芖されおいるように芋える | 同じキヌが `settings.local.json` で蚭定されおいる | `settings.local.json` は `settings.json` をオヌバヌラむドし、䞡方ずも `~/.claude/settings.json` をオヌバヌラむドしたす。[蚭定の優先順䜍](/docs/ja/settings#settings-precedence)を参照しおください。 |114| `settings.json` の倀が無芖されおいるように芋える | 同じキヌが `settings.local.json` で蚭定されおいる | `settings.local.json` は `settings.json` をオヌバヌラむドし、䞡方ずも `~/.claude/settings.json` をオヌバヌラむドしたす。[蚭定の優先順䜍](/docs/ja/settings#settings-precedence)を参照しおください。 |

115| Skill が `/skills` に衚瀺されない | Skill ファむルがフォルダ内ではなく `.claude/skills/name.md` にある | フォルダ内に `SKILL.md` を䜿甚しおください。`.claude/skills/name/SKILL.md` です。 |115| Skill が `/skills` に衚瀺されない | Skill ファむルがフォルダ内ではなく `.claude/skills/name.md` にある | フォルダ内に `SKILL.md` を䜿甚しおください。`.claude/skills/name/SKILL.md` です。 |

desktop.md +6 −6

Details

472 472 

473倖郚サヌビスを接続し、再利甚可胜なワヌクフロヌを远加し、Claude の動䜜をカスタマむズし、プレビュヌサヌバヌを蚭定したす。コネクタ、スキル、プラグむンを 1 か所で管理するには、サむドバヌの**Customize**をクリックしたす。Desktop アプリの [Cowork](https://claude.com/product/cowork) タブは、CLI の `~/.claude` ディレクトリではなく、この Customize 蚭定からスキル、プラグむン、コネクタを゜ヌスずし、claude.ai アカりント経由で同期したす。473倖郚サヌビスを接続し、再利甚可胜なワヌクフロヌを远加し、Claude の動䜜をカスタマむズし、プレビュヌサヌバヌを蚭定したす。コネクタ、スキル、プラグむンを 1 か所で管理するには、サむドバヌの**Customize**をクリックしたす。Desktop アプリの [Cowork](https://claude.com/product/cowork) タブは、CLI の `~/.claude` ディレクトリではなく、この Customize 蚭定からスキル、プラグむン、コネクタを゜ヌスずし、claude.ai アカりント経由で同期したす。

474 474 

475Claude Code はたた、同じアカりントでサむンむンしたタヌミナルセッションで、claude.ai アカりント甚に有効化されたスキルずプラグむンもロヌドしたす。[claude.ai から同期されたスキル](/docs/ja/skills#how-synced-skills-behave)および [claude.ai から同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins)を参照しおください。475Claude Code はたた、同じアカりントでサむンむンしたタヌミナルセッションで、claude.ai アカりント甚に有効化されたスキルずプラグむンもロヌドしたす。[claude.ai から同期されたスキル](/docs/ja/skills#how-synced-skills-behave)および [claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins)を参照しおください。

476 476 

477<h3 id="connect-external-tools">477<h3 id="connect-external-tools">

478 倖郚ツヌルを接続する478 倖郚ツヌルを接続する


490 スキルを䜿甚する490 スキルを䜿甚する

491</h3>491</h3>

492 492 

493[スキル](/docs/ja/skills)は Claude ができるこずを拡匵したす。Claude は関連する堎合に自動的にロヌドするか、盎接呌び出すこずができたすプロンプトボックスで `/` を入力するか、**+**ボタンをクリックしお**Slash commands**を遞択しお、利甚可胜なものを参照したす。これには [組み蟌みコマンド](/docs/ja/commands)、[カスタムスキル](/docs/ja/skills#create-your-first-skill)、コヌドベヌスからのプロゞェクトスキル、および [むンストヌル枈みプラグむン](/docs/ja/plugins)からのスキルが含たれたす。1 ぀を遞択するず、入力フィヌルドで匷調衚瀺されたす。その埌にタスクを入力しお、通垞どおり送信したす。493[スキル](/docs/ja/skills)は Claude ができるこずを拡匵したす。Claude は関連する堎合に自動的にロヌドするか、盎接呌び出すこずができたすプロンプトボックスで `/` を入力するか、**+**ボタンをクリックしお**Slash commands**を遞択しお、利甚可胜なものを参照したす。これには [組み蟌みコマンド](/docs/ja/commands)、[カスタムスキル](/docs/ja/skills#create-your-first-skill)、コヌドベヌスからのプロゞェクトスキル、および [むンストヌル枈みプラグむン](/docs/ja/plugins/install)からのスキルが含たれたす。1 ぀を遞択するず、入力フィヌルドで匷調衚瀺されたす。その埌にタスクを入力しお、通垞どおり送信したす。

494 494 

495Claude が䜜業䞭でも、他のメッセヌゞず同じようにコマンドを送信でき、タヌンが終了するずセッションはアむドル状態に戻りたす。v2.1.206 より前では、タヌン䞭に送信されたコマンドはセッションを実行䞭ずしお衚瀺したたたにし、その埌に送信したメッセヌゞは配信されたせんでした。495Claude が䜜業䞭でも、他のメッセヌゞず同じようにコマンドを送信でき、タヌンが終了するずセッションはアむドル状態に戻りたす。v2.1.206 より前では、タヌン䞭に送信されたコマンドはセッションを実行䞭ずしお衚瀺したたたにし、その埌に送信したメッセヌゞは配信されたせんでした。

496 496 


502 プラグむンをむンストヌルする502 プラグむンをむンストヌルする

503</h3>503</h3>

504 504 

505[プラグむン](/docs/ja/plugins)は、スキル、゚ヌゞェント、hooks、MCP サヌバヌ、および LSP 蚭定を Claude Code に远加する再利甚可胜なパッケヌゞです。タヌミナルを䜿甚せずにデスクトップアプリからプラグむンをむンストヌルできたす。505[プラグむン](/docs/ja/plugins/overview)は、スキル、゚ヌゞェント、hooks、MCP サヌバヌ、および LSP 蚭定を Claude Code に远加する再利甚可胜なパッケヌゞです。タヌミナルを䜿甚せずにデスクトップアプリからプラグむンをむンストヌルできたす。

506 506 

507ロヌカルおよび [SSH](#ssh-sessions) セッションの堎合、プロンプトボックスの暪の\*\*+**ボタンをクリックしお**Plugins**を遞択しお、むンストヌル枈みプラグむンずそのスキルを確認したす。プラグむンを远加するには、サブメニュヌから**Add plugin\*\*を遞択しおプラグむンブラりザを開きたす。これは、公匏 Anthropic マヌケットプレむスを含む、蚭定された [マヌケットプレむス](/docs/ja/plugin-marketplaces)から利甚可胜なプラグむンを衚瀺したす。**Manage plugins**を遞択しお、プラグむンを有効化、無効化、たたはアンむンストヌルしたす。507ロヌカルおよび [SSH](#ssh-sessions) セッションの堎合、プロンプトボックスの暪の\*\*+**ボタンをクリックしお**Plugins**を遞択しお、むンストヌル枈みプラグむンずそのスキルを確認したす。プラグむンを远加するには、サブメニュヌから**Add plugin\*\*を遞択しおプラグむンブラりザを開きたす。これは、公匏 Anthropic マヌケットプレむスを含む、蚭定された [マヌケットプレむス](/docs/ja/plugins/overview)から利甚可胜なプラグむンを衚瀺したす。**Manage plugins**を遞択しお、プラグむンを有効化、無効化、たたはアンむンストヌルしたす。

508 508 

509プラグむンはナヌザヌアカりント、特定のプロゞェクト、たたはロヌカルのみにスコヌプできたす。組織がプラグむンを䞀元管理する堎合、それらのプラグむンは CLI ず同じ方法で Desktop セッションで利甚可胜です。509プラグむンはナヌザヌアカりント、特定のプロゞェクト、たたはロヌカルのみにスコヌプできたす。組織がプラグむンを䞀元管理する堎合、それらのプラグむンは CLI ず同じ方法で Desktop セッションで利甚可胜です。

510 510 

511プラグむンブラりザはクラりドセッションでは利甚できず、デスクトップアプリからむンストヌルしたプラグむンはクラりドセッションでは利甚できたせん。クラりドセッションでプラグむンを䜿甚するには、リポゞトリの `.claude/settings.json` で宣蚀しお Claude Code が [セッション開始時にむンストヌル](/docs/ja/cloud-environments#what-carries-over-from-your-setup)するか、claude.ai アカりント甚に有効化しお Claude Code が [同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins)ずしおロヌドするようにしたす。プラグむンは WSL セッションでは利甚できたせん。プラグむンの䜜成を含む完党なプラグむンリファレンスに぀いおは、[プラグむン](/docs/ja/plugins)を参照しおください。511プラグむンブラりザはクラりドセッションでは利甚できず、デスクトップアプリからむンストヌルしたプラグむンはクラりドセッションでは利甚できたせん。クラりドセッションでもプラグむンをむンストヌルしたせん。リポゞトリの `.claude/settings.json` で宣蚀されおいるプラグむンは、[セットアップから匕き継がれるもの](/docs/ja/cloud-environments#what-carries-over-from-your-setup)で説明されおいるずおりです。プラグむンは WSL セッションでは利甚できたせん。プラグむンの䜜成を含む完党なプラグむンリファレンスに぀いおは、[プラグむン](/docs/ja/plugins/overview)を参照しおください。

512 512 

513<h3 id="configure-preview-servers">513<h3 id="configure-preview-servers">

514 プレビュヌサヌバヌを蚭定する514 プレビュヌサヌバヌを蚭定する


1023| 暩限モヌド | `dontAsk` を含むすべおのモヌド | Manual、Accept edits、Plan、および Auto。Bypass permissions はモヌドセレクタに衚瀺されたす。Pro ず Max プランでは Settings トグルで有効にしたす。Team ず Enterprise プランでは、組織ポリシヌがこれを制埡したす |1023| 暩限モヌド | `dontAsk` を含むすべおのモヌド | Manual、Accept edits、Plan、および Auto。Bypass permissions はモヌドセレクタに衚瀺されたす。Pro ず Max プランでは Settings トグルで有効にしたす。Team ず Enterprise プランでは、組織ポリシヌがこれを制埡したす |

1024| [サヌドパヌティプロバむダヌ](/docs/ja/third-party-integrations) | Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry | デフォルトでは Anthropic の API。ゲヌトりェむルヌティングに぀いおは、[デスクトップアプリをゲヌトりェむに接続](/docs/ja/llm-gateway-connect#desktop-app)を参照しおください。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは自己ホスト型 LLM ゲヌトりェむで Code タブを実行するには、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)を参照しおください。 |1024| [サヌドパヌティプロバむダヌ](/docs/ja/third-party-integrations) | Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry | デフォルトでは Anthropic の API。ゲヌトりェむルヌティングに぀いおは、[デスクトップアプリをゲヌトりェむに接続](/docs/ja/llm-gateway-connect#desktop-app)を参照しおください。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、たたは自己ホスト型 LLM ゲヌトりェむで Code タブを実行するには、[Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview)を参照しおください。 |

1025| [MCP サヌバヌ](/docs/ja/mcp) | 蚭定ファむルで蚭定 | ロヌカルおよび SSH セッションの Connectors UI、たたは蚭定ファむル |1025| [MCP サヌバヌ](/docs/ja/mcp) | 蚭定ファむルで蚭定 | ロヌカルおよび SSH セッションの Connectors UI、たたは蚭定ファむル |

1026| [Plugins](/docs/ja/plugins) | `/plugin` コマンド | プラグむンマネヌゞャヌ UI |1026| [Plugins](/docs/ja/plugins/overview) | `/plugin` コマンド | プラグむンマネヌゞャヌ UI |

1027| @mention ファむル | テキストベヌス | オヌトコンプリヌト付きロヌカルおよび SSH セッションのみ |1027| @mention ファむル | テキストベヌス | オヌトコンプリヌト付きロヌカルおよび SSH セッションのみ |

1028| ファむル添付 | 利甚できたせん | 画像、PDF |1028| ファむル添付 | 利甚できたせん | 画像、PDF |

1029| セッション分離 | [`--worktree`](/docs/ja/cli-reference) フラグ | **worktree** オプションセッション開始時 |1029| セッション分離 | [`--worktree`](/docs/ja/cli-reference) フラグ | **worktree** オプションセッション開始時 |

discover-plugins.md +0 −651 deleted

File Deleted View Diff

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# マヌケットプレむスから事前構築されたプラグむンを発芋しおむンストヌルする

6 

7> マヌケットプレむスからプラグむンを怜玢しおむンストヌルし、Claude Code を新しいスキル、゚ヌゞェント、機胜で拡匵したす。

8 

9プラグむンは Claude Code をスキル、゚ヌゞェント、フック、MCP サヌバヌで拡匵したす。プラグむンマヌケットプレむスは、これらの拡匵機胜を自分で構築するこずなく発芋しおむンストヌルするのに圹立぀カタログです。

10 

11claude.ai でプラグむンを有効にするこずもできたす。自分自身のため、たたは組織を通じお有効にできたす。Claude Code はそれらをマヌケットプレむスのむンストヌルなしにセッションに同期したす。[claude.ai から同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins)で説明されおいるずおりです。

12 

13独自のマヌケットプレむスを䜜成しお配垃したいですか[プラグむンマヌケットプレむスを䜜成しお配垃する](/docs/ja/plugin-marketplaces)を参照しおください。

14 

15<h2 id="how-marketplaces-work">

16 マヌケットプレむスの仕組み

17</h2>

18 

19マヌケットプレむスは、他の誰かが䜜成しお共有したプラグむンのカタログです。マヌケットプレむスを䜿甚するのは 2 段階のプロセスです

20 

21<Steps>

22 <Step title="マヌケットプレむスを远加する">

23 これにより、カタログが Claude Code に登録され、利甚可胜なものを参照できるようになりたす。プラグむンはただむンストヌルされおいたせん。

24 </Step>

25 

26 <Step title="個別のプラグむンをむンストヌルする">

27 カタログを参照しお、必芁なプラグむンをむンストヌルしたす。

28 </Step>

29</Steps>

30 

31<h2 id="official-anthropic-marketplace">

32 公匏 Anthropic マヌケットプレむス

33</h2>

34 

35Claude Code は初めお察話的に起動するず、公匏 Anthropic マヌケットプレむス`claude-plugins-official`を自動的に远加したす。ネットワヌクがダりンロヌドをブロックしおいる堎合や、[マヌケットプレむスポリシヌ](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)が以前の詊行をブロックした堎合など、Claude Code がそれを远加できない堎合は、`/plugin marketplace add anthropics/claude-plugins-official` を䜿甚しお自分で远加しおください。

36 

37利甚可胜なものを参照するには、`/plugin` を実行しお **Discover** タブに移動するか、[claude.com/plugins](https://claude.com/plugins)でカタログを衚瀺しおください。

38 

39公匏マヌケットプレむスからプラグむンをむンストヌルするには、`/plugin install <name>@claude-plugins-official` を䜿甚したす。たずえば、GitHub 統合をむンストヌルするには

40 

41```shell theme={null}

42/plugin install github@claude-plugins-official

43```

44 

45`/plugin` はタヌミナル CLI で察話的なパネルを開きたす。Claude が `/plugin` がこの環境では利甚できないず返答する堎合は、別の方法でプラグむンをむンストヌルしおください

46 

47* **Claude デスクトップアプリ**[プラグむンブラりザヌ](/docs/ja/desktop#install-plugins)を䜿甚しおください。

48* **VS Code 拡匵機胜**[**Manage plugins** ダむアログ](/docs/ja/vs-code#manage-plugins)からむンストヌルしおください。

49* **クラりドセッション**claude.ai アカりントのプラグむンを有効にしお、Claude Code が[同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins)ずしお読み蟌むようにしおください。

50 

51むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞず照合しおください

52 

53* `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。

54* プラグむンが[マヌケットプレむスで芋぀かりたせん](#install-plugins)プラグむン名を確認しおください。

55 

56<Note>

57 公匏マヌケットプレむスは Anthropic によっお管理されおおり、掲茉は Anthropic の裁量です。アプリ内送信フォヌムはプラグむンを[コミュニティマヌケットプレむス](#community-marketplace)に远加したす。公匏マヌケットプレむスには远加されたせん。プラグむンを独立しお配垃するには、[独自のマヌケットプレむスを䜜成](/docs/ja/plugin-marketplaces)しおナヌザヌず共有しおください。

58</Note>

59 

60公匏マヌケットプレむスには、プラグむンのいく぀かのカテゎリが含たれおいたす

61 

62<h3 id="code-intelligence">

63 コヌド むンテリゞェンス

64</h3>

65 

66[コヌド むンテリゞェンス](#code-intelligence)プラグむンは Claude Code の組み蟌み LSP ツヌルを有効にし、Claude が定矩にゞャンプしたり、参照を芋぀けたり、線集盎埌に型゚ラヌを確認したりできるようにしたす。これらのプラグむンは [Language Server Protocol](https://microsoft.github.io/language-server-protocol/) 接続を構成したす。これは VS Code のコヌド むンテリゞェンスを匷化する同じテクノロゞヌです。[クラりドセッション](/docs/ja/claude-code-on-the-web)では、Claude Code はプラグむン蚀語サヌバヌを起動しないため、Claude はそこで LSP ツヌルを取埗したせん。

67 

68これらのプラグむンを䜿甚する前に、以䞋の衚から蚀語サヌバヌバむナリをむンストヌルしおください。プラグむンはそれをむンストヌルしたせん。蚀語サヌバヌが既にむンストヌルされおいる堎合、プロゞェクトを開くず Claude は察応するプラグむンをむンストヌルするよう促す堎合がありたす。

69 

70| 蚀語 | プラグむン | 必芁なバむナリ |

71| :--------- | :------------------ | :--------------------------- |

72| C/C++ | `clangd-lsp` | `clangd` |

73| C# | `csharp-lsp` | `csharp-ls` |

74| Go | `gopls-lsp` | `gopls` |

75| Java | `jdtls-lsp` | `jdtls` |

76| Kotlin | `kotlin-lsp` | `kotlin-language-server` |

77| Lua | `lua-lsp` | `lua-language-server` |

78| PHP | `php-lsp` | `intelephense` |

79| Python | `pyright-lsp` | `pyright-langserver` |

80| Rust | `rust-analyzer-lsp` | `rust-analyzer` |

81| Swift | `swift-lsp` | `sourcekit-lsp` |

82| TypeScript | `typescript-lsp` | `typescript-language-server` |

83 

84[他の蚀語甚に独自の LSP プラグむンを䜜成](/docs/ja/plugins-reference#lsp-servers)するこずもできたす。

85 

86<Note>

87 プラグむンをむンストヌル埌に `/plugin` Errors タブに `Executable not found in $PATH` が衚瀺される堎合は、䞊蚘の衚から必芁なバむナリをむンストヌルしおください。

88</Note>

89 

90<h4 id="what-claude-gains-from-code-intelligence-plugins">

91 コヌド むンテリゞェンス プラグむンから Claude が埗られるもの

92</h4>

93 

94コヌド むンテリゞェンス プラグむンがむンストヌルされ、その蚀語サヌバヌバむナリが利甚可胜になるず、Claude は 2 ぀の機胜を埗られたす

95 

96* **自動蚺断**Claude が行うすべおのファむル線集埌、蚀語サヌバヌぱラヌず譊告を報告し、Claude はコンパむラやリンタヌを実行するこずなく、型゚ラヌ、䞍足しおいるむンポヌト、構文の問題を確認したす。Claude が゚ラヌを導入した堎合、それに気付いお同じタヌンで修正したす。

97* **コヌド ナビゲヌション**: Claude は蚀語サヌバヌを䜿甚しお定矩にゞャンプしたり、参照を芋぀けたり、ホバヌで型情報を取埗したり、シンボルをリストしたり、実装を芋぀けたり、呌び出し階局をトレヌスしたりできたす。これらの操䜜により、Claude は grep ベヌスの怜玢よりも正確なナビゲヌションが可胜になりたすが、蚀語ず環境によっお可甚性が異なる堎合がありたす。

98 

99蚺断を自分で読むには、Claude Code が **Found 3 new diagnostic issues in 2 files** などのむンゞケヌタヌを衚瀺するずきに **Ctrl+O** を抌しおください。

100 

101問題が発生した堎合は、[コヌド むンテリゞェンスのトラブルシュヌティング](#code-intelligence-issues)を参照しおください。

102 

103<h3 id="external-integrations">

104 倖郚統合

105</h3>

106 

107これらのプラグむンは事前構成された [MCP サヌバヌ](/docs/ja/mcp)をバンドルしおいるため、手動セットアップなしで Claude を倖郚サヌビスに接続できたす

108 

109* **゜ヌス管理**: `github`、`gitlab`

110* **プロゞェクト管理**: `atlassian`Jira/Confluence、`asana`、`linear`、`notion`

111* **デザむン**: `figma`

112* **むンフラストラクチャ**: `vercel`、`firebase`、`supabase`

113* **コミュニケヌション**: `slack`

114* **監芖**: `sentry`

115 

116<h3 id="automatic-security-review">

117 自動セキュリティレビュヌ

118</h3>

119 

120`security-guidance` プラグむンは Claude が行う各倉曎を䞀般的な脆匱性に぀いおレビュヌし、Claude に芋぀かったものを修正するよう指瀺したす。[Claude がコヌドを曞く際にセキュリティの問題をキャッチする](/docs/ja/security-guidance)を参照しお、䜕をチェックするか、プロゞェクト固有のルヌルを远加する方法を確認しおください。

121 

122<h3 id="development-workflows">

123 開発ワヌクフロヌ

124</h3>

125 

126䞀般的な開発タスク甚のスキルず゚ヌゞェントを远加するプラグむン

127 

128* **commit-commands**: コミット、プッシュ、PR 䜜成を含む Git コミット ワヌクフロヌ

129* **pr-review-toolkit**: プルリク゚ストをレビュヌするための特化した゚ヌゞェント

130* **agent-sdk-dev**: Claude Agent SDK で構築するためのツヌル

131* **plugin-dev**: 独自のプラグむンを䜜成するためのツヌルキット

132 

133<h3 id="output-styles">

134 出力スタむル

135</h3>

136 

137Claude の応答方法をカスタマむズしたす

138 

139* **explanatory-output-style**: 実装の遞択に関する教育的な掞察

140* **learning-output-style**: スキル構築のためのむンタラクティブな孊習モヌド

141 

142<h2 id="community-marketplace">

143 コミュニティ マヌケットプレむス

144</h2>

145 

146[`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community)のコミュニティ マヌケットプレむスは、Anthropic の自動怜蚌ずセキュリティ スクリヌニングに合栌したサヌドパヌティ プラグむンをホストしおいたす。各プラグむンはカタログ内の特定のコミット SHA に固定されおいたす。公匏マヌケットプレむスずは異なり、手動で远加したす

147 

148```shell theme={null}

149/plugin marketplace add anthropics/claude-plugins-community

150```

151 

152その埌、`claude-community` マヌケットプレむス名を䜿甚しおプラグむンをむンストヌルしたす

153 

154```shell theme={null}

155/plugin install <plugin-name>@claude-community

156```

157 

158独自のプラグむンをコミュニティ マヌケットプレむスに送信するには、プラグむン䜜成ガむドの[プラグむンをコミュニティ マヌケットプレむスに送信する](/docs/ja/plugins#submit-your-plugin-to-the-community-marketplace)を参照しおください。

159 

160<h2 id="try-it-add-the-demo-marketplace">

161 詊しおみる: デモマヌケットプレむスを远加する

162</h2>

163 

164Anthropic は、プラグむンシステムで䜕が可胜かを瀺す䟋プラグむンを含む [デモプラグむンマヌケットプレむス](https://github.com/anthropics/claude-code/tree/main/plugins)`claude-code-plugins`も管理しおいたす。公匏マヌケットプレむスずは異なり、このマヌケットプレむスは手動で远加する必芁がありたす。

165 

166<Steps>

167 <Step title="マヌケットプレむスを远加する">

168 Claude Code 内から、`anthropics/claude-code` マヌケットプレむスの `plugin marketplace add` コマンドを実行したす

169 

170 ```shell theme={null}

171 /plugin marketplace add anthropics/claude-code

172 ```

173 

174 これにより、マヌケットプレむスカタログがダりンロヌドされ、そのプラグむンが利甚可胜になりたす。

175 </Step>

176 

177 <Step title="利甚可胜なプラグむンを参照する">

178 `/plugin` を実行しおプラグむンマネヌゞャヌを開きたす。これにより、**Tab**たたは埌方に移動するには **Shift+Tab**を䜿甚しお埪環できるタブ付きむンタヌフェヌスが開きたす

179 

180 * **Discover**: すべおのマヌケットプレむスから利甚可胜なプラグむンを参照

181 * **Installed**: むンストヌル枈みプラグむンを衚瀺および管理

182 * **Marketplaces**: 远加したマヌケットプレむスを远加、削陀、たたは曎新

183 * **Errors**: プラグむン読み蟌み゚ラヌを衚瀺

184 * **Stats**: [各スキルのコンテキストコストず䜿甚頻床を確認](/docs/ja/skills#find-unused-skills)したす。`/skill-doctor` が利甚可胜なセッションで確認できたす

185 

186 **Discover** タブに移動しお、远加したばかりのマヌケットプレむスからプラグむンを確認しおください。管理者が [`pluginSuggestionMarketplaces`](/docs/ja/settings-reference#pluginsuggestionmarketplaces) マネヌゞド蚭定を通じおマヌケットプレむスをホワむトリストに登録しおいる堎合、珟圚の䜜業ディレクトリに関連するずマヌクされたプラグむンは、**suggested for this directory** ラベル付きで䞊郚に固定されたす。

187 </Step>

188 

189 <Step title="プラグむンをむンストヌルする">

190 プラグむンを遞択しおその詳现を衚瀺したす。詳现ペむンには、プラグむンに含たれるもの、およびそのコストが衚瀺されたす

191 

192 * **Context cost** の掚定倀。毎タヌン [コンテキストりィンドり](/docs/ja/features-overview#understand-context-costs) にプラグむンが远加するトヌクン数を確認できたす

193 * プラグむンの **Last updated** 日付

194 * プラグむンのコマンド、゚ヌゞェント、スキル、フック、MCP および LSP サヌバヌをリストアップする **Will install** セクション。むンストヌル前に正確に䜕が远加されるかを確認できたす

195 

196 すべおのプラグむンがこれらのフィヌルドの背埌にあるデヌタを提䟛するわけではありたせん。ロヌカルたたはカスタムマヌケットプレむスのプラグむンの堎合、**Context cost** および **Last updated** 行が衚瀺されない堎合があり、**Will install** セクションは代わりに **Components will be discovered at installation** を衚瀺する堎合がありたす。

197 

198 むンストヌルスコヌプを遞択したす

199 

200 * **User scope**: すべおのプロゞェクト党䜓で自分甚にむンストヌル

201 * **Project scope**: このリポゞトリのすべおのコラボレヌタヌ甚にむンストヌル

202 * **Local scope**: このリポゞトリ内で自分甚にのみむンストヌル

203 

204 たずえば、**commit-commands**git ワヌクフロヌスキルを远加するプラグむンを遞択しお、ナヌザヌスコヌプにむンストヌルしたす。

205 

206 コマンドラむンから盎接むンストヌルするこずもできたす

207 

208 ```shell theme={null}

209 /plugin install commit-commands@claude-code-plugins

210 ```

211 

212 スコヌプの詳现に぀いおは、[蚭定ファむル](/docs/ja/settings#where-settings-live)を参照しおください。

213 </Step>

214 

215 <Step title="新しいプラグむンを䜿甚する">

216 むンストヌル抂芁が `Run /reload-plugins to activate.` ず報告されおいる堎合、Claude Code はそのリロヌドを自動的に実行したす。リロヌドが䌚話を再読み蟌みするこずを譊告する堎合は、`/reload-plugins --force` を実行しおプラグむンをアクティベヌトしおください。

217 

218 プラグむンスキルはプラグむン名でネヌムスペヌス化されおいるため、**commit-commands** は `/commit-commands:commit` のようなスキルを提䟛したす。

219 

220 ファむルに倉曎を加えお、以䞋を実行しお詊しおみおください

221 

222 ```shell theme={null}

223 /commit-commands:commit

224 ```

225 

226 これにより、倉曎がステヌゞされ、コミットメッセヌゞが生成され、コミットが䜜成されたす。

227 

228 各プラグむンは異なる方法で機胜したす。**Discover** タブのプラグむンの詳现を確認しお、提䟛されるコマンドずスキルを確認するか、䜿甚方法のガむダンスに぀いおそのホヌムペヌゞにアクセスしおください。

229 </Step>

230</Steps>

231 

232<h2 id="add-marketplaces">

233 マヌケットプレむスを远加する

234</h2>

235 

236`/plugin marketplace add` コマンドを䜿甚しお、異なる゜ヌスからマヌケットプレむスを远加したす。

237 

238<Tip>

239 **ショヌトカット**: `/plugin marketplace` の代わりに `/plugin market` を䜿甚でき、`remove` の代わりに `rm` を䜿甚できたす。

240</Tip>

241 

242* **GitHub リポゞトリ**: `owner/repo` 圢匏䟋`anthropics/claude-code`

243* **Git URL**: 任意の git リポゞトリ URLGitLab、Bitbucket、自己ホスト

244* **ロヌカル パス**: ディレクトリたたは `marketplace.json` ファむルぞの盎接パス

245* **リモヌト URL**: ホストされた `marketplace.json` ファむルぞの盎接 URL

246* **claude.ai**: claude.ai でホストされおいるマヌケットプレむス組織のプラグむン ラむブラリなど。これらは [**Marketplaces** タブたたはシェルから名前で远加](#add-from-claude-ai)したす。゜ヌスではなく名前で远加したす。

247 

248<h3 id="add-from-github">

249 GitHub から远加する

250</h3>

251 

252`.claude-plugin/marketplace.json` ファむルを含む GitHub リポゞトリを `owner/repo` 圢匏を䜿甚しお远加したす。ここで `owner` は GitHub ナヌザヌ名たたは組織で、`repo` はリポゞトリ名です。

253 

254たずえば、`anthropics/claude-code` は `anthropics` が所有する `claude-code` リポゞトリを指したす

255 

256```shell theme={null}

257/plugin marketplace add anthropics/claude-code

258```

259 

260<h3 id="add-from-other-git-hosts">

261 他の Git ホストから远加する

262</h3>

263 

264git マヌケットプレむス リポゞトリを完党な URL を提䟛するこずで远加したす。`https://` URL の堎合、`.git` サフィックスを含めるかどうかはホストによっお異なりたす

265 

266* **`github.com` ず `gitlab.com`**: Claude Code はリポゞトリ URL を `.git` サフィックスの有無にかかわらず認識し、クロヌンしたす。サフィックスなしで `gitlab.com` URL を远加するには、Claude Code v2.1.232 以降が必芁です。v2.1.232 より前では、Claude Code はこれをホストされた `marketplace.json` ファむルぞの盎接リンクずしお扱いたした。

267* **Azure DevOps**: サフィックスを省略したす。Claude Code はパスに `/_git/` を含む任意の URL をクロヌンしたす。`/_git/` パスに `.git` を远加するず、クロヌンが倱敗したす。

268* **自己管理 GitLab サヌバヌを含む他のすべおのホスト**: `.git` サフィックスを含めお、Claude Code がリポゞトリをクロヌンするようにしおください。URL をホストされた `marketplace.json` ファむルぞの盎接リンクずしお扱うのではなく。AWS CodeCommit のようにクロヌン URL にサフィックスを含たないホストの堎合は、代わりに [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) に git ゚ントリずしおマヌケットプレむスを远加しおください。Claude Code は git ゚ントリを URL が `.git` で終わるかどうかにかかわらずクロヌンしたす。

269 

270Claude Code は `https://gitlab.com/group/subgroup/project` のようなネストされたサブグルヌプを持぀ `gitlab.com` URL もクロヌンしたす。

271 

272`https://` プレフィックスを含めおください。Claude Code v2.1.196 以降は、`gitlab.com/company/plugins.git` のようにプレフィックスなしで入力されたホストを無効な GitHub `owner/repo` ショヌトハンドずしお拒吊し、゚ラヌメッセヌゞでプレフィックスを远加するよう指瀺したす。以前のバヌゞョンでは、これを GitHub リポゞトリパスずしお誀読し、クロヌン時に倱敗したす。

273 

274HTTPS を䜿甚する堎合

275 

276```shell theme={null}

277/plugin marketplace add https://gitlab.com/company/plugins.git

278```

279 

280SSH を䜿甚する堎合

281 

282```shell theme={null}

283/plugin marketplace add git@gitlab.com:company/plugins.git

284```

285 

286Claude Code は SSH アドレスを `.git` で終わるかどうかにかかわらずクロヌンしたす。

287 

288特定のブランチたたはタグを远加するには、`#` の埌に ref を远加したす

289 

290```shell theme={null}

291/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

292```

293 

294<h3 id="add-from-local-paths">

295 ロヌカル パスから远加する

296</h3>

297 

298`.claude-plugin/marketplace.json` ファむルを含むロヌカル ディレクトリを远加したす

299 

300```shell theme={null}

301/plugin marketplace add ./my-marketplace

302```

303 

304`marketplace.json` ファむルぞの盎接パスを远加するこずもできたす

305 

306```shell theme={null}

307/plugin marketplace add ./path/to/marketplace.json

308```

309 

310<h3 id="add-from-remote-urls">

311 リモヌト URL から远加する

312</h3>

313 

314URL 経由でリモヌト `marketplace.json` ファむルを远加したす

315 

316```shell theme={null}

317/plugin marketplace add https://example.com/marketplace.json

318```

319 

320<Note>

321 URL ベヌスのマヌケットプレむスは、Git ベヌスのマヌケットプレむスず比べおいく぀かの制限がありたす。URL ベヌスのマヌケットプレむスからのプラグむンのむンストヌルが倱敗する堎合は、[トラブルシュヌティング](/docs/ja/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照しおください。

322</Note>

323 

324<h3 id="add-from-claude-ai">

325 claude.ai から远加する

326</h3>

327 

328[プラグむンが claude.ai アカりントから同期されるタヌミナル セッション](/docs/ja/plugins-reference#synced-plugins)では、claude.ai はマヌケットプレむスをリストアップするこずもできたす。組織のプラグむン ラむブラリや独自の claude.ai アップロヌドなど。`claude plugin marketplace list` は `From claude.ai:` セクションでそれらを出力し、`/plugin` **Marketplaces** タブにもリストされたす。そこから 1 ぀を遞択しお远加したす。claude.ai からマヌケットプレむスを远加するには、Claude Code v2.1.273 以降が必芁です。

329 

330シェルから远加するには、`claude plugin marketplace add` を `--claudeai` フラグずリストに衚瀺されおいる名前で実行したす

331 

332```bash theme={null}

333claude plugin marketplace add --claudeai claudeai-organization-library

334```

335 

336Claude Code はマヌケットプレむスをロヌカル名で登録したす。これは claude.ai がリストアップしおいる名前から掟生した `claudeai-` で始たる名前です。「Organization library」ずしおリストされおいるマヌケットプレむスは `claudeai-organization-library` ずしお登録されたす。その名前でプラグむンをむンストヌルしたす。たずえば `claude plugin install <plugin>@claudeai-organization-library` を䜿甚したす。

337 

338サむンアりトするか別のアカりントでサむンむンするず、マヌケットプレむスは蚭定されたたたですがプラグむンが衚瀺されず、既にそこからむンストヌルしたプラグむンは匕き続き読み蟌たれたす。

339 

340`From claude.ai:` セクションは、claude.ai を通じお共有されおいる git ベヌスのマヌケットプレむスもリストアップできたす。これらは通垞の `marketplace add` コマンドで远加したす。リストが出力する゜ヌスを䜿甚したす。

341 

342<h2 id="install-plugins">

343 プラグむンをむンストヌルする

344</h2>

345 

346マヌケットプレむスを远加したら、プラグむンを名前でむンストヌルできたす。ただ远加しおいないマヌケットプレむスの堎合は、代わりに[1 ぀のコマンドでマヌケットプレむスを远加しおむンストヌル](#add-a-marketplace-and-install-in-one-command)できたす。

347 

348名前でむンストヌルするには

349 

350```shell theme={null}

351/plugin install plugin-name@marketplace-name

352```

353 

354このコマンドはそのプラグむンの詳现を開き、[むンストヌル スコヌプ](/docs/ja/settings#where-settings-live)を遞択できたす。`/plugin` を実行しお **Discover** タブに移動し、プラグむンで **Enter** を抌すず、同じ遞択肢が衚瀺されたす

355 

356* **User scope**: すべおのプロゞェクト党䜓で自分甚にむンストヌル

357* **Project scope**: このリポゞトリのすべおのコラボレヌタヌ甚にむンストヌル`.claude/settings.json` に远加

358* **Local scope**: このリポゞトリ内で自分甚にのみむンストヌルコラボレヌタヌず共有されない

359 

360むンタラクティブなステップなしでむンストヌルするには、[`claude plugin install`](/docs/ja/plugins-reference#plugin-install) シェル コマンドを䜿甚したす。このコマンドはナヌザヌ スコヌプにむンストヌルしたす。`--scope` を枡さない限り、ナヌザヌ スコヌプにむンストヌルされたす。[`command` ゜ヌス](/docs/ja/plugin-marketplaces#how-users-accept-the-command)を持぀プラグむンの堎合、`--yes` を枡しお、それが衚瀺するコマンドを受け入れたす。

361 

362**managed** スコヌプのプラグむンも衚瀺される堎合がありたす。これらは管理者が[管理蚭定](/docs/ja/managed-settings)経由でむンストヌルしたもので、倉曎するこずはできたせん。

363 

364Claude Code はロヌカル マヌケットプレむス カタログのコピヌでプラグむンを怜玢したす。プラグむンの名前の付け方によっお、Claude Code がそのコピヌを最初に曎新するかどうかが決たりたす

365 

366* **マヌケットプレむス名を含む堎合**: セッションで `plugin-name@marketplace-name` をむンストヌルするか、`claude plugin install` で実行するず、Claude Code はルックアップの前にそのマヌケットプレむスを曎新したす。Claude Code は、マヌケットプレむスの[自動曎新](#configure-auto-updates)をオフにしたか、`DISABLE_AUTOUPDATER` を蚭定した堎合でも、曎新を実行したす。v2.1.232 より前では、Claude Code はルックアップの前にマヌケットプレむスを曎新したせんでした。Claude Code は以䞋の堎合、この曎新をスキップしたす

367 * マヌケットプレむスが[GitHub、別の Git ホスト、リモヌト URL から远加](#add-marketplaces)されおいない、たたは[Claude.ai から远加](#add-from-claude-ai)されおいない。

368 * [シヌド ディレクトリ](/docs/ja/plugin-marketplaces#pre-populate-plugins-for-containers)がマヌケットプレむスを提䟛しおいる。

369 * Claude Code が過去 30 秒以内にマヌケットプレむスを曎新した。

370 * [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars)を蚭定した。

371 * [管理蚭定](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)がマヌケットプレむスをブロックしおいる。この堎合、Claude Code はむンストヌルも拒吊したす。

372* **プラグむン名のみ**: セッションで `/plugin install plugin-name` を実行するず、Claude Code は[バックグラりンドでも曎新](#configure-auto-updates)するマヌケットプレむスのみを曎新し、ルックアップが倱敗した埌のみです。`claude plugin install plugin-name` を実行するず、Claude Code は曎新なしでキャッシュされたカタログを読み取りたす。最埌の曎新埌に公開されたプラグむンをむンストヌルするには、セッションで `/plugin marketplace update <marketplace-name>` を実行するか、シェルで [`claude plugin marketplace update <marketplace-name>`](/docs/ja/plugin-marketplaces#plugin-marketplace-update)を実行しおから、むンストヌルを再詊行したす。

373 

374名前付きむンストヌル前の曎新が倱敗した堎合䟋えば、オフラむンの堎合、Claude Code はキャッシュされたカタログでプラグむンを怜玢したす。`claude plugin install` は成功メッセヌゞで `marketplace not refreshed` を報告し、`/plugin install` はプラグむンの詳现の䞊たたは芋぀からないメッセヌゞで゚ラヌを衚瀺したす。

375 

376`/plugin` むンタヌフェむスからむンストヌルするず、むンストヌル サマリヌは、プラグむンが珟圚のセッションでアクティブかどうかを瀺したす

377 

378* `Plugin is now active.`: Claude Code はむンストヌルの䞀郚ずしおプラグむンをアクティブにしたした。

379* `Run /reload-plugins to activate.`: プラグむンはただアクティブではありたせん。これは、アクティブ化するず[プロンプト キャッシュが無効になる](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)か、アクティブ化の詊行が倱敗したためです。Claude Code はその埌、`/reload-plugins` を実行したす。そのリロヌドがプロンプト キャッシュに぀いお譊告する堎合、[プラグむンをずにかくアクティブにする](#apply-plugin-changes-without-restarting)には `/reload-plugins --force` を実行しおください。

380* プラグむンの読み蟌みに倱敗した堎合、サマリヌは倱敗を報告し、`/plugin` **Errors** タブに詳现が衚瀺されたす。

381 

382v2.1.221 より前では、`/reload-plugins` を実行するか再起動するたで、珟圚のセッションでむンストヌルが有効になりたせんでした。

383 

384`claude plugin install` シェル コマンドはセッションで実行されないため、Claude Code は次回 Claude Code を起動するか、既に開いおいるセッションで `/reload-plugins` を実行するずきに、むンストヌルしたプラグむンを読み蟌みたす。

385 

386<Warning>

387 プラグむンをむンストヌルする前に、それを信頌しおいるこずを確認しおください。Anthropic はプラグむンに含たれる MCP サヌバヌ、ファむル、たたはその他の゜フトりェアを制埡せず、意図したずおりに機胜するこずを確認できたせん。詳现に぀いおは、各プラグむンのホヌムペヌゞを確認しおください。

388</Warning>

389 

390<h3 id="add-a-marketplace-and-install-in-one-command">

391 1 ぀のコマンドでマヌケットプレむスを远加しおむンストヌルする

392</h3>

393 

394ただ远加しおいないマヌケットプレむスからプラグむンをむンストヌルするには、`--marketplace` でマヌケットプレむス ゜ヌスを指定したす。Claude Code v2.1.275 以降が必芁です。

395 

396```shell theme={null}

397/plugin install quality-review-plugin --marketplace your-org/plugins

398```

399 

400゜ヌスは[`/plugin marketplace add`](#add-marketplaces)ず同じ圢匏を取りたす。䟋えば、GitHub の `owner/repo`、git URL、たたはロヌカル パスなど。ただし、スペヌスを含むこずはできたせん。プラグむン名は `@marketplace` サフィックスなしで指定したす。

401 

402Claude Code は゜ヌスが解決されたこずを衚瀺し、マヌケットプレむスを远加する前に確認を求めたす。キャンセルするずむンストヌルがキャンセルされ、䜕も远加されたせん。マヌケットプレむスが远加されるず、プラグむンの詳现が開き、[むンストヌル スコヌプ](/docs/ja/settings#where-settings-live)を遞択できたす。゜ヌスが既に远加したマヌケットプレむスず䞀臎する堎合、Claude Code は確認をスキップし、そのマヌケットプレむスでプラグむンの詳现を開きたす。

403 

404<h2 id="manage-installed-plugins">

405 むンストヌル枈みプラグむンを管理する

406</h2>

407 

408`/plugin` を実行しお **Installed** タブに移動し、プラグむンを衚瀺、有効化、無効化、たたはアンむンストヌルしたす。リストはスコヌプでグルヌプ化され、問題が最初に衚瀺されるように゜ヌトされたす。読み蟌み゚ラヌたたは未解決の䟝存関係を持぀プラグむンが䞊郚に衚瀺され、その埌にお気に入りが続き、無効化されたプラグむンは䞋郚の折りたたたれたヘッダヌの埌ろに折りたたたれたす。

409 

410リストから以䞋を実行できたす

411 

412* `f` を抌しお、遞択したプラグむンをお気に入りに远加たたはお気に入りから削陀

413* 入力しおプラグむン名たたは説明でフィルタリング

414* Enter を抌しおプラグむンの詳现ビュヌを開き、有効化、無効化、たたはアンむンストヌル

415 

416Claude Code はたた、[claude.ai アカりントから同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins) を **Installed** タブに䞀芧衚瀺したす。゜ヌスは `synced` です。組織がそれを必須ずしおマヌクしおいない限り、そこで有効化たたは無効化できたす。削陀するには、claude.ai でオフにしたす。同期されたプラグむンは Claude Code v2.1.273 以降のタヌミナルセッションに衚瀺されたす。

417 

418プロゞェクトの `.claude/settings.json` が有効化しおいるプラグむンをアンむンストヌルするず、Claude Code はどのスコヌプを意図しおいるかを尋ねたす。自分だけのために無効化する堎合は、`.claude/settings.local.json` にオヌバヌラむドを曞き蟌み、プラグむンはプロゞェクトにむンストヌルされたたたになりたす。たたは、すべおのナヌザヌのためにアンむンストヌルする堎合は、共有の `.claude/settings.json` から削陀されたす。

419 

420詳现ビュヌには、プラグむンが提䟛するコンポヌネントが衚瀺されたす。コマンド、skills、agents、hooks、MCP サヌバヌ、LSP サヌバヌです。同じむンベントリは、コマンドラむンから `claude plugin details` で利甚できたす。

421 

422Claude Code はたた、マヌケットプレむスから自分でむンストヌルしたが、少なくずも 2 週間以䞊、か぀少なくずも 10 セッション以䞊にわたっお䜿甚しおいないプラグむンも䞀芧衚瀺したす。これらは **Installed** タブの **Not used recently** ヘッダヌの䞋に衚瀺されたす。詳现ビュヌには、各プラグむンの **Last used** 行が衚瀺されたす。これらを䜿甚しお、もう䜿甚しおいないが、それでもスタヌトアップずコンテキストコストを远加しおいるプラグむンを芋぀け、無効化たたはアンむンストヌルできたす。

423 

4242 皮類のプラグむンは、未䜿甚ずしお䞀芧衚瀺されるこずはありたせん

425 

426* 組織が管理するプラグむン、たたは `--plugin-dir` で読み蟌むプラグむン

427* テヌマ、出力スタむル、モニタヌ、たたはワヌクフロヌを提䟛するプラグむン。これらは远跡する呌び出しなしで䟡倀を提䟛するため

428 

429**Not used recently** ヘッダヌず **Last used** 行は、組織が [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) でマヌケットプレむスを制限しおいる堎合、䞡方ずも非衚瀺になりたす。

430 

431プラグむンの [蚀語サヌバヌ](/docs/ja/plugins#add-lsp-servers-to-your-plugin) は、蚺断を提䟛するか、コヌド ナビゲヌション リク゚ストに応答するずきに䜿甚枈みずしおカりントされたす。そのため、LSP プラグむンのサヌバヌがセッションでアクティブな堎合、未䜿甚ずしお䞀芧衚瀺されたせん。v2.1.203 より前では、蚀語サヌバヌ アクティビティを䜿甚ずしおカりントできなかったため、LSP サヌバヌを提䟛するプラグむンはグルヌプ党䜓から陀倖されおいたした。これはテヌマず出力スタむル プラグむンず同じ方法です。

432 

433蚀語サヌバヌ アクティビティをカりントするバヌゞョンの最初のセッションは、ただ䜿甚を蚘録しおいない各 LSP プラグむンの䜿甚蚘録もリセットするため、Claude Code は、サヌバヌ アクティビティが远跡される前に蚘録されたデヌタに基づいお、以前にむンストヌルしたプラグむンを未䜿甚ず刀断したせん。

434 

435䟝存関係を宣蚀するプラグむンをむンストヌルするず、むンストヌル出力には、それず共に自動むンストヌルされた䟝存関係が䞀芧衚瀺されたす。

436 

437盎接コマンドでプラグむンを管理するこずもできたす

438 

439* `/plugin disable`、`/plugin enable`、たたは `/plugin uninstall` を実行するず、Claude Code はプラグむンパネルを開いお倉曎を適甚し、パネルを開いたたたにしたす。別のコマンドを入力する前に **Esc** を抌しおパネルを閉じたす。[プラグむンの倉曎をリスタヌトなしで適甚する](#apply-plugin-changes-without-restarting) では、倉曎がセッションでい぀有効になるかに぀いお説明しおいたす。

440* スクリプティングの堎合は、代わりに `claude plugin` シェルコマンドを䜿甚したす。これらはパネルを開きたせん。

441 

442メニュヌを開かずにむンストヌル枈みプラグむンを䞀芧衚瀺したす

443 

444```shell theme={null}

445/plugin list

446```

447 

448`--enabled` たたは `--disabled` を枡しお、その状態のプラグむンのみを衚瀺したす。

449 

450プラグむンをアンむンストヌルせずに無効化したす

451 

452```shell theme={null}

453/plugin disable plugin-name@marketplace-name

454```

455 

456無効化されたプラグむンを再床有効化したす

457 

458```shell theme={null}

459/plugin enable plugin-name@marketplace-name

460```

461 

462これらの識別子では、`plugin-name` は [マヌケットプレむス゚ントリ](/docs/ja/plugin-marketplaces#plugin-entries) の `name` であり、プラグむン自䜓の `plugin.json` の `name` ず異なる堎合がありたす。

463 

464Claude Code v2.1.195 以降では、`/plugin` むンタヌフェむスの **Enable** ず **Disable** は、2 ぀の名前が異なるプラグむンに察しお機胜し、`/plugin enable` ず `/plugin disable` はどちらの名前でも受け入れたす。以前のバヌゞョンでそのようなプラグむンを無効化するず、Claude Code は `already disabled` を報告し、有効なたたにしたす。

465 

466プラグむンを完党に削陀したす

467 

468```shell theme={null}

469/plugin uninstall plugin-name@marketplace-name

470```

471 

472`--scope` オプションを䜿甚するず、CLI コマンドで特定のスコヌプをタヌゲットにできたす

473 

474```shell theme={null}

475claude plugin install formatter@your-org --scope project

476claude plugin uninstall formatter@your-org --scope project

477```

478 

479<h3 id="apply-plugin-changes-without-restarting">

480 プラグむンの倉曎をリスタヌトなしで適甚する

481</h3>

482 

483`/plugin` メニュヌを閉じるず、Claude Code はむンストヌル、有効化、無効化、アンむンストヌルなど、メニュヌで行った倉曎を適甚するために `/reload-plugins` を実行したす。リロヌドが [プロンプトキャッシュを無効にする](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin) 堎合、譊告を衚瀺し、倉曎を保留のたたにしたす。代わりに `/reload-plugins --force` を実行しお適甚したす。Claude がただ応答䞭の堎合、リロヌドは応答が終了した埌に実行されたす。

484 

485メニュヌの倖で発生するプラグむン倉曎に぀いおは、`/reload-plugins` を自分で実行したす。これらの倉曎には以䞋が含たれたす

486 

487* 別のタヌミナルで実行した `claude plugin` コマンド

488* 開発䞭に [`--plugin-dir`](/docs/ja/plugins#test-your-plugins-locally) で読み蟌んだプラグむンぞの線集

489* 再床読み蟌むよう求める通知を衚瀺するプラグむン [自動曎新](#configure-auto-updates)

490* [claude.ai アカりントからの同期](/docs/ja/plugins-reference#synced-plugins) がプラグむンを远加、曎新、たたは削陀し、再床読み蟌むよう求める通知を衚瀺した

491* Claude Code が保留しおいた [`--plugin-dir` フォルダ](/docs/ja/plugins#test-your-plugins-locally) の倉曎。これは、適甚するずプロンプトキャッシュが無効になるため

492 

493v2.1.268 より前では、メニュヌで有効化、無効化、たたはアンむンストヌルしたプラグむン、およびむンストヌル䞭にアクティブ化されなかったむンストヌルは、`/reload-plugins` を実行するたで保留のたたでした。

494 

495`/reload-plugins` はたた、デスクトップアプリ、Agent SDK、および [`-p` を䜿甚した非察話型モヌド](/docs/ja/headless) など、察話型タヌミナルのないセッションでも実行されたす。Claude Code v2.1.260 以降が必芁です。これらのセッションでは 2 ぀の制限が適甚されたす

496 

497* コマンドは、`-p` プロンプトやデスクトップアプリのプロンプトボックスなど、セッションに盎接入力した堎合にのみ実行されたす。代わりに [Remote Control](/docs/ja/remote-control) やリレヌされたチャットメッセヌゞなどのリモヌト接続を介しお送信する堎合、コマンドは䜕もリロヌドせずに拒吊されたす。

498* リロヌドはプラグむン MCP サヌバヌを接続たたは切断したせん。これらの倉曎は次のセッションで有効になりたす。

499 

500Claude Code はすべおのアクティブなプラグむンをリロヌドし、プラグむン、skills、agents、hooks、プラグむン MCP サヌバヌ、プラグむン LSP サヌバヌのカりントを衚瀺したす。察話型タヌミナルのないセッションではプラグむン MCP サヌバヌのカりントを省略したす。skills のカりントでは、Claude Code はプラグむンが提䟛するすべおの skill を含みたす。`commands/` ゚ントリず `SKILL.md` skills の䞡方です。v2.1.246 より前では、Claude Code は `commands/` ゚ントリのみをカりントしおいたため、プラグむンの `SKILL.md` skills をリロヌドしおも、抂芁で `0 skills` を報告する可胜性がありたした。

501 

502リロヌドには次のリク゚ストでトヌクンコストがありたす。新しくロヌドされたコンポヌネントは䌚話に远加されたコンテンツで自身を発衚し、既存の履歎はプロンプトキャッシュから読み蟌たれたたたです。MCP サヌバヌを提䟛するプラグむンは、そのツヌルが [tool search](/docs/ja/mcp#scale-with-mcp-tool-search) によっお遅延されおいない堎合、より倚くのコストがかかりたす。倉曎はキャッシュを無効にし、次のリク゚ストは䌚話党䜓を再床読み蟌みたす。詳现に぀いおは、[プラグむンの有効化たたは無効化](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin) を参照しおください。

503 

504<h2 id="manage-marketplaces">

505 マヌケットプレむスを管理する

506</h2>

507 

508むンタラクティブな `/plugin` むンタヌフェヌスたたは CLI コマンドを䜿甚しおマヌケットプレむスを管理できたす。

509 

510<h3 id="use-the-interactive-interface">

511 むンタラクティブ むンタヌフェヌスを䜿甚する

512</h3>

513 

514`/plugin` を実行しお **Marketplaces** タブに移動しお、以䞋を実行したす

515 

516* 远加したすべおのマヌケットプレむスをその゜ヌスずステヌタスで衚瀺

517* 新しいマヌケットプレむスを远加

518* マヌケットプレむス リストを曎新しお最新のプラグむンを取埗

519* 䞍芁になったマヌケットプレむスを削陀

520 

521<h3 id="use-cli-commands">

522 CLI コマンドを䜿甚する

523</h3>

524 

525盎接コマンドでマヌケットプレむスを管理するこずもできたす。

526 

527構成されたすべおのマヌケットプレむスをリストしたす

528 

529```shell theme={null}

530/plugin marketplace list

531```

532 

533マヌケットプレむスからプラグむン リストを曎新したす

534 

535```shell theme={null}

536/plugin marketplace update marketplace-name

537```

538 

539マヌケットプレむスを削陀したす

540 

541```shell theme={null}

542/plugin marketplace remove marketplace-name

543```

544 

545<Warning>

546 マヌケットプレむスを削陀するず、そこからむンストヌルしたプラグむンがアンむンストヌルされたす。

547</Warning>

548 

549<h3 id="configure-auto-updates">

550 自動曎新を構成する

551</h3>

552 

553Claude Code はスタヌトアップ時にマヌケットプレむスずそのむンストヌル枈みプラグむンをバックグラりンドで自動的に曎新できたす。マヌケットプレむスで自動曎新が有効になっおいる堎合、Claude Code はマヌケットプレむス デヌタを曎新し、むンストヌル枈みプラグむンをディスク䞊の最新バヌゞョンに曎新したす。

554 

555Claude Code はセッション開始埌、最倧 10 分のランダムな遅延でマヌケットプレむスずプラグむンの曎新をチェックするため、実行䞭のセッションは起動時に読み蟌んだバヌゞョンを䜿甚し続けたす。プラグむンが曎新された堎合、`/reload-plugins` を実行するよう促すメッセヌゞが衚瀺されるか、次回の起動時に新しいバヌゞョンが読み蟌たれたす。

556 

557自動曎新は、マヌケットプレむス ゚ントリが `headersHelper` を宣蚀するプラグむンも陀倖したす。Claude Code は [そのパス䞊のコマンドを実行したり、アヌカむブをダりンロヌドしたりしたせん](/docs/ja/plugin-marketplaces#installs-and-updates-that-refuse-the-command-instead-of-asking)。そのセクションでは、Claude Code がプラグむンを `/plugin` Errors タブにリストする時期に぀いお説明しおおり、独自のビュヌから曎新できたす。

558 

559Claude Code は [`command` ゜ヌス](/docs/ja/plugin-marketplaces#command-sources)を持぀プラグむンを、マヌケットプレむス自動曎新蚭定および `DISABLE_AUTOUPDATER` ずは異なるペヌスで曎新したす。代わりに、[セッションごずに 1 回コマンドを再実行](/docs/ja/plugin-marketplaces#when-claude-code-re-runs-the-command)し、その [ハッシュ](/docs/ja/plugins-reference#version-management)が倉曎された堎合、出力を新しいプラグむン バヌゞョンずしおむンストヌルしたす。

560 

561UI を通じお個別のマヌケットプレむスの自動曎新を切り替えたす

562 

5631. `/plugin` を実行しおプラグむン マネヌゞャヌを開く

5642. **Marketplaces** を遞択

5653. リストからマヌケットプレむスを遞択

5664. **Enable auto-update** たたは **Disable auto-update** を遞択

567 

568`claude-plugins-official`、その他のほずんどの公匏 Anthropic マヌケットプレむス、および [claude.ai から远加されたマヌケットプレむス](#add-from-claude-ai)はデフォルトで自動曎新が有効になっおいたす。その他のサヌドパヌティ マヌケットプレむスおよびロヌカル開発マヌケットプレむスはデフォルトで自動曎新が無効になっおいたす。

569 

570管理者は、マネヌゞド蚭定で各 [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) ゚ントリに `"autoUpdate": true` を蚭定しお、各ナヌザヌが切り替える必芁なく、組織マヌケットプレむスの自動曎新を有効にするこずもできたす。

571 

572Claude Code ずマヌケットプレむスから取埗されたプラグむンの自動曎新を無効にするには、`DISABLE_AUTOUPDATER` 環境倉数を蚭定したす。[`command` ゜ヌス](/docs/ja/plugin-marketplaces#command-sources)を持぀プラグむンは独自のセッションごず 1 回の再解決に埓いたす。詳现に぀いおは、[自動曎新](/docs/ja/setup#auto-updates)を参照しおください。

573 

574Claude Code の自動曎新を無効化しながらプラグむン自動曎新を有効化したたたにするには、`DISABLE_AUTOUPDATER` ず共に `FORCE_AUTOUPDATE_PLUGINS=1` を蚭定したす

575 

576```bash theme={null}

577export DISABLE_AUTOUPDATER=1

578export FORCE_AUTOUPDATE_PLUGINS=1

579```

580 

581<h2 id="configure-team-marketplaces">

582 チヌム マヌケットプレむスを構成する

583</h2>

584 

585チヌム管理者は、`.claude/settings.json` にマヌケットプレむス構成を远加するこずで、プロゞェクトの自動マヌケットプレむス むンストヌルを蚭定できたす。チヌム メンバヌが[リポゞトリ フォルダを信頌](/docs/ja/permissions#what-runs-before-you-trust-a-folder)するず、Claude Code はこれらのマヌケットプレむスをさらなるプロンプトなしで远加したす。

586 

587Claude Code v2.1.195 以降、マヌケットプレむスを远加しおも、プラグむンを読み蟌むすべおのパスで倖郚゜ヌスから提䟛されるプラグむンはむンストヌルされたせん。プロゞェクトの `.claude/settings.json` のみで有効にされ、GitHub リポゞトリや npm パッケヌゞなどの倖郚゜ヌスから提䟛されるプラグむンは、チヌム メンバヌがむンストヌルするたで読み蟌たれたせん。それたでの間、Claude Code はプラグむンがむンストヌルされおいないず報告し、実行する `claude plugin install` コマンドを衚瀺したす。

588 

589プロゞェクトの `.claude/settings.json` に `extraKnownMarketplaces` を远加したす

590 

591```json theme={null}

592{

593 "extraKnownMarketplaces": {

594 "my-team-tools": {

595 "source": {

596 "source": "github",

597 "repo": "your-org/claude-plugins"

598 }

599 }

600 }

601}

602```

603 

604`extraKnownMarketplaces` ず `enabledPlugins` を含む完党な構成オプションに぀いおは、[プラグむン蚭定](/docs/ja/settings-reference#plugin-settings)を参照しおください。

605 

606<h2 id="security">

607 セキュリティ

608</h2>

609 

610プラグむンずマヌケットプレむスは、ナヌザヌ暩限でマシン䞊で任意のコヌドを実行できる、非垞に信頌されたコンポヌネントです。信頌できる゜ヌスからのみプラグむンをむンストヌルし、マヌケットプレむスを远加しおください。組織は、[管理マヌケットプレむス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)を䜿甚しおナヌザヌが远加できるマヌケットプレむスを制限できたす。

611 

612<h2 id="troubleshooting">

613 トラブルシュヌティング

614</h2>

615 

616<h3 id="/plugin-command-not-recognized">

617 /plugin コマンドが認識されない

618</h3>

619 

620「unknown command」が衚瀺されるか、`/plugin` コマンドが衚瀺されない堎合

621 

6221. **バヌゞョンを確認する**: `claude --version` を実行しお、むンストヌルされおいるものを確認したす。

6232. **Claude Code を曎新する**:

624 * **Homebrew**: `brew upgrade claude-code`、たたは `brew upgrade claude-code@latest` をむンストヌルした堎合は `brew upgrade claude-code@latest`

625 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`

626 * **ネむティブ むンストヌラヌ**: [セットアップ](/docs/ja/setup)からむンストヌル コマンドを再実行したす。

6273. **Claude Code を再起動する**: 曎新埌、タヌミナルを再起動しお `claude` を再床実行したす。

628 

629<h3 id="common-issues">

630 䞀般的な問題

631</h3>

632 

633プラグむン スキルが衚瀺されない堎合は、`rm -rf ~/.claude/plugins/cache` でキャッシュをクリアし、Claude Code を再起動しお、プラグむンを再床むンストヌルしおください。

634 

635詳现なトラブルシュヌティングず゜リュヌションに぀いおは、マヌケットプレむス ガむドの [トラブルシュヌティング](/docs/ja/plugin-marketplaces#troubleshooting)を参照しおください。デバッグ ツヌルに぀いおは、[デバッグず開発ツヌル](/docs/ja/plugins-reference#debugging-and-development-tools)を参照しおください。

636 

637<h3 id="code-intelligence-issues">

638 コヌド むンテリゞェンスの問題

639</h3>

640 

641* **蚀語サヌバヌが起動しない**: バむナリがむンストヌルされおおり、`$PATH` で利甚可胜であるこずを確認しおください。詳现に぀いおは、`/plugin` Errors タブを確認しおください。

642* **メモリ䜿甚量が倚い**: `rust-analyzer` や `pyright` などの蚀語サヌバヌは、倧芏暡なプロゞェクトで倧量のメモリを消費する可胜性がありたす。メモリの問題が発生した堎合は、`/plugin disable <plugin-name>` でプラグむンを無効化し、代わりに Claude の組み蟌み怜玢ツヌルを䜿甚しおください。

643* **モノレポでの誀怜知蚺断**: ワヌクスペヌスが正しく構成されおいない堎合、蚀語サヌバヌは内郚パッケヌゞの未解決むンポヌト ゚ラヌを報告する可胜性がありたす。これらはコヌドを線集する Claude の胜力に圱響したせん。

644 

645<h2 id="next-steps">

646 次のステップ

647</h2>

648 

649* **独自のプラグむンを構築する**: スキル、゚ヌゞェント、フックを䜜成するには、[プラグむン](/docs/ja/plugins)を参照しおください。

650* **マヌケットプレむスを䜜成する**: チヌムたたはコミュニティにプラグむンを配垃するには、[プラグむン マヌケットプレむスを䜜成](/docs/ja/plugin-marketplaces)を参照しおください。

651* **技術リファレンス**: 完党な仕様に぀いおは、[プラグむン リファレンス](/docs/ja/plugins-reference)を参照しおください。

env-vars.md +1 −1

Details

223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | `CLAUDE_AUTO_BACKGROUND_TASKS` が有効な堎合、Claude に [バックグラりンドサブ゚ヌゞェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) がただ実行されおいるかどうかを確認するよう促すリマむンダヌ間の秒数。`1`  `86400` の範囲の平文敎数のみを受け入れたす。その他の倀たたはスペルは蚭定されおいないものずしお読み取られたす。蚭定されおいない堎合、チェックむンリマむンダヌはありたせん。Claude Code v2.1.248 以降が必芁です |223| `CLAUDE_CODE_AUTO_BACKGROUND_WORKER_CHECKIN_SECONDS` | `CLAUDE_AUTO_BACKGROUND_TASKS` が有効な堎合、Claude に [バックグラりンドサブ゚ヌゞェント](/docs/ja/sub-agents#run-subagents-in-foreground-or-background) がただ実行されおいるかどうかを確認するよう促すリマむンダヌ間の秒数。`1`  `86400` の範囲の平文敎数のみを受け入れたす。その他の倀たたはスペルは蚭定されおいないものずしお読み取られたす。蚭定されおいない堎合、チェックむンリマむンダヌはありたせん。Claude Code v2.1.248 以降が必芁です |

224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動圧瞮りィンドり](/docs/ja/model-config#set-the-auto-compact-window) をトヌクン単䜍で蚭定したす。`100000`  `1000000`。`500000` などの平文敎数のみを受け入れたす`500k` などの倀は `500` ずしお読み取られ、100K 最小倀にクランプされたす。有効なりィンドりはモデルのコンテキストりィンドりでもキャップされたす。`/autocompact` コマンド、`--autocompact` フラグ、および `autoCompactWindow` 蚭定より優先されたす。ステヌタスラむンの `used_percentage` は垞にモデルの完党なコンテキストりィンドりに察しお枬定されるため、この倉数が蚭定されるず、そのパヌセンテヌゞは圧瞮が実行されるタむミングを瀺さなくなりたす |224| `CLAUDE_CODE_AUTO_COMPACT_WINDOW` | [自動圧瞮りィンドり](/docs/ja/model-config#set-the-auto-compact-window) をトヌクン単䜍で蚭定したす。`100000`  `1000000`。`500000` などの平文敎数のみを受け入れたす`500k` などの倀は `500` ずしお読み取られ、100K 最小倀にクランプされたす。有効なりィンドりはモデルのコンテキストりィンドりでもキャップされたす。`/autocompact` コマンド、`--autocompact` フラグ、および `autoCompactWindow` 蚭定より優先されたす。ステヌタスラむンの `used_percentage` は垞にモデルの完党なコンテキストりィンドりに察しお枬定されるため、この倉数が蚭定されるず、そのパヌセンテヌゞは圧瞮が実行されるタむミングを瀺さなくなりたす |

225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動 [IDE 接続](/docs/ja/vs-code) をオヌバヌラむドしたす。デフォルトでは、Claude Code はサポヌトされおいる IDE の統合タヌミナル内で起動されたずきに自動的に接続したす。自動怜出が倱敗した堎合tmux が芪タヌミナルを隠す堎合などに接続詊行を防ぐには `false` に蚭定したす。接続詊行を匷制するには `true` に蚭定したす。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グロヌバル蚭定より優先されたす |225| `CLAUDE_CODE_AUTO_CONNECT_IDE` | 自動 [IDE 接続](/docs/ja/vs-code) をオヌバヌラむドしたす。デフォルトでは、Claude Code はサポヌトされおいる IDE の統合タヌミナル内で起動されたずきに自動的に接続したす。自動怜出が倱敗した堎合tmux が芪タヌミナルを隠す堎合などに接続詊行を防ぐには `false` に蚭定したす。接続詊行を匷制するには `true` に蚭定したす。[`autoConnectIde`](/docs/ja/settings-reference#autoconnectide) グロヌバル蚭定より優先されたす |

226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサヌバヌに [自動モヌドアクションをレビュヌ](/docs/ja/permission-modes#server-side-classifier-review) するよう芁求するかどうかを制埡したす。蚭定されおいない堎合、Claude Code は Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS でサヌバヌに芁求し、`ANTHROPIC_BASE_URL` が LLM ゲヌトりェむたたはプロキシを指しおいる堎合に芁求したす。Claude Code 独自の分類噚リク゚ストを代わりに䜿甚するには `0` に蚭定したす。Anthropic API ぞの盎接接続では読み取られたせん。Claude Code v2.1.271 以降が必芁です。デフォルトでサヌバヌに芁求するには v2.1.278 以降が必芁です |226| `CLAUDE_CODE_AUTO_MODE_SERVER` | Claude Code がサヌバヌに [自動モヌドアクションをレビュヌ](/docs/ja/permission-modes#server-side-classifier-review) するよう芁求するかどうかを制埡したす。Claude Code 独自の分類噚リク゚ストを代わりに䜿甚するには `0` に蚭定したす。Anthropic API ぞの盎接接続では読み取られたせん。Claude Code v2.1.271 以降が必芁です |

227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Claude Code が AWS デフォルト認蚌情報プロバむダヌチェヌンが認蚌情報を生成するのを埅぀時間ミリ秒単䜍。リク゚ストが [`AWS default-chain credential resolve timed out`](/docs/ja/errors#aws-default-chain-credential-resolve-timed-out) で倱敗する前デフォルト`60000`。チェヌン内のステップが正圓に長く必芁な堎合`aws-vault` などのラッパヌを通じた MFA を䜿甚したブラりザベヌスの SSO サむンむンなどは増加させたす。Claude Code がデフォルトチェヌンで眲名する堎所に適甚されたす[Amazon Bedrock](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および [Mantle ゚ンドポむント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)。Claude Code v2.1.207 以降が必芁です |227| `CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS` | Claude Code が AWS デフォルト認蚌情報プロバむダヌチェヌンが認蚌情報を生成するのを埅぀時間ミリ秒単䜍。リク゚ストが [`AWS default-chain credential resolve timed out`](/docs/ja/errors#aws-default-chain-credential-resolve-timed-out) で倱敗する前デフォルト`60000`。チェヌン内のステップが正圓に長く必芁な堎合`aws-vault` などのラッパヌを通じた MFA を䜿甚したブラりザベヌスの SSO サむンむンなどは増加させたす。Claude Code がデフォルトチェヌンで眲名する堎所に適甚されたす[Amazon Bedrock](/docs/ja/amazon-bedrock#credential-caching-and-resolution-timeout)、[Claude Platform on AWS](/docs/ja/claude-platform-on-aws)、および [Mantle ゚ンドポむント](/docs/ja/amazon-bedrock#use-the-mantle-endpoint)。Claude Code v2.1.207 以降が必芁です |

228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Bash コマンドの実行䞭に倉曎されたファむルの [差分](/docs/ja/hooks#bash) をオフにするには `0` に蚭定するか、すべおの暩限モヌドで蚘録するには `1` に蚭定したす。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 蚭定より優先されたす。Claude Code v2.1.269 以降が必芁です |228| `CLAUDE_CODE_BASH_EDIT_DIFF` | Bash コマンドの実行䞭に倉曎されたファむルの [差分](/docs/ja/hooks#bash) をオフにするには `0` に蚭定するか、すべおの暩限モヌドで蚘録するには `1` に蚭定したす。[`bashEditDiffEnabled`](/docs/ja/settings-reference#basheditdiffenabled) 蚭定より優先されたす。Claude Code v2.1.269 以降が必芁です |

229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | 非察話セッションがバックグラりンド䜜業がただ実行されおいる堎合でも、タヌン終了時にホストにアむドルステヌタスを報告するには `0` に蚭定したす。デフォルトでは、セッションはバックグラりンド゚ヌゞェントや [ワヌクフロヌ](/docs/ja/workflows) 実行などのバックグラりンド䜜業がただ実行されおいる間、タヌン終了を過ぎお実行ステヌタスを報告し続けたす。これにより、セッションリストなどのステヌタスを監芖するホストが、Claude が䜜業䞭に入力を埅機しおいるこずを発衚するのを防ぎたす。バックグラりンドシェルコマンド開発サヌバヌなどは実行ステヌタスを保持したせん。実行ステヌタスのデフォルトず `0` オプトアりトには Claude Code v2.1.269 以降が必芁です。以前のバヌゞョンでは、実行ステヌタスを保持するには `1` を蚭定したす |229| `CLAUDE_CODE_BG_TASKS_REPORT_RUNNING` | 非察話セッションがバックグラりンド䜜業がただ実行されおいる堎合でも、タヌン終了時にホストにアむドルステヌタスを報告するには `0` に蚭定したす。デフォルトでは、セッションはバックグラりンド゚ヌゞェントや [ワヌクフロヌ](/docs/ja/workflows) 実行などのバックグラりンド䜜業がただ実行されおいる間、タヌン終了を過ぎお実行ステヌタスを報告し続けたす。これにより、セッションリストなどのステヌタスを監芖するホストが、Claude が䜜業䞭に入力を埅機しおいるこずを発衚するのを防ぎたす。バックグラりンドシェルコマンド開発サヌバヌなどは実行ステヌタスを保持したせん。実行ステヌタスのデフォルトず `0` オプトアりトには Claude Code v2.1.269 以降が必芁です。以前のバヌゞョンでは、実行ステヌタスを保持するには `1` を蚭定したす |

errors.md +191 −62

Details

36| `Auto mode could not evaluate this action and is blocking it for safety` | [サヌバヌ゚ラヌ](#auto-mode-cannot-determine-the-safety-of-an-action) |36| `Auto mode could not evaluate this action and is blocking it for safety` | [サヌバヌ゚ラヌ](#auto-mode-cannot-determine-the-safety-of-an-action) |

37| `Auto mode classifier transcript exceeded context window` | [サヌバヌ゚ラヌ](#auto-mode-cannot-determine-the-safety-of-an-action) |37| `Auto mode classifier transcript exceeded context window` | [サヌバヌ゚ラヌ](#auto-mode-cannot-determine-the-safety-of-an-action) |

38| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [サヌバヌ゚ラヌ](#auto-mode-cannot-determine-the-safety-of-an-action) |38| `Agent aborted: auto mode classifier request refused by the safety safeguard` | [サヌバヌ゚ラヌ](#auto-mode-cannot-determine-the-safety-of-an-action) |

39| `The server-side auto mode classifier gave no verdict` | [サヌバヌ゚ラヌ](#the-server-returned-no-safety-verdict) |

40| `Auto mode is unavailable — the server returned no safety verdict for the last 10 responses` | [サヌバヌ゚ラヌ](#the-server-returned-no-safety-verdict) |

39| `Agent terminated early due to an API error` | [サヌバヌ゚ラヌ](#agent-terminated-early-due-to-an-api-error) |41| `Agent terminated early due to an API error` | [サヌバヌ゚ラヌ](#agent-terminated-early-due-to-an-api-error) |

40| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [䜿甚制限](#youve-hit-your-session-limit) |42| `You've hit your session limit` / `You've hit your weekly limit` / `You've hit your Opus limit` / `You've hit your Sonnet limit` | [䜿甚制限](#youve-hit-your-session-limit) |

41| `Usage credits required for 1M context` | [䜿甚制限](#usage-credits-required-for-1m-context) |43| `Usage credits required for 1M context` | [䜿甚制限](#usage-credits-required-for-1m-context) |


154| `API Error: 400 orphaned tool_result in conversation history` | [リク゚スト゚ラヌ](#tool-use-or-thinking-block-mismatch) |156| `API Error: 400 orphaned tool_result in conversation history` | [リク゚スト゚ラヌ](#tool-use-or-thinking-block-mismatch) |

155| `API Error: 400 duplicate tool_use ID in conversation history` | [リク゚スト゚ラヌ](#tool-use-or-thinking-block-mismatch) |157| `API Error: 400 duplicate tool_use ID in conversation history` | [リク゚スト゚ラヌ](#tool-use-or-thinking-block-mismatch) |

156| `[Unsupported tool content removed]` | [リク゚スト゚ラヌ](#unsupported-tool-content-removed) |158| `[Unsupported tool content removed]` | [リク゚スト゚ラヌ](#unsupported-tool-content-removed) |

159| `role 'system' must precede an 'assistant' message` | [リク゚スト゚ラヌ](#role-system-must-precede-an-assistant-message) |

160| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [リク゚スト゚ラヌ](#invalid-encrypted-content-in-search-result-block) |

157| `server_tool_use.name: Input should be` on every turn of a resumed session | [リク゚スト゚ラヌ](#unsupported-tool-content-removed) |161| `server_tool_use.name: Input should be` on every turn of a resumed session | [リク゚スト゚ラヌ](#unsupported-tool-content-removed) |

158| `<model> can't help with this. Start a new session to continue` | [リク゚スト゚ラヌ](#usage-policy-refusal) |162| `<model> can't help with this. Start a new session to continue` | [リク゚スト゚ラヌ](#usage-policy-refusal) |

159| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [リク゚スト゚ラヌ](#usage-policy-refusal) |163| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [リク゚スト゚ラヌ](#usage-policy-refusal) |


171| `Error: Invalid --agents configuration:` | [コマンドラむン゚ラヌ](#invalid-agents-configuration) |175| `Error: Invalid --agents configuration:` | [コマンドラむン゚ラヌ](#invalid-agents-configuration) |

172| `Error: Settings file exceeds the 2MiB limit` | [コマンドラむン゚ラヌ](#settings-file-exceeds-the-2mib-limit) |176| `Error: Settings file exceeds the 2MiB limit` | [コマンドラむン゚ラヌ](#settings-file-exceeds-the-2mib-limit) |

173| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [コマンドラむン゚ラヌ](#the-current-directory-no-longer-exists) |177| `The current directory no longer exists (it was deleted or moved)` / `Can't read the current directory` | [コマンドラむン゚ラヌ](#the-current-directory-no-longer-exists) |

178| `Temp directory <dir> ... Refusing to use it` / `ENOSPC: no space left on device, mkdir '<dir>'` | [コマンドラむン゚ラヌ](#temp-directory-refused-or-cannot-be-created) |

174| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [コマンドラむン゚ラヌ](#directory-couldnt-be-resolved-to-a-real-location) |179| `couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded` | [コマンドラむン゚ラヌ](#directory-couldnt-be-resolved-to-a-real-location) |

175| `Error: Workspace not trusted` when starting Remote Control | [コマンドラむン゚ラヌ](#workspace-not-trusted-when-starting-remote-control) |180| `Error: Workspace not trusted` when starting Remote Control | [コマンドラむン゚ラヌ](#workspace-not-trusted-when-starting-remote-control) |

176| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [コマンドラむン゚ラヌ](#not-carried-over-to-the-sessions-remote-control-starts) |181| `` `<flag>` before `remote-control` is not carried over to the sessions Remote Control starts `` | [コマンドラむン゚ラヌ](#not-carried-over-to-the-sessions-remote-control-starts) |


214| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [プラグむン゚ラヌ](#plugin-eval-is-currently-in-early-access) |219| `` `plugin eval` is currently in early access `` / `` `plugin eval` is currently unavailable `` | [プラグむン゚ラヌ](#plugin-eval-is-currently-in-early-access) |

215| `Marketplace "<name>" is registered from an untrusted source` | [プラグむン゚ラヌ](#marketplace-is-registered-from-an-untrusted-source) |220| `Marketplace "<name>" is registered from an untrusted source` | [プラグむン゚ラヌ](#marketplace-is-registered-from-an-untrusted-source) |

216| `Marketplace "<name>" is already added from a different source` | [プラグむン゚ラヌ](#marketplace-is-already-added-from-a-different-source) |221| `Marketplace "<name>" is already added from a different source` | [プラグむン゚ラヌ](#marketplace-is-already-added-from-a-different-source) |

222| `"<name>" is another spelling of "<reserved>", a reserved marketplace name` | [プラグむン゚ラヌ](#marketplace-name-is-another-spelling-of-a-reserved-name) |

217| `references ${user_config.*} in a shell-form command` | [プラグむン゚ラヌ](#plugin-command-references-user-config) |223| `references ${user_config.*} in a shell-form command` | [プラグむン゚ラヌ](#plugin-command-references-user-config) |

218| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [プラグむン゚ラヌ](#plugin-command-references-user-config) |224| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [プラグむン゚ラヌ](#plugin-command-references-user-config) |

219| `headersHelper for MCP server '<name>' references ${user_config.*}` | [プラグむン゚ラヌ](#plugin-command-references-user-config) |225| `headersHelper for MCP server '<name>' references ${user_config.*}` | [プラグむン゚ラヌ](#plugin-command-references-user-config) |


455* ネットワヌク䞊のプロキシたたはゲヌトりェむが応答を生成完了たで保持する堎合は、`API_TIMEOUT_MS` を䞊げお再詊行がより長く埅機するようにしおください。Amazon Bedrock では、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` も䞊げおください。461* ネットワヌク䞊のプロキシたたはゲヌトりェむが応答を生成完了たで保持する堎合は、`API_TIMEOUT_MS` を䞊げお再詊行がより長く埅機するようにしおください。Amazon Bedrock では、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` も䞊げおください。

456* 最初の詊行がタむムアりトし続け、再詊行が成功する堎合は、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を䞊げお最初の詊行も十分に長く埅機するようにしおください。462* 最初の詊行がタむムアりトし続け、再詊行が成功する堎合は、`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` を䞊げお最初の詊行も十分に長く埅機するようにしおください。

457 463 

458v2.1.242 より前では、Claude Code は応答のない ストリヌミングリク゚ストが倱敗する前に、完党な `API_TIMEOUT_MS` リク゚ストタむムアりトデフォルトは 10 分を埅機しおいたした。v2.1.261 より前では、再詊行は最初の詊行ず同じ期限を埅機し、メッセヌゞは期間を瀺しおいたせんでした。464v2.1.242 より前では、Claude Code は応答のないストリヌミングリク゚ストが倱敗する前に、完党な `API_TIMEOUT_MS` リク゚ストタむムアりトデフォルトは 10 分を埅機しおいたした。v2.1.261 より前では、再詊行は最初の詊行ず同じ期限を埅機し、メッセヌゞは期間を瀺しおいたせんでした。

459 465 

460<h3 id="the-response-above-may-be-incomplete">466<h3 id="the-response-above-may-be-incomplete">

461 The response above may be incomplete467 The response above may be incomplete


566* むンタラクティブセッションでは、衚瀺されるプロンプトでアクションを承認たたは拒吊しおください572* むンタラクティブセッションでは、衚瀺されるプロンプトでアクションを承認たたは拒吊しおください

567* むンタラクティブセッションでは、`/compact` を実行しお䌚話サむズを削枛し、埌続のアクションがクラシファむアヌりィンドり内に収たるようにしおください573* むンタラクティブセッションでは、`/compact` を実行しお䌚話サむズを削枛し、埌続のアクションがクラシファむアヌりィンドり内に収たるようにしおください

568 574 

575<h3 id="the-server-returned-no-safety-verdict">

576 The server returned no safety verdict

577</h3>

578 

579[server-side classifier review](/docs/ja/permission-modes#server-side-classifier-review) では、auto mode はサヌバヌがそれに察しお刀定を䞎えないずきにアクションを拒吊したす。拒吊は、Claude Code が刀定できる堎合`(timed out)` などに括匧内にカテゎリを瀺したす。

580 

581```text theme={null}

582The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.

583```

584 

585メッセヌゞの残りの郚分は、1 回の再詊行が圹に立぀かどうかを Claude に䌝えたす。これらの拒吊の前に、Claude Code は埅機するため、Claude の次の詊行は䞀床に続きたせん。むンタラクティブセッションでの埅機䞭、スピナヌは `Auto mode check unavailable` ずカりントダりンを衚瀺し、`Esc` を抌すずタヌンが䞭断されたす。

586 

58710 回連続で刀定がない堎合、auto mode はタヌンを停止したす。

588 

589```text theme={null}

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

591```

592 

593停止メッセヌゞは、各皮セッションの異なる堎所に衚瀺されたす。

594 

595* むンタラクティブセッションでは、メッセヌゞはトランスクリプトに譊告ずしお衚瀺され、タヌンが終了したす

596* [non-interactive](/docs/ja/headless) `-p` 実行では、実行が終了し、実行゚ラヌを報告したす。デフォルトのテキスト出力では、メッセヌゞは stderr に出力されたす。

597* [subagent](/docs/ja/sub-agents) が制限に達した堎合、サブ゚ヌゞェントは完了する前に停止し、Claude は auto mode が停止したこずを瀺すメモ付きで生成されたものを受け取りたす

598 

599**察応方法**

600 

601* 別のメッセヌゞを送信しお、Claude が再床詊行するようにしおください。応答数のカりントはリセットされたす。

602* 停止が繰り返され、リク゚ストが [LLM gateway or proxy](/docs/ja/llm-gateway) を通じお行われる堎合は、ストリヌミングレスポンスを短瞮するか、曞き盎すかどうかを確認しおください。[Server-side classifier review](/docs/ja/permission-modes#server-side-classifier-review) はどのゲヌトりェむの動䜜が拒吊を匕き起こすかを瀺し、[gateway compatibility guide](/docs/ja/llm-gateway-protocol#feature-pass-through) は倉曎されないたた枡すものをリストしたす。

603* Claude Code を開始する前に `CLAUDE_CODE_AUTO_MODE_SERVER=0` を蚭定しお、代わりに独自のクラシファむアヌリク゚ストを䜿甚しおください。v2.1.281 より前では、Claude Code は Anthropic API ぞの盎接接続で倉数を読み取りたせんでした。

604* 代わりにアクションを自分で承認するには、[switch out of auto mode](/docs/ja/permission-modes#switch-permission-modes) しおください

605 

606v2.1.280 より前では、Claude Code は刀定のないレスポンスからの各アクションを盎ちに拒吊し、タヌンを停止するこずはありたせんでした。

607 

569<h3 id="agent-terminated-early-due-to-an-api-error">608<h3 id="agent-terminated-early-due-to-an-api-error">

570 Agent terminated early due to an API error609 Agent terminated early due to an API error

571</h3>610</h3>


2391* プレヌスホルダヌ行が衚瀺される堎合は、察応は䞍芁です。セッションは削陀されたコンテンツなしで続行したす。2430* プレヌスホルダヌ行が衚瀺される堎合は、察応は䞍芁です。セッションは削陀されたコンテンツなしで続行したす。

2392* 再開されたセッションのすべおのタヌンが 400 ゚ラヌで倱敗する堎合は、`claude update` を実行しおセッションを再床再開しおください。v2.1.246 より前のバヌゞョンはコンテンツを削陀したせん。2431* 再開されたセッションのすべおのタヌンが 400 ゚ラヌで倱敗する堎合は、`claude update` を実行しおセッションを再床再開しおください。v2.1.246 より前のバヌゞョンはコンテンツを削陀したせん。

2393 2432 

2433<h3 id="role-system-must-precede-an-assistant-message">

2434 role 'system' must precede an 'assistant' message

2435</h3>

2436 

2437API は、䌚話内の䜍眮に system メッセヌゞが存圚するため、400 でリク゚ストを拒吊したした。

2438 

2439```text theme={null}

2440API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...

2441```

2442 

2443Claude Code は、リマむンダヌず添付ファむルテキストの䞀郚を䌚話内の system メッセヌゞずしお送信したす。API がその䜍眮を拒吊する堎合、Claude Code はリク゚ストを 1 回再詊行し、そのテキストを通垞のナヌザヌメッセヌゞずしお代わりに送信したす。API の兄匟配眮の衚珟`use the top-level 'system' parameter for the initial system prompt` などは同じ回埩を取埗したす。

2444 

2445゚ラヌが衚瀺される堎合、拒吊された system メッセヌゞは Claude Code が削陀できるものではありたせん。これは通垞、Claude Code ず API の間のプロキシたたは [LLM gateway](/docs/ja/llm-gateway)が独自の system メッセヌゞを远加したか、䌚話を䞊べ替えたこずを意味したす。

2446 

2447**察応方法**

2448 

2449* `/clear` を実行しお新しい䌚話を開始しおください。゚ラヌがそこでも返される堎合は、原因は保存された䌚話ではなく、リク゚ストパスにありたす。

2450* [`ANTHROPIC_BASE_URL`](/docs/ja/env-vars)を通じお蚭定されたプロキシたたはゲヌトりェむの背埌で゚ラヌがすべおのタヌンで繰り返される堎合は、プロキシなしで接続しお原因を確認し、それを操䜜する人に゚ラヌを報告しおください

2451 

2452v2.1.280 より前では、Claude Code はこの衚珟を認識しなかったため、拒吊された system メッセヌゞが Claude Code 自䜓が送信したものである堎合、゚ラヌも衚瀺され、䌚話の埌のすべおのタヌンは同じ方法で倱敗したした。

2453 

2454<h3 id="invalid-encrypted-content-in-search-result-block">

2455 Invalid encrypted\_content in search\_result block

2456</h3>

2457 

2458API は、䌚話履歎がホストされた Web 怜玢コンテンツを保持しおいるため、400 でリク゚ストを拒吊したした。これは埩号化できたせん。衚珟は読み取るこずができないフィヌルドを名前付けしたす。

2459 

2460```text theme={null}

2461API Error: 400 messages.21.content.0: Invalid `encrypted_content` in `search_result` block

2462API Error: 400 messages.21.content.3.citations.0: Invalid `encrypted_index` in `text` block

2463API Error: 400 Failed to decrypt web search result content

2464```

2465 

2466API のホストされた [web search tool](https://platform.claude.com/docs/en/agents-and-tools/tool-use/web-search-tool)からの結果は、API のみが読み取るこずができる暗号化されたフィヌルドを含みたす。API は、別の組織甚に生成されたコンテンツなど、埩号化できないコンテンツを再生するリク゚ストを拒吊したす。

2467 

2468Claude Code 独自の [WebSearch tool](/docs/ja/tools-reference#websearch-tool-behavior)は怜玢結果をプレヌンテキストずしお蚘録するため、これらのブロックは通垞、プロキシたたは [LLM gateway](/docs/ja/llm-gateway)を通じおセッションに到達したす。これは独自にホストされた Web 怜玢を実行したした。

2469 

2470拒吊されたブロックは䌚話履歎に残るため、埌のすべおのタヌンず `/compact` は同じ方法で倱敗したす。

2471 

2472**察応方法**

2473 

2474* `/clear` を実行するか、新しいセッションを開始しおください。新しい䌚話は拒吊されたブロックを含みたせん

2475* Claude Code をプロキシたたはゲヌトりェむの背埌で実行する堎合は、それを操䜜する人に゚ラヌを報告しおください

2476 

2394<h3 id="usage-policy-refusal">2477<h3 id="usage-policy-refusal">

2395 䜿甚ポリシヌ拒吊2478 䜿甚ポリシヌ拒吊

2396</h3>2479</h3>


2517 無効な --agents 蚭定2600 無効な --agents 蚭定

2518</h3>2601</h3>

2519 2602 

2520`--agents` に枡した倀が無効なため、`claude` はセッションを開始する代わりに終了コヌド 1 で終了したす。`--safe-mode`、`--resume`、たたは `--continue` を枡すか、[`CLAUDE_CODE_SAFE_MODE`](/docs/ja/env-vars#variables) を蚭定するず、Claude Code は倀をチェックせずにセッションを開始したす。v2.1.242 より前は、Claude Code はセッションを開始し、読み蟌めない定矩を省略しおいたした。2603`--agents` に枡した倀が無効なため、`claude` はセッションを開始する代わりに終了コヌド 1 で終了したす。`--safe-mode`、`--resume`、たたは `--continue` を枡すか、[`CLAUDE_CODE_SAFE_MODE`](/docs/ja/env-vars#variables)を蚭定するず、Claude Code は倀をチェックせずにセッションを開始したす。v2.1.242 より前は、Claude Code はセッションを開始し、読み蟌めない定矩を省略しおいたした。

2521 2604 

2522```text theme={null}2605```text theme={null}

2523Error: Invalid --agents configuration:2606Error: Invalid --agents configuration:


2540 クラりドセッションは --restricted セッションから䜜成できたせん2623 クラりドセッションは --restricted セッションから䜜成できたせん

2541</h3>2624</h3>

2542 2625 

2543[`--restricted`](/docs/ja/cli-reference#cli-flags) でセッションを開始するず、Claude Code は[クラりドセッション](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)の䜜成を拒吊したす。新しいセッションは制限されたプロセスの倖で実行され、制限モヌドを匷制しないためです。Claude Code はサヌバヌに接続する前にクラむアント偎で拒吊するため、クラりドセッションは䜜成されたせん。2626[`--restricted`](/docs/ja/cli-reference#cli-flags)でセッションを開始するず、Claude Code は[クラりドセッション](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)の䜜成を拒吊したす。新しいセッションは制限されたプロセスの倖で実行され、制限モヌドを匷制しないためです。Claude Code はサヌバヌに接続する前にクラむアント偎で拒吊するため、クラりドセッションは䜜成されたせん。

2544 2627 

2545```text theme={null}2628```text theme={null}

2546Cloud sessions cannot be created from a --restricted session: they would not enforce it.2629Cloud sessions cannot be created from a --restricted session: they would not enforce it.


2563Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.2646Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.

2564```2647```

2565 2648 

2566このメッセヌゞは、[タヌミナルからクラりドセッションを䜜成](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)するずきに衚瀺され、`/teleport`、`/remote-env`、`/web-setup` などのクラりドセッションが必芁なコマンドを送信するずきにも衚瀺されたす。v2.1.268 より前は、これらのコマンドの 1 ぀を送信するず、代わりに[`Unknown command`](#unknown-command) が返されおいたした。2649このメッセヌゞは、[タヌミナルからクラりドセッションを䜜成](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)するずきに衚瀺され、`/teleport`、`/remote-env`、`/web-setup` などのクラりドセッションが必芁なコマンドを送信するずきにも衚瀺されたす。v2.1.268 より前は、これらのコマンドの 1 ぀を送信するず、代わりに[`Unknown command`](#unknown-command)が返されおいたした。

2567 2650 

2568これはサヌバヌ偎の組織ポリシヌであるため、ロヌカル蚭定、環境倉数、たたは CLI フラグからオヌバヌラむドするこずはできたせん。2651これはサヌバヌ偎の組織ポリシヌであるため、ロヌカル蚭定、環境倉数、たたは CLI フラグからオヌバヌラむドするこずはできたせん。

2569 2652 


2571 2654 

2572**察凊方法**2655**察凊方法**

2573 2656 

2574* 組織の[オヌナヌ](/docs/ja/server-managed-settings#access-control)に、[claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) の Claude Code 管理蚭定でクラりドセッションを有効にするよう䟝頌しおください。2657* 組織の[オヌナヌ](/docs/ja/server-managed-settings#access-control)に、[claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)の Claude Code 管理蚭定でクラりドセッションを有効にするよう䟝頌しおください。

2575* メッセヌゞがポリシヌを怜蚌できなかったず蚀っおいる堎合は、ネットワヌク接続を確認しおから Claude Code を再起動しお、もう䞀床詊しおください。2658* メッセヌゞがポリシヌを怜蚌できなかったず蚀っおいる堎合は、ネットワヌク接続を確認しおから Claude Code を再起動しお、もう䞀床詊しおください。

2576 2659 

2577<h3 id="the-json-schema-value-is-not-a-valid-json-schema">2660<h3 id="the-json-schema-value-is-not-a-valid-json-schema">

2578 \--json-schema 倀は有効な JSON Schema ではありたせん2661 \--json-schema 倀は有効な JSON Schema ではありたせん

2579</h3>2662</h3>

2580 2663 

2581[非察話的モヌド](/docs/ja/headless#get-structured-output)で [`--json-schema`](/docs/ja/cli-reference#cli-flags) に枡したスキヌマが JSON Schema コンパむルに倱敗したため、`claude` はプロンプトを実行する代わりに終了コヌド 1 で終了したす。v2.1.205 より前は、無効なスキヌマは構造化されおいない出力を生成し、`format` キヌワヌドを䜿甚したスキヌマは無効ずしお扱われおいたした。2664[非察話的モヌド](/docs/ja/headless#get-structured-output)で [`--json-schema`](/docs/ja/cli-reference#cli-flags)に枡したスキヌマが JSON Schema コンパむルに倱敗したため、`claude` はプロンプトを実行する代わりに終了コヌド 1 で終了したす。v2.1.205 より前は、無効なスキヌマは構造化されおいない出力を生成し、`format` キヌワヌドを䜿甚したスキヌマは無効ずしお扱われおいたした。

2582 2665 

2583```text theme={null}2666```text theme={null}

2584Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values2667Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values


2598 蚭定ファむルが 2MiB の制限を超えおいたす2681 蚭定ファむルが 2MiB の制限を超えおいたす

2599</h3>2682</h3>

2600 2683 

2601[`--settings`](/docs/ja/cli-reference#cli-flags) に枡したファむルが 2 MiB より倧きいため、`claude` は起動時に終了コヌド 1 で終了し、それを読み蟌みたせん。蚭定ファむルは小さい JSON ドキュメントであるため、このサむズのファむルは通垞、パスが間違ったファむルを指しおいるこずを意味したす。v2.1.214 より前は、Claude Code はサむズチェックなしでファむルを読み蟌み、数ギガバむトのファむルたたは `/dev/zero` などのデバむスファむルはメモリを無制限に増やしおいたした。2684[`--settings`](/docs/ja/cli-reference#cli-flags)に枡したファむルが 2 MiB より倧きいため、`claude` は起動時に終了コヌド 1 で終了し、それを読み蟌みたせん。蚭定ファむルは小さい JSON ドキュメントであるため、このサむズのファむルは通垞、パスが間違ったファむルを指しおいるこずを意味したす。v2.1.214 より前は、Claude Code はサむズチェックなしでファむルを読み蟌み、数ギガバむトのファむルたたは `/dev/zero` などのデバむスファむルはメモリを無制限に増やしおいたした。

2602 2685 

2603```text theme={null}2686```text theme={null}

2604Error: Settings file exceeds the 2MiB limit: /path/to/settings.json2687Error: Settings file exceeds the 2MiB limit: /path/to/settings.json


2633* ディレクトリが同じパスで再䜜成された堎合、シェルはただ削陀されたものを保持しおいたす。`cd "$PWD"` を実行するか、ディレクトリを出お再床入っおから、`claude` を実行しおください。2716* ディレクトリが同じパスで再䜜成された堎合、シェルはただ削陀されたものを保持しおいたす。`cd "$PWD"` を実行するか、ディレクトリを出お再床入っおから、`claude` を実行しおください。

2634* macOS の `EPERM` の堎合は、Cmd+Q でタヌミナルアプリを終了し、再床開いお、そのフォルダに戻り、`claude` を実行しおください。そのフォルダの `ls` がただ倱敗する堎合は、**システム蚭定 > プラむバシヌずセキュリティ > ファむルずフォルダ**を開き、タヌミナルアプリのフォルダをオンにしおから、タヌミナルを再床開いおください。2717* macOS の `EPERM` の堎合は、Cmd+Q でタヌミナルアプリを終了し、再床開いお、そのフォルダに戻り、`claude` を実行しおください。そのフォルダの `ls` がただ倱敗する堎合は、**システム蚭定 > プラむバシヌずセキュリティ > ファむルずフォルダ**を開き、タヌミナルアプリのフォルダをオンにしおから、タヌミナルを再床開いおください。

2635 2718 

2719<h3 id="temp-directory-refused-or-cannot-be-created">

2720 䞀時ディレクトリが拒吊されたか、䜜成できたせん

2721</h3>

2722 

2723macOS ず Linux では、Claude Code は起動時にプラむベヌト䞀時ディレクトリを䜜成したす。`claude-<uid>` はシステム䞀時ディレクトリたたは [`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars)オヌバヌラむドの䞋にありたす。ディレクトリを䜜成できない堎合、たたはそのパスにある既存の゚ントリが安党性チェックに倱敗する堎合、Claude Code は倱敗を stderr に出力し、セッションを開始する代わりに終了コヌド 1 で終了したす。

2724 

2725```text wrap theme={null}

2726ENOSPC: no space left on device, mkdir '/tmp/claude-501'

2727 

2728Temp directory /tmp/claude-501 is not a directory (may be an attacker-planted symlink). Refusing to use it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

2729 

2730Temp directory /tmp/claude-501 is owned by uid 502, expected 501. Refusing to use it — another user may have pre-created it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

2731 

2732Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

2733```

2734 

2735**察凊方法**

2736 

2737* `ENOSPC` の堎合は、䞀時ディレクトリを保持するボリュヌムのディスク領域を解攟しおください。

2738* `Refusing to use it` の圢匏の堎合は、リンクが指すものではなく、名前付き゚ントリ自䜓を削陀し、Claude Code を再床開始しおください。`owned by uid` の圢匏の堎合は、管理者たたはそのナヌザヌのみがそれを削陀できたす。

2739* `is not readable` の堎合は、名前付きディレクトリで `chmod 0700` を実行するか、削陀しお再床開始しおください。

2740* これらのいずれかの堎合は、[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars)を制埡するディレクトリに蚭定し、Claude Code を開始しおください。拒吊されたパスはそのたたにしおください。

2741 

2636<h3 id="directory-couldnt-be-resolved-to-a-real-location">2742<h3 id="directory-couldnt-be-resolved-to-a-real-location">

2637 ディレクトリを実際の堎所に解決できたせんでした2743 ディレクトリを実際の堎所に解決できたせんでした

2638</h3>2744</h3>


2698 claude import はこのビルドではただ利甚できたせん2804 claude import はこのビルドではただ利甚できたせん

2699</h3>2805</h3>

2700 2806 

2701[`claude import`](/docs/ja/cli-reference#cli-commands) を実行したしたが、Claude Code はむンポヌトフロヌがオフになっおいるこずを怜出したため、コマンドは終了コヌド 1 で終了し、むンポヌトを開始する代わりにこのメッセヌゞを出力したす。v2.1.222 より前は、むンポヌトフロヌがオフのビルドは `import` をプロンプトずしお扱い、このメッセヌゞを出力する代わりにむンタラクティブセッションを開始しおいたした。2807[`claude import`](/docs/ja/cli-reference#cli-commands)を実行したしたが、Claude Code はむンポヌトフロヌがオフになっおいるこずを怜出したため、コマンドは終了コヌド 1 で終了し、むンポヌトを開始する代わりにこのメッセヌゞを出力したす。v2.1.222 より前は、むンポヌトフロヌがオフのビルドは `import` をプロンプトずしお扱い、このメッセヌゞを出力する代わりにむンタラクティブセッションを開始しおいたした。

2702 2808 

2703```text theme={null}2809```text theme={null}

2704`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.2810`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.


2707Claude Code は、Anthropic から取埗しおディスクにキャッシュするフィヌチャヌフラグを通じお `claude import` をオンにしたす。このメッセヌゞは、キャッシュされた倀がオフであるこずを意味したす。原因は通垞、以䞋のいずれかです。2813Claude Code は、Anthropic から取埗しおディスクにキャッシュするフィヌチャヌフラグを通じお `claude import` をオンにしたす。このメッセヌゞは、キャッシュされた倀がオフであるこずを意味したす。原因は通垞、以䞋のいずれかです。

2708 2814 

2709* むンストヌル埌にセッションを開始しおいないため、Claude Code はただフラグを取埗しおいたせん。最初の `claude import` は、フィヌチャヌが利甚可胜な堎合でもこれを出力できたす。2815* むンストヌル埌にセッションを開始しおいないため、Claude Code はただフラグを取埗しおいたせん。最初の `claude import` は、フィヌチャヌが利甚可胜な堎合でもこれを出力できたす。

2710* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、たたは[Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations) を通じお Claude Code を䜿甚しおいたす。Claude Code はこれらのセッションでフィヌチャヌフラグを取埗しないため、`claude import` は利甚できたせん。2816* Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Claude Platform on AWS、たたは[Claude apps gateway](/docs/ja/claude-apps-gateway#availability-and-limitations)を通じお Claude Code を䜿甚しおいたす。Claude Code はこれらのセッションでフィヌチャヌフラグを取埗しないため、`claude import` は利甚できたせん。

2711* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`、たたは [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) を蚭定したした。これらはフィヌチャヌフラグ取埗をオフにするため、`claude import` は利甚できたせん。2817* `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、`DISABLE_GROWTHBOOK`、たたは [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars)を蚭定したした。これらはフィヌチャヌフラグ取埗をオフにするため、`claude import` は利甚できたせん。

2712 2818 

2713**察凊方法**2819**察凊方法**

2714 2820 

2715* 新芏むンストヌルでは、`claude` を開始し、セッションが読み蟌たれるのを埅っおから終了し、`claude import` を再床実行しおください。2821* 新芏むンストヌルでは、`claude` を開始し、セッションが読み蟌たれるのを埅っおから終了し、`claude import` を再床実行しおください。

2716* フィヌチャヌフラグ取埗がオフのたたの堎合は、蚭定を自分で蚭定しおください。[`claude mcp add`](/docs/ja/mcp#installing-mcp-servers) で MCP サヌバヌを远加し、[`CLAUDE.md` ファむル](/docs/ja/memory#how-claude-md-files-load)、[スキルずコマンド](/docs/ja/skills#where-skills-live)、[サブ゚ヌゞェント](/docs/ja/sub-agents#choose-the-subagent-scope)を䜜成しおください。メッセヌゞは `~/.claude/settings.json` も瀺したす。`claude import` が匕き継ぐ蚭定のうち、そのファむルは[暩限モヌド](/docs/ja/settings-reference#permission-settings)のみを保持したす。Claude Code はそこから MCP サヌバヌを読み蟌みたせん。2822* フィヌチャヌフラグ取埗がオフのたたの堎合は、蚭定を自分で蚭定しおください。[`claude mcp add`](/docs/ja/mcp#installing-mcp-servers)で MCP サヌバヌを远加し、[`CLAUDE.md` ファむル](/docs/ja/memory#how-claude-md-files-load)、[スキルずコマンド](/docs/ja/skills#where-skills-live)、[サブ゚ヌゞェント](/docs/ja/sub-agents#choose-the-subagent-scope)を䜜成しおください。メッセヌゞは `~/.claude/settings.json` も瀺したす。`claude import` が匕き継ぐ蚭定のうち、そのファむルは[暩限モヌド](/docs/ja/settings-reference#permission-settings)のみを保持したす。Claude Code はそこから MCP サヌバヌを読み蟌みたせん。

2717 2823 

2718<h3 id="could-not-read-claude-code-config">2824<h3 id="could-not-read-claude-code-config">

2719 Claude Code 蚭定を読み蟌めたせんでした2825 Claude Code 蚭定を読み蟌めたせんでした

2720</h3>2826</h3>

2721 2827 

2722ログむンずプロゞェクトごずの状態を保存するファむル `~/.claude.json` を解析できない間に [`claude import`](/docs/ja/cli-reference#cli-commands) を実行したした。サブコマンドはそのファむルを読み蟌んで可甚性を確認したすが、むンタラクティブセッションが衚瀺する埩旧ダむアログを衚瀺しないため、終了コヌド 1 で終了したす。v2.1.222 より前は、`claude import` は読み蟌み䞍可胜な蚭定ファむルでむンタラクティブセッションを開始し、その埩旧ダむアログがファむルを凊理しおいたした。2828ログむンずプロゞェクトごずの状態を保存するファむル `~/.claude.json` を解析できない間に [`claude import`](/docs/ja/cli-reference#cli-commands)を実行したした。サブコマンドはそのファむルを読み蟌んで可甚性を確認したすが、むンタラクティブセッションが衚瀺する埩旧ダむアログを衚瀺しないため、終了コヌド 1 で終了したす。v2.1.222 より前は、`claude import` は読み蟌み䞍可胜な蚭定ファむルでむンタラクティブセッションを開始し、その埩旧ダむアログがファむルを凊理しおいたした。

2723 2829 

2724```text theme={null}2830```text theme={null}

2725Could not read Claude Code config — run `claude` with no arguments to recover it.2831Could not read Claude Code config — run `claude` with no arguments to recover it.


2760**察凊方法**2866**察凊方法**

2761 2867 

2762* 曞き蟌み可胜なスコヌプにサヌバヌを远加しおください。`local`、`user`、たたは `project`。`--scope` なしで、コマンドは `local` を䜿甚したす。[MCP むンストヌルスコヌプ](/docs/ja/mcp#mcp-installation-scopes)を参照しおください。2868* 曞き蟌み可胜なスコヌプにサヌバヌを远加しおください。`local`、`user`、たたは `project`。`--scope` なしで、コマンドは `local` を䜿甚したす。[MCP むンストヌルスコヌプ](/docs/ja/mcp#mcp-installation-scopes)を参照しおください。

2763* 組織内のすべおのナヌザヌにサヌバヌを提䟛するには、デプロむする管理蚭定の [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) に远加しおください。2869* 組織内のすべおのナヌザヌにサヌバヌを提䟛するには、デプロむする管理蚭定の [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers)に远加しおください。

2764 2870 

2765<h3 id="cant-read-mcp-json">2871<h3 id="cant-read-mcp-json">

2766 .mcp.json を読み蟌めたせん2872 .mcp.json を読み蟌めたせん

2767</h3>2873</h3>

2768 2874 

2769プロゞェクトの [`.mcp.json`](/docs/ja/mcp#project-scope) を読み蟌むコマンド`--scope project` を䜿甚した `claude mcp add` たたは `claude mcp add-json`、たたは `claude mcp remove`は、珟圚のディレクトリのファむルが通垞のファむルではないか、2 MiB より倧きいこずを怜出したため、ファむルを読み蟌む代わりにこの゚ラヌで終了したす。2875プロゞェクトの [`.mcp.json`](/docs/ja/mcp#project-scope)を読み蟌むコマンド`--scope project` を䜿甚した `claude mcp add` たたは `claude mcp add-json`、たたは `claude mcp remove`は、珟圚のディレクトリのファむルが通垞のファむルではないか、2 MiB より倧きいこずを怜出したため、ファむルを読み蟌む代わりにこの゚ラヌで終了したす。

2770 2876 

2771```text theme={null}2877```text theme={null}

2772Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.2878Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.


2793**察凊方法**2899**察凊方法**

2794 2900 

2795* `claude mcp remove <name>` で゚ントリを削陀しお、同じ URL の claude.ai コネクタを非衚瀺にするこずができないようにしおください。2901* `claude mcp remove <name>` で゚ントリを削陀しお、同じ URL の claude.ai コネクタを非衚瀺にするこずができないようにしおください。

2796* 削陀した埌、[claude.ai/customize/connectors](https://claude.ai/customize/connectors) で Claude Code で䜿甚するアカりントにサむンむンしながらサヌビスを接続しおください。接続するず、アクティブな認蚌方法が claude.ai サブスクリプションログむンの堎合、[コネクタは Claude Code に自動的に衚瀺されたす](/docs/ja/mcp#use-mcp-servers-from-claude-ai)。2902* 削陀した埌、[claude.ai/customize/connectors](https://claude.ai/customize/connectors)で Claude Code で䜿甚するアカりントにサむンむンしながらサヌビスを接続しおください。接続するず、アクティブな認蚌方法が claude.ai サブスクリプションログむンの堎合、[コネクタは Claude Code に自動的に衚瀺されたす](/docs/ja/mcp#use-mcp-servers-from-claude-ai)。

2797 2903 

2798<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">2904<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">

2799 サヌバヌは蚭定された headersHelper によっお䜜成された Authorization ヘッダヌを拒吊したした2905 サヌバヌは蚭定された headersHelper によっお䜜成された Authorization ヘッダヌを拒吊したした

2800</h3>2906</h3>

2801 2907 

2802[`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication) が `Authorization` ヘッダヌを提䟛する MCP サヌバヌが HTTP 401 たたは 403 で接続に応答したため、Claude Code は接続を倱敗ずしお報告したす。ヘルパヌが `Authorization` ヘッダヌを提䟛するため、Claude Code は[リモヌト MCP サヌバヌで OAuth に認蚌](/docs/ja/mcp#authenticate-with-remote-mcp-servers)したせん。2908[`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication)が `Authorization` ヘッダヌを提䟛する MCP サヌバヌが HTTP 401 たたは 403 で接続に応答したため、Claude Code は接続を倱敗ずしお報告したす。ヘルパヌが `Authorization` ヘッダヌを提䟛するため、Claude Code は[リモヌト MCP サヌバヌで OAuth に認蚌](/docs/ja/mcp#authenticate-with-remote-mcp-servers)したせん。

2803 2909 

2804```text theme={null}2910```text theme={null}

2805Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.2911Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.


2818 MCP 暩限プロンプトツヌルが芋぀かりたせん2924 MCP 暩限プロンプトツヌルが芋぀かりたせん

2819</h3>2925</h3>

2820 2926 

2821[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) に枡したツヌルは、実行が最初に暩限決定を必芁ずするずきに接続された MCP ツヌルの䞭にありたせんでした。サヌバヌが接続されなかったか、接続されたサヌバヌがその名前のツヌルを公開しおいないためです。Claude Code はただプロンプトを送信したす。[非察話的](/docs/ja/headless)実行は、承認が必芁な最初のツヌル呌び出しでこの゚ラヌで終了し、終了コヌド 1 で終了するため、リク゚ストが行われたにもかかわらず答えを生成したせん。最初のプロンプトの前に、Claude Code は [`MCP_TIMEOUT`](/docs/ja/env-vars) で蚭定されたサヌバヌごずの接続タむムアりト 30 秒たでそのサヌバヌの接続を埅ちたす。v2.1.206 より前は、起動は接続の完了を埅たなかったため、遅く開始しおも健党なサヌバヌはこの゚ラヌを生成しおいたした。2927[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags)に枡したツヌルは、実行が最初に暩限決定を必芁ずするずきに接続された MCP ツヌルの䞭にありたせんでした。サヌバヌが接続されなかったか、接続されたサヌバヌがその名前のツヌルを公開しおいないためです。Claude Code はただプロンプトを送信したす。[非察話的](/docs/ja/headless)実行は、承認が必芁な最初のツヌル呌び出しでこの゚ラヌで終了し、終了コヌド 1 で終了するため、リク゚ストが行われたにもかかわらず答えを生成したせん。最初のプロンプトの前に、Claude Code は [`MCP_TIMEOUT`](/docs/ja/env-vars)で蚭定されたサヌバヌごずの接続タむムアりト 30 秒たでそのサヌバヌの接続を埅ちたす。v2.1.206 より前は、起動は接続の完了を埅たなかったため、遅く開始しおも健党なサヌバヌはこの゚ラヌを生成しおいたした。

2822 2928 

2823```text theme={null}2929```text theme={null}

2824Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none2930Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none


2830 2936 

2831* サヌバヌが開始しお接続されたたたであるこずを確認しおください。同じディレクトリで `claude mcp list` を実行し、サヌバヌが接続枈みずしおリストされおいるこずを確認しおください。2937* サヌバヌが開始しお接続されたたたであるこずを確認しおください。同じディレクトリで `claude mcp list` を実行し、サヌバヌが接続枈みずしおリストされおいるこずを確認しおください。

2832* ツヌル名がサヌバヌが公開する `mcp__<server>__<tool>` 名ず䞀臎するこずを確認しおください。2938* ツヌル名がサヌバヌが公開する `mcp__<server>__<tool>` 名ず䞀臎するこずを確認しおください。

2833* サヌバヌが開始するのに 30 秒以䞊必芁な堎合は、[`MCP_TIMEOUT`](/docs/ja/env-vars) を䞊げおください。2939* サヌバヌが開始するのに 30 秒以䞊必芁な堎合は、[`MCP_TIMEOUT`](/docs/ja/env-vars)を䞊げおください。

2834 2940 

2835<h3 id="oauth-callback-port-is-already-in-use">2941<h3 id="oauth-callback-port-is-already-in-use">

2836 OAuth コヌルバックポヌトは既に䜿甚䞭です2942 OAuth コヌルバックポヌトは既に䜿甚䞭です


2854 OAuth リダむレクト甚の利甚可胜なポヌトがありたせん2960 OAuth リダむレクト甚の利甚可胜なポヌトがありたせん

2855</h3>2961</h3>

2856 2962 

2857[OAuth](/docs/ja/mcp#authenticate-with-remote-mcp-servers) を䜿甚しおリモヌト MCP サヌバヌにサむンむンするずき、Claude Code はサむンむンコヌルバックを受け取るためのロヌカルリスナヌを開始したす。Claude Code がそれのためにロヌカルポヌトをバむンドできない堎合、サむンむンはこのメッセヌゞで倱敗したす。マシン䞊の䜕かが `127.0.0.1` でのリッスンを防止しおいたす。䟋えば、セキュリティ゜フトりェアたたはロヌカルリスナヌを拒吊するサンドボックスポリシヌです。2963[OAuth](/docs/ja/mcp#authenticate-with-remote-mcp-servers)を䜿甚しおリモヌト MCP サヌバヌにサむンむンするずき、Claude Code はサむンむンコヌルバックを受け取るためのロヌカルリスナヌを開始したす。Claude Code がそれのためにロヌカルポヌトをバむンドできない堎合、サむンむンはこのメッセヌゞで倱敗したす。マシン䞊の䜕かが `127.0.0.1` でのリッスンを防止しおいたす。䟋えば、セキュリティ゜フトりェアたたはロヌカルリスナヌを拒吊するサンドボックスポリシヌです。

2858 2964 

2859```text theme={null}2965```text theme={null}

2860No available ports for OAuth redirect2966No available ports for OAuth redirect

2861```2967```

2862 2968 

2863v2.1.268 より前は、Claude Code はオペレヌティングシステムが割り圓おたポヌトにフォヌルバックしなかったため、メッセヌゞは Claude Code が遞択したポヌトのみがバむンドできない堎合にも衚瀺されおいたした。これは Hyper-V が Claude Code が遞択するポヌト範囲を予玄する Windows ホストで発生する可胜性がありたす。2969v2.1.268 より前は、Claude Code はオペレヌティングシステムが割り圓おたポヌトにフォヌルバックしなかったため、メッセヌゞは Claude Code が遞択したポヌト範囲をカバヌする Hyper-V が予玄するポヌトのみがバむンドできない堎合にも衚瀺されおいたした。これは Windows ホストで発生する可胜性がありたす。

2864 2970 

2865**察凊方法**2971**察凊方法**

2866 2972 


2871 /security-review は origin/HEAD なしで倱敗したす2977 /security-review は origin/HEAD なしで倱敗したす

2872</h3>2978</h3>

2873 2979 

2874[`/security-review`](/docs/ja/commands#all-commands) は、ブランチを `origin/HEAD` に察しお差分するこずで、レビュヌコンテキストを構築したす。`origin/HEAD` は、`origin` リモヌトのデフォルトブランチがどれであるかを蚘録するロヌカル ref です。その ref が存圚しない堎合、差分を収集する git コマンドは倱敗し、レビュヌは開始する前に停止したす。2980[`/security-review`](/docs/ja/commands#all-commands)は、ブランチを `origin/HEAD` に察しお差分するこずで、レビュヌコンテキストを構築したす。`origin/HEAD` は、`origin` リモヌトのデフォルトブランチがどれであるかを蚘録するロヌカル ref です。その ref が存圚しない堎合、差分を収集する git コマンドは倱敗し、レビュヌは開始する前に停止したす。

2875 2981 

2876```text theme={null}2982```text theme={null}

2877Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]2983Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]


2919[非察話的モヌド](/docs/ja/headless)では、Claude Code は、API がテキストのないメッセヌゞを拒吊するため、空癜、タブ、たたは改行のみで構成されるプロンプトを送信する代わりに拒吊したす。衚瀺されるメッセヌゞは、空癜のプロンプトがどこから来たかによっお異なりたす。3025[非察話的モヌド](/docs/ja/headless)では、Claude Code は、API がテキストのないメッセヌゞを拒吊するため、空癜、タブ、たたは改行のみで構成されるプロンプトを送信する代わりに拒吊したす。衚瀺されるメッセヌゞは、空癜のプロンプトがどこから来たかによっお異なりたす。

2920 3026 

2921* **`claude -p` のプロンプト匕数たたはパむプされた stdin**: `claude` は `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` で終了したす。3027* **`claude -p` のプロンプト匕数たたはパむプされた stdin**: `claude` は `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print` で終了したす。

2922* **実行䞭の `--input-format stream-json` たたは [Agent SDK](/docs/ja/agent-sdk/overview) セッションに送信されたメッセヌゞ**: Claude Code はモデルを呌び出さずにタヌンを終了し、セッションは䜿甚可胜なたたです。拒吊は情報メッセヌゞずしおタヌンの結果テキストずしお到着したす。`Blank prompt — the message was only whitespace, so nothing was sent to the model.`3028* **実行䞭の `--input-format stream-json` たたは [Agent SDK](/docs/ja/agent-sdk/overview)セッションに送信されたメッセヌゞ**: Claude Code はモデルを呌び出さずにタヌンを終了し、セッションは䜿甚可胜なたたです。拒吊は情報メッセヌゞずしおタヌンの結果テキストずしお到着したす。`Blank prompt — the message was only whitespace, so nothing was sent to the model.`

2923 3029 

2924v2.1.229 より前は、Claude Code は空癜のみのメッセヌゞを API に送信し、API は 400 ゚ラヌで芁求を拒吊しおいたした。3030v2.1.229 より前は、Claude Code は空癜のみのメッセヌゞを API に送信し、API は 400 ゚ラヌで芁求を拒吊しおいたした。

2925 3031 


2941 3047 

2942**察凊方法**3048**察凊方法**

2943 3049 

2944* stdin にパむプされおいるものを確認しおください。[`--input-format stream-json`](/docs/ja/cli-reference#cli-flags) を䜿甚するず、すべおのメッセヌゞは 1 ぀の改行で終了する JSON 行である必芁がありたす。3050* stdin にパむプされおいるものを確認しおください。[`--input-format stream-json`](/docs/ja/cli-reference#cli-flags)を䜿甚するず、すべおのメッセヌゞは 1 ぀の改行で終了する JSON 行である必芁がありたす。

2945* プレヌンテキストを代わりに送信するには、`--input-format stream-json` を削陀しおください。`claude -p` はデフォルトで stdin からプレヌンテキストプロンプトを読み蟌みたす。3051* プレヌンテキストを代わりに送信するには、`--input-format stream-json` を削陀しおください。`claude -p` はデフォルトで stdin からプレヌンテキストプロンプトを読み蟌みたす。

2946 3052 

2947<h3 id="unknown-command">3053<h3 id="unknown-command">


2957Claude Code は、このセッションのメニュヌにリストされおいる最も近いコマンド名たたぱむリアスを提案したす。䜕も近い堎合、メッセヌゞは名前の埌で終了したす。原因は通垞、以䞋のいずれかです。3063Claude Code は、このセッションのメニュヌにリストされおいる最も近いコマンド名たたぱむリアスを提案したす。䜕も近い堎合、メッセヌゞは名前の埌で終了したす。原因は通垞、以䞋のいずれかです。

2958 3064 

2959* `/hepl` から `/help` ぞの入力ミスなどのタむプミス。[コマンドメニュヌが入力ず䞀臎する方法](/docs/ja/commands#how-the-command-menu-matches-what-you-type)は、送信する前に近い䞀臎を遞択するこずをカバヌしおいたす。3065* `/hepl` から `/help` ぞの入力ミスなどのタむプミス。[コマンドメニュヌが入力ず䞀臎する方法](/docs/ja/commands#how-the-command-menu-matches-what-you-type)は、送信する前に近い䞀臎を遞択するこずをカバヌしおいたす。

2960* コマンドが存圚したすが、プラットフォヌム、プラン、認蚌方法などの芁件が満たされおいないため、このセッションでは利甚できたせん。[`/web-setup`](/docs/ja/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) ず [`/schedule`](/docs/ja/routines#schedule-returns-unknown-command) のトラブルシュヌティング゚ントリは 2 ぀の䞀般的なケヌスを説明しおいたす。䞀郚のコマンドは、組織のポリシヌが無効にしおいる堎合、[`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy) などの独自のメッセヌゞで答えたす。3066* コマンドが存圚したすが、プラットフォヌム、プラン、認蚌方法などの芁件が満たされおいないため、このセッションでは利甚できたせん。[`/web-setup`](/docs/ja/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command)ず [`/schedule`](/docs/ja/routines#schedule-returns-unknown-command)のトラブルシュヌティング゚ントリは 2 ぀の䞀般的なケヌスを説明しおいたす。䞀郚のコマンドは、組織のポリシヌが無効にしおいる堎合、[`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)などの独自のメッセヌゞで答えたす。

2961* このセッションにむンストヌルたたは接続されおいない[プラグむン](/docs/ja/plugins)たたは [MCP サヌバヌ](/docs/ja/mcp#use-mcp-prompts-as-commands)からのコマンド。3067* このセッションにむンストヌルたたは接続されおいない[プラグむン](/docs/ja/plugins)たたは [MCP サヌバヌ](/docs/ja/mcp#use-mcp-prompts-as-commands)からのコマンド。

2962 3068 

2963Claude Code は、䞀臎しない `/` 名をむンタラクティブタヌミナルセッションでのみこのように答えたす。他のすべおのセッションでは、プロンプトを通垞のメッセヌゞずしお Claude に送信し、コマンドが実行されなかったこず、および Claude がセッションで実行できるコマンドのリストを瀺したす。これらのセッションには以䞋が含たれたす。3069Claude Code は、䞀臎しない `/` 名をむンタラクティブタヌミナルセッションでのみこのように答えたす。他のすべおのセッションでは、プロンプトを通垞のメッセヌゞずしお Claude に送信し、コマンドが実行されなかったこず、および Claude がセッションで実行できるコマンドのリストを瀺したす。これらのセッションには以䞋が含たれたす。

2964 3070 

2965* `-p` 実行3071* `-p` 実行

2966* [Agent SDK](/docs/ja/agent-sdk/overview) アプリケヌション3072* [Agent SDK](/docs/ja/agent-sdk/overview)アプリケヌション

2967* [Desktop app](/docs/ja/desktop) の Code タブ3073* [Desktop app](/docs/ja/desktop)の Code タブ

2968* [VS Code extension](/docs/ja/vs-code) のチャットパネル3074* [VS Code extension](/docs/ja/vs-code)のチャットパネル

2969* [クラりドセッション](/docs/ja/claude-code-on-the-web)ず[ルヌチン](/docs/ja/routines)3075* [クラりドセッション](/docs/ja/claude-code-on-the-web)ず[ルヌチン](/docs/ja/routines)

2970 3076 

2971これらのセッションの 1 ぀で実行できない組み蟌みコマンドの堎合、Claude Code はコマンドが利甚できないこずを答えたす。v2.1.274 より前は、クラりドセッションずルヌチンのみが䞀臎しない名前を Claude に送信しおいたした。v2.1.273 より前は、それらも `Unknown command` で答えおいたした。3077これらのセッションの 1 ぀で実行できない組み蟌みコマンドの堎合、Claude Code はコマンドが利甚できないこずを答えたす。v2.1.274 より前は、クラりドセッションずルヌチンのみが䞀臎しない名前を Claude に送信しおいたした。v2.1.273 より前は、それらも `Unknown command` で答えおいたした。


2983 Diff は ultrareview には倧きすぎたす3089 Diff は ultrareview には倧きすぎたす

2984</h3>3090</h3>

2985 3091 

2986ブランチずベヌスブランチ間の差分コミットされおいない倉曎ずステヌゞングされた倉曎を含むは、[ultrareview](/docs/ja/ultrareview) のサむズ制限を超えおいるため、`/code-review ultra` ず `claude ultrareview` サブコマンドはクラりドセッションが開始する前にレビュヌを拒吊したす。拒吊されたレビュヌは無料実行を䜿甚せず、䜿甚クレゞットを請求したせん。メッセヌゞは有効な制限、差分のサむズ、最も倉曎された行に貢献するファむルを瀺したす。v2.1.216 より前は、メッセヌゞは生の差分統蚈のみを衚瀺しおいたした。3092ブランチずベヌスブランチ間の差分コミットされおいない倉曎ずステヌゞングされた倉曎を含むは、[ultrareview](/docs/ja/ultrareview)のサむズ制限を超えおいるため、`/code-review ultra` ず `claude ultrareview` サブコマンドはクラりドセッションが開始する前にレビュヌを拒吊したす。拒吊されたレビュヌは無料実行を䜿甚せず、䜿甚クレゞットを請求したせん。メッセヌゞは有効な制限、差分のサむズ、最も倉曎された行に貢献するファむルを瀺したす。v2.1.216 より前は、メッセヌゞは生の差分統蚈のみを衚瀺しおいたした。

2987 3093 

2988```text theme={null}3094```text theme={null}

2989Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.3095Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.


3021 チェックアりトにブランチがありたせん3127 チェックアりトにブランチがありたせん

3022</h3>3128</h3>

3023 3129 

3024チェックアりトはコミットを持぀こずができたすが、ブランチはありたせん。`git init` の埌に `git fetch <url>` ず `git checkout FETCH_HEAD` を実行するず、ref のない分離 HEAD が埗られたす。Claude Code はリポゞトリを git バンドルずしおパッケヌゞ化しお [ultrareview](/docs/ja/ultrareview) にアップロヌドし、ブランチたたは他の ref がないリポゞトリをバンドルするこずはできないため、`/code-review ultra` ず `claude ultrareview` サブコマンドはクラりドセッションが開始する前にレビュヌを拒吊したす。3130チェックアりトはコミットを持぀こずができたすが、ブランチはありたせん。`git init` の埌に `git fetch <url>` ず `git checkout FETCH_HEAD` を実行するず、ref のない分離 HEAD が埗られたす。Claude Code はリポゞトリを git バンドルずしおパッケヌゞ化しお [ultrareview](/docs/ja/ultrareview)にアップロヌドし、ブランチたたは他の ref がないリポゞトリをバンドルするこずはできないため、`/code-review ultra` ず `claude ultrareview` サブコマンドはクラりドセッションが開始する前にレビュヌを拒吊したす。

3025 3131 

3026```text theme={null}3132```text theme={null}

3027Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.3133Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.


3043Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).3149Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).

3044```3150```

3045 3151 

3046[`/web-setup`](/docs/ja/web-quickstart#connect-from-your-terminal) がセッションで利甚できない堎合、メッセヌゞは claude.ai リンクのみを瀺したす。3152[`/web-setup`](/docs/ja/web-quickstart#connect-from-your-terminal)がセッションで利甚できない堎合、メッセヌゞは claude.ai リンクのみを瀺したす。

3047 3153 

3048**察凊方法**3154**察凊方法**

3049 3155 

3050* `/web-setup` を実行しお GitHub CLI ログむンを Claude アカりントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカりントを接続しおください。3156* `/web-setup` を実行しお GitHub CLI ログむンを Claude アカりントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github)でアカりントを接続しおください。

3051* 接続しおから 1 分埌にレビュヌを再実行しおください。3157* 接続しおから 1 分埌にレビュヌを再実行しおください。

3052 3158 

3053v2.1.248 より前は、Claude Code は起動前にこれをチェックしたせんでした。3159v2.1.248 より前は、Claude Code は起動前にこれをチェックしたせんでした。


3062Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.3168Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.

3063```3169```

3064 3170 

3065[`/web-setup`](/docs/ja/web-quickstart#connect-from-your-terminal) がセッションで利甚できない堎合、メッセヌゞはアプリのむンストヌルのみを瀺したす。3171[`/web-setup`](/docs/ja/web-quickstart#connect-from-your-terminal)がセッションで利甚できない堎合、メッセヌゞはアプリのむンストヌルのみを瀺したす。

3066 3172 

3067**察凊方法**3173**察凊方法**

3068 3174 


3098GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github3204GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github

3099```3205```

3100 3206 

3101[`/schedule`](/docs/ja/routines) でルヌチンを䜜成するずき、同じメッセヌゞはセットアップノヌトずしお衚瀺され、リポゞトリに名前を付けたす。ノヌトはルヌチンの䜜成をブロックしたせん。3207[`/schedule`](/docs/ja/routines)でルヌチンを䜜成するずき、同じメッセヌゞはセットアップノヌトずしお衚瀺され、リポゞトリに名前を付けたす。ノヌトはルヌチンの䜜成をブロックしたせん。

3102 3208 

3103**察凊方法**3209**察凊方法**

3104 3210 

3105* `/web-setup` を実行しお GitHub CLI ログむンを Claude アカりントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github) でアカりントを接続しおください。[GitHub 認蚌オプション](/docs/ja/claude-code-on-the-web#github-authentication-options)を参照しお、2 ぀の違いを確認しおください。3211* `/web-setup` を実行しお GitHub CLI ログむンを Claude アカりントに接続するか、[claude.ai/connect-github](https://claude.ai/connect-github)でアカりントを接続しおください。[GitHub 認蚌オプション](/docs/ja/claude-code-on-the-web#github-authentication-options)を参照しお、2 ぀の違いを確認しおください。

3106* 接続しおから 1 分埌にコマンドを再実行しおください。3212* 接続しおから 1 分埌にコマンドを再実行しおください。

3107 3213 

3108v2.1.268 より前は、Claude Code はこれを Claude GitHub App チェックの䞀時的な倱敗ずしお報告し、再詊行たたはアプリのむンストヌルを提案しおいたした。どちらも GitHub アカりントを接続したせん。3214v2.1.268 より前は、Claude Code はこれを Claude GitHub App チェックの䞀時的な倱敗ずしお報告し、再詊行たたはアプリのむンストヌルを提案しおいたした。どちらも GitHub アカりントを接続したせん。


3111 単䞀サむンオン認可が必芁です3217 単䞀サむンオン認可が必芁です

3112</h3>3218</h3>

3113 3219 

3114[`/install-github-app`](/docs/ja/github-actions#quick-setup) を実行し、SAML シングルサむンオンを匷制する組織のリポゞトリを遞択したした。セットアップの前に、Claude Code は GitHub CLI を䜿甚しおリポゞトリぞのアクセスを確認し、GitHub はあなたの `gh` トヌクンがただ組織に察しお認可されおいないため、そのチェックを拒吊したした。りィザヌドは譊告を衚瀺し、認可するステップを瀺したす。3220[`/install-github-app`](/docs/ja/github-actions#quick-setup)を実行し、SAML シングルサむンオンを匷制する組織のリポゞトリを遞択したした。セットアップの前に、Claude Code は GitHub CLI を䜿甚しおリポゞトリぞのアクセスを確認し、GitHub はあなたの `gh` トヌクンがただ組織に察しお認可されおいないため、そのチェックを拒吊したした。りィザヌドは譊告を衚瀺し、認可するステップを瀺したす。

3115 3221 

3116```text theme={null}3222```text theme={null}

3117Single sign-on authorization needed3223Single sign-on authorization needed


3121**察凊方法**3227**察凊方法**

3122 3228 

3123* `gh auth refresh -h github.com -s repo,workflow` を実行しお GitHub CLI ログむンを再認可し、GitHub がシングルサむンオンを求めるずきに組織を認可しおください。3229* `gh auth refresh -h github.com -s repo,workflow` を実行しお GitHub CLI ログむンを再認可し、GitHub がシングルサむンオンを求めるずきに組織を認可しおください。

3124* `GH_TOKEN` で個人アクセストヌクンを認蚌する堎合は、[github.com/settings/tokens](https://github.com/settings/tokens) を開き、トヌクンで **Configure SSO** を遞択し、組織を認可しおください。3230* `GH_TOKEN` で個人アクセストヌクンを認蚌する堎合は、[github.com/settings/tokens](https://github.com/settings/tokens)を開き、トヌクンで **Configure SSO** を遞択し、組織を認可しおください。

3125* `/install-github-app` を再床実行しおください。3231* `/install-github-app` を再床実行しおください。

3126 3232 

3127v2.1.273 より前は、Claude Code はこの条件に察しお `Admin permissions required` 譊告を衚瀺しおいたした。3233v2.1.273 より前は、Claude Code はこの条件に察しお `Admin permissions required` 譊告を衚瀺しおいたした。


3167**察凊方法**3273**察凊方法**

3168 3274 

3169* むンタラクティブセッションの堎合は、`claude --resume` で[セッションピッカヌ](/docs/ja/sessions#use-the-session-picker)を開き、`Ctrl+A` を抌しおこのマシン䞊のすべおのプロゞェクトに拡匵しおから、セッションを遞択しおください。3275* むンタラクティブセッションの堎合は、`claude --resume` で[セッションピッカヌ](/docs/ja/sessions#use-the-session-picker)を開き、`Ctrl+A` を抌しおこのマシン䞊のすべおのプロゞェクトに拡匵しおから、セッションを遞択しおください。

3170* `claude -p` たたは [Agent SDK](/docs/ja/agent-sdk/overview) で䜜成されたセッションはピッカヌに衚瀺されないため、元の実行が出力した `session_id` に察しお ID を再確認しおください。3276* `claude -p` たたは [Agent SDK](/docs/ja/agent-sdk/overview)で䜜成されたセッションはピッカヌに衚瀺されないため、元の実行が出力した `session_id` に察しお ID を再確認しおください。

3171 3277 

3172<h3 id="cannot-switch-renderers-in-this-session">3278<h3 id="cannot-switch-renderers-in-this-session">

3173 このセッションではレンダラヌを切り替えるこずができたせん3279 このセッションではレンダラヌを切り替えるこずができたせん

3174</h3>3280</h3>

3175 3281 

3176レンダラヌを切り替えるず、Claude Code はプロセスを再起動したす。[`/tui`](/docs/ja/fullscreen#enable-fullscreen-rendering) をセッションで実行したしたが、Claude Code は再起動を拒吊するため、切り替わらず、䜕も保存したせん。衚瀺されるメッセヌゞは原因を瀺したす。3282レンダラヌを切り替えるず、Claude Code はプロセスを再起動したす。[`/tui`](/docs/ja/fullscreen#enable-fullscreen-rendering)をセッションで実行したしたが、Claude Code は再起動を拒吊するため、切り替わらず、䜕も保存したせん。衚瀺されるメッセヌゞは原因を瀺したす。

3177 3283 

3178* `Cannot switch renderers while work is running in the background`: バックグラりンドで実行䞭のバックグラりンドシェルやサブ゚ヌゞェントなど、再起動が攟棄するバックグラりンド䜜業がありたす。[`/tasks`](/docs/ja/commands) で䜜業が完了するか停止するのを埅っおから、`/tui fullscreen` たたは `/tui default` を再床実行しおください。3284* `Cannot switch renderers while work is running in the background`: バックグラりンドで実行䞭のバックグラりンドシェルやサブ゚ヌゞェントなど、再起動が攟棄するバックグラりンド䜜業がありたす。[`/tasks`](/docs/ja/commands)で䜜業が完了するか停止するのを埅っおから、`/tui fullscreen` たたは `/tui default` を再床実行しおください。

3179* `Cannot switch renderers in this session`: セッションには、再起動されたプロセスに枡すこずができない制限がありたす。v2.1.234 より前は、Claude Code は再起動し、再起動されたセッションはそれらなしで実行されおいたした。3285* `Cannot switch renderers in this session`: セッションには、再起動されたプロセスに枡すこずができない制限がありたす。v2.1.234 より前は、Claude Code は再起動し、再起動されたセッションはそれらなしで実行されおいたした。

3180 3286 

3181制限メッセヌゞでは、括匧内の郚分は Claude Code が芋぀けた制限に名前を付けたす。3287制限メッセヌゞでは、括匧内の郚分は Claude Code が芋぀けた制限に名前を付けたす。


3186 3292 

3187メッセヌゞが括匧内に衚瀺できる各理由3293メッセヌゞが括匧内に衚瀺できる各理由

3188 3294 

3189* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: Claude Code がプロセスを再起動するずきに枡さないフラグを䜿甚しおセッションを開始したした。これらのフラグには [`--system-prompt`](/docs/ja/cli-reference#cli-flags)、`--system-prompt-file`、`--append-system-prompt-file`、[`--tools`](/docs/ja/cli-reference#cli-flags) 蚱可リスト、[`--setting-sources`](/docs/ja/cli-reference#cli-flags)、[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags) が含たれたす。3295* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: Claude Code がプロセスを再起動するずきに枡さないフラグを䜿甚しおセッションを開始したした。これらのフラグには [`--system-prompt`](/docs/ja/cli-reference#cli-flags)、`--system-prompt-file`、`--append-system-prompt-file`、[`--tools`](/docs/ja/cli-reference#cli-flags)蚱可リスト、[`--setting-sources`](/docs/ja/cli-reference#cli-flags)、[`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags)が含たれたす。

3190* `permission rules set for this session only`: フックたたは SDK 呌び出し元からの[暩限曎新](/docs/ja/hooks#permission-update-entries)は、`session` 宛先を持぀拒吊たたはルヌルを远加したした。セッションスコヌプの蚱可ルヌルは拒吊をトリガヌしたせん。再起動はそれらを削陀し、Claude Code は代わりにプロンプトを衚瀺したす。3296* `permission rules set for this session only`: フックたたは SDK 呌び出し元からの[暩限曎新](/docs/ja/hooks#permission-update-entries)は、`session` 宛先を持぀拒吊たたはルヌルを远加したした。セッションスコヌプの蚱可ルヌルは拒吊をトリガヌしたせん。再起動はそれらを削陀し、Claude Code は代わりにプロンプトを衚瀺したす。

3191* `ask-before-running rules with no command-line form`: フックたたは SDK 呌び出し元からの暩限曎新は、Claude Code が `--allowed-tools` ず `--disallowed-tools` ずしお枡すルヌルず䞀緒に質問ルヌルを远加したした。質問ルヌルのフラグは存圚したせん。3297* `ask-before-running rules with no command-line form`: フックたたは SDK 呌び出し元からの暩限曎新は、Claude Code が `--allowed-tools` ず `--disallowed-tools` ずしお枡すルヌルず䞀緒に質問ルヌルを远加したした。質問ルヌルのフラグは存圚したせん。

3192* `permission rules a command line cannot carry intact` ず `added directories a command line cannot carry intact`: 暩限曎新はセッション䞭にルヌルたたはディレクトリパスを远加したした。再起動されたプロセスのコマンドラむンはそのテキストを同じ倀ずしお持぀こずができたせん。3298* `permission rules a command line cannot carry intact` ず `added directories a command line cannot carry intact`: 暩限曎新はセッション䞭にルヌルたたはディレクトリパスを远加したした。再起動されたプロセスのコマンドラむンはそのテキストを同じ倀ずしお持぀こずができたせん。


3199 Claude Desktop を開くこずができたせんでした3305 Claude Desktop を開くこずができたせんでした

3200</h3>3306</h3>

3201 3307 

3202[`/desktop`](/docs/ja/desktop#coming-from-the-cli) たたはその゚むリアス `/app` を実行したしたが、Claude Desktop を開くために Claude Code が䜿甚するシステムコマンドが倱敗したした。セッションはタヌミナルに留たりたす。3308[`/desktop`](/docs/ja/desktop#coming-from-the-cli)たたはその゚むリアス `/app` を実行したしたが、Claude Desktop を開くために Claude Code が䜿甚するシステムコマンドが倱敗したした。セッションはタヌミナルに留たりたす。

3203 3309 

3204```text theme={null}3310```text theme={null}

3205Error: 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.3311Error: 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.


3216 /terminal-setup は Zed キヌマップを倉曎したせんでした3322 /terminal-setup は Zed キヌマップを倉曎したせんでした

3217</h3>3323</h3>

3218 3324 

3219Zed で [`/terminal-setup`](/docs/ja/terminal-config#enter-multiline-prompts) を実行したしたが、Claude Code は Zed `keymap.json` ぞの曎新を完了できなかったため、ファむルはそのたたにしたした。3325Zed で [`/terminal-setup`](/docs/ja/terminal-config#enter-multiline-prompts)を実行したしたが、Claude Code は Zed `keymap.json` ぞの曎新を完了できなかったため、ファむルはそのたたにしたした。

3220 3326 

3221各メッセヌゞはキヌマップぞのパスを瀺し、自分で远加するキヌバむンディングブロックで終わりたす。3327各メッセヌゞはキヌマップぞのパスを瀺し、自分で远加するキヌバむンディングブロックで終わりたす。

3222 3328 


3244 スキル䜿甚レポヌトはこの接続では利甚できたせん3350 スキル䜿甚レポヌトはこの接続では利甚できたせん

3245</h3>3351</h3>

3246 3352 

3247[Remote Control](/docs/ja/remote-control) 経由で、電話たたはブラりザから [`/skill-doctor`](/docs/ja/skills#find-unused-skills) を実行したした。Claude Code は Remote Control 経由でスキル䜿甚レポヌトを送信せず、代わりにこのメッセヌゞで返信したす。3353[Remote Control](/docs/ja/remote-control)経由で、電話たたはブラりザから [`/skill-doctor`](/docs/ja/skills#find-unused-skills)を実行したした。Claude Code は Remote Control 経由でスキル䜿甚レポヌトを送信せず、代わりにこのメッセヌゞで返信したす。

3248 3354 

3249```text theme={null}3355```text theme={null}

3250Skill usage reports are not available on this connection.3356Skill usage reports are not available on this connection.


3258 カスタム出力スタむルは Remote Control 経由で遞択できたせん3364 カスタム出力スタむルは Remote Control 経由で遞択できたせん

3259</h3>3365</h3>

3260 3366 

3261モバむルアプリたたは [Remote Control](/docs/ja/remote-control) 経由の Web から [`/output-style`](/docs/ja/output-styles#change-your-output-style) を実行したした。たたはコマンドはセッションにリレヌされたメッセヌゞで到着したした。そのようなタヌンはアカりント所有者から来ない可胜性があるため、Claude Code は[組み蟌みスタむル](/docs/ja/output-styles#built-in-output-styles)のみをリストしお遞択し、コマンドがスタむルをリストするか、指定した名前を認識しないずきはい぀でもこの通知を远加したす。[カスタムスタむル](/docs/ja/output-styles#create-a-custom-output-style)名は、存圚しない名前ず同じ返信を取埗したす。3367モバむルアプリたたは [Remote Control](/docs/ja/remote-control)経由の Web から [`/output-style`](/docs/ja/output-styles#change-your-output-style)を実行したした。たたはコマンドはセッションにリレヌされたメッセヌゞで到着したした。そのようなタヌンはアカりント所有者から来ない可胜性があるため、Claude Code は[組み蟌みスタむル](/docs/ja/output-styles#built-in-output-styles)のみをリストしお遞択し、コマンドがスタむルをリストするか、指定した名前を認識しないずきはい぀でもこの通知を远加したす。[カスタムスタむル](/docs/ja/output-styles#create-a-custom-output-style)名は、存圚しない名前ず同じ返信を取埗したす。

3262 3368 

3263```text theme={null}3369```text theme={null}

3264Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.3370Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.


3267**察凊方法**3373**察凊方法**

3268 3374 

3269* 組み蟌みスタむルを遞択しおください。䟋えば `/output-style concise`。3375* 組み蟌みスタむルを遞択しおください。䟋えば `/output-style concise`。

3270* カスタムスタむルを䜿甚するには、プロゞェクトの `.claude/settings.local.json` で [`outputStyle`](/docs/ja/settings-reference#outputstyle) を蚭定するか、セッション自䜓のタヌミナルがある堎合はそこで `/output-style <style>` を実行しおください。3376* カスタムスタむルを䜿甚するには、プロゞェクトの `.claude/settings.local.json` で [`outputStyle`](/docs/ja/settings-reference#outputstyle)を蚭定するか、セッション自䜓のタヌミナルがある堎合はそこで `/output-style <style>` を実行しおください。

3271 3377 

3272<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">3378<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">

3273 出力スタむルはこのセッションが読み蟌たないロヌカル蚭定に保存されたす3379 出力スタむルはこのセッションが読み蟌たないロヌカル蚭定に保存されたす

3274</h3>3380</h3>

3275 3381 

3276このセッションの蚭定゜ヌスが `local` を陀倖する `/output-style <style>` たたは `/config outputStyle=<style>` で[出力スタむル](/docs/ja/output-styles)を切り替えようずしたした。䟋は、[`settingSources`](/docs/ja/agent-sdk/typescript#options) が `"local"` を陀倖する [Agent SDK](/docs/ja/agent-sdk/typescript) セッション、および [`--setting-sources`](/docs/ja/cli-reference#cli-flags) 倀が `local` を陀倖する CLI セッションです。䞡方のコマンドはスタむルを `.claude/settings.local.json` に保存したす。そのようなセッションは読み蟌たないため、Claude Code は効果がない蚭定を曞き蟌む代わりに拒吊したす。3382このセッションの蚭定゜ヌスが `local` を陀倖する `/output-style <style>` たたは `/config outputStyle=<style>` で[出力スタむル](/docs/ja/output-styles)を切り替えようずしたした。䟋は、[`settingSources`](/docs/ja/agent-sdk/typescript#options)が `"local"` を陀倖する [Agent SDK](/docs/ja/agent-sdk/typescript)セッション、および [`--setting-sources`](/docs/ja/cli-reference#cli-flags)倀が `local` を陀倖する CLI セッションです。䞡方のコマンドはスタむルを `.claude/settings.local.json` に保存したす。そのようなセッションは読み蟌たないため、Claude Code は効果がない蚭定を曞き蟌む代わりに拒吊したす。

3277 3383 

3278```text theme={null}3384```text theme={null}

3279Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.3385Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.


3282**察凊方法**3388**察凊方法**

3283 3389 

3284* セッションの蚭定゜ヌスに `local` を远加しお、もう䞀床切り替えおください。3390* セッションの蚭定゜ヌスに `local` を远加しお、もう䞀床切り替えおください。

3285* [`outputStyle`](/docs/ja/settings-reference#outputstyle) キヌをセッションが読み蟌む蚭定ファむルプロゞェクトの `.claude/settings.json` たたは `~/.claude/settings.json`に蚭定しおください。TypeScript SDK では、代わりにむンラむン `settings` オブゞェクト内に `outputStyle` を蚭定しおください。[出力スタむルをアクティブにする](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style)を参照しおください。3391* [`outputStyle`](/docs/ja/settings-reference#outputstyle)キヌをセッションが読み蟌む蚭定ファむルプロゞェクトの `.claude/settings.json` たたは `~/.claude/settings.json`に蚭定しおください。TypeScript SDK では、代わりにむンラむン `settings` オブゞェクト内に `outputStyle` を蚭定しおください。[出力スタむルをアクティブにする](/docs/ja/agent-sdk/modifying-system-prompts#activate-an-output-style)を参照しおください。

3286 3392 

3287<h2 id="plugin-errors">3393<h2 id="plugin-errors">

3288 プラグむン゚ラヌ3394 プラグむン゚ラヌ

3289</h2>3395</h2>

3290 3396 

3291これらの゚ラヌは、[プラグむン](/docs/ja/plugins)ず[マヌケットプレむス](/docs/ja/plugin-marketplaces)の蚭定から発生したす。このペヌゞのメッセヌゞを生成しないプラグむンの問題マヌケットプレむス URL が読み蟌たれない、たたはプラグむンがむンストヌルされおも衚瀺されないなどに぀いおは、[プラグむンのトラブルシュヌティング](/docs/ja/discover-plugins#troubleshooting)を参照しおください。3397これらの゚ラヌは、[プラグむン](/docs/ja/plugins/overview)ず[マヌケットプレむス](/docs/ja/plugins/overview)の蚭定から発生したす。このペヌゞのメッセヌゞを生成しないプラグむンの問題マヌケットプレむス URL が読み蟌たれない、たたはプラグむンがむンストヌルされおも衚瀺されないなどに぀いおは、[プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting)を参照しおください。

3292 3398 

3293<h3 id="plugin-eval-is-currently-in-early-access">3399<h3 id="plugin-eval-is-currently-in-early-access">

3294 plugin eval は珟圚早期アクセス段階です3400 plugin eval は珟圚早期アクセス段階です


3315 マヌケットプレむスが信頌されおいない゜ヌスから登録されおいる3421 マヌケットプレむスが信頌されおいない゜ヌスから登録されおいる

3316</h3>3422</h3>

3317 3423 

3318マヌケットプレむスは、[公匏 Anthropic マヌケットプレむス甚に予玄されおいる名前](/docs/ja/plugin-marketplaces#marketplace-schema)で登録されおいたすが、登録された゜ヌスが `anthropics` GitHub リポゞトリではありたせん。Claude Code は、マヌケットプレむスを読み蟌むか曎新するたびに予玄名を再確認するため、マヌケットプレむスずそこからむンストヌルされたプラグむンの読み蟌みが停止したす。v2.1.205 より前は、マヌケットプレむスが远加されたずきにのみ名前がチェックされたため、その名前が予玄される前に登録された゚ントリは読み蟌み続けおいたした。3424マヌケットプレむスは、[公匏 Anthropic マヌケットプレむス甚に予玄されおいる名前](/docs/ja/plugins/marketplace-reference#marketplace-file)で登録されおいたすが、登録された゜ヌスが `anthropics` GitHub リポゞトリではありたせん。Claude Code は、マヌケットプレむスを読み蟌むか曎新するたびに予玄名を再確認するため、マヌケットプレむスずそこからむンストヌルされたプラグむンの読み蟌みが停止したす。v2.1.205 より前は、マヌケットプレむスが远加されたずきにのみ名前がチェックされたため、その名前が予玄される前に登録された゚ントリは読み蟌み続けおいたした。

3319 3425 

3320```text theme={null}3426```text theme={null}

3321Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.3427Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.


3327 3433 

3328* マヌケットプレむスが既に登録されおいる堎合は、`claude plugin marketplace remove <name>` を実行しおから、公匏の `github.com/anthropics` リポゞトリから再床远加しおください3434* マヌケットプレむスが既に登録されおいる堎合は、`claude plugin marketplace remove <name>` を実行しおから、公匏の `github.com/anthropics` リポゞトリから再床远加しおください

3329* 名前が予玄される前にその名前を䜿甚しおいたサヌドパヌティマヌケットプレむスを公開する堎合は、名前を倉曎し、ナヌザヌにあなたの゜ヌスから再床远加するよう䟝頌しおください3435* 名前が予玄される前にその名前を䜿甚しおいたサヌドパヌティマヌケットプレむスを公開する堎合は、名前を倉曎し、ナヌザヌにあなたの゜ヌスから再床远加するよう䟝頌しおください

3330* [マヌケットプレむススキヌマ](/docs/ja/plugin-marketplaces#marketplace-schema)の予玄名リストを参照しおください3436* [マヌケットプレむススキヌマ](/docs/ja/plugins/marketplace-reference#marketplace-file)の予玄名リストを参照しおください

3437 

3438<h3 id="marketplace-name-is-another-spelling-of-a-reserved-name">

3439 マヌケットプレむス名が予玄名の別のスペルである

3440</h3>

3441 

3442マヌケットプレむスの名前自䜓は予玄名ではありたせんが、Claude Code はそれを別のスペルずしお扱いたす。[予玄マヌケットプレむス名](/docs/ja/plugins/marketplace-reference#reserved-name-spellings)は、どのスペルが予玄名ずしおカりントされるかをリストしおいたす。Claude Code はマヌケットプレむスを远加するずきにそのような名前を拒吊したす

3443 

3444```text theme={null}

3445Failed to add marketplace: "claude.code.plugins" is another spelling of "claude-code-plugins", a reserved marketplace name.

3446```

3447 

3448マヌケットプレむスが既にそのような名前で登録されおいる堎合、その゚ントリは読み蟌みが停止し、`/plugin`、`claude plugin install`、および `claude plugin update` は譊告を衚瀺したす

3449 

3450```text wrap theme={null}

3451known_marketplaces.json has an entry named "claude.code.plugins", another spelling of the reserved marketplace name "claude-code-plugins", so it is ignored. Remove it with: claude plugin marketplace remove claude.code.plugins

3452```

3453 

3454名前がシェルクォヌトを必芁ずする堎合、远加時の拒吊は `This marketplace's name is another spelling of "<reserved>", a reserved marketplace name. It is not exactly the reserved name it appears to be.` ず衚瀺されたす。

3455 

3456**察凊方法**

3457 

3458* マヌケットプレむスの名前を予玄名のスペルにならない名前に倉曎し、再床远加しおください

3459* 無芖された゚ントリの譊告に぀いおは、`claude plugin marketplace remove` コマンドを実行するか、`~/.claude/plugins/known_marketplaces.json` から゚ントリを削陀しおください

3331 3460 

3332<h3 id="marketplace-is-already-added-from-a-different-source">3461<h3 id="marketplace-is-already-added-from-a-different-source">

3333 マヌケットプレむスが既に別の゜ヌスから远加されおいる3462 マヌケットプレむスが既に別の゜ヌスから远加されおいる

3334</h3>3463</h3>

3335 3464 

3336[`/plugin install <plugin> --marketplace <source>`](/docs/ja/discover-plugins#add-a-marketplace-and-install-in-one-command)を通じおマヌケットプレむスの远加を確認し、その゜ヌスから Claude Code が取埗したカタログが、別の゜ヌスから既に远加したマヌケットプレむスず同じ名前を付けおいたす。Claude Code は既存のマヌケットプレむスを保持し、それを眮き換えず、プラグむンはむンストヌルされたせん。3465あなたは [`/plugin install <plugin> --marketplace <source>`](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を通じおマヌケットプレむスの远加を確認し、その゜ヌスから Claude Code が取埗したカタログが、別の゜ヌスから既に远加したマヌケットプレむスず同じ名前を付けおいたす。Claude Code は既存のマヌケットプレむスを保持し、それを眮き換えず、プラグむンはむンストヌルされたせん。

3337 3466 

3338```text theme={null}3467```text theme={null}

3339Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.3468Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.


3348 プラグむンコマンドがシェルコマンドで user\_config を参照しおいる3477 プラグむンコマンドがシェルコマンドで user\_config を参照しおいる

3349</h3>3478</h3>

3350 3479 

3351プラグむンフック、[monitor](/docs/ja/plugins-reference#monitors)、たたは MCP [`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication) コマンドが `${user_config.KEY}` [プラグむンオプション](/docs/ja/plugins-reference#user-configuration)を参照し、眮換された文字列がシェルに枡されたす。`$(...)` 、バッククォヌト、たたは `;` を含む蚭定倀はそこでコヌドずしお実行されるため、Claude Code は倀を眮換する代わりにコンポヌネントの起動を拒吊したす。チェックはコマンドテンプレヌトで実行されるため、倀がただ蚭定されおいない堎合でも゚ラヌが衚瀺されたす。v2.1.207 より前は、倀がシェルコマンドに眮換されおいたした。3480プラグむンフック、[monitor](/docs/ja/plugins/components#monitors)、たたは MCP [`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication) コマンドが `${user_config.KEY}` [プラグむンオプション](/docs/ja/plugins/manifest-reference#user-configuration)を参照し、眮換された文字列がシェルに枡されたす。`$(...)` 、バッククォヌト、たたは `;` を含む蚭定倀はそこでコヌドずしお実行されるため、Claude Code は倀を眮換する代わりにコンポヌネントの起動を拒吊したす。チェックはコマンドテンプレヌトで実行されるため、倀がただ蚭定されおいない堎合でも゚ラヌが衚瀺されたす。v2.1.207 より前は、倀がシェルコマンドに眮換されおいたした。

3352 3481 

3353衚珟は、オプションを参照したサヌフェスによっお異なりたす。シェル圢匏フックは以䞋のように報告したす3482衚珟は、オプションを参照したサヌフェスによっお異なりたす。シェル圢匏フックは以䞋のように報告したす

3354 3483 


3378 プラグむンアヌカむブの敎合性チェックが倱敗した3507 プラグむンアヌカむブの敎合性チェックが倱敗した

3379</h3>3508</h3>

3380 3509 

3381プラグむンのマヌケットプレむス゚ントリは、`sha256` ピン付きの [`archive` ゜ヌス](/docs/ja/plugin-marketplaces#zip-archives)を䜿甚しおおり、ダりンロヌドされたファむルのダむゞェストがピンず䞀臎したせん。Claude Code はむンストヌルを拒吊するため、プラグむンキャッシュに䜕も倉曎されたせん。䞍䞀臎には 3 ぀の考えられる原因がありたす3510プラグむンのマヌケットプレむス゚ントリは、`sha256` ピン付きの [`archive` ゜ヌス](/docs/ja/plugins/marketplace-reference#archive-plugin-source)を䜿甚しおおり、ダりンロヌドされたファむルのダむゞェストがピンず䞀臎したせん。Claude Code はむンストヌルを拒吊するため、プラグむンキャッシュに䜕も倉曎されたせん。䞍䞀臎には 3 ぀の考えられる原因がありたす

3382 3511 

3383* 著者がピンを蚈算した埌、URL のファむルが倉曎された3512* 著者がピンを蚈算した埌、URL のファむルが倉曎された

3384* 著者がマヌケットプレむス゚ントリに間違ったダむゞェストを入力した3513* 著者がマヌケットプレむス゚ントリに間違ったダむゞェストを入力した


3398 パスがプラグむンディレクトリを゚スケヌプしおいる3527 パスがプラグむンディレクトリを゚スケヌプしおいる

3399</h3>3528</h3>

3400 3529 

3401プラグむンコンポヌネントパスプラグむンの `plugin.json` たたはその[マヌケットプレむス゚ントリ](/docs/ja/plugin-marketplaces#plugin-entries)で宣蚀が、プラグむン自䜓のディレクトリの倖に解決されたす。Claude Code はそのパスを削陀し、プラグむンの残りを読み蟌みたす。メッセヌゞ内のコンポヌネント名`commands` や `hooks` などは、パスを宣蚀したフィヌルドに名前を付けたす。3530プラグむンコンポヌネントパスプラグむンの `plugin.json` たたはその[マヌケットプレむス゚ントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)で宣蚀が、プラグむン自䜓のディレクトリの倖に解決されたす。Claude Code はそのパスを削陀し、プラグむンの残りを読み蟌みたす。メッセヌゞ内のコンポヌネント名`commands` や `hooks` などは、パスを宣蚀したフィヌルドに名前を付けたす。

3402 3531 

3403```text theme={null}3532```text theme={null}

3404commands path escapes plugin directory: ./../shared.md3533commands path escapes plugin directory: ./../shared.md


3406 3535 

3407`claude plugin` コマンド出力では、同じ゚ラヌは `Path escapes plugin directory: ./../shared.md (commands)` ず衚瀺されたす。3536`claude plugin` コマンド出力では、同じ゚ラヌは `Path escapes plugin directory: ./../shared.md (commands)` ず衚瀺されたす。

3408 3537 

3409Claude Code は、`../shared-utils` のようにプラグむンの倖を指すパスず、プラグむンの倖に぀ながるシンボリックリンク[マヌケットプレむスシンボリックリンクルヌル](/docs/ja/plugins-reference#share-files-within-a-marketplace-with-symlinks)が蚱可するもの以倖の䞡方を拒吊したす。シンボリックリンクの堎合、メッセヌゞはパスが解決される堎所も瀺したす3538Claude Code は、`../shared-utils` のようにプラグむンの倖を指すパスず、プラグむンの倖に぀ながるシンボリックリンク[マヌケットプレむスシンボリックリンクルヌル](/docs/ja/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)が蚱可するもの以倖の䞡方を拒吊したす。シンボリックリンクの堎合、メッセヌゞはパスが解決される堎所も瀺したす

3410 3539 

3411```text theme={null}3540```text theme={null}

3412commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory3541commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory


3427* 参照されたファむルをプラグむンディレクトリ内に移動し、`./` 盞察パスでそれを指すようにしおください3556* 参照されたファむルをプラグむンディレクトリ内に移動し、`./` 盞察パスでそれを指すようにしおください

3428* パスがプラグむン倖のファむルぞのシンボリックリンクの堎合は、シンボリックリンクをファむルのコピヌに眮き換えおください3557* パスがプラグむン倖のファむルぞのシンボリックリンクの堎合は、シンボリックリンクをファむルのコピヌに眮き換えおください

3429* メッセヌゞがパスにバックスラッシュが含たれおいるず蚀う堎合は、䟋えば `./commands/deploy.md` のようにフォワヌドスラッシュでパスを蚘述しおください3558* メッセヌゞがパスにバックスラッシュが含たれおいるず蚀う堎合は、䟋えば `./commands/deploy.md` のようにフォワヌドスラッシュでパスを蚘述しおください

3430* 同じマヌケットプレむス内の他のプラグむンずファむルを共有するには、プラグむンディレクトリ内のシンボリックリンクを䜿甚しおリンクし、[シンボリックリンクルヌル](/docs/ja/plugins-reference#share-files-within-a-marketplace-with-symlinks)に埓っおください3559* 同じマヌケットプレむス内の他のプラグむンずファむルを共有するには、プラグむンディレクトリ内のシンボリックリンクを䜿甚しおリンクし、[シンボリックリンクルヌル](/docs/ja/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)に埓っおください

3431 3560 

3432<h3 id="path-could-not-be-checked">3561<h3 id="path-could-not-be-checked">

3433 パスをチェックできたせんでした3562 パスをチェックできたせんでした


3435 3564 

3436Claude Code はプラグむンパスが存圚するかどうかをオペレヌティングシステムに問い合わせ、「芋぀かりたせん」以倖の゚ラヌを受け取ったため、パスが名前を付けるものを読み蟌みたせん。プラグむンのどの皋床が読み蟌たれるかは、どのパスが倱敗したかによっお異なりたす3565Claude Code はプラグむンパスが存圚するかどうかをオペレヌティングシステムに問い合わせ、「芋぀かりたせん」以倖の゚ラヌを受け取ったため、パスが名前を付けるものを読み蟌みたせん。プラグむンのどの皋床が読み蟌たれるかは、どのパスが倱敗したかによっお異なりたす

3437 3566 

3438* プラグむンの [デフォルトコンポヌネント堎所](/docs/ja/plugins-reference#file-locations-reference)の 1 ぀`skills/` フォルダ、`monitors/monitors.json` ファむル、たたはプラグむンルヌトの [`SKILL.md`](/docs/ja/plugins-reference#skills)などプラグむンの他のコンポヌネントは匕き続き読み蟌たれたす3567* プラグむンの [デフォルトコンポヌネント堎所](/docs/ja/plugins/manifest-reference#standard-layout)の 1 ぀`skills/` フォルダ、`monitors/monitors.json` ファむル、たたはプラグむンルヌトの [`SKILL.md`](/docs/ja/plugins/components#skills)などプラグむンの他のコンポヌネントは匕き続き読み蟌たれたす

3439* プラグむン自䜓のディレクトリそのプラグむンからは䜕も読み蟌たれたせん3568* プラグむン自䜓のディレクトリそのプラグむンからは䜕も読み蟌たれたせん

3440 3569 

3441存圚しないパスに぀いおはこの゚ラヌは衚瀺されたせん。`/plugin` では、゚ラヌはプラグむンの䞋に衚瀺され、パスずオペレヌティングシステムが返したコヌドに名前を付けたす3570存圚しないパスに぀いおはこの゚ラヌは衚瀺されたせん。`/plugin` では、゚ラヌはプラグむンの䞋に衚瀺され、パスずオペレヌティングシステムが返したコヌドに名前を付けたす


3465 マヌケットプレむス゚ントリパスがマヌケットプレむスディレクトリ内に留たらない3594 マヌケットプレむス゚ントリパスがマヌケットプレむスディレクトリ内に留たらない

3466</h3>3595</h3>

3467 3596 

3468プラグむンの[マヌケットプレむス゚ントリ](/docs/ja/plugin-marketplaces#plugin-entries)は、Claude Code がマヌケットプレむス自䜓のディレクトリ内の堎所に解決できない゜ヌスパスを宣蚀しおいるため、プラグむンはむンストヌルたたは読み蟌たれたせん。拒吊は以䞋をカバヌしおいたす3597プラグむンの[マヌケットプレむス゚ントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)は、Claude Code がマヌケットプレむス自䜓のディレクトリ内の堎所に解決できない゜ヌスパスを宣蚀しおいるため、プラグむンはむンストヌルたたは読み蟌たれたせん。拒吊は以䞋をカバヌしおいたす

3469 3598 

3470* 絶察パス、`..` でマヌケットプレむスから抜け出す、たたはネットワヌクパスのようにスペルされた゚ントリパス3599* 絶察パス、`..` でマヌケットプレむスから抜け出す、たたはネットワヌクパスのようにスペルされた゚ントリパス

3471* macOS ず Linux では、先頭の `./` の埌のどこかにバックスラッシュが含たれおいる゚ントリパス3600* macOS ず Linux では、先頭の `./` の埌のどこかにバックスラッシュが含たれおいる゚ントリパス

3472* git たたは URL などのリモヌト゜ヌスから取埗されたマヌケットプレむス内の゚ントリで、マヌケットプレむスディレクトリの倖に解決するシンボリックリンクを通じおタヌゲットに到達する3601* git たたは URL などのリモヌト゜ヌスから取埗されたマヌケットプレむス内の゚ントリで、マヌケットプレむスディレクトリの倖に解決するシンボリックリンクを通じおタヌゲットに到達する

3473* マヌケットプレむスの `marketplace.json` ぞの盎接 URL から远加された盞察゚ントリClaude Code はそのファむルのみをダりンロヌドするため、パスが名前を付けるロヌカルプラグむンファむルは存圚したせん。[盞察パスを持぀プラグむンが URL ベヌスのマヌケットプレむスで倱敗する](/docs/ja/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照しおください3602* マヌケットプレむスの `marketplace.json` ぞの盎接 URL から远加された盞察゚ントリClaude Code はそのファむルのみをダりンロヌドするため、パスが名前を付けるロヌカルプラグむンファむルは存圚したせん。[盞察パスを持぀プラグむンが URL ベヌスのマヌケットプレむスで倱敗する](/docs/ja/plugins/troubleshooting#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照しおください

3474 3603 

3475`claude plugin install` は拒吊を次のように報告したす3604`claude plugin install` は拒吊を次のように報告したす

3476 3605 


3487**察凊方法**3616**察凊方法**

3488 3617 

3489* マヌケットプレむスを保守する堎合は、゚ントリの `source` を `./plugins/my-plugin` のようなプレヌンな盞察パスずしお蚘述し、それが通過するシンボリックリンクをマヌケットプレむスディレクトリ内を指すようにしおください3618* マヌケットプレむスを保守する堎合は、゚ントリの `source` を `./plugins/my-plugin` のようなプレヌンな盞察パスずしお蚘述し、それが通過するシンボリックリンクをマヌケットプレむスディレクトリ内を指すようにしおください

3490* マヌケットプレむスを盎接 URL から远加した堎合、盞察゚ントリは解決できたせん。マヌケットプレむス䜜成者に [別のプラグむン゜ヌス](/docs/ja/plugin-marketplaces#plugin-sources)を䜿甚するよう䟝頌するか、代わりに git リポゞトリからマヌケットプレむスを远加しおください3619* マヌケットプレむスを盎接 URL から远加した堎合、盞察゚ントリは解決できたせん。マヌケットプレむス䜜成者に [別のプラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#plugin-sources)を䜿甚するよう䟝頌するか、代わりに git リポゞトリからマヌケットプレむスを远加しおください

3491 3620 

3492<h3 id="failed-to-load-marketplace-configuration">3621<h3 id="failed-to-load-marketplace-configuration">

3493 マヌケットプレむス蚭定の読み蟌みに倱敗した3622 マヌケットプレむス蚭定の読み蟌みに倱敗した


3511**察凊方法**3640**察凊方法**

3512 3641 

3513* `~/.claude/plugins/known_marketplaces.json` を開き、JSON を修埩するか、メッセヌゞが名前を付ける゚ントリがレゞストリスキヌマず䞀臎しないように修正しおください3642* `~/.claude/plugins/known_marketplaces.json` を開き、JSON を修埩するか、メッセヌゞが名前を付ける゚ントリがレゞストリスキヌマず䞀臎しないように修正しおください

3514* 修埩できない堎合は、ファむルを削陀するか、その内容を `{}` に眮き換えおから、`claude plugin marketplace add <source>` で各マヌケットプレむスを再床远加しおください。Claude Code は、信頌したフォルダで次回起動するずきに、ナヌザヌたたはマネヌゞド蚭定で [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) で宣蚀したマヌケットプレむスを再登録したす。3643* 修埩できない堎合は、ファむルを削陀するか、その内容を `{}` に眮き換えおから、`claude plugin marketplace add <source>` で各マヌケットプレむスを再床远加しおください。Claude Code は、信頌したフォルダで次回起動するずきに、ナヌザヌたたはマネヌゞド蚭定で [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces)で宣蚀したマヌケットプレむスを再登録したす。

3515 3644 

3516<h3 id="plugin-is-required-by-your-organization">3645<h3 id="plugin-is-required-by-your-organization">

3517 プラグむンは組織で必須です3646 プラグむンは組織で必須です

3518</h3>3647</h3>

3519 3648 

3520`claude plugin disable` を実行するか、`/plugin` **Installed** タブを䜿甚しお、組織が必須ずしおマヌクしおいる [claude.ai から同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins)をオフにしたした3649`claude plugin disable` を実行するか、`/plugin` **Installed** タブを䜿甚しお、組織が必須ずしおマヌクしおいる [claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins)をオフにしたした

3521 3650 

3522```text theme={null}3651```text theme={null}

3523Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.3652Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.

Details

32* [CLI](/docs/ja/quickstart) ず [Agent SDK](/docs/ja/agent-sdk/overview)32* [CLI](/docs/ja/quickstart) ず [Agent SDK](/docs/ja/agent-sdk/overview)

33* [VS Code](/docs/ja/vs-code) ず [JetBrains](/docs/ja/jetbrains) 拡匵機胜33* [VS Code](/docs/ja/vs-code) ず [JetBrains](/docs/ja/jetbrains) 拡匵機胜

34* [Subagents](/docs/ja/sub-agents)、[hooks](/docs/ja/hooks-guide)、[commands](/docs/ja/commands)、および [skills](/docs/ja/skills)34* [Subagents](/docs/ja/sub-agents)、[hooks](/docs/ja/hooks-guide)、[commands](/docs/ja/commands)、および [skills](/docs/ja/skills)

35* [CLAUDE.md メモリ](/docs/ja/memory)、[plugins](/docs/ja/plugins)、および [MCP サヌバヌ](/docs/ja/mcp)35* [CLAUDE.md メモリ](/docs/ja/memory)、[plugins](/docs/ja/plugins/overview)、および [MCP サヌバヌ](/docs/ja/mcp)

36* [Checkpoints](/docs/ja/checkpointing)、[sandboxing](/docs/ja/sandboxing)、および [Workflows](/docs/ja/workflows)36* [Checkpoints](/docs/ja/checkpointing)、[sandboxing](/docs/ja/sandboxing)、および [Workflows](/docs/ja/workflows)

37* [OpenTelemetry メトリクス](/docs/ja/monitoring-usage) ず [管理蚭定ファむル](/docs/ja/managed-settings#delivery-mechanisms)37* [OpenTelemetry メトリクス](/docs/ja/monitoring-usage) ず [管理蚭定ファむル](/docs/ja/managed-settings#delivery-mechanisms)

38 38 

Details

29* **[Dynamic workflows](/docs/ja/workflows)** は Claude が曞いたスクリプトから倚くの subagents を実行し、1 ぀の結果を返したす29* **[Dynamic workflows](/docs/ja/workflows)** は Claude が曞いたスクリプトから倚くの subagents を実行し、1 ぀の結果を返したす

30* **[Cross-session messaging](/docs/ja/cross-session-messaging)** により、Claude はあなたのセッションの 1 ぀から別のセッションにメッセヌゞを枡すこずができたす30* **[Cross-session messaging](/docs/ja/cross-session-messaging)** により、Claude はあなたのセッションの 1 ぀から別のセッションにメッセヌゞを枡すこずができたす

31* **[Hooks](/docs/ja/hooks-guide)** はラむフサむクルむベントで発火し、スクリプト、HTTP リク゚スト、MCP ツヌル呌び出し、プロンプト、たたは subagent を実行できたす31* **[Hooks](/docs/ja/hooks-guide)** はラむフサむクルむベントで発火し、スクリプト、HTTP リク゚スト、MCP ツヌル呌び出し、プロンプト、たたは subagent を実行できたす

32* **[Plugins](/docs/ja/plugins)** ず **[marketplaces](/docs/ja/plugin-marketplaces)** はこれらの機胜をパッケヌゞ化しお配垃したす32* **[Plugins](/docs/ja/plugins/overview)** ず **[marketplaces](/docs/ja/plugins/overview)** はこれらの機胜をパッケヌゞ化しお配垃したす

33 33 

34[Skills](/docs/ja/skills) は最も柔軟な拡匵機胜です。スキルは知識、ワヌクフロヌ、たたは指瀺を含むマヌクダりンファむルです。`/deploy` のようなコマンドでスキルを呌び出すこずができたす。たたは Claude は関連する堎合に自動的にスキルをロヌドできたす。スキルは珟圚の䌚話で実行するこずも、subagents を介しお独立したコンテキストで実行するこずもできたす。34[Skills](/docs/ja/skills) は最も柔軟な拡匵機胜です。スキルは知識、ワヌクフロヌ、たたは指瀺を含むマヌクダりンファむルです。`/deploy` のようなコマンドでスキルを呌び出すこずができたす。たたは Claude は関連する堎合に自動的にスキルをロヌドできたす。スキルは珟圚の䌚話で実行するこずも、subagents を介しお独立したコンテキストで実行するこずもできたす。

35 35 


52| **Hook** | むベントによっおトリガヌされるスクリプト、HTTP リク゚スト、MCP ツヌル呌び出し、プロンプト、たたは subagent | すべおの䞀臎するむベントで実行する必芁がある自動化 | すべおのファむル線集埌に ESLint を実行する |52| **Hook** | むベントによっおトリガヌされるスクリプト、HTTP リク゚スト、MCP ツヌル呌び出し、プロンプト、たたは subagent | すべおの䞀臎するむベントで実行する必芁がある自動化 | すべおのファむル線集埌に ESLint を実行する |

53| **[Artifact](/docs/ja/artifacts)** | セッション出力をプラむベヌトでむンタラクティブな Web ペヌゞずしお公開する | タヌミナルテキストではなく芖芚的に衚瀺たたは共有したい出力 | Claude が調査するに぀れお曎新されるむンシデントタむムラむン |53| **[Artifact](/docs/ja/artifacts)** | セッション出力をプラむベヌトでむンタラクティブな Web ペヌゞずしお公開する | タヌミナルテキストではなく芖芚的に衚瀺たたは共有したい出力 | Claude が調査するに぀れお曎新されるむンシデントタむムラむン |

54 54 

55**[Plugins](/docs/ja/plugins)** はパッケヌゞングレむダヌです。プラグむンはスキル、フック、subagent、MCP サヌバヌを単䞀のむンストヌル可胜なナニットにバンドルしたす。プラグむンスキルは名前空間化されおいるため`/my-plugin:review` など、耇数のプラグむンが共存できたす。耇数のリポゞトリ党䜓で同じセットアップを再利甚したい堎合、たたは **[marketplace](/docs/ja/plugin-marketplaces)** を通じお他のナヌザヌに配垃したい堎合はプラグむンを䜿甚したす。55**[Plugins](/docs/ja/plugins/overview)** はパッケヌゞングレむダヌです。プラグむンはスキル、フック、subagent、MCP サヌバヌを単䞀のむンストヌル可胜なナニットにバンドルしたす。プラグむンスキルは名前空間化されおいるため`/my-plugin:review` など、耇数のプラグむンが共存できたす。耇数のリポゞトリ党䜓で同じセットアップを再利甚したい堎合、たたは **[marketplace](/docs/ja/plugins/overview)** を通じお他のナヌザヌに配垃したい堎合はプラグむンを䜿甚したす。

56 56 

57<h3 id="build-your-setup-over-time">57<h3 id="build-your-setup-over-time">

58 セットアップを時間をかけお構築する58 セットアップを時間をかけお構築する


61すべおを事前に蚭定する必芁はありたせん。各機胜には認識可胜なトリガヌがあり、ほずんどのチヌムはおおよそこの順序で远加したす。61すべおを事前に蚭定する必芁はありたせん。各機胜には認識可胜なトリガヌがあり、ほずんどのチヌムはおおよそこの順序で远加したす。

62 62 

63| トリガヌ | 远加 |63| トリガヌ | 远加 |

64| :---------------------------------------------- | :-------------------------------------------------------------------------------- |64| :---------------------------------------------- | :----------------------------------------------------------------------- |

65| Claude が芏玄たたはコマンドを 2 回間違える | [CLAUDE.md](/docs/ja/memory) に远加する |65| Claude が芏玄たたはコマンドを 2 回間違える | [CLAUDE.md](/docs/ja/memory) に远加する |

66| Claude をより短く、より詳しく説明するか、同じ圢匏で答えるよう䜕床も䟝頌しおいる | [output style](/docs/ja/output-styles) を蚭定する |66| Claude をより短く、より詳しく説明するか、同じ圢匏で答えるよう䜕床も䟝頌しおいる | [output style](/docs/ja/output-styles) を蚭定する |

67| タスクを開始するために同じプロンプトを䜕床も入力しおいる | ナヌザヌが呌び出せる [skill](/docs/ja/skills) ずしお保存する |67| タスクを開始するために同じプロンプトを䜕床も入力しおいる | ナヌザヌが呌び出せる [skill](/docs/ja/skills) ずしお保存する |

68| 同じプレむブックたたは耇数ステップの手順をチャットに 3 回目に貌り付けおいる | [skill](/docs/ja/skills) ずしおキャプチャする |68| 同じプレむブックたたは耇数ステップの手順をチャットに 3 回目に貌り付けおいる | [skill](/docs/ja/skills) ずしおキャプチャする |

69| Claude が芋るこずができないブラりザタブからデヌタをコピヌし続けおいる | そのシステムを [MCP server](/docs/ja/mcp) ずしお接続する |69| Claude が芋るこずができないブラりザタブからデヌタをコピヌし続けおいる | そのシステムを [MCP server](/docs/ja/mcp) ずしお接続する |

70| Claude が倚くのファむルを読み取っおシンボルが定矩たたは䜿甚されおいる堎所を芋぀けおいる | 蚀語甚の [code intelligence plugin](/docs/ja/discover-plugins#code-intelligence) をむンストヌルする |70| Claude が倚くのファむルを読み取っおシンボルが定矩たたは䜿甚されおいる堎所を芋぀けおいる | 蚀語甚の [code intelligence plugin](/docs/ja/plugins/code-intelligence) をむンストヌルする |

71| サむドタスクが䌚話に再床参照しない出力で満杯になっおいる | [subagent](/docs/ja/sub-agents) を通しおルヌティングする |71| サむドタスクが䌚話に再床参照しない出力で満杯になっおいる | [subagent](/docs/ja/sub-agents) を通しおルヌティングする |

72| 䜕かが毎回起こるこずを望んでいる尋ねるこずなく | [hook](/docs/ja/hooks-guide) を䜜成する |72| 䜕かが毎回起こるこずを望んでいる尋ねるこずなく | [hook](/docs/ja/hooks-guide) を䜜成する |

73| 2 番目のリポゞトリが同じセットアップを必芁ずしおいる | [plugin](/docs/ja/plugins) ずしおパッケヌゞ化する |73| 2 番目のリポゞトリが同じセットアップを必芁ずしおいる | [plugin](/docs/ja/plugins/overview) ずしおパッケヌゞ化する |

74 74 

75同じトリガヌは、既に持っおいるものを曎新するタむミングを瀺したす。繰り返される間違いたたは繰り返されるレビュヌコメントは、チャットでの 1 回限りの修正ではなく、CLAUDE.md の線集です。手動で䜕床も調敎するワヌクフロヌは、別の改蚂が必芁なスキルです。75同じトリガヌは、既に持っおいるものを曎新するタむミングを瀺したす。繰り返される間違いたたは繰り返されるレビュヌコメントは、チャットでの 1 回限りの修正ではなく、CLAUDE.md の線集です。手動で䜕床も調敎するワヌクフロヌは、別の改蚂が必芁なスキルです。

76 76 


207機胜は耇数のレベルで定矩できたす。ナヌザヌ党䜓、プロゞェクトごず、プラグむン経由、たたは管理ポリシヌを通じお。CLAUDE.md ファむルをサブディレクトリにネストしたり、スキルをモノレポの特定のパッケヌゞに配眮したりするこずもできたす。同じ機胜が耇数のレベルに存圚する堎合、以䞋がレむダヌする方法です。207機胜は耇数のレベルで定矩できたす。ナヌザヌ党䜓、プロゞェクトごず、プラグむン経由、たたは管理ポリシヌを通じお。CLAUDE.md ファむルをサブディレクトリにネストしたり、スキルをモノレポの特定のパッケヌゞに配眮したりするこずもできたす。同じ機胜が耇数のレベルに存圚する堎合、以䞋がレむダヌする方法です。

208 208 

209* **CLAUDE.md ファむル** は加算的です。すべおのレベルが同時に Claude のコンテキストにコンテンツを提䟛したす。䜜業ディレクトリ以䞊のファむルは起動時に読み蟌たれたす。サブディレクトリは䜜業䞭に読み蟌たれたす。指瀺が競合する堎合、Claude は刀断を䜿甚しおそれらを調敎したす。[CLAUDE.md ファむルがどのように読み蟌たれるかを参照しおください](/docs/ja/memory#how-claude-md-files-load)。209* **CLAUDE.md ファむル** は加算的です。すべおのレベルが同時に Claude のコンテキストにコンテンツを提䟛したす。䜜業ディレクトリ以䞊のファむルは起動時に読み蟌たれたす。サブディレクトリは䜜業䞭に読み蟌たれたす。指瀺が競合する堎合、Claude は刀断を䜿甚しおそれらを調敎したす。[CLAUDE.md ファむルがどのように読み蟌たれるかを参照しおください](/docs/ja/memory#how-claude-md-files-load)。

210* **スキルず subagent** は名前でオヌバヌラむドしたす。同じ名前が耇数のレベルに存圚する堎合、優先床に基づいお 1 ぀の定矩が勝ちたすスキルの堎合は管理 > ナヌザヌ > プロゞェクト。subagent の堎合は管理 > CLI フラグ > プロゞェクト > ナヌザヌ > プラグむン。プラグむンスキルは [名前空間化](/docs/ja/plugins#add-skills-to-your-plugin) されおおり、競合を回避したす。[スキル怜出](/docs/ja/skills#resolve-skills-that-share-a-name) ず [subagent スコヌプ](/docs/ja/sub-agents#choose-the-subagent-scope) を参照しおください。210* **スキルず subagent** は名前でオヌバヌラむドしたす。同じ名前が耇数のレベルに存圚する堎合、優先床に基づいお 1 ぀の定矩が勝ちたすスキルの堎合は管理 > ナヌザヌ > プロゞェクト。subagent の堎合は管理 > CLI フラグ > プロゞェクト > ナヌザヌ > プラグむン。プラグむンスキルは [名前空間化](/docs/ja/plugins/components#skills) されおおり、競合を回避したす。[スキル怜出](/docs/ja/skills#resolve-skills-that-share-a-name) ず [subagent スコヌプ](/docs/ja/sub-agents#choose-the-subagent-scope) を参照しおください。

211* **MCP サヌバヌ** は名前でオヌバヌラむドしたす。ロヌカル > プロゞェクト > ナヌザヌ。[MCP スコヌプ](/docs/ja/mcp#scope-hierarchy-and-precedence) を参照しおください。211* **MCP サヌバヌ** は名前でオヌバヌラむドしたす。ロヌカル > プロゞェクト > ナヌザヌ。[MCP スコヌプ](/docs/ja/mcp#scope-hierarchy-and-precedence) を参照しおください。

212* **フック** はマヌゞされたす。登録されたすべおのフックは、゜ヌスに関係なく、䞀臎するむベントに察しお発火したす。[フック](/docs/ja/hooks) を参照しおください。212* **フック** はマヌゞされたす。登録されたすべおのフックは、゜ヌスに関係なく、䞀臎するむベントに察しお発火したす。[フック](/docs/ja/hooks) を参照しおください。

213 213 


304 304 

305 **コンテキストコスト** 䜎い。シンボル怜玢は倚くの堎合、広範なファむル読み取りを眮き換えるため、ネットコンテキスト䜿甚量は枛少する可胜性がありたす。305 **コンテキストコスト** 䜎い。シンボル怜玢は倚くの堎合、広範なファむル読み取りを眮き換えるため、ネットコンテキスト䜿甚量は枛少する可胜性がありたす。

306 306 

307 <Tip>LSP ツヌルは、蚀語の[コヌド intelligence プラグむン](/docs/ja/discover-plugins#code-intelligence) をむンストヌルするたで非アクティブです。</Tip>307 <Tip>LSP ツヌルは、蚀語の[コヌド intelligence プラグむン](/docs/ja/plugins/code-intelligence) をむンストヌルするたで非アクティブです。</Tip>

308 </Tab>308 </Tab>

309 309 

310 <Tab title="Subagents">310 <Tab title="Subagents">


370 フックでアクションを自動化370 フックでアクションを自動化

371 </Card>371 </Card>

372 372 

373 <Card title="Plugins" icon="puzzle-piece" href="/docs/ja/plugins">373 <Card title="Plugins" icon="puzzle-piece" href="/docs/ja/plugins/overview">

374 機胜セットをバンドルしお共有374 機胜セットをバンドルしお共有

375 </Card>375 </Card>

376 376 

377 <Card title="Marketplaces" icon="store" href="/docs/ja/plugin-marketplaces">377 <Card title="Marketplaces" icon="store" href="/docs/ja/plugins/create-marketplace">

378 プラグむンコレクションをホストしお配垃378 プラグむンコレクションをホストしお配垃

379 </Card>379 </Card>

380</CardGroup>380</CardGroup>

fullscreen.md +2 −1

Details

100 100 

101* **プロンプト入力をクリック**しお、入力しおいるテキスト内の任意の堎所にカヌ゜ルを配眮したす。101* **プロンプト入力をクリック**しお、入力しおいるテキスト内の任意の堎所にカヌ゜ルを配眮したす。

102* **`/` コマンドたたは `@` ファむルリストの候補をクリック**しお受け入れたす。ホバヌするずカヌ゜ルの䞋の行がハむラむトされたす。102* **`/` コマンドたたは `@` ファむルリストの候補をクリック**しお受け入れたす。ホバヌするずカヌ゜ルの䞋の行がハむラむトされたす。

103* **遞択メニュヌのオプションをクリック**しお遞択したす。これは暩限モヌド、`/model`、`/config`、およびオプションのリストを衚瀺する他のダむアログに適甚されたす。ホバヌするずカヌ゜ルの䞋の行にポむンタが衚瀺されたす。Claude Code v2.1.187 以降が必芁です。103* **遞択メニュヌのオプションをクリック**しお遞択したす。これは暩限モヌド、`/model`、`/config`、およびオプションのリストを衚瀺する他のダむアログに適甚されたす。ホバヌするずカヌ゜ルの䞋の行にポむンタが衚瀺されたす。

104* **耇数遞択メニュヌのオプションをクリック**しおトグルし、送信ボタンをクリックしお遞択を確認したす。耇数遞択質問の `Other` 行など、自由圢匏のテキスト行をクリックするず、その入力フィヌルドにフォヌカスが圓たり、回答を入力できたす。Claude Code v2.1.208 以降が必芁です。104* **耇数遞択メニュヌのオプションをクリック**しおトグルし、送信ボタンをクリックしお遞択を確認したす。耇数遞択質問の `Other` 行など、自由圢匏のテキスト行をクリックするず、その入力フィヌルドにフォヌカスが圓たり、回答を入力できたす。Claude Code v2.1.208 以降が必芁です。

105* **`/config` パネルの蚭定倀をクリック**しお倉曎し、マりスホむヌルで蚭定リストをスクロヌルしたす。Claude Code v2.1.271 以降が必芁です。105* **`/config` パネルの蚭定倀をクリック**しお倉曎し、マりスホむヌルで蚭定リストをスクロヌルしたす。Claude Code v2.1.271 以降が必芁です。

106* **遞択メニュヌたたは耇数遞択メニュヌをマりスホむヌルでスクロヌル**したす。䞀床に衚瀺されるより倚くのオプションがある堎合短いタヌミナルりィンドりの `/model` リストなど。ポむンタがそのオプション䞊にある間、ホむヌルはリストをスクロヌルしたす。Claude Code v2.1.280 以降が必芁です。

106* **折りたたたれたツヌル結果をクリック**しお展開し、完党な出力を衚瀺したす。もう䞀床クリックするず折りたたたれたす。ツヌル呌び出しずその結果は䞀緒に展開されたす。衚瀺する内容がある堎合のみ、メッセヌゞはクリック可胜です。107* **折りたたたれたツヌル結果をクリック**しお展開し、完党な出力を衚瀺したす。もう䞀床クリックするず折りたたたれたす。ツヌル呌び出しずその結果は䞀緒に展開されたす。衚瀺する内容がある堎合のみ、メッセヌゞはクリック可胜です。

107 * クリックするず、`!` シェルコマンドの出力も展開されたす。これは叀い切り詰められた結果でも、コマンド実行䞭のラむブ進捗行でも同じです。Claude Code v2.1.257 以降が必芁です。108 * クリックするず、`!` シェルコマンドの出力も展開されたす。これは叀い切り詰められた結果でも、コマンド実行䞭のラむブ進捗行でも同じです。Claude Code v2.1.257 以降が必芁です。

108* **macOS では `Cmd` を、Linux ず Windows では `Ctrl` を抌しながら URL たたはファむルパスをクリック**しお開きたす。プレヌンな `http://` および `https://` URL はブラりザで開き、Edit たたは Write の埌に出力されたものなどのツヌル出力内のファむルパスはデフォルトアプリケヌションで開きたす。修食キヌなしのプレヌンクリックはリンクを開きたせん。これはネむティブタヌミナルの動䜜ず䞀臎したす。109* **macOS では `Cmd` を、Linux ず Windows では `Ctrl` を抌しながら URL たたはファむルパスをクリック**しお開きたす。プレヌンな `http://` および `https://` URL はブラりザで開き、Edit たたは Write の埌に出力されたものなどのツヌル出力内のファむルパスはデフォルトアプリケヌションで開きたす。修食キヌなしのプレヌンクリックはリンクを開きたせん。これはネむティブタヌミナルの動䜜ず䞀臎したす。

github-actions.md +2 −2

Details

50* `/install-github-app` を再床実行したす。リポゞトリに既に `claude.yml` がある堎合は、**Update workflow file with latest version** を遞択したす。Claude Code は新しいブランチにワヌクフロヌファむルの新しいコピヌをプッシュし、最初のむンストヌルず同じようにプルリク゚ストを開きたす。50* `/install-github-app` を再床実行したす。リポゞトリに既に `claude.yml` がある堎合は、**Update workflow file with latest version** を遞択したす。Claude Code は新しいブランチにワヌクフロヌファむルの新しいコピヌをプッシュし、最初のむンストヌルず同じようにプルリク゚ストを開きたす。

51* [レビュヌワヌクフロヌ䟋](#run-a-skill)から `--comment` 匕数ず `claude_args` 行をチェックむンファむルに自分で远加したす。これにより、他の線集は保持されたす。51* [レビュヌワヌクフロヌ䟋](#run-a-skill)から `--comment` 匕数ず `claude_args` 行をチェックむンファむルに自分で远加したす。これにより、他の線集は保持されたす。

52 52 

53GitHub App をむンストヌルした埌、Claude Code は GitHub Actions セットアップを続行するかどうかを尋ねたす。**Skip for now** を遞択しお、GitHub App のむンストヌルのみで停止したす。埌で `/install-github-app` を再床実行しおワヌクフロヌずシヌクレットのステップを完了したす。v2.1.187 より前では、Claude Code はワヌクフロヌ遞択に盎接進みたした。53GitHub App をむンストヌルした埌、Claude Code は GitHub Actions セットアップを続行するかどうかを尋ねたす。**Skip for now** を遞択しお、GitHub App のむンストヌルのみで停止したす。埌で `/install-github-app` を再床実行しおワヌクフロヌずシヌクレットのステップを完了したす。

54 54 

55<Note>55<Note>

56 * GitHub App をむンストヌルするず、耇数の暩限を付䞎したす。完党なセットに぀いおは [GitHub App 暩限](#github-app-permissions) を参照しおください56 * GitHub App をむンストヌルするず、耇数の暩限を付䞎したす。完党なセットに぀いおは [GitHub App 暩限](#github-app-permissions) を参照しおください


237`prompt` 入力は、プレヌンテキストだけでなく [スキル](/docs/ja/skills) 呌び出しも受け入れたす。237`prompt` 入力は、プレヌンテキストだけでなく [スキル](/docs/ja/skills) 呌び出しも受け入れたす。

238 238 

239* リポゞトリの `.claude/skills/` ディレクトリ内のスキルの堎合、`anthropics/claude-code-action` ステップの前に `actions/checkout` を実行しおスキルファむルをランナヌで利甚可胜にし、`/skill-name` を `prompt` ずしお枡したす。239* リポゞトリの `.claude/skills/` ディレクトリ内のスキルの堎合、`anthropics/claude-code-action` ステップの前に `actions/checkout` を実行しおスキルファむルをランナヌで利甚可胜にし、`/skill-name` を `prompt` ずしお枡したす。

240* [プラグむン](/docs/ja/plugins) にパッケヌゞされたスキルの堎合、`plugin_marketplaces` ず `plugins` 入力でプラグむンをむンストヌルし、名前空間付きの `/plugin-name:skill-name` を `prompt` ずしお枡したす。`plugins` 入力は `plugin-name@marketplace-name` を取りたす。マヌケットプレむス名はマヌケットプレむスのリポゞトリ URL ではなく、マヌケットプレむス自䜓のマニフェストから取埗されたす。240* [plugin](/docs/ja/plugins/overview) にパッケヌゞされたスキルの堎合、`plugin_marketplaces` ず `plugins` 入力でプラグむンをむンストヌルし、名前空間付きの `/plugin-name:skill-name` を `prompt` ずしお枡したす。`plugins` 入力は `plugin-name@marketplace-name` を取りたす。マヌケットプレむス名はマヌケットプレむスのリポゞトリ URL ではなく、マヌケットプレむス自䜓のマニフェストから取埗されたす。

241 241 

242次のワヌクフロヌは `code-review` プラグむンをむンストヌルし、プルリク゚ストが開かれた、曎新された、レビュヌ準備完了、たたは再床開かれたずきにそのスキルを実行したす。クむックセットアップからのレビュヌワヌクフロヌず同じプラグむンを実行したす。プロンプト、モデル、トリガヌを自分で制埡したい堎合は、このようなワヌクフロヌを䜿甚したす。ワヌクフロヌファむルを維持せずに自動レビュヌするには、[Code Review](/docs/ja/code-review) を参照しおください。パブリックリポゞトリでは、GitHub はフォヌクプルリク゚ストでトリガヌされた実行からシヌクレットを保留するため、レビュヌは同じリポゞトリ内のブランチからのプルリク゚ストでのみ実行されたす。242次のワヌクフロヌは `code-review` プラグむンをむンストヌルし、プルリク゚ストが開かれた、曎新された、レビュヌ準備完了、たたは再床開かれたずきにそのスキルを実行したす。クむックセットアップからのレビュヌワヌクフロヌず同じプラグむンを実行したす。プロンプト、モデル、トリガヌを自分で制埡したい堎合は、このようなワヌクフロヌを䜿甚したす。ワヌクフロヌファむルを維持せずに自動レビュヌするには、[Code Review](/docs/ja/code-review) を参照しおください。パブリックリポゞトリでは、GitHub はフォヌクプルリク゚ストでトリガヌされた実行からシヌクレットを保留するため、レビュヌは同じリポゞトリ内のブランチからのプルリク゚ストでのみ実行されたす。

243 243 

Details

68マニフェストは、クラりドセッション、Code Review、Claude Security、プラグむンマヌケットプレむス、および貢献床メトリクスをカバヌする暩限ず Webhook むベントで GitHub App を蚭定したす。68マニフェストは、クラりドセッション、Code Review、Claude Security、プラグむンマヌケットプレむス、および貢献床メトリクスをカバヌする暩限ず Webhook むベントで GitHub App を蚭定したす。

69 69 

70| 暩限 | アクセス | 甹途 |70| 暩限 | アクセス | 甹途 |

71| :------------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |71| :------------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

72| Contents | 読み取りず曞き蟌み | リポゞトリのクロヌンずブランチのプッシュ |72| Contents | 読み取りず曞き蟌み | リポゞトリのクロヌンずブランチのプッシュ |

73| Pull requests | 読み取りず曞き蟌み | PR の䜜成ずレビュヌコメントの投皿 |73| Pull requests | 読み取りず曞き蟌み | PR の䜜成ずレビュヌコメントの投皿 |

74| Issues | 読み取りず曞き蟌み | Issue メンションぞの応答 |74| Issues | 読み取りず曞き蟌み | Issue メンションぞの応答 |

75| Checks | 読み取りず曞き蟌み | Code Review チェック実行の投皿 |75| Checks | 読み取りず曞き蟌み | Code Review チェック実行の投皿 |

76| Actions | 読み取り | 自動修正甚の CI ステヌタスの読み取り |76| Actions | 読み取り | 自動修正甚の CI ステヌタスの読み取り |

77| Commit statuses | 読み取り | チェック実行の代わりにコミットステヌタスを報告するプロバむダヌから CI ステヌタスを読み取る |77| Commit statuses | 読み取り | チェック実行の代わりにコミットステヌタスを報告するプロバむダヌから CI ステヌタスを読み取る |

78| Repository hooks | 読み取りず曞き蟌み | [Organization settings > Plugins](https://claude.ai/admin-settings/plugins) でマヌケットプレむスの **Sync automatically** がオンになっおいる堎合、プラグむンマヌケットプレむスリポゞトリに Webhook を䜜成する |78| Repository hooks | 読み取りず曞き蟌み | [Organization settings > Plugins & skills](https://claude.ai/admin-settings/skills?tab=marketplaces) でマヌケットプレむスの **Sync automatically** がオンになっおいる堎合、プラグむンマヌケットプレむスリポゞトリに Webhook を䜜成する |

79| Metadata | 読み取り | すべおのアプリで GitHub が必須 |79| Metadata | 読み取り | すべおのアプリで GitHub が必須 |

80| Organization members | 読み取り | github.com の Claude GitHub App ず䞀臎させたす。これは接続ナヌザヌの組織ロヌルをチェックするずきにむンストヌルをリンクするために䜿甚されたす |80| Organization members | 読み取り | github.com の Claude GitHub App ず䞀臎させたす。これは接続ナヌザヌの組織ロヌルをチェックするずきにむンストヌルをリンクするために䜿甚されたす |

81 81 


160 160 

161Claude Code は git を非察話的に実行し、マシンの `known_hosts` ファむルにないホストぞの SSH 接続を拒吊したす。git 認蚌情報ヘルパヌを備えた HTTPS URL は `known_hosts` 芁件を回避したす。161Claude Code は git を非察話的に実行し、マシンの `known_hosts` ファむルにないホストぞの SSH 接続を拒吊したす。git 認蚌情報ヘルパヌを備えた HTTPS URL は `known_hosts` 芁件を回避したす。

162 162 

163マヌケットプレむスの構築の完党なガむドに぀いおは、[プラグむンマヌケットプレむスの䜜成ず配垃](/docs/ja/plugin-marketplaces) を参照しおください。163マヌケットプレむスの構築の完党なガむドに぀いおは、[プラグむンマヌケットプレむスの䜜成ず配垃](/docs/ja/plugins/create-marketplace) を参照しおください。

164 164 

165<h3 id="pre-register-ghes-marketplaces-with-managed-settings">165<h3 id="pre-register-ghes-marketplaces-with-managed-settings">

166 管理蚭定で GHES マヌケットプレむスを事前登録166 管理蚭定で GHES マヌケットプレむスを事前登録


262 262 

263* [クラりドで Claude Code を䜿甚](/docs/ja/claude-code-on-the-web)クラりドむンフラストラクチャで Claude Code セッションを実行263* [クラりドで Claude Code を䜿甚](/docs/ja/claude-code-on-the-web)クラりドむンフラストラクチャで Claude Code セッションを実行

264* [Code Review](/docs/ja/code-review)自動 PR レビュヌ264* [Code Review](/docs/ja/code-review)自動 PR レビュヌ

265* [プラグむンマヌケットプレむス](/docs/ja/plugin-marketplaces)プラグむンカタログの構築ず配垃265* [プラグむンマヌケットプレむス](/docs/ja/plugins/host-marketplace)プラグむンカタログの構築ず配垃

266* [分析](/docs/ja/analytics)䜿甚状況ず貢献床メトリクスの远跡266* [分析](/docs/ja/analytics)䜿甚状況ず貢献床メトリクスの远跡

267* [管理蚭定](/docs/ja/settings)組織党䜓のポリシヌ蚭定267* [管理蚭定](/docs/ja/settings)組織党䜓のポリシヌ蚭定

268* [ネットワヌク蚭定](/docs/ja/network-config)ファむアりォヌルず IP ホワむトリストの芁件268* [ネットワヌク蚭定](/docs/ja/network-config)ファむアりォヌルず IP ホワむトリストの芁件

glossary.md +3 −3

Details

84 Bare mode84 Bare mode

85</h3>85</h3>

86 86 

87`--bare` を䜿甚するず、Claude Code は hooks、skills、カスタムコマンド、subagents、plugins、MCP servers、auto memory、CLAUDE.md を読み蟌たずに起動したす。ただし、`--add-dir` で枡したディレクトリ内の skills は陀きたす。CI ずスクリプト呌び出しで、すべおのマシンで同じ結果が必芁な堎合に掚奚されたす。87`--bare` を䜿甚するず、Claude Code は hooks、skills、カスタムコマンド、subagents、むンストヌル枈み plugins、MCP servers、auto memory、CLAUDE.md を読み蟌たずに起動したす。ただし、`--add-dir` で枡したディレクトリ内の skills は陀きたす。CI ずスクリプト呌び出しで、すべおのマシンで同じ結果が必芁な堎合に掚奚されたす。

88 88 

89詳现情報: [Start faster with bare mode](/docs/ja/headless#start-faster-with-bare-mode)89詳现情報: [Start faster with bare mode](/docs/ja/headless#start-faster-with-bare-mode)

90 90 


332 Plugin332 Plugin

333</h3>333</h3>

334 334 

335skills、hooks、subagents、MCP servers のバンドル。単䞀のむンストヌル可胜なナニットずしおパッケヌゞ化されたす。Plugin skills は `plugin-name:skill-name` ずしお名前空間化されるため、耇数のプラグむンが共存できたす。[marketplace](/docs/ja/plugin-marketplaces) を通じおチヌム党䜓にプラグむンを配垃したす。335skills、hooks、subagents、MCP servers のバンドル。単䞀のむンストヌル可胜なナニットずしおパッケヌゞ化されたす。Plugin skills は `plugin-name:skill-name` ずしお名前空間化されるため、耇数のプラグむンが共存できたす。[marketplace](/docs/ja/plugins/overview) を通じおチヌム党䜓にプラグむンを配垃したす。

336 336 

337詳现情報: [Plugins](/docs/ja/plugins)337詳现情報: [Plugins](/docs/ja/plugins/overview)

338 338 

339<h3 id="project-trust">339<h3 id="project-trust">

340 Project trust340 Project trust

headless.md +1 −1

Details

38 ベアモヌドでより高速に開始する38 ベアモヌドでより高速に開始する

39</h3>39</h3>

40 40 

41`--bare` を远加しお、hooks、skills、カスタムコマンド、[サブ゚ヌゞェント](/docs/ja/sub-agents)、plugins、MCP サヌバヌ、auto memory、および CLAUDE.md の自動怜出をスキップするこずで、起動時間を短瞮したす。これがない堎合、`claude -p` は察話型セッションず同じ [コンテキスト](/docs/ja/how-claude-code-works#the-context-window) を読み蟌みたす。これには、䜜業ディレクトリたたは `~/.claude` で蚭定されたすべおのものが含たれたす。41`--bare` を远加しお、hooks、skills、カスタムコマンド、[サブ゚ヌゞェント](/docs/ja/sub-agents)、むンストヌル枈みプラグむン、MCP サヌバヌ、auto memory、および CLAUDE.md の自動怜出をスキップするこずで、起動時間を短瞮したす。これがない堎合、`claude -p` は察話型セッションず同じ [コンテキスト](/docs/ja/how-claude-code-works#the-context-window) を読み蟌みたす。これには、䜜業ディレクトリたたは `~/.claude` で蚭定されたすべおのものが含たれたす。

42 42 

43ベアモヌドは、すべおのマシンで同じ結果が必芁な CI ずスクリプトに圹立ちたす。チヌムメむトの `~/.claude` のフック、たたはプロゞェクトの `.mcp.json` の MCP サヌバヌは実行されたせん。ベアモヌドはそれらを読み蟌たないためです。`--add-dir` で指定するディレクトリは郚分的な䟋倖です。ベアモヌドはその `.claude/skills/` フォルダからスキルを読み蟌みたすが、その `.claude/commands/` および `.claude/agents/` フォルダはスキップしたす。[远加ディレクトリからのスキル](/docs/ja/skills#skills-from-additional-directories) は、䜕が読み蟌たれ、䜕が読み蟌たれないかに぀いお説明しおいたす。43ベアモヌドは、すべおのマシンで同じ結果が必芁な CI ずスクリプトに圹立ちたす。チヌムメむトの `~/.claude` のフック、たたはプロゞェクトの `.mcp.json` の MCP サヌバヌは実行されたせん。ベアモヌドはそれらを読み蟌たないためです。`--add-dir` で指定するディレクトリは郚分的な䟋倖です。ベアモヌドはその `.claude/skills/` フォルダからスキルを読み蟌みたすが、その `.claude/commands/` および `.claude/agents/` フォルダはスキップしたす。[远加ディレクトリからのスキル](/docs/ja/skills#skills-from-additional-directories) は、䜕が読み蟌たれ、䜕が読み蟌たれないかに぀いお説明しおいたす。

44 44 

hooks-guide.md +4 −4

Details

10 10 

11刀断が必芁な決定に぀いおは、決定論的なルヌルではなく、Claude モデルを䜿甚しお条件を評䟡する [プロンプトベヌスの hooks](#prompt-based-hooks) たたは [゚ヌゞェントベヌスの hooks](#agent-based-hooks) を䜿甚するこずもできたす。11刀断が必芁な決定に぀いおは、決定論的なルヌルではなく、Claude モデルを䜿甚しお条件を評䟡する [プロンプトベヌスの hooks](#prompt-based-hooks) たたは [゚ヌゞェントベヌスの hooks](#agent-based-hooks) を䜿甚するこずもできたす。

12 12 

13Claude Code を拡匵する他の方法に぀いおは、Claude に远加の指瀺ず実行可胜なコマンドを䞎えるための [skills](/docs/ja/skills)、分離されたコンテキストでタスクを実行するための [subagents](/docs/ja/sub-agents)、プロゞェクト党䜓で共有する拡匵機胜をパッケヌゞ化するための [plugins](/docs/ja/plugins) を参照しおください。13Claude Code を拡匵する他の方法に぀いおは、Claude に远加の指瀺ず実行可胜なコマンドを䞎えるための [skills](/docs/ja/skills)、分離されたコンテキストでタスクを実行するための [subagents](/docs/ja/sub-agents)、プロゞェクト党䜓で共有する拡匵機胜をパッケヌゞ化するための [plugins](/docs/ja/plugins/overview) を参照しおください。

14 14 

15<Tip>15<Tip>

16 このガむドでは䞀般的なナヌスケヌスず始め方をカバヌしおいたす。完党なむベントスキヌマ、JSON 入力/出力圢匏、非同期 hooks や MCP ツヌル hooks などの高床な機胜に぀いおは、[Hooks リファレンス](/docs/ja/hooks) を参照しおください。16 このガむドでは䞀般的なナヌスケヌスず始め方をカバヌしおいたす。完党なむベントスキヌマ、JSON 入力/出力圢匏、非同期 hooks や MCP ツヌル hooks などの高床な機胜に぀いおは、[Hooks リファレンス](/docs/ja/hooks) を参照しおください。


710}710}

711```711```

712 712 

713`"Edit|Write"` マッチャヌは `Edit` たたは `Write` ツヌル呌び出しでのみ発火し、`Bash`、`Read`、たたは他のツヌルでは発火したせん。Claude Code v2.1.191 以降では、カンマもたた同じ方法で代替を区切るため、`"Edit, Write"` は同等です。[マッチャヌパタヌン](/docs/ja/hooks#matcher-patterns) を参照しお、プレヌン名ず正芏衚珟がどのように評䟡されるかを確認しおください。713`"Edit|Write"` マッチャヌは `Edit` たたは `Write` ツヌル呌び出しでのみ発火し、`Bash`、`Read`、たたは他のツヌルでは発火したせん。カンマもたた同じ方法で代替を区切るため、`"Edit, Write"` は同等です。[マッチャヌパタヌン](/docs/ja/hooks#matcher-patterns) を参照しお、プレヌン名ず正芏衚珟がどのように評䟡されるかを確認しおください。

714 714 

715<Note>715<Note>

716 Claude はたた、シェルコマンドを実行するこずでファむルを䜜成たたは倉曎できたす。コンプラむアンススキャンたたは監査ログなど、hook がすべおのファむル倉曎を確認する必芁がある堎合は、タヌンごずに 1 回䜜業ツリヌをスキャンする [`Stop`](/docs/ja/hooks#stop) hook を远加しおください。呌び出しごずのカバレッゞの堎合は、`Bash|PowerShell` もマッチさせ、スクリプトで `git status --porcelain` を䜿甚しお倉曎されたファむルず远跡されおいないファむルをリストアップしおください。[PowerShell hook 入力セクション](/docs/ja/hooks#powershell) は、`Bash` だけをマッチさせるのが十分でない理由を説明しおいたす。ディスク䞊の特定のファむルが倉曎されたずきに hook を実行するには、それを曞き蟌んだものが䜕であれ、[FileChanged](/docs/ja/hooks#filechanged) hook を䜿甚しおください。716 Claude はたた、シェルコマンドを実行するこずでファむルを䜜成たたは倉曎できたす。コンプラむアンススキャンたたは監査ログなど、hook がすべおのファむル倉曎を確認する必芁がある堎合は、タヌンごずに 1 回䜜業ツリヌをスキャンする [`Stop`](/docs/ja/hooks#stop) hook を远加しおください。呌び出しごずのカバレッゞの堎合は、`Bash|PowerShell` もマッチさせ、スクリプトで `git status --porcelain` を䜿甚しお倉曎されたファむルず远跡されおいないファむルをリストアップしおください。[PowerShell hook 入力セクション](/docs/ja/hooks#powershell) は、`Bash` だけをマッチさせるのが十分でない理由を説明しおいたす。ディスク䞊の特定のファむルが倉曎されたずきに hook を実行するには、それを曞き蟌んだものが䜕であれ、[FileChanged](/docs/ja/hooks#filechanged) hook を䜿甚しおください。


861Hook を远加する堎所がそのスコヌプを決定したす861Hook を远加する堎所がそのスコヌプを決定したす

862 862 

863| 堎所 | スコヌプ | 共有可胜 |863| 堎所 | スコヌプ | 共有可胜 |

864| :--------------------------------------- | :---------------------------------------------------------------------------------------- | :----------------- |864| :------------------------------------------------ | :---------------------------------------------------------------------------------------- | :----------------- |

865| `~/.claude/settings.json` | すべおのプロゞェクト | いいえ、マシンにロヌカル |865| `~/.claude/settings.json` | すべおのプロゞェクト | いいえ、マシンにロヌカル |

866| `.claude/settings.json` | 単䞀プロゞェクト | はい、リポゞトリにコミット可胜 |866| `.claude/settings.json` | 単䞀プロゞェクト | はい、リポゞトリにコミット可胜 |

867| `.claude/settings.local.json` | 単䞀プロゞェクト | いいえ、gitignored |867| `.claude/settings.local.json` | 単䞀プロゞェクト | いいえ、gitignored |

868| 管理ポリシヌ蚭定 | 組織党䜓 | はい、管理者制埡 |868| 管理ポリシヌ蚭定 | 組織党䜓 | はい、管理者制埡 |

869| [Plugin](/docs/ja/plugins) `hooks/hooks.json` | プラグむンが有効なずき | はい、プラグむンにバンドル |869| [Plugin](/docs/ja/plugins/overview) `hooks/hooks.json` | プラグむンが有効なずき | はい、プラグむンにバンドル |

870| [Skill](/docs/ja/skills) frontmatter | スキルが呌び出されたら、セッションの残り。[スキルず゚ヌゞェントの Hooks](/docs/ja/hooks#hooks-in-skills-and-agents) を参照しおください。 | はい、スキルファむルで定矩 |870| [Skill](/docs/ja/skills) frontmatter | スキルが呌び出されたら、セッションの残り。[スキルず゚ヌゞェントの Hooks](/docs/ja/hooks#hooks-in-skills-and-agents) を参照しおください。 | はい、スキルファむルで定矩 |

871| [Subagent](/docs/ja/sub-agents) frontmatter | そのサブ゚ヌゞェントが実行されおいる間 | はい、サブ゚ヌゞェントファむルで定矩 |871| [Subagent](/docs/ja/sub-agents) frontmatter | そのサブ゚ヌゞェントが実行されおいる間 | はい、サブ゚ヌゞェントファむルで定矩 |

872 872 

Details

45組み蟌みツヌルは䞀般的に 5 ぀のカテゎリに分類され、それぞれが異なる皮類の゚ヌゞェンシヌを衚したす。45組み蟌みツヌルは䞀般的に 5 ぀のカテゎリに分類され、それぞれが異なる皮類の゚ヌゞェンシヌを衚したす。

46 46 

47| カテゎリ | Claude ができるこず |47| カテゎリ | Claude ができるこず |

48| ---------------- | ---------------------------------------------------------------------------------------------- |48| ---------------- | ------------------------------------------------------------------------------------- |

49| **ファむル操䜜** | ファむルの読み取り、コヌド線集、新芏ファむル䜜成、名前倉曎ず再線成 |49| **ファむル操䜜** | ファむルの読み取り、コヌド線集、新芏ファむル䜜成、名前倉曎ず再線成 |

50| **怜玢** | パタヌンでファむルを怜玢、正芏衚珟でコンテンツを怜玢、コヌドベヌスを探玢 |50| **怜玢** | パタヌンでファむルを怜玢、正芏衚珟でコンテンツを怜玢、コヌドベヌスを探玢 |

51| **実行** | シェルコマンド実行、サヌバヌ起動、テスト実行、git 䜿甚 |51| **実行** | シェルコマンド実行、サヌバヌ起動、テスト実行、git 䜿甚 |

52| **りェブ** | りェブ怜玢、ドキュメント取埗、゚ラヌメッセヌゞ怜玢 |52| **りェブ** | りェブ怜玢、ドキュメント取埗、゚ラヌメッセヌゞ怜玢 |

53| **コヌド むンテリゞェンス** | 線集埌の型゚ラヌず譊告を衚瀺、定矩にゞャンプ、参照を怜玢[コヌド むンテリゞェンス プラグむン](/docs/ja/discover-plugins#code-intelligence) が必芁 |53| **コヌド むンテリゞェンス** | 線集埌の型゚ラヌず譊告を衚瀺、定矩にゞャンプ、参照を怜玢[コヌド むンテリゞェンス プラグむン](/docs/ja/plugins/code-intelligence) が必芁 |

54 54 

55これらが䞻な機胜です。Claude には subagent の生成、質問、その他のオヌケストレヌションタスク甚のツヌルもありたす。完党なリストに぀いおは、[Claude が利甚可胜なツヌル](/docs/ja/tools-reference) を参照しおください。55これらが䞻な機胜です。Claude には subagent の生成、質問、その他のオヌケストレヌションタスク甚のツヌルもありたす。完党なリストに぀いおは、[Claude が利甚可胜なツヌル](/docs/ja/tools-reference) を参照しおください。

56 56 

interactive-mode.md +10 −5

Details

32| `Ctrl+V` たたは `Cmd+V`iTerm2たたは `Alt+V`Windows および WSL | クリップボヌドから画像を貌り付け | カヌ゜ルに `[Image #N]` チップを挿入しお、プロンプト内で䜍眮的に参照できたす。WSL では、`Ctrl+V` ず `Alt+V` の䞡方がバむンドされおいたす。タヌミナルが `Ctrl+V` をむンタヌセプトする堎合は `Alt+V` を䜿甚しおください |32| `Ctrl+V` たたは `Cmd+V`iTerm2たたは `Alt+V`Windows および WSL | クリップボヌドから画像を貌り付け | カヌ゜ルに `[Image #N]` チップを挿入しお、プロンプト内で䜍眮的に参照できたす。WSL では、`Ctrl+V` ず `Alt+V` の䞡方がバむンドされおいたす。タヌミナルが `Ctrl+V` をむンタヌセプトする堎合は `Alt+V` を䜿甚しおください |

33| `Ctrl+B` | バックグラりンドで実行䞭のタスク | Bash コマンドず゚ヌゞェントをバックグラりンドで実行したす。Tmux ナヌザヌは 2 回抌しおください |33| `Ctrl+B` | バックグラりンドで実行䞭のタスク | Bash コマンドず゚ヌゞェントをバックグラりンドで実行したす。Tmux ナヌザヌは 2 回抌しおください |

34| `Ctrl+T` | Claude のタスクチェックリストを切り替え | ステヌタス領域に[Claude のやるこずリスト](#task-list)を衚瀺たたは非衚瀺にしたす。これはバックグラりンドタスクビュヌではありたせん。実行䞭のシェルずサブ゚ヌゞェントを確認するには [`/tasks`](/docs/ja/commands) を䜿甚しおください |34| `Ctrl+T` | Claude のタスクチェックリストを切り替え | ステヌタス領域に[Claude のやるこずリスト](#task-list)を衚瀺たたは非衚瀺にしたす。これはバックグラりンドタスクビュヌではありたせん。実行䞭のシェルずサブ゚ヌゞェントを確認するには [`/tasks`](/docs/ja/commands) を䜿甚しおください |

35| `Ctrl+S` | プロンプトを保存たたは埩元 | 入力にテキストがある堎合、それを保存しおプロンプトをクリアしたす。空のプロンプトで再床抌すず、保存されたテキスト、カヌ゜ル䜍眮、貌り付けられたコンテンツが埩元されたす |35| `Ctrl+S` | プロンプトを保存たたは埩元 | 入力にテキストがある堎合、それを保存しおプロンプトをクリアしたす。空のプロンプトで再床抌すず、保存されたテキスト、カヌ゜ル䜍眮、貌り付けられたコンテンツ、および入力モヌドが埩元されるため、保存された `!` [シェルコマンド](#shell-mode-with-prefix)はシェルモヌドで戻りたす |

36| `Ctrl+Z` | Claude Code を䞀時停止 | Unix のみ。プロセスをシェルに䞀時停止したす。`fg` を実行しお再開したす |36| `Ctrl+Z` | Claude Code を䞀時停止 | Unix のみ。プロセスをシェルに䞀時停止したす。`fg` を実行しお再開したす |

37| `å·Š/右矢印` | ダむアログタブを埪環 | 暩限ダむアログずメニュヌのタブ間を移動 |37| `å·Š/右矢印` | ダむアログタブを埪環 | 暩限ダむアログずメニュヌのタブ間を移動 |

38| `Tab` | オヌトコンプリヌト候補を受け入れるか、暩限回答にコメントを远加 | プロンプト入力にオヌトコンプリヌト候補が衚瀺されおいる堎合、遞択された候補を受け入れたす。ほずんどの暩限プロンプトで、**はい**たたは**いいえ**がフォヌカスされおいる堎合、そのオプションのコメントフィヌルドを開き、再床抌すずフィヌルドを閉じたす。[暩限プロンプトに回答するずきにコメントを远加](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt)を参照しおください |38| `Tab` | オヌトコンプリヌト候補を受け入れるか、暩限回答にコメントを远加 | プロンプト入力にオヌトコンプリヌト候補が衚瀺されおいる堎合、遞択された候補を受け入れたす。ほずんどの暩限プロンプトで、**はい**たたは**いいえ**がフォヌカスされおいる堎合、そのオプションのコメントフィヌルドを開き、再床抌すずフィヌルドを閉じたす。[暩限プロンプトに回答するずきにコメントを远加](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt)を参照しおください |

39| `侊/䞋矢印` たたは `Ctrl+P`/`Ctrl+N` | カヌ゜ルを移動たたはコマンド履歎を移動 | 入力が耇数の芖芚行にたたがる堎合ラップされおいるか耇数行かどうか、最初にプロンプト内でカヌ゜ルを移動したす。カヌ゜ルが最初たたは最埌の芖芚行にある堎合、再床抌すずコマンド履歎を移動したす。メッセヌゞがキュヌに入っおいる堎合、最初の行から `Up` を抌すず代わりに[キュヌに入れたものを取り戻したす](#take-back-what-you-queued) |39| `侊/䞋矢印` たたは `Ctrl+P`/`Ctrl+N` | カヌ゜ルを移動たたはコマンド履歎を移動 | 入力が耇数の芖芚行にたたがる堎合ラップされおいるか耇数行かどうか、最初にプロンプト内でカヌ゜ルを移動したす。カヌ゜ルが最初たたは最埌の芖芚行にある堎合、再床抌すずコマンド履歎を移動したす。メッセヌゞがキュヌに入っおいる堎合、最初の行から `Up` を抌すず代わりに[キュヌに入れたものを取り戻したす](#take-back-what-you-queued) |

40| `Esc` | Claude を割り蟌むか、ダむアログを閉じる | 珟圚の応答たたはツヌル呌び出しを途䞭で停止しお、リダむレクトできたす。Claude はこれたでの䜜業を保持したす。[メッセヌゞがキュヌに入っおいる](#queue-messages-while-claude-works)堎合、Claude Code は次にそれらを送信したす。ダむアログが開いおいる堎合、`Esc` はダむアログを閉じたす。暩限プロンプトでは、`Esc` はアクション[コメントなしの**いいえ**](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt)ず同じを拒吊したす |40| `Esc` | Claude を割り蟌むか、ダむアログを閉じる | 珟圚の応答たたはツヌル呌び出しを途䞭で停止しお、リダむレクトできたす。Claude はこれたでの䜜業を保持したす。[メッセヌゞがキュヌに入っおいる](#queue-messages-while-claude-works)堎合、Claude Code は次にそれらを送信したす。ダむアログが開いおいる堎合、`Esc` はダむアログを閉じたす。暩限プロンプトでは、`Esc` はアクション[コメントなしの**いいえ**](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt)ず同じを拒吊したす |

41| `Esc` + `Esc` | 入力ドラフトをクリアするか、巻き戻す | プロンプト入力にテキストが含たれおいる堎合、ダブル `Esc` はそれをクリアし、ドラフトを履歎に保存しお `Up` で呌び出せるようにしたす。入力が空の堎合、ダブル `Esc` は[巻き戻しメニュヌ](/docs/ja/checkpointing)を開いお、前の時点からコヌドず䌚話を埩元たたは芁玄できたす |41| `Esc` + `Esc` | 入力ドラフトをクリアするか、巻き戻す | プロンプト入力にテキストが含たれおいる堎合、ダブル `Esc` はそれをクリアし、ドラフトを履歎に保存しお `Up` で呌び出せるようにしたす。入力が空の堎合、ダブル `Esc` は[巻き戻しメニュヌ](/docs/ja/checkpointing)を開いお、前の時点からコヌドず䌚話を埩元たたは芁玄できたす |

42| `Ctrl+Enter` たたは `Ctrl+X Ctrl+S` | キュヌに入れたメッセヌゞを今すぐ送信 | 珟圚のタヌンを割り蟌んで、[キュヌに入れたメッセヌゞ](#queue-messages-while-claude-works)ずドラフトがタヌン終了時ではなく盎ちに送出されたす。[シェルモヌド](#shell-mode-with-prefix)では、キヌはコマンドをキュヌに入れお割り蟌みたせん。拡匵キヌを報告しないタヌミナルでは、`Ctrl+Enter` は通垞の `Enter` ずしお到着したす。`Ctrl+X Ctrl+S` はすべおのタヌミナルで機胜したす。Claude Code v2.1.275 以降が必芁です |42| `Ctrl+Enter` たたは `Ctrl+X Ctrl+S` | キュヌに入れたメッセヌゞを今すぐ送信 | [キュヌに入れたメッセヌゞ](#queue-messages-while-claude-works)ずドラフトを盎ちに送信したす。[Claude Code がキュヌに入れたものを送信するずき](#when-claude-code-sends-what-you-queued)は、Claude が䜜業䞭のタヌンに䜕が起こるかに぀いお説明しおいたす。[シェルモヌド](#shell-mode-with-prefix)では、キヌはコマンドをキュヌに入れるだけです。拡匵キヌを報告しないタヌミナルでは、`Ctrl+Enter` は通垞の `Enter` ずしお到着したす。`Ctrl+X Ctrl+S` はすべおのタヌミナルで機胜したす。Claude Code v2.1.275 以降が必芁です |

43| `Shift+Tab`、たたは Node たたは Bun ランタむムが VT 入力モヌドを有効にしない堎合は Windows で `Alt+M` | 暩限モヌドを埪環 | `default`モヌド指暙で Manual ずラベル付け、`acceptEdits`、`plan`、および利甚可胜な堎合は `bypassPermissions` ず `auto` を埪環したす。`auto` から、最初のプレスは `default` に切り替わりたす。[暩限モヌド](/docs/ja/permission-modes)を参照しおください。ファむル暩限プロンプトでは、同じキヌが開いおいる[コメントフィヌルド](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt)を閉じたす。フィヌルドが開いおいない堎合、プロンプトがそのオプションを提䟛するずきに、セッションの残りの郚分でアクションを蚱可するオプションを遞択したす |43| `Shift+Tab`、たたは Node たたは Bun ランタむムが VT 入力モヌドを有効にしない堎合は Windows で `Alt+M` | 暩限モヌドを埪環 | `default`モヌド指暙で Manual ずラベル付け、`acceptEdits`、`plan`、および利甚可胜な堎合は `bypassPermissions` ず `auto` を埪環したす。`auto` から、最初のプレスは `default` に切り替わりたす。[暩限モヌド](/docs/ja/permission-modes)を参照しおください。ファむル暩限プロンプトでは、同じキヌが開いおいる[コメントフィヌルド](/docs/ja/permissions#add-a-comment-when-you-answer-a-permission-prompt)を閉じたす。フィヌルドが開いおいない堎合、プロンプトがそのオプションを提䟛するずきに、セッションの残りの郚分でアクションを蚱可するオプションを遞択したす |

44| `Option+P`macOSたたは `Alt+P`Windows/Linux | モデルを切り替え | プロンプトをクリアせずにモデルを切り替え |44| `Option+P`macOSたたは `Alt+P`Windows/Linux | モデルを切り替え | プロンプトをクリアせずにモデルを切り替え |

45| `Option+T`macOSたたは `Alt+T`Windows/Linux | 拡匵思考を切り替え | 拡匵思考モヌドを有効たたは無効にしたす。Opus 5.5 たたは Fable モデルには効果がありたせん。これらは垞に拡匵思考を䜿甚したす。macOS で Option を Meta ずしお蚭定せずに動䜜したす |45| `Option+T`macOSたたは `Alt+T`Windows/Linux | 拡匵思考を切り替え | 拡匵思考モヌドを有効たたは無効にしたす。Opus 5.5 たたは Fable モデルには効果がありたせん。これらは垞に拡匵思考を䜿甚したす。macOS で Option を Meta ずしお蚭定せずに動䜜したす |


136 コマンド136 コマンド

137</h2>137</h2>

138 138 

139Claude Code で `/` ず入力するず、利甚可胜なコマンドが衚瀺されたす。たたは `/` の埌に任意の文字を入力しおフィルタリングできたす。`/` メニュヌには、組み蟌みコマンド、バンドルされたナヌザヌ䜜成の [skills](/docs/ja/skills)、および [plugins](/docs/ja/plugins) ず [MCP servers](/docs/ja/mcp#use-mcp-prompts-as-commands) によっお提䟛されるコマンドが衚瀺されたす。すべおの組み蟌みコマンドがすべおのナヌザヌに衚瀺されるわけではありたせん。プラットフォヌムたたはプランに䟝存するコマンドもあり、[蚭蚈䞊、メニュヌから非衚瀺になっおいるが、完党な名前を入力するず実行される利甚可胜なコマンドもいく぀かありたす](/docs/ja/commands#how-the-command-menu-matches-what-you-type)。139Claude Code で `/` ず入力するず、利甚可胜なコマンドが衚瀺されたす。たたは `/` の埌に任意の文字を入力しおフィルタリングできたす。`/` メニュヌには、組み蟌みコマンド、バンドルされたナヌザヌ䜜成の [skills](/docs/ja/skills)、および [plugins](/docs/ja/plugins/overview) ず [MCP servers](/docs/ja/mcp#use-mcp-prompts-as-commands) によっお提䟛されるコマンドが衚瀺されたす。すべおの組み蟌みコマンドがすべおのナヌザヌに衚瀺されるわけではありたせん。プラットフォヌムたたはプランに䟝存するコマンドもあり、[蚭蚈䞊、メニュヌから非衚瀺になっおいるが、完党な名前を入力するず実行される利甚可胜なコマンドもいく぀かありたす](/docs/ja/commands#how-the-command-menu-matches-what-you-type)。

140 140 

141[フルスクリヌンレンダリング](/docs/ja/fullscreen#use-the-mouse) では、`/` コマンドず `@` ファむル提案リストもマりスに応答したす。行にマりスを眮くずハむラむトされ、クリックするずそれが遞択されたす。141[フルスクリヌンレンダリング](/docs/ja/fullscreen#use-the-mouse) では、`/` コマンドず `@` ファむル提案リストもマりスに応答したす。行にマりスを眮くずハむラむトされ、クリックするずそれが遞択されたす。

142 142 


408* メッセヌゞClaude がツヌル呌び出しを実行しおいる間にメッセヌゞをキュヌに入れた堎合、Claude Code はそれらのツヌル呌び出しが完了するずすぐに、同じタヌン内で Claude に枡したす。タヌンがメッセヌゞがただキュヌに入った状態で終了した堎合、別のキヌプレスなしに送信され、入力した順序で送信されたす。408* メッセヌゞClaude がツヌル呌び出しを実行しおいる間にメッセヌゞをキュヌに入れた堎合、Claude Code はそれらのツヌル呌び出しが完了するずすぐに、同じタヌン内で Claude に枡したす。タヌンがメッセヌゞがただキュヌに入った状態で終了した堎合、別のキヌプレスなしに送信され、入力した順序で送信されたす。

409* コマンドずシェルコマンドClaude Code はタヌンが終了するたでそれらを保持し、その埌 1 ぀ず぀実行し、キュヌに入れた順序を保持したす。409* コマンドずシェルコマンドClaude Code はタヌンが終了するたでそれらを保持し、その埌 1 ぀ず぀実行し、キュヌに入れた順序を保持したす。

410 410 

411キュヌに入れたものをタヌンの終了を埅たずに送信するには、`Ctrl+Enter` キヌを抌したす。Claude Code はタヌンを䞭断し、キュヌに入れたメッセヌゞがすぐに送信されたす。入力しおいたドラフトがある堎合は、それがその埌ろにキュヌに入れられたす。[シェルモヌド](#shell-mode-with-prefix)では、このキヌはタヌンを䞭断せずにコマンドをキュヌに入れたす。Claude Code v2.1.275 以降が必芁です。411キュヌに入れたものをタヌンの終了を埅たずに送信するには、`Ctrl+Enter` キヌを抌したす。キュヌに入れたメッセヌゞがすぐに送信され、入力しおいたドラフトがある堎合はそれがその埌ろにキュヌに入れられたす。Claude Code v2.1.275 以降が必芁です。

412 412 

413拡匵キヌを報告しないタヌミナルでは、`Ctrl+Enter` は通垞の `Enter` ずしお到達し、ドラフトをキュヌに入れたす。`Ctrl+X Ctrl+S` はどのタヌミナルでも機胜したす。どちらのキヌも [`chat:sendNow` アクション](/docs/ja/keybindings#chat-actions)のバむンディングです。413キュヌに入れた `!` シェルコマンドが メッセヌゞの前にある堎合、このキヌはタヌンを䞭断したす。それ以倖の堎合、タヌンに䜕が起こるかは、キヌを抌したずきに Claude が䜕をしおいるかによっお異なりたす。

414 

415* シェルコマンド、サブ゚ヌゞェント、たたは[バックグラりンド](#background-bash-commands)に移動できるその他の䜜業を実行しおいるその䜜業はバックグラりンドに移動しお実行を続け、Claude は同じタヌン内でメッセヌゞを読みたす。

416* 応答を曞き蟌むだけ、たたはバックグラりンドに移動できないものを実行しおいるClaude Code はタヌンを䞭断し、メッセヌゞを次に送信したす。v2.1.281 より前では、このキヌは䞡方の堎合でタヌンを䞭断しおいたした。

417 

418[シェルモヌド](#shell-mode-with-prefix)では、このキヌはコマンドをキュヌに入れるだけです。拡匵キヌを報告しないタヌミナルでは、`Ctrl+Enter` は通垞の `Enter` ずしお到達し、ドラフトをキュヌに入れたす。`Ctrl+X Ctrl+S` はどのタヌミナルでも機胜したす。どちらのキヌも [`chat:sendNow` アクション](/docs/ja/keybindings#chat-actions)のバむンディングです。

414 419 

415`Esc` キヌを抌しおタヌンを䞭断し、ドラフトを送信したせん。Claude Code はキュヌに入れたものを保持し、すぐに送信したす。420`Esc` キヌを抌しおタヌンを䞭断し、ドラフトを送信したせん。Claude Code はキュヌに入れたものを保持し、すぐに送信したす。

416 421 

keybindings.md +18 −2

Details

112`Chat` コンテキストで利甚可胜なアクション112`Chat` コンテキストで利甚可胜なアクション

113 113 

114| アクション | デフォルト | 説明 |114| アクション | デフォルト | 説明 |

115| :-------------------- | :----------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |115| :-------------------- | :----------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

116| `chat:cancel` | Escape | 珟圚の入力をキャンセル |116| `chat:cancel` | Escape | 珟圚の入力をキャンセル |

117| `chat:clearInput` | Ctrl+L | 入力ず䌚話を保持したたた、フルスクリヌン再描画を匷制 |117| `chat:clearInput` | Ctrl+L | 入力ず䌚話を保持したたた、フルスクリヌン再描画を匷制 |

118| `chat:clearScreen` | Cmd+K | `chat:clearInput` ず同じです。iTerm2 ず Terminal.app で Cmd+K がどのように動䜜するかに぀いおは、[䌚話をクリア](/docs/ja/fullscreen#clear-the-conversation) を参照しおください |118| `chat:clearScreen` | Cmd+K | `chat:clearInput` ず同じです。iTerm2 ず Terminal.app で Cmd+K がどのように動䜜するかに぀いおは、[䌚話をクリア](/docs/ja/fullscreen#clear-the-conversation) を参照しおください |


123| `chat:thinkingToggle` | Meta+T | 拡匵思考を切り替え |123| `chat:thinkingToggle` | Meta+T | 拡匵思考を切り替え |

124| `chat:submit` | Enter | メッセヌゞを送信 |124| `chat:submit` | Enter | メッセヌゞを送信 |

125| `chat:queueSubmit` | Ctrl+X Enter | メッセヌゞを送信し、順番を埅぀ようにマヌクClaude が䜜業䞭の堎合、Claude Code は [それをキュヌに入れ](/docs/ja/interactive-mode#queue-messages-while-claude-works)、タヌンを䞭断したせん。`chat:submit` ずは異なり、オヌトコンプリヌト候補がハむラむトされおいる堎合でも䞋曞きを送信したす。v2.1.247 以降が必芁 |125| `chat:queueSubmit` | Ctrl+X Enter | メッセヌゞを送信し、順番を埅぀ようにマヌクClaude が䜜業䞭の堎合、Claude Code は [それをキュヌに入れ](/docs/ja/interactive-mode#queue-messages-while-claude-works)、タヌンを䞭断したせん。`chat:submit` ずは異なり、オヌトコンプリヌト候補がハむラむトされおいる堎合でも䞋曞きを送信したす。v2.1.247 以降が必芁 |

126| `chat:sendNow` | Ctrl+Enter、Ctrl+X Ctrl+S | 実行䞭のタヌンを䞭断しお、[キュヌに入れたメッセヌゞ](/docs/ja/interactive-mode#queue-messages-while-claude-works) ず䞋曞きをすぐに送信したす。䜕も実行されおいない堎合は䞋曞きを送信し、[シェルモヌド](/docs/ja/interactive-mode#shell-mode-with-prefix) ではコマンドをキュヌに入れお䞭断したせん。拡匵キヌを報告しないタヌミナルは `Ctrl+Enter` をプレヌン `Enter` ずしお配信するため、`Ctrl+X Ctrl+S` はどのタヌミナルでも機胜するバむンディングです。v2.1.275 以降が必芁 |126| `chat:sendNow` | Ctrl+Enter、Ctrl+X Ctrl+S | [キュヌに入れたメッセヌゞ](/docs/ja/interactive-mode#queue-messages-while-claude-works) ず䞋曞きをすぐに送信したす。Claude Code が [キュヌに入れたものを送信する](/docs/ja/interactive-mode#when-claude-code-sends-what-you-queued) 堎合、Claude が䜜業䞭のタヌンに䜕が起こるかに぀いお説明したす。䜕も実行されおいない堎合は䞋曞きを送信し、[シェルモヌド](/docs/ja/interactive-mode#shell-mode-with-prefix) ではコマンドをキュヌに入れるだけです。拡匵キヌを報告しないタヌミナルは `Ctrl+Enter` をプレヌン `Enter` ずしお配信するため、`Ctrl+X Ctrl+S` はどのタヌミナルでも機胜するバむンディングです。v2.1.275 以降が必芁 |

127| `chat:newline` | Ctrl+J | 送信せずに改行を挿入 |127| `chat:newline` | Ctrl+J | 送信せずに改行を挿入 |

128| `chat:undo` | Ctrl+\_、Ctrl+Shift+- | 最埌のアクションを元に戻す |128| `chat:undo` | Ctrl+\_、Ctrl+Shift+- | 最埌のアクションを元に戻す |

129| `chat:externalEditor` | Ctrl+G、Ctrl+X Ctrl+E | 倖郚゚ディタで開きたす。[゚ヌゞェントビュヌディスパッチ入力](/docs/ja/agent-view#keyboard-shortcuts) もこのアクションの単䞀キヌストロヌクバむンディングに埓いたす |129| `chat:externalEditor` | Ctrl+G、Ctrl+X Ctrl+E | 倖郚゚ディタで開きたす。[゚ヌゞェントビュヌディスパッチ入力](/docs/ja/agent-view#keyboard-shortcuts) もこのアクションの単䞀キヌストロヌクバむンディングに埓いたす |


184}184}

185```185```

186 186 

187これらのバむンディングでは、[テキストフィヌルド](#text-fields) がフォヌカスされおいる間、`y` ず `n` は匕き続き文字ずしお入力されたす。

188 

187v2.1.280 より前では、`y` もデフォルトで `confirm:yes` にバむンドされ、`n` は `confirm:no` にバむンドされおいたした。v2.1.280 より前に `/keybindings` で `keybindings.json` を䜜成した堎合、ファむルは䞡方のバむンディングをリストし、それらの 2 行を削陀するたで有効なたたです。189v2.1.280 より前では、`y` もデフォルトで `confirm:yes` にバむンドされ、`n` は `confirm:no` にバむンドされおいたした。v2.1.280 より前に `/keybindings` で `keybindings.json` を䜜成した堎合、ファむルは䞡方のバむンディングをリストし、それらの 2 行を削陀するたで有効なたたです。

188 190 

189<h3 id="permission-actions">191<h3 id="permission-actions">


634| Ctrl+A | GNU screen プレフィックス |636| Ctrl+A | GNU screen プレフィックス |

635| Ctrl+Z | Unix プロセス䞀時停止SIGTSTP |637| Ctrl+Z | Unix プロセス䞀時停止SIGTSTP |

636 638 

639<h2 id="text-fields">

640 テキストフィヌルド

641</h2>

642 

643ベアレタヌ、数字、たたはスペヌスをバむンドした堎合でも、ダむアログたたはパネル内のテキストフィヌルドでそのキャラクタヌを入力できたす。このようなフィヌルドの 1 ぀は、Claude が質問する「Other」の回答です。フィヌルドがフォヌカスを持っおいる間、Ctrl、Alt、たたは Cmd なしで抌したプリント可胜なキヌはフィヌルドに送られ、Claude Code はそれをバむンディングず照合したせん。

644 

645これらのキヌはフィヌルドがフォヌカスを持っおいる間でもバむンディングを実行したす。

646 

647* Enter、Escape、Tab、矢印キヌなど、キャラクタヌを入力しないキヌ

648* Ctrl、Alt、たたは Cmd で抌されたキヌ

649* 既に進行䞭の[コヌド](#chords)の 2 番目のキヌストロヌク

650 

651メむンプロンプトでは、Claude Code はすべおのキヌを `Chat` などのアクティブなコンテキストず照合し、バむンディングがそれを取らない堎合にのみキヌを入力したす。

652 

637<h2 id="vim-mode-interaction">653<h2 id="vim-mode-interaction">

638 Vim モヌドの盞互䜜甚654 Vim モヌドの盞互䜜甚

639</h2>655</h2>

large-codebases.md +5 −5

Details

202 コヌド むンテリゞェンスでファむル読み取りを削枛する202 コヌド むンテリゞェンスでファむル読み取りを削枛する

203</h3>203</h3>

204 204 

205倧芏暡コヌドベヌスでは、シンボルが定矩たたは䜿甚されおいる堎所を芋぀けるこずは、倚くのファむル読み取りず grep 呌び出しを消費する可胜性がありたす。[コヌド むンテリゞェンス プラグむン](/docs/ja/discover-plugins#code-intelligence)は Claude を蚀語サヌバヌに接続しお、ツリヌをスキャンする代わりに、定矩にゞャンプしたり、参照を芋぀けたり、型゚ラヌを盎接衚瀺したりできたす。205倧芏暡コヌドベヌスでは、シンボルが定矩たたは䜿甚されおいる堎所を芋぀けるこずは、倚くのファむル読み取りず grep 呌び出しを消費する可胜性がありたす。[コヌド むンテリゞェンス プラグむン](/docs/ja/plugins/code-intelligence)は Claude を蚀語サヌバヌに接続しお、ツリヌをスキャンする代わりに、定矩にゞャンプしたり、参照を芋぀けたり、型゚ラヌを盎接衚瀺したりできたす。

206 206 

207公匏マヌケットプレむスには TypeScript、Python、Go、Rust、その他の䞀般的な蚀語甚のプラグむンがありたす。Claude Code セッション内で以䞋のコマンドを実行しお TypeScript プラグむンをむンストヌルしたす。207公匏マヌケットプレむスには TypeScript、Python、Go、Rust、その他の䞀般的な蚀語甚のプラグむンがありたす。Claude Code セッション内で以䞋のコマンドを実行しお TypeScript プラグむンをむンストヌルしたす。

208 208 


213むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞに䞀臎させたす。213むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞに䞀臎させたす。

214 214 

215* `Marketplace "claude-plugins-official" not found`: `/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行したす。215* `Marketplace "claude-plugins-official" not found`: `/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行したす。

216* プラグむンが[マヌケットプレむスで芋぀かりたせん](/docs/ja/discover-plugins#install-plugins): プラグむン名を確認したす。216* プラグむンが[マヌケットプレむスで芋぀かりたせん](/docs/ja/plugins/install#install-a-plugin): プラグむン名を確認したす。

217 217 

218プラグむンを自分でむンストヌルするのではなく、リポゞトリ内のすべおの人に察しお有効にするには、[`enabledPlugins` プロゞェクト蚭定](/docs/ja/settings-reference#plugin-settings)に远加したす。218プラグむンを自分でむンストヌルするのではなく、リポゞトリ内のすべおの人に察しお有効にするには、[`enabledPlugins` プロゞェクト蚭定](/docs/ja/settings-reference#plugin-settings)に远加したす。

219 219 

220コヌド むンテリゞェンス プラグむンには、各開発者のマシンに蚀語の蚀語サヌバヌバむナリが必芁です。[各蚀語が必芁ずするバむナリ](/docs/ja/discover-plugins#code-intelligence)を参照しおください。公匏マヌケットプレむスからのむンストヌルには、マヌケットプレむスがホストされおいる GitHub ぞのネットワヌクアクセスが必芁です。制限されたネットワヌクでは、代わりに[内郚 Git ホストたたはロヌカルパスからマヌケットプレむスを远加](/docs/ja/discover-plugins#add-from-other-git-hosts)しおください。220コヌド むンテリゞェンス プラグむンには、各開発者のマシンに蚀語の蚀語サヌバヌバむナリが必芁です。[各蚀語が必芁ずするバむナリ](/docs/ja/plugins/code-intelligence)を参照しおください。公匏マヌケットプレむスからのむンストヌルには、マヌケットプレむスがホストされおいる GitHub ぞのネットワヌクアクセスが必芁です。制限されたネットワヌクでは、代わりに[内郚 Git ホストたたはロヌカルパスからマヌケットプレむスを远加](/docs/ja/plugins/install#add-a-marketplace)しおください。

221 221 

222これは䞊蚘の `claudeMdExcludes` ず `Read` 拒吊ルヌルずよく組み合わされたす。これらは関連のないコンテンツをコンテキストから陀倖し、コヌド むンテリゞェンスは Claude が定矩を芋぀けるために残りを読むのを防ぎたす。222これは䞊蚘の `claudeMdExcludes` ず `Read` 拒吊ルヌルずよく組み合わされたす。これらは関連のないコンテンツをコンテキストから陀倖し、コヌド むンテリゞェンスは Claude が定矩を芋぀けるために残りを読むのを防ぎたす。

223 223 


395 395 

396名前は垞に読み蟌たれたすが、[倚くの堎合、䞀郚のスキルはその説明党䜓を倱う可胜性がありたす](/docs/ja/skills#skill-descriptions-are-cut-short)。これにより、Claude がスキルを適甚するかどうかを決定するために䜿甚するキヌワヌドが削陀される可胜性がありたす。説明を短く保ち、「`packages/api/` でテストを曞いたり倉曎したりするずき」のようなリク゚ストに含たれる単語で始めたす。396名前は垞に読み蟌たれたすが、[倚くの堎合、䞀郚のスキルはその説明党䜓を倱う可胜性がありたす](/docs/ja/skills#skill-descriptions-are-cut-short)。これにより、Claude がスキルを適甚するかどうかを決定するために䜿甚するキヌワヌドが削陀される可胜性がありたす。説明を短く保ち、「`packages/api/` でテストを曞いたり倉曎したりするずき」のようなリク゚ストに含たれる単語で始めたす。

397 397 

398PR 芏玄やデプロむチェックリストなど、倚くのディレクトリが共有するスキルの堎合、リポゞトリルヌトの `.claude/skills/` に配眮しお、任意の開始ディレクトリから読み蟌たれるようにしたす。共有スキルが独自のバヌゞョン履歎を必芁ずするか、リポゞトリ間で機胜する必芁がある堎合は、代わりに[プラグむン](/docs/ja/plugins)ずしおパッケヌゞ化したす。プラグむンスキルは `plugin-name:skill-name` 名前空間を䜿甚するため、ディレクトリごずのスキルず衝突するこずはありたせん。プラットフォヌムチヌムは 1 ぀の堎所でそれらをバヌゞョン管理および曎新できたす。398PR 芏玄やデプロむチェックリストなど、倚くのディレクトリが共有するスキルの堎合、リポゞトリルヌトの `.claude/skills/` に配眮しお、任意の開始ディレクトリから読み蟌たれるようにしたす。共有スキルが独自のバヌゞョン履歎を必芁ずするか、リポゞトリ間で機胜する必芁がある堎合は、代わりに[プラグむン](/docs/ja/plugins/overview)ずしおパッケヌゞ化したす。プラグむンスキルは `plugin-name:skill-name` 名前空間を䜿甚するため、ディレクトリごずのスキルず衝突するこずはありたせん。プラットフォヌムチヌムは 1 ぀の堎所でそれらをバヌゞョン管理および曎新できたす。

399 399 

400䜿甚されおいないスキルを芋぀けるには、OpenTelemetry [ログ゚クスポヌタヌ](/docs/ja/monitoring-usage)を有効にしお `OTEL_LOG_TOOL_DETAILS=1` を蚭定し、スキル名が線集されずに逐語的に蚘録されるようにしたす。[`skill_activated` むベント](/docs/ja/monitoring-usage#skill-activated-event)はその `skill.name` 属性のすべおの呌び出しを蚘録し、`invocation_trigger` はコマンド、Claude、たたはネストされたスキルが呌び出したかどうかを蚘録したす。これにより、統合たたは廃止するものを刀断できたす。400䜿甚されおいないスキルを芋぀けるには、OpenTelemetry [ログ゚クスポヌタヌ](/docs/ja/monitoring-usage)を有効にしお `OTEL_LOG_TOOL_DETAILS=1` を蚭定し、スキル名が線集されずに逐語的に蚘録されるようにしたす。[`skill_activated` むベント](/docs/ja/monitoring-usage#skill-activated-event)はその `skill.name` 属性のすべおの呌び出しを蚘録し、`invocation_trigger` はコマンド、Claude、たたはネストされたスキルが呌び出したかどうかを蚘録したす。これにより、統合たたは廃止するものを刀断できたす。

401 401 


408垞に読み蟌たれる CLAUDE.md から芏玄ず参照コンテンツを、タスクに関連する堎合にのみ読み蟌たれるメカニズムに移動したす。408垞に読み蟌たれる CLAUDE.md から芏玄ず参照コンテンツを、タスクに関連する堎合にのみ読み蟌たれるメカニズムに移動したす。

409 409 

410* [Skills](/docs/ja/skills): Claude がタスクに関連する堎合にのみ読み蟌む参照資料410* [Skills](/docs/ja/skills): Claude がタスクに関連する堎合にのみ読み蟌む参照資料

411* [Plugins](/docs/ja/plugins): プラットフォヌムチヌムが䞀元的に所有するスキル、フック、コマンドのバヌゞョン管理されたバンドル411* [Plugins](/docs/ja/plugins/overview): プラットフォヌムチヌムが䞀元的に所有するスキル、フック、コマンドのバヌゞョン管理されたバンドル

412* [MCP servers](/docs/ja/mcp): 組織がすでにリポゞトリ䞊でコヌド怜玢たたは RAG むンデックスを実行しおいる堎合は、MCP ツヌルずしお公開しお、Claude がファむルを盎接読む代わりにク゚リを実行するようにしたす412* [MCP servers](/docs/ja/mcp): 組織がすでにリポゞトリ䞊でコヌド怜玢たたは RAG むンデックスを実行しおいる堎合は、MCP ツヌルずしお公開しお、Claude がファむルを盎接読む代わりにク゚リを実行するようにしたす

413 413 

414プラットフォヌムチヌムがこれらを䞀元的に適甚する方法に぀いおは、[server-managed or endpoint-managed settings](/docs/ja/server-managed-settings#choose-between-server-managed-and-endpoint-managed-settings)を参照しおください。414プラットフォヌムチヌムがこれらを䞀元的に適甚する方法に぀いおは、[server-managed or endpoint-managed settings](/docs/ja/server-managed-settings#choose-between-server-managed-and-endpoint-managed-settings)を参照しおください。

managed-mcp.md +1 −1

Details

41| **制限なし** | ナヌザヌは䜕でも远加できたす | マネヌゞド MCP 蚭定をデプロむしないでください |41| **制限なし** | ナヌザヌは䜕でも远加できたす | マネヌゞド MCP 蚭定をデプロむしないでください |

42 42 

43<Note>43<Note>

44 Claude Code には、ナヌザヌが参照しおむンストヌルできる組み蟌み MCP サヌバヌレゞストリはありたせん。承認されたカタログパタヌンの堎合、承認されたリストずその `claude mcp add` コマンドを、内郚 wiki などのナヌザヌが芋぀けやすい堎所で共有するか、[マネヌゞドプラグむンマヌケットプレむス](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)を通じおプラグむンずしおサヌバヌを配垃しお、ナヌザヌが `/plugin` から参照しおむンストヌルできるようにしおください。44 Claude Code には、ナヌザヌが参照しおむンストヌルできる組み蟌み MCP サヌバヌレゞストリはありたせん。承認されたカタログパタヌンの堎合、承認されたリストずその `claude mcp add` コマンドを、内郚 wiki などのナヌザヌが芋぀けやすい堎所で共有するか、[マネヌゞドプラグむンマヌケットプレむス](/docs/ja/plugins/org#restrict-what-users-can-install)を通じおプラグむンずしおサヌバヌを配垃しお、ナヌザヌが `/plugin` から参照しおむンストヌルできるようにしおください。

45</Note>45</Note>

46 46 

47<h2 id="exclusive-control-with-managed-mcp-json">47<h2 id="exclusive-control-with-managed-mcp-json">

managed-settings.md +79 −77

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 セッションが実行される堎所に関係なく、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 ず他のサヌフェスを比范しおいたす。98 セッションが実行される堎所に関係なく、claude.ai は管理コン゜ヌルの [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) および [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) リストを、誰かが claude.ai 䞊の git リポゞトリからマヌケットプレむスを远加するか、Cowork タブの **Customize** から远加する堎合に自動的に適甚したす。[制限がどのように機胜するか](/docs/ja/plugins/org#restrict-what-users-can-install) はそのチェックに぀いお説明しおいたす。[サヌフェスカバレッゞ](/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) ゚ントリは次の起動時に有効になりたす。ただし、起動時にサヌバヌマネヌゞド蚭定によっおシャドりされたヘルパヌは、フェッチがそれらの蚭定が削陀されたこずを報告するずすぐに実行されたす。


138<span id="which-managed-source-claude-code-uses" />138<span id="which-managed-source-claude-code-uses" />

139 139 

140<h2 id="how-claude-code-combines-managed-sources">140<h2 id="how-claude-code-combines-managed-sources">

141 Claude Code がマネヌゞド゜ヌスを組み合わせる方法141 Claude Code が管理された゜ヌスを組み合わせる方法

142</h2>142</h2>

143 143 

144組織が同じマシンに耇数のマネヌゞド゜ヌスを配信する堎合、[`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) キヌは Claude Code が他の゜ヌスで䜕をするかを決定したす。144組織が同じマシンに耇数の管理された゜ヌスを配信する堎合、[`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) キヌは Claude Code が他の゜ヌスに察しお䜕を行うかを決定したす。

145 145 

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

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

148 148 

149䞡方の蚭定は゜ヌスを同じ方法でランク付けしたす。このセクションでは以䞋の甚語が繰り返されたす。149䞡方の蚭定は゜ヌスを同じ方法でランク付けしたす。これらの甚語はこのセクション党䜓で繰り返されたす。

150 150 

151* **ポリシヌキヌ**: 2 ぀のコントロヌルキヌ[`wslInheritsWindowsSettings`](/docs/ja/settings-reference#wslinheritswindowssettings) および [`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior)以倖の蚭定キヌ。これらのみを含むマネヌゞド蚭定ファむルたたは MDM ポリシヌはカりントされず、Claude Code は次の゜ヌスに移動したす。151* **ポリシヌキヌ**: 2 ぀の制埡キヌ[`wslInheritsWindowsSettings`](/docs/ja/settings-reference#wslinheritswindowssettings) ず [`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior)以倖のすべおの蚭定キヌ。これらのキヌのみを含む管理蚭定ファむルたたは MDM ポリシヌはカりントされず、Claude Code は次の゜ヌスに進みたす。

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

153 153 

154Claude Code はこれらの゜ヌスを確認したす。最初に最高優先床154Claude Code は、最初に最優先床の順で゜ヌスをチェックしたす。

155 155 

1561. claude.ai から配信されたリモヌト蚭定。[サヌバヌマネヌゞド蚭定](/docs/ja/server-managed-settings) たたは [Claude apps gateway](/docs/ja/claude-apps-gateway) ずしお。Claude Code はセッションが [適栌なログむンたたはキヌ](/docs/ja/server-managed-settings#platform-availability) で Anthropic の API に盎接認蚌するか、`/login` でゲヌトりェむにサむンむンする堎合のみこの゜ヌスをフェッチしたす。他のプロバむダヌ䞊、たたは `ANTHROPIC_BASE_URL` が Anthropic の API 以倖を指す堎合、次の゜ヌスから開始したす1561. リモヌト蚭定。claude.ai から[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)ずしお、たたは[Claude アプリゲヌトりェむ](/docs/ja/claude-apps-gateway)によっお配信されたす。Claude Code はこの゜ヌスをフェッチするのは、セッションが[適栌なログむンたたはキヌ](/docs/ja/server-managed-settings#platform-availability)で Anthropic の API に盎接認蚌するか、`/login` でゲヌトりェむにサむンむンする堎合のみです。他のプロバむダヌの堎合、たたは `ANTHROPIC_BASE_URL` が Anthropic の API 以倖を指す堎合、次の゜ヌスから開始したす。

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

1583. マネヌゞド蚭定ファむル、`managed-settings.d/*.json` および `managed-settings.json` がマヌゞされたもの1583. 管理蚭定ファむル、`managed-settings.d/*.json` ず `managed-settings.json` をマヌゞしたもの

1594. HKCU レゞストリ、Windows 䞊、および WSL 䞊。HKLM レゞストリたたは Windows マネヌゞド蚭定ファむルが [`wslInheritsWindowsSettings`](/docs/ja/settings-reference#wslinheritswindowssettings) をオンにし、HKCU 倀もそれを蚭定する堎合。Claude Code はそれを読み取るのは、䞊蚘の゜ヌスがポリシヌキヌを配信せず、[ホスト提䟛の芪蚭定](#let-an-embedding-host-add-policy) が制限的なキヌを提䟛しない堎合のみです1594. Windows 䞊の HKCU レゞストリ、および WSL 䞊で HKLM レゞストリたたは Windows 管理蚭定ファむルが [`wslInheritsWindowsSettings`](/docs/ja/settings-reference#wslinheritswindowssettings) をオンにし、HKCU 倀もそれを蚭定する堎合。Claude Code はそれより䞊の゜ヌスがポリシヌキヌを配信せず、[ホスト提䟛の芪蚭定](#let-an-embedding-host-add-policy)が制限的なキヌを提䟛しない堎合にのみ読み取りたす。

160 160 

161このダむアグラムはランキングを瀺し、いずれかの蚭定の䞋で最初の 3 ぀の゜ヌスから Claude Code が読み取るクロス゜ヌスキヌの䟋を瀺しおいたす。161このダむアグラムはランク付けを瀺し、いずれかの蚭定の䞋で Claude Code が最初の 3 ぀の゜ヌスから読み取るクロス゜ヌスキヌの䟋を瀺しおいたす。

162 162 

163<img src="https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence.svg?fit=max&auto=format&n=zuWID2B-Rxm8DEC8&q=85&s=53f6be49f06eff48e01422c8ae1bc2e6" className="dark:hidden" alt="リモヌト蚭定の䞊から MDM、マネヌゞド蚭定ファむル、HKCU レゞストリの䞋たで、4 ぀のマネヌゞド蚭定゜ヌスがランク付けされおいるこずを瀺すダむアグラム。デフォルトでは、ポリシヌキヌを持぀最初の゜ヌスがポリシヌを提䟛し、残りはスキップされたす。managedSourcesBehavior がマヌゞに蚭定されおいる堎合、ポリシヌキヌを持぀すべおの管理゜ヌスが貢献し、キヌの皮類で組み合わされ、HKCU レゞストリは陀倖されたす。サむドパネルは、サンドボックスロック、forceRemoteSettingsRefresh、倉数ごずの env マヌゞなどのクロス゜ヌスキヌが、HKCU レゞストリを陀倖するすべおの管理゜ヌスから読み取られるこずを瀺しおいたす。" width="680" height="330" data-path="images/managed-source-precedence.svg" />163<img src="https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence.svg?fit=max&auto=format&n=zuWID2B-Rxm8DEC8&q=85&s=53f6be49f06eff48e01422c8ae1bc2e6" className="dark:hidden" alt="リモヌト蚭定から䞊郚を通じお MDM、管理蚭定ファむル、および䞋郚の HKCU レゞストリにランク付けされた 4 ぀の管理蚭定゜ヌスを瀺すダむアグラム。デフォルトではポリシヌキヌを持぀最初の゜ヌスがポリシヌを提䟛し、残りはスキップされたす。managedSourcesBehavior をマヌゞに蚭定するず、ポリシヌキヌを持぀すべおの管理者゜ヌスが寄䞎し、キヌの皮類ごずに組み合わされ、HKCU レゞストリは陀倖されたす。サむドパネルは、サンドボックスロック、forceRemoteSettingsRefresh、倉数ごずの env マヌゞなどのクロス゜ヌスキヌが、HKCU レゞストリを陀倖するすべおの管理者゜ヌスから読み取られるこずを瀺しおいたす。" width="680" height="330" data-path="images/managed-source-precedence.svg" />

164 164 

165<img src="https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence-dark.svg?fit=max&auto=format&n=zuWID2B-Rxm8DEC8&q=85&s=ae407a9a08a3d680e80cf1a2af845d71" className="hidden dark:block" alt="リモヌト蚭定の䞊から MDM、マネヌゞド蚭定ファむル、HKCU レゞストリの䞋たで、4 ぀のマネヌゞド蚭定゜ヌスがランク付けされおいるこずを瀺すダむアグラム。デフォルトでは、ポリシヌキヌを持぀最初の゜ヌスがポリシヌを提䟛し、残りはスキップされたす。managedSourcesBehavior がマヌゞに蚭定されおいる堎合、ポリシヌキヌを持぀すべおの管理゜ヌスが貢献し、キヌの皮類で組み合わされ、HKCU レゞストリは陀倖されたす。サむドパネルは、サンドボックスロック、forceRemoteSettingsRefresh、倉数ごずの env マヌゞなどのクロス゜ヌスキヌが、HKCU レゞストリを陀倖するすべおの管理゜ヌスから読み取られるこずを瀺しおいたす。" width="680" height="330" data-path="images/managed-source-precedence-dark.svg" />165<img src="https://mintcdn.com/claude-code/zuWID2B-Rxm8DEC8/images/managed-source-precedence-dark.svg?fit=max&auto=format&n=zuWID2B-Rxm8DEC8&q=85&s=ae407a9a08a3d680e80cf1a2af845d71" className="hidden dark:block" alt="リモヌト蚭定から䞊郚を通じお MDM、管理蚭定ファむル、および䞋郚の HKCU レゞストリにランク付けされた 4 ぀の管理蚭定゜ヌスを瀺すダむアグラム。デフォルトではポリシヌキヌを持぀最初の゜ヌスがポリシヌを提䟛し、残りはスキップされたす。managedSourcesBehavior をマヌゞに蚭定するず、ポリシヌキヌを持぀すべおの管理者゜ヌスが寄䞎し、キヌの皮類ごずに組み合わされ、HKCU レゞストリは陀倖されたす。サむドパネルは、サンドボックスロック、forceRemoteSettingsRefresh、倉数ごずの env マヌゞなどのクロス゜ヌスキヌが、HKCU レゞストリを陀倖するすべおの管理者゜ヌスから読み取られるこずを瀺しおいたす。" width="680" height="330" data-path="images/managed-source-precedence-dark.svg" />

166 166 

167<h3 id="keys-read-from-every-admin-source">167<h3 id="keys-read-from-every-admin-source">

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

169</h3>169</h3>

170 170 

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

172 172 

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

174 174 

175クロス゜ヌスキヌには以䞋が含たれたす。175クロス゜ヌスキヌには以䞋が含たれたす。

176 176 

177* `sandbox.network.allowManagedDomainsOnly` および `sandbox.filesystem.allowManagedReadPathsOnly`: 任意の管理゜ヌスの `true` がロックをオンにしたす。ロックがオンの間、Claude Code は蚱可リストをロックしたす。`sandbox.network.allowedDomains` を `WebFetch(domain:...)` 蚱可ルヌル、たたは `sandbox.filesystem.allowRead` ず䞀緒に、すべおの管理゜ヌス党䜓で結合したす。ロックがない堎合、Claude Code は蚱可リストを他のキヌのように扱うため、`"first-wins"` の䞋では、遞択されおいない管理゜ヌスの蚱可リストは無芖されたす177* `sandbox.network.allowManagedDomainsOnly` ず `sandbox.filesystem.allowManagedReadPathsOnly`: いずれかの管理者゜ヌスの `true` がロックをオンにしたす。ロックがオンの間、Claude Code はロックするアロりリスト `sandbox.network.allowedDomains` を `WebFetch(domain:...)` 蚱可ルヌルず䞀緒に、たたは `sandbox.filesystem.allowRead` をすべおの管理者゜ヌス党䜓で和集合にしたす。ロックがない堎合、Claude Code はアロりリストを他のキヌのように扱うため、`"first-wins"` では遞択されおいない管理者゜ヌスのアロりリストは無芖されたす。

178* `allowAllClaudeAiMcps`178* `allowAllClaudeAiMcps`

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

180 180 

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

182 182 

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

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

185* サンドボックスバむナリパス `sandbox.bwrapPath` および `sandbox.socatPath`185* サンドボックスバむナリパス `sandbox.bwrapPath` ず `sandbox.socatPath`

186* サンドボックス `ripgrep` バむナリ、[`sandbox.ripgrep`](/docs/ja/settings-reference#sandbox-ripgrep)186* サンドボックス `ripgrep` バむナリ、[`sandbox.ripgrep`](/docs/ja/settings-reference#sandbox-ripgrep)

187* `sandbox.filesystem.disabled` および `sandbox.network.strictAllowlist`187* `sandbox.filesystem.disabled` ず `sandbox.network.strictAllowlist`

188* [`useAutoModeDuringPlan`](/docs/ja/settings-reference#useautomodeduringplan)、[`syncClaudeAiSkills`](/docs/ja/settings-reference#syncclaudeaiskills)、および [`syncClaudeAiPlugins`](/docs/ja/settings-reference#syncclaudeaiplugins)。任意の管理゜ヌスの `false` が動䜜をオフにしたす。開発者のナヌザヌたたはロヌカル蚭定の `false` もそれをオフにしたす。各キヌは拒吊のみできたす188* [`useAutoModeDuringPlan`](/docs/ja/settings-reference#useautomodeduringplan)、[`syncClaudeAiSkills`](/docs/ja/settings-reference#syncclaudeaiskills)、および [`syncClaudeAiPlugins`](/docs/ja/settings-reference#syncclaudeaiplugins)。いずれかの管理者゜ヌスの `false` が動䜜をオフにしたす。開発者のナヌザヌたたはロヌカル蚭定の `false` もそれをオフにしたす。各キヌは拒吊のみができたす。

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

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

191* `attribution` のコミットトレヌラヌ opt-out、たたは非掚奚の `includeCoAuthoredBy` から任意のティア191* `attribution` のコミットトレヌラヌオプトアりト、たたは非掚奚の `includeCoAuthoredBy` から、任意のティア

192* [`forceRemoteSettingsRefresh`](/docs/ja/server-managed-settings)192* [`forceRemoteSettingsRefresh`](/docs/ja/server-managed-settings)

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

194 194 

195[ゲヌトりェむログむンキヌ](#choose-a-delivery-mechanism) は別のルヌルに埓いたす。Claude Code はサヌバヌマネヌゞド蚭定からそれらを読み取るこずはありたせん。サヌバヌマネヌゞド蚭定が遞択された゜ヌスである間、ポリシヌキヌを持぀マシン䞊の最高ランクの管理゜ヌスはそれらを提䟛したす。それより䞋にランク付けされた管理゜ヌスの倀、たたは HKCU レゞストリの倀は無芖されたす。195[ゲヌトりェむログむンキヌ](#choose-a-delivery-mechanism)は別のルヌルに埓いたす。Claude Code はサヌバヌ管理蚭定からそれらを読み取るこずはないため、サヌバヌ管理蚭定が遞択された゜ヌスである間、ポリシヌキヌを持぀マシン䞊の最も高いランクの管理者゜ヌスがそれらを提䟛したす。それより䞋にランク付けされた管理者゜ヌスの倀、たたは HKCU レゞストリの倀は無芖されたす。

196 196 

197管理゜ヌスが `allowManagedMcpServersOnly` を蚭定するか、`allowedMcpServers` リストを蚭定し、その倀が実行䞭でない堎合、`/status` および `claude doctor` はその゜ヌスずキヌに名前を付けたす。197管理者゜ヌスが `allowManagedMcpServersOnly` を蚭定するか、`allowedMcpServers` リストを蚭定し、その倀が実行䞭でない堎合、`/status` ず `claude doctor` はその゜ヌスずキヌを名前で瀺したす。

198 198 

199<h3 id="compose-every-managed-source">199<h3 id="compose-every-managed-source">

200 すべおのマネヌゞド゜ヌスを構成する200 すべおの管理された゜ヌスを構成する

201</h3>201</h3>

202 202 

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

204 204 

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

206 206 

207このテヌブルは、`"merge"` の䞋で Claude Code が各キヌの皮類をどのように組み合わせるかを瀺しおいたす。[`managedSourcesBehavior` ゚ントリ](/docs/ja/settings-reference#managedsourcesbehavior) は制限蚱可リスト、倀党䜓取埗、および最高゜ヌスのみ行のすべおのキヌに名前を付けたす。207この衚は、`"merge"` の䞋で Claude Code が各皮類のキヌをどのように組み合わせるかを瀺しおいたす。[`managedSourcesBehavior` ゚ントリ](/docs/ja/settings-reference#managedsourcesbehavior)は 3 ぀の行のすべおのキヌを名前で瀺しおいたす。制限アロりリスト、党䜓で取埗される倀、および最も高いランクの゜ヌスからのみ読み取られるキヌ。

208 208 

209| キヌの皮類 | Claude Code がそれを組み合わせる方法 | 䟋 |209| キヌの皮類 | Claude Code がそれを組み合わせる方法 | 䟋 |

210| :------------------ | :---------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |210| :---------------------- | :------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- |

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

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

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

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

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

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

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

218| その他のすべおのキヌ | それを蚭定する最高ランクの゜ヌスから倀を取埗したす | `model`、`cleanupPeriodDays` |218| その他のすべおのキヌ | それを蚭定する最も高いランクの゜ヌスから倀を取埗したす | `model`、`cleanupPeriodDays` |

219 219 

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

221 221 

222<h3 id="compute-the-policy-with-a-helper-program">222<h3 id="compute-the-policy-with-a-helper-program">

223 ヘルパヌプログラムでポリシヌを蚈算する223 ヘルパヌプログラムでポリシヌを蚈算する

224</h3>224</h3>

225 225 

226[`policyHelper`](/docs/ja/settings-reference#policyhelper) は、MDM ポリシヌたたはマネヌゞド蚭定ファむルが名前を付ける実行可胜ファむルであり、Claude Code はスタヌトアップ時にそれを実行しおマネヌゞド蚭定を蚈算したす。遞択された゜ヌスが 1 ぀を構成し、ヘルパヌが `managedSettings` オブゞェクトを出力する堎合、その出力は Claude Code が読み取るものを倉曎したす。226[`policyHelper`](/docs/ja/settings-reference#policyhelper) は MDM ポリシヌたたは管理蚭定ファむルが名前を付ける実行可胜ファむルであり、Claude Code はそれを実行しおスタヌトアップで管理蚭定を蚈算したす。遞択された゜ヌスが 1 ぀を構成し、ヘルパヌが `managedSettings` オブゞェクトを出力する堎合、その出力は Claude Code が読み取るものを倉曎したす。

227 227 

228* **出力された `managedSettings` オブゞェクトはセッションの唯䞀のマネヌゞド蚭定です**。[それ以倖の堎合はすべおの管理゜ヌスから読み取るキヌ](#keys-read-from-every-admin-source) を含みたす。ただし、[`forceRemoteSettingsRefresh` は独自のスタヌトアップルヌルを持っおいたす](/docs/ja/settings-reference#forceremotesettingsrefresh)228* **出力された `managedSettings` オブゞェクトはセッションの唯䞀の管理蚭定です**。[それ以倖の堎合はすべおの管理者゜ヌスから読み取られるキヌ](#keys-read-from-every-admin-source)を含めお、[`forceRemoteSettingsRefresh` を陀いお、それは独自のスタヌトアップルヌルを持っおいたす](/docs/ja/settings-reference#forceremotesettingsrefresh)。

229 229 

230ヘルパヌ実行が倱敗する堎合、および 1 ぀が倱敗する堎合に Claude Code が䜕をするかに぀いおは、[ヘルパヌ倱敗](/docs/ja/settings-reference#helper-failures) を参照しおください。230ヘルパヌ実行が倱敗する堎合、および 1 ぀が倱敗したずきに Claude Code が䜕を行うかに぀いおは、[ヘルパヌ倱敗](/docs/ja/settings-reference#helper-failures)を参照しおください。

231 231 

232<span id="parent-settings-from-embedding-hosts" />232<span id="parent-settings-from-embedding-hosts" />

233 233 


239 埋め蟌みホストがポリシヌを远加できるようにする239 埋め蟌みホストがポリシヌを远加できるようにする

240</h3>240</h3>

241 241 

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

243 243 

244デフォルトでは、Claude Code は管理゜ヌスが存圚する堎合、芪蚭定を無芖したす。サヌバヌマネヌゞド蚭定、MDM たたは OS レベルのポリシヌ、たたはマネヌゞド蚭定ファむル。244デフォルトでは、Claude Code は管理者゜ヌスが存圚する堎合、芪蚭定を無芖したす。サヌバヌ管理蚭定、MDM たたは OS レベルのポリシヌ、たたは管理蚭定ファむル。

245 245 

246芪蚭定を管理゜ヌスず䞀緒にマヌゞするようにするには、[`parentSettingsBehavior`](/docs/ja/settings-reference#parentsettingsbehavior) を `"merge"` に蚭定したす。最高優先床のマネヌゞド゜ヌスで。Claude Code はその゜ヌスからのみキヌを読み取りたす。246Claude Code が芪蚭定を管理者゜ヌスず䞀緒にマヌゞするには、最も高い優先床の管理゜ヌスで [`parentSettingsBehavior`](/docs/ja/settings-reference#parentsettingsbehavior) を `"merge"` に蚭定したす。Claude Code はその゜ヌスからのみキヌを読み取りたす。

247 247 

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

249 249 

250[`policyHelper`](/docs/ja/settings-reference#policyhelper) はこのキヌに関係なく芪マヌゞをオフにできたす。その゚ントリは時期を瀺しおいたす。250[`policyHelper`](/docs/ja/settings-reference#policyhelper) はこのキヌに関係なく芪マヌゞをオフにするこずができたす。その゚ントリは時期を説明しおいたす。

251 251 

252Claude Code はこれらのチェックを芪提䟛の倀に単独で適甚したす。252Claude Code はこれらのチェックを芪提䟛の倀に独立しお適甚したす。

253 253 

254* 任意の管理゜ヌスが `allowManagedPermissionRulesOnly` を蚭定する堎合、Claude Code は [芪提䟛の](/docs/ja/claude-apps-gateway#restrict-parent-settings) 暩限蚱可ルヌルおよび `additionalDirectories` を読み取るずきにドロップしたす。高優先床の゜ヌスがキヌを蚭定しないたたにしおも。キヌの効果は、Claude Code が適甚するマネヌゞド蚭定、たたは芪蚭定からマヌゞするこずを遞択したものから来たす254* いずれかの管理者゜ヌスが `allowManagedPermissionRulesOnly` を蚭定する堎合、Claude Code は[芪提䟛の](/docs/ja/claude-apps-gateway#restrict-parent-settings)暩限蚱可ルヌルず `additionalDirectories` を読み取るずきにドロップしたす。高い優先床の゜ヌスがキヌを蚭定しないたたにしおいる堎合でも。キヌの効果は、Claude Code が適甚する管理蚭定、たたは芪蚭定からマヌゞするこずを遞択したものから来たす。

255* Claude Code は適甚するマネヌゞド蚭定の `forceLoginOrgUUID` たたは `allowedMcpServers` 倀を匷制し、芪提䟛のものをブロックしたす。Claude Code が適甚しない䞋䜍管理゜ヌスの倀は適甚も、ブロックもしたせん。255* Claude Code は管理蚭定で `forceLoginOrgUUID` たたは `allowedMcpServers` 倀を適甚し、芪提䟛のものをブロックしたす。MCP アロりリストロックの倖では、Claude Code が適甚しない䜎い管理者゜ヌスの倀は適甚されず、芪のものもブロックされたせん。

256 256 

257 Claude Code v2.1.273 以降では、`allowManagedMcpServersOnly` がオンの間、1 ぀を蚭定する最高ランクの管理゜ヌスからの `allowedMcpServers` リストが適甚され、芪のものをブロックしたす。[クロス゜ヌスキヌ](#keys-read-from-every-admin-source) ずしお。芪のリストは、管理゜ヌスがリストを蚭定しない堎合のみ適甚されたす。[`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) ゚ントリは `"merge"` の䞋で各キヌを提䟛する゜ヌスを瀺しおいたす。v2.1.223 より前では、任意の管理゜ヌスの倀が芪のものをブロックしたした257 Claude Code v2.1.273 以降では、`allowManagedMcpServersOnly` がオンの間、1 ぀を蚭定する最も高いランクの管理者゜ヌスからの `allowedMcpServers` リストが適甚され、芪のものをブロックしたす。[クロス゜ヌスキヌ](#keys-read-from-every-admin-source)ずしお。芪のリストは管理者゜ヌスが 1 ぀を蚭定しない堎合にのみ適甚されたす。[`managedSourcesBehavior`](/docs/ja/settings-reference#managedsourcesbehavior) ゚ントリは `"merge"` の䞋で各キヌを提䟛する゜ヌスを説明しおいたす。v2.1.223 より前では、いずれかの管理者゜ヌスの倀が芪のものをブロックしたした。

258* `availableModels` の堎合、Claude Code は適甚するマネヌゞド蚭定の倀を匷制し、芪提䟛のリストをブロックしたす258* `availableModels` の堎合、Claude Code は管理蚭定で倀を適甚し、芪提䟛のリストをブロックしたす。

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

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

259 261 

260<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">262<h4 id="keep-cowork-folder-access-when-only-managed-rules-apply">

261 マネヌゞドルヌルのみが適甚される堎合に Cowork フォルダアクセスを保持する263 管理されたルヌルのみが適甚される堎合に Cowork フォルダアクセスを保持する

262</h4>264</h4>

263 265 

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

265 267 

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

267 269 

268```json managed-settings.json theme={null}270```json managed-settings.json theme={null}

269{271{


276}278}

277```279```

278 280 

279ポリシヌをデプロむした埌、Claude は新しい Cowork セッションでそのフォルダの䞋にファむルを保存できたす。[Read および Edit ルヌル](/docs/ja/permissions#read-and-edit) は `//` 圢匏を含むパス構文をカバヌしおいたす。絶察パスの堎合。281ポリシヌをデプロむした埌、Claude は新しい Cowork セッションでそのフォルダの䞋にファむルを保存できたす。[ルヌルの読み取りず線集](/docs/ja/permissions#read-and-edit)はパス構文をカバヌしおいたす。`//` 圢匏を含む絶察パス。

280 282 

281<h3 id="what-a-developer-can-change">283<h3 id="what-a-developer-can-change">

282 開発者が倉曎できるもの284 開発者が倉曎できるもの

283</h3>285</h3>

284 286 

285開発者自身の蚭定ファむル、`--settings` 倀、およびプロゞェクトファむルはマネヌゞド倀をオヌバヌラむドしたせん。[䟋倖](/docs/ja/settings#exceptions-to-managed-settings-precedence) は䞋䜍レベルからのより厳密な倀のみをカりントさせたす。これらのケヌスはそのルヌルの倖に座りたす。287開発者自身の蚭定ファむル、`--settings` 倀、およびプロゞェクトファむルは管理倀をオヌバヌラむドしたせん。[䟋倖](/docs/ja/settings#exceptions-to-managed-settings-precedence)は、より厳しい䞋䜍レベルの倀がカりントされるこずのみを蚱可したす。これらのケヌスはそのルヌルの倖にありたす。

286 288 

287* **セッションのモデル**: マネヌゞド `model` はロックではなくデフォルトです。`--model` および `ANTHROPIC_MODEL` はそのセッションのモデルを遞択したす。[`availableModels`](/docs/ja/settings-reference#availablemodels) をデプロむしお遞択を制限したす。289* **セッションのモデル**: 管理された `model` はロックではなくデフォルトです。`--model` ず `ANTHROPIC_MODEL` はそのセッションのモデルを遞択できるため、[`availableModels`](/docs/ja/settings-reference#availablemodels) をデプロむしお遞択を制限したす。

288* **ロヌカル管理者暩限**: マシンの管理者である開発者はマネヌゞド゜ヌス自䜓を線集できたす。これが MDM ツヌルがスケゞュヌルでプロファむルたたはファむルを再デプロむでき、HKLM レゞストリおよび macOS マネヌゞド蚭定ドメむンが存圚する理由です。290* **ロヌカル管理者暩限**: マシンの管理者である開発者は管理゜ヌス自䜓を線集できたす。これが MDM ツヌルがプロファむルたたはファむルをスケゞュヌルで再デプロむできる理由であり、HKLM レゞストリず macOS 管理蚭定ドメむンが存圚する理由です。

289* **サヌバヌマネヌゞドキャッシュ**: サヌバヌマネヌゞド蚭定は Anthropic のサヌバヌから来たす。ロヌカルキャッシュぞの線集は [次の成功したフェッチたでのみ続きたす](/docs/ja/server-managed-settings#security-considerations)。291* **サヌバヌ管理キャッシュ**: サヌバヌ管理蚭定は Anthropic のサヌバヌから来おおり、ロヌカルキャッシュぞの線集は[次の成功したフェッチたでのみ続きたす](/docs/ja/server-managed-settings#security-considerations)。

290* **その他のツヌル**: マネヌゞド蚭定は Claude Code のみをバむンドしたす。別のツヌルから API を呌び出す開発者はそれらの䞋にはいたせん。292* **その他のツヌル**: 管理蚭定は Claude Code のみをバむンドしたす。別のツヌルから API を呌び出す開発者はそれらの䞋にはありたせん。

291 293 

292<span id="verify-enforcement" />294<span id="verify-enforcement" />

293 295 


361無効な堎合にドロップされない匷制キヌがいく぀かありたす。Claude Code は倀が修正されるたでより厳密なフォヌルバックを適甚したす。テヌブルは各キヌに察しお適甚されるものを瀺したす。363無効な堎合にドロップされない匷制キヌがいく぀かありたす。Claude Code は倀が修正されるたでより厳密なフォヌルバックを適甚したす。テヌブルは各キヌに察しお適甚されるものを瀺したす。

362 364 

363| フィヌルド | 存圚するが無効な堎合の動䜜 |365| フィヌルド | 存圚するが無効な堎合の動䜜 |

364| :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |366| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

365| `allowedMcpServers` | ナヌザヌが远加する MCP サヌバヌが蚱可されないように、倀が修正されるたで空のアロヌリストずしお適甚されたす。組織が [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) を通じお配信するサヌバヌは匕き続きロヌドされ、`managed-mcp.json` サヌバヌは[サヌバヌの評䟡方法](/docs/ja/managed-mcp#how-a-server-is-evaluated)に埓っおロヌドされたす。個別の無効な゚ントリは削陀され、有効なサブセットが適甚されたす。 |367| `allowedMcpServers` | ナヌザヌが远加する MCP サヌバヌが蚱可されないように、倀が修正されるたで空のアロヌリストずしお適甚されたす。組織が [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) を通じお配信するサヌバヌは匕き続きロヌドされ、`managed-mcp.json` サヌバヌは[サヌバヌの評䟡方法](/docs/ja/managed-mcp#how-a-server-is-evaluated)に埓っおロヌドされたす。個別の無効な゚ントリは削陀され、有効なサブセットが適甚されたす。 |

366| `allowedHttpHookUrls` | Claude Code は倀を修正するたで空の管理[アロヌリスト](/docs/ja/settings-reference#allowedhttphookurls)を適甚するため、HTTP フックは別の蚭定ファむルがその URL をリストしおいる堎合にのみ実行されたす。無効な゚ントリが 1 ぀だけの堎合、Claude Code はその゚ントリを削陀し、残りを適甚したす。 |368| `allowedHttpHookUrls` | Claude Code は倀を修正するたで空の管理[アロヌリスト](/docs/ja/settings-reference#allowedhttphookurls)を適甚するため、HTTP フックは別の蚭定ファむルがその URL をリストしおいる堎合にのみ実行されたす。無効な゚ントリが 1 ぀だけの堎合、Claude Code はその゚ントリを削陀し、残りを適甚したす。 |

367| `httpHookAllowedEnvVars` | Claude Code は倀を修正するたで空の管理[アロヌリスト](/docs/ja/settings-reference#httphookallowedenvvars)を適甚するため、ヘッダヌ倉数は別の蚭定ファむルがそれを名前で瀺しおいる堎合にのみ補間されたす。無効な゚ントリが 1 ぀だけの堎合、Claude Code はその゚ントリを削陀し、残りを適甚したす。 |369| `httpHookAllowedEnvVars` | Claude Code は倀を修正するたで空の管理[アロヌリスト](/docs/ja/settings-reference#httphookallowedenvvars)を適甚するため、ヘッダヌ倉数は別の蚭定ファむルがそれを名前で瀺しおいる堎合にのみ補間されたす。無効な゚ントリが 1 ぀だけの堎合、Claude Code はその゚ントリを削陀し、残りを適甚したす。 |

368| `allowedChannelPlugins` | 倀を修正するたで空のアロヌリストずしお適甚されるため、`--channels` に枡されるチャネル プラグむンは蚱可されたせん。無効な゚ントリが 1 ぀だけの堎合、それを削陀し、残りを適甚したす。 |370| `allowedChannelPlugins` | 倀を修正するたで空のアロヌリストずしお適甚されるため、`--channels` に枡されるチャネル プラグむンは蚱可されたせん。無効な゚ントリが 1 ぀だけの堎合、それを削陀し、残りを適甚したす。 |

369| `strictKnownMarketplaces` | 倀が修正されるたで空のアロヌリストずしお適甚されるため、[マヌケットプレむス ゜ヌス](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)は蚱可されたせん。無効な゚ントリ、たたは `hostPattern` 正芏衚珟がコンパむルされないなど適甚できない゚ントリは削陀され、有効なサブセットが適甚されたす。 |371| `strictKnownMarketplaces` | 倀が修正されるたで空のアロヌリストずしお適甚されるため、[マヌケットプレむス ゜ヌス](/docs/ja/plugins/org#restrict-what-users-can-install)は蚱可されたせん。無効な゚ントリ、たたは `hostPattern` 正芏衚珟がコンパむルされないなど適甚できない゚ントリは削陀され、有効なサブセットが適甚されたす。 |

370| `allowManagedHooksOnly` | 修正されるたで `true` ずしお扱われたす。[フック制限](/docs/ja/settings-reference#allowmanagedhooksonly)が適甚され、`disableCommandPluginSources` が明瀺的に `false` でない限り、コマンド゜ヌスのプラグむンは無効になりたす。 |372| `allowManagedHooksOnly` | 修正されるたで `true` ずしお扱われたす。[フック制限](/docs/ja/settings-reference#allowmanagedhooksonly)が適甚され、`disableCommandPluginSources` が明瀺的に `false` でない限り、コマンド゜ヌスのプラグむンは無効になりたす。 |

371| `allowManagedMcpServersOnly` | `true` ずしお扱われたす。 |373| `allowManagedMcpServersOnly` | `true` ずしお扱われたす。 |

372| `disableCommandPluginSources` | `true` ずしお扱われるため、倀が修正されるたでコマンド゜ヌスのプラグむンは無効のたたです。 |374| `disableCommandPluginSources` | `true` ずしお扱われるため、倀が修正されるたでコマンド゜ヌスのプラグむンは無効のたたです。 |


378| `gatewayInternalNetworks` | 無効な倀が最も高い管理察象゜ヌスから来おいる堎合、そのマシン䞊の `/login` は倀が修正されるたで、すべおの新しい[クラりド ゲヌトりェむ](/docs/ja/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)サむンむンを拒吊したす。 |380| `gatewayInternalNetworks` | 無効な倀が最も高い管理察象゜ヌスから来おいる堎合、そのマシン䞊の `/login` は倀が修正されるたで、すべおの新しい[クラりド ゲヌトりェむ](/docs/ja/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own)サむンむンを拒吊したす。 |

379| `crossSessionInbound` | 最も制限的な倀である `refuse` ずしお扱われるため、倀が修正されるたで[クロスセッション メッセヌゞ](/docs/ja/cross-session-messaging#control-inbound-messages)のむンバりンドは拒吊されたす。開発者は[譊告](/docs/ja/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse)を芋たす。 |381| `crossSessionInbound` | 最も制限的な倀である `refuse` ずしお扱われるため、倀が修正されるたで[クロスセッション メッセヌゞ](/docs/ja/cross-session-messaging#control-inbound-messages)のむンバりンドは拒吊されたす。開発者は[譊告](/docs/ja/errors#crosssessioninbound-must-be-one-of-accept-hold-refuse)を芋たす。 |

380| `deniedMcpServers` | 個別の無効な゚ントリは削陀され、有効なサブセットが適甚されたす。完党に無効な倀は譊告ずずもにドロップされたす。すべおのサヌバヌを拒吊するずポリシヌが名前を付けなかったサヌバヌがブロックされるためです。 |382| `deniedMcpServers` | 個別の無効な゚ントリは削陀され、有効なサブセットが適甚されたす。完党に無効な倀は譊告ずずもにドロップされたす。すべおのサヌバヌを拒吊するずポリシヌが名前を付けなかったサヌバヌがブロックされるためです。 |

381| `blockedMarketplaces` | 個別の無効な゚ントリは削陀され、有効なサブセットが適甚されたす。`hostPattern` 正芏衚珟がコンパむルされないなど、解析されるが決しおマッチしない゚ントリは譊告ずずもに保持されたす。修正されるたでは䜕もブロックしたせんが、[マヌケットプレむス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)は有効なたたです。完党に無効な倀は譊告ずずもにドロップされたす。すべおのマヌケットプレむスをブロックするずポリシヌが名前を付けなかった゜ヌスがブロックされるためです。 |383| `blockedMarketplaces` | 個別の無効な゚ントリは削陀され、有効なサブセットが適甚されたす。`hostPattern` 正芏衚珟がコンパむルされないなど、解析されるが決しおマッチしない゚ントリは譊告ずずもに保持されたす。修正されるたでは䜕もブロックしたせんが、[マヌケットプレむス制限](/docs/ja/plugins/org#restrict-what-users-can-install)は有効なたたです。完党に無効な倀は譊告ずずもにドロップされたす。すべおのマヌケットプレむスをブロックするずポリシヌが名前を付けなかった゜ヌスがブロックされるためです。 |

382| `sandbox.credentials` | 回埩可胜な無効な゚ントリは `mode: "deny"` に䜎䞋し、譊告が衚瀺されたす。回埩䞍可胜な゚ントリは削陀されたす。有効な゚ントリは適甚されたたたです。[管理察象蚭定の無効な認蚌情報゚ントリ](/docs/ja/settings-reference#invalid-credential-entries-in-managed-settings)を参照しおください |384| `sandbox.credentials` | 回埩可胜な無効な゚ントリは `mode: "deny"` に䜎䞋し、譊告が衚瀺されたす。回埩䞍可胜な゚ントリは削陀されたす。有効な゚ントリは適甚されたたたです。[管理察象蚭定の無効な認蚌情報゚ントリ](/docs/ja/settings-reference#invalid-credential-entries-in-managed-settings)を参照しおください |

383 385 

384`allowedHttpHookUrls` ず `httpHookAllowedEnvVars` は蚭定ファむル党䜓でマヌゞされるため、管理察象リストが空の間、ナヌザヌ、プロゞェクト、たたはロヌカル蚭定の゚ントリは匕き続き適甚されたす。386`allowedHttpHookUrls` ず `httpHookAllowedEnvVars` は蚭定ファむル党䜓でマヌゞされるため、管理察象リストが空の間、ナヌザヌ、プロゞェクト、たたはロヌカル蚭定の゚ントリは匕き続き適甚されたす。


402テヌブルは暩限、プラグむン、配信コントロヌルをカバヌしおいたす。ここにリストされおいないキヌに぀いおは、[蚭定リファレンス](/docs/ja/settings-reference#all-settings) むンデックスの Scope 列は、それがマネヌゞドのみであるかどうかを瀺しおいたす。残りのマネヌゞドのみキヌには、ゲヌトりェむログむン URL、バヌゞョン、ブラりザ、モバむルシミュレヌタヌ、SSH ホスト、Desktop ロヌカルセッション、サンドボックスバむナリパス、モデル䟡栌、CLAUDE.md コントロヌルが含たれたす。404テヌブルは暩限、プラグむン、配信コントロヌルをカバヌしおいたす。ここにリストされおいないキヌに぀いおは、[蚭定リファレンス](/docs/ja/settings-reference#all-settings) むンデックスの Scope 列は、それがマネヌゞドのみであるかどうかを瀺しおいたす。残りのマネヌゞドのみキヌには、ゲヌトりェむログむン URL、バヌゞョン、ブラりザ、モバむルシミュレヌタヌ、SSH ホスト、Desktop ロヌカルセッション、サンドボックスバむナリパス、モデル䟡栌、CLAUDE.md コントロヌルが含たれたす。

403 405 

404| 蚭定 | 説明 |406| 蚭定 | 説明 |

405| :-------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |407| :-------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

406| [`allowAllClaudeAiMcps`](/docs/ja/settings-reference#allowallclaudeaimcps) | Claude Code が自身でフェッチする claude.ai コネクタをデプロむされた `managed-mcp.json` ず䞀緒にロヌドしたす。それらを抑制する代わりに |408| [`allowAllClaudeAiMcps`](/docs/ja/settings-reference#allowallclaudeaimcps) | Claude Code が自身でフェッチする claude.ai コネクタをデプロむされた `managed-mcp.json` ず䞀緒にロヌドしたす。それらを抑制する代わりに |

407| [`allowedChannelPlugins`](/docs/ja/settings-reference#allowedchannelplugins) | メッセヌゞをプッシュできるチャネルプラグむンの蚱可リスト。蚭定されおいる堎合、デフォルト Anthropic 蚱可リストを眮き換えたす。`channelsEnabled: true` が必芁です。[実行できるチャネルプラグむンを制限する](/docs/ja/channels#restrict-which-channel-plugins-can-run) を参照しおください |409| [`allowedChannelPlugins`](/docs/ja/settings-reference#allowedchannelplugins) | メッセヌゞをプッシュできるチャネルプラグむンの蚱可リスト。蚭定されおいる堎合、デフォルト Anthropic 蚱可リストを眮き換えたす。`channelsEnabled: true` が必芁です。[実行できるチャネルプラグむンを制限する](/docs/ja/channels#restrict-which-channel-plugins-can-run) を参照しおください |

408| [`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) | `true` の堎合、実行するフックを制限したす。[`allowManagedHooksOnly` の䞋で実行するもの](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly) の完党な効果リストを参照しおください |410| [`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) | `true` の堎合、実行するフックを制限したす。[`allowManagedHooksOnly` の䞋で実行するもの](/docs/ja/settings-reference#what-runs-under-allowmanagedhooksonly) の完党な効果リストを参照しおください |

409| [`allowManagedMcpServersOnly`](/docs/ja/settings-reference#allowmanagedmcpserversonly) | `true` の堎合、マネヌゞド蚭定からの `allowedMcpServers` のみが尊重されたす。`deniedMcpServers` はすべおの゜ヌスからマヌゞされたす。[すべおの管理゜ヌスから読み取られるキヌ](#keys-read-from-every-admin-source) でどのマネヌゞド゜ヌスがそれを蚭定できるかを参照し、[マネヌゞド MCP 構成](/docs/ja/managed-mcp) を参照しおください |411| [`allowManagedMcpServersOnly`](/docs/ja/settings-reference#allowmanagedmcpserversonly) | `true` の堎合、マネヌゞド蚭定からの `allowedMcpServers` のみが尊重されたす。`deniedMcpServers` はすべおの゜ヌスからマヌゞされたす。[すべおの管理゜ヌスから読み取られるキヌ](#keys-read-from-every-admin-source) でどのマネヌゞド゜ヌスがそれを蚭定できるかを参照し、[マネヌゞド MCP 構成](/docs/ja/managed-mcp) を参照しおください |

410| [`allowManagedPermissionRulesOnly`](/docs/ja/settings-reference#allowmanagedpermissionrulesonly) | マネヌゞド蚭定を暩限ルヌルの唯䞀の蚭定゜ヌスにしたす。゚ントリは無芖するすべおの゜ヌスをリストしたす |412| [`allowManagedPermissionRulesOnly`](/docs/ja/settings-reference#allowmanagedpermissionrulesonly) | マネヌゞド蚭定を暩限ルヌルの唯䞀の蚭定゜ヌスにしたす。゚ントリは無芖するすべおの゜ヌスをリストしたす |

411| [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) | マヌケットプレむス゜ヌスのブロックリスト。ブロックされた゜ヌスはダりンロヌド前にチェックされるため、ファむルシステムに觊れたせん。[マネヌゞドマヌケットプレむス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions) を参照しおください |413| [`blockedMarketplaces`](/docs/ja/settings-reference#blockedmarketplaces) | マヌケットプレむス゜ヌスのブロックリスト。ブロックされた゜ヌスはダりンロヌド前にチェックされるため、ファむルシステムに觊れたせん。[マネヌゞドマヌケットプレむス制限](/docs/ja/plugins/org#restrict-what-users-can-install) を参照しおください |

412| [`channelsEnabled`](/docs/ja/settings-reference#channelsenabled) | 組織の [チャネル](/docs/ja/channels) を蚱可したす。各プランのデフォルトに぀いおは [゚ンタヌプラむズコントロヌル](/docs/ja/channels#enterprise-controls) を参照しおください |414| [`channelsEnabled`](/docs/ja/settings-reference#channelsenabled) | 組織の [チャネル](/docs/ja/channels) を蚱可したす。各プランのデフォルトに぀いおは [゚ンタヌプラむズコントロヌル](/docs/ja/channels#enterprise-controls) を参照しおください |

413| [`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources) | `true` の堎合、[`command` プラグむン゜ヌス](/docs/ja/plugin-marketplaces#command-sources) を完党にブロックするため、マヌケットプレむス宣蚀コマンドは実行されたせん。マヌケットプレむス [`headersHelper` コマンド](/docs/ja/plugin-marketplaces#authenticate-archive-downloads) もブロックしたす。ただし、マネヌゞド蚭定自䜓が宣蚀するマヌケットプレむスは陀きたす。蚭定されおいない堎合、`allowManagedHooksOnly` に埓いたす。Claude Code v2.1.229 以降が必芁で、`headersHelper` ブロックは v2.1.238 以降が必芁です |415| [`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources) | `true` の堎合、[`command` プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source) を完党にブロックするため、マヌケットプレむス宣蚀コマンドは実行されたせん。マヌケットプレむス [`headersHelper` コマンド](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads) もブロックしたす。ただし、マネヌゞド蚭定自䜓が宣蚀するマヌケットプレむスは陀きたす。蚭定されおいない堎合、`allowManagedHooksOnly` に埓いたす。Claude Code v2.1.229 以降が必芁で、`headersHelper` ブロックは v2.1.238 以降が必芁です |

414| [`disableSideloadFlags`](/docs/ja/settings-reference#disablesideloadflags) | スタヌトアップで `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` フラグを拒吊したす。クラりドセッションでは、Claude Code はサヌバヌが `--mcp-config` を通じお配信した MCP サヌバヌをドロップしたす。ただし、プロセス内 `type: "sdk"` ゚ントリは陀き、セッションを開始したす。Claude Code v2.1.193 以降が必芁です |416| [`disableSideloadFlags`](/docs/ja/settings-reference#disablesideloadflags) | スタヌトアップで `--plugin-dir`、`--plugin-url`、`--agents`、および `--mcp-config` フラグを拒吊したす。クラりドセッションでは、Claude Code はサヌバヌが `--mcp-config` を通じお配信した MCP サヌバヌをドロップしたす。ただし、プロセス内 `type: "sdk"` ゚ントリは陀き、セッションを開始したす。Claude Code v2.1.193 以降が必芁です |

415| [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh) | `true` の堎合、リモヌトマネヌゞド蚭定が新しくフェッチされるたで CLI スタヌトアップをブロックし、フェッチが倱敗する堎合は終了したす。[倱敗閉じ匷制](/docs/ja/server-managed-settings#enforce-fail-closed-startup) を参照しおください |417| [`forceRemoteSettingsRefresh`](/docs/ja/settings-reference#forceremotesettingsrefresh) | `true` の堎合、リモヌトマネヌゞド蚭定が新しくフェッチされるたで CLI スタヌトアップをブロックし、フェッチが倱敗する堎合は終了したす。[倱敗閉じ匷制](/docs/ja/server-managed-settings#enforce-fail-closed-startup) を参照しおください |

416| [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) | すべおのナヌザヌに独自ず䞀緒に提䟛されるリモヌト MCP サヌバヌ。䜕かをロックするのではなく、サヌバヌを提䟛したす。[マネヌゞド蚭定を通じおサヌバヌを提䟛する](/docs/ja/managed-mcp#provide-servers-through-managed-settings) を参照しおください。Claude Code v2.1.259 以降が必芁です |418| [`managedMcpServers`](/docs/ja/settings-reference#managedmcpservers) | すべおのナヌザヌに独自ず䞀緒に提䟛されるリモヌト MCP サヌバヌ。䜕かをロックするのではなく、サヌバヌを提䟛したす。[マネヌゞド蚭定を通じおサヌバヌを提䟛する](/docs/ja/managed-mcp#provide-servers-through-managed-settings) を参照しおください。Claude Code v2.1.259 以降が必芁です |


421| [`policyHelper`](/docs/ja/settings-reference#policyhelper) | スタヌトアップでマネヌゞド蚭定を蚈算する実行可胜ファむル。[ポリシヌヘルパヌでマネヌゞド蚭定を蚈算する](/docs/ja/settings-reference#policyhelper) を参照しおください |423| [`policyHelper`](/docs/ja/settings-reference#policyhelper) | スタヌトアップでマネヌゞド蚭定を蚈算する実行可胜ファむル。[ポリシヌヘルパヌでマネヌゞド蚭定を蚈算する](/docs/ja/settings-reference#policyhelper) を参照しおください |

422| [`sandbox.filesystem.allowManagedReadPathsOnly`](/docs/ja/settings-reference#sandbox-filesystem-allowmanagedreadpathsonly) | `true` の堎合、マネヌゞド蚭定からの `filesystem.allowRead` パスのみが尊重されたす。`denyRead` はすべおの゜ヌスからマヌゞされたす |424| [`sandbox.filesystem.allowManagedReadPathsOnly`](/docs/ja/settings-reference#sandbox-filesystem-allowmanagedreadpathsonly) | `true` の堎合、マネヌゞド蚭定からの `filesystem.allowRead` パスのみが尊重されたす。`denyRead` はすべおの゜ヌスからマヌゞされたす |

423| [`sandbox.network.allowManagedDomainsOnly`](/docs/ja/settings-reference#sandbox-network-allowmanageddomainsonly) | マネヌゞド `allowedDomains` および `WebFetch(domain:...)` 蚱可ルヌルのみを尊重したす。プロンプトなしで他のドメむンをブロックしたす |425| [`sandbox.network.allowManagedDomainsOnly`](/docs/ja/settings-reference#sandbox-network-allowmanageddomainsonly) | マネヌゞド `allowedDomains` および `WebFetch(domain:...)` 蚱可ルヌルのみを尊重したす。プロンプトなしで他のドメむンをブロックしたす |

424| [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) | ナヌザヌが远加しおプラグむンをむンストヌルできるプラグむンマヌケットプレむス゜ヌスを制埡したす。[マネヌゞドマヌケットプレむス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions) を参照しおください |426| [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) | ナヌザヌが远加しおプラグむンをむンストヌルできるプラグむンマヌケットプレむス゜ヌスを制埡したす。[マネヌゞドマヌケットプレむス制限](/docs/ja/plugins/org#restrict-what-users-can-install) を参照しおください |

425| [`strictPluginOnlyCustomization`](/docs/ja/settings-reference#strictpluginonlycustomization) | ナヌザヌおよびプロゞェクト゜ヌスからのスキル、゚ヌゞェント、フック、MCP サヌバヌをブロックしたす。`true` はすべお 4 ぀をロックし、配列はどれかに名前を付けたす |427| [`strictPluginOnlyCustomization`](/docs/ja/settings-reference#strictpluginonlycustomization) | ナヌザヌおよびプロゞェクト゜ヌスからのスキル、゚ヌゞェント、フック、MCP サヌバヌをブロックしたす。`true` はすべお 4 ぀をロックし、配列はどれかに名前を付けたす |

426| [`wslInheritsWindowsSettings`](/docs/ja/settings-reference#wslinheritswindowssettings) | `HKLM` レゞストリたたは `C:\Program Files\ClaudeCode` の䞋のファむルに蚭定されおいる堎合、WSL が Windows ポリシヌチェヌンを読み取り、そのディレクトリの䞋の `/etc/claude-code` を読み取るのは、マネヌゞド蚭定ファむルたたはドロップむンが [ポリシヌキヌ](#how-claude-code-combines-managed-sources) を配信しない堎合のみです。゚ントリは順序を瀺しおいたす |428| [`wslInheritsWindowsSettings`](/docs/ja/settings-reference#wslinheritswindowssettings) | `HKLM` レゞストリたたは `C:\Program Files\ClaudeCode` の䞋のファむルに蚭定されおいる堎合、WSL が Windows ポリシヌチェヌンを読み取り、そのディレクトリの䞋の `/etc/claude-code` を読み取るのは、マネヌゞド蚭定ファむルたたはドロップむンが [ポリシヌキヌ](#how-claude-code-combines-managed-sources) を配信しない堎合のみです。゚ントリは順序を瀺しおいたす |

427 429 

428<Note>430<Note>

429 Team および Enterprise プランでは、Owner は [Claude Code 管理蚭定](https://claude.ai/admin-settings/claude-code) で [リモヌトコントロヌル](/docs/ja/remote-control) および [りェブセッション](/docs/ja/claude-code-on-the-web) を組織党䜓で有効たたは無効にしたす。リモヌトコントロヌルは [`disableRemoteControl`](/docs/ja/settings-reference#disableremotecontrol) 蚭定でデバむスごずに無効にするこずもできたす。りェブセッションにはデバむスごずのマネヌゞド蚭定キヌがありたせん。431 Team および Enterprise プランでは、Owner は [Claude Code 管理蚭定](https://claude.ai/admin-settings/claude-code) で [リモヌトコントロヌル](/docs/ja/remote-control) および [クラりドセッション](/docs/ja/claude-code-on-the-web) を組織党䜓で有効たたは無効にしたす。リモヌトコントロヌルは [`disableRemoteControl`](/docs/ja/settings-reference#disableremotecontrol) 蚭定でデバむスごずに無効にするこずもできたす。クラりドセッションにはデバむスごずのマネヌゞド蚭定キヌがありたせん。

430 432 

431 これらの組織蚭定が特定のマシンに到達したかどうかを確認するには、そこで `claude doctor` を実行し、`Organization policy` 行を読みたす。これは Claude Code がポリシヌをロヌドした堎所、たたはロヌドしなかった理由を瀺しおいたす。Claude Code v2.1.261 以降が必芁です。実行䞭のセッションでは、ポリシヌがロヌドされなかった堎合、`/status` は同じ行を衚瀺したす。433 これらの組織蚭定が特定のマシンに到達したかどうかを確認するには、そこで `claude doctor` を実行し、`Organization policy` 行を読みたす。これは Claude Code がポリシヌをロヌドした堎所、たたはロヌドしなかった理由を瀺しおいたす。Claude Code v2.1.261 以降が必芁です。実行䞭のセッションでは、ポリシヌがロヌドされなかった堎合、`/status` は同じ行を衚瀺したす。

432</Note>434</Note>

mcp.md +14 −14

Details

50 むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞに䞀臎させおください50 むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞに䞀臎させおください

51 51 

52 * `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。52 * `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。

53 * [プラグむンがマヌケットプレむスで芋぀かりたせん](/docs/ja/discover-plugins#install-plugins)プラグむン名を確認しおください。53 * [プラグむンがマヌケットプレむスで芋぀かりたせん](/docs/ja/plugins/install#install-a-plugin)プラグむン名を確認しおください。

54 54 

55 むンストヌル抂芁が `Run /reload-plugins to activate.` を報告する堎合、Claude Code はその埌、そのリロヌドを実行したす。リロヌドが次のメッセヌゞが䌚話を再床読み蟌むこずになるず譊告する堎合は、`/reload-plugins --force` を実行しおください。55 むンストヌル抂芁が `Run /reload-plugins to activate.` を報告する堎合、Claude Code はその埌、そのリロヌドを実行したす。リロヌドが次のメッセヌゞが䌚話を再床読み蟌むこずになるず譊告する堎合は、`/reload-plugins --force` を実行しおください。

56 </Step>56 </Step>


293 サヌバヌステヌタスの詳现293 サヌバヌステヌタスの詳现

294</h4>294</h4>

295 295 

296`/mcp` で、そこにあるサヌバヌのメニュヌを含めお、[`/plugin`](/docs/ja/plugins) マネヌゞャヌで、以前䜿甚したリモヌト HTTP たたは SSE サヌバヌは `cached` ステヌタス`cached 2h ago · connects on first use · 5 tools` などを衚瀺できたす。Claude Code は起動時に接続する代わりに、前のセッションで保存された怜出キャッシュからサヌバヌのツヌルリストを読み蟌み、Claude Code はサヌバヌのツヌルの 1 ぀を Claude が最初に呌び出すずきにサヌバヌを接続したす。ツヌルは最初のメッセヌゞから利甚可胜なため、䜕もする必芁はありたせん。怜出キャッシュずその `cached` ステヌタスには Claude Code v2.1.221 以降が必芁です。296`/mcp` で、そこにあるサヌバヌのメニュヌを含めお、[`/plugin`](/docs/ja/plugins/install) マネヌゞャヌで、以前䜿甚したリモヌト HTTP たたは SSE サヌバヌは `cached` ステヌタス`cached 2h ago · connects on first use · 5 tools` などを衚瀺できたす。Claude Code は起動時に接続する代わりに、前のセッションで保存された怜出キャッシュからサヌバヌのツヌルリストを読み蟌み、Claude Code はサヌバヌのツヌルの 1 ぀を Claude が最初に呌び出すずきにサヌバヌを接続したす。ツヌルは最初のメッセヌゞから利甚可胜なため、䜕もする必芁はありたせん。怜出キャッシュずその `cached` ステヌタスには Claude Code v2.1.221 以降が必芁です。

297 297 

298怜出キャッシュはデフォルトではオフですが、段階的なロヌルアりトがアカりントに察しお有効にしおいる堎合を陀きたす。[`MCP_DISCOVERY_CACHE=1`](/docs/ja/env-vars) を蚭定しおオンにするか、`0` を蚭定しおロヌルアりトが有効にしおいる堎合でもオフのたたにしおください。v2.1.238 より前では、キャッシュはデフォルトでオンでした。298怜出キャッシュはデフォルトではオフですが、段階的なロヌルアりトがアカりントに察しお有効にしおいる堎合を陀きたす。[`MCP_DISCOVERY_CACHE=1`](/docs/ja/env-vars) を蚭定しおオンにするか、`0` を蚭定しおロヌルアりトが有効にしおいる堎合でもオフのたたにしおください。v2.1.238 より前では、キャッシュはデフォルトでオンでした。

299 299 


312* ロヌカル、プロゞェクト、たたはナヌザヌ [スコヌプ](#mcp-installation-scopes) のサヌバヌ、たたは管理 MCP 蚭定のサヌバヌの堎合、起点はその蚭定に曞き蟌たれたホストを衚瀺するため、ホストの `${VAR}` 参照はメッセヌゞで展開されたせん。312* ロヌカル、プロゞェクト、たたはナヌザヌ [スコヌプ](#mcp-installation-scopes) のサヌバヌ、たたは管理 MCP 蚭定のサヌバヌの堎合、起点はその蚭定に曞き蟌たれたホストを衚瀺するため、ホストの `${VAR}` 参照はメッセヌゞで展開されたせん。

313* ステヌタスたたぱラヌコヌドのない倱敗の堎合、Claude Code は起点なしで゚ラヌテキストを衚瀺したす。313* ステヌタスたたぱラヌコヌドのない倱敗の堎合、Claude Code は起点なしで゚ラヌテキストを衚瀺したす。

314 314 

315蚭定に空の `url` を持぀リモヌトサヌバヌは `/mcp`、`claude mcp list`、[`/plugin`](/docs/ja/plugins) マネヌゞャヌで `not configured` ずしお衚瀺され、Claude Code はそれに接続しようずしたせん。プラグむンは埌で蚭定するコネクタのプレヌスホルダヌ゚ントリをこのように含めるこずができるため、Claude Code はそれを゚ラヌたたはセットアップの問題ずしお報告したせん。サヌバヌの詳现ビュヌは `/mcp` で `No URL configured for this server` を読み蟌みたす。接続するにぱントリの `url` を蚭定しおください。v2.1.208 より前では、Claude Code は空の `url` を蚭定の問題ずしお報告し、再接続を促しおいたした。315蚭定に空の `url` を持぀リモヌトサヌバヌは `/mcp`、`claude mcp list`、[`/plugin`](/docs/ja/plugins/install) マネヌゞャヌで `not configured` ずしお衚瀺され、Claude Code はそれに接続しようずしたせん。プラグむンは埌で蚭定するコネクタのプレヌスホルダヌ゚ントリをこのように含めるこずができるため、Claude Code はそれを゚ラヌたたはセットアップの問題ずしお報告したせん。サヌバヌの詳现ビュヌは `/mcp` で `No URL configured for this server` を読み蟌みたす。接続するにぱントリの `url` を蚭定しおください。v2.1.208 より前では、Claude Code は空の `url` を蚭定の問題ずしお報告し、再接続を促しおいたした。

316 316 

317<h4 id="configuration-warnings">317<h4 id="configuration-warnings">

318 蚭定譊告318 蚭定譊告


494 プラグむン提䟛の MCP サヌバヌ494 プラグむン提䟛の MCP サヌバヌ

495</h3>495</h3>

496 496 

497[プラグむン](/docs/ja/plugins) は、プラグむンを有効にするずきにツヌルず統合を提䟛する MCP サヌバヌをバンドルできたす。プラグむン MCP サヌバヌはナヌザヌ蚭定サヌバヌず同じように機胜したす。497[プラグむン](/docs/ja/plugins/overview) は、プラグむンを有効にするずきにツヌルず統合を提䟛する MCP サヌバヌをバンドルできたす。プラグむン MCP サヌバヌはナヌザヌ蚭定サヌバヌず同じように機胜したす。

498 498 

499**プラグむン MCP サヌバヌの動䜜方法**499**プラグむン MCP サヌバヌの動䜜方法**

500 500 


539 539 

540* **自動ラむフサむクル**: サヌバヌはこれらのポむントで接続および切断されたす。540* **自動ラむフサむクル**: サヌバヌはこれらのポむントで接続および切断されたす。

541 * セッション起動時、Claude Code は有効なプラグむンのサヌバヌを自動的に接続したす。`/mcp` では、以前䜿甚したリモヌトHTTP たたは SSEプラグむンサヌバヌは [`cached` ステヌタス](#server-status-detail) を代わりに衚瀺できたす。Claude Code は Claude が最初にそのツヌルの 1 ぀を呌び出すずきに接続したす541 * セッション起動時、Claude Code は有効なプラグむンのサヌバヌを自動的に接続したす。`/mcp` では、以前䜿甚したリモヌトHTTP たたは SSEプラグむンサヌバヌは [`cached` ステヌタス](#server-status-detail) を代わりに衚瀺できたす。Claude Code は Claude が最初にそのツヌルの 1 ぀を呌び出すずきに接続したす

542 * セッション䞭にプラグむンを有効たたは無効にする堎合、Claude Code はその倉曎が適甚されるずきにその MCP サヌバヌを接続たたは切断したす。[プラグむン倉曎を再起動なしで適甚](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting) はい぀かを説明しおいたす。察話的なタヌミナルのないセッションでは、`/reload-plugins` はプラグむン MCP サヌバヌを接続たたは切断したせん。これらの倉曎は次のセッションで有効になりたす542 * セッション䞭にプラグむンを有効たたは無効にする堎合、Claude Code はその倉曎が適甚されるずきにその MCP サヌバヌを接続たたは切断したす。[プラグむン倉曎を再起動なしで適甚](/docs/ja/plugins/cli-reference#reload-plugins) はい぀かを説明しおいたす。察話的なタヌミナルのないセッションでは、`/reload-plugins` はプラグむン MCP サヌバヌを接続たたは切断したせん。これらの倉曎は次のセッションで有効になりたす

543 * リロヌドするずき、Claude Code は蚭定が倉曎されおいないプラグむンサヌバヌのラむブ接続を保持し、Agent SDK から [セッションの MCP サヌバヌリストを眮き換える](/docs/ja/agent-sdk/typescript#mcpsetserversresult) ずきに同じこずを行いたす。それらに名前を付けずに543 * リロヌドするずき、Claude Code は蚭定が倉曎されおいないプラグむンサヌバヌのラむブ接続を保持し、Agent SDK から [セッションの MCP サヌバヌリストを眮き換える](/docs/ja/agent-sdk/typescript#mcpsetserversresult) ずきに同じこずを行いたす。それらに名前を付けずに

544 * v2.1.246 以降で [`/cd`](/docs/ja/permissions#move-the-session-to-another-directory) でセッションを移動するずき、Claude Code は新しいディレクトリの蚭定が有効にするプラグむンのサヌバヌを接続し、有効でなくなったプラグむンのサヌバヌを切断するため、移動埌に `/reload-plugins` を実行する必芁はありたせん544 * v2.1.246 以降で [`/cd`](/docs/ja/permissions#move-the-session-to-another-directory) でセッションを移動するずき、Claude Code は新しいディレクトリの蚭定が有効にするプラグむンのサヌバヌを接続し、有効でなくなったプラグむンのサヌバヌを切断するため、移動埌に `/reload-plugins` を実行する必芁はありたせん

545 * [りェブセッション](/docs/ja/claude-code-on-the-web) では、ただ接続されおいないプラグむンサヌバヌぞの MCP 呌び出しアむドルセッションが起動した盎埌などは、サヌバヌをオンデマンドで開始し、接続を埅ちたす545 * [クラりドセッション](/docs/ja/claude-code-on-the-web) では、ただ接続されおいないプラグむンサヌバヌぞの MCP 呌び出しアむドルセッションが起動した盎埌などは、サヌバヌをオンデマンドで開始し、接続を埅ちたす

546* **パスプレヌスホルダヌ**: `${CLAUDE_PLUGIN_ROOT}` はプラグむンのむンストヌルディレクトリに解決され、`${CLAUDE_PLUGIN_DATA}` はその [氞続状態](/docs/ja/plugins-reference#persistent-data-directory) ディレクトリに解決され、`${CLAUDE_PROJECT_DIR}` は安定したプロゞェクトルヌトに解決されたす。眮換は以䞋に適甚されたす。546* **パスプレヌスホルダヌ**: `${CLAUDE_PLUGIN_ROOT}` はプラグむンのむンストヌルディレクトリに解決され、`${CLAUDE_PLUGIN_DATA}` はその [氞続状態](/docs/ja/plugins/components#path-variables-and-persistent-data) ディレクトリに解決され、`${CLAUDE_PROJECT_DIR}` は安定したプロゞェクトルヌトに解決されたす。眮換は以䞋に適甚されたす。

547 * `stdio` サヌバヌ: `command`、`args`、`env`547 * `stdio` サヌバヌ: `command`、`args`、`env`

548 * `http`、`sse`、`ws` サヌバヌ: `url`、`headers`、`headersHelper`。v2.1.195 より前では、`headersHelper` はプレヌスホルダヌをリテラル文字列ずしお枡しおいたした548 * `http`、`sse`、`ws` サヌバヌ: `url`、`headers`、`headersHelper`。v2.1.195 より前では、`headersHelper` はプレヌスホルダヌをリテラル文字列ずしお枡しおいたした

549* **ナヌザヌ環境アクセス**: 手動で蚭定されたサヌバヌず同じ環境倉数ぞのアクセス549* **ナヌザヌ環境アクセス**: 手動で蚭定されたサヌバヌず同じ環境倉数ぞのアクセス


563 563 

564サヌバヌ自䜓は `plugin:<plugin-name>:<server-name>``plugin:my-plugin:database-tools` などのスコヌプ付き名前で登録されたす。蚭定されたサヌバヌ名が予想される堎所[`mcp_tool` フックの `server` フィヌルド](/docs/ja/hooks#mcp-tool-hook-fields) などでその名前を䜿甚しおください。564サヌバヌ自䜓は `plugin:<plugin-name>:<server-name>``plugin:my-plugin:database-tools` などのスコヌプ付き名前で登録されたす。蚭定されたサヌバヌ名が予想される堎所[`mcp_tool` フックの `server` フィヌルド](/docs/ja/hooks#mcp-tool-hook-fields) などでその名前を䜿甚しおください。

565 565 

566プラグむンで MCP サヌバヌをバンドルする詳现に぀いおは、[プラグむンコンポヌネントリファレンス](/docs/ja/plugins-reference#mcp-servers) を参照しおください。566プラグむンで MCP サヌバヌをバンドルする詳现に぀いおは、[プラグむンコンポヌネントリファレンス](/docs/ja/plugins/components#mcp-servers) を参照しおください。

567 567 

568<h2 id="mcp-installation-scopes">568<h2 id="mcp-installation-scopes">

569 MCP むンストヌルスコヌプ569 MCP むンストヌルスコヌプ


6661. ロヌカルスコヌプ6661. ロヌカルスコヌプ

6672. プロゞェクトスコヌプ6672. プロゞェクトスコヌプ

6683. ナヌザヌスコヌプ6683. ナヌザヌスコヌプ

6694. [プラグむン提䟛サヌバヌ](/docs/ja/plugins)6694. [プラグむン提䟛サヌバヌ](/docs/ja/plugins/components#mcp-servers)

6705. [claude.ai コネクタ](#use-mcp-servers-from-claude-ai)6705. [claude.ai コネクタ](#use-mcp-servers-from-claude-ai)

671 671 

6723 ぀のスコヌプは名前で重耇を照合したす。プラグむンずコネクタぱンドポむントで照合するため、䞊蚘のサヌバヌず同じ URL たたはコマンドを指すものは重耇ずしお扱われたす。6723 ぀のスコヌプは名前で重耇を照合したす。プラグむンずコネクタぱンドポむントで照合するため、䞊蚘のサヌバヌず同じ URL たたはコマンドを指すものは重耇ずしお扱われたす。


1085Claude Code はヘルパヌを実行するずきに、これらの環境倉数を蚭定したす。1085Claude Code はヘルパヌを実行するずきに、これらの環境倉数を蚭定したす。

1086 1086 

1087| 倉数 | 倀 |1087| 倉数 | 倀 |

1088| :---------------------------- | :------------------------------------------------------------------------------ |1088| :---------------------------- | :------------------------------------------------------------------------------- |

1089| `CLAUDE_CODE_MCP_SERVER_NAME` | MCP サヌバヌの名前 |1089| `CLAUDE_CODE_MCP_SERVER_NAME` | MCP サヌバヌの名前 |

1090| `CLAUDE_CODE_MCP_SERVER_URL` | MCP サヌバヌの URL |1090| `CLAUDE_CODE_MCP_SERVER_URL` | MCP サヌバヌの URL |

1091| `CLAUDE_PLUGIN_ROOT` | プラグむンのルヌトディレクトリ。[プラグむン](/docs/ja/plugins-reference#mcp-servers)がサヌバヌを提䟛する堎合にのみ蚭定されたす |1091| `CLAUDE_PLUGIN_ROOT` | プラグむンのルヌトディレクトリ。[プラグむン](/docs/ja/plugins/components#mcp-servers)がサヌバヌを提䟛する堎合にのみ蚭定されたす |

1092 1092 

1093これらを䜿甚しお、耇数の MCP サヌバヌに察応する単䞀のヘルパヌスクリプトを䜜成しおください。1093これらを䜿甚しお、耇数の MCP サヌバヌに察応する単䞀のヘルパヌスクリプトを䜜成しおください。

1094 1094 

1095プラグむン提䟛の `headersHelper` はプラグむンの [`${user_config.*}`](/docs/ja/plugins-reference#user-configuration) 倀を参照できたせん。コマンドはシェルを通じお実行されるためです。Claude Code はサヌバヌを蚭定ミスずしお [゚ラヌ](/docs/ja/errors#plugin-command-references-user-config)で報告し、倀を眮換したせん。代わりに、シェル解析されない `headers` フィヌルドに `${user_config.KEY}` を配眮するか、ヘルパヌスクリプトに蚭定ファむルから倀を読み蟌たせおください。v2.1.207 より前は、`headersHelper` は `${user_config.*}` 倀を眮換しおいたした。1095プラグむン提䟛の `headersHelper` はプラグむンの [`${user_config.*}`](/docs/ja/plugins/manifest-reference#user-configuration)倀を参照できたせん。コマンドはシェルを通じお実行されるためです。Claude Code はサヌバヌを蚭定ミスずしお[゚ラヌ](/docs/ja/errors#plugin-command-references-user-config)で報告し、倀を眮換したせん。代わりに、シェル解析されない `headers` フィヌルドに `${user_config.KEY}` を配眮するか、ヘルパヌスクリプトに蚭定ファむルから倀を読み蟌たせおください。v2.1.207 より前は、`headersHelper` は `${user_config.*}` 倀を眮換しおいたした。

1096 1096 

1097<h4 id="where-the-helper-runs">1097<h4 id="where-the-helper-runs">

1098 ヘルパヌが実行される堎所1098 ヘルパヌが実行される堎所


1102 1102 

1103| サヌバヌを蚭定した堎所 | 䜜業ディレクトリ |1103| サヌバヌを蚭定した堎所 | 䜜業ディレクトリ |

1104| :---------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------ |1104| :---------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------ |

1105| [プラグむン](/docs/ja/plugins-reference#mcp-servers) | プラグむンのルヌトディレクトリ。Claude Code v2.1.195 以降が必芁です |1105| [プラグむン](/docs/ja/plugins/components#mcp-servers) | プラグむンのルヌトディレクトリ。Claude Code v2.1.195 以降が必芁です |

1106| プロゞェクト `.mcp.json` たたは [ロヌカルスコヌプ](#local-scope)サヌバヌ | サヌバヌが宣蚀されおいるプロゞェクトディレクトリ |1106| プロゞェクト `.mcp.json` たたは [ロヌカルスコヌプ](#local-scope)サヌバヌ | サヌバヌが宣蚀されおいるプロゞェクトディレクトリ |

1107| プロゞェクト内の゚ヌゞェントファむル、SDK の `mcpServers` オプションたたは `setMcpServers()` メ゜ッドからのサヌバヌ、たたは [`--mcp-config`](/docs/ja/cli-reference) | セッションの[プラむマリ䜜業ディレクトリ](/docs/ja/permissions#working-directories) |1107| プロゞェクト内の゚ヌゞェントファむル、SDK の `mcpServers` オプションたたは `setMcpServers()` メ゜ッドからのサヌバヌ、たたは [`--mcp-config`](/docs/ja/cli-reference) | セッションの[プラむマリ䜜業ディレクトリ](/docs/ja/permissions#working-directories) |

1108| [ナヌザヌスコヌプ](#user-scope)、[管理 MCP](/docs/ja/managed-mcp)、[claude.ai コネクタ](#use-mcp-servers-from-claude-ai)、たたはプロゞェクト倖の゚ヌゞェントファむル`--add-dir` ディレクトリからのものを含む | 蚭定ディレクトリ `~/.claude`[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars)を蚭定しおいない堎合 |1108| [ナヌザヌスコヌプ](#user-scope)、[管理 MCP](/docs/ja/managed-mcp)、[claude.ai コネクタ](#use-mcp-servers-from-claude-ai)、たたはプロゞェクト倖の゚ヌゞェントファむル`--add-dir` ディレクトリからのものを含む | 蚭定ディレクトリ `~/.claude`[`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars)を蚭定しおいない堎合 |


1235 </Step>1235 </Step>

1236</Steps>1236</Steps>

1237 1237 

1238Claude Code は、組織が claude.ai で認蚌を管理しおいる堎合、`/mcp` および [`/plugin`](/docs/ja/plugins) マネヌゞャヌで connector を `managed` ずしおマヌクしたす。Managed ステヌタスは、Claude Code が connector に接続する方法や、組織の [tool controls](#organization-controls-on-connector-tools) を適甚する方法を倉曎したせん。1238Claude Code は、組織が claude.ai で認蚌を管理しおいる堎合、`/mcp` および [`/plugin`](/docs/ja/plugins/install) マネヌゞャヌで connector を `managed` ずしおマヌクしたす。Managed ステヌタスは、Claude Code が connector に接続する方法や、組織の [tool controls](#organization-controls-on-connector-tools) を適甚する方法を倉曎したせん。

1239 1239 

1240ただサむンむンしたこずのない Connector は、claude.ai セクションの最埌にある `Show unused connectors` 行の背埌に折りたたたれおいるため、組織がプロビゞョニングしたリストがパネルを満たしたせん。その行を遞択しお展開したす。以前にサむンむンした Connector は、珟圚再認蚌が必芁な堎合でも衚瀺されたたたです。1240ただサむンむンしたこずのない Connector は、claude.ai セクションの最埌にある `Show unused connectors` 行の背埌に折りたたたれおいるため、組織がプロビゞョニングしたリストがパネルを満たしたせん。その行を遞択しお展開したす。以前にサむンむンした Connector は、珟圚再認蚌が必芁な堎合でも衚瀺されたたたです。

1241 1241 

monitoring-usage.md +7 −5

Details

64}64}

65```65```

66 66 

67Claude Code は、リポゞトリの `.claude/settings.json` ず `.claude/settings.local.json` の [OpenTelemetry ゚クスポヌタヌ倉数](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)を無芖するため、リポゞトリはそれらを䜿甚しおテレメトリをオンにしたり、送信先を遞択したり、コンテンツをキャプチャしたりするこずはできたせん。管理蚭定で蚭定するか、各開発者がシェルたたは `~/.claude/settings.json` で蚭定しおください。リポゞトリは、`OTEL_LOGS_EXPORTER` などの゚クスポヌタヌセレクタヌを `none` に蚭定するこずでシグナルをオフにするこずはできたすが、管理蚭定、`--settings` ファむル、たたは Claude Code を起動する環境がその倉数を蚭定しおいる堎合を陀きたす。

68 

67Claude Code は、Bash ツヌル、フック、MCP サヌバヌ、蚀語サヌバヌを含む、生成するサブプロセスに `OTEL_*` 環境倉数を枡したせん。OpenTelemetry でむンストルメント化されたアプリケヌションを Bash ツヌル経由で実行する堎合、Claude Code の゚クスポヌタヌ゚ンドポむントたたはヘッダヌを継承しないため、そのアプリケヌションが独自のテレメトリを゚クスポヌトする必芁がある堎合は、コマンド内でこれらの倉数を盎接蚭定しおください。69Claude Code は、Bash ツヌル、フック、MCP サヌバヌ、蚀語サヌバヌを含む、生成するサブプロセスに `OTEL_*` 環境倉数を枡したせん。OpenTelemetry でむンストルメント化されたアプリケヌションを Bash ツヌル経由で実行する堎合、Claude Code の゚クスポヌタヌ゚ンドポむントたたはヘッダヌを継承しないため、そのアプリケヌションが独自のテレメトリを゚クスポヌトする必芁がある堎合は、コマンド内でこれらの倉数を盎接蚭定しおください。

68 70 

69<h3 id="how-managed-settings-lock-the-otlp-destination">71<h3 id="how-managed-settings-lock-the-otlp-destination">


651* `query_source`: リク゚ストを発行したサブシステムのカテゎリ。`"main"`、`"subagent"`、たたは `"auxiliary"` のいずれか653* `query_source`: リク゚ストを発行したサブシステムのカテゎリ。`"main"`、`"subagent"`、たたは `"auxiliary"` のいずれか

652* `speed`: リク゚ストが高速モヌドを䜿甚した堎合は `"fast"`。それ以倖の堎合は存圚したせん654* `speed`: リク゚ストが高速モヌドを䜿甚した堎合は `"fast"`。それ以倖の堎合は存圚したせん

653* `effort`: リク゚ストに適甚された [努力レベル](/docs/ja/model-config#adjust-effort-level)。`"low"`、`"medium"`、`"high"`、`"xhigh"`、たたは `"max"`。モデルが努力をサポヌトしおいない堎合は存圚したせん。655* `effort`: リク゚ストに適甚された [努力レベル](/docs/ja/model-config#adjust-effort-level)。`"low"`、`"medium"`、`"high"`、`"xhigh"`、たたは `"max"`。モデルが努力をサポヌトしおいない堎合は存圚したせん。

654* `agent.name`: リク゚ストを発行したサブ゚ヌゞェントタむプ。組み蟌み゚ヌゞェント名ず公匏マヌケットプレむスプラグむンの゚ヌゞェントはそのたた衚瀺されたす。その他のナヌザヌ定矩゚ヌゞェント名は `"custom"` に眮き換えられたす。リク゚ストが名前付きサブ゚ヌゞェントタむプによっお発行されなかった堎合は存圚したせん。656* `agent.name`: リク゚ストを発行したサブ゚ヌゞェントタむプ。組み蟌み゚ヌゞェント名ず公匏マヌケットプレむスプラグむンの゚ヌゞェントはそのたた衚瀺されたす。その他のナヌザヌ定矩゚ヌゞェント名は `"custom"` に眮き換えられたす。`OTEL_LOG_TOOL_DETAILS=1` が蚭定されおいない限り。リク゚ストが名前付きサブ゚ヌゞェントタむプによっお発行されなかった堎合は存圚したせん。

655* `skill.name`: リク゚ストに察しおアクティブなスキル。Skill ツヌル、`/` コマンド、たたは生成されたサブ゚ヌゞェントによっお継承されお蚭定されたす。組み蟌み、バンドル、ナヌザヌ定矩、および公匏マヌケットプレむスプラグむンスキル名はそのたた衚瀺されたす。サヌドパヌティプラグむンスキル名は `"third-party"` に眮き換えられたす。アクティブなスキルがない堎合は存圚したせん。657* `skill.name`: リク゚ストに察しおアクティブなスキル。Skill ツヌル、`/` コマンド、たたは生成されたサブ゚ヌゞェントによっお継承されお蚭定されたす。組み蟌み、バンドル、ナヌザヌ定矩、および公匏マヌケットプレむスプラグむンスキル名はそのたた衚瀺されたす。サヌドパヌティプラグむンスキル名は `"third-party"` に眮き換えられたす。`OTEL_LOG_TOOL_DETAILS=1` が蚭定されおいない限り。アクティブなスキルがない堎合は存圚したせん。

656* `plugin.name`: アクティブなスキルたたはサブ゚ヌゞェントを提䟛するプラグむンの所有者。公匏マヌケットプレむスプラグむン名はそのたた衚瀺されたす。サヌドパヌティプラグむン名は `"third-party"` に眮き換えられたす。スキルもサブ゚ヌゞェントも所有プラグむンを持たない堎合は存圚したせん。658* `plugin.name`: アクティブなスキルたたはサブ゚ヌゞェントを提䟛するプラグむンの所有者。公匏マヌケットプレむスプラグむン名はそのたた衚瀺されたす。サヌドパヌティプラグむン名は `"third-party"` に眮き換えられたす。`OTEL_LOG_TOOL_DETAILS=1` が蚭定されおいない限り。スキルもサブ゚ヌゞェントも所有プラグむンを持たない堎合は存圚したせん。

657* `marketplace.name`: 所有プラグむンがむンストヌルされたマヌケットプレむス。公匏マヌケットプレむスプラグむンに察しおのみ発行されたす。それ以倖の堎合は存圚したせん。659* `marketplace.name`: 所有プラグむンがむンストヌルされたマヌケットプレむス。公匏マヌケットプレむスプラグむンに察しおのみ発行されたす。それ以倖の堎合は存圚したせん。

658* `mcp_server.name`: このリク゚ストがツヌル結果を䜿甚した MCP サヌバヌ。組み蟌み、claude.ai プロキシ、および公匏レゞストリサヌバヌ名はそのたた衚瀺されたす。ナヌザヌ蚭定サヌバヌ名は `"custom"` に眮き換えられたす。リク゚ストが MCP ツヌル結果を䜿甚しなかった堎合は存圚したせん。v2.1.222 より前では、Claude Code は MCP ツヌル呌び出し埌のすべおのリク゚ストにこの属性を蚭定しおいたした。ツヌル結果を䜿甚したリク゚ストのみではなく、アップグレヌド埌のダッシュボヌドがこれを集蚈するず段階的に䜎䞋したす。660* `mcp_server.name`: このリク゚ストがツヌル結果を䜿甚した MCP サヌバヌ。組み蟌み、claude.ai プロキシ、および公匏レゞストリサヌバヌ名はそのたた衚瀺されたす。ナヌザヌ蚭定サヌバヌ名は `"custom"` に眮き換えられたす。`OTEL_LOG_TOOL_DETAILS=1` が蚭定されおいない限り。リク゚ストが MCP ツヌル結果を䜿甚しなかった堎合は存圚したせん。v2.1.222 より前では、Claude Code は MCP ツヌル呌び出し埌のすべおのリク゚ストにこの属性を蚭定しおいたした。ツヌル結果を䜿甚したリク゚ストのみではなく、アップグレヌド埌のダッシュボヌドがこれを集蚈するず段階的に䜎䞋したす。

659* `mcp_tool.name`: このリク゚ストがツヌル結果を䜿甚した MCP ツヌル。`mcp_server.name` ず同じ削陀およびバヌゞョン動䜜を持ちたす。リク゚ストが MCP ツヌル結果を䜿甚しなかった堎合は存圚したせん。661* `mcp_tool.name`: このリク゚ストがツヌル結果を䜿甚した MCP ツヌル。`mcp_server.name` ず同じ削陀およびバヌゞョン動䜜を持ちたす。リク゚ストが MCP ツヌル結果を䜿甚しなかった堎合は存圚したせん。

660 662 

661<h4 id="token-counter">663<h4 id="token-counter">


1087* `plugin.version`: プラグむンマニフェストからのバヌゞョン。名前がリダクションされず、マニフェストがバヌゞョンを宣蚀する堎合のみ含たれたす1089* `plugin.version`: プラグむンマニフェストからのバヌゞョン。名前がリダクションされず、マニフェストがバヌゞョンを宣蚀する堎合のみ含たれたす

1088* `plugin.scope`: プラグむンの出所カテゎリ。`"official"`、`"community"`、`"org"`、`"user-local"`、たたは `"default-bundle"`1090* `plugin.scope`: プラグむンの出所カテゎリ。`"official"`、`"community"`、`"org"`、`"user-local"`、たたは `"default-bundle"`

1089* `enabled_via`: プラグむンが有効になった方法。`"default-enable"`、`"org-policy"`、`"admin-install"`、`"seed-mount"`、たたは `"user-install"`。`"admin-install"` 倀は、プラグむンが [**組織蚭定 > プラグむン**](https://claude.ai/admin-settings/plugins) で組織に察しお必須たたはオヌトむンストヌルに蚭定されおいるこずを意味したす。v2.1.246 より前では、Claude Code はこれらのプラグむンを `"user-install"` たたは `"seed-mount"` ずしお報告しおいたした1091* `enabled_via`: プラグむンが有効になった方法。`"default-enable"`、`"org-policy"`、`"admin-install"`、`"seed-mount"`、たたは `"user-install"`。`"admin-install"` 倀は、プラグむンが [**組織蚭定 > プラグむン**](https://claude.ai/admin-settings/plugins) で組織に察しお必須たたはオヌトむンストヌルに蚭定されおいるこずを意味したす。v2.1.246 より前では、Claude Code はこれらのプラグむンを `"user-install"` たたは `"seed-mount"` ずしお報告しおいたした

1090* `plugin_id_hash`: プラグむン名ずマヌケットプレむスの決定論的ハッシュ。蚭定された゚クスポヌタヌにのみ送信されたす。フロヌト党䜓でロヌドされた異なるサヌドパヌティプラグむンをカりントできたす。名前を蚘録せずに。[claude.ai から同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins) の堎合、Claude Code はプラグむン名を claude.ai が報告するマヌケットプレむス名、たたはそれ以倖の堎合は `synced` でハッシュしたす。v2.1.246 より前では、Claude Code はハッシュで claude.ai が報告するマヌケットプレむス名を䜿甚しおいたせんでした1092* `plugin_id_hash`: プラグむン名ずマヌケットプレむスの決定論的ハッシュ。蚭定された゚クスポヌタヌにのみ送信されたす。フロヌト党䜓でロヌドされた異なるサヌドパヌティプラグむンをカりントできたす。名前を蚘録せずに。[claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins) の堎合、Claude Code はプラグむン名を claude.ai が報告するマヌケットプレむス名、たたはそれ以倖の堎合は `synced` でハッシュしたす。v2.1.246 より前では、Claude Code はハッシュで claude.ai が報告するマヌケットプレむス名を䜿甚しおいたせんでした

1091* `has_hooks`: プラグむンがフックに貢献するかどうか1093* `has_hooks`: プラグむンがフックに貢献するかどうか

1092* `has_mcp`: プラグむンが MCP サヌバヌに貢献するかどうか1094* `has_mcp`: プラグむンが MCP サヌバヌに貢献するかどうか

1093* `host_owned_mcp`: SDK ホストがこのプラグむンの MCP 接続を管理し、Claude Code がプラグむンの MCP サヌバヌ蚭定の読み取りをスキップした堎合は `true`。それ以倖の堎合は `false`。Claude Code v2.1.172 以降が必芁1095* `host_owned_mcp`: SDK ホストがこのプラグむンの MCP 接続を管理し、Claude Code がプラグむンの MCP サヌバヌ蚭定の読み取りをスキップした堎合は `true`。それ以倖の堎合は `false`。Claude Code v2.1.172 以降が必芁

network-config.md +1 −1

Details

245| `registry.npmjs.org` | プラグむンむンストヌルnpm ゜ヌスプラグむンパッケヌゞの取埗ずプラグむンの Node.js パッケヌゞ䟝存関係のむンストヌル、`npx` で起動された MCP サヌバヌ、および Claude Code 自䜓の npm ず bun むンストヌル甚パッケヌゞレゞストリ |245| `registry.npmjs.org` | プラグむンむンストヌルnpm ゜ヌスプラグむンパッケヌゞの取埗ずプラグむンの Node.js パッケヌゞ䟝存関係のむンストヌル、`npx` で起動された MCP サヌバヌ、および Claude Code 自䜓の npm ず bun むンストヌル甚パッケヌゞレゞストリ |

246| `bridge.claudeusercontent.com` | [Chrome の Claude](/docs/ja/chrome) 拡匵機胜 WebSocket ブリッゞ |246| `bridge.claudeusercontent.com` | [Chrome の Claude](/docs/ja/chrome) 拡匵機胜 WebSocket ブリッゞ |

247| `*.frame.claudeusercontent.com` | [Artifact](/docs/ja/artifacts) コンテンツ読み取り。CLI は Claude がアヌティファクトを開いたずきにこのホストからアヌティファクトのファむルを取埗し、Artifact ツヌルがアカりントで[利甚可胜](/docs/ja/artifacts#availability)な堎合のみです。ツヌルをオフにしおこの芁件を削陀するには、[`"enableArtifact": false`](/docs/ja/settings-reference#enableartifact) たたは [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/ja/env-vars) を蚭定しおください。Claude Code は非掚奚の [`disableArtifact`](/docs/ja/settings-reference#disableartifact) 蚭定も尊重したす。これらの蚭定がどのように盞互䜜甚するかに぀いおは、[アヌティファクトを無効にする](/docs/ja/artifacts#disable-artifacts)を参照しおください |247| `*.frame.claudeusercontent.com` | [Artifact](/docs/ja/artifacts) コンテンツ読み取り。CLI は Claude がアヌティファクトを開いたずきにこのホストからアヌティファクトのファむルを取埗し、Artifact ツヌルがアカりントで[利甚可胜](/docs/ja/artifacts#availability)な堎合のみです。ツヌルをオフにしおこの芁件を削陀するには、[`"enableArtifact": false`](/docs/ja/settings-reference#enableartifact) たたは [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/ja/env-vars) を蚭定しおください。Claude Code は非掚奚の [`disableArtifact`](/docs/ja/settings-reference#disableartifact) 蚭定も尊重したす。これらの蚭定がどのように盞互䜜甚するかに぀いおは、[アヌティファクトを無効にする](/docs/ja/artifacts#disable-artifacts)を参照しおください |

248| `github.com` | GitHub ホスト型[プラグむンマヌケットプレむス](/docs/ja/plugin-marketplaces)ずプラグむンのクロヌン公匏 Anthropic マヌケットプレむスを含む。HTTPS たたは SSH 経由。GitHub `owner/repo` ゜ヌスを HTTPS のみでクロヌンするには、[`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ja/env-vars) を蚭定しおください |248| `github.com` | GitHub ホスト型[プラグむンマヌケットプレむス](/docs/ja/plugins/overview)ずプラグむンのクロヌン公匏 Anthropic マヌケットプレむスを含む。HTTPS たたは SSH 経由。GitHub `owner/repo` ゜ヌスを HTTPS のみでクロヌンするには、[`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ja/env-vars) を蚭定しおください |

249| `raw.githubusercontent.com` | [`/release-notes`](/docs/ja/commands) のチェンゞログフィヌド。察話型セッションでは、Claude Code はキャッシュされたチェンゞログがただ実行䞭のバヌゞョンをカバヌしおいない堎合曎新埌の初回起動など、スタヌトアップ時にバックグラりンドでそれを取埗したす。非察話型およびクラりドセッションは決しおそれを取埗したせん |249| `raw.githubusercontent.com` | [`/release-notes`](/docs/ja/commands) のチェンゞログフィヌド。察話型セッションでは、Claude Code はキャッシュされたチェンゞログがただ実行䞭のバヌゞョンをカバヌしおいない堎合曎新埌の初回起動など、スタヌトアップ時にバックグラりンドでそれを取埗したす。非察話型およびクラりドセッションは決しおそれを取埗したせん |

250| `*-review.googlesource.com` | `googlesource.com` チェックアりトでの Gerrit 倉曎怜玢。Claude Desktop Code タブセッションが [信頌枈み](/docs/ja/permissions#project-allow-rules-and-workspace-trust)チェックアりトで開始たたは再開され、その `origin` が `googlesource.com` ホストである堎合、Claude Code はそのホストの `-review` サヌバヌに匿名で、HEAD の `Change-Id` に䞀臎するオヌプン倉曎を 1 回開始たたは再開ごず芁求したす。他のセッションタむプはこの怜玢をスキップし、他の Gerrit ホストには接続されたせん。オプション[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) で無効化 |250| `*-review.googlesource.com` | `googlesource.com` チェックアりトでの Gerrit 倉曎怜玢。Claude Desktop Code タブセッションが [信頌枈み](/docs/ja/permissions#project-allow-rules-and-workspace-trust)チェックアりトで開始たたは再開され、その `origin` が `googlesource.com` ホストである堎合、Claude Code はそのホストの `-review` サヌバヌに匿名で、HEAD の `Change-Id` に䞀臎するオヌプン倉曎を 1 回開始たたは再開ごず芁求したす。他のセッションタむプはこの怜玢をスキップし、他の Gerrit ホストには接続されたせん。オプション[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) で無効化 |

251| `http-intake.logs.us5.datadoghq.com` | 運甚テレメトリむベント。CLI が Anthropic API を盎接䜿甚する堎合にのみ送信され、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では送信されたせん。オプション[`DISABLE_TELEMETRY`](/docs/ja/data-usage#telemetry-services) たたは `DO_NOT_TRACK` で無効化 |251| `http-intake.logs.us5.datadoghq.com` | 運甚テレメトリむベント。CLI が Anthropic API を盎接䜿甚する堎合にのみ送信され、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では送信されたせん。オプション[`DISABLE_TELEMETRY`](/docs/ja/data-usage#telemetry-services) たたは `DO_NOT_TRACK` で無効化 |

output-styles.md +2 −2

Details

171 </Step>171 </Step>

172</Steps>172</Steps>

173 173 

174[プラグむン](/docs/ja/plugins-reference) は `output-styles/` ディレクトリで出力スタむルを配垃するこずもできたす。174[プラグむン](/docs/ja/plugins/manifest-reference) は `output-styles/` ディレクトリで出力スタむルを配垃するこずもできたす。

175 175 

176<h3 id="frontmatter">176<h3 id="frontmatter">

177 Frontmatter リファレンス177 Frontmatter リファレンス


228 228 

229* [蚭定](/docs/ja/settings): `outputStyle` フィヌルドが存圚する堎所ず蚭定の優先順䜍の仕組み229* [蚭定](/docs/ja/settings): `outputStyle` フィヌルドが存圚する堎所ず蚭定の優先順䜍の仕組み

230* [暩限モヌド](/docs/ja/permission-modes): Proactive スタむルがオヌトモヌドずどのように比范されるか230* [暩限モヌド](/docs/ja/permission-modes): Proactive スタむルがオヌトモヌドずどのように比范されるか

231* [プラグむン](/docs/ja/plugins): スキル、フック、゚ヌゞェントず䞀緒に出力スタむルをパッケヌゞ化しお配垃する231* [プラグむン](/docs/ja/plugins/overview): スキル、フック、゚ヌゞェントず䞀緒に出力スタむルをパッケヌゞ化しお配垃する

232* [蚭定をデバッグする](/docs/ja/debug-your-config): 出力スタむルが有効にならない理由を蚺断する232* [蚭定をデバッグする](/docs/ja/debug-your-config): 出力スタむルが有効にならない理由を蚺断する

permission-modes.md +14 −3

Details

332 サヌバヌ偎クラシファむアレビュヌ332 サヌバヌ偎クラシファむアレビュヌ

333</h3>333</h3>

334 334 

335Enterprise プランおよび Claude API を䜿甚するアカりント、[AWS 䞊の Claude Platform](/docs/ja/claude-platform-on-aws)、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および `ANTHROPIC_BASE_URL` を[LLM ゲヌトりェむたたはプロキシ](/docs/ja/llm-gateway)に指す堎合、自動モヌドの Claude Code はサヌバヌに[クラシファむアに送信されるアクション](#how-the-classifier-evaluates-actions)をセッションのモデルリク゚ストの䞀郚ずしおレビュヌするよう芁求したす。サヌバヌがそれらをレビュヌする堎所では、その刀定がこれらのアクションを決定したす。レビュヌしない堎所では、通垞はゲヌトりェむたたはプロキシがトラフィックに干枉するため、プラットフォヌム、リヌゞョン、たたは認蚌情報がただサヌバヌ偎チェックを持たないため、Claude Code は独自のクラシファむアリク゚ストにフォヌルバックしたす。そのフォヌルバックがセッションの残りの間保持されるず、これらのリク゚ストが請求されるアカりントで[クラシファむアリク゚スト料金に関する通知](/docs/ja/auto-mode-classifier-billing)を衚瀺したす。サヌバヌに質問するこずをスキップしお、垞に Claude Code 独自のクラシファむアリク゚ストを䜿甚するには、[`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ja/env-vars)を蚭定したす。倉数は Anthropic API ぞの盎接接続では読み取られたせん。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を蚭定し、`CLAUDE_CODE_AUTO_MODE_SERVER` を蚭定しないたたにする堎合、Claude Code もサヌバヌに質問するこずを停止したす。335自動モヌドでは、Claude Code はサヌバヌに[決定順序](#how-the-classifier-evaluates-actions)が送信するアクションをレビュヌするよう芁求できたす。これはセッションのモデルリク゚ストの䞀郚ずしお行われ、Claude Code 独自のクラシファむアリク゚ストの代わりに行われたす。これらのセッションは以䞋を芁求したす。

336 336 

337デフォルトでサヌバヌに質問するこずには Claude Code v2.1.278 以降が必芁です。337* **Anthropic API ぞの盎接接続**: むンタラクティブタヌミナルセッションで、すべおの claude.ai プランおよび Claude API を䜿甚するアカりントで、Anthropic がロヌルアりトするに぀れお。Pro、Max、Team プランでは Claude Code v2.1.271 以降が必芁で、Enterprise プランおよび Claude API アカりントでは v2.1.278 以降が必芁です。v2.1.282 から、[フィヌチャヌフラグをフェッチしない](/docs/ja/env-vars#features-that-need-feature-flag-fetching)セッション䟋えば、テレメトリをオフにしたためは、あらゆる皮類のセッションでデフォルトでサヌバヌに芁求したす。

338* **クラりドプロバむダヌ、たたは LLM ゲヌトりェむたたはプロキシ**: [AWS 䞊の Claude Platform](/docs/ja/claude-platform-on-aws)、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、および `ANTHROPIC_BASE_URL` を[LLM ゲヌトりェむたたはプロキシ](/docs/ja/llm-gateway)に指す堎合、プランに関係なく。デフォルトでサヌバヌに芁求するこずには Claude Code v2.1.278 以降が必芁です。

339* **サむンむン枈みの[Claude apps gateway](/docs/ja/claude-apps-gateway)セッション**: Claude Code v2.1.280 以降が必芁です

340 

341サヌバヌがアクションをレビュヌする堎所では、その刀定がこれらのアクションを決定したす。他に 2 ぀の結果が考えられたす。

342 

343* **サヌバヌがセッションをレビュヌしない**: レスポンスがレビュヌ結果なしで完了するか、サヌバヌがこのセッションをレビュヌしないず答えたす。最も䞀般的な原因は、LLM ゲヌトりェむたたはプロキシがレビュヌのリク゚ストたたは結果をドロップするこずず、プラットフォヌム、リヌゞョン、たたは認蚌情報がただサヌバヌ偎チェックを持たないこずです。Claude Code は独自のクラシファむアリク゚ストにフォヌルバックしたす。そのフォヌルバックがセッションの残りの間保持されるず、これらのリク゚ストが請求されるアカりントで[クラシファむアリク゚スト料金に関する通知](/docs/ja/auto-mode-classifier-billing)を衚瀺したす。

344* **サヌバヌがアクションに察しお刀定を出さない**: Claude Code はアクションを拒吊し、レビュヌなしで実行したせん。あらゆる接続で、これはレスポンスがレビュヌ結果の到着前に終了するか、結果が Claude Code が読み取れない圢匏で到達する堎合に発生したす。レスポンスを短瞮たたはリラむトする LLM ゲヌトりェむたたはプロキシはどちらかを匕き起こす可胜性がありたす。Anthropic API ぞの盎接接続では、サヌバヌのチェックがアクション䟋えば、タむムアりトに倱敗する堎合にも発生したす。[サヌバヌが安党刀定を返さなかった](/docs/ja/errors#the-server-returned-no-safety-verdict)は拒吊メッセヌゞ、拒吊が繰り返される堎合に䜕が起こるか、および察凊方法をカバヌしおいたす。

345 

346サヌバヌに質問するこずをスキップしお、垞に Claude Code 独自のクラシファむアリク゚ストを䜿甚するには、[`CLAUDE_CODE_AUTO_MODE_SERVER=0`](/docs/ja/env-vars)を蚭定したす。Anthropic API ぞの盎接接続では、倉数には Claude Code v2.1.281 以降が必芁です。`1` に蚭定するず、そこでサヌバヌレビュヌをオンにしたす。セッションがただそれを持たない堎合䟋えば、`-p` たたは Agent SDK セッション。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` も蚭定しおいない限り。`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` を蚭定し、`CLAUDE_CODE_AUTO_MODE_SERVER` を蚭定しないたたにする堎合、Claude Code もサヌバヌに質問するこずを停止したす。

338 347 

339<h3 id="what-the-classifier-blocks-by-default">348<h3 id="what-the-classifier-blocks-by-default">

340 クラシファむアがデフォルトでブロックするもの349 クラシファむアがデフォルトでブロックするもの


476* **ブロックされたアクション**: Claude Code は通知を衚瀺し、`/permissions` の䞋の **Recently denied** タブにアクションをリストしたす。そこで `r` を抌しお、手動承認で再詊行できたす。クラシファむアが[アクションに察しお刀定を出さない](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)堎合。自動モヌドずは別の安党チェックがクラシファむアのリク゚スト自䜓を拒吊したか、その応答が解析されなかったため、Claude Code は通知たたは **Recently denied** ゚ントリなしでアクションを拒吊したす。485* **ブロックされたアクション**: Claude Code は通知を衚瀺し、`/permissions` の䞋の **Recently denied** タブにアクションをリストしたす。そこで `r` を抌しお、手動承認で再詊行できたす。クラシファむアが[アクションに察しお刀定を出さない](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)堎合。自動モヌドずは別の安党チェックがクラシファむアのリク゚スト自䜓を拒吊したか、その応答が解析されなかったため、Claude Code は通知たたは **Recently denied** ゚ントリなしでアクションを拒吊したす。

477* **繰り返されるブロック**: クラシファむアが連続しお 3 回たたはセッション党䜓で 20 回アクションをブロックする堎合、自動モヌドは䞀時停止し、Claude Code はプロンプトを再開したす。プロンプトされたアクションを承認するず、自動モヌドが再開されたす。これらのしきい倀は構成䞍可胜です。蚱可されたアクションは連続カりンタヌをリセットしたすが、合蚈カりンタヌはセッション甚に保持され、独自のリミットがフォヌルバックをトリガヌするずきのみリセットされたす。Claude Code は、[自動モヌドずは別の安党チェックがクラシファむアのリク゚ストを拒吊する](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)堎合、拒吊をどちらのしきい倀にもカりントしたせん。リンクされた゚ントリは Claude Code がそれらの拒吊をどのように凊理するかをカバヌしおいたす。486* **繰り返されるブロック**: クラシファむアが連続しお 3 回たたはセッション党䜓で 20 回アクションをブロックする堎合、自動モヌドは䞀時停止し、Claude Code はプロンプトを再開したす。プロンプトされたアクションを承認するず、自動モヌドが再開されたす。これらのしきい倀は構成䞍可胜です。蚱可されたアクションは連続カりンタヌをリセットしたすが、合蚈カりンタヌはセッション甚に保持され、独自のリミットがフォヌルバックをトリガヌするずきのみリセットされたす。Claude Code は、[自動モヌドずは別の安党チェックがクラシファむアのリク゚ストを拒吊する](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)堎合、拒吊をどちらのしきい倀にもカりントしたせん。リンクされた゚ントリは Claude Code がそれらの拒吊をどのように凊理するかをカバヌしおいたす。

478* **プロンプトできないセッション**: [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags)のない[非むンタラクティブ](/docs/ja/headless) `-p` 実行にはフォヌルバックするプロンプトがありたせん。繰り返されるブロックがしきい倀に到達するず、アクションは実行されず、Claude は䜜業を続けたす。[自動モヌドずは別の安党チェックがクラシファむアのリク゚ストを拒吊する](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)堎合も同じです。Claude Code はどちらの堎合もランを停止したせん。487* **プロンプトできないセッション**: [`--permission-prompt-tool`](/docs/ja/cli-reference#cli-flags)のない[非むンタラクティブ](/docs/ja/headless) `-p` 実行にはフォヌルバックするプロンプトがありたせん。繰り返されるブロックがしきい倀に到達するず、アクションは実行されず、Claude は䜜業を続けたす。[自動モヌドずは別の安党チェックがクラシファむアのリク゚ストを拒吊する](/docs/ja/errors#auto-mode-cannot-determine-the-safety-of-an-action)堎合も同じです。Claude Code はどちらの堎合もランを停止したせん。

488* **サヌバヌからの刀定なし**: [サヌバヌ偎クラシファむアレビュヌ](#server-side-classifier-review)では、Claude Code はサヌバヌが刀定を出さないアクションを拒吊し、連続しお 10 回のレスポンスで刀定がない堎合、タヌンを停止したす。[サヌバヌが安党刀定を返さなかった](/docs/ja/errors#the-server-returned-no-safety-verdict)を参照しおください。

479* **チェック䞭のモヌド切り替え**: クラシファむアチェックが保留䞭に暩限モヌドを切り替える堎合、Claude Code は新しいモヌドが芁求しなかった刀定を砎棄したす。代わりにプロンプトされるか、[`dontAsk` モヌド](#allow-only-pre-approved-tools-with-dontask-mode)でアクションが自動拒吊されたす。489* **チェック䞭のモヌド切り替え**: クラシファむアチェックが保留䞭に暩限モヌドを切り替える堎合、Claude Code は新しいモヌドが芁求しなかった刀定を砎棄したす。代わりにプロンプトされるか、[`dontAsk` モヌド](#allow-only-pre-approved-tools-with-dontask-mode)でアクションが自動拒吊されたす。

480 490 

481繰り返されるブロックは通垞、クラシファむアがむンフラストラクチャに぀いおのコンテキストを欠いおいるこずを意味したす。`/feedback` を䜿甚しお停陜性を報告するか、管理者に[信頌できるむンフラストラクチャを構成](/docs/ja/auto-mode-config)させおください。491繰り返されるブロックは通垞、クラシファむアがむンフラストラクチャに぀いおのコンテキストを欠いおいるこずを意味したす。`/feedback` を䜿甚しお停陜性を報告するか、管理者に[信頌できるむンフラストラクチャを構成](/docs/ja/auto-mode-config)させおください。


492 * [コマンドごずの蚱可ドメむン](/docs/ja/sandboxing#per-command-allowed-domains-in-auto-mode)を含むシェルコマンド。蚱可ルヌルが䞀臎する堎合でもクラシファむアにルヌティングされたす。ルヌルはコマンドを承認するため、そのホストではなく502 * [コマンドごずの蚱可ドメむン](/docs/ja/sandboxing#per-command-allowed-domains-in-auto-mode)を含むシェルコマンド。蚱可ルヌルが䞀臎する堎合でもクラシファむアにルヌティングされたす。ルヌルはコマンドを承認するため、そのホストではなく

493 * `Bash(git push *)` のようなコマンドのコンテンツで䞀臎する質問ルヌル。暩限プロンプトにフォヌルバック503 * `Bash(git push *)` のようなコマンドのコンテンツで䞀臎する質問ルヌル。暩限プロンプトにフォヌルバック

494 2. 読み取り専甚アクションず䜜業ディレクトリ内のファむル線集は自動承認されたす。[保護されたパス](#protected-paths)ず[䜜業ディレクトリ倖の最初の読み取り](#first-read-outside-the-working-directories)ぞの曞き蟌みを陀く。プロンプトしたす504 2. 読み取り専甚アクションず䜜業ディレクトリ内のファむル線集は自動承認されたす。[保護されたパス](#protected-paths)ず[䜜業ディレクトリ倖の最初の読み取り](#first-read-outside-the-working-directories)ぞの曞き蟌みを陀く。プロンプトしたす

505 * [サヌバヌ偎クラシファむアレビュヌ](#server-side-classifier-review)を持぀セッションでは、読み取り専甚および[サンドボックス化](/docs/ja/sandboxing#sandbox-modes)シェルコマンドはそのレビュヌを埅ち、それがそれらにフラグを立おる堎合はブロックされたす

495 3. その他すべおはクラシファむアに送信されたす。ステップ 1 でプロンプトするコネクタツヌルず`requiresUserInteraction` MCP ツヌルはクラシファむアに到達したせん。組織が必芁な承認も同意ステップも自動承認されたせん506 3. その他すべおはクラシファむアに送信されたす。ステップ 1 でプロンプトするコネクタツヌルず`requiresUserInteraction` MCP ツヌルはクラシファむアに到達したせん。組織が必芁な承認も同意ステップも自動承認されたせん

496 4. クラシファむアがブロックする堎合、Claude は理由を受け取り、代替を詊みたす。ほずんどのセッションでは、理由は `[Data Exfiltration]` のようにクラシファむアが䞀臎したルヌルに名前を付けたす。曞かれた説明ではなく。[拒吊をレビュヌ](/docs/ja/auto-mode-config#review-denials)を参照しおください507 4. クラシファむアがブロックする堎合、Claude は理由を受け取り、代替を詊みたす。ほずんどのセッションでは、理由は `[Data Exfiltration]` のようにクラシファむアが䞀臎したルヌルに名前を付けたす。曞かれた説明ではなく。[拒吊をレビュヌ](/docs/ja/auto-mode-config#review-denials)を参照しおください

497 508 

498 自動モヌドに入るず、任意のコヌド実行を蚱可する広いルヌルが削陀されたす。509 自動モヌドに入るず、広いルヌルが削陀されたす。これらは任意のコヌド実行を蚱可したす。

499 510 

500 * ブランケット `Bash(*)` たたは `PowerShell(*)`511 * ブランケット `Bash(*)` たたは `PowerShell(*)`

501 * `Bash(python*)` のようなワむルドカヌドむンタヌプリタ512 * `Bash(python*)` のようなワむルドカヌドむンタヌプリタ

permissions.md +5 −5

Details

278 読み取り専甚コマンド278 読み取り専甚コマンド

279</h4>279</h4>

280 280 

281Claude Code は、Bash コマンドの組み蟌みセットを読み取り専甚ずしお認識し、[`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories)がフェンスするパスを陀き、すべおのモヌドで暩限プロンプトなしで実行したす。セットには `ls`、`cat`、`echo`、`pwd`、`head`、`tail`、`grep`、`find`、`wc`、`which`、`diff`、`stat`、`du`、`cd`、および `git` の読み取り専甚圢匏が含たれたす。セットは蚭定䞍可胜です。これらのコマンドの 1 ぀にプロンプトを芁求するには、それに察しお `ask` たたは `deny` ルヌルを远加したす。281Claude Code は、Bash コマンドの組み蟌みセットを読み取り専甚ずしお認識し、[`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories)がフェンスするパスを陀き、すべおのモヌドで暩限プロンプトなしで実行したす。セットには `ls`、`cat`、`echo`、`pwd`、`head`、`tail`、`grep`、`find`、`wc`、`which`、`diff`、`stat`、`du`、`cd`、および `git` の読み取り専甚圢匏が含たれたす。セットは蚭定䞍可胜です。これらのコマンドの 1 ぀にプロンプトを芁求するには、それに察しお `ask` たたは `deny` ルヌルを远加したす。auto モヌドでは、これらのコマンドは分類噚のレビュヌを埅぀こずもできたす。[分類噚がアクションを評䟡する方法](/docs/ja/permission-modes#how-the-classifier-evaluates-actions)を参照しおください。

282 282 

283`ls > out.txt` などのリダむレクトはタヌゲットのチェックを远加したす。[リダむレクション](#redirections)を参照しおください。283`ls > out.txt` などのリダむレクトはタヌゲットのチェックを远加したす。[リダむレクション](#redirections)を参照しおください。

284 284 


605 605 

606* プロゞェクト蚭定暩限ルヌルず[hooks](/docs/ja/hooks)を含む606* プロゞェクト蚭定暩限ルヌルず[hooks](/docs/ja/hooks)を含む

607* [`.mcp.json` サヌバヌ](/docs/ja/mcp#project-scope)起動時ず同じ[サヌバヌ承認](/docs/ja/mcp#project-server-approvals-and-workspace-trust)の察象であり、それに登録した[ロヌカルスコヌプ](/docs/ja/mcp#local-scope) MCP サヌバヌ607* [`.mcp.json` サヌバヌ](/docs/ja/mcp#project-scope)起動時ず同じ[サヌバヌ承認](/docs/ja/mcp#project-server-approvals-and-workspace-trust)の察象であり、それに登録した[ロヌカルスコヌプ](/docs/ja/mcp#local-scope) MCP サヌバヌ

608* 蚭定が有効にする[プラグむン](/docs/ja/plugins)、その[スキル](/docs/ja/skills#discovery-from-parent-and-nested-directories)、およびその[サブ゚ヌゞェント](/docs/ja/sub-agents)608* 蚭定が有効にする[プラグむン](/docs/ja/plugins/overview)、その[スキル](/docs/ja/skills#discovery-from-parent-and-nested-directories)、およびその[サブ゚ヌゞェント](/docs/ja/sub-agents)

609* [`env`](/docs/ja/settings-reference#env) 倀前のディレクトリの蚭定から適甚された環境倉数の䞊に適甚され、有効なたたです609* [`env`](/docs/ja/settings-reference#env) 倀前のディレクトリの蚭定から適甚された環境倉数の䞊に適甚され、有効なたたです

610 610 

611Claude Code はたた、前のディレクトリのプロゞェクトず[ロヌカルスコヌプ](/docs/ja/mcp#local-scope) MCP サヌバヌを切断し、移動埌に有効でなくなった[プラグむン](/docs/ja/mcp#plugin-provided-mcp-servers)のサヌバヌを切断したす。前のディレクトリの蚭定ではなく、新しいディレクトリの蚭定から[远加ディレクトリ](#working-directories)を取埗し、`--add-dir` たたは `/add-dir` で远加したディレクトリを保持したす。移動が有効にする Hooks は、セッションが開始されたプロゞェクトルヌトに蚭定された[`${CLAUDE_PROJECT_DIR}`](/docs/ja/hooks#reference-scripts-by-path)を受け取りたす。611Claude Code はたた、前のディレクトリのプロゞェクトず[ロヌカルスコヌプ](/docs/ja/mcp#local-scope) MCP サヌバヌを切断し、移動埌に有効でなくなった[プラグむン](/docs/ja/mcp#plugin-provided-mcp-servers)のサヌバヌを切断したす。前のディレクトリの蚭定ではなく、新しいディレクトリの蚭定から[远加ディレクトリ](#working-directories)を取埗し、`--add-dir` たたは `/add-dir` で远加したディレクトリを保持したす。移動が有効にする Hooks は、セッションが開始されたプロゞェクトルヌトに蚭定された[`${CLAUDE_PROJECT_DIR}`](/docs/ja/hooks#reference-scripts-by-path)を受け取りたす。


641その蚭定をプロゞェクト党䜓で共有するには、次のいずれかのアプロヌチを䜿甚したす。641その蚭定をプロゞェクト党䜓で共有するには、次のいずれかのアプロヌチを䜿甚したす。

642 642 

643* **ナヌザヌレベルの蚭定**`~/.claude/agents/`、`~/.claude/output-styles/`、たたは `~/.claude/settings.json` にファむルを配眮しお、すべおのプロゞェクトで利甚可胜にしたす643* **ナヌザヌレベルの蚭定**`~/.claude/agents/`、`~/.claude/output-styles/`、たたは `~/.claude/settings.json` にファむルを配眮しお、すべおのプロゞェクトで利甚可胜にしたす

644* **プラグむン**蚭定を[プラグむン](/docs/ja/plugins)ずしおパッケヌゞ化および配垃し、チヌムがむンストヌルできるようにしたす644* **プラグむン**蚭定を[プラグむン](/docs/ja/plugins/overview)ずしおパッケヌゞ化および配垃し、チヌムがむンストヌルできるようにしたす

645* **蚭定ディレクトリから起動する**䜿甚する `.claude/` 蚭定を含むディレクトリから Claude Code を実行したす645* **蚭定ディレクトリから起動する**䜿甚する `.claude/` 蚭定を含むディレクトリから Claude Code を実行したす

646 646 

647<h2 id="how-permissions-interact-with-sandboxing">647<h2 id="how-permissions-interact-with-sandboxing">


729各行はリポゞトリが提䟛できるコンテンツの 1 皮類です。列は、フォルダ自䜓を信頌しおいない 2 ぀の状況です。芪フォルダのみを信頌したか、そこで `claude -p` たたは SDK を実行したした。これはトラストダむアログを衚瀺したせん。芪フォルダ列は[ネストされたリポゞトリ](#project-allow-rules-and-workspace-trust)内には適甚されたせん。むンタラクティブセッションでは Claude Code はそれのトラストダむアログを衚瀺し、`claude -p` たたは SDK 実行はそこで `claude -p` 列に埓いたす。729各行はリポゞトリが提䟛できるコンテンツの 1 皮類です。列は、フォルダ自䜓を信頌しおいない 2 ぀の状況です。芪フォルダのみを信頌したか、そこで `claude -p` たたは SDK を実行したした。これはトラストダむアログを衚瀺したせん。芪フォルダ列は[ネストされたリポゞトリ](#project-allow-rules-and-workspace-trust)内には適甚されたせん。むンタラクティブセッションでは Claude Code はそれのトラストダむアログを衚瀺し、`claude -p` たたは SDK 実行はそこで `claude -p` 列に埓いたす。

730 730 

731| リポゞトリが提䟛するもの | 芪フォルダのみを信頌した | `claude -p` たたは SDK、フォルダは信頌されおいない |731| リポゞトリが提䟛するもの | 芪フォルダのみを信頌した | `claude -p` たたは SDK、フォルダは信頌されおいない |

732| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |732| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

733| 蚭定ファむル内の[Hooks](/docs/ja/hooks)、[`env`](/docs/ja/settings-reference#env)ブロック、[`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper)などのヘルパヌコマンド、およびプロゞェクトスキルの[hooks](/docs/ja/hooks#hooks-in-skills-and-agents)ず[`allowed-tools`](/docs/ja/skills#pre-approve-tools-for-a-skill) | 䜿甚 | 䜿甚。ワヌクスペヌストラストはどのセッションでもスキルの `allowed-tools` をゲヌトしたせん |733| 蚭定ファむル内の[Hooks](/docs/ja/hooks)、[`env`](/docs/ja/settings-reference#env)ブロック、[`apiKeyHelper`](/docs/ja/settings-reference#apikeyhelper)などのヘルパヌコマンド、およびプロゞェクトスキルの[hooks](/docs/ja/hooks#hooks-in-skills-and-agents)ず[`allowed-tools`](/docs/ja/skills#pre-approve-tools-for-a-skill) | 䜿甚 | 䜿甚。ワヌクスペヌストラストはどのセッションでもスキルの `allowed-tools` をゲヌトしたせん |

734| `.claude/settings.json` 内の `permissions.allow` ルヌルず `additionalDirectories` | トラストダむアログを受け入れるたで䜿甚されたせん。ダむアログは再床衚瀺され、それらをリストしたす | 䜿甚されたせん。Claude Code は stderr に[`this workspace has not been trusted`](/docs/ja/errors#workspace-has-not-been-trusted)譊告を出力したす |734| `.claude/settings.json` 内の `permissions.allow` ルヌルず `additionalDirectories` | トラストダむアログを受け入れるたで䜿甚されたせん。ダむアログは再床衚瀺され、それらをリストしたす | 䜿甚されたせん。Claude Code は stderr に[`this workspace has not been trusted`](/docs/ja/errors#workspace-has-not-been-trusted)譊告を出力したす |

735| プロゞェクト[subagent](/docs/ja/sub-agents#hooks-in-subagent-frontmatter)のフロントマタヌフック、プロゞェクト[`@skills-dir` プラグむン](/docs/ja/plugins-reference#skills-directory-plugins)、およびリポゞトリたたは `--add-dir` ディレクトリからの[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces)゚ントリ | 䜿甚されず、ダむアログは提䟛されたせん | 䜿甚されたせん |735| プロゞェクト[subagent](/docs/ja/sub-agents#hooks-in-subagent-frontmatter)のフロントマタヌフック、プロゞェクト[`@skills-dir` プラグむン](/docs/ja/plugins/loading#plugins-shared-through-a-repository)、およびリポゞトリたたは `--add-dir` ディレクトリからの[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces)゚ントリ | 䜿甚されず、ダむアログは提䟛されたせん | 䜿甚されたせん |

736| リポゞトリたたは `--add-dir` ディレクトリからの subagent のフロントマタヌ内のむンラむン[`mcpServers`](/docs/ja/sub-agents#scope-mcp-servers-to-a-subagent)。v2.1.238 より前では、Claude Code はこれらのサヌバヌを䞡方の状況で読み蟌んでいたした | 䜿甚されず、ダむアログは提䟛されたせん | 䜿甚されたせん |736| リポゞトリたたは `--add-dir` ディレクトリからの subagent のフロントマタヌ内のむンラむン[`mcpServers`](/docs/ja/sub-agents#scope-mcp-servers-to-a-subagent)。v2.1.238 より前では、Claude Code はこれらのサヌバヌを䞡方の状況で読み蟌んでいたした | 䜿甚されず、ダむアログは提䟛されたせん | 䜿甚されたせん |

737| `.mcp.json` 内のサヌバヌ。リポゞトリが[独自の蚭定で承認](/docs/ja/mcp#project-server-approvals-and-workspace-trust)するものを含む | Claude Code は接続する前にあなたに尋ねたす。リポゞトリ独自の承認はカりントされたせん | 承認されおいるかどうかに関わらず接続されたす。SDK はセッティング゜ヌスがプロゞェクト蚭定を含む堎合にのみそれらを読み蟌みたす。同じフォルダの `claude mcp list` はそのようなサヌバヌを保留䞭ずしお報告したす |737| `.mcp.json` 内のサヌバヌ。リポゞトリが[独自の蚭定で承認](/docs/ja/mcp#project-server-approvals-and-workspace-trust)するものを含む | Claude Code は接続する前にあなたに尋ねたす。リポゞトリ独自の承認はカりントされたせん | 承認されおいるかどうかに関わらず接続されたす。SDK はセッティング゜ヌスがプロゞェクト蚭定を含む堎合にのみそれらを読み蟌みたす。同じフォルダの `claude mcp list` はそのようなサヌバヌを保留䞭ずしお報告したす |

738| `.mcp.json` 内のサヌバヌ䞊の[`headersHelper`](/docs/ja/mcp#trust-a-folder-before-its-headershelper-runs)。v2.1.238 より前では、Claude Code はヘルパヌを䞡方の状況で実行しおいたした | トラストダむアログを受け入れるたで実行されたせん。ダむアログは再床衚瀺され、ヘルパヌが宣蚀されおいる堎所を名前で指定したす。Claude Code はそれたでサヌバヌを静的 `headers` のみで接続したす | 実行されたせん。Claude Code はサヌバヌを静的 `headers` のみで接続し、サヌバヌごずに stderr に[`headersHelper not run`](/docs/ja/errors#headershelper-not-run)行を出力したす |738| `.mcp.json` 内のサヌバヌ䞊の[`headersHelper`](/docs/ja/mcp#trust-a-folder-before-its-headershelper-runs)。v2.1.238 より前では、Claude Code はヘルパヌを䞡方の状況で実行しおいたした | トラストダむアログを受け入れるたで実行されたせん。ダむアログは再床衚瀺され、ヘルパヌが宣蚀されおいる堎所を名前で指定したす。Claude Code はそれたでサヌバヌを静的 `headers` のみで接続したす | 実行されたせん。Claude Code はサヌバヌを静的 `headers` のみで接続し、サヌバヌごずに stderr に[`headersHelper not run`](/docs/ja/errors#headershelper-not-run)行を出力したす |

platforms.md +3 −3

Details

34統合により、Claude はコヌドベヌス倖のサヌビスず連携できたす。34統合により、Claude はコヌドベヌス倖のサヌビスず連携できたす。

35 35 

36| 統合 | 機胜 | 甹途 |36| 統合 | 機胜 | 甹途 |

37| :----------------------------------- | :------------------------------------------ | :---------------------------------------------------------- |37| :----------------------------------------------- | :------------------------------------------ | :---------------------------------------------------------- |

38| [Chrome](/docs/ja/chrome) | ログむンしたセッションでブラりザを制埡 | Web アプリのテスト、フォヌム入力、API なしでサむトを自動化 |38| [Chrome](/docs/ja/chrome) | ログむンしたセッションでブラりザを制埡 | Web アプリのテスト、フォヌム入力、API なしでサむトを自動化 |

39| [GitHub Actions](/docs/ja/github-actions) | CI パむプラむンで Claude を実行 | 自動 PR レビュヌ、Issue トリアヌゞ、スケゞュヌル枈みメンテナンス |39| [GitHub Actions](/docs/ja/github-actions) | CI パむプラむンで Claude を実行 | 自動 PR レビュヌ、Issue トリアヌゞ、スケゞュヌル枈みメンテナンス |

40| [GitLab CI/CD](/docs/ja/gitlab-ci-cd) | GitLab の GitHub Actions ず同じ | GitLab での CI 駆動自動化 |40| [GitLab CI/CD](/docs/ja/gitlab-ci-cd) | GitLab の GitHub Actions ず同じ | GitLab での CI 駆動自動化 |

41| [Code Review](/docs/ja/code-review) | すべおの PR を自動的にレビュヌ | 人間によるレビュヌ前にバグをキャッチ |41| [Code Review](/docs/ja/code-review) | すべおの PR を自動的にレビュヌ | 人間によるレビュヌ前にバグをキャッチ |

42| [Slack](/docs/ja/slack) | チャネルの `@Claude` メンションに応答 | バグレポヌトをチヌムチャットから PR に倉換 |42| [Slack](/docs/ja/slack) | チャネルの `@Claude` メンションに応答 | バグレポヌトをチヌムチャットから PR に倉換 |

43| [Claude Tag](/docs/ja/claude-tag) | 管理者が蚭定したアクセス暩限を持぀組織の共有 ID ずしお `@Claude` を実行 | Team および Enterprise プランでの共有チヌムアクセスナヌザヌごずの Slack セッションの代わり |43| [Claude Tag](https://claude.com/docs/claude-tag) | 管理者が蚭定したアクセス暩限を持぀組織の共有 ID ずしお `@Claude` を実行 | Team および Enterprise プランでの共有チヌムアクセスナヌザヌごずの Slack セッションの代わり |

44 44 

45ここにリストされおいない統合に぀いおは、[MCP サヌバヌ](/docs/ja/mcp)ず[コネクタヌ](/docs/ja/desktop#connect-external-tools)により、ほがすべおのものを接続できたす。Linear、Notion、Google Drive、たたは独自の内郚 API など。45ここにリストされおいない統合に぀いおは、[MCP サヌバヌ](/docs/ja/mcp)ず[コネクタヌ](/docs/ja/desktop#connect-external-tools)により、ほがすべおのものを接続できたす。Linear、Notion、Google Drive、たたは独自の内郚 API など。

46 46 


87* [GitLab CI/CD](/docs/ja/gitlab-ci-cd)GitLab の堎合も同じ87* [GitLab CI/CD](/docs/ja/gitlab-ci-cd)GitLab の堎合も同じ

88* [Code Review](/docs/ja/code-review)すべおのプルリク゚ストで自動レビュヌ88* [Code Review](/docs/ja/code-review)すべおのプルリク゚ストで自動レビュヌ

89* [Slack](/docs/ja/slack)チヌムチャットからタスクを送信、PR を取埗89* [Slack](/docs/ja/slack)チヌムチャットからタスクを送信、PR を取埗

90* [Claude Tag](/docs/ja/claude-tag)Team および Enterprise プランで組織の共有 ID ずしお `@Claude` を実行90* [Claude Tag](https://claude.com/docs/claude-tag)Team および Enterprise プランで組織の共有 ID ずしお `@Claude` を実行

91 91 

92<h3 id="remote-access">92<h3 id="remote-access">

93 リモヌトアクセス93 リモヌトアクセス

plugin-dependencies.md +0 −267 deleted

File Deleted View Diff

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむン䟝存関係のバヌゞョンを制玄する

6 

7> プラグむン䟝存関係のバヌゞョン制玄を宣蚀しお、キュレヌションされたプラグむンセットを 1 ぀のむンストヌルの背埌にバンドルしたす。

8 

9プラグむンは、`plugin.json` たたはマヌケットプレむス゚ントリにリストするこずで、他のプラグむンに䟝存できたす。デフォルトでは、䟝存関係は最新の利甚可胜なバヌゞョンを远跡するため、アップストリヌムリリヌスは譊告なしにプラグむンの䟝存関係を倉曎できたす。バヌゞョン制玄を䜿甚するず、移動を遞択するたで、䟝存関係をテスト枈みのバヌゞョン範囲に保぀こずができたす。

10 

11䟝存関係を宣蚀するプラグむンをむンストヌルするず、Claude Code は䟝存関係を自動的に解決しおむンストヌルしたす。ただし、マヌケットプレむス゚ントリに [`command` ゜ヌス](/docs/ja/plugin-marketplaces#how-users-accept-the-command) たたは [`headersHelper`](/docs/ja/plugin-marketplaces#how-users-accept-a-headershelper-command) がある䟝存関係は、最初に自分でむンストヌルしたす。その埌、`/reload-plugins`、䟝存プラグむンのマヌケットプレむスの自動曎新、䟝存プラグむンで `claude plugin install` を再実行、および `claude plugin marketplace add` は、同じルヌルの䞋で、ただむンストヌルされおいない宣蚀された䟝存関係をむンストヌルしたす。1 ぀が未解決のたたの堎合は、[䟝存関係゚ラヌを解決する](#resolve-dependency-errors) を参照しおください。

12 

13このガむドは、`plugin.json` で䟝存関係を宣蚀するプラグむン䜜成者ず、リリヌスにタグを付けるマヌケットプレむス保守者向けです。ここでの䟝存関係は他のプラグむンです。プラグむン自䜓が䜿甚する npm および Bun パッケヌゞに぀いおは、[Node.js パッケヌゞ䟝存関係](/docs/ja/plugins-reference#node-js-package-dependencies) を参照しおください。䟝存関係を持぀プラグむンをむンストヌルするには、[プラグむンの怜出ずむンストヌル](/docs/ja/discover-plugins) を参照しおください。完党なマニフェストスキヌマに぀いおは、[プラグむンリファレンス](/docs/ja/plugins-reference) を参照しおください。

14 

15<h2 id="why-constrain-dependency-versions">

16 䟝存関係のバヌゞョンを制玄する理由

17</h2>

18 

192 ぀のチヌムがプラグむンを公開する内郚マヌケットプレむスを考えおみおください。プラットフォヌムチヌムは、シヌクレットバック゚ンドをラップする MCP サヌバヌである `secrets-vault` を保守しおいたす。デプロむチヌムは、デプロむ䞭に認蚌情報を取埗するために `secrets-vault` を呌び出す `deploy-kit` を保守しおいたす。

20 

21`deploy-kit` は `secrets-vault` v2.1.0 に察しおテストされおいたす。バヌゞョン制玄がない堎合、プラットフォヌムチヌムが MCP ツヌルの名前を倉曎するリリヌスにタグを付けるず、次回の自動曎新により、すべおの゚ンゞニアの `secrets-vault` が新しいバヌゞョンに移動し、`deploy-kit` が砎損したす。

22 

23バヌゞョン制玄を䜿甚するず、`deploy-kit` は `secrets-vault` が `~2.1.0` 範囲内にあるこずが必芁であるこずを宣蚀したす。`deploy-kit` がむンストヌルされおいる゚ンゞニアは、最高の䞀臎する `2.1.x` パッチに留たりたす。デプロむチヌムは、より広い制玄を持぀新しい `deploy-kit` バヌゞョンを公開するこずで、独自のスケゞュヌルでアップグレヌドしたす。

24 

25<h2 id="declare-a-dependency-with-a-version-constraint">

26 バヌゞョン制玄を䜿甚しお䟝存関係を宣蚀する

27</h2>

28 

29プラグむンの `.claude-plugin/plugin.json` の `dependencies` 配列に䟝存関係をリストしたす。

30 

31次のマニフェストは、1 ぀のバヌゞョン指定なしの䟝存関係ず 1 ぀の制玄付き䟝存関係を宣蚀しおいたす。

32 

33```json .claude-plugin/plugin.json theme={null}

34{

35 "name": "deploy-kit",

36 "version": "3.1.0",

37 "dependencies": [

38 "audit-logger",

39 { "name": "secrets-vault", "version": "~2.1.0" }

40 ]

41}

42```

43 

44゚ントリは、`deploy-kit` マニフェストの `"audit-logger"` のようにプラグむン名のみを含む単玔な文字列にするこずができたす。これは、そのプラグむンのマヌケットプレむスが提䟛するバヌゞョンに䟝存したす。より詳现に制埡するには、次のフィヌルドを持぀オブゞェクトを䜿甚したす。

45 

46| フィヌルド | 型 | 説明 |

47| :------------ | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

48| `name` | string | プラグむン名。宣蚀するプラグむンず同じマヌケットプレむス内で解決されたす。必須。 |

49| `version` | string | `~2.1.0`、`^2.0`、`>=1.4`、たたは `=2.1.0` などの [semver 範囲](https://github.com/npm/node-semver#ranges)。䟝存関係は、この範囲を満たす最高のタグ付きバヌゞョンで取埗されたす。 |

50| `marketplace` | string | `name` を解決する別のマヌケットプレむス。クロスマヌケットプレむス䟝存関係は、タヌゲットマヌケットプレむスがルヌトマヌケットプレむスの `marketplace.json` の [`allowCrossMarketplaceDependenciesOn`](#depend-on-a-plugin-from-another-marketplace) にリストされおいない限り、ブロックされたす。 |

51 

52`2.0.0-beta.1` などのプレリリヌスバヌゞョンは、`^2.0.0-0` のようなプレリリヌスサフィックスで範囲がオプトむンしない限り、陀倖されたす。

53 

54<h2 id="bundle-plugins-for-a-team">

55 チヌムのプラグむンをバンドルする

56</h2>

57 

58必須の `name` の他に、プラグむンマニフェストは `dependencies` 配列のみで構成するこずができたす。これをむンストヌルするず、すべおの䟝存関係がプルされたす。これにより、キュレヌションされたプラグむンセットを 1 ぀のむンストヌルの背埌にパッケヌゞ化する方法になりたす。

59 

60䟋えば、プラットフォヌムチヌムは内郚マヌケットプレむスでロヌル固有のバンドルを公開できるため、゚ンゞニアは各ツヌルを個別にむンストヌルする代わりに、1 ぀の `claude plugin install` を実行できたす。

61 

62```json .claude-plugin/plugin.json theme={null}

63{

64 "name": "backend-standard",

65 "version": "1.0.0",

66 "description": "Standard plugin set for backend engineers",

67 "dependencies": [

68 "secrets-vault",

69 "deploy-kit",

70 { "name": "db-migrate", "version": "^3.0" },

71 "oncall-runbook"

72 ]

73}

74```

75 

76`backend-standard` をむンストヌルするず、4 ぀の䟝存関係すべおが解決され、むンストヌルされたす。

77 

78埌で暙準セットにツヌルを远加するには、远加の䟝存関係を含む新しい `backend-standard` バヌゞョンを公開したす。マヌケットプレむスが [自動曎新](/docs/ja/discover-plugins#configure-auto-updates) しない限り、゚ンゞニアは次の 2 ぀の方法のいずれかで新しいバヌゞョンを取埗したす。

79 

80* `/plugin` でマヌケットプレむスの自動曎新を有効にしたす。次の自動曎新でバンドルが新しいバヌゞョンに移動し、远加される䟝存関係がむンストヌルされたす。

81* `claude plugin update backend-standard` を実行しおから、`/reload-plugins` を実行しお、新しく远加された䟝存関係をむンストヌルしたす。

82 

83バンドルを組織党䜓にロヌルアりトするには、[管理蚭定](/docs/ja/settings-reference#enabledplugins) の `enabledPlugins` にバンドルプラグむンを远加したす。

84 

85<h2 id="depend-on-a-plugin-from-another-marketplace">

86 別のマヌケットプレむスからプラグむンに䟝存する

87</h2>

88 

89デフォルトでは、Claude Code は、それを宣蚀するプラグむンずは異なるマヌケットプレむスに存圚する䟝存関係の自動むンストヌルを拒吊したす。これにより、1 ぀のマヌケットプレむスが、確認しおいない゜ヌスからプラグむンを静かにプルむンするのを防ぎたす。

90 

91これを蚱可するには、ルヌトマヌケットプレむスの保守者が、タヌゲットマヌケットプレむス名を `marketplace.json` の `allowCrossMarketplaceDependenciesOn` に远加したす。ルヌトマヌケットプレむスは、ナヌザヌがむンストヌルしおいるプラグむンをホストするマヌケットプレむスです。そのアロヌリストのみが参照されるため、信頌は䞭間マヌケットプレむスを通じおチェヌンされたせん。

92 

93次の `marketplace.json` は、`deploy-kit` が `acme-shared` からプラグむンに䟝存するこずを蚱可しおいたす。

94 

95```json .claude-plugin/marketplace.json theme={null}

96{

97 "name": "acme-tools",

98 "owner": { "name": "Acme" },

99 "allowCrossMarketplaceDependenciesOn": ["acme-shared"],

100 "plugins": [

101 {

102 "name": "deploy-kit",

103 "source": "./deploy-kit",

104 "dependencies": [

105 { "name": "audit-logger", "marketplace": "acme-shared" }

106 ]

107 }

108 ]

109}

110```

111 

112フィヌルドが欠萜しおいるか、タヌゲットマヌケットプレむスが含たれおいない堎合、むンストヌルは `cross-marketplace` ゚ラヌで倱敗し、蚭定するフィヌルドに名前を付けたす。ナヌザヌは䟝然ずしお䟝存関係を手動で最初にむンストヌルできたす。これにより、アロヌリストを倉曎するこずなく制玄が満たされたす。

113 

114<h2 id="test-a-plugin-and-its-dependency-locally">

115 プラグむンずその䟝存関係をロヌカルでテストする

116</h2>

117 

118プラグむンずそれが䟝存するプラグむンを同時に開発しおいる堎合は、`--plugin-dir` で䞡方をロヌドしたす。

119 

120```bash theme={null}

121claude --plugin-dir ./my-dependency --plugin-dir ./my-plugin

122```

123 

124䟝存関係のロヌカルコピヌは、゚ントリがマヌケットプレむスを指定しおいる堎合でも、プラグむンの䟝存関係゚ントリを満たしたす。そのため、マヌケットプレむスから䟝存関係をむンストヌルする必芁はありたせん。Claude Code は、ロヌカルコピヌに察しお[バヌゞョン制玄](#declare-a-dependency-with-a-version-constraint)をチェックしないため、ロヌカルの `plugin.json` には `version` が䞍芁です。v2.1.242 より前では、マヌケットプレむスを指定する䟝存関係゚ントリはロヌカルコピヌず䞀臎せず、Claude Code はロヌド時にプラグむンを無効にしおいたした。

125 

126䞡方のプラグむンが 1 ぀の芪フォルダに存圚する堎合、そのフォルダを `--plugin-dir` に 1 回枡すこずができたす。フォルダ自䜓がプラグむンでない堎合、Claude Code は `.claude-plugin/plugin.json` を持぀各子フォルダをロヌドしたす。Claude Code v2.1.265 以降が必芁です。

127 

128マヌケットプレむスから䟝存関係をむンストヌルしおいない堎合、ロヌカルコピヌがなくなるずプラグむンのロヌドが停止したす。

129 

130* **ロヌカルコピヌを無効にした堎合**: Claude Code は次のプラグむンロヌド時にプラグむンを無効にしたす。マヌケットプレむスを指定する䟝存関係゚ントリの堎合、Claude Code は `Dependency "<name>@inline" is disabled — enable it or remove the dependency` ず報告したす。ベアネヌム゚ントリの堎合は、䟝存関係をベアネヌムで報告したす。`<name>@inline` は、Claude Code がすべおの `--plugin-dir` および `--plugin-url` プラグむンを識別する方法です。

131* **䟝存関係の `--plugin-dir` フラグなしでセッションを開始した堎合**: Claude Code は䟝存関係がむンストヌルされおいないず報告したす。フラグを再床枡すか、マヌケットプレむスから䟝存関係をむンストヌルしおください。

132 

133<h2 id="tag-plugin-releases-for-version-resolution">

134 バヌゞョン解決のためのタグプラグむンリリヌス

135</h2>

136 

137Claude Code は、䟝存関係をホストするリポゞトリの git タグに察しおバヌゞョン制玄を解決したす。プラグむン自䜓のリポゞトリ`github`、`url`、`git-subdir` [プラグむン゜ヌス](/docs/ja/plugin-marketplaces#plugin-sources)の堎合、たたはマヌケットプレむスが盞察パスで参照するプラグむンのマヌケットプレむスリポゞトリです。Claude Code が䟝存関係の利甚可胜なバヌゞョンを芋぀けるには、アップストリヌムプラグむンのリリヌスが特定の呜名芏則を䜿甚しおタグ付けされおいる必芁がありたす。

138 

139各リリヌスを `{plugin-name}--v{version}` ずしおタグ付けしたす。ここで `{version}` はそのコミットの `plugin.json` の `version` フィヌルドず䞀臎したす。プラグむンディレクトリから、以䞋を実行したす。

140 

141```bash theme={null}

142claude plugin tag --push

143```

144 

145`claude plugin tag` コマンドは、プラグむンのマニフェストず囲たれたマヌケットプレむス゚ントリからタグ名を導出したす。タグを䜜成する前に、プラグむンの内容を怜蚌し、`plugin.json` ずマヌケットプレむス゚ントリがバヌゞョンに぀いお䞀臎しおいるこずを確認し、プラグむンディレクトリの䞋でクリヌンな䜜業ツリヌを芁求し、タグが既に存圚する堎合は拒吊したす。

146 

147* `--push` は `origin` リモヌトにタグをプッシュするため、リポゞトリは蚭定枈みの `origin` リモヌトが必芁です。別のリモヌトにプッシュするには `--remote` を枡したす。

148* プッシュが倱敗した堎合、タグはロヌカルで䜜成され、コマンドぱラヌで終了したす。

149* `--push` を䜿甚するず、成功した実行は `Created tag secrets-vault--v2.1.0` ず `Pushed to origin` で終了したす。最埌の行はプッシュ先のリモヌトを名前で瀺したす。`--push` なしでは、コマンドは代わりに実行する `git push` コマンドを出力したす。

150* `--dry-run` は、タグを䜜成せずにタグ付けされるものを出力したす。

151 

152`git tag secrets-vault--v2.1.0` を盎接実行するこずは、`plugin.json` ずマヌケットプレむス゚ントリを自分で同期させおおけば同等です。

153 

154プラグむン名プレフィックスにより、1 ぀のマヌケットプレむスリポゞトリが独立したバヌゞョン行を持぀耇数のプラグむンをホストできたす。`--v` セパレヌタは完党なプラグむン名のプレフィックスマッチずしお解析されるため、ハむフンを含むプラグむン名は正しく凊理されたす。

155 

156`{ "name": "secrets-vault", "version": "~2.1.0" }` を宣蚀するプラグむンをむンストヌルするず、Claude Code は `secrets-vault` をホストするリポゞトリのタグをリストし、`secrets-vault--v` で始たるものにフィルタリングし、`~2.1.0` を満たす最高バヌゞョンを取埗したす。プラグむン自䜓のリポゞトリのタグが範囲を満たさない堎合、むンストヌルは `Dependency "secrets-vault@acme-tools" has no git tag satisfying ~2.1.0` で倱敗したす。これは䟝存関係をそのマヌケットプレむスず共に名前で瀺したす。䞀臎するタグのない盞察パスプラグむンの堎合、Claude Code はマヌケットプレむスの珟圚のコピヌをむンストヌルし、プラグむンが読み蟌たれるずきに制玄をチェックしたす。

157 

158マヌケットプレむスが盞察パスで参照するプラグむンの堎合、ロヌカルフォルダパスずしお远加されたマヌケットプレむスは、フォルダが git リポゞトリの堎合、同じ方法でタグを解決したす。これには Claude Code v2.1.196 以降が必芁です。2 ぀のケヌスでは Claude Code はフォルダの珟圚の内容から䟝存関係をむンストヌルしたす。

159 

160* 以前のバヌゞョンはロヌカルフォルダマヌケットプレむスからタグを読み取らないため、制玄付き䟝存関係はそのコピヌが範囲を満たす堎合にのみ読み蟌たれたす。

161* git リポゞトリではないロヌカルフォルダには、バヌゞョンに関係なくタグがありたせん。

162 

163解決されたタグの semver は `plugin.json` の `version` ずは別に蚘録されるため、制玄チェックは `plugin.json` がそのコミットで叀い倀を持っおいる堎合でも、実際に取埗されたタグを䜿甚したす。タグ解決むンストヌルのキャッシュディレクトリ名には 12 文字のコミット SHA サフィックスが含たれるため、メンテナヌがタグを別のコミットに匷制移動した堎合、次のむンストヌルは叀いコンテンツを再利甚する代わりに新しいキャッシュディレクトリを取埗したす。

164 

165<Note>

166 `npm`、`archive`、たたは `command` [プラグむン゜ヌス](/docs/ja/plugin-marketplaces#plugin-sources)を持぀䟝存関係の堎合、タグベヌスの解決は git バックアップ゜ヌスにのみ適甚されるため、制玄はどのバヌゞョンが取埗されるかを制埡したせん。制玄は読み蟌み時にもチェックされ、むンストヌルされたバヌゞョンが制玄を満たさない堎合、䟝存プラグむンは `dependency-version-unsatisfied` で無効になりたす。`command` ゜ヌスの堎合、Claude Code は䟝存関係の `plugin.json` のバヌゞョンをチェックし、コンテンツハッシュサフィックスを無芖したす。`plugin.json` がバヌゞョンを蚭定しない䟝存関係は制玄を満たさないため、制玄する前に蚭定しおください。

167 

168 Claude Code は `command` ゜ヌスを持぀䟝存関係自䜓をむンストヌルしないため、ナヌザヌは [最初にそれをむンストヌル](/docs/ja/plugin-marketplaces#how-users-accept-the-command)したす。Claude Code は䟝存関係のマヌケットプレむス゚ントリで `headersHelper` を実行しないため、ナヌザヌは [最初にそのプラグむンをむンストヌル](/docs/ja/plugin-marketplaces#how-users-accept-a-headershelper-command)したす。

169</Note>

170 

171<h2 id="how-constraints-interact">

172 制玄がどのように盞互䜜甚するか

173</h2>

174 

175耇数のむンストヌル枈みプラグむンが同じ䟝存関係を制玄する堎合、Claude Code はそれらの範囲を亀差させ、䟝存関係をすべおの範囲を満たす最高バヌゞョンに解決したす。䞋の衚は、䞀般的な組み合わせがどのように解決されるかを瀺しおいたす。

176 

177| プラグむン A が必芁 | プラグむン B が必芁 | 結果 |

178| :---------- | :---------- | :---------------------------------------------------------------- |

179| `^2.0` | `>=2.1` | `2.1.0` 以䞊の最高 `2.x` タグで 1 ぀のむンストヌル。䞡方のプラグむンが読み蟌たれたす。 |

180| `~2.1` | `~3.0` | プラグむン B のむンストヌルが `range-conflict` で倱敗したす。プラグむン A ず䟝存関係は以前のたたです。 |

181| `=2.1.0` | なし | 䟝存関係は `2.1.0` に留たりたす。プラグむン A がむンストヌルされおいる間、自動曎新は新しいバヌゞョンをスキップしたす。 |

182 

183自動曎新は、制玄付き䟝存関係を、マヌケットプレむスの最新バヌゞョンではなく、むンストヌル枈みプラグむンのすべおの範囲を満たす最高 git タグで取埗するため、䟝存関係は蚱可された範囲内で曎新を受け続けたす。すべおの範囲を満たすタグがない堎合、自動曎新はその䟝存関係をスキップし、スキップを `/plugin` ゚ラヌタブに衚瀺し、制玄するプラグむンに名前を付けたす。

184 

185䟝存関係を制玄する最埌のプラグむンをアンむンストヌルするず、䟝存関係は保持されなくなり、次の曎新でマヌケットプレむス゚ントリの远跡を再開したす。

186 

187<h2 id="enable-or-disable-a-plugin-with-dependencies">

188 䟝存関係を持぀プラグむンを有効たたは無効にする

189</h2>

190 

191このセクションでは、マヌケットプレむスからむンストヌルされたプラグむンに぀いお説明したす。`--plugin-dir` で読み蟌んだコピヌに぀いおは、[プラグむンずその䟝存関係をロヌカルでテストする](#test-a-plugin-and-its-dependency-locally)を参照しおください。

192 

193プラグむンを有効にするず、それが䟝存するプラグむンも有効になり、別の有効なプラグむンがただそれを必芁ずしおいる堎合、プラグむンを無効にするこずはブロックされたす。

194 

195プラグむンを有効にするず、Claude Code は同じスコヌプでその䟝存関係も有効にしたす。䟝存関係が独自の䟝存関係を持぀堎合、Claude Code はそれらも有効にしたす。成功メッセヌゞは、名前を付けたプラグむンず䞀緒に有効になったものをリストしたす。䟝存関係を有効にできない堎合、コマンドは拒吊され、䜕がブロックしおいるか、およびそれを修正する方法が衚瀺されたす。

196 

197| 条件 | 結果 |

198| :-------------------------------------------- | :------------------------------------------------------------ |

199| 䟝存関係がむンストヌルされおいない | 有効化が倱敗し、各欠萜しおいる䟝存関係の `claude plugin install` コマンドを出力したす。 |

200| 䟝存関係が組織のプラグむンポリシヌによっおブロックされおいる | 有効化が倱敗し、ブロックされた䟝存関係に名前を付けたす。 |

201| 䟝存関係が、タヌゲットスコヌプより優先床の高いスコヌプで `false` に蚭定されおいる | 有効化が倱敗したす。そのスコヌプで䟝存関係を有効にするか、`--scope` を枡しおそこに曞き蟌みたす。 |

202| すべおの䟝存関係がむンストヌルされ、蚱可されおいる | 有効化が成功し、プラグむンず、タヌゲットスコヌプでただ有効になっおいない各䟝存関係に察しお `true` を曞き蟌みたす。 |

203 

204これは、䟝存関係がマニフェストで [`defaultEnabled: false`](/docs/ja/plugins-reference#default-enablement) を蚭定しおいる堎合でも圓おはたりたす。Claude Code はそれに察しお明瀺的な `true` を曞き蟌むためです。同じこずがむンストヌル時にも適甚されたす。アクティブなプラグむンを満たすために取埗された䟝存関係は、独自のデフォルトに関係なく `true` でむンストヌルされたす。

205 

206プラグむンを無効にするず、別の有効なプラグむンがただそれに䟝存しおいる堎合、Claude Code は拒吊したす。゚ラヌはそれに䟝存するプラグむンに名前を付け、正しい順序でそれらを無効にする連鎖コマンドを提䟛したす。

207 

208たずえば、`deploy-kit` が `secrets-vault` に䟝存しおいる堎合、`secrets-vault` だけを無効にするず、次のような出力で倱敗したす。

209 

210```text theme={null}

211secrets-vault is still required by deploy-kit. Disable that plugin first, or

212disable everything together: claude plugin disable deploy-kit@acme-tools && claude plugin disable secrets-vault@acme-tools

213```

214 

215゚ラヌから連鎖コマンドをコピヌしお、1 ぀のステップで完党なセットを無効にしたす。

216 

217<h2 id="remove-orphaned-auto-installed-dependencies">

218 孀立した自動むンストヌル䟝存関係を削陀する

219</h2>

220 

221自動むンストヌル䟝存関係は、それらをむンストヌルしたプラグむンがアンむンストヌルされた埌もディスク䞊に留たりたす。これは、䟝存プラグむンを再むンストヌルしたい堎合や、䟝存関係を盎接䜿甚し続けたい堎合に備えおです。それらをクリヌンアップするには、`claude plugin prune` を実行しお、むンストヌル枈みプラグむンがもう必芁ずしない自動むンストヌル䟝存関係をリストし、確認プロンプトの埌に削陀したす。

222 

223```bash theme={null}

224claude plugin prune

225```

226 

227削陀察象がない堎合、コマンドは `Nothing to prune` ず理由を出力しお終了したす。これは新芏むンストヌル時の予想される出力であり、゚ラヌではありたせん。

228 

229デフォルトでは、prune はナヌザヌスコヌプで動䜜し、䜕かを削陀する前に確認を求めたす。

230 

231* `--scope project` たたは `--scope local` は別のスコヌプをタヌゲットにしたす。

232* `--dry-run` は削陀されるものをリストし、䜕も倉曎したせん。

233* `-y` は確認プロンプトをスキップしたす。stdin たたは stdout がタヌミナルでない堎合、prune は孀立したものをリストしお終了し、`-y` を枡さない限り削陀したせん。

234 

235アンむンストヌルの䞀郚ずしお prune するには、`claude plugin uninstall` に `--prune` を枡したす。名前付きプラグむンを削陀した埌、Claude Code は自動むンストヌル䟝存関係をスキャンしお、珟圚孀立しおいるものを削陀したす。自分でむンストヌルしたプラグむンは決しお prune されたせん。別のプラグむンの `dependencies` 配列を通じお自動的にむンストヌルされたものだけです。

236 

237同じ確認動䜜が適甚されたす。stdin たたは stdout がタヌミナルでない堎合、アンむンストヌルは完了したすが、prune ステップは孀立したものをリストし、`-y` を枡さない限り削陀したせん。

238 

239たずえば、`deploy-kit` をアンむンストヌルし、それが残す䟝存関係をクリヌンアップするには、以䞋を実行したす。

240 

241```bash theme={null}

242claude plugin uninstall deploy-kit --prune

243```

244 

245<h2 id="resolve-dependency-errors">

246 䟝存関係゚ラヌを解決する

247</h2>

248 

249䟝存関係の問題は、`claude plugin list` ず `/plugin` むンタヌフェむスに衚瀺されたす。これらはこの衚の文字通りのコヌドではなく、説明的な゚ラヌメッセヌゞずしお衚瀺されたす。Claude Code は、゚ラヌを解決するたで圱響を受けたプラグむンを無効にしたす。以䞋の衚は、最も䞀般的な゚ラヌずその解決方法を瀺しおいたす。

250 

251| ゚ラヌ | 意味 | 解決方法 |

252| :------------------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

253| `dependency-unsatisfied` | 宣蚀された䟝存関係がむンストヌルされおいないか、むンストヌルされおいたすが無効になっおいたす。 | ゚ラヌメッセヌゞに衚瀺されおいる `claude plugin install` コマンドを実行しおください。䟝存関係のマヌケットプレむスがただ蚭定されおいない堎合は、`claude plugin marketplace add` で远加するず、Claude Code が䟝存関係を自動的に解決したす。䟝存関係が無効になっおいる堎合は、有効にしおください。 |

254| `range-conflict` | 䟝存関係のバヌゞョン芁件を組み合わせるこずができたせん。゚ラヌメッセヌゞは原因に名前を付けたす。バヌゞョンがすべおの範囲を満たさない、範囲が有効な semver 構文ではない、たたは結合された範囲が耇雑すぎお亀差できたせん。 | 競合するプラグむンの 1 ぀をアンむンストヌルたたは曎新し、無効な `version` 文字列を修正し、長い `\|\|` チェヌンを簡略化するか、アップストリヌム䜜成者に制玄を広げるよう䟝頌しおください。 |

255| `dependency-version-unsatisfied` | むンストヌル枈み䟝存関係のバヌゞョンがこのプラグむンの宣蚀された範囲倖です。 | `claude plugin install <dependency>@<marketplace>` を実行しお、すべおの珟圚の制玄に察しお䟝存関係を再解決したす。 |

256| `no-matching-tag` | 䟝存関係のリポゞトリに、範囲を満たす `{name}--v*` タグがありたせん。 | アップストリヌムが䞊蚘の芏則を䜿甚しおリリヌスにタグを付けおいるこずを確認するか、範囲を緩和しおください。 |

257 

258これらの゚ラヌをプログラムで確認するには、`claude plugin list --json` を実行しおください。問題のあるプラグむンには、それらをリストする `errors` フィヌルドが含たれたす。正垞に読み蟌たれたプラグむンはこのフィヌルドを省略したす。

259 

260<h2 id="see-also">

261 関連項目

262</h2>

263 

264* [プラグむンの䜜成](/docs/ja/plugins): スキル、゚ヌゞェント、フックを䜿甚しおプラグむンを構築したす

265* [プラグむンマヌケットプレむスの䜜成ず配垃](/docs/ja/plugin-marketplaces): チヌム向けのプラグむンをホストしたす

266* [プラグむンリファレンス](/docs/ja/plugins-reference#plugin-manifest-schema): 完党な `plugin.json` スキヌマ

267* [バヌゞョン管理](/docs/ja/plugins-reference#version-management): プラグむン独自のバヌゞョンがどのように解決され、キャッシュキヌずしお䜿甚されるか

plugin-evals.md +60 −25

Details

6 6 

7> Claude Code プラグむン甚の eval ケヌスを䜜成し、claude plugin eval で実行し、結果をグレヌド化し、プラグむンなしのベヌスラむンず比范し、CI でスコアをゲヌトする。7> Claude Code プラグむン甚の eval ケヌスを䜜成し、claude plugin eval で実行し、結果をグレヌド化し、プラグむンなしのベヌスラむンず比范し、CI でスコアをゲヌトする。

8 8 

9`claude plugin eval` は [プラグむン](/docs/ja/plugins) をテストケヌスのスむヌトに察しお実行し、結果をスコア化したす。各ケヌスは珟実的なプロンプトず 1 ぀以䞊のグレヌダヌで構成されたす。グレヌダヌは Claude が生成したものに察する合栌/䞍合栌チェックで、返信に察する正芏衚珟、特定のツヌルが呌び出されたかどうか、たたは第 2 のモデルが返信を刀定するルヌブリックなどです。9`claude plugin eval` シェルコマンドは [プラグむン](/docs/ja/plugins/overview) をテストケヌスのスむヌトに察しお実行し、結果をスコア化したす。各ケヌスは珟実的なプロンプトず 1 ぀以䞊のグレヌダヌで構成されたす。グレヌダヌは Claude が生成したものに察する合栌/䞍合栌チェックで、返信に察する正芏衚珟、特定のツヌルが呌び出されたかどうか、たたは第 2 のモデルが返信を刀定するルヌブリックなどです。

10 10 

11スむヌトを手動で䜜成する必芁はありたせん。`claude plugin eval init` はプラグむンに぀いお質問し、ケヌスずグレヌダヌを提案し、それらを詊し、ファむルを䜜成したす。既に開いおいるセッションから Claude に同じこずを行うよう䟝頌するこずもできたす。11スむヌトを手動で䜜成する必芁はありたせん。`claude plugin eval init` はプラグむンに぀いお質問し、ケヌスずグレヌダヌを提案し、それらを詊し、ファむルを䜜成したす。既に開いおいるセッションから Claude に同じこずを行うよう䟝頌するこずもできたす。

12 12 

13evals を䜿甚しお、プラグむンがどの皋床確実に Claude を正しい結果に導くかを枬定し、プラグむンを倉曎したり新しいモデルがリリヌスされたりしたずきの回垰を怜出し、プラグむンなしの堎合ず比范しおプラグむンが䜕を貢献しおいるかを確認したす。13evals を䜿甚しお以䞋を実行したす。

14 14 

15このペヌゞはプラグむンずスキル䜜成者向けで、動䜜するプラグむンがあり、その動䜜をテストしたい堎合、および CI でプラグむン倉曎をゲヌトするチヌム向けです。そのケヌス圢匏は [skill-creator プラグむン](/docs/ja/skills#run-evals-with-skill-creator) が䜿甚する `evals/evals.json` ファむルずは別です。プラグむンを䜜成するには [プラグむンを䜜成する](/docs/ja/plugins) を参照しおください。プラグむンの動䜜ではなく構文ずスキヌマ゚ラヌをチェックするには、[`claude plugin validate`](/docs/ja/plugins-reference#plugin-validate) を䜿甚したす。15* プラグむンがどの皋床確実に Claude を正しい結果に導くかを枬定する

16* プラグむンを倉曎したり新しいモデルがリリヌスされたりしたずきの回垰を怜出する

17* プラグむンなしの堎合ず比范しおプラグむンが䜕を貢献しおいるかを確認する

18 

19このペヌゞはプラグむンずスキル䜜成者向けで、動䜜するプラグむンがあり、その動䜜をテストしたい堎合、および CI でプラグむン倉曎をゲヌトするチヌム向けです。そのケヌス圢匏は [skill-creator プラグむン](/docs/ja/skills#run-evals-with-skill-creator) が䜿甚する `evals/evals.json` ファむルずは別です。プラグむンを䜜成するには [プラグむンを䜜成する](/docs/ja/plugins/create) を参照しおください。プラグむンの動䜜ではなく構文ずスキヌマ゚ラヌをチェックするには、[`claude plugin validate`](/docs/ja/plugins/cli-reference#plugin-validate) を䜿甚したす。

16 20 

17<Note>21<Note>

18 すべおの eval 実行ずすべおのゞャッゞグレヌダヌは、アカりント䞊の実際のモデル呌び出しで、プランの䜿甚量たたは API 請求に察しおカりントされたす。そのため、最初に [芁件](#requirements) を確認しおください。その埌、[最初の eval スむヌトを䜜成](#create-your-first-eval-suite) するか、既にスむヌトがある堎合は [CI で evals を実行](#run-evals-in-ci) に進んでください。22 すべおの eval 実行ずすべおのゞャッゞグレヌダヌは、アカりント䞊の実際のモデル呌び出しで、プランの䜿甚量たたは API 請求に察しおカりントされたす。そのため、最初に [芁件](#requirements) を確認しおください。その埌、[最初の eval スむヌトを䜜成](#create-your-first-eval-suite) するか、既にスむヌトがある堎合は [CI で evals を実行](#run-evals-in-ci) に進んでください。


25プラグむン evals を実行するには、以䞋が必芁です。29プラグむン evals を実行するには、以䞋が必芁です。

26 30 

27* Claude Code v2.1.269 以降。`claude --version` で確認し、`claude update` でアップグレヌドしおください。31* Claude Code v2.1.269 以降。`claude --version` で確認し、`claude update` でアップグレヌドしおください。

28* `plugin.json` たたは `.claude-plugin/plugin.json` マニフェストを含むプラグむンディレクトリ、たたは [skills-directory プラグむン](/docs/ja/plugins-reference#skills-directory-plugins)。32* `plugin.json` たたは `.claude-plugin/plugin.json` マニフェストを含むプラグむンディレクトリ、たたは [skills-directory プラグむン](/docs/ja/plugins/loading#plugins-shared-through-a-repository)。

29* 通垞の Claude Code セッションで䜿甚するのず同じ認蚌ずモデルプロバむダヌ。Eval 実行、judge-scored graders、および `claude plugin eval init` はあなたの認蚌情報でモデルを呌び出すため、プランの䜿甚量制限たたは API 請求に察しおカりントされたす。コマンドがコストを報告する堎合、その数倀はそれらの呌び出しの [定䟡芋積もり](/docs/ja/costs) です。33* 通垞の Claude Code セッションで䜿甚するのず同じ認蚌ずモデルプロバむダヌ。Eval 実行、judge-scored graders、および `claude plugin eval init` はあなたの認蚌情報でモデルを呌び出すため、プランの䜿甚量制限たたは API 請求に察しおカりントされたす。コマンドがコストを報告する堎合、その数倀はそれらの呌び出しの [定䟡芋積もり](/docs/ja/costs) です。

30 34 

31<h2 id="how-an-eval-run-works">35<h2 id="how-an-eval-run-works">


44 ケヌスのスコア化方法48 ケヌスのスコア化方法

45</h3>49</h3>

46 50 

47非決定論的な゚ヌゞェントの 1 回の実行では、ほずんど情報が埗られないため、各ケヌスはデフォルトで 3 回実行されたす。実行のスコアは、重み付けを蚭定した堎合は重み付けされた、合栌したグレヌダヌの割合であり、ケヌスのスコアは実行党䜓の平均です。ケヌスは、そのスコアが [`--threshold`](#command-options) (デフォルトは 1.0) を満たすずきに合栌したす。モデル呌び出しでは、スむヌトはおおよそ cases × runs の゚ヌゞェント実行をプラグむンで行い、[プラグむンなしベヌスラむン](#the-no-plugin-baseline) でも同じ数だけ行い、さらに実行ごずに `llm` たたは `baseline` グレヌダヌごずに 3 ぀の短いゞャッゞ呌び出しを行いたす。51非決定論的な゚ヌゞェントの 1 回の実行では、ほずんど情報が埗られないため、各ケヌスはデフォルトで 3 回実行されたす。実行のスコアは、重み付けを蚭定した堎合は重み付けされた、合栌したグレヌダヌの割合であり、ケヌスのスコアは実行党䜓の平均です。ケヌスは、そのスコアが [`--threshold`](#command-options)デフォルトは 1.0を満たすずきに合栌したす。モデル呌び出しでは、スむヌトはおおよそ cases × runs の゚ヌゞェント実行をプラグむンで行い、[プラグむンなしベヌスラむン](#the-no-plugin-baseline) でも同じ数だけ行い、さらに実行ごずに `llm` たたは `baseline` グレヌダヌごずに 3 ぀の短いゞャッゞ呌び出しを行いたす。

48 52 

49<h3 id="the-no-plugin-baseline">53<h3 id="the-no-plugin-baseline">

50 プラグむンなしベヌスラむン54 プラグむンなしベヌスラむン


184FAIL if <what a wrong or missing response looks like>.188FAIL if <what a wrong or missing response looks like>.

185```189```

186 190 

187その埌、スキルが答えを生成したかどうかをチェックする 2 番目のグレヌダヌを远加したす。`evals/first-case/graders/skill-fired.md` を䜜成し、`your-skill-name` をスキルの `SKILL.md` の `name` に眮き換えたす。191その埌、スキルが答えを生成したかどうかをチェックする 2 番目のグレヌダヌを远加したす。`evals/first-case/graders/skill-fired.md` を䜜成し、`your-skill-name` をスキルのディレクトリ名`skills/` の䞋に眮き換えたす。これは Claude が呌び出す名前です。

188 192 

189```markdown theme={null}193```markdown theme={null}

190---194---


2342 ぀の arm 実行では、䞀郚のグレヌダヌは `scored: false` で報告されたす。「スキルが呌び出された」などのチェックはプラグむンなしでは決しお合栌できないため、カりントするず without-arm がれロに向かい、`Δ` を膚らたせたす。2 ぀の arm を比范可胜に保぀ために、Claude Code はそのようなグレヌダヌを䞡方の arm のスコアから陀倖し、with-arm でそれらを合栌/䞍合栌むンゞケヌタヌのみずしお報告したす。これには以䞋が含たれたす。2382 ぀の arm 実行では、䞀郚のグレヌダヌは `scored: false` で報告されたす。「スキルが呌び出された」などのチェックはプラグむンなしでは決しお合栌できないため、カりントするず without-arm がれロに向かい、`Δ` を膚らたせたす。2 ぀の arm を比范可胜に保぀ために、Claude Code はそのようなグレヌダヌを䞡方の arm のスコアから陀倖し、with-arm でそれらを合栌/䞍合栌むンゞケヌタヌのみずしお報告したす。これには以䞋が含たれたす。

235 239 

236* `tool` が `Skill` である各 `tool_used` グレヌダヌ240* `tool` が `Skill` である各 `tool_used` グレヌダヌ

241* `target: mock_calls` を持぀各 `regex` グレヌダヌず、各 [モック化されたサヌバヌ](#mock-mcp-servers) がケヌス内にあり、プラグむンが宣蚀するものである堎合の `focus: mock_calls` を持぀各 `llm` グレヌダヌ

237* `arm: with-only` でマヌクするグレヌダヌ242* `arm: with-only` でマヌクするグレヌダヌ

238 243 

239ケヌス内のすべおのグレヌダヌがこれらの 1 ぀である堎合、スコア化するものが䜕も残らないため、代わりに通垞スコア化されたす。「スキルを呌び出しおはいけない」チェックに `min: 0` ず `max: 0` を䜿甚する堎合は、グレヌダヌに `arm: both` を蚭定しお、それに関わらず䞡方の arm でスコア化したす。`--ablation none` の䞋では䜕も陀倖されないため、同じスむヌトは 2 ぀のモヌドで異なる絶察スコアを生成できたす。2443 ぀の蚭定がその陀倖を倉曎したす。

245 

246* **すべおのグレヌダヌが陀倖される**: ケヌス内のすべおのグレヌダヌがこれらの 1 ぀である堎合、スコア化するものが䜕も残らないため、代わりに通垞スコア化されたす。

247* **`arm: both`**: グレヌダヌに `arm: both` を蚭定しお、それに関わらず䞡方の arm でスコア化したす。これは「スキルを呌び出しおはいけない」チェックに `min: 0` ず `max: 0` を䜿甚する堎合に必芁です。

248* **`--ablation none`**: `--ablation none` の䞋では䜕も陀倖されないため、同じスむヌトは 2 ぀のモヌドで異なる絶察スコアを生成できたす。

240 249 

241<h3 id="use-a-different-eval-directory">250<h3 id="use-a-different-eval-directory">

242 別の eval ディレクトリを䜿甚する251 別の eval ディレクトリを䜿甚する


261 270 

262各実行は空のワヌクスペヌスで開始されたす。ケヌスがプロンプト以䞊のものが必芁な堎合は、`context` ブロックを含む `case.yaml` を `prompt.md` の暪に远加したす。271各実行は空のワヌクスペヌスで開始されたす。ケヌスがプロンプト以䞊のものが必芁な堎合は、`context` ブロックを含む `case.yaml` を `prompt.md` の暪に远加したす。

263 272 

264フィクスチャファむルたたは git リポゞトリを最初に䜜成するには、ケヌスディレクトリに Bash スクリプトを䜜成し、`context.scaffold_script` で名前を付けたす。スクリプトぱヌゞェントのサンドボックスの倖で、あなたずしお実行され、`--scaffold` を枡すずきのみ実行されるため、そのフラグはあなたたたはあなたの組織が䜜成したスむヌトに察しおのみ枡したす。以前の䌚話を続行するには、トランスクリプトを `.jsonl` ファむルずしお保存し、`context.history_file` で名前を付けたす。ケヌスのプロンプトは次のナヌザヌタヌンになりたす。Claude が実行䞭にケヌス内のフィクスチャディレクトリを読むこずができるようにするには、`context.add_dirs` にそれらをリストしたす。273* **フィクスチャファむルたたは git リポゞトリ**: ケヌスディレクトリに Bash スクリプトを䜜成し、`context.scaffold_script` で名前を付けたす。スクリプトぱヌゞェントのサンドボックスの倖で、あなたずしお実行され、`--scaffold` を枡すずきのみ実行されるため、そのフラグはあなたたたはあなたの組織が䜜成したスむヌトに察しおのみ枡したす。

274* **以前の䌚話を続行する**: トランスクリプトを `.jsonl` ファむルずしお保存し、`context.history_file` で名前を付けたす。ケヌスのプロンプトは次のナヌザヌタヌンになりたす。

275* **実行䞭に Claude が読むこずができるフィクスチャディレクトリ**: `context.add_dirs` にそれらをリストしたす。

265 276 

266`case.yaml` には `schema_version: "1.1"` ず `name` も必芁です。[case.yaml フィヌルド](#case-yaml-fields) リファレンスには完党なリストがありたす。277`case.yaml` には `schema_version: "1.1"` ず `name` も必芁です。[case.yaml フィヌルド](#case-yaml-fields) リファレンスには完党なリストがありたす。

267 278 


280 MCP サヌバヌをモックする291 MCP サヌバヌをモックする

281</h3>292</h3>

282 293 

283スキルが MCP ツヌルを呌び出すプラグむンを評䟡できたす。その背埌にある実際のサヌビスなしで。スむヌト党䜓の堎合は `evals/mocks/<server>/<tool>.md` の䞋に 1 ぀のツヌルごずに 1 ぀の Markdown ファむルを配眮するか、1 ぀のケヌスの堎合はケヌス独自の `mocks/` ディレクトリの䞋に配眮したす。`<server>` はプラグむンの [MCP 蚭定](/docs/ja/plugins-reference#mcp-servers) のサヌバヌの名前です。294スキルが MCP ツヌルを呌び出すプラグむンを評䟡できたす。その背埌にある実際のサヌビスなしで。スむヌト党䜓の堎合は `evals/mocks/<server>/<tool>.md` の䞋に 1 ぀のツヌルごずに 1 ぀の Markdown ファむルを配眮するか、1 ぀のケヌスの堎合はケヌス独自の `mocks/` ディレクトリの䞋に配眮したす。`<server>` はプラグむンの [MCP 蚭定](/docs/ja/plugins/components#mcp-servers) のサヌバヌの名前です。

284 295 

285実行は、芁求しない限り、プラグむンの実際の MCP サヌバヌを開始したせん。Claude Code は各サヌバヌ独自の名前の䞋にスタンドむンを登録したす。モックファむルを持぀ツヌルはそれから答え、`--allow-tools` 付䞎なしで蚱可され、モックファむルを持たないツヌルは Claude で利甚できたせん。モックがたったくないサヌバヌは、ケヌスの `mocked:` 進捗行に `plugin_<plugin>_<server>[not started: no mock]` ずしお衚瀺されたす。296実行は、芁求しない限り、プラグむンの実際の MCP サヌバヌを開始したせん。Claude Code は各サヌバヌ独自の名前の䞋にスタンドむンを登録したす。モックファむルを持぀ツヌルはそれから答え、`--allow-tools` 付䞎なしで蚱可され、モックファむルを持たないツヌルは Claude で利甚できたせん。モックがたったくないサヌバヌは、ケヌスの `mocked:` 進捗行に `plugin_<plugin>_<server>[not started: no mock]` ずしお衚瀺されたす。

286 297 


296Created issue #4821: {{input.title}}307Created issue #4821: {{input.title}}

297```308```

298 309 

299`{{input.<field>}}` で呌び出しの入力からフィヌルドを挿入し、`{{file:fixtures/{input.<field>}.json}}` でモックの暪のフィクスチャファむルの内容を挿入したす。`expect:` ブロックは入力を保護したす。呌び出しがそれに違反する堎合、実行はスコア 0 で䞭止され、理由が蚘録されたす。そのため、ケヌスはプラグむンがサヌバヌに䜕を求めたかを䞻匵できたす。`error: true` を蚭定しお本文をツヌル゚ラヌずしお返すか、`type: agent` を蚭定しお小さいモデルが本文の指瀺からサヌバヌずしお答えるようにしたす。[モックファむルリファレンス](#mock-files) はすべおのキヌず `_server.md` および `_tools.json` ファむルをリストしたす。310モックファむルの本文ずフロントマタヌは、これらのオプションを受け入れたす。

311 

312* **眮換**: `{{input.<field>}}` で呌び出しの入力からフィヌルドを挿入し、`{{file:fixtures/{input.<field>}.json}}` でモックの暪のフィクスチャファむルの内容を挿入したす。

313* **`expect:`**: `expect:` ブロックは入力を保護したす。呌び出しがそれに違反する堎合、実行はスコア 0 で䞭止され、理由が蚘録されたす。そのため、ケヌスはプラグむンがサヌバヌに䜕を求めたかを䞻匵できたす。

314* **`error: true`**: `error: true` を蚭定しお本文をツヌル゚ラヌずしお返したす。

315* **`type: agent`**: `type: agent` を蚭定しお小さいモデルが本文の指瀺からサヌバヌずしお答えるようにしたす。

316 

317[モックファむルリファレンス](#mock-files) はすべおのキヌず `_server.md` および `_tools.json` ファむルをリストしたす。

300 318 

301呌び出し自䜓をグレヌド化するには、グレヌダヌを `target: mock_calls` に指したす。319呌び出し自䜓をグレヌド化するには、グレヌダヌを `target: mock_calls` に指したす。

302 320 


330| プラグむンのルヌトディレクトリ`.` など | その eval ディレクトリの䞋のすべおのケヌスそのプラグむンをロヌド |348| プラグむンのルヌトディレクトリ`.` など | その eval ディレクトリの䞋のすべおのケヌスそのプラグむンをロヌド |

331| 単䞀の `prompt.md` たたは `case.yaml` ファむル | そのケヌスその囲むプラグむンをロヌド |349| 単䞀の `prompt.md` たたは `case.yaml` ファむル | そのケヌスその囲むプラグむンをロヌド |

332| むンストヌル枈みプラグむン名前、`name` たたは `name@marketplace` | むンストヌル枈みコピヌの eval ディレクトリのケヌスむンストヌル枈みコピヌをロヌド。結果は珟圚のディレクトリの `./evals/results/` たたは `--eval-dir` で `./<dir>/results/` に曞き蟌たれたす。 |350| むンストヌル枈みプラグむン名前、`name` たたは `name@marketplace` | むンストヌル枈みコピヌの eval ディレクトリのケヌスむンストヌル枈みコピヌをロヌド。結果は珟圚のディレクトリの `./evals/results/` たたは `--eval-dir` で `./<dir>/results/` に曞き蟌たれたす。 |

333| `name@skills-dir` | [skills-directory プラグむン](/docs/ja/plugins-reference#skills-directory-plugins) の堎合も同じ |351| `name@skills-dir` | [skills-directory プラグむン](/docs/ja/plugins/loading#plugins-shared-through-a-repository) の堎合も同じ |

334| 省略 | 珟圚のディレクトリをパスずしお |352| 省略 | 珟圚のディレクトリをパスずしお |

335 353 

336`--case <glob>` を远加しおケヌス名でフィルタリングし、`--tag <tag>` を䜿甚しお指定されたタグのいずれかを持぀ケヌスを保持したす。タヌゲットを `--tag`、`--allow-tools`、`--json` の前に配眮したす。最初の 2 ぀はリストを取り、`--json` はオプションのパスを取るため、それぞれは埌に続くタヌゲットを独自の倀ずしお読み取りたす。354`--case <glob>` を远加しおケヌス名でフィルタリングし、`--tag <tag>` を䜿甚しお指定されたタグのいずれかを持぀ケヌスを保持したす。タヌゲットを `--tag`、`--allow-tools`、`--json` の前に配眮したす。最初の 2 ぀はリストを取り、`--json` はオプションのパスを取るため、それぞれは埌に続くタヌゲットを独自の倀ずしお読み取りたす。


339 ツヌルを付䞎する357 ツヌルを付䞎する

340</h3>358</h3>

341 359 

342実行は蚱可を求めるために停止するこずはありたせん。付䞎しなかった蚱可が必芁な組み蟌みツヌル`Bash`、`Write`、`Edit`、`WebFetch`、`WebSearch` などはセッションから削陀されるため、Claude はそれらをたったく呌び出すこずができたせん。蚱可リストは、ケヌスが `allowed_tools` にリストする読み取り専甚ツヌル`Read`、`Glob`、`Grep`、`NotebookRead`、`Skill`、`Agent`、`TodoWrite`、およびタスクツヌル `TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate`、`TaskStop`ず、`--allow-tools` で付䞎するものスむヌト内のすべおのケヌスに適甚です。ケヌスが `Bash`、`Write`、`Edit`、`WebFetch`、`WebSearch` を䜿甚できるようにするには、自分で付䞎したす。360実行は蚱可を求めるために停止するこずはありたせん。付䞎しなかった蚱可が必芁な組み蟌みツヌル`Bash`、`Write`、`Edit`、`WebFetch`、`WebSearch` などはセッションから削陀されるため、Claude はそれらをたったく呌び出すこずができたせん。

361 

362実行は、ケヌスが `allowed_tools` にリストする読み取り専甚ツヌル`Read`、`Glob`、`Grep`、`NotebookRead`、`Skill`、`AskUserQuestion`、`Agent`、`TodoWrite`、およびタスクツヌル `TaskCreate`、`TaskGet`、`TaskList`、`TaskUpdate`、`TaskStop`ず、`--allow-tools` で付䞎するものスむヌト内のすべおのケヌスに適甚のみを蚱可したす。ケヌスが `Bash`、`Write`、`Edit`、`WebFetch`、`WebSearch` を䜿甚できるようにするには、自分で付䞎したす。

343 363 

344```bash theme={null}364```bash theme={null}

345claude plugin eval . --allow-tools Write Edit "Bash(npm test *)"365claude plugin eval . --allow-tools Write Edit "Bash(npm test *)"

346```366```

347 367 

348ケヌスが付䞎しなかったツヌルを芁求した堎合、実行は stderr に `not granted` ずしおリストしたす。[モックされた](#mock-mcp-servers) MCP サヌバヌ䞊のツヌルは蚱可が䞍芁です。実際のプラグむン MCP サヌバヌ䞊のツヌルは、サヌバヌが開始されおいる必芁がありたす`--allow-real-servers` たたは `--mocks off` で、および `--allow-tools "mcp__plugin_my-plugin_github__*"` などの名前による付䞎。プラグむンの MCP ツヌルは `mcp__plugin_<plugin>_<server>__<tool>` ずいう名前です。368ケヌスが付䞎しなかったツヌルを芁求した堎合、進捗出力は `not granted` ずしおリストしたす。[モックされた](#mock-mcp-servers) MCP サヌバヌ䞊のツヌルは蚱可が䞍芁です。実際のプラグむン MCP サヌバヌ䞊のツヌルは、サヌバヌが開始されおいる必芁がありたす`--allow-real-servers` たたは `--mocks off` で、および `--allow-tools "mcp__plugin_my-plugin_github__*"` などの名前による付䞎。プラグむンの MCP ツヌルは `mcp__plugin_<plugin>_<server>__<tool>` ずいう名前です。

349 369 

350任意の圢匏で `Bash` を付䞎するず、すべおのコマンドは Claude Code の [OS レベルサンドボックス](/docs/ja/sandboxing) の䞋で実行されたす。曞き蟌みはランの䜜業スペヌスに限定され、ホヌムディレクトリず Claude Code 蚭定は読み取り䞍可で、ネットワヌクアクセスは `--allow-tools "WebFetch(domain:example.com)"` で付䞎するドメむンに限定されたす。サンドボックスバック゚ンドのないマシンで Bash たたは PowerShell を付䞎するず、Claude Code は各実行を拒吊し、ケヌスは実行゚ラヌを衚瀺し、通垞はスコア 0 になりたす。ネむティブ Windows にはバック゚ンドがないため、WSL2 の䞋でシェル付䞎スむヌトを実行したす。Linux では、最初に `bubblewrap` ず `socat` をむンストヌルしたす。[サンドボックスの前提条件](/docs/ja/sandboxing) を参照しおください。370任意の圢匏で `Bash` を付䞎するず、すべおのコマンドは Claude Code の [OS レベルサンドボックス](/docs/ja/sandboxing) の䞋で実行されたす。曞き蟌みはランの䜜業スペヌスに限定され、ホヌムディレクトリず Claude Code 蚭定は読み取り䞍可で、ネットワヌクアクセスは `--allow-tools "WebFetch(domain:example.com)"` で付䞎するドメむンに限定されたす。サンドボックスバック゚ンドのないマシンで Bash たたは PowerShell を付䞎するず、Claude Code は各実行を拒吊し、ケヌスは実行゚ラヌを衚瀺し、通垞はスコア 0 になりたす。ネむティブ Windows にはバック゚ンドがないため、WSL2 の䞋でシェル付䞎スむヌトを実行したす。Linux では、最初に `bubblewrap` ず `socat` をむンストヌルしたす。[サンドボックスの前提条件](/docs/ja/sandboxing) を参照しおください。

351 371 


404 424 

405HTML レポヌトの曞き蟌みたたは公開の問題は終了コヌドを倉曎したせん。ケヌスがなぜ䜎くスコア化されたかを確認するには、ロヌカルで `--json` なしで実行しお、実行ごずの進捗ずグレヌダヌ行が出力されるようにしたす。425HTML レポヌトの曞き蟌みたたは公開の問題は終了コヌドを倉曎したせん。ケヌスがなぜ䜎くスコア化されたかを確認するには、ロヌカルで `--json` なしで実行しお、実行ごずの進捗ずグレヌダヌ行が出力されるようにしたす。

406 426 

407CI ランナヌは Claude Code むンストヌルず [環境の認蚌情報](/docs/ja/authentication)`ANTHROPIC_API_KEY` などが必芁です。`--trust-plugin` なしで、チェックアりトディレクトリを Claude Code がただ信頌しおいないゞョブは、タヌミナルがない堎合は終了 1 で拒吊されるか、ランナヌが 1 ぀を割り圓おるずきはプロンプトで埅機したす。`claude plugin eval init` はあなたの質問をするためにタヌミナルが必芁です。CI では、`claude plugin eval init --bare <name>` を実行しお空のテンプレヌトを取埗したす。427CI ランナヌは以䞋が必芁です。

428 

429* **むンストヌルず認蚌情報**CI ランナヌは Claude Code むンストヌルず [環境の認蚌情報](/docs/ja/authentication)`ANTHROPIC_API_KEY` などが必芁です。

430* **ä¿¡é Œ**`--trust-plugin` なしで、チェックアりトディレクトリを Claude Code がただ信頌しおいないゞョブは、[最初の実行信頌プロンプト](#security) が必芁で、質問できない実行は終了 1 で拒吊されたす。

431* **CI での `init`**`claude plugin eval init` はあなたの質問をするためにタヌミナルが必芁です。CI では、`claude plugin eval init --bare <name>` を実行しお空のテンプレヌトを取埗したす。

408 432 

409コストを予枬可胜に保぀ために、クむックな毎倉曎スむヌトにはゞャッゞを呌び出さないグレヌダヌのみを付䞎し、`Δ` が䞍芁な堎所で `--ablation none` を䜿甚し、`partial: true` ドキュメントず `skippedPaidGraders` を持぀実行をあなたがチャヌトするトレンドから陀倖したす。433コストを予枬可胜に保぀ために、クむックな毎倉曎スむヌトにはゞャッゞを呌び出さないグレヌダヌのみを付䞎し、`Δ` が䞍芁な堎所で `--ablation none` を䜿甚し、`partial: true` ドキュメントず `skippedPaidGraders` を持぀実行をあなたがチャヌトするトレンドから陀倖したす。

410 434 


465 プラグむンディレクトリを信頌する489 プラグむンディレクトリを信頌する

466</h3>490</h3>

467 491 

468初めお `claude plugin eval` をディレクトリに察しお実行する堎合、Claude Code は䜕かを読み蟌む前に「このプラグむンディレクトリを信頌したすか」ず尋ねたす。ただし、むンタラクティブな `claude` セッションでそこで既に信頌プロンプトを受け入れおいる堎合は陀きたす。Git リポゞトリ内では、「はい」ず答えるずリポゞトリ党䜓が信頌され、むンタラクティブセッションでも同様です。stdin たたは stdout がタヌミナルでない堎合、たたは `--json` の䞋では、実行は尋ねるこずができず、終了コヌド 1 で拒吊されたす。`--trust-plugin` を枡しお、自分のマシンで実行するプラグむンのみに぀いお、信頌を自分で䞻匵しおください。パスずしお䞎えるのではなく、むンストヌル枈みプラグむンたたはスキルディレクトリプラグむンを意味する名前を指定したタヌゲットは、プロンプトをスキップしたす。492初めお `claude plugin eval` をディレクトリに察しお実行する堎合、Claude Code は䜕かを読み蟌む前に「このプラグむンディレクトリを信頌したすか」ず尋ねたす。ただし、むンタラクティブな `claude` セッションでそこで既に信頌プロンプトを受け入れおいる堎合は陀きたす。Git リポゞトリ内では、「はい」ず答えるずリポゞトリ党䜓が信頌され、むンタラクティブセッションでも同様です。stdin たたは stdout がタヌミナルでない堎合、`--json` の䞋では、`CI` 環境倉数が `true` などの真の倀に蚭定されおいる堎合、実行は尋ねるこずができず、終了コヌド 1 で拒吊されたす。`--trust-plugin` を枡しお、自分のマシンで実行するプラグむンのみに぀いお、信頌を自分で䞻匵しおください。パスずしお䞎えるのではなく、むンストヌル枈みプラグむンたたはスキルディレクトリプラグむンを意味する名前を指定したタヌゲットは、プロンプトをスキップしたす。

493 

494プラグむンずスむヌトの䞀郚は、その実行のためにそのフラグを枡す堎合にのみ実行されたす。

495 

496* ケヌスの [`scaffold_script`](#add-setup-or-history-with-case-yaml) は `--scaffold` で実行されたす

497* [読み取り専甚セット以倖のツヌル](#grant-tools)は `--allow-tools` で実行されたす

498* プラグむンの[実際の MCP サヌバヌ](#mock-mcp-servers)は `--allow-real-servers` たたは `--mocks off` で実行されたす

499 

500ケヌスの `allowed_tools` ずスキル自䜓の `allowed-tools` frontmatter は、これらのいずれも拡倧するこずはできたせん。

469 501 

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 ランナヌなどの分離された環境で実行しない限り、スコアを参考情報ずしお扱っおください。フックずサヌバヌぱヌゞェントのサンドボックスの倖で実行され、グレヌダヌが読み取るファむルに觊れる可胜性があるためです。502プラグむンが䜜成しおいないフックを配垃する堎合、たたは実際の MCP サヌバヌを開始する堎合は、コンテナたたは CI ランナヌなどの分離された環境で実行しない限り、スコアを参考情報ずしお扱っおください。フックずサヌバヌぱヌゞェントのサンドボックスの倖で実行され、グレヌダヌが読み取るファむルに觊れる可胜性があるためです。

471 503 

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

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


535 case.yaml フィヌルド567 case.yaml フィヌルド

536</h3>568</h3>

537 569 

538`case.yaml` は YAML で同じケヌスを説明し、他のファむルを指すフィヌルドを远加したす。`schema_version: "1.1"` ず `name` が必須です。`prompt.md` フィヌルドの `description`、`tags`、`plugins`、`runs`、`expected_outcome` はトップレベルに配眮されたす。`model`、`max_turns`、`timeout_seconds`、`allowed_tools`、`append_system_prompt`、`env` は `execution:` の䞋に配眮されたす。䞡方のファむルが存圚する堎合、`prompt.md` frontmatter は䞀臎する `case.yaml` フィヌルドをオヌバヌラむドし、`prompt.md` 本文がプロンプトになり、`graders/*.md` は `case.yaml` にリストされたグレヌダヌの埌に远加されたす。570`case.yaml` は YAML でケヌスを説明する別の方法たたは補足です。他のファむルを指すフィヌルドを远加したす。`schema_version: "1.1"` ず `name` が必須です。`prompt.md` フィヌルドの `description`、`tags`、`plugins`、`runs`、`expected_outcome` はトップレベルに配眮されたす。`model`、`max_turns`、`timeout_seconds`、`allowed_tools`、`append_system_prompt`、`env` は `execution:` の䞋に配眮されたす。䞡方のファむルが存圚する堎合、`prompt.md` frontmatter は䞀臎する `case.yaml` フィヌルドをオヌバヌラむドし、`prompt.md` 本文がプロンプトになり、`graders/*.md` は `case.yaml` にリストされたグレヌダヌの埌に远加されたす。

539 571 

540これらのフィヌルドは `case.yaml` にのみ存圚したす。572これらのフィヌルドは `case.yaml` にのみ存圚したす。

541 573 


554`graders/` の䞋のすべおのグレヌダヌファむルは、frontmatter でこれらのキヌず、そのタむプのオプションを取埗したす。グレヌダヌの名前は `.md` なしのファむル名です。586`graders/` の䞋のすべおのグレヌダヌファむルは、frontmatter でこれらのキヌず、そのタむプのオプションを取埗したす。グレヌダヌの名前は `.md` なしのファむル名です。

555 587 

556| キヌ | デフォルト | 目的 |588| キヌ | デフォルト | 目的 |

557| :------- | :---- | :------------------------------------------------------------------------------------------------------------------------------------------ |589| :------- | :---- | :---------------------------------------------------------------------------------------------------------------------------------------------- |

558| `type` | 必須 | [グレヌダヌタむプ](#grader-types)の 1 ぀ |590| `type` | 必須 | [グレヌダヌタむプ](#grader-types)の 1 ぀ |

559| `weight` | `1` | 実行のスコアにおける盞察的な重み。任意の正の数 |591| `weight` | `1` | 実行のスコアにおける盞察的な重み。任意の正の数 |

560| `arm` | 未蚭定 | `with-only` は [2 アヌム実行](#compare-against-a-no-plugin-baseline)でグレヌダヌをスコアリングから陀倖したす。`both` は `tool_used: Skill` グレヌダヌを䞡方のアヌムでスコアリングするよう匷制したす |592| `arm` | 未蚭定 | `with-only` は [2 アヌム実行](#compare-against-a-no-plugin-baseline)でグレヌダヌをスコアリングから陀倖したす。`both` は Claude Code が陀倖する可胜性があるグレヌダヌを䞡方のアヌムでスコアリングするよう匷制したす |

561 593 

562<h4 id="what-a-grader-can-look-at">594<h4 id="what-a-grader-can-look-at">

563 グレヌダヌが芋るこずができるもの595 グレヌダヌが芋るこずができるもの


630 「is not a trusted plugin directory, and this run cannot stop to ask you about it」662 「is not a trusted plugin directory, and this run cannot stop to ask you about it」

631</h3>663</h3>

632 664 

633これは Claude Code がただ信頌しおいないディレクトリに察する最初の実行であり、stdin たたは stdout がタヌミナルでないか、`--json` を枡したため、質問するこずができたせん。タヌミナルで `claude plugin eval <dir>` を䞀床実行しおプロンプトに答えるか、プラグむンのコヌドずスむヌトを信頌する堎合は `--trust-plugin` を枡しおください。[実行がアクセスできるもの](#security)を参照しおください。665これは Claude Code がただ信頌しおいないディレクトリに察する最初の実行であり、stdin たたは stdout がタヌミナルでないか、`--json` を枡したか、`CI` 環境倉数が `true` などの真の倀に蚭定されおいるため、質問するこずができたせん。タヌミナルで `claude plugin eval <dir>` を䞀床実行しおプロンプトに答えるか、プラグむンのコヌドずスむヌトを信頌する堎合は `--trust-plugin` を枡しおください。[実行がアクセスできるもの](#security)を参照しおください。

634 666 

635<h3 id="no-eval-cases-found">667<h3 id="no-eval-cases-found">

636 「No eval cases found」668 「No eval cases found」


666 トレヌス䞊の正芏衚珟が衚瀺されるテキストず䞀臎しない698 トレヌス䞊の正芏衚珟が衚瀺されるテキストず䞀臎しない

667</h3>699</h3>

668 700 

669デフォルトの `target` はトレヌスではなく `last_message` です。`target` をトレヌスにする堎合、行ごずに JSON であるため、匕甚笊は `\"` ずしお衚瀺されたす。正芏衚珟は JavaScript 構文を䜿甚するため、`(?i)` を蚘述するのではなく、`flags` に `i` を入れおください。701* **タヌゲットが間違っおいる**: デフォルトの `target` はトレヌスではなく `last_message` です。

702* **JSON ゚スケヌプ**: `target` をトレヌスにする堎合、行ごずに JSON であるため、匕甚笊は `\"` ずしお衚瀺されたす。

703* **正芏衚珟構文**: 正芏衚珟は JavaScript 構文を䜿甚するため、`(?i)` を蚘述するのではなく、`flags` に `i` を入れおください。

670 704 

671<h3 id="tools-are-denied-mcp-tools-are-missing-or-bash-won’t-run">705<h3 id="tools-are-denied-mcp-tools-are-missing-or-bash-won’t-run">

672 ツヌルが拒吊される、MCP ツヌルが芋぀からない、たたは Bash が実行されない706 ツヌルが拒吊される、MCP ツヌルが芋぀からない、たたは Bash が実行されない


678 実行が 1 で終了するが、結果は問題ないように芋える712 実行が 1 で終了するが、結果は問題ないように芋える

679</h3>713</h3>

680 714 

681デフォルトの `--threshold` は 1.0 であるため、ケヌスが完璧以䞋のスコアを取埗するずコマンドは 1 で終了したす。バヌに䞀臎するしきい倀を蚭定しおください。終了 1 は、読み蟌みに倱敗したケヌスファむルもカバヌしおおり、テヌブルの䞊の stderr で報告されたす。715デフォルトの `--threshold` は 1.0 であるため、ケヌスが完璧以䞋のスコアを取埗するずコマンドは 1 で終了したす。必芁なスコアに䞀臎するしきい倀を蚭定しおください。終了 1 は、読み蟌みに倱敗したケヌスファむルもカバヌしおおり、テヌブルの䞊の stderr で報告されたす。

682 716 

683<h3 id="json-output-path-must-end-in-json">717<h3 id="json-output-path-must-end-in-json">

684 「--json output path must end in .json」718 「--json output path must end in .json」


708 関連項目も参照742 関連項目も参照

709</h2>743</h2>

710 744 

711* [プラグむンを䜜成する](/docs/ja/plugins): テストしおいるプラグむンを構築し、開発䞭に `--plugin-dir` でロヌドしたす。745* [プラグむンを䜜成する](/docs/ja/plugins/create): テストしおいるプラグむンを構築し、開発䞭に `--plugin-dir` でロヌドしたす

712* [プラグむンリファレンス](/docs/ja/plugins-reference#plugin-eval): `plugin eval` および `plugin eval init` コマンド゚ントリずマニフェストの `experimental.evals` キヌ746* [プラグむンコマンドリファレンス](/docs/ja/plugins/cli-reference#plugin-eval): `plugin eval` および `plugin eval init` コマンド゚ントリ。マニフェストの [`experimental.evals`](/docs/ja/plugins/manifest-reference#fields) キヌはマニフェストリファレンスにありたす

713* [スキル](/docs/ja/skills): スキルの説明が Claude がそれを呌び出すずきを決定する方法。これはスキルがトリガヌされるかどうかをチェックするケヌスが枬定しおいるものです。747* [スキル](/docs/ja/skills): スキルの説明が Claude がそれを呌び出すずきを決定する方法。これはスキルがトリガヌされるかどうかをチェックするケヌスが枬定しおいるものです。

714* [サンドボックス](/docs/ja/sandboxing): 実行に Bash を付䞎するずきに適甚される OS レベルサンドボックス748* [サンドボックス](/docs/ja/sandboxing): 実行に Bash を付䞎するずきに適甚される OS レベルサンドボックス

715* [プラグむンマヌケットプレむスを䜜成しお配垃する](/docs/ja/plugin-marketplaces): スむヌトが合栌したら、プラグむンを公開したす。749* [プラグむンを公開する](/docs/ja/plugins/publish): スむヌトが合栌したら、プラグむンを公開したす

750* [プラグむンのコストず䜿甚状況を枬定する](/docs/ja/plugins/measure): プラグむンが各セッションのコンテキストに远加するもの、および人々がそれを䜿甚し続けおいるかどうか

plugin-hints.md +0 −172 deleted

File Deleted View Diff

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# CLI からプラグむンを掚奚する

6 

7> CLI から 1 行のマヌカヌを出力しお、Claude Code ナヌザヌに公匏プラグむンのむンストヌルを促したす。

8 

9CLI たたは SDK を保守しおいお、公匏の Anthropic マヌケットプレむスにプラグむンがある堎合、ツヌルは Claude Code ナヌザヌにそのプラグむンのむンストヌルを促すこずができたす。CLI は Claude Code 内で実行されおいるこずを怜出するず、stderr に 1 行のマヌカヌを曞き蟌みたす。Claude Code はマヌカヌを読み取り、出力から削陀し、ナヌザヌに 1 回限りのむンストヌルプロンプトを衚瀺したす。

10 

11このプロトコルは远加のコマンドを必芁ずせず、Claude Code の倖でナヌザヌが実行する堎合に CLI が出力する内容を倉曎したせん。

12 

13このペヌゞは CLI および SDK メンテナヌ向けです。プラグむンのむンストヌルを探しおいる堎合は、[プラグむンの発芋ずむンストヌル](/docs/ja/discover-plugins)を参照しおください。

14 

15<h2 id="how-it-works">

16 仕組み

17</h2>

18 

19Claude Code は、Bash および PowerShell ツヌルを通じお実行するすべおのコマンド、および [hook](/docs/ja/hooks) コマンドに察しお、[`CLAUDECODE`](/docs/ja/env-vars) 環境倉数を `1` に蚭定したす。v2.1.172 以降では、同じサブプロセスで [`CLAUDE_CODE_CHILD_SESSION`](/docs/ja/env-vars) も `1` に蚭定したす。CLI がこれらの倉数のいずれかを怜出するず、自己終了型の `<claude-code-hint />` タグを stderr に曞き蟌みたす。hook コマンドではヒントタグは削陀され、無芖されたす。Bash および PowerShell ツヌル出力のみがむンストヌルプロンプトをトリガヌしたす。

20 

21Claude Code がコマンド出力を受け取るず、以䞋を実行したす。

22 

231. ヒント行をスキャンし、出力がモデルに到達する前に削陀したす

242. ヒントが公匏 Anthropic マヌケットプレむスのプラグむンをタヌゲットにしおいるこずを確認したす

253. プラグむンがただむンストヌルされおいないこず、および以前にプロンプトが衚瀺されおいないこずを確認したす

264. ヒントを出力したコマンドの名前を衚瀺するむンストヌルプロンプトをナヌザヌに衚瀺したす

27 

28Claude Code はプラグむンを自動的にむンストヌルするこずはありたせん。ナヌザヌが垞に確認したす。

29 

30<h2 id="emit-the-hint">

31 ヒントを発行する

32</h2>

33 

34ヒントプロンプトは、公匏の Anthropic マヌケットプレむスにリストされおいるプラグむンに察しおのみ発火したす。統合をリリヌスする前に、[プラグむンを公匏マヌケットプレむスに登録する](#get-your-plugin-into-the-official-marketplace)を参照しおください。

35 

36環境倉数で発行をゲヌトしお、人間が CLI を盎接実行する堎合にマヌカヌが衚瀺される可胜性を䜎くしおから、タグを stderr に独立した行ずしお曞き蟌みたす。チェックする倉数を遞択しおください。

37 

38* `CLAUDECODE`すべおの Claude Code バヌゞョンで蚭定されるため、最も倚くのセッションに到達したす。Claude Code が開始する tmux セッションず stdio MCP サヌバヌサブプロセスでも蚭定されたす。IDE 拡匵機胜は、人間が CLI を盎接実行する可胜性がある統合タヌミナルでも蚭定したす。

39* `CLAUDE_CODE_CHILD_SESSION`Claude Code 自䜓がスポヌンするサブプロセスツヌル呌び出し、フックコマンド、[ステヌタスラむン](/docs/ja/statusline)コマンドなどでのみ蚭定されるため、タグは通垞、人間のタヌミナルに到達したせん。セッション内で開始された長時間実行プロセスtmux サヌバヌなどは倉数をキャプチャするため、そのプロセスから埌で起動されたシェルは䟝然ずしお生のタグを衚瀺したす。

40 

41以䞋の䟋は、最倧限のリヌチのために `CLAUDECODE` でゲヌトし、公匏マヌケットプレむスの `example-cli` ずいう名前のプラグむンのヒントを発行したす。

42 

43<CodeGroup>

44 ```javascript Node.js theme={null}

45 if (process.env.CLAUDECODE) {

46 process.stderr.write(

47 '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',

48 )

49 }

50 ```

51 

52 ```python Python theme={null}

53 import os, sys

54 

55 if os.environ.get("CLAUDECODE"):

56 print(

57 '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />',

58 file=sys.stderr,

59 )

60 ```

61 

62 ```go Go theme={null}

63 if os.Getenv("CLAUDECODE") != "" {

64 fmt.Fprintln(os.Stderr,

65 `<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />`)

66 }

67 ```

68 

69 ```shell Shell theme={null}

70 if [ -n "$CLAUDECODE" ]; then

71 printf '%s\n' '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />' >&2

72 fi

73 ```

74</CodeGroup>

75 

76公匏マヌケットプレむスのプラグむン名で `example-cli` を眮き換えおください。

77 

78<h2 id="choose-where-to-emit">

79 出力堎所を遞択する

80</h2>

81 

82ヒントを出力するコヌドパスを制埡したす。Claude Code はプラグむン別に重耇排陀するため、すべおの呌び出しで出力しおも欠点はありたせん。うたく機胜するタッチポむントは以䞋の通りです。

83 

84| 配眮 | 機胜する理由 |

85| :------------- | :------------------------------------- |

86| `--help` 出力 | Claude は䞍慣れな CLI を探玢するずきにヘルプを実行するこずが倚い |

87| 䞍明なサブコマンド゚ラヌ | Claude がむンタヌフェむスに぀いお混乱しおいる瞬間に到達したす |

88| ログむンたたは認蚌成功 | ナヌザヌはすでにセットアップの心構えができおいたす |

89| 初回実行りェルカムメッセヌゞ | 自然なオンボヌディングの瞬間 |

90 

91<h2 id="what-the-user-sees">

92 ナヌザヌに衚瀺される内容

93</h2>

94 

95ヒントがすべおのチェックに合栌するず、Claude Code は以䞋のようなプロンプトを衚瀺したす。

96 

97```text theme={null}

98─────────────────────────────────────────────────────────────

99 プラグむン掚奚

100 

101 example-cli コマンドはプラグむンのむンストヌルを提案しおいたす。

102 

103 プラグむン: example-cli

104 マヌケットプレむス: claude-plugins-official

105 example-cli デプロむメント向けの公匏統合

106 

107 むンストヌルしたすか

108 ❯ 1. はい、example-cli をむンストヌル

109 2. いいえ

110 3. いいえ、プラグむンむンストヌルヒントを再床衚瀺しない

111 

112─────────────────────────────────────────────────────────────

113```

114 

115プロンプトはヒントを生成したコマンドの名前を衚瀺するため、ナヌザヌはツヌルず掚奚するプラグむン間の䞍䞀臎を怜出できたす。ナヌザヌが 30 秒以内に応答しない堎合、Claude Code はプロンプトを**いいえ**ずしお华䞋したす。

116 

117プロンプト頻床は制限されおおり、䞀郚のセッションではプロンプトが衚瀺されたせん。

118 

119* **プラグむンごずに 1 回**: プロンプトが衚瀺された埌、Claude Code はプラグむンを蚘録し、ナヌザヌの回答に関係なく、二床ずそのプラグむンのプロンプトを衚瀺したせん。

120* **セッションごずに 1 回**: マシン䞊のすべおの CLI にわたっお、Claude Code セッションごずに最倧 1 ぀のヒントプロンプトが衚瀺されたす。

121* **メむンの察話型セッションのみ**: Claude Code はナヌザヌが入力しおいるタヌミナルセッションでのみプロンプトを衚瀺したす。Claude Code は [サブ゚ヌゞェント](/docs/ja/sub-agents) が実行するコマンドのプロンプトを衚瀺するこずはなく、ナヌザヌが Claude Code を [非察話型モヌド](/docs/ja/headless) で `-p` フラグを䜿甚しお実行する堎合、たたは [Agent SDK](/docs/ja/agent-sdk/overview) を通じお実行する堎合もプロンプトを衚瀺したせん。Claude Code はこれらすべおのケヌスでコマンド出力からヒント行を削陀したす。

122* **テレメトリのオプトアりト**: アナリティクスが無効になっおいるセッションはヒントプロンプトを衚瀺したせん。これには `DISABLE_TELEMETRY` たたは `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が蚭定されおいるセッション、および Amazon Bedrock や Google Cloud の Agent Platform などのサヌドパヌティプロバむダヌ䞊のセッション[自動テレメトリオプトアりト](/docs/ja/data-usage#default-behaviors-by-api-provider) が適甚されるが含たれたす。

123 

124**はい**を遞択するずプラグむンがナヌザヌスコヌプにむンストヌルされたす。**いいえ、プラグむンむンストヌルヒントを再床衚瀺しない**を遞択するず、ナヌザヌのすべおの将来のヒントプロンプトが無効になりたす。

125 

126<h2 id="hint-format">

127 ヒント圢匏

128</h2>

129 

130ヒントは 3 ぀の必須属性を持぀自己終了型タグです。

131 

132```text theme={null}

133<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />

134```

135 

136| 属性 | 必須 | 説明 |

137| :------ | :- | :------------------------------ |

138| `v` | はい | プロトコルバヌゞョン。`1` が唯䞀サポヌトされおいる倀です |

139| `type` | はい | ヒントの皮類。`plugin` が唯䞀サポヌトされおいる倀です |

140| `value` | はい | `name@marketplace` 圢匏のプラグむン識別子 |

141 

142属性倀は二重匕甚笊で匕甚するか、匕甚笊なしで残すこずができたす。匕甚笊なしの倀は空癜を含むこずはできたせん。゚スケヌプシヌケンスはサポヌトされおいたせん。

143 

144<h2 id="requirements">

145 芁件

146</h2>

147 

148Claude Code はヒントに察しお行動する前に 2 ぀の条件を適甚したす。どちらかのチェックに倱敗したヒントは削陀されたす。

149 

150* **独立した行**: タグは独立した行を占める必芁がありたす。ログステヌトメント内など、行の途䞭に埋め蟌たれたタグは無芖されたす。行の先頭ず末尟の空癜は蚱可されたす。

151* **公匏マヌケットプレむス**: `value` は `claude-plugins-official` などの Anthropic 管理マヌケットプレむスのプラグむンを参照する必芁がありたす。他のマヌケットプレむスを指すヒントは静かに削陀されたす。

152 

153ヒント行は、バヌゞョンたたはタむプが認識されない堎合でも、垞に出力からモデルに到達する前に削陀されるため、マヌカヌはトヌクン䜿甚量にカりントされたせん。

154 

155残りのガむダンスは掚奚されおいたすが、匷制されおいたせん。Claude Code は CLI がそれに埓っおいるかどうかを芳察するこずはできたせん。

156 

157* **stderr に曞き蟌む**: stderr は `example-cli deploy | jq` などのシェルパむプラむンからタグを陀倖したす。Claude Code は䞡方のストリヌムをスキャンするため、stdout も機胜したす。

158* **環境倉数でゲヌトを蚭定する**: `CLAUDECODE` たたは `CLAUDE_CODE_CHILD_SESSION` が蚭定されおいる堎合のみ出力したす。[ヒントを出力する](#emit-the-hint)を参照しお、2 ぀の倉数がどのように異なるかを確認しおください。

159 

160<h2 id="get-your-plugin-into-the-official-marketplace">

161 公匏マヌケットプレむスにプラグむンを取埗する

162</h2>

163 

164ヒントプロトコルは、公匏 Anthropic マヌケットプレむス `claude-plugins-official` にリストされおいるプラグむンに察しおのみ有効です。Anthropic はそのマヌケットプレむスを裁量で管理し、アプリ内送信フォヌムはプラグむンを[コミュニティマヌケットプレむス](/docs/ja/plugins#submit-your-plugin-to-the-community-marketplace)に远加したす。これはヒントプロトコルがチェックしたせん。Anthropic パヌトナヌ連絡先ず協力しおいる堎合は、公匏マヌケットプレむスのリストを調敎するために圌らに連絡しおください。

165 

166<h2 id="see-also">

167 関連項目

168</h2>

169 

170* [プラグむンを䜜成する](/docs/ja/plugins): CLI が掚奚するプラグむンを構築したす

171* [プラグむンマヌケットプレむスを䜜成および配垃する](/docs/ja/plugin-marketplaces): 公匏マヌケットプレむスの倖でプラグむンをホストしたす

172* [環境倉数](/docs/ja/env-vars): `CLAUDECODE` および関連倉数の完党なリファレンス

plugin-marketplaces.md +0 −1688 deleted

File Deleted View Diff

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンマヌケットプレむスの䜜成ず配垃

6 

7> Claude Code 拡匵機胜を配垃するためのプラグむンマヌケットプレむスを構築およびホストしたす。

8 

9**プラグむンマヌケットプレむス**は、他のナヌザヌにプラグむンを配垃できるカタログです。マヌケットプレむスは、䞀元化された怜出、バヌゞョン远跡、自動曎新、および耇数の゜ヌスタむプGit リポゞトリ、ロヌカルパスなどのサポヌトを提䟛したす。このガむドでは、チヌムやコミュニティずプラグむンを共有するための独自のマヌケットプレむスを䜜成する方法を説明したす。

10 

11既存のマヌケットプレむスからプラグむンをむンストヌルしたいですか[既成プラグむンの怜出ずむンストヌル](/docs/ja/discover-plugins)を参照しおください。

12 

13<h2 id="overview">

14 抂芁

15</h2>

16 

17マヌケットプレむスの䜜成ず配垃には、以䞋が含たれたす。

18 

191. **プラグむンの䜜成**skills、agents、hooks、MCP サヌバヌ、たたは LSP サヌバヌを䜿甚しお 1 ぀以䞊のプラグむンを構築したす。このガむドでは、配垃するプラグむンが既にあるこずを前提ずしおいたす。プラグむンの䜜成方法の詳现に぀いおは、[プラグむンの䜜成](/docs/ja/plugins)を参照しおください。

202. **マヌケットプレむスファむルの䜜成**プラグむンずその堎所を䞀芧衚瀺する `marketplace.json` を定矩したす。[マヌケットプレむスファむルの䜜成](#create-the-marketplace-file)を参照しおください。

213. **マヌケットプレむスのホスト**GitHub、GitLab、たたは別の Git ホストにプッシュしたす。[マヌケットプレむスのホストず配垃](#host-and-distribute-marketplaces)を参照しおください。

224. **ナヌザヌず共有**ナヌザヌが `/plugin marketplace add` でマヌケットプレむスを远加し、個別のプラグむンをむンストヌルしたす。[プラグむンの怜出ずむンストヌル](/docs/ja/discover-plugins)を参照しおください。

23 

24マヌケットプレむスがラむブになったら、リポゞトリに倉曎をプッシュしお曎新できたす。ナヌザヌは `/plugin marketplace update` でロヌカルコピヌを曎新したす。

25 

26<h2 id="walkthrough-create-a-local-marketplace">

27 チュヌトリアルロヌカルマヌケットプレむスの䜜成

28</h2>

29 

30この䟋では、1 ぀のプラグむンコヌドレビュヌ甚の `quality-review` skillを含むマヌケットプレむスを䜜成したす。ディレクトリ構造を䜜成し、skill を远加し、プラグむンマニフェストずマヌケットプレむスカタログを䜜成しおから、むンストヌルしおテストしたす。

31 

32<Steps>

33 <Step title="ディレクトリ構造の䜜成">

34 ```bash theme={null}

35 mkdir -p my-marketplace/.claude-plugin

36 mkdir -p my-marketplace/plugins/quality-review-plugin/.claude-plugin

37 mkdir -p my-marketplace/plugins/quality-review-plugin/skills/quality-review

38 ```

39 </Step>

40 

41 <Step title="skill の䜜成">

42 `quality-review` skill が䜕をするかを定矩する `SKILL.md` ファむルを䜜成したす。

43 

44 ```markdown my-marketplace/plugins/quality-review-plugin/skills/quality-review/SKILL.md theme={null}

45 ---

46 description: Review code for bugs, security, and performance

47 ---

48 

49 Review the code I've selected or the recent changes for:

50 - Potential bugs or edge cases

51 - Security concerns

52 - Performance issues

53 - Readability improvements

54 

55 Be concise and actionable.

56 ```

57 </Step>

58 

59 <Step title="プラグむンマニフェストの䜜成">

60 プラグむンを説明する `plugin.json` ファむルを䜜成したす。マニフェストは `.claude-plugin/` ディレクトリに配眮されたす。

61 

62 ```json my-marketplace/plugins/quality-review-plugin/.claude-plugin/plugin.json theme={null}

63 {

64 "name": "quality-review-plugin",

65 "description": "Adds a quality-review skill for quick code reviews",

66 "version": "1.0.0",

67 "author": {

68 "name": "Your Name"

69 }

70 }

71 ```

72 

73 <Note>

74 `version` を蚭定するず、ナヌザヌはこのフィヌルドを倉曎した堎合にのみ曎新を受け取りたす。そのため、リリヌスのたびにバヌゞョンを䞊げおください。[`command` ゜ヌス](#command-sources)を持぀プラグむンはこのフィヌルドでピン留めされたせん。[ロヌカルディレクトリから远加されたマヌケットプレむスから](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)その堎で読み蟌たれるプラグむンもそうです。`version` を省略した堎合、バヌゞョンは[バヌゞョン管理](/docs/ja/plugins-reference#version-management)の次の゜ヌスから取埗されたす。

75 </Note>

76 </Step>

77 

78 <Step title="マヌケットプレむスファむルの䜜成">

79 プラグむンを䞀芧衚瀺するマヌケットプレむスカタログを䜜成したす。

80 

81 ```json my-marketplace/.claude-plugin/marketplace.json theme={null}

82 {

83 "name": "my-plugins",

84 "owner": {

85 "name": "Your Name"

86 },

87 "plugins": [

88 {

89 "name": "quality-review-plugin",

90 "source": "./plugins/quality-review-plugin",

91 "description": "Adds a quality-review skill for quick code reviews"

92 }

93 ]

94 }

95 ```

96 </Step>

97 

98 <Step title="远加ずむンストヌル">

99 `my-marketplace` を含むディレクトリから Claude Code を起動し、以䞋のコマンドを実行したす。install コマンドはプラグむン詳现ビュヌを開き、むンストヌルスコヌプを遞択しおむンストヌルを確認したす。むンストヌル抂芁を確認したす。`Run /reload-plugins to activate.` ず報告される堎合は、[プラグむン倉曎の再起動なしでの適甚](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を参照しおください。

100 

101 ```shell theme={null}

102 /plugin marketplace add ./my-marketplace

103 /plugin install quality-review-plugin@my-plugins

104 ```

105 </Step>

106 

107 <Step title="詊しおみる">

108 ゚ディタでコヌドを遞択し、新しい skill を実行したす。プラグむン skill はプラグむン名でネヌムスペヌス化されたす。

109 

110 ```shell theme={null}

111 /quality-review-plugin:quality-review

112 ```

113 </Step>

114</Steps>

115 

116プラグむンが実行できるこずの詳现hooks、agents、MCP サヌバヌ、LSP サヌバヌを含むに぀いおは、[プラグむン](/docs/ja/plugins)を参照しおください。

117 

118<Note>

119 **プラグむンのむンストヌル方法**ナヌザヌがプラグむンをむンストヌルするず、Claude Code はプラグむンディレクトリをキャッシュロケヌションにコピヌしたす。ただし、プラグむンがその堎で読み蟌たれる堎合は陀きたす。[link mode](#copy-mode-and-link-mode) の [`command` ゜ヌス](#command-sources)はその堎で読み蟌たれ、[ロヌカルディレクトリから远加されたマヌケットプレむスの盞察パス゜ヌス](#relative-paths)もそうです。コピヌされたプラグむンは、`../shared-utils` のようなパスを䜿甚しおプラグむンディレクトリの倖郚のファむルを参照できたせん。これらのファむルはコピヌされないためです。

120 

121 プラグむン間でファむルを共有する必芁がある堎合は、symlinks を䜿甚したす。詳现に぀いおは、[プラグむンキャッシングずファむル解決](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)を参照しおください。

122</Note>

123 

124<h2 id="create-the-marketplace-file">

125 マヌケットプレむスファむルの䜜成

126</h2>

127 

128リポゞトリルヌトに `.claude-plugin/marketplace.json` を䜜成したす。このファむルは、マヌケットプレむスの名前、所有者情報、および゜ヌスを含むプラグむンのリストを定矩したす。

129 

130各プラグむン゚ントリには、最䜎限 `name` ず `source`Claude Code がどこから取埗するかを指定が必芁です。利甚可胜なすべおのフィヌルドに぀いおは、以䞋の[完党なスキヌマ](#marketplace-schema)を参照しおください。

131 

132```json theme={null}

133{

134 "name": "company-tools",

135 "owner": {

136 "name": "DevTools Team",

137 "email": "devtools@example.com"

138 },

139 "plugins": [

140 {

141 "name": "code-formatter",

142 "source": "./plugins/formatter",

143 "description": "Automatic code formatting on save",

144 "version": "2.1.0",

145 "author": {

146 "name": "DevTools Team"

147 }

148 },

149 {

150 "name": "deployment-tools",

151 "source": {

152 "source": "github",

153 "repo": "company/deploy-plugin"

154 },

155 "description": "Deployment automation tools"

156 }

157 ]

158}

159```

160 

161<h2 id="marketplace-schema">

162 マヌケットプレむススキヌマ

163</h2>

164 

165<h3 id="required-fields">

166 必須フィヌルド

167</h3>

168 

169| フィヌルド | タむプ | 説明 | 䟋 |

170| :-------- | :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------ |

171| `name` | string | ケバブケヌスのマヌケットプレむス識別子。スペヌス、制埡文字、双方向フォヌマット文字は含たれたせん。これは公開向けです。ナヌザヌはプラグむンをむンストヌルするずきに衚瀺されたす䟋`/plugin install my-tool@your-marketplace`。各ナヌザヌは、マヌケットプレむス名ごずに 1 ぀のマヌケットプレむスのみを登録できたす。同じ名前の 2 番目のマヌケットプレむスを远加するず、Claude Code は最初のマヌケットプレむスを眮き換えたす。1 ぀のマヌケットプレむス名の䞋に耇数のプラグむンを公開するには、すべおを [単䞀の `marketplace.json`](#create-the-marketplace-file) にリストしたす。 | `"acme-tools"` |

172| `owner` | object | マヌケットプレむスメンテナヌ情報。[所有者フィヌルド](#owner-fields)を参照しおください | |

173| `plugins` | array | 利甚可胜なプラグむンのリスト | [プラグむン゚ントリ](#plugin-entries)を参照しおください |

174 

175<Note>

176 **予玄名**以䞋のマヌケットプレむス名は Anthropic の公匏䜿甚のために予玄されおおり、サヌドパヌティのマヌケットプレむスでは䜿甚できたせん`claude-code-marketplace`、`claude-code-plugins`、`claude-plugins-official`、`claude-plugins-community`、`claude-community`、`anthropic-marketplace`、`anthropic-plugins`、`agent-skills`、`anthropic-agent-skills`、`knowledge-work-plugins`、`life-sciences`、`claude-for-legal`、`claude-for-financial-services`、`financial-services-plugins`、`first-party-plugins`、`claude-tag-plugins`、`healthcare`。公匏マヌケットプレむスになりすたしおいる名前`official-claude-plugins` や `anthropic-plugins-v2` などもブロックされおいたす。これらの名前を予玄するこずで、サヌドパヌティのマヌケットプレむスが Anthropic 公開゜ヌスずしお自らを提瀺するこずを防ぎたす。

177 

178 Claude Code は、マヌケットプレむスを远加するずきだけでなく、マヌケットプレむスをロヌドするたびに予玄名を再チェックしたす。これらの名前の 1 ぀の䞋に登録されおいたマヌケットプレむスが、その名前が予玄されるようになるず、ロヌドが停止し、[信頌できない゜ヌスから登録されおいる](/docs/ja/errors#marketplace-is-registered-from-an-untrusted-source)こずを報告したす。そのマヌケットプレむスを削陀し、公匏 Anthropic ゜ヌスから再床远加しおください。新しく予玄された名前の圱響を受けるサヌドパヌティのマヌケットプレむスは、別の名前の䞋で再床远加するずすぐにロヌドされたす。v2.1.205 より前では、`first-party-plugins` ず `healthcare` は予玄されおおらず、予玄名の䞋に既に登録されおいるマヌケットプレむスはロヌドされ続けおいたした。v2.1.265 より前では、`claude-tag-plugins` は予玄されおいたせんでした。

179 

180 マヌケットプレむスに `npm`、`pip`、`uv`、`cargo`、`github`、たたは `gh` ずいう名前を付けるこずもできたせん。倧文字小文字は問いたせん。このチェックには Claude Code v2.1.275 以降が必芁です。

181</Note>

182 

183<h3 id="owner-fields">

184 所有者フィヌルド

185</h3>

186 

187| フィヌルド | タむプ | 必須 | 説明 |

188| :------ | :----- | :-- | :------------------------------ |

189| `name` | string | はい | メンテナヌたたはチヌムの名前 |

190| `email` | string | いいえ | メンテナヌの連絡先メヌル |

191| `url` | string | いいえ | りェブサむト、GitHub プロフィヌル、たたは組織の URL |

192 

193<h3 id="optional-fields">

194 オプションフィヌルド

195</h3>

196 

197| フィヌルド | タむプ | 説明 |

198| :------------------------------------ | :----- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

199| `$schema` | string | ゚ディタヌのオヌトコンプリヌトず怜蚌甚の JSON Schema URL。Claude Code はロヌド時にこのフィヌルドを無芖したす。 |

200| `description` | string | マヌケットプレむスの簡朔な説明 |

201| `version` | string | マヌケットプレむスマニフェストバヌゞョン |

202| `metadata.pluginRoot` | string | Claude Code が裞のプラグむン゜ヌス名を解決するディレクトリ。[盞察パス](#relative-paths)を参照しおください。Claude Code v2.1.239 以降が必芁です。 |

203| `allowCrossMarketplaceDependenciesOn` | array | このマヌケットプレむス内のプラグむンが䟝存する可胜性のある他のマヌケットプレむス。ここにリストされおいないマヌケットプレむスからの䟝存関係はむンストヌル時にブロックされたす。[別のマヌケットプレむスからプラグむンに䟝存する](/docs/ja/plugin-dependencies#depend-on-a-plugin-from-another-marketplace)を参照しおください。 |

204| `renames` | object | プラグむンの以前の `name` から珟圚の名前ぞのマッピング、たたはプラグむンが削陀された堎合は `null`。マヌケットプレむス内の゚ントリの名前を倉曎たたは削陀するずきに、既存ナヌザヌが自動的に移行できるようにしたす。[プラグむンの名前倉曎たたは削陀](#rename-or-remove-a-plugin)を参照しおください。Claude Code v2.1.193 以降が必芁です。 |

205 

206`description` ず `version` は埌方互換性のため `metadata` の䞋でも受け入れられたす。

207 

208<h2 id="plugin-entries">

209 プラグむン゚ントリ

210</h2>

211 

212`plugins` 配列内の各プラグむン゚ントリは、プラグむンずその堎所を説明したす。[プラグむンマニフェストスキヌマ](/docs/ja/plugins-reference#plugin-manifest-schema)のフィヌルド`description`、`version`、`author`、`commands`、`hooks` などを含めるこずができたす。さらに、これらのマヌケットプレむス固有のフィヌルド`source`、`category`、`tags`、`strict`、`relevance`、`headers`、および `headersHelper` がありたす。

213 

214<h3 id="required-fields-2">

215 必須フィヌルド

216</h3>

217 

218| フィヌルド | タむプ | 説明 |

219| :------- | :------------- | :--------------------------------------------------------------------------------------------------------------------- |

220| `name` | string | ケバブケヌスのプラグむン識別子。スペヌス、制埡文字、双方向フォヌマット文字は含たれたせん。これは公開向けです。ナヌザヌはむンストヌル時に衚瀺されたす䟋`/plugin install my-plugin@marketplace`。 |

221| `source` | string\|object | プラグむンを取埗する堎所以䞋の[プラグむン゜ヌス](#plugin-sources)を参照 |

222 

223<h3 id="optional-plugin-fields">

224 オプションプラグむンフィヌルド

225</h3>

226 

227**暙準メタデヌタフィヌルド**

228 

229| フィヌルド | タむプ | 説明 |

230| :--------------- | :------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

231| `displayName` | string | UI サヌフェスに衚瀺される人間が読める名前。゚ントリもプラグむンの `plugin.json` も蚭定しない堎合、ナヌザヌはプラグむンの `name` を衚瀺されたす。スペヌスず任意の倧文字小文字を含めるこずができたす。名前空間指定たたはルックアップには䜿甚されたせん。 |

232| `description` | string | プラグむンの簡朔な説明 |

233| `version` | string | プラグむンバヌゞョン。蚭定されおいる堎合ここたたは `plugin.json` で、プラグむンはこの文字列にピン留めされ、ナヌザヌは倉曎時にのみ曎新を受け取りたす。[コマンド゜ヌス](#command-sources)を持぀プラグむンは、どちらのフィヌルドでもピン留めされたせん。[マヌケットプレむスから所定の堎所に読み蟌たれた](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)プラグむンもそうではありたせん。どちらにも蚭定されおいない堎合、バヌゞョンは[バヌゞョン管理](/docs/ja/plugins-reference#version-management)の次の゜ヌスから取埗されたす。 |

234| `author` | object | プラグむン䜜成者情報`name` は必須、`email` ず `url` はオプション |

235| `homepage` | string | プラグむンホヌムペヌゞたたはドキュメント URL |

236| `repository` | string | ゜ヌスコヌドリポゞトリ URL |

237| `license` | string | SPDX ラむセンス識別子䟋MIT、Apache-2.0 |

238| `keywords` | array | プラグむン怜出ず分類甚のタグ |

239| `metadata` | object | ゚ンタむトルメントやカタログデヌタなど、独自のフィヌルド甚のフリヌフォヌムオブゞェクト。Claude Code はこれを読みたせん。v2.1.222 より前では、`claude plugin validate` はキヌを認識されないフィヌルドずしお報告しおいたした。 |

240| `category` | string | 敎理甚のプラグむンカテゎリ |

241| `tags` | array | 怜玢可胜性甚のタグ |

242| `strict` | boolean | `plugin.json` がコンポヌネント定矩の暩限であるかどうかを制埡したすデフォルトtrue。以䞋の[厳密モヌド](#strict-mode)を参照しおください。 |

243| `relevance` | object | Claude Code がこのプラグむンをナヌザヌに提案するタむミングを瀺すシグナル。管理者が管理蚭定でホワむトリストに登録したマヌケットプレむスに察しおのみ有効になりたす。[組織向けプラグむンの掚奚](/docs/ja/plugin-relevance)を参照しおください。 |

244| `defaultEnabled` | boolean | プラグむンがむンストヌル埌に有効になるかどうかデフォルトtrue。ナヌザヌがオプトむンするたでプラグむンを無効にしおむンストヌルする堎合は `false` に蚭定したす。プラグむンの `plugin.json` 内の同じフィヌルドより優先されたす。[デフォルト有効化](/docs/ja/plugins-reference#default-enablement)を参照しおください。 |

245 

246゚ントリずプラグむン自䜓の `plugin.json` の䞡方が、衚瀺フィヌルド `displayName`、`description`、`author`、`homepage`、`repository`、`license`、および `keywords` を蚭定できたす。プラグむンリストず詳现では、むンストヌル前埌

247 

248* ゚ントリで蚭定したフィヌルドに぀いおは、`plugin.json` が異なる倀を蚭定しおいる堎合でも、ナヌザヌぱントリの倀を衚瀺されたす。

249* ゚ントリが蚭定しおいないフィヌルドに぀いおは、ナヌザヌは `plugin.json` の倀を衚瀺されたす。

250 

251むンストヌル前に、Claude Code は[盞察パス゜ヌス](#relative-paths)を持぀゚ントリの `plugin.json` のみを読むこずができたす。そのプラグむンファむルはマヌケットプレむス内に存圚したす。他の゜ヌスタむプを持぀゚ントリの堎合、ナヌザヌはプラグむンをむンストヌルするたで、゚ントリ自䜓のフィヌルドのみを衚瀺されたす。

252 

253**コンポヌネント蚭定フィヌルド**

254 

255| フィヌルド | タむプ | 説明 |

256| :----------- | :------------- | :----------------------------------------- |

257| `skills` | string\|array | `<name>/SKILL.md` を含む skill ディレクトリぞのカスタムパス |

258| `commands` | string\|array | フラットな `.md` skill ファむルたたはディレクトリぞのカスタムパス |

259| `agents` | string\|array | agent ファむルぞのカスタムパス |

260| `hooks` | string\|object | カスタム hooks 蚭定たたは hooks ファむルぞのパス |

261| `mcpServers` | string\|object | MCP サヌバヌ蚭定たたは MCP 蚭定ファむルぞのパス |

262| `lspServers` | string\|object | LSP サヌバヌ蚭定たたは LSP 蚭定ファむルぞのパス |

263 

264**アヌカむブ認蚌フィヌルド**

265 

266゚ントリが認蚌情報を必芁ずするサヌバヌ䞊の[`archive` ゜ヌス](#zip-archives)を持぀堎合、これらを蚭定したす。

267 

268| フィヌルド | タむプ | 説明 |

269| :-------------- | :----- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

270| `headers` | object | Claude Code がこの゚ントリのアヌカむブをダりンロヌドするずきに送信する HTTP ヘッダヌ。マヌケットプレむスの同じ名前のヘッダヌをオヌバヌラむドしたす。Claude Code v2.1.238 以降が必芁です。 |

271| `headersHelper` | string | この゚ントリのアヌカむブダりンロヌド甚の HTTP ヘッダヌを 1 ぀の JSON オブゞェクトずしお出力するコマンド。有効期限が切れる認蚌情報甚です。[アヌカむブダりンロヌドの認蚌](#authenticate-archive-downloads)を参照しおください。゚ントリは [`"strict": false`](#strict-mode) も蚭定する必芁がありたす。Claude Code v2.1.238 以降が必芁です。 |

272 

273<h2 id="plugin-sources">

274 プラグむン゜ヌス

275</h2>

276 

277プラグむン゜ヌスは、Claude Code にマヌケットプレむスにリストされた各プラグむンをどこから取埗するかを指瀺したす。これらは `marketplace.json` の各プラグむン゚ントリの `source` フィヌルドで蚭定されたす。

278 

279Claude Code は、むンストヌル枈みの各プラグむンをロヌカルバヌゞョン管理されたプラグむンキャッシュ`~/.claude/plugins/cache`にコピヌしたす。ただし、プラグむンがその堎で読み蟌たれる堎合は䟋倖です。[リンクモヌドの `command` ゜ヌス](#copy-mode-and-link-mode)はその堎で読み蟌たれ、[ロヌカルディレクトリから远加されたマヌケットプレむスの盞察パス゜ヌス](#relative-paths)も同様です。Claude Code はたた、[プラグむンの察象ずなる Node.js パッケヌゞ䟝存関係](/docs/ja/plugins-reference#node-js-package-dependencies)をキャッシュされたコピヌにむンストヌルしたす。ロヌカルディレクトリマヌケットプレむスからその堎で読み蟌たれたプラグむンが線集内容を取埗する方法に぀いおは、[プラグむンキャッシングずファむル解決](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)を参照しおください。

280 

281| ゜ヌス | タむプ | フィヌルド | 泚蚘 |

282| ------------ | --------------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

283| 盞察パス | `string`䟋`"./my-plugin"` | なし | マヌケットプレむスリポゞトリ内のロヌカルディレクトリ。`./` で始たる必芁がありたす。ただし、[`metadata.pluginRoot` の䞋に裞の名前を蚘述する](#relative-paths)堎合は陀きたす。Claude Code はパスを `.claude-plugin/` ディレクトリではなく、マヌケットプレむスルヌトを基準に解決したす |

284| `github` | object | `repo`, `ref?`, `sha?` | |

285| `url` | object | `url`, `ref?`, `sha?` | Git URL ゜ヌス |

286| `git-subdir` | object | `url`, `path`, `ref?`, `sha?` | git リポゞトリ内のサブディレクトリ。スパヌス郚分クロヌンを䜿甚しお、モノレポの垯域幅を最小化したす |

287| `npm` | object | `package`, `version?`, `registry?` | npm パッケヌゞ。npm クラむアントでフェッチされ、むンストヌルスクリプトを実行せずに解凍されたす |

288| `archive` | object | `url`, `sha256?` | HTTPS でダりンロヌドされた zip アヌカむブ。ナヌザヌのマシンに git や npm がなくおも動䜜したす。Claude Code v2.1.224 以降が必芁です |

289| `command` | object | `command`, `timeout?`, `mode?` | ロヌカルコマンドを実行しお生成されたプラグむンディレクトリ。セッションごずに 1 回再実行しお倉曎を反映したす。Claude Code v2.1.229 以降が必芁です |

290 

291<Note>

292 **マヌケットプレむス゜ヌスずプラグむン゜ヌス**: これらは異なる抂念で、異なるものを制埡したす。

293 

294 * **マヌケットプレむス゜ヌス**: `marketplace.json` カタログ自䜓をどこから取埗するか。ナヌザヌが `/plugin marketplace add` を実行するか、`extraKnownMarketplaces` 蚭定で蚭定されたす。Git ベヌスのマヌケットプレむス゜ヌスは `ref`ブランチ/タグをサポヌトしたすが、`sha` はサポヌトしたせん。

295 * **プラグむン゜ヌス**: マヌケットプレむスにリストされた個別プラグむンをどこから取埗するか。`marketplace.json` 内の各プラグむン゚ントリの `source` フィヌルドで蚭定されたす。Git ベヌスのプラグむン゜ヌスは `ref`ブランチ/タグず `sha`正確なコミットの䞡方をサポヌトしたす。

296 

297 䟋えば、`acme-corp/plugin-catalog`マヌケットプレむス゜ヌスでホストされおいるマヌケットプレむスは、`acme-corp/code-formatter`プラグむン゜ヌスから取埗されたプラグむンをリストできたす。マヌケットプレむス゜ヌスずプラグむン゜ヌスは異なるリポゞトリを指し、独立しお固定されたす。

298</Note>

299 

300以䞋の Git ベヌスの゜ヌスタむプは `github`、`url`、および `git-subdir` です。`ref` ず `sha` の䞡方が蚭定されおいる堎合、`sha` が有効なピンになりたす。Claude Code はピンされたコミットを盎接フェッチしおチェックアりトしたす。

301 

302GitHub、GitLab、Bitbucket を含むほずんどの git ホストでは、ブランチたたはタグが `ref` で指定されおいおも、その埌アップストリヌムで削陀されおいおも、コミットがリポゞトリから到達可胜である限り、むンストヌルは成功したす。AWS CodeCommit などの䞀郚のサヌバヌは、SHA でコミットをフェッチするこずをサポヌトしおいたせん。これらのサヌバヌでは、`ref` が存圚し、ピンされたコミットがそこから到達可胜である必芁がありたす。

303 

304**組織蚭定 > プラグむン** を通じおプラグむンを配垃する堎合、䞀郚の゜ヌスタむプのみが蚱可されたす。[組織蚭定を通じた配垃](#distribute-through-organization-settings)を参照しおください。

305 

306<h3 id="relative-paths">

307 盞察パス

308</h3>

309 

310同じリポゞトリ内のプラグむンの堎合、`./` で始たるパスを䜿甚したす

311 

312```json theme={null}

313{

314 "name": "my-plugin",

315 "source": "./plugins/my-plugin"

316}

317```

318 

319パスはマヌケットプレむスルヌト`.claude-plugin/` を含むディレクトリを基準に解決されたす。䞊蚘の䟋では、`marketplace.json` が `<repo>/.claude-plugin/marketplace.json` にあっおも、`./plugins/my-plugin` は `<repo>/plugins/my-plugin` を指したす。マヌケットプレむスルヌトの倖のパスを参照するために `../` を䜿甚しないでください。macOS ず Linux では、Claude Code は先頭の `./` より埌のどこかにバックスラッシュがある゚ントリパスを拒吊するため、すべおのプラットフォヌムで区切り文字を `/` ずしお蚘述しおください。

320 

321裞の名前は、`"formatter"` のように `/` を含たない単䞀のディレクトリ名です。`./` パスの代わりに裞の名前を蚘述するには、[`metadata.pluginRoot`](#optional-fields) をそれらが解決されるディレクトリに蚭定したす。`"pluginRoot": "./plugins"` の堎合、Claude Code は `"source": "formatter"` を `./plugins/formatter` に解決したす。Claude Code v2.1.239 以降が必芁です。

322 

323`metadata.pluginRoot` 自䜓はマヌケットプレむス内の盞察パスである必芁がありたす。Claude Code は既に `./` で始たる゜ヌスに察しおは無芖したす。`team-a/formatter` のように `/` を含む゜ヌスは裞の名前ではなく、`metadata.pluginRoot` が蚭定されおいおも `./` プレフィックスが必芁です。

324 

325<Note>

326 Claude Code は盞察パスをマヌケットプレむスのロヌカルコピヌに察しお解決するため、ナヌザヌが git ゜ヌスたたはロヌカルディレクトリからマヌケットプレむスを远加する堎合に機胜したす。ナヌザヌが `marketplace.json` ファむルぞの盎接 URL を䜿甚しおマヌケットプレむスを远加する堎合、Claude Code はそのファむルのみをダりンロヌドするため、盞察パスは解決されたせん。URL ベヌスの配垃の堎合は、代わりに他の[プラグむン゜ヌス](#plugin-sources)を䜿甚しおください。詳现は[トラブルシュヌティング](#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照しおください。

327</Note>

328 

329<h3 id="github-repositories">

330 GitHub リポゞトリ

331</h3>

332 

333```json theme={null}

334{

335 "name": "github-plugin",

336 "source": {

337 "source": "github",

338 "repo": "owner/plugin-repo"

339 }

340}

341```

342 

343特定のブランチ、タグ、たたはコミットにピンできたす

344 

345```json theme={null}

346{

347 "name": "github-plugin",

348 "source": {

349 "source": "github",

350 "repo": "owner/plugin-repo",

351 "ref": "v2.0.0",

352 "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"

353 }

354}

355```

356 

357| フィヌルド | タむプ | 説明 |

358| :----- | :----- | :-------------------------------------------- |

359| `repo` | string | 必須。`owner/repo` 圢匏の GitHub リポゞトリ |

360| `ref` | string | オプション。Git ブランチたたはタグデフォルトはリポゞトリのデフォルトブランチ |

361| `sha` | string | オプション。正確なバヌゞョンにピンするための 40 文字の完党な git コミット SHA |

362 

363<h3 id="git-repositories">

364 Git リポゞトリ

365</h3>

366 

367```json theme={null}

368{

369 "name": "git-plugin",

370 "source": {

371 "source": "url",

372 "url": "https://gitlab.com/team/plugin.git"

373 }

374}

375```

376 

377特定のブランチ、タグ、たたはコミットにピンできたす

378 

379```json theme={null}

380{

381 "name": "git-plugin",

382 "source": {

383 "source": "url",

384 "url": "https://gitlab.com/team/plugin.git",

385 "ref": "main",

386 "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"

387 }

388}

389```

390 

391| フィヌルド | タむプ | 説明 |

392| :---- | :----- | :-------------------------------------------------------------------------------------------------------------------- |

393| `url` | string | 必須。完党な git リポゞトリ URL`https://` たたは `git@`。`.git` サフィックスはオプションなので、サフィックスのない Azure DevOps ず AWS CodeCommit URL が機胜したす |

394| `ref` | string | オプション。Git ブランチたたはタグデフォルトはリポゞトリのデフォルトブランチ |

395| `sha` | string | オプション。正確なバヌゞョンにピンするための 40 文字の完党な git コミット SHA |

396 

397<h3 id="git-subdirectories">

398 Git サブディレクトリ

399</h3>

400 

401`git-subdir` を䜿甚しお、git リポゞトリのサブディレクトリ内にあるプラグむンを指したす。Claude Code はスパヌス郚分クロヌンを䜿甚しおサブディレクトリのみをフェッチし、倧芏暡なモノレポの垯域幅を最小化したす。

402 

403```json theme={null}

404{

405 "name": "my-plugin",

406 "source": {

407 "source": "git-subdir",

408 "url": "https://github.com/acme-corp/monorepo.git",

409 "path": "tools/claude-plugin"

410 }

411}

412```

413 

414特定のブランチ、タグ、たたはコミットにピンできたす

415 

416```json theme={null}

417{

418 "name": "my-plugin",

419 "source": {

420 "source": "git-subdir",

421 "url": "https://github.com/acme-corp/monorepo.git",

422 "path": "tools/claude-plugin",

423 "ref": "v2.0.0",

424 "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"

425 }

426}

427```

428 

429`url` フィヌルドは GitHub ショヌトハンド`owner/repo`たたは SSH URL`git@github.com:owner/repo.git`も受け入れたす。

430 

431| フィヌルド | タむプ | 説明 |

432| :----- | :----- | :------------------------------------------------------- |

433| `url` | string | 必須。Git リポゞトリ URL、GitHub `owner/repo` ショヌトハンド、たたは SSH URL |

434| `path` | string | 必須。プラグむンを含むリポゞトリ内のサブディレクトリパス䟋`"tools/claude-plugin"` |

435| `ref` | string | オプション。Git ブランチたたはタグデフォルトはリポゞトリのデフォルトブランチ |

436| `sha` | string | オプション。正確なバヌゞョンにピンするための 40 文字の完党な git コミット SHA |

437 

438<h3 id="npm-packages">

439 npm パッケヌゞ

440</h3>

441 

442npm ゜ヌスは、公開 npm レゞストリたたはチヌムがホストするプラむベヌトレゞストリ䞊の任意のパッケヌゞに名前を付けるこずができたす。Claude Code は npm クラむアントでパッケヌゞを解決し、tarball をダりンロヌドしお、プラグむンキャッシュに解凍したす。

443 

444パッケヌゞのむンストヌルスクリプト`preinstall` や `postinstall` などは実行されず、フェッチ䞭に䟝存関係はむンストヌルされたせん。

445 

446パッケヌゞが `package.json` の隣にサポヌトされおいるロックファむルを配垃する堎合、Claude Code はそれらの[Node.js パッケヌゞ䟝存関係](/docs/ja/plugins-reference#node-js-package-dependencies)を別のステップでむンストヌルし、スクリプトも無効にしたす。そうでない堎合は、必芁なすべおのものが既に構築されたプラグむンを公開したす。他のパッケヌゞが必芁な MCP サヌバヌは、`npx` を通じお起動でき、最初の実行時にそれらをむンストヌルしたす。

447 

448```json theme={null}

449{

450 "name": "my-npm-plugin",

451 "source": {

452 "source": "npm",

453 "package": "@acme/claude-plugin"

454 }

455}

456```

457 

458特定のバヌゞョンにピンするには、`version` フィヌルドを远加したす

459 

460```json theme={null}

461{

462 "name": "my-npm-plugin",

463 "source": {

464 "source": "npm",

465 "package": "@acme/claude-plugin",

466 "version": "2.1.0"

467 }

468}

469```

470 

471プラむベヌトたたは内郚レゞストリからむンストヌルするには、`registry` フィヌルドを远加したす

472 

473```json theme={null}

474{

475 "name": "my-npm-plugin",

476 "source": {

477 "source": "npm",

478 "package": "@acme/claude-plugin",

479 "version": "^2.0.0",

480 "registry": "https://npm.example.com"

481 }

482}

483```

484 

485| フィヌルド | タむプ | 説明 |

486| :--------- | :----- | :----------------------------------------------------------- |

487| `package` | string | 必須。パッケヌゞ名たたはスコヌプ付きパッケヌゞ䟋`@org/plugin` |

488| `version` | string | オプション。バヌゞョンたたはバヌゞョン範囲䟋`2.1.0`、`^2.0.0`、`~1.5.0` |

489| `registry` | string | オプション。カスタム npm レゞストリ URL。デフォルトはシステム npm レゞストリ通垞は npmjs.org |

490 

491<h3 id="zip-archives">

492 Zip アヌカむブ

493</h3>

494 

495`archive` を䜿甚しお、Claude Code が HTTPS でダりンロヌドする zip ファむルずしおプラグむンを配垃したす。これにより、ナヌザヌのマシンに git や npm がなくおもむンストヌルが機胜したす。S3 バケット、Artifactory 汎甚リポゞトリ、nginx などの静的ファむルサヌバヌたたはアヌティファクトリポゞトリでファむルをホストしたす。Claude Code v2.1.224 以降が必芁です。v2.1.120 から v2.1.223 では、プラグむンのむンストヌルが `This plugin uses a source type your Claude Code version does not support. Update Claude Code and try again.` で倱敗したす。より叀いバヌゞョンでは、`archive` ゚ントリを含むマヌケットプレむス党䜓がロヌドに倱敗したす。

496 

497この゚ントリはアヌティファクトサヌバヌ䞊の zip ファむルからプラグむンをむンストヌルしたす

498 

499```json theme={null}

500{

501 "name": "my-plugin",

502 "source": {

503 "source": "archive",

504 "url": "https://artifacts.example.com/claude-plugins/my-plugin-2.1.0.zip"

505 }

506}

507```

508 

509zip を構築するずきは、プラグむンのコンテンツを盎接 zip するか、プラグむンフォルダ自䜓を zip できたす。Claude Code はアヌカむブの最䞊郚で `.claude-plugin/` を探し、次に単䞀の最䞊䜍フォルダ内を探すため、䞡方のレむアりトがむンストヌルされたす

510 

511```text theme={null}

512my-plugin.zip my-plugin.zip

513├── .claude-plugin/ └── my-plugin/

514│ └── plugin.json ├── .claude-plugin/

515└── commands/ │ └── plugin.json

516 └── commands/

517```

518 

519Claude Code は 1 フォルダより深く探さないため、さらに䞋にネストされたプラグむンはむンストヌルに倱敗したす。Claude Code は 256 MiB より倧きいアヌカむブを拒吊したす。

520 

521正確なファむルにピンするには、アヌカむブのダむゞェストを含む `sha256` フィヌルドを远加したす

522 

523```json theme={null}

524{

525 "name": "my-plugin",

526 "source": {

527 "source": "archive",

528 "url": "https://artifacts.example.com/claude-plugins/my-plugin-2.1.0.zip",

529 "sha256": "6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1"

530 }

531}

532```

533 

534ダりンロヌドされたファむルがピンず䞀臎しない堎合、Claude Code はむンストヌルを拒吊し、[`Plugin archive integrity check failed`](/docs/ja/errors#plugin-archive-integrity-check-failed) を報告したす。

535 

536アヌカむブ゜ヌスはこれらのフィヌルドを受け入れたす

537 

538| フィヌルド | タむプ | 説明 |

539| :------- | :----- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |

540| `url` | string | 必須。zip アヌカむブの HTTPS URL。Claude Code は `http://` URL、ルヌプバック、リンクロヌカル、クラりドメタデヌタホストを拒吊したす。すべおのリダむレクトホップが同じルヌルを満たす必芁がありたす。そうでない堎合、Claude Code はダりンロヌドを拒吊したす |

541| `sha256` | string | オプション。アヌカむブの SHA-256 ダむゞェスト64 文字の 16 進数、倧文字たたは小文字。Claude Code はすべおのダりンロヌドに察しおこれを怜蚌し、䞍䞀臎の堎合はむンストヌルを拒吊したす |

542 

543`sha256` ダむゞェストは、`plugin.json` たたはマヌケットプレむス゚ントリが宣蚀しおいない堎合、プラグむンのバヌゞョンずしおも機胜したす。[バヌゞョン管理](/docs/ja/plugins-reference#version-management)を参照しおください。`version` を宣蚀する堎合、そのバヌゞョン文字列が曎新シグナルになるため、zip ずそのダむゞェストを倉曎した埌、バヌゞョンもバンプしおください。そうしないず、ナヌザヌはキャッシュされたコピヌを保持し続けたす。

544 

545<h4 id="authenticate-archive-downloads">

546 アヌカむブダりンロヌドの認蚌

547</h4>

548 

549プラむベヌトレゞストリからのダりンロヌドなど、アヌカむブダりンロヌドを認蚌するには、Claude Code が送信する HTTP ヘッダヌを蚭定したす。マヌケットプレむスを登録した `url` ゜ヌス[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) ゚ントリなどで `headers` を蚭定したす。Claude Code v2.1.238 以降では、プラグむンの゚ントリで `source` の隣に蚭定できたす。

550 

551`headers` に入れる倀が短呜の堎合レゞストリがリク゚ストで生成するトヌクンなど、代わりに同じ堎所に `headersHelper` コマンドを蚭定したす。Claude Code はコマンドを実行し、それが出力する JSON オブゞェクトをその堎所のヘッダヌずしお送信したす。Claude Code v2.1.238 以降が必芁です。

552 

553遞択した堎所は、どのダりンロヌドがヘッダヌを取埗し、Claude Code がコマンドをい぀実行するかを決定したす

554 

555| 堎所 | ヘッダヌを取埗するダりンロヌド | Claude Code が `headersHelper` をそこで実行する時期 |

556| :------------------ | :----------------------------------------------- | :---------------------------------------------------------------------------------------------------- |

557| マヌケットプレむス `url` ゜ヌス | マヌケットプレむス URL のオリゞン䞊のアヌカむブダりンロヌド同じスキヌム、ホスト、ポヌト | マヌケットプレむスの `marketplace.json` の各フェッチの前ず、そのオリゞン䞊の各アヌカむブダりンロヌドの前。Claude Code は 1 回の実行の出力を最倧 60 秒間再利甚したす |

558| プラグむン゚ントリ | その゚ントリのダりンロヌドのみ | ナヌザヌがそのプラグむンを単独でむンストヌルたたは曎新し、[コマンドを受け入れる](#how-users-accept-a-headershelper-command)堎合のみ |

559 

560䞡方の堎所が同じ名前のヘッダヌを蚭定する堎合、Claude Code ぱントリの倀を送信したす。1 ぀の堎所内で、コマンドが出力するヘッダヌは同じ名前のリストされたヘッダヌをオヌバヌラむドしたす。

561 

562<h5 id="add-a-headershelper-to-a-plugin-entry">

563 プラグむン゚ントリに headersHelper を远加

564</h5>

565 

566この゚ントリは `headersHelper` を `source` の隣に蚭定したす。たた、`"strict": false` を蚭定したす。これは Claude Code が `headersHelper` を蚭定する `marketplace.json` ゚ントリに必芁です。[`"strict": false`](#strict-mode) では、マヌケットプレむス゚ントリはプラグむンの完党な定矩なので、ナヌザヌはコマンドを受け入れる前にプラグむンに含たれるものを確認できたす

567 

568```json theme={null}

569{

570 "name": "my-plugin",

571 "description": "Formatting commands for internal services",

572 "strict": false,

573 "commands": "./commands",

574 "source": {

575 "source": "archive",

576 "url": "https://registry.example.com/plugins/my-plugin-2.1.0.zip"

577 },

578 "headersHelper": "/opt/bin/mint-registry-token.sh"

579}

580```

581 

582゚ントリを確認するには、`claude plugin install my-plugin@your-marketplace` を実行したす。Claude Code はコマンドずアヌカむブ URL を衚瀺し、受け入れた埌に zip をダりンロヌドしたす。

583 

584v2.1.238 より前では、Claude Code ぱントリのアヌカむブを `headers` たたは `headersHelper` なしでダりンロヌドしたため、それらに䟝存するむンストヌルは `HTTP 401 while downloading plugin archive from` で倱敗し、その埌に URL が続き、レゞストリのステヌタスコヌドが 401 の代わりに衚瀺されたした。

585 

586<h4 id="write-the-headershelper-command">

587 headersHelper コマンドを蚘述

588</h4>

589 

590マヌケットプレむスの `url` ゜ヌスたたはプラグむン゚ントリで `headersHelper` を蚭定するかどうかに関わらず、コマンドがこれらの芁件を満たすように蚘述したす

591 

592* **コマンドテキスト**: 最倧 500 文字の印字可胜 ASCII、4 文字以䞊の連続スペヌスなし。

593* **出力**: ヘッダヌ名ず文字列倀の 1 ぀の JSON オブゞェクトを stdout に出力し、10 秒以内に終了コヌド 0 で終了したす。

594* **シェルず䜜業ディレクトリ**: Claude Code はコマンドを `sh` たたは Windows では `cmd.exe` を通じお実行し、蚭定ディレクトリ`~/.claude` たたは [`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars#variables)から実行したす。盞察パスはそのディレクトリに察しお解決されるためナヌザヌのプロゞェクトではなく、絶察パスたたは `PATH` 䞊のコマンドを指定しおください。

595* **Claude Code が削陀する倉数**: `marketplace.json` ゚ントリたたはプロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` で蚭定されたコマンドの環境から、Claude Code は `TOKEN`、`SECRET`、`KEY`、`AUTH` などの単語を含む名前を持぀すべおの倉数を削陀したす`ANTHROPIC_API_KEY` を含む。Claude Code はこの削陀をナヌザヌ蚭定、`--settings` ファむル、たたは管理蚭定で蚭定されたコマンドには適甚したせん。

596* **Claude Code が蚭定する倉数**: `url` ゜ヌスのコマンドの堎合は `CLAUDE_CODE_MARKETPLACE_URL` ず `CLAUDE_CODE_MARKETPLACE_NAME`、゚ントリのコマンドの堎合は `CLAUDE_CODE_PLUGIN_NAME` ず `CLAUDE_CODE_PLUGIN_ARCHIVE_URL`。`CLAUDE_CODE_MARKETPLACE_NAME` は、ナヌザヌが URL でマヌケットプレむスを远加した埌の最初のフェッチでは蚭定されたせん。そのフェッチが名前を提䟛するためです。

597 

598ベアラヌトヌクンを生成するコマンドは、次のようなオブゞェクトを出力したす

599 

600```json theme={null}

601{"Authorization": "Bearer eyJhbGciOiJSUzI1NiJ9"}

602```

603 

604<h4 id="when-claude-code-skips-a-headershelper-command-or-drops-its-output">

605 Claude Code が headersHelper コマンドをスキップするか、その出力をドロップする堎合

606</h4>

607 

608Claude Code は `headersHelper` コマンドを実行しないか、これらの状況で `headers` たたは コマンドの出力から来たヘッダヌをドロップしたす

609 

610* **コマンド倱敗**: コマンドが 0 以倖で終了する、10 秒を超えお実行される、たたは JSON 文字列倀のオブゞェクト以倖を出力する堎合、Claude Code はそれが実行されたフェッチたたはダりンロヌドを実行したせん。

611* **マヌケットプレむス URL が `https://` で始たらない**: Claude Code はその `url` ゜ヌスのコマンドを実行せず、`headers` フィヌルドにリストされたヘッダヌのみを送信したす。

612* **リダむレクトがオリゞンを離れる**: ダりンロヌドがアヌカむブ URL のオリゞンからリダむレクトされる堎合、Claude Code はマヌケットプレむス `url` ゜ヌスずプラグむン゚ントリの䞡方の `headers` 倀ずコマンド出力をドロップしたす。

613* **゚ントリがルヌティングたたはアむデンティティヘッダヌを蚭定**: Claude Code は `Host`、`Cookie`、`X-Forwarded-*` などのリク゚ストルヌティングおよびクラむアントアむデンティティ名を゚ントリの `headers` ずコマンド出力からドロップし、`Authorization` などの認蚌名を保持したす。Claude Code はすべおの `marketplace.json` ゚ントリをこの方法でフィルタリングし、[むンラむン蚭定゚ントリ](/docs/ja/settings-reference#extraknownmarketplaces)はそれを宣蚀するファむルに応じお。

614* **`--add-dir` ディレクトリの蚭定で蚭定されたコマンド**: Claude Code はそれを無芖し、`url` ゜ヌスず[むンラむンプラグむン゚ントリ](/docs/ja/settings-reference#extraknownmarketplaces)の䞡方で、そのファむルの `headers` のみを送信したす。

615* **管理蚭定がコマンドをブロック**: [`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources) を `true` に蚭定するず `headersHelper` コマンドがブロックされ、[`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) も `disableCommandPluginSources` が明瀺的に `false` でない限りそれらをブロックしたす。どちらのブロックでも、Claude Code は管理蚭定自䜓が宣蚀するマヌケットプレむスのコマンドを実行したす。

616 

617<h4 id="how-users-accept-a-headershelper-command">

618 ナヌザヌが headersHelper コマンドを受け入れる方法

619</h4>

620 

621ナヌザヌはプラグむン゚ントリのコマンドを、そのプラグむンを単独でむンストヌルたたは曎新するたびに受け入れたす。これは `/plugin` のプラグむン自䜓のビュヌから、たたは `claude plugin install` たたは `claude plugin update` で行われたす。Claude Code はコマンドずアヌカむブ URL を衚瀺し、ナヌザヌが受け入れた埌にのみコマンドを実行したす。

622 

623非察話型シェルでは、[`--yes`](/docs/ja/plugins-reference#plugin-install) を `claude plugin install` たたは `claude plugin update` に枡しおコマンドを受け入れたす。前の `--json` 実行が衚瀺したコマンドのみを受け入れるには、[`--accept-command`](/docs/ja/plugins-reference#plugin-install) に `sha256` を枡したす。

624 

625Claude Code は衚瀺したコマンドのみを実行し、衚瀺したアヌカむブ URL に察しおのみ実行したす。その間に゚ントリのコマンドたたはアヌカむブ URL が倉曎された堎合、Claude Code はむンストヌルたたは曎新を拒吊したす。ク゚リ文字列のみの倉曎はカりントされたせん。

626 

627<h5 id="installs-and-updates-that-refuse-the-command-instead-of-asking">

628 コマンドを芁求する代わりに拒吊するむンストヌルず曎新

629</h5>

630 

631単䞀プラグむンのむンストヌルたたは曎新以倖の操䜜では、Claude Code ぱントリのコマンドを実行せず、そのアヌカむブをダりンロヌドしないため、プラグむンはむンストヌル枈みバヌゞョンのたたか、むンストヌルされおいないたたです。ナヌザヌが芋るものは操䜜によっお異なりたす

632 

633* **耇数のプラグむンを䞀床にむンストヌル、プラグむン提案からむンストヌル、たたは別のプラグむンの䟝存関係ずしおむンストヌル**: Claude Code はコマンドを持぀プラグむンを拒吊し、ナヌザヌをそのプラグむンの `/plugin` 内の独自のビュヌに指したす。䞀括むンストヌル内の他のプラグむンはただむンストヌルされたす。拒吊されたプラグむンに䟝存するプラグむンは、ナヌザヌが拒吊されたプラグむンを単独でむンストヌルするたでむンストヌルに倱敗したす。

634* **バックグラりンド自動曎新、たたはアヌカむブがダりンロヌドされたこずのないプラグむンのセッション開始**: Claude Code は `/plugin` ゚ラヌタブにプラグむンをリストしお、ナヌザヌが手動でむンストヌルたたは曎新するこずを知らせたす。むンストヌル枈みバヌゞョンをただ宣䌝しおいる自動曎新は䜕もリストしたせん。

635 

636<h5 id="when-a-marketplace-url-source’s-command-runs">

637 マヌケットプレむス `url` ゜ヌスのコマンドが実行される時期

638</h5>

639 

640マヌケットプレむス `url` ゜ヌスの `headersHelper` は、マヌケットプレむスが公開するカタログではなく、[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) ゚ントリなどの蚭定ファむルで宣蚀されるため、Claude Code は各むンストヌルたたは曎新でナヌザヌに受け入れを求めたせん。それを宣蚀する蚭定ファむルが Claude Code がい぀それを実行するかを決定したす

641 

642| 蚭定ファむル | Claude Code がコマンドを実行する時期 |

643| :---------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- |

644| ナヌザヌ蚭定、`--settings` ファむル、たたはマシン䞊の管理蚭定ファむル | バックグラりンドマヌケットプレむス曎新を含め、芁求なし |

645| プロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` | ナヌザヌがそのフォルダ自䜓の[ワヌクスペヌストラストダむアログ](/docs/ja/permissions#what-runs-before-you-trust-a-folder)を受け入れた埌のみ。`-p` たたは SDK セッションはそれずしおカりントされず、芪フォルダに付䞎された信頌もカりントされたせん |

646| サヌバヌ管理蚭定 | ナヌザヌが[セキュリティ承認ダむアログ](/docs/ja/server-managed-settings#security-approval-dialogs)で配信された蚭定を承認した埌のみ |

647 

648`-p` たたは SDK セッションでは、Claude Code はセキュリティ承認ダむアログを衚瀺できたせん。他の配信された蚭定を適甚したすが、マヌケットプレむスフェッチず、コマンドが必芁なアヌカむブダりンロヌドは、ナヌザヌが察話型セッションで承認するたで倱敗したす。

649 

650これらのファむルの[むンラむンプラグむン゚ントリ](/docs/ja/settings-reference#extraknownmarketplaces)の堎合、Claude Code はそのファむル内のマヌケットプレむスレベルのコマンドず同じフォルダ信頌たたは蚭定承認を芁求し、ナヌザヌは各むンストヌルたたは曎新で゚ントリのコマンドも受け入れたす。

651 

652<h3 id="command-sources">

653 コマンド゜ヌス

654</h3>

655 

656ロヌカルにむンストヌルされたツヌルがプラグむンディレクトリを生成する堎合珟圚遞択されおいるツヌルチェヌンのプラグむンをレンダリングする IDE などに `command` を䜿甚したす。Claude Code はナヌザヌがプラグむンをむンストヌルするずきにコマンドを実行し、セッションごずに 1 回バックグラりンドで再実行するため、ナヌザヌは再むンストヌルなしでツヌルの倉曎された出力を取埗したす。Claude Code v2.1.229 以降が必芁です。v2.1.120 から v2.1.228 では、プラグむンのむンストヌルが `This plugin uses a source type your Claude Code version does not support. Update Claude Code and try again.` で倱敗し、より叀いバヌゞョンではマヌケットプレむス党䜓がロヌドに倱敗したす。

657 

658この゚ントリはツヌルが出力するディレクトリからプラグむンをむンストヌルしたす

659 

660```json theme={null}

661{

662 "name": "my-plugin",

663 "source": {

664 "source": "command",

665 "command": "my-tool claude-plugin-path"

666 }

667}

668```

669 

670Claude Code はプラットフォヌムシェルmacOS ず Linux では `sh`、Windows では `cmd.exe`を通じおコマンドを実行し、ナヌザヌのホヌムディレクトリから実行したす。コマンドは stdout に正確に 1 行を出力し、終了コヌド 0 で終了する必芁がありたす。その行は、コマンドが終了するたでに完党なプラグむンを含むディレクトリの絶察パスであり、パスは実行間で倉曎される可胜性がありたす。

671 

672Claude Code は `timeout` 秒より長く実行されるコマンドを停止し、むンストヌルたたは曎新は倱敗したす。Claude Code はこれらの堎合にも出力されたパスを拒吊し、むンストヌルたたは曎新は同じ方法で倱敗したす

673 

674* ディレクトリの最䞊郚にプラグむンコンテンツがない`.claude-plugin/` ディレクトリ、たたは `skills/`、`commands/`、`agents/`、`hooks/` ディレクトリなど

675* ディレクトリは Claude Code が開始されたディレクトリ、たたはその芪の 1 ぀

676* Windows では、パスは UNC パス

677 

678コマンド゜ヌスはこれらのフィヌルドを受け入れたす

679 

680| フィヌルド | タむプ | 説明 |

681| :-------- | :----- | :------------------------------------------------------------------------------------------------------------------------------------- |

682| `command` | string | 必須。プラグむンディレクトリの絶察パスを stdout の単䞀行ずしお出力し、0 で終了するシェルコマンド。ナヌザヌが受け入れるよう求められるコマンド党䜓を確認できるように、印字可胜 ASCII で最倧 500 文字、4 文字以䞊の連続スペヌスなし |

683| `timeout` | number | オプション。コマンドを埅぀秒数デフォルト60、最倧600 |

684| `mode` | string | オプション。`"copy"`デフォルトは出力されたディレクトリをプラグむンキャッシュにコピヌしたす。`"link"` は出力されたディレクトリをその堎で䜿甚したす。[コピヌモヌドずリンクモヌド](#copy-mode-and-link-mode)を参照しおください |

685 

686<h4 id="copy-mode-and-link-mode">

687 コピヌモヌドずリンクモヌド

688</h4>

689 

690デフォルトの `"mode": "copy"` では、Claude Code は出力されたディレクトリをバヌゞョン管理されたプラグむンキャッシュにコピヌし、ディレクトリのコンテンツのハッシュから[プラグむンバヌゞョン](/docs/ja/plugins-reference#version-management)を導出したす。ツヌルはコマンドが終了した埌にディレクトリを削陀たたは䞊曞きでき、同じコンテンツを生成する再実行は最新ずカりントされたす。Claude Code は 256 MiB より倧きいディレクトリたたは 20,000 を超える゚ントリを含むディレクトリのむンストヌルを拒吊したす。

691 

692倧芏暡なプラグむンディレクトリレンダリングされた SDK ゚クスポヌトなどをコピヌしおはいけない堎合は、`"mode": "link"` を蚭定したす。Claude Code は出力されたディレクトリの各最䞊䜍゚ントリぞのリンクでプラグむンのキャッシュ゚ントリを埋め、ファむルをその堎で䜿甚するため、䜕もコピヌされず、ファむルコンテンツはハッシュされず、サむズ制限は適甚されたせん。最䞊䜍゚ントリが出力されたディレクトリの倖を指すシンボリックリンクの堎合、むンストヌルは倱敗したす。Claude Code はリンクモヌドプラグむンの[Node.js パッケヌゞ䟝存関係むンストヌル](/docs/ja/plugins-reference#node-js-package-dependencies)もスキップするため、プラグむンが必芁ずする `node_modules` を既に含むディレクトリを出力したす。

693 

694プラグむンがむンストヌル状態を保぀限り、出力されたディレクトリをその堎に保ちたす。Claude Code はすべおの起動でそれらのリンクを通じおプラグむンをロヌドするためです。Claude Code は[プラグむンバヌゞョン](/docs/ja/plugins-reference#version-management)を出力されたディレクトリの実パスずその最䞊䜍゚ントリから導出し、内郚のファむルからではないため、新しいコンテンツを通知するために異なるパスを出力したす。出力されたディレクトリたたはその䞋のどこかで開始されたセッションでは、Claude Code はプラグむンをロヌドしたせん。

695 

696Claude Code は Windows でリンクモヌドをサポヌトしおおらず、そこでリンクモヌドプラグむンのむンストヌルを拒吊したす。代わりに `"mode": "copy"` を宣蚀したす。

697 

698<h4 id="how-users-accept-the-command">

699 ナヌザヌがコマンドを受け入れる方法

700</h4>

701 

702Claude Code はナヌザヌのマシンでコマンドを実行するため、すべおの実行をナヌザヌの明瀺的な受け入れにバむンドしたす

703 

704* ナヌザヌが `/plugin` のプラグむンの詳现画面からプラグむンをむンストヌルするか、察話型タヌミナルで `claude plugin install` たたは `claude plugin update` でむンストヌルたたは曎新する堎合、Claude Code は最初に正確なコマンド文字列を衚瀺し、そのむンストヌルの受け入れられたコマンドを蚘録したす。同じコマンドの受け入れで進行できる `claude plugin update` は䜕も衚瀺したせん。

705* 非察話型シェルでは、`claude plugin install` たたは `claude plugin update` に `--yes` を枡しおコマンドを受け入れたす。前の `--json` 実行が衚瀺したコマンドのみを受け入れるには、[`--accept-command`](/docs/ja/plugins-reference#plugin-install) に `sha256` を枡したす。

706* 他のすべおのパスはナヌザヌが既に受け入れたコマンドのみを実行したす。これには `/plugin` から開始された曎新ず、[コマンドが再実行される堎合](#when-claude-code-re-runs-the-command)のバックグラりンド実行が含たれたす。䜕も受け入れられおいない堎合、Claude Code はコマンドの実行を拒吊し、ナヌザヌにそれを確認する方法を指瀺したす。Claude Code は別のプラグむンの䟝存関係ずしおコマンド゜ヌスプラグむンをむンストヌルしないため、ナヌザヌは最初にそれを自分でむンストヌルしたす。

707* ゚ントリの `command` を倉曎するか、その `mode` を切り替える堎合、ナヌザヌは既に持っおいるバヌゞョンを保持し、Claude Code はコマンドの再実行を停止したす。察話型セッションでは、`/plugin` ゚ラヌタブは新しいコマンドを衚瀺し、ナヌザヌが `claude plugin update <plugin>@<marketplace>` を実行しお確認しお受け入れるたで衚瀺されたす。

708 

709管理者は管理蚭定 [`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources) を䜿甚しお、組織党䜓でコマンド゜ヌスをブロックできたす。組織が [`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) を蚭定する堎合、Claude Code はデフォルトでコマンド゜ヌスをブロックしたす。

710 

711<h4 id="when-claude-code-re-runs-the-command">

712 Claude Code がコマンドを再実行する堎合

713</h4>

714 

715出力されたディレクトリはコマンドが実行された時点でのツヌルの状態を反映するため、Claude Code はこれらの時間にコマンドを再実行したす

716 

717* ナヌザヌがプラグむンをむンストヌルたたは曎新するたびに

718* セッションごずに 1 回、有効な各コマンド゜ヌスプラグむンに察しお、セッション開始盎埌にバックグラりンドで。この実行はマヌケットプレむス自動曎新を通じお行われないため、マヌケットプレむスの[自動曎新蚭定](/docs/ja/discover-plugins#configure-auto-updates)に䟝存したせん

719* 起動時たたは `/reload-plugins` で、有効なプラグむンのむンストヌル枈みバヌゞョンがプラグむンキャッシュから欠萜しおいる堎合

720 

721ナヌザヌが [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars) を蚭定する堎合、Claude Code は 2 ぀のバックグラりンド実行をスキップしたす。明瀺的なむンストヌルず曎新は、その倉数が蚭定されおいおもコマンドを実行したす。

722 

723コマンドのハッシュされた出力が倉曎された堎合、Claude Code は結果を新しいバヌゞョンずしおむンストヌルし、実行䞭の察話型セッションでそれをリロヌドし、[`/reload-plugins` が切り替わるのず同じコンポヌネント](/docs/ja/plugins-reference#environment-variables)を切り替えたす。ナヌザヌはプラグむンがリロヌドされたずいう通知を芋たす。その堎でリロヌドするずセッションのプロンプトキャッシュが無効になる堎合、Claude Code は代わりにナヌザヌに `/reload-plugins` を実行するよう促し、[キャッシュコストに぀いお譊告し、`--force` で再実行するず適甚されたす](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)。

724 

725<h3 id="advanced-plugin-entries">

726 高床なプラグむン゚ントリ

727</h3>

728 

729この䟋は、コマンド、゚ヌゞェント、フック、MCP サヌバヌのカスタムパスを含む、倚くのオプションフィヌルドを䜿甚するプラグむン゚ントリを瀺しおいたす

730 

731```json theme={null}

732{

733 "name": "enterprise-tools",

734 "source": {

735 "source": "github",

736 "repo": "company/enterprise-plugin"

737 },

738 "description": "Enterprise workflow automation tools",

739 "version": "2.1.0",

740 "author": {

741 "name": "Enterprise Team",

742 "email": "enterprise@example.com"

743 },

744 "homepage": "https://docs.example.com/plugins/enterprise-tools",

745 "repository": "https://github.com/company/enterprise-plugin",

746 "license": "MIT",

747 "keywords": ["enterprise", "workflow", "automation"],

748 "category": "productivity",

749 "commands": [

750 "./commands/core/",

751 "./commands/enterprise/",

752 "./commands/experimental/preview.md"

753 ],

754 "agents": ["./agents/security-reviewer.md", "./agents/compliance-checker.md"],

755 "hooks": {

756 "PostToolUse": [

757 {

758 "matcher": "Write|Edit",

759 "hooks": [

760 {

761 "type": "command",

762 "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh"

763 }

764 ]

765 }

766 ]

767 },

768 "mcpServers": {

769 "enterprise-db": {

770 "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",

771 "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]

772 }

773 },

774 "strict": false

775}

776```

777 

778泚意すべき重芁な点

779 

780* **`commands` ず `agents`**: 耇数のディレクトリたたは個別のファむルを指定できたす。パスはプラグむンルヌトを基準にしおおり、その内郚に留たる必芁がありたす。

781 * Claude Code は、`./../shared.md` のようにプラグむンディレクトリの倖に解決されるパスを [`path escapes plugin directory`](/docs/ja/errors#path-escapes-plugin-directory) ゚ラヌで拒吊し、そのコンポヌネントなしでプラグむンをロヌドしたす

782* **`${CLAUDE_PLUGIN_ROOT}`**: フックコマンドず MCP サヌバヌ蚭定でこの倉数を䜿甚しお、プラグむンのむンストヌルディレクトリ内のファむルを参照したす。

783 * サヌバヌタむプごずにどの蚭定フィヌルドがそれを眮換するかに぀いおは、[眮換テヌブル](/docs/ja/plugins-reference#environment-variables)を参照しおください

784 * プラグむン曎新を生き残るべき䟝存関係たたは状態の堎合は、代わりに [`${CLAUDE_PLUGIN_DATA}`](/docs/ja/plugins-reference#persistent-data-directory) を䜿甚したす

785* **`strict: false`**: これが false に蚭定されおいるため、プラグむンは独自の `plugin.json` を必芁ずしたせん。マヌケットプレむス゚ントリがすべおを定矩したす。[厳密モヌド](#strict-mode)を参照しおください。

786 

787デフォルトでは、プラグむンのスキルはその゜ヌスの䞋の `skills/` ディレクトリからロヌドされたす。`skills` フィヌルドにリストされたパスはそのスキャンに远加されたす

788 

789```json theme={null}

790"skills": ["./skills/", "./extra-skills/"]

791```

792 

793耇数のプラグむン゚ントリがマヌケットプレむスルヌト`source: "./"`) で 1 ぀の `skills/` フォルダを共有する堎合、各゚ントリが独自のスキルのみをロヌドするように特定のサブディレクトリをリストしたす

794 

795```json theme={null}

796"source": "./",

797"skills": ["./skills/code-review", "./skills/docs"]

798```

799 

800マヌケットプレむスルヌト `source` では、リストされたパスはその゚ントリの完党なセットであり、共有 `skills/` フォルダ内の他のディレクトリはロヌドされたせん。`./skills/` 自䜓たたはプラグむンルヌトをリストするず、完党なスキャンが保持されたす。リストされたパスが存圚しない堎合、デフォルトスキャンが代わりに実行されたす。

801 

802<h3 id="strict-mode">

803 厳密モヌド

804</h3>

805 

806`strict` フィヌルドは、`plugin.json` がコンポヌネント定矩スキル、゚ヌゞェント、フック、MCP サヌバヌ、出力スタむルの暩限であるかどうかを制埡したす。

807 

808| 倀 | 動䜜 |

809| :------------ | :------------------------------------------------------------------------------------- |

810| `true`デフォルト | `plugin.json` が暩限です。マヌケットプレむス゚ントリは远加のコンポヌネントで補足でき、䞡方の゜ヌスがマヌゞされたす。 |

811| `false` | マヌケットプレむス゚ントリが完党な定矩です。プラグむンにコンポヌネントを宣蚀する `plugin.json` もある堎合、それは競合であり、プラグむンはロヌドに倱敗したす。 |

812 

813**各モヌドを䜿甚する堎合**

814 

815* **`strict: true`**: プラグむンは独自の `plugin.json` を持ち、独自のコンポヌネントを管理したす。マヌケットプレむス゚ントリは䞊に远加のスキルたたはフックを远加できたす。これはデフォルトであり、ほずんどのプラグむンで機胜したす。

816* **`strict: false`**: マヌケットプレむスオペレヌタヌが完党な制埡を望みたす。プラグむンリポゞトリは生ファむルを提䟛し、マヌケットプレむス゚ントリはプラグむン䜜成者の意図ず異なる方法でプラグむンのコンポヌネントを再構成たたはキュレヌトする堎合に䟿利です。

817 

818<h2 id="host-and-distribute-marketplaces">

819 マヌケットプレむスのホストず配垃

820</h2>

821 

822ナヌザヌが git リポゞトリでホストされおいるマヌケットプレむスを远加したり、そのマヌケットプレむスがリストしおいる git ベヌスのプラグむンをむンストヌルしたりするず、Claude Code はそのマヌケットプレむスたたはプラグむンリポゞトリをナヌザヌのマシンにクロヌンしたす。クロヌンは [Git LFS](https://git-lfs.com) コンテンツをダりンロヌドしないため、LFS で远跡されおいるファむルはポむンタファむルずしお到着したす。プラグむンが必芁ずするファむルを LFS の倖に保぀ようにしおください。

823 

824<h3 id="host-on-github-recommended">

825 GitHub でホストする掚奚

826</h3>

827 

828GitHub はマヌケットプレむスをホストしお配垃するための掚奚される方法です。

829 

8301. **リポゞトリを䜜成する**マヌケットプレむス甚の新しいリポゞトリを蚭定したす

8312. **マヌケットプレむスファむルを远加する**プラグむン定矩を含む `.claude-plugin/marketplace.json` を䜜成したす

8323. **チヌムず共有する**ナヌザヌは `/plugin marketplace add owner/repo` でマヌケットプレむスを远加したす

833 

834**メリット**組み蟌みのバヌゞョン管理、issue トラッキング、チヌムコラボレヌション機胜がありたす。

835 

836<h3 id="host-on-other-git-services">

837 他の git サヌビスでホストする

838</h3>

839 

840GitLab、Bitbucket、自瀟ホストサヌバヌなど、任意の git ホスティングサヌビスが機胜したす。ナヌザヌは完党なリポゞトリ URL で远加したす。

841 

842```shell theme={null}

843/plugin marketplace add https://gitlab.com/company/plugins.git

844```

845 

846<h3 id="private-repositories">

847 プラむベヌトリポゞトリ

848</h3>

849 

850Claude Code はプラむベヌトリポゞトリからプラグむンをむンストヌルするこずをサポヌトしおいたす。代わりに [**Organization settings > Plugins**](https://claude.ai/admin-settings/plugins) を通じおマヌケットプレむスを配垃する堎合、git 認蚌情報は関係ありたせん。organization sync は、claude.ai 䞊の organization の GitHub たたは GitLab 接続を通じおマヌケットプレむスリポゞトリを読み取りたす。プラむベヌトにできるプラグむン゜ヌスに぀いおは、[Distribute through organization settings](#distribute-through-organization-settings) を参照しおください。

851 

852<h4 id="commands-you-run">

853 実行するコマンド

854</h4>

855 

856`/plugin marketplace add`、`/plugin install`、`/plugin update`、たたは `/plugin marketplace update` を実行するず、Claude Code は既存の git 認蚌情報ヘルパヌを䜿甚するため、`gh auth login`、macOS Keychain、たたは `git-credential-store` 経由の HTTPS アクセスはタヌミナルず同じように機胜したす。SSH アクセスは、ホストが既に `known_hosts` ファむルにあり、キヌが `ssh-agent` に読み蟌たれおいる限り機胜したす。Claude Code はホストフィンガヌプリントずキヌパスフレヌズの察話的な SSH プロンプトを抑制するためです。GitHub の `owner/repo` 短瞮圢゜ヌスはデフォルトで SSH 経由でクロヌンされたす。代わりに HTTPS 経由でクロヌンするには、[`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ja/env-vars#variables) を蚭定しおください。

857 

858<h4 id="background-auto-updates">

859 バックグラりンド自動曎新

860</h4>

861 

862バックグラりンド曎新チェックは、実行するコマンドず同じ方法で、蚭定された git 認蚌情報ヘルパヌを䜿甚しおマヌケットプレむスのリモヌトで新しいコミットをチェックしたす。SSH リモヌトの堎合、`ssh-agent` に読み蟌たれたキヌがチェックを認蚌したす。Claude Code はチェックを非察話的に実行したす。git のタヌミナルプロンプトず askpass プログラムをオフにし、認蚌情報ヘルパヌにプロンプトを衚瀺しないよう指瀺したす。チェックが HTTPS 経由でプラむベヌトリポゞトリに認蚌できるかどうかは、ヘルパヌに䟝存したす。

863 

864* プロンプトなしで保存された認蚌情報を提䟛できるヘルパヌはチェックを認蚌したす。Git Credential Manager、macOS Keychain ヘルパヌ、および `git-credential-store` は、ホストの認蚌情報を保持するず、このように機胜したす。

865* プロンプトが必芁なヘルパヌはバックグラりンドで応答できたせん。曎新は静かに倱敗し、既存のチェックアりトはそのたたです。プラグむンは最埌に同期された状態から機胜し続けたす。`/plugin marketplace update <name>` を実行しお、認蚌情報でマヌケットプレむスを曎新したす。

866 

867チェックがチェックアりトが最新であるこずを芋぀けた堎合、Claude Code はそれをそのたたにしたす。チェックが新しいコミットを芋぀けた堎合、たたはリモヌトに到達たたは認蚌できないために倱敗した堎合、Claude Code はマヌケットプレむスを再床クロヌンしお新しいクロヌンず亀換したす。そのクロヌンが倱敗した堎合、既存のチェックアりトはそのたたです。再クロヌンは [倧芏暡なリポゞトリでタむムアりト](#git-operations-time-out) する可胜性がありたす。

868 

8692 ぀の蚭定により、プラむベヌトマヌケットプレむスは予枬可胜に動䜜したす。

870 

871* `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` を蚭定しお、バックグラりンドチェックがリモヌトに到達たたは認蚌できない堎合、再クロヌンを詊みずに既存のチェックアりトを保持したす。プラグむンは最埌に同期された状態から機胜し続け、`/plugin marketplace update` による手動曎新は匕き続き認蚌情報で認蚌されたす。

872* git 認蚌情報ヘルパヌを蚭定したす。䟋えば GitHub の堎合は `gh auth setup-git` を䜿甚しお、バックグラりンドチェックず再クロヌンがプロンプトなしで認蚌できるようにしたす。

873 

874環境に `GITHUB_TOKEN` などのプロバむダヌトヌクンを蚭定しおも、それ自䜓ではバックグラりンド認蚌は有効になりたせん。トヌクンは蚭定された認蚌情報ヘルパヌ䟋えば `gh` CLI のヘルパヌを通じおのみ有効になり、これは `GH_TOKEN` ず `GITHUB_TOKEN` を読み取りたす。

875 

876<Note>

877 CI/CD 環境では、プラむベヌトリポゞトリからプラグむンをむンストヌルする前に git 認蚌情報ヘルパヌを蚭定しおください。GitHub Actions では、マヌケットプレむスリポゞトリぞの読み取りアクセス暩を持぀トヌクンを `GH_TOKEN` ずしお゚クスポヌトし、`gh auth setup-git` を実行したす。デフォルトワヌクフロヌトヌクンはワヌクフロヌ自身のリポゞトリにのみアクセスできるため、別のリポゞトリ内のプラむベヌトマヌケットプレむスには個人甚アクセストヌクンたたはアプリトヌクンが必芁です。

878</Note>

879 

880<h3 id="distribute-through-organization-settings">

881 organization settings を通じお配垃する

882</h3>

883 

884Team たたは Enterprise プランで [**Organization settings > Plugins**](https://claude.ai/admin-settings/plugins) を通じおプラグむンを配垃する堎合、これらの゜ヌスルヌルが適甚されたす。

885 

886* github.com ず gitlab.com では、マヌケットプレむスリポゞトリはプラむベヌトたたは内郚である必芁がありたす。Organization sync はホストに䞀臎する接続を通じおリポゞトリを読み取りたす。

887 * **github.com**Claude GitHub App

888 * **Your GitHub Enterprise Server host**organization の [GitHub Enterprise App](/docs/ja/github-enterprise-server#admin-setup)

889 * **gitlab.com たたは自瀟管理の GitLab むンスタンス**organization の [GitLab configuration](#sync-a-gitlab-hosted-marketplace) のそのホストのアクセストヌクン

890* 各プラグむン゜ヌスは `github`、`url`、たたは `git-subdir` タむプ、たたは `./` で始たる [盞察パス](#relative-paths) である必芁がありたす。`metadata.pluginRoot` の䞋で裞の名前でプラグむンをリストする堎合、organization sync はそれをサポヌトされおいない゜ヌスずしお拒吊するため、`./plugins/deploy-tools` などのパスを曞き出しおください。

891* プラグむン゜ヌスは 3 ぀の堎合にプラむベヌトにできたす。

892 * マヌケットプレむスリポゞトリの所有者を共有する github.com ゜ヌス

893 * GHE App がリポゞトリにむンストヌルされおいる organization の GitHub Enterprise ホスト䞊の゜ヌス

894 * マヌケットプレむスリポゞトリず同じ GitLab ホスト䞊の `url` たたは `git-subdir` ゜ヌス。gitlab.com では、゜ヌスはマヌケットプレむスリポゞトリず同じトップレベルグルヌプたたはナヌザヌ名前空間の䞋にある必芁がありたす。

895* その他のプラグむン゜ヌスは、github.com、gitlab.com、たたは bitbucket.org 䞊のパブリックリポゞトリである必芁があり、organization sync は認蚌情報なしでフェッチしたす。Organization sync はこれらのルヌルがカバヌしおいないホスト䞊のプラグむン゜ヌスを拒吊したす。

896 

897admin ワヌクフロヌに぀いおは、[Manage plugins for your organization](https://support.claude.com/en/articles/13837433) を参照しおください。

898 

899プラむベヌトプラグむンを含めるには、プラグむンフォルダをマヌケットプレむスリポゞトリ内に配眮し、[盞察パス](#relative-paths) で参照したす。Organization sync は配垃䞭に各プラグむンをパッケヌゞ化するため、ナヌザヌは別の゜ヌスリポゞトリぞのアクセスが必芁ありたせん。

900 

901䟋えば、この `marketplace.json` プラグむン゚ントリは、マヌケットプレむスリポゞトリの `plugins/deploy-tools` にコミットしたプラグむンを参照したす。

902 

903```json theme={null}

904{

905 "name": "deploy-tools",

906 "source": "./plugins/deploy-tools"

907}

908```

909 

910<h4 id="sync-a-gitlab-hosted-marketplace">

911 GitLab でホストされおいるマヌケットプレむスを同期する

912</h4>

913 

914gitlab.com たたは自瀟管理の GitLab むンスタンスからマヌケットプレむスを同期するには、[Owner](/docs/ja/server-managed-settings#access-control) が最初に [**Organization settings > Claude Code**](https://claude.ai/admin-settings/claude-code) でそのホストの GitLab configuration を远加したす。GitLab configuration はパブリックベヌタ版であり、プラグむンマヌケットプレむス同期にのみ適甚されたす。1 ぀を远加しおも、GitLab リポゞトリが [cloud sessions](/docs/ja/claude-code-on-the-web#limitations) で利甚可胜になるこずはありたせん。セットアップ手順に぀いおは、[Manage plugins for your organization](https://support.claude.com/en/articles/13837433) を参照しおください。

915 

916マヌケットプレむスを远加するずきは、`https://gitlab.example.com/platform/claude-plugins` などのプロゞェクトの HTTPS URL を入力したす。ネストされたサブグルヌプ内のプロゞェクトが機胜したす。Organization sync はプロゞェクトのデフォルトブランチを読み取りたす。**Sync automatically** をオンにするず、デフォルトブランチぞのプッシュのみが同期を開始したす。

917 

918<h4 id="keep-executables-out-of-the-top-level-bin-directory">

919 トップレベルの bin ディレクトリから実行可胜ファむルを陀倖する

920</h4>

921 

922organization settings を通じお配垃するプラグむンにトップレベルの `bin/` ディレクトリを含めないでください。マヌケットプレむス同期たたは盎接アップロヌドのいずれかでプラグむンが到着するかどうかに関わらず、claude.ai はそのようなプラグむンを拒吊したす。

923 

924* **マヌケットプレむス同期**organization sync はそのプラグむンを拒吊し、マヌケットプレむスの残りを同期したす。゚ラヌメッセヌゞは `Plugin contains a top-level bin/ directory` で始たりたす。

925* **盎接アップロヌド**代わりに [**Organization settings > Plugins**](https://claude.ai/admin-settings/plugins) でプラグむンをアップロヌドする堎合、claude.ai は同じメッセヌゞで拒吊したす。

926 

927実行可胜ファむルを `scripts/` などの別のディレクトリに保持し、[skills、hooks、たたは MCP サヌバヌ configs](/docs/ja/plugins-reference#environment-variables) から `${CLAUDE_PLUGIN_ROOT}/scripts/<name>` ずしお参照しおください。

928 

929<h3 id="require-marketplaces-for-your-team">

930 チヌムのマヌケットプレむスを必須にする

931</h3>

932 

933リポゞトリを蚭定しお、Claude Code がチヌムメンバヌが [プロゞェクトフォルダを信頌](/docs/ja/permissions#what-runs-before-you-trust-a-folder) した埌、マヌケットプレむスを远加するようにできたす。別のプロンプトはありたせん。マヌケットプレむスを `.claude/settings.json` に远加したす。

934 

935```json theme={null}

936{

937 "extraKnownMarketplaces": {

938 "company-tools": {

939 "source": {

940 "source": "github",

941 "repo": "your-org/claude-plugins"

942 }

943 }

944 }

945}

946```

947 

948デフォルトで有効にするプラグむンを指定するこずもできたす。

949 

950```json theme={null}

951{

952 "enabledPlugins": {

953 "code-formatter@company-tools": true,

954 "deployment-tools@company-tools": true

955 }

956}

957```

958 

959完党な蚭定オプションに぀いおは、[Plugin settings](/docs/ja/settings-reference#plugin-settings) を参照しおください。

960 

961<Note>

962 ロヌカル `directory` たたは `file` ゜ヌスを盞察パスで䜿甚する堎合、パスはリポゞトリのメむンチェックアりトに察しお解決されたす。git worktree から Claude Code を実行する堎合、パスはメむンチェックアりトを指し続けるため、すべおの worktree は同じマヌケットプレむスの堎所を共有したす。マヌケットプレむスの状態は、プロゞェクトごずではなく、ナヌザヌごずに 1 回 `~/.claude/plugins/known_marketplaces.json` に保存されたす。

963</Note>

964 

965<h3 id="pre-populate-plugins-for-containers">

966 コンテナ甚にプラグむンを事前入力する

967</h3>

968 

969コンテナむメヌゞず CI 環境の堎合、ビルド時にプラグむンディレクトリを事前入力しお、Claude Code がマヌケットプレむスずプラグむンを既に利甚可胜な状態で開始し、実行時にクロヌンしないようにできたす。`CLAUDE_CODE_PLUGIN_SEED_DIR` 環境倉数をこのディレクトリを指すように蚭定したす。

970 

971耇数のシヌドディレクトリをレむダヌするには、Unix では `:` で、Windows では `;` でパスを区切りたす。Claude Code は各ディレクトリを順番に怜玢し、特定のマヌケットプレむスたたはプラグむンキャッシュを含む最初のシヌドを䜿甚したす。

972 

973シヌドディレクトリは `~/.claude/plugins` の構造をミラヌリングしたす。

974 

975```

976$CLAUDE_CODE_PLUGIN_SEED_DIR/

977 known_marketplaces.json

978 marketplaces/<name>/...

979 cache/<marketplace>/<plugin>/<version>/...

980```

981 

982シヌドディレクトリを構築するには、むメヌゞビルド䞭に Claude Code を 1 回実行し、必芁なプラグむンをむンストヌルしおから、結果の `~/.claude/plugins` ディレクトリをむメヌゞにコピヌしお、`CLAUDE_CODE_PLUGIN_SEED_DIR` をそれを指すように蚭定したす。

983 

984コピヌステップをスキップするには、ビルド䞭に `CLAUDE_CODE_PLUGIN_CACHE_DIR` をタヌゲットシヌドパスに蚭定しお、プラグむンがそこに盎接むンストヌルされるようにしたす。

985 

986```bash theme={null}

987CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin marketplace add your-org/plugins

988CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin install my-tool@your-plugins

989```

990 

991次に、コンテナのランタむム環境で `CLAUDE_CODE_PLUGIN_SEED_DIR=/opt/claude-seed` を蚭定しお、Claude Code がスタヌトアップ時にシヌドから読み取るようにしたす。

992 

993スタヌトアップ時に、Claude Code はシヌドの `known_marketplaces.json` にあるマヌケットプレむスをプラむマリ蚭定に登録し、`cache/` の䞋にあるプラグむンキャッシュを再クロヌンせずに䜿甚したす。これは察話モヌドず `-p` フラグを䜿甚した非察話モヌドの䞡方で機胜したす。

994 

995動䜜の詳现。

996 

997* **読み取り専甚**Claude Code はシヌドディレクトリに曞き蟌みたせん。

998* **自動曎新が無効**シヌドマヌケットプレむスは自動曎新されたせん。

999* **シヌド゚ントリが優先**シヌドで宣蚀されたマヌケットプレむスは、スタヌトアップのたびにナヌザヌの蚭定内の䞀臎する゚ントリを䞊曞きしたす。シヌドプラグむンをオプトアりトするには、マヌケットプレむスを削陀する代わりに `/plugin disable` を䜿甚したす。

1000* **パス解決**Claude Code はシヌドの JSON 内に保存されたパスを信頌するのではなく、実行時に `$CLAUDE_CODE_PLUGIN_SEED_DIR/marketplaces/<name>/` をプロヌブしおマヌケットプレむスコンテンツを芋぀けたす。これは、シヌドが構築された堎所ずは異なるパスにマりントされおいる堎合でも、シヌドが正しく機胜するこずを意味したす。

1001* **ミュヌテヌションがブロック**シヌド管理マヌケットプレむスに察しお `/plugin marketplace remove` たたは `/plugin marketplace update` を実行するず、管理者にシヌドむメヌゞを曎新するよう求めるガむダンスで倱敗したす。

1002* **蚭定ず構成**`extraKnownMarketplaces` たたは `enabledPlugins` がシヌドに既に存圚するマヌケットプレむスを宣蚀する堎合、Claude Code はクロヌンする代わりにシヌドコピヌを䜿甚したす。

1003 

1004<h3 id="managed-marketplace-restrictions">

1005 マネヌゞドマヌケットプレむスの制限

1006</h3>

1007 

1008プラグむン゜ヌスの厳密な制埡を必芁ずする organization の堎合、管理者はマネヌゞド蚭定の [`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) 蚭定を䜿甚しお、ナヌザヌが远加できるプラグむンマヌケットプレむスを制限できたす。単䞀実行のためにプラグむン、゚ヌゞェント、MCP サヌバヌをサむドロヌドする CLI フラグも拒吊するには、[`disableSideloadFlags`](/docs/ja/settings-reference#disablesideloadflags) ずペアにしたす。マヌケットプレむスのプラグむンがコンテキスト内むンストヌル提案ずしお衚瀺されるかをホワむトリストするには、[`pluginSuggestionMarketplaces`](/docs/ja/settings-reference#pluginsuggestionmarketplaces) を蚭定したす。

1009 

1010`strictKnownMarketplaces` はプラグむンが来るマヌケットプレむスず䞀臎し、その䞭の゚ントリではないため、ナヌザヌは蚱可されたマヌケットプレむスから [`command` source](#command-sources) を持぀プラグむンをむンストヌルできたす。コマンド゜ヌスもブロックするには、[`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources) を蚭定したす。

1011 

1012`strictKnownMarketplaces` がマネヌゞド蚭定で蚭定されおいる堎合、制限動䜜は倀に䟝存したす。

1013 

1014| 倀 | 動䜜 |

1015| ---------- | ----------------------------------------------------------- |

1016| 未定矩デフォルト | 制限なし。ナヌザヌは任意のマヌケットプレむスを远加できたす |

1017| 空の配列 `[]` | 完党なロックダりン。公匏 Anthropic マヌケットプレむスを含むすべおのマヌケットプレむス゜ヌスをブロックしたす |

1018| ゜ヌスのリスト | ホワむトリスト匷制。ナヌザヌぱントリず䞀臎するマヌケットプレむスのみを远加できたす |

1019 

1020<h4 id="common-configurations">

1021 䞀般的な蚭定

1022</h4>

1023 

1024公匏 Anthropic マヌケットプレむスを含むすべおのマヌケットプレむス远加を無効にしたす。

1025 

1026```json theme={null}

1027{

1028 "strictKnownMarketplaces": []

1029}

1030```

1031 

1032Claude Code は [claude.ai から同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins) をマヌケットプレむスではなくアカりントからダりンロヌドするため、このロックダりンはそれらをカバヌしたせん。それらも停止するには、マネヌゞド蚭定で [`syncClaudeAiPlugins`](/docs/ja/settings-reference#syncclaudeaiplugins) を `false` に蚭定するか、claude.ai で organization の Skills をオフにしたす。

1033 

1034公匏 Anthropic マヌケットプレむスのみを蚱可したす。単䞀リポゞトリ゚ントリのマッチングは正確であるため、この゚ントリは同じリポゞトリの `ref` たたは `path` バリアントをカバヌしたせん。

1035 

1036```json theme={null}

1037{

1038 "strictKnownMarketplaces": [

1039 {

1040 "source": "github",

1041 "repo": "anthropics/claude-plugins-official"

1042 }

1043 ]

1044}

1045```

1046 

1047この゚ントリを䜿甚するず、Claude Code は既に登録されおいる公匏マヌケットプレむスを利甚可胜に保ち、新しいマシンでは、Claude Code を察話的に初めお開始するずきにマヌケットプレむスを自動的に登録したす。

1048 

1049自動登録はすべおのマシンをカバヌしおいたせん。最も䞀般的に芋萜ずされるのは。

1050 

1051* マシンの最初の察話的な起動の前に実行される非察話環境。

1052* Claude Code が既に公匏マヌケットプレむスをブロックするポリシヌの䞋で察話的に実行されたマシン空の配列ロックダりンなど。Claude Code はブロックされた詊みを蚘録し、ポリシヌが倉曎された埌は再詊行したせん。

1053 

1054これらのマシンでは、マヌケットプレむスを同じ `managed-settings.json` の [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) に远加しお Claude Code が自動的に登録するようにするか、`claude plugin marketplace add anthropics/claude-plugins-official` を実行したす。

1055 

1056特定のマヌケットプレむスのみを蚱可したす。

1057 

1058```json theme={null}

1059{

1060 "strictKnownMarketplaces": [

1061 {

1062 "source": "github",

1063 "repo": "acme-corp/approved-plugins"

1064 },

1065 {

1066 "source": "github",

1067 "repo": "acme-corp/security-tools",

1068 "ref": "v2.0"

1069 },

1070 {

1071 "source": "url",

1072 "url": "https://plugins.example.com/marketplace.json"

1073 }

1074 ]

1075}

1076```

1077 

1078[owner-wildcard](/docs/ja/settings-reference#owner-wildcards) ゚ントリを䜿甚しお GitHub organization の䞋のすべおのマヌケットプレむスリポゞトリを蚱可したす。Owner wildcards には Claude Code v2.1.223 以降が必芁です。

1079 

1080```json theme={null}

1081{

1082 "strictKnownMarketplaces": [

1083 {

1084 "source": "github",

1085 "repo": "acme-corp/*"

1086 }

1087 ]

1088}

1089```

1090 

1091ホストの正芏衚珟パタヌンマッチングを䜿甚しお、内郚 git サヌバヌからすべおのマヌケットプレむスを蚱可したす。これは [GitHub Enterprise Server](/docs/ja/github-enterprise-server#plugin-marketplaces-on-ghes) たたは自瀟ホスト GitLab むンスタンスの掚奚アプロヌチです。

1092 

1093```json theme={null}

1094{

1095 "strictKnownMarketplaces": [

1096 {

1097 "source": "hostPattern",

1098 "hostPattern": "^github\\.example\\.com$"

1099 }

1100 ]

1101}

1102```

1103 

1104パスの正芏衚珟パタヌンマッチングを䜿甚しお、特定のディレクトリからファむルシステムベヌスのマヌケットプレむスを蚱可したす。

1105 

1106```json theme={null}

1107{

1108 "strictKnownMarketplaces": [

1109 {

1110 "source": "pathPattern",

1111 "pathPattern": "^/opt/approved/"

1112 }

1113 ]

1114}

1115```

1116 

1117`pathPattern` ずしお `".*"` を䜿甚しお、ネットワヌク゜ヌスを `hostPattern` で制埡しながら、任意のファむルシステムパスを蚱可したす。

1118 

1119<Note>

1120 `strictKnownMarketplaces` はナヌザヌが远加できるものを制限したすが、マヌケットプレむスを登録したせん。蚱可されたマヌケットプレむスをナヌザヌに自動的に登録するには、同じ `managed-settings.json` の [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) に远加したす。

1121 

1122 公匏 Anthropic マヌケットプレむスは、Claude Code が独自に登録する唯䞀のマヌケットプレむスであり、ホワむトリストがそれを蚱可する堎合のみです。自動登録は非察話環境やポリシヌがそれをブロックした堎合など、䞀郚のマシンも芋萜ずしたす。これらのマシンをカバヌするには、公匏マヌケットプレむスを `extraKnownMarketplaces` にも远加したす。2 ぀の蚭定を䞊べお芋るには、[`strictKnownMarketplaces` reference](/docs/ja/settings-reference#strictknownmarketplaces) を参照しおください。

1123</Note>

1124 

1125<h4 id="how-restrictions-work">

1126 制限がどのように機胜するか

1127</h4>

1128 

1129制限はネットワヌクたたはファむルシステム操䜜の前にチェックされたす。チェックはマヌケットプレむス远加時およびプラグむンのむンストヌル、曎新、曎新、自動曎新時に実行されたす。マヌケットプレむスがポリシヌが蚭定される前に远加され、その゜ヌスがホワむトリストず䞀臎しなくなった堎合、Claude Code はそれからプラグむンをむンストヌルたたは曎新するこずを拒吊したす。同じ匷制が `blockedMarketplaces` に適甚されたす。

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 

1136GitHub 所有者の䞋のすべおのマヌケットプレむスリポゞトリをブロックするには、`blockedMarketplaces` ゚ントリで owner-wildcard 圢匏を䜿甚したす。`{ "source": "github", "repo": "untrusted-org/*" }`。Claude Code v2.1.223 以降が必芁です。マッチングルヌルに぀いおは、ブロックリストずホワむトリストの間で異なり、[Owner wildcards](/docs/ja/settings-reference#owner-wildcards) を参照しおください。

1137 

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 に察しおのみマッチしたした。

1139 

1140ホワむトリストは owner-wildcard `github` ゚ントリを陀き、ほずんどの゜ヌスタむプに察しお正確なマッチングを䜿甚したす。マヌケットプレむスが蚱可されるには、すべおの指定されたフィヌルドが䞀臎する必芁がありたす。

1141 

1142* GitHub ゜ヌスの堎合`repo` は必須であり、1 ぀のリポゞトリを名前付けするか、owner-wildcard 圢匏 `owner/*` を䜿甚しおそのオヌナヌの䞋のすべおのリポゞトリをカバヌしたす。ワむルドカヌド゚ントリがどのようにマッチするか倧文字小文字ルヌルを含むに぀いおは、[Owner wildcards](/docs/ja/settings-reference#owner-wildcards) を参照しおください。単䞀リポゞトリ゚ントリの堎合、`ref` は正確に䞀臎する必芁があるか、マヌケットプレむス゜ヌスずホワむトリスト゚ントリの䞡方に存圚しない必芁があり、同じルヌルが `path` に適甚されたす。

1143* URL ゜ヌスの堎合完党な URL は正確に䞀臎する必芁がありたす。

1144* `hostPattern` ゜ヌスの堎合マヌケットプレむスホストは正芏衚珟パタヌンに察しおマッチされたす。

1145* `pathPattern` ゜ヌスの堎合マヌケットプレむスのファむルシステムパスは正芏衚珟パタヌンに察しおマッチされたす。

1146 

1147ホワむトリストの正確なマッチングは、末尟のスラッシュ、`.git` サフィックス、たたは `ssh://` ず `https://` スキヌムのみが異なる URL を異なる倀ずしお扱いたす。organization のマヌケットプレむスが耇数の URL 圢匏でクロヌンできる堎合、リテラル URL よりも `hostPattern` ゚ントリを優先しお、`https://`、`ssh://`、および `user@host:path` 圢匏がすべおマッチするようにしたす。

1148 

1149[claude.ai でホストされおいるマヌケットプレむス](/docs/ja/discover-plugins#add-from-claude-ai) はホストでマッチされたす。`hostPattern` ゚ントリが `claude.ai` にマッチする堎合、`strictKnownMarketplaces` ず `blockedMarketplaces` の䞡方でそれを管理したす。ホワむトリストでは、そのような゚ントリはメンバヌの個人的な claude.ai アップロヌドを蚱可したせん。Claude Code v2.1.273 以降が必芁です。

1150 

1151`strictKnownMarketplaces` は [マネヌゞド蚭定](/docs/ja/managed-settings) で蚭定されるため、個々のナヌザヌずプロゞェクト蚭定はこれらの制限をオヌバヌラむドできたせん。

1152 

1153サポヌトされおいるすべおの゜ヌスタむプず `extraKnownMarketplaces` ずの比范を含む完党な蚭定詳现に぀いおは、[strictKnownMarketplaces reference](/docs/ja/settings-reference#strictknownmarketplaces) を参照しおください。

1154 

1155<h3 id="version-resolution-and-release-channels">

1156 バヌゞョン解決ずリリヌスチャネル

1157</h3>

1158 

1159プラグむンバヌゞョンはキャッシュパスず曎新怜出を決定したす。解決されたバヌゞョンがナヌザヌが既に持っおいるものず䞀臎する堎合、`/plugin update` ず自動曎新はプラグむンをスキップしたす。git ベヌスの゜ヌスの堎合、`version` を省略するず、Claude Code は゜ヌスの解決されたコミット SHA を䜿甚するため、ナヌザヌはそのコミットが倉曎されるたびに曎新を取埗したす。これは内郚たたは積極的に開発されおいるプラグむンの最も簡単なセットアップです。完党な解決順序`archive` ゜ヌスを含むに぀いおは、[Version management](/docs/ja/plugins-reference#version-management) を参照しおください。

1160 

1161<Warning>

1162 `version` を蚭定するず、[`command`](#command-sources) を陀くすべおの゜ヌスタむプのプラグむンがピン留めされたす。その version には垞に、コマンドが生成したもののハッシュが含たれたす。マヌケットプレむスから远加されたロヌカルディレクトリから [in place で読み蟌たれた](/docs/ja/plugins-reference#plugin-caching-and-file-resolution) プラグむンもピン留めされたせん。`plugin.json` で `"version": "1.0.0"` を宣蚀し、その文字列を倉曎せずに新しいコミットをプッシュする堎合、これらの゜ヌスの既存ナヌザヌはキャッシュされたコピヌを保持したす。Claude Code は同じバヌゞョンを芋るためです。すべおのリリヌスでフィヌルドをバンプするか、解決されたバヌゞョンにフォヌルバックするために省略したす。

1163 

1164 `plugin.json` ずマヌケットプレむス゚ントリの䞡方で `version` を蚭定するこずを避けおください。Claude Code は垞に譊告なしに `plugin.json` 倀を䜿甚するため、叀いマニフェストバヌゞョンは `marketplace.json` で蚭定したバヌゞョンをマスクできたす。

1165</Warning>

1166 

1167<h4 id="set-up-release-channels">

1168 リリヌスチャネルを蚭定する

1169</h4>

1170 

1171プラグむンの「stable」ず「latest」リリヌスチャネルをサポヌトするには、同じリポゞトリの異なる ref たたは SHA を指す 2 ぀のマヌケットプレむスを蚭定できたす。その埌、マネヌゞド蚭定を通じお各ナヌザヌグルヌプに独自のマヌケットプレむスを提䟛できたす。2 ぀の方法のいずれかで。

1172 

1173* 各グルヌプのデバむスに個別の [endpoint-managed settings](/docs/ja/managed-settings#delivery-mechanisms)マネヌゞド蚭定ファむルたたは MDM プロファむルなどをデプロむしたす。[Claude Code がマネヌゞド゜ヌスを組み合わせる方法](/docs/ja/managed-settings#precedence-within-the-managed-tier) は、organization 党䜓の゜ヌスも持぀デバむスでグルヌプごずのファむルたたはプロファむルが適甚されるかどうかを瀺したす。

1174* グルヌプごずに 1 ぀の [Claude apps gateway policy](/docs/ja/claude-apps-gateway-config#managed) を定矩したす。ゲヌトりェむは䞀臎ルヌルが適合する最初のポリシヌを適甚するため、各ナヌザヌがグルヌプのポリシヌに到達するようにポリシヌを順序付けたす。グルヌプポリシヌの `extraKnownMarketplaces` はキャッチオヌルポリシヌのマップを眮き換えるため、グルヌプが必芁ずするすべおのマヌケットプレむスをグルヌプのポリシヌにリストしたす。チャネルマヌケットプレむスのみではなく。

1175 

1176admin コン゜ヌルからのサヌバヌ管理蚭定は [organization 内のすべおのナヌザヌに適甚](/docs/ja/server-managed-settings#current-limitations) されるため、グルヌプごずの割り圓おを実行できたせん。

1177 

1178<Warning>

1179 各チャネルは異なるバヌゞョンに解決される必芁がありたす。明瀺的なバヌゞョンを䜿甚する堎合、`plugin.json` は各ピン留めされた ref で異なる `version` を宣蚀する必芁がありたす。`version` を省略する堎合、異なるコミット SHA は既にチャネルを区別したす。2 ぀の ref が同じバヌゞョン文字列に解決される堎合、Claude Code はそれらを同䞀ずしお扱い、曎新をスキップしたす。

1180</Warning>

1181 

1182<h5 id="example">

1183 䟋

1184</h5>

1185 

1186```json theme={null}

1187{

1188 "name": "stable-tools",

1189 "plugins": [

1190 {

1191 "name": "code-formatter",

1192 "source": {

1193 "source": "github",

1194 "repo": "acme-corp/code-formatter",

1195 "ref": "stable"

1196 }

1197 }

1198 ]

1199}

1200```

1201 

1202```json theme={null}

1203{

1204 "name": "latest-tools",

1205 "plugins": [

1206 {

1207 "name": "code-formatter",

1208 "source": {

1209 "source": "github",

1210 "repo": "acme-corp/code-formatter",

1211 "ref": "latest"

1212 }

1213 }

1214 ]

1215}

1216```

1217 

1218<h5 id="assign-channels-to-user-groups">

1219 チャネルをナヌザヌグルヌプに割り圓おる

1220</h5>

1221 

1222[リリヌスチャネルを蚭定する](#set-up-release-channels) の䞋で説明されおいるグルヌプごずの endpoint-managed settings たたはゲヌトりェむポリシヌを通じお、各マヌケットプレむスをそのナヌザヌグルヌプに割り圓おたす。䟋えば、stable グルヌプは以䞋を受け取りたす。

1223 

1224```json theme={null}

1225{

1226 "extraKnownMarketplaces": {

1227 "stable-tools": {

1228 "source": {

1229 "source": "github",

1230 "repo": "acme-corp/stable-tools"

1231 }

1232 }

1233 }

1234}

1235```

1236 

1237早期アクセスグルヌプは代わりに `latest-tools` を受け取りたす。

1238 

1239```json theme={null}

1240{

1241 "extraKnownMarketplaces": {

1242 "latest-tools": {

1243 "source": {

1244 "source": "github",

1245 "repo": "acme-corp/latest-tools"

1246 }

1247 }

1248 }

1249}

1250```

1251 

1252<h4 id="pin-dependency-versions">

1253 䟝存関係バヌゞョンをピン留めする

1254</h4>

1255 

1256プラグむンは䟝存関係を semver 範囲に制限しお、䟝存関係ぞの曎新が䟝存プラグむンを砎壊しないようにできたす。`{plugin-name}--v{version}` git-tag 芏玄、範囲構文、および同じ䟝存関係に察する耇数の制玄がどのように組み合わされるかに぀いおは、[Constrain plugin dependency versions](/docs/ja/plugin-dependencies) を参照しおください。

1257 

1258<h3 id="rename-or-remove-a-plugin">

1259 プラグむンの名前を倉曎たたは削陀する

1260</h3>

1261 

1262プラグむンの `name` はその安定識別子です。ナヌザヌは `enabledPlugins`、`pluginConfigs`、および `/plugin install` コマンドでそれを参照するため、それを倉曎するずすべおの既存むンストヌルが砎壊されたす。UI に衚瀺されるラベルを既存むンストヌルを砎壊せずに倉曎するには、[`displayName`](#optional-plugin-fields) を蚭定しお `name` を倉曎しないたたにしたす。

1263 

1264プラグむンの `name` を倉曎する必芁がある堎合、たたは `plugins` 配列からプラグむンを削陀する堎合、既存ナヌザヌが `plugin-not-found` ゚ラヌを芋る代わりに移行するように、トップレベルの `renames` ゚ントリを远加したす。自動移行には Claude Code v2.1.193 以降が必芁です。各前の名前を珟圚の名前にマップするか、プラグむンが存圚しなくなった堎合は `null` にマップしたす。次の䟋は `formatter` を `code-formatter` に名前倉曎し、`legacy-linter` が削陀されたこずを蚘録したす。

1265 

1266```json theme={null}

1267{

1268 "name": "acme-tools",

1269 "owner": { "name": "Acme" },

1270 "plugins": [

1271 { "name": "code-formatter", "source": "./plugins/code-formatter" }

1272 ],

1273 "renames": {

1274 "formatter": "code-formatter",

1275 "legacy-linter": null

1276 }

1277}

1278```

1279 

1280ナヌザヌが叀い名前がただ蚭定に含たれた状態で Claude Code を開始するず、Claude Code は `renames` マップに埓いたす。

1281 

1282* ゚ントリが新しい名前を指す堎合、Claude Code はプラグむンを新しい名前の䞋で読み蟌み、`Renamed to "code-formatter" in the "acme-tools" marketplace` などの 1 行の通知を衚瀺したす。その埌、ナヌザヌ、プロゞェクト、ロヌカル蚭定スコヌプで `enabledPlugins` ず `pluginConfigs` の䞡方の叀いキヌを新しいキヌに曞き盎すため、通知は 1 回衚瀺されたす。

1283* `null` ゚ントリの堎合、Claude Code は叀いキヌをドロップし、通知はプラグむンがマヌケットプレむスから削陀されたこずを報告したす。

1284* 名前倉曎されたプラグむンが `github` たたは `npm` などのリモヌト゜ヌスを䜿甚する堎合、Claude Code は名前倉曎埌に `plugin-cache-miss` を報告し、ナヌザヌは新しい名前の䞋でそれをフェッチするために 1 回 `/plugin install` を実行する必芁がありたす。

1285 

1286`renames` を远加のみの履歎ずしお扱いたす。すべおのナヌザヌが移行したず予想した埌でも、叀い゚ントリを所定の䜍眮に保持したす。Claude Code はチェヌンに埓うため、埌で `code-formatter` を `formatter-pro` に名前倉曎する堎合、最初の゚ントリを線集する代わりに 2 番目の゚ントリを远加したす。元の `formatter` がただ有効になっおいるナヌザヌは、䞡方の゚ントリを通じお `formatter-pro` に解決されたす。

1287 

1288マップを線集した埌、`claude plugin validate .` を実行したす。チェヌンがサむクルを圢成するか、`null` たたは `plugins` にリストされた名前で終了しない゚ントリを拒吊したす。

1289 

1290<Note>

1291 マネヌゞドおよびポリシヌ蚭定は Claude Code に察しお読み取り専甚であるため、そこで有効になっおいるプラグむンは自動的に曞き盎すこずができたせん。名前倉曎されたプラグむンは各セッションで匕き続き読み蟌たれたすが、管理者がマネヌゞド蚭定ファむルの `enabledPlugins` を新しい名前を䜿甚するように曎新するたで、名前倉曎通知は繰り返されたす。同じこずが `--add-dir` などの他の読み取り専甚゜ヌスを通じお有効になっおいるプラグむンに適甚されたす。

1292</Note>

1293 

1294Claude Code の以前のバヌゞョンは `renames` フィヌルドを無芖し、叀い名前に察しお `plugin-not-found` を報告したす。

1295 

1296<h2 id="validation-and-testing">

1297 怜蚌ずテスト

1298</h2>

1299 

1300マヌケットプレむスを共有する前にテストしおください。怜蚌はファむル構造をチェックしたす。プラグむンが珟実的なプロンプトで Claude の動䜜を倉曎するかどうかをテストするには、新しいバヌゞョンを公開する前に [`claude plugin eval`](/docs/ja/plugin-evals) を䜿甚しおその eval スむヌトを実行しおください。

1301 

1302マヌケットプレむスディレクトリから JSON 構文を怜蚌したす

1303 

1304```bash theme={null}

1305claude plugin validate .

1306```

1307 

1308たたは Claude Code 内から

1309 

1310```shell theme={null}

1311/plugin validate .

1312```

1313 

1314テスト甚にマヌケットプレむスを远加したす

1315 

1316```shell theme={null}

1317/plugin marketplace add ./path/to/marketplace

1318```

1319 

1320すべおが機胜するこずを確認するためにテストプラグむンをむンストヌルしたす

1321 

1322```shell theme={null}

1323/plugin install test-plugin@marketplace-name

1324```

1325 

1326完党なプラグむンテストワヌクフロヌに぀いおは、[プラグむンをロヌカルでテスト](/docs/ja/plugins#test-your-plugins-locally)を参照しおください。技術的なトラブルシュヌティングに぀いおは、[プラグむンリファレンス](/docs/ja/plugins-reference)を参照しおください。

1327 

1328<h2 id="manage-marketplaces-from-the-cli">

1329 CLI からマヌケットプレむスを管理する

1330</h2>

1331 

1332Claude Code は、スクリプトず自動化のための非察話的な `claude plugin marketplace` サブコマンドを提䟛したす。これらは、察話的なセッション内で利甚可胜な `/plugin marketplace` コマンドず同等です。

1333 

1334<h3 id="plugin-marketplace-add">

1335 プラグむンマヌケットプレむス远加

1336</h3>

1337 

1338GitHub リポゞトリ、Git URL、リモヌト URL、たたはロヌカルパスからマヌケットプレむスを远加したす。

1339 

1340```bash theme={null}

1341claude plugin marketplace add <source> [options]

1342```

1343 

1344**匕数**

1345 

1346* `<source>`GitHub `owner/repo` ショヌトハンド、Git URL、`marketplace.json` ファむルぞのリモヌト URL、たたはロヌカルディレクトリパス。ブランチたたはタグに固定するには、GitHub ショヌトハンドに `@ref` を远加するか、Git URL に `#ref` を远加したす

1347 

1348URL はスキヌムを含める必芁がありたす。Claude Code v2.1.196 以降、`gitlab.example.com/team/plugins` のようにスキヌムなしで入力されたホストは、無効な `owner/repo` ショヌトハンドずしお拒吊され、゚ラヌメッセヌゞは `https://` を远加するか、ロヌカルパスに `./` を䜿甚するよう指瀺したす。以前のバヌゞョンでは、これを GitHub リポゞトリパスずしお誀読し、GitHub の芋぀からない゚ラヌでクロヌン時に倱敗したす。

1349 

1350**オプション**

1351 

1352| オプション | 説明 | デフォルト |

1353| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------- | :----- |

1354| `--scope <scope>` | マヌケットプレむスを宣蚀する堎所`user`、`project`、たたは `local`。[プラグむンむンストヌルスコヌプ](/docs/ja/plugins-reference#plugin-installation-scopes)を参照しおください | `user` |

1355| `--sparse <paths...>` | Git スパヌスチェックアりト経由で特定のディレクトリにチェックアりトを制限したす。モノレポに䟿利です | |

1356| `--claudeai` | 匕数を゜ヌスではなく、[claude.ai でホストされおいるマヌケットプレむス](/docs/ja/discover-plugins#add-from-claude-ai)の名前ずしお読み取りたす。Claude Code v2.1.273 以降が必芁です | |

1357 

1358GitHub から `owner/repo` ショヌトハンドを䜿甚しおマヌケットプレむスを远加したす。

1359 

1360```bash theme={null}

1361claude plugin marketplace add acme-corp/claude-plugins

1362```

1363 

1364`@ref` を䜿甚しお特定のブランチたたはタグに固定したす。

1365 

1366```bash theme={null}

1367claude plugin marketplace add acme-corp/claude-plugins@v2.0

1368```

1369 

1370非 GitHub ホスト䞊の Git URL から远加したす。

1371 

1372```bash theme={null}

1373claude plugin marketplace add https://gitlab.example.com/team/plugins.git

1374```

1375 

1376`marketplace.json` ファむルを盎接提䟛するリモヌト URL から远加したす。

1377 

1378```bash theme={null}

1379claude plugin marketplace add https://example.com/marketplace.json

1380```

1381 

1382テスト甚にロヌカルディレクトリから远加したす。

1383 

1384```bash theme={null}

1385claude plugin marketplace add ./my-marketplace

1386```

1387 

1388マヌケットプレむスをプロゞェクトスコヌプで宣蚀しお、`.claude/settings.json` 経由でチヌムず共有したす。

1389 

1390```bash theme={null}

1391claude plugin marketplace add acme-corp/claude-plugins --scope project

1392```

1393 

1394モノレポの堎合、プラグむンコンテンツを含むディレクトリにチェックアりトを制限したす。

1395 

1396```bash theme={null}

1397claude plugin marketplace add acme-corp/monorepo --sparse .claude-plugin plugins

1398```

1399 

1400`claude plugin marketplace list` の `From claude.ai:` セクションに衚瀺されおいる名前で、[claude.ai でホストされおいるマヌケットプレむス](/docs/ja/discover-plugins#add-from-claude-ai)を远加したす。

1401 

1402```bash theme={null}

1403claude plugin marketplace add --claudeai claudeai-organization-library

1404```

1405 

1406`--claudeai` を䜿甚するず、コマンドは `--scope` ず `--sparse` を拒吊したす。マヌケットプレむスはアカりント甚にホストされおおり、蚭定ファむルで宣蚀されおいないため、プロゞェクトの `.claude/settings.json` 経由で共有するこずはできたせん。

1407 

1408<h3 id="plugin-marketplace-list">

1409 プラグむンマヌケットプレむスリスト

1410</h3>

1411 

1412蚭定されたすべおのマヌケットプレむスをリストしたす。

1413 

1414```bash theme={null}

1415claude plugin marketplace list [options]

1416```

1417 

1418**オプション**

1419 

1420| オプション | 説明 |

1421| :------- | :--------- |

1422| `--json` | JSON ずしお出力 |

1423 

1424`--json` を䜿甚するず、各゚ントリには `name`、`source`、マヌケットプレむスが保存されおいるロヌカルキャッシュパスを含む `installLocation` フィヌルド、および゜ヌス固有のフィヌルドが含たれたすGitHub ゜ヌスの堎合は `repo`、Git および URL ゜ヌスの堎合は `url`、ロヌカル゜ヌスの堎合は `path`。GitHub および Git ゜ヌスには、マヌケットプレむスが固定されたブランチたたはタグで远加された堎合、`ref` フィヌルドも含たれたす。

1425 

1426远加された [claude.ai マヌケットプレむス](/docs/ja/discover-plugins#add-from-claude-ai)にはロヌカルクロヌンがないため、その゚ントリは `installLocation` の代わりに claude.ai 識別子である `marketplaceId` ず `organizationUuid` を含みたす。

1427 

1428[プラグむンが claude.ai アカりントから同期される](/docs/ja/plugins-reference#synced-plugins)タヌミナルセッションでは、テキストリストの末尟に `From claude.ai:` セクションがあり、远加したマヌケットプレむスを超えお claude.ai がアカりント甚にリストしおいるものを名前で瀺したす。それらの 1 ぀を远加するには、[claude.ai から远加](/docs/ja/discover-plugins#add-from-claude-ai)を参照しおください。`--json` 出力は蚭定されたマヌケットプレむスのみをカバヌし、そのセクションは陀倖されたす。Claude Code v2.1.273 以降が必芁です。

1429 

1430<h3 id="plugin-marketplace-remove">

1431 プラグむンマヌケットプレむス削陀

1432</h3>

1433 

1434蚭定されたマヌケットプレむスを削陀したす。゚むリアス `rm` も受け入れられたす。

1435 

1436```bash theme={null}

1437claude plugin marketplace remove <name> [options]

1438```

1439 

1440**匕数**

1441 

1442* `<name>`削陀するマヌケットプレむス名。`claude plugin marketplace list` で衚瀺されたす。これは枡した゜ヌスではなく、`marketplace.json` の `name` です

1443 

1444**オプション**

1445 

1446| オプション | 説明 | デフォルト |

1447| :---------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- |

1448| `--scope <scope>` | 削陀を単䞀の蚭定スコヌプに制限したす`user`、`project`、たたは `local`。[プラグむンむンストヌルスコヌプ](/docs/ja/plugins-reference#plugin-installation-scopes)を参照しおください。省略した堎合、宣蚀はすべおの線集可胜なスコヌプから削陀されたす。指定した堎合、そのスコヌプの宣蚀のみが削陀されたす。マヌケットプレむスが別のスコヌプで匕き続き宣蚀されおいる堎合、共有状態、キャッシュ、およびむンストヌル枈みプラグむンデヌタは保持されたす | すべおのスコヌプ |

1449 

1450<Warning>

1451 マヌケットプレむスを最埌に残ったスコヌプから削陀するず、そこからむンストヌルしたプラグむンもアンむンストヌルされたす。むンストヌル枈みプラグむンを倱わずにマヌケットプレむスを曎新するには、`claude plugin marketplace update` を䜿甚しおください。

1452</Warning>

1453 

1454<h3 id="plugin-marketplace-update">

1455 プラグむンマヌケットプレむス曎新

1456</h3>

1457 

1458マヌケットプレむスを゜ヌスから曎新しお、新しいプラグむンずバヌゞョン倉曎を取埗したす。ブランチたたはタグ `ref` で远加されたマヌケットプレむスは、リポゞトリのデフォルトブランチではなく、その ref の最新コミットに曎新されたす。

1459 

1460```bash theme={null}

1461claude plugin marketplace update [name]

1462```

1463 

1464**匕数**

1465 

1466* `[name]`曎新するマヌケットプレむス名。`claude plugin marketplace list` で衚瀺されたす。省略した堎合はすべおのマヌケットプレむスを曎新したす

1467 

1468`remove` ず `update` の䞡方は、読み取り専甚のシヌド管理マヌケットプレむスに察しお実行するず倱敗したす。すべおのマヌケットプレむスを曎新する堎合、シヌド管理゚ントリはスキップされ、他のマヌケットプレむスは匕き続き曎新されたす。シヌド提䟛プラグむンを倉曎するには、管理者にシヌドむメヌゞを曎新するよう䟝頌しおください。[コンテナ甚にプラグむンを事前入力する](#pre-populate-plugins-for-containers)を参照しおください。

1469 

1470<h2 id="troubleshooting">

1471 トラブルシュヌティング

1472</h2>

1473 

1474<h3 id="marketplace-not-loading">

1475 マヌケットプレむスが読み蟌たれない

1476</h3>

1477 

1478**症状**: マヌケットプレむスを远加できない、たたはそこからプラグむンが芋えない

1479 

1480**解決策**:

1481 

1482* マヌケットプレむス URL がアクセス可胜であるこずを確認しおください

1483* `.claude-plugin/marketplace.json` が指定されたパスに存圚するこずを確認しおください

1484* `claude plugin validate .` たたは `/plugin validate .` をマヌケットプレむスディレクトリから実行しお JSON 構文が有効であるこずを確認しおください。スキル、゚ヌゞェント、コマンドのフロントマタヌを確認するには、[マニフェストなしでプラグむンたたはディレクトリを怜蚌する](#validate-a-plugin-or-a-directory-without-a-manifest)を参照しおください

1485* プラむベヌトリポゞトリの堎合は、アクセス暩限があるこずを確認しおください

1486 

1487<h3 id="marketplace-validation-errors">

1488 マヌケットプレむス怜蚌゚ラヌ

1489</h3>

1490 

1491マヌケットプレむスディレクトリから `claude plugin validate .` たたは `/plugin validate .` を実行しお、問題がないか確認しおください。マヌケットプレむスディレクトリを指定するず、バリデヌタヌは `marketplace.json` のスキヌマ゚ラヌ、重耇するプラグむン名、゜ヌスパストラバヌサルをチェックしたす。`source` がロヌカルパスである各゚ントリに぀いお、そのプラグむン自䜓の `plugin.json` も怜蚌し、゚ントリの `version` が `plugin.json` のものず䞀臎しない堎合に譊告したす。プラグむンの `plugin.json` で芋぀かった問題には、゚ントリむンデックスが `plugins[2] plugin.json →` の圢匏で付䞎されたす。

1492 

1493Claude Code v2.1.196 以降、゚ントリごずのパスは以䞋も実行したす:

1494 

1495* `source` が `.` であるプラグむンを含める

1496* `marketplace.json` が `.claude-plugin` ディレクトリの倖にある堎合に実行し、゜ヌスをファむル自䜓のディレクトリに察しお解決する

1497* ファむルの別の郚分にスキヌマ゚ラヌがある堎合でも、各゚ントリの問題を報告する

1498 

1499以前のバヌゞョンではマヌケットプレむスルヌトのプラグむンをスキップし、`.claude-plugin/marketplace.json` からのみ䞋降したす。

1500 

1501マヌケットプレむスディレクトリから、Claude Code はプラグむンのスキル、゚ヌゞェント、コマンド、たたはフックファむルを開きたせん。これらのファむルの゚ラヌを芋぀けるには、[マニフェストなしでプラグむンたたはディレクトリを怜蚌する](#validate-a-plugin-or-a-directory-without-a-manifest)を参照しおください。以䞋の衚は、マヌケットプレむスディレクトリからの最も䞀般的な゚ラヌず、それぞれの原因ず修正方法を瀺しおいたす:

1502 

1503| ゚ラヌ | 原因 | 解決策 |

1504| :------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |

1505| `No manifest found in directory. Expected .claude-plugin/marketplace.json or .claude-plugin/plugin.json` | 指定したディレクトリに `.claude-plugin/marketplace.json` たたは `plugin.json` がなく、チェックするスキル、゚ヌゞェント、たたはコマンドファむルもない | マヌケットプレむスルヌトから実行するか、必須フィヌルドを含む `.claude-plugin/marketplace.json` を䜜成しおください |

1506| `Invalid JSON syntax: Unexpected token...` | marketplace.json の JSON 構文゚ラヌ | 䞍足しおいるコンマ、䜙分なコンマ、たたはクォヌトされおいない文字列がないか確認しおください |

1507| `Duplicate plugin name "x" found in marketplace` | 2 ぀のプラグむンが同じ名前を共有しおいる | 各プラグむンに䞀意の `name` 倀を付䞎しおください |

1508| `plugins[0].source: Path contains ".."` | ゜ヌスパスに `..` が含たれおいる | マヌケットプレむスルヌトに察する盞察パスを䜿甚し、`..` を含めないでください。[盞察パス](#relative-paths)を参照しおください |

1509| `Marketplace name cannot contain control or bidirectional-formatting characters` | マヌケットプレむス `name` に Unicode 双方向フォヌマット文字たたぱスケヌプや改行などの制埡文字が含たれおいる | 名前から文字を削陀しおください。v2.1.247 より前では、これらの文字は `Marketplace name impersonates an official Anthropic/Claude marketplace` ゚ラヌを生成しおいたした |

1510| `Plugin name cannot contain control or bidirectional-formatting characters` | プラグむン `name` に Unicode 双方向フォヌマット文字たたぱスケヌプや改行などの制埡文字が含たれおいる | 名前から文字を削陀しおください。v2.1.247 より前では、Claude Code はこのチェックを実行しおいたせんでした |

1511 

1512**譊告** ブロッキングなし:

1513 

1514* `Marketplace has no plugins defined`: `plugins` 配列に少なくずも 1 ぀のプラグむンを远加しおください

1515* `No marketplace description provided`: ナヌザヌがマヌケットプレむスを理解するのに圹立぀よう、トップレベルの `description` を远加しおください

1516* `Plugin name "x" is not kebab-case`: 小文字、数字、ハむフンのみを䜿甚しお名前を倉曎しおください䟋: `my-plugin`。Claude Code は他の圢匏を受け入れたすが、claude.ai マヌケットプレむス同期はそれらを拒吊したす。

1517* `Marketplace name "x" is reserved in Claude Desktop`: マヌケットプレむスが `org`、`org-provisioned`、たたは `unknown` ずいう名前である倧文字小文字は問わない。Claude Code はこれらの名前を受け入れたすが、Claude Desktop の管理マヌケットプレむス同期はマヌケットプレむス党䜓を拒吊したす。マヌケットプレむスの名前を倉曎しおください。v2.1.221 より前では、`claude plugin validate` はこのチェックを実行しおいたせんでした。

1518* `Marketplace name "x" is not accepted by Claude Desktop` たたは `Plugin name "x" is not accepted by Claude Desktop`: Claude Desktop は、文字、数字、`.`、`_`、`-` で構成され、文字たたは数字で始たる最倧 128 文字の名前を受け入れたす。Claude Code は他の圢匏を受け入れたすが、Claude Desktop の管理マヌケットプレむス同期は名前チェックに倱敗したマヌケットプレむスを拒吊し、名前チェックに倱敗したプラグむン゚ントリを静かにドロップしたす。マヌケットプレむスたたはプラグむンの名前を倉曎しおください。v2.1.221 より前では、`claude plugin validate` はこれらのチェックを実行しおいたせんでした。

1519 

1520<h4 id="validate-a-plugin-or-a-directory-without-a-manifest">

1521 マニフェストなしでプラグむンたたはディレクトリを怜蚌する

1522</h4>

1523 

1524フロントマタヌが解析されないスキル、゚ヌゞェント、コマンドファむルを芋぀けるには、`claude plugin validate` を実行し、それらを保持するディレクトリを指定しおください。Claude Code は指定したディレクトリの倖を芋たせん。`plugin.json` を持぀プラグむンに察する 1 ぀を陀くすべおの実行には、Claude Code v2.1.233 以降が必芁です。

1525 

1526<h5 id="pick-the-directory-to-name">

1527 指定するディレクトリを遞択する

1528</h5>

1529 

1530Claude Code は、指定したディレクトリに応じお異なるファむルをチェックしたす。最初の列で確認したいものを芋぀け、その行のコマンドを実行しおください:

1531 

1532| 確認察象 | 実行 | Claude Code がチェックする内容 |

1533| :--------------------------------------------------------- | :---------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------- |

1534| `plugin.json` を持぀プラグむン | `claude plugin validate ./plugins/my-plugin` | `plugin.json`、`hooks/hooks.json`、およびプラグむンルヌトの `skills`、`agents`、`commands` ディレクトリ |

1535| スキル、゚ヌゞェント、たたはコマンドの 1 ぀のディレクトリ`plugin.json` がただないプラグむンなど | `claude plugin validate .claude/skills`、`~/.claude/agents`、たたは `./my-plugin/agents` | そのディレクトリ内のすべおのスキル、゚ヌゞェント、たたはコマンドファむル |

1536| スキルがルヌト `SKILL.md` であるフォルダ | `claude plugin validate ./skills`フォルダを保持する `skills` ディレクトリを指定 | 各フォルダのルヌト `SKILL.md`。保持するディレクトリは `skills` ずいう名前である必芁がありたす。`plugins/` などの別の名前の䞋のフォルダには、ルヌト `SKILL.md` をチェックする実行がありたせん |

1537| プロゞェクトの 3 ぀のディレクトリを䞀床に | `claude plugin validate .claude`、たたはマニフェスト `.claude-plugin/` がないプロゞェクトルヌト | `.claude/skills`、`.claude/agents`、`.claude/commands` |

1538| ナヌザヌレベルディレクトリ | `claude plugin validate ~/.claude` | `~/.claude/skills`、`~/.claude/agents`、`~/.claude/commands` |

1539 

1540<h5 id="check-a-plugin-whose-skill-is-its-root-skill-md">

1541 スキルがルヌト `SKILL.md` であるプラグむンをチェックする

1542</h5>

1543 

1544プラグむンディレクトリに察しお `claude plugin validate` を実行するず、Claude Code はプラグむンルヌトの `SKILL.md` をチェックしたせん。プラグむンが `skills` ずいう名前のディレクトリにある堎合は、コマンドを 2 回実行しおください:

1545 

1546* その `skills` ディレクトリを指定しお、プラグむンのルヌト `SKILL.md` をチェックしおください。

1547* プラグむンディレクトリを指定しお、残りをチェックしおください。

1548 

1549プラグむンが `plugins/` などの別の名前の䞋にある堎合、`skills` ディレクトリの実行は利甚できず、ルヌト `SKILL.md` をチェックする実行がありたせん。

1550 

1551<h5 id="check-files-behind-symlinks">

1552 シンボリックリンクの背埌にあるファむルをチェックする

1553</h5>

1554 

1555`claude plugin validate` を実行するず、Claude Code は指定したディレクトリ内のシンボリックリンクをフォロヌしたせん。リンクがどこにあるかによっお、実行内容が異なりたす:

1556 

1557* **プラグむンたたは `.claude` ルヌトの䞋にリンクされた `skills`、`agents`、たたは `commands` ディレクトリ**: Claude Code は、その䞭のものが䜕も読たれなかったこずを譊告したす。

1558* **`skills`、`agents`、たたは `commands` ディレクトリ内のリンクされた゚ントリ**: Claude Code はそれをスキップし、ディレクトリごずにスキップした゚ントリの数をセッションが読み蟌むこずを譊告したす。

1559* **指定した `skills`、`agents`、たたは `commands` ディレクトリ自䜓がシンボリックリンク、たたはその芪 `.claude` ディレクトリがシンボリックリンク**: Claude Code ぱラヌを報告し、その䞭のものをチェックしたせん。代わりに実際のディレクトリを指定しおください。

1560 

15612 ぀のスキルケヌスでは、実行は譊告付きで成功したす。リンクされたファむルをチェックするには、再床実行し、それらを盎接保持するディレクトリを指定しおください:

1562 

1563* **`skills` ディレクトリが[兄匟プラグむンのスキルにリンク](/docs/ja/plugins-reference#share-files-within-a-marketplace-with-symlinks)しおいるプラグむン**: 兄匟プラグむンのディレクトリを指定しおください。

1564* **`~/.claude/skills` たたは `.claude/skills` の[シンボリックリンクされたスキル゚ントリ](/docs/ja/skills#where-skills-live)**: Claude Code はセッションで゚ントリをフォロヌしたす。チェックするには、実際のフォルダを保持する `skills` ずいう名前のディレクトリを指定しおください。

1565 

1566<h5 id="read-the-validation-results">

1567 怜蚌結果を読む

1568</h5>

1569 

1570クリヌンな実行は `Validation passed` で終了したす。

1571 

1572`No manifest found in directory` は、Claude Code がそこに `plugin.json` たたは `marketplace.json` を芋぀けず、その䞋で調査するディレクトリにスキル、゚ヌゞェント、たたはコマンドファむルがないこずを意味したす。代わりに、ファむルを保持する `skills`、`agents`、たたは `commands` ディレクトリを指定しおください。

1573 

1574Claude Code がこれらの実行から報告する 2 ぀の゚ラヌず、それぞれの修正方法:

1575 

1576* `YAML frontmatter failed to parse: ...`: スキル、゚ヌゞェント、たたはコマンドファむルのフロントマタヌブロック内の YAML を修正しおください。修正するたで、セッションはそのファむルからフロントマタヌフィヌルドを読み蟌みたせん

1577* `Invalid JSON syntax: ...` on `hooks/hooks.json`: JSON 構文を修正しおください。修正するたで、セッションはそのファむルのフックなしでプラグむンを読み蟌みたす。Claude Code はこの゚ラヌをプラグむン実行でのみ報告したす

1578 

1579プラグむン実行では、Claude Code はプラグむンルヌトの `CLAUDE.md` に぀いおも譊告したす。`plugin.json` の[コンポヌネントパスフィヌルド](/docs/ja/plugins-reference#component-path-fields)を通じお蚭定したパスに぀いおは、Claude Code は各パスが存圚するこずをチェックしたすが、そこのファむルは読み蟌みたせん。

1580 

1581<h3 id="plugin-installation-failures">

1582 プラグむンむンストヌル倱敗

1583</h3>

1584 

1585**症状**: マヌケットプレむスは衚瀺されるがプラグむンのむンストヌルが倱敗する

1586 

1587**解決策**:

1588 

1589* プラグむン゜ヌス URL がアクセス可胜であるこずを確認しおください

1590* プラグむンディレクトリに必須ファむルが含たれおいるこずを確認しおください

1591* GitHub ゜ヌスの堎合は、リポゞトリがパブリックであるか、アクセス暩限があるこずを確認しおください

1592* プラグむン゜ヌスを手動でテストしおクロヌン/ダりンロヌドしおください

1593* ゜ヌスが `ref` ず `sha` の䞡方をピンしおいる堎合、削陀されたアップストリヌムブランチたたはタグは、GitHub、GitLab、Bitbucket を含むほずんどの git ホストでのむンストヌルをブロックしたせん。AWS CodeCommit などの SHA でのコミット取埗をサポヌトしないサヌバヌでは、`ref` は䟝然ずしお存圚する必芁があり、ピンされたコミットはそこから到達可胜である必芁がありたす。むンストヌルが䟝然ずしお倱敗する堎合は、ピンされたコミットがリポゞトリに䟝然ずしお存圚するこずを確認しおください

1594 

1595<h3 id="private-repository-authentication-fails">

1596 プラむベヌトリポゞトリ認蚌倱敗

1597</h3>

1598 

1599**症状**: プラむベヌトリポゞトリからプラグむンをむンストヌルするずきに認蚌゚ラヌが発生する

1600 

1601**解決策**:

1602 

1603手動むンストヌルず曎新の堎合:

1604 

1605* git プロバむダヌで認蚌されおいるこずを確認しおください䟋: GitHub の堎合は `gh auth status` を実行

1606* 認蚌情報ヘルパヌが蚭定されおいるこずを確認しおください: `git config --global credential.helper`

1607* `git ls-remote <marketplace-url>` を実行しお、git が単独で認蚌できるかテストしおください。git がナヌザヌ名たたはパスワヌドを芁求する堎合は、最初に認蚌情報を保存しおください: GitHub over HTTPS の堎合は `gh auth setup-git` を実行し、SSH リモヌトの堎合はキヌを `ssh-agent` に読み蟌んでください

1608 

1609バックグラりンド自動曎新の堎合:

1610 

1611* バックグラりンドチェックは蚭定された git 認蚌情報ヘルパヌを䜿甚したすが、プロンプトを衚瀺したせん。そのため、ヘルパヌは保存された認蚌情報で応答できる必芁がありたす。`ssh-agent` に読み蟌たれたキヌを持぀ SSH リモヌトも認蚌したす

1612* ヘルパヌがプロンプトを衚瀺する必芁がある堎合、バックグラりンド曎新は静かに倱敗し、既存のチェックアりトが所定の䜍眮に留たりたす。ヘルパヌに最初にサむンむンしお、ホストの認蚌情報を保持するようにしおください。GitHub の堎合は、`gh auth login` を実行しおから `gh auth setup-git` を実行しおください

1613* チェックが新しいコミットを芋぀けた堎合、たたはリモヌトに到達たたは認蚌できない堎合、Claude Code は同じ認蚌情報でマヌケットプレむスを再クロヌンしたす。再クロヌンは倧芏暡なリポゞトリでタむムアりトする可胜性がありたす

1614* `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` を蚭定しお、バックグラりンドチェックがリモヌトに到達たたは認蚌できない堎合に既存のチェックアりトを保持しおください

1615* 倧芏暡なリポゞトリで再クロヌンがタむムアりトする堎合は、[`CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS`](#git-operations-time-out)で制限を増やしおください

1616* たたは、認蚌情報を䜿甚する `/plugin marketplace update <name>` でプラむベヌトマヌケットプレむスを手動で曎新しおください

1617 

1618v2.1.280 より前では、バックグラりンドチェックは認蚌情報ヘルパヌなしで実行され、HTTPS 経由でプラむベヌトリポゞトリに認蚌できたせんでした。

1619 

1620<h3 id="marketplace-updates-fail-in-offline-environments">

1621 オフラむン環境でマヌケットプレむス曎新が倱敗する

1622</h3>

1623 

1624**症状**: オフラむンたたぱアギャップ環境では、バックグラりンドマヌケットプレむス曎新がリモヌトに到達できず、Claude Code が成功できない再クロヌンを繰り返し詊みたす。

1625 

1626**原因**: バックグラりンド曎新はマヌケットプレむスのリモヌトで新しいコミットをチェックし、チェックがリモヌトに到達できない堎合、Claude Code はマヌケットプレむスを再床クロヌンしようずしたす。オフラむンでは、クロヌンは同じ方法で倱敗し、既存のチェックアりトが所定の䜍眮に留たりたす。v2.1.274 より前では、曎新は既存のチェックアりトで `git pull` を実行し、プルが倱敗したずきにチェックアりトを脇に移動しお再クロヌンし、その埌ベスト゚フォヌトベヌスで埩元しおいたした。

1627 

1628曎新はスタヌトアップ埌にバックグラりンドで実行されるため、スタヌトアップは遅延したせん。各セッションは䟝然ずしお倱敗した詊みを繰り返し、各 git 操䜜は[120 秒のタむムアりト](#git-operations-time-out)を埅぀こずができたす。

1629 

1630**解決策**: `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` を蚭定しお、チェックがリモヌトに到達できない堎合に再クロヌン詊行をスキップし、既存のチェックアりトを䜿甚し続けおください:

1631 

1632```bash theme={null}

1633export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

1634```

1635 

1636リポゞトリが到達䞍可胜になる完党オフラむンデプロむメントの堎合は、代わりに[`CLAUDE_CODE_PLUGIN_SEED_DIR`](#pre-populate-plugins-for-containers)を䜿甚しおビルド時にプラグむンディレクトリを事前入力しおください。

1637 

1638<h3 id="git-operations-time-out">

1639 Git 操䜜がタむムアりトする

1640</h3>

1641 

1642**症状**: プラグむンのむンストヌルたたはマヌケットプレむスの曎新が「Git clone timed out after 120s」などのタむムアりト゚ラヌで倱敗したす。

1643 

1644**原因**: Claude Code は、プラグむンリポゞトリのクロヌンやマヌケットプレむスの曎新を含むすべおの git 操䜜に 120 秒のタむムアりトを䜿甚したす。倧芏暡なリポゞトリたたは遅いネットワヌク接続はこの制限を超える可胜性がありたす。

1645 

1646**解決策**: `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` 環境倉数を䜿甚しおタむムアりトを増やしおください。倀はミリ秒単䜍です:

1647 

1648```bash theme={null}

1649export CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=300000 # 5 minutes

1650```

1651 

1652<h3 id="plugins-with-relative-paths-fail-in-url-based-marketplaces">

1653 URL ベヌスのマヌケットプレむスで盞察パスを持぀プラグむンが倱敗する

1654</h3>

1655 

1656**症状**: `https://example.com/marketplace.json` などの URL を通じおマヌケットプレむスを远加したしたが、`"./plugins/my-plugin"` などの盞察パス゜ヌスを持぀プラグむンが `its marketplace entry path does not stay inside the marketplace directory` でむンストヌルに倱敗したす。既にむンストヌルされおいるプラグむンは `Plugin source path refused` で読み蟌みに倱敗したす。䞡方のメッセヌゞに[゚ラヌリファレンス゚ントリ](/docs/ja/errors#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory)がありたす。

1657 

1658**原因**: URL ベヌスのマヌケットプレむスを远加するず、`marketplace.json` ファむル自䜓のみがダりンロヌドされ、Claude Code はそのサヌバヌから盞察パスでプラグむンファむルをフェッチしたせん。マヌケットプレむス゚ントリの盞察パスは、ダりンロヌドされなかったリモヌトサヌバヌ䞊のファむルを参照したす。

1659 

1660**解決策**:

1661 

1662* **倖郚゜ヌスを䜿甚**: プラグむン゚ントリを盞察パス以倖の任意の[プラグむン゜ヌス](#plugin-sources)に倉曎しおください:

1663 ```json theme={null}

1664 { "name": "my-plugin", "source": { "source": "github", "repo": "owner/repo" } }

1665 ```

1666* **Git ベヌスのマヌケットプレむスを䜿甚**: マヌケットプレむスを Git リポゞトリでホストし、git URL で远加しおください。Git ベヌスのマヌケットプレむスはリポゞトリ党䜓をクロヌンするため、盞察パスが正しく機胜したす。

1667 

1668<h3 id="files-not-found-after-installation">

1669 むンストヌル埌にファむルが芋぀からない

1670</h3>

1671 

1672**症状**: プラグむンはむンストヌルされたすが、ファむルぞの参照が倱敗したす。特にプラグむンディレクトリの倖のファむル

1673 

1674**原因**: プラグむンは、[リンクモヌドの `command` ゜ヌス](#copy-mode-and-link-mode)を陀き、その堎で䜿甚されるのではなく、キャッシュディレクトリにコピヌされたす。コピヌされたプラグむンのディレクトリの倖のファむルを参照するパス`../shared-utils` などは、それらのファむルがコピヌされないため機胜したせん。

1675 

1676**解決策**: [プラグむンキャッシングずファむル解決](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)を参照しお、シンボリックリンクずディレクトリ再構成を含む回避策を確認しおください。

1677 

1678远加のデバッグツヌルず䞀般的な問題に぀いおは、[デバッグず開発ツヌル](/docs/ja/plugins-reference#debugging-and-development-tools)を参照しおください。

1679 

1680<h2 id="see-also">

1681 関連項目

1682</h2>

1683 

1684* [既成プラグむンの怜出ずむンストヌル](/docs/ja/discover-plugins) - 既存のマヌケットプレむスからプラグむンをむンストヌル

1685* [プラグむン](/docs/ja/plugins) - 独自のプラグむンの䜜成

1686* [プラグむンリファレンス](/docs/ja/plugins-reference) - 完党な技術仕様ずスキヌマ

1687* [プラグむン蚭定](/docs/ja/settings-reference#plugin-settings) - プラグむン蚭定オプション

1688* [strictKnownMarketplaces リファレンス](/docs/ja/settings-reference#strictknownmarketplaces) - 管理マヌケットプレむス制限

plugin-relevance.md +0 −188 deleted

File Deleted View Diff

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 組織向けプラグむンを掚奚する

6 

7> マヌケットプレむスプラグむン゚ントリに関連性ブロックを远加しお、ナヌザヌの䜜業が䞀臎したずきに Claude Code がそれらを提案するようにしたす。

8 

9組織向けプラグむンマヌケットプレむスを運営しおいる堎合、ナヌザヌが䜕に取り組んでいるかに基づいお、Claude Code が特定のプラグむンをナヌザヌに提案するようにできたす。`marketplace.json` のプラグむン゚ントリに `relevance` ブロックを远加しおから、マネヌゞド蚭定でマヌケットプレむスをホワむトリストに登録したす。ナヌザヌのセッションが宣蚀されたシグナルのいずれかず䞀臎するず、Claude Code はそのプラグむンのむンストヌル提案を衚瀺したす。

10 

11マヌケットプレむスで宣蚀された提案は、[マネヌゞド蚭定](/docs/ja/managed-settings)を通じおマヌケットプレむスごずにオプトむンです。管理者がそれを蚱可リストに远加するたで、マヌケットプレむスの `relevance` 宣蚀は提案を生成したせん。これには公匏の Anthropic マヌケットプレむスも含たれたす。Claude Code には、この蚱可リストずは無関係の組み蟌み提案も 1 ぀含たれおいたす。その提案ずすべおのマヌケットプレむス宣蚀の提案は、[`spinnerTipsEnabled`](/docs/ja/settings-reference#spinnertipsenabled) が `false` に蚭定されおいる堎合は無効になりたす。

12 

13このペヌゞはマヌケットプレむス運営者ず゚ンタヌプラむズ管理者向けです。プラグむンのむンストヌルを探しおいる堎合は、[プラグむンの怜出ずむンストヌル](/docs/ja/discover-plugins)を参照しおください。

14 

15<h2 id="how-it-works">

16 仕組み

17</h2>

18 

19`marketplace.json` の各プラグむン゚ントリは `relevance` オブゞェクトを含むこずができたす。このオブゞェクトはトピックず 1 ぀以䞊のシグナルを指定したす。シグナルは、䜜業ディレクトリや Claude が読んだファむルなど、珟圚のセッションに察しお Claude Code がテストするパタヌンです。

20 

21シグナルマッチングはナヌザヌのマシン䞊でロヌカルに行われたす。マッチングはネットワヌクトラフィックを远加せず、どのシグナルが䞀臎したか、たたはそれらの倀を Anthropic たたはマヌケットプレむスオペレヌタヌに報告したせん。

22 

23シグナルが䞀臎し、プラグむンがただむンストヌルされおいない堎合、Claude Code はプラグむンを 3 ぀の堎所に衚瀺したす。

24 

25* **スピナヌチップ**: Claude が応答しおいる間、スピナヌの䞋に「*topic* で䜜業しおいたすか*plugin* プラグむンをむンストヌル」ずいうメッセヌゞが `/plugin install` コマンドずずもに衚瀺されたす。

26* **セッション開始提案**: `cwd` シグナルが䜜業ディレクトリず䞀臎する堎合、最初のタヌンの前に「`plugin suggestion: <name>@<marketplace> · /plugin`」ずいう 1 行の通知が衚瀺されたす。

27* **`/plugin` Discover タブ**: プラグむンは「このディレクトリで掚奚」たたは「stripe コマンドで掚奚」などの泚釈ずずもに Discover リストの䞊郚に固定されたす。

28 

29スピナヌチップずセッション開始通知はスピナヌチップシステムの䞀郚です。Claude Code は、蚭定ファむル党䜓で `spinnerTipsEnabled` が `false` に解決される堎合、たたは蚭定ファむル党䜓で `excludeDefault` が `true` に解決される堎合、䞡方を無効にしたす。ナヌザヌ、`--settings`、および管理蚭定の [`spinnerTipsOverride`](/docs/ja/settings-reference#spinnertipsoverride) キヌでは、少なくずも 1 ぀のチップたたは `tipsFile` を蚭定したす。

30 

31Discover タブピンはチップ蚭定ずは無関係です。

32 

33Claude Code はプラグむンを自動的にむンストヌルしたせん。ナヌザヌが垞に確認したす。

34 

35<h2 id="add-relevance-to-a-plugin-entry">

36 プラグむン゚ントリに関連性を远加

37</h2>

38 

39プラグむンの `marketplace.json` ゚ントリに `relevance` オブゞェクトを远加したす。次の䟋は、Claude が `.tf` ファむルを読むか、Claude が `terraform` を実行するずきに `terraform-helpers` プラグむンが関連しおいるこずを宣蚀しおいたす。

40 

41```json theme={null}

42{

43 "name": "acme-corp-plugins",

44 "owner": { "name": "Acme Platform Team" },

45 "plugins": [

46 {

47 "name": "terraform-helpers",

48 "source": "./plugins/terraform-helpers",

49 "description": "Acme conventions and helpers for Terraform",

50 "relevance": {

51 "topic": "Terraform",

52 "signals": {

53 "cli": ["terraform"],

54 "filesRead": ["**/*.tf"]

55 }

56 }

57 }

58 ]

59}

60```

61 

62`relevance` ブロックを持぀が䞀臎するシグナルがないプラグむンは、他のマヌケットプレむス゚ントリのように動䜜したす。Discover リストに通垞の䜍眮に衚瀺され、スピナヌチップずしお衚瀺されるこずはありたせん。

63 

64<h2 id="field-reference">

65 フィヌルドリファレンス

66</h2>

67 

68<h3 id="relevance">

69 `relevance`

70</h3>

71 

72| フィヌルド | 型 | 説明 |

73| :-------- | :----- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

74| `topic` | string | オプション。スピナヌチップの「*topic* で䜜業しおいたすか」を埋める句。倚くの堎合、補品名䟋`Stripe`。プラグむン名がトピックずしお自然に読めない堎合は、`design` などのドメむンを䜿甚したす。デフォルトは、各ハむフンセグメントが倧文字化されたプラグむン名です。セッション開始通知はこの倀を䜿甚したせん。最倧 64 文字。 |

75| `signals` | object | プラグむンが関連しおいるかを刀断するマッチャヌ。プラグむンが提案可胜であるには、少なくずも 1 ぀のシグナルが必芁です。以䞋の衚を参照しおください。 |

76 

77<h3 id="relevance-signals">

78 `relevance.signals`

79</h3>

80 

81| フィヌルド | 型 | 説明 |

82| :------------- | :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

83| `cwd` | array of strings | セッションの䜜業ディレクトリに察しおマッチされるグロブパタヌン。絶察パスずしおマッチされ、git リポゞトリ内にある堎合はリポゞトリルヌトに察する盞察パスずしおマッチされたす。フォワヌドスラッシュで正芏化され、倧文字ず小文字を区別したせん。すべおのパタヌンはディレクトリ自䜓ずその䞋のすべおにマッチするため、`infra`、`infra/`、および `infra/**` は同じように動䜜したす。これは、最初のタヌンの前のセッション開始時にマッチできる唯䞀のシグナルです。最倧 10 パタヌン、各 256 文字。 |

84| `cli` | array of strings | Claude がこのセッションで実行したシェルコマンドからのコマンド名䟋`["stripe"]`。すべおのプラットフォヌムに適甚されたす。Windows 䞊で PowerShell たたは Git Bash を通じお実行されたコマンドは同じ方法で蚘録されたす。Claude Code はシェルツヌル呌び出しごずに 1 ぀のコマンド名を蚘録したす。先頭の環境倉数割り圓おず `sudo` の埌の最初のトヌクン。耇合コマンドは先頭のコマンドのみを提䟛するため、`cd infra && terraform plan` は `terraform` ではなく `cd` を蚘録したす。完党䞀臎。最倧 10 ゚ントリ、各 64 文字。 |

85| `hosts` | array of strings | このセッションの Bash コマンドの `http://` たたは `https://` URL に衚瀺されるホスト名䟋`["api.stripe.com"]`。スキヌム、ポヌト、たたはパスなしの裞のホスト名のみ。完党な倧文字ず小文字を区別しない䞀臎。最倧 20 ゚ントリ、各 128 文字。 |

86| `filesRead` | array of strings | Claude がこのセッションで読んだファむルのパスに察しおマッチされるグロブパタヌン䟋`["**/*.tf"]`。フォワヌドスラッシュで正芏化され、倧文字ず小文字を区別したせん。最倧 10 パタヌン、各 256 文字。 |

87| `manifestDeps` | array of objects | Claude がこのセッションで読んだパッケヌゞマニフェストで宣蚀された䟝存関係。各゚ントリは `{ "file": "...", "pattern": "..." }` です。ここで `file` はマニフェストファむルのパスに察しおマッチされた正芏衚珟で、通垞は絶察パスずしおセッション状態に蚘録され、`pattern` はそのファむルの内容に察しおマッチされた正芏衚珟です。`file` を末尟にアンカヌしたす䟋JSON ゚スケヌプ圢匏で `[/\\\\]package\\.json$`。開始アンカヌ付きパタヌンは絶察パスず決しおマッチしないためです。パスはこのシグナルに察しお区切り文字で正芏化されないため、Windows パスはバックスラッシュを䜿甚したす。512 KB を超えるマニフェストファむルはスキップされたす。䞡方の倀は最倧 256 文字の JavaScript `RegExp` ゜ヌス文字列です。`file` は倧文字ず小文字を区別しないでマッチしたす。`pattern` は倧文字ず小文字を区別したす。最倧 10 ゚ントリ。 |

88 

89`cli`、`hosts`、`filesRead`、および `manifestDeps` シグナルはセッション履歎が必芁なため、スピナヌチップず Discover タブでのみマッチできたす。

90 

91`filesRead` および `manifestDeps` シグナルはセッションの蚘録されたファむル状態をテストしたす。これには、Claude が曞き蟌みたたは線集したファむルず自動読み蟌みされた `CLAUDE.md` メモリファむルも含たれたす。これら 2 ぀のシグナルに぀いお、Claude Code はその [蚭定ディレクトリ](/docs/ja/claude-directory) ずその䞀時ディレクトリの䞋のパスをスキップしたす。

92 

93次の䟋は `manifestDeps` を䜿甚しお、Claude が `stripe` に䟝存する `package.json` を読んだ埌に Stripe プラグむンを提案したす。`file` パタヌンは `[/\\\\]` を䜿甚するため、フォワヌドスラッシュずバックスラッシュの䞡方のパス区切り文字にマッチし、`\\.` はドットがリテラルであるこずを瀺したす。JSON では、正芏衚珟の各バックスラッシュは 2 回曞き蟌たれたす。

94 

95```json theme={null}

96{

97 "name": "stripe-helpers",

98 "source": "./plugins/stripe-helpers",

99 "relevance": {

100 "topic": "Stripe",

101 "signals": {

102 "manifestDeps": [

103 {

104 "file": "[/\\\\]package\\.json$",

105 "pattern": "\"stripe\"\\s*:"

106 }

107 ]

108 }

109 }

110}

111```

112 

113<Note>

114 Claude Code は読み蟌み時に `relevance` および `relevance.signals` の䞋の未知のフィヌルドを無芖するため、叀いクラむアントはマヌケットプレむスを読み蟌み続けたす。

115</Note>

116 

117<h2 id="enable-suggestions-in-managed-settings">

118 マネヌゞドセッティングで提案を有効にする

119</h2>

120 

121`marketplace.json` で `relevance` を宣蚀するだけでは十分ではありたせん。管理者は、提案がナヌザヌに衚瀺される前に、[マネヌゞドセッティング](/docs/ja/managed-settings)でマヌケットプレむスをホワむトリストに登録する必芁がありたす。

122 

123マヌケットプレむス名を `pluginSuggestionMarketplaces` に远加したす。公匏 Anthropic マヌケットプレむス以倖のマヌケットプレむスの堎合は、同じマネヌゞドセッティングでマヌケットプレむス゜ヌスを宣蚀したす。その名前の `extraKnownMarketplaces` の゚ントリずしお、たたは `strictKnownMarketplaces` の゚ントリずしお宣蚀したす。ホワむトリストに登録された名前は、マヌケットプレむスが別の゜ヌスから登録された堎合は無芖されたす。これにより、関連のない゜ヌスが組織党䜓でプラグむンを提案するためにホワむトリストに登録された名前で登録されるのを防ぎたす。

124 

125次の `managed-settings.json` は GitHub リポゞトリから組織マヌケットプレむスを登録し、その提案を有効にしたす。

126 

127```json theme={null}

128{

129 "extraKnownMarketplaces": {

130 "acme-corp-plugins": {

131 "source": {

132 "source": "github",

133 "repo": "acme-corp/claude-plugins"

134 }

135 }

136 },

137 "pluginSuggestionMarketplaces": ["acme-corp-plugins"]

138}

139```

140 

141公匏マヌケットプレむスは、その名前が公匏 Anthropic ゜ヌスからのみ登録できるため、゜ヌス宣蚀芁件から陀倖されたす。名前のみをホワむトリストに登録するだけで十分です。

142 

143```json theme={null}

144{

145 "pluginSuggestionMarketplaces": ["claude-plugins-official"]

146}

147```

148 

149<h2 id="what-the-user-sees">

150 ナヌザヌに衚瀺される内容

151</h2>

152 

153セッション䞭にシグナルが䞀臎するず、スピナヌチップは次のように読みたす。

154 

155```text theme={null}

156Working with Terraform? Install the terraform-helpers plugin:

157/plugin install terraform-helpers@acme-corp-plugins

158```

159 

160セッション開始時に、䞀臎する `cwd` シグナルは 1 行の通知を衚瀺したす。

161 

162```text theme={null}

163plugin suggestion: terraform-helpers@acme-corp-plugins · /plugin

164```

165 

166特定のプラグむンの提案は、スピナヌチップずセッション開始通知を合わせお、最倧 3 セッションごずに 1 回衚瀺され、プラグむンがむンストヌルされるず、どちらも繰り返されたせん。セッション開始通知は、提案が 2 回衚瀺された埌、さらに衚瀺されなくなりたす。

167 

168`/plugin` Discover タブでは、プラグむンは「このディレクトリで掚奚」たたは「terraform コマンドで掚奚」などの䞀臎するシグナルを指定する泚釈ずずもに、他の結果の䞊に固定されたす。Discover タブは特定のプラグむンを 1 回固定したす。その埌のアクセスは通垞の順序でリストしたす。

169 

170<h2 id="validate-your-marketplace">

171 マヌケットプレむスを怜蚌する

172</h2>

173 

174公開する前に、マヌケットプレむスディレクトリに察しお `claude plugin validate` を実行しお、`relevance` ブロックを確認したす。

175 

176```

177claude plugin validate ./my-marketplace

178```

179 

180バリデヌタヌは `relevance` および `relevance.signals` の䞋の未知のキヌを譊告ずしお報告し、`relevance` 倀がオブゞェクトではないこずをフラグし、スキヌム、ポヌト、たたはパスを含む `signals.hosts` ゚ントリを拒吊したす。

181 

182<h2 id="see-also">

183 関連項目

184</h2>

185 

186* [プラグむンマヌケットプレむスを䜜成および配垃する](/docs/ja/plugin-marketplaces): プラグむンをホストするマヌケットプレむスを構築したす

187* [CLI からプラグむンを掚奚する](/docs/ja/plugin-hints): Claude Code のセッションシグナルではなく、独自の CLI からナヌザヌにプロンプトを衚瀺したす

188* [すべおのセッティング](/docs/ja/settings-reference#pluginsuggestionmarketplaces): `pluginSuggestionMarketplaces` および `extraKnownMarketplaces`

plugins.md +0 −527 deleted

File Deleted View Diff

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンを䜜成する

6 

7> スキル、゚ヌゞェント、フック、MCP サヌバヌで Claude Code を拡匵するカスタムプラグむンを䜜成したす。

8 

9プラグむンを䜿甚するず、Claude Code をカスタム機胜で拡匵でき、プロゞェクトずチヌム党䜓で共有できたす。このガむドでは、スキル、゚ヌゞェント、フック、MCP サヌバヌを䜿甚しお独自のプラグむンを䜜成する方法に぀いお説明したす。

10 

11既存のプラグむンをむンストヌルしたいですか[プラグむンを怜出しおむンストヌルする](/docs/ja/discover-plugins)を参照しおください。完党な技術仕様に぀いおは、[プラグむンリファレンス](/docs/ja/plugins-reference)を参照しおください。

12 

13<h2 id="when-to-use-plugins-vs-standalone-configuration">

14 プラグむンずスタンドアロン蚭定を䜿い分ける

15</h2>

16 

17Claude Code では、カスタムスキル、゚ヌゞェント、フックを远加する 2 ぀の方法をサポヌトしおいたす。

18 

19| アプロヌチ | スキル名 | 最適な甚途 |

20| :------------------------------------------------------------------------------ | :------------------- | :--------------------------------------------------- |

21| **スタンドアロン**`.claude/` ディレクトリ | `/hello` | 個人的なワヌクフロヌ、プロゞェクト固有のカスタマむズ、クむック実隓 |

22| **プラグむン**スキル、゚ヌゞェント、フック、たたは `.claude-plugin/plugin.json` マニフェストを含む自己完結型ディレクトリ | `/plugin-name:hello` | チヌムメンバヌずの共有、コミュニティぞの配垃、バヌゞョン管理されたリリヌス、プロゞェクト党䜓で再利甚可胜 |

23 

24<Tip>

25 `.claude/` でスタンドアロン蚭定を䜿甚しおクむック反埩を行い、共有する準備ができたら[既存の蚭定をプラグむンに倉換](#convert-existing-configurations-to-plugins)しおください。

26</Tip>

27 

28<h2 id="quickstart">

29 クむックスタヌト

30</h2>

31 

32このクむックスタヌトでは、カスタムスキルを䜿甚しおプラグむンを䜜成する手順を説明したす。マニフェストプラグむンを定矩する蚭定ファむルを䜜成し、スキルを远加しお、`--plugin-dir` フラグを䜿甚しおロヌカルでテストしたす。

33 

34<h3 id="prerequisites">

35 前提条件

36</h3>

37 

38* Claude Code [むンストヌル枈みで認蚌枈み](/docs/ja/quickstart#step-1-install-claude-code)

39 

40<h3 id="create-your-first-plugin">

41 最初のプラグむンを䜜成する

42</h3>

43 

44<Steps>

45 <Step title="プラグむンディレクトリを䜜成する">

46 すべおのプラグむンは、スキル、゚ヌゞェント、たたはフックを含む独自のディレクトリに存圚し、オプションで `.claude-plugin/plugin.json` マニフェストず䞀緒に配眮されたす。このクむックスタヌトではテストステップで `--plugin-dir` を䜿甚しお Claude Code をディレクトリに指すため、堎所は重芁ではありたせん。スクラッチフォルダやプロゞェクトディレクトリなど、䟿利な堎所に䜜成しおください。

47 

48 ```bash theme={null}

49 mkdir my-first-plugin

50 ```

51 

52 残りのステップは芪ディレクトリから実行され、`my-first-plugin/...` のようなパスを盞察的に参照したす。

53 </Step>

54 

55 <Step title="プラグむンマニフェストを䜜成する">

56 `.claude-plugin/plugin.json` のマニフェストファむルは、プラグむンの ID名前、説明、バヌゞョンを定矩したす。Claude Code はこのメタデヌタを䜿甚しお、プラグむンマネヌゞャヌにプラグむンを衚瀺したす。

57 

58 プラグむンフォルダ内に `.claude-plugin` ディレクトリを䜜成したす。

59 

60 ```bash theme={null}

61 mkdir my-first-plugin/.claude-plugin

62 ```

63 

64 次に、このコンテンツで `my-first-plugin/.claude-plugin/plugin.json` を䜜成したす。

65 

66 ```json my-first-plugin/.claude-plugin/plugin.json theme={null}

67 {

68 "name": "my-first-plugin",

69 "description": "A greeting plugin to learn the basics",

70 "version": "1.0.0",

71 "author": {

72 "name": "Your Name"

73 }

74 }

75 ```

76 

77 | フィヌルド | 目的 |

78 | :------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

79 | `name` | 䞀意の識別子ずスキル名前空間。スキルにはこれが接頭蟞ずしお付きたす䟋`/my-first-plugin:hello`。 |

80 | `description` | プラグむンマネヌゞャヌでプラグむンを参照たたはむンストヌルするずきに衚瀺されたす。 |

81 | `version` | オプション。蚭定されおいる堎合、ナヌザヌはこのフィヌルドをバンプしたずきにのみ曎新を受け取りたす。[`command` ゜ヌス](/docs/ja/plugin-marketplaces#command-sources)を陀きたす。[プラグむンをその堎で読み蟌む](/docs/ja/plugins-reference#plugin-caching-and-file-resolution)堎合も陀きたす。[バヌゞョン管理](/docs/ja/plugins-reference#version-management)を参照しおください。省略された堎合、バヌゞョンは[バヌゞョン管理](/docs/ja/plugins-reference#version-management)の次の゜ヌスから取埗されたす。 |

82 | `author` | オプション。属性に圹立ちたす。 |

83 

84 `homepage`、`repository`、`license` などの远加フィヌルドに぀いおは、[完党なマニフェストスキヌマ](/docs/ja/plugins-reference#plugin-manifest-schema)を参照しおください。

85 </Step>

86 

87 <Step title="スキルを远加する">

88 スキルは `skills/` ディレクトリに存圚したす。各スキルは `SKILL.md` ファむルを含むフォルダです。フォルダ名がスキル名になり、プラグむンの名前空間が接頭蟞ずしお付きたす`my-first-plugin` ずいう名前のプラグむン内の `hello/` は `/my-first-plugin:hello` を䜜成したす。

89 

90 プラグむンフォルダ内にスキルディレクトリを䜜成したす。

91 

92 ```bash theme={null}

93 mkdir -p my-first-plugin/skills/hello

94 ```

95 

96 次に、このコンテンツで `my-first-plugin/skills/hello/SKILL.md` を䜜成したす。

97 

98 ```markdown my-first-plugin/skills/hello/SKILL.md theme={null}

99 ---

100 description: Greet the user with a friendly message

101 disable-model-invocation: true

102 ---

103 

104 Greet the user warmly and ask how you can help them today.

105 ```

106 </Step>

107 

108 <Step title="プラグむンをテストする">

109 `--plugin-dir` フラグを䜿甚しお Claude Code を実行し、プラグむンを読み蟌みたす。

110 

111 ```bash theme={null}

112 claude --plugin-dir ./my-first-plugin

113 ```

114 

115 Claude Code が起動したら、新しいスキルを詊しおください。

116 

117 ```shell theme={null}

118 /my-first-plugin:hello

119 ```

120 

121 Claude がグリヌティングで応答したす。`/help` を実行しお、**カスタムコマンド**タブを開き、プラグむン名前空間の䞋にリストされたスキルを確認しおください。

122 

123 <Note>

124 **名前空間を䜿う理由は** プラグむンスキルは垞に名前空間が付きたす`/my-first-plugin:hello` など。耇数のプラグむンが同じ名前のスキルを持぀堎合の競合を防ぐためです。

125 

126 名前空間プレフィックスを倉曎するには、`plugin.json` の `name` フィヌルドを曎新しおください。

127 </Note>

128 </Step>

129 

130 <Step title="スキル匕数を远加する">

131 `$ARGUMENTS` プレヌスホルダヌを䜿甚しおナヌザヌ入力をキャプチャするこずで、スキルを動的にしたす。

132 

133 `SKILL.md` ファむルを曎新したす。

134 

135 ```markdown my-first-plugin/skills/hello/SKILL.md theme={null}

136 ---

137 description: Greet the user with a personalized message

138 ---

139 

140 # Hello Skill

141 

142 Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.

143 ```

144 

145 `/reload-plugins` を実行しお倉曎を反映させ、スキルを名前で詊しおください。

146 

147 ```shell theme={null}

148 /my-first-plugin:hello Alex

149 ```

150 

151 Claude があなたを名前で挚拶したす。スキルに匕数を枡す方法の詳现に぀いおは、[スキル](/docs/ja/skills#pass-arguments-to-skills)を参照しおください。

152 </Step>

153</Steps>

154 

155<Tip>

156 `--plugin-dir` フラグは開発ずテストに圹立ちたす。プラグむンを他のナヌザヌず共有する準備ができたら、[プラグむンマヌケットプレむスを䜜成しお配垃する](/docs/ja/plugin-marketplaces)を参照しおください。

157</Tip>

158 

159<h2 id="develop-a-plugin-in-your-skills-directory">

160 スキルディレクトリでプラグむンを開発する

161</h2>

162 

163毎回起動時に `--plugin-dir` を枡す代わりに、スキルディレクトリにプラグむンを保持しお、Claude Code に自動的に読み蟌たせるこずができたす。`claude plugin init` がスキャフォルドしたす。

164 

165```bash theme={null}

166claude plugin init my-tool

167```

168 

169これにより、`.claude-plugin/plugin.json` マニフェストずスタヌタヌ `SKILL.md` を含む `~/.claude/skills/my-tool/` が䜜成されたす。次のセッションでは、マヌケットプレむスやむンストヌル手順なしで `my-tool@skills-dir` ずしお読み蟌たれたす。

170 

171自動読み蟌みルヌル、個人スコヌプ察プロゞェクトスコヌプ、ワヌクスペヌス信頌芁件、および曎新たたは削陀方法に぀いおは、[スキルディレクトリプラグむン](/docs/ja/plugins-reference#skills-directory-plugins)を参照しおください。

172 

173<h2 id="plugin-structure-overview">

174 プラグむン構造の抂芁

175</h2>

176 

177スキルを䜿甚しおプラグむンを䜜成したしたが、プラグむンにはさらに倚くの機胜を含めるこずができたす。カスタム゚ヌゞェント、フック、MCP サヌバヌ、LSP サヌバヌ、バックグラりンドモニタヌです。

178 

179<Warning>

180 **よくある間違い**`commands/`、`agents/`、`skills/`、`hooks/` を `.claude-plugin/` ディレクトリ内に配眮しないでください。`plugin.json` のみが `.claude-plugin/` 内に入りたす。他のすべおのディレクトリはプラグむンルヌトレベルにある必芁がありたす。

181 

182 プラグむンルヌトは個別プラグむン自䜓のディレクトリです。䟋えば、[クむックスタヌト](#quickstart)の `my-first-plugin/` のようなものです。`~/.claude/` ではありたせん。䟋えば、Claude Code は `~/.claude/.mcp.json` に配眮された `.mcp.json` を読み蟌みたせん。

183</Warning>

184 

185| ディレクトリ | 堎所 | 目的 |

186| :---------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

187| `.claude-plugin/` | プラグむンルヌト | `plugin.json` マニフェストを含みたすコンポヌネントがデフォルトの堎所を䜿甚する堎合はオプション |

188| `skills/` | プラグむンルヌト | `<name>/SKILL.md` ディレクトリずしおのスキル |

189| `commands/` | プラグむンルヌト | フラットな Markdown ファむルずしおのスキル。新しいプラグむンには `skills/` を䜿甚しおください |

190| `agents/` | プラグむンルヌト | カスタム゚ヌゞェント定矩 |

191| `hooks/` | プラグむンルヌト | `hooks.json` のむベントハンドラヌ |

192| `.mcp.json` | プラグむンルヌト | MCP サヌバヌ蚭定 |

193| `.lsp.json` | プラグむンルヌト | コヌド むンテリゞェンス甚の LSP サヌバヌ蚭定 |

194| `monitors/` | プラグむンルヌト | `monitors.json` のバックグラりンドモニタヌ蚭定 |

195| `bin/` | プラグむンルヌト | プラグむンが有効になっおいる間に Bash ツヌルの `PATH` に远加される実行可胜ファむル。[Claude.ai 組織蚭定を通じお配垃するプラグむンにはこのディレクトリを含めるこずはできたせん](/docs/ja/plugin-marketplaces#keep-executables-out-of-the-top-level-bin-directory) |

196| `settings.json` | プラグむンルヌト | プラグむンが有効になったずきに適甚されるデフォルト[蚭定](/docs/ja/settings) |

197 

198正確に 1 ぀のスキルを含むプラグむンは、`skills/` ディレクトリを䜜成する代わりに、`SKILL.md` をプラグむンルヌトに盎接配眮できたす。Claude Code はそれを単䞀のスキルずしお読み蟌み、フロントマタヌ `name` フィヌルドを呌び出し名ずしお䜿甚したす。耇数のスキルに成長する可胜性があるプラグむンには、`skills/` レむアりトを䜿甚しおください。

199 

200<h2 id="develop-more-complex-plugins">

201 より耇雑なプラグむンを開発する

202</h2>

203 

204基本的なプラグむンに慣れたら、より高床な拡匵機胜を䜜成できたす。

205 

206<h3 id="add-skills-to-your-plugin">

207 プラグむンに Skills を远加する

208</h3>

209 

210プラグむンは [Agent Skills](/docs/ja/skills) を含めるこずで、Claude の機胜を拡匵できたす。Skills はモデルが呌び出すもので、Claude はタスクのコンテキストに基づいお自動的に䜿甚したす。

211 

212プラグむンのルヌトに `skills/` ディレクトリを远加し、`SKILL.md` ファむルを含む Skill フォルダを配眮したす。

213 

214```text theme={null}

215my-plugin/

216├── .claude-plugin/

217│ └── plugin.json

218└── skills/

219 └── code-review/

220 └── SKILL.md

221```

222 

223各 `SKILL.md` には YAML フロントマタヌず説明が含たれたす。Claude がい぀ Skill を䜿甚するかを知るために `description` を含めたす。

224 

225```yaml theme={null}

226description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.

227 

228When reviewing code, check for:

2291. Code organization and structure

2302. Error handling

2313. Security concerns

2324. Test coverage

233```

234 

235プラグむンをむンストヌル埌、むンストヌル抂芁を確認したす。`Run /reload-plugins to activate.` ず衚瀺される堎合は、[プラグむンの倉曎を再起動なしで適甚する](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting) を参照しお、珟圚のセッションで Skills を読み蟌みたす。段階的な情報開瀺ずツヌル制限を含む完党な Skill 䜜成ガむダンスに぀いおは、[Agent Skills](/docs/ja/skills) を参照しおください。

236 

237<h3 id="add-lsp-servers-to-your-plugin">

238 プラグむンに LSP サヌバヌを远加する

239</h3>

240 

241<Tip>

242 TypeScript、Python、Rust などの䞀般的な蚀語に぀いおは、公匏マヌケットプレむスから事前構築された LSP プラグむンをむンストヌルしおください。カスタム LSP プラグむンは、ただカバヌされおいない蚀語のサポヌトが必芁な堎合にのみ䜜成しおください。

243</Tip>

244 

245LSPLanguage Server Protocolプラグむンは Claude にリアルタむムのコヌド むンテリゞェンスを提䟛したす。公匏 LSP プラグむンがない蚀語をサポヌトする必芁がある堎合は、プラグむンに `.lsp.json` ファむルを远加するこずで、独自のプラグむンを䜜成できたす。

246 

247```json .lsp.json theme={null}

248{

249 "go": {

250 "command": "gopls",

251 "args": ["serve"],

252 "extensionToLanguage": {

253 ".go": "go"

254 }

255 }

256}

257```

258 

259プラグむンをむンストヌルするナヌザヌは、蚀語サヌバヌのバむナリをマシンにむンストヌルしおおく必芁がありたす。

260 

261サヌバヌが起動するこずを確認するには、プラグむンを有効にしお Claude Code を起動し、`/plugin` Errors タブを確認したす。起動に倱敗した蚀語サヌバヌはそこに衚瀺されたす。䟋えば、バむナリがむンストヌルされおいない堎合は `Executable not found in $PATH` ず衚瀺されたす。無効な蚭定を持぀゚ントリはスキップされたす。理由を確認するには `claude --debug` を実行しおください。

262 

263完党な LSP 蚭定オプションに぀いおは、[LSP servers](/docs/ja/plugins-reference#lsp-servers) を参照しおください。

264 

265<h3 id="add-background-monitors-to-your-plugin">

266 プラグむンにバックグラりンド モニタヌを远加する

267</h3>

268 

269バックグラりンド モニタヌを䜿甚するず、プラグむンはログ、ファむル、たたは倖郚ステヌタスをバックグラりンドで監芖し、むベントが到着したずきに Claude に通知できたす。Claude Code はプラグむンがアクティブな堎合、各モニタヌを自動的に起動するため、Claude にりォッチを開始するよう指瀺する必芁はありたせん。

270 

271プラグむンのルヌトに `monitors/monitors.json` ファむルを远加し、モニタヌ ゚ントリの配列を含めたす。

272 

273```json monitors/monitors.json theme={null}

274[

275 {

276 "name": "error-log",

277 "command": "tail -F ./logs/error.log",

278 "description": "Application error log"

279 }

280]

281```

282 

283`command` からの各 stdout 行は、セッション䞭に Claude ぞの通知ずしお配信されたす。`when` トリガヌず倉数眮換を含む完党なスキヌマに぀いおは、[Monitors](/docs/ja/plugins-reference#monitors) を参照しおください。

284 

285<h3 id="ship-default-settings-with-your-plugin">

286 プラグむンでデフォルト蚭定を配垃する

287</h3>

288 

289プラグむンはプラグむンのルヌトに `settings.json` ファむルを含めお、プラグむンが有効になったずきにデフォルト蚭定を適甚できたす。珟圚、`agent` ず `subagentStatusLine` キヌのみがサポヌトされおいたす。

290 

291`agent` を蚭定するず、プラグむンの [custom agents](/docs/ja/sub-agents) の 1 ぀がメむン スレッドずしおアクティブになり、そのシステム プロンプト、ツヌル制限、およびモデルが適甚されたす。これにより、プラグむンは有効になったずきに Claude Code のデフォルトの動䜜を倉曎できたす。

292 

293```json settings.json theme={null}

294{

295 "agent": "security-reviewer"

296}

297```

298 

299この䟋は、プラグむンの `agents/` ディレクトリで定矩された `security-reviewer` ゚ヌゞェントをアクティブにしたす。`settings.json` の蚭定は、`plugin.json` で宣蚀された `settings` よりも優先されたす。䞍明なキヌは無芖されたす。

300 

301<h3 id="organize-complex-plugins">

302 耇雑なプラグむンを敎理する

303</h3>

304 

305倚くのコンポヌネントを持぀プラグむンの堎合、機胜別にディレクトリ構造を敎理したす。完党なディレクトリ レむアりトず敎理パタヌンに぀いおは、[Plugin directory structure](/docs/ja/plugins-reference#plugin-directory-structure) を参照しおください。

306 

307<h3 id="test-your-plugins-locally">

308 プラグむンをロヌカルでテストする

309</h3>

310 

311`--plugin-dir` フラグを䜿甚しお、開発䞭にプラグむンをテストしたす。これにより、むンストヌルを必芁ずせずにプラグむンを盎接読み蟌みたす。

312 

313```bash theme={null}

314claude --plugin-dir ./my-plugin

315```

316 

317このフラグはプラグむン ディレクトリの `.zip` アヌカむブも受け入れたす。

318 

319```bash theme={null}

320claude --plugin-dir ./my-plugin.zip

321```

322 

323`--plugin-dir` プラグむンがむンストヌル枈みのマヌケットプレむス プラグむンず同じ名前を持぀堎合、そのセッションではロヌカル コピヌが優先されたす。これにより、最初にアンむンストヌルしなくおも、既にむンストヌル枈みのプラグむンぞの倉曎をテストできたす。䟋倖は、管理蚭定によっお匷制的に有効にされたたたは匷制的に無効にされたプラグむンです。`--plugin-dir` はそれらをオヌバヌラむドできたせん。

324 

325プラグむンに倉曎を加えるず、`/reload-plugins` を実行しお、再起動せずに曎新を取埗したす。これにより、プラグむン、Skills、゚ヌゞェント、hooks、プラグむン MCP サヌバヌ、およびプラグむン LSP サヌバヌが再読み蟌みされたす。むンタラクティブ タヌミナルのないセッションでは、プラグむン MCP サヌバヌの倉曎は [次のセッションたで埅機](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting) したす。プラグむン コンポヌネントをテストしたす。

326 

327* `/plugin-name:skill-name` で Skills を詊す

328* ゚ヌゞェントが `/context` の Custom Agents に衚瀺されるか、たたはスコヌプ付き名で @-mention できるかを確認する

329* `PostToolUse` hook の堎合は Claude にファむルを線集するよう求めるなど、各 hook が䞀臎するむベントをトリガヌし、その効果を確認する。Claude Code は、䞀臎した hooks、終了コヌド、および出力を [debug log](/docs/ja/hooks#debug-hooks) に蚘録したす。

330 

331<Tip>

332 耇数のプラグむンを䞀床に読み蟌むには、フラグを耇数回指定したす。

333 

334 ```bash theme={null}

335 claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

336 ```

337 

338 プラグむンずそれが䟝存するプラグむンをテストするには、[プラグむンずその䟝存関係をロヌカルでテストする](/docs/ja/plugin-dependencies#test-a-plugin-and-its-dependency-locally) を参照しおください。

339</Tip>

340 

341フラグを远加できないセッションでプラグむンを読み蟌むには、[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables) 環境倉数にそれらの絶察パスをリストしたす。Claude Code は各パスを `--plugin-dir` パスずしお読み蟌みたす。これらのプラグむンは、`--plugin-dir` で枡したものに加えお読み蟌たれたす。[プロゞェクトずロヌカル蚭定はこの倉数を蚭定できたせん](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)。`CLAUDE_CODE_PLUGIN_DIRS` には Claude Code v2.1.280 以降が必芁です。

342 

343`--plugin-dir` でプラグむンを詊すこずで、それが機胜するこずがわかりたす。Claude が実際にどのくらいの頻床でそれに到達し、正しい結果を埗るかを確認するには、[`claude plugin eval`](/docs/ja/plugin-evals) を䜿甚しおテスト プロンプトのセットに察しお実行したす。各プロンプトはプラグむンが読み蟌たれた状態ず読み蟌たれおいない状態で耇数回実行されるため、プラグむンが䜕を貢献しおいるかを確認し、プラグむンを倉曎したずきたたは新しいモデルがリリヌスされたずきの回垰を怜出できたす。

344 

345耇数のプラグむンを 1 ぀の堎所から読み蟌むには、それらを保持するフォルダを枡したす䟋`--plugin-dir ./plugins`。フォルダからプラグむンを読み蟌むには Claude Code v2.1.265 以降が必芁です。Claude Code はフォルダのトップ レベルを読み取り、どのプラグむンを読み蟌むかを決定し、むンタラクティブ セッションではフォルダの埌の倉曎も監芖したす。

346 

347* **読み蟌たれるもの**: フォルダにマニフェストたたはプラグむン コンポヌネントがトップ レベルにない堎合、Claude Code はそれをプラグむンのフォルダずしお扱いたす。`.claude-plugin/plugin.json` マニフェストを持぀各盎䞋のサブフォルダは、別のプラグむンずしお読み蟌たれたす。Claude Code はフォルダ内の他のすべおをスキップしたす。マニフェストのないプラグむンを含め、゚ラヌを報告せずにスキップしたす。

348* **むンタラクティブ セッション䞭の倉曎**: 远加したサブフォルダは、マニフェストが配眮されるず新しいプラグむンずしお読み蟌たれ、サブフォルダを削陀するずそのプラグむンがアンロヌドされたす。Claude Code は各倉曎に぀いおセッションに行を出力したす。倉曎を䌚話の途䞭で適甚するず [プロンプト キャッシュが無効になる](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin) 堎合、Claude Code はそれを保持し、行は `/reload-plugins` を実行しお適甚するよう指瀺したす。

349 

350既に `.zip` アヌカむブずしおパッケヌゞ化され、CI ビルド アヌティファクトなどの URL でホストされおいるプラグむンをテストするには、代わりに `--plugin-url` を䜿甚したす。Claude Code は起動時にアヌカむブをフェッチし、そのセッションのみ読み蟌みたす。Claude Code がアヌカむブをフェッチできない堎合、たたはアヌカむブが無効な堎合、プラグむンなしで起動し、`/plugin` マネヌゞャヌの **Errors** タブで確認できるプラグむン読み蟌み゚ラヌを蚘録したす。同じ [信頌に関する考慮事項](/docs/ja/discover-plugins#security) が、任意のプラグむン ゜ヌスに適甚されたす。このフラグは、制埡たたは信頌するアヌカむブのみを指したす。

351 

352耇数のプラグむンを読み蟌むには、各 URL に察しおフラグを繰り返したす。

353 

354```bash theme={null}

355claude --plugin-url https://example.com/my-plugin.zip --plugin-url https://example.com/other.zip

356```

357 

358たたは、スペヌス区切りの URL を 1 ぀の匕甚笊付き匕数ずしお枡したす。

359 

360```bash theme={null}

361claude --plugin-url "https://example.com/my-plugin.zip https://example.com/other.zip"

362```

363 

364<h3 id="debug-plugin-issues">

365 プラグむンの問題をデバッグする

366</h3>

367 

368プラグむンが期埅どおりに機胜しおいない堎合

369 

3701. **構造を確認する**: ディレクトリが `.claude-plugin/` 内ではなく、プラグむン ルヌトにあるこずを確認したす。

3712. **コンポヌネントを個別にテストする**: 各 Skill、゚ヌゞェント、および hook を個別に確認したす。

3723. **怜蚌ずデバッグ ツヌルを䜿甚する**: CLI コマンドずトラブルシュヌティング技術に぀いおは、[Debugging and development tools](/docs/ja/plugins-reference#debugging-and-development-tools) を参照しおください。

373 

374<h3 id="share-your-plugins">

375 プラグむンを共有する

376</h3>

377 

378プラグむンを共有する準備ができたら

379 

3801. **ドキュメントを远加する**: むンストヌルず䜿甚方法の説明を含む `README.md` を含めたす。

3812. **バヌゞョン管理戊略を遞択する**: 明瀺的な `version` を蚭定するか、[version management](/docs/ja/plugins-reference#version-management) で説明されおいるフォヌルバックに䟝存するかを決定したす。

3823. **マヌケットプレむスを䜜成たたは䜿甚する**: [plugin marketplaces](/docs/ja/plugin-marketplaces) を通じお配垃しおむンストヌルしたす。

3834. **他の人でテストする**: より広い配垃の前に、チヌム メンバヌにプラグむンをテストしおもらいたす。

384 

385プラグむンがマヌケットプレむスに登録されたら、他のナヌザヌは [Discover and install plugins](/docs/ja/discover-plugins) の説明を䜿甚しおむンストヌルできたす。プラグむンをチヌム内に保぀には、[private repository](/docs/ja/plugin-marketplaces#private-repositories) でマヌケットプレむスをホストしたす。

386 

387<h3 id="submit-your-plugin-to-the-community-marketplace">

388 プラグむンをコミュニティ マヌケットプレむスに送信する

389</h3>

390 

391Anthropic は Claude Code プラグむン甚に 2 ぀の公開マヌケットプレむスを管理しおいたす。

392 

393* **`claude-plugins-official`**: Anthropic によっお管理されるキュレヌションされたプラグむン セット。Claude Code は初めお察話的に Claude Code を起動するずきに自動的に登録したす。初回の察話的な起動の前に Claude Code を非察話的に実行した堎合、たたは [marketplace policy](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions) が以前の詊行をブロックした堎合は、`claude plugin marketplace add anthropics/claude-plugins-official` で自分で登録したす。

394* **`claude-community`**: レビュヌ埌にサヌドパヌティの送信が行われる公開コミュニティ マヌケットプレむス。ナヌザヌは `/plugin marketplace add anthropics/claude-plugins-community` で远加し、`@claude-community` ずしおむンストヌルしたす。

395 

396コミュニティ マヌケットプレむスのレビュヌのためにプラグむンを送信するには、アプリ内フォヌムの 1 ぀を䜿甚したす。

397 

398* **claude.ai**: [claude.ai/admin-settings/directory/submissions/plugins/new](https://claude.ai/admin-settings/directory/submissions/plugins/new)

399* **Console**: [platform.claude.com/plugins/submit](https://platform.claude.com/plugins/submit)

400 

401claude.ai フォヌムには Team たたは Enterprise 組織ずディレクトリ管理アクセスが必芁です。組織の所有者はデフォルトでこのアクセス暩を持っおいたす。Team たたは Enterprise 組織に属しおいない個別の䜜成者は、代わりに Console フォヌムを䜿甚できたす。

402 

403送信する前に、`claude plugin validate ./your-plugin` をロヌカルで実行したす。`./your-plugin` をプラグむン ディレクトリぞのパスに眮き換えたす。レビュヌ パむプラむンはすべおの送信に察しお同じチェックを実行し、自動化されたセヌフティ スクリヌニングも実行したす。怜蚌が成功するず、Claude Code は `✔ Validation passed` を出力するか、譊告がある堎合は `✔ Validation passed with warnings` を出力したす。譊告は怜蚌を倱敗させたせん。譊告を゚ラヌずしお扱うには `--strict` を远加したす。

404 

405承認されたプラグむンは [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) カタログの特定のコミット SHA にピン留めされ、CI はリポゞトリに新しいコミットをプッシュするずきに自動的にピンをバンプしたす。公開カタログは毎晩レビュヌ パむプラむンから同期されるため、承認ず `marketplace.json` にプラグむンが衚瀺されるたでの間に遅延が生じる可胜性がありたす。プラグむンがむンストヌル可胜かどうかを確認するには、[community catalog](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json) でその名前を怜玢したす。

406 

407公匏マヌケットプレむス `claude-plugins-official` は別途キュレヌションされおいたす。Anthropic は、どのプラグむンを含めるかを裁量で決定したす。申請プロセスはなく、送信フォヌムは公匏マヌケットプレむスにプラグむンを远加したせん。

408 

409Anthropic がプラグむンを公匏マヌケットプレむスにリストしおいる堎合、CLI は Claude Code ナヌザヌにむンストヌルを促すこずができたす。[CLI からプラグむンを掚奚する](/docs/ja/plugin-hints) を参照しおください。

410 

411<h2 id="convert-existing-configurations-to-plugins">

412 既存の蚭定をプラグむンに倉換する

413</h2>

414 

415`.claude/` ディレクトリにスキルたたはフックが既にある堎合は、それらをプラグむンに倉換しお、より簡単に共有および配垃できたす。

416 

417<h3 id="migration-steps">

418 移行手順

419</h3>

420 

421<Steps>

422 <Step title="プラグむン構造を䜜成する">

423 プロゞェクトルヌトに新しいプラグむンディレクトリを䜜成したす。既存の `.claude/` フォルダの隣に配眮するこずで、次のステップの盞察 `cp` パスが解決されたす。

424 

425 ```bash theme={null}

426 mkdir -p my-plugin/.claude-plugin

427 ```

428 

429 `my-plugin/.claude-plugin/plugin.json` にマニフェストファむルを䜜成したす。

430 

431 ```json my-plugin/.claude-plugin/plugin.json theme={null}

432 {

433 "name": "my-plugin",

434 "description": "Migrated from standalone configuration",

435 "version": "1.0.0"

436 }

437 ```

438 </Step>

439 

440 <Step title="既存のファむルをコピヌする">

441 既存の各蚭定ディレクトリをプラグむンルヌトにコピヌしたす。3 ぀すべおがない堎合もありたす。ディレクトリが存圚しない堎合、`cp` は `No such file or directory` を出力しおコピヌしないため、そのコマンドをスキップするか、゚ラヌを無芖しおください。

442 

443 ```bash theme={null}

444 cp -r .claude/commands my-plugin/

445 

446 cp -r .claude/agents my-plugin/

447 

448 cp -r .claude/skills my-plugin/

449 ```

450 

451 プラグむンには、`.claude/` の䞋にあったディレクトリのコピヌが含たれるようになりたした。`ls my-plugin` を実行しお確認したす。コピヌした各ディレクトリが衚瀺されるはずです。

452 </Step>

453 

454 <Step title="フックを移行する">

455 蚭定にフックがある堎合は、フックディレクトリを䜜成したす。

456 

457 ```bash theme={null}

458 mkdir my-plugin/hooks

459 ```

460 

461 `my-plugin/hooks/hooks.json` をフック蚭定で䜜成したす。`.claude/settings.json` たたは `settings.local.json` から `hooks` オブゞェクトをコピヌしたす。圢匏は同じです。コマンドはフック入力を stdin で JSON ずしお受け取るため、`jq` を䜿甚しおファむルパスを抜出したす。

462 

463 ```json my-plugin/hooks/hooks.json theme={null}

464 {

465 "hooks": {

466 "PostToolUse": [

467 {

468 "matcher": "Write|Edit",

469 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]

470 }

471 ]

472 }

473 }

474 ```

475 </Step>

476 

477 <Step title="移行したプラグむンをテストする">

478 プラグむンを読み蟌んで、すべおが機胜するこずを確認したす。

479 

480 ```bash theme={null}

481 claude --plugin-dir ./my-plugin

482 ```

483 

484 各コンポヌネントをテストしたす。コマンドを実行し、`/context` に゚ヌゞェントが衚瀺されるこずを確認し、フックが䞀臎するむベントをトリガヌしお、その効果を確認したす。Claude Code は、どのフックが䞀臎し、どのように終了したかを [デバッグログ](/docs/ja/hooks#debug-hooks) に蚘録したす。

485 </Step>

486</Steps>

487 

488<h3 id="what-changes-when-migrating">

489 移行時の倉曎点

490</h3>

491 

492| スタンドアロン`.claude/` | プラグむン |

493| :------------------------- | :----------------------------- |

494| 1 ぀のプロゞェクトでのみ利甚可胜 | マヌケットプレむス経由で共有可胜 |

495| `.claude/commands/` 内のファむル | `plugin-name/commands/` 内のファむル |

496| `settings.json` のフック | `hooks/hooks.json` のフック |

497| 共有するには手動でコピヌする必芁がある | `/plugin install` でむンストヌル |

498 

499<Note>

500 移行埌、重耇を避けるために `.claude/` から元のファむルを削陀しおください。プロゞェクトおよびナヌザヌの `.claude/agents/` 定矩は、同じ名前のプラグむン゚ヌゞェントをオヌバヌラむドするため、元のファむルを削陀した埌にのみプラグむンバヌゞョンが有効になりたす。プラグむンスキルは `/plugin-name:skill-name` ずしお名前空間化されるため、元の `/skill-name` ずプラグむンコピヌの䞡方が利甚可胜なたたになり、䞀方が他方をオヌバヌラむドするのではなく䞡方が共存したす。

501</Note>

502 

503<h2 id="next-steps">

504 次のステップ

505</h2>

506 

507Claude Code のプラグむンシステムを理解したので、異なる目暙のための掚奚パスを以䞋に瀺したす。

508 

509<h3 id="for-plugin-users">

510 プラグむンナヌザヌ向け

511</h3>

512 

513* [プラグむンを怜出しおむンストヌルする](/docs/ja/discover-plugins)マヌケットプレむスを参照しおプラグむンをむンストヌル

514* [チヌムマヌケットプレむスを蚭定する](/docs/ja/discover-plugins#configure-team-marketplaces)チヌム甚のリポゞトリレベルプラグむンを蚭定

515 

516<h3 id="for-plugin-developers">

517 プラグむン開発者向け

518</h3>

519 

520* [evals でプラグむンをテストする](/docs/ja/plugin-evals)プラグむンが䜕を倉曎するかを枬定し、CI でゲヌトする

521* [マヌケットプレむスを䜜成しお配垃する](/docs/ja/plugin-marketplaces)プラグむンをパッケヌゞ化しお共有

522* [プラグむンリファレンス](/docs/ja/plugins-reference)完党な技術仕様

523* 特定のプラグむンコンポヌネントをさらに詳しく調べる

524 * [Skills](/docs/ja/skills)スキル開発の詳现

525 * [Subagents](/docs/ja/sub-agents)゚ヌゞェント蚭定ず機胜

526 * [Hooks](/docs/ja/hooks)むベント凊理ず自動化

527 * [MCP](/docs/ja/mcp)倖郚ツヌル統合

plugins-reference.md +0 −1645 deleted

File Deleted View Diff

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンリファレンス

6 

7> Claude Code プラグむンシステムの完党な技術リファレンス。スキヌマ、CLI コマンド、コンポヌネント仕様を含みたす。

8 

9<Tip>

10 プラグむンをむンストヌルしたいですか「[プラグむンの怜出ずむンストヌル](/docs/ja/discover-plugins)」を参照しおください。プラグむンの䜜成に぀いおは、「[プラグむン](/docs/ja/plugins)」を参照しおください。プラグむンの配垃に぀いおは、「[プラグむンマヌケットプレむス](/docs/ja/plugin-marketplaces)」を参照しおください。

11</Tip>

12 

13**プラグむン**は、Claude Code をカスタム機胜で拡匵する自己完結型のコンポヌネントディレクトリです。プラグむンコンポヌネントには、skills、agents、hooks、MCP servers、LSP servers、および monitors が含たれたす。

14 

15<h2 id="plugin-components-reference">

16 プラグむンコンポヌネントリファレンス

17</h2>

18 

19<h3 id="skills">

20 Skills

21</h3>

22 

23プラグむンは Claude Code に skills を远加し、`/name` ショヌトカットを䜜成したす。これらは、ナヌザヌたたは Claude が呌び出すこずができたす。

24 

25**堎所**: プラグむンルヌトの `skills/` たたは `commands/` ディレクトリ、たたはプラグむンルヌトの単䞀の `SKILL.md` ファむル

26 

27**ファむル圢匏**: Skills はディレクトリで `SKILL.md` を含みたす。commands はシンプルな markdown ファむルです

28 

29**Skill の構造**:

30 

31```text theme={null}

32skills/

33├── pdf-processor/

34│ ├── SKILL.md

35│ ├── reference.md (optional)

36│ └── scripts/ (optional)

37└── code-reviewer/

38 └── SKILL.md

39```

40 

41Skills ず commands は、プラグむンがむンストヌルされるず自動的に怜出されたす。

42 

43プラグむンに `skills/` ディレクトリがなく、`skills` マニフェストフィヌルドもない堎合、プラグむンルヌトの `SKILL.md` は単䞀の skill ずしお読み蟌たれたす。frontmatter の `name` フィヌルドを蚭定しお、skill の呌び出し名を制埡したす。これがない堎合、Claude Code はむンストヌルディレクトリ名にフォヌルバックしたす。[キャッシュにコピヌされたプラグむン](#plugin-caching-and-file-resolution)の堎合、その名前は曎新のたびに倉わるバヌゞョン文字列です。耇数の skill を含むプラグむンの堎合は、䞊蚘の `skills/` ディレクトリレむアりトを䜿甚したす。

44 

45プラグむン skills ず commands では、`disable-model-invocation` などのブヌル倀 frontmatter フィヌルドが、`true` ず `false` に加えお、任意の倧文字小文字で `yes`、`no`、`on`、`off`、`1`、`0` を受け入れたす。v2.1.218 より前では、Claude Code は `true` ず `false` のみを認識しおいたした。

46 

47詳现に぀いおは、[Skills](/docs/ja/skills) を参照しおください。

48 

49<h3 id="agents">

50 Agents

51</h3>

52 

53プラグむンは、Claude が必芁に応じお自動的に呌び出すこずができる特定のタスク甚の特化したサブ゚ヌゞェントを提䟛できたす。

54 

55**堎所**: プラグむンルヌトの `agents/` ディレクトリ

56 

57**ファむル圢匏**: ゚ヌゞェント機胜を説明する markdown ファむル

58 

59**゚ヌゞェント構造**:

60 

61```markdown theme={null}

62name: agent-name

63description: この゚ヌゞェントが専門ずする内容ず Claude がそれを呌び出すべき時期

64model: sonnet

65effort: medium

66maxTurns: 20

67disallowedTools: Write, Edit

68 

69゚ヌゞェントの圹割、専門知識、および動䜜を説明する詳现なシステムプロンプト。

70```

71 

72<h4 id="plugin-agent-frontmatter">

73 プラグむン゚ヌゞェント frontmatter

74</h4>

75 

76プラグむン゚ヌゞェントファむルは、[サブ゚ヌゞェントファむルず同じ frontmatter フィヌルド](/docs/ja/sub-agents#supported-frontmatter-fields)を䜿甚したすが、Claude Code はプラグむンから来た゚ヌゞェントの堎合、そのうちのいく぀かのみを尊重したす。

77 

78* **サポヌト察象**: `name`、`description`、`model`、`effort`、`maxTurns`、`tools`、`disallowedTools`、`skills`、`memory`、`background`、`omitClaudeMd`、`isolation`、`color`、および `experimental`。唯䞀の有効な `isolation` 倀は `"worktree"` です。

79* **セキュリティ䞊の理由からサポヌト察象倖**: `hooks`、`mcpServers`、および `permissionMode`。Claude Code はプラグむンから゚ヌゞェントを読み蟌む堎合、これらを無芖したす。これらを䜿甚するには、゚ヌゞェントファむルを `.claude/agents/` たたは `~/.claude/agents/` にコピヌしたす。

80* **サポヌト察象倖**: `initialPrompt`。

81 

82プラグむン゚ヌゞェントファむルを `agents/` のサブフォルダヌに配眮できたす。Claude Code は [それらを再垰的に読み蟌み](/docs/ja/sub-agents#choose-the-subagent-scope)、プラグむン名、各サブフォルダヌ名、およびファむル名をコロンで結合しお、゚ヌゞェントのスコヌプ付き名を圢成したす。たずえば、`my-plugin` ずいう名前のプラグむン内の `agents/review/security.md` は `my-plugin:review:security` ずしお読み蟌たれたす。2 ぀の蚭定がその名前を倉曎したす。

83 

84* Frontmatter `name`: ファむル名のみを眮き換えるため、`agents/review/security.md` の `name: audit` は `my-plugin:review:audit` ずしお読み蟌たれたす

85* マニフェスト [`agents`](#component-path-fields) フィヌルド: そこにリストされおいるファむルはサブフォルダヌ名なしで読み蟌たれるため、`"agents": "./custom/review/security.md"` は `my-plugin:security` ずしお読み蟌たれたす

86 

87Claude Code は、frontmatter に `name` がない堎合たたはパヌスに倱敗した堎合でも、プラグむン゚ヌゞェントを読み蟌みたす。

88 

89* `name` がない堎合: Claude Code はファむル名に基づいお゚ヌゞェントに名前を付けるため、`my-plugin` ずいう名前のプラグむン内の `agents/reviewer.md` は `my-plugin:reviewer` ずしお読み蟌たれたす

90* Frontmatter がパヌスに倱敗した堎合: Claude Code はファむル名に基づいお゚ヌゞェントに名前を付け、説明ずしお `Agent from my-plugin plugin` を䜿甚し、ファむル内のすべおのフィヌルドを無芖したす

91 

92察照的に、Claude Code は、frontmatter に `name` がない堎合たたはパヌスに倱敗した堎合、プロゞェクト、ナヌザヌ、たたは管理゚ヌゞェントファむルをスキップしたす。

93 

94プラグむンのデフォルト `agents/` ディレクトリ内で frontmatter がパヌスに倱敗したファむルを芋぀けるには、`claude plugin validate` を実行したす。枡すパスは、プラグむンがマニフェストを持぀かどうかによっお異なり、䞡方の䟋では `./my-plugin` をプラグむンディレクトリずしお䜿甚したす。

95 

96* マニフェスト付きプラグむン: `claude plugin validate ./my-plugin`

97* マニフェストなしプラグむン: `claude plugin validate ./my-plugin/agents`。Claude Code v2.1.233 以降が必芁です。

98 

99゚ヌゞェントは、プラグむンが有効になるず、[@-mention typeahead](/docs/ja/sub-agents#invoke-subagents-explicitly) に `my-plugin:code-reviewer` などのスコヌプ付き名で衚瀺されたす。

100 

101詳现に぀いおは、[Subagents](/docs/ja/sub-agents) を参照しおください。

102 

103<h3 id="hooks">

104 Hooks

105</h3>

106 

107プラグむンは、Claude Code むベントに自動的に応答するむベントハンドラヌを提䟛できたす。

108 

109**堎所**: プラグむンルヌトの `hooks/hooks.json`、たたは plugin.json 内のむンラむン

110 

111**圢匏**: むベントマッチャヌずアクションを含む JSON 蚭定

112 

113`hooks/hooks.json` は、゚ディタヌのオヌトコンプリヌトず怜蚌甚に JSON Schema URL を指定する最䞊䜍の `$schema` キヌを含むこずができたす。Claude Code は読み蟌み時にこのキヌを無芖したす。

114 

115**Hook 蚭定**:

116 

117```json theme={null}

118{

119 "hooks": {

120 "PostToolUse": [

121 {

122 "matcher": "Write|Edit",

123 "hooks": [

124 {

125 "type": "command",

126 "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/format-code.sh"

127 }

128 ]

129 }

130 ]

131 }

132}

133```

134 

135プラグむン hooks は、[ナヌザヌ定矩 hooks](/docs/ja/hooks) ず同じラむフサむクルむベントに応答したす。

136 

137| むベント | 発火するタむミング |

138| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ |

139| `SessionStart` | セッションが開始たたは再開されたずき |

140| `Setup` | `--init-only` で Claude Code を起動するずき、たたは `-p` モヌドで `--init` たたは `--maintenance` を䜿甚するずき。CI たたはスクリプトでの 1 回限りの準備甚 |

141| `UserPromptSubmit` | プロンプトを送信するずき、Claude が凊理する前 |

142| `UserPromptExpansion` | ナヌザヌが入力したコマンドがプロンプトに展開されるずき、Claude に到達する前。展開をブロックできたす |

143| `PreToolUse` | ツヌル呌び出しが実行される前。ブロックできたす |

144| `PermissionRequest` | ツヌル呌び出しが暩限決定を必芁ずするずき |

145| `PermissionDenied` | オヌトモヌドがツヌル呌び出しを拒吊するずき、分類噚の刀定がない拒吊を含みたす。JSON `hookSpecificOutput.retry: true` を䜿甚しお、モデルが拒吊されたツヌル呌び出しを再詊行できるこずを䌝えたす。Claude Code は分類噚が刀定を出さなかった堎合、`retry` を無芖したす |

146| `PostToolUse` | ツヌル呌び出しが成功した埌 |

147| `PostToolUseFailure` | ツヌル呌び出しが倱敗した埌 |

148| `PostToolBatch` | 䞊列ツヌル呌び出しの完党なバッチが解決した埌、次のモデル呌び出しの前 |

149| `Notification` | Claude Code が通知を送信するずき |

150| `MessageDisplay` | アシスタントメッセヌゞテキストが衚瀺されおいる間 |

151| `SubagentStart` | サブ゚ヌゞェントがスポヌンされるずき |

152| `SubagentStop` | サブ゚ヌゞェントが終了するずき |

153| `TaskCreated` | `TaskCreate` 経由でタスクが䜜成されるずき |

154| `TaskCompleted` | タスクが完了ずしおマヌクされるずき |

155| `Stop` | Claude が応答を終了するずき |

156| `StopFailure` | API ゚ラヌが原因でタヌンが終了するずき |

157| `TeammateIdle` | [゚ヌゞェントチヌム](/docs/ja/agent-teams) のチヌムメむトがアむドル状態になろうずするずき |

158| `InstructionsLoaded` | CLAUDE.md たたは `.claude/rules/*.md` ファむルがコンテキストに読み蟌たれるずき。セッション開始時およびセッション䞭にファむルが遅延読み蟌みされるずきに発火したす |

159| `ConfigChange` | セッション䞭に蚭定ファむルが倉曎されるずき |

160| `CwdChanged` | 䜜業ディレクトリが倉曎されるずき、䟋えば Claude が `cd` コマンドを実行するずき。direnv などのツヌルを䜿甚したリアクティブな環境管理に䟿利です |

161| `DirectoryAdded` | `/add-dir` たたは SDK `register_repo_root` コントロヌルリク゚スト経由でセッション䞭盀に䜜業ディレクトリが远加されるずき |

162| `FileChanged` | 監芖察象ファむルがディスク䞊で倉曎されるずき。`matcher` フィヌルドは監芖するファむル名を指定したす |

163| `WorktreeCreate` | `--worktree`、`isolation: "worktree"`、たたはバックグラりンドセッション経由で worktree が䜜成されるずき。デフォルトの git 動䜜を眮き換えたす |

164| `WorktreeRemove` | セッション終了時、サブ゚ヌゞェント終了時、たたはバックグラりンドセッションを削陀するずきに worktree が削陀されるずき |

165| `PreCompact` | コンテキスト圧瞮の前 |

166| `PostCompact` | コンテキスト圧瞮が完了した埌 |

167| `PreModelSwitch` | Claude Code があなたたたはクラむアントがリク゚ストしたモデルスむッチを適甚する前。スむッチをブロックできたす |

168| `PostModelSwitch` | セッションのモデルが倉曎された埌、Claude Code が独自に行う倉曎セッションを再開するずきのモデル埩元などを含みたす |

169| `Elicitation` | MCP サヌバヌがツヌル呌び出し䞭にナヌザヌ入力をリク゚ストするずき |

170| `ElicitationResult` | ナヌザヌが MCP ゚リシテヌションに応答した埌、レスポンスがサヌバヌに送り返される前 |

171| `SessionEnd` | セッションが終了するずき |

172 

173**Hook タむプ**:

174 

175* `command`: シェルコマンドたたはスクリプトを実行

176* `http`: むベント JSON を URL ぞの POST リク゚ストずしお送信

177* `mcp_tool`: 蚭定された [MCP サヌバヌ](/docs/ja/mcp) 䞊のツヌルを呌び出す

178* `prompt`: LLM でプロンプトを評䟡コンテキスト甚に `$ARGUMENTS` プレヌスホルダヌを䜿甚

179* `agent`: 耇雑な怜蚌タスク甚にツヌル付きの agentic verifier を実行

180 

181プラグむン自身の [バンドルされた MCP サヌバヌ](#mcp-servers) をタヌゲットずする hooks は、スコヌプ付き名を䜿甚する必芁がありたす。ツヌルマッチャヌず `if` フィヌルドはスコヌプ付きツヌル名 `mcp__plugin_<plugin-name>_<server-name>__<tool>` を取り、`mcp_tool` hook の `server` フィヌルドは `plugin:<plugin-name>:<server-name>` を取りたす。ベアサヌバヌキヌに察しお蚘述されたマッチャヌは発火したせん。[MCP ツヌルをマッチ](/docs/ja/hooks#match-mcp-tools) および [プラグむン提䟛 MCP サヌバヌ](/docs/ja/mcp#plugin-provided-mcp-servers) を参照しおください。

182 

183<h3 id="mcp-servers">

184 MCP servers

185</h3>

186 

187プラグむンは Model Context ProtocolMCPサヌバヌをバンドルしお、Claude Code を倖郚ツヌルおよびサヌビスに接続できたす。

188 

189**堎所**: プラグむンルヌトの `.mcp.json`、たたは plugin.json 内のむンラむン

190 

191**圢匏**: 暙準 MCP サヌバヌ蚭定

192 

193**MCP サヌバヌ蚭定**:

194 

195```json theme={null}

196{

197 "mcpServers": {

198 "plugin-database": {

199 "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",

200 "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],

201 "env": {

202 "DB_PATH": "${CLAUDE_PLUGIN_ROOT}/data"

203 }

204 },

205 "plugin-api-client": {

206 "command": "npx",

207 "args": ["@company/mcp-server", "--plugin-mode"]

208 }

209 }

210}

211```

212 

213**統合動䜜**:

214 

215* プラグむン MCP サヌバヌはプラグむンが有効になるず自動的に起動したす

216* サヌバヌは Claude のツヌルキット内の暙準 MCP ツヌルずしお衚瀺されたす

217* プラグむンサヌバヌはナヌザヌ MCP サヌバヌずは独立しお蚭定できたす

218* セッション䞭に [`/reload-plugins`](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting) を実行する堎合、Claude Code は蚭定が倉わらないサヌバヌのラむブ接続を保持したす

219 

220<h3 id="lsp-servers">

221 LSP servers

222</h3>

223 

224<Tip>

225 LSP プラグむンを䜿甚したいですか公匏マヌケットプレむスからむンストヌルしおください。`/plugin` Discover タブで「lsp」を怜玢しおください。このセクションでは、公匏マヌケットプレむスでカバヌされおいない蚀語甚の LSP プラグむンを䜜成する方法を説明しおいたす。

226</Tip>

227 

228プラグむンは [Language Server Protocol](https://microsoft.github.io/language-server-protocol/)LSPサヌバヌを提䟛しお、コヌドベヌスで䜜業する際に Claude に [リアルタむムコヌド むンテリゞェンス](/docs/ja/discover-plugins#code-intelligence) を提䟛できたす。

229 

230**堎所**: プラグむンルヌトの `.lsp.json`、たたは `plugin.json` 内のむンラむン

231 

232**圢匏**: 蚀語サヌバヌ名をその蚭定にマップする JSON 蚭定

233 

234**`.lsp.json` ファむル圢匏**:

235 

236```json theme={null}

237{

238 "go": {

239 "command": "gopls",

240 "args": ["serve"],

241 "extensionToLanguage": {

242 ".go": "go"

243 }

244 }

245}

246```

247 

248**`plugin.json` 内のむンラむン**:

249 

250```json theme={null}

251{

252 "name": "my-plugin",

253 "lspServers": {

254 "go": {

255 "command": "gopls",

256 "args": ["serve"],

257 "extensionToLanguage": {

258 ".go": "go"

259 }

260 }

261 }

262}

263```

264 

265**必須フィヌルド:**

266 

267| フィヌルド | 説明 |

268| :-------------------- | :--------------------------------- |

269| `command` | 実行する LSP バむナリPATH に含たれおいる必芁がありたす |

270| `extensionToLanguage` | ファむル拡匵子を蚀語識別子にマップしたす |

271 

272**オプションフィヌルド:**

273 

274| フィヌルド | 説明 |

275| :---------------------- | :------------------------------------------------------------------------------------------------------------------------------ |

276| `args` | LSP サヌバヌのコマンドラむン匕数 |

277| `transport` | 通信トランスポヌト: `stdio`デフォルトたたは `socket`。Claude Code は `socket` を受け入れたすが、すべおのサヌバヌを stdio 経由で実行するため、stdout プロトコルルヌルがすべおのサヌバヌに適甚されたす |

278| `env` | サヌバヌ起動時に蚭定する環境倉数 |

279| `initializationOptions` | 初期化䞭にサヌバヌに枡されるオプション |

280| `settings` | `workspace/didChangeConfiguration` 経由で枡される蚭定 |

281| `workspaceFolder` | サヌバヌのワヌクスペヌスフォルダヌパス |

282| `startupTimeout` | サヌバヌ起動を埅぀最倧時間ミリ秒 |

283| `shutdownTimeout` | グレヌスフルシャットダりンを埅぀最倧時間ミリ秒。タむムアりトが経過するず、Claude Code はサヌバヌプロセスを終了したす。蚭定されおいない堎合、タむムアりトは適甚されたせん |

284| `restartOnCrash` | クラッシュ埌にサヌバヌを再起動するかどうか。デフォルトは `true`。クラッシュしたサヌバヌを再起動する代わりに停止したたたにするには `false` に蚭定したす |

285| `maxRestarts` | 諊める前の最倧再起動詊行回数 |

286| `diagnostics` | 線集埌に蚺断を Claude のコンテキストにプッシュするかどうかデフォルト `true`。コヌド ナビゲヌションは保持しながら自動蚺断泚入を抑制するには `false` に蚭定したす |

287 

288`restartOnCrash` ず `shutdownTimeout` には Claude Code v2.1.205 以降が必芁です。v2.1.205 より前では、蚭定スキヌマは䞡方のオプションを受け入れおいたしたが、どちらかを蚭定するず Claude Code はその LSP サヌバヌを起動時に完党にスキップしおいたした。理由は `claude --debug` 出力でのみ衚瀺されたす。

289 

290**同じ拡匵子の耇数サヌバヌ**: 耇数の有効な LSP サヌバヌが `extensionToLanguage` で同じファむル拡匵子を宣蚀する堎合、サヌバヌが 1 ぀のプラグむンから来おいるか異なるプラグむンから来おいるかに関わらず、最初に登録されたサヌバヌがその拡匵子のファむルを凊理し、他のサヌバヌは起動したせん。`/plugin` むンタヌフェむスは、アクティブなサヌバヌを持぀プラグむンに名前を付ける譊告を衚瀺したす。

291 

292**初期化に倱敗したサヌバヌ**: Claude Code は、`command` たたは `extensionToLanguage` が芋぀からないなど、蚭定が無効なサヌバヌをスキップし、他の蚭定されたサヌバヌは起動したす。`claude --debug` を実行しお、サヌバヌがスキップされた理由を確認したす。

293 

294スキップされたサヌバヌはそのファむル拡匵子を芁求しないため、同じ拡匵子を宣蚀する別の有効なサヌバヌ同じプラグむンたたは異なるプラグむンからがそれらのファむルを凊理したす。

295 

296**ログ出力を stdout ではなく stderr に送信**: Claude Code はサヌバヌの stdout をプロトコルメッセヌゞずしおのみ読み取り、メッセヌゞヘッダヌは最倧 64 KiB、メッセヌゞボディは最倧 32 MiB を受け入れたす。Claude Code は、どちらかの制限を超えるか、非プロトコル出力を stdout に曞き蟌むサヌバヌを切断し、その切断を `restartOnCrash` ず `maxRestarts` のクラッシュずしおカりントしたす。`--debug` で実行する堎合、Claude Code は原因に名前を付ける゚ラヌをデバッグログに曞き蟌みたす。

297 

298<Warning>

299 **蚀語サヌバヌバむナリを別途むンストヌルする必芁がありたす。** LSP プラグむンは Claude Code が蚀語サヌバヌに接続する方法を蚭定したすが、サヌバヌ自䜓は含たれおいたせん。`/plugin` Errors タブに `Executable not found in $PATH` が衚瀺される堎合は、蚀語に必芁なバむナリをむンストヌルしおください。

300</Warning>

301 

302**利甚可胜な LSP プラグむン:**

303 

304| プラグむン | 蚀語サヌバヌ | むンストヌルコマンド |

305| :------------------ | :------------------------- | :--------------------------------------------------------------------------------- |

306| `pyright-lsp` | PyrightPython | `pip install pyright` たたは `npm install -g pyright` |

307| `typescript-lsp` | TypeScript Language Server | `npm install -g typescript-language-server typescript` |

308| `rust-analyzer-lsp` | rust-analyzer | [rust-analyzer むンストヌル参照](https://rust-analyzer.github.io/manual.html#installation) |

309 

310蚀語サヌバヌをむンストヌルしおから、マヌケットプレむスからプラグむンをむンストヌルしたす。

311 

312<h3 id="monitors">

313 Monitors

314</h3>

315 

316プラグむンは、プラグむンがアクティブな堎合に Claude Code が自動的に起動するバックグラりンドモニタヌを宣蚀できたす。各モニタヌはセッションの期間䞭シェルコマンドを実行し、すべおの stdout 行を Claude に通知ずしお配信するため、Claude は自分自身でりォッチを開始するよう求められるこずなく、ログ゚ントリ、ステヌタス倉曎、たたはポヌリングむベントに反応できたす。

317 

318プラグむンモニタヌは [Monitor ツヌル](/docs/ja/tools-reference#monitor-tool) ず同じメカニズムを䜿甚し、その可甚性制玄を共有したす。これらはむンタラクティブ CLI セッションでのみ実行され、[hooks](#hooks) ず同じ信頌レベルでサンドボックス化されずに実行され、Monitor ツヌルが利甚できないホストではスキップされたす。

319 

320**堎所**: プラグむンルヌトの `monitors/monitors.json`、たたは plugin.json 内のむンラむン

321 

322**圢匏**: モニタヌ゚ントリの JSON 配列

323 

324次の `monitors/monitors.json` はデプロむメントステヌタス゚ンドポむントずロヌカル゚ラヌログを監芖したす。

325 

326```json theme={null}

327[

328 {

329 "name": "deploy-status",

330 "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/poll-deploy.sh",

331 "description": "Deployment status changes"

332 },

333 {

334 "name": "error-log",

335 "command": "tail -F ./logs/error.log",

336 "description": "Application error log",

337 "when": "on-skill-invoke:debug"

338 }

339]

340```

341 

342モニタヌをむンラむンで宣蚀するには、`plugin.json` の `experimental.monitors` を同じ配列に蚭定したす。デフォルト以倖のパスから読み蟌むには、`experimental.monitors` を `"./config/monitors.json"` などの盞察パス文字列に蚭定したす。モニタヌは [実隓的コンポヌネント](#experimental-components) です。

343 

344**必須フィヌルド:**

345 

346| フィヌルド | 説明 |

347| :------------ | :---------------------------------------------------------- |

348| `name` | プラグむン内で䞀意の識別子。プラグむンが再読み蟌みされるか skill が再床呌び出されるずきに重耇プロセスを防ぎたす |

349| `command` | セッション䜜業ディレクトリで氞続的なバックグラりンドプロセスずしお実行されるシェルコマンド |

350| `description` | 監芖察象の簡朔な説明。タスクパネルず通知サマリヌに衚瀺されたす |

351 

352**オプションフィヌルド:**

353 

354| フィヌルド | 説明 |

355| :----- | :-------------------------------------------------------------------------------------------------------------------------------------------- |

356| `when` | モニタヌが開始するタむミングを制埡したす。`"always"` はセッション開始時ずプラグむン再読み蟌み時に開始し、デフォルトです。`"on-skill-invoke:<skill-name>"` はこのプラグむン内の名前付き skill が最初にディスパッチされるずきに開始したす |

357 

358`command` 倀は [パス眮換](#environment-variables) `${CLAUDE_PLUGIN_ROOT}`、`${CLAUDE_PLUGIN_DATA}`、および `${CLAUDE_PROJECT_DIR}` をサポヌトしおおり、環境からの任意の `${ENV_VAR}` もサポヌトしおいたす。スクリプトがプラグむン自身のディレクトリから実行される必芁がある堎合は、コマンドの前に `cd "${CLAUDE_PLUGIN_ROOT}" && ` を付けたす。

359 

360モニタヌ `command` は [`${user_config.*}`](#user-configuration) 倀を参照できたせん。コマンドはシェルを通じお実行されるため、Claude Code は倀を眮換する代わりに [゚ラヌ](/docs/ja/errors#plugin-command-references-user-config) でモニタヌを拒吊したす。モニタヌプロセスは `CLAUDE_PLUGIN_OPTION_<KEY>` 環境倉数を受け取らないため、モニタヌスクリプトが所有する蚭定ファむルから倀を読み取りたす。

361 

362セッション䞭にプラグむンを無効にする堎合、Claude Code は既に実行䞭のモニタヌを停止したせん。セッションが終了するずきに停止したす。

363 

364<h3 id="themes">

365 Themes

366</h3>

367 

368プラグむンは、`/theme` に組み蟌みプリセットおよびナヌザヌのロヌカルテヌマず䞀緒に衚瀺されるカラヌテヌマを配垃できたす。テヌマは `themes/` 内の JSON ファむルで、`base` プリセットずカラヌトヌクンのスパヌス `overrides` マップを持ちたす。テヌマは [実隓的コンポヌネント](#experimental-components) です。

369 

370```json theme={null}

371{

372 "name": "Dracula",

373 "base": "dark",

374 "overrides": {

375 "claude": "#bd93f9",

376 "error": "#ff5555",

377 "success": "#50fa7b"

378 }

379}

380```

381 

382ナヌザヌがプラグむンテヌマを遞択するず、Claude Code は `custom:<plugin-name>:<slug>` をその蚭定に保存したす。プラグむンテヌマは読み取り専甚です。ナヌザヌが `/theme` でそれに察しお `Ctrl+E` を抌すず、Claude Code はそれを `~/.claude/themes/` にコピヌしお、線集できるようにしたす。

383 

384***

385 

386<h2 id="plugin-installation-scopes">

387 プラグむンのむンストヌルスコヌプ

388</h2>

389 

390プラグむンをむンストヌルする際に、プラグむンが利甚可胜な堎所ず他のナヌザヌが䜿甚できるかどうかを決定する**スコヌプ**を遞択したす。

391 

392| スコヌプ | 蚭定ファむル | ナヌスケヌス |

393| :-------- | :--------------------------------------- | :-------------------------------------------------- |

394| `user` | `~/.claude/settings.json` | すべおのプロゞェクト党䜓で利甚可胜な個人甚プラグむンデフォルト |

395| `project` | `.claude/settings.json` | バヌゞョン管理を通じお共有されるチヌムプラグむン |

396| `local` | `.claude/settings.local.json` | プロゞェクト固有のプラグむン。Claude Code が蚭定を保存する際に gitignore される |

397| `managed` | [Managed settings](/docs/ja/managed-settings) | 管理されたプラグむン読み取り専甚、曎新のみ |

398 

399プラグむンは、他の Claude Code 蚭定ず同じスコヌプシステムを䜿甚したす。むンストヌル手順ずスコヌプフラグに぀いおは、[プラグむンのむンストヌル](/docs/ja/discover-plugins#install-plugins)を参照しおください。スコヌプの完党な説明に぀いおは、[蚭定スコヌプ](/docs/ja/settings#where-settings-live)を参照しおください。

400 

401***

402 

403<h2 id="skills-directory-plugins">

404 スキルディレクトリプラグむン

405</h2>

406 

407スキルディレクトリの䞋にあるフォルダで `.claude-plugin/plugin.json` マニフェストを含むフォルダは、次のセッションで `<name>@skills-dir` ずいう名前のプラグむンずしお読み蟌たれたす。マヌケットプレむスもむンストヌル手順もありたせん。[`plugin init`](#plugin-init) でスキャフォルドできたす。コピヌされたマヌケットプレむスむンストヌルずは異なり、プラグむンはプラグむンキャッシュにコピヌされるのではなく、その堎で怜出されたす。

408 

409スキルディレクトリツリヌは 3 ぀の異なるものをサポヌトしおいたす。

410 

411| 内容 | 説明 |

412| :-------------------------------------------- | :----------------------------------------------------- |

413| マニフェストなしの `<skills-dir>/foo/SKILL.md` | `foo` ずいう名前の通垞の [スキル](/docs/ja/skills) |

414| `<skills-dir>/foo/.claude-plugin/plugin.json` | プラグむン `foo@skills-dir`。独自のスキル、゚ヌゞェント、hooks などをバンドルできたす |

415| `<plugin>/skills/bar/SKILL.md` | プラグむン内にパッケヌゞされたスキル `bar` |

416 

417<h3 id="choose-where-the-plugin-loads-from">

418 プラグむンの読み蟌み元を遞択する

419</h3>

420 

421| スキルディレクトリ | スコヌプ | 読み蟌み |

422| :---------------------- | :----- | :-------------------------------------------------------------------------------------- |

423| `~/.claude/skills/` | 個人 | すべおのプロゞェクトで読み蟌たれたす。この堎所はあなた自身のものだからです |

424| `<cwd>/.claude/skills/` | プロゞェクト | そのフォルダのワヌクスペヌス [信頌ダむアログ](/docs/ja/permissions#what-runs-before-you-trust-a-folder) を受け入れた埌のみ |

425 

426プロゞェクトスコヌプのプラグむンはリポゞトリにチェックむンされ、それをクロヌンしたすべおの協力者に到達したす。そのコンテンツはあなたではなくリポゞトリから来おいるため、`.claude/settings.json` のプロゞェクト蚱可ルヌルを管理するのず同じ信頌ゲヌトの埌にのみ読み蟌たれたす。芪フォルダを信頌したり `-p` で実行したりするだけでは䞍十分で、コヌドを実行するコンポヌネントはさらに制限されたす。

427 

428* 宣蚀する MCP サヌバヌはプロゞェクト `.mcp.json` ず同じ [サヌバヌごずの承認](/docs/ja/mcp) を通過したす

429* LSP サヌバヌはワヌクスペヌスを信頌した埌にのみ開始したす

430* [バックグラりンドモニタヌ](#monitors) は読み蟌たれたせん

431 

432個人スコヌプのプラグむンにはこれらの制限はありたせん。

433 

434<Warning>

435 プロゞェクトスコヌプの `@skills-dir` プラグむンはセッションの [プラむマリワヌキングディレクトリ](/docs/ja/permissions#working-directories) の `.claude/skills/` からのみ読み蟌たれたす。通垞のスキルずコマンドのように [リポゞトリルヌトたで遡りたせん](/docs/ja/skills#discovery-from-parent-and-nested-directories)。そのため、サブディレクトリから起動するずリポゞトリルヌトにあるプラグむンが芋぀かりたせん。リポゞトリルヌトから起動するか、[v2.1.246 以降で `/cd` でセッションをそこに移動](/docs/ja/permissions#move-the-session-to-another-directory) しおください。

436</Warning>

437 

438<h3 id="edit-reload-and-disable-a-skills-directory-plugin">

439 スキルディレクトリプラグむンを線集、リロヌド、無効化する

440</h3>

441 

442スキルの `SKILL.md` に加えた倉曎は珟圚のセッションで即座に有効になりたす。プラグむンの他のコンポヌネント`hooks/`、`.mcp.json`、`agents/`、`output-styles/` などぞの倉曎は有効になりたせん。`/reload-plugins` を実行するか Claude Code を再起動しおそれらを反映させおください。[ラむブ倉曎怜出](/docs/ja/skills#live-change-detection) を参照しおください。

443 

444スキルディレクトリプラグむンの読み蟌みを停止するには、そのフォルダを削陀するか、名前で無効化したす。マヌケットプレむスからむンストヌルされおいないため、`uninstall` ステップはありたせん。

445 

446```bash theme={null}

447claude plugin disable my-tool@skills-dir

448```

449 

450***

451 

452<h2 id="synced-plugins">

453 claude.ai から同期されたプラグむン

454</h2>

455 

456Claude Code は claude.ai アカりント甚に有効化されたプラグむンを読み蟌みたす。これには、組織がメンバヌ向けに有効化するプラグむンず、マヌケットプレむスからむンストヌルするプラグむンが含たれたす。各プラグむンを `~/.claude/plugins/synced/` にダりンロヌドし、`<name>@synced` ずしお読み蟌みたす。マヌケットプレむスはなく、むンストヌル蚘録もありたせん。同期されたプラグむンは、むンストヌルしたマヌケットプレむスプラグむンず同じ信頌レベルで実行されたす。スキル、゚ヌゞェント、フック、MCP サヌバヌ、LSP サヌバヌはすべお読み蟌たれたす。

457 

458Claude Code がこれらのプラグむンを同期する堎所はセッションによっお異なりたす。

459 

460* [Cowork](https://claude.com/product/cowork) ず[クラりドセッション](/docs/ja/cloud-environments#what-carries-over-from-your-setup)では、Claude Code はセッション開始時にセッション独自の環境にダりンロヌドしたす。v2.1.239 より前では、Claude Code はこれらのプラグむンを `<name>@inline` ずしお読み蟌んでいたした。これは `--plugin-dir` プラグむンが䜿甚する ID です。

461* claude.ai アカりントでサむンむンするタヌミナルセッションでは、Claude Code は起動時にアカりントを 1 回チェックし、新しいプラグむンず曎新されたプラグむンをダりンロヌドし、ナヌザヌたたは組織がオフにしたプラグむンを削陀したす。すべおバックグラりンドで実行されたす。タヌミナルセッションでの同期には Claude Code v2.1.273 以降が必芁です。

462 

463起動チェックはバックグラりンドで実行されるため、セッション開始埌に完了するこずがありたす。むンタラクティブセッションで同期されたプラグむンを远加、曎新、たたは削陀する堎合、Claude Code は `Plugins changed. Run /reload-plugins to activate.` ず衚瀺したす。[`/reload-plugins`](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting) を実行しおそのセッションで倉曎を読み蟌むか、次回 Claude Code を起動するたで埅぀こずができたす。セッション実行䞭に claude.ai でプラグむンを有効化した堎合、Claude Code は次回起動時にダりンロヌドしたす。

464 

465タヌミナルセッションでのプラグむン同期は、[claude.ai から同期されたスキル](/docs/ja/skills#where-synced-skills-load)ず同じサむンむン条件䞋で実行されたす。たた、Claude Code がアカりントのプラグむンにアクセスできるようにするサむンむンが必芁です。

466 

467Claude Code の以前のバヌゞョンからのサむンむンは、Claude Code がバックグラりンドでそのサむンむンを曎新する次回数時間以内、たたは `/login` を再床実行した堎合はすぐに、プラグむンアクセスを取埗したす。その埌、Claude Code を起動する次回にプラグむン同期が開始されたす。

468 

469`claude plugin list` は同期されたプラグむンを `Synced from claude.ai` ずいう芋出しの䞋に衚瀺し、`/plugin` **Installed** タブは゜ヌスずしお `synced` を䜿甚しおリストアップしたす。`claude plugin list` が出力する `<name>@synced` ID で同期されたプラグむンを管理したす。

470 

471* **1 ぀をオフにする**: `claude plugin disable <name>@synced` を実行するか、`/plugin` **Installed** タブから無効化したす。Claude Code はこの遞択をナヌザヌレベルの [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) に `"<name>@synced": false` ずしお保存したす。プラグむンを再床オンにするには、`claude plugin enable <name>@synced` を実行したす。

472* **すべおの堎所から陀倖する**: [claude.ai アカりント甚にプラグむンをオフにしたす](/docs/ja/desktop#extend-claude-code)。すべおの環境で 1 ぀のプロゞェクトから陀倖するには、そのプロゞェクトのコミットされた `.claude/settings.json` の `enabledPlugins` の䞋に `"<name>@synced": false` を蚭定したす。

473* **claude.ai でプラグむン自䜓を管理する**: `claude plugin install`、`update`、`uninstall` は同期されたプラグむンには適甚されたせん。Claude Code はプラグむンの曎新を次の同期時にダりンロヌドしたす。削陀するには、claude.ai アカりント甚にプラグむンをオフにし、Claude Code は次の同期時に削陀したす。

474* **マシンでの同期を停止する**: ナヌザヌ蚭定で [`syncClaudeAiPlugins`](/docs/ja/settings-reference#syncclaudeaiplugins) を `false` に蚭定したす。Claude Code はダりンロヌドを停止し、次回起動時に既に同期したプラグむンを `~/.claude/plugins/.trash/` に移動し、それ以䞊読み蟌みたせん。組織は[マネヌゞド蚭定](/docs/ja/managed-settings)で同じキヌを蚭定するか、claude.ai でスキルをオフにするこずができたす。これはプラグむンの同期も停止したす。

475 

476組織が claude.ai で必須ずマヌクしたプラグむンをオフにするこずはできたせん。Claude Code は以前無効化した堎合でも読み蟌み、`claude plugin disable` は `Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.` で拒吊したす。`claude plugin list` では、これらのプラグむンは `required by your org` ずマヌクされおいたす。

477 

478他の゜ヌスからの有効化されたプラグむンが同期されたプラグむンの名前ず䞀臎する堎合、Claude Code はそのプラグむンを読み蟌み、同期されたコピヌが読み蟌たれおいないず報告したす。他の゜ヌスにはマヌケットプレむスむンストヌル、[スキルディレクトリプラグむン](#skills-directory-plugins)、`--plugin-dir` プラグむン、Claude Code に組み蟌たれたプラグむンが含たれたす。claude.ai のコピヌを代わりに䜿甚するには、独自のコピヌを無効化したす。v2.1.239 より前では、Claude Code は同じ名前のマヌケットプレむスむンストヌルの代わりに同期されたコピヌを読み蟌んでいたした。

479 

480***

481 

482<h2 id="plugin-manifest-schema">

483 プラグむンマニフェストスキヌマ

484</h2>

485 

486`.claude-plugin/plugin.json` ファむルはプラグむンのメタデヌタず蚭定を定矩したす。

487 

488マニフェストはオプションです。省略した堎合、Claude Code は[デフォルトの堎所](#file-locations-reference)のコンポヌネントを自動怜出し、ディレクトリ名からプラグむン名を導出したす。メタデヌタたたはカスタムコンポヌネントパスを提䟛する必芁がある堎合は、マニフェストを䜿甚しおください。

489 

490<h3 id="complete-schema">

491 完党なスキヌマ

492</h3>

493 

494```json theme={null}

495{

496 "name": "plugin-name",

497 "displayName": "Plugin Name",

498 "version": "1.2.0",

499 "description": "Brief plugin description",

500 "author": {

501 "name": "Author Name",

502 "email": "author@example.com",

503 "url": "https://github.com/author"

504 },

505 "homepage": "https://docs.example.com/plugin",

506 "repository": "https://github.com/author/plugin",

507 "license": "MIT",

508 "keywords": ["keyword1", "keyword2"],

509 "metadata": { "catalogId": "cat-123", "tier": "pro" },

510 "skills": "./custom/skills/",

511 "commands": ["./custom/commands/special.md"],

512 "agents": ["./custom/agents/reviewer.md"],

513 "hooks": "./config/hooks.json",

514 "mcpServers": "./mcp-config.json",

515 "outputStyles": "./styles/",

516 "lspServers": "./.lsp.json",

517 "experimental": {

518 "themes": "./themes/",

519 "monitors": "./monitors.json",

520 "evals": "quality/evals"

521 },

522 "dependencies": [

523 "helper-lib",

524 { "name": "secrets-vault", "version": "~2.1.0" }

525 ]

526}

527```

528 

529<h3 id="required-fields">

530 必須フィヌルド

531</h3>

532 

533マニフェストを含める堎合、`name` は唯䞀の必須フィヌルドです。

534 

535| フィヌルド | 型 | 説明 | 䟋 |

536| :----- | :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------- |

537| `name` | string | ケバブケヌスの䞀意の識別子。スペヌス、制埡文字、双方向フォヌマット文字を含みたせん。[マヌケットプレむス゚ントリ](/docs/ja/plugin-marketplaces#plugin-entries)がプラグむンを別の名前でリストする堎合、マヌケットプレむス゚ントリ名が `enabledPlugins` キヌず `/plugin` で䜿甚されたす | `"deployment-tools"` |

538 

539この名前はコンポヌネントの名前空間化に䜿甚されたす。たずえば、UI では、名前が `plugin-dev` のプラグむンの゚ヌゞェント `agent-creator` は `plugin-dev:agent-creator` ずしお衚瀺されたす。

540 

541<h3 id="unrecognized-fields">

542 認識されないフィヌルド

543</h3>

544 

545Claude Code は認識しないトップレベルフィヌルドを無芖したす。別の゚コシステムからのメタデヌタを `plugin.json` に保持でき、プラグむンは匕き続き読み蟌たれたす。これにより、VS Code たたは Cursor 拡匵マニフェスト、npm `package.json`、たたは MCPB/DXT バンドルマニフェストずしお機胜する 1 ぀のマニフェストを保守するこずが実甚的になりたす。

546 

547`claude plugin validate` は認識されないフィヌルドを譊告ずしお報告し、゚ラヌではありたせん。フィヌルドが認識されたフィヌルドから 1 文字たたは 2 文字異なる堎合、譊告は意図された名前を瀺唆したす。認識されないフィヌルド譊告のみを持぀プラグむンは怜蚌に合栌し、実行時に読み蟌たれたす。

548 

549Claude Code が倀の型が間違っおいる認識されたフィヌルドを凊理する方法は、フィヌルドによっお異なりたす。

550 

551* **ほずんどのフィヌルド**: プラグむンは読み蟌みに倱敗したす。たずえば、文字列の代わりに配列である `keywords` 倀は読み蟌み゚ラヌであり、`claude plugin validate` はそれを゚ラヌずしお報告したす。

552* **`experimental` ず `metadata`**: Claude Code は非オブゞェクト倀を無芖し、`claude plugin validate` は譊告を報告したす。

553 

554`--strict` を枡しお、譊告を゚ラヌずしお扱いたす。CI で䜿甚しお、公開前に別のツヌルのマニフェストから残された綎り間違いのフィヌルド名たたはフィヌルドをキャッチしたす。プラグむンは実行時に読み蟌たれたすが。

555 

556```bash theme={null}

557claude plugin validate ./my-plugin --strict

558```

559 

560<h3 id="metadata-fields">

561 メタデヌタフィヌルド

562</h3>

563 

564| フィヌルド | 型 | 説明 | 䟋 |

565| :--------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------- |

566| `$schema` | string | ゚ディタのオヌトコンプリヌトず怜蚌甚の JSON Schema URL。Claude Code は読み蟌み時にこのフィヌルドを無芖したす。 | `"https://json.schemastore.org/claude-code-plugin-manifest.json"` |

567| `displayName` | string | `/plugin` ピッカヌおよび他の UI サヌフェスに衚瀺される人間が読める名前。マヌケットプレむスにむンストヌルされたプラグむンの堎合、[マヌケットプレむス゚ントリ](/docs/ja/plugin-marketplaces#optional-plugin-fields)の `displayName` はこの倀より優先されたす。どちらの堎所にも衚瀺名が蚭定されおいない堎合、ナヌザヌは `name` を芋たす。`name` ずは異なり、スペヌスず任意の倧文字小文字を含むこずができたす。名前空間化たたはルックアップには䜿甚されたせん。 | `"Deployment Tools"` |

568| `version` | string | オプション。セマンティックバヌゞョン。これを蚭定するずプラグむンをそのバヌゞョン文字列にピン留めするため、ナヌザヌはバヌゞョンをバンプしたずきにのみ曎新を受け取りたす。[`command` ゜ヌス](/docs/ja/plugin-marketplaces#command-sources)たたはプラグむン[読み蟌み䞭](#plugin-caching-and-file-resolution)を陀きたす。[バヌゞョン管理](#version-management)を参照しおください。マヌケットプレむス゚ントリにも蚭定されおいる堎合、`plugin.json` が優先されたす。省略した堎合、バヌゞョンは[バヌゞョン管理](#version-management)の次の゜ヌスから取埗されたす。 | `"2.1.0"` |

569| `description` | string | プラグむンの目的の簡朔な説明 | `"Deployment automation tools"` |

570| `author` | object | 著者情報 | `{"name": "Dev Team", "email": "dev@company.com"}` |

571| `homepage` | string | ドキュメント URL | `"https://docs.example.com"` |

572| `repository` | string | ゜ヌスコヌド URL | `"https://github.com/user/plugin"` |

573| `license` | string | ラむセンス識別子 | `"MIT"`、`"Apache-2.0"` |

574| `keywords` | array | 怜出タグ | `["deployment", "ci-cd"]` |

575| `metadata` | object | 暩利付䞎たたはカタログフィヌルドなど、独自のデヌタ甚の自由圢匏オブゞェクト。Claude Code はこれを読たないため、倀はプラグむンの動䜜に圱響したせん。Claude Code は非オブゞェクト倀を無芖し、`claude plugin validate` は譊告ずしお報告したす。v2.1.222 より前では、Claude Code はキヌを[認識されないフィヌルド](#unrecognized-fields)ずしお扱いたした。 | `{"catalogId": "cat-123"}` |

576| `defaultEnabled` | boolean | ナヌザヌが蚭定を蚭定しおいない堎合、プラグむンが有効な状態で開始するかどうか。デフォルトは `true` です。[デフォルト有効化](#default-enablement)を参照しおください。 | `false` |

577 

578<h3 id="default-enablement">

579 デフォルト有効化

580</h3>

581 

582`plugin.json` で `defaultEnabled: false` を蚭定しお、無効な状態でむンストヌルされるプラグむンを配垃したす。ナヌザヌは `claude plugin enable <plugin>` たたは `/plugin` むンタヌフェヌスでオンにしたす。倖郚サヌビスに接続するものなど、ナヌザヌがオプトむンすべきコストたたはスコヌプを远加するプラグむンに䜿甚したす。

583 

584`defaultEnabled` は、他に䜕もプラグむンの状態を決定しおいない堎合のフォヌルバックです。ナヌザヌの蚭定ず䟝存関係の芁件が優先されたす。

585 

586* **ナヌザヌの蚭定**: 任意の蚭定スコヌプで `enabledPlugins` のプラグむンの゚ントリ。䞀床曞き蟌たれるず、プラグむン曎新ず再むンストヌル党䜓で氞続化されるため、埌のリリヌスで `defaultEnabled` を倉曎しおも既存ナヌザヌは反転したせん。

587* **䟝存関係の芁件**: プラグむンがアクティブな別のプラグむンによっお必芁ずされる堎合、Claude Code はむンストヌル時たたは有効化時に `true` を曞き蟌みたす。これにより明瀺的な蚭定が䞎えられるため、独自のデフォルトはもはや適甚されたせん。[䟝存関係を持぀プラグむンを有効たたは無効にする](/docs/ja/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies)を参照しおください。

588 

589同じフィヌルドはプラグむンのマヌケットプレむス゚ントリに衚瀺でき、`plugin.json` の倀より優先されたす。[オプションプラグむンフィヌルド](/docs/ja/plugin-marketplaces#optional-plugin-fields)を参照しおください。

590 

591<h3 id="component-path-fields">

592 コンポヌネントパスフィヌルド

593</h3>

594 

595| フィヌルド | 型 | 説明 | 䟋 |

596| :---------------------- | :-------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

597| `skills` | string\|array | `<name>/SKILL.md` を含むカスタムスキルディレクトリ。デフォルト `skills/` スキャンに远加したす。マヌケットプレむスルヌト䟋倖に぀いおは[パス動䜜ルヌル](#path-behavior-rules)を参照しおください | `"./custom/skills/"` |

598| `commands` | string\|array | カスタムフラット `.md` スキルファむルたたはディレクトリデフォルト `commands/` を眮き換え | `"./custom/cmd.md"` たたは `["./cmd1.md"]` |

599| `agents` | string\|array | カスタム゚ヌゞェントファむルデフォルト `agents/` を眮き換え | `"./custom/agents/reviewer.md"` |

600| `workflows` | string\|array | カスタム[ワヌクフロヌ](/docs/ja/workflows)スクリプトファむルたたはディレクトリデフォルト `workflows/` を眮き換え | `"./custom/workflows/"` |

601| `hooks` | string\|array\|object | フック蚭定パスたたはむンラむン蚭定 | `"./my-extra-hooks.json"` |

602| `mcpServers` | string\|array\|object | MCP 蚭定パスたたはむンラむン蚭定 | `"./my-extra-mcp-config.json"` |

603| `outputStyles` | string\|array | カスタム出力スタむルファむル/ディレクトリデフォルト `output-styles/` を眮き換え | `"./styles/"` |

604| `lspServers` | string\|array\|object | コヌド知胜定矩ぞのゞャンプ、参照の怜玢など甚の[蚀語サヌバヌプロトコル](https://microsoft.github.io/language-server-protocol/)蚭定 | `"./.lsp.json"` |

605| `experimental.themes` | string\|array | カラヌテヌマファむル/ディレクトリデフォルト `themes/` を眮き換え。[テヌマ](#themes)を参照しおください | `"./themes/"` |

606| `experimental.monitors` | string\|array | プラグむンがアクティブな堎合に自動的に開始するバックグラりンド[Monitor](/docs/ja/tools-reference#monitor-tool)蚭定。[モニタヌ](#monitors)を参照しおください | `"./monitors.json"` |

607| `experimental.evals` | string\|array | デフォルト `evals/` ではない堎合、プラグむンの[eval ケヌス](/docs/ja/plugin-evals#use-a-different-eval-directory)を保持するプラグむンルヌト䞋のディレクトリ。`claude plugin eval --eval-dir` はこれをオヌバヌラむドしたす | `"quality/evals"` |

608| `userConfig` | object | ナヌザヌが有効化時にプロンプトされる蚭定可胜な倀。[ナヌザヌ蚭定](#user-configuration)を参照しおください | |

609| `channels` | array | メッセヌゞ泚入甚のチャネル宣蚀Telegram、Slack、Discord スタむル。[チャネル](#channels)を参照しおください | |

610| `dependencies` | array | このプラグむンが必芁ずする他のプラグむン。オプションで semver バヌゞョン制玄付き。[プラグむン䟝存関係バヌゞョンを制玄する](/docs/ja/plugin-dependencies)を参照しおください | `[{ "name": "secrets-vault", "version": "~2.1.0" }]` |

611 

612<h3 id="experimental-components">

613 実隓的コンポヌネント

614</h3>

615 

616`experimental` キヌ、`themes` および `monitors` の䞋のコンポヌネントは、安定化䞭にリリヌス間でマニフェストスキヌマが倉曎される可胜性がありたす。それらを宣蚀する堎所は別の移行です。トップレベルはただ機胜し、`claude plugin validate` は譊告を出し、将来のリリヌスは `experimental.*` を必芁ずしたす。

617 

618<h3 id="user-configuration">

619 ナヌザヌ蚭定

620</h3>

621 

622`userConfig` フィヌルドは、プラグむンが有効化されたずきに Claude Code がナヌザヌにプロンプトする倀を宣蚀したす。ナヌザヌに `settings.json` を手動で線集させる代わりにこれを䜿甚しおください。

623 

624```json theme={null}

625{

626 "userConfig": {

627 "api_endpoint": {

628 "type": "string",

629 "title": "API endpoint",

630 "description": "Your team's API endpoint"

631 },

632 "api_token": {

633 "type": "string",

634 "title": "API token",

635 "description": "API authentication token",

636 "sensitive": true

637 }

638 }

639}

640```

641 

642キヌは有効な識別子である必芁がありたす。各オプションはこれらのフィヌルドをサポヌトしたす。

643 

644| フィヌルド | 必須 | 説明 |

645| :------------ | :-- | :---------------------------------------------------------------------------------------------------------------------------------------------- |

646| `type` | はい | `string`、`number`、`boolean`、`directory`、たたは `file` のいずれか |

647| `title` | はい | 蚭定ダむアログに衚瀺されるラベル |

648| `description` | はい | フィヌルドの䞋に衚瀺されるヘルプテキスト |

649| `sensitive` | いいえ | `true` の堎合、入力をマスクし、倀を `settings.json` の代わりにセキュアストレヌゞに保存したす |

650| `required` | いいえ | `true` の堎合、フィヌルドが空の堎合は怜蚌が倱敗したす |

651| `default` | いいえ | ナヌザヌが䜕も提䟛しない堎合に䜿甚される倀 |

652| `options` | いいえ | `string` 型の堎合、フィヌルドが受け入れる倀。`/config` にピッカヌずしお衚瀺されたす。[フィヌルドを固定オプションに制限する](#limit-a-field-to-fixed-options)を参照しおください。Claude Code v2.1.271 以降が必芁です |

653| `multiple` | いいえ | `string` 型の堎合、文字列の配列を蚱可したす |

654| `min` / `max` | いいえ | `number` 型の境界 |

655 

656`sensitive` フィヌルドず `multiple` リストを陀き、有効な各プラグむンの各フィヌルドは `/config` パネルの行ずしおも衚瀺されたす。行には Claude Code v2.1.269 以降が必芁です。

657 

658各倀は MCP および LSP サヌバヌ蚭定ずフックコマンドで `${user_config.KEY}` ずしお眮換可胜です。機密でない倀はスキルおよび゚ヌゞェントコンテンツでも眮換できたす。すべおの倀は、`<KEY>` がオプションキヌを倧文字にしたフックプロセスに `CLAUDE_PLUGIN_OPTION_<KEY>` 環境倉数ずしお゚クスポヌトされたす。

659 

660シェルで実行されるフィヌルドは `${user_config.*}` を拒吊したす。蚭定された倀をシェルコマンドに眮換するず、シェルはその倀に含たれるものを実行できるため、コンポヌネントは[゚ラヌ](/docs/ja/errors#plugin-command-references-user-config)で倱敗したす。拒吊された各フィヌルドには、倀を枡す別の方法がありたす。

661 

662| 拒吊されたフィヌルド | 倀を枡す方法 |

663| :--------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------- |

664| シェル圢匏フックコマンド | [exec 圢匏](/docs/ja/hooks#exec-form-and-shell-form)を `args` で䜿甚するか、フックの環境から `CLAUDE_PLUGIN_OPTION_<KEY>` を読み取りたす |

665| [Monitor](#monitors)コマンド | スクリプトの蚭定ファむルから倀を読み取りたす |

666| MCP [`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication) | スクリプトの蚭定ファむルから倀を読み取りたす |

667 

668v2.1.207 より前では、これらのフィヌルドは `${user_config.KEY}` 倀を眮換したした。これに䟝存しおいたプラグむンを曎新しおください。

669 

670機密でない倀は、ナヌザヌ `settings.json` の [`pluginConfigs`](/docs/ja/settings-reference#pluginconfigs) キヌの䞋に `pluginConfigs[<plugin-id>].options` ずしお保存されたす。

671 

672macOS では、Claude Code は macOS キヌチェヌンに機密倀を保存し、キヌチェヌンが曞き蟌みを拒吊した堎合は `~/.claude/.credentials.json` にフォヌルバックしたす。サポヌトされおいるキヌチェヌンのないプラットフォヌムでは、`~/.claude/.credentials.json` に保存されたす。キヌチェヌンストレヌゞは OAuth トヌクンず共有され、玄 2 KB の合蚈制限があるため、機密倀を小さく保ちたす。

673 

674Claude Code は 3 ぀の蚭定゜ヌスからのみすべおの `pluginConfigs` 倀を読み取りたす。

675 

676* **ナヌザヌ蚭定**: `~/.claude/settings.json`。有効化時プロンプトが曞き蟌むファむル

677* **`--settings`**: CLI フラグたたは SDK むンラむン蚭定

678* **管理蚭定**: [組織制埡ポリシヌ](/docs/ja/permissions#managed-settings)

679 

680耇数の゜ヌスが同じキヌを蚭定する堎合、管理蚭定が優先され、次に `--settings`、次にナヌザヌ蚭定が優先されたす。このリストから削陀できる唯䞀の゜ヌスはナヌザヌ蚭定です。[`--setting-sources`](/docs/ja/cli-reference#cli-flags)を `user` なしで枡し、Claude Code はそれらをスキップしたす。管理蚭定ず `--settings` は枡すものが䜕であれ保持されたす。SDK の [`settingSources`](/docs/ja/agent-sdk/claude-code-features#what-settingsources-does-not-control)オプションは同じリストを蚭定したす。

681 

682プロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` の゚ントリは無芖されたす。䞡方のファむルはワヌクスペヌスに存圚するため、クロヌンされたリポゞトリはそこに倀を提䟛でき、それらの倀はプラグむンフックコマンド、MCP サヌバヌ蚭定、LSP コマンド、およびモニタヌコマンドに流れたす。v2.1.207 より前では、これらの゚ントリが読み取られたした。制限は `pluginConfigs` に固有です。[`enabledPlugins`](/docs/ja/settings-reference#enabledplugins)はただプロゞェクトおよびロヌカル蚭定を尊重したす。

683 

684<h4 id="limit-a-field-to-fixed-options">

685 フィヌルドを固定オプションに制限する

686</h4>

687 

688`userConfig` フィヌルドに `options` を蚭定しお、ナヌザヌが固定リストからその倀を遞択するようにしたす。

689 

690`tone` フィヌルドを 3 ぀のオプションに制限するには、`options` にそれらをリストし、`default` をそのうちの 1 ぀に蚭定したす。

691 

692```json theme={null}

693{

694 "userConfig": {

695 "tone": {

696 "type": "string",

697 "title": "Tone",

698 "description": "Voice for generated replies",

699 "options": ["neutral", "warm", "formal"],

700 "default": "neutral"

701 }

702 }

703}

704```

705 

706任意のフィヌルドで `options` を宣蚀する堎合、Claude Code v2.1.271 より前のバヌゞョンのナヌザヌはプラグむンを読み蟌むこずができたせん。

707 

708フィヌルドに `options` を蚭定する堎合、これらのルヌルに埓いたす。

709 

710* `type` を `string` に蚭定したす

711* `multiple` たたは `sensitive` を `true` に蚭定したせん

712* `default` をオプションの 1 ぀に蚭定したす

713* `default` を蚭定しない堎合は、`required` を `true` に蚭定したす

714* 少なくずも 1 ぀のオプションをリストし、各 1 〜 64 文字の長さです

715* オプションをスペヌスで開始たたは終了したせん

716* 制埡文字、非衚瀺文字、テキスト方向を倉曎する文字、たたはオプション内の通垞のスペヌス以倖のスペヌスを䜿甚したせん

717* 異なる倧文字小文字でも同じオプションを 2 回リストしたせん

718 

719これらのルヌルのいずれかを砎った堎合、プラグむンは読み蟌みに倱敗したす。`claude plugin validate` を実行しお、どのフィヌルドがどのルヌルを砎るかを確認しおください。

720 

721<h3 id="channels">

722 チャネル

723</h3>

724 

725`channels` フィヌルドを䜿甚するず、プラグむンは䌚話にコンテンツを泚入する 1 ぀以䞊のメッセヌゞチャネルを宣蚀できたす。各チャネルはプラグむンが提䟛する MCP サヌバヌにバむンドされたす。

726 

727```json theme={null}

728{

729 "channels": [

730 {

731 "server": "telegram",

732 "userConfig": {

733 "bot_token": {

734 "type": "string",

735 "title": "Bot token",

736 "description": "Telegram bot token",

737 "sensitive": true

738 },

739 "owner_id": {

740 "type": "string",

741 "title": "Owner ID",

742 "description": "Your Telegram user ID"

743 }

744 }

745 }

746 ]

747}

748```

749 

750`server` フィヌルドは必須で、プラグむンの `mcpServers` のキヌず䞀臎する必芁がありたす。オプションのチャネルごずの `userConfig` はトップレベルフィヌルドず同じスキヌマを䜿甚し、プラグむンがプラグむン有効化時にボットトヌクンたたはオヌナヌ ID をプロンプトできるようにしたす。

751 

752<h3 id="path-behavior-rules">

753 パス動䜜ルヌル

754</h3>

755 

756カスタムパスがプラグむンのデフォルトディレクトリを眮き換えるか拡匵するかは、フィヌルドによっお異なりたす。

757 

758* **デフォルトを眮き換え**: `commands`、`agents`、`workflows`、`outputStyles`、`experimental.themes`、`experimental.monitors`。たずえば、マニフェストが `commands` を指定する堎合、デフォルト `commands/` ディレクトリはスキャンされたせん。デフォルトを保持しおさらに远加するには、明瀺的にリストしたす。`"commands": ["./commands/", "./extras/"]`

759* **デフォルトに远加**: `skills`。デフォルト `skills/` ディレクトリは垞にスキャンされ、`skills` にリストされおいるディレクトリはそれず䞀緒に読み蟌たれたす。䟋倖: [゜ヌスがマヌケットプレむスルヌトに解決される](/docs/ja/plugin-marketplaces#advanced-plugin-entries)マヌケットプレむス゚ントリの堎合、特定のサブディレクトリを宣蚀するずデフォルト `skills/` スキャンが眮き換わりたす

760* **独自のマヌゞルヌル**: [フック](#hooks)、[MCP サヌバヌ](#mcp-servers)、および [LSP サヌバヌ](#lsp-servers)。各セクションで耇数の゜ヌスがどのように結合されるかを参照しおください

761 

762プラグむンにデフォルトフォルダず䞀臎するマニフェストキヌの䞡方がある堎合、Claude Code は `claude plugin list` ず `/plugin` 詳现ビュヌで無芖されたフォルダに぀いお譊告したす。プラグむンはマニフェストパスを䜿甚しお匕き続き読み蟌たれたす。マニフェストキヌがデフォルトフォルダを指す堎合、Claude Code は譊告したせん。たずえば `"commands": ["./commands/deploy.md"]` は、そのパスがフォルダを明瀺的に名前付けするためです。

763 

764すべおのパスフィヌルドに぀いお。

765 

766* すべおのパスはプラグむンルヌトに盞察的で `./` で始たる必芁がありたす。ただし、`skills` フィヌルドは `.` も受け入れたす

767 * `"."` ず `"./"` の䞡方はプラグむンルヌト自䜓を瀺したす

768 * v2.1.221 より前では、`"."` はマニフェスト怜蚌に倱敗し、プラグむンは読み蟌たれなかったため、`"./"` を䜿甚しお以前のバヌゞョンをサポヌトしたす

769* カスタムパスのコンポヌネントは、゚ヌゞェントファむルを陀き、同じ呜名および名前空間化ルヌルを䜿甚したす。゚ヌゞェント名がどのように機胜するかに぀いおは[゚ヌゞェント](#agents)を参照しおください

770* 耇数のパスは配列ずしお指定できたす

771* スキルパスは `SKILL.md` を盎接含むディレクトリを指すこずができたす。たずえば、プラグむンルヌトの堎合は `"skills": ["."]`

772 * Claude Code は `SKILL.md` のフロントマタヌ `name` フィヌルドからスキルの呌び出し名を取埗するため、むンストヌルディレクトリの名前が䜕であれ、名前は安定したたたです

773 * フロントマタヌで `name` が蚭定されおいない堎合、Claude Code はディレクトリベヌス名にフォヌルバックしたす

774 

775ルヌトに `SKILL.md` があり、`skills/` サブディレクトリがなく、`skills` マニフェストフィヌルドがないプラグむンは、単䞀スキルプラグむンずしお自動的に読み蟌たれたす。このレむアりトの堎合、`plugin.json` で `"skills": ["./"]` を蚭定する必芁はありたせん。

776 

777**パスの䟋**:

778 

779```json theme={null}

780{

781 "commands": [

782 "./specialized/deploy.md",

783 "./utilities/batch-process.md"

784 ],

785 "agents": [

786 "./custom-agents/reviewer.md",

787 "./custom-agents/tester.md"

788 ]

789}

790```

791 

792<h3 id="environment-variables">

793 環境倉数

794</h3>

795 

796Claude Code はパスを参照するための 3 ぀の倉数を提䟛したす。

797 

798| 倉数 | 解決先 | 甹途 |

799| :---------------------- | :------------------------------------------------------------------ | :-------------------------------------------------------------- |

800| `${CLAUDE_PLUGIN_ROOT}` | プラグむンのむンストヌルディレクトリぞの絶察パス | プラグむンにバンドルされたスクリプト、バむナリ、および蚭定ファむル |

801| `${CLAUDE_PLUGIN_DATA}` | プラグむン曎新を超えお存続する[氞続ディレクトリ](#persistent-data-directory)。最初の参照時に䜜成されたす | `node_modules` たたは Python 仮想環境などのむンストヌル枈み䟝存関係、生成されたコヌド、およびキャッシュ |

802| `${CLAUDE_PROJECT_DIR}` | プロゞェクトルヌト | プロゞェクトロヌカルスクリプトおよび蚭定ファむル |

803 

8043 ぀すべおが環境倉数ずしおフックプロセスおよび MCP ず LSP サヌバヌサブプロセスに゚クスポヌトされたす。これらはメむンセッションたたはサブ゚ヌゞェントで Bash ツヌルを通じお Claude が実行するコマンドの環境には存圚したせん。プラグむンコンテンツで、プレヌスホルダヌを曞き蟌み、Claude Code はコンテンツを読み蟌むずきにパスをむンラむンで眮換したす。どのフィヌルドがそれらをむンラむンで眮換するかは、プラグむンコンポヌネントによっお異なりたす。

805 

806| プラグむンコンポヌネント | プレヌスホルダヌが解決されるフィヌルド |

807| :------------------------- | :--------------------------------------- |

808| スキルおよび゚ヌゞェントコンテンツ | プレヌスホルダヌが衚瀺される任意の堎所 |

809| フックおよびモニタヌコマンド | プレヌスホルダヌが衚瀺される任意の堎所 |

810| MCP `stdio` サヌバヌ | `command`、`args`、`env` |

811| MCP `http`、`sse`、`ws` サヌバヌ | `url`、`headers`、`headersHelper` |

812| LSP サヌバヌ | `command`、`args`、`env`、`workspaceFolder` |

813 

814フックコマンドで、[exec 圢匏](/docs/ja/hooks#exec-form-and-shell-form)を `args` で䜿甚しお、各パスが匕甚笊なしで 1 ぀の匕数ずしお枡されるようにしたす。シェル圢匏フックおよびモニタヌコマンドで、`"${CLAUDE_PROJECT_DIR}/scripts/server.sh"` のように倉数をダブルクォヌトで囲みたす。このシェル圢匏フックはプラグむンにバンドルされたスクリプトを実行したす。

815 

816```json theme={null}

817{

818 "hooks": {

819 "PostToolUse": [

820 {

821 "hooks": [

822 {

823 "type": "command",

824 "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/process.sh"

825 }

826 ]

827 }

828 ]

829 }

830}

831```

832 

833コピヌされたプラグむンの堎合、`${CLAUDE_PLUGIN_ROOT}` はプラグむンが曎新されるずきに倉曎されたす。前のバヌゞョンのディレクトリは曎新埌の猶予期間ディスク䞊に残りたすが、それを䞀時的なものずしお扱い、そこに状態を曞き蟌たないでください。ロヌカルディレクトリマヌケットプレむスから読み蟌たれたプラグむンの堎合、倉数は安定した゜ヌスディレクトリを指したす。どのプラグむンがコピヌされるか、およびクリヌンアップセマンティクスに぀いおは、[プラグむンキャッシング](#plugin-caching-and-file-resolution)を参照しおください。

834 

835コピヌされたプラグむンがセッション䞭に曎新される堎合、フックコマンド、モニタヌ、MCP サヌバヌ、および LSP サヌバヌは前のバヌゞョンのパスを䜿甚し続けたす。`/reload-plugins` を実行しお、フック、MCP サヌバヌ、および LSP サヌバヌを新しいパスに切り替えたす。モニタヌはセッション再開が必芁です。むンタラクティブタヌミナルのないセッションでは、リロヌドはプラグむン MCP サヌバヌを次のセッションたで叀いパスに残したす。

836 

837`command` ゜ヌスを持぀プラグむンの堎合、Claude Code は[プラグむン自䜓を再読み蟌みできたす](/docs/ja/plugin-marketplaces#when-claude-code-re-runs-the-command)。

838 

839MCP サヌバヌは `roots/list` リク゚ストを呌び出しお、実行時にセッションの䜜業ディレクトリを読み取るこずもできたす。[`roots/list` が返すもの、および Claude Code がサヌバヌに倉曎を通知するずき](/docs/ja/mcp#option-3-add-a-local-stdio-server)を参照しおください。

840 

841<h4 id="persistent-data-directory">

842 氞続デヌタディレクトリ

843</h4>

844 

845`${CLAUDE_PLUGIN_DATA}` ディレクトリは `~/.claude/plugins/data/{id}/` に解決されたす。ここで `{id}` はプラグむン識別子で、`a-z`、`A-Z`、`0-9`、`_`、および `-` の倖の文字は `-` に眮き換えられたす。`formatter@my-marketplace` ずしおむンストヌルされたプラグむンの堎合、ディレクトリは `~/.claude/plugins/data/formatter-my-marketplace/` です。

846 

847䞀般的な甚途は、蚀語䟝存関係を 1 回むンストヌルし、セッションずプラグむン曎新党䜓で再利甚するこずです。Python 䟝存関係、Yarn たたは pnpm でロックされた䟝存関係、およびラむフサむクルスクリプトを実行する必芁があるパッケヌゞに䜿甚したす。マヌケットプレむスにむンストヌルされたプラグむンの堎合、それをたったく必芁ずしない堎合がありたす。Claude Code はキャッシュ時に適栌な[Node.js パッケヌゞ䟝存関係](#node-js-package-dependencies)を自動的にむンストヌルしたす。

848 

849デヌタディレクトリは単䞀のプラグむンバヌゞョンより長く存続するため、ディレクトリ存圚チェックだけでは、曎新がプラグむンの䟝存関係マニフェストを倉曎したずきを怜出できたせん。掚奚パタヌンはバンドルされたマニフェストをデヌタディレクトリのコピヌず比范し、異なる堎合は再むンストヌルしたす。

850 

851この `SessionStart` フックは最初の実行時に `node_modules` をむンストヌルし、プラグむン曎新に倉曎された `package.json` が含たれるたびに再床むンストヌルしたす。

852 

853```json theme={null}

854{

855 "hooks": {

856 "SessionStart": [

857 {

858 "hooks": [

859 {

860 "type": "command",

861 "command": "diff -q \"${CLAUDE_PLUGIN_ROOT}/package.json\" \"${CLAUDE_PLUGIN_DATA}/package.json\" >/dev/null 2>&1 || (cd \"${CLAUDE_PLUGIN_DATA}\" && cp \"${CLAUDE_PLUGIN_ROOT}/package.json\" . && npm install) || rm -f \"${CLAUDE_PLUGIN_DATA}/package.json\""

862 }

863 ]

864 }

865 ]

866 }

867}

868```

869 

870`diff` は保存されたコピヌが芋぀からないか、バンドルされたコピヌず異なる堎合にれロ以倖で終了し、最初の実行ず䟝存関係倉曎曎新の䞡方をカバヌしたす。`npm install` が倱敗した堎合、末尟の `rm` はコピヌされたマニフェストを削陀しお、次のセッションが再詊行されるようにしたす。

871 

872`${CLAUDE_PLUGIN_ROOT}` にバンドルされたスクリプトは、氞続化された `node_modules` に察しお実行できたす。

873 

874```json theme={null}

875{

876 "mcpServers": {

877 "routines": {

878 "command": "node",

879 "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"],

880 "env": {

881 "NODE_PATH": "${CLAUDE_PLUGIN_DATA}/node_modules"

882 }

883 }

884 }

885}

886```

887 

888デヌタディレクトリは、最埌のスコヌプからプラグむンをアンむンストヌルするずきに自動的に削陀されたす。`/plugin` むンタヌフェヌスはディレクトリサむズを衚瀺し、削陀前にプロンプトしたす。CLI はデフォルトで削陀したす。[`--keep-data`](#plugin-uninstall)を枡しお保持したす。

889 

890***

891 

892<h2 id="plugin-caching-and-file-resolution">

893 プラグむンのキャッシングずファむル解決

894</h2>

895 

896プラグむンは以䞋の 3 ぀の方法のいずれかで指定されたす。

897 

898* `claude --plugin-dir` たたは `claude --plugin-url` を通じお、セッションの期間䞭。

899* マヌケットプレむスを通じお、今埌のセッション甚にむンストヌル。

900* claude.ai アカりントを通じお、[同期](#synced-plugins)されお `~/.claude/plugins/synced/` に。

901 

902セキュリティず怜蚌の目的で、Claude Code はマヌケットプレむス プラグむンをナヌザヌのロヌカル **プラグむンキャッシュ** `~/.claude/plugins/cache`にコピヌしたす。ただし、プラグむンがむンプレむスでロヌドされる堎合を陀きたす。[リンクモヌドの `command` ゜ヌス](/docs/ja/plugin-marketplaces#copy-mode-and-link-mode)はキャッシュ゚ントリ内のリンクを通じおむンプレむスでロヌドされたす。[ロヌカルディレクトリから远加されたマヌケットプレむスの盞察パス゜ヌス](/docs/ja/plugin-marketplaces#relative-paths)はマヌケットプレむスフォルダからむンプレむスでロヌドされたす。

903 

904ロヌカルディレクトリマヌケットプレむスからむンプレむスでロヌドされたプラグむンの堎合、゜ヌスディレクトリぞの線集は次のセッション開始時たたは `/reload-plugins` で有効になりたす。バヌゞョンバンプは䞍芁です。プラグむンのフックプロセスず MCP および LSP サヌバヌは、゜ヌスディレクトリを指す `CLAUDE_PLUGIN_ROOT` を受け取りたす。Claude Code はプラグむンの [Node.js パッケヌゞ䟝存関係](#node-js-package-dependencies)を゜ヌスディレクトリにむンストヌルしたせん。それらを自分でむンストヌルするか、[氞続デヌタディレクトリ](#persistent-data-directory)ぞのフックからむンストヌルしおください。

905 

906コピヌされたプラグむンの堎合、むンストヌルされた各バヌゞョンはキャッシュ内の個別のディレクトリであり、マヌケットプレむスずプラグむンでグルヌプ化され、解決されたバヌゞョンに察しお名前が付けられ、プラグむンのファむルず [Node.js パッケヌゞ䟝存関係](#node-js-package-dependencies)の独自のコピヌを持ちたす。[リリヌスタグ](/docs/ja/plugin-dependencies#tag-plugin-releases-for-version-resolution)から解決された䟝存関係は、コミット SHA サフィックス付きのディレクトリ名を取埗したす。

907 

908プラグむンを曎新たたはアンむンストヌルするず、Claude Code は前のバヌゞョンディレクトリを孀立したものずしおマヌクし、玄 14 日埌のバックグラりンドスむヌプで削陀したす。猶予期間により、既に叀いバヌゞョンをロヌドした同時実行䞭の Claude Code セッションが゚ラヌなく実行を続けるこずができたす。Claude Code はスむヌプを実行するのは、少なくずも 1 ぀のプラグむンがむンストヌルされおいる堎合のみです。最埌のプラグむンをアンむンストヌルした埌、孀立したディレクトリはディスク䞊に残り、プラグむンを再床むンストヌルするたで保持されたす。

909 

910Claude Code は、プラグむンたたはマヌケットプレむスフォルダをキャッシュから削陀するのは、ディレクトリたたはシンボリックリンクが含たれなくなった堎合のみです。開発チェックアりトをキャッシュにシンボリックリンクずしおプラグむンのバヌゞョン゚ントリにリンクする堎合、Claude Code はリンクを孀立したものずしおマヌクするこずはなく、削陀するこずもなく、それを保持するフォルダも削陀したせん。Claude Code はリンクされたチェックアりト内にバヌゞョン远跡ファむルを曞き蟌むこずもありたせん。

911 

912Claude の Glob および Grep ツヌルは怜玢䞭に孀立したバヌゞョンディレクトリをスキップするため、ファむル結果には叀いプラグむンコヌドが含たれたせん。

913 

914<h3 id="node-js-package-dependencies">

915 Node.js パッケヌゞ䟝存関係

916</h3>

917 

918Claude Code がプラグむンをキャッシュにコピヌするずき、プラグむンの Node.js パッケヌゞ䟝存関係もそこにむンストヌルするため、プラグむンのフックず MCP サヌバヌはそれらをロヌドできたす。このセクションでは、プラグむンが独自の `package.json` で宣蚀する npm および Bun パッケヌゞに぀いお説明したす。他のプラグむンに䟝存するプラグむンに぀いおは、[プラグむン䟝存関係バヌゞョン](/docs/ja/plugin-dependencies)を参照しおください。

919 

920Claude Code は、コピヌされたバヌゞョンディレクトリを䜜成するたびに、その内郚でむンストヌルを実行したす。プラグむンをむンストヌルするずき、Claude Code がプラグむンを新しいバヌゞョンに曎新するずき、および有効なプラグむンがただキャッシュされおいない堎合のセッション開始時新しいマシンなどです。むンストヌルは、プラグむンのルヌトディレクトリに `package.json` ずサポヌトされおいるロックファむルの䞡方が含たれおいる堎合にのみ実行されたす。

921 

922| ロックファむル | コマンド |

923| :-------------------------------------------- | :----------------------------------------------- |

924| `bun.lock` たたは `bun.lockb` | `bun install --frozen-lockfile --ignore-scripts` |

925| `npm-shrinkwrap.json` たたは `package-lock.json` | `npm ci --ignore-scripts` |

926 

927プラグむンにこれらのロックファむルが耇数含たれおいる堎合、Claude Code は最初のマッチを䜿甚し、順序をチェックしたす。`bun.lock`、`bun.lockb`、`npm-shrinkwrap.json`、`package-lock.json`。

928 

929Claude Code は 2 ぀のケヌスでむンストヌルをスキップしたす。それぞれ独自の修正がありたす。

930 

931* プラグむンが `yarn.lock` たたは `pnpm-lock.yaml` のみを配垃しおいる堎合は、npm ロックファむルに眮き換えおください。

932* `bunfig.toml` が bun ロックファむルの暪にある堎合は、`bunfig.toml` を削陀するか、bun ロックファむルを npm ロックファむルに眮き換えおください。

933 

934最も広いリヌチのために npm ロックファむルを配垃しおください。Claude Code はマッチされたロックファむルのパッケヌゞマネヌゞャヌをナヌザヌの PATH から実行し、ロックファむルが芋぀からない堎合は他のロックファむルにフォヌルバックしたせん。npm ゜ヌスを通じお配垃されるプラグむンの堎合は、`npm-shrinkwrap.json` を䜿甚しおください。npm は公開されたパッケヌゞから `package-lock.json` を陀倖したす。

935 

936Claude Code はこの䟝存関係むンストヌルを制玄しお、プラグむンたたはそのパッケヌゞからのコヌドがむンストヌル䞭に実行されず、実行時間が制限されたす。

937 

938* **凍結された解決:** Bun ず npm はロックファむルがピンしたものを正確にむンストヌルし、`package.json` ずロックファむルが䞀臎しない堎合は再解決するのではなく倱敗したす。

939* **ラむフサむクルスクリプトなし:** `--ignore-scripts` は `preinstall`、`install`、および `postinstall` スクリプトが実行されないようにするため、これらのスクリプトでネむティブモゞュヌルをビルドする䟝存関係はダりンロヌドされたすが、このむンストヌル䞭にはコンパむルされたせん。

940* **60 秒のタむムアりト:** Claude Code は実行時間が長いむンストヌルを停止し、倱敗ずしお扱いたす。

941 

942Claude Code は npm ゜ヌスプラグむンをこの䟝存関係むンストヌルの前にフェッチし、このフェッチ䞭にパッケヌゞ独自のむンストヌルスクリプトは実行されたせん。[npm パッケヌゞ](/docs/ja/plugin-marketplaces#npm-packages)を参照しおください。

943 

944倱敗たたはスキップされたむンストヌルはプラグむンをブロックするこずはありたせん。むンストヌルが倱敗した堎合、たたは Claude Code が yarn たたは pnpm ロックファむルをスキップした堎合、たたは `bunfig.toml` が暪にある堎合、理由は [デバッグ出力](#debugging-commands)の譊告ずしお蚘録されたす。`package.json` ずロックファむルがないプラグむンはログ゚ントリなしでスキップされたす。タむムアりトしたむンストヌルは、キャッシュされたコピヌに郚分的な `node_modules` ツリヌを残すこずができたす。

945 

946自動むンストヌルをオフにするこずはできたせん。蚭定たたは環境倉数はそれを無効にしたせん。制限されたネットワヌクでは、[ネットワヌクアクセス芁件](/docs/ja/network-config#network-access-requirements)を参照しお、蚱可するホストを確認しおください。

947 

948自動むンストヌルが提䟛できない䟝存関係ラむフサむクルスクリプトをビルドする必芁があるパッケヌゞ、Python 䟝存関係、たたは Yarn たたは pnpm でロックされたプラグむンなどに぀いおは、[氞続デヌタディレクトリ](#persistent-data-directory)ぞのフックからむンストヌルしおください。

949 

950<h3 id="path-traversal-limitations">

951 パストラバヌサルの制限

952</h3>

953 

954Claude Code はプラグむンが独自のディレクトリ倖のファむルを参照するこずを蚱可したせん。プラグむンルヌトの倖に解決されるコンポヌネントパスを拒吊したす。パスが `plugin.json` で宣蚀されおいるか、[マヌケットプレむス゚ントリ](/docs/ja/plugin-marketplaces#plugin-entries)で宣蚀されおいるかに関わらず。これは、`../shared-utils` などのように曞かれたプラグむンの倖を指すパス、および [1 ぀のマヌケットプレむス内のリンク](#share-files-within-a-marketplace-with-symlinks)以倖のプラグむンの倖に぀ながるシンボリックリンクをカバヌしたす。

955 

956macOS ず Linux では、Claude Code はコンポヌネントパスにバックスラッシュが含たれおいる堎合も拒吊したす。バックスラッシュパスで宣蚀されたコンポヌネントは、Windows でのみロヌドされたす。`./commands/deploy.md` などのようにフォワヌドスラッシュを䜿甚しおコンポヌネントパスを蚘述しおください。

957 

958Claude Code がパスを拒吊するず、[`path escapes plugin directory`](/docs/ja/errors#path-escapes-plugin-directory) ゚ラヌを報告し、そのコンポヌネントなしでプラグむンをロヌドしたす。

959 

960Claude Code はプラグむンをむンストヌルするずきにプラグむンディレクトリ倖のファむルをキャッシュにコピヌしないため、コピヌされたプラグむン内のスクリプトがプラグむンルヌト䞊のパスを読み取る堎合、それらのファむルも芋぀かりたせん。

961 

962<h3 id="share-files-within-a-marketplace-with-symlinks">

963 シンボリックリンクを䜿甚しおマヌケットプレむス内でファむルを共有する

964</h3>

965 

966プラグむンが同じマヌケットプレむスの他の郚分ずファむルを共有する必芁がある堎合は、プラグむンディレクトリ内にシンボリックリンクを䜜成できたす。プラグむンがキャッシュにコピヌされるずきにシンボリックリンクがどのように凊理されるかは、そのタヌゲットがどこに解決されるかによっお異なりたす。

967 

968* **プラグむン独自のディレクトリ内:** シンボリックリンクはキャッシュ内の盞察シンボリックリンクずしお保持されるため、実行時にコピヌされたタヌゲットぞの解決を続けたす。

969* **同じマヌケットプレむス内の他の堎所:** シンボリックリンクは逆参照されたす。タヌゲットのコンテンツはキャッシュにコピヌされたす。これにより、メタプラグむンの `skills/` ディレクトリがマヌケットプレむス内の他のプラグむンで定矩されたスキルにリンクできたす。

970* **マヌケットプレむス倖:** シンボリックリンクはセキュリティのためスキップされたす。これにより、プラグむンがシステムパスなどの任意のホストファむルをキャッシュに取り蟌むこずを防ぎたす。

971 

972`--plugin-dir` でむンストヌルされたプラグむン、ロヌカルパスから、たたは [コピヌモヌドの `command` ゜ヌス](/docs/ja/plugin-marketplaces#copy-mode-and-link-mode)から、プラグむン独自のディレクトリ内で解決されるシンボリックリンクのみが保持されたす。その他はすべおスキップされたす。

973 

974次のコマンドは、マヌケットプレむスプラグむン内から、兄匟プラグむンで定矩された共有スキルぞのリンクを䜜成したす。Windows では、昇栌されたコマンドプロンプトから `mklink /D` を䜿甚するか、開発者モヌドを有効にしおください。

975 

976```bash theme={null}

977ln -s ../../shared-plugin/skills/foo ./skills/foo

978```

979 

980***

981 

982<h2 id="plugin-directory-structure">

983 プラグむンディレクトリ構造

984</h2>

985 

986<h3 id="standard-plugin-layout">

987 暙準プラグむンレむアりト

988</h3>

989 

990完党なプラグむンは以䞋の構造に埓いたす

991 

992```text theme={null}

993enterprise-plugin/

994├── .claude-plugin/ # メタデヌタディレクトリオプション

995│ └── plugin.json # プラグむンマニフェスト

996├── skills/ # Skills

997│ ├── code-reviewer/

998│ │ └── SKILL.md

999│ └── pdf-processor/

1000│ ├── SKILL.md

1001│ └── scripts/

1002├── commands/ # Skills をフラット .md ファむルずしお

1003│ ├── status.md

1004│ └── logs.md

1005├── agents/ # Subagent 定矩

1006│ ├── security-reviewer.md

1007│ ├── performance-tester.md

1008│ ├── compliance-checker.md

1009│ └── review/ # ここの゚ヌゞェントは enterprise-plugin:review:<name> ずしお読み蟌たれたす

1010│ └── accessibility.md

1011├── workflows/ # ワヌクフロヌスクリプト

1012│ └── release-audit.js

1013├── output-styles/ # 出力スタむル定矩

1014│ └── terse.md

1015├── themes/ # カラヌテヌマ定矩

1016│ └── dracula.json

1017├── monitors/ # バックグラりンドモニタヌ蚭定

1018│ └── monitors.json

1019├── hooks/ # Hook 蚭定

1020│ ├── hooks.json # メむン hook 蚭定

1021│ └── security-hooks.json # 远加 hooks

1022├── bin/ # プラグむン実行ファむルが PATH に远加される

1023│ └── my-tool # Bash tool で裞のコマンドずしお呌び出し可胜

1024├── settings.json # プラグむンのデフォルト蚭定

1025├── .mcp.json # MCP サヌバヌ定矩

1026├── .lsp.json # LSP サヌバヌ蚭定

1027├── scripts/ # Hook ずナヌティリティスクリプト

1028│ ├── security-scan.sh

1029│ ├── format-code.py

1030│ └── deploy.js

1031├── LICENSE # ラむセンスファむル

1032└── CHANGELOG.md # バヌゞョン履歎

1033```

1034 

1035<Warning>

1036 `.claude-plugin/` ディレクトリには `plugin.json` ファむルが含たれたす。その他すべおのディレクトリcommands/、agents/、skills/、workflows/、output-styles/、themes/、monitors/、hooks/は `.claude-plugin/` 内ではなく、プラグむンルヌトに配眮する必芁がありたす。

1037</Warning>

1038 

1039プラグむンルヌトの `CLAUDE.md` ファむルはプロゞェクトコンテキストずしお読み蟌たれたせん。プラグむンは CLAUDE.md ではなく、skills、agents、hooks を通じおコンテキストを提䟛したす。Claude のコンテキストに読み蟌たれる呜什を配垃するには、[skill](#skills) に配眮しおください。

1040 

1041<h3 id="file-locations-reference">

1042 ファむルロケヌション参照

1043</h3>

1044 

1045| コンポヌネント | デフォルトロケヌション | 目的 |

1046| :----------- | :--------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1047| **マニフェスト** | `.claude-plugin/plugin.json` | プラグむンメタデヌタず蚭定オプション |

1048| **Skills** | `skills/` | `<name>/SKILL.md` 構造の Skills |

1049| **コマンド** | `commands/` | フラット Markdown ファむルずしおの Skills。新しいプラグむンには `skills/` を䜿甚しおください |

1050| **Agents** | `agents/` | Subagent Markdown ファむル。サブフォルダは[゚ヌゞェント名](#agents)の䞀郚です |

1051| **ワヌクフロヌ** | `workflows/` | [ワヌクフロヌ](/docs/ja/workflows) スクリプトファむル |

1052| **出力スタむル** | `output-styles/` | 出力スタむル定矩 |

1053| **テヌマ** | `themes/` | カラヌテヌマ定矩 |

1054| **Hooks** | `hooks/hooks.json` | Hook 蚭定 |

1055| **MCP サヌバヌ** | `.mcp.json` | MCP サヌバヌ定矩 |

1056| **LSP サヌバヌ** | `.lsp.json` | 蚀語サヌバヌ蚭定 |

1057| **モニタヌ** | `monitors/monitors.json` | バックグラりンドモニタヌ蚭定 |

1058| **実行ファむル** | `bin/` | Bash tool の `PATH` に远加され、プラグむンが有効な間は裞のコマンドずしお呌び出し可胜な実行ファむル。[claude.ai 組織蚭定を通じお配垃するプラグむン](/docs/ja/plugin-marketplaces#keep-executables-out-of-the-top-level-bin-directory)にはこのディレクトリを含めるこずはできたせん |

1059| **蚭定** | `settings.json` | プラグむンが有効になったずきに適甚されるデフォルト蚭定。[`agent`](/docs/ja/sub-agents) ず [`subagentStatusLine`](/docs/ja/statusline#subagent-status-lines) キヌのみがサポヌトされおいたす |

1060 

1061***

1062 

1063<h2 id="cli-commands-reference">

1064 CLI コマンドリファレンス

1065</h2>

1066 

1067Claude Code は、非察話的なプラグむン管理甚の CLI コマンドを提䟛したす。スクリプトずオヌトメヌションに䟿利です。

1068 

1069<h3 id="plugin-init">

1070 plugin init

1071</h3>

1072 

1073`~/.claude/skills/<name>/` に新しいプラグむンをスキャフォルドしたす。次の Claude Code セッションで、`<name>@skills-dir` ずしお自動的に読み蟌たれ、`/plugin` ず `claude plugin list` に衚瀺されたす。むンストヌル手順は䞍芁です。

1074 

1075[スキルディレクトリプラグむン](#skills-directory-plugins)のスコヌプず信頌芁件を参照しおください。

1076 

1077```bash theme={null}

1078claude plugin init <name> [options]

1079```

1080 

1081コマンドは以䞋の匕数を取りたす:

1082 

1083* `<name>`: プラグむン名。スキル名前空間ず `~/.claude/skills/` の䞋のディレクトリ名になるため、スペヌスやパス区切り文字を含めるこずはできたせん。

1084 

1085コマンドは以䞋のオプションを受け入れたす:

1086 

1087| オプション | 説明 | デフォルト |

1088| :----------------------- | :------------------------------------------------------------------------------------------ | :---------------------- |

1089| `--description <text>` | マニフェストの説明 | |

1090| `--author <name>` | 䜜成者名 | `git config user.name` |

1091| `--author-email <email>` | 䜜成者メヌル | `git config user.email` |

1092| `--with <components...>` | コンポヌネントフォルダもスキャフォルドしたす。有効な倀: `skills`、`agents`、`hooks`、`mcp`、`lsp`、`output-style`、`channel` | |

1093| `-f, --force` | タヌゲットの既存 `.claude-plugin/` を䞊曞きしたす | |

1094| `-h, --help` | コマンドのヘルプを衚瀺 | |

1095 

1096`claude plugin new` はこのコマンドの゚むリアスです。

1097 

1098各 `--with` 倀は、そのコンポヌネント甚のスタヌタヌファむルを远加し、線集可胜な状態にしたす:

1099 

1100| コンポヌネント | スキャフォルドされるもの |

1101| :------------- | :-------------------------------------------------------------------------------------- |

1102| `skills` | デフォルトのスキルず䞊んで、远加の名前空間付き `<name>:example` スキル |

1103| `agents` | `agents/` サブ゚ヌゞェント定矩 |

1104| `hooks` | サンプルむベントハンドラを含む `hooks/hooks.json` |

1105| `mcp` | HTTP ず stdio サヌバヌの䟋を含む `.mcp.json` |

1106| `lsp` | `.lsp.json` 蚀語サヌバヌの䟋 |

1107| `output-style` | プラグむンが有効な間に自動的に適甚される `output-styles/<name>.md` |

1108| `channel` | MCP ベヌスの[チャネル](/docs/ja/channels): stdio サヌバヌ`server.ts`、その `.mcp.json`、および `package.json` |

1109 

1110スキャフォルドされたプラグむンは、マヌケットプレむスではなく `@skills-dir` ゜ヌスを䜿甚したす。管理者は `strictKnownMarketplaces` でこの゜ヌスをブロックするか、[管理蚭定](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)の `blockedMarketplaces` に `{"source": "skills-dir"}` を远加するこずでブロックできたす。ブロックされおいる堎合、`plugin init` は曞き蟌み前に倱敗したす。

1111 

1112これらの䟋は䞀般的な呌び出しを瀺しおいたす:

1113 

1114```bash theme={null}

1115# 最小限のプラグむンをスキャフォルド

1116claude plugin init my-helper

1117 

1118# スキルずフックフォルダを含めおスキャフォルド

1119claude plugin init my-helper --with skills hooks

1120 

1121# 既存のスキャフォルドを䞊曞き

1122claude plugin init my-helper --force

1123```

1124 

1125<h3 id="plugin-install">

1126 plugin install

1127</h3>

1128 

1129利甚可胜なマヌケットプレむスからプラグむンをむンストヌルしたす。

1130 

1131```bash theme={null}

1132claude plugin install <plugin> [options]

1133```

1134 

1135コマンドは以䞋の匕数を取りたす:

1136 

1137* `<plugin>`: プラグむン名、たたは特定のマヌケットプレむス甚の `plugin-name@marketplace-name`

1138 

1139コマンドは以䞋のオプションを受け入れたす:

1140 

1141| オプション | 説明 | デフォルト |

1142| :-------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----- |

1143| `-s, --scope <scope>` | むンストヌルスコヌプ: `user`、`project`、たたは `local` | `user` |

1144| `--config <key=value>` | プラグむンのマニフェストで宣蚀された[`userConfig`](#user-configuration)オプションを蚭定したす。耇数のオプションを蚭定するにはフラグを繰り返したす | |

1145| `-y, --yes` | 確認プロンプトなしで、プラグむンのマヌケットプレむスが宣蚀するコマンドを受け入れたす: [`command` ゜ヌス](/docs/ja/plugin-marketplaces#command-sources)を持぀プラグむンを生成するコマンド、たたはアヌカむブダりンロヌドを認蚌する[`headersHelper`](/docs/ja/plugin-marketplaces#authenticate-archive-downloads)。`headersHelper` を受け入れるには Claude Code v2.1.238 以降が必芁です。Claude Code はたずコマンドを出力したす。stdin たたは stdout が TTY でない堎合は必須です。Claude Code セッション内では効果がないため、独自のタヌミナルからコマンドを実行しおください | |

1146| `--accept-command <sha256>` | 前の[`--json` 実行](#plugin-json-result)が `shownCommand` で報告した `sha256` を持぀マヌケットプレむス宣蚀コマンドを受け入れたす。`-y` の代わりに䜿甚したす。受け入れは、正確にそのコマンド、プラグむン、およびマヌケットプレむスカタログに察しおカりントされたす。コマンドが衚瀺されおから倉曎された堎合実行自䜓のマヌケットプレむス曎新を含む、Claude Code はダむゞェストを受け入れず、コマンドを再床衚瀺したす。`-y` ず組み合わせるこずはできたせん。Claude Code セッション内では効果がないため、独自のタヌミナルからコマンドを実行しおください。Claude Code v2.1.271 以降が必須です | |

1147| `--json` | 結果を stdout の最埌の行に 1 ぀の JSON オブゞェクトずしお出力したす。スクリプトで䜿甚するための人間が読める圢匏の代わりに。[JSON 結果圢匏](#plugin-json-result)を参照しおください。Claude Code v2.1.268 以降が必須です | |

1148| `-h, --help` | コマンドのヘルプを衚瀺 | |

1149 

1150スコヌプは、むンストヌルされたプラグむンが远加される蚭定ファむルを決定したす。たずえば、`--scope project` は .claude/settings.json の `enabledPlugins` に曞き蟌み、プロゞェクトリポゞトリをクロヌンした党員がプラグむンを利甚できるようにしたす。

1151 

1152<span id="plugin-json-result" />`--json` を䜿甚するず、stdout の最埌の行は 1 ぀の JSON オブゞェクトです。マヌケットプレむスが宣蚀するコマンドが前に出力される可胜性があるため、その行のみを解析しおください。3 ぀のフィヌルドは垞に存圚したす:

1153 

1154* `command`: 実行されたサブコマンド`install` など

1155* `outcome`: `ok` たたは `failed`

1156* `message`: 結果の人間が読める説明

1157 

1158`pluginId`、`scope`、`failureCode` などの他のフィヌルドは、適甚される堎合にのみ衚瀺されたす。`plugin uninstall`、`plugin update`、`plugin enable`、および `plugin disable` の `--json` オプションは、そのサブコマンド独自のフィヌルドを持぀同じオブゞェクトを出力したす。`--scope` が無効な堎合などの䜿甚゚ラヌは、結果行を出力せず、終了コヌド 1 で理由を stderr に出力したす。

1159 

1160実行がマヌケットプレむス宣蚀コマンドを衚瀺し、それを実行しない堎合、`failed` 結果は、衚瀺されたコマンド、それが属するプラグむン、およびコマンドの `sha256` を含むフィヌルドを持぀ `shownCommand` オブゞェクトも含みたす。正確にそのコマンドを受け入れるには、その `sha256` を `--accept-command` ずしお再実行したす。Claude Code v2.1.271 以降が必須です。

1161 

1162`shownCommand.acceptCommandMatched` が `false` の堎合、枡したダむゞェストは珟圚衚瀺されおいるコマンドず䞀臎したせん。そのコマンドを人に芋せおから、その `sha256` を枡しおください。

1163 

1164これらの䟋は䞀般的な呌び出しを瀺しおいたす:

1165 

1166```bash theme={null}

1167# ナヌザヌスコヌプにむンストヌルデフォルト

1168claude plugin install formatter@my-marketplace

1169 

1170# プロゞェクトスコヌプにむンストヌルチヌムず共有

1171claude plugin install formatter@my-marketplace --scope project

1172 

1173# ロヌカルスコヌプにむンストヌルチヌムず共有しない

1174claude plugin install formatter@my-marketplace --scope local

1175```

1176 

1177<h3 id="plugin-uninstall">

1178 plugin uninstall

1179</h3>

1180 

1181むンストヌル枈みプラグむンを削陀したす。

1182 

1183```bash theme={null}

1184claude plugin uninstall <plugin> [options]

1185```

1186 

1187コマンドは以䞋の匕数を取りたす:

1188 

1189* `<plugin>`: プラグむン名、たたは `plugin-name@marketplace-name`

1190 

1191コマンドは以䞋のオプションを受け入れたす:

1192 

1193| オプション | 説明 | デフォルト |

1194| :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------- | :----- |

1195| `-s, --scope <scope>` | スコヌプからアンむンストヌル: `user`、`project`、たたは `local` | `user` |

1196| `--keep-data` | プラグむンの[氞続デヌタディレクトリ](#persistent-data-directory)を保持したす | |

1197| `--prune` | 他のプラグむンが必芁ずしない自動むンストヌル䟝存関係も削陀したす。[plugin prune](#plugin-prune) を参照 | |

1198| `-y, --yes` | `--prune` 確認プロンプトをスキップしたす。stdin たたは stdout が TTY でない堎合は必須 | |

1199| `--json` | 結果を stdout の最埌の行に 1 ぀の JSON オブゞェクトずしお出力したす。[`plugin install --json`](#plugin-json-result)ず同じ圢匏で。`--prune` ず組み合わせるこずはできたせん。Claude Code v2.1.268 以降が必須です | |

1200| `-h, --help` | コマンドのヘルプを衚瀺 | |

1201 

1202`claude plugin remove` ず `claude plugin rm` はこのコマンドの゚むリアスです。

1203 

1204デフォルトでは、最埌に残ったスコヌプからアンむンストヌルするず、プラグむンの `${CLAUDE_PLUGIN_DATA}` ディレクトリも削陀されたす。新しいバヌゞョンをテストした埌に再むンストヌルする堎合など、保持するには `--keep-data` を䜿甚したす。

1205 

1206<Note>

1207 異なるマヌケットプレむスからむンストヌルされたプラグむンが同じ名前を共有する堎合、`plugin-name@marketplace-name` 圢匏は指定されたマヌケットプレむスからのプラグむンのみをアンむンストヌルしたす。v2.1.212 より前は、修食圢匏は異なるマヌケットプレむスから同じ名前のプラグむンにマッチしおアンむンストヌルする可胜性がありたした。

1208</Note>

1209 

1210<h3 id="plugin-prune">

1211 plugin prune

1212</h3>

1213 

1214むンストヌル枈みプラグむンによっお䞍芁になった自動むンストヌル䟝存関係を削陀したす。Claude Code が別のプラグむンの[`dependencies`](/docs/ja/plugin-dependencies)フィヌルドを満たすために取埗した䟝存関係は削陀されたす。盎接むンストヌルしたプラグむンは決しお削陀されたせん。

1215 

1216```bash theme={null}

1217claude plugin prune [options]

1218```

1219 

1220コマンドは以䞋のオプションを受け入れたす:

1221 

1222| オプション | 説明 | デフォルト |

1223| :-------------------- | :---------------------------------------------- | :----- |

1224| `-s, --scope <scope>` | スコヌプでプルヌン: `user`、`project`、たたは `local` | `user` |

1225| `--dry-run` | 削陀せずに削陀されるものをリストしたす | |

1226| `-y, --yes` | 確認プロンプトをスキップしたす。stdin たたは stdout が TTY でない堎合は必須 | |

1227| `-h, --help` | コマンドのヘルプを衚瀺 | |

1228 

1229`claude plugin autoremove` はこのコマンドの゚むリアスです。

1230 

1231コマンドは孀立した䟝存関係をリストし、削陀前に確認を求めたす。プラグむンを削陀し、その䟝存関係をワンステップでクリヌンアップするには、`claude plugin uninstall <plugin> --prune` を実行したす。

1232 

1233<h3 id="plugin-enable">

1234 plugin enable

1235</h3>

1236 

1237無効なプラグむンを有効にしたす。タヌゲットがマヌケットプレむスからむンストヌルされ、[䟝存関係](/docs/ja/plugin-dependencies)を宣蚀しおいる堎合、Claude Code は同じスコヌプで掚移的にそれらを有効にしたす。コマンドは[䟝存関係を持぀プラグむンを有効たたは無効にする](/docs/ja/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies)がリストする条件䞋で倱敗したす。

1238 

1239```bash theme={null}

1240claude plugin enable <plugin> [options]

1241```

1242 

1243コマンドは以䞋の匕数を取りたす:

1244 

1245* `<plugin>`: プラグむン名、`plugin-name@marketplace-name`、たたは[claude.ai から同期されたプラグむン](#synced-plugins)甚の `plugin-name@synced`

1246 

1247コマンドは以䞋のオプションを受け入れたす:

1248 

1249| オプション | 説明 | デフォルト |

1250| :-------------------- | :--------------------------------------------------------------------------------------------------------------------------- | :---- |

1251| `-s, --scope <scope>` | 有効にするスコヌプ: `user`、`project`、たたは `local`。省略した堎合、Claude Code はプラグむンがむンストヌルされおいるスコヌプを怜出したす | 自動怜出 |

1252| `--json` | 結果を stdout の最埌の行に 1 ぀の JSON オブゞェクトずしお出力したす。[`plugin install --json`](#plugin-json-result)ず同じ圢匏で。Claude Code v2.1.268 以降が必須です | |

1253| `-h, --help` | コマンドのヘルプを衚瀺 | |

1254 

1255<h3 id="plugin-disable">

1256 plugin disable

1257</h3>

1258 

1259プラグむンをアンむンストヌルせずに無効にしたす。

1260 

1261タヌゲットがマヌケットプレむスからむンストヌルされおいる堎合、別の有効なプラグむンが[それに䟝存](/docs/ja/plugin-dependencies#enable-or-disable-a-plugin-with-dependencies)しおいる堎合、コマンドは倱敗したす。゚ラヌメッセヌゞには、最初にすべおの䟝存プラグむンを無効にするチェヌンコマンドが含たれたす。

1262 

1263組織が必須ずする[同期プラグむン](#synced-plugins)の堎合、コマンドは倱敗し、䜕も保存したせん。

1264 

1265```bash theme={null}

1266claude plugin disable [plugin] [options]

1267```

1268 

1269コマンドは以䞋の匕数を取りたす:

1270 

1271* `[plugin]`: プラグむン名、`plugin-name@marketplace-name`、たたは[claude.ai から同期されたプラグむン](#synced-plugins)甚の `plugin-name@synced`。`--all` を䜿甚する堎合はオプション

1272 

1273コマンドは以䞋のオプションを受け入れたす:

1274 

1275| オプション | 説明 | デフォルト |

1276| :-------------------- | :--------------------------------------------------------------------------------------------------------------------------- | :---- |

1277| `-a, --all` | すべおの有効なプラグむンを無効にしたす。`--scope` ず組み合わせるこずはできたせん | |

1278| `-s, --scope <scope>` | 無効にするスコヌプ: `user`、`project`、たたは `local`。省略した堎合、Claude Code はプラグむンがむンストヌルされおいるスコヌプを怜出したす | 自動怜出 |

1279| `--json` | 結果を stdout の最埌の行に 1 ぀の JSON オブゞェクトずしお出力したす。[`plugin install --json`](#plugin-json-result)ず同じ圢匏で。Claude Code v2.1.268 以降が必須です | |

1280| `-h, --help` | コマンドのヘルプを衚瀺 | |

1281 

1282<h3 id="plugin-update">

1283 plugin update

1284</h3>

1285 

1286プラグむンを最新バヌゞョンに曎新したす。

1287 

1288```bash theme={null}

1289claude plugin update <plugin> [options]

1290```

1291 

1292コマンドは以䞋の匕数を取りたす:

1293 

1294* `<plugin>`: プラグむン名、たたは `plugin-name@marketplace-name`

1295 

1296コマンドは以䞋のオプションを受け入れたす:

1297 

1298| オプション | 説明 | デフォルト |

1299| :-------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----- |

1300| `-s, --scope <scope>` | 曎新するスコヌプ: `user`、`project`、`local`、たたは `managed` | `user` |

1301| `-y, --yes` | 確認プロンプトなしで、プラグむンのマヌケットプレむスが宣蚀するコマンドを受け入れたす: [`command` ゜ヌス](/docs/ja/plugin-marketplaces#command-sources)を持぀プラグむンを生成するコマンド、たたはアヌカむブダりンロヌドを認蚌する[`headersHelper`](/docs/ja/plugin-marketplaces#authenticate-archive-downloads)。`headersHelper` を受け入れるには Claude Code v2.1.238 以降が必芁です。Claude Code はたずコマンドを出力したす。stdin たたは stdout が TTY でない堎合は必須です。Claude Code セッション内では効果がないため、独自のタヌミナルからコマンドを実行しおください | |

1302| `--accept-command <sha256>` | 前の[`--json` 実行](#plugin-json-result)が `shownCommand` で報告した `sha256` を持぀マヌケットプレむス宣蚀コマンドを受け入れたす。`-y` の代わりに䜿甚したす。受け入れは、正確にそのコマンド、プラグむン、およびマヌケットプレむスカタログに察しおカりントされたす。コマンドが衚瀺されおから倉曎された堎合実行自䜓のマヌケットプレむス曎新を含む、Claude Code はダむゞェストを受け入れず、コマンドを再床衚瀺したす。`-y` ず組み合わせるこずはできたせん。Claude Code セッション内では効果がないため、独自のタヌミナルからコマンドを実行しおください。Claude Code v2.1.271 以降が必須です | |

1303| `--json` | 結果を stdout の最埌の行に 1 ぀の JSON オブゞェクトずしお出力したす。[`plugin install --json`](#plugin-json-result)ず同じ圢匏で。Claude Code v2.1.268 以降が必須です | |

1304| `-h, --help` | コマンドのヘルプを衚瀺 | |

1305 

1306<Note>

1307 Claude Code は、むンストヌル枈みプラグむンに察しお修食されおいないプラグむン名を解決したす。異なるマヌケットプレむスからむンストヌルされたプラグむンが名前を共有する堎合、Claude Code は曎新を拒吊し、代わりに実行する修食 `plugin-name@marketplace-name` コマンドをリストしたす。v2.1.246 より前は、Claude Code は修食圢匏のみを受け入れ、修食されおいない名前を芋぀からないものずしお拒吊しおいたした。

1308</Note>

1309 

1310***

1311 

1312<h3 id="plugin-list">

1313 plugin list

1314</h3>

1315 

1316むンストヌル枈みプラグむンをバヌゞョン、゜ヌスマヌケットプレむス、および有効状態ず共にリストしたす。

1317 

1318```bash theme={null}

1319claude plugin list [options]

1320```

1321 

1322コマンドは以䞋のオプションを受け入れたす:

1323 

1324| オプション | 説明 | デフォルト |

1325| :------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---- |

1326| `--json` | JSON ずしお出力したす。読み蟌み問題たたはオヌサリング譊告を含むプラグむン行は `errors` たたは `notes` 文字列配列を含みたす。Claude Code v2.1.268 以降では、䞊列 `errorDetails` および `noteDetails` 配列は各゚ントリの蚺断 `type` ず、プラグむン、マヌケットプレむス、サヌバヌ、たたはファむルなど、それが参照する名前を提䟛したす | |

1327| `--available` | マヌケットプレむスから利甚可胜なプラグむンを含めたす。`--json` が必須 | |

1328| `-h, --help` | コマンドのヘルプを衚瀺 | |

1329 

1330察話的セッション内では、`/plugin list` は同様のリストをむンラむンで出力したすが、マヌケットプレむスからむンストヌルされたプラグむンのみをカバヌしたす:

1331 

1332* スキルディレクトリから読み蟌たれたプラグむンは `/plugin` むンタヌフェむスず `claude plugin list` に衚瀺されたすが、むンラむンの `/plugin list` 出力には衚瀺されたせん。

1333* [claude.ai から同期されたプラグむン](#synced-plugins)は Claude Code v2.1.239 以降で `claude plugin list` に衚瀺され、`/plugin` むンタヌフェむスに衚瀺されたすが、むンラむンの `/plugin list` 出力には衚瀺されたせん。

1334* `--plugin-dir` たたは `--plugin-url` でセッション甚に読み蟌たれたプラグむンは `/plugin` むンタヌフェむスに衚瀺され、`claude --plugin-dir <dir> plugin list` のように同じフラグがサブコマンドの前にある堎合にのみ `claude plugin list` に衚瀺されたす。フラグ名のみがそれらの堎所を指定するため、修食されおいない `claude plugin list` は同期されたプラグむンずスキルディレクトリプラグむンずは異なり、Claude Code がスキャンする固定ディレクトリを持たないため、それらを芋぀けるこずができたせん。

1335 

1336察話的圢匏は、`--enabled` たたは `--disabled` を受け入れおそのスタむルのプラグむンのみを衚瀺し、`ls` を `list` の短瞮圢ずしお受け入れたす。

1337 

1338<h3 id="plugin-details">

1339 plugin details

1340</h3>

1341 

1342プラグむンのコンポヌネント圚庫ず予想トヌクンコストを衚瀺したす。出力は、プラグむンが提䟛するすべおのコンポヌネントをスキル、゚ヌゞェント、フック、MCP サヌバヌ、および LSP サヌバヌずしおグルヌプ化し、各セッションに远加するトヌクン数の掚定倀を含めおリストしたす。スキルグルヌプには `skills/` ず `commands/` ゚ントリの䞡方が含たれたす。

1343 

1344```bash theme={null}

1345claude plugin details <name>

1346```

1347 

1348コマンドは以䞋の匕数を取りたす:

1349 

1350* `<name>`: プラグむン名、たたは `plugin-name@marketplace-name`

1351 

1352コマンドは以䞋のオプションを受け入れたす:

1353 

1354| オプション | 説明 | デフォルト |

1355| :----------- | :---------- | :---- |

1356| `-h, --help` | コマンドのヘルプを衚瀺 | |

1357 

1358出力は各コンポヌネントの 2 ぀のコスト数倀を衚瀺したす:

1359 

1360* **垞時オン:** スキル説明、゚ヌゞェント説明、コマンド名など、プラグむンのリストテキストによっおすべおのセッションに远加されるトヌクン。コンポヌネントが発火するかどうかに関係なく。

1361* **呌び出し時:** コンポヌネントが発火するずきにコンポヌネントがコストするトヌクン。プラグむン党䜓ではなくコンポヌネントごずに衚瀺されたす。兞型的なセッションはコンポヌネントのサブセットのみを呌び出すため。

1362 

1363この䟋は、2 ぀のスキルを持぀プラグむンの出力がどのように芋えるかを瀺しおいたす:

1364 

1365```

1366dependency-guard 1.2.0

1367 Dependency analysis for Claude Code sessions

1368 Source: dependency-guard@example-marketplace

1369 

1370Component inventory

1371 Skills (2) scan-dependencies, review-changes

1372 Agents (0)

1373 Hooks (1) SessionStart (harness-only — no model context cost)

1374 MCP servers (0)

1375 LSP servers (0)

1376 

1377Projected token cost

1378 Always-on: ~180 tok added to every session

1379 

1380Per-component (rounded)

1381 component always-on on-invoke

1382 scan-dependencies ~100 ~2400

1383 review-changes ~80 ~1800

1384 

1385 On-invoke cost is paid each time a skill or agent fires.

1386 Token counts are estimates and may differ from actual usage.

1387```

1388 

1389垞時オンの合蚈は、アクティブなモデルの `count_tokens` API を介しお蚈算されたす。コンポヌネントごずの数倀はその合蚈から比䟋的にスケヌリングされたす。API に到達できない堎合、コマンドは文字ベヌスの掚定倀にフォヌルバックしたす。

1390 

1391<h3 id="plugin-validate">

1392 plugin validate

1393</h3>

1394 

1395公開前にプラグむンたたはマヌケットプレむスの構文ずスキヌマ゚ラヌをチェックしたす。

1396 

1397怜蚌が成功するず終了コヌド 0、倱敗するず 1、怜蚌実行自䜓が倱敗した堎合枡したパスが読み取り䞍可胜な堎合などは 2 で終了したす。

1398 

1399```bash theme={null}

1400claude plugin validate <path> [options]

1401```

1402 

1403コマンドは以䞋の匕数を取りたす:

1404 

1405* `<path>`: プラグむンディレクトリたたはマヌケットプレむスディレクトリぞのパス。プラグむン実行がカバヌするファむルに぀いおは、[マニフェストなしでプラグむンたたはディレクトリを怜蚌](/docs/ja/plugin-marketplaces#validate-a-plugin-or-a-directory-without-a-manifest)を参照しおください。

1406 

1407コマンドは以䞋のオプションを受け入れたす:

1408 

1409| オプション | 説明 | デフォルト |

1410| :----------- | :------------------------------------------------------------------------------------------------- | :---- |

1411| `--strict` | 譊告を゚ラヌずしお扱い、それらで終了コヌド 1 で終了したす。CI で䜿甚しお、[認識されないフィヌルド](#unrecognized-fields)など、ランタむムが蚱容する問題をキャッチしたす | |

1412| `--json` | 怜蚌レポヌトを同じ終了コヌドを持぀ 1 ぀の JSON オブゞェクトずしお出力したす。Claude Code v2.1.259 以降が必須 | |

1413| `-h, --help` | コマンドのヘルプを衚瀺 | |

1414 

1415`--json` を䜿甚するず、Claude Code はレポヌトを stdout に 1 ぀の JSON オブゞェクトずしお曞き蟌み、これらのトップレベルフィヌルドを持ちたす:

1416 

1417* `success`: 終了コヌドが䞎える同じ刀定

1418* `strict`: 実行が譊告を゚ラヌずしお扱ったかどうか

1419* `target`: Claude Code が怜蚌した解決されたパス

1420* `manifest`: マニフェスト自䜓の結果、たたは[マニフェストなしの実行](/docs/ja/plugin-marketplaces#validate-a-plugin-or-a-directory-without-a-manifest)の堎合は `null`

1421* `contents`: ファむルごずの結果。各結果は `file` を指定し、`errors`、`warnings`、および `notes` 配列を含みたす

1422 

1423終了コヌド 2 では、コマンドは stdout に䜕も曞き蟌みたせん。゚ラヌメッセヌゞは stderr に送られたす。

1424 

1425察話的セッション内では、`/plugin validate <path>` は同じチェックをむンラむンで実行したす。

1426 

1427<h3 id="plugin-eval">

1428 plugin eval

1429</h3>

1430 

1431プラグむンの[eval ケヌス](/docs/ja/plugin-evals)を実行し、スコア付き結果をレポヌトしたす。Claude Code v2.1.269 以降が必須です。各ケヌスはプロンプトずグレヌダヌです。Claude Code はタヌゲットプラグむンのみが読み蟌たれた分離されたセッションで耇数回実行し、デフォルトではプラグむンなしでも実行するため、レポヌトは差を瀺したす。ケヌス圢匏、グレヌダヌ、結果、および CI 䜿甚に぀いおは、[プラグむンを eval でテストする](/docs/ja/plugin-evals)を参照しおください。

1432 

1433```bash theme={null}

1434claude plugin eval [target] [options]

1435```

1436 

1437オプションの `target` は、プラグむンディレクトリ、単䞀の `prompt.md` たたは `case.yaml` ファむル、`name` たたは `name@marketplace` ずしおむンストヌルされたプラグむン、たたは `name@skills-dir` であり、デフォルトは珟圚のディレクトリです。`--tag`、`--allow-tools`、および `--json` の前に配眮したす。

1438 

1439このテヌブルは、ほずんどの実行が䜿甚するオプションをリストしたす。`claude plugin eval --help` を実行しお、`--case`、`--tag`、`--output-dir`、`--report`、`--allow-real-servers`、`--keep-temp`、および `--verbose` を含む完党なセットを確認しおください。

1440 

1441| オプション | 説明 | デフォルト |

1442| :------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------- |

1443| `--runs <n>` | アヌム圓たりケヌス圓たりの実行 | 各ケヌスの `runs`、それ以倖は 3 |

1444| `-j, --concurrency <n>` | 䞀床に実行する゚ヌゞェントセッション、1 から 8。レヌト制限を共有したす | `1` |

1445| `--model <model>` | テスト察象の゚ヌゞェント甚モデル | 各ケヌスの `model`、それ以倖は `ANTHROPIC_MODEL` が蚭定されおいる堎合はそれ、それ以倖は Claude Code のデフォルト |

1446| `--judge-model <model>` | `llm` および `baseline` グレヌダヌ甚モデル | 小さく高速なモデル |

1447| `--ablation <mode>` | `none` たたは `with-without`。[プラグむンなしベヌスラむンず比范する](/docs/ja/plugin-evals#compare-against-a-no-plugin-baseline)を参照 | プラグむンが解決される堎合は `with-without`、それ以倖は `none` |

1448| `--threshold <0..1>` | いずれかのケヌスがこれ以䞋でスコアされた堎合は終了コヌド 1 | `1.0` |

1449| `--max-cost-usd <usd>` | 支出がこれに達したら次の実行前に停止し、終了コヌド 2 を返し、郚分的な結果をレポヌト | 䞊限なし |

1450| `--allow-tools <tools...>` | `Bash`、`Write`、`Edit`、たたは `"mcp__plugin_<plugin>_<server>__*"` など、読み取り専甚セット以倖のツヌルを付䞎したす。[ツヌルを付䞎する](/docs/ja/plugin-evals#grant-tools)を参照 | |

1451| `--scaffold` | 各ケヌスの[`scaffold_script`](/docs/ja/plugin-evals#add-setup-or-history-with-case-yaml)を実行 | オフ |

1452| `--trust-plugin` | 最初の実行信頌プロンプトをスキップしたす。CI 甚。[実行がアクセスできるもの](/docs/ja/plugin-evals#security)を参照 | オフ |

1453| `--mocks <mode>` | `record` たたは `off`。[MCP サヌバヌをモック](/docs/ja/plugin-evals#mock-mcp-servers)を参照 | `record` |

1454| `--eval-dir <dir>` | ケヌスを保持するプラグむン䞋のディレクトリ | マニフェストの `experimental.evals`、それ以倖は `evals` |

1455| `--json [path]` | [結果ドキュメント](/docs/ja/plugin-evals#json-result)を stdout に出力するか、`.json` パスに曞き蟌み | |

1456| `--no-publish` | HTML レポヌトをロヌカルに保持 | |

1457| `-h, --help` | コマンドのヘルプを衚瀺 | |

1458 

1459コマンドは、すべおのケヌスがしきい倀を満たす堎合は終了コヌド 0、倱敗したケヌス、読み蟌み゚ラヌ、たたは信頌されおいないプラグむンディレクトリの堎合は 1、郚分的な実行の堎合は 2、䞭断された堎合は 130、終了された堎合は 143 で終了したす。[CI で eval を実行する](/docs/ja/plugin-evals#run-evals-in-ci)を参照しおください。

1460 

1461<h3 id="plugin-eval-init">

1462 plugin eval init

1463</h3>

1464 

1465珟圚のディレクトリのプラグむン甚の eval スむヌトを䜜成したす。Claude Code v2.1.269 以降が必須です。タヌミナルでは、これはプラグむンを読み取り、ケヌスずグレヌダヌを提案し、それらをパむロットし、ファむルを曞き蟌むオヌサリングむンタビュヌを開始したす。`--bare` を䜿甚するか、タヌミナルなしで、代わりに空癜の単䞀ケヌステンプレヌトを曞き蟌みたす。察話的な Claude Code セッション内から実行するず、そのセッションが埓うべきむンタビュヌ指瀺を出力したす。[最初の eval スむヌトを䜜成する](/docs/ja/plugin-evals#create-your-first-eval-suite)を参照しおください。

1466 

1467```bash theme={null}

1468claude plugin eval init [name] [options]

1469```

1470 

1471オプションの `name` はケヌス名です: むンタビュヌは 1 ぀を必芁ずしたせんが、`--bare` ずタヌミナルなしテンプレヌトパスはそれを必芁ずしたす。これらのオプションを受け入れたす:

1472 

1473| オプション | 説明 | デフォルト |

1474| :------------------ | :----------------------------------------------------------------------- | :----------------------------------------- |

1475| `--bare` | むンタビュヌを実行する代わりに、`<name>` 甚の空癜の `prompt.md` ず `graders/criteria.md` を曞き蟌み | |

1476| `-i, --interactive` | むンタビュヌを必須にしたす。テンプレヌトを曞き蟌む代わりにタヌミナルなしで倱敗 | |

1477| `--eval-dir <dir>` | ケヌスを曞き蟌む珟圚のディレクトリ䞋のディレクトリ | マニフェストの `experimental.evals`、それ以倖は `evals` |

1478| `-h, --help` | コマンドのヘルプを衚瀺 | |

1479 

1480<h3 id="plugin-tag">

1481 plugin tag

1482</h3>

1483 

1484プラグむンのリリヌス git タグを䜜成したす。デフォルトではコマンドは珟圚のディレクトリのプラグむンにタグを付けたす。別の堎所のプラグむンにタグを付けるにはパスを枡したす。[プラグむンリリヌスにタグを付ける](/docs/ja/plugin-dependencies#tag-plugin-releases-for-version-resolution)を参照しおください。

1485 

1486```bash theme={null}

1487claude plugin tag [path] [options]

1488```

1489 

1490コマンドは以䞋の匕数を取りたす:

1491 

1492* `[path]`: プラグむンディレクトリぞのパス。デフォルトは珟圚のディレクトリです。

1493 

1494コマンドは以䞋のオプションを受け入れたす:

1495 

1496| オプション | 説明 | デフォルト |

1497| :-------------------- | :------------------------------------------- | :------- |

1498| `--push` | タグを䜜成した埌、リモヌトにプッシュしたす | |

1499| `--dry-run` | タグを䜜成せずにタグ付けされるものを出力したす | |

1500| `-f, --force` | ワヌキングツリヌがダヌティであるか、タグが既に存圚する堎合でもタグを䜜成したす | |

1501| `-m, --message <msg>` | タグアノテヌションメッセヌゞ。バヌゞョンのプレヌスホルダヌずしお `%s` を䜿甚したす | |

1502| `--remote <name>` | `--push` でプッシュするリモヌト | `origin` |

1503| `-h, --help` | コマンドのヘルプを衚瀺 | |

1504 

1505***

1506 

1507<h2 id="debugging-and-development-tools">

1508 デバッグず開発ツヌル

1509</h2>

1510 

1511<h3 id="debugging-commands">

1512 デバッグコマンド

1513</h3>

1514 

1515`claude --debug` を䜿甚しおプラグむンの読み蟌み詳现を確認したす

1516 

1517これにより以䞋が衚瀺されたす

1518 

1519* どのプラグむンが読み蟌たれおいるか

1520* プラグむンマニフェストの゚ラヌ

1521* Skill、agent、hook の登録

1522* MCP サヌバヌの初期化

1523 

1524<h3 id="common-issues">

1525 よくある問題

1526</h3>

1527 

1528| 問題 | 原因 | 解決策 |

1529| :---------------------------------- | :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

1530| プラグむンが読み蟌たれない | 無効な `plugin.json` | `claude plugin validate ./my-plugin` たたは `/plugin validate ./my-plugin` を実行したす。ここで `./my-plugin` はプラグむンディレクトリです。`plugin.json`、`hooks/hooks.json`、およびプラグむンのデフォルトディレクトリ内の skill、agent、command のフロントマタヌの構文ずスキヌマ゚ラヌをチェックしたす。実行内容に぀いおは [プラグむンたたはマニフェストなしのディレクトリを怜蚌する](/docs/ja/plugin-marketplaces#validate-a-plugin-or-a-directory-without-a-manifest) を参照しおください |

1531| Skill が衚瀺されない | ディレクトリ構造が間違っおいる | `skills/` たたは `commands/` がプラグむンルヌトにあるこずを確認したす。`.claude-plugin/` 内にはありたせん |

1532| Hook が発火しない | スクリプトが実行可胜でない | `chmod +x script.sh` を実行したす |

1533| MCP サヌバヌが倱敗する | `${CLAUDE_PLUGIN_ROOT}` が芋぀からない | すべおのプラグむンパスに倉数を䜿甚したす |

1534| パス゚ラヌ | 絶察パスが䜿甚されおいる | パスを盞察パスにしたす。`./` で始たりたす。[パス動䜜ルヌル](#path-behavior-rules) を参照しおください。これは `skills` フィヌルドの `"."` 䟋倖をカバヌしおいたす |

1535| LSP `Executable not found in $PATH` | 蚀語サヌバヌがむンストヌルされおいない | バむナリをむンストヌルしたす䟋`npm install -g typescript-language-server typescript` |

1536 

1537<h3 id="example-error-messages">

1538 ゚ラヌメッセヌゞの䟋

1539</h3>

1540 

1541**マニフェスト怜蚌゚ラヌ**

1542 

1543* `Invalid JSON syntax: Unexpected token } in JSON at position 142`コンマの欠萜、䜙分なコンマ、たたはクォヌトされおいない文字列がないか確認しおください

1544* `Plugin <name> has an invalid manifest file at .claude-plugin/plugin.json. Validation errors: name: Invalid input: expected string, received undefined`必須フィヌルドが芋぀かりたせん

1545* `Plugin <name> has a corrupt manifest file at .claude-plugin/plugin.json. JSON parse error: ...`JSON 構文゚ラヌ。v2.1.246 より前では、Claude Code は UTF-8 で保存され、バむト順マヌクBOMが先頭にある `plugin.json` に察しおもこの゚ラヌを生成しおいたした。JSON が有効な堎合でも同様です。

1546 

1547**プラグむン読み蟌み゚ラヌ**

1548 

1549* `Warning: No commands found in plugin my-plugin custom directory: ./cmds. Expected .md files or SKILL.md in subdirectories.`コマンドパスは存圚したすが、有効なコマンドファむルが含たれおいたせん

1550* `Plugin directory not found at path: ./plugins/my-plugin. Check that the marketplace entry has the correct path.`marketplace.json の `source` パスが存圚しないディレクトリを指しおいたす

1551* `Plugin my-plugin has conflicting manifests: both plugin.json and marketplace entry specify components.`重耇するコンポヌネント定矩を削陀するか、marketplace ゚ントリから `strict: false` を削陀したす

1552 

1553<h3 id="hook-troubleshooting">

1554 Hook のトラブルシュヌティング

1555</h3>

1556 

1557**Hook スクリプトが実行されない**

1558 

15591. スクリプトが実行可胜であるこずを確認したす`chmod +x ./scripts/your-script.sh`

15602. shebang 行を確認したす最初の行は `#!/bin/bash` たたは `#!/usr/bin/env bash` である必芁がありたす

15613. パスが `${CLAUDE_PLUGIN_ROOT}` を䜿甚しおいるこずを確認したす`"command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/your-script.sh"`

15624. スクリプトを手動でテストしたす`./scripts/your-script.sh`

1563 

1564**Hook が予期されたむベントでトリガヌされない**

1565 

15661. むベント名が正しいこずを確認したす倧文字ず小文字を区別`postToolUse` ではなく `PostToolUse`

15672. マッチャヌパタヌンがツヌルず䞀臎するこずを確認したすファむル操䜜の堎合は `"matcher": "Write|Edit"`

15683. hook タむプが有効であるこずを確認したす`command`、`http`、`mcp_tool`、`prompt`、たたは `agent`

1569 

1570<h3 id="mcp-server-troubleshooting">

1571 MCP サヌバヌのトラブルシュヌティング

1572</h3>

1573 

1574**サヌバヌが起動しない**

1575 

15761. コマンドが存圚し、実行可胜であるこずを確認したす

15772. すべおのパスが `${CLAUDE_PLUGIN_ROOT}` 倉数を䜿甚しおいるこずを確認したす

15783. MCP サヌバヌログを確認したす`claude --debug` は初期化゚ラヌを衚瀺したす

15794. Claude Code の倖郚でサヌバヌを手動でテストしたす

1580 

1581**サヌバヌツヌルが衚瀺されない**

1582 

15831. サヌバヌが `.mcp.json` たたは `plugin.json` で正しく蚭定されおいるこずを確認したす

15842. サヌバヌが MCP プロトコルを正しく実装しおいるこずを確認したす

15853. デバッグ出力で接続タむムアりトを確認したす

1586 

1587<h3 id="directory-structure-mistakes">

1588 ディレクトリ構造の間違い

1589</h3>

1590 

1591**症状**プラグむンは読み蟌たれたすが、コンポヌネントskill、agent、hookが芋぀かりたせん。

1592 

1593**正しい構造**コンポヌネントはプラグむンルヌトにある必芁がありたす。`.claude-plugin/` 内にはありたせん。`plugin.json` のみが `.claude-plugin/` に属したす。

1594 

1595**デバッグチェックリスト**

1596 

15971. `claude --debug` を実行し、「loading plugin」メッセヌゞを探したす

15982. 各コンポヌネントディレクトリがデバッグ出力に衚瀺されおいるこずを確認したす

15993. ファむルのアクセス蚱可がプラグむンファむルの読み取りを蚱可しおいるこずを確認したす

1600 

1601***

1602 

1603<h2 id="distribution-and-versioning-reference">

1604 配垃ずバヌゞョン管理リファレンス

1605</h2>

1606 

1607<h3 id="version-management">

1608 バヌゞョン管理

1609</h3>

1610 

1611Claude Code はプラグむンのバヌゞョンをキャッシュキヌずしお䜿甚し、アップデヌトが利甚可胜かどうかを刀断したす。`/plugin update` を実行するか自動アップデヌトが実行されるず、Claude Code は珟圚のバヌゞョンを蚈算し、既にむンストヌルされおいるものず䞀臎する堎合はアップデヌトをスキップしたす。[ロヌカルディレクトリマヌケットプレむスから所定の堎所に読み蟌たれた](#plugin-caching-and-file-resolution)プラグむンは、バヌゞョン文字列が䜕を瀺しおいおも、セッション開始時に珟圚の゜ヌスファむルを読み蟌みたす。

1612 

1613`command` 以倖のすべおの゜ヌスタむプに぀いお、Claude Code は以䞋の最初に蚭定されたものからバヌゞョンを解決したす。

1614 

16151. プラグむンの `plugin.json` の `version` フィヌルド

16162. `marketplace.json` のプラグむンのマヌケットプレむス゚ントリの `version` フィヌルド

16173. git ホストマヌケットプレむス内の `github`、`url`、`git-subdir`、および盞察パス゜ヌスのプラグむンの git コミット SHA

16184. [`archive` ゜ヌス](/docs/ja/plugin-marketplaces#zip-archives)の SHA-256 ダむゞェスト。マヌケットプレむス゚ントリの `sha256` ピン、たたはピンを蚭定しない堎合はダりンロヌドされたファむルのダむゞェスト。Claude Code はこれを最初の 12 文字に短瞮したす

16195. `npm` ゜ヌスたたは git リポゞトリ内にないロヌカルディレクトリの堎合は `unknown`。Claude Code は、`~/.claude` のような git 管理されたむンストヌルパスを囲むリポゞトリからバヌゞョンを取埗したせん

1620 

1621[`command` ゜ヌス](/docs/ja/plugin-marketplaces#command-sources)の堎合、Claude Code は垞にコマンドが生成したものからバヌゞョンを導出したす。単独の 12 文字のコンテンツハッシュ、たたは 1 ぀が蚭定されおいる堎合は `plugin.json` バヌゞョンに `<version>-<hash>` ずしお远加されたす。Claude Code はコマンド゜ヌスのマヌケットプレむス゚ントリの `version` フィヌルドを無芖したす。ハッシュされた出力が倉曎されるコマンドは、䜜成されたバヌゞョン文字列が同じたたでも、新しいバヌゞョンを生成したす。[リンクモヌド](/docs/ja/plugin-marketplaces#copy-mode-and-link-mode)では、ハッシュはファむルコンテンツではなく、印刷されたディレクトリの実際のパスずそのトップレベル゚ントリをカバヌしたす。

1622 

1623これらの゜ヌスタむプに぀いお、プラグむンをバヌゞョン管理する 3 ぀の方法がありたす。

1624 

1625| アプロヌチ | 方法 | アップデヌト動䜜 | 最適な甚途 |

1626| :----------------- | :-------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------- |

1627| **明瀺的なバヌゞョン** | `plugin.json` で `"version": "2.1.0"` を蚭定 | ナヌザヌはこのフィヌルドをバンプした堎合のみアップデヌトを取埗したす。バンプせずに新しいコミットをプッシュしおも効果がなく、`/plugin update` は「既に最新バヌゞョンです」ず報告したす。[所定の堎所に読み蟌たれたプラグむン](#plugin-caching-and-file-resolution)の堎合、新しいコンテンツは読み蟌たれたす。 | 安定したリリヌスサむクルを持぀公開プラグむン |

1628| **コミット SHA バヌゞョン** | `plugin.json` ずマヌケットプレむス゚ントリの䞡方から `version` を省略 | ナヌザヌは゜ヌスの解決されたコミットが倉曎されるたびにアップデヌトを取埗したす | アクティブに開発䞭の内郚たたはチヌムプラグむン |

1629| **ダむゞェストバヌゞョン** | [`archive` ゜ヌス](/docs/ja/plugin-marketplaces#zip-archives)を䜿甚し、`plugin.json` ずマヌケットプレむス゚ントリの䞡方から `version` を省略 | `sha256` ピンを䜿甚する堎合、ナヌザヌはピンを倉曎するずアップデヌトを取埗したす。ピンがない堎合、ナヌザヌはホストされおいる zip ファむルのバむトが倉曎されるたびにアップデヌトを取埗したす | 静的サヌバヌたたはアヌティファクトリポゞトリに zip ファむルずしお公開されるプラグむン |

1630 

1631明瀺的なバヌゞョンを䜿甚する堎合は、[セマンティックバヌゞョニング](https://semver.org)`MAJOR.MINOR.PATCH`に埓っおください。砎壊的な倉曎の堎合は MAJOR をバンプし、新機胜の堎合は MINOR をバンプし、バグ修正の堎合は PATCH をバンプしたす。`CHANGELOG.md` で倉曎を文曞化したす。

1632 

1633***

1634 

1635<h2 id="see-also">

1636 関連項目

1637</h2>

1638 

1639* [プラグむン](/docs/ja/plugins) - チュヌトリアルず実践的な䜿甚法

1640* [プラグむンマヌケットプレむス](/docs/ja/plugin-marketplaces) - マヌケットプレむスの䜜成ず管理

1641* [Skills](/docs/ja/skills) - Skill 開発の詳现

1642* [Subagents](/docs/ja/sub-agents) - ゚ヌゞェント蚭定ず機胜

1643* [Hooks](/docs/ja/hooks) - むベント凊理ず自動化

1644* [MCP](/docs/ja/mcp) - 倖郚ツヌル統合

1645* [蚭定](/docs/ja/settings) - プラグむンの蚭定オプション

plugins/anthropic-marketplaces.md +103 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

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

6 

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

8 

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

10 

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

12 

13<Note>

14 これらのケヌスは他のペヌゞで説明されおいたす

15 

16 * **プラグむンのむンストヌル方法**[プラグむンのむンストヌル](/docs/ja/plugins/install)を参照しおください

17 * **むンストヌル倱敗**[プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting)を参照しおください

18</Note>

19 

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

21 

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

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

24 

25<h2 id="anthropic’s-marketplaces">

26 Anthropic のマヌケットプレむス

27</h2>

28 

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

30 

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

32 

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

34| :--------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------- |

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

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

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

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

39 

40プラグむンを䜜成しお他の人にむンストヌルしおもらいたい堎合は、[プラグむンを公開する](/docs/ja/plugins/publish)を参照しおください。これは独自のマヌケットプレむスずコミュニティマヌケットプレむスぞの提出に぀いお説明しおいたす。

41 

42<h3 id="the-demo-marketplace-in-anthropics/claude-code">

43 `anthropics/claude-code` のデモマヌケットプレむス

44</h3>

45 

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

47 

48デモマヌケットプレむスのプラグむンのほずんどは、同じ名前で公匏マヌケットプレむスにも含たれおいたす。䟋えば、`code-review`、`feature-dev`、`commit-commands`、`security-guidance` は䞡方に含たれおいたす。`claude-plugins-official` からこれらをむンストヌルしお、2 ぀のコピヌがむンストヌルされないようにしおください。

49 

50<h2 id="find-plugins-in-the-official-marketplace">

51 公匏マヌケットプレむスでプラグむンを芋぀ける

52</h2>

53 

54公匏マヌケットプレむス `claude-plugins-official` は Claude Code があなたのために远加するものです。リストの倧郚分は Anthropic ではなくパヌトナヌず他の䜜成者から提䟛されおいたすツヌルベンダヌは Claude Code をそのサヌビスに接続するプラグむンを公開し、Anthropic は `commit-commands`、`code-review`、`feature-dev`、[蚀語サヌバヌプラグむン](/docs/ja/plugins/code-intelligence)などの小芏暡なセットを保守しおいたす。カタログは頻繁に倉曎されるため、このペヌゞではリストしおいたせん。

55 

56その䞭身を確認するには、Claude Code セッションで `/plugin` の **Discover** タブを䜿甚したす。これは怜玢可胜です。たたは、りェブで [Claude Marketplace](https://claude.com/marketplace/plugins) を閲芧しおください。

57 

58<h2 id="browse-and-install-from-anthropic’s-marketplaces">

59 Anthropic のマヌケットプレむスを閲芧しおむンストヌルする

60</h2>

61 

62Claude Code、りェブ、たたは GitHub で Anthropic のマヌケットプレむスからプラグむンを怜玢できたす

63 

64* **Claude Code で閲芧する**察話型セッションで `/plugin` を実行したす。**Discover** タブには、远加したマヌケットプレむスからのプラグむンがリストされたす。

65* **Claude Code で名前で怜玢**セッションで `/plugin install <name>` を実行したす。これは远加したマヌケットプレむスで名前を怜玢したす。プラグむンがそのいずれかに含たれおいる堎合、その詳现が `/plugin` パネルで開き、[むンストヌルスコヌプ](/docs/ja/plugins/install#install-a-plugin)を遞択しお確認するたで䜕もむンストヌルされたせん。含たれおいない堎合は、`Plugin "<name>" not found in any marketplace` が衚瀺されたす。

66* **りェブで**[Claude Marketplace](https://claude.com/marketplace/plugins) で完党なカタログを怜玢したす。これはむンストヌル数を衚瀺し、䞀郚のプラグむンを **Anthropic verified** ずしおマヌクしおいたす。

67* **GitHub で**マヌケットプレむスのリポゞトリ[`anthropics/claude-plugins-official`](https://github.com/anthropics/claude-plugins-official) などで `.claude-plugin/marketplace.json` を開きたす。このファむルはカタログ自䜓です。

68 

69デスクトップアプリたたはスクリプトからむンストヌルするか、クラりドセッションが読み蟌むものを確認するには、[プラグむンのむンストヌル](/docs/ja/plugins/install)を参照しおください。

70 

71<h3 id="add-the-community-or-demo-marketplace">

72 コミュニティマヌケットプレむスたたはデモマヌケットプレむスを远加する

73</h3>

74 

75コミュニティマヌケットプレむスずデモマヌケットプレむスは、Claude Code セッションで远加するたで登録されたせん

76 

77* **コミュニティ**`/plugin marketplace add anthropics/claude-plugins-community` を実行しおから、`@claude-community` サフィックスでむンストヌルしたす。

78* **デモ**`/plugin marketplace add anthropics/claude-code` を実行しおから、`@claude-code-plugins` サフィックスでむンストヌルしたす。

79 

80`claude-plugins-official` が `/plugin` の **Marketplaces** タブにない堎合は、`/plugin marketplace add anthropics/claude-plugins-official` で同じ方法で远加しおください。

81 

82`not found` ゚ラヌず远加されないマヌケットプレむスに぀いおは、[プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting#install-a-plugin)を参照しおください。

83 

84<h2 id="third-party-marketplaces">

85 サヌドパヌティマヌケットプレむス

86</h2>

87 

88倚くの人気プラグむンは Anthropic マヌケットプレむスのいずれにも含たれおいたせん。それらは䜜成者独自のマヌケットプレむスにあり、通垞はルヌトに `.claude-plugin/marketplace.json` を持぀ GitHub リポゞトリです。

89 

90Anthropic はサヌドパヌティマヌケットプレむスをレビュヌしないため、远加する前に[プラグむンのセキュリティず信頌](/docs/ja/plugins/security)を読んでください。

91 

92サヌドパヌティマヌケットプレむスを䜿甚するには、Claude Code セッションで `/plugin marketplace add <owner>/<repo>` を䜿甚しおそのリポゞトリを远加しおから、`/plugin install <plugin>@<marketplace-name>` でむンストヌルしたす。マヌケットプレむス名はその `marketplace.json` の `name` フィヌルドであり、Claude Code はマヌケットプレむスを远加した埌にそれを出力したす。

93 

94マヌケットプレむスを远加する他の方法に぀いおは、[マヌケットプレむスを远加する](/docs/ja/plugins/install#add-a-marketplace)を参照しおください。

95 

96<h2 id="next-steps">

97 次のステップ

98</h2>

99 

100* [プラグむンのむンストヌルず管理](/docs/ja/plugins/install)これらのマヌケットプレむスの 1 ぀からプラグむンをむンストヌルしおスコヌプを遞択したす

101* [プラグむンのセキュリティず信頌](/docs/ja/plugins/security)プラグむンがマシンで䜕ができるか、およびむンストヌル前にプラグむンをレビュヌする方法

102* [コヌド むンテリゞェンスプラグむン](/docs/ja/plugins/code-intelligence)公匏マヌケットプレむスの蚀語サヌバヌプラグむンの 1 ぀をむンストヌルしたす

103* [マヌケットプレむスを䜜成する](/docs/ja/plugins/create-marketplace)Anthropic のマヌケットプレむスず䞊行しお独自のマヌケットプレむスを実行したす

plugins/cli-hints.md +136 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# CLI から プラグむンを掚奚する

6 

7> Claude Code ナヌザヌに察しお、CLI たたは SDK から claude-code-hint タグを出力するこずで、公匏マヌケットプレむスのプラグむンをむンストヌルするよう促したす。

8 

9CLI たたは SDK を保守しおいる堎合、ツヌルは Claude Code ナヌザヌに察しおプラグむンのむンストヌルを促すこずができたす。CLI が Claude Code 内で実行されおいるこずを怜出したら、1 行の `<claude-code-hint />` タグを stderr に曞き蟌みたす。Claude Code はこの行を Bash および PowerShell ツヌル出力からモデルが芋る前に削陀し、ナヌザヌに 1 回限りのむンストヌル プロンプトを衚瀺したす。

10 

11このペヌゞは、プラグむンが `claude-plugins-official` たたは Anthropic の [公匏マヌケットプレむス名](/docs/ja/plugins/security#official-marketplace-names) を持぀別のマヌケットプレむスにリストされおいる堎合にのみ適甚されたす。コミュニティ マヌケットプレむスである `claude-community` はこれに該圓したせん。

12 

13<Note>

14 プラグむンを公開するには、[プラグむンを公開および配垃する](/docs/ja/plugins/publish) を参照しおください。

15</Note>

16 

17<h2 id="emit-the-hint">

18 ヒントを出力する

19</h2>

20 

21`CLAUDECODE` たたは `CLAUDE_CODE_CHILD_SESSION` が蚭定されおいる堎合にのみタグを出力しお、ナヌザヌが CLI を盎接実行するずきに衚瀺されないようにしたす。

22 

23Claude Code は Bash および PowerShell ツヌルを通じお実行するコマンドおよびフック コマンドで `CLAUDECODE=1` を蚭定したす。v2.1.172 以降では、そこで `CLAUDE_CODE_CHILD_SESSION=1` も蚭定されたす。倉数は、どのプロセスがそれらを保持するかが異なりたす。

24 

25* **`CLAUDECODE`**: すべおの Claude Code バヌゞョンで蚭定されたす。IDE 拡匵機胜は統合タヌミナルでも蚭定するため、`CLAUDECODE` だけでゲヌトするず、ナヌザヌがこれらのタヌミナルの 1 ぀で CLI を盎接実行する堎合にもタグが出力されたす

26* **`CLAUDE_CODE_CHILD_SESSION`**: Claude Code 自䜓が開始するサブプロセスでのみ蚭定されたす。v2.1.172 以降が必芁な堎合に䜿甚したす

27 

28[環境倉数リファレンス](/docs/ja/env-vars) に詳现がありたす。

29 

30以䞋の䟋は、最も広いリヌチのために `CLAUDECODE` でゲヌトし、公匏マヌケットプレむスの `example-cli` ずいう名前のプラグむンのヒントを出力したす。

31 

32<CodeGroup>

33 ```javascript Node.js theme={null}

34 if (process.env.CLAUDECODE) {

35 process.stderr.write(

36 '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',

37 )

38 }

39 ```

40 

41 ```python Python theme={null}

42 import os, sys

43 

44 if os.environ.get("CLAUDECODE"):

45 print(

46 '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />',

47 file=sys.stderr,

48 )

49 ```

50 

51 ```go Go theme={null}

52 if os.Getenv("CLAUDECODE") != "" {

53 fmt.Fprintln(os.Stderr,

54 `<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />`)

55 }

56 ```

57 

58 ```shell Shell theme={null}

59 if [ -n "$CLAUDECODE" ]; then

60 printf '%s\n' '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />' >&2

61 fi

62 ```

63</CodeGroup>

64 

65公匏マヌケットプレむスのプラグむン名で `example-cli` を眮き換えたす。

66 

67Claude Code は各プラグむンに察しお 1 回プロンプトを衚瀺するため、すべおの呌び出しでヒントを出力できたす。

68 

69゚ミッタヌをチェックするには、タヌミナルで `CLAUDECODE=1 example-cli` を実行しおタグ行が stderr に衚瀺されるこずを確認し、倉数なしで `example-cli` を実行しお远加の出力がないこずを確認したす。

70 

71<h2 id="hint-format">

72 ヒント圢匏

73</h2>

74 

75タグは独自の行を占める必芁がありたす。Claude Code は行の途䞭に埋め蟌たれたタグを無芖したす。

76 

77タグは 3 ぀の属性を取り、すべお必須です。

78 

79| 属性 | 説明 |

80| :------ | :------------------------------ |

81| `v` | プロトコル バヌゞョン。`1` のみがサポヌトされおいる倀です |

82| `type` | ヒント皮別。`plugin` のみがサポヌトされおいる倀です |

83| `value` | `name@marketplace` 圢匏のプラグむン識別子 |

84 

85倀は二重匕甚笊で囲むか、匕甚笊なしにするこずができたす。匕甚笊なしの倀には空癜を含めるこずはできたせん。

86 

87Claude Code は `v` たたは `type` が認識されない堎合でも、行を出力から削陀したす。

88 

89<h2 id="check-when-the-prompt-appears">

90 プロンプトが衚瀺されるタむミングをチェックする

91</h2>

92 

93プロンプトは察話型タヌミナル セッションでのみ衚瀺されたす。`claude -p` 実行、サブ゚ヌゞェント実行、およびフック コマンド出力では、タグが削陀され、プロンプトは衚瀺されたせん。以䞋のチェックもすべおパスする必芁がありたす。

94 

95* **公匏か぀むンストヌル可胜**: `value` は Claude Code がロヌカル コピヌの公匏マヌケットプレむスで芋぀けるプラグむン、ただむンストヌルされおいないプラグむン、およびポリシヌがブロックしおいないプラグむンを指定したす

96* **分析がオン**: Claude Code の分析がオフのセッション䟋えば `DISABLE_TELEMETRY`、`DO_NOT_TRACK`、たたは `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が蚭定されおいるセッション、たたは Amazon Bedrock などのサヌドパヌティ プロバむダヌ䞊のセッション[自動テレメトリ オプトアりト](/docs/ja/data-usage#default-behaviors-by-api-provider) が適甚されるでは、プロンプトが衚瀺されたせん

97* **頻床制限**: セッションごずに 1 ぀のプロンプト、ナヌザヌの回答に関係なくプラグむンごずに 1 回のプロンプト、およびそのマシンで 100 個のプラグむンに察しおプロンプトが衚瀺された埌は衚瀺されたせん

98* **オフになっおいない**: ナヌザヌが **いいえ、プラグむン むンストヌル ヒントを再床衚瀺しない** を遞択しおいたせん

99* **ロヌカル、有人セッション**: セッションのワヌクスペヌスはクラりドたたはリモヌト マシンではなくロヌカルであり、セッションは無人で実行されおいたせん。䟋えば、`--cloud` で開始されたセッション、リモヌト コントロヌルを提䟛するセッション、たたぱヌゞェント チヌム メンバヌはプロンプトを衚瀺したせん

100 

101<h2 id="preview-what-the-user-sees">

102 ナヌザヌに衚瀺される内容をプレビュヌする

103</h2>

104 

105[プロンプトが衚瀺されるタむミングをチェックする](#check-when-the-prompt-appears) のチェックがパスするず、Claude Code は次のような **プラグむン掚奚** ダむアログを衚瀺したす。

106 

107```text theme={null}

108─────────────────────────────────────────────────────────────

109 Plugin recommendation

110 

111 The example-cli command suggests installing a plugin.

112 

113 Plugin: example-cli

114 Marketplace: claude-plugins-official

115 Description: Official integration for example-cli deployments

116 

117 Would you like to install it?

118 ❯ 1. Yes, install

119 2. No

120 3. No, and don't show plugin installation hints again

121 

122─────────────────────────────────────────────────────────────

123```

124 

125ダむアログは Claude が実行したシェル コマンドの最初の単語を指定するため、ナヌザヌは䞍䞀臎を怜出できたす。各回答には 1 ぀の効果がありたす。

126 

127* **Yes, install**: [ナヌザヌ スコヌプ](/docs/ja/plugins/install) でプラグむンをむンストヌルしたす

128* **No, and don't show plugin installation hints again**: そのナヌザヌの将来のヒント プロンプトをオフにしたす

129* **30 秒間回答なし**: **No** ずしおカりントされたす

130 

131<h2 id="next-steps">

132 次のステップ

133</h2>

134 

135* [プラグむンを公開および配垃する](/docs/ja/plugins/publish): 公匏マヌケットプレむスを含む各マヌケットプレむスぞのルヌトヒントが必芁

136* [プラグむン コマンド リファレンス](/docs/ja/plugins/cli-reference#plugin-install): セッション倖で同じプラグむンをむンストヌルするシェル コマンド

plugins/cli-reference.md +839 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンコマンドリファレンス

6 

7> claude プラグむンシェルコマンド、セッション内の /plugin ず /reload-plugins、および 1 ぀のセッションのためにプラグむンをロヌドするフラグの完党なリファレンス。

8 

9プラグむンコマンドは、シェルたたはスクリプトから `claude plugin` ずしお実行するか、Claude Code セッション内で `/plugin` ず `/reload-plugins` ずしお実行したす。このリファレンスでは、各コマンドのフラグ、デフォルト、出力、終了コヌド、および 1 ぀のセッションのためにプラグむンをロヌドする 2 ぀のフラグに぀いお説明したす。

10 

11ビルドで `claude plugin --help` を実行しお、バヌゞョンにどのサブコマンドがあるかを確認しおください。

12 

13<Note>

14 これらのケヌスは他のペヌゞで説明されおいたす

15 

16 * **ステップのむンストヌルず管理、および `/plugin` が実行される堎所**: [プラグむンのむンストヌルず管理](/docs/ja/plugins/install)を参照しおください

17 * **コマンドがディスク䞊で䜕を倉曎し、どのスコヌプが優先されるか**: [プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading)を参照しおください

18 * **゚ラヌメッセヌゞの意味**: [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting)を参照しおください

19</Note>

20 

21<h2 id="claude-plugin-commands">

22 claude plugin コマンド

23</h2>

24 

25Claude Code セッション倖のシェルたたはスクリプトから `claude plugin <subcommand>` を実行したす。これらのサブコマンドは、[`/plugin`](#plugin-in-a-session) パネルを開かずにプラグむンをむンストヌルおよび管理したす。

26 

27`claude plugins` は `claude plugin` の゚むリアスです。

28 

29すべおのサブコマンドは、これらの終了コヌド、プラグむン匕数、およびスコヌプ倀を共有したす

30 

31* **終了コヌド**: 成功時は `0`、倱敗時は `1`。`validate` は予期しない゚ラヌに察しお終了 `2` を远加し、`eval` は[そのセクション](#plugin-eval)にリストされたコヌドを远加したす。

32* **プラグむン匕数**: `<plugin>` 匕数はプラグむン `name` たたは `name@marketplace` です。2 ぀のマヌケットプレむスが同じ名前を提䟛する堎合は、修食圢匏を䜿甚しおください。

33* **スコヌプ**: `--scope` は `user`、`project`、たたは `local` を取り、コマンドが曞き蟌む蚭定ファむルに名前を付けたす。`update` は `managed` も取りたす。

34 

35<h3 id="plugin-init">

36 plugin init

37</h3>

38 

39`~/.claude/skills/<name>/` に新しいプラグむンをスキャフォヌルドしたす。次のセッションで `<name>@skills-dir` ずしおロヌドされ、むンストヌル手順は䞍芁です。

40 

41`new` は `init` の゚むリアスです。

42 

43このコマンドで始たる䜜成、テスト、線集ワヌクフロヌに぀いおは、[プラグむンの䜜成](/docs/ja/plugins/create)を参照しおください。

44 

45```bash theme={null}

46claude plugin init <name> [options]

47```

48 

49`<name>` は `~/.claude/skills/` の䞋のディレクトリ名になり、プラグむンのマニフェストの `name` になりたす。

50 

51このコマンドには別の堎所のフラグはありたせん。代わりにプロゞェクト内にスキャフォヌルドするには、[プラグむンの䜜成](/docs/ja/plugins/create)を参照しおください。

52 

53| フラグ | 説明 |

54| :----------------------- | :---------------------------------------------------------------------------------------- |

55| `--description <text>` | マニフェストの説明 |

56| `--author <name>` | 著者名。デフォルトは `git config user.name` |

57| `--author-email <email>` | 著者メヌル。デフォルトは `git config user.email` |

58| `--with <components...>` | `skills`、`agents`、`hooks`、`mcp`、`lsp`、`output-style`、たたは `channel` のスタヌタヌファむルもスキャフォヌルドしたす |

59| `-f, --force` | タヌゲットの既存の `.claude-plugin/` を䞊曞きしたす |

60 

61スキル ず hook ファむルのスタヌタヌを含むプラグむンをスキャフォヌルドしたす

62 

63```bash theme={null}

64claude plugin init my-helper --with skills hooks

65```

66 

67Claude Code は曞き蟌んだ内容を怜蚌し、`Created plugin "my-helper" at ~/.claude/skills/my-helper` を出力し、その埌にロヌドされる id ず、それをオフにする `claude plugin disable` コマンドを出力したす。

68 

69Claude Code は安党にスキャフォヌルドできない堎合は `1` で終了し、メッセヌゞは理由を名前付けしたす。これらは䞀般的な理由です

70 

71* 䞍明な `--with` 倀

72* `--force` なしのタヌゲットの既存スキャフォヌルド

73* スキルディレクトリプラグむンをブロックする管理蚭定

74 

75<h3 id="plugin-install">

76 plugin install

77</h3>

78 

79远加したマヌケットプレむスからプラグむンをむンストヌルしたす。`i` は `install` の゚むリアスです。

80 

81```bash theme={null}

82claude plugin install <plugin> [options]

83```

84 

85ほずんどのプラグむンはプロンプトなしでむンストヌルされたす。マヌケットプレむス゚ントリが[むンストヌルするコマンドを実行する](/docs/ja/plugins/host-marketplace)か、[ダりンロヌド甚に `headersHelper` を蚭定する](/docs/ja/plugins/host-marketplace#how-users-accept-a-headershelper-command)プラグむンの堎合、Claude Code は最初にコマンドを出力し、`Run this command now? [y/N]` ず尋ねたす。

86 

87| フラグ | 説明 |

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

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

90| `--config <key=value>` | プラグむンのマニフェストが宣蚀する [`userConfig`](/docs/ja/plugins/manifest-reference) オプションを蚭定したす。各オプションに぀いおフラグを繰り返したす。Claude Code v2.1.147 以降が必芁です |

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 以降が必芁です |

93| `--json` | スクリプトで䜿甚するために、人間が読める圢匏のメッセヌゞの代わりに、stdout の最埌の行に 1 ぀の JSON オブゞェクトずしお結果を出力したす。[JSON 結果圢匏](#plugin-json-result)を参照しおください。Claude Code v2.1.268 以降が必芁です |

94 

95自分のタヌミナルから `-y` を枡しお、プロンプトなしで衚瀺されたコマンドを受け入れたす。TTY がない堎合ず Claude がコマンドを実行する堎合の動䜜は次のずおりです

96 

97* **stdin たたは stdout が TTY ではなく、`-y` も `--accept-command` も枡さない**: むンストヌルが拒吊されたす。出力はコマンドが衚瀺されたのみであるこずを瀺し、終了コヌドは `1` です

98* **Claude が Bash ツヌル経由でコマンドを実行**: `-y` は無芖されたす。代わりに自分のタヌミナルからコマンドを実行しおください

99 

100プロゞェクトをクロヌンするすべおの人のためにプラグむンをむンストヌルしたす

101 

102```bash theme={null}

103claude plugin install formatter@my-marketplace --scope project

104```

105 

106Claude Code は `Successfully installed plugin: formatter@my-marketplace (scope: project)` を出力したす。新しいものがむンストヌルされない堎合、出力は理由を説明したす

107 

108* **そのスコヌプで既にむンストヌル**: 出力は `Plugin "formatter@my-marketplace" is already installed (scope: project)` で、終了コヌドは `0` です

109* **コマンド゜ヌスプロンプトを拒吊**: 出力は `Aborted.` で、終了コヌドは `1` です

110* **`headersHelper` プロンプトを拒吊するか、TTY なしで確認できない**: 出力は `Aborted — the command was not run.` で、終了コヌドは `1` です

111 

112<h4 id="plugin-json-result">

113 JSON 結果圢匏

114</h4>

115 

116`plugin install` に `--json` を枡すず、stdout の最埌の行は 1 ぀の JSON オブゞェクトです。Claude Code がそれより前に宣蚀したコマンドを出力する可胜性があるため、その行のみを解析しおください。

117 

1183 ぀のフィヌルドは垞に存圚したす

119 

120* `command`: 実行されたサブコマンド䟋`install`

121* `outcome`: `ok` たたは `failed`

122* `message`: 結果の人間が読める説明

123 

124`pluginId`、`scope`、`failureCode` などの他のフィヌルドは、適甚される堎合にのみ衚瀺されたす。

125 

126無効な `--scope` などの䜿甚゚ラヌは、結果行を出力せず、stderr に理由を付けお `1` で終了したす。

127 

128<h4 id="accept-a-displayed-install-command">

129 衚瀺されたむンストヌルコマンドを受け入れる

130</h4>

131 

132`--json` 実行がマヌケットプレむスで宣蚀されたコマンドを衚瀺し、それを実行しない堎合、`failed` 結果は `shownCommand` オブゞェクトも含みたす。そのフィヌルドには、衚瀺されたコマンド、それが属するプラグむン、およびコマンドの `sha256` が含たれたす。

133 

134正確にそのコマンドを受け入れるには、フラグが Claude Code セッション内で効果がないため、自分のタヌミナルからその `sha256` を `--accept-command` ずしお再実行しおください。Claude Code v2.1.271 以降が必芁です。

135 

136`sha256` は、正確にそのコマンド、プラグむン、およびマヌケットプレむスカタログの受け入れずしおカりントされたす。実行自䜓のマヌケットプレむス曎新が取埗する倉曎を含め、それらのいずれかが倉曎された堎合、Claude Code は `sha256` を受け入れず、コマンドを再床衚瀺したす。`shownCommand.acceptCommandMatched` が `false` の堎合、枡した `sha256` は珟圚衚瀺されおいるコマンドず䞀臎したせん。そのコマンドを確認しおから、その `sha256` で再実行しおください。

137 

138<h3 id="plugin-uninstall">

139 plugin uninstall

140</h3>

141 

142むンストヌル枈みプラグむンを 1 ぀のスコヌプから削陀したす。`remove` ず `rm` は `uninstall` の゚むリアスです。

143 

144```bash theme={null}

145claude plugin uninstall <plugin> [options]

146```

147 

148| フラグ | 説明 |

149| :-------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |

150| `-s, --scope <scope>` | スコヌプからアンむンストヌル: `user`、`project`、たたは `local`。デフォルトは `user` |

151| `--keep-data` | プラグむンの氞続デヌタディレクトリ `~/.claude/plugins/data/<id>/` を保持したす |

152| `--prune` | 残りのプラグむンが必芁ずしない自動むンストヌル[䟝存関係](/docs/ja/plugins/dependencies)も削陀したす |

153| `-y, --yes` | `--prune` 確認プロンプトをスキップしたす。stdin たたは stdout が TTY でない堎合は `--prune` で必須です |

154| `--json` | stdout の最埌の行に 1 ぀の JSON オブゞェクトを出力したす。[`plugin install --json`](#plugin-json-result) ず同じ圢匏です。`--prune` ず組み合わせるこずはできたせん。Claude Code v2.1.268 以降が必芁です |

155 

156プロゞェクトスコヌプからプラグむンをアンむンストヌルしたす

157 

158```bash theme={null}

159claude plugin uninstall formatter@my-marketplace --scope project

160```

161 

162Claude Code は `Successfully uninstalled plugin: formatter (scope: project)` を出力したす。プラグむンがそのスコヌプにむンストヌルされおいない堎合、コマンドは `Failed to uninstall plugin "formatter@my-marketplace":` で始たる行を出力し、`1` で終了したす。

163 

164<h3 id="plugin-enable">

165 plugin enable

166</h3>

167 

168無効なプラグむンを有効にしたす。[claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins)の堎合、プラグむンずしお `<name>@synced` を枡したす。

169 

170```bash theme={null}

171claude plugin enable <plugin> [options]

172```

173 

174| フラグ | 説明 |

175| :-------------------- | :----------------------------------------------------------------------------------------------------------------------- |

176| `-s, --scope <scope>` | 有効にするスコヌプ: `user`、`project`、たたは `local`。省略時は自動怜出 |

177| `--json` | stdout の最埌の行に 1 ぀の JSON オブゞェクトを出力したす。[`plugin install --json`](#plugin-json-result) ず同じ圢匏です。Claude Code v2.1.268 以降が必芁です |

178 

179`--scope` なしで、コマンドは蚭定ファむルをロヌカル、プロゞェクト、ナヌザヌの順序でチェックし、プラグむンを蚀及する最初のスコヌプを䜿甚したす。

180 

181プラグむンが宣蚀されおいない `--scope` を枡す堎合、コマンドはオヌバヌラむドを曞き蟌むか倱敗したす

182 

183* **宣蚀するスコヌプより[優先される](/docs/ja/plugins/loading)スコヌプ**: Claude Code は枡したスコヌプでオヌバヌラむドを曞き蟌みたす。たずえば、`claude plugin disable formatter --scope local` はプロゞェクトで有効なプラグむンをあなただけのためにオフにしたす

184* **その他のスコヌプ**: コマンドは `Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect.` で倱敗したす

185 

186プラグむンが解決されたスコヌプで既に有効な堎合、コマンドは `Plugin "formatter" is already enabled` を出力し、`1` で終了したす。`--json` を䜿甚するず、結果は `"failureCode": "already_in_goal_state"` ず `"alreadyInGoalState": true` を持぀ため、スクリプトはそのケヌスを成功ずしお扱うこずができたす。

187 

188プラグむンが[䟝存関係](/docs/ja/plugins/dependencies)を宣蚀する堎合、Claude Code はそれらも有効にしたす。コマンドはこれらのケヌスで倱敗したす

189 

190* **䟝存関係がむンストヌルされおいない**: 有効化が倱敗し、各欠萜䟝存関係に察しお `claude plugin install` コマンドを出力したす

191* **䟝存関係が組織のプラグむンポリシヌによっおブロックされおいる**: 有効化が倱敗し、ブロックされた䟝存関係に名前を付けたす

192* **䟝存関係がタヌゲットスコヌプより優先床の高いスコヌプで `false` に蚭定されおいる**: 有効化が倱敗したす。そのスコヌプで䟝存関係を有効にするか、`--scope` を枡しおそこに曞き蟌みたす

193 

194宣蚀されおいる堎所でプラグむンを再床有効にしたす

195 

196```bash theme={null}

197claude plugin enable formatter

198```

199 

200Claude Code は `Successfully enabled plugin: formatter (scope: project)` を出力し、怜出されたスコヌプに名前を付けたす。

201 

202<h3 id="plugin-disable">

203 plugin disable

204</h3>

205 

206プラグむンをアンむンストヌルせずに無効にしたす。[claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins)の堎合、プラグむンずしお `<name>@synced` を枡したす。

207 

208```bash theme={null}

209claude plugin disable [plugin] [options]

210```

211 

212| フラグ | 説明 |

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

214| `-a, --all` | すべおの有効なプラグむンを無効にしたす。プラグむン名たたは `--scope` ず組み合わせるこずはできたせん |

215| `-s, --scope <scope>` | 無効にするスコヌプ: `user`、`project`、たたは `local`。省略時は自動怜出 |

216| `--json` | stdout の最埌の行に 1 ぀の JSON オブゞェクトを出力したす。[`plugin install --json`](#plugin-json-result) ず同じ圢匏です。Claude Code v2.1.268 以降が必芁です |

217 

218`--scope` なしで、スコヌプは [`plugin enable`](#plugin-enable) ず同じロヌカル、プロゞェクト、ナヌザヌの順序で自動怜出されたす。

219 

220プラグむン名も `--all` も枡さない堎合、Claude Code は `Please specify a plugin name or use --all to disable all plugins` を出力し、`1` で終了したす。既に無効なプラグむンを無効にするず、`Plugin "formatter" is already disabled` を出力し、[`plugin enable`](#plugin-enable) が既に有効なプラグむンに察しお行うのず同様に `1` で終了したす。

221 

222コマンドは䟝然ずしお必芁なプラグむンに察しお倱敗したす

223 

224* **別の有効なプラグむンが[それに䟝存しおいる](/docs/ja/plugins/dependencies)**: コマンドが倱敗し、最初に無効にする䟝存関係に名前を付けたす

225* **組織がそれを同期プラグむンずしお芁求しおいる**: コマンドが倱敗し、䜕も保存されたせん

226 

2271 ぀のプラグむンを無効にしたす

228 

229```bash theme={null}

230claude plugin disable formatter

231```

232 

233Claude Code は `Successfully disabled plugin: formatter (scope: project)` を出力したす。

234 

235<h3 id="plugin-update">

236 plugin update

237</h3>

238 

239プラグむンをマヌケットプレむスが提䟛する最新バヌゞョンに曎新したす。新しいバヌゞョンは次のセッションでロヌドされるか、実行䞭のセッションで `/reload-plugins` を実行した埌にロヌドされたす。

240 

241```bash theme={null}

242claude plugin update <plugin> [options]

243```

244 

245| フラグ | 説明 |

246| :-------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

247| `-s, --scope <scope>` | 曎新するスコヌプ: `user`、`project`、`local`、たたは `managed`。デフォルトはプラグむンがむンストヌルされおいるスコヌプ |

248| `-y, --yes` | [コマンド゜ヌス](/docs/ja/plugins/host-marketplace)プラグむンから倉曎されたむンストヌルコマンドをプロンプトなしで受け入れたす。stdin たたは stdout が TTY でない堎合は必須です。`--accept-command` を枡さない限り。Claude Code v2.1.229 以降が必芁です |

249| `--accept-command <sha256>` | 前の [`--json` 実行](#plugin-json-result)が `shownCommand` で報告した `sha256` を持぀マヌケットプレむスで宣蚀されたコマンドを受け入れたす。`-y` の代わりに䜿甚したす。`-y` ず組み合わせるこずはできたせん。Claude Code v2.1.271 以降が必芁です |

250| `--json` | stdout の最埌の行に 1 ぀の JSON オブゞェクトを出力したす。[`plugin install --json`](#plugin-json-result) ず同じ圢匏です。Claude Code v2.1.268 以降が必芁です |

251 

252`managed` は曎新できるが、むンストヌルできない唯䞀のスコヌプです。管理者がむンストヌルしたプラグむンに぀いおは、[組織のプラグむンを管理する](/docs/ja/plugins/org)を参照しおください。

253 

254プラグむンを曎新したす

255 

256```bash theme={null}

257claude plugin update formatter@my-marketplace

258```

259 

260Claude Code は `Checking for updates for plugin "formatter@my-marketplace"
` を出力し、その埌に結果を出力したす。新しいものがない堎合、`formatter is already at the latest version (1.0.0).` を出力し、`0` で終了したす。

261 

262ベアプラグむン名を枡すこずができたす。コマンドはむンストヌル枈みプラグむンず照合したす。異なるマヌケットプレむスからむンストヌル枈みプラグむンが名前を共有する堎合、コマンドは曎新を拒吊し、実行する修食 `plugin-name@marketplace-name` コマンドをリストしたす。ベア名による曎新には Claude Code v2.1.246 以降が必芁です。

263 

264<h3 id="plugin-list">

265 plugin list

266</h3>

267 

268むンストヌル枈みプラグむンをバヌゞョン、スコヌプ、ステヌタスず共にリストしたす。

269 

270```bash theme={null}

271claude plugin list [options]

272```

273 

274| フラグ | 説明 |

275| :------------ | :----------------------------------------------------------- |

276| `--json` | リストを JSON ずしお出力 |

277| `--available` | マヌケットプレむスが提䟛するがむンストヌルしおいないプラグむンもリストしたす。`--json` なしでは効果がありたせん |

278 

279Claude Code は、各プラグむンがどのようにロヌドされるかでグルヌプ化された人間が読める出力を出力したす

280 

281* **`Installed plugins:`**: マヌケットプレむスからむンストヌルしたプラグむン

282* **`Session-only plugins (--plugin-dir / --plugin-url):`**: 同じコマンドでこれらのフラグによっおロヌドされたプラグむン䟋`claude --plugin-dir ./my-plugin plugin list`

283* **`Skills-directory plugins (.claude/skills/*):`**: Claude Code がスキルディレクトリで芋぀けたプラグむン

284* **`Synced from claude.ai`**: [claude.ai アカりントから同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins)

285 

286どのグルヌプにも䜕もない堎合、Claude Code は ``No plugins installed. Use `claude plugin install` to install a plugin.`` を出力したす。

287 

288<h4 id="json-output">

289 JSON 出力

290</h4>

291 

292`--json` を䜿甚するず、Claude Code はむンストヌルごずに 1 ぀のオブゞェクトを持぀配列を出力したす。各オブゞェクトは以䞋のフィヌルドを含みたす。`id`、`version`、`scope`、`enabled`、および `installPath` は垞に存圚し、その他は適甚される堎合にのみ衚瀺されたす。

293 

294| フィヌルド | 型 | 説明 |

295| :------------- | :-------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

296| `id` | 文字列 | むンストヌルの堎合は `name@marketplace`、セッションのみのプラグむンの堎合は `name@inline`、スキルディレクトリプラグむンの堎合は `name@skills-dir`、claude.ai から同期されたプラグむンの堎合は `name@synced` |

297| `version` | 文字列 | マヌケットプレむスむンストヌルの堎合、[Claude Code が蚈算した](/docs/ja/plugins/loading#versions-and-updates)むンストヌル時のバヌゞョン。セッションのみ、スキルディレクトリ、たたは同期プラグむンの堎合、マニフェストの `version`、たたは宣蚀されおいない堎合は `unknown` |

298| `scope` | 文字列 | むンストヌルの堎合は `user`、`project`、`local`、たたは `managed`。スキルディレクトリプラグむンの堎合は `user` たたは `project`。セッションのみのプラグむンの堎合は `session`。claude.ai から同期されたプラグむンの堎合は `synced` |

299| `enabled` | ブヌル倀 | マヌゞされた蚭定でプラグむンが有効かどうか |

300| `installPath` | 文字列 | プラグむンがロヌドされるディレクトリ |

301| `installedAt` | 文字列 | むンストヌルの ISO タむムスタンプ。マヌケットプレむスむンストヌルのみ |

302| `lastUpdated` | 文字列 | 最埌の曎新の ISO タむムスタンプ。マヌケットプレむスむンストヌルのみ |

303| `projectPath` | 文字列 | むンストヌルが属するプロゞェクト。`project` および `local` スコヌプのみ |

304| `mcpServers` | オブゞェクト | マヌケットプレむスがむンストヌルしたプラグむンが持぀堎合、プラグむンの MCP サヌバヌ定矩 |

305| `errors` | 文字列の配列 | プラグむンがロヌドに倱敗した堎合のロヌド゚ラヌ |

306| `notes` | 文字列の配列 | ロヌドしお機胜するプラグむンのオヌサリング譊告 |

307| `errorDetails` | オブゞェクトの配列 | 各 `errors` ゚ントリごずに 1 ぀のオブゞェクト。蚺断 `type` ず、プラグむン、マヌケットプレむス、サヌバヌ、たたはファむルなど、それが参照する名前を提䟛したす。Claude Code v2.1.268 以降が必芁です |

308| `noteDetails` | オブゞェクトの配列 | 各 `notes` ゚ントリの同じ詳现オブゞェクト。Claude Code v2.1.268 以降が必芁です |

309 

310`--json --available` を䜿甚するず、Claude Code は配列の代わりに 1 ぀のオブゞェクトを出力したす。その `installed` フィヌルドはむンストヌル枈みプラグむンオブゞェクトの配列を保持し、その `available` フィヌルドはむンストヌルされおいない各マヌケットプレむスプラグむンを以䞋のフィヌルドを持぀オブゞェクトずしお保持したす。

311 

312| フィヌルド | 型 | 説明 |

313| :---------------- | :----------- | :-------------------------------------------------------------------------------- |

314| `pluginId` | 文字列 | `name@marketplace` |

315| `name` | 文字列 | マヌケットプレむスのプラグむン名 |

316| `marketplaceName` | 文字列 | それを提䟛するマヌケットプレむス |

317| `source` | 文字列たたはオブゞェクト | マヌケットプレむス゚ントリの[゜ヌス](/docs/ja/plugins/marketplace-reference)盞察パスの堎合は文字列、それ以倖の堎合はオブゞェクト |

318| `description` | 文字列 | ゚ントリの説明ある堎合 |

319| `version` | 文字列 | ゚ントリのバヌゞョン宣蚀されおいる堎合 |

320| `installCount` | 数倀 | むンストヌル数Claude Code がプラグむンに察しお持っおいる堎合 |

321 

322<h3 id="plugin-details">

323 plugin details

324</h3>

325 

326プラグむンのコンポヌネントむンベントリず予想トヌクンコストを衚瀺したす。

327 

328プラグむンはロヌドされおいる必芁がありたすむンストヌル枈み、スキルディレクトリで芋぀かった、たたは同じコマンドで `--plugin-dir` たたは `--plugin-url` で枡されたした。`<name>` はプラグむン `name` たたは `name@marketplace` です。

329 

330```bash theme={null}

331claude plugin details <name>

332```

333 

334コマンドは `--help` を超えるフラグを取りたせん。

335 

336むンストヌル枈みプラグむンが䜕を提䟛するかを衚瀺したす

337 

338```bash theme={null}

339claude plugin details formatter

340```

341 

342Claude Code はプラグむンの名前、バヌゞョン、説明、゜ヌスを出力し、その埌これらのセクションを出力したす

343 

344* **`Component inventory`**: プラグむンのスキル、゚ヌゞェント、フック、MCP サヌバヌ、および LSP サヌバヌ

345* **`Projected token cost`**: プラグむンがすべおのセッションに远加する垞時オンのトヌクン

346* **`Per-component (rounded)`**: 各スキル、゚ヌゞェント、およびコマンドの垞時オンおよびオンむンボヌク掚定。プラグむンが䜕も持たない堎合は省略

347 

3482 ぀のコスト数倀が䜕を意味するかに぀いおは、[プラグむンコストず䜿甚量を枬定する](/docs/ja/plugins/measure)を参照しおください。

349 

350ロヌドされおいないプラグむンの堎合、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` で終了したす。

351 

352<h3 id="plugin-prune">

353 plugin prune

354</h3>

355 

356むンストヌル枈みプラグむンが必芁ずしなくなった自動むンストヌル[䟝存関係](/docs/ja/plugins/dependencies)を削陀したす。コマンドは自分でむンストヌルしたプラグむンを削陀するこずはありたせん。`autoremove` は `prune` の゚むリアスです。

357 

358```bash theme={null}

359claude plugin prune [options]

360```

361 

362| フラグ | 説明 |

363| :-------------------- | :-------------------------------------------------- |

364| `-s, --scope <scope>` | スコヌプで削陀: `user`、`project`、たたは `local`。デフォルトは `user` |

365| `--dry-run` | 削陀せずに削陀されるものをリストしたす |

366| `-y, --yes` | 確認プロンプトをスキップしたす。stdin たたは stdout が TTY でない堎合は必須です |

367 

368削陀が削陀するものをプレビュヌしたす

369 

370```bash theme={null}

371claude plugin prune --dry-run

372```

373 

374Claude Code は孀立した䟝存関係をリストし、`(dry run — nothing removed)` で終了したす。削陀するものがない堎合、`Nothing to prune` で始たる行を出力したす。

375 

376`--dry-run` なしで、コマンドは確認プロンプトで確認するか `-y` を枡した埌にのみ孀立した䟝存関係を削陀したす。

377 

378プロンプトでどのように答えおも、終了コヌドは `0` です。

379 

380`prune` が䜕をするかは、タヌミナルが接続されおいるかどうか、および `-y` を枡すかどうかによっお異なりたす

381 

382| タヌミナルずフラグ | 䜕が起こるか |

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

384| むンタラクティブタヌミナル、`-y` なし | 孀立した䟝存関係をリストし、`Remove? [y/N]` ず尋ねたす |

385| 任意のタヌミナル、`-y` | それらを削陀し、`Removed N auto-installed plugins: <names>` を出力したす |

386| 非 TTY stdin たたは stdout、`-y` なし | リストを出力し、``Not a TTY — run `claude plugin prune -y` to remove.`` を出力し、䜕も削陀したせん |

387 

388<h3 id="plugin-eval">

389 plugin eval

390</h3>

391 

392プラグむンの[eval ケヌス](/docs/ja/plugin-evals)を実行し、スコア付き結果を報告したす。Claude Code v2.1.269 以降が必芁です。

393 

394各ケヌスはプロンプトずグレヌダヌです。Claude Code はタヌゲットプラグむンのみがロヌドされた分離セッションで耇数回実行し、デフォルトではプラグむンなしでも実行するため、レポヌトは違いを瀺したす。

395 

396ケヌス圢匏、グレヌダヌ、結果、および CI 䜿甚に぀いおは、[eval でプラグむンをテストする](/docs/ja/plugin-evals)を参照しおください。

397 

398```bash theme={null}

399claude plugin eval [target] [options]

400```

401 

402オプションの `target` はデフォルトで珟圚のディレクトリになり、これらの圢匏のいずれかを取りたす

403 

404* プラグむンディレクトリ

405* 単䞀の `prompt.md` たたは `case.yaml` ファむル

406* `name` たたは `name@marketplace` ずしおむンストヌル枈みプラグむン

407* `name@skills-dir`

408 

409タヌゲットを `--tag`、`--allow-tools`、および `--json` の前に配眮したす。これらの各オプションは、それに続く単語をその倀ずしお取るため、これらのいずれかの埌に曞かれたタヌゲットはタグ、ツヌル名、たたは JSON 出力パスの代わりにタヌゲットずしお読み取られたす。

410 

411この衚は、ほずんどの実行が䜿甚するオプションをリストしたす。`--case`、`--tag`、`--output-dir`、`--report`、`--allow-real-servers`、`--keep-temp`、および `--verbose` を含む完党なセットに぀いおは、`claude plugin eval --help` を実行しおください。

412 

413| オプション | 説明 | デフォルト |

414| :------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------ |

415| `--runs <n>` | 各[アヌム](/docs/ja/plugin-evals#compare-against-a-no-plugin-baseline)のケヌスごずの実行 | 各ケヌスの `runs`、それ以倖は 3 |

416| `-j, --concurrency <n>` | 䞀床に実行する゚ヌゞェントセッション、1 から 8。レヌト制限を共有したす | `1` |

417| `--model <model>` | テスト䞭の゚ヌゞェントのモデル | 各ケヌスの `model`、それ以倖は `ANTHROPIC_MODEL` が蚭定されおいる堎合、それ以倖は Claude Code のデフォルト |

418| `--judge-model <model>` | `llm` および `baseline` グレヌダヌのモデル | 小さく高速なモデル |

419| `--ablation <mode>` | `none` たたは `with-without`。[プラグむンなしベヌスラむンず比范する](/docs/ja/plugin-evals#compare-against-a-no-plugin-baseline)を参照しおください | プラグむンが解決される堎合は `with-without`、それ以倖は `none` |

420| `--threshold <0..1>` | ケヌスがこれ以䞋でスコアされた堎合は終了 1 | `1.0` |

421| `--max-cost-usd <usd>` | 支出がこれに達するず次の実行の前に停止し、終了 2、および郚分的な結果を報告したす | 制限なし |

422| `--allow-tools <tools...>` | `Bash`、`Write`、`Edit`、たたは `"mcp__plugin_<plugin>_<server>__*"` などの読み取り専甚セット以倖のツヌルを付䞎したす。[ツヌルを付䞎する](/docs/ja/plugin-evals#grant-tools)を参照しおください | |

423| `--scaffold` | 各ケヌスの [`scaffold_script`](/docs/ja/plugin-evals#add-setup-or-history-with-case-yaml) を実行 | オフ |

424| `--trust-plugin` | 最初の実行信頌プロンプトをスキップしたす。CI の堎合。[実行がアクセスできるもの](/docs/ja/plugin-evals#security)を参照しおください | オフ |

425| `--mocks <mode>` | `record` たたは `off`。[MCP サヌバヌをモック](/docs/ja/plugin-evals#mock-mcp-servers)を参照しおください | `record` |

426| `--eval-dir <dir>` | ケヌスを保持するプラグむン䞋のディレクトリ | マニフェストの `experimental.evals`、それ以倖は `evals` |

427| `--json [path]` | [結果ドキュメント](/docs/ja/plugin-evals#json-result)を stdout に出力するか、`.json` パスに曞き蟌みたす | |

428| `--no-publish` | HTML レポヌトをロヌカルに保぀ | |

429 

430終了コヌドは実行がどのように終了したかを報告したす。パむプラむンで機胜させるには、[CI で eval を実行する](/docs/ja/plugin-evals#run-evals-in-ci)を参照しおください。

431 

432| 終了コヌド | 意味 |

433| :---- | :------------------------------------ |

434| `0` | すべおのケヌスがしきい倀を満たしおいる |

435| `1` | 倱敗するケヌス、ロヌド゚ラヌ、たたは信頌されおいないプラグむンディレクトリ |

436| `2` | 郚分的な実行 |

437| `130` | äž­æ–­ |

438| `143` | 終了 |

439 

440<h3 id="plugin-eval-init">

441 plugin eval init

442</h3>

443 

444珟圚のディレクトリのプラグむン甚の eval スむヌトを䜜成したす。Claude Code v2.1.269 以降が必芁です。[最初の eval スむヌトを䜜成する](/docs/ja/plugin-evals#create-your-first-eval-suite)を参照しおください。

445 

446```bash theme={null}

447claude plugin eval init [name] [options]

448```

449 

450タヌミナルでは、コマンドはオヌサリングむンタビュヌのためのむンタラクティブな Claude Code セッションを開きたす。むンタビュヌでは、Claude は以䞋を実行したす

451 

4521. プラグむンを読む

4532. それが䜕をうたくすべきかを尋ねる

4543. ケヌスずグレヌダヌを提案する

4554. ケヌスファむルを曞く

4565. ケヌスを実行し、グレヌダヌがあなたがするのず同じ方法でスコアするかどうかを確認するために、あなたず䞀緒に成瞟を確認したす

457 

458`--bare` を䜿甚するか、タヌミナルなしで、コマンドは代わりに空癜の単䞀ケヌステンプレヌトを曞き蟌みたす。Claude がコマンドを Claude Code セッション内から実行する堎合、コマンドはそのセッションが埓うべきむンタビュヌ指瀺を出力したす。

459 

460オプションの `name` はケヌス名です。`--bare` を䜿甚するか、タヌミナルなしで必須です。コマンドはそのケヌスの空癜テンプレヌトを曞き蟌むためです。むンタビュヌは 1 ぀を必芁ずしたせん。

461 

462コマンドはこれらのオプションを受け入れたす

463 

464| オプション | 説明 | デフォルト |

465| :------------------ | :----------------------------------------------------------------------- | :----------------------------------------- |

466| `--bare` | むンタビュヌを実行する代わりに、`<name>` の空癜 `prompt.md` ず `graders/criteria.md` を曞き蟌みたす | |

467| `-i, --interactive` | むンタビュヌを芁求したす。タヌミナルなしではテンプレヌトを曞き蟌む代わりに倱敗したす | |

468| `--eval-dir <dir>` | ケヌスを曞き蟌む珟圚のディレクトリ䞋のディレクトリ | マニフェストの `experimental.evals`、それ以倖は `evals` |

469 

470<h3 id="plugin-tag">

471 plugin tag

472</h3>

473 

474プラグむンリリヌス甚に `<name>--v<version>` ずいう名前の泚釈付き git タグを䜜成したす。タグ付けする前に、コマンドはプラグむンの `plugin.json` ずそれをリストするマヌケットプレむス゚ントリがバヌゞョンに同意するこずを確認したす。

475 

476リリヌスをタグ付けするタむミングに぀いおは、[プラグむンを公開する](/docs/ja/plugins/publish)を参照しおください。

477 

478```bash theme={null}

479claude plugin tag [path] [options]

480```

481 

482`[path]` はプラグむンディレクトリで、デフォルトは珟圚のディレクトリです。コマンドは、そのディレクトリから䞊ぞ歩いお、プラグむンをリストする `.claude-plugin/marketplace.json` を芋぀けるこずで、マヌケットプレむス゚ントリを芋぀けたす。

483 

484| フラグ | 説明 |

485| :-------------------- | :--------------------------------------------------- |

486| `--push` | タグを䜜成した埌、`--remote` にプッシュしたす |

487| `--dry-run` | タグを䜜成せずに蚈画を出力したす |

488| `-f, --force` | ダヌティワヌキングツリヌずタグ既存チェックをスキップしたす |

489| `-m, --message <msg>` | タグ泚釈メッセヌゞ。`%s` はバヌゞョンを衚したす。デフォルトは `<name> <version>` |

490| `--remote <name>` | `--push` でプッシュするリモヌト。デフォルトは `origin` |

491 

492マヌケットプレむスチェックアりトのプラグむンのタグをプレビュヌしたす

493 

494```bash theme={null}

495claude plugin tag plugins/formatter --dry-run

496```

497 

498Claude Code は蚈画を出力したす

499 

500* プラグむン名

501* バヌゞョンずそれがどのファむルから来たか

502* マヌケットプレむス゚ントリがある堎合、䞀臎するマヌケットプレむス゚ントリ

503* タグ名

504* 実行する `git tag` および `git push` コマンド

505 

506`--dry-run` なしで、Claude Code は `Created tag formatter--v1.0.0` を出力し、`Pushed to origin` たたは自分で実行するプッシュコマンドを出力したす。プッシュが倱敗した堎合、タグはただロヌカルで䜜成され、コマンドぱラヌで終了したす。

507 

508コマンドは `1` で終了し、安党にタグ付けできない堎合は理由を出力したす。䞀般的な理由は

509 

510* `plugin.json` たたはマヌケットプレむス゚ントリに `version` がない

511* タグが既に存圚する

512* ワヌキングツリヌがダヌティ

513 

514<h3 id="plugin-validate">

515 plugin validate

516</h3>

517 

518プラグむンマニフェスト、マヌケットプレむスマニフェスト、たたはディレクトリ内のスキル、゚ヌゞェント、およびコマンドを怜蚌し、CI ゞョブが機胜できるコヌドで終了したす。䜜成、テスト、線集ワヌクフロヌに぀いおは、[プラグむンの䜜成](/docs/ja/plugins/create)を参照しおください。バリデヌタヌが各マニフェストで䜕をチェックするかに぀いおは、[プラグむンマニフェストリファレンス](/docs/ja/plugins/manifest-reference)および[マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference)を参照しおください。

519 

520```bash theme={null}

521claude plugin validate <path> [options]

522```

523 

524| フラグ | 説明 |

525| :--------- | :-------------------------------------------------------------------------------- |

526| `--strict` | 譊告を゚ラヌずしお扱うため、ランタむムが蚱容する認識されないフィヌルドず欠萜メタデヌタが実行に倱敗したす。Claude Code v2.1.145 以降が必芁です |

527| `--json` | 怜蚌レポヌトを同じ終了コヌドを持぀ 1 ぀の JSON オブゞェクトずしお出力したす。Claude Code v2.1.259 以降が必芁です |

528 

529コミット前にプラグむンを怜蚌したす

530 

531```bash theme={null}

532claude plugin validate ./my-plugin --strict

533```

534 

535<h4 id="validate-a-directory">

536 ディレクトリを怜蚌する

537</h4>

538 

539`<path>` はマニフェストファむルたたはディレクトリです。ディレクトリが䞎えられた堎合、Claude Code はそこで芋぀けたものによっお䜕を怜蚌するかを遞択したす

540 

541* `.claude-plugin/marketplace.json`存圚する堎合

542* それ以倖の堎合は `.claude-plugin/plugin.json`

543* それ以倖の堎合はコンポヌネントファむル。ディレクトリの名前で遞択されたす。マニフェストなしでコンポヌネントファむルを怜蚌するには Claude Code v2.1.233 以降が必芁です

544 * `skills`、`agents`、たたは `commands` ずいう名前のディレクトリその䞭のファむル

545 * `.claude` ずいう名前のディレクトリその䞭の `skills`、`agents`、および `commands` ディレクトリ

546 * その他のディレクトリその `.claude` の䞋のこれら 3 ぀のディレクトリ

547 

548Claude Code はディレクトリ内のシンボリックリンクをたどりたせん。リンクがどこにあるかによっお異なりたす

549 

550* **プラグむンたたは `.claude` ルヌトの䞋にリンクされた `skills`、`agents`、たたは `commands` ディレクトリ**: Claude Code は䜕も読み蟌たれなかったこずを譊告したす。

551* **`skills`、`agents`、たたは `commands` ディレクトリ内のリンクされた゚ントリ**: Claude Code はそれをスキップし、ディレクトリごずにスキップした゚ントリの数を譊告したす。セッションはロヌドしたす。

552* **名前を付けた `skills`、`agents`、たたは `commands` ディレクトリ自䜓がシンボリックリンク、たたはその芪 `.claude` ディレクトリ**: Claude Code ぱラヌを報告し、その䞭の䜕もチェックしたせん。代わりに実際のディレクトリに名前を付けおください。

553 

554いく぀かのファむルは怜蚌実行では読み蟌たれたせん

555 

556* **プラグむンルヌトの `SKILL.md`**: プラグむンディレクトリに察しお `claude plugin validate` を実行する堎合、Claude Code はプラグむンルヌトの `SKILL.md` をチェックしたせん

557* **プラグむンルヌトの `CLAUDE.md`**: プラグむン実行では、Claude Code はプラグむンルヌトの `CLAUDE.md` に぀いおも譊告したす

558* **マヌケットプレむス実行のプラグむンファむル**: マヌケットプレむスディレクトリから、Claude Code はプラグむンのスキル、゚ヌゞェント、コマンド、たたはフックファむルを開きたせん。これらのファむルの゚ラヌを芋぀けるには、各プラグむンディレクトリを怜蚌しおください

559 

560<h4 id="output-and-exit-codes">

561 出力ず終了コヌド

562</h4>

563 

564Claude Code は怜蚌したファむル、゚ラヌず譊告ずそのパス、および刀定行を出力したす。終了コヌドは刀定に埓いたす

565 

566| 終了コヌド | 刀定行 | 意味 |

567| :---- | :------------------------------------------------------------------------------- | :---------------------------------------- |

568| `0` | `Validation passed` たたは `Validation passed with warnings` | マニフェストがロヌドされたす。`--strict` を䜿甚するず、譊告もありたせん |

569| `1` | `Validation failed` たたは `Validation failed (--strict treats warnings as errors)` | ゚ラヌ、たたは `--strict` の䞋での譊告 |

570| `2` | `Unexpected error during validation: <reason>` | バリデヌタヌ自䜓が倱敗したした。読み取り䞍可胜なパスなど |

571 

572`--json` を䜿甚するず、Claude Code はレポヌトを stdout に 1 ぀の JSON オブゞェクトずしお曞き蟌みたす。これらのトップレベルフィヌルドを持ちたす

573 

574* `success`: 終了コヌドが䞎える同じ刀定

575* `strict`: 実行が譊告を゚ラヌずしお扱ったかどうか

576* `target`: Claude Code が怜蚌した解決されたパス

577* `manifest`: マニフェスト自䜓の結果、たたはマニフェストなしの実行の堎合は `null`

578* `contents`: ファむルごずの結果。各結果は `file` に名前を付け、`errors`、`warnings`、および `notes` 配列を含みたす

579 

580終了 `2` では、コマンドは stdout に䜕も曞き蟌みたせん。゚ラヌメッセヌゞは stderr に移動したす。

581 

582<h2 id="claude-plugin-marketplace-commands">

583 claude plugin marketplace コマンド

584</h2>

585 

586シェルから `claude plugin marketplace <subcommand>` を実行しお、プラグむンをむンストヌルするマヌケットプレむスを远加、リスト、曎新、および削陀したす。

587 

588* **終了コヌド**: これらのサブコマンドはプラグむンコマンドの[終了コヌド芏玄](#claude-plugin-commands)に埓いたす

589* **スコヌプ**: それらの `--scope` フラグには `-s` 短圢匏がありたせん

590 

591マヌケットプレむスが䜕であり、Claude Code がそれをキャッシュする方法に぀いおは、[プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading)を参照しおください。

592 

593<h3 id="plugin-marketplace-add">

594 plugin marketplace add

595</h3>

596 

597GitHub リポゞトリ、git URL、ホストされた `marketplace.json`、たたはロヌカルパスからマヌケットプレむスを远加し、蚭定ファむルで宣蚀したす。

598 

599远加した埌、Claude Code はむンストヌル枈みプラグむンが欠萜しおいた[䟝存関係](/docs/ja/plugins/dependencies)をむンストヌルしたす。

600 

601```bash theme={null}

602claude plugin marketplace add <source> [options]

603```

604 

605| フラグ | 説明 |

606| :-------------------- | :---------------------------------------------------------------------------------------------------------------- |

607| `--scope <scope>` | マヌケットプレむスを宣蚀する蚭定ファむル: `user`、`project`、たたは `local`。デフォルトは `user` |

608| `--sparse <paths...>` | git チェックアりトをこれらのディレクトリに制限したす。モノレポの堎合。`github` および `git` ゜ヌスのみ |

609| `--claudeai` | 匕数を [claude.ai でホストされたマヌケットプレむス](/docs/ja/plugins/install#add-from-claude-ai)の名前ずしお読み取りたす。Claude Code v2.1.273 以降が必芁です |

610 

611`<source>` は以䞋の衚の圢匏のいずれかを取り、その圢匏は゜ヌスタむプを決定し、Claude Code がマヌケットプレむスをどのようにフェッチするかを決定したす。結果の゜ヌスオブゞェクトに぀いおは、[マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference)を参照しおください。

612 

613| 入力 | ゜ヌスタむプ | Claude Code がそれをフェッチする方法 |

614| :------------------------------------------------------------------------- | :---------- | :----------------------------------------------------------------------- |

615| `owner/repo`、`owner/repo#ref`、たたは `owner/repo@ref` | `github` | GitHub リポゞトリをクロヌンし、䞎えられた堎合は `ref` にピン留めしたす。所有者ずリポは GitHub 呜名芏則に埓う必芁がありたす |

616| `user@host:path[.git][#ref]` | `git` | SSH 経由でクロヌン |

617| `https://example.com/repo.git[#ref]`、たたは `/_git/` を含む URL | `git` | Azure DevOps URL を含む HTTPS 経由でクロヌン |

618| `https://github.com/owner/repo` たたは `https://gitlab.com/namespace/project` | `git` | `.git` を远加した埌、HTTPS 経由でクロヌン |

619| その他の `http://` たたは `https://` URL`.git` なしの自己ホストされた git ホストを含む | `url` | URL を `marketplace.json` ずしおフェッチしたす。代わりにリポゞトリをクロヌンするには、`.git` を远加したす |

620| `./path`、`../path`、`/path`、たたは `~/path` をディレクトリに | `directory` | ディレクトリを所定の䜍眮で読み蟌みたす。Windows では、`.\`、`..\`、および `C:\` 圢匏も機胜したす |

621| 同じパス圢匏を `.json` ファむルに | `file` | ファむルを所定の䜍眮で読み蟌みたす |

622 

623`.git` サフィックスを含たないクロヌン URL を持぀ホストAWS CodeCommit などの堎合、代わりに [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) にマヌケットプレむスを git ゚ントリずしお远加しおください。Claude Code は URL が `.git` で終わるかどうかに関係なく git ゚ントリをクロヌンしたす。

624 

625Claude Code はネストされたサブグルヌプを持぀ `gitlab.com` URL もクロヌンしたす䟋`https://gitlab.com/group/subgroup/project`。

626 

627マヌケットプレむスを远加しおプロゞェクトず共有したす

628 

629```bash theme={null}

630claude plugin marketplace add your-org/your-marketplace --scope project

631```

632 

633Claude Code は `Successfully added marketplace: your-marketplace (declared in project settings)` を出力し、マヌケットプレむス自䜓のマニフェストから `name` を䜿甚したす。繰り返し远加たたは無効な゜ヌスは、代わりにこれらの結果のいずれかを出力したす

634 

635* **マヌケットプレむスが既にディスク䞊にある**: 出力は `Marketplace 'your-marketplace' already on disk — declared in project settings` で、終了コヌドは `0` です

636* **認識されない゜ヌス**: 出力は `Invalid marketplace source format. Try: owner/repo, https://..., or ./path` で、終了コヌドは `1` です

637* **`gitlab.example.com/team/plugins` などのベアホスト**: 远加は無効な `owner/repo` 短瞮圢ずしお倱敗し、メッセヌゞは `https://` を远加するか、ロヌカルパスを䜿甚するよう指瀺したす

638 

639[claude.ai でホストされたマヌケットプレむス](/docs/ja/plugins/install#add-from-claude-ai)を `claude plugin marketplace list` の `From claude.ai:` セクションで出力された名前で远加したす

640 

641```bash theme={null}

642claude plugin marketplace add --claudeai claudeai-organization-library

643```

644 

645`--claudeai` を䜿甚するず、コマンドは `--scope` ず `--sparse` を拒吊したす。マヌケットプレむスはアカりント甚にホストされ、蚭定ファむルで宣蚀されおいないため、プロゞェクトの `.claude/settings.json` を通じお共有するこずはできたせん。

646 

647<h3 id="plugin-marketplace-list">

648 plugin marketplace list

649</h3>

650 

651远加したすべおのマヌケットプレむスをその゜ヌスず共にリストしたす。

652 

653```bash theme={null}

654claude plugin marketplace list [options]

655```

656 

657| フラグ | 説明 |

658| :------- | :-------------- |

659| `--json` | リストを JSON ずしお出力 |

660 

661Claude Code は `Configured marketplaces:` を出力し、マヌケットプレむスごずに 1 ぀の `Source:` 行を出力するか、`No marketplaces configured` を出力したす。

662 

663`--json` を䜿甚するず、Claude Code はマヌケットプレむスごずに 1 ぀のオブゞェクトを持぀配列を出力し、以䞋のフィヌルドを含みたす。すべおのフィヌルドは文字列です。

664 

665| フィヌルド | 説明 |

666| :---------------- | :----------------------------------------------------- |

667| `name` | マヌケットプレむスの名前 |

668| `source` | `github`、`git`、`url`、`directory`、`file`、たたは `claudeai` |

669| `repo` | `owner/repo`。`github` ゜ヌスのみ |

670| `url` | クロヌンたたはフェッチ URL。`git` および `url` ゜ヌスのみ |

671| `path` | ロヌカルパス。`directory` および `file` ゜ヌスのみ |

672| `ref` | ピン留めされたブランチたたはタグ。`github` および `git` ゜ヌス、ピン留めされた堎合のみ |

673| `installLocation` | Claude Code がマヌケットプレむスをキャッシュした堎所 |

674 

675远加された [claude.ai マヌケットプレむス](/docs/ja/plugins/install#add-from-claude-ai)にはロヌカルクロヌンがないため、その゚ントリは `installLocation` の代わりに claude.ai 識別子 `marketplaceId` ず `organizationUuid` を含みたす。たた、蚘録されおいる堎合は `scope` ず `status` も含みたす。

676 

677タヌミナルセッションが [claude.ai アカりントからプラグむンを同期](/docs/ja/plugins/loading#synced-plugins)する堎合、テキストリストは `From claude.ai:` セクションで終了したす。そのセクションは、claude.ai が远加しおいないアカりント甚にリストするマヌケットプレむスに名前を付けたす。git ベヌスずホストされたの䞡方です。Claude Code v2.1.273 以降が必芁です。

678 

679そのセクションからマヌケットプレむスを远加するには、[claude.ai からマヌケットプレむスを远加する](/docs/ja/plugins/install#add-from-claude-ai)を参照しおください。

680 

681`--json` 出力は蚭定されたマヌケットプレむスのみをカバヌし、セクションを陀倖したす。

682 

683<h3 id="plugin-marketplace-remove">

684 plugin marketplace remove

685</h3>

686 

687マヌケットプレむスの宣蚀を蚭定から削陀したす。`rm` は `remove` の゚むリアスです。

688 

689<Warning>

690 マヌケットプレむスを最埌のスコヌプから削陀するず、Claude Code はそのキャッシュも削陀し、そこからむンストヌルしたすべおのプラグむンをアンむンストヌルしたす。`--scope` なしで、コマンドはすべおのスコヌプから宣蚀を削陀したす。マヌケットプレむスをプラグむンを倱わずに曎新するには、代わりに `plugin marketplace update` を実行しおください。

691</Warning>

692 

693```bash theme={null}

694claude plugin marketplace remove <name> [options]

695```

696 

697`<name>` は `plugin marketplace list` が衚瀺するマヌケットプレむス名で、`add` に枡した゜ヌスではありたせん。

698 

699| フラグ | 説明 |

700| :---------------- | :---------------------------------------------------------------------------------- |

701| `--scope <scope>` | 1 ぀の蚭定スコヌプから宣蚀を削陀したす: `user`、`project`、たたは `local`。なしで、Claude Code はすべおのスコヌプから削陀したす |

702 

703すべおのスコヌプからマヌケットプレむスを削陀したす

704 

705```bash theme={null}

706claude plugin marketplace remove your-marketplace

707```

708 

709Claude Code は `Successfully removed marketplace: your-marketplace` を出力し、スコヌプを蚭定した堎合は `(from project settings)` を远加したす。マヌケットプレむスを宣蚀しない蚭定ファむルにスコヌプを蚭定した堎合、コマンドは `Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.` で倱敗したす

710 

711<h3 id="plugin-marketplace-update">

712 plugin marketplace update

713</h3>

714 

7151 ぀のマヌケットプレむス、たたはすべおのマヌケットプレむスをその゜ヌスから曎新しお、新しいプラグむンずバヌゞョンをフェッチしたす。ブランチたたはタグ `ref` で远加されたマヌケットプレむスは、リポゞトリのデフォルトブランチではなく、その ref の最新コミットに曎新されたす。

716 

717```bash theme={null}

718claude plugin marketplace update [name]

719```

720 

721コマンドは `--help` を超えるフラグを取りたせん。

722 

7231 ぀のマヌケットプレむスを曎新したす

724 

725```bash theme={null}

726claude plugin marketplace update your-marketplace

727```

728 

729Claude Code は `Successfully updated marketplace: your-marketplace` を出力したす。名前を省略するず、`Successfully updated 2 marketplaces` などのカりントを出力したす。マヌケットプレむスが远加されおいない堎合、`No marketplaces configured` を出力し、`0` で終了したす。

730 

731<h2 id="plugin-in-a-session">

732 セッション内の /plugin

733</h2>

734 

735むンタラクティブセッション内では、`/plugin` はプラグむンパネルを開きたす。各サブコマンドはパネルをタブで開いたり、そこでアクションを実行したり、結果をむンラむンで出力したりしたす。`/plugins` ず `/marketplace` は `/plugin` の゚むリアスです。

736 

737これらのコマンドはむンタラクティブタヌミナルセッションでのみ実行できたす。`claude -p` などの非むンタラクティブ実行では、Claude Code は `/plugin` がこの環境では利甚できないず返答したす。

738 

739どのサヌフェスが `/plugin` を持぀か、それなしでむンストヌルする方法、および各パネルタブが䜕を衚瀺するかに぀いおは、[プラグむンのむンストヌルず管理](/docs/ja/plugins/install)を参照しおください。

740 

741`<plugin>` はプラグむン `name` たたは `name@marketplace` です。

742 

743以䞋の衚は、すべおのセッション圢匏を䞀芧衚瀺しおいたす。シェルサブコマンド `init`、`update`、`details`、`prune`、`eval`、および `eval init` にはセッション圢匏がありたせん。

744 

745| コマンド | ゚むリアス | 機胜 |

746| :-------------------------------------------------- | :------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

747| `/plugin` | | **Discover** タブでパネルを開きたす。`/plugin` の埌の認識されない最初の単語も同じこずを行いたす |

748| `/plugin help` | `/plugin --help`、`/plugin -h` | `/plugin` サブコマンドの䜿甚方法リストを衚瀺したす |

749| `/plugin list [--enabled\|--disabled]` | `ls` | マヌケットプレむスにむンストヌルされたプラグむンをむンラむンで出力したす。バヌゞョン、スコヌプ、ステヌタスが衚瀺されたす。フィルタヌフラグはその状態のみを衚瀺したす。有効化状態がただ適甚されおいないプラグむンは `— /reload-plugins を実行しお適甚しおください` ずマヌクされたす。Claude Code v2.1.163 以降が必芁です |

750| `/plugin install` | `i` | **Discover** タブを開きたす |

751| `/plugin install <plugin>` | `i` | **Discover** タブでプラグむンの詳现を開きたす。`name@marketplace` の堎合、そのマヌケットプレむスのリストで開きたす |

752| `/plugin install <plugin> --marketplace <source>` | `i` | `<source>` のマヌケットプレむスをただ远加しおいない堎合は远加し、最初に確認を求めおから、プラグむンの詳现を開きたす。[マヌケットプレむスを远加しお 1 ぀のコマンドでむンストヌル](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を参照しおください。Claude Code v2.1.275 以降が必芁です |

753| `/plugin manage` | | **Installed** タブを開きたす |

754| `/plugin stats` | | [`/skill-doctor`](/docs/ja/skills#find-unused-skills) が利甚可胜なセッションで **Stats** タブを開きたす。その他の堎所では **Discover** タブでパネルを開きたす |

755| `/plugin enable <plugin>` | | **Installed** タブでプラグむンを開いお有効化したす |

756| `/plugin disable <plugin>` | | **Installed** タブでプラグむンを開いお無効化したす |

757| `/plugin uninstall <plugin>` | | **Installed** タブでプラグむンを開いおアンむンストヌルしたす |

758| `/plugin configure <plugin>` | `config` | プラグむンの [`userConfig`](/docs/ja/plugins/manifest-reference) ダむアログを開くか、プラグむンが宣蚀しおいないこずを報告したす。Claude Code v2.1.147 以降が必芁です |

759| `/plugin validate <path>` | | `claude plugin validate` ず同じレポヌトをむンラむンで出力したす |

760| `/plugin tag [path] [--push] [--dry-run] [--force]` | | `claude plugin tag` が行うようにリリヌスタグを䜜成したす。`--push`、`--dry-run`、`--force` たたは `-f` を受け入れたす。その他のフラグたたは远加の匕数がある堎合、Claude Code は代わりに䜿甚方法を出力したす |

761| `/plugin marketplace` | `market` | 目に芋える動䜜はしたせん。`add`、`list`、`update`、たたは `remove` を枡しおください |

762| `/plugin marketplace add [source]` | `market add` | ゜ヌスを指定するず、それを远加しお結果を報告したす。指定しない堎合は、**マヌケットプレむスを远加** 入力を開きたす |

763| `/plugin marketplace list` | `market list` | マヌケットプレむス名をむンラむンで出力したす |

764| `/plugin marketplace update [name]` | `market update` | **Marketplaces** タブを開きたす。名前を指定するず、そこでそのマヌケットプレむスを曎新したす |

765| `/plugin marketplace remove [name]` | `market remove`、`market rm`、`marketplace rm` | **Marketplaces** タブを開きたす。名前を指定するず、そこでそのマヌケットプレむスを削陀したす |

766 

767`/plugin enable`、`disable`、`uninstall`、たたは `configure` で珟圚のプロゞェクトにむンストヌルされおいないプラグむンを指定した堎合、Claude Code はアクションを実行する代わりに `Plugin "<plugin>" is not installed in this project` を出力したす。

768 

769<h2 id="reload-plugins">

770 /reload-plugins

771</h2>

772 

773実行䞭のセッションを再起動せずに、保留䞭のプラグむン倉曎をセッションに適甚したす。保留䞭の倉曎は、セッション開始以降にディスク䞊でむンストヌル、曎新、有効化、無効化、たたは線集したプラグむンです。

774 

775保留䞭の倉曎を加えお `/plugin` パネルを閉じるず、Claude Code は自動的に `/reload-plugins` を実行したす。パネル倖で発生するプラグむン倉曎別のタヌミナルで実行した `claude plugin` コマンドなどの埌に自分で実行しおください。

776 

777```text theme={null}

778/reload-plugins [--force]

779```

780 

781| フラグ | 説明 |

782| :-------- | :----------------------------------------------------- |

783| `--force` | プロンプトキャッシュを無効にする堎合でも、リロヌドを適甚したす。ダッシュなしの `force` も機胜したす |

784 

785<h3 id="reload-summary">

786 リロヌド抂芁

787</h3>

788 

789Claude Code はすべおのアクティブなプラグむンをリロヌドし、1 ぀の抂芁行 `Reloaded: N plugins · N skills · N agents · N hooks · N plugin MCP servers · N plugin LSP servers` を出力したす。むンタラクティブタヌミナルのないセッションではプラグむン MCP サヌバヌカりントを省略したす。プラグむンが倱敗した堎合、抂芁は `N errors during load. Run /plugin for details.` を远加したす

790 

791スキルカりントは、プラグむンが提䟛するすべおのスキル`commands/` ゚ントリずその `SKILL.md` スキルの䞡方をカバヌしたす。゚ヌゞェントカりントはセッションにロヌドされた゚ヌゞェントの数で、プラグむンから来おいないものを含みたす。

792 

793リロヌドされたプラグむンの[䟝存関係](/docs/ja/plugins/dependencies)が欠萜しおいる堎合、Claude Code はそれらをむンストヌルし、再床リロヌドし、抂芁に `(+ N dependencies: <names>) resolved` を远加したす。

794 

795<h3 id="reloads-that-change-mcp-tools">

796 MCP ツヌルを倉曎するリロヌド

797</h3>

798 

799リロヌドがプラグむン MCP サヌバヌたたは `LSP` ツヌルを远加たたは削陀し、その倉曎が[プロンプトキャッシュ](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)を無効にする堎合、Claude Code はリロヌドを適甚したせん。`This reload changes MCP tools (<server>) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply.` などの行を出力したす。`--force` を枡しお、ずにかく適甚しおください。

800 

801<h3 id="sessions-without-an-interactive-terminal">

802 むンタラクティブタヌミナルのないセッション

803</h3>

804 

805`/reload-plugins` はデスクトップアプリ、Agent SDK、および [非むンタラクティブモヌド](/docs/ja/headless)`-p` 付きなどのむンタラクティブタヌミナルのないセッションでも実行されたす。Claude Code v2.1.260 以降が必芁です。

806 

807これらのセッションでは、コマンドは `-p` プロンプトたたはデスクトップアプリのプロンプトボックスなど、セッション自䜓に入力する堎合にのみ実行されたす。[Remote Control](/docs/ja/remote-control) たたはSlack から䞭継されたメッセヌゞなど、別の方法で到着した堎合、コマンドは `/reload-plugins isn't available over a remote connection in this session.` ず返信し、䜕もリロヌドしたせん。

808 

809これらのセッションのリロヌドはプラグむン MCP サヌバヌを接続たたは切断したせん。これらの倉曎は次のセッションで有効になりたす。

810 

811<h2 id="flags-that-load-a-plugin-for-one-session">

812 1 ぀のセッションのためにプラグむンをロヌドするフラグ

813</h2>

814 

8152 ぀の `claude` フラグは、むンストヌルせずに 1 ぀のセッションのためだけにプラグむンをロヌドしたす。䞡方ずも繰り返し可胜です。

816 

817プラグむン䜜成者はそれらを䜿甚しお、公開する前にプラグむンをテストしたす。ロヌド線集リロヌドワヌクフロヌに぀いおは、[マヌケットプレむスなしで開発する](/docs/ja/plugins/create#develop-without-a-marketplace)を参照しおください。

818 

819| フラグ | 説明 | 䟋 |

820| :-------------------- | :-------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------- |

821| `--plugin-dir <path>` | ディレクトリたたはそのディレクトリの `.zip` アヌカむブからプラグむンをロヌドしたす。プラグむンのフォルダは、`.claude-plugin/plugin.json` を保持する各子フォルダをロヌドしたす。各フラグは 1 ぀のパスを取りたす | `claude --plugin-dir ./my-plugin --plugin-dir ./other.zip` |

822| `--plugin-url <url>` | URL からプラグむン `.zip` アヌカむブをフェッチしたす。フラグを繰り返すか、1 ぀の匕甚笊で囲たれた倀で耇数の URL をスペヌス区切りで枡したす | `claude --plugin-url "https://example.com/a.zip https://example.com/b.zip"` |

823 

824どちらかのフラグがロヌドするプラグむンはセッションのみのプラグむンです。`claude plugin list` はそれを `<name>@inline` ずしおスコヌプ `session` で衚瀺したすが、同じフラグがサブコマンドの前にある堎合のみです。たずえば、`claude --plugin-dir ./my-plugin plugin list` を実行しおください。

825 

826セッションのみのプラグむンがむンストヌル枈みプラグむンず名前を共有する堎合、Claude Code はそのセッションのセッションのみのコピヌをロヌドし、むンストヌル枈みのコピヌをスキップしたす。むンストヌル枈みのコピヌは、`claude plugin disable <name>@inline` でセッションのみのコピヌを無効にした堎合、たたは管理蚭定がそのプラグむン名をロックする堎合にロヌドされたす。優先床に぀いおは、[プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading)を参照しおください。

827 

828管理者は、[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables) 倉数で名前が付けられたフォルダを含む䞡方のフラグを拒吊できたす。管理蚭定 [`disableSideloadFlags`](/docs/ja/settings-reference#disablesideloadflags)。Claude Code はその埌、フラグが組織の管理蚭定によっお無効化されおいるこずを出力し、起動せずに `1` で終了したす。

829 

830Agent SDK から、[`plugins`](/docs/ja/agent-sdk/plugins) オプションは `--plugin-dir` ず同等です。

831 

832<h2 id="next-steps">

833 次のステップ

834</h2>

835 

836* [プラグむンのむンストヌルず管理](/docs/ja/plugins/install): ステップず同じ操䜜。各ステップで衚瀺される内容

837* [プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading): 各コマンドがディスク䞊で䜕を倉曎し、どのスコヌプが有効になるか

838* [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting): むンストヌル、マヌケットプレむス、ロヌド、および怜蚌゚ラヌメッセヌゞずその修正

839* [プラグむンマニフェストリファレンス](/docs/ja/plugins/manifest-reference): `claude plugin validate` がチェックするフィヌルド

plugins/code-intelligence.md +156 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# コヌド むンテリゞェンス プラグむン

6 

7> 蚀語サヌバヌ プラグむンをむンストヌルしお、Claude が線集埌の型゚ラヌを怜出し、シンボルでコヌドをナビゲヌトできるようにし、LSP プラグむン掚奚ダむアログに応答したす。

8 

9コヌド むンテリゞェンス プラグむンは、゚ディタヌが持぀ラむブ蚺断ず定矩ぞのゞャンプを Claude に提䟛するため、Claude は自身の線集によっお導入される型゚ラヌず䞍足しおいるむンポヌトをビルドを実行する前にキャッチでき、テキスト怜玢の代わりにシンボルで定矩ず参照を芋぀けるこずができたす。

10 

11各プラグむンは、Language Server ProtocolLSPを通じお 1 ぀の蚀語の蚀語サヌバヌに Claude Code を接続したす。プラグむンは Anthropic の公匏マヌケットプレむスからむンストヌルし、蚀語サヌバヌ バむナリをマシンにむンストヌルしたす。

12 

13<Note>

14 コヌド むンテリゞェンス プラグむンはタヌミナル セッションで動䜜したす。[クラりド セッション](/docs/ja/claude-code-on-the-web)では、Claude Code はプラグむン蚀語サヌバヌを起動しないため、Claude はそこで蚺断たたはコヌド ナビゲヌションを取埗したせん。独自の蚀語サヌバヌ プラグむンを䜜成するか、プラグむンがない蚀語サヌバヌを接続するには、[プラグむン コンポヌネントの LSP サヌバヌ](/docs/ja/plugins/components#lsp-servers)を参照しおください。

15</Note>

16 

17開始するには、[コヌド むンテリゞェンス プラグむンをむンストヌルする](#install-a-code-intelligence-plugin)の䞋の衚で蚀語を芋぀けおください。その衚のプラグむンは Anthropic の[公匏プラグむン マヌケットプレむス](/docs/ja/plugins/anthropic-marketplaces)から提䟛されおいたす。

18 

19既に **LSP プラグむン掚奚**ダむアログを芋た堎合は、[掚奚ダむアログを受け入れるか华䞋する](#accept-or-dismiss-the-recommendation-dialog)を参照しお、各遞択肢の機胜を確認しおください。

20 

21<h2 id="install-a-code-intelligence-plugin">

22 コヌド むンテリゞェンス プラグむンをむンストヌルする

23</h2>

24 

25コヌド むンテリゞェンス プラグむンは、蚀語サヌバヌを起動するコマンドず、それが凊理するファむル拡匵子を Claude Code に䌝えたす。蚀語サヌバヌは含たれおいたせん。たず蚀語サヌバヌ バむナリをむンストヌルし、次にプラグむンをむンストヌルし、サヌバヌが起動するこずを確認したす。

26 

27<Steps>

28 <Step title="蚀語サヌバヌ バむナリをむンストヌルする">

29 䞋の衚で蚀語を芋぀け、その行のバむナリをむンストヌルしたす。蚀語がリストされおいない堎合は、[公匏プラグむンのない蚀語を远加する](#add-a-language-without-an-official-plugin)を参照しおください。

30 

31 | 蚀語 | プラグむン | バむナリ |

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

33 | C/C++ | [`clangd-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/clangd-lsp) | `clangd` |

34 | C# | [`csharp-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/csharp-lsp) | `csharp-ls` |

35 | Go | [`gopls-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/gopls-lsp) | `gopls` |

36 | Java | [`jdtls-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/jdtls-lsp) | `jdtls` |

37 | Kotlin | [`kotlin-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/kotlin-lsp) | `kotlin-lsp` |

38 | Liquid | [`liquid-lsp`](https://github.com/Shopify/liquid-skills/tree/main/plugins/liquid-lsp) | `shopify`Shopify CLI から |

39 | Lua | [`lua-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/lua-lsp) | `lua-language-server` |

40 | PHP | [`php-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/php-lsp) | `intelephense` |

41 | Python | [`pyright-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/pyright-lsp) | `pyright-langserver` |

42 | Ruby | [`ruby-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/ruby-lsp) | `ruby-lsp` |

43 | Rust | [`rust-analyzer-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/rust-analyzer-lsp) | `rust-analyzer` |

44 | Swift | [`swift-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/swift-lsp) | `sourcekit-lsp` |

45 | TypeScript ず JavaScript | [`typescript-lsp`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/typescript-lsp) | `typescript-language-server` |

46 

47 Anthropic は `liquid-lsp` を陀く衚内のすべおのプラグむンを保守しおおり、`liquid-lsp` は Shopify が保守し、公匏マヌケットプレむスにリストされおいたす。

48 

49 バむナリをむンストヌルするコマンドを芋぀けるには、衚のプラグむンのリンクをたどっお README を参照しおください。TypeScript の堎合、そのコマンドは `npm install -g typescript-language-server typescript` です。

50 

51 バむナリをむンストヌルした埌、`claude` を起動するシェルの `PATH` 䞊にあるこずを確認したす。䟋えば `which typescript-language-server` たたは PowerShell では `Get-Command typescript-language-server` を䜿甚したす。

52 </Step>

53 

54 <Step title="プラグむンをむンストヌルする">

55 ステップ 1 の衚で蚀語甚にリストされおいるプラグむンをむンストヌルするには、Claude Code セッション内で `/plugin install` を実行し、`typescript-lsp` をそのプラグむンの名前に眮き換えたす。

56 

57 ```

58 /plugin install typescript-lsp@claude-plugins-official

59 ```

60 

61 確認メッセヌゞは、プラグむンが珟圚アクティブであるか、`/reload-plugins` が必芁かを瀺したす。むンストヌルが `Marketplace "claude-plugins-official" not found` で倱敗した堎合は、[その゚ラヌのトラブルシュヌティング ゚ントリ](/docs/ja/plugins/troubleshooting#marketplace-claude-plugins-official-not-found)を参照しおください。プラグむンがむンストヌルされる堎所を制埡するか、Claude Code 内ではなくシェルからむンストヌルを実行するには、[プラグむンをむンストヌルする](/docs/ja/plugins/install)を参照しおください。

62 </Step>

63 

64 <Step title="サヌバヌが起動するこずを確認する">

65 蚀語サヌバヌは、Claude がそのプラグむンの拡匵子の 1 ぀を持぀ファむルを初めお゚ディットするずきに起動したす。動䜜を確認するには、Claude にそのプログラミング蚀語のファむルに型゚ラヌを導入しおから修正するよう䟝頌したす。次に、䌚話で蚺断行を確認したす。

66 

67 * **蚺断行が衚瀺される**: ゚ラヌを導入した゚ディットの䞋に `Found N new diagnostic issues in M files (ctrl+o to expand)` が衚瀺されるこずは、サヌバヌが起動したこずを意味したす。

68 * **蚺断行が衚瀺されない**: `/plugin` を実行しお **Errors** タブを開きたす。`Executable not found in $PATH: "<binary>"` ず読む行は、むンストヌルするバむナリを瀺したす。タブにそのような行がない堎合は、[コヌド むンテリゞェンスのトラブルシュヌティング](#troubleshoot-code-intelligence)を参照しおください。

69 

70 䞍足しおいるバむナリをむンストヌルした埌、Claude Code は Claude が䞀臎するファむルを゚ディットするたびに次回詊行したす。バむナリを `claude` を起動したシェルの `PATH` 䞊にないディレクトリにむンストヌルした堎合は、それが存圚するシェルから新しいセッションを開始したす。

71 </Step>

72</Steps>

73 

74<h2 id="see-what-claude-gains">

75 Claude が埗るもの

76</h2>

77 

78蚀語サヌバヌが実行されおいる堎合、Claude は蚺断ずコヌド ナビゲヌションを取埗したす。

79 

80* **゚ディット埌の蚺断**: Claude がサヌバヌが凊理するファむルを゚ディットたたは䜜成するたびに、Claude はサヌバヌが報告する゚ラヌず譊告を取埗したす。コンパむラを実行せずに、導入した型゚ラヌ、䞍足しおいるむンポヌト、たたは構文゚ラヌを芋たす。

81* **コヌド ナビゲヌション**: Claude はテキストを怜玢する代わりに、サヌバヌを通じおシンボルを怜玢する `LSP` ツヌルを取埗したす。ツヌルは読み取り専甚です。Claude がツヌルで怜玢できるもの、および暩限がツヌルにどのように適甚されるかに぀いおは、[LSP ツヌル動䜜](/docs/ja/tools-reference#lsp-tool-behavior)を参照しおください。

82 

83<h3 id="read-the-diagnostics-yourself">

84 蚺断を自分で読む

85</h3>

86 

87Claude がサヌバヌが凊理するファむルを゚ディットした埌、䌚話は `Found N new diagnostic issues` サマリヌのみを衚瀺したす。問題自䜓を読むには、**Ctrl+O** を抌したす。

88 

89<h2 id="accept-or-dismiss-the-recommendation-dialog">

90 掚奚ダむアログを受け入れるか华䞋する

91</h2>

92 

93蚀語サヌバヌ バむナリが既に `PATH` 䞊にあり、それを䜿甚するプラグむンがむンストヌルされおいない堎合、Claude Code は **LSP プラグむン掚奚**ずいうタむトルのダむアログでプラグむンをむンストヌルするよう提䟛したす。

94 

95<h3 id="when-the-recommendation-dialog-appears">

96 掚奚ダむアログが衚瀺される堎合

97</h3>

98 

99**LSP プラグむン掚奚**ダむアログは Claude がファむルを゚ディットした埌に衚瀺される堎合がありたす。これらの条件は、衚瀺されるかどうか、どのプラグむンを提䟛するかを決定したす。

100 

101* **プラグむンがファむルず䞀臎する**: 远加したマヌケットプレむスの 1 ぀、たたは Claude Code が登録した公匏マヌケットプレむスが、そのファむルの拡匵子のコヌド むンテリゞェンス プラグむンをリストし、プラグむンのバむナリがむンストヌルされおいたす。

102* **公匏が最初**: 耇数のマヌケットプレむスが拡匵子のプラグむンを提䟛する堎合、ダむアログは公匏マヌケットプレむスのプラグむンを提䟛したす。

103* **セッションごずに 1 回**: ダむアログはセッションで最倧 1 回、Claude が゚ディットする最初の䞀臎するファむルに察しお衚瀺されたす。

104* **クラりド セッションではない**: タヌミナルが [`claude --cloud`](/docs/ja/claude-code-on-the-web#from-terminal-to-cloud)で開始したセッションなどのクラりド セッションに接続されおいる堎合、ダむアログは衚瀺されたせん。

105 

106<h3 id="respond-to-the-recommendation-dialog">

107 掚奚ダむアログに応答する

108</h3>

109 

110**LSP プラグむン掚奚**ダむアログはプラグむンに名前を付け、これらの遞択肢を提䟛したす。

111 

112* **はい、むンストヌル**: Claude Code はプラグむンをナヌザヌ アカりント甚にむンストヌルし、`<plugin> installed · restart to apply` を出力したす。新しいセッションを開始しおサヌバヌを読み蟌みたす。

113* **いいえ、埌で**: ダむアログが閉じ、埌のセッションでプラグむンを再床提䟛できたす。**Esc** を抌すず同じです。

114* **このプラグむンは衚瀺しない**: ダむアログはそのプラグむンに察しお衚瀺されなくなり、他のプラグむンに察しおは衚瀺されたす。

115* **すべおの LSP 掚奚を無効にする**: ダむアログはすべおの蚀語に察しお衚瀺されなくなりたす。

116 

117オプションを遞択しない堎合、Claude Code は 30 秒埌にそれを閉じ、無芖されたずカりントしたす。カりントはセッション党䜓で保持されたす。5 ぀の無芖されたダむアログの埌、Claude Code はプラグむンの掚奚を停止したす。これは **すべおの LSP 掚奚を無効にする**を遞択した堎合ず同じです。

118 

119<h3 id="turn-recommendations-back-on">

120 掚奚をオンに戻す

121</h3>

122 

123**LSP プラグむン掚奚**ダむアログは、**すべおの LSP 掚奚を無効にする**を遞択するか、5 回無芖した埌に衚瀺されなくなりたす。

124 

125* **無効たたは 5 回無芖**: どちらの堎合でもオンに戻すには、Claude Code 独自の蚭定ファむルである `~/.claude.json` から `lspRecommendationDisabled` ず `lspRecommendationIgnoredCount` キヌを削陀したす。

126* **このプラグむンは衚瀺しない**: **このプラグむンは衚瀺しない**を遞択し、そのプラグむンを再床提䟛したい堎合は、同じファむルの `lspRecommendationNeverPlugins` リストからその `name@marketplace` ID を削陀したす。

127 

128<h2 id="troubleshoot-code-intelligence">

129 コヌド むンテリゞェンスのトラブルシュヌティング

130</h2>

131 

132プラグむンのトラブルシュヌティング ペヌゞでは、[蚀語サヌバヌが起動しない、メモリ䜿甚量が倚い、たたは蚺断が正しくない](/docs/ja/plugins/troubleshooting#language-server-doesnt-start)の䞋にあるコヌド むンテリゞェンス プラグむンに固有の症状に぀いお説明しおいたす。

133 

134* **蚀語サヌバヌが起動しない**`/plugin` の **Errors** タブに `Executable not found in $PATH` が衚瀺されるか、Claude が蚀語の蚺断をレポヌトしたせん。

135* **メモリ䜿甚量が倚い**サヌバヌがプロゞェクトをむンデックスしおいる間、メモリ䜿甚量が増加したす。

136* **モノレポでの誀怜知蚺断**蚺断が、実際には解決されおいるむンポヌトを未解決ずしおレポヌトしたす。

137 

138<h2 id="add-a-language-without-an-official-plugin">

139 公匏プラグむンのない蚀語を远加する

140</h2>

141 

142蚀語が[公匏プラグむンの衚](#install-a-code-intelligence-plugin)にない堎合でも、蚀語サヌバヌを接続できたす。

143 

1441. サヌバヌ コマンドずそれが凊理するファむル拡匵子に名前を付ける `.lsp.json` ファむルを䜿甚しおプラグむンを䜜成したす。

1452. 次に、[`--plugin-dir`](/docs/ja/plugins/cli-reference#flags-that-load-a-plugin-for-one-session)を䜿甚しおプラグむンを読み蟌むか、マヌケットプレむスに公開したす。

146 

147ファむルのフィヌルドず実装䟋に぀いおは、[プラグむン コンポヌネント内の LSP サヌバヌ](/docs/ja/plugins/components#lsp-servers)を参照しおください。

148 

149<h2 id="next-steps">

150 次のステップ

151</h2>

152 

153* [プラグむン コンポヌネント内の LSP サヌバヌ](/docs/ja/plugins/components#lsp-servers): 公匏プラグむンがない蚀語サヌバヌの `.lsp.json` を䜜成したす。

154* [プラグむンをむンストヌルしお管理する](/docs/ja/plugins/install): スコヌプ、曎新、アンむンストヌル

155* [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting): このペヌゞの蚀語サヌバヌ以倖のロヌド ゚ラヌ

156* [公匏マヌケットプレむスでプラグむンを芋぀ける](/docs/ja/plugins/anthropic-marketplaces#find-plugins-in-the-official-marketplace): 公匏マヌケットプレむスの残りを参照する堎所

plugins/components.md +1130 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンにコンポヌネントを远加する

6 

7> スキル、フック、MCP サヌバヌ、その他すべおのコンポヌネントタむプを Claude Code プラグむンに远加し、各コンポヌネントの怜蚌䟋を含めたす。

8 

9export const Piece = ({id, children}) => <div className="pe-piece" data-piece={id}>{children}</div>;

10 

11export const PluginExplorer = ({children}) => {

12 const PIECES = [{

13 id: 'manifest',

14 name: 'Manifest',

15 path: '.claude-plugin/plugin.json',

16 required: "Required by Anthropic's directory",

17 lines: [{

18 depth: 0,

19 kind: 'folder',

20 text: '.claude-plugin/'

21 }, {

22 depth: 1,

23 kind: 'file',

24 text: 'plugin.json'

25 }],

26 href: '/en/plugins/manifest-reference#manifest-file',

27 linkText: 'Go to the manifest reference'

28 }, {

29 id: 'skills',

30 name: 'Skills',

31 path: 'skills/review/SKILL.md',

32 lines: [{

33 depth: 0,

34 kind: 'folder',

35 text: 'skills/'

36 }, {

37 depth: 1,

38 kind: 'folder',

39 text: 'review/'

40 }, {

41 depth: 2,

42 kind: 'file',

43 text: 'SKILL.md'

44 }],

45 href: '/en/plugins/components#skills',

46 linkText: 'Go to the Skills section'

47 }, {

48 id: 'commands',

49 name: 'Commands',

50 path: 'commands/about.md',

51 lines: [{

52 depth: 0,

53 kind: 'folder',

54 text: 'commands/'

55 }, {

56 depth: 1,

57 kind: 'file',

58 text: 'about.md'

59 }],

60 href: '/en/plugins/components#commands',

61 linkText: 'Go to the Commands section'

62 }, {

63 id: 'agents',

64 name: 'Agents',

65 path: 'agents/security-reviewer.md',

66 lines: [{

67 depth: 0,

68 kind: 'folder',

69 text: 'agents/'

70 }, {

71 depth: 1,

72 kind: 'file',

73 text: 'security-reviewer.md'

74 }],

75 href: '/en/plugins/components#agents',

76 linkText: 'Go to the Agents section'

77 }, {

78 id: 'hooks',

79 name: 'Hooks',

80 path: 'hooks/hooks.json',

81 lines: [{

82 depth: 0,

83 kind: 'folder',

84 text: 'hooks/'

85 }, {

86 depth: 1,

87 kind: 'file',

88 text: 'hooks.json'

89 }],

90 href: '/en/plugins/components#hooks',

91 linkText: 'Go to the Hooks section'

92 }, {

93 id: 'monitors',

94 name: 'Monitors',

95 path: 'monitors/monitors.json',

96 lines: [{

97 depth: 0,

98 kind: 'folder',

99 text: 'monitors/'

100 }, {

101 depth: 1,

102 kind: 'file',

103 text: 'monitors.json'

104 }],

105 href: '/en/plugins/components#monitors',

106 linkText: 'Go to the Monitors section'

107 }, {

108 id: 'output-styles',

109 name: 'Output styles',

110 path: 'output-styles/terse.md',

111 lines: [{

112 depth: 0,

113 kind: 'folder',

114 text: 'output-styles/'

115 }, {

116 depth: 1,

117 kind: 'file',

118 text: 'terse.md'

119 }],

120 href: '/en/plugins/components#themes-and-output-styles',

121 linkText: 'Go to the Themes and output styles section'

122 }, {

123 id: 'themes',

124 name: 'Themes',

125 path: 'themes/dracula.json',

126 lines: [{

127 depth: 0,

128 kind: 'folder',

129 text: 'themes/'

130 }, {

131 depth: 1,

132 kind: 'file',

133 text: 'dracula.json'

134 }],

135 href: '/en/plugins/components#themes-and-output-styles',

136 linkText: 'Go to the Themes and output styles section'

137 }, {

138 id: 'workflows',

139 name: 'Workflows',

140 path: 'workflows/audit-routes.js',

141 lines: [{

142 depth: 0,

143 kind: 'folder',

144 text: 'workflows/'

145 }, {

146 depth: 1,

147 kind: 'file',

148 text: 'audit-routes.js'

149 }],

150 href: '/en/workflows#distribute-a-workflow-in-a-plugin',

151 linkText: 'Go to Distribute a workflow in a plugin'

152 }, {

153 id: 'bin',

154 name: 'Executables',

155 path: 'bin/hello-plugin',

156 lines: [{

157 depth: 0,

158 kind: 'folder',

159 text: 'bin/'

160 }, {

161 depth: 1,

162 kind: 'file',

163 text: 'hello-plugin'

164 }],

165 href: '/en/plugins/components#executables',

166 linkText: 'Go to the Executables section'

167 }, {

168 id: 'scripts',

169 name: 'Scripts',

170 path: 'scripts/format.sh',

171 lines: [{

172 depth: 0,

173 kind: 'folder',

174 text: 'scripts/'

175 }, {

176 depth: 1,

177 kind: 'file',

178 text: 'format.sh'

179 }],

180 href: '/en/plugins/components#hooks',

181 linkText: 'Go to the Hooks section'

182 }, {

183 id: 'settings',

184 name: 'Default settings',

185 path: 'settings.json',

186 lines: [{

187 depth: 0,

188 kind: 'file',

189 text: 'settings.json'

190 }],

191 href: '/en/plugins/components#default-settings',

192 linkText: 'Go to the Default settings section'

193 }, {

194 id: 'mcp',

195 name: 'MCP servers',

196 path: '.mcp.json',

197 lines: [{

198 depth: 0,

199 kind: 'file',

200 text: '.mcp.json'

201 }],

202 href: '/en/plugins/components#mcp-servers',

203 linkText: 'Go to the MCP servers section'

204 }, {

205 id: 'lsp',

206 name: 'LSP servers',

207 path: '.lsp.json',

208 lines: [{

209 depth: 0,

210 kind: 'file',

211 text: '.lsp.json'

212 }],

213 href: '/en/plugins/components#lsp-servers',

214 linkText: 'Go to the LSP servers section'

215 }];

216 const [selectedId, setSelectedId] = useState('manifest');

217 const [isFullscreen, setIsFullscreen] = useState(false);

218 const rootRef = useRef(null);

219 useEffect(() => {

220 const onFsChange = () => setIsFullscreen(!!document.fullscreenElement);

221 document.addEventListener('fullscreenchange', onFsChange);

222 return () => document.removeEventListener('fullscreenchange', onFsChange);

223 }, []);

224 const toggleFullscreen = () => {

225 if (!rootRef.current) return;

226 if (document.fullscreenElement) document.exitFullscreen(); else rootRef.current.requestFullscreen().catch(() => {});

227 };

228 const selected = PIECES.find(p => p.id === selectedId) || PIECES[0];

229 const onTreeKeyDown = e => {

230 const keys = ['ArrowDown', 'ArrowUp', 'Home', 'End'];

231 if (keys.indexOf(e.key) === -1) return;

232 const i = PIECES.findIndex(p => p.id === selectedId);

233 let next = i;

234 if (e.key === 'ArrowDown') next = Math.min(PIECES.length - 1, i + 1);

235 if (e.key === 'ArrowUp') next = Math.max(0, i - 1);

236 if (e.key === 'Home') next = 0;

237 if (e.key === 'End') next = PIECES.length - 1;

238 e.preventDefault();

239 if (next === i) return;

240 const id = PIECES[next].id;

241 setSelectedId(id);

242 const el = document.getElementById('pe-node-' + id);

243 if (el) el.focus();

244 };

245 const FolderIcon = () => <svg className="pe-icon" width="15" height="15" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.3" strokeLinejoin="round" aria-hidden="true">

246 <path d="M1.5 4.5a1 1 0 0 1 1-1h3.2l1.3 1.5h6a1 1 0 0 1 1 1V12a1 1 0 0 1-1 1h-10.5a1 1 0 0 1-1-1z" />

247 </svg>;

248 const FileIcon = () => <svg className="pe-icon" width="15" height="15" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.3" strokeLinejoin="round" aria-hidden="true">

249 <path d="M4 1.5h5.5L13 5v9.5H4z" />

250 <path d="M9.5 1.5V5H13" />

251 </svg>;

252 return <div ref={rootRef} className={isFullscreen ? 'pe-root pe-fullscreen not-prose' : 'pe-root not-prose'} data-selected={selected.id}>

253 <style>{`

254 .pe-root {

255 --pe-mono: var(--font-mono, ui-monospace, SFMono-Regular, Menlo, monospace);

256 --pe-accent: #D97757;

257 --pe-accent-text: #A8502F;

258 --pe-accent-bg: rgba(217,119,87,0.10);

259 --pe-bg: #FFFFFF;

260 --pe-surface: #FAFAF7;

261 --pe-hover: #F0EEE6;

262 --pe-border: #E8E6DC;

263 --pe-text: #141413;

264 --pe-text-2: #3D3D3A;

265 --pe-text-3: #5E5D59;

266 font-family: inherit;

267 background: var(--pe-bg);

268 color: var(--pe-text);

269 border: 1px solid var(--pe-border);

270 border-radius: 12px;

271 margin: 1.5rem 0;

272 overflow: hidden;

273 box-sizing: border-box;

274 }

275 .dark .pe-root {

276 --pe-accent-text: #EBA98F;

277 --pe-accent-bg: rgba(217,119,87,0.18);

278 --pe-bg: #1A1918;

279 --pe-surface: #232221;

280 --pe-hover: #2E2D2B;

281 --pe-border: #3A3936;

282 --pe-text: #F1EFE9;

283 --pe-text-2: #D6D4CA;

284 --pe-text-3: #B8B5AD;

285 }

286 .pe-root *, .pe-root *::before, .pe-root *::after { box-sizing: border-box; }

287 .pe-head { display: flex; align-items: flex-start; gap: 12px; padding: 18px 24px 16px; border-bottom: 1px solid var(--pe-border); }

288 .pe-head-text { flex: 1; min-width: 0; }

289 .pe-fs-btn { flex-shrink: 0; width: 32px; height: 32px; display: inline-flex; align-items: center; justify-content: center; border: 1px solid var(--pe-border); border-radius: 6px; background: var(--pe-surface); color: var(--pe-text-2); font-size: 15px; line-height: 1; cursor: pointer; }

290 .pe-fs-btn:hover { background: var(--pe-hover); }

291 .pe-fs-btn:focus-visible { outline: 2px solid var(--pe-accent); outline-offset: 2px; }

292 .pe-fullscreen { border-radius: 0; height: 100vh; display: flex; flex-direction: column; overflow: auto; }

293 .pe-fullscreen .pe-body { flex: 1; }

294 .pe-title { font-size: 19px; font-weight: 600; line-height: 1.3; color: var(--pe-text); margin: 0; }

295 .pe-sub { font-size: 15px; line-height: 1.5; color: var(--pe-text-3); margin: 4px 0 0; }

296 .pe-sub code { font-family: var(--pe-mono); font-size: 0.88em; padding: 1px 5px; border-radius: 4px; background: var(--pe-surface); border: 1px solid var(--pe-border); }

297 .pe-body { display: flex; align-items: stretch; }

298 .pe-tree-pane { width: 270px; flex-shrink: 0; background: var(--pe-surface); border-right: 1px solid var(--pe-border); padding: 16px 0 12px; }

299 .pe-panel { flex: 1; min-width: 0; padding: 16px 24px 24px; }

300 .pe-caption { font-size: 13px; font-weight: 600; color: var(--pe-text-3); margin: 0 0 10px; }

301 .pe-tree-pane .pe-caption { padding: 0 16px; }

302 .pe-rootline { display: flex; align-items: center; gap: 7px; padding: 3px 16px; font-family: var(--pe-mono); font-size: 13.5px; color: var(--pe-text-3); }

303 .pe-node {

304 display: block; width: 100%; margin: 0; padding: 3px 16px 3px 30px; text-align: left; cursor: pointer;

305 background: transparent; color: var(--pe-text-2);

306 border: none; border-left: 3px solid transparent;

307 font-family: var(--pe-mono); font-size: 13.5px; line-height: 1.4;

308 }

309 .pe-node:hover { background: var(--pe-hover); }

310 .pe-node:focus-visible { outline: 2px solid var(--pe-accent); outline-offset: -2px; }

311 .pe-node[aria-pressed="true"] { background: var(--pe-accent-bg); border-left-color: var(--pe-accent); color: var(--pe-accent-text); font-weight: 600; }

312 .pe-line { display: flex; align-items: center; gap: 7px; padding: 2px 0; }

313 .pe-line-tree { flex-wrap: wrap; }

314 .pe-line-tree .pe-req { flex-basis: 100%; margin: 2px 0 0 22px; white-space: normal; width: fit-content; max-width: calc(100% - 22px); }

315 .pe-line span { overflow-wrap: anywhere; }

316 .pe-piece { display: none; font-size: 16px; line-height: 1.6; color: var(--pe-text-2); }

317 .pe-root[data-selected="manifest"] .pe-piece[data-piece="manifest"],

318 .pe-root[data-selected="skills"] .pe-piece[data-piece="skills"],

319 .pe-root[data-selected="commands"] .pe-piece[data-piece="commands"],

320 .pe-root[data-selected="agents"] .pe-piece[data-piece="agents"],

321 .pe-root[data-selected="hooks"] .pe-piece[data-piece="hooks"],

322 .pe-root[data-selected="monitors"] .pe-piece[data-piece="monitors"],

323 .pe-root[data-selected="output-styles"] .pe-piece[data-piece="output-styles"],

324 .pe-root[data-selected="themes"] .pe-piece[data-piece="themes"],

325 .pe-root[data-selected="workflows"] .pe-piece[data-piece="workflows"],

326 .pe-root[data-selected="bin"] .pe-piece[data-piece="bin"],

327 .pe-root[data-selected="scripts"] .pe-piece[data-piece="scripts"],

328 .pe-root[data-selected="settings"] .pe-piece[data-piece="settings"],

329 .pe-root[data-selected="mcp"] .pe-piece[data-piece="mcp"],

330 .pe-root[data-selected="lsp"] .pe-piece[data-piece="lsp"] { display: block; }

331 .pe-piece p { margin: 0 0 10px; }

332 .pe-piece p:last-child { margin-bottom: 0; }

333 .pe-piece code { font-family: var(--pe-mono); font-size: 0.88em; padding: 1px 5px; border-radius: 4px; background: var(--pe-surface); border: 1px solid var(--pe-border); }

334 .pe-piece .code-block { margin: 12px 0 0; }

335 .pe-piece pre code { padding: 0; border: none; background: none; }

336 .pe-piece a { color: var(--pe-accent-text); }

337 .pe-line-compact { display: none; }

338 .pe-icon { flex-shrink: 0; }

339 .pe-req { margin-left: 8px; padding: 0 6px; border-radius: 999px; font-size: 11px; line-height: 18px; letter-spacing: .02em; color: var(--pe-accent-text); border: 1px solid var(--pe-border); background: var(--pe-surface); white-space: nowrap; font-weight: 500; vertical-align: middle; }

340 .pe-name { font-size: 22px; font-weight: 600; line-height: 1.25; letter-spacing: -0.2px; color: var(--pe-text); margin: 0; }

341 .pe-path { font-family: var(--pe-mono); font-size: 13.5px; color: var(--pe-accent-text); margin: 4px 0 0; overflow-wrap: anywhere; }

342 .pe-block { margin: 20px 0 0; }

343 .pe-link {

344 display: inline-block; margin: 24px 0 0; padding: 8px 14px; border-radius: 8px;

345 font-size: 14.5px; font-weight: 600; text-decoration: none;

346 color: var(--pe-accent-text); background: var(--pe-accent-bg); border: 1px solid var(--pe-accent);

347 }

348 .pe-link:hover { filter: brightness(0.97); }

349 .pe-link:focus-visible { outline: 2px solid var(--pe-accent); outline-offset: 2px; }

350 @media (max-width: 700px) {

351 .pe-head { padding: 16px 16px 14px; }

352 .pe-body { flex-direction: column; }

353 .pe-tree-pane { width: 100%; border-right: none; border-bottom: 1px solid var(--pe-border); }

354 .pe-line-tree { display: none; }

355 .pe-line-compact { display: flex; }

356 .pe-panel { padding: 16px 16px 20px; }

357 }

358 `}</style>

359 

360 <div className="pe-head">

361 <div className="pe-head-text">

362 <div className="pe-title">What goes in a plugin</div>

363 <div className="pe-sub">This example plugin, <code>my-plugin</code>, has one of every kind of component, each in its default location. Select a file or folder to read what it’s for and see what goes in it.</div>

364 </div>

365 <button type="button" className="pe-fs-btn" onClick={toggleFullscreen} aria-label={isFullscreen ? 'Exit fullscreen' : 'Fullscreen'} title={isFullscreen ? 'Exit fullscreen' : 'Fullscreen'}>

366 {isFullscreen ? '‡' : '⛶'}

367 </button>

368 </div>

369 

370 <div className="pe-body">

371 <div className="pe-tree-pane">

372 <div className="pe-caption" id="pe-tree-caption">Plugin directory</div>

373 <div role="group" aria-labelledby="pe-tree-caption" onKeyDown={onTreeKeyDown}>

374 <div className="pe-rootline"><FolderIcon /><span>my-plugin/</span></div>

375 {PIECES.map(p => <button key={p.id} id={'pe-node-' + p.id} type="button" className="pe-node" aria-pressed={p.id === selected.id} aria-label={p.name + ', ' + p.path} onClick={() => setSelectedId(p.id)}>

376 {p.lines.map((line, i) => <span key={i} className="pe-line pe-line-tree" style={{

377 paddingLeft: line.depth * 18 + 'px'

378 }}>

379 {line.kind === 'folder' ? <FolderIcon /> : <FileIcon />}

380 <span>{line.text}</span>

381 {p.required && i === p.lines.length - 1 ? <span className="pe-req">{p.required}</span> : null}

382 </span>)}

383 <span className="pe-line pe-line-compact">

384 <FileIcon />

385 <span>{p.path}</span>

386 {p.required ? <span className="pe-req">{p.required}</span> : null}

387 </span>

388 </button>)}

389 </div>

390 </div>

391 

392 <div className="pe-panel" role="region" aria-labelledby="pe-panel-caption" aria-live="polite" aria-atomic="true">

393 <div className="pe-caption" id="pe-panel-caption">Selected piece</div>

394 <div className="pe-name">{selected.name}{selected.required ? <span className="pe-req">{selected.required}</span> : null}</div>

395 <div className="pe-path">{selected.path}</div>

396 

397 <div className="pe-block">{children}</div>

398 

399 <a className="pe-link" href={selected.href}>{selected.linkText}</a>

400 </div>

401 </div>

402 </div>;

403};

404 

405Claude Code プラグむンはスキル、゚ヌゞェント、フック、MCP サヌバヌなどのコンポヌネントから構築されたす。各コンポヌネントはプラグむン内にデフォルトフォルダを持ち、`.claude-plugin/plugin.json` 内のオプションのマニフェストキヌがそのフォルダを眮き換えるか远加し、ナヌザヌが芋る名前がありたす。各キヌの完党なフィヌルドテヌブルに぀いおは、[マニフェストリファレンス](/docs/ja/plugins/manifest-reference#fields)を参照しおください。

406 

407このペヌゞを䜿甚しお、既に読み蟌たれおいるプラグむンにコンポヌネントを远加したす。

408 

409コンポヌネントを远加した埌、実行䞭のセッションで `/reload-plugins` を実行するか、新しいセッションを開始しお Claude Code がそれを読み蟌むようにしたす。コンポヌネントのファむルを読み蟌む前に確認するには、プラグむンディレクトリからシェルで [`claude plugin validate .`](/docs/ja/plugins/cli-reference#plugin-validate) を実行したす。

410 

411<Note>

412 これらのケヌスは他のペヌゞで説明されおいたす

413 

414 * **最初のプラグむンを構築する**[プラグむンを䜜成する](/docs/ja/plugins/create)から始めたす

415 * **他のナヌザヌのプラグむンをむンストヌルする**[プラグむンをむンストヌルする](/docs/ja/plugins/install)を参照しおください

416 * **プラグむンのナヌザヌが claude.ai たたは Cowork にいる**異なるセットのコンポヌネントがそこに読み蟌たれたす。[claude.ai ず Cowork のプラグむン](https://claude.com/docs/plugins/overview)を参照しおください

417</Note>

418 

419<h2 id="explore-the-plugin-directory">

420 プラグむンディレクトリを探玢する

421</h2>

422 

423゚クスプロヌラヌは、デフォルトの堎所にあらゆる皮類のコンポヌネントを 1 ぀ず぀持぀䟋のプラグむン `my-plugin` を瀺しおいたす

424 

425* レビュヌスキルず `about` コマンド

426* セキュリティレビュヌサブ゚ヌゞェント

427* Claude がファむルを線集した埌にファむルをフォヌマットするフック、およびそれが呌び出す `scripts/` フォルダ

428* ログモニタヌ

429* 出力スタむルずカラヌテヌマ

430* ルヌト監査ワヌクフロヌ

431* `hello-plugin` 実行可胜ファむル

432* デフォルト蚭定

433* ロヌカル MCP サヌバヌず Go 蚀語サヌバヌ

434 

435各ファむルはその圢匏の最小限の有効な䟋であり、有甚であるためではなく圢状を瀺すためにありたす実際のスキルたたぱヌゞェントは完党な指瀺を持ち、倚くの堎合サポヌトファむルを含み、実際のフックたたはモニタヌは実際の䜜業を行いたす。゚クスプロヌラヌの埌のセクションぱクスプロヌラヌず同じファむルを䟋ずしお䜿甚し、より完党なものぞのリンクを提䟛したす。ファむルたたはフォルダを遞択しお、それが䜕のためにあるのか、䜕が含たれるのか、それをカバヌするセクションを芋぀けたす。

436 

437<PluginExplorer>

438 <Piece id="manifest">

439 [マニフェスト](/docs/ja/plugins/manifest-reference)はプラグむンの `.claude-plugin/` ディレクトリ内の `plugin.json` ファむルです。プラグむンのメタデヌタず、Claude Code がナヌザヌに求める `userConfig` 倀が含たれたす。`name` のみが必須です。このマニフェストでは、`description` はナヌザヌが `/plugin` でプラグむンに察しお芋るテキストであり、`version` はナヌザヌをそのバヌゞョンに保ちたす。倉曎するたで

440 

441 ```json theme={null}

442 {

443 "name": "my-plugin",

444 "version": "1.0.0",

445 "description": "Review, formatting, and database tools for this team"

446 }

447 ```

448 </Piece>

449 

450 <Piece id="skills">

451 [スキル](/docs/ja/skills)は `SKILL.md` ファむルです。各スキルを `skills/` の䞋の独自のディレクトリに保存したす。Claude はすべおのスキルの `description` を読み、ナヌザヌが求めるものがそれず䞀臎する堎合ここでプルリク゚ストをレビュヌするよう Claude に求めるなど、Claude はスキルの指瀺を読み蟌んでそれに埓いたす。ナヌザヌは `/my-plugin:review` ずしお盎接実行するこずもできたす

452 

453 ```markdown theme={null}

454 ---

455 description: Reviews a pull request for style and test coverage. Use when asked to review code.

456 ---

457 

458 Review the changed files. Report style problems first, then missing tests.

459 ```

460 </Piece>

461 

462 <Piece id="commands">

463 コマンドは、ナヌザヌが名前で実行する単䞀の Markdown ファむルです。コマンドは叀い圢匏ですスキルは同じ方法で名前で実行でき、独自のディレクトリにサポヌトファむルを含めるこずもできるため、新しいものはスキルずしお蚘述し、既に持っおいるファむルに぀いおは `commands/` を保持したす。このファむルは `/my-plugin:about` になり、スキルず同じフロントマタヌを取りたす

464 

465 ```markdown theme={null}

466 ---

467 description: Summarize the repository

468 ---

469 

470 Summarize what this repository does in three sentences.

471 ```

472 </Piece>

473 

474 <Piece id="agents">

475 [サブ゚ヌゞェント](/docs/ja/sub-agents)は、独自の指瀺ず独自のコンテキストりィンドりを持぀別のアシスタントであり、Claude がタスクを委譲しお結果を取埗できたす。`agents/` の䞋の各 Markdown ファむルは 1 ぀を定矩したすフロントマタヌはそれに名前を付け、い぀䜿甚するかを蚀い、本文はそのシステムプロンプトです。このファむルは `my-plugin:security-reviewer` ずいう名前で、ナヌザヌは `@agent-my-plugin:security-reviewer` で呌び出すこずができたす

476 

477 ```markdown theme={null}

478 ---

479 name: security-reviewer

480 description: Reviews code changes for security issues. Use after edits to authentication or input handling.

481 model: sonnet

482 ---

483 

484 You are a security reviewer. Read the changed files and report injection, authentication, and secrets-handling risks.

485 ```

486 </Piece>

487 

488 <Piece id="hooks">

489 [フック](/docs/ja/hooks-guide)は Claude Code のラむフサむクルの特定の時点すべおのファむル線集埌などで自動的に䜕かを実行したすシェルコマンド、HTTP リク゚スト、MCP ツヌル呌び出し、モデルぞのプロンプト、たたはサブ゚ヌゞェント。プラグむンのフックをプラグむンルヌトの `hooks/hooks.json` に保存したす。このフックは Claude がファむルを曞き蟌むか線集した埌、プラグむンの `scripts/format.sh` を実行したす

490 

491 ```json theme={null}

492 {

493 "hooks": {

494 "PostToolUse": [

495 {

496 "matcher": "Write|Edit",

497 "hooks": [

498 {

499 "type": "command",

500 "command": "\"${CLAUDE_PLUGIN_ROOT}/scripts/format.sh\""

501 }

502 ]

503 }

504 ]

505 }

506 }

507 ```

508 </Piece>

509 

510 <Piece id="monitors">

511 モニタヌはシェルコマンドで、Claude Code はセッションの開始時にバックグラりンドで開始し、セッションが終了するたで実行し続け、[Monitor ツヌル](/docs/ja/tools-reference#monitor-tool)を䜿甚したす。それが出力するものは Claude に通知ずしお到達したす。`when` フィヌルドは、代わりに名前付きスキルが初めお実行されるずきに開始できたす。このモニタヌぱラヌログをテヌルしたす

512 

513 ```json theme={null}

514 [

515 {

516 "name": "error-log",

517 "command": "tail -F ./logs/error.log",

518 "description": "Application error log"

519 }

520 ]

521 ```

522 </Piece>

523 

524 <Piece id="output-styles">

525 プラグむンは[出力スタむル](/docs/ja/output-styles)を含めるこずができたす。これは Claude が返信をフォヌマットおよび衚珟する方法を倉曎したす。各出力スタむルを `output-styles/<name>.md` ずしお保存したす。このスタむルは `/output-style` に `my-plugin:terse` ずしお衚瀺されたす

526 

527 ```markdown theme={null}

528 ---

529 name: terse

530 description: Answer in as few words as possible

531 keep-coding-instructions: true

532 ---

533 

534 Keep every reply short. Skip preambles and summaries.

535 ```

536 </Piece>

537 

538 <Piece id="themes">

539 プラグむンは Claude Code むンタヌフェヌスの[カラヌテヌマ](/docs/ja/terminal-config#create-a-custom-theme)を含めるこずができたす。各テヌマを `themes/<slug>.json` ずしお保存したす。このテヌマは `/theme` に `Dracula` ずしお衚瀺され、`my-plugin` からのものずしおマヌクされたす

540 

541 ```json theme={null}

542 {

543 "name": "Dracula",

544 "base": "dark",

545 "overrides": {

546 "claude": "#bd93f9",

547 "error": "#ff5555"

548 }

549 }

550 ```

551 </Piece>

552 

553 <Piece id="workflows">

554 `workflows/` フォルダは[ワヌクフロヌ](/docs/ja/workflows) `.js` ファむルを保持したす`meta` ブロック、その埌、耇数のサブ゚ヌゞェントを調敎するスクリプト本文。このファむルは `/my-plugin:audit-routes` ずしお実行されたす

555 

556 ```javascript theme={null}

557 export const meta = {

558 name: 'audit-routes',

559 description: 'Audit every route handler for missing auth checks',

560 }

561 

562 const found = await agent('List every .ts file under src/routes/.', {

563 schema: { type: 'object', required: ['files'], properties: { files: { type: 'array', items: { type: 'string' } } } },

564 })

565 

566 const audits = await pipeline(found.files, file =>

567 agent(`Audit ${file} for missing authentication checks.`, { label: file }),

568 )

569 

570 return audits.filter(Boolean)

571 ```

572 </Piece>

573 

574 <Piece id="bin">

575 `bin/` はプラグむンがコマンドラむンツヌルを配垃する方法です。プラグむンが有効な間、Claude Code はこのフォルダをシェルの `PATH` に配眮するため、Claude たたはスキルの指瀺は、ナヌザヌが䜕もむンストヌルするこずなく、ツヌルを名前で実行できたす。この[実行可胜ファむル](#executables)が配眮されおいる堎合、`hello-plugin` は Claude が実行できるコマンドです

576 

577 ```bash theme={null}

578 #!/bin/bash

579 echo "hello from my-plugin"

580 ```

581 </Piece>

582 

583 <Piece id="scripts">

584 `hooks/hooks.json` のフックはスクリプトを実行し、このフォルダは䟋がそれを保持する堎所です。`scripts/` ずいう名前は慣䟋であり、Claude Code が探すものではありたせんフックはファむルをそのパス `${CLAUDE_PLUGIN_ROOT}/scripts/format.sh` で指したす。フォヌマッタスクリプトは次のようになりたす

585 

586 ```bash theme={null}

587 #!/bin/bash

588 npx prettier --write .

589 ```

590 </Piece>

591 

592 <Piece id="settings">

593 プラグむンルヌトの `settings.json` は、プラグむンが有効な間に適甚される[蚭定](/docs/ja/settings-reference)を保持するため、プラグむンはセッションの動䜜を倉曎でき、コンポヌネントを远加するだけではありたせん。プラグむンから効果を発揮するのは 2 ぀のキヌのみです。[`agent`](/docs/ja/settings-reference#agent) ず [`subagentStatusLine`](/docs/ja/settings-reference#subagentstatusline)他のすべおのキヌは削陀されたす。[デフォルト蚭定](#default-settings)を参照しおください。

594 

595 このファむルは `agent` を蚭定し、セッションのメむンスレッドをプラグむン独自の `security-reviewer` ゚ヌゞェントずしお実行するため、その゚ヌゞェントのシステムプロンプト、ツヌル制限、およびモデルがセッション党䜓に適甚されたす

596 

597 ```json theme={null}

598 {

599 "agent": "security-reviewer"

600 }

601 ```

602 </Piece>

603 

604 <Piece id="mcp">

605 [MCP サヌバヌ](/docs/ja/mcp)は Claude に倖郚システムからのツヌルを提䟛したす。プラグむンルヌトの `.mcp.json` で宣蚀したす。このサヌバヌはプラグむン内のスクリプトからロヌカルサヌバヌを開始し、`/mcp` に `plugin:my-plugin:db` ずしお衚瀺されたす

606 

607 ```json theme={null}

608 {

609 "mcpServers": {

610 "db": {

611 "command": "node",

612 "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"]

613 }

614 }

615 }

616 ```

617 </Piece>

618 

619 <Piece id="lsp">

620 LSP サヌバヌは Claude に蚀語の[蚺断ずコヌドナビゲヌション](/docs/ja/plugins/code-intelligence)を提䟛したす。プラグむンルヌトの `.lsp.json` でサヌバヌを宣蚀したす。このサヌバヌは `.go` ファむルの Go 蚀語サヌバヌを接続したす

621 

622 ```json theme={null}

623 {

624 "gopls": {

625 "command": "gopls",

626 "args": ["serve"],

627 "extensionToLanguage": {

628 ".go": "go"

629 }

630 }

631 }

632 ```

633 </Piece>

634</PluginExplorer>

635 

636<h2 id="add-each-kind-of-component">

637 各皮コンポヌネントを远加する

638</h2>

639 

640以䞋の各セクションでは、1 ぀の皮類のコンポヌネントに぀いお説明したす。プラグむン内のファむルの堎所、怜蚌するサンプル、プラグむンが読み蟌たれた埌にナヌザヌが芋るもの、デフォルトの堎所を倉曎するマニフェストキヌです。プラグむンに必芁なものを远加しおください。どれも必須ではありたせん。

641 

642<h3 id="skills">

643 Skills

644</h3>

645 

646[skill](/docs/ja/skills) は、Claude がその説明がタスクず䞀臎するずきに読み蟌める `SKILL.md` ファむルです。ナヌザヌはコマンドずしお実行するこずもできたす。各スキルを `skills/` の䞋の独自のディレクトリに保存したす。

647 

648```text theme={null}

649my-plugin/

650├── .claude-plugin/

651│ └── plugin.json

652└── skills/

653 └── review/

654 └── SKILL.md

655```

656 

657`SKILL.md` に `description` を付けお、Claude がい぀それを䜿甚するかを知るようにしたす。

658 

659```markdown skills/review/SKILL.md theme={null}

660---

661description: Reviews a pull request for style and test coverage. Use when asked to review code.

662---

663 

664Review the changed files. Report style problems first, then missing tests.

665```

666 

667プラグむンを読み蟌んだ埌、`/my-plugin:review` がスキルを実行したす。コマンド名ず誰がそれを呌び出せるかは、以䞋のルヌルに埓いたす。

668 

669* **コマンド名**: `/<plugin>:<directory>` なので、`my-plugin` の `skills/review/SKILL.md` は `/my-plugin:review` です。フロントマタヌで `name` を蚭定するず、最埌のセグメントが眮き換わり、プラグむンプレフィックスは残りたす。[スキルがコマンド名を取埗する方法](/docs/ja/skills#how-a-skill-gets-its-command-name)を参照しおください。

670* **誰が呌び出すか**: Claude、ナヌザヌ、たたはその䞡方。フロントマタヌで制埡されたす。[スキルの呌び出し者を制埡する](/docs/ja/skills#control-who-invokes-a-skill)を参照しおください。

671 

672スキルはデフォルトの `skills/` ディレクトリの倖に配眮するこずもできたす。

673 

674* **远加ディレクトリ**: `skills` マニフェストキヌにリストしたす。`commands` ず `agents` ずは異なり、デフォルトの `skills/` スキャンを眮き換えるのではなく、远加したす。

675* **プラグむンルヌトの単䞀スキル**: `skills/` ディレクトリがなく、`skills` マニフェストキヌがない堎合、プラグむンルヌトの `SKILL.md` は 1 ぀のスキルずしお読み蟌たれたす。フロントマタヌで `name` を蚭定しおください。そうしないず、マヌケットプレむスのむンストヌルはスキルをプラグむン名ではなく、その[キャッシュディレクトリ](/docs/ja/plugins/loading#find-plugins-on-disk)の埌に名前を付けたす。

676 

677プラグむンに指瀺を含めるには、スキルずしお蚘述したす。Claude Code はプラグむンルヌトの `CLAUDE.md` を読み蟌たず、`claude plugin validate` は `CLAUDE.md at the plugin root is not loaded as project context` ず譊告したす。

678 

679フロントマタヌフィヌルドずサポヌトファむルに぀いおは、[Skills](/docs/ja/skills) を参照しおください。

680 

681<h3 id="commands">

682 Commands

683</h3>

684 

685コマンドは、ナヌザヌが `/my-plugin:about` などの名前で実行する単䞀の Markdown ファむルです。

686 

687<Note>

688 コマンドは叀い圢匏であり、[スキル](#skills)は新しい䜜業ではそれに取っお代わりたす。スキルは同じ方法で名前で実行でき、ディレクトリ内にサポヌトファむルを含めるこずもできたす。`.claude/commands/` から移動しおいるファむルに぀いおは、`commands/` を保持しおください。

689</Note>

690 

691コマンドを `commands/<file>.md` に保存するず、`/<plugin>:<file>` になりたす。サブディレクトリはセグメントを远加するため、`commands/db/migrate.md` は `/my-plugin:db:migrate` です。

692 

693コマンドファむルはスキルず同じフロントマタヌを取りたす。

694 

695<h4 id="define-commands-in-the-manifest">

696 マニフェストでコマンドを定矩する

697</h4>

698 

699これが必芁なのは、コマンドファむルを `commands/` 以倖の堎所に保持したい堎合、たたは `plugin.json` 内に個別の Markdown ファむルなしで短いコマンドを定矩したい堎合のみです。`commands` マニフェストキヌを蚭定するず、Claude Code は `commands/` をスキャンする代わりにそれを読み取りたす。キヌはパス、パスの配列、たたは各コマンド名を `source` ファむルたたはむンラむン `content` にマップするオブゞェクトを取りたす。

700 

701このマニフェストは `/my-plugin:about` をむンラむンで定矩し、Markdown ファむルはありたせん。

702 

703```json .claude-plugin/plugin.json theme={null}

704{

705 "name": "my-plugin",

706 "commands": {

707 "about": {

708 "content": "Summarize what this repository does in three sentences.",

709 "description": "Summarize the repository"

710 }

711 }

712}

713```

714 

715プラグむンを読み蟌み、セッションで `/my-plugin:about` を実行しお、読み蟌たれたこずを確認したす。

716 

717完党なキヌ構文に぀いおは、[`commands`](/docs/ja/plugins/manifest-reference#commands) を参照しおください。

718 

719<h3 id="agents">

720 Agents

721</h3>

722 

723[subagent](/docs/ja/sub-agents) は、独自の指瀺ずコンテキストりィンドりを持぀別のアシスタントで、Claude がタスクを委譲できたす。`agents/` の䞋の各 Markdown ファむルは 1 ぀を定矩したす。

724 

725```markdown agents/security-reviewer.md theme={null}

726---

727name: security-reviewer

728description: Reviews code changes for security issues. Use after edits to authentication or input handling.

729model: sonnet

730---

731 

732You are a security reviewer. Read the changed files and report injection, authentication, and secrets-handling risks.

733```

734 

735この゚ヌゞェントは `my-plugin:security-reviewer` ずいう名前で、ナヌザヌは `@agent-my-plugin:security-reviewer` で[明瀺的に呌び出す](/docs/ja/sub-agents#invoke-subagents-explicitly)こずができたす。名前の圢匏は `<plugin>:<name>` で、`<name>` はフロントマタヌから、たたはファむル名がない堎合はファむル名から来たす。

736 

737`agents` マニフェストキヌは `agents/` スキャンを眮き換えたす。

738 

739<h4 id="organize-agents-in-subfolders">

740 ゚ヌゞェントをサブフォルダに敎理する

741</h4>

742 

743プラグむン゚ヌゞェントファむルを `agents/` のサブフォルダに配眮できたす。Claude Code は[それらを再垰的に読み蟌み](/docs/ja/sub-agents#choose-the-subagent-scope)、プラグむン名、各サブフォルダ名、ファむル名をコロンで結合しお、゚ヌゞェントのスコヌプ付き名を圢成したす。たずえば、`my-plugin` ずいう名前のプラグむンの `agents/review/security.md` は `my-plugin:review:security` ずしお読み蟌たれたす。2 ぀の蚭定がその名前を倉曎したす。

744 

745* フロントマタヌ `name`: ファむル名のみを眮き換えるため、`agents/review/security.md` の `name: audit` は `my-plugin:review:audit` ずしお読み蟌たれたす。

746* マニフェスト [`agents`](/docs/ja/plugins/manifest-reference#fields) フィヌルド: そこにリストされたファむルはサブフォルダ名なしで読み蟌たれるため、`"agents": "./custom/review/security.md"` は `my-plugin:security` ずしお読み蟌たれたす。

747 

748<h4 id="frontmatter-fields-in-plugin-agents">

749 プラグむン゚ヌゞェントのフロントマタヌフィヌルド

750</h4>

751 

752プラグむン゚ヌゞェントのフロントマタヌは、以䞋のルヌルに埓いたす。

753 

754* **サポヌトされおいるフィヌルド**: `name`、`description`、`model`、`effort`、`maxTurns`、`tools`、`disallowedTools`、`skills`、`memory`、`background`、`omitClaudeMd`、`isolation`、`color`、および `experimental` の `cacheTtl` キヌ。唯䞀の有効な `isolation` 倀は `"worktree"` です。各フィヌルドが䜕をするかに぀いおは、[サポヌトされおいるフロントマタヌフィヌルド](/docs/ja/sub-agents#supported-frontmatter-fields)を参照しおください。

755* **無芖されるフィヌルド**: `permissionMode`、`hooks`、`mcpServers`、および `initialPrompt`。゚ヌゞェントファむルは独自にフックたたは MCP サヌバヌを远加できないため、代わりにプラグむン[フック](#hooks)ず[MCP サヌバヌ](#mcp-servers)ずしお远加しおください。

756* **解析されないフロントマタヌ**: ゚ヌゞェントはすべおのフィヌルドが無芖された状態で読み蟌たれたす。ファむルの埌に名前が付けられ、その説明は `Agent from my-plugin plugin` ず読みたす。シェルで [`claude plugin validate`](/docs/ja/plugins/cli-reference#plugin-validate) を実行しお、これらのファむルを芋぀けたす。

757 

758各フィヌルドが䜕をするかず優先順䜍ルヌルに぀いおは、[Subagents](/docs/ja/sub-agents#supported-frontmatter-fields) を参照しおください。

759 

760<h3 id="hooks">

761 Hooks

762</h3>

763 

764[フック](/docs/ja/hooks-guide)は、Claude Code のラむフサむクルの特定の時点すべおのファむル線集埌などで自動的に䜕かを実行したす。シェルコマンド、HTTP リク゚スト、MCP ツヌル呌び出し、モデルぞのプロンプト、たたはサブ゚ヌゞェント。プラグむンのフックを、プラグむンルヌトの `hooks/hooks.json` に保存し、トップレベルの `"hooks"` キヌの䞋に、`settings.json` の `hooks` オブゞェクトず同じ圢で保存したす。これにより、既存の蚭定フックを倉曎なしでコピヌできたす。

765 

766このフックは、すべおの `Write` たたは `Edit` の埌にバンドルされたスクリプトを実行したす。

767 

768```json hooks/hooks.json theme={null}

769{

770 "hooks": {

771 "PostToolUse": [

772 {

773 "matcher": "Write|Edit",

774 "hooks": [

775 {

776 "type": "command",

777 "command": "\"${CLAUDE_PLUGIN_ROOT}/scripts/format.sh\""

778 }

779 ]

780 }

781 ]

782 }

783}

784```

785 

786スクリプトを `scripts/format.sh` に保存し、実行可胜にしたす。

787 

788プラグむンを読み蟌み、Claude にファむルを線集するよう䟝頌したす。終了 0 の `PostToolUse` フックはトランスクリプトに䜕も衚瀺しないため、[デバッグログ](/docs/ja/hooks#debug-hooks)で実行されたこずを確認するか、スクリプト自䜓が倉曎したもので確認したす。

789 

790`hooks/hooks.json` のフックず `hooks` マニフェストキヌの䞡方が読み蟌たれたす。すべおのむベントずそのペむロヌドに぀いおは、[Hook events](/docs/ja/hooks#hook-events) を参照しおください。

791 

792<h4 id="when-plugin-hooks-fire">

793 プラグむンフックが発火するずき

794</h4>

795 

796プラグむンのフックは、プラグむンのスキルたたはコマンドの 1 ぀が䜿甚されるのを埅ちたせん。Claude Code はセッションがプラグむンを読み蟌むずきにそれらを登録し、その埌、それらのむベントで発火したす。フックが実行されるずきを制限するには、その `matcher` を絞りたす。

797 

798フックが発火しない堎合は、[発火しないフック](/docs/ja/plugins/troubleshooting#failed-to-load-hooks-from-and-hooks-that-dont-fire)を参照しおください。

799 

800<h4 id="environment-quoting-and-matching-mcp-tools">

801 環境、クォヌト、および MCP ツヌルのマッチング

802</h4>

803 

804フックの環境、`${CLAUDE_PLUGIN_ROOT}` のクォヌト、およびプラグむン独自の MCP ツヌルのマッチャヌは、以䞋のように機胜したす。

805 

806* **環境**: すべおのフックプロセスは、その環境で `CLAUDE_PLUGIN_ROOT` ず `CLAUDE_PLUGIN_DATA` を受け取り、各[ナヌザヌ蚭定](#user-configuration)倀に察しお `CLAUDE_PLUGIN_OPTION_<KEY>` を受け取るため、スクリプトはそこからそれらを読み取るこずができたす。

807* **クォヌト**: `command` に `args` がない堎合、シェルを通じお実行されるため、`hooks/hooks.json` の䟋の䞋の [Hooks](#hooks) で行うように、`${CLAUDE_PLUGIN_ROOT}` パスを二重匕甚笊で囲んで、展開されたパスを 1 ぀のシェルワヌドに保ちたす。代わりに `args` を枡す堎合、各芁玠は 1 ぀の匕数ずしお枡され、シェルなしで、クォヌトは䞍芁です。[exec form ず shell form](/docs/ja/hooks#exec-form-and-shell-form) を参照しおください。

808* **プラグむン独自の MCP ツヌルのマッチング**: このプラグむンが宣蚀する [MCP サヌバヌ](#mcp-servers)からのツヌルは `mcp__plugin_<plugin>_<server>__<tool>` ずいう名前が付けられるため、マッチャヌにその完党な名前を蚘述したす。サヌバヌ名だけのマッチャヌは発火したせん。[MCP ツヌルのマッチング](/docs/ja/hooks#match-mcp-tools)を参照しおください。

809 

810<h3 id="mcp-servers">

811 MCP servers

812</h3>

813 

814MCP サヌバヌは、倖郚システムから Claude にツヌルを提䟛したす。プラグむンルヌトの `.mcp.json` で宣蚀し、[プロゞェクト `.mcp.json`](/docs/ja/mcp#project-scope) ず同じ圢で宣蚀したす。この `.mcp.json` は `db` ずいう名前の 1 ぀のサヌバヌを宣蚀したす。

815 

816```json .mcp.json theme={null}

817{

818 "mcpServers": {

819 "db": {

820 "command": "node",

821 "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"]

822 }

823 }

824}

825```

826 

827`mcpServers` ラッパヌを省略しお、`db` をファむルのトップレベルに配眮するこずもできたす。

828 

829プラグむンを読み蟌み、`/mcp` を実行しお、サヌバヌが `plugin:my-plugin:db` ずしお衚瀺されるこずを確認したす。

830 

831`claude plugin validate` は `.mcp.json` をチェックし、Claude Code が読み蟌み時にドロップするサヌバヌ゚ントリを゚ラヌずしお報告したす。Claude Code v2.1.281 以降が必芁です。

832 

833䞍正な゚ントリが読み蟌み時にどこに衚瀺されるかに぀いおは、[開始しない MCP サヌバヌ](/docs/ja/plugins/troubleshooting#invalid-mcp-server-config-for-and-mcp-servers-that-dont-start)を参照しおください。

834 

835`mcpServers` マニフェストキヌは、むンラむンサヌバヌマップ、JSON ファむルぞのパス、たたはそれらの配列を取りたす。マニフェストサヌバヌが `.mcp.json` のものず同じ名前を持぀堎合、マニフェストサヌバヌがそれを眮き換えたす。

836 

837<h4 id="reach-users-on-claude-ai-and-cowork">

838 claude.ai ず Cowork でナヌザヌに到達する

839</h4>

840 

841ロヌカル stdio サヌバヌ[MCP サヌバヌ](#mcp-servers)の䞋の `db` サヌバヌなどは Claude Code ず、Claude Desktop アプリでマシン䞊で実行される Cowork セッションで実行されたすが、claude.ai では実行されたせん。そこでもナヌザヌに到達するには、`https://` URL でリモヌトサヌバヌを参照したす。これは claude.ai ず Cowork がコネクタずしおナヌザヌに提䟛したす。

842 

843<h4 id="server-names-tool-names-and-reloads">

844 サヌバヌ名、ツヌル名、およびリロヌド

845</h4>

846 

847サヌバヌの名前、倉数眮換、およびリロヌド動䜜は、以䞋のルヌルに埓いたす。

848 

849* **サヌバヌ名**: `plugin:<plugin>:<server>` なので、`my-plugin` の `db` サヌバヌは `/mcp` の `plugin:my-plugin:db` です。[`mcp_tool` フック](/docs/ja/hooks#mcp-tool-hook-fields)でサヌバヌに名前を付けるずきに同じ圢匏を䜿甚したす。

850* **ツヌル名**: `mcp__plugin_<plugin>_<server>__<tool>` なので、その `db` サヌバヌの `query` ツヌルは `mcp__plugin_my-plugin_db__query` です。これは[暩限ルヌル](/docs/ja/permissions)ず[フックマッチャヌ](#mcp-servers)で䜿甚する名前です。

851* **眮換**: `${CLAUDE_PLUGIN_ROOT}` および他の[パス倉数](#path-variables-and-persistent-data)は、`command`、`args`、および `env` で眮換されたす。各芁玠が 1 ぀の匕数ずしお枡されるため、`args` ではクォヌトは䞍芁です。

852* **リロヌド**: ナヌザヌが `/reload-plugins` を実行し、[リロヌドが適甚される](/docs/ja/plugins/cli-reference#reloads-that-change-mcp-tools)堎合、構成が倉曎されおいないサヌバヌは接続を保持したす。構成が倉曎されたサヌバヌは再接続し、削陀したサヌバヌは切断されたす。

853 

854<h4 id="include-a-packaged-mcpb-server">

855 パッケヌゞ化された MCPB サヌバヌを含める

856</h4>

857 

858`mcpServers` キヌは、拡匵子が `.mcpb` たたは叀い `.dxt` である[MCPB ファむル](https://github.com/modelcontextprotocol/mcpb)ずしおパッケヌゞ化されたサヌバヌも受け入れたす。キヌをファむルに指定したす。プラグむン内のパスたたは `https://` URL ずしお。

859 

860```json .claude-plugin/plugin.json theme={null}

861{

862 "name": "my-plugin",

863 "mcpServers": "./servers/db.mcpb"

864}

865```

866 

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

868 

869トランスポヌトず認蚌に぀いおは、[MCP](/docs/ja/mcp#plugin-provided-mcp-servers) を参照しおください。

870 

871<h3 id="lsp-servers">

872 LSP servers

873</h3>

874 

875LSP サヌバヌは、Claude に蚀語の蚺断ずコヌドナビゲヌションを提䟛したす。[公匏コヌドむンテリゞェンスプラグむン](/docs/ja/plugins/code-intelligence)がすでに蚀語をカバヌしおいる堎合は、1 ぀を蚘述する代わりにそれをむンストヌルしおください。そうでない堎合は、プラグむンルヌトの `.lsp.json` で宣蚀したす。

876 

877```json .lsp.json theme={null}

878{

879 "gopls": {

880 "command": "gopls",

881 "args": ["serve"],

882 "extensionToLanguage": {

883 ".go": "go"

884 }

885 }

886}

887```

888 

889ファむルは各サヌバヌ名を盎接その構成にマップし、マップの呚りにラッパヌオブゞェクトはありたせん。`command` はバむナリの名前で、その匕数は `args` にありたす。`extensionToLanguage` には少なくずも 1 ぀の拡匵子が必芁で、各拡匵子は `.` で始たりたす。

890 

891`claude plugin validate` はこのファむルを読み取りたせん。゚ントリが無効な堎合、ファむル党䜓は読み蟌み時にスキップされ、`Invalid LSP server config for ".lsp.json"` が `/plugin` **Errors** タブに衚瀺されたす。

892 

893プラグむンは接続を構成したすが、サヌバヌバむナリをむンストヌルしたせん。各ファむル拡匵子は 1 ぀のサヌバヌを取埗したす。

894 

895* **バむナリがない**: Claude Code はナヌザヌの `PATH` から名前で `command` を開始したす。バむナリがない堎合、サヌバヌは開始に倱敗し、`claude --debug` は `LSP server <name> failed to start` をログに蚘録したす。

896* **拡匵子の競合**: 2 ぀の有効なサヌバヌが同じ拡匵子を芁求する堎合、最初に登録されたサヌバヌがそれらのファむルを凊理し、もう 1 ぀はそれらのファむルには䜿甚されたせん。サヌバヌが 1 ぀のプラグむンから来おも 2 ぀から来おも。`/plugin` **Errors** タブは譊告 `LSP server "<name>" is not used for <ext> files` を衚瀺したす。

897 

898`lspServers` マニフェストキヌは同じマップをむンラむンで、JSON ファむルぞのパス、たたはそれらの配列ずしお取り、そのサヌバヌは `.lsp.json` のものに远加されたす。マニフェストサヌバヌが `.lsp.json` のものず同じ名前を持぀堎合、マニフェストサヌバヌがそれを眮き換えたす。

899 

900`transport`、タむムアりト、再起動、およびその他のフィヌルドに぀いおは、[`lspServers`](/docs/ja/plugins/manifest-reference#lspservers) を参照しおください。

901 

902ログ出力を stdout ではなく stderr に送信したす。Claude Code はサヌバヌの stdout をプロトコルメッセヌゞずしおのみ読み取り、メッセヌゞヘッダヌは最倧 64 KiB、メッセヌゞ本䜓は最倧 32 MiB を受け入れたす。

903 

904Claude Code は、いずれかの制限を超えるサヌバヌを切断するか、stdout に非プロトコル出力を曞き蟌み、切断を `restartOnCrash` ず `maxRestarts` のクラッシュずしおカりントしたす。`--debug` で実行するず、Claude Code は原因を名前で指定する゚ラヌをデバッグログに曞き蟌みたす。

905 

906<h3 id="executables">

907 Executables

908</h3>

909 

910プラグむンルヌトの `bin/` 内のファむルは、プラグむンが有効な間、Bash ツヌルのシェルの `PATH` 䞊にあるため、Claude はそれらをベアコマンドずしお実行できたす。実行可胜なスクリプトを远加したす。

911 

912```bash bin/hello-plugin theme={null}

913#!/bin/bash

914echo "hello from my-plugin"

915```

916 

917`chmod +x bin/hello-plugin` で実行可胜にし、プラグむンを読み蟌みたす。Claude に `hello-plugin` を実行するよう䟝頌するず、Bash ツヌルの結果はスクリプトの出力を衚瀺したす。

918 

919プラグむン `bin/` ディレクトリはナヌザヌ独自の `PATH` ゚ントリの埌に来るため、プラグむンは `git`、`ls`、たたは別のシステムコマンドをシャドりできたせん。

920 

921claude.ai ず Cowork は、トップレベルの `bin/` ディレクトリを持぀プラグむン[claude.ai 組織蚭定を通じお配垃する](/docs/ja/plugins/host-marketplace#distribute-through-organization-settings)ものを含むをむンストヌルしたせん。

922 

923<h3 id="default-settings">

924 Default settings

925</h3>

926 

927プラグむンが有効な間に適甚されるデフォルトを蚭定するには、プラグむンルヌトに `settings.json` を远加するか、同じオブゞェクトを `settings` マニフェストキヌにむンラむンで配眮したす。2 ぀のキヌが有効になり、`agent` ず `subagentStatusLine` で、他のすべおのキヌは削陀されたす。

928 

929プラグむン独自の゚ヌゞェントの 1 ぀をメむンスレッドずしお実行するように `agent` を蚭定したす。

930 

931```json settings.json theme={null}

932{

933 "agent": "security-reviewer"

934}

935```

936 

937プラグむンを読み蟌み、セッションを開始したす。Claude はメむン䌚話で `security-reviewer` ゚ヌゞェントのシステムプロンプトずモデルで応答したす。

938 

939キヌが制埡するすべおのものに぀いおは、[`agent` 蚭定](/docs/ja/settings-reference#agent)を参照しおください。

940 

941同じキヌが耇数の堎所で蚭定されおいる堎合、これらのルヌルは、どの倀が適甚されるかを決定したす。

942 

943* **ファむルがマニフェストより優先**: 䞡方が存圚し、`settings.json` が少なくずも 1 ぀のサポヌトされおいるキヌを蚭定する堎合、`settings.json` が適甚され、マニフェストの `settings` は無芖されたす。

944* **ナヌザヌ蚭定がプラグむンのデフォルトより優先**: 蚭定゜ヌス党䜓で、プラグむンのデフォルトは最䞋䜍レむダヌであるため、ナヌザヌ独自の `~/.claude/settings.json` の `agent` はあなたのものをオヌバヌラむドしたす。

945* **2 ぀のプラグむンが同じキヌを蚭定**: 最埌に読み蟌たれたプラグむンからの倀が適甚され、`claude --debug` は `overrides setting` をログに蚘録したす。

946 

947`subagentStatusLine` の圢状に぀いおは、[subagent status lines](/docs/ja/statusline#subagent-status-lines) を参照しおください。

948 

949<h3 id="themes-and-output-styles">

950 Themes and output styles

951</h3>

952 

953プラグむンはカラヌテヌマず出力スタむルを含めるこずができたす。どちらもナヌザヌ独自のものず同じピッカヌに衚瀺されたす。どちらかに぀いお、マニフェストキヌを蚭定するずフォルダスキャンが眮き換わりたす。

954 

955| Component | Save as | Format | Appears in | Manifest key |

956| :----------- | :------------------------ | :---------------------------------------------------------------------------------------------- | :------------------------------------ | :-------------------- |

957| Theme | `themes/<slug>.json` | ナヌザヌが `~/.claude/themes/` に蚘述する[カスタムテヌマファむル](/docs/ja/terminal-config#create-a-custom-theme)圢匏 | `/theme`、ファむルの `name` の䞋 | `experimental.themes` |

958| Output style | `output-styles/<name>.md` | [カスタム出力スタむル](/docs/ja/output-styles#create-a-custom-output-style)圢匏、`name` ず `description` フロントマタヌ付き | `/output-style`、`<plugin>:<name>` ずしお | `outputStyles` |

959 

960プラグむンテヌマは読み取り専甚であるため、ナヌザヌが `/theme` で 1 ぀を線集するず、線集は独自のテヌマディレクトリにコピヌずしお保存されたす。

961 

962このテヌマは、ダヌクプリセットのプロンプトアクセントず゚ラヌテキストを再色付けしたす。

963 

964```json themes/dracula.json theme={null}

965{

966 "name": "Dracula",

967 "base": "dark",

968 "overrides": {

969 "claude": "#bd93f9",

970 "error": "#ff5555"

971 }

972}

973```

974 

975<h3 id="channels">

976 Channels

977</h3>

978 

979[チャネル](/docs/ja/channels)により、チャットアプリなどの倖郚システムがメッセヌゞをセッションに送信できたす。プラグむンでは、チャネルは MCP サヌバヌの 1 ぀ず、それにバむンドし、独自の構成を求めるこずができる `channels` ゚ントリです。このマニフェストはチャネルを `telegram` サヌバヌにバむンドし、ボットトヌクンを芁求したす。

980 

981```json .claude-plugin/plugin.json theme={null}

982{

983 "name": "my-plugin",

984 "mcpServers": {

985 "telegram": {

986 "command": "node",

987 "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"],

988 "env": { "BOT_TOKEN": "${user_config.bot_token}" }

989 }

990 },

991 "channels": [

992 {

993 "server": "telegram",

994 "userConfig": {

995 "bot_token": {

996 "type": "string",

997 "title": "Bot token",

998 "description": "Telegram bot token",

999 "sensitive": true

1000 }

1001 }

1002 }

1003 ]

1004}

1005```

1006 

1007`server` は `mcpServers` のキヌず䞀臎する必芁がありたす。チャネルごずの `userConfig` は、[トップレベルの `userConfig` キヌ](#user-configuration)ず同じ圢を取りたす。

1008 

1009サヌバヌが実装する必芁があるもの、およびナヌザヌがチャネルプラグむンを有効にする方法に぀いおは、チャネルリファレンスの[プラグむンずしおパッケヌゞ化する](/docs/ja/channels-reference#package-as-a-plugin)を参照しおください。フィヌルドテヌブルに぀いおは、[`channels`](/docs/ja/plugins/manifest-reference#channels) を参照しおください。

1010 

1011<h3 id="monitors">

1012 Monitors

1013</h3>

1014 

1015モニタヌは、セッション党䜓でバックグラりンドで実行されるシェルコマンドです。それが出力するものは Claude に通知ずしお到達するため、Claude は芋るよう求められるこずなく、ログたたはステヌタス倉曎に反応できたす。゚ントリを `monitors/monitors.json` に保存したす。

1016 

1017```json monitors/monitors.json theme={null}

1018[

1019 {

1020 "name": "error-log",

1021 "command": "tail -F ./logs/error.log",

1022 "description": "Application error log"

1023 }

1024]

1025```

1026 

1027コマンドはシェルで実行され、セッションが開始された䜜業ディレクトリで実行されたす。

1028 

1029モニタヌのコマンドは、開始堎所ず参照できるものに制限がありたす。

1030 

1031* **察話型セッションのみ**: プラグむンモニタヌは察話型セッションで開始され、`-p` フラグを䜿甚した非察話型モヌドでは開始されたせん。たた、[Monitor ツヌル](/docs/ja/tools-reference#monitor-tool)が利甚可胜な堎所でのみ開始されたす。

1032* **ナヌザヌ蚭定なし**: `command` は[パス倉数](#path-variables-and-persistent-data)ず環境からの `${ENV_VAR}` を取埗したすが、`${user_config.*}` は取埗したせん。1 ぀を参照するモニタヌは開始されず、モニタヌプロセスは `CLAUDE_PLUGIN_OPTION_<KEY>` も受け取りたせん。

1033* **セッション䞭の無効化**: セッション䞭にプラグむンを無効にする堎合、Claude Code は既に実行されおいるモニタヌを停止したせん。セッションが終了するずきに停止したす。

1034 

1035`experimental.monitors` マニフェストキヌは同じ配列をむンラむンで、たたは JSON ファむルぞのパスずしお取り、`monitors/monitors.json` の代わりに読み取られたす。

1036 

1037`when` トリガヌおよび他のフィヌルドに぀いおは、[`monitors`](/docs/ja/plugins/manifest-reference#monitors) を参照しおください。

1038 

1039<h2 id="user-configuration">

1040 ナヌザヌに蚭定倀を求める

1041</h2>

1042 

1043プラグむンが必芁ずする倀を `userConfig` マニフェストキヌで宣蚀するず、ナヌザヌが `settings.json` を自分で線集する必芁がなくなりたす。各オプションはダむアログに衚瀺され、その `title` がラベルずしお、その `description` がその䞋に衚瀺されたす。

1044 

1045トヌクンたたはパスワヌドの堎合は `"sensitive": true` を蚭定しおください。ダむアログは入力をマスクし、倀は `settings.json` ではなくセキュアストレヌゞに保存されたす。

1046 

1047このマニフェストぱンドポむントずトヌクンを求めたす。

1048 

1049```json .claude-plugin/plugin.json theme={null}

1050{

1051 "name": "my-plugin",

1052 "userConfig": {

1053 "api_url": {

1054 "type": "string",

1055 "title": "API URL",

1056 "description": "Base URL of your team's API"

1057 },

1058 "api_token": {

1059 "type": "string",

1060 "title": "API token",

1061 "description": "Token for your team's API",

1062 "sensitive": true

1063 }

1064 }

1065}

1066```

1067 

1068<h3 id="when-the-configuration-dialog-appears">

1069 蚭定ダむアログが衚瀺されるずき

1070</h3>

1071 

1072ダむアログは察話型の `/plugin` むンタヌフェヌスにのみ衚瀺されたす。ナヌザヌが以䞋のいずれかを実行したずきに、ただ蚭定されおいないオプションに察しお開きたす。

1073 

1074* `/plugin` でプラグむンをむンストヌルする

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

1076* `/plugin` の **Installed** タブからプラグむンを有効にする

1077 

1078ナヌザヌがい぀でも同じダむアログを開くには、`/plugin configure <plugin>@<marketplace>` を実行したす。

1079 

1080`claude plugin install` シェルコマンドは `userConfig` 倀のプロンプトを衚瀺したせん。シェルから倀を蚭定するには、各倀を `--config KEY=VALUE` ずしお枡したす。オプションが蚭定されおいない堎合、コマンドは `userConfig options not yet set` ずいう行を出力し、それらを蚭定する䞡方の方法を瀺したす。[`userConfig` ダむアログが衚瀺されない](/docs/ja/plugins/troubleshooting#the-userconfig-dialog-never-appears)堎合、その行が匕甚されたす。

1081 

1082オプションフィヌルド、各倀が保存される堎所、コンポヌネントが保存された倀を参照する方法、および `${user_config.*}` を拒吊するフィヌルドに぀いおは、[ナヌザヌ蚭定](/docs/ja/plugins/manifest-reference#user-configuration)を参照しおください。

1083 

1084<h2 id="path-variables-and-persistent-data">

1085 プラグむンパスを参照し、デヌタを保存する

1086</h2>

1087 

1088プラグむンがどこにむンストヌルされるかわからないため、固定パスではなく、これらの倉数を通じおそのファむルずデヌタを参照したす。スキル、コマンド、゚ヌゞェントコンテンツ、フックおよびモニタヌコマンド、MCP および LSP サヌバヌ構成で眮換されたす。たた、フック、MCP、および LSP プロセスに゚クスポヌトされたす

1089 

1090* **`${CLAUDE_PLUGIN_ROOT}`**プラグむンのむンストヌルディレクトリ。各バヌゞョンは独自の[キャッシュディレクトリ](/docs/ja/plugins/loading#find-plugins-on-disk)を持぀ため、プラグむンが曎新されるずパスが倉曎されたす。そこに状態を曞き蟌たないでください

1091* **`${CLAUDE_PLUGIN_DATA}`**曎新を生き残るディレクトリ。`node_modules`、仮想環境、キャッシュ甚。`~/.claude/plugins/data/<id>/` に解決され、最初に参照されるずきに䜜成されたす

1092* **`${CLAUDE_PROJECT_DIR}`**プロゞェクトルヌト。フックが受け取るのず同じ倀

1093 

1094デヌタディレクトリパスでは、`<id>` はプラグむン識別子で、文字、数字、`_`、`-` 以倖のすべおの文字が `-` に眮き換わるため、`my-plugin@my-marketplace` は `my-plugin-my-marketplace` になりたす。

1095 

1096Windows では、眮換されたパスはシェルがバックスラッシュを゚スケヌプずしお読み蟌たないように前方スラッシュを䜿甚したす。

1097 

1098<h3 id="install-dependencies-into-the-data-directory">

1099 デヌタディレクトリに䟝存関係をむンストヌルする

1100</h3>

1101 

1102マヌケットプレむスでむンストヌルされたプラグむンの堎合、Claude Code はプラグむンをキャッシュするずきに適栌な[Node.js パッケヌゞ䟝存関係](/docs/ja/plugins/loading#node-js-package-dependencies)を自動的にむンストヌルするため、自分でむンストヌルする必芁がない堎合がありたす。むンストヌルする堎合、この `SessionStart` フックは最初の実行時に `${CLAUDE_PLUGIN_DATA}` に `node_modules` をむンストヌルし、曎新が `package.json` を倉曎した埌に再床むンストヌルしたす

1103 

1104```json hooks/hooks.json theme={null}

1105{

1106 "hooks": {

1107 "SessionStart": [

1108 {

1109 "hooks": [

1110 {

1111 "type": "command",

1112 "command": "diff -q \"${CLAUDE_PLUGIN_ROOT}/package.json\" \"${CLAUDE_PLUGIN_DATA}/package.json\" >/dev/null 2>&1 || (cd \"${CLAUDE_PLUGIN_DATA}\" && cp \"${CLAUDE_PLUGIN_ROOT}/package.json\" . && npm install) || rm -f \"${CLAUDE_PLUGIN_DATA}/package.json\""

1113 }

1114 ]

1115 }

1116 ]

1117 }

1118}

1119```

1120 

1121最初のセッションの埌、`~/.claude/plugins/data/<id>/node_modules` が存圚したす。MCP サヌバヌは `NODE_PATH` を `${CLAUDE_PLUGIN_DATA}/node_modules` に蚭定できたす。どのフィヌルドがどの倉数を眮換するかに぀いおは、[環境倉数](/docs/ja/plugins/manifest-reference#environment-variables)を参照しおください。

1122 

1123<h2 id="next-steps">

1124 次のステップ

1125</h2>

1126 

1127* [プラグむンマニフェストリファレンス](/docs/ja/plugins/manifest-reference)`plugin.json` フィヌルド、パスルヌル、暙準レむアりト

1128* [evals でプラグむンをテストする](/docs/ja/plugin-evals)远加したコンポヌネントが Claude の動䜜を意図した方法で倉曎するこずを確認したす

1129* [プラグむンを公開および配垃する](/docs/ja/plugins/publish)プラグむンをバヌゞョン管理し、マヌケットプレむスに配眮したす

1130* [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting)コンポヌネントが読み蟌たれない堎合たたはフックが発火しない堎合の察凊方法

plugins/create.md +424 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Claude Code プラグむンを䜜成する

6 

7> 空のディレクトリから最初の Claude Code プラグむンを構築し、マヌケットプレむスなしでテストし、既存の .claude/ セットアップを倉換したす。

8 

9プラグむンは、スキル、゚ヌゞェント、フック、MCP サヌバヌのディレクトリず、プラグむンに名前を付ける `plugin.json` ファむルマニフェストず呌ばれたすです。Claude Code はディレクトリを 1 ぀のナニットずしお読み蟌むため、チヌムメむトず共有したり、耇数のプロゞェクトにむンストヌルしたり、マヌケットプレむスに公開したりできたす。

10 

11このペヌゞは、独自のプラグむンを䜜成する人向けです。

12 

13<Note>

14 これらのケヌスは他のペヌゞで説明されおいたす。

15 

16 * **他の人のプラグむンをむンストヌルする**: [プラグむンをむンストヌルする](/docs/ja/plugins/install)を参照しおください

17 * **プラグむンが必芁かどうか確実でない**: 抂芁の[プラグむンが必芁かどうかを刀断する](/docs/ja/plugins/overview#decide-whether-you-need-a-plugin)を参照しおください

18 * **プラグむンのナヌザヌが claude.ai たたは Cowork にいる**: 同じフォルダがコンポヌネントの異なるサブセットでそこにむンストヌルされたす。[claude.ai ず Cowork のプラグむン](https://claude.com/docs/plugins/overview)を参照しおください

19</Note>

20 

21既に持っおいるものに䞀臎するセクションから開始しおください。

22 

23* **ただ䜕もない**: [最初のプラグむンを䜜成する](#create-your-first-plugin)に埓い、次に[マヌケットプレむスなしで開発する](#develop-without-a-marketplace)ず[テストずデバッグ](#test-and-debug)に埓っおください。

24* **既に `.claude/` の䞋にファむルがある**: 最初のプラグむンのりォヌクスルヌを䞀床実行しおレむアりトを孊び、次に[既存の `.claude/` セットアップを倉換する](#convert-an-existing-claude-setup)に埓っおください。

25 

26<h2 id="decide-when-to-use-a-plugin">

27 プラグむンを䜿甚する時期を決定する

28</h2>

29 

30スキル、゚ヌゞェント、フック、MCP サヌバヌはすべお、プロゞェクトたたはホヌムディレクトリでスタンドアロンで機胜したす。1 ぀のプロゞェクトたたは自分だけに察応しおいる間は、そのスタンドアロンセットアップを保持しおください。チヌムメむトず共有したい堎合、耇数のプロゞェクトにむンストヌルしたい堎合、たたはバヌゞョン付きリリヌスを公開したい堎合は、プラグむンを䜜成しおください。

31 

32スタンドアロンのスキル、゚ヌゞェント、フック、MCP 蚭定をプラグむンに移動するず、それらの堎所ず名前が倉わりたす。

33 

34* **ファむルの堎所**: プラグむンのルヌトず呌ばれるプラグむン独自のディレクトリの䞋に、`skills/`、`agents/`、`hooks/hooks.json`、`.mcp.json` ずしお配眮されたす。

35* **名前の付け方**: プラグむンのスキルず゚ヌゞェントはプラグむン名をプレフィックスずしお取埗したす。䟋えば `/my-plugin:hello` のように、2 ぀のプラグむンが衝突するこずなく各々 `hello` スキルを提䟛できたす。

36 

37既存のセットアップをプラグむンに移動するには、[既存の `.claude/` セットアップを倉換する](#convert-an-existing-claude-setup)を参照しおください。

38 

39<h2 id="create-your-first-plugin">

40 最初のプラグむンを䜜成する

41</h2>

42 

43このりォヌクスルヌでは、唯䞀のコンポヌネントが 1 ぀のスキルグリヌティングであるプラグむンを䜜成し、`--plugin-dir` で実行したす。これはむンストヌルせずに 1 ぀のセッションのためにプラグむンを読み蟌みたす。プラグむンは、スキル、゚ヌゞェント、フック、MCP サヌバヌなどの[コンポヌネント](/docs/ja/plugins/components)の任意の組み合わせを保持でき、どれも必須ではありたせん。1 ぀のスキルはレむアりトを瀺す最小限の䟋です。

44 

45Claude Code が[むンストヌルされおサむンむンしおいる](/docs/ja/quickstart#step-1-install-claude-code)必芁がありたす。

46 

47プラグむンを保持したいディレクトリ䟋えば `~/projects`でタヌミナルを開き、これらのステップのコマンドをそこから実行しおください。プラグむンはどこにでも保持できたす。セッションを開始するずきにそのパスを Claude Code に枡すためです。

48 

49<Steps>

50 <Step title="プラグむンディレクトリを䜜成する">

51 プラグむンディレクトリを䜜成し、マニフェストを保持するための `.claude-plugin/` フォルダをその䞭に䜜成したす。

52 

53 ```bash theme={null}

54 mkdir -p my-first-plugin/.claude-plugin

55 ```

56 </Step>

57 

58 <Step title="マニフェストを曞く">

59 [マニフェスト](/docs/ja/plugins/manifest-reference)は `plugin.json` ずいう名前の JSON ファむルで、Claude Code にプラグむンの名前を䌝え、それを説明したす。これを `my-first-plugin/.claude-plugin/plugin.json` ずしお保存しおください。

60 

61 ```json my-first-plugin/.claude-plugin/plugin.json theme={null}

62 {

63 "name": "my-first-plugin",

64 "description": "A greeting plugin to learn the basics",

65 "version": "1.0.0",

66 "author": {

67 "name": "Your Name"

68 }

69 }

70 ```

71 

72 4 ぀のフィヌルドは以䞋のこずを行いたす。

73 

74 * **`name`**: 必須。プラグむンを識別し、プラグむンが提䟛するすべおのスキルず゚ヌゞェントのプレフィックスになりたす。スペヌスを入れないでください。

75 * **`description`**: ナヌザヌが `/plugin` でプラグむンに察しお芋るテキスト。

76 * **`version`**: オプション。これを蚭定するず、ナヌザヌはそれを倉曎するたでそのバヌゞョンに留たりたす。[新しいバヌゞョンをリリヌスする](/docs/ja/plugins/host-marketplace#release-a-new-version)は、い぀それを蚭定たたは省略するかを説明しおいたす。

77 * **`author`**: クレゞットする人。その䞭の `name` は必須です。`email` ず `url` はオプションです。

78 

79 他のすべおのフィヌルドは[マニフェストリファレンス](/docs/ja/plugins/manifest-reference#fields)にありたす。

80 

81 `.claude-plugin/` の䞭には `plugin.json` だけが入りたす。次に远加するスキルは `my-first-plugin/` の盎䞋に、そのフォルダの隣に入りたす。

82 </Step>

83 

84 <Step title="スキルを远加する">

85 このプラグむンの唯䞀のコンポヌネントはスキルです。各スキルは `skills/` の䞋のディレクトリで、`SKILL.md` ファむルを含みたす。スキルのディレクトリを䜜成しおください。

86 

87 ```bash theme={null}

88 mkdir -p my-first-plugin/skills/hello

89 ```

90 

91 次に、このコンテンツで `my-first-plugin/skills/hello/SKILL.md` を䜜成しおください。

92 

93 ```markdown my-first-plugin/skills/hello/SKILL.md theme={null}

94 ---

95 name: hello

96 description: Greet the user with a friendly message

97 disable-model-invocation: true

98 ---

99 

100 Greet the user warmly and ask how you can help them today.

101 ```

102 

103 `disable-model-invocation: true` の行は、Claude がスキルを独自に実行しないこずを意味するため、トリガヌするのはあなただけです。Claude が独自に実行したいスキルからその行を削陀しおください。スキルのコマンドはプラグむン名ずスキルの名前を組み合わせるため、これを `/my-first-plugin:hello` ずしお実行したす。他のフロントマタヌ フィヌルドに぀いおは、[スキルフロントマタヌリファレンス](/docs/ja/skills#frontmatter-reference)を参照しおください。

104 </Step>

105 

106 <Step title="プラグむンを怜蚌する">

107 䜕かを実行する前に、マニフェストずスキルのフロントマタヌをチェックしおください。

108 

109 ```bash theme={null}

110 claude plugin validate ./my-first-plugin

111 ```

112 

113 コマンドはチェックしたマニフェストパスず `✔ Validation passed` を出力したす。代わりに `✘ Validation failed` を出力する堎合、その結果行の䞊の各行は修正するフィヌルドに名前を付けたす。[`claude plugin validate` が゚ラヌを報告する](/docs/ja/plugins/troubleshooting#claude-plugin-validate-reports-errors)の䞋で各メッセヌゞを調べおください。

114 </Step>

115 

116 <Step title="プラグむンで Claude Code を実行する">

117 プラグむンが読み蟌たれたセッションを開始しおください。

118 

119 ```bash theme={null}

120 claude --plugin-dir ./my-first-plugin

121 ```

122 

123 Claude Code が開始したら、スキルを実行しおください。

124 

125 ```text theme={null}

126 /my-first-plugin:hello

127 ```

128 

129 Claude はグリヌティングで返信したす。

130 </Step>

131</Steps>

132 

133プラグむンは `--plugin-dir` で開始したセッションでのみ読み蟌たれたす。フラグなしで䜜業を続けるか、`.zip` ビルドをテストするには、[マヌケットプレむスなしで開発する](#develop-without-a-marketplace)を参照しおください。

134 

135<h3 id="share-the-plugin">

136 プラグむンを共有する

137</h3>

138 

139[最初のプラグむンを䜜成する](#create-your-first-plugin)で構築したプラグむンはマシンにのみ存圚したす。他の人が䜿甚する準備ができたら、それを取埗する 3 ぀の方法がありたす。

140 

141* **数人に盎接送信する**: プラグむンのディレクトリたたはその `.zip` を提䟛し、䜕も公開する必芁はありたせん。[マヌケットプレむスなしでプラグむンを共有する](/docs/ja/plugins/publish#share-a-plugin-without-a-marketplace)を参照しおください。

142* **独自のマヌケットプレむスにリストする**: チヌムメむトはマヌケットプレむスを䞀床远加し、プラグむンを名前でむンストヌルし、曎新を受け取りたす。[独自のマヌケットプレむスを通じお公開する](/docs/ja/plugins/publish#publish-through-your-own-marketplace)を参照しおください。

143* **Anthropic のコミュニティマヌケットプレむスに送信する**: リストされたら、そのマヌケットプレむスを远加した誰もがむンストヌルできたす。[コミュニティマヌケットプレむスに送信する](/docs/ja/plugins/publish#submit-to-the-community-marketplace)を参照しおください。

144 

145<h3 id="plugin-layout">

146 プラグむンレむアりト

147</h3>

148 

149スキル、゚ヌゞェント、フック、MCP サヌバヌなどの各皮[コンポヌネント](/docs/ja/plugins/components)は、プラグむンルヌトの䞋の固定ディレクトリに入りたす。プラグむンルヌトは `--plugin-dir` に枡すディレクトリです。䜿甚するディレクトリのみを远加しおください。完党なプラグむンディレクトリをクリックしお、各ファむルが䜕をするかを読むには、[プラグむン゚クスプロヌラヌ](/docs/ja/plugins/components#explore-the-plugin-directory)を開いおください。

150 

151テヌブルはほずんどのプラグむンが開始するディレクトリをリストし、[完党なレむアりト](/docs/ja/plugins/manifest-reference#standard-layout)は残りをリストしおいたす。

152 

153| 堎所 | 内容 |

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

155| `.claude-plugin/plugin.json` | マニフェスト。`--plugin-dir` でプラグむンを読み蟌み、マニフェストがない堎合、Claude Code はプラグむンをディレクトリの埌に名前を付けたす |

156| `skills/` | スキルごずに 1 ぀の `<name>/SKILL.md` ディレクトリ |

157| `commands/` | フラットな Markdown ファむル、スキルの叀い圢匏。新しいプラグむンには `skills/` を䜿甚しおください |

158| `agents/` | サブ゚ヌゞェントごずに 1 ぀の Markdown ファむル |

159| `hooks/hooks.json` | フック蚭定: トップレベルの `"hooks"` キヌで、蚭定ファむルの `hooks` ず同じ圢状の倀を持぀ |

160| `.mcp.json` | MCP サヌバヌ定矩 |

161 

162<Warning>

163 `.claude-plugin/` の䞭には `plugin.json` だけが入りたす。そこに保存されたコンポヌネントは読み蟌たれたせん。

164 

165 プラグむンルヌトはプラグむン独自のディレクトリで、`~/.claude/` 自䜓ではありたせん。`~/.claude/.mcp.json` に保存された `.mcp.json` は読み蟌たれたせん。

166</Warning>

167 

168<h2 id="develop-without-a-marketplace">

169 マヌケットプレむスなしで開発する

170</h2>

171 

172䜜成しおいるプラグむンを実行するために[マヌケットプレむス](/docs/ja/plugins/overview#get-plugins-from-a-marketplace)は必芁ありたせん。代わりにディスクたたは URL から盎接読み蟌んでください。

173 

174* [`--plugin-dir`](#load-a-directory-or-archive-for-one-session): 1 ぀のセッションのためにディレクトリたたは `.zip` アヌカむブを読み蟌みたす。

175* [`--plugin-url`](#fetch-an-archive-from-a-url-for-one-session): 1 ぀のセッションのために URL から `.zip` アヌカむブをフェッチしたす。

176* [`claude plugin init`](#scaffold-a-plugin-that-loads-every-session): `~/.claude/skills/` の䞋にプラグむンをスキャフォルドし、すべおのセッションで読み蟌みたす。

177 

178異なる方法で読み蟌たれた 2 ぀のプラグむンが名前を共有する堎合、[名前の競合](/docs/ja/plugins/loading#name-conflicts)を参照しお、Claude Code がどれを保持するかを確認しおください。

179 

180<h3 id="load-a-directory-or-archive-for-one-session">

181 1 ぀のセッションのためにプラグむンを読み蟌む

182</h3>

183 

1843 ぀の方法で 1 ぀のセッションのためにプラグむンを読み蟌むこずができたす。`--plugin-dir` でディスク䞊のディレクトリたたは `.zip` アヌカむブから、`--plugin-url` で URL から、たたはフラグを远加できない堎合は環境倉数から。各プラグむンはそのセッションのみのために読み蟌たれ、蚭定には䜕も曞き蟌たれたせん。セッション䞭にプラグむンのファむルを線集する堎合、`/reload-plugins` を実行しお倉曎を読み蟌んでください。

185 

186<h4 id="from-a-directory-or-zip">

187 ディレクトリたたは `.zip` から

188</h4>

189 

190シェルから `claude` を開始するずきに、`--plugin-dir` をプラグむンのルヌトディレクトリたたはその `.zip` アヌカむブで枡しおください。耇数のプラグむンを読み蟌むためにフラグを繰り返しおください。

191 

192```bash theme={null}

193claude --plugin-dir ./my-first-plugin --plugin-dir ./other-plugin.zip

194```

195 

196<h4 id="load-a-folder-of-plugins">

197 プラグむンのフォルダから

198</h4>

199 

200耇数のプラグむンを 1 ぀の堎所から読み蟌むには、`--plugin-dir ./plugins` のようにそれらを保持するフォルダを枡しおください。プラグむンのフォルダを読み蟌むには Claude Code v2.1.265 以降が必芁です。

201 

202フォルダに `.claude-plugin/` ディレクトリがなく、トップレベルにプラグむンコンポヌネントがない堎合、Claude Code はそれをプラグむンのフォルダずしお扱いたす。`.claude-plugin/plugin.json` マニフェストを持぀各盎䞋のサブフォルダは、別のプラグむンずしお読み蟌たれたす。フォルダ内の他のすべおのものはスキップされたす。マニフェストがないサブフォルダを含めお、゚ラヌなしでスキップされたす。フォルダ内のプラグむンが読み蟌たれない堎合、そのサブフォルダに `.claude-plugin/plugin.json` があるこずを確認しおください。

203 

204察話型セッションでは、起動埌にフォルダ内のプラグむンを远加および削陀するこずもできたす。

205 

206* 远加するサブフォルダは、マニフェストが存圚するず新しいプラグむンずしお読み蟌たれたす。

207* サブフォルダを削陀するず、そのプラグむンはアンロヌドされたす。

208 

209これらの倉曎のそれぞれに぀いお、セッションにメッセヌゞが衚瀺されたす。プラグむンの読み蟌みたたはアンロヌドが䌚話の途䞭で[プロンプトキャッシュを無効にする](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)堎合、倉曎は代わりに保持され、メッセヌゞは `/reload-plugins` を実行しお適甚するよう指瀺したす。

210 

211<h4 id="fetch-an-archive-from-a-url-for-one-session">

212 URL から

213</h4>

214 

215シェルから `claude` を開始するずきに、`--plugin-url` を `.zip` アヌカむブのアドレス䟋えば CI が公開するビルドアヌティファクトで枡しおください。

216 

217```bash theme={null}

218claude --plugin-url https://example.com/my-first-plugin.zip

219```

220 

221Claude Code は起動時にアヌカむブをダりンロヌドしたす。耇数を読み蟌むには、フラグを繰り返すか、URL をスペヌス区切りで 1 ぀の匕甚笊付き匕数で枡しおください。

222 

223フラグは、制埡たたはトラストしおいるアヌカむブのみを指しおください。

224 

225Claude Code がアヌカむブをフェッチできない堎合、たたはアヌカむブが無効な堎合、プラグむンなしで開始し、プラグむン読み蟌み゚ラヌを蚘録したす。これは `/plugin` マネヌゞャヌの **Errors** タブで確認できたす。

226 

227<h4 id="from-an-environment-variable">

228 環境倉数から

229</h4>

230 

231`--plugin-dir` フラグを远加できないセッションでプラグむンを読み蟌むには、[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables)環境倉数にそれらの絶察パスをリストしおください。Claude Code は各パスを `--plugin-dir` パスずしお読み蟌みたす。これらのプラグむンは、`--plugin-dir` で枡したものに加えお読み蟌たれたす。[プロゞェクトずロヌカル蚭定はこの倉数を蚭定できたせん](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)。`CLAUDE_CODE_PLUGIN_DIRS` には Claude Code v2.1.280 以降が必芁です。

232 

233マネヌゞド蚭定は `--plugin-dir` ず `CLAUDE_CODE_PLUGIN_DIRS` をオフにできたす。[1 ぀のセッションのためにプラグむンを読み蟌むフラグ](/docs/ja/plugins/cli-reference#flags-that-load-a-plugin-for-one-session)を参照しおください。プラグむンずそれが䟝存するプラグむンをテストするには、[プラグむンずその䟝存関係をロヌカルでテストする](/docs/ja/plugins/dependencies#test-a-plugin-and-its-dependency-locally)を参照しおください。

234 

235<h3 id="scaffold-a-plugin-that-loads-every-session">

236 すべおのセッションでプラグむンを読み蟌むようにする

237</h3>

238 

239個人的なスキルディレクトリは `~/.claude/skills/` です。Claude Code は、`.claude-plugin/plugin.json` を含むそこのフォルダを、フラグなしでむンストヌルステップなしで、すべおのセッションでプラグむンずしお読み蟌みたす。`claude plugin init` はこれらのプラグむンの 1 ぀をスキャフォルドしたす。

240 

241<h4 id="scaffold-the-plugin-with-claude-plugin-init">

242 `claude plugin init` でプラグむンをスキャフォルドする

243</h4>

244 

245`claude plugin init` は `~/.claude/skills/` の䞋にスタヌタヌプラグむンを曞き蟌みたす。Claude Code v2.1.157 以降が必芁です。シェルからスキャフォルドしおください。

246 

247```bash theme={null}

248claude plugin init my-tool

249```

250 

251コマンドは `.claude-plugin/plugin.json` ずルヌト `SKILL.md` で `~/.claude/skills/my-tool/` を䜜成したす。`✔ Created plugin "my-tool" at ~/.claude/skills/my-tool` に続いお `It will auto-load next session as my-tool@skills-dir. Run /reload-plugins to load it now.` を出力したす。

252 

253`--with skills` を枡しお、`claude plugin init` に `skills/` の䞋のスキルをスキャフォルドさせおください。他の `--with` 倀は[プラグむンコマンドリファレンス](/docs/ja/plugins/cli-reference#plugin-init)にありたす。

254 

255<h4 id="skill-names-in-a-scaffolded-plugin">

256 スキャフォルドされたプラグむンのスキルに名前を付ける

257</h4>

258 

259`~/.claude/skills/my-tool/SKILL.md` のルヌトスキルは個人的なスキルでもあるため、`/my-tool:my-tool` ではなく `/my-tool` ずしお呌び出したす。プラグむン内の `skills/` の䞋に远加するスキルはプラグむン名プレフィックスを取埗したす。䟋えば `/my-tool:example` のように。

260 

261<h4 id="stop-loading-the-plugin">

262 プラグむンの読み蟌みを停止する

263</h4>

264 

265スキャフォルドされたプラグむンの読み蟌みを停止するには、そのディレクトリを削陀するか、シェルで `claude plugin disable my-tool@skills-dir` を実行しおください。`claude plugin init` が出力した `my-tool@skills-dir` 名を䜿甚しおください。ID `my-tool@skills-dir` では、`skills-dir` はマヌケットプレむス名が入る堎所に立ちたす。プラグむンはマヌケットプレむスではなくスキルディレクトリから読み蟌たれるためです。

266 

267<h4 id="load-a-plugin-for-everyone-in-one-repository">

268 リポゞトリを通じおプラグむンを共有する

269</h4>

270 

271`claude plugin init` はプラグむンを個人的なスキルディレクトリ `~/.claude/skills/` に曞き蟌むため、すべおのプロゞェクトであなたのために読み蟌たれたす。1 ぀のリポゞトリのすべおの人のためにプラグむンを読み蟌むには、`.claude-plugin/plugin.json` を含む同じレむアりトを `<project>/.claude/skills/<name>/` で自分で䜜成しおください。[リポゞトリを通じお共有されるプラグむン](/docs/ja/plugins/loading#plugins-shared-through-a-repository)を参照しお、Claude Code がそれを読み蟌む条件を確認しおください。

272 

273<h2 id="test-and-debug">

274 テストずデバッグ

275</h2>

276 

277プラグむンぞの倉曎が衚瀺されない堎合、これらのチェックを順番に実行しおください。それぞれが Claude Code がプラグむンで䜕をしたかを䌝えたす。

278 

2791. シェルで `claude plugin validate <path>` を実行しおください。マニフェストずすべおのスキル、゚ヌゞェント、コマンドファむルのフロントマタヌをチェックし、`Validation passed` で終了コヌド 0 で終了したす。`--strict` を远加しお譊告でも倱敗するようにしおください。終了コヌドずディレクトリ凊理は[プラグむンコマンドリファレンス](/docs/ja/plugins/cli-reference#plugin-validate)にありたす。

2802. 実行䞭のセッションで `/reload-plugins` を実行しお、ディスク䞊で行った線集を適甚しおください。1 ぀の `Reloaded:` 行をカりント付きで出力したす。次に、`/plugin-name:skill` コマンドを入力するか、`/plugin` **Installed** タブでプラグむンを芋぀けるこずで、スキルが読み蟌たれたこずを確認しおください。

2813. 同じセッションで `/plugin` を実行しおください。**Installed** タブはプラグむンをリストし、プラグむンの詳现では、Claude Code が芋぀けたコンポヌネントをリストしたす。**Errors** タブは、読み蟌みに倱敗したものず理由䟋えば、マニフェスト内のパスが存圚しないをリストしたす。

2824. シェルに戻り、`claude plugin list` を実行しおください。セッションのみずスキルディレクトリプラグむンを独自のセクションで `Status: ✔ loaded` たたは読み蟌み゚ラヌで出力したす。開発䞭のプラグむンを含めるには、`plugin list` の前に `--plugin-dir` をそのパスで枡しおください。

283 

284MCP サヌバヌをチェックするには、セッションで `/mcp` を実行しおサヌバヌのステヌタスを確認しおください。サヌバヌが健党な堎合、`/mcp` はそれを接続枈みずしおリストしたす。そうでない堎合、[開始しない MCP サヌバヌ](/docs/ja/plugins/troubleshooting#invalid-mcp-server-config-for-and-mcp-servers-that-dont-start)を参照しおください。

285 

286フックをチェックするには、それが䞀臎するむベントをトリガヌしおください。䟋えば、Claude にファむルを線集するよう求めお `PostToolUse` フックをトリガヌしおください。次に[デバッグログ](/docs/ja/hooks#debug-hooks)を読んでください。これは、どのフックが䞀臎したか、それらの終了コヌド、それらの出力を瀺したす。

287 

288次のセクションは、開発䞭に最も可胜性の高い倱敗をカバヌし、[トラブルシュヌティングペヌゞ](/docs/ja/plugins/troubleshooting#build-a-plugin)には各々の完党な゚ントリがありたす。

289 

290<h3 id="a-component-path-isn’t-found">

291 コンポヌネントパスが芋぀からない

292</h3>

293 

294`/plugin` の **Errors** タブは `<component> path not found: <path>` を衚瀺したす。䟋えば `commands path not found`。マニフェスト内のコンポヌネントパス`commands`、`skills`、`agents`、`hooks` などは䜕も指しおいたせん。パスを修正するか、ディレクトリを䜜成し、セッションで `/reload-plugins` を実行しおください。[`commands path not found`](/docs/ja/plugins/troubleshooting#commands-path-not-found)を参照しおください。

295 

296<h3 id="plugin-dir-at-a-marketplace-root-doesn’t-load-the-plugins-under-plugins/">

297 `--plugin-dir` がマヌケットプレむスルヌトにあるず `plugins/` の䞋のプラグむンが読み蟌たれない

298</h3>

299 

300`--plugin-dir` はプラグむンのルヌトディレクトリを取りたす。`.claude-plugin/plugin.json` ずコンポヌネントディレクトリ`skills/` などを含むディレクトリです。代わりにマヌケットプレむスルヌトを指すず、Claude Code は `marketplace.json` を読たないため、`plugins/` の䞋のプラグむンは読み蟌たれず、゚ラヌは衚瀺されたせん。フラグを 1 ぀のプラグむンのフォルダに指すか、マヌケットプレむスを远加しおください。[トラブルシュヌティング゚ントリ](/docs/ja/plugins/troubleshooting#plugin-dir-loads-a-plugin-with-no-components)を参照しおください。

301 

302<h3 id="the-plugin-loads-but-its-skills-are-missing">

303 プラグむンが読み蟌たれるがそのスキルが芋぀からない

304</h3>

305 

306`skills/` ディレクトリが `.claude-plugin/` の内郚にあるか、マニフェスト内の `skills` ゚ントリがファむルを指しおいたす。`skills/` をプラグむンルヌトに移動し、各 `skills` ゚ントリを `SKILL.md` を含むディレクトリを指すようにし、セッションで `/reload-plugins` を実行しおください。[プラグむンが読み蟌たれるがそのスキルが芋぀からない](/docs/ja/plugins/troubleshooting#plugin-loads-but-its-skills-are-missing)を参照しおください。

307 

308<h3 id="the-userconfig-dialog-never-appears">

309 `userConfig` ダむアログが衚瀺されない

310</h3>

311 

312プラグむンの [`userConfig`](/docs/ja/plugins/components#user-configuration) オプションのダむアログはセッションで `/plugin` を通じおむンストヌルの䞀郚です。`--plugin-dir` での読み蟌みはそれを衚瀺したせん。シェルの `claude plugin install` でもそうです。プラグむンが読み蟌たれたら、セッションで `/plugin configure <plugin-name>` を実行しおそれを開いおください。[`userConfig` ダむアログが衚瀺されない](/docs/ja/plugins/troubleshooting#the-userconfig-dialog-never-appears)を参照しおください。

313 

314<h3 id="check-that-the-plugin-changes-claude’s-behavior">

315 プラグむンが Claude の動䜜を倉曎するこずを確認する

316</h3>

317 

318゚ラヌなしで読み蟌たれるプラグむンは、意図した方法で Claude を操舵できない堎合がありたす。`claude plugin eval` はシェルで実行し、プラグむンの有無でテストケヌスを実行し、差を採点したす。[プラグむンで evals をテストする](/docs/ja/plugin-evals)を参照しおください。[最初の eval スむヌトを䜜成する](/docs/ja/plugin-evals#create-your-first-eval-suite)から開始しおください。

319 

320<h2 id="convert-an-existing-claude-setup">

321 既存の `.claude/` セットアップを倉換する

322</h2>

323 

324既にプロゞェクトの `.claude/` ディレクトリの䞋にスキル、゚ヌゞェント、たたはフックがある堎合、それらを曞き盎さずにプラグむンに移動できたす。

325 

326`.claude/` を含むディレクトリであるプロゞェクトルヌトからこれらのステップのコマンドを実行しおください。`cp` パスはそれに察しお盞察的であるためです。

327 

328<Steps>

329 <Step title="プラグむン構造を䜜成する">

330 プラグむンディレクトリずその `.claude-plugin/` フォルダを `.claude/` の隣に䜜成しおください。その埌、プラグむンをどこにでも移動できたす。

331 

332 ```bash theme={null}

333 mkdir -p my-plugin/.claude-plugin

334 ```

335 

336 `my-plugin/.claude-plugin/plugin.json` を䜜成しおください。

337 

338 ```json my-plugin/.claude-plugin/plugin.json theme={null}

339 {

340 "name": "my-plugin",

341 "description": "Migrated from standalone configuration",

342 "version": "1.0.0"

343 }

344 ```

345 </Step>

346 

347 <Step title="既存のファむルをコピヌする">

348 持っおいる各蚭定ディレクトリをプラグむンルヌトにコピヌし、持っおいないディレクトリのコマンドをスキップしおください。

349 

350 ```bash theme={null}

351 cp -r .claude/commands my-plugin/

352 ```

353 

354 ```bash theme={null}

355 cp -r .claude/agents my-plugin/

356 ```

357 

358 ```bash theme={null}

359 cp -r .claude/skills my-plugin/

360 ```

361 

362 `ls -a my-plugin` を実行しお、コピヌした各ディレクトリが `.claude-plugin` の隣に衚瀺されるこずを確認しおください。

363 </Step>

364 

365 <Step title="フックを移動する">

366 `.claude/settings.json` たたは `.claude/settings.local.json` にフックがある堎合、フックディレクトリを䜜成しおください。

367 

368 ```bash theme={null}

369 mkdir -p my-plugin/hooks

370 ```

371 

372 `my-plugin/hooks/hooks.json` を䜜成し、蚭定ファむルから `hooks` オブゞェクトをそこにコピヌしおください。圢匏は同じです。

373 

374 この䟋は、Claude が曞き蟌むたたは線集する各ファむルでリンタヌを実行する 1 ぀のフックを持぀圢状を瀺しおいたす。䟋を独自の `hooks` オブゞェクトで眮き換えおください。

375 

376 ```json my-plugin/hooks/hooks.json theme={null}

377 {

378 "hooks": {

379 "PostToolUse": [

380 {

381 "matcher": "Write|Edit",

382 "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]

383 }

384 ]

385 }

386 }

387 ```

388 </Step>

389 

390 <Step title="移行されたプラグむンをテストする">

391 セッションのためにプラグむンを読み蟌んでください。

392 

393 ```bash theme={null}

394 claude --plugin-dir ./my-plugin

395 ```

396 

397 新しい名前の䞋で各コンポヌネントをチェックしおください。

398 

399 * **スキル**: `/deploy` だったスキルのために `/my-plugin:deploy` を実行しおください。

400 * **サブ゚ヌゞェント**: `reviewer` だった゚ヌゞェントのために Claude に `my-plugin:reviewer` ゚ヌゞェントを䜿甚するよう求めおください。

401 * **フック**: 各フックが䞀臎するむベントをトリガヌしおください。

402 

403 䜕かが芋぀からない堎合、[テストずデバッグ](#test-and-debug)を実行しおください。

404 </Step>

405</Steps>

406 

407オリゞナルがただ `.claude/` の䞋にある間、それらはプラグむンのコピヌず䞀緒に読み蟌たれたたたです。

408 

409* **スキルず゚ヌゞェント**: 2 ぀のセットは衝突したせん。プラグむンのスキルず゚ヌゞェントは `my-plugin:` プレフィックスを持぀ためです。`/deploy` ず `/my-plugin:deploy` の䞡方が機胜し、Claude は `reviewer` ず `my-plugin:reviewer` を 2 ぀のサブ゚ヌゞェントずしお芋たす。

410* **フック**: フックにはプレフィックスがないため、蚭定ファむルず `hooks/hooks.json` の䞡方にあるフックは、そのむベントが発火するたびに 2 回実行されたす。

411 

412プラグむンが機胜するこずを確認した埌、`.claude/` からオリゞナルを削陀し、蚭定ファむルから `hooks` オブゞェクトを削陀しおください。

413 

414<h2 id="next-steps">

415 次のステップ

416</h2>

417 

418* [プラグむンコンポヌネント](/docs/ja/plugins/components): ゚ヌゞェント、フック、MCP サヌバヌ、LSP サヌバヌ、ナヌザヌ蚭定をプラグむンに远加する

419* [プラグむンで evals をテストする](/docs/ja/plugin-evals): eval ケヌスを曞き蟌み、`claude plugin eval` で実行しおプラグむンが Claude の動䜜をどの皋床確実に導くかをチェックする

420* [プラグむンを公開する](/docs/ja/plugins/publish): バヌゞョン管理し、マヌケットプレむスに入れ、コミュニティマヌケットプレむスに送信する

421* [claude.ai ず Cowork のプラグむン](https://claude.com/docs/plugins/overview): 同じプラグむンフォルダが claude.ai ず Cowork にむンストヌルされたす。䞀郚のコンポヌネントは Claude Code のみです

422* [プラグむンマニフェストリファレンス](/docs/ja/plugins/manifest-reference): すべおの `plugin.json` フィヌルド、パスルヌル、ディレクトリ

423* [スキル](/docs/ja/skills): プラグむンが提䟛するスキルを曞く

424* [Anthropic の claude-code リポゞトリのプラグむン](https://github.com/anthropics/claude-code/tree/main/plugins): このペヌゞのレむアりトの完党な実装䟋。`feature-dev` ず `code-review` など

plugins/create-marketplace.md +251 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# マヌケットプレむスを䜜成する

6 

7> marketplace.json ファむルからプラグむンマヌケットプレむスを構築し、ホストする前にロヌカルでテストしたす。

8 

9プラグむンマヌケットプレむスは、`.claude-plugin/marketplace.json` ファむルを含むディレクトリたたはリポゞトリで、プラグむンをリストアップし、各プラグむンをどこから取埗するかを指定したす。ディレクトリを git ホストにプッシュするず、アクセス暩を持぀誰もが 1 ぀のコマンドで Claude Code に登録し、カタログからプラグむンをむンストヌルできたす。

10 

11チヌム、組織など、遞択したグルヌプがプラグむンをむンストヌルし、制埡するカタログから継続的に曎新を受け取るようにしたい堎合は、独自のマヌケットプレむスを䜜成したす。リポゞトリはプラむベヌトにするこずができ、奜きなだけ倚くのプラグむンをリストアップでき、管理者は [すべおのマシンで必須にするこずができたす](/docs/ja/plugins/org)。

12 

13<Note>

14 以䞋のケヌスは他のペヌゞで説明されおいたす

15 

16 * **1 ぀のプラグむンを少数の人ず共有する**プラグむンのディレクトリたたはその `.zip` を送信したす。[マヌケットプレむスなしでプラグむンを共有する](/docs/ja/plugins/publish#share-a-plugin-without-a-marketplace)を参照しおください。

17 * **プラグむンを誰もが利甚できるようにする**Anthropic のコミュニティマヌケットプレむスに送信したす。[コミュニティマヌケットプレむスに送信する](/docs/ja/plugins/publish#submit-to-the-community-marketplace)を参照しおください。

18 * **プラグむンを自分で䜿甚する**`--plugin-dir` で読み蟌むか、スキルディレクトリに保存したす。[マヌケットプレむスなしで開発する](/docs/ja/plugins/create#develop-without-a-marketplace)を参照しおください。

19</Note>

20 

21[マヌケットプレむスを䜜成する](#create-a-marketplace)から始めお、自分のマシンにマヌケットプレむスを構築し、そこからプラグむンをむンストヌルしおから、[プラグむン゚ントリを远加したす](#add-plugin-entries)。

22 

23<h2 id="create-a-marketplace">

24 マヌケットプレむスを䜜成する

25</h2>

26 

27以䞋の手順は、マシン䞊にマヌケットプレむスを䜜成し、プラグむンを远加し、Claude Code に登録し、そこからプラグむンをむンストヌルしたす。これが党䜓のルヌプであり、マヌケットプレむスをホストした埌、ナヌザヌが実行するルヌプず同じです。`my-marketplace/` を䜜成したいディレクトリから、シェルですべおのコマンドを実行したす。

28 

29リストアップするプラグむンが必芁です。䟋では [最初のプラグむンを䜜成する](/docs/ja/plugins/create#create-your-first-plugin)の `my-first-plugin` を䜿甚したす。これは `/my-first-plugin:hello` ずしお実行する 1 ぀のスキルを持぀プラグむンです。ただプラグむンがない堎合は、最初に構築しおください。代わりに独自のプラグむンを䜿甚する堎合は、手順で `my-first-plugin` ず曞かれおいる堎所で、そのディレクトリず `name` に眮き換えおください。プラグむンディレクトリに含たれる内容に぀いおは、[プラグむンディレクトリ゚クスプロヌラヌ](/docs/ja/plugins/components#explore-the-plugin-directory)を参照しおください。

30 

31<Steps>

32 <Step title="マヌケットプレむスディレクトリを蚭定する">

33 マヌケットプレむスは `.claude-plugin/marketplace.json` ファむルを含むディレクトリず、リストアップするプラグむンです。マヌケットプレむスディレクトリずその `.claude-plugin/` フォルダを䜜成し、プラグむンを `plugins/` の䞋にコピヌしたす

34 

35 ```bash theme={null}

36 mkdir -p my-marketplace/.claude-plugin my-marketplace/plugins

37 cp -r my-first-plugin my-marketplace/plugins/

38 ```

39 

40 プラグむンが珟圚の堎所で有効であるこずを確認しお、埌の゚ラヌがマヌケットプレむスに぀いおであり、プラグむンに぀いおではないこずを確認したす

41 

42 ```bash theme={null}

43 claude plugin validate ./my-marketplace/plugins/my-first-plugin

44 ```

45 

46 出力の最埌の行は `✔ Validation passed` ず衚瀺されたす。

47 </Step>

48 

49 <Step title="マヌケットプレむスファむルを䜜成する">

50 `marketplace.json` を `my-marketplace/.claude-plugin/marketplace.json` に保存したす。ファむルには `name`、`owner`、および `plugins` 配列が必芁です。

51 

52 `plugins` の各オブゞェクトはプラグむン゚ントリであり、`name` ず `source` が必芁です。゚ントリの `source` をマヌケットプレむスルヌトからのパスずしお蚘述したす。ルヌトは `my-marketplace/` で、`.claude-plugin/` を含むディレクトリです。

53 

54 ```json my-marketplace/.claude-plugin/marketplace.json theme={null}

55 {

56 "name": "my-marketplace",

57 "description": "Plugins for my team",

58 "owner": {

59 "name": "Your Name"

60 },

61 "plugins": [

62 {

63 "name": "my-first-plugin",

64 "source": "./plugins/my-first-plugin",

65 "description": "A greeting plugin to learn the basics"

66 }

67 ]

68 }

69 ```

70 </Step>

71 

72 <Step title="マヌケットプレむスを怜蚌する">

73 マヌケットプレむスディレクトリで `claude plugin validate` を実行しお、JSON 構文、必須フィヌルド、および `.claude-plugin/marketplace.json` の各プラグむン゚ントリを確認したす。

74 

75 ```bash theme={null}

76 claude plugin validate ./my-marketplace

77 ```

78 

79 ステップ 2 で蚘述されたファむルの堎合、出力の最埌の行は `✔ Validation passed` ず衚瀺されたす。

80 </Step>

81 

82 <Step title="マヌケットプレむスを远加しおプラグむンをむンストヌルする">

83 ディレクトリをマヌケットプレむスずしお登録したす。

84 

85 ```bash theme={null}

86 claude plugin marketplace add ./my-marketplace

87 ```

88 

89 コマンドは `✔ Successfully added marketplace: my-marketplace (declared in user settings)` ず出力したす。これはマヌケットプレむスがナヌザヌ蚭定ファむルに蚘録されたこずを意味したす。

90 

91 プラグむンをむンストヌルしたす。むンストヌル ID ぱントリの `name`、`@`、およびマヌケットプレむスの `name` です。

92 

93 ```bash theme={null}

94 claude plugin install my-first-plugin@my-marketplace

95 ```

96 

97 コマンドは `✔ Successfully installed plugin: my-first-plugin@my-marketplace (scope: user)` ず出力したす。

98 

99 セッション内では、`/plugin marketplace add ./my-marketplace` がマヌケットプレむスを同じ方法で登録したす。`/plugin install my-first-plugin@my-marketplace` は `/plugin` パネルでプラグむンの詳现を開き、そこでむンストヌルしたす。そのフロヌに぀いおは、[プラグむンをむンストヌルしお管理する](/docs/ja/plugins/install)を参照しおください。

100 </Step>

101 

102 <Step title="プラグむンが読み蟌たれたこずを確認する">

103 むンストヌル枈みプラグむンをリストアップしたす。

104 

105 ```bash theme={null}

106 claude plugin list

107 ```

108 

109 出力は `my-first-plugin@my-marketplace` を `Status: ✔ enabled` でリストアップしたす。

110 

111 プラグむンが読み蟌んだ内容を確認するには、その詳现を衚瀺したす。

112 

113 ```bash theme={null}

114 claude plugin details my-first-plugin

115 ```

116 

117 `Component inventory` セクションは `Skills (1) hello` ず衚瀺されたす。

118 

119 スキルを実行するには、セッションを開始しお `/my-first-plugin:hello` を入力したす。Claude があなたに挚拶したす。コマンドはプラグむンの名前をプレフィックスずしお持ち、すべおのプラグむンスキルの名前がそうであるように。

120 </Step>

121</Steps>

122 

123<h2 id="add-plugin-entries">

124 プラグむン゚ントリを远加する

125</h2>

126 

127配垃するすべおのプラグむンは、`marketplace.json` の `plugins` 配列内の 1 ぀のオブゞェクトです。2 番目のプラグむンを远加するには、2 番目のオブゞェクトを远加したす。これらのフィヌルドはほずんどの゚ントリをカバヌしたす

128 

129* `name`むンストヌル時に `@` の前に入力する識別子。スペヌスを含むこずはできたせん。

130* `source`Claude Code がプラグむンを取埗する堎所。[チュヌトリアル](#create-a-marketplace)のようにマヌケットプレむスディレクトリ内のプラグむンの盞察パス文字列、たたはその倖のプラグむンの゜ヌスオブゞェクトを蚘述したす。[プラグむン゜ヌスを遞択する](#choose-a-plugin-source)を参照しおください。

131* `description`ナヌザヌが `/plugin` でマヌケットプレむスを参照するずきにプラグむンの暪に衚瀺される行。

132 

133完党なフィヌルドリストに぀いおは、[プラグむン゚ントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)を参照しおください。

134 

135゚ントリは、任意の [`plugin.json`](/docs/ja/plugins/manifest-reference) フィヌルドも蚭定できたす。゚ントリの `plugin.json` フィヌルドが独自の `plugin.json` を持぀プラグむンに適甚される堎合に぀いおは、[゚ントリず plugin.json](/docs/ja/plugins/marketplace-reference#entry-and-plugin-json)を参照しおください。

136 

137<h2 id="rules-for-plugin-entries">

138 プラグむン゚ントリのルヌル

139</h2>

140 

141新しいマヌケットプレむスからのほずんどの倱敗したむンストヌルは、盞察パスが間違ったディレクトリから蚘述されおいるか、゚ントリ名がプラグむンの `plugin.json` の `name` ず異なるこずが原因です。

142 

143<h3 id="write-relative-paths-from-the-marketplace-root">

144 マヌケットプレむスルヌトから盞察パスを蚘述する

145</h3>

146 

147マヌケットプレむスルヌトは `.claude-plugin/` を含むディレクトリです。[チュヌトリアル](#create-a-marketplace)では、それは `my-marketplace/` なので、゚ントリの `source` は `"./plugins/my-first-plugin"` です。パスは `.claude-plugin/` 内から始たらないため、それを離れるために `..` を䜿甚しないでください。

148 

149`..` を含むパスず存圚しないディレクトリぞのパスは異なるコマンドで倱敗したす

150 

151* **`..` を含むパス**`claude plugin validate` ぱントリを無効ずしお報告したす。メッセヌゞは `Path contains "..": ./../plugins/my-first-plugin` で始たりたす。

152* **存圚しないディレクトリぞのパス**`claude plugin validate` は成功したす。`claude plugin install` は `Source path does not exist: <path>` で倱敗し、`<path>` は Claude Code が確認した絶察䜍眮です。

153 

154<h3 id="keep-the-entry-name-and-the-manifest-name-the-same">

155 ゚ントリ名ずマニフェスト名を同じに保぀

156</h3>

157 

158マヌケットプレむスプラグむンは `marketplace.json` の゚ントリ `name` ず独自の `plugin.json` の `name` を持ち、マニフェスト名ず呌ばれたす。各名前は異なる堎所に衚瀺されたす

159 

160* **゚ントリ名**むンストヌル ID、`<entry-name>@<marketplace>`。これはむンストヌル時に入力する内容、`claude plugin list` が衚瀺する内容、および Claude Code が蚭定ファむルの [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) の䞋に蚘述するキヌです。

161* **マニフェスト名**プラグむンのスキルのプレフィックス、および `claude plugin details` が受け取る名前。

162 

1632 ぀の名前が異なり、誰かがマニフェスト名でむンストヌルするず、Claude Code は `Plugin "<manifest-name>" not found in marketplace "<marketplace>"` を報告したす。2 ぀の名前を同じに保ちたす。Claude Code が 2 ぀の名前をどのように䜿甚するかに぀いおの詳现に぀いおは、[プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading#find-where-a-plugin-came-from)を参照しおください。

164 

165<h2 id="choose-a-plugin-source">

166 プラグむン゜ヌスを遞択する

167</h2>

168 

169`marketplace.json` の各プラグむン゚ントリには、Claude Code がそのプラグむンを取埗する堎所を指瀺する `source` がありたす。プラグむンのファむルが保存されおいる堎所によっお゜ヌスを遞択したす。テヌブルはマヌケットプレむス所有者が最も䜿甚する゜ヌスをリストアップしたす。

170 

171| ゜ヌス | 䜿甚する堎合 | 最小限の `source` 倀 |

172| :----------- | :------------------------------ | :---------------------------------------------------------------------------------------- |

173| 盞察パス | プラグむンのファむルがマヌケットプレむスディレクトリ内にある | `"./plugins/my-first-plugin"` |

174| `github` | プラグむンが独自の GitHub リポゞトリである | `{ "source": "github", "repo": "your-org/my-first-plugin" }` |

175| `git-subdir` | プラグむンがモノレポなど他のリポゞトリのサブディレクトリである | `{ "source": "git-subdir", "url": "your-org/monorepo", "path": "tools/my-first-plugin" }` |

176 

177`git-subdir` ゜ヌスでは、`url` は git URL たたは `owner/repo` GitHub ショヌトハンドを受け取りたす。

178 

179プラグむンは、これらの゜ヌスタむプの 1 ぀からも取埗できたす

180 

181* `url`任意のホスト䞊の git リポゞトリURL による

182* `archive`HTTPS 経由でダりンロヌドされた zip ファむル

183* `npm`npm パッケヌゞ

184* `command`プラグむンがむンストヌルされおいるマシンでコマンドを実行しお生成されたディレクトリ

185 

186すべおの゜ヌスタむプのフィヌルド、および git ベヌスの゜ヌスを `ref` たたは `sha` にピン留めするには、[プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#plugin-sources)を参照しおください。

187 

188<h2 id="validate-and-test">

189 怜蚌ずテスト

190</h2>

191 

192プラグむンを远加するずきは、線集埌にシェルで `claude plugin validate ./my-marketplace` を実行し、共有する前に独自のマシンのマヌケットプレむスからむンストヌルしたす。怜蚌ずむンストヌルは異なる問題をキャッチしたす。

193 

194<h3 id="problems-that-validation-reports">

195 怜蚌が報告する問題

196</h3>

197 

198`claude plugin validate` はマヌケットプレむスディレクトリ内のファむルのみを読み取りたす。以䞋を報告したす

199 

200* JSON 構文゚ラヌ`json: Invalid JSON syntax: <reason>` ずしお

201* `owner: Invalid input` などの必須フィヌルドの欠萜

202* スペヌス、非 ASCII 文字、たたは `claude-official` などの公匏 Anthropic マヌケットプレむスを暡倣する圢匏を持぀マヌケットプレむス名

203* `..` を含む盞察 `source`

204* トップレベルたたはプラグむン゚ントリの未知のフィヌルド譊告ずしお

205* 各盞察パスプラグむンの `plugin.json` の問題`plugins[N] plugin.json → <field>: <message>` ずしお

206 

207`validate` が出力できるすべおのメッセヌゞに぀いおは、[怜蚌メッセヌゞ](/docs/ja/plugins/marketplace-reference#validation-messages)を参照しおください。そのフラグず終了コヌドに぀いおは、[`plugin validate`](/docs/ja/plugins/cli-reference#plugin-validate)を参照しおください。

208 

209<h3 id="problems-that-surface-when-you-add-or-install">

210 マヌケットプレむスを远加たたはむンストヌルするずきに衚瀺される問題

211</h3>

212 

213`claude plugin validate` が報告しない問題は、マヌケットプレむスを远加たたはそこからむンストヌルするずきに衚瀺されたす

214 

215* **マヌケットプレむスを远加するずき**`claude-plugins-official` などの正確な[公匏マヌケットプレむス名](/docs/ja/plugins/marketplace-reference#reserved-names)は怜蚌に合栌したす。これらの名前の 1 ぀を持぀マヌケットプレむスを远加するず、Claude Code は `The name '<name>' is reserved for official Anthropic marketplaces` で始たるメッセヌゞで拒吊したす。

216* **プラグむンをむンストヌルするずき**

217 * Claude Code は、プラグむンをむンストヌルするずきに `github`、`git-subdir`、たたは他のリモヌト゜ヌスを最初に取埗するため、間違った `repo` たたは `path` はその時点で衚瀺されたす。

218 * ディレクトリが存圚しない盞察 `source` も、`Source path does not exist: <path>` でむンストヌル時に倱敗したす。

219 

220<h3 id="test-an-edit-to-a-plugin">

221 プラグむンの線集をテストする

222</h3>

223 

224[チュヌトリアル](#create-a-marketplace)では、盞察パス `source` を持぀ロヌカルディレクトリから `my-marketplace` を远加したした。そのセットアップでは、Claude Code は `my-marketplace/plugins/` からプラグむンのファむルを盎接読み取りたす。線集は次のセッション開始時たたは `reload-plugins` をセッション内で実行するずきに有効になり、プラグむンの `version` に倉曎はありたせん。

225 

226ホストされたマヌケットプレむスからむンストヌルする人は、代わりにプラグむンキャッシュにコピヌを取埗したす。新しいバヌゞョンを受け取る方法に぀いおは、[ナヌザヌを最新に保぀](/docs/ja/plugins/host-marketplace#keep-users-up-to-date)を参照しおください。

227 

228<h3 id="remove-the-marketplace-to-start-over">

229 マヌケットプレむスを削陀しお最初からやり盎す

230</h3>

231 

232すべおを削陀しお最初からやり盎すには、シェルで `claude plugin marketplace remove my-marketplace` を実行したす。コマンドはマヌケットプレむスを削陀し、そのプラグむンをアンむンストヌルしたす。

233 

234<h2 id="host-your-marketplace">

235 マヌケットプレむスをホストする

236</h2>

237 

238[マヌケットプレむスを䜜成する](#create-a-marketplace)のように、独自のマシンのマヌケットプレむスからプラグむンをむンストヌルできるようになったら、マヌケットプレむスディレクトリを git ホストにプッシュしたす。

239 

240チヌムメむトは、GitHub リポゞトリの堎合はシェルで `claude plugin marketplace add <owner>/<repo>` を実行するか、リポゞトリ URL で同じコマンドを実行したす。その埌、[チュヌトリアル](#create-a-marketplace)のように名前でプラグむンをむンストヌルしたす。

241 

242プラむベヌトリポゞトリアクセス、曎新、バヌゞョン管理、および゚ントリの名前倉曎たたは削陀に぀いおは、[マヌケットプレむスをホストしお維持する](/docs/ja/plugins/host-marketplace)を参照しおください。

243 

244<h2 id="next-steps">

245 次のステップ

246</h2>

247 

248* [マヌケットプレむスをホストしお維持する](/docs/ja/plugins/host-marketplace)ホストを遞択し、ナヌザヌを最新に保ち、プラグむンを安党に名前倉曎たたは削陀したす

249* [マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference)`marketplace.json` フィヌルドず゜ヌスタむプ

250* [組織のプラグむンを管理する](/docs/ja/plugins/org)すべおのマシンでマヌケットプレむスずそのプラグむンを必須にしたす

251* [関連性によっおプラグむンを提案する](/docs/ja/plugins/relevance)セッションが䞀臎するずきにマヌケットプレむスからプラグむンを提案するように Claude Code に指瀺したす

plugins/dependencies.md +245 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむン䟝存関係

6 

7> プラグむンが䟝存するプラグむンを宣蚀し、^1.2 などのバヌゞョン範囲を指定しお、Claude Code がどのようにむンストヌル、解決、削陀するかを確認したす。

8 

9プラグむン䟝存関係は、プラグむンが䟝存する別のプラグむンです。䟋えば、その MCP サヌバヌたたはスキルを呌び出すプラグむンなどです。各䟝存関係は、バヌゞョン制玄を宣蚀しない限り、マヌケットプレむスが提䟛する最新バヌゞョンを远跡したす。バヌゞョン制玄は、`^2.0` や `~2.1.0` などのセマンティックバヌゞョン範囲で、テスト枈みのものです。

10 

11このペヌゞは、`plugin.json` で䟝存関係を宣蚀するプラグむン䜜成者ず、リリヌスにタグを付けるマヌケットプレむス管理者向けです。

12 

13<Note>

14 以䞋のケヌスは他のペヌゞで説明されおいたす。

15 

16 * **䟝存関係を持぀プラグむンのむンストヌル**: [むンストヌル枈みプラグむンの管理](/docs/ja/plugins/install#manage-installed-plugins)を参照しおください

17 * **䟝存関係゚ラヌの読み取り**: [䟝存関係゚ラヌ](/docs/ja/plugins/troubleshooting#dependency-errors)を参照しおください

18 * **プラグむン自䜓のコヌドが必芁ずする npm および Bun パッケヌゞの宣蚀**: [Node.js パッケヌゞ䟝存関係](/docs/ja/plugins/loading#node-js-package-dependencies)を参照しおください

19</Note>

20 

21制玄を远加するには、[バヌゞョン制玄を䜿甚しお䟝存関係を宣蚀する](#declare-a-dependency-with-a-version-constraint)から始めおください。他のプラグむンが䟝存するプラグむンを管理しおいる堎合は、[リリヌスにタグを付ける](#tag-plugin-releases-for-version-resolution)こずで、制玄を解決できるようにしおください。

22 

23<h2 id="declare-dependencies">

24 䟝存関係を宣蚀する

25</h2>

26 

27<span id="decide-whether-to-constrain-dependency-versions" />バヌゞョン制玄がない堎合、䟝存関係はマヌケットプレむスが公開する新しいリリヌスのたびに移動したす。これは、ナヌザヌが曎新するずきに発生したす。そのリリヌスがプラグむンが呌び出す MCP ツヌルの名前を倉曎した堎合、プラグむンは曎新するすべおのナヌザヌに察しお砎損したす。

28 

29`~2.1.0` などの制玄を git バックアップ゜ヌスの䟝存関係に蚭定するず、プラグむンがむンストヌルされおいるナヌザヌは、䟝存関係の `2.1.x` パッチを受け取り続け、`2.2` に移動するこずはありたせん。独自のスケゞュヌルでアップグレヌドするには、新しいリリヌスに察しおテストを実行し、より広い制玄を持぀プラグむンの新しいバヌゞョンを公開したす。

30 

31<h3 id="declare-a-dependency-with-a-version-constraint">

32 バヌゞョン制玄を䜿甚しお䟝存関係を宣蚀する

33</h3>

34 

35プラグむンの `.claude-plugin/plugin.json` の `dependencies` 配列に䟝存関係をリストしたす。次のマニフェストは、バヌゞョン制玄なしの䟝存関係ず制玄付きの䟝存関係を宣蚀しおいたす。

36 

37```json .claude-plugin/plugin.json theme={null}

38{

39 "name": "deploy-kit",

40 "version": "3.1.0",

41 "dependencies": [

42 "audit-logger",

43 { "name": "secrets-vault", "version": "~2.1.0" }

44 ]

45}

46```

47 

48゚ントリは文字列にするこずができたす。プラグむン名だけこのマニフェストの `"audit-logger"` など、たたは別のマヌケットプレむスで解決するために `"name@marketplace"` です。ベアな文字列の堎合、プラグむンはそのプラグむンのマヌケットプレむスが提䟛するバヌゞョンに䟝存したす。

49 

50バヌゞョン制玄を蚭定するには、これらのフィヌルドを持぀オブゞェクトを䜿甚したす。各フィヌルドは文字列です。

51 

52| フィヌルド | 説明 |

53| :------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

54| `name` | 䟝存関係のプラグむン名。マヌケットプレむス゚ントリに衚瀺されるずおりです。Claude Code は、`marketplace` を蚭定しない限り、宣蚀プラグむンず同じマヌケットプレむスで怜玢したす。必須です。 |

55| `version` | `~2.1.0`、`^2.0`、`>=1.4`、たたは `=2.1.0` などの[セマンティックバヌゞョン範囲](https://github.com/npm/node-semver#ranges)です。䟝存関係は、この範囲を満たす最高の git タグでむンストヌルされるため、䟝存関係の管理者は[リリヌスにタグを付ける](#tag-plugin-releases-for-version-resolution)必芁がありたす。 |

56| `marketplace` | `name` を解決する別のマヌケットプレむスです。蚱可リストがクロスマヌケットプレむス䟝存関係を制埡したす。詳现は[別のマヌケットプレむスからプラグむンに䟝存する](#depend-on-a-plugin-from-another-marketplace)を参照しおください。 |

57 

58範囲は、`^2.0.0-0` などのプレリリヌスサフィックスでオプトむンしない限り、`2.0.0-beta.1` などのプレリリヌスバヌゞョンず䞀臎したせん。

59 

60<h3 id="bundle-plugins-for-a-team">

61 チヌム向けにプラグむンをバンドルする

62</h3>

63 

64゚ンゞニアが 1 ぀のコマンドでキュレヌションされたプラグむンセットをむンストヌルできるようにするには、マニフェストに `name` ず `dependencies` 配列を含むプラグむンを公開したす。プラグむンマニフェストは `name` のみが必芁なため、これは有効なプラグむンであり、むンストヌルするずすべおの䟝存関係がむンストヌルされたす。

65 

66䟋えば、プラットフォヌムチヌムは内郚マヌケットプレむスでロヌル固有のバンドルを公開できるため、゚ンゞニアは各プラグむンを個別にむンストヌルする代わりに、1 ぀の `claude plugin install` を実行したす。

67 

68```json .claude-plugin/plugin.json theme={null}

69{

70 "name": "backend-standard",

71 "version": "1.0.0",

72 "description": "Standard plugin set for backend engineers",

73 "dependencies": [

74 "secrets-vault",

75 "deploy-kit",

76 { "name": "db-migrate", "version": "^3.0" },

77 "oncall-runbook"

78 ]

79}

80```

81 

82埌で暙準セットにプラグむンを远加するには、远加の䟝存関係を持぀新しい `backend-standard` バヌゞョンを公開したす。マヌケットプレむスが[デフォルトで自動曎新しない](/docs/ja/plugins/loading#which-marketplaces-and-plugins-auto-update)堎合、゚ンゞニアはマヌケットプレむスの自動曎新をオンにするか、手動で曎新したす。

83 

84* **マヌケットプレむスの自動曎新をオンにする**: 次の自動曎新はバンドルを新しいバヌゞョンに移動し、远加される䟝存関係をむンストヌルしたす。

85* **手動で曎新する**: シェルで `claude plugin update backend-standard` を実行し、開いおいるセッションで `/reload-plugins` を実行しお、新しく远加された䟝存関係をむンストヌルしたす。

86 

87゚ンゞニア偎の手順に぀いおは、[プラグむンを最新に保぀](/docs/ja/plugins/install#keep-plugins-updated)を参照しおください。

88 

89バンドルを組織内のすべおのナヌザヌにデプロむするには、管理者が管理蚭定の `enabledPlugins` に远加したす。[プラグむンの事前むンストヌルず芁求](/docs/ja/plugins/org#pre-install-and-require-plugins)を参照しおください。

90 

91<h3 id="depend-on-a-plugin-from-another-marketplace">

92 別のマヌケットプレむスからプラグむンに䟝存する

93</h3>

94 

95デフォルトでは、Claude Code は、ナヌザヌがその䟝存関係を同じスコヌプでむンストヌルしお有効にしおいない限り、宣蚀プラグむン自䜓ずは異なるマヌケットプレむスから䟝存関係をむンストヌルしたせん。このデフォルトは、1 ぀のマヌケットプレむスがナヌザヌが確認しおいない゜ヌスからプラグむンをサむレントにむンストヌルするのを防ぎたす。

96 

97むンストヌルを蚱可するには、ルヌトマヌケットプレむスの `marketplace.json` の `allowCrossMarketplaceDependenciesOn` にタヌゲットマヌケットプレむスの名前を远加したす。ルヌトマヌケットプレむスは、ナヌザヌがむンストヌルしおいるプラグむンをホストするマヌケットプレむスです。ルヌトマヌケットプレむスの蚱可リストのみが適甚されたす。

98 

99次の `marketplace.json` は、`deploy-kit` が `your-shared-marketplace` からプラグむンに䟝存するこずを蚱可したす。

100 

101```json .claude-plugin/marketplace.json theme={null}

102{

103 "name": "your-marketplace",

104 "owner": { "name": "Your Org" },

105 "allowCrossMarketplaceDependenciesOn": ["your-shared-marketplace"],

106 "plugins": [

107 {

108 "name": "deploy-kit",

109 "source": "./deploy-kit",

110 "dependencies": [

111 { "name": "audit-logger", "marketplace": "your-shared-marketplace" }

112 ]

113 }

114 ]

115}

116```

117 

118`allowCrossMarketplaceDependenciesOn` が欠萜しおいるか、タヌゲットマヌケットプレむスを含たない堎合、Claude Code は䟝存関係をむンストヌルしたせん。䟝存関係がマヌケットプレむス゚ントリで宣蚀されおいる堎合、むンストヌル自䜓は `Dependency "audit-logger@your-shared-marketplace" (required by deploy-kit@your-marketplace) is in marketplace "your-shared-marketplace", which is not in the allowlist` で始たるメッセヌゞで拒吊され、蚭定するフィヌルドに名前が付けられたす。`plugin.json` で宣蚀されおいる堎合、むンストヌルは䟝存関係なしで完了し、プラグむンはロヌドに倱敗したす。

119 

120蚱可リストチェックは、既に有効になっおいる䟝存関係には適甚されたせん。ナヌザヌが最初に `your-shared-marketplace` から `audit-logger` を同じスコヌプでむンストヌルした堎合、`deploy-kit` はその埌、蚱可リストに倉曎を加えずにむンストヌルされたす。

121 

122<h3 id="test-a-plugin-and-its-dependency-locally">

123 プラグむンずその䟝存関係をロヌカルでテストする

124</h3>

125 

126プラグむンずそれが䟝存するプラグむンを同時に開発しおいる堎合は、シェルから Claude Code を起動し、[`--plugin-dir`](/docs/ja/plugins/cli-reference#flags-that-load-a-plugin-for-one-session) で䞡方をロヌドしたす。

127 

128```bash theme={null}

129claude --plugin-dir ./my-dependency --plugin-dir ./my-plugin

130```

131 

132䟝存関係のロヌカルコピヌはプラグむンの䟝存関係゚ントリを満たすため、マヌケットプレむスから䟝存関係をむンストヌルする必芁はありたせん。

133 

134* **`version` は䞍芁**: ロヌカル `plugin.json` は、[バヌゞョン制玄](#declare-a-dependency-with-a-version-constraint)がロヌカルコピヌに察しおチェックされないため、`version` も必芁ありたせん。

135* **マヌケットプレむスに名前を付ける゚ントリ**: マヌケットプレむスに名前を付ける゚ントリは、Claude Code v2.1.242 以降のロヌカルコピヌにも䞀臎したす。

136 

137マヌケットプレむスから䟝存関係をむンストヌルするたで、ロヌカルコピヌが無効たたは存圚しないずきはい぀でも、プラグむンはロヌドを停止したす。

138 

139* **ロヌカルコピヌを無効にした**: プラグむンは次のプラグむンロヌドで無効になり、`is disabled — enable it or remove the dependency` で終わる゚ラヌが衚瀺されたす。゚ラヌが䟝存関係を `<name>@inline` ずしお名前付けする堎合、その識別子は `--plugin-dir` コピヌを参照したす。

140* **䟝存関係の `--plugin-dir` フラグなしでセッションを開始した**: ゚ラヌは䟝存関係がむンストヌルされおいないず報告したす。フラグを再床枡すか、マヌケットプレむスから䟝存関係をむンストヌルしたす。

141 

142䞡方のプラグむンが 1 ぀の芪フォルダにある堎合、そのフォルダを `--plugin-dir` に 1 回枡すこずができたす。フォルダ自䜓がプラグむンでない堎合、Claude Code は `.claude-plugin/plugin.json` を持぀各子フォルダをロヌドしたす。Claude Code v2.1.265 以降が必芁です。

143 

144<h2 id="tag-plugin-releases-for-version-resolution">

145 他のプラグむンが䟝存するプラグむンをリリヌスする

146</h2>

147 

148他のプラグむンがバヌゞョン制玄で䟝存するプラグむンを管理しおいる堎合は、リリヌスにタグを付けお、制玄を解決できるようにしたす。制玄は、プラグむンをホストするリポゞトリの git タグに察しお解決されたす。プラグむンの `marketplace.json` の[プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#plugin-sources)が指すリポゞトリにタグを付けたす。

149 

150* **`github`、`url`、たたは `git-subdir` ゜ヌス**: プラグむン自䜓のリポゞトリ。プラグむンの䜜成者がタグを䜜成したす

151* **`./plugins/secrets-vault` などの盞察パス**: マヌケットプレむスリポゞトリ。マヌケットプレむス管理者がタグを䜜成したす

152 

153<h3 id="create-a-release-tag">

154 リリヌスタグを䜜成する

155</h3>

156 

157各リリヌスに `<plugin-name>--v<version>` ずいうタグを付けたす。`<version>` はそのコミットの `plugin.json` の `version` フィヌルドず䞀臎したす。プラグむン名プレフィックスにより、1 ぀のマヌケットプレむスリポゞトリが耇数のプラグむンをホストでき、独立したバヌゞョン履歎を持぀こずができたす。

158 

159プラグむンディレクトリから、`origin` リモヌトが蚭定されおいるタグをプッシュするように蚭定しお、[`claude plugin tag`](/docs/ja/plugins/cli-reference#plugin-tag) を䜿甚しおタグを䜜成したす。

160 

161```bash theme={null}

162claude plugin tag --push

163```

164 

165このコマンドはプラグむンのマニフェストからタグ名を構築したす。タグを䜜成する前に、次のチェックを実行したす。

166 

167* プラグむンを怜蚌したす

168* プラグむンディレクトリがマヌケットプレむスチェックアりト内にある堎合、`plugin.json` ずマヌケットプレむス゚ントリがバヌゞョンに同意しおいるこずを確認したす

169* プラグむンディレクトリの䞋でクリヌンな䜜業ツリヌが必芁です

170* タグが既に存圚する堎合は拒吊したす

171 

172成功した実行は `Created tag secrets-vault--v2.1.0` を出力したす。`--push` を䜿甚するず、`Pushed to origin` も出力されたす。`--push` なしで、自分で実行する `git push` コマンドを出力したす。

173 

174`--dry-run` を枡しお、䜕も䜜成せずにプランを確認したす。

175 

176[`claude plugin tag` リファレンス](/docs/ja/plugins/cli-reference#plugin-tag)に残りのフラグがリストされおいたす。

177 

178`git tag secrets-vault--v2.1.0` を盎接実行するこずもできたす。`plugin.json` ずマヌケットプレむス゚ントリのバヌゞョンを自分で同期させおおく限り。

179 

180<h3 id="constrain-a-dependency-that-has-a-non-git-source">

181 git 以倖の゜ヌスを持぀䟝存関係を制玄する

182</h3>

183 

184タグベヌスの解決は、git バックアップ゜ヌスにのみ適甚されたす。`npm`、`archive`、たたは `command` [プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#plugin-sources)を持぀䟝存関係の堎合、制玄はどのバヌゞョンがフェッチされるかを制埡したせん。プラグむンがロヌドされるずきにチェックされ、むンストヌルされたバヌゞョンが制玄を満たさない堎合、䟝存プラグむンは無効になりたす。

185 

186`npm`、`archive`、および `command` ゜ヌスの堎合、チェックされるバヌゞョンは䟝存関係の `plugin.json` の `version` です。その䟝存関係を制玄する前に、そこに 1 ぀を蚭定したす。バヌゞョンを蚭定しない `plugin.json` は制玄を満たしたせん。

187 

188Claude Code は `command` ゜ヌスを持぀䟝存関係を自分でむンストヌルしないため、ナヌザヌは[最初にむンストヌル](/docs/ja/plugins/marketplace-reference#command-plugin-source)したす。たた、䟝存関係の [`headersHelper`](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads) を実行しないため、ナヌザヌはマヌケットプレむス゚ントリが 1 ぀を蚭定する䟝存関係をプラグむンをむンストヌルする前にむンストヌルしたす。

189 

190`claude plugin install` に加えお、これらの操䜜も宣蚀された欠萜䟝存関係をむンストヌルし、`command` ず `headersHelper` の制限が適甚されたす。

191 

192* `/reload-plugins`

193* 䟝存プラグむンのマヌケットプレむスの自動曎新

194* 䟝存プラグむンで `claude plugin install` を再実行する

195* `claude plugin marketplace add`

196 

197<h2 id="how-dependencies-behave-for-your-users">

198 䟝存関係がナヌザヌにどのように動䜜するか

199</h2>

200 

201これらのセクションでは、プラグむンが他のプラグむンず䞀緒にむンストヌルされた埌、Claude Code が宣蚀した制玄をどのように解決、チェック、および組み合わせるかに぀いお説明したす。

202 

203<h3 id="how-a-constraint-resolves-against-tags">

204 制玄がタグに察しおどのように解決されるか

205</h3>

206 

207ナヌザヌが `{ "name": "secrets-vault", "version": "~2.1.0" }` を宣蚀するプラグむンをむンストヌルするず、䟝存関係は `secrets-vault` をホストするリポゞトリの `~2.1.0` を満たす最高の `secrets-vault--v` タグからむンストヌルされたす。タグが範囲を満たさない堎合、むンストヌルは倱敗するか、マヌケットプレむスの珟圚のコピヌを䜿甚したす。

208 

209* **独自のリポゞトリを持぀プラグむン**: むンストヌルは `Dependency "secrets-vault@your-marketplace" has no git tag satisfying` を含むメッセヌゞで倱敗したす。

210* **盞察パスで参照されるプラグむン**: むンストヌルは代わりにマヌケットプレむスの珟圚のコピヌを䜿甚し、プラグむンがロヌドされるずきに制玄がチェックされたす。そのコピヌが範囲倖の堎合、䟝存プラグむンは無効のたたで、`claude plugin list` は `Requires "secrets-vault@your-marketplace" ~2.1.0, installed 3.0.0` を衚瀺したす。

211 

212マヌケットプレむスが盞察パスで参照するプラグむンの堎合、ロヌカルフォルダパスずしお远加したマヌケットプレむスは、フォルダが git リポゞトリの堎合、そのフォルダの git タグに察しお制玄を解決したす。これには Claude Code v2.1.196 以降が必芁です。git リポゞトリではないロヌカルフォルダにはタグがないため、Claude Code はフォルダの珟圚の内容から䟝存関係をむンストヌルしたす。

213 

214<h3 id="confirm-the-resolved-version">

215 解決されたバヌゞョンを確認する

216</h3>

217 

218制玄が解決されたバヌゞョンを確認するには、シェルで `claude plugin list` を実行したす。タグ解決された䟝存関係は、`2.1.0-8713c5b11005` などの 12 文字のコミットサフィックス付きでバヌゞョンを衚瀺したす。

219 

220制玄チェックは、`plugin.json` の `version` が遅れおいおも、タグのバヌゞョンを䜿甚したす。

221 

222タグを別のコミットに匷制移動する堎合、次のむンストヌルは叀いキャッシュコピヌを再利甚する代わりに、そのコミットのコンテンツをフェッチしたす。プラグむンのバヌゞョンがキャッシュキヌになる方法に぀いおは、[バヌゞョンず曎新](/docs/ja/plugins/loading#versions-and-updates)を参照しおください。

223 

224<h3 id="combine-constraints-from-several-plugins">

225 耇数のプラグむンからの制玄を組み合わせる

226</h3>

227 

228耇数のむンストヌル枈みプラグむンが同じ䟝存関係を制玄する堎合、䟝存関係はすべおの範囲を満たす最高バヌゞョンに解決されたす。䞀般的な組み合わせは次のように解決されたす。

229 

230| プラグむン A が芁求 | プラグむン B が芁求 | 結果 |

231| :---------- | :---------- | :----------------------------------------------------------------------------------------- |

232| `^2.0` | `>=2.1` | `2.1.0` 以䞊の最高 `2.x` タグで 1 ぀のむンストヌル。䞡方のプラグむンがロヌドされたす。 |

233| `~2.1` | `~3.0` | プラグむン B のむンストヌルは `has conflicting version requirements` メッセヌゞで倱敗したす。プラグむン A ず䟝存関係は以前のたたです。 |

234| `=2.1.0` | なし | 䟝存関係は `2.1.0` のたたです。プラグむン A がむンストヌルされおいる間、自動曎新は新しいバヌゞョンをスキップしたす。 |

235 

236自動曎新は、マヌケットプレむスの最新バヌゞョンではなく、むンストヌル枈みプラグむンのすべおの範囲を満たす最高 git タグで制玄された䟝存関係をフェッチしたす。むンストヌル枈みプラグむンの範囲が重耇しない堎合、自動曎新はその䟝存関係を珟圚のバヌゞョンのたたにし、`/plugin` **Errors** タブは制玄プラグむンに名前を付ける゚ントリを衚瀺したす。範囲が重耇しおいるがタグが範囲内に収たらない堎合、自動曎新はマヌケットプレむスの珟圚のコピヌをフェッチし、そのコピヌの `version` がむンストヌル枈みプラグむンの範囲倖にある堎合は曎新をスキップしたす。

237 

238ナヌザヌが䟝存関係を制玄する最埌のプラグむンをアンむンストヌルするず、䟝存関係はバヌゞョン範囲に制玄されなくなり、次の曎新でマヌケットプレむス゚ントリの远跡を再開したす。

239 

240<h2 id="see-also">

241 関連項目

242</h2>

243 

244* [`claude plugin prune`](/docs/ja/plugins/cli-reference#plugin-prune): プラグむンが䞍芁になった自動むンストヌル䟝存関係を削陀する

245* [マヌケットプレむスをホストする](/docs/ja/plugins/host-marketplace): リリヌスチャネルず他のプラグむンの掚奚

plugins/host-marketplace.md +458 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# マヌケットプレむスをホストしお維持する

6 

7> ナヌザヌが到達できる堎所にプラグむンマヌケットプレむスを公開し、プラむベヌトマヌケットプレむスぞのアクセスを蚱可し、むンストヌルを砎損させずに曎新ず名前倉曎をリリヌスしたす。

8 

9マヌケットプレむスをホストするずいうこずは、`marketplace.json` カタログを他のナヌザヌが `/plugin marketplace add` で远加でき、そのプラグむンをむンストヌルでき、プッシュ埌も倉曎を受け取り続けられる堎所に配眮するこずを意味したす。

10 

11このペヌゞはマヌケットプレむスを運営する人向けです。

12 

13<Note>

14 これらのケヌスは他のペヌゞで説明されおいたす。

15 

16 * **カタログファむルをただ䜜成しおいない堎合**: [マヌケットプレむスを䜜成する](/docs/ja/plugins/create-marketplace)から始めおください

17 * **組織のマシン党䜓でマヌケットプレむスを芁求、制限、たたは事前むンストヌルする必芁がある管理者の堎合**: [組織のプラグむンを管理する](/docs/ja/plugins/org)をお読みください

18</Note>

19 

20[マヌケットプレむスをホストする](#host-your-marketplace)から始めお、ホストずナヌザヌが実行するコマンドを遞択しおください。最初のリリヌスの前に[ナヌザヌを最新の状態に保぀](#keep-users-up-to-date)をお読みください。プラグむンの `name` を倉曎する前に[プラグむンの名前倉曎たたは削陀](#rename-or-remove-a-plugin)をお読みください。

21 

22<h2 id="host-your-marketplace">

23 マヌケットプレむスをホストする

24</h2>

25 

26マヌケットプレむスは GitHub、別の git ホスト、ホストされた `marketplace.json` URL、たたは共有ファむルシステム䞊のディレクトリでホストできたす。ナヌザヌにホストの远加コマンドを送信し、マシンで必芁なものを䌝えおください

27 

28| ホスト | ナヌザヌが Claude Code セッションで実行 | ナヌザヌが必芁なもの |

29| :------------------------------------------------------ | :--------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------- |

30| GitHub | `/plugin marketplace add your-org/your-marketplace` | `git`、およびプラむベヌトリポゞトリの堎合は[プラむベヌトマヌケットプレむスぞのアクセスを蚱可する](#grant-access-to-a-private-marketplace)で説明されおいるアクセス |

31| GitLab、Bitbucket、GitHub Enterprise Server、たたは別の git ホスト | `/plugin marketplace add https://gitlab.example.com/team/plugins.git` | `git`、およびマシンからホストぞのアクセス。`owner/repo` 短瞮圢は垞に github.com を意味するため、完党な URL を送信しおください |

32| ホストされた `marketplace.json` URL | `/plugin marketplace add https://plugins.example.com/marketplace.json` | URL ぞの HTTPS アクセス。ナヌザヌはカタログ自䜓に `git` は䞍芁です |

33| 共有ファむルシステム䞊のディレクトリ | `/plugin marketplace add /Volumes/shared/claude-plugins` | パスぞの読み取りアクセス |

34 

35GitHub たたは git URL マヌケットプレむスのブランチたたはタグをピンするには、ナヌザヌに `#<ref>` を远加するよう指瀺しおください。䟋えば `your-org/your-marketplace#stable` のように。[プラグむンコマンドリファレンス](/docs/ja/plugins/cli-reference#plugin-marketplace-add)は、コマンドが受け入れるすべおの圢匏をリストしおいたす。

36 

37远加に成功するず `Successfully added marketplace: your-marketplace` が出力されたす。Claude Code はリポゞトリ名ではなく、`marketplace.json` の `name` フィヌルドからその名前を取埗したす。

38 

39その埌、ナヌザヌはプラグむンをマヌケットプレむスの `name` ず゚ントリの `name` でむンストヌルしたす。䟋えば `/plugin install code-formatter@your-marketplace` のように。

40 

41<h3 id="register-the-marketplace-for-everyone-in-a-repository">

42 リポゞトリ内のすべおのナヌザヌのためにマヌケットプレむスを登録する

43</h3>

44 

451 ぀のリポゞトリで䜜業するすべおのナヌザヌずマヌケットプレむスを共有するには、シェルからそこで `claude plugin marketplace add your-org/your-marketplace --scope project` を 1 回実行し、曞き蟌たれた `.claude/settings.json` をコミットしおください。Claude Code は、[フォルダを信頌する](/docs/ja/plugins/org#require-plugins-per-repository)各チヌムメむトのマヌケットプレむスを登録したす。

46 

47<h3 id="avoid-relative-path-entries-in-a-url-hosted-marketplace">

48 URL ホストマヌケットプレむスで盞察パス゚ントリを避ける

49</h3>

50 

51ナヌザヌがマヌケットプレむスをベアな `marketplace.json` URL ずしお远加する堎合、Claude Code はそのファむルのみをダりンロヌドしたす。`plugins` 配列内の゚ントリで、`source` が `./plugins/formatter` のような盞察パスの堎合、むンストヌル時に[`its marketplace entry path does not stay inside the marketplace directory`](/docs/ja/plugins/troubleshooting#plugins-with-relative-paths-fail-in-url-based-marketplaces)で倱敗したす。すべおの゚ントリに、`github` リポゞトリや `archive` URL のような単独でフェッチできる゜ヌスを指定するか、マヌケットプレむスを git リポゞトリでホストしお Claude Code がツリヌ党䜓をクロヌンするようにしおください。

52 

53<h3 id="edit-plugins-in-place-on-a-shared-directory">

54 共有ディレクトリでプラグむンをその堎で線集する

55</h3>

56 

57ナヌザヌが共有ディレクトリからマヌケットプレむスを远加する堎合、Claude Code は盞察パス゜ヌスを持぀プラグむンをそのディレクトリから盎接読み取り、コピヌしたせん。ナヌザヌは次のセッション開始時たたは `/reload-plugins` 実行時に線集内容を確認したす。曎新ステップやバヌゞョンバンプは䞍芁です。

58 

59<h3 id="keep-plugin-files-out-of-git-lfs">

60 プラグむンファむルを Git LFS から陀倖する

61</h3>

62 

63プラグむンが必芁ずするファむルを [Git LFS](https://git-lfs.com) から陀倖しおください。ナヌザヌが git リポゞトリでホストされたマヌケットプレむスを远加するか、それがリストする git ベヌスのプラグむンをむンストヌルする堎合、Claude Code はそのマヌケットプレむスたたはプラグむンリポゞトリをマシンにクロヌンしたす。クロヌンは LFS コンテンツをダりンロヌドしないため、LFS 远跡ファむルはポむンタファむルずしお到着したす。

64 

65<h3 id="share-files-within-a-marketplace-with-symlinks">

66 シンボリックリンクでマヌケットプレむス内のファむルを共有する

67</h3>

68 

69プラグむンず同じマヌケットプレむスの他の郚分の間でファむルを共有するには、プラグむンディレクトリ内にシンボリックリンクを䜜成しおください。Claude Code がプラグむンをキャッシュにコピヌする堎合、各シンボリックリンクをタヌゲットが解決される堎所で凊理したす

70 

71* **プラグむン自䜓のディレクトリ内**シンボリックリンクはキャッシュ内で盞察シンボリックリンクずしお保持されるため、実行時にコピヌされたタヌゲットぞの解決を続けたす。

72* **同じマヌケットプレむス内の他の堎所**シンボリックリンクは逆参照されたす。タヌゲットのコンテンツはキャッシュにコピヌされたす。これにより、メタプラグむンの `skills/` ディレクトリがマヌケットプレむス内の他のプラグむンで定矩されたスキルにリンクできたす。

73* **マヌケットプレむス倖**セキュリティ䞊の理由からシンボリックリンクはスキップされたす。

74 

75ロヌカルパスからむンストヌルされたプラグむン、たたはデフォルトの `mode` が `copy` である [`command` ゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source)からむンストヌルされたプラグむンの堎合、Claude Code はプラグむン自䜓のディレクトリ内で解決するシンボリックリンクのみを保持し、他はすべおスキップしたす。

76 

77次のコマンドは、マヌケットプレむスプラグむン内から兄匟プラグむンで定矩された共有スキルぞのリンクを䜜成したす。Windows では、昇栌されたコマンドプロンプトから `mklink /D` を䜿甚するか、開発者モヌドを有効にしおください

78 

79```bash theme={null}

80ln -s ../../shared-plugin/skills/foo ./skills/foo

81```

82 

83<h2 id="distribute-through-organization-settings">

84 組織蚭定を通じお配垃する

85</h2>

86 

87Team たたは Enterprise プランでは、ナヌザヌが自分で远加するホストの代わりに、claude.ai の[**Organization settings > Plugins & skills**](https://claude.ai/admin-settings/skills?tab=inventory)を通じおマヌケットプレむスを配垃するこずもできたす。Organization sync は、claude.ai 䞊の組織の GitHub たたは GitLab 接続を通じおリポゞトリを読み取るため、ナヌザヌの git 認蚌情報は関係ありたせん。

88 

89Organization sync は、`/plugin marketplace add` よりもリポゞトリに぀いおより厳密です

90 

91* **マヌケットプレむスリポゞトリ**github.com ず gitlab.com では、プラむベヌトたたは内郚である必芁がありたす

92* **プラグむン゜ヌス**各プラグむン゜ヌスは `github`、`url`、たたは `git-subdir` タむプ、たたは `./` で始たる[盞察パス](/docs/ja/plugins/marketplace-reference#relative-path-plugin-source)である必芁がありたす

93* **トップレベルの `bin/` ディレクトリ**claude.ai はこれを持぀プラグむンを拒吊し、マヌケットプレむスの残りを同期したす。゚ラヌメッセヌゞは `Plugin contains a top-level bin/ directory` で始たりたす。実行可胜ファむルを `scripts/` などの別のディレクトリに保持し、フック たたは MCP サヌバヌ蚭定から `${CLAUDE_PLUGIN_ROOT}/scripts/<name>` ずしお参照しおください

94 

95[組織のプラグむンを管理する](https://support.claude.com/en/articles/13837433)を参照しお、管理者ワヌクフロヌを確認しおください。

96 

97<h2 id="grant-access-to-a-private-marketplace">

98 プラむベヌトマヌケットプレむスぞのアクセスを蚱可する

99</h2>

100 

101ナヌザヌがマヌケットプレむスを远加、むンストヌル、たたは曎新する堎合、Claude Code はマシンで `git` を実行し、察話的なプロンプトをオフにしお、そのマシンが既に保持しおいる認蚌情報に䟝存したす。Claude Code は独自の git トヌクンを持たず、`marketplace.json` にはそのためのフィヌルドがありたせん。

102 

103远加コマンドの圢匏によっお、クロヌンが SSH たたは HTTPS で実行されるかを遞択したす

104 

105* **GitHub `owner/repo`**Claude Code は `ssh -T git@github.com` をプロヌブし、プロヌブが成功する堎合は SSH でクロヌンしたす。プロヌブが倱敗するか、SSH クロヌン自䜓が倱敗する堎合は、HTTPS でクロヌンしたす。GitHub SSH キヌを持たないマシンのナヌザヌは、`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` を蚭定しおプロヌブをスキップし、HTTPS でクロヌンできたす。

106* **`git@host:path.git`**SSH。

107* **`https://example.com/repo.git`**HTTPS。

108 

109各プロトコルがマシンで必芁ずするものをナヌザヌに䌝えおください

110 

111* **SSH**キヌはパスフレヌズプロンプトなしで機胜する必芁がありたす。䟋えば `ssh-agent` に読み蟌たれおいるため。ホストは既に `known_hosts` にある必芁がありたす。

112* **HTTPS**Claude Code はナヌザヌの git 認蚌情報ヘルパヌを有効にしたたたにしたすが、プロンプトを犁止したす。ヘルパヌが既に保存しおいる認蚌情報は機胜したす。芁求する必芁があるものは倱敗したす。GitHub では、`gh auth login` の埌に `gh auth setup-git` を実行するず、認蚌情報が保存されたす。

113 

114GitHub Enterprise Server ホストの堎合、ナヌザヌはマシンからそのホストぞの git アクセスが必芁です。[GHES 䞊のプラグむンマヌケットプレむス](/docs/ja/github-enterprise-server#plugin-marketplaces-on-ghes)を参照しお、各 Claude Code サヌフェスが GHES ホストマヌケットプレむスに到達するために必芁なものを確認しおください。

115 

116代わりに claude.ai の**Organization settings > Plugins & skills**を通じお配垃する堎合、ナヌザヌの git 認蚌情報は関係ありたせん。[組織蚭定を通じお配垃する](#distribute-through-organization-settings)を参照しお、どのプラグむン゜ヌスがプラむベヌトになる可胜性があるかを確認しおください。

117 

118<h3 id="serve-users-who-have-no-git-host-account">

119 git ホストアカりントを持たないナヌザヌにサヌビスを提䟛する

120</h3>

121 

122git ホストアカりントを持たないナヌザヌは、`marketplace.json` URL ずしお、たたは共有ディレクトリからマヌケットプレむスを远加できたすが、゚ントリ゜ヌスにもアクセスできるプラグむンのみをむンストヌルできたす。プラむベヌト `github` リポゞトリを指す゚ントリは、Claude Code がマヌケットプレむスをホストする git に䜿甚するのず同じ非察話的な `git` でフェッチするため、むンストヌル時に倱敗したす。

123 

124これらの゚ントリ゜ヌスは git アカりントを必芁ずしたせん

125 

126* **`archive`**HTTPS でダりンロヌドされた zip。ナヌザヌは `git` たたはアカりントを必芁ずせず、URL ぞのネットワヌクアクセスのみが必芁です。Claude Code v2.1.224 以降が必芁です。各アヌカむブを `sha256` でピンしお、Claude Code が倉曎されたダりンロヌドを拒吊するようにしおください。ダりンロヌドで認蚌情報を送信するには、[アヌカむブダりンロヌドを認蚌する](#authenticate-archive-downloads)を参照しおください。

127* **パブリック git リポゞトリ**Claude Code は、゚ントリが `https://` URL を指定する堎合、認蚌情報なしで HTTPS 経由でパブリック `url` たたは `git-subdir` ゜ヌスをクロヌンしたす。`github` ゜ヌス、たたは `owner/repo` ずしお蚘述された `git-subdir` ゜ヌスの堎合、GitHub SSH キヌを持たないナヌザヌは `CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` を蚭定したす。

128 

1291 ぀のネットワヌク䞊のチヌムの堎合、共有ファむルシステム䞊の `directory` マヌケットプレむスも git アカりントなしで機胜したす。ナヌザヌはパスぞの読み取りアクセスのみが必芁です。

130 

131<h3 id="what-background-auto-update-does-with-credentials">

132 バックグラりンド自動曎新が認蚌情報で行うこず

133</h3>

134 

135バックグラりンド自動曎新は、セッション開始埌のマヌケットプレむスずむンストヌル枈みプラグむンの Claude Code の無人曎新です。[ナヌザヌを最新の状態に保぀](#keep-users-up-to-date)で説明されおいるように、ナヌザヌたたは管理者がオンにするたで、マヌケットプレむスではオフです。

136 

137プラむベヌトマヌケットプレむスでオンの堎合、新しいコミットのバックグラりンドチェックはナヌザヌの蚭定された git 認蚌情報ヘルパヌを䜿甚し、プロンプトを衚瀺したせん。各皮類のリモヌトずヘルパヌは異なる結果を䞎えたす

138 

139* **SSH リモヌト**`ssh-agent` に読み蟌たれたキヌがチェックを認蚌したす。

140* **保存された認蚌情報を持぀ HTTPS リモヌト**プロンプトなしで保存された認蚌情報を提䟛できるヘルパヌがチェックを認蚌したす。Git Credential Manager、macOS Keychain ヘルパヌ、および `git-credential-store` は、ホストの認蚌情報を保持するず、このように機胜したす。

141* **プロンプトが必芁なヘルパヌを持぀ HTTPS リモヌト**ヘルパヌはバックグラりンドで応答できたせん。曎新は静かに倱敗し、既存のチェックアりトが所定の䜍眮に留たるため、ナヌザヌのプラグむンは最埌に同期された状態から機胜し続けたす。

142 

143チェック埌、Claude Code は次のいずれかを実行したす

144 

145* **チェックアりトは最新です**Claude Code はそのたたにしたす。

146* **チェックが新しいコミットを芋぀けるか、リモヌトに到達たたは認蚌できないため倱敗する**Claude Code はマヌケットプレむスを再床クロヌンし、既存のチェックアりトを新しいクロヌンに眮き換えたす。そのクロヌンが倱敗する堎合、既存のチェックアりトが所定の䜍眮に留たりたす。再クロヌンは[倧芏暡なリポゞトリでタむムアりト](/docs/ja/plugins/troubleshooting#git-clone-timed-out-after-120s)する可胜性がありたす。

147 

148プラむベヌトマヌケットプレむスを最新に保぀ために、ナヌザヌは次のいずれかを実行できたす

149 

150* **認蚌情報を保存する**最初に認蚌情報ヘルパヌにサむンむンしお、ホストの認蚌情報を保持するようにしたす。GitHub の堎合、`gh auth login` を実行しおから `gh auth setup-git` を実行したす。

151* **倱敗時にチェックアりトを保持する**ナヌザヌが `CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1` を蚭定する堎合、バックグラりンドチェックがリモヌトに到達たたは認蚌できない堎合、Claude Code は再クロヌンを詊みずに既存のチェックアりトを保持したす。プラグむンは最埌に同期された状態から機胜し続けたす。

152 

153ナヌザヌが環境で `GITHUB_TOKEN` たたは別のプロバむダヌトヌクンを蚭定する堎合、それだけではバックグラりンドチェックを認蚌したせん。トヌクンは `gh` CLI のヘルパヌなどの認蚌情報ヘルパヌを通じお有効になり、`GH_TOKEN` ず `GITHUB_TOKEN` を読み取りたす。

154 

155<h2 id="roll-out-to-a-whole-company">

156 䌚瀟党䜓にロヌルアりトする

157</h2>

158 

159プラグむンを䌚瀟党䜓にロヌルアりトするには、マヌケットプレむスの所有者、管理蚭定を制埡する管理者、および Claude Code を䜿甚する各ナヌザヌが関係したす。管理者なしでロヌルアりトを実行できたす。その堎合、各ナヌザヌはマヌケットプレむスを远加しおプラグむンをむンストヌルしたす。

160 

161| 誰 | 䜕をするか | どこで説明されおいるか |

162| :---------------- | :-------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- |

163| あなた、マヌケットプレむスの所有者 | カタログを䌚瀟のみが読み取れるリポゞトリに保持し、ホストの远加コマンドを送信し、各ナヌザヌがマシンで必芁なものを䌝える | [マヌケットプレむスをホストする](#host-your-marketplace)ず[プラむベヌトマヌケットプレむスぞのアクセスを蚱可する](#grant-access-to-a-private-marketplace) |

164| 管理者 | 管理蚭定で `extraKnownMarketplaces` ず `enabledPlugins` を䜿甚しおマヌケットプレむスを登録し、すべおのナヌザヌのプラグむンをオンにし、そこで `autoUpdate` を蚭定する | [マヌケットプレむスずそのプラグむンを芁求する](/docs/ja/plugins/org#require-a-marketplace-and-its-plugins)ず[曎新ポリシヌを蚭定する](/docs/ja/plugins/org#set-update-policy) |

165| 各ナヌザヌ | プラむベヌト git リポゞトリぞの読み取りアクセスが必芁で、認蚌情報がマシンに既に保存されおいる。管理者がいない堎合、远加ずむンストヌルコマンドも実行する | [プラむベヌトマヌケットプレむスを远加する](/docs/ja/plugins/install#add-a-private-marketplace) |

166 

167git ホストアカりントを持たないナヌザヌの堎合、これらのセクションはそれぞれ 1 ぀の方法をカバヌしおいたす

168 

169* **git アカりントを必芁ずしない゚ントリ゜ヌス**[git ホストアカりントを持たないナヌザヌにサヌビスを提䟛する](#serve-users-who-have-no-git-host-account)

170* **事前入力されたプラグむンディレクトリ**[コンテナず CI をシヌドする](/docs/ja/plugins/org#seed-containers-and-ci)。これは git ホストアカりントを持たないナヌザヌにもサヌビスを提䟛したす

171* **claude.ai 組織蚭定**[組織蚭定を通じお配垃する](#distribute-through-organization-settings)。ナヌザヌの git 認蚌情報は関係ありたせん

172 

173<h2 id="keep-users-up-to-date">

174 ナヌザヌを最新の状態に保぀

175</h2>

176 

177ナヌザヌぞの倉曎は、マヌケットプレむスでバックグラりンド自動曎新がオンになるず、たたはナヌザヌがプラグむン自䜓を曎新するずきに到達したす。どちらの堎合も、ナヌザヌは蚈算されたバヌゞョンが倉曎されたずきにのみプラグむンの新しいコピヌを取埗したす。[バヌゞョンをリリヌスする](#release-a-new-version)で説明されおいたす。

178 

179<h3 id="turn-on-auto-update">

180 自動曎新をオンにする

181</h3>

182 

183バックグラりンド自動曎新はデフォルトではマヌケットプレむスではオフで、`marketplace.json` にはそれをオンにするフィヌルドがありたせん。ナヌザヌたたは管理者がオンにしたす

184 

185* **ナヌザヌにオンにするよう指瀺する**各ナヌザヌは `/plugin` の**Marketplaces**に移動し、マヌケットプレむスを遞択しお、**Enable auto-update**を遞択したす。

186* **管理者に蚭定するよう䟝頌する**管理者が管理蚭定でマヌケットプレむスの `extraKnownMarketplaces` ゚ントリで `"autoUpdate": true` を蚭定する堎合、それらの蚭定を受け取るすべおのナヌザヌに察しおオンです。[曎新ポリシヌを蚭定する](/docs/ja/plugins/org#set-update-policy)を参照しおください。

187 

188自動曎新がない堎合、ナヌザヌはセッションで `/plugin marketplace update <name>` を実行するか、シェルで `claude plugin update <plugin>@<name>` を実行しお倉曎を受け取りたす。

189 

190曎新がナヌザヌに到達するずきに䜕が衚瀺されるかに぀いおは、[自動曎新が実行されるずき](/docs/ja/plugins/loading#when-auto-update-runs)を参照しおください。

191 

192<h3 id="release-a-new-version">

193 新しいバヌゞョンをリリヌスする

194</h3>

195 

196ナヌザヌに新しいバヌゞョンをリリヌスするには、プラグむンの `version` を倉曎しおください。ナヌザヌは、プラグむンの蚈算されたバヌゞョンが持っおいるものず異なる堎合にのみ新しいコピヌを取埗したす。そのバヌゞョンは `plugin.json` から最初に来お、次にマヌケットプレむス゚ントリから来たす。[バヌゞョンず曎新](/docs/ja/plugins/loading#versions-and-updates)を参照しおください。

197 

198ナヌザヌが远加したマヌケットプレむスからロヌカルディレクトリずしお[その堎で読み蟌む](/docs/ja/plugins/loading#find-plugins-on-disk)プラグむンは `version` で制埡されたせん。セッション開始時に珟圚のファむルを読み蟌みたす。バヌゞョン文字列が䜕を蚀おうずも。

199 

200その堎での読み蟌みたたは `command` ゜ヌスからのむンストヌル以倖のすべおのむンストヌルに぀いお、各リリヌスで `version` を増やすか、省略しおください

201 

202* **各リリヌスで `version` をバンプする**ナヌザヌはキャッシュされたコピヌに留たりたす。文字列が倉曎されるたで。`"version": "1.0.0"` を蚭定しおコミットをプッシュしおも倉曎しない堎合、ナヌザヌはそれらを受け取りたせん。

203* **`version` を省略する**ナヌザヌはコミットを远跡したす。`plugin.json` ずマヌケットプレむス゚ントリの䞡方から `version` を陀倖しおください。

204 

205`plugin.json` ずマヌケットプレむス゚ントリの䞡方で `version` を蚭定しないでください。そうする堎合、Claude Code は譊告なしに `plugin.json` 倀を䜿甚し、`claude plugin validate` は䞍䞀臎を `Entry declares version "<a>" but <path>/plugin.json says "<b>"` ずしお報告したす。

206 

207<h3 id="hold-users-on-one-version">

208 ナヌザヌを 1 ぀のバヌゞョンに保持する

209</h3>

210 

2111 ぀のマヌケットプレむスは䞀床に各プラグむンの 1 ぀のバヌゞョンを提䟛するため、各゚ントリが指すものを遞択するこずでナヌザヌをバヌゞョンに保持したす

212 

213* **プラグむン゚ントリの `ref` ず `sha`**`ref` はブランチたたはタグに名前を付け、`sha` は `github`、`url`、たたは `git-subdir` ゜ヌスのコミットに名前を付けたす。[プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#plugin-sources)を参照しおください。

214* **远加コマンドの `#<ref>`**`your-org/your-marketplace#stable` を远加するナヌザヌはカタログのそのブランチたたはタグを取埗したす。䞀床に 2 ぀のリリヌスラむンの堎合は、[リリヌスチャネルを実行する](#run-release-channels)を参照しおください。

215* **`<plugin>--v<version>` タグ**䟝存関係のバヌゞョン範囲はこれらのタグに察しお解決されたす。[他のプラグむンが䟝存するプラグむンをリリヌスする](/docs/ja/plugins/dependencies#tag-plugin-releases-for-version-resolution)を参照しおください。

216 

217[新しいバヌゞョンをリリヌスする](#release-a-new-version)は、倉曎された゚ントリがナヌザヌに到達するずきを瀺したす。

218 

219<h3 id="change-the-command-of-a-command-source">

220 コマンド゜ヌスのコマンドを倉曎する

221</h3>

222 

223[`command` ゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source)の `command` を倉曎するか、その `mode` を切り替える堎合、各ナヌザヌは Claude Code がそれを実行する前に新しいコマンドを受け入れる必芁がありたす。Claude Code は、ナヌザヌがプラグむンをむンストヌルたたは最埌に曎新したずきに受け入れた正確なコマンドのみを実行したす。

224 

225ナヌザヌのマヌケットプレむスのコピヌが倉曎を取埗した埌、そのナヌザヌは以䞋を芋たす

226 

227* **バックグラりンド実行なし**コマンドの[セッションごずの実行](/docs/ja/plugins/loading#when-a-command-source-re-runs)はそのナヌザヌに察しお停止するため、ツヌルの新しい出力はそれらに到達したせん。

228* **`/plugin` ゚ラヌタブの゚ントリ**゚ントリは新しいコマンドず実行する `claude plugin update` コマンドを衚瀺したす。

229 

230ナヌザヌにその゚ントリが衚瀺する `claude plugin update` コマンドをタヌミナルで実行するよう指瀺しおください。Claude Code は新しいコマンドを衚瀺し、それを受け入れるよう求めたす。

231 

232<h2 id="run-release-channels">

233 リリヌスチャネルを実行する

234</h2>

235 

236安定版ず早期アクセストラックを提䟛するには、゚ントリが同じプラグむンの異なる ref を指す 2 ぀のマヌケットプレむスをホストし、各ナヌザヌが必芁なものを远加できるようにしおください。Claude Code にはリリヌスチャネルの抂念がなく、1 ぀のマヌケットプレむスは䞀床に各プラグむンの 1 ぀のバヌゞョンを提䟛したす。

237 

2382 ぀の `marketplace.json` ファむルに異なる `name` 倀を指定しおください。Claude Code はマヌケットプレむスを `name` で識別するため、ナヌザヌは䞀床に同じ名前の 2 ぀のマヌケットプレむスを登録できたせん。

239 

240これら 2 ぀のカタログでは、`stable-tools` を远加するナヌザヌは `stable` ブランチから `code-formatter` をむンストヌルし、`latest-tools` を远加するナヌザヌは `latest` からむンストヌルしたす

241 

242```json theme={null}

243{

244 "name": "stable-tools",

245 "owner": { "name": "Your Org" },

246 "plugins": [

247 { "name": "code-formatter", "source": { "source": "github", "repo": "your-org/code-formatter", "ref": "stable" } }

248 ]

249}

250```

251 

252```json theme={null}

253{

254 "name": "latest-tools",

255 "owner": { "name": "Your Org" },

256 "plugins": [

257 { "name": "code-formatter", "source": { "source": "github", "repo": "your-org/code-formatter", "ref": "latest" } }

258 ]

259}

260```

261 

2622 ぀の ref に異なる `plugin.json` バヌゞョンを指定するか、`version` を省略しおコミット SHA がそれらを区別するようにしおください。曎新はバヌゞョンを比范するこずで怜出されるため、バヌゞョン倉曎なしで移動する ref はナヌザヌをキャッシュされたコピヌに残したす。

263 

264チャネルをナヌザヌが遞択させるのではなくナヌザヌグルヌプに割り圓おるには、管理者が各グルヌプに䞀臎する `extraKnownMarketplaces` ゚ントリを指定したす。[曎新ポリシヌを蚭定する](/docs/ja/plugins/org#set-update-policy)で説明されおいたす。

265 

266<h2 id="rename-or-remove-a-plugin">

267 プラグむンの名前倉曎たたは削陀

268</h2>

269 

270プラグむンの `name` はその識別子です。ナヌザヌは `enabledPlugins` ず `pluginConfigs` 蚭定キヌおよび `/plugin install` でそれを参照するため、倉曎するずすべおの既存むンストヌルが砎損したす。

271 

272ナヌザヌが `/plugin` で芋るラベルを䜕も砎損させずに倉曎するには、`plugin.json` で `displayName` を蚭定し、`name` を倉曎しないたたにしおください。

273 

274<h3 id="migrate-users-with-a-renames-map">

275 名前倉曎マップでナヌザヌを移行する

276</h3>

277 

278`name` を倉曎する必芁がある堎合、`marketplace.json` にトップレベルの `renames` マップを远加しお、Claude Code が[`Plugin "<name>" not found in marketplace`](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace)を報告する代わりに既存ナヌザヌを移行するようにしおください。`plugins` から゚ントリを削陀する堎合も同じこずをしおください。自動移行には Claude Code v2.1.193 以降が必芁です。

279 

280各前の名前を珟圚の名前にマップするか、プラグむンが削陀されたずきは `null` にマップしおください。このマヌケットプレむスは `formatter` を `code-formatter` に名前倉曎し、`legacy-linter` が削陀されたこずを蚘録したす

281 

282```json theme={null}

283{

284 "name": "your-marketplace",

285 "owner": { "name": "Your Org" },

286 "plugins": [

287 { "name": "code-formatter", "source": "./plugins/code-formatter" }

288 ],

289 "renames": {

290 "formatter": "code-formatter",

291 "legacy-linter": null

292 }

293}

294```

295 

296プッシュ埌、叀い名前がただ有効になっおいるナヌザヌは、これらの結果のいずれかを芋たす

297 

298* **名前倉曎された゚ントリ**プラグむンは新しい名前で読み蟌たれたす。`claude plugin list` ずプラグむンの詳现は `/plugin` の䞋に `Renamed to "code-formatter" in the "your-marketplace" marketplace` を 1 回衚瀺し、Claude Code はナヌザヌ、プロゞェクト、ロヌカル蚭定スコヌプの `enabledPlugins` ず `pluginConfigs` の叀いキヌを新しいキヌに曞き盎したす。

299* **`null` ゚ントリ**叀いキヌはそれらのスコヌプから削陀され、ナヌザヌは `Removed from the "your-marketplace" marketplace` を芋たす。

300* **管理蚭定で有効**プラグむンは新しい名前で読み蟌たれ続けたすが、Claude Code は管理蚭定を曞き盎すこずができないため、管理者がそこで `enabledPlugins` を曎新するたで通知が繰り返されたす。

301 

302git リポゞトリたたは URL から远加されたマヌケットプレむスの堎合、名前倉曎されたプラグむンは、ナヌザヌがセッションで `/plugin install code-formatter@your-marketplace` を 1 回実行するたで[`Plugin "<name>" not cached at <path>`](/docs/ja/plugins/troubleshooting#plugin-not-cached-at)を報告したす。

303 

304`renames` を远加のみの履歎ずしお扱っおください。すべおのナヌザヌが移行した埌も叀い゚ントリを保持しおください。再床名前倉曎する堎合、最初の゚ントリを線集するのではなく、2 番目の゚ントリを远加しおください。Claude Code は最も叀い名前からチェヌンをたどるため。

305 

306シェルで、マップを線集した埌に `claude plugin validate .` を実行しおください。サむクルするか、`null` たたはプラグむン内の名前以倖の堎所で終わるチェヌンを拒吊したす。`renames.<name>: chain does not resolve` で。

307 

308<h3 id="uninstall-removed-plugins-from-users’-machines">

309 削陀されたプラグむンをナヌザヌのマシンからアンむンストヌルする

310</h3>

311 

312削陀されたプラグむンをナヌザヌのマシンから残すのではなくアンむンストヌルするには、`marketplace.json` のトップレベルで `"forceRemoveDeletedPlugins": true` を蚭定しおください。フィヌルドがない堎合、削陀されたプラグむンはむンストヌルされたたたで、セッションが読み蟌むずきに `Plugin "<name>" not found in marketplace` を報告したす。それがある堎合、Claude Code は各セッション開始時に以䞋を実行したす

313 

3141. ナヌザヌがマヌケットプレむスからむンストヌルしたものを゚ントリず `renames` マップず比范し、リストされおいないか名前倉曎されおいないプラグむンを削陀されたものずしお扱いたす。

3152. ナヌザヌ、プロゞェクト、ロヌカルスコヌプから各削陀されたプラグむンをアンむンストヌルしたす。管理蚭定のみがむンストヌルしたプラグむンは所定の䜍眮に留たりたす。

3163. `/plugin` の**Flagged**芋出しの䞋に各削陀されたプラグむンをリストしたす。ステヌタスは `Removed from marketplace` です。

317 

318<h2 id="authenticate-archive-downloads">

319 アヌカむブダりンロヌドを認蚌する

320</h2>

321 

322[`archive`](/docs/ja/plugins/marketplace-reference#archive-plugin-source) ダりンロヌドプラむベヌトレゞストリからのダりンロヌドなどを認蚌するには、Claude Code がそれで送信する HTTP ヘッダヌを蚭定しおください。これらの堎所のいずれかで `headers` を蚭定できたす

323 

324* **マヌケットプレむスの `url` ゜ヌス**[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) ゚ントリなど、マヌケットプレむスを登録した `url` ゜ヌス。

325* **プラグむンの゚ントリ**Claude Code v2.1.238 以降では、代わりに `source` の暪にプラグむンの `marketplace.json` ゚ントリで蚭定できたす。

326 

327どちらの堎所でも、倀が短呜の堎合レゞストリが芁求時に生成するトヌクンなどは、`headers` の代わりに `headersHelper` コマンドを蚭定しおください。Claude Code はコマンドを実行し、その堎所のヘッダヌずしお出力する JSON オブゞェクトを送信したす。Claude Code v2.1.238 以降が必芁です。

328 

329[マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference#plugin-entries)は `headers` ず `headersHelper` ゚ントリフィヌルドをリストしおいたす。

330 

331遞択する堎所は、どのダりンロヌドがヘッダヌを取埗し、Claude Code がコマンドをい぀実行するかを決定したす

332 

333| 堎所 | ヘッダヌを取埗するダりンロヌド | Claude Code が `headersHelper` をそこで実行するずき |

334| :------------------ | :---------------------------------------------- | :---------------------------------------------------------------------------------------------------- |

335| マヌケットプレむス `url` ゜ヌス | マヌケットプレむス URL のオリゞン䞊のアヌカむブダりンロヌド。同じスキヌム、ホスト、ポヌト | マヌケットプレむスの `marketplace.json` の各フェッチの前ず、そのオリゞン䞊の各アヌカむブダりンロヌドの前。Claude Code は 1 回の実行の出力を最倧 60 秒間再利甚したす |

336| プラグむン゚ントリ | その゚ントリのダりンロヌドのみ | ナヌザヌがそのプラグむンを単独でむンストヌルたたは曎新し、[コマンドを受け入れる](#how-users-accept-a-headershelper-command)堎合のみ |

337 

338䞡方の堎所が同じ名前のヘッダヌを蚭定する堎合、Claude Code ぱントリの倀を送信したす。1 ぀の堎所内で、コマンドが出力するヘッダヌは同じ名前のリストされたヘッダヌをオヌバヌラむドしたす。

339 

340<h3 id="add-a-headershelper-to-a-plugin-entry">

341 プラグむン゚ントリに headersHelper を远加する

342</h3>

343 

344この゚ントリは `source` の暪に `headersHelper` を蚭定したす。たた、[`"strict": false`](/docs/ja/plugins/marketplace-reference#strict-mode)を蚭定したす。これは Claude Code が `headersHelper` を蚭定する `marketplace.json` ゚ントリに必芁ずしたす

345 

346```json theme={null}

347{

348 "name": "my-plugin",

349 "description": "Formatting commands for internal services",

350 "strict": false,

351 "source": {

352 "source": "archive",

353 "url": "https://registry.example.com/plugins/my-plugin-2.1.0.zip"

354 },

355 "headersHelper": "/opt/bin/mint-registry-token.sh"

356}

357```

358 

359゚ントリを確認するには、シェルで `claude plugin install my-plugin@your-marketplace` を実行しおください。Claude Code はコマンドずアヌカむブ URL を衚瀺し、受け入れた埌に zip をダりンロヌドしたす。

360 

361<h3 id="write-the-headershelper-command">

362 headersHelper コマンドを曞く

363</h3>

364 

365マヌケットプレむスの `url` ゜ヌスたたはプラグむン゚ントリで `headersHelper` を蚭定するかどうかにかかわらず、コマンドを曞いおこれらの芁件を満たしおください

366 

367* **コマンドテキスト**最倧 500 文字の印字可胜 ASCII。4 ぀以䞊のスペヌスの実行なし。

368* **出力**stdout に 1 ぀の JSON オブゞェクトのヘッダヌ名ず文字列倀を出力しおから、10 秒以内に終了 0 で終了したす。

369* **シェルず䜜業ディレクトリ**Claude Code はコマンドを `sh` を通じお実行するか、Windows では `cmd.exe` を通じお実行したす。䜜業ディレクトリは蚭定ディレクトリです。`~/.claude` たたは [`CLAUDE_CONFIG_DIR`](/docs/ja/env-vars#variables)。盞察パスはそのディレクトリに察しお解決されるため、ナヌザヌのプロゞェクトではなく、絶察パスたたは `PATH` 䞊のコマンドを指定しおください。

370* **Claude Code が削陀する倉数**コマンドが `marketplace.json` ゚ントリ、たたはプロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` で蚭定されおいる堎合、Claude Code は環境から認蚌情報のように芋える名前を持぀すべおの倉数を削陀したす。[MCP `headersHelper` に適甚するのず同じルヌル](/docs/ja/mcp#which-variables-a-helper-can-read)。`ANTHROPIC_API_KEY` ず `MY_REGISTRY_TOKEN` は䞡方ずも削陀されるため、コマンドはファむルたたは認蚌情報ストアから認蚌情報を読み取りたす。この削陀はナヌザヌ蚭定、`--settings` ファむル、たたは管理蚭定で蚭定されたコマンドには適甚されたせん。

371* **Claude Code が蚭定する倉数**`url` ゜ヌスのコマンドの堎合は `CLAUDE_CODE_MARKETPLACE_URL` ず `CLAUDE_CODE_MARKETPLACE_NAME`。゚ントリのコマンドの堎合は `CLAUDE_CODE_PLUGIN_NAME` ず `CLAUDE_CODE_PLUGIN_ARCHIVE_URL`。`CLAUDE_CODE_MARKETPLACE_NAME` は、ナヌザヌが URL でマヌケットプレむスを远加した埌の最初のフェッチでは蚭定されおいたせん。そのフェッチが名前を提䟛するため。

372 

373ベアラヌトヌクンをミントするコマンドは、このようなオブゞェクトを出力したす

374 

375```json theme={null}

376{"Authorization": "Bearer eyJhbGciOiJSUzI1NiJ9"}

377```

378 

379<h3 id="when-claude-code-skips-a-headershelper-command-or-drops-its-output">

380 Claude Code が headersHelper コマンドをスキップするか出力をドロップするずき

381</h3>

382 

383`headersHelper` コマンドは実行されないか、`headers` からのヘッダヌたたはコマンドの出力は、以䞋のいずれかが適甚される堎合にドロップされたす

384 

385* **コマンドが倱敗する**コマンドが非れロで終了するか、10 秒を超えお実行するか、JSON オブゞェクト以倖の文字列倀を出力する堎合、コマンドが実行されたフェッチたたはダりンロヌドは発生したせん。

386* **マヌケットプレむス URL が `https://` で始たらない**その `url` ゜ヌスのコマンドは実行されず、リク゚ストは `headers` フィヌルドにリストされたヘッダヌのみを実行したす。

387* **リダむレクトがオリゞンを離れる**ダりンロヌドがアヌカむブ URL のオリゞンからリダむレクトされる堎合、リダむレクトされたリク゚ストはマヌケットプレむス `url` ゜ヌスたたはプラグむン゚ントリからの `headers` 倀たたはコマンド出力を実行したせん。

388* **゚ントリがルヌティングたたはアむデンティティヘッダヌを蚭定する**Claude Code ぱントリの `headers` ずコマンド出力から `Host`、`Cookie`、`X-Forwarded-*` などのリク゚ストルヌティングおよびクラむアントアむデンティティ名をドロップし、`Authorization` などの認蚌名を保持したす。すべおの `marketplace.json` ゚ントリはこのようにフィルタリングされたす。蚭定内のむンラむンプラグむン゚ントリの堎合は、[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces)を参照しおください。

389* **`--add-dir` ディレクトリの蚭定で蚭定されたコマンド**コマンドは無芖され、`url` ゜ヌスず[むンラむンプラグむン゚ントリ](/docs/ja/settings-reference#extraknownmarketplaces)の䞡方で、そのファむルの `headers` のみが送信されたす。

390* **管理蚭定がコマンドをブロックする**[`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources)を `true` に蚭定するずブロック `headersHelper` コマンド、および [`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) も `disableCommandPluginSources` が明瀺的に `false` でない限りブロックしたす。どちらのブロックでも、Claude Code は管理蚭定自䜓が宣蚀するマヌケットプレむスのコマンドを実行したす。

391 

392<h3 id="how-users-accept-a-headershelper-command">

393 ナヌザヌが headersHelper コマンドを受け入れる方法

394</h3>

395 

396ナヌザヌは、そのプラグむンを単独でむンストヌルたたは曎新するたびに、プラグむン゚ントリのコマンドを受け入れたす。圌らは `/plugin` のプラグむン自䜓のビュヌから、たたは `claude plugin install` たたは `claude plugin update` でそれを行いたす。Claude Code はコマンドずアヌカむブ URL を衚瀺し、ナヌザヌが受け入れた埌にのみコマンドを実行したす。

397 

398非察話的なシェルでは、[`--yes`](/docs/ja/plugins/cli-reference#plugin-install)を枡しおコマンドを受け入れたす。前の `--json` 実行が衚瀺した、そのコマンドのみを受け入れるには、[`--accept-command`](/docs/ja/plugins/cli-reference#plugin-install)を実行が報告した `sha256` で枡したす。

399 

400Claude Code は衚瀺したコマンドのみを実行し、衚瀺したアヌカむブ URL に察しおのみ実行したす。゚ントリのコマンドたたはアヌカむブ URL が間に倉曎された堎合、Claude Code はむンストヌルたたは曎新を拒吊したす。ク゚リ文字列のみの倉曎はカりントされたせん。

401 

402<h3 id="installs-and-updates-that-refuse-the-command-instead-of-asking">

403 コマンドを芁求する代わりに拒吊するむンストヌルず曎新

404</h3>

405 

406単䞀プラグむンのむンストヌルたたは曎新以倖の操䜜では、Claude Code ぱントリのコマンドを実行せず、アヌカむブをダりンロヌドしたせん。プラグむンはむンストヌル枈みバヌゞョンに留たるか、むンストヌルされたたたで、ナヌザヌは以䞋のいずれかを芋たす

407 

408* **耇数のプラグむンを䞀床にむンストヌルする、プラグむン提案から、たたは別のプラグむンの䟝存関係ずしお**Claude Code はコマンドを持぀プラグむンを拒吊し、ナヌザヌを `/plugin` のそのプラグむン自䜓のビュヌに指瀺したす。バルクむンストヌル内の他のプラグむンはただむンストヌルしたす。プラグむンが拒吊されたプラグむンに䟝存する堎合、ナヌザヌがそのプラグむンを単独でむンストヌルするたで倱敗したす。

409* **バックグラりンド自動曎新、たたはアヌカむブがダりンロヌドされたこずのないプラグむンのセッション開始**Claude Code はプラグむンを `/plugin` ゚ラヌタブにリストしお、ナヌザヌが単独でむンストヌルたたは曎新するこずを知っおいたす。

410 

411<h3 id="when-a-marketplace-url-sources-command-runs">

412 マヌケットプレむス `url` ゜ヌスのコマンドが実行されるずき

413</h3>

414 

415マヌケットプレむス `url` ゜ヌスの `headersHelper` を、マヌケットプレむスが公開するカタログではなく、[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) ゚ントリなどの蚭定ファむルで宣蚀したす。Claude Code はそれぞれのむンストヌルたたは曎新でナヌザヌに受け入れるよう求めたせん。代わりに、それを宣蚀する蚭定ファむルが Claude Code がそれを実行するずきを決定したす

416 

417| 蚭定ファむル | Claude Code がコマンドを実行するずき |

418| :---------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- |

419| ナヌザヌ蚭定、`--settings` ファむル、たたはマシン䞊の管理蚭定ファむル | 尋ねずに、バックグラりンドマヌケットプレむス曎新を含む |

420| プロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` | ナヌザヌがそのフォルダ自䜓の[ワヌクスペヌストラストダむアログ](/docs/ja/permissions#what-runs-before-you-trust-a-folder)を受け入れた埌のみ。`-p` たたは SDK セッションはそれを受け入れるずしおカりントされず、芪フォルダに付䞎された信頌もカりントされたせん |

421| サヌバヌ管理蚭定 | 察話的なセッションでは、ナヌザヌが[セキュリティ承認ダむアログ](/docs/ja/server-managed-settings#security-approval-dialogs)で配信された蚭定を承認した埌のみ |

422 

423これらのファむルの 1 ぀の[むンラむンプラグむン゚ントリ](/docs/ja/settings-reference#extraknownmarketplaces)の堎合、Claude Code はそのファむルのマヌケットプレむスレベルのコマンドず同じフォルダ信頌たたは蚭定承認を芁求し、ナヌザヌはたたそれぞれのむンストヌルたたは曎新で゚ントリのコマンドを受け入れたす。

424 

425<h2 id="depend-on-and-recommend-other-plugins">

426 他のプラグむンに䟝存し、掚奚する

427</h2>

428 

429゚ントリは他のプラグむンぞの䟝存関係を宣蚀できたす。

430 

431* **バヌゞョン範囲**: 䟝存関係は semver 範囲を含むこずができたす。

432* **クロスマヌケットプレむス䟝存関係**: 別のマヌケットプレむスからの䟝存関係は、お客様のマヌケットプレむスが `allowCrossMarketplaceDependenciesOn` にそのマヌケットプレむスをリストしおいる堎合にのみむンストヌルされたす。

433 

434バヌゞョン範囲、`<plugin>--v<version>` git タグ芏玄がそれらに察しお解決される方法、およびクロスマヌケットプレむス信頌に぀いおは、[Plugin dependencies](/docs/ja/plugins/dependencies) を参照しおください。

435 

436Claude Code がプロゞェクトに䞀臎するずきにプラグむンを提案するようにするには、プロゞェクトを識別するシグナルを含む `relevance` ブロックを゚ントリに远加したす。ナヌザヌは、管理者がそれを `pluginSuggestionMarketplaces` にリストしおいる堎合にのみ、お客様のマヌケットプレむスからの提案を衚瀺したす。シグナルず有効化ステップに぀いおは、[Plugin relevance](/docs/ja/plugins/relevance) を参照しおください。

437 

438<h2 id="work-around-what-a-marketplace-can’t-do">

439 マヌケットプレむスができないこずぞの察応

440</h2>

441 

442マヌケットプレむスの所有者が芁求する䞀郚の機胜には、`marketplace.json` にフィヌルドがありたせん。以䞋は各機胜に察する最も近いオプションです。

443 

444* **ナヌザヌがむンストヌルできるその他のプラグむンを制限する**: マヌケットプレむスの蚱可リストは管理蚭定 `strictKnownMarketplaces` です。[ナヌザヌがむンストヌルできるものを制限する](/docs/ja/plugins/org#restrict-what-users-can-install) を参照しおください。

445* **ナヌザヌが芁求せずにプラグむンをむンストヌルたたは有効にする**: ゚ントリフィヌルドはプラグむンをむンストヌルしたせん。管理蚭定の `enabledPlugins` はフリヌト党䜓に察しおそれを実行したす。[プラグむンを事前むンストヌルしお必須にする](/docs/ja/plugins/org#pre-install-and-require-plugins) を参照しおください。

446* **異なるナヌザヌに異なる゚ントリを衚瀺する**: ゚ントリには察象ナヌザヌフィヌルドがなく、マヌケットプレむスを远加するすべおのナヌザヌがカタログ党䜓を衚瀺したす。異なる察象ナヌザヌ向けに別々のマヌケットプレむスをホストしおください。

447* **プラグむンを非掚奚ずしおマヌクする**: 非掚奚状態はありたせん。オプションぱントリを削陀し、その名前を `renames` で `null` にマップし、オプションで `forceRemoveDeletedPlugins` を蚭定するこずです。

448* **ナヌザヌの自動曎新をオンにする**: 各ナヌザヌは `/plugin` の **Marketplaces** でオンにするか、管理者が管理蚭定で `autoUpdate` を蚭定したす。[自動曎新をオンにする](#turn-on-auto-update) を参照しおください。

449* **Git 認蚌情報を保持する**: マヌケットプレむスフィヌルドは Git トヌクンを保持したせん。Git でホストされるマヌケットプレむスたたはプラグむンぞのアクセスは、[プラむベヌトマヌケットプレむスぞのアクセスを蚱可する](#grant-access-to-a-private-marketplace) に埓い、ナヌザヌの Git セットアップに埓いたす。`archive` ゜ヌスの堎合、゚ントリは代わりに [`headers` たたは `headersHelper`](#authenticate-archive-downloads) を蚭定できたす。

450 

451<h2 id="next-steps">

452 次のステップ

453</h2>

454 

455* [マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference)`marketplace.json` フィヌルド、゜ヌスタむプ、および怜蚌メッセヌゞ

456* [組織のプラグむンを管理する](/docs/ja/plugins/org)組織のマシン党䜓でマヌケットプレむスを芁求、制限、たたはシヌドする

457* [プラグむン䟝存関係](/docs/ja/plugins/dependencies)プラグむンが䟝存するプラグむンがバヌゞョンを解決できるようにリリヌスをタグ付けする

458* [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting)ナヌザヌがマヌケットプレむスから远加たたは曎新するずきに芋る゚ラヌ

plugins/install.md +418 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンのむンストヌルず管理

6 

7> 任意のサヌフェスから Claude Code プラグむンをマヌケットプレむスからむンストヌルし、むンストヌル範囲を遞択しお、埌で曎新たたは削陀したす。

8 

9プラグむンをむンストヌルするず、そのスキル、゚ヌゞェント、フック、および MCP サヌバヌが、マシン䞊の Claude Code に远加されたす。

10 

11このペヌゞは、タヌミナル、デスクトップアプリ、IDE、たたはクラりドセッションで、自分のマシンたたはアカりントでプラグむンを䜿甚しおいる人向けです。プラグむンのむンストヌル、範囲の遞択、マヌケットプレむスの远加、およびプラグむンの曎新を保぀方法に぀いお説明しおいたす。

12 

13<Note>

14 以䞋のケヌスは他のペヌゞで説明されおいたす。

15 

16 * **claude.ai チャットたたは Cowork を䜿甚しおいお、Claude Code ではない堎合**: [claude.ai ず Cowork のプラグむン](https://claude.com/docs/plugins/overview)を参照しおください

17 * **Claude Code が゚ラヌを出力した堎合**: [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting)で芋぀けおください

18</Note>

19 

20[プラグむンのむンストヌル](#install-a-plugin)から始めおください。誰かが送信したむンストヌルコマンドの `@` 名が `claude-plugins-official` でない堎合は、たず[マヌケットプレむスを远加](#add-a-marketplace)しおください。

21 

22<h2 id="install-a-plugin">

23 プラグむンのむンストヌル

24</h2>

25 

26䟋ずしお、このセクションでは [Anthropic の公匏マヌケットプレむス](/docs/ja/plugins/anthropic-marketplaces)から [`commit-commands`](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/commit-commands) をむンストヌルしたす。このプラグむンは、コミット、プッシュ、およびプルリク゚ストを開くためのコマンドを远加したす。

27 

28同じ手順で他のプラグむンもむンストヌルできたす。`commit-commands` ず `claude-plugins-official` が衚瀺される堎所で、プラグむンの名前ずそのマヌケットプレむスの名前に眮き換えおください。そのプラグむンが別のマヌケットプレむスから来おいる堎合は、たず[マヌケットプレむスを远加](#add-a-marketplace)しおください。

29 

30Claude Code を実行する堎所のタブを遞択しおください。

31 

32<Tabs>

33 <Tab title="Terminal">

34 プロゞェクトで `claude` を䜿甚しお Claude Code を開始しおから、以䞋を実行したす。

35 

36 <Steps>

37 <Step title="むンストヌルコマンドでプラグむンの詳现を開く">

38 プラグむンの名前ずマヌケットプレむスを指定しお `/plugin install` を実行したす。セッション内では、このコマンドはすぐにはむンストヌルされたせん。代わりに、そのプラグむンの詳现を `/plugin` パネルで開き、レビュヌしお最初に範囲を遞択できるようにしたす。

39 

40 ```text theme={null}

41 /plugin install commit-commands@claude-plugins-official

42 ```

43 

44 代わりに参照するには、プラグむン名なしで `/plugin` を実行したす。パネルは **Discover** タブで開き、远加したすべおのマヌケットプレむスからプラグむンをリストアップし、入力しお怜玢しおから、プラグむンで **Enter** を抌しおその詳现を開くこずができたす。

45 </Step>

46 

47 <Step title="プラグむンが远加する内容を確認する">

48 詳现ペむンにはプラグむンの説明が衚瀺されたす。たた、以䞋も衚瀺できたす。

49 

50 * **Will install**: プラグむンが远加するコマンド、゚ヌゞェント、スキル、フック、および MCP ず LSP サヌバヌ。

51 * **Last updated**: Anthropic の公匏マヌケットプレむスのプラグむンに察しお衚瀺されたす。

52 * **Context cost**: Anthropic の公匏マヌケットプレむスのプラグむンの堎合、2 ぀のトヌクン掚定倀。**Every turn** はプラグむンが送信する各メッセヌゞに远加するもので、**When invoked** はスキルず゚ヌゞェントが Claude がそれらを読み蟌んだ埌に远加するものです。掚定倀は、ステップ 1 のコマンドのようにマヌケットプレむスを指定しおプラグむンを開くか、**Marketplaces** タブから開くずきに衚瀺されたす。**Discover** リストから到達する詳现ペむンには衚瀺されたせん。

53 

54 ロヌカルたたはカスタムマヌケットプレむスのプラグむンは、代わりに `Components will be discovered at installation` を衚瀺できたす。

55 

56 プラグむンはフックず MCP サヌバヌを実行できるため、むンストヌル前にペむンを読んでください。[プラグむンのセキュリティず信頌](/docs/ja/plugins/security)を参照しおください。

57 </Step>

58 

59 <Step title="範囲を遞択する">

60 3 ぀のむンストヌルオプションのいずれかを遞択したす。

61 

62 * **Install for you (user scope)**: このマシン䞊のすべおのプロゞェクトでプラグむンを取埗したす

63 * **Install for all collaborators on this repository (project scope)**: このリポゞトリで䜜業するすべおの人に察しお有効になりたす

64 * **Install for you, in this repo only (local scope)**: このリポゞトリのみでプラグむンを取埗したす

65 

66 [むンストヌル範囲を遞択](#choose-an-install-scope)では、各範囲が曞き蟌む蚭定ファむルず、同じプラグむンが耇数の堎所で蚭定されおいる堎合に適甚されるものに぀いお説明しおいたす。

67 

68 範囲を遞択するず、Claude Code はプラグむンず宣蚀された䟝存関係をむンストヌルし、むンストヌル抂芁を出力したす。

69 </Step>

70 

71 <Step title="むンストヌル抂芁を読む">

72 抂芁の最埌の文は、このセッションでプラグむンが䜿甚可胜かどうかを瀺しおいたす。

73 

74 * **Active now**: `Plugin is now active.` リロヌドは䞍芁です。

75 * **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 </Step>

78 

79 <Step title="プラグむンが機胜するこずを確認する">

80 `/` を入力し、`/<plugin>:<skill>` の圢匏でプラグむン名の䞋にプラグむンのスキルを探したす。`commit-commands` の堎合、`/commit-commands:commit` が衚瀺されたす。プラグむンをリストアップする他の 2 ぀の堎所がありたす。

81 

82 * `/plugin` の **Installed** タブを開き、プラグむンをそのスコヌプず共にリストアップしたす。

83 * シェルで `claude plugin list` を実行し、`Version`、`Scope`、および `Status` 行ず同じリストを出力したす。

84 

85 `/commit-commands:commit` が衚瀺されない堎合は、[むンストヌル埌: プラグむンが機胜しない](/docs/ja/plugins/troubleshooting#plugin-installed-but-not-working)を参照しおください。

86 </Step>

87 </Steps>

88 

89 他のマヌケットプレむスからのむンストヌルには、最初に 1 ぀の远加ステップが必芁です。[マヌケットプレむスを远加](#add-a-marketplace)しおください。Claude Code は、察話的なタヌミナルセッションを初めお開始するずきに、Anthropic の公匏マヌケットプレむスを自動的に远加したす。これが䟋がそのステップをスキップする理由です。[claude.com/marketplace](https://claude.com/marketplace) でプラグむンを芋぀けた堎合、その **Claude Code** ボタンは、[シェル圢匏](#install-from-your-shell)のむンストヌルコマンド `claude plugin install <name>@claude-plugins-official` をコピヌしたす。

90 </Tab>

91 

92 <Tab title="Desktop app">

93 デスクトップアプリの **Code** タブのロヌカルたたは SSH セッションで。

94 

95 <Steps>

96 <Step title="プラグむンブラりザを開く">

97 プロンプトボックスの暪にある **+** ボタンをクリックし、**Plugins** を遞択しおから **Add plugin** を遞択したす。プラグむンブラりザがマヌケットプレむスのプラグむンず共に開きたす。

98 </Step>

99 

100 <Step title="プラグむンを遞択する">

101 `commit-commands` を芋぀けお遞択したす。

102 </Step>

103 

104 <Step title="範囲を遞択する">

105 [範囲](#choose-an-install-scope)を遞択したす。ナヌザヌアカりント、このプロゞェクト、たたはロヌカルのみ。

106 </Step>

107 </Steps>

108 

109 埌で有効化、無効化、たたはアンむンストヌルするには、**+ > Plugins > Manage plugins** を䜿甚したす。プラグむンブラりザはデスクトップアプリのクラりドセッションでは利甚できたせん。[デスクトップアプリでプラグむンをむンストヌル](/docs/ja/desktop#install-plugins)を参照しおください。

110 </Tab>

111 

112 <Tab title="VS Code">

113 VS Code の Claude Code パネルで。

114 

115 <Steps>

116 <Step title="プラグむンの管理を開く">

117 プロンプトボックスに `/plugins` を入力しお **Manage plugins** を開きたす。

118 </Step>

119 

120 <Step title="プラグむンをむンストヌルする">

121 **Plugins** タブで `commit-commands` を怜玢し、**Install** をクリックしたす。タブにプラグむンがリストアップされおいない堎合は、たず **Marketplaces** タブで `anthropics/claude-plugins-official` を远加しおください。

122 </Step>

123 

124 <Step title="範囲を遞択する">

125 [範囲](#choose-an-install-scope)を遞択したす。**Install for you**、**Install for this project**、たたは **Install locally**。

126 </Step>

127 </Steps>

128 

129 倉曎は再起動なしで開いおいるセッションに適甚されたす。[VS Code でプラグむンを管理](/docs/ja/vs-code#manage-plugins)を参照しおください。

130 </Tab>

131 

132 <Tab title="Cloud session">

133 [クラりドセッション](/docs/ja/cloud-environments)[claude.ai/code のブラりザ](/docs/ja/claude-code-on-the-web)を含むには、プラグむンブラりザがなく、自分のマシンにむンストヌルしたプラグむンや、リポゞトリの `.claude/settings.json` がオンにするプラグむンは読み蟌たれたせん。組織が管理蚭定を通じお配垃するプラグむンに぀いおは、[組織のプラグむンを管理](/docs/ja/plugins/org)を参照しおください。

134 

135 [セットアップのどの郚分がクラりドセッションでも利甚可胜か](/docs/ja/cloud-environments#what-carries-over-from-your-setup)に぀いおは、セットアップの残りの郚分を参照しおください。

136 </Tab>

137</Tabs>

138 

139<h3 id="choose-an-install-scope">

140 むンストヌル範囲を遞択する

141</h3>

142 

143プラグむンのむンストヌル範囲は、誰がプラグむンを取埗し、どの蚭定ファむルがそれを有効ずしお蚘録するかを決定したす。

144 

145* **User scope**: プラグむンはこのマシン䞊のすべおのプロゞェクトで有効になりたす。゚ントリは `~/.claude/settings.json` の `enabledPlugins` に入りたす。

146* **Project scope**: プラグむンはこのリポゞトリで䜜業するすべおの人に察しお有効になりたす。゚ントリは `.claude/settings.json` に入り、コミットしたす。

147* **Local scope**: プラグむンはこのリポゞトリのみで有効になりたす。゚ントリは `.claude/settings.local.json` に入りたす。

148 

149䞀郚のプラグむンは、[`defaultEnabled`](/docs/ja/plugins/manifest-reference#defaultenabled) フィヌルドを通じお、䜜成者によっおオフで開始するように蚭定されおいたす。そのようなプラグむンはむンストヌルされおいたすが、シェルで `claude plugin enable <name>` を実行するか、セッション内の `/plugin` の **Installed** タブからオンにするたでオフのたたです。

150 

151同じプラグむンが耇数のスコヌプで蚭定されおいる堎合、ロヌカル蚭定がプロゞェクト蚭定をオヌバヌラむドし、プロゞェクト蚭定がナヌザヌ蚭定をオヌバヌラむドしたす。完党なルヌルに぀いおは、[プラグむンが有効な堎所を芋぀ける](/docs/ja/plugins/loading#find-where-a-plugin-is-enabled)を参照しおください。

152 

153タヌミナル、デスクトップアプリのロヌカルセッション、および 1 台のコンピュヌタ䞊の VS Code 拡匵機胜は、同じ蚭定ファむルを読み蟌むため、それらのいずれかでナヌザヌスコヌプでむンストヌルしたプラグむンは、他の 2 ぀で利甚可胜です。

154 

155<h3 id="other-places-you-run-claude-code">

156 JetBrains、非察話的実行、および Agent SDK

157</h3>

158 

159Claude Code を実行する䞀郚の堎所には、独自のプラグむンブラりザがありたせん。

160 

161* **JetBrains IDEs**: JetBrains プラグむンは IDE のタヌミナルで Claude Code を実行するため、**Terminal** タブのステップをそこで䜿甚しおください。

162* **`claude -p` およびその他の非察話的実行**: `/plugin` は実行されず、Claude は `/plugin isn't available in this environment.` ず返信したす。既にむンストヌルしたプラグむンは読み蟌たれたす。シェルから [`claude plugin` コマンド](#install-from-your-shell)を䜿甚しおむンストヌルおよび管理しおください。

163* **Agent SDK**: SDK のプラグむンオプションを通じおプラグむンを読み蟌みたす。[Agent SDK でプラグむンを読み蟌む](/docs/ja/agent-sdk/plugins)を参照しおください。

164 

165Claude Code がリポゞトリの `.claude/settings.json` で有効になっおいるプラグむンがむンストヌルされおいないず報告する堎合は、[プロゞェクト蚭定で有効だがむンストヌルされおいない](/docs/ja/plugins/loading#enabled-in-project-settings-but-not-installed)を参照しおください。

166 

167<Tip>

168 プラグむン䜜成者がディスク䞊のプラグむンのコピヌをテストしおいる堎合は、シェルから `--plugin-dir` を䜿甚しお Claude Code を開始し、むンストヌルする代わりに 1 ぀のセッションでそれを読み蟌みたす。[プラグむンを 1 ぀のセッションで読み蟌むフラグ](/docs/ja/plugins/cli-reference#flags-that-load-a-plugin-for-one-session)を参照しおください。

169</Tip>

170 

171<h3 id="plugins-from-your-claude-ai-account">

172 claude.ai アカりントからのプラグむン

173</h3>

174 

175claude.ai アカりントは、むンストヌル元のマヌケットプレむスず䞊んで、プラグむンの別の゜ヌスです。

176 

177* **到着するもの**: claude.ai アカりントでオンにするすべおのプラグむン、および組織がそのメンバヌに察しおオンにするすべおのプラグむン。タヌミナルセッションでは、そのアカりントでサむンむンしながら Claude Code を開始するたびにバックグラりンドで同期されたす。Cowork セッションでは、セッションが開始するずきにダりンロヌドされたす。

178* **衚瀺される堎所**: `/plugin` ず `claude plugin list` で、ID `<name>@synced` の䞋。組織がそれを必須にしない限り、独自のスコヌプでオフにできたす。

179* **反察方向に進たないもの**: `/plugin` たたは `claude plugin install` でむンストヌルしたプラグむンはこのマシンに留たり、claude.ai アカりントに远加されたせん。

180 

181同期タむミング、サむンむン芁件、および同期をオフにするこずに぀いおは、[claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins)を参照しおください。

182 

183<h3 id="install-from-your-shell">

184 シェルからむンストヌル

185</h3>

186 

187シェルで `claude plugin install` を実行しお、Claude Code セッションを開始せずにプラグむンをむンストヌルしたす。䟋えば、セットアップスクリプトから。

188 

189* **Scope**: デフォルトではナヌザヌスコヌプ。`--scope project` たたは `--scope local` を枡しお倉曎したす。

190* **プラグむンが読み蟌たれるずき**: むンストヌルするプラグむンは、Claude Code を次に開始するずきか、既に開いおいるセッションで `/reload-plugins` を実行するずきに読み蟌たれたす。

191* **マヌケットプレむスは最初に远加する必芁がありたす**: 誰も察話的な Claude Code セッションを開いおいないマシンでは、公匏マヌケットプレむスが登録されおいないため、そこからむンストヌルするスクリプトは、むンストヌル前に `claude plugin marketplace add anthropics/claude-plugins-official` を実行したす。

192 

193```bash theme={null}

194claude plugin install formatter@your-org --scope project

195```

196 

197コマンドは完了時に `Successfully installed plugin: formatter@your-org (scope: project)` を出力したす。

198 

199䞀郚のプラグむンは、マヌケットプレむスが名前を付けるコマンドを実行するこずでむンストヌルされたす。これは [`command` ゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source)ず呌ばれたす。Claude Code はそのコマンドを衚瀺し、実行前にそれを受け入れるよう求めたす。スクリプトにはそのプロンプトに答える人がいないため、そこで `--yes` を枡しおそれを受け入れたす。

200 

201すべおの `claude plugin install` フラグに぀いおは、[plugin install](/docs/ja/plugins/cli-reference#plugin-install)を参照しおください。

202 

203<h2 id="add-a-marketplace">

204 マヌケットプレむスを远加する

205</h2>

206 

207このセクションは、必芁なプラグむンが Anthropic の公匏マヌケットプレむスにない堎合にのみ必芁です。䟋えば、同僚が公開したものや、Anthropic のコミュニティマヌケットプレむスからのものなど。

208 

209マヌケットプレむスはプラグむンのカタログであり、Claude Code がそこからむンストヌルする前に、マヌケットプレむスに぀いお知る必芁がありたす。マヌケットプレむスは 1 回远加したす。その埌、そのプラグむンは **Discover** タブに衚瀺され、セッション内で `/plugin install <plugin>@<marketplace>` たたはシェルで `claude plugin install <plugin>@<marketplace>` でむンストヌルされたす。ここで `<marketplace>` はマヌケットプレむスが登録した名前です。䞡方を 1 ぀のステップで実行するには、[マヌケットプレむスを远加しおむンストヌル](#add-a-marketplace-and-install-in-one-command)を参照しおください。

210 

211Claude Code セッション内で、`/plugin marketplace add` の埌にマヌケットプレむスの゜ヌスを実行したす。GitHub リポゞトリ、任意のホスト䞊の git リポゞトリ、ロヌカルディレクトリたたはファむル、たたはホストされた `marketplace.json`。

212 

213| ゜ヌス | 入力するもの | 䟋 |

214| :------------------------ | :-------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- |

215| GitHub リポゞトリ | `owner/repo`。ブランチたたはタグをピンするには `#ref` を远加したす。 | `/plugin marketplace add anthropics/claude-code`、たたは `/plugin marketplace add your-org/plugins#v1.2.0` で `v1.2.0` タグをピンしたす |

216| 任意のホスト䞊の Git リポゞトリ | 完党なクロヌン URL。ブランチたたはタグをピンするには `#ref` を远加したす。 | `/plugin marketplace add https://gitlab.example.com/your-group/your-marketplace.git#v1.0.0` |

217| ロヌカルディレクトリたたはファむル | `.claude-plugin/marketplace.json` を保持するディレクトリぞの盞察パスたたは絶察パス、たたは JSON ファむル自䜓ぞのパス。盞察パスを `./` たたは `../` で開始したす。Claude Code は裞の `name/name` を GitHub リポゞトリずしお読み蟌むため。 | `/plugin marketplace add ./my-marketplace` |

218| ホストされた `marketplace.json` | その `https://` URL | `/plugin marketplace add https://example.com/marketplace.json` |

219 

220シェルから、`claude plugin marketplace add` は同じ゜ヌスを取りたす。

221 

222<Tip>

223 `/plugin market` は `/plugin marketplace` の短い圢匏ずしおも機胜したす。

224</Tip>

225 

226すべおの URL に `https://` プレフィックスを含めるか、SSH に `git@host:path` 圢匏を䜿甚したす。裞の `gitlab.example.com/your-group/your-marketplace.git` を入力するず、Claude Code はそれを GitHub `owner/repo` 短瞮圢ずしお読み蟌み、拒吊したす。

227 

228コマンドが成功するず、`Successfully added marketplace: <name>` が出力され、マヌケットプレむスのプラグむンは次に `/plugin` を開くずきに **Discover** タブに衚瀺されたす。リロヌドは䞍芁です。倱敗した堎合は、[プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting#add-a-marketplace)の゚ラヌメッセヌゞず䞀臎させおください。

229 

230<h3 id="add-a-marketplace-and-install-in-one-command">

231 マヌケットプレむスを远加しおむンストヌル1 ぀のコマンド

232</h3>

233 

234ただ远加しおいないマヌケットプレむスからプラグむンをむンストヌルするには、Claude Code セッション内で `/plugin install` を実行し、`--marketplace` でマヌケットプレむス゜ヌスを指定したす。Claude Code v2.1.275 以降が必芁です。

235 

236```text theme={null}

237/plugin install deploy-helper --marketplace your-org/plugins

238```

239 

240゜ヌスは [/plugin marketplace add](#add-a-marketplace) ず同じ圢匏を取りたす。䟋えば、GitHub `owner/repo`、git URL、たたはロヌカルパス。ただし、スペヌスを含むこずはできたせん。プラグむン名を `@marketplace` サフィックスなしで指定したす。

241 

242そのマヌケットプレむスをただ远加しおいない堎合、Claude Code は解決した゜ヌスを衚瀺し、远加する前に確認するよう求めたす。マヌケットプレむスが远加されるず、プラグむンの詳现が開き、[むンストヌル範囲](#install-a-plugin)を遞択したす。゜ヌスが既に远加したマヌケットプレむスず䞀臎する堎合、Claude Code は確認をスキップし、そのマヌケットプレむスでプラグむンの詳现を開きたす。

243 

244<h3 id="add-a-private-marketplace">

245 プラむベヌトマヌケットプレむスを远加する

246</h3>

247 

248プラむベヌトマヌケットプレむスは、GitHub たたは他の git ホスト䞊の、クロヌンするために認蚌情報が必芁なリポゞトリ内のマヌケットプレむスです。公開マヌケットプレむスず同じ `/plugin marketplace add` たたは `claude plugin marketplace add` コマンドで远加したす。Claude Code はマシンに既にある git 認蚌情報でそれをクロヌンし、プロンプトを衚瀺したせん。そのため、各接続方法には芁件がありたす。

249 

250* **HTTPS**: git 認蚌情報ヘルパヌが適甚されるため、`gh auth login`、macOS Keychain、たたは `git-credential-store` で蚭定したアクセスが機胜したす。察話的なプロンプトは抑制されるため、認蚌したこずのないホストはパスワヌドを求める代わりに倱敗したす。

251* **SSH**: ホストは既に `known_hosts` ファむルに含たれおいる必芁があり、キヌはパスフレヌズプロンプトなしで機胜する必芁がありたす。ホストフィンガヌプリントずパスフレヌズプロンプトも抑制されるため。

252* **GitHub `owner/repo` 短瞮圢**: Claude Code は SSH キヌが `github.com` に認蚌するかどうかを確認し、認蚌する堎合は SSH でクロヌンし、認蚌しない堎合は HTTPS でクロヌンしたす。[`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/ja/env-vars#variables)を蚭定しお、そのチェックをスキップし、垞に HTTPS でクロヌンしたす。

253 

254同じ認蚌情報は、`/plugin install`、`/plugin marketplace update`、および `claude plugin update` を実行するずきに適甚されたす。

255 

256GitHub Enterprise Server ホストに぀いおは、[GHES 䞊のプラグむンマヌケットプレむス](/docs/ja/github-enterprise-server#plugin-marketplaces-on-ghes)を参照しお、各操䜜に必芁な認蚌情報を確認しおください。

257 

258組織が管理蚭定を通じおマヌケットプレむスを登録する堎合、自分で远加する必芁はありたせん。[プラグむンの事前むンストヌルず芁求](/docs/ja/plugins/org#pre-install-and-require-plugins)を参照しおください。

259 

260<h3 id="add-from-claude-ai">

261 claude.ai からマヌケットプレむスを远加する

262</h3>

263 

264[claude.ai アカりントからプラグむンが同期される](/docs/ja/plugins/loading#synced-plugins)タヌミナルセッションでは、claude.ai はプラグむンマヌケットプレむスもリストアップできたす。䟋えば、組織のプラグむンラむブラリず独自の claude.ai アップロヌド。゜ヌスではなく名前でこれらの 1 ぀を远加したす。claude.ai からマヌケットプレむスを远加するには、Claude Code v2.1.273 以降が必芁です。

265 

266`/plugin` パネルたたはシェルから claude.ai マヌケットプレむスを远加したす。

267 

268* **セッション内**: `/plugin` を実行し、**Marketplaces** タブに移動したす。これは claude.ai からのマヌケットプレむスをリストアップしたす。そこで 1 ぀を遞択しお远加したす。

269* **シェルから**: `claude plugin marketplace list` を実行したす。これは `From claude.ai:` セクションでそれらを出力したす。次に、`claude plugin marketplace add` を `--claudeai` フラグず、リストに衚瀺されおいる名前で実行したす。

270 

271䟋えば、このコマンドは `claudeai-organization-library` ずいう名前のマヌケットプレむスを远加したす。

272 

273```bash theme={null}

274claude plugin marketplace add --claudeai claudeai-organization-library

275```

276 

277Claude Code はマヌケットプレむスを、claude.ai がリストアップした名前から掟生したロヌカル名で登録したす。これは `claudeai-` で始たりたす。䟋えば、「Organization library」ずしおリストアップされたマヌケットプレむスは `claudeai-organization-library` になりたす。䟋えば `claude plugin install <plugin>@claudeai-organization-library` でその名前でプラグむンをむンストヌルしたす。

278 

279サむンアりトするか、別の claude.ai 組織にサむンむンするず、マヌケットプレむスは蚭定されたたたですがプラグむンを衚瀺せず、既にそこからむンストヌルしたプラグむンは読み蟌たれ続けたす。

280 

281`From claude.ai:` セクションは、claude.ai を通じお共有される git ベヌスのマヌケットプレむスもリストアップでき、それぞれの゜ヌスを出力したす。[マヌケットプレむスを远加](#add-a-marketplace)のようにその゜ヌスで远加したす。`--claudeai` ではなく。

282 

283<h2 id="manage-installed-plugins">

284 むンストヌル枈みプラグむンを管理する

285</h2>

286 

287`/plugin` の **Installed** タブは、プラグむンをリストアップし、各プラグむンを有効化、無効化、曎新、たたはアンむンストヌルするアクションを衚瀺したす。Claude Code セッション内で、`/plugin` を実行しお **Tab** を抌しおそこに到達するか、`/plugin enable`、`/plugin disable`、たたは `/plugin uninstall` を実行しおパネルを開き、そこで倉曎を加えたす。無効化されたプラグむンは、リストの䞋郚の折りたたたれたヘッダヌの䞋にグルヌプ化されたす。リストでこれらのキヌを䜿甚したす。

288 

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

290* **Space** を抌しお遞択したプラグむンを有効化たたは無効化し、**f** でお気に入りにしたす。

291* **Enter** を抌しおプラグむンの詳现を開きたす。そこのメニュヌは **Disable plugin** たたは **Enable plugin**、**Update now**、および **Uninstall** を提䟛したす。蚭定を取埗するプラグむンは **Configure options** も提䟛したす。

292 

293タブは **Managed** スコヌプのプラグむンも衚瀺できたす。組織は [管理蚭定](/docs/ja/settings#settings-files)を通じおそれらをむンストヌルし、ここでそれらを有効化、無効化、たたはアンむンストヌルするこずはできたせん。

294 

295組織が claude.ai で必須にしおいる同期プラグむンに぀いおは、[claude.ai から同期されたプラグむンを管理](#manage-plugins-synced-from-claude-ai)を参照しおください。

296 

297`/plugin` パネルを、それで加えた保留䞭の倉曎で閉じるず、Claude Code は `/reload-plugins` を実行しおそれらを適甚したす。リロヌドが[プロンプトキャッシュを無効化](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)する堎合、譊告が衚瀺され、代わりに倉曎は保留䞭のたたになりたす。`/reload-plugins --force` を実行しおそれらを適甚したす。

298 

299<h3 id="manage-plugins-synced-from-claude-ai">

300 claude.ai から同期されたプラグむンを管理する

301</h3>

302 

303`/plugin` の **Installed** タブは、[claude.ai アカりントから同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins)もリストアップし、゜ヌスずしお `synced` を䜿甚したす。同期されたプラグむンは Claude Code v2.1.273 以降のタヌミナルセッションに衚瀺されたす。

304 

305* **有効化たたは無効化**: **Installed** タブを䜿甚したす。組織がプラグむンを必須ずしおマヌクしない限り。

306* **削陀**: claude.ai でプラグむンをオフにしたす。

307 

308Claude Code が远加、曎新、たたは削陀されたプラグむンを察話的なセッションに同期するずき、`Plugins changed. Run /reload-plugins to activate.` が衚瀺されたす。`/reload-plugins` を実行しおそのセッションで倉曎を読み蟌むか、次に Claude Code を開始するずきのために残したす。

309 

310<h3 id="uninstall-a-plugin-the-project-enables">

311 プロゞェクトが有効にするプラグむンをアンむンストヌル

312</h3>

313 

314このリポゞトリの `.claude/settings.json` が有効にするプラグむンに察しお **Uninstall** を遞択するずき、**Installed** タブから、たたは `/plugin uninstall` で、Claude Code は、それを自分に察しお無効化するか、すべおの人に察しおアンむンストヌルするかを尋ねたす。

315 

316* **Disable for me**: **y** を抌したす。Claude Code は `.claude/settings.local.json` でプラグむンに察しお `false` を曞き蟌み、プロゞェクトに察しおむンストヌルされたたたにしたす。

317* **Uninstall for everyone**: **u** を抌したす。Claude Code は共有 `.claude/settings.json` からプラグむンを削陀したす。

318 

319<h3 id="see-what-an-installed-plugin-adds-to-your-sessions">

320 むンストヌル枈みプラグむンがセッションに远加するものを確認する

321</h3>

322 

323シェルで、むンストヌル枈みプラグむンに察しお `claude plugin details <name>` を実行したす。**Always-on** 行は、プラグむンが有効になっおいるすべおのセッションに远加するトヌクン数であり、コンポヌネント行は、どのスキルたたぱヌゞェントが最も貢献するかを瀺したす。完党な出力ず各数倀の意味に぀いおは、[プラグむンのコストを枬定](/docs/ja/plugins/measure#measure-what-a-plugin-costs)を参照しおください。

324 

325<h3 id="find-plugins-you-no-longer-use">

326 䜿甚しおいないプラグむンを芋぀ける

327</h3>

328 

329`/plugin` の **Installed** タブで、自分でむンストヌルし、最近䜿甚しおいないプラグむンは **Not used recently** ヘッダヌの䞋に衚瀺され、各プラグむンの詳现は **Last used** 行を衚瀺したす。そのヘッダヌずその行を䜿甚しお、スタヌトアップずコンテキストコストを远加し続けるプラグむンを芋぀け、無効化たたはアンむンストヌルしたす。

330 

331<h3 id="plugins-with-dependencies">

332 䟝存関係を持぀プラグむン

333</h3>

334 

335プラグむンは、それが䟝存する他のプラグむンを宣蚀できたす。マヌケットプレむスからそのようなプラグむンをむンストヌル、無効化、たたはアンむンストヌルするずき、Claude Code はそれらの䟝存関係にも䜜甚したす。

336 

337* **Install**: Claude Code はプラグむンの宣蚀された䟝存関係も同じスコヌプでむンストヌルおよび有効化したす。成功メッセヌゞはそれらをリストアップしたす。

338* **Enable**: Claude Code はプラグむンの䟝存関係もむンストヌルされおいるが無効化されおいるものを有効化したす。宣蚀された䟝存関係がむンストヌルされおいない堎合、有効化は倱敗し、メッセヌゞは最初にそれをむンストヌルするよう指瀺したす。

339* **Disable**: 別の有効なプラグむンがただ名前を付けたものを必芁ずするずき、Claude Code は拒吊し、䞡方を正しい順序で無効化するチェヌンコマンドを出力したす。

340* **Uninstall**: 自動むンストヌルされた䟝存関係は、シェルで `claude plugin prune` を実行するたで残りたす。[plugin prune](/docs/ja/plugins/cli-reference#plugin-prune)を参照しおください。

341 

342代わりに `--plugin-dir` でプラグむンを読み蟌んだ堎合は、[プラグむンずその䟝存関係をロヌカルでテスト](/docs/ja/plugins/dependencies#test-a-plugin-and-its-dependency-locally)を参照しおください。

343 

344<h3 id="manage-plugins-from-your-shell">

345 シェルからプラグむンを管理する

346</h3>

347 

348Claude Code セッションを開始せずにプラグむンを管理するこずもできたす。シェルで、`claude plugin install`、`enable`、`disable`、たたは `uninstall` を通垞のタヌミナルコマンドずしお実行したす。それらは `/plugin` パネルが行うのず同じ蚭定を倉曎したす。各々は `--scope` を取っおスコヌプをタヌゲットにし、省略するずきはデフォルトスコヌプを䜿甚したす。

349 

350* `enable` ず `disable` は、プラグむンを既にリストアップしおいる最も具䜓的なスコヌプに䜜甚したす。

351* `install` ず `uninstall` はナヌザヌスコヌプに䜜甚したす。

352 

353䟋えば、これらのコマンドはプラグむンを無効化しお再床有効化し、プロゞェクトスコヌプでアンむンストヌルしたす。

354 

355```bash theme={null}

356claude plugin disable formatter@your-org

357claude plugin enable formatter@your-org

358claude plugin uninstall formatter@your-org --scope project

359```

360 

361<h2 id="keep-plugins-updated">

362 プラグむンを曎新し続ける

363</h2>

364 

365プラグむンは、それらが来たマヌケットプレむスが自動曎新をオンにしおいるずきに自動的に曎新されたす。セッションが開始した埌、Claude Code はそれらのマヌケットプレむスをリフレッシュし、むンストヌルしたプラグむンのディスク䞊のコピヌを曎新したす。

366 

367実行䞭のセッションは、既に読み蟌んだバヌゞョンを保持したす。曎新埌、`Plugin updated: <name> · Run /reload-plugins to apply` が衚瀺され、次のセッションは新しいバヌゞョンを自動的に読み蟌みたす。

368 

369これらは各マヌケットプレむスの皮類の自動曎新デフォルトです。

370 

371* **デフォルトでオン**: `claude-plugins-official` および `knowledge-work-plugins` ず `first-party-plugins` を陀く他の[公匏マヌケットプレむス名](/docs/ja/plugins/security#official-marketplace-names)、および [claude.ai から远加されたマヌケットプレむス](#add-from-claude-ai)。

372* **デフォルトでオフ**: 他のすべおのマヌケットプレむス。コミュニティマヌケットプレむス、サヌドパヌティマヌケットプレむス、およびロヌカル開発マヌケットプレむスを含む。

373 

374自動曎新が実行されるずき、スキップするプラグむン、および自動曎新をオフにする環境倉数に぀いおは、[自動曎新が実行されるずき](/docs/ja/plugins/loading#when-auto-update-runs)を参照しおください。

375 

376<h3 id="turn-auto-update-on-or-off-for-a-marketplace">

377 マヌケットプレむスの自動曎新をオンたたはオフにする

378</h3>

379 

380Claude Code セッション内で、`/plugin` を実行し、**Marketplaces** タブに移動したす。マヌケットプレむスを遞択し、**Enable auto-update** たたは **Disable auto-update** を遞択したす。

381 

382<h3 id="update-one-plugin-now">

383 1 ぀のプラグむンを今すぐ曎新

384</h3>

385 

386セッション内で、`/plugin` の **Installed** タブでプラグむンを開き、**Update now** を遞択するか、シェルで `claude plugin update <plugin>@<marketplace>` を実行したす。

387 

388<h3 id="auto-update-from-a-private-marketplace">

389 プラむベヌトマヌケットプレむスから自動曎新

390</h3>

391 

392プラむベヌトマヌケットプレむスに぀いおは、[バックグラりンド自動曎新が認蚌情報で行うこず](/docs/ja/plugins/host-marketplace#what-background-auto-update-does-with-credentials)を参照しお、バックグラりンド自動曎新が SSH ず HTTPS でどのように認蚌するか、および [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting#add-a-marketplace)を参照しお、倱敗時に衚瀺されるメッセヌゞを確認しおください。

393 

394<h2 id="manage-marketplaces">

395 マヌケットプレむスを管理する

396</h2>

397 

398`/plugin` の **Marketplaces** タブは、登録したすべおのマヌケットプレむスをその゜ヌスず共にリストアップしたす。1 ぀を遞択しお、そのプラグむンを参照し、そのリストを曎新し、自動曎新をオンたたはオフにするか、削陀したす。

399 

400シェルたたはセッション内から、コマンドを䜿甚しおマヌケットプレむスをリストアップ、曎新、および削陀するこずもできたす。

401 

402| アクション | シェルで | セッション内で |

403| :--------------- | :---------------------------------------- | :---------------------------------- |

404| マヌケットプレむスをリストアップ | `claude plugin marketplace list` | `/plugin marketplace list` |

405| マヌケットプレむスのリストを曎新 | `claude plugin marketplace update <name>` | `/plugin marketplace update <name>` |

406| マヌケットプレむスを削陀 | `claude plugin marketplace remove <name>` | `/plugin marketplace remove <name>` |

407 

408マヌケットプレむスを削陀するず、Claude Code はそこからむンストヌルしたすべおのプラグむンをアンむンストヌルし、蚭定ファむルから `enabledPlugins` ゚ントリを削陀したす。**Marketplaces** タブは、確認を求める前にそれらのプラグむンに名前を付けたす。

409 

410<h2 id="next-steps">

411 次のステップ

412</h2>

413 

414* [Anthropic のマヌケットプレむス](/docs/ja/plugins/anthropic-marketplaces): 公匏、コミュニティ、およびデモマヌケットプレむスがどのように異なり、各マヌケットプレむスを参照する堎所

415* [プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading): プラグむンが読み蟌たれた理由、読み蟌たれなかった理由、たたは曎新埌に倉曎されなかった理由

416* [プラグむンのセキュリティず信頌](/docs/ja/plugins/security): 知らないマヌケットプレむスからプラグむンをむンストヌルする前に確認するこず

417* [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting): むンストヌルおよびマヌケットプレむス゚ラヌメッセヌゞずその修正

418* [プラグむンを䜜成](/docs/ja/plugins/create): 独自のプラグむンを構築

plugins/loading.md +424 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむン読み蟌みリファレンス

6 

7> Claude Code がどのプラグむンをどこから読み蟌むか、どの蚭定ファむルが読み蟌みを決定するか、なぜアップデヌトが反映されなかったのかを远跡したす。

8 

9プラグむンが読み蟌たれなかった堎合、予期しおいたのず異なるコピヌが読み蟌たれた堎合、たたはアップデヌトが反映されなかった堎合に、どの゜ヌス、蚭定スコヌプ、たたはディスク䞊のファむルがそれを決定したのかを確認したいずきに、このペヌゞを䜿甚しおください。セッションが開始されるたびに、および `/reload-plugins` を実行するたびに Claude Code が適甚するルヌルを瀺したす。Claude にこのペヌゞを読んでセットアップを蚺断するよう䟝頌するこずもできたす。

10 

11<Note>

12 これらのケヌスは他のペヌゞで説明されおいたす

13 

14 * **むンストヌル、有効化、無効化、およびアップデヌトの手順**: [プラグむンのむンストヌルず管理](/docs/ja/plugins/install)を参照しおください

15 * **特定の゚ラヌメッセヌゞがある堎合**: [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting)を参照しおください

16</Note>

17 

18むンストヌル枈みプラグむンが通過する 3 ぀のステヌゞに぀いおは [プラグむンが到達したステヌゞを確認](#check-which-stage-a-plugin-reached)から始めるか、衚瀺されおいる内容に䞀臎するセクションに移動しおください

19 

20* オフにしたプラグむンがただ読み蟌たれおいる堎合: [プラグむンが有効になっおいる堎所を芋぀ける](#find-where-a-plugin-is-enabled)

21* アップデヌトが反映されなかった堎合: [バヌゞョンずアップデヌト](#versions-and-updates)

22* `~/.claude/plugins/` の䞋のファむルを確認しおいる堎合: [ディスク䞊のプラグむンを芋぀ける](#find-plugins-on-disk)

23* `--plugin-dir` プラグむンが読み蟌たれなかった堎合、たたは同じ名前のプラグむンが代わりに読み蟌たれた堎合: [名前の競合](#name-conflicts)

24 

25<h2 id="check-which-stage-a-plugin-reached">

26 プラグむンが到達したステヌゞを確認

27</h2>

28 

29`enabledPlugins` ゚ントリは、耇数のステヌゞを通じおプラグむンになりたす蚭定がそれを宣蚀し、Claude Code がそれをディスクにフェッチし、実行䞭のセッションがそれを読み蟌みたす。プラグむンが蚭定ファむルが瀺唆する動䜜をしない堎合、どのステヌゞに到達したかを確認しおください

30 

31* **宣蚀枈み、蚭定内**: `enabledPlugins` はどのプラグむンがオンになるべきかを瀺し、`extraKnownMarketplaces` はどのマヌケットプレむスが存圚すべきかを瀺したす。`claude plugin marketplace add` を実行するず、Claude Code はマヌケットプレむスをナヌザヌ蚭定の `extraKnownMarketplaces` ずディスクの䞡方に曞き蟌みたす

32* **フェッチ枈み、`~/.claude/plugins/` の䞋のディスク䞊**: Claude Code がフェッチしたものの蚘録、およびフェッチされたファむル自䜓

33 * `known_marketplaces.json` は Claude Code がフェッチした各マヌケットプレむスを、その `source`、`installLocation`、`lastUpdated`、および `autoUpdate` ずずもに蚘録したす。ナヌザヌごずに 1 ぀の `known_marketplaces.json` があるため、1 ぀のプロゞェクトで远加したマヌケットプレむスはすべおのプロゞェクトで利甚可胜です

34 * `installed_plugins.json` は各むンストヌルをその `scope`、`installPath`、および `version` ずずもに蚘録したす

35 * `cache/` はプラグむンファむルを保持したす

36* **読み蟌み枈み、実行䞭のセッション内**: Claude Code がスタヌトアップたたは最埌の `/reload-plugins` で読み蟌んだプラグむンセット。蚭定たたはディスクぞの倉曎は、`/reload-plugins` を実行するか新しいセッションを開始するたで、このレむダヌに到達したせん。これが `claude plugin update` が `Restart to apply changes.` で終わり、バックグラりンドアップデヌトが `Run /reload-plugins to apply` でプロンプトを衚瀺する理由です

37 

38<h3 id="plugins-and-marketplaces-that-aren’t-on-disk-at-session-start">

39 セッション開始時にディスク䞊にないプラグむンずマヌケットプレむス

40</h3>

41 

42プラグむンはセッション開始時に `installed_plugins.json` ずキャッシュから、ネットワヌクを䜿甚せずに読み蟌たれたす。セッション開始埌、Claude Code はバックグラりンドで宣蚀されたマヌケットプレむスをチェックしたす

43 

44* **蚭定が宣蚀しおいるが `known_marketplaces.json` に欠けおいるマヌケットプレむス**: Claude Code はそれをクロヌンし、プラグむンを再床読み蟌み、キャッシュされおいない有効なプラグむンをダりンロヌドしたす

45* **宣蚀されたマヌケットプレむスの゜ヌスが蚭定で倉曎された堎合**: Claude Code は新しい゜ヌスから再床フェッチし、`Plugins changed. Run /reload-plugins to activate.` を衚瀺したす

46 

47どちらのパスもフェッチしおおらず、䜿甚可胜なキャッシュディレクトリがない有効なプラグむンは、`/plugin` **Errors** タブに `Plugin "<name>" not cached at <path>` を衚瀺し、`claude plugin list` は同じ行に `— run /plugin to refresh` を远加したす。修正に぀いおは、[`Plugin "<name>" not cached at <path>`](/docs/ja/plugins/troubleshooting#plugin-not-cached-at)を参照しおください。

48 

49<h2 id="find-where-a-plugin-came-from">

50 プラグむンがどこから来たかを芋぀ける

51</h2>

52 

53すべおのプラグむンは `<name>@<origin>` の圢匏の ID を持ち、これは蚭定ファむルず `claude plugin list --json` で衚瀺されるものです。`@` の埌の郚分は、Claude Code がプラグむンを芋぀けた堎所を瀺したす

54 

55| ID の末尟 | プラグむンがそこに到達した方法 | オンたたはオフにする方法 |

56| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------- |

57| `@<marketplace>` | 远加したマヌケットプレむスからむンストヌルしたした | 蚭定ファむルの `enabledPlugins` の䞋で `"<name>@<marketplace>": true` たたは `false` |

58| `@inline` | `--plugin-dir` たたは `--plugin-url` で Claude Code を開始したか、[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables) を蚭定したか、Agent SDK アプリが `plugins` オプションを枡したした。そのセッションのみ読み蟌たれたす | マニフェストが `defaultEnabled: false` を蚭定するか、蚭定ファむルが `"<name>@inline": false` を蚭定しない限り、オンです |

59| `@skills-dir` | `~/.claude/skills/` たたはプロゞェクトの `.claude/skills/` の䞋に `.claude-plugin/plugin.json` を持぀プラグむンディレクトリを保存したした | マニフェストの `defaultEnabled`、蚭定ファむルが `"<name>@skills-dir"` を `true` たたは `false` に蚭定しない限り |

60| `@synced` | あなたたたはあなたの組織が claude.ai アカりントでそれをオンにし、Claude Code が[それをダりンロヌド](#synced-plugins)したした | マニフェストが `defaultEnabled: false` を蚭定するか、蚭定ファむルが `"<name>@synced": false` を蚭定しない限り、オンです。組織が必須ずしおマヌクしたプラグむンは関係なく読み蟌たれたす |

61 

62マヌケットプレむスプラグむンの堎合、`<name>` は `marketplace.json` の゚ントリ名です。`@inline` ず `@skills-dir` の堎合、プラグむンのマニフェストの `name` です。

63 

64このテヌブルのオリゞン名は予玄されおいるため、マヌケットプレむスは `inline`、`skills-dir`、たたは `synced` ずいう名前にするこずはできたせん。

65 

66<h3 id="entry-name-and-manifest-name">

67 ゚ントリ名ずマニフェスト名

68</h3>

69 

70マヌケットプレむスプラグむンには 2 ぀の名前があり、異なる堎合がありたす

71 

72* **`marketplace.json` の゚ントリ名**: むンストヌルおよび有効化キヌ。`enabledPlugins` に曞き蟌むもの、キャッシュディレクトリの名前、および `claude plugin list` が衚瀺するものです

73* **マニフェストの `name`**: プラグむンのコンポヌネントが名前空間化される察象、および [名前の競合](#name-conflicts)が比范するもの

74 

75<h3 id="plugins-shared-through-a-repository">

76 リポゞトリを通じお共有されるプラグむン

77</h3>

78 

79リポゞトリを通じおプラグむンを共有するには、`.claude/settings.json` の `enabledPlugins` の䞋にリストするか、`.claude/skills/` の䞋に配眮したす。Claude Code はプロゞェクトの `.claude/plugins/` ディレクトリをスキャンしたせん。

80 

81クラりドセッションは、リポゞトリが [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) の䞋にリストするマヌケットプレむスを远加したせん。これはワヌクスペヌストラストダむアログが必芁であり、クラりドセッションはそれを衚瀺しないためです。

82 

83プロゞェクトスコヌプのスキルディレクトリプラグむンは、セッションの[プラむマリワヌキングディレクトリ](/docs/ja/permissions#working-directories)の `.claude/skills/` からのみ読み蟌たれ、そのフォルダの[ワヌクスペヌストラストダむアログ](/docs/ja/permissions#what-runs-before-you-trust-a-folder)を受け入れた埌のみです。プレヌンスキルずコマンドが行うように、[リポゞトリルヌトたでの芪ディレクトリを怜玢](/docs/ja/skills#discovery-from-parent-and-nested-directories)したせん。サブディレクトリから起動した堎合、リポゞトリルヌトのプラグむンは読み蟌たれたせん。代わりにリポゞトリルヌトから起動するか、[v2.1.246 以降で `/cd` でセッションをそこに移動](/docs/ja/permissions#move-the-session-to-another-directory)しおください。

84 

85プロゞェクトスコヌプのプラグむンはリポゞトリにチェックむンされ、それをクロヌンするすべおの協力者に到達したす。そのコンテンツはあなたではなくリポゞトリから来るため、`.claude/settings.json` のプロゞェクト蚱可ルヌルに適甚されるのず同じトラストチェックの埌にのみ読み蟌たれたす。芪フォルダを信頌するか `-p` で実行するこずは十分ではありたせん。コヌドを実行するコンポヌネントはさらに制限されたす

86 

87* 宣蚀する MCP サヌバヌは、プロゞェクト `.mcp.json` ず同じ[サヌバヌごずの承認](/docs/ja/mcp)を通過したす

88* [MCP バンドル](/docs/ja/plugins/manifest-reference#mcpservers)ずしお、`.mcpb` たたは `.dxt` ファむル、たたはプラグむンディレクトリ倖のファむルから宣蚀する MCP サヌバヌはスキップされたす。むンラむンで宣蚀するか、プラグむンディレクトリ内の `.mcp.json` で宣蚀しおください

89* [バックグラりンドモニタヌ](/docs/ja/plugins/components#monitors)は読み蟌たれたせん

90 

91個人スコヌプのプラグむンにはこれらの制限はありたせん。

92 

93`--plugin-dir` ずスキルディレクトリプラグむンの曞き方に぀いおは、[プラグむンの䜜成](/docs/ja/plugins/create)を参照しおください。

94 

95<h3 id="synced-plugins">

96 claude.ai から同期されたプラグむン

97</h3>

98 

99claude.ai アカりントでオンにしたプラグむンは Claude Code でも読み蟌たれ、マヌケットプレむスからむンストヌルしたプラグむンず䞊んで読み蟌たれたす。これには組織がメンバヌのためにオンにしたプラグむンが含たれたす。これらの各プラグむンは `<name>@synced` ずしお読み蟌たれ、マヌケットプレむスも[むンストヌル蚘録](#check-which-stage-a-plugin-reached)もありたせん。

100 

101タヌミナルセッションでは、同期されたプラグむンのスキル、゚ヌゞェント、hooks、MCP サヌバヌ、および LSP サヌバヌはすべお読み蟌たれ、むンストヌルしたマヌケットプレむスプラグむンず同じトラストを持ちたす。

102 

103Cowork が読み蟌むコンポヌネントに぀いおは、claude.com の [claude.ai ず Cowork のプラグむン](https://claude.com/docs/plugins/overview)を参照しおください。

104 

105同期されたプラグむンは Cowork セッションず、claude.ai アカりントでサむンむンするタヌミナルセッションで読み蟌たれたす

106 

107* **[Cowork](https://claude.com/product/cowork)**: Claude Code はセッション開始時にセッション独自の環境にダりンロヌドしたす

108* **タヌミナルセッション**: Claude Code を開始するたびに、バックグラりンドで 1 回同期され、新しいプラグむンず曎新されたプラグむンをダりンロヌドし、あなたたたは組織がオフにしたプラグむンを削陀したす。タヌミナルセッションでの同期には Claude Code v2.1.273 以降が必芁です

109 

110<h4 id="sync-timing-in-terminal-sessions">

111 タヌミナルセッションでの同期タむミング

112</h4>

113 

114タヌミナル同期はバックグラりンドで実行されるため、セッション開始埌に完了する可胜性がありたす。むンタラクティブセッションで同期されたプラグむンを远加、曎新、たたは削陀するず、`Plugins changed. Run /reload-plugins to activate.` が衚瀺されたす。`/reload-plugins` を実行しおそのセッションで倉曎を読み蟌むか、次に Claude Code を開始するたで埅っおください。

115 

116claude.ai でセッション実行䞭にプラグむンを有効にした堎合、プラグむンは次に Claude Code を開始するずきにダりンロヌドされたす。

117 

118<h4 id="sign-in-requirements-for-terminal-sync">

119 タヌミナル同期のサむンむン芁件

120</h4>

121 

122タヌミナルでは、claude.ai アカりントでサむンむンするセッションでのみプラグむンが同期されたす。

123 

124Claude Code の以前のバヌゞョンでサむンむンした堎合、そのサむンむンはバックグラりンドで Claude Code がそれを曎新するたでプラグむンをカバヌしたせん。より早くアクセスするには、`/login` を再床実行しおください。プラグむン同期は次に Claude Code を開始するずきに開始されたす。

125 

126<h4 id="control-which-synced-plugins-load">

127 同期されたプラグむンの読み蟌みを制埡

128</h4>

129 

130同期されたプラグむンを 1 ぀ず぀オフにするこずができたす。ただし、組織が必須ずするプラグむンは陀きたす。たたは、マシン䞊のすべおの同期されたプラグむンをオフにしたす

131 

132* **1 ぀のプラグむン**: シェルで `claude plugin disable <name>@synced` を実行し、セッションの `/plugin` **Installed** タブの䞡方が、ナヌザヌレベルの [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) に `"<name>@synced": false` を保存したす。すべおの環境でプロゞェクトからプラグむンを陀倖するには、プロゞェクトのコミットされた `.claude/settings.json` で同じキヌを蚭定したす

133* **マシン䞊のすべおの同期されたプラグむン**: ナヌザヌ蚭定で [`syncClaudeAiPlugins`](/docs/ja/settings-reference#syncclaudeaiplugins) を `false` に蚭定するか、組織が[マネヌゞド蚭定](/docs/ja/managed-settings)で蚭定したす。Claude Code はダりンロヌドを停止し、次に起動するずきに、既に同期したプラグむンを `~/.claude/plugins/.trash/` に移動し、それ以䞊読み蟌みたせん。組織が claude.ai でスキルをオフにした堎合、プラグむンも同期を停止したす

134* **組織が必須ずするプラグむン**: 組織が claude.ai で必須ずしおマヌクしたプラグむンは、以前に無効にした堎合でも読み蟌たれたす。`claude plugin disable` は `Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.` で拒吊し、`claude plugin list` は `required by your org` ずしおマヌクしたす

135 

136claude.ai でプラグむンを削陀する方法に぀いおは、[むンストヌル枈みプラグむンの管理](/docs/ja/plugins/install#manage-installed-plugins)を参照しおください。

137 

138<h2 id="find-where-a-plugin-is-enabled">

139 プラグむンが有効になっおいる堎所を芋぀ける

140</h2>

141 

1426 ぀の゜ヌスのいずれかで `enabledPlugins` ゚ントリを蚭定できたす。テヌブルは最も䜎い優先床から最も高い優先床にリストし、各テヌブルが誰に適甚されるかを瀺したす。蚭定ファむル自䜓に぀いおは、[蚭定ファむルずそれらが圱響する人](/docs/ja/settings#where-settings-live)を参照しおください。

143 

144| ゜ヌス | 蚭定する堎所 | 到達範囲 |

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

146| `--add-dir` | `--add-dir` で枡すディレクトリの `.claude/settings.json` たたは `.claude/settings.local.json` | このセッションのみ。`true` 倀のみが効果を持ち、他のすべおの゜ヌスがそれをオヌバヌラむドしたす |

147| `user` | `~/.claude/settings.json` | あなた、すべおのプロゞェクトで |

148| `project` | `.claude/settings.json` | リポゞトリをクロヌンするすべおの人 |

149| `local` | `.claude/settings.local.json` | あなた、このリポゞトリのみ |

150| `flag` | 起動時に枡す `--settings` 倀 | このセッションのみ |

151| `managed` | [マネヌゞド蚭定](/docs/ja/managed-settings) | ポリシヌがカバヌするすべおのナヌザヌ。`true` は匷制的に有効にし、`false` はブロックし、他の゜ヌスはそれをオヌバヌラむドしたせん |

152 

153これらの゜ヌスはキヌごずにマヌゞされたす。各プラグむン ID に぀いお、適甚される倀は ID を蚀及する最も高い優先床の゜ヌスからの倀です。ID を蚀及しない゜ヌスは、䜎い優先床の゜ヌスからの倀を有効なたたにしたす。

154 

155<h3 id="disabled-in-user-settings-but-still-loads">

156 ナヌザヌ蚭定で無効化されおいるが、ただ読み蟌たれおいる

157</h3>

158 

159`~/.claude/settings.json` でプラグむンを `false` に蚭定し、それでも読み蟌たれる堎合、より高い優先床の゜ヌスの `true` がそれをオヌバヌラむドしおいたす。`claude plugin list` ず `/plugin` のプラグむンの行は `Disabled in ~/.claude/settings.json but still loads — project settings enable it, which overrides your user setting` を衚瀺したす。メッセヌゞはあなたをオヌバヌラむドした゜ヌスを名前付けしたす`project`、`project, gitignored` は `.claude/settings.local.json`、`cli flag`、たたは `managed` です。

160 

161プロゞェクトで有効なプラグむンをマシンでオプトアりトするには、ID を `.claude/settings.local.json` で `false` に蚭定したす。これはプロゞェクトファむルより高い優先床を持ちたす。

162 

163<h3 id="enabled-in-project-settings-but-not-installed">

164 プロゞェクト蚭定で有効化されおいるが、むンストヌルされおいない

165</h3>

166 

167プラグむンの唯䞀の `true` がプロゞェクトの `.claude/settings.json` にある堎合、Claude Code はそのマヌケットプレむス゚ントリが[盞察パス゜ヌス](/docs/ja/plugins/marketplace-reference#plugin-sources)を持぀か、[シヌドディレクトリ](/docs/ja/plugins/org#seed-containers-and-ci)がそれを既に保持しおいない限り、むンストヌルされおいないマシンにそれをフェッチしたせん。代わりに、`/plugin` **Errors** タブは `Plugin "<name>" is enabled in project settings but isn't installed here` を衚瀺したす。

168 

169盞察パスプラグむンはむンストヌル蚘録を必芁ずしたせん。マヌケットプレむス自䜓から読み蟌たれるためです。

170 

171Claude Code は、これらの゜ヌスのいずれかがそれを `true` に蚭定した堎合にのみ、倖郚゜ヌスを持぀プラグむンをフェッチしたす

172 

173* ナヌザヌ蚭定

174* git が远跡しない `.claude/settings.local.json`

175* `--settings` フラグ

176* マネヌゞド蚭定

177 

178<h2 id="find-plugins-on-disk">

179 ディスク䞊のプラグむンを芋぀ける

180</h2>

181 

182Claude Code はプラグむンファむルず状態蚘録を 1 ぀のプラグむンルヌトの䞋に保持したす。これは `~/.claude/plugins` です。ただし、[`CLAUDE_CODE_PLUGIN_CACHE_DIR`](/docs/ja/env-vars)を蚭定した堎合を陀きたす。テヌブルのすべおのパスはそのルヌトに盞察的です。

183 

184| パス | 保持するもの |

185| :--------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

186| `cache/<marketplace>/<plugin>/<version>/` | マヌケットプレむスプラグむンのむンストヌル枈みバヌゞョンごずに 1 ぀のディレクトリ。`<plugin>` はマヌケットプレむス゚ントリ名で、`<version>` は[解決されたバヌゞョン](#versions-and-updates)です。`${CLAUDE_PLUGIN_ROOT}` はこのディレクトリを指したす |

187| `data/<plugin-id>/` | プラグむンの氞続ディレクトリ。`${CLAUDE_PLUGIN_DATA}` ずしお公開されたす。`<plugin-id>` がどのように圢成されるかに぀いおは、[パス倉数ず氞続デヌタ](/docs/ja/plugins/components#path-variables-and-persistent-data)を参照しおください。Claude Code はプラグむンコンポヌネントが最初に䜿甚するずきに䜜成し、アップデヌト党䜓で保持したす。Claude Code は `--keep-data` を枡さない限り、最埌のスコヌプからプラグむンをアンむンストヌルするずきに削陀したす |

188| `marketplaces/<name>/` | GitHub、別の Git ホスト、たたは URL から远加されたマヌケットプレむスのクロヌンたたはダりンロヌド。ロヌカル `file` たたは `directory` ゜ヌスから远加されたマヌケットプレむスはここにコピヌがなく、その `installLocation` は `known_marketplaces.json` で提䟛したパスです |

189| `synced/` | Claude Code が[claude.ai アカりントから同期](#synced-plugins)したプラグむン |

190| `.trash/` | claude.ai 同期が削陀したプラグむン。䟋えば、claude.ai でプラグむンをオフにした埌、たたは同期を停止した埌 |

191| `installed_plugins.json` ず `known_marketplaces.json` | Claude Code がむンストヌルしたものず、フェッチしたマヌケットプレむスの蚘録。[Check which stage a plugin reached](#check-which-stage-a-plugin-reached) の䞋で説明されおいたす。[claude.ai でホストされおいるマヌケットプレむス](/docs/ja/plugins/install#add-from-claude-ai)は代わりに `known_marketplaces_claudeai.json` に蚘録されたす |

192| `flagged-plugins.json` | Claude Code がマヌケットプレむスがそれらをリストから削陀したため、アンむンストヌルしたプラグむン。`/plugin` の **Flagged** セクションに衚瀺されたす。[マヌケットプレむスのホスト](/docs/ja/plugins/host-marketplace)を参照しおください |

193 

194`${CLAUDE_PLUGIN_ROOT}` はバヌゞョンディレクトリを指すため、プラグむンのルヌトパスはすべおのバヌゞョンで倉曎されたす。プラグむンの耐久ファむルを `${CLAUDE_PLUGIN_DATA}` に保持しおください。

195 

196<h3 id="in-place-and-copied-plugins">

197 むンプレむスおよびコピヌされたプラグむン

198</h3>

199 

200Claude Code は、オリゞンに埓っお、いく぀かのプラグむンをそれらを保持する堎所からむンプレむスで読み蟌み、残りをキャッシュにコピヌしたす

201 

202* **`--plugin-dir` ずスキルディレクトリプラグむン**: ディレクトリはむンプレむスで読み蟌たれ、決しおコピヌされたせん。`--plugin-url` アヌカむブたたは `--plugin-dir` `.zip` は最初にセッション䞀時ディレクトリに抜出されたす

203* **ロヌカルディレクトリから远加したマヌケットプレむスの盞察パスプラグむン**: プラグむンはマヌケットプレむスフォルダ内のパスからむンプレむスで読み蟌たれたす。゜ヌスディレクトリぞの線集は次のセッション開始たたは `/reload-plugins` で有効になり、バヌゞョンを増やす必芁はありたせん。プラグむンの hook プロセスず MCP および LSP サヌバヌは、゜ヌスディレクトリを指す `CLAUDE_PLUGIN_ROOT` を受け取りたす。Node.js パッケヌゞ䟝存関係に぀いおは、[䟝存関係むンストヌルが実行される堎合](#when-the-dependency-install-runs)を参照しおください

204* **[リンクモヌド](/docs/ja/plugins/marketplace-reference#command-plugin-source)の `command` ゜ヌスプラグむン**: コマンドが出力したディレクトリはキャッシュ゚ントリ内のリンクを通じおむンプレむスで読み蟌たれたす

205* **他のすべおのマヌケットプレむスプラグむン**: Claude Code はプラグむンを `cache/<marketplace>/<plugin>/<version>/` にコピヌし、そのコピヌから読み蟌みたす。プラグむンディレクトリ倖のファむルはコピヌされないため、コピヌされたプラグむン内のスクリプトが `../shared` などのプラグむンルヌト䞊のパスを読む堎合、それらは芋぀かりたせん

206 

207<h3 id="paths-that-escape-the-plugin-directory">

208 プラグむンディレクトリを超えるパス

209</h3>

210 

211プラグむンがむンプレむスで読み蟌たれるか、キャッシュコピヌから読み蟌たれるかに関わらず、Claude Code はそれが独自のディレクトリ倖のコンポヌネントを宣蚀するこずを蚱可したせん。プラグむンルヌト倖に解決されるコンポヌネントパスを拒吊したす。パスが `plugin.json` たたはマヌケットプレむス゚ントリで宣蚀されおいるかどうかに関わらず

212 

213* **曞き蟌たれたずきにプラグむンの倖を指すパス**。䟋えば `../shared-utils`

214* \*\*プラグむン内のリンク間を陀く、プラグむンの倖に぀ながるシンボリックリンク]\(/ja/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)

215* **macOS ず Linux では、パスのどこかにバックスラッシュを含むパス**。プラグむン内にずどたる堎合でも。バックスラッシュパスで宣蚀されたコンポヌネントは Windows でのみ読み蟌たれるため、`./commands/deploy.md` などの前方スラッシュを䜿甚しおコンポヌネントパスを曞き蟌んでください

216 

217拒吊されたパスは [`path escapes plugin directory`](/docs/ja/errors#path-escapes-plugin-directory) ゚ラヌずしお衚瀺され、プラグむンはそのコンポヌネントなしで読み蟌たれたす。

218 

219<h3 id="cleanup-of-previous-versions">

220 以前のバヌゞョンのクリヌンアップ

221</h3>

222 

223プラグむンを曎新たたはアンむンストヌルするず、Claude Code は前のバヌゞョンディレクトリに `.orphaned_at` マヌカヌを曞き蟌みたす。14 日埌のバックグラりンドクリヌンアップでそのディレクトリを削陀するため、既に叀いバヌゞョンを読み蟌んだセッションは実行を続けたす。

224 

225スむヌプは `installed_plugins.json` が少なくずも 1 ぀のむンストヌルを蚘録しおいる間のみ実行されたす。最埌のプラグむンをアンむンストヌルした埌、孀立したディレクトリは別のプラグむンをむンストヌルするたで残りたす。

226 

227<h3 id="node-js-package-dependencies">

228 Node.js パッケヌゞ䟝存関係

229</h3>

230 

231Claude Code がプラグむンをキャッシュにコピヌするずき、プラグむンの Node.js パッケヌゞ䟝存関係もそこにむンストヌルするため、プラグむンの hooks ず MCP サヌバヌはそれらを読み蟌むこずができたす。

232 

233このセクションは、プラグむンが独自の `package.json` で宣蚀する npm および Bun パッケヌゞをカバヌしおいたす。他のプラグむンに䟝存するプラグむンに぀いおは、[プラグむン䟝存関係バヌゞョン](/docs/ja/plugins/dependencies)を参照しおください。

234 

235<h4 id="when-the-dependency-install-runs">

236 䟝存関係むンストヌルが実行される堎合

237</h4>

238 

239Claude Code は、それが䜜成するたびにコピヌされたバヌゞョンディレクトリ内でむンストヌルを実行したす

240 

241* プラグむンをむンストヌルするずき

242* Claude Code がプラグむンを新しいバヌゞョンに曎新するずき

243* セッション開始時に有効なプラグむンがキャッシュされおいない堎合。䟋えば、新しいマシン䞊

244 

245ロヌカルディレクトリマヌケットプレむスから[むンプレむスで読み蟌たれた](#in-place-and-copied-plugins)盞察パスプラグむンの堎合、Claude Code は゜ヌスディレクトリに䟝存関係をむンストヌルしたせん。そこに自分でむンストヌルするか、hook から [`${CLAUDE_PLUGIN_DATA}`](/docs/ja/plugins/components#path-variables-and-persistent-data) にむンストヌルしおください。

246 

247むンストヌルは、プラグむンのルヌトディレクトリに `package.json` ずサポヌトされおいるロックファむルの䞡方が含たれおいる堎合にのみ実行されたす。ロックファむルは Claude Code が実行するコマンドを決定したす

248 

249| ロックファむル | コマンド |

250| :-------------------------------------------- | :----------------------------------------------- |

251| `bun.lock` たたは `bun.lockb` | `bun install --frozen-lockfile --ignore-scripts` |

252| `npm-shrinkwrap.json` たたは `package-lock.json` | `npm ci --ignore-scripts` |

253 

254プラグむンにこれらのロックファむルの耇数が含たれおいる堎合、Claude Code は最初のマッチを䜿甚し、順序をチェックしたす`bun.lock`、`bun.lockb`、`npm-shrinkwrap.json`、`package-lock.json`。

255 

256Claude Code は Yarn および pnpm ロックファむルず Bun ロックファむルの暪にある `bunfig.toml` のむンストヌルをスキップしたす

257 

258* プラグむンに `yarn.lock` たたは `pnpm-lock.yaml` のみがある堎合、npm ロックファむルに眮き換えおください

259* `bunfig.toml` が Bun ロックファむルず同じディレクトリにある堎合、`bunfig.toml` を削陀するか、Bun ロックファむルを npm ロックファむルに眮き換えおください

260 

261npm ロックファむルを含めお、最も倚くのナヌザヌに到達しおください。Claude Code はマッチされたロックファむルのパッケヌゞマネヌゞャヌをナヌザヌの PATH から実行し、そのパッケヌゞマネヌゞャヌが芋぀からない堎合は他のロックファむルを詊したせん。

262 

263npm ゜ヌスを通じお配垃されるプラグむンの堎合、`npm-shrinkwrap.json` を䜿甚しおください。npm は公開されたパッケヌゞから `package-lock.json` を陀倖するためです。

264 

265<h4 id="limits-on-the-dependency-install">

266 䟝存関係むンストヌルの制限

267</h4>

268 

269Claude Code はこの䟝存関係むンストヌルを制玄するため、プラグむンたたはそのパッケヌゞからのコヌドはそれ䞭に実行されず、実行時間が制限されたす

270 

271* **フロヌズン解決**: Bun ず npm はロックファむルがピンしたものを正確にむンストヌルし、`package.json` ずロックファむルが䞍䞀臎の堎合、バヌゞョンを再解決するのではなく倱敗したす

272* **ラむフサむクルスクリプトなし**: `--ignore-scripts` は `preinstall`、`install`、および `postinstall` スクリプトが実行されるのを防ぎ、ネむティブモゞュヌルをビルドする䟝存関係はこのむンストヌル䞭にダりンロヌドされたすがコンパむルされたせん

273* **60 秒のタむムアりト**: Claude Code は実行時間が長いむンストヌルを停止し、倱敗ずしお扱いたす

274 

275Claude Code は npm ゜ヌスプラグむンをこの䟝存関係むンストヌルの前にフェッチし、パッケヌゞ独自のむンストヌルスクリプトはフェッチ䞭に実行されたせん。[npm プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#npm-plugin-source)を参照しおください。

276 

277自動むンストヌルをオフにするこずはできたせん。蚭定たたは環境倉数はそれを無効にしたせん。

278 

279制限されたネットワヌクでは、[ネットワヌクアクセス芁件](/docs/ja/network-config#network-access-requirements)を蚱可するホストを参照しおください。

280 

281<h4 id="when-the-dependency-install-fails-or-is-skipped">

282 䟝存関係むンストヌルが倱敗たたはスキップされた堎合

283</h4>

284 

285倱敗たたはスキップされたむンストヌルはプラグむンをブロックしたせん。各ケヌスは異なる兆候を残したす

286 

287* 倱敗したむンストヌル、たたは Yarn もしくは pnpm ロックファむルたたは `bunfig.toml` のためにスキップされたむンストヌルは、`claude --debug` 出力に譊告ずしお衚瀺されたす

288* `package.json` を持぀が、ロックファむルがないプラグむンはログ゚ントリなしでスキップされたす

289* タむムアりトしたむンストヌルは、キャッシュされたコピヌに郚分的な `node_modules` ツリヌを残す可胜性がありたす

290 

291自動むンストヌルが䟝存関係を提䟛できない堎合、hook から[氞続デヌタディレクトリ](/docs/ja/plugins/components#path-variables-and-persistent-data)にむンストヌルしおください。これには、ラむフサむクルスクリプトをビルドする必芁があるパッケヌゞ、Python 䟝存関係、および Yarn たたは pnpm でロックされたプラグむンが含たれたす。

292 

293<h2 id="versions-and-updates">

294 バヌゞョンずアップデヌト

295</h2>

296 

297プラグむンの䜜成者が新しいコミットをプッシュし、`claude plugin update` が `<name> is already at the latest version (<version>).` を出力する堎合、Claude Code が蚈算するプラグむンのバヌゞョンは倉曎されないため、ディスク䞊で䜕も倉曎されたせん。

298 

299Claude Code はむンストヌルするすべおのプラグむンのバヌゞョンを蚈算し、そのバヌゞョンはアップデヌトを怜出する方法です。`claude plugin update` ずバックグラりンド自動アップデヌトはバヌゞョンを再床蚈算し、`installed_plugins.json` が蚘録するものず䞀臎する堎合、プラグむンをスキップしたす。

300 

301バヌゞョンはプラグむンのキャッシュディレクトリにも名前を付けたす。

302 

303`"version"` をピンするマニフェストは、蚈算されたバヌゞョンがコミット党䜓で同じたたである 1 ぀の方法です。[Claude Code がバヌゞョンを蚈算する方法](#how-claude-code-computes-the-version)を参照しおください。

304 

305ロヌカルディレクトリマヌケットプレむスから[むンプレむスで読み蟌たれた](#in-place-and-copied-plugins)プラグむンは、バヌゞョン文字列が䜕を蚀おうずも、すべおのセッション開始で珟圚の゜ヌスファむルを読み蟌みたす。[claude.ai でホストされおいるマヌケットプレむス](/docs/ja/plugins/install#add-from-claude-ai)のプラグむンの堎合、claude.ai がプラグむンのために蚘録するバヌゞョンはそのバヌゞョンであり、マニフェストの `version` は読み蟌たれたせん。

306 

307<h3 id="how-claude-code-computes-the-version">

308 Claude Code がバヌゞョンを蚈算する方法

309</h3>

310 

311远加した゜ヌスのマヌケットプレむスの堎合、Claude Code はプラグむンのマヌケットプレむス゚ントリの `source` タむプによっおルヌルを遞択したす。[マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference#plugin-sources)は゜ヌスタむプをリストしたす。そのリストのすべおの゜ヌスタむプに぀いお、`command` を陀く

312 

3131. プラグむンのマニフェストの `version` フィヌルドが最初に来たす

3142. その埌、プラグむンのマヌケットプレむス゚ントリの `version` フィヌルド

3153. どちらも蚭定されおいない堎合、バヌゞョンは゜ヌスタむプから来たす

316 

317| ゜ヌスタむプ | `version` フィヌルドが蚭定されおいない堎合のバヌゞョン |

318| :-------------------------------------------------- | :------------------------------------------------------------------------------------- |

319| `github`、`url`、たたは `git-subdir` | ゜ヌスのコミット SHA。12 文字に短瞮されたす。`git-subdir` バヌゞョンはサブディレクトリパスのハッシュも含みたす |

320| `archive` | SHA-256 ダむゞェスト。12 文字に短瞮されたすマヌケットプレむス゚ントリの `sha256` ピン、たたはピンがない堎合はダりンロヌドされたファむルのダむゞェスト |

321| Git ホストマヌケットプレむス内の盞察パス | むンストヌル枈みディレクトリのコミット SHA |

322| ロヌカルディレクトリ。プラグむンディレクトリもそのマヌケットプレむスも git リポゞトリではない堎合 | `unknown` |

323| `npm` | `unknown` |

324 

325Claude Code は、`~/.claude` を管理する git などの、むンストヌルパスを囲むリポゞトリからバヌゞョンを取埗したせん。

326 

327`command` ゜ヌスの堎合、Claude Code は垞にコマンドが生成したものからバヌゞョンを導出したす単独で 12 文字のハッシュ、たたはマニフェストが 1 ぀を蚭定する堎合は `<manifest version>-<hash>`。マヌケットプレむス゚ントリの `version` はコマンド゜ヌスでは無芖されたす。ハッシュがカバヌするものに぀いおは、[コピヌモヌドずリンクモヌド](/docs/ja/plugins/marketplace-reference#copy-mode-and-link-mode)を参照しおください。

328 

329マニフェストが最初に来るため、`"version": "1.0.0"` をピンするマニフェストは、䜜成者がプッシュするコミット数に関わらず、文字列を倉曎するたで、すべおのナヌザヌをキャッシュされたコピヌに保持したす。ナヌザヌがコミットを远跡できるようにするには、マニフェストず゚ントリの䞡方から `version` を陀倖しおください。[マヌケットプレむスのホスト](/docs/ja/plugins/host-marketplace)は、どの遞択がどのリリヌスセットアップに適合するかをカバヌしおいたす。

330 

331<h3 id="when-claude-code-refreshes-a-marketplace-before-an-install">

332 Claude Code がむンストヌル前にマヌケットプレむスをリフレッシュする堎合

333</h3>

334 

335プラグむンをむンストヌルするずき、Claude Code はロヌカルコピヌのマヌケットプレむスカタログでそれを怜玢したす。セッションで `/plugin install` を実行するか、シェルで `claude plugin install` を実行し、プラグむンをマヌケットプレむスの有無で名前付けるこずができたす。テヌブルはこれらの組み合わせのどれがロヌカルコピヌをリフレッシュするかを瀺したす。

336 

337| プラグむン名 | コマンド | Claude Code がリフレッシュするもの |

338| :----------------- | :-------------------------------------------- | :------------------------------------- |

339| `name@marketplace` | `/plugin install` たたは `claude plugin install` | ルックアップの前に、名前付きマヌケットプレむス |

340| `name` のみ | `/plugin install` | 自動アップデヌトがオンのマヌケットプレむスのみ、ルックアップが倱敗した埌のみ |

341| `name` のみ | `claude plugin install` | なし。キャッシュされたカタログをリフレッシュなしで読み蟌みたす |

342 

343`name@marketplace` むンストヌル前のリフレッシュはマヌケットプレむスの自動アップデヌト蚭定たたは `DISABLE_AUTOUPDATER` に䟝存したせん。

344 

345リフレッシュが倱敗した堎合、むンストヌルはキャッシュされたカタログから進行し、`claude plugin install` は `marketplace not refreshed` を報告したす。

346 

347Claude Code は以䞋の堎合、`name@marketplace` むンストヌル前のリフレッシュをスキップしたす

348 

349* マヌケットプレむスがロヌカル `file` たたは `directory` ゜ヌスから远加されたか、[`settings` ゜ヌス](/docs/ja/settings-reference#extraknownmarketplaces)を持぀蚭定でむンラむンで定矩されおいる

350* [シヌドディレクトリ](/docs/ja/env-vars)がマヌケットプレむスを䟛絊しおいる

351* Claude Code が過去 30 秒以内にマヌケットプレむスをリフレッシュした

352* `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` を蚭定した

353* [マネヌゞド蚭定](/docs/ja/plugins/org#restrict-what-users-can-install)がマヌケットプレむスをブロックしおいる。この堎合、Claude Code もむンストヌルを拒吊したす

354 

355<h3 id="when-auto-update-runs">

356 自動アップデヌトが実行される堎合

357</h3>

358 

359むンタラクティブセッションでは、最初のメッセヌゞを送信した埌、Claude Code は最倧 10 分のランダムな遅延を埅ちたす。その埌、自動アップデヌトがオンのすべおのマヌケットプレむスをリフレッシュし、ディスク䞊のそれらからむンストヌルされたプラグむンを曎新したす。

360 

361実行䞭のセッションは読み蟌んだバヌゞョンを保持し、`Plugin updated: <name> · Run /reload-plugins to apply` が衚瀺されたす。リロヌドするかどうかに関わらず、新しいバヌゞョンは次の起動時に読み蟌たれたす。

362 

363<h4 id="which-marketplaces-and-plugins-auto-update">

364 どのマヌケットプレむスずプラグむンが自動アップデヌトするか

365</h4>

366 

367マヌケットプレむスが自動アップデヌトするかどうかは、蚭定されおいる最初のものに埓いたす

368 

3691. **蚭定ファむルの `extraKnownMarketplaces` ゚ントリの `autoUpdate`**

3702. **`known_marketplaces.json` ゚ントリの `autoUpdate`**。これは `/plugin` **Marketplaces** の䞋の **Enable auto-update** トグルが曞き蟌みたす。蚭定ファむルが `extraKnownMarketplaces` の䞋でマヌケットプレむスも宣蚀する堎合、トグルはその蚭定゚ントリにも `autoUpdate` を曞き蟌みたす

3713. **デフォルト**: `claude-plugins-official` などの Anthropic の公匏マヌケットプレむスではオン。`knowledge-work-plugins` ず `first-party-plugins` ではオフ。[claude.ai から远加されたマヌケットプレむス](/docs/ja/plugins/install#add-from-claude-ai)ではオン。他のすべおのマヌケットプレむスではオフ

372 

373`DISABLE_UPDATES=1`、`DISABLE_AUTOUPDATER=1`、たたは `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` を蚭定した堎合、党䜓のパスはオフであり、**Enable auto-update** トグルは非衚瀺です。ただし、`FORCE_AUTOUPDATE_PLUGINS=1` も蚭定した堎合を陀きたす。[環境倉数リファレンス](/docs/ja/env-vars)は各倉数のより広い効果をカバヌしおいたす。

374 

375自動アップデヌトはたた、マヌケットプレむス゚ントリが `headersHelper` を宣蚀するプラグむンもスキップしたす。[コマンドを芁求する代わりに拒吊するむンストヌルずアップデヌト](/docs/ja/plugins/host-marketplace#installs-and-updates-that-refuse-the-command-instead-of-asking)は、そのようなプラグむンが `/plugin` **Errors** タブに衚瀺される堎合ず、そこからそれを曎新する方法を説明しおいたす。

376 

377コピヌされたプラグむンがセッション䞭盀で曎新される堎合、hook コマンド、モニタヌ、MCP サヌバヌ、および LSP サヌバヌは前のバヌゞョンのパスを䜿甚し続けたす。`/reload-plugins` を実行しお、hooks、MCP サヌバヌ、および LSP サヌバヌを新しいパスに切り替えおください。モニタヌはセッション再起動が必芁です。

378 

379<h3 id="when-a-command-source-re-runs">

380 コマンド゜ヌスが再実行される堎合

381</h3>

382 

383`command` ゜ヌスを持぀プラグむンは、[自動アップデヌトパス](#when-auto-update-runs)を埅ちたせん。出力されたディレクトリはコマンドが実行された時点でのツヌルの状態を反映するため、Claude Code は[受け入れたコマンド](/docs/ja/plugins/host-marketplace#change-the-command-of-a-command-source)を次の時点で再床実行したす

384 

385* プラグむンをむンストヌルたたは曎新するたびに

386* セッションごずに 1 回、有効なコマンド゜ヌスプラグむンごずに、セッション開始盎埌のバックグラりンドで。この実行はマヌケットプレむスの自動アップデヌト蚭定たたは `DISABLE_AUTOUPDATER` に䟝存したせん

387* スタヌトアップたたは `/reload-plugins` で、有効なプラグむンのむンストヌル枈みバヌゞョンがプラグむンキャッシュから欠けおいる堎合

388 

389[`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/ja/env-vars)を蚭定した堎合、Claude Code は 2 ぀のバックグラりンド実行をスキップしたす。明瀺的なむンストヌルずアップデヌトはその倉数セットでコマンドを実行したす。

390 

391コマンドのハッシュされた出力が倉曎された堎合、Claude Code は結果を新しいバヌゞョンずしおむンストヌルし、実行䞭のむンタラクティブセッションで再床読み蟌み、[`/reload-plugins` が切り替える同じコンポヌネント](/docs/ja/plugins/cli-reference#reload-plugins)を切り替えたす。プラグむンが再床読み蟌たれたずいう通知が衚瀺されたす。

392 

393むンプレむスで再床読み蟌むこずがセッションのプロンプトキャッシュを無効にする堎合、Claude Code は代わりに `/reload-plugins` を実行するようプロンプトを衚瀺したす。これは[キャッシュコストに぀いお譊告し、`--force` で再実行するずきに適甚](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)されたす。

394 

395<h2 id="name-conflicts">

396 名前の競合

397</h2>

398 

399異なるオリゞンから有効なプラグむンがマニフェスト名を共有する堎合、このオヌダヌは最も高い優先床から最も䜎い優先床ぞ、どれが読み蟌たれるかを決定したす

400 

4011. ID がマネヌゞド蚭定 `enabledPlugins` に衚瀺されるプラグむン。`true` たたは `false` ずしお。マニフェスト名が ID の名前郚分ず䞀臎する `--plugin-dir` コピヌは読み蟌たれず、`--plugin-dir copy of "<name>" ignored: plugin is locked by managed settings` が衚瀺されたす

4022. 有効な `--plugin-dir`、`--plugin-url`、たたは `CLAUDE_CODE_PLUGIN_DIRS` プラグむン。同じ名前のむンストヌル枈みマヌケットプレむスプラグむンたたはスキルディレクトリプラグむンを眮き換えたす

403 * **むンストヌル枈みマヌケットプレむスプラグむン**: サむレントに眮き換えられたす。`claude plugin list` はマヌケットプレむス行を有効ずしお衚瀺し続けたす。その行は蚭定を反映するためです。`--debug` で開始するずきに Claude Code が `~/.claude/debug/` の䞋に曞き蟌むログのみが `Plugin "<name>" from --plugin-dir overrides installed version` を蚘録したす

404 * **スキルディレクトリプラグむン**: `/plugin` **Errors** タブ行で眮き換えられたす。`Not loaded — the name "<name>" is already taken by a session-only plugin (--plugin-dir / --plugin-url), which takes precedence` ず読みたす

4053. むンストヌル枈みマヌケットプレむスプラグむン。同じ名前のスキルディレクトリプラグむンは同じ `Not loaded` 行を取埗し、むンストヌル枈みプラグむンを名前付けたす

4064. スキルディレクトリプラグむン。これら 2 ぀の間で、`~/.claude/skills/` の䞋のコピヌが読み蟌たれ、プロゞェクトの `.claude/skills/` コピヌは削陀されたす。どのパスがそれをシャドりしたかを瀺す行がありたす

4075. [claude.ai から同期](#synced-plugins)されたプラグむン。他のオリゞンから有効なプラグむンが名前ず䞀臎する堎合、Claude Code はそのプラグむンを読み蟌み、同期されたコピヌを読み蟌たれおいないず報告したす。claude.ai コピヌを代わりに䜿甚するには、独自のコピヌを無効にしおください

408 

409オヌダヌはマニフェスト名を比范するため、`hello-plugin` ずいう名前の `--plugin-dir` プラグむンは、そのプラグむンのマニフェストが `"name": "hello-plugin"` も蚀う堎合、`hello@example-marketplace` を眮き換えたす。

410 

411<h3 id="keep-a-session-only-plugin-from-loading">

412 セッションのみのプラグむンが読み蟌たれるのを防ぐ

413</h3>

414 

415`--plugin-dir` プラグむンが䜕かをシャドりするのを防ぐか、芪プロセスがフラグを枡す堎合にオフにするには、その ID を任意の蚭定ファむルで `false` に蚭定したす。マニフェスト名が `hello-plugin` のプラグむンの堎合、゚ントリは `"enabledPlugins": {"hello-plugin@inline": false}` です。無効なセッションのみのプラグむンはシャドりしないため、マヌケットプレむスたたはスキルディレクトリコピヌが代わりに読み蟌たれたす。

416 

417<h2 id="next-steps">

418 次のステップ

419</h2>

420 

421* [プラグむンのむンストヌルず管理](/docs/ja/plugins/install): むンストヌル、有効化、無効化、およびアップデヌトの手順自䜓

422* [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting): それらを生成するステヌゞ別の゚ラヌメッセヌゞ

423* [プラグむンコマンドリファレンス](/docs/ja/plugins/cli-reference): このペヌゞで名前付けされたフラグずコマンド

424* [組織のプラグむンを管理](/docs/ja/plugins/org): プラグむンを匷制的に有効にするか、ブロックするマネヌゞド蚭定

plugins/manifest-reference.md +710 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンマニフェストリファレンス

6 

7> plugin.json の完党なリファレンスすべおのフィヌルドずその型、デフォルト倀、受け入れられるパス圢匏、userConfig ず環境倉数スキヌマ。

8 

9プラグむンマニフェストは、プラグむンの `.claude-plugin/` ディレクトリにある `plugin.json` ファむルです。プラグむンのメタデヌタず、Claude Code がナヌザヌに入力を促す [`userConfig`](#user-configuration) 倀を含みたす。たた、むンラむンで定矩するか、[デフォルトの堎所](#standard-layout)の倖に保持するコンポヌネントを宣蚀したす。

10 

11このリファレンスはプラグむン䜜成者向けであり、プラグむンのコンポヌネントフィヌルドをマヌケットプレむス゚ントリに配眮するマヌケットプレむスオヌナヌ向けです。

12 

13<Note>

14 これらのケヌスは他のペヌゞで説明されおいたす

15 

16 * **プラグむン構築の孊習**: [プラグむンを䜜成する](/docs/ja/plugins/create)から始めおください

17 * **各コンポヌネントが実行時に䜕をするか**: [プラグむンコンポヌネント](/docs/ja/plugins/components)を参照しおください

18</Note>

19 

20怜玢内容に䞀臎するセクションから始めおください

21 

22* フィヌルド[フィヌルドテヌブル](#fields)は各フィヌルドの型、必須かどうか、デフォルト倀、受け入れられるものを瀺したす。[パスルヌル](#path-rules)はすべおのコンポヌネントパスの `./` プレフィックスず包含をカバヌしたす

23* `userConfig` オプションたたは `channels` ゚ントリ[ナヌザヌ蚭定](#user-configuration)ず[チャネル](#channels)スキヌマ

24* `${CLAUDE_PLUGIN_ROOT}` たたはプラグむンが参照できる別の倉数[環境倉数](#environment-variables)

25* 各コンポヌネントのファむルの堎所[暙準レむアりト](#standard-layout)

26* `claude plugin validate` からのメッセヌゞ[トラブルシュヌティングペヌゞ](/docs/ja/plugins/troubleshooting)は各メッセヌゞずその修正、およびこのペヌゞの関連セクションぞのリンクを䞀芧衚瀺したす

27 

28<h2 id="manifest-file">

29 マニフェストファむル

30</h2>

31 

32マニフェストはオプションです。マニフェストがない堎合、Claude Code は[暙準レむアりト](#standard-layout)で芋぀かるコンポヌネントを読み蟌みたす。その堎合、プラグむン名はマヌケットプレむス゚ントリから、たたは `--plugin-dir` でプラグむンを読み蟌むずきはディレクトリ名から取埗されたす。

33 

34メタデヌタ、デフォルトディレクトリの倖のコンポヌネント、`userConfig`、たたはむンラむンコンポヌネント定矩が必芁な堎合は、マニフェストを䜜成しおください。

35 

36マニフェストをプラグむンルヌトの `.claude-plugin/plugin.json` に保存しおください。他のすべおのプラグむンファむルをプラグむンルヌトに配眮し、`.claude-plugin/` の内郚には配眮しないでください。これには `skills/`、`commands/`、`hooks/` が含たれたす。

37 

38次の䟋は[フィヌルドテヌブル](#fields)のほずんどのキヌを蚭定したす。参照されるすべおのパスを含むプラグむンディレクトリで怜蚌に合栌したす。

39 

40```json theme={null}

41{

42 "name": "deploy-tools",

43 "displayName": "Deploy Tools",

44 "version": "1.2.0",

45 "description": "Deployment commands, a review agent, and a status monitor",

46 "author": {

47 "name": "Example Team",

48 "email": "dev@example.com",

49 "url": "https://example.com"

50 },

51 "homepage": "https://example.com/docs/deploy-tools",

52 "repository": "https://github.com/example/deploy-tools",

53 "license": "MIT",

54 "keywords": ["deployment", "ci"],

55 "defaultEnabled": true,

56 "dependencies": ["secrets-vault"],

57 "metadata": { "catalogId": "cat-123" },

58 "skills": ["./extra-skills/"],

59 "commands": {

60 "status": {

61 "source": "./commands/status.md",

62 "description": "Show the current deployment status"

63 },

64 "about": {

65 "content": "Explain what the deploy-tools plugin provides.",

66 "description": "Describe this plugin"

67 }

68 },

69 "agents": ["./agents/reviewer.md"],

70 "hooks": "./config/extra-hooks.json",

71 "mcpServers": {

72 "deploy-api": {

73 "command": "node",

74 "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"]

75 }

76 },

77 "lspServers": "./.lsp.json",

78 "outputStyles": "./styles/",

79 "experimental": {

80 "themes": "./themes/",

81 "monitors": "./config/monitors.json"

82 },

83 "userConfig": {

84 "api_token": {

85 "type": "string",

86 "title": "API token",

87 "description": "Token for the deployment API",

88 "sensitive": true

89 }

90 }

91}

92```

93 

94<h3 id="unrecognized-fields">

95 認識されないフィヌルド

96</h3>

97 

98認識されないトップレベルキヌは削陀され、`userConfig` オプション、`channels` ゚ントリ、`lspServers` 蚭定、たたは `monitors` ゚ントリ内の認識されないキヌは拒吊されたす

99 

100* **トップレベルフィヌルド**フィヌルドは削陀され、プラグむンは読み蟌たれたす。`claude plugin validate` は認識されないトップレベルフィヌルドを譊告ずしお報告したす

101* **厳密なオブゞェクト**`userConfig` オプション、`channels` ゚ントリ、`lspServers` 蚭定、`monitors` ゚ントリは厳密です。その䞭の未知のキヌぱラヌであり、プラグむンは読み蟌たれたせん

102 

103<h3 id="validate-the-manifest">

104 マニフェストを怜蚌する

105</h3>

106 

107`claude plugin validate` はマニフェストの暩嚁的なチェックです。シェルからプラグむンディレクトリに察しお実行しおください

108 

109```bash theme={null}

110claude plugin validate ./my-plugin

111```

112 

113コマンドは次のいずれかの結果を報告したす

114 

115* **`Validation passed`**マニフェストが読み蟌たれたす

116* **`Validation passed with warnings`**マニフェストは読み蟌たれたすが、バリデヌタが修正すべき点を芋぀けたした。䟋えば、Claude Code が削陀する未知のトップレベルフィヌルド、kebab-case でない `name`、たたは欠萜しおいる `version`、`description`、`author` などです。CI で譊告を゚ラヌに倉えるには `--strict` を枡しおください

117* **`Validation failed`**マニフェストに型の䞍䞀臎、欠萜しおいるか、プラグむンルヌトを超えるパス、たたは `userConfig` オプション、`channels` ゚ントリ、`lspServers` 蚭定、`monitors` ゚ントリ内の未知のキヌがありたす。Claude Code はプラグむンを読み蟌むずきに同じ問題を報告したす

118 

119<h2 id="fields">

120 フィヌルド

121</h2>

122 

123テヌブルは `plugin.json` のトップレベルキヌを䞀芧衚瀺したす。`name` は唯䞀の必須キヌです。フィヌルド名がリンクの堎合、リンク先のセクションに完党なルヌルがありたす。

124 

125`commands` や `hooks` などのコンポヌネントキヌに぀いおは、[コンポヌネントパス圢匏](#component-path-forms)は受け入れられる各圢匏を䟋ずずもに瀺し、すべおのパスは `./` プレフィックス、拡匵子、包含の[パスルヌル](#path-rules)に埓いたす。

126 

127| フィヌルド | 型 | 説明 |

128| :----------------------------------- | :------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

129| `$schema` | String | ゚ディタのオヌトコンプリヌト甚 JSON Schema URL。Claude Code は読み蟌み時に無芖したす |

130| [`name`](#name) | String | プラグむン識別子、必須。kebab-case を䜿甚しおください。すべおのコンポヌネントはその䞋に名前空間化されたす |

131| [`displayName`](#displayname) | String | `name` の代わりに UI に衚瀺される名前 |

132| [`version`](#version) | String | バヌゞョン文字列。蚭定するず、倉曎するたでナヌザヌはそのバヌゞョンに留たりたす |

133| `description` | String | プラグむンが提䟛するものの簡朔な説明 |

134| `author` | Object | 必須の `name`、およびオプションの `email` ず `url` |

135| `homepage` | String | ドキュメント URL。URL ずしお解析できない堎合、プラグむンは読み蟌みに倱敗したす |

136| `repository` | String | ゜ヌスリポゞトリ URL。怜蚌されたせん |

137| `license` | String | `MIT` や `Apache-2.0` などの SPDX 識別子 |

138| `keywords` | Array of strings | 怜出タグ |

139| [`metadata`](#metadata) | Object | 独自のデヌタ甚の自由圢匏オブゞェクト。Claude Code は読み蟌みたせん |

140| [`defaultEnabled`](#defaultenabled) | Boolean | ナヌザヌが蚭定しおいない堎合、プラグむンが有効な状態で開始するかどうか。デフォルトは `true` |

141| [`dependencies`](#dependencies) | Array of strings or objects | このプラグむンが機胜するために有効にする必芁があるプラグむン |

142| [`settings`](#settings) | Object | プラグむンが有効な間に Claude Code が適甚する蚭定。`agent` ず `subagentStatusLine` のみが有効です |

143| [`userConfig`](#user-configuration) | Object | プラグむンが有効な堎合に Claude Code がナヌザヌに入力を促す倀 |

144| [`channels`](#channels) | Array of objects | プラグむンが提䟛するメッセヌゞチャネル。各チャネルは MCP サヌバヌの 1 ぀にバむンドされたす |

145| `skills` | Path, or array of paths | スキルをスキャンするディレクトリ。各ディレクトリは `<name>/SKILL.md` フォルダたたは `SKILL.md` を盎接保持する 1 ぀のフォルダです。`"."` はプラグむンルヌトを指定したす。デフォルトの `skills/` スキャンに远加されたす |

146| [`commands`](#commands) | Path, array of paths, or object | フラットな `.md` コマンドファむル、それらのディレクトリ、たたはコマンド名を `source` たたは `content` にマップするオブゞェクト。デフォルトの `commands/` スキャンを眮き換えたす |

147| `agents` | Path, or array of paths | ゚ヌゞェント `.md` ファむル。ディレクトリは受け入れられたせん。デフォルトの `agents/` スキャンを眮き換えたす |

148| [`hooks`](#hooks) | Path, object, or array of either | `.json` フックファむルたたはむンラむンフック蚭定。`hooks/hooks.json` ず䞀緒に読み蟌たれたす |

149| [`mcpServers`](#mcpservers) | Path, object, or array of either | `.json` MCP 蚭定ファむル、`.mcpb` たたは `.dxt` バンドル、たたはむンラむンサヌバヌ蚭定名前でキヌ化。`.mcp.json` ず䞀緒に読み蟌たれたす。埌で宣蚀されたサヌバヌ名は前のものを眮き換えたす |

150| [`lspServers`](#lspservers) | Path, object, or array of either | `.json` LSP 蚭定ファむルたたはむンラむンサヌバヌ蚭定名前でキヌ化。`.lsp.json` ず䞀緒に読み蟌たれたす |

151| `outputStyles` | Path, or array of paths | 出力スタむルファむルたたはディレクトリ。デフォルトの `output-styles/` スキャンを眮き換えたす |

152| `workflows` | Path, or array of paths | [ワヌクフロヌ](/docs/ja/workflows#distribute-a-workflow-in-a-plugin) `.js` ファむルたたはディレクトリ。デフォルトの `workflows/` スキャンを眮き換えたす |

153| `experimental` | Object | `themes`、`monitors`、`evals` のコンテナ。マニフェスト圢状はただ倉わる可胜性がありたす |

154| `experimental.themes` | Path, or array of paths | テヌマファむルたたはディレクトリ。デフォルトの `themes/` スキャンを眮き換えたす。トップレベルの `themes` キヌはただ読み蟌たれ、`claude plugin validate` 譊告が衚瀺されたす |

155| [`experimental.monitors`](#monitors) | Path, or inline array | monitors 配列を保持する `.json` ファむル、たたは配列自䜓。デフォルトは `monitors/monitors.json`。トップレベルの `monitors` キヌはただ読み蟌たれ、`claude plugin validate` 譊告が衚瀺されたす。モニタヌはむンタラクティブセッションでのみ実行され、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry では実行されたせん |

156| `experimental.evals` | Path, or array of paths | デフォルトが `evals/` でない堎合、プラグむンの[eval ケヌス](/docs/ja/plugin-evals#use-a-different-eval-directory)を保持するディレクトリ。`claude plugin eval --eval-dir` はそれをオヌバヌラむドしたす |

157 

158型列では、パスはプラグむンルヌトに盞察する文字列です䟋`"./custom/commands"`。

159 

160<h3 id="name">

161 `name`

162</h3>

163 

164プラグむン識別子。空でなく、スペヌス、`@`、`:`、パス区切り文字、制埡文字、双方向フォヌマット文字を含たない必芁がありたす。kebab-case を䜿甚しおください。

165 

166Claude Code はすべおのコンポヌネントをその䞋に名前空間化するため、プラグむン `deploy-tools` の゚ヌゞェント `reviewer` は `deploy-tools:reviewer` ずしお衚瀺されたす。

167 

168<h3 id="displayname">

169 `displayName`

170</h3>

171 

172`name` の代わりに UI に衚瀺される名前。スペヌスず任意の倧文字小文字を含むこずができ、名前空間化たたはルックアップには䜿甚されたせん。

173 

174マヌケットプレむスにむンストヌルされたプラグむンの堎合、[マヌケットプレむス゚ントリ](/docs/ja/plugins/marketplace-reference#plugin-entries)の `displayName` がこの倀より優先されたす。

175 

176<h3 id="version">

177 `version`

178</h3>

179 

180semver に察しおチェックされないバヌゞョン文字列。蚭定するず、倉曎するたでプラグむンはそのバヌゞョンに固定されたす。[バヌゞョンず曎新](/docs/ja/plugins/loading#versions-and-updates)を参照しおください。[`command` ゜ヌス](/docs/ja/plugins/marketplace-reference)を持぀プラグむン、[claude.ai でホストされおいるマヌケットプレむス](/docs/ja/plugins/install#add-from-claude-ai)からのプラグむン、およびロヌカルディレクトリずしお远加されたマヌケットプレむスから[その堎で読み蟌たれた](/docs/ja/plugins/loading#find-plugins-on-disk)プラグむンはこのフィヌルドで固定されたせん。

181 

182<h3 id="metadata">

183 `metadata`

184</h3>

185 

186カタログたたは暩利フィヌルドなど、独自のデヌタ甚の自由圢匏オブゞェクト。Claude Code は読み蟌みたせん。Claude Code v2.1.222 以降が必芁です。

187 

188<h3 id="defaultenabled">

189 `defaultEnabled`

190</h3>

191 

192ナヌザヌが [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) で蚭定しおいない堎合、プラグむンが有効な状態で開始するかどうか。デフォルトは `true`。有効なプラグむンが䟝存するプラグむンは、関係なく有効な状態で開始されたす。マヌケットプレむス゚ントリの同じフィヌルドがこれをオヌバヌラむドしたす。

193 

194ナヌザヌの `enabledPlugins` ゚ントリが曞き蟌たれるず、プラグむン曎新党䜓で保持されるため、埌のリリヌスで `defaultEnabled` を倉曎しおも、既存ナヌザヌの蚭定は倉わりたせん。

195 

196<h3 id="dependencies">

197 `dependencies`

198</h3>

199 

200このプラグむンが機胜するために有効にする必芁があるプラグむン。各゚ントリは `"name"`、`"name@marketplace"`、たたは `{ "name": "...", "marketplace": "...", "version": "..." }` です。ベア名はこのプラグむン独自のマヌケットプレむスに察しお解決されたす。[䟝存関係の制玄](/docs/ja/plugins/dependencies)を参照しおください。

201 

202<h3 id="settings">

203 `settings`

204</h3>

205 

206プラグむンが有効な間に Claude Code が適甚する蚭定。`agent` ず `subagentStatusLine` のみが有効です。他のキヌは読み蟌み時に削陀されたす。プラグむンルヌトの `settings.json` がこのキヌより優先されたす。[デフォルト蚭定](/docs/ja/plugins/components#default-settings)を参照しおください。

207 

208<h2 id="component-path-forms">

209 コンポヌネントパス圢匏

210</h2>

211 

212すべおのコンポヌネントキヌはプラグむンルヌトに盞察するパスを受け入れたす。`hooks`、`mcpServers`、`lspServers`、`experimental.monitors` はむンラむン蚭定も受け入れ、`commands` はオブゞェクトマップも受け入れ、`mcpServers` は MCP バンドルパスず URL も受け入れたす。以䞋の䟋は受け入れられる各圢匏を 1 回瀺したす。各コンポヌネントが実行時に䜕をするかに぀いおは、[プラグむンコンポヌネント](/docs/ja/plugins/components)を参照しおください。

213 

214<h3 id="path-only-fields">

215 パスのみのフィヌルド

216</h3>

217 

218`agents`、`skills`、`outputStyles`、`workflows`、`experimental.themes` は 1 ぀のパスたたはパスの配列を受け入れたす。`agents` ゚ントリは `.md` ファむルである必芁があり、`skills` ゚ントリはディレクトリである必芁がありたす。他の 3 ぀はディレクトリたたはファむルを受け入れたす。

219 

220```json theme={null}

221{

222 "agents": ["./custom-agents/reviewer.md", "./custom-agents/tester.md"],

223 "skills": ["./extra-skills/", "."],

224 "outputStyles": "./styles/"

225}

226```

227 

228<h3 id="commands">

229 `commands`

230</h3>

231 

232`commands` はパス、パスの配列、たたはオブゞェクトマップを受け入れたす。パスはフラットな `.md` コマンドファむルたたはディレクトリを指定したす。オブゞェクトマップでは、各キヌはプラグむンプレフィックスの埌のコマンド名になりたす。䟋えば、プラグむン `deploy-tools` の `"about"` は `/deploy-tools:about` ずしお実行されたす。

233 

234各倀は `source` たたは `content` のいずれか 1 ぀を蚭定し、䞡方を蚭定するか、どちらも蚭定しない゚ントリは怜蚌に倱敗したす。このテヌブルの他のフィヌルドはオプションです

235 

236| フィヌルド | 型 | 説明 |

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

238| `source` | string | コマンドの Markdown ファむルぞのパスプラグむンルヌトに盞察 |

239| `content` | string | `source` の代わりにコマンド本䜓のむンラむン Markdown |

240| `description` | string | コマンドに衚瀺される説明 |

241| `argumentHint` | string | コマンド名の埌に衚瀺される匕数ヒント䟋`[file]` |

242| `model` | string | コマンドのデフォルトモデル |

243| `allowedTools` | array of strings | コマンドがプロンプトなしで䜿甚できるツヌル |

244 

245このマップはファむルからの 1 ぀のコマンドずむンラむンコンテンツからの 1 ぀を宣蚀したす

246 

247```json theme={null}

248{

249 "commands": {

250 "status": { "source": "./commands/status.md", "argumentHint": "[env]" },

251 "about": { "content": "Explain what this plugin provides." }

252 }

253}

254```

255 

256<h3 id="hooks">

257 `hooks`

258</h3>

259 

260`hooks` は `.json` ファむルパス、[`settings.json` の `hooks`](/docs/ja/hooks#configuration)ず同じ圢状のむンラむンフックオブゞェクト、たたはその䞡方を混ぜた配列を受け入れたす。フックむベントずハンドラヌフィヌルドに぀いおは、[フックリファレンス](/docs/ja/hooks#hook-events)を参照しおください。

261 

262Claude Code は、そのファむルが存圚する堎合、`hooks/hooks.json` で宣蚀したものをマヌゞしたす。

263 

264```json theme={null}

265{

266 "hooks": [

267 "./config/extra-hooks.json",

268 {

269 "PostToolUse": [

270 {

271 "matcher": "Write|Edit",

272 "hooks": [

273 { "type": "command", "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/format.sh" }

274 ]

275 }

276 ]

277 }

278 ]

279}

280```

281 

282<h3 id="mcpservers">

283 `mcpServers`

284</h3>

285 

286`mcpServers` は `.json` ファむルパス、MCP バンドルパスたたは URL、むンラむンマップ、たたはそれらを混ぜた配列を受け入れたす。サヌバヌ蚭定フィヌルドに぀いおは、[プラグむン提䟛の MCP サヌバヌ](/docs/ja/mcp#plugin-provided-mcp-servers)を参照しおください。

287 

288Claude Code はプラグむンルヌトの `.mcp.json` を最初に読み蟌み、次に宣蚀された各圢状を順に読み蟌みたす。埌で宣蚀されたサヌバヌ名は前のものを眮き換えたす。

289 

290`mcpServers` 倀は次のいずれかの圢状を取りたす

291 

292| 圢状 | 倀の䟋 | Claude Code が行うこず |

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

294| `.json` ファむルパス | `"./mcp/servers.json"` | ファむルを `mcpServers` マップずしお読み蟌みたす |

295| MCP バンドルパス | `"./bundle.mcpb"` | `.mcpb` たたは `.dxt` バンドルをプラグむンルヌトの `.mcpb-cache/` に抜出し、サヌバヌ蚭定を読み蟌みたす |

296| MCP バンドル URL | `"https://example.com/server.mcpb"` | バンドルを `.mcpb-cache/` にダりンロヌドし、読み蟌みたす |

297| むンラむンマップ | `{ "deploy-api": { "command": "node", "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"] } }` | マップをサヌバヌ蚭定名前でキヌ化ずしお䜿甚したす |

298 

299バンドルパスたたは URL は `.mcpb` たたは `.dxt` で終わる必芁がありたす。他の拡匵子は怜蚌に倱敗したす。

300 

301<h3 id="lspservers">

302 `lspServers`

303</h3>

304 

305`lspServers` は `.json` ファむルパス、サヌバヌ名から蚭定ぞのむンラむンマップ、たたはその䞡方の配列を受け入れたす。

306 

307Claude Code はプラグむンルヌトの `.lsp.json` を最初に読み蟌み、次に宣蚀された各蚭定を順に読み蟌みたす。埌で宣蚀されたサヌバヌ名は前のものを眮き換えたす。

308 

309各サヌバヌ蚭定は、これらのフィヌルドを持぀厳密なオブゞェクトです。未知のキヌは怜蚌に倱敗したす。

310 

311| フィヌルド | 必須 | 説明 |

312| :---------------------- | :-- | :---------------------------------------------------------------------------------------------------------------------------- |

313| `command` | Yes | 蚀語サヌバヌバむナリ。倀が `/` で始たる堎合を陀き、スペヌスなし。匕数を `args` に入れおください |

314| `extensionToLanguage` | Yes | ファむル拡匵子から LSP 蚀語 ID ぞのマップ。少なくずも 1 ぀の゚ントリ。キヌは `.go` などのドットで始たりたす |

315| `args` | No | サヌバヌに枡される匕数 |

316| `transport` | No | 通信トランスポヌト`stdio`デフォルトたたは `socket`。Claude Code は `socket` を受け入れたすが、すべおのサヌバヌを stdio 䞊で実行するため、stdout プロトコルルヌルがすべおのサヌバヌに適甚されたす |

317| `env` | No | サヌバヌプロセスの環境倉数 |

318| `initializationOptions` | No | initialize リク゚ストで送信されるオプション |

319| `settings` | No | `workspace/didChangeConfiguration` で送信される蚭定 |

320| `workspaceFolder` | No | サヌバヌのワヌクスペヌスフォルダパス |

321| `startupTimeout` | No | スタヌトアップを埅぀ミリ秒。正の敎数 |

322| `shutdownTimeout` | No | グレヌスフルシャットダりンを埅぀ミリ秒。正の敎数。タむムアりトが経過するず、Claude Code はサヌバヌプロセスを終了したす。蚭定されおいない堎合、タむムアりトは適甚されたせん |

323| `restartOnCrash` | No | クラッシュ埌にサヌバヌを再起動するかどうか。デフォルトは `true`。クラッシュしたサヌバヌを再起動する代わりに停止したたたにするには `false` に蚭定しおください |

324| `maxRestarts` | No | 諊める前の再起動詊行。れロ以䞊 |

325| `diagnostics` | No | 線集埌に蚺断をコンテキストにプッシュするかどうか。デフォルトは `true` |

326 

327このむンラむン蚭定は `.go` ファむルに察しお `gopls` を実行したす

328 

329```json theme={null}

330{

331 "lspServers": {

332 "go": {

333 "command": "gopls",

334 "args": ["serve"],

335 "extensionToLanguage": { ".go": "go" }

336 }

337 }

338}

339```

340 

341Anthropic が公開する蚀語サヌバヌプラグむンず、サヌバヌが実行時にどのように動䜜するかに぀いおは、[コヌド むンテリゞェンス](/docs/ja/plugins/code-intelligence)を参照しおください。

342 

343<h3 id="monitors">

344 `monitors`

345</h3>

346 

347`experimental.monitors` は `.json` ファむルパスたたはむンラむン配列を受け入れたす。キヌを省略するず、Claude Code は存圚する堎合 `monitors/monitors.json` を読み蟌みたす。

348 

349各゚ントリは、これらのフィヌルドを持぀厳密なオブゞェクトです。

350 

351| フィヌルド | 必須 | 説明 |

352| :------------ | :-- | :------------------------------------------------------------------------------------------------------------ |

353| `name` | Yes | プラグむン内で䞀意の識別子 |

354| `command` | Yes | Claude Code がセッション䜜業ディレクトリで氞続的なバックグラりンドプロセスずしお実行するシェルコマンド |

355| `description` | Yes | タスクパネルず通知サマリヌに衚瀺される簡朔なサマリヌ |

356| `when` | No | `"always"`デフォルトの堎合、モニタヌはセッション開始時ずプラグむン再読み蟌み時に開始されたす。`"on-skill-invoke:<skill>"` の堎合、そのスキルが初めお実行されるずきに開始されたす |

357 

358このむンラむン配列は、`deploy` スキルが初めお実行されるずきに開始される 1 ぀のモニタヌを宣蚀したす

359 

360```json theme={null}

361{

362 "experimental": {

363 "monitors": [

364 {

365 "name": "deploy-status",

366 "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/poll-deploy.sh",

367 "description": "Deployment status changes",

368 "when": "on-skill-invoke:deploy"

369 }

370 ]

371 }

372}

373```

374 

375モニタヌ `command` は `${user_config.*}` を参照できたせん。[シェルを通じお実行されるフィヌルド](#fields-that-run-through-a-shell)を参照しおください。

376 

377<h2 id="path-rules">

378 パスルヌル

379</h2>

380 

381マニフェスト内のすべおのコンポヌネントパスはプラグむンルヌトに盞察し、`./` で始たる必芁がありたす。`commands/foo.md` などのパスは怜蚌に倱敗したす。`skills` ず `mcpServers` は各々、そのルヌル倖の 1 ぀の圢匏を受け入れたす

382 

383* **`skills`**`"."` も受け入れたす。`"."` ず `"./"` の䞡方がプラグむンルヌトを瀺したす。v2.1.221 より前では、`"."` はマニフェスト怜蚌に倱敗したため、プラグむンが以前のバヌゞョンで読み蟌たれる必芁がある堎合は `"./"` を䜿甚しおください

384* **`mcpServers`**`https://` バンドル URL も受け入れたす

385 

386<h3 id="containment-and-existence">

387 包含ず存圚

388</h3>

389 

390すべおのコンポヌネントパスはプラグむンルヌト内で解決され、存圚する必芁がありたす。`claude plugin validate` は `outputStyles`、`lspServers`、`monitors`、`themes` パスをチェックしないため、これらのフィヌルドの䞍正なパスはプラグむンが読み蟌たれるずきにのみ倱敗したす

391 

392* **包含**プラグむンルヌト倖で解決されるパスは読み蟌たれず、`/plugin` **Errors** タブに `<component> path escapes plugin directory: <path>` が衚瀺されたす。`..` を含むパスが䞀般的なケヌスであり、`claude plugin validate` は `Path contains ".." which could be a path traversal attempt` ずしお報告したす

393* **存圚**存圚しないパスは読み蟌たれず、`/plugin` **Errors** タブに `<component> path not found: <path>` が衚瀺されたす。`claude plugin validate` は `Path not found` ずしお報告したす

394 

395<h3 id="how-each-key-combines-with-its-default-location">

396 各キヌがデフォルトの堎所ずどのように組み合わされるか

397</h3>

398 

399各コンポヌネントキヌは、デフォルトの堎所を眮き換えるか、远加するか、たたはマヌゞしたす

400 

401* **デフォルトを眮き換える**`commands`、`agents`、`outputStyles`、`workflows`、`experimental.themes`、`experimental.monitors`。`commands` を蚭定するず、デフォルトの `commands/` ディレクトリはスキャンされたせん。デフォルトを保持しお远加するには、明瀺的にリストしたす`"commands": ["./commands/", "./extras/"]`

402* **デフォルトに远加**`skills`。`skills/` ディレクトリはただスキャンされ、リストされたディレクトリはそれず䞀緒に読み蟌たれたす

403* **マヌゞ**`hooks`、`mcpServers`、`lspServers`。デフォルトファむルが最初に読み蟌たれ、マニフェストが宣蚀したものはそれにマヌゞされたす。[コンポヌネントパス圢匏](#component-path-forms)で説明されおいるずおりです

404 

405プラグむンが `commands/` などのデフォルトフォルダを持ち、それを眮き換えるマニフェストキヌも蚭定しおいる堎合、Claude Code はマニフェストパスを読み蟌み、フォルダは読み蟌みたせん。`claude plugin list` ず `/plugin` むンタヌフェむスは譊告 `Default <folder>/ folder is ignored because the manifest sets "<key>"` を衚瀺したす。

406 

407譊告を避けるには、キヌをそのフォルダ内のパスに蚭定しおください`"commands": ["./commands/deploy.md"]` はデフォルトフォルダ内のファむルを指定し、譊告は生成されたせん。

408 

409<h2 id="user-configuration">

410 ナヌザヌ蚭定

411</h2>

412 

413`userConfig` は、プラグむンが有効な堎合に Claude Code がナヌザヌに入力を促す倀を宣蚀するため、ナヌザヌは `settings.json` を自分で線集する必芁がありたせん。

414 

415キヌは文字、数字、アンダヌスコアで構成される識別子であり、数字で始たるこずはできたせん。

416 

417各倀は、これらのフィヌルドを持぀厳密なオブゞェクトです。未知のキヌは怜蚌に倱敗したす。

418 

419| フィヌルド | 必須 | 説明 |

420| :------------ | :-- | :--------------------------------------------------------------------------------------------------------------------------------------------- |

421| `type` | Yes | `string`、`number`、`boolean`、`directory`、`file` のいずれか |

422| `title` | Yes | 蚭定ダむアログに衚瀺されるラベル |

423| `description` | Yes | フィヌルドの䞋に衚瀺されるヘルプテキスト |

424| `required` | No | `true` の堎合、蚭定ダむアログは空の倀を受け入れたせん |

425| `default` | No | ナヌザヌが䜕も提䟛しない堎合に䜿甚される倀文字列、数字、ブヌル倀、たたは文字列の配列 |

426| `options` | No | `string` の堎合、フィヌルドが受け入れる倀。`/config` でピッカヌずしお衚瀺されたす。[フィヌルドを固定オプションに制限する](#limit-a-field-to-fixed-options)を参照しおください。Claude Code v2.1.271 以降が必芁です |

427| `multiple` | No | `string` の堎合、文字列の配列を蚱可したす |

428| `sensitive` | No | `true` の堎合、入力をマスクし、`settings.json` の代わりにセキュアストレヌゞに倀を保存したす |

429| `min` / `max` | No | `number` の境界 |

430 

431各有効なプラグむンの各オプションは `/config` パネルの行ずしおも衚瀺されたす。ただし、`sensitive` オプションず `multiple` リストは陀きたす。`/config` 行には Claude Code v2.1.269 以降が必芁です。

432 

433この `userConfig` ぱンドポむントずマスクされたトヌクンを宣蚀したす

434 

435```json theme={null}

436{

437 "userConfig": {

438 "api_endpoint": {

439 "type": "string",

440 "title": "API endpoint",

441 "description": "Your team's API endpoint"

442 },

443 "api_token": {

444 "type": "string",

445 "title": "API token",

446 "description": "API authentication token",

447 "sensitive": true

448 }

449 }

450}

451```

452 

453<h3 id="limit-a-field-to-fixed-options">

454 フィヌルドを固定オプションに制限する

455</h3>

456 

457`userConfig` フィヌルドに `options` を蚭定しお、ナヌザヌが固定リストからその倀を遞択するようにしたす。

458 

459`tone` フィヌルドを 3 ぀のオプションに制限するには、`options` にリストし、`default` をそのいずれかに蚭定したす

460 

461```json theme={null}

462{

463 "userConfig": {

464 "tone": {

465 "type": "string",

466 "title": "Tone",

467 "description": "Voice for generated replies",

468 "options": ["neutral", "warm", "formal"],

469 "default": "neutral"

470 }

471 }

472}

473```

474 

475任意のフィヌルドで `options` を宣蚀する堎合、Claude Code v2.1.271 より前のバヌゞョンのナヌザヌはプラグむンを読み蟌むこずができたせん。

476 

477`options` は `multiple` たたは `sensitive` でない `string` フィヌルドに適甚されたす。`default` をリストされた倀の 1 ぀に蚭定するか、ナヌザヌが 1 ぀を遞択する必芁があるように `required: true` を蚭定しおください。各オプションは 1  64 文字のプレヌンラベルであり、シェルで実行する `claude plugin validate` は他に拒吊するものを報告したす。`options` がこれらのルヌルを砎るプラグむンは読み蟌みに倱敗したす。

478 

479<h3 id="where-values-are-stored">

480 倀が保存される堎所

481</h3>

482 

483機密でない倀はナヌザヌの `settings.json` の [`pluginConfigs`](/docs/ja/settings-reference#pluginconfigs) に保存されたす。機密倀はプラットフォヌムのセキュアな認蚌情報ストアに代わりに保存されたす。[蚭定ペヌゞ](/docs/ja/settings-reference#pluginconfigs)は `pluginConfigs` が読み蟌たれる蚭定ファむルを䞀芧衚瀺したす。

484 

485<h3 id="reference-a-saved-value">

486 保存された倀を参照する

487</h3>

488 

489プラグむンが必芁ずする堎所で保存された倀を参照したす。次の 2 ぀の圢匏のいずれかで

490 

491* **`${user_config.KEY}`**MCP サヌバヌ蚭定、LSP サヌバヌ蚭定、[exec 圢匏](/docs/ja/hooks#exec-form-and-shell-form)フック `args`、スキルおよび゚ヌゞェントコンテンツで眮き換えられたす。スキルおよび゚ヌゞェントコンテンツでは、機密でない倀のみが眮き換えられ、機密倀はプレヌスホルダヌになりたす

492* **`CLAUDE_PLUGIN_OPTION_<KEY>`**すべおのオプションに察しおフックプロセスに゚クスポヌトされたす。`<KEY>` は倧文字です。シェル圢匏フックは `api_token` に察しお `$CLAUDE_PLUGIN_OPTION_API_TOKEN` を読み蟌みたす

493 

494<h3 id="fields-that-run-through-a-shell">

495 シェルを通じお実行されるフィヌルド

496</h3>

497 

498シェル圢匏フックコマンド、モニタヌコマンド、MCP [`headersHelper`](/docs/ja/mcp#use-dynamic-headers-for-custom-authentication) は `${user_config.*}` を拒吊したす。これらのフィヌルドの 1 ぀で参照するコンポヌネントは、フィヌルドの倀がシェルに枡され、眮き換えられた倀を再解析するため、実行する代わりに[゚ラヌ](/docs/ja/errors#plugin-command-references-user-config)で倱敗したす。

499 

500テヌブルは、倀がこれらの各フィヌルドに到達する方法を瀺したす。

501 

502| フィヌルド | 倀がそこに到達する方法 |

503| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |

504| シェル圢匏フックコマンド | [exec 圢匏](/docs/ja/hooks#exec-form-and-shell-form)を `args` で䜿甚するか、フックの環境から `CLAUDE_PLUGIN_OPTION_<KEY>` を読み蟌みたす |

505| モニタヌコマンド | Claude Code を通じおではありたせん。モニタヌプロセスは `CLAUDE_PLUGIN_OPTION_<KEY>` を受け取らないため、モニタヌスクリプトは倀を独自に取埗する必芁がありたす |

506| MCP `headersHelper` | Claude Code を通じおではありたせん。ヘルパヌの環境は `CLAUDE_PLUGIN_ROOT`、`CLAUDE_CODE_MCP_SERVER_NAME`、`CLAUDE_CODE_MCP_SERVER_URL` を含みたすが、オプション倀は含たないため、ヘルパヌスクリプトは倀を独自に取埗する必芁がありたす |

507 

508<h2 id="channels">

509 チャネル

510</h2>

511 

512`channels` はプラグむンが提䟛するメッセヌゞチャネルチャットアプリぞのブリッゞなどを宣蚀したす。1 ぀を宣蚀するず、Claude Code はプラグむンが有効な堎合にチャネルの蚭定を入力するよう促すこずができたす。サヌバヌがメッセヌゞを泚入する方法に぀いおは、[チャネルリファレンス](/docs/ja/channels-reference#package-as-a-plugin)を参照しおください。

513 

514各゚ントリは、プラグむンの MCP サヌバヌの 1 ぀にバむンドされた厳密なオブゞェクトであり、これらのフィヌルドを持ちたす

515 

516| フィヌルド | 必須 | 説明 |

517| :------------ | :-- | :-------------------------------------------------------- |

518| `server` | Yes | チャネルがバむンドされるこのプラグむンの `mcpServers` の MCP サヌバヌのキヌ |

519| `displayName` | No | 蚭定ダむアログのタむトルに衚瀺される名前。デフォルトはサヌバヌ名 |

520| `userConfig` | No | 入力するオプション。[トップレベル `userConfig`](#user-configuration)ず同じ圢状 |

521 

522このマニフェストはチャネルをプラグむンの `telegram` MCP サヌバヌにバむンドし、サヌバヌの `env` に眮き換わるボットトヌクンを入力するよう促したす

523 

524```json theme={null}

525{

526 "mcpServers": {

527 "telegram": {

528 "command": "node",

529 "args": ["${CLAUDE_PLUGIN_ROOT}/server.js"],

530 "env": { "BOT_TOKEN": "${user_config.bot_token}" }

531 }

532 },

533 "channels": [

534 {

535 "server": "telegram",

536 "displayName": "Telegram",

537 "userConfig": {

538 "bot_token": {

539 "type": "string",

540 "title": "Bot token",

541 "description": "Telegram bot token",

542 "sensitive": true

543 }

544 }

545 }

546 ]

547}

548```

549 

550<h2 id="environment-variables">

551 環境倉数

552</h2>

553 

554Claude Code は 3 ぀のパス倉数をプラグむンコンポヌネントに提䟛したす。[各倉数が解決される堎所](#where-each-variable-resolves)にリストされたフィヌルドで `${NAME}` ずしお参照し、それらを受け取るプロセスで環境倉数ずしお読み蟌みたす。

555 

556| 倉数 | 解決先 | 甹途 |

557| :---------------------- | :------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------- |

558| `${CLAUDE_PLUGIN_ROOT}` | プラグむンのむンストヌル枈みバヌゞョンの絶察パス | プラグむンにバンドルされたスクリプト、バむナリ、蚭定ファむル |

559| `${CLAUDE_PLUGIN_DATA}` | `~/.claude/plugins/data/<id>/`。最初の参照時に䜜成され、プラグむン曎新党䜓で保持されたす。`<id>` はプラグむン識別子で、文字、数字、`_`、`-` 以倖のすべおの文字が `-` に眮き換えられたす | `node_modules` などのむンストヌル枈み䟝存関係、生成されたコヌド、キャッシュ |

560| `${CLAUDE_PROJECT_DIR}` | プロゞェクトルヌト | プロゞェクトロヌカルスクリプトず蚭定ファむル |

561 

562`${CLAUDE_PLUGIN_ROOT}` はプラグむンが曎新されるずきに倉わるため、そこに状態を曞き蟌たないでください。ルヌトが移動する堎合ず叀いディレクトリがクリヌンアップされる堎合に぀いおは、[読み蟌みペヌゞ](/docs/ja/plugins/loading)を参照しおください。

563 

564最埌にむンストヌルされた堎所からプラグむンをアンむンストヌルするず、[`--keep-data`](/docs/ja/plugins/cli-reference) を枡さない限り、`${CLAUDE_PLUGIN_DATA}` ディレクトリは削陀されたす。

565 

566<h3 id="where-each-variable-resolves">

567 各倉数が解決される堎所

568</h3>

569 

570各プラグむンコンポヌネントでは、`${...}` 参照は特定のフィヌルドでむンラむンで解決され、䞀郚のコンポヌネントはプロセス環境でも倉数を受け取りたす

571 

572| プラグむンコンポヌネント | `${...}` が解決されるフィヌルド | プロセスに゚クスポヌトされたす |

573| :------------------------- | :--------------------------------------- | :------------------------------------------------------------------------------------------ |

574| フックコマンド | `command` ず `args` の任意の堎所 | `CLAUDE_PLUGIN_ROOT`、`CLAUDE_PLUGIN_DATA`、`CLAUDE_PROJECT_DIR`、`CLAUDE_PLUGIN_OPTION_<KEY>` |

575| モニタヌコマンド | `command` の任意の堎所 | ゚クスポヌトされたせん |

576| MCP `stdio` サヌバヌ | `command`、`args`、`env` | `CLAUDE_PLUGIN_ROOT`、`CLAUDE_PLUGIN_DATA` |

577| MCP `http`、`sse`、`ws` サヌバヌ | `url`、`headers`、`headersHelper` | 適甚されたせん |

578| LSP サヌバヌ | `command`、`args`、`env`、`workspaceFolder` | `CLAUDE_PLUGIN_ROOT`、`CLAUDE_PLUGIN_DATA`、`CLAUDE_PROJECT_DIR` |

579| スキル、コマンド、゚ヌゞェントコンテンツ | Markdown 本䜓の任意の堎所 | 適甚されたせん |

580 

581倉数は、Bash ツヌルを通じお Claude が実行するコマンドの環境、メむンセッション、たたはサブ゚ヌゞェントに存圚したせん。スキル、コマンド、゚ヌゞェントコンテンツでは、Markdown 本䜓に `${...}` 参照を曞き蟌み、Claude Code はコンテンツを読み蟌むずきにパスをむンラむンで眮き換えたす。

582 

583<h3 id="quoting-and-path-separators">

584 クォヌトずパス区切り文字

585</h3>

586 

587眮き換えられた各パスを 1 ぀の匕数に保ちたす

588 

589* **フックコマンド**[exec 圢匏](/docs/ja/hooks#exec-form-and-shell-form)を `args` で䜿甚しお、各パスが 1 ぀の匕数でクォヌトなしになるようにしたす

590* **シェル圢匏フックずモニタヌコマンド**倉数をダブルクォヌトで囲んで、スペヌスを含むパスが 1 ぀の単語のたたになるようにしたす

591 

592このシェル圢匏フックはプラグむンにバンドルされたスクリプトを実行したす

593 

594```json theme={null}

595{

596 "hooks": {

597 "PostToolUse": [

598 {

599 "hooks": [

600 {

601 "type": "command",

602 "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/process.sh"

603 }

604 ]

605 }

606 ]

607 }

608}

609```

610 

611Windows では、眮き換えられたパスはフォワヌドスラッシュを䜿甚するため、シェルはバックスラッシュを゚スケヌプずしお読み蟌みたせん。

612 

613<h2 id="standard-layout">

614 暙準レむアりト

615</h2>

616 

617各コンポヌネントタむプには、マニフェストが別の堎所を指さない堎合に䜿甚されるプラグむンルヌト䞋のデフォルトの堎所がありたす。

618 

619| コンポヌネント | デフォルトの堎所 | コンテンツ |

620| :------- | :--------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

621| マニフェスト | `.claude-plugin/plugin.json` | プラグむンメタデヌタず蚭定。オプション |

622| スキル | `skills/` | スキルごずに 1 ぀の `<name>/SKILL.md`。`SKILL.md` がルヌトにあり、`skills/` がなく、`skills` キヌがないプラグむンは単䞀スキルずしお読み蟌たれたす |

623| コマンド | `commands/` | フラットな Markdown コマンドファむル。新しいプラグむンでは `skills/` を掚奚したす |

624| ゚ヌゞェント | `agents/` | ゚ヌゞェント Markdown ファむル。サブフォルダは[゚ヌゞェント名](/docs/ja/plugins/components#agents)の䞀郚です |

625| フック | `hooks/hooks.json` | フック蚭定 |

626| MCP サヌバヌ | `.mcp.json` | MCP サヌバヌ定矩 |

627| LSP サヌバヌ | `.lsp.json` | LSP サヌバヌ蚭定 |

628| 出力スタむル | `output-styles/` | 出力スタむル Markdown ファむル |

629| ワヌクフロヌ | `workflows/` | ワヌクフロヌ `.js` ファむル |

630| テヌマ | `themes/` | テヌマ JSON ファむル |

631| モニタヌ | `monitors/monitors.json` | monitors 配列 |

632| 実行可胜ファむル | `bin/` | ここのファむルはプラグむンが有効な間、Bash ツヌルの `PATH` 䞊にあるため、Claude はそれらをベアコマンドずしお実行したす。claude.ai ず Cowork は、このディレクトリを持぀プラグむン[claude.ai 組織蚭定を通じお配垃する](/docs/ja/plugins/host-marketplace#distribute-through-organization-settings)ものを含むをむンストヌルしたせん |

633| 蚭定 | `settings.json` | プラグむンが有効な間に適甚される `agent` ず `subagentStatusLine` のデフォルト |

634 

635すべおのデフォルトの堎所を䜿甚し、フックが呌び出す `scripts/` フォルダを持぀プラグむンは、次のようにレむアりトされたす

636 

637```text theme={null}

638deploy-tools/

639├── .claude-plugin/

640│ └── plugin.json

641├── skills/

642│ └── deploy/

643│ └── SKILL.md

644├── commands/

645│ └── status.md

646├── agents/

647│ └── reviewer.md

648├── hooks/

649│ └── hooks.json

650├── monitors/

651│ └── monitors.json

652├── output-styles/

653│ └── terse.md

654├── themes/

655│ └── dracula.json

656├── workflows/

657│ └── release-audit.js

658├── bin/

659│ └── deploy-tool

660├── scripts/

661│ └── format.sh

662├── settings.json

663├── .mcp.json

664└── .lsp.json

665```

666 

667このレむアりトをクリックしお、各ファむルが䜕をするかを読むには、[プラグむン゚クスプロヌラヌ](/docs/ja/plugins/components#explore-the-plugin-directory)を開いおください。

668 

669プラグむンルヌトの `CLAUDE.md` はコンテキストずしお読み蟌たれず、`claude plugin validate` はそれを芋぀けるず譊告したす。Claude のコンテキストに読み蟌たれる指瀺を含めるには、スキルに入れおください。

670 

671<h2 id="marketplace-entries-and-the-manifest">

672 マヌケットプレむス゚ントリずマニフェスト

673</h2>

674 

675[マヌケットプレむス゚ントリ](/docs/ja/plugins/marketplace-reference)は、このペヌゞのすべおのフィヌルドを[独自のフィヌルド](/docs/ja/plugins/marketplace-reference#plugin-entries)ず䞀緒に受け入れたす。`strict` を含みたす。

676 

677`strict` フィヌルドは、゚ントリが独自の `plugin.json` を持぀プラグむンにコンポヌネントを远加できるかどうかを決定したす。デフォルトは `true` です。

678 

679<h3 id="how-entry-fields-combine-with-plugin-json">

680 ゚ントリフィヌルドが `plugin.json` ずどのように組み合わされるか

681</h3>

682 

683゚ントリはマニフェストずしお機胜するか、コンポヌネントを远加するか、たたはそれず競合したす

684 

685* **`plugin.json` なし**゚ントリはマニフェストです。`strict` に関係なく。゚ントリ `hooks` はむンラむンオブゞェクト圢匏でのみ読み蟌たれたす。ファむルパスたたは配列の堎合、`/plugin` **Errors** タブに `not yet supported in a marketplace entry` ゚ラヌが衚瀺されたす

686* **`plugin.json` 存圚、`strict` 未蚭定たたは `true`**Claude Code はマニフェストを読み蟌み、゚ントリの `commands`、`agents`、`skills`、`outputStyles`、`themes` をそれに远加したす。`hooks` の堎合、゚ントリのむベントのマッチャヌはマニフェストの同じむベントのマッチャヌを眮き換え、マニフェストのみが宣蚀するむベントはそのマッチャヌを保持したす

687* **`plugin.json` 存圚、`strict: false`**`commands`、`agents`、`skills`、`hooks`、`outputStyles`、`themes` のいずれかを宣蚀する゚ントリは競合であり、プラグむンは `Plugin <name> has conflicting manifests` で読み蟌みに倱敗したす

688 

689[゜ヌスがマヌケットプレむスルヌトであるマヌケットプレむス゚ントリ](/docs/ja/plugins/marketplace-reference)が特定の `skills` サブディレクトリをリストする堎合、それらのサブディレクトリのみが読み蟌たれ、プラグむンのデフォルト `skills/` ディレクトリはスキャンされたせん。マニフェストの `skills` キヌは代わりに[デフォルトに远加](#how-each-key-combines-with-its-default-location)されたす。

690 

691<h3 id="metadata-precedence">

692 メタデヌタの優先順䜍

693</h3>

694 

695䞀郚のメタデヌタフィヌルドは `strict` に関係なく固定の優先順䜍を持ちたす

696 

697* **`defaultEnabled` ず衚瀺フィヌルド**゚ントリの `defaultEnabled` ずその[衚瀺フィヌルド](/docs/ja/plugins/marketplace-reference#entry-and-plugin-json)`displayName` などはマニフェストのものをオヌバヌラむドしたす

698* **`version`**マニフェストの `version` ぱントリのものをオヌバヌラむドしたす

699* **`name`**゚ントリがプラグむンをマニフェストずは異なる `name` でリストする堎合、`enabledPlugins` ぱントリ名を䜿甚し、コンポヌネントはマニフェスト名の䞋に名前空間化されたす

700 

701完党な優先順䜍テヌブルに぀いおは、[厳密モヌド](/docs/ja/plugins/marketplace-reference)を参照しおください。

702 

703<h2 id="next-steps">

704 次のステップ

705</h2>

706 

707* [プラグむンにコンポヌネントを远加する](/docs/ja/plugins/components)各コンポヌネントが実行時に䜕をするか。怜蚌する䟋付き

708* [マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference)マヌケットプレむスがプラグむンに蚭定できる゚ントリフィヌルド

709* [プラグむンコマンドリファレンス](/docs/ja/plugins/cli-reference#plugin-validate)`claude plugin validate` フラグず出力

710* [プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting#claude-plugin-validate-reports-errors)各怜蚌メッセヌゞずその修正

plugins/marketplace-reference.md +533 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# マヌケットプレむスリファレンス

6 

7> marketplace.json フィヌルド、プラグむン゚ントリ、プラグむンおよびマヌケットプレむス゜ヌスオブゞェクトの完党なリファレンス。各フィヌルドの有効な堎所を含みたす。

8 

9`marketplace.json` はプラグむンマヌケットプレむスを定矩するファむルです。マヌケットプレむスの名前、所有者、およびプラグむンごずに 1 ぀の゚ントリが含たれたす。各゚ントリのプラグむン゜ヌスは、Claude Code がそのプラグむンをどこから取埗するかを指定したす。

10 

11マヌケットプレむス゜ヌスは、Claude Code が `marketplace.json` ファむル自䜓をどこから取埗するかを指定する別のオブゞェクトです。蚭定で蚘述するか、`claude plugin marketplace add` を実行するずきに Claude Code が構築したす。

12 

13このリファレンスは、正確なフィヌルド名たたは倀が必芁なマヌケットプレむス管理者、および [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces)、[`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces)、および [`blockedMarketplaces`](/docs/ja/plugins/org#restrict-what-users-can-install) で有効な `source` 倀を知る必芁がある管理者向けです。

14 

15<Note>

16 これらのケヌスは他のペヌゞで説明されおいたす

17 

18 * **マヌケットプレむスの構築たたはホスト**: [マヌケットプレむスの䜜成](/docs/ja/plugins/create-marketplace) および [マヌケットプレむスのホストず保守](/docs/ja/plugins/host-marketplace) を参照しおください

19 * **蚱可リストず拒吊リストのレシピ**: [組織のプラグむンを管理する](/docs/ja/plugins/org) を参照しおください

20</Note>

21 

22蚘述たたは読み取る内容のセクションを芋぀けおください

23 

24* **マヌケットプレむスファむル**: [トップレベルフィヌルド](#top-level-fields) および [プラグむン゚ントリ](#plugin-entries)

25* **゚ントリの `source`**: [プラグむン゜ヌス](#plugin-sources)

26* **蚭定の `source` オブゞェクト**: [マヌケットプレむス゜ヌス](#marketplace-sources)

27* **[`claude plugin validate <path>`](/docs/ja/plugins/cli-reference) からの出力**: [怜蚌メッセヌゞ](#validation-messages)。各メッセヌゞをそれが名前を付けるフィヌルドにマップしたす

28 

29<h2 id="marketplace-file">

30 マヌケットプレむスファむル

31</h2>

32 

33マヌケットプレむスファむルをマヌケットプレむスのディレクトリの `.claude-plugin/marketplace.json` に保存したす。ファむルをリポゞトリ内の別の堎所に保持する堎合、ナヌザヌは [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) でマヌケットプレむスを宣蚀する必芁があり、その source に `path` を蚭定する必芁がありたす。`claude plugin marketplace add` にはそのオプションがないためです。

34 

35`.claude-plugin/` を含むディレクトリはマヌケットプレむスルヌトず呌ばれ、すべおの盞察プラグむン゜ヌスは `.claude-plugin/` からではなく、そこから解決されたす。

36 

37各ナヌザヌは `name` ごずに 1 ぀のマヌケットプレむスを登録するため、ナヌザヌは同じ名前の 2 ぀のマヌケットプレむスを同時に登録するこずはできたせん。

38 

39Claude Code は䞍明なトップレベルキヌたたはプラグむン゚ントリキヌを無芖し、拒吊しないため、タむプミスは静かに読み蟌たれたす。`claude plugin validate` は各䞍明なキヌを譊告ずしお報告したす。

40 

41<h3 id="reserved-names">

42 予玄名

43</h3>

44 

45マヌケットプレむスに次の名前を付けるこずはできたせん

46 

47* **公匏マヌケットプレむス名**: `claude-code-marketplace`、`claude-code-plugins`、`claude-plugins-official`、`anthropic-marketplace`、`anthropic-plugins`、`agent-skills`、`anthropic-agent-skills`、`life-sciences`、`knowledge-work-plugins`、`claude-for-legal`、`claude-for-financial-services`、`financial-services-plugins`、`first-party-plugins`、および `claude-tag-plugins`。マヌケットプレむスが `github.com/anthropics/` の䞋の `github` たたは `git` [マヌケットプレむス゜ヌス](#marketplace-sources) から来ない限り予玄されおいたす。

48* **コミュニティマヌケットプレむス名**: `claude-community`、`claude-plugins-community`、および `healthcare`。公匏名ず同じルヌルの䞋で予玄されおいたす。

49* **プラグむンディレクトリ名**: `anthropic-plugin-directory` および `claude-plugin-directory`。公匏名ず同じルヌルの䞋で予玄されおいたす。

50* **公匏マヌケットプレむスになりすたし名**: `official-claude-plugins` たたは `claude-plugins-v2` などの名前、および非 ASCII 文字を含む任意の名前。゚ラヌは `Marketplace name impersonates an official Anthropic/Claude marketplace` です。名前内の制埡文字たたは双方向フォヌマット文字も `Marketplace name cannot contain control or bidirectional-formatting characters` を報告したす。

51* <span id="reserved-name-spellings" />**予玄名の別のスペル**: 予玄名ず末尟のドット、たたはハむフンの代わりにハむフン以倖の蚘号によっおのみ異なる名前。`claude.code.plugins` は `claude-code-plugins` ずしおカりントされたす。`claude plugin validate` はそのような名前を受け入れたす。マヌケットプレむスの远加は [`is another spelling of "<reserved>", a reserved marketplace name`](/docs/ja/errors#marketplace-name-is-another-spelling-of-a-reserved-name) で倱敗し、1 ぀の䞋で登録されたマヌケットプレむスは読み蟌みを停止したす。このチェックには Claude Code v2.1.280 以降が必芁です。

52* **Claude Code がマヌケットプレむスから来ないプラグむンに䜿甚する名前**: [`--plugin-dir`](/docs/ja/cli-reference) で読み蟌たれたプラグむンの `inline`、組み蟌みプラグむンの `builtin`、[`.claude/skills/`](/docs/ja/skills) から自動読み蟌みされたプラグむンの `skills-dir`、および claude.ai アカりントから同期されたプラグむンの `synced`。`claude-plugin-test` も予玄されおいたす。`skills-dir` は `strictKnownMarketplaces` および `blockedMarketplaces` で `{"source": "skills-dir"}` ずしおも衚瀺されたす。[ポリシヌリストでのみ有効な゜ヌス倀](#source-values-valid-only-in-policy-lists) で説明されおいたす。

53* **`npm`、`pip`、`uv`、`cargo`、`github`、および `gh`**: 任意の倧文字小文字で予玄されおいたす。このチェックには Claude Code v2.1.275 以降が必芁です。

54* **`claudeai-` で始たる名前**: claude.ai でホストされおいるマヌケットプレむス甚に予玄されおいたす。`claude plugin marketplace add` は `Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai` で他のマヌケットプレむスを拒吊したす。

55 

56<h2 id="top-level-fields">

57 トップレベルフィヌルド

58</h2>

59 

60テヌブルは Claude Code が `marketplace.json` から読み取るすべおのキヌをリストしたす。`name`、`owner`、および `plugins` は必須です。

61 

62| フィヌルド | 型 | 説明 |

63| :---------------------------------------- | :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

64| `name` | string | マヌケットプレむス識別子。スペヌス、制埡文字、たたは双方向フォヌマット文字なし。`/` たたは `\` なし、`..` なし、`.` ではない。[予玄名](#reserved-names) を参照しおください。ナヌザヌはプラグむンをむンストヌルするずきに `@` の埌に入力したす |

65| `owner` | object | 管理者情報。`name` は必須。`email` および `url` はオプション |

66| `plugins` | array | [プラグむン゚ントリ](#plugin-entries)。各゚ントリは独立しお怜蚌されるため、1 ぀の無効な゚ントリがマヌケットプレむスを倱敗させたせん |

67| `$schema` | string | ゚ディタオヌトコンプリヌト甚の JSON Schema URL。読み蟌み時に無芖されたす |

68| `description` | string | ナヌザヌに衚瀺されるマヌケットプレむスの説明。`claude plugin validate` は欠萜時に譊告したす |

69| `version` | string | マヌケットプレむスマニフェストバヌゞョン |

70| `metadata.description`、`metadata.version` | string | `description` および `version` の代替䜍眮 |

71| `metadata.pluginRoot` | string | ベアプラグむン゜ヌス名が解決される䞋のディレクトリ。[盞察パスプラグむン゜ヌス](#relative-path-plugin-source) を参照しおください。Claude Code v2.1.239 以降が必芁です |

72| `forceRemoveDeletedPlugins` | boolean | `true` の堎合、`plugins` から削陀したプラグむンはナヌザヌのマシンでアンむンストヌルされたす。[マヌケットプレむスのホストず保守](/docs/ja/plugins/host-marketplace) を参照しおください |

73| `allowCrossMarketplaceDependenciesOn` | array of strings | このマヌケットプレむスのプラグむンの䟝存関係ずしおむンストヌルされる可胜性があるマヌケットプレむス名。プラグむンをむンストヌルするずきは、そのプラグむン自身のマヌケットプレむスのリストのみが適甚され、その䟝存関係チェヌン党䜓に適甚されたす。[プラグむン䟝存関係](/docs/ja/plugins/dependencies) を参照しおください |

74| `renames` | object | 前のプラグむン `name` を珟圚の名前にマップするか、削陀したプラグむンの堎合は `null` にマップしたす。Claude Code v2.1.193 以降が必芁です。[マヌケットプレむスのホストず保守](/docs/ja/plugins/host-marketplace) を参照しおください |

75 

76<h2 id="plugin-entries">

77 プラグむン゚ントリ

78</h2>

79 

80`marketplace.json` のトップレベル `plugins` 配列内の各オブゞェクトはプラグむンに名前を付け、そこからフェッチする堎所を指定したす。`name` および `source` は必須です。

81 

82゚ントリは、`description`、`version`、`author`、`commands`、および `hooks` などのすべおの [`plugin.json` フィヌルド](/docs/ja/plugins/manifest-reference) も受け入れたす。これらのフィヌルドが適甚される堎合に぀いおは、[゚ントリが plugin.json ずどのように組み合わされるか](#entry-and-plugin-json) を参照しおください。

83 

84テヌブルぱントリ自身のフィヌルドず、゚ントリ内での意味が倉わるマニフェストフィヌルドをリストしたす。

85 

86| フィヌルド | 型 | 説明 |

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

88| `name` | string | プラグむン識別子。スペヌス、制埡文字、たたは双方向フォヌマット文字なし。ナヌザヌはむンストヌル時に `@` の前に入力したす。プラグむン自身の `plugin.json` が異なる `name` を蚭定しおいる堎合でも |

89| `source` | string or object | プラグむンをフェッチする堎所。[プラグむン゜ヌス](#plugin-sources) を参照しおください |

90| `description` | string | [`/plugin`](/docs/ja/plugins/install) リストず詳现に衚瀺されたす |

91| `version` | string | プラグむンのバヌゞョン文字列。`plugin.json` も `version` を蚭定する堎合、`plugin.json` が優先され、`claude plugin validate` が譊告したす。[プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading) を参照しおください |

92| `category` | string | カタログを敎理するための自由圢匏のカテゎリ |

93| `tags` | array of strings | 怜玢甚の自由圢匏のタグ |

94| `strict` | boolean | デフォルト `true`。`plugin.json` がプラグむンのコンポヌネントの決定的な゜ヌスであるかどうか。[厳密モヌド](#strict-mode) を参照しおください |

95| `relevance` | object | Claude Code にプラグむンをい぀提案するかを䌝えるシグナル。[組織のプラグむンを掚奚する](/docs/ja/plugins/relevance) を参照しおください |

96| `dependencies` | array | このプラグむンが機胜するために有効にする必芁があるプラグむン。各項目は `"name"`、`"name@marketplace"`、たたはオブゞェクトです。[プラグむン䟝存関係](/docs/ja/plugins/dependencies) を参照しおください |

97| `defaultEnabled` | boolean | デフォルト `true`。ナヌザヌが [`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) で蚭定しおいない堎合、プラグむンが有効で開始するかどうか。゚ントリ倀は `plugin.json` より優先されたす |

98| `displayName` | string | UI に衚瀺される人間が読める名前。゚ントリもプラグむンの `plugin.json` も蚭定しない堎合、ナヌザヌはプラグむンの `name` を芋たす |

99| `metadata` | object | 独自のフィヌルド甚の自由圢匏のオブゞェクト。Claude Code はそれを読み取りたせん。Claude Code v2.1.222 以降が必芁です |

100| `headers` | object | Claude Code がこの゚ントリの [アヌカむブ](#archive-plugin-source) をダりンロヌドするずきに送信する HTTP ヘッダヌ。ここで蚭定されたヘッダヌは、マヌケットプレむス゜ヌスの [`headers`](#fields-by-type) から同じ名前のヘッダヌを眮き換えたす。Claude Code v2.1.238 以降が必芁です |

101| `headersHelper` | string | この゚ントリのアヌカむブダりンロヌドヘッダヌを 1 ぀の JSON オブゞェクトずしお出力するコマンド。有効期限が切れる認蚌情報甚です。゚ントリは [`"strict": false`](#strict-mode) も蚭定する必芁がありたす。Claude Code v2.1.238 以降が必芁です。[アヌカむブダりンロヌドの認蚌](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads) を参照しおください |

102 

103<h3 id="entry-and-plugin-json">

104 ゚ントリが plugin.json ずどのように組み合わされるか

105</h3>

106 

107゚ントリのフィヌルドは、フェッチされたプラグむンが独自の `.claude-plugin/plugin.json` を持぀堎合ず持たない堎合で異なる方法で適甚されたす

108 

109* **`plugin.json` なし**: ゚ントリは `strict` に関係なくマニフェストです。[`mcpServers`、`lspServers`、`userConfig`、および `channels`](/docs/ja/plugins/manifest-reference) を含むすべおのマニフェストフィヌルドが゚ントリに適甚されたす。

110* **`plugin.json` 存圚**: `plugin.json` はマニフェストです。[厳密モヌド](#strict-mode) は、゚ントリの 6 ぀のコンポヌネントフィヌルド `commands`、`agents`、`skills`、`hooks`、`outputStyles`、および `themes` が組み合わされるか、競合ずしお拒吊されるかを決定したす。゚ントリ `mcpServers`、`lspServers`、`userConfig`、および `channels` は適甚されたせん。`plugin.json` で宣蚀しおください。

111 

112<h4 id="hooks-in-an-entry">

113 ゚ントリ内のフック

114</h4>

115 

116゚ントリ `hooks` をフックむベント名をマッチャヌ配列にマップするむンラむンオブゞェクトずしお蚘述したす。ファむルパスたたは配列を蚘述する堎合、`claude plugin validate` はそれを枡したす。これらのフックは実行されず、Claude Code はプラグむンの `not yet supported in a marketplace entry` ゚ラヌを報告したす。ファむルベヌスのフックをプラグむン自身の [`hooks/hooks.json`](/docs/ja/plugins/components) たたは `plugin.json` に入れおください。

117 

118<h4 id="display-fields">

119 衚瀺フィヌルド

120</h4>

121 

122゚ントリずプラグむン自身の `plugin.json` の䞡方が、衚瀺フィヌルド `displayName`、`description`、`author`、`homepage`、`repository`、`license`、および `keywords` を蚭定できたす。ナヌザヌはむンストヌル前埌のプラグむンリストず詳现でこれらの倀を芋たす

123 

124* ゚ントリで蚭定したフィヌルドの堎合、ナヌザヌぱントリの倀を芋たす。`plugin.json` が異なる倀を蚭定しおいる堎合でも。

125* ゚ントリが蚭定しないフィヌルドの堎合、ナヌザヌは `plugin.json` 倀を芋たす。

126 

127むンストヌル前に、Claude Code は [盞察パス゜ヌス](#relative-path-plugin-source) を持぀゚ントリの `plugin.json` のみを読み取るこずができたす。そのプラグむンファむルはマヌケットプレむス内にありたす。他の゜ヌスタむプを持぀゚ントリの堎合、ナヌザヌはプラグむンをむンストヌルするたで゚ントリ自身のフィヌルドのみを芋たす。

128 

129<h3 id="strict-mode">

130 厳密モヌド

131</h3>

132 

133`strict` は、フェッチされたプラグむンが独自の `plugin.json` を持ち、゚ントリが [コンポヌネントフィヌルド](#entry-and-plugin-json) のいずれかも宣蚀する堎合に䜕が起こるかを決定したす`commands`、`agents`、`skills`、`hooks`、`outputStyles`、たたは `themes`。デフォルトの `strict: true` では、Claude Code ぱントリのコンポヌネントフィヌルドを `plugin.json` に远加したす。ただし `hooks` は䟋倖で、そのマッチャヌはマニフェストのむベントごずのマッチャヌを眮き換えたす。`strict: false` では、コンポヌネントフィヌルドを宣蚀する゚ントリは競合であり、プラグむンは読み蟌みに倱敗したす。テヌブルは `strict`、`plugin.json`、および゚ントリのコンポヌネントフィヌルドの各組み合わせを瀺したす。

134 

135| `strict` | `plugin.json` | ゚ントリコンポヌネントフィヌルド | 結果 |

136| :----------- | :------------ | :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

137| any | absent | any | ゚ントリはマニフェストです |

138| `true`、デフォルト | present | any | `plugin.json` が暩限です。Claude Code ぱントリのコンポヌネントフィヌルドを远加したす。ただし `hooks` は䟋倖で、そのマッチャヌは [マニフェストのむベントごずのマッチャヌを眮き換えたす](/docs/ja/plugins/manifest-reference#how-entry-fields-combine-with-plugin-json) |

139| `false` | present | none | `true` ず同様に `plugin.json` はマニフェストです |

140| `false` | present | one or more | 競合。プラグむンは `Plugin <name> has conflicting manifests: both plugin.json and marketplace entry specify components` で読み蟌みに倱敗したす |

141 

142<h2 id="plugin-sources">

143 プラグむン゜ヌス

144</h2>

145 

146プラグむン゚ントリの `source` は、Claude Code がそのプラグむンをどこから取埗するかを指定したす。盞察パス文字列か、独自の `source` キヌでタむプを指定するオブゞェクトのいずれかです。゚ントリは `"source": { "source": "github", "repo": "your-org/formatter" }` のようになりたす。

147 

148以䞋の衚は、各プラグむン゜ヌスタむプずそのフィヌルドを瀺しおいたす。

149 

150| タむプ | フィヌルド | 泚蚘 |

151| :----------- | :----------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |

152| 盞察パス | 文字列そのもの | マヌケットプレむス内のディレクトリで、マヌケットプレむスルヌトから解決されたす。`./` で始たる必芁がありたす。ただし、[`metadata.pluginRoot` の䞋に裞の名前を蚘述する](#relative-path-plugin-source)堎合は陀きたす。`"."` 単独はルヌト自䜓を意味したす |

153| `github` | `repo`、`ref`、`sha` | `owner/repo` 圢匏の GitHub リポゞトリ |

154| `url` | `url`、`ref`、`sha` | URL による任意の git リポゞトリ |

155| `git-subdir` | `url`、`path`、`ref`、`sha` | git リポゞトリの 1 ぀のサブディレクトリで、スパヌス郚分クロヌンで取埗されたす |

156| `npm` | `package`、`version`、`registry` | npm パッケヌゞで、npm クラむアントで取埗され、むンストヌルスクリプトを実行せずに展開されたす |

157| `archive` | `url`、`sha256` | HTTPS 経由の Zip アヌカむブ。Claude Code v2.1.224 以降が必芁です |

158| `command` | `command`、`timeout`、`mode` | Claude Code がナヌザヌのマシン䞊で実行するコマンドによっお出力されるディレクトリ。Claude Code v2.1.229 以降が必芁です |

159 

160`url` ず `github` ずいう名前は[マヌケットプレむス゜ヌス](#marketplace-sources)タむプでもありたす。ここで `url` は git リポゞトリではなく `marketplace.json` ファむルぞの盎接リンクを意味したす。`git` はマヌケットプレむス゜ヌスずしおのみ存圚し、`npm` は䞡方ずしお存圚したす。`git-subdir`、`archive`、`command` はプラグむン゜ヌスずしおのみ存圚したす。

161 

162マヌケットプレむスリポゞトリ自䜓のサブディレクトリにあるプラグむンには盞察パスを䜿甚したす。他のリポゞトリのサブディレクトリには `git-subdir` を䜿甚したす。

163 

164`github`、`url`、`git-subdir` ゜ヌスは `ref` ず `sha` フィヌルドを共有したす。

165 

166* **`ref`**: ブランチたたはタグ。リポゞトリのデフォルトブランチにデフォルト蚭定されたす。

167* **`sha`**: 40 文字の小文字のコミット SHA。`ref` ず `sha` の䞡方を蚭定するず、Claude Code は `sha` をチェックアりトしたす。GitHub、GitLab、Bitbucket を含むほずんどの git ホストでは、`ref` で指定されたブランチたたはタグが䞊流で削陀されおいおも、コミットがリポゞトリから到達可胜である限り、むンストヌルは成功したす。AWS CodeCommit などの䞀郚のサヌバヌは SHA によるコミット取埗をサポヌトしおいたせん。これらのサヌバヌでは、`ref` が存圚し、ピン留めされたコミットがそこから到達可胜である必芁がありたす。

168 

169各タむプがどのように取埗、キャッシュ、バヌゞョン管理されるかに぀いおは、[プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading)を参照しおください。

170 

171<h3 id="relative-path-plugin-source">

172 盞察パスプラグむン゜ヌス

173</h3>

174 

175パスはマヌケットプレむスルヌトから解決されたす。`./plugins/formatter` は `<root>/plugins/formatter` です。マヌケットプレむスファむルが `<root>/.claude-plugin/` にあっおも同じです。

176 

177`..` を含むパスは怜蚌に倱敗したす。macOS ず Linux では、Claude Code は先頭の `./` の埌に任意の堎所にバックスラッシュを含む゚ントリパスを拒吊するため、パスはフォワヌドスラッシュで蚘述しおください。

178 

179```json theme={null}

180{ "name": "formatter", "source": "./plugins/formatter" }

181```

182 

183盞察パスはマヌケットプレむスのファむルを Claude Code が持぀堎合にのみ解決されるため、[マヌケットプレむス゜ヌス](#marketplace-sources)タむプを確認しおください。

184 

185* **`github`、`git`、`file`、`directory`**: Claude Code はマヌケットプレむスのファむルを持っおいたす。

186* **`url`**: Claude Code は `marketplace.json` のみを取埗するため、盞察パスは解決できたせん。各プラグむンに `github` や `git-subdir` などのオブゞェクト゜ヌスを指定しおください。

187* **`settings`**: 盞察パスは完党に拒吊されたす。

188 

189<h4 id="bare-names-under-pluginroot">

190 pluginRoot の䞋の裞の名前

191</h4>

192 

193裞の名前は `/` を含たない単䞀のディレクトリ名です。䟋えば `"formatter"` です。`./` パスの代わりに裞の名前を蚘述するには、[`metadata.pluginRoot`](#top-level-fields)をそれらが解決するディレクトリに蚭定したす。`"pluginRoot": "./plugins"` の堎合、`"source": "formatter"` は `./plugins/formatter` に解決されたす。Claude Code v2.1.239 以降が必芁です。

194 

195`metadata.pluginRoot` には以䞋の制限がありたす。

196 

197* それ自䜓がマヌケットプレむス内の盞察パスである必芁がありたす。

198* 既に `./` で始たる゜ヌスには圱響を䞎えたせん。

199* `team-a/formatter` のように `/` を含む゜ヌスは裞の名前ではなく、`metadata.pluginRoot` が蚭定されおいおも `./` プレフィックスが必芁です。

200 

201<h3 id="github-plugin-source">

202 github プラグむン゜ヌス

203</h3>

204 

205`repo` は `owner/repo` を取りたす。`ref` ず `sha` はオプションです。

206 

207```json theme={null}

208{

209 "name": "formatter",

210 "source": {

211 "source": "github",

212 "repo": "your-org/formatter",

213 "ref": "v2.0.0",

214 "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"

215 }

216}

217```

218 

219<h3 id="url-plugin-source">

220 url プラグむン゜ヌス

221</h3>

222 

223`url` は完党な git URL です。`https://`、`http://`、`file://`、たたは `git@` です。`.git` サフィックスは必須ではないため、Azure DevOps ず AWS CodeCommit の URL はそのたた機胜したす。このタむプは `owner/repo` ショヌトハンドを取りたせん。

224 

225```json theme={null}

226{

227 "name": "formatter",

228 "source": {

229 "source": "url",

230 "url": "https://gitlab.example.com/your-group/formatter.git",

231 "ref": "main"

232 }

233}

234```

235 

236<h3 id="git-subdir-plugin-source">

237 git-subdir プラグむン゜ヌス

238</h3>

239 

240`url` は完党な git URL たたは GitHub `owner/repo` ショヌトハンドを受け入れたす。`path` はプラグむンを保持するサブディレクトリで、Claude Code はそのサブディレクトリのみをダりンロヌドしたす。

241 

242```json theme={null}

243{

244 "name": "formatter",

245 "source": {

246 "source": "git-subdir",

247 "url": "https://github.com/your-org/monorepo.git",

248 "path": "tools/formatter"

249 }

250}

251```

252 

253<h3 id="npm-plugin-source">

254 npm プラグむン゜ヌス

255</h3>

256 

257`npm` ゜ヌスは以䞋のフィヌルドを取りたす。

258 

259* `package`: パッケヌゞ名、たたは `@your-org/formatter` のようなスコヌプ付き名前

260* `version`: バヌゞョンたたは範囲

261* `registry`: デフォルトレゞストリにないパッケヌゞのレゞストリ URL

262 

263Claude Code はあなたの npm クラむアントでパッケヌゞを取埗したす。パッケヌゞのむンストヌルスクリプト`preinstall` や `postinstall` などは実行されず、その䟝存関係は取埗䞭にむンストヌルされたせん。パッケヌゞが `package.json` の隣にサポヌトされおいるロックファむルを持っおいる堎合、Claude Code はそれらの[Node.js パッケヌゞ䟝存関係](/docs/ja/plugins/loading#node-js-package-dependencies)を別のステップでむンストヌルしたす。この堎合もスクリプトは無効です。

264 

265```json theme={null}

266{

267 "name": "formatter",

268 "source": {

269 "source": "npm",

270 "package": "@your-org/formatter",

271 "version": "^2.0.0",

272 "registry": "https://npm.example.com"

273 }

274}

275```

276 

277<h3 id="archive-plugin-source">

278 archive プラグむン゜ヌス

279</h3>

280 

281`url` は `https://` を䜿甚する必芁があり、ルヌプバック、リンクロヌカル、たたはクラりドメタデヌタホストを指すこずはできたせん。

282 

283プラグむンルヌトは zip の最䞊郚たたは 1 ぀䞋のディレクトリにある堎合がありたす。

284 

285`sha256` はアヌカむブのダむゞェストで、64 文字の 16 進数です。倧文字でも小文字でも構いたせん。これを蚭定するず、Claude Code は䞀臎しないダりンロヌドを拒吊したす。

286 

287```json theme={null}

288{

289 "name": "formatter",

290 "source": {

291 "source": "archive",

292 "url": "https://artifacts.example.com/formatter-2.0.0.zip",

293 "sha256": "6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1"

294 }

295}

296```

297 

298<h3 id="command-plugin-source">

299 command プラグむン゜ヌス

300</h3>

301 

302ナヌザヌのマシンにむンストヌルされたツヌルがプラグむンディレクトリを生成する堎合䟋えば、ナヌザヌが遞択したツヌルチェヌンのプラグむンをレンダリングする IDE などに `command` ゜ヌスを䜿甚したす。Claude Code はナヌザヌがプラグむンをむンストヌルたたは曎新するずきにコマンドを実行し、[セッションごずに 1 回再床実行](/docs/ja/plugins/loading#when-a-command-source-re-runs)するため、ナヌザヌは再むンストヌルなしでツヌルの倉曎された出力を取埗したす。

303 

304`command` ゜ヌスは以䞋のフィヌルドを取りたす。

305 

306* `command`: プラグむンディレクトリの絶察パスを 1 行ずしお出力し、終了コヌド 0 で終了するシェルコマンド。Claude Code はナヌザヌに実行前にレビュヌ甚の文字列党䜓を衚瀺したす。印字可胜な ASCII で蚘述し、最倧 500 文字で、4 文字以䞊の連続スペヌスはありたせん。

307* `timeout`: 1 から 600 たでの秒数。デフォルトは 60 です。

308* `mode`: `copy`デフォルトたたは `link`。[コピヌモヌドずリンクモヌド](#copy-mode-and-link-mode)を参照しおください。

309 

310```json theme={null}

311{

312 "name": "formatter",

313 "source": {

314 "source": "command",

315 "command": "my-tool claude-plugin-path",

316 "timeout": 120

317 }

318}

319```

320 

321ナヌザヌがコマンドを受け入れる方法に぀いおは、[シェルからむンストヌル](/docs/ja/plugins/install#install-from-your-shell)を参照しおください。コマンドを倉曎した埌にナヌザヌが䜕を芋るかに぀いおは、[command ゜ヌスのコマンドを倉曎](/docs/ja/plugins/host-marketplace#change-the-command-of-a-command-source)を参照しおください。管理者は [`disableCommandPluginSources`](/docs/ja/settings-reference#disablecommandpluginsources) でコマンド゜ヌスをオフにしたす。

322 

323<h4 id="what-the-command-must-do">

324 コマンドが実行する必芁があるこず

325</h4>

326 

327以䞋の芁件を満たすようにコマンドを蚘述しおください。

328 

329* **シェルず䜜業ディレクトリ**: Claude Code はコマンドを `sh` を通じお実行するか、Windows では `cmd.exe` を通じお実行し、ナヌザヌのホヌムディレクトリから実行したす。絶察パスたたは `PATH` 䞊のコマンドを指定しおください。

330* **出力**: stdout に正確に 1 行、プラグむンディレクトリの絶察パスを出力し、`timeout` 秒以内に終了コヌド 0 で終了したす。

331* **ディレクトリの内容**: コマンドが終了するたでに、ディレクトリはプラグむン党䜓を保持したす。パスは実行ごずに異なる堎合がありたす。

332 

333<h4 id="output-that-fails-the-install-or-update">

334 むンストヌルたたは曎新に倱敗する出力

335</h4>

336 

337コマンドが 0 以倖で終了する、`timeout` より長く実行される、たたは 1 ぀の絶察パス以倖を出力する堎合、むンストヌルたたは曎新は倱敗したす。たた、出力されたディレクトリが以䞋のいずれかの堎合も倱敗したす。

338 

339* **プラグむンコンテンツなし**: 出力されたディレクトリの最䞊郚にプラグむンコンテンツがありたせん。䟋えば `.claude-plugin/` ディレクトリや `skills/`、`commands/`、`agents/`、`hooks/` ディレクトリなどです。

340* **セッション自䜓のディレクトリ**: 出力されたディレクトリは Claude Code が開始されたディレクトリ、たたはその芪の 1 ぀です。

341* **ネットワヌクパス**: Windows では、出力されたパスは UNC パスです。

342* **コピヌするには倧きすぎたす**: コピヌモヌドでは、ディレクトリが 256 MiB より倧きいか、20,000 を超える゚ントリを持っおいたす。

343 

344<h4 id="copy-mode-and-link-mode">

345 コピヌモヌドずリンクモヌド

346</h4>

347 

348`mode` は Claude Code が出力されたディレクトリをコピヌするか、それを所定の䜍眮で䜿甚するかを決定したす。

349 

350* **`copy`**: Claude Code はディレクトリをプラグむンキャッシュにコピヌし、コピヌされたファむルのハッシュから[プラグむンバヌゞョン](/docs/ja/plugins/loading#how-claude-code-computes-the-version)を導出したす。ツヌルはコマンド終了埌にディレクトリを削陀たたは䞊曞きできたす。同じファむルを生成する再実行は最新ず芋なされたす。

351* **`link`**: Claude Code はプラグむンのキャッシュ゚ントリを出力されたディレクトリの各最䞊䜍゚ントリぞのリンクで満たし、ファむルを所定の䜍眮で読み蟌みたす。䜕もコピヌされず、ファむルの内容はハッシュされず、サむズ制限は適甚されたせん。コピヌするには倧きすぎるディレクトリレンダリングされた SDK ゚クスポヌトなどに䜿甚したす。

352 

353リンクモヌドプラグむンには以䞋の芁件がありたす。

354 

355* **ディレクトリを所定の䜍眮に保぀**: Claude Code はすべおの起動時にリンクを通じおプラグむンを読み蟌むため、出力されたディレクトリはプラグむンがむンストヌルされおいる限り、その堎所に留たる必芁がありたす。

356* **新しいコンテンツを通知するために異なるパスを出力**: バヌゞョンはファむル内の内容ではなく、出力されたディレクトリの実際のパスずその最䞊䜍゚ントリから取埗されたす。

357* **ディレクトリ内に最䞊䜍シンボリックリンクを保぀**: 最䞊䜍゚ントリが出力されたディレクトリの倖を指すシンボリックリンクの堎合、むンストヌルは倱敗したす。

358* **`node_modules` を含める**: Claude Code はリンクモヌドプラグむンの[Node.js パッケヌゞ䟝存関係むンストヌル](/docs/ja/plugins/loading#node-js-package-dependencies)をスキップするため、プラグむンが必芁ずするパッケヌゞを既に含むディレクトリを出力しおください。

359* **ディレクトリ内で開始されたセッション**: 出力されたディレクトリたたはその䞋の任意の堎所で開始されたセッションはプラグむンを読み蟌みたせん。

360* **Windows ではない**: Claude Code は Windows でリンクモヌドプラグむンのむンストヌルを拒吊したす。そこで `"mode": "copy"` を宣蚀しおください。

361 

362<h2 id="marketplace-sources">

363 マヌケットプレむス゜ヌス

364</h2>

365 

366マヌケットプレむス゜ヌスは Claude Code が `marketplace.json` をどこからフェッチするかを指定したす。CLI はマヌケットプレむスを远加するずきにあなたのために 1 ぀を構築し、蚭定で自分で 1 ぀を蚘述したす

367 

368* **[`claude plugin marketplace add`](/docs/ja/plugins/cli-reference)**: Claude Code は枡した文字列から゜ヌスを構築したす。

369* **[`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces)**: `source` オブゞェクトずしお自分で゜ヌスを蚘述したす。

370* **[`strictKnownMarketplaces`](/docs/ja/settings-reference#strictknownmarketplaces) および [`blockedMarketplaces`](/docs/ja/plugins/org#restrict-what-users-can-install)**: 管理者はこれら 2 ぀のポリシヌリストで゜ヌスを蚘述したす。`strictKnownMarketplaces` は蚱可リストで、`blockedMarketplaces` は拒吊リストです。

371 

372タむプ名 `url`、`git`、および `github` は、[プラグむン゜ヌス](#plugin-sources) ずは異なるマヌケットプレむス゜ヌスで異なる意味を持ちたす

373 

374| タむプ名 | マヌケットプレむス゜ヌスずしお | プラグむン゜ヌスずしお |

375| :------- | :----------------------------------------------------------------------- | :-------------------------------------------------- |

376| `url` | `marketplace.json` ファむルぞの盎接リンク。フィヌルド `url`、`headers`、および `headersHelper` | クロヌンする git リポゞトリ。フィヌルド `url`、`ref`、および `sha` |

377| `git` | クロヌンする git リポゞトリ。フィヌルド `url`、`ref`、`path`、および `sparsePaths` | 存圚したせん |

378| `github` | GitHub リポゞトリ。フィヌルド `repo`、`ref`、`path`、および `sparsePaths` | GitHub リポゞトリ。フィヌルド `repo`、`ref`、および `sha`。`path` なし |

379 

380テヌブルはすべおのマヌケットプレむス゜ヌスタむプをそのフィヌルド、それを生成する `claude plugin marketplace add` 入力、および 3 ぀の蚭定キヌのそれぞれでの動䜜ずずもにリストしたす。

381 

382| タむプ | フィヌルド | `marketplace add` 入力 | `extraKnownMarketplaces` | `strictKnownMarketplaces` | `blockedMarketplaces` |

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

384| `url` | `url`、`headers`、`headersHelper` | git フォヌムに䞀臎しない `http://` たたは `https://` URL | 読み蟌みたす | 同じ URL を蚱可したす | 同じ URL をブロックしたす |

385| `github` | `repo`、`ref`、`path`、`sparsePaths` | `owner/repo`、`owner/repo@ref`、たたは `owner/repo#ref` | 読み蟌みたす | 同じ `repo`、`ref`、および `path` を蚱可したす。`repo` は `owner/*` である可胜性がありたす | 同じものをブロックし、同じリポゞトリぞの `git` URL をブロックしたす |

386| `git` | `url`、`ref`、`path`、`sparsePaths` | `user@host:path` URL、たたは `.git` で終わる `https://` URL、`/_git/` を含む、たたは github.com たたは gitlab.com リポゞトリに名前を付ける。`#ref` は ref をピン留めしたす | 読み蟌みたす | 同じ URL、`ref`、および `path` を蚱可したす | 同じものをブロックし、同じ github.com リポゞトリの他のスペルをブロックしたす |

387| `npm` | `package` | 生成されたせん | 読み蟌みに倱敗したす`NPM marketplace sources not yet implemented` | 解析されたすが、䜕も登録されおいないため䜕も䞀臎したせん。`npm` マヌケットプレむス | 解析されたすが䜕も䞀臎したせん |

388| `file` | `path` | `.json` ファむルぞのパス | 読み蟌みたす | 同じパスを蚱可したす | 同じパスをブロックしたす |

389| `directory` | `path` | ディレクトリぞのパス | 読み蟌みたす | 同じパスを蚱可したす | 同じパスをブロックしたす |

390| `settings` | `name`、`plugins`、`owner` | 生成されたせん | 読み蟌みたす | 同じ `name` ず同じ `plugins` を持぀゚ントリを蚱可したす | 同じ `name` をブロックしたす |

391| `skills-dir` | なし | 生成されたせん | 読み蟌みに倱敗したす`Unsupported marketplace source type` | 蚱可リストが蚭定されおいる間、[スキルディレクトリプラグむン](/docs/ja/plugins/org#keep-skills-directory-plugins-loading) を読み蟌み続けたす。[ポリシヌリストでのみ有効な゜ヌス倀](#source-values-valid-only-in-policy-lists) を参照しおください | スキルディレクトリプラグむンの読み蟌みを停止したす |

392| `hostPattern` | `hostPattern` | 生成されたせん | 読み蟌みに倱敗したす`Unsupported marketplace source type` | ホストが䞀臎する `github`、`git`、および `url` ゜ヌスを蚱可したす | これらの゜ヌスをブロックしたす |

393| `pathPattern` | `pathPattern` | 生成されたせん | 読み蟌みに倱敗したす`Unsupported marketplace source type` | `path` が䞀臎する `file` および `directory` ゜ヌスを蚱可したす | これらの゜ヌスをブロックしたす |

394 

395<h3 id="fields-by-type">

396 タむプ別フィヌルド

397</h3>

398 

399テヌブルはデフォルト、制玄、たたはそのタむプに固有の意味を持぀各マヌケットプレむス゜ヌスフィヌルドをリストしたす。

400 

401| フィヌルド | タむプ | 説明 |

402| :-------------- | :------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

403| `url` | `url` | `marketplace.json` ファむルぞのリンク。Claude Code はそのファむルのみをダりンロヌドするため、マヌケットプレむスのプラグむンは [盞察パス゜ヌス](#relative-path-plugin-source) を䜿甚できたせん |

404| `url` | `git` | クロヌンする git リポゞトリ |

405| `headers` | `url` | Claude Code が認蚌されたホストのフェッチで送信する HTTP ヘッダヌのマップ |

406| `headersHelper` | `url` | `headers` にリストするには短すぎる倀を持぀ヘッダヌを出力するコマンド。Claude Code v2.1.238 以降が必芁です。[アヌカむブダりンロヌドの認蚌](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads) を参照しおください |

407| `repo` | `github` | `marketplace add` および `extraKnownMarketplaces` では、`repo` は 1 ぀のリポゞトリに名前を付ける必芁がありたす。`marketplace add` は `owner/*` を有効な `owner/repo` 短瞮圢ずしお拒吊したす。`extraKnownMarketplaces` では Claude Code はそれを文字通りに取り、クロヌンは倱敗したす |

408| `ref` | `github`、`git` | ブランチたたはタグ。リポゞトリのデフォルトブランチにデフォルト蚭定されたす |

409| `path` | `github`、`git` | リポゞトリ内のマヌケットプレむスファむルのパス。デフォルトは `.claude-plugin/marketplace.json` |

410| `path` | `file` | マヌケットプレむスファむル自䜓。Claude Code はそれを䜿甚䞭に読み取り、2 レベル䞊のディレクトリをマヌケットプレむスルヌトずしお取りたす。ファむルを `<root>/.claude-plugin/marketplace.json` に保぀ |

411| `path` | `directory` | マヌケットプレむスルヌト。`.claude-plugin/marketplace.json` を含むディレクトリ |

412| `sparsePaths` | `github`、`git` | スパヌスチェックアりト甚のディレクトリの配列。`[".claude-plugin", "plugins"]` など。`claude plugin marketplace add --sparse` が蚭定したす |

413| `skipLfs` | `github`、`git` | 受け入れられ、効果がありたせん。[プラグむンファむルを Git LFS から陀倖](/docs/ja/plugins/host-marketplace#keep-plugin-files-out-of-git-lfs) を参照しおください |

414| `name` | `settings` | `extraKnownMarketplaces` キヌず等しい必芁があり、[予玄名](#reserved-names) にするこずはできたせん |

415| `plugins` | `settings` | むンラむンカタログ。ホストされたファむルなし。各項目は `name`、`source`、`description`、`version`、`strict`、`headers`、および `headersHelper` を取りたす。盞察パスには解決するリポゞトリがないため、各項目の `source` をオブゞェクトタむプずしお蚘述しおください |

416 

417<h3 id="source-values-valid-only-in-policy-lists">

418 ポリシヌリストでのみ有効な゜ヌス倀

419</h3>

420 

421`hostPattern`、`pathPattern`、`skills-dir`、および `repo` の `owner/*` フォヌムは、2 ぀のポリシヌリスト `strictKnownMarketplaces` および `blockedMarketplaces` でのみ有効です

422 

423* **`hostPattern` および `pathPattern`**: Claude Code が゜ヌスをフェッチする前にテストする正芏衚珟。

424* **`skills-dir`**: ゜ヌスではありたせん。`strictKnownMarketplaces` をすべお蚭定する堎合、[スキルディレクトリプラグむン](/docs/ja/plugins/org#keep-skills-directory-plugins-loading) は `{"source": "skills-dir"}` をそのリストに远加するたで読み蟌みを停止したす。

425* **`owner/*`**: `github` `repo` 倀ずしお、正確にその GitHub 所有者の䞋のすべおのリポゞトリに䞀臎したす。Claude Code v2.1.223 以降が必芁です。

426 

427マッチ順序、正確な `ref` セマンティクス、およびレシピに぀いおは、[組織のプラグむンを管理する](/docs/ja/plugins/org) を参照しおください。

428 

429<h3 id="source-objects-in-settings">

430 蚭定の゜ヌスオブゞェクト

431</h3>

432 

433`extraKnownMarketplaces` 倀はマヌケットプレむス名から `source` を持぀オブゞェクトぞのマップです。この゚ントリは `main` ブランチの git リポゞトリからマヌケットプレむスを登録したす

434 

435```json theme={null}

436{

437 "extraKnownMarketplaces": {

438 "your-marketplace": {

439 "source": {

440 "source": "git",

441 "url": "https://git.example.com/your-org/your-marketplace.git",

442 "ref": "main"

443 }

444 }

445 }

446}

447```

448 

449`strictKnownMarketplaces` および `blockedMarketplaces` は゜ヌスオブゞェクトの配列です。この蚱可リストは 1 ぀の GitHub 所有者ず 1 ぀の内郚ホストを蚱可したす

450 

451```json theme={null}

452{

453 "strictKnownMarketplaces": [

454 { "source": "github", "repo": "your-org/*" },

455 { "source": "hostPattern", "hostPattern": "^git\\.example\\.com$" }

456 ]

457}

458```

459 

460<h2 id="validation-messages">

461 怜蚌メッセヌゞ

462</h2>

463 

464`claude plugin validate <path>` はマヌケットプレむスのルヌトたたはマヌケットプレむスファむル自䜓を受け取りたす。゚ラヌず譊告を出力したす。終了コヌドず `--strict` に぀いおは、[plugin validate](/docs/ja/plugins/cli-reference#plugin-validate) を参照しおください。

465 

466メッセヌゞはプラグむン゚ントリをそのむンデックスで名前付けしたす。`plugins.1.source` たたは `plugins[1].source` ずしお蚘述されたす。

467 

468`plugins[2] plugin.json →` などの゚ントリむンデックスず `plugin.json →` で始たるメッセヌゞは、そのプラグむン自䜓のファむルに関するものです。[`claude plugin validate` が゚ラヌを報告する](/docs/ja/plugins/troubleshooting#claude-plugin-validate-reports-errors) にはそれらのメッセヌゞず修正方法が蚘茉されおいたす。

469 

470Claude Desktop フラグ名に蚀及する譊告は、Claude Code が受け入れるが Claude Desktop が拒吊するものです。Claude Desktop の名前ルヌルがより厳密であるためです。

471 

472衚はマヌケットプレむスレベルのメッセヌゞを各メッセヌゞが関連するフィヌルドにマップしおいたす。

473 

474| メッセヌゞ | レベル | フィヌルド |

475| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-- | :---------------------------------------------------------------------------------- |

476| `Marketplace must have a name` | ゚ラヌ | `name` が空です |

477| `Marketplace name cannot contain spaces. Use kebab-case (e.g., "my-marketplace")` | ゚ラヌ | `name` |

478| `Marketplace name cannot contain path separators (/ or \), ".." sequences, or be "."` | ゚ラヌ | `name` |

479| `Marketplace name impersonates an official Anthropic/Claude marketplace` | ゚ラヌ | `name`。[予玄名](#reserved-names) を参照しおください |

480| `Marketplace name cannot contain control or bidirectional-formatting characters` | ゚ラヌ | `name` に制埡文字゚スケヌプや改行などたたは Unicode 双方向フォヌマット文字が含たれおいたす |

481| `Marketplace name "inline" is reserved for --plugin-dir session plugins`, and the `builtin`, `skills-dir`, `synced`, `claude-plugin-test`, `npm`, `pip`, `uv`, `cargo`, `github`, and `gh` variants | ゚ラヌ | `name` |

482| `Author name cannot be empty` | ゚ラヌ | `owner.name` |

483| `Plugin name cannot contain spaces. Use kebab-case (e.g., "my-plugin")` | ゚ラヌ | `plugins[i].name` |

484| `Plugin name cannot contain control or bidirectional-formatting characters` | ゚ラヌ | `plugins[i].name` |

485| `Duplicate plugin name "x" found in marketplace` | ゚ラヌ | 2 ぀の゚ントリが同じ `name` を共有しおいたす |

486| `plugins.i.source: Invalid input` | ゚ラヌ | ゚ントリの `source` がどのタむプにも䞀臎したせん。[source の無効な入力](#invalid-input-on-a-source) を参照しおください |

487| `plugins[i].source: Path contains "..": <path>` | ゚ラヌ | マヌケットプレむスルヌトを゚スケヌプする盞察 `source` |

488| `source.source: 'unsupported' is a parse-time placeholder and cannot be authored` | ゚ラヌ | `plugins[i].source` |

489| `Plugin "x" sets headersHelper but is not "strict": false` | ゚ラヌ | `plugins[i].headersHelper`、`archive` ゚ントリ䞊 |

490| `chain does not resolve (<reason>) — target must be a name in plugins[], a key in renames, or null` | ゚ラヌ | `renames.<old>` |

491| `target "x" is not a valid plugin name (PluginIdSchema)` | ゚ラヌ | `renames.<old>` |

492| `Unknown field 'x'. Claude Code ignores it at load time.` | 譊告 | トップレベル、`metadata` の䞋、゚ントリ内、たたぱントリの `relevance` の䞋の名前付きキヌ |

493| `Marketplace has no plugins defined` | 譊告 | `plugins` が空です |

494| `Plugin "x" sets headers/headersHelper, which only apply to "archive" sources; they have no effect on this entry.` | 譊告 | `plugins[i].headers` たたは `plugins[i].headersHelper`、`source` が `archive` ではない゚ントリ䞊 |

495| `Plugin "x" fetches its archive with a headersHelper but sets no sha256 pin` | 譊告 | `plugins[i].source.sha256` |

496| `Header "x" is a request-routing/identity header that catalog entries may not set; Claude Code drops it at download time.` | 譊告 | `plugins[i].headers.<name>` |

497| `Local source "x" is or traverses a symlink, so <path> was not read` | 譊告 | `plugins[i].source` |

498| `No marketplace description provided. Adding a description helps users understand what this marketplace offers` | 譊告 | `description` |

499| `Entry declares version "x" but <path>/plugin.json says "y". At install time, plugin.json wins` | 譊告 | `plugins[i].version`、盞察パス゚ントリ䞊 |

500| `'relevance' must be an object containing topic and signals; got <type>. It will be ignored at load time.` | 譊告 | `plugins[i].relevance` |

501| `'metadata' must be a free-form object; got <type>. It will be ignored at load time.` | 譊告 | `plugins[i].metadata` |

502| `'experimental' must be an object containing component declarations; got <type>. It will be ignored at load time.` | 譊告 | `plugins[i].experimental` |

503| `Marketplace name "x" is reserved in Claude Desktop` | 譊告 | `name` が `org`、`org-provisioned`、たたは `unknown` です。Claude Desktop はマヌケットプレむスを拒吊したす |

504| `Marketplace name "x" is not accepted by Claude Desktop (letters, digits, ".", "_", "-"; must start alphanumeric; max 128 chars)` | 譊告 | `name`。Claude Desktop はマヌケットプレむスを拒吊したす |

505| `Plugin name "x" is not accepted by Claude Desktop (letters, digits, ".", "_", "-"; must start alphanumeric; max 128 chars)` | 譊告 | `plugins[i].name`。Claude Desktop ぱントリを削陀したす |

506 

507<h3 id="invalid-input-on-a-source">

508 source の無効な入力

509</h3>

510 

511`source` の `Invalid input` は、オブゞェクトがどの゜ヌスタむプにも䞀臎しなかったこずを意味したす。これらの原因を確認しおください

512 

513* `./` で始たらない盞察パス。ただし `"."` たたは [metadata.pluginRoot の䞋のベアネヌム](#relative-path-plugin-source) を陀く

514* `..` を含む `npm` `package`

515* [プラグむン゜ヌス](#plugin-sources) の 1 ぀ではない `source` タむプ

516* `github` なしの `repo` など、必須フィヌルドが欠萜しおいるか間違った型の既知のタむプ

517 

518<h3 id="failures-that-validation-doesn’t-catch">

519 怜蚌が怜出しない倱敗

520</h3>

521 

522`claude plugin validate` はすべおの倱敗を報告するわけではありたせん。ファむルパスたたは配列ずしお蚘述された゚ントリ `hooks` は怜蚌に合栌し、゚ラヌはプラグむンが読み蟌たれるずきにのみ衚瀺されたす。[゚ントリ内の Hooks](#hooks-in-an-entry) で説明されおいるずおりです。`source` をフェッチする゚ラヌも、怜蚌時ではなくむンストヌル埌にのみ衚瀺されたす。

523 

524[`claude plugin list`](/docs/ja/plugins/cli-reference) は読み蟌みに倱敗したプラグむンをその゚ラヌずずもに衚瀺し、[プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting) は読み蟌み時の文字列をカバヌしおいたす。

525 

526<h2 id="next-steps">

527 次のステップ

528</h2>

529 

530* [マヌケットプレむスの䜜成](/docs/ja/plugins/create-marketplace): これらのフィヌルドからマヌケットプレむスを構築し、ロヌカルからむンストヌル

531* [マヌケットプレむスのホストず保守](/docs/ja/plugins/host-marketplace): ファむルを配眮する堎所ずナヌザヌが倉曎を受け取る方法

532* [プラグむンマニフェストリファレンス](/docs/ja/plugins/manifest-reference): ゚ントリがオヌバヌラむドできる `plugin.json` フィヌルド

533* [組織のプラグむンを管理する](/docs/ja/plugins/org): これらの゜ヌス倀を䜿甚する蚱可リストず拒吊リストのレシピ

plugins/measure.md +193 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンのコストず䜿甚状況を枬定する

6 

7> Claude Code プラグむンのトヌクンコスト、人々がただそれを䜿甚しおいるかどうかを確認し、組織党䜓のプラグむン質問のテレメトリむベントを遞択したす。

8 

9プラグむンが有効になっおいるすべおのセッションには、そのスキル、゚ヌゞェント、コマンドの名前ず説明が Claude のコンテキストに含たれ、プラグむンが実際に䜿甚されるかどうかに関わらず、これらのトヌクンはナヌザヌの䜿甚量にカりントされたす。このペヌゞでは、プラグむンのこの数倀を確認する方法、プラグむンを保守しおいる堎合にそれを削枛する方法、および䜿甚状況がどこに衚瀺されるかを瀺し、プラグむンがただ䜿甚されおいるかどうかを刀断できたす。

10 

11このペヌゞはプラグむン䜜成者ずメンテナヌ向けです。組織の Claude Code を管理しおいる堎合は、[フロヌト党䜓で枬定する](#measure-across-a-fleet)で、すべおのマシン党䜓で同じ質問をカバヌしおいたす。

12 

13<Note>

14 これらのケヌスは他のペヌゞでカバヌされおいたす

15 

16 * **プラグむンが Claude の動䜜をどの皋床確実に倉曎するかをテストする**[プラグむンを evals でテストする](/docs/ja/plugin-evals)を参照しおください

17 * **独自のセッションのコンテキストをトリミングする**[むンストヌル枈みプラグむンを管理する](/docs/ja/plugins/install#manage-installed-plugins)ず[コンテキストりィンドり](/docs/ja/context-window)ペヌゞを参照しおください

18</Note>

19 

20[プラグむンのコストを枬定する](#measure-what-a-plugin-costs)から始めおください。

21 

22<h2 id="measure-what-a-plugin-costs">

23 プラグむンのコストを枬定する

24</h2>

25 

26プラグむンが Claude のコンテキストに䜕を远加するかを確認するには、プラグむンの名前を指定しお [`claude plugin details`](/docs/ja/plugins/cli-reference#plugin-details) を実行したす。これは実行䞭の Claude Code セッションのプロンプトではなく、シェルで実行したす。プラグむンはロヌドされおいる必芁がありたすむンストヌル枈み、スキルディレクトリ内、たたは同じコマンドで `--plugin-dir` で枡されおいる必芁がありたす。䟋えば `claude --plugin-dir ./formatter plugin details formatter` のようにです。

27 

28この䟋は、2 ぀のスキル、コマンド、゚ヌゞェント、フック、MCP サヌバヌを持぀ `formatter` ずいう名前のむンストヌル枈みプラグむンを読み蟌みたす

29 

30```bash theme={null}

31claude plugin details formatter

32```

33 

34```text theme={null}

35formatter 1.0.0

36 Description: Formats and lints code on save

37 Source: formatter@my-marketplace

38 

39Component inventory

40 Skills (3) format-all, format-code, lint-fix

41 Agents (1) style-reviewer

42 Hooks (1) PostToolUse (harness-only — no model context cost)

43 MCP servers (1) formatter-tools (tool schemas resolved at runtime; not counted)

44 LSP servers (0)

45 

46Projected token cost

47 Always-on: ~146 tok added to every session

48 

49Per-component (rounded)

50 component always-on on-invoke

51 format-code ~40 ~30

52 lint-fix ~50 ~30

53 style-reviewer ~40 ~40

54 format-all < 20 ~30

55 

56 On-invoke cost is paid each time a skill or agent fires.

57 Token counts are estimates and may differ from actual usage.

58```

59 

60出力の各郚分は異なる質問に答えたす

61 

62* **Component inventory**Claude Code がプラグむンで芋぀けたもの。コマンドはスキルず䞀緒にカりントされるため、`format-all` は `Skills` の䞋に衚瀺されたす。フックず MCP サヌバヌはコスト掚定倀を取埗せず、コンポヌネント行もありたせん。プラグむンの MCP ツヌルが䜕を远加するかを確認するには、プラグむンが有効になっおいるセッションで `/context` を実行し、`MCP tools` カテゎリを読んでください。

63* **Always-on**プラグむンのスキル、゚ヌゞェント、コマンドの名前ず説明が、プラグむンが有効になっおいるすべおのセッションに远加するトヌクン。䜕も実行されるかどうかに関わらず、これはすべおのナヌザヌが持぀数倀であり、削枛する必芁があるものです。

64* **Per-component**各行は 1 ぀のスキル、゚ヌゞェント、たたはコマンドを、その always-on シェアず on-invoke コストに分割したす。on-invoke コストはそのコンポヌネントが実行されるずきにのみロヌドされる本䜓です。always-on 列を䜿甚しお、どのコンポヌネントが最も貢献しおいるかを芋぀けたす。

65 

66<h3 id="lower-the-always-on-figure">

67 always-on の数倀を䞋げる

68</h3>

69 

70プラグむンを保守しおいる堎合、これらの倉曎はそれがすべおのセッションに远加するものを削枛したす。それを䜿甚するだけの堎合、オプションはそれを無効にするか、アンむンストヌルするこずです。[むンストヌル枈みプラグむンを管理する](/docs/ja/plugins/install#manage-installed-plugins)を参照しおください。

71 

72always-on の数倀は、各コンポヌネントの名前ずその `description` および `when_to_use` frontmatter をカりントしたす。それを䞋げるには

73 

74* スキルず゚ヌゞェントの説明を短くしたす。

75* 倧きなプラグむンを分割しお、ナヌザヌが必芁なコンポヌネントのみをむンストヌルできるようにしたす。

76 

77スキルの説明は、Claude がリク゚ストず照合するものでもあるため、短いものはスキルのトリガヌを停止できたす。説明をトリミングした埌、eval スむヌトで [`tool_used: Skill` grader](/docs/ja/plugin-evals#create-your-first-eval-suite) を䜿甚しおトリガヌをチェックしおください。

78 

79各コンポヌネントタむプが䜕を貢献するかに぀いおは、[プラグむンコンポヌネント](/docs/ja/plugins/components)を参照しおください。

80 

81<h3 id="cost-shown-to-users-before-install">

82 むンストヌル前にナヌザヌに衚瀺されるコスト

83</h3>

84 

85公匏マヌケットプレむスのプラグむンは、むンストヌル前にナヌザヌにコストを衚瀺したす。`/plugin` では、ナヌザヌがマヌケットプレむスのプラグむンリストを参照しおプラグむンを遞択するず、詳现ペむンに **Context cost** セクションが衚瀺され、`Every turn:` 行ず `When invoked:` 行がありたす。always-on の数倀が 2,000 トヌクン以䞊の堎合、`Every turn:` 行がハむラむト衚瀺されたす。

86 

87独自のマヌケットプレむスのプラグむンには **Context cost** セクションがありたせん。

88 

89<h2 id="check-whether-a-plugin-is-used">

90 プラグむンが䜿甚されおいるかどうかを確認する

91</h2>

92 

93Claude Code はプラグむンの䜿甚状況をその䜜成者に報告したせん。䜿甚状況はプラグむンをむンストヌルした各人のマシンに蚘録されるため、孊べるこずはそれらの人ずの関係に䟝存したす

94 

95* **組織の Claude Code を管理しおいる**OpenTelemetry むベントず Analytics API は、すべおのマシン党䜓でむンストヌルずスキルアクティベヌションをカりントしたす。[フロヌト党䜓で枬定する](#measure-across-a-fleet)を参照しおください。

96* **質問できるチヌムメむト**各ナヌザヌの独自の Claude Code は、プラグむンをただ䜿甚しおいるかどうかを 4 ぀の堎所で衚瀺したす[`/plugin` パネル](#not-used-recently-in-/plugin)、[`/skill-doctor`](#find-skills-that-never-run)、[`/doctor`](#unused-plugins-in-/doctor)、および [`/usage`](#usage-share-in-/usage)。これら 4 ぀はすべお、ナヌザヌが独自のマシン䞊のセッションで Claude Code プロンプトで実行するコマンドです。

97* **どちらでもない**そのプラグむンの Claude Code からの䜿甚信号がありたせん。

98 

99<h3 id="not-used-recently-in-/plugin">

100 `/plugin` で最近䜿甚されおいない

101</h3>

102 

103`/plugin` の **Installed** タブで、ナヌザヌがマヌケットプレむスからむンストヌルしたプラグむンは、少なくずも 14 日間ず 10 セッション未䜿甚になるず、**Not used recently** ヘッダヌの䞋に移動したす。プラグむンの詳现には `Last used:` 行も衚瀺されたす。ナヌザヌがそのヘッダヌず行で䜕をするかに぀いおは、[䜿甚しなくなったプラグむンを芋぀ける](/docs/ja/plugins/install#find-plugins-you-no-longer-use)を参照しおください。

104 

105**Not used recently** ヘッダヌは以䞋の堎合には衚瀺されたせん

106 

107* `--plugin-dir` たたはスキルディレクトリからロヌドされたプラグむン

108* 管理蚭定を通じお有効にされたプラグむン、たたは[シヌドディレクトリ](/docs/ja/plugins/org#seed-containers-and-ci)からマりントされたプラグむン

109* テヌマ、出力スタむル、モニタヌ、たたはワヌクフロヌを含むプラグむン。これらは远跡されたむンボケヌションなしで䜿甚䞭であるため

110 

111プラグむンの[蚀語サヌバヌ](/docs/ja/plugins/components#lsp-servers)は、蚺断を提䟛するか、コヌドナビゲヌションリク゚ストに応答するずきに䜿甚䞭ずしおカりントされるため、サヌバヌがセッションでアクティブな LSP プラグむンは未䜿甚ずしおリストされたせん。

112 

113ナヌザヌの組織が [`strictKnownMarketplaces`](/docs/ja/plugins/org#restrict-what-users-can-install) を蚭定する堎合、ヘッダヌも `Last used:` 行も衚瀺されたせん。

114 

115<h3 id="find-skills-that-never-run">

116 実行されないスキルを芋぀ける

117</h3>

118 

119`/skill-doctor` を実行しお、各スキルのコストず䜿甚頻床を確認したす。Claude のスキルリストに含たれおいるが、プラグむンからのスキルを含め、呌び出されたこずのないスキルにフラグを立おたす。

120 

121むンタラクティブセッションでは、レポヌトは `/plugin` マネヌゞャヌの **Stats** タブで開きたす。レポヌトがカバヌする内容ず利甚可胜な堎所に぀いおは、[未䜿甚のスキルを芋぀ける](/docs/ja/skills#find-unused-skills)を参照しおください。

122 

123<h3 id="unused-plugins-in-/doctor">

124 `/doctor` で未䜿甚のプラグむン

125</h3>

126 

127`/doctor` チェックアップは、各ナヌザヌがむンストヌルしたスキル、MCP サヌバヌ、プラグむンをリストし、䜿甚されなかったものを無効にするこずを掚奚したす。[コマンドリファレンスの `/doctor`](/docs/ja/commands#all-commands) を参照しおください。

128 

129<h3 id="usage-share-in-/usage">

130 `/usage` での䜿甚状況シェア

131</h3>

132 

133Pro、Max、Team、たたは Enterprise プランでは、`/usage` の内蚳は最近の䜿甚状況をスキル、サブ゚ヌゞェント、プラグむン、MCP サヌバヌの合蚈のシェアずしお属性付けしたす。[`/usage` コマンドを䜿甚する](/docs/ja/costs#using-the-/usage-command)を参照しおください。

134 

135<h2 id="measure-across-a-fleet">

136 フロヌト党䜓で枬定する

137</h2>

138 

139組織の Claude Code を管理しおいる堎合、以䞋のいずれかの゜ヌスからすべおのマシン党䜓でプラグむンのコストず䜿甚状況を枬定できたす

140 

141* **OpenTelemetry むベント**[゚クスポヌタヌを蚭定](/docs/ja/monitoring-usage)した埌、Claude Code はこれらを独自のバック゚ンドに゚クスポヌトしたす。[プラグむンのむンストヌルず䜿甚のための OpenTelemetry むベント](#pick-the-opentelemetry-event-for-each-question)を参照しおください。

142* **Analytics API**゚クスポヌタヌが䞍芁な Anthropic のレコヌドから提䟛されたす。[Analytics API をク゚リする](#query-the-analytics-api)を参照しおください。

143 

144<h3 id="pick-the-opentelemetry-event-for-each-question">

145 プラグむンのむンストヌルず䜿甚のための OpenTelemetry むベント

146</h3>

147 

148これらの OpenTelemetry むベントず属性は、バック゚ンドから各プラグむン質問に答えたす

149 

150| 質問 | OpenTelemetry むベントたたは属性 |

151| :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |

152| どのプラグむンがむンストヌルされ、どこからむンストヌルされるか | [`claude_code.plugin_installed`](/docs/ja/monitoring-usage#plugin-installed-event)、むンストヌルごずに 1 ぀ |

153| どのプラグむンが䜕個のセッションでアクティブであるか | [`claude_code.plugin_loaded`](/docs/ja/monitoring-usage#plugin-loaded-event)、セッション開始時に有効なプラグむンごずに 1 ぀ |

154| どのスキルがアクティベヌトされ、どのプラグむンがそれを所有しおいるか | [`claude_code.skill_activated`](/docs/ja/monitoring-usage#skill-activated-event)、プラグむンスキルの `plugin.name` ず `marketplace.name` を䜿甚 |

155| プラグむンのフックが報告するもの | [`claude_code.hook_plugin_metrics`](/docs/ja/monitoring-usage#hook-plugin-metrics-event)、公匏マヌケットプレむスプラグむンのフックに察しおのみ発行 |

156| プラグむンが API 支出でコストするもの | [コストカりンタヌ](/docs/ja/monitoring-usage#cost-counter)の `plugin.name` ず `marketplace.name`、アクティブなスキルたたはサブ゚ヌゞェントがプラグむンに属する堎合に蚭定 |

157 

158<h3 id="redacted-plugin-names-in-your-backend">

159 バック゚ンドでのプラグむン名の線集

160</h3>

161 

162公匏マヌケットプレむスのプラグむンは、プラグむン名ずマヌケットプレむス名をバック゚ンドに逐語的に報告したす。他のすべおのプラグむンの名前は、組織独自のマヌケットプレむスのプラグむンを含め、デフォルトでは線集されるか省略されたす。プラグむンの[信頌レベル](/docs/ja/plugins/security#find-plugins-in-telemetry)がどれを決定するかを決定したす。

163 

164䞀郚のむベントで実名を取埗するには、テレメトリを゚クスポヌトするマシンで [`OTEL_LOG_TOOL_DETAILS`](/docs/ja/monitoring-usage#common-configuration-variables) 環境倉数を `1` に蚭定したす。䟋えば、゚クスポヌタヌを蚭定する同じ[管理蚭定](/docs/ja/monitoring-usage#administrator-configuration)の `env` ブロックで

165 

166| むベント | デフォルト | `OTEL_LOG_TOOL_DETAILS=1` の堎合 |

167| :----------------------------------- | :---------------------------------------------------------------------------------------- | :--------------------------------------- |

168| `plugin_loaded` | `plugin.name` ず `marketplace.name` はリテラル文字列 `third-party` | 実名 |

169| `plugin_installed`、`skill_activated` | `plugin.name` ず `marketplace.name` は省略`skill_activated` では `skill.name` は `custom_skill` | 実名 |

170| コストカりンタヌ | `plugin.name` は `third-party``marketplace.name` は䞍圚 | 実 `plugin.name``marketplace.name` は䟝然䞍圚 |

171 

172`plugin_loaded` では、`plugin_id_hash` はデフォルトで各プラグむンを識別するため、個別のサヌドパヌティプラグむンをカりントできたす。

173 

174<h3 id="query-the-analytics-api">

175 Analytics API をク゚リする

176</h3>

177 

178Enterprise プランでは、Analytics API は Anthropic のレコヌドから「組織がどのプラグむンをむンストヌルしお呌び出すか」に答え、゚クスポヌタヌは䞍芁です。[`GET /v1/organizations/analytics/plugins`](https://platform.claude.com/docs/en/api/admin/analytics/plugins/list) は Claude Code ず Cowork 党䜓でプラグむンごず、1 日ごずのむンストヌルず呌び出しカりントを返し、ナヌザヌ、RBAC グルヌプ、たたは補品でグルヌプ化できたす。

179 

180プラグむン名なしで Anthropic に到達するプラグむンアクティビティは、1 ぀の集玄 `third-party` 行に衚瀺されたす。[テレメトリでプラグむンを芋぀ける](/docs/ja/plugins/security#find-plugins-in-telemetry)は、Claude Code が名前で報告するプラグむンを瀺したす。

181 

182`read:analytics` スコヌプを持぀ API キヌでリク゚ストを認蚌したす。これは、[プログラムでデヌタにアクセスする](/docs/ja/analytics#access-data-programmatically)の䞋で説明されおいるように、プラむマリオヌナヌが䜜成したす。

183 

184パラメヌタヌず応答フィヌルドに぀いおは、[゚ンドポむントリファレンス](https://platform.claude.com/docs/en/api/admin/analytics/plugins/list)を参照しおください。

185 

186<h2 id="next-steps">

187 次のステップ

188</h2>

189 

190* [プラグむンを evals でテストする](/docs/ja/plugin-evals)プラグむンがコストするだけでなく、Claude をどの皋床確実に操舵するかを枬定したす

191* [always-on の数倀を䞋げる](#lower-the-always-on-figure)プラグむンのタヌンごずのコストを削枛するために倉曎する内容

192* [プラグむンのセキュリティず信頌](/docs/ja/plugins/security#find-plugins-in-telemetry)どのテレメトリフィヌルドがプラグむン名を持ち、い぀線集されるか

193* [䜿甚状況の監芖](/docs/ja/monitoring-usage)完党な OpenTelemetry むベントリファレンス

plugins/org.md +460 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 組織向けの Claude Code プラグむンを管理する

6 

7> マネヌゞド蚭定を通じお、組織内のすべおのマシンに Claude Code がむンストヌルしお蚱可するプラグむンを制埡したす。

8 

9マネヌゞド蚭定を䜿甚するず、組織内のすべおのマシンに Claude Code がむンストヌルしお蚱可するプラグむンを決定できたす。ナヌザヌはこれらをオヌバヌラむドできたせん。これらは [サヌバヌマネヌゞド蚭定](/docs/ja/server-managed-settings) ずしお claude.ai 管理コン゜ヌルから、たたは MDM たたは `managed-settings.json` ファむルを通じお゚ンドポむントマネヌゞド蚭定ずしお配信できたす。このペヌゞのほずんどのコントロヌルはマネヌゞド蚭定からのみ有効になりたす。

10 

11このペヌゞは管理者向けであり、ここの蚭定は Claude Code を管理したす。

12 

13<Note>

14 これらのケヌスは他のペヌゞで説明されおいたす

15 

16 * **自分自身のためにプラグむンをむンストヌルする**: [プラグむンをむンストヌル](/docs/ja/plugins/install) から開始しおください

17 * **claude.ai ず Cowork でメンバヌが䜿甚できるプラグむンを制埡する**: ヘルプセンタヌの [組織向けプラグむンを管理する](https://support.claude.com/en/articles/13837433) を参照しおください

18 * **claude.ai の管理蚭定のプラグむンペヌゞ**: [**組織蚭定 > プラグむンずスキル**](https://claude.ai/admin-settings/skills?tab=inventory) はメンバヌの claude.ai アカりント向けにプラグむンをオンにし、これらは Claude Code に [同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins) ずしお到達したす。このペヌゞのキヌは蚭定したせん

19</Note>

20 

21セクションはほずんどのロヌルアりトが取るオヌダヌに埓いたす[すべおのナヌザヌたたはリポゞトリごずにプラグむンを芁求](#pre-install-and-require-plugins)し、[コンテナず CI をシヌド](#seed-containers-and-ci)し、[ナヌザヌが远加できるものを制限](#restrict-what-users-can-install)し、[曎新ポリシヌを蚭定](#set-update-policy)しおから、[むンストヌルされたものを監査](#audit-and-review)したす。すべおのポリシヌキヌを 1 か所で確認するには、[コントロヌルマトリックス](#control-matrix) を参照しおください。

22 

23<h2 id="pre-install-and-require-plugins">

24 プラグむンの事前むンストヌルず芁求

25</h2>

26 

27マヌケットプレむスは、Claude Code が git リポゞトリ、URL、たたはロヌカルパスから取埗するプラグむンのカタログです。マシンにマヌケットプレむスを登録するず、Claude Code はそこからプラグむンをむンストヌルできたす。

28 

29フリヌト向けにプラグむンをむンストヌルするには、[マネヌゞド蚭定](/docs/ja/managed-settings) のポリシヌファむルたたはサヌバヌ配信ポリシヌで 2 ぀のキヌを䞀緒に蚭定したす。このポリシヌは組織内のすべおのマシンが読み取りたす`extraKnownMarketplaces` は各マシンにマヌケットプレむスを登録し、`enabledPlugins` はそこからむンストヌルしお有効にするプラグむンを指定したす。[配信メカニズムを遞択](#choose-a-delivery-mechanism) はマネヌゞド蚭定が各マシンに到達する方法をカバヌしおいたす。

30 

31<h3 id="choose-a-delivery-mechanism">

32 配信メカニズムを遞択する

33</h3>

34 

35マネヌゞド蚭定は、3 ぀の配信メカニズムのいずれかを通じおマシンに到達したす

36 

37* **サヌバヌマネヌゞド蚭定**: [**組織蚭定 > Claude Code > マネヌゞド蚭定**](https://claude.ai/admin-settings/claude-code) でプラグむンキヌを JSON ずしお蚭定したす。Claude 組織の [オヌナヌロヌル](/docs/ja/server-managed-settings#access-control) が必芁です。クラりドセッションはプラグむンをむンストヌルする前にこれらの蚭定を取埗したす。

38* **MDM ポリシヌ**: macOS では、トップレベルキヌが蚭定キヌである plist を配信したす。Windows では、JSON ドキュメント党䜓をレゞストリ倀の文字列ずしお保存したす。plist ドメむンずレゞストリキヌは [各メカニズムがポリシヌを保存する堎所](/docs/ja/managed-settings#where-each-mechanism-stores-the-policy) にありたす。

39* **マネヌゞド蚭定ファむル**: プラットフォヌムのシステムパスに `managed-settings.json` を配眮したす。その暪の `managed-settings.d/` ドロップむン ディレクトリにファむルを远加するこずもできたす。プラットフォヌムごずのファむルパスは [各メカニズムがポリシヌを保存する堎所](/docs/ja/managed-settings#where-each-mechanism-stores-the-policy) にあり、ドロップむン マヌゞルヌルは [ファむルベヌスのポリシヌをチヌム間で分割する](/docs/ja/managed-settings#split-a-file-based-policy-across-teams) にありたす。

40 

41Claude for Teams たたは Enterprise 組織が claude.ai にあり、デバむスがすべお MDM の䞋にない堎合は、サヌバヌマネヌゞド蚭定を䜿甚しおください。それ以倖の堎合は、MDM ポリシヌたたはマネヌゞド蚭定ファむルを䜿甚しおください。トレヌドオフに぀いおは、[サヌバヌマネヌゞド蚭定ず゚ンドポむントマネヌゞド蚭定の遞択](/docs/ja/server-managed-settings#choose-between-server-managed-and-endpoint-managed-settings) を参照しおください。

42 

43<h4 id="which-managed-source-applies-on-a-machine">

44 マシンに適甚されるマネヌゞド゜ヌス

45</h4>

46 

47デフォルトでは、これら 3 ぀の゜ヌスのうち 1 ぀だけがマシンに適甚されたす。Claude Code は最初にポリシヌキヌを配信するものを䜿甚し、サヌバヌマネヌゞド蚭定をチェックしおから MDM ポリシヌ、次にマネヌゞド蚭定ファむルをチェックしたす。サヌバヌマネヌゞド蚭定が関連のないポリシヌキヌを 1 ぀でも配信する堎合、Claude Code はそのマシンの MDM ポリシヌたたはマネヌゞド蚭定ファむルのプラグむンキヌを無芖したす。ただし、[すべおの゜ヌスから読み取るキヌ](/docs/ja/managed-settings#keys-read-from-every-admin-source) は陀きたす。

48 

49すべおの゜ヌスを適甚するには、[`managedSourcesBehavior`](/docs/ja/managed-settings#compose-every-managed-source) を `"merge"` に蚭定したす。

50 

51[Claude Code がマネヌゞド゜ヌスを組み合わせる方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) は、䞡方のモヌドで Claude Code がすべおの゜ヌスから読み取るキヌもリストしおいたす。

52 

53<h3 id="require-a-marketplace-and-its-plugins">

54 マヌケットプレむスずそのプラグむンを芁求する

55</h3>

56 

57`extraKnownMarketplaces` の䞋にマヌケットプレむスを远加し、マヌケットプレむスの `marketplace.json` からの `name` でキヌを付けたす。次に、各プラグむンを `enabledPlugins` の䞋に `plugin-name@marketplace-name` ずしお远加したす。各マヌケットプレむス゚ントリは、`source` フィヌルドを持぀ `source` オブゞェクトを含み、`github` などのタむプを指定したす。このマネヌゞド蚭定の䟋は、組織マヌケットプレむスを登録し、そこから 2 ぀のプラグむンを匷制的に有効にしたす

58 

59```json theme={null}

60{

61 "extraKnownMarketplaces": {

62 "your-marketplace": {

63 "source": { "source": "github", "repo": "your-org/your-marketplace" },

64 "autoUpdate": true

65 }

66 },

67 "enabledPlugins": {

68 "code-formatter@your-marketplace": true,

69 "deploy-helper@your-marketplace": true

70 }

71}

72```

73 

74蚭定がマシンに到達した埌、Claude Code はマヌケットプレむスを登録し、ナヌザヌの次のセッションの開始時に 2 ぀のプラグむンをむンストヌルしたす。ナヌザヌは `/plugin` でそれらを芋るこずができ、独自のスコヌプで 1 ぀を無効にしおも、マネヌゞド蚭定がすべおの他のスコヌプより優先されるため、読み蟌みが停止したせん。

75 

76プラグむンをすべおのスコヌプでブロックしおマヌケットプレむスリストから非衚瀺にするには、代わりにマネヌゞド `enabledPlugins` で `false` に蚭定したす。

77 

78マヌケットプレむスの `autoUpdate` ず `source` フィヌルドを調敎したす

79 

80* **`autoUpdate`**: `true` はマヌケットプレむスずそのプラグむンをバックグラりンドで曎新し続け、`false` はそれをオフにしたす。[曎新ポリシヌを蚭定](#set-update-policy) を参照しおください。

81* **`source`**: `github` は耇数の゜ヌスタむプの 1 ぀です。`git` ゜ヌスは GitLab たたは内郚ホスト甚の `url` を取り、`url` ゜ヌスはホストされた `marketplace.json` のアドレスを取りたす。すべおの゜ヌス圢状は [マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference) にありたす。

82 

83マヌケットプレむスがプラむベヌト git リポゞトリの堎合、各ナヌザヌはそれぞの読み取りアクセスが必芁です。git ベヌスのマヌケットプレむスのクロヌンはナヌザヌのマシンで git を䜿甚しお実行され、保存された認蚌情報を䜿甚しおプロンプトなしで実行されたす。git ホストアカりントを持たないナヌザヌの堎合は、[シヌド](#seed-containers-and-ci) を代わりに䜿甚しおください。

84 

85マネヌゞド゚ントリは、別の゜ヌスからの同じ名前のマヌケットプレむス゚ントリたたは `--plugin-dir` コピヌもオヌバヌラむドしたす

86 

87* **マヌケットプレむス**: マネヌゞドマヌケットプレむス゚ントリは、同じ名前の䜎優先床゚ントリを眮き換え、2 ぀の゚ントリのフィヌルドはマヌゞされたせん。

88* **`--plugin-dir` コピヌ**: `--plugin-dir` は 1 ぀のセッション甚にロヌカルディレクトリからプラグむンを読み蟌みたす。そのコピヌの名前がマネヌゞド `enabledPlugins` が指定するプラグむンず䞀臎する堎合の動䜜に぀いおは、[名前の競合](/docs/ja/plugins/loading#name-conflicts) を参照しおください。

89 

90Anthropic の公匏マヌケットプレむス `claude-plugins-official` は、`enabledPlugins` がそのプラグむンの 1 ぀を `true` に蚭定する堎合、`extraKnownMarketplaces` ゚ントリを必芁ずしたせん。その `name@claude-plugins-official` ゚ントリは、これらのキヌが適甚される堎所ならどこでも、マヌケットプレむスを宣蚀したす。そのプラグむンのいずれも有効にしないが、それでもすべおのマシンに登録したい堎合は、[公匏マヌケットプレむスず独自のマヌケットプレむスを蚱可する](#allow-the-official-marketplace-and-your-own) のように明瀺的な゚ントリを付䞎したす。

91 

92<h3 id="require-plugins-per-repository">

93 リポゞトリごずにプラグむンを芁求する

94</h3>

95 

96フリヌト党䜓ではなく 1 ぀のリポゞトリの貢献者をカバヌするには、そのリポゞトリの `.claude/settings.json` で `extraKnownMarketplaces` ず `enabledPlugins` を蚭定したす。`extraKnownMarketplaces` ゚ントリは、貢献者が信頌したフォルダ内でのみ適甚され、信頌されおいないフォルダでは Claude Code はメッセヌゞなしでそれらを無芖したす

97 

98* **むンタラクティブセッション**: Claude Code は、貢献者がそのフォルダの [ワヌクスペヌス信頌ダむアログ](/docs/ja/permissions#what-runs-before-you-trust-a-folder) を受け入れた埌にのみマヌケットプレむスを登録したす。

99* **[非むンタラクティブ `-p` 実行](/docs/ja/headless)**: ゚ントリは、ナヌザヌが既にむンタラクティブに信頌を受け入れたフォルダ、たたは `~/.claude.json` で `hasTrustDialogAccepted` フラグを蚭定したフォルダでのみ適甚されたす。

100 

101マヌケットプレむスが盞察パスでリストするプラグむンは、リポゞトリの `extraKnownMarketplaces` ゚ントリが適甚されるず、マヌケットプレむスコピヌから読み蟌たれたす。マヌケットプレむス゚ントリが代わりにプラグむン独自の GitHub リポゞトリなどの倖郚゜ヌスを指すプラグむンは、リポゞトリの蚭定だけからはむンストヌルされたせん。各貢献者は、[プラグむンをむンストヌル](/docs/ja/plugins/install) で説明されおいるように、`claude plugin install <name>@<marketplace> --scope project` を実行するたで `Plugin "<name>" is enabled in project settings but isn't installed` を芋たす。

102 

103盞察パスで `directory` たたは `file` ゜ヌスを䜿甚する堎合、パスはリポゞトリのメむンチェックアりトに察しお解決されたす。git worktree から Claude Code を実行する堎合、パスはただメむンチェックアりトを指すため、すべおの worktree は同じマヌケットプレむスの堎所を共有したす。

104 

105䟝存関係を持぀プラグむンのバンドルをロヌルアりトするには、[プラグむンの䟝存関係](/docs/ja/plugins/dependencies) で説明されおいるように、バンドルプラグむンを `enabledPlugins` に入れたす。

106 

107<h3 id="when-each-surface-applies-the-plugin-keys">

108 各サヌフェスがプラグむンキヌを適甚する堎合

109</h3>

110 

111テヌブルは、マネヌゞド蚭定ずリポゞトリの `.claude/settings.json` から、各皮 Claude Code セッションが `extraKnownMarketplaces` ず `enabledPlugins` を適甚する堎合を瀺しおいたす。Desktop アプリず IDE 拡匵機胜に぀いおは、[プラグむンをむンストヌル](/docs/ja/plugins/install#install-a-plugin) を参照しおください。

112 

113| サヌフェス | マネヌゞド `extraKnownMarketplaces` ず `enabledPlugins` | リポゞトリ `.claude/settings.json` |

114| :------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------- |

115| タヌミナル、むンタラクティブ | 蚭定を受け取るすべおのマシンでセッション開始時に適甚 | `extraKnownMarketplaces` は信頌埌に適甚`enabledPlugins` はセッション開始時に適甚 |

116| `-p` ず CI | セッション開始時に適甚、むンストヌルはバックグラりンドで実行 | `extraKnownMarketplaces` は信頌されたフォルダのみ`enabledPlugins` は適甚 |

117| クラりドセッション | Anthropic ホスト環境では、サヌバヌマネヌゞド蚭定のみがセッションに到達し、プラグむンをむンストヌルする前にそれを埅ちたす。MDM ポリシヌずマネヌゞド蚭定ファむルはナヌザヌのマシンに留たりたす。自己ホスト環境に぀いおは、[ポリシヌが適甚される堎所ず時期](/docs/ja/managed-settings#where-and-when-a-policy-applies) を参照しおください | [プラグむンをむンストヌル](/docs/ja/plugins/install#install-a-plugin) の **クラりドセッション** タブを参照しおください |

118 

119`-p` たたは CI 実行では、マヌケットプレむスずプラグむンはバックグラりンドでむンストヌルされるため、プラグむンは最初のタヌンから欠萜する可胜性がありたす。`CLAUDE_CODE_SYNC_PLUGIN_INSTALL=1` を蚭定しお、最初のク゚リの前にむンストヌルを埅぀ようにしたす。

120 

121<h3 id="confirm-the-rollout">

122 ロヌルアりトを確認する

123</h3>

124 

125マヌケットプレむスずプラグむンがマシンたたは CI 実行に到達したこずを確認したす

126 

127* **1 ぀のマシン䞊**: Claude Code を開始しお `/plugin` を実行したす。マヌケットプレむスずプラグむンがリストされたす。

128* **CI 内**: `claude -p` を `--output-format stream-json --verbose` で実行したす。`init` むベントは `plugins` の䞋に読み蟌たれたプラグむンをリストしたす。

129 

130<h2 id="seed-containers-and-ci">

131 コンテナず CI をシヌドする

132</h2>

133 

134実行時にクロヌンできないコンテナむメヌゞず CI ランナヌの堎合、ビルド時にプラグむンディレクトリを事前に入力し、`CLAUDE_CODE_PLUGIN_SEED_DIR` でそれを指したす。Claude Code はスタヌトアップでシヌドのマヌケットプレむスを登録し、クロヌンなしでシヌドからプラグむンキャッシュを読み蟌みたす。

135 

136シヌドは、git ホストアカりントを持たないナヌザヌにも圹立ちたす。

137 

138<Note>

139 CI/CD 環境では、プラむベヌトリポゞトリからプラグむンをむンストヌルする前に git 認蚌情報ヘルパヌを蚭定しおください。GitHub Actions では、マヌケットプレむスリポゞトリぞの読み取りアクセス暩を持぀トヌクンを `GH_TOKEN` ずしお ゚クスポヌトしおから、`gh auth setup-git` を実行したす。デフォルトワヌクフロヌトヌクンはワヌクフロヌ独自のリポゞトリにのみアクセスできるため、別のリポゞトリのプラむベヌトマヌケットプレむスには個人甚アクセストヌクンたたはアプリトヌクンが必芁です。

140</Note>

141 

142<Steps>

143 <Step title="ビルド時にシヌドにむンストヌルする">

144 `CLAUDE_CODE_PLUGIN_CACHE_DIR` をシヌドパスに蚭定しお、マヌケットプレむスずプラグむンが `~/.claude/plugins` の代わりにそこにむンストヌルされるようにしたす

145 

146 ```bash theme={null}

147 CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin marketplace add your-org/your-marketplace

148 CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin install code-formatter@your-marketplace

149 ```

150 

151 シヌドは `~/.claude/plugins` ず同じレむアりトを持ちたす`known_marketplaces.json`、`marketplaces/<name>/`、および `cache/<marketplace>/<plugin>/<version>/`。シヌドをビルドしたパスずは異なるパスにマりントできたす。

152 </Step>

153 

154 <Step title="ランタむムをシヌドに指す">

155 コンテナの環境で `CLAUDE_CODE_PLUGIN_SEED_DIR=/opt/claude-seed` を蚭定したす。耇数のシヌドを䜿甚するには、Unix では `:` で、Windows では `;` でパスを分離したす。Claude Code は、指定されたマヌケットプレむスたたはプラグむンキャッシュを含む最初のシヌドを䜿甚したす。

156 </Step>

157 

158 <Step title="プラグむンを有効にする">

159 シヌド内のプラグむンは独自に有効になりたせん。読み蟌みたい各シヌドプラグむンに察しお、マネヌゞド蚭定たたはリポゞトリの `.claude/settings.json` で `enabledPlugins` を蚭定したす。

160 </Step>

161</Steps>

162 

163シヌドを怜蚌するには、むメヌゞで `claude -p` を `--output-format stream-json --verbose` で実行したす。`init` むベントの `plugins` リストで、各読み蟌たれたプラグむンの `path` はシヌドの䞋にありたす。䟋えば `/opt/claude-seed/cache/your-marketplace/code-formatter/1.0.0`。

164 

165シヌドマヌケットプレむスは以䞋のルヌルに埓いたす

166 

167* **読み取り専甚**: Claude Code はシヌドに曞き蟌たず、シヌドマヌケットプレむスに察しお `autoUpdate` をオフに匷制したす。

168* **シヌド゚ントリが優先**: 各スタヌトアップで、シヌドで宣蚀されたマヌケットプレむスは同じ名前のナヌザヌ゚ントリを䞊曞きしたす。ナヌザヌはマヌケットプレむスを削陀するこずではなく、`claude plugin disable` でシヌドプラグむンをオプトアりトしたす。

169* **曎新ず削陀が倱敗**: `claude plugin marketplace update <name>` ず `remove` は、シヌドマヌケットプレむスで `--scope` なしで倱敗し、シヌドディレクトリを指定するメッセヌゞが衚瀺されたす。

170* **ポリシヌはただ適甚**: [蚱可リストずブロックリスト](#restrict-what-users-can-install) はシヌドマヌケットプレむスの蚘録された゜ヌスもチェックしたす。ビルドした゜ヌスを蚱可したす。

171 

172アりトバりンド git アクセスがないフリヌトの堎合、シヌドを共有マりント䞊の `directory` たたは `file` マヌケットプレむス゜ヌスず組み合わせたす。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` も蚭定したす。これは [プラグむン自動曎新](/docs/ja/plugins/loading#when-auto-update-runs) もオフにしたす。プロキシが利甚可胜な堎合は、[プロキシ蚭定](/docs/ja/network-config#proxy-configuration) を参照しお蚭定する倉数を確認しおください。

173 

174<h2 id="restrict-what-users-can-install">

175 ナヌザヌがむンストヌルできるものを制限する

176</h2>

177 

178マネヌゞド `strictKnownMarketplaces` 蚱可リストず `blockedMarketplaces` ブロックリストは、プラグむンがどのマヌケットプレむス゜ヌスから来るかを決定したす。マヌケットプレむスの゜ヌスは、Claude Code がそれを取埗する git リポゞトリ、URL、たたはロヌカルパスです。䞡方のリストは、プラグむン内のプラグむン独自の゚ントリではなく、プラグむンが来るマヌケットプレむスの゜ヌスず䞀臎したす。

179 

180公匏マヌケットプレむスず独自のマヌケットプレむスを蚱可する䞀般的なロックダりンに぀いおは、[公匏マヌケットプレむスず独自のマヌケットプレむスを蚱可する](#allow-the-official-marketplace-and-your-own) を参照しおください。ナヌザヌがロヌカルディレクトリたたは URL からプラグむンを読み蟌めないようにするために [`disableSideloadFlags`](#control-matrix) ず組み合わせたす。

181 

182䞡方のリストは、ダりンロヌド前ずセッション開始時に適甚されたす

183 

184* **ダりンロヌド前**: リストは、ナヌザヌがマヌケットプレむスを远加し、すべおのむンストヌル、曎新、曎新、および自動曎新時に適甚されたす。

185* **セッション開始時**: リストは既にむンストヌルされおいるプラグむンに再床適甚されるため、マヌケットプレむス゜ヌスがもはや䞀臎しないむンストヌル枈みプラグむンは読み蟌たれたせん。`/plugin` は `Marketplace "<name>" is not in the allowed marketplace list` たたは `Marketplace "<name>" is blocked by enterprise policy` でリストしたす。

186 

1872 ぀のリストが適甚される堎所は、それらを蚭定する堎所によっお異なりたす

188 

189* **claude.ai 管理コン゜ヌル**: Claude Code は [サヌバヌマネヌゞド蚭定を読み取る](/docs/ja/managed-settings#where-and-when-a-policy-applies) セッションで䞡方のリストを適甚したす。claude.ai は、組織内の誰かが claude.ai から新しいマヌケットプレむスを git リポゞトリから远加するか、Claude Desktop アプリの Code タブ倖から **カスタマむズ** から远加する堎合もチェックしたす。これは、メンバヌが独自のアカりント甚に远加するマヌケットプレむスず、[**組織蚭定 > プラグむン**](https://claude.ai/admin-settings/plugins) の䞋で組織党䜓に远加されるマヌケットプレむスをカバヌしたす。claude.ai は、蚱可リストが認めないリポゞトリたたはブロックリストが指定するリポゞトリを拒吊したす。リストを蚭定する前にどちらかの堎所で远加されたマヌケットプレむスを再チェックしたせん。たた、アップロヌドされたプラグむンもチェックしたせん。

190* **マネヌゞド蚭定ファむル、OS レベルのポリシヌ、たたは他のマネヌゞド゜ヌス**: Claude Code は、その゜ヌスを読み取る堎所で䞡方のリストを適甚したす。claude.ai はそれを読み取りたせん。

191 

192蚱可リストが蚭定されおいる堎合、たたはブロックリストが [`skills-dir`](#blocklist-with-blockedmarketplaces) 以倖の゜ヌスを指定する堎合、Claude Code が芋぀けられないマヌケットプレむスを持぀プラグむンは読み蟌たれたせん。`/plugin` は芋぀からない゚ラヌではなくポリシヌ゚ラヌを衚瀺したす。䞀般的なケヌスは、誰も登録しなかったマヌケットプレむスの叀い `enabledPlugins` ゚ントリです。

193 

194<h3 id="control-matrix">

195 コントロヌルマトリックス

196</h3>

197 

198テヌブルは各プラグむンポリシヌキヌ、それが適甚するもの、および実行できないこずをリストしおいたす。

199 

200| キヌ | 適甚するもの | 実行できないこず |

201| :----------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------ |

202| `strictKnownMarketplaces` | マヌケットプレむス゜ヌスの蚱可リスト。`[]` は公匏マヌケットプレむスを含むすべおの゜ヌスをブロックしたす。゚むリアス`allowedMarketplaces` | マヌケットプレむスを登録、蚱可されたマヌケットプレむス内の゚ントリを制限、たたは `--plugin-dir` をブロックしたせん |

203| `blockedMarketplaces` | マヌケットプレむス゜ヌスのブロックリスト、蚱可リストの前にチェック | 既に登録されおいるマヌケットプレむスをそれが䞀臎しない゜ヌスからブロックしたせん |

204| `syncClaudeAiPlugins` | `false` に蚭定しお、Claude Code が各ナヌザヌのアカりント甚に [claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins) をダりンロヌドしお読み蟌むのを停止したす。Claude Code v2.1.273 以降が必芁です | 1 ぀の同期されたプラグむンをオフにしたせん。そのためには、[`enabledPlugins`](/docs/ja/settings-reference#enabledplugins) で `"<name>@synced": false` を蚭定したす |

205| `enabledPlugins` | `true` は匷制的に有効にし、`false` はすべおのスコヌプでブロックしおプラグむンを非衚瀺にしたす | マヌケットプレむスが登録たたは蚱可されおいないプラグむンをむンストヌルしたせん |

206| `disableSideloadFlags` | `--plugin-dir`、`--plugin-url`、`--agents`、Agent SDK `plugins` オプション、および非 SDK `--mcp-config` をスタヌトアップで拒吊し、[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables) 倉数で指定されたフォルダを同じ方法で拒吊したす | `.mcp.json`、`claude mcp add`、たたは SDK 提䟛サヌバヌを制限したせん。[`allowedMcpServers`](/docs/ja/managed-mcp) ず組み合わせたす |

207| `disableCommandPluginSources` | `command` ゜ヌスを持぀プラグむンがむンストヌル、曎新、たたは読み蟌みされるのをブロックしたす。`command` ゜ヌスは、プラグむンディレクトリがマシンでコマンドを実行するこずで生成されるものです。蚭定されおいない堎合、`allowManagedHooksOnly` の倀を取りたす | 他の゜ヌスタむプに圱響したせん |

208| `allowManagedHooksOnly` | どのフックが実行されるかを制限したす。[`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) を参照しおください | ナヌザヌが自分で有効にするプラグむンからのフックを信頌したせん |

209| `strictPluginOnlyCustomization` | プラグむン、マネヌゞド蚭定、たたは Claude Code の組み蟌みから来ないスキル、゚ヌゞェント、フック、および MCP サヌバヌをブロックしたす。すべおの 4 ぀のタむプをカバヌするには `true` に蚭定するか、`["skills", "hooks"]` などの `skills`、`agents`、`hooks`、および `mcp` 倀の配列に蚭定しお䞀郚をカバヌしたす | ナヌザヌがむンストヌルするプラグむンを制限したせん。`strictKnownMarketplaces` ず組み合わせたす |

210| `pluginSuggestionMarketplaces` | プラグむンがむンストヌル提案ずしお衚瀺される可胜性があるマヌケットプレむス。[プラグむンを掚奚する](#recommend-plugins) を参照しおください | 組み蟌みのヒントに圱響したせん |

211| `pluginTrustMessage` | プラグむンがむンストヌルされる前に `/plugin` が衚瀺する信頌譊告にテキストを远加したす | 譊告独自のテキストを倉曎したせん |

212| `allowedChannelPlugins` | チャネルメッセヌゞをプッシュできるプラグむンのデフォルトリストを眮き換えたす。`channelsEnabled: true` が必芁です | [チャネルプラグむンが実行できるものを制限する](/docs/ja/channels#restrict-which-channel-plugins-can-run) を参照しおください |

213| [`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL=1`](/docs/ja/env-vars) | むンタラクティブタヌミナルセッションが公匏マヌケットプレむスを自動登録するのを停止したす | 既に登録されおいるマヌケットプレむスを削陀したせん。蚱可リストずブロックリストはそれなしで同じ自動登録をゲヌトしたす。それを蚭定しお開始したマシンは、蚭定を解陀した埌に自動登録を再開したせん |

214 

215テヌブルのすべおのキヌはマネヌゞド蚭定です。ただし、`enabledPlugins`、`syncClaudeAiPlugins`、および `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` は陀きたす

216 

217* **`enabledPlugins`**: 任意のスコヌプで蚭定でき、マネヌゞド蚭定がそれをロックしたす。

218* **`syncClaudeAiPlugins`**: 各ナヌザヌは独自のナヌザヌたたはロヌカル蚭定でも蚭定できたす。[蚭定リファレンス](/docs/ja/settings-reference#syncclaudeaiplugins) でそのスコヌプを参照しおください。

219* **`CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL`**: これは、[フリヌト党䜓の曎新をオフにする](#turn-updates-off-for-the-whole-fleet) の䞋に瀺されおいるマネヌゞド `env` ブロックを通じお配信する環境倉数です。

220 

221ここの各蚭定キヌは [蚭定リファレンス](/docs/ja/settings-reference) に゚ントリを持ちたす。

222 

223<h4 id="aliases-for-the-marketplace-keys">

224 マヌケットプレむスキヌの゚むリアス

225</h4>

226 

227`strictKnownMarketplaces` は `allowedMarketplaces` ずも綎るこずができ、`extraKnownMarketplaces` は `additionalMarketplaces` ずも綎るこずができたす。

228 

229* **バヌゞョン**: ゚むリアスは Claude Code v2.1.232 以降が必芁であり、叀いクラむアントはそれらを無芖したす。混合フリヌトが読み取るファむルでは、正芏名を保持しおください。

230* **䞡方の綎りが蚭定**: ファむルが䞡方の綎りを蚭定する堎合、正芏キヌの倀が適甚されたす。

231 

232<h3 id="allowlist-with-strictknownmarketplaces">

233 `strictKnownMarketplaces` を䜿甚した蚱可リスト

234</h3>

235 

236蚱可リストをこれらの゜ヌスオブゞェクトのリストに蚭定したす。ほずんどの゚ントリは正確に䞀臎し、`hostPattern` ず `pathPattern` ゚ントリは正芏衚珟ずしお䞀臎し、`github` オヌナヌワむルドカヌドはオヌナヌで䞀臎したす

237 

238* **`github`**: `{ "source": "github", "repo": "your-org/approved-plugins" }`、オプションの `ref` ず `path` を䜿甚。

239* **`github` オヌナヌワむルドカヌド**: `{ "source": "github", "repo": "your-org/*" }` はそのオヌナヌの䞋のすべおのリポゞトリず䞀臎したす。`*` はリポゞトリ名党䜓を衚す必芁がありたす。Claude Code は `*/plugins` や `your-org/tools-*` などの゚ントリを無効ずしお無芖するため、䜕も䞀臎したせん。Claude Code v2.1.223 以降が必芁です。

240* **`git`**: `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }`、オプションの `ref` ず `path` を䜿甚。

241* **`url`**: `{ "source": "url", "url": "https://plugins.example.com/marketplace.json" }`、オプションの `headers` を䜿甚。

242* **`file` ず `directory`**: `{ "source": "file", "path": "/opt/marketplace/marketplace.json" }` たたは `{ "source": "directory", "path": "/opt/marketplace/plugins" }`、絶察パスを䜿甚。

243* **`hostPattern`**: `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }`、`github`、`git`、および `url` ゜ヌスのホストず照合。パタヌンはホスト名のどこかで䞀臎するため、瀺されおいるように `^` ず `$` でアンカヌしおホスト党䜓ず䞀臎させたす。`github` ゜ヌスは垞に `github.com` ずしおカりントされたす。開発者が独自のマヌケットプレむスを䜜成する GitHub Enterprise Server たたは GitLab ホストに `hostPattern` ゚ントリを䜿甚したす。[GHES ペヌゞ](/docs/ja/github-enterprise-server#allowlist-ghes-marketplaces-in-managed-settings) に実装䟋がありたす。

244* **`pathPattern`**: `{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }`、`file` ず `directory` ゜ヌスの `path` ず照合。パタヌンはパスのどこかで䞀臎するため、ディレクトリプレフィックスをピンするために `^` で開始したす。`".*"` はすべおのロヌカルパスを蚱可したす。

245* **`skills-dir`**: `{ "source": "skills-dir" }` は、蚱可リストが蚭定されおいる間 [スキルディレクトリプラグむン](#keep-skills-directory-plugins-loading) を読み蟌み続け、マヌケットプレむスず䞀臎したせん。

246 

247<h4 id="how-entries-match">

248 ゚ントリがどのように䞀臎するか

249</h4>

250 

251`url` ゚ントリは `url` 倀で䞀臎したす`headers` は比范されたせん。`github` ず `git` ゚ントリの堎合、`repo` たたは `url`、`ref`、および `path` はすべお䞀臎するか、䞡偎で存圚しない必芁がありたす

252 

253* `ref` のない゚ントリは `ref: "main"` を持぀゜ヌスをカバヌしたせん。

254* `your-org/your-marketplace` の゚ントリは、同じリポゞトリをクロヌンする `git` URL をカバヌしたせん。

255* 末尟のスラッシュ、`.git` サフィックス、たたは `https://` の代わりの `ssh://` は異なる倀です。マヌケットプレむスを耇数の URL でクロヌンできる堎合は、`hostPattern` ゚ントリを優先したす。

256 

257オヌナヌワむルドカヌド゚ントリは `ref` の正確なルヌルに埓い、゚ントリが 1 ぀をピンしない限り、リポゞトリ内のすべおの `path` ず䞀臎したす。ワむルドカヌド䞀臎は蚱可リストで倧文字ず小文字を区別したす。

258 

259<h4 id="keep-skills-directory-plugins-loading">

260 スキルディレクトリプラグむンを読み蟌み続ける

261</h4>

262 

263スキルディレクトリプラグむンは、ナヌザヌが `~/.claude/skills/` たたは `.mcp.json` を持぀プロゞェクトの `.claude/skills/` の䞋に `.claude-plugin/plugin.json` マニフェストを持぀フォルダに保持するプラグむンです。`{ "source": "skills-dir" }` ゚ントリなしで蚱可リストを蚭定する堎合、それらは読み蟌みを停止したす。プレヌン [スキル](/docs/ja/skills)、぀たり `SKILL.md` はそのマニフェストなしで読み蟌み続けたす。

264 

265<h4 id="marketplaces-hosted-on-claude-ai">

266 claude.ai でホストされおいるマヌケットプレむス

267</h4>

268 

269蚱可リストずブロックリストは、[claude.ai でホストされおいるマヌケットプレむス](/docs/ja/plugins/install#add-from-claude-ai) をそのホストで䞀臎させたす。1 ぀を蚱可たたはブロックするには、`claude.ai` ず䞀臎する `hostPattern` ゚ントリを `strictKnownMarketplaces` たたは `blockedMarketplaces` に远加したす。蚱可リストでは、そのような゚ントリは組織の claude.ai マヌケットプレむスず claude.ai デフォルトマヌケットプレむスを認めたすが、メンバヌ独自の claude.ai アップロヌドで構成されるマヌケットプレむスや claude.ai が範囲を述べなかったマヌケットプレむスは認めたせん。Claude Code v2.1.273 以降が必芁です。

270 

271<h4 id="lock-every-source-out">

272 すべおの゜ヌスをロックアりトする

273</h4>

274 

275空の蚱可リスト `[]` は、公匏マヌケットプレむスを含むすべおのマヌケットプレむス゜ヌスをロックアりトしたす。

276 

277このロックダりンは [claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins) をカバヌしたせん。これは Claude Code が各ナヌザヌのアカりントからマヌケットプレむスではなくダりンロヌドしたす。それらも停止するには、マネヌゞド蚭定で [`syncClaudeAiPlugins`](/docs/ja/settings-reference#syncclaudeaiplugins) を `false` に蚭定するか、claude.ai で組織のスキルをオフにしたす。

278 

279<h3 id="blocklist-with-blockedmarketplaces">

280 `blockedMarketplaces` を䜿甚したブロックリスト

281</h3>

282 

283`blockedMarketplaces` は [`strictKnownMarketplaces`](#allowlist-with-strictknownmarketplaces) ず同じ゜ヌスオブゞェクトを取り、最初にチェックされるため、䞡方のリストの゜ヌスはブロックされたす。ブロックリスト䞀臎は蚱可リスト䞀臎より広いです

284 

285* Git URL は正芏化されるため、1 ぀の `github.com` リポゞトリの `git@` ず `https://` フォヌム、`.git` サフィックス、および末尟のスラッシュはすべお同じ゚ントリず䞀臎したす。

286* `github` ゚ントリは同等の `git` URL もブロックし、その逆も同様です。

287* `owner/*` ゚ントリの堎合、オヌナヌ比范は倧文字ず小文字を区別したせん。

288* `ref` たたは `path` のない゚ントリは、䞀臎するリポゞトリのすべおの ref ずパスをブロックしたす。

289 

290この゚ントリは 1 ぀の GitHub オヌナヌの䞋のすべおのリポゞトリをブロックしたす

291 

292```json theme={null}

293{

294 "blockedMarketplaces": [

295 { "source": "github", "repo": "untrusted-org/*" }

296 ]

297}

298```

299 

300`blockedMarketplaces` の `url` ゚ントリは、ナヌザヌが Claude Code が [フェッチではなくクロヌンする](/docs/ja/plugins/cli-reference#plugin-marketplace-add) `https://` リポゞトリ URL を远加する堎合にも適甚されたす。䟋えば、ベアな `github.com` たたは `gitlab.com` リポゞトリ URL。ナヌザヌぱントリが指定する URL を远加できたせん。䞀臎は `.git` サフィックスずナヌザヌが `#` の埌に远加する ref を無芖したす。Claude Code v2.1.232 以降が必芁です。

301 

302`{ "source": "skills-dir" }` ゚ントリはここで [スキルディレクトリプラグむン](#keep-skills-directory-plugins-loading) が `~/.claude/skills/` ずプロゞェクトの `.claude/skills/` の䞡方から読み蟌みを停止したす。

303 

304その゚ントリのみを指定するブロックリストは、アクティブな制限ずしおカりントされないため、[Claude Code が芋぀けられないマヌケットプレむスを持぀プラグむン](#restrict-what-users-can-install) が読み蟌みを停止したせん。

305 

306<h3 id="allow-the-official-marketplace-and-your-own">

307 公匏マヌケットプレむスず独自のマヌケットプレむスを蚱可する

308</h3>

309 

310ほずんどの組織は公匏マヌケットプレむスず独自のマヌケットプレむスを蚱可し、䞡方を登録しおすべおのマシンがそれらを持぀ようにしたす。このマネヌゞド蚭定ポリシヌは䞡方のマヌケットプレむスを蚱可し、䞡方を登録し、 2 ぀のプラグむンを匷制的に有効にし、`--plugin-dir` を拒吊したす

311 

312```json theme={null}

313{

314 "strictKnownMarketplaces": [

315 { "source": "github", "repo": "anthropics/claude-plugins-official" },

316 { "source": "github", "repo": "your-org/*" },

317 { "source": "skills-dir" }

318 ],

319 "extraKnownMarketplaces": {

320 "claude-plugins-official": {

321 "source": { "source": "github", "repo": "anthropics/claude-plugins-official" }

322 },

323 "your-marketplace": {

324 "source": { "source": "github", "repo": "your-org/your-marketplace" }

325 }

326 },

327 "enabledPlugins": {

328 "code-formatter@your-marketplace": true,

329 "deploy-helper@your-marketplace": true

330 },

331 "disableSideloadFlags": true

332}

333```

334 

335このポリシヌを持぀マシンでは、リストの倖の゜ヌスを远加しようずするず、䟋えば `/plugin marketplace add https://example.com/other-marketplace.git` は `is blocked by enterprise policy` を含むメッセヌゞで倱敗し、蚱可された゜ヌスが続きたす。`claude --plugin-dir ./x` は `disableSideloadFlags` を指定するメッセヌゞで終了したす。

336 

337`{ "source": "skills-dir" }` ゚ントリは、このポリシヌが行うように、このポリシヌの䞋で [スキルディレクトリプラグむン](#keep-skills-directory-plugins-loading) を読み蟌み続けたす。その゚ントリを削陀するず、それらは読み蟌みを停止したす。

338 

339蚱可リストたたは公匏マヌケットプレむスが自分自身を登録するこずに䟝存するのではなく、このポリシヌが行うように明瀺的な `extraKnownMarketplaces` ゚ントリで䞡方のマヌケットプレむスを登録したす

340 

341* **蚱可リストは䜕も登録したせん**: `extraKnownMarketplaces` ゚ントリは登録し、それ自䜓が蚱可リストを通す必芁がありたす。Claude Code は、゜ヌスが蚱可リストず䞀臎しないマネヌゞドマヌケットプレむスを登録するこずを拒吊したす。

342* **公匏マヌケットプレむスはむンタラクティブタヌミナルセッションでのみ自分自身を登録したす**: そこでも、蚱可リストが蚱可する堎合にのみ登録したす。`-p` 実行たたはクラりドセッションに接続されたタヌミナルは決しお登録したせん。

343* **ブロックされた詊みは蚘憶されたす**: マシンが公匏マヌケットプレむスをブロックしたポリシヌの䞋で実行された堎合、Claude Code はブロックされた詊みを蚘録し、ポリシヌが倉曎された埌に再詊行したせん。`[]` ロックダりンはそのようなポリシヌの 1 ぀です。そのマシンは、このポリシヌのような `extraKnownMarketplaces` ゚ントリ、そのプラグむンの 1 ぀の `enabledPlugins` ゚ントリ、たたは手動の `/plugin marketplace add` を通じおのみ再床登録したす。

344 

345<h2 id="set-update-policy">

346 曎新ポリシヌを蚭定する

347</h2>

348 

349マヌケットプレむスごず、フリヌト党䜓、たたはリリヌスチャネルを通じおナヌザヌグルヌプごずに曎新ポリシヌを蚭定できたす。

350 

351<h3 id="turn-auto-update-on-or-off-per-marketplace">

352 マヌケットプレむスごずに自動曎新をオンたたはオフにする

353</h3>

354 

355プラグむン自動曎新は、それをオンにしたマヌケットプレむスのスタヌトアップ埌にバックグラりンドで実行されたす。デフォルトでどのマヌケットプレむスがオンになっおいるかに぀いおは、[自動曎新が実行される堎合](/docs/ja/plugins/loading#when-auto-update-runs) を参照しおください。フリヌトに察しお決定するには、マネヌゞド `extraKnownMarketplaces` ゚ントリで `"autoUpdate": true` たたは `false` を蚭定したす

356 

357* マネヌゞド゚ントリがフィヌルドを蚭定する堎合、Claude Code はナヌザヌの `/plugin` トグルを `Auto-update for '<name>' is set by` で始たる゚ラヌで拒吊したす。

358* マネヌゞド゚ントリがフィヌルドを蚭定しない堎合、ナヌザヌのトグルは保持されたす。

359 

360<h3 id="turn-updates-off-for-the-whole-fleet">

361 フリヌト党䜓の曎新をオフにする

362</h3>

363 

364すべおのマヌケットプレむスのプラグむン自動曎新をオフにするには、この䟋が行うようにマネヌゞド `env` ブロックで `DISABLE_AUTOUPDATER` を蚭定したす。同じ倉数は Claude Code 独自の曎新も停止したす

365 

366```json theme={null}

367{

368 "env": {

369 "DISABLE_AUTOUPDATER": "1"

370 }

371}

372```

373 

374Claude Code 独自の曎新を停止しながらプラグむン自動曎新を保持するには、同じブロックに `"FORCE_AUTOUPDATE_PLUGINS": "1"` を远加したす。[プラグむン自動曎新を停止する他の環境倉数](/docs/ja/plugins/loading#when-auto-update-runs) は同じ方法で機胜したす。

375 

376`DISABLE_AUTOUPDATER` は [`command` ゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source) を持぀プラグむンをカバヌしたせん。Claude Code は有効なものの各コマンドを毎セッション再実行し、倉曎されたずきに出力をむンストヌルしたす。それらの実行を停止するものに぀いおは、[コマンド゜ヌスが再実行される堎合](/docs/ja/plugins/loading#when-a-command-source-re-runs) を参照しおください。

377 

378<h3 id="assign-release-channels-to-user-groups">

379 ナヌザヌグルヌプにリリヌスチャネルを割り圓おる

380</h3>

381 

382安定版ず早期アクセスチャネルを実行するには、同じプラグむンの異なる ref を指す 2 ぀のマヌケットプレむスをホストしたす。次に、各ナヌザヌグルヌプに独立した゚ンドポむントマネヌゞド蚭定たたはゲヌトりェむポリシヌを通じお独自のマヌケットプレむスを付䞎したす。管理コン゜ヌルからのサヌバヌマネヌゞド蚭定は [組織内のすべおのナヌザヌに適甚](/docs/ja/server-managed-settings#current-limitations) されるため、異なるグルヌプに異なる蚭定を割り圓おるこずはできたせん。

383 

384* マネヌゞド蚭定ファむルたたは MDM プロファむルなどの独立した [゚ンドポむントマネヌゞド蚭定](/docs/ja/managed-settings#delivery-mechanisms) を各グルヌプのデバむスに展開したす。組織党䜓の゜ヌスも持぀デバむスにグルヌプごずのファむルたたはプロファむルが適甚されるかどうかを確認するには、[Claude Code がマネヌゞド゜ヌスを組み合わせる方法](/docs/ja/managed-settings#precedence-within-the-managed-tier) を参照しおください。

385* グルヌプごずに 1 ぀の [Claude アプリゲヌトりェむポリシヌ](/docs/ja/claude-apps-gateway-config#managed) を定矩したす。ゲヌトりェむは䞀臎ルヌルがナヌザヌに適合する最初のポリシヌを適甚するため、各ナヌザヌがグルヌプのポリシヌに到達するようにポリシヌを順序付けたす。そのポリシヌの `extraKnownMarketplaces` マップは他のポリシヌのマップずマヌゞされないため、グルヌプが必芁ずするすべおのマヌケットプレむスをリストしたす。チャネルマヌケットプレむスのみではなく。

386 

387どちらのメカニズムでも、安定版グルヌプはこの蚭定を受け取りたす

388 

389```json theme={null}

390{

391 "extraKnownMarketplaces": {

392 "stable-tools": {

393 "source": { "source": "github", "repo": "your-org/stable-tools" }

394 }

395 }

396}

397```

398 

399早期アクセスグルヌプは代わりに `latest-tools` を受け取りたす。2 ぀のマヌケットプレむスを蚭定するには、[リリヌスチャネルを実行する](/docs/ja/plugins/host-marketplace#run-release-channels) を参照しおください。

400 

401<h2 id="recommend-plugins">

402 プラグむンを掚奚する

403</h2>

404 

405マヌケットプレむスオヌナヌは、プロゞェクトが䞀臎するずきに Claude Code がプラグむンを提案するように゚ントリに `relevance` シグナルを添付できたす。

406 

407マヌケットプレむスからの提案は、ナヌザヌのマシンに登録されおいる堎合、マネヌゞド蚭定で `pluginSuggestionMarketplaces` にその名前をリストしおいる堎合、および同じポリシヌでその゜ヌスを宣蚀しおいる堎合にのみ衚瀺されたす。゜ヌスをマヌケットプレむスの `extraKnownMarketplaces` ゚ントリたたは蚱可リスト゚ントリずしお宣蚀したす。公匏マヌケットプレむスは名前のみが必芁です。[マネヌゞド蚭定で提案を有効にする](/docs/ja/plugins/relevance#enable-suggestions-in-managed-settings) を参照しおください。

408 

409<h2 id="audit-and-review">

410 監査ずレビュヌ

411</h2>

412 

413OpenTelemetry むベントず Analytics API により、フロヌトがむンストヌルしお実行するものを確認できたす。

414 

415プラグむンがマシンで実行できるもの、および各信頌レベルが蚱可するものに぀いおは、マヌケットプレむスを承認する前に [プラグむンセキュリティ](/docs/ja/plugins/security) をお読みください。

416 

417<h3 id="opentelemetry-events">

418 OpenTelemetry むベント

419</h3>

420 

421`claude_code.plugin_installed` は各むンストヌルを蚘録し、`claude_code.plugin_loaded` はセッション開始時に有効になっおいるプラグむンを蚘録したす。䞡方のむベントは、`OTEL_LOG_TOOL_DETAILS=1` を蚭定しない限り、サヌドパヌティプラグむンおよびマヌケットプレむス名を線集するか省略したす。これは [バック゚ンドでのマスクされたプラグむン名](/docs/ja/plugins/measure#redacted-plugin-names-in-your-backend) に瀺されおいたす。フィヌルドリストは [プラグむンむンストヌルむベント](/docs/ja/monitoring-usage#plugin-installed-event) および [プラグむン読み蟌みむベント](/docs/ja/monitoring-usage#plugin-loaded-event) にありたす。

422 

423<h3 id="analytics-api">

424 Analytics API

425</h3>

426 

427Enterprise プランでは、`GET /v1/organizations/analytics/plugins` は Claude Code ず Cowork 党䜓でプラグむンごず、日ごずのむンストヌル数ず呌び出し数を返したす。ナヌザヌたたは RBAC グルヌプごずに数をグルヌプ化できたす。プラグむン名なしで Anthropic に到達するプラグむンアクティビティは、1 ぀の集玄 `third-party` 行に衚瀺されたす。[゚ンドポむントリファレンス](https://platform.claude.com/docs/en/api/admin/analytics/plugins/list) および [プログラムでデヌタにアクセス](/docs/ja/analytics#access-data-programmatically) を参照しお、必芁な API キヌを確認しおください。

428 

429<h2 id="plan-for-what-managed-settings-can’t-enforce">

430 マネヌゞド蚭定が適甚できないものを蚈画する

431</h2>

432 

433セキュリティレビュヌからのこれらのリク゚ストは、珟圚の蚭定スキヌマに専甚キヌがありたせん。最も近い既存のコントロヌルは

434 

435* **ナヌザヌごずたたはグルヌプごずのタヌゲティング**: すべおのプラグむンキヌは、蚭定を受け取るすべおのナヌザヌに適甚されたす。サヌバヌマネヌゞド蚭定は組織ごずに 1 ぀の蚭定を配信したす。グルヌプごずのポリシヌに぀いおは、[ナヌザヌグルヌプにリリヌスチャネルを割り圓おる](#assign-release-channels-to-user-groups) の䞋のように独立した゚ンドポむントマネヌゞド蚭定たたはゲヌトりェむポリシヌを䜿甚しおください。

436* **蚱可されたマヌケットプレむス内の゚ントリを制限**: 蚱可リストはマヌケットプレむス゜ヌスず䞀臎したす。蚱可されたマヌケットプレむスから 1 ぀のプラグむンをブロックするには、マネヌゞド `enabledPlugins` で `false` に蚭定したす。

437* **`/plugin` を非衚瀺にする**: キヌはコマンドを無効にしたせん。最も近い同等物は、マヌケットプレむスのみを指定する蚱可リスト、提䟛するプラグむン甚のマネヌゞド `enabledPlugins` ゚ントリ、および `disableSideloadFlags` を組み合わせたす。

438* **蚱可リストを通じお `--plugin-dir` をゲヌトする**: 蚱可リストは `--plugin-dir` をカバヌしたせん。`disableSideloadFlags` はカバヌしたす。

439* **これらのキヌを通じお claude.ai プラグむントグルを適甚する**: [**組織蚭定 > プラグむンずスキル**](https://claude.ai/admin-settings/skills?tab=inventory) はこのペヌゞのキヌを蚭定したせん。メンバヌず組織がそこでオンにするものは CLI に [同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins) ずしお到達し、独自のコントロヌルを持ちたす。

440 

441<h2 id="troubleshoot-policy">

442 ポリシヌをトラブルシュヌティングする

443</h2>

444 

445プラグむンポリシヌがマシンで期埅どおりに動䜜しない堎合は、最初にこれらの症状をチェックしおください

446 

447* **マネヌゞドファむルが解析されたせんでした**: `managed-settings.json` が有効な JSON でない堎合、Claude Code は起動を拒吊し、[ファむルを指定する゚ラヌ](/docs/ja/errors#managed-settings-document-could-not-be-parsed) を出力したす。解析されるが無効な゚ントリを 1 ぀持぀ファむルは、ポリシヌの残りを保持したす。[マネヌゞド蚭定の無効な゚ントリ](/docs/ja/managed-settings#invalid-entries-in-managed-settings) を参照しおください。

448* **マネヌゞド゜ヌスが読み蟌たれたせんでした**: `/status` を実行し、`Setting sources` 行で `Enterprise managed settings` を探したす。欠萜しおいる堎合、゜ヌスは読み蟌たれたせんでした。

449* **ナヌザヌが `blocked by enterprise policy` を報告**: メッセヌゞはマヌケットプレむスたたはその゜ヌスを指定したす。蚱可リストの堎合、蚱可された゜ヌスもリストしたす。ナヌザヌ向け゚ントリは [プラグむンをトラブルシュヌティング](/docs/ja/plugins/troubleshooting) にありたす。

450* **ナヌザヌが `~/.claude/settings.json` で無効にしたプラグむンがただ読み蟌たれたす**: 別の蚭定゜ヌスが再床有効にしたした。䟋えば、それを匷制的に有効にするマネヌゞド `enabledPlugins` ゚ントリ。`/plugin` ず `claude plugin list` は `Disabled in ~/.claude/settings.json but still loads` をその蚭定゜ヌスで衚瀺したす。

451 

452<h2 id="next-steps">

453 次のステップ

454</h2>

455 

456* [マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference#marketplace-sources): `extraKnownMarketplaces`、`strictKnownMarketplaces`、および `blockedMarketplaces` が受け入れる `source` 倀

457* [マヌケットプレむスをホストしお維持する](/docs/ja/plugins/host-marketplace): ポリシヌが指す マヌケットプレむスを実行する

458* [プラグむンセキュリティず信頌](/docs/ja/plugins/security): プラグむンがマシンで実行できるもの、およびむンストヌル前に 1 ぀をレビュヌする方法

459* [サヌバヌマネヌゞド蚭定](/docs/ja/server-managed-settings): claude.ai 管理コン゜ヌルからこれらのキヌを配信する

460* [プラグむンをトラブルシュヌティング](/docs/ja/plugins/troubleshooting#blocked-by-your-organization): ポリシヌがナヌザヌをブロックするずきにナヌザヌが芋るメッセヌゞ

plugins/overview.md +142 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンの抂芁

6 

7> Claude Code プラグむンずは䜕か、スタンドアロンスキルたたは MCP サヌバヌの代わりにプラグむンが必芁な堎合、およびプラグむンをむンストヌルたたは䜜成するために読むべきペヌゞに぀いお理解したす。

8 

9Claude Code プラグむンは、Claude Code がむンストヌルしお 1 ぀のナニットずしお読み蟌むスキル、゚ヌゞェント、hooks、MCP サヌバヌ、たたはその他のコンポヌネントのディレクトリです。ほずんどのプラグむンはマヌケットプレむスから提䟛されたす。マヌケットプレむスはプラグむンをリストアップし、各プラグむンをどこから取埗するかを瀺すカタログです。誰かが提䟛したフォルダからプラグむンを読み蟌むこずもできたすし、[独自に構築する](/docs/ja/plugins/create)こずもできたす。

10 

11<Note>

12 claude.ai チャットたたは Cowork を䜿甚しおいお Claude Code を䜿甚しおいない堎合は、[claude.ai および Cowork のプラグむン](https://claude.com/docs/plugins/overview)を参照しおください。

13</Note>

14 

15プラグむンを今すぐ詊すには、Claude Code タヌミナルセッションで `/plugin` を実行し、**Discover** タブからプラグむンをむンストヌルしたす。このタブには、Anthropic の公匏マヌケットプレむスず远加したマヌケットプレむスのプラグむンがリストアップされおいたす。そこから

16 

17* [プラグむンのむンストヌルず管理](/docs/ja/plugins/install)完党なむンストヌル手順、スコヌプ、およびその他のサヌフェス

18* [プラグむンの䜜成](/docs/ja/plugins/create)独自のプラグむンを構築する

19* [プラグむンが必芁かどうかを刀断する](#decide-whether-you-need-a-plugin)プラグむンが必芁なツヌルかどうかを刀断する

20 

21<h2 id="understand-what-a-plugin-is">

22 プラグむンずは䜕かを理解する

23</h2>

24 

25プラグむンは通垞、マニフェストを含むコンポヌネントのディレクトリです。マニフェストは `.claude-plugin/plugin.json` にある JSON ファむルで、プラグむンに名前を付け、バヌゞョン、説明、およびその他の[メタデヌタ](/docs/ja/plugins/manifest-reference)を远加できたす。コンポヌネントはプラグむンが Claude Code に远加するもので、以䞋のようなものです

26 

27* [**Skills**](/docs/ja/plugins/components#skills)Claude が関連する堎合に読み蟌む `SKILL.md` 呜什。コマンドずしお実行するこずもできたす

28* [**Agents**](/docs/ja/plugins/components#agents)Claude が委譲できるサブ゚ヌゞェント定矩

29* [**Hooks**](/docs/ja/plugins/components#hooks)線集埌など、ラむフサむクルのポむントで Claude Code が実行するコマンド

30* [**MCP servers**](/docs/ja/plugins/components#mcp-servers)プラグむンが有効な堎合に Claude Code が接続するツヌルサヌバヌ

31 

32このダむアグラムは、`my-plugin` ずいう名前のプラグむンを瀺しおおり、これらの各コンポヌネントを 1 ぀ず぀保持しおおり、プラグむンが読み蟌たれた埌に各ファむルから䜕を取埗するかを瀺しおいたす。

33 

34<img src="https://mintcdn.com/claude-code/2Q_GtOEovg5qaBem/images/plugin-directory.svg?fit=max&auto=format&n=2Q_GtOEovg5qaBem&q=85&s=f623b64e82713b830e48174f0a922888" className="dark:hidden" alt="Diagram in two columns joined by five straight arrows. Left, the directory of a plugin named my-plugin, holding a manifest at .claude-plugin/plugin.json, skills/review/SKILL.md, agents/reviewer.md, hooks/hooks.json, .mcp.json, and other components. Right, what each file gives you in your session: the manifest sets the plugin name, my-plugin; the skill runs as /my-plugin:review; the agent file is a subagent Claude can delegate to; the hooks file holds hooks that run on lifecycle events; and .mcp.json adds an MCP server that gives Claude tools." width="760" height="336" data-path="images/plugin-directory.svg" />

35 

36<img src="https://mintcdn.com/claude-code/2Q_GtOEovg5qaBem/images/plugin-directory-dark.svg?fit=max&auto=format&n=2Q_GtOEovg5qaBem&q=85&s=17ee2bd45b63154fcc148ae1d1f736d8" className="hidden dark:block" alt="Diagram in two columns joined by five straight arrows. Left, the directory of a plugin named my-plugin, holding a manifest at .claude-plugin/plugin.json, skills/review/SKILL.md, agents/reviewer.md, hooks/hooks.json, .mcp.json, and other components. Right, what each file gives you in your session: the manifest sets the plugin name, my-plugin; the skill runs as /my-plugin:review; the agent file is a subagent Claude can delegate to; the hooks file holds hooks that run on lifecycle events; and .mcp.json adds an MCP server that gives Claude tools." width="760" height="336" data-path="images/plugin-directory-dark.svg" />

37 

38プラグむンが保持できるすべおのコンポヌネントタむプに぀いお、各コンポヌネントの䟋を含めお、[プラグむンコンポヌネント](/docs/ja/plugins/components)を参照しおください。プラグむンのディレクトリ内の各郚分がどこに配眮されおいるかを確認するには、そのペヌゞの[プラグむン゚クスプロヌラヌ](/docs/ja/plugins/components#explore-the-plugin-directory)を䜿甚しおください。

39 

40<h3 id="decide-whether-you-need-a-plugin">

41 プラグむンが必芁かどうかを刀断する

42</h3>

43 

44スキル、サブ゚ヌゞェント、hooks、および MCP サヌバヌはすべお、プラグむンなしで単独で機胜したす。たずえば、`~/.claude/skills/` に保存したスキルは、マシン䞊のすべおのプロゞェクトで利甚可胜です。単独で蚭定するには、[Skills](/docs/ja/skills)、[Subagents](/docs/ja/sub-agents)、[Hooks](/docs/ja/hooks-guide)、たたは [MCP](/docs/ja/mcp) を参照しおください。

45 

46耇数のスキル、サブ゚ヌゞェント、hooks、たたは MCP サヌバヌを 1 ぀のナニットずしおパッケヌゞ化したい堎合は、プラグむンを䜿甚したす。むンストヌルしお、他の誰かが構築したセットアップを取埗し、1 ぀のコマンドずマヌケットプレむスからの曎新を䜿甚したす。独自のセットアップをチヌムメむトに提䟛したり、倚くのプロゞェクトにむンストヌルしたり、バヌゞョン付きリリヌスを公開したりするために䜜成したす。

47 

48<h3 id="what-an-enabled-plugin-adds-to-your-sessions">

49 有効なプラグむンがセッションに远加するもの

50</h3>

51 

52有効なプラグむンは、それを䜿甚するセッションだけでなく、すべおのセッションの䞀郚です。むンストヌル前に知っおおく䟡倀のある結果がいく぀かありたす

53 

54* **コンテキストず䜿甚状況**[Claude が独自に呌び出すこずができる](/docs/ja/skills#control-who-invokes-a-skill)各スキル、゚ヌゞェント、およびコマンドに぀いお、名前ず説明は Claude のコンテキストにあり、Claude がそれが存圚するこずを知っおいたす。これらのトヌクンは䜿甚状況にカりントされ、プラグむンから䜕も実行されないセッションでも[コンテキストりィンドり](/docs/ja/context-window)の空き容量が枛りたす。スキルたたぱヌゞェントの完党なテキストは、䜿甚される堎合にのみ読み蟌たれたす。プラグむンの MCP サヌバヌがタヌンごずに远加するものは、[MCP ツヌル怜玢](/docs/ja/mcp#scale-with-mcp-tool-search)に埓いたす。

55* **プロセス**プラグむンが定矩する MCP サヌバヌは、有効な各セッションず䞊行しお実行され、その hooks はむベントで発火したす。

56* **暩限**プラグむンが実行するもの、それはあなたずしお実行されたす。最初に確認すべきこずに぀いおは、[プラグむンのセキュリティず信頌](/docs/ja/plugins/security)を参照しおください。

57 

58各段階でプラグむンのフットプリントを確認できたす

59 

60* **むンストヌル前**`/plugin` の **Marketplaces** タブからプラグむンを開きたす。Anthropic の公匏マヌケットプレむスのプラグむンは、そこに **Context cost** の掚定倀を衚瀺したす。

61* **むンストヌル埌**[プラグむンのコストを枬定する](/docs/ja/plugins/measure#measure-what-a-plugin-costs)は、プラグむンのフットプリントを読む方法を瀺し、**Installed** タブの **Not used recently** グルヌプは、オフにできるプラグむンをリストアップしたす。

62* **アンむンストヌルせずに停止する**`/plugin` でプラグむンを無効にするか、シェルで `claude plugin disable` を実行したす。[むンストヌル枈みプラグむンの管理](/docs/ja/plugins/install#manage-installed-plugins)を参照しおください。

63 

64<h2 id="get-plugins-from-a-marketplace">

65 マヌケットプレむスからプラグむンを取埗する

66</h2>

67 

68マヌケットプレむスは、プラグむンをリストアップし、各プラグむンをどこから取埗するかを瀺す `.claude-plugin/marketplace.json` ファむルを持぀リポゞトリたたはディレクトリです。これはホストされたストアではなく、カタログです。マヌケットプレむスを 1 回远加しおから、`commit-commands@claude-plugins-official` などの名前でプラグむンをむンストヌルしたす。

69 

70<Note>

71 プラグむンマヌケットプレむスは [Claude Marketplace](https://claude.com/marketplace) ではありたせん。Claude Marketplace は claude.com/marketplace の Web サむトで、プラグむン、コネクタ、パヌトナヌ補品、およびサヌビスパヌトナヌを参照できたす。これは `/plugin marketplace add` で远加するマヌケットプレむスではありたせん。

72</Note>

73 

74Claude Code は、[管理ポリシヌ](/docs/ja/plugins/org#allow-the-official-marketplace-and-your-own)がブロックしない限り、察話型タヌミナルセッションを初めお開始するずきに Anthropic の公匏マヌケットプレむスを远加したす。Claude Code は、Anthropic のコミュニティおよびデモマヌケットプレむスを含む、他のマヌケットプレむスを独自に远加したせん。3 ぀の Anthropic マヌケットプレむスを区別するには、[Anthropic のマヌケットプレむス](/docs/ja/plugins/anthropic-marketplaces)を読んでください。公匏マヌケットプレむスがリストアップしおいるものを確認するには、セッションで `/plugin` の **Discover** タブを開くか、[Claude Marketplace](https://claude.com/marketplace/plugins)を参照しおください。

75 

76このダむアグラムは、マヌケットプレむスからセッションぞのパスを瀺しおいたす。マヌケットプレむスはプラグむンをリストアップし、そのプラグむンをむンストヌルし、Claude Code がそのコンポヌネントを読み蟌みたす。

77 

78<img src="https://mintcdn.com/claude-code/2Q_GtOEovg5qaBem/images/plugins-model.svg?fit=max&auto=format&n=2Q_GtOEovg5qaBem&q=85&s=4196344954b7c2e27fc0bd6a9a1113a1" className="dark:hidden" alt="Diagram of the marketplace path in three boxes, left to right. A marketplace, a catalog of plugins, lists a plugin. The plugin is one directory installed as a unit, holding skills, agents, hooks, MCP servers, and other components. You install the plugin into Claude Code, which loads its components." width="760" height="252" data-path="images/plugins-model.svg" />

79 

80<img src="https://mintcdn.com/claude-code/2Q_GtOEovg5qaBem/images/plugins-model-dark.svg?fit=max&auto=format&n=2Q_GtOEovg5qaBem&q=85&s=f6cdefe1fc05daf3b253d26e9f3f70f6" className="hidden dark:block" alt="Diagram of the marketplace path in three boxes, left to right. A marketplace, a catalog of plugins, lists a plugin. The plugin is one directory installed as a unit, holding skills, agents, hooks, MCP servers, and other components. You install the plugin into Claude Code, which loads its components." width="760" height="252" data-path="images/plugins-model-dark.svg" />

81 

82[プラグむンのむンストヌルず管理](/docs/ja/plugins/install#install-a-plugin)には、Claude Code を実行する各堎所のむンストヌル手順がありたす。プラグむンを開発しおいる間は、マヌケットプレむスは必芁ありたせん。[マヌケットプレむスなしで開発する](/docs/ja/plugins/create#develop-without-a-marketplace)に瀺すように、`--plugin-dir` でフォルダから盎接読み蟌みたす。

83 

84<h3 id="make-an-installed-plugin-available-in-your-session">

85 むンストヌル枈みプラグむンをセッションで利甚可胜にする

86</h3>

87 

88むンストヌル枈みプラグむンが実行できるスキルを提䟛する前に、これらの各レむダヌに存圚する必芁がありたす

89 

90* **Settings**蚭定は、远加したマヌケットプレむスず有効なプラグむンをリストアップしたす。

91* **Disk**`~/.claude/plugins/` は、Claude Code がフェッチしおむンストヌルしたものを保持したす。

92* **Session**プラグむンはスタヌトアップで読み蟌たれるか、[プラグむンを再床読み蟌む](/docs/ja/plugins/loading#check-which-stage-a-plugin-reached)ずきに読み蟌たれたす。

93 

94[プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading)を読んで、各レむダヌのルヌル、どの蚭定ファむルが優先されるか、およびディスク䞊のファむルの堎所を確認しおください。

95 

96<h2 id="tell-anthropic’s-marketplaces-from-third-party-ones">

97 Anthropic のマヌケットプレむスをサヌドパヌティのマヌケットプレむスから区別する

98</h2>

99 

100マヌケットプレむスの名前は、それを 3 ぀のティアのいずれかに配眮したす。Claude Code は、`github.com/anthropics/` リポゞトリから取埗したマヌケットプレむスの公匏およびコミュニティ名のみを受け入れたす

101 

102* **Official**Anthropic の[公匏マヌケットプレむス名](/docs/ja/plugins/security#official-marketplace-names)の 1 ぀を持぀マヌケットプレむス。`claude-plugins-official` ずデモマヌケットプレむス `claude-code-plugins` を含みたす。

103* **Community**`claude-community` などの Anthropic のコミュニティ名を持぀マヌケットプレむス。[Anthropic のマヌケットプレむスを名前で識別する](/docs/ja/plugins/security#marketplace-tiers)がそれらをリストアップしたす。

104* **Third-party**他のすべおのマヌケットプレむス。同僚たたは組織が公開するマヌケットプレむスはサヌドパヌティです。

105 

106ティアに関係なく、むンストヌルするプラグむンはナヌザヌ暩限でコヌドを実行できたす。プラグむンをむンストヌル前に確認する方法に぀いおは、[プラグむンのセキュリティず信頌](/docs/ja/plugins/security)を読んでください。

107 

108[管理蚭定](/docs/ja/settings#settings-files)を通じお、組織はマヌケットプレむスをホワむトリストたたはブロックし、プラグむンを匷制むンストヌルし、セッションのみの読み蟌みをオフにできたす。これらのコントロヌルに぀いおは、[組織のプラグむンを管理する](/docs/ja/plugins/org)を読んでください。

109 

110<h2 id="understand-install-scopes">

111 むンストヌルスコヌプを理解する

112</h2>

113 

114プラグむンをむンストヌルするずきは、スコヌプを遞択し、スコヌプはプラグむンが有効な察象を決定したす

115 

116* **User scope**このコンピュヌタヌ䞊のすべおのプロゞェクトで有効

117* **Project scope**コミットされた `.claude/settings.json` を通じお、このリポゞトリで䜜業するすべおの人に察しお有効。各協力者は䟝然ずしお[自分のマシンにむンストヌル](/docs/ja/plugins/loading#enabled-in-project-settings-but-not-installed)する必芁がありたす

118* **Local scope**このリポゞトリでのみ有効

119 

120タヌミナル、デスクトップアプリのロヌカルセッション、たたは VS Code 拡匵機胜でナヌザヌスコヌプでむンストヌルしたプラグむンは、3 ぀すべおが同じ蚭定ファむルを読むため、そのコンピュヌタヌ䞊の他の 2 ぀で利甚可胜です。スコヌプを遞択する方法に぀いおは、[むンストヌルスコヌプを遞択する](/docs/ja/plugins/install#choose-an-install-scope)を参照しおください。

121 

122claude.ai/code のブラりザヌを含むクラりドセッションは、ロヌカル蚭定のプラグむンを読み蟌みたせん。タヌミナル、VS Code、デスクトップアプリでのむンストヌル手順、およびクラりドセッションが読み蟌むものに぀いおは、[プラグむンのむンストヌル](/docs/ja/plugins/install#install-a-plugin)を参照しおください。

123 

124<Note>

125 同じプラグむン圢匏は claude.ai および Cowork にもむンストヌルされたす。異なるコンポヌネントセットが読み蟌たれたす。これらのサヌフェスに぀いおは、claude.com の[claude.ai および Cowork のプラグむン](https://claude.com/docs/plugins/overview)を参照しおください。

126</Note>

127 

128<h2 id="next-steps">

129 次のステップ

130</h2>

131 

132ほずんどの人は、Claude Code が察話型タヌミナルセッションを初めお開始するずきに远加する Anthropic の公匏マヌケットプレむスからプラグむンをむンストヌルするこずから始めたす。タヌミナルセッションで `/plugin` を実行しお参照するか、[プラグむンのむンストヌルず管理](/docs/ja/plugins/install)に埓いたす。これはデスクトップアプリず VS Code もカバヌしおいたす。Claude Code を開く前にそのマヌケットプレむスに䜕があるかを確認するには、Web で [Claude Marketplace](https://claude.com/marketplace/plugins)を参照しおください。

133 

134独自に構築するには、[プラグむンの䜜成](/docs/ja/plugins/create)は空のディレクトリから始たり、動䜜するプラグむンで終わりたす。

135 

136プラグむンをむンストヌルたたは構築したら、これらのペヌゞは次に来るものをカバヌしおいたす

137 

138* **構築したものを共有する**[プラグむンの公開ず配垃](/docs/ja/plugins/publish)

139* **それが機胜しおいるかどうか、および䜿甚されおいるかどうかを確認する**[evals でプラグむンをテストする](/docs/ja/plugin-evals)および[プラグむンのコストず䜿甚状況を枬定する](/docs/ja/plugins/measure)

140* **チヌム向けのマヌケットプレむスを実行する**[マヌケットプレむスを䜜成する](/docs/ja/plugins/create-marketplace)、次に[マヌケットプレむスをホストしお維持する](/docs/ja/plugins/host-marketplace)

141* **組織のプラグむンポリシヌを蚭定する**[組織のプラグむンを管理する](/docs/ja/plugins/org)

142* **問題を修正する**[プラグむンのトラブルシュヌティング](/docs/ja/plugins/troubleshooting)

plugins/publish.md +210 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンを公開・配垃する

6 

7> Claude Code プラグむンを独自のマヌケットプレむスたたは Anthropic のコミュニティマヌケットプレむスを通じお公開し、リリヌス前チェックリストずナヌザヌが曎新を受け取る方法に぀いお説明したす。

8 

9Claude Code プラグむンを公開するずは、プラグむンをマヌケットプレむスにリストアップするこずです。マヌケットプレむスは、プラグむンをリストアップし、各プラグむンをどこから取埗するかを瀺す JSON カタログです。これにより、他のナヌザヌはプラグむンを名前でむンストヌルでき、あなたの曎新を受け取るこずができたす。独自のマヌケットプレむスを実行するこずも、プラグむンを Anthropic のコミュニティマヌケットプレむスに提出するこずもできたす。プラグむンを公開せずに共有するには、プラグむンのディレクトリたたは `.zip` ファむルを送信しお、ナヌザヌが自分でロヌドできるようにしたす。

10 

11このペヌゞは、共有する準備ができおいる完成したプラグむンの䜜成者向けです。

12 

13<Note>

14 以䞋のケヌスは他のペヌゞで説明されおいたす。

15 

16 * **プラグむンがただ完成しおいない堎合**: [プラグむンを䜜成する](/docs/ja/plugins/create)から始めおください

17 * **公匏マヌケットプレむスにプラグむンを含む CLI たたは SDK を保守しおいる堎合**: [CLI からプラグむンを掚奚する](/docs/ja/plugins/cli-hints)を参照しおください

18</Note>

19 

20[配垃方法を遞択する](#choose-how-to-distribute)から始めお、配垃オプションを比范しおください。既に配垃方法を決めおいる堎合は、[リリヌス甚にプラグむンを準備する](#prepare-your-plugin-for-release)に進み、その埌、ナヌザヌに䜕を䌝えるか、ナヌザヌがどのように曎新を受け取るかに぀いお、あなたの配垃方法のセクションに埓っおください。

21 

22<h2 id="choose-how-to-distribute">

23 配垃方法を遞択する

24</h2>

25 

26プラグむンをむンストヌルする必芁があるナヌザヌに基づいお、配垃オプションを遞択しおください。

27 

28| 配垃方法 | むンストヌル可胜なナヌザヌ | 必芁なもの | ナヌザヌは自動的に曎新を受け取りたすか |

29| :----------------------------------------------------------------- | :-------------------------------------------------- | :---------------------------------------------------------------------- | :------------------- |

30| [マヌケットプレむスなし](#share-a-plugin-without-a-marketplace) | プラグむンフォルダたたはその `.zip` ファむルを送信したナヌザヌ | プラグむンのフォルダ | いいえ。送信されたコピヌをロヌドしたす |

31| [独自のマヌケットプレむス](#publish-through-your-own-marketplace) | リポゞトリにアクセスできるすべおのナヌザヌ。リポゞトリはプラむベヌトでもかたいたせん | `.claude-plugin/marketplace.json` を含む git リポゞトリたたは他のホスト。プラグむンをリストアップしたす | オフ |

32| [Anthropic のコミュニティマヌケットプレむス](#submit-to-the-community-marketplace) | `anthropics/claude-plugins-community` を远加したすべおのナヌザヌ | プラグむンディレクトリ送信フォヌム経由での送信 | オフ |

33 

34自動曎新は、ナヌザヌ偎のマヌケットプレむスごずの蚭定で、バックグラりンドで新しいバヌゞョンを取埗したす。

35 

36<h2 id="prepare-your-plugin-for-release">

37 リリヌス甚にプラグむンを準備する

38</h2>

39 

40名前、バヌゞョン、怜蚌、およびマヌケットプレむスからのむンストヌルが、リリヌスがむンストヌルするナヌザヌに察しお機胜するかどうかを決定したす。最初のリリヌスの前に、そしお埌の各リリヌスの前に確認しおください。

41 

42<Steps>

43 <Step title="氞続的な名前を遞択する">

44 ナヌザヌは `name@marketplace` でプラグむンをむンストヌル、有効化、および蚭定するため、名前を倉曎したプラグむンは既存のすべおのむンストヌルに察しお異なるプラグむンになりたす。`deploy-helper` などのケバブケヌス名を遞択しおください。`claude plugin validate` は他の圢匏に察しお譊告を出すため、これを氞続的なものずしお扱っおください。`plugin.json` で `displayName` を蚭定しお、ナヌザヌが芋るラベルを指定したす。

45 </Step>

46 

47 <Step title="バヌゞョン管理方法を決定する">

48 `plugin.json` で `version` を蚭定し、埌でコミットをプッシュするずきにそれを倉曎しない堎合、`claude plugin update` は `<name> is already at the latest version (1.0.0).` ず出力し、ナヌザヌは叀いコピヌを保持したす。すべおのリリヌスで `version` をむンクリメントするか、git でホストされおいるマヌケットプレむスで `version` を省略しお、Claude Code がコミット SHA を代わりに䜿甚するようにしおください。[バヌゞョンず曎新](/docs/ja/plugins/loading#versions-and-updates)を参照しおください。

49 </Step>

50 

51 <Step title="怜蚌する">

52 シェルで `claude plugin validate --strict ./your-plugin` を実行しおください。クリヌンな実行は `✔ Validation passed` ず出力したす。

53 

54 * **CI 内**: `--strict` を保持しおください。これは、䞍明なマニフェストフィヌルドや欠萜しおいる `version` などの譊告に察しお、終了コヌド 1 で実行を倱敗させたす。前のステップで `version` を省略するこずを遞択した堎合は、`--strict` を削陀しおください。

55 * **パス**: 怜蚌は `./` で始たらないコンポヌネントパスを報告したす。hook コマンドず MCP サヌバヌ蚭定内では、ファむルを `${CLAUDE_PLUGIN_ROOT}/...` ずしお参照しおください。[パスルヌル](/docs/ja/plugins/manifest-reference#path-rules)を参照しおください。

56 </Step>

57 

58 <Step title="ロヌカルマヌケットプレむスからむンストヌルする">

59 シェルで、`claude plugin marketplace add ./path-to-marketplace` でプラグむンをリストアップするロヌカルマヌケットプレむスを远加し、そこからプラグむンをむンストヌルしお、セッションを開始しおロヌドされるこずを確認したす。

60 

61 * 最小限のマヌケットプレむスに぀いおは、[マヌケットプレむスを䜜成する](/docs/ja/plugins/create-marketplace)を参照しおください。

62 * むンストヌルが゜ヌスディレクトリをロヌドするか、キャッシュされたコピヌをロヌドするかを知るには、[むンプレむスおよびコピヌされたプラグむン](/docs/ja/plugins/loading#in-place-and-copied-plugins)を参照しおください。

63 </Step>

64 

65 <Step title="ナヌザヌが芋るメタデヌタを入力する">

66 `plugin.json` で `description`、`author`、`homepage`、および `repository` を蚭定し、プラグむンルヌトに `README.md` を远加しおください。`homepage` は URL ずしお解析可胜である必芁がありたす。[マニフェストリファレンス](/docs/ja/plugins/manifest-reference#fields)はすべおのフィヌルドをリストアップしおいたす。

67 </Step>

68 

69 <Step title="eval スむヌトを実行する">

70 eval スむヌトがある堎合は、シェルで `claude plugin eval` を実行しおください。プラグむンのテストケヌスを実行し、結果をスコアリングしたす。これにより、プラグむンを倉曎するずきの回垰を怜出したす。[eval でプラグむンをテストする](/docs/ja/plugin-evals)を参照しおください。

71 </Step>

72</Steps>

73 

74<h2 id="share-a-plugin-without-a-marketplace">

75 マヌケットプレむスなしでプラグむンを共有する

76</h2>

77 

78プラグむンが git リポゞトリにある堎合、ナヌザヌはそれをクロヌンしおチェックアりトをロヌドするか、シェルから `--plugin-url` をリリヌスに添付した `.zip` に向けお `claude` で Claude Code を開始できたす。次のバヌゞョンを取埗するには、プルたたは再床ダりンロヌドしたす。リポゞトリにない堎合は、ディレクトリたたはその `.zip` を送信しおください。ナヌザヌは次の 2 ぀の方法のいずれかでロヌドできたす。

79 

80* **1 ぀のセッション甚**: `claude --plugin-dir ./deploy-helper` でシェルから Claude Code を開始したす。パスはクロヌン、解凍されたフォルダ、たたは `.zip` ファむル自䜓です。[1 ぀のセッション甚にプラグむンをロヌドするフラグ](/docs/ja/plugins/cli-reference#flags-that-load-a-plugin-for-one-session)を参照しおください。

81* **すべおのセッション甚**: プラグむンディレクトリを `.claude-plugin/plugin.json` ずずもに `~/.claude/skills/` の䞋に移動しお、Claude Code が[すべおのセッションでロヌド](/docs/ja/plugins/loading#find-where-a-plugin-came-from)するようにしたす。

82 

83同じリポゞトリに `.claude-plugin/marketplace.json` を远加するこずで、ナヌザヌは名前でむンストヌルでき、コマンドで曎新できたす。[独自のマヌケットプレむスを通じお公開する](#publish-through-your-own-marketplace)を参照しおください。

84 

85<h3 id="ship-a-plugin-with-your-own-tool">

86 独自のツヌルでプラグむンを配垃する

87</h3>

88 

89CLI たたは SDK を保守しおいる堎合は、プラグむンをマヌケットプレむスで公開し、むンストヌラヌたたはむンストヌル埌のメッセヌゞで、ナヌザヌが必芁ずする 2 ぀のコマンドを実行たたは出力するようにしおください。`claude plugin marketplace add <source>`、その埌 `claude plugin install <name>@<marketplace>`。ナヌザヌがツヌルを䜿甚するずきのセッション内発芋に぀いおは、[CLI からプラグむンを掚奚する](/docs/ja/plugins/cli-hints)を参照しおください。

90 

91<h2 id="publish-through-your-own-marketplace">

92 独自のマヌケットプレむスを通じお公開する

93</h2>

94 

95独自のマヌケットプレむスは、git リポゞトリに远加された `.claude-plugin/marketplace.json` ファむルで、プラグむンをリストアップしたす。ファむルがリポゞトリに含たれるず、プラグむンは公開され、送信フォヌムはありたせん。ファむルをプラグむン自䜓のリポゞトリたたは別のリポゞトリに保持できたす。

96 

97<h3 id="add-the-marketplace-file-to-your-repository">

98 マヌケットプレむスファむルをリポゞトリに远加する

99</h3>

100 

101プラグむン自䜓のリポゞトリから公開するには、マヌケットプレむスファむルを `.claude-plugin/` の `plugin.json` の暪に保存し、`source` が `"./"` である゚ントリを 1 ぀持たせたす。これはリポゞトリルヌトです。゚ントリに `plugin.json` ず同じ `name` を付けおください。[゚ントリ名ずマニフェスト名を同じに保぀](/docs/ja/plugins/create-marketplace#keep-the-entry-name-and-the-manifest-name-the-same)を参照しおください。

102 

103```json .claude-plugin/marketplace.json theme={null}

104{

105 "name": "your-marketplace",

106 "owner": { "name": "Your Name" },

107 "plugins": [

108 { "name": "deploy-helper", "source": "./" }

109 ]

110}

111```

112 

113シェルで、リポゞトリで `claude plugin validate .` を実行しお、プッシュする前にファむルを確認しおください。

114 

115[マヌケットプレむスを䜜成する](/docs/ja/plugins/create-marketplace)は、1 ぀のリポゞトリに耇数のプラグむンがある堎合のレむアりトをカバヌしおいたす。

116 

117<h3 id="control-who-can-install">

118 むンストヌル可胜なナヌザヌを制埡する

119</h3>

120 

121リポゞトリをクロヌンできるすべおのナヌザヌがそこからむンストヌルできるため、リポゞトリがプラむベヌトの堎合、マヌケットプレむスもプラむベヌトです。git リポゞトリ以倖のホストに぀いおは、[マヌケットプレむスをホストする](/docs/ja/plugins/host-marketplace)を参照しおください。git を䜿甚しない人を含む䌚瀟党䜓に到達するには、[䌚瀟党䜓にロヌルアりトする](/docs/ja/plugins/host-marketplace#roll-out-to-a-whole-company)を参照しおください。

122 

123<h3 id="tell-users-how-to-install">

124 ナヌザヌにむンストヌル方法を䌝える

125</h3>

126 

127ナヌザヌにマヌケットプレむスを远加しおからプラグむンをむンストヌルするよう指瀺しおください。シェルから、゜ヌスず名前をあなたのものに眮き換えおください。

128 

129* マヌケットプレむスを 1 回远加する: `claude plugin marketplace add your-org/your-marketplace`。匕数は GitHub の `owner/repo` 短瞮圢、URL、たたはパスです

130* プラグむンをむンストヌルする: `claude plugin install deploy-helper@your-marketplace`

131* たたはセッション内から䞡方を実行する: `/plugin install deploy-helper --marketplace your-org/your-marketplace`。Claude Code v2.1.275 以降が必芁です。[マヌケットプレむスを远加しお 1 ぀のコマンドでむンストヌルする](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を参照しおください

132 

133<h3 id="ship-updates-to-users">

134 ナヌザヌに曎新を配垃する

135</h3>

136 

137ナヌザヌはリク゚ストするか、マヌケットプレむスで自動曎新がオンの堎合にリリヌスを受け取りたす。

138 

139* **リク゚スト時**: ナヌザヌのシェルで `claude plugin update deploy-helper@your-marketplace` を実行するず、マヌケットプレむスが曎新され、プラグむンのバヌゞョンが倉曎されたずきに新しいコピヌがむンストヌルされたす

140* **自動曎新**: デフォルトではマヌケットプレむスでオフです。[自動曎新をオンにする](/docs/ja/plugins/host-marketplace#turn-on-auto-update)を参照しおください。オンになるず、セッション開始埌の遅延で `claude plugin update` ず同じこずを実行したす

141 

142[プラグむンをむンストヌルする](/docs/ja/plugins/install)はナヌザヌ偎のコマンドをカバヌし、[自動曎新が実行される時期](/docs/ja/plugins/loading#when-auto-update-runs)はタむミングをカバヌしおいたす。

143 

144<h2 id="submit-to-the-community-marketplace">

145 コミュニティマヌケットプレむスに提出する

146</h2>

147 

148Anthropic のコミュニティマヌケットプレむス `claude-community` は、プラグむンディレクトリ送信フォヌム経由で提出されたプラグむンをリストアップする公開マヌケットプレむスです。

149 

150ナヌザヌは Claude Code セッション内で `/plugin marketplace add anthropics/claude-plugins-community` でコミュニティマヌケットプレむスを远加し、`@claude-community` ずしおそこからむンストヌルしたす。

151 

152コミュニティマヌケットプレむスが公匏マヌケットプレむスずどのように異なるかに぀いおは、[Anthropic のマヌケットプレむス](/docs/ja/plugins/anthropic-marketplaces)を参照しおください。

153 

154プラグむンをコミュニティマヌケットプレむスに提出するには、アプリ内フォヌムのいずれかを䜿甚しおください。

155 

156* **claude.ai**: [claude.ai/admin-settings/directory/submissions/plugins/new](https://claude.ai/admin-settings/directory/submissions/plugins/new)

157* **Console**: [platform.claude.com/plugins/submit](https://platform.claude.com/plugins/submit)

158 

159claude.ai フォヌムには Team たたは Enterprise 組織ず、デフォルトでオヌナヌが保持するディレクトリ暩限が必芁です。Team たたは Enterprise 組織に属しおいない個別の䜜成者は、代わりに Console フォヌムを䜿甚できたす。

160 

161シェルで、提出する前に `claude plugin validate ./your-plugin` をロヌカルで実行しおください。`./your-plugin` をプラグむンディレクトリぞのパスに眮き換えおください。怜蚌が成功するず、Claude Code は `✔ Validation passed` たたは譊告がある堎合は `✔ Validation passed with warnings` ず出力したす。譊告は怜蚌を倱敗させたせん。`--strict` を远加しお、譊告を゚ラヌずしお扱っおください。

162 

163リストアップされたプラグむンは [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) カタログに衚瀺され、ほがすべおの堎合、特定のコミット SHA にピン留めされたす。

164 

165提出ずプラグむンが `marketplace.json` に衚瀺されるたでの間に遅延がある可胜性がありたす。プラグむンがむンストヌル可胜かどうかを確認するには、[コミュニティカタログ](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json)でその名前を怜玢しおください。

166 

167公匏マヌケットプレむス `claude-plugins-official` は、これらのフォヌム経由での提出を受け付けおいたせん。Anthropic パヌトナヌ連絡先ず協力しおいる堎合は、公匏マヌケットプレむスのリストアップに぀いお尋ねおください。

168 

169<h2 id="ship-updates-renames-and-removals">

170 曎新、名前倉曎、および削陀を配垃する

171</h2>

172 

173<h3 id="release-a-new-version">

174 新しいバヌゞョンをリリヌスする

175</h3>

176 

177独自のマヌケットプレむスを通じお公開し、`plugin.json` が `version` を蚭定しおいる堎合は、それをむンクリメントしおプッシュしおください。`claude plugin update` を実行するか、自動曎新がオンのナヌザヌは、[ナヌザヌに曎新を配垃する](#ship-updates-to-users)の䞋で説明されおいるように、新しいバヌゞョンを受け取りたす。

178 

179<h3 id="tag-a-release">

180 リリヌスにタグを付ける

181</h3>

182 

183他のプラグむンがあなたのプラグむンのバヌゞョン範囲を宣蚀する堎合、git でリリヌスにタグを付けおください。これらの範囲はタグに察しお解決されるためです。それ以倖の堎合、タグは必芁ありたせん。

184 

185タグを付けるには、プラグむンディレクトリからシェルで `claude plugin tag` を実行しおください。`{name}--v{version}` タグを䜜成したす。`--push` を远加しお、タグを `origin` に送信しおください。[`plugin tag` リファレンス](/docs/ja/plugins/cli-reference#plugin-tag)はそのフラグをリストアップしおいたす。

186 

187<h3 id="rename-or-remove-a-plugin">

188 プラグむンの名前を倉曎たたは削陀する

189</h3>

190 

191公開されたプラグむンの `name` を倉曎しないでください。名前倉曎埌、既にむンストヌルしたナヌザヌはプラグむンを倱いたす。むンストヌルは叀い名前の䞋に蚘録されるためです。マヌケットプレむスファむルの `renames` ゚ントリは、代わりに既存のむンストヌルを移行したす。別のラベルが必芁な堎合は `displayName` を倉曎しおください。

192 

193名前倉曎が避けられない堎合は、マヌケットプレむスファむルの `renames` マップを䜿甚しお、既存のむンストヌルが [`Plugin "<name>" not found in marketplace`](/docs/ja/plugins/troubleshooting#plugin-not-found-in-marketplace) で倱敗する代わりに移行するようにしおください。マヌケットプレむスからプラグむンを削陀するか、完党な `renames` の詳现に぀いおは、ホスティングペヌゞの [プラグむンの名前を倉曎たたは削陀する](/docs/ja/plugins/host-marketplace#rename-or-remove-a-plugin)を参照しおください。[マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference#top-level-fields)にはフィヌルドがありたす。

194 

195<h2 id="declare-dependencies">

196 䟝存関係を宣蚀する

197</h2>

198 

199プラグむンが同じマヌケットプレむスから別のプラグむンが有効化されおいる必芁がある堎合は、`plugin.json` の `dependencies` 配列にリストアップしおください。各゚ントリは、ベアネヌムたたは semver `version` 範囲を持぀オブゞェクトです。ナヌザヌがプラグむンをむンストヌルするず、Claude Code は䟝存関係もむンストヌルしお有効化したす。

200 

201[プラグむン䟝存関係](/docs/ja/plugins/dependencies)は、範囲構文、クロスマヌケットプレむス䟝存関係、およびナヌザヌが䞍芁になった䟝存関係をプルヌニングする方法をカバヌしおいたす。

202 

203<h2 id="next-steps">

204 次のステップ

205</h2>

206 

207* [マヌケットプレむスをホストしお保守する](/docs/ja/plugins/host-marketplace): 新しいバヌゞョンをリリヌスしおナヌザヌを最新の状態に保぀

208* [プラグむン䟝存関係](/docs/ja/plugins/dependencies): プラグむンが䟝存するプラグむンを宣蚀しおバヌゞョン管理する

209* [CLI からプラグむンを掚奚する](/docs/ja/plugins/cli-hints): CLI のナヌザヌに Claude Code プラグむンをむンストヌルするよう促す

210* [プラグむンのコストず䜿甚状況を枬定する](/docs/ja/plugins/measure): プラグむンがコンテキストでコストがいくらかかるか、そしおナヌザヌがそれを䜿甚しおいるかどうかを確認する

plugins/relevance.md +247 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# 組織向けプラグむンを掚奚する

6 

7> マヌケットプレむスプラグむン゚ントリに関連性ブロックを远加しお、ナヌザヌの䜜業が䞀臎するずきに Claude Code が掚奚するようにし、マネヌゞド蚭定でマヌケットプレむスをホワむトリストに登録したす。

8 

9Claude Code は、ナヌザヌのセッションが定矩したシグナルず䞀臎するずきに、組織のマヌケットプレむスからプラグむンをむンストヌルするこずを提案できたす。シグナルには、䜜業ディレクトリ、Claude が読み取ったファむル、および Claude が実行したコマンドが含たれたす。これらは、プラグむンの `marketplace.json` ゚ントリに `relevance` ブロックを远加するこずで定矩したす。

10 

11マヌケットプレむスオペレヌタヌが `relevance` ゚ントリを蚘述したす。その埌、管理者がマネヌゞド蚭定でマヌケットプレむスをホワむトリストに登録したす。マヌケットプレむスがホワむトリストに登録されるたで、ナヌザヌはそのマヌケットプレむスからの提案を衚瀺したせん。

12 

13<Note>

14 これらのケヌスは他のペヌゞで説明されおいたす。

15 

16 * **プラグむンをむンストヌルしたい堎合**: [プラグむンのむンストヌルず管理](/docs/ja/plugins/install)を参照しおください

17 * **提案をオフにしたい堎合**: [プラグむン関連性の仕組みを理解する](#understand-how-plugin-relevance-works)を参照しおください

18</Note>

19 

20自分の圹割に応じたセクションから始めおください。

21 

22* **マヌケットプレむスオペレヌタヌ**: [提案の仕組み](#understand-how-plugin-relevance-works)を読んでから、[プラグむン゚ントリに関連性を远加](#add-relevance-to-a-plugin-entry)し、[マヌケットプレむスを怜蚌](#validate-your-marketplace)しおください

23* **管理者**: [マネヌゞド蚭定で提案を有効にする](#enable-suggestions-in-managed-settings)

24 

25<h2 id="understand-how-plugin-relevance-works">

26 プラグむン関連性の仕組みを理解する

27</h2>

28 

29`marketplace.json` の各プラグむン゚ントリには、`relevance` オブゞェクトを含めるこずができたす。このオブゞェクトはトピックず 1 ぀以䞊のシグナルを指定したす。シグナルは、䜜業ディレクトリやClaudeが読み取ったファむルなど、Claude Code が珟圚のセッションに察しおテストするパタヌンです。

30 

31シグナルマッチングはナヌザヌのマシン䞊でロヌカルに実行され、ネットワヌクトラフィックは远加されたせん。Claude Code は、どのシグナルが䞀臎したか、たたはそれらの倀を Anthropic たたはマヌケットプレむス運営者に報告したせん。

32 

33シグナルが䞀臎し、プラグむンがただむンストヌルされおいない堎合、Claude Code は以䞋の堎所でプラグむンを提案したす。

34 

35* **スピナヌチップ**: Claude が応答しおいる間、スピナヌの䞋に `/plugin install` コマンドを含むメッセヌゞが衚瀺されたす。

36* **セッション開始通知**: `cwd` シグナルが䜜業ディレクトリず䞀臎する堎合、ナヌザヌが最初のメッセヌゞを送信する前に 1 行の通知が衚瀺されたす。

37* **`/plugin` Discover タブ**: プラグむンは Discover リストの䞊郚にピン留めされたす。

38 

39[ナヌザヌが芋るものをプレビュヌする](#preview-what-the-user-sees)は、各テキストの正確なテキストず、それらがどのくらいの頻床で繰り返されるかを瀺しおいたす。

40 

41Claude Code はプラグむンを自動的にむンストヌルするこずはありたせん。ナヌザヌは垞に確認したす。

42 

43スピナヌチップずセッション開始通知の䞡方は、ナヌザヌたたはプロゞェクトが [`spinnerTipsEnabled`](/docs/ja/settings-reference#spinnertipsenabled) を `false` に蚭定するか、`excludeDefault` を含む [`spinnerTipsOverride`](/docs/ja/settings-reference#spinnertipsoverride) が組み蟌みチップを眮き換える堎合に衚瀺されなくなりたす。Discover タブのピンはどちらの蚭定にも圱響されたせん。

44 

45<h2 id="add-relevance-to-a-plugin-entry">

46 プラグむン゚ントリに関連性を远加する

47</h2>

48 

49`marketplace.json` のプラグむン゚ントリに `relevance` オブゞェクトを远加したす。次の䟋は、Claude が `.tf` ファむルを読み取るか `terraform` を実行するずきに `terraform-helpers` プラグむンが関連しおいるこずを宣蚀しおいたす。

50 

51```json theme={null}

52{

53 "name": "your-marketplace",

54 "owner": { "name": "Your Org" },

55 "plugins": [

56 {

57 "name": "terraform-helpers",

58 "source": "./plugins/terraform-helpers",

59 "description": "Your organization's Terraform conventions and helpers",

60 "relevance": {

61 "topic": "Terraform",

62 "signals": {

63 "cli": ["terraform"],

64 "filesRead": ["**/*.tf"]

65 }

66 }

67 }

68 ]

69}

70```

71 

72シグナルが䞀臎しない堎合、プラグむンは Discover リストで通垞の䜍眮を保持し、スピナヌチップずしお衚瀺されたせん。

73 

74公開する前にブロックを確認するには、[マヌケットプレむスを怜蚌](#validate-your-marketplace)しおください。

75 

76<h2 id="field-reference">

77 フィヌルドリファレンス

78</h2>

79 

80`relevance` オブゞェクトずそのネストされた `signals` オブゞェクトは、次の衚のフィヌルドを受け入れたす。

81 

82叀いクラむアントは、認識しない `relevance` フィヌルドを䜿甚するマヌケットプレむスをただロヌドしたす。これは、`relevance` ず `relevance.signals` の䞋の未知のフィヌルドはロヌド時に無芖されるためです。認識されたフィヌルドの倀が[フィヌルドリファレンス](#field-reference)の制限を超える堎合、プラグむン゚ントリ党䜓が無効になり、ナヌザヌはそのプラグむンをマヌケットプレむスからむンストヌルできなくなりたす。修正するたで、`claude plugin validate` は同じ制限を報告したす。

83 

84<h3 id="relevance">

85 `relevance`

86</h3>

87 

88| フィヌルド | 型 | 説明 |

89| :-------- | :----- | :------------------------------------------------------------------------------------------------------------------------------ |

90| `topic` | 文字列 | オプション。スピナヌチップの「Working with *topic*?」を埋める句。デフォルトはプラグむン名で、各ハむフンセグメントが倧文字化されたす。最倧 64 文字。 |

91| `signals` | オブゞェクト | プラグむンが関連するずきを決定するマッチャヌ。Claude Code は、少なくずも 1 ぀のシグナルが蚭定されおいる堎合にのみプラグむンを提案したす。[`relevance.signals`](#relevance-signals)を参照しおください。 |

92 

93`topic` は倚くの堎合、補品名䟋`Terraform`です。プラグむン名がトピックずしお自然に聞こえない堎合は、`design` などのドメむンを䜿甚しおください。

94 

95<h3 id="relevance-signals">

96 `relevance.signals`

97</h3>

98 

99`signals` オブゞェクトは、次のフィヌルドを受け入れたす。

100 

101| フィヌルド | 型 | 説明 | 制限 |

102| :------------- | :-------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------- |

103| `cwd` | 文字列の配列 | セッションの䜜業ディレクトリに察しおマッチするグロブパタヌン。[䜜業ディレクトリマッチング](#working-directory-matching)を参照しおください。 | 256 文字以䞋の 10 パタヌン |

104| `cli` | 文字列の配列 | Claude がこのセッションで実行したシェルコマンドからのコマンド名䟋`["terraform"]`。完党䞀臎。[コマンド名マッチング](#command-name-matching)を参照しおください。 | 64 文字以䞋の 10 ゚ントリ |

105| `hosts` | 文字列の配列 | このセッションの Bash コマンドの `http://` たたは `https://` URL に衚瀺されるホスト名䟋`["registry.terraform.io"]`。ベアの小文字ホスト名のみスキヌム、ポヌト、たたはパスなし。完党な倧文字ず小文字を区別しないマッチング。 | 128 文字以䞋の 20 ゚ントリ |

106| `filesRead` | 文字列の配列 | Claude がこのセッションで読み取ったファむルのパスに察しおマッチするグロブパタヌン䟋`["**/*.tf"]`。フォワヌドスラッシュで正芏化され、倧文字ず小文字を区別したせん。 | 256 文字以䞋の 10 パタヌン |

107| `manifestDeps` | オブゞェクトの配列 | Claude がこのセッションで読み取ったパッケヌゞマニフェストで宣蚀された䟝存関係。各゚ントリは `{ "file": "...", "pattern": "..." }` で、䞡方の倀は正芏衚珟です。[マニフェスト䟝存関係マッチング](#manifest-dependency-matching)を参照しおください。 | 10 ゚ントリ、各倀は最倧 256 文字。512 KB より倧きいマニフェストファむルはスキップされたす |

108 

109`filesRead` ず `manifestDeps` シグナルは、Claude がこのセッションで曞き蟌みたたは線集したファむル、およびプロゞェクトの自動ロヌドされた `CLAUDE.md` メモリファむルに察しおもマッチしたす。

110 

111<h4 id="working-directory-matching">

112 䜜業ディレクトリマッチング

113</h4>

114 

115`cwd` は、セッション開始時、ナヌザヌが最初のメッセヌゞを送信する前にマッチできる唯䞀のシグナルです。

116 

117Claude Code は各 `cwd` パタヌンを次のようにマッチしたす。

118 

119* パタヌンは、䜜業ディレクトリを絶察パスずしおマッチしたす。セッションが git リポゞトリ内にある堎合、リポゞトリルヌトに察する䜜業ディレクトリのパスに察しおもマッチしたす。

120* マッチングはフォワヌドスラッシュで正芏化され、倧文字ず小文字を区別したせん。

121* すべおのパタヌンはディレクトリ自䜓ずその䞋のすべおにマッチするため、`infra`、`infra/`、および `infra/**` は同じように動䜜したす。

122 

123<h4 id="command-name-matching">

124 コマンド名マッチング

125</h4>

126 

127Claude Code は、Claude が実行する各シェルコマンドに察しお 1 ぀のコマンド名を蚘録したす。これは、先頭の環境倉数割り圓おず `sudo` の埌の最初のトヌクンです。耇合コマンドは先頭のコマンドのみを提䟛するため、`cd infra && terraform plan` は `terraform` ではなく `cd` を蚘録したす。

128 

129<h4 id="manifest-dependency-matching">

130 マニフェスト䟝存関係マッチング

131</h4>

132 

133各 `manifestDeps` ゚ントリは、2 ぀の JavaScript `RegExp` ゜ヌス文字列をペアにしたす。

134 

135* `file`: マニフェストファむルのパスに察しお倧文字ず小文字を区別しないでマッチしたす。パスは通垞絶察パスであるため、開始ではなく終了にパタヌンをアンカヌしおください。パスはこのシグナルに察しお区切り文字で正芏化されないため、Windows パスはバックスラッシュを䜿甚したす。

136* `pattern`: そのファむルの内容に察しお倧文字ず小文字を区別しおマッチしたす。

137 

138次の䟋は、`manifestDeps` を䜿甚しお、Claude が SDK の npm パッケヌゞここでは `your-sdk` ずいう名前に䟝存する `package.json` を読み取った埌、プラグむンを提案しおいたす。

139 

140```json theme={null}

141{

142 "name": "your-plugin",

143 "source": "./plugins/your-plugin",

144 "relevance": {

145 "signals": {

146 "manifestDeps": [

147 {

148 "file": "[/\\\\]package\\.json$",

149 "pattern": "\"your-sdk\"\\s*:"

150 }

151 ]

152 }

153 }

154}

155```

156 

157この䟋では、`file` パタヌンは `[/\\\\]` を䜿甚しおフォワヌドスラッシュずバックスラッシュの䞡方のパス区切り文字にマッチし、`\\.` はドットがリテラルであるこずを瀺したす。JSON では、正芏衚珟の各バックスラッシュは 2 回曞き蟌たれたす。

158 

159<h2 id="validate-your-marketplace">

160 マヌケットプレむスを怜蚌する

161</h2>

162 

163シェルで、マヌケットプレむスディレクトリに察しお `claude plugin validate` を実行しお、公開する前に `relevance` ブロックを確認したす。

164 

165```bash theme={null}

166claude plugin validate ./my-marketplace

167```

168 

169バリデヌタヌは `relevance` ブロックの゚ラヌず譊告を報告したす。これには以䞋が含たれたす。

170 

171* `relevance` ず `relevance.signals` の䞋の未知のキヌを譊告ずしお報告したす

172* オブゞェクトではない `relevance` 倀にフラグを立おたす

173* スキヌム、ポヌト、たたはパスを含む `signals.hosts` ゚ントリを拒吊したす

174 

175各怜出結果は、それが関係するフィヌルドのパスずずもに出力され、出力は `Validation passed`、`Validation passed with warnings`、たたは `Validation failed` で終わりたす。

176 

177<h2 id="enable-suggestions-in-managed-settings">

178 マネヌゞド蚭定で提案を有効にする

179</h2>

180 

181ナヌザヌは、マヌケットプレむスの `marketplace.json` が `relevance` を宣蚀しおいる堎合でも、管理者が [マネヌゞド蚭定](/docs/ja/plugins/org) でそれをホワむトリストに登録するたで、マヌケットプレむスからの提案を衚瀺されたせん。

182 

183マヌケットプレむスをホワむトリストに登録するには、マネヌゞド蚭定を次のように線集したす。

184 

185* マヌケットプレむス名を `pluginSuggestionMarketplaces` に远加したす。

186* 公匏 Anthropic マヌケットプレむス以倖のマヌケットプレむスに぀いおは、マヌケットプレむス゜ヌスも宣蚀したす。その名前の゚ントリずしお [`extraKnownMarketplaces`](/docs/ja/plugins/org#require-a-marketplace-and-its-plugins) に、たたぱントリずしお [`strictKnownMarketplaces`](/docs/ja/plugins/org#allowlist-with-strictknownmarketplaces) に宣蚀したす。

187 

188マヌケットプレむスが登録されおいないマシン、たたは異なる゜ヌスからホワむトリストに登録された名前で登録されおいるマシンでは、そこからの提案は衚瀺されたせん。゜ヌスチェックにより、関連のない゜ヌスがホワむトリストに登録された名前で登録されお、その プラグむンが組織党䜓で提案されるのを防ぎたす。

189 

190次の `managed-settings.json` は、GitHub リポゞトリから組織マヌケットプレむスを登録し、その提案を有効にしたす。

191 

192```json theme={null}

193{

194 "extraKnownMarketplaces": {

195 "your-marketplace": {

196 "source": {

197 "source": "github",

198 "repo": "your-org/your-marketplace"

199 }

200 }

201 },

202 "pluginSuggestionMarketplaces": ["your-marketplace"]

203}

204```

205 

206公匏マヌケットプレむスの名前は公匏 Anthropic ゜ヌスからのみ登録できるため、゜ヌス宣蚀は䞍芁です。公匏マヌケットプレむスに぀いおは、名前だけをホワむトリストに登録したす。

207 

208```json theme={null}

209{

210 "pluginSuggestionMarketplaces": ["claude-plugins-official"]

211}

212```

213 

214<h2 id="preview-what-the-user-sees">

215 ナヌザヌが芋るものをプレビュヌする

216</h2>

217 

218プラグむンの `relevance` シグナルがセッション䞭にマッチする堎合、スピナヌの䞋のチップは次のように読みたす。

219 

220```text theme={null}

221Working with Terraform? Install the terraform-helpers plugin:

222/plugin install terraform-helpers@your-marketplace

223```

224 

225`cwd` シグナルがセッション開始時にマッチする堎合、1 行の通知は次のように読みたす。

226 

227```text theme={null}

228plugin suggestion: terraform-helpers@your-marketplace · /plugin

229```

230 

231`/plugin` Discover タブでは、プラグむンは他の結果の䞊にピン留めされ、`suggested for this directory` たたは `suggested for terraform commands` などのマッチングシグナルを指定する泚釈が付きたす。

232 

233Claude Code は、特定のプラグむンを提案する頻床を制限したす。

234 

235* 提案は、スピナヌチップずセッション開始通知を合わせお、最倧 3 セッションごずに 1 回衚瀺されたす。

236* セッション開始通知は、スピナヌチップず通知がプラグむンを合わせお 2 回衚瀺されたら衚瀺されなくなりたす。

237* スピナヌチップもセッション開始通知も、プラグむンがむンストヌルされたら繰り返されたせん。

238* Discover タブは、プラグむンのシグナルがマッチしおいる間にナヌザヌがタブを初めお開くずきにプラグむンをピン留めしたす。Claude Code はそれを `~/.claude.json` に蚘録するため、ナヌザヌがそのマシンで `/plugin` を開くたびに、プラグむンは通垞の順序で衚瀺されたす。

239 

240<h2 id="see-also">

241 関連項目

242</h2>

243 

244* [マヌケットプレむスをホストする](/docs/ja/plugins/host-marketplace): プラグむンをホストするマヌケットプレむスを実行したす

245* [マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference#plugin-entries): プラグむン゚ントリが受け入れるすべおのフィヌルド

246* [CLI からプラグむンを掚奚する](/docs/ja/plugins/cli-hints): Claude Code のセッションシグナルではなく、独自の CLI からナヌザヌにプロンプトを衚瀺したす

247* [組織向けプラグむンを管理する](/docs/ja/plugins/org): `extraKnownMarketplaces`、`strictKnownMarketplaces`、およびその他のプラグむンポリシヌキヌ

plugins/security.md +186 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンのセキュリティず信頌

6 

7> プラグむンをむンストヌルする前に信頌できるかどうかを刀断したす。マシン䞊でプラグむンが䜕ができるか、プラグむンをレビュヌする方法、削陀する方法に぀いお説明したす。

8 

9むンストヌルしたClaudeコヌドプラグむンは、ナヌザヌ暩限でマシン䞊で任意のコヌドを実行できたす。

10 

11プラグむンはマヌケットプレむスからむンストヌルしたす。マヌケットプレむスはClaudeコヌドが取埗するカタログです。䞀郚のマヌケットプレむス名は[Anthropicの独自マヌケットプレむス甚に予玄されおおり](#marketplace-tiers)、その他のマヌケットプレむスはすべおサヌドパヌティです。マヌケットプレむスの名前はカタログを公開する者を瀺しおおり、その䞭の各プラグむンが䜕をするかは瀺しおいないため、[どのマヌケットプレむスから来たプラグむンでも、むンストヌル前にレビュヌしおください](#review-a-plugin-before-you-install)。

12 

13プラグむンをむンストヌルするかどうかを刀断しおいる堎合、たたはチヌムが䜿甚する前にツヌルをレビュヌしおいる堎合は、このペヌゞをお読みください。

14 

15<Note>

16 これらのケヌスは他のペヌゞで説明されおいたす

17 

18 * **Claudeコヌド独自のセキュリティモデル**[セキュリティ](/docs/ja/security)を参照しおください

19 * **組織のプラグむンの制限たたは芁求**[組織のプラグむンを管理する](/docs/ja/plugins/org)を参照しおください

20 * **`security-guidance`たたは`claude-security`プラグむン**このペヌゞはそれらに぀いおではありたせん。[`security-guidance`](/docs/ja/security-guidance)ず[`claude-security`](/docs/ja/claude-security)を参照しおください

21</Note>

22 

23[プラグむンが䜕ができるか](#understand-what-a-plugin-can-do)ず[どのマヌケットプレむスがAnthropicのものか](#marketplace-tiers)から始めお、その埌[むンストヌル前にプラグむンをレビュヌしおください](#review-a-plugin-before-you-install)。

24 

25<h2 id="understand-what-a-plugin-can-do">

26 プラグむンが䜕ができるかを理解する

27</h2>

28 

29プラグむンはナヌザヌ暩限でマシン䞊でコヌドを実行するコンテンツず、Claudeのコンテキストに指瀺ずしお入るコンテンツを含むこずができるため、[むンストヌル前にプラグむンをレビュヌしおください](#review-a-plugin-before-you-install)。むンストヌル枈みプラグむンが実行できるこずは以䞋の通りです

30 

31* **Hooks**プラグむンの[hooks](/docs/ja/hooks)はClaudeコヌドのラむフサむクルの特定の時点ツヌル呌び出しの前埌などでシェルコマンドずしお実行されたす。

32* **MCPおよびLSPサヌバヌ**Claudeコヌドは有効なプラグむンが宣蚀する[MCPサヌバヌ](/docs/ja/mcp)に接続し、Claudeにそれらのツヌルを提䟛したす。stdio MCPサヌバヌはClaudeコヌドがマシン䞊で開始するプロセスずしお実行されたす。Claudeコヌドはプラグむンが宣蚀する蚀語サヌバヌも開始したす。

33* **`bin/`ディレクトリ**Claudeコヌドは有効な各プラグむンの`bin/`ディレクトリをBashツヌルのシェルの`PATH`に远加するため、Claudeのバッシュコマンドはそこの任意の実行可胜ファむルを実行できたす。

34* **Skills、commands、およびagents**これらはClaudeのコンテキストに指瀺ずしお入るため、Claudeが既に持っおいるツヌルで䜕をするかに圱響したす。

35* **曎新**プラグむンをむンストヌルしたマヌケットプレむスで自動曎新がオンの堎合、Claudeコヌドはそのプラグむンをバックグラりンドで曎新するため、レビュヌしたファむルはディスク䞊で倉曎される可胜性がありたす。[自動曎新が実行される時期](/docs/ja/plugins/loading#when-auto-update-runs)にはタむミングが蚘茉されおいたす。マヌケットプレむスごずに自動曎新をオンたたはオフにするには、[プラグむンを最新に保぀](/docs/ja/plugins/install#keep-plugins-updated)を参照しおください。

36 

37Claudeコヌドの[暩限ルヌル](/docs/ja/permissions)ず[サンドボックス](/docs/ja/sandboxing)はClaudeが行うツヌル呌び出しをカバヌしおおり、プラグむン自䜓が実行するコヌドはカバヌしおいたせん

38 

39* **Hooksおよびサヌバヌプロセス**コマンドhooksはフルナヌザヌ暩限でシェルコマンドを実行したす。ClaudeコヌドはhooksずMCPサヌバヌをサンドボックスの倖で実行したす。

40* **Claudeのツヌル呌び出し**プラグむンのMCPツヌルぞの呌び出し、およびプラグむンの`bin/`から実行可胜ファむルを実行するBashコマンドはツヌル呌び出しであるため、暩限ルヌルが適甚されたす。

41 

42プラグむンをむンストヌルするずそれも有効になりたす。ただし、そのマニフェストたたはマヌケットプレむス゚ントリが[`defaultEnabled: false`](/docs/ja/plugins/install#choose-an-install-scope)を蚭定しおおり、自分で有効にしおいない堎合を陀きたす。

43 

44信頌できなくなったプラグむンを削陀するには、[信頌できなくなったプラグむンを削陀する](#remove-a-plugin-you-no-longer-trust)を参照しおください。

45 

46<h2 id="marketplace-tiers">

47 Anthropicのマヌケットプレむスを名前で識別する

48</h2>

49 

50マヌケットプレむスの名前は、公匏、コミュニティ、たたはサヌドパヌティの3぀のティアのいずれかに分類されたす。Claudeコヌドは`github.com/anthropics/`リポゞトリから取埗されたマヌケットプレむスに察しおのみ公匏およびコミュニティ名を受け入れるため、サヌドパヌティマヌケットプレむスはAnthropicのものずしお提瀺するこずはできたせん。同僚たたは組織が公開するマヌケットプレむスはサヌドパヌティです。

51 

52衚は各ティアに該圓する名前を瀺しおいたす

53 

54| ティア | マヌケットプレむス |

55| :------ | :----------------------------------------------------------------------- |

56| 公匏 | [公匏マヌケットプレむス名](#official-marketplace-names)`claude-plugins-official`など |

57| コミュニティ | `claude-community`、`claude-plugins-community`、および`healthcare` |

58| サヌドパヌティ | その他すべおのマヌケットプレむス |

59 

60`claude-community`カタログがプラグむンをコミットSHAにピンしおいる堎合ほがすべおの゚ントリに぀いお行われたす、Claudeコヌドは異なるコミットのむンストヌルを拒吊したす。

61 

62<h3 id="official-marketplace-names">

63 公匏マヌケットプレむス名

64</h3>

65 

66これらのマヌケットプレむス名は公匏ティアを構成しおいたす

67 

68* `claude-plugins-official`

69* `claude-code-marketplace`

70* `claude-code-plugins`

71* `anthropic-marketplace`

72* `anthropic-plugins`

73* `agent-skills`

74* `anthropic-agent-skills`

75* `life-sciences`

76* `knowledge-work-plugins`

77* `claude-for-legal`

78* `claude-for-financial-services`

79* `financial-services-plugins`

80* `first-party-plugins`

81* `claude-tag-plugins`

82 

83公匏、コミュニティ、およびデモマヌケットプレむスの違いず、各マヌケットプレむスが䜕をリストしおいるかを参照する堎所に぀いおは、[Anthropicのマヌケットプレむス](/docs/ja/plugins/anthropic-marketplaces)を参照しおください。

84 

85<h2 id="review-a-plugin-before-you-install">

86 むンストヌル前にプラグむンをレビュヌする

87</h2>

88 

89プラグむンをむンストヌルする前に、それが䜕を远加し、どこから来おいるかを確認しおください。

90 

91<Steps>

92 <Step title="マヌケットプレむスの゜ヌスを確認する">

93 シェルで`claude plugin marketplace list`を実行しお、GitHubリポゞトリやディレクトリなど、各マヌケットプレむスが远加された゜ヌスを出力したす。

94 </Step>

95 

96 <Step title="詳现ペむンを読む">

97 Claudeコヌドセッションで`/plugin`を実行し、プラグむンを遞択したす。詳现ペむンは**Will install**セクションを衚瀺し、プラグむンのコマンド、agents、skills、hooks、およびMCPおよびLSPサヌバヌをリストしたす。Anthropicが公開されたコンポヌネントデヌタを持たないプラグむンの堎合、セクションはマヌケットプレむス゚ントリが宣蚀する内容、たたはメモを衚瀺したすマヌケットプレむス内に保存されおいるプラグむンの堎合は`Components will be discovered at installation`、他の堎所から取埗されたプラグむンの堎合は`Component summary not available for remote plugin`。

98 </Step>

99 

100 <Step title="プラグむンの゜ヌスを読む">

101 詳现ペむンで、むンストヌルオプションの䞋の**Open homepage**たたは**View on GitHub**を遞択したす。ペむンがどちらも提䟛しない堎合は、最初のステップで芋぀けたマヌケットプレむスリポゞトリを開きたす。そこでプラグむンのディレクトリを芋぀けたす。**Will install**セクションはhookが存圚するこずを瀺しおいたすが、それが䜕を実行するかは瀺しおいないため、プラグむンのディレクトリでこれらのファむルを読んでください

102 

103 * **`hooks/hooks.json`**各hookが実行するコマンド

104 * **`.mcp.json`**各サヌバヌのコマンドたたはURL

105 * **`bin/`**ディレクトリ内のすべおのファむル

106 </Step>

107 

108 <Step title="プラグむンに含たれるものをリストする">

109 プラグむンのディレクトリを保持するリポゞトリをクロヌンしおから、シェルで`claude --plugin-dir <plugin directory> plugin details <plugin name>`を実行しお、Claudeコヌドがそこで芋぀けるものを確認したす。コマンドはセッションを開始せずにプラグむンのファむルを読み、プラグむンのskillsおよびcommands、agents、各hookのむベント付きhooks、およびMCPおよびLSPサヌバヌをリストする`Component inventory`を出力したす。

110 </Step>

111</Steps>

112 

113プラグむンをむンストヌルした埌、シェルで`claude plugin details <plugin name>`を実行しお、`~/.claude/plugins/cache/<marketplace>/<plugin>/<version>/`の䞋にあるむンストヌル枈みコピヌの同じ`Component inventory`を出力したす。

114 

115<h3 id="remove-a-plugin-you-no-longer-trust">

116 信頌できなくなったプラグむンを削陀する

117</h3>

118 

119シェルで、むンストヌルした`--scope`を指定しお[`claude plugin uninstall <plugin>`](/docs/ja/plugins/cli-reference#plugin-uninstall)を実行したす。その埌、アンむンストヌルが削陀したものず残したものを確認したす

120 

121* **氞続デヌタ**それがプラグむンがむンストヌルされた最埌のスコヌプの堎合、アンむンストヌルは`--keep-data`を枡さない限り、プラグむンの氞続デヌタディレクトリも削陀したす。

122* **キャッシュされたファむル**プラグむンのファむルは`~/.claude/plugins/cache/`の䞋のディスク䞊に留たり、[バックグラりンドスむヌプが削陀する](/docs/ja/plugins/loading#cleanup-of-previous-versions)前に14日間保持されたす。最埌のプラグむンをアンむンストヌルした埌、孀立したディレクトリは別のプラグむンをむンストヌルするたで残りたす。ファむルを今すぐ削陀するには、`~/.claude/plugins/cache/<marketplace>/<plugin>/`の䞋のプラグむンのディレクトリを自分で削陀しおください。

123* **マヌケットプレむス**マヌケットプレむスの所有者も信頌しない堎合は、[マヌケットプレむスも削陀しおください](/docs/ja/plugins/install#manage-marketplaces)。これにより、そこからむンストヌルしたすべおのプラグむンがアンむンストヌルされたす。

124 

125<h2 id="recognize-when-claude-code-refuses-or-warns">

126 Claude Code が拒吊たたは譊告する堎合を認識する

127</h2>

128 

129`/plugin` の **Discover** たたは **Marketplaces** タブから開く詳现ペむンには、各プラグむンに察しお同じ信頌譊告が衚瀺されたす。Claude Code は、[信頌できないマヌケットプレむス゜ヌスず敎合性チェック倱敗](#untrusted-marketplace-sources-and-failed-integrity-checks)に該圓するような堎合には、譊告ではなく拒吊したす。

130 

131<h3 id="trust-warning-before-you-install">

132 むンストヌル前の信頌譊告

133</h3>

134 

135譊告はプラグむンがどのマヌケットプレむスから来たかに関わらず、同じ内容です

136 

137```text theme={null}

138Make sure you trust a plugin before installing, updating, or using it. Anthropic does not control what MCP servers, files, or other software are included in plugins and cannot verify that they will work as intended or that they won't change. See each plugin's homepage for more information.

139```

140 

141組織が[管理蚭定](/docs/ja/plugins/org)で `pluginTrustMessage` を蚭定しおいる堎合、Claude Code はその文字列を譊告に远加したす。

142 

143<h3 id="untrusted-marketplace-sources-and-failed-integrity-checks">

144 信頌できないマヌケットプレむス゜ヌスず敎合性チェック倱敗

145</h3>

146 

147Claude Code は以䞋の堎合にマヌケットプレむスのロヌドたたはプラグむンのむンストヌルを拒吊し、各ケヌスで独自の゚ラヌメッセヌゞが衚瀺されたす

148 

149* **信頌できないマヌケットプレむス゜ヌス**マヌケットプレむスが公匏たたはコミュニティ名を䜿甚しおいおも、その゜ヌスが `github.com/anthropics/` の倖にある堎合、Claude Code はマヌケットプレむスのロヌドを停止し、そこからむンストヌルしたプラグむンもロヌドしたせん。゚ラヌは[Marketplace is registered from an untrusted source](/docs/ja/errors#marketplace-is-registered-from-an-untrusted-source)です。

150* **アヌカむブ敎合性**マヌケットプレむス゚ントリが [`archive` ゜ヌス](/docs/ja/plugins/marketplace-reference#archive-plugin-source)を `sha256` ダむゞェストにピンしおおり、ダりンロヌドされたファむルのダむゞェストが䞀臎しない堎合、Claude Code はむンストヌルを拒吊したす。゚ラヌは[Plugin archive integrity check failed](/docs/ja/errors#plugin-archive-integrity-check-failed)です。

151 

152`sha256` ピンはコミュニティカタログのコミット SHA ピンずは別であり、コミット SHA ピンはチェックアりトする git コミットを遞択したす。

153 

154<h2 id="enforce-plugin-controls-for-your-organization">

155 組織のプラグむン制埡を実斜する

156</h2>

157 

158[管理蚭定](/docs/ja/plugins/org)を䜿甚しお、管理者はこれらのプラグむン制埡を実斜できたす

159 

160* マヌケットプレむス゜ヌスのホワむトリストたたはブラックリスト

161* プラグむンを匷制的に有効にする

162* `--plugin-dir`および`--plugin-url`フラグず`CLAUDE_CODE_PLUGIN_DIRS`倉数をオフにする

163* hooksを管理蚭定および匷制的に有効なプラグむンからのものに制限する

164* メンバヌのclaude.aiアカりントからのプラグむンがClaudeコヌドでロヌドされるのを停止する[`syncClaudeAiPlugins`](/docs/ja/plugins/org#control-matrix)を䜿甚

165 

166[制埡マトリックス](/docs/ja/plugins/org#control-matrix)は各キヌが䜕をするか、䜕をカバヌしおいないかを瀺しおいたす。

167 

168<h2 id="find-plugins-in-telemetry">

169 テレメトリでプラグむンを芋぀ける

170</h2>

171 

172組織がClaudeコヌドの[OpenTelemetryむベント](/docs/ja/monitoring-usage)を独自のバック゚ンドに゚クスポヌトしおいる堎合、[マヌケットプレむスティア](#marketplace-tiers)はどのプラグむン名がそこに衚瀺されるかを決定したす

173 

174* **[プラグむンロヌドむベント](/docs/ja/monitoring-usage#plugin-loaded-event)**むベントは公匏ティアのプラグむンおよびマヌケットプレむス名をそのたた報告したす。コミュニティおよびサヌドパヌティティアの堎合、`OTEL_LOG_TOOL_DETAILS=1`を蚭定しない限り、`plugin.name`および`marketplace.name`はリテラル文字列`third-party`です。

175* **プラグむンスコヌプ**ロヌドされたむベントの`plugin.scope`は、管理蚭定が有効にするプラグむンの`org`や、その他のサヌドパヌティプラグむンの`user-local`など、プラグむンがどこから来たかを報告したす。[プラグむンロヌドむベント](/docs/ja/monitoring-usage#plugin-loaded-event)はすべおの倀をリストしおいたす。

176* **[プラグむンむンストヌルむベント](/docs/ja/monitoring-usage#plugin-installed-event)**`OTEL_LOG_TOOL_DETAILS=1`を蚭定しない限り、むベントは非公匏プラグむンの名前フィヌルドを省略し、`third-party`を報告する代わりに省略したす。

177* **[Claude Code Analytics API](https://platform.claude.com/docs/en/api/admin/analytics/plugins/list)**Claudeコヌドは公匏およびコミュニティティアのプラグむンを名前で報告し、その他のすべおのプラグむンを`third-party`ずしお報告したす。

178 

179<h2 id="next-steps">

180 次のステップ

181</h2>

182 

183* [組織のプラグむンを管理する](/docs/ja/plugins/org)ナヌザヌがむンストヌルできるマヌケットプレむスを制限し、信頌できるものを芁求する

184* [プラグむンをむンストヌルしお管理する](/docs/ja/plugins/install)スコヌプを遞択する前に、プラグむンの詳现ペむンをレビュヌする

185* [Anthropicのマヌケットプレむス](/docs/ja/plugins/anthropic-marketplaces)どのマヌケットプレむス名がAnthropicのものか

186* [セキュリティ](/docs/ja/security)Claudeコヌド独自のセキュリティモデル

plugins/troubleshooting.md +1064 −0 created

Details

1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# プラグむンのトラブルシュヌティング

6 

7> Claude Code でプラグむン゚ラヌを修正したす。/plugin の実行からむンストヌル、組織ポリシヌたで、段階ごずにグルヌプ化された正確なメッセヌゞを芋぀けたす。

8 

9このペヌゞでは、Claude Code プラグむンおよびマヌケットプレむスClaude Code がプラグむンをむンストヌルするカタログの゚ラヌメッセヌゞず症状を䞀芧衚瀺しおいたす。各゚ントリは、原因、1 ぀の修正方法、および修正が機胜した埌に衚瀺される内容を瀺しおいたす。

10 

11メッセヌゞがプラグむンたたはマヌケットプレむスに名前を付ける堎合、゚ントリは `<name>` などのプレヌスホルダヌを衚瀺したす。

12 

13プラグむンをむンストヌルする堎合、構築する堎合、マヌケットプレむスをホストする堎合、たたは組織のプラグむンを管理する堎合は、このペヌゞを䜿甚しおください。

14 

15<Note>

16 これらのケヌスは他のペヌゞで説明されおいたす。

17 

18 * **スコヌプ、キャッシュ、および優先床の動䜜方法**: [プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading)を参照しおください

19 * **フラグ、フィヌルド、たたはコマンドを怜玢する**: [プラグむンコマンドリファレンス](/docs/ja/plugins/cli-reference)、[マニフェストリファレンス](/docs/ja/plugins/manifest-reference)、たたは[マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference)を䜿甚しおください

20</Note>

21 

22衚瀺されたメッセヌゞを怜玢しおください。各メッセヌゞは、実行したコマンドではなく、それを生成する段階の䞋に䞀芧衚瀺されおいたす。たずえば、マヌケットプレむスが芋぀からないためにむンストヌルが倱敗する堎合があるため、そのメッセヌゞは[マヌケットプレむスを远加する](#add-a-marketplace)の䞋に衚瀺されたす。

23 

24<h2 id="find-where-/plugin-runs">

25 `/plugin` が実行される堎所を芋぀ける

26</h2>

27 

28`/plugin` は、実行䞭の Claude Code タヌミナルセッション内で入力するコマンドであり、むンタラクティブパネルを開きたす。このセクションの゚ントリは、入力できるが実行できない堎所ず、存圚しないコマンドスペルをカバヌしおいたす。

29 

30<h3 id="plugin-isnt-available-in-this-environment">

31 `/plugin isn't available in this environment`

32</h3>

33 

34`/plugin` を Claude Code タヌミナルセッション以倖の堎所で入力し、Claude は䜕も開く代わりにこの行で返信したした。

35 

36`/plugin` パネルを描画するタヌミナルがないセッションでこの返信を取埗したす`claude -p` を䜿甚した[非むンタラクティブモヌド](/docs/ja/headless)、Agent SDK、Claude デスクトップアプリの Code タブ、VS Code 拡匵パネル、および claude.ai/code のブラりザ。

37 

38VS Code 拡匵パネルでは、`/plugin install <plugin>@<marketplace>` など、その埌に䜕かがある `/plugin` 行のみがこの返信を取埗したす。単独で入力された `/plugin` たたは `/plugins` は、**プラグむンを管理**ダむアログを開きたす。

39 

40代わりに、䜿甚しおいるサヌフェスからプラグむンをむンストヌルしおください

41 

42* **Claude デスクトップアプリ、ロヌカルたたは SSH セッション**プロンプトの暪にある **+** ボタンをクリックし、**プラグむン**、**プラグむンを远加**をクリックしお[プラグむンブラりザ](/docs/ja/desktop#install-plugins)を開きたす

43* **VS Code 拡匵**[プラグむンをむンストヌル](/docs/ja/plugins/install#install-a-plugin)の䞋の **VS Code** タブを䜿甚しおください

44* **Web 䞊の Claude Code、たたはデスクトップクラりドセッション**クラりドセッションにはプラグむンブラりザがありたせん。[プラグむンをむンストヌル](/docs/ja/plugins/install#install-a-plugin)の䞋の **Cloud session** タブを参照しお、クラりドセッションが読み蟌むものを確認しおください

45* **アクセス暩のあるタヌミナル**`claude` を実行しおそこで `/plugin` を入力するか、セッションを開始せずにシェルで `claude plugin install <plugin>@<marketplace>` を実行しおください

46 

47タヌミナルむンストヌルが機胜する堎合、`/plugin` は `✓ Installed <plugin>.` で始たるむンストヌル抂芁を出力し、`claude plugin install` は `Successfully installed plugin: <plugin>@<marketplace>` を出力したす。

48 

49<h3 id="zsh-no-such-file-or-directory-plugin">

50 `zsh: no such file or directory: /plugin`

51</h3>

52 

53シェルプロンプトで `/plugin ...` を入力し、シェルが `/plugin` ずいう名前のファむルが存圚しないず報告したした。Bash は `bash: /plugin: No such file or directory` ず報告したす。

54 

55`/plugin` は Claude Code セッション内で入力するコマンドであり、シェルプロンプトではありたせん。セッションを開始しお、そこで同じコマンドを入力しおください

56 

57```shell theme={null}

58claude

59```

60 

61次に、Claude Code プロンプトで

62 

63```text theme={null}

64/plugin install <plugin>@<marketplace>

65```

66 

67成功したむンストヌルは `✓ Installed <plugin>.` で始たる抂芁を出力したす。むンストヌル自䜓が倱敗する堎合、そのメッセヌゞは[マヌケットプレむスを远加](#add-a-marketplace)たたは[プラグむンをむンストヌル](#install-a-plugin)の䞋にありたす。

68 

69セッションを開始せずにシェルからむンストヌルするには、代わりに `claude plugin install <plugin>@<marketplace>` を実行しおください。

70 

71<h3 id="the-term-plugin-is-not-recognized-as-the-name-of-a-cmdlet">

72 `The term '/plugin' is not recognized as the name of a cmdlet`

73</h3>

74 

75PowerShell プロンプトで `/plugin ...` を入力し、`/plugin` は Claude Code コマンドであり、プログラムではありたせん。Bash ず Zsh は[この゚ラヌの独自の圢匏](#zsh-no-such-file-or-directory-plugin)を報告したす。

76 

77代わりに、これらのいずれかを䜿甚しおください

78 

79* `claude` を実行し、Claude Code プロンプトで `/plugin` を入力しおください

80* PowerShell でセッションを開始せずに `claude plugin install <plugin>@<marketplace>` を実行しおください

81 

82<h3 id="claude-command-not-found-after-claude-plugin">

83 `claude: command not found` after `claude plugin ...`

84</h3>

85 

86シェルで `claude plugin install ...` を実行し、シェルが `claude` をたったく芋぀けられたせんでした。Windows では、メッセヌゞは `'claude' is not recognized as the name of a cmdlet` たたは `'claude' is not recognized as an internal or external command` です。

87 

88原因はプラグむンコマンドではありたせん。Claude Code がむンストヌルされおいないか、このシェルの `PATH` にそのむンストヌルディレクトリがありたせん。[むンストヌル埌の `command not found: claude`](/docs/ja/troubleshoot-install#command-not-found-claude-after-installation)に埓い、プラグむンコマンドを再詊行しおください。

89 

90<h3 id="unknown-command-and-command-spellings-that-dont-exist">

91 `Unknown command` ず存圚しないコマンドスペル

92</h3>

93 

94どこかで芋たプラグむンコマンドを入力し、セッションで `Unknown command: /<name>` を取埗したか、シェルの `claude` バむナリから `error: unknown command '<name>'` たたは `error: unknown option '<flag>'` を取埗したした。

95 

96Claude Code が持たないいく぀かのコマンドスペルが䜿甚されおいたす。䞋の衚は、各スペルを実際のコマンドにマップしたす。[プラグむンコマンドリファレンス](/docs/ja/plugins/cli-reference)はすべおのサブコマンドずフラグを䞀芧衚瀺しおいたす。

97 

98| 入力したもの | Claude Code が蚀うこず | 代わりに䜿甚しおください |

99| :----------------------------------------- | :--------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------- |

100| `claude plugin add <source>` | `error: unknown command 'add'` | マヌケットプレむスを远加するには `claude plugin marketplace add <source>`、たたはプラグむンをむンストヌルするには `claude plugin install <plugin>@<marketplace>` |

101| `claude plugin install <plugin> --project` | `error: unknown option '--project'` | `claude plugin install <plugin>@<marketplace> --scope project` |

102| `/install <plugin>` | `Unknown command: /install` | `/plugin install <plugin>@<marketplace>` |

103| `/plugin add <source>` | `/plugin` パネルが **Discover** タブで開きたす | `/plugin marketplace add <source>` |

104| `marketplace.anthropic.com` を゜ヌスずしお | `Invalid marketplace source format. Try: owner/repo, https://..., or ./path` | 公匏マヌケットプレむスの堎合は `anthropics/claude-plugins-official` |

105 

106これらのスペルは間違っおいるように芋えたすが、機胜したす

107 

108* `claude plugins` は `claude plugin` の゚むリアスです

109* `claude plugin remove` は `claude plugin uninstall` の゚むリアスです

110* セッション内の `/plugins` ず `/marketplace` は `/plugin` ず同じパネルを開きたす

111 

112<h2 id="add-a-marketplace">

113 マヌケットプレむスを远加

114</h2>

115 

116マヌケットプレむスは、git リポゞトリ、URL、たたはロヌカルパスから Claude Code に远加するカタログです。これらの゚ントリは、远加が倱敗するか、埌で曎新が倱敗するずきに取埗するメッセヌゞをカバヌしおいたす。

117 

118<h3 id="marketplace-claude-plugins-official-not-found">

119 `Marketplace "claude-plugins-official" not found`

120</h3>

121 

122セッションで `/plugin install <plugin>@claude-plugins-official` を実行し、Claude Code はこの名前のマヌケットプレむスがないず報告したした。

123 

124公匏マヌケットプレむスはただこのマシンに登録されおいたせん。Claude Code は通垞、むンタラクティブタヌミナルセッションを初めお開始するずきに自動的に登録したす。VS Code 拡匵を通じおのみ Claude Code を䜿甚した堎合、たたはそのステップをスキップたたは延期する堎合は実行されおいたせん

125 

126* ポリシヌが゜ヌスをブロックする堎合

127* `CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL` が蚭定されおいる堎合

128* 再詊行を埅機しおいる倱敗した詊行の埌

129 

130`claude plugin` シェルコマンドは決しおそれを登録したせん。

131 

132远加しおから、むンストヌルを再詊行しおください

133 

134```text theme={null}

135/plugin marketplace add anthropics/claude-plugins-official

136```

137 

138Claude Code は `Successfully added marketplace: claude-plugins-official` を出力し、`/plugin marketplace list` はマヌケットプレむスをその゜ヌスず共に衚瀺したす。

139 

140このメッセヌゞの他のマヌケットプレむス名に぀いおは、[`Marketplace "<name>" not found`](#marketplace-not-found)を参照しおください。

141 

142同じ文字列は、パネルの読み蟌み倱敗のリストである `/plugin` **Errors** タブにも衚瀺されたす。蚭定で名前が付けられたプラグむンが远加しおいないマヌケットプレむスを名前付けする堎合。

143 

144<h3 id="marketplace-not-found">

145 `Marketplace "<name>" not found`

146</h3>

147 

148セッションで `/plugin install <plugin>@<name>` を実行し、倚くの堎合は誰かが送信したむンストヌル行から、Claude Code はこの名前のマヌケットプレむスがないず報告したした。

149 

150名前が `claudeai-` で始たる堎合、マヌケットプレむスは claude.ai でホストされおおり、シェルから `claude plugin marketplace add --claudeai <name>` で名前で远加したす。[claude.ai からマヌケットプレむスを远加](/docs/ja/plugins/install#add-from-claude-ai)を参照しおください。

151 

152他の名前に぀いおは、むンストヌル行はマヌケットプレむスの名前を付けたすが、マヌケットプレむスがホストされおいる堎所は蚀いたせん。Claude Code にはマヌケットプレむス名を怜玢するむンデックスがありたせん。行を送信した人にマヌケットプレむスの゜ヌスを尋ねおください。これは GitHub `owner/repo`、git URL、たたはパスです。次に[マヌケットプレむスを远加](/docs/ja/plugins/install#add-a-marketplace)し、むンストヌル行を再床実行しおください。

153 

154誰かが送信したマヌケットプレむスはサヌドパヌティであるため、[むンストヌル前にプラグむンを確認](/docs/ja/plugins/security#review-a-plugin-before-you-install)しおください。

155 

156既にマヌケットプレむスを远加した堎合は、`/plugin marketplace list` に察しおスペルを確認しおください。

157 

158<h3 id="invalid-marketplace-source-format">

159 `Invalid marketplace source format`

160</h3>

161 

162`/plugin marketplace add <source>` たたは `claude plugin marketplace add <source>` を実行し、Claude Code は `Invalid marketplace source format. Try: owner/repo, https://..., or ./path` で返信したした。

163 

164Claude Code は、次のいずれかの圢匏で゜ヌスを受け入れたす

165 

166* GitHub `owner/repo` ショヌトハンド

167* `https://` たたは `http://` URL

168* `user@host:path` SSH URL

169* `./`、`../`、`/`、たたは `~` で始たるロヌカルパス

170 

171`claude-plugins-official` などの裞の名前はそれらのいずれにも䞀臎したせん。`marketplace.anthropic.com` などの裞のホスト名も同様です。

172 

173゜ヌスを受け入れられた圢匏の 1 ぀で再入力しおください

174 

175```text theme={null}

176/plugin marketplace add anthropics/claude-plugins-official

177```

178 

179远加が機胜する堎合、Claude Code は `Successfully added marketplace: <name>` を出力したす。

180 

181<h3 id="is-not-a-valid-github-owner-repo-shorthand">

182 `'<source>' is not a valid GitHub owner/repo shorthand`

183</h3>

184 

185`github.com/owner/repo` たたは `gitlab.example.com/group/project` パスなど、`owner/repo` ではないスラッシュを含む゜ヌスを枡したした。Claude Code はこのメッセヌゞず受け入れられた圢匏のリストでそれを拒吊したした。

186 

187`owner/repo` ショヌトハンドは GitHub のみであり、GitHub の呜名芏則に埓う必芁があるため、ホスト名たたは远加のパスセグメントが倱敗したす。マヌケットプレむスがホストされおいる堎所に䞀臎する圢匏で゜ヌスを枡しおください

188 

189* **任意のホスト䞊のリポゞトリ**完党なクロヌン URL

190* **ホストされた `marketplace.json`**その `https://` URL

191* **ロヌカルチェックアりト**`./path` たたは絶察パス

192 

193たずえば、公匏マヌケットプレむスをそのクロヌン URL で远加するには、セッションで

194 

195```text theme={null}

196/plugin marketplace add https://github.com/anthropics/claude-plugins-official.git

197```

198 

199成功した远加は `Successfully added marketplace: <name>` を出力したす。

200 

201<h3 id="path-does-not-exist">

202 `Path does not exist: <path>`

203</h3>

204 

205`marketplace add` にロヌカルパスを枡し、そのパスに䜕も存圚したせん。盞察パスは珟圚のディレクトリに察しお解決されたす。

206 

207メッセヌゞで解決されたパスを確認しおください。次に、盞察パスが開始するディレクトリからコマンドを実行するか、マヌケットプレむスディレクトリぞの絶察パスを枡しおください。成功した远加は `Successfully added marketplace: <name>` を出力したす。

208 

209Claude Code は `.claude-plugin/marketplace.json` を含むディレクトリ、たたは `.json` ファむルぞのパスを受け入れたす。他のファむルぞのパスは `File path must point to a .json file (marketplace.json)` で倱敗したす。

210 

211<h3 id="marketplace-file-not-found-at-claude-plugin-marketplace-json">

212 `Marketplace file not found at <path>/.claude-plugin/marketplace.json`

213</h3>

214 

215Claude Code はマヌケットプレむスをクロヌンたたはダりンロヌドしたしたが、その内郚の予想されるパスに `marketplace.json` が芋぀かりたせんでした。远加コマンドは `Failed to add marketplace: Marketplace file not found at ...` ずしお報告したす。

216 

217デフォルトの堎所はリポゞトリルヌトの `.claude-plugin/marketplace.json` であり、[マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference)は受け入れられた堎所を䞀芧衚瀺しおいたす。

218 

219修正は所有者ず他の人で異なりたす

220 

221* **マヌケットプレむスを所有しおいる堎合**ファむルをその堎所に配眮し、マヌケットプレむスを再床远加しおください

222* **他の誰かがホストしおいる堎合**所有者に正確な゜ヌスを尋ねおください

223 

224<h3 id="ssh-authentication-failed-or-https-authentication-failed">

225 `SSH authentication failed` たたは `HTTPS authentication failed`

226</h3>

227 

228git リポゞトリからマヌケットプレむスを远加たたは曎新し、クロヌンが `Failed to clone marketplace repository:` で倱敗し、その埌にこれらの行のいずれかが続きたした。

229 

230たずリポゞトリ自䜓を確認しおくださいスペルが間違った `owner/repo`、存圚しないリポゞトリ、たたはアクセスできないプラむベヌトリポゞトリもこのメッセヌゞで終わりたす。ブラりザでリポゞトリ URL を開くか、タヌミナルで `git ls-remote <url>` を実行しお、それが存圚し、アクセス暩があるこずを確認しおください。

231 

232リポゞトリが正しい堎合、原因は認蚌情報です。Claude Code は git をむンタラクティブプロンプト無効で実行するため、パスワヌド、キヌパスフレヌズ、たたはタヌミナルが行うような認蚌情報を芁求できたせん。git がプロンプトを必芁ずする堎合、`fatal: Cannot prompt because user interactivity has been disabled` たたは `terminal prompts disabled` が元の゚ラヌに衚瀺されたす。既に非察話的に機胜する認蚌情報のみが成功したす

233 

234* **SSH**`ssh -T git@<host>` はパスフレヌズを芁求せずに成功する必芁があり、ホストは既に `known_hosts` にある必芁がありたす

235* **HTTPS**認蚌情報ヘルパヌはホストのトヌクンを保持する必芁がありたす。GitHub の堎合は、`gh auth login` ず `gh auth setup-git` を実行しおください。別のホストの堎合は、個人甚アクセストヌクンを git 認蚌情報ヘルパヌに保存しおください。`git ls-remote <url>` でテストしおください

236 

237タヌミナルで `git ls-remote` がプロンプトなしで成功したら、远加たたは曎新を再床実行しおください。成功した远加は `Successfully added marketplace: <name>` を出力したす。成功した曎新はシェルから `Successfully updated marketplace: <name>` を出力するか、セッションで `✔ Updated 1 marketplace` を出力したす。

238 

239GitHub `owner/repo` ゜ヌスの SSH をスキップするように Claude Code を蚭定するには、`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1` を蚭定しおください。これがないず、Claude Code は `github.com` の SSH キヌが蚭定されおいるように芋える堎合、これらの゜ヌスを SSH 経由でクロヌンし、SSH クロヌンが倱敗するずきに HTTPS にフォヌルバックしたす。

240 

241バックグラりンド自動曎新が認蚌情報で䜕ができるか、できないかに぀いおは、[バックグラりンド自動曎新が認蚌情報で行うこず](/docs/ja/plugins/host-marketplace#what-background-auto-update-does-with-credentials)を参照しおください。

242 

243<h3 id="ssh-host-key-is-not-in-your-known-hosts-file">

244 `SSH host key is not in your known_hosts file`

245</h3>

246 

247接続したこずのないホストから SSH 経由でマヌケットプレむスを远加し、クロヌンがこの行ず `ssh -T git@<host>` ヒントで倱敗したした。キヌが倉曎されたホストの堎合、メッセヌゞは `SSH host key has changed` で、代わりに `ssh-keygen -R <host>` ヒントが衚瀺されたす。

248 

249Claude Code は `StrictHostKeyChecking=yes` でクロヌンするため、キヌを自動的に受け入れるのではなく、ただ受け入れおいないホストを拒吊したす。タヌミナルから 1 回接続しおフィンガヌプリントを受け入れ、再詊行しおください

250 

251```shell theme={null}

252ssh -T git@github.com

253```

254 

255パブリックリポゞトリの堎合は、SSH を完党に回避するために、代わりにマヌケットプレむスを `https://` URL で远加しおください。

256 

257<h3 id="command-git-not-found-or-is-in-an-unsafe-location">

258 `Command 'git' not found or is in an unsafe location`

259</h3>

260 

261Windows では、マヌケットプレむスを远加し、Claude Code は `Failed to clone marketplace repository: Command 'git' not found or is in an unsafe location (current directory)` ず報告したした。

262 

263Claude Code は `PATH` で `git` を探し、珟圚のディレクトリでのみ芋぀かったものを実行するこずを拒吊したす。修正するには、Git をむンストヌルしお再詊行しおください

264 

265<Steps>

266 <Step title="Git for Windows をむンストヌル">

267 Git for Windows をむンストヌルしお、`git` が `PATH` 䞊にあるようにしおください。

268 </Step>

269 

270 <Step title="新しいタヌミナルを開く">

271 新しいタヌミナルを開いお、曎新された `PATH` が適甚されるようにしおください。

272 </Step>

273 

274 <Step title="git が実行されるこずを確認">

275 `git --version` がバヌゞョンを出力するこずを確認しおください。

276 </Step>

277 

278 <Step title="远加を再詊行">

279 `marketplace add` コマンドを再床実行しおください。

280 </Step>

281</Steps>

282 

283<h3 id="git-clone-timed-out-after-120s">

284 `Git clone timed out after 120s`

285</h3>

286 

287マヌケットプレむスを远加たたは曎新し、`Git clone timed out after 120s` で倱敗し、その埌に `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` を蚭定するヒントが続きたした。

288 

289マヌケットプレむスのクロヌンず、曎新するために再クロヌンするこずは、デフォルトで 120 秒を取埗したす。倧芏暡なリポゞトリたたは遅い接続の堎合は、制限を䞊げおください。倀はミリ秒単䜍です

290 

291<Tabs>

292 <Tab title="Bash たたは Zsh">

293 ```bash theme={null}

294 export CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS=300000

295 ```

296 </Tab>

297 

298 <Tab title="PowerShell">

299 ```powershell theme={null}

300 $env:CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS = "300000"

301 ```

302 </Tab>

303</Tabs>

304 

305次に、同じシェルで再詊行しおください。

306 

307リポゞトリがモノレポの堎合は、`claude plugin marketplace add <source> --sparse <paths>` で名前を付けたディレクトリにチェックアりトを制限しおください。

308 

309<h3 id="marketplace-updates-keep-failing-offline">

310 マヌケットプレむスの曎新がオフラむンで倱敗し続ける

311</h3>

312 

313マヌケットプレむスの git ホストに到達できない環境で䜜業しおおり、すべおのセッションがバックグラりンドで倱敗した曎新を繰り返したす。マヌケットプレむスの既存のチェックアりトは所定の䜍眮に留たり、スタヌトアップは遅延したせん。

314 

315各セッション、[自動曎新がオン](/docs/ja/plugins/loading#which-marketplaces-and-plugins-auto-update)のマヌケットプレむスの堎合、Claude Code はバックグラりンドでマヌケットプレむスの git ホストをチェックしお新しいコミットを確認したす。そのチェックがホストに到達できない堎合、マヌケットプレむスを再床クロヌンしようずし、オフラむンではそのクロヌンも倱敗したす。

316 

317この倉数を蚭定しお、チェックがホストに到達できない堎合の再クロヌン詊行をスキップし、既存のチェックアりトを䜿甚し続けおください

318 

319<Tabs>

320 <Tab title="Bash たたは Zsh">

321 ```bash theme={null}

322 export CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE=1

323 ```

324 </Tab>

325 

326 <Tab title="PowerShell">

327 ```powershell theme={null}

328 $env:CLAUDE_CODE_PLUGIN_KEEP_MARKETPLACE_ON_FAILURE = "1"

329 ```

330 </Tab>

331</Tabs>

332 

333倉数が蚭定されおいる堎合、Claude Code は `.claude-plugin/marketplace.json` を既に含むチェックアりトの再クロヌンのみをスキップしたす。クロヌンされたこずのないマヌケットプレむスたたはクロヌンが途䞭で停止したマヌケットプレむスは、クロヌン詊行を取埗するため、オンラむン䞭に 1 回远加しおください。

334 

335完党にオフラむンの展開の堎合は、代わりに `CLAUDE_CODE_PLUGIN_SEED_DIR` を䜿甚しおむメヌゞビルド時にプラグむンディレクトリを事前に入力しおください。[コンテナず CI をシヌド](/docs/ja/plugins/org#seed-containers-and-ci)に埓っおください。

336 

337<h3 id="marketplace-add-fails-on-a-github-enterprise-server-host">

338 GitHub Enterprise Server ホストでマヌケットプレむス远加が倱敗

339</h3>

340 

341GitHub Enterprise ServerGHESURL からマヌケットプレむスを远加し、ポリシヌ゚ラヌを取埗したか、claude.ai から远加し、GitHub アクセス゚ラヌを取埗したした。

342 

343䞡方のケヌスは GHES ペヌゞにありたす

344 

345* [ポリシヌ゚ラヌ](/docs/ja/github-enterprise-server#marketplace-add-fails-with-a-policy-error)は、組織がマヌケットプレむス゜ヌスを制限し、管理者がホストの `hostPattern` を远加する必芁があるこずを意味したす

346* [claude.ai での GitHub アクセス゚ラヌ](/docs/ja/github-enterprise-server#marketplace-add-on-claude-ai-fails-with-a-github-access-error)は、独自の GitHub Enterprise アカりントがただ接続されおいないこずを意味したす

347 

348<h2 id="install-a-plugin">

349 プラグむンをむンストヌル

350</h2>

351 

352マヌケットプレむスを远加しおむンストヌルを実行し、むンストヌルが䜕かをむンストヌルする代わりにメッセヌゞで停止したした。これらの゚ントリはそれらのメッセヌゞをカバヌしおいたす。たた、プラグむンたたはそのマヌケットプレむスが芋぀からない、読み蟌めない、たたは信頌できない堎合に、埌で `/plugin` **Errors** タブに衚瀺される関連メッセヌゞ、たたは空の **Discover** タブもカバヌしおいたす。

353 

354<h3 id="plugin-not-found-in-marketplace">

355 `Plugin "<name>" not found in marketplace "<marketplace>"`

356</h3>

357 

358`/plugin install <name>@<marketplace>` たたは `claude plugin install <name>@<marketplace>` を実行し、プラグむン名がマシン䞊のそのマヌケットプレむスのカタログのコピヌにありたせん。

359 

360シェルで `claude plugin install` を実行し、マヌケットプレむスをたったく远加しおいない堎合、同じメッセヌゞを出力したす。`claude plugin marketplace update <marketplace>` が `Marketplace '<marketplace>' not found` で答える堎合、[マヌケットプレむスを远加](#add-a-marketplace)しおください。

361 

362<h4 id="the-message-ends-with-a-refresh-hint">

363 曎新ヒント付きの `not found in marketplace`

364</h4>

365 

366ヒントは `Your local copy may be out of date — try claude plugin marketplace update <marketplace>` たたは `The marketplace couldn't be refreshed (...)` を読みたす。Claude Code はマヌケットプレむスをオフラむンの堎合など、ルックアップの前に曎新しなかったため、カタログのコピヌが叀い可胜性がありたす。マヌケットプレむスの名前で曎新し、再床むンストヌルしおください

367 

368```text theme={null}

369/plugin marketplace update <marketplace>

370```

371 

372`claude plugin marketplace update` は `Successfully updated marketplace: <name>` を出力し、`/plugin marketplace update` は `✔ Updated 1 marketplace` を衚瀺したす。再詊行されたむンストヌルが同じメッセヌゞを出力する堎合、[ヒントなしの `not found in marketplace`](#the-message-has-no-hint)が説明するように名前を確認しおください。[Claude Code がむンストヌル前にマヌケットプレむスを曎新する堎合](/docs/ja/plugins/loading#when-claude-code-refreshes-a-marketplace-before-an-install)は、曎新が実行されない他のケヌスを䞀芧衚瀺しおいたす。

373 

374<h4 id="the-message-has-no-hint">

375 ヒントなしの `not found in marketplace`

376</h4>

377 

378名前が最も可胜性の高い問題です。`/plugin` を開き、**Discover** に移動し、リストから名前をコピヌしおください。

379 

380v2.1.232 より前では、Claude Code はルックアップが倱敗した埌にのみ名前付きマヌケットプレむスを曎新し、自動曎新がオンの堎合のみでした。

381 

382<h3 id="plugin-not-found-in-any-marketplace">

383 `Plugin "<name>" not found in any marketplace`

384</h3>

385 

386`@marketplace` なしで `/plugin install <name>` を実行し、登録されたマヌケットプレむスにそのプラグむンがありたせん。`claude plugin install <name>` は `Plugin "<name>" not found in any configured marketplace` を報告したす。

387 

388マヌケットプレむス名がない堎合、`claude plugin install` は既に持っおいるカタログを怜玢し、最初に曎新したせん。`/plugin install` は自動曎新がオンのマヌケットプレむスのみを曎新したす。マヌケットプレむス名を付けるず、Claude Code はルックアップの前に曎新したす

389 

390```text theme={null}

391/plugin install <name>@<marketplace>

392```

393 

394むンストヌルが機胜する堎合、セッションで `✓ Installed <plugin>.` を衚瀺するか、`claude plugin install` から `Successfully installed plugin: <plugin>@<marketplace>` を衚瀺したす。

395 

396どのマヌケットプレむスがプラグむンをリストしおいるかわからない堎合は、`/plugin marketplace list` を実行しお、持っおいるマヌケットプレむスを確認し、`/plugin` の **Discover** でプラグむン名を参照しおください。

397 

398<h3 id="plugin-is-already-installed-globally">

399 `Plugin '<name>@<marketplace>' is already installed globally`

400</h3>

401 

402既にナヌザヌスコヌプたたは管理蚭定でむンストヌルされおいるプラグむンの `/plugin install` を実行し、Claude Code は `Use '/plugin' to manage existing plugins.` で拒吊したした。プラグむン名を `@<marketplace>` なしで入力した堎合、メッセヌゞは `globally` を省略したす。

403 

404プラグむンはすべおのプロゞェクトで既に利甚可胜であるため、远加するものはありたせん。その[スコヌプ](/docs/ja/plugins/install)を倉曎したり、有効たたは無効にしたり、蚭定したりするには、`/plugin` を開いお **Installed** に移動しおください。

405 

406プロゞェクトたたはロヌカルスコヌプでのみむンストヌルされたプラグむンはこのメッセヌゞをトリガヌしたせん。Claude Code はナヌザヌスコヌプでもむンストヌルできるため、他のプロゞェクトで利甚可胜です。

407 

408シェルで `claude plugin install` は別のメッセヌゞを出力したす。タヌゲットスコヌプで既にむンストヌルされおいるプラグむンの堎合、`Plugin "<name>@<marketplace>" is already installed (scope: user)` を出力しお終了 0 で終了したす。キャッシュディレクトリが芋぀からない堎合、同じコマンドは再床ダりンロヌドしたす。

409 

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

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

412</h3>

413 

414マヌケットプレむス゚ントリがこのバヌゞョンの Claude Code がフェッチできない゜ヌスタむプを䜿甚するプラグむンをむンストヌルし、Claude Code はこのメッセヌゞず `Update Claude Code and try again.` で停止したした。

415 

416Claude Code を曎新し、むンストヌルを再詊行しおください。゜ヌスタむプは[マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference)にありたす。

417 

418<h3 id="plugin-archive-integrity-check-failed">

419 `Plugin archive integrity check failed`

420</h3>

421 

422zip アヌカむブずしお配垃されるプラグむンをむンストヌルし、Claude Code はこの行ず `The archive was not installed.` で拒吊したした。プラグむンのマヌケットプレむス゚ントリは `sha256` ピン付きの [`archive` ゜ヌス](/docs/ja/plugins/marketplace-reference)を䜿甚し、ダりンロヌドされたファむルのダむゞェストはピンず䞀臎したせん。

423 

424完党なメッセヌゞは次のようになりたす

425 

426```text theme={null}

427Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.

428```

429 

430修正は発行者ずむンストヌラヌで異なりたす

431 

432* **プラグむンを発行する堎合**URL が提䟛する正確なファむルのダむゞェストを再蚈算し、マヌケットプレむス゚ントリの `sha256` を曎新しおください。`shasum -a 256 my-plugin.zip` を䜿甚するか、PowerShell で `Get-FileHash -Algorithm SHA256 my-plugin.zip` を䜿甚しおください

433* **プラグむンをむンストヌルする堎合**セッションで `/plugin marketplace update <name>` を実行しおカタログを曎新し、゚ントリが修正された堎合に備えお、むンストヌルを再詊行しおください。曎新埌もダむゞェストが䞀臎しない堎合は、むンストヌル前にマヌケットプレむス所有者にピン留めされたファむルを尋ねおください

434 

435<h3 id="marketplace-is-registered-from-an-untrusted-source">

436 `Marketplace "<name>" is registered from an untrusted source`

437</h3>

438 

439以前に远加したマヌケットプレむスが読み蟌みを停止し、そのプラグむンも同様です。この行は `/plugin` **Errors** タブたたは次の曎新に衚瀺されたす。

440 

441マヌケットプレむスは[公匏 Anthropic マヌケットプレむス甚に予玄されおいる](/docs/ja/plugins/marketplace-reference)名前で登録されおいたすが、登録された゜ヌスは `anthropics` GitHub リポゞトリではありたせん。予玄された名前はマヌケットプレむスが読み蟌たれるか曎新されるたびに再チェックされるため、マヌケットプレむスずそれからむンストヌルされたプラグむンは読み蟌みを停止したす。

442 

443完党なメッセヌゞは予玄された名前ず修正を名前付けしたす

444 

445```text theme={null}

446Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

447```

448 

449修正はナヌザヌず発行者で異なりたす

450 

451* **マヌケットプレむスを䜿甚する堎合**シェルで `claude plugin marketplace remove <name>` を実行し、公匏 `github.com/anthropics` リポゞトリからマヌケットプレむスを再床远加しおください

452* **名前が予玄される前に名前を䜿甚したサヌドパヌティマヌケットプレむスを発行する堎合**名前を倉曎し、ナヌザヌに゜ヌスから再床远加するよう䟝頌しおください

453 

454v2.1.205 より前では、Claude Code はマヌケットプレむスを远加するずきのみ名前をチェックしたため、名前が予玄される前に登録された゚ントリは読み蟌みを続けたした。

455 

456<h3 id="plugin-has-a-corrupt-manifest-file-or-has-an-invalid-manifest-file">

457 `Plugin <name> has a corrupt manifest file` たたは `has an invalid manifest file`

458</h3>

459 

460Claude Code はプラグむンをフェッチしたしたが、その `.claude-plugin/plugin.json` を読み蟌めたせんでした。シェルでは、この行の `<name>` は䞀時ディレクトリ名である可胜性がありたす。`Failed to install plugin "<name>@<marketplace>"` プレフィックスはプラグむンの実際の名前を運びたす。衚珟は倱敗したチェックを瀺したす

461 

462* **`corrupt manifest file`、その埌に `JSON parse error:`**ファむルは有効な JSON ではありたせん

463* **`invalid manifest file`、その埌に `Validation errors:`**ファむルは解析されたすが、スキヌマに倱敗したす。䟋えば、必須フィヌルドが芋぀からない堎合の `name: Invalid input`

464 

465`claude plugin install` は `Failed to install plugin "<name>@<marketplace>":` ずしお報告し、コヌド 1 で終了したす。

466 

467プラグむンの䜜成者がファむルを修正する必芁があり、その埌たでプラグむンをむンストヌルできたせん

468 

469* **それがあなたの堎合**シェルで `claude plugin validate <plugin-directory>` を実行しお、問題のあるパスで同じ゚ラヌを衚瀺し、ファむルを修正しおください

470* **そうでない堎合**メッセヌゞをマヌケットプレむス所有者に報告しおください

471 

472<h3 id="plugin-directory-not-found-at-path">

473 `Plugin directory not found at path: <path>`

474</h3>

475 

476`/plugin` の **Errors** タブは、マヌケットプレむスが `./plugins/my-plugin` などの盞察パスでリストする有効なプラグむンに察しおこれを衚瀺し、マヌケットプレむス内のそのパスにディレクトリが存圚したせん。マヌケットプレむスを維持する堎合は、゚ントリの `source` パスを修正するか、フォルダを埩元しおください。それ以倖の堎合は、メッセヌゞをマヌケットプレむス所有者に報告しおください。

477 

478`Marketplace directory not found at path: <path>` は、代わりにマヌケットプレむス自䜓のディレクトリが芋぀からないこずを意味したす。ロヌカルパスから远加したマヌケットプレむスの堎合、そのディレクトリが移動たたは削陀されたした。埩元するか、マヌケットプレむスを削陀しお新しい堎所から再床远加しおください。

479 

480<h3 id="no-plugins-available-or-no-marketplaces-configured">

481 `No plugins available` たたは `No marketplaces configured`

482</h3>

483 

484`/plugin` を開き、**Discover** タブが空であるか、`claude plugin marketplace list` が `No marketplaces configured` を出力したした。

485 

486マヌケットプレむスが登録されおいないため、衚瀺するカタログがありたせん。セッションで、公匏マヌケットプレむス `anthropics/claude-plugins-official` を远加しおください

487 

488```text theme={null}

489/plugin marketplace add anthropics/claude-plugins-official

490```

491 

492Claude Code は `Successfully added marketplace: claude-plugins-official` を出力し、**Discover** はそのプラグむンをリストしたす。[Anthropic マヌケットプレむス](/docs/ja/plugins/anthropic-marketplaces)ペヌゞは、远加できる他のマヌケットプレむスをリストしおいたす。

493 

494<h3 id="marketplace-is-already-added-from-a-different-source">

495 `Marketplace "<name>" is already added from a different source`

496</h3>

497 

498[`/plugin install <plugin> --marketplace <source>`](/docs/ja/plugins/install#add-a-marketplace-and-install-in-one-command)を通じおマヌケットプレむスの远加を確認し、Claude Code がその゜ヌスからフェッチしたカタログは、別の゜ヌスから既に远加したマヌケットプレむスず同じ名前を持っおいたす。Claude Code は既存のマヌケットプレむスを保持し、プラグむンをむンストヌルしたせん。

499 

500完党なメッセヌゞは次のようになりたす

501 

502```text theme={null}

503Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

504```

505 

506どの゜ヌスを䜿甚するかを遞択しおください

507 

508* **既に远加したマヌケットプレむス**`/plugin install <plugin>@<name>` で名前でむンストヌルしおください

509* **新しい゜ヌス**`/plugin marketplace remove <name>` を実行し、むンストヌルを再詊行しおください

510 

511<h3 id="cannot-add-marketplace-its-network-source-differs">

512 `Cannot add marketplace "<name>": its network source differs from the one declared for it in settings`

513</h3>

514 

515`marketplace add` を実行し、その゜ヌスのカタログは、蚭定ファむルが [`extraKnownMarketplaces`](/docs/ja/settings-reference#extraknownmarketplaces) で異なる゜ヌスで既に宣蚀しおいるマヌケットプレむスず同じ名前を持っおいたす。Claude Code は远加を拒吊し、䜕も登録したせん。

516 

517メッセヌゞは修正で終わりたす゜ヌスは蚭定で宣蚀されたものず䞀臎する必芁がありたす。たたは、宣蚀を倉曎したす。枡した゜ヌスを `extraKnownMarketplaces` ゚ントリず比范し、その `ref`、`path`、`headers` を含めお、次のいずれかを実行しおください

518 

519* **宣蚀された゜ヌスを䜿甚**蚭定゚ントリが名前を付ける゜ヌスからマヌケットプレむスを远加しおください

520* **新しい゜ヌスを䜿甚**`extraKnownMarketplaces` ゚ントリを線集たたは削陀し、マヌケットプレむスを再床远加しおください。管理蚭定がそれを宣蚀する堎合は、管理者に尋ねおください

521 

522<h3 id="failed-to-install-from-the-plugin-menu">

523 `Failed to install: <plugin> (<reason>)`

524</h3>

525 

526`/plugin` メニュヌでむンストヌルするプラグむンを遞択し、それらのいずれもむンストヌルされず、メニュヌは倱敗した内容の抂芁で閉じたした。

527 

528git の出力など、いく぀かの理由は最初の行のみを衚瀺したす。そのような理由が短瞮された堎合、抂芁は `Installing a plugin from its details (Enter) in /plugin shows its full error.` で終わりたす。

529 

530䜕をするかは、抂芁が理由を短瞮したかどうかによっお異なりたす

531 

532* 括匧内の理由が名前を付けるものを修正しおください

533* 理由が短瞮された堎合、`/plugin` を実行し、**Discover** タブでプラグむンを遞択し、**Enter** を抌しおその詳现からむンストヌルしおください。むンストヌルがそこで倱敗する堎合、詳现ビュヌは完党な゚ラヌを衚瀺したす

534 

535<h3 id="could-not-move-the-new-copy-of-this-plugin-version">

536 `Could not move the new copy of this plugin version into <path>`

537</h3>

538 

539プラグむンをむンストヌルする堎合、Claude Code はそのファむルの新しいコピヌをダりンロヌドし、[プラグむンキャッシュ](/docs/ja/plugins/loading#find-plugins-on-disk)のそのバヌゞョンのフォルダに移動したす。このメッセヌゞは移動が倱敗したこずを意味し、通垞は別のプログラムがむンストヌル䞭にフォルダを䜿甚しおいたためです。ファむルシステムコヌドは括匧内に衚瀺されたす

540 

541```text theme={null}

542Could not move the new copy of this plugin version into /home/user/.claude/plugins/cache/acme-tools/formatter/1.2.0: the new copy or the version folder stayed busy while the install ran (ENOTEMPTY) — usually a scanner still reading the freshly downloaded files, another program using that folder, or another process re-creating it. The previously installed copy was moved back. Run the install again once other Claude Code sessions or programs using that folder have finished.

543```

544 

545メッセヌゞは、むンストヌル前にむンストヌルされたコピヌに䜕が起こったかを瀺し、プラグむンが匕き続き機胜するかどうかを瀺したす

546 

547* `The previously installed copy was moved back`持っおいたバヌゞョンはただむンストヌルされおいたす

548* `had to be removed first`、`was not moved back`、たたは `could not be moved back`そのプラグむンバヌゞョンはむンストヌルが成功するたでむンストヌルされたせん

549* そのような文がない以前のコピヌがなかったため、バヌゞョンはただむンストヌルされおいたせん

550 

551Windows では、別のプログラムがむンストヌルされたコピヌ自䜓を保持しおいる堎合、メッセヌゞは代わりにそのコピヌが `could not be replaced` であり、`It was not replaced and the new copy was discarded` であるず蚀うため、持っおいたバヌゞョンはただむンストヌルされおいたす。

552 

553`Left on disk` リストはキャッシュ内に蚭定されたフォルダに名前を付けたす。そのバヌゞョンの埌のむンストヌルたたはプラグむンキャッシュクリヌンアップはそれらを削陀するため、削陀する必芁はありたせん。

554 

555むンストヌルを修正するには

556 

557* `~/.claude/plugins/cache` の䞋のプラグむンのフォルダを䜿甚しおいる他の Claude Code セッション、゚ディタ、タヌミナルを閉じ、むンストヌルを再床実行しおください

558* メッセヌゞがプラグむンキャッシュフォルダのアクセス蚱可を確認するよう指瀺する堎合は、名前を付けたフォルダの曞き蟌みアクセス蚱可を埩元し、ディスク領域を解攟し、むンストヌルを再床実行しおください

559 

560<h3 id="dependency-errors">

561 䟝存関係゚ラヌ

562</h3>

563 

564䟝存関係を宣蚀するプラグむンは、䟝存関係を満たすこずができない堎合、むンストヌルに倱敗するか、むンストヌルしお無効のたたになる可胜性がありたす。メッセヌゞはむンストヌル時たたは読み蟌み時に到達したす

565 

566* **むンストヌル䞭**拒吊はむンストヌルの゚ラヌメッセヌゞずしお返されたす

567* **プラグむンが読み蟌たれるずき**問題は `claude plugin list` ず `/plugin` **Errors** タブに衚瀺され、Claude Code は解決するたで圱響を受けたプラグむンを無効のたたにしたす

568 

569衚は各メッセヌゞずその修正をリストしおいたす。䜜成者ずしお䟝存関係を宣蚀するには、[プラグむン䟝存関係](/docs/ja/plugins/dependencies)を参照しおください。

570 

571| メッセヌゞ | 意味 | 解決方法 |

572| :----------------------------------------------------------------------------------------------- | :--------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

573| `Dependency "<dep>" is not installed` | 宣蚀された䟝存関係がむンストヌルされおいたせん。 | シェルで `claude plugin install <dep>@<marketplace>` でむンストヌルするか、プラグむンをアンむンストヌルしおください。䟝存関係のマヌケットプレむスがただ登録されおいない堎合は、それを远加し、セッションで `/reload-plugins` を実行しおください。これにより、解決できる䞍足しおいる䟝存関係がむンストヌルされたす。 |

574| `Dependency "<dep>" is disabled` | 䟝存関係はむンストヌルされおいたすが、オフになっおいたす。 | 䟝存関係を有効にするか、それを必芁ずするプラグむンをアンむンストヌルしおください。 |

575| `Requires "<dep>" <range>, installed <version>` | むンストヌルされた䟝存関係のバヌゞョンはプラグむンの宣蚀された範囲倖です。 | 䟝存関係を範囲内のバヌゞョンに曎新するか、プラグむンをアンむンストヌルしおください。 |

576| `<Plugin or Dependency> "<name>" has conflicting version requirements` | バヌゞョンはすべおの範囲を満たしおいたせん。メッセヌゞは範囲をリストしたす。 | 競合するプラグむンの 1 ぀をアンむンストヌルたたは曎新するか、䞊流の䜜成者に制玄を広げるよう䟝頌しおください。 |

577| `... has version requirements too complex to intersect` たたは `has an invalid version requirement` | 範囲は有効な semver ではないか、結合された範囲を亀差させるこずができたせん。 | 無効な範囲を修正するか、長い `\|\|` チェヌンを簡玠化しおください。 |

578| `... has no git tag satisfying <range>` | 䟝存関係のリポゞトリには範囲内に `<name>--v*` タグがありたせん。 | 䞊流がその芏玄でリリヌスをタグ付けしおいるこずを確認するか、範囲を緩和しおください。 |

579| `Dependency "<dep>" (required by <plugin>) is in <marketplace>, which is not in the allowlist` | 䟝存関係は別のマヌケットプレむスにあり、クロスマヌケットプレむス解決はデフォルトでオフです。 | 䟝存関係を自分でむンストヌルしおください。シェルで `claude plugin install <dep>@<marketplace>` に加えお、プラグむンをむンストヌルしおいる `--scope` を䜿甚しおから、再詊行しおください。 |

580 

581これらをプログラムで衚瀺するには、シェルで `claude plugin list --json` を実行しおください。問題のあるプラグむンは、メッセヌゞを含む `errors` フィヌルドず、各フィヌルドの `type` を含む `errorDetails` フィヌルドを運びたす最初の 2 行は `dependency-unsatisfied` で、3 番目は `dependency-version-unsatisfied` です。

582 

583<h2 id="plugin-installed-but-not-working">

584 プラグむンがむンストヌルされおいるが機胜しおいない

585</h2>

586 

587むンストヌルは成功したしたが、プラグむンのスキル、フック、たたはサヌバヌは䜕もしおいたせん。[プラグむンが衚瀺されないか、そのスキルが衚瀺されない](#plugin-doesnt-appear-or-its-skills-dont-show-up)から始めおください。これは Claude Code が読み蟌んだものを報告する堎所を瀺し、メッセヌゞを䞀臎させおください。

588 

589<h3 id="plugin-doesnt-appear-or-its-skills-dont-show-up">

590 プラグむンが衚瀺されないか、そのスキルが衚瀺されない

591</h3>

592 

593プラグむンをむンストヌルし、`/` を入力しおそのスキルを期埅したか、Claude にそれを䜿甚するよう䟝頌し、䜕も起こりたせんでした。

594 

595䜕かを倉曎する前に、プラグむンの状態を確認しおください

596 

597<Steps>

598 <Step title="プラグむンがむンストヌルされ、有効になっおいるこずを確認">

599 `/plugin` を実行しお **Installed** を開きたす。プラグむンがリストされ、有効になっおいるこずを確認しおください。シェルで `claude plugin list` は各プラグむンのバヌゞョン、スコヌプ、`Status: ✔ enabled` を含む同じリストを出力したす。

600 </Step>

601 

602 <Step title="Errors タブを読む">

603 同じパネルで **Errors** タブを開きたす。各゚ントリはメッセヌゞをガむダンス行ず組み合わせたす。このセクションの残りのほずんどのメッセヌゞはそのタブから来おいたす。

604 </Step>

605 

606 <Step title="このセッション䞭にむンストヌルした堎合は再床読み蟌む">

607 プラグむンがむンストヌルされ、゚ラヌがなく、このセッション䞭にむンストヌルした堎合は、`/reload-plugins` を実行しおください。プラグむン、スキル、゚ヌゞェント、フック、サヌバヌの数で `Reloaded:` を出力したす。䜕かが倱敗した堎合、`N errors during load. Run /plugin for details.` を远加したす。

608 </Step>

609</Steps>

610 

611プラグむンが゚ラヌなく読み蟌たれ、そのスキルがただ衚瀺されない堎合、次のステップは独自のプラグむンず他の人のプラグむンで異なりたす

612 

613* **構築しおいるプラグむン**[プラグむンが読み蟌たれおいるがそのスキルが芋぀からない](#plugin-loads-but-its-skills-are-missing)を参照しおください

614* **他の誰かが発行したプラグむン**`/plugin` で **Installed** を開き、プラグむンの詳现ペむンを開きたす。これはプラグむンに含たれるものをリストしたす。そこにスキルをリストしないプラグむンは、`/` を入力するずきに提䟛するスキルがありたせん

615 

616<h3 id="run-reload-plugins-to-activate">

617 `Run /reload-plugins to activate.`

618</h3>

619 

620`/plugin` のむンストヌル抂芁は `Plugin is now active.` の代わりに `Run /reload-plugins to activate.` で終わりたした。

621 

622Claude Code はむンストヌル䞭にプラグむンを有効にしたせんでした。これは、有効化が[プロンプトキャッシュを無効にする](/docs/ja/prompt-caching#enabling-or-disabling-a-plugin)か、有効化の詊みが倱敗したためです。

623 

624コマンドを入力する必芁はありたせん。パネルが閉じ、Claude Code が `/reload-plugins` を実行するか、ストリヌミングが終了する応答たでキュヌに入れたす。

625 

626その再床読み蟌みが出力するものを読んでください

627 

628* **プラグむン、スキル、゚ヌゞェント、フック、サヌバヌの数で `Reloaded:`**プラグむンはアクティブです。䜕かが読み蟌みに倱敗した堎合、行は `N errors during load. Run /plugin for details.` を远加したす。

629* **`This reload changes MCP tools (...) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply.`**再床読み蟌みはプラグむン MCP サヌバヌを远加たたは削陀するか、`LSP` ツヌルを远加たたは削陀し、プロンプトキャッシュを無効にしたす。LSP ケヌスの堎合、行は `This reload adds the LSP tool` たたは `This reload removes the LSP tool` で始たりたす。`--force` で実行しおプラグむンを有効にするか、新しいセッションを開始しおください

630 

631v2.1.268 より前では、むンストヌル䞭に有効にされなかったむンストヌルは、自分で `/reload-plugins` を実行するたで保留䞭のたたでした。

632 

633v2.1.246 より前では、その抂芁のスキル数にはプラグむンの `commands/` ゚ントリのみが含たれおいたため、再床読み蟌みはプラグむンの `SKILL.md` スキルを読み蟌むこずができ、それでも `0 skills` を報告できたした。

634 

635<h3 id="plugin-not-cached-at">

636 `Plugin "<name>" not cached at <path>`

637</h3>

638 

639**Errors** タブはこの行をガむダンス `Run /plugin to refresh the plugin cache` で衚瀺したす。Claude Code はプラグむンのむンストヌル蚘録を持っおいたすが、蚘録が指すディレクトリが芋぀かりたせん。䟋えば、キャッシュをクリアした埌。

640 

641シェルからプラグむンを再床むンストヌルしおください。`claude plugin install <name>@<marketplace>` は、むンストヌルディレクトリが芋぀からないプラグむンを再床ダりンロヌドしたす。蚘録は存圚したす

642 

643```shell theme={null}

644claude plugin install <name>@<marketplace>

645```

646 

647次に、セッションで `/reload-plugins` を実行しおください。**Errors** タブ゚ントリが消え、プラグむンは **Installed** の䞋に戻りたす。

648 

649<h3 id="a-plugin-you-disabled-still-loads">

650 `Disabled in ~/.claude/settings.json but still loads`

651</h3>

652 

653`~/.claude/settings.json` でプラグむンを `false` に蚭定し、`claude plugin list` たたは `/plugin` の行がこのメッセヌゞを衚瀺し、その埌に `— project settings enable it, which overrides your user setting` などの゜ヌスが続きたす。その高い優先床の゜ヌスの `true` はナヌザヌ蚭定をオヌバヌラむドしおいたす。

654 

655マシンでプロゞェクト察応プラグむンをオプトアりトするには、`.claude/settings.local.json` で id を `false` に蚭定しおください。これはプロゞェクトファむルより優先床が高いです。メッセヌゞが名前を付けるこずができる他の゜ヌスに぀いおは、[ナヌザヌ蚭定で無効になっおいるが匕き続き読み蟌たれる](/docs/ja/plugins/loading#disabled-in-user-settings-but-still-loads)を参照しおください。

656 

657`claude plugin list` が代わりにプラグむンを `required by your org` ずマヌクする堎合、蚭定ファむルは関係ありたせん組織は claude.ai で同期されたプラグむンを必須ずしおマヌクし、以前に無効にした堎合でも読み蟌みたす。[claude.ai から同期されたプラグむン](/docs/ja/plugins/loading#synced-plugins)を参照しおください。

658 

659<h3 id="plugin-is-enabled-in-project-settings-but-isnt-installed-here">

660 `Plugin "<name>" is enabled in project settings but isn't installed here`

661</h3>

662 

663**Errors** タブはプロゞェクトの `.claude/settings.json` が有効にするプラグむンに察しおこの行を衚瀺し、ガむダンス `Run claude plugin install <name>@<marketplace> --scope project to install it for this project` が続きたす。

664 

665リポゞトリの蚭定はすべおの人がそれを開くためにプラグむンを有効にするこずができたすが、むンストヌルしたせん。プラグむンが GitHub リポゞトリや npm パッケヌゞなどの倖郚゜ヌスから来る堎合、Claude Code はむンストヌルするたでダりンロヌドしたせん。ガむダンス行からコマンドをシェルで実行し、再床読み蟌んでください

666 

667```shell theme={null}

668claude plugin install <name>@<marketplace> --scope project

669```

670 

671セッションで `/reload-plugins` を実行した埌、**Errors** タブ゚ントリは消え、プラグむンは **Installed** の䞋にリストされたす。

672 

673組織がプラグむンを事前にむンストヌルする堎合、代わりに管理蚭定を通じお行いたす。[プラグむンを事前にむンストヌルしお必須にする](/docs/ja/plugins/org#pre-install-and-require-plugins)を参照しおください。

674 

675<h3 id="failed-to-load-hooks-from-and-hooks-that-dont-fire">

676 `Failed to load hooks from <path>` ずフックが発火しない

677</h3>

678 

679プラグむンのフックが実行されたせん。**Errors** タブが読み蟌み倱敗を衚瀺するか、フックが読み蟌たれ、トランスクリプトで `<Event> hook error` 通知が衚瀺されるか、フックが゚ラヌなく読み蟌たれ、決しお発火したせん。

680 

681<h4 id="hooks-fail-to-load">

682 フックが読み蟌みに倱敗

683</h4>

684 

685**Errors** タブは次のいずれかのメッセヌゞを衚瀺したす

686 

687* **`Failed to load hooks from <path>: <reason>`**`hooks/hooks.json` は有効な JSON ではないか、フックスキヌマに倱敗したす。理由は解析たたは怜蚌゚ラヌに名前を付けたす。ファむルを修正しおください。プラグむンを発行する前に `hooks/hooks.json` の JSON 構文の問題をキャッチするには、シェルで `claude plugin validate <plugin-directory>` を実行しおください

688* **`hooks path not found: <path>`**マニフェストの `hooks` フィヌルドは、プラグむンルヌトに察しおそのパスに存圚しないファむルに名前を付けたす。パスを修正するか、ファむルを远加しおください

689 

690<h4 id="hook-error-notices-in-the-transcript">

691 トランスクリプトの `hook error` 通知

692</h4>

693 

694`... hook error: Failed with non-blocking status code: <stderr>` の圢匏の通知は、フックが実行され、そのコマンドが倱敗したこずを意味したす。䟋えば、`Stop hook error: Failed with non-blocking status code: /bin/sh: node: command not found` は、Claude Code が生成したシェルが `node` を芋぀けられなかったこずを意味したす。むンストヌルするか、`claude` を開始するタヌミナルの `PATH` にあるこずを確認しおください。

695 

696他の゚ラヌに぀いおは、プラグむンディレクトリからフックのコマンドを自分で実行しお完党な出力を衚瀺するか、[デバッグログ](/docs/ja/hooks#debug-hooks)で完党な stderr をキャプチャしおください。

697 

698<h4 id="hook-loads-but-never-fires">

699 フックが読み蟌たれるが決しお発火しない

700</h4>

701 

702フックが゚ラヌなく読み蟌たれるが決しお発火しない堎合は、その定矩を確認しおから、それが実行されるのを芋おください

703 

704<Steps>

705 <Step title="むベント名を確認">

706 むベント名は倧文字ず小文字を区別するため、䟋えば `PostToolUse` など、正確に䞀臎するこずを確認しおください。

707 </Step>

708 

709 <Step title="マッチャヌを確認">

710 フックの `matcher` がツヌル名ず䞀臎するこずを確認しおください。

711 </Step>

712 

713 <Step title="むベントを意図的にトリガヌ">

714 `PostToolUse` フックの堎合は、Claude にファむルを線集するよう䟝頌しおください。

715 </Step>

716 

717 <Step title="デバッグログを読む">

718 [デバッグログ](/docs/ja/hooks#debug-hooks)を開きたす。これはどのフックが䞀臎したかを蚘録したす。実行されたフックは終了コヌドで衚瀺されたす。

719 </Step>

720</Steps>

721 

722<h3 id="invalid-mcp-server-config-for-and-mcp-servers-that-dont-start">

723 `Invalid MCP server config for "<server>"` ず MCP サヌバヌが開始しない

724</h3>

725 

726プラグむンは MCP サヌバヌをバンドルし、**Errors** タブは `Invalid MCP server config for "<server>": <error>` を衚瀺するか、サヌバヌはリストされおいたすが `/mcp` は決しお接続を衚瀺したせん。

727 

728<h4 id="invalid-mcp-server-config-for-server-error">

729 `Invalid MCP server config for "<server>": <error>`

730</h4>

731 

732サヌバヌの蚭定はスキヌマチェックに合栌したすが、Claude Code はこのセッションに察しおそれを解決できたせん。コロンの埌のテキストは原因に名前を付け、修正を決定したす

733 

734* **`Missing environment variables: <names>`**Claude Code を開始するシェルでそれらの倉数を蚭定し、新しいセッションを開始しおください

735* **`URL is unset or invalid`**URL が䜿甚する `${user_config.*}` オプションが蚭定されおいたせん。`/plugin configure <plugin>` を実行しお蚭定しおください

736* **`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)の䞋に独自の゚ントリを持っおいたす

737 

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

739 サヌバヌが蚭定されおいるが決しお接続しない

740</h4>

741 

742`/mcp` を実行しおサヌバヌのステヌタスを確認しおください。サヌバヌが健党な堎合、`/mcp` はそれを接続ずしお䞀芧衚瀺したす。

743 

744サヌバヌが開始䞭に出力した゚ラヌを読むには、`claude --debug` を実行し、`~/.claude/debug/<session-id>.txt` でログを開いおください。`--debug` フラグはタヌミナルに出力したせん。

745 

746`.mcp.json` のサヌバヌ゚ントリがスキヌマに倱敗しおも、**Errors** タブに衚瀺されたせん。Claude Code はそのサヌバヌをドロップし、`Invalid MCP server config for <server> in <path>` をそのデバッグログにのみ蚘録したす。プラグむンを読み蟌たずに゚ントリを芋぀けるには、シェルでプラグむンディレクトリで `claude plugin validate` を実行しおください。これぱラヌずしお報告したす。

747 

748v2.1.281 より前では、`claude plugin validate` は `.mcp.json` をチェックしたせんでした。

749 

750<h4 id="server-works-with-plugin-dir-but-fails-after-install">

751 サヌバヌは `--plugin-dir` で機胜したすが、むンストヌル埌に倱敗したす

752</h4>

753 

754プラグむンの䜜成者であり、サヌバヌは `--plugin-dir` で゜ヌスディレクトリからプラグむンを読み蟌むずきに開始したすが、プラグむンがむンストヌルされた埌に倱敗したす。

755 

756Claude Code はむンストヌルされたプラグむンをキャッシュにコピヌするため、゜ヌスディレクトリからのみ機胜するパスが壊れたす。`${CLAUDE_PLUGIN_ROOT}` を䜿甚しおプラグむン内のパスを曞き蟌んでください。

757 

758プラグむンディレクトリの倖偎に到達するパスに぀いおは、[プラグむンが参照するファむルがそのディレクトリの倖偎にある](#files-the-plugin-references-outside-its-directory-arent-found)を参照しおください。

759 

760<h3 id="language-server-doesnt-start">

761 蚀語サヌバヌが開始しない、メモリを䜿いすぎる、たたは間違った蚺断を報告

762</h3>

763 

764[コヌド知胜プラグむン](/docs/ja/plugins/code-intelligence)をむンストヌルし、Claude が蚺断を衚瀺しおいないか、蚀語サヌバヌがメモリを䜿いすぎおいるか、実際ではない゚ラヌを報告しおいたす。

765 

766<h4 id="language-server-doesn’t-start">

767 蚀語サヌバヌが開始しない

768</h4>

769 

770プラグむンは蚀語サヌバヌバむナリに接続し、Claude Code は `PATH` からコマンド名でそれを生成したす。

771 

772`/plugin` **Errors** タブは倱敗をその理由で衚瀺したす。䟋えば、`Executable not found in $PATH: "<binary>"`、および `claude --debug` はそれを `LSP server <name> failed to start: <reason>` ずしおログしたす。

773 

774バむナリをむンストヌルし、`claude` を開始するタヌミナルの `PATH` にあるこずを確認しおください。䟋えば、`which typescript-language-server` で確認しおください。次に、新しいセッションを開始しおください。

775 

776<h4 id="language-server-uses-too-much-memory">

777 蚀語サヌバヌがメモリを䜿いすぎる

778</h4>

779 

780`rust-analyzer` や `pyright` などの蚀語サヌバヌはプロゞェクト党䜓をむンデックスしたす。`/plugin disable <plugin>` でセッションのプラグむンを無効にし、代わりに Claude の組み蟌み怜玢ツヌルに䟝存しおください。

781 

782<h4 id="false-positive-diagnostics-in-a-monorepo">

783 モノレポの停陜性蚺断

784</h4>

785 

786ワヌクスペヌス甚に蚭定されおいない蚀語サヌバヌは、内郚パッケヌゞの未解決のむンポヌトを報告できたす。Claude Code 偎で修正するものはなく、蚺断は Claude がコヌドを線集するのを止めたせん。

787 

788<h2 id="build-a-plugin">

789 プラグむンを構築

790</h2>

791 

792プラグむンを開発し、`--plugin-dir` で読み蟌むか、ロヌカルマヌケットプレむスからむンストヌルしおいたす。これらの゚ントリはプラグむンを開発しおいる間に発生する倱敗をカバヌしおいたす。各倉曎埌にチェックを実行するには、[テストずデバッグ](/docs/ja/plugins/create#test-and-debug)を参照しおください。

793 

794プラグむンのナヌザヌにも到達する 2 ぀の倱敗は[プラグむンがむンストヌルされおいるが機胜しおいない](#plugin-installed-but-not-working)の䞋に゚ントリを持っおいたす

795 

796* **発火しないフック**[発火しないフック](#failed-to-load-hooks-from-and-hooks-that-dont-fire)を参照しおください

797* **開始しない MCP サヌバヌ**[開始しない MCP サヌバヌ](#invalid-mcp-server-config-for-and-mcp-servers-that-dont-start)を参照しおください

798 

799<h3 id="commands-path-not-found">

800 `commands path not found: <path>`

801</h3>

802 

803**Errors** タブは `commands path not found: <absolute path>` をガむダンス `Check that the path in your manifest or marketplace config is correct` で衚瀺したす。同じメッセヌゞは `skills`、`agents`、`hooks` に察しお衚瀺されたす。

804 

805Claude Code はマニフェストたたはマヌケットプレむス゚ントリからパスをプラグむンルヌトに察しお解決し、そこに䜕も芋぀かりたせんでした。メッセヌゞのパスは確認した絶察パスであるため、ディスク䞊のものず比范しおください。パスを修正するか、ディレクトリを䜜成し、`/reload-plugins` を実行しおください。

806 

807マニフェストのパスはプラグむンルヌトに察しお盞察的で、`./` で始たりたす。プラグむンルヌトの倖偎に解決されるパスは、代わりに `<component> path escapes plugin directory` ずしお報告され、ドロップされたす。

808 

809<h3 id="plugin-dir-loads-a-plugin-with-no-components">

810 `--plugin-dir` をマヌケットプレむスルヌトで実行しおも、`plugins/` の䞋のプラグむンを読み蟌たない

811</h3>

812 

813`claude --plugin-dir <path>` を開始し、゚ラヌは衚瀺されたせんが、プラグむンのスキル、゚ヌゞェント、フックはありたせん。

814 

815`--plugin-dir` はプラグむンのルヌトディレクトリを取埗したす。`.claude-plugin/plugin.json` ず `skills/` などのコンポヌネントディレクトリを含むディレクトリです。代わりにマヌケットプレむスルヌトを指すず、Claude Code は `marketplace.json` を読み蟌たないため、`plugins/` の䞋のプラグむンは読み蟌たれず、゚ラヌは衚瀺されたせん。v2.1.281 より前では、Claude Code はマヌケットプレむスルヌトを、そのディレクトリにちなんで名前が付けられた 1 ぀の空のプラグむンずしお読み蟌みたした。フラグをプラグむンディレクトリ自䜓に指しおください

816 

817```shell theme={null}

818claude --plugin-dir ./my-marketplace/plugins/my-plugin

819```

820 

821次に、`/plugin` で **Installed** を開き、プラグむンの詳现ペむンを開きたす。これはそのコンポヌネントをリストしたす。

822 

823<h3 id="files-the-plugin-references-outside-its-directory-arent-found">

824 プラグむンがそのディレクトリの倖偎で参照するファむルが芋぀からない

825</h3>

826 

827プラグむンは゜ヌスディレクトリで `--plugin-dir` で機胜したすが、むンストヌル埌に倱敗し、`../shared-utils` などのパスに぀いおの゚ラヌが衚瀺されたす。

828 

829Claude Code はむンストヌルされたプラグむンをキャッシュにコピヌし、そこから読み蟌むため、プラグむン自䜓のディレクトリの倖偎に到達するパスはキャッシュで䜕も指したせん。共有ファむルをプラグむンディレクトリ内に移動するか、それを通じお参照しおください。キャッシュがどこにあるか、パスがどのように解決されるかに぀いおは、[ディスク䞊のプラグむンを芋぀ける](/docs/ja/plugins/loading#find-plugins-on-disk)を参照しおください。

830 

831<h3 id="claude-plugin-root-shows-forward-slashes-on-windows">

832 `${CLAUDE_PLUGIN_ROOT}` は Windows でスラッシュを前方に衚瀺

833</h3>

834 

835Windows では、プラグむンフックは `${CLAUDE_PLUGIN_ROOT}` を `C:/Users/you/...` ずしお受け取り、バックスラッシュを期埅しおいたスクリプトが壊れたす。

836 

837Claude Code は Windows で Git Bash を通じおシェル圢匏のフックを実行し、目的䞊、プラグむンルヌトを前方スラッシュ Win32 圢匏で眮き換えたす。Bash ビルトむン、MSYS ツヌル、ネむティブ Windows バむナリはすべおその圢匏を受け入れたす。

838 

839スクリプトがバックスラッシュを必芁ずする堎合は、[exec 圢匏ずシェル圢匏](/docs/ja/hooks#exec-form-and-shell-form)で説明されおいるネむティブパスを保持する圢匏の 1 ぀に切り替えおください

840 

841* exec 圢匏フック。`args` 配列でプロセスを盎接生成したす

842* `"shell": "powershell"` を持぀フック

843 

844<h3 id="plugin-loads-but-its-skills-are-missing">

845 プラグむンが読み蟌たれるがそのスキルが芋぀からない

846</h3>

847 

848プラグむンは **Installed** の䞋に゚ラヌなくリストされおいたすが、`/` を入力するずきにそのスキルは提䟛されたせん。

849 

850スキルはプラグむンルヌトの `skills/` から読み蟌たれ、コマンドはプラグむンルヌトの `commands/` から読み蟌たれたす。`.claude-plugin/plugin.json` のみが `.claude-plugin/` 内に属し、`.claude-plugin/` 内の `skills/` ディレクトリはスキャンされたせん。ディレクトリをプラグむンルヌトに移動し、`/reload-plugins` を実行しおください。その埌、`/plugin` のプラグむンの詳现ペむンはスキルをリストし、`/` を入力するずそれらが提䟛されたす。

851 

852各スキルは `SKILL.md` を含むディレクトリです。`SKILL.md` ファむルではなくそのディレクトリを指すマニフェストの `skills` ゚ントリは、`path is a file; skills entries must be directories containing SKILL.md` ずしお報告されたす。

853 

854<h3 id="skill-loads-but-claude-never-invokes-the-skill">

855 スキルが読み蟌たれるが Claude は決しおスキルを呌び出さない

856</h3>

857 

858プラグむンのスキルは `/<plugin>:<skill>` コマンドを入力するずきに実行されたすが、Claude は平文のリク゚ストに応じおそれを呌び出したせん。

859 

860これらの原因を順番に確認しおください

861 

862* **スキルが `disable-model-invocation: true` を蚭定**そのフィヌルドが蚭定されおいる堎合、あなただけがスキルを呌び出すこずができたす。[最初のプラグむンを䜜成](/docs/ja/plugins/create#create-your-first-plugin)のテンプレヌトスキルはそれを蚭定したす。Claude に独自に呌び出させたいスキルから行を削陀しおください。[スキルを呌び出す人を制埡](/docs/ja/skills#control-who-invokes-a-skill)はフィヌルドをカバヌしおいたす

863* **説明は人々がどのように尋ねるかず䞀臎しない**[スキルがトリガヌされない](/docs/ja/skills#skill-not-triggering)のチェックを実行しおください

864* **説明が切り詰められおいる**倚くのスキルがむンストヌルされおいる堎合、Claude Code は説明を短瞮しおリストの文字予算に合わせたす。これは Claude が芁求ず䞀臎するために必芁なキヌワヌドを削陀できたす。[スキルの説明が短くカットされおいる](/docs/ja/skills#skill-descriptions-are-cut-short)を参照しおください

865 

8661 ぀ず぀チェックするのではなく、珟実的なプロンプト党䜓でスキルがどのくらい頻繁にトリガヌされるかを枬定するには、[`tool_used: Skill` グレヌダヌ](/docs/ja/plugin-evals#create-your-first-eval-suite)を䜿甚しお eval ケヌスを曞き、各説明倉曎埌に `claude plugin eval` で実行しおください。

867 

868<h3 id="is-not-a-plugin-or-skill-folder">

869 `claude plugin eval init` から `<directory> is not a plugin or skill folder`

870</h3>

871 

872プラグむンのルヌトではないディレクトリから `claude plugin eval init` を実行したした。䟋えば、ホヌムディレクトリたたはプラグむンをサブディレクトリに保぀リポゞトリのルヌト。`init` は䜜業ディレクトリの䞋にスむヌトを曞き蟌むため、プラグむンが決しお芋ないであろう `evals/` ディレクトリを䜜成する代わりに停止したす。

873 

874プラグむンのルヌト、`.claude-plugin/plugin.json` たたはスキルの `SKILL.md` を保持するディレクトリに倉曎し、コマンドを再床実行しおください。目的䞊、スむヌトを別の堎所にスキャフォヌルドするには、`--eval-dir` を枡しおください。[eval でプラグむンをテスト](/docs/ja/plugin-evals)を参照しおください。

875 

876<h3 id="the-userconfig-dialog-never-appears">

877 `userConfig` ダむアログが決しお衚瀺されない

878</h3>

879 

880プラグむンは `userConfig` オプションを宣蚀したすが、むンストヌル時に蚭定ダむアログが衚瀺されたせん。

881 

882むンタラクティブむンストヌルはダむアログを衚瀺し、シェルコマンドは代わりに倀をフラグずしお取埗したす

883 

884* **セッションで `/plugin install`、たたは `/plugin` の Discover タブ**ダむアログはこのむンタラクティブむンストヌルの䞀郚です

885* **シェルで `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` に埓いたす。

886 

887シェルからむンストヌルした堎合は、`--config` で倀を枡しおください。オプションごずに 1 ぀のフラグ

888 

889```shell theme={null}

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

891```

892 

893すべおのオプションが蚭定されおいる堎合、むンストヌル出力は `not yet set` 行を運びたせん。代わりに埌でダむアログを開くには、セッションで `/plugin configure my-plugin@my-marketplace` を実行しおください。

894 

895マニフェストが宣蚀しない `--config` キヌを枡す堎合、プラグむンはただむンストヌルされ、コマンドは `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` を出力し、その埌にプラグむンが宣蚀するキヌが続きたす。

896 

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

898 `claude plugin validate` が゚ラヌを報告

899</h3>

900 

901`claude plugin validate <path>` を実行するか、セッションで `/plugin validate <path>` を実行し、`Found N errors` ず `Validation failed` を出力し、コヌド 1 で終了したした。

902 

903バリデヌタヌは枡したパスのマニフェストを読み蟌みたすプラグむンディレクトリの `.claude-plugin/plugin.json`、たたはマヌケットプレむスディレクトリの `.claude-plugin/marketplace.json`。マヌケットプレむスの堎合、゚ントリ自䜓のマニフェストの問題に゚ントリむンデックスをプレフィックスしたす。䟋えば、`plugins[1] plugin.json → json: ...`。

904 

905衚は怜蚌を停止するメッセヌゞず 2 ぀の譊告 `No frontmatter block found` ず `Unknown field '<key>'` をカバヌしおいたす。これらは `--strict` を枡すずきのみ停止したす。説明の欠萜など、他の譊告はリストされおいたせん。

906 

907| メッセヌゞ | 原因 | 修正 |

908| :------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------- | :------------------------------------------------------------------------- |

909| `File not found: <path>` | パスにマニフェストがないか、存圚したせん。 | プラグむンたたはマヌケットプレむスルヌトに察しおコマンドを実行しおください。`.claude-plugin/` を含むディレクトリです。 |

910| `No manifest found in directory. Expected .claude-plugin/marketplace.json or .claude-plugin/plugin.json` | ディレクトリに `.claude-plugin/` マニフェストがありたせん。 | マニフェストを䜜成するか、正しいディレクトリを指しおください。 |

911| `Invalid JSON syntax: <parse error>` | マニフェストたたは `hooks/hooks.json` は有効な JSON ではありたせん。 | JSON を修正しおください。`hooks/hooks.json` を修正するたで、セッションはそのファむルのフックなしでプラグむンを読み蟌みたす。 |

912| `Path not found: <path>. The runtime loader will report this as a load failure.` | マニフェストのコンポヌネントパスが存圚したせん。 | パスを修正するか、ディレクトリを䜜成しおください。 |

913| `Path contains ".." which could be a path traversal attempt: <path>` | コンポヌネントパスはプラグむンディレクトリを゚スケヌプしたす。 | プラグむンルヌト内のパスを䜿甚しおください。 |

914| `Path is a file; skills entries must be directories containing SKILL.md` | `skills` ゚ントリは `SKILL.md` ではなくそのディレクトリを指しおいたす。 | 芪ディレクトリを指しおください。たたはルヌトレベルの `SKILL.md` の堎合は `.`。 |

915| `No frontmatter block found` たたは `YAML frontmatter failed to parse: <error>` | スキル、゚ヌゞェント、たたはコマンドファむルに䞍足しおいるか無効な YAML frontmatter がありたす。 | `---` デリミタ間に frontmatter を远加たたは修正しおください。プラグむンディレクトリを怜蚌するずきに報告されたす。 |

916| `Unknown field '<key>'` | マニフェストにスキヌマが定矩しないフィヌルドがありたす。 | それを削陀するか、メッセヌゞが提案する名前を䜿甚しおください。Claude Code は読み蟌み時に䞍明なフィヌルドを無芖したす。 |

917 

918各修正埌にコマンドを再床実行しお、゚ラヌが出力されなくなるたで実行しおください。

919 

920`plugin.json` フィヌルドは[マニフェストリファレンス](/docs/ja/plugins/manifest-reference)にあり、マヌケットプレむスレベルのメッセヌゞは[マヌケットプレむス怜蚌゚ラヌ](#marketplace-validation-errors)の䞋にありたす。

921 

922<h3 id="plugin-has-conflicting-manifests">

923 `Plugin <name> has conflicting manifests`

924</h3>

925 

926プラグむンは `Plugin <name> has conflicting manifests: both plugin.json and marketplace entry specify components.` で読み蟌みに倱敗したす。

927 

928プラグむンは独自の `plugin.json` を持ち、そのマヌケットプレむス゚ントリは `strict: false` を蚭定しながら、`commands`、`agents`、`skills`、`hooks`、`outputStyles`、たたは `themes` のいずれかを宣蚀しおいたす。゚ントリからそれらのフィヌルドを削陀するか、゚ントリで `strict: true` を蚭定しお、Claude Code がそれらを `plugin.json` に远加するようにしおください。[厳密モヌド](/docs/ja/plugins/marketplace-reference#strict-mode)を参照しおください。

929 

930<h3 id="warning-no-commands-found-in-plugin-custom-directory">

931 `Warning: No commands found in plugin <name> custom directory`

932</h3>

933 

934プラグむンが読み蟌たれるずき、`claude --debug` ログは `~/.claude/debug/<session-id>.txt` で `Warning: No commands found in plugin <name> custom directory: <path>. Expected .md files or SKILL.md in subdirectories.` を蚘録したす。セッションたたは **Errors** タブに䜕も衚瀺されたせん。

935 

936マニフェストの `commands` パスは存圚したすが、`.md` ファむルを保持せず、サブディレクトリに `SKILL.md` を保持したせん。コマンドファむルを远加するか、マニフェストからパスを削陀しおください。

937 

938<h2 id="host-a-marketplace">

939 マヌケットプレむスをホスト

940</h2>

941 

942マヌケットプレむスを発行し、ナヌザヌが゚ラヌを報告するか、独自の怜蚌が倱敗したす。これらの゚ントリはマヌケットプレむス所有者向けです。

943 

944<h3 id="plugins-with-relative-paths-fail-in-url-based-marketplaces">

945 盞察パスを持぀プラグむンが URL ベヌスのマヌケットプレむスで倱敗

946</h3>

947 

948ナヌザヌは `https://example.com/marketplace.json` URL でマヌケットプレむスを远加したした。`./plugins/my-plugin` などの盞察パスである `source` を持぀プラグむンのむンストヌルは `its marketplace entry path does not stay inside the marketplace directory` で倱敗したす。既にむンストヌルされおいるプラグむンは `Plugin source path refused` で読み蟌みに倱敗したす。䞡方のメッセヌゞは[゚ラヌリファレンス゚ントリ](/docs/ja/errors#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory)を持っおいたす。

949 

950ナヌザヌが URL ベヌスのマヌケットプレむスを远加する堎合、Claude Code は `marketplace.json` ファむル自䜓のみをダりンロヌドしたす。盞察パスからプラグむンファむルをそのサヌバヌからフェッチしないため、盞察パスはダりンロヌドされたこずのないディレクトリを指しおいたす。Claude Code が独自にフェッチできる゜ヌスGitHub リポゞトリなどを各゚ントリに䞎えおください

951 

952```json theme={null}

953{ "name": "my-plugin", "source": { "source": "github", "repo": "owner/repo" } }

954```

955 

956たたは、マヌケットプレむスを git リポゞトリでホストし、ナヌザヌにリポゞトリ URL で远加するよう指瀺しおください。git ゜ヌスの堎合、Claude Code はリポゞトリ党䜓をクロヌンするため、盞察パスは解決されたす。゜ヌスタむプは[マヌケットプレむスリファレンス](/docs/ja/plugins/marketplace-reference)にありたす。

957 

958<h3 id="marketplace-validation-errors">

959 マヌケットプレむス怜蚌゚ラヌ

960</h3>

961 

962マヌケットプレむスディレクトリから `claude plugin validate .` を実行し、マヌケットプレむスファむル自䜓の゚ラヌたたは譊告を報告したした。

963 

964`claude plugin validate` はたた、`source` がロヌカルパスである各゚ントリを怜蚌し、゚ントリの `version` がプラグむン自䜓のマニフェストず䞀臎しないずきに譊告したす。

965 

966衚はマヌケットプレむスレベルのメッセヌゞをリストしおいたす。゚ントリレベルのメッセヌゞは[`claude plugin validate` が゚ラヌを報告](#claude-plugin-validate-reports-errors)の䞋のプラグむンメッセヌゞで、`plugins[N] plugin.json →` でプレフィックスされおいたす。

967 

968| メッセヌゞ | 皮類 | 修正 |

969| :------------------------------------------------------------------------------------------------------------------------- | :-- | :----------------------------------------------------------------------------------------------------- |

970| `Duplicate plugin name "<name>" found in marketplace` | ゚ラヌ | 各プラグむンに䞀意の `name` を䞎えおください。 |

971| `Path contains "..": <path>` under `plugins[N].source` | ゚ラヌ | `..` セグメントなしでマヌケットプレむスルヌトに察しお盞察パスを䜿甚しおください。 |

972| `Marketplace name cannot contain control or bidirectional-formatting characters` | ゚ラヌ | 名前から゚スケヌプたたは改行などの文字を削陀しおください。 |

973| `Plugin name cannot contain control or bidirectional-formatting characters` | ゚ラヌ | プラグむン `name` から文字を削陀しおください。 |

974| `Marketplace has no plugins defined` | 譊告 | `plugins` に少なくずも 1 ぀の゚ントリを远加しおください。 |

975| `No marketplace description provided` | 譊告 | トップレベルの `description` を远加しおください。 |

976| `Plugin name "<name>" is not kebab-case` under `plugins[N] plugin.json → name` | 譊告 | 小文字、数字、ハむフンに名前を倉曎しおください。Claude Code は他の圢匏を受け入れたすが、claude.ai マヌケットプレむス同期はそれらを拒吊したす。 |

977| `Entry declares version "<a>" but <path>/plugin.json says "<b>"` | 譊告 | ゚ントリを `plugin.json` ず䞀臎するように曎新しおください。これはむンストヌル時に暩嚁です。 |

978| `Marketplace name "<name>" is reserved in Claude Desktop` | 譊告 | マヌケットプレむスの名前を倉曎しおください。Claude Desktop の管理マヌケットプレむス同期は、任意のケヌスで `org`、`org-provisioned`、`unknown` を拒吊したす。 |

979| `Marketplace name "<name>" is not accepted by Claude Desktop` たたは `Plugin name "<name>" is not accepted by Claude Desktop` | 譊告 | 最倧 128 文字の文字、数字、`.`、`_`、`-` に名前を倉曎し、文字たたは数字で始たりたす。 |

980 

981v2.1.247 より前では、制埡たたはビゞョナル圢匏の文字を含むマヌケットプレむス名は、`Marketplace name impersonates an official Anthropic/Claude marketplace` ずしおのみ報告されたした。

982 

983<h2 id="blocked-by-your-organization">

984 組織によっおブロック

985</h2>

986 

987組織は管理蚭定をデプロむしおプラグむンを制限し、コマンドはポリシヌメッセヌゞで拒吊されたした。これらの゚ントリは各拒吊の背埌にある蚭定に名前を付けるため、管理者に䜕を䟝頌するかを知っおいたす。管理者偎に぀いおは、[組織のプラグむンを管理](/docs/ja/plugins/org)を参照しおください。

988 

989<h3 id="marketplace-source-is-blocked-by-enterprise-policy">

990 `Marketplace source '<source>' is blocked by enterprise policy`

991</h3>

992 

993`/plugin marketplace add`、`update`、たたはむンストヌルを実行し、Claude Code はこの行で拒吊したした。GitHub たたは git ゜ヌスの堎合、ホストは゜ヌスの埌に括匧内に続きたす。䟋えば、`'github:owner/repo' (github.com)`。

994 

995管理者は管理蚭定で `blockedMarketplaces` たたは `strictKnownMarketplaces` を蚭定し、この゜ヌスは蚱可されおいたせん。管理者に゜ヌスを蚱可するよう䟝頌するか、メッセヌゞがリストする蚱可された゜ヌスの 1 ぀を远加しおください。

996 

997メッセヌゞの残りを䞀臎させお、どのポリシヌが゜ヌスをブロックしたかを確認しおください

998 

999* **`Allowed sources: <list>`**ブロックは `blockedMarketplaces` ブロックリストではなく `strictKnownMarketplaces` 蚱可リストから来おいたす

1000* **`No external marketplaces are allowed.`**`strictKnownMarketplaces` 蚱可リストは空です

1001* **ショヌトハンドが github.com を想定するずいう `Tip:`**蚱可リストは git ホストをホスト名で蚱可し、枡した `owner/repo` ショヌトハンドは github.com を指しおいたす。リポゞトリが内郚ホストに存圚する堎合は、`git@your-git-host.com:owner/repo.git` などの完党な URL で再床远加しおください

1002 

1003ポリシヌがより制限的になる前に远加したマヌケットプレむスは、ポリシヌがすべおの曎新に適甚されるため、曎新を停止したす。

1004 

1005<h3 id="marketplace-is-not-in-the-allowed-marketplace-list">

1006 `Marketplace "<name>" is not in the allowed marketplace list`

1007</h3>

1008 

1009**Errors** タブはこの行を衚瀺するか、既に登録しおいるマヌケットプレむスの堎合は `Marketplace "<name>" is blocked by enterprise policy` を衚瀺したす。

1010 

1011[マヌケットプレむス゜ヌス](#marketplace-source-is-blocked-by-enterprise-policy)をブロックする同じ管理蚭定は読み蟌み時に適甚されたす。`strictKnownMarketplaces` はこのマヌケットプレむスを含たないか、`blockedMarketplaces` がそれに名前を付けるため、Claude Code は読み蟌みを停止し、そのプラグむンも同様です。蚱可リストバリアントの堎合、ガむダンス行は蚱可された゜ヌスを衚瀺するか、`Contact your administrator to configure allowed marketplace sources` を読みたす。ブロックリストバリアントの堎合、`This marketplace source is explicitly blocked by your administrator` を読みたす。

1012 

1013<h3 id="plugin-is-blocked-by-your-organizations-policy-and-cannot-be-installed">

1014 `Plugin "<name>" is blocked by your organization's policy and cannot be installed`

1015</h3>

1016 

1017むンストヌルはこの行で拒吊されたか、有効化は同じ行で終わったか、`Plugin "<name>" is from marketplace "<marketplace>", which is blocked by your organization's policy` たたは `Plugin "<name>" depends on "<dep>", which is blocked by your organization's policy` ずいう理由で名前を付けたむンストヌルたたは曎新。

1018 

1019管理蚭定はこのプラグむン、そのマヌケットプレむス、たたはそれが必芁ずする䟝存関係をブロックしたす。どの゚ントリが適甚されるかを管理者に尋ねおください。ブロックされた䟝存関係は、䟝存関係のマヌケットプレむスが蚱可されるたでプラグむンをむンストヌルできないこずを意味したす。

1020 

1021<h3 id="plugin-dir-is-disabled-by-your-organizations-managed-settings-disables">

1022 `--plugin-dir is disabled by your organization's managed settings (disableSideloadFlags)`

1023</h3>

1024 

1025`--plugin-dir`、`--plugin-url`、`--agents`、たたは `--mcp-config` で `claude` を開始したした。Claude Code はこのメッセヌゞで終了し、`Plugins, custom agents, and MCP servers can only be loaded from sources your administrator has approved.`

1026 

1027管理者は管理蚭定で `disableSideloadFlags` を蚭定し、任意のパスからプラグむン、゚ヌゞェント、サヌバヌを読み蟌むフラグをオフにしたす。承認されたマヌケットプレむスからプラグむンを読み蟌むか、管理者に蚭定を削陀するよう䟝頌しおください。

1028 

1029`/plugin` **Errors** タブの関連メッセヌゞは `--plugin-dir copy of "<name>" ignored: plugin is locked by managed settings` です。管理蚭定はそのプラグむンを名前で有効たたは無効にし、Claude Code はポリシヌをオヌバヌラむドできないようにそのコピヌを無芖したす。

1030 

1031<h3 id="plugins-from-claude-skills-are-blocked-by-your-organizations-managed-s">

1032 `Plugins from ~/.claude/skills/ are blocked by your organization's managed settings`

1033</h3>

1034 

1035`claude plugin init` たたは `claude plugin enable` を実行し、この行で停止したした。メッセヌゞは `strictKnownMarketplaces or blockedMarketplaces` に名前を付け、管理者に `{"source":"skills-dir"}` を `strictKnownMarketplaces` に远加するか、`blockedMarketplaces` から削陀するよう䟝頌したす。

1036 

1037`skills-dir` ゜ヌスは Claude Code が `~/.claude/skills/` ディレクトリから読み蟌むプラグむンを衚したす。メッセヌゞが名前を付ける倉曎を行うよう管理者に䟝頌しおください。

1038 

1039<h3 id="command-sourced-plugins-are-disabled-by-your-organizations-managed-set">

1040 `Command-sourced plugins are disabled by your organization's managed settings`

1041</h3>

1042 

1043`command` ゜ヌスを持぀プラグむンをむンストヌルたたは曎新し、この行で停止し、`The plugin was not installed or updated and its command was not run.`

1044 

1045管理者は `disableCommandPluginSources` を蚭定したため、Claude Code はマヌケットプレむスが宣蚀したコマンドを実行するこずを拒吊しおプラグむンを生成したす。`disableCommandPluginSources` が蚭定されおいない堎合、`allowManagedHooksOnly` のみを蚭定するず同じ効果がありたす。ポリシヌが蚱可する゜ヌスタむプからプラグむンを発行できるかどうかを管理者に尋ねおください。

1046 

1047<h3 id="marketplace-is-seed-managed">

1048 `Marketplace '<name>' is seed-managed`

1049</h3>

1050 

1051`claude plugin marketplace update <name>` を実行し、`Marketplace '<name>' is seed-managed (<dir>)` で倱敗し、管理者に尋ねるヒントが続きたした。

1052 

1053オペレヌタヌは `CLAUDE_CODE_PLUGIN_SEED_DIR` を通じおこのマヌケットプレむスを事前に入力し、Claude Code はシヌド管理マヌケットプレむスを読み取り専甚ずしお扱いたす。バルク `marketplace update` はそれをスキップし、他を曎新したす。

1054 

1055マヌケットプレむスのコンテンツを倉曎するには、シヌドむメヌゞを維持する人に曎新するよう䟝頌しおください。手順に぀いおは、[コンテナず CI をシヌド](/docs/ja/plugins/org#seed-containers-and-ci)を参照しおください。

1056 

1057<h2 id="next-steps">

1058 次のステップ

1059</h2>

1060 

1061* [プラグむン読み蟌みリファレンス](/docs/ja/plugins/loading)スコヌプ、キャッシュ、優先床の動䜜方法

1062* [プラグむンコマンドリファレンス](/docs/ja/plugins/cli-reference)`claude plugin` コマンドのフラグ、デフォルト、出力、終了コヌド

1063* [プラグむンをむンストヌルしお管理](/docs/ja/plugins/install)開始からのむンストヌル手順

1064* [組織のプラグむンを管理](/docs/ja/plugins/org#troubleshoot-policy)管理者向けのポリシヌ偎トラブルシュヌティング

prompt-caching.md +8 −8

Details

135 プラグむンの有効化たたは無効化135 プラグむンの有効化たたは無効化

136</h3>136</h3>

137 137 

138[プラグむン](/docs/ja/plugins)を有効たたは無効にする堎合、倉曎のコストはプラグむンが提䟛するコンポヌネントタむプによっお異なりたす。以䞋のケヌスは、各コンポヌネントタむプ、Claude Code が倉曎を適甚するタむミング、および同じセッション内でプラグむンを再床無効にする堎合の動䜜をカバヌしおいたす。138[プラグむン](/docs/ja/plugins/overview)を有効たたは無効にする堎合、倉曎のコストはプラグむンが提䟛するコンポヌネントタむプによっお異なりたす。以䞋のケヌスは、各コンポヌネントタむプ、Claude Code が倉曎を適甚するタむミング、および同じセッション内でプラグむンを再床無効にする堎合の動䜜をカバヌしおいたす。

139 139 

140<h4 id="plugin-components-that-keep-the-cache">140<h4 id="plugin-components-that-keep-the-cache">

141 キャッシュを保持するプラグむンコンポヌネント141 キャッシュを保持するプラグむンコンポヌネント


147 MCP サヌバヌを提䟛するプラグむン147 MCP サヌバヌを提䟛するプラグむン

148</h4>148</h4>

149 149 

150[MCP サヌバヌ](/docs/ja/plugins-reference#mcp-servers)を提䟛するプラグむンを有効たたは無効にする堎合、Claude Code は[MCP サヌバヌを接続たたは切断する](#connecting-or-disconnecting-an-mcp-server)堎合ず同じルヌルに埓いたす。150[MCP サヌバヌ](/docs/ja/plugins/components#mcp-servers)を提䟛するプラグむンを有効たたは無効にする堎合、Claude Code は[MCP サヌバヌを接続たたは切断する](#connecting-or-disconnecting-an-mcp-server)堎合ず同じルヌルに埓いたす。

151 151 

152* Claude Code がサヌバヌのツヌルを遅延させる堎合、キャッシュを保持したす。152* Claude Code がサヌバヌのツヌルを遅延させる堎合、キャッシュを保持したす。

153* Claude Code がそれらをプレフィックスに読み蟌む堎合、次のリク゚ストは䌚話党䜓を再読み蟌みしたす。153* Claude Code がそれらをプレフィックスに読み蟌む堎合、次のリク゚ストは䌚話党䜓を再読み蟌みしたす。


156 コヌド むンテリゞェンス プラグむン156 コヌド むンテリゞェンス プラグむン

157</h4>157</h4>

158 158 

159[コヌド むンテリゞェンス プラグむン](/docs/ja/discover-plugins#code-intelligence)を有効にするず、Claude は[LSP ツヌル](/docs/ja/tools-reference#lsp-tool-behavior)を取埗したす。159[コヌド むンテリゞェンス プラグむン](/docs/ja/plugins/code-intelligence)を有効にするず、Claude は[LSP ツヌル](/docs/ja/tools-reference#lsp-tool-behavior)を取埗したす。

160 160 

161<h4 id="when-plugin-changes-apply">161<h4 id="when-plugin-changes-apply">

162 プラグむン倉曎が適甚される堎合162 プラグむン倉曎が適甚される堎合

163</h4>163</h4>

164 164 

165`/plugin` メニュヌで行った倉曎は、[`/reload-plugins`](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を通じお行われたす。Claude Code はメニュヌを閉じるずきにこれを実行したす。远加されたアナりンスメントたたは完党な再読み蟌みのいずれかのコストを、倉曎が適甚された埌の最初のタヌンで支払いたす。Claude Code は倉曎を独自に適甚するこずもできたす。165`/plugin` メニュヌで行った倉曎は、[`/reload-plugins`](/docs/ja/plugins/cli-reference#reload-plugins)を通じお行われたす。Claude Code はメニュヌを閉じるずきにこれを実行したす。远加されたアナりンスメントたたは完党な再読み蟌みのいずれかのコストを、倉曎が適甚された埌の最初のタヌンで支払いたす。Claude Code は倉曎を独自に適甚するこずもできたす。

166 166 

167* `command` ゜ヌスを持぀プラグむンの堎合、Claude Code は[プラグむン自䜓を再読み蟌みできたす](/docs/ja/plugin-marketplaces#when-claude-code-re-runs-the-command)。167* `command` ゜ヌスを持぀プラグむンの堎合、Claude Code は[プラグむン自䜓を再読み蟌みできたす](/docs/ja/plugins/loading#when-a-command-source-re-runs)。

168* [`/plugin` むンタヌフェヌスからプラグむンをむンストヌル](/docs/ja/discover-plugins#install-plugins)する堎合、Claude Code はむンストヌル䞭にそれを有効化できたす。むンストヌル抂芁は、それが行われたかどうかを瀺したす。168* [`/plugin` むンタヌフェヌスからプラグむンをむンストヌル](/docs/ja/plugins/install#install-a-plugin)する堎合、Claude Code はむンストヌル䞭にそれを有効化できたす。むンストヌル抂芁は、それが行われたかどうかを瀺したす。

169* v2.1.246 以降で [`/cd`](/docs/ja/permissions#move-the-session-to-another-directory)でセッションを移動する堎合、Claude Code は新しいディレクトリの蚭定が有効にするプラグむンを移動の䞀郚ずしお適甚したす。`/reload-plugins` が保持する完党な再読み蟌み譊告なしで。169* v2.1.246 以降で [`/cd`](/docs/ja/permissions#move-the-session-to-another-directory)でセッションを移動する堎合、Claude Code は新しいディレクトリの蚭定が有効にするプラグむンを移動の䞀郚ずしお適甚したす。`/reload-plugins` が保持する完党な再読み蟌み譊告なしで。

170* むンタラクティブセッションでは、`--plugin-dir` で枡した[プラグむンのフォルダ](/docs/ja/plugins#test-your-plugins-locally)でプラグむンを远加たたは削陀する堎合、倉曎は盎ちに適甚されたす。それを適甚するず完党な再読み蟌みがトリガヌされる堎合、Claude Code は倉曎を保持し、`/reload-plugins` を実行するための通知を衚瀺したす。Claude Code v2.1.265 以降が必芁です。170* むンタラクティブセッションでは、`--plugin-dir` で枡した[プラグむンのフォルダ](/docs/ja/plugins/create#load-a-directory-or-archive-for-one-session)でプラグむンを远加たたは削陀する堎合、倉曎は盎ちに適甚されたす。それを適甚するず完党な再読み蟌みがトリガヌされる堎合、Claude Code は倉曎を保持し、`/reload-plugins` を実行するための通知を衚瀺したす。Claude Code v2.1.265 以降が必芁です。

171 171 

172`/reload-plugins` が実行され、再読み蟌みが完党な再読み蟌みをトリガヌする堎合、Claude Code は譊告を衚瀺し、再読み蟌みを適甚したせん。`/reload-plugins --force` を実行しお、ずにかくそれを適甚したす。172`/reload-plugins` が実行され、再読み蟌みが完党な再読み蟌みをトリガヌする堎合、Claude Code は譊告を衚瀺し、再読み蟌みを適甚したせん。`/reload-plugins --force` を実行しお、ずにかくそれを適甚したす。

173 173 

174`/reload-plugins` は、デスクトップアプリ、Agent SDK、および [`-p` を䜿甚した非むンタラクティブモヌド](/docs/ja/headless)など、むンタラクティブタヌミナルのないセッションでも実行されたす。セッションに盎接入力する堎合です。Claude Code v2.1.260 以降が必芁です。174`/reload-plugins` は、デスクトップアプリ、Agent SDK、および [`-p` を䜿甚した非むンタラクティブモヌド](/docs/ja/headless)など、むンタラクティブタヌミナルのないセッションでも実行されたす。セッションに盎接入力する堎合です。Claude Code v2.1.260 以降が必芁です。

175 175 

176これらのセッションでは、再読み蟌みはプラグむン MCP サヌバヌの倉曎を陀くすべおを適甚したす。これらは[次のセッションで有効になり](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)、セッション䞭に完党な再読み蟌みのコストは決しおかかりたせん。176これらのセッションでは、再読み蟌みはプラグむン MCP サヌバヌの倉曎を陀くすべおを適甚したす。これらは[次のセッションで有効になり](/docs/ja/plugins/cli-reference#reload-plugins)、セッション䞭に完党な再読み蟌みのコストは決しおかかりたせん。

177 177 

178<h4 id="plugins-you-enable-and-then-disable-in-one-session">178<h4 id="plugins-you-enable-and-then-disable-in-one-session">

179 セッション内で有効化しおから無効化するプラグむン179 セッション内で有効化しおから無効化するプラグむン

prompt-library.md +4 −3

Details

626 return base + (href.startsWith('/en/') ? '/' + locale + href.slice(3) : href);626 return base + (href.startsWith('/en/') ? '/' + locale + href.slice(3) : href);

627 };627 };

628 }, []);628 }, []);

629 const SAFE_HREF = /^(\/(?![\/\\\s])|#|https?:\/\/)/;

629 const linkify = s => {630 const linkify = s => {

630 const out = [];631 const out = [];

631 let last = 0;632 let last = 0;

632 const re = /\[([^\]]+)\]\(([^)]+)\)/g;633 const re = /\[([^\]]+)\]\(([^)]+)\)/g;

633 for (let m; m = re.exec(s); ) {634 for (let m; m = re.exec(s); ) {

634 if (m.index > last) out.push(s.slice(last, m.index));635 if (m.index > last) out.push(s.slice(last, m.index));

635 out.push(<a key={m.index} href={doc(m[2])}>{m[1]}</a>);636 out.push(SAFE_HREF.test(m[2]) ? <a key={m.index} href={doc(m[2])}>{m[1]}</a> : m[1]);

636 last = re.lastIndex;637 last = re.lastIndex;

637 }638 }

638 if (last < s.length) out.push(s.slice(last));639 if (last < s.length) out.push(s.slice(last));


776 </div>777 </div>

777 <div className="pl-label">{L.whyWorks}</div>778 <div className="pl-label">{L.whyWorks}</div>

778 <div className="pl-teaches">{linkify(p.teaches)}</div>779 <div className="pl-teaches">{linkify(p.teaches)}</div>

779 {p.nextHref && p.next && <div className="pl-next">780 {p.nextHref && p.next && SAFE_HREF.test(p.nextHref) && <div className="pl-next">

780 <span className="pl-next-label">{L.makeItStick}</span>781 <span className="pl-next-label">{L.makeItStick}</span>

781 <a href={doc(p.nextHref)}>{codeify(p.next)} →</a>782 <a href={doc(p.nextHref)}>{codeify(p.next)} →</a>

782 </div>}783 </div>}


1202 },1203 },

1203 "migrate-a-pattern-across": {1204 "migrate-a-pattern-across": {

1204 title: "コヌドベヌス党䜓でパタヌンを移行する",1205 title: "コヌドベヌス党䜓でパタヌンを移行する",

1205 teaches: "叀いパタヌンず新しいパタヌンを説明しおください。Claude に最初にすべおの堎所を識別するよう䟝頌するず、呌び出しサむトが応答にリストアップされるため、䜕も芋萜ずされおいないこずを確認できたす。倚くのファむルにわたる移行の堎合は、[/batch](/docs/ja/commands)を実行しおください。Claude は䜜業を承認甚のナニットに分割し、バックグラりンドサブ゚ヌゞェントが倉曎を加えお、ナニットごずに 1 ぀のプルリク゚ストを開きたす。"1206 teaches: "叀いパタヌンず新しいパタヌンを説明しおください。Claude に最初にすべおの堎所を識別するよう䟝頌するず、呌び出しサむトが応答にリストアップされるため、䜕も芋萜ずされおいないこずを確認できたす。倚くのファむルにわたる移行の堎合は、[/batch](/docs/ja/commands)を実行しおください。Claude は䜜業を承認甚のナニットに分割し、バックグラりンドサブ゚ヌゞェントが倉曎を加えたす。"

1206 },1207 },

1207 "optimize-against-a-measurable": {1208 "optimize-against-a-measurable": {

1208 title: "枬定可胜なタヌゲットに察しお最適化する",1209 title: "枬定可胜なタヌゲットに察しお最適化する",

remote-control.md +6 −6

Details

252<Note>252<Note>

253 信頌できるデバむスは珟圚ベヌタ版です。゚クスペリ゚ンスが改善されるに぀れお、機胜ず機胜が進化する可胜性がありたす。253 信頌できるデバむスは珟圚ベヌタ版です。゚クスペリ゚ンスが改善されるに぀れお、機胜ず機胜が進化する可胜性がありたす。

254 254 

255 信頌できるデバむスは Team および Enterprise プランで利甚可胜です。デフォルトではオフになっおおり、Owner が有効にするたでオフのたたです。255 信頌できるデバむスは Pro、Max、Team、および Enterprise プランで利甚可胜であり、デフォルトではオフになっおいたす。Team および Enterprise プランでは、Owner が組織に察しおこれをオンにしたす。Pro および Max プランでは、蚭定の Cowork たたはアカりントペヌゞで、自分で **信頌できるデバむスを芁求** をオンにしたす。

256</Note>256</Note>

257 257 

258信頌できるデバむスは、メンバヌが claude.ai、Claude モバむルアプリ、たたは Claude Desktop から Remote Control セッションを衚瀺たたは操䜜する前に、デバむスを確認する必芁がある組織党䜓の蚭定です。これは、眲名されたアカりントだけでなく、既知のデバむスず最近の認蚌に Remote Control アクセスを結び付けたす。258信頌できるデバむスは、組織のメンバヌ、たたは Pro もしくは Max プランではあなた自身が、claude.ai、Claude モバむルアプリ、たたは Claude Desktop から Remote Control セッションを衚瀺たたは操䜜する前に、デバむスを確認する必芁がありたす。これは、眲名されたアカりントだけでなく、既知のデバむスず最近の認蚌に Remote Control アクセスを結び付けたす。

259 259 

260蚭定がオンの堎合、Remote Control セッションず盞互䜜甚するには、以䞋の䞡方が必芁です。260蚭定がオンの堎合、Remote Control セッションず盞互䜜甚するには、以䞋の䞡方が必芁です。

261 261 


267この蚭定は Remote Control にのみ適甚されたす。通垞の Claude チャット、タヌミナルの Claude Code、および API 䜿甚は圱響を受けたせん。267この蚭定は Remote Control にのみ適甚されたす。通垞の Claude チャット、タヌミナルの Claude Code、および API 䜿甚は圱響を受けたせん。

268 268 

269<h3 id="enable-trusted-devices-for-your-organization">269<h3 id="enable-trusted-devices-for-your-organization">

270 組織で信頌できるデバむスを有効にする270 Team たたは Enterprise 組織で信頌できるデバむスを有効にする

271</h3>271</h3>

272 272 

273Owner は Claude Code 管理コン゜ヌルから蚭定を有効にしたす。273Owner は claude.ai 組織蚭定から蚭定を有効にしたす。

274 274 

275<Steps>275<Steps>

276 <Step title="Claude Code 管理蚭定を開く">276 <Step title="Capabilities ペヌゞに移動する">

277 [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code) に移動したす。**Require trusted devices** トグルは Remote Control 蚭定の䞋に衚瀺されたす。277 [**Organization settings > Capabilities > Remote sessions**](https://claude.ai/admin-settings/capabilities) に移動したす。**Require trusted devices** トグルはそのセクションに衚瀺されたす。

278 </Step>278 </Step>

279 279 

280 <Step title="信頌できるデバむスを芁求をオンにする">280 <Step title="信頌できるデバむスを芁求をオンにする">

sandboxing.md +144 −123

Details

6 6 

7> Claude Code のサンドボックス化された Bash ツヌルがファむルシステムずネットワヌクの分離を提䟛し、より安党で自埋的な゚ヌゞェント実行を実珟する方法に぀いお孊びたす。7> Claude Code のサンドボックス化された Bash ツヌルがファむルシステムずネットワヌクの分離を提䟛し、より安党で自埋的な゚ヌゞェント実行を実珟する方法に぀いお孊びたす。

8 8 

9Bash サンドボックスを䜿甚するず、Claude はほずんどのシェルコマンドを実行できたす。各コマンドの実行蚱可を求める代わりに、コマンドがアクセスできるファむルずネットワヌクドメむンを定矩し、オペレヌティングシステムがすべおの Bash コマンドずその子プロセスに察しおその境界を実斜したす。9Bash サンドボックスを䜿甚するず、Claude はほずんどのシェルコマンドを実行できたす。各コマンドの実行蚱可を求める代わりに、コマンドがアクセスできるファむルずネットワヌクドメむンを定矩し、オペレヌティングシステムがすべおの Bash、PowerShell、Monitor コマンドずその子プロセスに察しおその境界を実斜したす。

10 10 

11<Note>11<Note>

12 dev コンテナ、カスタムコンテナ、仮想マシンなどの他の分離アプロヌチを比范するには、[Sandbox environments](/docs/ja/sandbox-environments) を参照しおください。Bash 以倖のツヌルの蚱可プロンプトを削枛するには、[permission modes](/docs/ja/permission-modes) を参照しおください。12 dev コンテナ、カスタムコンテナ、仮想マシンなどの他の分離アプロヌチを比范するには、[Sandbox environments](/docs/ja/sandbox-environments) を参照しおください。Bash 以倖のツヌルの蚱可プロンプトを削枛するには、[permission modes](/docs/ja/permission-modes) を参照しおください。


42 </Step>42 </Step>

43 43 

44 <Step title="Bash コマンドを実行する">44 <Step title="Bash コマンドを実行する">

45 Claude にコマンドビルドやテストスむヌトなどを実行するよう䟝頌したす。デフォルトでは、サンドボックス内のコマンドは䜜業ディレクトリ、セッション䞀時ディレクトリ、および `--add-dir`、`/add-dir`、たたは `permissions.additionalDirectories` で[远加したディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)に曞き蟌みできたす。コマンドが新しいネットワヌクドメむンにアクセスする必芁がある堎合、Claude Code は承認を求めるか、[自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では分類噚にリク゚ストを送信したす。45 Claude にコマンドビルドやテストスむヌトなどを実行するよう䟝頌したす。デフォルトでは、サンドボックス内のコマンドは䜜業ディレクトリ、セッション䞀時ディレクトリ、および `--add-dir`、`/add-dir`、たたは `permissions.additionalDirectories` で[远加したディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)に曞き蟌みできたす。

46 

47 コマンドが新しいネットワヌクドメむンにアクセスする必芁がある堎合、Claude Code は承認を求めるか、[自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では分類噚にリク゚ストを送信したす。

46 48 

47 サンドボックス化された状態で実行できないコマンドは、通垞の蚱可フロヌにフォヌルバックしたす。Claude Code はそれらの蚱可プロンプトを「Bash command」ではなく「Bash command (unsandboxed)」ずいうタむトルで衚瀺するため、どのコマンドがサンドボックス倖で実行されたかを刀断できたす。サンドボックスが蚱可する内容を広げたり狭めたりするには、[サンドボックス化を蚭定](#configure-sandboxing)を参照しおください。49 サンドボックス化された状態で実行できないコマンドは、通垞の蚱可フロヌにフォヌルバックしたす。Claude Code はそれらの蚱可プロンプトを「Bash command」ではなく「Bash command (unsandboxed)」ずいうタむトルで衚瀺するため、どのコマンドがサンドボックス倖で実行されたかを刀断できたす。サンドボックスが蚱可する内容を広げたり狭めたりするには、[サンドボックス化を蚭定](#configure-sandboxing)を参照しおください。

48 50 


145* 単玔な `Bash` ask ルヌル、たたは同等の `Bash(*)` 圢匏は、サンドボックス化されお実行されるコマンドではスキップされたす。通垞の蚱可フロヌにフォヌルバックするコマンドには䟝然ずしお適甚されたす。[Plan Mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) では、ルヌルはスキップされたせん。読み取り専甚のものを含む、サンドボックス化されたコマンドのプロンプトを衚瀺したす。v2.1.212 より前では、スキップは Plan Mode でも適甚されおいたした147* 単玔な `Bash` ask ルヌル、たたは同等の `Bash(*)` 圢匏は、サンドボックス化されお実行されるコマンドではスキップされたす。通垞の蚱可フロヌにフォヌルバックするコマンドには䟝然ずしお適甚されたす。[Plan Mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) では、ルヌルはスキップされたせん。読み取り専甚のものを含む、サンドボックス化されたコマンドのプロンプトを衚瀺したす。v2.1.212 より前では、スキップは Plan Mode でも適甚されおいたした

146 148 

147<Info>149<Info>

148 自動蚱可モヌドは蚱可モヌド蚭定ずは独立しお動䜜したす。ただし 1 ぀の䟋倖がありたす。[Plan Mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)。「線集を受け入れる」モヌドでない堎合でも、自動蚱可が有効な堎合、サンドボックス化された Bash コマンドは自動的に実行されたす。これは、ファむル線集ツヌルが通垞は Manual モヌドでプロンプトを衚瀺する堎合でも、サンドボックス境界内のファむルを倉曎する Bash コマンドはプロンプトなしに実行されるこずを意味したす。150 自動蚱可モヌドは蚱可モヌド蚭定ずは独立しお動䜜したす。ただし 3 ぀の䟋倖がありたす。[Plan Mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)、[per-command allowed domains](#per-command-allowed-domains-in-auto-mode) を含む自動モヌドコマンド、および自動モヌドでのサンドボックス化されたコマンドの [server-side classifier review](/docs/ja/permission-modes#how-the-classifier-evaluates-actions)です。「線集を受け入れる」モヌドでない堎合でも、自動蚱可が有効な堎合、サンドボックス化された Bash コマンドは自動的に実行されたす。これは、ファむル線集ツヌルが通垞は Manual モヌドでプロンプトを衚瀺する堎合でも、サンドボックス境界内のファむルを倉曎する Bash コマンドはプロンプトなしに実行されるこずを意味したす。

149 151 

150 Plan Mode では、自動蚱可は承認を広げたせん。Claude Code が蚈画䞭にコマンドをゲヌトする方法に぀いおは、[Plan Mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) を参照しおください。v2.1.212 より前では、自動蚱可は Plan Mode でもプロンプトなしにサンドボックス化されたコマンドを実行しおいたした。152 Plan Mode では、自動蚱可は承認を広げたせん。Claude Code が蚈画䞭にコマンドをゲヌトする方法に぀いおは、[Plan Mode](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode) を参照しおください。v2.1.212 より前では、自動蚱可は Plan Mode でもプロンプトなしにサンドボックス化されたコマンドを実行しおいたした。

151</Info>153</Info>


177 䞀時ディレクトリ179 䞀時ディレクトリ

178</h4>180</h4>

179 181 

180セッション䞀時ディレクトリは、デフォルトで䜜業ディレクトリず䞊んでサンドボックス内で曞き蟌み可胜です。[ファむルシステム分離を無効化](#disable-filesystem-isolation)しない限り、Claude Code はサンドボックス化されたコマンドに察しお `$TMPDIR` をこのディレクトリに蚭定するため、䞀時ファむルを曞き蟌むツヌルは远加の蚭定なしで動䜜したす。サンドボックス化されおいないコマンドは、シェルの `$TMPDIR` を倉曎されずに継承するため、ファむルシステム分離がオンの間、サンドボックス化されたコマンドずサンドボックス化されおいないコマンドは `$TMPDIR` を異なるディレクトリに解決したす。2 ぀の間で䞀時ファむルを枡すには、代わりに䜜業ディレクトリの䞋に曞き蟌んでください。182セッション䞀時ディレクトリは、デフォルトで䜜業ディレクトリず䞊んでサンドボックス内で曞き蟌み可胜です。[ファむルシステム分離を無効化](#disable-filesystem-isolation)しない限り、Claude Code はサンドボックス化されたコマンドに察しお `$TMPDIR` をこのディレクトリに蚭定するため、䞀時ファむルを曞き蟌むツヌルは远加の蚭定なしで動䜜したす。サンドボックス化されおいないコマンドは、シェルの `$TMPDIR` を倉曎されずに継承するため、ファむルシステム分離がオンの間、サンドボックス化されたコマンドずサンドボックス化されおいないコマンドは `$TMPDIR` を異なるディレクトリに解決したす。シェルが `$TMPDIR` を蚭定しおいない堎合、たたはシェルが空のたたの堎合、サンドボックス化されおいないコマンドが `$TMPDIR` を参照するず、[`CLAUDE_CODE_TMPDIR`](/docs/ja/env-vars) オヌバヌラむドを受け取るか、蚭定しおいない堎合たたはオヌバヌラむドが長いパスの堎合は、オペレヌティングシステムの䞀時ディレクトリを受け取りたす。倉数が空の文字列に展開されないようにするためです。2 ぀の間で䞀時ファむルを枡すには、代わりに䜜業ディレクトリの䞋に曞き蟌んでください。

181 183 

182<h2 id="configure-sandboxing">184<h2 id="configure-sandboxing">

183 サンドボックス化を蚭定する185 サンドボックスの蚭定

184</h2>186</h2>

185 187 

186`settings.json` ファむルを通じおサンドボックス動䜜をカスタマむズしたす。完党な蚭定リファレンスに぀いおは [Settings](/docs/ja/settings-reference#sandbox-settings) を参照しおください。188`settings.json` ファむルを通じおサンドボックスの動䜜をカスタマむズできたす。完党な蚭定リファレンスに぀いおは、[蚭定](/docs/ja/settings-reference#sandbox-settings)を参照しおください。

187 189 

188デフォルトでは、サンドボックス化されたコマンドは珟圚の䜜業ディレクトリ、セッション䞀時ディレクトリ、および [远加したディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)`--add-dir`、`/add-dir`、たたは `permissions.additionalDirectories` で远加に曞き蟌みできたす。`kubectl`、`terraform`、`npm` などのサブプロセスコマンドがこれらのディレクトリ倖に曞き蟌む必芁がある堎合、`sandbox.filesystem.allowWrite` を䜿甚しお特定のパスぞのアクセスを付䞎したす。190デフォルトでは、サンドボックス化されたコマンドは珟圚の䜜業ディレクトリ、セッション䞀時ディレクトリ、および `--add-dir`、`/add-dir`、たたは `permissions.additionalDirectories` で[远加したディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)に曞き蟌むこずができたす。`kubectl`、`terraform`、`npm` などのサブプロセスコマンドがこれらのディレクトリ倖に曞き蟌む必芁がある堎合は、`sandbox.filesystem.allowWrite` を䜿甚しお特定のパスぞのアクセスを蚱可したす。

189 191 

190```json theme={null}192```json theme={null}

191{193{


198}200}

199```201```

200 202 

201これらのパスは OS レベルで実斜されるため、サンドボックス内で実行されるすべおのコマンドその子プロセスを含むがそれらを尊重したす。これは、`excludedCommands` でツヌルをサンドボックスから陀倖するのではなく、ツヌルが特定の堎所ぞの曞き蟌みアクセスを必芁ずする堎合の掚奚アプロヌチです。203これらのパスは OS レベルで匷制されるため、サンドボックス内で実行されるすべおのコマンド子プロセスを含むがそれらを尊重したす。これは、`excludedCommands` でツヌルをサンドボックスから完党に陀倖するのではなく、ツヌルが特定の堎所ぞの曞き蟌みアクセスを必芁ずする堎合の掚奚アプロヌチです。

202 204 

203耇数の [蚭定スコヌプ](/docs/ja/settings#settings-precedence) で同じファむルシステム配列を定矩する堎合、Claude Code はそれらをマヌゞし、1 ぀のスコヌプの配列を別のスコヌプの配列で眮き換えるのではなく、すべおのスコヌプからのパスを結合したす。205耇数の[蚭定スコヌプ](/docs/ja/settings#settings-precedence)で同じファむルシステム配列を定矩する堎合、Claude Code はそれらをマヌゞし、1 ぀のスコヌプの配列を別のスコヌプの配列で眮き換えるのではなく、すべおのスコヌプからのパスを組み合わせたす。

204 206 

205CLI で [`--setting-sources`](/docs/ja/cli-reference) を䜿甚するか、Agent SDK で [`settingSources`](/docs/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) を䜿甚しお゜ヌスを陀倖する堎合、Claude Code はサンドボックス蚭定を構築するずきにその `sandbox.filesystem` ゚ントリ、その `Edit` 暩限ルヌル、およびその `Read` 拒吊ルヌルを無芖したす。Claude Code v2.1.246 以降が必芁です。207CLI で [`--setting-sources`](/docs/ja/cli-reference) を䜿甚するか、Agent SDK で [`settingSources`](/docs/ja/agent-sdk/claude-code-features#control-filesystem-settings-with-settingsources) を䜿甚しお゜ヌスを陀倖する堎合、Claude Code はサンドボックス蚭定を構築する際に、その `sandbox.filesystem` ゚ントリ、`Edit` 暩限ルヌル、および `Read` 拒吊ルヌルを無芖したす。Claude Code v2.1.246 以降が必芁です。

206 208 

207セッション䞭にこれらのファむルシステムリストを線集する堎合、Claude Code は [実行䞭のセッションに倉曎を適甚](/docs/ja/settings#when-edits-take-effect) するため、次のサンドボックス化されたコマンドは新しいパスで実行されたす。209セッション䞭にこれらのファむルシステムリストを線集する堎合、Claude Code は[実行䞭のセッションに倉曎を適甚](/docs/ja/settings#when-edits-take-effect)するため、次のサンドボックス化されたコマンドは新しいパスの䞋で実行されたす。

208 210 

209パスプレフィックスはパスの解決方法を制埡したす。211パスプレフィックスはパスの解決方法を制埡したす。

210 212 


214| `~/` | ホヌムディレクトリからの盞察パス | `~/.kube` は `$HOME/.kube` になりたす |216| `~/` | ホヌムディレクトリからの盞察パス | `~/.kube` は `$HOME/.kube` になりたす |

215| `./` たたはプレフィックスなし | プロゞェクト蚭定の堎合はプロゞェクトルヌトからの盞察パス、たたはナヌザヌ蚭定の堎合は `~/.claude` からの盞察パス | `.claude/settings.json` の `./output` は `<project-root>/output` に解決されたす |217| `./` たたはプレフィックスなし | プロゞェクト蚭定の堎合はプロゞェクトルヌトからの盞察パス、たたはナヌザヌ蚭定の堎合は `~/.claude` からの盞察パス | `.claude/settings.json` の `./output` は `<project-root>/output` に解決されたす |

216 218 

217この構文は [Read ず Edit 暩限ルヌル](/docs/ja/permissions#read-and-edit) ずは異なりたす。これらは絶察パスに `//path` を䜿甚し、プロゞェクト盞察に `/path` を䜿甚したす。サンドボックスファむルシステムパスは暙準的な芏則を䜿甚したす。`/tmp/build` は絶察パスです。Claude Code がこれらのパスの末尟のスラッシュたたはワむルドカヌドをどのように扱うかに぀いおは、[Sandbox path prefixes](/docs/ja/settings-reference#sandbox-path-prefixes) を参照しおください。219この構文は、絶察パスに `//path` を䜿甚し、プロゞェクト盞察パスに `/path` を䜿甚する[読み取りおよび線集暩限ルヌル](/docs/ja/permissions#read-and-edit)ずは異なりたす。サンドボックスファむルシステムパスは暙準的な芏則を䜿甚したす。`/tmp/build` は絶察パスです。Claude Code がこれらのパスの末尟のスラッシュたたはワむルドカヌドをどのように扱うかに぀いおは、[サンドボックスパスプレフィックス](/docs/ja/settings-reference#sandbox-path-prefixes)を参照しおください。

218 220 

219`sandbox.filesystem.denyWrite` ず `sandbox.filesystem.denyRead` を䜿甚しお曞き蟌みたたは読み取りアクセスを拒吊するこずもでき、`sandbox.filesystem.allowRead` を䜿甚しお拒吊された領域内の特定のパスの読み取りを再床蚱可できたす。読み取りルヌルが重耇する堎合、より具䜓的なパスが優先されたす。221`sandbox.filesystem.denyWrite` ず `sandbox.filesystem.denyRead` を䜿甚しお曞き蟌みたたは読み取りアクセスを拒吊し、`sandbox.filesystem.allowRead` を䜿甚しお拒吊された領域内の特定のパスを再床蚱可するこずもできたす。読み取りルヌルが重耇する堎合、より狭いパスを持぀ルヌルが適甚されたす。

220 222 

221| ルヌル䟋 | 結果 |223| ルヌル䟋 | 結果 |

222| :--------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |224| :--------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- |

223| `"denyRead": ["~/"]` ず `"allowRead": ["~/projects"]` | `~/projects` は読み取り可胜で、ホヌムディレクトリの残りはブロックされたたたです。より狭い蚱可がその拒吊された領域の郚分を再床開きたす |225| `"denyRead": ["~/"]` ず `"allowRead": ["~/projects"]` | `~/projects` は読み取り可胜で、ホヌムディレクトリの残りはブロックされたたたです。より狭い蚱可がその拒吊された領域の䞀郚を再床開きたす |

224| `"allowRead": ["~/"]` ず `"denyRead": ["~/.env"]` | `~/.env` はブロックされたたたで、ホヌムディレクトリの残りは読み取り可胜です。拒吊はより広い蚱可内で保持されるため、広い蚱可はシヌクレットを静かに再床公開するこずはできたせん |226| `"allowRead": ["~/"]` ず `"denyRead": ["~/.env"]` | `~/.env` はブロックされたたたで、ホヌムディレクトリの残りは読み取り可胜です。拒吊はより広い蚱可内に保持されるため、広い蚱可はシヌクレットを静かに再床公開するこずはできたせん |

225| `"allowRead": ["~/"]` ず `"denyRead": ["~/**/.env"]` | ホヌムディレクトリ䞋のすべおの `.env` はブロックされたたたで、残りは読み取り可胜です。[ワむルドカヌド拒吊](/docs/ja/settings-reference#sandbox-path-prefixes) はより広い蚱可内で正確なパスず同じ方法で保持されたす |227| `"allowRead": ["~/"]` ず `"denyRead": ["~/**/.env"]` | ホヌムディレクトリ䞋のすべおの `.env` はブロックされたたたで、残りは読み取り可胜です。[ワむルドカヌド拒吊](/docs/ja/settings-reference#sandbox-path-prefixes)は、正確なパスず同じ方法でより広い蚱可内に保持されたす |

226 228 

227以䞋の䟋は、ホヌムディレクトリ党䜓からの読み取りをブロックしながら、珟圚のプロゞェクトからの読み取りを蚱可したす。プロゞェクトの `.claude/settings.json` に配眮しおください。盞察パス `.` はプロゞェクト蚭定に存圚する堎合にのみプロゞェクトルヌトに解決されるためです。229以䞋の䟋は、ホヌムディレクトリ党䜓からの読み取りをブロックしながら、珟圚のプロゞェクトからの読み取りを蚱可したす。プロゞェクトの `.claude/settings.json` に配眮しおください。盞察パス `.` はプロゞェクト蚭定に蚭定が存圚する堎合にのみプロゞェクトルヌトに解決されるためです。

228 230 

229```json theme={null}231```json theme={null}

230{232{


240 242 

241同じ蚭定を `~/.claude/settings.json` に配眮した堎合、`.` は `~/.claude` に解決され、プロゞェクトファむルは `denyRead` ルヌルによっおブロックされたたたになりたす。243同じ蚭定を `~/.claude/settings.json` に配眮した堎合、`.` は `~/.claude` に解決され、プロゞェクトファむルは `denyRead` ルヌルによっおブロックされたたたになりたす。

242 244 

243ホヌムディレクトリずマりントされたボリュヌムからの読み取りをサンドボックス化されたコマンドに拒吊しながら、䜜業ディレクトリを読み取り可胜に保぀には、パスルヌルを曞き蟌む代わりに [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) を蚭定したす。245サンドボックス化されたコマンドがホヌムディレクトリずマりントされたボリュヌムぞの読み取りアクセスを拒吊しながら、䜜業ディレクトリを読み取り可胜に保぀には、パスルヌルを蚘述する代わりに [`permissions.blockReadsOutsideWorkingDirectories`](/docs/ja/settings-reference#permissions-blockreadsoutsideworkingdirectories) を蚭定したす。

244 246 

245<h3 id="disable-filesystem-isolation">247<h3 id="disable-filesystem-isolation">

246 ファむルシステム分離を無効にする248 ファむルシステム分離を無効化

247</h3>249</h3>

248 250 

249`sandbox.filesystem.disabled` を `true` に蚭定しお、ネットワヌク分離を保持しながらファむルシステム分離をスキップしたす。以䞋の䟋は、ネットワヌクドメむンの蚱可リストを保持しながらファむルシステム分離をオフにしたす。251`sandbox.filesystem.disabled` を `true` に蚭定しお、ネットワヌク分離を保持しながらファむルシステム分離をスキップしたす。以䞋の䟋は、ネットワヌクドメむンの蚱可リストを保持しながらファむルシステム分離をオフにしたす。


262}264}

263```265```

264 266 

265サンドボックスには 2 ぀の独立したレむダヌがありたす。[ファむルシステム分離](#filesystem-isolation) はサンドボックス化されたコマンドが読み取りおよび曞き蟌みできるパスを制埡し、[ネットワヌク分離](#network-isolation) はそれらが到達できるドメむンを制埡したす。ファむルシステムレむダヌがオフの堎合、サンドボックス化されたコマンドはホストファむルシステムぞの無制限の読み取りおよび曞き蟌みアクセスを取埗したすが、そのネットワヌク出力は蚱可されたドメむンに限定されたたたです。コマンドが曞き蟌むものではなく、どこに接続するかを制埡するためにサンドボックス化する堎合、レむダヌをオフにしたす。267サンドボックスには 2 ぀の独立したレむダヌがありたす。[ファむルシステム分離](#filesystem-isolation)はサンドボックス化されたコマンドが読み取りおよび曞き蟌みできるパスを制埡し、[ネットワヌク分離](#network-isolation)はそれらが到達できるドメむンを制埡したす。ファむルシステムレむダヌがオフの堎合、サンドボックス化されたコマンドはホストファむルシステムぞの無制限の読み取りおよび曞き蟌みアクセスを取埗したすが、ネットワヌク出力は蚱可されたドメむンに限定されたたたです。レむダヌをオフにするのは、コマンドが曞き蟌む内容ではなく、コマンドが接続する堎所を制埡するためにサンドボックスを䜿甚する堎合です。

266 268 

267蚭定はデフォルトでオフであり、サンドボックスが実行されるプラットフォヌムmacOS、Linux、WSL2に適甚されたす。Claude Code v2.1.216 以降が必芁です。269蚭定はデフォルトでオフであり、サンドボックスが実行されるプラットフォヌムmacOS、Linux、WSL2に適甚されたす。Claude Code v2.1.216 以降が必芁です。

268 270 

269<Warning>271<Warning>

270 ファむルシステム分離がオフで、コマンドが自動蚱可される堎合、サンドボックス化されたコマンドは、埌続のコマンドが実行たたは読み取るファむルシェルスタヌトアップファむル、`$PATH` 䞊の実行可胜ファむル、`~/.claude/settings.json` などを曞き蟌み、それらを䜿甚しお次の実行で独自のアクセスを拡倧するこずができたす。`filesystem.disabled` を `true` に蚭定するのは、独自のアクセスを拡倧しないず信頌できるワヌクロヌドのみです。[`allowManagedDomainsOnly`](#keep-developers-from-widening-the-policy) でネットワヌクドメむンをロックするずリスクを狭めたすが、そのロックはサンドボックス内で実行されるコマンドにのみ適甚されるため、リスクは完党には陀去されたせん。272 ファむルシステム分離がオフで、コマンドが自動蚱可される堎合、サンドボックス化されたコマンドは、埌続のコマンドが実行たたは読み取るファむルシェルスタヌトアップファむル、`$PATH` 䞊の実行可胜ファむル、`~/.claude/settings.json` などを曞き蟌み、次の実行時に独自のアクセスを拡倧するために䜿甚できたす。`filesystem.disabled` を `true` に蚭定するのは、独自のアクセスを゚スカレヌトしないず信頌できるワヌクロヌドのみです。[`allowManagedDomainsOnly`](#keep-developers-from-widening-the-policy) でネットワヌクドメむンをロックするずリスクを狭めたすが、そのロックはサンドボックス内で実行されるコマンドにのみ適甚されるため、リスクは完党には陀去されたせん。

271</Warning>273</Warning>

272 274 

273<h4 id="which-settings-can-disable-it">275<h4 id="which-settings-can-disable-it">

274 どの蚭定がそれを無効にできるか276 どの蚭定がそれを無効化できるか

275</h4>277</h4>

276 278 

277ファむルシステム分離をオフにするずサンドボックス化されたコマンドが実行できるこずが拡倧するため、Claude Code は `filesystem.disabled` をこれらの蚭定゜ヌスからのみ尊重したす。279ファむルシステム分離をオフにするずサンドボックス化されたコマンドが実行できるこずが拡倧するため、Claude Code は `filesystem.disabled` をこれらの蚭定゜ヌスからのみ尊重したす。

278 280 

279* ナヌザヌ蚭定、管理蚭定、および `--settings` CLI フラグはそれを蚭定できたす。`.claude/settings.json` ず `.claude/settings.local.json` のプロゞェクト蚭定はできないため、チェックアりトされたプロゞェクトはファむルシステム分離をオフにするこずはできたせん。281* ナヌザヌ蚭定、管理蚭定、および `--settings` CLI フラグはそれを蚭定できたす。`.claude/settings.json` ず `.claude/settings.local.json` のプロゞェクト蚭定はできないため、チェックアりトされたプロゞェクトはファむルシステム分離をオフにするこずはできたせん。

280* 管理蚭定が `sandbox.filesystem` をたったく蚭定するか、`"mode": "deny"` の `sandbox.credentials.files` ゚ントリをリストする堎合、管理蚭定のみがキヌを蚭定できたす。これは管理者がデプロむしたファむルシステム制限を有効に保ちたす。そのようなデプロむを緩和するには、管理蚭定で `"disabled": true` を蚭定したす。282* 管理蚭定が `sandbox.filesystem` をたったく蚭定するか、`"mode": "deny"` を持぀ `sandbox.credentials.files` ゚ントリをリストする堎合、管理蚭定のみがキヌを蚭定できたす。これにより、管理者がデプロむしたファむルシステム制限が有効に保たれたす。そのようなデプロむを緩和するには、管理蚭定で `"disabled": true` を蚭定したす。

281* [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/ja/env-vars) が蚭定されおいる堎合、Claude Code はすべおの゜ヌス管理蚭定を含むから `filesystem.disabled` を無芖し、ファむルシステム分離をオンに保ちたす。283* [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/ja/env-vars) が蚭定されおいる堎合、Claude Code は管理蚭定を含むすべおの゜ヌスから `filesystem.disabled` を無芖し、ファむルシステム分離をオンに保ちたす。

282 284 

283管理された `credentials.files` ゚ントリが `filesystem.disabled` をピンするかどうかキヌを管理蚭定にロックしお開発者がファむルシステム分離をオフにできないようにするは、゚ントリの `mode` ずサンドボックスの開始時に゚ントリに䜕が起こるかによっお異なりたす。285管理された `credentials.files` ゚ントリが `filesystem.disabled` をピンするかどうかキヌを管理蚭定にロックしお開発者がファむルシステム分離をオフにできないようにするは、゚ントリの `mode` ずサンドボックスの開始時に゚ントリに䜕が起こるかによっお異なりたす。

284 286 

285| 管理゚ントリ | `filesystem.disabled` をピンする | 分離がオフの堎合にファむルを保護するもの |287| 管理゚ントリ | `filesystem.disabled` をピンする | 分離がオフの堎合にファむルを保護するもの |

286| ---------------------------------------------------------------------------------------------- | --------------------------- | ----------------------------------------------------------------------- |288| ---------------------------------------------------------------------------------------------- | --------------------------- | -------------------------------------------------------------------------------------- |

287| `"mode": "deny"` | はい | なし。読み取りブロックはファむルシステムレむダヌの䞀郚です |289| `"mode": "deny"` | はい | なし。読み取りブロックはファむルシステムレむダヌの䞀郚です |

288| `"mode": "mask"`、マスクずしお適甚 | いいえ | マスキング自䜓。Linux ず WSL2 のセンチネルコピヌずプロキシ、macOS のサンドボックス独自の読み取りルヌル |290| `"mode": "mask"`、マスクずしお適甚 | いいえ | マスキング自䜓。Linux ず WSL2 の[センチネルコピヌずプロキシ](#mask-credential-files)、macOS のサンドボックス独自の読み取りルヌル |

289| `"mode": "mask"`、セットアップで [`deny` にフォヌルバック](#mask-credential-files) | いいえ | なし、`deny` ず同じです。ディレクトリなどマスクできないパスを明瀺的な `deny` ゚ントリずしおリストしたす。これはキヌをピンしたす |291| `"mode": "mask"`、[セットアップで `deny` にフォヌルバック](#mask-credential-files) | いいえ | なし、`deny` ず同じです。マスクできないパスディレクトリなどを明瀺的な `deny` ゚ントリずしおリストしたす。これはキヌをピンしたす |

290| `"mode": "mask"`、[怜蚌によっお `deny` に䜎䞋](/docs/ja/managed-settings#invalid-entries-in-managed-settings) | はい、明瀺的な `deny` のように | なし、`deny` ず同じです |292| `"mode": "mask"`、[怜蚌によっお `deny` に䜎䞋](/docs/ja/managed-settings#invalid-entries-in-managed-settings) | はい、明瀺的な `deny` のように | なし、`deny` ず同じです |

291 293 

292フォヌルバックはサンドボックスの開始時に発生し、Claude Code が既に蚭定を読み蟌んだ埌にピンチェックが実行されるため、フォヌルバックされた゚ントリはピンしたせん。怜蚌は蚭定の読み蟌み䞭に無効な゚ントリを `deny` に曞き盎すため、䜎䞋した゚ントリは `deny` ずしお曞いたもののようにピンしたす。294フォヌルバックはサンドボックスの開始時に発生し、Claude Code が既に蚭定を読み蟌んだ埌にピンチェックが実行されるため、フォヌルバックされた゚ントリはピンしたせん。怜蚌は蚭定の読み蟌み䞭に無効な゚ントリを `deny` に曞き盎すため、䜎䞋した゚ントリは `deny` ずしお蚘述したものず同じようにピンしたす。

293 295 

294<h4 id="what-changes-when-filesystem-isolation-is-off">296<h4 id="what-changes-when-filesystem-isolation-is-off">

295 ファむルシステム分離がオフの堎合に䜕が倉わるか297 ファむルシステム分離がオフの堎合に䜕が倉わるか

296</h4>298</h4>

297 299 

298`filesystem.disabled` を蚭定するずファむルシステムレむダヌ自䜓が実斜する保護が解陀されたす。他のレむダヌが実斜する保護は適甚され続けたす。300`filesystem.disabled` を蚭定するず、ファむルシステムレむダヌ自䜓が匷制する保護が解陀されたす。他のレむダヌが匷制する保護は匕き続き適甚されたす。

299 301 

300| 保護 | ファむルシステム分離がオフの堎合 |302| 保護 | ファむルシステム分離がオフの堎合 |

301| ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |303| ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |

302| `filesystem.denyRead` ず [`credentials.files`](#protect-credentials) `deny` 読み取りブロック | 実斜されたせん。ファむルシステムレむダヌは䞡方を適甚したす |304| `filesystem.denyRead` ず [`credentials.files`](#protect-credentials) `deny` 読み取りブロック | 匷制されたせん。ファむルシステムレむダヌは䞡方を適甚したす |

303| `credentials.envVars` `deny` ず `mask` ゚ントリ | 実斜されたす。環境倉数スクラビングはファむルシステムレむダヌから独立しおいたす |305| `credentials.envVars` `deny` ず `mask` ゚ントリ | 匷制されたす。環境倉数スクラビングはファむルシステムレむダヌから独立しおいたす |

304| [`credentials.files` `mask` ゚ントリ](#mask-credential-files) マスクずしお適甚 | 実斜されたす。マスキングはファむルシステムレむダヌから独立しおいたす。[`deny` にフォヌルバック](#mask-credential-files) した゚ントリは実斜されたせん。任意の `deny` ゚ントリのようです |306| [`credentials.files` `mask` ゚ントリ](#mask-credential-files)がマスクずしお適甚 | 匷制されたす。マスキングはファむルシステムレむダヌから独立しおいたす。[`deny` にフォヌルバック](#mask-credential-files)した゚ントリは匷制されたせん。`deny` ゚ントリず同じです |

305 307 

3062 ぀の他のこずが倉わりたす。308他に 2 ぀のこずが倉わりたす。

307 309 

308* サンドボックス化されたコマンドはセッション䞀時ディレクトリではなくシェルの `$TMPDIR` を継承したす。すべおの䞀時ディレクトリは曞き蟌み可胜で、Claude Code はもはやコマンドをセッション䞀時ディレクトリにリダむレクトしないためです。310* サンドボックス化されたコマンドは、セッション䞀時ディレクトリではなく、シェルの `$TMPDIR` を継承したす。すべおの䞀時ディレクトリは曞き蟌み可胜で、Claude Code はコマンドをセッション䞀時ディレクトリにリダむレクトしなくなるためです。

309 311 

310 Linux では倉数は芪シェルでしばしば蚭定されおいないため、サンドボックス化されたコマンド内で空に展開される可胜性がありたす。Claude Code は Bash ツヌルガむダンスを通じお Claude に `$TMPDIR` に䟝存するのではなく `mktemp -d` でスクラッチディレクトリを䜜成するよう指瀺したす。312 Linux では、倉数は芪シェルでしばしば蚭定されおいたせん。Bash ツヌルのガむダンスは、`$TMPDIR` に䟝存するのではなく、`mktemp -d` でスクラッチディレクトリを䜜成するよう Claude に指瀺したす。

311* [`autoAllowBashIfSandboxed`](/docs/ja/settings-reference#sandbox-autoallowbashifsandboxed) はただデフォルトで `true` なので、サンドボックス化されたコマンドはプロンプトなしで実行され続けたす。サンドボックス化されたコマンドにプロンプトを衚瀺するには `false` に蚭定したす。313* [`autoAllowBashIfSandboxed`](/docs/ja/settings-reference#sandbox-autoallowbashifsandboxed) は匕き続きデフォルトで `true` であるため、サンドボックス化されたコマンドはプロンプトなしで実行され続けたす。プロンプトを衚瀺するには `false` に蚭定したす。

312 314 

313<h3 id="protect-credentials">315<h3 id="protect-credentials">

314 認蚌情報を保護する316 認蚌情報を保護

315</h3>317</h3>

316 318 

317`sandbox.credentials` 蚭定は、サンドボックス化されたコマンドから保護するファむルパスず環境倉数を宣蚀したす。各゚ントリはファむルパスたたは環境倉数ず `mode` を指定したす。専甚の `credentials` ブロックは、認蚌情報ルヌルをグルヌプ化し、䞀般的なファむルシステムルヌルから分離したす。Claude Code v2.1.187 以降が必芁です。319`sandbox.credentials` 蚭定は、サンドボックス化されたコマンドから保護するための認蚌情報ファむルず環境倉数を宣蚀したす。各゚ントリはファむルパスたたは環境倉数ず `mode` に名前を付けたす。専甚の `credentials` ブロックは、認蚌情報ルヌルを䞀緒にグルヌプ化し、䞀般的なファむルシステムルヌルから分離したす。

318 320 

319`"mode": "deny"` の゚ントリの堎合、ファむルパスはサンドボックス内の読み取りに察しお拒吊されたす。これは `filesystem.denyRead` が適甚するのず同じ制限であり、環境倉数は各サンドボックス化されたコマンド実行前に蚭定解陀されたす。ファむル保護はファむルシステムレむダヌの䞀郚なので、[ファむルシステム分離を無効にする](#disable-filesystem-isolation) 堎合は適甚されたせん。環境倉数保護は䟝然ずしお適甚されたす。321`"mode": "deny"` を持぀゚ントリの堎合、ファむルパスはサンドボックス内での読み取りに察しお拒吊されたす。これは `filesystem.denyRead` が適甚する制限ず同じであり、環境倉数は各サンドボックス化されたコマンドの実行前に蚭定解陀されたす。ファむル保護はファむルシステムレむダヌの䞀郚であるため、[ファむルシステム分離を無効化](#disable-filesystem-isolation)した堎合は適甚されたせん。環境倉数保護は匕き続き適甚されたす。

320 322 

321以䞋の䟋は、AWS 認蚌情報ファむルず SSH ディレクトリの読み取りをブロックし、サンドボックス化されたコマンドの環境から `GITHUB_TOKEN` ず `NPM_TOKEN` を削陀したす。323以䞋の䟋は AWS 認蚌情報ファむルず SSH ディレクトリの読み取りをブロックし、`GITHUB_TOKEN` ず `NPM_TOKEN` をサンドボックス化されたコマンドの環境から削陀したす。

322 324 

323```json theme={null}325```json theme={null}

324{326{


338}340}

339```341```

340 342 

341環境倉数゚ントリずファむル゚ントリは `"mode": "mask"` も受け入れたす。これは [認蚌情報をマスクする](#mask-credentials) の䞋で説明されおいたす。343環境倉数゚ントリずファむル゚ントリは、[認蚌情報をマスク](#mask-credentials)の䞋で説明されおいる `"mode": "mask"` も受け入れたす。

342 344 

343ファむルパスは `sandbox.filesystem.*` 蚭定ず同じ [プレフィックスルヌル](/docs/ja/settings-reference#sandbox-path-prefixes) に埓いたす。345ファむルパスは `sandbox.filesystem.*` 蚭定ず同じ[プレフィックスルヌル](/docs/ja/settings-reference#sandbox-path-prefixes)に埓いたす。

344 346 

345Claude Code はセッションが読み蟌むすべおの [蚭定スコヌプ](/docs/ja/settings#settings-precedence) から `deny` ゚ントリをマヌゞしたす。`deny` ゚ントリはアクセスを狭めるだけなので、任意のスコヌプは 1 ぀を远加できたすが、別のスコヌプが远加したものを削陀するこずはできたせん。347Claude Code はセッションが読み蟌むすべおの[蚭定スコヌプ](/docs/ja/settings#settings-precedence)から `deny` ゚ントリをマヌゞしたす。`deny` ゚ントリはアクセスを狭めるだけなので、任意のスコヌプが 1 ぀を远加できたすが、別のスコヌプが远加したものを削陀できるスコヌプはありたせん。

346 348 

347[蚭定゜ヌスを陀倖する](#configure-sandboxing) 堎合。349[蚭定゜ヌスを陀倖](#configure-sandboxing)する堎合。

348 350 

349* **プロゞェクトたたはロヌカル蚭定**: Claude Code はそれらの `credentials` ゚ントリをたったく適甚したせん。Claude Code v2.1.246 以降が必芁です。351* **プロゞェクトたたはロヌカル蚭定**: Claude Code はそれらの `credentials` ゚ントリを適甚したせん。Claude Code v2.1.246 以降が必芁です。

350* **ナヌザヌ蚭定**: Claude Code は `~/.claude/settings.json` の `deny` ゚ントリを䟝然ずしお適甚し、その [ファむル `mask` ゚ントリ](#mask-credential-files) を制限ずしお保持したすが、その [環境倉数 `mask` ゚ントリ](#mask-environment-variables) をドロップしたす。352* **ナヌザヌ蚭定**: Claude Code は `~/.claude/settings.json` の `deny` ゚ントリを匕き続き適甚し、その[ファむル `mask` ゚ントリ](#mask-credential-files)を制限ずしお保持したすが、その[環境倉数 `mask` ゚ントリ](#mask-environment-variables)を削陀したす。

351 353 

352組み蟌みの認蚌情報拒吊リストはないため、リストしたファむルず倉数のみが制限されたす。354組み蟌みの認蚌情報拒吊リストはないため、リストしたファむルず倉数のみが制限されたす。

353 355 

354`sandbox.credentials` はサンドボックス化された Bash コマンドのみに圱響したす。サンドボックス化に関係なくすべおのサブプロセスから認蚌情報を削陀するには、[`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/ja/env-vars) を蚭定したす。356`sandbox.credentials` はサンドボックス化された Bash コマンドのみに圱響したす。サンドボックスに関係なくすべおのサブプロセスから認蚌情報を削陀するには、[`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](/docs/ja/env-vars) を蚭定したす。

355 357 

356<h3 id="mask-credentials">358<h3 id="mask-credentials">

357 認蚌情報をマスクする359 認蚌情報をマスク

358</h3>360</h3>

359 361 

360マスキングは [認蚌情報を保護する](#protect-credentials) の䞋の `deny` ゚ントリよりも進みたす。認蚌情報をブロックする代わりに、Claude Code はサンドボックス化されたコマンドにプレヌスホルダヌであるセンチネルを衚瀺し、[サンドボックスプロキシ](#network-isolation) は蚱可したホストぞのアりトバりンドリク゚ストで実際の倀を亀換したす。ファむルの堎合、眮き換えは Linux ず WSL2 の動䜜です。[macOS はファむルをブロックしたす](#mask-credential-files)。362マスキングは、[認蚌情報を保護](#protect-credentials)の䞋の `deny` ゚ントリよりもさらに進みたす。認蚌情報をブロックする代わりに、Claude Code はサンドボックス化されたコマンドにプレヌスホルダヌであるセンチネルを衚瀺し、[サンドボックスプロキシ](#network-isolation)は蚱可したホストぞのアりトバりンドリク゚ストで実際の倀を亀換したす。ファむルの堎合、眮換は Linux ず WSL2 の動䜜です。[macOS はファむルをブロック](#mask-credential-files)したす。

361 363 

362<h4 id="mask-environment-variables">364<h4 id="mask-environment-variables">

363 環境倉数をマスクする365 環境倉数をマスク

364</h4>366</h4>

365 367 

366`"mode": "mask"` は認蚌情報を保護しながら、それで認蚌するツヌルが機胜し続けるようにしたす。`deny` は倉数を完党に削陀するため、`gh` や `npm` などそれを必芁ずするツヌルも壊したす。Claude Code v2.1.199 以降が必芁です。368`"mode": "mask"` は認蚌情報を保護しながら、それで認蚌するツヌルが機胜し続けるようにしたす。`deny` は倉数を完党に削陀し、これは `gh` や `npm` などの必芁なツヌルも砎壊したす。Claude Code v2.1.199 以降が必芁です。

367 369 

368`mask` を䜿甚するず、サンドボックス化されたコマンドは実際の倀の代わりにセッションごずのセンチネル倀を芋たす。各 `mask` ゚ントリは `injectHosts` をリストできたす。これはリク゚ストが蚱可されおいる実際の倀に到達するホストです。リク゚ストがそれらの 1 ぀に察しおサンドボックスを離れるずき、[サンドボックスプロキシ](#network-isolation) はセンチネルを実際の倀に眮き換えたす。コマンドずそれがログに蚘録するものは実際の認蚌情報を保持したせんが、そのリク゚ストは䟝然ずしお認蚌されたす。370`mask` を䜿甚するず、サンドボックス化されたコマンドは実際の倀の代わりにセッションごずのセンチネル倀を芋たす。各 `mask` ゚ントリは `injectHosts` をリストでき、実際の倀が到達できるホストです。リク゚ストがそれらの 1 ぀に察しおサンドボックスを離れるずき、[サンドボックスプロキシ](#network-isolation)はセンチネルを実際の倀に眮き換えたす。コマンドずそれがログに蚘録するものは実際の認蚌情報を保持したせんが、そのリク゚ストは匕き続き認蚌されたす。

369 371 

370プロキシはリク゚ストコンテンツ内の認蚌情報を眮き換えるため、それらを芋る必芁がありたす。[`network.tlsTerminate`](/docs/ja/settings-reference#sandbox-network-tlsterminate) を蚭定しお、プロキシが TLS 自䜓を終了するようにしたす。372プロキシはリク゚ストコンテンツ内の認蚌情報を眮き換えるため、それらを芋る必芁がありたす。[`network.tlsTerminate`](/docs/ja/settings-reference#sandbox-network-tlsterminate) を蚭定しお、プロキシが TLS 自䜓を終了するようにしたす。

371 373 

372それなしでは、マスキングは安党に倱敗したす。コマンドはセンチネルのみを芋たすが、センチネルは倉曎されずにサヌバヌに到達し、認蚌は倱敗したす。Claude Code はこの蚭定ミスをスタヌトアップ時に報告したす。374それなしでは、マスキングは䜕も公開せずに倱敗したす。コマンドはセンチネルのみを芋たすが、センチネルはサヌバヌに倉曎されずに到達し、認蚌は倱敗したす。Claude Code はこの蚭定ミスをスタヌトアップで報告したす。

373 375 

374眮き換えはリク゚ストコンテンツ内のヘッダヌずリク゚ストボディをカバヌしたす。認蚌情報自䜓ではなく認蚌情報から掟生した眲名で認蚌するリク゚ストは、プロキシで再眲名する必芁がありたす。[AWS リク゚ストを再眲名する](#re-sign-aws-requests) は AWS でそれがどのように機胜するかをカバヌしおいたす。376眮換はヘッダヌずリク゚ストボディをカバヌしたす。認蚌情報自䜓ではなく、認蚌情報から掟生した眲名で認蚌するリク゚ストは、プロキシで再眲名する必芁がありたす。[AWS リク゚ストに再眲名](#re-sign-aws-requests)は AWS でそれがどのように機胜するかをカバヌしたす。

375 377 

376プロキシは [ドメむン蚱可リスト](#network-isolation) が認める接続でのみ泚入するため、各 `injectHosts` 宛先も `network.allowedDomains` を通じお到達可胜である必芁がありたす。378プロキシは[ドメむン蚱可リスト](#network-isolation)が蚱可する接続にのみ泚入するため、各 `injectHosts` 宛先は `network.allowedDomains` を通じおも到達可胜である必芁がありたす。

377 379 

378以䞋の䟋は 2 ぀のトヌクンをマスクしたす。`GH_TOKEN` は `api.github.com` ぞのリク゚ストでのみ眮き換えられ、`NPM_TOKEN` は `injectHosts` を持たず、`network.allowedDomains` 内のすべおのホストぞのリク゚ストで眮き換えられたす。380以䞋の䟋は 2 ぀のトヌクンをマスクしたす。`GH_TOKEN` は `api.github.com` ぞのリク゚ストにのみ眮き換えられ、`NPM_TOKEN` は `injectHosts` を持たず、`network.allowedDomains` のすべおのホストぞのリク゚ストで眮き換えられたす。

379 381 

380```json theme={null}382```json theme={null}

381{383{


395}397}

396```398```

397 399 

398<span id="ipv6-destinations-in-injecthosts" />IPv6 宛先は 2 ぀のリストで異なるスペルを䜿甚したす。各リストは独自のマッチャヌを持぀ためです。400<span id="ipv6-destinations-in-injecthosts" />IPv6 宛先は 2 ぀のリストで異なるスペルを䜿甚しおください。各リストは独自のマッチャヌを持぀ためです。

399 401 

400* **`network.allowedDomains`**: [ドメむンリストが䜿甚する括匧圢匏](#ipv6-addresses-in-domain-lists)`"[::1]"` など。プロキシはこのリストをチェックしお接続を認めたす。402* **`network.allowedDomains`**: [ドメむンリストが䜿甚する括匧圢匏](#ipv6-addresses-in-domain-lists)`"[::1]"` など。プロキシはこのリストをチェックしお接続を蚱可したす。

401* **`injectHosts`**: 正芏の圧瞮圢匏での裞のアドレス`"::1"` たたは `"2001:db8::1"` など。プロキシは各゚ントリを接続の裞の宛先アドレスず照合し、ポヌトを無芖するため、括匧圢匏、ゟヌン ID、たたは異なる圧瞮スペルはマッチしたせん。プロキシはそこで認蚌情報を泚入したせん。403* **`injectHosts`**: 正芏の圧瞮圢匏での裞のアドレス`"::1"` たたは `"2001:db8::1"` など。プロキシは各゚ントリをコネクションの裞の宛先アドレスず照合し、ポヌトを無芖するため、括匧で囲たれた、ゟヌン ID、たたは異なる圧瞮スペルは䞀臎せず、プロキシはそこで認蚌情報を泚入したせん。

402 404 

403`claude doctor` は `injectHosts` ゚ントリに譊告 `Sandbox credential injectHosts entries can never match their destination` でフラグを立おたす。これらはそれらの宛先ず決しおマッチできたせん。このチェックには Claude Code v2.1.229 以降が必芁です。405`claude doctor` は、`injectHosts` ゚ントリが宛先ず䞀臎できないこずを譊告 `Sandbox credential injectHosts entries can never match their destination` でフラグしたす。このチェックには Claude Code v2.1.229 以降が必芁です。

404 406 

405`deny` ずは異なり、マスキングはプロキシに実際の認蚌情報をリストされたホストに送信するこずを認可するため、Claude Code はあなたたたはあなたの管理者が制埡する蚭定からのみそれを尊重したす。ナヌザヌ蚭定、管理蚭定、および `--settings` CLI フラグです。Claude Code はリポゞトリの `.claude/settings.json` たたは `.claude/settings.local.json` 内の `mask` ゚ントリを無芖したす。これらのファむルではたた `network.tlsTerminate` ず [`credentials.allowPlaintextInject`](/docs/ja/settings-reference#sandbox-credentials-allowplaintextinject) を無芖したす。これはプロキシが暗号化されおいないリク゚ストに認蚌情報を泚入するこずを蚱可する蚭定です。[ナヌザヌ蚭定を陀倖する](#configure-sandboxing) 堎合、Claude Code は `~/.claude/settings.json` の環境倉数 `mask` ゚ントリもドロップしたす。407`deny` ずは異なり、マスキングはプロキシに実際の認蚌情報をリストされたホストに送信するこずを認可するため、Claude Code はナヌザヌたたは管理者が制埡する蚭定からのみそれを尊重したす。ナヌザヌ蚭定、管理蚭定、および `--settings` CLI フラグです。Claude Code はリポゞトリの `.claude/settings.json` たたは `.claude/settings.local.json` の `mask` ゚ントリを無芖したす。これらのファむルでは、`network.tlsTerminate` ず [`credentials.allowPlaintextInject`](/docs/ja/settings-reference#sandbox-credentials-allowplaintextinject)プロキシが暗号化されおいないリク゚ストに認蚌情報を泚入できるようにする蚭定も無芖したす。[ナヌザヌ蚭定を陀倖](#configure-sandboxing)する堎合、Claude Code は `~/.claude/settings.json` の環境倉数 `mask` ゚ントリも削陀したす。

406 408 

407あなたの管理者がサヌバヌ管理蚭定を通じお `mask` ゚ントリ、`network.tlsTerminate`、たたは `credentials.allowPlaintextInject` を配信する堎合、それらは [承認が必芁な蚭定](/docs/ja/server-managed-settings#security-approval-dialogs) ずしお数えられたす。409管理者が `mask` ゚ントリ、`network.tlsTerminate`、たたは `credentials.allowPlaintextInject` をサヌバヌ管理蚭定を通じお配信する堎合、それらは[承認が必芁な蚭定](/docs/ja/server-managed-settings#security-approval-dialogs)ずしおカりントされたす。

408 410 

409同じ倉数が任意のスコヌプで `deny` でリストされおいる堎合、`deny` が優先されたす。411同じ倉数が任意のスコヌプで `deny` でリストされおいる堎合、`deny` が優先されたす。

410 412 

411マスキングはデフォルトで倉数の党䜓倀を眮き換えたす。これは裞のトヌクンに適しおいたす。オプションの゚ントリフィヌルドClaude Code v2.1.224 以降が必芁は構造を持぀倀を凊理したす。413マスキングはデフォルトで倉数の党䜓倀を眮き換えたす。これは裞のトヌクンに適しおいたす。オプションの゚ントリフィヌルドClaude Code v2.1.224 以降が必芁は、構造を持぀倀を凊理したす。

412 414 

413* `extract`: Claude Code が倀党䜓に適甚する正芏衚珟。各マッチのグルヌプ 1 でキャプチャされたテキストのみを眮き換えるため、`DATABASE_URL` 接続文字列などの倀を解析するツヌルはサンドボックス内で䟝然ずしお機胜したす。パタヌンは少なくずも 1 ぀のキャプチャグルヌプを含む必芁がありたす。415* `extract`: Claude Code が倀党䜓に適甚する正芏衚珟。各マッチの 1 グルヌプでキャプチャされたテキストのみを眮き換えるため、倀を解析するツヌル`DATABASE_URL` 接続文字列などはサンドボックス内で匕き続き機胜したす。パタヌンは少なくずも 1 ぀のキャプチャグルヌプを含む必芁がありたす。

414* `onExtractNoMatch` はパタヌンが䜕もマッチしない堎合に䜕が起こるかを制埡したす。416* `onExtractNoMatch` はパタヌンが䜕もマッチしない堎合に䜕が起こるかを制埡したす。

415 * `warn`デフォルトは譊告を出し、倉数を未マスク状態で枡したす417 * `warn`デフォルトは譊告を発し、倉数を未マスク状態で枡したす

416 * `deny` はサンドボックス内で倉数を蚭定解陀したす418 * `deny` はサンドボックス内で倉数を蚭定解陀したす

417 * `error` は蚭定を修正するたでサンドボックスセットアップを停止したす419 * `error` は蚭定を修正するたでサンドボックスセットアップを停止したす

418* `decode: "jwt"`JSON Web TokenJWTを保持する倉数の堎合。Claude Code は倀が JWT であるこずを怜蚌し、それを構造的に有効な停のトヌクンで眮き換えるため、サンドボックス内でトヌクンをデコヌドするコヌドは機胜し続けたす。`maskClaims` を远加しお、トヌクン党䜓を眮き換える代わりに個別にマスクするトップレベルペむロヌドクレヌムをリストしたす。他のクレヌムは読み取り可胜なたたです。倀が JWT ずしお怜蚌されない堎合、たたはリストされたクレヌムがマッチしない堎合、Claude Code は譊告を出しお倉数を未マスク状態で枡したす。`decode` は `extract` ず組み合わせるこずはできたせん。420* `decode: "jwt"`: JSON Web TokenJWTを保持する倉数の堎合。Claude Code は倀が JWT であるこずを怜蚌し、それを構造的に有効な停のトヌクンに眮き換えるため、サンドボックス内のトヌクンをデコヌドするコヌドは機胜し続けたす。`maskClaims` を远加しお、トヌクン党䜓を眮き換える代わりに個別にマスクするトップレベルペむロヌドクレヌムをリストしたす。他のクレヌムは読み取り可胜なたたです。倀が JWT ずしお怜蚌されない堎合、たたはリストされたクレヌムが䞀臎しない堎合、Claude Code は譊告を䌎っお倉数を未マスク状態で枡したす。`decode` は `extract` ず組み合わせるこずはできたせん。

419 421 

420蚭定リファレンスの [`credentials.envVars[]` 行](/docs/ja/settings-reference#sandbox-settings) を参照しお、完党なフィヌルドリストを確認しおください。422蚭定リファレンスの [`credentials.envVars[]` 行](/docs/ja/settings-reference#sandbox-settings)で完党なフィヌルドリストを参照しおください。

421 423 

422<h4 id="re-sign-aws-requests">424<h4 id="re-sign-aws-requests">

423 AWS リク゚ストを再眲名する425 AWS リク゚ストに再眲名

424</h4>426</h4>

425 427 

426AWS リク゚ストはリク゚ストコンテンツ䞊に SigV4 眲名を持぀ため、`AWS_ACCESS_KEY_ID` ず `AWS_SECRET_ACCESS_KEY` を䞀緒にマスクしたす。プロキシはアクセスキヌのセンチネルで SigV4 リク゚ストを怜出し、実際の倀を眮き換えた埌にそれを再眲名したす。シヌクレットのみをマスクするずリク゚ストはプレヌスホルダヌで眲名されたたたになり、プロキシはそれを怜出できないため、AWS で倱敗したす。Claude Code はこのケヌスをスタヌトアップ時に譊告したすが、アクセスキヌ ID のみがマスクされおいる堎合は譊告したせん。プロキシが再眲名できない怜出されたリク゚スト`x-amz-date` ヘッダヌが欠萜しおいるなどは、壊れた眲名でサヌバヌに到達する代わりにプロキシ゚ラヌで倱敗したす。428AWS リク゚ストはリク゚ストコンテンツ䞊に SigV4 眲名を持぀ため、`AWS_ACCESS_KEY_ID` ず `AWS_SECRET_ACCESS_KEY` を䞀緒にマスクしたす。プロキシはアクセスキヌのセンチネルで SigV4 リク゚ストを怜出し、実際の倀を眮き換えた埌に再眲名したす。シヌクレットのみをマスクするず、プレヌスホルダヌで眲名されたリク゚ストが残り、プロキシが怜出できないため、AWS で倱敗したす。Claude Code はこのケヌスをスタヌトアップで譊告したすが、アクセスキヌ ID のみがマスクされおいる堎合は譊告したせん。プロキシが再眲名できない怜出されたリク゚スト`x-amz-date` ヘッダヌが欠萜しおいるなどは、壊れた眲名でサヌバヌに到達する代わりに、プロキシ゚ラヌで倱敗したす。

427 429 

428Claude Code は、党䜓倀をマスクする堎合、埓来の `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、および `AWS_SESSION_TOKEN` 倉数を 1 ぀の認蚌情報に自動的にリンクしたす。AWS 認蚌情報が他の名前の倉数に存圚する堎合、[`credentials.awsPairs`](/docs/ja/settings-reference#sandbox-credentials-awspairs) で自分でグルヌプ化したす。これには Claude Code v2.1.224 以降が必芁です。この䟋は、既に `MY_KEY_ID`、`MY_SECRET_KEY`、および `MY_SESSION_TOKEN` を党䜓倀ずしおマスクする蚭定䞊蚘の [マスキング蚭定](#mask-environment-variables) のようににペアリングを远加したす。430Claude Code は、党䜓倀をマスクする堎合、埓来の `AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、および `AWS_SESSION_TOKEN` 倉数を 1 ぀の認蚌情報に自動的にリンクしたす。AWS 認蚌情報が他の名前の倉数に存圚する堎合、[`credentials.awsPairs`](/docs/ja/settings-reference#sandbox-credentials-awspairs) で自分でグルヌプ化したす。これには Claude Code v2.1.224 以降が必芁です。この䟋は、既に `MY_KEY_ID`、`MY_SECRET_KEY`、および `MY_SESSION_TOKEN` を党䜓倀ずしおマスクする蚭定にペアリングを远加したす。䞊蚘の[マスキング蚭定](#mask-environment-variables)のように。

429 431 

430```json theme={null}432```json theme={null}

431{433{


445 447 

446各゚ントリは以䞋のルヌルに埓いたす。448各゚ントリは以䞋のルヌルに埓いたす。

447 449 

448* `accessKeyIdVar` ず `secretAccessKeyVar` はアクセスキヌ ID ずシヌクレットキヌを保持するマスク `envVars` ゚ントリを指定したす。オプションの `sessionTokenVar` は䞀時認蚌情報のセッショントヌクンを保持する゚ントリを指定したす。蚭定されおいる堎合、プロキシは再眲名されたリク゚ストで `x-amz-security-token` ずしお実際のトヌクンを送信したす。450* `accessKeyIdVar` ず `secretAccessKeyVar` はアクセスキヌ ID ずシヌクレットキヌを保持するマスク枈み `envVars` ゚ントリに名前を付けたす。オプションの `sessionTokenVar` は䞀時認蚌情報のセッショントヌクンを保持する゚ントリに名前を付けたす。蚭定されおいる堎合、プロキシは再眲名されたリク゚ストで実際のトヌクンを `x-amz-security-token` ずしお送信したす。

449* 指定された各倉数は、`extract` たたは `decode` なしで党䜓倀をマスクする `mask` ゚ントリである必芁がありたす。451* 名前付きの各倉数は、`extract` たたは `decode` なしで党䜓倀をマスクする `mask` ゚ントリである必芁がありたす。

450* プロキシは `injectHosts` にリストされたホストでリク゚ストを再眲名したす。452* プロキシはアクセスキヌ ID ゚ントリの `injectHosts` にリストされたホストでリク゚ストに再眲名したす。

451* ペアで埓来の倉数を指定するず、自動ペアリングが眮き換えられたす。453* ペアで埓来の倉数のいずれかに名前を付けるず、自動ペアリングが眮き換えられたす。

452 454 

453`mask` ゚ントリのように、`awsPairs` はナヌザヌ蚭定、管理蚭定、および `--settings` CLI フラグからのみ尊重されたす。455`mask` ゚ントリず同様に、`awsPairs` はナヌザヌ蚭定、管理蚭定、および `--settings` CLI フラグからのみ尊重されたす。

454 456 

4553 ぀の AWS リク゚スト圢匏はプロキシが再蚈算できない眲名を持ちたす。そのようなリク゚ストがマスク枈みペアのプレヌスホルダヌで眲名されおいる堎合、プロキシは壊れた眲名を転送する代わりにそれを倱敗させたす。未マスク認蚌情報で眲名されたリク゚ストは圱響を受けたせん。[`credentials.sigv4`](/docs/ja/settings-reference#sandbox-credentials-sigv4) 蚭定Claude Code v2.1.224 以降が必芁は圢匏ごずにこれを緩和したす。圢匏のキヌを `passthrough` に蚭定するず、プロキシはプレヌスホルダヌ掟生眲名でリク゚ストを転送するため、呌び出しツヌルはプロキシ゚ラヌの代わりに AWS 独自の拒吊応答を受け取りたす。`awsPairs` のように、`sigv4` はナヌザヌ蚭定、管理蚭定、および `--settings` CLI フラグからのみ尊重されたす。4573 ぀の AWS リク゚スト圢匏は、プロキシが再蚈算できない眲名を持ちたす。そのようなリク゚ストがマスク枈みペアのプレヌスホルダヌで眲名されおいる堎合、プロキシは壊れた眲名を転送するのではなく倱敗したす。未マスク認蚌情報で眲名されたリク゚ストは圱響を受けたせん。[`credentials.sigv4`](/docs/ja/settings-reference#sandbox-credentials-sigv4) 蚭定Claude Code v2.1.224 以降が必芁は、フォヌムごずにこれを緩和したす。フォヌムのキヌを `passthrough` に蚭定するず、リク゚ストはプレヌスホルダヌ掟生眲名で転送されるため、呌び出しツヌルは AWS 独自の拒吊応答を受け取る代わりにプロキシ゚ラヌを受け取りたす。`awsPairs` ず同様に、`sigv4` はナヌザヌ蚭定、管理蚭定、および `--settings` CLI フラグからのみ尊重されたす。

456 458 

457| リク゚スト圢匏 | `sigv4` キヌ | プロキシが再眲名できない理由 |459| リク゚スト圢匏 | `sigv4` キヌ | プロキシが再眲名できない理由 |

458| :------------------------ | :---------- | :----------------------------------------- |460| :------------------------ | :---------- | :----------------------------------------- |

459| aws-chunked ストリヌミングアップロヌド | `streaming` | チャックごずの眲名はシヌド眲名から連鎖するため、再眲名にはボディの曞き盎しが必芁です |461| aws-chunked ストリヌミングアップロヌド | `streaming` | チャックごずの眲名はシヌド眲名から連鎖するため、再眲名にはボディの曞き盎しが必芁です |

460| 眲名枈み URL | `presigned` | 眲名は URL 自䜓に存圚し、`Authorization` ヘッダヌがありたせん |462| 眲名枈み URL | `presigned` | 眲名は URL 自䜓に存圚し、`Authorization` ヘッダヌはありたせん |

461| SigV4A 非察称眲名 | `sigv4a` | 再蚈算する共有キヌ HMAC がありたせん |463| SigV4A 非察称眲名 | `sigv4a` | 再蚈算する共有キヌ HMAC がありたせん |

462 464 

463<h4 id="mask-credential-files">465<h4 id="mask-credential-files">

464 認蚌情報ファむルをマスクする466 認蚌情報ファむルをマスク

465</h4>467</h4>

466 468 

467ファむル゚ントリは `"mode": "mask"` も受け入れたす。これには Claude Code v2.1.221 以降が必芁です。サンドボックス化されたコマンドが芋るものはプラットフォヌムに䟝存したす。469ファむル゚ントリも `"mode": "mask"` を受け入れたす。これには Claude Code v2.1.221 以降が必芁です。サンドボックス化されたコマンドが芋るものはプラットフォヌムに䟝存したす。

468 470 

469* **Linux ず WSL2**サンドボックス化されたコマンドはファむルのセンチネルコピヌを読み取りたす。これはシヌクレットがプレヌスホルダヌ倀で眮き換えられたスタンドむンであり、[サンドボックスプロキシ](#network-isolation) は出力時に実際の倀を眮き換えたす。471* **Linux ず WSL2**: サンドボックス化されたコマンドはファむルのセンチネルコピヌを読み取りたす。シヌクレットがプレヌスホルダヌ倀に眮き換えられたスタンドむン。[サンドボックスプロキシ](#network-isolation)は出力時に実際の倀を眮き換えたす。

470* **macOS**サンドボックス化されたコマンドはリストされたファむルを読み取るこずができたせん。Claude Code はセンチネルコピヌを構築せず、出力時に䜕も眮き換えないため、ファむルで認蚌するツヌルはサンドボックス内で機胜したせん。これは `deny` ず同じ効果です。`deny` ゚ントリずは異なり、[ファむルシステム分離を無効にする](#disable-filesystem-isolation) 堎合でも読み取りブロックは保持されたす。472* **macOS**: サンドボックス化されたコマンドはリストされたファむルを読み取るこずができたせん。Claude Code はセンチネルコピヌを構築せず、出力時に䜕も眮き換えないため、ファむルで認蚌するツヌルはサンドボックス内で機胜したせん。`deny` ず同じ効果です。`deny` ゚ントリずは異なり、[ファむルシステム分離を無効化](#disable-filesystem-isolation)した堎合でも読み取りブロックは保持されたす。

471 473 

472すべおのプラットフォヌムで、Claude Code は [`network.tlsTerminate`](/docs/ja/settings-reference#sandbox-network-tlsterminate) 芁件ず `injectHosts` を [マスク枈み環境倉数](#mask-environment-variables) ず同じ方法で適甚し、リポゞトリ蚭定を同じ方法で無芖したす。[ナヌザヌ蚭定を陀倖する](#configure-sandboxing) 堎合、Claude Code は `~/.claude/settings.json` のファむル `mask` ゚ントリを制限ずしお保持したすが、゚ントリはもはやプロキシに実際の倀を眮き換えるこずを認可したせん。474すべおのプラットフォヌムで、Claude Code は [`network.tlsTerminate`](/docs/ja/settings-reference#sandbox-network-tlsterminate) 芁件ず `injectHosts` を[マスク枈み環境倉数](#mask-environment-variables)ず同じ方法で適甚し、リポゞトリ蚭定を同じ方法で無芖したす。[ナヌザヌ蚭定を陀倖](#configure-sandboxing)する堎合、Claude Code は `~/.claude/settings.json` のファむル `mask` ゚ントリを制限ずしお保持したすが、゚ントリはプロキシが実際の倀を眮き換えるこずをもはや認可したせん。

473 475 

474以䞋の䟋は `~/.config/gh/hosts.yml` に保存された GitHub トヌクンをマスクしたす。以䞋で説明する `extract` パタヌンは、Claude Code にファむルのどの郚分がシヌクレットであるかを指瀺したす。Linux ず WSL2 では、ファむルを読み取るサンドボックス化されたコマンドはトヌクンの代わりにセンチネルを取埗し、プロキシは `api.github.com` ぞのリク゚ストで実際のトヌクンを眮き換えたす。476以䞋の䟋は `~/.config/gh/hosts.yml` に保存された GitHub トヌクンをマスクしたす。以䞋で説明される `extract` パタヌンは、Claude Code にファむルのどの郚分がシヌクレットであるかを䌝えたす。Linux ず WSL2 では、ファむルを読み取るサンドボックス化されたコマンドはトヌクンの代わりにセンチネルを取埗し、プロキシは `api.github.com` ぞのリク゚ストで実際のトヌクンを眮き換えたす。

475 477 

476```json theme={null}478```json theme={null}

477{479{


495}497}

496```498```

497 499 

498マスクがアクティブであるこずを確認するには、Claude に `cat ~/.config/gh/hosts.yml` をサンドボックス化されたコマンドで実行するよう䟝頌したす。Linux ず WSL2 では出力はトヌクンの代わりにセンチネル倀を衚瀺し、macOS では読み取りが倱敗したす。500マスクがアクティブであるこずを確認するには、Claude にサンドボックス化されたコマンドで `cat ~/.config/gh/hosts.yml` を実行するよう䟝頌したす。Linux ず WSL2 では出力はトヌクンの代わりにセンチネル倀を衚瀺し、macOS では読み取りが倱敗したす。

499 501 

500Linux ず WSL2 では、`extract` パタヌンは `hosts.yml` の残りを読み取り可胜に保぀ものです。Claude Code は正芏衚珟を党䜓ファむルに適甚し、各マッチのグルヌプ 1 でキャプチャされたテキストのみを眮き換えるため、`gh` は䟝然ずしおその蚭定を解析し、トヌクンのみがプレヌスホルダヌです。`.netrc`、JSON、YAML などのツヌルが解析する構造化ファむルに `extract` を䜿甚したす。パタヌンは少なくずも 1 ぀のキャプチャグルヌプを含む必芁がありたす。`extract` なしでは、Claude Code はファむル党䜓のコンテンツを 1 ぀のセンチネル倀で眮き換えたす。これは単䞀の裞のシヌクレットず䜕も保持しないファむルに適しおいたす。502Linux ず WSL2 では、`extract` パタヌンは `hosts.yml` の残りを読み取り可胜に保぀ものです。Claude Code は正芏衚珟を党䜓ファむルに適甚し、各マッチの 1 グルヌプでキャプチャされたテキストのみを眮き換えるため、`gh` は匕き続き蚭定を解析し、トヌクンのみがプレヌスホルダヌです。`extract` を `.netrc`、JSON、YAML などのツヌルが解析する構造化ファむルに䜿甚したす。パタヌンは少なくずも 1 ぀のキャプチャグルヌプを含む必芁がありたす。`extract` なしでは、Claude Code はファむル党䜓のコンテンツを 1 ぀のセンチネル倀に眮き換えたす。これは、単䞀の裞のシヌクレットを保持し、他に䜕もないファむルに適しおいたす。

501 503 

502JWT を保持するファむルの堎合、`extract` の代わりに、たたは䞀緒に `decode: "jwt"` を蚭定したす。`decode` には Claude Code v2.1.224 以降が必芁です。Claude Code は組み蟌みパタヌンで JWT 候補を芋぀けるか、蚭定されおいる堎合は `extract` パタヌンで芋぀け、各候補が JWT であるこずを怜蚌し、それを構造的に有効な停のトヌクンで眮き換えるため、サンドボックス内でトヌクンをデコヌドするコヌドは機胜し続けたす。`maskClaims` を远加しお、トヌクン党䜓を眮き換える代わりに、各怜蚌枈みトヌクン内の指定されたトップレベルペむロヌドクレヌムのみをマスクし、他のクレヌムは読み取り可胜なたたにしたす。候補が怜蚌されない堎合、たたはリストされたクレヌムがマッチしない堎合、以䞋の `onExtractNoMatch` フィヌルドが結果を支配したす。これはパタヌンが䜕もマッチしない堎合ず同じです。504JWT を保持するファむルの堎合、`extract` の代わりに、たたは䞀緒に `decode: "jwt"` を蚭定したす。`decode` には Claude Code v2.1.224 以降が必芁です。Claude Code は組み蟌みパタヌンで JWT 候補を芋぀けるか、蚭定されおいる堎合は `extract` パタヌンで芋぀け、各候補が JWT であるこずを怜蚌し、それを構造的に有効な停のトヌクンに眮き換えるため、サンドボックス内でトヌクンをデコヌドするコヌドは機胜し続けたす。`maskClaims` を远加しお、トヌクン党䜓を眮き換える代わりに、各怜蚌枈みトヌクン内の名前付きトップレベルペむロヌドクレヌムのみをマスクし、他のクレヌムは読み取り可胜なたたにしたす。候補が怜蚌されない堎合、たたはリストされたクレヌムが䞀臎しない堎合、以䞋の `onExtractNoMatch` フィヌルドが結果を管理したす。これは、パタヌンが䜕もマッチしない堎合ず同じです。

503 505 

5042 ぀のオプションフィヌルドはマッチング動䜜を改善したす。䞡方は `mode` が `mask` で `extract` たたは `decode` が蚭定されおいる堎合にのみ適甚されたす。macOS では、ファむルシステム分離がオンの堎合、Claude Code は `mask` ゚ントリを `deny` ずしお適甚しおからパタヌンが実行されるため、これらのフィヌルドず以䞋の䞍䞀臎結果は、[ファむルシステム分離がオフ](#disable-filesystem-isolation) の堎合にのみそこで有効になりたす。5062 ぀のオプションフィヌルドはマッチング動䜜を改善したす。䞡方は `mode` が `mask` で `extract` たたは `decode` が蚭定されおいる堎合にのみ適甚されたす。macOS では、ファむルシステム分離がオンの堎合、Claude Code は `mask` ゚ントリを `deny` ずしお適甚したす。パタヌンが実行される前です。これらのフィヌルドず以䞋の䞍䞀臎の結果は、[ファむルシステム分離を無効化](#disable-filesystem-isolation)した堎合にのみ macOS で有効になりたす。

505 507 

506* `onExtractNoMatch` はマッチングがファむル内でマスクするものを芋぀けない堎合に䜕が起こるかを制埡したす。508* `onExtractNoMatch` はマッチングがファむル内でマスクするものを芋぀けない堎合に䜕が起こるかを制埡したす。

507 509 

508 * `warn`デフォルトは譊告を出し、゚ントリをスキップするため、サンドボックス化されたコマンドは実際のファむルを未マスク状態で読み取るこずができたす。デフォルトは認蚌情報が合法的に存圚しない可胜性がある堎合に適しおいたす。シヌクレットが存圚する可胜性があるがパタヌンが芋萜ずす可胜性がある堎合は、`deny` を䜿甚したす510 * `warn`デフォルトは譊告を発し、゚ントリをスキップするため、サンドボックス化されたコマンドは実際のファむルを未マスク状態で読み取るこずができたす。デフォルトは認蚌情報が合法的に存圚しない可胜性があるケヌスに適しおいたす。シヌクレットが存圚する可胜性があるがパタヌンが芋萜ずす可胜性がある堎合は、`deny` を䜿甚したす

509 * `deny` はファむルを読み取り䞍可にしたす511 * `deny` はファむルを読み取り䞍可にしたす

510 * `error` は蚭定を修正するたでサンドボックスセットアップを停止したす512 * `error` は蚭定を修正するたでサンドボックスセットアップを停止したす

511 513 

512 Claude Code は、読み取りブロックが実斜されない堎合は垞に `deny` を `error` ずしお扱いたす。[ファむルシステム分離を無効にする](#disable-filesystem-isolation) 堎合、および任意の蚭定゜ヌスからの `filesystem.allowRead` ゚ントリがファむルのパスを再床開く堎合です。514 Claude Code は、読み取りブロックが匷制されない堎合は垞に `deny` を `error` ずしお扱いたす。[ファむルシステム分離を無効化](#disable-filesystem-isolation)した堎合、および任意の蚭定゜ヌスからの `filesystem.allowRead` ゚ントリがファむルのパスを再床開く堎合です。

513* `maskDuplicates` はたた、マスク枈み認蚌情報倀の逐語的コピヌを眮き換えたす。これは `extract` キャプチャたたは `decode` 怜蚌枈みトヌクンであり、マッチした範囲倖で芋぀かりたす。短いたたは䞀般的な倀は出珟するすべおの堎所で眮き換えられるため、長く高゚ントロピヌのシヌクレット甚に予玄したす。デフォルトfalse。515* `maskDuplicates` は、マッチした各マスク枈み認蚌情報倀`extract` キャプチャたたは `decode` 怜蚌枈みトヌクンの逐語的コピヌも眮き換えたす。マッチした範囲倖で芋぀かった堎合、シヌクレットが繰り返される堎所です。生の郚分文字列ず照合するため、短いたたは䞀般的な倀はどこでも眮き換えられたす。長く、高゚ントロピヌのシヌクレット甚に予玄したす。デフォルト: false。

514 516 

515`mask` は単䞀のファむルに適甚されるため、各認蚌情報ファむルを個別にリストしたす。Claude Code は、安党にマスクできない `mask` ゚ントリ、぀たりディレクトリパス、グロブパタヌン、8 MiB より倧きいファむル、たたは UTF-8 テキストではないファむルに぀いおは `deny` にフォヌルバックしたす。ディレクトリは代わりに明瀺的な `deny` ゚ントリずしお蚘述しおください。[どの蚭定がそれを無効にできるか](#which-settings-can-disable-it) の䞋の衚は、各圢匏が `filesystem.disabled` をピンするかどうかず、ファむルシステム分離がオフの堎合にどのように動䜜するかをカバヌしおいたす。517`mask` は単䞀のファむルに適甚されるため、各認蚌情報ファむルを個別にリストしたす。Claude Code は `mask` ゚ントリが安党にマスクできない堎合にフォヌルバックしお `deny` したす。ディレクトリパス、グロブパタヌン、8 MiB より倧きいファむル、たたは UTF-8 テキストではないファむル。代わりにディレクトリを明瀺的な `deny` ゚ントリずしお蚘述したす。[どの蚭定がそれを無効化できるか](#which-settings-can-disable-it)の䞋の衚は、各フォヌムが `filesystem.disabled` をピンするかどうか、およびファむルシステム分離がオフの堎合の動䜜をカバヌしたす。

516 518 

517<h2 id="how-sandboxing-works">519<h2 id="how-sandboxing-works">

518 サンドボックス化の仕組み520 サンドボックス化の仕組み


540 542 

541* **䜜業ディレクトリおよびその䞊のディレクトリ内**`.claude` 蚭定ファむル、`.claude/skills`、`.claude/agents`、`.claude/commands`、`.claude/hooks` ディレクトリ、`.mcp.json`、および Claude Code が独自に実行するファむル`.claude/workflows` や `.claude/scheduled_tasks.json` など543* **䜜業ディレクトリおよびその䞊のディレクトリ内**`.claude` 蚭定ファむル、`.claude/skills`、`.claude/agents`、`.claude/commands`、`.claude/hooks` ディレクトリ、`.mcp.json`、および Claude Code が独自に実行するファむル`.claude/workflows` や `.claude/scheduled_tasks.json` など

542* **䜜業ディレクトリのみ**`.bashrc` や `.zshrc` などのシェルスタヌトアップファむル、`.gitconfig`、`.vscode` および `.idea` ディレクトリ、`.git` 内の `hooks` および `config`544* **䜜業ディレクトリのみ**`.bashrc` や `.zshrc` などのシェルスタヌトアップファむル、`.gitconfig`、`.vscode` および `.idea` ディレクトリ、`.git` 内の `hooks` および `config`

543* **䜜業ディレクトリをベア git リポゞトリに倉えるファむル**トップレベルの `HEAD`、`objects`、`refs`、加えお `config` ず `hooks`既に存圚する堎合。`config` ディレクトリがプロゞェクトに属する堎合でも git に属する堎合でも同様です。Linux および WSL2 では、サンドボックス化されたコマンドの実行䞭に衚瀺されるトップレベルの `HEAD` ファむルたたは `objects` たたは `refs` ディレクトリをサンドボックスが削陀したす。545* **䜜業ディレクトリをベア git リポゞトリに倉えるファむル**トップレベルの `HEAD`、`objects`、`refs`、加えお `config` ず `hooks``HEAD` が隣に存圚する堎合。Linux および WSL2 では、サンドボックス化されたコマンドの実行䞭に衚瀺されるトップレベルの `HEAD` ファむルたたは `objects` たたは `refs` ディレクトリをサンドボックスが削陀したす。

544* **`~/.claude` たたは `CLAUDE_CONFIG_DIR` が指すディレクトリ内**そのほずんどのコンテンツ、加えお `~/.claude.json` および `.credentials.json` 認蚌情報ストア546* **`~/.claude` たたは `CLAUDE_CONFIG_DIR` が指すディレクトリ内**そのほずんどのコンテンツ、加えお `~/.claude.json` および `.credentials.json` 認蚌情報ストア

545 547 

546セッション䞭に保護された蚭定ファむルのパスにシンボリックリンクが衚瀺される堎合、サンドボックスは次のコマンドから、それが指すファむルぞの曞き蟌みも拒吊したす。548セッション䞭に保護された蚭定ファむルのパスにシンボリックリンクが衚瀺される堎合、サンドボックスは次のコマンドから、それが指すファむルぞの曞き蟌みも拒吊したす。


555 557 

556ネットワヌクアクセスはサンドボックス倖で実行されるプロキシサヌバヌを通じお制埡されたす。558ネットワヌクアクセスはサンドボックス倖で実行されるプロキシサヌバヌを通じお制埡されたす。

557 559 

558* **ドメむン制限**Claude Code はデフォルトでドメむンを事前に蚱可したせん。コマンドが新しいドメむンにアクセスする必芁がある堎合、Claude Code はプロンプトを衚瀺するか、[オヌトモヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)で分類噚にリク゚ストを送信したす。プロンプトで「はい」を遞択するず、Claude Code は珟圚のセッションの残りの期間そのホストを蚱可し、同じホストぞの埌続の接続ではプロンプトを衚瀺したせん。「はい、今埌は聞かない」を遞択するず、Claude Code は `WebFetch(domain:...)` 蚱可ルヌルを[ロヌカル蚭定](/docs/ja/permissions#permission-system)に保存するため、そのホストは今埌のセッションで蚱可されたたたになりたす。[`allowedDomains`](/docs/ja/settings-reference#sandbox-network-alloweddomains) でドメむンを事前に蚱可しおプロンプトを完党に回避したす。Claude Code は、[Permission rules](#permission-rules) で説明されおいるように、`WebFetch(domain:...)` 蚱可ルヌルからのドメむンも事前に蚱可したす。560* **ドメむン制限**Claude Code はデフォルトでドメむンを事前に蚱可したせん。コマンドが新しいドメむンにアクセスする必芁がある堎合、Claude Code はプロンプトを衚瀺したす。[オヌトモヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)では、Claude は[Per-command allowed domains](#per-command-allowed-domains-in-auto-mode)に埓っお、コマンド自䜓でコマンドが必芁ずするホストを指定したす。プロンプトで「はい」を遞択するず、Claude Code は珟圚のセッションの残りの期間そのホストを蚱可し、同じホストぞの埌続の接続ではプロンプトを衚瀺したせん。「はい、今埌は聞かない」を遞択するず、Claude Code は `WebFetch(domain:...)` 蚱可ルヌルを[ロヌカル蚭定](/docs/ja/permissions#permission-system)に保存するため、そのホストは今埌のセッションで蚱可されたたたになりたす。

561* **事前蚱可ドメむン**[`allowedDomains`](/docs/ja/settings-reference#sandbox-network-alloweddomains) でドメむンを事前に蚱可しおプロンプトを完党に回避したす。Claude Code は、[Permission rules](#permission-rules) で説明されおいるように、`WebFetch(domain:...)` 蚱可ルヌルからのドメむンも事前に蚱可したす。

559* **厳密な蚱可リスト**ナヌザヌ、管理、たたは CLI `--settings` 蚭定で [`strictAllowlist`](/docs/ja/settings-reference#sandbox-network-strictallowlist) を `true` に蚭定した堎合、Claude Code はプロンプトの代わりに、蚱可リスト倖のホストぞのサンドボックス化されたコマンドアクセスを拒吊したす。蚱可リストは、サンドボックスが他の方法でプロンプトを衚瀺するのず同じものです。`allowedDomains` に加えお `WebFetch(domain:...)` 蚱可ルヌルからのドメむン、たたは `allowManagedDomainsOnly` が蚭定されおいる堎合は管理蚭定゚ントリのみです。Claude Code はサンドボックス化されたコマンドのみにこれを実斜したす。`WebFetch` などのむンプロセスツヌルは匕き続き[暩限ルヌル](#permission-rules)に埓いたす。リポゞトリの `.claude/settings.json` たたは `.claude/settings.local.json` で蚭定しおも効果はありたせん。Claude Code v2.1.219 以降が必芁です。562* **厳密な蚱可リスト**ナヌザヌ、管理、たたは CLI `--settings` 蚭定で [`strictAllowlist`](/docs/ja/settings-reference#sandbox-network-strictallowlist) を `true` に蚭定した堎合、Claude Code はプロンプトの代わりに、蚱可リスト倖のホストぞのサンドボックス化されたコマンドアクセスを拒吊したす。蚱可リストは、サンドボックスが他の方法でプロンプトを衚瀺するのず同じものです。`allowedDomains` に加えお `WebFetch(domain:...)` 蚱可ルヌルからのドメむン、たたは `allowManagedDomainsOnly` が蚭定されおいる堎合は管理蚭定゚ントリのみです。Claude Code はサンドボックス化されたコマンドのみにこれを実斜したす。`WebFetch` などのむンプロセスツヌルは匕き続き[暩限ルヌル](#permission-rules)に埓いたす。リポゞトリの `.claude/settings.json` たたは `.claude/settings.local.json` で蚭定しおも効果はありたせん。Claude Code v2.1.219 以降が必芁です。

560* **管理ロックダりン**[`allowManagedDomainsOnly`](/docs/ja/settings-reference#sandbox-network-allowmanageddomainsonly) が管理蚭定で蚭定されおいる堎合、蚱可されおいないドメむンはプロンプトの代わりに自動的にブロックされ、管理蚭定からの `allowedDomains` および `WebFetch(domain:...)` 蚱可ルヌルのみが尊重されたす。563* **管理ロックダりン**[`allowManagedDomainsOnly`](/docs/ja/settings-reference#sandbox-network-allowmanageddomainsonly) が管理蚭定で蚭定されおいる堎合、蚱可されおいないドメむンはプロンプトの代わりに自動的にブロックされ、管理蚭定からの `allowedDomains` および `WebFetch(domain:...)` 蚱可ルヌルのみが尊重されたす。

561* **䌁業プロキシ**ネットワヌクが発信トラフィックを䌁業プロキシを通じお送信する必芁がある堎合、[プロキシ蚭定](/docs/ja/network-config#proxy-configuration)で説明されおいるように、`HTTPS_PROXY`、`HTTP_PROXY`、`NO_PROXY` を蚭定の `env` ブロックで蚭定しお、[バックグラりンド゚ヌゞェント](/docs/ja/network-config#set-network-variables-in-settings-not-the-shell)もそれらを取埗するようにするか、Claude Code を起動する環境で蚭定したす。Claude Code はドメむン蚱可リストを実斜しおから、蚱可されたコネクションをそのアップストリヌムプロキシを通じおトンネルしたす。564* **䌁業プロキシ**ネットワヌクが発信トラフィックを䌁業プロキシを通じお送信する必芁がある堎合、[プロキシ蚭定](/docs/ja/network-config#proxy-configuration)で説明されおいるように、`HTTPS_PROXY`、`HTTP_PROXY`、`NO_PROXY` を蚭定の `env` ブロックで蚭定しお、[バックグラりンド゚ヌゞェント](/docs/ja/network-config#set-network-variables-in-settings-not-the-shell)もそれらを取埗するようにするか、Claude Code を起動する環境で蚭定したす。Claude Code はドメむン蚱可リストを実斜しおから、蚱可されたコネクションをそのアップストリヌムプロキシを通じおトンネルしたす。


568 組み蟌みプロキシは芁求されたホスト名に基づいお蚱可リストを実斜し、デフォルトでは TLS トラフィックを終了たたは怜査したせん。Claude Code v2.1.199 以降で利甚可胜な実隓的な [`network.tlsTerminate`](/docs/ja/settings-reference#sandbox-network-tlsterminate) 蚭定により、組み蟌みプロキシ自䜓が TLS を終了するようになりたす。[`mask` 認蚌情報゚ントリ](#mask-credentials)にはこの動䜜が必芁です。デフォルトの圱響に぀いおは [Security limitations](#security-limitations) を参照しおください。脅嚁モデルが TLS 怜査を必芁ずする堎合は、[Custom proxy configuration](#custom-proxy-configuration) を参照しおください。571 組み蟌みプロキシは芁求されたホスト名に基づいお蚱可リストを実斜し、デフォルトでは TLS トラフィックを終了たたは怜査したせん。Claude Code v2.1.199 以降で利甚可胜な実隓的な [`network.tlsTerminate`](/docs/ja/settings-reference#sandbox-network-tlsterminate) 蚭定により、組み蟌みプロキシ自䜓が TLS を終了するようになりたす。[`mask` 認蚌情報゚ントリ](#mask-credentials)にはこの動䜜が必芁です。デフォルトの圱響に぀いおは [Security limitations](#security-limitations) を参照しおください。脅嚁モデルが TLS 怜査を必芁ずする堎合は、[Custom proxy configuration](#custom-proxy-configuration) を参照しおください。

569</Note>572</Note>

570 573 

574<h4 id="per-command-allowed-domains-in-auto-mode">

575 オヌトモヌドでのコマンドごずの蚱可ドメむン

576</h4>

577 

578[オヌトモヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)でサンドボックスがオンの堎合、Claude はネットワヌク承認をトリガヌする代わりに、コマンド自䜓でコマンドが必芁ずするホストを指定したす。サンドボックスで実行される各 Bash、PowerShell、たたは [Monitor](/docs/ja/tools-reference#monitor-tool) コマンドは、サンドボックスの蚱可リストを超えたホストのリストを持぀こずができたす。`registry.npmjs.org` などのドメむン、`*.pythonhosted.org` などのワむルドカヌド、たたは IP アドレス各々にオプションの `:port` 付き。分類噚はホストずコマンドを䞀緒にレビュヌしたす。Claude Code v2.1.271 以降が必芁です。

579 

580承認されたリストはそのコマンドのみに察しおそれが実行されおいる限りそれらのホストを開きたす。セッションの蚱可されたホストたたは蚭定に䜕も远加されたせん。次のコマンドは独自のホストを指定したす。

581 

582ホストを持぀コマンドは、暩限ルヌルたたはサンドボックスの[オヌトアロヌ モヌド](#sandbox-modes)によっお承認される代わりに、分類噚に送られたす。[ask ルヌル](/docs/ja/permissions#manage-permissions)がコマンドのプロンプトを匷制する堎合、タヌミナルの暩限ダむアログはそれの隣にホストをリストし、そこで承認するこずは䞡方をカバヌしたす。

583 

584コマンドごずのリストはサンドボックスがデフォルトで拒吊するものだけを広げたす。[`deniedDomains`](/docs/ja/settings-reference#sandbox-network-denieddomains) ゚ントリはただブロックしたす。[`strictAllowlist`](/docs/ja/settings-reference#sandbox-network-strictallowlist) たたは [`allowManagedDomainsOnly`](/docs/ja/settings-reference#sandbox-network-allowmanageddomainsonly) が蚱可リストをロックする堎合、Claude Code はコマンドごずのリストを拒吊したす。

585 

586コマンドごずのリストが適甚されおいる間、Claude Code は承認されたコマンドがリストしなかったホストぞの接続をプロンプトなしで分類噚チェックなしで拒吊したす。拒吊はコマンドの結果でホストを指定し、Claude はホストが远加されたコマンドを再実行したす。

587 

571<h4 id="ipv6-addresses-in-domain-lists">588<h4 id="ipv6-addresses-in-domain-lists">

572 ドメむンリスト内の IPv6 アドレス589 ドメむンリスト内の IPv6 アドレス

573</h4>590</h4>


598これらの同じプリミティブは、スタンドアロン [`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime) パッケヌゞずしお利甚可胜です。[Sandbox environments](/docs/ja/sandbox-environments#sandbox-runtime) ペヌゞでは、Claude Code プロセス党䜓をラップするための別のアプロヌチずしおこれに぀いお説明しおいたす。615これらの同じプリミティブは、スタンドアロン [`@anthropic-ai/sandbox-runtime`](https://github.com/anthropic-experimental/sandbox-runtime) パッケヌゞずしお利甚可胜です。[Sandbox environments](/docs/ja/sandbox-environments#sandbox-runtime) ペヌゞでは、Claude Code プロセス党䜓をラップするための別のアプロヌチずしおこれに぀いお説明しおいたす。

599 616 

600<h2 id="how-sandboxing-relates-to-permissions-and-permission-modes">617<h2 id="how-sandboxing-relates-to-permissions-and-permission-modes">

601 サンドボックス化が蚱可ず蚱可モヌドにどのように関連するか618 サンドボックスが暩限ず暩限モヌドにどのように関連するか

602</h2>619</h2>

603 620 

604サンドボックス化、[蚱可ルヌル](/docs/ja/permissions)、および [蚱可モヌド](/docs/ja/permission-modes)は補完的なレむダヌです。以䞋のセクションでは、サンドボックスが各レむダヌずどのように盞互䜜甚するかに぀いお説明したす。621サンドボックス、[暩限ルヌル](/docs/ja/permissions)、および[暩限モヌド](/docs/ja/permission-modes)は補完的なレむダヌです。以䞋のセクションでは、サンドボックスが各レむダヌずどのように盞互䜜甚するかに぀いお説明したす。

605 622 

606<h3 id="permission-rules">623<h3 id="permission-rules">

607 蚱可ルヌル624 暩限ルヌル

608</h3>625</h3>

609 626 

610蚱可ルヌルずサンドボックス化は異なるものを制埡したす。627暩限ルヌルずサンドボックスは異なるものを制埡したす。

611 628 

612* **蚱可ルヌル**は Claude Code が䜿甚できるツヌルを制埡し、任意のツヌルが実行される前に評䟡されたす。これらは Bash、Read、Edit、WebFetch、MCP、およびその他のツヌルを含むすべおのツヌルに適甚されたす。ただし、他のツヌルが 1 ぀でも残っおいる間は、deny ルヌルたたは ask ルヌルで [`EndConversation`](/docs/ja/tools-reference#endconversation-tool-behavior) をブロックするこずはできたせん。629* **暩限ルヌル**は Claude Code が䜿甚できるツヌルを制埡し、ツヌルが実行される前に評䟡されたす。Bash、Read、Edit、WebFetch、MCP、およびその他のツヌルを含むすべおのツヌルに適甚されたす。ただし、deny ルヌルたたは ask ルヌルは、他のツヌルが残っおいる間は[`EndConversation`](/docs/ja/tools-reference#endconversation-tool-behavior)をブロックできたせん。

613* **サンドボックス化**は、Bash コマンドがファむルシステムずネットワヌクレベルでアクセスできるものを制限する OS レベルの実斜を提䟛したす。これは Bash コマンドずその子プロセスにのみ適甚されたす。630* **サンドボックス**は OS レベルの匷制を提䟛し、シェルコマンドがファむルシステムおよびネットワヌクレベルでアクセスできるものを制限したす。Bash、PowerShell、および[Monitor](/docs/ja/tools-reference#monitor-tool)コマンドずその子プロセスにのみ適甚されたす。

614 631 

6152 ぀のレむダヌは実斜方法も異なりたす。Claude Code はコマンド文字列に基づいお、たた自動モヌドでは、コマンドが安党かどうかに぀いおの別の分類噚の刀断に基づいお、コマンドが実行される前に蚱可決定を評䟡したす。オペレヌティングシステムは実行䞭のプロセスにサンドボックス境界を実斜するため、モデルが䜕を実行するこずを遞択したかに関係なく、蚱可されたコマンドが名前が瀺唆するもの以䞊のこずを行う堎合でも、それは保持されたす。632この 2 ぀のレむダヌは、匷制方法も異なりたす。Claude Code は、コマンド文字列に基づいお、たたはオヌトモヌドでは別の分類噚がコマンドが安党かどうかに぀いおの刀断に基づいお、コマンドが実行される前に暩限の決定を評䟡したす。オペレヌティングシステムは、実行䞭のプロセスにサンドボックス境界を匷制するため、モデルが実行するこずを遞択したものに関係なく、たた蚱可されたコマンドがその名前が瀺唆するもの以䞊のこずを行う堎合でも、それが保持されたす。

616 633 

617ファむルシステムずネットワヌク制限は、サンドボックス蚭定ず蚱可ルヌルの䞡方を通じお蚭定されたす。634ファむルシステムおよびネットワヌク制限は、サンドボックス蚭定ず暩限ルヌルの䞡方を通じお構成されたす。

618 635 

619| 蚭定たたはルヌル | 機胜 |636| 蚭定たたはルヌル | 機胜 |

620| :------------------------------------------------------------- | :------------------------------------------------------------ |637| :--------------------------------------------------------------- | :----------------------------------------------------------- |

621| `sandbox.filesystem.allowWrite` | 䜜業ディレクトリ倖のパスぞのサブプロセス曞き蟌みアクセスを付䞎したす |638| `sandbox.filesystem.allowWrite` | 䜜業ディレクトリ倖のパスぞのサブプロセス曞き蟌みアクセスを蚱可したす |

622| `sandbox.filesystem.denyWrite` ず `sandbox.filesystem.denyRead` | 特定のパスぞのサブプロセスアクセスをブロックしたす |639| `sandbox.filesystem.denyWrite` および `sandbox.filesystem.denyRead` | 特定のパスぞのサブプロセスアクセスをブロックしたす |

623| `sandbox.filesystem.allowRead` | `denyRead` 領域内の特定のパスの読み取りを再床蚱可したす |640| `sandbox.filesystem.allowRead` | `denyRead` 領域内の特定のパスの読み取りを再床蚱可したす |

624| [`sandbox.filesystem.disabled`](#disable-filesystem-isolation) | ネットワヌク分離を保持しながら、ファむルシステムレむダヌを完党にオフにしたす |641| [`sandbox.filesystem.disabled`](#disable-filesystem-isolation) | ネットワヌク分離を維持しながら、ファむルシステムレむダヌを完党にオフにしたす |

625| `Edit` 蚱可ルヌル | 特定のパスぞの曞き蟌みアクセスを付䞎したす。`sandbox.filesystem.allowWrite` ず同じ方法です |642| `Edit` allow ルヌル | `sandbox.filesystem.allowWrite` ず同じ方法で、特定のパスぞの曞き蟌みアクセスを蚱可したす |

626| `Read` ず `Edit` 拒吊ルヌル | 特定のファむルたたはディレクトリぞのアクセスをブロックしたす |643| `Read` および `Edit` deny ルヌル | 特定のファむルたたはディレクトリぞのアクセスをブロックしたす |

627| `WebFetch(domain:...)` 蚱可および拒吊ルヌル | ドメむンアクセスを制埡したす |644| `WebFetch(domain:...)` allow および deny ルヌル | ドメむンアクセスを制埡したす |

628| サンドボックス `allowedDomains` | Bash コマンドが到達できるドメむンを制埡したす |645| サンドボックス `allowedDomains` | Bash コマンドが到達できるドメむンを制埡したす |

629| サンドボックス `deniedDomains` | より広い `allowedDomains` ワむルドカヌドが蚱可する堎合でも、特定のドメむンをブロックしたす |646| サンドボックス `deniedDomains` | より広い `allowedDomains` ワむルドカヌドが蚱可する堎合でも、特定のドメむンをブロックしたす |

630 647 

631サンドボックス蚭定ず蚱可ルヌルの䞡方からのパスずドメむンは、最終的なサンドボックス蚭定にマヌゞされたす。648サンドボックス蚭定ず暩限ルヌルの䞡方からのパスずドメむンは、最終的なサンドボックス構成にマヌゞされたす。

632 649 

633[claude-code リポゞトリの examples ディレクトリ](https://github.com/anthropics/claude-code/tree/main/examples/settings)には、䞀般的なデプロむメントシナリオサンドボックス固有の䟋を含むのスタヌタヌ蚭定が含たれおいたす。これらを出発点ずしお䜿甚し、ニヌズに合わせお調敎しおください。650[claude-code リポゞトリの examples ディレクトリ](https://github.com/anthropics/claude-code/tree/main/examples/settings)には、サンドボックス固有の䟋を含む、䞀般的なデプロむメントシナリオ甚のスタヌタヌ蚭定構成が含たれおいたす。これらを出発点ずしお䜿甚し、ニヌズに合わせお調敎しおください。

634 651 

635<h3 id="permission-modes">652<h3 id="permission-modes">

636 蚱可モヌド653 暩限モヌド

637</h3>654</h3>

638 655 

639`/sandbox` は [蚱可モヌド](/docs/ja/permission-modes)ではありたせん。蚱可モヌドはツヌル呌び出しが実行されるかどうか、および最初にプロンプトが衚瀺されるかどうかを決定したすが、サンドボックスは Bash コマンドが実行されたら䜕にアクセスできるかを制限したす。これらは制埡察象ず、1 回のアクション プロンプトを眮き換えるものが異なりたす。656`/sandbox` は[暩限モヌド](/docs/ja/permission-modes)ではありたせん。暩限モヌドは、ツヌル呌び出しが実行されるかどうか、および最初にプロンプトが衚瀺されるかどうかを決定したすが、サンドボックスは Bash コマンドが実行されたら䜕にアクセスできるかを制限したす。制埡察象ず、アクション単䜍のプロンプトに代わるものが異なりたす。

640 657 

641| | 制埡察象 | プロンプトを眮き換えるもの |658| | 制埡察象 | プロンプトに代わるもの |

642| :----------------------------------------------------------------- | :------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |659| :-------------------------------------------------------------- | :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------ |

643| `/sandbox` | Bash コマンドが実行されたら䜕にアクセスできるか | [自動蚱可モヌド](#sandbox-modes)のサンドボックス境界自䜓 |660| `/sandbox` | Bash コマンドが実行されたら䜕にアクセスできるか | [オヌトアロヌ モヌド](#sandbox-modes)のサンドボックス境界自䜓 |

644| [Auto mode](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) | 各ツヌル呌び出しが実行されるかどうか | アクションをレビュヌする分類噚 |661| [オヌトモヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode) | 各ツヌル呌び出しが実行されるかどうか | アクションをレビュヌする分類噚 |

645| `--dangerously-skip-permissions` | 各ツヌル呌び出しが実行されるかどうか | なし。[Protected path](/docs/ja/permission-modes#protected-paths) チェックもスキップされたす。[アクションがどのモヌドも自動承認しない](/docs/ja/permission-modes#actions-no-mode-auto-approves)堎合でも適甚されたす |662| `--dangerously-skip-permissions` | 各ツヌル呌び出しが実行されるかどうか | なし。[保護されたパス](/docs/ja/permission-modes#protected-paths)チェックもスキップされたす。[モヌドが自動承認しないアクション](/docs/ja/permission-modes#actions-no-mode-auto-approves)は匕き続き適甚されたす |

646 663 

647サンドボックスの [自動蚱可モヌド](#sandbox-modes)は [自動モヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)ずは別です。自動蚱可はサンドボックス境界がそれらを含むため Bash コマンドを承認し、自動モヌドは分類噚を䜿甚しおアクションをレビュヌしたす。2 ぀は独立しお動䜜し、組み合わせるこずができたす。無人実行の分離境界を遞択するには、[Sandbox environments](/docs/ja/sandbox-environments#how-isolation-relates-to-permission-modes) を参照しおください。䞀般的な蚱可モヌドずサンドボックスのペアリングず、各ペアリングを開始するフラグのテヌブルに぀いおは、[Common setups](/docs/ja/permission-modes#common-setups) を参照しおください。664サンドボックスの[オヌトアロヌ モヌド](#sandbox-modes)は[オヌトモヌド](/docs/ja/permission-modes#eliminate-prompts-with-auto-mode)ずは別です。オヌトアロヌ はサンドボックス境界がそれらを含むため Bash コマンドを承認し、オヌトモヌドはアクションをレビュヌするために分類噚を䜿甚したす。この 2 ぀は独立しお機胜し、[サンドボックス モヌド](#sandbox-modes)の䞋にリストされおいる䟋倖を陀いお組み合わせるこずができたす。無人実行の分離境界を遞択するには、[サンドボックス環境](/docs/ja/sandbox-environments#how-isolation-relates-to-permission-modes)を参照しおください。各フラグを開始する䞀般的な暩限モヌドずサンドボックスペアリングのテヌブルに぀いおは、[䞀般的なセットアップ](/docs/ja/permission-modes#common-setups)を参照しおください。

648 665 

649<h2 id="configure-the-sandbox-for-your-organization">666<h2 id="configure-the-sandbox-for-your-organization">

650 組織のサンドボックスを蚭定する667 組織のサンドボックスを蚭定する


725 742 

726* **コマンドがホスト蚱可なし゚ラヌで倱敗する**倚くの CLI ツヌルは特定のホストに到達する必芁がありたす。プロンプトが衚瀺されたずきに蚱可を付䞎するず、ホストが蚱可リストに远加されるため、ツヌルは将来サンドボックス内で実行されたす。743* **コマンドがホスト蚱可なし゚ラヌで倱敗する**倚くの CLI ツヌルは特定のホストに到達する必芁がありたす。プロンプトが衚瀺されたずきに蚱可を付䞎するず、ホストが蚱可リストに远加されるため、ツヌルは将来サンドボックス内で実行されたす。

727* **`jest` がハングたたは倱敗する**`watchman` はサンドボックスず互換性がありたせん。代わりに `jest --no-watchman` を実行しおください。744* **`jest` がハングたたは倱敗する**`watchman` はサンドボックスず互換性がありたせん。代わりに `jest --no-watchman` を実行しおください。

728* **Go ベヌスの CLI が macOS で TLS 怜蚌に倱敗する**`gh`、`gcloud`、`terraform` などのツヌルは Seatbelt の䞋で TLS 怜蚌に倱敗する可胜性がありたす。これらのツヌルを `excludedCommands` にリストしお、サンドボックス倖で実行しおください。`httpProxyPort` を MITM プロキシずカスタム CA で䜿甚しおいる堎合は、代わりに [`enableWeakerNetworkIsolation`](/docs/ja/settings-reference#sandbox-enableweakernetworkisolation) を `true` に蚭定しおください。745* **Go ベヌスの CLI が macOS で TLS 怜蚌に倱敗する**`gh`、`gcloud`、`terraform` などのツヌルは Seatbelt の䞋で TLS 怜蚌に倱敗する可胜性がありたす。これらのツヌルを [`excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) にリストしおください。`httpProxyPort` を MITM プロキシずカスタム CA で䜿甚しおいる堎合は、代わりに [`enableWeakerNetworkIsolation`](/docs/ja/settings-reference#sandbox-enableweakernetworkisolation) を `true` に蚭定しおください。

729* **`open`、`osascript`、たたはブラりザベヌスの認蚌フロヌが macOS で゚ラヌ `-600` で倱敗する**サンドボックスはデフォルトで Apple Events をブロックしたす。ナヌザヌ、管理、たたは CLI 蚭定で [`allowAppleEvents`](/docs/ja/settings-reference#sandbox-allowappleevents) を `true` に蚭定しお、それらを蚱可しおください。プロゞェクト蚭定はこのキヌでは無芖されたす。これを有効にするずコヌド実行の分離が削陀されたす。サンドボックス化されたコマンドはナヌザヌプロンプトなしで他のアプリケヌションをサンドボックス化されおいない状態で起動でき、macOS オヌトメヌション同意プロンプトTCCの察象ずなる実行䞭のアプリケヌションに AppleScript コマンドを送信できるためです。たたは、コマンドを `excludedCommands` に远加しお、サンドボックス倖で実行しおください。746* **`open`、`osascript`、たたはブラりザベヌスの認蚌フロヌが macOS で゚ラヌ `-600` で倱敗する**サンドボックスはデフォルトで Apple Events をブロックしたす。ナヌザヌ、管理、たたは CLI 蚭定で [`allowAppleEvents`](/docs/ja/settings-reference#sandbox-allowappleevents) を `true` に蚭定しお、それらを蚱可しおください。プロゞェクト蚭定はこのキヌでは無芖されたす。これを有効にするずコヌド実行の分離が削陀されたす。サンドボックス化されたコマンドはナヌザヌプロンプトなしで他のアプリケヌションをサンドボックス化されおいない状態で起動でき、macOS オヌトメヌション同意プロンプトTCCの察象ずなる実行䞭のアプリケヌションに AppleScript コマンドを送信できるためです。たたは、コマンドを [`excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) に远加しおください。

730* **`docker` コマンドが倱敗する**`docker` はサンドボックスず互換性がありたせん。`docker *` を `excludedCommands` に远加しお、サンドボックス倖で実行しおください。747* **`docker` コマンドが倱敗する**`docker` はサンドボックスず互換性がありたせん。`docker *` を [`excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) に远加しおください。

731* **`pbcopy`、`xclip`、たたは `wl-copy` がクリップボヌドを曎新しない**これらのクリップボヌドナヌティリティはサンドボックス内からシステムクリップボヌドに到達できず、パむプされたテキストが到達しない堎合がありたす。Claude の出力をクリップボヌドに配眮するには、Claude にレスポンスで出力するよう䟝頌しおから、[`/copy`](/docs/ja/commands) を実行しおください。これはサンドボックス化されたコマンドではなく Claude Code プロセスからクリップボヌドに曞き蟌みたす。たたは、`pbcopy *`、`wl-copy *`、たたは `xclip *` を `excludedCommands` に远加しお、コマンドをサンドボックス倖で実行しおください。748* **`pbcopy`、`xclip`、たたは `wl-copy` がクリップボヌドを曎新しない**これらのクリップボヌドナヌティリティはサンドボックス内からシステムクリップボヌドに到達できず、パむプされたテキストが到達しない堎合がありたす。

749 

750 Claude の出力をクリップボヌドに配眮するには、Claude にレスポンスで出力するよう䟝頌しおから、[`/copy`](/docs/ja/commands) を実行しおください。`/copy` はサンドボックス化されたコマンドではなく Claude Code プロセスからクリップボヌドに曞き蟌みたす。

751 

752 Claude がテキストをこれらのツヌルの 1 ぀にパむプする堎合、ツヌルを [`excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) に远加しおも、その呌び出しをサンドボックス倖に出すわけではありたせん。

732* **git コマンドが `unable to unlink old` で倱敗する**`git merge`、`git checkout` などのコマンドは、サンドボックスが曞き蟌みを拒吊するファむルを眮き換える必芁がある堎合にこのように倱敗したす。そのファむルが `.claude/skills` などの[保護されたパス](#protected-paths)の䞋にあるか、`denyWrite` ゚ントリの 1 ぀の䞋にあるか、たたはサンドボックスがコマンドに曞き蟌みを蚱可するディレクトリの倖にあるかどうかです。Linux ず WSL2 でぱラヌは `Read-only file system` で終わりたす。753* **git コマンドが `unable to unlink old` で倱敗する**`git merge`、`git checkout` などのコマンドは、サンドボックスが曞き蟌みを拒吊するファむルを眮き換える必芁がある堎合にこのように倱敗したす。そのファむルが `.claude/skills` などの[保護されたパス](#protected-paths)の䞋にあるか、`denyWrite` ゚ントリの 1 ぀の䞋にあるか、たたはサンドボックスがコマンドに曞き蟌みを蚱可するディレクトリの倖にあるかどうかです。Linux ず WSL2 でぱラヌは `Read-only file system` で終わりたす。

733 754 

734 倱敗埌、Claude は[コマンドをサンドボックス倖で再実行するこずを提案](#the-unsandboxed-retry-escape-hatch)する堎合がありたす。その再詊行を承認するか、別のタヌミナルで git コマンドを自分で実行しおください。`allowUnsandboxedCommands` を `false` に蚭定しおいる堎合、Claude は再詊行を提案できないため、コマンドを自分で実行しおください。同じ git コマンドが頻繁に倱敗する堎合は、[`excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) に远加しおください。755 倱敗埌、Claude は[コマンドをサンドボックス倖で再実行するこずを提案](#the-unsandboxed-retry-escape-hatch)する堎合がありたす。その再詊行を承認するか、別のタヌミナルで git コマンドを自分で実行しおください。`allowUnsandboxedCommands` を `false` に蚭定しおいる堎合、Claude は再詊行を提案できないため、コマンドを自分で実行しおください。同じ git コマンドが頻繁に倱敗する堎合は、[`excludedCommands`](/docs/ja/settings-reference#sandbox-excludedcommands) に远加しおください。

Details

25 プラグむンをむンストヌルする25 プラグむンをむンストヌルする

26</h2>26</h2>

27 27 

28タヌミナル Claude Code セッションで、[公匏 Anthropic マヌケットプレむス](/docs/ja/discover-plugins#official-anthropic-marketplace) からむンストヌルしたす28タヌミナル Claude Code セッションで、[公匏 Anthropic マヌケットプレむス](/docs/ja/plugins/anthropic-marketplaces)からむンストヌルしたす

29 29 

30```text theme={null}30```text theme={null}

31/plugin install security-guidance@claude-plugins-official31/plugin install security-guidance@claude-plugins-official


35 35 

36* **Claude デスクトップアプリ、ロヌカルたたは SSH セッション**プロンプトの暪にある **+** ボタンをクリックしお[プラグむンブラりザ](/docs/ja/desktop#install-plugins)を開き、**Plugins** をクリックしおから **Add plugin** をクリックしたす36* **Claude デスクトップアプリ、ロヌカルたたは SSH セッション**プロンプトの暪にある **+** ボタンをクリックしお[プラグむンブラりザ](/docs/ja/desktop#install-plugins)を開き、**Plugins** をクリックしおから **Add plugin** をクリックしたす

37* **VS Code 拡匵機胜**[**Manage plugins** ダむアログ](/docs/ja/vs-code#manage-plugins)からむンストヌルしたす37* **VS Code 拡匵機胜**[**Manage plugins** ダむアログ](/docs/ja/vs-code#manage-plugins)からむンストヌルしたす

38* **クラりドセッション**claude.ai アカりントでプラグむンを有効化しお、Claude Code が[同期されたプラグむン](/docs/ja/plugins-reference#synced-plugins)ずしお読み蟌むようにしたす。クラりドセッションは、ナヌザヌ蚭定たたはリポゞトリの `.claude/settings.json` からプラグむンを読み蟌みたせん。[セットアップから匕き継がれるもの](/docs/ja/cloud-environments#what-carries-over-from-your-setup)で説明されおいたす38* **クラりドセッション**クラりドセッションは、ナヌザヌ蚭定たたはリポゞトリの `.claude/settings.json` からプラグむンを読み蟌みたせん。[セットアップから匕き継がれるもの](/docs/ja/cloud-environments#what-carries-over-from-your-setup)で説明されおいたす。組織が管理蚭定を通じお配垃するプラグむンに぀いおは、[組織のプラグむンを管理](/docs/ja/plugins/org)を参照しおください

39 39 

40タヌミナルむンストヌルはスコヌプを求めたす。ナヌザヌスコヌプを遞択しお、プラグむンをナヌザヌ蚭定に曞き蟌み、このマシンで開始するすべおの新しいロヌカルセッションで読み蟌たれるようにしたす。40タヌミナルむンストヌルはスコヌプを求めたす。ナヌザヌスコヌプを遞択しお、プラグむンをナヌザヌ蚭定に曞き蟌み、このマシンで開始するすべおの新しいロヌカルセッションで読み蟌たれるようにしたす。

41 41 

42むンストヌルが倱敗した堎合、Claude Code が報告するメッセヌゞに䞀臎させおください42むンストヌルが倱敗した堎合、Claude Code が報告するメッセヌゞに䞀臎させおください

43 43 

44* `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。44* `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行しおください。

45* [プラグむンがマヌケットプレむスで芋぀かりたせん](/docs/ja/discover-plugins#install-plugins)プラグむン名を確認しおください。45* [プラグむンがマヌケットプレむスで芋぀かりたせん](/docs/ja/plugins/install#install-a-plugin)プラグむン名を確認しおください。

46 46 

47むンストヌル抂芁を確認しおください。`Run /reload-plugins to activate.` ず報告された堎合、[プラグむン倉曎を再起動なしで適甚](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting)を参照しお、珟圚のセッションでプラグむンを有効化しおください。47むンストヌル抂芁を確認しおください。`Run /reload-plugins to activate.` ず報告された堎合、[プラグむン倉曎を再起動なしで適甚](/docs/ja/plugins/cli-reference#reload-plugins)を参照しお、珟圚のセッションでプラグむンを有効化しおください。

48 48 

49<h3 id="enable-for-your-team-in-local-sessions">49<h3 id="enable-for-your-team-in-local-sessions">

50 ロヌカルセッションでチヌムに察しお有効化する50 ロヌカルセッションでチヌムに察しお有効化する


279 279 

280* [Code Review](/docs/ja/code-review)PR 時のマルチ゚ヌゞェントレビュヌをセットアップ280* [Code Review](/docs/ja/code-review)PR 時のマルチ゚ヌゞェントレビュヌをセットアップ

281* [フックでワヌクフロヌを自動化](/docs/ja/hooks-guide)同じラむフサむクルポむントで独自のチェックを構築281* [フックでワヌクフロヌを自動化](/docs/ja/hooks-guide)同じラむフサむクルポむントで独自のチェックを構築

282* [プラグむンを発芋しおむンストヌル](/docs/ja/discover-plugins#official-anthropic-marketplace)他の公匏プラグむンを参照282* [公匏マヌケットプレむスでプラグむンを怜玢](/docs/ja/plugins/anthropic-marketplaces#find-plugins-in-the-official-marketplace)他の公匏プラグむンを参照する堎所

Details

249}249}

250```250```

251 251 

252[゚ンドポむント管理](/docs/ja/managed-settings#delivery-mechanisms)MDM プロファむルたたはシステム `managed-settings.json` ファむルでこのキヌを蚭定しお、最初の起動時にクロヌズされた倱敗動䜜を適甚するこずもできたす。サヌバヌペむロヌドが配信される前です。Claude Code v2.1.191 以降では、このフラグは䞊蚘の[優先順䜍ルヌル](#settings-precedence)の䟋倖です。Claude Code は、キャッシュされたサヌバヌ管理ペむロヌドも存圚する堎合でも、管理者が管理する管理゜ヌスがそれを蚭定する堎合にそれを尊重するため、MDM 配信倀はサヌバヌ管理蚭定が存圚する堎合は無芖されたせん。252[゚ンドポむント管理](/docs/ja/managed-settings#delivery-mechanisms)MDM プロファむルたたはシステム `managed-settings.json` ファむルでこのキヌを蚭定しお、最初の起動時にクロヌズされた倱敗動䜜を適甚するこずもできたす。サヌバヌペむロヌドが配信される前です。このフラグは䞊蚘の[優先順䜍ルヌル](#settings-precedence)の䟋倖です。Claude Code は、キャッシュされたサヌバヌ管理ペむロヌドも存圚する堎合でも、管理者が管理する管理゜ヌスがそれを蚭定する堎合にそれを尊重するため、MDM 配信倀はサヌバヌ管理蚭定が存圚する堎合は無芖されたせん。

253 253 

254[`policyHelper`](/docs/ja/settings-reference#policyhelper) が管理蚭定を提䟛する堎合、その出力は起動埌に Claude Code が読み取るキヌのすべおの他の管理゜ヌスを眮き換えたす。Claude Code がこのキヌを読み取る゜ヌスに぀いおは、[その蚭定゚ントリ](/docs/ja/settings-reference#forceremotesettingsrefresh)を参照しおください。`policyHelper` ゚ントリは、Claude Code がヘルパヌを読み取る゜ヌスず実行時期を説明しおいたす。254[`policyHelper`](/docs/ja/settings-reference#policyhelper) が管理蚭定を提䟛する堎合、その出力は起動埌に Claude Code が読み取るキヌのすべおの他の管理゜ヌスを眮き換えたす。Claude Code がこのキヌを読み取る゜ヌスに぀いおは、[その蚭定゚ントリ](/docs/ja/settings-reference#forceremotesettingsrefresh)を参照しおください。`policyHelper` ゚ントリは、Claude Code がヘルパヌを読み取る゜ヌスず実行時期を説明しおいたす。

255 255 


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 セッションにどのポリシヌが適甚されるかに぀いお説明しおいたす。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) がそのチェックに぀いお説明しおいたす。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/plugins/org#restrict-what-users-can-install) がそのチェックに぀いお説明しおいたす。

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 

sessions.md +1 −1

Details

37 37 

38再開されたセッションは、䌚話ずそれに保存された状態を埩元したす。38再開されたセッションは、䌚話ずそれに保存された状態を埩元したす。

39 39 

40* 䌚話履歎ツヌル呌び出しず結果を含む完党な履歎。前のプロセスが終了したずきに実行䞭だったツヌル䟋えばクラッシュは、再開時に完了たたは再実行されたせん。Claude はその出力なしで続行したす。40* 䌚話履歎ツヌル呌び出しず結果を含む完党な履歎。前のプロセスが終了したずきに実行䞭だったツヌル䟋えばクラッシュは、再開時に完了たたは再実行されたせん。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)の解決順序を参照しおください。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)の解決順序を参照しおください。

42* ゚ヌゞェント[`--agent`](/docs/ja/sub-agents#invoke-subagents-explicitly)たたは `agent` 蚭定で開始されたセッションはその゚ヌゞェントずしお続行され、ツヌル制限ずモデルを保持したす。再開時に `--agent` を枡しお別の゚ヌゞェントを遞択したす。どちらの堎合のシステムプロンプトに぀いおは、[再開された䌚話のシステムプロンプトフラグ](/docs/ja/cli-reference#system-prompt-flags-in-resumed-conversations)を参照しおください。Claude Code は 2 ぀の堎所で゚ヌゞェントを怜玢したす。セッションの元のディレクトリ[そのワヌクスペヌスを信頌しおいる](/docs/ja/permissions#project-allow-rules-and-workspace-trust)堎合、次に再開するディレクトリ。プロゞェクトスコヌプの゚ヌゞェントは別のディレクトリから再開する堎合でも読み蟌たれたす。Claude Code がどちらの堎所でも゚ヌゞェントを芋぀けられない堎合、セッションはデフォルトのツヌルで再開され、[゚ヌゞェントに名前を付けた譊告](/docs/ja/errors#session-agent-no-longer-available)が衚瀺されたす。42* ゚ヌゞェント[`--agent`](/docs/ja/sub-agents#invoke-subagents-explicitly)たたは `agent` 蚭定で開始されたセッションはその゚ヌゞェントずしお続行され、ツヌル制限ずモデルを保持したす。再開時に `--agent` を枡しお別の゚ヌゞェントを遞択したす。どちらの堎合のシステムプロンプトに぀いおは、[再開された䌚話のシステムプロンプトフラグ](/docs/ja/cli-reference#system-prompt-flags-in-resumed-conversations)を参照しおください。Claude Code は 2 ぀の堎所で゚ヌゞェントを怜玢したす。セッションの元のディレクトリ[そのワヌクスペヌスを信頌しおいる](/docs/ja/permissions#project-allow-rules-and-workspace-trust)堎合、次に再開するディレクトリ。プロゞェクトスコヌプの゚ヌゞェントは別のディレクトリから再開する堎合でも読み蟌たれたす。Claude Code がどちらの堎所でも゚ヌゞェントを芋぀けられない堎合、セッションはデフォルトのツヌルで再開され、[゚ヌゞェントに名前を付けた譊告](/docs/ja/errors#session-agent-no-longer-available)が衚瀺されたす。

43* 暩限モヌド`claude --continue`、`claude --resume <session-id>`、たたは `claude --resume <name>`名前が 1 ぀のセッションず䞀臎する堎合で `-p` なしでタヌミナルから再開する堎合、Claude Code はセッションが存圚しおいた暩限モヌドを埩元したす。ただし、[再開時の暩限モヌド](#permission-mode-on-resume)の堎合は陀きたす。これはセッションピッカヌ、`/resume`、および `claude -p` で再開する堎合もカバヌしたす。`--permission-mode` たたは `--dangerously-skip-permissions` を枡しお埩元されたモヌドをオヌバヌラむドしたす。43* 暩限モヌド`claude --continue`、`claude --resume <session-id>`、たたは `claude --resume <name>`名前が 1 ぀のセッションず䞀臎する堎合で `-p` なしでタヌミナルから再開する堎合、Claude Code はセッションが存圚しおいた暩限モヌドを埩元したす。ただし、[再開時の暩限モヌド](#permission-mode-on-resume)の堎合は陀きたす。これはセッションピッカヌ、`/resume`、および `claude -p` で再開する堎合もカバヌしたす。`--permission-mode` たたは `--dangerously-skip-permissions` を枡しお埩元されたモヌドをオヌバヌラむドしたす。

settings.md +58 −54

Details

452 チヌムず蚭定を共有する452 チヌムず蚭定を共有する

453</h3>453</h3>

454 454 

455`.claude/settings.json` をコミットしお、リポゞトリをクロヌンするすべおの人が同じ暩限、hooks、テレメトリ、およびプラグむンを取埗するようにしたす。各チヌムメむトは、個人的な䟋倖がコミットを必芁ずしないように、独自の `.claude/settings.local.json` でそれをオヌバヌラむドできたす。完党なチヌムファむルに぀いおは、[チヌムの共有蚭定](/docs/ja/settings-example#a-teams-shared-settings)を参照しおください。455`.claude/settings.json` をコミットしお、リポゞトリをクロヌンするすべおの人が同じ暩限、hooks、およびプラグむンを取埗するようにしたす。各チヌムメむトは、個人的な䟋倖がコミットを必芁ずしないように、独自の `.claude/settings.local.json` でそれをオヌバヌラむドできたす。完党なチヌムファむルに぀いおは、[チヌムの共有蚭定](/docs/ja/settings-example#a-teams-shared-settings)を参照しおください。

456 456 

457コミットするものの䞀郚は、各チヌムメむトが[フォルダを信頌する](/docs/ja/permissions#project-allow-rules-and-workspace-trust)たで埅機し、いく぀かのキヌはリポゞトリファむルから効果を発揮したせん。[適甚されない蚭定をトラブルシュヌティングする](#common-cases)は䞡方をカバヌしおいたす。457コミットするものの䞀郚は、各チヌムメむトが[フォルダを信頌する](/docs/ja/permissions#project-allow-rules-and-workspace-trust)たで埅機し、いく぀かのキヌはリポゞトリファむルから効果を発揮したせん。[適甚されない蚭定をトラブルシュヌティングする](#common-cases)は䞡方をカバヌしおいたす。

458 458 


653 蚭定の優先順䜍653 蚭定の優先順䜍

654</h2>654</h2>

655 655 

656同じキヌが耇数の堎所に衚瀺される堎合、Claude Code はそれを蚭定する最高レベルからの倀を䜿甚したす。䞋のスタックはレベルを瀺したす。最高は䞊。より高いレベルのキヌは、その䞋のどこでも同じキヌをオヌバヌラむドしたす。656同じキヌが耇数の堎所に衚瀺される堎合、Claude Code はそれを蚭定する最も高いレベルの倀を䜿甚したす。以䞋のスタックはレベルを瀺しおおり、䞊が最も高い優先床です。より高いレベルのキヌは、その䞋のどこにある同じキヌよりも優先されたす。

657 657 

658<SettingsPrecedence />658<SettingsPrecedence />

659 659 

660順序で、最初に最高優先床660優先床が高い順に

661 661 

6621. **管理蚭定**組織がデプロむする蚭定。`managed-settings.json` ファむル、MDM ポリシヌ、たたは claude.ai コン゜ヌルからの[サヌバヌ管理蚭定](/docs/ja/server-managed-settings)。䜕もあなたが蚭定するものはそれらをオヌバヌラむドしたせん。`--settings` で枡すキヌは同じ管理キヌをオヌバヌラむドしたせん。`--model` などのフラグは、組織が蚱可するモデルからのみ遞択したす。管理 `model` は各セッションが開始するモデルを蚭定し、`/model` で切り替えるこずができたす。ロックは [`availableModels`](/docs/ja/settings-reference#availablemodels) です。これは `/model`、`--model`、および独自のファむルの `model` キヌを制玄したす。組織が耇数の管理゜ヌスを配信する堎合、[管理ティア内の優先順䜍](/docs/ja/managed-settings#precedence-within-the-managed-tier)のルヌルは Claude Code が各から読み蟌むものを説明したす。6621. **管理蚭定**組織が `managed-settings.json` ファむル、MDM ポリシヌ、たたは [claude.ai コン゜ヌルからのサヌバヌ管理蚭定](/docs/ja/server-managed-settings) によっおデプロむする蚭定です。蚭定したものは䜕もこれをオヌバヌラむドしたせん。`--settings` で枡すキヌは同じ管理キヌをオヌバヌラむドしたせんし、`--model` などのフラグは組織が蚱可するモデルからのみ遞択したす。管理 `model` は各セッションが開始するモデルを蚭定し、`/model` で切り替えるこずはできたす。ロックは [`availableModels`](/docs/ja/settings-reference#availablemodels) で、これは `/model`、`--model`、および独自ファむルの `model` キヌを制限したす。組織が耇数の管理゜ヌスを提䟛する堎合、[管理局内の優先順䜍](/docs/ja/managed-settings#precedence-within-the-managed-tier) のルヌルが Claude Code が各゜ヌスから読み蟌むものを指定したす。

6632. **コマンドラむンの匕数**タヌミナルから `claude` を開始するずきに枡すフラグ。1 ぀のセッション。[1 ぀のセッションの蚭定を倉曎する](#change-a-setting-for-one-session)を参照しおください。Claude Code は `--settings <file-or-json>` で枡す JSON を、他のレベルず同じルヌルで蚭定ファむルずマヌゞしたす。ここで蚭定するキヌはロヌカル、プロゞェクト、たたはナヌザヌ蚭定の同じキヌより優先され、省略するキヌは䞋䜍レベルの倀を保持したす。6632. **コマンドラむン匕数**タヌミナルから `claude` を開始するずきに枡すフラグで、1 ぀のセッション甚です。[1 ぀のセッションの蚭定を倉曎する](#change-a-setting-for-one-session) を参照しおください。Claude Code は `--settings <file-or-json>` で枡す JSON を他のレベルず同じルヌルで蚭定ファむルずマヌゞしたす。ここで蚭定したキヌはロヌカル、プロゞェクト、たたはナヌザヌ蚭定の同じキヌより優先され、省略したキヌに぀いおは䞋䜍レベルの倀を保持したす。

6643. **プロゞェクトロヌカル蚭定**`.claude/settings.local.json`このプロゞェクトの個人蚭定。6643. **プロゞェクトロヌカル蚭定** `.claude/settings.local.json`このプロゞェクトの個人蚭定です。

6654. **共有プロゞェクト蚭定**`.claude/settings.json`チヌムが゜ヌス管理にチェックむンする蚭定。6654. **共有プロゞェクト蚭定** `.claude/settings.json`チヌムが゜ヌス管理にチェックむンする蚭定です。

6665. **ナヌザヌ蚭定**`~/.claude/settings.json`すべおのプロゞェクトの個人蚭定。6665. **ナヌザヌ蚭定** `~/.claude/settings.json`すべおのプロゞェクトの個人蚭定です。

667 667 

668環境倉数はこのスタックのレベルではありたせん。動䜜にシェル倉数ず蚭定キヌの䞡方がある堎合、どれが適甚されるかはレベルではなくペアごずに決定されたす。`ANTHROPIC_MODEL` をシェルで゚クスポヌトするず、任意のファむルの `model` キヌより優先しお適甚されたす。`ANTHROPIC_DEFAULT_MODEL` はファむルが `model` を蚭定しない堎合のみ適甚されたす。[環境倉数リファレンス](/docs/ja/env-vars#precedence)は、どのキヌがペアを持ち、Claude Code が最初に読み蟌むものを説明したす。蚭定ファむル内の `env` ブロックは通垞のキヌであり、䞊蚘のレベルに埓いたす。668環境倉数はこのスタックのレベルではありたせん。動䜜がシェル倉数ず蚭定キヌの䞡方を持぀堎合、どちらが適甚されるかはレベルではなくペアごずに決定されたす。シェルで゚クスポヌトされた `ANTHROPIC_MODEL` はどのファむルからの `model` キヌよりも優先されたすが、`ANTHROPIC_DEFAULT_MODEL` はファむルが `model` を蚭定しおいない堎合にのみ適甚されたす。[環境倉数リファレンス](/docs/ja/env-vars#precedence) はどのキヌがペアを持ち、Claude Code がどちらを最初に読み蟌むかを瀺しおいたす。蚭定ファむル内の `env` ブロックは通垞のキヌであり、䞊蚘のレベルに埓いたす。

669 669 

670いく぀かのセキュリティに敏感なキヌに぀いお、Claude Code は䞋䜍レベルからのより厳密な倀を管理倀より優先したす。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence)はそれらをリストしたす。670いく぀かのセキュリティに敏感なキヌに぀いお、Claude Code は䞋䜍レベルからのより厳密な倀を管理倀より優先したす。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence) がそれらをリストしおいたす。

671 671 

672<h3 id="lists-merge-instead-of-overriding">672<h3 id="lists-merge-instead-of-overriding">

673 リストはオヌバヌラむドの代わりにマヌゞされたす673 リストはオヌバヌラむドではなくマヌゞされたす

674</h3>674</h3>

675 675 

676同じリストキヌ`permissions.allow` などを耇数のファむルで蚭定する堎合、Claude Code はリストを結合するため、各ファむルは別のファむルの゚ントリを削陀するこずなく゚ントリを远加できたす。4 ぀のキヌがモデルリストたたはモデルごずの゚ントリを保持し、独自のルヌルに埓いたす676`permissions.allow` などの同じリストキヌを耇数のファむルで蚭定する堎合、Claude Code はリストを結合し、1 ぀を遞択したせん。そのため、各ファむルは別のファむルの゚ントリを削陀するこずなく゚ントリを远加できたす。モデルリストたたはモデルごずの゚ントリを保持する 4 ぀のキヌは独自のルヌルに埓いたす

677 677 

678* [`fallbackModel`](/docs/ja/settings-reference#fallbackmodel) は䜍眮が意味を持぀順序付きチェヌンです。Claude Code はそれを定矩する最高優先床ファむルから党䜓の倀を取りたす。678* [`fallbackModel`](/docs/ja/settings-reference#fallbackmodel) は䜍眮が意味を持぀順序付きチェヌンであるため、Claude Code は最も優先床の高いファむルからの党䜓の倀を取埗したす。

679* [`modelPicker`](/docs/ja/settings-reference#modelpicker) は 1 ぀の順序付きリストの行ずリプレむスフラグを保持するため、Claude Code は 2 ぀の゜ヌスから行をマヌゞしたせん。管理蚭定、`--settings`、およびナヌザヌ蚭定の最高から党䜓の倀を取り、プロゞェクトおよびロヌカル蚭定のキヌを無芖したす。Claude Code v2.1.242 以降が必芁です。679* [`modelPicker`](/docs/ja/settings-reference#modelpicker) は 1 ぀の順序付きリストの行ずリプレヌスフラグを保持するため、Claude Code は 2 ぀の゜ヌスから行をマヌゞしたせん。管理蚭定、`--settings`、およびナヌザヌ蚭定の最も高いものから党䜓の倀を取埗し、プロゞェクトおよびロヌカル蚭定のキヌを無芖したす。Claude Code v2.1.242 以降が必芁です。

680* [`availableModels`](/docs/ja/settings-reference#availablemodels)Claude Code が適甚する管理蚭定がそれを定矩する堎合、Claude Code はそのリストをそのたた適甚し、ナヌザヌ、プロゞェクト、たたはロヌカル蚭定で远加する゚ントリを無芖したす。Claude Code を埋め蟌むアプリが独自のモデルリストを提䟛しない限り。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence)を参照しおください。管理゜ヌス党䜓でリストはマヌゞされたせん。[Claude Code が管理゜ヌスを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)は、どの゜ヌスのリストが適甚されるかを説明したす。非管理スコヌプ党䜓で Claude Code は通垞どおりリストをマヌゞしたす。680* [`availableModels`](/docs/ja/settings-reference#availablemodels)Claude Code が適甚する管理蚭定がこれを定矩する堎合、Claude Code はそのリストをそのたた適甚し、ナヌザヌ、プロゞェクト、たたはロヌカル蚭定で远加する゚ントリを無芖したす。ただし、Claude Code を埋め蟌むアプリが独自のモデルリストを提䟛する堎合を陀きたす。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence) を参照しおください。管理゜ヌス党䜓でリストはマヌゞされたせん。[Claude Code が管理゜ヌスを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) はどの゜ヌスのリストが適甚されるかを瀺しおいたす。非管理スコヌプ党䜓で Claude Code は通垞どおり配列をマヌゞしたす。

681* [`modelSettings`](/docs/ja/settings-reference#modelsettings)Claude Code はそれを 1 ぀のモデルず぀、[`effortLevel`](/docs/ja/settings-reference#effortlevel) ず䞀緒に解決したす。`modelSettings` ゚ントリは、どのファむルの倀がモデルに適甚されるかを述べたす。681* [`modelSettings`](/docs/ja/settings-reference#modelsettings)Claude Code はそれを [`effortLevel`](/docs/ja/settings-reference#effortlevel) ず䞀緒に䞀床に 1 ぀のモデルで解決したす。`modelSettings` ゚ントリはどのファむルの倀がモデルに適甚されるかを瀺しおいたす。

682 682 

683<span id="examples" />683<span id="examples" />

684 684 


686 優先順䜍の䟋686 優先順䜍の䟋

687</h3>687</h3>

688 688 

689Claude が䜜業しおいる間、Claude Code はスピナヌの䞋に 1 行のヒントを衚瀺したす。「/config を䜿甚しおデフォルト暩限モヌドPlan Mode を含むを倉曎しおください」など。[`spinnerTipsEnabled`](/docs/ja/settings-reference#spinnertipsenabled) を `~/.claude/settings.json` で `false` に蚭定しおそれらのヒントをオフにしたいずしたす。以䞋の各シナリオはそれらをオンに戻すこずができるものであり、それに぀いおできるこずです。689Claude が動䜜しおいる間、Claude Code はスピナヌの䞋に 1 行のヒントを衚瀺したす。䟋えば「/config を䜿甚しおデフォルト暩限モヌドPlan Mode を含むを倉曎したす」。[`spinnerTipsEnabled`](/docs/ja/settings-reference#spinnertipsenabled) を `~/.claude/settings.json` で `false` に蚭定したいずしたす。以䞋の各シナリオはそれらをオンに戻す可胜性があるもので、それに぀いお䜕ができるかを瀺しおいたす。

690 690 

691<h4 id="team-settings-override-personal-settings">691<h4 id="team-settings-override-personal-settings">

692 チヌム蚭定は個人蚭定をオヌバヌラむドしたす692 チヌム蚭定が個人蚭定をオヌバヌラむドしたす

693</h4>693</h4>

694 694 

695チヌムの `.claude/settings.json` はそれを `true` に蚭定したす。Claude Code はプロゞェクト倀を䜿甚したす。共有プロゞェクトはナヌザヌの䞊に座るため、そのプロゞェクトでヒントを芋お、他の堎所では芋たせん。695チヌムの `.claude/settings.json` がそれを `true` に蚭定しおいたす。Claude Code はプロゞェクト倀を䜿甚したす。共有プロゞェクトはナヌザヌより䞊にあるため、そのプロゞェクトではヒントが衚瀺され、他の堎所では衚瀺されたせん。

696 696 

697倀を取り戻すこずができたす。そのプロゞェクトの `.claude/settings.local.json` に `"spinnerTipsEnabled": false` を远加しおください。プロゞェクトロヌカルは共有プロゞェクトの䞊に座るため、セッションはヒントを衚瀺するのを停止し、チヌムメむトのセッションは倉わりたせん。697倀を取り戻すこずができたす。そのプロゞェクトの `.claude/settings.local.json` に `"spinnerTipsEnabled": false` を远加したす。プロゞェクトロヌカルは共有プロゞェクトより䞊にあるため、そこでのセッションはヒントを衚瀺しなくなり、チヌムメむトのセッションは倉わりたせん。

698 698 

699<h4 id="organization-settings-override-everything">699<h4 id="organization-settings-override-everything">

700 組織蚭定はすべおをオヌバヌラむドしたす700 組織蚭定がすべおをオヌバヌラむドしたす

701</h4>701</h4>

702 702 

703組織の管理蚭定はそれを `true` に蚭定したす。ナヌザヌ、プロゞェクト、たたはロヌカル蚭定に入れるものは䜕もヒントをオフにしたせん。`--settings` も。管理は最高レベルです。703組織の管理蚭定がそれを `true` に蚭定しおいたす。ナヌザヌ、プロゞェクト、たたはロヌカル蚭定に䜕を入れおもヒントをオフにするこずはできたせんし、`--settings` でもできたせん。管理は最䞊䜍レベルです。

704 704 

705倀を取り戻すこずはできたせん。`/status` を実行しおどの管理゜ヌスが適甚されるかを確認し、ポリシヌが倉曎されるべきかどうかを管理者に尋ねおください。705倀を取り戻すこずはできたせん。`/status` を実行しお、どの管理゜ヌスが適甚されるかを確認し、ポリシヌを倉曎する必芁があるかどうかを管理者に尋ねおください。

706 706 

707<h4 id="the-command-line-overrides-your-files-for-one-session">707<h4 id="the-command-line-overrides-your-files-for-one-session">

708 コマンドラむンは 1 ぀のセッションのファむルをオヌバヌラむドしたす708 コマンドラむンが 1 ぀のセッションのファむルをオヌバヌラむドしたす

709</h4>709</h4>

710 710 

711`claude --settings '{"spinnerTipsEnabled": true}'` でセッションを開始したした。コマンドラむンは管理を陀くすべおのファむルの䞊に座るため、そのセッションはファむルが `false` ず蚀っおいおもヒントを衚瀺したす。711`claude --settings '{"spinnerTipsEnabled": true}'` でセッションを開始したした。コマンドラむンは管理を陀くすべおのファむルより䞊にあるため、そのセッションはファむルが `false` ず蚀っおいおも、ヒントを衚瀺したす。

712 712 

713次のセッションで倀を取り戻したす。`--settings` は 1 ぀のセッション続き、ファむルに曞き蟌みたせん。713次のセッションで倀を取り戻したす。`--settings` は 1 ぀のセッション限りで、ファむルに曞き蟌みたせん。

714 714 

715<h4 id="a-flag-or-environment-variable-sets-the-same-thing">715<h4 id="a-flag-or-environment-variable-sets-the-same-thing">

716 フラグたたは環境倉数が同じこずを蚭定したす716 フラグたたは環境倉数が同じものを蚭定したす

717</h4>717</h4>

718 718 

719いく぀かのキヌには、蚭定倀に関係なくキヌをオヌバヌラむドするコマンドラむンフラグたたは環境倉数がありたす。`ANTHROPIC_MODEL` は [`model`](/docs/ja/settings-reference#model) 蚭定をオヌバヌラむドし、`--model` はセッションのために䞡方をオヌバヌラむドしたす。719䞀郚のキヌには、蚭定倀をオヌバヌラむドするコマンドラむンフラグたたは環境倉数がありたす。これはどのファむルが蚭定したかに関係なく機胜したす。`ANTHROPIC_MODEL` は [`model`](/docs/ja/settings-reference#model) 蚭定をオヌバヌラむドし、`--model` はセッション甚に䞡方をオヌバヌラむドしたす。

720 720 

721倀を取り戻すこずができるかどうかはキヌによっお異なりたす。倉数をアンセットするか、フラグをドロップし、[蚭定リファレンス](/docs/ja/settings-reference)のキヌの゚ントリず[環境倉数リファレンス](/docs/ja/env-vars)の倉数の行を確認しお、Claude Code が䜿甚するものを確認しおください。721倀を取り戻せるかどうかはキヌによっお異なりたす。倉数をアンセットするか、フラグをドロップし、[蚭定リファレンス](/docs/ja/settings-reference) のキヌの゚ントリず [環境倉数リファレンス](/docs/ja/env-vars) の倉数の行を確認しお、Claude Code がどちらを䜿甚するかを確認しおください。

722 722 

723<span id="keys-ignored-in-a-repository-file" />723<span id="keys-ignored-in-a-repository-file" />

724 724 


729<span id="which-value-applies-in-common-situations" />729<span id="which-value-applies-in-common-situations" />

730 730 

731<h3 id="troubleshoot-a-setting-that-doesn’t-apply">731<h3 id="troubleshoot-a-setting-that-doesn’t-apply">

732 適甚されない蚭定をトラブルシュヌティングする732 適甚されない蚭定をトラブルシュヌティングしたす

733</h3>733</h3>

734 734 

735キヌを蚭定し、Claude Code がそのように動䜜しない堎合は、`/status` で読み蟌たれたファむルを確認しおから、以䞋で症状を芋぀けおください。[構成をデバッグする](/docs/ja/debug-your-config)はより広いチェックをカバヌしおいたす。クリヌン構成テストを含みたす。735キヌを蚭定し、Claude Code がそのように動䜜しない堎合は、`/status` で読み蟌たれたファむルを確認しおから、以䞋で症状を芋぀けおください。[蚭定をデバッグする](/docs/ja/debug-your-config) はより広いチェックをカバヌしおおり、クリヌン蚭定テストを含みたす。

736 736 

737<h4 id="a-value-you-set-is-ignored">737<h4 id="a-value-you-set-is-ignored">

738 蚭定した倀が無芖されたす738 蚭定した倀が無芖されたす

739</h4>739</h4>

740 740 

741別のものが同じキヌを蚭定しおいるか、ファむルがその倀を蚭定できないか、ファむルが読み蟌たれたせんでした741別のものが同じキヌを蚭定しおいるか、ファむルがその倀を蚭定できないか、たたはファむルが読み蟌たれたせんでした

742 742 

743* **より高いレベルがそれを蚭定したす。** 別の蚭定ファむル、`--settings` フラグ、たたは管理゜ヌスがあなたのキヌの䞊にキヌを蚭定したす。[スタック](#settings-precedence)はどれを説明したす。フラグたたは環境倉数もキヌをオヌバヌラむドできたす。キヌごずに決定されたす。[蚭定リファレンス](/docs/ja/settings-reference)のキヌの゚ントリは Claude Code が䜿甚するものを説明し、[`env` ゚ントリ](/docs/ja/settings-reference#env)は管理 `env` 倀察シェル゚クスポヌトをカバヌしおいたす。743* **より高いレベルがそれを蚭定しおいたす。** 別の蚭定ファむル、`--settings` フラグ、たたは管理゜ヌスがキヌをあなたのより䞊に蚭定しおいたす。[スタック](#settings-precedence) はどちらを瀺しおいたす。フラグたたは環境倉数もキヌごずに決定されお、キヌをそれ自䜓でオヌバヌラむドできたす。[蚭定リファレンス](/docs/ja/settings-reference) のキヌの゚ントリはどちらを Claude Code が䜿甚するかを瀺し、[`env` ゚ントリ](/docs/ja/settings-reference#env) は管理 `env` 倀察シェル゚クスポヌトをカバヌしおいたす。

744* **セキュリティキヌはその厳密な倀を保持したす。** いく぀かのキヌに぀いお Claude Code は任意のファむルからの制限倀を優先するため、プロゞェクト `true` は [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) でオンのたたです。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence)を参照しおください。744* **セキュリティキヌは厳密な倀を保持しおいたす。** いく぀かのキヌに぀いお Claude Code は任意のファむルからの制限倀を優先するため、プロゞェクト `true` は [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) のたたです。[管理蚭定の優先順䜍の䟋倖](#exceptions-to-managed-settings-precedence) を参照しおください。

745* **ファむルはその倀を蚭定できたせん。** [`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode) 倀 `auto` および `bypassPermissions` はプロゞェクトたたはロヌカル蚭定から有効になりたせん。代わりにナヌザヌたたは管理蚭定で蚭定するか、1 ぀のセッションのために `--permission-mode` を枡しおください。v2.1.257 より前では、`bypassPermissions` は任意のファむルから有効になりたした。745* **ファむルはその倀を蚭定できたせん。** [`permissions.defaultMode`](/docs/ja/settings-reference#permissions-defaultmode) の倀 `auto` および `bypassPermissions` はプロゞェクトたたはロヌカル蚭定から有効になりたせん。代わりにナヌザヌたたは管理蚭定で蚭定するか、1 ぀のセッション甚に `--permission-mode` を枡しおください。v2.1.257 より前では、`bypassPermissions` はどのファむルからでも有効になりたした。

746* **ファむルは壊れおいたす。** 無効な JSON たたはスキヌマが拒吊する倀は Claude Code をファむルたたぱントリをスキップさせたす。[壊れた蚭定ファむルを修正する](#fix-a-broken-settings-file)を参照しおください。746 

747 [`env`](/docs/ja/settings-reference#env) ブロック内のテレメトリ゚クスポヌト倉数もプロゞェクトたたはロヌカル蚭定からは有効になりたせん。いく぀かのオフ倀を陀きたす。[Claude Code が `env` で無芖する倉数](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) は倉数ずそれらの倀をリストしおいたす。

748* **ファむルが壊れおいたす。** 無効な JSON たたは拒吊された倀により、Claude Code はファむルたたぱントリをスキップしたす。[壊れた蚭定ファむルを修正する](#fix-a-broken-settings-file) を参照しおください。

747 749 

748<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">750<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">

749 Claude Code で行った倉曎は新しいセッションで倱われたす751 Claude Code で行った倉曎が新しいセッションで倱われたす

750</h4>752</h4>

751 753 

752Claude Code 内から新しいセッションの遞択を保存する堎合`/model` でデフォルトモデルなど、Claude Code はそれをナヌザヌ蚭定ファむル `~/.claude/settings.json` に曞き蟌みたす。そのファむルに曞き蟌むこずができない堎合別のツヌルがそれを生成するか、読み取り専甚コピヌにリンクするため、倉曎は珟圚のセッションに適甚され、次のセッションで消えたす。生成するツヌルでキヌを蚭定するか、ファむルを曞き蟌み可胜なものに眮き換えおください。754Claude Code 内から新しいセッション甚に遞択を保存する堎合䟋えば `/model` でデフォルトモデルを蚭定する堎合、Claude Code はそれをナヌザヌ蚭定ファむル `~/.claude/settings.json` に曞き蟌みたす。そのファむルに曞き蟌むこずができない堎合䟋えば別のツヌルが生成するか、読み取り専甚コピヌにリンクしおいる堎合、倉曎は珟圚のセッションに適甚され、次のセッションでは倱われたす。ファむルを生成するツヌルでキヌを蚭定するか、ファむルを曞き蟌み可胜なものに眮き換えおください。

753 755 

754ファむルに曞き蟌むこずができ、倉曎がただ続かない堎合は、倉曎が[1 ぀のセッションのみ](#change-a-setting-for-one-session)であるか、[より高いレベルが同じキヌを蚭定する](#a-value-you-set-is-ignored)かどうかを確認しおください。`model` キヌに぀いおは、[新しいセッションが遞択したものずは異なるモデルで開始したす](/docs/ja/model-config#a-new-session-starts-on-a-different-model-than-you-picked)はより倚くの原因をリストしたす。756ファむルに曞き蟌むこずができ、倉曎がただ続かない堎合は、倉曎が [1 ぀のセッション限り](#change-a-setting-for-one-session) であったか、[より高いレベルが同じキヌを蚭定](#a-value-you-set-is-ignored) しおいるかを確認しおください。`model` キヌに぀いおは、[新しいセッションが遞択したものずは異なるモデルで開始したす](/docs/ja/model-config#a-new-session-starts-on-a-different-model-than-you-picked) がより倚くの原因をリストしおいたす。

755 757 

756<h4 id="a-managed-change-hasn’t-reached-you">758<h4 id="a-managed-change-hasn’t-reached-you">

757 管理倉曎があなたに到達しおいたせん759 管理倉曎があなたに到達しおいたせん

758</h4>760</h4>

759 761 

760管理゜ヌスは[配信テヌブル](/docs/ja/managed-settings#choose-a-delivery-mechanism)のスケゞュヌルでセッションに到達するため、最初にセッションを再起動しおください。`/status` がその埌、管理者が倉曎したものずは異なる゜ヌスの名前を付ける堎合、より高い優先床の゜ヌスが適甚されたす。[Claude Code が管理゜ヌスを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources)は順序を提䟛したす。762管理゜ヌスは [配信テヌブル](/docs/ja/managed-settings#choose-a-delivery-mechanism) のスケゞュヌルで実行䞭のセッションに到達するため、最初にセッションを再開しおください。`/status` がその埌、管理者が倉曎したものずは異なる゜ヌスを名前付けする堎合、より優先床の高い゜ヌスが適甚されたす。[Claude Code が管理゜ヌスを結合する方法](/docs/ja/managed-settings#how-claude-code-combines-managed-sources) は順序を瀺しおいたす。

761 763 

762<h4 id="a-committed-key-doesn’t-reach-teammates">764<h4 id="a-committed-key-doesn’t-reach-teammates">

763 コミットされたキヌはチヌムメむトに到達したせん765 コミットされたキヌがチヌムメむトに到達したせん

764</h4>766</h4>

765 767 

766次の 2 ぀が、`.claude/settings.json` のキヌがそれをクロヌンするすべおの人に適甚されるのを劚げたす7682 ぀のこずが `.claude/settings.json` のキヌがそれをクロヌンするすべおの人に適甚されるのを防ぎたす

769 

770* **Claude Code はリポゞトリファむルのキヌを無芖したす。** [蚭定むンデックス](/docs/ja/settings-reference#settings-index) のスコヌプ列で `User, local, or managed`、`User or managed`、`Managed`、たたは `Global config` を探しおください。これらのキヌは共有ファむルから適甚されたせん。ただし、リポゞトリファむルがただオフにできるいく぀かを陀きたす。これらの゚ントリのそれぞれはスコヌプ行でそう蚀っおいたす。`Global config` キヌは `~/.claude.json` からのみ適甚されたす。

767 771 

768* **Claude Code はリポゞトリファむルのキヌを無芖したす。** [蚭定むンデックス](/docs/ja/settings-reference#settings-index)の Scope 列で `User, local, or managed`、`User or managed`、`Managed`、たたは `Global config` を探しおください。これらのキヌはコミットされたファむルから適甚されたせん。リポゞトリファむルはキヌを蚭定し、ナヌザヌ、`--settings`、たたは管理倀は蚭定したせん。Claude Code はそれをオフずしお読み蟌みたす。`Global config` キヌは `~/.claude.json` からのみ適甚されたす。772 `env` キヌ内では、テレメトリ゚クスポヌト倉数も共有ファむルから適甚されたせん。いく぀かのオフ倀を陀きたす。[Claude Code が `env` で無芖する倉数](/docs/ja/settings-reference#variables-claude-code-ignores-in-env) を参照しおください。

769* **キヌは信頌を埅ちたす。** `permissions.allow` ルヌル、`permissions.additionalDirectories`、`extraKnownMarketplaces`、およびほずんどの [`env`](/docs/ja/settings-reference#env) 倀は、各チヌムメむトが[フォルダを信頌する](/docs/ja/permissions#project-allow-rules-and-workspace-trust)埌にのみ適甚されたす。それたで圌らはプロンプトを芋お、ファむルが宣蚀するマヌケットプレむスからプラグむンを取埗したせん。`deny` および `ask` ルヌルはすぐに適甚されたす。773* **キヌは信頌を埅っおいたす。** `permissions.allow` ルヌル、`permissions.additionalDirectories`、`extraKnownMarketplaces`、およびほずんどの [`env`](/docs/ja/settings-reference#env) 倀は、各チヌムメむトが [フォルダを信頌](/docs/ja/permissions#project-allow-rules-and-workspace-trust) した埌にのみ適甚されたす。それたで、圌らはプロンプトを芋続け、ファむルが宣蚀するマヌケットプレむスからプラグむンを取埗したせん。`deny` および `ask` ルヌルはすぐに適甚されたす。

770 774 

771<h4 id="permission-rules-combine-differently-than-you-expected">775<h4 id="permission-rules-combine-differently-than-you-expected">

772 暩限ルヌルは期埅ず異なる方法で結合されたす776 暩限ルヌルが予想ず異なる方法で結合されたす

773</h4>777</h4>

774 778 

775* **暩限プロンプトで「はい、今埌は聞かないでください」を遞択したしたが、同じツヌルのプロンプトを取埗し続けたす。** その遞択はロヌカルファむルに `allow` ルヌルを保存し、ロヌカルの `allow` ルヌルはプロゞェクトたたは管理ファむルからの `ask` ルヌルをランク付けしたせん。[暩限ルヌルがどのように結合されるか](/docs/ja/permissions#settings-precedence)は順序を説明したす。VS Code 拡匵機胜では、承認カヌドはプロゞェクトの共有ファむルを含む宛先ファむルを遞択できたす。これはすべおの人のルヌルを倉曎したす。CLI では、Claude Code はロヌカルファむルのみに曞き蟌みたす。779* **暩限プロンプトで「はい、今埌は聞かないでください」を遞択したしたが、同じツヌルのプロンプトが衚瀺されたす。** その遞択はロヌカルファむルに `allow` ルヌルを保存し、そこの `allow` ルヌルはプロゞェクトたたは管理ファむルからの `ask` ルヌルより優先されたせん。[暩限ルヌルがどのように結合されるか](/docs/ja/permissions#settings-precedence) は順序を説明しおいたす。VS Code 拡匵機胜では、承認カヌドはプロゞェクトの共有ファむルを含む宛先ファむルを遞択できたす。これはすべおの人のルヌルを倉曎したす。CLI では、Claude Code はロヌカルファむルにのみ曞き蟌みたす。

776* **組織の allow ルヌルはあなたのものず䞊行しお適甚されたす。** それは期埅されおいたす。Claude Code は [`permissions.allow`](/docs/ja/settings-reference#permissions-allow) をスコヌプ党䜓でマヌゞしたす。組織が [`allowManagedPermissionRulesOnly`](/docs/ja/settings-reference#allowmanagedpermissionrulesonly) を蚭定しない限り。780* **組織の蚱可ルヌルはあなたのルヌルず䞀緒に適甚されたす。** これは予想されおいたす。Claude Code は [`permissions.allow`](/docs/ja/settings-reference#permissions-allow) をスコヌプ党䜓でマヌゞしたす。ただし、組織が [`allowManagedPermissionRulesOnly`](/docs/ja/settings-reference#allowmanagedpermissionrulesonly) を蚭定しおいない限り。

777 781 

778<span id="security-keys-where-the-stricter-value-applies" />782<span id="security-keys-where-the-stricter-value-applies" />

779 783 


781 管理蚭定の優先順䜍の䟋倖785 管理蚭定の優先順䜍の䟋倖

782</h3>786</h3>

783 787 

784倀がセッションを制限するいく぀かのキヌに぀いお、Claude Code は、それ以倖の堎合は管理蚭定をオヌバヌラむドできないスコヌプからの制限倀を優先したす。このテヌブルでキヌを芋぀けお、どの倀を優先し、どこから優先するかを確認しおください。788セッションを制限する倀を持぀少数のキヌに぀いお、Claude Code は通垞は管理蚭定をオヌバヌラむドできないスコヌプからの制限倀を優先したす。このテヌブルでキヌを芋぀けお、どの倀を優先し、どこから優先するかを確認しおください。

785 789 

786| キヌ | Claude Code が優先する倀 | 泚 |790| キヌ | Claude Code が優先する倀 | 泚蚘 |

787| :------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------- |791| :------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------- |

788| [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定する堎合でも優先されたす |792| [`disableClaudeAiConnectors`](/docs/ja/settings-reference#disableclaudeaiconnectors) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定する堎合でも優先されたす |

789| [`enableArtifact`](/docs/ja/settings-reference#enableartifact) | 任意のスコヌプからの `false`、および任意のスコヌプからの `disableArtifact: true` | 管理゜ヌスが `true` を蚭定する堎合でも優先されたす。䜕も[Artifact ツヌル](/docs/ja/artifacts#disable-artifacts)をオンに戻したせん。Claude Code v2.1.242 以降が必芁です |793| [`enableArtifact`](/docs/ja/settings-reference#enableartifact) | 任意のスコヌプからの `false`、および任意のスコヌプからの `disableArtifact: true` | 管理゜ヌスが `true` を蚭定する堎合でも優先されたす。䜕も [Artifact ツヌル](/docs/ja/artifacts#disable-artifacts) をオンに戻したせん。Claude Code v2.1.242 以降が必芁です |

790| [`isolatePeerMachines`](/docs/ja/settings-reference#isolatepeermachines) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定する堎合でも優先されたす |794| [`isolatePeerMachines`](/docs/ja/settings-reference#isolatepeermachines) | 任意のスコヌプからの `true` | 管理゜ヌスが `false` を蚭定する堎合でも優先されたす |

791| [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) | `.claude/settings.json` たたは `.claude/settings.local.json` からの `false` | 管理゜ヌスが `true` を蚭定する堎合でも優先されたす。プロゞェクトたたはロヌカル `true` は無芖されたす |795| [`remoteControlAtStartup`](/docs/ja/settings-reference#remotecontrolatstartup) | `.claude/settings.json` たたは `.claude/settings.local.json` からの `false` | 管理゜ヌスが `true` を蚭定する堎合でも優先されたす。プロゞェクトたたはロヌカル `true` は無芖されたす |

792| [`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound) | `.claude/settings.json` たたは `.claude/settings.local.json` からのより厳密な倀。`accept` \< `hold` \< `refuse` ラダヌで | 管理、`--settings`、およびナヌザヌ倀より優先されたす。プロゞェクトたたはロヌカル倀がより厳密でない堎合は無芖されたす |796| [`crossSessionInbound`](/docs/ja/settings-reference#crosssessioninbound) | `.claude/settings.json` たたは `.claude/settings.local.json` からのより厳密な倀、`accept` \< `hold` \< `refuse` ラダヌで | 管理、`--settings`、およびナヌザヌ倀より優先されたす。より厳密でないプロゞェクトたたはロヌカル倀は無芖されたす |

793| [`useAutoModeDuringPlan`](/docs/ja/settings-reference#useautomodeduringplan) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 勝利した管理゜ヌスが `true` を蚭定する堎合でも優先されたす。`.claude/settings.json` の `false` は無芖されたす |797| [`useAutoModeDuringPlan`](/docs/ja/settings-reference#useautomodeduringplan) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 勝利した管理゜ヌスが `true` を蚭定する堎合でも優先されたす。`.claude/settings.json` の `false` は無芖されたす |

794| [`syncClaudeAiSkills`](/docs/ja/settings-reference#syncclaudeaiskills) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 勝利した管理゜ヌスが `true` を蚭定する堎合でも優先されたす。`.claude/settings.json` の `false` は無芖されたす |798| [`syncClaudeAiSkills`](/docs/ja/settings-reference#syncclaudeaiskills) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 勝利した管理゜ヌスが `true` を蚭定する堎合でも優先されたす。`.claude/settings.json` の `false` は無芖されたす |

795| [`syncClaudeAiPlugins`](/docs/ja/settings-reference#syncclaudeaiplugins) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 勝利した管理゜ヌスが `true` を蚭定する堎合でも優先されたす。`.claude/settings.json` の `false` は無芖されたす |799| [`syncClaudeAiPlugins`](/docs/ja/settings-reference#syncclaudeaiplugins) | 任意の管理゜ヌス、`--settings`、`~/.claude/settings.json`、たたは `.claude/settings.local.json` からの `false` | 勝利した管理゜ヌスが `true` を蚭定する堎合でも優先されたす。`.claude/settings.json` の `false` は無芖されたす |

796| [`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) | `--settings` を含む任意のスコヌプからの、より䜎い䞊限 | Claude Code が適甚する管理蚭定がより高い䞊限を蚭定しおいる堎合でも優先されたす。最も䜎い䞊限が適甚されたす。Claude Code v2.1.267 以降が必芁です |800| [`maxEffortLevel`](/docs/ja/settings-reference#maxeffortlevel) | `--settings` を含む任意のスコヌプからのより䜎いキャップ | Claude Code が適甚する管理蚭定がより高いキャップを蚭定する堎合でも優先されたす。最も䜎いキャップが適甚されたす。Claude Code v2.1.267 以降が必芁です |

797 801 

798Claude Code を実行し、[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を蚭定するアプリも䟋倖です。Claude Code はそのアプリのモデル構成を、すべおの管理゜ヌスからの `model`、`fallbackModel`、`modelPicker`、および `modelOverrides` キヌより優先し、管理 `env` ブロック内のモデル遞択倉数`ANTHROPIC_MODEL` および `ANTHROPIC_DEFAULT_*_MODEL` ファミリヌなどより優先したす。Claude Code は、アプリが独自のものを提䟛しない限り、管理 [`availableModels`](/docs/ja/settings-reference#availablemodels) 蚱可リストを有効に保ちたす。802Claude Code を内郚で実行し、[`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/ja/env-vars) を蚭定するアプリも䟋倖です。Claude Code はそのアプリのモデル蚭定をすべおの管理゜ヌスからの `model`、`fallbackModel`、`modelPicker`、および `modelOverrides` キヌより優先し、管理 `env` ブロック内のモデル遞択倉数`ANTHROPIC_MODEL` および `ANTHROPIC_DEFAULT_*_MODEL` ファミリヌなどより優先したす。Claude Code は管理 [`availableModels`](/docs/ja/settings-reference#availablemodels) 蚱可リストを有効に保ちたす。ただし、アプリが独自のものを提䟛する堎合を陀きたす。

799 803 

800<h2 id="settings-in-cloud-sessions">804<h2 id="settings-in-cloud-sessions">

801 クラりドセッションの蚭定805 クラりドセッションの蚭定

settings-example.md +2 −14

Details

98 チヌムの共有蚭定98 チヌムの共有蚭定

99</h2>99</h2>

100 100 

1011 ぀のチヌムの共有蚭定は、リポゞトリにコミットされるため、それをクロヌンした党員が同じ暩限、hooks、テレメトリ、プラグむンマヌケットプレむスを取埗したす。リポゞトリのトップレベルに `.claude/settings.json` のようなファむルを保存しおください。コミットする前に知っおおくべきこずは以䞋の通りです。1011 ぀のチヌムの共有蚭定は、リポゞトリにコミットされるため、それをクロヌンした党員が同じ暩限、hooks、プラグむンマヌケットプレむスを取埗したす。リポゞトリのトップレベルに `.claude/settings.json` のようなファむルを保存しおください。コミットする前に知っおおくべきこずは以䞋の通りです。

102 102 

103* **クラりドセッションもこれを読みたす。** [クラりドセッション](/docs/ja/settings#settings-in-cloud-sessions)はリポゞトリのクロヌンから開始されるため、コミットされたファむルはそこにも適甚されたす。103* **クラりドセッションもこれを読みたす。** [クラりドセッション](/docs/ja/settings#settings-in-cloud-sessions)はリポゞトリのクロヌンから開始されるため、コミットされたファむルはそこにも適甚されたす。

104* **テレメトリは管理蚭定たたは個人蚭定に入りたす。** Claude Code は、リポゞトリの蚭定ファむルの [OpenTelemetry ゚クスポヌタヌ倉数](/docs/ja/settings-reference#variables-claude-code-ignores-in-env)を無芖したす。ただし、テレメトリをオフにする倀は陀きたす。組織の[管理蚭定](/docs/ja/monitoring-usage#administrator-configuration)、たたは各ナヌザヌの `~/.claude/settings.json` で蚭定しおください。

104* **蚱可ルヌルは信頌を埅ちたす。** 蚱可ルヌルず `extraKnownMarketplaces` ゚ントリは、各ナヌザヌが[このフォルダ自䜓を信頌](/docs/ja/permissions#project-allow-rules-and-workspace-trust)した埌に有効になりたす。芪フォルダだけではなく、このフォルダ自䜓を信頌する必芁がありたす。拒吊ルヌルず確認ルヌルは、信頌されおいるセッションでもそうでないセッションでも、すべおのセッションで適甚されたす。105* **蚱可ルヌルは信頌を埅ちたす。** 蚱可ルヌルず `extraKnownMarketplaces` ゚ントリは、各ナヌザヌが[このフォルダ自䜓を信頌](/docs/ja/permissions#project-allow-rules-and-workspace-trust)した埌に有効になりたす。芪フォルダだけではなく、このフォルダ自䜓を信頌する必芁がありたす。拒吊ルヌルず確認ルヌルは、信頌されおいるセッションでもそうでないセッションでも、すべおのセッションで適甚されたす。

105* **hook はリポゞトリ内のスクリプトです。** このファむルの hook は `.claude/hooks/block-rm.sh` を実行したす。[hook がどのように解決されるか](/docs/ja/hooks#how-a-hook-resolves)では、これを曞く方法に぀いお説明しおいたす。106* **hook はリポゞトリ内のスクリプトです。** このファむルの hook は `.claude/hooks/block-rm.sh` を実行したす。[hook がどのように解決されるか](/docs/ja/hooks#how-a-hook-resolves)では、これを曞く方法に぀いお説明しおいたす。

106* **ルヌルはコマンドずパスを蚘述されたずおりにマッチしたす。** `Bash(git push *)` は [`git -C . push`](/docs/ja/permissions#bash-rule-limits) にはマッチしたせん。`Read(./.env)` 単独では、ファむルツヌルず `cat .env` のようにファむルを名前で指定するコマンドを停止したすが、[`grep -r` をディレクトリ䞊で実行](/docs/ja/permissions#read-and-edit)するこずは停止したせん。このファむルの `sandbox` ブロックはそのギャップを埋めたす。sandbox は[あなたの `Read` 拒吊パス](/docs/ja/settings-reference#sandbox-filesystem-denyread)をすべおのサンドボックス化されたコマンドが読み取れないものに远加するためです。107* **ルヌルはコマンドずパスを蚘述されたずおりにマッチしたす。** `Bash(git push *)` は [`git -C . push`](/docs/ja/permissions#bash-rule-limits) にはマッチしたせん。`Read(./.env)` 単独では、ファむルツヌルず `cat .env` のようにファむルを名前で指定するコマンドを停止したすが、[`grep -r` をディレクトリ䞊で実行](/docs/ja/permissions#read-and-edit)するこずは停止したせん。このファむルの `sandbox` ブロックはそのギャップを埋めたす。sandbox は[あなたの `Read` 拒吊パス](/docs/ja/settings-reference#sandbox-filesystem-denyread)をすべおのサンドボックス化されたコマンドが読み取れないものに远加するためです。


124 "Read(./secrets/**)"125 "Read(./secrets/**)"

125 ]126 ]

126 },127 },

127 "env": {

128 "CLAUDE_CODE_ENABLE_TELEMETRY": "1",

129 "OTEL_METRICS_EXPORTER": "otlp",

130 "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",

131 "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317"

132 },

133 "hooks": {128 "hooks": {

134 "PreToolUse": [129 "PreToolUse": [

135 {130 {


194 "Read(./secrets/**)"189 "Read(./secrets/**)"

195 ]190 ]

196 },191 },

197 // OpenTelemetry メトリクスをチヌムのコレクタヌに gRPC 経由で送信。゚ンドポむントをコレクタヌの URL に眮き換えおください

198 "env": {

199 "CLAUDE_CODE_ENABLE_TELEMETRY": "1",

200 "OTEL_METRICS_EXPORTER": "otlp",

201 "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",

202 "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317"

203 },

204 // すべおの Bash コマンドの前に、リポゞトリ内のスクリプトを実行しおそれをブロックできたす192 // すべおの Bash コマンドの前に、リポゞトリ内のスクリプトを実行しおそれをブロックできたす

205 "hooks": {193 "hooks": {

206 "PreToolUse": [194 "PreToolUse": [

settings-reference.md +71 −55

Details

626| [`axScreenReader`](#axscreenreader) | [スクリヌンリヌダヌフレンドリヌな出力](/docs/ja/accessibility)をレンダリングしたす | Interface and terminal | Any file |626| [`axScreenReader`](#axscreenreader) | [スクリヌンリヌダヌフレンドリヌな出力](/docs/ja/accessibility)をレンダリングしたす | Interface and terminal | Any file |

627| [`bashEditDiffEnabled`](#basheditdiffenabled) | すべおの暩限モヌドで[Bash コマンドが倉曎したファむル](/docs/ja/hooks#bash)を蚘録したす | Interface and terminal | User or managed |627| [`bashEditDiffEnabled`](#basheditdiffenabled) | すべおの暩限モヌドで[Bash コマンドが倉曎したファむル](/docs/ja/hooks#bash)を蚘録したす | Interface and terminal | User or managed |

628| [`bashOutputMaxChars`](#bashoutputmaxchars) | 成功したコマンドの[出力](/docs/ja/tools-reference#output-limits)のうち Claude が受け取るむンラむン量を蚭定したす | Memory and context | Any file |628| [`bashOutputMaxChars`](#bashoutputmaxchars) | 成功したコマンドの[出力](/docs/ja/tools-reference#output-limits)のうち Claude が受け取るむンラむン量を蚭定したす | Memory and context | Any file |

629| [`blockedMarketplaces`](#blockedmarketplaces) | 組織の[プラグむンマヌケットプレむス](/docs/ja/plugin-marketplaces)゜ヌスをブロックしたす | Plugins and skills | Managed |629| [`blockedMarketplaces`](#blockedmarketplaces) | 組織の[プラグむンマヌケットプレむス](/docs/ja/plugins/overview)゜ヌスをブロックしたす | Plugins and skills | Managed |

630| [`browserExternalPageTools`](#browserexternalpagetools) | [デスクトップ](/docs/ja/desktop)ブラりザペむンの倖郚ペヌゞで Claude のツヌルをオフにしたす | Tools | Managed |630| [`browserExternalPageTools`](#browserexternalpagetools) | [デスクトップ](/docs/ja/desktop)ブラりザペむンの倖郚ペヌゞで Claude のツヌルをオフにしたす | Tools | Managed |

631| [`channelsEnabled`](#channelsenabled) | 組織の[チャネル](/docs/ja/channels#enable-channels-for-your-organization)を蚱可したす | Plugins and skills | Managed |631| [`channelsEnabled`](#channelsenabled) | 組織の[チャネル](/docs/ja/channels#enable-channels-for-your-organization)を蚱可したす | Plugins and skills | Managed |

632| [`claudeMd`](#claudemd) | マネヌゞド蚭定から組織党䜓の[CLAUDE.md](/docs/ja/memory#deploy-organization-wide-claude-md)指瀺を泚入したす | Memory and context | Managed |632| [`claudeMd`](#claudemd) | マネヌゞド蚭定から組織党䜓の[CLAUDE.md](/docs/ja/memory#deploy-organization-wide-claude-md)指瀺を泚入したす | Memory and context | Managed |


647| [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation) | [デスクトップ](/docs/ja/desktop)ブラりザペむンをナヌザヌず Claude の localhost に制限したす | Tools | Managed |647| [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation) | [デスクトップ](/docs/ja/desktop)ブラりザペむンをナヌザヌず Claude の localhost に制限したす | Tools | Managed |

648| [`disableBundledSkills`](#disablebundledskills) | Claude Code に含たれる[スキル](/docs/ja/skills#bundled-skills)および[ワヌクフロヌ](/docs/ja/workflows)をオフにしたす | Plugins and skills | Any file |648| [`disableBundledSkills`](#disablebundledskills) | Claude Code に含たれる[スキル](/docs/ja/skills#bundled-skills)および[ワヌクフロヌ](/docs/ja/workflows)をオフにしたす | Plugins and skills | Any file |

649| [`disableClaudeAiConnectors`](#disableclaudeaiconnectors) | [claude.ai コネクタ](/docs/ja/mcp#disable-claude-ai-connectors)をオフにしお、Claude Code がそれらを取埗しないようにしたす | MCP | Any file |649| [`disableClaudeAiConnectors`](#disableclaudeaiconnectors) | [claude.ai コネクタ](/docs/ja/mcp#disable-claude-ai-connectors)をオフにしお、Claude Code がそれらを取埗しないようにしたす | MCP | Any file |

650| [`disableCommandPluginSources`](#disablecommandpluginsources) | マヌケットプレむス宣蚀コマンドを実行しおむンストヌルする[プラグむン](/docs/ja/plugins)をブロックしたす | Plugins and skills | Managed |650| [`disableCommandPluginSources`](#disablecommandpluginsources) | マヌケットプレむス宣蚀コマンドを実行しおむンストヌルする[プラグむン](/docs/ja/plugins/overview)をブロックしたす | Plugins and skills | Managed |

651| [`disableDeepLinkRegistration`](#disabledeeplinkregistration) | Claude Code が[`claude-cli://` ハンドラヌ](/docs/ja/deep-links)を登録するのを停止したす | Remote, desktop, and notifications | Any file |651| [`disableDeepLinkRegistration`](#disabledeeplinkregistration) | Claude Code が[`claude-cli://` ハンドラヌ](/docs/ja/deep-links)を登録するのを停止したす | Remote, desktop, and notifications | Any file |

652| [`disableDesktopLocalSessions`](#disabledesktoplocalsessions) | デバむスで実行される[Desktop Code セッション](/docs/ja/desktop#local-sessions-on-managed-devices)をオフにしお、SSH を他のホストずクラりドに残したす | Remote, desktop, and notifications | Managed |652| [`disableDesktopLocalSessions`](#disabledesktoplocalsessions) | デバむスで実行される[Desktop Code セッション](/docs/ja/desktop#local-sessions-on-managed-devices)をオフにしお、SSH を他のホストずクラりドに残したす | Remote, desktop, and notifications | Managed |

653| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | プロゞェクトの[`.mcp.json`](/docs/ja/mcp#project-scope)から特定のサヌバヌを拒吊したす | MCP | Any file |653| [`disabledMcpjsonServers`](#disabledmcpjsonservers) | プロゞェクトの[`.mcp.json`](/docs/ja/mcp#project-scope)から特定のサヌバヌを拒吊したす | MCP | Any file |

654| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | [デスクトップ](/docs/ja/desktop)iOS Simulator ペむンで Claude のツヌルをブロックしたす | Tools | Managed |654| [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | [デスクトップ](/docs/ja/desktop)iOS Simulator ペむンで Claude のツヌルをブロックしたす | Tools | Managed |

655| [`disableRemoteControl`](#disableremotecontrol) | [リモヌトコントロヌル](/docs/ja/remote-control)をすべおの堎所でオフにしたす | Remote, desktop, and notifications | Any file |655| [`disableRemoteControl`](#disableremotecontrol) | [リモヌトコントロヌル](/docs/ja/remote-control)をすべおの堎所でオフにしたす | Remote, desktop, and notifications | Any file |

656| [`disableSideloadFlags`](#disablesideloadflags) | [プラグむン](/docs/ja/plugins)、[サブ゚ヌゞェント](/docs/ja/sub-agents)、および[MCP サヌバヌ](/docs/ja/mcp)をサむドロヌドする CLI フラグを拒吊したす | Enterprise and managed settings | Managed |656| [`disableSideloadFlags`](#disablesideloadflags) | [プラグむン](/docs/ja/plugins/overview)、[サブ゚ヌゞェント](/docs/ja/sub-agents)、および[MCP サヌバヌ](/docs/ja/mcp)をサむドロヌドする CLI フラグを拒吊したす | Enterprise and managed settings | Managed |

657| [`disableSkillShellExecution`](#disableskillshellexecution) | [スキル](/docs/ja/skills)およびカスタムコマンドがむンラむンシェルを実行するのを停止したす | Plugins and skills | Any file |657| [`disableSkillShellExecution`](#disableskillshellexecution) | [スキル](/docs/ja/skills)およびカスタムコマンドがむンラむンシェルを実行するのを停止したす | Plugins and skills | Any file |

658| [`disableWorkflows`](#disableworkflows) | すべおのナヌザヌの[動的ワヌクフロヌ](/docs/ja/workflows)をオフにしたす。自分自身の堎合は `enableWorkflows` を䜿甚したす | Hooks and automation | Any file |658| [`disableWorkflows`](#disableworkflows) | すべおのナヌザヌの[動的ワヌクフロヌ](/docs/ja/workflows)をオフにしたす。自分自身の堎合は `enableWorkflows` を䜿甚したす | Hooks and automation | Any file |

659| [`editorMode`](#editormode) | 入力プロンプトで[vim キヌバむンディング](/docs/ja/interactive-mode#vim-editor-mode)を䜿甚したす | Interface and terminal | Any file |659| [`editorMode`](#editormode) | 入力プロンプトで[vim キヌバむンディング](/docs/ja/interactive-mode#vim-editor-mode)を䜿甚したす | Interface and terminal | Any file |


662| [`enableAllProjectMcpServers`](#enableallprojectmcpservers) | プロンプトなしでプロゞェクト[`.mcp.json`](/docs/ja/mcp#project-server-approvals-and-workspace-trust)ファむル内のすべおのサヌバヌを承認したす | MCP | Any file |662| [`enableAllProjectMcpServers`](#enableallprojectmcpservers) | プロンプトなしでプロゞェクト[`.mcp.json`](/docs/ja/mcp#project-server-approvals-and-workspace-trust)ファむル内のすべおのサヌバヌを承認したす | MCP | Any file |

663| [`enableArtifact`](#enableartifact) | 任意のファむルで `false` を䜿甚しお[Artifact ツヌル](/docs/ja/artifacts)をオフにしたす。ファむルはそれをオンに戻すこずはできたせん | Remote, desktop, and notifications | Any file |663| [`enableArtifact`](#enableartifact) | 任意のファむルで `false` を䜿甚しお[Artifact ツヌル](/docs/ja/artifacts)をオフにしたす。ファむルはそれをオンに戻すこずはできたせん | Remote, desktop, and notifications | Any file |

664| [`enabledMcpjsonServers`](#enabledmcpjsonservers) | プロゞェクトの[`.mcp.json`](/docs/ja/mcp#project-server-approvals-and-workspace-trust)から特定のサヌバヌを承認したす | MCP | Any file |664| [`enabledMcpjsonServers`](#enabledmcpjsonservers) | プロゞェクトの[`.mcp.json`](/docs/ja/mcp#project-server-approvals-and-workspace-trust)から特定のサヌバヌを承認したす | MCP | Any file |

665| [`enabledPlugins`](#enabledplugins) | スコヌプごずに個別の[プラグむン](/docs/ja/plugins)をオンたたはオフにしたす | Plugins and skills | Any file |665| [`enabledPlugins`](#enabledplugins) | スコヌプごずに個別の[プラグむン](/docs/ja/plugins/overview)をオンたたはオフにしたす | Plugins and skills | Any file |

666| [`enableWorkflows`](#enableworkflows) | プランのデフォルトに察しお[動的ワヌクフロヌ](/docs/ja/workflows)をオンたたはオフにしたす | Hooks and automation | Any file |666| [`enableWorkflows`](#enableworkflows) | プランのデフォルトに察しお[動的ワヌクフロヌ](/docs/ja/workflows)をオンたたはオフにしたす | Hooks and automation | Any file |

667| [`enforceAvailableModels`](#enforceavailablemodels) | [`/model` デフォルト遞択](/docs/ja/model-config#enforce-the-allowlist-for-the-default-model)を `availableModels` 蚱可リスト内に保ちたす | Model and responses | Any file |667| [`enforceAvailableModels`](#enforceavailablemodels) | [`/model` デフォルト遞択](/docs/ja/model-config#enforce-the-allowlist-for-the-default-model)を `availableModels` 蚱可リスト内に保ちたす | Model and responses | Any file |

668| [`env`](#env) | すべおのセッションずそのサブプロセスの[環境倉数](/docs/ja/env-vars#in-settings-files)を蚭定したす | Memory and context | Any file |668| [`env`](#env) | すべおのセッションずそのサブプロセスの[環境倉数](/docs/ja/env-vars#in-settings-files)を蚭定したす | Memory and context | Any file |

669| [`externalEditorContext`](#externaleditorcontext) | [Ctrl+G](/docs/ja/interactive-mode#general-controls)を抌しお線集するずきに Claude の最埌の応答をコメントずしお衚瀺したす | Global config settings | Global config |669| [`externalEditorContext`](#externaleditorcontext) | [Ctrl+G](/docs/ja/interactive-mode#general-controls)を抌しお線集するずきに Claude の最埌の応答をコメントずしお衚瀺したす | Global config settings | Global config |

670| [`extraKnownMarketplaces`](#extraknownmarketplaces) | リポゞトリたたは組織の[マヌケットプレむス](/docs/ja/plugin-marketplaces)を登録したす | Plugins and skills | Any file |670| [`extraKnownMarketplaces`](#extraknownmarketplaces) | リポゞトリたたは組織の[マヌケットプレむス](/docs/ja/plugins/overview)を登録したす | Plugins and skills | Any file |

671| [`fallbackModel`](#fallbackmodel) | プラむマリがオヌバヌロヌドされたずきの[バックアップモデル](/docs/ja/model-config#fallback-model-chains)に名前を付けたす | Model and responses | Any file |671| [`fallbackModel`](#fallbackmodel) | プラむマリがオヌバヌロヌドされたずきの[バックアップモデル](/docs/ja/model-config#fallback-model-chains)に名前を付けたす | Model and responses | Any file |

672| [`fastMode`](#fastmode) | 利甚可胜なセッションで[高速モヌド](/docs/ja/fast-mode)をオンにしたす | Model and responses | Any file |672| [`fastMode`](#fastmode) | 利甚可胜なセッションで[高速モヌド](/docs/ja/fast-mode)をオンにしたす | Model and responses | Any file |

673| [`fastModePerSessionOptIn`](#fastmodepersessionoptin) | ナヌザヌが各セッションで[高速モヌド](/docs/ja/fast-mode)をオンにするこずを芁求したす | Model and responses | Any file |673| [`fastModePerSessionOptIn`](#fastmodepersessionoptin) | ナヌザヌが各セッションで[高速モヌド](/docs/ja/fast-mode)をオンにするこずを芁求したす | Model and responses | Any file |


712| [`permissions.deny`](#permissions-deny) | リストされた[ツヌル䜿甚](/docs/ja/permissions#permission-rule-syntax)をブロックしたす。秘密を保持するファむルの読み取りを含みたす | Permission settings | Any file |712| [`permissions.deny`](#permissions-deny) | リストされた[ツヌル䜿甚](/docs/ja/permissions#permission-rule-syntax)をブロックしたす。秘密を保持するファむルの読み取りを含みたす | Permission settings | Any file |

713| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 誰もが[bypassPermissions モヌド](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)に入るのを防ぎたす | Permission settings | Any file |713| [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | 誰もが[bypassPermissions モヌド](/docs/ja/permission-modes#skip-all-checks-with-bypasspermissions-mode)に入るのを防ぎたす | Permission settings | Any file |

714| [`plansDirectory`](#plansdirectory) | [プランモヌド](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)がプランファむルを曞き蟌む堎所を遞択したす | Memory and context | Any file |714| [`plansDirectory`](#plansdirectory) | [プランモヌド](/docs/ja/permission-modes#analyze-before-you-edit-with-plan-mode)がプランファむルを曞き蟌む堎所を遞択したす | Memory and context | Any file |

715| [`pluginConfigs`](#pluginconfigs) | [プラグむン](/docs/ja/plugins)の蚭定ダむアログで提䟛した回答を保存したす | Plugins and skills | User or managed |715| [`pluginConfigs`](#pluginconfigs) | [プラグむン](/docs/ja/plugins/overview)の蚭定ダむアログで提䟛した回答を保存したす | Plugins and skills | User or managed |

716| [`pluginSuggestionMarketplaces`](#pluginsuggestionmarketplaces) | `/plugin` でプラグむンむンストヌル提案を衚瀺できる[マヌケットプレむス](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)を遞択したす | Plugins and skills | Managed |716| [`pluginSuggestionMarketplaces`](#pluginsuggestionmarketplaces) | `/plugin` でプラグむンむンストヌル提案を衚瀺できる[マヌケットプレむス](/docs/ja/plugins/org#restrict-what-users-can-install)を遞択したす | Plugins and skills | Managed |

717| [`pluginTrustMessage`](#plugintrustmessage) | [プラグむン](/docs/ja/plugins)信頌譊告に独自のテキストを远加したす | Plugins and skills | Managed |717| [`pluginTrustMessage`](#plugintrustmessage) | [プラグむン](/docs/ja/plugins/overview)信頌譊告に独自のテキストを远加したす | Plugins and skills | Managed |

718| [`policyHelper`](#policyhelper) | スタヌトアップで[マネヌゞド蚭定](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を蚈算する実行可胜ファむルを実行したす | Enterprise and managed settings | Managed |718| [`policyHelper`](#policyhelper) | スタヌトアップで[マネヌゞド蚭定](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を蚈算する実行可胜ファむルを実行したす | Enterprise and managed settings | Managed |

719| [`policyHelper.path`](#policyhelper-path) | Claude Code が実行する[ヘルパヌ実行可胜ファむル](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)に名前を付けたす | Enterprise and managed settings | Managed |719| [`policyHelper.path`](#policyhelper-path) | Claude Code が実行する[ヘルパヌ実行可胜ファむル](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)に名前を付けたす | Enterprise and managed settings | Managed |

720| [`policyHelper.refreshIntervalMs`](#policyhelper-refreshintervalms) | バックグラりンドで[ヘルパヌ](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を間隔で再実行したす | Enterprise and managed settings | Managed |720| [`policyHelper.refreshIntervalMs`](#policyhelper-refreshintervalms) | バックグラりンドで[ヘルパヌ](/docs/ja/managed-settings#compute-the-policy-with-a-helper-program)を間隔で再実行したす | Enterprise and managed settings | Managed |


785| [`sshConfigs`](#sshconfigs) | Desktop 環境ドロップダりンに[SSH 接続](/docs/ja/desktop#pre-configure-ssh-connections-for-your-team)を远加したす | Remote, desktop, and notifications | User or managed |785| [`sshConfigs`](#sshconfigs) | Desktop 環境ドロップダりンに[SSH 接続](/docs/ja/desktop#pre-configure-ssh-connections-for-your-team)を远加したす | Remote, desktop, and notifications | User or managed |

786| [`sshHostAllowlist`](#sshhostallowlist) | [Desktop SSH セッション](/docs/ja/desktop#restrict-which-ssh-hosts-users-can-connect-to)が到達できるホストを制限したす | Remote, desktop, and notifications | Managed |786| [`sshHostAllowlist`](#sshhostallowlist) | [Desktop SSH セッション](/docs/ja/desktop#restrict-which-ssh-hosts-users-can-connect-to)が到達できるホストを制限したす | Remote, desktop, and notifications | Managed |

787| [`statusLine`](#statusline) | [ステヌタスラむン](/docs/ja/statusline)をプロンプトの䞋にレンダリングする独自のコマンドを実行したす | Interface and terminal | Any file |787| [`statusLine`](#statusline) | [ステヌタスラむン](/docs/ja/statusline)をプロンプトの䞋にレンダリングする独自のコマンドを実行したす | Interface and terminal | Any file |

788| [`strictKnownMarketplaces`](#strictknownmarketplaces) | ナヌザヌが远加およびむンストヌルできる[マヌケットプレむス](/docs/ja/plugin-marketplaces)゜ヌスを蚱可リストに登録したす | Plugins and skills | Managed |788| [`strictKnownMarketplaces`](#strictknownmarketplaces) | ナヌザヌが远加およびむンストヌルできる[マヌケットプレむス](/docs/ja/plugins/overview)゜ヌスを蚱可リストに登録したす | Plugins and skills | Managed |

789| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | ナヌザヌおよびプロゞェクト゜ヌスから[スキル](/docs/ja/skills)、[゚ヌゞェント](/docs/ja/sub-agents)、[フック](/docs/ja/hooks)、[MCP サヌバヌ](/docs/ja/mcp)をブロックしたす | Plugins and skills | Managed |789| [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | ナヌザヌおよびプロゞェクト゜ヌスから[スキル](/docs/ja/skills)、[゚ヌゞェント](/docs/ja/sub-agents)、[フック](/docs/ja/hooks)、[MCP サヌバヌ](/docs/ja/mcp)をブロックしたす | Plugins and skills | Managed |

790| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | [゚ヌゞェント](/docs/ja/sub-agents)をプラグむンおよびマネヌゞド゜ヌスにロックしたす | Plugins and skills | Managed |790| [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | [゚ヌゞェント](/docs/ja/sub-agents)をプラグむンおよびマネヌゞド゜ヌスにロックしたす | Plugins and skills | Managed |

791| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | [フック](/docs/ja/hooks)をプラグむンおよびマネヌゞド゜ヌスにロックしたす | Plugins and skills | Managed |791| [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | [フック](/docs/ja/hooks)をプラグむンおよびマネヌゞド゜ヌスにロックしたす | Plugins and skills | Managed |


794| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | サブ゚ヌゞェントおよびメむン䌚話倖の他のリク゚ストの[プロンプトキャッシュラむフタむム](/docs/ja/prompt-caching#cache-lifetime)を遞択したす | Model and responses | Any file |794| [`subagentPromptCacheTtl`](#subagentpromptcachettl) | サブ゚ヌゞェントおよびメむン䌚話倖の他のリク゚ストの[プロンプトキャッシュラむフタむム](/docs/ja/prompt-caching#cache-lifetime)を遞択したす | Model and responses | Any file |

795| [`subagentStatusLine`](#subagentstatusline) | [サブ゚ヌゞェント](/docs/ja/sub-agents)タスク衚瀺の行を独自のコマンドで曞き盎したす | Interface and terminal | Any file |795| [`subagentStatusLine`](#subagentstatusline) | [サブ゚ヌゞェント](/docs/ja/sub-agents)タスク衚瀺の行を独自のコマンドで曞き盎したす | Interface and terminal | Any file |

796| [`switchModelsOnFlag`](#switchmodelsonflag) | [安党分類噚](/docs/ja/model-config#ask-before-switching)がリク゚ストにフラグを立おたずきにモデルを自動的に切り替えるか䞀時停止したす | Model and responses | Any file |796| [`switchModelsOnFlag`](#switchmodelsonflag) | [安党分類噚](/docs/ja/model-config#ask-before-switching)がリク゚ストにフラグを立おたずきにモデルを自動的に切り替えるか䞀時停止したす | Model and responses | Any file |

797| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | [claude.ai アカりントで有効になっおいるプラグむン](/docs/ja/plugins-reference#synced-plugins)のロヌドを停止し、新しいものをダりンロヌドするのを停止したす | Plugins and skills | User, local, or managed |797| [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | [claude.ai アカりントで有効になっおいるプラグむン](/docs/ja/plugins/loading#synced-plugins)のロヌドを停止し、新しいものをダりンロヌドするのを停止したす | Plugins and skills | User, local, or managed |

798| [`syncClaudeAiSkills`](#syncclaudeaiskills) | [claude.ai アカりントで有効になっおいるスキル](/docs/ja/skills#how-synced-skills-behave)のロヌドを停止し、新しいものをダりンロヌドするのを停止したす | Plugins and skills | User, local, or managed |798| [`syncClaudeAiSkills`](#syncclaudeaiskills) | [claude.ai アカりントで有効になっおいるスキル](/docs/ja/skills#how-synced-skills-behave)のロヌドを停止し、新しいものをダりンロヌドするのを停止したす | Plugins and skills | User, local, or managed |

799| [`syntaxHighlightingDisabled`](#syntaxhighlightingdisabled) | diff およびコヌドブロックの構文匷調衚瀺をオフにしたす | Interface and terminal | Any file |799| [`syntaxHighlightingDisabled`](#syntaxhighlightingdisabled) | diff およびコヌドブロックの構文匷調衚瀺をオフにしたす | Interface and terminal | Any file |

800| [`taskOutputMaxChars`](#taskoutputmaxchars) | v2.1.277 で削陀されたした。それがサむズを蚭定した `TaskOutput` ツヌルず䞀緒に削陀されたした | Memory and context | Any file |800| [`taskOutputMaxChars`](#taskoutputmaxchars) | v2.1.277 で削陀されたした。それがサむズを蚭定した `TaskOutput` ツヌルず䞀緒に削陀されたした | Memory and context | Any file |


2254 `sandbox.credentials`2254 `sandbox.credentials`

2255</h3>2255</h3>

2256 2256 

2257[サンドボックス化されたコマンドから保護する](/docs/ja/sandboxing#protect-credentials)認蚌情報ファむルず環境倉数を宣蚀したす。各゚ントリはファむル `path` たたは倉数 `name` ず `mode` に名前を付けたす`deny` はサンドボックス内の認蚌情報を非衚瀺にし、`mask` はサンドボックス化されたコマンドにプレヌスホルダヌを衚瀺したす。[サンドボックスプロキシ](/docs/ja/sandboxing#mask-credentials)は送信リク゚ストで実際の倀を眮き換えたす。Claude Code はリストした゚ントリのみを保護したす。組み蟌みの認蚌情報拒吊リストはありたせん。Claude Code v2.1.187 以降が必芁です。2257[サンドボックス化されたコマンドから保護する](/docs/ja/sandboxing#protect-credentials)認蚌情報ファむルず環境倉数を宣蚀したす。各゚ントリはファむル `path` たたは倉数 `name` ず `mode` に名前を付けたす`deny` はサンドボックス内の認蚌情報を非衚瀺にし、`mask` はサンドボックス化されたコマンドにプレヌスホルダヌを衚瀺したす。[サンドボックスプロキシ](/docs/ja/sandboxing#mask-credentials)は送信リク゚ストで実際の倀を眮き換えたす。Claude Code はリストした゚ントリのみを保護したす。組み蟌みの認蚌情報拒吊リストはありたせん。

2258 2258 

2259* **Scope**: [`Any file`](#scopes)。Claude Code は `mask` ゚ントリ、`allowPlaintextInject`、`awsPairs`、`sigv4` をナヌザヌ蚭定、管理蚭定、`--settings` フラグからのみ尊重したす。2259* **Scope**: [`Any file`](#scopes)。Claude Code は `mask` ゚ントリ、`allowPlaintextInject`、`awsPairs`、`sigv4` をナヌザヌ蚭定、管理蚭定、`--settings` フラグからのみ尊重したす。

2260* **Type**: `files`、`envVars`、`allowPlaintextInject`、`awsPairs`、`sigv4` を含むオブゞェクト2260* **Type**: `files`、`envVars`、`allowPlaintextInject`、`awsPairs`、`sigv4` を含むオブゞェクト


2273}2273}

2274```2274```

2275 2275 

2276`deny` ファむル保護はファむルシステムレむダヌの䞀郚であるため、[ファむルシステム分離を無効にする](/docs/ja/sandboxing#disable-filesystem-isolation)堎合は適甚されたせん。環境倉数保護は匕き続き行われたす。Claude Code v2.1.187 以降が必芁です。2276`deny` ファむル保護はファむルシステムレむダヌの䞀郚であるため、[ファむルシステム分離を無効にする](/docs/ja/sandboxing#disable-filesystem-isolation)堎合は適甚されたせん。環境倉数保護は匕き続き行われたす。

2277 2277 

2278<h4 id="invalid-credential-entries-in-managed-settings">2278<h4 id="invalid-credential-entries-in-managed-settings">

2279 管理蚭定の無効な認蚌情報゚ントリ2279 管理蚭定の無効な認蚌情報゚ントリ


2291 `sandbox.credentials.files`2291 `sandbox.credentials.files`

2292</h3>2292</h3>

2293 2293 

2294認蚌情報ファむルたたはディレクトリをサンドボックス化されたコマンドから保護したす。`"mode": "deny"` の堎合、Claude Code はサンドボックス内のパスの読み取りをブロックしたす。これは [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread) ず同じ読み取りブロックです。` "mode": "mask"` の堎合、Linux ず WSL2 でサンドボックス化されたコマンドはファむルのセンチネルコピヌを読み取り、サンドボックスプロキシはその゚ントリの `injectHosts` ぞの送信リク゚ストで実際の倀を眮き換えたす。macOS ではファむルはサンドボックス内で読み取り䞍可です。Claude Code v2.1.187 以降が必芁で、`"mode": "mask"` は v2.1.221 以降が必芁です。2294認蚌情報ファむルたたはディレクトリをサンドボックス化されたコマンドから保護したす。`"mode": "deny"` の堎合、Claude Code はサンドボックス内のパスの読み取りをブロックしたす。これは [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread) ず同じ読み取りブロックです。` "mode": "mask"` の堎合、Linux ず WSL2 でサンドボックス化されたコマンドはファむルのセンチネルコピヌを読み取り、サンドボックスプロキシはその゚ントリの `injectHosts` ぞの送信リク゚ストで実際の倀を眮き換えたす。macOS ではファむルはサンドボックス内で読み取り䞍可です。`"mode": "mask"` は Claude Code v2.1.221 以降が必芁です。

2295 2295 

2296* **Scope**: [`Any file`](#scopes)。Claude Code はプロゞェクト `.claude/settings.json` ずロヌカル `.claude/settings.local.json` から `mask` ゚ントリを削陀したす。2296* **Scope**: [`Any file`](#scopes)。Claude Code はプロゞェクト `.claude/settings.json` ずロヌカル `.claude/settings.local.json` から `mask` ゚ントリを削陀したす。

2297* **Type**: オブゞェクトの配列。各オブゞェクトは `path` ず `"deny"` たたは `"mask"` の `mode`、および optional [ファむルのマスクフィヌルド](#mask-fields-for-files)2297* **Type**: オブゞェクトの配列。各オブゞェクトは `path` ず `"deny"` たたは `"mask"` の `mode`、および optional [ファむルのマスクフィヌルド](#mask-fields-for-files)


2312}2312}

2313```2313```

2314 2314 

2315パスは `sandbox.filesystem.*` 蚭定ず同じ[プレフィックス](#sandbox-path-prefixes)を䜿甚し、Claude Code はセッションが読み蟌むすべおの蚭定スコヌプから配列をマヌゞしたす。[認蚌情報を保護する](/docs/ja/sandboxing#protect-credentials)は `--setting-sources` で陀倖する゜ヌスから䜕が匕き続き適甚されるかをカバヌしおいたす。Claude Code v2.1.187 以降が必芁です。`mask` ゚ントリは v2.1.221 以降が必芁です。2315パスは `sandbox.filesystem.*` 蚭定ず同じ[プレフィックス](#sandbox-path-prefixes)を䜿甚し、Claude Code はセッションが読み蟌むすべおの蚭定スコヌプから配列をマヌゞしたす。[認蚌情報を保護する](/docs/ja/sandboxing#protect-credentials)は `--setting-sources` で陀倖する゜ヌスから䜕が匕き続き適甚されるかをカバヌしおいたす。`mask` ゚ントリは v2.1.221 以降が必芁です。

2316 2316 

2317`mask` 眮き換えはサンドボックスプロキシを通じおのみ実行されるため、[`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) を蚭定するか、プレヌン HTTP テストネットワヌクの堎合は [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) を蚭定しおください。`mask` は単䞀ファむルに適甚されるため、各認蚌情報ファむルを個別にリストしおください。Claude Code は `deny` ゚ントリの `mask` フィヌルドを受け入れたすが無芖したす。[認蚌情報ファむルをマスクする](/docs/ja/sandboxing#mask-credential-files)は、どの蚭定゜ヌスが尊重されるか、および゚ントリが `deny` にフォヌルバックするずきをカバヌしおいたす。2317`mask` 眮き換えはサンドボックスプロキシを通じおのみ実行されるため、[`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) を蚭定するか、プレヌン HTTP テストネットワヌクの堎合は [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) を蚭定しおください。`mask` は単䞀ファむルに適甚されるため、各認蚌情報ファむルを個別にリストしおください。Claude Code は `deny` ゚ントリの `mask` フィヌルドを受け入れたすが無芖したす。[認蚌情報ファむルをマスクする](/docs/ja/sandboxing#mask-credential-files)は、どの蚭定゜ヌスが尊重されるか、および゚ントリが `deny` にフォヌルバックするずきをカバヌしおいたす。

2318 2318 


2368 `sandbox.credentials.envVars`2368 `sandbox.credentials.envVars`

2369</h3>2369</h3>

2370 2370 

2371環境倉数をサンドボックス化されたコマンドから保護したす。`"mode": "deny"` の堎合、Claude Code はサンドボックス化されたコマンドの環境から倉数を削陀したす。` "mode": "mask"` の堎合、サンドボックス化されたコマンドはセッションごずのセンチネル倀を芋お、サンドボックスプロキシはその゚ントリの `injectHosts` ぞの送信リク゚ストで実際の倀を眮き換えたす。`gh` ず `npm` などのツヌルは実際の認蚌情報を保持するこずなく認蚌を続けたす。Claude Code v2.1.187 以降が必芁で、`"mode": "mask"` は v2.1.199 以降が必芁です。2371環境倉数をサンドボックス化されたコマンドから保護したす。`"mode": "deny"` の堎合、Claude Code はサンドボックス化されたコマンドの環境から倉数を削陀したす。` "mode": "mask"` の堎合、サンドボックス化されたコマンドはセッションごずのセンチネル倀を芋お、サンドボックスプロキシはその゚ントリの `injectHosts` ぞの送信リク゚ストで実際の倀を眮き換えたす。`gh` ず `npm` などのツヌルは実際の認蚌情報を保持するこずなく認蚌を続けたす。`"mode": "mask"` は Claude Code v2.1.199 以降が必芁です。

2372 2372 

2373* **Scope**: [`Any file`](#scopes)。Claude Code はプロゞェクト `.claude/settings.json` ずロヌカル `.claude/settings.local.json` から `mask` ゚ントリを削陀したす。2373* **Scope**: [`Any file`](#scopes)。Claude Code はプロゞェクト `.claude/settings.json` ずロヌカル `.claude/settings.local.json` から `mask` ゚ントリを削陀したす。

2374* **Type**: オブゞェクトの配列。各オブゞェクトは `name` ず `"deny"` たたは `"mask"` の `mode`、および optional [環境倉数のマスクフィヌルド](#mask-fields-for-environment-variables)2374* **Type**: オブゞェクトの配列。各オブゞェクトは `name` ず `"deny"` たたは `"mask"` の `mode`、および optional [環境倉数のマスクフィヌルド](#mask-fields-for-environment-variables)


2389}2389}

2390```2390```

2391 2391 

2392`name` は文字、アンダヌスコアで始たり、文字、数字、アンダヌスコアのみを含む必芁がありたす。Claude Code はセッションが読み蟌むすべおの蚭定スコヌプから配列をマヌゞし、同じ倉数が䞡方のモヌドで衚瀺される堎合は `deny` を適甚したす。[認蚌情報を保護する](/docs/ja/sandboxing#protect-credentials)は `--setting-sources` で陀倖する゜ヌスから䜕が匕き続き適甚されるかをカバヌしおいたす。Claude Code v2.1.187 以降が必芁です。`mask` ゚ントリは v2.1.199 以降が必芁です。2392`name` は文字、アンダヌスコアで始たり、文字、数字、アンダヌスコアのみを含む必芁がありたす。Claude Code はセッションが読み蟌むすべおの蚭定スコヌプから配列をマヌゞし、同じ倉数が䞡方のモヌドで衚瀺される堎合は `deny` を適甚したす。[認蚌情報を保護する](/docs/ja/sandboxing#protect-credentials)は `--setting-sources` で陀倖する゜ヌスから䜕が匕き続き適甚されるかをカバヌしおいたす。`mask` ゚ントリは v2.1.199 以降が必芁です。

2393 2393 

2394`mask` 眮き換えはサンドボックスプロキシを通じおのみ実行されるため、[`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) を蚭定するか、プレヌン HTTP テストネットワヌクの堎合は [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) を蚭定しおください。[環境倉数をマスクする](/docs/ja/sandboxing#mask-environment-variables)を参照しおください。Claude Code は `deny` ゚ントリの `mask` フィヌルドを受け入れたすが無芖したす。2394`mask` 眮き換えはサンドボックスプロキシを通じおのみ実行されるため、[`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) を蚭定するか、プレヌン HTTP テストネットワヌクの堎合は [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) を蚭定しおください。[環境倉数をマスクする](/docs/ja/sandboxing#mask-environment-variables)を参照しおください。Claude Code は `deny` ゚ントリの `mask` フィヌルドを受け入れたすが無芖したす。

2395 2395 


2952 `env`2952 `env`

2953</h3>2953</h3>

2954 2954 

2955すべおのセッションず Claude Code がそこから開始するサブプロセスの環境倉数を蚭定したす。[環境倉数リファレンス](/docs/ja/env-vars)の任意の倉数をここに配眮できたす。これは 1 ぀をすべおのセッションに適甚するか、チヌム党䜓にロヌルアりトする方法です。2955すべおのセッションず Claude Code がそこから開始するサブプロセスの環境倉数を蚭定したす。[環境倉数リファレンス](/docs/ja/env-vars)の任意の倉数をここに配眮できたす。これは 1 ぀をすべおのセッションに適甚するか、チヌム党䜓にロヌルアりトする方法です。プロゞェクトおよびロヌカル蚭定は[それらの䞀郚を蚭定できたせん](#variables-claude-code-ignores-in-env)。

2956 2956 

2957* **スコヌプ**: [`任意のファむル`](#scopes)2957* **スコヌプ**: [`任意のファむル`](#scopes)

2958* **タむプ**: 倉数名を文字列倀にマップするオブゞェクト2958* **タむプ**: 倉数名を文字列倀にマップするオブゞェクト


2973 `env` 倀がシェルずどのように盞互䜜甚するか2973 `env` 倀がシェルずどのように盞互䜜甚するか

2974</h4>2974</h4>

2975 2975 

2976* ここの倀はシェルで゚クスポヌトされた同じ倉数を䞊曞きしたす。耇数の蚭定ファむルが倉数を蚭定する堎合、[最も優先床の高い](/docs/ja/settings#settings-precedence)ものが適甚されたす。2976* ここの倀はシェルで゚クスポヌトされた同じ倉数を䞊曞きしたす。耇数の蚭定ファむルが倉数を蚭定する堎合、[最も優先床の高い](/docs/ja/settings#settings-precedence)ものが適甚されたす。[Claude Code が `env` で無芖する倉数](#variables-claude-code-ignores-in-env)はプロゞェクトおよびロヌカル蚭定の䟋倖をリストしたす。

2977* シェル゚クスポヌトをキャンセルするには、倉数を `""` に蚭定したす。Claude Code は空の倀をプロバむダヌ遞択の未蚭定ずしお扱い、サブプロセスは空の倀を継承したす。2977* シェル゚クスポヌトをキャンセルするには、倉数を `""` に蚭定したす。Claude Code は空の倀をプロバむダヌ遞択の未蚭定ずしお扱い、サブプロセスは空の倀を継承したす。

2978* `NO_COLOR` ず `FORCE_COLOR` をここで蚭定するず、サブプロセスにのみ到達したす。Claude Code 自䜓のむンタヌフェヌスカラヌを倉曎するには、`claude` を起動する前にシェルで蚭定したす。2978* `NO_COLOR` ず `FORCE_COLOR` をここで蚭定するず、サブプロセスにのみ到達したす。Claude Code 自䜓のむンタヌフェヌスカラヌを倉曎するには、`claude` を起動する前にシェルで蚭定したす。

2979* ここの倀は蚭定ファむルのプレヌンテキストであり、Claude Code が開始するすべおのサブプロセスに到達したす。ロヌテヌションする OTLP ベアラヌトヌクンの堎合は[`otelHeadersHelper`](#otelheadershelper)を䜿甚したす。API 認蚌情報の堎合は[`apiKeyHelper`](#apikeyhelper)を䜿甚したす。2979* ここの倀は蚭定ファむルのプレヌンテキストであり、Claude Code が開始するすべおのサブプロセスに到達したす。ロヌテヌションする OTLP ベアラヌトヌクンの堎合は[`otelHeadersHelper`](#otelheadershelper)を䜿甚したす。API 認蚌情報の堎合は[`apiKeyHelper`](#apikeyhelper)を䜿甚したす。


2984 2984 

2985* ナヌザヌ蚭定、`--settings`、管理蚭定から: 起動時、および実行䞭のセッションでマヌゞされた `env` を倉曎する保存された倉曎がある堎合。2985* ナヌザヌ蚭定、`--settings`、管理蚭定から: 起動時、および実行䞭のセッションでマヌゞされた `env` を倉曎する保存された倉曎がある堎合。

2986* プロゞェクトおよびロヌカル蚭定から: ワヌクスペヌスを信頌した埌、たたは `-p` モヌド信頌ダむアログを衚瀺しないでの起動時、およびマヌゞされた `env` を倉曎する保存された倉曎がある堎合。2986* プロゞェクトおよびロヌカル蚭定から: ワヌクスペヌスを信頌した埌、たたは `-p` モヌド信頌ダむアログを衚瀺しないでの起動時、およびマヌゞされた `env` を倉曎する保存された倉曎がある堎合。

2987* Claude Code がモデル遞択、タむムアりトず制限、機胜トグル、テレメトリ蚭定などの安党ずしお分類する倉数: [プロゞェクトおよびロヌカル蚭定が蚭定できない倉数](#variables-claude-code-ignores-in-env)を陀き、すべおの蚭定ファむルから起動時。2987* Claude Code がモデル遞択、タむムアりトず制限、機胜トグルなどの安党ずしお分類する倉数: [プロゞェクトおよびロヌカル蚭定が蚭定できない倉数](#variables-claude-code-ignores-in-env)を陀き、すべおの蚭定ファむルから起動時。

2988* v2.1.246 以降で[`/cd`](/docs/ja/permissions#move-the-session-to-another-directory)でセッションを移動した埌: 新しいディレクトリのプロゞェクトおよびロヌカル `env` 倀。前のディレクトリの䞊に。2988* v2.1.246 以降で[`/cd`](/docs/ja/permissions#move-the-session-to-another-directory)でセッションを移動した埌: 新しいディレクトリのプロゞェクトおよびロヌカル `env` 倀。前のディレクトリの䞊に。

2989 2989 

2990<h4 id="variables-claude-code-ignores-in-env">2990<h4 id="variables-claude-code-ignores-in-env">


2995 2995 

2996 * Claude Code が独自のファむルを保存たたは曞き蟌む堎所を遞択する倉数: `CLAUDE_CONFIG_DIR`、`CLAUDE_CODE_TMPDIR`、および `HOME`、`TMPDIR`、`TMP`、`TEMP`、`XDG_*` ファミリヌなどのオペレヌティングシステムディレクトリ倉数。2996 * Claude Code が独自のファむルを保存たたは曞き蟌む堎所を遞択する倉数: `CLAUDE_CONFIG_DIR`、`CLAUDE_CODE_TMPDIR`、および `HOME`、`TMPDIR`、`TMP`、`TEMP`、`XDG_*` ファミリヌなどのオペレヌティングシステムディレクトリ倉数。

2997 * セッションコンテンツを゚クスポヌトする倉数: [`OTEL_LOG_RAW_API_BODIES`](/docs/ja/env-vars#variables)および詳现なベヌタトレヌシングペア `ENABLE_BETA_TRACING_DETAILED` ず `BETA_TRACING_ENDPOINT`。2997 * セッションコンテンツを゚クスポヌトする倉数: [`OTEL_LOG_RAW_API_BODIES`](/docs/ja/env-vars#variables)および詳现なベヌタトレヌシングペア `ENABLE_BETA_TRACING_DETAILED` ず `BETA_TRACING_ENDPOINT`。

2998 * [OpenTelemetry ゚クスポヌタヌ](/docs/ja/monitoring-usage)倉数。テレメトリをオンにする、どこに送信するかを遞択する、たたはどのコンテンツをキャプチャするかを遞択したす。

2999 

3000 * `CLAUDE_CODE_ENABLE_TELEMETRY`。拡匵テレメトリベヌタペア `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` ず `ENABLE_ENHANCED_TELEMETRY_BETA`

3001 * ゚クスポヌタヌセレクタヌ `OTEL_LOGS_EXPORTER`、`OTEL_METRICS_EXPORTER`、`OTEL_TRACES_EXPORTER`

3002 * コンテンツ倉数 `OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_ASSISTANT_RESPONSES`、`OTEL_LOG_TOOL_CONTENT`、`OTEL_LOG_TOOL_DETAILS`

3003 * `OTEL_EXPORTER_OTLP_*` 倉数。名前が `_ENDPOINT`、`_HEADERS`、`_PROTOCOL`、`_CERTIFICATE`、`_CLIENT_KEY`、`_INSECURE` で終わりたす。汎甚およびシグナルごずの圢匏。`OTEL_EXPORTER_OTLP_ENDPOINT` ず `OTEL_EXPORTER_OTLP_METRICS_HEADERS` など

3004 * `OTEL_EXPORTER_PROMETHEUS_HOST` ず `OTEL_EXPORTER_PROMETHEUS_PORT`

3005 

3006 これらの倀のみがプロゞェクトおよびロヌカル蚭定から適甚されたす。䜕かをオフにするため: 3 ぀の゚クスポヌタヌセレクタヌの堎合は `none`。`OTEL_LOG_USER_PROMPTS`、`OTEL_LOG_TOOL_CONTENT`、`OTEL_LOG_TOOL_DETAILS` の堎合は `0` などのオフ倀。そのような倀はナヌザヌ蚭定で同じ倉数をオヌバヌラむドしたすが、環境で Claude Code を起動するもの、`--settings` ファむル、たたは管理蚭定は蚭定したせん。

3007 

3008 プロゞェクトたたはロヌカル蚭定ファむルがこのグルヌプの倉数を蚭定する堎合、ロヌカルむンタラクティブセッションは起動時に通知を衚瀺したす。`/status` たたは `claude doctor` を実行しお、Claude Code が無芖したものず、テレメトリをオフにしたものを確認したす。䞡方ずも名前をリストしたす。倀は決しおリストしたせん。`-p` を䜿甚した非むンタラクティブ実行たたは Agent SDK セッションは通知を衚瀺しないため、アップグレヌド埌にコレクタヌがデヌタを受け取り続けるかどうかを確認したす。受け取らない堎合は、ナヌザヌ蚭定、管理蚭定、ゞョブの環境、たたは `--settings` で枡すファむルで倉数を蚭定したす。

3009 

3010 プロゞェクトおよびロヌカル蚭定でこのグルヌプを無芖するには Claude Code v2.1.282 以降が必芁です。

2998 * Claude Code の起動たたはシンク方法を倉曎する倉数。`CLAUDE_CODE_PROCESS_WRAPPER`、`CLAUDE_CODE_SYNC_SKILLS`、`CLAUDE_CODE_SYNC_PLUGINS`、`CLAUDE_CODE_PLUGIN_CACHE_DIR`、`CLAUDE_CODE_PLUGIN_SEED_DIR` など。3011 * Claude Code の起動たたはシンク方法を倉曎する倉数。`CLAUDE_CODE_PROCESS_WRAPPER`、`CLAUDE_CODE_SYNC_SKILLS`、`CLAUDE_CODE_SYNC_PLUGINS`、`CLAUDE_CODE_PLUGIN_CACHE_DIR`、`CLAUDE_CODE_PLUGIN_SEED_DIR` など。

2999 3012 

3000 v2.1.251 より前は、プロゞェクトおよびロヌカル蚭定は `HOME`、`XDG_CONFIG_HOME`、Claude Code の起動たたはシンク方法を倉曎する倉数を陀き、このリストが名前を付けるすべおの倉数を蚭定できたした。3013 v2.1.251 より前は、プロゞェクトおよびロヌカル蚭定は `HOME` ず `XDG_CONFIG_HOME` を陀き、このリストが名前を付けるファむルの保存たたは曞き蟌み堎所を遞択する倉数、たたはセッションコンテンツを゚クスポヌトする倉数を蚭定できたした。

3001* Claude Code のホスティング環境が所有する `CLAUDE_CODE_REMOTE` や `CLAUDE_CODE_ACCOUNT_UUID` などのアむデンティティ倉数は、すべおのファむルから無芖されたす。3014* Claude Code のホスティング環境が所有する `CLAUDE_CODE_REMOTE` や `CLAUDE_CODE_ACCOUNT_UUID` などのアむデンティティ倉数は、すべおのファむルから無芖されたす。

3002* [`CLAUDE_CODE_MESSAGING_SOCKET` ず `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ja/env-vars#variables)。Claude Code 自䜓が゚クスポヌトするものは、すべおのファむルから無芖されたす。゜ケット倉数を無芖するには Claude Code v2.1.224 以降が必芁で、トヌクンを無芖するには v2.1.228 以降が必芁です。3015* [`CLAUDE_CODE_MESSAGING_SOCKET` ず `CLAUDE_CODE_MESSAGING_TOKEN`](/docs/ja/env-vars#variables)。Claude Code 自䜓が゚クスポヌトするものは、すべおのファむルから無芖されたす。゜ケット倉数を無芖するには Claude Code v2.1.224 以降が必芁で、トヌクンを無芖するには v2.1.228 以降が必芁です。

3003* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ja/sessions#name-the-project-directory-yourself)。Claude Code は起動環境からのみ読み取りたす。すべおのファむルから無芖されたす。v2.1.234 以降が必芁です。3016* [`CLAUDE_CODE_PROJECT_DIR_NAME`](/docs/ja/sessions#name-the-project-directory-yourself)。Claude Code は起動環境からのみ読み取りたす。すべおのファむルから無芖されたす。v2.1.234 以降が必芁です。


3462 `respondToBashCommands`3475 `respondToBashCommands`

3463</h3>3476</h3>

3464 3477 

3465入力ボックスで [`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)でシェルコマンドを実行した埌、Claude が応答するかどうかを遞択したす。デフォルトでは、Claude Code はコマンドの出力を䌚話に远加し、Claude がそれに応答したす。このキヌを `false` に蚭定しお、応答なしでコンテキストに出力を远加し、耇数のコマンドを実行しお䞀緒に質問できるようにしたす。Claude Code v2.1.186 以降が必芁です。3478入力ボックスで [`!` プレフィックス](/docs/ja/interactive-mode#shell-mode-with-prefix)でシェルコマンドを実行した埌、Claude が応答するかどうかを遞択したす。デフォルトでは、Claude Code はコマンドの出力を䌚話に远加し、Claude がそれに応答したす。このキヌを `false` に蚭定しお、応答なしでコンテキストに出力を远加し、耇数のコマンドを実行しお䞀緒に質問できるようにしたす。

3466 3479 

3467* **スコヌプ**: [`任意のファむル`](#scopes)3480* **スコヌプ**: [`任意のファむル`](#scopes)

3468* **タむプ**: ブヌル倀3481* **タむプ**: ブヌル倀


3476}3489}

3477```3490```

3478 3491 

3479[`!` プレフィックスでシェルモヌド](/docs/ja/interactive-mode#shell-mode-with-prefix)を参照しおください。Claude Code v2.1.186 以降が必芁です。3492[シェルモヌド`!` プレフィックス付き](/docs/ja/interactive-mode#shell-mode-with-prefix)を参照しおください。

3480 3493 

3481<h3 id="showclearcontextonplanaccept">3494<h3 id="showclearcontextonplanaccept">

3482 `showClearContextOnPlanAccept`3495 `showClearContextOnPlanAccept`


3983Claude Code が git コミットずプルリク゚ストに远加するアトリビュヌションをカスタマむズしたす。コミットはデフォルトで `Co-Authored-By` などの [git トレヌラヌ](https://git-scm.com/docs/git-interpret-trailers) を取埗したす。プルリク゚ストの説明はプレヌンテキストを取埗したす。以䞋のサブキヌを䜿甚しお各郚分を個別に蚭定したす。3996Claude Code が git コミットずプルリク゚ストに远加するアトリビュヌションをカスタマむズしたす。コミットはデフォルトで `Co-Authored-By` などの [git トレヌラヌ](https://git-scm.com/docs/git-interpret-trailers) を取埗したす。プルリク゚ストの説明はプレヌンテキストを取埗したす。以䞋のサブキヌを䜿甚しお各郚分を個別に蚭定したす。

3984 3997 

3985* **スコヌプ**: [`Any file`](#scopes)3998* **スコヌプ**: [`Any file`](#scopes)

3986* **タむプ**: `commit` ず `pr` 文字列および `sessionUrl` ブヌル倀を含むオブゞェクト3999* **タむプ**: `commit` ず `pr` 文字列および `sessionUrl` ブヌル倀を含むオブゞェクト、たたは党おのアトリビュヌションを非衚瀺にする `false`。`false` 倀には Claude Code v2.1.281 以降が必芁です。それより前のバヌゞョンはこれを拒吊し、[それを含むナヌザヌ、プロゞェクト、たたはロヌカル蚭定ファむル党䜓をスキップしたす](/docs/ja/settings#fix-a-broken-settings-file)

3987* **デフォルト**: 未蚭定。Claude Code は各サブキヌの䞋に衚瀺される暙準アトリビュヌションを䜿甚したす4000* **デフォルト**: 未蚭定。Claude Code は各サブキヌの䞋に衚瀺される暙準アトリビュヌションを䜿甚したす

3988 4001 

4002党おのアトリビュヌションを非衚瀺にするには、`attribution` を `false` に蚭定したす。それより前のバヌゞョンも読み蟌む蚭定ファむルでは、[`commit`](#attribution-commit) ず [`pr`](#attribution-pr) を空の文字列に蚭定し、[`sessionUrl`](#attribution-sessionurl) を `false` に蚭定しおください。

4003 

3989この䟋はコミットアトリビュヌションを眮き換え、プルリク゚ストアトリビュヌションを削陀し、セッションリンクを削陀したす。4004この䟋はコミットアトリビュヌションを眮き換え、プルリク゚ストアトリビュヌションを削陀し、セッションリンクを削陀したす。

3990 4005 

3991```json settings.json theme={null}4006```json settings.json theme={null}


3998}4013}

3999```4014```

4000 4015 

4001すべおのアトリビュヌションを非衚瀺にするには、[`commit`](#attribution-commit) ず [`pr`](#attribution-pr) を空の文字列に蚭定し、[`sessionUrl`](#attribution-sessionurl) を `false` に蚭定したす。`commit` たたは `pr` を蚭定するず、Claude Code は非掚奚の `includeCoAuthoredBy` 蚭定を無芖し、蚭定しなかった方のデフォルトテキストを䜿甚したす。4016`commit` たたは `pr` を蚭定するず、Claude Code は非掚奚の `includeCoAuthoredBy` 蚭定を無芖し、蚭定しなかった方のデフォルトテキストを䜿甚したす。

4002 4017 

4003Claude Code は、CLAUDE.md たたは [memory](/docs/ja/memory) ルヌルなど、アトリビュヌションに関するカスタマヌ独自の呜什が、[managed settings](/docs/ja/managed-settings) で蚭定されおいる堎合を陀き、これらのコミットおよび PR 行より優先されるこずを Claude に䌝えたす。4018Claude Code は、CLAUDE.md たたは [memory](/docs/ja/memory) ルヌルなど、アトリビュヌションに関するカスタマヌ独自の呜什が、[managed settings](/docs/ja/managed-settings) で蚭定されおいる堎合を陀き、これらのコミットおよび PR 行より優先されるこずを Claude に䌝えたす。

4004 4019 


4024}4039}

4025```4040```

4026 4041 

4027すべおのアトリビュヌションを今すぐ非衚瀺にするには、[`attribution.commit`](#attribution-commit) ず [`attribution.pr`](#attribution-pr) を空の文字列に蚭定し、[`attribution.sessionUrl`](#attribution-sessionurl) を `false` に蚭定したす。4042党おのアトリビュヌションを非衚瀺にするには、[`attribution`](#attribution) を参照しおください。

4028 4043 

4029<h3 id="includegitinstructions">4044<h3 id="includegitinstructions">

4030 `includeGitInstructions`4045 `includeGitInstructions`


4182* **管理フックず SDK フックが実行されたす**: 管理蚭定からのフックず [Agent SDK](/docs/ja/agent-sdk/overview) がプロセス内で登録するフック4197* **管理フックず SDK フックが実行されたす**: 管理蚭定からのフックず [Agent SDK](/docs/ja/agent-sdk/overview) がプロセス内で登録するフック

4183* **匷制有効プラグむンフックが実行されたす**: 管理蚭定が [`enabledPlugins`](#enabledplugins) を通じお匷制有効にするプラグむンからのフック。Claude Code は完党な `plugin@marketplace` ID でマッチするため、別のマヌケットプレむスからの同じ名前のプラグむンはブロックされたたたです。これにより、組織マヌケットプレむスを通じお怜蚌枈みフックを配垃しながら、その他すべおをブロックできたす4198* **匷制有効プラグむンフックが実行されたす**: 管理蚭定が [`enabledPlugins`](#enabledplugins) を通じお匷制有効にするプラグむンからのフック。Claude Code は完党な `plugin@marketplace` ID でマッチするため、別のマヌケットプレむスからの同じ名前のプラグむンはブロックされたたたです。これにより、組織マヌケットプレむスを通じお怜蚌枈みフックを配垃しながら、その他すべおをブロックできたす

4184* **その他すべおはブロックされたす**: ナヌザヌ、プロゞェクト、ロヌカルフック、他のプラグむンからのフック、゚ヌゞェント frontmatter で宣蚀されたフック4199* **その他すべおはブロックされたす**: ナヌザヌ、プロゞェクト、ロヌカルフック、他のプラグむンからのフック、゚ヌゞェント frontmatter で宣蚀されたフック

4185* **コマンド゜ヌスプラグむンは無効になりたす**: Claude Code は [`command` ゜ヌス](/docs/ja/plugin-marketplaces#command-sources)を持぀プラグむン管理 `enabledPlugins` で匷制有効にされたプラグむンを含むも無効にしたす。ただし、[`disableCommandPluginSources`](#disablecommandpluginsources) を明瀺的に `false` に蚭定した堎合を陀きたす4200* **コマンド゜ヌスプラグむンは無効になりたす**: Claude Code は [`command` ゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source)を持぀プラグむン管理 `enabledPlugins` で匷制有効にされたプラグむンを含むも無効にしたす。ただし、[`disableCommandPluginSources`](#disablecommandpluginsources) を明瀺的に `false` に蚭定した堎合を陀きたす

4186* **マヌケットプレむス `headersHelper` コマンドはブロックされたす**: Claude Code はマヌケットプレむス [`headersHelper` コマンド](/docs/ja/plugin-marketplaces#authenticate-archive-downloads)もブロックしたす。ただし、[`disableCommandPluginSources`](#disablecommandpluginsources) が明瀺的に `false` に蚭定されおいる堎合、たたは管理蚭定自䜓が宣蚀するマヌケットプレむスの堎合を陀きたす。Claude Code v2.1.238 以降が必芁です4201* **マヌケットプレむス `headersHelper` コマンドはブロックされたす**: Claude Code はマヌケットプレむス [`headersHelper` コマンド](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads)もブロックしたす。ただし、[`disableCommandPluginSources`](#disablecommandpluginsources) が明瀺的に `false` に蚭定されおいる堎合、たたは管理蚭定自䜓が宣蚀するマヌケットプレむスの堎合を陀きたす。Claude Code v2.1.238 以降が必芁です

4187* **ステヌタスラむンずファむル提案は管理蚭定に絞られたす**: Claude Code は [`statusLine`](/docs/ja/statusline)、[`fileSuggestion`](#filesuggestion)、[`subagentStatusLine`](/docs/ja/statusline#subagent-status-lines) を管理蚭定からのみ読み蟌みたす。[ステヌタスラむンずファむル提案ゲヌト](#status-line-and-file-suggestion-gates)に埓いたす4202* **ステヌタスラむンずファむル提案は管理蚭定に絞られたす**: Claude Code は [`statusLine`](/docs/ja/statusline)、[`fileSuggestion`](#filesuggestion)、[`subagentStatusLine`](/docs/ja/statusline#subagent-status-lines) を管理蚭定からのみ読み蟌みたす。[ステヌタスラむンずファむル提案ゲヌト](#status-line-and-file-suggestion-gates)に埓いたす

4188 4203 

4189このキヌが蚭定されおいる間、[`/goal`](/docs/ja/goal) コマンドは実行できたせん。これはフックに䟝存しおいるためです。4204このキヌが蚭定されおいる間、[`/goal`](/docs/ja/goal) コマンドは実行できたせん。これはフックに䟝存しおいるためです。


4366 プラグむンずスキル4381 プラグむンずスキル

4367</h2>4382</h2>

4368 4383 

4369プラグむンを有効にし、マヌケットプレむスを登録し、組織が蚱可するプラグむン゜ヌスを制限し、どのスキルを読み蟌むかを制埡したす。プラグむンのむンストヌルずビルドに぀いおは、[プラグむン](/docs/ja/plugins)を参照しおください。4384プラグむンを有効にし、マヌケットプレむスを登録し、組織が蚱可するプラグむン゜ヌスを制限し、どのスキルを読み蟌むかを制埡したす。プラグむンのむンストヌルずビルドに぀いおは、[プラグむン](/docs/ja/plugins/overview)を参照しおください。

4370 4385 

4371<h3 id="disablebundledskills">4386<h3 id="disablebundledskills">

4372 `disableBundledSkills`4387 `disableBundledSkills`


4462 `syncClaudeAiPlugins`4477 `syncClaudeAiPlugins`

4463</h3>4478</h3>

4464 4479 

4465[claude.ai アカりントで有効になっおいるプラグむン](/docs/ja/plugins-reference#synced-plugins)のダりンロヌドをオフにしたす。Claude Code は、claude.ai アカりントでサむンむンするタヌミナルセッションの開始時、および Cowork ずクラりドセッションで、それらを `~/.claude/plugins/synced/` にダりンロヌドし、各プラグむンを `<name>@synced` ずしお読み蟌みたす。`false` に蚭定しお、そのダりンロヌドを停止し、既に同期されたプラグむンの読み蟌みを停止したす。Claude Code は `false` のみを受け入れたす。`true` は未蚭定ず同じで、それ以倖の堎所でオンになっおいない堎合、同期をオンにしたせん。Claude Code v2.1.273 以降が必芁です。4480[claude.ai アカりントで有効になっおいるプラグむン](/docs/ja/plugins/loading#synced-plugins)のダりンロヌドをオフにしたす。Claude Code は、claude.ai アカりントでサむンむンするタヌミナルセッションの開始時、および Cowork セッションで、それらを `~/.claude/plugins/synced/` にダりンロヌドし、各プラグむンを `<name>@synced` ずしお読み蟌みたす。`false` に蚭定しお、そのダりンロヌドを停止し、既に同期されたプラグむンの読み蟌みを停止したす。Claude Code は `false` のみを受け入れたす。`true` は未蚭定ず同じで、それ以倖の堎所でオンになっおいない堎合、同期をオンにしたせん。Claude Code v2.1.273 以降が必芁です。

4466 4481 

4467* **Scope**: [`User, local, or managed`](#scopes)、および `--settings` で枡されたファむル。リポゞトリはそれをオフにするこずはできたせん。4482* **Scope**: [`User, local, or managed`](#scopes)、および `--settings` で枡されたファむル。リポゞトリはそれをオフにするこずはできたせん。

4468* **Type**: Boolean4483* **Type**: Boolean


4511 4526 

4512組織のプラグむンマヌケットプレむス゜ヌスをブロックしたす。Claude Code はマヌケットプレむスの远加時およびプラグむンのむンストヌル、曎新、リフレッシュ、自動曎新時にブロックリストをチェックするため、ポリシヌを蚭定する前に誰かが远加したマヌケットプレむスは、プラグむンをフェッチするために䜿甚するこずはできたせん。ブロックされた゜ヌスはダりンロヌド前にチェックされるため、ファむルシステムに觊れるこずはありたせん。4527組織のプラグむンマヌケットプレむス゜ヌスをブロックしたす。Claude Code はマヌケットプレむスの远加時およびプラグむンのむンストヌル、曎新、リフレッシュ、自動曎新時にブロックリストをチェックするため、ポリシヌを蚭定する前に誰かが远加したマヌケットプレむスは、プラグむンをフェッチするために䜿甚するこずはできたせん。ブロックされた゜ヌスはダりンロヌド前にチェックされるため、ファむルシステムに觊れるこずはありたせん。

4513 4528 

4514[claude.ai 管理コン゜ヌル](/docs/ja/server-managed-settings)でこのキヌを蚭定する堎合、claude.ai は、[制限の仕組み](/docs/ja/plugin-marketplaces#how-restrictions-work)で説明されおいるように、組織内の誰かが claude.ai から git リポゞトリからマヌケットプレむスを远加するずきにも適甚したす。4529[claude.ai 管理コン゜ヌル](/docs/ja/server-managed-settings)でこのキヌを蚭定する堎合、claude.ai は、[制限の仕組み](/docs/ja/plugins/org#restrict-what-users-can-install)で説明されおいるように、組織内の誰かが claude.ai から git リポゞトリからマヌケットプレむスを远加するずきにも適甚したす。

4515 4530 

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

4517* **Type**: [`strictKnownMarketplaces`](#allowed-source-types) ず同じ圢匏のマヌケットプレむス゜ヌスオブゞェクトの配列4532* **Type**: [`strictKnownMarketplaces`](#allowed-source-types) ず同じ圢匏のマヌケットプレむス゜ヌスオブゞェクトの配列


4527}4542}

4528```4543```

4529 4544 

4530GitHub ゚ントリは、[オヌナヌワむルドカヌド圢匏](#owner-wildcards) `"owner/*"` を䜿甚しお、その GitHub オヌナヌの䞋のすべおのリポゞトリをブロックできたす。これには Claude Code v2.1.223 以降が必芁です。`{ "source": "skills-dir" }` を远加しお、Claude Code が `~/.claude/skills/` から [`@skills-dir` プラグむン](/docs/ja/plugins-reference#skills-directory-plugins)を読み蟌むのを停止し、マヌケットプレむスを制限したせん。[マネヌゞドマヌケットプレむス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)を参照しおください。4545GitHub ゚ントリは、[オヌナヌワむルドカヌド圢匏](#owner-wildcards) `"owner/*"` を䜿甚しお、その GitHub オヌナヌの䞋のすべおのリポゞトリをブロックできたす。これには Claude Code v2.1.223 以降が必芁です。`{ "source": "skills-dir" }` を远加しお、Claude Code が `~/.claude/skills/` から [`@skills-dir` プラグむン](/docs/ja/plugins/loading#plugins-shared-through-a-repository)を読み蟌むのを停止し、マヌケットプレむスを制限したせん。[マネヌゞドマヌケットプレむス制限](/docs/ja/plugins/org#restrict-what-users-can-install)を参照しおください。

4531 4546 

4532<h3 id="channelsenabled">4547<h3 id="channelsenabled">

4533 `channelsEnabled`4548 `channelsEnabled`


4553 `disableCommandPluginSources`4568 `disableCommandPluginSources`

4554</h3>4569</h3>

4555 4570 

4556[`command` プラグむン゜ヌス](/docs/ja/plugin-marketplaces#command-sources)をブロックしたす。これはナヌザヌのマシンでマヌケットプレむス宣蚀コマンドを実行しおプラグむンをむンストヌルしたす。`true` に蚭定するず、Claude Code はコマンドを実行せず、コマンド゜ヌスプラグむンをむンストヌルたたは曎新せず、既にむンストヌルされおいるプラグむンの読み蟌みを停止したす。`false` に蚭定しお明瀺的に蚱可したす。コマンド゜ヌスをブロックするずきはい぀でも、`true` に蚭定するか [`allowManagedHooksOnly`](#allowmanagedhooksonly) の䞋で未蚭定のたたにするかに関わらず、マヌケットプレむス [`headersHelper` コマンド](/docs/ja/plugin-marketplaces#authenticate-archive-downloads)もブロックしたす。ただし、マネヌゞド蚭定自䜓が宣蚀するマヌケットプレむスは陀きたす。Claude Code v2.1.229 以降が必芁で、`headersHelper` ブロックには v2.1.238 以降が必芁です。4571[`command` プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#command-plugin-source)をブロックしたす。これはナヌザヌのマシンでマヌケットプレむス宣蚀コマンドを実行しおプラグむンをむンストヌルしたす。`true` に蚭定するず、Claude Code はコマンドを実行せず、コマンド゜ヌスプラグむンをむンストヌルたたは曎新せず、既にむンストヌルされおいるプラグむンの読み蟌みを停止したす。`false` に蚭定しお明瀺的に蚱可したす。コマンド゜ヌスをブロックするずきはい぀でも、`true` に蚭定するか [`allowManagedHooksOnly`](#allowmanagedhooksonly) の䞋で未蚭定のたたにするかに関わらず、マヌケットプレむス [`headersHelper` コマンド](/docs/ja/plugins/host-marketplace#authenticate-archive-downloads)もブロックしたす。ただし、マネヌゞド蚭定自䜓が宣蚀するマヌケットプレむスは陀きたす。Claude Code v2.1.229 以降が必芁で、`headersHelper` ブロックには v2.1.238 以降が必芁です。

4557 4572 

4558* **Scope**: [`Managed`](#scopes)4573* **Scope**: [`Managed`](#scopes)

4559* **Type**: Boolean4574* **Type**: Boolean


4585}4600}

4586```4601```

4587 4602 

4588名前は、マヌケットプレむスがマシンに登録され、その登録された゜ヌスが同じマネヌゞド蚭定でも宣蚀されおいる堎合にのみ有効になりたす。その名前の [`extraKnownMarketplaces`](#extraknownmarketplaces) ゚ントリずしお、たたは [`strictKnownMarketplaces`](#strictknownmarketplaces) の゚ントリずしお。Claude Code は、蚱可リストされた名前の䞋で別の゜ヌスから登録されたマヌケットプレむスを無芖したす。公匏マヌケットプレむスは゜ヌス芁件から陀倖されたす。その名前を蚱可リストするだけで十分です。その名前は公匏 Anthropic ゜ヌスからのみ登録できるためです。[コンテキストでプラグむンを提案する](/docs/ja/plugin-relevance)を参照しおください。4603名前は、マヌケットプレむスがマシンに登録され、その登録された゜ヌスが同じマネヌゞド蚭定でも宣蚀されおいる堎合にのみ有効になりたす。その名前の [`extraKnownMarketplaces`](#extraknownmarketplaces) ゚ントリずしお、たたは [`strictKnownMarketplaces`](#strictknownmarketplaces) の゚ントリずしお。Claude Code は、蚱可リストされた名前の䞋で別の゜ヌスから登録されたマヌケットプレむスを無芖したす。公匏マヌケットプレむスは゜ヌス芁件から陀倖されたす。その名前を蚱可リストするだけで十分です。その名前は公匏 Anthropic ゜ヌスからのみ登録できるためです。[コンテキストでプラグむンを提案する](/docs/ja/plugins/relevance)を参照しおください。

4589 4604 

4590<h3 id="plugintrustmessage">4605<h3 id="plugintrustmessage">

4591 `pluginTrustMessage`4606 `pluginTrustMessage`


4609 4624 

4610組織内のナヌザヌがプラグむンを远加およびむンストヌルできるプラグむンマヌケットプレむス゜ヌスを制限したす。Claude Code はマヌケットプレむスの远加時およびプラグむンのむンストヌル、曎新、リフレッシュ、自動曎新時に蚱可リストを実斜したす。ネットワヌクたたはファむルシステム操䜜の前に実斜されるため、ポリシヌを蚭定する前に誰かが远加したマヌケットプレむスは、その゜ヌスが䞀臎しなくなるず䜿甚できたせん。ブロックされたナヌザヌはマネヌゞドポリシヌに名前を付ける゚ラヌを衚瀺したす。4625組織内のナヌザヌがプラグむンを远加およびむンストヌルできるプラグむンマヌケットプレむス゜ヌスを制限したす。Claude Code はマヌケットプレむスの远加時およびプラグむンのむンストヌル、曎新、リフレッシュ、自動曎新時に蚱可リストを実斜したす。ネットワヌクたたはファむルシステム操䜜の前に実斜されるため、ポリシヌを蚭定する前に誰かが远加したマヌケットプレむスは、その゜ヌスが䞀臎しなくなるず䜿甚できたせん。ブロックされたナヌザヌはマネヌゞドポリシヌに名前を付ける゚ラヌを衚瀺したす。

4611 4626 

4612[claude.ai 管理コン゜ヌル](/docs/ja/server-managed-settings)でこのキヌを蚭定する堎合、claude.ai は、[制限の仕組み](/docs/ja/plugin-marketplaces#how-restrictions-work)で説明されおいるように、組織内の誰かが claude.ai から git リポゞトリからマヌケットプレむスを远加するずきにも適甚したす。4627[claude.ai 管理コン゜ヌル](/docs/ja/server-managed-settings)でこのキヌを蚭定する堎合、claude.ai は、[制限の仕組み](/docs/ja/plugins/org#restrict-what-users-can-install)で説明されおいるように、組織内の誰かが claude.ai から git リポゞトリからマヌケットプレむスを远加するずきにも適甚したす。

4613 4628 

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

4615* **Type**: マヌケットプレむス゜ヌスオブゞェクトの配列。[蚱可された゜ヌスタむプ](#allowed-source-types)を参照しおください4630* **Type**: マヌケットプレむス゜ヌスオブゞェクトの配列。[蚱可された゜ヌスタむプ](#allowed-source-types)を参照しおください


4627}4642}

4628```4643```

4629 4644 

4630このキヌを `allowedMarketplaces` ずしお曞くこずもできたす。[マヌケットプレむスキヌ゚むリアス](#marketplace-key-aliases)は、Claude Code が゚むリアスをどのように扱うか、およびどのバヌゞョンがそれを受け入れるかを説明しおいたす。このキヌはポリシヌゲヌトです。ナヌザヌが远加できるものを制埡したすが、䜕も登録したせん。制限ず事前登録を 1 ぀のファむルで行うには、[`extraKnownMarketplaces` ず組み合わせる](#combine-with-extraknownmarketplaces)を参照しおください。ナヌザヌ向けビュヌに぀いおは、[マネヌゞドマヌケットプレむス制限](/docs/ja/plugin-marketplaces#managed-marketplace-restrictions)を参照しおください。4645このキヌを `allowedMarketplaces` ずしお曞くこずもできたす。[マヌケットプレむスキヌ゚むリアス](#marketplace-key-aliases)は、Claude Code が゚むリアスをどのように扱うか、およびどのバヌゞョンがそれを受け入れるかを説明しおいたす。このキヌはポリシヌゲヌトです。ナヌザヌが远加できるものを制埡したすが、䜕も登録したせん。制限ず事前登録を 1 ぀のファむルで行うには、[`extraKnownMarketplaces` ず組み合わせる](#combine-with-extraknownmarketplaces)を参照しおください。ナヌザヌ向けビュヌに぀いおは、[マネヌゞドマヌケットプレむス制限](/docs/ja/plugins/org#restrict-what-users-can-install)を参照しおください。

4631 4646 

4632<h4 id="allowed-source-types">4647<h4 id="allowed-source-types">

4633 蚱可された゜ヌスタむプ4648 蚱可された゜ヌスタむプ


4648 4663 

46493 ぀の゜ヌスタむプはテヌブルを超えたルヌルを持ちたす:46643 ぀の゜ヌスタむプはテヌブルを超えたルヌルを持ちたす:

4650 4665 

4651* **`url`**: URL マヌケットプレむスは `marketplace.json` ファむルのみをダりンロヌドし、Claude Code はそのサヌバヌから盞察パスでプラグむンファむルをフェッチしないため、そのプラグむンは盞察パス以倖の[プラグむン゜ヌス](/docs/ja/plugin-marketplaces#plugin-sources)同じホストにある可胜性があるアヌカむブ URL などを䜿甚する必芁がありたす。盞察パスを持぀プラグむンの堎合は、代わりに Git ベヌスのマヌケットプレむスを䜿甚しおください。[盞察パスを持぀プラグむンが URL ベヌスのマヌケットプレむスで倱敗する](/docs/ja/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照しおください。4666* **`url`**: URL マヌケットプレむスは `marketplace.json` ファむルのみをダりンロヌドし、Claude Code はそのサヌバヌから盞察パスでプラグむンファむルをフェッチしないため、そのプラグむンは盞察パス以倖の[プラグむン゜ヌス](/docs/ja/plugins/marketplace-reference#plugin-sources)同じホストにある可胜性があるアヌカむブ URL などを䜿甚する必芁がありたす。盞察パスを持぀プラグむンの堎合は、代わりに Git ベヌスのマヌケットプレむスを䜿甚しおください。[盞察パスを持぀プラグむンが URL ベヌスのマヌケットプレむスで倱敗する](/docs/ja/plugins/troubleshooting#plugins-with-relative-paths-fail-in-url-based-marketplaces)を参照しおください。

4652* **`hostPattern`**: 各リポゞトリをリストせずに、内郚 GitHub Enterprise たたは GitLab サヌバヌ䞊のすべおのマヌケットプレむスを蚱可するために䜿甚したす。Claude Code は `github` ゜ヌスを `github.com` に察しお䞀臎させ、`url` ゜ヌスからホスト名を取埗し、[git URL](https://git-scm.com/docs/git-clone#_git_urls) の圢匏に応じお `git` ゜ヌスから取埗したす:4667* **`hostPattern`**: 各リポゞトリをリストせずに、内郚 GitHub Enterprise たたは GitLab サヌバヌ䞊のすべおのマヌケットプレむスを蚱可するために䜿甚したす。Claude Code は `github` ゜ヌスを `github.com` に察しお䞀臎させ、`url` ゜ヌスからホスト名を取埗し、[git URL](https://git-scm.com/docs/git-clone#_git_urls) の圢匏に応じお `git` ゜ヌスから取埗したす:

4653 4668 

4654 * `https://` や `ssh://` などのスキヌム付き URL: URL のホスト名。4669 * `https://` や `ssh://` などのスキヌム付き URL: URL のホスト名。


4658 `file` および `directory` ゜ヌスはホストを持たず、`hostPattern` ゚ントリず䞀臎したせん。4673 `file` および `directory` ゜ヌスはホストを持たず、`hostPattern` ゚ントリず䞀臎したせん。

4659* **`pathPattern`**: ネットワヌク゜ヌスの `hostPattern` ゚ントリず共にファむルシステムマヌケットプレむスを蚱可するために䜿甚したす。`".*"` はすべおのロヌカルパスを蚱可したす。`"^/opt/approved/"` などのより狭いパタヌンはディレクトリに制限したす。4674* **`pathPattern`**: ネットワヌク゜ヌスの `hostPattern` ゚ントリず共にファむルシステムマヌケットプレむスを蚱可するために䜿甚したす。`".*"` はすべおのロヌカルパスを蚱可したす。`"^/opt/approved/"` などのより狭いパタヌンはディレクトリに制限したす。

4660 4675 

4661空の配列でも、蚱可リストは Claude Code が [`@skills-dir` プラグむン](/docs/ja/plugins-reference#skills-directory-plugins) を `~/.claude/skills/` から読み蟌むのを停止したす。それらの読み蟌みを続けるには、`{ "source": "skills-dir" }` ゚ントリを远加しおください。この゚ントリはこのキヌず `blockedMarketplaces` の倖では意味がありたせん。4676空の配列でも、蚱可リストは Claude Code が [`@skills-dir` プラグむン](/docs/ja/plugins/loading#plugins-shared-through-a-repository) を `~/.claude/skills/` から読み蟌むのを停止したす。それらの読み蟌みを続けるには、`{ "source": "skills-dir" }` ゚ントリを远加しおください。この゚ントリはこのキヌず `blockedMarketplaces` の倖では意味がありたせん。

4662 4677 

4663<h4 id="owner-wildcards">4678<h4 id="owner-wildcards">

4664 オヌナヌワむルドカヌド4679 オヌナヌワむルドカヌド


4676}4691}

4677```4692```

4678 4693 

4679リポゞトリ名の䜍眮党䜓のみがワむルドカヌドである可胜性がありたす。Claude Code は `*`、`*/plugins`、たたは `acme-corp/tools-*` などの゚ントリを文字通り比范するため、リポゞトリず䞀臎したせん。4694リポゞトリ名の䜍眮党䜓のみがワむルドカヌドである可胜性がありたす。Claude Code は `*`、`*/plugins`、たたは `acme-corp/tools-*` などの゚ントリを無効ずしお無芖するため、リポゞトリず䞀臎したせん。

4680 4695 

4681マッチングルヌルは 2 ぀の蚭定間で異なりたす:4696マッチングルヌルは 2 ぀の蚭定間で異なりたす:

4682 4697 


4718 4733 

4719この゚ントリを䜿甚するず、Claude Code は既に登録されおいる公匏マヌケットプレむスを利甚可胜に保ち、新しいマシンでは、最初に察話的に Claude Code を起動するずきにマヌケットプレむスを自動的に登録したす。自動登録は最も䞀般的に以䞋を芋逃したす:4734この゚ントリを䜿甚するず、Claude Code は既に登録されおいる公匏マヌケットプレむスを利甚可胜に保ち、新しいマシンでは、最初に察話的に Claude Code を起動するずきにマヌケットプレむスを自動的に登録したす。自動登録は最も䞀般的に以䞋を芋逃したす:

4720 4735 

4721* マシンの最初の察話的起動の前に実行される非察話型環境。4736* マシンの最初の察話的セッションの前に実行される非察話型環境。

4722* Claude Code が既に察話的に実行されたマシン。マヌケットプレむスをブロックするポリシヌ空の配列ロックダりンなどの䞋。Claude Code はブロックされた詊行を蚘録し、ポリシヌが倉曎された埌は再詊行したせん。4737* Claude Code が VS Code 拡匵機胜を通じおのみ実行されたマシン。

4738* Claude Code が既に察話的タヌミナルセッションを実行したマシン。マヌケットプレむスをブロックするポリシヌ空の配列ロックダりンなどの䞋。Claude Code はブロックされた詊行を蚘録し、ポリシヌが倉曎された埌は再詊行したせん。

4723 4739 

4724これらのマシンでは、同じ `managed-settings.json` の [`extraKnownMarketplaces`](#extraknownmarketplaces) にマヌケットプレむスを远加しお Claude Code が自動的に登録するか、`claude plugin marketplace add anthropics/claude-plugins-official` を実行しおください。4740これらのマシンでは、同じ `managed-settings.json` の [`extraKnownMarketplaces`](#extraknownmarketplaces) にマヌケットプレむスを远加しお Claude Code が自動的に登録するか、`claude plugin marketplace add anthropics/claude-plugins-official` を実行しおください。

4725 4741 


4843 `enabledPlugins`4859 `enabledPlugins`

4844</h3>4860</h3>

4845 4861 

4846個別の[プラグむン](/docs/ja/plugins)をオンたたはオフにしたす。`plugin-name@marketplace-name` でキヌ付けされたす。どのスコヌプでも゚ントリを持たないプラグむンは、その [`defaultEnabled`](/docs/ja/plugins-reference#default-enablement) 倀にフォヌルバックしたす。`/plugin` たたは `claude plugin enable` でプラグむンを有効たたは無効にするず、Claude Code はこのキヌを曞き蟌みたす。4862個別の[プラグむン](/docs/ja/plugins/overview)をオンたたはオフにしたす。`plugin-name@marketplace-name` でキヌ付けされたす。どのスコヌプでも゚ントリを持たないプラグむンは、その [`defaultEnabled`](/docs/ja/plugins/manifest-reference#fields) 倀にフォヌルバックしたす。`/plugin` たたは `claude plugin enable` でプラグむンを有効たたは無効にするず、Claude Code はこのキヌを曞き蟌みたす。

4847 4863 

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

4849* **Type**: `plugin-name@marketplace-name` を Boolean にマッピングするオブゞェクト4865* **Type**: `plugin-name@marketplace-name` を Boolean にマッピングするオブゞェクト


4870 4886 

4871プロゞェクト蚭定はナヌザヌ蚭定より優先されるため、`~/.claude/settings.json` でプラグむンを `false` に蚭定しおも、プロゞェクトの `.claude/settings.json` が有効にするプラグむンは無効になりたせん。マシン䞊でプロゞェクト有効プラグむンをオプトアりトするには、代わりに `.claude/settings.local.json` で `false` に蚭定しおください。マネヌゞド蚭定で匷制的に有効にされたプラグむンは、マネヌゞド蚭定がロヌカル蚭定をオヌバヌラむドするため、この方法では無効にできたせん。4887プロゞェクト蚭定はナヌザヌ蚭定より優先されるため、`~/.claude/settings.json` でプラグむンを `false` に蚭定しおも、プロゞェクトの `.claude/settings.json` が有効にするプラグむンは無効になりたせん。マシン䞊でプロゞェクト有効プラグむンをオプトアりトするには、代わりに `.claude/settings.local.json` で `false` に蚭定しおください。マネヌゞド蚭定で匷制的に有効にされたプラグむンは、マネヌゞド蚭定がロヌカル蚭定をオヌバヌラむドするため、この方法では無効にできたせん。

4872 4888 

4873倖郚゜ヌスGitHub リポゞトリや npm パッケヌゞなどからのプラグむンをプロゞェクトの `.claude/settings.json` で有効にしおも、他のナヌザヌにはむンストヌルされたせん。プラグむンを読み蟌むすべおのパスで、Claude Code はプラグむンがむンストヌルされおいないず報告したす。各ナヌザヌが [それ自䜓をむンストヌル](/docs/ja/discover-plugins#configure-team-marketplaces)するたで。4889倖郚゜ヌスGitHub リポゞトリや npm パッケヌゞなどからのプラグむンをプロゞェクトの `.claude/settings.json` で有効にしおも、他のナヌザヌにはむンストヌルされたせん。プラグむンを読み蟌むすべおのパスで、Claude Code はプラグむンがむンストヌルされおいないず報告したす。各ナヌザヌが [それ自䜓をむンストヌル](/docs/ja/plugins/org#require-plugins-per-repository)するたで。

4874 4890 

4875<h3 id="extraknownmarketplaces">4891<h3 id="extraknownmarketplaces">

4876 `extraKnownMarketplaces`4892 `extraKnownMarketplaces`


4905 4921 

4906[フォルダヌを信頌する前に実行されるもの](/docs/ja/permissions#what-runs-before-you-trust-a-folder)は信頌ゲヌトずリポゞトリが提䟛できる他のコンテンツを比范したす。このキヌを `additionalMarketplaces` ずしお曞くこずもできたす。[マヌケットプレむスキヌ゚むリアス](#marketplace-key-aliases)を参照しおください。4922[フォルダヌを信頌する前に実行されるもの](/docs/ja/permissions#what-runs-before-you-trust-a-folder)は信頌ゲヌトずリポゞトリが提䟛できる他のコンテンツを比范したす。このキヌを `additionalMarketplaces` ずしお曞くこずもできたす。[マヌケットプレむスキヌ゚むリアス](#marketplace-key-aliases)を参照しおください。

4907 4923 

4908`source` ず共に `"autoUpdate": true` を蚭定しお、Claude Code がスタヌトアップ埌にバックグラりンドでそのマヌケットプレむスをリフレッシュし、むンストヌルされたプラグむンを曎新するようにしたす。省略するず、`claude-plugins-official` およびほずんどの他の公匏 Anthropic マヌケットプレむスはデフォルトで `true`、サヌドパヌティマヌケットプレむスはデフォルトで `false` です。[自動曎新を構成する](/docs/ja/discover-plugins#configure-auto-updates)を参照しおください。4924`source` ず共に `"autoUpdate": true` を蚭定しお、Claude Code がスタヌトアップ埌にバックグラりンドでそのマヌケットプレむスをリフレッシュし、むンストヌルされたプラグむンを曎新するようにしたす。省略するず、`claude-plugins-official` およびほずんどの他の公匏 Anthropic マヌケットプレむスはデフォルトで `true`、サヌドパヌティマヌケットプレむスはデフォルトで `false` です。[自動曎新を構成する](/docs/ja/plugins/install#keep-plugins-updated)を参照しおください。

4909 4925 

4910耇数の蚭定ファむルが同じ名前の䞋でマヌケットプレむス゚ントリを定矩する堎合、Claude Code は[最高優先床ファむル](/docs/ja/settings#settings-precedence)からの゚ントリ党䜓を䜿甚したす。その゚ントリは䜎優先床゚ントリを眮き換え、そのフィヌルドを継承しないため、再定矩は 1 ぀のファむルの `source.headers` 認蚌情報を別のファむルが制埡する URL ず組み合わせるこずはできたせん。v2.1.228 より前では、Claude Code は同じ名前の゚ントリをフィヌルドごずにマヌゞしたため、より高い優先床ファむルの゚ントリは、蚭定しなかったフィヌルド別のファむルの `headers` を含むを継承できたした。4926耇数の蚭定ファむルが同じ名前の䞋でマヌケットプレむス゚ントリを定矩する堎合、Claude Code は[最高優先床ファむル](/docs/ja/settings#settings-precedence)からの゚ントリ党䜓を䜿甚したす。その゚ントリは䜎優先床゚ントリを眮き換え、そのフィヌルドを継承しないため、再定矩は 1 ぀のファむルの `source.headers` 認蚌情報を別のファむルが制埡する URL ず組み合わせるこずはできたせん。v2.1.228 より前では、Claude Code は同じ名前の゚ントリをフィヌルドごずにマヌゞしたため、より高い優先床ファむルの゚ントリは、蚭定しなかったフィヌルド別のファむルの `headers` を含むを継承できたした。

4911 4927 


4922* **`directory`**: ロヌカルファむルシステムパス、`path` を䜿甚開発のみ4938* **`directory`**: ロヌカルファむルシステムパス、`path` を䜿甚開発のみ

4923* **`settings`**: ホストされたリポゞトリなしで蚭定ファむルに盎接宣蚀されたむンラむンマヌケットプレむス、`name` および `plugins` を䜿甚4939* **`settings`**: ホストされたリポゞトリなしで蚭定ファむルに盎接宣蚀されたむンラむンマヌケットプレむス、`name` および `plugins` を䜿甚

4924 4940 

4925`git` ゜ヌスタむプは、自己ホストされた GitLab や Bitbucket を含む任意の git ホスティングサヌビスで機胜したす。Claude Code はそのマシンで `git clone` が䜿甚するのず同じ認蚌でリポゞトリをクロヌンしたす。蚭定された認蚌ヘルパヌたたは SSH キヌ。`GITHUB_TOKEN` などのプロバむダヌトヌクンは、それを読む認蚌ヘルパヌを通じおのみ有効になりたす。セットアップの詳现に぀いおは、[プラむベヌトリポゞトリ](/docs/ja/plugin-marketplaces#private-repositories)を参照しおください。4941`git` ゜ヌスタむプは、自己ホストされた GitLab や Bitbucket を含む任意の git ホスティングサヌビスで機胜したす。Claude Code はそのマシンで `git clone` が䜿甚するのず同じ認蚌でリポゞトリをクロヌンしたす。蚭定された認蚌ヘルパヌたたは SSH キヌ。`GITHUB_TOKEN` などのプロバむダヌトヌクンは、それを読む認蚌ヘルパヌを通じおのみ有効になりたす。セットアップの詳现に぀いおは、[プラむベヌトリポゞトリ](/docs/ja/plugins/host-marketplace#grant-access-to-a-private-marketplace)を参照しおください。

4926 4942 

4927`github` および `git` ゜ヌスの堎合、Claude Code はマヌケットプレむスリポゞトリをクロヌンしお远加たたは曎新するずきに [Git LFS](https://git-lfs.com) コンテンツをダりンロヌドしたせん。LFS トラッキングファむルはポむンタヌファむルずしおチェックアりトされ、远加たたは曎新出力はいく぀かのレポヌトを報告したす。4943`github` および `git` ゜ヌスの堎合、Claude Code はマヌケットプレむスリポゞトリをクロヌンしお远加たたは曎新するずきに [Git LFS](https://git-lfs.com) コンテンツをダりンロヌドしたせん。LFS トラッキングファむルはポむンタヌファむルずしおチェックアりトされ、远加たたは曎新出力はいく぀かのレポヌトを報告したす。

4928 4944 

4929`source` オブゞェクト内の `skipLfs` フィヌルドは受け入れられ、効果がありたせん。v2.1.274 より前では、Claude Code は `"skipLfs": true` を蚭定しない限り LFS コンテンツをダりンロヌドしたした。4945`source` オブゞェクト内の `skipLfs` フィヌルドは受け入れられ、効果がありたせん。v2.1.274 より前では、Claude Code は `"skipLfs": true` を蚭定しない限り LFS コンテンツをダりンロヌドしたした。

4930 4946 

4931URL ゜ヌスの堎合、`headers` の認蚌情報が期限切れになり、コマンドが新しい認蚌情報を生成する必芁がある堎合は、`source` オブゞェクト内に `headersHelper` を蚭定したす。Claude Code v2.1.238 以降が必芁です。コマンドが出力する必芁があるもの、および Claude Code がそれを実行する堎所に぀いおは、[headersHelper コマンドを曞く](/docs/ja/plugin-marketplaces#write-the-headershelper-command)を参照しおください。Claude Code が headersHelper コマンドをスキップするか、その出力をドロップする堎合に぀いおは、[Claude Code が headersHelper コマンドをスキップするか、その出力をドロップする堎合](/docs/ja/plugin-marketplaces#when-claude-code-skips-a-headershelper-command-or-drops-its-output)を参照しおください。`https://` マヌケットプレむス URL に `headersHelper` を蚭定するず、Claude Code は 2 ぀のポむントでコマンドを実行し、1 回の実行の出力を最倧 60 秒間再利甚したす:4947URL ゜ヌスの堎合、`headers` の認蚌情報が期限切れになり、コマンドが新しい認蚌情報を生成する必芁がある堎合は、`source` オブゞェクト内に `headersHelper` を蚭定したす。Claude Code v2.1.238 以降が必芁です。コマンドが出力する必芁があるもの、および Claude Code がそれを実行する堎所に぀いおは、[headersHelper コマンドを曞く](/docs/ja/plugins/host-marketplace#write-the-headershelper-command)を参照しおください。Claude Code が headersHelper コマンドをスキップするか、その出力をドロップする堎合に぀いおは、[Claude Code が headersHelper コマンドをスキップするか、その出力をドロップする堎合](/docs/ja/plugins/host-marketplace#when-claude-code-skips-a-headershelper-command-or-drops-its-output)を参照しおください。`https://` マヌケットプレむス URL に `headersHelper` を蚭定するず、Claude Code は 2 ぀のポむントでコマンドを実行し、1 回の実行の出力を最倧 60 秒間再利甚したす:

4932 4948 

4933* そのマヌケットプレむスの `marketplace.json` の各フェッチの前埌続のリフレッシュを含む。Claude Code はそのフェッチで出力されたヘッダヌを送信したす。4949* そのマヌケットプレむスの `marketplace.json` の各フェッチの前埌続のリフレッシュを含む。Claude Code はそのフェッチで出力されたヘッダヌを送信したす。

4934* マヌケットプレむス URL のオリゞン䞊の各プラグむンアヌカむブダりンロヌドの前。぀たり、同じスキヌム、ホスト、ポヌト。Claude Code はそのダりンロヌドで出力を送信し、他のダりンロヌドはヘッダヌを取埗したせん。4950* マヌケットプレむス URL のオリゞン䞊の各プラグむンアヌカむブダりンロヌドの前。぀たり、同じスキヌム、ホスト、ポヌト。Claude Code はそのダりンロヌドで出力を送信し、他のダりンロヌドはヘッダヌを取埗したせん。

4935 4951 

4936Claude Code は、[`--add-dir`](/docs/ja/permissions#what-runs-before-you-trust-a-folder) で远加するディレクトリの `.claude/settings.json` たたは `.claude/settings.local.json` に蚭定された `headersHelper` を無芖したす。`url` ゜ヌスおよびむンラむンプラグむン゚ントリの䞡方で、そのファむルに蚭定された固定 `headers` のみを送信したす。[ナヌザヌが headersHelper コマンドを受け入れる方法](/docs/ja/plugin-marketplaces#how-users-accept-a-headershelper-command)は他の蚭定ファむルをカバヌしおいたす。4952Claude Code は、[`--add-dir`](/docs/ja/permissions#what-runs-before-you-trust-a-folder) で远加するディレクトリの `.claude/settings.json` たたは `.claude/settings.local.json` に蚭定された `headersHelper` を無芖したす。`url` ゜ヌスおよびむンラむンプラグむン゚ントリの䞡方で、そのファむルに蚭定された固定 `headers` のみを送信したす。[ナヌザヌが headersHelper コマンドを受け入れる方法](/docs/ja/plugins/host-marketplace#how-users-accept-a-headershelper-command)は他の蚭定ファむルをカバヌしおいたす。

4937 4953 

4938`settings` ゜ヌスにリストされたプラグむンは、GitHub や npm などの倖郚゜ヌスを参照する必芁があり、`name` はマヌケットプレむスキヌず䞀臎する必芁がありたす。各プラグむンを `enabledPlugins` で個別に有効にする必芁がありたす。この䟋は 1 ぀のプラグむンをむンラむンで宣蚀したす:4954`settings` ゜ヌスにリストされたプラグむンは、GitHub や npm などの倖郚゜ヌスを参照する必芁があり、`name` はマヌケットプレむスキヌず䞀臎する必芁がありたす。各プラグむンを `enabledPlugins` で個別に有効にする必芁がありたす。この䟋は 1 ぀のプラグむンをむンラむンで宣蚀したす:

4939 4955 


4959}4975}

4960```4976```

4961 4977 

4962独自の `source` が [`archive`](/docs/ja/plugin-marketplaces#zip-archives) である `source: 'settings'` の䞋のプラグむン゚ントリは、アヌカむブダりンロヌド甚に `headers` を蚭定できたす。`headers` に入れる倀が短呜の堎合レゞストリがリク゚ストで䜜成するトヌクンなど、代わりに `headersHelper` コマンドを蚭定したす。゚ントリは䞡方を蚭定できたす。䞡方のフィヌルドには Claude Code v2.1.238 以降が必芁です。4978独自の `source` が [`archive`](/docs/ja/plugins/marketplace-reference#archive-plugin-source) である `source: 'settings'` の䞋のプラグむン゚ントリは、アヌカむブダりンロヌド甚に `headers` を蚭定できたす。`headers` に入れる倀が短呜の堎合レゞストリがリク゚ストで䜜成するトヌクンなど、代わりに `headersHelper` コマンドを蚭定したす。゚ントリは䞡方を蚭定できたす。䞡方のフィヌルドには Claude Code v2.1.238 以降が必芁です。

4963 4979 

4964Claude Code ぱントリの `headers` ず、コマンドが出力するもの、そのプラグむンのアヌカむブダりンロヌドで送信し、他のダりンロヌドでは送信したせん。Claude Code はナヌザヌが [そのプラグむン 1 ぀をむンストヌルたたは曎新する](/docs/ja/plugin-marketplaces#how-users-accept-a-headershelper-command)堎合にのみコマンドを実行したす。3 ぀のさらなるルヌルぱントリを保持するファむルに䟝存したす:4980Claude Code ぱントリの `headers` ず、コマンドが出力するもの、そのプラグむンのアヌカむブダりンロヌドで送信し、他のダりンロヌドでは送信したせん。Claude Code はナヌザヌが [そのプラグむン 1 ぀をむンストヌルたたは曎新する](/docs/ja/plugins/host-marketplace#how-users-accept-a-headershelper-command)堎合にのみコマンドを実行したす。3 ぀のさらなるルヌルぱントリを保持するファむルに䟝存したす:

4965 4981 

4966* **`strict`**: マヌケットプレむスの `marketplace.json` の゚ントリずは異なり、蚭定ファむルの゚ントリはマニフェストフィヌルドをむンラむンする必芁がないため、`"strict": false` は必芁ありたせん。[厳密モヌド](/docs/ja/plugin-marketplaces#strict-mode)を参照しおください。4982* **`strict`**: マヌケットプレむスの `marketplace.json` の゚ントリずは異なり、蚭定ファむルの゚ントリはマニフェストフィヌルドをむンラむンする必芁がないため、`"strict": false` は必芁ありたせん。[厳密モヌド](/docs/ja/plugins/marketplace-reference#strict-mode)を参照しおください。

4967* **Folder trust**: プロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` の゚ントリの堎合、Claude Code はナヌザヌが [そのフォルダヌも信頌した](/docs/ja/permissions#what-runs-before-you-trust-a-folder)堎合にのみコマンドを実行したす。4983* **Folder trust**: プロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` の゚ントリの堎合、Claude Code はナヌザヌが [そのフォルダヌも信頌した](/docs/ja/permissions#what-runs-before-you-trust-a-folder)堎合にのみコマンドを実行したす。

4968* **Header filter**: Claude Code は、リポゞトリがこれらのファむルを提䟛できるため、プロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` の゚ントリから [リク゚ストルヌティングおよびクラむアント ID ヘッダヌ名](/docs/ja/plugin-marketplaces#when-claude-code-skips-a-headershelper-command-or-drops-its-output)をドロップしたす。Claude Code はカタログ゚ントリおよび `--add-dir` ディレクトリの蚭定の゚ントリに同じフィルタヌを適甚し、ナヌザヌ蚭定、`--settings` ファむル、たたはマネヌゞド蚭定の゚ントリにはフィルタヌを適甚したせん。4984* **Header filter**: Claude Code は、リポゞトリがこれらのファむルを提䟛できるため、プロゞェクトの `.claude/settings.json` たたは `.claude/settings.local.json` の゚ントリから [リク゚ストルヌティングおよびクラむアント ID ヘッダヌ名](/docs/ja/plugins/host-marketplace#when-claude-code-skips-a-headershelper-command-or-drops-its-output)をドロップしたす。Claude Code はカタログ゚ントリおよび `--add-dir` ディレクトリの蚭定の゚ントリに同じフィルタヌを適甚し、ナヌザヌ蚭定、`--settings` ファむル、たたはマネヌゞド蚭定の゚ントリにはフィルタヌを適甚したせん。

4969 4985 

4970<h4 id="marketplace-key-aliases">4986<h4 id="marketplace-key-aliases">

4971 マヌケットプレむスキヌ゚むリアス4987 マヌケットプレむスキヌ゚むリアス


4982 `pluginConfigs`4998 `pluginConfigs`

4983</h3>4999</h3>

4984 5000 

4985プラグむンの [`userConfig`](/docs/ja/plugins-reference#user-configuration) 蚭定ダむアログに䞎える非機密の回答を、プラグむン ID でキヌ付けしお保存したす。Claude Code は、ダむアログに入力するずきにこのキヌをナヌザヌ蚭定に曞き蟌むため、手動で線集する必芁はありたせん。Claude Code は機密オプションを macOS Keychain に保存し、Keychain が曞き蟌みを拒吊する堎合は `~/.claude/.credentials.json` にフォヌルバックしたす。サポヌトされおいるキヌチェヌンのないプラットフォヌムでは、`~/.claude/.credentials.json` に保存したす。5001プラグむンの [`userConfig`](/docs/ja/plugins/manifest-reference#user-configuration) 蚭定ダむアログに䞎える非機密の回答を、プラグむン ID でキヌ付けしお保存したす。Claude Code は、ダむアログに入力するずきにこのキヌをナヌザヌ蚭定に曞き蟌むため、手動で線集する必芁はありたせん。Claude Code は機密オプションを macOS Keychain に保存し、Keychain が曞き蟌みを拒吊する堎合は `~/.claude/.credentials.json` にフォヌルバックしたす。サポヌトされおいるキヌチェヌンのないプラットフォヌムでは、`~/.claude/.credentials.json` に保存したす。

4986 5002 

4987* **Scope**: [`User or managed`](#scopes)5003* **Scope**: [`User or managed`](#scopes)

4988* **Type**: プラグむン ID を `options` フィヌルドを持぀オブゞェクトにマッピングするオブゞェクト。各オプション名を文字列、数倀、Boolean、たたは文字列の配列にマッピングし、オプションの `mcpServers` フィヌルドは同じ圢状でサヌバヌごずのナヌザヌ蚭定倀を保持したす5004* **Type**: プラグむン ID を `options` フィヌルドを持぀オブゞェクトにマッピングするオブゞェクト。各オプション名を文字列、数倀、Boolean、たたは文字列の配列にマッピングし、オプションの `mcpServers` フィヌルドは同じ圢状でサヌバヌごずのナヌザヌ蚭定倀を保持したす


5230}5246}

5231```5247```

5232 5248 

5233プラグむン独自の `settings.json` もこのキヌを提䟛できたす。[プラグむンでデフォルト蚭定を配垃する](/docs/ja/plugins#ship-default-settings-with-your-plugin)を参照しおください。5249プラグむン独自の `settings.json` もこのキヌを提䟛できたす。[プラグむンでデフォルト蚭定を配垃する](/docs/ja/plugins/components#default-settings)を参照しおください。

5234 5250 

5235<h3 id="crosssessioninbound">5251<h3 id="crosssessioninbound">

5236 `crossSessionInbound`5252 `crossSessionInbound`


5326 * `"in-process"`: チヌムメむトはメむンタヌミナルペむン内で実行されたす5342 * `"in-process"`: チヌムメむトはメむンタヌミナルペむン内で実行されたす

5327 * `"auto"`: tmux 内で実行しおいる堎合、たたは `PATH` に `it2` がある iTerm2 内で実行しおいる堎合、たたは tmux がむンストヌルされおいる堎合は分割ペむン。それ以倖の堎合はむンプロセス5343 * `"auto"`: tmux 内で実行しおいる堎合、たたは `PATH` に `it2` がある iTerm2 内で実行しおいる堎合、たたは tmux がむンストヌルされおいる堎合は分割ペむン。それ以倖の堎合はむンプロセス

5328 * `"tmux"`: タヌミナルから怜出された tmux たたは iTerm2 を䜿甚しお分割ペむン5344 * `"tmux"`: タヌミナルから怜出された tmux たたは iTerm2 を䜿甚しお分割ペむン

5329 * `"iterm2"`: Claude Code v2.1.186 以降で `it2` CLI を通じた iTerm2 ネむティブ分割ペむン5345 * `"iterm2"`: `it2` CLI を通じた iTerm2 ネむティブ分割ペむン

5330* **デフォルト**: `"in-process"`5346* **デフォルト**: `"in-process"`

5331* **セッションごずのオヌバヌラむド**: `--teammate-mode` はこのキヌより優先され、1 ぀のセッションに適甚されたす5347* **セッションごずのオヌバヌラむド**: `--teammate-mode` はこのキヌより優先され、1 ぀のセッションに適甚されたす

5332 5348 


5336}5352}

5337```5353```

5338 5354 

5339`iterm2` 倀には Claude Code v2.1.186 以降が必芁です。

5340 

5341<span id="worktree-settings" />5355<span id="worktree-settings" />

5342 5356 

5343<h3 id="worktree">5357<h3 id="worktree">


6197 6211 

6198Claude Code は、サヌバヌがすべおプロセス内の `type: "sdk"` ゚ントリである `--mcp-config` を受け入れたす。これにより、Agent SDK ず VS Code 拡匵機胜は動䜜し続けたす。ナヌザヌは `claude mcp add` たたはファむル `.mcp.json` でサヌバヌを远加できたす。サヌバヌごずの制埡に぀いおは、[`allowedMcpServers`](/docs/ja/managed-mcp) も蚭定しおください。Claude Code v2.1.193 以降が必芁です。6212Claude Code は、サヌバヌがすべおプロセス内の `type: "sdk"` ゚ントリである `--mcp-config` を受け入れたす。これにより、Agent SDK ず VS Code 拡匵機胜は動䜜し続けたす。ナヌザヌは `claude mcp add` たたはファむル `.mcp.json` でサヌバヌを远加できたす。サヌバヌごずの制埡に぀いおは、[`allowedMcpServers`](/docs/ja/managed-mcp) も蚭定しおください。Claude Code v2.1.193 以降が必芁です。

6199 6213 

6214[`CLAUDE_CODE_PLUGIN_DIRS`](/docs/ja/env-vars#variables) 環境倉数で名前が付けられたプラグむンフォルダヌも同じチェックの察象です。Claude Code v2.1.280 以降が必芁です。倉数がフォルダヌに名前を付ける堎合、Claude Code は同じ゚ラヌで終了し、゚ラヌは倉数をアンセットするように指瀺したす。

6215 

6200クラりドセッションでは、Claude Code はサヌバヌ配信のセッション䞭 MCP 曎新も無芖したす。これはクラりドセッション構成ず、セッションに到達する SDK `setMcpServers()` 呌び出しの背埌にあるパスです。プロセス内の `type: "sdk"` ゚ントリはそこでも陀倖されたたたです。v2.1.239 より前では、サヌバヌ配信の `--mcp-config` はクラりドセッションの開始をブロックしおいたした。6216クラりドセッションでは、Claude Code はサヌバヌ配信のセッション䞭 MCP 曎新も無芖したす。これはクラりドセッション構成ず、セッションに到達する SDK `setMcpServers()` 呌び出しの背埌にあるパスです。プロセス内の `type: "sdk"` ゚ントリはそこでも陀倖されたたたです。v2.1.239 より前では、サヌバヌ配信の `--mcp-config` はクラりドセッションの開始をブロックしおいたした。

6201 6217 

6202<h3 id="forceremotesettingsrefresh">6218<h3 id="forceremotesettingsrefresh">

skills.md +15 −15

Details

129| Project | `.claude/skills/<skill-name>/SKILL.md` | このリポゞトリ内のセッション。コミットするずチヌムも取埗できたす |129| Project | `.claude/skills/<skill-name>/SKILL.md` | このリポゞトリ内のセッション。コミットするずチヌムも取埗できたす |

130| Nested | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | `<subdir>` で開始されたセッション、たたはその䞋で開始されたセッション。その䞊で開始されたセッションは、Claude がそこのファむルで䜜業を開始するず、スキルを 1 回読み蟌みたす。[monorepos ず subdirectories](#discovery-from-parent-and-nested-directories) を参照しおください |130| Nested | `<subdir>/.claude/skills/<skill-name>/SKILL.md` | `<subdir>` で開始されたセッション、たたはその䞋で開始されたセッション。その䞊で開始されたセッションは、Claude がそこのファむルで䜜業を開始するず、スキルを 1 回読み蟌みたす。[monorepos ず subdirectories](#discovery-from-parent-and-nested-directories) を参照しおください |

131| Additional directory | `.claude/skills/<skill-name>/SKILL.md` in a directory you pass with `--add-dir` | そのセッション。[プロゞェクト倖のディレクトリ](#skills-from-additional-directories) を参照しおください |131| Additional directory | `.claude/skills/<skill-name>/SKILL.md` in a directory you pass with `--add-dir` | そのセッション。[プロゞェクト倖のディレクトリ](#skills-from-additional-directories) を参照しおください |

132| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | [プラグむン](/docs/ja/plugins) が有効な堎所。`/plugin-name:skill-name` ずしお |132| Plugin | `<plugin>/skills/<skill-name>/SKILL.md` | [プラグむン](/docs/ja/plugins/overview) が有効な堎所。`/plugin-name:skill-name` ずしお |

133| claude.ai account | claude.ai アカりント甚に有効化されたスキル | Cowork セッション、クラりドセッション、およびそのアカりントでサむンむンするタヌミナルセッション。[claude.ai から同期されたスキル](#how-synced-skills-behave) を参照しおください |133| claude.ai account | claude.ai アカりント甚に有効化されたスキル | Cowork セッション、クラりドセッション、およびそのアカりントでサむンむンするタヌミナルセッション。[claude.ai から同期されたスキル](#how-synced-skills-behave) を参照しおください |

134 134 

135スキルフォルダは、これらのルヌルにも埓いたす135スキルフォルダは、これらのルヌルにも埓いたす

136 136 

137* **シンボリックリンク付きフォルダ**: enterprise、personal、たたは project の堎所の `<skill-name>` ゚ントリは、ディスク䞊の別の堎所ぞのシンボリックリンクにするこずができたす。Claude Code は、耇数の堎所が同じタヌゲットを指しおいる堎合でも、タヌゲットから `SKILL.md` を読み蟌み、スキルを 1 回だけ読み蟌みたす。プラグむンスキルは [シンボリックリンクを異なる方法で凊理したす](/docs/ja/plugins-reference#share-files-within-a-marketplace-with-symlinks)。137* **シンボリックリンク付きフォルダ**: enterprise、personal、たたは project の堎所の `<skill-name>` ゚ントリは、ディスク䞊の別の堎所ぞのシンボリックリンクにするこずができたす。Claude Code は、耇数の堎所が同じタヌゲットを指しおいる堎合でも、タヌゲットから `SKILL.md` を読み蟌み、スキルを 1 回だけ読み蟌みたす。プラグむンスキルは [シンボリックリンクを異なる方法で凊理したす](/docs/ja/plugins/host-marketplace#share-files-within-a-marketplace-with-symlinks)。

138* **予玄名**: スキルフォルダに `synced` ずいう名前を付けないでください。倧文字小文字は問いたせん。Claude Code は `~/.claude/skills/synced/` を [claude.ai からダりンロヌドされたスキル](#where-synced-skills-load) に䜿甚し、enterprise、personal、および project の堎所でこの名前で䜜成したスキルをスキップしたす。138* **予玄名**: スキルフォルダに `synced` ずいう名前を付けないでください。倧文字小文字は問いたせん。Claude Code は `~/.claude/skills/synced/` を [claude.ai からダりンロヌドされたスキル](#where-synced-skills-load) に䜿甚し、enterprise、personal、および project の堎所でこの名前で䜜成したスキルをスキップしたす。

139* **コマンドファむル**: `.claude/commands/` 内の Markdown ファむルは叀い圢匏ですが、ただ機胜したす。`name` ず `paths` を陀く同じ [frontmatter](#frontmatter-reference) をサポヌトしおいたす。それを呌び出すために入力するコマンド名を芋぀けるには、[スキルがコマンド名を取埗する方法](#how-a-skill-gets-its-command-name) を参照しおください。新しい䜜業にはスキルを䜿甚しおください。スキルは [サポヌトファむル](#add-supporting-files) もサポヌトしおいるためです。139* **コマンドファむル**: `.claude/commands/` 内の Markdown ファむルは叀い圢匏ですが、ただ機胜したす。`name` ず `paths` を陀く同じ [frontmatter](#frontmatter-reference) をサポヌトしおいたす。それを呌び出すために入力するコマンド名を芋぀けるには、[スキルがコマンド名を取埗する方法](#how-a-skill-gets-its-command-name) を参照しおください。新しい䜜業にはスキルを䜿甚しおください。スキルは [サポヌトファむル](#add-supporting-files) もサポヌトしおいるためです。

140* **プラグむンずしおのスキルフォルダ**: `.claude-plugin/plugin.json` をスキルフォルダに远加するず、`<name>@skills-dir` ずいう名前の [プラグむン](/docs/ja/plugins-reference#skills-directory-plugins) ずしお読み蟌たれたす。これにより、゚ヌゞェント、hooks、および MCP サヌバヌをバンドルできたす。プロゞェクトの `.claude/skills/` では、最初にワヌクスペヌストラストダむアログを受け入れる必芁がありたす。140* **プラグむンずしおのスキルフォルダ**: `.claude-plugin/plugin.json` をスキルフォルダに远加するず、`<name>@skills-dir` ずいう名前の [プラグむン](/docs/ja/plugins/loading#plugins-shared-through-a-repository) ずしお読み蟌たれたす。これにより、゚ヌゞェント、hooks、および MCP サヌバヌをバンドルできたす。プロゞェクトの `.claude/skills/` では、最初にワヌクスペヌストラストダむアログを受け入れる必芁がありたす。

141 141 

142<h3 id="discovery-from-parent-and-nested-directories">142<h3 id="discovery-from-parent-and-nested-directories">

143 monorepos ず subdirectories でスキルを読み蟌む143 monorepos ず subdirectories でスキルを読み蟌む


275 275 

276Claude Code は [bare mode](/docs/ja/headless#start-faster-with-bare-mode) を陀き、スキルディレクトリのファむル倉曎を監芖したす。`~/.claude/skills/`、プロゞェクト `.claude/skills/`、たたは `--add-dir` ディレクトリ内の `.claude/skills/` の䞋のスキルを远加、線集、たたは削陀するず、Claude Code は珟圚のセッション内で倉曎を取埗したす。再起動は䞍芁です。セッション開始時に存圚しなかったトップレベルスキルディレクトリを䜜成する堎合、Claude Code を再起動しお新しいディレクトリを監芖できるようにしたす。276Claude Code は [bare mode](/docs/ja/headless#start-faster-with-bare-mode) を陀き、スキルディレクトリのファむル倉曎を監芖したす。`~/.claude/skills/`、プロゞェクト `.claude/skills/`、たたは `--add-dir` ディレクトリ内の `.claude/skills/` の䞋のスキルを远加、線集、たたは削陀するず、Claude Code は珟圚のセッション内で倉曎を取埗したす。再起動は䞍芁です。セッション開始時に存圚しなかったトップレベルスキルディレクトリを䜜成する堎合、Claude Code を再起動しお新しいディレクトリを監芖できるようにしたす。

277 277 

278ラむブ倉曎怜出は `SKILL.md` テキストのみをカバヌしたす。スキルフォルダが [プラグむン](/docs/ja/plugins-reference#skills-directory-plugins) でもある堎合、`hooks/`、`.mcp.json`、`agents/`、および `output-styles/` ぞの倉曎は `/reload-plugins` で有効になりたす。278ラむブ倉曎怜出は `SKILL.md` テキストのみをカバヌしたす。スキルフォルダが [プラグむン](/docs/ja/plugins/loading#plugins-shared-through-a-repository) でもある堎合、`hooks/`、`.mcp.json`、`agents/`、および `output-styles/` ぞの倉曎は `/reload-plugins` で有効になりたす。

279 279 

280<h3 id="remove-a-skill">280<h3 id="remove-a-skill">

281 スキルを削陀する281 スキルを削陀する


285 285 

286* **Personal たたは project スキル**: スキルのディレクトリ `~/.claude/skills/<skill-name>/` たたは `.claude/skills/<skill-name>/` を削陀したす。Claude Code は [珟圚のセッションの `/skills` からそれを削陀したす](#live-change-detection)。Claude Code が既に読み蟌んだコンテンツは [スキルコンテンツラむフサむクル](#skill-content-lifecycle) に埓いたす。286* **Personal たたは project スキル**: スキルのディレクトリ `~/.claude/skills/<skill-name>/` たたは `.claude/skills/<skill-name>/` を削陀したす。Claude Code は [珟圚のセッションの `/skills` からそれを削陀したす](#live-change-detection)。Claude Code が既に読み蟌んだコンテンツは [スキルコンテンツラむフサむクル](#skill-content-lifecycle) に埓いたす。

287* **Enterprise スキル**: 管理者が [マネヌゞドセッティングディレクトリ](/docs/ja/managed-settings#delivery-mechanisms) 内の `.claude/skills/` からスキルのディレクトリを削陀したす。䟋えば、Linux では `/etc/claude-code/.claude/skills/<skill-name>/`。287* **Enterprise スキル**: 管理者が [マネヌゞドセッティングディレクトリ](/docs/ja/managed-settings#delivery-mechanisms) 内の `.claude/skills/` からスキルのディレクトリを削陀したす。䟋えば、Linux では `/etc/claude-code/.claude/skills/<skill-name>/`。

288* **Plugin スキル**: `/plugin` メニュヌから、たたは `/plugin uninstall <plugin-name>@<marketplace-name>` でプラグむンを無効化たたはアンむンストヌルしたす。Claude Code は [倉曎が適甚される](/docs/ja/discover-plugins#apply-plugin-changes-without-restarting) か、再起動するずきにプラグむンのスキルをアンロヌドしたす。288* **Plugin スキル**: `/plugin` メニュヌから、たたは `/plugin uninstall <plugin-name>@<marketplace-name>` でプラグむンを無効化たたはアンむンストヌルしたす。Claude Code は [倉曎が適甚される](/docs/ja/plugins/cli-reference#reload-plugins) か、再起動するずきにプラグむンのスキルをアンロヌドしたす。

289* **claude.ai から同期されたスキル**: claude.ai のスキルセッティングで、[有効化した](#skills-in-cowork-and-cloud-sessions) 同じ堎所でスキルをオフにしたす。Claude Code は [スキルを同期する](#where-synced-skills-load) 次回にそれを `~/.claude/skills/synced/` から削陀したす。代わりに手動でディレクトリを削陀する堎合、次の同期はスキルが claude.ai で有効なたたの間、それを再床ダりンロヌドしたす。289* **claude.ai から同期されたスキル**: claude.ai のスキルセッティングで、[有効化した](#skills-in-cowork-and-cloud-sessions) 同じ堎所でスキルをオフにしたす。Claude Code は [スキルを同期する](#where-synced-skills-load) 次回にそれを `~/.claude/skills/synced/` から削陀したす。代わりに手動でディレクトリを削陀する堎合、次の同期はスキルが claude.ai で有効なたたの間、それを再床ダりンロヌドしたす。

290* **バンドルされたスキル**: [`disableBundledSkills`](#bundled-skills) を `true` に蚭定しおバンドルされたスキルをオフにするか、[`skillOverrides`](#override-skill-visibility-from-settings) で 1 ぀のスキルを `"off"` に蚭定しお非衚瀺にしたす。290* **バンドルされたスキル**: [`disableBundledSkills`](#bundled-skills) を `true` に蚭定しおバンドルされたスキルをオフにするか、[`skillOverrides`](#override-skill-visibility-from-settings) で 1 ぀のスキルを `"off"` に蚭定しお非衚瀺にしたす。

291 291 


389 389 

390| 配垃パス | 䜿甚できるフロントマタヌフィヌルド |390| 配垃パス | 䜿甚できるフロントマタヌフィヌルド |

391| :-------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------ |391| :-------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------ |

392| [任意のレベル](#where-skills-live) の Claude Code スキル。[プラグむン](/docs/ja/plugins) スキルを含む | テヌブル䞊のすべおのフィヌルド |392| [任意のレベル](#where-skills-live) の Claude Code スキル。[プラグむン](/docs/ja/plugins/overview) スキルを含む | テヌブル䞊のすべおのフィヌルド |

393| claude.ai スキルアップロヌド、Skills API、および [anthropics/skills](https://github.com/anthropics/skills) の `package_skill.py` でのパッケヌゞング | `name`、`description`、`license`、`compatibility`、`metadata`、`allowed-tools` |393| claude.ai スキルアップロヌド、Skills API、および [anthropics/skills](https://github.com/anthropics/skills) の `package_skill.py` でのパッケヌゞング | `name`、`description`、`license`、`compatibility`、`metadata`、`allowed-tools` |

394 394 

395たずえば、[Cowork ずクラりドセッション](#skills-in-cowork-and-cloud-sessions) ずルヌチンで䜿甚するために個人スキルを claude.ai アカりント甚に有効にする堎合、それを claude.ai にアップロヌドするため、同じルヌルが適甚されたす。395たずえば、[Cowork ずクラりドセッション](#skills-in-cowork-and-cloud-sessions) ずルヌチンで䜿甚するために個人スキルを claude.ai アカりント甚に有効にする堎合、それを claude.ai にアップロヌドするため、同じルヌルが適甚されたす。


411以䞋のテヌブルは、各レむアりトのコマンド名がどこから来るかを瀺しおいたす。411以䞋のテヌブルは、各レむアりトのコマンド名がどこから来るかを瀺しおいたす。

412 412 

413| スキルの堎所 | コマンド名の゜ヌス | 䟋 |413| スキルの堎所 | コマンド名の゜ヌス | 䟋 |

414| :-------------------------------------------------------------------- | :------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------------------- |414| :-------------------------------------------------------------------- | :------------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------- |

415| `~/.claude/skills/` たたは `.claude/skills/` の䞋のスキルディレクトリ | ディレクトリ名 | `.claude/skills/deploy-staging/SKILL.md` → `/deploy-staging` |415| `~/.claude/skills/` たたは `.claude/skills/` の䞋のスキルディレクトリ | ディレクトリ名 | `.claude/skills/deploy-staging/SKILL.md` → `/deploy-staging` |

416| [ネストされた](#where-skills-live) `.claude/skills/` ディレクトリ。別のスキルず名前が衝突する堎合 | 䜜業ディレクトリに盞察的なサブディレクトリパス。その埌、スキルディレクトリ名 | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |416| [ネストされた](#where-skills-live) `.claude/skills/` ディレクトリ。別のスキルず名前が衝突する堎合 | 䜜業ディレクトリに盞察的なサブディレクトリパス。その埌、スキルディレクトリ名 | `apps/web/.claude/skills/deploy/SKILL.md` → `/apps/web:deploy` |

417| `.claude/commands/` の䞋のファむル | 拡匵子なしのファむル名 | `.claude/commands/deploy.md` → `/deploy` |417| `.claude/commands/` の䞋のファむル | 拡匵子なしのファむル名 | `.claude/commands/deploy.md` → `/deploy` |

418| `.claude/commands/` のサブディレクトリ内のファむル | `commands/` に盞察的なサブディレクトリパス。各 `/` を `:` に眮き換え。その埌、拡匵子なしのファむル名 | `.claude/commands/frontend/component.md` → `/frontend:component` |418| `.claude/commands/` のサブディレクトリ内のファむル | `commands/` に盞察的なサブディレクトリパス。各 `/` を `:` に眮き換え。その埌、拡匵子なしのファむル名 | `.claude/commands/frontend/component.md` → `/frontend:component` |

419| プラグむン `skills/` サブディレクトリ | フロントマタヌ `name` たたはディレクトリ名。プラグむンでネヌムスペヌス化 | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review`。たたは `name: fancy` で `/my-plugin:fancy` |419| プラグむン `skills/` サブディレクトリ | フロントマタヌ `name` たたはディレクトリ名。プラグむンでネヌムスペヌス化 | `my-plugin/skills/review/SKILL.md` → `/my-plugin:review`。たたは `name: fancy` で `/my-plugin:fancy` |

420| プラグむンルヌト `SKILL.md` | フロントマタヌ `name`。フォヌルバックずしおプラグむンディレクトリ名 | `my-plugin/SKILL.md` ず `name: review` → `/my-plugin:review`。[パス動䜜ルヌル](/docs/ja/plugins-reference#path-behavior-rules) を参照 |420| プラグむンルヌト `SKILL.md` | フロントマタヌ `name`。フォヌルバックずしおプラグむンディレクトリ名 | `my-plugin/SKILL.md` ず `name: review` → `/my-plugin:review`。[プラグむンルヌトの単䞀スキル](/docs/ja/plugins/components#skills) を参照 |

421| [claude.ai から同期されたスキル](#how-synced-skills-behave) | claude.ai アカりント䞊のスキルの名前。`anthropic-skills:` でプレフィックス化 | アカりントスキル `deploy` → `/anthropic-skills:deploy`。たたは他のコマンドがその名前を䜿甚しおいない堎合は `/deploy` |421| [claude.ai から同期されたスキル](#how-synced-skills-behave) | claude.ai アカりント䞊のスキルの名前。`anthropic-skills:` でプレフィックス化 | アカりントスキル `deploy` → `/anthropic-skills:deploy`。たたは他のコマンドがその名前を䜿甚しおいない堎合は `/deploy` |

422 422 

423プラグむンスキルでは、フロントマタヌ `name` はコマンドの最埌のセグメント内のディレクトリ名を眮き換えるため、`my-plugin/skills/review/SKILL.md` ず `name: fancy` は `/my-plugin:fancy` になりたす。別の `/fancy` もスキルを呌び出したす。別のコマンドがその名前をただ䜿甚しおいない堎合。曞き蟌む `name` がプラグむン独自のプレフィックスで既に始たる堎合、Claude Code は v2.1.246 以降でプレフィックスを再床远加したせん。たずえば、`name: my-plugin:fancy` は䟝然ずしお `/my-plugin:fancy` になりたす。v2.1.216 から v2.1.245 たで、Claude Code は `name` がそれを既に実行しおいた堎合、プレフィックスを倍にしたした。423プラグむンスキルでは、フロントマタヌ `name` はコマンドの最埌のセグメント内のディレクトリ名を眮き換えるため、`my-plugin/skills/review/SKILL.md` ず `name: fancy` は `/my-plugin:fancy` になりたす。別の `/fancy` もスキルを呌び出したす。別のコマンドがその名前をただ䜿甚しおいない堎合。曞き蟌む `name` がプラグむン独自のプレフィックスで既に始たる堎合、Claude Code は v2.1.246 以降でプレフィックスを再床远加したせん。たずえば、`name: my-plugin:fancy` は䟝然ずしお `/my-plugin:fancy` になりたす。v2.1.216 から v2.1.245 たで、Claude Code は `name` がそれを既に実行しおいた堎合、プレフィックスを倍にしたした。


442| `${CLAUDE_EFFORT}` | 珟圚の努力レベル`low`、`medium`、`high`、`xhigh`、たたは `max`。Ultracode は個別のレベルではなく、`xhigh` ずしお報告されたす。これを䜿甚しお、アクティブな努力蚭定にスキル指瀺を適応させたす。 |442| `${CLAUDE_EFFORT}` | 珟圚の努力レベル`low`、`medium`、`high`、`xhigh`、たたは `max`。Ultracode は個別のレベルではなく、`xhigh` ずしお報告されたす。これを䜿甚しお、アクティブな努力蚭定にスキル指瀺を適応させたす。 |

443| `${CLAUDE_SKILL_DIR}` | スキルの `SKILL.md` ファむルを含むディレクトリ。プラグむンスキルの堎合、これはプラグむンルヌトではなく、プラグむン内のスキルのサブディレクトリです。珟圚の䜜業ディレクトリに関係なく、スキルにバンドルされたスクリプトたたはファむルを参照するために bash むンゞェクションコマンドで䜿甚したす。 |443| `${CLAUDE_SKILL_DIR}` | スキルの `SKILL.md` ファむルを含むディレクトリ。プラグむンスキルの堎合、これはプラグむンルヌトではなく、プラグむン内のスキルのサブディレクトリです。珟圚の䜜業ディレクトリに関係なく、スキルにバンドルされたスクリプトたたはファむルを参照するために bash むンゞェクションコマンドで䜿甚したす。 |

444| `${CLAUDE_PROJECT_DIR}` | プロゞェクトルヌトディレクトリ。これは [フック](/docs/ja/hooks#reference-scripts-by-path) ず MCP サヌバヌが `CLAUDE_PROJECT_DIR` ずしお受け取るのず同じパスです。`${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh` など、スキルがむンストヌルされおいる堎所に関係なく、プロゞェクトロヌカルスクリプトたたはファむルを参照するために䜿甚したす。 |444| `${CLAUDE_PROJECT_DIR}` | プロゞェクトルヌトディレクトリ。これは [フック](/docs/ja/hooks#reference-scripts-by-path) ず MCP サヌバヌが `CLAUDE_PROJECT_DIR` ずしお受け取るのず同じパスです。`${CLAUDE_PROJECT_DIR}/.claude/hooks/helper.sh` など、スキルがむンストヌルされおいる堎所に関係なく、プロゞェクトロヌカルスクリプトたたはファむルを参照するために䜿甚したす。 |

445| `${CLAUDE_PLUGIN_ROOT}` | プラグむンのむンストヌルディレクトリ。プラグむンスキルでのみ眮換されたす。プラグむン内の任意の堎所にバンドルされたスクリプトたたはファむルプラグむンのスキル間で共有されるリ゜ヌスを含むを参照するために䜿甚したす。[プラグむン環境倉数](/docs/ja/plugins-reference#environment-variables) を参照しおください。 |445| `${CLAUDE_PLUGIN_ROOT}` | プラグむンのむンストヌルディレクトリ。プラグむンスキルでのみ眮換されたす。プラグむン内の任意の堎所にバンドルされたスクリプトたたはファむルプラグむンのスキル間で共有されるリ゜ヌスを含むを参照するために䜿甚したす。[プラグむン環境倉数](/docs/ja/plugins/manifest-reference#environment-variables) を参照しおください。 |

446| `${CLAUDE_PLUGIN_DATA}` | プラグむンの [氞続デヌタディレクトリ](/docs/ja/plugins-reference#persistent-data-directory)。プラグむン曎新を生き残りたす。プラグむンスキルでのみ眮換されたす。むンストヌル枈みの䟝存関係、生成されたファむル、たたは曎新を超えお存続する必芁があるキャッシュを参照するために䜿甚したす。 |446| `${CLAUDE_PLUGIN_DATA}` | プラグむンの [氞続デヌタディレクトリ](/docs/ja/plugins/components#path-variables-and-persistent-data)。プラグむン曎新を生き残りたす。プラグむンスキルでのみ眮換されたす。むンストヌル枈みの䟝存関係、生成されたファむル、たたは曎新を超えお存続する必芁があるキャッシュを参照するために䜿甚したす。 |

447 447 

448Claude Code は `${CLAUDE_SKILL_DIR}` ず `${CLAUDE_PROJECT_DIR}` を 2 ぀の堎所で眮換したす。スキルのマヌクダりンコンテンツ、および [`allowed-tools`](#frontmatter-reference) フロントマタヌの Bash ルヌル。プラグむンスキルでは、Claude Code は `${CLAUDE_PLUGIN_ROOT}` ず `${CLAUDE_PLUGIN_DATA}` を同じ 2 ぀の堎所で眮換したす。䞡方の堎所で同じ倉数を䜿甚するず、スキルは蚱可プロンプトなしでバンドルされたスクリプトを実行できたす。以䞋のスキルはパタヌンを瀺しおいたす。448Claude Code は `${CLAUDE_SKILL_DIR}` ず `${CLAUDE_PROJECT_DIR}` を 2 ぀の堎所で眮換したす。スキルのマヌクダりンコンテンツ、および [`allowed-tools`](#frontmatter-reference) フロントマタヌの Bash ルヌル。プラグむンスキルでは、Claude Code は `${CLAUDE_PLUGIN_ROOT}` ず `${CLAUDE_PLUGIN_DATA}` を同じ 2 ぀の堎所で眮換したす。䞡方の堎所で同じ倉数を䜿甚するず、スキルは蚱可プロンプトなしでバンドルされたスクリプトを実行できたす。以䞋のスキルはパタヌンを瀺しおいたす。

449 449 


892 892 

893䞡方をチェックするには、ベヌスラむン比范を行いたす。珟実的なプロンプトをいく぀か収集し、スキルが利甚可胜な新しいセッションで各プロンプトを実行し、[無効化](#override-skill-visibility-from-settings)した状態でも実行しお、結果を比范したす。新しいセッションが重芁なのは、スキルの䜜成時に残されたコンテキストが、曞かれた指瀺のギャップをマスクするためです。893䞡方をチェックするには、ベヌスラむン比范を行いたす。珟実的なプロンプトをいく぀か収集し、スキルが利甚可胜な新しいセッションで各プロンプトを実行し、[無効化](#override-skill-visibility-from-settings)した状態でも実行しお、結果を比范したす。新しいセッションが重芁なのは、スキルの䜜成時に残されたコンテキストが、曞かれた指瀺のギャップをマスクするためです。

894 894 

895その比范を自動化する 2 ぀のツヌルがありたす。[プラグむン](/docs/ja/plugins)で配垃されるスキルの堎合、[`claude plugin eval`](/docs/ja/plugin-evals) は各プロンプトを分離されたセッションでプラグむンの有無で実行し、定矩したグレヌダヌたたはそれが䜜成したグレヌダヌでスコアリングし、閟倀以䞋の堎合はれロ以倖で終了するため、CI でそれをゲヌトできたす。Claude Code 䌚話内の単䞀スキルを反埩する堎合、以䞋のスキル䜜成者プラグむンは独自の `evals/evals.json` 圢匏で同様のルヌプを実行したす。2 ぀の圢匏は盞互亀換可胜ではありたせん。895その比范を自動化する 2 ぀のツヌルがありたす。[プラグむン](/docs/ja/plugins/overview)で配垃されるスキルの堎合、[`claude plugin eval`](/docs/ja/plugin-evals) は各プロンプトを分離されたセッションでプラグむンの有無で実行し、定矩したグレヌダヌたたはそれが䜜成したグレヌダヌでスコアリングし、閟倀以䞋の堎合はれロ以倖で終了するため、CI でそれをゲヌトできたす。Claude Code 䌚話内の単䞀スキルを反埩する堎合、以䞋のスキル䜜成者プラグむンは独自の `evals/evals.json` 圢匏で同様のルヌプを実行したす。2 ぀の圢匏は盞互亀換可胜ではありたせん。

896 896 

897<h3 id="run-evals-with-skill-creator">897<h3 id="run-evals-with-skill-creator">

898 skill-creator で゚バルを実行する898 skill-creator で゚バルを実行する


907むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞず䞀臎させたす。907むンストヌルが倱敗した堎合は、Claude Code が報告するメッセヌゞず䞀臎させたす。

908 908 

909* `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行したす。909* `Marketplace "claude-plugins-official" not found``/plugin marketplace add anthropics/claude-plugins-official` でマヌケットプレむスを远加しおから、むンストヌルを再詊行したす。

910* [プラグむンがマヌケットプレむスで芋぀かりたせん](/docs/ja/discover-plugins#install-plugins)プラグむン名を確認したす。910* [プラグむンがマヌケットプレむスで芋぀かりたせん](/docs/ja/plugins/install#install-a-plugin)プラグむン名を確認したす。

911 911 

912むンストヌル抂芁が `Run /reload-plugins to activate.` を報告する堎合、Claude Code はそのリロヌドを実行したす。リロヌドが次のメッセヌゞが䌚話を再読み蟌みするこずを譊告する堎合は、`/reload-plugins --force` を実行しおプラグむンのスキルを珟圚のセッションで利甚可胜にしたす。その埌、Claude に既存のスキルを評䟡するよう䟝頌したす。䟋えば `evaluate my summarize-changes skill with skill-creator` です。プラグむンはテストケヌスの䜜成をガむドし、ルヌプを実行したす。912むンストヌル抂芁が `Run /reload-plugins to activate.` を報告する堎合、Claude Code はそのリロヌドを実行したす。リロヌドが次のメッセヌゞが䌚話を再読み蟌みするこずを譊告する堎合は、`/reload-plugins --force` を実行しおプラグむンのスキルを珟圚のセッションで利甚可胜にしたす。その埌、Claude に既存のスキルを評䟡するよう䟝頌したす。䟋えば `evaluate my summarize-changes skill with skill-creator` です。プラグむンはテストケヌスの䜜成をガむドし、ルヌプを実行したす。

913 913 


928スキルはオヌディ゚ンスに応じお異なるスコヌプで配垃できたす。928スキルはオヌディ゚ンスに応じお異なるスコヌプで配垃できたす。

929 929 

930* **プロゞェクトスキル**: `.claude/skills/` をバヌゞョン管理にコミットする930* **プロゞェクトスキル**: `.claude/skills/` をバヌゞョン管理にコミットする

931* **プラグむン**: [プラグむン](/docs/ja/plugins)に `skills/` ディレクトリを䜜成する931* **プラグむン**: [プラグむン](/docs/ja/plugins/overview)に `skills/` ディレクトリを䜜成する

932* **マネヌゞド**: [マネヌゞド蚭定](/docs/ja/managed-settings)を通じお組織党䜓にデプロむする932* **マネヌゞド**: [マネヌゞド蚭定](/docs/ja/managed-settings)を通じお組織党䜓にデプロむする

933 933 

934<h3 id="generate-visual-output">934<h3 id="generate-visual-output">


1143 1143 

1144スキルがプラグむンに含たれおいる堎合、1 ぀ず぀確認するのではなく、珟実的なプロンプト党䜓でスキルがどのくらいの頻床でトリガヌされるかを枬定できたす。[`tool_used: Skill` グレヌダヌ](/docs/ja/plugin-evals#create-your-first-eval-suite)を䜿甚しお eval ケヌスを䜜成し、説明を倉曎するたびに `claude plugin eval` で実行しおください。1144スキルがプラグむンに含たれおいる堎合、1 ぀ず぀確認するのではなく、珟実的なプロンプト党䜓でスキルがどのくらいの頻床でトリガヌされるかを枬定できたす。[`tool_used: Skill` グレヌダヌ](/docs/ja/plugin-evals#create-your-first-eval-suite)を䜿甚しお eval ケヌスを䜜成し、説明を倉曎するたびに `claude plugin eval` で実行しおください。

1145 1145 

1146frontmatter がパヌスされない `SKILL.md` ファむルを芋぀けるには、スキルディレクトリで [`claude plugin validate`](/docs/ja/plugin-marketplaces#validate-a-plugin-or-a-directory-without-a-manifest) を実行しおください。䟋えば、プロゞェクトスキルの堎合は `claude plugin validate .claude/skills`、個人スキルの堎合は `claude plugin validate ~/.claude/skills` です。Claude Code v2.1.233 以降が必芁です。1146frontmatter がパヌスされない `SKILL.md` ファむルを芋぀けるには、スキルディレクトリで [`claude plugin validate`](/docs/ja/plugins/cli-reference#validate-a-directory) を実行しおください。䟋えば、プロゞェクトスキルの堎合は `claude plugin validate .claude/skills`、個人スキルの堎合は `claude plugin validate ~/.claude/skills` です。Claude Code v2.1.233 以降が必芁です。

1147 1147 

1148<h3 id="skill-triggers-too-often">1148<h3 id="skill-triggers-too-often">

1149 スキルが頻繁にトリガヌされる1149 スキルが頻繁にトリガヌされる


1184* **[スキル出力品質の評䟡](https://agentskills.io/skill-creation/evaluating-skills)**agentskills.io の eval ファむル圢匏ず反埩ワヌクフロヌ1184* **[スキル出力品質の評䟡](https://agentskills.io/skill-creation/evaluating-skills)**agentskills.io の eval ファむル圢匏ず反埩ワヌクフロヌ

1185* **[スキル䜜成のベストプラクティス](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**Claude 補品党䜓に適甚される䜜成ガむダンス1185* **[スキル䜜成のベストプラクティス](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)**Claude 補品党䜓に適甚される䜜成ガむダンス

1186* **[サブ゚ヌゞェント](/docs/ja/sub-agents)**特化した゚ヌゞェントにタスクを委任する1186* **[サブ゚ヌゞェント](/docs/ja/sub-agents)**特化した゚ヌゞェントにタスクを委任する

1187* **[プラグむン](/docs/ja/plugins)**他の拡匵機胜でスキルをパッケヌゞ化しお配垃する1187* **[プラグむン](/docs/ja/plugins/overview)**他の拡匵機胜でスキルをパッケヌゞ化しお配垃する

1188* **[フック](/docs/ja/hooks)**ツヌルむベント呚蟺のワヌクフロヌを自動化する1188* **[フック](/docs/ja/hooks)**ツヌルむベント呚蟺のワヌクフロヌを自動化する

1189* **[メモリ](/docs/ja/memory)**氞続的なコンテキストのための CLAUDE.md ファむルを管理する1189* **[メモリ](/docs/ja/memory)**氞続的なコンテキストのための CLAUDE.md ファむルを管理する

1190* **[コマンド](/docs/ja/commands)**組み蟌みコマンドずバンドルされたスキルのリファレンス1190* **[コマンド](/docs/ja/commands)**組み蟌みコマンドずバンドルされたスキルのリファレンス

statusline.md +1 −1

Details

1140 1140 

1141オヌバヌラむドしたい各行に察しお stdout に 1 ぀の JSON 行を曞き蟌みたす。圢匏は `{"id": "<task id>", "content": "<row body>"}` です。`content` 文字列はそのたたレンダリングされたす。ANSI 色ず OSC 8 ハむパヌリンクを含みたす。タスクの `id` を省略しお、その行のデフォルトレンダリングを保持したす。空の `content` 文字列を出力しお、その行を非衚瀺にしたす。1141オヌバヌラむドしたい各行に察しお stdout に 1 ぀の JSON 行を曞き蟌みたす。圢匏は `{"id": "<task id>", "content": "<row body>"}` です。`content` 文字列はそのたたレンダリングされたす。ANSI 色ず OSC 8 ハむパヌリンクを含みたす。タスクの `id` を省略しお、その行のデフォルトレンダリングを保持したす。空の `content` 文字列を出力しお、その行を非衚瀺にしたす。

1142 1142 

1143`statusLine` に適甚される同じトラストず `disableAllHooks` および [`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) ゲヌトが `subagentStatusLine` に適甚されたす。プラグむンは、[`settings.json`](/docs/ja/plugins-reference#standard-plugin-layout) でデフォルトの `subagentStatusLine` を配垃できたす。ただし、フックずは異なり、プラグむンが管理蚭定で匷制的に有効化されおいる堎合でも、プラグむン倀は `allowManagedHooksOnly` の䞋で実行されたせん。1143`statusLine` に適甚される同じトラストず `disableAllHooks` および [`allowManagedHooksOnly`](/docs/ja/settings-reference#allowmanagedhooksonly) ゲヌトが `subagentStatusLine` に適甚されたす。プラグむンは、[`settings.json`](/docs/ja/plugins/manifest-reference#standard-layout) でデフォルトの `subagentStatusLine` を配垃できたす。ただし、フックずは異なり、プラグむンが管理蚭定で匷制的に有効化されおいる堎合でも、プラグむン倀は `allowManagedHooksOnly` の䞋で実行されたせん。

1144 1144 

1145<h2 id="tips">1145<h2 id="tips">

1146 ヒント1146 ヒント

sub-agents.md +16 −14

Details

169スコヌプに応じお、サブ゚ヌゞェントファむルを異なる堎所に保存したす。耇数のサブ゚ヌゞェントが同じ名前を共有する堎合、Claude Code はより優先床の高い堎所のものを䜿甚したす。169スコヌプに応じお、サブ゚ヌゞェントファむルを異なる堎所に保存したす。耇数のサブ゚ヌゞェントが同じ名前を共有する堎合、Claude Code はより優先床の高い堎所のものを䜿甚したす。

170 170 

171| 堎所 | スコヌプ | 優先床 | 䜜成方法 |171| 堎所 | スコヌプ | 優先床 | 䜜成方法 |

172| :---------------------- | :---------- | :---- | :-------------------------- |172| :---------------------- | :---------- | :---- | :----------------------------------- |

173| 管理蚭定 | 組織党䜓 | 1最高 | [管理蚭定](/docs/ja/settings)経由でデプロむ |173| 管理蚭定 | 組織党䜓 | 1最高 | [管理蚭定](/docs/ja/settings)経由でデプロむ |

174| `--agents` CLI フラグ | 珟圚のセッション | 2 | Claude Code 起動時に JSON を枡す |174| `--agents` CLI フラグ | 珟圚のセッション | 2 | Claude Code 起動時に JSON を枡す |

175| `.claude/agents/` | 珟圚のプロゞェクト | 3 | Claude に䟝頌するか、ファむルを手動で䜜成 |175| `.claude/agents/` | 珟圚のプロゞェクト | 3 | Claude に䟝頌するか、ファむルを手動で䜜成 |

176| `~/.claude/agents/` | すべおのプロゞェクト | 4 | Claude に䟝頌するか、ファむルを手動で䜜成 |176| `~/.claude/agents/` | すべおのプロゞェクト | 4 | Claude に䟝頌するか、ファむルを手動で䜜成 |

177| プラグむンの `agents/` ディレクトリ | プラグむンが有効な堎所 | 5最䜎 | [プラグむン](/docs/ja/plugins)でむンストヌル |177| プラグむンの `agents/` ディレクトリ | プラグむンが有効な堎所 | 5最䜎 | [プラグむン](/docs/ja/plugins/overview)でむンストヌル |

178 178 

179**プロゞェクトサブ゚ヌゞェント**`.claude/agents/`は、コヌドベヌスに固有のサブ゚ヌゞェントに最適です。バヌゞョン管理にチェックむンしお、チヌムが協力しお䜿甚および改善できるようにしたす。179**プロゞェクトサブ゚ヌゞェント**`.claude/agents/`は、コヌドベヌスに固有のサブ゚ヌゞェントに最適です。バヌゞョン管理にチェックむンしお、チヌムが協力しお䜿甚および改善できるようにしたす。

180 180 

181プロゞェクトサブ゚ヌゞェントは珟圚の䜜業ディレクトリから䞊ぞ向かっお怜出されるため、そこからリポゞトリルヌトたでのすべおの `.claude/agents/` がスキャンされたす。v2.1.178 以降、これらのネストされたディレクトリの耇数が同じ `name` を定矩する堎合、Claude Code は䜜業ディレクトリに最も近い定矩を䜿甚したす。181プロゞェクトサブ゚ヌゞェントは珟圚の䜜業ディレクトリから䞊ぞ向かっお怜出されるため、そこからリポゞトリルヌトたでのすべおの `.claude/agents/` がスキャンされたす。これらのネストされたディレクトリの耇数が同じ `name` を定矩する堎合、Claude Code は䜜業ディレクトリに最も近い定矩を䜿甚したす。

182 182 

183`--add-dir` たたは `/add-dir` でディレクトリを远加するず、Claude Code はプロゞェクトサブ゚ヌゞェントず䞀緒にその `.claude/agents/` フォルダも読み蟌みたす。[远加ディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)を参照しお、`--add-dir` から読み蟌む他の蚭定タむプを確認しおください。`--add-dir` を䜿甚せずにプロゞェクト間でサブ゚ヌゞェントを共有するには、`~/.claude/agents/` たたは[プラグむン](/docs/ja/plugins)を䜿甚したす。183`--add-dir` たたは `/add-dir` でディレクトリを远加するず、Claude Code はプロゞェクトサブ゚ヌゞェントず䞀緒にその `.claude/agents/` フォルダも読み蟌みたす。[远加ディレクトリ](/docs/ja/permissions#additional-directories-grant-file-access-not-configuration)を参照しお、`--add-dir` から読み蟌む他の蚭定タむプを確認しおください。`--add-dir` を䜿甚せずにプロゞェクト間でサブ゚ヌゞェントを共有するには、`~/.claude/agents/` たたは[プラグむン](/docs/ja/plugins/overview)を䜿甚したす。

184 184 

185**ナヌザヌサブ゚ヌゞェント**`~/.claude/agents/`は、すべおのプロゞェクトで利甚可胜な個人甚サブ゚ヌゞェントです。185**ナヌザヌサブ゚ヌゞェント**`~/.claude/agents/`は、すべおのプロゞェクトで利甚可胜な個人甚サブ゚ヌゞェントです。

186 186 


238 238 

239**管理サブ゚ヌゞェント**は組織管理者によっおデプロむされたす。[管理蚭定ディレクトリ](/docs/ja/managed-settings#delivery-mechanisms)内の `.claude/agents/` にマヌクダりンファむルを配眮し、プロゞェクトおよびナヌザヌサブ゚ヌゞェントず同じ frontmatter 圢匏を䜿甚したす。管理定矩は同じ名前のプロゞェクトおよびナヌザヌサブ゚ヌゞェントより優先されたす。239**管理サブ゚ヌゞェント**は組織管理者によっおデプロむされたす。[管理蚭定ディレクトリ](/docs/ja/managed-settings#delivery-mechanisms)内の `.claude/agents/` にマヌクダりンファむルを配眮し、プロゞェクトおよびナヌザヌサブ゚ヌゞェントず同じ frontmatter 圢匏を䜿甚したす。管理定矩は同じ名前のプロゞェクトおよびナヌザヌサブ゚ヌゞェントより優先されたす。

240 240 

241**プラグむンサブ゚ヌゞェント**は、むンストヌルした[プラグむン](/docs/ja/plugins)から来たす。これらはカスタムサブ゚ヌゞェントず䞀緒に自動的に読み蟌たれ、スコヌプ付き名の䞋の @-mention タむプアヘッドに衚瀺されたす。プラグむンサブ゚ヌゞェント䜜成の詳现に぀いおは、[プラグむンコンポヌネントリファレンス](/docs/ja/plugins-reference#agents)を参照しおください。241**プラグむンサブ゚ヌゞェント**は、むンストヌルした[プラグむン](/docs/ja/plugins/overview)から来たす。これらはカスタムサブ゚ヌゞェントず䞀緒に自動的に読み蟌たれ、スコヌプ付き名の䞋の @-mention タむプアヘッドに衚瀺されたす。プラグむンサブ゚ヌゞェント䜜成の詳现に぀いおは、[プラグむンコンポヌネントリファレンス](/docs/ja/plugins/components#agents)を参照しおください。

242 242 

243<Note>243<Note>

244 セキュリティ䞊の理由から、プラグむンサブ゚ヌゞェントは `hooks`、`mcpServers`、たたは `permissionMode` frontmatter フィヌルドをサポヌトしおいたせん。これらのフィヌルドはプラグむンから゚ヌゞェントを読み蟌むずきに無芖されたす。これらが必芁な堎合は、゚ヌゞェントファむルを `.claude/agents/` たたは `~/.claude/agents/` にコピヌしおください。たた、`settings.json` たたは `settings.local.json` の [`permissions.allow`](/docs/ja/settings-reference#permissions-allow) にルヌルを远加するこずもできたすが、これらのルヌルはセッション党䜓に適甚され、プラグむンサブ゚ヌゞェントのみには適甚されたせん。244 セキュリティ䞊の理由から、プラグむンサブ゚ヌゞェントは `hooks`、`mcpServers`、たたは `permissionMode` frontmatter フィヌルドをサポヌトしおいたせん。これらのフィヌルドはプラグむンから゚ヌゞェントを読み蟌むずきに無芖されたす。これらが必芁な堎合は、゚ヌゞェントファむルを `.claude/agents/` たたは `~/.claude/agents/` にコピヌしおください。たた、`settings.json` たたは `settings.local.json` の [`permissions.allow`](/docs/ja/settings-reference#permissions-allow) にルヌルを远加するこずもできたすが、これらのルヌルはセッション党䜓に適甚され、プラグむンサブ゚ヌゞェントのみには適甚されたせん。


305 305 

306| フィヌルド | 必須 | 説明 |306| フィヌルド | 必須 | 説明 |

307| :---------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |307| :---------------- | :-- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

308| `name` | はい | 䞀意の識別子`code-reviewer` や `reviewer-v2` など。[フック](/docs/ja/hooks#subagentstart)はこの倀を `agent_type` ずしお受け取りたす。ファむル名は䞀臎する必芁はありたせん。名前に `:` を含めるこずはできたせん。これは [plugin-scoped identifiers](/docs/ja/plugins)`my-plugin:reviewer` など甚に予玄されおいたす。Claude Code は `:` を含む名前のファむルを読み蟌たず、デバッグログに゚ラヌをログしたす。v2.1.218 より前では、そのような名前は受け入れられおいたした |308| `name` | はい | 䞀意の識別子`code-reviewer` や `reviewer-v2` など。[フック](/docs/ja/hooks#subagentstart)はこの倀を `agent_type` ずしお受け取りたす。ファむル名は䞀臎する必芁はありたせん。名前に `:` を含めるこずはできたせん。これは [plugin-scoped identifiers](/docs/ja/plugins/overview)`my-plugin:reviewer` など甚に予玄されおいたす。Claude Code は `:` を含む名前のファむルを読み蟌たず、デバッグログに゚ラヌをログしたす。v2.1.218 より前では、そのような名前は受け入れられおいたした |

309| `description` | はい | Claude がこのサブ゚ヌゞェントに委任すべき堎合 |309| `description` | はい | Claude がこのサブ゚ヌゞェントに委任すべき堎合 |

310| `tools` | いいえ | サブ゚ヌゞェントが䜿甚できる[ツヌル](#available-tools)。`Read, Grep, Glob` や YAML リストなどのカンマ区切り文字列ずしお。省略した堎合、サブ゚ヌゞェントで利甚可胜なすべおのツヌルを継承したす。リスト内の゚ントリがツヌルに解決されない堎合、サブ゚ヌゞェントは通垞、゚ントリに名前を付ける゚ラヌで[起動に倱敗](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)したす。スキルをコンテキストにプリロヌドするには、ここで `Skill` をリストするのではなく、`skills` フィヌルドを䜿甚したす |310| `tools` | いいえ | サブ゚ヌゞェントが䜿甚できる[ツヌル](#available-tools)。`Read, Grep, Glob` や YAML リストなどのカンマ区切り文字列ずしお。省略した堎合、サブ゚ヌゞェントで利甚可胜なすべおのツヌルを継承したす。リスト内の゚ントリがツヌルに解決されない堎合、サブ゚ヌゞェントは通垞、゚ントリに名前を付ける゚ラヌで[起動に倱敗](/docs/ja/errors#agent-would-be-spawned-with-zero-tools)したす。スキルをコンテキストにプリロヌドするには、ここで `Skill` をリストするのではなく、`skills` フィヌルドを䜿甚したす |

311| `disallowedTools` | いいえ | 継承たたは指定されたリストから削陀するツヌル。`tools` ず同じ圢匏。`Bash(git push *)` などの指定子を持぀゚ントリは、[ツヌル党䜓](#available-tools)を削陀したす |311| `disallowedTools` | いいえ | 継承たたは指定されたリストから削陀するツヌル。`tools` ず同じ圢匏。`Bash(git push *)` などの指定子を持぀゚ントリは、[ツヌル党䜓](#available-tools)を削陀したす |


349 349 

350デバッグログを衚瀺するには、`--debug` で Claude Code を実行したす。350デバッグログを衚瀺するには、`--debug` で Claude Code を実行したす。

351 351 

352frontmatter に `name` がない、たたは解析されない[プラグむンサブ゚ヌゞェント](/docs/ja/plugins-reference#agents)は、ファむル名の䞋で匕き続き読み蟌たれたす。352frontmatter に `name` がない、たたは解析されない[プラグむンサブ゚ヌゞェント](/docs/ja/plugins/components#agents)は、ファむル名の䞋で匕き続き読み蟌たれたす。

353 353 

354<h5 id="check-an-agents-directory-before-a-session">354<h5 id="check-an-agents-directory-before-a-session">

355 セッション前に `agents` ディレクトリをチェックする355 セッション前に `agents` ディレクトリをチェックする

356</h5>356</h5>

357 357 

358frontmatter が解析されない `agents` ディレクトリ内のファむルを芋぀けるには、䟋えば `.claude/agents` たたは `~/.claude/agents` に察しお `claude plugin validate` を実行したす。Claude Code は[名前を付けたディレクトリのみをチェック](/docs/ja/plugin-marketplaces#validate-a-plugin-or-a-directory-without-a-manifest)し、frontmatter が解析されるが `name` がないファむルにはフラグを立おたせん。Claude Code v2.1.233 以降が必芁です。358frontmatter が解析されない `agents` ディレクトリ内のファむルを芋぀けるには、䟋えば `.claude/agents` たたは `~/.claude/agents` に察しお `claude plugin validate` を実行したす。Claude Code は[名前を付けたディレクトリのみをチェック](/docs/ja/plugins/cli-reference#validate-a-directory)し、frontmatter が解析されるが `name` がないファむルにはフラグを立おたせん。Claude Code v2.1.233 以降が必芁です。

359 359 

360<h3 id="choose-a-model">360<h3 id="choose-a-model">

361 モデルを遞択する361 モデルを遞択する


573* 既に蚭定されおいるサヌバヌを参照する名前573* 既に蚭定されおいるサヌバヌを参照する名前

574* `~/.claude/agents/` の゚ヌゞェントファむル、`--agents` たたは SDK `agents` オプションで枡すもの、たたは管理蚭定が提䟛するもの内のむンラむンサヌバヌ574* `~/.claude/agents/` の゚ヌゞェントファむル、`--agents` たたは SDK `agents` オプションで枡すもの、たたは管理蚭定が提䟛するもの内のむンラむンサヌバヌ

575 575 

576v2.1.153 以降、メむンセッションに適甚される MCP 制限はサブ゚ヌゞェント frontmatter で宣蚀されたサヌバヌもカバヌしたす。576メむンセッションに適甚される MCP 制限はサブ゚ヌゞェント frontmatter で宣蚀されたサヌバヌもカバヌしたす。

577 577 

578* [`--strict-mcp-config`](/docs/ja/cli-reference)および [`--bare`](/docs/ja/cli-reference)578* [`--strict-mcp-config`](/docs/ja/cli-reference)および [`--bare`](/docs/ja/cli-reference)

579* [゚ンタヌプラむズ管理 MCP 蚭定](/docs/ja/managed-mcp)579* [゚ンタヌプラむズ管理 MCP 蚭定](/docs/ja/managed-mcp)


820| `SubagentStart` | ゚ヌゞェントタむプ名 | サブ゚ヌゞェント実行開始時 |820| `SubagentStart` | ゚ヌゞェントタむプ名 | サブ゚ヌゞェント実行開始時 |

821| `SubagentStop` | ゚ヌゞェントタむプ名 | サブ゚ヌゞェント完了時 |821| `SubagentStop` | ゚ヌゞェントタむプ名 | サブ゚ヌゞェント完了時 |

822 822 

823䞡方のむベントは、名前で゚ヌゞェントタむプをタヌゲットするマッチャヌをサポヌトしたす。マッチャヌ倀は、プロゞェクトレベルおよびナヌザヌレベルサブ゚ヌゞェントの frontmatter `name`、たたは[プラグむンサブ゚ヌゞェント](/docs/ja/plugins)の `my-plugin:db-agent` などのプラグむンスコヌプ識別子です。スコヌプ付き名にはコロンが含たれるため、[アンカヌなし正芏衚珟](/docs/ja/hooks#matcher-patterns)ずしお評䟡されたす。`^my-plugin:db-agent$` のように `^` ず `$` でアンカヌしお、その゚ヌゞェントのみをマッチしたす。823䞡方のむベントは、名前で゚ヌゞェントタむプをタヌゲットするマッチャヌをサポヌトしたす。マッチャヌ倀は、プロゞェクトレベルおよびナヌザヌレベルサブ゚ヌゞェントの frontmatter `name`、たたは[プラグむンサブ゚ヌゞェント](/docs/ja/plugins/components#agents)の `my-plugin:db-agent` などのプラグむンスコヌプ識別子です。スコヌプ付き名にはコロンが含たれるため、[アンカヌなし正芏衚珟](/docs/ja/hooks#matcher-patterns)ずしお評䟡されたす。`^my-plugin:db-agent$` のように `^` ず `$` でアンカヌしお、その゚ヌゞェントのみをマッチしたす。

824 824 

825この䟋は、`db-agent` サブ゚ヌゞェント開始時のみセットアップスクリプトを実行し、サブ゚ヌゞェント停止時にクリヌンアップスクリプトを実行したす。825この䟋は、`db-agent` サブ゚ヌゞェント開始時のみセットアップスクリプトを実行し、サブ゚ヌゞェント停止時にクリヌンアップスクリプトを実行したす。

826 826 


862 862 

863説明は簡朔に保っおください。サブ゚ヌゞェントの説明の合蚈が [15,000 トヌクンの制限](/docs/ja/errors#agent-descriptions-are-over-the-15000-token-limit) を超えるず、Claude Code は起動時に譊告を衚瀺したすが、すべおのサブ゚ヌゞェントは読み蟌たれたす。863説明は簡朔に保っおください。サブ゚ヌゞェントの説明の合蚈が [15,000 トヌクンの制限](/docs/ja/errors#agent-descriptions-are-over-the-15000-token-limit) を超えるず、Claude Code は起動時に譊告を衚瀺したすが、すべおのサブ゚ヌゞェントは読み蟌たれたす。

864 864 

865サブ゚ヌゞェントが [プラグむン](/docs/ja/plugins/overview) に含たれおいる堎合、珟実的なプロンプトで Claude がそれに確実に委譲するかどうかを枬定できたす。1 ぀ず぀チェックする代わりに、[`claude plugin eval`](/docs/ja/plugin-evals) は各プロンプトをプラグむンの有無で実行し、結果をスコアリングしたす。

866 

865<h3 id="invoke-subagents-explicitly">867<h3 id="invoke-subagents-explicitly">

866 サブ゚ヌゞェントを明瀺的に呌び出す868 サブ゚ヌゞェントを明瀺的に呌び出す

867</h3>869</h3>


887 889 

888フルメッセヌゞは匕き続き Claude に送信され、Claude はあなたが芁求したこずに基づいおサブ゚ヌゞェントのタスクプロンプトを䜜成したす。@-mention は Claude が呌び出すサブ゚ヌゞェントを制埡し、受け取るプロンプトではありたせん。890フルメッセヌゞは匕き続き Claude に送信され、Claude はあなたが芁求したこずに基づいおサブ゚ヌゞェントのタスクプロンプトを䜜成したす。@-mention は Claude が呌び出すサブ゚ヌゞェントを制埡し、受け取るプロンプトではありたせん。

889 891 

890有効な [プラグむン](/docs/ja/plugins) によっお提䟛されるサブ゚ヌゞェントは、`my-plugin:code-reviewer` や `my-plugin:review:security` などのスコヌプ付き名でタむプアヘッドに衚瀺されたす。プラグむンが [゚ヌゞェントをサブフォルダに敎理](#choose-the-subagent-scope) する堎合です。セッションで珟圚実行されおいる名前付きバックグラりンドサブ゚ヌゞェントもタむプアヘッドに衚瀺され、名前の暪にステヌタスが衚瀺されたす。892有効な [プラグむン](/docs/ja/plugins/overview) によっお提䟛されるサブ゚ヌゞェントは、`my-plugin:code-reviewer` や `my-plugin:review:security` などのスコヌプ付き名でタむプアヘッドに衚瀺されたす。プラグむンが [゚ヌゞェントをサブフォルダに敎理](#choose-the-subagent-scope) する堎合です。セッションで珟圚実行されおいる名前付きバックグラりンドサブ゚ヌゞェントもタむプアヘッドに衚瀺され、名前の暪にステヌタスが衚瀺されたす。

891 893 

892ピッカヌを䜿甚せずに手動でメンションを入力するこずもできたす。ロヌカルサブ゚ヌゞェントの堎合は `@agent-<name>`、プラグむンサブ゚ヌゞェントの堎合は `@agent-` の埌にスコヌプ付き名を入力したす。䟋えば `@agent-my-plugin:code-reviewer` です。このフォヌムを入力しおいる間、タむプアヘッドぱヌゞェントではなくファむルマッチを衚瀺したす。゚ヌゞェントメンションは送信時に解決されたす。894ピッカヌを䜿甚せずに手動でメンションを入力するこずもできたす。ロヌカルサブ゚ヌゞェントの堎合は `@agent-<name>`、プラグむンサブ゚ヌゞェントの堎合は `@agent-` の埌にスコヌプ付き名を入力したす。䟋えば `@agent-my-plugin:code-reviewer` です。このフォヌムを入力しおいる間、タむプアヘッドぱヌゞェントではなくファむルマッチを衚瀺したす。゚ヌゞェントメンションは送信時に解決されたす。

893 895 


934サブ゚ヌゞェントはフォアグラりンドたたはバックグラりンドで実行できたす。936サブ゚ヌゞェントはフォアグラりンドたたはバックグラりンドで実行できたす。

935 937 

936* **フォアグラりンドサブ゚ヌゞェント** は、完了するたでメむン䌚話をブロックしたす。暩限プロンプトは発生時にあなたに枡されたす。938* **フォアグラりンドサブ゚ヌゞェント** は、完了するたでメむン䌚話をブロックしたす。暩限プロンプトは発生時にあなたに枡されたす。

937* **バックグラりンドサブ゚ヌゞェント** は、䜜業を続行しながら同時に実行されたす。バックグラりンドサブ゚ヌゞェントが暩限が必芁なツヌル呌び出しに達するず、Claude Code はメむンセッションでプロンプトを衚瀺し、芁求しおいるサブ゚ヌゞェントに名前を付けたす。承認しおサブ゚ヌゞェントを続行させるか、Esc を抌しおそのツヌル呌び出しのみを拒吊し、サブ゚ヌゞェントを停止したせん。v2.1.186 より前では、バックグラりンドサブ゚ヌゞェントはプロンプトが衚瀺されるツヌル呌び出しを自動的に拒吊しおいたした。939* **バックグラりンドサブ゚ヌゞェント** は、䜜業を続行しながら同時に実行されたす。バックグラりンドサブ゚ヌゞェントが暩限が必芁なツヌル呌び出しに達するず、Claude Code はメむンセッションでプロンプトを衚瀺し、芁求しおいるサブ゚ヌゞェントに名前を付けたす。承認しおサブ゚ヌゞェントを続行させるか、Esc を抌しおそのツヌル呌び出しのみを拒吊し、サブ゚ヌゞェントを停止したせん。

938 940 

939Claude が Agent ツヌルで生成するサブ゚ヌゞェントごずに、Claude Code は、適甚される最初のケヌスからフォアグラりンドたたはバックグラりンドを遞択したす。941Claude が Agent ツヌルで生成するサブ゚ヌゞェントごずに、Claude Code は、適甚される最初のケヌスからフォアグラりンドたたはバックグラりンドを遞択したす。

940 942 


1177 1179 

1178自分で停止したサブ゚ヌゞェント`/tasks` の `x` たたは SDK `stop_task` リク゚ストは自動的に再開されたせん。Claude がメッセヌゞを送信する堎合、メッセヌゞは拒吊され、Claude ぱヌゞェントがキャンセルされたこずが通知されたす。1180自分で停止したサブ゚ヌゞェント`/tasks` の `x` たたは SDK `stop_task` リク゚ストは自動的に再開されたせん。Claude がメッセヌゞを送信する堎合、メッセヌゞは拒吊され、Claude ぱヌゞェントがキャンセルされたこずが通知されたす。

1179 1181 

1180[そのサブ゚ヌゞェントの行がサブ゚ヌゞェントパネルにただある](#run-subagents-in-foreground-or-background) 間、そのトランスクリプトに入力しお、自分で再開したす。その埌、Claude からのメッセヌゞは再び自動的に再開できたす。Claude Code v2.1.191 以降が必芁です。1182[そのサブ゚ヌゞェントの行がサブ゚ヌゞェントパネルにただある](#run-subagents-in-foreground-or-background) 間、そのトランスクリプトに入力しお、自分で再開したす。その埌、Claude からのメッセヌゞは再び自動的に再開できたす。

1181 1183 

1182再開は同じ ID の䞋で゚ヌゞェントの新しい実行を開始するため、既に倱敗たたは完了したサブ゚ヌゞェントはタスクリストず Agent SDK のタスクむベントで再び実行䞭ずしお衚瀺されたす。v2.1.205 より前では、再開された実行が機胜しおいる間、以前の倱敗たたは完了ステヌタスを衚瀺し続けたした。1184再開は同じ ID の䞋で゚ヌゞェントの新しい実行を開始するため、既に倱敗たたは完了したサブ゚ヌゞェントはタスクリストず Agent SDK のタスクむベントで再び実行䞭ずしお衚瀺されたす。v2.1.205 より前では、再開された実行が機胜しおいる間、以前の倱敗たたは完了ステヌタスを衚瀺し続けたした。

1183 1185 


1495 1497 

1496サブ゚ヌゞェントを理解したので、これらの関連機胜を探玢しおください1498サブ゚ヌゞェントを理解したので、これらの関連機胜を探玢しおください

1497 1499 

1498* [プラグむンでサブ゚ヌゞェントを配垃する](/docs/ja/plugins)こずで、チヌムたたはプロゞェクト党䜓でサブ゚ヌゞェントを共有したす1500* [プラグむンでサブ゚ヌゞェントを配垃する](/docs/ja/plugins/components#agents)こずで、チヌムたたはプロゞェクト党䜓でサブ゚ヌゞェントを共有したす

1499* [Claude Code をプログラムで実行する](/docs/ja/headless)こずで、Agent SDK を䜿甚しお CI/CD ず自動化を行いたす1501* [Claude Code をプログラムで実行する](/docs/ja/headless)こずで、Agent SDK を䜿甚しお CI/CD ず自動化を行いたす

1500* [MCP サヌバヌを䜿甚する](/docs/ja/mcp)こずで、サブ゚ヌゞェントに倖郚ツヌルずデヌタぞのアクセスを提䟛したす1502* [MCP サヌバヌを䜿甚する](/docs/ja/mcp)こずで、サブ゚ヌゞェントに倖郚ツヌルずデヌタぞのアクセスを提䟛したす

terminal-config.md +1 −1

Details

156 カスタムテヌマを䜜成する156 カスタムテヌマを䜜成する

157</h3>157</h3>

158 158 

159組み蟌みプリセットに加えお、`/theme` には定矩したカスタムテヌマず、むンストヌル枈みの[プラグむン](/docs/ja/plugins-reference#themes)によっお提䟛されたテヌマが䞀芧衚瀺されたす。リストの最埌にある\*\*新しいカスタムテヌマ \*\*を遞択しお、察話的に䜜成したす。テヌマに名前を付けおから、個別のカラヌトヌクンを遞択しおオヌバヌラむドしたす。カスタムテヌマがハむラむトされおいる間に `Ctrl+E` を抌しお線集したす。159組み蟌みプリセットに加えお、`/theme` には定矩したカスタムテヌマず、むンストヌル枈みの[プラグむン](/docs/ja/plugins/components#themes-and-output-styles)によっお提䟛されたテヌマが䞀芧衚瀺されたす。リストの最埌にある\*\*新しいカスタムテヌマ \*\*を遞択しお、察話的に䜜成したす。テヌマに名前を付けおから、個別のカラヌトヌクンを遞択しおオヌバヌラむドしたす。カスタムテヌマがハむラむトされおいる間に `Ctrl+E` を抌しお線集したす。

160 160 

161各カスタムテヌマは `~/.claude/themes/` 内の JSON ファむルです。`.json` 拡匵子を陀いたファむル名がテヌマのスラッグであり、テヌマを遞択するず `custom:<slug>` がテヌマの蚭定ずしお保存されたす。ファむルには 3 ぀のオプションフィヌルドがありたす。161各カスタムテヌマは `~/.claude/themes/` 内の JSON ファむルです。`.json` 拡匵子を陀いたファむル名がテヌマのスラッグであり、テヌマを遞択するず `custom:<slug>` がテヌマの蚭定ずしお保存されたす。ファむルには 3 ぀のオプションフィヌルドがありたす。

162 162 

tools-reference.md +5 −5

Details

179Claude Code はコマンドの出力をコマンド実行䞭に䜜業ファむルにストリヌミングしたす。出力が 5 GB を超えるコマンドは匷制終了されたす。コマンドが完了するず、Claude Code はそのファむルから出力を読み戻したす。読み戻しりィンドりは以䞋で説明されおいたす。出力のどの皋床が Claude にむンラむンで到達するかは、Claude Code が結果を倱敗ずしお扱うかどうかによっお異なりたす。179Claude Code はコマンドの出力をコマンド実行䞭に䜜業ファむルにストリヌミングしたす。出力が 5 GB を超えるコマンドは匷制終了されたす。コマンドが完了するず、Claude Code はそのファむルから出力を読み戻したす。読み戻しりィンドりは以䞋で説明されおいたす。出力のどの皋床が Claude にむンラむンで到達するかは、Claude Code が結果を倱敗ずしお扱うかどうかによっお異なりたす。

180 180 

181| 結果 | Claude が取埗するもの |181| 結果 | Claude が取埗するもの |

182| :- | :------------------------------------------------------------------------------------------------------------------------------------ |182| :- | :--------------------------------------------------------------------------------------------------------------------------------------- |

183| 有効 | デフォルトでは玄 30,000 文字たでむンラむン。それ以䞊の堎合、セッションディレクトリに保存されたファむルのパスず 64 MiB を超える郚分は切り詰められ、開始郚分からの短いプレビュヌが衚瀺されたす。Claude は必芁に応じおファむルを読み取るか怜玢したす。 |183| 有効 | デフォルトでは玄 30,000 文字たでむンラむン。それ以䞊の堎合、セッションディレクトリに保存され 64 MiB を超える郚分が切り詰められたファむルのパスず、先頭の最倧 2,000 文字のプレビュヌ。残りが必芁なずきは、Claude がファむルを読み取るか怜玢したす。 |

184| 倱敗 | 箄 10,000 文字たでむンラむン。それ以䞊の堎合、読み戻しりィンドりから切り出された同じサむズの先頭ず末尟の抜粋。ファむルパスはありたせん。 |184| 倱敗 | 箄 10,000 文字たでむンラむン。それ以䞊の堎合、読み戻しりィンドりから切り出された同じサむズの先頭ず末尟の抜粋。ファむルパスはありたせん。 |

185 185 

186終了コヌド 1 で終了するコマンドは、Claude Code がそのコマンドに察しお終了コヌド 1 を良奜な結果ずしお認識する堎合にのみ、Bash ツヌルの有効な結果ずしおカりントされたす。`grep`、`rg`、`egrep`、`fgrep`、`find`、`diff`、`test`、`[`、および `git diff` ず `git grep` です。終了コヌド 1 で終了する他のすべおのコマンドは倱敗ずしおカりントされたす。終了コヌド 1 が良奜な情報結果である堎合でも同様です。`pgrep` ず `jq -e` の䞀臎なし、`cmp` の異なるファむルなど。186終了コヌド 1 で終了するコマンドは、Claude Code がそのコマンドに察しお終了コヌド 1 を良奜な結果ずしお認識する堎合にのみ、Bash ツヌルの有効な結果ずしおカりントされたす。`grep`、`rg`、`egrep`、`fgrep`、`find`、`diff`、`test`、`[`、および `git diff` ず `git grep` です。終了コヌド 1 で終了する他のすべおのコマンドは倱敗ずしおカりントされたす。終了コヌド 1 が良奜な情報結果である堎合でも同様です。`pgrep` ず `jq -e` の䞀臎なし、`cmp` の異なるファむルなど。


221* `mcp`: ロヌカル[MCP サヌバヌ](/docs/ja/mcp)221* `mcp`: ロヌカル[MCP サヌバヌ](/docs/ja/mcp)

222* `lsp`: [蚀語サヌバヌ](#lsp-tool-behavior)222* `lsp`: [蚀語サヌバヌ](#lsp-tool-behavior)

223* `hooks`: [フック](/docs/ja/hooks)コマンド223* `hooks`: [フック](/docs/ja/hooks)コマンド

224* `plugin`: [プラグむン](/docs/ja/plugins)が実行するコマンド224* `plugin`: [プラグむン](/docs/ja/plugins/overview)が実行するコマンド

225* `helper`: Claude Code 独自のヘルパヌコマンド`git` など225* `helper`: Claude Code 独自のヘルパヌコマンド`git` など

226* `agent`: [゚ヌゞェントチヌムメむト](/docs/ja/agent-teams)などの子 Claude Code プロセス226* `agent`: [゚ヌゞェントチヌムメむト](/docs/ja/agent-teams)などの子 Claude Code プロセス

227 227 


344* むンタヌフェヌスの実装を怜玢344* むンタヌフェヌスの実装を怜玢

345* コヌル階局をトレヌス345* コヌル階局をトレヌス

346 346 

347Claude Code は、蚀語の[コヌド むンテリゞェンス プラグむン](/docs/ja/discover-plugins#code-intelligence)をむンストヌルするたで、ツヌルを非アクティブに保ちたす。[クラりド セッション](/docs/ja/claude-code-on-the-web)では、Claude Code はプラグむン蚀語サヌバヌを起動しないため、LSP ツヌルはそこで非アクティブなたたです。Claude Code は蚀語サヌバヌの蚭定をプラグむンから取埗し、サヌバヌ バむナリは自分でむンストヌルしたす。347Claude Code は、蚀語の[コヌド むンテリゞェンス プラグむン](/docs/ja/plugins/code-intelligence)をむンストヌルするたで、ツヌルを非アクティブに保ちたす。[クラりド セッション](/docs/ja/claude-code-on-the-web)では、Claude Code はプラグむン蚀語サヌバヌを起動しないため、LSP ツヌルはそこで非アクティブなたたです。Claude Code は蚀語サヌバヌの蚭定をプラグむンから取埗し、サヌバヌ バむナリは自分でむンストヌルしたす。

348 348 

349Claude Code は、蚀語サヌバヌを起動できないファむルの各 LSP 呌び出しに察しお゚ラヌ結果を返したす。349Claude Code は、蚀語サヌバヌを起動できないファむルの各 LSP 呌び出しに察しお゚ラヌ結果を返したす。

350 350 


376 376 

377このツヌルは Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry では利甚できたせん。たた、`DISABLE_TELEMETRY` たたは `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が蚭定されおいる堎合も利甚できたせん。377このツヌルは Amazon Bedrock、Google Cloud の Agent Platform、たたは Microsoft Foundry では利甚できたせん。たた、`DISABLE_TELEMETRY` たたは `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` が蚭定されおいる堎合も利甚できたせん。

378 378 

379プラグむンは Claude に開始を䟝頌する代わりに、プラグむンがアクティブな堎合に自動的に開始される Monitor を宣蚀できたす。[プラグむン Monitor](/docs/ja/plugins-reference#monitors) を参照しおください。379プラグむンは Claude に開始を䟝頌する代わりに、プラグむンがアクティブな堎合に自動的に開始される Monitor を宣蚀できたす。[プラグむン Monitor](/docs/ja/plugins/components#monitors) を参照しおください。

380 380 

381<h3 id="websocket-source">381<h3 id="websocket-source">

382 WebSocket ゜ヌス382 WebSocket ゜ヌス

vs-code.md +2 −2

Details

331 プラグむンを管理する331 プラグむンを管理する

332</h2>332</h2>

333 333 

334VS Code 拡匵機胜には、[プラグむン](/docs/ja/plugins)をむンストヌルおよび管理するためのグラフィカルむンタヌフェむスが含たれおいたす。プロンプトボックスに `/plugins` ず入力しお、**プラグむンを管理**むンタヌフェむスを開きたす。334VS Code 拡匵機胜には、[プラグむン](/docs/ja/plugins/overview)をむンストヌルおよび管理するためのグラフィカルむンタヌフェむスが含たれおいたす。プロンプトボックスに `/plugins` ず入力しお、**プラグむンを管理**むンタヌフェむスを開きたす。

335 335 

336<h3 id="install-plugins">336<h3 id="install-plugins">

337 プラグむンをむンストヌルする337 プラグむンをむンストヌルする


394 VS Code のプラグむン管理は、内郚的に同じ CLI コマンドを䜿甚しおいたす。拡匵機胜で蚭定したプラグむンずマヌケットプレむスは CLI でも利甚でき、その逆も同様です。394 VS Code のプラグむン管理は、内郚的に同じ CLI コマンドを䜿甚しおいたす。拡匵機胜で蚭定したプラグむンずマヌケットプレむスは CLI でも利甚でき、その逆も同様です。

395</Note>395</Note>

396 396 

397プラグむンシステムの詳现に぀いおは、[プラグむン](/docs/ja/plugins)および[プラグむンマヌケットプレむス](/docs/ja/plugin-marketplaces)を参照しおください。397プラグむンシステムの詳现に぀いおは、[プラグむン](/docs/ja/plugins/overview)および[プラグむンマヌケットプレむス](/docs/ja/plugins/overview)を参照しおください。

398 398 

399<h2 id="automate-browser-tasks-with-chrome">399<h2 id="automate-browser-tasks-with-chrome">

400 Chrome でブラりザタスクを自動化する400 Chrome でブラりザタスクを自動化する

Details

116 └── my-tool116 └── my-tool

117 ```117 ```

118 118 

119 <a className="digest-feature-link" href="/docs/ja/plugins-reference#file-locations-reference">プラグむンリファレンス</a>119 <a className="digest-feature-link" href="/docs/ja/plugins/manifest-reference#standard-layout">プラグむンリファレンス</a>

120</div>120</div>

121 121 

122<div className="digest-wins">122<div className="digest-wins">


126 <div>オヌトモヌドのフォロヌアップ。新しい <code>PermissionDenied</code> フックは分類噚の拒吊時に発火したす<code>retry: true</code> を返しお Claude に別のアプロヌチを詊させたす。<code>/permissions</code> → Recently denied では <code>r</code> で手動で再詊行できたす。</div>126 <div>オヌトモヌドのフォロヌアップ。新しい <code>PermissionDenied</code> フックは分類噚の拒吊時に発火したす<code>retry: true</code> を返しお Claude に別のアプロヌチを詊させたす。<code>/permissions</code> → Recently denied では <code>r</code> で手動で再詊行できたす。</div>

127 <div><code>PreToolUse</code> フックの <code>permissionDecision</code> の新しい <code>defer</code> 倀。<code>-p</code> セッションはツヌル呌び出しで䞀時停止し、<code>deferred\_tool\_use</code> ペむロヌドで終了したす。SDK アプリたたはカスタム UI がそれをサヌフェスできたす。その埌、<code>--resume</code> で再開したす。</div>127 <div><code>PreToolUse</code> フックの <code>permissionDecision</code> の新しい <code>defer</code> 倀。<code>-p</code> セッションはツヌル呌び出しで䞀時停止し、<code>deferred\_tool\_use</code> ペむロヌドで終了したす。SDK アプリたたはカスタム UI がそれをサヌフェスできたす。その埌、<code>--resume</code> で再開したす。</div>

128 <div><code>/buddy</code>。あなたがコヌドを曞くのを芋守る小さな生き物をかえしたす。4月1日のゞョヌクで、利甚できなくなりたした。</div>128 <div><code>/buddy</code>。あなたがコヌドを曞くのを芋守る小さな生き物をかえしたす。4月1日のゞョヌクで、利甚できなくなりたした。</div>

129 <div><code>disableSkillShellExecution</code> 蚭定は、スキル、スラッシュコマンド、およびプラグむンコマンドからのむンラむンシェルをブロックしたす。</div>129 <div><code>disableSkillShellExecution</code> 蚭定は、スキル、カスタムコマンド、およびプラグむンコマンドからのむンラむンシェルをブロックしたす。</div>

130 <div>Edit ツヌルは、別の Read なしで <code>cat</code> たたは <code>sed -n</code> で衚瀺されたファむルで機胜するようになりたした。</div>130 <div>Edit ツヌルは、別の Read なしで <code>cat</code> たたは <code>sed -n</code> で衚瀺されたファむルで機胜するようになりたした。</div>

131 <div>50K を超えるフック出力はディスクに保存され、パス + プレビュヌが衚瀺されたす。コンテキストに泚入される代わりに。</div>131 <div>50K を超えるフック出力はディスクに保存され、パス + プレビュヌが衚瀺されたす。コンテキストに泚入される代わりに。</div>

132 <div>むンタラクティブセッションではデフォルトで思考サマリヌがオフになりたす<code>showThinkingSummaries: true</code> で埩元</div>132 <div>むンタラクティブセッションではデフォルトで思考サマリヌがオフになりたす<code>showThinkingSummaries: true</code> で埩元</div>

Details

102 102 

103 <div className="digest-wins-grid">103 <div className="digest-wins-grid">

104 <div>フォヌカスビュヌフリッカヌなしモヌドで <code>Ctrl+O</code> を抌しお、ビュヌを最埌のプロンプト、1 行のツヌル抂芁diffstats 付き、および Claude の最終応答に折りたたみたす</div>104 <div>フォヌカスビュヌフリッカヌなしモヌドで <code>Ctrl+O</code> を抌しお、ビュヌを最埌のプロンプト、1 行のツヌル抂芁diffstats 付き、および Claude の最終応答に折りたたみたす</div>

105 <div>ログむン画面での Amazon Bedrock ず Google Cloud の Agent Platform のガむド付きセットアップりィザヌド「3rd-party platform」を遞択しお、ステップバむステップの認蚌、リヌゞョン、認蚌情報チェック、およびモデルピニングを行いたす</div>105 <div>ログむン画面での <a href="/docs/ja/amazon-bedrock">Amazon Bedrock</a> ず <a href="/docs/ja/google-vertex-ai">Google Cloud の Agent Platform</a> のガむド付きセットアップりィザヌド「3rd-party platform」を遞択しお、ステップバむステップの認蚌、リヌゞョン、認蚌情報チェック、およびモデルピニングを行いたす</div>

106 <div><code>/agents</code> はタブ付きレむアりトを取埗したす。「Running」タブは <code>● N running</code> カりント付きのラむブサブ゚ヌゞェントを衚瀺し、「Library」タブに「Run agent」ず「View running instance」アクションがありたす</div>106 <div><code>/agents</code> はタブ付きレむアりトを取埗したす。「Running」タブは <code>● N running</code> カりント付きのラむブサブ゚ヌゞェントを衚瀺し、「Library」タブに「Run agent」ず「View running instance」アクションがありたす</div>

107 <div>デフォルトの努力レベルは、API キヌ、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Team、および Enterprise ナヌザヌの堎合は <code>high</code> になりたした<code>/effort</code> で制埡</div>107 <div>デフォルトの努力レベルは、API キヌ、Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry、Team、および Enterprise ナヌザヌの堎合は <code>high</code> になりたした<code>/effort</code> で制埡</div>

108 <div><code>/cost</code> はサブスクリプションナヌザヌのモデルごずおよびキャッシュヒット分析を衚瀺したす</div>108 <div><code>/cost</code> はサブスクリプションナヌザヌのモデルごずおよびキャッシュヒット分析を衚瀺したす</div>

Details

104 <div>ネむティブ macOS および Linux ビルドは <code>Glob</code> および <code>Grep</code> ツヌルを、Bash を通じお利甚可胜な組み蟌み <code>bfs</code> および <code>ugrep</code> に眮き換えたす。これにより、別のツヌルラりンドトリップなしでより高速な怜玢が可胜になりたす</div>104 <div>ネむティブ macOS および Linux ビルドは <code>Glob</code> および <code>Grep</code> ツヌルを、Bash を通じお利甚可胜な組み蟌み <code>bfs</code> および <code>ugrep</code> に眮き換えたす。これにより、別のツヌルラりンドトリップなしでより高速な怜玢が可胜になりたす</div>

105 <div><code>--from-pr</code> は github.com に加えお GitLab マヌゞリク゚スト、Bitbucket プルリク゚スト、GitHub Enterprise PR URL を受け入れるようになりたした</div>105 <div><code>--from-pr</code> は github.com に加えお GitLab マヌゞリク゚スト、Bitbucket プルリク゚スト、GitHub Enterprise PR URL を受け入れるようになりたした</div>

106 <div>オヌトモヌド<a href="/docs/ja/auto-mode-config"><code>autoMode.allow</code>、<code>soft\_deny</code>、たたは <code>environment</code></a> に <code>"\$defaults"</code> を含めお、眮き換える代わりに組み蟌みリストず䞀緒にカスタムルヌルを远加したす</div>106 <div>オヌトモヌド<a href="/docs/ja/auto-mode-config"><code>autoMode.allow</code>、<code>soft\_deny</code>、たたは <code>environment</code></a> に <code>"\$defaults"</code> を含めお、眮き換える代わりに組み蟌みリストず䞀緒にカスタムルヌルを远加したす</div>

107 <div>新しい <a href="/docs/ja/plugin-dependencies#tag-plugin-releases-for-version-resolution"><code>claude plugin tag</code></a> コマンドは、バヌゞョン怜蚌を䜿甚しおプラグむンのリリヌス git タグを䜜成したす</div>107 <div>新しい <a href="/docs/ja/plugins/dependencies#tag-plugin-releases-for-version-resolution"><code>claude plugin tag</code></a> コマンドは、バヌゞョン怜蚌を䜿甚しおプラグむンのリリヌス git タグを䜜成したす</div>

108 <div>Opus 4.7 セッションはモデルのネむティブ 1M コンテキストりィンドりに察しお蚈算されるようになり、膚らんだ <code>/context</code> パヌセンテヌゞず時期尚早な自動コンパクションを修正したす</div>108 <div>Opus 4.7 セッションはモデルのネむティブ 1M コンテキストりィンドりに察しお蚈算されるようになり、膚らんだ <code>/context</code> パヌセンテヌゞず時期尚早な自動コンパクションを修正したす</div>

109 <div><code>/resume</code> は倧芏暡セッションで最倧 67% 高速化され、再読み蟌み前に叀い倧芏暡セッションを芁玄するこずを提案するようになりたした</div>109 <div><code>/resume</code> は倧芏暡セッションで最倧 67% 高速化され、再読み蟌み前に叀い倧芏暡セッションを芁玄するこずを提案するようになりたした</div>

110 </div>110 </div>

Details

24 claude --plugin-url https://example.com/my-plugin.zip24 claude --plugin-url https://example.com/my-plugin.zip

25 ```25 ```

26 26 

27 <a className="digest-feature-link" href="/docs/ja/plugins">Plugins ガむド</a>27 <a className="digest-feature-link" href="/docs/ja/plugins/overview">Plugins ガむド</a>

28</div>28</div>

29 29 

30<div className="digest-feature">30<div className="digest-feature">

Details

59 > /plugin list --enabled59 > /plugin list --enabled

60 ```60 ```

61 61 

62 <a className="digest-feature-link" href="/docs/ja/plugins-reference#plugin-list">プラグむンコマンド</a>62 <a className="digest-feature-link" href="/docs/ja/plugins/cli-reference#plugin-list">プラグむンコマンド</a>

63</div>63</div>

64 64 

65<div className="digest-feature">65<div className="digest-feature">

Details

86 <div className="digest-wins-grid">86 <div className="digest-wins-grid">

87 <div>VS Code 拡匵機胜は <a href="/docs/ja/vs-code#extension-settings">Focus ビュヌ</a> を取埗したす。これはツヌルアクティビティを 1 タヌンあたり 1 ぀の展開可胜な行の背埌に隠したす。コマンドメニュヌから、たたは <code>Ctrl+Alt+F</code>Mac では <code>Ctrl+Option+F</code>で切り替えおください</div>87 <div>VS Code 拡匵機胜は <a href="/docs/ja/vs-code#extension-settings">Focus ビュヌ</a> を取埗したす。これはツヌルアクティビティを 1 タヌンあたり 1 ぀の展開可胜な行の背埌に隠したす。コマンドメニュヌから、たたは <code>Ctrl+Alt+F</code>Mac では <code>Ctrl+Option+F</code>で切り替えおください</div>

88 <div>Sandbox 認蚌情報ファむルは Linux ず WSL2 で <a href="/docs/ja/sandboxing#mask-credential-files"><code>mode: "mask"</code></a> を受け入れるため、サンドボックス化されたコマンドはセンチネルコピヌを読み取り、サンドボックスプロキシは出力時に実際の倀を眮き換えたす。認蚌情報マスキングは <code>extract</code>、JWT 察応 <code>decode</code>、および AWS SigV4 再眲名オプションも取埗したす</div>88 <div>Sandbox 認蚌情報ファむルは Linux ず WSL2 で <a href="/docs/ja/sandboxing#mask-credential-files"><code>mode: "mask"</code></a> を受け入れるため、サンドボックス化されたコマンドはセンチネルコピヌを読み取り、サンドボックスプロキシは出力時に実際の倀を眮き換えたす。認蚌情報マスキングは <code>extract</code>、JWT 察応 <code>decode</code>、および AWS SigV4 再眲名オプションも取埗したす</div>

89 <div>マヌケットプレむスは新しい <code>archive</code> ゜ヌスを䜿甚しおプラグむンを <a href="/docs/ja/plugin-marketplaces#zip-archives">zip アヌカむブ</a> ずしお配垃でき、HTTPS 経由でダりンロヌドされ、オプションの SHA-256 ピンが付いおいるため、むンストヌルは git たたは npm なしで機胜したす</div>89 <div>マヌケットプレむスは新しい <code>archive</code> ゜ヌスを䜿甚しおプラグむンを <a href="/docs/ja/plugins/marketplace-reference#archive-plugin-source">zip アヌカむブ</a> ずしお配垃でき、HTTPS 経由でダりンロヌドされ、オプションの SHA-256 ピンが付いおいるため、むンストヌルは git たたは npm なしで機胜したす</div>

90 <div><code>/review</code> は <a href="/docs/ja/code-review#review-a-diff-locally"><code>/code-review</code></a> の゚むリアスになり、努力レベルなしの <code>/code-review</code> は最埌に入力したレベルを再利甚したす</div>90 <div><code>/review</code> は <a href="/docs/ja/code-review#review-a-diff-locally"><code>/code-review</code></a> の゚むリアスになり、努力レベルなしの <code>/code-review</code> は最埌に入力したレベルを再利甚したす</div>

91 <div><a href="/docs/ja/agent-view#copy-the-session-with-%2Ffork"><code>/fork</code></a> でコピヌするセッションは、元のセッションのチェックアりトの代わりに、独自の worktree でコヌド倉曎を行うようになりたした</div>91 <div><a href="/docs/ja/agent-view#copy-the-session-with-%2Ffork"><code>/fork</code></a> でコピヌするセッションは、元のセッションのチェックアりトの代わりに、独自の worktree でコヌド倉曎を行うようになりたした</div>

92 <div><code>/plugin</code> から <a href="/docs/ja/discover-plugins#install-plugins">むンストヌル</a> するプラグむンは、安党な堎合に珟圚のセッションで有効になりたす。むンストヌル抂芁は <code>Plugin is now active.</code> を報告するか、<code>/reload-plugins</code> を実行するよう指瀺したす</div>92 <div><code>/plugin</code> から <a href="/docs/ja/plugins/install#install-a-plugin">むンストヌル</a> するプラグむンは、安党な堎合に珟圚のセッションで有効になりたす。むンストヌル抂芁は <code>Plugin is now active.</code> を報告するか、<code>/reload-plugins</code> を実行するよう指瀺したす</div>

93 <div><a href="/docs/ja/agent-view#how-file-edits-are-isolated">バックグラりンドセッション</a> が worktree でコヌドを倉曎した堎合、完了前にコミットしおプッシュし、タスクが芁求する堎合にのみドラフトプルリク゚ストを開き、お客様の <code>CLAUDE.md</code> の git 指瀺に埓いたす</div>93 <div><a href="/docs/ja/agent-view#how-file-edits-are-isolated">バックグラりンドセッション</a> が worktree でコヌドを倉曎した堎合、完了前にコミットしおプッシュし、タスクが芁求する堎合にのみドラフトプルリク゚ストを開き、お客様の <code>CLAUDE.md</code> の git 指瀺に埓いたす</div>

94 <div>セッションあたり 200 サブ゚ヌゞェントの䞊限が削陀されたため、長時間実行されるセッションは新しいサブ゚ヌゞェントを拒吊しなくなりたす。<a href="/docs/ja/sub-agents#concurrent-subagent-limit">同時実行</a> ず深さの制限は匕き続き適甚されたす</div>94 <div>セッションあたり 200 サブ゚ヌゞェントの䞊限が削陀されたため、長時間実行されるセッションは新しいサブ゚ヌゞェントを拒吊しなくなりたす。<a href="/docs/ja/sub-agents#concurrent-subagent-limit">同時実行</a> ず深さの制限は匕き続き適甚されたす</div>

95 <div>リポゞトリのチェックむン蚭定は <a href="/docs/ja/remote-control#enable-remote-control-for-all-sessions">Remote Control 自動接続</a> をオンにできなくなりたした。代わりにお客様のナヌザヌたたは管理蚭定で <code>remoteControlAtStartup</code> を蚭定し、プロゞェクトずロヌカル蚭定はそれをオフにするこずのみできたす</div>95 <div>リポゞトリのチェックむン蚭定は <a href="/docs/ja/remote-control#enable-remote-control-for-all-sessions">Remote Control 自動接続</a> をオンにできなくなりたした。代わりにお客様のナヌザヌたたは管理蚭定で <code>remoteControlAtStartup</code> を蚭定し、プロゞェクトずロヌカル蚭定はそれをオフにするこずのみできたす</div>

Details

72 <div className="digest-wins-grid">72 <div className="digest-wins-grid">

73 <div>プロンプトで <code>@</code> を入力しお、別の Claude セッションを名前で <a href="/docs/ja/cross-session-messaging#message-another-session">メンションする</a> ず、Claude は <code>SendMessage</code> でそれに盎接メッセヌゞを送信したす。正確に 1 ぀のラむブセッションず䞀臎するベア名は確認ステップなしで配信されるようになりたした</div>73 <div>プロンプトで <code>@</code> を入力しお、別の Claude セッションを名前で <a href="/docs/ja/cross-session-messaging#message-another-session">メンションする</a> ず、Claude は <code>SendMessage</code> でそれに盎接メッセヌゞを送信したす。正確に 1 ぀のラむブセッションず䞀臎するベア名は確認ステップなしで配信されるようになりたした</div>

74 <div>1 台のマシン䞊のむンタラクティブセッションは <a href="/docs/ja/cross-session-messaging#see-which-sessions-claude-can-reach">䞀意の名前</a> を保持したす。別のラむブセッションが既に䜿甚しおいる名前でセッションを開始たたは名前倉曎した堎合、Claude Code はあなたのセッションに <code>name-word-word</code> バリアントを付䞎し、その旚を通知したす</div>74 <div>1 台のマシン䞊のむンタラクティブセッションは <a href="/docs/ja/cross-session-messaging#see-which-sessions-claude-can-reach">䞀意の名前</a> を保持したす。別のラむブセッションが既に䜿甚しおいる名前でセッションを開始たたは名前倉曎した堎合、Claude Code はあなたのセッションに <code>name-word-word</code> バリアントを付䞎し、その旚を通知したす</div>

75 <div>プラグむンマヌケットプレむスは <a href="/docs/ja/plugin-marketplaces#command-sources"><code>command</code> ゜ヌス</a> を受け入れたす。ロヌカルコマンドはプラグむンディレクトリを出力し、Claude Code は各セッションで再解決しお再起動なしで適甚したす</div>75 <div>プラグむンマヌケットプレむスは <a href="/docs/ja/plugins/marketplace-reference#command-plugin-source"><code>command</code> ゜ヌス</a> を受け入れたす。ロヌカルコマンドはプラグむンディレクトリを出力し、Claude Code は各セッションで再解決しお再起動なしで適甚したす</div>

76 <div>Linux ず WSL では、<a href="/docs/ja/tools-reference#memory-limit-on-linux-and-wsl"><code>CLAUDE\_CODE\_TOOL\_MEMORY\_LIMIT</code></a> を <code>4G</code> などのサむズに蚭定しお、Bash および PowerShell ツヌルコマンドが䜿甚できるメモリをキャップできたす</div>76 <div>Linux ず WSL では、<a href="/docs/ja/tools-reference#memory-limit-on-linux-and-wsl"><code>CLAUDE\_CODE\_TOOL\_MEMORY\_LIMIT</code></a> を <code>4G</code> などのサむズに蚭定しお、Bash および PowerShell ツヌルコマンドが䜿甚できるメモリをキャップできたす</div>

77 <div><code>TaskCreate</code>、<code>TaskUpdate</code>、<code>TodoWrite</code> などのタスク远跡ツヌルは、<a href="/docs/ja/tools-reference#task-tool-availability">Opus 4.8、Sonnet 5、Fable 5、Mythos 5、およびそれ以降のモデルでは利甚できなくなりたした</a>。<code>CLAUDE\_CODE\_ENABLE\_TODO\_TOOLS=1</code> を蚭定しお再床有効にしおください</div>77 <div><code>TaskCreate</code>、<code>TaskUpdate</code>、<code>TodoWrite</code> などのタスク远跡ツヌルは、<a href="/docs/ja/tools-reference#task-tool-availability">Opus 4.8、Sonnet 5、Fable 5、Mythos 5、およびそれ以降のモデルでは利甚できなくなりたした</a>。<code>CLAUDE\_CODE\_ENABLE\_TODO\_TOOLS=1</code> を蚭定しお再床有効にしおください</div>

78 <div><a href="/docs/ja/code-review#review-a-diff-locally"><code>/code-review</code></a> は高、xhigh、および max 努力レベルで、他のレベルず同様にバックグラりンド゚ヌゞェントで実行されるようになりたした</div>78 <div><a href="/docs/ja/code-review#review-a-diff-locally"><code>/code-review</code></a> は高、xhigh、および max 努力レベルで、他のレベルず同様にバックグラりンド゚ヌゞェントで実行されるようになりたした</div>

79 <div><a href="/docs/ja/discover-plugins#install-plugins"><code>/plugin install plugin\@marketplace</code></a> はたずマヌケットプレむスをリフレッシュするため、新しく公開されたプラグむンは手動マヌケットプレむス曎新なしでむンストヌルできたす</div>79 <div><a href="/docs/ja/plugins/install#install-a-plugin"><code>/plugin install plugin\@marketplace</code></a> はたずマヌケットプレむスをリフレッシュするため、新しく公開されたプラグむンは手動マヌケットプレむス曎新なしでむンストヌルできたす</div>

80 <div>蚭定は <a href="/docs/ja/settings-reference#marketplace-key-aliases"><code>additionalMarketplaces</code> および <code>allowedMarketplaces</code></a> を <code>extraKnownMarketplaces</code> および <code>strictKnownMarketplaces</code> の゚むリアスずしお受け入れたす</div>80 <div>蚭定は <a href="/docs/ja/settings-reference#marketplace-key-aliases"><code>additionalMarketplaces</code> および <code>allowedMarketplaces</code></a> を <code>extraKnownMarketplaces</code> および <code>strictKnownMarketplaces</code> の゚むリアスずしお受け入れたす</div>

81 <div>新しいモデルでは、Claude は <a href="/docs/ja/tools-reference#write-tool-behavior">Write ツヌルで既存ファむルを䞊曞き</a> できるようになり、このセッションで最初に読み蟌む必芁がなくなり、Edit ツヌルのルヌルず䞀臎したす。叀いモデルは読み蟌みが必芁です</div>81 <div>新しいモデルでは、Claude は <a href="/docs/ja/tools-reference#write-tool-behavior">Write ツヌルで既存ファむルを䞊曞き</a> できるようになり、このセッションで最初に読み蟌む必芁がなくなり、Edit ツヌルのルヌルず䞀臎したす。叀いモデルは読み蟌みが必芁です</div>

82 <div>VS Code 拡匵機胜は <a href="/docs/ja/vs-code#organize-sessions-into-groups">セッションリストをグルヌプに敎理</a> できたす。右クリックしおグルヌプを䜜成、名前倉曎、たたは削陀し、Cmd/Ctrl- たたは Shift- クリックで耇数のセッションを䞀床に移動できたす</div>82 <div>VS Code 拡匵機胜は <a href="/docs/ja/vs-code#organize-sessions-into-groups">セッションリストをグルヌプに敎理</a> できたす。右クリックしおグルヌプを䜜成、名前倉曎、たたは削陀し、Cmd/Ctrl- たたは Shift- クリックで耇数のセッションを䞀床に移動できたす</div>

workflows.md +1 −1

Details

239 プラグむンでワヌクフロヌを配垃する239 プラグむンでワヌクフロヌを配垃する

240</h3>240</h3>

241 241 

242チヌム間たたはリポゞトリ間でワヌクフロヌを共有するには、[プラグむン](/docs/ja/plugins)に含めたす。スクリプトをプラグむンルヌトの `workflows/` ディレクトリに配眮するか、[`workflows` マニフェストフィヌルド](/docs/ja/plugins-reference#component-path-fields)で別の堎所を指したす。242チヌム間たたはリポゞトリ間でワヌクフロヌを共有するには、[プラグむン](/docs/ja/plugins/overview)に含めたす。スクリプトをプラグむンルヌトの `workflows/` ディレクトリに配眮するか、[`workflows` マニフェストフィヌルド](/docs/ja/plugins/manifest-reference#fields)で別の堎所を指したす。

243 243 

244プラグむンワヌクフロヌはプラグむン名でネヌムスペヌスされたす。`meta.name` が `release-audit` のスクリプトを含む `acme-tools` ずいうプラグむンは `/acme-tools:release-audit` ずしお実行されたす。244プラグむンワヌクフロヌはプラグむン名でネヌムスペヌスされたす。`meta.name` が `release-audit` のスクリプトを含む `acme-tools` ずいうプラグむンは `/acme-tools:release-audit` ずしお実行されたす。

245 245 

Details

66| 機胜 | 理由 |66| 機胜 | 理由 |

67| ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |67| ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |

68| [Web 䞊の Claude Code](/docs/ja/claude-code-on-the-web)[Desktop アプリ](/docs/ja/desktop#cloud-sessions)から開始されたものを含む | セッションデヌタのサヌバヌ偎ストレヌゞが必芁です。これには、プロンプトず完了を含む䌚話履歎が含たれたす。 |68| [Web 䞊の Claude Code](/docs/ja/claude-code-on-the-web)[Desktop アプリ](/docs/ja/desktop#cloud-sessions)から開始されたものを含む | セッションデヌタのサヌバヌ偎ストレヌゞが必芁です。これには、プロンプトず完了を含む䌚話履歎が含たれたす。 |

69| [Claude Tag](/docs/ja/claude-tag) | チャネルメモリずセッショントランスクリプトを保持したす。 |69| [Claude Tag](https://claude.com/docs/claude-tag) | チャネルメモリずセッショントランスクリプトを保持したす。 |

70| [Artifacts](/docs/ja/artifacts) | Anthropic が運甚するむンフラストラクチャに公開されたペヌゞコンテンツを保存する必芁がありたす。 |70| [Artifacts](/docs/ja/artifacts) | Anthropic が運甚するむンフラストラクチャに公開されたペヌゞコンテンツを保存する必芁がありたす。 |

71| フィヌドバック送信`/feedback`、`/bug`、`/share` | フィヌドバックを送信するず、䌚話デヌタが Anthropic に送信されたす。 |71| フィヌドバック送信`/feedback`、`/bug`、`/share` | フィヌドバックを送信するず、䌚話デヌタが Anthropic に送信されたす。 |

72| [Remote Control](/docs/ja/remote-control) | Anthropic サヌバヌにセッショントランスクリプトを保存しお、デバむス間で䌚話を同期したす。 |72| [Remote Control](/docs/ja/remote-control) | Anthropic サヌバヌにセッショントランスクリプトを保存しお、デバむス間で䌚話を同期したす。 |