Claude가 프로젝트로 진행 중인 작업을 조율하도록 하기

• 한 곳으로 작업 전송: 버그 보고서, 스택 추적 또는 작업 목록을 대화에 붙여넣으면 Claude가 각 작업에 대한 스레드를 시작하거나 이미 해당 영역에서 작업 중인 스레드로 전달하고 빠른 질문에 즉시 답변합니다.
• 컨텍스트를 한 번 설정: 모든 새 스레드는 프로젝트의 지침으로 시작하므로 대상 분기와 같이 한 번 명시한 규칙이 모든 스레드에 도달합니다.
• 떠났다가 완료된 작업으로 돌아오기: 한 시간 후 또는 다음 아침에 돌아오면 개요 창에 어느 스레드가 완료되었는지, 어느 풀 요청이 검토 준비가 되었는지, 어느 스레드가 사용자의 답변을 기다리고 있는지 표시됩니다.

​

프로젝트를 사용할 때

• 많은 저장소에 걸친 하나의 목표: “모든 서비스를 새 lint 구성으로 업그레이드합니다.” Claude는 저장소당 하나의 스레드를 실행할 수 있으며, 각각 자체 풀 요청을 가지고 있고, Overview 창에 어느 것이 검토 준비가 되었는지 표시됩니다.
• 계속 공급하는 영역: 한 서비스에 대한 버그, 스택 추적 및 검토 요청을 대화에 붙여넣으면 도달합니다. 한 수정 후 Claude에게 기억하도록 말한 함정은 다음 수정을 위해 프로젝트 메모리에 있습니다.
• 세션보다 큰 빌드 또는 마이그레이션: “docs/spec.md가 설명하는 것을 빌드합니다” 또는 “앱을 더 이상 사용되지 않는 ORM에서 이동합니다.” 작업은 각각 일부를 수행하는 스레드로 분할되고, Claude에게 초기에 기억하도록 요청한 결정이 나중 스레드에 도달하며, 빌드 중에 발견한 사양 변경 및 버그가 동일한 대화로 이동합니다.
• 코드가 아닌 작업: 계약 폴더 또는 지원 티켓 내보내기를 계속 돌아와서 새로운 질문을 하는 경우, 예를 들어 “이 티켓에서 가장 일반적인 10가지 통합 실수를 찾습니다.” 저장소를 추가하는 대신 문서를 업로드하고, 스레드는 프로젝트의 Library 탭에 각 작성물을 파일로 제공합니다.

​

다른 것이 더 잘 맞을 때

• 세션에 맞는 하나의 작업: “불안정한 로그인 테스트를 수정합니다.” 클라우드 세션을 직접 시작하세요.
• 모든 작업이 머신이 필요한 작업: 로컬 데이터베이스, 디바이스 에뮬레이터, 또는 VPN 뒤의 API입니다. 로컬 세션을 사용하거나, agent view를 사용하여 여러 개를 동시에 실행하세요. 작업에 로컬 파일만 필요하면 대신 프로젝트에 업로드하세요.
• 대화 없이 일정에 따라 반복되는 하나의 작업: “매주 월요일 의존성 보고서를 게시합니다.” 별도로 클라우드 예약 작업을 생성하세요.
• 여러 사람이 Claude에게 작업을 제공하고 Slack 채널에서 함께 조율: Claude Tag를 참조하세요.

​

프로젝트가 어떻게 구성되는지

• 프로젝트 대화: Claude가 조율자 역할을 하는 하나의 장기 실행 세션입니다. 사용자가 보내는 것을 받아서 무엇이 스레드가 될지 결정하고 시작한 모든 스레드를 추적합니다. 스레드가 보고하는 것을 보지만 스레드가 취하는 모든 단계를 보지는 않습니다.
• 스레드: 작업자입니다. 각각은 자신의 컨텍스트 윈도우를 가진 별도의 세션으로, 한 가지 작업을 수행하고 완료되면 대화에 보고합니다. 클라우드 스레드는 자신의 브랜치에서 작업하고 작업이 필요할 때 풀 리퀘스트를 엽니다.
• 모든 클라우드 스레드가 시작할 때 가지는 것:
  • 프로젝트의 저장소와 파일, 그리고 지침과 메모리
  • 프로젝트의 각 저장소에 있는 CLAUDE.md(단, 저장소의 스킬, .claude/settings.json, .mcp.json은 포함되지 않음)
  • claude.ai 계정의 커넥터
  • 네트워크 액세스, 환경 변수, 네트워크 시크릿, 설치된 도구를 설정하는 클라우드 환경
