Claude Code：インストール済みプラグインを再インストールせずに再設定する方法（2.1.285）

このガイドは、アドレス、トークン、フォルダーパスなどの userConfig 設定を宣言しているClaude Codeプラグインをすでにインストールしているユーザー向けです。誤って入力した値を修正したり、プラグインを再インストールせずにトークンを交換したりする必要がある場合に役立ちます。以下の内容はすべて、Claude Codeの公式ドキュメントと変更履歴に基づいています。この記事には独自のテスト実行は含まれていません。

Ailootの利用方法については、ドキュメントをご覧ください。

バージョン2.1.285で追加された機能#

Claude Codeのバージョン2.1.285の変更履歴（2026年9月29日付のコミット）には、プラグインに関する記述がいくつかあります。この記事に関係するのは次の2項目です。

Added claude plugin configure <plugin> to show a plugin's options and which are unset, or save new values read from stdin with --values-stdin

これは、新しい claude plugin configure <plugin> コマンドでプラグインの設定と未設定の項目を確認できるほか、--values-stdin を付けると標準入力から読み取った新しい値を保存できるという意味です。

Added <server>.<key>=<value> to claude plugin install --config, so a bundled .mcpb MCP server's own settings can be set at install time and it starts without visiting /plugin → Configure

これは、claude plugin install --config が <server>.<key>=<value> 形式に対応したという意味です。これにより、.mcpb ファイルでプラグインにバンドルされたMCPサーバーの設定をインストール時に指定でき、/plugin → Configureを開かずにサーバーを起動できます。

コマンドリファレンスでは、バージョン要件が確認できます。claude plugin configure の実行にはClaude Code v2.1.285以降が必要です。それより前のバージョンには、このコマンドはありません。

/plugin configureとの違い#

/plugin configure <plugin> コマンド（エイリアスは config）は、以前からClaude Codeの対話型セッション内で利用できました。userConfig の設定画面を開くには、v2.1.147以降が必要です。ただし、/plugin は対話型セッションでしか動作しません。claude -p のような非対話型の実行では、Claude Codeは /plugin をその環境で利用できないと応答します。

ドキュメントによると、claude plugin コマンドはClaude Codeのセッション外で、シェルやスクリプトから実行します。この方法なら、ダイアログを開かずに claude plugin configure を実行できます。対話型ターミナルがない環境でのこのコマンドの動作や、グラフィカル環境のないサーバーでシークレットの値がどこに保存されるかは、ドキュメントに記載されていません。CIで使う前に、ご自身の環境で確認してください。

ステップ1. 設定済みの項目を確認する#

ドキュメントでは、claude plugin list に表示される name@marketplace 形式の完全なプラグイン識別子が必要です。configure コマンドは、@marketplace を含まない名前だけでは受け付けません。

claude plugin list
claude plugin configure formatter@my-marketplace

formatter@my-marketplace は、使用するプラグインの識別子に置き換えてください。フラグを指定しない場合、各設定には required または optional のラベルが付き、シークレットフィールドにはさらに sensitive と表示されたうえで、set または not set が示されます。保存済みの値は表示されません。

機械可読な出力が必要な場合は、--json を追加してください。この場合、通常のフィールドの保存済みの値が出力に含まれますが、シークレットフィールドの内容は決して表示されません。

ステップ2. ファイルを使って値を変更する#

値はJSONオブジェクトで指定します。キーはマニフェストにある設定名、各値は改行を含まない文字列です。ドキュメントでは、ファイルを使う方法が紹介されています。オブジェクトを values.json に書き込み、そのファイルをコマンドの標準入力に渡します。ここでは、ドキュメントの例で使われているキー api_url を示しています。ご自身のプラグインでは、マニフェストまたはステップ1の出力から、変更する設定名を確認してください。

{"api_url": "NEW_ADDRESS"}

claude plugin configure formatter@my-marketplace --values-stdin < values.json

