Claude Code Projects에서는 한 대화에 여러 개발 작업을 요청하면 Claude가 작업별 대화인 스레드를 만들고 진행 상황을 관리합니다. Anthropic이 2026년 9월 17일 공개한 새 베타입니다.
다만 Pro나 Max를 구독한다고 바로 사용할 수 있는 단계는 아닙니다. 2026년 9월 22일 확인한 공식 안내를 기준으로 이용 조건과 처음 설정할 내용을 정리했습니다.
시작하려면 계정과 실행 환경부터 확인하세요
현재 베타는 Pro와 Max 계정에 순차 공개 중이며 Team과 Enterprise는 아직 대상이 아닙니다. Claude 웹의 Code 화면이나 데스크톱 앱의 Code 탭에서 Projects 메뉴가 보이는지 확인하면 됩니다. 메뉴가 없다면 해당 계정에 아직 공개되지 않은 상태입니다.
코드 작업을 하려면 GitHub.com에 있는 저장소를 연결해야 하며 계정의 푸시 권한과 해당 저장소에 설치된 Claude GitHub App도 필요합니다. 저장소는 코드와 변경 기록을 보관하는 곳이고 푸시 권한은 수정한 내용을 그곳에 올릴 권한입니다.
스레드는 클라우드에서 실행됩니다. 내 컴퓨터에서 실행 중인 로컬 세션을 프로젝트에 넣을 수 없고 로컬에 설치한 도구나 설정도 자동으로 가져오지 않습니다. 내 컴퓨터에서만 접속할 수 있는 데이터베이스나 사내망 서비스가 필요한 작업이라면 실행 환경이 맞는지 먼저 확인해야 합니다.
새 프로젝트에 목표와 공통 지침을 넣습니다
Projects에서 New project를 선택하고 이름을 입력한 뒤 필요한 저장소와 자료를 추가합니다. 목표와 자료는 나중에 보충할 수도 있습니다. 코드를 수정할 일이 없다면 저장소 없이 문서를 올려 작업할 수도 있습니다.
공통 지침에는 어느 브랜치에서 시작할지, 어떤 테스트를 실행할지, 무엇을 사용자에게 물어야 할지 적어두면 됩니다. 브랜치는 코드 변경을 따로 관리하는 작업 단위입니다. 새 스레드는 프로젝트의 자료와 지침, 메모리를 참고하므로 작업마다 같은 배경을 다시 설명할 필요가 줄어듭니다.
처음에는 작은 작업을 하나 맡겨 결과를 확인한 뒤 동시에 진행할 작업을 늘리는 편이 좋겠습니다. 예를 들어 개인 블로그 도구를 만든다면 이미지 설명 기능 추가와 글 목록의 날짜 정렬 오류 수정을 각각 맡길 수 있습니다. 두 작업이 같은 코드를 수정해야 한다면 먼저 처리할 작업을 정해두는 편이 낫겠죠.
Overview에서 상태를 확인하고 Library에서 파일을 찾습니다
프로젝트 대화에서는 전체 요청을 전달하고 개별 스레드에서는 세부 내용을 확인합니다. Claude는 새 스레드를 만들거나 이미 관련 작업을 맡은 스레드에 요청을 전달할 수 있습니다.
| 화면 | 확인할 내용 |
|---|---|
| 프로젝트 대화 | 전체 작업 지시와 결과 요약 |
| 개별 스레드 | 해당 작업의 상세 대화와 결과 |
| Overview | 진행 중인 작업과 검토 또는 답변이 필요한 작업 |
| Library | 사용자가 추가한 파일과 스레드가 만든 파일 |
| Pull requests | 스레드가 연 코드 변경 요청 |
예를 들어 날짜 정렬 수정이 끝나고 이미지 설명 기능을 맡은 스레드가 입력 위치에 대한 답변을 기다린다면 Overview에서 해당 스레드를 열어 답하면 됩니다. 프로젝트 대화에 중간 보고가 없더라도 작업이 멈췄다고 단정할 수는 없으니 스레드 안의 진행 내용을 확인하세요.
작업 수를 늘리기 전에 사용량과 변경 코드를 확인하세요
저는 Claude Code에서 Max 5배 요금제를 쓰고 있습니다. 다만 이 글은 Projects를 직접 사용한 후기가 아니라 공식 안내를 바탕으로 정리한 사용법입니다.
Projects 사용량은 다른 Claude Code 세션의 사용량과 합산됩니다. 각 스레드뿐 아니라 작업을 조율하는 프로젝트 대화도 토큰을 쓰므로 여러 작업을 동시에 진행하면 한도에 더 빨리 도달할 수 있습니다. Project settings의 Usage에서 사용량을 확인할 수 있습니다. General에서는 모델을 선택하고 추론에 들이는 노력을 조절하는 effort를 설정할 수 있습니다.
작업별 브랜치가 달라도 병합 충돌은 생길 수 있습니다. 병합은 따로 수정한 내용을 합치는 과정인데요. 두 스레드가 같은 날짜 정렬 코드를 서로 다르게 고쳤다면 어느 변경을 적용할지 정해야 합니다. 각 작업의 테스트가 끝난 뒤에도 코드를 합칠 때 변경 내용을 검토해야 합니다.
여러 작업에 같은 자료와 규칙을 반복해서 설명하고 있다면 Projects를 사용해 볼 만합니다. 처음에는 수정 범위가 겹치지 않는 작은 작업부터 맡기고 결과와 사용량을 확인한 뒤 작업 수를 늘리세요. 로컬 도구가 꼭 필요한 작업은 현재 사용하던 로컬 세션에서 이어가면 됩니다.
댓글
댓글 쓰기