作为 OpenClaw 的用户,你可能已经发现 OpenClaw 很多设计理念来自 Claude Code。本文将带你深入了解 Claude Code 的配置系统,这既是它的”第一课”,也是理解 OpenClaw 很多设计来源的关键。
OpenClaw 在设计时借鉴了很多 Claude Code 的理念,特别是记忆系统这一块。某种程度上,你可以把理解 Claude Code 配置系统当作理解 OpenClaw 内在逻辑的一把钥匙。
剧透:你正在使用的 、、、 这些文件体系,最初就来自 Claude Code 社区的最佳实践。
Claude Code 的配置系统可以理解成三层架构:
真正决定”手感”的主要是记忆层,这也是本文的重点。
2.1 CLAUDE.md 是什么?
是 Claude Code 的核心”记忆文件”。当你进入一个目录工作时,Claude Code 会自动读取这个文件,把它当成比普通对话更”硬”的规则。
官方文档定义:
- 是一个项目配置/上下文文件
- 会被自动读取,当成项目的”系统提示”
- 可以多层叠加(项目级 + 全局级)
2.2 记忆层级结构
Claude Code 按特定顺序查找和加载这些文件:
加载顺序:从当前目录往上递归查找,合并所有找到的 CLAUDE.md
💡 Monorepo 提示:可以在根目录和子包分别放 CLAUDE.md,形成分层规则。
2.3 CLAUDE.md 应该写什么?
根据官方和社区实践,推荐结构如下:
⚠️ 这是本文最核心的部分——OpenClaw 正是借鉴了这套体系!
这不是官方标准,而是中文/英文社区自发形成的最佳实践,目前已经非常成熟。
3.1 核心思想
每次会话前,Claude 按顺序做四件事:
3.2 各文件职责
SOUL.md — “你是谁”
定义 Claude 在这个项目里的角色、价值观、工作风格。
USER.md — “你在帮助谁”
描述用户的背景、技术栈、偏好。
memory/YYYY-MM-DD.md — 短期记忆
记录最近一两天的重要决策和上下文。
MEMORY.md — 长期记忆
记录项目长期的约定、踩过的坑、关键决策。
3.3 为什么要这样分层?
在”记忆文件”之外,还有一层是JSON 设置文件:
常用配置项:
- :默认模型
- :是否自动更新
- :日志级别
💡 这层对”手感”影响主要是默认模型选择和工具权限边界,初学者先把 CLAUDE.md 体系做好就够了。
第一步:创建你的全局配置
在你的 home 目录创建:
然后创建以下文件:
- — 全局规则
- — 你是谁
- — 你在帮助谁
- — 长期记忆
- — 短期记忆
第二步:让 Claude 帮你写第一版
进入一个项目,运行:
然后加一句:「请用中文生成详细的 CLAUDE.md 项目说明文档」
第三步:对照官方文档优化
参考官方示例:
- Using CLAUDE.md Files
把自动生成的版本优化成结构清晰的小节。
第四步:迭代更新
在日常使用中不断补充:
- 踩过的坑 → 写入 MEMORY.md
- 新决定 → claude code 教程写入 memory/YYYY-MM-DD.md
- 角色调整 → 更新 SOUL.md
🎯 理解了这层对应关系,你就能理解 OpenClaw 很多设计背后的思考。
- 官方文档
- Claude Code 设置说明
- Using CLAUDE.md Files
- 中文实践
- Claude Code 最佳实践 – feisky
- 一周深度使用 Claude Code 的总结 – CSDN
- V2EX 讨论
- SOUL/USER/MEMORY 体系起源
- Claude Code 配置体系核心是三层:记忆层 + 设置层 + 技能层
- 记忆层的 Markdown 文件组织决定了使用”手感”
- SOUL/USER/MEMORY 体系是社区成熟实践,OpenClaw 借鉴了这一设计
- 第一步:先建立全局的 CLAUDE.md + SOUL.md + USER.md + MEMORY.md
📢 下节课剧透:我们将学习 MCP 服务器和 Skills 技能系统,这是 Claude Code 扩展能力的核心。
以下是 CLAUDE.md 文件的完整模板,整理自官方文档和社区最佳实践。你可以复制直接使用。
- 从简单开始:先用 A.2 全局模板,有项目再加 A.1
- 渐进完善:A.3-A.5 可以在日常使用中逐步补充
- 团队共享:项目级 CLAUDE.md 可以进 Git,团队一起维护
- 定期回顾:每月检查 MEMORY.md,清理过时内容
发布者:Ai探索者,转载请注明出处:https://javaforall.net/275711.html原文链接:https://javaforall.net
