• 신영선
• 기본 과정
• 클로드코드&안티그래비티

클로드코드 기초 총정리 시리즈 6편

AI 한 명한테 줄 세우지 마세요. 5명 동시에 돌리세요

2026-03-02

1. 릴스 영상을 저장 또는 공유하기로 기록 해놓습니다.
2. DM으로 받은 링크를 카톡으로 옮겨 놓습니다.
3. PC로 접속해서 AI 즐겨찾기 폴더를 만들어 저장해놓습니다.
4. 바로 사용을 해봅니다. 절대 미루지 마세요. (⭐ 제일 중요)

1. 관련 영상

2. Claude Code 병렬 작업 핵심 꿀팁

1. 서브에이전트의 본질

Claude Code의 병렬 작업은 Task Tool을 통해 서브에이전트를 생성하는 방식으로 동작합니다. 각 서브에이전트는 독립된 컨텍스트 윈도우(약 200K 토큰)를 갖고, 메인 세션과 분리되어 작업 후 요약만 반환합니다. 최대 동시 실행은 10개까지 가능합니다.

2. 병렬 vs 순차 판단 기준

CLAUDE.md에 라우팅 룰을 명시하면 메인 에이전트가 자동으로 판단합니다. 병렬 조건은 3개 이상의 독립 작업이면서 파일 간 겹침이 없고 공유 상태가 없을 때입니다. 반대로 작업 간 의존성이 있거나 같은 파일을 건드리면 반드시 순차 처리해야 머지 충돌을 피할 수 있습니다.

3. 프롬프트 작성법

"use 4 parallel sub-agents"처럼 숫자와 범위를 명확히 지정하는 게 핵심입니다. 예: "코드베이스를 4개 병렬 태스크로 탐색해. 각각 frontend, backend, DB, auth 영역을 담당해." 모호하게 "병렬로 해줘"보다 에이전트별 스코프를 확실히 나눠줘야 품질이 올라갑니다.

4. 백그라운드 실행 활용

서브에이전트 실행 중 Ctrl+B를 누르면 백그라운드로 전환됩니다. 리서치나 분석 같은 비차단 작업을 백그라운드에 돌리고, 메인 세션에서는 다른 작업을 계속할 수 있습니다. /tasks 명령으로 진행 상황을 확인하면 됩니다.

5. 커스텀 에이전트 사전 정의

.claude/agents/ 폴더에 마크다운 파일로 전문 에이전트를 미리 정의해두면, 매번 프롬프트로 설명할 필요 없이 자동 위임됩니다. 프로젝트용은 .claude/agents/, 전역용은 ~/.claude/agents/에 배치합니다.

6. 비용 최적화

메인 세션은 Opus로 복잡한 판단을, 서브에이전트는 CLAUDE_CODE_SUBAGENT_MODEL 환경변수로 Sonnet을 지정하면 토큰 비용을 크게 절감할 수 있습니다.