Claude Code 的 CLAUDE.md 入门模板：防止重复失误的最小文件

薄弱的 CLAUDE.md 会让每次会话都从冷启动开始

如果你每次都要重新告诉 Claude Code 项目规则，问题不只是提示词。项目需要一个小的操作手册，记录命令、边界、禁止触碰的区域和完成标准。

这份模板适合已有代码库。它和 First Task Runbook 搭配使用，可以让第一轮工作更稳定。

入门模板应该包含什么

不需要写成长篇政策文件。先写清楚技术栈、常用命令、风险路径、输出偏好和完成条件。

# CLAUDE.md

## Project snapshot
- stack: Astro + TypeScript
- package manager: npm
- main app: site/

## Commands
- dev: cd site && npm.cmd run dev
- build: cd site && npm.cmd run build

## Guardrails
- do not touch: .env, dist, generated exports
- ask before: destructive git commands, production deploys, secret rotation

## Definition of done
- code change is applied
- verification command has run
- remaining risks are stated

这个版本足够短，也足够让下一次 Claude Code 会话少走弯路。

内容网站的例子

如果是 Astro 多语言网站，可以补充：所有语言使用同一个 slug，pubDate 和 updatedDate 要一致，必须设置 heroImage，发布后检查 live URL 的 h1、canonical、正文语言和 CTA 链接。

最需要避免的失败是：每个语言文件都存在，但非英文页面正文仍然是英文。frontmatter 正确不代表文章真的完成。

什么时候增加规则

CLAUDE.md 不是越长越好。重复出现两次的问题，才值得变成一条固定规则。比如 build 经常忘，就加命令；多语言漂移，就加发布规则；review 太浅，就加评审标准。

下一步

如果只是需要命令提醒，先拿 免费 cheatsheet。如果瓶颈是权限、hooks、MCP 或 CLAUDE.md 质量，购买 Setup Guide。如果要给团队制定使用规则，看 咨询页面。