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連携で公開する。
本記事の位置付け
Section titled “本記事の位置付け”Cloudflare に手元のサイトを公開したいだけなら、こんなざっくりとした依頼でも進められる:
このフォルダの中身を GitHub 経由で Cloudflare に公開したいClaude Code はアカウントの有無や環境などを聞きながら、最終的にデプロイまで案内してくれる。ただし、その過程で取る道は人によって違う。
本記事では、その中で Cloudflare の Git連携で自動デプロイにする 道筋を、つまずきにくい順序で追っていく。
1. Claude Code でWebアプリを作成
Section titled “1. Claude Code でWebアプリを作成”このハンズオンでは 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 Codeでポモドーロタイマーを作成
なお、途中、操作の許可を求めてくることがあるので対応する。
2. GitHub に push
Section titled “2. GitHub に push”作ったアプリを GitHub に置く。次章で Cloudflare 側がリポジトリの中身を読み取ってデプロイするため、先に GitHub にコードが push されている必要がある。
事前に Git と GitHub の基本 を終えて、次の状態になっていること:
- GitHub アカウント作成済み
ghCLI インストール・認証済み(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):
git initgit add -Agit commit -m "初回コミット"gh repo create my-git-app --private --source=. --remote=origin --pushgh repo create --source=. --push は「ローカルのコミットを GitHub に上げる」コマンド。先に git init でフォルダをリポジトリ化し、コミットを1つ作ってから実行する必要がある(コミットが無いと push しても中身が上がらない)。my-git-app は自分のベース名に読み替える。
3. Git連携で Cloudflare に公開する
Section titled “3. Git連携で Cloudflare に公開する”Cloudflare に GitHub リポジトリを連携すると、リポジトリに変更が push されるたびに自動でデプロイが実行される。この章ではその連携を設定する。
3-1. Cloudflareアカウントを作る
Section titled “3-1. Cloudflareアカウントを作る”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" }}
公開前の確認の例
push の前に「公開される範囲」を説明して、push してよいか聞いてくることがある。
public/の中身だけが公開され、wrangler.jsoncやREADME.mdは公開されないことを確かめて「push して」と答える。
次に、Cloudflare 側でリポジトリを連携する。 Cloudflare ダッシュボード を開き、左メニューの Compute → Workers & Pages をクリック、右上の Create application をクリック。
Make something new の画面で Continue with GitHub をクリック。初回は GitHub との連携の承認を求められる(→ 3-3)。

Continue with GitHub
Select a repository に自分の GitHub のリポジトリが並ぶので、自分のリポジトリ(<ベース名>)を選んで 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)

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

緑のチェックが付けば完了
公開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 しておく。
Cloudflare ダッシュボード を開き、左メニューの Compute → Workers & Pages をクリック、右上の Create application をクリック。
Make something new の画面の下にある、目立たない Need to use the legacy Pages workflow? の Continue to Pages をクリック。
Get started の画面で、Import an existing Git repository の Get started をクリック。

Import an existing Git repository の Get started
初回は GitHub との連携の承認を求められる(→ 3-3)。
Deploy a site from your account の Select a repository から自分のリポジトリ(<ベース名>)を選び、Begin setup をクリック。

リポジトリを選ぶ
Set up builds and deployments のページが開く。設定するのは以下の2項目:
- Project name に
<ベース名>を入れる(リポジトリ名と同じでよい。揃えると管理しやすい)。公開URLの一部になる(https://<ベース名>.pages.dev)。入力欄の直下に割り当てられるURLが表示される。末尾に文字が付く場合はすでに使われているので、別の名前に変えてもよい - Build output directory に
publicと入力:デプロイ対象をpublic/に絞るため
Production branch は main のまま。その他の項目(Framework preset、Build command など)も、そのままで構わない。public/ 配下の静的ファイルがそのまま配信される。

Build output directory に public
Save and Deploy をクリックするとデプロイが始まる。完了すると公開URL(https://<ベース名>.pages.dev)が表示されるのでアクセスして確認する。

完了すると公開URLが出る
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 のページへ戻る。初回の作業はここまで。
うまく連携できない場合や、リポジトリ一覧に自分のリポジトリが出ない場合は、GitHub の Settings → Applications → Installed GitHub Apps で Cloudflare Workers and Pages の Configure を開き、Repository access を All repositories に設定して Save する。
4. 修正して再デプロイ
Section titled “4. 修正して再デプロイ”ここまでで、GitHub の main ブランチに push すると Cloudflare が自動でデプロイする仕組みが整った。以降は エージェントで修正 → push → 自動デプロイ の繰り返しになる。
公開URLや過去のデプロイ履歴は Compute → Workers & Pages → プロジェクト名 → Deployments で確認できる。
4-1. 修正して push する
Section titled “4-1. 修正して push する”修正依頼プロンプト例:
背景をもっと明るくしてください数値入力をスライダーにしてくださいボタンの間隔をもっと広げて途中、操作の許可を求めてくることがあるので対応する。
納得したら、GitHubへのアップを依頼:
変更をgitでコミットしてpushしてしばらく(1〜2分)待ってから公開URLにアクセスして確認。
このように修正と反映を繰り返して、Webアプリを仕上げよう!
4-2. main 以外のブランチを push したとき
Section titled “4-2. main 以外のブランチを push したとき”Git連携は、main 以外のブランチが push されたときも、そのブランチを Preview(お試し版)としてデプロイする設定が最初からオンになっている。main だけに push しているうちは関係ないが、次のようなときに Preview が増える。
Preview はデプロイの回数(無料枠)を使う。Pages では、Preview の URL は誰でも見られる状態で公開される。要らなければ止めておく。
プロジェクトの Settings → Builds の Previews Base タブ → Builds for Preview branches をオフにして保存する。作るときなら、Set up your application の Enable Preview builds をオフにしておく。
プロジェクトの Settings → Build → Branch control の鉛筆アイコン → Preview branch を None (Disable automatic branch deployments) にして Save。
保存しても Settings の一覧の表示は変わらない(Production branch と Automatic deployments しか出ない)。鉛筆アイコンを開き直して None になっていれば止まっている。
- 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 は引き続き利用できる