AgentShieldとは?
AgentShieldはコーディングエージェントの設定、主に~/.claudeディレクトリと各プロジェクトの.claudeフォルダを読み、問題になりうる点を報告します。CLAUDE.mdに貼られたAPIキー、Bash(*)のような許可ルール、ファイル名をシェルコマンドに埋め込むフック、npx -yで起動するMCPサーバー、リモートのコードを取得して実行するようエージェントに指示する記述などです。AからFの評価と0から100のスコアを表示し、最も安全な問題は自動で修正できます。
npx ecc-agentshield scanで実行でき、Code Scanning用のSARIFを出力するGitHub Actionとしても、GitHub AppのECC Toolsの中でも動きます。オプションの--opusモードは、設定をClaudeに送り、レッドチーム、ブルーチーム、監査役の3エージェントでレビューさせます。Affaan Mustafaが2026年2月のCerebral ValleyとAnthropicによるClaude Codeハッカソンで、自身のEverything Claude Codeプロジェクトの一部として作りました。
CLIはMITライセンスで無料です。組織全体を分析するGitHub AppのECC Tools Proは1ユーザーあたり月19ドルです。
AgentShieldは使う価値があるか?
AgentShieldに価値があるのは、汎用のシークレットスキャナーが理解できない、コーディングエージェントの設定で重要なファイルを読むからです。15 モジュールにわたる268のルールは、許可リスト、リバースシェルからクリップボード経由の持ち出しまでの40のフックパターン、49のMCPサーバーチェック、エージェントとCLAUDE.mdの指示に関する41のルールを含みます。スコアはカテゴリーごとに100から始まり、検出結果だけが減点します。重大は25、高は15の減点なので、見せかけの拒否ルールを足しても評価は上がりません。
普及は控えめながら本物です。GitHubスターは約1,413、2026年11月15日までの30日間のecc-agentshieldのnpmダウンロードは66,299、v1.6.0は2026年9月10日に公開されました。GitHub Action、SARIF出力、新しい検出だけを示すベースライン、証跡パックの書き出しにより、ノートPCだけでなくCIでも使えます。
主なコストはノイズです。メンテナーはリポジトリに誤検知の監査ファイルを置き、テンプレートフォルダー内のMCPの検出は0.25xに重みを下げ、ドキュメントはどの検出が実行時の本当のリスクでどれが例なのかを何段落もかけて説明しています。仕分けは覚悟してください。主な対象はClaude Codeで、Codex、OpenCode、Zedなど他の環境は証跡のメモ程度で、同じ深さはありません。
--opusモードは設定をAnthropicに、--provider orcarouterならOrcaRouterに送ります。READMEは、秘密情報を伏せていない設定で後者を使わないよう警告しています。まずローカルでスキャンし、見つかった問題を直してから外部に送るのが順序です。スキルやMCPツールの汚染に焦点を当てるSnykのエージェントスキャナーやNVIDIAのSkillSpectorと比べると、AgentShieldは実行環境そのものを広く見る一方、精度の成熟度では劣ります。
真価を発揮する場面
1年分のClaude CodeのフックとMCPサーバーを溜め込んだ個人開発者
自分の設定がキーを漏らしていないか、エージェントに何でも実行させていないか確かめたい
インストールせずにnpx ecc-agentshield scanを実行し、まず重大と高の検出を読み、ハードコードされた秘密情報には--fixを適用します。費用はかからず、ファイルをどこにも送 らずローカルで完了します。
40人のエンジニアに共通の.claudeディレクトリを配布するプラットフォームチーム
危険な権限やフックがチームの設定にマージされるのを防ぎたい
ベースライン付きでaffaan-m/agentshield@v1のGitHub Actionを追加し、新しい重大・高の検出があるときだけプルリクエストを失敗させ、SARIFをCode Scanningにアップロードします。Actionは無料で、19ドル/ユーザー/月のECC Tools Proで組織全体の分析が加わります。
SOC 2審査の証跡を準備するセキュリティエンジニア
エージェントの設定がどう管理されているかを監査人に示したい
--complianceと--evidence-packを付けてスキャンし、検出結果を統制IDに対応づけて持ち運べるパッケージを書き出し、HTMLレポートを審査資料に添付します。
導入前に確認すること
- 導入
- npx ecc-agentshield scanが~/.claudeを自動で見つけ、コマンド1つで採点付きのレポートを表示します。agentshield initはより厳しい基本設定を書き出します。
- 連携
- SARIFとジョブサマリー付きのGitHub Action。JSON、Markdown、HTML出力。GitHub AppのECC Tools。外部ルールパック。--opus用のAnthropic APIまたはOrcaRouter。--supply-chain-onlineによるnpmレジストリの照会。
- データとプライバシー
- 標準のスキャンはローカルで動き、サプライチェーンのチェックもオフラインです。--opusは設定内容をAnthropicに、選んだ場合はOrcaRouterに送るので、先に秘密情報を伏せてください。
- 大規模利用時のコスト
- CLIとActionは無料です。--opusは自分のAnthropic APIの料金でClaude Opusを使い、ECC Tools Proは1ユーザーあたり月19ドルです。
- 制限
- 誤検知が多く、メンテナーが仕分けの手順を文書化しているほどです。テンプレート内のMCPの検出は0.25xに重みを下げられ、最も深く対応しているのはClaude Codeです。
良い点
- Claude Codeの設定、フック、MCP構成を理解する
- 防御ルールを足してもスコアを水増しできない
- SARIFとベースライン差分に対応したGitHub Action
- 自動修正でハードコードされた秘密情報を環境変数に移せる
気になる点
- 多くの検出に手作業の仕分けが必要
- Claude Code以外では深さが落ちる
- --opusモードは設定を第三者のAPIに送る
- 2026年9月10日以降リリースがない
おすすめの人
フックやMCPサーバーを組み込んでClaude Codeを使い、その設定をCIで繰り返し監査したい開発者やプラットフォームチーム。