Claude Securityプラグインの導入基準と実務的比較

Claude Securityプラグインとは？既存SASTとの違いと実務での使い方

Claude Securityプラグインとは

Claude Securityプラグインは、Claude Codeのセッション内で複数のエージェントが脆弱性スキャンを行う、ベータ版のプラグインです。
エージェントがアーキテクチャを把握し、脅威モデルを作り、脆弱性を探し、各指摘を独立して検証したうえでレポートを書きます。
名前が似たものに、Enterprise向けのマネージドサービス「Claude Security」があります。こちらはGitHubリポジトリを接続して継続的に監視するホスト型のサービスで、Claude Mythos 5.1でスキャンできます。一方、プラグインは手元のClaude Codeで使えるモデルだけを使い、GitLabやBitbucketのリポジトリなど、マネージド版では届かないコードもスキャンできます。本記事で扱うのはプラグイン版です。

既存静的解析ツールとの構造的な違い

両者の違いは、ルールとの一致を見るか、コードの意味を推論するかにあります。そのため、どちらかを選ぶのではなく、併用するのが前提です。

ルールベースの静的解析の特徴

従来の静的解析は、定義されたパターンとの一致を判定します。既知のパターンは決定的かつ高速に検出できます。一方で、文脈を考慮しないため誤検知が出やすく、複数ファイルにまたがるロジックの問題は見逃しがちです。

推論ベースの検知の特徴

Claude Securityは、データの流れを追い、ビジネスロジックを理解したうえで脆弱性を評価します。Anthropicによれば、複数ファイルの理解が必要な、文脈に依存する脆弱性の検出が得意とされています。ただし、これは提供元の説明であり、効果は自分のコードベースで確かめる必要があります。
置き換えではなく併用
公式ドキュメントは、このプラグインが既存のソースコード向けセキュリティツールを置き換えるものではないと明記しています。言語ごとのルール、依存関係やサプライチェーンのチェックは、引き続き既存の静的解析や依存関係スキャナーの役割です。

マルチエージェント構成と検証の仕組み

ノイズを減らす要は、見つけるエージェントと確かめるエージェントを分けている点です。独立した検証者が分析した指摘だけがレポートに載るため、レポートは短く、読む価値のあるものに絞られます。
スキャンはおおむね次の流れで進みます。

1. リポジトリを読み込み、アーキテクチャを把握する
2. コンポーネントごとに脅威モデルを作る
3. 複数の調査エージェントで並行して脆弱性を探す
4. 別の検証エージェントが各指摘を独立して確認する
5. 確認できた指摘だけをレポートにまとめる

指摘ごとに、影響、攻撃シナリオ、深刻度、確信度、推奨対応が付きます。ただし、検証を経ても誤検知をゼロにはできません。また、同じコードを2回スキャンしても結果が変わることがあるため、最終判断は人間が行う前提で運用します。

導入要件とインストール

有料プラン（またはAnthropic APIや対応するクラウドプロバイダー）、Python 3.9以上、Gitがあれば始められます。

Claude Codeのプロンプトで、公式マーケットプレイスからインストールします。

/plugin install claude-security@claude-plugins-official

マーケットプレイスが見つからないと言われたら、先に/plugin marketplace add anthropics/claude-plugins-officialを実行します。インストール後に/reload-pluginsを求められた場合は、それを実行して有効化します。

3つの機能と出力

/claude-securityを実行すると、3つの機能を選ぶメニューが開きます。/claude-security scan my branchのように引数で指示したり、「scan commit abc1234」のように自然な文で頼んだりもできます。
Scan Codebase：リポジトリ全体のスキャン
自分が書いていないコードも含めて、リポジトリ全体を対象にします。最初にリポジトリを読み込み、全体か特定の領域（API層や認証まわりなど）かを選ばせてくれます。各選択肢にはファイル数と相対的なコストが表示されます。大きなリポジトリでは、領域を絞って順にスキャンするのが現実的です。

