コンテンツにスキップ

Claude Code と Astro でブログを作って Cloudflare で公開する

Astro(Wikipedia)は、ブログ・ドキュメント・マーケティングサイトなど コンテンツ中心のサイトを構築する Web フレームワーク。2026年1月に Cloudflare が買収したが、オープンソースのまま開発が続いている。

この記事では、Astro 公式の ブログテンプレート でブログを作り、Cloudflare Workers に公開する。プロンプトを順に Claude Code に渡していけば、ブログが公開され、記事を足して公開し直すところまで進む。

できあがるブログの例:https://my-astro-blog.ytolabo.workers.dev(この記事の手順で作り、続きの ASB の一部まで進めたもの)

記事は Markdown(.md)で書き、Astro がビルドで HTML に変換する。できあがるのは HTML の束なので、Cloudflare はそれを配るだけで済む(静的サイト)。Astro にはサーバー側で動く機能もあるが、ブログを書いて公開するだけなら要らない。管理画面から記事を書きたい場合は、Astro をもとにした CMS の EmDash が向いている。

応用編なので、Wranglerハンズオン を一通り体験している前提で進める(Node.js が入っていて、Wrangler で Cloudflare にログインできる状態)。

新しく作った作業フォルダ ~/claude/my-astro-blog を Claudeデスクトップアプリで開く。

フォルダ名は、そのまま公開URLの一部になる(→ 3章)。別の名前にしてもよい。以降 my-astro-blog と出てきたら自分のフォルダ名に読み替える。

何を作りたいかを伝える。

プロンプト
このフォルダに、Astro の公式ブログテンプレートでブログを作って。
パッケージマネージャは npm にして。

Claude Code は Astro の作成ツール(create-astro)の使い方を確かめてから実行する。コマンドを実行するたびに許可を求められるので、内容を見て 一度だけ許可 を押す。先頭のボタンが 常に許可 のときは、右の ∨ から 一度だけ許可 を選ぶ。

作成ツールはふつう質問に1つずつ答えていく対話形式だが、答えを引数で渡せば質問なしで進む。Claude Code はたとえば次のように実行する。

Terminal window
npm create astro@latest . -- --template blog --install --no-git --yes

. は「今のフォルダに作る」、--template blog はブログテンプレート、--yes は「残りの質問は既定値で答える」の意味。Git の初期化は、頼まなければしないことが多い(このあとの手順には要らない)。2026-10-15 に試したときは15秒ほどで終わった。

できあがったフォルダのうち、覚えておくのは2か所だけ。

  • src/content/blog/:記事の置き場所。サンプル記事が5本入っている
  • AGENTS.md:AI エージェント向けの説明書。開発サーバーの動かし方と、Astro 公式ドキュメントのどこを読めばよいかが書いてある(CLAUDE.md はこれへのリンク)

作り終えたら、同じフォルダで Claude Code のセッションを新しく開き直す。AGENTS.md はセッションを始めるときに読み込まれるため。

ターミナルで作る場合:自分のターミナルで cd ~/claude してから npm create astro@latest my-astro-blog を実行すると、質問に1つずつ答える形で作れる。テンプレートを聞かれたら Use blog template を選び、依存関係のインストールと Git の初期化は Yes と答える。

開発サーバーを起動して、プレビューで確認する。

プロンプト
開発サーバーを起動して

Claudeにastro-devの開始を許可しますか? と聞かれるので、一度だけ許可 を押す。起動の設定ファイル(.claude/launch.json)が作られ、会話の中にブログのトップページのプレビューが表示される。いつものブラウザで見たいときは、プレビューの下の ブラウザで開く から http://localhost:4321 を開く。

開発サーバーを起動すると、会話の中に Astro ブログテンプレートのトップページのプレビューが表示される

会話の中に、ブログテンプレートのトップページのプレビューが表示される

開発サーバーは動き続け、ファイルを書き換えると、保存しただけでプレビューに反映される。止めたくなったら「開発サーバーを止めて」と頼む。画面右上のボタンで開く セッションレール の サーバー 欄にも動いている開発サーバーが出ていて、行の右端の □(このサーバーを停止する)でも止められる。

このまま公開してしまう。

プロンプト
このブログを Cloudflare Workers に公開して。
サーバー側の機能は使わない静的サイトなので、アダプタは入れずに、
ビルドした dist フォルダをそのまま配信する設定にして。

