코드가 포함된 단계별 Claude API 튜토리얼

단계별 튜토리얼 • 읽기 시간 8분

요약 (TL;DR)

console.anthropic.com에서 가입하고, API 키를 생성하고, anthropic SDK를 설치하면 5분 안에 첫 번째 요청을 보낼 수 있습니다.

1. API 키 가져오기

• console.anthropic.com에 접속하여 계정을 생성합니다.
• 결제 정보를 추가합니다 (시작 시 약간의 무료 크레딧이 제공됩니다).
• 사이드바에서 API Keys로 이동합니다.
• Create Key를 클릭하고 키를 복사합니다 — sk-ant-로 시작합니다.

2. SDK 설치

Python:
pip install anthropic
Node.js:
npm install @anthropic-ai/sdk

3. 첫 번째 요청 (Python)

import anthropic

client = anthropic.Anthropic(api_key="sk-ant-...")

response = client.messages.create(  
    model="claude-opus-4-7",  
    max_tokens=1024,  
    messages=[  
        {"role": "user", "content": "Explain quantum computing in 3 sentences."}  
    ]  
)  
print(response.content[0].text)

4. 모델 선택 (2026)

모델	속도	비용	최적 용도
Claude Opus 4.7	느림	높음	복잡한 추론, 코딩
Claude Sonnet 4.6	빠름	중간	대부분의 작업 (기본값)
Claude Haiku 4.5	가장 빠름	가장 저렴함	대량 처리, 실시간

5. 활용해야 할 주요 기능

시스템 프롬프트 (System Prompts)

response = client.messages.create(   
    model="claude-sonnet-4-6",   
    max_tokens=1024,   
    system="You are a helpful coding assistant. Respond only with code.",   
    messages=[{"role": "user", "content": "Reverse a linked list in Python"}]   
)

스트리밍 (Streaming)

with client.messages.stream(   
    model="claude-sonnet-4-6",   
    max_tokens=1024,   
    messages=[{"role": "user", "content": "Write a poem"}]   
) as stream:   
    for text in stream.text_stream:   
        print(text, end="", flush=True)

프롬프트 캐싱 (Prompt Caching) (비용 절감)

긴 시스템 프롬프트나 컨텍스트를 캐싱하세요 — 이후 호출 시 비용이 90% 저렴해집니다. 시스템 메시지에 cache_control 마커를 추가하세요.

도구 사용 (Tool Use)

Claude에게 함수(날씨, 데이터베이스 쿼리, 코드 실행)에 대한 접근 권한을 부여하세요. 전체 tool_use 사양은 docs.claude.com을 참조하세요.

6. 일반적인 패턴 (Common Patterns)

다중 턴 대화 (Multi-turn Conversation)

messages = [ {"role": "user", "content": "Hi"}, {"role": "assistant", "content": "Hello! How can I help?"}, {"role": "user", "content": "Explain recursion"} ] response = client.messages.create(model="claude-sonnet-4-6", max_tokens=1024, messages=messages)

파일 입력 (PDF, 이미지) (File Input (PDF, Images))

import base64 image_data = base64.b64encode(open("chart.png", "rb").read()).decode() response = client.messages.create( model="claude-sonnet-4-6", max_tokens=1024, messages=[{"role": "user", "content": [ {"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": image_data}}, {"type": "text", "text": "What does this chart show?"} ]}] )

7. 가격 책정 (Pricing) (2026)

• Opus 4.7: $15/M 입력, $75/M 출력
• Sonnet 4.6: $3/M 입력, $15/M 출력
• Haiku 4.5: $0.80/M 입력, $4/M 출력

프롬프트 캐싱(Prompt caching)은 캐시된 토큰에 대해 입력 비용을 90% 절감합니다.

8. 흔한 실수 (Common Mistakes)

• 시스템 프롬프트 미사용 (Not using system prompts) — 품질 개선 효과가 매우 큼
• 스트리밍 무시 (Ignoring streaming) — 긴 응답에 더 나은 사용자 경험(UX) 제공
• 긴 컨텍스트 캐싱 누락 (Not caching long contexts) — 90% 절감 기회를 놓치게 함
• 모든 작업에 Opus 사용 (Using Opus for everything) — 대부분의 작업에는 Sonnet으로 충분함
• 프롬프트 엔지니어링 생략 (Skipping prompt engineering) — 프롬프트 튜닝 30분이 모델 교체보다 효과적임

관련 자료: ChatGPT vs Claude · 최신 Anthropic 뉴스 · AI 용어 사전

🎧 5분 만에 매일 AI 뉴스 받기 (Get Daily AI News in 5 Minutes)

매일 5분짜리 팟캐스트로 최신 AI 동향을 파악하세요:

• 🎵 Spotify
• 🍎 Apple Podcasts

[IMG:N]