CLAUDE.md 模板大全：50+ 框架模板示例
浏览 50+ 真实 CLAUDE.md 模板：React、Python、Go、TypeScript、Next.js 等框架，复制到项目根目录即可配置 Claude Code。
William Wang — TokRepo & GEOScore AI 创始人，专注 AI 开发者工具和搜索可见性。
了解如何使用 CLAUDE.md 模板为任何框架配置 Claude Code。本指南提供 50+ 按语言和框架组织的真实示例，以及编写自己模板的最佳实践。
前置条件
- 已安装 Claude Code
- 一个需要配置 Claude Code 行为的项目
- 基本了解你使用的框架约定
什么是 CLAUDE.md？
CLAUDE.md 是放在项目根目录的配置文件，告诉 Claude Code 如何与你的代码库协作。Claude Code 启动会话时自动读取此文件，理解项目约定、架构、首选模式和约束。
可以把它理解为 AI 版的 .editorconfig —— 不是配置缩进和换行，而是配置 AI 助手如何理解并贡献你的项目。
touch CLAUDE.md
CLAUDE.md vs .cursorrules vs AGENTS.md
| 文件 | 工具 | 用途 |
|---|---|---|
CLAUDE.md | Claude Code | 项目上下文和编码约定 |
.cursorrules | Cursor AI | Cursor 规则和模式 |
AGENTS.md | Codex CLI | Agent 行为配置 |
所有文件服务于同一目的，内容可在格式间迁移。
模板结构
# 项目名
## 概述
[项目做什么、技术栈、架构]
## 技术栈
- 前端：[框架，版本]
- 后端：[框架，版本]
## 项目结构
[关键目录及其内容]
## 开发命令
- `npm run dev` — 启动开发服务器
## 编码约定
[语言特定模式、命名、格式]
## 重要规则
[绝对不能做的事]
各框架模板
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
完整模板内容请查看 英文版指南 或 TokRepo CLAUDE.md 模板合集。
编写最佳实践
1. 具体约束
## 差
- 遵循最佳实践
## 好
- 所有变量声明用 `const`，除非需要重新赋值
- 函数最大长度：30 行
- 每个导出函数必须有 JSDoc 注释
2. 包含实际命令
## 差
- 提交前跑测试
## 好
- 提交前运行 `npm test`
- 运行 `npm run lint:fix` 自动修复样式
3. 控制在 500 行以内
CLAUDE.md 读入上下文窗口，2000 行的文件浪费 token。保持专注于约定和约束。
FAQ
Q: 什么是 CLAUDE.md？ A: 放在项目根目录的 markdown 配置文件，告诉 Claude Code 你的编码约定、项目结构和重要约束。
Q: 必须有 CLAUDE.md 吗？ A: 不是必须，但添加后能显著提升代码质量。
Q: 放在哪里？
A: 项目根目录（和 package.json、go.mod 等同级）。Claude Code 启动时自动读取。