Claude Codeプラグインの入れ方を初心者向けに詳しく解説！

「Claude Codeのプラグインって、どうやって入れるの？」
「入れてみたけど動かない、何が悪いの？」

プラグインは、Claude Codeの拡張機能をまとめて配れるようにした仕組みです。
コマンド2つで入るのですが、最初は「マーケットプレイスって何？」でつまずく人がとても多いんですよね。

しかも入れれば入れるほど便利になるわけではなく、増やしすぎると逆に動きが鈍くなります。
この記事では入れ方の手順に加えて、入れすぎて壊れたときにどこから確かめるかまで書いていきます。

Claude Codeのプラグインとは何か｜拡張を配れる形にする仕組み

手順に入る前に、プラグインが何をまとめたものなのかを押さえておきましょう。

ここがわかると、あとで「どれを入れるか」の判断が一気に楽になります。

プラグインは拡張機能をひとつの箱に束ねたもの

Claude Codeは、もともといろいろな方法で拡張できます。
スラッシュコマンドを足したり、専用のエージェントを作ったり、フックで自動処理を挟んだり。

ただ、これを人に渡そうとすると「このファイルをここに置いて、こっちの設定も足して」と説明が長くなるんですよね。

その面倒を解決するのがプラグインでした。関連する拡張をひとつのフォルダにまとめて、コマンド1つで配れる形にしたものです。

受け取る側は中身を1つずつ配置しなくてよくなり、渡す側もバージョンで管理できるようになります。

逆にいえば、自分ひとりの一時的な工夫なら、わざわざプラグインにする必要はありません。

手元で試して固まったものだけを箱に詰める。この順番のほうが、結局は早く進みました。

もうひとつ、スキルの呼び出し名に接頭辞が付くという特徴もあります。
プラグイン名が頭に付くので、別のプラグインと同じ名前のスキルがあってもぶつかりません。

プラグインに入れられる5種類の要素

1つの箱に何を詰められるのか。ここを知っておくと、公式カタログの説明が読めるようになります。

主に入れられるのは次の5種類でした。

この5つが1つの箱に入るというのが、プラグインのいちばん大事な点です。

たとえばGitHub連携のプラグインなら、接続の設定（MCP）と、それを使う手順（スキル）がセットで入ってきます。
片方だけ入れて「動かない」となる事故が起きません。

ほかにも、実行ファイルを置く bin/ や、ログを見張る monitors/ を含められました。

自作でつまずく原因の大半が、この置き場所の勘違いでした。

公式のプラグインを1つ入れて、中身のフォルダ構成を眺めてみるのがいちばん早い理解の仕方です。
それぞれの仕組みそのものは、Claude Code Skillsの使い方やClaude Code hooksの使い方で個別に扱っています。

フォルダに直接置く設定との違い

ここで混乱しやすいのが、.claude/ フォルダに直接置く方法との違いです。

どちらも同じことができますが、共有できるかどうかが決定的に違います。

おすすめの進め方は、.claude/ で試してから、固まったらプラグインに移すという順番でした。

最初からプラグインにしようとすると、マニフェストの書き方で手が止まります。
まず動くものを作って、共有したくなった時点で箱に詰め直すほうが早いです。

2つ目は気づきにくく、私も「入れたのに変わらない」と首をかしげたことがあります。
プラグイン側を直しても、手元の定義が残っているかぎりそちらが勝ち続けるので気づけないんですよね。

Claude Codeのプラグインの入れ方を5つの手順で解説

ここからが本題です。初めての方でもそのまま追える形で並べます。

ポイントは「マーケットプレイスを追加する」と「プラグインを入れる」が別の操作だという点でした。

【ステップ1】/pluginでプラグインマネージャーを開く

まずはClaude Codeを起動して、コマンドを1つ打ちます。

> /plugin

すると、タブが4つ並んだ画面が開きます。Tabキーで切り替えられるので、まずは一周してみてください。

ここで /plugin が「unknown command」と言われる場合は、Claude Codeのバージョンが古い可能性があります。

claude --version で確認して、古ければ更新してから進めてください。
更新したあとはターミナルを開き直さないと反映されないので、そこも忘れずに。

