AI Agent / 系统课时

区分记忆与配置范围

区分记忆与配置范围

本课解决“这条信息该放哪里”的问题。你将区分记忆文件与设置文件,并在用户级、项目级和本地级之间选择合适范围,避免个人信息被提交或团队规则只在一台机器生效。

学习目标

  • 区分上下文记忆与行为配置
  • 正确选择用户、项目和本地范围
  • 识别不应进入版本控制的内容

先区分记忆和配置

记忆文件主要告诉 Claude“项目是什么、应该怎样协作”,典型形式是 CLAUDE.md。设置文件主要控制工具“允许做什么、怎样运行”,例如权限规则、环境变量和插件开关,典型形式是 settings.json。

两者都可能影响会话,但作用不同。把“使用 Java 21”写入 CLAUDE.md 是协作说明;把允许执行的测试命令写入权限设置,则是在配置工具行为。必须强制执行的安全边界不能只依赖自然语言记忆。

三种常用范围

范围 记忆位置 设置位置 适合内容 是否共享
用户级 ~/.claude/CLAUDE.md ~/.claude/settings.json 个人跨项目偏好、常用工具设置 仅当前用户
项目级 ./CLAUDE.md 或 ./.claude/CLAUDE.md ./.claude/settings.json 团队架构、命令、项目权限与插件 通常提交到版本控制
本地级 ./CLAUDE.local.md ./.claude/settings.local.json 当前项目的个人路径、实验设置、本机许可 不应提交

Windows 中的 ~/.claude 通常对应用户目录下的 .claude。项目级内容应对所有协作者都有价值;本地级内容则只服务当前开发者和当前机器。

用场景决定范围

“所有项目都偏好简洁回复”属于用户级;“本项目必须运行 ./mvnw verify”属于项目级;“本机测试数据库地址”属于本地级。不要因为配置方便,就把个人绝对路径、内网地址或临时许可写入共享文件。

下面展示一个本地设置文件片段,用于只在当前机器允许特定测试命令。

json
{
  "permissions": {
    "allow": [
      "Bash(./mvnw test *)"
    ]
  }
}

这是配置片段,会影响当前项目的本地权限行为。保存为 .claude/settings.local.json 后,应确认它未进入版本控制;实际规则语法和可用设置以当前 Claude Code 版本为准。

验证加载来源

修改设置后,可在会话中运行 /status 检查已加载的设置来源;记忆文件则可用 /context 或 /memory 核对。

text
/status

预期结果

text
<SESSION_STATUS>
Setting sources:
- <LOADED_SETTING_SOURCE>

输出格式可能变化,判断重点是目标文件作为有效来源出现。若手写 JSON 有语法错误,文件可能不会被加载,应先用标准 JSON 校验器检查。

处理覆盖和冲突

不同范围可能同时生效。越具体的配置通常用于覆盖更宽泛的个人默认值,而组织托管策略可能具有更高优先级。记忆文件则可能被拼接到同一上下文中,冲突指令会降低可预测性。

因此,应把同一规则保留在最合理的一层:团队统一要求放项目级,个人偏好放用户级,机器差异放本地级。不要在三处复制同一段内容。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

区分记忆与配置范围

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通