클로드 API 사용 방법
키 발급부터 코드 실행까지
Anthropic 고성능 모델을 내 프로그램에서 직접 호출
Python SDK로 5분 안에 첫 응답을 받아보세요
신규 가입 시 결제 카드 등록 필요 (신규 사용자 무료 크레딧 자동 제공 — 테스트 충분).
⚠️ 키는 최초 1회만 표시됩니다. 반드시 즉시 복사해 안전한 곳에 저장하세요.
# Linux / Mac
export ANTHROPIC_API_KEY='sk-ant-...'
# Windows — 시스템 환경변수에 ANTHROPIC_API_KEY 추가
신규 계정에는 무료 크레딧이 자동 제공됩니다. 결제 전 충분히 테스트할 수 있으니 바로 시작하세요. 크레딧 잔액은 콘솔 Billing 탭에서 확인 가능합니다.
터미널에서 아래 명령어로 SDK를 설치합니다. Python 3.7 이상 필요.
pip install anthropic
✅ 첫 호출 예제 — 간단한 챗 메시지 전송
import anthropic # API 키는 환경변수에서 자동 로드 client = anthropic.Anthropic() message = client.messages.create( model="claude-sonnet-4-5", # 또는 opus / haiku max_tokens=1024, messages=[ { "role": "user", "content": "한국 금융 정책 최신 업데이트 요약해줘." } ] ) print(message.content[0].text) # Claude 응답 출력
⚡ 스트리밍 예제 — 생성 중 실시간 출력 (콘텐츠 제작에 유용)
with client.messages.stream( model="claude-sonnet-4-5", max_tokens=1024, messages=[ { "role": "user", "content": "블로그 스크립트 작성해줘." } ] ) as stream: for text in stream.text_stream: print(text, end="", flush=True) # 생성되는 텍스트를 실시간으로 출력
🎯 시스템 프롬프트 추가 — 일관성 있는 응답 설정
message = client.messages.create( model="claude-sonnet-4-5", max_tokens=1024, system="항상 한국어로, 출처 인용해 응답.", # 시스템 프롬프트 messages=[ {"role": "user", "content": "AI 최신 동향 알려줘."} ] )
더 많은 예제와 파라미터 설명은 https://docs.anthropic.com에서 확인하세요. API Reference, Cookbook, SDK 가이드가 모두 제공됩니다.
📝 시스템 프롬프트
system="항상 한국어로..." 추가로 모든 응답에 일관된 톤·형식·출처 인용 강제 적용 가능
💬 대화 이력 유지
messages 리스트에 이전 user/assistant 응답을 누적하면 멀티턴 대화(문맥 유지) 구현 가능
🖼️ 파일·이미지 업로드
이미지·PDF를 base64 인코딩해 messages에 포함. 비전 모델로 분석·요약 가능
📊 Rate Limit 모니터링
응답 헤더의 x-ratelimit-remaining 값으로 잔여 호출량 실시간 확인 필수
💰 API 비용 (2026년 기준 · 1M 토큰당)
① 콘솔에서 API 키 발급 → ② pip install anthropic → ③ 환경변수 설정 → ④ 기본 예제 실행 확인 → ⑤ Rate Limit 모니터링 설정. 이 순서로 진행하면 5분 안에 첫 API 응답을 받을 수 있습니다.
콘솔 키 발급 → pip install → 첫 호출
스트리밍으로 실시간 출력 · 시스템 프롬프트로 일관성
Haiku→Sonnet→Opus 용도별 모델 선택으로 비용 최적화
공식 문서 docs.anthropic.com · Rate Limit 확인하며 테스트하세요 😊
