核心配置

1、settings.json

路径	作用范围	是否提交 Git	优先级
~/.claude/settings.json	全局（所有项目）	否	低
项目/.claude/settings.json	当前项目（团队共享）	是	中
项目/.claude/settings.local.json	当前项目（个人私有）	否（gitignore）	高

1.1、~/.claude/settings.json

模型相关的配置

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "API KEY",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "deepseek-v4-pro[1M]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash[1M]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1M]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash[1M]",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "model": "sonnet",
  "autoMemoryEnabled": true
}

1.2 项目下的settinngs

项目相关的配置

{
  "permissions": {
    "allow": [
      "Read",
      "Glob",
      "Grep",
      "Edit",
      "MultiEdit",
      "Write(src/**)",
      "Write(tests/**)",
      "Bash(npm *)",
      "Bash(pnpm *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Bash(git add *)",
      "Bash(cat *)",
      "Bash(head *)",
      "Bash(tail *)",
      "Bash(find *)"
    ],
    "deny": [
      "Read(**/.env*)",
      "Read(**/*.pem)",
      "Read(**/*.key)",
      "Read(**/secrets/**)",
      "Read(**/credentials/**)",
      "Write(**/.env*)",
      "Write(**/secrets/**)",
      "Write(package-lock.json)",
      "Write(.github/workflows/*)",
      "Bash(rm -rf *)",
      "Bash(sudo *)",
      "Bash(git push *)",
      "Bash(git commit *)",
      "Bash(git merge *)",
      "Bash(git rebase *)",
      "Bash(docker *)",
      "Bash(curl * | sh)",
      "Bash(chmod *)"
    ],
    "defaultMode": "acceptEdits"
  }
}

注： 全局和项目都有配置，会合并，相同的键，优先级高的值会覆盖优先级低的值
优先级： ~/.claude/settings.json < 项目/.claude/settings.json < 项目/.claude/settings.local.json

2、claude.md（项目说明书）

层级	路径	作用范围	适合写什么
全局级	~/.claude/CLAUDE.md	所有项目都会读	个人习惯、身份、翻译偏好（如"永远用中文回答"、“我是 xx、从事 xx”）
项目级	项目根目录/CLAUDE.md	仅本项目	项目技术栈、架构、规范、进度（可提交 Git，团队共享）
文件夹级	子目录/CLAUDE.md	仅该子目录	模块专属约定

三层叠加生效，不冲突。优先级：文件夹级 > 项目级 > 全局级。

为什么 CLAUDE.md 如此重要？

没有 CLAUDE.md 时，Claude Code 每次开始工作都要花时间"重新认识"你的项目。有了 CLAUDE.md，它一启动就知道项目的全部背景，效率大幅提升。

2.1 ~/.claude/CLAUDE.md （全局模板）

沟通方式

- 默认中文回复；代码、命令、变量名、文件路径保持英文
- 结论先行，简洁直接，不先铺垫背景
- 不谄媚，不夸"这是个很好的问题"，不以"当然可以"开头
- 给真实判断——方案有问题直接指出，发现更好做法主动说明

## Git

- 不自动 `git commit` 或 `git push`，除非我明确要求
- 提交前先展示将要提交的变更摘要
- commit message 使用简洁英文

## 红线操作

以下操作即使在 auto-accept 模式下也必须先问我：

- 删除文件、目录或 git 历史
- 修改 `.env`、密钥、token、证书、CI/CD 配置
- `git push`、`git rebase`、`git reset --hard`、强制推送
- 公开发布（`npm publish`、生产部署等）

2.2 项目下的claude.md

两个官方推荐的创建姿势：**

• /init 创建项目级：在项目根目录下运行 claude 后输入 /init，cc 会自动扫描项目并生成一份 CLAUDE.md 初稿，你再调整。官方建议：项目有一定规模再 /init 效果更好（太空它扫不出什么东西）。

2.3 自建参考文档（渐进式披露）

应用场景：某些东西不适合全部塞进 CLAUDE.md（太长、太专门），但 cc 需要的时候必须能查到。比如做个产品，你希望：

• 品牌视觉规范：颜色、字体、间距 → docs/brand-visual.md
• 产品文本风格：语调、术语表 → docs/copywriting-style.md
• API 约定：请求响应格式、错误码 → docs/api-conventions.md

然后在 CLAUDE.md 里加上指引：

## 外部参考文档

- 修改前端视觉、调颜色、调间距时 → 必读 `docs/brand-visual.md`
- 写产品文案、按钮文字、提示语时 → 必读 `docs/copywriting-style.md`
- 写 API 、定义返回格式时 → 必读 `docs/api-conventions.md`

这样 claude code只在"需要的时候"才去读完整文档，既保证了准确性，又不占多余上下文。

3、memory

如果说 CLAUDE.md 是你主动立下的规矩，那 Auto Memory 就是 cc 在干活过程中默默记下的设计笔记。你没显式写进 CLAUDE.md 的习惯、反馈、项目踩坑，会被一个后台 agent 静静记录。

3.1 工作机制

• 它只在当前项目生效（文件存在项目目录下），换项目需重新积累
• 启用后 cc 不会每次都把所有记忆全部加载进上下文，只会读一份 memory.md 索引——遇到具体问题才去读对应的子文件，占 token 很少
• 随时可以用快捷键 Ctrl+O 在会话中查看实际被调用过的记忆内容
• 记错了就跟它说：“忘掉刚刚说的不喜欢深色主题”，它会自己删掉

区分 CLAUDE.md vs Auto Memory：

• CLAUDE.md 是第一优先级、全量注入的明规则；
• Auto Memory 是第二优先级、按需注入的隐规则。
• 两者配合，cc 越用越懂你。

4、claude.md 和 memory 总结

Claude Code 的三层记忆体系：

• 第一层 ：CLAUDE.md（你主动写，全量加载）
• 第二层 ：Auto Memory（cc 自己记，按需读取）
• 第三层：自建参考文档（你写，cc 遇到对应任务才读）。

层	位置	优先级	加载方式	谁在维护
1	CLAUDE.md（三级）	高	会话启动全量加载	你手动维护
2	Auto Memory	中	先读索引、按需读子文件	cc 自己写、你校对修改
3	参考文档	按需	cc 遇到对应任务才读	你手动维护

5、claude 使用方式

官方推荐工作流：Explore → Plan → Implement → Commit

Claude Code 的常见推荐工作流可以概括为 四阶段：

1. Explore（探索）：Plan Mode 下读代码、搜引用，搞清楚现状
2. Plan（规划）：出方案、评估边界情况，你审核
3. Implement（实施）：切出 Plan Mode，按方案执行
4. Commit（提交）：生成 commit message，提交