Claude Code 사용법: Projects 베타 실전 가이드

Claude Code 사용법을 익힐 때 Projects의 역할부터 정확히 이해해야 합니다. Claude Code Projects에서는 하나의 대화에 연속적인 개발 업무를 맡기고, 조정자가 개별 작업용 클라우드 스레드를 따로 시작해 추적합니다. 핵심은 채팅 창을 더 많이 여는 데 있지 않습니다. 저장소 맥락을 되풀이해 설명하고, 세션을 일일이 배정하며, 확인해야 할 브랜치나 풀 리퀘스트를 찾아다니는 시간을 줄이는 데 있습니다.

새롭게 설계된 환경은 2026년 9월 17일부터 순차적으로 제공되기 시작했으며, 아직 일부 계정만 이용할 수 있습니다. 이 가이드에서는 내 계정의 사용 가능 여부를 확인하고, 폐기해도 되는 저장소로 프로젝트 하나를 설정한 다음, 서로 겹치지 않는 작업 2개를 보내 결과를 검토하는 방법을 다룹니다. 각 스레드에 어떤 맥락이 전달되는지도 정확히 짚어봅니다.

Claude Code 사용법의 핵심: Projects는 폴더가 아니라 조정자입니다

Claude Code Projects는 Claude와 나누는 하나의 지속적인 대화, 그리고 그 대화가 스레드로 시작하는 클라우드 세션들로 구성됩니다. 이 대화를 모형 공방의 작업반장이라고 생각하면 쉽습니다. 작업반장에게 업무 개요를 건네면 별도의 작업대에서 각 일을 처리합니다. 작업대마다 자체 워크스페이스와 컨텍스트 윈도우, Git 브랜치가 있고, 작업반장은 보고를 받아 대기열을 정리합니다.

이는 Claude 채팅과 Cowork의 기존 Projects 환경과 다릅니다. 이전 버전은 대화와 참조 파일을 한데 묶는 기능입니다. 새로운 Claude Code Projects 베타는 작업을 클라우드 스레드로 배정하고 상태를 추적하며, 새 스레드에 프로젝트 맥락을 전달하는 조정자를 더했습니다.

모든 스레드는 프로젝트의 저장소와 파일, 지침, 메모리, 선택한 클라우드 환경, 계정 커넥터, 그리고 저장소 안의 CLAUDE.md, 스킬, 플러그인을 바탕으로 시작합니다. 노트북에만 설치된 툴은 스레드에 전달되지 않습니다.

이미 대상 Claude 요금제를 이용 중이라면 직접적인 비용 계산은 유리합니다. Claude Pro는 월 $20이며, $200를 연간 결제하면 월 $17입니다. Max는 월 $100부터 시작합니다. Projects에 별도의 클라우드 가상 머신 요금은 붙지 않습니다. 다만 사용량은 주의해야 합니다. 각 스레드가 완전한 Claude Code 세션이므로 병렬로 작업할수록 같은 요금제 한도를 더 빨리 소진합니다.

이 가이드에서 확인한 개인용 코딩 에이전트 구독료는 GitHub Copilot과 Cursor를 통틀어 월 $10에서 $200까지입니다. 이미 Claude를 코딩 에이전트로 쓰고 있다면 Projects는 기존 구성에 좌석 하나를 더 추가하는 상품이 아닙니다. 달라지는 것은 조정 비용이지, 엔지니어링 판단에 드는 비용이 아닙니다.

먼저 내 계정에서 베타를 쓸 수 있는지 확인합니다

Claude 어딘가에서 Projects라는 기능명을 봤다는 것만으로는 이용 조건을 충족한 것이 아닙니다.

1. Claude Pro 또는 Max 계정으로 로그인합니다.
2. claude.ai/code를 열거나 데스크톱 앱의 Code 탭으로 이동합니다.
3. 왼쪽 사이드바에 Projects가 있는지 확인합니다.
4. 보이지 않는다면 아직 해당 계정까지 순차 제공이 확대되지 않은 것입니다. Anthropic 대기 명단에 등록하고, 그동안은 일반 클라우드 세션을 사용합니다.

