claude-howto/ja/07-plugins/README.md

Claude Code プラグイン

このフォルダには、複数の Claude Code 機能をひとつのインストール可能なパッケージにまとめた、完成度の高いプラグインの例が収録されている。

概要

Claude Code プラグインは、カスタマイズ（スラッシュコマンド、サブエージェント、MCP サーバー、フック）を束ねて 1 コマンドでインストールできるバンドル形式である。複数の機能をまとめて配布できる、最も上位の拡張機構と言える。

プラグインのアーキテクチャ

graph TB
    A["Plugin"]
    B["Slash Commands"]
    C["Subagents"]
    D["MCP Servers"]
    E["Hooks"]
    F["Configuration"]

    A -->|bundles| B
    A -->|bundles| C
    A -->|bundles| D
    A -->|bundles| E
    A -->|bundles| F

プラグインの読み込みプロセス

sequenceDiagram
    participant User
    participant Claude as Claude Code
    participant Plugin as Plugin Marketplace
    participant Install as Installation
    participant SlashCmds as Slash Commands
    participant Subagents
    participant MCPServers as MCP Servers
    participant Hooks
    participant Tools as Configured Tools

    User->>Claude: /plugin install pr-review
    Claude->>Plugin: Download plugin manifest
    Plugin-->>Claude: Return plugin definition
    Claude->>Install: Extract components
    Install->>SlashCmds: Configure
    Install->>Subagents: Configure
    Install->>MCPServers: Configure
    Install->>Hooks: Configure
    SlashCmds-->>Tools: Ready to use
    Subagents-->>Tools: Ready to use
    MCPServers-->>Tools: Ready to use
    Hooks-->>Tools: Ready to use
    Tools-->>Claude: Plugin installed ✅

プラグインの種類と配布

種別	スコープ	共有範囲	管理主体	例
Official	グローバル	全ユーザー	Anthropic	PR Review、Security Guidance
Community	公開	全ユーザー	コミュニティ	DevOps、Data Science
Organization	社内	チームメンバー	企業	社内標準・ツール
Personal	個人	単一ユーザー	開発者	個別ワークフロー

プラグイン定義の構造

プラグインのマニフェストは .claude-plugin/plugin.json の JSON 形式で記述する：

{
  "name": "my-first-plugin",
  "description": "A greeting plugin",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  },
  "homepage": "https://example.com",
  "repository": "https://github.com/user/repo",
  "license": "MIT"
}

プラグイン構造の例

my-plugin/
├── .claude-plugin/
│   └── plugin.json       # マニフェスト（name、description、version、author）
├── commands/             # Markdown 形式のスキル
│   ├── task-1.md
│   ├── task-2.md
│   └── workflows/
├── agents/               # カスタムエージェント定義
│   ├── specialist-1.md
│   ├── specialist-2.md
│   └── configs/
├── skills/               # SKILL.md ファイルを伴うエージェントスキル
│   ├── skill-1.md
│   └── skill-2.md
├── hooks/                # hooks.json のイベントハンドラ
│   └── hooks.json
├── .mcp.json             # MCP サーバーの設定
├── .lsp.json             # コードインテリジェンス用の LSP サーバー設定
├── bin/                  # プラグイン有効化中に Bash ツールの PATH に追加される実行ファイル
├── settings.json         # プラグイン有効化時に適用されるデフォルト設定（現状は `agent` キーのみサポート）
├── themes/               # 任意：Claude Code のカスタムテーマを同梱（v2.1.118 以降）
├── templates/
│   └── issue-template.md
├── scripts/
│   ├── helper-1.sh
│   └── helper-2.py
├── docs/
│   ├── README.md
│   └── USAGE.md
└── tests/
    └── plugin.test.js

LSP サーバーの設定

プラグインはリアルタイムなコードインテリジェンス向けに Language Server Protocol（LSP）サポートを含められる。LSP サーバーは作業中の診断、コードナビゲーション、シンボル情報を提供する。

設定の場所：

• プラグインのルートディレクトリにある .lsp.json
• plugin.json 内のインライン lsp キー

フィールドリファレンス