Claude Code は、Cloudflare 向けの設定ファイル wrangler.jsonc を作り、npm run build でビルドしてから npx wrangler deploy でデプロイする。実行してよいか聞かれるので、それぞれ 一度だけ許可 を選ぶ。

Claude Code は本番の前に試しに流してみて(ドライラン)、「この内容で公開してよいですか?」と確かめてくることがある。そのときは 公開する を押す。

デプロイが終わると公開URL(https://my-astro-blog.<アカウントのサブドメイン>.workers.dev)が表示されるので、ブラウザで開く。手元で見たのと同じブログが出れば公開できている。URL の先頭(Worker の名前)には、フォルダ名がそのまま使われる。

Wrangler でログインしていないと、デプロイの前で止まる。そのときは自分のターミナルで npx wrangler login を打ってログインし、もう一度頼む(→ Wranglerハンズオンの 1-2)。

できる wrangler.jsonc は、たとえば次のようなもの。Worker の名前と、ビルドしてできた dist/ フォルダを配信することしか書いていない。

{
"$schema": "node_modules/wrangler/config-schema.json",
"name": "my-astro-blog",
"compatibility_date": "2026-10-15",
"assets": {
"directory": "./dist",
"not_found_handling": "404-page"
}
}

not_found_handling は、存在しない URL を開かれたときに 404.html を返す設定。テンプレートには 404.html が無いので、今は Cloudflare 既定の 404 が出る。

Wrangler をこのプロジェクトに入れる(package.json に1行増える)こともある。

プロンプトの「アダプタは入れずに」は、この形にするための一言。設定ファイルが無いまま Wrangler でデプロイすると、Wrangler が Astro のプロジェクトだと判断して自動で設定を作り、アダプタ(ページをサーバー側で組み立てるための部品)まで入れる。2026-10-15 に試したときは、アダプタのほかに KV(データの保存場所)などの設定も加わり、astro.config.mjs や package.json を含む7つのファイルが変わった。記事を表示するだけのブログには要らないもの。

ここからは、書いて、公開し直すの繰り返し。まず、サンプルのままの文言を自分用に置き換える。

プロンプト
サイト全体のサンプル文言を自分用に書き換えて。
- サイト名: 「日々のメモ」
- サイトの説明: 「日々の生活について気が向いたら書きます」
- 著者名: 「匿名ペンギン」
細かい調整はやらないで、デフォルトを置き換えるだけでOK。

続けて、記事を足す。タイトルと中身の方向だけ伝えれば、本文と、記事の先頭に置く情報(フロントマター:タイトル・説明・日付など)は Claude Code が組み立てる。

プロンプト
新しい記事を1本追加して。
タイトルは「時の流れ」、内容は昔買った腕時計(最近こわれた)について簡潔に書いて。
見出しの画像は、サンプル記事と同じプレースホルダ画像のどれかでいい。

ファイルの書き換えも、書き込むコマンドとして許可を求められることがある。記事の本文がそのままダイアログに出るので、目を通してから許可する。

開発サーバーのプレビューで、トップページの文言が変わり、Blog 一覧(トップのナビバー → Blog)に記事が増えていることを確かめる。

サイト名が「日々のメモ」になり、Blog 一覧の先頭に画像つきで「時の流れ」が出ている

サイト名が変わり、Blog 一覧の先頭に追加した記事が出る

よければ公開し直す。

プロンプト
ビルドして Cloudflare に公開し直して

公開URLを開き直して、同じ変更が出ていれば完了。以降は「記事を書いて」「公開し直して」の2つを繰り返すだけで、ブログを更新していける。

誤字の修正くらいなら、自分で直接書き換えてもよい。Claudeデスクトップアプリの右上のフォルダのアイコン(ファイル、→ CDG 5-5)を押し、src → content → blog の順に開き、記事の .md をクリック。右上の </>(ソースを表示)で編集モードに切り替えて書き換え、保存 を押す。そのあと「公開し直して」と頼む。

変更の記録(Git のコミット)は公開とは別。区切りのいいところで「変更をコミットして」と頼んでおくと、あとで前の状態に戻せる。GitHub に push するだけで自動で公開されるようにしたい場合は、Cloudflare の Git 連携を使う(→ CGT(Git連携))。

ここまでで、ブログを公開し、プロンプトで記事を足して公開し直せる状態になった。次は雛形を自分のブログとして使い込むためのカスタマイズに進む。