<name>。
無論您是安裝外掛程式、建置外掛程式、託管市集，還是為組織管理外掛程式，都可以使用此頁面。
搜尋您看到的確切訊息。每個訊息都列在產生它的階段下，這不一定是您執行的命令。例如，安裝可能因為市集遺失而失敗，所以該訊息在 新增市集 下。
找到 /plugin 執行的位置
/plugin 是您在執行中的 Claude Code 終端機工作階段內輸入的命令，它會開啟互動式面板。本節中的條目涵蓋您可以輸入它但它無法執行的位置，以及不存在的命令拼寫。
/plugin isn't available in this environment
您在 Claude Code 終端機工作階段以外的地方輸入了 /plugin，Claude 回覆了這一行，而不是開啟任何東西。
您會在沒有終端機來繪製 /plugin 面板的工作階段中收到此回覆：非互動模式，使用 claude -p、Agent SDK、Claude 桌面應用程式的 Code 標籤、VS Code 擴充功能面板，以及 claude.ai/code 上的瀏覽器。
在 VS Code 擴充功能面板中，只有 /plugin 行後面跟著某些內容（例如 /plugin install <plugin>@<marketplace>）會收到此回覆。單獨輸入 /plugin 或 /plugins 會開啟 管理外掛程式 對話框。
改為從您所在的表面安裝外掛程式：
- Claude 桌面應用程式、本機或 SSH 工作階段：按一下提示旁邊的 + 按鈕，然後按 外掛程式，然後按 新增外掛程式 以開啟 外掛程式瀏覽器
- VS Code 擴充功能：使用 安裝外掛程式 下的 VS Code 標籤
- 網路上的 Claude Code，或桌面雲端工作階段：雲端工作階段沒有外掛程式瀏覽器。請參閱 安裝外掛程式 下的 雲端工作階段 標籤，了解雲端工作階段載入的內容
- 您有權存取的終端機：執行
claude並在那裡輸入/plugin，或在您的 shell 中執行claude plugin install <plugin>@<marketplace>，而不啟動工作階段
/plugin 會列印以 ✓ Installed <plugin>. 開頭的安裝摘要，而 claude plugin install 會列印 Successfully installed plugin: <plugin>@<marketplace>。
zsh: no such file or directory: /plugin
您在 shell 提示符處輸入了 /plugin ...，shell 報告不存在名為 /plugin 的檔案。Bash 報告 bash: /plugin: No such file or directory。
/plugin 是您在 Claude Code 工作階段內輸入的命令，而不是在 shell 提示符處。啟動工作階段並在那裡輸入相同的命令：
✓ Installed <plugin>. 開頭的摘要。如果安裝本身隨後失敗，其訊息在 新增市集 或 安裝外掛程式 下。
若要從 shell 安裝而不啟動工作階段，請改為執行 claude plugin install <plugin>@<marketplace>。
The term '/plugin' is not recognized as the name of a cmdlet
您在 PowerShell 提示符處輸入了 /plugin ...，而 /plugin 是 Claude Code 命令，不是程式。Bash 和 Zsh 報告 它們自己的這個錯誤形式。
改為使用以下任一方式：
- 執行
claude，然後在 Claude Code 提示符處輸入/plugin - 在 PowerShell 中執行
claude plugin install <plugin>@<marketplace>，而不啟動工作階段
claude: command not found after claude plugin ...
您在 shell 中執行了 claude plugin install ...，shell 根本找不到 claude。在 Windows 上，訊息是 'claude' is not recognized as the name of a cmdlet 或 'claude' is not recognized as an internal or external command。
原因不是外掛程式命令。請遵循 驗證您的 PATH，然後重試外掛程式命令。
Unknown command and command spellings that don’t exist
您輸入了您在某處看到的外掛程式命令，並在工作階段中收到 Unknown command: /<name>，或從 shell 中的 claude 二進位檔案收到 error: unknown command '<name>' 或 error: unknown option '<flag>'。
有幾個命令拼寫在使用中，Claude Code 沒有。下表將每個對應到真實命令。外掛程式命令參考 列出子命令及其旗標。
這些拼寫看起來不對但有效：
claude plugins是claude plugin的別名claude plugin remove是claude plugin uninstall的別名/plugins和/marketplace在工作階段中開啟與/plugin相同的面板
新增市集
市集是您從 git 儲存庫、URL 或本機路徑新增到 Claude Code 的目錄。這些條目涵蓋當新增失敗或稍後重新整理失敗時您收到的訊息。Marketplace "claude-plugins-official" not found
您在工作階段中執行了 /plugin install <plugin>@claude-plugins-official，Claude Code 報告它沒有該名稱的市集。
官方市集尚未在此機器上註冊。Claude Code 通常在您第一次啟動互動式終端機工作階段時自行註冊它。如果您只透過 VS Code 擴充功能使用 Claude Code，它還沒有執行，並且它會跳過或延遲該步驟：
- 當政策阻止來源時
- 當設定
CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL時 - 在失敗的嘗試之後，等待重試
claude plugin shell 命令永遠不會為您註冊它。
新增它，然後重試安裝：
Successfully added marketplace: claude-plugins-official，而 /plugin marketplace list 顯示市集及其來源。
對於此訊息中的任何其他市集名稱，請參閱 Marketplace "<name>" not found。
相同的字串也出現在 /plugin Errors 標籤中，面板的載入失敗清單，當您的設定中列出的外掛程式命名您尚未新增的市集時。
Marketplace "<name>" not found
您在工作階段中執行了 /plugin install，Claude Code 報告它沒有該名稱的市集。有兩種形式的命令會到達此訊息：
/plugin install <plugin>@<name>：安裝行，通常來自某人傳送給您的，命名您尚未新增的市集。本條目的其餘部分涵蓋尋找和新增它。/plugin install <source>搭配路徑、URL 或owner/repo：此形式報告訊息而不是安裝，即使對於您已經新增的來源。若要在一個命令中從來源安裝，請參閱 新增市集並在一個命令中安裝。
claudeai- 開頭，市集託管在 claude.ai 上，您可以使用 claude plugin marketplace add --claudeai <name> 從 shell 按名稱新增它。請參閱 從 claude.ai 新增市集。
對於任何其他名稱，安裝行命名市集但不說明市集託管在何處，Claude Code 沒有索引來查詢市集名稱。詢問傳送該行的人市集的來源，這是 GitHub owner/repo、git URL 或路徑。然後 新增市集 並再次執行安裝行。
某人傳送給您的市集是第三方的，所以 在安裝前檢查外掛程式。
如果您已經新增了市集，請根據 /plugin marketplace list 檢查拼寫。
Invalid marketplace source format
您執行了 /plugin marketplace add <source>、claude plugin marketplace add <source> 或 claude plugin install <plugin> --marketplace <source>，Claude Code 回覆 Invalid marketplace source format. Try: owner/repo, https://..., or ./path。
Claude Code 接受以下形式之一的來源：
- GitHub
owner/repo速記 https://或http://URLuser@host:pathSSH URL- 以
./、../、/或~開頭的本機路徑
claude-plugins-official）不符合任何一個。裸主機名稱（例如 marketplace.anthropic.com）也不符合。
以接受的形式之一重新輸入來源：
Successfully added marketplace: <name>。
'<source>' is not a valid GitHub owner/repo shorthand
您傳遞了一個包含斜線但不是 owner/repo 的來源，例如 github.com/owner/repo 或 gitlab.example.com/group/project 路徑。Claude Code 拒絕了它，並提供了接受的形式清單。
owner/repo 速記僅限 GitHub，必須遵循 GitHub 的命名規則，因此主機名稱或額外的路徑段會失敗。以符合市集託管位置的形式傳遞來源：
- 任何主機上的儲存庫：完整的複製 URL
- 託管的
marketplace.json：其https://URL - 本機簽出：
./path或絕對路徑
Successfully added marketplace: <name>。
Invalid git URL
您新增了市集、安裝了外掛程式，或從 git 位址執行了更新，命令失敗，訊息中顯示 Invalid git URL。
Claude Code 在執行 git 之前檢查每個 git 位址。它拒絕其協議不支援的位址。它也拒絕 git 可能讀取為命名不同伺服器或資料夾的位址，而不是位址顯示的位址。
位址後面的文字命名要變更的內容。按照訊息所說重寫位址並再次執行命令。
改為說 is blocked by enterprise policy 的拒絕來自您組織的設定。請參閱 市集來源被企業政策阻止。
Path does not exist: <path>
您傳遞了本機路徑給 marketplace add，該路徑處沒有任何內容。相對路徑相對於您的目前目錄解析。
檢查訊息中的已解析路徑。然後從相對路徑開始的目錄執行命令，或傳遞市集目錄的絕對路徑。成功的新增會列印 Successfully added marketplace: <name>。
Claude Code 接受包含 .claude-plugin/marketplace.json 的目錄，或指向 .json 檔案的路徑。指向任何其他檔案的路徑會失敗，並顯示 File path must point to a .json file (marketplace.json)。
Marketplace file not found at <path>/.claude-plugin/marketplace.json
Claude Code 複製或下載了市集，但在其內部的預期路徑中找不到 marketplace.json。新增命令將其報告為 Failed to add marketplace: Marketplace file not found at ...。
預設位置是儲存庫根目錄中的 .claude-plugin/marketplace.json，市集參考 列出接受的位置。
修復因所有者和其他人而異：
- 您擁有市集：將檔案放在該位置並重新新增市集
- 其他人託管它：詢問所有者確切的來源他們發佈
Cannot add marketplace "<name>": Claude Code cannot install plugins from a marketplace with this name
您新增了市集，而其 marketplace.json 中的 name 無法作為 外掛 ID（例如 my-plugin@my-marketplace）中 @ 之後的部分。Claude Code 會拒絕此新增，且不會註冊任何內容。
訊息的其餘部分說明名稱的規則。在此範例中，_internal 因以 _ 開頭而違反規則：
- 您擁有市集：變更
marketplace.json中的name，例如改為internal-tools - 其他人託管它：請所有者變更名稱
Cannot add marketplace "<name>": Claude Code reserves this name and cannot register a marketplace under it
您新增了市集，而其 marketplace.json 中的 name 是每個 JavaScript 物件都具有的成員名稱之一，例如 constructor、toString 或 valueOf。Claude Code 保留這些名稱，因此會拒絕此新增，且不會註冊任何內容。保留名稱 列出了這些名稱。
在此範例中，市集名為 constructor：
extraKnownMarketplaces 下宣告該市集，Claude Code 在啟動時嘗試新增它也會以相同方式失敗，且此訊息會出現在 /plugin 中的 Errors 標籤上。
為市集取另一個名稱，然後再次新增：
- 您擁有市集：變更
marketplace.json中的name - 其他人託管它：請所有者變更名稱
SSH authentication failed or HTTPS authentication failed
您從 git 儲存庫新增或更新了市集，複製失敗，並顯示 Failed to clone marketplace repository: 後跟以下其中一行。
首先檢查儲存庫本身：拼寫錯誤的 owner/repo、不存在的儲存庫或您看不到的私人儲存庫也會以此訊息結尾。在瀏覽器中開啟儲存庫 URL，或在終端機中執行 git ls-remote <url>，以確認它存在且您有權存取。
如果儲存庫是正確的，原因是認證。Claude Code 執行 git 時禁用互動式提示，因此它無法像您的終端機那樣要求您輸入密碼、金鑰密碼或認證。如果 git 需要提示，您會看到 fatal: Cannot prompt because user interactivity has been disabled 或 terminal prompts disabled 在原始錯誤中。只有已經非互動式工作的認證才會成功：
- SSH：
ssh -T git@<host>必須成功而不提示密碼，並且主機必須已在known_hosts中 - HTTPS：您的認證助手必須為主機保存令牌。對於 GitHub，執行
gh auth login和gh auth setup-git。對於另一個主機，在您的 git 認證助手中儲存個人存取令牌。使用git ls-remote <url>測試
git ls-remote 在您的終端機中成功執行而不提示，請再次執行新增或更新。成功的新增會列印 Successfully added marketplace: <name>。成功的更新會從您的 shell 列印 Successfully updated marketplace: <name>，或在工作階段中列印 ✔ Updated 1 marketplace。
若要讓 Claude Code 跳過 GitHub owner/repo 來源的 SSH，請設定 CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1。沒有它，當 github.com 的 SSH 金鑰看起來已配置時，Claude Code 會透過 SSH 複製這些來源，並在 SSH 複製失敗時回退到 HTTPS。
有關背景自動更新可以和不能對您的認證做什麼，請參閱 背景自動更新對認證的作用。
SSH host key is not in your known_hosts file
您從您從未連接過的主機透過 SSH 新增了市集，複製失敗，並顯示此行和 ssh -T git@<host> 提示。對於金鑰已更改的主機，訊息是 SSH host key has changed，並改為提供 ssh-keygen -R <host> 提示。
Claude Code 使用 StrictHostKeyChecking=yes 複製，因此它拒絕您尚未接受其金鑰的主機，而不是自動接受金鑰。從您的終端機連接一次以接受指紋，然後重試：
https:// URL 新增市集，以完全避免 SSH。
Command 'git' not found or is in an unsafe location
在 Windows 上，您新增了市集，Claude Code 報告 Failed to clone marketplace repository: Command 'git' not found or is in an unsafe location (current directory)。
Claude Code 在您的 PATH 上查找 git，並拒絕執行僅在目前目錄中找到的。若要修復它，請安裝 Git 並重試：
1
安裝 Git for Windows
安裝 Git for Windows，使
git 在您的 PATH 上。2
開啟新終端機
開啟新終端機，使更新的
PATH 適用。3
確認 git 執行
確認
git --version 列印版本。4
重試新增
再次執行
marketplace add 命令。Git clone timed out after 120s
您新增或更新了市集，它失敗，並顯示 Git clone timed out after 120s，後跟設定 CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS 的提示。
複製市集和重新複製一個以更新它，預設情況下獲得 120 秒。對於大型儲存庫或緩慢連接，提高限制。該值以毫秒為單位：
- Bash or Zsh
- PowerShell
claude plugin marketplace add <source> --sparse <paths> 限制簽出到您命名的目錄。
Marketplace updates keep failing offline
您在市集的 git 主機無法到達的環境中工作，每個工作階段都在背景中重複失敗的重新整理。您現有的市集簽出保持原位，啟動不會延遲。 每個工作階段，對於 開啟自動更新 的市集，Claude Code 在背景中檢查市集的 git 主機是否有新提交。當該檢查無法到達主機時，它會嘗試再次複製市集，離線時該複製也會失敗。 設定此變數以跳過重新複製嘗試，並在檢查無法到達主機時繼續使用現有簽出：- Bash or Zsh
- PowerShell
.claude-plugin/marketplace.json 的簽出跳過重新複製。從未複製或其複製中途停止的市集仍會獲得複製嘗試，因此在線上新增一次。
對於完全離線部署，改為在映像建置時使用 CLAUDE_CODE_PLUGIN_SEED_DIR 預先填充外掛程式目錄，遵循 種子容器和 CI。