No-Verify をブロックするフック

PreToolUse フック設定で、実行前にバイパスフラグの使用をインターセプトしてブロックし、AI エージェントが pre-commit フック、GPG 署名、その他の git セーフティメカニズムをスキップできないようにします。

概要

AI コーディングエージェント (Claude Code, Codex など) は --no-verify などのフラグを含むシェルコマンドを実行して、pre-commit フックをバイパスすることができます。これは lint、フォーマット、テスト、pre-commit フックに設定されているセキュリティチェックの目的を無くしてしまいます。block-no-verify フックは、実行前にバイパスフラグを含むツール呼び出しを拒否する PreToolUse ガードを追加します。

問題

AI エージェントがコードをコミットする際、フック失敗を避けるためにバイパスフラグを使用することがあります:

# これらのコマンドは pre-commit フックを完全にスキップします
git commit --no-verify -m "quick fix"
git push --no-verify
git commit --no-gpg-sign -m "unsigned commit"
git merge --no-verify feature-branch

これにより以下が可能になります:

• フォーマットされていないコードがリポジトリに入る
• Lint エラーがチェックを回避する
• セキュリティスキャンがスキップされる
• 署名されていないコミットが署名ポリシーをバイパスする
• テストスイートが回避される

ソリューション

.claude/settings.json に PreToolUse フックを追加して、すべての Bash ツール呼び出しを検査し、バイパスフラグを含むコマンドをブロックします。

設定

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

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hook": {
          "type": "command",
          "command": "if printf '%s' \"$TOOL_INPUT\" | grep -qE '(^|&&|;|\\|)\\s*git\\s+.*--(no-verify|no-gpg-sign)'; then echo 'BLOCKED: --no-verify and --no-gpg-sign flags are not allowed. Run the commit without bypass flags so that pre-commit hooks execute properly.' >&2; exit 2; fi"
        }
      }
    ]
  }
}

動作方法

1. Matcher: フックは Bash ツール呼び出しのみをターゲットにするため、他のツール (Read、Edit、Grep など) に干渉しません。
2. 検査: $TOOL_INPUT 環境変数には、エージェントが実行しようとしているフルコマンドが含まれます。フックは printf を使用して入力を安全に渡し (echo の特殊文字の落とし穴を回避)、git コマンドの直後に続く場合のみ --no-verify または --no-gpg-sign フラグをチェックします。
3. ブロッキング: git コマンド内でバイパスフラグが見つかった場合、フックは終了コード 2 で終了してエラーメッセージを出力します。終了コード 2 は Claude Code にツール呼び出し全体を拒否するよう指示します。
4. パススルー: バイパスフラグが見つからない場合、フックは終了コード 0 で終了してコマンドは通常通り実行されます。

終了コード

コード	意味
0	ツール呼び出しの実行を許可
1	エラー (ツール呼び出しは進行、警告が表示される)
2	ツール呼び出しを完全にブロック

ブロックされるフラグ

フラグ	目的	ブロック理由
--no-verify	pre-commit および commit-msg フックをスキップ	lint、フォーマット、テスト、セキュリティチェックをバイパス
--no-gpg-sign	GPG コミット署名をスキップ	コミット署名ポリシーをバイパス

インストール

プロジェクト単位のセットアップ

プロジェクトルートに .claude/settings.json を作成または更新します:

mkdir -p .claude
cat > .claude/settings.json << 'EOF'
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hook": {
          "type": "command",
          "command": "if printf '%s' \"$TOOL_INPUT\" | grep -qE '(^|&&|;|\\|)\\s*git\\s+.*--(no-verify|no-gpg-sign)'; then echo 'BLOCKED: --no-verify and --no-gpg-sign flags are not allowed. Run the commit without bypass flags so that pre-commit hooks execute properly.' >&2; exit 2; fi"
        }
      }
    ]
  }
}
EOF

グローバルセットアップ

すべてのプロジェクトに適用するには、~/.claude/settings.json に追加します:

mkdir -p ~/.claude
cat > ~/.claude/settings.json << 'EOF'
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hook": {
          "type": "command",
          "command": "if printf '%s' \"$TOOL_INPUT\" | grep -qE '(^|&&|;|\\|)\\s*git\\s+.*--(no-verify|no-gpg-sign)'; then echo 'BLOCKED: --no-verify and --no-gpg-sign flags are not allowed. Run the commit without bypass flags so that pre-commit hooks execute properly.' >&2; exit 2; fi"
        }
      }
    ]
  }
}
EOF

検証

フックがバイパスフラグをブロックすることを確認します:

# これはフックによってブロックされるはずです:
git commit --no-verify -m "test"

# これは通常通り成功するはずです:
git commit -m "test"

フックの拡張

さらにブロックするフラグを追加

追加のフラグ (--force など) をブロックするには、grep パターンを拡張します:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hook": {
          "type": "command",
          "command": "if printf '%s' \"$TOOL_INPUT\" | grep -qE '(^|&&|;|\\|)\\s*git\\s+.*--(no-verify|no-gpg-sign|force-with-lease|force)'; then echo 'BLOCKED: Bypass flags are not allowed.' >&2; exit 2; fi"
        }
      }
    ]
  }
}

他のフックと組み合わせる

block-no-verify フックは他の PreToolUse フックと並行して動作します:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hook": {
          "type": "command",
          "command": "if printf '%s' \"$TOOL_INPUT\" | grep -qE '(^|&&|;|\\|)\\s*git\\s+.*--(no-verify|no-gpg-sign)'; then echo 'BLOCKED: Bypass flags not allowed.' >&2; exit 2; fi"
        }
      },
      {
        "matcher": "Bash",
        "hook": {
          "type": "command",
          "command": "if printf '%s' \"$TOOL_INPUT\" | grep -qE 'rm\\s+-rf\\s+/'; then echo 'BLOCKED: Dangerous rm command.' >&2; exit 2; fi"
        }
      }
    ]
  }
}

ベストプラクティス

1. 設定ファイルをコミット -- .claude/settings.json をバージョン管理に追加すれば、すべてのチームメンバーがフックの恩恵を受けます。
2. オンボーディングドキュメント -- プロジェクトの貢献ガイドにフックについて記載して、開発者がバイパスフラグがブロックされる理由を理解できるようにします。
3. pre-commit フックと組み合わせる -- block-no-verify フックは pre-commit フックが実行されることを保証します。意味のある pre-commit フックが設定されていることを確認してください。
4. セットアップ後にテスト -- テストコミットで意図的にトリガーしてフックが機能することを確認します。