클로드 코드 프로젝트 대표 이미지

공식 문서가 짚는 문제가 이 상황입니다. 세션 여러 개를 직접 돌리면 무엇을 시킬지 정하고, 같은 배경을 세션마다 반복 설명하고, 어느 세션이 끝났는지 확인하는 일을 사용자가 합니다. 프로젝트는 이 조율을 Claude가 맡는 기능입니다.

이 레터에서 다루는 것:

프로젝트는 무엇을 대신 맡는가

한 대화창, 코디네이터, 스레드

공식 문서 기준으로 프로젝트는 Claude가 관련 작업을 조율하는, 하나의 계속되는 대화입니다. 구조는 세 부분으로 나뉩니다.

스레드는 보통 클라우드 세션, 즉 내 컴퓨터가 아닌 클라우드에서 실행되는 클로드 코드입니다. 자기 브랜치(원본 코드를 건드리지 않도록 따로 떼어 둔 작업용 복사본)에서 일하고, 노트북을 닫아도 계속 돌며, 스마트폰에서 확인하고 지시할 수 있습니다. 새 스레드는 모두 프로젝트 지침에서 출발하므로, 규칙을 한 번 정하면 모든 스레드에 전달됩니다.

스레드로 이어지는 프로젝트 구조

일을 전달하면 나뉘는 방식

공식 영상 기준으로 프로젝트 대화에서 할 수 있는 일은 세 가지입니다. Claude가 제안하는 항목을 고르기, 간단한 질문하기, 할 일 목록 전달하기입니다. 목록을 전달하면 코디네이터가 작업마다 스레드를 하나씩 만들어 병렬로 돌립니다.

각 스레드는 대화에 카드로 나타납니다. 카드를 누르면 스레드의 진행 과정을 읽을 수 있고, 그 스레드에 직접 말해 방향을 바꾸거나 중지할 수 있습니다.

PR까지 이어지는 흐름

스레드가 코드를 바꿀 때의 순서입니다.

Overview의 Pull requests 탭에서 모든 PR의 상태를 봅니다.

스레드가 연 PR과 다음 단계 버튼

내 컴퓨터가 필요한 작업은 따로

내 컴퓨터에 있는 파일이나 도구가 필요하면, 그 작업의 스레드만 내 컴퓨터에서 돌리도록 요청합니다. Remote Control(내 컴퓨터의 클로드 코드를 claude.ai와 연결하는 기능)을 쓰며, 그 컴퓨터에 Claude Code 2.1.280 버전 이상이 필요합니다. 이 스레드는 그 컴퓨터가 켜져 있는 동안에만 일하고, 나머지 스레드는 계속 클라우드에서 돕니다.

만들고, 맡기고, 확인하는 순서

만들 때 입력하는 세 가지

claude.ai/code나 데스크톱 앱의 Code 탭에서 New project를 열면 세 가지를 입력합니다. 이름은 필수입니다. 목표는 한 줄이면 되고 Claude가 그 목표를 향해 일합니다. 컨텍스트는 작업할 저장소와 스레드가 읽을 파일·폴더입니다. 목표와 컨텍스트는 선택이라 나중에 채워도 됩니다. 만들면 메인 대화가 열립니다.

New project 대화상자 입력 화면

프로젝트 지침과 메모리

프로젝트 지침(Project instructions)은 새 스레드와 프로젝트 대화에 전달되는 글이며 최대 16,000자입니다. 공식 문서는 프로젝트의 목적, 기준 브랜치, 스레드가 완료 전에 스스로 검증하는 방법, 필요한 것이 없을 때의 행동, 사용자 승인이 먼저 필요한 일을 적으라고 안내합니다. 메모리는 지침과 다릅니다. Claude가 작업하며 요구사항·결정·주의점을 파일로 저장해 두는 것입니다.

Overview가 보여 주는 상태

Overview의 Threads 탭은 스레드를 상태별로 묶어 보여 줍니다.

Overview의 Threads 탭에서 상태별로 묶인 스레드

공식 팀이 권하는 팁 3가지

팁 1. 코디네이터는 low effort로

스레드는 모두 완전한 클로드 코드 세션이라, 여러 개를 동시에 돌리면 플랜 한도를 단일 세션보다 빠르게 씁니다. 프로젝트 설정에서 코디네이터와 스레드의 모델·effort(응답 전에 생각하는 정도를 정하는 설정)를 각각 바꿀 수 있습니다.

영상은 코디네이터를 low effort로 두라고 권합니다. 코디네이터는 주로 일을 배분하는 역할이라 effort를 높여도 결과가 의미 있게 좋아지지 않는다는 설명입니다. 작업 범위가 분명하다면 스레드 기본 모델을 작은 모델로 두고, 크고 복잡한 작업만 스레드에서 모델을 바꾸라는 안내도 있습니다.

프로젝트 설정의 모델·effort·자동 이어가기 항목

팁 2. 운영 규칙은 말로 지시

영상은 동시에 돌릴 스레드 수, 진행 보고 빈도, 시작 전 계획 제시를 말로 정하라고 안내합니다. 공식 문서의 예시 문장입니다.

Claude는 이런 선호를 프로젝트 메모리에 스스로 저장하고 이후 클라우드 스레드에서 따릅니다. 다만 공식 문서는 이것을 강제 설정이 아니라 Claude가 따르는 지시라고 설명하고, 스레드 수 제한도 상한선이 아니라고 밝힙니다. 문구를 고정해 처음부터 적용하려면 프로젝트 지침에 적습니다.

팁 3. 스레드는 메모리를 공유한다

선호를 기억시키면 이후 모든 스레드에 적용됩니다. 영상은 기억시킬 내용을 Claude에게 말하고 프로젝트 설정에서 편집하라고 안내합니다. 공식 문서 기준으로 클라우드 스레드는 시작할 때 메모리 색인 파일 MEMORY.md를 읽습니다.

예외가 하나 있습니다. 내 컴퓨터에서 도는 스레드는 프로젝트 지침은 받지만 메모리 파일은 불러오지 않습니다.

돌아와 보면 끝나 있는 흐름, 그리고 비슷한 기능과의 차이

공식 영상의 하루 흐름

영상의 예시는 웹사이트의 반복되는 성능 저하를 조사해 고치는 프로젝트입니다.

Library에 저장된 보고서 화면

매일 도는 루틴을 만든 대화 화면

비슷한 기능과 무엇이 다른가

병렬로 돈다는 점만으로는 프로젝트와 구분되지 않습니다. 공식 문서 기준 차이는 누가 세션을 시작하고 추적하느냐에 있습니다.

쓰기 전에 확인할 제약

🔑 핵심

다음 발행에서 또 인사드리겠습니다. swimmingcode 드림.

이 레터에서 다룬 내용에 대해 궁금한 점이 있으시면 답장으로 알려주세요. 확인해서 답해드립니다.

👇 스위밍코드 유튜브 채널

👇 스위밍코드 인스타그램

👇 스위밍코드 스레드

👇 스위밍코드 네이버 블로그