Claude Projects 활용법: 커스텀 인스트럭션과 지식 파일로 브랜드 전용 AI 어시스턴트 만들기

Claude Projects란? 브랜드 맞춤형 AI의 시작

Claude Projects는 Anthropic이 제공하는 강력한 워크스페이스 기능으로, 커스텀 인스트럭션(Custom Instructions)과 지식 파일(Knowledge Files)을 결합하여 특정 브랜드나 업무에 최적화된 AI 어시스턴트를 구축할 수 있습니다. 반복적인 프롬프트 입력 없이도 일관된 톤, 정확한 정보, 브랜드 가이드라인을 따르는 응답을 자동으로 생성할 수 있습니다.

사전 준비 사항

• Claude Pro, Team, 또는 Enterprise 플랜 구독 (Projects 기능 필요)- 브랜드 가이드라인 문서 (PDF, TXT, MD 등)- FAQ 데이터, 제품 카탈로그, 내부 정책 문서 등 참조 자료- API 연동 시: Anthropic API 키

Step 1: 새 프로젝트 생성하기

• claude.ai에 로그인한 후 좌측 사이드바에서 Projects 탭을 클릭합니다.- “Create Project” 버튼을 클릭하고 프로젝트 이름을 입력합니다. 예: 브랜드-CS-어시스턴트- 프로젝트 설명(Description)에 목적을 간략히 기재합니다. 예: “고객 지원용 브랜드 전용 AI 봇”

Step 2: 커스텀 인스트럭션 설정

프로젝트 설정 화면에서 Custom Instructions 영역에 시스템 프롬프트를 작성합니다. 이 인스트럭션은 해당 프로젝트의 모든 대화에 자동 적용됩니다.

커스텀 인스트럭션 작성 예시

## 역할 당신은 [브랜드명]의 공식 고객지원 AI 어시스턴트입니다.

• 답변은 3문장 이내로 핵심을 먼저 전달합니다.
• 추가 정보가 필요하면 bullet point로 정리합니다.
• 관련 FAQ 링크가 있으면 함께 안내합니다.

Step 3: 지식 파일 업로드

프로젝트 설정의 **Knowledge** 섹션에서 참조 문서를 업로드합니다.

권장 파일 구성

Step 4: API를 통한 프로그래밍 방식 활용

Claude API를 사용하면 Projects에 설정한 컨텍스트를 프로그래밍 방식으로 활용할 수 있습니다.

Python SDK 설치 및 기본 사용

# Anthropic Python SDK 설치 pip install anthropic

export ANTHROPIC_API_KEY=YOUR_API_KEY

시스템 프롬프트와 문서 컨텍스트를 활용한 API 호출

import anthropic

client = anthropic.Anthropic(api_key="YOUR_API_KEY")

# 브랜드 가이드라인을 시스템 프롬프트로 설정
system_prompt = """
당신은 [브랜드명]의 공식 고객지원 AI입니다.
항상 존댓말을 사용하고, 아래 제품 정보만을 기반으로 답변하세요.

[제품 카탈로그]
- 프리미엄 플랜: 월 29,900원, 무제한 사용
- 스탠다드 플랜: 월 14,900원, 월 100회 사용
- 무료 체험: 14일간 프리미엄 기능 제공
"""

response = client.messages.create(
    model="claude-sonnet-4-6-20250514",
    max_tokens=1024,
    system=system_prompt,
    messages=[
        {"role": "user", "content": "요금제 종류가 어떻게 되나요?"}
    ]
)

print(response.content[0].text)

대화 이력 유지 (멀티턴)

conversation = []

def chat(user_message):
    conversation.append({"role": "user", "content": user_message})
    
    response = client.messages.create(
        model="claude-sonnet-4-6-20250514",
        max_tokens=1024,
        system=system_prompt,
        messages=conversation
    )
    
    assistant_message = response.content[0].text
    conversation.append({"role": "assistant", "content": assistant_message})
    return assistant_message

# 사용 예시
print(chat("환불 정책이 궁금합니다"))
print(chat("그럼 부분 환불도 가능한가요?"))

Step 5: 테스트 및 반복 개선

• 프로젝트 내에서 테스트 대화를 시작합니다.- 다양한 시나리오를 입력하여 응답 품질을 확인합니다: 일반 문의, 불만 접수, 기술 지원, 가격 문의 등- 부정확하거나 톤이 맞지 않는 응답이 나오면 커스텀 인스트럭션을 수정합니다.- 누락된 정보가 있으면 지식 파일을 추가하거나 업데이트합니다.

Pro Tips: 파워 유저를 위한 고급 활용법

• 구조화된 지식 파일: Markdown 헤딩과 리스트를 활용하여 문서를 구조화하면 Claude가 정보를 더 정확하게 검색합니다. 예를 들어 ## 환불 정책, ## 배송 안내 등 명확한 섹션 구분을 사용하세요.- 네거티브 인스트럭션 활용: “하지 말아야 할 것” 목록을 명시하면 의도치 않은 응답을 방지할 수 있습니다. 예: “절대 할인 코드를 임의로 생성하지 마세요.”- 버전 관리: 인스트럭션을 별도 MD 파일로 관리하고 Git으로 버전 추적하면 변경 이력을 체계적으로 관리할 수 있습니다.- 멀티 프로젝트 전략: 용도별로 프로젝트를 분리하세요. CS용, 마케팅 카피용, 기술 문서용 등 역할별로 나누면 각 프로젝트의 응답 품질이 향상됩니다.- 팀 공유: Team 플랜에서는 프로젝트를 팀원과 공유할 수 있어 일관된 AI 사용 환경을 보장합니다.

Troubleshooting: 자주 발생하는 문제 해결

Q1: Claude Projects의 지식 파일은 얼마나 자주 업데이트해야 하나요?

제품 정보, 가격, 정책이 변경될 때마다 즉시 업데이트하는 것이 좋습니다. 최소 월 1회 정기 점검을 권장하며, 업로드된 파일은 프로젝트 설정에서 언제든 교체하거나 삭제할 수 있습니다. 오래된 정보가 포함되면 AI가 부정확한 답변을 제공할 수 있으므로 주기적 관리가 중요합니다.

Q2: 하나의 프로젝트에 여러 언어(한국어, 영어 등)를 지원할 수 있나요?

네, 커스텀 인스트럭션에 다국어 응답 규칙을 설정할 수 있습니다. 예를 들어 “사용자가 영어로 질문하면 영어로, 한국어로 질문하면 한국어로 답변하세요”와 같은 지시를 추가하면 됩니다. 다만 각 언어별로 별도 프로젝트를 만드는 것이 응답 품질 면에서 더 효과적입니다.

Q3: Projects 기능과 API 시스템 프롬프트의 차이점은 무엇인가요?

Claude Projects는 웹 UI에서 시각적으로 관리할 수 있어 비개발자도 쉽게 사용 가능하며, 파일 업로드와 팀 공유 기능을 제공합니다. API 시스템 프롬프트는 프로그래밍 방식으로 더 세밀한 제어가 가능하고 자동화된 워크플로우에 적합합니다. 두 방식을 병행하여 웹 UI로 프로토타이핑 후 API로 프로덕션 배포하는 전략이 가장 효율적입니다.