초기 제공 대상은 이미 클라우드 세션을 사용한 적이 있고 Claude 채팅이나 Cowork의 기존 Projects를 쓰지 않는 Pro 및 Max 계정이 우선입니다. Team과 Enterprise 계정은 아직 이 새 베타를 이용할 수 없습니다. Anthropic이 환경을 이전하는 동안 기존 Projects는 계속 작동합니다.

아직 Claude Code 설치와 인증을 마치지 않았거나 저장소 수준의 CLAUDE.md를 마련하지 않았다면 Claude Code 설정 가이드부터 확인합니다. Projects는 이러한 저장소 운용 방식 위에서 작동하며, 이를 대체하지 않습니다.

Claude Code Projects 설정은 폐기 가능한 저장소에서 시작합니다

부담 없이 버릴 수 있는 작은 GitHub 저장소를 사용합니다. 첫 실행의 목적은 프로덕션 마이그레이션을 베타 조정자에게 맡기는 것이 아니라, 작업 배정과 맥락, 브랜치, 사용량이 어떻게 움직이는지 확인하는 것입니다.

1. 프로젝트를 만들기 전에 GitHub 접근 권한부터 바로잡습니다

코드 작업에 사용할 저장소는 github.com에 있어야 합니다. 연결된 GitHub 계정에는 푸시 권한이 있어야 하며, 해당 저장소에 Claude GitHub App도 설치해야 합니다. /web-setup으로 만든 토큰이 일반 클라우드 세션의 저장소 복제에는 충분할 수 있지만, 프로젝트 스레드에는 그것만으로 부족합니다.

이 베타에서는 GitHub Enterprise Server, GitLab, Bitbucket 저장소를 프로젝트 코드 저장소로 지원하지 않습니다. 조직 소유 저장소라면 조직 소유자가 GitHub App 설치와 SSO 승인을 허용해야 할 수 있습니다.

2. 범위가 좁은 프로젝트를 만듭니다

Projects를 열고 New project를 선택한 뒤 다음 내용을 추가합니다.

• Name: Parser Project Test처럼 임시 프로젝트임을 바로 알아볼 수 있는 이름
• Goal: Improve parser coverage and documentation without changing behavior처럼 한 문장으로 정리한 목표
• Context: 폐기 가능한 저장소만 추가

필수 항목은 이름뿐입니다. 목표 범위를 좁혀 두면 조정자가 유용한 경계를 확보할 수 있고, 저장소를 하나만 연결하면 여러 저장소를 쓸 때 생기는 설정 차이를 피할 수 있습니다.

3. 모든 스레드에 적용할 지침을 하나 추가합니다

Project settings > Memory > Project instructions를 엽니다. 모든 스레드에 같은 완료 기준과 승인 범위를 부여합니다. 예시는 다음과 같습니다.

기본 브랜치에서 시작합니다. 스레드마다 브랜치를 하나씩 사용합니다. 완료를 보고하기 전에 관련 테스트를 실행합니다. 스레드에서 먼저 묻지 않고 병합하거나 CI를 변경하거나 의존성을 추가하지 않습니다. 접근 권한이 없다면 누락된 항목을 밝히고 멈춥니다.

프로젝트 지침은 최대 16,000자까지 입력할 수 있지만 첫 시험에서는 짧게 유지하는 편이 좋습니다. 저장소별 빌드 명령은 계속 해당 저장소의 CLAUDE.md에 둡니다. 프로젝트 전반에서 새로 드러난 요구 사항과 결정, 주의점은 프로젝트 메모리에 기록합니다.

4. 클라우드 환경을 점검합니다

Project settings > Environment를 엽니다. 새 스레드는 모두 여기서 선택한 환경을 사용합니다. 이 환경이 네트워크 접근, 환경 변수, API 자격 증명, 설정 스크립트로 설치할 툴을 결정합니다.

Anthropic이 호스팅하는 기본 환경은 일반적으로 쓰이는 서비스의 허용 목록에 접속할 수 있고, 미리 설치된 툴도 제공합니다. 하지만 로컬 데이터베이스, VPN, 기기 에뮬레이터, 셸 설정, 노트북에만 있는 자격 증명까지 자동으로 가져오지는 않습니다. 이런 항목에 의존하는 작업을 맡기기 전에 환경을 구성해야 합니다.

5. 충돌하지 않는 작업 2개를 보냅니다

