コンテンツにスキップ

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

Wranglerのハンズオンでは、Claude Codeから Wrangler コマンドで Cloudflare にデプロイする方法を扱った。この記事ではその発展として、Cloudflare の Git連携で GitHub リポジトリとつなぎ、GitHubに変更を反映するだけで自動デプロイされる仕組みを作る。最初に Cloudflareダッシュボードでリポジトリをつなげば、以降は変更履歴を残しつつ GitHub 経由で公開できる。

Git連携は Workers と Pages のどちらにもある(Workers 側の名前は Workers Builds)。公開先はどちらでもよい。手順が違うところはタブで切り替えて読む(ほかの記事で一度選んだほうが、最初から開く)。どちらを選ぶかは Workers と Pages どちらを使うか を参照。

Git連携のほかにも、Cloudflare に公開する方法はある(ドラッグ&ドロップ、Wrangler、GitHub Actions)。違いと使い分けは Cloudflareにデプロイする4つの方法 にまとめてある。

今回のハンズオンでは、一人完結型Webアプリ(参考)を作って、Git連携で公開する。

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

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

Claude Code はアカウントの有無や環境などを聞きながら、最終的にデプロイまで案内してくれる。ただし、その過程で取る道は人によって違う。

本記事では、その中で Cloudflare の Git連携で自動デプロイにする 道筋を、つまずきにくい順序で追っていく。

このハンズオンでは GitHub のリポジトリ名と、Cloudflare 側の名前(Workers の名前、または Pages のプロジェクト名)を付ける。リポジトリ名と Workers の名前は自分のアカウントの中で、Pages のプロジェクト名は Cloudflare 全体で重複できないので、2回目以降に前回と同じ名前を使うと衝突する。最初に自分だけの ベース名(例: git-app-yto)を決め、この記事に出てくる my-git-app を自分のベース名に読み替えて進める。

本記事は Claude Code を例に進めるが、Codex など他のコーディングエージェントでも同じプロンプトで進められる。以降、プロンプトを渡す相手をまとめて エージェント と呼ぶ。

新しく作った作業フォルダ ~/claude/my-git-app を Claudeデスクトップアプリで開く。フォルダの名前はベース名にそろえる。

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

公開ファイル(HTMLなど)は public/ フォルダに置く構成にする。設定ファイルや作業用ファイルが公開されないようにするため。

プロンプト
public フォルダを作って。公開ファイルは public 配下だけに置く構成にする。

次に、public/index.html を作る。

プロンプト
HTML+JavaScriptでポモドーロタイマーを作って!
public/index.html 1ファイルで作って。

右上のところからプレビューを選ぶと表示される(自動で表示されることも)。

Claudeデスクトップアプリ

Claude Codeでポモドーロタイマーを作成

なお、途中、操作の許可を求めてくることがあるので対応する。

作ったアプリを GitHub に置く。次章で Cloudflare 側がリポジトリの中身を読み取ってデプロイするため、先に GitHub にコードが push されている必要がある。

事前に Git と GitHub の基本 を終えて、次の状態になっていること:

  • GitHub アカウント作成済み
  • gh CLI インストール・認証済み(gh auth login 済み)

GitHub の MCP プラグインはオフにしておく: Claudeデスクトップアプリの 設定 → カスタマイズ → プラグイン にある Github(GitHub 公式 MCP サーバ)をインストールしていると、Claude Code が gh・ローカルの git ではなく GitHub API 経由で操作してしまい、手順どおりに進まないことがある。本ハンズオンは gh に統一するので、入れている場合は無効化しておく(詳しくは GBA 4章 を参照)。

一番簡単なのはエージェントに頼む方法。次のように頼めば、リポジトリの初期化からコミット・作成・push までまとめてやってくれる:

プロンプト
GitHubに非公開のリポジトリ <ベース名> を作って、今のフォルダの内容をpushして

ターミナルで手順を踏みたい場合は、Claudeデスクトップアプリの右上の >_ のアイコン(ターミナル)を押して、次を実行する(→ GBA 4-5):

Terminal window
git init
git add -A
git commit -m "初回コミット"
gh repo create my-git-app --private --source=. --remote=origin --push

