Claude Codeのyou should knowを有効にする — 見落としを知らせる組み込みmod

You should knowは、Claude Codeに入っている組み込みmodの1つです。Claudeが長めの作業をしている間、別のエージェント(side agent)が裏で見張り、あなたやClaudeが見落としそうなことを見つけると、プロンプトの上にメモを出します。既定では無効なので、使うには自分で有効にします。

有効化はセッション内で/plugin enable cc-plugin-you-should-know@builtinを打つだけです。ただし、どの環境でも使えるわけではありません。条件と、メモが出ないときの確認先は後段にあります。

You should knowは何をするmodか

modの一覧表での説明は、次のとおりです。長めのタスクの間、side agentがあなたの背後を見ている、という役割です。

• 見張るのは、Claudeが進めている作業
• 出すのは、あなたが見逃しそうな「知っておくべきこと」
• 出す場所は、プロンプトの上

modはClaude Code本体の中で動く関数の集まりで、画面の一部を描く力を持ちます。プロンプトの上に帯を出せるのは、そのためです。modの仕組みそのものはClaude Codeのmodを80行で作るに手順があります。

You should knowが具体的にどんな場面でメモを出すのかは、modの概要ページの表に挙げられていません。「あなたが見逃しそうなこと」という説明にとどまります。出る場面を決め打ちして使うより、普段の作業に有効にして、出たメモを読んで判断する使い方になります。

メモの文面は、更新で調整されてきました。changelogに載っている変更は3件です。

日本語で使っているなら、v2.1.290より前のバージョンではメモが英語で出る可能性があります。claude --versionで確認し、古ければ更新してください。modの導入経緯はv2.1.287のリリースノートにあります。

有効にする手順と、使える条件

有効化のコマンドは1行ですが、前提が3つあります。

1. Claude Codeがv2.1.287以降であること(modの概要ページの記載では、terminalはv2.1.287以降、Desktopアプリはv2.1.286以降でmodが動く)
2. first-partyのセッションで、テレメトリがオンであること(v2.1.287のchangelogの注記)
3. 組織で利用が許されていること(概要ページの表に「if available for your org」とある)

3つ目の見え方が少し特殊です。表によれば、このmodは/pluginのInstalledタブでShow disabledを開くと一覧に出ます。ただし、これも組織で使える場合の話です。

手順は次のとおりです。

/plugin enable <plugin>は、Installedタブのそのプラグインを開いて有効化する動作です。インストールではなく、組み込みmodの有効化なので、マーケットプレイスの追加は要りません。

/plugin enable cc-plugin-you-should-know@builtin

/plugin系のコマンドは、対話型のターミナルセッションでだけ使えます。claude -pのような非対話の実行では、/pluginはこの環境では使えないという返事になります。有効化はふだんの対話セッションで済ませてください。

有効化したかどうかを/plugin listで確かめようとしても、期待どおりにはなりません。/plugin listが出すのはマーケットプレイスからインストールしたプラグインで、バージョン、スコープ、状態が並びます。組み込みmodはInstalledタブのBuilt-inの下で見るものです。また、modの概要ページにあるmods activeの行にも、組み込みmodは含まれません。この行に名前が無くても、You should knowが動いていないとは限りません。

テレメトリの条件は、分けて考える必要があります。組み込みmodにはcc-plugin-telemetryという別のmodがあり、Claude Codeと組み込みmodが記録する分析レコードを送ります。You should knowの有効化条件に「テレメトリがオン」とあるので、テレメトリを止めている環境では、有効化できない可能性があります。なぜ条件になっているのかは、changelogにも概要ページにも説明がありません。

メモが出ないときの切り分け

有効にしたのにメモが出ないときは、次の順に確かめます。

画面については、modが描いたものが見える場所は限られます。modの概要ページの表を、You should knowのメモが帯として出る前提で読み替えると、次のようになります。

