Claude Code Safe Deploy Dry Run: 本番アクセスを頼む前に検証する

Claude Code にデプロイまで任せると速く見えますが、本番権限を渡す前の dry run がないと、失敗時に何を戻すのか分からなくなります。

このガイドでは、本番アクセスを求める前に build、diff、preview URL、rollback owner、触った範囲を確認する安全な dry run を作ります。

あわせて読む: claude-code-permissions-guide, claude-code-permission-audit-before-deploy, claude-code-cloudflare-workers. 公式ドキュメントの基準: Anthropic Claude Code docs.

なぜ最初に決めるのか

本番権限の前に、公開できる証拠と戻し方を揃えること

大事なのは、最初の依頼を大きくしすぎないことです。読む範囲、触らない範囲、最初の一手、確認方法を先に置くと、Claude Code は余計な作業を広げにくくなります。

Cloudflare Pages、Workers、静的サイトを Claude Code で更新し始めた人

実務で使う手順

1. ローカル build を先に通す
2. diff を読み、secrets や支払いが含まれないか見る
3. preview URL で h1、canonical、CTA を確認する
4. rollback owner と戻しコマンドを決める
5. 証拠が揃ってから本番アクセスを依頼する

場面	Claude Code に任せること	人間が確認する証拠
記事公開	dist build と公開URLチェックを先に行う	build, diff, URL
CTA変更	Gumroadリンクと相談導線を preview で確認する	build, diff, URL
Workers修正	環境変数に触らず dry run log を見る	build, diff, URL

この証拠が残ると、Claude Code の返答を雰囲気ではなく実際の作業結果で判断できます。

コピーして使えるプロンプトとコード

この変更を本番 deploy する前の dry run checklist に変換してください。build結果、diffリスク、preview URL、rollback owner、触っていない領域、再試行条件を表で返してください。本番 deploy はまだ実行しないでください。

const deployCheck = {
  build: "passed",
  diffReviewed: true,
  previewUrl: "https://example.pages.dev",
  rollbackOwner: "Masa",
  changedAreas: ["content", "cta-copy"]
};

function canRequestProductionAccess(check) {
  return check.build === "passed" &&
    check.diffReviewed &&
    /^https:\/\//.test(check.previewUrl) &&
    check.rollbackOwner.length > 0 &&
    !check.changedAreas.includes("secrets");
}

console.log({ ready: canRequestProductionAccess(deployCheck) });

実例と失敗例

場面	Claude Code に任せること	人間が確認する証拠
記事公開	dist build と公開URLチェックを先に行う	build, diff, URL
CTA変更	Gumroadリンクと相談導線を preview で確認する	build, diff, URL
Workers修正	環境変数に触らず dry run log を見る	build, diff, URL

• build 前に wrangler を叩くと、失敗原因がコードか環境か分からなくなります。
• rollback owner がないと、失敗後の判断が遅れます。
• preview URL を見ないと、HTTP 200 でも別記事やトップページ fallback を見逃します。

大事なのは、最初の依頼を大きくしすぎないことです。読む範囲、触らない範囲、最初の一手、確認方法を先に置くと、Claude Code は余計な作業を広げにくくなります。

証拠パックとして残すこと

本番権限の前に、公開できる証拠と戻し方を揃えること は、1回の作業だけで終わらせるよりも、次のセッションで再利用できる証拠パックにして残すと価値が出ます。具体的には、最初の依頼文、Claude Code が読んだ範囲、触らなかった範囲、実行した確認コマンド、公開URLやスクリーンショット、判断に迷った点を短く残します。これがあると、別の日に同じ問題を見直しても、なぜその判断をしたのかを追えます。

Cloudflare Pages、Workers、静的サイトを Claude Code で更新し始めた人 は、最初から完璧な運用規程を作る必要はありません。まずは1つの PR、1つのメモ、1つの deploy だけで試し、失敗した場所を checklist に戻します。Claude Code に任せる作業を増やすのは、build、diff、URL、CTA、rollback の証拠がそろってからで十分です。証拠が薄い段階で権限だけ広げると、速度は上がっても確認コストが後から膨らみます。

収益導線も同じです。読者がまだ基本操作で止まっているなら無料PDF、同じ prompt を何度も書いているなら Gumroad、チームや本番運用で判断が割れるなら導入相談へ進めます。この記事の役割は、読者を急いで買わせることではなく、今の詰まりに合う次の一手を見せることです。安全なデプロイ前チェックと権限設計 が該当する読者だけを教材へ送り、まだ早い読者には無料PDFや関連記事を返します。

追加で残したいのは、判断の分岐です。Claude Code が提案した案をそのまま採用したのか、範囲を狭めたのか、別の確認を先に挟んだのかを一行で書きます。PRレビューなら「P0はなし、P1はモバイル崩れ、P2はテスト不足」のように残します。Obsidian から issue を作るなら「メモ全文ではなくCTA改善だけを採用」と書きます。deploy dry run なら「preview URL は正しいが rollback owner 未設定なので本番はまだ」と書きます。

この一行があると、次に同じ読者や同じチームが来たときのCTAも選びやすくなります。基本操作で迷っている人には無料PDFを案内し、同じ作業を繰り返す人には Gumroad の実用教材を案内し、責任分界や本番権限で止まっている人には導入相談を案内します。安全なデプロイ前チェックと権限設計 は、その分岐の中で「今すぐ型を持って帰れば自走できる」読者に向けたルートです。

最後に、確認ログは記事本文と同じくらい大事です。公開前にどのURLを開いたか、h1 と canonical が合っていたか、heroImage が見えていたか、CTA が無料PDF、Gumroad、導入相談へ正しく分かれていたかを残します。ここまで記録すると、次回の改善は「なんとなくCTAを強くする」ではなく、どの段階で読者が止まったかを見る作業になります。安全なデプロイ前チェックと権限設計 を案内する判断も、証拠があるほど自然になります。小さな記録が次の改善を速くします。

無料PDF、Gumroad、導入相談につなげる

まだ基本コマンドが曖昧なら 無料チートシート で日々の型を固めてください。安全なデプロイ前チェックと権限設計 をすぐ深めたい場合は Gumroad 教材 が次の一手です。チーム導入、レビュー設計、収益導線まで一緒に整理したい場合は 導入相談 に進み、教材比較は products で確認できます。

CTA は記事末尾だけに置くものではありません。導入では無料PDF、実例の後では Gumroad 教材、チーム導入や本番リスクの話では導入相談を自然に出すと、読者の迷いが減ります。

公開後に見る数字

公開後は permissions 系記事から Setup Guide、/en/training、無料PDFへの導線を見ます。

PV だけで判断せず、本文冒頭の読了、内部リンク、無料PDF登録、Gumroadクリック、導入相談ページへの移動を分けて見ます。HTTP 200、h1、canonical、heroImage、CTA が同じ slug を指していることも確認します。