평소에 저는 여러 처리를 동시에 실행할 경우, 터미널을 여러 개 띄워서

ClaudeCode를 실행하거나 cmux를 이용하곤 했습니다.

하지만 매번 이렇게 일일이 조작하는 것이 번거롭기도 하고, 생각해보니 백그라운드에서 실행할 수 있겠더라고요. 그래서 그 방법을 비망록으로 남겨둡니다.

에이전트를 여러 개 실행하여 병렬 처리하는 시나리오

이것은 저의 일상적인 태스크에서의 케이스입니다.

• Fan-out형 (동일한 처리를 대상만 다르게 하여 일제히 수행)

  • 여러 사이트의 스크레이핑 (Scraping)을 동시에 하고 싶을 때.
  • 여러 키워드의 SERPs를 조사하고 싶을 때

• 탐색형 (한 가지 일에 대해 서로 다른 전략·프롬프트의 에이전트를 실행하여 최적의 결과를 채택)

  • 동일한 리서치 질문을 Grok / DeepSeek / Claude에 던져서 대조
  • 트레이딩 전략의 백테스트를 파라미터 차이(T/SL/TP 그리드)로 병렬 탐색

• 파이프라인형 (역할을 분담하여 흐름을 만듦)

  • 코드 생성 에이전트와 리뷰 에이전트를 나누어, 코드 생성 중에 이미 생성된 코드의 리뷰를 수행하게 함

• Interrupt/개입형 (감독자 + 실행자의 분리)

  • 학습 계획에 따라 학습을 진행하던 중, 도중에 변경 사항이 생길 때. (학습은 계속하면서, 향후 설계 부분을 변경해두고 싶을 때)

ClaudeCode에서 에이전트를 백그라운드에서 여러 개 실행하는 방법

방법으로는 「백그라운드 Bash형」, 「병렬 서브 에이전트 (Parallel Sub-agent)」 두 가지가 있습니다.

각각 상세히 설명하겠습니다.

Bash로 할지, 서브 에이전트를 기동할지의 판단 방법은

「실행만 할 것인가 / 생각하게 할 것인가」로 선택하면 됩니다. 아래에 차이점을 기재합니다.

백그라운드 Bash	병렬 서브 에이전트
작동하는 것	1개의 커맨드 (Command)
...	...

백그라운드 Bash (하나의 긴 처리에 사용)

빌드(Build)·테스트(Test)·dev server·스크레이핑 등, 시간이 걸리는 커맨드를 뒤에서 실행합니다.

• 여러 개를 동시에 기동할 수 있으며, 각각 종료되는 타이밍에 알림이 도착함
• 폴링 (Polling) 불필요: 끝나면 자동으로 그 결과를 보고할 수 있음

백그라운드 Bash = 단순히 「커맨드를 뒤에서 실행하는 것"

npm run dev 나 npm test 같이 정해진 처리를 실행하고 결과만 내뱉을 뿐입니다.
생각하거나 판단하지 않습니다. 버튼을 누르면 작동하는 기계입니다.

【구체적인 예시】

・dev server를 켜두기
・테스트를 돌리기
・빌드하기
・스크레이핑 스크립트를 실행하기

→ 정해진 커맨드를 흘려보낼 뿐입니다. 판단은 필요 없습니다.

요청 예시:
「npm run dev를 백그라운드에서 실행해줘」
「테스트를 뒤에서 돌려보고, 끝나면 알려줘」

병렬 서브 에이전트 (여러 처리를 동시에)

「여러 처리를 병렬로」의 본체입니다. 독립된 작업을 하나의 메시지로 묶어서 던지면 병렬로 실행되며, 각 에이전트가 끝나면 결과만 반환됩니다.

병렬 서브 에이전트 = 「Claude를 여러 명, 동시에 일하게 함"

각자가 스스로 파일을 읽고, 생각하고, 툴 (Tool)을 사용하여 판단하고 작업합니다.
당신을 대신해 움직이는 "어시스턴트가 3명 있는" 이미지입니다.

【구체적인 예시】

・A사·B사·C사를 각각 조사해서 비교해줘
・3개의 기사를 병렬로 팩트 체크(Fact Check)해줘

→ 각자가 읽고 생각해서 성과물을 만듭니다. 따라서 병렬로 인원수를 늘리면 빠릅니다.

요청 예시:
「A・B・C 3개의 파일을 각각 별도의 에이전트로 병렬 조사해줘」

FleetView 보는 법

백그라운드 태스크의 관제탑입니다. 뒤로 흘려보낸 처리가 상태별로 쌓여갑니다.

claudecode 기동 후, 키보드로 「← 키」를 누르면 표시됩니다.

섹션	의미
Needs input	뒤의 처리가 당신의 답변을 기다리며 멈춰 있음 (승인·선택·확인이 필요). 행의 오른쪽에 「지금 무엇을 묻고 있는지」가 나옴
...	...

Completed에서 세션을 삭제하는 방법

삭제하고 싶은 세션에 커서를 맞춘 후, 입력란 아래에 커맨드 힌트가 표시되므로 힌트에 맞춰 입력합니다.

Windows의 경우 「ctrl + x」를 2번 누름으로써 삭제가 가능합니다.

뭐, 삭제하지 않아도 된다고 합니다. 토큰이 소모되지는 않는다고 하네요.
오히려 NeedsInput 상태로 멈춰 있는 것들을 처리하는 편이 좋다고 합니다.

Workflow 사용법

여러 에이전트를 결정론적(deterministic, 루프·분기·fan-out)으로 오케스트레이션(orchestration)하는 메커니즘입니다. JavaScript로 스크립트를 작성하면 백그라운드에서 실행되며, 완료 시 알림이 반환됩니다.

언제 사용하나요?

• 대량 파일의 일괄 처리·이전·감사
• 「조사 → 설계 → 리뷰」의 단계적 파이프라인
• 여러 관점에서 병렬로 조사하여 통합하고 싶을 때

실행 흐름

• "워크플로우로 ◯◯해줘"라고 요청합니다.
• Claude가 스크립트를 작성하여 실행합니다.
• 즉시 태스크 ID(task ID)를 반환하고 백그라운드에서 실행됩니다.
• /workflows 명령어로 실시간 진행 상황을 확인합니다.
• 완료 시 알림이 도착하며 결과를 보고합니다.

Discussion