muacoTech Note

Claude Codetheverge.com

Claude Code Projects 사용법클라우드 스레드 여러 개 한 번에 돌리기

Claude Code의 새 Projects에서 클라우드 프로젝트를 만들고, 여러 스레드를 동시에 돌리면서 조정자가 일을 나눠 주고 모아 주게 하는 방법을 처음부터 따라 할 수 있어요.

안녕하세요, muaco입니다.

이 글을 읽고 나면 무엇이 되나요

Anthropic이 2026년 9월 17일에 Claude Code의 Projects를 새로 내놨어요. 예전 Projects가 대화와 참고 파일을 담아 두는 폴더였다면, 새 Projects는 일을 나눠 주는 대화 한 칸이에요.

이 글을 끝까지 따라 하면 클라우드 프로젝트를 하나 만들고 할 일을 한군데에 적어 보내고 Claude가 그 일을 스레드 여러 개로 쪼개 동시에 돌리게 할 수 있어요. 스레드는 내 노트북이 꺼져도 계속 돌아요. 아침에 돌아와서 어느 스레드가 끝났고 어느 스레드가 내 대답을 기다리는지 한 화면에서 보게 돼요.

기준은 2026년 9월 17일에 공개된 공개 베타예요. 화면과 조건이 바뀔 수 있으니 막히면 아래 출처의 공식 문서를 먼저 열어 보세요.

미리 갖춰야 할 준비물

여기서 하나라도 어긋나면 아래를 다 읽어도 프로젝트가 안 만들어져요. 그래서 앞에 둡니다.

  • 요금제: Pro 또는 Max예요. Team과 Enterprise 요금제는 아직 안 돼요.
  • 차례가 왔는지: 공개 베타가 순서대로 풀리는 중이에요. 클라우드 세션을 써 본 적이 있고 claude.ai 채팅이나 Cowork에 기존 프로젝트가 없는 계정부터 열렸어요. claude.ai/code 왼쪽 사이드바나 데스크톱 앱 Code 탭에 Projects가 안 보이면 아직 내 차례가 아니에요. 대기자 명단에 이름을 올려 두면 돼요.
  • 쓸 수 있는 곳: 웹(claude.ai/code), 데스크톱 앱 Code 탭, iOS와 Android 모바일 앱이에요. 터미널 CLI에서는 안 돼요. CLI에 있는 claude project 명령은 이름만 비슷하고 아무 상관이 없어요.
  • GitHub: 코드 작업을 맡길 거라면 코드가 github.com에 있어야 해요. GitHub Enterprise Server, GitLab, Bitbucket은 안 돼요. 그리고 연결한 GitHub 계정에 그 저장소 푸시 권한이 있어야 하고 Claude GitHub App이 그 저장소에 설치돼 있어야 해요.

마지막 줄에서 많이들 걸려요. 터미널에서 /web-setup으로 GitHub를 연결해 뒀더라도 프로젝트 스레드에는 그 토큰만으로 부족하고 Claude GitHub App이 따로 있어야 해요. 코드 없이 문서나 자료 조사만 맡길 거라면 저장소 없이도 프로젝트를 만들 수 있어요.

따라 하기: 프로젝트 만들고 스레드 돌리기

준비: GitHub 붙이기

따라 하기
  1. GitHub 계정을 Claude에 연결해요. claude.ai/code에 처음 들어가면 연결 화면이 알아서 떠요. 이 연결은 계정당 한 번만 하면 돼요.
  2. Claude GitHub App을 설치하고 프로젝트가 쓸 저장소를 골라 권한을 줘요. 저장소가 GitHub 조직 소유면 조직 소유자만 설치를 끝낼 수 있어요. 내가 소유자가 아니면 GitHub가 소유자에게 승인 요청을 보내고 승인이 날 때까지 그 저장소는 못 써요.
  3. 조직이 SAML SSO를 강제한다면 GitHub를 다시 연결하면서 그 조직에 대해 Claude 앱을 승인해요. 이걸 안 하면 그 조직의 비공개 저장소가 New project 대화상자 목록에 아예 안 떠요. 목록에 뜨면 준비가 끝난 거예요.

만들기: New project 대화상자 채우기