なお、この画面はプラグインを入れていない状態でも開けます。
先にDiscoverタブでどんなものが並んでいるかを眺めておくと、あとの選び方がぐっと楽になりました。

【ステップ2】マーケットプレイスを追加する

次にカタログを登録します。ここが最初のつまずきポイントでした。

マーケットプレイスの追加は「お店を登録する」だけで、この時点ではまだ何もインストールされていません。
Anthropic公式のカタログは、Claude Codeを起動すると自動で使える状態になっています。

# 公式カタログが見当たらないときは、明示的に追加する
> /plugin marketplace add anthropics/claude-plugins-official



# コミュニティのカタログを追加する
> /plugin marketplace add anthropics/claude-plugins-community

GitHub以外のリポジトリからも追加できます。

GitLabなどを指定するときは、https:// を省略しないでください。
省くとGitHubの owner/repo と誤解されて弾かれます。

なお、コマンドは /plugin market add と短く書いても通ります。

【ステップ3】プラグインを選んでインストールする

カタログが登録できたら、いよいよインストールです。
画面から選ぶ方法と、コマンドで直接指定する方法があります。

# 公式カタログからGitHub連携を入れる
> /plugin install github@claude-plugins-official



# コミュニティのカタログから入れる場合
> /plugin install プラグイン名@claude-community

@ のうしろは、そのプラグインがどのカタログのものかを指す名前です。

出典：Claude 公式サイト「Plugins」

画面から選ぶ場合は、Discoverタブでプラグインを選ぶと詳細が開きました。

ここで見てほしいのがContext costという表示で、そのプラグインが毎回のやり取りでどれだけ場所を取るかがわかります。

Will installの欄は必ず開いてください。ここに知らないフックやMCPサーバーが並んでいたら、いったん保留するくらいでちょうどよいです。

作業中のディレクトリに関係が深いものは、一覧の上に固定されて出ることがあります。
プロジェクトの言語や構成から推測して並べてくれるので、迷ったらそこから見るのが早いです。

【ステップ4】どの範囲で使うかを決める

インストールを選ぶと、範囲（スコープ）を聞かれます。ここは3つから選びます。

迷ったらUser（自分の全プロジェクト）を選んでおけば間違いありません。

チームで共有したいならProject、試すだけならLocalという使い分けです。

Projectを選ぶと .claude/settings.json に記録されるので、リポジトリを共有している人にも入ります。
勝手に増やすと迷惑がられるので、チームで合意してから使うほうが安全でした。

ちなみに、対話画面を開かずにシェルから入れることもできます。

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

【ステップ5】再読み込みして動作を確かめる

インストールが終わっても、その場では使えないことがあります。
最後に必ず再読み込みしてください。

> /reload-plugins

実行すると、読み込まれたスキルやエージェントの数が表示されます。ここで数が0のままなら、インストールがうまくいっていません。

動作確認は、入れたプラグインのスキルを呼んでみるのが早いです。

# プラグイン名を頭に付けて呼び出す
> /commit-commands:commit

呼び出し名がわからなくなったら、/help で一覧を見るのが確実です。
プラグインごとに区切って表示されるので、どれが何を持ち込んだのかも一目でわかります。

なお、再読み込みには次のやり取りぶんのコストがかかります。
作業の途中でむやみに叩かず、インストールした直後にまとめて実行するのがおすすめでした。

Claude Codeのプラグインをコマンドで管理する方法

入れたあとの管理も、コマンドで一通りできます。

画面を開かずに済むので、慣れてくるとこちらのほうが速いです。

一覧の確認と、有効・無効の切り替え

まず、いま何が入っているのかを確かめます。

# 入っているプラグインを一覧表示する
> /plugin list



# 有効なものだけ・無効なものだけを見る
> /plugin list --enabled
> /plugin list --disabled

消さずに一時的に止めたいときは、無効化を使います。

# 止める
> /plugin disable プラグイン名@カタログ名



# 戻す
> /plugin enable プラグイン名@カタログ名

調子が悪いときは、まず疑わしいものを無効化して様子を見るのが基本の動きでした。

