# Claude Code：如何在不重新安裝的情況下重新設定已安裝的外掛（2.1.285）

> Claude Code 2.1.285 新增了 claude plugin configure 指令。說明如何在文件中檢查外掛設定，並在不重新安裝的情況下變更權杖或位址。

Source: https://ailoot.ai/blog/zh-hant-tw/claude-code-plugin-configure-2-1-285/
Canonical: https://ailoot.ai/blog/zh-hant-tw/claude-code-plugin-configure-2-1-285/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-050
Revision: sha256-5c4df1992e34a9c63c633bb7eab2ab4d4cf6c6d0bd0d612fe31c1f325ee75bd5


<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>

本指南適用於已安裝 Claude Code 外掛，且該外掛宣告了 `userConfig` 設定的使用者，例如位址、權杖或資料夾路徑。當你需要修正輸入錯誤的值，或在不重新安裝外掛的情況下更換權杖時，可以參考本指南。以下內容皆根據 Claude Code 官方文件與變更記錄整理。本文未包含原創測試執行。

Ailoot 的使用資訊請參閱[文件](https://ailoot.ai/docs/)。



## 版本 2.1.285 新增了什麼

Claude Code 版本 2.1.285 的變更記錄（提交日期為 2026 年 9 月 29 日）包含幾項外掛相關內容，其中兩項與本文有關：

> 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 工作階段外，透過 shell 或指令碼執行。這也讓你可以在不開啟對話框的情況下執行 `claude plugin configure`。文件未說明此指令在沒有互動式終端機時的行為，也未說明在沒有圖形環境的伺服器上，機密值會儲存於何處。在 CI 中使用前，請先於自己的環境中確認。





## 步驟 1：查看哪些設定已設定

文件要求使用 `name@marketplace` 格式的完整外掛識別碼，如 `claude plugin list` 所示。`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/zh-hant-tw/skills-subagents-mcp-plugins-claude-code/)可協助你選擇擴充功能類型。如果你還沒有選好外掛，可以從Claude Code 十大外掛開始。另有一篇 Telegram 機器人指南：[在 Telegram 代理中安裝外掛](https://ailoot.ai/blog/zh-hant-tw/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 識別碼，也要確認外掛安裝於相關範圍。這個指令不接受只有簡短外掛名稱的寫法。

### 如何檢查修改後的 token，卻不印出內容？

以外掛完整識別碼執行 `claude plugin configure`，確認敏感欄位顯示為 set。儲存後重新啟動 Claude Code，含 token 的 JSON 輸入檔不要提交到 Git。


## Ailoot · 公司及其專案組合

Ailoot以累積的營運經驗、廣大的客戶群、穩定的服務及持續的KPI管理為基礎。

公司及其專案組合：數百萬客戶，每月銷售額達數十億。

Ailoot將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。