everything-claude-code/docs/zh-CN/examples/user-CLAUDE.md

用户级别 CLAUDE.md 示例

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

用户级别配置全局应用于所有项目。用于：

• 个人编码偏好
• 您始终希望强制执行的全域规则
• 指向您模块化规则的链接

---

核心哲学

您是 Claude Code。我使用专门的代理和技能来处理复杂任务。

关键原则：

1. 代理优先：将复杂工作委托给专门的代理
2. 并行执行：尽可能使用具有多个代理的 Task 工具
3. 先计划后执行：对复杂操作使用计划模式
4. 测试驱动：在实现之前编写测试
5. 安全第一：绝不妥协安全性

---

模块化规则

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

规则文件	内容
security.md	安全检查，密钥管理
coding-style.md	不可变性，文件组织，错误处理
testing.md	TDD 工作流，80% 覆盖率要求
git-workflow.md	提交格式，PR 工作流
agents.md	代理编排，何时使用哪个代理
patterns.md	API 响应，仓库模式
performance.md	模型选择，上下文管理
hooks.md	钩子系统

---

可用代理

位于 ~/.claude/agents/：

代理	目的
planner	功能实现规划
architect	系统设计和架构
tdd-guide	测试驱动开发
code-reviewer	代码审查以保障质量/安全
security-reviewer	安全漏洞分析
build-error-resolver	构建错误解决
e2e-runner	Playwright E2E 测试
refactor-cleaner	死代码清理
doc-updater	文档更新

---

个人偏好

隐私

• 始终编辑日志；绝不粘贴密钥（API 密钥/令牌/密码/JWT）
• 分享前审查输出 - 移除任何敏感数据

代码风格

• 代码、注释或文档中不使用表情符号
• 偏好不可变性 - 永不改变对象或数组
• 许多小文件优于少数大文件
• 典型 200-400 行，每个文件最多 800 行

Git

• 约定式提交：feat:，fix:，refactor:，docs:，test:
• 提交前始终在本地测试
• 小型的、专注的提交

测试

• TDD：先写测试
• 最低 80% 覆盖率
• 关键流程使用单元测试 + 集成测试 + E2E 测试

知识捕获

• 个人调试笔记、偏好和临时上下文 → 自动记忆
• 团队/项目知识（架构决策、API变更、实施操作手册） → 遵循项目现有的文档结构
• 如果当前任务已生成相关文档、注释或示例，请勿在其他地方重复记录相同知识
• 如果没有明显的项目文档位置，请在创建新的顶层文档前进行询问

---

编辑器集成

我使用 Zed 作为主要编辑器：

• 用于文件跟踪的代理面板
• CMD+Shift+R 打开命令面板
• 已启用 Vim 模式

---

成功指标

当满足以下条件时，您就是成功的：

• 所有测试通过（覆盖率 80%+）
• 无安全漏洞
• 代码可读且可维护
• 满足用户需求

---

哲学：代理优先设计，并行执行，先计划后行动，先测试后编码，安全至上。