プラグインを作成する

​

プラグインとスタンドアロン設定を使用する場合

• 単一のプロジェクト用にClaude Codeをカスタマイズしている
• 設定は個人的であり、共有する必要がない
• スラッシュコマンドやフックをパッケージ化する前に実験している
• /hello や /review のような短いスラッシュコマンド名が必要

• チームまたはコミュニティと機能を共有したい
• 複数のプロジェクト全体で同じスラッシュコマンド/エージェントが必要
• 拡張機能のバージョン管理と簡単な更新が必要
• マーケットプレイスを通じて配布している
• /my-plugin:hello のような名前空間付きスラッシュコマンドで問題ない（名前空間はプラグイン間の競合を防ぎます）

​

クイックスタート

​

前提条件

• Claude Code インストール済みで認証済み
• Claude Code バージョン 1.0.33 以降（claude --version で確認）

​

最初のプラグインを作成する

mkdir my-first-plugin

mkdir my-first-plugin/.claude-plugin

{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}

mkdir my-first-plugin/commands

---
description: Greet the user with a friendly message
---

# Hello Command

Greet the user warmly and ask how you can help them today.

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

/my-first-plugin:hello

---
description: Greet the user with a personalized message
---

# Hello Command

Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.

/my-first-plugin:hello Alex

• プラグインマニフェスト (.claude-plugin/plugin.json)：プラグインのメタデータを説明します
• コマンドディレクトリ (commands/)：カスタムスラッシュコマンドを含みます
• コマンド引数 ($ARGUMENTS)：動的な動作のためにユーザー入力をキャプチャします

​

プラグイン構造の概要

​

より複雑なプラグインを開発する

​

プラグインにスキルを追加する

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── code-review/
        └── SKILL.md

---
name: code-review
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

​

プラグインにLSPサーバーを追加する

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

​

複雑なプラグインを整理する

​

プラグインをローカルでテストする

claude --plugin-dir ./my-plugin

• /command-name でコマンドを試す
• /agents にエージェントが表示されることを確認する
• フックが期待通りに機能することを確認する

claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

​

プラグインの問題をデバッグする

1. 構造を確認する：ディレクトリが .claude-plugin/ 内ではなく、プラグインルートにあることを確認してください
2. コンポーネントを個別にテストする：各コマンド、エージェント、フックを個別に確認してください
3. 検証とデバッグツールを使用する：CLIコマンドとトラブルシューティング技術については、デバッグと開発ツールを参照してください

​

プラグインを共有する

1. ドキュメントを追加する：インストールと使用方法の指示を含む README.md を含めます
2. プラグインをバージョン管理する：plugin.json でセマンティックバージョニングを使用します
3. マーケットプレイスを作成または使用する：プラグインマーケットプレイスを通じて配布してインストールします
4. 他のユーザーでテストする：より広い配布の前に、チームメンバーにプラグインをテストしてもらいます

​

既存の設定をプラグインに変換する

​

移行手順

mkdir -p my-plugin/.claude-plugin

{
  "name": "my-plugin",
  "description": "Migrated from standalone configuration",
  "version": "1.0.0"
}

# コマンドをコピー
cp -r .claude/commands my-plugin/

# エージェントをコピー（ある場合）
cp -r .claude/agents my-plugin/

# スキルをコピー（ある場合）
cp -r .claude/skills my-plugin/

mkdir my-plugin/hooks

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{ "type": "command", "command": "npm run lint:fix $FILE" }]
      }
    ]
  }
}

claude --plugin-dir ./my-plugin

​

移行時の変更内容

​

次のステップ

​

プラグインユーザー向け

• プラグインを発見してインストールする：マーケットプレイスを参照してプラグインをインストールする
• チームマーケットプレイスを設定する：チーム用のリポジトリレベルプラグインを設定する

​

プラグイン開発者向け

• マーケットプレイスを作成および配布する：プラグインをパッケージ化して共有する
• プラグインリファレンス：完全な技術仕様
• 特定のプラグインコンポーネントをさらに詳しく調べる：
  • スラッシュコマンド：コマンド開発の詳細
  • サブエージェント：エージェント設定と機能
  • エージェントスキル：Claudeの機能を拡張する
  • フック：イベント処理と自動化
  • MCP：外部ツール統合