Claude Ads：帮你审计广告账户的 Claude Code 技能

你也许在 Instagram 上刷到过那个视频：「十分钟干完你那家月费 3000 欧元广告代理公司的活」。在这个略带推销味的钩子背后，是一个货真价实的开源项目：Claude Ads，一款 Claude Code 技能，它读取你的广告账户数据，告诉你哪些有效、哪些出了问题、先修哪里。截至 2026 年 10 月，它在 GitHub 上有一万多颗星，采用 MIT 许可证。

本文于2026年10月21日更新，对应2026年10月16日发布的 Claude Ads v2.1.0。本文第一版介绍的是 v1.7.1。从 v2 开始，这款技能覆盖的平台从八个增加到十二个，不再给出百分制评分，作者也明确提醒不要使用我们以前展示的一行命令安装方式。下文所有内容都已对照 v2.1.0 的 README 和技能文件核实过。

Claude Ads 到底是什么

Claude Ads 是一款 Claude Code 技能，由 Daniel Agrici 打造。所谓技能，就是一套指令、参考资料和代理的集合，你的代码代理会按需加载它：在这里，装进去的是一位付费投放审计师的本事，拆成一个个模块。它不是 Anthropic 的产品，也和 Claude 里的广告毫无关系：Anthropic 在 2026 年 2 月写道，Claude 将保持无广告。

它有两个来源：AgriciDaniel/claude-ads 上的公开版本（MIT，无需会员），以及 AI-Marketing-Hub/claude-ads 上的社区镜像，付费社区的成员可以在那里抢先使用。

v2.1.0 包含的内容：

• 12 个广告平台：Google、Meta、YouTube、LinkedIn、TikTok、Microsoft、Apple、Amazon、Reddit、Pinterest、Snapchat 和 X。
• 一个 /ads 命令背后的 33 个技能，每个平台一个，再加上若干横向技能（归因、服务器端追踪、创意、落地页、预算、规划、报告）。
• 25 个代理定义：每个平台一个审计工作代理，追踪、预算、创意、平台政策和法规合规各有工作代理，四个创意代理（文案撰写、创意策略、格式适配、视觉设计），以及调研和核验代理。
• 每项检查有四种可能结果：pass、fail、unknown 或 not_applicable。unknown 表示缺少数据，技能从不去猜。
• 暂时没有健康度评分。 项目自称是开发候选版本，十二个账户健康度评分配置全部停用。审计改为报告发现、未知项和证据覆盖率：覆盖率 80% 及以上给出评级，60% 到 79% 为暂定，低于 60% 则为证据不足。

你可能在别处看到过的旧数字，250 项检查、带 A 到 F 评级的百分制评分、八个平台，说的都是 v1。现在的技能已经不这样介绍自己了。

底层是怎么运转的

一个统筹者负责这次运行的范围、规则、汇总和最终报告。各个工作代理分析各自划定的一小块，一个平台或一个主题，并按固定的结构返回发现。如果某个必需的工作代理失败，这次运行就会被标记为部分完成：它绝不会被当作一次完整的审计呈现出来。

设置、审计、复核：v2 流程的三个步骤，取自官方仓库。

如果你已经在用 Claude Code 写代码，你会认出这个模式：它就是子代理与代理团队的机制，只不过用在了营销而不是代码上。从 v2.1.0 起，代理不再固定某个模型：除非另有更具体的设置，Claude Code 会用你主对话的模型来运行它们。

一次运行的结果是一个带版本号的 JSON 文件。Markdown、HTML 和 PDF 报告都是对同一个文件的渲染，所以 /ads report 无需重新运行任何东西，就能再次展示过去的某次运行。

实际使用时，整个流程分五步：

1. 运行 /ads setup 并回答它的问题：商业模式、目标、主要转化、月度花费、在投平台，以及谁来批准改动。它会提醒你千万不要在这里粘贴 API 密钥或令牌。
2. 提供证据：CSV 或 JSON 格式的账户导出、截图，或者一段粘贴的摘要，注明日期范围、币种和时区。
3. 运行 /ads audit google 或 /ads audit all。你会看到哪些通过、哪些失败、哪些缺失。
4. 运行 /ads report，再次查看过去的某次运行。
5. 运行 /ads next，查看最重要的阻碍。

十二个平台

每个平台都有自己的技能、自己的审计工作代理、自己的检查项参考和自己的能力声明。仓库里的一份能力清单记录了每个平台上哪些内容可以实时读取或修改。在平台之上，还有横向审计：归因（转化定义、归因窗口、GA4、移动监测合作伙伴）和服务器端追踪（服务器端打标、Conversions API 与 Events API、去重、事件数据质量）。这些往往是人工审计的盲区，因为它们同时需要投放和技术两方面的功底。

