muaco Tech Note

Claude Codetheverge.com

Claude Code Projects 사용법원격 스레드 여러 개 한 번에 돌리기

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

안녕하세요, muaco입니다.

이 글을 읽고 나면 무엇을 할 수 있을까요

이 글을 끝까지 따라 하면 프로젝트를 만들고, 할 일을 한곳에 적어 보내고, Claude가 그 일을 여러 스레드로 쪼개 동시에 돌리게 할 수 있습니다. 스레드는 노트북이 꺼져도 계속 돕니다. 아침에 돌아오면 끝난 스레드와 내 대답을 기다리는 스레드를 한 화면에서 확인하게 됩니다.

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

기준은 2026년 9월 17일에 공개된 공개 베타입니다. 화면과 조건은 바뀔 수 있습니다. 막히면 아래 출처의 공식 문서부터 열어 보세요.

미리 갖춰야 할 준비물

하나라도 어긋나면 아래를 다 읽어도 프로젝트가 만들어지지 않습니다. 그래서 맨 앞에 둡니다.

  • 요금제: Pro 또는 Max입니다. Team과 Enterprise 요금제는 아직 지원하지 않습니다.
  • 차례가 왔는지: 공개 베타는 순서대로 열리는 중입니다. 먼저 열린 쪽은 클라우드 세션(내 컴퓨터가 아니라 Anthropic 서버에서 도는 Claude Code)을 써 본 계정입니다. 그중에서도 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 코딩

같은 분류의 글