本地记忆上下文配置的文件名 是 .claude.local.md还是 CLAUDE.local.md ?

是 CLAUDE.local.md。

通常 Claude Code 识别的是：

• CLAUDE.md
• CLAUDE.local.md

不是 .claude.local.md。

说明这两个文件各自的作用，以及它们和 .claude/ 目录下配置的区别

可以，简单说：

1. CLAUDE.md

这是项目级共享说明文件。

适合放：

• 项目背景
• 代码结构说明
• 开发/测试命令
• 代码风格约定
• 常见工作流程
• 对 Claude 的项目内协作要求

特点：

• 一般会提交到 git
• 团队成员都可以共享
• Claude 进入这个项目时会读取它，作为长期项目上下文

例如可以写：

# Project Notes

## Run
- `composer test`
- `npm run dev`

## Conventions
- PHP 代码保持现有风格，不主动改成新语法
- 数据库查询统一走 repository
- 新接口先看 `routes/api.php`

---

2. CLAUDE.local.md

这是你本机私有的项目说明文件。

适合放：

• 只对你自己有用的偏好
• 本地调试习惯
• 不想提交到仓库的说明
• 临时但跨会话有价值的项目备注

特点：

• 通常不提交到 git
• 只在你本地生效
• 用来补充 CLAUDE.md，但更偏个人化

例如：

# Local Notes

- 我平时用中文沟通
- 这个项目优先看 iOS 分支相关逻辑
- 跑测试时先执行某个本地脚本
- 遇到支付模块改动时提醒我先检查日志目录权限

---

3. .claude/ 目录

这个目录通常放的是 Claude Code 的配置文件，不是项目说明文档本身。

常见内容可能包括：

• .claude/settings.json
  Claude Code/harness 行为配置
• .claude/settings.local.json
  本地私有配置
• .claude/agents/
  自定义 agent
• .claude/workflows/
  自定义 workflow
• 其他工具相关配置

也就是说：

• CLAUDE.md / CLAUDE.local.md：偏给 Claude 的自然语言说明
• .claude/...：偏工具配置、自动化配置、行为设置

---

4. 怎么理解它们的分工

可以这样记：

• CLAUDE.md = 团队共享的“项目操作手册”
• CLAUDE.local.md = 你自己的“本地备注”
• .claude/ = Claude Code 的“配置中心”

---

5. 典型搭配建议

比较推荐这样用：

提交到仓库

• CLAUDE.md

本地忽略

• CLAUDE.local.md
• .claude/settings.local.json

如果你不想把本地说明提交上去，通常会在 .gitignore 里加类似：

CLAUDE.local.md
.claude/settings.local.json

---

6. 一个常见误区

你刚才问的 .claude.local.md 容易和下面这些混淆：

• CLAUDE.local.md ← 对，应使用这个
• .claude/ ← 这是目录，不是这个说明文件
• .claude.local.md ← 一般不是标准文件名

---

如果你愿意，我可以下一步直接帮你看一下你这个仓库的 .gitignore，判断是否已经正确忽略了 CLAUDE.local.md 和本地 .claude 配置。