Claude Projects 커스텀 지시사항과 지식 파일로 재사용 가능한 리서치 어시스턴트 만들기
Claude Projects로 나만의 리서치 어시스턴트 구축하기
Claude Projects는 커스텀 지시사항(Custom Instructions)과 지식 파일(Knowledge Files)을 결합하여 특정 업무에 최적화된 AI 어시스턴트를 만들 수 있는 강력한 기능입니다. 이 가이드에서는 반복적인 리서치 작업을 자동화하는 재사용 가능한 리서치 어시스턴트를 단계별로 구축하는 방법을 설명합니다.
사전 준비사항
- Claude Pro 또는 Team 플랜 구독 (Projects 기능 필요)- 리서치에 활용할 참고 문서 (PDF, TXT, CSV 등)- API 활용 시: Claude API 키
단계별 구축 가이드
1단계: 새 프로젝트 생성
Claude 웹 인터페이스에서 프로젝트를 생성합니다.
- claude.ai에 로그인합니다.- 왼쪽 사이드바에서 Projects 메뉴를 클릭합니다.- Create Project 버튼을 클릭합니다.- 프로젝트 이름을 입력합니다. 예:
시장 리서치 어시스턴트- 프로젝트 설명을 추가합니다.
2단계: 커스텀 지시사항 작성
프로젝트 설정에서 Custom Instructions 영역에 아래와 같은 시스템 프롬프트를 입력합니다.
당신은 전문 시장 리서치 어시스턴트입니다.
역할
- 업로드된 지식 파일을 기반으로 정확한 데이터 분석을 수행합니다.
- 모든 응답에 출처를 명시합니다.
- 한국어로 응답하되, 전문 용어는 영문 병기합니다.
출력 형식
- 요약: 3줄 이내의 핵심 요약
- 상세 분석: 구조화된 본문
- 데이터 포인트: 수치 근거 포함
- 액션 아이템: 구체적 다음 단계 제안
제약 사항
- 지식 파일에 없는 내용은 추측하지 않고 명시합니다.
데이터의 시점과 한계를 항상 언급합니다.
3단계: 지식 파일 업로드
프로젝트에 참고 자료를 추가하여 맥락을 강화합니다. - 프로젝트 설정에서 **Knowledge** 섹션으로 이동합니다.- **Upload files**를 클릭하여 문서를 업로드합니다.- 지원 형식: PDF, TXT, CSV, MD 등 (파일당 최대 30MB, 프로젝트당 최대 200K 토큰)효과적인 지식 파일 구성 예시:
| 파일명 | 용도 | 형식 |
|---|---|---|
| industry_report_2025.pdf | 산업 현황 데이터 | |
| competitor_analysis.csv | 경쟁사 비교 데이터 | CSV |
| glossary.md | 도메인 전문 용어집 | Markdown |
| research_template.txt | 보고서 출력 템플릿 | TXT |
pip install anthropicPython에서 프로젝트 컨텍스트를 활용하는 예시:
import anthropic
client = anthropic.Anthropic(api_key=“YOUR_API_KEY”)
시스템 프롬프트에 커스텀 지시사항 반영
system_prompt = """
당신은 전문 시장 리서치 어시스턴트입니다.
업로드된 자료를 기반으로 분석하고, 출처를 명시하세요.
응답 형식: 요약 → 상세 분석 → 데이터 포인트 → 액션 아이템
"""
def research_query(question: str, context_docs: str = "") -> str:
message = client.messages.create(
model=“claude-sonnet-4-20250514”,
max_tokens=4096,
system=system_prompt,
messages=[
{
“role”: “user”,
“content”: f”참고 자료:\n{context_docs}\n\n질문: {question}”
}
]
)
return message.content[0].text
실행 예시
result = research_query(
question=“2025년 국내 SaaS 시장 성장률과 주요 트렌드를 분석해주세요.”,
context_docs=“[업로드된 보고서 내용이 여기에 포함됩니다]”
)
print(result)
5단계: 반복 활용을 위한 프롬프트 템플릿 설정
프로젝트 내에서 자주 사용하는 질문 패턴을 템플릿화합니다.
# 경쟁사 분석 템플릿
[회사명]에 대해 다음 항목을 분석해주세요:
1. 핵심 제품/서비스 라인업
2. 시장 포지셔닝 및 차별화 전략
3. 최근 12개월 주요 이벤트
4. 강점과 약점 (SWOT 중 S/W)
5. 우리 회사와의 직접 비교 포인트
시장 트렌드 분석 템플릿
[산업/분야]의 현재 트렌드를 다음 구조로 정리해주세요:
- 매크로 트렌드 (3가지)
- 기술 동향
- 규제 환경 변화
6개월 내 예상 변화
Pro Tips: 파워 유저를 위한 고급 활용법
- 지식 파일 계층화: 변하지 않는 기본 자료(용어집, 가이드라인)와 주기적으로 업데이트하는 자료(시장 데이터, 뉴스)를 분리하여 관리하세요.- 출력 형식 고정: 커스텀 지시사항에 Markdown 테이블, JSON 등 원하는 출력 포맷을 명시하면 일관된 형식의 리포트를 받을 수 있습니다.- 멀티 프로젝트 전략: 산업별, 고객별로 프로젝트를 분리하면 지식 파일의 맥락 충돌 없이 정확한 답변을 얻을 수 있습니다.- 체인 프롬프팅: 첫 질문에서 데이터 수집 → 두 번째 질문에서 분석 → 세 번째 질문에서 보고서 작성처럼 대화를 단계적으로 구성하면 품질이 향상됩니다.- 버전 관리: 커스텀 지시사항을 별도 텍스트 파일로 보관하고, 수정 이력을 기록하여 최적의 프롬프트를 추적하세요.
Troubleshooting: 자주 발생하는 문제 해결
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 지식 파일 내용이 응답에 반영되지 않음 | 파일 크기 초과 또는 형식 오류 | 파일을 200K 토큰 이내로 분할하고, 텍스트 기반 형식(PDF, TXT, MD)으로 변환 |
| 응답이 커스텀 지시사항을 따르지 않음 | 지시사항이 너무 길거나 모호함 | 핵심 규칙을 5개 이내로 줄이고, 구체적 예시를 포함 |
| API 호출 시 401 Unauthorized 에러 | API 키 만료 또는 잘못된 키 | console.anthropic.com에서 키 재발급 후 환경변수 업데이트 |
| 응답에 할루시네이션(허위 정보) 포함 | 지식 파일 범위 밖의 질문 | 커스텀 지시사항에 "자료에 없는 내용은 '확인 불가'로 표시" 규칙 추가 |
| 토큰 한도 초과 경고 | 지식 파일 + 대화 컨텍스트 합산 초과 | 불필요한 파일 제거, 핵심 정보만 요약하여 재업로드 |
아래는 주간 시장 리서치 보고서를 자동화하는 전체 흐름입니다.
- **월요일:** 최신 산업 뉴스와 데이터를 지식 파일로 업데이트- **화요일~목요일:** 프로젝트 내에서 템플릿 프롬프트로 각 섹션 분석 수행- **금요일:** "이번 주 분석 내용을 종합하여 주간 리포트를 작성해주세요" 프롬프트로 최종 보고서 생성# 주간 보고서 통합 프롬프트 예시
이번 주 대화에서 다룬 모든 분석을 종합하여
다음 형식의 주간 리서치 보고서를 작성해주세요:
- Executive Summary (국문)
- 주요 발견사항 Top 5
- 데이터 기반 인사이트
- 리스크 요인
다음 주 모니터링 포인트
자주 묻는 질문 (FAQ)
Q1: Claude Projects의 지식 파일은 얼마나 자주 업데이트해야 하나요?
지식 파일의 업데이트 주기는 데이터의 성격에 따라 다릅니다. 시장 데이터나 경쟁사 정보는 주 1회 이상 업데이트하는 것이 좋고, 용어집이나 분석 가이드라인 같은 기본 자료는 분기별로 검토하면 충분합니다. 오래된 데이터가 남아있으면 분석 품질이 저하되므로, 날짜가 지난 파일은 삭제하고 최신 버전으로 교체하세요.
Q2: 하나의 프로젝트에 여러 목적의 지시사항을 넣어도 되나요?
하나의 프로젝트에 너무 많은 역할을 부여하면 지시사항 간 충돌이 발생할 수 있습니다. 예를 들어 “간결하게 요약하라”와 “상세하게 분석하라”는 서로 모순됩니다. 목적별로 프로젝트를 분리하는 것을 권장합니다. 시장 리서치용, 경쟁사 분석용, 고객 인사이트용 등으로 나누면 각 프로젝트의 응답 품질이 크게 향상됩니다.
Q3: Claude API와 웹 Projects를 함께 사용할 수 있나요?
현재 Claude API는 웹 인터페이스의 Projects 기능과 직접 연동되지 않습니다. API 사용 시에는 시스템 프롬프트에 커스텀 지시사항을 직접 포함하고, 지식 파일의 내용을 메시지 컨텍스트로 전달해야 합니다. 위 가이드의 Python 코드 예시처럼 system 파라미터와 messages에 참고 자료를 포함하는 방식으로 동일한 효과를 구현할 수 있습니다.