CLAUDE.md：让 Claude 懂你的项目

你：帮我重构一下登录模块

Claude：好的，我创建了新的登录组件...

你：等等，我们项目用的是 Vue，不是 React

Claude：哦，我重新写...

你：还有，我们组件命名用 PascalCase

Claude：我改一下...

你：对了，测试文件要放在 __tests__ 目录

┌─────────────────────────────────────────────────────────────────┐
│                    Claude Code 五层记忆体系                       │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  优先级    类型          位置                     共享范围       │
│  ───────────────────────────────────────────────────────────    │
│                                                                  │
│   高      企业策略      /etc/claude-code/         全公司        │
│                        CLAUDE.md                                │
│                                                                  │
│           项目内存      ./CLAUDE.md               项目团队      │
│                        或 ./.claude/CLAUDE.md                    │
│                                                                  │
│           项目规则      ./.claude/rules/*.md      项目团队      │
│                        (模块化、可按路径匹配)                    │
│                                                                  │
│           用户内存      ~/.claude/CLAUDE.md       仅你自己      │
│                        (所有项目通用)                            │
│                                                                  │
│   低      项目内存(本地) ./CLAUDE.local.md        仅你自己      │
│                        (当前项目专用)                            │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────────┐
│                    内存加载流程                             │
├────────────────────────────────────────────────────────────┤
│                                                            │
│  1. 企业策略（最先加载，作为基础）                         │
│     ↓                                                      │
│  2. 用户内存（个人偏好覆盖企业策略）                       │
│     ↓                                                      │
│  3. 项目内存（项目规则覆盖用户偏好）                       │
│     ↓                                                      │
│  4. 项目规则（与项目内存同级，模块化组织）                 │
│     ↓                                                      │
│  5. 项目内存-本地（最具体，最高优先级）                    │
│                                                            │
│  原则：越具体的规则，优先级越高                            │
│                                                            │
└────────────────────────────────────────────────────────────┘

# 项目说明

## 技术栈
- React 18 + TypeScript
- TailwindCSS
- Vite

## 常用命令
- npm run dev - 启动开发服务器
- npm run build - 构建
- npm test - 运行测试

# 电商平台项目说明

## 技术栈
- 前端：Next.js 14 + TypeScript + TailwindCSS
- 后端：Node.js + Express + PostgreSQL
- ORM：Prisma

## 目录结构

## 代码规范
- 使用 2 空格缩进
- 组件文件用 PascalCase 命名（如 `UserProfile.tsx`）
- 工具函数用 camelCase 命名（如 `formatDate.ts`）
- 每个组件都要有对应的测试文件

## 禁止事项
- 不要直接修改 `src/generated` 目录
- 所有 API 调用必须经过 `src/lib/api-client.ts`
- 不要在组件中直接使用 `fetch`，使用封装好的 API 客户端

## 常用命令
- `npm run dev` - 启动开发服务器
- `npm run build` - 构建生产版本
- `npm test` - 运行测试
- `npm run lint` - 代码检查
- `npx prisma studio` - 打开数据库管理界面

## Git 工作流
- 功能分支命名：`feature/功能名`
- 修复分支命名：`fix/问题描述`
- 提交信息格式：`type(scope): 描述`
  - type: feat|fix|docs|style|refactor|test|chore

claude

> 帮我创建一个商品列表组件

# 项目说明

## 项目概述
参见 @README.md

## 可用命令
参见 @package.json

## Git 工作流
参见 @docs/git-workflow.md

## 补充说明
- 所有 API 必须有错误处理
- 测试覆盖率要求 80% 以上

# 项目说明

## 团队规范
（这里写团队共同遵守的规则）

## 个人偏好
@~/.claude/my-project-preferences.md

┌────────────────────────────────────────────────────────────┐
│                    @import 注意事项                         │
├────────────────────────────────────────────────────────────┤
│                                                            │
│  ✅ 支持：                                                 │
│     • 相对路径：@./README.md                               │
│     • 绝对路径：@/path/to/file.md                          │
│     • 用户目录：@~/.claude/config.md                       │
│     • 递归导入：最多 5 层                                   │
│                                                            │
│  ❌ 不支持：                                               │
│     • 代码块内的导入：`@anthropic-ai/claude-code`         │
│     • 代码跨度内的导入                                     │
│                                                            │
│  💡 提示：使用 /memory 命令查看实际加载了哪些文件          │
│                                                            │
└────────────────────────────────────────────────────────────┘

❌ 一个大文件的问题：
- 难以找到特定规则
- 团队协作容易冲突
- 规则职责不清晰

your-project/
├── .claude/
│   ├── CLAUDE.md           # 主配置文件
│   └── rules/
│       ├── code-style.md   # 代码风格
│       ├── testing.md      # 测试规范
│       ├── api.md          # API 开发规范
│       └── security.md     # 安全要求

# 代码风格规范

## 命名约定
- 组件：PascalCase（如 `UserProfile.tsx`）
- 函数：camelCase（如 `getUserById`）
- 常量：UPPER_SNAKE_CASE（如 `MAX_RETRY_COUNT`）
- 文件：与导出的主要名称一致

## 格式化
- 使用 2 空格缩进
- 语句末尾不加分号
- 字符串优先使用单引号
- 最大行宽 100 字符

## 注释
- 公共函数必须有 JSDoc 注释
- 复杂逻辑必须有行内注释说明
- TODO 注释格式：`// TODO(username): 描述`

# 测试规范

## 测试文件位置
- 单元测试：与源文件同目录，`.test.ts` 后缀
- 集成测试：`tests/integration/` 目录
- E2E 测试：`tests/e2e/` 目录

## 测试覆盖率要求
- 整体覆盖率：≥ 80%
- 核心业务逻辑：≥ 90%
- 工具函数：≥ 70%

## 测试命名
- describe 块：描述被测试的模块/函数
- it 块：描述测试场景，使用"应该..."句式

---
paths: src/api/**/*.ts
---

