무엇이 바뀌었나
확인 공식 문서에 적힌 구조를 그대로 옮기면 — 프로젝트는 대화(조정자) 하나 + 스레드 여러 개로 이뤄진다. 대화창에 버그 리포트나 할 일 목록을 붙여 넣으면, 조정자가 그걸 읽고 스레드(클라우드에서 도는 Claude Code 세션 하나)를 새로 열거나 이미 그 영역을 맡고 있는 스레드에 넘긴다. 스레드는 각자 자기 브랜치에서 일하고, 필요하면 풀 리퀘스트를 열고, 끝나면 대화창에 보고한다.
확인 공식 문서 원문의 표현으로는 "Projects are in public beta on Pro and Max plans and rolling out gradually, starting with accounts that have used cloud sessions and don't have existing projects in claude.ai chat or Cowork." 즉 Pro·Max 요금제이고, 클라우드 세션(claude.ai/code)을 써 본 적 있는 계정부터 순서대로 열리고 있다. Team·Enterprise는 아직 안 된다.
| 항목 | 문서에 적힌 것 |
|---|---|
| 발표일 | 2026-09-17 |
| 어디서 쓰나 | claude.ai/code · 데스크톱 앱 Code 탭 · 모바일 앱(iOS·Android) |
| 어디서 안 되나 | 터미널 CLI, Amazon Bedrock · Google Vertex(Agent Platform) · Microsoft Foundry |
| 대상 플랜 | Pro · Max (베타). Team · Enterprise는 아직 |
| 기본 모델 | 스레드 = Opus · high effort. 조정자 = Opus · low effort |
| 하루 한도 | 새 스레드 200개/일 (전체 프로젝트 합산) |
| 안 보이면 | 대기 명단(claude.com/form/projects) 신청 |
확인 스레드는 내 컴퓨터에만 있는 파일이나 도구는 못 건드린다. GitHub(github.com 한정 — GitHub Enterprise Server·GitLab·Bitbucket은 안 됨) 저장소나, 프로젝트에 직접 올린 파일·폴더·구글 드라이브 폴더가 대상이다. 코드가 아닌 일도 된다 — 계약서 폴더나 메모 묶음을 올려 두고 "이 안에서 자주 나오는 문제 열 가지를 찾아 줘" 같은 것도 스레드가 맡아 파일로 만들어 준다.
확인 비용 쪽 원문도 그대로 옮긴다 — "A project draws on the same plan limits as your other Claude Code sessions and uses them faster." 새 프로젝트는 기본이 Opus·high effort라 플랜 한도에 가장 빨리 닿는 조합이다. 반대로 돌아가는 스레드가 없고, 지켜보는 풀 리퀘스트도 없고, 새 메시지도 없으면 프로젝트가 열려 있어도 한도를 쓰지 않는다고도 적혀 있다.
확인
프로젝트는 혼자 쓰는 것이다. 다른 사람과 공유하거나 조직 단위로 관리하는 기능은
베타 기간 동안 없다고 문서에 명시돼 있다. 그리고 예전부터 터미널에 있던
claude project 명령(로컬 디렉터리 상태를 관리하는 것)과는
이름만 같고 관계없는 기능이라는 점도 문서가 따로 짚어 뒀다.
확인 못 함 "gradually" 가 구체적으로 며칠·몇 주 걸리는지는 문서에 숫자로 적혀 있지 않다. 내 계정이 언제 열리는지는 직접 접속해서 확인하는 수밖에 없다.
왜 중요한가
이 과정 STEP 08 에서 만든 "프로젝트"는 지금도 그대로 있다. 문서도 그걸 "earlier Projects experience"라고 부르며 구분해 둔다 — 그쪽은 대화들을 자료와 함께 묶어 두는 서류철이고, 스레드도 조정자도 없다. 이번 글의 Projects는 Claude Code 쪽에 새로 생긴, 이름만 같은 다른 기능이다.
또 하나, STEP 15 에서 배운 Claude Code는 내 컴퓨터 터미널에서 켜는 것이었다. 이번 기능은 정반대로 터미널엔 없고 claude.ai/code 브라우저·앱에서만 된다. 같은 "Claude Code"라는 이름 아래 로컬에서 켜는 것과 클라우드에서 여러 개를 굴리는 것, 두 갈래가 생긴 셈이다.
직접 해 보기 — 10분
- 보이는지부터 확인한다. claude.ai/code 에 접속해 왼쪽 사이드바에 Projects 가 있는지 본다. Pro·Max 계정이고 전에 클라우드 세션(claude.ai/code)을 써 본 적 있을수록 먼저 열릴 가능성이 크다.
- 없으면 대기 명단에 이름을 올린다. claude.com/form/projects. 순서대로 열리는 중이라 억지로 켤 방법은 없다.
-
있으면 저장소 없이 먼저 만들어 본다. New project → 이름만 넣고 생성.
깃허브를 안 걸어도 파일 업로드만으로 스레드가 작동한다. 개인 메모 폴더처럼
가벼운 것으로 시작해 본다.
업로드한 이번 달 영수증·메모를 훑어서 항목별로 얼마 썼는지 표로 정리해 줘. -
모델·effort부터 낮춘다.
Project settings → General에서 Thread model / Thread effort 를 본다. 기본값이 Opus·high다. 가벼운 일이면 모델을 낮추거나 effort를 medium·low로 내려서 한도를 아낀다. - Overview 패널로 진행 상황을 본다. 스레드가 끝났는지, 내 답을 기다리는지가 묶음으로 뜬다. 다 써 봤으면 Project settings → General 맨 아래 Pause 로 꺼 둔다 — 켜 놓은 채 잊으면 다음에 열 때 한도가 그새 깎여 있을 수 있다.
확인 기본값(Opus·high effort)을 그대로 두고 저장소 여러 개를 걸어 두면 Pro 플랜에서는 특히 한도에 평소보다 빨리 닿는다고 문서가 경고한다. 가볍게 눌러 보고 끝낼 생각이면 모델·effort부터 낮추고 시작하는 편이 낫다.
확인 새 프로젝트를 만들면 메시지를 먼저 보내지 않아도 Claude가 저장소를 한 번 훑고 설정을 제안하는 턴을 자동으로 돈다 — 이때도 내 플랜 한도가 쓰인다. 아무 말도 안 했는데 벌써 뭔가 하고 있다고 놀랄 필요는 없다.
한 줄 정리
- Claude Code Projects는 9월 17일 베타다. Pro·Max, claude.ai/code·데스크톱·모바일 전용 — 터미널엔 없다.
- 기본값이 Opus·high effort라 플랜 한도를 빨리 쓴다 — Project settings에서 모델·effort부터 낮춰 본다.
- 예전 "프로젝트"(STEP 08)와 이름만 같고 다른 기능이다 — 서류철과, 일을 나눠 맡기는 조정자.
- Claude Code Docs — Let Claude coordinate ongoing work with Projects (베타 대상 · 구조 · 생성 절차 · 기본 모델·effort · 사용량·한도 · 제한사항)
- Anthropic 공식 블로그 — Projects redesigned: from folder to conversation (출시 발표)
- AI타임스 — 앤트로픽, 장기 개발 관리 에이전트 '클로드 코드 프로젝트' 공개 (국내 보도)