Claude Code ガイド

Appearance

改善：refトラッキングのプラグインが毎回ロード時に再クローンされるように ​

原文（日本語に翻訳） ​

プラグインのフレッシュネスを改善。ref トラッキングのプラグインが毎回ロード時に再クローンされ、上流の変更を取り込むようになった。

原文（英語） ​

Improved plugin freshness — ref-tracked plugins now re-clone on every load to pick up upstream changes

概要 ​

Gitのref（ブランチやタグなど）を指定してインストールされたプラグイン（ref-tracked plugins）が、Claude Code起動のたびに最新版を取得するようになりました。以前はプラグインがインストール時の状態のまま固定されており、プラグイン開発者が更新しても自動的には反映されませんでした。この改善により、プラグインが常に最新の状態で利用できます。

基本的な使い方 ​

ref-tracked プラグインは、URLにブランチ・タグ・コミットを指定してインストールしたもの：

bash
# ブランチを指定してプラグインをインストール（ref-tracked）
claude plugin install https://github.com/example/my-plugin@main

# タグを指定（ref-tracked）
claude plugin install https://github.com/example/my-plugin@v2.0

# 起動のたびに自動的に最新版を取得
claude  # → プラグインが最新の状態で読み込まれる

実践例 ​

### チームの共有プラグイン ​

チームで管理しているプラグインを常に最新状態で使用：

bash
# チームのプラグインをブランチ指定でインストール
claude plugin install https://github.com/company/claude-plugins@main

# 毎回起動時に最新版を取得するため、プラグイン更新の手間が不要

### 開発中のプラグインのテスト ​

プラグイン開発者が自分のプラグインをテストする場合：

bash
# 開発ブランチを ref-tracked でインストール
claude plugin install https://github.com/my-org/dev-plugin@feature-branch

# Claude Code を再起動するたびに最新の変更が反映される

注意点 ​

  • パフォーマンス: 毎回クローンするため、起動時間がわずかに長くなる可能性がある
  • ネットワーク依存: オフライン環境ではプラグインの更新ができない（前回のキャッシュが使用される）
  • 特定バージョンに固定したい場合: コミットハッシュで固定すると自動更新されない
    bash
    claude plugin install https://github.com/example/plugin@abc1234  # ハッシュ固定
  • セッション中にプラグインディレクトリが削除される問題は別途修正済み（v2.1.81）

関連情報 ​