이 단원의 카드 6개
먼저 볼 카드 — Notion 연결 — MCP
실습 서브에이전트
서브에이전트 위임
이 카드를 다루는 수업 자료를 잘 정리하는 법 Codex부터 GitHub 저장까지
서브에이전트는 별도 맥락에서 작업하고 결과만 본 대화로 돌려주는 워커입니다. “서브에이전트로 조사해 줘”처럼 요청하면 Claude가 워커를 골라 위임합니다.
본 대화에서 직접 조사하면 중간 결과와 읽고 안 쓴 파일이 그대로 쌓입니다. 맥락이 무거워지면 이후 요청에서 처음 규칙을 놓칩니다.
- 파일 여러 개를 뒤지거나 같은 조사를 반복할 때 씁니다.
- 한두 줄로 끝나는 질문은 직접 답하는 게 빠릅니다.
- 위임한 작업은 끝나거나 막히면 스스로 보고합니다.
범위 밖의 일은 칩으로 떼어 두기
칩(chip)은 지금 범위 밖의 일을 별도 세션으로 미뤄 두는 방법입니다. “이건 새 칩으로 띄워 줘”라고 요청하면 화면에 칩이 생기고, 누르면 그 일만 다루는 세션이 열립니다. 지금 대화는 그대로 이어집니다.
| 넘기는 것 | 돌아오는 것 | |
|---|---|---|
| 서브에이전트 | 지금 해야 할 조사·반복 | 요약이 본 대화로 |
| 칩 | 지금 안 할 일 | 나중에 열 세션으로 |
아래 요청문을 복사해 붙여넣고 조사 하나를 서브에이전트에 맡깁니다.
실행 순서
-
위임할 조사나 반복 작업을 정의합니다.
이 프로젝트의 폴더별 역할을 읽기 전용으로 조사하도록 서브에이전트에 맡겨 주세요. 서브에이전트는 별도 대화에서 일을 맡아 결과를 돌려주는 보조 에이전트입니다. 파일을 수정하거나 추가로 위임하지 말고, 본 대화에는 폴더별 역할과 근거 파일 경로를 요약해 주세요. 요약 한 항목을 실제 파일과 대조해 확인하고, 이 환경에서 서브에이전트를 쓸 수 없다면 실행했다고 하지 말고 알려 주세요.
확인폴더별 역할과 근거 경로, 실제 파일과 대조한 항목이 나오며 파일은 바뀌지 않습니다.
-
"서브에이전트로 조사해 줘"처럼 자연어로 위임을 요청합니다.
-
작업이 끝나면 결과 요약을 받습니다.
-
받은 결과가 기준에 맞는지 검수합니다.
직접 해보기
대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.
[조사가 필요한 주제나 폴더]를 서브에이전트로 조사해서 핵심만 요약해 줘. 결과는 5줄 이내로 줘.
방금 받은 요약 중 하나를 골라서, 실제 파일 내용과 맞는지 직접 대조해서 확인해 줘.
받은 요약 중 하나를 골라 실제 파일 내용과 맞는지 대조해 보세요.
헷갈리기 쉬운 것
서브에이전트가 돌려준 요약을 검수 없이 그대로 쓰면 놓친 부분이 결과물에 그대로 남습니다. 받은 요약은 원하는 기준에 맞는지 한 번은 확인합니다. 몇 줄이면 끝날 짧은 일까지 전부 위임하면 작업을 설명하고 결과를 기다리는 왕복 비용이 직접 답하는 것보다 오히려 커집니다.
용어 풀이
전체 용어집 →- 맥락(context)
- 대화가 지금까지 기억하고 있는 정보 범위입니다. 오래 이야기할수록 무거워집니다.
- 칩(chip)
- 지금 하는 대화를 멈추지 않고, 다른 일을 나중에 처리하도록 따로 떼어 두는 표시입니다.
2026-07-13 기준 · 출처 · Claude Code — Sub-agents