Claude Code Projects 베타: 병렬 작업을 계획하고 조율하는 에이전트 팀

Claude Code 에이전트 팀과 프로젝트 베타의 관계

이 개편된 프로젝트 발표 에서는 지속적인 작업을 중심으로 구성된 프로젝트를 소개합니다. 코디네이터는 스레드를 지휘하고, 공유 메모리는 스레드 간에 컨텍스트를 전달하며, 라이브러리는 파일과 산출물을 모읍니다.

코디네이터의 역할은 명확히 정의되어 있습니다. 요청의 범위를 정하고, 병렬 스레드에 작업을 위임하며, 각 스레드가 만든 산출물을 검토하고 결과를 종합합니다. 각 스레드는 Claude Code 클라우드 세션에서 작업을 수행합니다.

에이전트 팀은 이번 출시 이전에도 존재했습니다. Claude Code 2026년 2월 5일에 출시된 v2.1.32에서는 다중 에이전트 협업을 위한 연구 프리뷰로 에이전트 팀을 도입했습니다. 해당 릴리스에서는 이 기능의 토큰 사용량이 많다고 설명했으며, 실험용 환경 변수가 필요했습니다.

설정 지침을 읽을 때는 이 차이를 이해하는 것이 중요합니다. 2월의 CLI 기능과 9월의 프로젝트 베타는 문서에 명시된 진입 방식이 다릅니다. 프로젝트 발표에서는 실험용 CLI 플래그를 활성화 요건으로 명시하지 않습니다.

이러한 기능을 살펴보려면 Claude Code 가이드 허브 에서 시작할 수 있습니다. 작업에 적합한 워크플로를 결정할 때는 프로젝트 코디네이터, 클라우드 스레드, 하위 에이전트를 구분하세요.

9월 21일 기준 이용 가능 여부 및 설정

초기 이용 대상은 Claude Code 클라우드 세션을 사용하면서 기존 웹 또는 데스크톱 프로젝트가 없는 일부 Pro 및 Max 구독자로 제한되었습니다. Pro 및 Max 이용 대상을 확대할 계획이었으며, 이후 Team 및 Enterprise에도 제공할 예정이었습니다.

개요에서는 9월 21일까지 확대 배포가 완료되었다고 확인해 주지 않습니다. 따라서 구독 중이라는 사실만으로 특정 계정에서 개편된 프로젝트 베타를 이용할 수 있었다고 판단해서는 안 됩니다.

설정 항목

프로젝트 설정은 목표와 저장소 또는 컨텍스트를 지정하는 것으로 시작합니다. 설정 항목에는 클라우드 환경, 커넥터, 플러그인, 지침, 모델이 포함됩니다.

개발 작업에서 유용한 목표는 원하는 결과와 구현 중 중요한 제약 조건을 설명하는 것입니다. 예를 들어 API와 인터페이스에 걸친 기능을 요청한 뒤, 수용 기준과 특히 주의가 필요한 코드 영역을 지정할 수 있습니다. 이는 코디네이터에게 작업을 제시하는 권장 방식이며, 요청을 어떻게 분할할지에 관해 문서에 명시된 보장은 아닙니다.

휴대폰을 포함해 프로젝트 채팅이나 개별 스레드를 통해 작업 방향을 조정할 수 있습니다. 프로젝트 채팅에서는 전체 작업을 지휘할 수 있고, 개별 스레드에서는 특정 부분의 방향을 조정할 수 있습니다.

아직 명시되지 않은 사항

출시 발표에는 최소 CLI 버전, 동시 스레드 수의 상한, 별도의 베타 가격이 명시되어 있지 않습니다. 또한 게시 마감 시점까지 모든 대상 구독 등급에 대한 이용 권한 제공이 완료되었다고 확인해 주지도 않습니다.

이러한 정보의 공백은 계획을 세울 때 중요합니다. 동시 실행 가능한 스레드 수나 배포 날짜를 임의로 가정해 워크플로를 구성하지 마세요.

병렬 스레드의 실행 방식과 여전히 통합이 중요한 지점

