Claude Code ガイド

Appearance

claude plugin prune: 孤立した自動インストール依存関係の削除 ​

原文（日本語に翻訳） ​

孤立した自動インストール済みプラグイン依存関係を削除する claude plugin prune を追加しました。plugin uninstall --prune はカスケード削除を行います。

原文（英語） ​

Added claude plugin prune to remove orphaned auto-installed plugin dependencies; plugin uninstall --prune cascades

概要 ​

Claude Code v2.1.121 では、プラグイン管理コマンドに claude plugin prune が追加されました。プラグインを削除した後に残る自動インストールされた依存パッケージを一括でクリーンアップできます。また claude plugin uninstall --prune オプションを使うと、プラグインのアンインストールと同時に依存関係も削除するカスケード削除が可能です。定期的なメンテナンスやディスクスペースの節約に役立ちます。

基本的な使い方 ​

bash
# 孤立した依存関係を確認・削除
claude plugin prune

# プラグインをアンインストールと同時に依存関係も削除
claude plugin uninstall my-plugin --prune

実践例 ​

定期的なクリーンアップ ​

bash
# 現在インストールされているプラグインを確認
claude plugin list

# 不要なプラグインを削除
claude plugin uninstall old-plugin

# 孤立した依存関係を削除
claude plugin prune
# → Removed 3 orphaned dependencies: pkg-a@1.2.0, pkg-b@0.5.1, pkg-c@2.0.0

アンインストールと同時に依存関係も削除 ​

bash
# --prune フラグでカスケード削除
claude plugin uninstall heavy-plugin --prune
# → Uninstalled heavy-plugin
# → Removed 5 orphaned dependencies (saved ~120MB)

CI/CD 環境でのクリーンアップ ​

bash
#!/bin/bash
# CI ジョブ終了時のクリーンアップスクリプト

# 一時的に使ったプラグインをまとめてアンインストール
claude plugin uninstall ci-helper --prune
claude plugin uninstall test-reporter --prune

# 残った孤立依存関係を一括削除
claude plugin prune

echo "Plugins and dependencies cleaned up"

ドライランで確認（将来的な機能） ​

bash
# prune 前に何が削除されるか確認
claude plugin prune --dry-run
# → Would remove: pkg-x@1.0.0, pkg-y@2.1.0

注意点 ​

  • plugin prune は自動インストールされた依存関係のみを削除します（手動でインストールしたパッケージは対象外）
  • --prune フラグはアンインストールするプラグインが依存していたパッケージを削除するため、他のプラグインが同じパッケージを使っている場合は残されます
  • 大きなプラグインをインストール・削除する環境では定期的に claude plugin prune を実行することを推奨します
  • 削除された内容はコマンド出力で確認できます

関連情報 ​