行业资讯
CLAUDE.md 与 Skill 的边界感,Claude Code 配置真正好用的关键
很多团队刚开始用 Claude Code 时,最容易走进一个坑,看到什么规则都往 CLAUDE.md 里塞。代码风格放进去,构建命令放进去,API 文档也放进去,发布流程也放进去,甚至连一次性的排障步骤也想写进去。短期看很爽,Claude Code 每次打开项目都像拿到了一本厚厚的项目手册。可一段时间后,问题会慢慢冒出来,Claude 读得越来越多,响应越来越像背诵制度文件,真正跟当前任务有关的信息反而被噪声稀释。CLAUDE.md 和 Skill 都能存放指令,但它们不是同一种东西。一个更像团队墙上的长期约定,另一个更像工具箱里的专用操作卡。CLAUDE.md 解决的是「Claude 每次进入项目都必须知道什么」,Skill 解决的是「Claude 在某类任务发生时才需要调用什么」。Anthropic 官方文档里也明确区分了这层关系,Claude Code 会在会话启动时加载工作目录上方层级中的 CLAUDE.md 和 CLAUDE.local.md,而 Skill 的完整内容只有在被使用时才加载,长参考资料在不用的时候几乎不占主上下文空间。CLAUDE.md 更像项目里的空气CLAUDE.md 最适合放那些「不需要被触发,也不应该被遗忘」的规则。比如项目只允许 pnpm,不允许 npm。比如所有新增 API 都要走 src/server/routes 里的现有错误返回结构。比如测试命令固定是 pnpm test,不要猜测 yarn test。比如某个老系统里不能直接改数据库 migration,只能通过内部脚本生成。这些内容不是任务,而是环境。Claude Code 每次进入项目,如果不知道这些规则,后面的所有判断都会跑偏。就像一个新同事入职
郑州网站建设
网页设计
企业官网