gh repo create --source=. --push は「ローカルのコミットを GitHub に上げる」コマンド。先に git init でフォルダをリポジトリ化し、コミットを1つ作ってから実行する必要がある(コミットが無いと push しても中身が上がらない)。my-git-app は自分のベース名に読み替える。

3. Git連携で Cloudflare に公開する

Section titled “3. Git連携で Cloudflare に公開する”

Cloudflare に GitHub リポジトリを連携すると、リポジトリに変更が push されるたびに自動でデプロイが実行される。この章ではその連携を設定する。

Cloudflareアカウントがなければ作る。 こちらの手順(1-2)を参照のこと。

3-2. リポジトリを連携して公開する

Section titled “3-2. リポジトリを連携して公開する”

まず、設定ファイルを作って push する。 Workers の Git連携には、公開するフォルダを画面で指定する欄が無い。代わりに、設定ファイル(wrangler.jsonc)に書いておく(Wrangler のハンズオンと同じ)。<ベース名> は自分のベース名に置き換える。

プロンプト
Workers の Git連携で公開するための wrangler.jsonc を作って push して。
名前は <ベース名>、公開するのは public フォルダだけ。

できあがる wrangler.jsonc はこんな形になる。

{
"name": "my-git-app",
"compatibility_date": "2026-10-12",
"assets": { "directory": "./public" }
}
wrangler.jsonc を作ってコミットしたという Claude Code の応答。公開される範囲を説明し、push してよいか確認している

公開前の確認の例

push の前に「公開される範囲」を説明して、push してよいか聞いてくることがある。public/ の中身だけが公開され、wrangler.jsonc や README.md は公開されないことを確かめて「push して」と答える。

次に、Cloudflare 側でリポジトリを連携する。 Cloudflare ダッシュボード を開き、左メニューの Compute → Workers & Pages をクリック、右上の Create application をクリック。

Make something new の画面で Continue with GitHub をクリック。初回は GitHub との連携の承認を求められる(→ 3-3)。

Make something new の画面。Continue with Artifacts、Continue with GitHub、Connect with GitLab、Start with Hello World!、Select a template、Upload your static files が並ぶ

Continue with GitHub

Select a repository に自分の GitHub のリポジトリが並ぶので、自分のリポジトリ(<ベース名>)を選んで Next をクリック。

Select a repository の画面。リポジトリ一覧で1つにチェックが付き、右下に Next ボタンがある

リポジトリを選んで Next

Set up your application のページが開く。

  • Project name にはリポジトリ名が最初から入っている。wrangler.jsonc の name と同じでなければならない(違うとビルドが失敗する)。ベース名で揃えていればそのままでよい。同じ名前の Worker がすでにあると、欄を書き換えたときに「A project with that name already exists.」と赤字で出る(開いた直後は出ない)。そのときは別のベース名でやり直す
  • Build command は空欄、Deploy command は npx wrangler deploy のまま
  • Enable Preview builds はオンのままでよい(→ 4-2)
Set up your application の画面。Project name、空の Build command、npx wrangler deploy が入った Deploy command、Preview command、Enable Preview builds と Protect with Cloudflare Access のトグルが並ぶ

Project name を確かめて、ほかは既定のまま

Deploy をクリック。ビルドのページに移り、Cloudflare が GitHub からコードを取得してデプロイする。試したときは20秒ほどで緑のチェックが付いた。

ビルドのページ。Build の横に緑のチェック、Build settings に Deploy command の npx wrangler deploy が表示されている

緑のチェックが付けば完了

公開URLは https://<ベース名>.<サブドメイン>.workers.dev(ビルドのログの最後、またはプロジェクトの Overview の Domains and routes に出る)。ブラウザで開いて確認する。

作った直後は Overview の上部に「No URLs enabled」と出ることがあるが、workers.dev の URL で公開されている。URL を開いて確かめればよい(試したときは、2日後に見たら URL が出ていた)。

wrangler.jsonc を push する前に連携してしまった場合:public フォルダがあれば、Cloudflare が自動で判定して public/ の中身だけを公開する(ビルドのログに Framework: Static、Output Directory: public と出る)。ただし、この設定はリポジトリには残らないので、あとから wrangler.jsonc を作って push しておく。

