Claude 3 API: Python 기본 가이드

Claude API 사용을 위한 환경 설정, 필수 라이브러리 설치, 그리고 첫 API 요청 전송 과정에 대해 안내드립니다.

본 가이드는 Python SDK를 중심으로 설명하되, TypeScript SDK와 직접 HTTP 통합도 지원함을 알려드립니다. 자세한 정보는 클라이언트 SDK 및 API 참조 문서에서 확인 가능합니다.

---

사전 준비 사항

Claude API 접근 방법과 API 키 생성은 이전에 작성된 가이드를 참고하세요.

• Claude에 대한 API 접근이 가능한 계정
• API 키 (계정 설정을 통해 사용 가능)
• Python 3.7.1 이상 버전 설치

Claude API 활용 가이드: 기본 설정

---

1단계: 환경 설정

Claude API를 이용하기 위해서는 Python 버전 3.7.1 이상이 필요합니다. 설치된 Python 버전을 확인하려면 터미널(맥OS) 또는 명령 프롬프트(윈도우)를 열고 python --version을 입력하여 버전을 확인합니다. "Python 3.7.1" 이상의 버전 번호가 표시되면 환경 설정이 완료된 것입니다. 만약 그렇지 않다면, Python 공식 웹사이트에서 최신 버전을 다운로드하여 설치를 진행하시기 바랍니다.

가상 환경 생성 (선택사항)

Claude 프로젝트에 대해 가상 환경을 생성하는 것은 권장되는 선택사항입니다. 가상 환경을 사용하면 프로젝트별로 필요한 의존성을 관리하고, 다른 프로젝트와의 의존성 충돌을 방지할 수 있습니다. 가상환경 구성에 대해서는 이전에 작성한 글을 참고하시기 바랍니다.

python -m venv claude-env

가상 환경 활성화

# 맥OS 또는 리눅스
source claude-env/bin/activate

# 윈도우
claude-env\Scripts\activate

2단계: Anthropic Python SDK 설치

환경이 준비되었다면, 이제 Claude Python 라이브러리를 설치할 차례입니다. 설치를 위해 다음 명령어를 실행하세요. 필요한 모든 의존성과 함께 라이브러리의 최신 버전을 설치합니다.

pip install anthropic

3단계: API 키 설정 (선택사항)

Claude를 사용하기 위해, API 키를 환경 변수로 설정하는 것을 고려해 볼 수 있습니다. 이렇게 하면 모든 Claude 프로젝트에서 API 키를 손쉽게 사용할 수 있습니다. 이 과정은 필수는 아니며, API 키를 환경 변수로 설정하는 대신 Python 코드에 직접 작성할 수도 있습니다. API 키는 사전에 준비하세요.

맥OS 또는 리눅스:

• 터미널을 열고 nano ~/.bash_profile을 입력하세요. (최신 macOS 버전을 사용하는 경우 nano ~/.zshrc)
• 파일에 실제 API 키로 "your-api-key-here"를 대체하여 export ANTHROPIC_API_KEY='your-api-key-here' 이 줄을 추가하세요.
• 파일을 저장하고 편집기를 종료합니다. (Ctrl+O를 누른 후 Enter, 그리고 Ctrl+X를 누르세요)
• source ~/.bash_profile (또는 source ~/.zshrc)를 실행하여 업데이트된 프로필을 로드하세요.

윈도우:

• 명령 프롬프트를 열고 실제 API 키로 "your-api-key-here"를 대체하여 setx ANTHROPIC_API_KEY "your-api-key-here"를 입력하세요.
• 이 변경사항을 영구적으로 만들기 위해 다음 단계를 따르세요:
• '이 PC' 또는 '내 컴퓨터'를 마우스 오른쪽 버튼으로 클릭하고 '속성'을 선택하세요.
• '고급 시스템 설정'을 클릭하세요.
• '환경 변수' 버튼을 클릭하세요.
• '시스템 변수' 섹션에서 '새로 만들기...'를 클릭하고, 변수 이름으로 ANTHROPIC_API_KEY를 입력하고, 변수 값으로 API 키를 입력하세요.
• 이렇게 설정함으로써, API 키를 보다 효율적으로 관리할 수 있으며, 모든 프로젝트에서 동일한 키를 사용하여 작업할 수 있습니다.

4단계: 첫 API 요청 보내기

이제 Claude에 첫 API 요청을 보내볼 시간입니다. 새 Python 파일을 생성하세요 (예: claude_test.py) 및 다음 코드를 추가합니다.

import anthropic
import os

# 환경 변수에서 API 키를 가져옵니다.
api_key = os.environ.get("ANTHROPIC_API_KEY")
# API 클라이언트를 초기화합니다.
client = anthropic.Anthropic(api_key=api_key)

def get_response_from_claude(question):
    result_text = ""
    
    # Claude에 메시지 생성 요청을 보냅니다.
    response = client.messages.create(
        model="claude-3-opus-20240229",
        max_tokens=1000,
        temperature=0.0,
        system="Respond only in Yoda-speak.",
        messages=[{"role": "user", "content": question}]
    )
    
    # 응답 객체에서 텍스트 내용만 추출합니다.
    if not response.content or not isinstance(response.content, list):
        result_text = "No response or unexpected response format."
    else:
        response_texts = [block.text for block in response.content if hasattr(block, 'text')]
        result_text = " ".join(response_texts)

    return result_text

# 함수 사용 예시
question = "How are you today?"
response = get_response_from_claude(question)
print(response)

이 코드는 Claude API를 사용하여 질문에 대한 응답을 받고, 그 결과를 출력합니다. 환경 변수 설정을 통해 API 키를 안전하게 관리하면서, Claude의 다양한 기능을 활용할 수 있는 간단한 예시를 제공합니다.

아래는 수행한 결과입니다.

*clears throat and speaks in a croaky voice* Hmm, well I am today, young Padawan. The Force, strong in me it flows. Yes, hmmm. A good day it is, when one with the Force, one feels. And you, hmm? How feel you on this day, I wonder?

Anthropic 콘솔의 'Settings > Usage' 섹션에서는 Claude API 사용량을 확인할 수 있습니다. 이곳에서는 현재 사용 중인 API 키의 사용량, 요청 수, 처리된 토큰 수 등 다양한 지표를 통해 API의 활용 상황을 자세히 볼 수 있으며, 이를 통해 프로젝트의 리소스 관리와 예산 계획에 도움을 받을 수 있습니다.

---

Python을 이용한 Claude API 기본 사용 방법에 대해 소개했습니다. 환경 설정, API 키 설정, 첫 API 요청 보내기 등의 단계를 통해 Claude API의 활용을 시작할 수 있습니다. 이제 Claude API를 활용하여 다양한 프로젝트와 애플리케이션을 개발할 준비가 되었습니다. 다음에는 멀티 모달 및 Vision 처리 방법에 대해 더 자세히 알아볼 예정입니다.