@PawelHuryn: 187,000 人在 GitHub 上给一个 CLAUDE.md 文件点了星。每次交互都会加载一个 CLAUDE.md。每一行代码都是你付的租金……

X AI KOLs Timeline 工具
claude-md github ai-coding-assistant best-practices configuration

摘要

Paweł Huryn 在推特上分享了他关于为 Claude Code 编写高效 CLAUDE.md 文件的见解，重点强调了项目专属规则以及避免不必要的冗余。

187,000 人在 GitHub 上给一个 CLAUDE.md 文件点了星。 每次交互都会加载一个 CLAUDE.md。每一行代码都是你在每次请求中付的租金。 所以，看看这个文件里大部分内容都要求什么：匹配现有风格，只做被要求的事，不要重构能工作的代码，不要假设某个库存在。这些都不是建议——Claude Code 已经这么做了。匹配现有风格甚至被写进了 Opus 4.8 的系统提示里。 值得付租金的规则是你项目特有的，通常是从错误中积累出来的。例如： - 版本升级由用户发起 - 有三种测试类型，区别很重要：npm test、CI 测试、npm run test:live (...) - 发布推送时不要跳过标签/发布（或 vsix 资源） - 在 GitHub 评论上签名 (...) 由代理编写，经 Paweł 审阅 (...) 由 Paweł 的代理编写 从 GitHub 复制过来的一行代码，是对你可能遇到的问题的猜测。而在某件事第三次出问题后你写下的那一行代码，才是策略。 其他所有内容按需加载。主文件保持简短，Claude 只在任务需要时才去读取 database.md、security.md 或 cron.md。 这就是你无法加星的那个设置。
查看原文
查看缓存全文

缓存时间: 2026/07/04 08:42

187,000 人在 GitHub 上给一份 CLAUDE.md 文件标了星。

每次对话轮次都会加载 CLAUDE.md。每一行都是你每次请求需要支付的租金。

所以，看看那份文件中大部分内容要求什么。匹配现有风格。只做被要求的事。不要重构能正常工作的代码。不要假设某个库存在。这些都不是建议——而是 Claude Code 已有的行为方式。匹配现有风格甚至被写入 Opus 4.8 的系统提示词中。

值得支付这笔租金的规则是专属于你项目的。通常是从错误中得来的。例如：

  • 版本升级由用户主动触发
  • 有三种测试，并且区分它们很重要：npm test、CI 测试、npm run test:live (…)
  • 在推送发布时不要跳过标签/发布（或 vsix 资产）
  • 签署 GitHub 评论 (…) 由代理编写，Paweł 审阅 (…) 由 Paweł 的代理编写

从 GitHub 复制过来的一行代码是对你可能遇到的问题的猜测。而你在某件事第三次搞砸后写下的一行代码，才是策略。

其他所有内容按需加载。主文件保持简短，Claude 只有在任务需要时才读取 database.md、security.md 或 cron.md。

这就是你无法标星的设定。

相似文章

@vincemask: 我靠，原来 CLAUDE.md 还有这么多门道，以前真是白写了。 以前我一直以为「信息越多越好」，于是把项目历史、技术决策、个人偏好，甚至「写干净代码」这种空泛要求，全塞进 CLAUDE.md。 结果就是：Claude 每次都像在几千行上…

X AI KOLs Timeline

作者反思了对CLAUDE.md的常见误解，指出不应堆砌信息，而应压缩判断标准、约束执行边界和沉淀高频规则，以提升Claude Code等代码代理的工作效率。