1> ## Documentation Index

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

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

4 

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

6 

7> CLI から 1 行のマーカーを出力して、Claude Code ユーザーに公式プラグインのインストールを促します。

8 

9CLI または SDK を保守していて、公式の Anthropic マーケットプレイスにプラグインがある場合、ツールは Claude Code ユーザーにそのプラグインのインストールを促すことができます。CLI は Claude Code 内で実行されていることを検出すると、stderr に 1 行のマーカーを書き込みます。Claude Code はマーカーを読み取り、出力から削除し、ユーザーに 1 回限りのインストールプロンプトを表示します。

10 

11Claude Code はコマンド出力からヒント行を削除してからモデルに送信するため、マーカーは会話に表示されず、トークン使用量にカウントされません。このプロトコルは追加のコマンドを必要とせず、Claude Code の外でユーザーが実行する場合に CLI が出力する内容を変更しません。

12 

13このページは CLI および SDK メンテナー向けです。プラグインのインストールを探している場合は、[プラグインの発見とインストール](/ja/discover-plugins)を参照してください。

14 

15<h2 id="how-it-works">

16 仕組み

17</h2>

18 

19Claude Code は、Bash および PowerShell ツールを通じて実行するすべてのコマンド、および [hook](/ja/hooks) コマンドに対して、[`CLAUDECODE`](/ja/env-vars) 環境変数を `1` に設定します。CLI がその変数を検出すると、自己終了型の `<claude-code-hint />` タグを stderr に書き込みます。hook コマンドではヒントタグは削除され、無視されます。Bash および PowerShell ツール出力のみがインストールプロンプトをトリガーします。

20 

21Claude Code がコマンド出力を受け取ると、以下を実行します。

22 

231. ヒント行をスキャンし、出力がモデルに到達する前に削除します

242. ヒントが公式 Anthropic マーケットプレイスのプラグインをターゲットにしていることを確認します

253. プラグインがまだインストールされていないこと、および以前にプロンプトが表示されていないことを確認します

264. ヒントを出力したコマンドの名前を表示するインストールプロンプトをユーザーに表示します

27 

28Claude Code はプラグインを自動的にインストールすることはありません。ユーザーが常に確認します。

29 

30<h2 id="emit-the-hint">

31 ヒントを出力する

32</h2>

33 

34`CLAUDECODE` 環境変数でゲートを設定して、マーカーが人間のユーザーのターミナルに表示されないようにします。次に、タグを stderr に独立した行として書き込みます。

35 

36以下の例は、公式マーケットプレイスの `example-cli` という名前のプラグインのヒントを出力します。

37 

38<CodeGroup>

39 ```javascript Node.js theme={null}

40 if (process.env.CLAUDECODE) {

41 process.stderr.write(

42 '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',

43 )

44 }

45 ```

46 

47 ```python Python theme={null}

48 import os, sys

49 

50 if os.environ.get("CLAUDECODE"):

51 print(

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

53 file=sys.stderr,

54 )

55 ```

56 

57 ```go Go theme={null}

58 if os.Getenv("CLAUDECODE") != "" {

59 fmt.Fprintln(os.Stderr,

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

61 }

62 ```

63 

64 ```shell Shell theme={null}

65 [ -n "$CLAUDECODE" ] &&

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

67 ```

68</CodeGroup>

69 

70公式マーケットプレイスのプラグイン名で `example-cli` を置き換えます。

71 

72<h2 id="choose-where-to-emit">

73 出力場所を選択する

74</h2>

75 

76ヒントを出力するコードパスを制御します。Claude Code はプラグイン別に重複排除するため、すべての呼び出しで出力しても欠点はありません。うまく機能するタッチポイントは以下の通りです。

77 

78| 配置 | 機能する理由 |

79| :------------- | :------------------------------------- |

80| `--help` 出力 | Claude は不慣れな CLI を探索するときにヘルプを実行することが多い |

81| 不明なサブコマンドエラー | Claude がインターフェイスについて混乱している瞬間に到達します |

82| ログインまたは認証成功 | ユーザーはすでにセットアップの心構えができています |

83| 初回実行ウェルカムメッセージ | 自然なオンボーディングの瞬間 |

84 

85<h2 id="what-the-user-sees">

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

87</h2>

88 

89ヒントがすべてのチェックに合格すると、Claude Code は以下のようなプロンプトを表示します。

90 

