AI 개발 도구 · 2025년 9월 베타 출시

클로드 코드 프로젝트 베타 출시 — 노트북을 닫아도 계속 돌아가는 병렬 클라우드 세션

발행: 2025-09-17 최종 수정: 2025-09-19 카테고리: AI 코딩 어시스턴트 난이도: 초급

1. 기존 프로젝트와 무엇이 다른가?

기존의 Claude Code 프로젝트(Projects)는 "파일이 몇 개 들어 있는 폴더에 채팅창이 하나 붙어 있는" 형태에 가까웠습니다. 새로 베타로 나온 프로젝트는 다릅니다.

지금의 프로젝트는 Claude가 코디네이터(조율장)인 하나의 진행형 대화입니다. 사용자가 "이렇게 해 줘"라고 한마디 하면, Claude가 스스로 판단해서 어떤 작업이 별도의 스레드(작업 줄기)로 가야 할지 정합니다. 그리고 그 스레드들은 각자 다른 사본에서 동시에 돌아갑니다.

Anthropic은 이를 "스스로 병렬 클라우드 세션으로 분기되는 하나의 대화"라고 표현합니다. 핵심은 사용자가 노트북을 닫아도 백그라운드에서 계속 일한다는 점입니다.

2. 어떻게 동작하나? — 코디네이터와 스레드

구조는 두 겹으로 단순합니다.

코디네이터 (Coordinator) = 두뇌

사용자 메시지를 읽고, 사소한 질문은 그 자리에서 답합니다. 실제 코드를 만져야 하면 스레드를 새로 띄워 작업을 맡김니다. 스레드 내부 동작은 보지 않고, 결과 보고만 받습니다.

스레드 (Thread) = 손발

각 스레드는 자신만의 코드 사본(브랜치·리포지토리 복제본) 위에서 완전한 Claude Code 클라우드 세션으로 동작합니다. 필요할 때 PR(코드 합치기 요청)을 열고, 자동 검사(CI) 결과를 기다렸다가 실패하면 알아서 고쳐 푸시합니다.

흐름을 그림으로 보면

사용자 요청→ 코디네이터→ 스레드 1스레드 2스레드 3→ PR 열기 + CI 검사→ 결과 보고

Anthropic이 제시한 실제 예시

체크아웃 p75 지연시간 줄이기: Claude가 각 결제 엔드포인트를 분석해 병렬 스레드로 최적화 PR을 동시에 열어 줍니다. 사용자는 자고 일어나도 됩니다.
v1 엔드포인트 폐기: API·웹·모바일 저장소에 흩어져 있는 쓰지 않는 v1 코드를 각각의 스레드로 정리하고, 어떤 PR이 먼저 합쳐지는지 알려 줍니다. 두 스레드가 같은 파일을 동시에 만지면 보통의 git 병합 충돌(conflict)로 자연스럽게 나타납니다.

3. 스레드는 무엇을 자동으로 받나?

프로젝트 안에서 새 스레드가 만들어질 때마다, 다음 정보가 자동으로 전달됩니다. 이걸 "상시 컨텍스트(Standing context)"라고 부릅니다.

리포지토리 프로젝트에 연결된 모든 코드 저장소
업로드한 파일 사용자가 올린 자료들
지시문 최대 16,000자까지 쓸 수 있는 프로젝트 지시문(project instructions)
메모리 MEMORY.md 라는 색인을 통해 Claude가 읽고 쓰는 프로젝트 메모리

메모리에는 보통 이런 일이 저장됩니다. 예: "이번 릴리스는 금요일이다", "결제 코드를 건드리기 전에 김팀장님께 먼저 확인을 받는다."

스레드는 저장소를 통째로 복제(clone)한 뒤, 안에 있는 CLAUDE.md, 스킬(skills), 플러그인(plugins)을 모두 자동으로 읽어 들입니다.

주의해서 다뤄야 하는 설정도 있습니다

저장소 개수에 따라 달라지는 동작
설정 항목	저장소 1개일 때	저장소 여러 개일 때
권한 규칙, 훅(hooks), 환경 변수(env)	정상 적용	스레드 시작 위치에 따라 적용이 달라질 수 있음
MCP 도구 (외부 서비스 연결)	커넥터 통해 전달	커넥터 작업은 반드시 스레드로 보내야 함

MCP(Model Context Protocol)는 Claude가 외부 도구·데이터 소스에 표준 방식으로 연결되는 규칙입니다. 프로젝트 대화 자체에는 커넥터가 없기 때문에, 외부 서비스(GitHub, Slack, 사내 DB 등)를 연결해 쓰는 작업은 반드시 스레드로 보내야 합니다.

상태 패널과 라이브러리

Overview(개요) 패널은 스레드를 상태별로 묶어 보여 줍니다. Ready for review(검토 준비) Waiting on you(응답 대기) Working(작업 중) Landing(머지 진행) Idle(대기) Resolved(해결됨)
Library 탭은 사용자가 올린 파일과, 스레드가 만든 파일을 한곳에 모아 둡니다.

4. 비용은 얼마나 드나?

프로젝트는 보통의 단일 채팅보다 요금제 한도(plan limit)를 더 빠르게 소모합니다. 이유很简单, 실행 중인 스레드마다가 그 자체로 완전한 세션이기 때문입니다.

기본으로 잡혀 있는 모델과 투입도

새 프로젝트의 기본값은 다음과 같습니다.

