Claude Code の危険なコマンドをブロックする Mod

この Mod を使うと、Claude Code の危険なコマンドをブロックできます。対象は、Claude が Bash ツールで実行しようとしているシェルコマンドです。どのコマンドも実行される前に、短いルールの一覧と照合されます。ルールに該当したコマンドは拒否され、どのルールがなぜ発動したのかが Claude に伝えられ、あなたの画面にはルール名を示すトーストが表示されます。安全なコマンドはそのまま素通りします。

組み込みルールがカバーするのは次のとおりです。/、~、$HOME、.、* に対する rm -rf、main または master への git push --force、git clean -fdx、SQL の DROP TABLE、DROP DATABASE、DROP SCHEMA、TRUNCATE、chmod -R 777 /、mkfs、ディスクデバイスへの dd、生のディスクへの出力リダイレクト、curl や wget の出力をシェルへパイプする操作、そして古典的なフォーク爆弾です。git reset --hard はオプトインのルールとして用意されています。Claude Code 2.1.287 以降が必要です。

録画では、デモ用プロジェクトで Claude に破壊的な操作を頼んでいます。Mod は Bash の呼び出しを拒否し、該当したルール名がトーストで表示され、Claude はその理由を読んだうえで、コマンドを実行せずに応答します。

インストールブロックにあるいずれかの方法を使ってください。ガードは次のツール呼び出しから有効になります。/reload-plugins の後に再起動する必要はありません。

ロジックはすべて 1 つの tool.call フックに収まっています。hooks/register.ts から抜粋します。

on('tool.call', { tool: 'Bash' }, ($, e, next) => {
  const match = findMatch(e.command, settings)
  if (match === undefined) return next(e)

  if (settings.mode === 'warn') {
    $.ui.toast(`${$.plugin.name}: "${match.name}" is running (warn mode)`)
    return next(e)
  }

  $.ui.toast(`${$.plugin.name}: blocked "${match.name}"`)
  return { deny: denyReason($.plugin.name, match) }
}).catch(($, e, next) =>
  next.called
    ? next(e)
    : { deny: `${$.plugin.name}: its check failed, so the command was not run to be safe.` },
)

マッチャー { tool: 'Bash' } により、このフックはシェルコマンドだけを受け取ります。hooks/rules.ts の findMatch は、まず allowPatterns を確認し、次に組み込みルール（オフにしたものは除く）、最後にあなたの extraPatterns を確認します。どれにも該当しなければ、next(e) によってコマンドは通常どおり実行されます。該当した場合、フックは { deny: reason } を返し、その理由が Claude の読むツール結果になります。

.catch ハンドラーこそが、この Mod を単なるフィルターではなくガードにしている部分です。next が呼ばれる前にチェックが例外を投げた場合、呼び出しは許可されずに拒否されます。つまり、この Mod はフェイルクローズで動作します。また session.start フックは、カスタムパターンの中に正しくない正規表現があると、一度だけトーストで知らせます。

rules.ts の各ルールは、ID、名前、1 文の理由、そしてテストで検証されるコマンド例を持つ、ただのデータです。

以下のオプションは /config で変更できます。mode: warn にすると、ガードは通知役に変わります。該当するコマンドも実行され、トーストで知らせるだけになります。extraPatterns と allowPatterns には JavaScript の正規表現を 1 項目に 1 つずつ指定します。組み込みルールそのものを変えたい場合は、hooks/rules.ts の RULES 配列にある該当ルールの pattern を編集してください。

ツール呼び出しを傍受 は、この Mod が存在する理由そのものです。すべての Bash コマンドを実行前に確認し、拒否することができます。コマンドを書き換えることはなく、自分でコマンドを実行することもありません。UI を変更 はトースト表示のためのものです。それ以外に、ファイル、ネットワーク、モデル、コマンドへの独自のアクセスは一切持ちません。

これは事故を防ぐための保護であり、サンドボックスではありません。パターンを回避するように組み立てられたコマンドは通ってしまうため、Claude Code の権限確認プロンプトは有効のままにしておいてください。Mod を無効にするには /plugin disable cm-block-dangerous-commands を実行します。すべての Mod をオフにしてセッションを始めるには claude --safe-mode を使います。

macOS のターミナル上で Claude Code 2.1.291 にてテスト済みです。ブロックされるはずのコマンドが実行されてしまう場合は、次を確認してください。

• claude --version が 2.1.287 以降であること、そして /plugin でこの Mod が有効になっていること。
• シェルからインストールした場合は /reload-plugins を実行すること。
• /config で mode が warn ではなく block になっていること。
• allowPatterns のエントリーが、意図した以上に広くマッチしていないこと。
• ガードが対象とするのは Bash ツールだけです。Edit や Write によるファイル編集はチェックされません。

安全なコマンドが拒否される場合は、Mod 全体を warn モードに切り替えるのではなく、範囲を絞った許可パターンを追加してください。