プラグインをインストールすると、そのプラグインに含まれるスキル・エージェント・フック・MCP サーバーが手元の Claude Code に追加されます。この記事では、公式ドキュメント「Install and manage plugins」に沿って、ターミナルでのインストール手順、3つのインストールスコープの違い、公式以外のマーケットプレイスの追加、インストール後の有効化・無効化・削除、更新の仕組みを順に整理します。プラグインを作る側の手順はプラグイン作成の記事を参照してください。
プラグインをインストールする
公式ドキュメントでは、Anthropic 公式マーケットプレイス(claude-plugins-official)にある commit-commands(コミット・push・プルリクエスト作成のコマンドを追加するプラグイン)を例に説明しています。別のプラグインでも、名前とマーケットプレイス名を置き換えれば手順は同じです。公式マーケットプレイスは、対話型のターミナルセッションを初めて起動したときに Claude Code が自動で追加します。
プロジェクトで claude を起動し、プラグイン名とマーケットプレイス名を指定して実行します。
/plugin install commit-commands@claude-plugins-official
セッション内のこのコマンドはすぐにはインストールしません。/plugin パネルがそのプラグインの詳細画面で開き、内容を確認してからスコープを選ぶ流れになります。プラグイン名を付けずに /plugin だけを実行すると Discover タブが開き、文字を打って検索し、Enter で詳細を開けます。
詳細画面には説明文のほか、次の情報が表示されることがあります。
- Will install: 追加されるコマンド・エージェント・スキル・フック・MCP / LSP サーバー
- Last updated: 公式マーケットプレイスのプラグインで表示
- Context cost: 公式マーケットプレイスのプラグインで表示される2つのトークン見積もり。Every turn は毎メッセージに加わる量、When invoked はスキルやエージェントが読み込まれたときに加わる量です(マーケットプレイス名付きで開いた場合や Marketplaces タブから開いた場合に表示され、Discover 一覧から開いた詳細には出ません)
プラグインはフックや MCP サーバーを実行できるため、インストール前に詳細画面を読むよう公式は勧めています。スコープを選ぶとインストールが行われ、要約の最後の一文で状態がわかります。
Plugin is now active.: そのまま使えますPlugin is now active.の後にIts bundled MCP server needsで始まる注記: 同梱 MCP サーバーの設定が必要です。Installed タブでプラグインを選び Configure を実行しますRun /reload-plugins to apply.: パネルが閉じて再読み込みが自動実行されます。プロンプトキャッシュを無効化してしまう場合は警告して保留になり、/reload-plugins --forceで反映できます(キャッシュなしのリクエストが1回発生)The plugin couldn'tを含む: 読み込み失敗。/pluginの Errors タブで理由を確認します
動作確認は、/ を打って /<plugin>:<skill> 形式のスキル(例: /commit-commands:commit)が出るかを見ます。/plugin の Installed タブや、シェルでの claude plugin list でも一覧できます。
セッションを開かずにシェルやセットアップスクリプトから入れる場合は claude plugin install を使います。既定はユーザースコープで、入れたプラグインは次回起動時か、開いているセッションで /reload-plugins を実行したときに読み込まれます。
claude plugin install formatter@your-org --scope project
マーケットプレイス側が指定するコマンドを実行してインストールする command ソースのプラグインでは、実行前に確認を求められます。応答する人がいないスクリプトでは --yes を付けます。なお、デスクトップアプリでは + ボタンの Add plugins、VS Code では /plugins で開く Manage plugins から同様にインストールできます。claude -p などの非対話実行では /plugin は使えませんが、インストール済みのプラグインは読み込まれます。
インストールスコープを選ぶ
インストールスコープは「誰がそのプラグインを使えるか」と「どの設定ファイルに有効化が記録されるか」を決めます。
| スコープ | 対象 | 記録先 |
|---|---|---|
| ユーザー(user) | このマシンの全プロジェクトで自分だけ | ~/.claude/settings.json の enabledPlugins |
| プロジェクト(project) | このリポジトリで作業する全員 | .claude/settings.json(コミットする) |
| ローカル(local) | このリポジトリで自分だけ | .claude/settings.local.json |
プロジェクトスコープの記録をコミットすると共同作業者の環境でも有効になりますが、プラグイン本体は各自のマシンにダウンロードされません。各共同作業者はクローンごとに一度 claude plugin install <name>@<marketplace> --scope project を実行します。
同じプラグインが複数のスコープで設定されている場合は、ローカルがプロジェクトより、プロジェクトがユーザーより優先されます。また、作者が defaultEnabled で既定オフにしたプラグインは、インストール後も claude plugin enable <name> か Installed タブで有効にするまでオフのままです。同じコンピュータ上のターミナル・デスクトップアプリのローカルセッション・VS Code 拡張は同じ設定ファイルを読むため、どれかでユーザースコープに入れたプラグインは残り2つでも使えます。一方、クラウドセッション(claude.ai/code を含む)は手元で入れたプラグインもリポジトリの .claude/settings.json で有効にしたプラグインも読み込みません。
マーケットプレイスを追加する
公式マーケットプレイス以外のプラグイン(同僚が公開したものやコミュニティマーケットプレイスのものなど)を入れるには、先にそのマーケットプレイスを一度だけ追加します。セッション内では /plugin marketplace add にソースを続けます(シェルでは claude plugin marketplace add が同じソースを受け付けます。/plugin market という短縮形も使えます)。
| ソース | 指定方法 | 例 |
|---|---|---|
| GitHub リポジトリ | owner/repo。#ref でブランチやタグを固定 | /plugin marketplace add your-org/plugins#v1.2.0 |
| 任意ホストの git リポジトリ | 完全なクローン URL | /plugin marketplace add https://gitlab.example.com/your-group/your-marketplace.git#v1.0.0 |
| ローカルのディレクトリ / ファイル | .claude-plugin/marketplace.json を含むディレクトリか JSON へのパス。相対パスは ./ か ../ で始める | /plugin marketplace add ./my-marketplace |
| ホストされた marketplace.json | https:// の URL | /plugin marketplace add https://example.com/marketplace.json |
URL には必ず https:// を付けるか、SSH なら git@host:path 形式にします。gitlab.example.com/... のように接頭辞なしで書くと GitHub の owner/repo 省略形と解釈されて拒否されます。追加できたかは /plugin の Marketplaces タブで確認できます。
まだ追加していないマーケットプレイスから一度に入れたい場合は、プラグイン名だけ(@ なし)を指定して --marketplace でソースを渡します。セッション内(v2.1.275 以降)ではソースを確認してから追加し、シェル(v2.1.292 以降)では確認なしで追加されます。
claude plugin install deploy-helper --marketplace your-org/plugins
認証が必要な非公開リポジトリも同じコマンドで追加できます。Claude Code は手元の git 認証情報でクローンし、入力を求めません。HTTPS では gh auth login などの credential helper が使われ、SSH ではホストが known_hosts にあり、パスフレーズ入力なしで鍵が使える必要があります。GitHub の owner/repo 省略形では SSH 鍵が通るかを確かめてから SSH か HTTPS を選び、CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1 を設定すると常に HTTPS になります。
インストール済みプラグインを管理する
/plugin を開いて Tab で Installed タブに移ると、プラグインごとに有効化・無効化・更新・アンインストールができます(/plugin enable・/plugin disable・/plugin uninstall でもパネルが開きます)。一覧では文字入力で絞り込み、Space で有効 / 無効の切り替え、f でお気に入り、Enter で詳細を開けます。詳細メニューには Disable plugin(または Enable plugin)、Update now、Uninstall があり、設定項目を持つプラグインでは Configure options や Configure も表示されます。組織が管理設定で入れた Managed スコープのプラグインは、ここでは変更できません。
リポジトリの .claude/settings.json で有効化されているプラグインをアンインストールしようとすると、Disable for me(自分の .claude/settings.local.json に false を書く)か Uninstall for everyone(共有の .claude/settings.json から削除)かを選ぶよう求められます。
シェルからも同じ操作ができ、--scope で対象スコープを指定します。省略時、enable / disable はそのプラグインを記載している最も具体的なスコープ、install / uninstall はユーザースコープが対象です。
claude plugin disable formatter@your-org
claude plugin enable formatter@your-org
claude plugin uninstall formatter@your-org --scope project
そのほか、claude plugin details <name> の Always-on 行で毎セッション加わるトークン数を確認でき、Installed タブの Not used recently 見出しには最近使っていない自分で入れたプラグインがまとまります。依存プラグインを宣言したプラグインは、インストール時に依存先も同じスコープで入りますが、アンインストールしても自動で入った依存先は残るため、claude plugin prune で片付けます。
プラグインを更新する
入手元のマーケットプレイスで自動更新がオンなら、プラグインは自動で更新されます。セッション開始後に Claude Code がマーケットプレイスを更新し、ディスク上のプラグインを新しくします。Plugin updated: <name> · Run /reload-plugins to apply と表示されたら、そのセッションで /reload-plugins を実行します。実行しなくても次回起動時には新しい版が読み込まれます。
- 既定でオン:
claude-plugins-officialなど公式のマーケットプレイス名(knowledge-work-pluginsとfirst-party-pluginsを除く)と、claude.ai から追加したマーケットプレイス - 既定でオフ: それ以外のすべて(コミュニティマーケットプレイス、サードパーティ、ローカル開発用など)
自動更新の切り替えは /plugin の Marketplaces タブでマーケットプレイスを選んで行います。すぐに更新したいときは、Installed タブで Update now を選ぶか、シェルで claude plugin update <plugin>@<marketplace> を実行します。全プラグインを一括更新するコマンドはありませんが、Marketplaces タブでマーケットプレイスを選び Update marketplace を実行すると、そのマーケットプレイスから入れたプラグインがまとめて更新されます。シェルで名前を付けずに claude plugin marketplace update を実行した場合は、一覧が更新されるだけでインストール済みプラグインの版は変わりません。
マーケットプレイス自体の管理は次のコマンドで行えます。マーケットプレイスを削除すると、そこから入れたプラグインもすべてアンインストールされ、設定ファイルの enabledPlugins からも消えます。
| 操作 | シェル | セッション内 |
|---|---|---|
| 一覧 | claude plugin marketplace list | /plugin marketplace list |
| 一覧の更新 | claude plugin marketplace update <name> | /plugin marketplace update <name> |
| 削除 | claude plugin marketplace remove <name> | /plugin marketplace remove <name> |
出典: Install and manage plugins / Plugin commands reference(Claude Code 公式ドキュメント)。2026-11-21 時点の内容に基づく非公式翻訳です。