フィールド	必須	説明
command	はい	LSP サーバーのバイナリ（PATH 上にある必要あり）
extensionToLanguage	はい	ファイル拡張子を言語 ID にマップ
args	いいえ	サーバーへのコマンドライン引数
transport	いいえ	通信方式：stdio（デフォルト）または socket
env	いいえ	サーバープロセス用の環境変数
initializationOptions	いいえ	LSP 初期化時に送るオプション
settings	いいえ	サーバーへ渡すワークスペース設定
workspaceFolder	いいえ	ワークスペースフォルダのパスを上書き
startupTimeout	いいえ	サーバー起動を待つ最大時間（ミリ秒）
shutdownTimeout	いいえ	正常終了を待つ最大時間（ミリ秒）
restartOnCrash	いいえ	クラッシュ時に自動再起動するか
maxRestarts	いいえ	諦めるまでの再起動回数の上限

設定例

Go（gopls）：

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

Python（pyright）：

{
  "python": {
    "command": "pyright-langserver",
    "args": ["--stdio"],
    "extensionToLanguage": {
      ".py": "python",
      ".pyi": "python"
    }
  }
}

TypeScript：

{
  "typescript": {
    "command": "typescript-language-server",
    "args": ["--stdio"],
    "extensionToLanguage": {
      ".ts": "typescript",
      ".tsx": "typescriptreact",
      ".js": "javascript",
      ".jsx": "javascriptreact"
    }
  }
}

利用可能な LSP プラグイン

公式マーケットプレイスには事前設定された LSP プラグインが含まれる：

プラグイン	言語	サーバーバイナリ	インストールコマンド
pyright-lsp	Python	pyright-langserver	pip install pyright
typescript-lsp	TypeScript / JavaScript	typescript-language-server	npm install -g typescript-language-server typescript
rust-lsp	Rust	rust-analyzer	rustup component add rust-analyzer でインストール

LSP の機能

設定が完了すると、LSP サーバーは以下を提供する：

• 即時診断 — 編集直後にエラーや警告が表示される
• コードナビゲーション — 定義へジャンプ、参照や実装を検索
• ホバー情報 — ホバー時に型シグネチャやドキュメントを表示
• シンボル一覧 — 現在のファイルやワークスペースのシンボルを閲覧

プラグインのオプション（v2.1.83 以降）

プラグインはマニフェストの userConfig を介してユーザーが設定可能なオプションを宣言できる。sensitive: true のフィールドは平文の設定ファイルではなくシステムキーチェーンに保存される：

{
  "name": "my-plugin",
  "version": "1.0.0",
  "userConfig": {
    "apiKey": {
      "description": "API key for the service",
      "sensitive": true
    },
    "region": {
      "description": "Deployment region",
      "default": "us-east-1"
    }
  }
}

永続的なプラグインデータ（${CLAUDE_PLUGIN_DATA}）（v2.1.78 以降）

プラグインは ${CLAUDE_PLUGIN_DATA} 環境変数経由で永続的な状態保存ディレクトリにアクセスできる。このディレクトリはプラグインごとに固有で、セッションをまたいで残るため、キャッシュ・データベース・その他の永続状態の保存先に適している：

{
  "hooks": {
    "PostToolUse": [
      {
        "command": "node ${CLAUDE_PLUGIN_DATA}/track-usage.js"
      }
    ]
  }
}

このディレクトリはプラグインのインストール時に自動作成される。ここに保存したファイルはプラグインがアンインストールされるまで保持される。

バックグラウンドモニター（v2.1.105）

プラグインは、セッション開始時やプラグインのスキル呼び出し時に自動起動するバックグラウンドモニターを登録できる。プラグインマニフェストにトップレベルの monitors キーを追加する：

{
  "name": "my-plugin",
  "version": "1.0.0",
  "monitors": [
    {
      "command": "tail -f /var/log/app.log",
      "trigger": "session_start"
    }
  ]
}

trigger フィールドが受け付ける値：

• "session_start" — セッション開始時に自動でモニターを起動
• "skill_invoke" — プラグインのスキルが呼ばれたときにモニターを起動

モニターは内部的に Monitor ツールを利用しており、stdout の各行を Claude が反応できるイベントとしてストリーミングする。

設定によるインラインプラグイン（source: 'settings'）（v2.1.80 以降）

プラグインは、source: 'settings' フィールドを使って設定ファイル中にマーケットプレイスエントリとしてインラインで定義できる。これにより、別個のリポジトリやマーケットプレイスを用意せずにプラグイン定義を直接埋め込める：

