Claude Code と Astro で作ったブログを運営していく
AST(Claude Code と Astro でブログを作って Cloudflare で公開する)で作ったブログを、自分のブログとして使えるところまで育てる。サイト情報・記事の書き方・SEO・デザインの変更を順に扱う。
1. はじめに
Section titled “1. はじめに”AST で my-astro-blog を作り、Cloudflare Workers に公開済みの状態から始める。本記事ではそのテンプレートを「自分のブログ」に育てるためのトピックを扱う。
扱うこと:
- サイト情報(サイト名・About・ヘッダーとフッター・日本語向けの設定)のカスタマイズ
- 記事の書き方(フロントマター、下書き、画像)
- SEO 系(OGP、sitemap、RSS)
- デザインの変更(別のテンプレートやテーマへの引っ越し)
- 規模感の目安・ページネーション・アクセス解析
ハンズオンは AST と同じく Claudeデスクトップアプリ(→ CDG)の Claude Code で進める。進め方も AST と同じで、プロンプトで直してもらい、開発サーバーの画面(Claudeデスクトップアプリのプレビュー、またはブラウザで開いた http://localhost:4321)で確かめ、よければ「ビルドして Cloudflare に公開し直して」と頼む。各節では最後の公開し直しを省略する。
2. 全体像(ファイル構造の再確認)
Section titled “2. 全体像(ファイル構造の再確認)”Astro のブログテンプレートが生成する主なフォルダ・ファイル:
my-astro-blog/├── astro.config.mjs ← サイト設定(サイトURL、sitemap、フォントなど)├── wrangler.jsonc ← Cloudflare 向けの設定(AST の 3章で作ったもの)├── public/ ← 配信時にそのままコピーされる静的アセット│ └── favicon.svg└── src/ ├── consts.ts ← SITE_TITLE / SITE_DESCRIPTION の定数 ├── content.config.ts ← 記事のフロントマターの定義 ├── content/blog/ ← .md / .mdx 記事 ├── assets/ ← 記事で使う画像(ビルド時に最適化される) ├── pages/ ← ルーティング(index.astro, about.astro, blog/...) ├── layouts/ ← ページレイアウト(BlogPost.astro) ├── components/ ← Header, Footer, BaseHead など └── styles/ ← CSS(global.css)ポイント:
src/consts.ts:サイト名・説明の定数。複数のページから参照されるsrc/content/blog/:記事置き場。各.mdの中身がそのまま個別ページになるsrc/pages/:URL ルーティング。pages/index.astroがトップ、pages/blog/[...slug].astroが個別記事src/layouts/:ページのレイアウト(共通の見出し・本文枠など)astro.config.mjs:Astro 自体の設定。site(公開URL)や sitemap など
3. サイト情報をきちんと書き換える
Section titled “3. サイト情報をきちんと書き換える”ブログの「顔」となる部分(サイト名・サイト説明・About・ヘッダーとフッター)を自分のものに整える。デフォルトのままだと「テンプレを使っただけのサイト」に見えてしまうので、ここを差し替えると、自分のブログらしい見た目になる。
AST の 4章で雑に書き換えたサイト情報を、より整った形に直していく。
3-1. サイト名・説明
Section titled “3-1. サイト名・説明”サイト名と説明は src/consts.ts に定数として置かれていて、各ページはそこから読んでいる。AST で書き換えていれば済んでいるはずなので、取りこぼしがないかを確かめてもらう。
サイト名を「日々のメモ」、サイトの説明を「日々の生活について気が向いたら書きます」にそろえて。サイト名と説明に、テンプレートのサンプル文言(Astro Blog など)が残っていないかも確かめて。About ページとヘッダー・フッターはこのあと直すので、今は触らないで。範囲を区切らずに「サンプル文言を全部探して」と頼むと、About ページや SNS のリンクまで一度に手を入れ、SNS のリンクは差し替えずに消してしまうことがある(2026-10-15 に試したとき)。サンプル記事5本を消すかどうかを聞かれることもあるが、4章で記事の書き方を見比べるのに使うので、今は残しておく。
3-2. About ページ
Section titled “3-2. About ページ”src/pages/about.astro がデフォルトでサンプル文章(Lorem ipsum)になっている。自己紹介に書き換える。
About ページを自己紹介に書き換えて。レイアウトはそのままで、中の文章だけ差し替えればいい。====著者: 匿名ペンギン自己紹介: 日々の生活と読んだ本について書いています連絡先: GitHub (@yourname)、X (@yourname)yourname は自分のアカウント名に置き換えて渡す。そのままだと、Claude Code は仮の名前かどうか判断できず、リンクにしないで文字だけで載せる。
3-3. ヘッダーとフッター
Section titled “3-3. ヘッダーとフッター”ヘッダー(src/components/Header.astro)とフッター(src/components/Footer.astro)の両方に、Astro 公式の SNS(Mastodon・Twitter(現 X)・GitHub)へのリンクが入っている。フッターのコピーライトも「Your name here」のまま。
ヘッダーとフッターにある Astro 公式の SNS リンクを、自分のアカウントに差し替えて。使わない SNS のリンクは消して。フッターのコピーライトは匿名ペンギンにして。====GitHub: https://github.com/yournameX: https://x.com/yournameヘッダーのナビゲーションは Home / Blog / About の3つ。項目を増やしたり減らしたりしたいときも、同じように頼めばよい。
3-4. 日本語のブログにする
Section titled “3-4. 日本語のブログにする”テンプレートは英語のサイト向けに作られていて、ページの言語の指定が英語(lang="en")、日付の表示が英語式(Jul 08, 2022)になっている。日本語で書くなら直しておく。言語の指定は、ブラウザの読み上げや翻訳の提案、検索エンジンが参考にする。
日本語のブログにしたい。ページの言語の指定を日本語にして、日付の表示も日本語の書き方(2026年10月15日)にして。4. 記事の書き方
Section titled “4. 記事の書き方”記事は src/content/blog/ に .md(または .mdx)として置く。Astro はこのフォルダを「ブログ記事のコンテンツコレクション」として認識し、各ファイルから個別ページ(/blog/<ファイル名>/)を1つずつビルドする。
ファイル先頭にフロントマター(YAML 形式のメタデータ)を書いて、その後ろに本文(Markdown)を続ける形が基本。
4-1. フロントマターの基本項目
Section titled “4-1. フロントマターの基本項目”サンプル記事のフロントマター(先頭の --- で囲まれた部分)の例:
---title: 'First post'description: 'Lorem ipsum dolor sit amet'pubDate: 'Jul 08 2022'heroImage: '../../assets/blog-placeholder-3.jpg'---主な項目:
title:記事のタイトル(必須)description:一覧ページと検索エンジン向けの説明(必須)pubDate:公開日。記事一覧はこの新しい順に並ぶ(必須)heroImage:記事の先頭に表示される画像(任意)updatedDate:更新日(任意)
必須項目とそうでないものの定義は
src/content.config.tsに書かれている。必須の項目が欠けた記事があると、ビルドがエラーで止まる。Claude Code に記事を書いてもらうときは揃えてくれるが、自分で.mdを書くときは気をつける。
4-2. 下書き機能(draft: true)
Section titled “4-2. 下書き機能(draft: true)”書きかけの記事を「手元では見えるけど公開はされない」状態にしたい。フロントマターに draft: true を入れる運用にする。
これは Astro 公式の機能ではなく、Jekyll や Hugo 時代から続くコミュニティの慣習。Astro 公式ドキュメント(Filtering collection queries)でもカスタマイズ例として紹介されているが、組み込み機能ではない。
draftの名前も自由で、published: falseなどでもよい。
Astro のブログテンプレートはデフォルトで draft を扱わないので、仕組みを作ってもらう。
書きかけの記事を下書きにできるようにしたい。記事の先頭に draft: true と書いた記事は、手元の開発サーバーでは見えて、公開するときのビルドには含まれないようにして。記事一覧・個別ページ・RSS のどれにも出ないようにして。Claude Code は、仕組みを作ったあと、下書きのテスト記事を一時的に作ってビルドし、外れることを確かめてから消すことが多い。自分の記事でも試すなら、続けて頼む。
「時の流れ」の記事を下書きにして、ビルドしたときに出ないことを確かめて開発サーバーの Blog 一覧には出たままで、ビルドしたページ数が1つ減っていれば効いている。公開するときは、記事の先頭の draft: true の行を消す(「『時の流れ』の下書きを外して」と頼んでもよい)。
4-3. 画像の使い方
Section titled “4-3. 画像の使い方”Astro では画像の置き場が2種類ある:
src/assets/:ビルド時に最適化される(軽い形式への変換、サイズの調整)。記事のheroImageや本文中の画像はこちらが推奨public/:そのままコピーされる(最適化なし)。favicon など、URL を変えたくないものはこちら
記事に画像を入れるときは、画像のファイルを渡して頼めばよい。
~/Downloads/coffee.jpg を「時の流れ」の記事のトップ画像にして。画像は src/assets/ に置いて。Blog 一覧でも、記事のトップ画像が使われる
src/assets/ に置いた画像は、表示する大きさに縮められ、軽い WebP 形式に変換される。2026-10-15 に試したときは、2256×1504 の JPEG が 1020×510 の WebP になり、写真に入っていた撮影情報(カメラの機種や撮影日などの EXIF)も変換後の画像には残っていなかった。public/ に置いた画像はそのまま配信されるので、撮影情報も残る。
ただし、元の画像ファイルをそのまま指すところがあると、src/assets/ の画像でも元の画像が公開される。5-2 の SNS 用の画像がそれにあたるので、そこで手当てする。
記事の .md には、src/content/blog/ から見た相対パスで書かれる。
---heroImage: '../../assets/coffee.jpg'---本文中の画像も同じ書き方:
5. SEO 系
Section titled “5. SEO 系”書いた記事を読んでもらうための「外向きの整え方」をまとめる。検索エンジンに見つけてもらう仕組み(sitemap)、SNS でシェアされたときに見栄えよく表示される仕組み(OGP / X のカード)、RSS リーダーで購読してもらう仕組み(RSS フィード)。
どれも Astro のブログテンプレートに最初から組み込まれている。いずれもサイトの公開URLを起点にするので、まず astro.config.mjs の site を揃えるところから始める。
5-1. サイトの URL を設定する
Section titled “5-1. サイトの URL を設定する”astro.config.mjs の site は、テンプレートのままだと https://example.com になっている。このままだと、sitemap・RSS・OGP に出る URL が example.com になる。自分の公開URLに揃えておく。
このサイトの公開URLは https://my-astro-blog.<アカウントのサブドメイン>.workers.dev です。サイトの URL として設定して。URL は AST の3章で公開したときに表示されたものに置き換える。独自ドメインに移したら、ここもそのドメインに直す。
5-2. OGP / X のカード
Section titled “5-2. OGP / X のカード”src/components/BaseHead.astro に OGP(og:title og:description og:image など)と、X(旧 Twitter)でのカード表示用のメタタグが入っている。X のメタタグは、名前が今も twitter:card のように twitter: で始まる。記事ページでは、記事の title と description が使われる。
シェア用の画像は、テンプレートのままだとどのページもサンプル画像(blog-placeholder-1.jpg)になり、記事のトップ画像は使われない。自分の画像に差し替え、記事ではトップ画像を使うようにする。
SNS でシェアされたときの画像を ~/Downloads/og-default.jpg にして。記事ページでは、その記事のトップ画像があればそれを使って。SNS 用の画像も記事の画像と同じように縮小・変換したものを使って、写真の撮影情報が公開されないようにして。最後の1行が無いと、SNS 用の画像には元の画像ファイルがそのまま使われる。2026-10-15 に試したときは、1.8MB の元の写真が、カメラの機種と撮影日の入ったまま公開された。3行まとめて頼むと、1200×630 の JPEG(88KB)に変換したものが使われ、撮影情報も元の写真も公開されなくなった。
5-3. sitemap.xml
Section titled “5-3. sitemap.xml”@astrojs/sitemap が組み込み済み。5-1 で site を設定していれば、ビルドのたびに dist/sitemap-index.xml と dist/sitemap-0.xml が作られる。
確認:公開し直したあとに https://my-astro-blog.<アカウントのサブドメイン>.workers.dev/sitemap-index.xml を開く。
5-4. RSS フィード
Section titled “5-4. RSS フィード”src/pages/rss.xml.js がテンプレートに入っていて、/rss.xml で配信される。RSS リーダー(Feedly など)に登録してもらうと、公開し直すたびに新着が届く。
5-1 で site を設定すれば、RSS の各記事 URL も自分のサイトのものになる。
6. ブログのデザインを変える
Section titled “6. ブログのデザインを変える”AST では Astro 公式の blog template を使ったが、Astro には他にも公式テンプレが何種類かあり、コミュニティ製テーマも多数公開されている。書きためてきたブログのデザインを丸ごと差し替えたいときに使い分けられる。
Astro のテーマ切り替えは WordPress のような「管理画面で1クリック」ほど気軽ではない。テンプレートやテーマはプロジェクト一式なので、テーマを変えるときは「新しいプロジェクトを作って、書きためた記事を移す」作業になる。逆に言えば、テーマがコード全部を含むので、必要なら手元で気が済むまで自由に手を入れられる。
6-1. 公式 CLI で選べるテンプレ一覧
Section titled “6-1. 公式 CLI で選べるテンプレ一覧”npm create astro@latest 実行時の How would you like to start your new project? で選べる公式テンプレ(2026年10月時点):
| 選択肢(CLI 表示) | 用途 | プレビュー |
|---|---|---|
| A basic, helpful starter project (recommended) | 基本のスターター | astro.new |
| Use blog template | ブログ(AST で使ったもの) | astro.new |
| Use docs (Starlight) template | ドキュメントサイト(本サイト Vibecoding Notes もこのテンプレ) | astro.new / Starlight 公式 |
| Use minimal (empty) template | 空のプロジェクト(ゼロから組む) | astro.new |
各テンプレの見た目はハブの astro.new からブラウザ上でそのまま触れる(StackBlitz / CodeSandbox 経由)。
6-2. Astro Themes ギャラリーで探す
Section titled “6-2. Astro Themes ギャラリーで探す”Astro Themes ギャラリー には公式・コミュニティ製のテーマが多数並んでいる。ブログ向けでも「ミニマル」「マガジン風」「画像中心」「タイポグラフィ重視」など方向性で選べる。
各テーマのページには、そのテーマを雛形にしてプロジェクトを作るコマンドが載っている。AST と同じように、新しい作業フォルダを開いてテーマのページの URL を渡せば、Claude Code が作ってくれる。
このフォルダに、Astro のテーマ https://astro.build/themes/details/<テーマ名>/ でブログを作って。パッケージマネージャは npm にして。2026-10-15 に AstroPaper で試したときは、テーマのページから元のリポジトリを見つけて作り、テーマに入っていた pnpm(別のパッケージマネージャ)用のファイルも npm に合わせて片づけた。
AstroPaper で作ったブログ(右上のボタンでダークモードに切り替えたところ)
元のブログの開発サーバーが動いたままだと、新しいほうは別のポート番号(http://localhost:4322 など)で起動する。どちらのサイトを見ているかは、アドレスの番号で見分ける。
6-3. 既存ブログから新テーマへ移行する流れ
Section titled “6-3. 既存ブログから新テーマへ移行する流れ”書きためた記事を新テーマに移すのは、ファイル単位のコピー作業に近い。6-2 で作った新しいフォルダのまま、Claude Code に頼む。
引っ越しの作業は新しいフォルダで進めるので、公開するまで元のブログには影響しない。うまくいかなければ、元のフォルダで公開し直せば元のデザインに戻る。
~/claude/my-astro-blog にある記事と画像を、このプロジェクトに移して。フロントマターの違いはこのテーマに合わせて直して。サイトの URL や favicon など、記事以外に引き継ぐべきものがあれば教えて。テーマによって、フロントマターの項目の名前や必須の項目が違う。2026-10-15 に AstroPaper で試したときは、Claude Code が両方の定義を読み比べて、日付の項目名(pubDate → pubDatetime)などを書き換えた。
AstroPaper には記事の上に大きな画像を出す仕組みが無いので、トップ画像(heroImage)はシェア用の画像(ogImage)に振り替えられ、記事のページには表示されなくなった。記事の中に写真を出したいときは「コーヒーの写真を本文の先頭に入れて」のように頼む。
テンプレートのサンプル記事は移さず、自分で書いた記事だけを移した。記事以外は、引き継ぐかどうか決めてほしいものとして一覧で返ってきた(サイト名・説明、サイトの URL、言語とタイムゾーン、著者名と SNS リンク、favicon、シェア用の画像、Web Analytics、wrangler.jsonc など)。引き継ぐものを指定して、もう一度頼む。
サイト名・説明・著者名・SNS リンク・サイトの URL・言語とタイムゾーン(日本語・日本時間)・OG 画像・Web Analytics・wrangler.jsonc を引き継いで。SNS 用の画像は、写真の撮影情報が公開されないようにして。AstroPaper に移した記事。写真は頼んで本文の先頭に入れた
最後の1行は 5-2 と同じ理由で入れている。AstroPaper ではシェア用の画像(ogImage)が元のファイルのまま公開されるため、Claude Code は写真そのものから撮影情報を消した。
記事の URL が変わることがある。元のブログテンプレートでは
/blog/passage-of-time/だった記事が、AstroPaper では/posts/passage-of-time/になった。古い URL は開けなくなるので、SNS に貼ったリンクや検索結果から来た人は迷子になる。公開する前に、URL を元のまま保つように頼んでおく。プロンプト 元のブログの記事の URL(/blog/記事名/)のまま開けるようにしたい。このテーマで /blog/ に変えられるならそうして、難しければ古い URL から新しい URL へ転送して。2026-10-15 に試したときは、AstroPaper でも
/blog/に変えられたので、転送は使わずに記事のページと一覧、ヘッダーのリンクやサイトマップまで/blog/にそろえた。
開発サーバーで確かめて、よければ公開する。
ビルドして Cloudflare に公開してwrangler.jsonc を引き継いでいれば Worker の名前が同じなので、同じ URL のまま中身が新しいデザインに入れ替わる。2026-10-15 に試したときは、Claude Code が公開の前に「今のブログが上書きされる」「テーマのサンプル記事も公開される」と知らせて、どう公開するかを選ばせた(そのまま置き換える/サンプル記事を消してから置き換える/別の名前で公開する)。サンプル記事を消してから置き換える を選ぶと、サンプル記事を消し、About ページも元のブログの文章に差し替えてから公開した。
トップページの「Mingalaba」とテーマの紹介文や、「Go back」「Share this post」のようなテーマ側の英語の文言は残る。気になるところから「トップページの文章を自分用にして」「日本語にして」と頼んでいけばよい。
7. その他
Section titled “7. その他”記事が増えてきたときの規模感の目安・ページネーション・アクセス解析を扱う。
7-1. 規模感の目安
Section titled “7-1. 規模感の目安”書き続けて記事数が増えてきたとき、Astro と Cloudflare Workers の構成がどこまで耐えるかをざっくりつかんでおく。ビルドは手元の Mac でするので、Cloudflare 側のビルド時間の上限は関係ない。気にするのは、1回に公開できるファイルの数。
- 〜100記事:ビルドは数十秒(目安)。特に対処は要らない
- 〜1000記事:一覧ページに全部並べると重いので、ページネーション(→ 7-2)を入れる
- 数千記事〜:ビルドに数分(目安)かかるようになる。画像の最適化が重くなるので、
src/assets/で最適化する画像を絞る、public/に置く運用も併用する - ファイル数の上限:Workers の無料プランでは、1回に公開できるファイルは20,000個まで(Workers Paid は100,000個)。記事1本で HTML が1つ、画像は最適化でサイズ違いが増える。1ファイルは 25 MiB まで
数千記事までは、特に手を打たなくてよい。大きく育ってきて気になったら、ページネーションを入れる、画像の置き場を整理する、という順で対処していけばよい。
静的なファイル(ビルドしてできた HTML や画像)へのアクセスは、Workers では無料で回数の制限もない(公式ドキュメント)。
7-2. ページネーションを入れる
Section titled “7-2. ページネーションを入れる”Astro はページネーションをファイルベースで実装できる。一覧ページのファイル名を [...page].astro のようにすると、ビルド時に /blog/, /blog/2/, /blog/3/ のような URL が自動生成される。
ブログの記事一覧を10件ずつのページに分けて。1ページ目は /blog/、2ページ目以降は /blog/2/, /blog/3/ という URL にして、ページ下部に前後のページへのリンクも置いて。記事が10本に満たないうちは1ページだけなので、ページ送りは出ない。Claude Code は件数を一時的に減らしてビルドし、ページが分かれることを確かめてから戻すことが多い。自分の目でも見たいときは「試しに3件ずつにして」と頼み、開発サーバーで /blog/ と /blog/2/ を開いて見る。見終わったら「10件ずつに戻して」と頼む。
3件ずつにしたときの2ページ目。下に前のページへのリンクとページ番号が出る
ページネーションは標準では未設定なので、記事が増えてきたタイミングで入れればよい。
7-3. アクセス解析
Section titled “7-3. アクセス解析”Cloudflare には無料のアクセス解析(Web Analytics)がある。訪問者数・ページビュー・どこから来たか(referrer)などが見られ、Cookie を使わない。
workers.dev のアドレスは Cloudflare で管理している自分のドメインではないので、自動で計測を入れる設定は使えない。ページに計測用のスクリプト(JS スニペット)を入れる方式になる。
- Cloudflare ダッシュボードの左のメニューで Observability → Analytics → Web analytics を開き、Add a site を押す
- Set up hostname に公開URLのホスト名(
my-astro-blog.<アカウントのサブドメイン>.workers.dev)を入れる。下に出る「Click here to use ”…” which does not belong to Cloudflare websites」を選ぶと、「You will need to install a JS Snippet on the website.」と出るので、Done を押す - Manage site の画面の Install JS Snippet に出るスニペットをクリックしてコピーする
- Claude Code に渡して、全ページに入れてもらう
Cloudflare Web Analytics の計測用スニペットを全ページに入れて。各ページの body の閉じタグの直前に置いて。====(ここにコピーしたスニペットを貼る)公開し直してしばらくすると、Web Analytics の一覧にページビューが出はじめる。2026-10-15 に試したときは、スニペットを入れて公開し直してから数字が出るまで10分ほどかかった。
workers.dev のアドレスでも、スニペットを入れればページビューが計測される