命令

一切都通过 /ads 运行。作为 Claude Code 插件安装时，命令带有命名空间，以 /claude-ads:ads 开头；单独安装时，以 /ads 开头。README 列出了这些命令：

平台快捷命令可直接进入单个审计：/ads google、/ads meta、/ads youtube、/ads linkedin、/ads tiktok、/ads microsoft、/ads apple、/ads amazon、/ads reddit、/ads pinterest、/ads snapchat 和 /ads x。

v1 的专项命令仍由技能负责分发：/ads dna 生成网站的品牌与产品定位档案，/ads attribution、/ads tracking、/ads creative、/ads landing、/ads budget，/ads math 计算 CPA、ROAS、MER、LTV:CAC 和盈亏平衡点，/ads competitor，/ads generate 根据经过验证的简报生成图片，/ads photoshoot 生成商品图变体，/ads test 则是 /ads experiment 的别名。用日常语言提出的请求也会交给同样的技能。没有任何技能会渲染视频：视频工作止步于概念和简报。

安全地安装

作者现在写得很直白：优先使用宿主的插件流程，或者经过校验和核对的发布压缩包，千万不要把远程安装脚本直接通过管道交给 shell。本文第一版展示的恰恰就是这种做法，一条 curl | bash 和一条 irm | iex：别再用了。

在 Claude Code 里，使用插件流程：

/plugin marketplace add agricidaniel/claude-ads
/plugin install claude-ads@ai-marketing-hub-claude-ads

如果你在 v2.0.0 之前添加过这个插件市场，Claude Code 仍以旧别名保存着它。先把它移除：

/plugin marketplace remove agricidaniel-claude-ads

在 macOS 或 Linux 上，从一个你已经读过的克隆安装：

git clone https://github.com/AgriciDaniel/claude-ads.git
cd claude-ads
bash install.sh --source=local

在 Windows 上，用 PowerShell 在同一个克隆里运行：.\install.ps1 -Source local。

要固定版本，bash install.sh --source=git --ref=v2.1.0 会检出这个确切的标签，如果标签无法解析就直接失败。经过验证的路径仍然是发布 zip：每个 GitHub 发布版本都会附上 zip、清单、软件物料清单和一个 SHA256SUMS 文件，解压之前，sha256sum -c SHA256SUMS 的每一行都必须显示 OK。发布版本带有校验和，但没有签名。

所需环境：用于托管依赖的 CPython 3.11 或 3.12，Linux 上需要 glibc 2.28 或更高版本，生成 PDF 报告需要 WeasyPrint 和 Pango 库，如果要做浏览器截取，还需要一个 Playwright 浏览器。

安装程序还提供 --target=codex、--target=gemini，以及面向 Cursor、Windsurf 和 Goose 的目标。README 把它们标为实验性的：只有 Claude Code 经过验证，其他宿主可能会以不同方式处理同样的文件。

重看视频里的工作流

让这款技能出名的那个 Instagram 视频展示了三个步骤。下面是它们在 v2.1.0 里的样子。

第一步：安装技能。 用上面的插件流程，而不是粘贴一行命令。

第二步：描述你的业务，然后做规划。 /ads setup 会询问你的产品、目标、转化、预算和平台。如果你有网站，/ads dna <url> 会提取你的品牌与产品定位档案，让方案从你真实的定位出发。接着，/ads plan 制定渠道、投放、预算和衡量方案。

第三步：报告。 /ads report 把保存的运行结果渲染成 Markdown、HTML 或 PDF，可以直接发给客户或你的管理层。

视频简化掉的地方在于：输出的质量取决于证据的质量。回答含糊，得到的就是含糊的方案。没有导出或截图就跑审计，得到的就是满篇 unknown 的报告，这很诚实，但算不上诊断。而且 v2.1.0 里也没有可以拿来炫耀的分数：你得到的是发现，以及账户中有多少部分能够被评判。

你的数据和你的账户

技能在你的终端里运行，分析你提供给它的证据。凭证应该放在环境变量、操作系统的钥匙串或密钥管理器里；绝不能放进仓库、配置档案、报告或日志。

自 v1 以来更大的变化在写入这一侧。v2 有 /ads launch 和 /ads optimize，但每个适配器默认都是只读的，改动一律停留在草稿。要应用其中一项改动，技能必须同时满足以下六条：

1. 针对这一具体操作，经过测试并已启用的能力；
2. 明确的账户 ID 和对象 ID；
3. 一份易读的改动前后 diff，以及它影响到的内容；
4. 所有者的批准，且在为该账户设定的限额之内；
5. 一个幂等键、一个审计记录去处、一个回滚方案和一段核验窗口；
6. 确认账户仍与这次改动所预期的状态一致。