• 개요 창: 모든 스레드를 한 번에 보고 어느 것이 사용자를 필요로 하는지 보는 곳입니다. 다른 탭은 추가한 파일과 스레드가 생성한 파일을 위한 라이브러리, 스레드가 열은 풀 리퀘스트를 위한 풀 리퀘스트, 프로젝트의 예약된 작업을 위한 예약 작업입니다.

​

프로젝트 만들기

• 처음부터 시작: Claude가 실행할 작업 흐름을 알고 있을 때 새 프로젝트 대화상자를 열고 이름을 지정합니다. 처음부터 새 프로젝트 시작하기에서 대화상자를 안내합니다.
• 이미 작업을 진행 중인 클라우드 세션에서 시작하는 경우: 해당 세션의 사이드바 메뉴에서 Continue in project를 선택한 다음 Continue as new project를 선택합니다. Claude가 세션에서 진행하던 작업을 바탕으로 프로젝트 설정을 제안합니다. 기존 클라우드 세션에서 시작하기를 참조하세요.

​

필수 조건 확인하기

• 플랜: Pro, Max 또는 Ultra를 사용 중이며 사이드바에 프로젝트가 직접 또는 더 보기 아래에 표시됩니다. 프로젝트를 선택하고 새 프로젝트 또는 시작하기가 제공되는지 확인하세요.
• GitHub(프로젝트가 코드에서 작업할 경우): 코드가 GitHub Enterprise Server, GitLab 또는 Bitbucket이 아닌 github.com에 있고, 연결된 GitHub 계정이 코드에 대한 푸시 액세스 권한을 가지고 있으며, Claude GitHub App이 설치되어 있습니다. /web-setup으로 GitHub를 연결한 경우, 해당 토큰을 사용하면 다른 클라우드 세션이 리포지토리에 도달할 수 있지만 Claude GitHub App이 필요한 프로젝트의 클라우드 스레드에는 충분하지 않습니다. GitHub 액세스 설정하기에 단계가 나와 있습니다.
• 네트워크, 시크릿 및 도구: 클라우드 스레드의 경우, 이들은 프로젝트의 클라우드 환경에서 제공됩니다. 기본 환경은 이미 일반적인 패키지 레지스트리에 도달하므로, 작업이 다른 도메인, 시크릿 또는 사전 설치되지 않은 도구가 필요한 경우에만 확인하세요. 작업이 MCP 서버가 필요한 경우, claude.ai 커넥터에서 연결된 것으로 표시되는지 확인하세요.

​

처음부터 새 프로젝트 시작하기

​

기존 세션에서 시작하기

• 세션에서 새 프로젝트를 만들려면 새 프로젝트로 계속하기를 선택합니다. 프로젝트가 열리고, Claude는 세션을 읽고 프로젝트 대화에 설정 권장 사항을 게시하여 확인하도록 합니다. 원본 세션은 세션 목록에 남아 있습니다. 턴 중간에 있었다면 계속 실행되므로 둘 다 동시에 작동하지 않으려면 직접 중지하세요.
• 세션의 작업을 기존 프로젝트로 가져오려면 기존 프로젝트 중 하나를 선택합니다. 해당 프로젝트가 열리고, 사용자를 대신하여 보내진 메시지가 Claude에게 세션을 읽고 중단한 부분부터 계속하도록 요청합니다. 원본 세션은 세션 목록에 남아 있으며 변경되지 않습니다.

