Claude Codeのmodを組織で許可・禁止する管理者向け設定

この記事の要点
- mod は利用者の権限で動き、サンドボックスもない。管理者は managed settings で、動かすか・どれを動かすか・順番を決められる
- 利用者のmodを全部止めるなら、組み込みの番人 cc-plugin-sec-default@builtin に allowManagedModsOnly を true で設定する
- 許可する前に claude plugin validate で hooks と calls の行を読む。例外だけ許すなら、自前のポリシーmodで plugin.register を見張る
活用例:従業員が入れたClaude Codeのmod(独自の拡張)を、組織の方針で許可・禁止する
- 部署
- 情報システム・セキュリティ
- 使うもの
- managed settings と claude plugin validate
- AIに任せる
- modのコードの点検メモの下書き
- 人が決める
- どのmodを許可するか・例外の範囲
modは便利ですが、利用者の権限でそのまま動く拡張です。管理者が何も決めなければ、利用者は好きなmodを入れられます。この記事は、組織としてどこまで許し、どこから止めるかを決める手順をまとめます。
公式ドキュメント「Manage mods for your organization」(2026年11月20日確認)にもとづいています。modとは何かは modの記事、管理設定の配り方は managed settingsの記事、プラグイン全般の安全面は プラグインのセキュリティの記事 をご覧ください。
結論:既定は「オン」。止めるなら番人にオプションを1つ足す
modは Claude Code v2.1.286 以降、既定でオンです。管理者向けの設定は、次の3つの考え方に分けられます。
| やりたいこと | 設定の考え方 |
|---|---|
| 利用者のmodを全部止める | 組み込みの番人に allowManagedModsOnly を true にする |
| 自社のmodだけ動かす | 上に加えて、自社のmodを「組織のもの」として入れる |
| 全部許すが、自社のmodで見張る | 自社のmodを prependPlugins の先頭に置く |
迷ったら、まず全部止める設定から始めて、必要になった例外だけ足していくのが安全です。
何もしないと、利用者はどうなるか
何も設定しないときの動きを、先に押さえておきます。
- modは動く:許可されたマーケットプレイスや、--plugin-dir で指定した場所から読み込める
- 組み込みの番人が先に動く:sec-default@builtin という名前のmodが、利用者のmodより先に読み込まれる。利用者は止められない。管理設定のあるマシン、または Team・Enterprise のログインで動いているときに読み込まれる
- 番人が守るもの:システムプロンプト、管理者のCLAUDE.md、設定の読み取り結果、接続済みの管理MCPのツール一覧は、利用者のmodから書き換えられない
- それ以外は利用者の権限:ファイルの読み書き、プログラムの起動、通信ができる
さらに見落としやすい点があります。modが自分で呼ぶ処理(ファイルの読み取りやプログラムの起動など)は、許可ルールやPreToolUseフックの検査を通らないことがあります。たとえば .env の読み取りを禁止しても、modがファイル読み取りの機能を直接呼べば、読めてしまいます。ルールだけでは守れないので、「そもそも入れさせない」か「見張る側のmodを置く」が必要です。
手順1:利用者のmodを全部止める
管理設定に、番人のオプションを書きます。キーは cc-plugin-sec-default@builtin です。
{
"pluginConfigs": {
"cc-plugin-sec-default@builtin": {
"options": {
"allowManagedModsOnly": true
}
}
}
}
これで次のようになります。
- 利用者のmodはフックが動かない:入れたプラグインのmod、--plugin-dir のmod、セッション中にClaudeが書いたmodのすべて
- 組織のmodは動く:組織のものとして扱われるmodは検査されない
- 他の設定ファイルに書いても無効:利用者・プロジェクト・ローカル・--settings に書かれた同じ設定は無視される
- ふつうの設定フックは動く:利用者の設定ファイルのフック、ステータスライン、/goal は影響を受けない
- 組み込みのmodは動く:AGENTS.md対応などは、それぞれ別のスイッチがある
効いているかを確かめるには、利用者の環境で claude --plugin-dir にmodの入ったフォルダを指定して起動します。modのフックが動かず、番人のメッセージが出れば成功です。なお、早期アクセス時代の CLAUDE_CODE_ENABLE_FUNCTION_HOOKS を 0 にしていた場合は、v2.1.287 以降では変数自体が無視されるので、このオプションに置き換えてください。
手順2:もっと強い止め方を使い分ける
番人のオプションより広く止める設定もあります。影響範囲が違うので注意が必要です。
| 設定 | 止まるもの | 注意 |
|---|---|---|
| allowManagedModsOnly | 利用者のmod | 設定ファイルのフックは動く |
| allowManagedHooksOnly | 利用者のmod と、利用者の設定ファイルのフック | 組織のmodと組み込みだけが動く |
| disableAllHooks | すべてのmod と、すべてのフック | 管理者のフックも止まる。ステータスラインと /goal も動かなくなる |
| disableSideloadFlags | --plugin-dir などの読み込み口 | セッション中にClaudeが書いたmodも読み込まれなくなる |
disableAllHooks は管理者自身のPreToolUseフックも止めるので、使うと別の守りが外れます。設定前に、公式の設定リファレンスの説明を必ず読んでください。
手順3:入れる前にmodの中身を点検する
許可制にするなら、承認の前に何ができるmodなのかを確認します。シェルで claude plugin validate にプラグインのフォルダを渡すと、hooks の行と calls の行が出ます。
- hooks:そのmodが受け取るイベント。tool.call や prompt.submit があれば、すべてのツール呼び出しやプロンプトを見て、書き換えられる
- calls:コードが呼ぶ機能。次の表が目安
| 呼ぶ機能 | 意味 |
|---|---|
| fs の読み書き | 利用者が触れる場所のファイルを読み書きできる |
| process の実行 | 利用者として任意のプログラムを起動できる |
| http の通信 | ネットワークに通信できる |
| env と settings の読み取り | 環境変数や設定にある鍵を読める |
| mcp の呼び出し | 許可の確認なしでMCPのツールを使える |
| model の呼び出し | 利用者の契約でモデルを使う |
| session への送信 | 別のセッションやサブエージェントのClaudeに読ませるメッセージを送れる |
検証コマンドが失敗したmodは承認しないでください。失敗しても読み込まれてしまう場合があるためです。長い一覧は v2.1.323 以降で複数行に続くので、すべての行を読みます。
手順4:自社のmodだけを動かす
利用者のmodを止めたうえで、自社のmodは動かしたい場合は、そのmodを「組織のもの」と認識させます。リモートのマーケットプレイスのmodなら v2.1.324 以降で、管理設定に次の3つを書きます。
- enabledPlugins で、そのプラグインを true にする
- extraKnownMarketplaces で、マーケットプレイスを宣言する
- prependPlugins または appendPlugins に、modのIDを書く
prependPlugins を使うときは、組み込みの番人 sec-default@builtin も一緒に並べてください。一覧を設定すると既定が置き換わるため、書き忘れると番人が外れます。ローカルのフォルダに置くmodは条件が厳しく、管理設定で絶対パスのマーケットプレイスを宣言し、一覧には相対パスで載せ、フォルダ自体を管理者だけが書き込める状態にします。そこに誰でも書き込めると、組織のmodを書き換えられます。
確認は claude --debug で起動し、デバッグログで自社のmodの行を探します。tier が prepend なら組織のmodとして先頭で動いており、tier が user ならただの利用者のmod扱いです。
手順5:例外を許すなら、自前のポリシーmodで見張る
「全部止める」ではなく、「ほとんど許すが危ない呼び出しをするものだけ止めたい」場合は、ポリシーmodを書きます。公式の例では、prependPlugins に置いたmodが plugin.register というイベントで、他のmodの読み込み前に calls の一覧を受け取ります。利用者のmodがプログラム起動の機能を呼ぶなら、フックのモジュールだけを外して、残りのプラグインは読み込ませます(v2.1.326 以降)。さらに、ツール呼び出しとファイル書き込みの記録をデバッグログに残すこともできます。
見落としやすいのは、検査が例外を出したり時間切れになったりすると、そのフックは飛ばされ、検査をすり抜けて読み込まれることです。これを避けるには、検査を名前付きの関数に移し、catch で「利用者のmodなら止める」処理を書きます。ただし、時間切れには頼れないと公式が注意しています。
管理者の注意点
- サンドボックスではない:どの設定でも、許可したmodは利用者の権限で動く
- --safe-mode は全部のmodを止める:自社のmodも対象。不具合の切り分けに使える
- 番人は失敗側に倒れる:番人が管理設定を読めないときは、利用者のmodをすべて拒否する
- WebFetchの禁止だけでは足りない:modの通信は別経路のため、通信を止めたいなら、利用者のmodを止めるか、ポリシーmodで拒否する
- modを自作して配る側のテストは、modのテストの記事 の手順で、組織のポリシーmodまで確認できる
まとめ
- modは既定でオン。利用者の権限で動き、サンドボックスもない
- 全部止めるなら、番人 cc-plugin-sec-default@builtin に allowManagedModsOnly を true で設定する
- 許可の前に claude plugin validate の hooks と calls を読み、失敗したmodは承認しない
- 自社のmodは enabledPlugins、extraKnownMarketplaces、prependPlugins で組織のものにし、番人も一緒に並べる
出典:Manage mods for your organization(公式ドキュメント)
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


