Claude Code プラグインを作成する

• まだ何もない: 最初のプラグインを作成するに従い、次にマーケットプレイスなしで開発するとテストとデバッグに従ってください。
• 既に .claude/ の下にファイルがある: 最初のプラグインのウォークスルーを一度実行してレイアウトを学び、次に既存の .claude/ セットアップを変換するに従ってください。

​

プラグインを使用する時期を決定する

• ファイルの場所: プラグインのルートと呼ばれるプラグイン独自のディレクトリの下に、skills/、agents/、hooks/hooks.json、.mcp.json として配置されます。
• 名前の付け方: プラグインのスキルとエージェントはプラグイン名をプレフィックスとして取得します。例えば /my-plugin:hello のように、2 つのプラグインが衝突することなく各々 hello スキルを提供できます。

​

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

mkdir -p 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 -p my-first-plugin/skills/hello

---
name: hello
description: Greet the user with a friendly message
disable-model-invocation: true
---

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

claude plugin validate ./my-first-plugin

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

/my-first-plugin:hello

​

プラグインを共有する

• 数人に直接送信する: プラグインのディレクトリまたはその .zip を提供し、何も公開する必要はありません。マーケットプレイスなしでプラグインを共有するを参照してください。
• 独自のマーケットプレイスにリストする: チームメイトはマーケットプレイスを一度追加し、プラグインを名前でインストールし、更新を受け取ります。独自のマーケットプレイスを通じて公開するを参照してください。
• Anthropic のコミュニティマーケットプレイスに送信する: リストされたら、そのマーケットプレイスを追加した誰もがインストールできます。コミュニティマーケットプレイスに送信するを参照してください。

​

プラグインレイアウト

​

マーケットプレイスなしで開発する

• --plugin-dir: 1 つのセッションのためにディレクトリまたは .zip アーカイブを読み込みます。
• --plugin-url: 1 つのセッションのために URL から .zip アーカイブをフェッチします。
• claude plugin init: ~/.claude/skills/ の下にプラグインをスキャフォルドし、すべてのセッションで読み込みます。

​

1 つのセッションのためにプラグインを読み込む

​

ディレクトリまたは .zip から

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

​

プラグインのフォルダから

• 追加するサブフォルダは、マニフェストが存在すると新しいプラグインとして読み込まれます。
• サブフォルダを削除すると、そのプラグインはアンロードされます。

​

URL から

claude --plugin-url https://example.com/my-first-plugin.zip

​

環境変数から

​

すべてのセッションでプラグインを読み込むようにする

​

claude plugin init でプラグインをスキャフォルドする

claude plugin init my-tool

​

スキャフォルドされたプラグインのスキルに名前を付ける

​

プラグインの読み込みを停止する

​

リポジトリを通じてプラグインを共有する

​

テストとデバッグ

1. シェルで claude plugin validate <path> を実行してください。マニフェストとすべてのスキル、エージェント、コマンドファイルのフロントマターをチェックし、Validation passed で終了コード 0 で終了します。--strict を追加して警告でも失敗するようにしてください。終了コードとディレクトリ処理はプラグインコマンドリファレンスにあります。
2. 実行中のセッションで /reload-plugins を実行して、ディスク上で行った編集を適用してください。1 つの Reloaded: 行をカウント付きで出力します。次に、/plugin-name:skill コマンドを入力するか、/plugin Installed タブでプラグインを見つけることで、スキルが読み込まれたことを確認してください。
3. 同じセッションで /plugin を実行してください。Installed タブはプラグインをリストし、プラグインの詳細では、Claude Code が見つけたコンポーネントをリストします。Errors タブは、読み込みに失敗したものと理由（例えば、マニフェスト内のパスが存在しない）をリストします。
4. シェルに戻り、claude plugin list を実行してください。セッションのみとスキルディレクトリプラグインを独自のセクションで Status: ✔ loaded または読み込みエラーで出力します。開発中のプラグインを含めるには、plugin list の前に --plugin-dir をそのパスで渡してください。

​

コンポーネントパスが見つからない

​

--plugin-dir がマーケットプレイスルートにあると plugins/ の下のプラグインが読み込まれない

​

プラグインが読み込まれるがそのスキルが見つからない

​

userConfig ダイアログが表示されない

​

プラグインが Claude の動作を変更することを確認する

​

既存の .claude/ セットアップを変換する

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 -p my-plugin/hooks

{
  "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

• スキルとエージェント: 2 つのセットは衝突しません。プラグインのスキルとエージェントは my-plugin: プレフィックスを持つためです。/deploy と /my-plugin:deploy の両方が機能し、Claude は reviewer と my-plugin:reviewer を 2 つのサブエージェントとして見ます。
• フック: フックにはプレフィックスがないため、設定ファイルと hooks/hooks.json の両方にあるフックは、そのイベントが発火するたびに 2 回実行されます。

​

次のステップ

• プラグインコンポーネント: エージェント、フック、MCP サーバー、LSP サーバー、ユーザー設定をプラグインに追加する
• プラグインで evals をテストする: eval ケースを書き込み、claude plugin eval で実行してプラグインが Claude の動作をどの程度確実に導くかをチェックする
• プラグインを公開する: バージョン管理し、マーケットプレイスに入れ、コミュニティマーケットプレイスに送信する
• claude.ai と Cowork のプラグイン: 同じプラグインフォルダが claude.ai と Cowork にインストールされます。一部のコンポーネントは Claude Code のみです
• プラグインマニフェストリファレンス: すべての plugin.json フィールド、パスルール、ディレクトリ
• スキル: プラグインが提供するスキルを書く
• Anthropic の claude-code リポジトリのプラグイン: このページのレイアウトの完全な実装例。feature-dev と code-review など