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

前の回で、売れ残り帳を Vercel に置きました。この回では、置いた先で読み取りが動くように、鍵を渡します。コードを作り直す前に、場所ごとの設定を見ます。
置いた先には、鍵がない
第6部の第4回で、API キー(作品から Claude を使うための鍵)は、.env(手元で環境変数を書いておくファイル)にしまいました。そして .gitignore(記録に入れないものの一覧)に書いて、GitHub に送らないようにしました。
Vercel は、GitHub から作品を受け取ります。だから、鍵は届いていません。読み取りが動かないのは、鍵が GitHub に出ていない、という証拠でもあります。
鍵は、
佐藤さんの
本番の環境変数
置いた先で使う設定の値を、この講座では、本番の環境変数と呼びます。環境変数は、第6部の第4回で見た、作品の外から渡す値でした。Vercel の公式の説明には、こう書かれています。
“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.”
環境変数は、ソースコードの外で設定する、名前と値の組です。環境ごとに、値を変えられます。値は、しまってあるあいだ、暗号化されています。
ソースコードは、第4部の第5回で見た、作品の元になる文のことです。暗号化は、ほかの人が読めない形に変えて、しまっておくことです。
名前と値は、別のものです。たとえば ANTHROPIC_API_KEY は、設定の名前です。本物の鍵の文字の並びが、値です。名前は、手元の .env と同じにします。
名前は Claude に聞き、値は自分で入れる
まず、Claude Code(会話で頼むと、作品を作ったり直したりしてくれる道具)に、要る名前を聞きます。
この作品を Vercel の本番で動かすのに要る環境変数の、名前と用途を一覧にしてください。値は表示しないでください。値をブラウザに届けてしまう名前の付け方になっていないかも、確かめて教えてください。この依頼文は、説明のための架空の例です。
値は、自分で入れます。Vercel の公式の説明によると、プロジェクトの「Settings」(設定)を開き、画面の左側に並んだ項目の中の「Environment Variables」で、名前と値を入れます。入れるときに、次の2つを選びます。
- 種類:Config(あとで読める)と Secret(保存したら読めない)がある。API キーは Secret にする
- 使う環境:Production(本番)、Preview(試しの版)、Development(手元)。本番で使うなら Production を選ぶ

入れる鍵は、本番用に新しく作ったものにします。第6部の第2回で見たとおり、作っている途中用と、本番用で、鍵を分けておきます。分けておけば、どちらかが漏れたときに、もう一方を止めずに済みます。佐藤さんは、本番用に urenokori-prod という名前の鍵を作りました。
入れたあと、置き直す
環境変数を入れても、いま動いている本番には、すぐには効きません。Vercel の公式の説明には、こう書かれています。
“Environment variable changes apply only to new deployments. The running deployment keeps the values it was built with.”
環境変数の変更は、新しいデプロイにだけ効きます。動いているデプロイは、置かれたときの値を使い続けます。
同じ説明には、置き直す(Redeploy)ように、とあります。置き直したら、同じ URL を開き、試し用のノートで、表に数が入るかを確かめます。
Cloudflare Workers に置いた場合は、公式の説明によると、作品の「Settings」の「Variables and Secrets」で、種類を Secret にして入れます。
本番で使う鍵は、GitHub を通さず、置き場の環境変数に、自分で入れます。入れたあとは、置き直して確かめます。
注意
ただし、鍵の値は、会話にも画面写真にも残さない
鍵の値は、Claude との会話や、README(作品の説明書)や、画面の写真に載せません。Vercel の画面で入れるところを写真に撮って誰かに聞くときも、値が写っていないかを確かめます。
鍵が漏れたときは、第6部の第5回の順番で止めて作り直し、置き場の環境変数も、新しい鍵に入れ替えて、置き直します。
次回の問い
佐藤さんの次の疑問です。置いた先で、読み取りが動くようになりました。父にも触ってもらいます。URL を渡すときは、何に気をつければよいのでしょうか。