コンテンツにスキップ

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

Git連携のハンズオンでは、Cloudflare 側で GitHub リポジトリとつなぎ、push するだけで自動デプロイされる仕組みを作った。この記事では同じ自動デプロイを、GitHub 側の自動化の仕組みである GitHub Actions で作る。

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

今回のハンズオンでは、一人完結型Webアプリ(参考)を作って、GitHub Actions で公開する。流れは Git連携のハンズオンとほぼ同じで、大きく違うのは3章。

GitHub Actions は、GitHub に組み込まれた自動化の仕組み。「main に push されたら、これを実行する」という手順をファイル(ワークフローファイル)に書いてリポジトリに置くと、push のたびに GitHub のサーバーがそれを実行する。この記事では、その手順の中で Cloudflare にデプロイさせる。

静的なサイトを公開するだけなら、手順は Git連携 のほうが少ない。Cloudflare 自身も、Git連携(Workers Builds)を標準の方法として案内している。GitHub Actions で増える手間と、代わりに得られるものは次のとおり(ドラッグ&ドロップや Wrangler も含めた4つの方法の比較は Cloudflareにデプロイする4つの方法 にある)。

Git連携GitHub Actions
権限を渡す向きCloudflare が GitHub を読むGitHub が Cloudflare を操作する
最初の準備リポジトリを選ぶトークン作成・登録、ワークフロー作成
デプロイ手順の置き場所Cloudflare の設定画面リポジトリの中
ビルドの無料枠Cloudflare 側GitHub 側
デプロイ前の処理挟みにくい手順を足せばよい
Preview(お試し公開)最初からある自分で組む

無料枠は、Cloudflare 側が Workers で月3,000分・Pages で月500回、GitHub 側が公開リポジトリなら無料・非公開リポジトリで月2,000分(2026年10月時点)。

GitHub Actions を選ぶ理由になるのは、次のようなとき。

  • デプロイの手順をリポジトリに残したい。ダッシュボードの設定は、あとから見返しにくい
  • デプロイの前に確認を挟みたい(たとえば、公開フォルダに秘密情報らしきファイルが混ざっていたら止める)
  • Cloudflare 側のビルド枠を使いたくない
  • GitHub Actions に一度触れておきたい。デプロイ以外にも、定期実行や自動チェックに使える仕組み

逆に、APIトークンの管理は自分の責任になる。トークンが漏れると、自分の Cloudflare アカウントの Workers や Pages を書き換えられてしまう。

ワークフローファイルはエージェントに作らせる

Section titled “ワークフローファイルはエージェントに作らせる”

ワークフローファイルは YAML という形式で書く。中身は「コードを取り出す」「Cloudflare にデプロイする」の2つの手順だけの、短いもの。この記事では、ワークフローファイルをエージェントに作らせる。読者が YAML を書く必要はない。

ただし、頼み方に一言足す。そのまま頼むと、エージェントが覚えている少し古い書き方で作ることがある(試したときは、公式の例より1つ前の版を使った)。「公式ドキュメントで今の推奨を確かめてから」と添えると、公式の例に合わせて作る。

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

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

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

セッションを始める前に、入力欄の下の権限のボタン(いまの設定が出ている)を押して、編集を受け入れる にしておく(自動 にしない)。

公開ファイル(HTMLなど)は public/ フォルダに置く構成にする。ワークフローファイルなどの設定ファイルが公開されないようにするため。

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

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

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

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

作ったアプリを GitHub に置く。3章で GitHub にトークンを登録するので、先にリポジトリが要る。

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

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

Claudeデスクトップアプリの GitHub の MCP プラグインを入れている場合は、無効にしておく(理由は Git連携のハンズオンの2章 と同じ)。

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

まだワークフローファイルが無いので、この push では何も公開されない。

3. GitHub Actions で Cloudflare に公開する

Section titled “3. GitHub Actions で Cloudflare に公開する”

