[Claude Code #13] /deep-research, 멀티에이전트 리서치

Claude Code /deep-research는 질문을 여러 갈래로 검색하고 교차 검증해 인용 보고서를 만드는 내장 워크플로입니다. /workflows 진행 뷰, ultracode 확장, 비용 감각까지 정리했습니다.

기술 조사를 하다 보면 브라우저 탭이 수십 개 열립니다. 자료마다 말이 조금씩 달라서 뭐가 맞는지 교차 확인하는 데 시간이 다 가죠.

Claude Code의 /deep-research는 이 과정을 통째로 맡아 줍니다. 질문 하나를 주면 여러 에이전트가 갈래갈래 검색하고 서로 검증한 뒤, 출처가 달린 보고서 하나로 돌아와요.

/deep-research Node.js 권한 모델이 v20에서 v22 사이 어떻게 바뀌었지?

Claude Code 12편의 /loop가 시간을 나눠 쓰는 법이었다면, 이번엔 에이전트를 나눠 쓰는 법입니다.

무엇이 다른가: 교차 검증

공식 워크플로 문서는 동작을 이렇게 설명합니다. 질문을 여러 각도의 웹 검색으로 팬아웃하고, 찾은 출처를 서로 대조하고, 주장마다 투표를 거친다고요.

그래서 결과물이 다릅니다. 교차 검증에서 살아남지 못한 주장은 걸러진 채, 근거 출처가 달린 보고서만 도착합니다.

검증 에이전트가 요청 제한(rate limit)이나 API 오류로 확인에 실패한 주장은 틀린 것으로 치지 않고 “미검증”으로 따로 표시돼요.

기본 권한 모드에서는 워크플로를 허용할지 먼저 물어봅니다. 계획된 단계 목록을 보고 승인하면 실행이 시작돼요.

실행은 백그라운드로 돕니다. 내 세션은 그대로 자유롭고 끝나면 보고서만 대화에 도착해요.

중간 진행이 궁금하면 /workflows를 입력하세요. 단계별 에이전트 수, 토큰 사용량, 경과 시간이 뜨고 단계 안으로 들어가면 에이전트 하나하나가 뭘 찾았는지도 볼 수 있습니다.

/deep-research는 Claude Code에 내장된 다이나믹 워크플로(dynamic workflow)입니다.

워크플로는 서브에이전트 수십 개를 오케스트레이션하는 JavaScript 스크립트예요. 반복과 분기, 중간 결과가 전부 스크립트 안에 머물러서 내 대화 컨텍스트에는 최종 답만 남습니다.

같은 구조를 내 작업에도 쓸 수 있습니다. 프롬프트에 “워크플로로 해줘”라고 적거나 ultracode 키워드를 넣으면 Claude가 그 작업용 워크플로 스크립트를 써서 돌려요.

ultracode: src/routes/ 아래 모든 엔드포인트에서 인증 누락을 감사해줘

마음에 든 워크플로는 /workflows 뷰에서 s를 눌러 저장하면 /이름 명령으로 재사용할 수 있습니다.

워크플로는 에이전트를 많이 띄우는 만큼 토큰도 많이 씁니다. 대화로 푸는 것보다 확연히 비쌀 수 있어요.

그러니 큰 작업 전에 작은 조각으로 먼저 돌려 보는 게 요령입니다. 저장소 전체 대신 디렉터리 하나, 넓은 질문 대신 좁은 질문으로요.

에이전트가 25개를 넘거나 예상 토큰이 150만을 넘으면 Large workflow 경고가 뜹니다. 실행을 막지는 않는 안내용 경고예요. /workflows에서 언제든 중단할 수 있고 끝난 에이전트의 결과는 대체로 보존됩니다.

/deep-research는 “검색 → 교차 검증 → 인용 보고서”를 백그라운드 멀티에이전트로 돌리는 내장 워크플로입니다.

버전 간 변경점, 라이브러리 비교, 장애 원인 조사처럼 출처가 갈리는 질문에 특히 값을 합니다. 진행 상황은 /workflows로 확인하면 됩니다. 같은 구조를 내 작업에도 워크플로로 확장해 보세요.

다음 편에서는 터미널 파이프라인에 Claude를 끼워 넣는 claude -p 헤드리스 모드를 다룹니다.