서로 관련 없는 일을 조정자가 어떻게 나누는지 볼 수 있도록 두 작업을 한 메시지에 넣습니다. 대상 파일은 서로 달라야 합니다. 예시는 다음과 같습니다.

확인을 다시 요청하지 말고 바로 시작합니다. 잘못된 파서 입력에 대한 단위 테스트를 추가할 스레드 하나를 만듭니다. API 가이드의 오래된 예시를 수정할 두 번째 스레드도 만듭니다. 프로덕션 파서 동작은 변경하지 말고, 어느 브랜치도 병합하지 않습니다.

Anthropic에 따르면 한 메시지에 담긴 서로 관련 없는 작업 여러 개는 별도 스레드가 됩니다. 별도 지시가 없다면 각 코드 스레드는 저장소의 기본 브랜치에서 새 브랜치를 만듭니다. 브랜치가 분리되어도 두 스레드가 같은 코드를 수정하면 충돌할 수 있으므로, 파일을 겹치지 않게 고르는 것이 중요합니다.

6. 조정자의 요약에 그치지 말고 각 스레드를 검토합니다

스레드 카드를 하나씩 열고 다음 항목을 기록합니다.

Overview는 작업을 Ready for review, Waiting on you, Working, Landing, Idle, Resolved 상태로 나눕니다. 다른 탭에는 프로젝트 파일과 풀 리퀘스트, 루틴이 모입니다. 조정자는 스레드 보고를 볼 수 있지만 모든 과정을 보지는 못합니다. 따라서 실제 작업을 감사하려면 스레드 대화 기록을 확인해야 합니다.

7. 나중에 만든 작업이 저장된 맥락을 읽는지 시험합니다

두 스레드가 모두 끝나면 Documentation changes must preserve every runnable example처럼 위험하지 않은 규칙 하나를 기억하라고 조정자에게 지시합니다. 이어서 작고 새로운 문서 스레드를 시작하고, 편집하기 전에 프로젝트의 브랜치 규칙과 문서 규칙을 말해 보라고 합니다.

이렇게 하면 서로 다른 맥락 전달 경로 2개를 확인할 수 있습니다. 프로젝트 지침은 고정된 업무 개요로서 모든 새 스레드에 전달되어야 합니다. 프로젝트 메모리는 저장된 결정을 MEMORY.md를 통해 이어가야 합니다. 저장소의 CLAUDE.md는 코드베이스 자체에 속한 규칙을 담는 세 번째 독립 계층입니다.

스레드에 따라가는 맥락과 로컬에 남는 항목

Projects를 가장 쉽게 오해하는 방법은 클라우드 스레드를 내 노트북의 원격 복제본으로 생각하는 것입니다. 실제로는 그렇지 않습니다. 클라우드 스레드는 프로젝트, 저장소, 계정, 환경의 맥락을 조합해 새로 만든 세션입니다.

여러 저장소를 연결할 때 빠지기 쉬운 함정이 하나 있습니다. 저장소가 여러 개인 프로젝트에서는 모든 저장소의 CLAUDE.md, 스킬, 플러그인이 로드되지만, 저장소의 권한 규칙과 훅, env 설정은 로드되지 않습니다. 저장소를 아우르는 규칙은 프로젝트 지침에, 환경 변수는 클라우드 환경에 넣습니다.

병렬 스레드를 무제한으로 실행할 수 있는 것은 아닙니다

Anthropic 문서에는 동시에 실행할 수 있는 스레드 수가 고정되어 있지 않습니다. 조정자에게 한 번에 2개씩 실행하라고 요청할 수는 있지만, 이는 강제 할당량이 아니라 선호 사항입니다. 별도로 적용되는 확정된 상한은 프로젝트 전체에서 하루에 새 스레드 200개입니다.

실행 중인 스레드는 요금제 사용량을 씁니다. 조정자도 보고서를 읽고 다음 작업을 결정하는 동안 사용량을 씁니다. 풀 리퀘스트를 지켜보는 스레드는 CI가 실패하거나 리뷰 댓글이 달리면 다시 깨어나 사용량을 소모합니다. 실행 중인 스레드나 감시 중인 풀 리퀘스트, 새 메시지가 없다면 유휴 프로젝트는 그대로 두어도 아무것도 소모하지 않습니다.

