클로드 코드로 마케팅 팀을 100% 완벽하게 만드는 방법
📺 원본 영상: 클로드 코드로 마케팅 팀을 100% 완벽하게 만드는 방법 🎙️ 채널: 빌더 조쉬 Builder Josh 📅 정리 일자: 2026-04-10 ⚠️ Note: 본 리포트는 영상의 음성을 텍스트로 변환(STT)하여 정리한 것입니다. 화면에 표시된 자료(차트, 코드, 슬라이드 등)는 포함되지 않을 수 있습니다.
개요
이 영상은 Claude Code를 활용하여 마케팅 에이전트 팀을 처음부터 완성까지 구축하는 전 과정을 다룬다. 단순히 Claude에게 콘텐츠 제작을 지시하는 수준을 넘어, 브랜드 가이드라인 세팅부터 서브 에이전트(Sub-agent) 팀 구성, 그리고 Buffer API를 통한 소셜미디어 자동 배포까지 실무적인 마케팅 자동화 파이프라인의 전체 흐름을 보여준다. 강연자가 가장 강조하는 핵심 철학은 “실행 시간의 5%, 하네스(Harness) 세팅에 95%의 시간을 투자하라”는 것이다.
00:07 - 나노바나나 MCP로 생성된 브랜드 가이드라인에 맞춘 카드 뉴스 결과물 화면
핵심 철학: 왜 95%의 시간을 세팅에 써야 하는가
Claude Code를 처음 접하는 많은 사람들이 빠지는 함정이 있다. 바로 아무런 사전 준비 없이 Claude에게 곧바로 작업을 지시하는 것이다. 강연자는 이 방식이 불일관된 결과물, 낮은 품질, 그리고 반복적인 수정 작업으로 이어진다고 강조한다. 이를 해결하기 위한 개념이 바로 하네스(Harness) 세팅이다. 마치 말을 달리게 하기 전에 안장과 고삐를 단단히 채우듯, Claude가 일관된 결과물을 낼 수 있도록 컨텍스트(Context), 템플릿(Template), 스킬(Skills), 에이전트(Agent) 정의를 미리 완비해두는 작업 전체를 가리킨다.
강연자에 따르면, 고품질 결과물을 위한 작업 시간 구성은 하네스 세팅에 95%, 실제 실행에 5%다. 이 비율이 역전될수록 Claude는 엉뚱한 방향으로 결과물을 내보내거나, 매번 다른 스타일의 산출물을 생성하게 된다. 비즈니스 세계에서의 SOP(Standard Operating Procedure, 표준 업무 절차)와 동일한 개념을 AI에 적용하는 것이 하네스 세팅의 본질이며, 강연자는 이 사전 준비 작업이야말로 “Claude Code를 잘 쓰는 방법 중 하나”라고 단언한다.
1단계: 개발 환경 준비 및 폴더 구조 세팅
강연자는 Cursor IDE를 사용하고, VS Code Extension 형태의 Claude Code 확장 프로그램을 설치하여 진행한다. 확장 프로그램 마켓플레이스에서 “Claude Code”를 검색하면 “Claude Code for VS Code” 확장 프로그램을 찾을 수 있으며, 이를 설치한 후 “Claude Code Open” 메뉴를 통해 해당 프로젝트 폴더에서 Claude Code를 실행한다. VS Code나 다른 에디터를 사용해도 인터페이스가 대부분 비슷하기 때문에 동일하게 적용할 수 있다.
프로젝트 폴더를 생성한 뒤 가장 먼저 해야 할 일은 두 개의 핵심 하위 폴더를 만드는 것이다. 첫 번째는 context 폴더, 두 번째는 templates 폴더다. context 폴더에는 우리 회사의 브랜드 가이드라인, 디자인 스타일 가이드, 비즈니스 맥락 같은 내용을 Markdown(.md) 파일 형태로 저장한다. templates 폴더에는 카드 뉴스, PPT, 뉴스레터, 유튜브 썸네일 등의 레퍼런스 이미지나 템플릿 파일을 넣는다. AI 모델은 Markdown 형식의 파일을 가장 효율적으로 파싱하고 이해하기 때문에, 이 구조 자체가 이후 모든 품질의 출발점이 된다.
2단계: 맥락(Context) 문서 생성
컨텍스트 문서는 반드시 수작업으로 직접 작성할 필요가 없다. 강연자는 자신의 AX 에이전시 웹사이트의 스크린샷을 캡처하여 Claude에게 전달하고, 다음과 같이 지시한다. “이 웹사이트 스크린샷은 나의 AX 에이전시 웹사이트 스크린샷이야. 이 내용을 파악하고, 우리 회사의 간단한 브랜드 가이드라인, 디자인 스타일 가이드, 비즈니스 맥락 세 가지 파일을 Markdown 파일로 만들어줘. 그 파일은 context 폴더에 생성해줘.” 이렇게 하면 Claude는 웹사이트의 색상, 폰트, 브랜드 보이스, 타겟 고객, 서비스 라인 등을 분석하여 세 개의 맥락 문서를 자동으로 생성한다.
05:46 - context 폴더에 자동 생성된 브랜드 가이드라인, 비즈니스 컨텍스트, 디자인 스타일 가이드 세 개의 MD 파일 목록
생성된 파일들을 살펴보면, 브랜드 가이드라인에는 브랜드 보이스(자신감 있는 전문가, 실용적 비전 등)와 카피라이팅 키워드가 담기고, 비즈니스 컨텍스트에는 타겟 고객(AI를 도입하고 싶지만 방법을 모르는 기업), 서비스 라인(교육·개발·진단), 고객 페인포인트가 정리된다. 디자인 스타일 가이드에는 웹사이트에서 분석된 타이포그래피 정보, 예를 들어 “매우 굵고 큰 산세리프(sans-serif) 폰트를 헤드라인으로 사용한다”는 식의 내용이 포함된다. 이미 사내에 브랜드 가이드라인 문서가 존재한다면 해당 내용을 Markdown으로 변환하여 context 폴더에 바로 넣어도 된다. 방식보다 중요한 것은 맥락 문서가 얼마나 정확하고 풍부하게 채워져 있느냐이기 때문이다.
3단계: 템플릿(Template) 수집 및 이미지 효율화
templates 폴더에는 앞으로 만들 콘텐츠들의 디자인 방향성을 잡아줄 레퍼런스 이미지들을 모아둔다. 강연자는 Pinterest에서 “인스타그램 카드 뉴스 템플릿”을 검색하여 원하는 스타일의 이미지를 다운로드하고, Figma에서 제작한 유튜브 썸네일 템플릿 이미지도 함께 저장한다. 이미지 파일명은 card_news_1.jpg, card_news_2.jpg, thumbnail_1.jpg 같이 목적이 명확하게 드러나도록 붙여둔다.
여기서 중요한 효율화 포인트가 등장한다. Claude가 작업할 때마다 원본 이미지 파일을 직접 읽게 하면 토큰 소모가 매우 크다. 이를 해결하기 위해 강연자는 이미지를 한 번만 Claude에게 보여주고, 해당 이미지를 분석한 내용을 Markdown 파일로 저장하도록 지시한다. “이 이미지를 바탕으로 PPT 템플릿 Markdown 파일을 만들어줘, 항상 참조할 수 있는 형태로”라고 지시하면, Claude는 이미지의 레이아웃, 색상 팔레트, 디자인 구성 요소를 텍스트로 기술한 Markdown 파일을 생성한다. 이후에는 원본 이미지 대신 이 Markdown 파일만 참조하게 함으로써 토큰 소모를 크게 줄이고 효율적으로 운영할 수 있다. 뉴스레터 템플릿의 경우에도 강연자가 운영하는 개인 뉴스레터의 URL을 Claude에게 전달하여 “이 내용을 참고해서 뉴스레터 형식 템플릿으로 templates 폴더에 md 파일로 저장해줘”라고 지시하는 방식으로 자동화한다.
4단계: CLAUDE.md 파일 - 프로젝트 두뇌의 역할
context와 templates 폴더 세팅이 완료된 후 가장 중요한 단계가 이어진다. 바로 CLAUDE.md 파일의 생성이다. 이 파일은 전체 프로젝트의 시스템 문서이자 SOP와 같은 역할을 한다. 내부에는 전체 폴더 구조, 각 에이전트의 역할, 사용할 스킬 목록, 프로젝트 전반의 맥락이 명시된다.
CLAUDE.md 없이 매 작업마다 Claude가 폴더 전체를 탐색하고 파악하게 하면 시간이 오래 걸리고 일관된 결과물이 나오지 않는다. 반면 CLAUDE.md가 잘 작성되어 있으면, Claude는 이 한 파일을 읽는 것만으로도 전체 프로젝트의 맥락, 규칙, 에이전트 구성을 파악하고 일관되게 동작한다. 강연자는 이것이 “항상 AI에게 일관된 것을 만들어주는 강력한 장치”라고 표현한다. CLAUDE.md 생성 방법은 간단하다. Claude에게 “전체 프로젝트의 폴더를 스캔해서 맥락을 파악하고, 마케팅 에이전트 팀에 걸맞는 파일로 생성해줘”라고 지시한다. 이때 IDE 확장 프로그램용 폴더 등은 무시하도록 예외 처리를 함께 명시한다.
12:41 - 생성된 CLAUDE.md 파일 내용 화면 - 프로젝트 케어, 브랜드 핵심, 프로젝트 구조, 작업 규칙 섹션 표시
에이전트들이 추가된 이후에는 에이전트 라우팅 룰(Routing Rule), 즉 어떤 작업에 어떤 에이전트를 사용할지를 지정하는 규칙도 이 파일에 추가하게 된다. 이로써 CLAUDE.md는 단순한 소개 문서를 넘어, 팀 전체의 일하는 방식을 정의하는 살아있는 문서로 진화한다.
5단계: 공식 스킬(Skills) 설치
Anthropic은 Claude Code에서 사용할 수 있는 공식 스킬을 GitHub(anthropics/skills 레포지토리)를 통해 제공한다. 이 스킬들을 설치하면 Claude가 결과물 형식을 임의로 만들지 않고, 규격에 맞는 PPTX, DOCX, PDF 같은 파일을 일관되게 생성할 수 있다. 설치 방법은 해당 GitHub 주소를 복사한 후, Claude Code 확장 프로그램의 플러그인(Plugins) 탭 → 마켓플레이스(Marketplace)에서 해당 주소를 붙여넣고 추가(Add)하는 것이다. 이후 “document”로 검색하면 문서 생성 스킬이 나타나며, “Install for this project”를 선택하면 현재 프로젝트에만 적용된다. 설치가 완료되면 settings.json에 해당 스킬이 등록된 것을 확인할 수 있다.
스킬이 설치된 후 PPT 생성을 테스트하는 방법은 다음과 같다. Claude Code에서 /를 입력하면 PPTX 스킬이 목록에 나타나고, 이를 선택한 뒤 “조슈아의 사업 소개서를 만들어줘. 우리가 가지고 있는 템플릿과 컨텍스트가 잘 반영될 수 있도록 해줘”라고 지시한다. 강연자는 테스트 단계에서 반드시 “만일 반영이 잘 안 되어 있다면 CLAUDE.md에 앞으로 잘 반영될 수 있도록 업데이트해줘”라는 문구를 추가하여 자기개선(Self-improvement) 루프를 만들도록 권장한다. 이를 통해 첫 시도에서 나온 부족함이 다음 작업에는 자동으로 반영되는 구조가 만들어진다. 또한 Claude가 작업 중에 사용자에게 매번 확인을 구하지 않도록 “Bypass Permission” 옵션을 활성화하는 것이 중요하다.
15:59 - 브랜드 가이드라인 기반으로 생성된 사업 소개 PPT 슬라이드 전체 화면
6단계: Gemini MCP 연결 - 이미지 생성 파워 추가
카드 뉴스처럼 고품질 이미지가 필요한 콘텐츠를 제작하기 위해 강연자는 Gemini API의 이미지 생성 기능을 MCP(Model Context Protocol)를 통해 Claude Code에 연결한다. 강연자에 따르면 현존하는 이미지 생성 API 중 Gemini가 가장 월등한 성능을 제공하기 때문에 선택했다고 한다.
연결에 사용하는 도구는 한국의 Vibe Mafia 커뮤니티에서 활동하는 최수민 님이 제작한 나노바나나(Nanobanana) MCP다. 이 MCP의 GitHub 레포지토리에서 Claude Code 설치 명령어를 복사하여 Claude Code에 붙여넣으면 설치가 진행된다. 이때 반드시 Your API Key here 부분을 실제 Gemini API 키로 교체해야 한다. API 키는 Google AI Studio(aistudio.google.com)의 “Get API Key” 메뉴에서 발급받을 수 있다. 강연자는 API 키 관련 두 가지 중요한 주의 사항을 명시한다. 첫째, API 키는 절대 외부에 노출되어서는 안 된다. 둘째, 무료 등급으로는 이미지 생성 모델이 제한되므로, 고품질 이미지를 위해서는 결제 계정으로 업그레이드해야 한다.
MCP 설치 후 Claude Code를 재실행하고 /mcp를 입력하면 나노바나나 MCP가 연결 목록에 나타나는 것으로 정상 설치를 확인할 수 있다. 이후 “나노바나나 MCP를 활용해서 우리 가이드라인에 맞는 회사 소개 카드 뉴스 5장을 생성해줘”라고 지시하면, Claude는 CLAUDE.md에 명시된 규칙에 따라 브랜드 가이드라인과 템플릿을 먼저 확인한 후 카드 뉴스를 생성한다. 강연자는 이 방식이 Claude Code 내에서 직접 이미지 생성 코드를 작성하는 것보다 훨씬 빠르고 효율적이라고 평가한다.
7단계: 마케팅 에이전트 팀 설계
스킬과 MCP가 준비되었으면 이제 전문화된 에이전트 팀을 구성할 차례다. 강연자는 Claude에게 “Claude Code의 공식 가이드라인을 따라서, 우리 프로젝트에 걸맞는 마케팅 에이전트 팀 계획도를 제시해줘. 순서는 리서치, 콘텐츠 제작, 디자인, 검수 이런 형식이 있을 것 같은데, 추천해줬으면 좋겠어”라고 지시한다.
Claude가 제안한 결과는 4단계 마케팅 파이프라인이다. 1단계 리서치 에이전트는 웹 검색과 데이터 수집을 담당하며 회사 맥락에 맞는 인사이트를 도출한다. 2단계 콘텐츠 에이전트는 리서치 결과를 바탕으로 뉴스레터 원고, 카드 뉴스 카피 등 텍스트 콘텐츠를 제작한다. 3단계 디자인 에이전트는 나노바나나 MCP와 PPTX 스킬을 활용하여 시각 콘텐츠를 생성한다. 4단계 검수 에이전트(Review Agent)는 생성된 모든 콘텐츠가 브랜드 가이드라인에 부합하는지 최종 검토한다. 강연자는 각 에이전트의 역할 설명, 수행 작업, 참조 문서 목록 등 세부 내용까지 Claude가 충실하게 제시해준 것이 “정말 중요한 부분”이라고 평가한다.
22:23 - Claude가 제안한 4단계 마케팅 에이전트 파이프라인 구조도 및 각 에이전트 세부 사양
에이전트 생성 시 반드시 지켜야 할 원칙이 하나 있다. 지시문에 “Claude Code의 공식 서브 에이전트 제작 가이드를 따라줘”라는 문구를 명시적으로 포함해야 한다는 것이다. 이를 명시하지 않으면 Claude가 임의의 구조로 에이전트를 생성해 호환성 문제가 생길 수 있기 때문이다. 공식 가이드라인에 따라 생성된 에이전트 파일은 이름(name), 설명(description), 사용 도구(tools), 모델(model) 항목이 명시된 형태로 .claude/agents/ 폴더에 저장된다. 에이전트 생성 후에는 반드시 CLAUDE.md에 라우팅 룰을 추가하여, 특정 종류의 작업 요청이 들어왔을 때 Claude가 적합한 에이전트를 자동으로 선택하고 실행할 수 있도록 해야 한다.
8단계: 에이전트 팀 개별 테스트
전체 팀을 구동하기 전에, 강연자는 각 에이전트를 개별적으로 테스트하여 정상 동작 여부를 확인한다. 리서치 에이전트 테스트는 “리서치 에이전트 md를 불러오고, AI 자동화 트렌드 주제로 리서치해줘”라고 지시하는 방식으로 진행된다. 결과물은 회사 맥락에 맞게 정제된 핵심 팩트들을 출처와 함께 Markdown 형태로 제공한다. 단순한 일반 정보가 아니라 context 폴더의 비즈니스 맥락을 반영한 맞춤형 인사이트가 생성된다는 점이 핵심이다. 강연자는 “어느 정도 범위를 좁혀서 제공해주는 게 훨씬 더 퀄리티가 높은 결과를 줄 수 있다”고 설명한다.
디자인 에이전트 테스트에서는 “AI 도입, 왜 실패할까”라는 주제의 카드 뉴스 샘플이 생성된다. 브랜드 가이드라인에 맞는 레이아웃과 회사 슬로건이 반영된 결과물이 나오며, 강연자는 “저희 회사의 디자인 가이드라인을 잘 따른 것 같고, 저희 회사의 내용도 잘 홍보해서 보여주는 것 같다”고 평가한다.
9단계: 에이전트 팀 병렬 실행 - 전체 마케팅 캠페인 생성
개별 테스트가 완료되면, 이제 전체 에이전트를 병렬로 구동하여 완전한 마케팅 캠페인 결과물을 한 번에 생성한다. 강연자는 다음과 같이 지시한다. “조슈아 마케팅 캠페인을 만들고 싶어. 뉴스레터, 카드 뉴스, 유튜브 썸네일, 프레젠테이션까지 모든 자료를 만들어줘. 상대방 기업의 AX 현황 진단 사항과 우리가 해결할 수 있는 내용을 홍보할 수 있도록 해줘. 모든 에이전트 팀을 가동해서 진행시켜줘. 결과물은 output 폴더에 저장해줘.”
이 명령 하나로 Claude는 전체 파이프라인을 자동으로 가동한다. 먼저 모든 컨텍스트 파일과 에이전트 정의를 확인하고, 템플릿도 파악한 후 병렬 처리를 통해 동시에 여러 산출물을 생성하기 시작한다. 전체 제작 소요 시간은 약 10분 정도라고 강연자는 언급한다.
31:13 - 전체 에이전트 팀 병렬 실행 후 생성된 카드 뉴스 결과물 화면
결과물을 구체적으로 살펴보면, 카드 뉴스는 브랜드 가이드라인에 맞는 디자인으로 생성되며 회사 서비스를 홍보하는 내용을 담는다. PPT는 레이아웃과 내용 면에서 충실하나 폰트는 추가 조정이 필요한 수준이다. 뉴스레터는 헤더, 후킹 타이틀, 서론, 본문(숫자로 보는 현실 → 원인 분석 → 해결 방향) 구조로 완성도 있게 작성된다. 유튜브 썸네일의 경우 16:9 비율로 생성되나, 강연자 스스로도 가이드라인을 충분히 전달하지 않아 원하는 스타일과 다소 차이가 있었다고 솔직하게 인정한다. 이는 사전 템플릿 설정이 더 구체적이어야 했음을 보여주는 실질적인 교훈이다.
10단계: Buffer API를 통한 소셜미디어 자동 배포
마케팅 자동화의 마지막 단계는 생성된 콘텐츠를 자동으로 소셜미디어에 배포하는 것이다. 강연자는 이를 위해 Buffer API를 활용한다. Buffer는 LinkedIn, Threads, X(구 Twitter) 등 여러 소셜미디어 플랫폼에 예약 포스팅을 한꺼번에 관리할 수 있는 서비스로, 최근 개발자 API(베타)를 공개하여 외부 애플리케이션에서의 자동화를 지원하기 시작했다.
설정 절차는 다음과 같다. 먼저 Buffer 웹사이트에서 소셜미디어 계정들을 연동한다. 그 다음 Buffer Developer API 페이지에서 Personal Access Token을 발급받고, 이 키를 프로젝트 폴더의 .env 파일에 BUFFER_API_KEY=발급받은_키 형태로 저장한다. .env 파일은 API 키를 코드 외부에 분리하여 보관하는 표준적인 방식으로, 이 파일은 절대 Git 저장소에 커밋하거나 외부에 공개되어서는 안 된다.
이후 Claude Code에서 “버퍼 API 키를 .env 파일에 저장해 놓았어. 예약 포스팅 기능을 테스트해줘. output 폴더에 있는 카드 뉴스 파일을 Threads에 4월 9일 오후 2시로 예약 포스팅해줘”라고 지시하면, Claude는 필요한 라이브러리를 자동으로 설치하고 Buffer API를 호출하여 예약 포스팅을 생성한다. Buffer 대시보드에서 이미지가 포함된 예약 포스팅이 정상적으로 등록된 것을 확인할 수 있다.
37:16 - Buffer 대시보드에서 카드 뉴스 이미지와 함께 예약 포스팅이 등록된 화면
이 기능이 완전히 구축되면, 마케팅 에이전트가 콘텐츠를 생성하는 순간부터 소셜미디어 예약 배포까지 인간의 개입 없이 자동으로 처리되는 파이프라인이 완성된다.
마무리 / 핵심 정리
강연자는 전체 과정을 다음 다섯 단계로 요약한다. 첫째, 회사 맥락이 담긴 context 폴더와 디자인 레퍼런스가 담긴 templates 폴더를 세팅하는 것이 출발점이다. 둘째, Anthropic 공식 GitHub에서 문서 생성 스킬을 설치하여 규격화된 파일 출력 기반을 갖춘다. 셋째, CLAUDE.md 파일을 작성하여 전체 프로젝트의 SOP를 정의한다. 에이전트 추가 이후에는 라우팅 룰도 여기에 포함시킨다. 넷째, 공식 가이드라인에 따라 서브 에이전트를 만들고 각 에이전트를 개별적으로 테스트하여 정상 동작을 검증한다. 다섯째, Buffer API 같은 외부 서비스와 연동하여 콘텐츠 생성에서 자동 배포까지의 완전한 파이프라인을 구성한다.
강연자가 이 영상 전반에 걸쳐 일관되게 강조하는 메시지는 하나다. Claude에게 무언가를 시키기 전에 충분한 맥락과 구조를 먼저 만들어줘야 한다는 것이다. 하네스 세팅에 투자한 시간이 결국 결과물의 품질과 일관성을 결정하며, 이것이 Claude Code를 단순한 챗봇이 아닌 진정한 ‘마케팅 팀’으로 만드는 핵심 비결이다. 준비 없이 실행에 뛰어드는 것이 아니라, 철저한 사전 설계를 통해 AI가 최대한의 역량을 발휘할 수 있는 환경을 만드는 것 — 그것이 이 영상이 전달하는 가장 중요한 교훈이다.
📚 출처 및 참고
| 구분 | 내용 |
|---|---|
| 원본 영상 | 클로드 코드로 마케팅 팀을 100% 완벽하게 만드는 방법 |
| 채널 | 빌더 조쉬 Builder Josh |
| 리포트 작성 | 2026-04-10 |
| 작성 방식 | YouTube 영상 STT 변환 후 에디팅 |
💬 본 리포트는 영상 내용을 바탕으로 재구성되었습니다. 정확한 내용은 원본 영상을 참조해 주세요.