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

概要

マーケットプレイス（プラグインカタログ）を通じてプラグインを検索・インストールする方法の仕様。プラグインはスキル・エージェント・フック・MCP サーバーを Claude Code に追加する。

仕様

マーケットプレイスの利用手順

マーケットプレイスを追加する（カタログを登録。プラグインはまだインストールされない）
個別のプラグインをインストールする

公式 Anthropic マーケットプレイス

Claude Code 初回起動時に claude-plugins-official マーケットプレイスを自動追加する
追加できなかった場合は /plugin marketplace add anthropics/claude-plugins-official で手動追加する
カタログ閲覧: /plugin コマンドの Discover タブ、または claude.com/plugins
インストール: /plugin install <name>@claude-plugins-official

公式マーケットプレイスのカテゴリ:

カテゴリ	内容
コードインテリジェンス	LSP ツールを有効化（定義ジャンプ・参照検索・型エラー検知）
外部インテグレーション	GitHub、GitLab、Atlassian、Asana、Linear、Notion、Figma、Vercel、Firebase、Supabase、Slack、Sentry
セキュリティレビュー	`security-guidance`: Claude が書いた変更を脆弱性チェックして同セッション内で修正
開発ワークフロー	`commit-commands`、`pr-review-toolkit`、`agent-sdk-dev`、`plugin-dev`
出力スタイル	`explanatory-output-style`、`learning-output-style`

コードインテリジェンスプラグイン

プラグインをインストールしても言語サーバーバイナリは自動インストールされない。別途インストールが必要。

言語	プラグイン名	必要なバイナリ
C/C++	`clangd-lsp`	`clangd`
C#	`csharp-lsp`	`csharp-ls`
Go	`gopls-lsp`	`gopls`
Java	`jdtls-lsp`	`jdtls`
Kotlin	`kotlin-lsp`	`kotlin-language-server`
Lua	`lua-lsp`	`lua-language-server`
PHP	`php-lsp`	`intelephense`
Python	`pyright-lsp`	`pyright-langserver`
Rust	`rust-analyzer-lsp`	`rust-analyzer`
Swift	`swift-lsp`	`sourcekit-lsp`
TypeScript	`typescript-lsp`	`typescript-language-server`

コードインテリジェンスプラグインがもたらす能力:

自動診断: ファイル編集後に型エラー・不足インポート・構文エラーを検知
コードナビゲーション: 定義ジャンプ・参照検索・型情報取得・シンボル一覧・実装検索・呼び出し階層

コミュニティマーケットプレイス

リポジトリ: anthropics/claude-plugins-community
追加: /plugin marketplace add anthropics/claude-plugins-community
インストール: /plugin install <name>@claude-community
Anthropic の自動バリデーションとセーフティスクリーニングを通過したサードパーティプラグイン
各プラグインは特定コミット SHA に固定されている

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

コマンド: /plugin marketplace add <source>

ソース形式	例
GitHub リポジトリ (`owner/repo`)	`anthropics/claude-code`
Git URL（GitLab 等）	`https://gitlab.com/company/plugins.git`
SSH URL	`git@gitlab.com:company/plugins.git`
ローカルパス	`./my-marketplace`
リモート URL	`https://example.com/marketplace.json`

バージョン指定: # の後に ref を付ける: https://gitlab.com/company/plugins.git#v1.0.0

Git ホスト別の注意事項:

ホスト	`.git` サフィックス
`github.com`、`gitlab.com`	あってもなくても可
Azure DevOps	省略する（`/_git/` を含む URL に `.git` を付けると失敗）
その他すべてのホスト	`.git` サフィックスを含める

https:// プレフィックスを含める（Claude Code v2.1.196 以降: プレフィックスなしは無効として拒否）

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

/plugin install plugin-name@marketplace-name

インストールスコープ:

スコープ	対象
User scope	自分のすべてのプロジェクト
Project scope	このリポジトリのすべての共同作業者（`.claude/settings.json` に追記）
Local scope	このリポジトリの自分のみ（共同作業者と共有しない）

インストール後のアクティベーション:

メッセージ	意味
`Plugin is now active.`	インストールと同時にアクティベート済み
`Run /reload-plugins to activate.`	プロンプトキャッシュ無効化を避けるため手動で `/reload-plugins` が必要

v2.1.221 より前: インストールは再起動または /reload-plugins まで有効にならない

マーケットプレイス名ありでインストールする場合のリフレッシュ動作（v2.1.232 以降）:

Claude Code はルックアップ前にそのマーケットプレイスを自動リフレッシュする
以下の場合はリフレッシュをスキップ: GitHub/Git/URL 以外のマーケットプレイス、シードディレクトリ提供、直近30秒以内にリフレッシュ済み、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 設定時、マネージドポリシーによるブロック

プラグインの管理

/plugin コマンドの Installed タブで管理:

f キーでお気に入り登録・解除
名前・説明でフィルタリング
Enter でプラグイン詳細画面（有効化・無効化・アンインストール）

管理コマンド:

/plugin list [--enabled | --disabled]
/plugin disable plugin-name@marketplace-name
/plugin enable plugin-name@marketplace-name
/plugin uninstall plugin-name@marketplace-name

--scope オプションで対象スコープを指定できる:

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

プロジェクトの .claude/settings.json が有効化しているプラグインをアンインストールする場合、「自分のみ無効化（.claude/settings.local.json に上書き）」か「全員からアンインストール（共有 .claude/settings.json から削除）」かを選択できる
未使用プラグイン（2週間以上・10セッション以上使っていない）は Not used recently ヘッダーに表示される（strictKnownMarketplaces が設定されている場合は非表示）

セッション内でのプラグイン変更の反映

/reload-plugins

キャッシュ無効化を伴う場合は確認メッセージが出る。--force で強制実行
claude plugin install シェルコマンド（非セッション）でインストールしたプラグインは次回起動時または /reload-plugins で反映される

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

/plugin marketplace list
/plugin marketplace update marketplace-name
/plugin marketplace remove marketplace-name  # 削除するとそこからインストールしたプラグインも削除される

自動更新の設定

/plugin > Marketplaces でマーケットプレイスごとに切り替える
セッション開始後、ランダムな最大10分の遅延で更新チェックが走る（更新があれば /reload-plugins を促すか次回起動時に反映）
DISABLE_AUTOUPDATER 環境変数でプラグイン自動更新を無効化できる
FORCE_AUTOUPDATE_PLUGINS=1 と DISABLE_AUTOUPDATER を同時に設定すると、Claude Code 本体の自動更新は止めつつプラグイン更新は有効にできる
command ソースのプラグインは auto-update 設定に関係なく1セッション1回コマンドを再実行してハッシュ変化時に新バージョンをインストールする

チーム向けマーケットプレイス設定

.claude/settings.json に extraKnownMarketplaces を追加することで、フォルダーを信頼した時点でマーケットプレイスを自動追加できる。

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

v2.1.195 以降: マーケットプレイスの追加はプラグインをインストールしない（外部ソースのプラグインはユーザーが手動でインストールするまでロードされない）

制約・注意点

プラグインとマーケットプレイスはユーザー権限で任意のコードを実行できる高信頼コンポーネント。信頼できるソースのみ追加・インストールする
クラウド環境変数と設定スクリプトには機密情報を含めない（環境を使う全員が読める）
/plugin コマンドが使えない環境では Claude デスクトップアプリのプラグインブラウザを使うか、.claude/settings.json の enabledPlugins で宣言する