自分のホームページを、
AIといっしょに作る。

このページを上から順に進めると、ホームページが公開されます。 途中で出てくる 青い囲みの文章をコードAIに貼り付ける だけで、作業のほとんどはAIが進めます。 公開したあとの直し方も、このページに書いてあります。

囲みの色意味
「コードAIに貼る」そのままコピーして、コードAIに貼り付けます
「ターミナルに貼る」パソコンの黒い画面(ターミナル)に貼り付けて、Enter を押します
「ご自身の手で」AIにはできない(させてはいけない)ところ。パスワードや支払いなど

先に、あなたの環境を選んでください

選んだ内容に合わせて、このページの貼り付け用の文章がすべて書き換わります。あとから変えられます。

あなたのサイトの作業フォルダ:

「書類(ドキュメント)」や「デスクトップ」を避けているのには理由があります。 iCloud や OneDrive が自動で同期している場所だと、作業中のファイルが大量に同期されて動きが極端に遅くなったり、壊れたりします。

1

はじめに知っておくこと

チャットAIとコードAIは、別のものです

同じ会社のAIでも、できることがまったく違います。このページで使うのは「コードAI」のほうです。

チャットAIコードAI
たとえばChatGPT、Claude(ブラウザやアプリの会話画面)Claude Code、Codex
たとえるなら相談相手。聞けば答えてくれる作業する人。あなたのパソコンの中で手を動かす
あなたのパソコンのファイル触れません作る・直す・消すができます
コマンドの実行できません(やり方を教えるだけ)できます(実行の前に、あなたに許可を求めます)
このページでの役割文章の下書き、分からない言葉を聞くサイトを作る・直す・公開する

許可を求められたら、内容を読んでから「はい」を。 コードAIは、ファイルを書き換える前やコマンドを実行する前に「これをやってよいですか」と聞いてきます。 このページの手順の範囲なら、基本的に許可して大丈夫です。 パスワードやカード番号を聞かれることはありません。聞かれたら、教えずに手を止めてください。

MCP とは(知らなくても進められます)

コードAIに「外の道具」をつなぐ差し込み口のことです。 たとえば Cloudflare の公式の説明書をつなぐと、AIが古い記憶ではなく、いまの説明書を読んで答えるようになります。 AIの知識は少し前で止まっているので、サービスの画面や手順が変わっていると、間違った案内をすることがあります。 つなぎ方は「2. 事前準備」にあります(任意です)。

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 自身にやってもらうのが確実です。