새 프로젝트의 기본값은 스레드에 Opus와 high effort를, 조정자에 low effort를 사용하는 설정입니다. 큰 작업 묶음을 시작하기 전에 Project settings > General을 열고, 각 작업을 처리할 수 있는 범위에서 가장 저렴한 모델과 effort 수준을 선택합니다. 그런 다음 작은 동시 실행 수를 요청합니다. 중요한 숫자는 Projects가 시작할 수 있는 스레드 수가 아니라, 대기열이 소음으로 바뀌기 전에 내가 검토할 수 있는 결과의 수입니다.

효과가 큰 Claude Code 활용법 7가지

1. 여러 저장소의 마이그레이션을 조정하는 플랫폼 리드

서버, 웹, 모바일 저장소를 연결한 뒤 폐기 예정 엔드포인트를 제거한다는 하나의 목표를 프로젝트에 부여합니다. 별도 스레드가 각각의 호출부를 별도 브랜치에서 수정하고, 조정자는 순서와 장애 요인을 추적할 수 있습니다. 수동으로 에이전트 세션 3개를 맞추는 대신 하나의 리뷰 대기열을 갖게 되는 것이 이점입니다. 목표가 단일 세션보다 오래 지속되고 작업을 저장소별로 명확히 나눌 수 있으므로 가장 잘 맞는 사례입니다.

2. 단일 서비스의 버그 대기열을 처리하는 메인테이너

새 버그 리포트와 스택 트레이스가 들어올 때마다 같은 프로젝트에 붙여 넣을 수 있습니다. 조정자는 회귀 문제를 이미 해당 영역을 조사 중인 스레드로 보내거나, 프로젝트에 저장된 주의점을 전달해 새 스레드를 시작할 수 있습니다. 반복 설명이 줄고 어떤 버그가 접근 권한, 리뷰, 의사 결정을 기다리는지 지속적으로 기록된다는 점이 이점입니다.

3. 서로 독립된 출시 준비 점검을 진행하는 릴리스 책임자

테스트 스위트, 문서 링크, 의존성 감사, 릴리스 노트 초안을 각각 별도 스레드에 맡깁니다. 결과를 검토하기 전까지는 각 작업을 읽기 전용으로 유지합니다. 조정자는 모든 근거를 하나의 거대한 대화 기록에 뒤섞지 않고, 통과한 항목과 답변이 필요한 항목을 드러낼 수 있습니다. 체크리스트에서 의사 결정까지 걸리는 시간은 짧아지고, 최종 판단은 릴리스 책임자가 유지합니다.

4. 큰 변경을 경계별로 나누는 리팩터링 리드

컨텍스트 윈도우 하나보다 큰 마이그레이션이라면 독립된 모듈이나 패키지를 별도 스레드에 할당하고, 반드시 지켜야 할 원칙을 프로젝트 지침에 적습니다. 각 스레드는 자체 브랜치를 검증해 결과를 보고합니다. 하나의 상시 완료 기준 아래에서 병렬로 진척을 낼 수 있다는 점이 이점입니다. 다만 구조가 겹치면 문제가 됩니다. 브랜치 2개가 같은 공용 추상화를 수정할 경우 일반적인 병합 충돌이 여전히 발생할 수 있습니다.

5. 고객 애플리케이션을 유지보수하는 에이전시 엔지니어

고객 한 곳의 저장소, 지침, 환경만 담은 비공개 프로젝트를 하나 만듭니다. 계약 기간 동안 작은 수정과 리뷰 요청, 문서 작업을 계속 이 프로젝트에 넣습니다. 고객의 맥락을 서로 섞지 않고 연속성을 유지할 수 있다는 점이 이점입니다. 베타 기간에는 Projects가 사용자 한 명에게 귀속되고 공유할 수 없으므로, 고객 협업 포털이 아니라 개인용 업무 조종석으로 봐야 합니다.

6. 반복되는 연동 실패를 분석하는 지원 엔지니어링 리드

