コンテンツにスキップ

Claude CodeでWebアプリを作ってWranglerでCloudflareに公開する

前回のハンズオンでは、Cloudflareに静的ファイルをドラッグ&ドロップしてWebサイトをデプロイ(本番環境への公開・反映)した。今回はその発展として、同じサイトをClaude Code経由のコマンド操作で更新できるようにする。ブラウザで作ったサイトはWranglerからもそのまま操作できる。これにより、Claude Codeにデプロイ依頼ができ、開発作業がはかどる。

前回のハンズオンで Pages と Workers のどちらを選んだかで、デプロイの頼み方が変わる。違うところはタブで切り替えて読む。どちらか分からなければ、公開URLの末尾を見る。pages.dev なら Pages、workers.dev なら Workers。

Cloudflare に手元のサイトを公開したいだけなら、こんなざっくりとした依頼でも進められる:

プロンプト
このフォルダの中身を手軽に Cloudflare で公開したい

Claude Code はアカウントの有無や環境などを聞きながら、最終的にデプロイまで案内してくれる。そのとき裏で使われるのは、ほぼ必ず Wrangler という Cloudflare 公式のツール。頼み方を変えても、結局は裏で Wrangler を使うことになる。

ノートパソコンに向かうねこ(Claude Code)の上に Claude デスクトップアプリの画面。帽子をかぶったアライグマ(Wrangler)の上に、$ wrangler deploy と表示された黒いターミナル。アライグマはサイトの画面を詰めた箱を抱え、右のオレンジの雲(Cloudflare)へ運んでいる

Claude Code が Wrangler を呼び出し、Wrangler がサイトを Cloudflare に届ける

そんなわけで、Wrangler が何をしているのかを知っておくと、Webサイトが公開される仕組みもあわせて理解できる。本記事では、Wrangler を準備してデプロイするまでを、つまずきにくい順序で一つずつ追っていく。

Wranglerラングラーは Cloudflare が公式に提供する CLI ツール(コマンドラインツール)で、 Cloudflare へのデプロイに使う。 Wrangler は Node.jsノードジェイエス 上で動く。用意するのは Node.js だけでよい。Wrangler そのものは入れなくても、Node.js に付いてくる npx から呼び出せば動く。 このハンズオンでは、Node.js を入れて、Wrangler で Cloudflare にログインしておけば準備完了。ログインだけは、Claude Code に頼まず自分のターミナルで打つ。

準備も、Claudeデスクトップアプリの Claude Code に頼んで進める。ターミナルのアプリを開いてコマンドを打つ必要はない。

まず、作業フォルダで Claude Code を起動する。前回のハンズオンで作ったフォルダ(~/claude/sup など)をそのまま使う。新しくサイトを作る場合は、新しい作業フォルダを作ってそこを使う(→ 4章)。

Codex や Antigravity のデスクトップアプリで進める場合は、アプリの操作を ALT で読み替える。プロンプトはこの記事のものをそのまま使える。

Claudeデスクトップアプリを起動 → 左上の </> のアイコン(Code)→ 新規 → 作業フォルダを指定(→ SUP 1-1)。

セッションを始める前に、権限の設定を 編集を受け入れる にしておく(自動 にしない)。入力欄の下の、いまの設定が出ているボタンを押すと「権限・このセッション」のメニューが開く(→ SUP 1-1)。自動だと Claude がファイルの変更やコマンドを確認なしで一気に進めてしまい、意図しない結果になる事故が起きやすい。まずは一つずつ承認しながら進めるのが安全。

本サイトは Mac 前提で書いている。Windows で進める場合は、先に Windowsでのセットアップ(WIN)で Node.js などを入れてから戻ってくる。

Node.js が入っているかを確かめてもらう。

プロンプト
Node.js と npx が使えるか確認して

Claude Code が node -v と npx -v を実行して教えてくれる。node が v22以上 で、npx もバージョン番号を返せばOK。確認は2つとも見る。 この先の Wrangler は毎回 npx で呼ぶので、node が動いていても npx が動かなければ先へ進めない。実際に、node -v は通るのに npx だけが動かない、という状態を見ている(npx は本体を指し示すだけのファイルなので、指し先が失われると単独で動かなくなる)。

入っていない、または古い場合はNode.js 公式サイトを開き、LTS版 の macOS 用インストーラー(.pkg ファイル)をダウンロードしてインストールする。インストール後に npm と npx が使えるようになる。