無効化してもファイルは残るので、必要になったらすぐ戻せます。
丸ごと消すと設定し直す手間が地味に効いてくるんですよね。
なお、カタログ側の名前とプラグイン自身の名前が違うことがありますが、どちらで打っても受け付けてくれます。

画面から操作する場合は、Installedタブで f を押すとお気に入りに入れられます。
よく使うものを上に集めておくと、一覧が長くなっても迷いません。

この一覧は、問題のあるものが上に来るように並んでいます。
読み込みに失敗したものや依存が解決していないものが先頭、無効にしたものは下にたたまれる形なので、開いた瞬間に上のほうを見れば異常の有無がわかります。

アンインストールとカタログの削除

もう使わないと決めたら、完全に消してしまいます。

# プラグインを削除する
> /plugin uninstall プラグイン名@カタログ名



# カタログそのものを削除する
> /plugin marketplace remove カタログ名

ここで気をつけたいのが2つ目のコマンドです。

「1つだけ消したいのにカタログごと消してしまった」というのは、私も一度やりました。

プラグイン単体を消したいときは、必ず uninstall のほうを使ってください。

2つ目については、自分だけ止めたいのか全員から外したいのかを選べます。
チームのリポジトリでは、勝手に共有設定を書き換えないよう注意したいところです。

自動更新をどうするか決める

プラグインは、起動時に自動で新しいバージョンへ更新されることがあります。

公式のカタログは自動更新が最初から有効で、それ以外は無効というのが既定の動きです。

切り替えたい場合は /plugin のMarketplacesタブから設定できます。

カタログの中身だけを最新にしたいときは、更新コマンドを直接打つ方法もあります。

> /plugin marketplace update カタログ名

更新の確認はセッション開始から最大10分ほど遅れて走ります。
そのため、いま動いているセッションは起動時のバージョンのまま進む点も覚えておいてください。

自動更新をまるごと止めたい場合は、環境変数で無効にする方法もあります。
逆にClaude Code本体の更新だけを手動にして、プラグインは自動のままにするという組み合わせも選べました。

Claude Codeのプラグインで最初に入れておきたいもの

公式カタログには相当な数が並んでいて、最初はどれを選べばいいか迷います。

私が実際に使っていて、外していないものを種類ごとに挙げてみます。

コードインテリジェンス系は効果がわかりやすい

いちばん体感が変わったのが、この種類でした。

言語ごとのLSPプラグインを入れると、Claudeがファイルを編集するたびに型エラーや未解決のインポートを自分で検知します。

注意点は、言語サーバー本体を自分のマシンに入れておく必要があることです。

入れ忘れていると、Errorsタブに「Executable not found in $PATH」と出ます。
大きなプロジェクトではメモリを食うので、重いと感じたら無効化して様子を見てください。

コンパイラを走らせずに間違いへ気づけるので、往復の回数がはっきり減りました。

プロジェクトを開いたときに、対応するプラグインの導入をすすめられることもあります。
すでに言語サーバーを入れている環境なら、その案内に乗ってしまうのがいちばん手っ取り早いです。

外部サービス連携系は設定の手間が消える

GitHubやSlackとつなぎたいとき、以前はMCPサーバーの設定を自分で書く必要がありました。

いまは連携プラグインを入れるだけで、設定済みのMCPサーバーがそのまま付いてきます。

手で設定していた頃と比べると、導入のハードルが本当に下がりました。
ただし、連携系はコンテキストの消費が大きめです。
常時つないでおく必要がないものは、使うときだけ有効にするほうが快適でした。

接続には認証が必要なものも多く、初回だけブラウザでの許可を求められます。
そこさえ通してしまえば、あとは普段の会話のなかから自然に呼び出せるようになります。

MCPの仕組みそのものを知りたい方は、Claude Code MCP設定方法を先に読んでおくと理解が早いです。

開発ワークフロー系は毎日の手数を減らす

最後は、日常の作業そのものを短くする種類です。

地味ですが、毎日使うものほど効果が積み上がります。

私が最初に入れたのは commit-commands でした。

コミットメッセージを毎回考える手間が消えるだけで、作業のリズムが変わります。
エージェント系のプラグインを検討する前に、Claude Codeサブエージェントの活用法も見ておくと選びやすくなります。

