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操作などを、プルリクエストに出る前に減らします。

入れたあとは自動で動き、呼び出すコマンドはありません。位置づけは次のとおりです。

見張りは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が上限です。管理者は、端末管理でユーザー側のファイルを配り、組織全体のルールにできます。

入れ方と、チーム全員に効かせる方法

公式の入れ方は、ターミナルのセッションで次のコマンドです。

事前に必要なのは、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つです。

  1. gitのリポジトリではない(ターンとコミットの確認はgitの状態が必要)
  2. Anthropicの認証も外部プロバイダの設定もない(編集ごとのチェックだけが動く)
  3. パターンのYAMLがあるのに PyYAML を読み込めない(ファイルが無視される。JSONで書けば解決)

まとめ

  1. 編集ごと・ターンの終わり・コミットの3層で、書いている最中に拾う
  2. 書き込みは止まらない。助言として渡り、Claudeがその場で直す
  3. 独自ルールは足せるが、標準のチェックは外せない
  4. Code Review、CIと組み合わせて使う。1枚で守りきろうとしない

出典:Catch security issues as Claude writes code(公式ドキュメント)

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事