Node.js インストーラー

Node.js インストーラー

インストールしたら Claudeデスクトップアプリを開き直す:Node.js を入れる前から開いていた Claudeデスクトップアプリは、node / npx の場所(PATH)を古いまま覚えている。そのままだと、このあとの手順で npx が見つからず失敗する。アプリを終了して起動し直し、同じ作業フォルダでもう一度「Node.js と npx が使えるか確認して」と頼む。

LTS(Long Term Support):「安定版」のこと。公式サイトに「LTS」と「最新/Current」の2種類があるが、LTS を選ぶのが定番。

npx:Node.js に付属するコマンドで、ツールを一時的に取得して実行できる仕組み。npx があれば Wrangler はインストールせずとも使える。

Wrangler で Cloudflare にログインする(一回だけ)。ログインは Claude Code に頼まず、自分のターミナルで打つ。

ターミナルは、Cmd + スペース で「ターミナル」と検索して開く。開いた場所(フォルダ)はどこでもよい。

Terminal window
npx wrangler login

初めてのときは、Wrangler を取ってきてよいか聞かれることがある。y を打って Enter を押す。

ブラウザで Cloudflare の画面が開き、Wrangler にアカウントへのアクセスを許可するか聞かれる。Workers・Pages・DNS などの書き込みも含む権限なので、内容を確かめてから Authorize を押す。

Wrangler wants to access your account の画面。左に許可する権限の一覧、右に Authorize と Cancel のボタン

Authorize を押す(右上のアカウント欄は伏せている)

「Authorization granted to Wrangler」と出たら、ブラウザのページは閉じてよい。ターミナルにも「Successfully logged in.」と出る。

Authorization granted to Wrangler と表示された画面

ログインが終わった画面

Claude Code に戻って、ログインできたか確かめてもらう。

プロンプト
Cloudflare にログインした。npx wrangler でログインできたか確認して

Claude Code が npx wrangler whoami を実行し、アカウント名やメールアドレスを教えてくれればOK。

ログインでエラーが出るとき:エラーに npm 系のメッセージが混じる場合、以前 npm install -g wrangler などで入れた古いグローバル版の Wrangler を npx が拾っているのが原因のことが多い(npx はローカル → PATH上のグローバル → ダウンロードの順で探すため、古いグローバル版があるとそれを実行してしまう)。自分で入れた覚えがなくても、「Cloudflareに公開して」のようなざっくりした依頼のときに Claude Code が環境準備として入れていることがある(とくに自動モードだと承認なしで実行されるため気づきにくい)。「古いグローバル版の wrangler が入っていないか調べて、あれば消して」と頼めば、Claude Code が npm uninstall -g wrangler などで片付けてくれる。

2. 前回作ったWebサイトを更新する

Section titled “2. 前回作ったWebサイトを更新する”

前回のハンズオンで作ったサイトに手を入れて、同じサイトを Wrangler で更新していく流れ。前回のハンズオンを通っていない場合や、新しくサイトを作りたい場合は4章へ。

2-1. Claude CodeでWebサイト・Webアプリを作る

Section titled “2-1. Claude CodeでWebサイト・Webアプリを作る”

作業フォルダ(前回のハンズオンで作ったフォルダ)の public/ には、前回作ったサイトのファイルが入っている状態。念の為、Claude Codeに下記を伝える:

プロンプト
public/ の中身は前回のハンズオンで作ったサイトです。これに手を入れていきます。

その後、Claude Codeに何か変更を依頼しておくと、デプロイ後に変化が確認しやすい。ここでは現在時刻を足す。

プロンプト
現在時刻も表示して!
Claudeデスクトップアプリの画面。「現在時刻も表示して!」に Claude Code が public/index.html に現在時刻を追加したと報告し、右のブラウザのパネルに Hello World と、その下に日付と時刻が表示されている

右のブラウザのパネルで、Hello World の下に現在時刻が出る

デプロイには、前回のハンズオンで付けたWorkerの名前が必要になる。前回はブラウザに手動でアップしたため、このフォルダの中身がどの名前のWorkerとして公開されているのかをWranglerは知らない。

Workerの名前は、公開URL https://Worker名.サブドメイン.workers.dev の先頭の部分(例:thisisapen)。覚えていない場合は、Cloudflareダッシュボードの Workers & Pages の一覧で確認する。

