Claude Ads: 광고 계정을 감사해 주는 Claude Code 스킬

인스타그램에서 이런 영상을 봤을지도 모르겠습니다. "월 3,000유로짜리 광고 대행사의 일을 10분 만에 끝내라"는 영상이죠. 다소 판매용 문구 같은 훅 뒤에는 엄연히 실재하는 오픈소스 프로젝트가 있습니다. 바로 Claude Ads입니다. 광고 계정 데이터를 읽고, 무엇이 잘 되고 있는지, 무엇이 망가졌는지, 무엇부터 고쳐야 하는지 알려 주는 Claude Code 스킬이죠. 2026년 10월 기준 GitHub 스타 10,000개 이상, MIT 라이선스입니다.

2026년 10월 16일에 출시된 Claude Ads v2.1.0에 맞춰 2026년 10월 21일에 업데이트했습니다. 이 글의 첫 버전은 v1.7.1을 설명했습니다. v2부터 스킬은 8개가 아니라 12개 플랫폼을 다루고, 더 이상 100점 만점 점수를 내지 않으며, 제작자는 예전에 저희가 소개했던 한 줄 설치를 하지 말라고 경고합니다. 아래 내용은 모두 v2.1.0의 README와 스킬 파일로 확인했습니다.

Claude Ads란 정확히 무엇인가

Claude Ads는 Daniel Agrici가 만든 Claude Code 스킬입니다. 스킬이란 코드 에이전트가 필요할 때 불러오는 지시문, 참고 자료, 에이전트의 묶음입니다. 여기서는 유료 광고 감사관의 노하우가 모듈 단위로 쪼개져 담겨 있습니다. 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개의 에이전트 정의: 플랫폼마다 감사 워커 하나, 트래킹, 예산, 크리에이티브, 광고 정책, 규제 준수를 맡는 워커, 크리에이티브 에이전트 4개(카피라이터, 크리에이티브 전략가, 포맷 변환, 비주얼 디자이너), 그리고 리서치와 검증 에이전트.
• 점검마다 네 가지 결과: pass, fail, unknown, not_applicable. unknown은 데이터가 없었다는 뜻이며, 스킬은 그것을 절대 추측하지 않습니다.
• 당분간 건강도 점수 없음. 프로젝트는 스스로를 개발 후보 버전이라고 부르며, 12개의 계정 건강도 점수 프로필이 모두 비활성화되어 있습니다. 대신 감사는 발견 사항, 확인 불가 항목, 근거 커버리지를 보고합니다. 커버리지 80% 이상이면 등급을 매기고, 60~79%면 잠정, 60% 미만이면 근거 부족입니다.

다른 곳에서 읽었을 수도 있는 예전 수치, 즉 250개 점검 항목, A부터 F까지 등급이 붙은 100점 만점 점수, 8개 플랫폼은 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를 실행합니다.

12개 플랫폼