코디네이터는 요청의 범위를 정하고 병렬 스레드에 작업을 위임합니다. 각 스레드는 자체 브랜치와 저장소 복사본을 갖춘 Claude Code 클라우드 세션으로 실행되므로, 병렬 작업마다 별도의 작업 복사본이 제공됩니다.

스레드 자체도 하위 에이전트, 루프, 워크플로를 사용할 수 있습니다. 따라서 프로젝트에는 여러 단계의 위임이 존재합니다. 코디네이터는 스레드를 지휘하고, 스레드는 하위 에이전트에 추가 작업을 위임할 수 있습니다.

산출물별로 작업 나누기

요청을 준비하는 실용적인 방법은 분리할 수 있는 산출물을 식별하는 것입니다. 제안하는 기능의 경우 API 구현, 인터페이스 변경, 검토로 나눌 수 있습니다. 이는 작업 경계의 예시이며, 보장된 분할 규칙은 아닙니다.

각 산출물에 명확한 완료 조건을 부여하세요. 두 부분이 같은 인터페이스에 의존한다면, 코디네이터가 작업 범위를 정할 때 참고할 수 있도록 프로젝트 지침에 해당 공통 규약을 설명하세요.

앞서 2월에 발표된 에이전트 팀은 코드베이스 검토처럼 독립적이고 읽기 작업이 많은 업무를 특히 강조했습니다. 이러한 방향성은 병렬화할 작업을 선택할 때도 유용합니다. 작업을 여러 과제로 나누기 전에 얼마나 많은 조율이 필요한지 고려하세요.

별도의 브랜치가 충돌을 없애지는 않습니다

프로젝트 발표에서는 코드 변경이 겹칠 경우 병합 충돌을 해결해야 한다고 명시합니다. 스레드가 같은 코드를 수정하면 별도의 브랜치와 저장소 복사본이 있어도 통합 작업은 필요합니다.

따라서 검토에는 산출물들이 어떻게 맞물리는지도 포함되어야 합니다. 권장 검토 항목은 인터페이스가 일치하는지, 겹치는 수정 사항이 조정되었는지, 종합된 결과가 원래 목표를 충족하는지입니다.

개요에서는 여러 저장소에 걸친 변경을 조율하는 워크플로를 명시하지 않습니다. 스레드에 자체 저장소 복사본이 있다는 사실만으로 저장소 간 오케스트레이션을 지원한다고 볼 수는 없으므로, 해당 기능의 지원 여부는 미확인 사항으로 남겨 두어야 합니다.

공유 메모리와 프로젝트 라이브러리

스레드는 프로젝트 공유 메모리에 정보를 추가하고, 프로젝트 라이브러리는 업로드된 파일과 생성된 산출물을 모읍니다. 이들은 지속적으로 유지되는 프로젝트 컨텍스트를 두 가지 형태로 제공합니다. 하나는 스레드가 추가한 메모리이고, 다른 하나는 작업과 관련된 자료 모음입니다.

개발자는 이 차이를 이해하면 입력 자료를 체계적으로 정리할 수 있습니다. 설계 문서나 참조 파일은 프로젝트 자료에 포함하는 것이 자연스럽고, 작업을 수행하면서 발견한 정보는 공유 메모리에 추가할 수 있습니다.

향후 작업에 필요한 사항 계획하기

프로젝트를 준비할 때는 작업이 진행되는 동안 어떤 제약 조건을 계속 참조할 수 있어야 하는지 고려하세요. 인터페이스의 의도된 동작, 저장소 규칙, 여러 산출물에 영향을 미치는 결정 등이 그 예입니다.

이러한 예시는 프로젝트 구성을 위한 권장 사항입니다. 출시 개요는 공유 메모리의 정확한 형식을 명시하지 않으며, 모든 스레드의 모든 세부 정보가 보존된다고 보장하지도 않습니다.

또한 보존 기간, 저장 용량 제한, 기억된 정보가 다른 스레드에 전달되는 시점에 관한 정확한 규칙도 정의하지 않습니다. 확인된 내용의 범위는 더 좁습니다. 스레드는 공유 메모리에 정보를 제공하고, 라이브러리는 업로드된 파일과 생성된 아티팩트를 수집합니다.

