🛠️ 零基础用 Claude Code 做出第一个小程序 · 第 1 周:从零到第一个上线的网页

CLAUDE.md 怎么写:让 Claude Code 记住项目规则(模板 + 反例)

写一次,它每次启动都先读

一句话先懂 · TL;DR

CLAUDE.md 是 Claude Code 每次启动都会读的项目说明。写清技术栈、常用命令、红线和「这次不做」,它就不会反复犯同样的错。附零基础可抄的模板和三个常见写坏的例子。

为什么它总是忘

你今天告诉它「别用框架,只用一个 html」,明天重新启动,它又给你装了一堆东西。不是它笨,是每次启动都是一次新对话,昨天说的它不记得。

解决办法是在项目文件夹里放一个 CLAUDE.md。它每次启动都会先读这个文件,把里面的规矩当成默认前提。

🔆CLAUDE.md 就是贴在实习生工位上的那张「本组规矩」:用什么工具、怎么跑测试、哪些事绝对不能干。新来的人不用你每天重复。

最小的 CLAUDE.md 长这样

在 Claude Code 里输入 /init,它会扫一遍你的项目,帮你生成一份初稿。然后你按下面三块检查和补充:技术栈、常用命令、红线

# 待办清单网页

## 技术栈
- 单个 index.html,原生 HTML/CSS/JS,不引入任何框架和外部库
- 数据存浏览器 localStorage

## 怎么跑
- 直接用浏览器打开 index.html
- 改完先在手机竖屏(或窄窗口)看一遍

## 红线
- 不要新增文件,所有代码留在 index.html 里
- 界面文字全部中文
- 改功能前先说明会动哪些部分,等我确认

## 这次不做
- 登录、多用户、云同步

什么该写,什么不该写

判断标准一句话:一个月后还成立的写,只对今天有效的不写。

- ✅ 「所有界面文字用中文」:一个月后还成立。
- ✅ 「改动前先说明范围等我确认」:稳定的协作方式。
- ❌ 「今天把删除按钮做完」:明天就过期,写进去反而误导它。
- ❌ 把整份需求文档贴进去:太长,它每次都要读,重点被淹没。

⚠️CLAUDE.md 越长越没用。超过一屏,就该问自己哪些是临时的、哪些是它本来就会的。

自测 · 学完检查一下

想真正动手做题、记进度、攒连胜?到互动课里练。

小赵每次启动 Claude Code 都要重新说一遍「界面用中文、不要引入外部库」。根本的解决办法是?

答案:把这两条写进项目里的 CLAUDE.md,它每次启动自动读

稳定不变的规则就该写进 CLAUDE.md。复制粘贴是在用人肉做文件该做的事;换模型不解决「新对话没记忆」的机制问题;永远不关终端既不现实,对话太长它反而更容易走神。

一份最小可用的 CLAUDE.md,至少要有哪三块?

答案:技术栈、怎么跑(常用命令)、红线

这三块回答了它最常问的三个问题:用什么做、怎么验证、什么不能碰。任务清单是临时的不该放这里;代码它自己会读,不用抄进来。

下面哪一条最不该写进 CLAUDE.md?

答案:「本周三之前把导出 Excel 功能做完」

这是一个有截止日期的任务,下周就失效,写进长期规则里只会让它困惑。金额单位、测试命令、禁改目录都是一个月后依然成立的规矩,正是 CLAUDE.md 该放的。

判断:为了让 AI 了解得更全面,应该把整份 30 页的需求文档原文粘进 CLAUDE.md。

答案:

它每次启动都要读完 CLAUDE.md,30 页会把「不要新增文件」这种关键红线淹没。需求文档单独放一个文件,在 CLAUDE.md 里写一句「需求见 docs/requirements.md,做功能前先读对应章节」即可。

小刘的 CLAUDE.md 只写了技术栈。AI 每次改完代码就直接说「完成」,他要自己猜怎么验证。该补哪一块?

答案:「怎么跑」:写清打开方式和验证步骤,它做完就会照着自测

它不知道怎么验证,就只能说「完成」。把「用浏览器打开 index.html,手机竖屏检查」写进去,它改完会自己跑一遍,把明显的问题拦在你验收之前。

想边练边学,而不只是读?

到互动课里答题、记进度、攒连胜——游客即可试学,无需注册。

进入互动课程 →

学点新东西,不错过更新

新课程、新功能、学习小技巧——偶尔一封,随时退订。