API라는 단어 자체가 낯선 분들도 있을 겁니다. 실제로 클로드 API 준비 과정은 세 단계입니다. 키 발급, SDK 설치, 코드 실행 한 블록. 이 글은 그 세 단계를 처음 해보는 사람 기준으로 구체적으로 풀어냅니다.
클로드 API란 — 웹 버전과 무엇이 다른가
클로드 API는 api.anthropic.com을 통해 Claude 모델에 프로그래밍 방식으로 접근하는 인터페이스다. claude.ai에서 대화창으로 쓰는 것과 달리, API를 쓰면 자신의 앱이나 스크립트에서 Claude를 직접 호출할 수 있다.
구체적으로 이런 상황에서 쓴다.
- 자동화: 매일 반복되는 텍스트 요약·분류 작업을 스크립트로 처리
- 서비스 통합: 사내 시스템이나 개인 프로젝트에 AI 응답 기능 추가
- 대량 처리: 수백 개 문서를 한 번에 분석하거나 변환
claude.ai Pro 구독과는 완전히 별개다. API는 종량제(pay-as-you-go)로, 사용한 토큰 수만큼만 요금이 청구된다. 구독 불필요, 사용한 만큼만 낸다. 클로드 무료 버전 Pro 기능 비교 글과 함께 보면 내 상황에 맞는 선택을 하는 데 도움이 된다.
API 키 발급 — console.anthropic.com 5단계
클로드 API를 쓰려면 먼저 키가 있어야 한다. Anthropic 콘솔에서 5분 안에 발급된다.
- console.anthropic.com 접속 — 구글 계정이나 이메일로 가입한다.
- 전화번호 인증 — 본인 인증을 완료하면 무료 체험 크레딧이 지급된다. 정확한 금액은 가입 시 콘솔에서 직접 확인한다.
- 결제 수단 등록 — Billing 메뉴에서 카드를 추가한다. 선불 충전이 아닌 사용 후 청구 방식이다.
- API 키 생성 — 좌측 “API Keys” → “Create Key” 클릭 후 이름을 입력한다.
dev-test처럼 용도가 드러나는 이름이 나중에 편하다. - 키 즉시 복사·저장 — 창을 닫으면 다시 볼 수 없다. 패스워드 매니저나 안전한 로컬 파일에 보관한다.
API 키는 절대 GitHub 저장소, 노션 공개 페이지, 메신저에 붙여넣지 않는다. 유출됐다면 콘솔에서 해당 키를 즉시 삭제하고 새로 발급해야 한다. 프로젝트별로 키를 분리해 두면 관리와 비용 추적이 훨씬 쉬워진다.
파이썬 SDK 설치와 환경 변수 설정
Anthropic은 공식 Python SDK를 제공한다. 터미널에서 한 줄이면 설치된다.
pip install anthropic설치 후에는 API 키를 환경 변수로 등록한다. 코드에 직접 쓰면 실수로 공유되는 사고가 생긴다.
윈도우 (PowerShell):
$env:ANTHROPIC_API_KEY = "sk-ant-여기에키입력"맥·리눅스 (zsh / bash):
export ANTHROPIC_API_KEY="sk-ant-여기에키입력"재시작 후에도 유지하고 싶다면 ~/.zshrc 또는 ~/.bashrc 파일 마지막 줄에 같은 내용을 추가한다. 윈도우는 시스템 환경 변수 설정에서 영구 등록할 수 있다.
첫 번째 API 호출 코드 — 복사해서 바로 실행
아래 코드를 새 파일(hello_claude.py)에 붙여넣고 실행한다. 환경 변수만 올바르게 설정돼 있으면 바로 작동한다.
import anthropic
client = anthropic.Anthropic() # 환경 변수에서 키 자동 로딩
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[
{"role": "user", "content": "안녕하세요. 클로드 API 첫 테스트입니다."}
]
)
print(message.content[0].text)터미널에서 python hello_claude.py를 실행하면 Claude의 답변이 출력된다. 여기까지 성공했다면 연동 자체는 완료된 거다.
이후엔 messages 리스트에 대화를 누적해 멀티턴 대화를 구현하거나, system 파라미터로 Claude에게 역할을 부여하는 식으로 확장한다. 구조는 단순하기 때문에 첫 실행에 성공하고 나면 응용이 빠르다.
모델 선택 기준 — 비용과 성능 사이에서 고르는 법
Claude API에는 용도에 따라 선택할 수 있는 여러 모델이 있다. 모든 모델은 한국어를 지원하며 텍스트·이미지 입력이 가능하다.
| 모델 ID | 적합한 용도 | 비용 수준 |
|---|---|---|
claude-opus-4-8 | 복잡한 추론, 장기 에이전트 작업 | 높음 (공식 페이지 확인) |
claude-opus-4-7 | 고난이도 코딩, 깊이 있는 분석 | 입력 $5 / 1M 토큰 |
claude-sonnet-4-6 | 일반 업무 자동화, 문서 처리 | 중간 (공식 페이지 확인) |
claude-haiku-4-5 | 빠른 응답, 반복 대량 처리 | 낮음 (공식 페이지 확인) |
초보 단계에서는 claude-sonnet-4-6 또는 claude-haiku-4-5로 시작해 요금 감각을 먼저 익히는 쪽이 낫다. Opus 계열은 성능이 높지만 토큰당 비용도 그에 비례한다. 정확한 최신 단가는 docs.anthropic.com의 Pricing 페이지에서 확인한다.
① Message Batches API: 같은 요청을 묶어서 처리하면 비용이 50% 줄어든다. 대량 처리 작업에 적합하다.
② 프롬프트 캐싱: 동일한 긴 프롬프트를 반복 호출할 때, 이전에 처리한 부분을 캐시에서 읽어 비용을 크게 아낄 수 있다.
자주 묻는 질문
Q. 클로드 API를 무료로 사용할 수 있나요?
신규 가입 시 무료 체험 크레딧이 제공된다. 크레딧이 소진되면 결제 수단이 있어야 계속 사용할 수 있으며, 무료 영구 요금제는 없다. 현재 제공 크레딧 금액은 시기마다 다를 수 있으므로 가입 시 콘솔에서 직접 확인한다.
Q. claude.ai Pro 구독과 API는 같은 건가요?
별개 서비스다. claude.ai Pro는 웹·앱 인터페이스 구독이고, API는 직접 호출 방식의 종량제 서비스다. 둘을 함께 사용해도 되고 API만 단독으로 써도 된다. 구독 없이 API만 쓰는 개발자도 많다.
Q. 파이썬 말고 다른 언어로도 사용할 수 있나요?
가능하다. Anthropic은 Python SDK와 TypeScript SDK를 공식 지원한다. 그 외 언어는 HTTP 요청으로 REST API를 직접 호출하면 되며, API 구조가 단순해 별도 SDK 없이도 어렵지 않다.
지금 바로 시작하는 체크리스트
정리하면 세 단계다. console.anthropic.com에서 API 키 발급 → pip install anthropic으로 SDK 설치 → 예제 코드 실행. 이 과정 자체는 30분이면 충분하다.
혹시 메시지 사용량이 걱정된다면 클로드 일일 메시지 제한 풀기 글도 참고하면 좋다. API와 웹 버전의 한도 구조가 다르기 때문에 두 가지를 비교해두면 나중에 판단이 쉬워진다.