Claude Code で Next.js のアフィリエイトブログを作った全手順【2026年版】
AIエージェントのClaude Codeを使って、SEOに強いNext.js + MarkdownのアフィリエイトブログをゼロからVercelに公開するまでの手順を、実際のコマンドとつまずきポイント込みで解説します。
「AIにブログサイトを丸ごと作らせたら、どこまで実用になるのか」を確かめるため、AIコーディングエージェントの Claude Code を使って、このサイト自体を Next.js でゼロから構築しました。この記事はその実作業ログです。生成AIの一般論ではなく、実際に動かしたコマンドと、詰まった箇所だけを書きます。
完成した構成
| 項目 | 採用したもの | 理由 |
|---|---|---|
| フレームワーク | Next.js (App Router) | SSG + Metadata APIでSEOが楽 |
| 言語 | TypeScript | 記事データの型を固めたい |
| スタイル | Tailwind CSS v4 | 構築速度。typographyプラグインで本文整形 |
| 記事管理 | Markdown + gray-matter | DB不要。Gitで記事を管理できる |
| 本文変換 | remark / remark-gfm | テーブルや脚注も崩れない |
| ホスティング | Vercel | Next.jsとの相性が最良・無料枠で開始可 |
ポイントは DBを使わないこと。記事を content/posts/*.md に置くだけで、ビルド時に静的HTMLへ変換されます。これにより表示は爆速、運用はGit commitだけ、という個人開発に最適な形になります。
1. プロジェクトを生成する
create-next-app を対話なし(フラグ指定)で実行します。
npx create-next-app@latest site \
--ts --tailwind --app --eslint --src-dir \
--import-alias "@/*" --use-npm --turbopack --yes
Markdownを扱うために追加で4つ入れます。
npm install gray-matter remark remark-html remark-gfm
npm install @tailwindcss/typography
2. Markdownを読む仕組みを書く
content/posts/ の .md を読み、frontmatter(タイトル等)と本文HTMLに分けるだけの薄いライブラリを用意します。要点は、記事一覧では本文をパースせずメタ情報だけを読むこと。これで一覧ページが速くなります。
const processed = await remark().use(remarkGfm).use(html).process(content);
remark-gfm を挟むのが地味に重要で、これが無いとMarkdownのテーブル(この記事の比較表のような)がただの文字列になります。
3. SEOの土台を最初に入れる
アフィリエイトブログは検索流入が命なので、最初から以下を入れておきます。後付けは漏れます。
- Metadata API:各記事で
title/description/canonical/ OGPを動的生成 app/sitemap.ts:全記事URLを自動でsitemap化app/robots.ts:クロール許可 + sitemapの場所を明示- JSON-LD(構造化データ):記事ページに
Articleを埋め込み、検索エンジンとAIに内容を伝える
metadataBase を next.config ではなく layout.tsx の metadata に設定しておくと、OGP画像の絶対URL化で後々ハマりません。
つまずき:Next.js 15以降の params は Promise
App Routerの動的ルートで、params を直接 params.slug と書くと型エラーになります。今は非同期なので await が必要です。
export default async function PostPage({
params,
}: { params: Promise<{ slug: string }> }) {
const { slug } = await params; // ← await する
}
4. 本文の見た目はTailwind Typographyに任せる
自前でh2やリストのCSSを書くのは時間の無駄です。Tailwind v4ではグローバルCSSに1行足すだけでプラグインが有効になります。
@import "tailwindcss";
@plugin "@tailwindcss/typography";
あとは本文を囲む要素に prose prose-neutral dark:prose-invert を付ければ、見出し・コード・テーブルが整います。
5. ローカルで確認して公開する
npm run dev # http://localhost:3000 で確認
npm run build # 本番ビルドが通るか確認
公開先はVercelが最短です。GitHubにpushして連携すれば、以降は commitするだけで自動デプロイ。独自ドメインも管理画面から数分で繋がります。サーバーの保守が一切要らないので、記事を書くことだけに集中できます。
補足:WordPressのように自分でサーバーを借りて運用する選択肢もありますが、Next.js構成ならまずVercelの無料枠で始め、規模が大きくなってからレンタルサーバーやVPSを検討するのが合理的です。サーバー比較は別記事で詳しく扱います。
やってみた所感
AIエージェントに任せて良かったのは、ボイラープレート(雛形)の生成速度です。create-next-appからSEO設定一式までを淡々と組み上げてくれるので、人間は「どんな記事構成にするか」「どの案件を扱うか」という、本来時間を使うべき所に集中できました。
逆に、paramsのPromise化のようなバージョン依存の罠は、AIでも古い書き方を出すことがあります。npm run build を必ず自分の目で通すこと——これだけは省略してはいけません。
次の記事では、このブログに載せるAIコーディングツール(Cursor / Claude Code / GitHub Copilot)の比較を、実際に同じ課題を解かせた結果付きで書く予定です。