今回の事例で獲得した成果
- AIエージェントで点検する仕組みを、作業時間1時間で構築しました。 Claude Code を使い、①AIエージェントに点検を任せるための指示書と、値を出さずに秘密情報を探すスクリプト、②社員が自分のPCで設定を見直す13の手順をまとめた手順書、③その手順を1ページずつ進める25枚の説明スライドを作成しました。作業は2026年11月15日から17日の3日間に分けて行いました。作業時間1時間のうち、人による確認・修正は15分です。
- 点検するAI自身が秘密情報を読まない仕組みにしました。 AIエージェントに設定ファイルを直接読ませると、秘密情報がAIの会話ログにも残ります。そこで、ファイルの中身は必ずスクリプトに通し、スクリプトは「場所・行番号・種類・接続先」だけを出力して、値は出力しない設計にしました。
- 非エンジニアでも進められる形にしました。 手順書では見直す場所を「PCに1つだけある全体の設定」と「作業したフォルダごとの設定」の2つに分けて説明しました。スライドでは各手順に画面のイメージと「見る場所」の表示を付けました。
取り組んだ課題
2026年11月、セキュリティ企業の Apiiro が、Claude Code の設定ファイルから秘密情報が漏れている事例を公開しました(Apiiro「Coding Agents Are Leaking Your Secrets to GitHub」)。
Claude Code はコマンドを実行する前に利用者に許可を求めます。利用者が「Yes, and don't ask again(今後は確認しない)」を選ぶと、Claude Code はそのコマンドを文字列のまま、プロジェクトの .claude フォルダにある個人用の設定ファイルに、許可ルールとして保存します。コマンドにデータベースのパスワードや API のトークンが入っていれば、それも一緒に保存されます。このファイルがほかのコードと一緒にコミットされ、GitHub で公開されていた例を、Apiiro は1,000件以上見つけています。
当社でも、社員が日常的に Claude Code を使っています。誰のPCの、どの設定ファイルに、何が残っているかは分かっていませんでした。 点検するには、次の2つが必要でした。
- GitHub 上と社員のPCにある設定ファイルを、まとめて調べる方法
- 社員一人ひとりが自分の設定を見直して片付ける方法
実施内容の概要
人とAIの役割
| 担当 | 役割 |
|---|---|
| 人 | 記事を読む範囲と、作るものを決める。構成案を承認する。手順書の抜けを指摘する(全体の設定とフォルダごとの設定のどちらを見るのかが書かれていない、など)。対象をWindowsに絞る、画面の図をイメージで作る、といった方針を決める |
| Claude Code | 記事を日本語で要約する。指示書・スクリプト・手順書・スライドを作る。設定ファイルの仕様を公式ドキュメントで確かめる。ダミーのデータでスクリプトを試す。スライドを画像に書き出して、表示の崩れを確かめる |
利用環境
- Claude Code(デスクトップアプリ)、Windows 11
- 文章の推敲には日本語を推敲するスキル(yomiyasu)を使用
- スライドは HTML の1ファイルで作成し、当社のデザインの決まりに合わせた
作成したもの
| 作成物 | 内容 |
|---|---|
| 点検用の指示書 | AIエージェントに読ませて実行させる手順。GitHub 上の現在のファイル、全リポジトリの履歴、社員のPCの3か所を調べ、見つかったものに優先度を付けて報告書にまとめる。ファイルの削除やコミットはさせず、確認と報告だけを任せる |
| スキャン用のスクリプト | ファイルの中から秘密情報らしき記述を探し、値を出さずに場所と種類だけを出力する |
| 見直しの手順書 | 社員が自分のPCで進める13の手順。「漏れ口を塞ぐ → 中身を片付ける → 防ぐ設定を入れる → 使い方を変える」の4段階 |
| 説明スライド | 手順書を1ページずつ進める25枚のスライド。画面の図はすべて、実際の画面に似せたイメージで作り、値は伏せた |
進め方
- Claude Code が記事を読み、日本語で要約しました。
- 人が「これを確認するための指示を作って」と頼み、Claude Code が手順書の初版を作りました。
- 人が「人間ではなくAIエージェントにやらせたい」と方針を変え、Claude Code が指示書とスクリプトに作り直しました。
- Claude Code が利用者ごとに見直す設定の手順書を作りました。設定ファイルの場所や優先順位は、別のエージェントに公式ドキュメントを調べさせて確かめました。
- 人が手順書を読み、「全体の設定とプロジェクトごとの設定のどちらを見るのかが書かれていない」と指摘しました。Claude Code が2つの場所の説明と、各手順で見る場所を追記しました。
- Claude Code が手順書をもとにスライドの構成案を出し、人が承認してから、スライドを作りました。
結果と検証条件
| 項目 | 内容 |
|---|---|
| 実施企業 | 株式会社アリストル |
| 対象 | Claude Code の設定ファイル(許可ルール、環境変数、MCP の設定、メモ類、会話ログ) |
| 実施時期 | 2026年11月15日〜17日 |
| 作成したもの | 点検用の指示書とスクリプト、見直しの手順書(13の手順)、説明スライド(25枚) |
| スクリプトの確認 | ダミーの設定ファイルで、パスワード入りのコマンド、接続文字列、API キーなどを検出し、変数で参照しているだけのルールは検出しないことを確かめた。出力に値が含まれないことも確かめた |
| 作業時間 | 合計1時間(2026年11月15日〜17日の3日間に分けて実施) |
| 人による確認・修正の時間 | 15分(作業時間1時間に含む) |
この結果は当社の取り組みの記録です。同じ方法で同じ結果が得られることを示すものではありません。
うまくいかなかったこと・適用上の限界
- 最初の手順書は、人が手作業で進める前提でした。 点検の対象は、GitHub 上の全リポジトリの履歴と社員のPCに広がります。人が1件ずつ確かめるのは現実的でないため、途中でAIエージェントに任せる形に作り直しました。
- 作成中に、AI自身の作ったものにも誤りが見つかりました。
- スキャン用のスクリプトが同じ1行を2種類の秘密情報として二重に数えていました。ダミーのデータで試したときに気づき、直しました。
- 手順書では
.gitignoreに1行を足す方法としてechoコマンドを案内していました。Windows PowerShell 5.1 でechoを使って追記すると、ファイルが UTF-16 という文字コードで書かれ、git が追記した行を正しく読めないおそれがあります。対象を Windows に絞ったときに気づき、メモ帳で書き足す方法に改めました。 - スライドの用語集で、許可ルールの説明が「確認なしで実行してよいコマンドの一覧」となっており、毎回確認する ask や禁止する deny と食い違っていました。
- 手順書の抜けは人の指摘で見つかりました。 Claude Code が作った手順書には、「全体の設定」と「作業したフォルダごとの設定」のどちらを見るのかが書かれていませんでした。設定ファイルの場所を知らない人には、どこを開けばよいかが分かりません。
- 画面の図は実際の画面ではありません。 スライドの画面の図は実際の画面に似せたイメージです。とくに Claude Code の許可ルールの一覧や、許可を求める画面は、実際の表示と異なる可能性があります。
- 公式ドキュメントで確かめられなかった点があります。 デスクトップアプリで「今後は確認しない」を選んだときに、ルールが同じ設定ファイルに保存されるかは、公式ドキュメントに記載がありませんでした。手順書では同じ扱いにしています。
- 本稿は点検する仕組みを構築するまでの記録です。 作成した手順で秘密情報をどの程度見つけられるかは、本稿では扱っていません。
他の企業で検討する際のポイント
- 点検をAIに任せるときは、AIに値を見せない仕組みにする。 AIエージェントに設定ファイルを読ませると、点検のたびに秘密情報がAIの会話ログに残ります。中身は値を出さないスクリプトに通し、AIには場所と種類だけを渡すことを勧めます。あわせて、AIに任せるのは確認と報告までにし、削除やローテーションは人が行う形にすると、作業の範囲を区切りやすくなります。
- 「見直す場所」を最初に説明する。 Claude Code の設定はPC全体の設定と、作業したフォルダごとの設定に分かれています。非エンジニアに見直しを頼むときは、手順に入る前に、どこにあるファイルを見るのかを説明することが大切です。
- 社員のPCのOSに合わせて手順を確かめる。 同じコマンドでも、OSやシェルによって結果が変わることがあります。手順書を配る前に、社員が実際に使う環境で手順を試すことを勧めます。
- AIが作った手順書も、人が読んで確かめる。 今回は、人が読んだことで手順書の抜けが見つかり、AIが試したことでスクリプトの不具合が見つかりました。AIに作らせた手順書をそのまま配るのではなく、人が読む工程と、ダミーのデータで試す工程を入れることを勧めます。
許可ルールの書き方や設定ファイルの優先順位は、コラム「Claude Code の権限設定(permissions)早見表」で、社内で運用ルールを作るときの論点は「Claude Code を安全に社内利用するための権限・セキュリティ設計」で解説しています。
