メインコンテンツへスキップ
見出し画像

Claude Code の deny は確認で通る。本当に止めるなら PreToolUse hook を使う

    2026-10-20 追記: Claude Code 2.1.303 では deny に当たるコマンドは確認ダイアログなしで即拒否されます。この記事の『確認で通る』は 2026-04-23 時点の私の環境での挙動です。hook で止める方法は今も有効です。

    settings.json の deny に危険なコマンドを書いたのに、確認ダイアログで「はい」を押したら通ってしまった。
    そんな経験がある方に向けて、deny の挙動と、PreToolUse hook で確実に止める方法を書きます。
    hook を使えば、確認ダイアログを出さずにコマンドを拒否できます。

    起きたこと

    Salesforce の本番環境を誤って変更しないように、settings.json の permissions.deny に危険なコマンドを書きました。
    これで止まるはずだと思っていたのですが、対話中に確認ダイアログが出て、「はい」を押したら普通に実行できてしまいました。

    2026-04 時点では、deny に書いたのに確認ダイアログで通っていました。これでは危険なコマンドを止めたことになりません。

    環境

    - Windows 11
    - Claude Code(VS Code 拡張)
    - 確認日: 2026-04-23

    原因

    私の環境(2026-04-23 時点)では、スコープ付きの deny ルールに書いたコマンドが、確認ダイアログ付きで表示され、「はい」を押すと実行できてしまいました。

    現在の公式ドキュメント(Configure permissions)では、スコープ付きの deny ルール(たとえば Bash(git push *) のような書き方)は「leaves the tool available and blocks matching calls when Claude attempts them」と記載されており、マッチするコマンドはブロックされると書かれています。ツール名だけの deny(たとえば Bash とだけ書く)はツール自体をコンテキストから除外します。

    2026-10-20 に Claude Code 2.1.303 で試したところ、deny に当たるコマンドは確認ダイアログなしで即拒否されました。バージョンによって挙動が変わるので、いずれにせよ hook を使えば、deny の挙動に関係なく確実にコマンドを止められます。

    直し方: PreToolUse hook を設定する

    PreToolUse hook は、ツールが実行される前に外部のスクリプトを呼び出し、そのスクリプトの出力で許可・拒否を決める仕組みです。
    hook で拒否した場合、確認ダイアログは出ません。拒否の理由が表示されて、そこで止まります。

    設定の手順は以下のとおりです。

    1. settings.json に hook を追加する

    プロジェクトの .claude/settings.json に以下を追加します。

    {
      "hooks": {
        "PreToolUse": [
          {
            "matcher": "Bash",
            "hooks": [
              {
                "type": "command",
                "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/guard.sh",
                "timeout": 30,
                "onFailure": "block"
              }
            ]
          }
        ]
      }
    }

    matcher はこの hook を適用するツール名です。"Bash" なら Bash ツールのコマンドだけが対象になります。複数のツールを対象にするには "Bash|Edit|Write" のようにパイプで区切ります。

    onFailure は "block" にしてください。既定は "continue" で、スクリプトが見つからない・異常終了する・タイムアウトするといった失敗時に操作がそのまま通ってしまいます。"block" にすれば、失敗時も止まります。

    2. hook のスクリプトを作る

    .claude/hooks/guard.sh を作ります。以下は、特定のコマンドを止める最小の例です。

    #!/bin/bash
    INPUT=$(cat)
    COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
    
    if echo "$COMMAND" | grep -qE '(sf|sfdx)\s+.*deploy'; then
      echo '{
        "hookSpecificOutput": {
          "hookEventName": "PreToolUse",
          "permissionDecision": "deny",
          "permissionDecisionReason": "本番へのデプロイは hook で禁止しています"
        }
      }'
      exit 0
    fi
    
    exit 0

    スクリプトは標準入力からツール呼び出しの情報を JSON で受け取ります。止めたいコマンドに一致したら、permissionDecision を "deny" にした JSON を標準出力に出します。一致しなければ何も出さずに終了します(通常の権限フローに進みます)。

    拒否のときに permissionDecisionReason に書いた文字列が、Claude Code の画面に表示されます。なぜ止まったのかが分かるように書いておくと便利です。

    3. スクリプトに実行権限を付ける

    chmod +x .claude/hooks/guard.sh

    確認のしかた

    設定後、止めたいコマンドを Claude Code に実行させてみます。

    hook が正しく動いていれば、確認ダイアログは出ず、拒否の理由(permissionDecisionReason に書いた文字列)が表示されて止まります。

    私の環境では、Salesforce の本番組織への変更コマンドを hook で止めるようにしてから、確認ダイアログは出なくなり、拒否の理由が表示されるようになりました。

    注意すること

    Windows では PowerShell ツールも止める必要があります。 Claude Code は Windows で Bash と PowerShell の両方のツールを使えます。matcher が Bash だけだと、同じ操作を PowerShell ツール経由で実行されたときに hook を通りません。Windows で使う場合は matcher を次のようにしてください。

    "matcher": "Bash|PowerShell"

    コマンドの書き方の違いにも注意してください。 たとえば --target-org の後にスペースを空けて別名を書く形だけを判定していると、短い形の -o や、イコールでつなぐ --target-org=別名 の形は通ってしまいます。止めたいコマンドの書き方を網羅するか、止めたい書き方と通したい書き方の両方でテストを作っておくと安全です。

    hook のスクリプトのパスは ${CLAUDE_PROJECT_DIR} を基準にしてください。 相対パスで書いていると、作業フォルダを移したときにスクリプトが見つからず、onFailure の設定次第では操作が素通りします。


    参考
    - Claude Code 公式ドキュメント - Hooks: https://code.claude.com/docs/en/hooks
    - Claude Code 公式ドキュメント - Configure permissions: https://code.claude.com/docs/en/permissions

     
     
    会社員のエンジニア、まだみです。ニュースや統計で「なんで?」と引っかかったことを、資料とデータで掘って書いています。SalesforceやAIの話も。好きなものはホラー映画、ミステリー小説、日本語ラップ、タコス。

    あなたへのおすすめ