1. 세션이 아직 연결되지 않았다면 해당 세션에서 /remote-control을 실행합니다. 해당 설정이 켜져 있는 동안 연결되었다면 먼저 연결을 해제한 후 다시 연결합니다.
2. 브라우저의 claude.ai/code 사이드바에서 해당 세션의 행을 찾아 메뉴를 열고, 동일한 하위 메뉴에서 선택합니다.

​

GitHub 액세스 설정하기

​

프로젝트에서 작업하기

​

첫 번째 배치

1. 프로젝트 지침 작성: 모든 스레드가 시작하는 기본 지침입니다. 예를 들어 어느 브랜치를 대상으로 할지, 스레드가 자신의 작업을 어떻게 확인할지, 무엇이 사용자의 승인이 필요한지 등이 포함됩니다.
2. 실제 작업의 작은 부분을 하나 보내거나, Claude가 제안한 스레드 중 하나를 시작하고, 스레드가 완료되면 열어서 어떻게 보고하는지, 자신의 브랜치에서 무엇을 했는지 확인합니다. 잘못된 가정을 했거나 필요한 것에 도달할 수 없었다면, 스레드가 질문하지 않고 추측하거나 멈춤에서 수정할 위치를 확인합니다.
3. 프로젝트 설정 > 일반에서 스레드 모델과 스레드 노력을 확인합니다. 새 프로젝트는 모든 스레드를 Opus에서 높은 노력으로 실행하므로 플랜을 빠르게 소비합니다. 모델을 선택하고 Claude가 컨텍스트를 관리하도록 함에서 대안을 확인합니다.
4. Claude에 스레드를 시작하기 전에 제안하고 한 번에 몇 개씩 실행하도록 요청하고, 몇 개의 스레드가 원하는 방식으로 돌아오면 이러한 제한을 제거합니다.

​

작업을 보내고 결과 읽기

• 빠른 질문은 보통 대화에서 답변을 받습니다.
• 새 작업은 새 스레드로 가거나 이미 해당 영역에서 작업 중인 스레드로 가며, Claude가 어느 것인지 알려줍니다. 각 새 스레드는 메시지 아래에 카드로 표시됩니다. 카드는 스레드의 제목과 상태를 보여주는 상자이며, 클릭하여 스레드를 열 수 있습니다.
• 한 메시지에 여러 관련 없는 작업이 있으면 별도의 스레드가 됩니다.

​

스레드의 풀 요청 검토

• 브랜치: 저장소의 기본 브랜치에서 시작한 새 브랜치에서 작업합니다.
• 풀 요청: 요청할 때 열고, 버그 수정이나 다른 구체적인 변경을 위해 자체적으로 열 수 있습니다.
• 열린 후: 자동 수정을 켜서 풀 요청을 감시합니다. 다른 클라우드 세션에서 자동 수정이 켜져 있는지 여부와 관계없이 켜져 있습니다. CI가 실패하면 수정을 푸시하고, 검토 의견을 처리하며, 검사가 통과하고 풀 요청이 사용자를 위해 준비되면 스레드에서 회신합니다.

• 충돌 해결, CI 수정, 의견 처리, 병합은 해당 지침을 사용자의 메시지로 스레드에 보내므로, 풀 요청에 반응할 때까지 기다리는 대신 스레드에 직접 메시지를 보낼 수 있습니다.
• PR 검토는 GitHub에서 풀 요청을 엽니다.
• PR 생성은 유휴 스레드가 브랜치를 푸시했지만 풀 요청을 열지 않았을 때 나타납니다. 클릭하면 스레드에 풀 요청을 열도록 지시하는 대신 해당 브랜치에서 직접 풀 요청을 생성합니다.

​

개요에서 필요한 것 확인

• 라이브러리: 추가한 파일 및 폴더와 스레드가 생성한 파일
• 풀 리퀘스트: 스레드가 풀 리퀘스트를 연 후에 표시됩니다
• 예약 작업: 이 프로젝트에서 Claude가 설정한 클라우드 예약 작업

​

제어가 필요할 때 스레드 열기

