プラグインを作成する
スキル、エージェント、フック、MCP サーバーで Claude Code を拡張するカスタムプラグインを作成します。
プラグインを使用すると、Claude Code をカスタム機能で拡張でき、プロジェクトとチーム全体で共有できます。このガイドでは、スキル、エージェント、フック、MCP サーバーを使用して独自のプラグインを作成する方法について説明します。
既存のプラグインをインストールしたいですか？プラグインを検出してインストールするを参照してください。完全な技術仕様については、プラグインリファレンスを参照してください。
プラグインとスタンドアロン設定を使い分ける
Claude Code では、カスタムスキル、エージェント、フックを追加する 2 つの方法をサポートしています。
| アプローチ | スキル名 | 最適な用途 |
|---|---|---|
スタンドアロン（.claude/ ディレクトリ） |
/hello |
個人的なワークフロー、プロジェクト固有のカスタマイズ、クイック実験 |
プラグイン（.claude-plugin/plugin.json を含むディレクトリ） |
/plugin-name:hello |
チームメンバーとの共有、コミュニティへの配布、バージョン管理されたリリース、プロジェクト全体で再利用可能 |
スタンドアロン設定を使用する場合：
- 単一のプロジェクト用に Claude Code をカスタマイズしている
- 設定が個人的で共有する必要がない
- スキルやフックをパッケージ化する前に実験している
/helloや/deployのような短いスキル名が必要
プラグインを使用する場合：
- 機能をチームまたはコミュニティと共有したい
- 複数のプロジェクト全体で同じスキル/エージェントが必要
- 拡張機能のバージョン管理と簡単な更新が必要
- マーケットプレイスを通じて配布している
/my-plugin:helloのような名前空間付きスキルで問題ない（名前空間はプラグイン間の競合を防ぎます）
クイックスタート
このクイックスタートでは、カスタムスキルを使用してプラグインを作成する手順を説明します。マニフェスト（プラグインを定義する設定ファイル）を作成し、スキルを追加して、--plugin-dir フラグを使用してローカルでテストします。
前提条件
- Claude Code インストール済みで認証済み
最初のプラグインを作成する
プラグインディレクトリを作成する
すべてのプラグインは、マニフェストとスキル、エージェント、またはフックを含む独自のディレクトリに存在します。今すぐ作成してください。
mkdir my-first-plugin
プラグインマニフェストを作成する
.claude-plugin/plugin.json のマニフェストファイルは、プラグインの ID（名前、説明、バージョン）を定義します。Claude Code はこのメタデータを使用して、プラグインマネージャーにプラグインを表示します。
プラグインフォルダ内に .claude-plugin ディレクトリを作成します。
mkdir my-first-plugin/.claude-plugin
次に、このコンテンツで my-first-plugin/.claude-plugin/plugin.json を作成します。
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
| フィールド | 目的 |
|---|---|
name |
一意の識別子とスキル名前空間。スキルにはこれが接頭辞として付きます（例：/my-first-plugin:hello）。 |
description |
プラグインマネージャーでプラグインを参照またはインストールするときに表示されます。 |
version |
オプション。設定されている場合、ユーザーはこのフィールドをバンプしたときにのみ更新を受け取ります。省略され、プラグインが git 経由で配布される場合、コミット SHA が使用され、すべてのコミットが新しいバージョンとしてカウントされます。バージョン管理を参照してください。 |
author |
オプション。属性に役立ちます。 |
homepage、repository、license などの追加フィールドについては、完全なマニフェストスキーマを参照してください。
スキルを追加する
スキルは skills/ ディレクトリに存在します。各スキルは SKILL.md ファイルを含むフォルダです。フォルダ名がスキル名になり、プラグインの名前空間が接頭辞として付きます（my-first-plugin という名前のプラグイン内の hello/ は /my-first-plugin:hello を作成します）。
プラグインフォルダ内にスキルディレクトリを作成します。
mkdir -p my-first-plugin/skills/hello
次に、このコンテンツで my-first-plugin/skills/hello/SKILL.md を作成します。
---
description: Greet the user with a friendly message
disable-model-invocation: true
---
Greet the user warmly and ask how you can help them today.
プラグインをテストする
--plugin-dir フラグを使用して Claude Code を実行し、プラグインを読み込みます。
claude --plugin-dir ./my-first-plugin
Claude Code が起動したら、新しいスキルを試してください。
/my-first-plugin:hello
Claude がグリーティングで応答します。/help を実行して、プラグイン名前空間の下にリストされたスキルを確認してください。
スキル引数を追加する
$ARGUMENTS プレースホルダーを使用してユーザー入力をキャプチャすることで、スキルを動的にします。
SKILL.md ファイルを更新します。
---
description: Greet the user with a personalized message
---
# Hello Skill
Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.
/reload-plugins を実行して変更を反映させ、スキルを名前で試してください。
/my-first-plugin:hello Alex
Claude があなたを名前で挨拶します。スキルに引数を渡す方法の詳細については、スキルを参照してください。
これらの主要なコンポーネントを使用してプラグインを正常に作成およびテストしました。
- プラグインマニフェスト（
.claude-plugin/plugin.json）：プラグインのメタデータを説明します - スキルディレクトリ（
skills/）：カスタムスキルを含みます - スキル引数（
$ARGUMENTS）：動的な動作のためにユーザー入力をキャプチャします
プラグイン構造の概要
スキルを使用してプラグインを作成しましたが、プラグインにはさらに多くの機能を含めることができます。カスタムエージェント、フック、MCP サーバー、LSP サーバー、バックグラウンドモニターです。
| ディレクトリ | 場所 | 目的 |
|---|---|---|
.claude-plugin/ |
プラグインルート | plugin.json マニフェストを含みます（コンポーネントがデフォルトの場所を使用する場合はオプション） |
skills/ |
プラグインルート | <name>/SKILL.md ディレクトリとしてのスキル |
commands/ |
プラグインルート | フラットな Markdown ファイルとしてのスキル。新しいプラグインには skills/ を使用してください |
agents/ |
プラグインルート | カスタムエージェント定義 |
hooks/ |
プラグインルート | hooks.json のイベントハンドラー |
.mcp.json |
プラグインルート | MCP サーバー設定 |
.lsp.json |
プラグインルート | コード インテリジェンス用の LSP サーバー設定 |
monitors/ |
プラグインルート | monitors.json のバックグラウンドモニター設定 |
bin/ |
プラグインルート | プラグインが有効になっている間に Bash ツールの PATH に追加される実行可能ファイル |
settings.json |
プラグインルート | プラグインが有効になったときに適用されるデフォルト設定 |
より複雑なプラグインを開発する
基本的なプラグインに慣れたら、より高度な拡張機能を作成できます。
プラグインにスキルを追加する
プラグインには、Claude の機能を拡張するエージェントスキルを含めることができます。スキルはモデル呼び出し型です。Claude はタスクコンテキストに基づいて自動的にそれらを使用します。
プラグインルートに skills/ ディレクトリを追加し、SKILL.md ファイルを含むスキルフォルダを追加します。
my-plugin/
├── .claude-plugin/
│ └── plugin.json
└── skills/
└── code-review/
└── SKILL.md
各 SKILL.md には YAML フロントマターと指示が含まれます。Claude がスキルをいつ使用するかを知るように description を含めてください。
---
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---
When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage
プラグインをインストールした後、/reload-plugins を実行してスキルを読み込みます。段階的な開示とツール制限を含む完全なスキル作成ガイダンスについては、エージェントスキルを参照してください。
プラグインに LSP サーバーを追加する
LSP（Language Server Protocol）プラグインは Claude にリアルタイムコード インテリジェンスを提供します。公式 LSP プラグインがない言語をサポートする必要がある場合は、プラグインに .lsp.json ファイルを追加することで、独自のプラグインを作成できます。
{
"go": {
"command": "gopls",
"args": ["serve"],
"extensionToLanguage": {
".go": "go"
}
}
}
プラグインをインストールするユーザーは、言語サーバーバイナリをマシンにインストールしておく必要があります。
完全な LSP 設定オプションについては、LSP サーバーを参照してください。
プラグインにバックグラウンドモニターを追加する
バックグラウンドモニターを使用すると、プラグインはログ、ファイル、または外部ステータスをバックグラウンドで監視し、イベントが到着したときに Claude に通知できます。Claude Code はプラグインがアクティブな場合、各モニターを自動的に開始するため、Claude にモニターの開始を指示する必要はありません。
プラグインルートに monitors/monitors.json ファイルを追加し、モニターエントリの配列を含めます。
[
{
"name": "error-log",
"command": "tail -F ./logs/error.log",
"description": "Application error log"
}
]
command からの各 stdout 行は、セッション中に Claude への通知として配信されます。when トリガーと変数置換を含む完全なスキーマについては、モニターを参照してください。
プラグインでデフォルト設定を配布する
プラグインは、プラグインルートに settings.json ファイルを含めて、プラグインが有効になったときにデフォルト設定を適用できます。現在、agent と subagentStatusLine キーのみがサポートされています。
agent を設定すると、プラグインのカスタムエージェントの 1 つがメインスレッドとしてアクティブになり、そのシステムプロンプト、ツール制限、モデルが適用されます。これにより、プラグインは有効になったときに Claude Code の動作方法をデフォルトで変更できます。
{
"agent": "security-reviewer"
}
この例は、プラグインの agents/ ディレクトリで定義された security-reviewer エージェントをアクティブにします。settings.json の設定は、plugin.json で宣言された settings よりも優先されます。不明なキーは無視されます。
複雑なプラグインを整理する
多くのコンポーネントを持つプラグインの場合、ディレクトリ構造を機能別に整理してください。完全なディレクトリレイアウトと整理パターンについては、プラグインディレクトリ構造を参照してください。
プラグインをローカルでテストする
開発中にプラグインをテストするには、--plugin-dir フラグを使用してください。これにより、インストールを必要とせずにプラグインが直接読み込まれます。
claude --plugin-dir ./my-plugin
--plugin-dir プラグインがインストール済みのマーケットプレイスプラグインと同じ名前を持つ場合、そのセッション中はローカルコピーが優先されます。これにより、最初にアンインストールしなくても、既にインストール済みのプラグインへの変更をテストできます。マネージド設定によって強制的に有効にされたマーケットプレイスプラグインは唯一の例外であり、オーバーライドできません。
プラグインに変更を加えると、/reload-plugins を実行して再起動せずに更新を反映させます。これにより、プラグイン、スキル、エージェント、フック、プラグイン MCP サーバー、プラグイン LSP サーバーが再読み込みされます。プラグインコンポーネントをテストします。
/plugin-name:skill-nameでスキルを試す/agentsでエージェントが表示されることを確認する- フックが期待どおりに機能することを確認する
プラグインの問題をデバッグする
プラグインが期待どおりに機能しない場合：
- 構造を確認する：ディレクトリが
.claude-plugin/内ではなく、プラグインルートにあることを確認してください - コンポーネントを個別にテストする：各スキル、エージェント、フックを個別に確認してください
- 検証とデバッグツールを使用する：CLI コマンドとトラブルシューティング技術については、デバッグと開発ツールを参照してください
プラグインを共有する
プラグインを共有する準備ができたら：
- ドキュメントを追加する：インストールと使用方法の指示を含む
README.mdを含めます - バージョン管理戦略を選択する：明示的な
versionを設定するか、git コミット SHA に依存するかを決定してください。バージョン管理を参照してください - マーケットプレイスを作成または使用する：プラグインマーケットプレイスを通じて配布してインストールします
- 他のユーザーでテストする：より広い配布の前に、チームメンバーにプラグインをテストしてもらいます
プラグインがマーケットプレイスに登録されたら、他のユーザーはプラグインを検出してインストールするの指示を使用してインストールできます。プラグインをチーム内に保つには、プライベートリポジトリでマーケットプレイスをホストしてください。
プラグインを公式マーケットプレイスに送信する
プラグインを公式 Anthropic マーケットプレイスに送信するには、アプリ内送信フォームの 1 つを使用してください。
- Claude.ai：claude.ai/settings/plugins/submit
- Console：platform.claude.com/plugins/submit
プラグインが登録されたら、独自の CLI で Claude Code ユーザーにインストールを促すことができます。CLI からプラグインを推奨するを参照してください。
既存の設定をプラグインに変換する
.claude/ ディレクトリにスキルまたはフックが既にある場合は、それらをプラグインに変換して、より簡単に共有および配布できます。
移行手順
プラグイン構造を作成する
新しいプラグインディレクトリを作成します。
mkdir -p my-plugin/.claude-plugin
my-plugin/.claude-plugin/plugin.json にマニフェストファイルを作成します。
{
"name": "my-plugin",
"description": "Migrated from standalone configuration",
"version": "1.0.0"
}
既存のファイルをコピーする
既存の設定をプラグインディレクトリにコピーします。
# Copy commands
cp -r .claude/commands my-plugin/
# Copy agents (if any)
cp -r .claude/agents my-plugin/
# Copy skills (if any)
cp -r .claude/skills my-plugin/
フックを移行する
設定にフックがある場合は、フックディレクトリを作成します。
mkdir my-plugin/hooks
my-plugin/hooks/hooks.json をフック設定で作成します。.claude/settings.json または settings.local.json から hooks オブジェクトをコピーします。形式は同じです。コマンドはフック入力を stdin で JSON として受け取るため、jq を使用してファイルパスを抽出します。
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]
}
]
}
}
移行したプラグインをテストする
プラグインを読み込んで、すべてが機能することを確認します。
claude --plugin-dir ./my-plugin
各コンポーネントをテストします。コマンドを実行し、/agents にエージェントが表示されることを確認し、フックが正しくトリガーされることを確認します。
移行時の変更点
スタンドアロン（.claude/） |
プラグイン |
|---|---|
| 1 つのプロジェクトでのみ利用可能 | マーケットプレイス経由で共有可能 |
.claude/commands/ 内のファイル |
plugin-name/commands/ 内のファイル |
settings.json のフック |
hooks/hooks.json のフック |
| 共有するには手動でコピーする必要がある | /plugin install でインストール |
次のステップ
Claude Code のプラグインシステムを理解したので、異なる目標のための推奨パスを以下に示します。
プラグインユーザー向け
- プラグインを検出してインストールする：マーケットプレイスを参照してプラグインをインストール
- チームマーケットプレイスを設定する：チーム用のリポジトリレベルプラグインを設定
プラグイン開発者向け
- マーケットプレイスを作成して配布する：プラグインをパッケージ化して共有
- プラグインリファレンス：完全な技術仕様
- 特定のプラグインコンポーネントをさらに詳しく調べる：