從您的 CLI 推薦您的外掛程式

​

發出提示

• CLAUDECODE：由每個 Claude Code 版本設定。IDE 擴充功能也在其整合終端中設定它，因此僅在 CLAUDECODE 上的閘道也會在使用者在其中一個終端中直接執行您的 CLI 時發出標籤
• CLAUDE_CODE_CHILD_SESSION：僅在 Claude Code 本身啟動的子程序中設定。當您可以要求 v2.1.172 或更新版本時使用它

if (process.env.CLAUDECODE) {
  process.stderr.write(
    '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',
  )
}

import os, sys

if os.environ.get("CLAUDECODE"):
    print(
        '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />',
        file=sys.stderr,
    )

if os.Getenv("CLAUDECODE") != "" {
    fmt.Fprintln(os.Stderr,
        `<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />`)
}

if [ -n "$CLAUDECODE" ]; then
  printf '%s\n' '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />' >&2
fi

​

提示格式

​

檢查提示何時出現

• 官方且可安裝：value 命名一個 Claude Code 在其官方市場本機副本中找到的外掛程式，該外掛程式尚未安裝，且沒有原則阻止
• 分析開啟：Claude Code 分析關閉的工作階段永遠不會提示，例如設定了 DISABLE_TELEMETRY、DO_NOT_TRACK 或 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 的工作階段，或在第三方提供者（例如 Amazon Bedrock）上的工作階段，其中自動遙測選擇退出適用
• 頻率限制：每個工作階段一個提示，每個外掛程式一個提示（無論使用者的答案如何），以及在該機器上已提示 100 個外掛程式後沒有提示
• 未關閉：使用者未選擇否，且不再顯示外掛程式安裝提示
• 本機、有人值守的工作階段：工作階段的工作區是本機而不是在雲端或遠端機器上，且工作階段不是無人值守執行。例如，使用 --cloud 啟動的工作階段、提供遠端控制的工作階段或代理團隊隊友永遠不會提示

​

預覽使用者看到的內容

─────────────────────────────────────────────────────────────
  外掛程式推薦

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

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

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

─────────────────────────────────────────────────────────────

• 是，安裝：在使用者範圍安裝外掛程式
• 否，且不再顯示外掛程式安裝提示：關閉該使用者的未來提示提示
• 30 秒內無答案：計為否

​

後續步驟

• 發佈和分發外掛程式：進入每個市場的路由，包括提示所需的官方市場
• 外掛程式命令參考：在工作階段外安裝相同外掛程式的 shell 命令