플러그인 설치·운용

전문가 에이전트 이해

검수자 · Goos Kim · 읽는 시간 5분 · 최종 업데이트 2026.08.22

플러그인을 설치하면 스킬(업무 지식 문서)만 오는 것이 아니라 에이전트도 함께 옵니다. 에이전트는 Claude 안에서 특정 역할을 맡아 독립적으로 일하는 “분신"이라고 생각하면 됩니다. 여러분이 마케터 플러그인에게 캠페인 기획을 맡기면, 본체 Claude가 직접 다 하는 게 아니라 캠페인 기획을 전담하는 에이전트를 불러 일을 시키고 결과만 받아 오는 식입니다.

모두의 코워크 플러그인 패밀리의 에이전트에는 한 가지 중요한 설계 원칙이 있습니다. 일하는 코워커(worker)과 검수하는 코워커(auditor)이 분리되어 있다는 점입니다. 회사에서 작성자와 결재자를 한 사람이 겸하지 않듯, 산출물을 만드는 에이전트와 그 품질을 평가하는 에이전트를 따로 두었습니다. 자기가 만든 결과물을 자기가 채점하면 후하게 주기 마련이라, 검수자는 처음부터 “결함을 찾는 눈"으로만 일하도록 만들어진 별도의 에이전트입니다.

이 분리는 말로만이 아니라 도구 권한으로 강제됩니다. worker 에이전트는 파일을 쓰고 고치는 도구(Write·Edit)를 갖지만 auditor 에이전트는 읽기·검색 도구만 갖는 경우가 대부분입니다. 검수자가 산출물을 몰래 고쳐서 “통과"시키는 일이 구조적으로 불가능하도록 권한 자체를 좁혀 둔 것입니다.

품질 루프 — worker와 auditor가 주고받는 흐름

sequenceDiagram
   participant U as 사용자
   participant W as worker 에이전트
(작성 권한 있음)
   participant A as auditor 에이전트
(읽기 전용)

   U->>W: 작업 지시 (예: 상세페이지 초안 작성)
   W->>W: 스킬 참조 + 산출물 작성
   W-->>U: 산출물 1차 완성
   U->>A: 검수 요청
   A->>A: 결함 탐색 (수정 불가, 평가만)
   A-->>U: 검수 보고 (지적 사항 목록)
   U->>W: 지적 사항 반영 지시
   W-->>U: 수정본 완성

이 루프를 한두 바퀴 돌리면 “그럴듯해 보이는 초안"이 “지적을 견딘 결과물"로 바뀝니다. 검수를 반드시 돌려야 하는 것은 아니지만 외부에 나가는 산출물(제안서, 광고 소재, 계약서 검토 의견 등)이라면 auditor 한 바퀴를 강하게 권합니다.

에이전트 직접 호출하는 법

평소에는 에이전트를 의식할 필요가 없습니다. 하지만 특정 에이전트를 지목해 부르고 싶을 때는 정해진 문형이 있습니다.

“OO 서브에이전트를 사용해서 ~해줘”

예를 들면 이렇게 씁니다.

claude — cowork

캠페인 전략 worker 서브에이전트를 사용해서 신제품 런칭 캠페인 초안을 만들어줘.

claude — cowork

방금 만든 상세페이지를 auditor 서브에이전트를 사용해서 검수해줘.

각 플러그인이 어떤 이름의 worker·auditor 에이전트를 데리고 있는지는 에이전트 팀 소개의 코워커별 페이지에 에이전트 카드로 정리되어 있습니다. 터미널에서는 claude plugin details <이름>@moai-cowork 출력의 에이전트 목록으로도 확인할 수 있습니다.

스킬 자동 매칭 vs 에이전트 명시 호출

플러그인을 부리는 방식은 두 가지이고, 상황에 따라 골라 쓰면 됩니다.

