作ったばかりの API キーは、長い英数字の並びです。佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)は、なくさないように、売れ残り帳のファイルの中に書いておこうとして、手を止めました。
問い
佐藤さんの疑問
鍵は、作品のどこに、どうしまっておけばいいんだろう。

前の回までで、佐藤さんは、API キー(あなたの利用分で Claude を使うための鍵)を作り、1回の読み取りの料金も試算しました。
この回では、その鍵を、作品のどこにしまえばよいかを見ていきます。
作品のファイルに、直接書かない
いちばん簡単なのは、作品のファイル(app.js など)に、鍵をそのまま書くことです。でも、それをすると、コミット(記録として残すこと)したときに、鍵が記録に入ります。GitHub に送れば、そこにも残ります。第5部の第9回で見たとおり、一度記録に入ったものは、なかなか消せません。
環境変数:作品の外に置く値
そこで、鍵は、作品のファイルの外に置き、作品が動き始めるときに読み込ませます。この、作品の外から渡す値を、環境変数と呼びます。環境は、作品が動いている場所のこと、変数は、名前を付けた入れ物のことです。
Claude API の公式の説明には、こう書かれています。
“The SDKs and CLI read your key from ANTHROPIC_API_KEY:”
SDK と CLI は、ANTHROPIC_API_KEY から、あなたの鍵を読み込みます。
SDK は、作品から Claude API を使いやすくするための、公式の部品(第4部の第11回で見たライブラリ)です。つまり、ANTHROPIC_API_KEY という名前の環境変数に鍵を入れておけば、作品は、そこから鍵を読み込めます。作品のファイルには、鍵そのものではなく、「ANTHROPIC_API_KEY から読む」とだけ書かれます。
.env:手元で環境変数を書いておくファイル
手元で作っているあいだは、環境変数を、.env(ドット・エンブ)という名前のファイルに書いておくことが多いです。第1部の第5回で、隠しファイルの例として名前だけ出てきたファイルです。
Claude のヘルプセンターには、.env を使うなら、必ず .gitignore(記録に入れないものの一覧。第5部の第10回)に入れるように、と書かれています。
鍵は .env に、
概念図。
佐藤さんの、鍵のしまい方
鍵そのものは、Claude との会話に貼りません(第6部の第2回)。そこで、入れ物だけを Claude に作ってもらい、鍵は自分で入れます。
作品から Claude API を使えるようにしたいです。API キーは、ANTHROPIC_API_KEY という環境変数から読み込むようにしてください。手元用に .env を作り、中身は「ANTHROPIC_API_KEY=」の1行だけにして、値は空にしておいてください。鍵は私が自分で入れます。.env が .gitignore に入っているかも確かめてください。この依頼文は、説明のための架空の例です。
できたら、自分で鍵を入れます。
- デスクトップアプリで、会話の欄の上の、ボタンが横に並んだ帯(第4部の第5回)にある「Files」を押す。ファイルの一覧が出る枠が開くので、.env を押して開く。見当たらなければ、Claude に開き方を聞く
- 第6部の第2回でしまった鍵(パスワードを管理するアプリなど)をコピーし、「ANTHROPIC_API_KEY=」のすぐ後ろに貼り付ける。空白は入れない
- 保存のボタンは押さなくてよい。Claude Code の公式の説明によると、Files の枠での書き換えは、初期設定では、そのまま自動で保存される
- Claude に「.env を書き換えたので、開発サーバー(手元で作品を動かす仮のサーバー)を動かし直してください」と頼む。環境変数は、作品が動き始めるときに読み込まれるため
Claude Code は、作業フォルダの中のファイルを読めるので、.env の中身を読むこともあります。それでも会話に鍵を貼らないのは、会話の記録や、画面の写真から鍵が漏れるのを減らすためです。
鍵は、作品のファイルに直接書かず、環境変数として外から渡します。手元では .env に書き、.gitignore に入れます。
注意
ただし、.gitignore に入っているかを、必ず確かめる
.env が .gitignore に入っていないと、次のコミットで、鍵が記録に入ります。依頼文の例で「確かめてください」と頼んだのは、そのためです。
コミットの前には、第5部の第10回で見たとおり、記録に入るファイルの一覧を見せてもらい、.env が入っていないことを、自分の目でも確かめます。
次回の問い
佐藤さんの次の疑問です。それでも鍵が漏れてしまったら、どうすればよいのでしょうか。