Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

プラグインマニフェスト: themes と monitors は "experimental": { ... } の下で宣言するようにしてください。トップレベルの宣言は引き続き動作しますが、claude plugin validate で警告が表示されるようになります。

原文（英語） ​

Plugin manifests: themes and monitors should now be declared under "experimental": { ... }. Top-level declarations still work but claude plugin validate will warn

概要 ​

プラグインマニフェストにおいて、themes と monitors の宣言場所が変更されました。これらのフィールドは実験的な機能として位置づけられ、"experimental" ブロック内に移動する必要があります。後方互換性のためトップレベルの宣言は引き続き動作しますが、claude plugin validate コマンドで警告が出力されるようになります。

基本的な使い方 ​

マニフェストの構造を以下のように更新します。

変更前（非推奨）:

json
{
  "name": "my-plugin",
  "version": "1.0.0",
  "themes": [...],
  "monitors": [...]
}

変更後（推奨）:

json
{
  "name": "my-plugin",
  "version": "1.0.0",
  "experimental": {
    "themes": [...],
    "monitors": [...]
  }
}

実践例 ​

テーマを含むプラグインマニフェストの更新 ​

json
{
  "name": "my-theme-plugin",
  "version": "2.0.0",
  "description": "カスタムテーマを提供するプラグイン",
  "experimental": {
    "themes": [
      {
        "name": "dark-ocean",
        "colors": {
          "background": "#1a1a2e",
          "foreground": "#e0e0e0",
          "accent": "#0099ff"
        }
      }
    ]
  }
}

モニターを含むプラグインマニフェストの更新 ​

json
{
  "name": "my-monitor-plugin",
  "version": "1.5.0",
  "description": "カスタムモニターを提供するプラグイン",
  "experimental": {
    "monitors": [
      {
        "name": "cpu-usage",
        "interval": 5000,
        "command": "top -bn1 | grep Cpu"
      }
    ]
  }
}

バリデーションで警告を確認する ​

bash
# 古い形式のマニフェストを検証
claude plugin validate

# 出力例（警告が表示される）
# ⚠ Warning: `themes` should be declared under `experimental`. Top-level declaration is deprecated.
# ⚠ Warning: `monitors` should be declared under `experimental`. Top-level declaration is deprecated.

注意点 ​

  • トップレベルに themes や monitors を置いた既存のプラグインは引き続き動作しますが、将来的なバージョンでは削除される可能性があります。
  • claude plugin validate を定期的に実行し、警告がないことを確認することを推奨します。
  • experimental ブロック内の機能は仕様が変更される可能性があるため、本番環境での利用には注意してください。
  • 自分のプラグインをメンテナンスしている場合は、早期に experimental ブロックへの移行を行うことを推奨します。

関連情報 ​