Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

マーケットプレイスのエントリが依存関係を省略している場合に、plugin.jsonで宣言された依存関係がプラグインインストールで尊重されない問題を修正しました。/plugin install は自動インストールされた依存関係を一覧表示するようになりました。

原文（英語） ​

Fixed plugin install not honoring dependencies declared in plugin.json when the marketplace entry omits them; /plugin install now lists auto-installed dependencies.

概要 ​

Claude Code v2.1.110では、プラグインのインストール時にplugin.jsonで宣言された依存関係が正しく処理されない問題が修正されました。マーケットプレイスのエントリに依存関係情報が含まれていない場合でも、plugin.jsonファイルに記載された依存関係が自動的にインストールされるようになりました。また、/plugin installコマンドで自動的にインストールされた依存関係が一覧表示されるようになり、透明性が向上しました。

基本的な使い方 ​

bash
# プラグインをインストール（依存関係が自動解決される）
/plugin install my-plugin

# インストール後の出力例（v2.1.110以降）
インストール中: my-plugin v1.2.0
依存関係を自動インストール:
  - helper-utils v2.0.0
  - shared-components v1.5.0
インストール完了!

実践例 ​

ユースケース1: 依存関係のあるプラグインのインストール ​

bash
# 複数の依存関係を持つプラグインをインストール
/plugin install advanced-code-analyzer

// 修正前の動作:
// マーケットプレイスに依存関係情報がない場合、依存関係がインストールされず
// プラグインが正常に動作しないことがあった

// 修正後の動作:
インストール中: advanced-code-analyzer v3.1.0
plugin.json から依存関係を検出:
  - code-parser v2.0.0 ✓ インストール済み
  - ast-utils v1.8.0 → 自動インストール中...
  - language-server v4.0.0 → 自動インストール中...
依存関係のインストール完了
advanced-code-analyzer のインストール完了!

ユースケース2: plugin.json の依存関係宣言 ​

プラグイン開発者向け：plugin.jsonで正しく依存関係を宣言する方法。

json
// plugin.json の例
{
  "name": "my-awesome-plugin",
  "version": "1.0.0",
  "description": "便利なプラグイン",
  "dependencies": {
    "shared-utils": "^2.0.0",
    "api-client": ">=1.5.0"
  },
  "skills": [
    {
      "name": "my-skill",
      "file": "skills/my-skill.md"
    }
  ]
}

ユースケース3: 依存関係の確認 ​

bash
# インストール済みプラグインと依存関係を確認
/plugin list --show-dependencies

// 出力例
インストール済みプラグイン:
1. advanced-code-analyzer v3.1.0
   依存関係:
   - code-parser v2.0.0
   - ast-utils v1.8.0 (自動インストール)
   - language-server v4.0.0 (自動インストール)

2. git-helper v1.2.0
   依存関係: なし

ユースケース4: 依存関係の競合解決 ​

bash
# 依存関係に競合がある場合の確認
/plugin install conflicting-plugin

// 依存関係の競合が検出された場合の出力
インストール中: conflicting-plugin v2.0.0
警告: 依存関係の競合が検出されました
  - shared-utils: v1.5.0 が必要 (現在: v2.0.0)
互換性のあるバージョンを確認中...
解決策: shared-utils v2.0.0 は v1.5.0 と後方互換性があります
インストールを続行します

ユースケース5: プラグインのアップデートと依存関係 ​

bash
# プラグインのアップデート時も依存関係が正しく処理される
/plugin update advanced-code-analyzer

インストール中: advanced-code-analyzer v3.2.0（更新）
依存関係を確認中...
新しい依存関係: new-feature-lib v1.0.0 → 自動インストール中...
不要になった依存関係: old-compat-shim → 削除中...
アップデート完了!

注意点 ​

  • マーケットプレイス vs plugin.json — マーケットプレイスのエントリに依存関係情報がなくても、plugin.jsonの情報が使用されます。
  • 自動インストールの透明性 — v2.1.110以降は自動インストールされる依存関係が明示的に表示されます。
  • 依存関係の削除 — プラグインをアンインストールしても、自動インストールされた依存関係は自動的には削除されません（他のプラグインが使用している可能性があるため）。
  • バージョン互換性 — 依存関係のバージョン要件が競合する場合は、警告が表示されます。

関連情報 ​