Knowledge
Claude Code と Eleventy で、JSなしの静的サイトを作って育てる
静的サイトジェネレーター Eleventy とは何かを押さえたうえで、Claude Code に日本語で指示を出して読書メモサイトを作り、見た目の調整、更新手順の CLAUDE.md 化、記事の追加まで実際に試しました。
Claude Code に日本語で指示を出すだけで、Eleventy という静的サイトジェネレーターを使ったサイトを作り、運用できる状態にするまでを試しました。題材は、架空の個人サイト「読書メモ」です。
最初の指示から、見た目の調整、更新手順の書き出し、記事の追加まで、実際に出した指示と Claude Code の動きをそのまま載せます。
こんな場面で役立つ
- 個人のブログやメモのサイトを作りたいが、WordPress のような CMS は大げさだと感じている。HTML ファイルを1つ足すだけでページが増える構成を、数分で用意できます。
- SEO を気にしているので、JavaScript で画面を組み立てるサイトにはしたくない。ビルドしたときに完成済みの HTML ができるので、検索エンジンにそのまま読ませられます。
- デザインの微調整を、CSS を読まずに言葉で頼みたい。「どこからどこまでが1冊分か分かりにくい」と伝えるだけで直してもらえます。
- 記事の追加を、あとで AI に任せたい。手順を CLAUDE.md に書かせておくと、次からは「メモを追加して」の一言で、同じ手順で進みます。
前提・検証環境
- 確認日:2026年11月14日
- Claude Code 2.1.322(非対話モード
claude -pで指示を出した) - Eleventy 3.1.8、テンプレートは Nunjucks
- Node.js 23.9.0 / macOS
Eleventy とは
Eleventy(イレブンティ、11ty とも書く)は、静的サイトジェネレーターの1つです。公式サイトでは「Eleventy is a simpler static site generator.」(よりシンプルな静的サイトジェネレーター)と紹介されています(Eleventy 公式サイト)。
静的サイトジェネレーターは、部品に分けて書いたファイルを、公開用の完成した HTML にまとめて変換する道具です。ほかのサイトの作り方と比べると、違いが分かりやすくなります。
| 作り方 | ページができるタイミング | 特徴 |
|---|---|---|
| HTML を手で書く | 書いたとき | ヘッダーやフッターを全ページにコピーするので、直すときは全ファイルを直すことになる |
| WordPress などの CMS | 閲覧されるたびにサーバーで組み立てる | 管理画面から書けるが、サーバーとデータベースの運用が必要 |
| JavaScript で画面を作る(SPA など) | ブラウザで JavaScript が動いたとき | 動きのある画面に向くが、検索エンジンへの見え方に気をつける必要がある |
| 静的サイトジェネレーター | 公開する前のビルドのとき | 共通部品は1か所で管理でき、出来上がるのはただの HTML。置くだけで公開できる |
Eleventy の場合、ヘッダー・フッターなどの共通部分はレイアウトに書きます。公式ドキュメントでは「ほかのコンテンツを包むための特別なテンプレート」と説明されています(Layouts)。各ページの先頭に使うレイアウトを書いておくと、ビルド時に本文がレイアウトに差し込まれます。
- 書ける形式:HTML、Markdown のほか、Nunjucks・Liquid・EJS などのテンプレート言語に対応しています。
- 必要なもの:Node.js 18 以上(Eleventy 3.1.8 のドキュメントによる)。
- 名前の変更:Eleventy は2024年9月に Font Awesome に加わり、2026年3月3日には「Build Awesome」への改名が発表されました。オープンソースのまま続き、既存のプラグインとの互換性も保つとしています。次の v4 は「Build Awesome v4」になる予定です(公式ブログ)。2026年11月14日時点の安定版は、npm の
@11ty/eleventy3.1.8 です。
手順
1. 最初の指示は「作りたいもの」と「縛り」を書く
空のディレクトリで git init だけしておき、Claude Code に次の指示を出しました。
読書メモを公開する個人サイトを作りたい。
・トップページと、本ごとのメモページ(メモは量産するのでディレクトリを分ける)
・ヘッダー・フッターは共通化する
・CSS は1ファイルにまとめ、インラインで書かない
・CMS は使わず、ページは HTML ファイルを足して増やす
・ブラウザ側の JavaScript は使わない。SEO に強いサイトにしたい
・静的サイトジェネレーターの Eleventy を使い、npm run build で _site/ に出力されるようにする
・落ち着いた、紙の本のようなデザイン
・サンプルのメモページを2つ作る
ポイントは、見た目の好みだけでなく「やらないこと」(インラインの CSS は書かない、JavaScript は使わない)も最初に書くことです。特に「SEO に強くしたい」「JavaScript を使わない」は、サイトの作り方そのものを決める条件です。途中で言うと作り直しになるので、デザインより先に伝えます。
Claude Code は約3分で作業を終えました。Eleventy のインストール、レイアウトや部品の作成、サンプルのメモ2本、ビルドの確認、ブラウザでの見た目の確認までを自分で進めています。報告にあった構成は次のとおりです。
実行結果(Claude Code の報告から抜粋)
src/
├─ _data/site.json サイト名・説明・公開URL
├─ _includes/
│ ├─ layouts/base.njk 全ページ共通の <head> と SEO 用タグ
│ ├─ layouts/note.njk メモページのレイアウト
│ └─ partials/header.njk, footer.njk 共通ヘッダー・フッター
├─ css/style.css CSS はこの1ファイルだけ
├─ index.html トップページ(メモ一覧を新しい順に自動表示)
├─ notes/
│ ├─ notes.json notes/ 内のページ全部にレイアウトなどを一括で設定
│ ├─ kokoro.html サンプル:夏目漱石『こころ』
│ └─ hojoki.html サンプル:鴨長明『方丈記』
├─ sitemap.njk / robots.njk
編集するのは src/ の中だけです。_includes/ がレイアウトと部品、notes/ がメモ本体で、メモ1本が HTML ファイル1つに対応します。
2. ビルドして、出来上がりを確認する
npm install
npm run build
実行結果
> book-notes@1.0.0 build
> eleventy
[11ty] Writing ./_site/robots.txt from ./src/robots.njk
[11ty] Writing ./_site/sitemap.xml from ./src/sitemap.njk
[11ty] Writing ./_site/index.html from ./src/index.html (njk)
[11ty] Writing ./_site/notes/hojoki/index.html from ./src/notes/hojoki.html (njk)
[11ty] Writing ./_site/notes/kokoro/index.html from ./src/notes/kokoro.html (njk)
[11ty] Copied 1 Wrote 5 files in 0.21 seconds (v3.1.8)
src/notes/kokoro.html が _site/notes/kokoro/index.html になり、URL は /notes/kokoro/ になります。サイトマップや robots.txt も自動で作られました。開発中は npx @11ty/eleventy --serve でプレビュー用のサーバーを起動すると、保存するたびに再ビルドされます(このデモでは Claude Code が npm start に割り当てていました)。
メモのファイルは、先頭に数行の情報(フロントマター)を書き、その下に本文を書くだけです。
---
title: 夏目漱石『こころ』を読んで
bookTitle: こころ
bookAuthor: 夏目漱石
date: 2026-10-20
description: 夏目漱石『こころ』の読書メモ。「先生と遺書」で語られる孤独と、人が人を信じきれないことについて考えたこと。
---
<h2>読んだきっかけ</h2>
<p>学生のころ教科書で「下 先生と遺書」の一部だけを読んで、……</p>
出力された HTML を調べると、<script> タグは検索エンジン向けの構造化データ(type="application/ld+json")だけでした。ブラウザで実行される JavaScript は1行もありません。
3. 見た目の調整は、感じたことをそのまま伝える
出来上がったトップページは、メモの一覧が点線で区切られているだけで、1冊ごとの境目が見えにくい状態でした。そこで、CSS のことは言わずに、感じたことをそのまま伝えました。
トップのメモ一覧がのっぺりしていて、どこからどこまでが1冊分なのか分かりにくい。1冊ずつ区切りが分かるようにして、書名をもう少し目立たせてほしい。
Claude Code は約1分で、CSS ファイル1つだけを直しました(git diff --stat で31行追加・7行削除)。報告では、カードの左端の線を「栞紐のように」サイトの差し色にしたこと、書名を 1.25rem から 1.5rem に、太さを 600 から 700 にしたことなどを説明していました。最初に「CSS は1ファイル」と縛っておいたので、HTML 側には手を入れていません。
4. 更新の手順を CLAUDE.md に書かせる
Claude Code は、リポジトリ直下の CLAUDE.md を作業のたびに自動で読み込みます。そこで、記事を追加する手順を書かせました。
今後、読書メモの追加はあなたに頼みたい。メモを追加するときの手順と守るルールを CLAUDE.md にまとめておいて。
Claude Code は既存のメモ・レイアウト・CSS を読み、そこから決まりごとを抜き出して CLAUDE.md を作りました。抜粋は次のとおりです。
実行結果(作られた CLAUDE.md の抜粋)
## 大原則:中身はユーザーの言葉で書く
- 感想・考えたこと・読んだきっかけは、**ユーザーから聞いた内容だけ**を元に書く。足りない部分を想像で補わない。材料が足りなければ書く前に質問する。
- 引用文は**ユーザーが示した文言をそのまま**使う。記憶から本文を引用しない。文言が不確かなら確認する。
## 追加の手順
1. **材料を確認する**:書名・著者名・記録日・各セクションの中身がそろっているか確認。
2. **ファイル名を決める**:`src/notes/<スラッグ>.html`。
- ファイル名がそのまま URL(`/notes/<スラッグ>/`)になる。**既存ファイルの名前は変えない**(URL が変わってしまう)。
3. **ファイルを書く**:下のテンプレートどおりに。
4. **ビルドして確認する**:`npm run build` がエラーなく通ること……
5. **報告する**:コミット・プッシュは頼まれたときだけ行う。
手順のほかに、本文のテンプレート、フロントマターの項目の表、「メモの追加のついでに CSS やほかのメモを変えない」といった禁止事項も入っていました。また、日付の指定がないときは今日の日付にする、など自分で決めた点を「確認してほしい点」として報告してきたので、内容を見て直したい部分があれば、ここで伝えます。
5. 「メモを追加して」と頼む
CLAUDE.md ができた状態で、新しいメモを頼みました。
太宰治『走れメロス』の読書メモを追加して。読んだきっかけは、子どもの音読の宿題に付き合ったこと。心に残ったのは「信じられているから走るのだ」という場面。
Claude Code はすぐには書かず、CLAUDE.md の「想像で補わない」というルールに従って質問してきました。
実行結果(Claude Code の返答から抜粋)
メモを書く前に、いくつか教えてください。このプロジェクトのルールで、感想は聞いた内容だけで書き、
足りないところを想像で埋めないことになっています。
1. その一節について思ったこと:この場面のどこが心に残ったのか、何を感じたのか。
2. 考えたこと:読んで考えたことがあれば、箇条書きの材料をください。なければこの見出しは省きます。
3. ひとこと:全体の感想を一言。なければこれも省きます。
…
ファイル名は src/notes/hashire-merosu.html(URL は /notes/hashire-merosu/)にする予定です。
質問に答えると、テンプレートどおりのファイルを作り、ビルドして一覧に載ったことまで確かめて報告しました。
実行結果(作られた src/notes/hashire-merosu.html の抜粋)
---
title: 太宰治『走れメロス』を読んで
bookTitle: 走れメロス
bookAuthor: 太宰治
date: 2026-11-14
description: 太宰治『走れメロス』の読書メモ。走るメロスよりも、信じて待つ友人セリヌンティウスの側の怖さについて考えたこと。
---
<h2>読んだきっかけ</h2>
<p>子どもの音読の宿題に付き合ったことがきっかけである。</p>
<h2>心に残ったところ</h2>
<blockquote>
<p>信じられているから走るのだ</p>
</blockquote>
つまずきポイント
- 最初のサンプルは、AI が感想も引用も書いてしまう。手順1で「サンプルのメモページを2つ作る」と頼んだところ、『こころ』『方丈記』の感想文と引用を Claude Code が自分で書きました。あくまで見本なので、公開する前に必ず自分のメモに差し替えます。手順4の CLAUDE.md で「ユーザーから聞いた内容だけで書く」と決めてからは、手順5のように足りない材料を質問してくるようになりました。
- 削除したページが
_site/に残る。Eleventy はビルドのたびに出力先を空にしません。試しにメモを1つ足してビルドし、そのファイルを消してもう一度ビルドすると、_site/notes/に消したページが残っていました。そのまま公開すると、消したはずのページが見えてしまいます。"build": "rm -rf _site && eleventy"のように、ビルドの前に出力先を空にしておくと安心です。 - 「JavaScript を使わない」と頼んでも、
<script>タグは出る。構造化データ(JSON-LD)は<script type="application/ld+json">というタグで書く決まりのためです。中身はデータで、ブラウザが実行するものではありません。Claude Code も報告でこの点を説明していました。 - 公開用の URL は仮のまま。
src/_data/site.jsonのurlはhttps://example.comになっていました。canonical やサイトマップに使われるので、公開前に実際のドメインに書き換えます。Claude Code も「公開前に必要なこと」として報告していました。 - ヘッドレス Chrome でスクリーンショットを撮ると、本文が写らないことがある。Web フォントの読み込みを待たずに撮影されるためです。
--virtual-time-budget=6000のように待ち時間を指定すると、文字まで写りました。
まとめ
Eleventy は、部品に分けて書いたファイルを、ビルドのときに完成した HTML にまとめる静的サイトジェネレーターです。Claude Code と組み合わせると、最初に要件と縛りを書く、見た目の調整は感じたことをそのまま伝える、決まった手順は CLAUDE.md に書かせる、の3つだけで、サイトを作って育てる作業のほとんどを任せられました。特に CLAUDE.md にルールを書いておくと、AI が勝手に中身を補わず、足りない材料を聞き返してくれるようになる点が効果的でした。