• Claude가 한 일을 단계별로 읽습니다.
• 스레드의 자체 메시지 상자에 작성하여 작업을 조정합니다. 거기의 메시지는 해당 스레드로 직접 가고, 프로젝트 대화의 후속은 Claude가 후속을 해당 스레드와 일치시킬 때만 도달합니다.
• 스레드가 기다리고 있는 권한 프롬프트에 답변합니다.
• 중지로 스레드를 중단합니다. 이는 스레드가 작업 중일 때 전송 버튼을 대체하거나 Esc를 눌러 중단합니다.

​

모델을 선택하고 Claude가 컨텍스트를 관리하도록 함

• 스레드 모델과 스레드 노력은 스레드에 적용됩니다. 한 작업에 다른 모델을 사용하려면 작업에서 요청합니다. 이미 실행 중인 스레드의 경우 해당 스레드의 모델 선택기를 사용합니다.
• 조정자 모델과 조정자 노력은 프로젝트 대화의 Claude에 적용됩니다.

​

Claude가 프로젝트를 실행하는 방식 조정

• “스레드를 제안하고 시작하기 전에 내 승인을 기다려” 또는 “이것들을 지금 시작해, 나한테 확인받지 말고”
• “한 번에 최대 두 개의 스레드를 실행해” 또는 “같은 영역의 후속에는 기존 스레드를 재사용해”
• “더 짧은 업데이트를 게시해” 또는 “뭔가 완료되거나 막힐 때만 게시해”
• “모든 스레드에 대한 상태 업데이트를 줘”
• “이 작업을 더 작은 모델로 해”
• “내가 계획을 본 후까지 풀 요청을 열지 마”
• “이 저장소에서 뭐가 잘못됐는지 말해 줘, 아직 뭐도 고치지 마”, 스레드가 되기 전에 발견 사항을 검토하고 싶을 때
• “대신 여기서 답변해”, Claude가 빠른 질문으로 의도한 것에 대해 스레드를 시작할 때

​

승인을 기다리는 스레드 차단 해제

​

자신의 컴퓨터에서 스레드 실행

• 프로젝트의 클라우드 환경 대신 해당 컴퓨터의 파일, 도구, MCP 서버, Claude Code 설정(훅 및 권한 규칙 포함)으로 작동합니다.
• 프로젝트의 지침으로 시작하지만, 메모리 파일이 로드되지 않습니다.
• 해당 컴퓨터가 깨어 있고 원격 제어가 켜져 있을 때만 실행됩니다.

• 스레드를 다시 시작하려면: 폴더와의 연결 끊김을 참조합니다
• 컴퓨터가 자체적으로 잠자기 상태로 가는 것을 방지하려면: 데스크톱 앱의 설정 > Code 또는 설정 > Claude Code에서 Remote Control을 위해 이 컴퓨터를 깨어 있게 유지를 켭니다

​

프로젝트에 상황 맥락 제공하기

​

프로젝트 지침 작성하기

• 프로젝트의 목적
• 작업이 진행되는 위치: 어느 저장소, 어느 브랜치에서 시작할지, 풀 리퀘스트의 이름을 어떻게 지을지
• 스레드가 작업을 완료하기 전에 자신의 작업을 확인하는 방법
• 필요한 것이 누락되었을 때 할 일
• 먼저 승인이 필요한 것

This project holds p95 latency for the payments API under 200 ms: profiling, query and caching fixes, and the dependency upgrades that come with them, in the payments-api repository.

- Branch from main and open one draft pull request per thread.
- Before you call work done, run `make test` and `make lint` and paste the summary lines in your final message.
- If you can't reach something you need, such as a repository, a secret, an API, or a connector, say exactly what's missing in your first message and stop. Don't substitute, mock, or guess.
- Don't merge, force-push, or change CI configuration without asking me in the thread.

​

추가할 저장소 결정하기

