帮程序员写CLAUDE.md文档赚钱，AI代码文档代写服务完整拆解

前两天在HN上看到一个186分的帖子，标题一句话就把我看笑了。

「程序员愿意花几小时给Claude写CLAUDE.md，却不愿意给同事写一句文档。」

我当时的第一反应是，这不就是我吗。。。我自己用Claude Code的时候，CLAUDE.md写了密密麻麻几百行，什么项目结构、编码规范、常用命令、踩过的坑全写上了。但我上一次给同事写README是什么时候？我自己都记不清了。

帖子里一堆人在评论区说自己也是这样。有人花了一整个下午调CLAUDE.md的措辞，为了让Claude Code少犯一个错误。转头让同组的实习生去看一份技术文档，甩了一句「你自己读代码吧」。

说实话我也不觉得这有什么问题。给AI写文档，AI立刻就能用，反馈是即时的，效果是可感知的。给同事写文档呢？写了半天对方可能根本不看，看了也可能看不懂，你付出的时间和得到的回报完全不对等。

但这个现象背后藏着一个非常有意思的商业机会。

你想想看，如果一个程序员愿意花几小时去优化一个CLAUDE.md文件，说明什么？说明他已经认可了给AI写文档这件事的价值。他只是不想自己花时间做，或者不知道怎么写得更好。

而你，可以把这件事做成一门生意。

这个市场到底有多大

先别急说怎么赚钱，先看看几个信号。

那个186分的帖子不是个案。同期HN上还有一篇450分的文章，标题叫「Claude Code as a Daily Driver」，专门讲怎么把CLAUDE.md、Skills、子agent配置这些玩到极致。评论区里几百人在讨论各自的CLAUDE.md写法，互相抄配置。

还有个Ask HN帖子，「你还在花时间维护CLAUDE.md吗」，底下全在讨论怎么写出让Claude Code效率翻倍的文档模板。

这些帖子指向一个很清晰的事实，CLAUDE.md已经从「可有可无的配置文件」变成了「开发效率的核心基础设施」。

我自己现在的感受就很明显。没有CLAUDE.md的项目，Claude Code就像个新来的实习生，什么都要从头问。有了写得好的CLAUDE.md，它直接上手干活，写出来的代码风格统一，测试覆盖完整。

差别太大了。

而且不只是Claude Code。Cursor有.cursorrules，Windsurf有.windsurfrules，每个AI编程工具都有自己的一套配置文件生态。GitHub上搜索「CLAUDE.md」，相关仓库已经有几千个了。Addy Osmani那个45K星的agent-skills项目，我之前拆解过，说到底也是一套预写好的AI agent文档和技能配置。

有个叫Charlie Labs的团队，做了两年的AI编程agent，后来发现了一个问题，他们写的agent越多，文档就越跟不上。agent越多，文档债越大。所以他们直接从「做agent」转成了「帮agent写文档」，成了一个AI开发基础设施公司。

具体帮人写什么文档

如果你要帮别人做AI agent文档服务，需要交付的东西大概有这几层。

第一层，CLAUDE.md和PROJECT.md。 这是地基。CLAUDE.md告诉AI agent这个项目的编码规范、架构约束、测试方法、常用命令。PROJECT.md描述项目的整体结构、模块关系、数据流。这两个文件写好了，AI agent的代码输出质量会有一个质的飞跃。Arpan Patel那篇450分的文章里专门提到，Boris Cherny（Claude Code的核心人物之一）认为给Claude写好配置文档，能带来2到3倍的质量提升。

第二层，Skills和子agent配置。 进阶玩法。帮客户写自定义的Skills文件，比如一个专门做code review的子agent配置，或者一个专门跑测试的子agent配置。上篇文章拆解的AI代码审查其实就是一种子agent技能。写这种配置需要对AI agent的工作机制有更深的理解。

第三层，多项目标准化。 面向公司客户。帮他们建立一套统一的AI agent文档规范，让所有项目都有一致的CLAUDE.md模板、Skills标准、子agent配置方案。这层已经不只是写文档了，更像是一个AI开发基础设施咨询。

这三层的门槛和收费，一层比一层高。但对普通人来说，第一层和第二层已经完全可以上手了。

三种赚钱方向，从低到高

顺着上面的三层文档体系，对应的赚钱方向也有三个。

方向一，帮独立开发者写CLAUDE.md和README

这是门槛最低的，适合刚起步的人。

GitHub上大量的个人项目，star从几十到几千不等，很多项目的README就一句话，「一个xxx的工具」。CLAUDE.md更是不存在。这些开发者在用Claude Code或者Cursor的时候，AI agent得猜着写代码，效率极低。

