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

> Claude Code 2.1.285で、claude plugin configureコマンドが導入されました。ドキュメントでプラグイン設定を確認し、再インストールせずにトークンやアドレスを変更する方法を解説します。

Source: https://ailoot.ai/blog/ja/claude-code-plugin-configure-2-1-285/
Canonical: https://ailoot.ai/blog/ja/claude-code-plugin-configure-2-1-285/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-050
Revision: sha256-f41ef76a8eb5866ffe023746d7e5d3bd90109e06cb5fcc3f50248da0ea5f9967


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

Claude Code 2.1.285で、ターミナルコマンド `claude plugin configure <plugin>` が導入されました。フラグを指定しないと、各プラグイン設定が設定済みか未設定かが表示され、値そのものは表示されません。`--values-stdin` を使うと、入力として渡したJSONファイルから新しい値を保存でき、プラグインを再インストールする必要はありません。通常の値は `settings.json` の `pluginConfigs` に保存され、`sensitive: true` とマークされたフィールドの値は、システムのセキュアな認証情報ストアに保存されます。

</div>

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

Ailootの利用方法については、[ドキュメント](https://ailoot.ai/docs/)をご覧ください。



## バージョン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` を含まない名前だけでは受け付けません。

```bash
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の出力から、変更する設定名を確認してください。

```json
{"api_url": "NEW_ADDRESS"}
```

```bash
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` のプレースホルダー全体を実際の値に置き換えてください。引数の前後の引用符は残してください。

```bash
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に関するガイド](https://ailoot.ai/blog/ja/skills-subagents-mcp-plugins-claude-code/)では、拡張機能の種類を選ぶ方法を紹介しています。まだプラグインを選んでいない場合は、Claude Codeのプラグイントップ10から始めることができます。Telegramボットについては別のガイドがあり、[Telegramエージェントへのプラグインのインストール](https://ailoot.ai/blog/ja/telegram-ai-agent-plugins/)は、Claude Codeへのインストールとは異なります。

<div class="section" role="doc-bibliography" aria-label="出典">

### 出典

- [Claude Code CHANGELOG、バージョン2.1.285の項目](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code：プラグインコマンドリファレンス](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code：プラグインマニフェストリファレンス、ユーザー設定](https://code.claude.com/docs/en/plugins-reference.md)

</div>





[Ailoot](https://ailoot.ai/)について知る。

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

### configureでインストール済みのプラグインが見つからない場合は？

`claude plugin list`にある完全なname@marketplace識別子を使い、該当するスコープにインストールされているか確認します。このコマンドは短いプラグイン名だけでは受け付けません。

### 変更したトークンの値を表示せずに確認できますか？

プラグインの完全な識別子で`claude plugin configure`を実行し、機密フィールドが設定済みを示すsetになっているか確認します。保存後はClaude Codeを再起動し、トークンを含むJSON入力ファイルはコミットしないでください。


## Ailoot · 企業とそのプロジェクト群

Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。