• 프로젝트에 추가합니다, 새 프로젝트 대화에서, 프로젝트 설정 > 환경에서, 또는 대화에서 Claude에게 프로젝트에 추가하도록 요청합니다. 그 이후 모든 클라우드 스레드는 작업이 이를 건드리든 아니든 이를 복제하고 CLAUDE.md를 로드하여 시작합니다.
• 이를 제외하고 스레드가 필요할 때 추가하도록 합니다. 프로젝트에 없는 저장소가 필요한 작업을 가진 클라우드 스레드는 자신에게 저장소를 추가할 수 있으며, 스레드의 메모는 이 스레드에만 추가되었음을 나타냅니다. 복제는 작업 중간에 발생하므로 해당 저장소의 CLAUDE.md는 스레드가 시작할 때 없었습니다. 다음 스레드는 해당 저장소 없이 시작합니다. 이런 방식으로 추가된 저장소는 프로젝트 저장소와 동일한 사전 요구 사항이 필요합니다: 해당 저장소에 설치된 Claude GitHub App과 GitHub 계정의 푸시 액세스.

​

파일과 폴더 추가하기

• 라이브러리 탭: 한 번에 최대 100개 파일과 2GB, 단일 파일은 최대 480MB입니다.
• 새 프로젝트 대화: 30MB를 초과하는 파일은 건너뛰므로, 프로젝트를 만든 후 라이브러리 탭에서 더 큰 파일을 추가합니다.
• 폴더: 두 곳 중 하나에서 폴더를 추가하면, 프로젝트는 첫 100개 파일의 복사본을 최대 200MB까지 받으며, 30MB를 초과하는 파일, 숨겨진 파일, node_modules는 포함되지 않습니다. 프로젝트는 최대 10개의 폴더와 Google Drive 폴더를 함께 보유할 수 있으며, 단일 파일은 해당 제한에 포함되지 않습니다.
• 업로드 후 변경: 업로드는 복사본이므로, 나중에 컴퓨터에서 변경한 내용은 파일을 다시 업로드하고 기존 이름에 대해 바꾸기를 선택할 때까지 프로젝트에 도달하지 않습니다.

​

저장소에서 스레드가 가져오는 것

​

스레드의 환경 선택하기

​

스킬, 플러그인, 커넥터, 도구를 스레드에 가져오기

• 스킬: claude.ai 계정에서 활성화하면 클라우드 스레드가 거기서 활성화한 스킬을 로드합니다. 단, 자체 호스팅 환경의 일부 스레드는 예외입니다. 저장소의 .claude/skills/에 커밋된 스킬은 클라우드 스레드에 로드되지 않습니다.
• 플러그인: 프로젝트 설정 > 플러그인에서 추가합니다; 각 새로운 클라우드 스레드에 로드됩니다. 저장소가 .claude/settings.json에서 선언하는 플러그인은 클라우드 스레드에 로드되지 않습니다.
• MCP 서버: 클라우드 스레드는 claude.ai 계정의 커넥터에서 MCP 도구를 가져옵니다. 커넥터는 claude.ai/customize/connectors에서 한 번 연결하는 MCP 서버입니다. 모든 클라우드 스레드는 프로젝트별 설정 없이 모두 사용할 수 있습니다. 프로젝트 대화 자체는 커넥터가 없으므로 커넥터가 필요한 작업을 클라우드 스레드의 작업으로 보냅니다. 커넥터가 Claude Code에 도달하는 방법은 클라우드 세션의 규칙과 커넥터를 끄는 설정을 나열합니다.
• 명령줄 도구 및 패키지: 환경의 설정 스크립트에 설치합니다.

​

프로젝트 설정 참조

​

프로젝트 일시 중지, 보관 또는 삭제

• Pause: 모든 것을 한 번에 중지합니다. 모든 실행 중인 스레드 및 대화가 중단되고, 새 스레드가 시작되지 않으며, 예약 작업이 실행되지 않고, 프로젝트는 다시 시작할 때까지 메시지를 수락하지 않습니다. 동일한 위치 또는 프로젝트의 메시지 상자 위의 배너에서 Resume을 클릭합니다. 일시 중지된 스레드는 그 후 메시지를 보낼 때 계속됩니다.
• Archive: 사이드바에서 프로젝트를 숨기고 스레드를 보관합니다. 이는 실행 중이거나 풀 리퀘스트를 감시하는 모든 스레드를 중지합니다. 프로젝트가 보관되는 동안 프로젝트의 예약 작업은 실행되지 않습니다. 프로젝트를 다시 가져오려면 Projects 페이지에서 열고 Unarchive를 클릭합니다. 스레드는 세션 목록에서 개별적으로 보관 해제할 때까지 보관된 상태로 유지됩니다.
• Delete: 프로젝트, 스레드, 메모리 및 파일을 영구적으로 제거하고 프로젝트의 예약 작업을 끕니다. 이것은 실행 취소할 수 없습니다. 스레드가 GitHub에 푸시한 브랜치 및 풀 리퀘스트는 영향을 받지 않습니다.