応答のしかたを変える出力スタイル系もあるので、学習目的なら一度試してみてください。

Claude Codeのプラグインを入れすぎて壊れたときの切り分け

ここからが、この記事でいちばん書きたかった部分です。

プラグインは増やすほど便利になる、とは限りませんでした。

まず/pluginのErrorsタブを開く

調子が悪いと感じたら、いきなり設定をいじらないでください。

最初にやるのは、/plugin を開いてErrorsタブを見ることです。

> /plugin
（Tabキーで Errors タブへ移動）

ここに読み込みの失敗が並んでいれば、原因はほぼ特定できます。

3つ目は自作プラグインでよくやる失敗です。

commands/ や skills/ を .claude-plugin/ の中に入れてしまうと読み込まれません。
この中に入れてよいのは plugin.json だけで、あとはプラグインの直下に置きます。

もう1つ多いのが、プラグインの外にあるファイルを参照している場合です。
インストール時に中身がキャッシュへコピーされるため、フォルダの外を指すパスはそのまま切れてしまいます。

次にコンテキストの消費量を疑う

エラーが出ていないのに反応が鈍い。この場合はたいてい入れすぎです。

プラグインは有効にしている間、毎回のやり取りでコンテキストを消費し続けます。

いま何が場所を取っているかは、コンテキストの内訳を見れば確かめられました。

> /context

そのうえで、使っていないものを外していきます。

この棚卸しを月に一度やるだけで、体感がかなり戻ります。
私は月初にInstalledタブを開くのを習慣にしていて、毎回2つか3つは外す候補が見つかりました。
入れるときの勢いと、使い続ける頻度はまったく別物なんですよね。

入れる前にDiscoverタブのContext costを見ておくと、そもそも増えすぎません。
「便利そうだから」で入れたものほど、半年後には使っていないんですよね。

ちなみに、テーマや出力スタイルを提供するものは未使用として扱われません。
呼び出す形の機能ではないため、リストに出てこなくても正常な動きです。

最後に名前の衝突とキャッシュを疑う

ここまでで直らない場合、残る犯人は2つです。

1つ目が名前の衝突で、プラグインのエージェントと同じ名前の定義が .claude/agents/ にあると、そちらが優先されます。

プラグインを入れたのに前と同じ動きをするなら、これを疑ってください。

キャッシュの削除は効きますが、入れ直しが必要になるので最後に回してください。

順番を守って確かめれば、たいていは2番目までで原因にたどり着きます。
逆にいうと、いきなりキャッシュを消しても何が悪かったのかがわからないままになります。

切り分けのコツは、一度に1つだけ変えることです。
疑わしいプラグインをまとめて無効化すると直った理由がわからず、次に同じことが起きたときにまた最初から探すはめになります。

Claude Codeのプラグインを自作してチームに配る

最後に、自分で作って配るところまで触れておきます。

思っているよりずっと簡単で、ファイル2つあれば形になりました。

最小構成のプラグインを作って手元で試す

必要なのは、マニフェストとスキルの2ファイルだけです。
まずフォルダを作って、その中に .claude-plugin/plugin.json を置きます。

{
  "name": "my-first-plugin",
  "description": "挨拶を返すだけの練習用プラグイン",
  "version": "1.0.0"
}

次に skills/hello/SKILL.md を作って、やってほしいことを日本語で書いていきましょう。
フォルダ名がそのままスキル名になるので、hello の部分が呼び出しに使われます。

---
description: 相手の名前を受け取って挨拶する
---



"$ARGUMENTS" さんに向けて、あたたかい挨拶を返してください。

できたら、インストールせずにそのまま読み込んで試せました。
起動したら /my-first-plugin:hello 山田 のように呼んでみてください。
登録する前でも動作を確認できるので、ここで一度動かしておくと安心です。

claude --plugin-dir ./my-first-plugin

この --plugin-dir を使ったやり方が、開発中はいちばん速い試し方でした。

毎回フラグを渡すのが面倒なら、スキルのフォルダに置いてしまう方法もあります。
claude plugin init を実行すると雛形が作られ、次のセッションから自動で読み込まれるようになりました。

