40 行 CLAUDE.md 让 Claude Code 不再瞎来:要下指令别写描述
techpotions · reddit · 2026-09-22
Reddit 用户分享几周踩坑后总结的 CLAUDE.md 写法:多数文件失败的原因是「描述项目」而非「指挥 agent」。Claude 能读代码,读不了你的心思。
关键对比:
- ❌「本项目用 pnpm,希望工具一致」→ ✅「包管理器是 pnpm,禁止 npm/yarn」
- ❌「尽量保持类型安全」→ ✅「多文件改动后运行 pnpm typecheck」
- ❌「测试有点难跑」→ ✅「测试依赖本地 Postgres,先 docker compose up -d,否则挂 60 秒」
实用建议:
- 一条「dev server 会缓存 schema,改 db/ 后要重启」能省一整轮 debug
- Claude 犯同一个错两次,说明 CLAUDE.md 缺了一条规则
- 固定写好 non-negotiables:不许自己起 dev server、不许动 .env、不许未经确认做数据库迁移
- 利用嵌套机制:Claude 会同时读根目录和最近目录的 CLAUDE.md,可分离 workspace 规则和包规则
作者还开源了 5 份 MIT 模板(Next.js、Python、monorepo、API service、精简起步),并警告不要不加修改直接套用。
「编程与Agent」频道最新
- Reddit 热传 AI 编程 Agent 精选仓库清单，网友整理出直达链接 — alexcovo_eth · 2026-09-22
- 开源无限后室游戏 vackrooms:全程用 Claude 写成 — pablostanley · 2026-09-22
- 给 LLM 建代码库 Wiki,实测输入 token 减半 — kedar5 · 2026-09-22
- 开发者实测:Claude Code Projects 是并行干重活的最佳界面 — daniel_mac8 · 2026-09-22
- 开源项目 QM 发布 v0.1.12:Agent 集群进入 Beta — ycombinator · 2026-09-22
- 类别感知专家训练框架：SWE-bench Multilingual 达 59% — Logics-MLLM · 2026-09-22