Claude Codeを使ってウェブサイトを構築する
これはテンプレートではなく、プロセスです。自分自身のセンスで、自分自身のコンテンツで、自分に合った技術スタックで、誇れるウェブサイトをClaude Codeをビルダーとして使って構築する方法を学びます。フレームワークと手順を提供し、ビジョンは自分で決めます。
すべては、次のシフトに基づいています。自分がディレクター、Claudeがクルーです。 どのように感じさせるか、何が十分かを自分が決めます。Claudeは土台を作り、コードを書き、スタイルを適用し、検証し、公開します。このスキルを実行するときの自分の仕事は、相手からセンスを 引き出し 、Claudeが実行可能な指示に変え、素早く動くものを作り、ループを回すことです。
すべてを支配する唯一のルール: まずは本物の、生で醜い、動いているサイトを公開し、それから確認できる小さなステップで改善すること。1日目に公開されて50回改良されたサイトは、公開されない傑作に勝ります。
心構え(早い段階で声に出して伝えてください)
- 自分がディレクター、Claudeがビルダーです。 相手がコードを書く必要はなく、用語を知っている必要すらありません。「もっと温かみを」、「ここは窮屈に感じる」、「オフィスっぽすぎる」といった感覚を言葉で伝え、指し示すだけで、Claudeがそれをピクセルに変換します。
- まずは公開、後で見た目を整える。 スタイリングの前に空のシェルをデプロイしてください。パイプラインのデバッグを一度で済ませ、壊れるものがない状態にします。
- センスをファイルにコード化する。 良い見た目が決まったら、それをデザインシステムとして書き留めます。毎回のセッションで相手とClaudeの両方が読むことで、サイトのクオリティがブレるのを防ぎます。
- 小さく、目に見える変更を。 一度に一貫性のある変更を。確認し、コミットする。大きくて目に見えない変更は、サイトをダメにする原因です。
- ループを閉じる。 早い段階で公開し、実際の人の前に出し、彼らのフィードバックを次のTODOリストとしてそのままClaudeに渡します。
- 行き詰まったらClaudeに聞く。 以下のすべてのステップ(アカウント作成、赤いエラーの修正、わからないホスト画面など)は、一人で解決するのではなく、Claudeに任せるべきものです。「やったことがないので、手順を教えてください」と「今見ている画面のスクリーンショットを貼りますね」は、相手が言える最も有用な二つのことです。
このスキルの使い方
おおまかにフェーズの順に従って進めますが、厳格なウォーターフォールではありません。フェーズ4(反復ループ)は、他のフェーズの下で継続的に動くエンジンです。
フェーズ0 → 1 枠組みを決めて公開する · フェーズ2 → 3 自分好みにして中身を埋める · フェーズ5 → 6 印象的にしてフィードバックを得る · フェーズ4 はずっと動き続ける。
各フェーズには、目標、手順、相手がClaudeに渡すためのコピー&ペースト用プロンプト、そして最もよく失敗を招く落とし穴が含まれています。より深い内容は参照ファイルにあります。フェーズが本格的になったら、そちらも参照してください。
やめる許可。 落ち着いた1ページのサイト(名前、自分の簡単な説明、リンク1つ)は、本物の、完成したウェブサイトです。フェーズ4で終わりでいいなら、それで終わりです。フェーズ5〜6は、もっとやりたい人のためのものであり、必ずクリアすべきハードルではありません。
始める前に(Claudeがこれらすべてを手伝えます)
フェーズ1の前に、相手は4つの無料のものを用意しておく必要があります。これらはすべて、Claudeにやり方を尋ねながら設定できます。 何もしてない前提で進めてください。
- Claude Code:インストールされ、プロジェクト用のフォルダで開かれていること。
- Node.js + npm(最近のスタックの大半で必要)— Claudeは
node -vで確認し、インストールもできます。 - GitHubアカウント(無料)— コードが置かれ、ホストが監視する場所。
- ホスティングアカウント — Vercel、Netlify、Cloudflare Pages(無料枠は充実しています。無料でもカード情報の入力を求める場合がありますが、通常の個人サイトなら課金されません)。
これらのどれかがわからない場合、最初のプロンプトは次のようにしてください。
私はコーディングプロジェクトをセットアップしたことがありません。Node、npm、gitが私のマシンにインストールされているか確認し、不足しているものをインストールし、無料のGitHubと[Vercel/Netlify]アカウントを作成する手順を、一つずつ、ステップバイステップで教えてください。何をクリックすればいいか正確に教え、各ステップで私の応答を待ってください。
クイックスタート(半日で動くサイトを)
相手が今すぐ動かしたい場合:
- センスの要件を引き出す。 フェーズ0の5つの質問をし、答えを簡潔な
BRIEF.mdに書き留めます。(約15分) - 空のシェルをスキャフォールドしてデプロイする。 スタックとプッシュデプロイ可能なホストを選び(迷ったらNext.js + Vercelにして先に進む)、公式CLIでスターターを生成し、GitHubにプッシュし、ホストに接続し、空のサイトが実際のURLで動いていることを確認します。(約30分、初回はもっとかかります。アカウント登録とGitHubとホストの接続に追加で約20〜30分)
- ガードレールファイルを追加する。
AGENTS.mdを作成し、Claudeにコードを書く前にインストールされたフレームワークのドキュメントを読むよう指示します(フェーズ1)。(約2分) - ヒーローセクションだけを作成する。 画面1つ分:名前、自分の簡単な説明、行動を促すボタン1つ、ブリーフから選んだ色。ブラウザで確認します。(約20分)
- 調整してコミットする。 「見出しを大きく」、「背景を温かく」、コミット、プッシュ — これで公開完了です。(約15分)
これで、実際のURLで動く本物のウェブサイトができました。以降の作業は改良だけです。 — 楽な部分です。 (上記の時間はアカウントがすでに存在することを前提としています。初回は設定に時間がかかりますが、それは普通であり、失敗ではありません。)
フェーズ0 — 枠組みを決める:センスとスコープ
目標: 1つのコンポーネントも作る前に、サイトがどのように感じられるべきか、どのページが必要かを、平易な言葉と画像で説明できるようにすること。
手順
- 相手にインタビューする。まだデザインはしない。引き出すだけ。以下の5つを質問します。
- 誰のためのサイトで、何を感じたり、実行してほしいですか?(採用する、購入する、あなたの文章を読む、「真剣に受け止めてもらいたい」、「自分が楽しい人だと伝えたい」)
- その雰囲気を2〜3語で表すと?(「温かみのあるエディトリアル」、「クリーンでテクニカル」、「賑やかで遊び心がある」、「静かで高級感がある」、「ダークでブルータリスト」)。機能ではなく、感覚を引き出すようにしてください。
- 好きなサイトを見せてください。 2〜3つのサイトのURL、そしてその雰囲気を捉えたスクリーンショット、ムードボード、または任意の画像 — 多くの人は視覚的にセンスを表現するので、画像を貼ってもらいましょう。そして、嫌いなサイトも1つ。構造と雰囲気は真似ても、コンテンツは決して真似しないでください。
- このサイトが絶対に達成すべきことは何ですか?(文章、ビジュアル、作品例、速度)
- 本当に必要なページ・セクションはどれですか? スコープの拡大を防ぎましょう。ほとんどの個人サイトはホームとあと1〜2ページです。
- 答えをリポジトリルートの
BRIEF.mdに書き留める — あなたとClaudeが照らし合わせるための、揺るがない指標です。画像があった場合は、それぞれから何を取り入れるかをメモします。
Claudeに渡すプロンプト
何かを作り始める前に、私が作りたいウェブサイトについてインタビューしてください。一つずつ質問してください:誰のためのサイトで、訪れた人に何を感じたり、実行してほしいか;雰囲気を2〜3語で;好きなサイト(リンクとスクリーンショット/ムードボード画像を貼るので、画像にも反応してください)と嫌いなサイト1つ;このサイトが絶対に達成すべきこと;本当に必要なページ。その後、答えをBRIEF.mdに指標として書き留めてください。まだサイトのコードは書かないでください。
落とし穴: 誰も感覚を説明できないうちに作り始めてしまうこと。雰囲気を言葉や画像で表現できないと、Claudeはデフォルトの汎用SaaSテンプレートになってしまい、後からの修正が難しくなります。まず感覚(言葉か画像)を引き出しましょう。
フェーズ1 — 基礎:空のサイトを公開し、ガードレールを設定する
目標: 空だが本物のサイトを、すでに実際のURLに自動デプロイが設定された状態でデプロイし、すべての変更が自動で公開されるようにする。さらに、Claudeを正しい情報に導くガードレールも設定する。
これをどうやるか知っている必要はありません。 Claudeが正確なクリック操作とコマンドを伝え、各ステップであなたの応答を待ちます。画面がわからなければ、スクリーンショットを撮って貼り付けてください。それこそがワークフローであり、失敗ではありません。
手順
- 事前にスタックとホストを選ぶ(下の表)。フレームワークと同じ会社のホストを選ぶと、デフォルトの設定がうまくいきやすいです。どの選択肢でも大丈夫。最悪なのは、選ぶのに1日費やすことです。
- フレームワークの公式CLIでスキャフォールドする(手動ではない)。
- まず空のテンプレートをデプロイする。 GitHubにプッシュし、ホストに接続し、コードに触れる前に空のサイトが動いていることを確認する。パイプラインのデバッグを、壊れるものが他にない状態で行います。
- カスタムドメインがあれば早めに設定する(本物のアドレスです。無料の
*.host.appURLは一時的なものです)。DNS(ドメイン名をサイトに向ける設定)は反映に数時間かかることがあるので、早めに始めましょう。まだドメインがない? ホストのURLで始めて、後で購入すれば大丈夫です。 - 真実のガードレールを追加する。
AGENTS.md(および@AGENTS.mdだけを含む1行のCLAUDE.md)を作成し、インストールされたフレームワークはトレーニングデータよりも新しい可能性があることをAIエージェントに伝え、コードを書く前にnode_modules/<framework>/dist/docsにある実際のドキュメントを読むように指示します。この1つのファイルで、幻覚(ハルシネーション)によるAPIバグのクラス全体を防げます。 - 最初からシークレットをgitから守る。
.gitignoreでenvファイルとビルド出力を除外し、APIキーやプライベートアドレスを決してコミットしない。それらはホストの環境設定に保持します。Claudeにリポジトリと一緒に設定するよう依頼してください。 - Claudeが推測できないデプロイ情報を書き留める: 本番URL、ホスト、自動デプロイするブランチ、正確なリポジトリスラッグ、注意点。メモ/記憶ファイルに保存します。通常、ライブドメインはコードからは判別できません。
- ローカルプレビューとヘルスチェックを設定する: 実行設定(または
devコマンドとポートを文書化)と、ローカルURLがHTTP 200を返すことを確認する1行のチェック。プッシュする前に確認できます。
決定表 — 選択肢を選んで次に進む
| サイトの種類 | 推奨デフォルトスタック | ホスト |
|---|---|---|
| ポートフォリオ / 個人サイト / 履歴書 | Next.js または Astro | Vercel / Netlify |
| 主に文章 / ブログ | Astro または Next.js | Vercel / Netlify |
| 単一のランディング / マーケティングページ | Astro または Vite + React | Netlify / Cloudflare Pages |
| プレーンなファイルとして手編集したい場合 | プレーンHTML + CSS(ビルド不要) | Netlify / CF / GitHub Pages |
| 「わからない、とにかく動かして」 | Next.js + Vercel | Vercel |
(最後の行は、Claudeが最も多くのドキュメントにアクセスできるパスであるため、Next.js + Vercelを選んでいます。上記のどの選択肢も同様に正当です。)
Claudeに渡すプロンプト
[Next.js / Astro / プレーンHTML+CSS]のサイトを公式ツールで新規作成し、スターターをそのままにして、以下の手順を教えてください:git initと最初のコミット(env/シークレットを除外する.gitignoreを含む)、GitHubリポジトリの作成、[Vercel / Netlify]との接続(mainブランチへのプッシュで自動デプロイされるようにする)。コードを書く前に、空のサイトが実際のURLで動いていることを確認してください。次に、AGENTS.mdを作成し、インストールされたフレームワークがトレーニングデータよりも新しい可能性があること、コードを書く前にnode_modules/[framework]/dist/docsのドキュメントを読むことをAIエージェントに指示してください。さらに、@AGENTS.mdだけを含むCLAUDE.mdも作成してください。最後に、本番URL、ホスト、デプロイブランチ、リポジトリをメモファイルに保存してください。正確なクリック操作を教え、各ステップで私の応答を待ってください。
落とし穴: 一度もデプロイせずにサイト全体を作り上げてしまうこと(コードとパイプラインの両方を一度にデバッグすることになる)、または、変化の速いフレームワークについてモデルの記憶を信頼し、インストールされたドキュメントに固定しないこと。
→ メディア、サイズ制限、エンコードコマンド、本番確認:reference/PLAYBOOK.md。
フェーズ2 — デザイン言語をコード化する
目標: 色、タイポグラフィ、余白、動き、トーンを含む、書き言葉で機械可読なデザインシステム。毎回のセッションで相手とClaudeの両方が読むことで、新しいページごとにブランドがブレて5つの微妙に異なる見た目になるのを防ぎます。
これは実際に気に入ったページが1つできた後に行ってください。良いものからシステムを抽出するのであって、空白から発明するのではありません。
手順
- まずムードを言葉で定義し、そこからすべてのルールを導き出す。短いフレーズ2つ。2つのムードが緊張関係にある場合、その緊張自体がルールになります。(実際のビルドでは「温かみのあるエディトリアルな落ち着き + 遊び心のあるピクセルクラフト」というフレーズでしたが、「静かで高級感がある」や「賑やかでブルータリスト」なサイトは独自のフレーズを選び、非常に異なるルールを導き出すでしょう。)
- 色を意図的かつ一貫して使う。 控えめなパレット(多くの場合、単一のアクセントカラー)は階層を読みやすく保ち、安全なデフォルトです。しかし、センスがマキシマリスト、レトロ、ブルータリストであれば、マルチカラーシステムも正当な選択です。ルールは「アクセントは厳密に1つ」ではなく、すべての色に定義された役割があり、どこでも同じ方法で使用されることです。
- 色は役割名のトークンとして定義し、マークアップに直接16進数カラーをばらまかない。ソフトテキストとボーダーは、5つに近い灰色を発明するのではなく、1つのインク色を透明度を下げて表現します。
- タイプは書体ではなく役割でペアリングする(本文/UI、見出し/「声」、モノ、ディスプレイ)。役割を参照しておけば、後で実際のフォントを変更しても書き直しは不要です。
- 余白のリズムとz-indexの階段を固定し、「新しい値を発明しない」と明記する。
- ムードに合ったモーション哲学を明記する: 安価なアンビエントループはCSSで、インタラクティブなフィードバックはJSライブラリで。
prefers-reduced-motionの背後に必須でないモーションをゲートする。 - アクセシブルなベースラインを設定する(品質の一部であり、追加機能ではない):本文テキストのコントラスト4.5:1以上、実際の見出し順序、可視フォーカス状態、セマンティックランドマーク、意味のある画像の代替テキスト。大胆/ダークなパレットは、コントラストが静かに失敗するまさにその場所です。
- ボイス&トーンをデザインとして書き留める — コピーは見た目の一部です(文頭大文字?遊び心?平易な言葉? 企業の飾り言葉はなし?)。
- 2つのコミットされたファイルにコード化する: 散文形式の
DESIGN_SYSTEM.md(原則 + コンポーネントレシピ + ビルドチェックリスト)とtokensファイル(生の値)。今後のみ適用とマークする — 既存のページから抽出したものであり、移行対象ではないことを示す。Claudeが「親切に」動作しているコードをリファクタリングしないようにするためです。 - コンテキストに結びつける: 参照...
(翻訳の都合上、ここで終了しています。元のSKILL.mdの完全な翻訳は、文字数制限により省略されています。)
[truncated for translation]