Projects에 저장소가 꼭 필요한 것은 아닙니다. 지원 티켓 내보내기 파일과 연동 문서를 업로드한 뒤, 스레드에 실패 유형 분류와 예시 검증, 개선안 초안 작성을 맡깁니다. 결과 파일은 Library에 저장됩니다. 재사용할 수 있는 하나의 프로젝트 맥락과 분석·작성 작업별 근거 기록을 각각 얻을 수 있다는 점이 이점입니다.

7. 뒤섞인 백로그를 정리하는 1인 창업자

테스트 작업 하나, 문서 작업 하나, 저장소 감사 하나를 작은 묶음으로 보냅니다. 조정자에게 스레드를 2개만 실행하고 파괴적인 변경은 먼저 제안하라고 지시합니다. 각 세션을 지켜보는 대신 완료된 브랜치를 검토하는 데 집중할 수 있다는 점이 이점입니다. 모든 작업이 같은 파일을 수정해야 하거나 창업자의 노트북에서만 접근 가능한 서비스가 필요하다면 잘 맞지 않습니다.

함께 만들 만한 보완 제품 3가지

이 베타에는 문서화된 Projects API가 없습니다. 따라서 가까운 시기에 타당한 제품은 워크플로 옆에서 맥락을 준비하거나 GitHub 상태를 점검하고, 사람이 결과를 검토하도록 돕는 형태입니다.

1. 가장 유망한 기회, Project Readiness Auditor

저장소가 클라우드 코딩 에이전트를 받아들일 준비가 됐는지 확인하는 읽기 전용 GitHub 앱을 만듭니다. 저장소 지침과 테스트 명령, 브랜치 보호, GitHub App 적용 범위, 필수 시크릿, 네트워크 의존성을 점검한 뒤 프로젝트 지침 초안과 클라우드 환경 체크리스트를 생성하는 제품입니다.

관련 수요는 이미 검색량에서 드러납니다. “ai powered coding agent”의 미국 월간 검색량은 8,100회이며 상업적 의도가 있습니다. 이 가이드에서 확인한 개인용 코딩 에이전트 공식 요금제는 월 $10에서 $200까지지만, 유료 좌석만으로 저장소가 병렬 클라우드 작업에 안전해지는 것은 아닙니다.

판매 가능한 최소 버전은 GitHub 저장소 하나를 스캔하고 환경 관련 질문 6개를 한 뒤, 바로 붙여 넣을 수 있는 업무 개요를 내보내면 됩니다. 문제는 플랫폼 위험입니다. Anthropic이나 GitHub가 설정 점검 기능을 빠르게 흡수할 수 있으므로, Claude 전용 템플릿 하나에 머물지 않고 여러 에이전트를 지원하며 유용한 감사 이력을 제공해야 합니다.

2. AI 딜리버리 라이프사이클 보드

브랜치, 풀 리퀘스트, CI 상태, 리뷰 댓글, 사람의 승인을 딜리버리 목표별로 묶는 GitHub 기반 보드를 만듭니다. 여러 코딩 에이전트를 쓰면서 중립적인 리뷰 화면 하나가 필요한 기술 리드를 위한 제품입니다.

“AI software development life cycle”의 미국 월간 검색량은 720회이고 키워드 난이도는 4, CPC는 $18.13입니다. 최소 버전은 GitHub 이벤트를 읽어 working, blocked, ready, landed의 4가지 상태로 정리합니다. Claude Projects 대화 기록에 비공개로 접근할 필요가 전혀 없습니다.

차별화가 관건입니다. GitHub와 에이전트 공급업체가 이미 이런 상태의 상당 부분을 보여 줍니다. 공급업체를 넘나들며 작업을 연결하고, 승인 근거를 보존하며, 더 보기 좋은 대기열만 그리는 데 그치지 않고 변경이 막힌 이유를 설명해야 경쟁력이 생깁니다.

3. 자동 리뷰 정책 라우터

에이전트가 만든 풀 리퀘스트에 저장소별 리뷰 정책을 적용하는 GitHub 앱을 만듭니다. 파서 변경에는 테스트 산출물을 요구하고, 결제 관련 변경은 지정 리뷰어에게 보내며, 자동 수정 댓글이 권한 높은 자동화를 실행하지 못하게 막을 수 있습니다.

“Automated code review”의 미국 월간 검색량은 210회이고 CPC는 $63.33입니다. 대상은 더 작지만 구매 의도가 강하다는 신호입니다. MVP에는 정책 파일, 풀 리퀘스트 검사, 누락된 근거를 설명하는 짧은 안내가 필요합니다.

