Claude Code의 '프로젝트' 기능 사용 후기: 장점, 어려움 및 활용 방법

open

컴퓨터를 재부팅한 후, 코디네이터에게 물어보니 '9개 중 8개가 연결되었다'고 돌아왔습니다. 그런데 그날 밤에 만약을 대비해 '조용한 스레드의 상황을 알려달라'고 부탁했더니, 6개가 멈춰 있었습니다. 컴퓨터가 절전 모드(sleep)에 들어가거나 네트워크가 끊겼을 때도 마찬가지였는데, 병합 순서를 기다리던 4개는 다음 날 아침까지 움직이지 않은 상태였습니다. 멈춘 스레드에서는 오류가 발생하지 않았고, 체크리스트가 '대기 중'인 상태로 변하지만 않았습니다.

게다가 컴퓨터 측에서 허가 확인이 필요해서 멈추는 경우도 적어도 5번 있었습니다. 이 경우에는 스레드 내에서 답변을 하면 다시 움직이기 시작했습니다.

작업이 끝나면, 스레드가 자동으로 '해결됨(解決済み)'으로 넘어가는 경우도 있었지만, 판단할 수 없는 것은 '검토 대기(レビュー待ち)'나 '대응 대기(対応待ち)' 상태로 남아 있는 경우도 있었습니다. 남아있는 항목들은 스레드 오른쪽 상단의 '해결' 버튼을 직접 눌러 '해결됨'으로 옮기고 목록을 정리해야 했습니다.

이 글을 쓰기 위해, 개발용과는 별도의 프로젝트를 만들었습니다. 그런데 기사용 프로젝트의 Claude는 개발용 프로젝트의 대화나 스레드를 읽을 수 없었습니다. 기록은 제가 복사해서 가져가야 했습니다.

코디네이터와의 상호작용은 겉보기에는 하나의 채팅이 계속 이어지고 있는 것처럼 보입니다. 하지만 나중에 기록을 읽어보면, 백그라운드 세션(裏のセッション)은 기간 동안 5번 바뀌어 있었습니다. 대화는 계속 연결되어 보여서, 주고받는 답변에도 어색함이 없었기 때문에 전혀 눈치채지 못했습니다.

여기부터가 순서입니다. 공식 설명은 다음 페이지에 있습니다.

공식의 4분 소개 영상도 이 포스트에서 볼 수 있습니다.

We just let in every Pro and Max user from the Claude Code Projects waitlist!

If you're new to Claude Code Projects, here's a 4 minute walkthrough to get you started: https://t.co/aewDkvvOcq

— ClaudeDevs (@ClaudeDevs) October 9, 2026

| 항목 | 내용 |
|---|---|
| 플랜 | Pro와 Max (Team과 Enterprise는 아직 대상 제외)
| ... | 
베타 기능은 단계적으로 배포되었기 때문에, 아직 받지 못한 사람은 웨이트리스트에 신청해서 기다리는 형태였습니다. 사이드바에 '프로젝트(Projects)'가 보이면 사용할 수 있습니다. 보이지 않으면, 기사 마지막에서 신청 방법을 소개합니다.

| 코디네이터 (대화) | 스레드 |
|---|---|
| 담당하는 것 | 프로젝트 전체 | 하나의 작업 |
| ... | 
프로젝트를 열면, 왼쪽에 대화(conversation), 오른쪽에 스레드 목록이 나열됩니다. 코디네이터는 스레드의 세부적인 절차까지 보지 않고, 보고서를 읽어 전체를 정리하는 것 같습니다.

사이드바의 '프로젝트'를 열면, 프로젝트 목록이 나타납니다.

처음으로 '프로젝트'를 열었을 때는, 이전에 있던 채팅의 프로젝트(claude.ai나 데스크톱 앱으로 만들 수 있는 기존 방식)를 가져올지 묻는 창이 나왔습니다.

- 오른쪽 상단의 '새 프로젝트(新規プロジェクト)'를 누릅니다.
- 다이얼로그에서 '이름'을 입력합니다. '목표'와 '컨텍스트'는 선택 사항이며, 나중에 추가할 수 있습니다.
- '프로젝트 생성(プロジェクトを作成)'을 누르면 대화가 열립니다.

컨텍스트의 '추가'에서는 GitHub 리포지토리, 파일, 폴더, Google Drive 폴더를 선택할 수 있습니다. 저는 여기서 개발 중인 리포지토리를 추가했습니다.

첫 프로젝트에서는, 만든 직후 Claude가 스스로 1턴 움직여서 리포지토리를 읽고 다음 단계를 제안합니다(이 턴도 구독 사용량을 사용합니다). 저는 제안을 기다리지 않고 먼저 메시지를 보냈는데, 그것으로 문제가 없었습니다. 이미 클라우드 세션에서 진행하고 있는 작업이 있다면, 해당 세션 메뉴의 '프로젝트로 계속하기(Continue as project)'를 통해 전환할 수도 있습니다.

