CLI からプラグインを推奨する

​

仕組み

1. ヒント行をスキャンし、出力がモデルに到達する前に削除します
2. ヒントが公式 Anthropic マーケットプレイスのプラグインをターゲットにしていることを確認します
3. プラグインがまだインストールされていないこと、および以前にプロンプトが表示されていないことを確認します
4. ヒントを出力したコマンドの名前を表示するインストールプロンプトをユーザーに表示します

​

ヒントを出力する

• CLAUDECODE: Claude Code のすべてのバージョンで設定されるため、最も多くのセッションに到達します。Claude Code が起動する tmux セッションと stdio MCP サーバーサブプロセスでも設定され、IDE 拡張機能は統合ターミナルで設定します。人間のユーザーが CLI を直接実行する可能性があります。
• CLAUDE_CODE_CHILD_SESSION: Claude Code 自体が生成するサブプロセス（ツール呼び出し、hook コマンド、status line コマンドなど）でのみ設定されるため、タグは通常、人間のターミナルに到達しません。セッション内で開始された長時間実行されるプロセス（tmux サーバーなど）は変数をキャプチャするため、そのプロセスから後で起動されたシェルは依然として生のタグを表示します。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" />`)
}

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

​

出力場所を選択する

​

ユーザーに表示される内容

─────────────────────────────────────────────────────────────
  プラグイン推奨

    example-cli コマンドはプラグインのインストールを提案しています。

    プラグイン: example-cli
    マーケットプレイス: claude-plugins-official
    example-cli デプロイメント向けの公式統合

    インストールしますか？
    ❯ 1. はい、example-cli をインストール
      2. いいえ
      3. いいえ、プラグインインストールヒントを再度表示しない

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

• プラグインごとに 1 回: プロンプトが表示された後、Claude Code はプラグインを記録し、ユーザーの回答に関係なく、二度とそのプラグインのプロンプトを表示しません。
• セッションごとに 1 回: マシン上のすべての CLI にわたって、Claude Code セッションごとに最大 1 つのヒントプロンプトが表示されます。

​

ヒント形式

<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />

​

要件

• 独立した行: タグは独立した行を占める必要があります。ログステートメント内など、行の途中に埋め込まれたタグは無視されます。行の先頭と末尾の空白は許可されます。
• 公式マーケットプレイス: value は claude-plugins-official などの Anthropic 管理マーケットプレイスのプラグインを参照する必要があります。他のマーケットプレイスを指すヒントは静かに削除されます。

• stderr に書き込む: stderr は example-cli deploy | jq などのシェルパイプラインからタグを除外します。Claude Code は両方のストリームをスキャンするため、stdout も機能します。
• 環境変数でゲートを設定する: CLAUDECODE または CLAUDE_CODE_CHILD_SESSION が設定されている場合のみ出力します。ヒントを出力するを参照して、2 つの変数がどのように異なるかを確認してください。

​

公式マーケットプレイスにプラグインを取得する

​

関連項目

• プラグインを作成する: CLI が推奨するプラグインを構築します
• プラグインマーケットプレイスを作成および配布する: 公式マーケットプレイスの外でプラグインをホストします
• 環境変数: CLAUDECODE および関連変数の完全なリファレンス