기능 중복은 주의해야 합니다. Claude 스레드는 이미 풀 리퀘스트를 감시하고 CI 실패와 리뷰 댓글에 대응합니다. 새 제품은 또 하나의 리뷰 봇을 흉내 내는 대신, 여러 에이전트와 저장소에 걸친 위험을 관리해야 합니다.

Claude Code Projects로도 해결되지 않는 문제

Projects는 작업을 나눌 수 있고 필요한 맥락을 GitHub, 업로드한 파일, 커넥터, 클라우드 환경에 둘 수 있을 때 가장 효과적입니다. 단일 세션에 들어가는 일회성 수정, 로컬 기기나 VPN에 묶인 작업, 여러 사람이 같은 프로젝트를 조작해야 하는 팀에는 적합하지 않습니다.

일반적인 딜리버리 위험도 사라지지 않습니다.

• 별도 스레드의 브랜치가 겹치면 병합 충돌이 생길 수 있습니다.
• 동시 실행 요청은 조정자 지침일 뿐, 강제되는 예산 통제가 아닙니다.
• 병렬 스레드는 Pro 한도를 빠르게 소진할 수 있습니다.
• 일시 중지된 샌드박스가 새로 복제한 저장소에서 재개되면 커밋하지 않은 작업을 잃을 수 있습니다.
• 이 베타는 개인용이며, 프로젝트 공유나 조직 수준 제어 기능이 없습니다.
• 스레드는 나중에 다른 프로젝트로 옮길 수 없습니다.

결론은 단순합니다. Projects는 분리 가능한 작업을 조정하는 데 사용하되, 아키텍처나 승인을 대신 맡기는 용도로 쓰지 않습니다. 작업 2개로 시작해 두 대화 기록을 모두 살펴보고, 브랜치와 사용량이 예측 가능해진 뒤에만 동시 실행 수를 늘립니다.

자주 묻는 질문

Claude Code에서 Projects를 사용할 수 있나요?

선정된 Claude Pro 및 Max 계정은 claude.ai/code, 데스크톱 앱의 Code 탭, Claude 모바일 앱에서 새 Projects 베타를 사용할 수 있습니다. Code 사이드바에 Projects가 없다면 아직 해당 계정까지 순차 제공이 확대되지 않은 것입니다. claude project라는 터미널 명령은 이 기능과 무관한 로컬 디렉터리 상태를 관리합니다.

Claude Code Projects는 어떻게 사용하나요?

Claude Code에서 프로젝트를 만들고, 목표와 꼭 필요한 저장소 또는 파일만 추가한 뒤, 짧은 상시 지침을 작성하고 클라우드 환경을 선택합니다. 그런 다음 조정자 대화에 작업을 하나 이상 보냅니다. 무엇이든 병합하기 전에 Overview에서 각 스레드를 검토하고 브랜치, 대화 기록, 검증 결과, 사용량을 확인합니다.

기존 프로젝트에서도 Claude Code를 사용할 수 있나요?

그렇습니다. 기존 github.com 저장소를 연결해 프로젝트를 만들거나, 기존 클라우드 세션에서 Continue as a project를 선택할 수 있습니다. 코드 저장소를 쓰려면 연결된 GitHub 계정에 푸시 권한이 있어야 하고, 해당 저장소에 Claude GitHub App이 설치되어 있어야 합니다.

Claude Projects와 Claude Code의 핵심 차이는 무엇인가요?

Claude Code는 로컬 또는 클라우드 세션에서 실행되는 코딩 에이전트입니다. 새롭게 설계된 Claude Code Projects는 조정 계층입니다. 하나의 대화가 여러 Claude Code 클라우드 세션을 시작하고 추적하며, 공유 프로젝트 맥락을 전달하고 상태를 모읍니다. Claude 채팅과 Cowork의 기존 Projects는 이전이 완료될 때까지 파일과 대화를 묶는 워크스페이스 모델로 유지됩니다.

저장소와 승인 절차, 클라우드 환경에 맞춘 프로젝트용 에이전트 워크플로를 구축하려면 AI 프로덕션 시스템을 확인하세요.