Skip to main content

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

如果您維護 CLI 或 SDK，並在官方 Anthropic 市場中有外掛程式，您的工具可以提示 Claude Code 使用者安裝該外掛程式。當您的 CLI 偵測到它在 Claude Code 內執行時，會向 stderr 寫入單行標記。Claude Code 讀取該標記，將其從輸出中移除，並向使用者顯示一次性安裝提示。 Claude Code 在將命令輸出發送給模型之前會從中移除提示行，因此標記永遠不會出現在對話中，也不會計入代幣使用量。該協議不需要額外命令，也不會改變您的 CLI 為 Claude Code 外部使用者列印的內容。 本頁面適用於 CLI 和 SDK 維護者。如果您正在尋找安裝外掛程式，請參閱探索和安裝外掛程式。

​
運作方式

Claude Code 為透過 Bash 和 PowerShell 工具執行的每個命令設定 CLAUDECODE 環境變數為 1。當您的 CLI 看到該變數時，它會向 stderr 寫入自閉合的 <claude-code-hint /> 標籤。 當 Claude Code 接收到命令輸出時，它會：
  1. 掃描提示行並在輸出到達模型之前將其移除
  2. 檢查提示是否指向官方 Anthropic 市場中的外掛程式
  3. 檢查外掛程式是否尚未安裝且之前未提示過
  4. 向使用者顯示安裝提示，其中包含發出提示的命令名稱
Claude Code 永遠不會自動安裝外掛程式。使用者始終需要確認。

​
發出提示

在 CLAUDECODE 環境變數上設定發出條件，以便標記永遠不會出現在人類使用者的終端中。然後將標籤寫入 stderr 的單獨一行。 以下範例為官方市場中名為 example-cli 的外掛程式發出提示： 
if (process.env.CLAUDECODE) {
  process.stderr.write(
    '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',
  )
}
將 example-cli 替換為您在官方市場中的外掛程式名稱。

​
選擇發出位置

您可以控制哪些程式碼路徑發出提示。Claude Code 按外掛程式進行重複資料刪除，因此在每次呼叫時發出沒有缺點。運作良好的接觸點包括：
位置為什麼有效
--help 輸出Claude 在探索不熟悉的 CLI 時經常執行幫助
未知子命令錯誤到達 Claude 對您的介面感到困惑的時刻
登入或驗證成功使用者已經處於設定心態
首次執行歡迎訊息自然的入門時刻

​
使用者看到的內容

當提示通過所有檢查時，Claude Code 會顯示如下提示： 
─────────────────────────────────────────────────────────────
  外掛程式推薦

    example-cli 命令建議安裝外掛程式。

    外掛程式：example-cli
    市場：claude-plugins-official
    example-cli 部署的官方整合

    您想要安裝它嗎？
    ❯ 1. 是的，安裝 example-cli
      2. 否
      3. 否，不再顯示外掛程式安裝提示

─────────────────────────────────────────────────────────────
提示會命名產生提示的命令，以便使用者可以發現工具與其推薦的外掛程式之間的不匹配。如果使用者在 30 秒內未回應，提示會關閉為否。 提示頻率受限：
  • 每個外掛程式一次：顯示提示後，Claude Code 會記錄該外掛程式，無論使用者的答案如何，都不會再次提示。
  • 每個工作階段一次：在機器上的所有 CLI 中，每個 Claude Code 工作階段最多出現一個提示。
選擇是的，安裝 example-cli 會將外掛程式安裝到使用者範圍。選擇否，不再顯示外掛程式安裝提示會為使用者停用所有未來的提示。

​
提示格式

提示是具有三個必需屬性的自閉合標籤。 
<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />
屬性必需描述
v是協議版本。1 是唯一支援的值
type是提示類型。plugin 是唯一支援的值
value是name@marketplace 形式的外掛程式識別碼
屬性值可以用雙引號引用或不引用。未引用的值不能包含空格。不支援逸出序列。

​
要求

Claude Code 在對提示進行操作之前強制執行兩個條件。未通過任一檢查的提示會被丟棄：
  • 自己的行：標籤必須佔據自己的行。嵌入在行中間的標籤，例如在日誌陳述式內，會被忽略。允許行上的前導和尾隨空格。
  • 官方市場：value 必須參考 Anthropic 控制的市場中的外掛程式，例如 claude-plugins-official。指向其他市場的提示會被無聲地丟棄。
提示行始終會在到達模型之前從輸出中移除，即使版本或類型無法識別，因此標記永遠不會計入代幣使用量。 其餘指導是建議的，但不是強制的。Claude Code 無法觀察您的 CLI 是否遵循它：
  • 寫入 stderr：stderr 將標籤保留在 shell 管道之外，例如 example-cli deploy | jq。Claude Code 掃描兩個流，因此 stdout 也有效。
  • 在 CLAUDECODE 上設定條件：僅在設定 CLAUDECODE 環境變數時發出。這可防止標記出現在直接執行您的 CLI 的使用者。

​
將您的外掛程式納入官方市場

提示協議僅對列在官方 Anthropic 市場 claude-plugins-official 中的外掛程式生效。Anthropic 自行決定策劃該市場，應用程式內提交表單會將外掛程式新增到社群市場，提示協議不會檢查該市場。如果您正在與 Anthropic 合作夥伴聯絡人合作，請與他們聯繫以協調官方市場列表。

​
另請參閱