따라 하기
  1. claude.ai/code 왼쪽 사이드바에서 Projects를 누르고 New project를 눌러요. 브라우저라면 claude.ai/code/projects/browse로 바로 가도 돼요.
  2. 대화상자를 채워요. Name만 필수예요. Goal에는 "결제 API p95 지연을 200ms 아래로 유지"처럼 한 줄 목표를 적어요. 요청 100번 중 빠른 쪽 95번이 0.2초 안에 끝나게 하자는 뜻이에요. Context에서 Add를 눌러 저장소와 파일을 붙여요. 목표를 적으면 조정자가 그쪽을 보고 일을 나눠요. 나중에 채워도 되니 지금 비워 둬도 괜찮아요.
  3. Create project를 눌러요. 프로젝트 대화가 열리고 아래에 입력창이 생기면 성공이에요. 첫 프로젝트라면 내가 말을 걸기 전에 Claude가 먼저 한 번 움직여요. 저장소를 훑어보는 스레드를 하나 띄우거나 Setup recommendations를 올려 줘요. 추천 항목은 전부 켜진 채로 뜨니 필요 없는 건 끄고 Update setup을 눌러요.

돌리기: 지침을 적고 일을 보내기

따라 하기
  1. 일을 보내기 전에 지침부터 적어요. 프로젝트 헤더의 톱니바퀴를 눌러 Project settings > Memory > Project instructions로 가요. 여기 적은 글은 새로 생기는 스레드마다 먼저 읽어요. 최대 16,000자까지 들어가요. 처음이라면 세 줄이면 충분해요. "작업 브랜치는 main에서 갈라 만들어 줘", "끝났다고 말하기 전에 테스트 명령을 돌려 통과를 확인해 줘", "정보를 못 찾으면 지어내지 말고 스레드에 질문을 남겨 줘"처럼요. 저장한 뒤 새 스레드를 하나 띄웠을 때 적어 둔 브랜치 규칙대로 움직이면 지침이 제대로 들어간 신호예요.
  2. Project settings > General에서 Thread model과 Thread effort를 확인해요. 새 프로젝트는 조정자와 스레드 모두 Opus로 돌고, 공들이는 정도는 조정자가 low, 스레드가 high예요. 스레드 쪽이 한도를 가장 빨리 먹어요. 가벼운 일이 많다면 여기서 낮춰 두세요.
  3. 대화창에 할 일을 적어 보내요. 버그 리포트를 붙여 넣어도 되고 할 일 목록을 한꺼번에 줘도 돼요. 서로 상관없는 일 여러 개를 한 메시지에 담으면 각각 따로 스레드가 돼요. 내 메시지 아래에 제목과 상태가 적힌 카드가 뜨면 스레드가 시작된 거예요.
  4. 처음에는 고삐를 짧게 잡아요. 대화에 "스레드를 시작하기 전에 먼저 제안하고 내 승인을 기다려 줘", "한 번에 두 개까지만 돌려 줘"라고 말해 두세요. 몇 개가 원하는 모습으로 돌아오면 그때 풀면 돼요. 참고로 이런 요청은 Claude가 지키려 애쓰는 약속이지 강제 설정이 아니에요.

확인: Overview에서 결과 받기

따라 하기
  1. 대화 옆 Overview 창을 봐요. Threads 탭이 스레드를 여섯 무리로 묶어 줘요. Ready for review는 풀 리퀘스트(고친 코드를 원래 자리에 합쳐 달라고 내는 신청서)가 열려 검토를 기다리는 스레드, Waiting on you는 내 대답이나 승인이 필요하거나 실패한 스레드, Working은 아직 도는 중이에요. 나머지 Landing, Idle, Resolved는 각각 합치는 중, 쉬는 중, 마무리된 스레드예요. 여기에 점이 찍히면 나를 기다리는 스레드가 있다는 뜻이에요.
  2. 코드를 고친 스레드는 기본 브랜치에서 갈라진 새 브랜치 위에서 일하고 필요하면 풀 리퀘스트를 열어요. 열고 나면 auto-fix를 켠 채로 그 풀 리퀘스트를 지켜봐요. CI, 그러니까 코드가 올라올 때마다 자동으로 도는 검사가 깨지면 수정을 밀어 넣고 리뷰 코멘트에 답하고 검사가 다 통과하면 스레드에 알려 줘요.
  3. 스레드 카드에 Fix CI, Address comments, Merge it 같은 버튼이 뜨면 눌러요. 그 버튼은 나를 대신해 스레드에 지시를 보내는 자리예요. 스레드가 알아서 반응하기를 기다리지 않고 내가 먼저 밀어 줄 수 있어요. 스레드 안에서 더 자세히 지시하고 싶으면 카드를 눌러 전체 기록을 열고 그 안 입력창에 쓰면 돼요.