​

사용량 및 비용

​

플랜을 사용하는 항목

• 실행 중인 스레드: 각각은 전체 세션이며, 여러 개가 동시에 실행될 수 있습니다. 고정된 개수는 없으며, Claude는 작업에 필요한 만큼 많은 스레드를 시작하고, 요청한 한도는 상한이 아닌 선호도입니다. 적용되는 한도는 프로젝트 전체에서 하루에 500개의 새로운 스레드입니다.
• 대화: Claude는 스레드가 보고하는 내용을 읽고 다음에 할 일을 결정하기 위해 자체 토큰을 사용합니다.
• pull request를 감시하는 스레드: 유휴 스레드는 CI가 실패하거나 pull request에 검토 의견이 도착하면 깨어나서 플랜을 다시 사용합니다. 이를 중지하려면 스레드에서 pull request 감시를 중지하도록 요청하세요.

​

프로젝트의 사용량 확인 및 감소

• Pro, Max, Ultra에서 플랜 한도 내에 있을 때 캐시 수명은 1시간입니다. 이보다 오래 유휴 상태였던 스레드는 후속 작업이 도달하면 작업을 수행하기 전에 전체 대화를 다시 읽습니다. 새로운 작업의 경우, Claude에게 새로운 스레드를 시작하도록 요청하세요. 큰 이전 스레드를 다시 활성화하는 것보다 적게 사용할 수 있습니다.
• 가장 큰 모델이 필요하지 않은 작업의 경우, 스레드, 대화 또는 둘 다에 대해 더 작은 모델 또는 더 낮은 노력 수준을 선택하세요.
• 프로젝트 대화에서 Claude에게 한 번에 더 적은 스레드를 실행하거나, 스레드를 시작하는 대신 작은 질문에 직접 답하도록 요청하세요.

​

프로젝트가 다른 Claude Code 기능과 어떻게 연결되는지

