plugins-reference.md 2026-09-24 22:57 UTC to 2026-09-25 23:58 UTC

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) - プラグインの設定オプション