| 항목 | 내용 |
|---|---|
| 코디네이터 모델, 추론량 | 코디네이터의 모델과 노력 수준. 초기 설정은 Opus의 '낮음' |
| ... | 
대화 메시지란에 하고 싶은 일을 그대로 쓰기만 하면 충분했습니다. 코디네이터는 짧은 질문이라면 그 자리에서 답하고, 작업이라면 새로운 스레드를 만들거나 비슷한 작업을 하는 스레드로 보냅니다. 만들어진 스레드는 메시지 바로 아래 카드 형태로 나열되며, 누르면 해당 스레드가 열립니다.

오른쪽에 있는 '개요'(Overview)에서는 스레드가 상태별로 나열됩니다.

| 분류 | 포함된 스레드 |
|---|---|
| 리뷰 대기 중 | 풀 리퀘스트가 리뷰 대기 중 |
| ... | 
Landing만은 제 화면에서 한국어 표시를 확인할 수 없었기 때문에, 공식 문서의 영어 이름을 그대로 사용했습니다. 앱을 닫고 다음 날 아침에 다시 열어도 무엇이 끝났고 무엇이 나를 기다리는지는 바로 알 수 있었습니다(다만, 오류 없이 멈춘 스레드는 여기서 구분할 수 없습니다). 브라우저에서는 개요 버튼에 점이 찍히고, 데스크톱 앱에서는 알림도 옵니다.

스레드를 열면 그 안에도 메시지 창이 있습니다. 대화창에 작성한 추가 지시는 코디네이터가 관련된 스레드를 찾았을 때만 도착하지만, 스레드 목록에 적으면 확실하게 해당 스레드로 전달됩니다.

스레드는 기본적으로 클라우드에서 작동하지만, 오직 제 컴퓨터에서만 할 수 있는 작업은 그 스레드만을 이용해 컴퓨터에서 실행할 수 있습니다. 저의 경우에는 e2e 테스트와 로컬의 다른 AI 도구에서의 코드 리뷰가 여기에 해당합니다.

작업 특성상, 로컬에서만 가능한 것은 제가 지시하지 않아도 코디네이터가 스스로 로컬 스레드를 열어주었습니다. 프로젝트 지침에 '로컬에서만 실행할 수 있는 작업은 로컬에서'라고 적혀 있었기 때문인 것 같습니다. 모든 것을 수동으로 지시할 필요는 없었고, 제가 한 것은 폴더 사용 허가에 응하는 것이 전부였습니다. 직접 지정하고 싶은 경우의 방법은 다음과 같습니다.

| 방법 | 보충 설명 |
|---|---|
| 메시지 창의 '+' → '로컬에서 작업'(Work locally) | 대화창이 공식적인 진입점입니다. 제 화면에서는 스레드 목록에도 있었습니다 |
| ... | 
로컬 컴퓨터에서 작동시키려면 Claude Code v2.1.280 이상과 Remote Control 설정이 필요합니다. 컴퓨터가 절전 모드로 들어가면, 해당 스레드도 멈춥니다.

사용된 만큼은 구독 크레딧에서 차감됩니다. 공식 문서에서는 주로 다음 세 가지 경우에 감소한다고 합니다.

| 상황 | 이유 |
|---|---|
| 스레드가 작동할 때 | 하나하나가 완전한 세션이며, 여러 개를 동시에 작동시킬 수 있습니다 |
| ... | 
어떤 스레드가 얼마나 사용되었는지는 '설정'의 '사용량'에서 확인할 수 있었습니다.

2026년 9월에 클라우드 세션이 공식적으로 제공될 때, 조건을 충족하는 Pro와 Max 계약자에게 한 번 사용할 수 있는 크레딧(Pro는 $100, Max는 $250)이 지급되었습니다. 이 크레딧은 프로젝트에서는 단 한 번도 사용되지 않았습니다. 공식 도움말 문서에서도 크레딧 대상에서 'Projects and Routines'가 언급되어 있습니다(채팅 세션은 다른 항목이므로, 여기서의 Projects는 Claude Code의 프로젝트를 가리킨다고 해석했습니다).

프로젝트는 공개 베타로 Pro와 Max 플랜 계정 순서대로 배포되었습니다. 저의 경우에도, 일찍 웨이트리스트에 등록해 두었더니 어느새 사용할 수 있게 되었습니다(10월 2일부터 사용 가능). 10월 9일에는 웨이트리스트에 등록된 Pro와 Max 사용자 전원이 사용할 수 있게 되었습니다.

사이드바에 '프로젝트'가 보이지 않는 분은 공식 신청 페이지에서 웨이트리스트에 등록할 수 있습니다.