통합된 결과를 평가하는 과정에서 생성된 아티팩트를 검토하세요. 아티팩트가 라이브러리에 있다는 것은 그곳에 수집되어 있다는 뜻이며, 그 사실만으로 정확성이 입증되지는 않습니다.

서브에이전트와 기존 CLI 에이전트 팀 워크플로

Claude Code 서브에이전트는 프로젝트 베타 이전부터 병렬 개발을 지원했습니다. Anthropic의 2025년 9월 29일 발표에는 메인 에이전트가 프런트엔드를 구축하는 동안 서브에이전트가 백엔드 API를 구축하는 예시가 포함되어 있었습니다.

새롭게 설계된 프로젝트에서는 스레드가 서브에이전트를 호출할 수 있습니다. 따라서 서브에이전트는 스레드 내에서 사용할 수 있는 실행 수단이 되며, 코디네이터는 프로젝트 수준의 범위 설정, 위임, 결과 통합을 담당합니다.

이 하위 에이전트 가이드 는 이러한 내부 위임 계층을 계획할 때 유용한 참고 자료입니다. 해당 구성과 계정의 프로젝트 베타 접근 권한 여부는 별개로 다루세요.

실험적 CLI 플래그의 적용 범위

2월의 v2.1.32 릴리스에서는 에이전트 팀 연구 프리뷰를 사용하기 위해 다음 환경 변수가 필요했습니다.

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

9월 프로젝트 발표에서는 해당 변수를 베타 활성화 요건으로 명시하지 않았습니다. 따라서 이 변수를 활성화하는 것을 새롭게 설계된 프로젝트의 접근 권한을 얻는 방법으로 안내해서는 안 됩니다.

2월 출시 당시에는 Shift+Up/Down 또는 tmux를 통한 직접 제어 전환도 문서화되었습니다. 이는 기존 에이전트 팀 워크플로의 출시 당시 제어 방식이며, 새롭게 설계된 프로젝트 인터페이스에도 적용된다고 가정해서는 안 됩니다.

오래된 서브에이전트 설정 안내 피하기

작성자 2026년 7월 1일의 v2.1.198, 해당 /agents 마법사가 제거되었습니다. 해당 날짜의 변경 로그는 사용자에게 Claude에 서브에이전트 생성 또는 관리를 요청하거나 다음 항목을 편집하도록 안내합니다. .claude/agents/ 직접 편집하세요.

9월 가이드에서는 독자에게 이전 마법사를 열라고 안내하는 대신 이러한 방법을 사용해야 합니다. 이는 프로젝트, 에이전트 팀, 서브에이전트에 관한 안내를 함께 구성할 때 날짜가 명시된 릴리스 정보가 왜 중요한지 보여 주는 구체적인 예입니다.

사용량, 모델 선택, 로컬 실행

병렬 프로젝트 세션은 사용량 한도를 더 빠르게 소진합니다. 프로젝트 발표에 따르면 사용자는 프로젝트 사용량을 확인하고 코디네이터와 작업자 모델 및 노력 수준을 선택할 수 있지만, 병렬 작업에 따른 수치화된 비용 배수는 제공되지 않습니다.

따라서 범위 설정은 중요한 계획 요소입니다. 스레드를 추가하기 전에 추가 활동을 정당화할 만큼 작업에 독립적인 부분이 충분한지 고려하세요. 워크플로를 평가할 때 프로젝트 사용량 정보와 함께 제공되는 모델 및 노력 수준 선택 옵션을 활용하세요.

9월 한도 변경

이 Claude Code 주간 한도 공지 에 따르면 9월 14일부터 Pro, Max, Team, 좌석 기반 Enterprise의 주간 한도가 프로모션 이전 수준보다 영구적으로 25% 높아졌습니다.

