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，給你的廣告部門配上和研發部門一樣的基礎設施。