約 3 分で読めます

Claude Securityプラグインで差分を検査する手順

自社開発の業務システムや社内ツールを、専任のセキュリティ担当なしで運用している会社は少なくありません。脆弱性診断を外部に頼むと費用がかさみ、リリースのたびに依頼するのは現実的ではないでしょう。

Anthropicは、Claude Code上で動くClaude Securityプラグインを公式マーケットプレイスで提供しています。本記事では、公式ドキュメントをもとに、中小企業がブランチ差分の検査から始める手順と、このプラグインだけでは防げない範囲を整理します。

Claude Securityプラグインとは何か

Claude Securityプラグインは、Claude Code上で複数のエージェントがコードベースの脆弱性を探し、検証済みの結果だけを報告するツールです。

全体スキャンでは、エージェントがアーキテクチャを把握し、脅威モデルを作成し、脆弱性を探索したうえで、別のエージェントがすべての指摘を独立に検証してからレポートを書きます。プラグインはローカルのセッション内で動き、利用するモデルは使用中のClaude Codeのモデルです。スキャンの消費は通常の利用枠に含まれ、別のAPIキーは要りません。

導入は /plugin install claude-security@claude-plugins-official の1行です。前提は、有料プランまたはAnthropic API等のアクセス、Python 3.9以降、Gitです(差分スキャンとパッチ生成にGitが必要)。

中小企業はどこから始めるべきか

最初の一歩は、リポジトリ全体ではなくマージ前のブランチ差分を検査することです。スキャン範囲が小さく、消費量も読みやすくなります。

ブランチに未マージのコミットがあると、/claude-security のメニューが差分のみのスキャンを提案します。オープン中のプルリクエストや、特定のコミットを指定した検査も可能です。対象はコミット済みの変更だけなので、作業中の編集はコミットかstashしてから実行してください。

大きなリポジトリでは、API層や認証コードのように領域を絞って走らせます。スキャンの深さは low・medium・high から選べ、既定は medium です。low はアーキテクチャの把握と脅威モデルの作成を省略します。見つかる指摘が少ないと感じたら、high で再実行するか、もう一度スキャンします。スキャンは非決定的で、同じコードでも結果が変わるためです。

出力はどう既存の仕組みに載せるか

スキャン結果はMarkdown・JSONL・SARIF 2.1.0で出力され、GitHubのコードスキャン等の既存ツールに取り込めます。

結果は、リポジトリ内の CLAUDE-SECURITY-<timestamp>/ に保存されます。主なファイルは次の4つです。

  • CLAUDE-SECURITY-RESULTS.md: 影響・攻撃シナリオ・重大度・確信度・推奨対応を含むレポート
  • CLAUDE-SECURITY-RESULTS.jsonl: 機械可読な同内容
  • CLAUDE-SECURITY-RESULTS.sarif: CWEで分類されたSARIF形式のログ
  • CLAUDE-SECURITY-REVISION-<commit>.json: 検査したコミットと深さを記録する刻印

このディレクトリには専用の .gitignore が入っており、誤ってコミットされません。監査証跡として履歴に残す場合は、その .gitignore を削除してからコミットします。

修正パッチはどこまで任せてよいか

パッチは自動適用されません。独立したエージェントが検証し、1件の指摘の解消と新たな脆弱性が無いことを保証できた場合だけ出力されます。

「Suggest patches」を選ぶと、指摘ごとに F1.patch のようなファイルがレポート配下の patches/ に書かれます。保証できない場合はパッチの代わりに理由のメモが出ます。適用は git apply で行い、1パッチごとに別のプルリクエストにすることがドキュメントで推奨されています。テストが無いコードのパッチは、テスト実行なしでレビューされた旨がメモに記載されます。

単独で任せてはいけない範囲は何か

このプラグインは既存の静的解析や依存関係スキャンの代替ではなく、人間のセキュリティ研究者のように推論する補完層です。

公式ドキュメントは、開発中のコード生成時に見るセキュリティガイダンスプラグイン、PR単位のCode Review、CI上の静的解析・依存関係スキャンを重ねる多層防御を前提にしています。継続的に監視するマネージド版のClaude Securityは、Enterpriseプラン向けです。中小企業は、プラグインによる差分検査を月次のリリース前チェックに組み込み、CI側の既存スキャナーと併用するのが現実的です。

導入の優先順位づけや運用ルールの設計は、AI導入の伴走支援でも相談できます。

参考

まとめ

Claude Securityプラグインは、1行のインストールでブランチ差分を検査でき、結果をSARIFで既存ツールに渡せる手段です。まずは次のリリース前に差分スキャンを1回走らせ、レポートの刻印とともに保存するところから始めてください。運用ルールの設計や定着にお困りなら、Kuu株式会社のAI導入伴走サービスにご相談ください。

関連記事

Claude Codeの権限設計——最初のdenyルール3つClaude APIキーの種類と漏えい時の初動手順Excessive Agencyを機能・権限・自律性の3軸で点検Lethal Trifectaを設計で崩す3つの切り口