← AIバイブコーディングTips 一覧へ Secrets / 個人開発者向け

APIキーはAIに見せずに編集する

Simon Willisonさんは、スマホからエージェントで作業中に認証情報を書き換える必要が出たとき、値をLLMに通さないための小さな編集画面をエージェントに作らせました。秘密の値だけは別の窓口から人間が入れる。その考え方を、個人開発の運用に落とし込みます。

この記事で手に入るもの

秘密の値がAIの手元に残る3つの経路、「名前はAI・値は人間」という分担の決め方、このブログで実際に使っている値を表示しない確認コマンド2つと、今日できる点検リスト。

01 — きっかけ

「この値だけはAIに渡したくない」を、道具で解決した例

Simon Willisonさんが2026年10月12日に、web-edit 0.1a0という小さなWebアプリを公開しました。ブラウザからフォルダ内のファイルを一覧・閲覧・編集できるPython製のツールです。作った理由がおもしろいものでした。

スマホからCodex Remoteでプロジェクトを進めていたところ、認証情報のファイルを書き換える必要が出てきた。でも、その値はLLMを経由させずに編集したい。チャットに貼れば、値はそのままモデルへの入力になるからです。そこで、ファイルを直接編集できるWeb画面をエージェント自身に作らせた、という経緯です。

01

Tailscale越しに使う前提

公開記事では「Tailscale上で動かすことを想定」と書かれています。エージェントにサーバーを起動させ、本人はスマホからTailscaleの自分専用ネットワーク経由で開く、という使い方です。

02

中身はファイルブラウザ+エディタ

ファイル一覧(名前・サイズ・更新日時)、アップロード、新規作成、2MB未満の画像のインライン表示、テキストファイルの編集。エディタはCodeMirror 6で、Monacoはスマホでの使い勝手がまだ良くないとして見送ったそうです。

03

認証や公開範囲の説明はない

紹介記事には、ログイン機能や、どのフォルダまで触れるかの説明はありません。0.1a0というアルファ版で、自分のネットワークの内側だけで使う道具として読むのが妥当です。インターネットに直接さらす使い方はしないでください。

ツールそのものより参考になるのは、考え方の方です。エージェントが作業している横に、秘密の値だけを扱う別の窓口を置く。この記事では、その考え方を個人開発の運用に落とし込みます。


02 — なぜ別の窓口が要るのか

AIに見せた値は、AIの手元に残り続ける

「キーを書き換えておいて」とAIに値を渡すと、その値は会話の一部になります。会話の一部になった値は、作業が終わっても消えません。

1
モデルへの入力として送られるチャットに貼った値も、エージェントが cat .env で読んだ値も、同じようにモデルへの入力として送信されます。
2
会話履歴やログに残る多くのツールは会話を手元やサーバーに保存します。Copilotを傍受した記事では、ローカルの会話履歴が平文のまま保存されていました。
3
別の出力に混ざる一度コンテキストに入った値は、要約・コミットメッセージ・エラー報告などに書き写されることがあります。本人に悪意がなくても起こります。

つまり、値を見せない一番確実な方法は、最初から値がAIの通り道に乗らないようにすることです。「読んだら忘れて」とは頼めません。web-editは、人間がファイルを直接書き換える経路を用意することで、その通り道を外しました。

この発想は、AIエージェントが脱走してHugging Faceを侵害した事例の教訓とも同じ方向を向いています。エージェントが触れる範囲に強い認証情報があること自体が、事故の大きさを決めていました。


03 — 分担を決める

AIは「名前」まで、人間は「値」を担当する

秘密の値をAIに見せない運用は、仕事の分担を1本の線で分けるだけで作れます。AIはキーの名前と置き場所を扱い、値は人間だけが入れるという線です。

A

AIの担当:枠を作る・名前で参照する

.env.example に FTP_HOST= のような空欄つきのキー一覧を作る。コードは os.environ.get("FTP_PASSWORD") のように名前で参照する。足りないキーがあれば「不足しています」と名前だけを表示する。ここまではAIに任せてかまいません。

B

人間の担当:値を入れる・確かめる

値の入力は、手元のエディタ、パスワード管理ツール、web-editのような別画面など、チャットを通らない経路で行います。スマホしかないときこそ、Simonさんのように別の窓口が役に立ちます。

C

確認は「中身を見ない方法」で

「ちゃんと入ったか」をAIに確かめさせたいときは、値を表示させずに確かめる方法を使います。次の節で、このブログの運用で実際に使っているものを紹介します。

ここが核心。AIに頼むのは「キーの名前と置き場所」まで。値そのものは、チャットを通らない別の窓口から人間が入れる。この線を最初に引いておけば、あとから「見せてしまった値」を探して回る必要がなくなります。


04 — 実際の運用

このブログの公開スクリプトは、値を読まずに動いている

このブログは、毎朝の自動投稿も記事の差し替えも、FTPの接続情報を .env から読むPythonスクリプトで行っています。AIエージェントはスクリプトを実行するだけで、.env を開く必要はありません。

値を読むのはスクリプトで、エージェントのコンテキストに入るのは「アップロード完了」「不足している変数名」といった結果だけです。設定に不足があったとき、スクリプトは不足しているキーの名前だけを表示して止まるように作ってあります。

それでも、エージェントが .env の中身を確かめたくなる場面はあります。そのために、このブログの作業環境では値を出さない確認コマンドを許可リストに入れています。

# キーの名前だけを表示する(値の部分は削って出す)
sed -E 's/^([A-Za-z_]+)[ \t]*=.*/\1/' .env

# 書き換えが反映されたかは、更新日時で確かめる(中身は開かない)
powershell -Command "(Get-Item .env).LastWriteTime"

1つ目は「どのキーが書いてあるか」、2つ目は「人間がさっき書き換えたか」を確かめるものです。どちらも値はAIの画面に出ません。確認したいことは、たいてい値そのものではなくキーがあるか・更新されたかなので、これで足ります。

さらに、うっかり読まないための仕組みも足せます。Claude Codeでは設定ファイルの permissions.deny に "Read(./.env)" や "Read(./secrets/**)" を書くと、そのファイルの読み取りを拒否させられます。ただし、シェル経由の読み方まで確実に塞げるかは使うツールや設定しだいなので、pre-commitフックで"守られないルール"を関所にした記事と同じく、最後の守りはそもそも作業フォルダに強い秘密を置かないことです。


05 — 今日やること

秘密の通り道を、一度だけ点検する

web-editのような道具を作るかどうかは、スマホから作業するかどうかで決めればよいことです。その前に、いまの運用で値がAIの通り道に乗っていないかを確かめておきましょう。

AIにほとんどの作業を任せるほど、「AIに任せない仕事」をはっきりさせる意味が大きくなります。値を入れる作業は数十秒で終わります。その数十秒だけ、AIのいない窓口を使うのが、いちばん安く済む守り方です。