Claude Code 第一讲 - CLAUDE.md：AI 的个人说明书

2025-08-20

什么是 CLAUDE.md？

想象一下，你刚雇了一个新助手，第一天上班你会给他一份"工作指南"，告诉他你喜欢怎么做事、文件放在哪里、哪些事情不要碰。CLAUDE.md 就是你给 AI 助手 Claude 的这份"工作指南"。

这是一个简单的文本文件，放在你的文件夹里，告诉 Claude：

你的喜好：比如"我喜欢图表用蓝色"、"报告要简洁不超过一页"
文件位置："重要数据在'销售数据'文件夹"、"图片素材在'素材库'"
隐私界限："不要读取'个人'文件夹"、"不要分享带密码的文件"
工作方式："每周五生成周报"、"Excel表格要带图表"

CLAUDE.md 有什么用？

省时省力：不用每次都重复解释你想要什么，Claude 记住你的习惯
个性化帮助：Claude 会按照你的喜好工作，就像熟悉你多年的助手
保护隐私：明确告诉 Claude 哪些内容不能碰，更安心
提高效率：Claude 能直接按你的方式整理文件、生成报告
智能建议：了解你的习惯后，Claude 能提供更符合你需求的建议

就像你的私人助理备忘录

有了 CLAUDE.md，Claude 就能：

记住你的工作习惯，不用反复教
按照你喜欢的方式整理信息
知道哪些是重要文件，哪些不能动
自动化你常做的任务，比如生成周报、整理数据

一键生成 CLAUDE.md

打开终端
- Mac：Command+空格 → 输入"终端"
- Windows：开始菜单 → 输入"cmd"
进入项目文件夹
```
cd 你的项目路径
```
执行初始化命令
```
claude /init
```

Claude 会自动扫描当前目录，生成一个包含以下内容的 CLAUDE.md 文件：

# 项目简介
这是一个8月销售报表文件夹。

# 常用指令
- 把CSV文件转换成Excel放在 ./output
- 图表请用蓝色主题
- 不要上传任何含"工资"字样的文件

主要优势

自动生成：识别目录结构，30秒完成设置
简单易用：全中文提示，无需编程知识
便于迁移：换设备时带上这个文件，保留所有设置

自定义规则与高级配置

CLAUDE.md 支持多种配置选项，可以根据项目需求进行精细调整。直接用任何文本编辑器（记事本、VS Code等）打开并编辑：

基本规则示例

# 项目规范
- 使用 TypeScript 严格模式
- 组件采用函数式编程风格
- 遵循 ESLint 配置的代码风格

# 文件处理规则
- 把日报生成PDF后自动发到微信群（文件路径：./日报/）
- 数据分析结果存放在 ./analytics 目录

高级配置示例

# 代码审查标准
- 所有公共API必须有JSDoc注释
- 单元测试覆盖率不低于80%
- 不允许使用any类型

# 项目特定约定
- 状态管理使用Redux
- API请求使用自定义hooks
- 错误处理遵循集中式日志记录

保存后立即生效，下次对话 Claude 会遵循新规则。

CLAUDE.md 在不同场景中的应用

软件开发项目

# 项目架构
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：MongoDB

# 代码规范
- 遵循 Airbnb JavaScript 风格指南
- 组件使用函数式编程
- 使用 Jest 进行单元测试

# 目录结构
- src/components: UI组件
- src/services: API调用
- src/utils: 工具函数

数据分析项目

# 数据目录：./data/sales
# 输出格式：所有图表使用蓝色主题，导出为PNG格式
# 分析标准：使用95%置信区间，异常值定义为3个标准差以外

个人项目

# 隐私：不读取./private目录
# 文件格式：只处理.csv和.xlsx
# 输出偏好：简洁报告，重点突出异常值

将这些配置添加到你的 CLAUDE.md 中，Claude 就能按照你的项目标准和个人偏好工作，大幅提高协作效率。

小结

CLAUDE.md = 项目标准和个人偏好的定义文件
一键生成：使用 /init 命令快速创建基础配置
高度可定制：从简单规则到复杂项目规范都能支持
即时生效：修改后立即应用，无需重启或复杂设置
团队共享：将配置纳入版本控制，确保团队一致性

想使用 GPT-5 赋能你的 Claude Code？

如果你希望使用 OpenAI 原生的 GPT-5 模型来增强 Claude Code 的能力，可以通过 Claude Code Proxy 实现。这种方式能让你：

利用 GPT-5 的强大能力辅助编程
保持 Claude Code 的界面和工作流程
获得更精准的代码补全和建议

注意：此方法仅支持 OpenAI 原生 GPT-5 模型，确保最佳兼容性和性能。

详细配置方法请参考我们的文章：Claude Code Proxy 使用指南