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

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

Ailoot 的使用資訊請參閱文件。

版本 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 的名稱。

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 十大外掛開始。另有一篇 Telegram 機器人指南：在 Telegram 代理中安裝外掛的方式與在 Claude Code 中安裝不同。

認識 Ailoot。