⑤ Claude API 시작하기 — 앱에 Claude 심기

모델·가격은 Anthropic 공식 문서(platform.claude.com/docs) 기준. 모델 라인업은 수시로 갱신되니 프로덕션 전엔 공식 페이지에서 최신 상태 확인하세요.

1. 현재 라인업 (2026년 4월 기준)

| 모델 | API id | 입력 / 출력 (USD / 백만토큰) | 컨텍스트 | 출력 | 지식 컷오프 | |---|---|---|---|---|---| | Claude Opus 4.7 | claude-opus-4-7 | $5 / $25 | 1M | 128k | 2026-01 | | Claude Sonnet 4.6 | claude-sonnet-4-6 | $3 / $15 | 1M | 64k | 2025-08 | | Claude Haiku 4.5 | claude-haiku-4-5 | $1 / $5 | 200k | 64k | — |

은퇴·중단 예정

• Sonnet 4 / Opus 4 — 2026-06-15
• Haiku 3 — 2026-04-19

2. 어떤 모델을 쓸까 — 3단 기준

Haiku 4.5 — 싸고 빠름

• 분류, 간단 요약, 태그 생성, 톤 체크, 간단 포맷 변환
• 챗봇 1차 응답
• 가격 민감한 대량 트래픽

Sonnet 4.6 — 일반적인 기본값

• 글쓰기, 편집, 일반 코드 생성, 문서 Q&A, 리서치
• 대부분의 프로덕션 시작점

Opus 4.7 — 최고 난이도

• 복잡한 에이전트 워크플로우
• 멀티스텝 계획, 어려운 코드 리팩토링
• "Sonnet으로 해봤는데 품질이 부족"한 순간에만

3. API 키 발급

1. console.anthropic.com 접속 → 로그인
2. API Keys → Create Key
3. 결제 수단 등록 (종량제)
4. 키를 .env 에 저장. 코드에 하드코딩 금지

# .env
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxx

4. 첫 호출 — Node.js

npm i @anthropic-ai/sdk

import Anthropic from "@anthropic-ai/sdk"

const client = new Anthropic()

const msg = await client.messages.create({
  model: "claude-haiku-4-5",
  max_tokens: 512,
  messages: [
    { role: "user", content: "한 문장으로 자기소개 해줘." },
  ],
})

console.log(msg.content)

5. 첫 호출 — Python

pip install anthropic

from anthropic import Anthropic

client = Anthropic()

msg = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=512,
    messages=[{"role": "user", "content": "한 문장으로 자기소개 해줘."}],
)

print(msg.content)

6. 프로덕션에서 꼭 챙길 5가지

1. 모델 ID를 하드코딩하지 말고 환경변수로 — 라인업이 빠르게 바뀝니다
2. max_tokens 는 실제 필요한 만큼만 — 과하면 비용만 커짐
3. 시스템 프롬프트는 system 필드로 — user 메시지에 끼워넣지 말 것
4. 재시도 로직 — 429/503은 exponential backoff
5. Prompt caching — 공통 컨텍스트가 길면 캐싱 활성화로 단가 절감

7. 비용 감 잡기

예시: Sonnet 4.6으로 한 요청에 입력 5k + 출력 1k 토큰을 쓴다면

• 입력: 5,000 × ($3 / 1,000,000) = $0.015
• 출력: 1,000 × ($15 / 1,000,000) = $0.015
• 합계: 요청당 약 $0.03 (≒ 40원대)

하루 1만 요청이면 약 $300. Haiku로 대체 가능한 요청은 Haiku로 돌리는 게 정답입니다 — 동일 조건이면 $100 안쪽.

여기까지가 Claude 기초 시리즈 5편입니다. 다음 시리즈: 자동화 입문 / 배포하는 법.