CLAUDE.md 怎么写

别担心，为 CLAUDE.md 这个文件感到无从下手，其实很正常。把它想象成给 Claude Code 的一份备忘录或者团队新人的入职指南，目的是让它一开始就知道你的工作习惯和任务目标，而不是每次都从头开始。

最关键的是，你不需要从头写起。直接用 /init 命令就能自动生成一个基础版本，你只需要在这个基础上修改就行。

CLAUDE.md 是什么？

简单说，CLAUDE.md 是一个用 Markdown 格式写的文本文件，在每次对话开始时，Claude 会自动读取它。有了它，Claude Code 就能：

· 理解上下文：不用你反复解释“我在做啥”、“我们的规范是啥”。 · 遵循偏好：按你喜欢的格式和风格来完成任务。 · 执行标准命令：按照你预定义好的指令去执行操作。

如何用 /init 快速起步？

在你的工作目录下打开终端（Terminal），输入 claude 并回车，启动 Claude Code。
在输入框中直接输入命令 /init，并回车。
Claude Code 会扫描目录里的文件，并自动创建一个名为 CLAUDE.md 的基础文件。

这就是你的起点。用文本编辑器（比如记事本、VS Code）打开它，然后根据后面的模板去调整和精简，效果会更好。

我的 CLAUDE.md 该怎么写？

关键是根据你的任务来写。我为你准备了两个模板，可以直接参考或修改。

通用模板：用于文档撰写、文件整理等

如果你主要用 Claude 来处理文档或日常办公文件，这个模板很适合作为基础。

# 项目定位：一个用于日常办公文件处理的个人工作区。
这个文件夹包含了我工作中需要处理的各类文档、表格和报告。

# ⚠️ 核心安全规则
1.  **所有修改前必须先备份。** 在编辑任何重要文件前，你必须先为该文件在 `_backups/` 文件夹下创建一个副本，以防我反悔。
2.  **严禁操作以下文件/文件夹：** `~/Desktop`、`~/Documents/Important`。
3.  **所有操作必须经过我确认。** 在删除或移动任何文件前，必须询问我。

# 📄 文档处理规范
1.  **风格与格式：** 使用 Markdown 编写，语气正式、专业。
2.  **文档结构：** 必须包含标题、简介、每个步骤的详细说明和一张示例截图。
3.  **文件命名：** 按照 "YYYY-MM-DD-项目名称-版本号.md" 的格式命名。
4.  **图片处理：** 所有截图统一保存到 `./images/` 文件夹，并使用相对路径引用。

# 💻 常用操作
1.  **当你需要我写一个新文档时，请按此流程操作：**
    1.  先跟我确认文档的大纲和目录结构。
    2.  根据确认好的大纲，生成完整的 Markdown 内容。
    3.  提醒我检查并插入必要的截图。

2.  **当你需要整理或重命名文件时，请按此流程操作：**
    1.  先分析当前文件夹下的文件类型和命名规律。
    2.  生成一份重命名方案的表格供我确认。
    3.  我确认后，再执行批量重命名操作。

浏览器自动化模板：用于网页操作、信息搜集

如果你想让 Claude 帮你自动操作网页，这个模板会更对路。

# 项目定位：浏览器自动化任务配置。
本目录包含用于自动化完成网页登录、信息填报、数据抓取等任务的相关配置。

# 🌐 浏览器自动化核心指令
1.  **首选工具：** 使用 Playwright MCP 来控制浏览器。
2.  **任务拆解：** 在开始任何自动化任务前，先将复杂任务拆解成清晰的步骤（如：打开网页 -> 点击登录按钮 -> 输入用户名密码 -> 点击提交）。
3.  **安全策略：** 绝对不允许在任何脚本或文件中明文存储我的任何密码。

# 💡 典型工作流：以“自动登录并抓取信息”为例
1.  **导航**：打开目标网址。
2.  **登录**：使用 `page.fill()` 方法输入用户名和密码（你需要协助我安全地获取这些凭据），然后用 `page.click()` 点击登录按钮。
3.  **等待**：使用 `page.wait_for_selector()` 确保页面加载完成。
4.  **抓取**：定位并提取我指定的数据内容。
5.  **输出**：将抓取到的数据保存为 JSON 或 CSV 文件到本地。
6.  **清理**：关闭浏览器。

# 🛠️ 常用命令参考
*   `page.goto()` - 打开网页
*   `page.fill()` - 在输入框内填写文本
*   `page.click()` - 点击页面上的某个按钮或链接
*   `page.screenshot()` - 截取当前屏幕

小技巧：如何让 Claude 帮你改进 CLAUDE.md？

其实，最好的文档是在和 AI 的协作中“聊”出来的。你完全可以直接用自然语言来生成和优化它。

比如，你可以直接在 Claude Code 对话框中输入：

· “我日常工作就是处理这些表格，帮我优化一下 CLAUDE.md，让它更懂我的需求。” · “以后处理文档时，请把所有的原始文件备份到 backup_2026 文件夹，帮我更新到 CLAUDE.md 里。” · “我现在需要你用浏览器自动打开百度并搜索‘今天天气’，我需要把这个任务自动化，应该怎么写？”

当你有了初稿后，就把它放在项目根目录下，命名为 CLAUDE.md（注意大小写和扩展名），并和你的文档放在一起。之后，每次在终端里用 claude 命令启动时，它都会自动读取这份指南，效果就和你交代过一样。

记住，对非开发人员来说，最关键的是 “告诉 AI 你想要什么，而不是纠结于代码怎么写”。CLAUDE.md 就是你最得力的“翻译官”，把你的意图清晰地传递给 AI。如果写的过程中还有什么不清楚的地方，随时都可以再来问我～