CLAUDE.md 实战配置技巧：让 AI 编程助手更听话

为什么 CLAUDE.md 重要？

CLAUDE.md 是 Claude Code 的"性格设定文件"。写好它，Claude 会按你的方式工作；写不好，每次对话都要重复纠正。

Santiago 的配置模板

规划优先

## 工作流程
- 在写任何代码之前，先描述你的方案并等待我的批准
- 如果需求不明确，始终先问澄清问题
- 对于涉及多文件的修改，先列出影响范围

代码质量

## 代码标准
- 不要添加我没要求的功能
- 不要添加不必要的注释和文档
- 优先编辑现有文件，不要创建新文件
- 如果一个改动超过 100 行，拆分成更小的步骤

测试策略

## 测试
- 每次功能修改后运行相关测试
- 不要 mock 数据库（我们用测试数据库）
- 测试文件放在 __tests__ 目录下

项目特定

## 技术栈
- Next.js 15 App Router（不要用 Pages Router）
- TypeScript strict mode
- Tailwind CSS（不要写内联样式）
- PostgreSQL + Drizzle ORM

## 目录结构
- API routes: app/api/
- Components: components/
- Database: db/
- Types: types/

分层配置

Claude Code 支持三层配置：

1. ~/.claude/CLAUDE.md — 全局偏好（所有项目）
2. 项目根目录/CLAUDE.md — 项目级规范
3. 子目录/CLAUDE.md — 模块级规则

Pro Tips

• 写具体的规则，不要写模糊的期望
• 用"不要"比"请"更有效
• 定期更新，删除过时的规则

来源: @svpino Santiago 的实践分享