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が自分で呼ぶ処理(ファイルの読み取りやプログラムの起動など)は、許可ルールやPreToolUseフックの検査を通らないことがあります。たとえば .env の読み取りを禁止しても、modがファイル読み取りの機能を直接呼べば、読めてしまいます。ルールだけでは守れないので、「そもそも入れさせない」か「見張る側のmodを置く」が必要です。

手順1:利用者のmodを全部止める

管理設定に、番人のオプションを書きます。キーは cc-plugin-sec-default@builtin です。

{
  "pluginConfigs": {
    "cc-plugin-sec-default@builtin": {
      "options": {
        "allowManagedModsOnly": true
      }
    }
  }
}

これで次のようになります。

効いているかを確かめるには、利用者の環境で 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 の行が出ます。

呼ぶ機能意味
fs の読み書き利用者が触れる場所のファイルを読み書きできる
process の実行利用者として任意のプログラムを起動できる
http の通信ネットワークに通信できる
env と settings の読み取り環境変数や設定にある鍵を読める
mcp の呼び出し許可の確認なしでMCPのツールを使える
model の呼び出し利用者の契約でモデルを使う
session への送信別のセッションやサブエージェントのClaudeに読ませるメッセージを送れる

検証コマンドが失敗したmodは承認しないでください。失敗しても読み込まれてしまう場合があるためです。長い一覧は v2.1.323 以降で複数行に続くので、すべての行を読みます。

手順4:自社のmodだけを動かす

利用者のmodを止めたうえで、自社のmodは動かしたい場合は、そのmodを「組織のもの」と認識させます。リモートのマーケットプレイスのmodなら v2.1.324 以降で、管理設定に次の3つを書きます。

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なら止める」処理を書きます。ただし、時間切れには頼れないと公式が注意しています。

管理者の注意点

まとめ

  1. modは既定でオン。利用者の権限で動き、サンドボックスもない
  2. 全部止めるなら、番人 cc-plugin-sec-default@builtin に allowManagedModsOnly を true で設定する
  3. 許可の前に claude plugin validate の hooks と calls を読み、失敗したmodは承認しない
  4. 自社のmodは enabledPlugins、extraKnownMarketplaces、prependPlugins で組織のものにし、番人も一緒に並べる

出典:Manage mods for your organization(公式ドキュメント)

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事