에이전시 에이전트 사용법, 클로드 코드에 개발·디자인·마케팅 팀 넣기

클로드 코드에 개발팀, 디자인팀, 검수팀 같은 역할별 에이전트를 한 번에 넣는 오픈소스 "에이전시 에이전트(Agency Agents)" 사용법을 정리했습니다. 짐코딩 채널의 71초 쇼츠가 보여준 홍보 시나리오 7단계를 그대로 따르고, 영상이 고정 댓글로 넘긴 설치 명령과 에이전트 부르는 문장은 공개 저장소 문서를 기준으로 채웠습니다.

혼자 다 하고 있다면 클로드 코드를 제대로 못 쓰는 것

첫마디부터 찌릅니다. "클로드 코드까지 켜 놓고 아직도 혼자 다 하세요." 기획도 디자인도 오류 확인도 전부 직접 하고 있다면 클로드 코드를 제대로 못 쓰고 있는 것이라는 진단입니다. 아래 내용 중 도구 설명은 화자의 설명이고, 결과물 품질은 제가 직접 검증한 것이 아닙니다.

에이전시 에이전트는 무엇을 넣는 도구인가

이름은 에이전시 에이전트(Agency Agents), 오픈소스라고 화자는 말합니다. 설치는 명령 한 줄. 넣으면 클로드 코드 안에 개발팀, 디자인팀, 검수팀이 생긴다는 설명입니다. 여기서 에이전트는 서브 에이전트(한 가지 역할만 맡아 따로 일하는 보조 클로드)를 말합니다.

핵심은 여기입니다. "그냥 너는 개발자야 한 마디 써 놓은 게 아니에요." 담당마다 문서로 적혀 있는 게 세 가지라고 합니다.

• 어떤 순서로 작업하는지
• 어떤 결과물을 내는지
• 마지막에 뭘 확인해야 하는지

역할 한 줄 던져 주고 알아서 하라는 방식과 다르다는 게 화자가 강조하는 차이입니다.

한 가지 짚고 갑니다. 처음 꺼낸 팀 이름은 개발팀·디자인팀·검수팀인데, 뒤에서 예시로 부리는 담당은 개발·디자인·마케팅입니다. 마케팅은 처음 목록에 없었고 검수팀은 실제로 쓰는 장면이 안 나옵니다. 전체 역할 목록은 영상에 없고, 저장소에 들어가 보면 engineering(개발), design(디자인), marketing(마케팅) 같은 부서별 폴더로 나뉘어 있습니다.

화자가 든 예시: 내 서비스 홍보하기

영상에 나오는 시나리오는 하나뿐입니다. "내가 만든 서비스를 홍보하고 싶다면." 여기서부터 아래 7단계가 시작됩니다. 영상이 짚은 동작을 줄이거나 합치지 않고 옮겼습니다.

1단계. 에이전시 에이전트를 설치한다

설치 명령 한 줄을 실행합니다. 영상은 "딱 한 줄이면 됩니다"라고만 말하고 명령을 읽어 주지 않습니다. 공개 저장소(GitHub의 msitarzewski/agency-agents) README 기준으로는 이렇게 합니다.

1. 클로드 코드가 설치돼 있어야 합니다. 없다면 맥 터미널(Cmd+스페이스 → "터미널")에서 curl -fsSL https://claude.ai/install.sh | bash를 실행하고 claude로 로그인합니다.
2. git(코드 저장소를 내려받는 도구)이 필요합니다. 맥은 터미널에 git --version을 치면 없을 때 설치 창이 뜹니다.
3. 아래 명령을 차례로 실행합니다.

git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
./scripts/install.sh --tool claude-code

전부 말고 한 부서만 넣고 싶다면 마지막 줄 대신 이렇게 복사합니다.

