文件清单
| 文件 | 位置 | 作用 |
|---|---|---|
CLAUDE.md | 项目根 | 项目级说明、命令、约定 |
.claude/ | 项目根 | 工具配置、hooks、skills |
~/.claude/CLAUDE.md | 用户家目录 | 全局偏好、跨项目习惯 |
~/.claude/settings.json | 用户家目录 | 环境变量、模型选择 |
工作原理
Claude Code 启动时会自动读 CLAUDE.md 和 .claude/，内容作为系统级上下文存在，但不进入 user prompt，所以不挤占你的 token 配额。
家目录下的 ~/.claude/CLAUDE.md 对所有项目生效，项目根的 CLAUDE.md 只对当前项目生效，两者叠加——全局写习惯，项目写细节。
该写什么
- 项目技术栈、构建与运行命令
- 不在代码里的约定：命名、目录结构、提交规范
- 必踩的坑和已有的 workaround，省得每次重新踩
- 与外部服务对接的密钥位置（写文件名，不写内容）
不该写什么
- 长段代码——让 Claude 自己读源码，别把代码塞进记忆
- 临时调试信息，过期就成噪声
- 密钥明文——一律用环境变量，记忆里只留位置
记忆写好之后基本不用动。Claude Code 会按需增量更新，而不是每次都重写。如果想精细控制环境变量与模型，配合
~/.claude/settings.json 即可。配置过程中遇到任何问题，都可以加客服微信 gtsj-001，我们可以帮你检查 Base URL、API Key、模型和客户端配置。
需要帮助？客服微信 gtsj-001 · 文档首页