# API 开发规范

这些规则只在处理 `src/api/` 目录下的 TypeScript 文件时生效。

## 通用要求
- 所有 API 端点必须包含输入验证
- 使用标准错误响应格式
- 必须包含 OpenAPI 文档注释

## 错误处理
```typescript
// 标准错误响应格式
{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable message",
    "details": {}
  }
}

### 4.5 Glob 模式语法

### 4.6 规则组织最佳实践

---

## 五、用户级配置：个人偏好跨项目共享

### 5.1 创建用户级配置

在 `~/.claude/CLAUDE.md` 创建你的个人偏好：

```markdown
# 个人编码偏好

## 代码风格
- 偏好函数式编程风格
- 优先使用 const，避免 let
- 喜欢提前 return，减少嵌套

## 注释风格
- 喜欢"为什么"而不是"是什么"的注释
- 复杂逻辑必须有注释

## 常用工具
- 使用 pnpm 而不是 npm
- 使用 vitest 而不是 jest

~/.claude/rules/
├── preferences.md    # 个人偏好
└── workflows.md      # 常用工作流

项目规则 > 用户规则 > 企业策略

这意味着：
- 项目的特定规范会覆盖你的个人偏好
- 你的个人偏好会覆盖企业通用规范
- 企业策略是最基础的约束

# 前端项目配置

## 技术栈
- React 18 + TypeScript
- Vite
- TailwindCSS
- React Query

## 组件规范
- 组件放在 `src/components/`
- 页面组件放在 `src/pages/`
- 每个组件一个文件夹，包含：
  - `index.tsx` - 组件实现
  - `styles.ts` - 样式（如需要）
  - `types.ts` - 类型定义
  - `index.test.tsx` - 测试

## 状态管理
- 服务端状态：React Query
- 客户端状态：Zustand
- 表单状态：React Hook Form

## 禁止
- 不要在组件中直接调用 fetch
- 不要使用 inline styles
- 不要在渲染中定义函数

# 后端 API 配置

## 技术栈
- Node.js + Express
- TypeScript
- Prisma ORM
- PostgreSQL

## API 规范
- RESTful 风格
- 使用 `/api/v1/` 前缀
- 统一错误响应格式
- JWT 认证

## 目录结构

## 禁止
- 不要在控制器中直接写业务逻辑
- 不要在代码中硬编码配置
- 不要跳过输入验证

# 全栈项目配置

## 架构
- 前端：Next.js 14 App Router
- 后端：Next.js API Routes
- 数据库：PostgreSQL + Prisma
- 部署：Vercel

## 目录结构

## 规范
- Server Component 优先
- 客户端交互用 Client Component
- 数据获取用 Server Actions

# ❌ 太笼统
- 代码要写得好

# ✅ 具体明确
- 函数名要有动词前缀：getXxx, setXxx, handleXxx
- 函数长度不超过 50 行
- 嵌套深度不超过 3 层

> /memory

---
paths: **/*.{ts,tsx}
---

# 代码风格（团队共识）

以下规范经过团队讨论确定，请遵守：
- 分号：不加
- 引号：单引号
- 缩进：2 空格

讨论记录：#123

---
paths: src/legacy/**
---

# 遗留代码处理规则

处理 src/legacy 目录时：
- 优先重构而不是修补
- 修改前先写测试
- 每次只改一个小模块

# [项目名称]

## 一句话描述
[这个项目是做什么的]

## 技术栈
- [列出主要技术和版本]

## 代码规范
- 命名：[你的命名规范]
- 格式：[缩进、分号等]
- 测试：[测试要求]

## 常用命令
- `npm run dev` - 启动开发
- `npm test` - 运行测试

## 禁止
- [列出不能做的事]

claude

> 这个项目用的是什么技术栈？

> 我们的代码规范是什么？

---
paths: src/api/**
---

# API 开发规范

所有 API 相关代码必须：
1. 包含错误处理
2. 添加请求验证
3. 编写单元测试

# 企业开发规范

## 安全要求
- 禁止在代码中硬编码密钥
- 所有用户输入必须验证
- 使用参数化查询防止 SQL 注入

## 合规要求
- 代码变更必须经过 Code Review
- 敏感数据操作必须有审计日志
- 遵循 OWASP Top 10 安全指南

## 技术栈要求
- 后端：Node.js 18+
- 前端：React 18+
- 数据库：PostgreSQL

# [项目名称] 配置

## 技术栈
- [框架] + [语言]
- [数据库]
- [其他工具]

## 目录结构

## 代码规范
- [命名规范]
- [格式规范]
- [注释规范]

## 常用命令
- `[命令]` - [用途]

## 禁止事项
- [禁止1]
- [禁止2]

## 参考
- @README.md
- @package.json