Claudeが書いたコードの穴を、その場で自分で直させる

この記事の要点
- security-guidanceは、Claudeが自分の変更をその場で見直し、見つけた脆弱性を同じセッションで直すプラグイン。入れたら自動で動く
- 見張りは3層。編集ごとの文字列チェック(費用なし)、ターン終了時の別Claudeによる確認、コミットやプッシュ時の深い確認
- どの層も書き込みやコミットを止めない。多層防御の1枚と考え、Code Reviewや継続的な検査と組み合わせる
活用例:AIが書いたコードの脆弱性を、人のレビューの前に減らす
- 部署
- 開発・セキュリティ
- 使うもの
- Claude Code の security-guidance プラグイン
- AIに任せる
- 変更の見直し・見つけた問題の修正
- 人が決める
- 独自ルールの内容・どこまでをプラグインに任せるか
AIにコードを書かせると、速いぶん、危ない書き方もそのまま通りやすくなります。人のレビューで全部を拾おうとすると、今度は人の負担が増えます。
この記事は、公式ドキュメント「Catch security issues as Claude writes code」(2026年11月19日確認)にもとづいて、書いている最中に脆弱性を拾う security-guidance プラグインを解説します。プルリクエスト側の確認は Code Review の記事 を、全体のセキュリティの考え方は セキュリティの記事 をご覧ください。
結論:書く時点で拾い、PRで残りを拾う
このプラグインは、Claudeが自分の変更を、書いている間に見直し、見つけた問題を同じセッションで直させるものです。インジェクション、安全でないデシリアライズ、危ないDOM操作などを、プルリクエストに出る前に減らします。
入れたあとは自動で動き、呼び出すコマンドはありません。位置づけは次のとおりです。
- このプラグイン:PRに届く前に減らす(セッションの中)
- Code Review:PRで、残りを拾う
見張りは3層:違いを表で見る
| 層 | いつ | 方法 | 費用 |
|---|---|---|---|
| 編集ごと | ファイルを書いた直後 | 危ない書き方の文字列マッチ。モデルは呼ばない | かからない |
| ターンの終わり | Claudeの1回の返事が終わったとき | 変更の差分を別のClaudeが確認。背景で動く | かかる |
| コミット・プッシュ | Claudeが git commit か git push を実行したとき | 周辺のコードも読む、深いエージェント型の確認 | かかる |
編集ごとのチェック
ファイルへの書き込みを見て、よくある危ない呼び出しを探します。例として、動的なコード実行(eval など)、安全でないデシリアライズ(pickle)、DOMへの直接挿入(innerHTML への代入など)、ワークフローのファイル(.github/workflows/ の下)があります。同じパターンの警告は、1ファイル・1セッションにつき1回だけ出ます。
ターン終了時のチェック
ターンの終わりに、そのターンで変わった作業ツリー全体の差分を取り、セキュリティに絞った別のClaudeに確認させます。Claudeの返事は待たされません。問題が見つかると、Claudeに結果が渡され、続きで直します。
文字列では拾えない次のような問題を狙います。
- 認可の抜け道
- 他人のデータを直接参照できてしまう問題
- インジェクション
- サーバー側のリクエスト偽造
- 弱い暗号
1ターンで見るのは最大30ファイル、連続で動くのは最大3回までです。
コミット・プッシュ時のチェック
Claudeが Bash ツールで git commit か git push を実行すると、背景で深い確認が走ります。呼び出し元、無害化の処理、関連ファイルまで読んで、本当の問題かどうかを判断します。単独で見ると危なそうでも、コードベースの中では安全な書き方による誤検知を減らすためです。
注意点は2つです。自分のシェルや、セッション中の ! で実行したコミットは見られません。コミットと push の確認は、1時間に20回までです。
「自分で採点しない」仕組み
書いたClaudeに自分の成果を評価させないのがポイントです。編集ごとの層は、モデルを使わない固定の文字列マッチです。ターンとコミットの層は、新しい文脈の別のClaudeが、差分から出発して、問題探しだけを指示されて動きます。
ただし、どの層も書き込みやコミットを止めません。 指摘はClaudeへの指示として渡り、会話の中で直される形です。見落としもあるので、完全な対策ではなく、多層防御の1枚として使います。
独自のルールを足す
足し方は2つあり、どちらも「足す」だけで、標準のチェックを外すことはできません。
| 方法 | ファイル | 効く層 |
|---|---|---|
| 自然な文章でガイドを書く | .claude/claude-security-guidance.md | ターン終了時とコミット時(モデルを使う層) |
| 文字列や正規表現で足す | .claude/security-patterns.yaml | 編集ごとの層 |
ガイドの例は、「顧客番号をINFO以上でログに出さない」「管理用のルートは、データ読み取りの前に管理者の権限確認を呼ぶ」「トークンの比較は専用の関数を使う」のような、そのリポジトリ固有の約束事です。これは審査役への助言であり、強制ではありません。 確実に止めたい場合は、保護するファイルへの編集を止める フック か、CIの検査を併用します。
パターンのファイルには、ルール名、警告文(1KBまで)、正規表現か文字列、対象のパス、除外のパスを書けます。JSON版も読み込まれ、YAMLを使うには PyYAML が必要です。ルールは最大50個まで読まれます。ガイドの置き場所は、ユーザー全体、プロジェクト、自分だけの上書きの3つで、すべて合算され、ガイドの合計は8KBが上限です。管理者は、端末管理でユーザー側のファイルを配り、組織全体のルールにできます。
入れ方と、チーム全員に効かせる方法
公式の入れ方は、ターミナルのセッションで次のコマンドです。
- /plugin install security-guidance@claude-plugins-official
事前に必要なのは、Python 3.7以降と、gitのリポジトリです。コミットのエージェント型の確認には Python 3.10以降が要ります。初回は、ホームフォルダの .claude/security/ に仮想環境を作り、Claude Agent SDK を入れます。この取得にはネットワークが要ります。失敗した場合や、Pythonが古い場合は、単発の確認に切り替わります。
チームの全員に効かせるには、プロジェクトの設定の enabledPlugins に書きます。そのうえで、各自が clone ごとに1回インストールのコマンドを実行します。管理者は、管理設定の enabledPlugins で組織全体に効かせられます。プラグインの読み込みで迷ったら プラグインの読み込みの記事、組織設定の全体像は 導入前に決める5つのこと をご覧ください。
費用と止め方
編集ごとの層は費用がかかりません。ターンとコミットの確認は、通常のリクエストと同じく、使用量にカウントされます。既定では、どちらもOpusのモデルで動きます。モデルは環境変数で変えられます(ターン用が SECURITY_REVIEW_MODEL、コミット用が SG_AGENTIC_MODEL)。
層ごとに止める環境変数も用意されています。
| 変数 | 止めるもの |
|---|---|
| ENABLE_PATTERN_RULES=0 | 編集ごとのチェック |
| ENABLE_STOP_REVIEW=0 | ターン終了時の確認 |
| ENABLE_COMMIT_REVIEW=0 | コミットとプッシュの確認 |
| ENABLE_CODE_SECURITY_REVIEW=0 | モデルを使う確認のすべて |
| SECURITY_GUIDANCE_DISABLE=1 | プラグイン全体(入れたまま) |
自分だけ止めるなら /plugin disable、外すなら /plugin uninstall です。プロジェクトの設定で有効にされていた場合、外すと自分用の上書きだけが書かれ、他のメンバーには影響しません。管理設定で有効にされたものは、個人では無効化も削除もできません。
他の手段との組み合わせ
| 段階 | 手段 | 役目 |
|---|---|---|
| セッションの中 | このプラグイン | Claudeが書くコードの一般的な脆弱性を、その場で直す |
| 必要なとき1回 | /security-review | 現在のブランチの変更を1回確認 |
| 必要なとき深く | Claude Security プラグイン | リポジトリや差分の、複数エージェントによる脆弱性スキャン |
| プルリクエスト | Code Review(TeamとEnterprise) | 正しさとセキュリティの複数エージェント確認 |
| CI | 既存の静的解析、依存関係のスキャン | 言語固有のルール、サプライチェーンの検査 |
すでにあるコードの問題を探すには、このプラグインではなく、特定のファイルの確認を頼むか、Claude Security プラグインを使います。いずれもソースコードを読むもので、動いているサイトを検査するものではありません。プラグインを入れる側のリスクは、プラグインのセキュリティの記事 にまとめています。
うまく動かないとき
診断のログは、ホームフォルダの .claude/security/log.txt に書かれます。メッセージなしで確認が飛ばされる主な理由は次の3つです。
- gitのリポジトリではない(ターンとコミットの確認はgitの状態が必要)
- Anthropicの認証も外部プロバイダの設定もない(編集ごとのチェックだけが動く)
- パターンのYAMLがあるのに PyYAML を読み込めない(ファイルが無視される。JSONで書けば解決)
まとめ
- 編集ごと・ターンの終わり・コミットの3層で、書いている最中に拾う
- 書き込みは止まらない。助言として渡り、Claudeがその場で直す
- 独自ルールは足せるが、標準のチェックは外せない
- Code Review、CIと組み合わせて使う。1枚で守りきろうとしない
出典:Catch security issues as Claude writes code(公式ドキュメント)
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