{
  "pluginMarketplaces": [
    {
      "name": "inline-tools",
      "source": "settings",
      "plugins": [
        {
          "name": "quick-lint",
          "source": "./local-plugins/quick-lint"
        }
      ]
    }
  ]
}

プラグインの設定

プラグインはデフォルト設定を提供するために settings.json を同梱できる。現状サポートされるのは agent キーで、プラグインのメインスレッドエージェントを設定する：

{
  "agent": "agents/specialist-1.md"
}

settings.json を含むプラグインをインストールすると、そのデフォルト値が適用される。ユーザーは自身のプロジェクト設定やユーザー設定で上書きできる。

スタンドアロン vs プラグイン方式

方式	コマンド名	設定	向いているケース
スタンドアロン	/hello	CLAUDE.md で手動セットアップ	個人用、プロジェクト固有
プラグイン	/plugin-name:hello	plugin.json で自動化	共有・配布・チーム利用

個人で素早く使うワークフローには スタンドアロンのスラッシュコマンド を、複数機能をまとめてチームで共有したり配布したい場合は プラグイン を使う。

実用例

例 1：PR Review プラグイン

ファイル： .claude-plugin/plugin.json

{
  "name": "pr-review",
  "version": "1.0.0",
  "description": "Complete PR review workflow with security, testing, and docs",
  "author": {
    "name": "Anthropic"
  },
  "repository": "https://github.com/your-org/pr-review",
  "license": "MIT"
}

ファイル： commands/review-pr.md

---
name: Review PR
description: Start comprehensive PR review with security and testing checks
---

# PR Review

This command initiates a complete pull request review including:

1. Security analysis
2. Test coverage verification
3. Documentation updates
4. Code quality checks
5. Performance impact assessment

ファイル： agents/security-reviewer.md

---
name: security-reviewer
description: Security-focused code review
tools: Read, Grep, Bash
---

# Security Reviewer

Specializes in finding security vulnerabilities:
- Authentication/authorization issues
- Data exposure
- Injection attacks
- Secure configuration

インストール：

/plugin install pr-review

# Result:
# ✅ 3 slash commands installed
# ✅ 3 subagents configured
# ✅ 2 MCP servers connected
# ✅ 4 hooks registered
# ✅ Ready to use!

例 2：DevOps プラグイン

構成要素：

devops-automation/
├── commands/
│   ├── deploy.md
│   ├── rollback.md
│   ├── status.md
│   └── incident.md
├── agents/
│   ├── deployment-specialist.md
│   ├── incident-commander.md
│   └── alert-analyzer.md
├── mcp/
│   ├── github-config.json
│   ├── kubernetes-config.json
│   └── prometheus-config.json
├── hooks/
│   ├── pre-deploy.js
│   ├── post-deploy.js
│   └── on-error.js
└── scripts/
    ├── deploy.sh
    ├── rollback.sh
    └── health-check.sh

例 3：Documentation プラグイン

同梱コンポーネント：

documentation/
├── commands/
│   ├── generate-api-docs.md
│   ├── generate-readme.md
│   ├── sync-docs.md
│   └── validate-docs.md
├── agents/
│   ├── api-documenter.md
│   ├── code-commentator.md
│   └── example-generator.md
├── mcp/
│   ├── github-docs-config.json
│   └── slack-announce-config.json
└── templates/
    ├── api-endpoint.md
    ├── function-docs.md
    └── adr-template.md

プラグインマーケットプレイス

Anthropic が運営する公式プラグインディレクトリは anthropics/claude-plugins-official である。エンタープライズ管理者は社内配布用にプライベートのプラグインマーケットプレイスを作ることもできる。

graph TB
    A["Plugin Marketplace"]
    B["Official<br/>anthropics/claude-plugins-official"]
    C["Community<br/>Marketplace"]
    D["Enterprise<br/>Private Registry"]

    A --> B
    A --> C
    A --> D

    B -->|Categories| B1["Development"]
    B -->|Categories| B2["DevOps"]
    B -->|Categories| B3["Documentation"]

    C -->|Search| C1["DevOps Automation"]
    C -->|Search| C2["Mobile Dev"]
    C -->|Search| C3["Data Science"]

    D -->|Internal| D1["Company Standards"]
    D -->|Internal| D2["Legacy Systems"]
    D -->|Internal| D3["Compliance"]

    style A fill:#e1f5fe,stroke:#333,color:#333
    style B fill:#e8f5e9,stroke:#333,color:#333
    style C fill:#f3e5f5,stroke:#333,color:#333
    style D fill:#fff3e0,stroke:#333,color:#333

