1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Claude がコードを書く際のセキュリティ問題をキャッチする

6 

7> security-guidance プラグインをインストールして、Claude が自身のコード変更の脆弱性をレビューし、同じセッション内で修正するようにします。

8 

9security guidance プラグインは、Claude が作業中に自身のコード変更を一般的な脆弱性についてレビューし、同じセッション内で見つかった問題を修正します。このプラグインは、インジェクション、安全でないデシリアライゼーション、安全でない DOM API などの問題をコードがプルリクエストに到達する前にキャッチし、下流の人間レビュアーが行うセキュリティレビューの量を削減します。

10 

11インストール後、プラグインは自動的に実行されます。呼び出すものはなく、覚えておく必要のある個別のコマンドもありません。

12 

13このプラグインは、プルリクエストで実行される [Code Review](/ja/code-review) のセッション内コンパニオンです。このプラグインは PR に到達するものを削減します。Code Review はそれをキャッチします。プラグインがオンデマンドレビューと CI スキャンとどのように層状になるかについては、[これが他のセキュリティツールとどのように適合するか](#how-this-fits-with-other-security-tools) を参照してください。

14 

15<h2 id="prerequisites">

16 前提条件

17</h2>

18 

19* Claude Code CLI バージョン 2.1.144 以降

20* `PATH` 上の Python 3.8 以降。プラグインは `python3`、`python`、`py -3` をこの順序で試します

21* 作業するディレクトリ用の git リポジトリ。ターン終了とコミットレビューは git 状態に対して diff を行い、リポジトリ外では無音でスキップします。編集ごとのパターンチェックはどこでも機能します

22 

23初回実行時、プラグインは `~/.claude/security/` の下に仮想環境を作成し、Claude Agent SDK をインストールします。これには `pip` とネットワークアクセスが必要です。そのインストールが失敗した場合、コミットレビューは agentic なものではなく、単一ショットレビューにフォールバックします。Windows では仮想環境ステップはスキップされるため、agentic コミットレビューは `claude-agent-sdk` が既にインポート可能な場合にのみ実行され、そうでない場合は同じようにフォールバックします。

24 

25<h2 id="install-the-plugin">

26 プラグインをインストールする

27</h2>

28 

29Claude Code セッションで、[公式 Anthropic マーケットプレイス](/ja/discover-plugins#official-anthropic-marketplace) からインストールします：

30 

31```text theme={null}

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

33```

34 

35インストールはスコープを求めます。ユーザースコープを選択して、プラグインをユーザー設定に書き込み、このマシンで開始するすべての新しいローカルセッションで読み込まれるようにします。Claude Code がマーケットプレイスが見つからないと報告した場合、まず `/plugin marketplace add anthropics/claude-plugins-official` を実行してから、インストールを再試行してください。

36 

37次に、現在のセッションで `/reload-plugins` を使用して有効化します。これはプラグインの変更を再起動なしで適用します：

38 

39```text theme={null}

40/reload-plugins

41```

42 

43<h3 id="enable-in-cloud-sessions-and-shared-repositories">

44 クラウドセッションと共有リポジトリで有効化する

45</h3>

46 

47ユーザースコープのプラグインは、Anthropic インフラストラクチャで実行されるため、[ウェブ上の Claude Code](/ja/claude-code-on-the-web) には引き継がれません。そこで有効化するか、リポジトリをクローンするすべてのユーザーに対して有効化するには、プロジェクトのチェックイン設定で宣言します：

48 

49```json .claude/settings.json theme={null}

50{

51 "enabledPlugins": {

52 "security-guidance@claude-plugins-official": true

53 }

54}

55```

56 

57管理者は、[管理設定](/ja/admin-setup) で [`enabledPlugins`](/ja/settings#plugin-settings) を設定することで、組織全体でプラグインを有効化できます。

58 

59<h2 id="what-the-plugin-checks">

60 プラグインがチェックする内容

61</h2>

62 

63プラグインは 3 つのポイントで Claude の作業をレビューし、それぞれ異なる深さです：

64 

65* [各ファイル編集時](#on-each-file-edit)：リスキーな呼び出しの高速パターンマッチ、モデル呼び出しなし

66* [各ターンの終了時](#at-the-end-of-each-turn)：そのターンが変更したすべてのバックグラウンドモデルレビュー

67* [Claude が行う各コミットまたはプッシュ時](#on-each-commit-or-push-claude-makes)：周囲のコードを読む深い agentic レビュー

68 

69各レイヤーは [独自のルールを追加](#add-your-own-rules) することで拡張できます。組み込みチェックは個別に削除することはできませんが、各レイヤーは [独立して無効化](#disable-or-uninstall) できます。

70 

71<h3 id="on-each-file-edit">

72 各ファイル編集時

73</h3>

74 

75Claude がファイルに書き込むと、プラグインは新しいコンテンツをスキャンして既知のリスキーなパターンを探します。これはモデル呼び出しのないパターンマッチなので、使用コストは追加されません。

76 

77パターンカテゴリの例：

78 

79* 動的コード実行：`eval(`、`new Function`、`os.system`、`child_process.exec`

80* 安全でないデシリアライゼーション：`pickle`

81* DOM インジェクション：`dangerouslySetInnerHTML`、`.innerHTML =`、`document.write`

82* ワークフローファイル：`.github/workflows/` 下の編集。リポジトリレベルの権限を付与できます

83 

84チェックは編集が完了した後に実行され、警告を Claude の次のステップのコンテキストに追加します。各警告はセッションごとにパターンごとにファイルごとに 1 回発火するため、同じファイル内の繰り返しマッチは会話をあふれさせません。

85 

86`security-patterns.yaml` ファイルを使用して、このレイヤーに [独自のパターンを追加](#add-custom-per-edit-patterns) できます。

87 

88<h3 id="at-the-end-of-each-turn">

89 各ターンの終了時

90</h3>

91 

92ターンは Claude が応答する 1 ラウンドです：メッセージを送信し、Claude が作業して返信し、ターンが終了します。各ターンの後、プラグインはターン中に作業ツリーで変更されたすべてのもの（Claude の編集ツール、Bash コマンド、サブエージェントからの変更を含む）の git diff を計算し、セキュリティに焦点を当てた別の Claude レビューに送信します。レビューはバックグラウンドで実行されるため、Claude の返信は遅延しません。レビューが問題を見つけた場合、Claude は結果を使用して再度プロンプトされ、フォローアップとして対処します。

93 

94これは文字列マッチでは捕捉できない問題をキャッチします。例えば：

95 

96* 認可バイパス

97* 安全でない直接オブジェクト参照

98* インジェクション

99* サーバー側リクエストフォージェリ

100* 弱い暗号化

101 

102セッションで直接、結果と Claude の解決策の両方が表示されます。レビューはターンごとに最大 30 個の変更されたファイルをカバーし、最大 3 回連続で発火してからあなたに戻ります。

103 

104<h3 id="on-each-commit-or-push-claude-makes">

105 Claude が行う各コミットまたはプッシュ時

106</h3>

107 

108Claude が Bash ツールを通じて `git commit` または `git push` を実行すると、プラグインはバックグラウンドで変更の深い agentic レビューを実行します。このレビューは、呼び出し元、サニタイザー、関連ファイルを含む周囲のコードを読んで、結果が実際のものであるかどうかを判断してから報告します。追加のコンテキストは、分離されたときは危険に見えるが、コードベースでは安全なパターンの偽陽性を低く保ちます。

109 

110このレイヤーは、Claude が Bash ツールを通じて行うコミットとプッシュでのみ発火します。独自のシェルから実行するコミット（セッション内の `!` シェルエスケープを含む）はレビューされません。コミットとプッシュレビューはローリング 1 時間あたり 20 に制限されています。コミットレビューの結果がターン終了レビューが既に報告したものと重複する場合、Claude は再度プロンプトされないため、クリーンなコミットはこのレイヤーから目に見える出力を生成しません。

111 

112<h3 id="review-independence-and-limits">

113 レビューの独立性と制限

114</h3>

115 

116プラグインは、コードを書いた同じ Claude インスタンスに自分自身を採点するよう求めません。編集ごとのチェックは、モデルが関与しない決定論的な文字列マッチです。ターン終了とコミットレビューは、新しいコンテキストとセキュリティに焦点を当てたプロンプトを持つ別の Claude 呼び出しとして実行されます：レビュアーは diff から開始し、元のアプローチに投資がなく、問題を見つけるだけの指示を受けます。

117 

118どのレイヤーも書き込みやコミットをブロックしません。結果は書き込み Claude に指示として到達し、Claude は会話で対処し、レビューモデルは問題を見落とす可能性があります。プラグインを完全なセキュリティソリューションではなく、多層防御の 1 つのレイヤーとして扱ってください。[これが他のセキュリティツールとどのように適合するか](#how-this-fits-with-other-security-tools) を参照してください。

119 

120<h2 id="add-your-own-rules">

121 独自のルールを追加する

122</h2>

123 

124プラグインには 2 つの拡張ポイントがあります：モデルバックアップレビュー用の Markdown ガイダンスファイルと、編集ごとの文字列マッチ用の YAML または JSON パターンファイルです。どちらも加算的です。チェックを追加できますが、これらのファイルから組み込みのものを無効化することはできません。

125 

126<h3 id="add-guidance-for-the-model-backed-reviews">

127 モデルバックアップレビュー用のガイダンスを追加する

128</h3>

129 

130プロジェクトに `.claude/claude-security-guidance.md` を作成し、脅威モデルとレビューチェックリストを平文で説明します。モデルバックアップレビューは、組み込みの脆弱性チェックリストと一緒に追加のコンテキストとして読み込みます。

131 

132以下の例は、ロールゲートされた管理ルートとカスタマーデータロギングポリシーを持つウェブサービス用です：

133 

134```markdown .claude/claude-security-guidance.md theme={null}

135# このリポジトリのセキュリティガイダンス

136 

137- INFO レベル以上で `customer_id` または `account_number` をログに記録しないでください。

138- `/admin` 下のすべてのルートは、データベース読み取り前に `require_role("admin")` を呼び出す必要があります。

139- `===` の代わりに `crypto.timingSafeEqual` をトークン比較に使用してください。

140```

141 

142これらのルールはレビュアーのガイダンスであり、決定論的なガードレールではありません。プラグインは違反を Claude が修正するための結果として表示しますが、書き込みをブロックしたり、すべての違反がキャッチされることを保証しません。ガイダンスは加算的のみです：脆弱性クラスを無視するように言うルールはそれらの結果を抑制しません。ハード実装の場合、プラグインを [編集をブロックするフック](/ja/hooks-guide#block-edits-to-protected-files) または CI チェックと組み合わせてください。

143 

144<h3 id="add-custom-per-edit-patterns">

145 カスタム編集ごとのパターンを追加する

146</h3>

147 

148`.claude/security-patterns.yaml` を作成して、[編集ごとのパターンチェック](#on-each-file-edit) に正規表現またはサブストリングルールを追加します。これらは組み込みパターンと一緒に決定論的な文字列マッチとして実行されます：

149 

150```yaml .claude/security-patterns.yaml theme={null}

151patterns:

152 - rule_name: internal_api_key

153 substrings: ["sk_live_", "AKIA"]

154 reminder: "ハードコードされた API キープレフィックス。シークレットマネージャーから認証情報を読み込んでください。"

155 - rule_name: tenant_unfiltered_query

156 regex: "\\.objects\\.all\\(\\)"

157 paths: ["**/src/tenants/**"]

158 reminder: "マルチテナントコードは org_id でフィルタリングする必要があります。"

159```

160 

161| フィールド | タイプ | 説明 |

162| :-------------- | :----- | :------------------------------------------------------------------------------------------ |

163| `rule_name` | string | 警告に表示される識別子 |

164| `reminder` | string | Claude のコンテキストに追加される警告テキスト、1 KB でキャップ |

165| `regex` | string | 編集されたコンテンツに対してマッチされる Python 正規表現 |

166| `substrings` | list | リテラルサブストリング；これまたは `regex` を提供してください |

167| `paths` | list | オプションのグロブパターン；ルールはマッチするファイルにのみ適用されます。グロブはフルファイルパスに対してマッチするため、プロジェクト相対パターンの前に `**/` を付けてください |

168| `exclude_paths` | list | スキップするオプションのグロブパターン；`paths` と同じマッチング |

169 

170プラグインは、同じスキーマで `.claude/security-patterns.yml` と `.claude/security-patterns.json` も読み込みます。JSON はすべての Python インストールで機能します。YAML フォームは PyYAML をインポート可能にする必要があり、プラグインはそれをインストールしません。プラグインは最大 50 個のカスタムルールを読み込み、壊滅的なバックトラッキングの傾向がある正規表現をスキップします。

171 

172<h3 id="rule-file-lookup-locations">

173 ルールファイルの検索場所

174</h3>

175 

176プラグインは、プラグインがどのように有効化されたかに関係なく、同じ場所で `claude-security-guidance.md` と `security-patterns.yaml` を探します：

177 

178| スコープ | パス | 注記 |

179| :--------- | :------------------------------------------ | :---------------------- |

180| ユーザー | `~/.claude/claude-security-guidance.md` | マシン上のすべてのプロジェクトに適用されます |

181| プロジェクト | `.claude/claude-security-guidance.md` | リポジトリでチェックインされます |

182| プロジェクトローカル | `.claude/claude-security-guidance.local.md` | Gitignored、個人的なオーバーライド用 |

183 

184プラグインは存在するすべての場所を読み込み、ガイダンスファイルの合計キャップ 8 KB で連結します。管理者は、デバイス管理を通じて `~/.claude/` にユーザースコープファイルをプッシュすることで、組織全体のルールを配布できます。同じパスが `security-patterns.yaml` に適用されます。

185 

186<h2 id="usage-cost">

187 使用コスト

188</h2>

189 

190[編集ごとのパターンチェック](#on-each-file-edit) はモデル呼び出しを行わず、コストを追加しません。[ターン終了](#at-the-end-of-each-turn) と [コミット](#on-each-commit-or-push-claude-makes) レビューはそれぞれ、他の Claude リクエストと同様に [使用](/ja/costs) にカウントされる追加のモデル使用を費やします。コミットレビューは agentic であり、コミットごとに複数のモデルターンを取る可能性があり、ローリング 1 時間あたり 20 レビューに制限されています。ターンごとにファイルを変更する 1 つのレビュー呼び出しと、コミットごとに 1 つの深いレビューを期待してください。どちらも上記のキャップの対象です。

191 

192両方のモデルバックアップレビューはデフォルトで Claude Opus 4.7 を使用します。`SECURITY_REVIEW_MODEL` を設定して、ターン終了レビュー用に別のモデルを選択し、`SG_AGENTIC_MODEL` をコミットレビュー用に設定します。

193 

194プラグインはすべてのプランで利用可能です。

195 

196<h2 id="disable-or-uninstall">

197 無効化またはアンインストール

198</h2>

199 

200残りを保持しながら個別のレイヤーをオフにするには、マッチング環境変数を設定します：

201 

202| 変数 | 効果 |

203| :------------------------------ | :--------------------------------------------------------- |

204| `ENABLE_PATTERN_RULES=0` | [編集ごとのパターンチェック](#on-each-file-edit) を無効化 |

205| `ENABLE_STOP_REVIEW=0` | [ターン終了 diff レビュー](#at-the-end-of-each-turn) を無効化 |

206| `ENABLE_COMMIT_REVIEW=0` | [コミットとプッシュレビュー](#on-each-commit-or-push-claude-makes) を無効化 |

207| `ENABLE_CODE_SECURITY_REVIEW=0` | すべてのモデルバックアップレビューを一度に無効化 |

208| `SECURITY_GUIDANCE_DISABLE=1` | アンインストールせずにプラグイン全体を無効化 |

209 

210ユーザースコープでプラグインを一時停止するには：

211 

212```text theme={null}

213/plugin disable security-guidance@claude-plugins-official

214```

215 

216ユーザースコープから削除するには：

217 

218```text theme={null}

219/plugin uninstall security-guidance@claude-plugins-official

220```

221 

222プラグインがプロジェクトの `.claude/settings.json` を通じて有効化された場合、`/plugin` から無効化すると、チェックインファイルを編集するのではなく、`.claude/settings.local.json` にオーバーライドを書き込むため、プラグインはあなたにとってオフのままで、チームメイトは影響を受けません。[管理設定](/ja/admin-setup) を通じて有効化された場合、管理者のみがそれを無効化できます。

223 

224<h2 id="how-the-plugin-integrates-with-claude-code">

225 プラグインが Claude Code とどのように統合されるか

226</h2>

227 

228プラグインは完全に [hooks](/ja/hooks) 上に構築されています。これは Claude のループの特定のポイントで独自のコードを実行するメカニズムです。登録されます：

229 

230| フックイベント | 目的 |

231| :--------------------------------------------------------- | :----------------------------------- |

232| `SessionStart` | プラグインの Python 環境をブートストラップ |

233| `UserPromptSubmit` | ターン終了レビューが diff を行う作業ツリーベースラインをキャプチャ |

234| `PostToolUse` on `Edit`、`Write`、`NotebookEdit` | 編集ごとのパターンマッチ |

235| `Stop` | ターン終了 diff レビュー、バックグラウンドで実行 |

236| `PostToolUse` on `Bash`、`git commit` と `git push` にフィルタリング | コミットとプッシュレビュー、バックグラウンドで実行 |

237 

238独自のフックを構築する場合、[プラグインのソース](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/security-guidance) はフックから別のモデル呼び出しを実行し、結果をセッションにフィードバックする実装例です。

239 

240<h2 id="how-this-fits-with-other-security-tools">

241 これが他のセキュリティツールとどのように適合するか

242</h2>

243 

244プラグインは多層防御アプローチの 1 つのレイヤーです。コードがまだエディタにある間に最も早く問題をキャッチしますが、保証ではなく、後の確認を置き換えません。典型的なスタック：

245 

246| ステージ | ツール | カバーするもの |

247| :------ | :----------------------------------------------------- | :---------------------------------------- |

248| セッション内 | Security guidance プラグイン | Claude が書くコードの一般的な脆弱性。同じセッション内で修正 |

249| オンデマンド | [`/security-review`](/ja/commands#all-commands) | 現在のブランチでの 1 回限りのセキュリティパス。要求時に実行 |

250| プルリクエスト | [Code Review](/ja/code-review)、Team および Enterprise プラン | 完全なコードベースコンテキストを持つマルチエージェント正確性とセキュリティレビュー |

251| CI | 既存の静的分析と依存関係スキャナー | 言語固有のルール、サプライチェーンチェック、プラグインが試みないポリシー実装 |

252 

253各後のステージは、前のものが見落とすものをキャッチします。プラグインの価値は、それらに到達するボリュームを削減することであり、それらの必要性を排除することではありません。

254 

255<h2 id="troubleshooting">

256 トラブルシューティング

257</h2>

258 

259プラグインはランタイム診断を `~/.claude/security/log.txt` に書き込みます。レビューが表示されない場合は、まずそこを確認してください。

260 

261レビューレイヤーが会話にメッセージなしでスキップする一般的な理由：

262 

263* ディレクトリが git リポジトリではない：ターン終了とコミットレビューは git 状態を必要とし、リポジトリ外ではスキップします

264* セッションに Anthropic 認証がない：モデルバックアップレビューはスキップされ、編集ごとのパターンチェックのみが実行されます

265* `security-patterns.yaml` ファイルが存在するが PyYAML がインポート可能ではない：ファイルは無視されます。代わりに `security-patterns.json` を使用してください

266 

267<h2 id="related-resources">

268 関連リソース

269</h2>

270 

271このページが触れるピースについてさらに深く掘り下げるには：

272 

273* [Code Review](/ja/code-review)：PR 時のマルチエージェントレビューをセットアップ

274* [フックでワークフローを自動化](/ja/hooks-guide)：同じライフサイクルポイントで独自のチェックを構築

275* [プラグインを発見してインストール](/ja/discover-plugins#official-anthropic-marketplace)：他の公式プラグインを参照