保存時には、次のルールが適用されます。

• JSONで省略した設定は、以前の値が保持されます。変更するフィールドだけを指定できます。
• フラグの説明では、設定値全般について言及していますが、シークレットフィールドに関する別個のルールは記載されていません。保存後、ステップ1を使って該当フィールドが set と表示されることを確認してください。
• Claude Codeは各値を宣言済みの型と照合し、Configuration saved. Restart Claude Code to apply it. と表示します。つまり、設定は保存されており、Claude Codeの再起動後に反映されます。
• JSONにマニフェストで宣言されていないキーが含まれている場合や、値が検証に失敗した場合、コマンドは何も保存せず、Failed to save configuration: に続けて理由を表示し、終了コード 1 で終了します。

トークンを values.json に書き込む場合は、通常のディスク上のファイルであることに注意してください。設定を保存したら削除し、このようなファイルをリポジトリに追加しないでください。

値の保存場所#

プラグインマニフェストのドキュメントによると、通常の値はユーザーの settings.json にある pluginConfigs に保存されます。sensitive: true とマークされたフィールドの値は settings.json ではなく、システムのセキュアな認証情報ストアに保存されます。これらのフィールドへの入力はマスクされます。

シークレットフィールドの値を settings.json で探しても意味はありません。claude plugin configure では、sensitive と set または not set のラベルで状態を確認できます。

install --config：インストール時に値を設定する#

新規インストールでは、claude plugin install の --config <key=value> フラグを使って設定できます。マニフェストで宣言された userConfig の設定を指定するもので、v2.1.147以降が必要です。設定ごとにフラグを繰り返してください。バージョン2.1.285以降では、<server>.<key> 形式のキーを指定すると、バンドルされたMCPサーバー自身の user_config で宣言された設定を指定できます。

以下の例では、formatter@my-marketplace を使用するプラグインの識別子に、api_url をマニフェストの設定名に、NEW_ADDRESS のプレースホルダー全体を実際の値に置き換えてください。引数の前後の引用符は残してください。

claude plugin install formatter@my-marketplace --config 'api_url=NEW_ADDRESS'

どのコマンドを使うかは、プラグインをインストール済みかどうかによって異なります。install --config は初回インストール時に値を設定し、plugin configure --values-stdin はすでにインストールされているプラグインの値を変更します。

バンドルされたMCPサーバーの設定について、ドキュメントに記載されている方法は plugin install --config または /plugin の Configure です。これらの設定に plugin configure コマンドを使う方法は示されていません。

コマンドでプラグインが見つからない場合#

claude plugin configure がその識別子の読み込み済みプラグインを見つけられない場合、No installed plugin has the id "<plugin>". と表示し、終了コード 1 で終了します。まず、claude plugin list に表示される name@marketplace 形式の完全な識別子を指定したことを確認してください。プラグイン名だけでは不十分です。

セッション内のコマンドでは、別のメッセージが表示されます。/plugin enable、disable、uninstall、configure のいずれかを使った際に、現在のプロジェクトにインストールされていないプラグインを指定すると、Claude Codeは Plugin "<plugin>" is not installed in this project と表示し、何も行いません。

結論#

Claude Code 2.1.285以降で、すでにインストール済みのプラグインのトークンやアドレスを変更するには、claude plugin list で識別子を確認し、claude plugin configure で設定の状態を確かめてから、--values-stdin でファイルから新しい値を渡し、Claude Codeを再起動します。シークレットフィールドの値は settings.json には保存されないため、同じコマンドで状態を確認してください。

Claude CodeのSkills、Subagents、MCP、Pluginsに関するガイドでは、拡張機能の種類を選ぶ方法を紹介しています。まだプラグインを選んでいない場合は、Claude Codeのプラグイントップ10から始めることができます。Telegramボットについては別のガイドがあり、Telegramエージェントへのプラグインのインストールは、Claude Codeへのインストールとは異なります。

Ailootについて知る。