環境の分離

同じ製品が、確認用と本番用など複数の場所で並行して動いています。この分離を知っていると、「手元では動くのに公開すると壊れる」「URLを送ったのに相手が見られない」という定番の混乱がすっと解けます。

localhostは自分のマシンの中

開発中にClaudeが立ち上げるhttp://localhost:3000のようなURLは、自分のコンピュータの中だけで動く確認用サーバーです。このURLを他の人へ送っても開けません。人に見せるには、プレビューまたは本番へデプロイします。

開発・プレビュー・本番

開発は自分のマシンの中で動き、接続先も開発用になっていれば、壊しても誰にも影響しません。本番のデータベースや本物の外部サービスへ繋いだままでは、この前提は崩れます（後述の「環境ごとに設定と鍵を変える」）。プレビューは本番と同じ仕組みで動く確認場所で、CloudflareではGitと連携させればbranch（バージョン管理）ごとに自動で作られ、URLを共有してレビューできます。本番は利用者が触っている実体で、変更はプレビューで確認してから反映します。

本番に反映する前に、プレビューのURLで確認させて

環境ごとに設定と鍵を変える

同じコードでも、環境変数（トークン・APIキー）は環境ごとに別の値を設定します。開発中の操作で本物の決済やメール送信が動かないよう、開発ではテスト用の鍵やmock（品質の観点）を使い、本番の鍵は本番にだけ置きます。

「手元では動く」の理屈

手元と本番では、データの量、設定、依存の状態が違います。手元で動いた事実は、本番で動く保証になりません。本番と同じ仕組みで動くプレビューで確認する運用は、この差を埋めるためにあります。差のうち実行環境の部分を箱ごと揃える手段としてコンテナがありますが、データや外部サービスの差は残ります（構造の観点）。