프로젝트는 Pro 및 Max 플랜에서 공개 베타 상태이며 클라우드 세션을 사용했으며 claude.ai 채팅 또는 Cowork에 기존 프로젝트가 없는 계정부터 시작하여 점진적으로 출시되고 있습니다. 아직 Team 또는 Enterprise 플랜에서는 사용할 수 없습니다. claude.ai/code의 사이드바 또는 데스크톱 앱의 Code 탭에 프로젝트가 나타나지 않으면 출시가 계정에 아직 도달하지 않았으며 대기 목록에 참여할 수 있습니다. 병렬로 에이전트 실행에서 그 동안 사용할 수 있는 것을 나열합니다.
- 한 곳으로 작업 전송: 버그 보고서, 스택 추적 또는 작업 목록을 대화에 붙여넣으면 Claude가 각 작업에 대한 스레드를 시작하거나 이미 해당 영역에서 작업 중인 스레드로 전달하고 빠른 질문에 즉시 답변합니다.
- 컨텍스트를 한 번 설정: 모든 새 스레드는 프로젝트의 저장소, 지침 및 메모리로 시작하므로 대상 분기와 같이 한 번 명시한 규칙이 모든 스레드에 도달합니다.
- 떠났다가 완료된 작업으로 돌아오기: 한 시간 후 또는 다음 아침에 돌아오면 개요 창에 어느 스레드가 완료되었는지, 어느 풀 요청이 검토 준비가 되었는지, 어느 스레드가 사용자의 답변을 기다리고 있는지 표시됩니다.
프로젝트를 사용할 때
프로젝트는 한 세션보다 오래 지속되고 계속 작업을 생성하는 목표가 있을 때 생성할 가치가 있습니다. 이러한 종류의 작업이 프로젝트에 적합합니다:- 많은 저장소에 걸친 하나의 목표: “모든 서비스를 새 lint 구성으로 업그레이드합니다.” Claude는 저장소당 하나의 스레드를 실행할 수 있으며, 각각 자체 풀 요청을 가지고 있고, Overview 창에 어느 것이 검토 준비가 되었는지 표시됩니다.
- 계속 공급하는 영역: 한 서비스에 대한 버그, 스택 추적 및 검토 요청을 대화에 붙여넣으면 도달합니다. 한 수정 후 Claude에게 기억하도록 말한 함정은 다음 수정을 위해 프로젝트 메모리에 있습니다.
- 세션보다 큰 빌드 또는 마이그레이션: “
docs/spec.md가 설명하는 것을 빌드합니다” 또는 “앱을 더 이상 사용되지 않는 ORM에서 이동합니다.” 작업은 각각 일부를 수행하는 스레드로 분할되고, Claude에게 초기에 기억하도록 요청한 결정이 나중 스레드에 도달하며, 빌드 중에 발견한 사양 변경 및 버그가 동일한 대화로 이동합니다. - 코드가 아닌 작업: 계약 폴더 또는 지원 티켓 내보내기를 계속 돌아와서 새로운 질문을 하는 경우, 예를 들어 “이 티켓에서 가장 일반적인 10가지 통합 실수를 찾습니다.” 저장소를 추가하는 대신 문서를 업로드하고, 스레드는 프로젝트의 Library 탭에 각 작성물을 파일로 제공합니다.
다른 것이 더 잘 맞을 때
스레드는 GitHub 저장소와 프로젝트에 업로드한 파일, 폴더 및 Google Drive 폴더에서 작동하며, 머신에만 존재하는 파일이나 도구에서는 작동하지 않습니다. 다음 경우에는 다른 것이 더 잘 맞습니다:- 세션에 맞는 하나의 작업: “불안정한 로그인 테스트를 수정합니다.” 클라우드 세션을 직접 시작하세요.
- 머신만 도달할 수 있는 도구 또는 서비스가 필요한 작업: 로컬 데이터베이스, 디바이스 에뮬레이터, VPN 뒤의 API입니다. 로컬 세션을 사용하거나 에이전트 보기를 사용하여 여러 개를 동시에 실행하세요. 작업에 로컬 파일만 필요하면 대신 프로젝트에 업로드하세요.
- 대화 없이 일정에 따라 반복되는 하나의 작업: “매주 월요일 종속성 보고서를 게시합니다.” 자체적으로 루틴을 생성하세요.
- 여러 사람이 Claude에게 작업을 제공하고 Slack 채널에서 함께 조율: Claude Tag를 참조하세요.
프로젝트가 어떻게 구성되는지
프로젝트는 Claude와의 하나의 조율 대화와 그것이 작업을 수행하기 위해 시작하는 스레드입니다. 이것이 그 부분들입니다:- 프로젝트 대화: Claude가 조율자 역할을 하는 하나의 장기 실행 세션입니다. 사용자가 보내는 것을 받아서 무엇이 스레드가 될지 결정하고 시작한 모든 스레드를 추적합니다. 스레드가 보고하는 것을 보지만 스레드가 취하는 모든 단계를 보지는 않습니다.
- 스레드: 작업자입니다. 각각은 자신의 컨텍스트 윈도우를 가진 별도의 클라우드 세션으로, 자신의 브랜치에서 한 가지 작업을 수행하고, 작업이 필요할 때 풀 리퀘스트를 열고, 완료되면 대화에 보고합니다.
- 모든 스레드가 시작할 때 가지는 것:
- 프로젝트의 저장소와 파일, 그리고 지침과 메모리
- 프로젝트의 각 저장소의
CLAUDE.md, 스킬, 플러그인, 그리고 하나의 저장소를 가진 프로젝트에서는 그 저장소의 권한 규칙과 훅도 포함 - claude.ai 계정의 커넥터
- 네트워크 액세스, 환경 변수, API 자격 증명, 설치된 도구를 설정하는 클라우드 환경
- 개요 창: 모든 스레드를 한 번에 보고 어느 것이 사용자를 필요로 하는지 보는 곳입니다. 다른 탭은 추가한 파일과 스레드가 생성한 파일을 위한 라이브러리, 스레드가 열은 풀 리퀘스트를 위한 풀 리퀘스트, 프로젝트의 예약된 작업을 위한 루틴입니다.
프로젝트 만들기
claude.ai/code에서 또는 데스크톱 앱의 Code 탭에서 프로젝트를 만들고 사용합니다. 프로젝트를 시작하는 방법은 두 가지입니다:- 처음부터 시작: Claude가 실행할 작업 흐름을 알고 있을 때 새 프로젝트 대화상자를 열고 이름을 지정합니다. 처음부터 새 프로젝트 시작하기에서 대화상자를 안내합니다.
- 이미 작업 중인 클라우드 세션에서: 해당 세션의 메뉴에서 프로젝트로 계속하기를 선택하면 Claude가 세션이 수행 중이던 작업을 바탕으로 프로젝트 설정을 제안합니다. 기존 클라우드 세션에서 시작하기를 참조하세요.
필수 조건 확인하기
프로젝트를 만들기 전에 플랜, GitHub 설정 및 작업이 도달해야 할 사항을 확인하세요:- 플랜: Pro 또는 Max를 사용 중이며 사이드바에 프로젝트가 표시됩니다.
- GitHub(프로젝트가 코드에서 작업할 경우): 코드가 GitHub Enterprise Server, GitLab 또는 Bitbucket이 아닌 github.com에 있고, 연결된 GitHub 계정이 코드에 대한 푸시 액세스 권한을 가지고 있으며, Claude GitHub App이 설치되어 있습니다.
/web-setup으로 GitHub를 연결한 경우, 해당 토큰을 사용하면 다른 클라우드 세션이 리포지토리에 도달할 수 있지만 Claude GitHub App이 필요한 프로젝트 스레드에는 충분하지 않습니다. GitHub 액세스 설정하기에 단계가 나와 있습니다. - 네트워크, 자격 증명 및 도구: 이들은 프로젝트의 클라우드 환경에서 제공됩니다. 기본 환경은 이미 일반적인 패키지 레지스트리에 도달하므로, 작업이 다른 도메인, 시크릿 또는 사전 설치되지 않은 도구가 필요한 경우에만 확인하세요. 작업이 MCP 서버가 필요한 경우, claude.ai 커넥터에서 연결된 것으로 표시되는지 확인하세요.
처음부터 새 프로젝트 시작하기
처음부터 프로젝트를 시작한다는 것은 새 프로젝트 대화상자를 열고, 작업 흐름의 이름을 지정하고, 선택적으로 목표와 작업할 리포지토리 및 파일을 제공하는 것을 의미합니다. 이름만 필수이므로 먼저 프로젝트를 만들고 작업이 진행되면서 나머지를 채울 수 있습니다.1
프로젝트 열기
claude.ai/code에서 또는 데스크톱 앱의 Code 탭에서 왼쪽 사이드바의 프로젝트를 선택한 다음 새 프로젝트를 선택합니다. 브라우저에서는 claude.ai/code/projects/browse로 직접 이동할 수도 있습니다.
2
새 프로젝트 대화상자 채우기
프로젝트를 계속 추가할 하나의 작업 흐름으로 범위를 지정합니다. 예를 들어 하나의 API를 지연 시간 목표 이내로 유지하는 데 필요한 모든 것입니다. 프로젝트를 사용할 때에 더 많은 예시가 있습니다. 그런 다음 대화상자의 필드를 채웁니다:
- 이름: 프로젝트 목록에 프로젝트가 표시되는 방식입니다.
- 목표 (선택 사항): “p95 API 지연 시간을 200ms 이하로 유지”와 같이 달성하려는 작업의 한 줄입니다. 대화에서 Claude는 이를 향해 작업합니다. 목표가 없으면 Claude는 사용자가 보내는 작업에서 작업하며, 나중에 프로젝트 설정 > 일반에서 목표를 추가할 수 있습니다.
- 컨텍스트 (선택 사항): 이 프로젝트가 작업할 GitHub 리포지토리와 스레드가 읽어야 할 파일, 폴더 또는 Google Drive 폴더입니다. 각각에 대해 추가를 클릭합니다. 작업이 만질 수 있는 모든 리포지토리가 아닌 대부분의 작업이 필요로 하는 리포지토리를 추가합니다. 추가할 리포지토리 결정하기에서 선택 사항을 다룹니다. 나중에 프로젝트 설정 > 환경에서 더 추가할 수 있습니다.
3
프로젝트 만들기
프로젝트 만들기를 클릭합니다. 프로젝트의 대화가 열리고 하단에 메시지 상자가 있으며, 여기서 Claude를 위한 작업을 설명합니다.첫 번째 프로젝트에서는 먼저 메시지를 보내지 않는 한 프로젝트가 만들어지자마자 Claude가 자신의 차례를 가집니다. 그 차례는 플랜을 사용합니다. 그 과정에서 Claude는 다음을 수행할 수 있습니다:
- 리포지토리를 읽을 수 있는 프로젝트가 있는 경우 리포지토리를 탐색하는 하나의 스레드를 시작하고 아무것도 변경하지 않으며 다음 단계를 제안합니다.
- 최근 클라우드 세션에서 도출한 설정 권장 사항을 게시합니다: 추가할 리포지토리, 만들 루틴 및 시작할 수 있는 스레드입니다. 권장되는 모든 리포지토리와 루틴은 기본적으로 켜져 있습니다. 원하지 않는 것은 끄고 설정 업데이트를 클릭하여 나머지를 추가하거나, 권장 사항을 무시하고 직접 작업을 설명합니다.
기존 클라우드 세션에서 시작하기
이미 프로젝트에 속해야 하는 작업을 수행 중인 클라우드 세션이 있는 경우, 사이드바에서 세션의 메뉴를 열고 프로젝트로 계속하기 또는 프로젝트로 이동을 선택합니다:- 프로젝트로 계속하기는 세션의 이름을 따서 새 프로젝트를 만들고 엽니다. Claude는 세션을 읽고 대화에 설정 권장 사항을 게시하여 확인하도록 합니다. 원본 세션은 세션 목록에 남아 있고, 차례 중간에 있었다면 계속 실행되므로 둘 다 동시에 작동하지 않으려면 직접 중지하세요. 클라우드 세션의 메시지 상자 위에 나타날 수 있는 프로젝트 설정 배너를 대신 사용하면 결과는 동일하지만, 프로젝트가 열리면 세션의 실행 중인 차례가 중지됩니다.
- 프로젝트로 이동은 세션의 작업을 기존 프로젝트로 가져옵니다. 해당 프로젝트의 대화에 Claude가 세션을 읽고 중단한 부분부터 계속하도록 요청하는 메시지를 게시하고, 새 작업은 프로젝트의 자체 스레드에서 계속됩니다. 원본 세션은 세션 목록에 남아 있으며 변경되지 않습니다.
GitHub 액세스 설정하기
대부분의 GitHub 설정은 프로젝트당이 아닌 한 번만 발생합니다. GitHub 계정을 Claude에 한 번 연결하고, Claude GitHub App은 리포지토리당 한 번 또는 모든 리포지토리를 제공하는 경우 전체 GitHub 조직에 대해 한 번 설치됩니다. Claude GitHub App이 아직 다루지 않는 리포지토리를 추가하거나 SSO를 적용하는 GitHub 조직의 리포지토리를 추가할 때 이 단계로 돌아옵니다.1
GitHub 계정 연결하기
이전에 claude.ai/code를 사용하지 않았다면, 첫 방문 시 GitHub 연결을 안내합니다. GitHub 연결하기를 참조하세요. 그렇지 않으면 GitHub 인증 옵션 중 하나를 사용합니다.
2
프로젝트의 리포지토리에 Claude GitHub App 설치하기
Claude GitHub App을 설치하고 프로젝트가 사용할 리포지토리에 대한 액세스 권한을 부여합니다. GitHub 조직이 소유한 리포지토리에서는 조직 소유자만 설치를 완료할 수 있습니다. 소유자가 아닌 경우 GitHub는 소유자에게 설치 요청을 보내고 소유자가 승인할 때까지 프로젝트는 리포지토리를 사용할 수 없습니다.
3
SSO를 적용하는 조직에 대해 SSO 승인하기
GitHub 조직이 SAML SSO를 적용하는 경우, GitHub를 다시 연결하고 해당 조직에 대해 Claude 앱을 승인합니다. 이를 수행할 때까지 해당 조직의 비공개 리포지토리는 새 프로젝트 대화상자 또는 프로젝트 설정 > 환경에 나타나지 않습니다.
프로젝트에서 작업
프로젝트 대화를 통해 Claude에게 작업을 제공합니다: 한 번에 하나의 작업 또는 여러 개, 그리고 업데이트 및 느슨한 생각이 나타나면서 업데이트합니다. Claude는 각 메시지를 라우팅하고 스레드가 작업을 수행하고 다시 보고합니다.첫 번째 배치
새 프로젝트에 작업 배치를 보내기 전에 첫 번째 스레드가 원하는 방식으로 돌아오도록 설정하세요:- 프로젝트 지침 작성: 대상 분기, 스레드가 자신의 작업을 확인하는 방법, 무엇이 승인이 필요한지와 같은 모든 스레드가 시작하는 간단한 설명입니다.
- 실제 작업의 작은 부분을 하나 보내거나, Claude가 제안한 스레드 중 하나를 시작하고, 완료되면 스레드를 열어 어떻게 보고하는지 그리고 분기에서 무엇을 했는지 확인합니다. 잘못된 것을 가정했거나 필요한 것에 도달할 수 없었다면 스레드가 묻는 대신 추측하거나 정체에서 수정할 위치를 다룹니다.
- Project settings > General에서 Thread model 및 Thread effort를 확인합니다. 새 프로젝트는 모든 스레드를 높은 노력으로 Opus에서 실행하며, 이는 플랜을 가장 빠르게 사용합니다. 모델 선택 및 Claude가 컨텍스트 관리하도록 하기에서 대안을 다룹니다.
- Claude에게 스레드를 시작하기 전에 제안하고 한 번에 몇 개만 실행하도록 요청하고, 몇 개의 스레드가 원하는 방식으로 돌아오면 이러한 제한을 제거합니다.
작업 보내기 및 결과 읽기
Claude는 대화에서 보내는 각 메시지가 어디로 가는지 결정합니다:- 빠른 질문은 보통 대화에서 답변을 받습니다.
- 새 작업은 새 스레드 또는 이미 해당 영역에서 작업 중인 스레드로 이동하고, Claude는 어느 것인지 알려줍니다. 각 새 스레드는 메시지 아래에 카드로 표시됩니다: 스레드의 제목과 상태가 있는 상자로, 클릭하여 스레드를 엽니다.
- 한 메시지의 여러 관련 없는 작업은 별도의 스레드가 됩니다.
스레드의 풀 요청 검토
스레드가 코드를 변경할 때, 다르게 말하지 않으면 이것이 수행하는 것입니다:- Branch: 저장소의 기본 분기에서 시작한 새 분기에서 작동합니다.
- Pull request: 요청할 때 열고, 버그 수정 또는 다른 구체적인 변경을 위해 자체적으로 열 수 있습니다.
- 열린 후: 다른 클라우드 세션에 대해 자동 수정이 켜져 있는지 여부에 관계없이 자동 수정이 켜져 있는 풀 요청을 감시합니다. CI가 실패하면 수정을 푸시하고, 검토 의견을 처리하고, 검사가 통과하고 풀 요청이 검토 준비가 되면 스레드에서 회신합니다.
Overview에서 필요한 것 확인
Overview 창은 프로젝트의 스레드를 추적합니다. 새 프로젝트를 처음 열 때 이미 열려 있습니다. 프로젝트 헤더의 Overview 버튼은 닫고 다시 열며, 스레드가 대기 중일 때 점을 표시합니다. 데스크톱 앱에서는 Claude가 대화에 게시할 때, 스레드가 오류에 도달할 때 또는 스레드가 입력이 필요할 때 데스크톱 알림을 받으므로 프로젝트를 열어 두고 찾을 필요가 없습니다. 스레드가 차례를 완료할 때마다 하나를 받거나 프로젝트에 대해 끄려면 프로젝트의 사이드바 메뉴에서 Notifications를 선택합니다. 이 알림은 데스크톱 전용입니다: 브라우저에서는 Overview 버튼의 점을 확인합니다. 창의 Threads 탭은 상태별로 스레드를 그룹화합니다:
창의 다른 탭은 추가한 파일과 폴더 및 스레드가 생성한 파일을 위한 Library, 스레드가 열었을 때 Pull requests, 이 프로젝트의 루틴을 위한 Routines입니다.
제어가 필요할 때 스레드 열기
대화의 스레드 카드 또는 Overview의 행을 클릭하여 Overview 창에서 스레드의 기록을 엽니다. 거기서 다음을 수행할 수 있습니다:- Claude가 수행한 작업을 단계별로 읽습니다.
- 스레드의 자체 메시지 상자에 작성하여 작업을 조율합니다. 거기의 메시지는 해당 스레드로 직접 이동하는 반면, 프로젝트 대화의 후속 작업은 Claude가 후속 작업을 해당 스레드와 일치시킬 때만 도달합니다.
- 스레드가 대기 중인 권한 프롬프트에 답변합니다.
- Stop으로 스레드를 중단합니다. 이는 스레드가 작동하는 동안 전송 버튼을 대체하거나 Esc를 눌러 중단합니다.
모델 선택 및 Claude가 컨텍스트 관리하도록 하기
Project settings > General에서 모델 및 노력을 설정합니다. 새 프로젝트는 모든 곳에서 Opus를 실행하며, 스레드에 대해 높은 노력, 대화에 대해 낮은 노력을 합니다:- Thread model 및 Thread effort는 스레드에 적용됩니다. 하나의 작업에 다른 모델을 사용하려면 작업에서 요청하세요. 이미 실행 중인 스레드의 경우 해당 스레드의 모델 선택기를 사용합니다.
- Coordinator model 및 Coordinator effort는 프로젝트 대화의 Claude에 적용됩니다.
프로젝트 실행 방식 조정
대화에서 Claude에게 한 번에 실행할 스레드 수, 업데이트를 게시할 때, 풀 요청을 열 때를 알려줍니다. Claude가 원하지 않는 방식으로 조율하고 있으면 말하세요. 예를 들어 다음과 같이 말할 수 있습니다:- “스레드를 제안하고 시작하기 전에 승인을 기다립니다” 또는 “확인을 요청하지 않고 지금 시작합니다”
- “한 번에 최대 2개의 스레드를 실행합니다” 또는 “동일한 영역의 후속 작업에 기존 스레드를 재사용합니다”
- “더 짧은 업데이트를 게시합니다” 또는 “무언가가 완료되거나 차단될 때만 게시합니다”
- “모든 스레드에 상태 업데이트를 제공합니다”
- “이 작업을 더 작은 모델로 수행합니다”
- “풀 요청을 열지 마세요. 계획을 본 후에 열어주세요”
- “이 저장소에서 무엇이 잘못되었는지 알려주세요. 아직 수정하지 마세요”, 스레드가 되기 전에 발견 사항을 검토하려고 할 때
- “대신 여기서 답변하세요”, Claude가 빠른 질문으로 의도한 것에 대해 스레드를 시작할 때
승인 대기 중인 스레드 차단 해제
스레드는 스레드의 모델이 지원할 때 자동 모드에서 실행되므로 대부분의 도구 호출은 요청 없이 실행됩니다. 스레드가 승인이 필요하면 프롬프트는 해당 스레드 내부에 있고 스레드는 거기서 답변할 때까지 기다립니다. 프로젝트 대화에서 Claude에게 진행하도록 말하는 것은 도달하지 않습니다. 각 승인은 해당 프롬프트 또는 더 광범위한 옵션을 선택하면 해당 스레드의 나머지를 다룹니다. 모든 스레드가 특정 명령을 요청 없이 실행하도록 하거나 일부를 차단하려면 저장소의.claude/settings.json에 권한 규칙을 추가합니다. 스레드는 하나의 저장소가 있는 프로젝트에서만 적용합니다. 스레드가 저장소에서 선택하는 것을 참조하세요.
프로젝트에 기본 컨텍스트 제공
프로젝트 메모리, 프로젝트 지침 및 프로젝트의 저장소, 파일 및 환경은 스레드 간에 컨텍스트를 전달합니다. 각각을 한 번 설정하면 모든 새 스레드에 적용됩니다.
Project settings > Memory는 Claude가 프로젝트에서 작업할 때 자신이 작성하기 때문에 이 파일들을 Auto memory 아래에 나열합니다. 이것들은 Claude Code가 머신에서 유지하는 자동 메모리와는 별개이며, 둘 다
MEMORY.md 인덱스를 사용하더라도 말입니다. 프로젝트 메모리는 프로젝트의 저장소의 CLAUDE.md 파일과도 별개입니다. 각 스레드는 시작할 때 복제에서 이 CLAUDE.md 파일을 읽으므로 저장소에 대한 지침을 CLAUDE.md에 넣고 프로젝트에 대한 메모를 프로젝트 메모리에 넣습니다.
프로젝트 지침 작성
프로젝트 지침은 모든 새 스레드가 시작하는 간단한 설명입니다. 프로젝트 헤더의 기어 아이콘을 클릭하여 Project settings를 열고 Memory > Project instructions로 이동합니다. 유용한 간단한 설명은 다음을 다룹니다:- 프로젝트의 목적
- 작업이 발생하는 위치: 어느 저장소, 어느 분기에서 시작할지, 풀 요청의 이름을 지정하는 방법
- 스레드가 완료되었다고 부르기 전에 자신의 작업을 확인하는 방법
- 필요한 것이 누락되었을 때 수행할 작업
- 먼저 승인이 필요한 것
CLAUDE.md에 속하며, 모든 스레드는 저장소가 프로젝트의 일부일 때 시작할 때 읽습니다. 작업이 진행 중일 때 스레드를 수정하면 Claude에게 수정을 기억하도록 말하세요: 프로젝트 메모리로 이동하고 나중 스레드는 이를 시작합니다.
추가할 저장소 결정
프로젝트에 추가하는 저장소는 모든 것을 포함하며, 코드,CLAUDE.md 및 스킬은 모든 스레드에 있습니다. 추가하지 않는 저장소는 여전히 범위 내입니다: 작업이 필요하면 스레드가 자신에게 하나를 추가할 수 있습니다. 대부분의 프로젝트는 둘 다 사용합니다:
- 프로젝트에 추가, New project 대화, Project settings > Environment 또는 대화에서 Claude에게 프로젝트에 추가하도록 요청합니다. 그 이후의 모든 스레드는 작업이 이를 만지는지 여부에 관계없이 복제하고
CLAUDE.md및 스킬로 시작합니다. 하나의 저장소에서 여러 개로 이동하면 각 저장소의.claude/settings.json에서 스레드가 선택하는 것도 변경됩니다. 스레드가 저장소에서 선택하는 것을 참조하세요. - 끄고 필요할 때 스레드가 추가하도록 합니다. 작업이 프로젝트에 없는 저장소가 필요한 스레드는 자신에게 추가할 수 있으며, 스레드의 메모는 이 스레드에만 추가되었음을 나타냅니다. 복제는 작업 중간에 발생하므로 해당 저장소의
CLAUDE.md및 스킬은 스레드가 시작할 때 없었습니다. 다음 스레드는 다시 없이 시작합니다. 스레드가 추가하는 저장소는 프로젝트 저장소와 동일한 필수 조건이 필요합니다: Claude GitHub App이 설치되고 GitHub 계정에서 푸시 액세스합니다.
스레드가 저장소에서 선택하는 것
각 스레드는 프로젝트의 모든 저장소를 복제하고 모두에서CLAUDE.md, 스킬 및 플러그인을 로드합니다. 권한 규칙, 훅 및 env는 스레드가 시작하는 디렉토리의 .claude/settings.json에서만 옵니다: 저장소가 하나일 때 저장소 내부, 여러 개일 때 복제 위에, 저장소의 파일이 읽히지 않는 곳입니다.
여러 저장소가 있는 프로젝트에서 각 복제는 스레드에 추가 디렉토리로 첨부되며
CLAUDE.md 로드가 켜져 있으므로 스레드가 위에서 시작하더라도 모든 저장소의 CLAUDE.md 및 스킬이 시작할 때 로드됩니다. 어느 경우든 활성화된 플러그인이 제공하는 훅은 여전히 실행됩니다. 모든 저장소에서 플러그인이 로드되기 때문입니다. 여러 저장소가 있는 프로젝트에서 프로젝트 지침에 기본 규칙을 넣고 클라우드 환경을 통해 스레드에 환경 변수를 제공합니다.
스레드에 대한 환경 선택
모든 새 스레드는 프로젝트의 클라우드 환경에서 시작합니다. 환경은 스레드가 도달할 수 있는 도메인, 가진 환경 변수, 요청에 추가되는 API 자격 증명, 설정 스크립트가 설치하는 것을 설정합니다. 스레드는 Project settings > Environment에서 하나를 선택할 때까지 기본 Anthropic 호스팅 환경을 사용합니다. 스레드가 내부 API 또는 비공개 패키지 레지스트리에 도달해야 하거나 머신이 일반적으로 보유한 토큰이 필요하면 프로젝트가 아닌 환경을 변경합니다: 네트워크 액세스, API 자격 증명 추가 및 설정 스크립트를 참조하세요.스킬, 플러그인, 커넥터 및 도구를 스레드로 가져오기
스레드는 클라우드 세션이므로 머신에만 설치된 스킬, MCP 서버, 플러그인 및 도구가 없습니다. 이 각각을 스레드에서 사용 가능하게 하려면:- 스킬, 서브에이전트 및 명령: 프로젝트에 추가한 저장소에 커밋합니다. 예를 들어
.claude/skills/<skill-name>/SKILL.md의 스킬입니다. 각 스레드는 프로젝트의 모든 저장소를 복제하고 각각에서.claude/skills/,.claude/agents/및.claude/commands/를 로드하므로 하나의 저장소에 커밋된 스킬은 모든 새 스레드에서 사용 가능합니다. 스레드는 또한 claude.ai 계정에 대해 활성화한 스킬을 로드합니다. - 플러그인: Project settings > Plugins에서 추가합니다. 각 새 스레드에 로드됩니다. 저장소가
.claude/settings.json에서 선언하는 플러그인도 로드됩니다. 설정에서 전달되는 것을 참조하세요. - MCP 서버: 스레드는 claude.ai 계정의 커넥터에서 MCP 도구를 가져옵니다. MCP 서버는 claude.ai/customize/connectors에서 한 번 연결하거나 Project settings > Environment의 Manage connectors 링크를 통해 연결합니다. 모든 스레드는 프로젝트별 설정 없이 모두 사용할 수 있습니다. 프로젝트 대화 자체는 커넥터가 없으므로 커넥터가 필요한 작업을 스레드의 작업으로 보냅니다. 하나의 저장소가 있는 프로젝트에서 스레드는 또한 해당 저장소의
.mcp.json에서 MCP 서버를 로드합니다. 커넥터가 Claude Code에 도달하는 방법은 클라우드 세션 및 커넥터를 끄는 설정의 규칙을 나열합니다. - 명령줄 도구 및 패키지: 환경의 설정 스크립트에 설치합니다.
프로젝트 설정 참조
프로젝트 설정을settings.json이 아닌 claude.ai/code 또는 데스크톱 앱에서 변경합니다. 프로젝트의 사이드바 메뉴의 Settings에서 또는 프로젝트 헤더의 기어 아이콘에서 Project settings를 엽니다.
설정은 변경할 때 저장됩니다. 목표 또는 지침과 같이 편집 중인 텍스트 필드는 떠날 때까지 Save changes 및 Discard를 표시합니다. Project settings의 지침, 저장소, 플러그인 및 환경 변경은 이미 실행 중인 스레드가 아닌 새 스레드에 도달합니다.
프로젝트 일시 중지, 보관 또는 삭제
세 가지 제어 모두 Project settings > General의 하단에 있습니다:- Pause: 모든 것을 한 번에 중지합니다. 모든 실행 중인 스레드 및 대화가 중단되고, 새 스레드가 시작되지 않으며, 루틴이 실행되지 않고, 프로젝트는 다시 시작할 때까지 메시지를 수락하지 않습니다. 동일한 위치 또는 프로젝트의 메시지 상자 위의 배너에서 Resume을 클릭합니다. 일시 중지된 스레드는 그 후 메시지를 보낼 때 계속됩니다.
- Archive: 사이드바에서 프로젝트를 숨기고 스레드를 보관합니다. 이는 실행 중이거나 풀 요청을 감시하는 모든 스레드를 중지합니다. 프로젝트가 보관되는 동안 프로젝트의 루틴은 실행되지 않습니다. 프로젝트를 다시 가져오려면 Projects 페이지에서 열고 Unarchive를 클릭합니다. 스레드는 세션 목록에서 개별적으로 보관 해제할 때까지 보관된 상태로 유지됩니다.
- Delete: 프로젝트, 스레드, 메모리 및 파일을 영구적으로 제거하고 프로젝트의 루틴을 끕니다. 이것은 실행 취소할 수 없습니다. 스레드가 GitHub에 푸시한 분기 및 풀 요청은 영향을 받지 않습니다.
사용량 및 비용
프로젝트 사용량은 다른 Claude Code 세션과 동일한 플랜 한도에 포함되며, 프로젝트는 자체적으로 해당 한도를 초과할 수 없습니다. 플랜 한도에 도달한 스레드는 대기했다가 한도가 초기화되면 자동으로 계속 진행되므로, 실행 중인 작업은 사용자의 메시지 없이 다음 사용 기간에 자동으로 시작됩니다. 스레드가 사용량 한도에 도달함에서는 표시되는 내용, 중지 방법, 그리고 대기하지 않는 한 가지 경우를 다룹니다. 작업이 플랜 한도를 초과하는 경우는 계정에 사용량 크레딧을 활성화한 경우에만 가능합니다. 스레드는 사용자를 위해 이를 활성화할 수 없습니다.플랜을 사용하는 항목
프로젝트는 단일 세션보다 한도를 더 빠르게 사용하며, 특히 Pro 플랜에서는 프로젝트를 실행하는 날에 한도에 더 빨리 도달할 것으로 예상해야 합니다. 다음은 플랜을 사용하는 프로젝트의 부분입니다:- 실행 중인 스레드: 각각은 전체 세션이며, 여러 개가 동시에 실행될 수 있습니다. 고정된 개수는 없으며, Claude는 작업에 필요한 만큼 많은 스레드를 시작하고, 요청한 한도는 상한이 아닌 선호도입니다. 적용되는 한도는 프로젝트 전체에서 하루에 200개의 새로운 스레드입니다.
- 대화: Claude는 스레드가 보고하는 내용을 읽고 다음에 할 일을 결정하기 위해 자체 토큰을 사용합니다.
- pull request를 감시하는 스레드: 유휴 스레드는 CI가 실패하거나 pull request에 검토 의견이 도착하면 깨어나서 플랜을 다시 사용합니다. 이를 중지하려면 스레드에서 pull request 감시를 중지하도록 요청하세요.
프로젝트의 사용량 확인 및 감소
프로젝트 설정에서 사용량을 열어 스레드별 및 모델별 토큰 사용량과 프로젝트 대화에 사용된 양을 확인하세요. 사용량을 줄이려면:- 캐시 수명보다 오래 유휴 상태인 스레드로 라우팅된 후속 작업(Pro 및 Max에서는 플랜 한도 내에서 1시간)은 작업을 수행하기 전에 해당 스레드의 전체 대화를 다시 읽습니다. 새로운 작업의 경우, Claude에게 새로운 스레드를 시작하도록 요청하면 큰 이전 스레드를 복구하는 것보다 적은 토큰을 사용할 수 있습니다.
- 가장 큰 모델이 필요하지 않은 작업의 경우, 스레드, 대화 또는 둘 다에 대해 더 작은 모델 또는 더 낮은 노력 수준을 선택하세요.
- 프로젝트 대화에서 Claude에게 한 번에 더 적은 스레드를 실행하거나, 스레드를 시작하는 대신 작은 질문에 직접 답하도록 요청하세요.
프로젝트가 다른 Claude Code 기능과 어떻게 연결되는지
여러 Claude Code 기능을 통해 한 번에 둘 이상의 세션이 작동할 수 있으므로, 병렬로 작업을 실행하는 것 자체가 프로젝트의 목적은 아닙니다. 프로젝트에서는 Claude가 사용자 대신 세션을 시작하고 추적하며, 각 세션은 동일한 저장소, 지침 및 메모리에서 시작되고, 작업은 지속되는 동안 클라우드에 저장됩니다. 다음은 각 인접 기능이 프로젝트와 어떻게 연결되는지 보여줍니다:- Claude Tag: Claude Tag는 Team 및 Enterprise 플랜의 팀 Slack 채널에 있는 Claude입니다. 채널의 누구나 작업을 할당할 수 있고, 채널의 모든 사람이 이를 보고 조정할 수 있으며, 관리자가 해당 채널을 위해 설정한 연결을 사용합니다. 프로젝트는 사용자만의 것입니다: 사용자만 작업을 할당하거나 스레드를 볼 수 있고, 사용자 자신의 GitHub 액세스 및 커넥터를 사용하며, Pro 및 Max에서 사용 가능합니다. Claude Tag가 Cowork 및 Claude Code와 어떻게 다른지에서 나란히 비교한 내용을 확인할 수 있습니다.
- 클라우드 세션: 모든 스레드는 Claude가 시작하고 추적하는 클라우드 세션입니다. 사용자가 직접 시작한 클라우드 세션은 프로젝트로 계속하기 또는 프로젝트로 이동을 통해 프로젝트가 되거나 프로젝트에 피드될 수 있습니다.
- 루틴: 프로젝트에서 예약된 작업을 요청하면, Claude는 해당 프로젝트의 스레드로 실행되고 루틴 탭에 표시되는 루틴을 생성합니다. 프로젝트 외부에서 생성한 루틴은 계속 독립적으로 작동합니다.
- 로컬 세션 및 에이전트 뷰: 터미널, IDE 또는 데스크톱 앱의 로컬 환경에서 실행되는 세션은 사용자의 머신에서 실행되며 프로젝트의 일부가 될 수 없습니다. 에이전트 뷰는 여러 로컬 세션을 추적하기 위한 화면이며, 조정자가 없습니다.
- Worktrees: worktree는 각 로컬 세션에 저장소의 자체 작업 복사본을 제공하므로 머신의 병렬 세션이 서로 덮어쓰지 않습니다. 스레드는 이를 필요로 하지 않습니다: 각 스레드는 저장소를 자체 클라우드 샌드박스에 복제하고 자체 브랜치에서 작동합니다.
- 에이전트 팀: 에이전트 팀은 머신 또는 클라우드 세션 내에서 단일 작업을 위해 팀원 세션을 시작하고 해당 작업으로 끝나는 하나의 세션입니다.
- claude.ai 채팅 및 Cowork의 프로젝트: 스레드나 조정자 없이 대화 및 참조 파일을 그룹화하는 이전 프로젝트 경험입니다. 이러한 프로젝트는 재설계된 경험이 도달할 때까지 현재대로 계속 작동합니다.
제한 사항
- 프로젝트는 claude.ai/code 및 데스크톱 앱에서 사용 가능하며, 터미널 CLI 또는 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry를 통해서는 사용할 수 없습니다. CLI의
claude project명령은 디렉토리에 대한 로컬 Claude Code 상태를 관리하며 관련이 없습니다. - 프로젝트 스레드는 Anthropic을 모델 제공자로 하는 클라우드 세션입니다. 보안 및 데이터 사용은 클라우드 세션이 어떻게 격리되고 무엇이 유지되는지를 다룹니다.
- 로컬 세션은 프로젝트의 일부가 될 수 없습니다.
- 스레드의 샌드박스는 차례 사이에 일시 중지되고 스레드가 계속될 때 다시 시작됩니다. 샌드박스를 다시 시작할 수 없으면 스레드는 새 복제에서 계속되므로 커밋되지 않은 변경 사항이 손실될 수 있습니다. 긴 작업에서 Claude에게 진행 중인 작업을 커밋하고 푸시하도록 요청합니다.
- 프로젝트는 한 사용자에게 속합니다. 프로젝트 또는 스레드를 다른 사용자와 공유할 수 없으며, 스레드 기록에는 다른 클라우드 세션이 가진 공유 옵션이 없습니다. 베타 중에는 프로젝트에 대한 조직 수준 제어가 없습니다.
- 스레드는 시작한 하나의 프로젝트에 속합니다. 스레드를 다른 프로젝트로 이동하거나 복사할 수 없으며, 독립적으로 이동할 수 없습니다. Move to project는 다른 방향으로만 이동합니다: 클라우드 세션의 작업을 프로젝트로 가져옵니다.
문제 해결
새 프로젝트 대화상자의 GitHub 설정 프롬프트에 대해서는 GitHub 액세스 설정을 참조하십시오.스레드가 멈춘 것처럼 보임
Claude는 스레드가 수행하는 각 단계를 게시하지 않으므로, 프로젝트 대화에서 실행 중이지만 새 메시지가 없는 것으로 표시되는 스레드는 일반적으로 여전히 작동 중입니다. 새 스레드는 Claude가 시작하기 전에 클라우드 환경을 프로비저닝하므로, 첫 번째 업데이트에는 시간이 걸립니다. 스레드를 열어 트랜스크립트를 읽으십시오. 스레드가 권한 프롬프트를 기다리고 있으면 거기서 답변하십시오.스레드가 묻지 않고 추측하거나 정체됨
여러 스레드가 잘못된 것을 가정하거나, 누락된 액세스를 해결하거나, “차단됨”으로 중지된 경우, 원인은 일반적으로 각 작업의 문제가 아니라 프로젝트 설정의 동일한 간격입니다. 무엇을 수정하기 전에 어떤 스레드가 건전한지 정렬하십시오:- 대화에서 Claude에게 묻기: “모든 열린 스레드에 대해, 당신에게 무엇을 하도록 요청했는지, 무엇을 가정했거나 도달할 수 없었는지, 무엇을 기다리고 있는지 나열하십시오.” Claude는 각 스레드를 읽고 대화에서 답변합니다.
- 잘못된 가정에서 시작된 스레드의 경우, 개요에서 스레드를 열고 메뉴에서 해결됨으로 표시하거나, 메시지 상자에서 대신 수행할 작업을 알려주십시오. 해당 분기와 모든 풀 요청은 삭제할 때까지 GitHub에 남아 있습니다.
- 프로젝트 지침 또는 환경에서 간격을 한 번 수정한 후, 나머지 작업을 새 스레드로 다시 보내기 전에 한 스레드를 보내십시오.
Claude가 응답하지 않음
프로젝트 대화는 Claude가 실행 중이지만 해당 응답이 프로젝트에 도달하지 않을 때 “Claude가 응답하지 않음” 배너를 표시합니다. 배너에서 Claude 다시 시작을 클릭하거나, 프로젝트 설정 > 일반으로 이동하여 Claude 다시 시작 행에서 다시 시작을 클릭하십시오. Claude는 대화에 다시 연결됩니다. 작성 중이던 모든 응답은 손실되며, 스레드는 영향을 받지 않습니다.저장소 액세스 오류
세 가지 메시지는 스레드 또는 프로젝트가 해당 저장소 중 하나에 도달할 수 없음을 의미합니다. 프로젝트 스레드는 다른 클라우드 세션이 동일한 저장소를 문제 없이 복제하는 경우에도 GitHub 필수 조건이 필요합니다.- “세션을 시작할 수 없음 — Claude가 이 프로젝트의 저장소에 대한 GitHub 액세스 권한이 없음”, 스레드가 시작되기 전에 보고됨. Claude GitHub 앱이 해당 저장소에 설치되지 않았거나, 일시 중단되었거나, 연결한 GitHub 계정에 연결되지 않았을 때입니다.
- “저장소에 액세스할 수 없음”, 스레드가 복제에 실패할 때 보고됨: GitHub가 복제를 거부했거나, 저장소를 프로젝트가 가진 이름으로 찾을 수 없거나, 스레드가 시작하도록 요청받은 분기가 존재하지 않습니다.
- “Claude가 저장소에 액세스할 수 없음”, 새 프로젝트 대화상자 또는 프로젝트 설정에서 저장소를 저장할 때 표시됩니다. 메시지는 설치 링크와 다시 연결 링크로 계속됩니다. Claude GitHub 앱이 해당 저장소에 없으면 설치 링크를 사용하고, 있으면 다시 연결 링크를 사용하십시오. GitHub 앱은 GitHub에 설치될 수 있지만 Claude에 연결한 계정에 연결되지 않을 수 있기 때문입니다. 메시지에서 GitHub 앱이 일시 중단되었거나 이 저장소를 포함하지 않는다고 하면, 해당 링크를 따라 GitHub에서 수정하십시오.
스레드가 사용 한도에 도달함
스레드 또는 프로젝트 대화가 계획의 5시간 또는 주간 한도에 도달하면, 자동으로 재시도를 계속하고 한도가 재설정될 때 계속됩니다. 기다리는 동안 스레드는 서비스가 바쁨을 표시하며 “Claude가 여전히 재시도 중이며 자동으로 계속됩니다.”라고 표시됩니다. 작업이 계속되려면 아무것도 할 필요가 없습니다. 다음 사용 기간을 사용하지 않으려면 스레드에서 중지를 클릭하거나, 프로젝트를 일시 중지하여 모든 스레드를 보류하십시오. 루틴이 시작한 스레드는 기다리지 않습니다: 해당 차례는 한도 오류로 중지되며, 한도가 재설정된 후 메시지를 보냅니다. 사용 한도 오류는 한도와 재설정 시기를 설명합니다.추가 사용 크레딧이 필요함
스레드 또는 프로젝트 대화가 계획이 사용 크레딧으로만 포함하는 요청(예: 계획이 포함하지 않는 모델 또는 컨텍스트 크기에 대한 요청)을 했으며, 사용 크레딧이 계정에 대해 켜져 있지 않습니다. 구독에 사용 크레딧 추가는 각 계획에서 누가 켜거나 구매할 수 있는지를 다룹니다. 크레딧을 사용할 수 있게 되면 다시 시도하려면 다른 메시지를 보내십시오.기타 메시지
이 메시지들은 자신의 원인을 명시합니다. 표는 각각에 대한 다음 단계를 제공합니다.관련 리소스
- 클라우드에서 Claude Code 사용: 각 스레드 뒤의 클라우드 세션이 어떻게 작동하는지, GitHub 액세스 옵션 및 풀 요청의 자동 수정 포함
- 클라우드 환경 구성: 스레드가 네트워크에서 도달할 수 있는 것을 변경하고, 환경 변수 및 API 자격 증명을 제공하고, 설정 스크립트로 도구를 설치합니다
- 루틴으로 작업 자동화: 일정, 트리거 및 루틴 관리, 프로젝트에서 Claude가 생성하는 것 포함
- 에이전트 보기로 여러 에이전트 관리: 작업이 머신만 도달할 수 있는 도구 또는 서비스가 필요할 때 머신에서 여러 세션을 실행하고 추적합니다
- Projects redesigned: from folder to conversation: 출시 공지, 프로젝트를 Claude와의 대화로 만드는 생각 포함