用户级 CLAUDE.md 示例¶

这是一个用户级 CLAUDE.md 文件示例。请将其放置在 ~/.claude/CLAUDE.md。

用户级设置会全局应用于所有项目。可用于以下目的： - 个人编码偏好设置 - 希望始终应用的通用规则 - 模块化规则文件的链接

核心哲学¶

你是 Claude Code。我使用针对复杂任务专门化的 agent 和 skill。

核心原则： 1. Agent 优先：将复杂任务委托给专门的 agent 2. 并行执行：在可能时使用 Task tool 同时运行多个 agent 3. 执行前规划：对于复杂任务使用 Plan Mode 4. 测试驱动：在实现之前编写测试 5. 安全优先：绝不妥协安全

模块化规则¶

详细指南位于 ~/.claude/rules/：

可用的 Agent¶

位于 ~/.claude/agents/：

个人偏好设置¶

隐私保护¶

• 始终删除日志，绝不粘贴机密信息（API 密钥/令牌/密码/JWT）
• 在共享之前检查输出内容，移除敏感数据

代码风格¶

• 禁止在代码、注释、文档中使用表情符号
• 偏好不可变性——不要直接修改对象或数组
• 偏好多个小文件，而非少数大文件
• 通常 200-400 行，每个文件最多 800 行

Git¶

• Conventional commits：feat:、fix:、refactor:、docs:、test:
• 提交前始终在本地运行测试
• 小而聚焦的提交

测试¶

• TDD：先编写测试
• 至少 80% 覆盖率
• 对核心流程进行单元 + 集成 + E2E 测试

知识积累¶

• 个人调试笔记、偏好设置、临时上下文 → auto memory
• 团队/项目知识（架构决策、API 变更、实施手册）→ 遵循项目现有的文档结构
• 如果在当前工作中已经生成了相关文档、注释、示例，则不要在其他地方重复相同知识
• 如果没有合适的项目文档位置，在创建新的顶层文档之前先提问

编辑器集成¶

我使用 Zed 作为默认编辑器： - 用于文件追踪的 Agent Panel - 使用 CMD+Shift+R 打开命令面板 - 启用 Vim 模式

成功标准¶

满足以下条件即为成功： - 所有测试通过（覆盖率不低于 80%） - 无安全漏洞 - 代码可读且易于维护 - 满足用户需求

理念：Agent 优先设计、并行执行、执行前规划、代码之前先测试、始终安全优先。