Claude Codeにプラグインを入れると、Git操作を1コマンドで済ませたり、Pythonの型チェックが自動で走ったりするようになる。公式マーケットプレイスは最初から利用できるので、/pluginコマンドですぐにプラグインを探せる。自分の環境でちゃんと動くのか? という不安もあるだろうけれど、手順通りに進めれば大丈夫。
この記事でやること
プラグインを入れるとClaude Codeに新しい機能が追加される。たとえば、コミット用のコマンドが増えたり、コードの型チェックが自動で動いたりする。
公式マーケットプレイスから実際のプラグインを1つ選んで導入する全手順を追っていく。環境確認→マーケットプレイス確認→検索→インストール→動作確認の順で進める。
「自分の環境で動くの?」という疑問については、始める前に確認すべき条件を次セクションでまとめた。
始める前に:環境を確認する
プラグインの操作はClaude Codeの入力欄で行う。PowerShellやコマンドプロンプトではないので注意。
前提として、以下を確認しておく。
- ネットワーク接続があること
- Claude Codeが最新バージョンであること(古いと
/pluginコマンドに対応していない場合がある)
※まだClaude Codeを入れていない場合は、Claude CodeをWindowsにインストールする手順を先に済ませてください。
バージョンはターミナルで次のコマンドを実行すれば確認できる。
claude --version
# 出力例
claude 1.0.33
バージョン番号が表示されればOK。古い場合は、先にClaude Codeの更新を済ませてからこの記事に戻ってほしい。
なお、Claude Codeにはデスクトップ版もあるが、ここではCLI(ターミナル)での手順で進める。
プラグインは何をしてくれるのか
プラグインとは、Claude Codeに機能を追加する仕組みだ。入れると、新しいskill(定型作業の手順書)やコマンドが使えるようになる。
最初から入っている機能とプラグインで追加する機能の違いは、スマートフォンのアプリに例えると分かりやすい。買ったばかりのスマホにも標準アプリは入っているが、アプリストアから追加インストールすればカメラアプリもゲームも使えるようになる。Claude Codeのプラグインも同じようなものだ。
まずは「プラグイン=機能の追加セット」と理解しておけば十分。追加される要素の詳しい分類は、後の判断基準表で整理する。
公式マーケットプレイスを確認する
Claude Codeを起動すると、公式のAnthropicマーケットプレイス(claude-plugins-official)が自動的に利用できる状態になっている。
/plugin コマンドでDiscoverタブを開けば、すぐにプラグインを探せる。特に準備は不要だ。
※Claude Codeの画面操作に不安がある場合は、画面の見方を先に押さえておくとスムーズです。
もしDiscoverタブが空っぽになる場合は、マーケットプレイスの更新が必要なことがある。そのときは次のコマンドを実行する。
/plugin marketplace update claude-plugins-official
更新後に再度Discoverタブを開けば、プラグイン一覧が表示されるはずだ。
外部マーケットプレイスを追加したい場合は /plugin marketplace add <パス> で可能だが、まずは公式マーケットプレイスだけで十分。
マーケットプレイスでプラグインを探す
マーケットプレイスが登録できたら、プラグインを探す。Claude Codeの入力欄で /plugin と入力し、Discoverタブを開く。
Discoverタブには、公開されているプラグインがカテゴリ別に表示される。代表的な定番プラグインをいくつか挙げておく。
- commit-commands —
/commit-commands:commitなど、Gitコミット用のコマンドを追加。Git操作を進めやすくする定番 - pyright-lsp — Pythonの型チェックを自動実行するLSPを追加
- typescript-lsp — TypeScriptの補完を強化
- code-review — PRの自動レビューを実行
- feature-dev — 機能開発のワークフローを追加
- security-guidance — セキュリティに関するベストプラクティスを提供
選ぶ時のポイントは、自分の用途に合うかどうかと、更新が続いているか。まずは公式マーケットプレイスにある人気プラグインから試すのが安全だ。
次は、この中から commit-commands を実際に入れてみる。
試しに1つ入れてみる:commit-commands
なぜ commit-commands をおすすめするか。Gitのコミット操作を1コマンドで済ませられるからだ。初心者にも「入れた効果」がすぐ分かる。
Step 1: /plugin から commit-commands を見つける
Discoverタブで「commit-commands」を探して選ぶ。
Step 2: インストールする
次のコマンドを実行。
/plugin install commit-commands@claude-plugins-official
Step 3: 完了メッセージを確認する
インストールが成功すると、次のようなメッセージが表示される。
# 成功時の出力例
✓ Plugin 'commit-commands' installed successfully
Step 4: プラグインを再読み込みする
/reload-plugins
Step 5: 動作確認する
適当なGitリポジトリで /commit-commands:commit と入力してみる。コミット用の処理が始まり、変更内容の確認やコミットメッセージ生成まで進めば、プラグインは動作している。
※万が一動かない場合は、エラー修正のトラブルシューティングを参考にしてください。
これでプラグインの追加から動作確認まで一通り完了した。
入れたのに動かない——よくある罠と直し方
プラグインを入れたのにコマンドが使えない——この現象、実は結構よく起こる。原因別に対処法をまとめた。
/plugin コマンド自体が認識されない場合
Unknown command: /plugin
Claude Codeのバージョンが古い可能性が高い。claude --version で確認し、必要ならアップデートする。
Discoverタブが空の場合
まず /plugin marketplace update claude-plugins-official を実行する。それでも表示されない場合は、Claude Codeの再起動、ネットワーク接続、バージョンを確認する。
Language server binary not found と表示される場合
言語サーバーのバイナリが不足している。たとえば pyright-lsp を使うには、事前に pyright-langserver のインストールが必要だ。
npm install -g pyright-langserver
インストール後にプラグインを再読み込みすれば直る。
インストールが途中で止まる場合
ネットワーク接続や権限を確認する。プロキシ環境下では設定が必要なことがある。
プラグインは入ったが期待通り動かない場合
他のプラグインとの競合や、対応バージョンのずれが疑われる。公式・人気のプラグインから試すと、この手の問題に遭いにくい。
用途別プラグイン選びの判断基準
「自分の用途にどのプラグインを選ぶか」を判断しやすくするため、やりたいことと追加される要素の対応を整理した。
| やりたいこと | 代表プラグイン | 追加される要素 |
|---|---|---|
| Git操作を楽にしたい | commit-commands | skill(`/commit-commands:commit` コマンド) |
| Pythonの型チェック | pyright-lsp | MCPサーバー+LSP |
| TypeScriptの補完 | typescript-lsp | MCPサーバー+LSP |
| PRの自動レビュー | code-review | agents(複数エージェントで並列審査) |
| セキュリティ確認 | security-guidance | セキュリティのベストプラクティス |
| 機能開発ワークフロー | feature-dev | skill+hooks(特定タイミングで自動実行) |
各要素のざっくり説明:
- skill — 定型作業の手順書。コマンドとして呼び出す
- agents — 役割を分けて担当させる設定
- hooks — 特定タイミングで自動実行する仕組み
- MCPサーバー — 外部ツールとの連携窓口
※スキルを自作したい場合は、プロジェクト設定でCLAUDE.mdの書き方を押さえておくと便利です。
初心者はまず skill を追加するプラグイン(commit-commands 等)が分かりやすい。コマンドが1つ増えるだけなので、効果を実感しやすい。
最後に:確認して次に進む
ここまでで、commit-commands を入れ、/commit-commands:commit コマンドが使えるようになった。マーケットプレイス確認→検索→インストール→再読み込み→確認の全流れを一通り踏んでいる。
次にやることの導線を3つ挙げておく。
- 次に読む — pyright-lsp や code-review など、他の定番プラグインも試してみる。導入手順は同じ流れで進められる
- 次に試す — 上の判断基準表から自分の用途に合うプラグインを選んで追加する
- 高度な設定 — プラグインの自作に挑戦する(関連記事「Claude Codeでプラグインを自作する方法」を参照)
- 他の自動化 — フォルダ整理など、他の自動化例もチェックしてみる
まとめ
Claude Codeのプラグインは、公式マーケットプレイスから数ステップで追加できる。まずは commit-commands を1つ試して、自分に合う機能拡張を体感する——これが一番手軽な始め方だ。