• Claude Tag: Claude Tag는 Team 및 Enterprise 플랜의 팀 Slack 채널에 있는 Claude입니다. 채널의 누구나 작업을 할당할 수 있고, 채널의 모든 사람이 이를 보고 조정할 수 있으며, 관리자가 해당 채널을 위해 설정한 연결을 사용합니다. 프로젝트는 Pro, Max 및 Ultra에서 사용할 수 있습니다. 프로젝트는 개인 전용입니다: 사용자만 작업을 할당하거나 스레드를 볼 수 있으며, 자신의 GitHub 액세스 및 커넥터를 사용합니다. Claude Tag가 Cowork 및 Claude Code와 어떻게 다른지에서 나란히 비교한 내용을 확인할 수 있습니다.
• 클라우드 세션: 모든 스레드는 Claude에게 머신에서 실행하도록 요청하지 않는 한 클라우드 세션입니다. 어느 쪽이든 사용자 대신 Claude가 세션을 시작하고 추적합니다. 직접 시작한 클라우드 세션의 작업을 프로젝트로 가져올 수도 있습니다: 해당 세션의 사이드바 메뉴에서 프로젝트로 이동을 선택합니다.
• 예약 작업: 프로젝트에서 예약된 작업을 요청하면 Claude는 해당 프로젝트의 스레드로 실행되고 해당 프로젝트의 예약 작업 탭에 표시되는 클라우드 예약 작업을 생성합니다. 프로젝트 외부에서 생성한 예약 작업은 계속 독립적으로 작동합니다.
• 원격 제어: 원격 제어는 claude.ai를 머신에서 실행 중인 Claude Code 세션에 연결합니다. 프로젝트에서 Claude에게 컴퓨터에서 스레드를 실행하도록 요청하면, 프로젝트는 원격 제어를 사용하여 이를 수행합니다.
• 로컬 세션 및 에이전트 뷰: 터미널, IDE 또는 데스크톱 앱의 로컬 환경에서 직접 시작한 세션은 프로젝트 외부에 남아 있지만, 해당 세션의 작업을 프로젝트로 가져올 수 있습니다. 에이전트 뷰는 여러 로컬 세션을 나란히 추적하기 위한 화면이며, 이 경우에도 사용자가 각 세션을 직접 시작하고 작업을 할당합니다.
• Worktrees: worktree는 각 로컬 세션에 저장소의 자체 작업 복사본을 제공합니다. 클라우드 스레드는 이를 필요로 하지 않습니다: 각 스레드는 저장소를 자체 클라우드 샌드박스에 복제하고 자체 브랜치에서 작동합니다.
• 에이전트 팀: 에이전트 팀은 머신 또는 클라우드 세션 내에서 단일 작업을 위해 팀원 세션을 시작하고 해당 작업으로 끝나는 하나의 세션입니다.
• 서브에이전트: 서브에이전트는 하나의 세션 내에서 실행되며, 자체 컨텍스트 윈도우에서 부수적인 작업을 수행하고, 해당 세션에 요약을 반환합니다. 프로젝트의 스레드는 Claude가 시작하고 프로젝트 대화에 보고하는 전체 세션이며, 스레드는 자체 부수 작업을 위해 여전히 서브에이전트를 사용할 수 있습니다.
• claude.ai 채팅 및 Cowork의 프로젝트: 스레드나 조정자 없이 대화 및 참조 파일을 그룹화하는 이전 프로젝트 경험입니다. 이러한 프로젝트는 재설계된 경험이 도달할 때까지 현재대로 계속 작동합니다.

​

제한 사항

• 프로젝트는 claude.ai/code, 데스크톱 앱 및 Claude 모바일 앱에서 사용 가능하며, 터미널 CLI, VS Code 확장 프로그램 또는 JetBrains 플러그인에서는 사용할 수 없으며, Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry를 통해서도 사용할 수 없습니다.
• 프로젝트 스레드는 클라우드 세션이거나, Remote Control을 통한 자신의 머신의 세션이며, 두 경우 모두 Anthropic이 모델 제공자입니다. 보안 및 데이터 사용은 클라우드 세션이 어떻게 격리되고 무엇이 유지되는지를 다루며, 연결 및 보안은 머신의 스레드가 어떻게 연결되고 무엇이 저장되는지를 다룹니다.
• 자신의 머신에서 직접 시작한 세션을 프로젝트에 추가할 수는 없지만, 해당 세션의 작업을 프로젝트로 가져올 수는 있습니다. 프로젝트는 Remote Control을 통해 머신에서 스레드를 실행하는 방식으로 머신에 도달하며, 해당 섹션에서 필요한 사항을 나열합니다.
• 클라우드 스레드의 샌드박스는 차례 사이에 일시 중지되고 스레드가 계속될 때 다시 시작됩니다. 샌드박스를 다시 시작할 수 없으면 스레드는 새 복제에서 계속되므로 커밋되지 않은 변경 사항이 손실될 수 있습니다. 긴 작업에서 Claude에게 진행 중인 작업을 커밋하고 푸시하도록 요청합니다.
• 프로젝트는 한 사용자에게 속합니다. 프로젝트 또는 스레드를 다른 사용자와 공유할 수 없으며, 스레드 기록에는 다른 클라우드 세션이 가진 공유 옵션이 없습니다. 베타 중에는 프로젝트에 대한 조직 수준 제어가 없습니다.
• 스레드는 해당 스레드를 시작한 하나의 프로젝트에 속합니다. 스레드를 다른 프로젝트로 이동하거나 복사할 수 없으며, 프로젝트 밖으로 옮겨 독립적으로 두는 것도 불가능합니다. 프로젝트에서 계속하기는 반대 방향으로만 작동하며, 클라우드 세션의 작업을 프로젝트로 가져옵니다. 두 프로젝트를 하나로 병합할 수는 없습니다.