コードAIに貼る
Cloudflare の公式ドキュメント用 MCP サーバー(https://docs.mcp.cloudflare.com/mcp )を、この Codex から使えるように追加してください。
いまの Codex の版で正しい設定のしかたを確かめてから進めて、追加できたかどうかも確認してください。
3

フォルダは決め打ちです

置き場所をつくって、コードAIを起動する

サイトの作業フォルダは にします(上の設定で変えられます)。 次を貼り付けると、フォルダを作り、その中でコードAIが起動します。

ターミナルに貼る

    

はじめて起動すると、ログインを求められます。画面の案内に従ってください(ここもご自身の手で)。
次からは、同じ1行を貼れば、同じフォルダでAIが起動します。直したくなったときも、ここから始めます。

4

AIに貼る ①

ひな形を取り込む

起動したコードAIに、次を貼り付けます。

コードAIに貼る

AIが教えてくれた URL(ふつうは http://localhost:4321)をブラウザで開くと、見本の「Jagカレーショップ」が出ます。これを、あなたの内容に書き換えていきます。

5

管理画面のかわり

Obsidian で開く

ご自身の手で
  1. Obsidian を起動する
  2. 「保管庫としてフォルダを開く」(Open folder as vault)を選ぶ
  3. 次のフォルダを選ぶ:
  4. 「作者を信頼しますか」と出たら、信頼して開く

開くのは content フォルダです。ひとつ上の作業フォルダごと開くと、関係ないファイルが大量に出てきます。

左側に並ぶノートが、そのままホームページの中身です。

ノート何が変わるか
siteサイト名・連絡先・色・公開の状態
menuメニューの並び。行を消せば消え、足せば増えます
pages の中1ノート=1ページ
blog の中お知らせ・ブログ
labels「お知らせ」「すべて見る」などの短い言葉(ふだんは触りません)

各ノートの先頭にある 色つきのメモ([!todo])は、あなた向けの案内です。サイトには出ません。読み終わったら消して構いません。

6

いちばん迷うところ

素材を入れる — 写真はどこに入れるか

迷ったら「素材」フォルダに入れてください。名前も大きさも、そのままで大丈夫です。

← サイトの作業フォルダ ├── 素材 ← ★ 迷ったらここに入れる │ ├── 写真 スマホで撮ったままでOK │ ├── ロゴ ロゴや看板のデータ │ └── 資料 メニュー表・チラシ・いまのサイトの文章(AIに読ませる) └── content ← Obsidian で開いているフォルダ └── images ← サイトに出る写真(素材から、整えられて入る)

フォルダを開くには、次を貼るのが早いです。

ターミナルに貼る(AIとは別の、新しいターミナルで)

Finder から行くなら: メニューの「移動」→「フォルダへ移動…」(⌘⇧G)に を貼ります。開いたら、フォルダを Finder の左の欄にドラッグしておくと、次から1クリックで開けます。

エクスプローラーから行くなら: 上の場所の欄に を貼って Enter。開いたら「クイック アクセスにピン留め」しておくと、次から1クリックで開けます。

写真や資料を入れたら、コードAIに次を貼ります。

コードAIに貼る
「素材」フォルダに、写真と資料を入れました。

1. npm run photos を実行して、写真をサイトで使える形にしてください
2. 入った写真を見て、内容がわかる英数字の名前に変えてください(例: shop-front.jpg)
3. どの写真をどのページに使うとよいか、案を見せてください
4. 「素材/資料」の中身を読んで、ホームページに使える情報を整理してください

勝手に本文へ入れず、先に案を見せてください。

写真に埋め込まれた位置情報は、このとき消えます。 スマホの写真には、撮った場所(自宅やお店の正確な位置)が入っていることがあります。 npm run photos は、サイト向けに小さくするのと同時に、その情報を取りのぞきます。

すでに Obsidian でノートを書いている途中なら、写真をノートに直接ドラッグしても構いません。 自動で content/images に入ります(この場合は小さくならないので、大きな写真は「素材」経由がおすすめです)。

7

AIに貼る ②

AIに聞き取りをしてもらって、中身を書き換える

コードAIに貼る
AGENTS.md の「はじめて作るとき」に沿って、私のホームページを作ってください。

・まず私に聞き取りをしてください。まとめて聞かず、会話しながら少しずつお願いします
・「素材/資料」に入れたものは、先に読んでおいてください
・見本(Jagカレーショップ)の文章は残さず、私の内容に置き換えてください
・要らないページは、ノートと menu.md の行を消してください
・私が話していない実績・数字・お客様の声は、作らないでください
・site.md の published は false のままにしてください

AIの質問に答えていくと、content の中身が書き換わります。 開いたままのブラウザは、保存されるたびに自動で新しくなります。

8

ここは何度でも

手元で見て、直す

直し方は2つあります。どちらでも、好きなほうで。

やり方向いているとき
Obsidian で自分で書き換える言い回し、電話番号、営業時間、価格など。保存すればすぐ画面が変わります
コードAIに頼むページを足す、構成を変える、文章をまとめて書き直す、見た目を変える

スマホでの見え方も確かめてください。ブラウザの幅を細くすると、スマホの表示になります。

コードAIに貼る(公開の前に)
npm run check を実行して、結果を私にわかる言葉で説明してください。
「だめ」があれば直してください。「注意」は、直すべきかどうかを私に聞いてください。
9

AIに貼る ③

公開する

ご自身の手で(はじめての1回だけ)

Cloudflare とこのパソコンをつなぎます。AIとは別の、新しいターミナルを開いて貼り付けます。

ターミナルに貼る

ブラウザが開くので、Cloudflare にログインして 「Allow」(許可)を押します。

コードAIに貼る
npm run deploy で公開してください。
終わったら、公開された URL と、いまが「準備中(検索に載らない)」の状態かどうかを教えてください。

公開先は https://(site.md の project).pages.dev です。 この時点では「準備中」で、検索には載りません。知り合いに見てもらって、直してから本番にします。

本番にする

Obsidian で site ノートの published: falsepublished: true に変えてから、もう一度公開します。

コードAIに貼る
site.md の published を true に変えました。npm run deploy で公開し直してください。
10

3つの道があります

ドメインをつなぐ

向いている方費用むずかしさ
A. そのまま使う
○○.pages.dev
まず公開したい。名刺に載せるほどではない無料何もしなくてよい
B. Cloudflare で新しく買うドメインをまだ持っていない年に千円台〜(種類による)かんたん
C. 持っているドメインを使うすでにドメインがある(メールで使っている、など)追加の費用なし場合によって複雑。AIに相談しながら

A. そのまま使う

公開した時点で https://(project).pages.dev が使えます。何もしなくて構いません。あとから B や C に変えられます。

B. Cloudflare で新しく買う

ご自身の手で
  1. Cloudflare の画面Register domains(ドメインの登録)を開き、ほしい名前を検索する
  2. 買えるものだけが出ます。ほしい種類(.jp など)が出てこないことがあります。その場合は、ほかの会社で買って C の方法へ
  3. 支払い方法(クレジットカード)と、登録者の情報を入力して購入する
  4. 買えたら、Workers & Pages → あなたのプロジェクト → Custom domainsSet up a domain で、買ったドメインを入力する

Cloudflare で買ったドメインは、最初から Cloudflare につながっているので、あとは数分待つだけです。

知っておくこと: Cloudflare で買ったドメインは、ネームサーバー(ドメインの管理先)をほかの会社に変えられません。Cloudflare で管理しつづける前提になります。

つないだら、サイトの住所を新しいドメインに合わせます。

コードAIに貼る
独自ドメイン(ここにドメインを書く)をつなぎました。
site.md の url をこのドメインに変えて、npm run deploy で公開し直してください。
そのあと、新しいドメインで開けるか、本文で確かめてください。

C. 持っているドメインを使う

ここは状況によって手順が変わります。とくに、そのドメインでメールを使っている場合は注意が要ります。 手順をまちがえるとメールが届かなくなることがあるためです。

つなぎ方内容メールへの影響
C-1. www.○○.com でつなぐ
(おすすめ)
いまドメインを管理している会社の設定画面で、1行足すだけ(CNAME)。管理先は変えない影響しません
C-2. ○○.com そのものでつなぐドメインの管理先(ネームサーバー)を Cloudflare に変える必要があります先にメールの設定を写しておかないと、止まります

まず、次の4つを確かめてから、AIに相談してください。分からない項目は「分からない」と書けば大丈夫です。

コードAIに貼る([ ] の中を書き換えて)
持っているドメインを、公開した Cloudflare Pages のサイトにつなぎたいです。
いきなり作業せず、まず私の状況に合った手順と、注意点を説明してください。

・ドメイン: [ 例: example.com ]
・買った会社(管理している会社): [ 例: お名前.com / さくら / ムームードメイン / 分からない ]
・このドメインでメールを使っているか: [ 使っている / 使っていない / 分からない ]
・いまこのドメインで別のホームページが動いているか: [ 動いている / 動いていない ]
・つなぎたい形: [ www.example.com でよい / example.com そのものがよい / 分からない ]

お願いしたいこと:
1. 私の状況だと、どのつなぎ方が安全かを教えてください
2. メールを使っている場合、いまのメールの設定(MX・SPF・DKIM など)が止まらない手順にしてください
3. 私が自分の手でやる操作(どの会社の、どの画面で、何を入力するか)を、順番に書いてください
4. 変更の前に控えておくべき設定と、元に戻す方法を教えてください
5. 手順は、あなたの記憶ではなく、いまの公式の説明を確かめたうえで書いてください

ドメインの管理画面での入力は、ご自身の手で行ってください。 AIに管理画面のパスワードを渡す必要はありません。AIには「何を入力するか」を教えてもらい、入力はあなたがします。

反映には、数分から長いと1〜2日かかります。すぐに開けなくても、あわてて設定を変えないでください。

11

使い方の手引き

公開したあとの直し方

直すときは、いつも同じ流れです。① 中身を直す → ② 手元で確かめる → ③ 公開する。

ターミナルに貼る(作業をはじめるとき)
文章・電話番号・営業時間・価格を直す

Obsidian で、そのページのノートを開いて書き換えます。終わったら公開します。

コードAIに貼る
Obsidian で内容を直しました。npm run check で点検してから、npm run deploy で公開してください。
お知らせ(ブログ)を書く

Obsidian の blog フォルダに新しいノートを作り、先頭に次を書きます。 publish: true と書いた記事だけがサイトに出ます。書きかけのあいだは false にしておきます。

ノートの先頭に貼る
---
title: 記事の題名
date: 2026-10-01
description: 一覧に出す短い説明
tags: お知らせ
publish: false
---

ここから本文。

AIに下書きを頼むこともできます。

コードAIに貼る
お知らせの下書きを1本書いてください。内容: [ ここに伝えたいことを書く ]
publish: false のまま content/blog に置いてください。私が読んで、出してよければ true に変えます。
写真を入れる・差し替える

写真を 素材/写真 に入れて、AIに頼みます。

コードAIに貼る
素材/写真 に新しい写真を入れました。npm run photos でサイト用にして、[ どのページの、どのあたり ] に入れてください。
写真の説明(代替テキスト)も付けてください。入れる前に、案を見せてください。

自分で入れるなら、ノートの入れたい場所に ![[ファイル名.jpg|何の写真か]] と書きます。

ページを足す・消す、メニューを変える

メニューは menu ノートのとおりに出ます。行を消せば消え、足せば増え、入れ替えれば並びが変わります。字下げ(Tab)で子メニューになります。 メニューのどこに動かしても、ページの URL は変わりません。

コードAIに貼る
[ ページの名前 ] のページを足してください。内容は次のとおりです: [ 内容 ]
メニューでは [ どの項目の次/どの項目の下 ] に入れてください。
色や見た目を変える

サイトの主な色は、site ノートの color: を書き換えるだけです(# から始まる6けた)。上に載る文字の白黒は、自動で読みやすいほうになります。

コードAIに貼る
見た目を変えたいです: [ 例: 文字をもう少し大きく/見出しの下の線をやめたい ]
src/styles/global.css の :root を中心に直してください。文章は変えないでください。
12

止まったら

困ったとき

赤い文字やエラーが出たら、そのまま全部コピーしてAIに貼るのがいちばん早いです。

コードAIに貼る
次のエラーが出ました。docs/ja/つまずきと対処.md に同じものがないか先に確かめてから、原因と直し方を教えてください。
私がやるべきことがあれば、順番に書いてください。

[ ここにエラーを貼る ]
起きたことたいていの原因
Obsidian で直したのに、サイトが変わらない公開(npm run deploy)をしていない。手元の画面は保存ですぐ変わりますが、公開先は公開し直すまで変わりません
公開した直後、古い内容が出たり新しい内容が出たりする世界中に行き渡るまで1分ほど、新旧が混ざります。待てば落ち着きます
写真が出ない写真が content/images の外にある。npm run check が場所を教えてくれます
iPhone の写真が入らない(Windows)iPhone の形式(HEIC)を読めていません。iPhone の「設定 → カメラ → フォーマット → 互換性優先」にして撮り直すか、メールやLINEで送り直すと JPEG になります
書いたブログが出ない先頭に publish: true が無い
表の中のリンクだけ壊れる表の中では [[ノート名\|表示名]]\ を付けます(Obsidian の作法です)
nodenpm が「見つかりません」Node.js を入れたあと、ターミナルを開き直していない

Jagwebbuilder — MIT License. このページは、お使いのパソコンの中だけで動いています。入力した内容が外に送られることはありません。