스레드: Opus + 높은(high) 투입도 — 복잡한 작업을 진지하게 처리
코디네이터 대화: Opus + 낮은(low) 투입도 — 가벼운 질문응답 위주

숫자로 보는 비용 한도

200개/일

모든 프로젝트를 합쳐 하루 새로 만들 수 있는 스레드 상한

16,000자

프로젝트 지시문 최대 길이

1개

코디네이터가 관리하는 대화 수 (단일 진행형)

n개

프로젝트 안에서 동시에 돌 수 있는 스레드 수

대기(Idle) 상태인 스레드도 CI가 실패하거나 리뷰 코멘트가 도착하면 스스로 다시 깨어나 비용을 소모합니다. 요금 한도에 도달한 스레드는 스스로 멈췄다가 자동으로 다시 이어집니다.

5. 누가 지금 쓸 수 있나?

베타라서 제한이 있습니다.

Pro Max 요금제 사용자 중 Anthropic이 선정한 사용자에게만 제공
사용 가능 환경: 웹(claude.ai)과 데스크톱 앱
CLI(터미널)에서는 지원하지 않습니다.

6. 자주 묻는 질문 (FAQ)

Q1. 코디네이터와 스레드는 무엇이 다른가요?

코디네이터는 사용자의 메시지를 받아 판단하고 결과를 모으는 두뇌입니다. 스레드는 그 판단에 따라 실제 작업을 수행하는 손발입니다. 코디네이터는 보통 한 프로젝트에 하나이고, 스레드는 여러 개가 동시에 돌아갑니다.

Q2. 노트북을 닫아도 정말로 계속 작동하나요?

예. 스레드는 Anthropic의 클라우드 세션에서 돌아가기 때문에 사용자가 로그아웃하거나 노트북을 닫아도 계속 작업을 이어갑니다. CI가 실패하면 스스로 코드를 고쳐 푸시하고, 준비가 되면 알림을 보냅니다.

Q3. 풀 리퀘스트(PR)가 뭔가요?

Git에서 "내가 작업한 코드 변경 사항을 메인 코드에 합쳐 달라"는 검토·합치기 요청입니다. 동료 개발자나 자동 검사 시스템(CI)이 코드를 리뷰한 뒤에 반영 여부가 결정됩니다.

Q4. p75 지연시간은 뭔가요?

응답 속도를 재시할 때 쓰는 숫자입니다. 요청 100건 중 75번째로 빠른 응답 시간을 의미합니다. 상위 25%의 매우 느린 요청을 빼고 대표값을 내기 때문에, 결제·API 성능 지표로 자주 쓰입니다.

Q5. Opus는 무엇인가요?

Anthropic이 만든 최상위 플래그십 Claude 모델 라인업입니다. 코딩, 추론, 장기간 돌아가는 에이전트 작업 같은 복잡한 일을 가장 잘하도록 설계되어 있습니다.

Q6. 기존 Claude Code 사용자는 어떻게 바뀌나요?

기존의 폴더형 프로젝트도 계속 쓸 수 있습니다. 새 프로젝트 기능은 별도의 옵트인(베타) 옵션으로 제공되며, 한 번 켜면 위에서 설명한 코디네이터 + 스레드 구조로 동작합니다.

Q7. MCP(Model Context Protocol)는 무엇인가요?

AI 모델이 외부 도구·데이터 소스·서비스에 표준화된 방식으로 연결되도록 만든 약속(프로토콜)입니다. claude.ai 계정에 등록한 커넥터를 통해 MCP 도구가 프로젝트 스레드에 전달됩니다.

7. 핵심 요약 (Key Takeaways)

하나의 프로젝트는 하나의 대화이며, Claude가 작업 단위별로 스레드를 자동으로 시작합니다.
모든 스레드는 자체 브랜치와 리포지토리 복제본을 가진 완전한 클라우드 세션입니다.
공유된 프로젝트 메모리와 지시문이 새 스레드에 자동으로 전달됩니다.
병렬 스레드는 요금제 한도(plan limit)를 더 빠르게 소모하며, 일일 상한은 모든 프로젝트 합쳐 200개의 새 스레드입니다.
베타는 웹·데스크톱의 선정된 Pro·Max 사용자에게 제공되며 CLI는 미지원입니다.
노트북을 닫아도 백그라운드에서 계속 작업하며, CI 실패 시 자동 수정까지 시도합니다.

주요 용어 한눈에 보기

프로젝트(Projects) — Claude Code 안의 단일 대화형 워크스페이스. 여러 작업을 병렬로 관리.
코디네이터(Coordinator) — 사용자 입력을 읽고 스레드를 띄우는 중심 관리자.
스레드(Thread) — 자체 브랜치와 저장소 복제본 위에서 동작하는 완전한 클라우드 세션.
서브에이전트(Subagent) — 스레드 안에서 작업을 위임받아 처리하는 하위 AI 도우미.
풀 리퀘스트(PR) — 코드 변경의 병합(머지)을 요청하는 Git 기능.
리포지토리(Repository) — 코드와 변경 이력이 저장되는 Git 저장소.
Claude Opus — Anthropic의 최상위 플래그십 LLM 모델.
MCP — 모델 컨텍스트 프로토콜. AI와 외부 도구를 표준 방식으로 연결.
CI(지속적 통합) — 코드 변경 시 자동으로 빌드·테스트를 돌리는 시스템.
p75 지연시간 — 응답 시간 분포의 75번째 백분위. 결제·API 성능 대표 지표.