CLAUDE.md 模板大全：50+ 框架模板示例

一句话：CLAUDE.md 是放在项目根目录的配置文件，告诉 Claude Code 你的项目约定、架构和模式——相当于 AI 版的 .editorconfig。启动会话时自动读取。本文给标准结构和各框架模板要点。

CLAUDE.md / .cursorrules / AGENTS.md

三者目的相同，内容可以跨格式迁移，团队混用多种工具时保持内容一致。

标准模板结构

# 项目名

## 概述
[项目做什么、技术栈、架构]

## 技术栈
- 前端：[框架，版本]
- 后端：[框架，版本]

## 项目结构
[关键目录及其内容]

## 开发命令
- `npm run dev` — 启动开发服务器

## 编码约定
[语言特定模式、命名、格式]

## 重要规则
[绝对不能做的事]

touch CLAUDE.md 后按这个骨架填。

各框架模板要点

React + TypeScript — 函数组件、Tailwind、TanStack Query、Vitest。

Next.js 15（App Router） — Server Components 优先、Server Actions 做数据变更、Prisma ORM。

Nuxt 3 + Vue 3 — Composition API、<script setup>、auto-imports、SSR 安全。

Python + FastAPI — Pydantic v2、SQLAlchemy 2.0 async、uv 包管理、服务层模式。

Django 5.x — Fat Model Thin View、DRF ViewSets、select_related 防 N+1。

Go + Chi — 标准布局、sqlc 类型安全 SQL、Context 传播、table-driven tests。

Rust + Axum — thiserror 错误类型、Arc、不用 unwrap。

编写最佳实践

1. 约束要具体

## 差
- 遵循最佳实践

## 好
- 所有变量声明用 `const`，除非需要重新赋值
- 函数最大长度：30 行
- 每个导出函数必须有 JSDoc 注释

2. 包含实际命令

## 差
- 提交前跑测试

## 好
- 提交前运行 `npm test`
- 运行 `npm run lint:fix` 自动修复样式

3. 控制在 200–500 行以内

CLAUDE.md 会读进上下文窗口，2000 行的文件浪费 Token。优先写项目特有约定（架构、命名、禁止事项），通用代码风格让 linter 管。

常见问题

必须有吗？
不是必须，但加上后代码质量显著提升。

放哪里？
项目根目录（和 package.json、go.mod 同级），Claude Code 启动时自动读取。

多人协作怎么管？
和源代码一起提交 Git、纳入 PR Review。团队规范变更先改 CLAUDE.md 再改代码，保证 AI 和人的标准一致。

怎么验证生效了？
启动 Claude Code 让它复述项目三条最重要的规则，答得准就是加载成功。没生效就检查文件是否在根目录、文件名大小写是否正确。