클로드 코드, 아직도 혼자 다 하나요? Agency Agents 설치·사용법

Agency Agents(에이전시 에이전트)는 클로드 코드(Claude Code)에 개발·디자인·콘텐츠 등 역할별 작업 지침을 넣어 쓰는 오픈소스 도구예요.
설치 방법부터 추천 AI 에이전트 4가지, 요청문 예시와 비용·장단점까지 정리해 봤어요.

 

클로드 코드로 페이지도 만들고, 디자인도 고치고,
홍보 글까지 혼자 준비하고 계신가요?

 

AI가 일을 도와주기는 하는데, 작업이 바뀔 때마다
“이건 이렇게 해줘”, “마지막에는 이것도 확인해줘”를 다시 설명하게 되죠.

 

이럴 때는 한 번에 모든 일을 시키기보다
개발은 개발 담당에게, 디자인은 디자인 담당에게 나눠 맡기는 방법도 있어요.
(설치한다고 회사 하나가 알아서 돌아가는 도구는 아니에요.)

 

 

개발 → 디자인 → 콘텐츠 → 검수로 나눠보는 활용 예시예요. 실제 제품 화면이 아닌 설명 도식이에요.

 

1. Agency Agents란? 클로드 코드 역할별 에이전트 모음

 

이름만 보면 별도의 AI 서비스 같지만,
쉽게 말하면 AI에게 건네는 역할별 업무 설명서 모음이에요.

 

공식 저장소에는 개발, 디자인, 마케팅, 테스트 등
여러 분야의 작업 지침이 Markdown 파일로 정리돼 있어요.

 

“너는 개발자야”라고 역할만 붙여주는 게 아니라,
어떤 순서로 일하고, 무엇을 만들어야 하고,
마지막에 무엇을 확인할지까지 담겨 있는 방식이에요.

 

예를 들어 개발 담당은 화면 구현과 테스트에,
디자인 담당은 화면 배치와 컴포넌트 기준에 집중하도록 나눌 수 있어요.
같은 페이지를 보더라도 살펴보는 부분이 달라지는 거죠.

 

여기서 역할 파일 모음과 설치 앱은 구분하면 좋아요.

 

• Agency Agents 저장소: 역할별 지침 파일이 모여 있는 곳이에요.
• Agency Agents 앱: 필요한 역할을 찾아 Claude Code, Cursor, Codex 같은 지원 도구에 설치하고 관리하는 앱이에요.

 

앱이 직접 AI 작업을 실행하는 것은 아니에요.
실제 작업은 클로드 코드 같은 연결 대상 도구에서 진행해요.

 

2. 추천 AI 에이전트 4가지: 개발·디자인·콘텐츠·검수

 

처음부터 전부 설치할 필요는 없어요.
지금 가장 자주 하는 일에 맞춰 하나부터 골라보면 돼요.

 

필요한 일	역할 이름	요청할 결과물
소개 페이지 만들기	Frontend Developer	페이지 파일과 실행 방법
화면 구성 점검하기	UI Designer	문제 위치와 개선안
블로그·홍보 글 쓰기	Content Creator	글 초안과 콘텐츠 구성
결과가 맞는지 확인하기	Reality Checker	확인 근거와 수정할 항목

 

역할 이름이 조금 거창해 보여도,
결국 “누구에게 무엇을 받아볼 것인지”를 정하는 것이라고 생각하면 편해요.

 

글이 필요하면 콘텐츠 담당부터,
페이지는 있는데 화면이 어수선하다면 디자인 담당부터 시작하면 되겠죠.

 

다만 역할을 추가한다고 모델이 갑자기 더 똑똑해지는 것은 아니에요.
지침이 작업 방향을 잡아줄 수는 있지만,
결과의 정확도나 작업 속도까지 보장하는 건 아니고요.

 

3. Agency Agents 설치 방법: Claude Code에 연결하기

 

터미널이 익숙하지 않다면 공식 데스크톱 앱을 살펴보세요.
macOS, Windows, Linux용이 제공돼요.

 

기본 흐름은 이렇게 보면 돼요.

 

1. 운영체제에 맞는 앱을 내려받아요.
2. 역할 설명을 읽고 필요한 담당을 골라요.
3. 설치할 도구로 Claude Code 등을 선택해요.
4. 해당 도구에서 역할이 보이는지 확인하고 작은 작업을 맡겨봐요.

 

(클로드 코드 설치와 로그인은 별도로 준비해야 해요.)

 

 

공식 앱의 대시보드예요. 역할 목록의 규모와 도구별 설치 현황을 보여줘요. 화면 속 숫자는 예시 이미지 기준이에요. 출처: Agency Agents / Michael Sitarzewski.

 

직접 파일을 관리한다면 클로드 코드의 기본 경로도 알아두면 좋아요.

 

• 사용자 공통 역할: ~/.claude/agents/
• 해당 프로젝트에서만 쓸 역할: .claude/agents/

 