没有设定限额就不会写入，而且 v2 不支持永久删除。

它能取代什么，又不能取代什么

咱们说句实话，因为「取代你月费 3000 欧元的代理公司」这话得掂量掂量。

Claude Ads 做得好的，是这份工作里成体系的那部分。给一个账户跑完所有检查一项不落，把追踪和平台的预期逐一比对，识别创意疲劳，重新算盈亏平衡点，并且清楚说明哪些没能检查。这些是审计里客观、可重复的部分，就连一位优秀的顾问，做起来也比机器慢。

它做不到的：默认情况下替你去按那些按钮，或者了解你的代理公司所了解的那些背景：你的季节性、已经失败过的测试、你和 Google 客户经理的关系。而且和所有 AI 输出一样，它的建议在投入真金白银的媒体预算之前，都得先核实一遍。

正确的定位是：Claude Ads 取代的不是判断力，而是那些花在一条条走清单上、按小时收费的时间。对于自己打理投放的创业者来说，这是一种他此前根本无从获得的审计水准。对于代理公司来说，过去每个账户要耗掉半天的审计，变成了一个每周例行的检查点。

AgentsRoom 里的 Claude Ads：把广告部门摆在研发部门旁边

如果你已经在用代理写代码，从这里开始就有意思了。像 Claude Ads 这样的技能，在终端里手动跑一下，只是一个工具。同样这款技能，交给多代理驾驶舱里的一个专职代理，就成了一个持续运转的职能部门。

AgentsRoom 就是为这个而生的：每个代理都有角色、实时状态和自己的颜色，你在同一个窗口里就能统管整支队伍。没人规定你只能跑代码代理。建一个角色为广告的代理，在它的 Claude Code 上装好 Claude Ads 技能，它就成了你的初级媒介采购员：从任务看板领取审计工单，跑它那些 /ads 命令，再把报告作为产出交上来。

完整的闭环大致是这样。广告代理在周一早上的导出数据上跑 /ads audit all，把发现发到看板上。它揪出的技术问题（一个被重复计算的 GA4 转化、一个配错的 Consent Mode、一个太慢的落地页）会变成工单，由你的研发代理领走并在代码里修复，各自在自己的工作树里作业，好让并行运行的代理彼此永远不会撞车。与此同时，一个 SEO 代理让落地页始终和正在跑的投放对齐。你负责阅读报告，而在任何改动进入广告账户之前，拍板的也是你。

让广告代理跑在 Claude Code 上，这是 Claude Ads 唯一验证过的宿主。你的代码代理可以跑在你喜欢的任何 CLI 上：AgentsRoom 会把它们并排运行在同一个窗口里，无论是哪家提供商，兼容性矩阵里列出了支持的范围。

隔壁那个职能，从来都是最难整合进来的：研发不懂媒体的话，媒体不懂研发的话。一支共享同一个看板的代理队伍，比任何一场周会都更能填平这道鸿沟。

常见问题

Claude Ads 是 Anthropic 做的吗？

不是。Claude Ads 是 Daniel Agrici 为 Claude Code 编写的开源技能，以 MIT 许可证发布在 github.com/AgriciDaniel/claude-ads。Anthropic 做的是 Claude 和 Claude Code，这款技能运行在它们之上。

Claude 里会出现广告吗？

不会。Anthropic 在2026年2月4日的文章《Claude is a space to think》中写道，Claude 将保持无广告：对话旁边没有赞助链接，回答也不会受到广告主的影响。Claude Ads 是用来审计你自己的广告账户的，和 Claude 里的广告无关。

Claude Ads 还会给出百分制评分吗？

v2.1.0 不会。十二个账户健康度评分配置全部停用，所以审计报告的是发现、未知项和证据覆盖率，而不是分数。每项检查的结果都是 pass、fail、unknown 或 not_applicable 之一，unknown 表示缺少数据。

Claude Ads 能修改我的广告投放吗？

不会自作主张。每个适配器默认都是只读的，改动一律停留在草稿。要应用其中一项改动，需要：针对这一具体操作已启用的能力、明确的账户 ID 和对象 ID、改动前后的 diff、账户限额内的所有者批准、回滚方案，以及确认账户在此期间没有变化。v2 不支持永久删除。

Claude Ads 能在 Codex 或 Gemini CLI 上用吗？

它的安装程序有 Codex、Gemini、Cursor、Windsurf 和 Goose 的目标，但 README 把它们标为实验性的：只有 Claude Code 经过验证。如果你想走受支持的路径，就把它装在 Claude Code 上。

装上技能，跑出你的第一个 /ads audit，如果你想让它不用你盯着也能转起来：下载 AgentsRoom，给你的广告部门配上和研发部门一样的基础设施。