플랫폼마다 전용 스킬, 전용 감사 워커, 전용 점검 항목 참고 자료, 전용 기능 선언이 있습니다. 저장소의 기능 매니페스트가 각 플랫폼에서 무엇을 실시간으로 읽거나 바꿀 수 있는지 기록합니다. 플랫폼 위에는 횡단 감사가 더해집니다. 어트리뷰션(전환 정의, 기여 기간, 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, CPA, ROAS, MER, LTV:CAC, 손익분기점을 계산하는 /ads math, /ads competitor, 검증된 브리프로 이미지를 만드는 /ads generate, 제품 사진 변형을 만드는 /ads photoshoot, 그리고 /ads experiment의 다른 이름인 /ads test입니다. 일상적인 말로 요청해도 같은 스킬로 이어집니다. 동영상을 렌더링하는 스킬은 없습니다. 동영상 작업은 콘셉트와 브리프에서 멈춥니다.

안전하게 설치하기

제작자는 이제 분명하게 적어 둡니다. 호스트의 플러그인 흐름이나 체크섬으로 검증한 릴리스 아카이브를 쓰고, 원격 설치 스크립트를 셸로 바로 파이프하지 말라고요. 이 글의 첫 버전은 바로 그것, 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뿐이며, 다른 호스트는 같은 파일을 다르게 처리할 수 있습니다.

영상 속 워크플로, 다시 보기

이 스킬을 유명하게 만든 인스타그램 영상은 세 단계를 보여 줍니다. v2.1.0 기준으로 다시 보면 이렇습니다.

1단계: 스킬 설치. 붙여 넣는 한 줄 명령어가 아니라, 위에서 소개한 플러그인 흐름으로 설치합니다.

2단계: 비즈니스를 설명하고 계획 세우기. /ads setup이 오퍼, 목표, 전환, 예산, 플랫폼에 대해 묻습니다. 웹사이트가 있다면 /ads dna <url>이 브랜드와 오퍼 프로필을 추출해, 계획이 실제 포지셔닝에서 출발하게 합니다. 그다음 /ads plan이 채널, 캠페인, 예산, 측정 계획을 세웁니다.

3단계: 리포트. /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에서 지원되지 않습니다.

무엇을 대체하고, 무엇을 대체하지 않는가

솔직하게 말해 봅시다. "월 3,000유로짜리 대행사를 대체한다"는 말에는 단서가 필요합니다.

Claude Ads가 잘하는 것: 이 일의 체계적인 부분입니다. 계정에 모든 점검을 하나도 빠짐없이 돌리고, 트래킹을 플랫폼이 기대하는 설정과 맞춰 보고, 크리에이티브 피로도를 찾아내고, 손익분기점을 다시 계산하고, 확인하지 못한 것을 분명히 말해 주는 일. 감사 중에서 객관적이고 반복 가능한 부분이며, 뛰어난 컨설턴트라도 기계보다 느리게 하는 부분입니다.

하지 않는 것: 기본적으로 나 대신 버튼을 누르는 일, 그리고 대행사가 알고 있는 맥락을 아는 일입니다. 사업의 계절성, 이미 실패한 테스트, Google 영업 담당자와의 관계 같은 것들이죠. 그리고 모든 AI 결과물처럼, 실제 매체 예산을 투입하기 전에 그 권고를 확인해야 합니다.

올바른 관점은 이렇습니다. Claude Ads는 판단력을 대체하는 것이 아니라, 체크리스트를 훑는 데 청구되던 시간을 대체합니다. 직접 캠페인을 운영하는 창업자에게는 이전에는 갖지 못했던 수준의 감사입니다. 대행사에게는 계정당 반나절이 걸리던 감사를 주간 점검으로 바꿔 줍니다.

AgentsRoom 안의 Claude Ads: 개발 부서 옆에 두는 광고 부서

이미 에이전트로 코드를 작성하고 있다면, 여기서부터가 흥미롭습니다. Claude Ads 같은 스킬을 터미널에서 손으로 실행하면 그건 도구입니다. 같은 스킬을 멀티 에이전트 콕핏에서 전담 에이전트에게 맡기면, 계속 돌아가는 사업 부서가 됩니다.

AgentsRoom은 바로 이것을 위해 만들어졌습니다. 각 에이전트에는 역할, 실시간 상태, 고유한 색상이 있고, 하나의 창에서 전체 플릿을 감독합니다. 코드 에이전트만 돌려야 할 이유는 없습니다. 광고 역할을 가진 에이전트를 만들고, 그 Claude Code에 Claude Ads 스킬을 설치하면, 그 에이전트가 내 주니어 미디어 바이어가 됩니다. 백로그에서 감사 티켓을 가져가고, /ads 명령어를 실행하고, 리포트를 결과물로 내놓습니다.

전체 루프는 이렇습니다. Ads 에이전트가 월요일 아침 내보내기 파일로 /ads audit all을 실행하고, 발견 사항을 백로그에 올립니다. 에이전트가 찾아낸 기술적인 문제(두 번 집계되는 GA4 전환, 잘못 설정된 Consent Mode, 너무 느린 랜딩 페이지)는 개발 에이전트가 가져가 코드에서 고치는 티켓이 됩니다. 각자 자신의 워크트리에서 작업하므로 병렬로 실행되는 에이전트끼리 서로 부딪히지 않습니다. 그동안 SEO 에이전트는 랜딩 페이지를 운영 중인 캠페인에 맞춰 유지합니다. 나는 리포트를 읽고, 변경이 광고 계정에 닿기 전에 승인하는 사람도 바로 나입니다.

Ads 에이전트는 Claude Ads가 검증한 유일한 호스트인 Claude Code에서 돌리세요. 코드 에이전트는 원하는 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는 지금도 100점 만점 점수를 주나요?

v2.1.0에서는 주지 않습니다. 12개의 계정 건강도 점수 프로필이 모두 비활성화되어 있어, 감사는 점수 대신 발견 사항, 확인 불가 항목, 근거 커버리지를 보고합니다. 모든 점검은 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을 다운로드하고, 광고 부서에도 개발 부서와 같은 인프라를 갖춰 주세요.