앞서 진행된 50% 프로모션은 5월 13일부터 9월 13일까지 적용되었으며, 태평양 시간 오후 11:59시에 종료되었습니다. 이 프로모션은 5시간 한도를 변경하지 않았으며, Free와 사용량 기반 Enterprise 좌석은 제외되었습니다.

Claude Code는 사용량을 확인하기 위한 다음 CLI 명령을 제공합니다.

/usage

이 요청 한도 가이드 는 관련 사용량 개념을 이해하는 데 도움이 됩니다. 주간 한도가 높아졌더라도 병렬 세션이 한도를 더 빠르게 소진한다는 프로젝트 발표의 경고는 여전히 유효합니다.

로컬 실행은 아직 출시 예정이었습니다

9월 발표에서는 로컬 실행을 출시 예정 기능으로 설명했습니다. 9월 21일 기준으로 문서화된 프로젝트 워크플로는 클라우드 세션을 사용했으며, 프로젝트 채팅이나 개별 스레드를 통해 작업 방향을 조정할 수 있었습니다.

따라서 로컬 Claude Code 워크플로와 새롭게 설계된 클라우드 프로젝트 베타는 별도로 평가해야 합니다. 개요에는 로컬 프로젝트 출시일이나 로컬 기능 배포 완료 여부가 제시되어 있지 않습니다.

핵심 요점

• 새롭게 설계된 프로젝트는 9월 17일 베타로 출시되었으며, 요청의 범위를 설정하고 병렬 스레드에 작업을 위임하며 출력을 검토하고 결과를 통합하는 코디네이터를 제공합니다.
• Claude Code 에이전트 팀은 이 베타보다 먼저 등장했습니다. v2.1.32은 2월 5일에 별도의 CLI 연구 프리뷰를 도입했습니다.
• 각 프로젝트 스레드는 자체 클라우드 세션, 브랜치, 저장소 사본을 갖습니다. 변경 사항이 겹치면 여전히 병합 충돌을 해결해야 합니다.
• 스레드는 공유 프로젝트 메모리에 정보를 제공하며, 라이브러리는 업로드된 파일과 생성된 아티팩트를 수집합니다.
• 초기 접근 권한은 발표된 조건을 충족하는 일부 Pro 및 Max 구독자로 제한되었습니다. 병렬 작업은 한도를 더 빠르게 소진하며, 로컬 실행은 여전히 출시 예정이었습니다.

자주 묻는 질문

새롭게 설계된 프로젝트 베타에 어떻게 접근하나요?

초기 접근 대상은 Claude Code 클라우드 세션을 사용하며 기존 웹 또는 데스크톱 프로젝트가 없는 일부 Pro 및 Max 구독자였습니다. 이후 더 많은 Pro 및 Max 사용자에게 접근 권한을 확대하고, 이어서 Team과 Enterprise로 확대할 계획이었지만, 개요만으로는 9월 21일까지 이러한 확대 배포가 완료되었다고 확인할 수 없습니다.

프로젝트, 에이전트 팀, 서브에이전트는 어떻게 다른가요?

새롭게 설계된 프로젝트에는 클라우드 세션 스레드를 지휘하고 그 결과를 통합하는 코디네이터가 있습니다. 에이전트 팀은 앞서 별도의 CLI 연구 프리뷰로 도입되었으며, 서브에이전트는 위임된 작업을 수행하고 프로젝트 스레드 내에서 호출할 수 있습니다.

두 스레드가 같은 코드를 편집하면 어떻게 되나요?

각 프로젝트 스레드는 자체 브랜치와 저장소 사본에서 작업합니다. 코드 변경 사항이 겹치면 여전히 병합 충돌을 해결해야 하며, 프로젝트 발표는 자동 조정을 보장하지 않습니다.

프로젝트 스레드를 로컬에서 실행할 수 있나요? 작업 방향은 어떻게 조정하나요?

9월 21일 기준으로 문서화된 베타는 Claude Code 클라우드 세션을 사용했으며, 로컬 실행은 출시 예정으로 발표되었습니다. 휴대전화를 포함한 기기에서 프로젝트 채팅이나 개별 스레드를 통해 작업 방향을 조정할 수 있습니다.