自分のホームページを、
AIといっしょに作る。
このページを上から順に進めると、ホームページが公開されます。 途中で出てくる 青い囲みの文章をコードAIに貼り付ける だけで、作業のほとんどはAIが進めます。 公開したあとの直し方も、このページに書いてあります。
| 囲みの色 | 意味 |
|---|---|
| 青「コードAIに貼る」 | そのままコピーして、コードAIに貼り付けます |
| 黒「ターミナルに貼る」 | パソコンの黒い画面(ターミナル)に貼り付けて、Enter を押します |
| 黄「ご自身の手で」 | AIにはできない(させてはいけない)ところ。パスワードや支払いなど |
先に、あなたの環境を選んでください
選んだ内容に合わせて、このページの貼り付け用の文章がすべて書き換わります。あとから変えられます。
あなたのサイトの作業フォルダ:
「書類(ドキュメント)」や「デスクトップ」を避けているのには理由があります。 iCloud や OneDrive が自動で同期している場所だと、作業中のファイルが大量に同期されて動きが極端に遅くなったり、壊れたりします。
はじめに知っておくこと
チャットAIとコードAIは、別のものです
同じ会社のAIでも、できることがまったく違います。このページで使うのは「コードAI」のほうです。
| チャットAI | コードAI | |
|---|---|---|
| たとえば | ChatGPT、Claude(ブラウザやアプリの会話画面) | Claude Code、Codex |
| たとえるなら | 相談相手。聞けば答えてくれる | 作業する人。あなたのパソコンの中で手を動かす |
| あなたのパソコンのファイル | 触れません | 作る・直す・消すができます |
| コマンドの実行 | できません(やり方を教えるだけ) | できます(実行の前に、あなたに許可を求めます) |
| このページでの役割 | 文章の下書き、分からない言葉を聞く | サイトを作る・直す・公開する |
許可を求められたら、内容を読んでから「はい」を。 コードAIは、ファイルを書き換える前やコマンドを実行する前に「これをやってよいですか」と聞いてきます。 このページの手順の範囲なら、基本的に許可して大丈夫です。 パスワードやカード番号を聞かれることはありません。聞かれたら、教えずに手を止めてください。
MCP とは(知らなくても進められます)
コードAIに「外の道具」をつなぐ差し込み口のことです。 たとえば Cloudflare の公式の説明書をつなぐと、AIが古い記憶ではなく、いまの説明書を読んで答えるようになります。 AIの知識は少し前で止まっているので、サービスの画面や手順が変わっていると、間違った案内をすることがあります。 つなぎ方は「2. 事前準備」にあります(任意です)。
ここだけは、ご自身の手で
事前準備(先にそろえるもの)
作りはじめてから止まらないように、先にそろえます。ここが終われば、あとはほとんどAIが進めます。
入れておくもの
| もの | 何のため | 費用 | 入手先 |
|---|---|---|---|
| コードAI Claude CodeCodex | 作業をしてもらう | 有料プランの契約が必要 | claude.comopenai.com/codex |
| Node.js | ホームページを書き出す道具を動かす | 無料 | nodejs.org の「LTS」と書いてあるほう |
| Obsidian | 文章を書く・直す(管理画面のかわり) | 無料 | obsidian.md |
Node.js が入ったかは、次で確かめられます。「ターミナル」というアプリ(Launchpad で「ターミナル」と検索)「PowerShell」(スタートメニューで「PowerShell」と検索)を開いて貼り付けます。
node -v
v20 以上の数字が出れば大丈夫です。「見つかりません」と出たら、Node.js を入れたあとにターミナルを開き直してください。
コードAIは、Node.js が入ったあとに次で入ります。
npm install -g @anthropic-ai/claude-code
npm install -g @openai/codex
作っておくアカウント
Cloudflare(クラウドフレア)のアカウント — ホームページを置く場所です。無料で使えます。
dash.cloudflare.com/sign-up から作ります。
- 手で入力するもの: メールアドレス、自分で決めたパスワード
- 登録のあと、届いたメールのリンクを押して確認します(これを忘れると、あとで公開が止まります)
- プランを聞かれたら Free(無料)で足ります
- 独自ドメインを Cloudflare で買う場合だけ、あとでクレジットカードの登録が要ります
パスワードをAIに教えないでください。AIがパスワードを必要とする場面はありません。
決めておくこと・集めておくもの
| 決めること | メモ |
|---|---|
| 屋号(サイトの名前) | 検索結果やページのいちばん上に出ます |
| 載せる連絡先 | メール・電話・住所。載せたくないものは載せなくて構いません |
| 営業時間・定休日・場所 | お店の場合 |
| 商品やサービスと、その価格 | 税込みか税別かも |
| 好きな色 | 無ければAIが提案します |
| 写真 | お店の外観・商品・ご自身。スマホで撮ったままで大丈夫です |
| ドメイン(○○.com など)をどうするか | 「10. ドメインをつなぐ」を先に読んでおくと決めやすいです。あとからでも変えられます |
メニュー表・チラシ・いまのホームページの文章など、すでにある資料はそのままAIに読ませられます。打ち直す必要はありません(「6. 素材を入れる」)。
(任意)Cloudflare の公式説明書を、コードAIにつなぐ(MCP)
つなぐと、AIが Cloudflare のいまの説明書を読んで答えます。公開やドメインでつまずいたときに効きます。 ログインは要りません。つながなくても、このページの手順は最後まで進められます。
claude mcp add --transport http --scope user cloudflare-docs https://docs.mcp.cloudflare.com/mcp
確かめるには claude mcp list。外すには claude mcp remove cloudflare-docs。
Codex は版によってつなぎ方が違うので、Codex 自身にやってもらうのが確実です。
Cloudflare の公式ドキュメント用 MCP サーバー(https://docs.mcp.cloudflare.com/mcp )を、この Codex から使えるように追加してください。 いまの Codex の版で正しい設定のしかたを確かめてから進めて、追加できたかどうかも確認してください。
フォルダは決め打ちです
置き場所をつくって、コードAIを起動する
サイトの作業フォルダは にします(上の設定で変えられます)。
次を貼り付けると、フォルダを作り、その中でコードAIが起動します。
はじめて起動すると、ログインを求められます。画面の案内に従ってください(ここもご自身の手で)。
次からは、同じ1行を貼れば、同じフォルダでAIが起動します。直したくなったときも、ここから始めます。
AIに貼る ①
ひな形を取り込む
起動したコードAIに、次を貼り付けます。
AIが教えてくれた URL(ふつうは http://localhost:4321)をブラウザで開くと、見本の「Jagカレーショップ」が出ます。これを、あなたの内容に書き換えていきます。
管理画面のかわり
Obsidian で開く
- Obsidian を起動する
- 「保管庫としてフォルダを開く」(Open folder as vault)を選ぶ
- 次のフォルダを選ぶ:
- 「作者を信頼しますか」と出たら、信頼して開く
開くのは content フォルダです。ひとつ上の作業フォルダごと開くと、関係ないファイルが大量に出てきます。
左側に並ぶノートが、そのままホームページの中身です。
| ノート | 何が変わるか |
|---|---|
site | サイト名・連絡先・色・公開の状態 |
menu | メニューの並び。行を消せば消え、足せば増えます |
pages の中 | 1ノート=1ページ |
blog の中 | お知らせ・ブログ |
labels | 「お知らせ」「すべて見る」などの短い言葉(ふだんは触りません) |
各ノートの先頭にある 色つきのメモ([!todo])は、あなた向けの案内です。サイトには出ません。読み終わったら消して構いません。
いちばん迷うところ
素材を入れる — 写真はどこに入れるか
迷ったら「素材」フォルダに入れてください。名前も大きさも、そのままで大丈夫です。
フォルダを開くには、次を貼るのが早いです。
Finder から行くなら: メニューの「移動」→「フォルダへ移動…」(⌘⇧G)に を貼ります。開いたら、フォルダを Finder の左の欄にドラッグしておくと、次から1クリックで開けます。
エクスプローラーから行くなら: 上の場所の欄に を貼って Enter。開いたら「クイック アクセスにピン留め」しておくと、次から1クリックで開けます。
写真や資料を入れたら、コードAIに次を貼ります。
「素材」フォルダに、写真と資料を入れました。 1. npm run photos を実行して、写真をサイトで使える形にしてください 2. 入った写真を見て、内容がわかる英数字の名前に変えてください(例: shop-front.jpg) 3. どの写真をどのページに使うとよいか、案を見せてください 4. 「素材/資料」の中身を読んで、ホームページに使える情報を整理してください 勝手に本文へ入れず、先に案を見せてください。
写真に埋め込まれた位置情報は、このとき消えます。
スマホの写真には、撮った場所(自宅やお店の正確な位置)が入っていることがあります。
npm run photos は、サイト向けに小さくするのと同時に、その情報を取りのぞきます。
すでに Obsidian でノートを書いている途中なら、写真をノートに直接ドラッグしても構いません。
自動で content/images に入ります(この場合は小さくならないので、大きな写真は「素材」経由がおすすめです)。
AIに貼る ②
AIに聞き取りをしてもらって、中身を書き換える
AGENTS.md の「はじめて作るとき」に沿って、私のホームページを作ってください。 ・まず私に聞き取りをしてください。まとめて聞かず、会話しながら少しずつお願いします ・「素材/資料」に入れたものは、先に読んでおいてください ・見本(Jagカレーショップ)の文章は残さず、私の内容に置き換えてください ・要らないページは、ノートと menu.md の行を消してください ・私が話していない実績・数字・お客様の声は、作らないでください ・site.md の published は false のままにしてください
AIの質問に答えていくと、content の中身が書き換わります。
開いたままのブラウザは、保存されるたびに自動で新しくなります。
ここは何度でも
手元で見て、直す
直し方は2つあります。どちらでも、好きなほうで。
| やり方 | 向いているとき |
|---|---|
| Obsidian で自分で書き換える | 言い回し、電話番号、営業時間、価格など。保存すればすぐ画面が変わります |
| コードAIに頼む | ページを足す、構成を変える、文章をまとめて書き直す、見た目を変える |
スマホでの見え方も確かめてください。ブラウザの幅を細くすると、スマホの表示になります。
npm run check を実行して、結果を私にわかる言葉で説明してください。 「だめ」があれば直してください。「注意」は、直すべきかどうかを私に聞いてください。
AIに貼る ③
公開する
Cloudflare とこのパソコンをつなぎます。AIとは別の、新しいターミナルを開いて貼り付けます。
ブラウザが開くので、Cloudflare にログインして 「Allow」(許可)を押します。
npm run deploy で公開してください。 終わったら、公開された URL と、いまが「準備中(検索に載らない)」の状態かどうかを教えてください。
公開先は https://(site.md の project).pages.dev です。
この時点では「準備中」で、検索には載りません。知り合いに見てもらって、直してから本番にします。
本番にする
Obsidian で site ノートの published: false を published: true に変えてから、もう一度公開します。
site.md の published を true に変えました。npm run deploy で公開し直してください。
3つの道があります
ドメインをつなぐ
| 向いている方 | 費用 | むずかしさ | |
|---|---|---|---|
A. そのまま使う○○.pages.dev | まず公開したい。名刺に載せるほどではない | 無料 | 何もしなくてよい |
| B. Cloudflare で新しく買う | ドメインをまだ持っていない | 年に千円台〜(種類による) | かんたん |
| C. 持っているドメインを使う | すでにドメインがある(メールで使っている、など) | 追加の費用なし | 場合によって複雑。AIに相談しながら |
A. そのまま使う
公開した時点で https://(project).pages.dev が使えます。何もしなくて構いません。あとから B や C に変えられます。
B. Cloudflare で新しく買う
- Cloudflare の画面で Register domains(ドメインの登録)を開き、ほしい名前を検索する
- 買えるものだけが出ます。ほしい種類(.jp など)が出てこないことがあります。その場合は、ほかの会社で買って C の方法へ
- 支払い方法(クレジットカード)と、登録者の情報を入力して購入する
- 買えたら、Workers & Pages → あなたのプロジェクト → Custom domains → Set up a domain で、買ったドメインを入力する
Cloudflare で買ったドメインは、最初から Cloudflare につながっているので、あとは数分待つだけです。
知っておくこと: Cloudflare で買ったドメインは、ネームサーバー(ドメインの管理先)をほかの会社に変えられません。Cloudflare で管理しつづける前提になります。
つないだら、サイトの住所を新しいドメインに合わせます。
独自ドメイン(ここにドメインを書く)をつなぎました。 site.md の url をこのドメインに変えて、npm run deploy で公開し直してください。 そのあと、新しいドメインで開けるか、本文で確かめてください。
C. 持っているドメインを使う
ここは状況によって手順が変わります。とくに、そのドメインでメールを使っている場合は注意が要ります。 手順をまちがえるとメールが届かなくなることがあるためです。
| つなぎ方 | 内容 | メールへの影響 |
|---|---|---|
C-1. www.○○.com でつなぐ(おすすめ) | いまドメインを管理している会社の設定画面で、1行足すだけ(CNAME)。管理先は変えない | 影響しません |
C-2. ○○.com そのものでつなぐ | ドメインの管理先(ネームサーバー)を Cloudflare に変える必要があります | 先にメールの設定を写しておかないと、止まります |
まず、次の4つを確かめてから、AIに相談してください。分からない項目は「分からない」と書けば大丈夫です。
持っているドメインを、公開した Cloudflare Pages のサイトにつなぎたいです。 いきなり作業せず、まず私の状況に合った手順と、注意点を説明してください。 ・ドメイン: [ 例: example.com ] ・買った会社(管理している会社): [ 例: お名前.com / さくら / ムームードメイン / 分からない ] ・このドメインでメールを使っているか: [ 使っている / 使っていない / 分からない ] ・いまこのドメインで別のホームページが動いているか: [ 動いている / 動いていない ] ・つなぎたい形: [ www.example.com でよい / example.com そのものがよい / 分からない ] お願いしたいこと: 1. 私の状況だと、どのつなぎ方が安全かを教えてください 2. メールを使っている場合、いまのメールの設定(MX・SPF・DKIM など)が止まらない手順にしてください 3. 私が自分の手でやる操作(どの会社の、どの画面で、何を入力するか)を、順番に書いてください 4. 変更の前に控えておくべき設定と、元に戻す方法を教えてください 5. 手順は、あなたの記憶ではなく、いまの公式の説明を確かめたうえで書いてください
ドメインの管理画面での入力は、ご自身の手で行ってください。 AIに管理画面のパスワードを渡す必要はありません。AIには「何を入力するか」を教えてもらい、入力はあなたがします。
反映には、数分から長いと1〜2日かかります。すぐに開けなくても、あわてて設定を変えないでください。
使い方の手引き
公開したあとの直し方
直すときは、いつも同じ流れです。① 中身を直す → ② 手元で確かめる → ③ 公開する。
文章・電話番号・営業時間・価格を直す
Obsidian で、そのページのノートを開いて書き換えます。終わったら公開します。
Obsidian で内容を直しました。npm run check で点検してから、npm run deploy で公開してください。
お知らせ(ブログ)を書く
Obsidian の blog フォルダに新しいノートを作り、先頭に次を書きます。
publish: true と書いた記事だけがサイトに出ます。書きかけのあいだは false にしておきます。
--- title: 記事の題名 date: 2026-10-01 description: 一覧に出す短い説明 tags: お知らせ publish: false --- ここから本文。
AIに下書きを頼むこともできます。
お知らせの下書きを1本書いてください。内容: [ ここに伝えたいことを書く ] publish: false のまま content/blog に置いてください。私が読んで、出してよければ true に変えます。
写真を入れる・差し替える
写真を 素材/写真 に入れて、AIに頼みます。
素材/写真 に新しい写真を入れました。npm run photos でサイト用にして、[ どのページの、どのあたり ] に入れてください。 写真の説明(代替テキスト)も付けてください。入れる前に、案を見せてください。
自分で入れるなら、ノートの入れたい場所に ![[ファイル名.jpg|何の写真か]] と書きます。
ページを足す・消す、メニューを変える
メニューは menu ノートのとおりに出ます。行を消せば消え、足せば増え、入れ替えれば並びが変わります。字下げ(Tab)で子メニューになります。
メニューのどこに動かしても、ページの URL は変わりません。
[ ページの名前 ] のページを足してください。内容は次のとおりです: [ 内容 ] メニューでは [ どの項目の次/どの項目の下 ] に入れてください。
色や見た目を変える
サイトの主な色は、site ノートの color: を書き換えるだけです(# から始まる6けた)。上に載る文字の白黒は、自動で読みやすいほうになります。
見た目を変えたいです: [ 例: 文字をもう少し大きく/見出しの下の線をやめたい ] src/styles/global.css の :root を中心に直してください。文章は変えないでください。
止まったら
困ったとき
赤い文字やエラーが出たら、そのまま全部コピーしてAIに貼るのがいちばん早いです。
次のエラーが出ました。docs/ja/つまずきと対処.md に同じものがないか先に確かめてから、原因と直し方を教えてください。 私がやるべきことがあれば、順番に書いてください。 [ ここにエラーを貼る ]
| 起きたこと | たいていの原因 |
|---|---|
| Obsidian で直したのに、サイトが変わらない | 公開(npm run deploy)をしていない。手元の画面は保存ですぐ変わりますが、公開先は公開し直すまで変わりません |
| 公開した直後、古い内容が出たり新しい内容が出たりする | 世界中に行き渡るまで1分ほど、新旧が混ざります。待てば落ち着きます |
| 写真が出ない | 写真が content/images の外にある。npm run check が場所を教えてくれます |
| iPhone の写真が入らない(Windows) | iPhone の形式(HEIC)を読めていません。iPhone の「設定 → カメラ → フォーマット → 互換性優先」にして撮り直すか、メールやLINEで送り直すと JPEG になります |
| 書いたブログが出ない | 先頭に publish: true が無い |
| 表の中のリンクだけ壊れる | 表の中では [[ノート名\|表示名]] と \ を付けます(Obsidian の作法です) |
node や npm が「見つかりません」 | Node.js を入れたあと、ターミナルを開き直していない |
Jagwebbuilder — MIT License. このページは、お使いのパソコンの中だけで動いています。入力した内容が外に送られることはありません。