マーケットプレイスの設定

エンタープライズや上級ユーザーは、設定を通じてマーケットプレイスの挙動を制御できる：

設定	説明
extraKnownMarketplaces	デフォルト以外のマーケットプレイスソースを追加
strictKnownMarketplaces	ユーザーが追加できるマーケットプレイスを制限（管理者専用）
blockedMarketplaces	管理者が管理するマーケットプレイスのブロックリスト（v2.1.119 以降は hostPattern / pathPattern の正規表現フィールドをサポート）
deniedPlugins	管理者が管理する、特定のプラグインをインストールさせないブロックリスト

より分かりやすいエイリアス（v2.1.232）：additionalMarketplaces は extraKnownMarketplaces の、allowedMarketplaces は strictKnownMarketplaces のエイリアスとして受け付けられる。changelog 由来 — v2.1.232 の changelog で告知されたが、公式の settings リファレンスにはまだ記載がない。正式なキーをそのまま使い続けて問題ない。

オーナーのワイルドカード（v2.1.223 以降）："owner/*" エントリは、ある GitHub オーナー配下のすべてのマーケットプレイスリポジトリを許可またはブロックする。strictKnownMarketplaces と blockedMarketplaces でのみ受け付けられる。 extraKnownMarketplaces や /plugin marketplace add を含め、github ソースが登場する他の箇所では、repo の値は単一のリポジトリを指定しなければならない。

適用範囲（v2.1.117 以降）：blockedMarketplaces と strictKnownMarketplaces は最初の追加時だけでなく、インストール・更新・リフレッシュ・自動更新といったあらゆるプラグインのライフサイクルイベントで適用される。strictKnownMarketplaces は管理者専用。

blockedMarketplaces でホスト / パス正規表現を使う例（v2.1.119）：

{
  "blockedMarketplaces": [
    {
      "hostPattern": "^evil\\.example\\.com$",
      "pathPattern": "^/marketplaces/.*"
    }
  ]
}

マーケットプレイスの追加機能

• デフォルトの git タイムアウト：大規模なプラグインリポジトリ向けに 30 秒から 120 秒へ拡大
• カスタム npm レジストリ：依存関係解決にカスタム npm レジストリ URL を指定可能
• バージョンピン留め：再現可能な環境のためにプラグインを特定バージョンに固定

マーケットプレイス定義のスキーマ

プラグインマーケットプレイスは .claude-plugin/marketplace.json で定義する：

{
  "name": "my-team-plugins",
  "owner": "my-org",
  "plugins": [
    {
      "name": "code-standards",
      "source": "./plugins/code-standards",
      "description": "Enforce team coding standards",
      "version": "1.2.0",
      "author": "platform-team"
    },
    {
      "name": "deploy-helper",
      "source": {
        "source": "github",
        "repo": "my-org/deploy-helper",
        "ref": "v2.0.0"
      },
      "description": "Deployment automation workflows"
    }
  ]
}

フィールド	必須	説明
name	はい	kebab-case のマーケットプレイス名
owner	はい	マーケットプレイスを保守する組織またはユーザー
plugins	はい	プラグインエントリの配列
plugins[].name	はい	プラグイン名（kebab-case）
plugins[].source	はい	プラグインソース（パス文字列または source オブジェクト）
plugins[].description	いいえ	プラグインの簡単な説明
plugins[].version	いいえ	セマンティックバージョン文字列
plugins[].author	いいえ	プラグイン作者名

プラグインソースの種類

プラグインは複数のソースから取得できる：

ソース	構文	例
相対パス	パス文字列	"./plugins/my-plugin"
GitHub	{ "source": "github", "repo": "owner/repo" }	{ "source": "github", "repo": "acme/lint-plugin", "ref": "v1.0" }
Git URL	{ "source": "url", "url": "..." }	{ "source": "url", "url": "https://git.internal/plugin.git" }
Git サブディレクトリ	{ "source": "git-subdir", "url": "...", "path": "..." }	{ "source": "git-subdir", "url": "https://github.com/org/monorepo.git", "path": "packages/plugin" }
npm	{ "source": "npm", "package": "..." }	{ "source": "npm", "package": "@acme/claude-plugin", "version": "^2.0" }
pip	{ "source": "pip", "package": "..." }	{ "source": "pip", "package": "claude-data-plugin", "version": ">=1.0" }

