本节目标:创建 Next.js 项目,生成 CLAUDE.md 让 AI 始终理解你的项目
演示的 Claude Code 功能:
/init、CLAUDE.md
5.2.1 创建项目
在终端执行以下命令:
# 1. 进入工作目录
cd ~/projects
# 2. 用 create-next-app 创建项目(会自动安装依赖)
npx create-next-app@latest mini-mall --typescript --tailwind --app --src-dir
# 3. 进入项目目录
cd mini-mall
# 4. 安装额外依赖
npm install prisma @prisma/client bcryptjs
npm install -D tsx @types/bcryptjs
意: 避坑:项目路径不要用中文,否则某些工具会出奇怪的问题。
![图片[1]-5.2 环境搭建:项目骨架 + CLAUDE.md-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1860-1024x637.png)
5.2.2 初始化 Prisma(数据库 ORM)
# 初始化 Prisma,选择 SQLite 作为数据库
npx prisma init --datasource-provider sqlite
这个命令会创建 prisma/schema.prisma 文件和 .env 环境变量文件。
5.2.3 CLAUDE.md — AI 的项目”说明书”
CLAUDE.md 是 Claude Code 最核心的概念之一。它是一个放在项目根目录的 Markdown 文件,每次你和 AI 对话时,AI 都会自动读取它。
你可以把 CLAUDE.md 理解为给 AI 的”项目说明书”——里面写了:
- 用了什么技术栈
- 文件怎么组织的
- 命名规范是什么
- 有什么特殊的约定
5.2.3.1 两种方式创建 CLAUDE.md
方式一:让 AI 自动生成
在 Claude Code 对话中输入:
/init
AI 会扫描你的项目结构,自动生成一份 CLAUDE.md。
方式二:自己写(更精确)
你可以在 CLAUDE.md 中写任何你想让 AI 记住的信息。以下是我们项目的 CLAUDE.md 内容:
# Mini Mall 项目规范
## 技术栈
- 框架:Next.js 16 (App Router) + TypeScript
- 样式:TailwindCSS 4
- 数据库:SQLite + Prisma 5
- 认证:自制 Cookie Session + bcryptjs
## 目录结构
- src/app/ — 页面和 API
- src/components/ — 可复用组件
- src/lib/ — 工具函数
- prisma/ — 数据库模型
## 命名规范
- 文件名:kebab-case(如 product-card.tsx)
- 组件:PascalCase(如 ProductCard)
- 函数:camelCase(如 getProducts)
## 约定
- 所有 UI 文案和注释用中文
- 优先使用 Server Components
- API 返回 JSON,错误返回 { error: string }
提示:有了 CLAUDE.md,你不需要每次对话都重新解释项目背景。AI 会自动读取它,就像新同事入职时先看员工手册一样。
5.2.4 定义数据库模型
在 prisma/schema.prisma 中定义 6 个数据模型。以下是完整的模型定义:
// 用户
model User {
id Int @id @default(autoincrement())
name String
email String @unique
password String
role String @default("USER") // USER 或 ADMIN
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
cartItems CartItem[]
orders Order[]
}
// 商品分类
model Category {
id Int @id @default(autoincrement())
name String @unique
slug String @unique // URL 友好的英文标识
products Product[]
}
// 商品
model Product {
id Int @id @default(autoincrement())
name String
description String @default("")
price Float
image String @default("")
stock Int @default(0)
categoryId Int
category Category @relation(fields: [categoryId], references: [id])
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
cartItems CartItem[]
orderItems OrderItem[]
}
// 购物车项
model CartItem {
id Int @id @default(autoincrement())
userId Int
productId Int
quantity Int @default(1)
user User @relation(fields: [userId], references: [id], onDelete: Cascade)
product Product @relation(fields: [productId], references: [id], onDelete: Cascade)
@@unique([userId, productId]) // 同一用户同一商品只允许一条记录
}
// 订单
model Order {
id Int @id @default(autoincrement())
userId Int
status String @default("PENDING")
total Float
createdAt DateTime @default(now())
user User @relation(fields: [userId], references: [id])
items OrderItem[]
}
// 订单明细
model OrderItem {
id Int @id @default(autoincrement())
orderId Int
productId Int
productName String // 下单时锁定商品名,防止后续改名影响历史订单
price Float // 下单时锁定价格
quantity Int
order Order @relation(fields: [orderId], references: [id], onDelete: Cascade)
product Product @relation(fields: [productId], references: [id])
}
然后执行迁移:
# 生成 Prisma 客户端 + 创建数据库表
npx prisma migrate dev --name init
提示:Prisma 的
migrate dev做了三件事:1)对比 schema 和数据库;2)生成迁移 SQL 文件;3)应用到数据库。这些迁移文件可以提交到 Git,团队成员都能复现相同的数据库结构。
5.2.5 填充种子数据
空数据库没法开发。写一个种子脚本,插入 12 个商品和 2 个测试用户。
创建 prisma/seed.ts:
import { PrismaClient } from "@prisma/client";
import bcrypt from "bcryptjs";
const prisma = new PrismaClient();
async function main() {
// 创建 5 个分类
const categories = await Promise.all([
prisma.category.create({ data: { name: "数码电子", slug: "digital" } }),
prisma.category.create({ data: { name: "服装鞋帽", slug: "clothing" } }),
prisma.category.create({ data: { name: "家居生活", slug: "home" } }),
prisma.category.create({ data: { name: "食品饮料", slug: "food" } }),
prisma.category.create({ data: { name: "图书教育", slug: "books" } }),
]);
// 创建 12 个商品(代码略,见完整源码)
// ...
// 创建管理员和测试用户
const adminPassword = await bcrypt.hash("admin123", 10);
const userPassword = await bcrypt.hash("user123", 10);
await prisma.user.create({
data: { name: "管理员", email: "admin@example.com", password: adminPassword, role: "ADMIN" },
});
await prisma.user.create({
data: { name: "测试用户", email: "user@example.com", password: userPassword, role: "USER" },
});
console.log("种子数据创建完成!");
}
main().finally(() => prisma.$disconnect());
在 package.json 中添加 seed 配置:
"prisma": {
"seed": "tsx prisma/seed.ts"
}
执行:
npx prisma db seed
验证:终端输出 “种子数据创建完成”。数据库中已有 5 个分类、12 个商品、2 个用户。
5.2.6 你学到了什么
| 概念 | 说明 |
|---|---|
| create-next-app | Next.js 官方脚手架,一键生成项目 |
| Prisma | ORM 工具,用代码定义数据库结构 |
| Prisma Migrate | 数据库版本管理,像 Git 管理代码一样管理数据库 |
| Seed 脚本 | 开发阶段用来填充测试数据 |
| CLAUDE.md | AI 的项目说明书,每次对话自动加载 |














请登录后查看评论内容