discover-plugins.md +0 −651 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# 透過市場探索和安裝預建外掛程式
6
7> 從市場探索和安裝外掛程式，以使用新技能、代理和功能擴展 Claude Code。
8
9外掛程式透過技能、代理、hooks 和 MCP servers 擴展 Claude Code。外掛程式市場是幫助您探索和安裝這些擴展的目錄，無需自己構建它們。
10
11您也可以在 claude.ai 上啟用外掛程式，供自己或透過您的組織使用。Claude Code 會將這些外掛程式同步到您的工作階段中，無需市場安裝，如[從 claude.ai 同步的外掛程式](/docs/zh-TW/plugins-reference#synced-plugins)所述。
12
13想要建立和分發您自己的市場？請參閱[建立和分發外掛程式市場](/docs/zh-TW/plugin-marketplaces)。
14
15<h2 id="how-marketplaces-work">
16 市場如何運作
17</h2>
18
19市場是他人建立和共享的外掛程式目錄。使用市場是一個兩步流程：
20
21<Steps>
22 <Step title="新增市場">
23 這會向 Claude Code 註冊目錄，以便您可以瀏覽可用內容。尚未安裝任何外掛程式。
24 </Step>
25
26 <Step title="安裝個別外掛程式">
27 瀏覽目錄並安裝您想要的外掛程式。
28 </Step>
29</Steps>
30
31<h2 id="official-anthropic-marketplace">
32 官方 Anthropic 市場
33</h2>
34
35Claude Code 在您第一次以互動方式啟動它時會自動新增官方 Anthropic 市場 (`claude-plugins-official`)。如果 Claude Code 無法新增它，例如因為您的網路阻止下載或[市場政策](/docs/zh-TW/plugin-marketplaces#managed-marketplace-restrictions)阻止了之前的嘗試，請使用 `/plugin marketplace add anthropics/claude-plugins-official` 自行新增。
36
37若要瀏覽可用內容，請執行 `/plugin` 並前往 **Discover** 標籤，或在 [claude.com/plugins](https://claude.com/plugins) 查看目錄。
38
39若要從官方市場安裝外掛程式，請使用 `/plugin install <name>@claude-plugins-official`。例如，若要安裝 GitHub 整合：
40
41```shell theme={null}
42/plugin install github@claude-plugins-official
43```
44
45`/plugin` 在終端 CLI 中開啟互動式面板。如果 Claude 回覆在此環境中無法使用 `/plugin`，請使用另一種方式安裝外掛程式：
46
47* **Claude 桌面應用程式**：使用[外掛程式瀏覽器](/docs/zh-TW/desktop#install-plugins)。
48* **VS Code 擴充功能**：從[**管理外掛程式**對話框](/docs/zh-TW/vs-code#manage-plugins)安裝。
49* **雲端工作階段**：啟用外掛程式以供您的 claude.ai 帳戶使用，以便 Claude Code 將其載入為[同步外掛程式](/docs/zh-TW/plugins-reference#synced-plugins)。
50
51如果安裝失敗，請符合 Claude Code 報告的訊息：
52
53* `Marketplace "claude-plugins-official" not found`：使用 `/plugin marketplace add anthropics/claude-plugins-official` 新增市場，然後重試安裝。
54* 外掛程式[在市場中找不到](#install-plugins)：檢查外掛程式名稱。
55
56<Note>
57 官方市場由 Anthropic 維護，包含由 Anthropic 自行決定。應用內提交表單會將外掛程式新增到[社群市場](#community-marketplace)，而不是官方市場。若要獨立分發外掛程式，請[建立您自己的市場](/docs/zh-TW/plugin-marketplaces)並與使用者共享。
58</Note>
59
60官方市場包括多個外掛程式類別：
61
62<h3 id="code-intelligence">
63 程式碼智能
64</h3>
65
66程式碼智能外掛程式啟用 Claude Code 的內建 LSP 工具，使 Claude 能夠跳轉到定義、尋找參考資料，並在編輯後立即查看類型錯誤。這些外掛程式配置[語言伺服器協議](https://microsoft.github.io/language-server-protocol/)連接，這是為 VS Code 程式碼智能提供動力的相同技術。在[雲端工作階段](/docs/zh-TW/claude-code-on-the-web)中，Claude Code 不會啟動外掛程式語言伺服器，因此 Claude 在那裡無法取得 LSP 工具。
67
68在使用這些外掛程式之前，請從下表安裝語言伺服器二進位檔；外掛程式不會為您安裝它。如果您已經安裝了語言伺服器，當您開啟專案時，Claude 可能會提示您安裝相應的外掛程式。
69
70| 語言 | 外掛程式 | 所需的二進位檔 |
71| :--------- | :------------------ | :--------------------------- |
72| C/C++ | `clangd-lsp` | `clangd` |
73| C# | `csharp-lsp` | `csharp-ls` |
74| Go | `gopls-lsp` | `gopls` |
75| Java | `jdtls-lsp` | `jdtls` |
76| Kotlin | `kotlin-lsp` | `kotlin-language-server` |
77| Lua | `lua-lsp` | `lua-language-server` |
78| PHP | `php-lsp` | `intelephense` |
79| Python | `pyright-lsp` | `pyright-langserver` |
80| Rust | `rust-analyzer-lsp` | `rust-analyzer` |
81| Swift | `swift-lsp` | `sourcekit-lsp` |
82| TypeScript | `typescript-lsp` | `typescript-language-server` |
83
84您也可以[為其他語言建立您自己的 LSP 外掛程式](/docs/zh-TW/plugins-reference#lsp-servers)。
85
86<Note>
87 如果在安裝外掛程式後在 `/plugin` Errors 標籤中看到 `Executable not found in $PATH`，請從[程式碼智能](#code-intelligence)表安裝該外掛程式所需的二進位檔。
88</Note>
89
90<h4 id="what-claude-gains-from-code-intelligence-plugins">
91 Claude 從程式碼智能外掛程式獲得的功能
92</h4>
93
94安裝程式碼智能外掛程式並且其語言伺服器二進位檔可用後，Claude 獲得兩項功能：
95
96* **自動診斷**：在 Claude 進行每次檔案編輯後，語言伺服器報告錯誤和警告，因此 Claude 看到類型錯誤、遺漏的匯入和語法問題，無需執行編譯器或 linter。如果 Claude 引入錯誤，它會注意到並在同一輪中修復它。
97* **程式碼導航**：Claude 可以使用語言伺服器跳轉到定義、尋找參考資料、懸停時取得類型資訊、列出符號、尋找實現和追蹤呼叫層次結構。這些操作為 Claude 提供比基於 grep 的搜尋更精確的導航，儘管可用性可能因語言和環境而異。
98
99您不需要超出安裝外掛程式的任何配置來配置診斷。若要自行讀取它們，當 Claude Code 顯示指示器（例如 **Found 3 new diagnostic issues in 2 files**）時，請按 **Ctrl+O**。
100
101如果您遇到問題，請參閱[程式碼智能故障排除](#code-intelligence-issues)。
102
103<h3 id="external-integrations">
104 外部整合
105</h3>
106
107這些外掛程式捆綁預先配置的 [MCP servers](/docs/zh-TW/mcp)，以便您可以連接 Claude 到外部服務，無需手動設定：
108
109* **原始碼控制**：`github`、`gitlab`
110* **專案管理**：`atlassian`（Jira/Confluence）、`asana`、`linear`、`notion`
111* **設計**：`figma`
112* **基礎設施**：`vercel`、`firebase`、`supabase`
113* **通訊**：`slack`
114* **監控**：`sentry`
115
116<h3 id="automatic-security-review">
117 自動安全審查
118</h3>
119
120`security-guidance` 外掛程式審查 Claude 進行的每項變更是否存在常見漏洞，並指示 Claude 在同一工作階段中修復發現的問題。請參閱[在 Claude 編寫程式碼時捕捉安全問題](/docs/zh-TW/security-guidance)以了解它檢查的內容以及如何新增專案特定的規則。
121
122<h3 id="development-workflows">
123 開發工作流程
124</h3>
125
126為常見開發任務新增技能和代理的外掛程式：
127
128* **commit-commands**：Git 提交工作流程，包括提交、推送和 PR 建立
129* **pr-review-toolkit**：用於審查拉取請求的專門代理
130* **agent-sdk-dev**：使用 Claude Agent SDK 構建的工具
131* **plugin-dev**：建立您自己的外掛程式的工具組
132
133<h3 id="output-styles">
134 輸出樣式
135</h3>
136
137自訂 Claude 的回應方式：
138
139* **explanatory-output-style**：關於實現選擇的教育見解
140* **learning-output-style**：用於技能建立的互動式學習模式
141
142<h2 id="community-marketplace">
143 社群市場
144</h2>
145
146位於 [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) 的社群市場託管已通過 Anthropic 自動驗證和安全篩選的第三方外掛程式。每個外掛程式都固定到目錄中的特定提交 SHA。與官方市場不同，您需要手動新增它：
147
148```shell theme={null}
149/plugin marketplace add anthropics/claude-plugins-community
150```
151
152然後使用 `claude-community` 市場名稱從中安裝外掛程式：
153
154```shell theme={null}
155/plugin install <plugin-name>@claude-community
156```
157
158若要將您自己的外掛程式提交到社群市場，請參閱建立外掛程式指南中的[將您的外掛程式提交到社群市場](/docs/zh-TW/plugins#submit-your-plugin-to-the-community-marketplace)。
159
160<h2 id="try-it-add-the-demo-marketplace">
161 試試看：新增演示市場
162</h2>
163
164Anthropic 也維護一個[演示外掛程式市場](https://github.com/anthropics/claude-code/tree/main/plugins)（`claude-code-plugins`），其中包含展示外掛程式系統可能性的範例外掛程式。與官方市場不同，您需要手動新增此市場。
165
166<Steps>
167 <Step title="新增市場">
168 在 Claude Code 中，為 `anthropics/claude-code` 市場執行 `plugin marketplace add` 命令：
169
170 ```shell theme={null}
171 /plugin marketplace add anthropics/claude-code
172 ```
173
174 這會下載市場目錄並使其外掛程式可供您使用。
175 </Step>
176
177 <Step title="瀏覽可用外掛程式">
178 執行 `/plugin` 以開啟外掛程式管理器。這會開啟一個標籤式介面，您可以使用 **Tab** 或 **Shift+Tab** 向後循環瀏覽：
179
180 * **Discover**：從所有市場瀏覽可用外掛程式
181 * **Installed**：檢視和管理已安裝的外掛程式
182 * **Marketplaces**：新增、移除或更新已新增的市場
183 * **Errors**：檢視任何外掛程式載入錯誤
184 * **Stats**：查看[您每個 skills 在內容中的成本以及使用頻率](/docs/zh-TW/skills#find-unused-skills)，在有 `/skill-doctor` 可用的工作階段中
185
186 前往 **Discover** 標籤以查看您剛新增的市場中的外掛程式。當您的管理員已透過 [`pluginSuggestionMarketplaces`](/docs/zh-TW/settings-reference#pluginsuggestionmarketplaces) 受管設定將市場加入允許清單時，標記為與您目前工作目錄相關的外掛程式會釘在頂部，並帶有 **suggested for this directory** 標籤。
187 </Step>
188
189 <Step title="安裝外掛程式">
190 選擇外掛程式以檢視其詳細資訊。詳細資訊窗格會顯示外掛程式包含的內容及其成本：
191
192 * **Context cost** 估計，讓您可以查看外掛程式每回合會為您的[內容視窗](/docs/zh-TW/features-overview#understand-context-costs)新增多少個 token
193 * 外掛程式的 **Last updated** 日期
194 * **Will install** 區段，列出外掛程式的命令、代理程式、skills、hooks 和 MCP 及 LSP 伺服器，讓您可以在安裝前檢視它新增的確切內容
195
196 並非每個外掛程式都提供這些欄位背後的資料。對於來自本機或自訂市場的外掛程式，您可能看不到 **Context cost** 和 **Last updated** 列，**Will install** 區段可能會改為顯示 **Components will be discovered at installation**。
197
198 選擇安裝範圍：
199
200 * **User scope**：在所有專案中為自己安裝
201 * **Project scope**：為此儲存庫上的所有協作者安裝
202 * **Local scope**：僅在此儲存庫中為自己安裝
203
204 例如，選擇 **commit-commands**（新增 git 工作流程 skills 的外掛程式）並將其安裝到您的使用者範圍。
205
206 您也可以直接從命令列開始安裝：
207
208 ```shell theme={null}
209 /plugin install commit-commands@claude-code-plugins
210 ```
211
212 請參閱[設定檔](/docs/zh-TW/settings#where-settings-live)以深入瞭解範圍。
213 </Step>
214
215 <Step title="使用您的新外掛程式">
216 如果安裝摘要報告 `Run /reload-plugins to activate.`，Claude Code 會為您執行該重新載入。如果重新載入警告您的下一則訊息會重新讀取對話，請執行 `/reload-plugins --force` 以啟用外掛程式。
217
218 外掛程式 skills 由外掛程式名稱命名空間，因此 **commit-commands** 提供 `/commit-commands:commit` 之類的 skills。
219
220 透過對檔案進行變更並執行以下命令來試試看：
221
222 ```shell theme={null}
223 /commit-commands:commit
224 ```
225
226 這會暫存您的變更、產生提交訊息並建立提交。
227
228 每個外掛程式的工作方式不同。檢查 **Discover** 標籤中的外掛程式詳細資訊以查看它提供的命令和 skills，或造訪其首頁以取得使用指導。
229 </Step>
230</Steps>
231
232<h2 id="add-marketplaces">
233 新增市場
234</h2>
235
236使用 `/plugin marketplace add` 命令從不同來源新增市場。
237
238<Tip>
239 **快捷方式**：您可以使用 `/plugin market` 代替 `/plugin marketplace`，以及 `rm` 代替 `remove`。
240</Tip>
241
242* **GitHub 儲存庫**：`owner/repo` 格式，例如 `anthropics/claude-code`
243* **Git URL**：任何 git 儲存庫 URL，包括 GitLab、Bitbucket 和自託管伺服器
244* **本機路徑**：目錄或 `marketplace.json` 檔案的直接路徑
245* **遠端 URL**：託管 `marketplace.json` 檔案的直接 URL
246* **claude.ai**：託管在 claude.ai 上的市場（適用於您的帳戶），例如您組織的外掛程式庫，您可以[從 **Marketplaces** 標籤或您的 shell 按名稱新增](#add-from-claude-ai)，而不是按來源新增
247
248<h3 id="add-from-github">
249 從 GitHub 新增
250</h3>
251
252使用 `owner/repo` 格式新增包含 `.claude-plugin/marketplace.json` 檔案的 GitHub 儲存庫，其中 `owner` 是 GitHub 使用者名稱或組織，`repo` 是儲存庫名稱。
253
254例如，`anthropics/claude-code` 指的是由 `anthropics` 擁有的 `claude-code` 儲存庫：
255
256```shell theme={null}
257/plugin marketplace add anthropics/claude-code
258```
259
260<h3 id="add-from-other-git-hosts">
261 從其他 Git 主機新增
262</h3>
263
264透過提供完整 URL 新增 git 市場儲存庫。對於 `https://` URL，是否包含 `.git` 後綴取決於主機：
265
266* **`github.com` 和 `gitlab.com`**：Claude Code 可識別帶有或不帶 `.git` 後綴的儲存庫 URL，並複製它。新增不帶後綴的 `gitlab.com` URL 需要 Claude Code v2.1.232 或更新版本。在 v2.1.232 之前，Claude Code 將其視為託管 `marketplace.json` 檔案的直接連結。
267* **Azure DevOps**：省略後綴。Claude Code 複製任何路徑包含 `/_git/` 的 URL。如果您在 `/_git/` 路徑後面附加 `.git`，複製會失敗。
268* **所有其他主機，包括自託管 GitLab 伺服器**：包含 `.git` 後綴，以便 Claude Code 複製儲存庫，而不是將 URL 視為託管 `marketplace.json` 檔案的直接連結。對於複製 URL 不帶後綴的主機（例如 AWS CodeCommit），請改為在 [`extraKnownMarketplaces`](/docs/zh-TW/settings-reference#extraknownmarketplaces) 中新增市場作為 git 項目。Claude Code 複製 git 項目時，無論其 URL 是否以 `.git` 結尾。
269
270Claude Code 也複製具有巢狀子群組的 `gitlab.com` URL，例如 `https://gitlab.com/group/subgroup/project`。
271
272包含 `https://` 前綴。Claude Code v2.1.196 及更新版本會拒絕沒有前綴的主機，例如 `gitlab.com/company/plugins.git`，視其為無效的 GitHub `owner/repo` 簡寫，錯誤訊息會告訴您新增前綴。較早的版本會將其誤讀為 GitHub 儲存庫路徑，並在複製時失敗。
273
274使用 HTTPS：
275
276```shell theme={null}
277/plugin marketplace add https://gitlab.com/company/plugins.git
278```
279
280使用 SSH：
281
282```shell theme={null}
283/plugin marketplace add git@gitlab.com:company/plugins.git
284```
285
286Claude Code 複製 SSH 位址時，無論是否以 `.git` 結尾。
287
288若要新增特定分支或標籤，請在 `#` 後面附加 ref：
289
290```shell theme={null}
291/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
292```
293
294<h3 id="add-from-local-paths">
295 從本機路徑新增
296</h3>
297
298新增包含 `.claude-plugin/marketplace.json` 檔案的本機目錄：
299
300```shell theme={null}
301/plugin marketplace add ./my-marketplace
302```
303
304您也可以新增 `marketplace.json` 檔案的直接路徑：
305
306```shell theme={null}
307/plugin marketplace add ./path/to/marketplace.json
308```
309
310<h3 id="add-from-remote-urls">
311 從遠端 URL 新增
312</h3>
313
314透過 URL 新增遠端 `marketplace.json` 檔案：
315
316```shell theme={null}
317/plugin marketplace add https://example.com/marketplace.json
318```
319
320<Note>
321 與基於 Git 的市場相比，基於 URL 的市場有一些限制。如果從基於 URL 的市場安裝外掛程式失敗，請參閱[故障排除](/docs/zh-TW/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces)。
322</Note>
323
324<h3 id="add-from-claude-ai">
325 從 claude.ai 新增
326</h3>
327
328在[外掛程式從您的 claude.ai 帳戶同步](/docs/zh-TW/plugins-reference#synced-plugins)的終端機工作階段中，claude.ai 也可以為您列出市場，例如您組織的外掛程式庫和您自己的 claude.ai 上傳。`claude plugin marketplace list` 會在 `From claude.ai:` 區段中列印它們，而 `/plugin` **Marketplaces** 標籤也會列出它們。在那裡選擇一個以新增它。從 claude.ai 新增市場需要 Claude Code v2.1.273 或更新版本。
329
330若要從您的 shell 新增一個，請執行 `claude plugin marketplace add` 並使用 `--claudeai` 旗標和列表中顯示的名稱：
331
332```bash theme={null}
333claude plugin marketplace add --claudeai claudeai-organization-library
334```
335
336Claude Code 會在以 `claudeai-` 開頭的本機名稱下註冊市場，該名稱衍生自 claude.ai 列出的名稱：列為「Organization library」的市場會註冊為 `claudeai-organization-library`。使用該名稱安裝其外掛程式，例如使用 `claude plugin install <plugin>@claudeai-organization-library`。
337
338如果您登出或使用不同帳戶登入，市場會保持設定但不顯示任何外掛程式，而您已從中安裝的外掛程式會繼續載入。
339
340`From claude.ai:` 區段也可以列出透過 claude.ai 共享的基於 git 的市場。您可以使用普通的 `marketplace add` 命令新增這些市場，使用列表列印的來源。
341
342<h2 id="install-plugins">
343 安裝外掛程式
344</h2>
345
346新增市場後，您可以按名稱安裝外掛程式。對於您尚未新增的市場，您可以改為[在一個命令中新增並安裝](#add-a-marketplace-and-install-in-one-command)。
347
348若要按名稱安裝：
349
350```shell theme={null}
351/plugin install plugin-name@marketplace-name
352```
353
354該命令會開啟該外掛程式的詳細資訊，您可以在其中選擇[安裝範圍](/docs/zh-TW/settings#where-settings-live)。當您執行 `/plugin`、前往 **Discover** 標籤，並在外掛程式上按 **Enter** 時，您會看到相同的選項：
355
356* **User scope**：在所有專案中為自己安裝
357* **Project scope**：為此儲存庫上的所有協作者安裝，這會將外掛程式新增到 `.claude/settings.json`
358* **Local scope**：僅在此儲存庫中為自己安裝，不與協作者共享
359
360若要在沒有互動式步驟的情況下安裝，請使用 [`claude plugin install`](/docs/zh-TW/plugins-reference#plugin-install) shell 命令，該命令預設安裝到使用者範圍，除非您傳遞 `--scope`。對於具有[`command` 來源](/docs/zh-TW/plugin-marketplaces#how-users-accept-the-command)的外掛程式，傳遞 `--yes` 以接受它顯示的命令。
361
362您也可能看到具有 **managed** 範圍的外掛程式。這些是由管理員透過[受管設定](/docs/zh-TW/managed-settings)安裝的，無法修改。
363
364Claude Code 在其本地市場目錄副本中查詢外掛程式。您命名外掛程式的方式控制 Claude Code 是否先重新整理該副本：
365
366* **使用市場名稱**：當您安裝 `plugin-name@marketplace-name` 時，在工作階段中或使用 `claude plugin install` 時，Claude Code 會在查詢前重新整理該市場。即使您關閉了市場的[自動更新](#configure-auto-updates)或設定了 `DISABLE_AUTOUPDATER`，Claude Code 也會執行重新整理。在 v2.1.232 之前，Claude Code 在查詢前不會重新整理市場。Claude Code 在以下情況下會跳過此重新整理：
367 * 市場未[從 GitHub、其他 Git 主機、遠端 URL](#add-marketplaces)或 [claude.ai](#add-from-claude-ai) 新增。
368 * [種子目錄](/docs/zh-TW/plugin-marketplaces#pre-populate-plugins-for-containers)提供市場。
369 * Claude Code 在過去 30 秒內重新整理了市場。
370 * 您設定了 [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/zh-TW/env-vars)。
371 * [受管設定](/docs/zh-TW/plugin-marketplaces#managed-marketplace-restrictions)阻止市場，在這種情況下 Claude Code 也會拒絕安裝。
372* **僅外掛程式名稱**：當您在工作階段中執行 `/plugin install plugin-name` 時，Claude Code 只會重新整理它也在[背景更新](#configure-auto-updates)的市場，且僅在查詢失敗後。當您執行 `claude plugin install plugin-name` 時，Claude Code 會讀取快取的目錄而不重新整理。若要安裝在上次重新整理後發佈的外掛程式，請在工作階段中執行 `/plugin marketplace update <marketplace-name>` 或在您的 shell 中執行 [`claude plugin marketplace update <marketplace-name>`](/docs/zh-TW/plugin-marketplaces#plugin-marketplace-update)，然後重試安裝。
373
374如果命名安裝前的重新整理失敗，例如因為您離線，Claude Code 仍會在快取目錄中查詢外掛程式。`claude plugin install` 在其成功訊息中報告 `marketplace not refreshed`，而 `/plugin install` 在外掛程式詳細資訊上方或其找不到訊息中顯示失敗。
375
376當您從 `/plugin` 介面安裝時，安裝摘要會告訴您外掛程式在您目前工作階段中是否為作用中：
377
378* `Plugin is now active.`：Claude Code 在安裝過程中啟動了外掛程式。
379* `Run /reload-plugins to activate.`：外掛程式尚未作用中，因為啟動它會[使提示快取失效](/docs/zh-TW/prompt-caching#enabling-or-disabling-a-plugin)或因為啟動嘗試失敗。Claude Code 接著會為您執行 `/reload-plugins`。如果該重新載入警告提示快取，請執行 `/reload-plugins --force` 以[在不重新啟動的情況下啟動外掛程式](#apply-plugin-changes-without-restarting)。
380* 如果外掛程式無法載入，摘要會報告失敗，而 `/plugin` **Errors** 標籤會顯示詳細資訊。
381
382在 v2.1.221 之前，在您執行 `/reload-plugins` 或重新啟動之前，沒有安裝在目前工作階段中生效。
383
384`claude plugin install` shell 命令不在工作階段中執行，因此 Claude Code 會在您下次啟動 Claude Code 時或在已開啟的工作階段中執行 `/reload-plugins` 時載入它安裝的外掛程式。
385
386<Warning>
387 在安裝外掛程式之前，請確保您信任它。Anthropic 不控制外掛程式中包含的 MCP servers、檔案或其他軟體，也無法驗證它們是否按預期工作。檢查每個外掛程式的首頁以獲取更多資訊。
388</Warning>
389
390<h3 id="add-a-marketplace-and-install-in-one-command">
391 在一個命令中新增市場並安裝
392</h3>
393
394若要從您尚未新增的市場安裝外掛程式，請使用 `--marketplace` 命名市場來源。需要 Claude Code v2.1.275 或更新版本。
395
396```shell theme={null}
397/plugin install quality-review-plugin --marketplace your-org/plugins
398```
399
400來源採用[與 `/plugin marketplace add` 相同的形式](#add-marketplaces)，例如 GitHub `owner/repo`、git URL 或本地路徑，除了它不能包含空格。給出外掛程式名稱時不帶 `@marketplace` 後綴。
401
402Claude Code 會顯示它解析的來源，並要求您在新增市場前確認。拒絕會取消安裝並不新增任何內容。市場新增後，外掛程式的詳細資訊會開啟，您可以選擇[安裝範圍](/docs/zh-TW/settings#where-settings-live)。如果來源符合您已新增的市場，Claude Code 會跳過確認並在該市場中開啟外掛程式的詳細資訊。
403
404<h2 id="manage-installed-plugins">
405 管理已安裝的外掛程式
406</h2>
407
408執行 `/plugin` 並前往 **Installed** 標籤以檢視、啟用、停用或解除安裝外掛程式。清單按範圍分組，並排序以便您首先看到問題：具有載入錯誤或未解決依賴項的外掛程式出現在頂部，然後是您的最愛，停用的外掛程式摺疊在底部的摺疊標題後面。
409
410從清單中，您可以：
411
412* 按 `f` 以將選定的外掛程式加入最愛或取消加入最愛
413* 輸入以按外掛程式名稱或描述篩選
414* 按 Enter 以開啟外掛程式的詳細檢視並啟用、停用或解除安裝它
415
416Claude Code 也會在 **Installed** 標籤中列出[從您的 claude.ai 帳戶同步的外掛程式](/docs/zh-TW/plugins-reference#synced-plugins)，其來源為 `synced`。除非您的組織將其標記為必需，否則您可以在那裡啟用或停用一個。若要移除一個，請在 claude.ai 上將其關閉。同步的外掛程式會出現在 Claude Code v2.1.273 或更新版本的終端工作階段中。
417
418當您解除安裝專案的 `.claude/settings.json` 啟用的外掛程式時，Claude Code 會詢問您指的是哪個範圍：僅為您停用它，這會將覆寫寫入您的 `.claude/settings.local.json` 並為專案保留已安裝的外掛程式，或為所有人解除安裝它，這會將其從共用的 `.claude/settings.json` 中移除。
419
420詳細檢視會顯示外掛程式貢獻的元件：commands、skills、agents、hooks、MCP servers 和 LSP servers。相同的清單也可從命令列透過 `claude plugin details` 取得。
421
422Claude Code 也會在 **Installed** 標籤中的 **Not used recently** 標題下列出您自己安裝但至少兩週內未使用且跨越至少 10 個工作階段的 marketplace 外掛程式。詳細檢視會為每個外掛程式顯示 **Last used** 行。使用這些功能來找出您不再使用但仍在增加啟動和內容成本的外掛程式，然後停用或解除安裝它們。
423
424兩種外掛程式永遠不會列為未使用：
425
426* 您的組織管理的外掛程式或您使用 `--plugin-dir` 載入的外掛程式
427* 貢獻 theme、output style、monitor 或 workflow 的外掛程式，因為這些外掛程式提供價值而無需追蹤叫用
428
429當您的組織使用 [`strictKnownMarketplaces`](/docs/zh-TW/settings-reference#strictknownmarketplaces) 限制 marketplaces 時，**Not used recently** 標題和 **Last used** 行都會隱藏。
430
431外掛程式的 [language server](/docs/zh-TW/plugins#add-lsp-servers-to-your-plugin) 在提供診斷或回答程式碼導覽請求時計為已使用，因此其伺服器在您的工作階段中處於活動狀態的 LSP 外掛程式不會列為未使用。在 v2.1.203 之前，無法將語言伺服器活動計為使用，因此貢獻 LSP 伺服器的外掛程式完全豁免於該群組，與 theme 和 output style 外掛程式的方式相同。
432
433在計算語言伺服器活動的版本上的第一個工作階段也會重設每個尚未記錄任何使用的 LSP 外掛程式的使用記錄，因此 Claude Code 不會根據在其伺服器活動被追蹤之前記錄的資料將您較早安裝的外掛程式判斷為未使用。
434
435當您安裝聲明依賴項的外掛程式時，安裝輸出會列出哪些依賴項與其一起自動安裝。
436
437您也可以使用直接命令管理外掛程式：
438
439* 當您執行 `/plugin disable`、`/plugin enable` 或 `/plugin uninstall` 時，Claude Code 會開啟外掛程式面板以套用變更並保持其開啟。按 **Esc** 以在輸入另一個命令之前關閉面板。[在不重新啟動的情況下套用外掛程式變更](#apply-plugin-changes-without-restarting)說明變更在您的工作階段中何時生效。
440* 對於指令碼編寫，請改用 `claude plugin` shell 命令，這些命令不會開啟面板。
441
442列出已安裝的外掛程式而不開啟選單：
443
444```shell theme={null}
445/plugin list
446```
447
448傳遞 `--enabled` 或 `--disabled` 以僅顯示處於該狀態的外掛程式。
449
450停用外掛程式而不解除安裝：
451
452```shell theme={null}
453/plugin disable plugin-name@marketplace-name
454```
455
456重新啟用已停用的外掛程式：
457
458```shell theme={null}
459/plugin enable plugin-name@marketplace-name
460```
461
462在這些識別碼中，`plugin-name` 是 [marketplace 項目](/docs/zh-TW/plugin-marketplaces#plugin-entries) 中外掛程式的 `name`，可能與外掛程式自身 `plugin.json` 中的 `name` 不同。
463
464自 Claude Code v2.1.195 起，`/plugin` 介面中的 **Enable** 和 **Disable** 適用於其兩個名稱不同的外掛程式，`/plugin enable` 和 `/plugin disable` 接受任一名稱。當您在較早版本中停用此類外掛程式時，Claude Code 會報告 `already disabled` 並保持其啟用狀態。
465
466完全移除外掛程式：
467
468```shell theme={null}
469/plugin uninstall plugin-name@marketplace-name
470```
471
472`--scope` 選項可讓您使用 CLI 命令針對特定範圍：
473
474```shell theme={null}
475claude plugin install formatter@your-org --scope project
476claude plugin uninstall formatter@your-org --scope project
477```
478
479<h3 id="apply-plugin-changes-without-restarting">
480 在不重新啟動的情況下套用外掛程式變更
481</h3>
482
483當您關閉 `/plugin` 選單時，Claude Code 會為您執行 `/reload-plugins` 以套用您在其中所做的變更，例如安裝、啟用、停用和解除安裝外掛程式。如果重新載入會[使提示快取失效](/docs/zh-TW/prompt-caching#enabling-or-disabling-a-plugin)，它會發出警告並改為保留變更待處理；執行 `/reload-plugins --force` 以無論如何套用它們。如果 Claude 在您關閉選單時仍在回應，重新載入會在回應完成後執行。
484
485對於在選單外發生的外掛程式變更，請自行執行 `/reload-plugins`。這些變更包括：
486
487* 您在另一個終端中執行的 `claude plugin` 命令
488* 您在開發時使用 [`--plugin-dir`](/docs/zh-TW/plugins#test-your-plugins-locally) 載入的外掛程式編輯
489* 外掛程式[自動更新](#configure-auto-updates)，其通知要求您重新載入
490* [從您的 claude.ai 帳戶同步](/docs/zh-TW/plugins-reference#synced-plugins)，已新增、更新或移除外掛程式並顯示要求您重新載入的通知
491* [`--plugin-dir` 資料夾](/docs/zh-TW/plugins#test-your-plugins-locally)中的變更，Claude Code 保留該變更是因為套用它會使提示快取失效
492
493在 v2.1.268 之前，您在選單中啟用、停用或解除安裝的外掛程式，以及在安裝期間未啟動的安裝，會保持待處理狀態，直到您執行 `/reload-plugins`。
494
495`/reload-plugins` 也在沒有互動式終端的工作階段中執行，例如桌面應用程式、Agent SDK 和[非互動模式](/docs/zh-TW/headless)（使用 `-p`）。需要 Claude Code v2.1.260 或更新版本。在這些工作階段中適用兩個限制：
496
497* 命令僅在您直接將其輸入到工作階段時執行，例如在 `-p` 提示或桌面應用程式的提示框中。當您改為透過遠端連線傳送它時，例如 [Remote Control](/docs/zh-TW/remote-control) 或轉接的聊天訊息，命令會拒絕而不重新載入任何內容。
498* 重新載入不會連線或斷開外掛程式 MCP servers。這些變更會在您的下一個工作階段中生效。
499
500Claude Code 重新載入所有活動外掛程式，並顯示外掛程式、skills、agents、hooks、外掛程式 MCP servers 和外掛程式 LSP servers 的計數，在沒有互動式終端的工作階段中省略外掛程式 MCP server 計數。在 skills 計數中，Claude Code 包括外掛程式提供的每個 skill：其 `commands/` 項目和 `SKILL.md` skills。在 v2.1.246 之前，Claude Code 僅計算 `commands/` 項目，因此它可以重新載入外掛程式的 `SKILL.md` skills 並仍然在摘要中報告 `0 skills`。
501
502重新載入在下一個請求時會產生令牌成本：新載入的元件會在附加到對話的內容中宣佈自己，而現有歷史記錄仍然從提示快取讀取。提供 MCP servers 的外掛程式在其工具未被 [tool search](/docs/zh-TW/mcp#scale-with-mcp-tool-search) 延遲時成本更高：該變更會使快取失效，下一個請求會重新讀取整個對話。請參閱[啟用或停用外掛程式](/docs/zh-TW/prompt-caching#enabling-or-disabling-a-plugin)以取得詳細資訊。
503
504<h2 id="manage-marketplaces">
505 管理市場
506</h2>
507
508您可以透過互動式 `/plugin` 介面或使用 CLI 命令管理市場。
509
510<h3 id="use-the-interactive-interface">
511 使用互動式介面
512</h3>
513
514執行 `/plugin` 並前往 **Marketplaces** 標籤以：
515
516* 檢視所有已新增的市場及其來源和狀態
517* 新增新市場
518* 更新市場清單以取得最新外掛程式
519* 移除您不再需要的市場
520
521<h3 id="use-cli-commands">
522 使用 CLI 命令
523</h3>
524
525您也可以使用直接命令管理市場。
526
527列出所有已配置的市場：
528
529```shell theme={null}
530/plugin marketplace list
531```
532
533從市場重新整理外掛程式清單：
534
535```shell theme={null}
536/plugin marketplace update marketplace-name
537```
538
539移除市場：
540
541```shell theme={null}
542/plugin marketplace remove marketplace-name
543```
544
545<Warning>
546 移除市場將解除安裝您從中安裝的任何外掛程式。
547</Warning>
548
549<h3 id="configure-auto-updates">
550 配置自動更新
551</h3>
552
553Claude Code 可以在啟動後自動在背景更新市場及其已安裝的外掛程式。為市場啟用自動更新後，Claude Code 會重新整理市場資料並將已安裝的外掛程式更新到其磁碟上的最新版本。
554
555Claude Code 會在您的工作階段開始後檢查市場和外掛程式更新，並隨機延遲最多十分鐘，因此執行中的工作階段會繼續使用它在啟動時載入的版本。如果任何外掛程式已更新，您將看到提示您執行 `/reload-plugins` 的通知，或新版本會在您下次啟動時載入。
556
557自動更新也會排除其市場項目宣告 `headersHelper` 的外掛程式：Claude Code [既不執行命令也不下載該路徑上的封存](/docs/zh-TW/plugin-marketplaces#installs-and-updates-that-refuse-the-command-instead-of-asking)；該部分說明 Claude Code 何時在 `/plugin` Errors 標籤中列出外掛程式，以便您可以從其自己的檢視中更新它。
558
559Claude Code 更新具有[`command` 來源](/docs/zh-TW/plugin-marketplaces#command-sources)的外掛程式，其節奏與市場自動更新設定和 `DISABLE_AUTOUPDATER` 分開。相反，它[每個工作階段重新執行一次命令](/docs/zh-TW/plugin-marketplaces#when-claude-code-re-runs-the-command)，並在其[雜湊](/docs/zh-TW/plugins-reference#version-management)已變更時將輸出安裝為新的外掛程式版本。
560
561透過 UI 為個別市場切換自動更新：
562
5631. 執行 `/plugin` 以開啟外掛程式管理器
5642. 選擇 **Marketplaces**
5653. 從清單中選擇市場
5664. 選擇 **Enable auto-update** 或 **Disable auto-update**
567
568`claude-plugins-official`、大多數其他官方 Anthropic 市場，以及[從 claude.ai 新增的市場](#add-from-claude-ai)預設啟用自動更新。其他第三方市場和本機開發市場預設停用自動更新。
569
570管理員也可以在受管設定中的每個 [`extraKnownMarketplaces`](/docs/zh-TW/settings-reference#extraknownmarketplaces) 項目上設定 `"autoUpdate": true`，以為組織市場啟用自動更新，而無需每個使用者都切換它。
571
572若要停用 Claude Code 和從市場取得的外掛程式的自動更新，請設定 `DISABLE_AUTOUPDATER` 環境變數。具有[`command` 來源](/docs/zh-TW/plugin-marketplaces#command-sources)的外掛程式遵循其自己的每個工作階段一次重新解析。如需詳細資訊，請參閱[自動更新](/docs/zh-TW/setup#auto-updates)。
573
574若要在停用 Claude Code 自動更新的同時保持外掛程式自動更新啟用，請設定 `FORCE_AUTOUPDATE_PLUGINS=1` 以及 `DISABLE_AUTOUPDATER`：
575
576```bash theme={null}
577export DISABLE_AUTOUPDATER=1
578export FORCE_AUTOUPDATE_PLUGINS=1
579```
580
581<h2 id="configure-team-marketplaces">
582 配置團隊市場
583</h2>
584
585團隊管理員可以透過將市場配置新增到 `.claude/settings.json` 來為專案設定自動市場安裝。當團隊成員[信任儲存庫資料夾](/docs/zh-TW/permissions#what-runs-before-you-trust-a-folder)後，Claude Code 會自動新增這些市場，無需進一步提示。
586
587自 Claude Code v2.1.195 起，新增市場不會安裝來自外部來源的外掛程式，在任何載入外掛程式的路徑上都是如此。只有專案的 `.claude/settings.json` 啟用的外掛程式，且來自外部來源（例如 GitHub 儲存庫或 npm 套件），在團隊成員安裝之前不會載入。在此之前，Claude Code 會將外掛程式報告為未安裝，並顯示要執行的 `claude plugin install` 命令。
588
589將 `extraKnownMarketplaces` 新增到您的專案的 `.claude/settings.json`：
590
591```json theme={null}
592{
593 "extraKnownMarketplaces": {
594 "my-team-tools": {
595 "source": {
596 "source": "github",
597 "repo": "your-org/claude-plugins"
598 }
599 }
600 }
601}
602```
603
604如需完整配置選項（包括 `extraKnownMarketplaces` 和 `enabledPlugins`），請參閱[外掛程式設定](/docs/zh-TW/settings-reference#plugin-settings)。
605
606<h2 id="security">
607 安全性
608</h2>
609
610外掛程式和市場是高度受信任的元件，可以使用您的使用者權限在您的機器上執行任意程式碼。僅從您信任的來源安裝外掛程式和新增市場。組織可以使用[受管市場限制](/docs/zh-TW/plugin-marketplaces#managed-marketplace-restrictions)限制使用者可以新增的市場。
611
612<h2 id="troubleshooting">
613 故障排除
614</h2>
615
616<h3 id="/plugin-command-not-recognized">
617 /plugin 命令無法識別
618</h3>
619
620如果您看到「未知命令」或 `/plugin` 命令未出現：
621
6221. **檢查您的版本**：執行 `claude --version` 以查看已安裝的內容。
6232. **更新 Claude Code**：
624 * **Homebrew**：`brew upgrade claude-code`，或如果您安裝了該 cask，執行 `brew upgrade claude-code@latest`
625 * **npm**：`npm install -g @anthropic-ai/claude-code@latest`
626 * **原生安裝程式**：從[設定](/docs/zh-TW/setup)重新執行安裝命令
6273. **重新啟動 Claude Code**：更新後，重新啟動您的終端機並再次執行 `claude`。
628
629<h3 id="common-issues">
630 常見問題
631</h3>
632
633如果 plugin skills 未出現，使用 `rm -rf ~/.claude/plugins/cache` 清除快取，重新啟動 Claude Code，然後重新安裝 plugin。
634
635如需詳細的故障排除和解決方案，請參閱市場指南中的[故障排除](/docs/zh-TW/plugin-marketplaces#troubleshooting)。如需偵錯工具，請參閱[偵錯和開發工具](/docs/zh-TW/plugins-reference#debugging-and-development-tools)。
636
637<h3 id="code-intelligence-issues">
638 程式碼智能問題
639</h3>
640
641* **語言伺服器未啟動**：驗證二進位檔已安裝且在您的 `$PATH` 中可用。檢查 `/plugin` Errors 標籤以獲取詳細資訊。
642* **高記憶體使用量**：`rust-analyzer` 和 `pyright` 等語言伺服器在大型專案上可能會消耗大量記憶體。如果您遇到記憶體問題，請使用 `/plugin disable <plugin-name>` 停用外掛程式，並改為依賴 Claude 的內建搜尋工具。
643* **monorepos 中的誤報診斷**：如果工作區配置不正確，語言伺服器可能會報告內部套件的未解決匯入錯誤。這些不會影響 Claude 編輯程式碼的能力。
644
645<h2 id="next-steps">
646 後續步驟
647</h2>
648
649* **構建您自己的外掛程式**：請參閱[外掛程式](/docs/zh-TW/plugins)以建立技能、代理和 hooks
650* **建立市場**：請參閱[建立外掛程式市場](/docs/zh-TW/plugin-marketplaces)以將外掛程式分發給您的團隊或社群
651* **技術參考**：請參閱[外掛程式參考](/docs/zh-TW/plugins-reference)以取得完整規格