Claude Codeでデータ共有型Webアプリを作ってCloudflareに公開する
ここまでのハンズオンでは一人完結型Webアプリを公開した。今回はその先として、データベースを使ってみんなで使えるWebアプリを作る。データを保存・共有できると、ほかの人の書き込みを表示したり、記録を残しておいたりできるようになる。
今回のハンズオンでは、データ共有型Webアプリ(参考)を作って、Cloudflare に公開する。公開のしかたは wrangler で直接デプロイする方法と Git連携で自動デプロイする方法の2通りを用意したので、好きな方を選べる。
本記事の位置付け
Section titled “本記事の位置付け”データを共有する Web アプリを作って公開したいなら、こんなざっくりとした依頼でも進められる:
みんなが書き込める掲示板アプリを作って公開したいClaude Code は使いたいサービスや構成などを聞きながら、最終的にアプリの実装からデプロイまで案内してくれる。ただし、その過程で取る道は人によって違う。
本記事では、その中で Cloudflare D1 を使ったデータ共有型アプリを、つまずきにくい順序で作って公開する。公開の段では wrangler で直接デプロイする方法(ケース1)と、GitHub に置いて Git連携で自動デプロイする方法(ケース2)の両方を案内する。
公開先は Pages と Workers のどちらでもよい。手順が違うところはタブで切り替えて読む(CloudflareにHTMLをアップロードして公開するで選んだほうが開く)。
1. このハンズオンの全体像
Section titled “1. このハンズオンの全体像”1-1. 作るもの:匿名一行掲示板
Section titled “1-1. 作るもの:匿名一行掲示板”このハンズオンではサンプルとして、匿名一行掲示板を作っていく。
仕様:
- 名前の入力不要。書き込むだけで投稿できる
- 書き込んだ人には自動的に「会員1号」「会員2号」と番号が割り振られる
- 同じブラウザから書き込むと、次回以降も同じ会員番号が使われる
- みんなの投稿を一覧表示する
▶ 完成版を試してみる: bbs-sample.vibecodingnotes.com:この章で作る掲示板の完成版。実際に書き込んで動きを確かめられる(デモのため、投稿は予告なくリセット・削除することがある)。
1-2. 全体構成の復習
Section titled “1-2. 全体構成の復習”データ共有型のWebアプリは、フロントエンド・バックエンド・データベースの3つの部品でできている。レストランにたとえると分かりやすい。
3つの部品をレストランにたとえると
お客さん(ブラウザ)は、客席で給仕係(フロントエンド)に注文する。注文を受けた料理人(バックエンド)が、冷蔵庫(データベース)から材料(データ)を出して料理を作る。お客さんが冷蔵庫を直接開けることはない。
3章ではこの3つを一気に作り、4章でそれぞれがどのファイルになったかを見て回る。一気に作っても、中ではこの3つが別々にできている。
このハンズオンで使う構成を整理しておく(詳細はCloudflare構成ガイド)。
| 役割 | Cloudflareのサービス |
|---|---|
| フロントエンド(画面・UI) | Cloudflare Workers(静的ファイル) |
| バックエンド(API処理) | Cloudflare Workers(Worker のコード) |
| データベース | Cloudflare D1 |
Workers は、画面のファイルと API のコードを1つの Worker にまとめて公開する。
| 役割 | Cloudflareのサービス |
|---|---|
| フロントエンド(画面・UI) | Cloudflare Pages |
| バックエンド(API処理) | Cloudflare Pages Functions |
| データベース | Cloudflare D1 |
この構成を念頭に置いて進めると、「今何をやっているのか」がわかりやすくなる。
本ハンズオンは大きく3段階に分かれる:
- 準備:作業フォルダを用意し、Wrangler のログインを確認して Claude Code を起動する
- 作る:データベースから画面までをまとめて頼んで手元で動かし、できたものを見学する
- 公開:本番環境にコードをデプロイする。本番DBにマイグレーションを適用する
1-3. 本番に反映する2つの流れ:デプロイとマイグレーション
Section titled “1-3. 本番に反映する2つの流れ:デプロイとマイグレーション”公開のときに意識したいのは、手元の変更を本番に反映する作業が2種類あり、呼び名も反映のしかたも違うこと。まとめれば「本番反映」だが、中身は次の2つに分かれる。
手元(ローカル)の変更 → 本番に反映する(本番反映) ├ コード(画面・API) → デプロイ(今の状態で丸ごと置き換える) └ DBのスキーマ → 本番DBへのマイグレーション適用(変更を1回だけ足す)- コード(フロントエンド・API):Cloudflare にデプロイして公開する。やり方は2通り。ケース1は
wranglerで手元から直接デプロイ、ケース2は GitHub に push して Git連携で自動デプロイ。3章で作って手元で動かしたら、好きな方を選ぶ - DBのスキーマ:手元から本番DB(
--remote)にマイグレーションを適用する。どちらの公開方法でも共通で、自動では反映されないので手動で行う
コードのデプロイは今のファイルで丸ごと置き換える作業なのに対し、マイグレーションはDBの中のデータを残したまま構造だけを少しずつ変えていく。丸ごと入れ替えたらデータが消えてしまうので、DBは置き換えではなく差分の適用になる。
2. 事前準備
Section titled “2. 事前準備”2-1. ベース名を決める
Section titled “2-1. ベース名を決める”このアプリでは、作業フォルダ・D1データベース・プロジェクト・GitHubリポジトリの4つに名前を付ける。これらの名前は 自分のアカウント内で重複できない。前に作ったものと同じ名前を一箇所でも使うとそこで衝突してうまくいかない。
そこで最初に、自分だけの ベース名 を1つ決めておく。短く・英小文字と数字とハイフンだけにしておくと、そのまま全部の名前に使える。
自分がこれまでに使っていない名前なら何でもよい(例: my-bbs)。ほかの人と同じ名前でもかまわない。
ベース名はそのまま 公開URL(https://<ベース名>.<サブドメイン>.workers.dev)の先頭になる。<サブドメイン> はアカウントごとに決まっている名前で、ほかの人と名前がぶつかることはないので、空きの確認は要らない。
サブドメインにメールアドレスの名前が入っている場合の変え方は、CloudflareにHTMLをアップロードして公開するの Workers のタブにある。
例: bbs-yto(イニシャル)、bbs-0629(日付)など、ほかの人と被らなそうなものにする。
Pages のプロジェクト名だけは、自分のアカウントの中だけでなく Cloudflare 全体で一意。ベース名はそのまま 公開URL(https://<ベース名>.pages.dev)になる。すでに使われているとベース名の後ろにランダムな英数3文字が付くので、URL をきれいにしたい場合はブラウザで https://候補名.pages.dev を開いて空きを確認しておくとよい。「このサイトにアクセスできません」と表示されれば、その名前はまだ使われていない(空き)。逆に Cloudflare のエラー画面(522 や 1016 など)や「ページが見つかりません」などが出たら、その名前はすでに使われているので避ける。

候補の pages.dev を開いたときの表示例。「このサイトにアクセスできません」だけが空きで、ほか(522 / 1016 / 404)は使われている
この記事では、決めたベース名を <ベース名>、D1データベース名を <ベース名>-db と表記する(D1データベースだけは名前のうしろに -db を付ける)。次の 2-3 でこの名前を Claude に覚えさせるので、以降は <ベース名> と書いたプロンプトをそのまま Claude に渡せば、Claude が自分のベース名に展開して実行してくれる。
2-2. 作業フォルダを準備
Section titled “2-2. 作業フォルダを準備”作業フォルダの名前は、ベース名にそろえる(例: my-bbs)。
2-3. Claude Codeを起動
Section titled “2-3. Claude Codeを起動”新しく作った作業フォルダ ~/claude/my-bbs を Claudeデスクトップアプリで開く(→ SUP 1-1)。
セッションを始める前に、入力欄の下の権限のボタン(いまの設定が出ている)を押して、編集を受け入れる にしておく(自動 にしない)。自動だと Claude がファイルの変更やコマンドを確認なしで一気に進めてしまい、意図しない結果になる事故が起きやすい。まずは一つずつ承認しながら進めるのが安全。
セッションを開始したら、最初にベース名を Claude に覚えさせる。次のプロンプトは、my-bbs(1箇所だけ)を自分のベース名に置き換えて渡す。置き換えるのはこの1箇所でよい(D1データベース名は Claude が自動で -db を付けてくれる)。
以下を AGENTS.md に記録してください。CLAUDE.md からは AGENTS.md を読み込むようにしてください。====このプロジェクトのベース名は my-bbs です。- アプリ名・プロジェクト名・GitHubリポジトリ名 = ベース名- D1データベース名 = ベース名のうしろに -db を付けた名前これ以降、私のプロンプトの <ベース名> はベース名に、<D1データベース> は「ベース名-db」に読み替えて作業してください。これでベース名が AGENTS.md(エージェントへの指示ファイル)に書き込まれ、CLAUDE.md には AGENTS.md を読み込む1行が入る。Claude はこれを毎回読み込むので、会話が長くなっても名前を忘れない(2つのファイルの関係は → CLM)。以降のステップでは <ベース名> や <D1データベース> と書いたプロンプトをそのまま渡せば、Claude が自分の名前に展開してくれる。なお、ターミナルで直接実行するコマンド例は my-bbs のまま載せているので、ターミナルに入力する場合は自分のベース名に読み替える。
本記事は Claude Code を例に進めるが、Codex など他のコーディングエージェントでも同じプロンプトで進められる。以降、プロンプトを渡す相手をまとめて エージェント と呼ぶ。Codex は AGENTS.md を直接読むので、プロンプトは読み替えずにそのまま使える。
2-4. 作るものをエージェントに覚えさせる
Section titled “2-4. 作るものをエージェントに覚えさせる”アプリの仕様を、先に AGENTS.md に書いてしまう。 以降のプロンプトでは「仕様のとおりに」と参照するだけでよくなる。
これから作るアプリの仕様を AGENTS.md に書いてください。====## 作るもの:匿名一行掲示板- 名前登録なし、初めて投稿したときに会員番号が払い出される(1, 2, 3...の連番)- 同じブラウザから投稿した人には毎回同じ会員番号が使われるようにする- 画面には「会員1号」「会員2号」と表示する- 投稿内容は1行のテキストなぜ先に書くのか。仕様をプロンプトに書くと、作りたいものの話と、どう作るかの話が混ざる。会話の流れで伝えるやり方もあるが、それだとセッションを開き直したときに失われる。
先に1回書いておけば、以降のプロンプトは「どう作るか」だけになる。そして、別のアプリを作りたくなったら、ここを差し替えるだけでよい(→ D1で実践:アンケート・ランキング・分担表)。
仕様が長くなってきたら、別のファイル(
SPEC.mdなど)に移してAGENTS.mdから指す形にする。AGENTS.mdは「毎回読ませたいこと」を置く場所なので、増えすぎると毎回の読み込みが重くなる(→ 作業メモをリポジトリに残す)。今回の仕様は数行なのでAGENTS.mdに直接書く。
2-5. Wranglerログイン状態の確認
Section titled “2-5. Wranglerログイン状態の確認”Wrangler のログイン状態を確認する。Wranglerハンズオンを完了している場合、Node.jsとWranglerログインは済んでいるはず。
npx wrangler whoamiアカウント名やメールアドレスが表示されればOK。表示されない場合はWranglerハンズオンの1章を参照してインストール・ログインする。
3. 一気に作って、手元で動かす
Section titled “3. 一気に作って、手元で動かす”2-4 で仕様を AGENTS.md に書いたので、データベース・スキーマ・設定ファイル・バックエンド(API)・フロントエンド(画面)を一気に頼む。作ったあと、手元(ローカル)で動かすところまで続けて頼む。
AGENTS.md の仕様のとおりに、この掲示板を Cloudflare Workers で作って。D1データベース <D1データベース> がまだ無ければ作って。テーブルはマイグレーションファイルで作る。公開するのは public フォルダの中だけにする。API のコードは src/index.js に書く。作ったら、ローカルの D1 にマイグレーションを適用(migrations apply)してから、ローカルサーバーを起動して。API のファイル名(src/index.js)まで指定しているのは、あとでやる応用のハンズオン(管理画面だけを Cloudflare Access で守る)の依頼文がこの名前を使うため。ここでそろえておけば、そのまま進める。
AGENTS.md の仕様のとおりに、この掲示板を Cloudflare Pages(Pages Functions)で作って。D1データベース <D1データベース> がまだ無ければ作って。テーブルはマイグレーションファイルで作る。公開するのは public フォルダの中だけにする。作ったら、ローカルの D1 にマイグレーションを適用(migrations apply)してから、ローカルサーバーを起動して。D1データベースは、まだ無ければ作られる。前に同じ名前の D1 を作っていると、それをそのまま使う。別のアプリのデータと混ざらないよう、ベース名はこれまでに使っていないものにする(2-1)。
手元で試したときは、D1データベースの作成からローカルサーバーの起動まで、1分ほどで進んだ。待っているあいだに、プロンプトが何を頼んでいるのかを読んでおく。
3-1. プロンプトを読む
Section titled “3-1. プロンプトを読む”プロンプトの言葉が、1-2 の表のどの部品の話なのかを並べる。それぞれがどのファイルになったかは、4章で見て回る。
| プロンプトの言葉 | 当たる部品 | 頼んでいること |
|---|---|---|
| AGENTS.md の仕様のとおりに | 全体 | 2-4 で書いた仕様(何を作るか)のとおりに作る |
| Cloudflare Workers で作って(Pages なら Pages Functions で) | 公開先 | 公開先に合わせた作りにする。公開先によってバックエンドの置き場所が変わる |
D1データベース <D1データベース> がまだ無ければ作って | データベース | 本番のデータベースを用意する |
| テーブルはマイグレーションファイルで作る | データベース(スキーマ) | 表の作り方を、手順書のファイルに残す |
| API のコードは src/index.js に書く(Workers だけ) | バックエンド(API) | API を書くファイルの名前をそろえる |
| 公開するのは public フォルダの中だけにする | フロントエンド(画面) | 外に出すのは画面のファイルだけにする |
| ローカルの D1 にマイグレーションを適用 | データベース(手元) | 手元のデータベースに、手順書どおりに表を作る |
| ローカルサーバーを起動して | 確かめる | 公開する前に、手元で動かす |
画面(フロントエンド)について、プロンプトが言っているのは置き場所(public)だけ。画面に何を出すかは仕様に書いてあるので、そこから作られる。
3-2. 手元で動かして確かめる
Section titled “3-2. 手元で動かして確かめる”起動したら、表示された URL(Workers なら http://localhost:8787、Pages なら http://localhost:8788 など)をブラウザで開き、1行書き込んでみる。「会員1号」と出て、もう一度書き込んでも同じ番号なら、仕様のとおりに動いている。
「ローカルで確認したい」とだけ伝えると、マイグレーションのローカル適用が抜けてテーブルが無いまま起動することがある。「ローカルのD1に適用してから」まで含めると抜けにくい。
起動するのは Wrangler 内蔵のサーバー(Pages なら
wrangler pages dev、Workers ならwrangler dev)。API と D1 も一緒に動く。python -m http.serverのような静的サーバではバックエンドとDBが動かず、このアプリは正しく動作しない。
Pages で投稿一覧が出ないとき: ターミナルに
Cannot read properties of undefined (reading 'prepare')と出ていたら、データベースがプログラムに渡っていない。作業フォルダより上のフォルダにpackage.jsonがあると、Pages のローカルサーバーがデータベースの設定を読み落とす(Workers では起きない)。「作業フォルダに package.json を作ってから、ローカルサーバーを起動し直して」と頼めば直る。
途中で止まってどこが悪いのか分からないときは、部品ごとに分けて頼む手順が補足にある。
4. できたものを見学する
Section titled “4. できたものを見学する”一気に頼んだので、何がどこにできたかをここで見て回る。1-2 のレストランの絵の客席・キッチン・冷蔵庫(フロントエンド・バックエンド・データベース)が、手元のどのファイルに当たるのかを確かめる。
作ったものを見学したい。このフォルダにできたファイルとフォルダ(隠しフォルダも含めて)を、データベース・スキーマ・バックエンド・フロントエンド・設定のどれに当たるかで表にして。D1 のデータベースそのものはどこにあるかも教えて。返ってくる表は、おおよそ次のようになる。
| ファイル・フォルダ | 当たるもの | 中身 |
|---|---|---|
public/index.html | フロントエンド | 画面。公開されるのは public/ の中だけ |
src/index.js | バックエンド | API。/api/posts で投稿の一覧を返し、書き込みを受け付ける |
migrations/0001_init.sql | スキーマ | テーブルの形を書いたファイル |
.wrangler/ | データベース(手元) | 手元で動かすときの D1 の中身。隠しフォルダ |
wrangler.jsonc | 設定 | Worker の名前、公開するフォルダ、D1 との結びつけ |
| ファイル・フォルダ | 当たるもの | 中身 |
|---|---|---|
public/index.html | フロントエンド | 画面。公開されるのは public/ の中だけ |
functions/api/posts.js | バックエンド | API(Pages Functions)。/api/posts で投稿の一覧を返し、書き込みを受け付ける |
migrations/0001_init.sql | スキーマ | テーブルの形を書いたファイル |
.wrangler/ | データベース(手元) | 手元で動かすときの D1 の中身。隠しフォルダ |
wrangler.jsonc | 設定 | プロジェクトの名前、公開するフォルダ、D1 との結びつけ |
ファイル名やテーブルの作りは、作るたびに少し変わる。会員の見分け方も、Cookie のこともあれば localStorage のこともある(手元で試したときは両方あった)。
4-1. フロントエンド:画面
Section titled “4-1. フロントエンド:画面”public/index.html が画面。外から見えるのは public/ の中だけで、API のコード・手順書・設定ファイルは公開されない(どこで決めているかは 4-6)。
画面は、開いたあとに API(/api/posts)を呼んで、投稿の一覧を読んだり、書き込んだりする。投稿のデータは、画面ではなくデータベースにある。
4-2. バックエンド:API
Section titled “4-2. バックエンド:API”Workers なら src/index.js、Pages なら functions/api/ の下のファイルが API。画面から呼ばれて、データベースを読み書きする。
DBを操作するAPIの実装は、業界標準的なパターンがほぼ決まっている。生成はエージェントに任せてよい。
ただし、できあがったコードが「どんなときに何を返すのか」は自分で把握しておくと、あとで動作確認したり修正を依頼したりするときに困らない。
いま作ったAPIの動きを箇条書きで説明して。投稿が空のときや長すぎるときの扱いも教えて静的ファイル(
public/にあるもの)へのリクエストは無料・無制限だが、API などコードが動くリクエストは無料プランで1日10万回まで数えられる。掲示板の規模なら届くことはまずない。
4-3. データベース:Excel にたとえる
Section titled “4-3. データベース:Excel にたとえる”スキーマ:データベースの構造定義のこと。どんなテーブルがあり、それぞれどんな列(カラム)を持ち、列ごとにどんな値を入れるか(型や、空を許すかなど)を定めたもの。
マイグレーション:データベースの構造変更(テーブルの作成・変更・削除など)をSQLファイルとして管理する仕組み。変更をファイルに記録しておくことで、「どの変更がいつ適用されたか」を追跡でき、本番環境への反映も自動化できる。スキーマが「何を作るか」なら、マイグレーションファイル(
0001_init.sql)は「それをどう作るか」を記したもの。
データベースまわりの言葉は、Excel にたとえると次のように対応する。正確な対応ではなく、イメージをつかむためのたとえ。
| 言葉 | やっていること | Excel でいえば |
|---|---|---|
| D1データベースを作る | データを入れる入れ物を用意する | 新しい Excel ファイルを作る |
| テーブル | データを入れる表。1つのデータベースにいくつも作れる | シート |
| スキーマ(テーブルの設計) | どんなテーブルがあり、それぞれにどんな列があり、列ごとにどんな値を入れるか(数値か文字か、空を許すか、など)の決まり | 各シートの1行目の見出しと、列ごとに入れてよい値の種類(数値・文字・日付など)を決めておくこと |
| マイグレーションファイル | テーブルを作る手順を書いたファイル(migrations/0001_init.sql) | 「このシートを作り、1行目にこの見出しを書く」という手順書 |
| マイグレーションを適用 | 手順書どおりに、データベースにテーブルを作る | 手順書を見ながら、Excel ファイルにシートを作る |
スキーマは、手元で試したときは次の2つのテーブルになった(作るたびに少し変わる)。列の見出しを Excel の1行目のように並べると、こうなる。
手元で試したときにできた2つのテーブルに、ダミーのデータを入れた例。1行目の列の見出しは、スキーマの一部。スキーマは列ごとに入れる値の種類なども決めている
中身が入ると、たとえば次のようになる(2行目からはダミーのデータ)。
会員のテーブル members:
| id(会員番号) | token(同じブラウザかを見分ける長い乱数) | created_at(会員になった日時) |
|---|---|---|
| 1 | 7f3a9c2e5b… | 2026-10-30 05:47:39 |
| 2 | b81e04d6a3… | 2026-10-30 05:52:10 |
投稿のテーブル posts:
| id(投稿の番号) | member_id(書いた会員の番号) | body(投稿の本文) | created_at(投稿した日時) |
|---|---|---|---|
| 1 | 1 | こんにちは | 2026-10-30 05:47:39 |
| 2 | 2 | はじめまして | 2026-10-30 05:52:10 |
| 3 | 1 | 今日は晴れ | 2026-10-30 06:03:25 |
投稿のテーブルには、書いた人の名前ではなく、会員のテーブルの番号(member_id)を入れておく。上の例では、投稿1と投稿3が会員1号、投稿2が会員2号の書き込み。画面に「会員1号」と出すときは、この番号を使う。
migrations/0001_init.sql を開くと、CREATE TABLE で始まるテーブルの定義が並んでいる。これが手順書の中身。自分の作ったテーブルの列を確かめたいときは、エージェントに説明してもらう。
migrations/0001_init.sql のテーブル設計を、表にして説明して4-4. データベース:2か所にある
Section titled “4-4. データベース:2か所にある”D1 のデータベースは、手元(ローカル)と本番(Cloudflare 側)の2か所に別々にある。片方にテーブルを作っても、もう片方は変わらない。
- 手元の D1:作業フォルダの
.wrangler/の中にある SQLite のファイル。3章のプロンプトでローカルにマイグレーションを適用したときに、自動でできた。名前が.で始まるフォルダは隠しフォルダで、Finder ではふだん見えない。ローカルサーバーで書き込んだ投稿はここに入る。.gitignoreに入れておけば GitHub には上がらない - 本番の D1:Cloudflare のアカウントの上にある。3章の「D1データベースを作って」で作った(または前からあったものを使った)のはこちら。まだテーブルは無く、公開するときに同じ手順書を当てて、はじめてテーブルができる(5章)
手元で書き込んだ投稿は、本番には出ない。手元は試すための別のデータベースで、本番のデータを壊さずに試せる。
Database ID(
database_id):wrangler.jsoncに書かれている、本番のデータベースの識別子。仮に外部に漏れても、API Tokenがなければ操作できないため問題なし。
4-5. データベース:マイグレーションファイルを残す理由
Section titled “4-5. データベース:マイグレーションファイルを残す理由”3章のプロンプトで「マイグレーションファイルで作る」と頼んだのは、手順書を残させるため。手順書があれば、手元と本番の2か所に同じテーブルを作れる。当てて揃うのは表の形(スキーマ)だけで、データは移らない。手元で書き込んだ投稿は、本番に適用しても入らない。
マイグレーションを適用すると、どの手順書をもう当てたかがデータベースの側に記録される。次に適用するときは、まだ当てていない手順書だけが当たる。
スキーマを変更したいときは、0001_init.sql を書き換えるのではなく、変更内容をエージェントに伝えて新しいマイグレーションファイル(0002_...)を追加してもらう(→ 7-2)。
4-6. 設定:wrangler.jsonc で部品をつなぐ
Section titled “4-6. 設定:wrangler.jsonc で部品をつなぐ”最後に、ここまでの部品をつなぐ設定ファイル。wrangler.jsonc は、プロジェクトの設定と、D1 データベースとの結びつけ(バインディング)をまとめたファイル。おおよそ次の形になっている(細かいところは作るたびに変わる)。
{ "name": "<ベース名>", "main": "src/index.js", "compatibility_date": "YYYY-MM-DD", "assets": { "directory": "./public", "binding": "ASSETS" }, "d1_databases": [ { "binding": "DB", "database_name": "<D1データベース>", "database_id": "(作ったデータベースのID)", "migrations_dir": "migrations" } ]}"main" が API のコード、"assets" の "directory": "./public" が公開する静的ファイルの置き場所。公開対象を public/ 配下に絞るので、wrangler.jsonc や migrations/、src/ のコードが外から見えることはない。
{ "name": "<ベース名>", "compatibility_date": "YYYY-MM-DD", "pages_build_output_dir": "./public", "d1_databases": [ { "binding": "DB", "database_name": "<D1データベース>", "database_id": "(作ったデータベースのID)", "migrations_dir": "migrations" } ]}"pages_build_output_dir": "./public" で公開対象を public/ 配下のファイルに絞る(wrangler.jsonc や migrations/ などのプロジェクトファイルが誤って公開されるのを防ぐ)。
バインディング(binding):プログラムからD1データベースを呼び出すときの名前。
"binding": "DB"なら、APIのコードからはenv.DBでデータベースにアクセスできる。コード上の名前(DB)と実際のデータベース(database_name/database_id)を結びつけるのがバインディングの役割。手元で試したときは、指定しなくてもDBになった。
5. 【ケース1】wrangler で直接公開する
Section titled “5. 【ケース1】wrangler で直接公開する”ここから公開に入る。公開のやり方は2通りあり、まずは GitHub の用意がいらず最短で公開できるケース1(wrangler で直接デプロイ)から見ていく。継続的に育てたいなら次章のケース2(Git連携)を選ぶとよい(両方試してもよい)。
| 【ケース1】wrangler で直接公開 | 【ケース2】Git連携で公開 | |
|---|---|---|
| GitHub | 不要 | 必要 |
| デプロイ | wrangler を手元から実行 | push で自動 |
| 変更履歴・ロールバック | Cloudflare のデプロイ履歴のみ | GitHub+Cloudflare に残る |
| 向き | まず公開したい・お試し | 継続的に育てるアプリ |
なお、本番DBへのスキーマ適用はどちらの方法でも必要。この章(ケース1)では、その適用とデプロイをまとめてエージェントに頼む。
3章で手元で動かすところまで済んでいれば、GitHub アカウントやリポジトリを用意しなくても、wrangler で直接デプロイして公開できる。最初の公開までの手数が少ないのが利点。
本番DBにマイグレーションを適用(migrations apply)してから、wrangler で Cloudflare に直接デプロイして「デプロイして」とだけ伝えると本番D1へのマイグレーション適用が抜けて、画面は出るのに投稿でDBエラーになることがある。「本番DBにマイグレーションを適用」まで含めると確実。
やっていることは2つ。①本番D1にスキーマ(マイグレーション)を適用する(初回とスキーマ変更時に必要)、②
wrangler.jsoncを読んで、src/index.jsの API とpublic/の静的ファイルをまとめて1つの Worker としてデプロイする(D1 binding(env.DB)も反映される)。初回はここで Worker が新しく作られる。
ターミナルでやる場合:
Terminal window npx wrangler d1 migrations apply my-bbs-db --remotenpx wrangler deploy(
my-bbsは自分のベース名に読み替え。wrangler.jsoncに名前が書いてあるので、何も聞かれずに通る)
初めてデプロイした直後の10秒ほどは、開いても
error code: 1042と出ることがある。新しく作った Worker が行き渡るまでの待ちなので、少し待ってから開き直す。
「デプロイして」とだけ伝えると本番D1へのマイグレーション適用が抜けて、画面は出るのに投稿でDBエラーになることがある。「本番DBにマイグレーションを適用」まで含めると確実。
やっていることは2つ。①本番D1にスキーマ(マイグレーション)を適用する(初回とスキーマ変更時に必要)、②
wrangler.jsoncのpages_build_output_dir(./public)を読んで Direct Upload でデプロイする(functions/の Pages Functions は自動でバンドルされ、D1 binding(env.DB)も反映される)。
ターミナルでやる場合:
Terminal window npx wrangler d1 migrations apply my-bbs-db --remotenpx wrangler pages deploy(
my-bbsは自分のベース名に読み替え。初回は Pages プロジェクト名やブランチを聞かれる)
デプロイ完了後、表示されたURL(Pages なら https://<ベース名>.pages.dev、Workers なら https://<ベース名>.<サブドメイン>.workers.dev)にアクセスして動作確認する。これでケース1の公開は完了。継続的な開発のために Git連携も使いたい場合は次章のケース2へ、そうでなければ「7. 公開したあとの運用」へ進む。
6. 【ケース2】GitHub に置いて Git連携で公開する
Section titled “6. 【ケース2】GitHub に置いて Git連携で公開する”GitHub にコードを置き、Cloudflare と Git連携すると、push するたびに自動でビルド・デプロイされる。継続的にアプリを育てるのに向く。この章では「① 初回push → ② 本番DBにスキーマを適用 → ③ Git連携を設定して初回デプロイ」の順に進める(すでにケース1で公開した人も、同じアプリを GitHub 経由で公開し直せる)。
GitHub から公開する方法には、Git連携のほかに GitHub Actions を使う方法もある(→ GitHub ActionsでCloudflareに公開する)。GitHub Actions の記事は D1 を扱っていないので、本番DBへのマイグレーションの適用は、この章の 6-2 と同じく手元から行う。
6-1. 初回push
Section titled “6-1. 初回push”ここまでに作ったコードを、GitHub のリポジトリにまとめて push する。Cloudflare で Git連携を設定するときに main ブランチを指定する必要があるため、先に GitHub 側にリポジトリと main ブランチを作っておく。
ghの認証がまだの場合はGit と GitHub の基本を参照。
GitHub の MCP プラグインはオフにしておく: Claudeデスクトップアプリの 設定 → カスタマイズ → プラグイン にある Github(GitHub 公式 MCP サーバ)をインストールしていると、Claude Code が
gh・ローカルの git ではなく GitHub API 経由で操作してしまい、手順どおりに進まないことがある。本ハンズオンはghに統一するので、入れている場合は無効化しておく(詳しくは GBA 4章 を参照)。
push前に .gitignore の設定。プロジェクトに作られる .wrangler/ フォルダ(ローカル状態のキャッシュ)はコミット不要なので、.gitignore に追加しておく。
.gitignore に .wrangler/ を追加して続けて、リポジトリを作成して push する。エージェントに次のように頼めば、git init からコミット・リポジトリ作成・push までまとめてやってくれる。
GitHubに非公開のリポジトリ <ベース名> を作って、今のフォルダの内容をpushして初期ブランチは main にしておくと、Cloudflare 側の Production branch 指定(main)と揃う(上のプロンプトならエージェントが main で作ってくれる)。
ターミナルでやる場合(→ GBA 4-5):
Terminal window git init -b maingit add -Agit commit -m "initial"gh repo create my-bbs --private --source=. --remote=origin --push
gh repo create --source=. --pushはローカルのコミットを GitHub の新規リポジトリに上げるコマンド。先にgit initでリポジトリ化し、コミットを1つ作ってから実行する(コミットが無いと push しても中身が上がらない)。git init -b mainで初期ブランチをmainにしておく(my-bbsは自分のベース名に読み替え)。
これで GitHub にコードと main ブランチが反映された。
6-2. 本番DBにスキーマを適用する
Section titled “6-2. 本番DBにスキーマを適用する”Git連携方式では migration が自動では適用されない。次の Save and Deploy で本番のアプリが動き出す前に、手元から本番DBにスキーマを反映しておく(適用しないと、画面は出るのに投稿でDBエラーになる)。エージェントに次のように頼む。
本番(リモート)のD1にマイグレーションを適用(migrations apply)して未適用のマイグレーションファイルだけが本番DBに適用される。
「マイグレーションを適用して」とだけ伝えるとローカルD1に適用されることがある。「本番(リモート)の」まで含めると確実。
このコマンドは
wrangler.jsoncを読むので、プロジェクトフォルダ(<ベース名>)内で実行する必要がある。エージェントなら最初からそのフォルダで動いている。
ターミナルでやる場合:
npx wrangler d1 migrations apply my-bbs-db --remoteを実行する(my-bbsは自分のベース名に読み替え)。
6-3. Git連携を設定して初回デプロイ
Section titled “6-3. Git連携を設定して初回デプロイ”リポジトリを Cloudflare に連携する。Cloudflare ダッシュボード を開き、左メニューの Compute → Workers & Pages をクリック、右上の Create application をクリック。
一覧の Continue with GitHub をクリック。初回は GitHub との連携承認を求められる。
Select a repository に自分の GitHub のリポジトリが並ぶので、自分のリポジトリ(<ベース名>)を選んで Next をクリック。

リポジトリを選んで Next(画面の zz-d1w-git は試したときの名前)
Set up your application のページが開く。
- Project name にはリポジトリ名(
<ベース名>)が最初から入っている。wrangler.jsoncのnameと同じでなければならないので、そのままにする(違うとビルドが失敗する) - Build command は空欄、Deploy command は
npx wrangler deployのまま。公開するフォルダや D1 の設定はwrangler.jsoncから読まれるので、画面で指定する欄は無い

Project name はリポジトリ名のまま、コマンドも既定のままでよい
ほかの項目(Advanced settings など)は触らなくてよい。Deploy をクリック。
ビルドのページに移り、Cloudflare が GitHub からコードを取得してデプロイする。手元で試したときは1分ほどで終わった。

緑のチェックが付けば完了。右上の Visit から公開ページを開ける
完了したら、右上の Visit(または https://<ベース名>.<サブドメイン>.workers.dev)を開いて動作確認する。
以降は push するたびに自動でデプロイされる(手元で試したときは、push から1分半ほどで公開ページに反映された)。
リポジトリを Cloudflare に連携する。Cloudflare ダッシュボード を開き、左メニューの Compute → Workers & Pages をクリック、右上の Create application をクリック。
一覧の下にある目立たないリンク Continue to Pages をクリック。
次の画面で Import an existing Git repository の Get started をクリック。初回は GitHub との連携承認を求められる。詳しい手順は CGT (Git連携) を参照(リポジトリ名は <ベース名> に読み替え)。
リポジトリ一覧から自分のリポジトリ(<ベース名>)を選び、Begin setup をクリック。
Set up builds and deployments のページが開く。設定するのは以下:
- Project name に自分のベース名(例:
my-bbs)を入れる。公開URLの一部になる(https://<ベース名>.pages.dev)
入力欄の直下に割り当てられるURLが表示される。
<ベース名>.pages.devのように入力した名前がそのままならば競合なし。競合する場合には区別するための文字列が付く。別の名前に変えてもよい。
- Production branch に
mainを選択 - Build output directory に
publicを入力:wrangler.jsoncのpages_build_output_dirと同じ場所
その他(Build command、Root directory など)は空欄のまま。functions/ 配下の Pages Functions と wrangler.jsonc の D1 binding は Cloudflare が自動で認識する。
Save and Deploy をクリック。Cloudflare が GitHub からコードを取得してビルド・デプロイを実行する。ダッシュボードの Deployments で進行状況を確認できる。
デプロイ完了後、表示されたURLにアクセスして動作確認する。
7. 公開したあとの運用
Section titled “7. 公開したあとの運用”公開したあとの手直しは、何を変えるかで本番への出し方が変わる。見た目の修正はデプロイだけで済み、データベースの構造の変更はマイグレーションとデプロイをセットで行い、データの管理はエージェントが本番DBを直接操作する。はじめの2つが、1-3 の2つの流れに当たる。
7-1. 見た目を修正する
Section titled “7-1. 見た目を修正する”例えば、投稿者ごとに投稿の背景色を変える。
ユーザーごとに投稿の背景色を変えてほしい途中、操作の許可を求めてくることがあるので対応する。
修正をローカルで確認したいときは、3章と同じく「ローカルのD1にマイグレーションを適用してから、ローカルサーバーを起動して」と頼む。
納得したら本番へ反映する。反映のしかたは選んだ公開方法による。
- ケース1(wrangler直接): 「wrangler で Cloudflare に再デプロイして」と頼む(Pages なら
npx wrangler pages deploy、Workers ならnpx wrangler deployを実行し直す) - ケース2(Git連携): 「コミットしてpushして」と頼む。Cloudflare が push を検知して自動デプロイする
しばらく待ってから公開URLにアクセスして確認。
修正例:投稿者(会員番号)ごとに投稿の背景色が変わった
7-2. データベースの構造を変える
Section titled “7-2. データベースの構造を変える”テーブルに列を足すような、スキーマの変更を伴う修正もできる。例えば、投稿者が名前を設定して投稿に表示できるようにする場合:
投稿者が名前を設定できるようにして、投稿に会員番号と一緒に名前も表示してほしいこのような修正では、テーブルに列を追加するための新しいmigrationファイル(0002_...)が追加される。この場合、コードのデプロイだけでは本番に反映されない。デプロイで反映されるのはコード(画面と API)だけで、本番DBのスキーマは変わらないため。スキーマ変更時は次の2つをセットで行う:
npx wrangler d1 migrations apply my-bbs-db --remoteを手元から実行して本番DBに反映する(どちらのケースでも共通)- コードを本番へ反映する(ケース1なら再デプロイ、ケース2なら「コミットしてpushして」)
7-3. データを管理する
Section titled “7-3. データを管理する”コードの修正だけでなく、本番DBのデータ操作もエージェントに頼める。不適切な投稿を消したいときは、管理画面を作らなくても次のように頼めばよい。
不適切な投稿があるので、◯◯の投稿を削除してエージェントが wrangler d1 execute(... --remote --command "DELETE FROM ...")で本番DBを直接操作してくれる。デモや個人運用なら、これで管理は十分なことが多い。わざわざ管理画面を作らなくても、手元のエージェントが管理コンソール代わりになる。
8. 次のステップ
Section titled “8. 次のステップ”DB付きの掲示板アプリが公開できた。投稿の削除程度ならエージェントで十分。ただし「自分以外が運営する」「スマホから手早く管理する」「複数人で管理する」となると、ブラウザから使える管理画面が欲しくなる。次のハンズオンで、認証付きの管理画面を追加する。管理画面を作るとログイン機能も作ることになるので、管理するのが自分ひとりのうちは、エージェントに頼む形で足りる(→ ログイン方式の選び方の1-1)。
- Claude CodeでWebアプリに管理画面を追加してCloudflare Accessでアクセス制限する:投稿の表示/非表示を切り替えられる管理画面を追加し、管理画面の部分だけに Cloudflare Access をかける
同じ流れで別のアプリを作ってみたいなら、次の記事へ。仕様を差し替えるだけで、診断アンケート・ゲームのランキング・当日の役割分担表を作る。
スマホとパソコンの両方から同じ会員番号で書き込みたくなったら、この下の補足へ。
補足:別の端末でも同じ会員番号を使う
Section titled “補足:別の端末でも同じ会員番号を使う”この掲示板の会員番号は「同じブラウザなら同じ番号」なので、スマホとパソコンでは別の会員になる。ここでは会員ごとにログインキー(UUID)を持たせ、そのキーを別の端末に入れれば同じ会員番号で書き込めるように改造する。
ログインキーの考え方(なぜヘッダで送るのか、なぜハッシュで保存するのか、キーを無くしたときの備え)は、Claude CodeでWebアプリのユーザーアカウント管理を始めるでゼロから作りながら説明している。ここでは、できあがった掲示板にあとから足す部分だけを扱う。あわせて、7-2 で触れた「スキーマ変更はデプロイだけでは反映されない」を、順番まで含めて一度通してみる。
改造後の例。自分のログインキーを表示・コピーでき、別の端末ではそのキーを入力する(画面の作りはエージェントによって変わる)
今の仕組みを確かめてから、ログインキーに移す
Section titled “今の仕組みを確かめてから、ログインキーに移す”本編の仕様は「同じブラウザから投稿した人には毎回同じ会員番号」としか言っていないので、ブラウザに何を覚えさせているかは作った人ごとに違う(Cookie のこともあれば localStorage のこともある)。そこで、エージェントに今の仕組みを確かめさせてから移してもらう。
この掲示板が「同じブラウザなら同じ会員番号」をどう実現しているか確認してから、別の端末でも同じ会員番号を使えるように、次の方式に移して。- 会員ごとの UUID をログインキーとして localStorage に保存する- API には、ログインキーを x-app-key ヘッダで送る- DB には生のキーを保存せず、SHA-256 のハッシュだけを持つ- いま生で入っているキーは、その人が次に来たときにハッシュへ置き換える- 既存の会員番号と投稿はそのまま残す- テーブルは作り直さず、列を足すだけにするDB を表計算のシートにたとえると、会員の表の右に「キーのハッシュ」の列を1つ足すだけの変更になる。会員番号の行も投稿もそのまま残る。前からの会員は、次に掲示板を開いたときに生のキーがハッシュに置き換わる(一度も来ない人の分は生のまま残る)。
最後の1行を外すと、エージェントがテーブルを作り直す形を選ぶことがある。手元で試したときは、2回のうち1回で作り直しのマイグレーションがエラーになり、エラーの文面からは原因が読めなかった。列を足すだけにして試し直したときは、2回とも通った。
migrations/ には新しいマイグレーションファイルが1つ増える(本編だけなら 0002_...、管理画面の記事で列を足した人は 0003_...)。
キーを表示・入力できるようにする
Section titled “キーを表示・入力できるようにする”ログインキーを別の端末に持ち運べるようにして。- 自分のログインキーを画面に表示して、コピーボタンを付ける- 表示するキーは localStorage から読み、サーバーには取りに行かない- 「このキーを無くすと、二度と同じ会員番号に戻れない」と明記する- 別の端末で使うために、ログインキーを入力する欄も用意するDB にはハッシュしか無いので、キーを無くすとサーバー側からも戻せない。だから注意を画面に出しておく。メールでキーを送る、専用リンクで別の端末に渡す、パスワードマネージャに保存させる、といった備えまで作り込むなら、ACCを参照。
もともと Cookie で会員番号を覚えていた場合、localStorage に移すと、iPhone・iPad のブラウザと Mac の Safari では、7日ほど開かないでいるとキーが消えることがある(→ ブラウザに保存したデータは消える)。たまにしか開かない掲示板なら、キーを控えておく必要が増える。
ローカルで確かめるときは、3章と同じく「ローカルのD1にマイグレーションを適用してから」起動してもらう。
本番に反映する:マイグレーションが先、デプロイがあと
Section titled “本番に反映する:マイグレーションが先、デプロイがあと”今回の改造は、コード(画面と API)の変更と、DB のスキーマ変更(列の追加)の両方を含む。1-3の2つの流れを、両方とも通すことになる。順番は、マイグレーションが先。
- 列を足すだけなので、先に足しても、いま本番で動いている古いアプリは新しい列を見ないまま動き続ける(手元で試したときは、マイグレーションを当てたあとも、古いコードのまま同じ会員番号で投稿できた)
- 逆に新しいアプリを先に出すと、まだ無い列を読みにいってエラーになる(手元で試したときは、投稿が
no such column: key_hashで失敗した)
本番DBにマイグレーションを適用してから、Cloudflare に再デプロイしてケース2(Git連携)なら、push した時点でデプロイが始まるので、「本番DBにマイグレーションを適用してから、コミットしてpushして」と頼む。
反映できたら、別の端末(またはシークレットウィンドウ)で開いて確かめる。最初は自分の会員番号とつながっておらず、自分のキーを入れると同じ会員番号で書き込めるようになる。前から使っていたブラウザでは、開き直しても会員番号が変わらない。
補足:部品を1つずつ作る
Section titled “補足:部品を1つずつ作る”3章では、データベースから画面までを一気に頼んだ。同じものを部品ごとに分けて頼むこともできる。一気に頼んで途中で止まり、どこが悪いのか分からないとき、作られる順番を1つずつ追いたいときに使う。できるものは3章と同じで、各部品の意味は4章にある。
順番は、データベース → スキーマとマイグレーション → wrangler.jsonc(D1 とアプリを結びつける設定)→ API(バックエンド)→ フロントエンド → 手元で動かす。
D1データベースを作る(初回のみ)
Section titled “D1データベースを作る(初回のみ)”D1データベース <D1データベース> を作って自分のアカウント内で過去に作った D1 データベースと同じ名前は使えない。「既に存在しています」エラーが出たら、ベース名を変えて作り直す。
実行すると database_id が表示される。同じセッションのまま進めれば、エージェントが覚えていて wrangler.jsonc に入れてくれる(分からなくなったら、表示された ID を伝える)。
ターミナルでやる場合:
npx wrangler d1 create my-bbs-dbを実行する(my-bbsは自分のベース名に読み替え)。
スキーマを設計して、マイグレーションファイルにする
Section titled “スキーマを設計して、マイグレーションファイルにする”AGENTS.md に書いた仕様のとおりに、このアプリに必要なデータベースのテーブル設計を提案してください。提案されたテーブル設計に疑問があれば、質問しながら確かめる。納得したら、ファイルにしてもらう。
このスキーマでマイグレーションファイルを作成してください。ファイルは migrations/0001_init.sql に保存してください。wrangler.jsonc を作る
Section titled “wrangler.jsonc を作る”このプロジェクト用の wrangler.jsonc を作って。Cloudflare Workers で、静的ファイルは public、API のコードは src/index.js。D1データベース <D1データベース> を binding 名 DB で使う。マイグレーションは migrations フォルダ。database_id は d1 create で表示された値を入れる。このプロジェクト用の wrangler.jsonc を作って。Cloudflare Pages プロジェクトで、公開ディレクトリは public。D1データベース <D1データベース> を binding 名 DB で使う。マイグレーションは migrations フォルダ。database_id は d1 create で表示された値を入れる。API を作る
Section titled “API を作る”AGENTS.md の仕様と、先ほど設計したスキーマを使って、Worker(src/index.js)で API を作って。/api/ 以外のリクエストは env.ASSETS.fetch で静的ファイルを返す。D1 の binding 名は DB。1つのファイルの中で、URL(/api/posts など)とメソッド(GET・POST)を見て処理を振り分ける。1件ごとの取得・更新・削除が要るアプリなら、/api/posts/3 のような URL から ID を切り出して処理する。
AGENTS.md の仕様と、先ほど設計したスキーマを使って、Pages Functions で API を作って。D1 の binding 名は DB。functions/api/<リソース名>.js ができる。1件ごとの取得・更新・削除が要るアプリなら、functions/api/<リソース名>/[id].js のような動的ルートで作る([id] は /api/posts/3 のような1件指定を受ける)。
フロントエンドを作る
Section titled “フロントエンドを作る”AGENTS.md の仕様と、これまでのDB定義・API定義を参考にフロントエンドを public/index.html として作成してください。デザインの好みがあれば追加で伝える。
シンプルで読みやすいデザインにしてください。スマートフォンでも使いやすいようにしてください。手元で動かす
Section titled “手元で動かす”本番DBではなくローカルのD1で動作確認したい。ローカルのD1にマイグレーションを適用(migrations apply)してから、ローカルサーバーを起動してターミナルでやる場合: まず
npx wrangler d1 migrations apply my-bbs-db --localでローカルD1にテーブルを作り、その後 Pages ならnpx wrangler pages dev、Workers ならnpx wrangler devを起動する(my-bbsは自分のベース名に読み替え)。
ここまでで3章と同じ状態になる。4章の見学に進む。
- プロジェクトに生成される
.wrangler/フォルダはローカル状態のキャッシュなのでコミット不要。.gitignoreに追加しておく - Git連携方式では migration が自動適用されない。スキーマ変更時は push 前に
wrangler d1 migrations apply --remoteを手元から実行する必要がある - migration の適用も Cloudflare 側で自動化したい場合は、Pages の Build command に
wrangler d1 migrations apply --remoteを仕込む手はある。ただし APIトークンを発行して Pages の環境変数に登録する必要があり、Git連携の手軽さは薄れる - Git連携は Cloudflare 側で build/deploy が実行されるため、無料枠を消費する。Pages は月500回、Workers(Workers Builds)は月3,000分。個人開発の通常運用で上限に届くことはほぼない
- Cloudflare は長期的に Pages の機能を Workers へ統合する方針を示しているが、2026年時点では強制移行の期限は発表されておらず、Pages は引き続き利用できる