AI生成コードとGitコミットからシークレットを締め出す方法

AIコーディングエージェントは高速だが、ひとつ盲点がある。APIキーを平気でファイルに貼り付け、トークンをログに出力し、ローカルに留めておきたかった.envを平然とコミットしてしまうのだ。ターミナルにアクセスできるすべてのエージェント（Claude Code、Cursor、Gemini CLI、Codex）は、あなたのシェル設定やプロジェクトファイルも読み取れる。そしてそこは、まさに認証情報が潜みがちな場所でもある。本ガイドでは、シークレットをAI生成コードからもGitの履歴からも締め出すための、実践的で多層的なセットアップを順を追って解説する。

なぜAI時代にこれがいっそう重要なのか

キーの漏洩はソフトウェアにおいて最もよくある、そして最も高くつくミスのひとつであり、AIアシスタントはそのリスクを2つの面で引き上げる。第一に、AIはコードを高速に生成するため、ハードコードされたキーが、あなたが気づく前に何十ものファイルに紛れ込みかねない。第二に、エージェントはコンテキストを貪欲に取り込む。あるシークレット管理の解説記事が述べているように、シェル設定はキーを参照すべきであって、含んではならない。エージェントはあなたのドットファイルが露出させているものなら何でも読めるからだ。解決策はツールを信用しないことではなく、そもそもツールが見つけられる平文のシークレットを一切残さないことだ。

ステップ1: シークレットは環境変数に置き、決してコードに書かない

基本ルールはこうだ。APIキー、パスワード、トークンは、ソースコード中にリテラル文字列として現れてはならない。これらはプロジェクトのルートにある.envファイルに置き、実行時に読み込む。

# .env  — never committed
ANTHROPIC_API_KEY=sk-ant-...
DATABASE_URL=postgres://...

// app.js — reads from the environment, no secret in the file
const apiKey = process.env.ANTHROPIC_API_KEY;

こうすれば、あなた（そしてあなたのAIエージェント）が編集するコードには、シークレットの名前だけが含まれ、その値が含まれることは決してない。

ステップ2: .envが絶対にコミットされないようにする

シークレットを1文字でも書く前に、これを.gitignoreへ追加しておく。

.env
.env.local
*.env

代わりに、空のプレースホルダーを入れた.env.exampleをコミットし、どの変数を設定すべきか共同作業者に分かるようにする。

ANTHROPIC_API_KEY=
DATABASE_URL=

すでに本物の.envをコミットしてしまった場合、新しいコミットでそれを削除するだけでは不十分だ。それは履歴の中に残り続ける。露出したキーは直ちにローテーション（再発行）し、漏洩したものとして扱うこと。

ステップ3: GitHubのプッシュ保護を有効にする

GitHubのプッシュ保護は、プッシュ時にコミットをスキャンし、シークレットを検出するとそのプッシュをブロックして、漏洩がリモートに到達する前に食い止める。AWS、OpenAI、Stripeなどのプロバイダーをはじめとする200種類を超えるシークレットのパターンを認識し、2026年のアップデートではデフォルトでブロックされるパターンが拡張された。パブリックリポジトリでは無料で利用でき、リポジトリの Settings → Code security から有効化できる。エージェント（やあなた自身）がついうっかりミスをした瞬間のためのシートベルトだと考えればよい。

ステップ4: エージェントにシェル設定を収集させない

シェルにアクセスできるエージェントは、.zshrc、.bashrc、.zshenvを読み取れる。便利だからとそこにキーをexportしていれば、エージェントはそれを見られてしまう。マシン全体で使うシークレットはドットファイルから外しておくこと。シェル起動時に平文をexportするのではなく、必要なときにシークレットマネージャーやOSのキーチェーンから読み込むようにする。

ステップ5: 権限を絞り、ローテーションする

万一漏洩したときの被害を抑える2つの習慣がある。これはOpenAIのAPIキー安全ガイドでも繰り返し説かれているアドバイスだ。

• 最小権限の原則: 各キーには必要最小限の範囲だけを与え、プロジェクトごと・環境ごとに別々のキーを使うことで、ひとつの漏洩がすべてを露出させないようにする。
• 定期的なローテーション: キーは定期的にローテーションし、露出が疑われた時点で直ちに入れ替える。ローテーション済みのキーなら、侵害も大事に至らずに済む。

簡単なチェックリスト

エージェントをリポジトリに放つ前に、次を確認しよう。

1. シークレットは.envに置き、process.env経由で読み込む。決してハードコードしない。
2. .envは.gitignoreに入っており、コミットするのは.env.exampleだけ。
3. リモートでプッシュ保護が有効になっている。
4. シェルのドットファイルに平文のキーがない。
5. キーは範囲が絞られ、定期的にローテーションされている。

どれも一度設定してしまえば作業の足を引っ張ることはない。それどころか、はるかに心配事を減らした状態で、より多くの仕事をAIエージェントに任せられるようになる。