에이전트·스킬·커맨드, 뭐가 다른가

주황색 퍼핏 앞에 세 도구가 놓여 있고 네 번째 물체는 천으로 덮여 있는 그림

스킬은 절차, 커맨드는 호출, 서브에이전트는 위임입니다. 에이전트 팀은 사용할 수 있는지 먼저 확인합니다

넷은 같은 자리를 두고 경쟁하지 않고, 무엇을 대신 해주느냐가 각각 다릅니다.

한 문장씩

스킬 — 절차를 적어 둔 문서입니다. “이런 일은 이 순서로 한다”를 Claude에게 가르칩니다.
커맨드 — 내가 직접 불러 쓰는 단축 명령입니다. 부르는 주체가 나입니다.
서브에이전트 — 따로 떨어진 맥락에서 일하고 결과만 돌려주는 워커입니다. 부르는 주체는 Claude입니다.
에이전트 팀 — 각자 독립된 세션으로 돌면서 서로 메시지를 주고받는 구성입니다.

커맨드와 서브에이전트를 가르는 기준은 누가 부르느냐입니다. 커맨드는 내가 칩니다. 서브에이전트는 내가 이름을 대지 않아도 Claude가 상황을 보고 알아서 넘깁니다.

서브에이전트와 에이전트 팀

	서브에이전트	에이전트 팀
맥락	자기 맥락 창을 갖고, 결과는 부른 쪽으로 돌아갑니다	자기 맥락 창을 갖고, 완전히 독립입니다
소통	본 대화에만 보고합니다. 서로 대화하지 않습니다	팀원끼리 직접 메시지를 주고받습니다
조율	본 대화가 전부 관리합니다	공유 작업 목록을 두고 스스로 나눠 가집니다
비용	낮습니다. 결과만 요약돼 돌아옵니다	높습니다. 팀원 하나하나가 별도 세션입니다

결과만 필요하면 서브에이전트, 서로 의견을 부딪쳐야 하면 에이전트 팀입니다. 다만 팀은 토큰을 훨씬 많이 씁니다.

에이전트 팀은 지금 꺼져 있습니다

에이전트 팀은 실험적 기능이라 기본으로 비활성입니다. 설정에서 켜지 않으면 팀이 구성되지 않고 팀원도 만들어지지 않습니다.

그래서 이 유닛의 실습은 전부 서브에이전트로 합니다. 에이전트 팀은 개념만 알아 두면 됩니다. 다른 자료에서 “팀원”이라는 말이 나올 때 서브에이전트와 헷갈리지 않는 정도면 충분합니다.

팀원과 서브에이전트가 물려받는 것

둘 다 프로젝트의 규칙 파일과 연결해 둔 도구를 물려받습니다. 다른 점은 하나입니다. 팀원은 새 세션을 켜는 것과 같아서 스킬까지 그대로 로딩되지만, 리드와 나눈 대화 기록은 넘어가지 않습니다. 팀원이 받는 건 만들 때 넣어 준 지시문뿐입니다.

그래서 팀원에게 일을 맡길 때는 앞선 대화에서 정한 것을 지시문에 다시 적어 줘야 합니다.

직접 해보기

그대로 붙여넣기

지금 이 프로젝트에서 내가 쓸 수 있는 스킬과 서브에이전트를 각각 나열해 줘. 그리고 둘이 어떻게 다른지 한 문장씩으로 설명해 줘.

대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.

내 상황에 맞춰

내가 하려는 일은 [한 줄로 설명]이야. 이건 스킬로 만드는 게 맞아, 서브에이전트로 만드는 게 맞아? 이유를 붙여서 하나만 골라 줘.

한 단계 더

에이전트 팀 기능이 지금 내 환경에서 켜져 있는지 확인해 줘. 꺼져 있다면 무엇을 설정해야 켜지는지, 켜기 전에 알아 둘 점이 있는지 알려 줘.

위 기본 프롬프트를 실행하고, 돌아온 설명이 아래 표와 어긋나는 곳이 있는지 대조해 보세요.

헷갈리기 쉬운 것

유튜브나 블로그에서 "에이전트 팀"이라고 부르는 것이 실제로는 서브에이전트 정의 파일을 여러 개 만든 것인 경우가 많습니다. 폴더에 정의 파일이 여러 개 생긴 것과, 각자 독립 세션으로 도는 팀이 구성된 것은 다릅니다. 에이전트 팀은 실험적 기능이라 기본으로 꺼져 있어서, 설정하지 않은 상태로 따라 하면 아무 팀도 만들어지지 않습니다.

용어 풀이

전체 용어집 →

맥락(context): 대화가 지금까지 들고 있는 정보 범위입니다. 길어질수록 무거워집니다.
시스템 프롬프트: 일을 시작하기 전에 미리 깔아 두는 역할 설명입니다. 매번 다시 말하지 않아도 되게 합니다.
실험적 기능: 아직 다듬는 중이라 기본으로 꺼져 있는 기능입니다. 따로 켜야 동작합니다.
토큰: AI가 글을 잘라 세는 단위입니다. 팀원마다 별도 세션이 생기면 그만큼 이 수가 늘어납니다.