​

문제 해결

​

스레드가 멈춘 것처럼 보이는 경우

​

스레드가 질문하는 대신 추측하거나 멈춘 경우

1. 대화에서 Claude에게 다음과 같이 요청합니다. “열려 있는 모든 스레드에 대해, 각 스레드에 무엇을 하라고 요청했는지, 스레드가 무엇을 가정했거나 무엇에 접근하지 못했는지, 그리고 무엇을 기다리고 있는지 나열해 줘.” Claude는 각 스레드를 읽고 대화에서 답변합니다.
2. 잘못된 가정에서 시작한 스레드는 Overview에서 해당 스레드를 열고 메뉴에서 해결됨으로 표시하거나, 메시지 상자에서 대신 무엇을 해야 하는지 알려 줍니다. 해당 스레드의 브랜치와 풀 리퀘스트는 삭제하기 전까지 GitHub에 남아 있습니다.
3. 프로젝트 지침 또는 환경에서 공백을 한 번에 수정한 다음, 나머지 작업을 새 스레드로 다시 보내기 전에 스레드 하나를 먼저 보내 봅니다.

​

Claude hasn’t responded

​

저장소 액세스 오류

• “Couldn’t start the session — Claude doesn’t have GitHub access to this project’s repository”: 스레드가 시작되기 전에 보고되며, Claude GitHub App이 해당 저장소에 설치되어 있지 않거나, 일시 중지되었거나, 연결한 GitHub 계정과 연동되어 있지 않을 때 발생합니다.
• “Unable to access your repository”: 스레드의 클론이 실패할 때 스레드가 보고합니다. GitHub가 클론을 거부했거나, 프로젝트에 지정된 이름으로 저장소를 찾을 수 없거나, 스레드가 시작하도록 요청받은 브랜치가 존재하지 않는 경우입니다.
• “Claude can’t access” 저장소: New project 대화 상자 또는 Project settings에서 저장소를 저장할 때 표시됩니다. 메시지 뒤에는 설치 링크와 재연결 링크가 이어집니다. Claude GitHub App이 해당 저장소에 없으면 설치 링크를 사용하고, 있다면 재연결 링크를 사용합니다. GitHub App은 Claude에 연결한 계정과 연동되지 않은 상태로 GitHub에 설치될 수 있기 때문입니다. 메시지에 GitHub App이 일시 중지되었거나 이 저장소를 포함하지 않는다고 표시되면, 링크를 따라 GitHub로 이동하여 수정합니다.

​

스레드가 사용 한도에 도달한 경우

​

Additional usage credits are required

​

Lost contact with your folder

• 데스크톱 앱: 앱을 다시 열고 Settings > Code 또는 Settings > Claude Code에서 Use this computer from your phone and claude.ai가 여전히 켜져 있는지 확인합니다
• 터미널: 같은 폴더에서 claude remote-control을 다시 실행합니다

​

기타 메시지

​

관련 리소스

• 클라우드에서 Claude Code 사용: 각 클라우드 스레드 뒤의 클라우드 세션이 어떻게 작동하는지, GitHub 액세스 옵션 및 풀 요청의 자동 수정 포함
• 클라우드 환경 구성: 클라우드 스레드가 네트워크에서 도달할 수 있는 것을 변경하고, 환경 변수 및 네트워크 시크릿을 제공하고, 설정 스크립트로 도구를 설치합니다
• 예약 작업으로 작업 자동화: 예약 작업의 일정, 트리거 및 관리, 프로젝트에서 Claude가 생성하는 예약 작업 포함
• 에이전트 보기로 여러 에이전트 관리: 작업이 머신만 도달할 수 있는 도구 또는 서비스가 필요할 때 머신에서 여러 세션을 실행하고 추적합니다
• Projects redesigned: from folder to conversation: 출시 공지, 프로젝트를 Claude와의 대화로 만드는 생각 포함