你去GitHub上随便翻几个star在100到2000之间的项目，看看它们的README和代码结构。我敢说至少一半的项目，你花三十分钟读完代码就能写出一份比原项目好十倍的CLAUDE.md。

因为很多开发者不是不知道文档重要，是真的没时间写。他们忙着写功能、修bug、回复issue，写文档这事永远排在最后。但如果你告诉他，「给我500块，我帮你写一份CLAUDE.md，以后你用Claude Code写代码效率直接翻倍」，很多人是愿意付的。

这个方向一单收费300到800元，看项目复杂度。

操作流程也很简单。客户给你仓库权限，你clone下来花一两个小时读代码、理解结构，然后用Claude帮你生成初版CLAUDE.md，你人工审一遍调整措辞，确保准确。整个交付周期一到两天。

找客户的方式，GitHub上直接找没有CLAUDE.md的项目，主动提issue或者PR建议添加。V2EX和掘金上发帖展示你的案例。Fiverr上挂「I will write CLAUDE.md for your project」的服务链接。

方向二，给中小公司搭建AI Agent工作流配置

这个方向是我自己觉得最有意思的。

现在很多中小技术团队正在经历一个转型，从传统开发切换到AI辅助开发。他们的项目可能已经运行了一两年，有完整的代码库，但没有任何为AI agent准备的文档和配置。

这些团队的程序员可能刚开始用Claude Code，体验过配置好了CLAUDE.md之后效率飞升的感觉，但他们不知道怎么给自己的项目写出高质量的配置。或者他们知道，但没有人力来做。

你做的事情就是，花两三天时间深入一个项目，理解它的架构、模块、数据流、编码规范，然后输出一整套AI agent文档，CLAUDE.md、PROJECT.md、Skills文件、常用子agent配置，全部配好。

这跟安装addyosmani的agent-skills不一样。那个是装一个通用的技能包，你的服务是针对客户的代码库定制文档。就像去裁缝店量体裁衣和去优衣库买成衣的区别，前者贵但更合身。

这个方向按项目收费，1500到4000元一个项目。如果跟公司签月度服务，每月3000到8000元。

续费率也会比较高。因为项目在持续迭代，CLAUDE.md也需要持续更新。你第一次帮他们搭好了框架，后面的维护就是常规的月度更新，几百块到一千块一个月，客户很乐意持续付。

获取客户的方式，去技术创业社区找刚拿到融资的团队，他们有钱有动力优化开发效率。也可以在技术社区写文章分享你的配置案例，展示前后的效率对比数据。

方向三，AI Agent文档标准化咨询服务

第三个方向是天花板最高的。

当一个公司有多个项目，十几个甚至几十个开发者在同时用AI编程工具的时候，每个人写的CLAUDE.md风格都不一样，AI产出的代码质量也参差不齐。这比没有文档更头疼。

你做的是帮他们建立一套公司级的AI开发文档标准。统一的CLAUDE.md模板、Skills规范、子agent配置标准、文档更新流程。这不只是写几个文件的事，更像是给一个公司搭AI时代的基础设施。

这个方向收费最高，单次5000到15000元，月度维护2000到5000元。

这个方向的门槛也最高。你需要有比较强的技术理解能力，能跟CTO和技术负责人对话，理解他们的架构设计和开发流程。也需要有项目管理和咨询的经验。

不过话说回来，不需要一上来就冲着这个方向去。从方向一开始做，积累十几二十个案例之后，如果你写的文档真的让客户的开发效率明显提升了，那你自然就有了做方向三的底气。

投入成本和收益分析

说点实在的。

工具成本

几乎为零。你用Claude Code来读代码和生成文档，API费用极低。写一份CLAUDE.md的过程可能只需要跟AI对话几轮，token消耗量很小。如果用DeepSeek更便宜。按每天写一到两份文档算，每月API成本不到100元。

你需要投入的是时间。学习怎么写好CLAUDE.md需要一两周的积累。去GitHub上找几个写得好的开源CLAUDE.md参考，比如Claude Code官方团队的配置。读几份你就知道好的CLAUDE.md长什么样了。

收益预期

我说一个比较保守的估算。

第一个月，免费帮三五个朋友的项目写CLAUDE.md，积累案例。在技术社区发帖分享你的作品。

第二个月，开始收费。接两三个独立开发者的单，每单300到800元，月收入大概1000到2400元。

第三四个月，如果谈到了一两个公司客户的项目配置单，单子变成1500到4000元。加上散客收入，月收入可以稳定在4000到8000元。

如果能签到一个公司级的月度维护合同，那就是每月3000到8000元的持续收入。两个这样的客户，月入过万很正常。