91```text theme={null}

92─────────────────────────────────────────────────────────────

93 プラグイン推奨

94 

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

96 

97 プラグイン: example-cli

98 マーケットプレイス: claude-plugins-official

99 example-cli デプロイメント向けの公式統合

100 

101 インストールしますか？

102 ❯ 1. はい、example-cli をインストール

103 2. いいえ

104 3. いいえ、プラグインインストールヒントを再度表示しない

105 

106─────────────────────────────────────────────────────────────

107```

108 

109プロンプトはヒントを生成したコマンドの名前を表示するため、ユーザーはツールと推奨するプラグイン間の不一致を検出できます。ユーザーが 30 秒以内に応答しない場合、プロンプトは**いいえ**として却下されます。

110 

111プロンプト頻度は制限されています。

112 

113* **プラグインごとに 1 回**: プロンプトが表示された後、Claude Code はプラグインを記録し、ユーザーの回答に関係なく、二度とそのプラグインのプロンプトを表示しません。

114* **セッションごとに 1 回**: マシン上のすべての CLI にわたって、Claude Code セッションごとに最大 1 つのヒントプロンプトが表示されます。

115 

116**はい**を選択するとプラグインがユーザースコープにインストールされます。**いいえ、プラグインインストールヒントを再度表示しない**を選択すると、ユーザーのすべての将来のヒントプロンプトが無効になります。

117 

118<h2 id="hint-format">

119 ヒント形式

120</h2>

121 

122ヒントは 3 つの必須属性を持つ自己終了型タグです。

123 

124```text theme={null}

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

126```

127 

128| 属性 | 必須 | 説明 |

129| :------ | :- | :------------------------------ |

130| `v` | はい | プロトコルバージョン。`1` が唯一サポートされている値です |

131| `type` | はい | ヒントの種類。`plugin` が唯一サポートされている値です |

132| `value` | はい | `name@marketplace` 形式のプラグイン識別子 |

133 

134属性値は二重引用符で引用するか、引用符なしで残すことができます。引用符なしの値は空白を含むことはできません。エスケープシーケンスはサポートされていません。

135 

136<h2 id="requirements">

137 要件

138</h2>

139 

140Claude Code はヒントに対して行動する前に 2 つの条件を適用します。どちらかのチェックに失敗したヒントは削除されます。

141 

142* **独立した行**: タグは独立した行を占める必要があります。ログステートメント内など、行の途中に埋め込まれたタグは無視されます。行の先頭と末尾の空白は許可されます。

143* **公式マーケットプレイス**: `value` は `claude-plugins-official` などの Anthropic 管理マーケットプレイスのプラグインを参照する必要があります。他のマーケットプレイスを指すヒントは静かに削除されます。

144 

145ヒント行は、バージョンまたはタイプが認識されない場合でも、常に出力からモデルに到達する前に削除されるため、マーカーはトークン使用量にカウントされません。

146 

147残りのガイダンスは推奨されていますが、強制されていません。Claude Code は CLI がそれに従っているかどうかを観察することはできません。

148 

149* **stderr に書き込む**: stderr は `example-cli deploy | jq` などのシェルパイプラインからタグを除外します。Claude Code は両方のストリームをスキャンするため、stdout も機能します。

150* **`CLAUDECODE` でゲートを設定する**: `CLAUDECODE` 環境変数が設定されている場合のみ出力します。これにより、ユーザーが CLI を直接実行するときにマーカーが表示されるのを防ぎます。

151 

152<h2 id="get-your-plugin-into-the-official-marketplace">

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

154</h2>

155 

156ヒントプロトコルは、公式 Anthropic マーケットプレイス `claude-plugins-official` にリストされているプラグインに対してのみ有効です。Anthropic はそのマーケットプレイスを裁量で管理し、アプリ内送信フォームはプラグインを[コミュニティマーケットプレイス](/ja/plugins#submit-your-plugin-to-the-community-marketplace)に追加します。これはヒントプロトコルがチェックしません。Anthropic パートナー連絡先と協力している場合は、公式マーケットプレイスのリストを調整するために彼らに連絡してください。

157 

158<h2 id="see-also">

159 関連項目

160</h2>

161 

162* [プラグインを作成する](/ja/plugins): CLI が推奨するプラグインを構築します

163* [プラグインマーケットプレイスを作成および配布する](/ja/plugin-marketplaces): 公式マーケットプレイスの外でプラグインをホストします

164* [環境変数](/ja/env-vars): `CLAUDECODE` および関連変数の完全なリファレンス