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

本番にも鍵を渡す

手元の鍵は、GitHub を通らないので、置いた先には届いていません。本番で使う鍵は、置き場の環境変数に、自分で入れます。入れたあとは、置き直して確かめます。

置いた売れ残り帳を、佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)は、自分のスマホで開きました。画面は出ます。ところが、試し用に書いたノートを「写真を撮る」で撮ると、「読み取りに失敗しました」と出ました。手元では、同じ写真で動いていたのに。

問い

佐藤さんの疑問

手元では動くのに、置いた先で、読み取りだけが動かないのは、なぜだろう。

形の少し違う2本の鍵が、それぞれ白い札を付けて並んでいる挿絵。

前の回で、売れ残り帳を Vercel に置きました。この回では、置いた先で読み取りが動くように、鍵を渡します。コードを作り直す前に、場所ごとの設定を見ます。

置いた先には、鍵がない

第6部の第4回で、API キー(作品から Claude を使うための鍵)は、.env(手元で環境変数を書いておくファイル)にしまいました。そして .gitignore(記録に入れないものの一覧)に書いて、GitHub に送らないようにしました。

Vercel は、GitHub から作品を受け取ります。だから、鍵は届いていません。読み取りが動かないのは、鍵が GitHub に出ていない、という証拠でもあります。

鍵は、GitHub を通さずに渡す

佐藤さんの鍵の置き場所

手元 .env 作るとき用の鍵 GitHub 鍵はない .gitignore で送らない Vercel 環境変数 本番用の鍵(Secret) 手元 .env 作るとき用の鍵 GitHub 鍵はない .gitignore で送らない Vercel 環境変数 本番用の鍵(Secret)
図1GitHub に鍵がないので、置いた先にも鍵は届きません。本番の鍵は、置き場に直接入れます。

本番の環境変数

置いた先で使う設定の値を、この講座では、本番の環境変数と呼びます。環境変数は、第6部の第4回で見た、作品の外から渡す値でした。Vercel の公式の説明には、こう書かれています。

DOCUMENTATION

“Environment variables are key-value pairs configured outside your source code so that each value can change depending on the Environment. These values are encrypted at rest.”

環境変数は、ソースコードの外で設定する、名前と値の組です。環境ごとに、値を変えられます。値は、しまってあるあいだ、暗号化されています。

VercelEnvironment variables(Vercel Docs)

ソースコードは、第4部の第5回で見た、作品の元になる文のことです。暗号化は、ほかの人が読めない形に変えて、しまっておくことです。

名前と値は、別のものです。たとえば ANTHROPIC_API_KEY は、設定の名前です。本物の鍵の文字の並びが、値です。名前は、手元の .env と同じにします。

名前は Claude に聞き、値は自分で入れる

まず、Claude Code(会話で頼むと、作品を作ったり直したりしてくれる道具)に、要る名前を聞きます。

本番に要る環境変数を聞く例
この作品を Vercel の本番で動かすのに要る環境変数の、名前と用途を一覧にしてください。値は表示しないでください。値をブラウザに届けてしまう名前の付け方になっていないかも、確かめて教えてください。

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

値は、自分で入れます。Vercel の公式の説明によると、プロジェクトの「Settings」(設定)を開き、画面の左側に並んだ項目の中の「Environment Variables」で、名前と値を入れます。入れるときに、次の2つを選びます。

  • 種類:Config(あとで読める)と Secret(保存したら読めない)がある。API キーは Secret にする
  • 使う環境:Production(本番)、Preview(試しの版)、Development(手元)。本番で使うなら Production を選ぶ
vercel.com/docs/environment-variables
Vercel の公式の説明のページ「Environment variables」。環境変数はソースコードの外で設定する名前と値の組で、Config の値は読めるまま、Secret の値は保存後は書き込みだけになる、と書かれ、変更は前のデプロイには効かず、新しいデプロイにだけ効く、とある。
Vercel の公式の説明のページ(英語、2026年11月11日に撮影)。Secret の値は、保存したあとは読めなくなる、と書かれています。ログインしなくても読めます。

入れる鍵は、本番用に新しく作ったものにします。第6部の第2回で見たとおり、作っている途中用と、本番用で、鍵を分けておきます。分けておけば、どちらかが漏れたときに、もう一方を止めずに済みます。佐藤さんは、本番用に urenokori-prod という名前の鍵を作りました。

入れたあと、置き直す

環境変数を入れても、いま動いている本番には、すぐには効きません。Vercel の公式の説明には、こう書かれています。

DOCUMENTATION

“Environment variable changes apply only to new deployments. The running deployment keeps the values it was built with.”

環境変数の変更は、新しいデプロイにだけ効きます。動いているデプロイは、置かれたときの値を使い続けます。

VercelEnvironment variables(Vercel Docs)

同じ説明には、置き直す(Redeploy)ように、とあります。置き直したら、同じ URL を開き、試し用のノートで、表に数が入るかを確かめます。

Cloudflare Workers に置いた場合は、公式の説明によると、作品の「Settings」の「Variables and Secrets」で、種類を Secret にして入れます。

本番で使う鍵は、GitHub を通さず、置き場の環境変数に、自分で入れます。入れたあとは、置き直して確かめます。

注意

ただし、鍵の値は、会話にも画面写真にも残さない

鍵の値は、Claude との会話や、README(作品の説明書)や、画面の写真に載せません。Vercel の画面で入れるところを写真に撮って誰かに聞くときも、値が写っていないかを確かめます。

鍵が漏れたときは、第6部の第5回の順番で止めて作り直し、置き場の環境変数も、新しい鍵に入れ替えて、置き直します。

次回の問い

佐藤さんの次の疑問です。置いた先で、読み取りが動くようになりました。父にも触ってもらいます。URL を渡すときは、何に気をつければよいのでしょうか。

参考

Environment variables(Vercel Docs)
環境変数の入れ方、使う環境の選び方、変更が新しいデプロイにだけ効くこと。英語。2026年11月11日に確認。
vercel.com · vercel.com
Config and Secret environment variables(Vercel Docs)
Config と Secret の違い。API キーは Secret に。英語。2026年11月11日に確認。
vercel.com · vercel.com
Secrets(Cloudflare Workers Docs)
Cloudflare Workers での秘密の値の入れ方。英語。2026年11月11日に確認。
developers.cloudflare.com · developers.cloudflare.com
Vibe Coding 用語集:環境変数
環境変数の説明。
AMPL · Web

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