Claude API 시작하는 법 — Python·Node.js 예제와 비용 가이드

1. API 키 발급

https://console.anthropic.com → Settings → API Keys → Create Key. 발급 즉시 환경변수에 저장 (ANTHROPIC_API_KEY=sk-ant-api03-...).

2. 첫 호출 (Python)

from anthropic import Anthropic
client = Anthropic()
msg = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "안녕"}],
)
print(msg.content[0].text)

3. Node.js 예제

import Anthropic from "@anthropic-ai/sdk"
const client = new Anthropic()
const msg = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [{ role: "user", content: "안녕" }],
})

4. 모델 선택 가이드

• Haiku 4.5 — 분류·요약·태깅 같은 단순 작업, 최저 단가
• Sonnet 4.6 — 일반 글쓰기·Q&A·중간 코딩, 가장 범용
• Opus 4.7 — 복잡한 추론·대형 리팩토링, 비싸지만 품질 최상

5. 비용 절감 3가지

Prompt Caching — 반복되는 시스템 프롬프트는 캐싱(읽기 단가 1/10). Batch API — 즉시 응답 안 필요한 작업은 50% 할인. 모델 라우팅 — 1차는 Haiku, 실패만 Sonnet으로 escalate.

실제 비용은 토큰 비용 계산기에서 시뮬레이션 가능.

6. 흔한 에러

• 401 unauthorized → 해결법
• prompt is too long → 컨텍스트 초과 해결
• 캐시 미적용 → Prompt Caching 디버깅