GitHub および git ソースは、バージョンピン留め用に任意の ref（ブランチ / タグ）と sha（コミットハッシュ）フィールドをサポートする。

配布方法

GitHub（推奨）：

# Users add your marketplace
/plugin marketplace add owner/repo-name

その他の git サービス（完全な URL が必要）：

/plugin marketplace add https://gitlab.com/org/marketplace-repo.git

プライベートリポジトリ：git の credential helper や環境変数のトークン経由でサポートされる。ユーザーは対象リポジトリへの読み取り権限を持っている必要がある。

公式マーケットプレイスへの提出：claude.ai/settings/plugins/submit または platform.claude.com/plugins/submit から、Anthropic がキュレートする公式マーケットプレイスにプラグインを提出して広く配布できる。

マーケットプレイスの管理

# Marketplace CLI commands
claude plugin marketplace add <source>       # Add marketplace (GitHub, URL, local)
claude plugin marketplace update [name]      # Refresh catalog index
claude plugin marketplace remove <name>      # Remove marketplace
claude plugin marketplace list               # List configured marketplaces

重要：marketplace update はプラグインカタログ（インストール可能な一覧）を更新するだけで、インストール済みプラグインは更新しない。インストール済みプラグインを更新するには plugin update <name> を使う。

Strict モード

マーケットプレイス定義とローカルの plugin.json の関係を制御する：

設定	動作
strict: true（デフォルト）	ローカルの plugin.json が正で、マーケットプレイスのエントリは補足扱い
strict: false	マーケットプレイスのエントリがプラグイン定義の全てとなる

strictKnownMarketplaces による 組織の制限：

値	効果
未設定	制限なし — ユーザーは任意のマーケットプレイスを追加可能
空配列 []	ロックダウン — マーケットプレイスを追加不可
パターン配列	許可リスト — 一致するマーケットプレイスのみ追加可能

{
  "strictKnownMarketplaces": [
    "my-org/*",
    "github.com/trusted-vendor/*"
  ]
}

警告：strictKnownMarketplaces を使った strict モードでは、ユーザーは許可リストにあるマーケットプレイスからしかプラグインをインストールできない。プラグイン配布を制御したいエンタープライズ環境で有用。

プラグインのインストールとライフサイクル

graph LR
    A["Discover"] -->|Browse| B["Marketplace"]
    B -->|Select| C["Plugin Page"]
    C -->|View| D["Components"]
    D -->|Install| E["/plugin install"]
    E -->|Extract| F["Configure"]
    F -->|Activate| G["Use"]
    G -->|Check| H["Update"]
    H -->|Available| G
    G -->|Done| I["Disable"]
    I -->|Later| J["Enable"]
    J -->|Back| G

プラグインの機能比較

機能	スラッシュコマンド	スキル	サブエージェント	プラグイン
インストール	手動コピー	手動コピー	手動設定	1 コマンド
セットアップ時間	5 分	10 分	15 分	2 分
バンドル	単一ファイル	単一ファイル	単一ファイル	複数
バージョン管理	手動	手動	手動	自動
チーム共有	ファイルコピー	ファイルコピー	ファイルコピー	インストール ID
更新	手動	手動	手動	自動取得
依存関係	なし	なし	なし	含めることが可能
マーケットプレイス	なし	なし	なし	あり
配布	リポジトリ	リポジトリ	リポジトリ	マーケットプレイス

プラグイン CLI コマンド

すべてのプラグイン操作は CLI コマンドとして利用できる：

claude plugin install <name>@<marketplace>   # Install from a marketplace
claude plugin uninstall <name>               # Remove a plugin
claude plugin update <name>                  # Update installed plugin to latest version
claude plugin list                           # List installed plugins
claude plugin enable <name>                  # Enable a disabled plugin
claude plugin disable <name>                 # Disable a plugin
claude plugin validate                       # Validate plugin structure
claude plugin tag <version>                  # Create a release git tag with version validation (v2.1.118+)

例：claude plugin tag v0.3.0 はバージョン形式を検証し、対応する git タグを作成する。配布用にプラグインをリリースする際の推奨手順である。