カタログの形にしてリポジトリに置く

手元で動いたら、次はチームに配る形にします。
やることは、.claude-plugin/marketplace.json を置いたリポジトリを用意するだけです。

相手はそのリポジトリを追加して、プラグインを入れるという流れになります。

> /plugin marketplace add あなたの組織名/リポジトリ名
> /plugin install my-first-plugin@あなたのカタログ名

3つ目を忘れると「直したのに反映されない」が起きます。

逆に version を書かずにGitで配ると、コミットごとに新しい版として扱われます。
細かく配りたいのか、まとまった単位で配りたいのかで決めてください。

チームで使う場合、リポジトリを信頼したタイミングで導入の案内が出ます。
設定に書いてあるだけでは自動的に入らないので、参加者が自分でインストールするまでは読み込まれない点に注意してください。

信頼できるものだけを入れる運用にする

便利な話ばかり書いてきましたが、最後に大事なことを1つ。

プラグインは自分の権限で任意のコードを動かせる、かなり強い仕組みです。

公式カタログとコミュニティカタログは審査や検証を通っていますが、それ以外は自己責任になります。

組織で使う場合は、管理者が追加できるカタログを制限する設定もあります。
会社の環境なら、まずそのルールを確認してから手を動かすほうが安全でした。

個人で使うぶんには、公式カタログから始めるのがいちばん安全でした。
慣れてきたらコミュニティのカタログに広げる、という順番で十分だと思います。

コミュニティのカタログは、自動検証とセキュリティの確認を通ったものが並んでいます。
とはいえ中身を作っているのは第三者なので、Will installの一覧に目を通す習慣だけは持っておいてください。

Claude Codeのプラグインの入れ方に関するよくある質問

Q：マーケットプレイスを追加したのにプラグインが表示されません

A：カタログの情報が古い可能性があります。/plugin marketplace update カタログ名 で更新してから、もう一度探してみてください。
それでも出ない場合は、リポジトリに .claude-plugin/marketplace.json が正しく置かれているかを確認します。

URLで指定したカタログは、相対パスの扱いでつまずくことがあります。
「path not found」と出るようなら、GitHubのリポジトリ指定に切り替えると解決することが多いです。

Q：インストールしたのにスキルが呼び出せません

A：まず /reload-plugins を実行してください。インストール直後は読み込まれていないことがあります。
それでも出ない場合は、呼び出し名が プラグイン名:スキル名 の形になっているかを /help で確かめます。

それでも見当たらないときは、キャッシュが壊れているのかもしれません。
rm -rf ~/.claude/plugins/cache で消してから、Claude Codeを起動し直して入れ直してみてください。

Q：プラグインを入れすぎると何が起きますか？

A：有効にしている数だけ、毎回のやり取りでコンテキストを消費します。
反応が鈍いと感じたら、Installedタブの「Not used recently」から使っていないものを無効化してみてください。

とくにMCPサーバーを含むプラグインは重くなりがちです。
使う日だけ有効にする運用に変えるだけでも、体感はずいぶん変わりました。

Q：/pluginコマンドが認識されません

A：Claude Codeのバージョンが古い可能性が高いです。claude --version で確認して、必要なら更新してからターミナルを再起動してください。

なお、この機能はProプラン以上の有料プランで利用します。無料プランではClaude Code自体が使えません。

まとめ

Claude Codeのプラグインの入れ方は、カタログを追加してからインストールするという2段階でした。

コマンドとしては2つ覚えるだけで、あとは /reload-plugins で反映すれば動きます。

むしろ難しいのは、入れたあとに増やしすぎないほうでした。

拡張は足すほど強くなるように見えますが、実際には選ぶほうが効きます。
入れた数より、使い切れている数のほうがずっと大事でした。

あなたが毎日いちばん多く繰り返している操作は、どれでしょうか。
そこを1つだけ短くするプラグインから入れてみてください。

Claude Codeを使いこなす力は、そのまま「AIを業務に組み込める人」の市場価値につながります。独学で埋めきれない部分を講座で補いたい方は、社会人におすすめの生成AI研修スクール｜スクール6校を比較が判断材料になります。