구분	스킬 자동 매칭	에이전트 명시 호출
쓰는 법	그냥 자연어로 일을 시킨다	“OO 서브에이전트를 사용해서 ~” 문형
동작	Claude가 요청 내용을 보고 알맞은 스킬·에이전트를 스스로 고름	지목한 에이전트가 반드시 그 일을 맡음
적합한 상황	일상 업무 대부분 — 무엇이 필요한지 Claude가 잘 고르는 경우	검수를 확실히 auditor에게 맡기고 싶을 때, 특정 전문 에이전트의 관점이 필요할 때

기본은 자동 매칭입니다. “스마트스토어 이번 주 주문 정리해줘"라고만 해도 셀러 플러그인의 스킬이 알아서 붙습니다. 명시 호출은 품질 게이트를 확실히 걸고 싶은 순간을 위한 수동 기어라고 생각하세요.

ChatGPT Work(Codex)에서는 어떻게 되나요

Codex 플러그인 규격이 지원하는 구성요소는 스킬·MCP 서버·훅·에셋입니다. 에이전트와 슬래시 명령은 규격에 없습니다.

그래도 기능이 빠지지는 않습니다. 실제 업무 지식은 전부 스킬에 들어 있고, 스킬은 에이전트 없이도 스스로 완결되도록 만들어져 있습니다. 슬래시 명령도 마찬가지로 스킬을 부르는 얇은 단축키일 뿐이라, 자연어로 같은 일을 시킬 수 있습니다.

	Claude Cowork	ChatGPT Work (Codex)
스킬 자동 매칭	동작	동작
MCP 연동	동작	동작
슬래시 명령 (`/project`)	동작	미지원 — 자연어로 대체
에이전트 명시 호출	동작	미지원 — 자연어로 대체
worker/auditor 검수 루프	에이전트로 자동 분리	요청을 두 번 나눠서 수동 진행

슬래시 명령은 `/project` 하나뿐입니다

모두의 코워크에서 슬래시 명령은 PM의 /project 하나만 둡니다. 나머지 코워커는 전부 자연어로 부릅니다.

이유는 단순합니다. 슬래시 명령은 Claude Cowork에서만 동작하는데, 같은 일을 하는 스킬은 양쪽에서 다 동작합니다. 명령을 늘리면 ChatGPT Work 사용자만 못 쓰는 기능이 늘어날 뿐입니다. 그래서 진입점 성격이 뚜렷한 /project만 남기고, 디자이너·SNS 크리에이터가 갖고 있던 슬래시 명령 8개는 없앴습니다.

없앤 명령이 하던 일은 그대로 있습니다 — 아래처럼 말하면 같은 스킬이 붙습니다.

예전 명령	이렇게 말하세요
`/brief`	디자인 브리프 만들어줘
`/design`	디자인 작업 시작해줘
`/tokens`	브랜드 디자인 토큰 만들어줘
`/system`	디자인 시스템 라이브러리 보여줘
`/import`	Claude Design 핸드오프 받아서 읽어줘
`/upload`	디자인 동기화해서 업로드해줘
`/check`	이 디자인 카피 AI 티 나는지 검수해줘
`/threads-post`	Threads에 올릴 글 초안 써줘

ChatGPT Work에서는 /project도 없으므로 “새 프로젝트 시작해줘"처럼 말하시면 됩니다.

검수 루프도 자연어로

Codex에서 auditor 역할을 쓰고 싶다면, 에이전트를 지목하는 대신 요청을 두 단계로 나누면 같은 효과를 냅니다.

codex — cowork

방금 만든 상세페이지를 결함을 찾는 관점에서만 검수해줘. 고치지 말고 지적 사항만 목록으로.

다음 단계

에이전트 한 명을 부리는 법을 익혔다면, 이제 여러 코워커를 조합해 프로젝트를 굴리는 팀 구성 패턴으로 넘어가세요. 각 코워커의 에이전트 카드와 스킬 목록은 에이전트 팀 소개에서 확인할 수 있습니다.

Sources

Claude Code 서브에이전트 공식 문서: https://code.claude.com/docs/en/sub-agents
Codex 플러그인 매니페스트 규격(에이전트 미지원 근거): https://developers.openai.com/plugins/build/plugins
코워커별 에이전트 카드: /moai-agents/ (생성 데이터: www/data/agent_teams.json)