Claude Projects
완전 활용 가이드
시스템 프롬프트 설정부터 파일 업로드, GitHub 연동, 팀 공유까지 — 한 번 제대로 세팅하면 매번 설명할 필요 없는 나만의 AI 작업 공간 만들기
개념 이해
Claude Projects란 무엇인가 — 일반 대화와의 차이
Claude.ai를 그냥 열어서 대화하면 매번 새 채팅이 시작됩니다. 어제 내가 어떤 프로젝트를 진행 중인지, 어떤 톤으로 글을 써달라고 했는지, 회사 내부 용어가 무엇인지 — Claude는 아무것도 모릅니다. 매번 다시 설명해야 합니다.
Projects는 이 문제를 해결합니다. 프로젝트 하나를 만들면 그 안에서 일어나는 모든 대화가 동일한 컨텍스트를 공유합니다. 지침(시스템 프롬프트)과 업로드된 파일이 모든 대화에 자동으로 적용되고, 대화 기록도 프로젝트 단위로 축적됩니다.
⚡ 일반 채팅
매번 배경 설명 반복
대화 끝나면 맥락 소멸
파일은 해당 대화에서만 유효
어투·형식 설정이 지속되지 않음
팀원과 공유 불가
🗂 Claude Projects
지침이 모든 대화에 자동 적용
대화 기록이 프로젝트에 누적
파일이 지식 베이스로 영구 저장
어투·형식·역할이 고정됨
팀원과 프로젝트 공유 가능 (Team)
지침 (커스텀 지시문)
모든 대화에 적용되는 시스템 프롬프트. 역할, 어투, 출력 형식을 고정한다.
프로젝트 지식
문서, PDF, 코드, 텍스트를 업로드해 지식 베이스를 구축한다. 200K 토큰 제공.
GitHub 연동
저장소를 직접 연결해 코드베이스를 기반으로 대화할 수 있다.
팀 협업 (Team 플랜)
공유 프로젝트, 대화 스냅샷, 활동 피드로 팀 단위 AI 활용을 지원한다.
요금제 비교
요금제별 사용 가능 기능 정리
Projects는 Claude Pro, Team, Enterprise 플랜에서 사용할 수 있습니다. 무료 플랜은 Projects를 지원하지 않습니다. 플랜별 주요 차이점은 다음과 같습니다.
| 기능 | Free | Pro ($20/월) | Team ($25/월) |
|---|---|---|---|
| Projects 생성 | ✗ | ✓ 무제한 | ✓ 무제한 |
| 지침(시스템 프롬프트) | ✗ | ✓ | ✓ |
| 파일 업로드 (지식 베이스) | ✗ | ✓ 200K 토큰 | ✓ 200K 토큰 |
| GitHub 저장소 연동 | ✗ | ✓ | ✓ |
| 프로젝트 팀 공유 | ✗ | ✗ (개인만) | ✓ |
| 활동 피드 & 스냅샷 공유 | ✗ | ✗ | ✓ |
| 사용 모델 | Claude Haiku | Claude Sonnet 4.6 | Opus 4.6 포함 |
팀 협업 기능이 필요하지 않다면 Pro 플랜의 Projects 기능으로 대부분의 작업을 커버할 수 있습니다. GitHub 연동과 200K 토큰 지식 베이스는 Pro에서도 동일하게 제공됩니다.
단계별 가이드
프로젝트 만들기 — 첫 세팅 단계별 가이드
Claude.ai 왼쪽 사이드바에서 "Projects" 항목을 클릭하고 "새 프로젝트"를 누르면 시작됩니다. 프로젝트 이름과 설명을 입력한 후 두 가지 핵심 설정으로 바로 넘어가세요.
-
1
사이드바 → Projects → 새 프로젝트 클릭
이름은 나중에 한눈에 구분할 수 있게 구체적으로 짓는 게 좋습니다. "블로그용"보다 "temver 블로그 – AI 툴 분석" 형태가 낫습니다.
-
2
지침(커스텀 지시문) 작성
프로젝트 내 모든 대화에 시스템 프롬프트처럼 적용됩니다. 역할, 어투, 출력 형식을 여기에 설정합니다.
-
3
파일 업로드 (프로젝트 지식)
관련 문서, 참고 자료, 브랜드 가이드라인 등을 업로드합니다. 최대 약 200K 토큰(500페이지 분량) 지원.
-
4
첫 대화로 세팅 검증
지침과 파일이 잘 반영되는지 테스트 질문을 던져보세요. "현재 설정된 지침을 요약해줘"로 빠르게 확인할 수 있습니다.
핵심 ① 지침(커스텀 지시문) 작성법
지침은 Projects의 심장입니다. 잘 쓴 지침 하나가 수십 번의 반복 설명을 대신합니다. 명확하고 구체적일수록 결과가 좋습니다. 다음은 블로그 글쓰기 프로젝트용 지침 예시입니다.
## 역할
당신은 AI 툴 전문 블로그 'temver'의 편집 파트너입니다.
기술에 밝은 일반 독자를 대상으로, 실용적이고 읽기 쉬운
한국어 콘텐츠를 작성합니다.
## 글쓰기 원칙
- 문장은 짧게. 단문과 장문을 섞어 리듬감을 만든다.
- 어려운 기술 용어는 첫 등장 시 괄호로 간단히 설명한다.
- 목차는 H2, 소제목은 H3. 소제목 끝에 마침표 없음.
- 본문에 코드 예시가 필요하면 반드시 언어 레이블을 붙인다.
- 결론은 핵심 한 줄로 요약하고 독자에게 다음 행동을 제안한다.
## 하지 말 것
- "안녕하세요, 오늘은 ~에 대해 알아보겠습니다" 류의 시작 금지
- 과도한 영어 원문 병기 금지 (필요한 경우만)
- 확인되지 않은 통계 수치 임의 작성 금지
## 출력 형식
요청 없으면 마크다운으로 출력. HTML 요청 시 별도 명시.① 역할 명확히 — "누구의 입장에서 답하는가"를 한 문장으로 / ② 해야 할 것과 하지 말 것 분리 — 두 가지 모두 적어야 정확도가 높아짐 / ③ 출력 형식 명시 — 마크다운, HTML, JSON 등 기본 출력 방식을 지정
핵심 ② 파일 업로드 & 지식 베이스 구축
프로젝트 지식에 파일을 올려두면 Claude가 해당 내용을 대화 전반에서 참조합니다. PDF, TXT, 코드 파일, 마크다운 등 대부분의 텍스트 기반 파일을 지원합니다. 최대 약 200K 토큰으로 약 500페이지 분량의 문서를 담을 수 있습니다.
올릴 때 한 가지 주의사항이 있습니다. 파일은 업로드 시점의 스냅샷으로 저장됩니다. 원본 파일이 수정되더라도 프로젝트는 자동으로 업데이트되지 않습니다. 변경사항이 생기면 해당 파일을 삭제하고 새 버전을 다시 올려야 합니다.
"첨부 파일을 바탕으로 이 프로젝트의 핵심 맥락, 용어, 규칙을 요약해줘. 모호하거나 충돌하는 부분이 있으면 알려줘." — Claude가 자료를 제대로 이해했는지 한 번에 검증할 수 있습니다.
어떤 파일을 올릴지 고민된다면 아래 체크리스트를 참고하세요.
- ✓브랜드/문체 가이드라인 (어투, 용어 정의, 피해야 할 표현)
- ✓자주 참조하는 내부 문서 (사양서, 정책, 매뉴얼)
- ✓과거 작업물 샘플 (내 글 스타일을 학습시킬 때)
- ✓자주 쓰는 템플릿 (보고서 양식, 이메일 형식)
- ✓도메인 특화 자료 (법령, 기술 스펙, 논문 요약)
핵심 ③ GitHub 저장소 연동
개발자라면 이 기능이 특히 유용합니다. 프로젝트에 GitHub 저장소를 직접 연결하면 코드베이스를 기반으로 질문하고, 코드 리뷰를 받고, 구조 분석을 할 수 있습니다. 파일 업로드와 달리 특정 브랜치의 내용을 동기화하는 방식입니다.
1. 프로젝트 설정 → "GitHub 저장소 추가" 클릭
2. GitHub 계정 연결 (최초 1회 OAuth 인증)
3. 연결할 저장소와 브랜치 선택
4. "파일 구성"에서 포함할 디렉토리·파일 선택
→ 불필요한 파일 제외해 토큰 낭비를 줄일 것
5. 동기화 완료 후 대화에서 바로 코드 질문 가능
## 주의사항
- 저장소 업데이트 후 수동으로 새로고침 필요
- 파일 내용(이름+코드)만 동기화됨, 커밋 기록 미포함
- 브랜치별 스냅샷 방식으로 실시간 연동은 아님모노레포나 대형 프로젝트는 모든 파일을 넣으면 토큰 한도를 금방 채웁니다. 현재 작업 중인 핵심 디렉토리와 파일만 선택적으로 포함하고, 작업이 바뀔 때 구성을 업데이트하는 방식이 효율적입니다.
실전 활용
직군별 실전 활용 사례 5가지
Projects는 반복적이고 맥락이 중요한 작업일수록 빛납니다. 직군별로 가장 효과적인 세팅 방식을 정리했습니다.
블로거 · 콘텐츠 크리에이터
지침에 나만의 문체 규칙과 독자 페르소나를 저장합니다. 과거 글 베스트 3~5개를 파일로 올려두면 Claude가 내 어투를 학습합니다. 매번 "내 톤을 유지하면서 써줘"라고 설명할 필요가 없어집니다.
핵심 설정: 지침 + 파일 (글 샘플)개발자 · 사이드 프로젝트
GitHub 저장소를 연결하고 지침에 코딩 컨벤션, 사용 스택, 금지 패턴을 명시합니다. "이 함수 리팩토링해줘", "이 버그 원인 분석해줘" 같은 질문을 코드베이스 맥락 위에서 바로 할 수 있습니다.
핵심 설정: GitHub 연동 + 지침 (코딩 컨벤션)마케터 · 기획자
브랜드 가이드라인, 제품 스펙, 경쟁사 분석 자료를 파일로 올려둡니다. "이 내용을 우리 브랜드 보이스로 SNS 캡션으로 바꿔줘" 같은 요청이 한 줄로 끝납니다. 제품 업데이트 시 관련 파일만 교체하면 됩니다.
핵심 설정: 파일 (브랜드 가이드) + 지침 (톤 앤 매너)연구자 · 학습자
논문, 교재, 강의 노트를 파일로 올려두고 "이 개념을 내가 업로드한 논문 기준으로 설명해줘"라고 질문합니다. 200K 토큰 덕분에 두꺼운 PDF 여러 개를 한꺼번에 올려도 됩니다. AI가 엉뚱한 정보를 만들어낼 위험이 줄어듭니다.
핵심 설정: 파일 (자료 업로드) + 지침 (인용 방식)고객지원 · CS팀
제품 FAQ, 환불 정책, 자주 발생하는 오류 해결책을 파일로 올립니다. 지침에 응대 어투와 에스컬레이션 규칙을 작성하면 일관된 고객 응대 초안 작성기로 활용할 수 있습니다. Team 플랜에서는 팀원 모두가 같은 지식 베이스를 사용합니다.
핵심 설정: 파일 (정책 문서) + 팀 공유팀 플랜 전용
팀 플랜 협업 기능 완전 정복
Claude Team 플랜을 쓴다면 Projects가 협업 도구로 확장됩니다. 핵심 기능은 세 가지입니다.
① 공유 프로젝트
프로젝트를 팀원과 공유하면 동일한 지침과 지식 베이스를 모두가 사용할 수 있습니다. 신규 팀원이 들어와도 별도 온보딩 없이 프로젝트를 열면 됩니다. 단, 각자의 대화 내역은 분리됩니다. 실시간 공동 편집은 지원하지 않습니다.
② 대화 스냅샷 공유
유용하게 사용한 대화를 팀 활동 피드에 공유할 수 있습니다. 잘 작동한 프롬프트나 결과물을 팀 전체가 배울 수 있는 노하우 공유 채널이 됩니다. "이 프롬프트로 하면 보고서 초안이 이렇게 나와요"를 직접 보여줄 수 있습니다.
③ 활동 피드
팀원들이 프로젝트에서 어떻게 AI를 활용하고 있는지 피드로 확인할 수 있습니다. AI 활용 역량 편차가 큰 팀에서 특히 효과적입니다. 잘 쓰는 사람의 방식이 자연스럽게 전파됩니다.
처음부터 완벽한 지침을 만들려 하지 마세요. 지침 초안 → 팀 피드백 → 개선 주기를 2~3회 반복하는 게 훨씬 효과적입니다. 공유 전에 혼자 2주 정도 써보면서 지침을 다듬는 것을 권장합니다.
고급 활용
실력자만 아는 고급 팁
팁 1 — 지침에 "출력 예시"를 넣어라
설명만으로 원하는 형식을 잡기 어려울 때는 원하는 결과물의 예시를 직접 지침에 넣으세요. "이런 형식으로 출력해줘: [예시]" 형태가 추상적인 설명보다 훨씬 정확하게 작동합니다.
## 블로그 글 도입부 형식
아래 예시처럼 도입부를 작성한다:
---예시 시작---
"ChatGPT한테 시키면 5분 만에 뚝딱 나온다던데요?"
맞습니다. 나옵니다. 그런데 6개월 후 그 블로그의
방문자가 왜 반토막이 났는지는 아무도 알려주지 않습니다.
---예시 끝---
특징: 짧은 인용/가정으로 시작 → 반전 → 문제 제기팁 2 — 프로젝트를 기능 단위로 잘게 쪼개라
하나의 프로젝트에 모든 것을 넣고 싶은 유혹을 참아야 합니다. "콘텐츠 제작 전반"보다 "블로그 초안 작성"과 "SNS 카드뉴스 제작"을 각각 분리하면 지침이 명확해지고 결과 품질이 높아집니다.
팁 3 — 파일 업로드 후 첫 명령을 "자기소개"로 써라
"업로드된 파일을 기반으로, 이 프로젝트에서 네가 맡은 역할, 알고 있는 핵심 정보, 모호하거나 충돌하는 부분을 정리해줘." — 파일 업로드 후 첫 검증 프롬프트
이 명령 하나로 Claude가 파일을 제대로 읽었는지, 지침을 잘 이해했는지 단번에 확인할 수 있습니다. 이상한 부분이 있으면 파일을 교체하거나 지침을 수정하면 됩니다.
팁 4 — 주기적으로 지침을 Claude에게 개선시켜라
프로젝트를 2~4주 사용한 뒤, 이런 프롬프트를 던져보세요: "지금까지 이 프로젝트에서 내가 자주 추가 설명한 것들을 보면, 지침에 어떤 내용을 추가하면 더 효율적일 것 같아?" Claude가 대화 패턴을 분석해서 지침 개선안을 제안해줍니다.
주의사항
한계와 주의사항
Projects를 잘 쓰려면 한계도 알아야 합니다. 과도한 기대는 오히려 실망으로 이어집니다.
업로드 시점의 스냅샷으로 저장됩니다. 원본이 변경되면 프로젝트를 직접 업데이트해야 합니다. 자주 바뀌는 문서는 올리기보다 그때그때 대화에서 직접 붙여넣는 게 나을 수 있습니다.
같은 문서에 동시 편집하거나, AI 출력에 댓글을 달거나, 공유 화이트보드에서 브레인스토밍하는 것은 지원하지 않습니다. 같은 지식 베이스를 공유하는 것이지, Notion이나 Google Docs 같은 실시간 협업 툴은 아닙니다.
파일을 마구 올리다 보면 토큰 한도에 가까워집니다. 정기적으로 오래되거나 불필요한 파일을 정리하는 습관이 필요합니다. 특히 이미지나 스캔 PDF는 텍스트 추출이 제한될 수 있습니다.
내부 문서, 개인정보, 영업 기밀을 올리기 전에 Anthropic의 데이터 처리 정책과 소속 조직의 보안 규정을 확인하세요. Enterprise 플랜은 별도의 데이터 보안 정책이 적용됩니다.
마치며
세팅 1시간이 수백 시간의 반복을 없앤다
Claude Projects의 진짜 가치는 처음 세팅이 끝난 이후에 나타납니다. 지침과 파일을 한 번 제대로 설정해두면, 이후 모든 대화가 그 위에서 시작됩니다. 매번 배경 설명을 반복하지 않아도 됩니다.
지금 당장 가장 반복적으로 하는 AI 작업 하나를 골라서 프로젝트를 만들어보세요. 블로그 글쓰기, 코드 리뷰, 보고서 작성 — 어떤 것이든 좋습니다. 일주일만 써보면 차이가 느껴집니다.
다음 편에서는 지침을 더 정밀하게 작성하는 방법과 프로젝트별 템플릿을 직군별로 공유할 예정입니다.
'사용법 가이드' 카테고리의 다른 글
| Claude Skills 완벽 사용법 반복 작업 자동화의 끝판왕 (0) | 2026.06.03 |
|---|---|
| AI 툴에게 일 잘 시키는 법 — 기획자·마케터를 위한 실무 맥락 설계 가이드 (0) | 2026.05.30 |
| Ollama 로컬 자동화 완전 가이드 | 상세 사용법 (0) | 2026.05.17 |
| Local AI로 무료 개발 에이전트 만들기 (0) | 2026.05.17 |
| OpenAI Codex 완벽 가이드 - 초기 설정부터 실전 코딩까지 (1) | 2026.05.13 |