Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

claude plugin tagを追加。バージョン検証付きでプラグインのリリース用gitタグを作成する。

原文（英語） ​

Added claude plugin tag to create release git tags for plugins with version validation

概要 ​

プラグイン開発者向けにclaude plugin tagコマンドが追加されました。このコマンドはプラグインのリリース用gitタグを作成する際に、plugin.jsonに記載されているバージョン番号を検証してから適切な形式のタグを自動生成します。バージョンの不整合によるリリースミスを防ぎ、プラグインのバージョン管理ワークフローを標準化できます。

基本的な使い方 ​

bash
# プラグインのリリースタグを作成
claude plugin tag

# 特定バージョンを指定してタグを作成
claude plugin tag 1.2.0

実践例 ​

通常のリリースフロー ​

bash
# 1. plugin.jsonのバージョンを更新
# plugin.json
# {
#   "name": "my-plugin",
#   "version": "1.2.0"
# }

# 2. 変更をコミット
git add plugin.json
git commit -m "chore: bump version to 1.2.0"

# 3. リリースタグを作成（plugin.jsonのバージョンが検証される）
claude plugin tag
# → バージョン 1.2.0 を検証
# → git tag v1.2.0 を作成

バージョン不整合時のエラー処理 ​

bash
# plugin.jsonのバージョンとタグが一致しない場合はエラー
claude plugin tag 2.0.0
# → エラー: plugin.jsonのバージョン(1.2.0)と指定バージョン(2.0.0)が一致しません

タグをリモートにプッシュ ​

bash
# タグ作成後にリモートへプッシュ
claude plugin tag
git push origin v1.2.0

# またはすべてのタグをプッシュ
git push origin --tags

プラグインのリリースチェックリスト ​

bash
# 1. バージョンを更新
vim plugin.json

# 2. テストを実行
claude plugin test

# 3. ドキュメントを確認
cat README.md

# 4. コミット & タグ作成
git add .
git commit -m "release: v1.2.0"
claude plugin tag

# 5. プッシュ
git push origin main
git push origin v1.2.0

注意点 ​

  • claude plugin tagはプラグインディレクトリのルート（plugin.jsonがあるディレクトリ）で実行する必要があります
  • バージョン番号はセマンティックバージョニング（MAJOR.MINOR.PATCH）形式である必要があります
  • 作成されたタグはvプレフィックス付きになります（例：バージョン1.2.0→タグv1.2.0）
  • gitリポジトリ内で実行する必要があります

関連情報 ​