从您的 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 启动的会话、提供远程控制的会话或代理团队队友永远不会提示

​

预览用户看到的内容

─────────────────────────────────────────────────────────────
  Plugin recommendation

    The example-cli command suggests installing a plugin.

    Plugin: example-cli
    Marketplace: claude-plugins-official
    Description: Official integration for example-cli deployments

    Would you like to install it?
    ❯ 1. Yes, install
      2. No
      3. No, and don't show plugin installation hints again

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

• 是的，安装：在用户范围安装插件
• 否，不再显示插件安装提示：为该用户关闭未来的提示提示
• 30 秒内无答案：计为否

​

后续步骤

• 发布和分发插件：进入每个市场的路由，包括提示所需的官方市场
• 插件命令参考：在会话外安装相同插件的 shell 命令