여기서 자주 막혀요

스레드가 승인을 기다리는데 프로젝트 대화에서 아무리 말해도 안 움직여요. 승인 요청은 그 스레드 안에 있어요. 대화창에 "진행해"라고 써도 그 스레드에는 안 닿아요. Overview에서 스레드를 열고 거기 뜬 요청에 직접 답해 주세요. 매번 물어보는 명령이 정해져 있다면 저장소의 .claude/settings.json에 {"permissions": {"allow": ["Bash(npm test:*)"]}}처럼 허용 규칙을 넣어 두면 돼요. 다만 이 규칙은 저장소가 하나뿐인 프로젝트에서만 적용돼요.

저장소 접근 오류가 떠요. "Couldn't start the session"이나 "Unable to access your repository" 같은 문구가 나오면 거의 GitHub 쪽 문제예요. Claude GitHub App이 그 저장소에 없거나, 정지됐거나, 내가 Claude에 연결한 GitHub 계정과 이어져 있지 않은 경우예요. 오류 메시지에 뜨는 Install GitHub App 버튼을 누르고 처리한 다음 Check again을 눌러요. 다른 클라우드 세션이 같은 저장소를 잘 읽더라도 프로젝트 스레드는 따로 조건을 따진다는 점을 기억하세요.

스레드가 멈춘 것처럼 보여요. Claude는 스레드가 밟는 단계를 하나하나 대화에 올리지 않아요. 새 스레드는 클라우드 환경을 준비한 뒤에 일을 시작하니 첫 소식이 늦게 와요. 조급해하지 말고 스레드를 열어 기록을 읽어 보세요.

요금제 한도에 걸려요. 스레드 하나하나가 완전한 세션이라 프로젝트는 단일 세션보다 한도를 훨씬 빨리 써요. 특히 Pro라면 프로젝트를 돌리는 날에 한도가 일찍 닿을 각오를 하세요. 한도에 걸린 스레드는 Service is busy를 띄운 채 기다렸다가 한도가 풀리면 알아서 이어 가요. 다음 사용 구간까지 쓰기 싫으면 스레드에서 Stop을 누르거나 프로젝트를 Pause하세요. 참고로 강제 한도가 하나 있어요. 모든 프로젝트를 합쳐 하루 새 스레드 200개예요.

긴 작업을 맡겼는데 수정한 내용이 사라졌어요. 스레드는 샌드박스, 그러니까 클라우드에 따로 마련된 임시 작업실 안에서 일해요. 이 작업실은 차례 사이에 잠깐 멈췄다가 다시 깨어나요. 다시 깨우지 못하면 스레드가 저장소를 새로 복제해서 이어 가고 커밋하지 않은 변경은 이때 날아가요. 오래 걸리는 일에는 작업 중인 내용을 중간중간 커밋하고 푸시하라고 지침에 적어 두세요.

더 나아가려면 여기부터

스레드를 몇 번 돌려 봤다면 프로젝트 메모리를 써 보세요. 대화나 스레드에서 "이건 기억해 줘"라고 말하면 Claude가 파일로 남기고 새 스레드는 시작할 때 MEMORY.md 색인을 읽어요. 비용이 신경 쓰이면 Project settings > Usage에서 스레드별 토큰 사용량을 확인하세요. 토큰은 Claude가 글을 읽고 쓸 때 세는 낱말 조각이에요. Pro와 Max는 캐시 수명이 한 시간이라 오래 쉰 스레드에 후속 메시지를 보내면 그 대화를 통째로 다시 읽어요. 새 일은 묵은 스레드를 깨우기보다 새 스레드로 시작하는 쪽이 대체로 덜 써요.

이상으로 글 마치겠습니다.

출처

#Claude Code#Projects#다중 에이전트#병렬 실행#클라우드 세션#자동화#GitHub#AI 코딩

같은 분류의 글