여기서 ~/는 사용자 홈 폴더를 뜻해요.
설정에 따라 경로가 달라질 수 있으니 공식 설치 안내를 함께 확인해 주세요.

 

설치 후에는 클로드 코드의 /agents 메뉴에서 역할을 확인해 보세요.
답변에 “저는 개발 담당입니다”라고 나오는 것과
실제로 해당 서브에이전트에 작업이 넘어간 것은 달라요.
위임한 에이전트 이름이 호출 기록에 표시되는지도 살펴보면 좋아요.

 

4. 활용법: 소개 페이지부터 홍보 글까지 나눠 맡기기

 

예를 들어 캠핑 준비물 정리 서비스의 소개 페이지를 만든다고 해볼게요.
아래는 사용 흐름을 설명하기 위한 가상의 예시예요.

 

먼저 서비스 설명을 짧게 적어두면 좋아요.
누구를 위한 서비스인지, 지금 되는 기능은 무엇인지,
아직 만들지 않은 기능은 무엇인지 정리하는 거예요.

 

이 자료를 담당마다 함께 전달해야
페이지와 홍보 글이 서로 다른 이야기를 하지 않겠죠.

 

개발 담당 → 소개 페이지 만들기

 

소개 문구, 주요 기능, 버튼이 들어간 페이지를 부탁해요.
모바일에서도 내용이 잘 보이게 해달라고 덧붙이고,
완성 파일과 함께 실행 방법, 확인한 항목을 받아보면 좋아요.

 

디자인 담당 → 첫 화면 점검하기

 

첫 화면만 보고도 어떤 서비스인지 알 수 있는지,
버튼이 눈에 잘 들어오는지, 글자가 너무 작지 않은지 살펴보게 해요.
수정할 부분은 개발 담당에게 다시 전달하면 돼요.

 

콘텐츠 담당 → 홍보 글 작성하기

 

같은 서비스 설명과 완성된 페이지를 바탕으로
블로그 글이나 인스타그램 문구를 부탁할 수 있어요.

 

이때 아직 없는 기능이나 실제로 받지 않은 후기는 넣지 않도록 알려주세요.
카드뉴스도 글과 구성안만 필요한지, 이미지까지 필요한지 구분하는 게 좋아요.

 

검수 담당 → 정말 되는지 확인하기

 

버튼이 제대로 동작하는지, 모바일 화면이 잘리지 않는지,
홍보 문구가 실제 기능과 맞는지 점검하도록 해요.

 

“문제없어요”라는 답만 받기보다는
무엇을 확인했고, 어떤 결과가 나왔는지 함께 받아보세요.
실행하지 못한 검사는 ‘통과’가 아니라 ‘미확인’으로 남기고요.

 

이 과정이 설치만으로 자동 연결되는 건 아니에요.
앞 담당의 결과를 다음 담당에게 전달하고, 필요한 수정을 요청하는 과정은 있어요.
새 페이지라면 디자인부터 잡고 개발을 맡기는 순서도 괜찮아요.

 

클로드 코드 에이전트 호출 프롬프트 예시

 

UI Designer를 설치했다면 아래처럼 작은 검토 작업부터 맡겨볼 수 있어요.

 

설치된 UI Designer 서브에이전트에 소개 페이지 검토를 위임해줘.
서비스 설명 문서와 현재 페이지를 참고해줘.
처음 방문한 사람이 서비스의 쓰임을 이해할 수 있는지, 모바일에서 글자와 버튼이 잘 보이는지 살펴봐줘.
개선안은 최대 5개로 정리하고, 문제 위치와 수정 이유를 함께 적어줘.
직접 본 화면과 코드만 보고 추정한 내용은 구분해줘. 아직 파일은 수정하지 마.
해당 에이전트를 찾지 못하면 대신 역할극을 하지 말고 알려줘.

 

핵심은 길게 쓰는 것보다
맡길 일, 참고 자료, 받아볼 결과, 확인 기준을 함께 알려주는 것이에요.

 

5. 가격과 장단점: 무료로 쓸 수 있는 범위는?

 

반복해서 설명하는 일을 줄일 수 있어요

 

업무별 기준을 매번 처음부터 적는 대신,
역할 파일을 꺼내 쓰고 내 작업에 맞게 수정할 수 있다는 점이 좋아요.
개발도 하고 콘텐츠도 만드는 분이라면 살펴볼 만한 부분이에요.

 

반대로 가끔 짧은 질문만 한다면 굳이 역할을 여러 개 추가할 필요는 없어요.
설정이 늘어나면 관리할 것도 같이 늘어나니까요.

 

역할 자료는 무료지만, AI 사용 비용은 별도예요

 

역할 파일은 MIT 라이선스로 제공돼요.
조건을 지키면 수정하거나 상업적으로 활용할 수 있어요.
(파일을 재배포할 때는 저작권·허가 고지 유지 등의 조건을 확인해 주세요.)

 

