Claude Code: 项目初始化与项目结构

$ claude

╭─ Claude Code ──────────────────────────────╮
│  Project Analysis:                          │
│  Type:      Node.js / TypeScript            │
│  Framework: Express.js                      │
│  Test:      Jest                            │
│  Package:   npm                             │
│  Structure:                                 │
│    src/                                     │
│      routes/      (12 route files)          │
│      models/      (8 model files)           │
│      middleware/   (4 files)                │
│      utils/        (6 utility files)        │
│    tests/                                   │
│    config/                                  │
│  Key deps: express, mongoose, jest          │
╰─────────────────────────────────────────────╯

# 让 Claude Code 分析项目并生成 CLAUDE.md
claude /init

# 生成的 CLAUDE.md 包含：
# - 项目描述
# - 技术栈
# - 构建和测试命令
# - 代码风格约定
# - 目录结构说明

# CLAUDE.md

## 项目概述
电商后台管理系统，使用 Express + TypeScript + Prisma

## 技术栈
- Runtime: Node.js 20
- Framework: Express 4.x
- ORM: Prisma 5.x
- Test: Vitest
- Lint: ESLint + Prettier

## 常用命令
- 开发: `npm run dev`
- 构建: `npm run build`
- 测试: `npm test`
- Lint: `npm run lint`

## 代码约定
- 使用 ES Module 语法
- 所有 API 响应使用统一格式 { code, data, message }
- 错误处理使用自定义 AppError 类
- 路由文件放在 src/routes/ 下
- 每个 route 文件对应一个 test 文件

## 不要做的事
- 不要使用 var，只用 const/let
- 不要直接使用 mongoose，用 Prisma
- 不要修改 prisma/schema.prisma 除非明确要求

<!-- Go 项目的 CLAUDE.md -->
# CLAUDE.md

## 项目
RESTful API 服务，Go 1.22 + Gin + GORM

## 命令
- 运行: `go run ./cmd/server`
- 测试: `go test ./...`
- 构建: `go build -o bin/server ./cmd/server`

## 约定
- 使用标准项目布局（cmd/, internal/, pkg/）
- 错误返回使用 pkg/errors 包
- 所有 handler 接收 gin.Context
- 数据库操作只在 repository 层

<!-- 大型项目的 CLAUDE.md（精简版）-->
# CLAUDE.md

## 项目结构（只列核心）
- src/core/       核心业务逻辑
- src/api/        API 路由和控制器
- src/models/     数据模型
- src/utils/      工具函数
- tests/          测试

## 工作范围
- 当前主要开发 src/api/ 目录
- 测试使用 Jest
- 数据库使用 Prisma

## 重要约束
- 所有数据库操作必须通过 Prisma Client
- API 响应格式遵循 RFC 7807 Problem Details
- 认证使用 JWT，密钥从环境变量读取

my-monorepo/
├── CLAUDE.md           # 全局配置
├── packages/
│   ├── frontend/
│   │   └── CLAUDE.md   # 前端子项目配置
│   ├── backend/
│   │   └── CLAUDE.md   # 后端子项目配置
│   └── shared/
│       └── CLAUDE.md   # 共享库配置
├── package.json
└── turbo.json

# 在不同子目录启动 Claude Code 会读取对应的 CLAUDE.md
cd packages/frontend && claude  # 读取 frontend/CLAUDE.md
cd packages/backend && claude   # 读取 backend/CLAUDE.md

# Alice 为新项目做完整初始化

# 1. 创建项目
mkdir ecommerce-api && cd ecommerce-api
npm init -y

# 2. 初始化 git
git init

# 3. 启动 Claude Code 生成项目骨架
claude "初始化一个 Express + TypeScript 项目：
1. 配置 tsconfig.json
2. 设置 ESLint + Prettier
3. 创建 src/ 目录结构（routes, controllers, models, middleware, utils）
4. 配置 Jest 测试
5. 创建 .gitignore
6. 生成 CLAUDE.md"

# Claude Code 输出：
# → Creating tsconfig.json
# → Creating .eslintrc.js and .prettierrc
# → Creating directory structure...
# → Configuring Jest
# → Creating .gitignore
# → Generating CLAUDE.md based on project setup
# → Running: npm run build ✓

# 4. 检查生成的 CLAUDE.md
cat CLAUDE.md

# 5. 根据需要调整 CLAUDE.md
# 添加团队特定约定...

# 6. 提交初始状态
git add -A && git commit -m "feat: project initialization"