说真的，我自己也觉得这个方向天花板不算特别高。它不像Claude Code应用商店那种可以规模化复制的模式。但它有一个特别大的优势，零竞争。你去闲鱼搜CLAUDE.md，搜不到几个卖这个服务的。去Fiverr搜，竞争也很少。这个市场才刚刚开始，先进入的人有极大的先发优势。

怎么写好一份CLAUDE.md

这块我想多说两句，因为这是你的核心竞争力。

写好CLAUDE.md不是让Claude Code帮你生成一堆模板套话就完了。真正好的CLAUDE.md有几个特征。

第一个，准确。 你写的每一行都必须跟代码库实际情况一致。如果CLAUDE.md里写「测试用pytest运行」，但项目实际用的是vitest，那你的文档不是在帮忙，是在添乱。Mark Dominus在那篇帖子里说，他会仔细审读Claude帮他写的每份文档再commit，因为「是我的签名在commit上，我的账户收着工资」。

第二个，具体。 不要写「使用标准编码规范」，要写「文件命名用kebab-case，变量用camelCase，组件文件放在src/components下，每个组件一个目录」。AI agent需要的是精确指令，不是模糊的描述。

第三个，有边界。 好的CLAUDE.md不只告诉AI该做什么，还要告诉它不该做什么。比如「不要修改src/legacy目录下的文件」「不要引入新的npm依赖除非经过人工审批」「数据库schema变更必须走migration」。这些边界条件能大幅减少AI犯错的机会。

第四个，包含实战经验。 这是最值钱的部分。把客户在开发中踩过的坑写进去，比如「支付模块的回调接口有时候会重复触发，需要加幂等性检查」。这些知识只有深入代码才能发现，AI agent自己猜不到。

踩过的坑和注意事项

我自己研究这个方向的时候，发现几个容易踩的坑。

最大的坑，不要用AI直接生成文档然后转手卖给客户。 这个看起来最省事，但风险很大。Claude Code帮你生成的CLAUDE.md，经常会编造不存在的文件路径、错误的命令、不存在的依赖。如果你不仔细审读直接交付，客户一跑就露馅了。你的专业性和口碑直接崩掉。

正确做法是，用Claude Code帮你生成初稿，然后你自己读代码逐条验证。每一条命令都要亲自跑一遍确认能用，每一条路径都要确认文件真的存在。这个验证过程大概需要花你总交付时间的三分之一到一半，但它决定了你的服务是「靠谱的定制服务」还是「骗人的转手买卖」。

第二个坑，不要只写CLAUDE.md。 很多客户不知道他们还需要PROJECT.md和Skills文件。如果你只交付了一份CLAUDE.md，客户可能觉得还行但不够惊艳。如果你交付了一整套，CLAUDE.md + PROJECT.md + 一两个实用的Skills配置 + 一个简单的code review子agent，客户的感受完全不同。多花两小时输出的东西，能让你从「还行吧」变成「卧槽这也太全了」。

第三个坑，保密问题。 你在帮客户写文档的时候，需要读他们的全部代码。这些代码可能包含商业机密、API key、用户数据处理逻辑。你必须明确承诺保密义务，审查完成后立即删除本地副本，不保存任何代码备份。最好能签一个保密协议。

第四个坑，定价不要一上来就太低。 我知道很多人想先用低价吸引客户。但这个方向有一个特点，你的价值感很大程度取决于你交付文档的质量展示。如果你收50块写一份CLAUDE.md，客户拿到手的也是50块的质量。你收500块，客户会期待更好的交付物，而你为了配得上500块的价格，也会拿出更认真的作品。

我觉得一开始定价300到500是合理的。低于200块不如不做，因为你的时间成本和API成本加起来已经快到这个数了。

说真的，这个方向我自己觉得特别适合那种有一定编程基础、但目前没有全职技术工作的人。不要求你代码写得多好，要求你能读懂代码、理解架构、并且能用清晰的结构化语言把一个项目描述出来。

如果你已经在用Claude Code或者Cursor写代码，那你已经在积累这方面的经验了。你自己的CLAUDE.md写得越好，你就越有底气帮别人写。

说到这，如果你已经在用AI做副业但总觉得效率提不上来，我整理了一套自己压箱底的AI提示词包，里面就有写CLAUDE.md的专用模板和代码审查的提示词。点这里去看看。

回到最开始那个帖子。程序员愿意给AI写文档不给同事写，这看起来是个段子，其实是一个非常清晰的信号。当一个群体愿意花大量时间为一个工具写使用说明的时候，说明这个工具已经不可或缺了。

而不可避免的是，不是每个人都愿意或者有能力自己写这份说明。这里面就藏着你的机会。

大时代啊，朋友们。