インストール方法

マーケットプレイスから

/plugin install plugin-name
# or from CLI:
claude plugin install plugin-name@marketplace-name

すぐに反映されるか？ v2.1.221 以降はたいてい反映される。インストール要約の最終行を確認する：

インストール要約の表示	意味
Plugin is now active.	Claude Code がインストールの一環としてプラグインを有効化した。追加の操作は不要。
Run /reload-plugins to activate.	インストールは済んだがまだ有効ではない。有効化するとプロンプトキャッシュが無効になるため、または有効化の試行が失敗したため。

v2.1.221 より前は、/reload-plugins を実行するか再起動するまで、どのインストールも現在のセッションには反映されなかった。

有効化 / 無効化（スコープは自動検出）

/plugin enable plugin-name
/plugin disable plugin-name

ローカルプラグイン（開発用）

# CLI flag for local testing (repeatable for multiple plugins)
claude --plugin-dir ./path/to/plugin
claude --plugin-dir ./plugin-a --plugin-dir ./plugin-b

Git リポジトリから

/plugin install github:username/repo

自動更新

Claude Code は起動時にマーケットプレイスとそこにインストール済みのプラグインを自動更新できる。

マーケットプレイス種別	自動更新のデフォルト	切り替え方法
Official（claude-plugins-official）	✅ 有効	/plugin → Marketplaces → 選択
サードパーティ / ローカル	❌ 無効	同じ UI パス

自動更新が走ると、Claude Code は次の処理を行う：

1. マーケットプレイスのカタログを更新
2. インストール済みプラグインを最新バージョンへ更新
3. プラグインごとに結果を報告する：更新の一環として有効化された場合は Plugin is now active.、そうでない場合は Run /reload-plugins to activate.

環境変数

変数	効果
DISABLE_AUTOUPDATER=1	すべての自動更新（Claude Code + プラグイン）を無効化
DISABLE_AUTOUPDATER=1 + FORCE_AUTOUPDATE_PLUGINS=1	プラグインの自動更新は維持し、Claude Code 自体の更新を無効化

# Disable all auto-updates
export DISABLE_AUTOUPDATER=1

# Keep plugin auto-updates only
export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

プラグインを作るべきとき

graph TD
    A["Should I create a plugin?"]
    A -->|Need multiple components| B{"Multiple commands<br/>or subagents<br/>or MCPs?"}
    B -->|Yes| C["✅ Create Plugin"]
    B -->|No| D["Use Individual Feature"]
    A -->|Team workflow| E{"Share with<br/>team?"}
    E -->|Yes| C
    E -->|No| F["Keep as Local Setup"]
    A -->|Complex setup| G{"Needs auto<br/>configuration?"}
    G -->|Yes| C
    G -->|No| D

プラグインのユースケース

ユースケース	推奨	理由
チームのオンボーディング	✅ プラグインを使う	即時セットアップで設定がすべて整う
フレームワークのセットアップ	✅ プラグインを使う	フレームワーク固有のコマンドをまとめられる
エンタープライズ標準	✅ プラグインを使う	一元配布とバージョン管理
小さなタスクの自動化	❌ コマンドを使う	プラグインは過剰
単一ドメインの専門知識	❌ スキルを使う	プラグインは重すぎる、スキルで十分
特殊な解析	❌ サブエージェントを使う	手動作成またはスキルで対応
ライブデータへのアクセス	❌ MCP を使う	単独で使い、バンドルしない

プラグインのテスト

公開前に、--plugin-dir CLI フラグ（複数指定可能）を使ってプラグインをローカルでテストする：

claude --plugin-dir ./my-plugin
claude --plugin-dir ./my-plugin --plugin-dir ./another-plugin

これによりプラグインを読み込んだ状態で Claude Code が起動し、次を確認できる：

• すべてのスラッシュコマンドが利用可能であること
• サブエージェントとエージェントが正しく機能すること
• MCP サーバーが正常に接続されること
• フックが実行されること
• LSP サーバーの設定
• 設定エラーがないこと

ホットリロード

プラグインは開発中のホットリロードをサポートする。プラグインのファイルを修正すると Claude Code が変更を自動検出する。次のコマンドでも強制的にリロードできる：

/reload-plugins

これにより、セッションを再起動せずに、すべてのプラグインのマニフェスト・コマンド・エージェント・スキル・フック・MCP / LSP 設定が再読み込みされる。

