Anthropicは最近、Claude Codeリポジトリ内に高度な安全機能を導入しました。このユーティリティは、ソフトウェア開発フェーズにおいて危険なアーキテクチャ上の欠陥を正確に検出します。その基本理念は非常にシンプルです。具体的には、開発者がAIアシスタントと対話している間、独立したバックグラウンドスレッドがすべての構造的変更を継続的に監査します。このプロアクティブな検証により、脆弱なコードがプルリクエスト段階に到達する可能性が大幅に低減されます。
security-guidanceプラグインの技術アーキテクチャ
多層パターン分析
この防御機能は、Claude Code用のネイティブsecurity-guidanceプラグインを通じて実現されます。Anthropicの公式マーケットプレイスから初期化された後、拡張機能は個別のコマンドなしに自律的に動作します。さらに、このモジュールはコードの変更を複数の順次レイヤーによってトリアージします。例えば、個々のファイル変更が発生するたびに、揮発性コードパターンの高速スキャンが即座にトリガーされます。対象となるベクターには、動的コード実行フレームワーク、安全でないデシリアライゼーションルーティン、DOMインジェクション脆弱性などが含まれます。また、ローカルのGitHubワークフロー設定内で発生する変更も精査されます。
差分テレメトリとセッション内修正
Claude Codeによる各操作ステップの後、プラグインはローカルのgit diffマトリクスを生成します。次に、このシステムが差分テレメトリを専用のセキュリティ評価ノードに送信します。この二次分析により、高度な脆弱性が効果的に検出されます。例えば、不正な認可制御、クエリインジェクション、サーバーサイドリクエストフォージェリ(SSRF)、脆弱な暗号プリミティブなどが特定されます。スキャナーが確実なセキュリティリスクを発見した場合、Claude Codeは即座に診断フィードバックを取り込みます。その結果、開発者はアクティブなインタラクティブセッション内で脆弱性を修正することができます。
詳細なコンテキスト評価とコミットのインターセプト
より包括的な分析は、Claude Codeが統合されたBashユーティリティを介してgit commitまたはgit pushシーケンスを実行した場合にのみ開始されます。このシナリオでは、検証メカニズムが隣接するコードブロックや内部の関数呼び出しを積極的にパースします。さらに、入力サニタイゼーションルーティンや相互依存するシステムファイルも評価されます。この詳細な評価により、誤検知の発生が効果的に抑制されます。一方、標準的な外部ユーザーシェルからのコミットはプラグインによって完全に無視されます。
環境要件とカスタムルールの設定
システム依存関係と環境のプロビジョニング
運用には、Claude Codeバージョン2.1.144以降の使用が必須です。また、ホストシステムにはPython 3.8とアクティブなGitリポジトリが必要です。初回実行時に、プラグインは~/.claude/security/ディレクトリ内に独立した仮想環境を自動的に構築します。同時に、公式のClaude Agent SDKをブートストラップします。Windows環境では、エージェント主導のコミットスキャンはclaude-agent-sdkが事前インストールされている場合にのみ有効になります。
カスタムポリシーの管理
さらに、開発チームは独自のセキュリティルールを容易に統合できます。包括的なモデル主導の評価には、.claude/claude-security-guidance.mdドキュメントを活用できます。このファイル内で、管理者はプロジェクト固有の詳細なパラメーターを設定できます。例えば、機密トークンのログ記録を明示的に禁止したり、管理用ルーティングドメインに対して厳格なロールベースの検証を義務付けたりすることが可能です。正規表現ベースの高速パターンマッチングには、標準的なYAMLおよびJSONの設定ファイルがネイティブでサポートされています。
アーキテクチャ上の制限と防御的フィルタリング
重要なこととして、Anthropicはこのプラグインが包括的なセキュリティ監査や正式なコードレビューの代替にはならないことを強調しています。同様に、アクティブな継続的インテグレーション(CI)ワークフローや従来の静的アプリケーションセキュリティテスト(SAST)エンジンの代わりにもなりません。これらのリアルタイムチェックは、標準的なファイルシステムへの書き込みやコミットプロセスをブロックすることは一切ありません。代わりに、アクティブなターミナルウィンドウに非侵襲的なアノテーションをストリーミングするだけです。したがって、security-guidanceマトリクスは完全な万能薬としてではなく、早期フィルタリングシステムとして機能します。この戦略により、共有開発ブランチを汚染する前に、大量の脆弱性を効果的に排除することができます。
翻訳元: https://meterpreter.org/claude-code-security-guidance-plugin/