表は一般のmodについての記載で、You should knowのメモがどの画面に出るかは個別に書かれていません。プロンプトの上に出すmodなので、描画が見えない場所ではメモも見えないはずです。VS Code拡張で使っていてメモが出ないなら、ターミナルのセッションで試してください。

表にはほかに2行あります。claude.aiやモバイルアプリからのRemote Controlでは、hookは手元のマシンのセッションで動き、描画はそのマシンのターミナルに出ます。クラウドセッションではhookは動きますが、描画は見えません。スマホから操作していても、メモを読めるのは手元のターミナルです。

modそのものが読み込める状態かを調べる

一覧に出ない、有効にしても何も起きない、というときは、You should knowより手前でmodの仕組み自体が止まっていることがあります。シェルでclaude plugin testを、modを置いていないディレクトリから実行すると、セッションを開かずに状態が分かります。

claude plugin test

出力に含まれる文言と意味は次のとおりです。

最初の行以外が出たなら、インストールしたmodが読み込まれない状態です。これらの文言が示すのはインストールしたmodの状態で、disableAllHooksが原因でも組み込みmodは止まりません。You should knowが出ない理由としては、まず一覧表示と有効化の状態を見ます。Anthropic側の遠隔設定で止まっているかどうかは、文言で見分けられます。自分の設定か組織の方針かは、hooks modules are turned off hereの文言だけでは区別できません。なお、組織のallowManagedModsOnlyはこのコマンドに表示されません。この設定が効いていても組み込みmodは止まらないので、You should knowが出ない理由にはなりません。

止めたいとき、止まらないとき

止めるには/pluginで無効にします。組み込みmodは更新も削除もできませんが、無効化はできます。

ここで混乱しやすいのが、一般のmodを止める設定との違いです。

概要ページには、disableAllHooks、--bare、--safe-modeのような一括で止める設定やフラグは組み込みmodを止めない、とあります。You should knowを一時的に切りたいだけなら、--safe-modeで起動しても意味がありません。/pluginから無効にします。

--safe-modeなどプラグイン経由のカスタマイズを絞る設定については、strictPluginOnlyCustomizationの記事にあります。

組織の管理者が知っておくこと

管理者が「ユーザーが入れたmodは動かさない」と決めるallowManagedModsOnlyは、組み込みguardのcc-plugin-sec-default@builtinに付けるオプションです。管理者向けのページには、このオプションを立てても組み込みmodは動き続ける、とあります。

このオプションが拒むのは、ユーザーがインストールしたmod、--plugin-dirで読み込んだmod、セッション中にClaudeが書いたmodです。ユーザーのsettingsファイルのhookやカスタムのステータスライン、/goalは動き続けます。

つまり、allowManagedModsOnlyを設定した組織でも、You should knowは別のスイッチで制御されます。

管理者向けのページには、ほかにも3つの設定が載っています。どれも組み込みmodは止めません。

allowManagedHooksOnlyよりdisableAllHooksのほうが広い、という関係は管理者向けのページにもあります。組織で見えない、使えない場合は、管理者に聞くのが近道です。有効化は「組織で提供されている場合」に限られます。

6つの組み込みmodで既定が無効なのはYou should knowだけ

modの概要ページが挙げる組み込みmodは6つです。You should knowだけが、既定で無効です。

ほかの5つは、/pluginのInstalledタブにBuilt-inとして並びます。You should knowも同じ画面のShow disabledで見つかります。

この6つのうち、ソースが公開されているのは4つ(diff、agents-md、sec-default、telemetry)で、Claude Codeリポジトリのmodsディレクトリにあります。You should knowはその一覧に含まれないため、メモを出す条件を読んで確かめることはできません。出る場面を知る手段は、実際に有効にして観察することだけです。

まとめ

You should knowは、長い作業を任せている間に、側面から見落としを拾う仕組みです。使うかどうかは、自分の作業の長さと、メモを読む手間のどちらを重く見るかで決まります。

試すなら、バージョンが新しいことと、/pluginの一覧に名前があることを確かめてから、1行で有効にします。合わなければ、同じ/pluginで無効に戻せます。