GitHub Actions が Cloudflare にデプロイするには、Cloudflare を操作する権限(APIトークン)と、どのアカウントか(Account ID)を GitHub に預けておく必要がある。この章では、その2つを用意して GitHub に登録し、最後にワークフローファイルを作って push する。

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

Workers でも Pages でも、同じトークンを使う。

Cloudflare ダッシュボード の右上の 👤 アイコン → Profile → API Tokens → Create Token をクリック。テンプレートの一覧から Edit Cloudflare Workers を選ぶ。

Create Token の画面に、権限(Permissions)が並んだ状態で開く。名前に Workers とあるが、Cloudflare Pages の Edit も入っているので、Pages にもこのトークンでデプロイできる。

権限はそのままにして、下の2か所を設定する。

  • Account Resources:Include と自分のアカウントになっていることを確かめる
  • Zone Resources:最初は Specific zone になっていて、そのままだと「Choose a zone resource」と出て先に進めない。All zones from an account に変えて、右の欄で自分のアカウントを選ぶ
Zone Resources の選択肢。All zones、All zones from an account、Specific zone の3つが並び、上に Choose a zone resource の赤い表示がある

Zone Resources は All zones from an account に

Create Token の画面。Token name に Edit Cloudflare Workers、Permissions に Workers Scripts や Cloudflare Pages などの行が並び、Account Resources と Zone Resources に自分のアカウントが選ばれている

設定し終えた状態

Continue to summary をクリック。確認の画面で Create Token をクリックする。

Edit Cloudflare Workers API token summary の画面。アカウントに対する権限の一覧と、All zones に Workers Routes:Edit、右下に Create Token ボタン

確認して Create Token

作られたトークンが表示される。この画面を閉じると二度と表示されないので、すぐ次の 3-3 で GitHub に登録する。

Zone の権限(Workers Routes)は、独自ドメインに Worker をつなぐときに使うもの。この記事の公開(workers.dev / pages.dev)には使わない。

GitHub には、リポジトリごとに秘密の値を預ける Secrets という置き場がある。ここに入れた値は GitHub Actions から読めるが、あとから GitHub の画面で中身を見ることはできず、実行のログにも *** と伏せて出る。

トークン:コピーしたトークンを、エージェントに頼んで登録する。値は自分でターミナルのタブに入力する。

プロンプト
Cloudflare の APIトークンを、このリポジトリの GitHub の Secrets に CLOUDFLARE_API_TOKEN として登録して。
値は私がターミナルのタブで入力する

先に、リポジトリと登録済みの Secrets を確かめるコマンドの許可を求められることがある(値は出ない)。続いて「ターミナルでコマンドを実行します」の許可を求められるので、一度だけ許可 を押す。ターミナルのタブが開いて、? Paste your secret: と値の入力を待つ。タブにトークンを貼り付けて Enter を押す(貼り付けても画面には表示されない)。

Claudeデスクトップアプリの画面。左の会話で Claude が gh secret set を起動したと説明し、右のターミナルのタブに Paste your secret と表示されて入力を待っている

右のタブにトークンを貼り付けて Enter

「値は私がターミナルのタブで入力する」を添えないと、エージェントが値を聞いてきて、会話に値が残ることがある。

Account ID:秘密の値ではないので、会話に書いてよい。ダッシュボードの Compute → Workers & Pages を開くと、右側の列のいちばん下に Account ID がある(ウィンドウの幅によって3列か2列で表示される。3列なら3列目、2列なら2列目のいちばん下)。コピーして、エージェントに頼む。

プロンプト
このリポジトリの GitHub の Secrets に、CLOUDFLARE_ACCOUNT_ID として次の値を登録して。
====
<コピーした Account ID>

登録できたかは、エージェントに「GitHub の Secrets の一覧を見せて」と頼めば確かめられる(名前と登録日時だけが出て、値は出ない)。GitHub のサイトでは、リポジトリの Settings → Secrets and variables → Actions で見られる。

3-4. ワークフローファイルを作って push する

