Claude Code のプラグインをインストール・管理する手順

Claude Code エンジニアリング 6分で読めます

プラグインをインストールすると、そのプラグインに含まれるスキル・エージェント・フック・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 で詳細を開けます。

詳細画面には説明文のほか、次の情報が表示されることがあります。

プラグインはフックや MCP サーバーを実行できるため、インストール前に詳細画面を読むよう公式は勧めています。スコープを選ぶとインストールが行われ、要約の最後の一文で状態がわかります。

動作確認は、/ を打って /<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.jsonhttps:// の 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 を実行します。実行しなくても次回起動時には新しい版が読み込まれます。

自動更新の切り替えは /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 時点の内容に基づく非公式翻訳です。