CLAUDE.md 是 Claude Code 的系统提示词—— 每次 Claude 启动时都会自动读取它，作为对话的背景知识。 把它理解为你写给 AI 队友的"新人入职文档"： 项目是什么、用了哪些技术、有哪些规矩必须遵守。

一份好的 CLAUDE.md 包含什么

CLAUDE.md 示例

# CLAUDE.md — 项目指令文件

## 项目概述
这是一个用 Hugo + PaperMod 主题构建的个人技术博客。
内容以 AI、系统设计和编程学习笔记为主。

## 技术栈
- 静态站点生成器: Hugo
- 主题: PaperMod (自定义扩展)
- 部署: GitHub Pages
- 内容格式: Markdown + HTML (纸感学术风)

## 编码规范
- HTML 文件使用 CSS namespace 隔离样式 (如 .day01-wrap)
- 每个页面的 CSS 写在页面内部 <style> 标签中
- 颜色使用 CSS 变量: --ivory, --clay, --slate 等
- 中文内容为主，代码和命令用英文

## 常用命令
- hugo server -D --port 1313  # 本地预览
- hugo                        # 构建静态文件

## 禁忌
- 不要修改 themes/ 目录下的原始主题文件
- 不要在 CSS 中使用 !important
- 不要创建 README 或文档文件除非明确要求

## 行为偏好
- 回复用中文
- 优先使用 Edit 而非 Write 修改文件
- 修改文件前先 git commit 当前状态

三级层叠机制

CLAUDE.md 不只有项目根目录一份——它有三个层级，像 CSS 一样层叠生效。

CLAUDE.md 告诉 Claude 应该怎么做， settings.json 告诉 Claude 被允许做什么。 它是权限控制的核心——哪些工具可以自动执行、哪些环境变量可用、哪些命令被禁止。

配置层级

settings.json 结构

// .claude/settings.json — 项目级权限配置
{
  // 允许自动执行的 Bash 命令前缀
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run lint)",
      "Bash(git status)",
      "Bash(git diff)",
      "Bash(git log)",
      "Bash(ls)",
      "Bash(find)",
      "Bash(grep)"
    ],
    "deny": [
      "Bash(rm -rf)",
      "Bash(git push --force)",
      "Bash(git reset --hard)"
    ]
  },

  // 环境变量
  "env": {
    "NODE_ENV": "development"
  }
}

.claude/ 是 Claude Code 在你项目中的"家"—— 所有配置、自定义扩展和运行时数据都住在这里。 今天先认识每个文件的作用，后续课程会深入每个子目录。

CLAUDE.md 是你手动写的指令， Memory 是 Claude 自动学习的知识。 它在对话过程中捕捉你的偏好、纠正和项目上下文，保存为持久化的记忆文件， 在后续对话中自动加载。

Memory 的工作方式

# 查看当前 Memory
> /memory
# 显示所有已保存的记忆条目

# 手动要求记忆
> 记住: 这个项目的测试框架是 Vitest 而不是 Jest
# Claude 会保存到 Memory 文件中

# 自动学习 (你不需要做任何事)
> 不要用 var，用 const 和 let
# Claude 可能自动记住你的编码偏好

# 要求遗忘
> 忘掉关于测试框架的记忆
# Claude 会找到并删除相关记忆

Memory 的四种类型

今天的练习全都有持久化的产出—— 你写的 CLAUDE.md 和配置的 settings.json 会在后续所有课程中持续生效。

Lab 1 — 用 /init 生成 CLAUDE.md

让 Claude 分析你的项目并自动生成初稿。

# 进入你的项目目录
$ cd ~/my-project
$ claude

# 运行 /init 自动分析项目
> /init
# Claude 会读取 package.json、目录结构等
# 然后生成一份 CLAUDE.md 初稿

# 查看生成的文件
> 读一下 CLAUDE.md 的内容

Lab 2 — 手动完善 CLAUDE.md

/init 生成的内容通常需要补充——添加你的个人偏好和团队规范。

# 让 Claude 帮你完善 CLAUDE.md
> 在 CLAUDE.md 中添加以下规则:
> 1. 回复用中文
> 2. commit message 用英文
> 3. 优先使用 Edit 而非 Write
> 4. 修改代码前先跑一次测试

# 验证: 开一个新对话测试效果
$ claude
> 你知道这个项目用的什么技术栈吗？
# Claude 应该能准确回答 (来自 CLAUDE.md)

Lab 3 — 配置权限规则

设置一些安全的自动允许规则，减少重复确认。

# 方法 1: 通过对话让 Claude 帮你配置
> 在 .claude/settings.json 中添加以下 allow 规则:
> git status, git diff, git log, ls, find, grep

# 方法 2: 在日常使用中积累
# 当权限确认弹出时，选择 Always Allow
# 规则自动写入 settings.local.json

# 查看当前配置
> /config

Lab 4 — 测试 Memory

告诉 Claude 一些偏好，然后新建对话验证记忆是否生效。

# 对话 1: 建立记忆
> 记住: 我更喜欢用 early return 而不是深层嵌套
> 记住: 这个项目的数据库是 PostgreSQL 15
> /memory
# 查看是否保存成功

# 退出并开启新对话
$ claude

# 对话 2: 验证记忆
> 你知道我对代码风格有什么偏好吗？
# Claude 应该提到 early return 偏好
> 项目用的什么数据库？
# Claude 应该回答 PostgreSQL 15

1. CLAUDE.md 的三级层叠机制是什么？当同一条规则在项目级和子目录级冲突时，哪个优先？
2. settings.json 和 settings.local.json 的区别是什么？各自适合放什么内容？
3. CLAUDE.md 和 Memory 的关系是什么？各自适合存储什么类型的信息？
4. .claude/ 目录下有哪些文件和子目录？哪些会提交 Git，哪些不会？
5. 如果你需要让 git status 和 npm test 在 Prompt 模式下自动执行（不弹确认），你会怎么配置？