Section titled “3-4. ワークフローファイルを作って push する”
プロンプト
main に push したら、GitHub Actions で public フォルダを Cloudflare Workers に公開する仕組みを作って。
名前は <ベース名>。
APIトークンと Account ID は GitHub の Secrets に CLOUDFLARE_API_TOKEN と CLOUDFLARE_ACCOUNT_ID で入れてある。
書き方は Cloudflare の公式ドキュメントで今の推奨を確かめてから。

公式ドキュメントのページを読む許可を求められたら許可する。

エージェントは2つのファイルを作る。

  • wrangler.jsonc:Worker の名前と、公開するのが public/ だけであることを書いた設定ファイル(Wrangler のハンズオンと同じもの)
  • .github/workflows/ の中のワークフローファイル

ワークフローファイルは、試したときはこうなった。

name: Deploy Worker
on:
push:
branches:
- main
jobs:
deploy:
runs-on: ubuntu-latest
timeout-minutes: 60
steps:
- uses: actions/checkout@v6
- name: Deploy Worker
uses: cloudflare/wrangler-action@v4
with:
apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

on が「main に push されたら」、steps の2つの手順が「コードを取り出す」「Cloudflare にデプロイする」。トークンと Account ID は、ファイルに直接は書かず secrets.… で Secrets から読んでいる。

できたファイルで、次の3点を確かめる。読み方が分からなければ、エージェントに聞けばよい。

  • 公開するのが public/ だけになっているか
  • 動くきっかけが「main への push」になっているか
  • トークンや Account ID の値が、ファイルに直接書かれていないか(secrets.… で読んでいるか)

確かめたら push する。

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

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

push すると、GitHub Actions が動き出す。結果もエージェントに確かめてもらえる。

プロンプト
GitHub Actions の実行が終わるまで待って、結果と公開URLを教えて

試したときは、push から30秒ほどで公開まで終わった。公開URLは、Workers なら https://<ベース名>.<サブドメイン>.workers.dev、Pages なら https://<ベース名>.pages.dev。ブラウザで開いて確認する。

GitHub のサイトでは、リポジトリの Actions タブで実行の一覧と、それぞれのログが見られる。

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

修正依頼プロンプト例:

プロンプト
背景をもっと明るくしてください
プロンプト
ボタンの間隔をもっと広げて

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

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

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

しばらく待ってから公開URLにアクセスして確認。

失敗すると、Actions タブの実行の一覧に赤い印が付く。原因はログに出ているので、エージェントに読ませる。

プロンプト
GitHub Actions のデプロイが失敗した。ログを見て原因を教えて

考えられる原因は次の3つ。

  • Secrets の名前が、ワークフローファイルで読んでいる名前と違う
  • トークンの値が空、または途中で切れている(3-3 を、値を貼り直してやり直す)
  • Pages で、プロジェクトが無いままデプロイした(3-4 の Pages タブ)
  • cloudflare/wrangler-action は v4 から Wrangler 4 を既定で使う。古い記事やエージェントが書く wranglerVersion: "4" は、もう書かなくてよい
  • APIトークンを無くしたら、Cloudflare で作り直して、Secrets の CLOUDFLARE_API_TOKEN を登録し直す(同じ名前で登録すれば上書きされる)。古いトークンは API Tokens の一覧から削除しておく
  • Pages のプロジェクトを手元のエージェントに wrangler pages project create で作らせると、Pages ではなく同じ名前の Worker として公開されることがある(エージェントから Wrangler を使うと、新しいプロジェクトを Workers に振り替える仕組みがある)。Pages として作るには --force を付ける。GitHub Actions の中で作る場合は振り替えは起きなかった
  • Cloudflare は Pages と Workers を1つの体験に統合し、今後の投資を Workers に集中する方針を示している(→ WVP)。Pages のプロジェクトが無いときのエラーメッセージでも、Workers を使うよう強く勧めている。2026年10月時点では強制移行の期限は発表されておらず、Pages は引き続き利用できる