다만 클로드 코드의 구독이나 API 비용까지 무료가 되는 건 아니에요.
서브에이전트가 쓴 사용량도 합산되기 때문에,
여러 담당에게 같은 일을 반복해서 확인시키면 사용량이 늘어날 수 있어요.

 

‘AI 팀’이라는 표현은 조금 나눠서 봐야 해요

 

Agency Agents의 역할 파일을 설치하는 것과
클로드 코드의 Agent Teams 기능을 켜는 것은 별개예요.

 

서브에이전트는 맡은 작업의 결과를 호출한 쪽에 돌려주는 방식이고,
Agent Teams는 여러 별도 세션이 서로 소통하며 작업하는 기능이에요.
앱의 Teams 메뉴도 역할 묶음을 구성하고 설치하는 기능이지,
그 자체로 클로드 코드 팀 작업을 실행하는 것은 아니고요.

 

마지막 확인은 필요해요

 

검수 담당도 AI라서 틀릴 수 있어요.
브라우저나 실행 도구가 없다면 확인하지 못하는 부분도 생기고요.
완료했다는 설명보다 테스트 결과나 화면 같은 근거를 보는 게 중요해요.

 

외부 역할 파일은 설치 전에 내용을 읽어보고,
처음에는 별도 테스트 프로젝트에서 시작하는 걸 추천해요.
파일 수정이나 명령 실행 권한도 사용하는 도구에서 확인해 주세요.

 

6. 자주 묻는 질문: 설치와 활용 전에 확인해요

 

Agency Agents를 설치했는데 에이전트가 안 보이면?

 

먼저 설치한 도구와 폴더, 현재 작업 중인 프로젝트를 확인해 보세요.
프로젝트 전용 폴더에 설치했다면 다른 프로젝트에서는 보이지 않을 수 있어요.
클로드 코드의 /agents에서 역할을 확인하고, 새 세션에서도 다시 살펴보면 좋아요.
이름만 따라 말하는 답변이 아니라 실제 위임 기록이 나오는지도 확인해 주세요.

 

코딩을 잘 몰라도 쓸 수 있나요?

 

데스크톱 앱으로 역할을 설치하고 콘텐츠 초안이나 화면 검토를 요청하는 것부터 시작할 수 있어요.
다만 코드를 바꾸거나 실행하는 작업은 프로젝트 환경과 결과를 확인할 지식이 필요해요.
처음에는 파일을 수정하지 않는 검토 작업부터 맡기는 편이 부담이 적어요.

 

Claude Code 말고 Cursor나 Codex에서도 쓸 수 있나요?

 

공식 앱은 Claude Code 외에 Cursor, Codex 등도 설치 대상으로 지원해요.
다만 도구마다 파일 형식과 설치 위치가 다르므로, 클로드 코드용 파일을 그대로 복사하기보다 앱에서 해당 도구를 선택하거나 공식 안내를 확인해 주세요.

 

7. 총평: 1인 개발자와 소규모 팀에 맞을까요?

 

Agency Agents는 AI 직원을 한꺼번에 채용하는 서비스라기보다,
자주 하는 일의 담당과 작업 기준을 미리 정리해 두는 도구에 가까워요.

 

개발, 디자인, 콘텐츠 작업을 혼자 번갈아 하고 있다면
반복 설명을 줄이는 용도로 살펴볼 만해요.
다만 설치만 하면 모든 일이 자동으로 끝나는 건 아니고,
결과를 이어주고 확인하는 과정은 여전히 필요하다는 점은 알아두면 좋겠네요.

 

처음에는 역할 하나, 작업 하나면 충분해요.
기존 방식과 비교해서 빠뜨리는 내용이 줄었는지,
직접 고쳐야 하는 부분이 줄었는지부터 확인해 보세요.

 

많이 설치하는 것보다, 지금 번거로운 일 하나를 덜어내는 쪽으로 시작해 보시면 좋겠어요.

 

함께 읽으면 좋은 글

 

클로드 코드의 기본 설정이나 Skills·Agents 차이부터 정리하고 싶다면
클로드 코드 잘 사용하는 법: CLAUDE.md부터 Skills·Hooks·Agents까지를 함께 읽어보세요.
이 글은 기본 설정을, Agency Agents는 역할별 작업 지침을 고르는 방법을 다뤄요.

 

공식 참고 자료

 

• Agency Agents 원본 저장소
• Agency Agents 앱 · 앱 기능 설명
• 클로드 코드 서브에이전트 · Agent Teams
• 클로드 코드 비용과 사용량
• Agency Agents MIT 라이선스

 

2026년 9월 30일 확인한 공식 자료 기준이에요.
기능과 설치 방법은 업데이트에 따라 달라질 수 있어요.
직접 사용해 성능이나 비용 절감을 측정한 후기는 아니며,
본문의 작업 예시와 요청문은 이해를 돕기 위한 것이에요.