メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

鍵をしまう場所

API キーは、作品のファイルに直接書かず、環境変数という、作品の外の置き場から読み込ませます。手元では .env というファイルに書き、.gitignore に入れて、記録にも GitHub にも入らないようにします。

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

問い

佐藤さんの疑問

鍵は、作品のどこに、どうしまっておけばいいんだろう。

家の形をした鍵掛けの、真ん中のフックに鍵が1本かかっている挿絵。

前の回までで、佐藤さんは、API キー(あなたの利用分で Claude を使うための鍵)を作り、1回の読み取りの料金も試算しました。

この回では、その鍵を、作品のどこにしまえばよいかを見ていきます。

作品のファイルに、直接書かない

いちばん簡単なのは、作品のファイル(app.js など)に、鍵をそのまま書くことです。でも、それをすると、コミット(記録として残すこと)したときに、鍵が記録に入ります。GitHub に送れば、そこにも残ります。第5部の第9回で見たとおり、一度記録に入ったものは、なかなか消せません。

環境変数:作品の外に置く値

そこで、鍵は、作品のファイルの外に置き、作品が動き始めるときに読み込ませます。この、作品の外から渡す値を、環境変数と呼びます。環境は、作品が動いている場所のこと、変数は、名前を付けた入れ物のことです。

Claude API の公式の説明には、こう書かれています。

DOCUMENTATION

“The SDKs and CLI read your key from ANTHROPIC_API_KEY:”

SDK と CLI は、ANTHROPIC_API_KEY から、あなたの鍵を読み込みます。

AnthropicGet started(Claude API Docs)

SDK は、作品から Claude API を使いやすくするための、公式の部品(第4部の第11回で見たライブラリ)です。つまり、ANTHROPIC_API_KEY という名前の環境変数に鍵を入れておけば、作品は、そこから鍵を読み込めます。作品のファイルには、鍵そのものではなく、「ANTHROPIC_API_KEY から読む」とだけ書かれます。

.env:手元で環境変数を書いておくファイル

手元で作っているあいだは、環境変数を、.env(ドット・エンブ)という名前のファイルに書いておくことが多いです。第1部の第5回で、隠しファイルの例として名前だけ出てきたファイルです。

Claude のヘルプセンターには、.env を使うなら、必ず .gitignore(記録に入れないものの一覧。第5部の第10回)に入れるように、と書かれています。

鍵は .env に、記録の外に

概念図。色を敷いた区画が作業フォルダ

作業フォルダ(urenokori) app.js 鍵の名前だけ書く .env 鍵そのもの .gitignore 記録しない一覧 GitHub 記録を送る先 鍵を読み込む 送る 送らない 作業フォルダ(urenokori) app.js 鍵の名前だけ書く .env 鍵そのもの .gitignore 記録しない一覧 鍵を読み込む 送る 送らない GitHub 記録を送る先
図1鍵は .env に入れ、.gitignore で、記録にも GitHub にも入らないようにします。

佐藤さんの、鍵のしまい方

鍵そのものは、Claude との会話に貼りません(第6部の第2回)。そこで、入れ物だけを Claude に作ってもらい、鍵は自分で入れます。

鍵の入れ物を作ってもらう例
作品から Claude API を使えるようにしたいです。API キーは、ANTHROPIC_API_KEY という環境変数から読み込むようにしてください。手元用に .env を作り、中身は「ANTHROPIC_API_KEY=」の1行だけにして、値は空にしておいてください。鍵は私が自分で入れます。.env が .gitignore に入っているかも確かめてください。

この依頼文は、説明のための架空の例です。

できたら、自分で鍵を入れます。

  1. デスクトップアプリで、会話の欄の上の、ボタンが横に並んだ帯(第4部の第5回)にある「Files」を押す。ファイルの一覧が出る枠が開くので、.env を押して開く。見当たらなければ、Claude に開き方を聞く
  2. 第6部の第2回でしまった鍵(パスワードを管理するアプリなど)をコピーし、「ANTHROPIC_API_KEY=」のすぐ後ろに貼り付ける。空白は入れない
  3. 保存のボタンは押さなくてよい。Claude Code の公式の説明によると、Files の枠での書き換えは、初期設定では、そのまま自動で保存される
  4. Claude に「.env を書き換えたので、開発サーバー(手元で作品を動かす仮のサーバー)を動かし直してください」と頼む。環境変数は、作品が動き始めるときに読み込まれるため

Claude Code は、作業フォルダの中のファイルを読めるので、.env の中身を読むこともあります。それでも会話に鍵を貼らないのは、会話の記録や、画面の写真から鍵が漏れるのを減らすためです。

鍵は、作品のファイルに直接書かず、環境変数として外から渡します。手元では .env に書き、.gitignore に入れます。

注意

ただし、.gitignore に入っているかを、必ず確かめる

.env が .gitignore に入っていないと、次のコミットで、鍵が記録に入ります。依頼文の例で「確かめてください」と頼んだのは、そのためです。

コミットの前には、第5部の第10回で見たとおり、記録に入るファイルの一覧を見せてもらい、.env が入っていないことを、自分の目でも確かめます。

次回の問い

佐藤さんの次の疑問です。それでも鍵が漏れてしまったら、どうすればよいのでしょうか。

参考

API キーのベストプラクティス(Claude ヘルプセンター)
.env と .gitignore の扱いを含む、鍵の扱いの注意。日本語。
support.claude.com · support.claude.com
Vibe Coding 用語集:環境変数
環境変数の説明と、.env との関係。
AMPL · Web

このレッスンは役に立ちましたか?