3-3. 初回だけ:GitHub との連携を承認する

Section titled “3-3. 初回だけ:GitHub との連携を承認する”

Cloudflare の Git連携を初めて使うときは、GitHub の Install & Authorize Cloudflare Workers and Pages のページが開く。Workers と Pages で共通の GitHub App。

そこで All repositories を選ぶ(どのリポジトリをデプロイするかは、このあとの画面で選ぶので、ここで個別に指定する必要はない)。 組織(Organization)アカウントでは権限ポリシーの都合で All repositories を選べないことがあるが、その場合は個人アカウントを作成して使うこと(このハンズオンは個人アカウント前提)。

Install & Authorize Cloudflare Workers and Pages

Install & Authorize Cloudflare Workers and Pages

Install & Authorize をクリックすると Cloudflare のページへ戻る。初回の作業はここまで。

うまく連携できない場合や、リポジトリ一覧に自分のリポジトリが出ない場合は、GitHub の Settings → Applications → Installed GitHub Apps で Cloudflare Workers and Pages の Configure を開き、Repository access を All repositories に設定して Save する。

ここまでで、GitHub の main ブランチに push すると Cloudflare が自動でデプロイする仕組みが整った。以降は エージェントで修正 → push → 自動デプロイ の繰り返しになる。

公開URLや過去のデプロイ履歴は Compute → Workers & Pages → プロジェクト名 → Deployments で確認できる。

修正依頼プロンプト例:

プロンプト
背景をもっと明るくしてください
プロンプト
数値入力をスライダーにしてください
プロンプト
ボタンの間隔をもっと広げて

参考: AIへの指示に使えるUI用語集:動く実例つき

途中、操作の許可を求めてくることがあるので対応する。

納得したら、GitHubへのアップを依頼:

プロンプト
変更をgitでコミットしてpushして

しばらく(1〜2分)待ってから公開URLにアクセスして確認。

このように修正と反映を繰り返して、Webアプリを仕上げよう!

4-2. main 以外のブランチを push したとき

Section titled “4-2. main 以外のブランチを push したとき”

Git連携は、main 以外のブランチが push されたときも、そのブランチを Preview(お試し版)としてデプロイする設定が最初からオンになっている。main だけに push しているうちは関係ないが、次のようなときに Preview が増える。

  • ブランチで試してから合流させる(→ GBA 5-4・5-5)
  • クラウドで動く Claude Code に作業を頼む(claude/ で始まる作業用のブランチを自動で作って push する)

Preview はデプロイの回数(無料枠)を使う。Pages では、Preview の URL は誰でも見られる状態で公開される。要らなければ止めておく。

プロジェクトの Settings → Builds の Previews Base タブ → Builds for Preview branches をオフにして保存する。作るときなら、Set up your application の Enable Preview builds をオフにしておく。

  • Free プランの Git連携のビルドには上限がある(2026年10月時点)。Workers(Workers Builds)は 月3,000分、Pages は 月500回・同時実行1・タイムアウト20分。静的サイトの push 頻度であれば通常は問題にならないが、CI で何度も push する場合や、Preview を止めずにブランチを多用する場合は注意(→ 4-2)
  • Cloudflare Workers and Pages の GitHub App のリポジトリ設定は、GitHub の Settings → Applications → Installed GitHub Apps → Configure からあとで変更できる(Uninstall は不要)
  • Cloudflare で作ったプロジェクトを誤って削除しても、再度 Git連携で作り直せばよい(リポジトリの内容が真実)。ただし pages.dev のプロジェクト名は再取得できない場合がある
  • 自分でCI/CDをコード管理したい場合、テスト・lint・マイグレーションなどpush前に挟みたい場合は、Git連携ではなく GitHub Actions版(Claude CodeでWebアプリを作ってGitHub ActionsでCloudflareに公開する)の方が向く
  • Cloudflare は Pages と Workers を1つの体験に統合し、今後の投資を Workers に集中する方針を示している(→ WVP)。2026年10月時点では強制移行の期限は発表されておらず、Pages は引き続き利用できる