在 Claude Code 中使用你的 AgentSoul 文件

想让 Claude Code 拥有 AgentSoul 熔铸的人格，只需把四个文件放进项目，再在 CLAUDE.md 里引用它们。Claude Code 会在会话开始时自动读取 CLAUDE.md，而 CLAUDE.md 可以通过 @路径 引入其他文件。结果就是：每次会话都以同一个性格、同一套价值观和工作方式开场，不用再手动粘贴。

准备工作

• 一个在干将 iPhone App（闪电熔铸或高导）或网页 agentsoul.market 上熔铸好的灵魂。
• 电脑上的四个文件：soul.md、identity.md、user.md、agents.md。在 App 里点“获取四个文件”，再点“发送到电脑”，选择隔空投送、存储到“文件”或邮件。
• 已安装 Claude Code，以及一个你正在开发的项目文件夹。

具体步骤

1. 在项目里新建一个存放灵魂的文件夹，比如叫 soul 或 agent，把四个文件复制进去。
2. 打开项目根目录的 CLAUDE.md；如果还没有，就新建一个。
3. 加一小段说明，解释这些文件是什么，并逐行用 @ 引用每个文件相对于项目的路径。
4. 保存，然后在该项目里开启一个新的 Claude Code 会话。
5. 问一句“你是谁？你喜欢怎么工作？”，确认灵魂已经加载。

引用段落越简洁越好：一个“智能体人格”小标题，一句“以下文件描述了你的人格、你服务的人以及你的工作方式；除非项目说明另有规定，请遵循它们”，再接四行 @ 引用。最后半句很关键——它告诉 Claude Code，当灵魂和你的编码规范冲突时听谁的。

项目灵魂，还是个人灵魂？

Claude Code 会从不止一个位置读取 CLAUDE.md。项目里的 CLAUDE.md 只对该项目生效；你主目录下 ~/.claude 文件夹里的 CLAUDE.md 则对这台电脑上的所有项目生效。如果灵魂描述的是你这个人——你怎么想、希望被怎样对话——那么 soul.md 和 user.md 很适合放在用户级。如果灵魂是为某个代码库专门打造的专家，就留在那个项目里。不少人两者并用：全局放个人的 soul.md 和 user.md，项目里放专属的 agents.md。

四个文件在编码时各起什么作用

• soul.md 设定价值观和性情：偏谨慎还是偏速度，什么是不可妥协的底线。
• identity.md 给它名字和声音；同时运行多个智能体时，在对话记录里一眼就能分清谁是谁。
• user.md 告诉它你喜欢什么样的回答：先给结论还是先讲推理，简洁还是温和。
• agents.md 提供工作流程和升级规则——什么时候该停下来问你，而不是自己猜。

省时间的小建议

• 构建命令、测试命令、命名规范等技术规则放在 CLAUDE.md，不要写进 soul.md。人格和流程的更新节奏不同。
• 引用之前先读一遍。文件来自 AI 对你的解读，不像你的句子就删掉。
• 如果某次会话感觉不对劲，检查 agents.md 的步骤是否与项目流程冲突，把和写代码无关的步骤删掉。
• 文件每次会话都会进入上下文，越短越好。宁可删掉用不上的章节，也别越写越长。

就这么简单。你在 iPhone 上熔铸的灵魂，成了终端里那个智能体的性情；随着你们磨合，你还可以不断打磨它。