Skip to content

--plugin-dirの変更:単一パス指定に変更、複数指定はフラグ繰り返しで対応

原文(日本語に翻訳)

--plugin-dir を1つのパスのみ受け付けるように変更し、サブコマンドをサポート — 複数ディレクトリの場合は --plugin-dir を繰り返し使用

原文(英語)

Updated --plugin-dir to only accept one path to support subcommands — use repeated --plugin-dir for multiple directories

概要

Claude Codeの --plugin-dir フラグの仕様が変更されました。以前は1つの --plugin-dir フラグに複数のパスを渡すことができましたが、サブコマンドとの互換性を確保するために、1つのフラグにつき1つのパスのみを受け付けるようになりました。複数のプラグインディレクトリを指定する場合は、--plugin-dir フラグを繰り返し使用します。

基本的な使い方

プラグインディレクトリを1つ指定する場合:

bash
claude --plugin-dir ./my-plugins

複数のプラグインディレクトリを指定する場合は、フラグを繰り返します:

bash
claude --plugin-dir ./my-plugins --plugin-dir ./team-plugins

実践例

プロジェクト固有のプラグインとチーム共有プラグインの併用

プロジェクトローカルのプラグインとチーム共有のプラグインを同時に読み込む場合:

bash
claude \
  --plugin-dir ./project-plugins \
  --plugin-dir ~/shared/team-plugins

環境別のプラグイン構成

開発・ステージング・本番でプラグインセットを切り替える場合:

bash
# 開発環境:デバッグ用プラグインを追加
claude \
  --plugin-dir ./plugins/common \
  --plugin-dir ./plugins/dev

# 本番環境:本番用プラグインのみ
claude \
  --plugin-dir ./plugins/common \
  --plugin-dir ./plugins/production

シェルスクリプトでの移行

以前のスクリプトで複数パスを1つのフラグに渡していた場合の修正例:

bash
# 変更前(v2.1.76以前)— もう動作しない可能性がある
# claude --plugin-dir ./plugins1 ./plugins2

# 変更後(v2.1.76以降)
claude --plugin-dir ./plugins1 --plugin-dir ./plugins2

エイリアスでの活用

よく使うプラグイン構成をシェルエイリアスとして設定:

bash
# ~/.bashrc or ~/.zshrc
alias claude-dev='claude --plugin-dir ~/plugins/common --plugin-dir ~/plugins/dev'
alias claude-prod='claude --plugin-dir ~/plugins/common --plugin-dir ~/plugins/prod'

注意点

  • 破壊的変更の可能性: 以前のバージョンで1つの --plugin-dir に複数パスをスペース区切りで渡していた場合、スクリプトの修正が必要です
  • サブコマンドサポート: この変更はCLIのサブコマンド(claude mcp など)との互換性を確保するために行われました
  • セッション限定: --plugin-dir で指定したプラグインはそのセッションのみで有効です
  • VS Codeとの共有: CLIで設定したプラグインはVS Code拡張とも共有されます
  • マーケットプレイスとの併用: --plugin-dir はマーケットプレイス経由でインストールしたプラグインと併用可能です

関連情報