Workersでは、どのWorkerにどのフォルダを公開するかを、設定ファイル(wrangler.jsonc)に書いておく。その用意からデプロイまでまとめて頼む。既存Worker名 は前回の名前に置き換える。

プロンプト
Cloudflare の既存の Worker「既存Worker名」に、public フォルダの中身を npx wrangler でデプロイして。
設定ファイル(wrangler.jsonc)も作ってほしい。

wrangler.jsonc が作られてからデプロイされる。名前を既存のWorkerと同じにしてあるので、新しいWorkerは作られず、前回のWorkerが更新される。

実行結果に公開URL(https://既存Worker名.サブドメイン.workers.dev)が表示されるので、ブラウザで開いて内容が更新されていることを確認する。ダッシュボードの Deployments を見ると、ブラウザからのアップロードと同じように新しいバージョンが1つ増えている。

ファイルを修正する。Claude Codeに依頼:

プロンプト
流れ星も出して

修正を確認したら、再デプロイする。先ほど一度デプロイ済みなので、同じ Claude Code セッションなら「デプロイして」だけで通じる(Claude が先ほどのデプロイのやり方を覚えている)。

プロンプト
デプロイして

URLをブラウザで開き、変更が反映されていることを確認する。

紫のグラデーションの背景に光る Hello World と現在時刻。左上から斜めに流れ星が2本流れている

流れ星が出るようになった

4. Claude Code だけで作って公開する

Section titled “4. Claude Code だけで作って公開する”

ここまでは、ブラウザで作ったプロジェクトを Wrangler で更新してきた。じつは Wrangler は、プロジェクトを新しく作るところからできる。ブラウザでの操作は要らず、Claude Code に頼むだけで、作成から公開まで済む。

この章では、HTMLファイル1つで動く小さなWebアプリを1回の依頼で作り、新しい Worker として公開する。前回のハンズオンを通っていない場合も、1章の準備(Node.js とログイン)が済んでいれば、この章から進められる。

4-1. 作業フォルダを作って Claude Code を起動する

Section titled “4-1. 作業フォルダを作って Claude Code を起動する”

お題ごとに作業フォルダを分ける。新しく作った作業フォルダ ~/claude/renda を Claudeデスクトップアプリで開く(→ SUP 1-1)。フォルダ名はお題に合わせて変えてよい。Cloudflare へのログインはやり直さなくてよい。

4-2. 1回の依頼でWebアプリを作る

Section titled “4-2. 1回の依頼でWebアプリを作る”

次のどれかを頼む。お題を変えるときは、フォルダを分けて新しいセッションで頼む。

プロンプト
HTML+JavaScriptでポモドーロタイマーを作って!
public/index.html 1ファイルで作って。
プロンプト
複利計算機をHTML+JavaScriptで作って!
構成はHTMLファイル(public/index.html)が1つ。
プロンプト
マウスかタッチパッドでボタンを10回連打するのに何秒かかるかを競うゲーム。
public/index.html 1ファイルで作って。
プロンプト
ボタンを押すと効果音が出るWebアプリをHTMLファイル1つ(public/index.html)で作って。
3つのボタンで三つの効果音。
プロンプト
TODOリストをHTML+JavaScriptで作って!
項目の追加・削除ができて、ページを閉じても消えないようにしたい。
public/index.htmlに書いて。ファイルは1つで。
プロンプト
最大60秒のカウントダウンタイマーをHTML+JavaScriptで作って!
秒数を入力してスタート・リセットできるようにしたい。
HTMLファイル1つ(public/index.html)にまとめて。

途中でファイル操作の許可を求められることがあるので、その都度許可する。

Claudeデスクトップアプリで連打ゲームを作成した画面。右のブラウザのパネルに10連打タイムアタックが表示されている

連打ゲームを作った。右のブラウザのパネルで遊べる

4-3. 新しい Worker にデプロイする

Section titled “4-3. 新しい Worker にデプロイする”

まず Worker の名前を決める。Workers は <Worker名>.<アカウントのサブドメイン>.workers.dev という形式で、アカウントごとのサブドメインの下に置かれる。pages.dev と違って他人と名前がぶつからないので、空き確認は要らない。

前回作った Worker とは違う名前にする。 同じ名前を指定すると、新しい Worker は作られず、前回のサイトがこのアプリで上書きされる(2章で既存の Worker を更新したのと同じ仕組み)。

設定ファイルの用意からデプロイまでまとめて頼む。Worker名 は決めた名前(例:applepen)に置き換える。

プロンプト
Cloudflare に新しい Worker「Worker名」を作って、
public フォルダの中身を npx wrangler でデプロイして。
設定ファイル(wrangler.jsonc)も作ってほしい。

実行結果に表示される https://Worker名.<アカウントのサブドメイン>.workers.dev をブラウザで開いて確認する。このURLは固定で、常に最新のデプロイを指す。

修正して再デプロイするときは「デプロイして」だけでよい。設定は wrangler.jsonc に残っているので、Worker名も公開ディレクトリも言い直さなくて済む。

ここで作ったのは、1回の依頼で完成して、その場で使い終わるアプリ。使いながら機能を足していく、データを残す、といった「育てる」作り方は 一人完結型Webアプリの実践 で扱っている。

4-4. Pages ではなく Workers で作る理由

Section titled “4-4. Pages ではなく Workers で作る理由”

Wrangler で新しく作るときは、Pages ではなく Workers で作る。理由は2つ。

  • Cloudflare 公式が、新しく作るなら Workers を勧めている。Pages の公式ドキュメントの冒頭に「Start new projects with Workers.」と書かれている(Pages が廃止されるわけではなく、継続サポートは明言されている)
  • Wrangler 自身が、新しいプロジェクトを Pages に作ろうとすると Workers 側に振り替えるようになった(2026年9月時点)。逆らって Pages を作ることもできるが、素直に Workers で作るほうが手順が短い

前回 Pages で作ったプロジェクトを2章のように更新する場合は、これまでどおり Pages のままで、振り替えは起きない。

観点PagesWorkers
URLプロジェクト名.pages.dev と短いWorker名.アカウントのサブドメイン.workers.dev と長い
名前の衝突Cloudflare 全体で早い者勝ち。取られているとランダムな文字が付く起きない
設定ファイル要らない(コマンドのフラグで指定)wrangler.jsonc が要る
ブラウザからのアップロード更新できるできる(Workerのページ右上の New deployment)
過去のデプロイに戻すダッシュボードからダッシュボードのほか npx wrangler rollback でも戻せる
独自ドメイン外部のDNSのままでも設定できるCloudflare でネームサーバーを管理しているドメインだけ
静的ファイルの配信無料・無制限無料・無制限

このハンズオンでは、Wranglerを使ってコマンドラインからCloudflareにデプロイする方法を学んだ。次のステップの候補:

  • Cloudflareの認証がうまくいかない場合は、スマホのテザリングに切り替えてみる、VPN を使っている場合は切る、ブラウザのシークレットモードで開き直す、Safari を試す、などを試す
  • WranglerでのCloudflareログイン情報はローカルに保存されるため、npx wrangler login の再実行は不要
  • --branch=main について: 現状、ブラウザのドラッグ&ドロップで作ったプロジェクトの本番ブランチは main がデフォルト(Cloudflare側の仕様で将来変わる可能性あり)。違う値(例: --branch=production)を指定すると、その名前のプレビューブランチとして扱われ、production.既存プロジェクト名.pages.dev のような別URLにデプロイされてしまう(既存プロジェクト名.pages.dev には反映されない)ので注意
  • Claude Code から Wrangler コマンドを実行すると、同じセッション内では「デプロイして」と依頼するだけで実行されるようになる。Pages でセッションをまたいでも同じようにしたい場合は、デプロイコマンド(例: npx wrangler pages deploy ./public --branch=main --project-name=プロジェクト名)を作業フォルダの AGENTS.md に書き、CLAUDE.md からはそれを読み込むようにしておくとよい。Claude Code も Codex も同じコマンドを読む(→ CLM 3)。Workers は wrangler.jsonc に設定が残るので、この手間は要らない
  • ブラウザからのアップロードから Workers の Wrangler でのデプロイに切り替えると、404.html が表示されなくなる(存在しないページが中身のない404エラーになる)。ブラウザからのアップロードは 404.html があると自動で404ページを使う設定になるが、Wrangler は wrangler.jsonc に書かない限りその設定にならないため。Claude Code に「404.html があれば、存在しないページで表示されるようにして」と頼めば、wrangler.jsonc に設定が1行足される