클로드 프로젝트(Claude Projects)
클로드 프로젝트는 한 가지 목표를 위한 작업 공간이에요. 지침·지식 파일·대화가 함께 있어서, 어느 대화든 내가 이미 준 자료에서 시작해요.
한 목표에 한 작업 공간
프로젝트는 저마다 대화 기록과 지식 창고를 가진, 그 안에서 완결되는 작업 공간이에요.
프로젝트는 무료(Free)를 포함한 모든 요금제에서 쓸 수 있어요. 무료 계정은 프로젝트를 5개까지 만들 수 있어요.
claude.ai 에서 내 프로젝트 열기 (새 창)프로젝트 안에 든 것
프로젝트
한 목표를 위한 작업 공간 하나
-
지침
이 프로젝트에서 가 어떻게 답할지 — 역할·말투·지킬 규칙이에요. 프로젝트의 모든 대화에 적용돼요.
-
지식 파일
올려 둔 문서·글·코드예요. Claude 는 프로젝트의 모든 대화에서 이것을 으로 써요.
-
대화
프로젝트 안에서 시작한 대화예요. 대화마다 지침과 지식을 가지고 시작해요.
지침과 지식은 모든 대화에 닿아요. 하지만 한 대화에서 한 말은 다음 대화로 이어지지 않아요 — 지식에 넣어 두면 이어져요.
첫 프로젝트 만들기 — 한 과목 공부 프로젝트
예: 생물 과목 프로젝트. 강의 계획서와 내 노트가 지식이 되고, Claude 는 내 수업을 아는 과외 선생님이 돼요.
-
1프로젝트 만들기
claude.ai 에서 Projects 를 열고 단추를 눌러요. 이름은 "생물 — 2학기"처럼 지어요. 이름과 설명은 Claude 가 볼 수 없고 나만 봐요.
화면의 단추: + New Project
Projects 열기 (새 창) -
2강의 계획서를 지식으로 넣기
프로젝트 화면 오른쪽 지식 칸의 + 를 눌러 강의 계획서·수업 노트·읽을거리 목록을 올려요.
화면의 단추: +
-
3지침 쓰기
이 프로젝트에서 Claude 가 어떻게 도울지 적고 Save instructions 를 눌러요. 이 예를 복사해도 돼요:
화면의 단추: Set project instructions
너는 내 생물 과외 선생님이야. 쉬운 말로 설명하고, 강의 계획서의 예를 쓰고, 답마다 끝에 짧은 퀴즈 하나를 내 줘.
-
4프로젝트 안에서 대화 시작
프로젝트를 열고 대화를 시작해요. Claude 는 이미 강의 계획서와 내 규칙을 알아요. 이렇게 해 봐요:
강의 계획서 3장으로 짧은 퀴즈를 내고, 내 답을 채점해 줘.
지식이 커지면
- 지식이 작을 때: 안에서 모두 읽어요
- 지식이 한도에 가까워져요
- 유료 요금제: 가 저절로 켜져 필요한 부분만 찾아요
처음에 Claude 는 프로젝트 지식 전체를 컨텍스트 창 안에서 한 번에 읽어요. 유료 요금제(Pro, Max, Team, Enterprise)에서는 지식이 그 한도에 가까워지면 Claude 가 스스로 RAG 방식으로 바꿔요. 프로젝트 지식 검색 도구로 필요한 부분만 꺼내 쓰는 거예요. 따로 설정할 것은 없어요.
팀과 나누기 — Team·Enterprise
Team·Enterprise 요금제에서는 프로젝트를 조직 사람들과 나눌 수 있어요. 사람마다 두 중 하나를 줘요.
-
Can view
내용·지식·지침을 보고 프로젝트 안에서 대화할 수 있지만, 고칠 수는 없어요.
-
Can edit
지침과 지식을 고치고, 멤버를 관리하고, 다른 멤버를 뺄 수 있어요.
-
Share project
-
이름이나 이메일 넣기
-
권한 고르기
-
Share
프로젝트는 비공개(초대한 멤버만)나 조직 전체 공개로 둘 수 있어요. 공개 프로젝트라도 내 대화는 내가 나누지 않으면 나만 봐요.
새 Projects: 대화 하나, 클라우드 스레드 여럿
에서 새 의 프로젝트가 차례로 열리기 시작했어요. 여기서 프로젝트는 계속 이어지는 대화 하나이고, Claude 가 일을 에서 도는 스레드로 나눠요. Anthropic 이 2026-09-17 에 발표했어요.
프로젝트가 폴더에서 대화로 바뀌었어요
-
예전
프로젝트 = 폴더
자료와 대화를 모아 두는 곳이었어요. 대화는 내가 하나씩 직접 열었어요.
-
지금
프로젝트 = Claude 와 계속 이어지는 대화 하나
일이 생기는 대로 부탁하면, Claude 가 일마다 스레드에서 처리하고 진행하는 대로 알려 줘요.
- 나: 오늘 결제가 느린 것 같아요. 살펴봐 줄래요?
- Claude: 원인을 찾았어요. 오늘 아침 배포 때문에 느려졌어요.
- 나: 좋아요. 고치고, 다시 생기지 않게 테스트도 더해 줘요.
- 답글 4개
- Claude: 맡았어요. 고칠 스레드를 열었어요.
- 결제 고치기PR 여는 중
스레드는 혼자 일하고, 끝나면 이 대화에 결과를 알려 줘요. 카드를 열면 자세한 내용을 볼 수 있어요.
-
나
할 일· 보고·목록을 붙여 넣어요
-
프로젝트 대화
Claude 가 조율하며 할 일마다 스레드를 시작해요
동시에 도는 스레드(예시 할 일)
- 로그인 화면의 버그 고치기
- 결제 코드에 테스트 더하기
- 고객 문의 폴더 요약하기
-
대화 하나, 스레드 여럿: 대화는 일이 필요할 때만 스레드로 갈라져요.
-
맥락은 한 번만: 새 스레드는 모두 프로젝트의 지침···파일과 앞서 있었던 일을 가지고 시작해요.
-
스레드는 보통 클라우드 세션이에요 — 가 아니라 클라우드에서 도는 Claude Code 예요. 노트북을 닫아도 클라우드 스레드는 계속 일하고, 휴대폰으로 살펴볼 수 있어요.
-
내 컴퓨터에만 있는 것이 필요한 일이면, 그 스레드를 클라우드 대신 내 컴퓨터의 폴더에서 돌려 달라고 할 수 있어요. 이때는 Remote Control 이 필요하고, 컴퓨터가 깨어 있을 때만 돌아요.
-
를 고치는 스레드는 자기 에서 일하고 를 열 수 있어요.
Overview 칸은 스레드를 상태별로 나눠 보여 줘요. 예:
- Working
- Waiting on you
- Ready for review
- Resolved
누가 쓰나요: Pro·Max·Ultra 요금제의 공개 베타이고 차례로 열리고 있어요. Team·Enterprise 에는 아직 없어요. claude.ai/code 의 사이드바(More 아래도)에 Projects 가 없으면 대기자 명단에 이름을 올릴 수 있어요.
요금제 사용량에서 빠지고, 스레드를 여럿 동시에 돌리면 더 빨리 써요. Project settings 에서 Thread model 과 Thread effort 를 확인하고, 스레드 몇 개로 시작해요.
기존 Pro·Max 프로젝트 일부는 새 버전으로 옮겨지고 있어요. 지워지는 것은 없어요.
| 기존 프로젝트 | 새 Projects(베타) | |
|---|---|---|
| 어디서 | Claude 채팅(claude.ai) | Claude Code(claude.ai/code·데스크톱 앱·모바일 앱) |
| 누가 일하나 | 내가 Claude 와 한 번에 대화 하나씩 | Claude 가 스레드를 시작해 동시에 돌려요 |
| 대화·스레드가 가지고 시작하는 것 | 지침과 지식 파일 | 지침·메모리·저장소·파일 |
| 요금제 | 모든 요금제(무료는 5개까지) | Pro·Max·Ultra(공개 베타, 차례로 열림) |
새 Projects 쓰는 법 — 맡기고, 말로 조율하고, 돌아와 확인하기
새 Projects 는 비서실장에게 일을 맡기듯 쓰는 기능이에요. 지침을 먼저 쓰고, 말로 일하는 방식을 정하고, 자리를 비웠다가 돌아와 결과를 확인해요. 아래는 공식 문서에 나온 쓰는 법을 순서대로 정리한 것이에요.
claude.ai/code·데스크톱 앱·Claude 모바일 앱에서 써요. · 확장· 플러그인에서는 쓸 수 없어요.
1. 프로젝트를 만들까, 다른 것을 쓸까
판단 기준 하나: 목표가 세션 하나보다 오래 가고, 할 일이 계속 생기나요? 그렇다면 프로젝트예요.
프로젝트가 잘 맞는 일
-
여러 저장소에 걸친 목표 하나
예: "모든 서비스를 새 설정에 맞춰 줘." 저장소마다 스레드와 PR 이 하나씩 생기고, Overview 에서 리뷰할 것만 골라 봐요.
-
계속 일을 던지는 영역
한 서비스의 버그·오류 기록·리뷰 요청을 생길 때마다 대화에 붙여 넣어요. 한 번 고친 뒤 "기억해"라고 하면 다음 스레드가 그것을 알고 시작해요.
-
세션 하나보다 큰 개발·이전
예: "docs/spec.md 에 적힌 대로 만들어 줘." 일이 여러 스레드로 나뉘고, 초반에 기억하라고 한 결정을 뒤의 스레드가 따라요.
-
코드가 아닌 일
계약서 폴더나 고객 문의 내보내기 파일처럼 계속 새 질문을 하는 자료예요. 저장소 대신 파일을 올리면, 스레드가 쓴 결과는 Library 탭에 파일로 쌓여요.
| 상황 | 대신 쓸 것 |
|---|---|
| 세션 하나로 끝나는 일 — 예: "불안정한 로그인 테스트를 고쳐 줘." | 클라우드 세션을 직접 시작 |
| 모든 일에 내 컴퓨터가 필요함 — 로컬 ·기기 ·VPN 뒤의 | 로컬 세션(여럿을 함께 돌리려면 view) |
| 대화 없이 일정대로 반복만 — 예: "매주 월요일에 의존성 보고서를 올려 줘." | 클라우드 예약 작업 하나 |
| 여러 사람이 Slack 채널에서 함께 일을 맡기고 이끔 | Claude Tag |
2. 일을 많이 보내기 전에 — 첫 묶음 네 걸음
-
1 프로젝트 지침 쓰기
프로젝트 위의 톱니바퀴 → Project settings > Memory > Project instructions 에 써요(최대 16,000자). 모든 새 스레드와 프로젝트 대화가 이 글에서 시작해요.
-
2 작은 일 하나로 시험
진짜 일 가운데 작은 것 하나만 보내요. 끝나면 스레드를 열어 어떻게 보고했는지, 브랜치에서 무엇을 했는지 봐요.
-
3 모델·effort 확인
Project settings > General 의 Thread 과 Thread effort 를 확인해요. 새 프로젝트는 모든 스레드를 Opus·high effort 로 돌려서 사용량을 가장 빨리 써요.
-
4 제안만 · 몇 개씩
처음에는 "스레드를 제안만 하고 내가 승인하면 시작해", "한 번에 몇 개씩만"이라고 말해요. 스레드가 기대대로 돌아오면 이 제한을 풀어요.
좋은 지침에 들어갈 다섯 가지
- 프로젝트의 목적
- 일할 곳 — 저장소, 시작할 브랜치, PR 이름 규칙
- 스레드가 끝났다고 하기 전에 스스로 확인하는 방법
- 필요한 것이 없을 때 할 일
- 내 승인이 먼저 필요한 일
지침 예 — 공식 문서의 예를 옮겼어요. 복사해서 내 프로젝트에 맞게 고쳐 쓰세요.
이 프로젝트는 payments API 의 p95 지연을 200ms 아래로 유지하는 일을 해. 저장소는 payments-api 야. - main 에서 브랜치를 따고, 스레드마다 draft PR 을 하나씩 열어. - 끝났다고 하기 전에 make test 와 make lint 를 돌리고, 요약 줄을 마지막 메시지에 붙여. - 저장소·비밀 값·API·커넥터처럼 필요한 것에 닿을 수 없으면 첫 메시지에 무엇이 없는지 정확히 쓰고 멈춰. 다른 것으로 바꾸거나, 가짜로 때우거나, 짐작하지 마. - 머지·force-push·CI 설정 변경은 스레드 안에서 먼저 나에게 물어.
저장소 하나에만 맞는 규칙( 명령 등)은 그 저장소의 CLAUDE.md 에 둬요. 클라우드 스레드는 그 파일을 읽어요. 일하는 중에 스레드를 바로잡았다면 "기억해"라고도 말해요 — 프로젝트 메모리에 들어가 다음 스레드가 그것을 가지고 시작해요.
3. 말로 일하는 방식을 정해요
짧은 질문에는 대화에서 바로 답하고, 새 일은 새 스레드나 그 영역을 맡은 스레드로 보내며 어디로 보냈는지 알려 줘요. 서로 상관없는 일 여러 개를 한 메시지에 쓰면 저마다 스레드가 돼요. 일하는 방식은 대화에 이렇게 말해서 바꿔요.
| 원하는 것 | 이렇게 말하기 |
|---|---|
| 시작 전에 확인받기 | "스레드를 제안만 하고, 내가 승인하면 시작해." |
| 바로 시작하기 | "확인 없이 지금 시작해." |
| 동시에 도는 수 줄이기 | "한 번에 스레드 두 개까지만 돌려." |
| 같은 영역은 이어서 | "같은 영역의 후속 작업은 기존 스레드를 다시 써." |
| 알림 줄이기 | "끝났거나 막혔을 때만 알려 줘." · "업데이트는 짧게." |
| 전체 현황 보기 | "모든 스레드의 상태를 알려 줘." |
| 사용량 아끼기 | "이 일은 더 작은 모델로 해." |
| PR 은 신중하게 | "계획을 내가 보기 전에는 PR 을 열지 마." |
| 진단만 받기 | "이 저장소들에 무엇이 문제인지만 말하고, 아직 고치지 마." |
| 스레드 없이 답 받기 | "스레드를 만들지 말고 여기서 답해 줘." |
Claude 는 이런 부탁을 프로젝트 메모리에 저장해 따르지만, 강제되는 설정은 아니에요. "두 개까지만"도 꼭 지켜지는 한도가 아니에요. 정확한 말로 처음부터 모든 스레드에 적용하려면 프로젝트 지침에 적어요.
4. 맡겨 두고 자리를 비울 때
클라우드 스레드는 노트북을 닫아도 계속 일하고, 휴대폰으로 살펴보고 방향을 바꿀 수 있어요. 내 컴퓨터에서 도는 스레드는 그 컴퓨터가 깨어 있을 때만 일해요. 떠나기 전에 네 가지를 챙겨요.
-
"확인 없이 진행해"라고 말해 두기
승인이 필요한 스레드는 멈춰 기다려요. 승인 요청은 그 스레드 안에 있어서, 프로젝트 대화에서 "진행해"라고 해도 닿지 않아요 — 스레드를 열어 그 안에서 답해요.
-
"중간중간 커밋하고 푸시해"라고 말해 두기
클라우드 스레드의 작업 공간을 다시 열 수 없으면 저장소를 새로 받아 이어 가요. 그때 하지 않은 변경은 잃을 수 있어요.
-
내 컴퓨터가 필요한 일은 빼 두기
내 컴퓨터의 스레드는 컴퓨터가 잠들면 멈춰요. 밤새 맡길 일은 클라우드 스레드로 보내요.
-
한도에 걸려도 이어 가요
요금제 사용량 한도에 걸리면 멈췄다가 한도가 다시 차면 스스로 이어 가요(Project settings > General 의 Auto-continue when usage limits reset, 기본으로 켜짐).
돌아오면 Overview 에서 이 순서로 봐요
-
Waiting on you 나를 기다리는 스레드
-
Ready for review 리뷰할 PR
-
Library 스레드가 만든 파일
알아 둘 한도와 알림
-
새 스레드는 모든 프로젝트를 합쳐 하루 500개까지예요.
-
활동 없이 7일이 지난 스레드는 저절로 Resolved 가 돼요.
-
데스크톱 앱은 Claude 가 대화에 글을 올리거나, 스레드에 오류가 나거나, 내 입력이 필요할 때 알림을 보내요. 에서는 Overview 단추의 점을 봐요.
5. 내 컴퓨터가 필요한 일 — Work locally
로컬 데이터베이스, 기기 에뮬레이터, VPN 뒤의 API 처럼 내 컴퓨터에만 있는 것이 필요한 일만 그 스레드를 내 컴퓨터에서 돌려요. 다른 스레드는 계속 클라우드에서 일해요.
-
Claude Code v2.1.280 이상
-
폴더 연결하기
-
+ 메뉴 → Work locally
-
카드에서 Allow once
데스크톱 앱으로 연결: Settings > Code 에서 Use this computer from your phone and claude.ai 를 켜고 그 아래 목록에 폴더를 더해요. 앱이 열려 있는 동안 스레드가 돌아요.
터미널로 연결: 그 폴더에서 이 명령을 실행해 둬요. 저장소면 --spawn 를 붙여 스레드마다 자기 worktree 를 쓰게 해요.
claude remote-control --spawn worktree
내 컴퓨터의 스레드는 그 컴퓨터의 파일·도구··hooks·권한 규칙을 써요. 프로젝트 지침은 받지만 메모리 파일은 읽지 않아요.
6. 사용량 아끼기 — 모델과 effort
프로젝트는 다른 Claude Code 세션과 같은 요금제 한도를 쓰고, 세션 하나보다 더 빨리 써요(Pro 는 특히). 도는 스레드, 보고를 읽고 다음 일을 정하는 프로젝트 대화, PR 을 지켜보는 스레드가 사용량을 써요. 쉬는 프로젝트와 보관한 프로젝트는 쓰지 않아요.
-
모델·effort 낮추기
Project settings > General 에서 스레드는 Thread model·Thread effort, 프로젝트 대화는 Coordinator model·Coordinator effort 로 바꿔요. 바꾸면 바로 저장되고 새 스레드부터 적용돼요. 한 일만 다르게 하려면 그 일을 부탁할 때 말해요.
-
새 일은 새 스레드로
는 1시간 동안만 남아요. 그보다 오래 쉰 큰 스레드에 후속 일을 보내면 대화 전체를 다시 읽어요.
-
동시 스레드 줄이기
한 번에 도는 스레드를 줄이고, 작은 질문은 스레드를 만들지 말고 대화에서 답하게 해요.
-
PR 지켜보기 끄기
PR 을 지켜보는 스레드는 가 실패하거나 리뷰 댓글이 오면 깨어나 사용량을 써요. 그 스레드에 "PR 지켜보기를 멈춰"라고 해요.
-
Usage 화면 보기
Project settings > Usage 에서 스레드별·모델별 사용량과 프로젝트 대화가 쓴 몫을 따로 봐요.
7. 막혔을 때
| 증상 | 할 일 |
|---|---|
| 스레드가 승인을 기다려요 | 그 스레드를 열어 안에서 답해요. |
| 여러 스레드가 잘못 짐작했거나 멈췄어요 | 대화에 "열린 스레드마다 무엇을 맡겼고, 무엇을 가정했거나 닿지 못했고, 무엇을 기다리는지 정리해 줘"라고 묻고, 잘못 시작한 스레드는 Resolved 로 닫고, 지침이나 환경의 빈틈을 한 번 고친 뒤 스레드 하나로 먼저 시험해요. |
| 사용량 한도에 걸렸어요 | 기본값이면 한도가 다시 찰 때 저절로 이어 가요. 원하지 않으면 Auto-continue when usage limits reset 을 꺼요. |
| 결과를 못 찾겠어요 | 대화의 스레드 카드를 열거나 Overview 의 Library 탭을 봐요. |
더 깊이 공부하려면: 이 절은 공부 자료 모음 claude-projects-study 를 바탕으로 공식 문서와 맞춰 정리했어요.
GitHub 에서 공부 자료 보기 (새 창)요령과 조심할 것
-
비밀은 올리지 않기
비밀번호··개인 키는 넣지 마세요. 지식은 모든 대화에서 읽히고, Team 에서는 함께 나눈 사람도 봐요.
-
이름은 지침이 아니에요
Claude 는 프로젝트 이름과 설명을 볼 수 없어요. Claude 가 꼭 알아야 할 것은 지침이나 지식에 넣어요.
-
중요한 것은 지식에 넣어 두세요
한 대화에서 좋은 요약이 나왔다면 지식에 넣어 두세요. 다음 대화가 그것을 쓸 수 있어요.
-
Can edit 는 신중하게
고칠 수 있는 멤버는 모두에게 적용되는 지침과 지식을 바꿔요. 꼭 필요한 사람에게만 주세요.
-
사용량 살피기
큰 지식과 많은 병렬 스레드는 요금제 사용량을 더 빨리 써요. 목표에 필요한 파일만 두세요.
-
원본과 맞춰 보기
Claude 도 틀릴 수 있어요. 중요한 답은 강의 계획서나 교과서와 맞춰 보세요.
공식 출처
2026-11-09 에 공식 도움말로 확인했어요. 요금제와 화면은 바뀌니 공식 페이지도 함께 읽으세요.
- Claude Help Center — What are projects? (새 창)
- Claude Help Center — How can I create and manage projects? (새 창)
- Claude Help Center — Retrieval augmented generation (RAG) for projects (새 창)
- Claude Help Center — Project visibility and sharing (새 창)
- Claude Code Docs — Let Claude coordinate ongoing work with Projects (새 창)
- Claude Blog — Projects redesigned: from folder to conversation (새 창)