Claude Code ガイド

Appearance

原文（日本語訳） ​

  • プラグインが plugin.json またはマーケットプレイスエントリに defaultEnabled: false を宣言できるようになりました。/plugin コマンドまたは claude plugin enable で有効化できます。有効化されたプラグインの依存関係は引き続き自動的に有効化されます。
  • /plugin の「Discover」タブで、現在のディレクトリと関連性シグナルが一致するプラグインが「このディレクトリへの提案」アノテーション付きでピン留めされるようになりました。

原文（英語） ​

  • Plugins can now declare defaultEnabled: false in plugin.json or a marketplace entry; enable them with /plugin or claude plugin enable. Dependencies of enabled plugins are still enabled automatically.
  • The /plugin Discover tab now pins plugins whose relevance signals match the current directory with a "suggested for this directory" annotation.

概要 ​

プラグインに defaultEnabled: false を設定することで、インストール時に自動で有効化されないよう制御できるようになりました。これにより、プラグイン作者はすべてのユーザーに対して強制的に機能を有効化することなく、オプトイン方式での提供が可能になります。また、/plugin の「Discover」タブでは現在のプロジェクトディレクトリに関連するプラグインが「このディレクトリへの提案」として自動的にハイライト表示され、適切なプラグインを素早く見つけられるようになりました。

基本的な使い方 ​

プラグインをデフォルト無効に設定する（プラグイン作者向け） ​

plugin.json に defaultEnabled: false を追加します。

json
{
  "name": "my-plugin",
  "version": "1.0.0",
  "defaultEnabled": false,
  "description": "オプトインが必要なプラグインの例"
}

プラグインを手動で有効化する（ユーザー向け） ​

スラッシュコマンドで有効化：

/plugin enable my-plugin

CLIコマンドで有効化：

bash
claude plugin enable my-plugin

実践例 ​

デフォルト無効のプラグインを作成する ​

特定のユーザーだけが使う実験的な機能を提供するプラグインを、デフォルト無効として定義します。

json
{
  "name": "experimental-tools",
  "version": "0.1.0",
  "defaultEnabled": false,
  "description": "実験的な開発ツール群（オプトインが必要）",
  "skills": [
    {
      "name": "experimental-refactor",
      "description": "実験的なリファクタリング機能"
    }
  ]
}

インストール後、ユーザーが明示的に有効化するまでスキルは使用できません。

依存関係を持つプラグインを有効化する ​

プラグインAがプラグインBに依存していて、両方とも defaultEnabled: false の場合、プラグインAを有効化するだけで依存するプラグインBも自動的に有効化されます。

bash
# プラグインAを有効化すると、依存するプラグインBも自動的に有効化される
claude plugin enable plugin-a
# => plugin-a を有効化中...
# => 依存関係: plugin-b を自動的に有効化しました

ディレクトリ提案機能を活用する ​

Pythonプロジェクトのディレクトリで /plugin の「Discover」タブを開くと、Pythonや機械学習関連のプラグインが「このディレクトリへの提案」としてピン留めされて表示されます。

# Pythonプロジェクトのルートで
cd /path/to/my-python-project
claude
# → /plugin → Discover タブを開く
# 「このディレクトリへの提案」セクションに
# python-linter や ml-tools などが表示される

プロジェクト固有のプラグイン設定 ​

チーム開発では、.claude/settings.json でプロジェクトに必要なプラグインを明示的に有効化しておくと、メンバー全員が同じプラグイン環境を使えます。

json
{
  "plugins": {
    "my-team-plugin": {
      "enabled": true
    }
  }
}

注意点 ​

  • defaultEnabled: false を設定したプラグインは、インストールしても明示的に有効化するまでスキルや機能が使用できません。
  • 有効化されたプラグインの依存関係は自動的に有効化されます。逆に、依存元を無効化しても依存先は自動的に無効化されません。
  • ディレクトリ提案は関連性シグナルに基づいており、プロジェクトの言語や設定ファイルなどを自動的に検出します。
  • プラグインの有効/無効状態はユーザーまたはプロジェクトの設定に保存されます。

関連情報 ​