Scan Changes：差分のスキャン

ブランチの差分、プルリクエスト、単一のコミットを対象にします。差分だけを見るわけではなく、文脈を得るためにエージェントはリポジトリ全体を読みます。対象はコミット済みの変更だけなので、作業中の編集は先にcommitかstashします。

Suggest Patches：修正パッチの提案

レポートの中から修正したい指摘を選ぶと、パッチを作ります。パッチは作業用のコピー上で作られるので、元のソースは変わりません。
各パッチは、作ったエージェントとは別のエージェントがレビューします。テストがあれば実行し、次の3点をすべて保証できる場合にだけパッチを出力します。

• その指摘を修正していること
• 新しい脆弱性を入れていないこと
• それ以外の挙動を変えていないこと

保証できない場合は、パッチの代わりに理由を書いたメモが出ます。つまり、パッチはリファクタリングを含むものではなく、1つの指摘を最小限の変更で直すものです。パッチが自動で適用されることはなく、git applyで自分で適用します。1パッチにつき1つのプルリクエストに分けて、個別にレビュー・テストするのが推奨です。

出力されるファイル

スキャン結果は、リポジトリ内のCLAUDE-SECURITY-<timestamp>/ディレクトリに書き出されます。

このディレクトリには独自の.gitignoreが入っているため、うっかりgit addしてもコミットに混ざりません。

他ツールとの位置づけとCI連携

このプラグインは、多層防御の中で「必要なときに実行する深いスキャン」を担う層です。PRごとのレビューや、コードを書く最中のチェックは別のツールの役割です。

CIに組み込む場合のトレードオフ

Scan ChangesはCIでも実行できます。結果をSARIFで出力できるので、GitHub code scanningなど既存の仕組みに指摘を取り込みやすい点は利点です。

一方で、スキャンには時間とトークンがかかり、実行中はClaude Codeを開いておく必要があります。結果も毎回同じとは限りません。そのため、すべてのコミットで即座に結果を返すゲートとして使うよりも、マージ前のブランチや重要な変更に絞って使うほうが現実的です。高速で決定的なチェックは、既存の静的解析に任せます。

運用上の注意点

導入でつまずきやすいのは、コスト、結果のばらつき、人間によるレビューの3点です。

１．コストを見積もってから実行する：スキャンはClaude Codeの使用量にカウントされ、トークンを大量に使うことがあります。実行前に確認が求められるので、表示される範囲とコストを見てから始めます。まずは認証まわりなど1つの領域で試すのがおすすめです。

２．結果は毎回同じとは限らない：同じコードでも、スキャンごとに異なる指摘が出ることがあります。定期的にスキャンし、リビジョンの記録でどのコードの結果かを管理します。

３． パッチは必ず人がレビューする：パッチは自動で適用されません。テストのないコードでは、レビューがテストなしで行われたことがメモに書かれます。

４．他人のコードを扱うときは扱いを決めておく：受託開発などでは、レポートやパッチの保管・共有方法を事前に関係者と取り決めておくと安心です。

５．autoモードとの兼ね合い：プラグインはautoモードで最もスムーズに動きますが、エージェントに許可なく操作させることになります。信頼できるリポジトリで使い、外部から取り込んだコード中の指示に従わせない設計を意識します。

コラム：アラート疲れを防ぐコツ

すべての指摘を同じ重みで扱うと、開発者は警告に埋もれてしまいます。

レポートの深刻度と確信度をもとに優先度を付け、高い深刻度かつ高い確信度のものから対応する運用がおすすめです。

低い確信度の指摘は、次のスキャンで再び出るかどうかを見てから判断するのも一つの方法です。

関連記事

• AI開発のセキュリティリスクを体系的に分類し、現場で即実践できる防御策を解説
• AIエージェントを活用した開発プロセスの自動化と効率化の実践事例

出典

• Scan your codebase for vulnerabilities（Claude Code Docs）
• Claude Security plugin（claude.com）