「AIツールを使うと便利だが、顧客データや内部仕様書をプロンプトに貼り付けて大丈夫なのか?」——この疑問は、Claude Codeを企業導入する際に最も多く寄せられる声のひとつです。開発生産性を高めたい一方で、機密情報の漏洩リスクを見過ごすわけにはいかない。多くのエンジニアリーダーや情報セキュリティ担当者が、このジレンマに直面しています。
本記事では、Claude Codeにおけるプロンプトエンジニアリングの観点から機密情報を保護するための具体的な設計原則を解説します。CLAUDE.mdを活用したポリシー実装、Hooksによる自動チェック、そしてコンプライアンス監査を見据えたプロンプト設計まで、実践的なアプローチを体系的にお伝えします。
プロンプトへの機密情報混入が引き起こすリスク
Claude Codeを使った開発では、コードのレビューや仕様書の要約など、日常的にさまざまなテキストをプロンプトとして入力します。このとき、意識せずに機密情報を含めてしまうケースが少なくありません。「少し貼り付けるだけだから大丈夫」という軽い判断が、企業全体のリスクにつながることがあります。
コンテキストウィンドウに残るデータのリスク
Claude Codeはセッション中のコンテキストをメモリに保持します。たとえば、DBの接続文字列をデバッグのためにプロンプトに貼り付けた場合、その情報はセッション全体のコンテキストに残り続けます。チームで共有する設定や、CI/CDパイプラインでの自動化処理においては、この「コンテキスト汚染」が予期せぬ情報流出につながる可能性があります。複数の開発者が同じプロジェクト設定を使い回す環境では、一人の操作が他のメンバーへも影響を及ぼしかねません。
プロンプト履歴と監査ログの死角
多くの企業では、ソースコードやコミット履歴は厳格に管理されていても、AIへの入力プロンプト履歴は管理外になっているケースがあります。個人情報、APIシークレット、内部仕様に関わるテキストがプロンプトを通じて処理された場合、それをあとから追跡・証明できなければ、コンプライアンス上の問題が生じます。個人情報保護法やGDPRへの対応を進める企業にとって、この「見えない操作ログ」は大きな死角です。
業務のシステム化・AI活用のご相談は 30分の無料相談 へ(合同会社ジョインクラス)
CLAUDE.mdで実現する機密情報保護ポリシー
Claude Codeには、プロジェクトルートにCLAUDE.mdを配置することで、AIの挙動に対するガイダンスを与える仕組みがあります。この機能は単なるコーディング規約の共有にとどまらず、機密情報の取り扱いに関するポリシーをAIに直接伝える手段としても活用できます。
CLAUDE.mdに定義すべき機密情報ポリシーの書き方
以下は、CLAUDE.mdにおける機密情報保護ポリシーの記述例です。
# セキュリティポリシー
## 機密情報の取り扱い
- 本番環境の接続文字列(DBパスワード、APIキー等)はプロンプトに含めないこと
- 顧客の個人情報(氏名、メールアドレス等)は必ずマスキングした形式で共有すること
- 環境変数の値は直接貼り付けず、変数名のみを提示すること
- 内部の未公開仕様書は担当者の承認を得た範囲に限定すること
## シークレット管理
- AWS_SECRET_ACCESS_KEY、DATABASE_URLなどの変数名は参照可能だが値の共有は禁止
- Vault / AWS Secrets Managerから取得したシークレットの値は絶対に共有しないこと
CLAUDE.mdは個人のホームディレクトリ(グローバル設定)とプロジェクトルート(プロジェクト設定)の両方に配置できます。機密情報ポリシーはプロジェクト単位のCLAUDE.mdに定義することで、チームメンバー全員が同じ基準で利用できるようになります。Gitリポジトリに含めれば、新メンバーがcloneした時点でポリシーが自動適用されます。
既存のセキュリティポリシーとの連携
CLAUDE.mdをGitリポジトリに含めることで、チーム全体に統一された基準を適用できます。既存のセキュリティポリシー文書(社内規程やISMS関連文書)からエッセンスを抜き出してCLAUDE.mdに反映させることで、既存のコンプライアンス体制との整合性も保てます。Claude Codeのセキュリティとコンプライアンスを両立する実践ガイドも合わせて参照すると、ポリシー設計の全体像が掴みやすくなります。
機密情報を含まないプロンプト設計の実践テクニック
CLAUDE.mdでポリシーを定義したら、次は実際のプロンプト設計における具体的なテクニックを押さえましょう。ポリシーを「知っている」ことと「正しく実践できる」ことは別物です。開発者一人ひとりが使える手法を標準化することが重要です。
データマスキングとプレースホルダーの活用
機密情報を含むコードをレビューしてもらう場合、実際の値をプレースホルダーに置き換えてからプロンプトに渡す方法が有効です。
悪い例(機密情報がそのまま含まれている):
以下のコードをレビューしてください。
const db = new Client({
host: "prod-db.example.com",
password: "xK9#mN2@pL7qR",
database: "customers_prod"
});
良い例(マスキング済み):
以下のコードをレビューしてください。接続先はPostgresDBです。
const db = new Client({
host: process.env.DB_HOST,
password: process.env.DB_PASSWORD,
database: process.env.DB_NAME
});
環境変数への参照に置き換えるだけで、機密情報をプロンプトから切り離せます。クエリのロジックやコードの品質に関するレビューは、実際の値がなくても十分に行えます。
コンテキスト分離の原則
「本番環境の問題をAIに調査させたい」という状況では、実際の本番データをそのまま貼り付けるのではなく、以下のアプローチを取ることを推奨します。
- サンプリングと匿名化: 本番ログから個人情報に関連するフィールドを除去・仮名化してから渡す
- スキーマのみ共有: データの中身ではなく、テーブル定義やフィールド名のみをプロンプトに含める
- 問題の抽象化: 「Nレコードで発生するパフォーマンス問題」のように、具体的なデータなしで問題の本質を伝える
本番データの代わりにフィクスチャデータ(テスト用ダミーデータ)を使う習慣をチームに定着させましょう。AIとのやり取りには最初からフィクスチャを使うというルールをCLAUDE.mdに明記しておくと効果的です。フィクスチャ生成スクリプトをリポジトリに含めておくと、チーム全員がすぐに使えます。
HooksによるプロンプトのセキュリティチェックをCI/CDに組み込む
Claude CodeのHooks機能を使うと、AIへのリクエストが送信される前後に任意のスクリプトを実行できます。これを活用して、プロンプトに機密情報が含まれていないかを自動チェックする仕組みを導入できます。
// .claude/settings.json(Hooksの設定例)
{
"hooks": {
"PreToolUse": [
{
"matcher": ".*",
"hooks": [
{
"type": "command",
"command": "scripts/check-sensitive-data.sh"
}
]
}
]
}
}
check-sensitive-data.shの中では、正規表現を使ってAPIキーのパターン(例: sk-[a-zA-Z0-9]{48})や、IPアドレス、メールアドレスなどが含まれていないかを検査できます。チェックに引っかかった場合はユーザーに警告を出し、送信をブロックする実装も可能です。
Hooksによる自動チェックは「気づき」を促すセーフティネットとして機能します。完璧な検知は難しいため、あくまでHooksは補助的な手段と位置づけ、根本的にはCLAUDE.mdのポリシーと開発者教育を中心に据えることが重要です。自動化に頼りすぎず、定期的なポリシーレビューと組み合わせましょう。
コンプライアンス対応を見据えたプロンプト管理
個人情報保護法やGDPR、SOC2などのコンプライアンス要件に対応するためには、AIを使った開発プロセスにおいても適切な記録と証跡が求められます。プロンプト設計の段階からこれを意識しておくことが、後々の監査対応を大幅に楽にします。
プロンプト操作の監査ログ設計
「誰が、いつ、どのような情報をAIに渡したか」を追跡できる体制を整えることは、インシデント発生時の調査においても、平時の内部監査においても重要です。具体的には以下の情報を記録する設計を検討してください。
| 記録項目 | 目的 | 保持期間の目安 |
|---|---|---|
| ユーザーID・タイムスタンプ | 操作者の特定 | 1年以上 |
| プロンプトのカテゴリ・分類 | 機密情報の取り扱い状況把握 | 1年以上 |
| 使用したツール・ファイルパス | アクセスしたリソースの追跡 | 6ヶ月以上 |
| 異常検知フラグ | ポリシー違反の早期発見 | インシデント解決まで |
シークレット管理との統合
プロンプト設計と密接に関わるのが、シークレット管理の仕組みです。たとえばAWS Secrets ManagerやHashiCorp Vaultを使って機密情報を集中管理している場合、その値をコードやプロンプトにハードコードしないというルールをCLAUDE.mdで明示することが大切です。Claude CodeのAPI連携セキュリティ完全ガイドでは、シークレット管理から認証保護までの具体的な方法論を解説しています。プロンプト設計と組み合わせることで、より強固なセキュリティ体制を構築できます。
まとめ:プロンプト設計からはじめる機密情報保護
Claude Codeの企業導入において、機密情報保護のためのプロンプト設計は「後付けのセキュリティ対策」ではなく、開発プロセスの設計段階から組み込むべき基盤です。今回ご紹介したアプローチを実践することで、開発生産性を落とすことなく、組織のセキュリティレベルを継続的に高めることができます。
- プロンプトへの機密情報混入は「コンテキスト汚染」「監査ログの死角」という固有のリスクを生む
- CLAUDE.mdにセキュリティポリシーを定義することで、チーム全員が統一された基準でAIを利用できる
- データマスキング・プレースホルダー活用・コンテキスト分離の3テクニックでプロンプトの安全性を高める
- Hooksを使った自動チェックをセーフティネットとして導入し、ポリシー違反を早期発見する
- 監査ログの設計をプロンプト設計段階から考慮し、コンプライアンス対応を効率化する
これらの対策を体系的に理解し、自社の環境に合わせて実装するための詳細なガイドラインを、企業のためのClaude Codeセキュリティガイドにまとめています。CLAUDE.mdのテンプレートからHooksの実装例、コンプライアンス対応のチェックリストまで、実践に役立つ情報を網羅しています。企業でのClaude Code導入を検討されている方は、ぜひ参考にしてください。