プラグイン向けの管理対象設定

管理者は管理対象設定を使って組織全体のプラグイン挙動を制御できる：

設定	説明
enabledPlugins	デフォルトで有効化するプラグインの許可リスト
deniedPlugins	インストールを禁止するプラグインのブロックリスト
extraKnownMarketplaces	デフォルト以外のマーケットプレイスソースを追加
strictKnownMarketplaces	ユーザーが追加できるマーケットプレイスを制限（管理者専用、v2.1.117 以降はあらゆるプラグインのライフサイクルイベントで適用）
blockedMarketplaces	マーケットプレイスのブロックリスト（v2.1.117 以降はあらゆるライフサイクルイベントで適用、v2.1.119 以降は hostPattern / pathPattern の正規表現フィールドをサポート）
allowedChannelPlugins	リリースチャネルごとに許可するプラグインを制御

より分かりやすいエイリアス（v2.1.232）：additionalMarketplaces は extraKnownMarketplaces の、allowedMarketplaces は strictKnownMarketplaces のエイリアスとして受け付けられる。changelog 由来 — v2.1.232 の changelog で告知されたが、公式の settings リファレンスにはまだ記載がない。正式なキーをそのまま使い続けて問題ない。

オーナーのワイルドカード（v2.1.223 以降）："owner/*" エントリは、ある GitHub オーナー配下のすべてのマーケットプレイスリポジトリを許可またはブロックする。strictKnownMarketplaces と blockedMarketplaces でのみ受け付けられる。 extraKnownMarketplaces や /plugin marketplace add を含め、github ソースが登場する他の箇所では、repo の値は単一のリポジトリを指定しなければならない。

これらの設定は管理対象設定ファイルで組織レベルに適用でき、ユーザーレベルの設定より優先される。

プラグインのセキュリティ

プラグインのサブエージェントは制限付きサンドボックスで動作する。プラグインのサブエージェント定義では以下のフロントマターキーは 使用不可 である：

• hooks — サブエージェントはイベントハンドラを登録できない
• mcpServers — サブエージェントは MCP サーバーを設定できない
• permissionMode — サブエージェントは権限モデルを上書きできない

これにより、プラグインが宣言したスコープを超えて権限昇格したりホスト環境を変更したりできないようにしている。

プラグインの公開

公開手順：

1. すべてのコンポーネントを含むプラグイン構造を作成
2. .claude-plugin/plugin.json マニフェストを記述
3. ドキュメント用の README.md を作成
4. claude --plugin-dir ./my-plugin でローカルテスト
5. claude plugin tag v0.3.0（v2.1.118 以降）でリリースタグを作成 — バージョン文字列を検証し、対応する git タグを作成
6. プラグインマーケットプレイスへ提出
7. レビューと承認を受ける
8. マーケットプレイスで公開
9. ユーザーが 1 コマンドでインストール可能になる

提出例：

# PR Review Plugin

## Description
Complete PR review workflow with security, testing, and documentation checks.

## What's Included
- 3 slash commands for different review types
- 3 specialized subagents
- GitHub and CodeQL MCP integration
- Automated security scanning hooks

## Installation
```bash
/plugin install pr-review

Features

✅ Security analysis ✅ Test coverage checking ✅ Documentation verification ✅ Code quality assessment ✅ Performance impact analysis

Usage

/review-pr
/check-security
/check-tests

Requirements

• Claude Code 2.1+
• GitHub access
• CodeQL (optional)

## プラグイン vs 手動設定

**手動セットアップ（2 時間以上）：**
- スラッシュコマンドを 1 つずつインストール
- サブエージェントを個別に作成
- MCP を別々に設定
- フックを手動で設定
- すべてをドキュメント化
- チームに共有（正しく設定してくれることを祈る）

**プラグインを使う場合（2 分）：**
```bash
/plugin install pr-review
# ✅ Everything installed and configured
# ✅ Ready to use immediately
# ✅ Team can reproduce exact setup

ベストプラクティス

Do（推奨）✅

• 明快で説明的なプラグイン名を使う
• 包括的な README を含める
• セマンティックバージョニングで適切にバージョン管理する
• すべてのコンポーネントを通しでテストする
• 必要要件を明確にドキュメント化する
• 使用例を提供する
• エラーハンドリングを含める
• 検索性を高めるタグを付ける
• 後方互換性を維持する
• プラグインを焦点を絞った一貫性ある内容に保つ
• 包括的なテストを含める
• すべての依存関係をドキュメント化する

