Claude CodeでWebアプリを作ってWranglerでCloudflareに公開する
前回のハンズオンでは、Cloudflareに静的ファイルをドラッグ&ドロップしてWebサイトをデプロイ(本番環境への公開・反映)した。今回はその発展として、同じサイトをClaude Code経由のコマンド操作で更新できるようにする。ブラウザで作ったサイトはWranglerからもそのまま操作できる。これにより、Claude Codeにデプロイ依頼ができ、開発作業がはかどる。
前回のハンズオンで Pages と Workers のどちらを選んだかで、デプロイの頼み方が変わる。違うところはタブで切り替えて読む。どちらか分からなければ、公開URLの末尾を見る。pages.dev なら Pages、workers.dev なら Workers。
本記事の位置付け
Section titled “本記事の位置付け”Cloudflare に手元のサイトを公開したいだけなら、こんなざっくりとした依頼でも進められる:
このフォルダの中身を手軽に Cloudflare で公開したいClaude Code はアカウントの有無や環境などを聞きながら、最終的にデプロイまで案内してくれる。そのとき裏で使われるのは、ほぼ必ず Wrangler という Cloudflare 公式のツール。頼み方を変えても、結局は裏で Wrangler を使うことになる。
Claude Code が Wrangler を呼び出し、Wrangler がサイトを Cloudflare に届ける
そんなわけで、Wrangler が何をしているのかを知っておくと、Webサイトが公開される仕組みもあわせて理解できる。本記事では、Wrangler を準備してデプロイするまでを、つまずきにくい順序で一つずつ追っていく。
1. Node.js のセットアップ
Section titled “1. Node.js のセットアップ”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 などを入れてから戻ってくる。
1-1. Node.js のインストール
Section titled “1-1. 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 インストーラー
インストールしたら Claudeデスクトップアプリを開き直す:Node.js を入れる前から開いていた Claudeデスクトップアプリは、
node/npxの場所(PATH)を古いまま覚えている。そのままだと、このあとの手順でnpxが見つからず失敗する。アプリを終了して起動し直し、同じ作業フォルダでもう一度「Node.js と npx が使えるか確認して」と頼む。
LTS(Long Term Support):「安定版」のこと。公式サイトに「LTS」と「最新/Current」の2種類があるが、LTS を選ぶのが定番。
npx:Node.js に付属するコマンドで、ツールを一時的に取得して実行できる仕組み。npx があれば Wrangler はインストールせずとも使える。
1-2. Wrangler でログイン
Section titled “1-2. Wrangler でログイン”Wrangler で Cloudflare にログインする(一回だけ)。ログインは Claude Code に頼まず、自分のターミナルで打つ。
ターミナルは、Cmd + スペース で「ターミナル」と検索して開く。開いた場所(フォルダ)はどこでもよい。
npx wrangler login初めてのときは、Wrangler を取ってきてよいか聞かれることがある。y を打って Enter を押す。
ブラウザで Cloudflare の画面が開き、Wrangler にアカウントへのアクセスを許可するか聞かれる。Workers・Pages・DNS などの書き込みも含む権限なので、内容を確かめてから Authorize を押す。
Authorize を押す(右上のアカウント欄は伏せている)
「Authorization granted to Wrangler」と出たら、ブラウザのページは閉じてよい。ターミナルにも「Successfully logged in.」と出る。
ログインが終わった画面
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に何か変更を依頼しておくと、デプロイ後に変化が確認しやすい。ここでは現在時刻を足す。
現在時刻も表示して!
右のブラウザのパネルで、Hello World の下に現在時刻が出る
2-2. Cloudflareにデプロイ
Section titled “2-2. Cloudflareにデプロイ”デプロイには、前回のハンズオンで付けた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つ増えている。
Wranglerで pages.dev のサイトを更新する。ブラウザでアップしたプロジェクトも、Wranglerからそのまま操作できる。
デプロイには、前回のハンズオンで作ったプロジェクト名が必要になる。前回はブラウザに手動でアップしたため、このフォルダの中身がどの名前のpages.devプロジェクトとして公開されているのかをWranglerは知らない。
プロジェクト名を覚えてない場合は、Cloudflareダッシュボードの Workers & Pages でプロジェクト一覧から確認する(例:aoitanaka)。
下記のように Claude Code に頼んでデプロイする。既存プロジェクト名 は前回のプロジェクト名(例:aoitanaka)に置き換える。
public フォルダの中身を、Cloudflare Pages のプロジェクト「既存プロジェクト名」に、本番(main ブランチ)として npx wrangler でデプロイしてコマンドで明示するなら
npx wrangler pages deploy ./public --branch=main --project-name=既存プロジェクト名。同じデプロイになる。頼み方(自然文)とコマンド、どちらで渡してもよい。
実行すると public/ のファイルがアップロードされ、本番環境に反映される。実行結果に公開URL(https://既存プロジェクト名.pages.dev)が表示されるので、ブラウザで開いて内容が更新されていることを確認する。
3. 修正して再デプロイ
Section titled “3. 修正して再デプロイ”ファイルを修正する。Claude Codeに依頼:
流れ星も出して修正を確認したら、再デプロイする。先ほど一度デプロイ済みなので、同じ Claude Code セッションなら「デプロイして」だけで通じる(Claude が先ほどのデプロイのやり方を覚えている)。
デプロイしてURLをブラウザで開き、変更が反映されていることを確認する。
流れ星が出るようになった
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)にまとめて。途中でファイル操作の許可を求められることがあるので、その都度許可する。
連打ゲームを作った。右のブラウザのパネルで遊べる
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 のままで、振り替えは起きない。
| 観点 | Pages | Workers |
|---|---|---|
| URL | プロジェクト名.pages.dev と短い | Worker名.アカウントのサブドメイン.workers.dev と長い |
| 名前の衝突 | Cloudflare 全体で早い者勝ち。取られているとランダムな文字が付く | 起きない |
| 設定ファイル | 要らない(コマンドのフラグで指定) | wrangler.jsonc が要る |
| ブラウザからのアップロード更新 | できる | できる(Workerのページ右上の New deployment) |
| 過去のデプロイに戻す | ダッシュボードから | ダッシュボードのほか npx wrangler rollback でも戻せる |
| 独自ドメイン | 外部のDNSのままでも設定できる | Cloudflare でネームサーバーを管理しているドメインだけ |
| 静的ファイルの配信 | 無料・無制限 | 無料・無制限 |
5. 次のステップ
Section titled “5. 次のステップ”このハンズオンでは、Wranglerを使ってコマンドラインからCloudflareにデプロイする方法を学んだ。次のステップの候補:
- Claude CodeでWebサイトにBasic認証をかけて合言葉を知っている人だけに見せる:合言葉を知っている人だけに見せる。ロードマップの次のステップ
- Git と GitHub の基本:バージョン管理を身につける。AI に大胆な書き換えを頼む前に commit しておけばいつでも戻せるし、GitHub をハブに公開ともつながる
- Claude Codeでデータ共有型Webアプリを作ってCloudflareに公開する:データベース(D1)を使って複数人でデータを共有できるWebアプリを作る。wrangler で直接公開する方法も案内している
- Claude CodeでWebアプリを作ってGit連携でCloudflareに公開する(応用):Cloudflare Pages の Git連携機能で、ダッシュボードからリポジトリを選ぶだけで自動デプロイを設定する
- 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行足される