Use Claude Code

让它记规矩

让它记规矩这一页讲的，就是让它记规矩这件事在 Claude Code 里到底怎么用。

页面信息

对应原页

让它记规矩

页面性质

第三方中文解释页

使用建议

先看人话解释，再对照原页命令和代码

这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。

如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。

这一页先讲明白

这一页讲 Claude Code 的“记性”从哪儿来。

一个是你写的 `CLAUDE.md`，一个是它逐步积累的 auto memory。

`CLAUDE.md` 像贴在墙上的家规，适合写团队都要遵守的规则。auto memory 像老帮工的小本子，适合记干活过程中学到的经验。

两者都很有用，但职责不同，别混着写。

长期规则写进 `CLAUDE.md`，临场经验让 auto memory 慢慢积累。

规则文件要短而硬，写真正影响结果的东西，不要把大段废话也塞进去。

CLAUDE.md 最适合写什么

写团队共识和硬规则最值。

- 常用构建命令
- 测试命令
- 代码风格要求
- 架构边界
- 审查清单

预留广告位

正文中段响应式广告 等你后面真接 AdSense，这里再放正式广告。

Documentation Index

这里不是让你背"Documentation Index"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

CLAUDE.md vs auto memory

这一段主要是在把"CLAUDE.md vs auto memory"讲实，不是只摆个标题给你看。

如果你打算把外接能力往里挂，这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

CLAUDE.md files

这一段主要是在把"CLAUDE.md files"讲实，不是只摆个标题给你看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

When to add to CLAUDE.md

When to add to CLAUDE.md 到底什么时候值得上，这一段就是在算这笔账。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Choose where to put CLAUDE.md files

看这段时就盯一个事：到底该选哪条更合适。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Set up a project CLAUDE.md

这段就是开工前的准备清单，先把地基打好。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Write effective instructions

这一块主要是在说"Write effective instructions"真到手上该怎么用，哪里最容易踩坑。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Import additional files

看到这里，就把"Import additional files"当成一件真要上手的活来看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Import additional files 1

这一段说完，最后还得写到配置里才算真的生效。

See @README for project overview and @package.json for available npm commands for this project.

# Additional Instructions
- git workflow @docs/git-instructions.md

终端里敲

Import additional files 2

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

# Individual Preferences
- @~/.claude/my-project-instructions.md

AGENTS.md

这一块主要是在说"AGENTS.md"真到手上该怎么用，哪里最容易踩坑。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

关键片段

AGENTS.md

"AGENTS.md"这一段里最要紧的原始写法在下面，先看它怎么落地。

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

How CLAUDE.md files load

这里不是让你背"How CLAUDE.md files load"这个词，而是让你看它真干活时怎么使。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

关键片段

How CLAUDE.md files load

下面这块是这一段最值钱的原文样板，先对着看一眼。

CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir ../shared-config

Organize rules with .claude/rules/

看到这里，就把"Organize rules with .claude/rules/"当成一件真要上手的活来看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

目录怎么摆

Organize rules with .claude/rules/ 1

这一段主要是认目录和文件摆放位置。先把地方放对，后面才不容易串。

your-project/
├── .claude/
│   ├── CLAUDE.md           # Main project instructions
│   └── rules/
│       ├── code-style.md   # Code style guidelines
│       ├── testing.md      # Testing conventions
│       └── security.md     # Security requirements

改配置

Organize rules with .claude/rules/ 2

这一段说完，最后还得写到配置里才算真的生效。

---
paths:
  - "src/api/**/*.ts"
---

# API Development Rules

- All API endpoints must include input validation
- Use the standard error response format
- Include OpenAPI documentation comments

改配置

Organize rules with .claude/rules/ 3

这一段说完，最后还得写到配置里才算真的生效。

---
paths:
  - "src/**/*.{ts,tsx}"
  - "lib/**/*.ts"
  - "tests/**/*.test.ts"
---

终端里敲

Organize rules with .claude/rules/ 4

这一段不是只让你理解意思，下面这条命令就是现在要跑的。

ln -s ~/shared-claude-rules .claude/rules/shared
ln -s ~/company-standards/security.md .claude/rules/security.md

Manage CLAUDE.md for large teams

这段主要是在说平时怎么管，不是光教你怎么开。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Manage CLAUDE.md for large teams

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

{
  "claudeMdExcludes": [
    "**/monorepo/CLAUDE.md",
    "/home/user/monorepo/other-team/.claude/rules/**"
  ]
}

Auto memory

这里不是让你背"Auto memory"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Enable or disable auto memory

看到这类标题，就当是在调一个具体开关。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Enable or disable auto memory

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

{
  "autoMemoryEnabled": false
}

Storage location

这里不是让你背"Storage location"这个词，而是让你看它真干活时怎么使。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

改配置

Storage location 1

光知道意思还不够，这里得把规矩落进配置里，下面这块照着填。

{
  "autoMemoryDirectory": "~/my-custom-memory-dir"
}

目录怎么摆

Storage location 2

这一段主要是认目录和文件摆放位置。先把地方放对，后面才不容易串。

~/.claude/projects/<project>/memory/
├── MEMORY.md          # Concise index, loaded into every session
├── debugging.md       # Detailed notes on debugging patterns
├── api-conventions.md # API design decisions
└── ...                # Any other topic files Claude creates

How it works

这里讲底层是怎么运转的。你把它看明白，后面遇到异常时就知道该往哪儿查。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Audit and edit your memory

这一段主要是在把"Audit and edit your memory"讲实，不是只摆个标题给你看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

View and edit with /memory

这段看着像个标题，其实是在说"View and edit with /memory"管到哪儿。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Troubleshoot memory issues

遇到这种内容，别急着大拆大改，先按它给的路子把问题缩小。

如果你打算把外接能力往里挂，这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

Claude isn’t following my CLAUDE.md

这一块主要是在说"Claude isn’t following my CLAUDE.md"真到手上该怎么用，哪里最容易踩坑。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

I don’t know what auto memory saved

这一段是在把 /memory and select the auto memory folder to browse what Claude has saved. Everything is plain markdown you can read, edit, or delete. 真跑起来。别只看命令长什么样，还得看跑完该出现什么。

看这段时要特别盯工具和权限边界，别为了省事一把全开。

My CLAUDE.md is too large

这一段主要是在把"My CLAUDE.md is too large"讲实，不是只摆个标题给你看。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Instructions seem lost after /compact

这一块主要是在说"Instructions seem lost after /compact"真到手上该怎么用，哪里最容易踩坑。

这里还牵扯作用域，意思就是这条规则到底管当前项目、你个人，还是只管这一趟会话。

Related resources

这一段主要是在把"Related resources"讲实，不是只摆个标题给你看。

如果你打算把外接能力往里挂，这里提到的 hooks、MCP、skills、memory 都要分清各自负责哪一摊。

照着做一遍

如果你不想来回翻，就先照这几步顺着做。

每做完一步就看一下结果，再决定要不要继续往下。

第 1 步：CLAUDE.md 最适合写什么

写团队共识和硬规则最值。

- 常用构建命令
- 测试命令
- 代码风格要求
- 架构边界
- 审查清单

一眼看懂这一页

这页的作用，就是把原本偏专业的话题，拆成能直接照着走的明白话。

让它记规矩
   |
   v
让它记规矩 这一页讲的，就是 让它记规矩 这件事在 Claude Code 里到底怎么用。
   |
   v
照着步骤去做

文末提醒

这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。

人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。