Don't（避ける）❌

• 関連のない機能を混ぜない
• 認証情報をハードコードしない
• テストを省略しない
• ドキュメントを忘れない
• 重複したプラグインを作らない
• バージョン管理を軽視しない
• コンポーネント間の依存を複雑にしすぎない
• エラーを優雅に処理することを忘れない

インストール手順

マーケットプレイスからインストール

1. 利用可能なプラグインを閲覧：

   /plugin list
   

2. プラグインの詳細を表示：

   /plugin info plugin-name
   

3. プラグインをインストール：

   /plugin install plugin-name
   

ローカルパスからインストール

/plugin install ./path/to/plugin-directory

GitHub からインストール

/plugin install github:username/repo

インストール済みプラグインの一覧

/plugin list --installed

プラグインの更新

/plugin update plugin-name

プラグインの無効化 / 有効化

# Temporarily disable
/plugin disable plugin-name

# Re-enable
/plugin enable plugin-name

プラグインのアンインストール

/plugin uninstall plugin-name

関連概念

以下の Claude Code 機能はプラグインと組み合わせて動作する：

• スラッシュコマンド — プラグインに含まれる個々のコマンド
• メモリ — プラグイン用の永続コンテキスト
• スキル — プラグインに包めるドメイン専門知識
• サブエージェント — プラグインのコンポーネントとして含まれる専門エージェント
• MCP サーバー — プラグインに同梱される Model Context Protocol 連携
• フック — プラグインのワークフローを起動するイベントハンドラ

完全なワークフロー例

PR Review プラグインの全ワークフロー

1. User: /review-pr

2. Plugin executes:
   ├── pre-review.js hook validates git repo
   ├── GitHub MCP fetches PR data
   ├── security-reviewer subagent analyzes security
   ├── test-checker subagent verifies coverage
   └── performance-analyzer subagent checks performance

3. Results synthesized and presented:
   ✅ Security: No critical issues
   ⚠️  Testing: Coverage 65% (recommend 80%+)
   ✅ Performance: No significant impact
   📝 12 recommendations provided

トラブルシューティング

プラグインがインストールできない

• Claude Code のバージョン互換性を確認：/version
• JSON バリデーターで plugin.json の構文を検証
• インターネット接続を確認（リモートプラグインの場合）
• 権限を確認：ls -la plugin/

コンポーネントが読み込まれない

• plugin.json のパスが実際のディレクトリ構造と一致するか確認
• ファイル権限を確認：chmod +x scripts/
• コンポーネントファイルの構文を確認
• ログを確認：/plugin debug plugin-name

MCP 接続が失敗する

• 環境変数が正しく設定されているか確認
• MCP サーバーのインストール状況と健全性を確認
• /mcp test で MCP 接続を単独で確認
• mcp/ ディレクトリ内の MCP 設定を確認

インストール後にコマンドが利用できない

• プラグインが正しくインストールされているか確認：/plugin list --installed
• プラグインが有効か確認：/plugin status plugin-name
• Claude Code を再起動：exit して再度開く
• 既存のコマンドと名前が衝突していないか確認

フック実行の問題

• フックファイルの権限が正しいか確認
• フックの構文とイベント名を確認
• フックのログでエラー詳細を確認
• 可能ならフックを手動でテスト

追加リソース

• 公式プラグインドキュメント
• プラグインを探す
• プラグインマーケットプレイス
• プラグインリファレンス
• MCP サーバーリファレンス
• サブエージェント設定ガイド
• フックシステムリファレンス

---

最終更新: 2026 年 8 月 15 日 Claude Code バージョン: 2.1.233 出典:

• https://code.claude.com/docs/en/discover-plugins
• https://code.claude.com/docs/en/settings
• https://code.claude.com/docs/en/plugins
• https://code.claude.com/docs/en/plugin-marketplaces
• https://github.com/anthropics/claude-code/releases/tag/v2.1.117
• https://github.com/anthropics/claude-code/releases/tag/v2.1.118
• https://github.com/anthropics/claude-code/releases/tag/v2.1.119 対応モデル: Claude Sonnet 4.6、Claude Opus 4.7、Claude Haiku 4.5