cp engineering/*.md ~/.claude/agents/

• 확인: 클로드 코드를 다시 실행하고 /agents를 입력하면 새 에이전트 목록이 보인다.

2단계. 무엇이 들어왔는지 열어본다

담당별 역할 문서를 직접 엽니다. 에이전트 파일은 ~/.claude/agents/ 폴더에 .md 파일로 저장됩니다. 맥 Finder에서 Cmd+Shift+G를 누르고 이 경로를 붙여 넣으면 폴더가 열립니다.

• 확인: 담당마다 일하는 순서, 내야 할 결과물, 마지막에 확인할 것이 적혀 있다.
• 화자는 "직접 열어보고 내 작업에 맞게 지침을 바꿔 써도 된다"고 말합니다.

3단계. 맡길 작업을 정한다

이번에 시킬 일 하나를 고릅니다. 화자의 예시는 "내가 만든 서비스를 홍보하고 싶다"입니다.

• 확인: 한 문장으로 목표를 적을 수 있다.

4단계. 개발 담당에게 소개 페이지를 맡긴다

• 확인: 서비스 소개 페이지 결과물이 나온다.

부르는 문장은 저장소 안내처럼 에이전트 이름을 그대로 넣으면 됩니다. 이름은 파일 맨 위 name: 줄에 적힌 값입니다.

Frontend Developer 에이전트를 써서 내 서비스 소개 페이지를 만들어 줘.
서비스: 동네 필라테스 예약 앱. 대상: 30~40대 직장인.
결과물: index.html 한 장, 모바일에서도 보기 좋게.

5단계. 디자인 담당에게 첫 화면을 다듬게 한다

• 확인: 첫 화면이 보기 좋게 정리된다.
• 4단계에서 페이지가 나와 있어야 다듬을 대상이 생깁니다. 순서가 고정된 지점입니다.

design 부서 에이전트 중 UI 담당을 골라, 방금 만든 index.html의 첫 화면만 다듬어 줘.
구조와 문구는 바꾸지 말고 색, 여백, 글자 크기만 손봐.

6단계. 마케팅 담당에게 인스타그램 홍보 글을 맡긴다

• 확인: 인스타그램용 홍보 글 초안이 나온다.

marketing 부서에서 인스타그램 담당 에이전트를 써서, 이 서비스 홍보 게시물 3개 초안을 써 줘.
각각 첫 문장, 본문 5줄 이내, 해시태그 5개. 과장 표현은 빼.

7단계. 요청하는 방법을 몸에 익힌다

화자가 말한 요청 공식은 세 가지를 한 번에 적는 겁니다.

• 필요한 에이전트 이름
• 맡길 작업

• 원하는 결과

• 확인: 해당 담당이 정해진 순서대로 작업하고 결과물을 낸다.

화자는 이 흐름을 "작업에 맞는 담당을 골라 요청하는 것"이라고 정리합니다. 페이지를 만드는 일부터 사람들에게 알리는 일까지 필요한 역할을 골라 쓰는 방식입니다. 영상에서 쓰는 장면이 없던 검수팀도 같은 공식으로 부를 수 있습니다. 저장소 안내의 예시는 "Use the Reality Checker agent to verify this feature is production-ready"입니다.

비용과 수정

역할별 자료는 전부 무료로 받을 수 있다고 화자는 말합니다. 그리고 열어서 내 작업에 맞게 지침을 바꿔 써도 된다고 덧붙입니다.

무료라는 건 역할 지침 자료 이야기입니다. 클로드 코드 자체 이용료나 토큰 사용량은 따로이고, 요금은 공식 안내를 확인해야 합니다.

화자가 실제로 권한 것

마무리에 질문 두 개를 던집니다. "내 작업에는 어떤 담당부터 붙여야 할까요?", "첫 요청은 어떻게 해야 할까요?" 답은 영상에서 하지 않습니다. 대신 짐코딩 구독과 알림 설정을 요청하고, 고정 댓글에 정리 가이드를 남겨 놨다고 안내합니다.

출처: youtube.com/…