CLAUDE.md 深度指南：四层记忆架构、@ 导入与内容取舍原则

四个加载层级，优先级从高到低

@ 导入：把记忆拆成可组合的模块

# Project Setup

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

## Additional Rules {#additional-rules}
- Git workflow: @docs/git-workflow.md
- Testing conventions: @docs/testing.md
- Personal overrides: @~/.claude/my-project-overrides.md

• 支持相对路径和绝对路径，也支持 ~/ 家目录路径
• 可递归导入，最深 5 层（被导入文件可以再导入其他文件）
• 代码块内的 @ 不会被解析，即 `@anthropic-ai/claude-code` 这类包名不会触发导入
• 运行 /memory 命令可查看当前会话实际加载了哪些记忆文件

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

# CLAUDE.md
## Core Rules {#core-rules}
@docs/rules/core.md

## Security Rules {#security-rules}
@docs/rules/security.md

## Testing Rules {#testing-rules}
@docs/rules/testing.md

# CLAUDE.md
@docs/agent_rules/index.md

# 快速写入和 /memory 编辑

# Always use pnpm, not npm or yarn

什么该写，什么不该写

进阶：用 CLAUDE.md 控制 /compact 保留什么

## Compaction Rules {#compaction-rules}
When compacting, always preserve:
- The full list of modified files
- Any pending test commands
- Current migration state if a database migration is in progress

一个完整的项目 CLAUDE.md 结构示例

# [项目名]

## Project Overview {#project-overview}
[一句话说明项目是什么、用什么技术栈]

## Repository Structure {#repository-structure}
- `src/` — 主应用代码
- `packages/` — 共享库
- `docs/` — 详细文档（见下方导入）

## Common Commands {#common-commands}
- Install: `pnpm install`
- Dev: `pnpm dev`
- Test: `pnpm test`
- Build: `pnpm build`
- Lint: `pnpm lint` (auto-runs on Stop hook)

## Code Conventions {#code-conventions}
- 使用 TypeScript strict mode，禁止 `any`
- [与行业默认不同的约定才需要写]

## Architecture Decisions {#architecture-decisions}
@docs/architecture.md

## Git Workflow {#git-workflow}
@docs/git-workflow.md

## Individual Preferences {#individual-preferences}
@~/.claude/[project-name]-local.md

## Compaction Rules {#compaction-rules-2}
When compacting, preserve: modified file list, pending test commands.