코드에서 클로드를 부르려면 API 키가 필요합니다. API는 claude.ai 구독(Pro 등)과 완전히 별개인 종량제로, 쓴 만큼만 토큰 단위로 과금됩니다. 이 글은 키를 어디서 어떻게 발급받고, 요금이 얼마이며, 키를 안전하게 관리하는 법을 정리합니다. (실제 첫 호출 코드는 API 시작 가이드를 참고하세요.)
🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당
2026년 9월 27일 업데이트: 2026년 9월 22일 Claude Opus 5.5가 출시되어 현행 Opus 모델이 됐습니다(API claude-opus-5-5, 입력 100만 토큰당 $4·출력 $20 — Opus 5의 $5/$25보다 낮음). Anthropic은 대부분의 작업에서 Fable 5.1 수준 성능을 내면서 일반 작업 기준 Opus 5보다 40% 저렴하다고 밝혔습니다. Opus 5는 계속 제공되지만 공식 모델 문서에서 레거시로 표기됩니다. 아래 본문의 Opus 5 가격·비교 서술은 발표 이전 기준이며 순차 갱신 예정입니다. 자세한 내용: Claude Opus 5.5 완벽 가이드.
구독과 API는 다릅니다
가장 헷갈리는 부분입니다. Claude Pro($20/월)는 API 사용량을 포함하지 않습니다. API는 월 구독이 아니라 종량제(pay-as-you-go)로, 보낸 입력 토큰과 받은 출력 토큰만큼 과금됩니다. 아무것도 호출하지 않으면 비용도 0입니다.
API 키 발급 단계
- platform.claude.com에 가입/로그인합니다(개발자용 콘솔). 신규 계정에는 보통 소액의 무료 크레딧이 제공되지만, 금액·조건은 변동될 수 있습니다.
- 결제 수단을 등록하고 크레딧을 충전합니다. 신규 계정은 프리페이드 크레딧으로 시작하며, 자동 충전(auto-reload)을 켤 수 있습니다. 사용량이 많아지면 월 청구 방식으로 전환할 수 있습니다.
- API Keys 메뉴에서 새 키를 생성합니다. 키 값은 생성 시 한 번만 표시되는 경우가 많으니 안전한 곳에 즉시 보관하세요.
모델별 요금
요금은 입력 토큰(보낸 프롬프트·맥락)과 출력 토큰(클로드의 답변)을 따로 계산하며, 모든 현행 모델에서 출력이 입력의 5배입니다. 아래는 2026년 9월 28일 공식 가격표(platform.claude.com) 기준 현행 모델 요금입니다(단위: 100만 토큰당 미국 달러).
| 모델 | 입력 | 출력 | 캐시 읽기 | Batch(입력/출력) | 어울리는 작업 |
|---|---|---|---|---|---|
| Haiku 4.5 | $1 | $5 | $0.10 | $0.50 / $2.50 | 분류·추출·요약 같은 대량·단순 작업 |
| Sonnet 5 | $2 | $10 | $0.20 | $1 / $5 | 대부분의 코딩·에이전트·도구 사용 |
| Opus 5.5 | $4 | $20 | $0.20 | $2 / $10 | 복잡한 코딩·추론·긴 에이전트 작업 |
| Fable 5.1 | $10 | $50 | $0.25 | $5 / $25 | 가장 어려운 추론(최상위 모델) |
- Haiku 4.5($1/$5): 가장 저렴. 분류·추출·요약 등 대량·단순 작업에 적합.
- Sonnet 5($2/$10): 2026년 6월 30일 출시된 현행 Sonnet 모델. 에이전트 작업, 코딩, 도구 사용 능력이 전작 Sonnet 4.6보다 크게 향상되었으며, 성능 대비 가격 균형이 뛰어납니다. API에서는
claude-sonnet-5로 호출합니다. - Opus 5.5($4/$20): 현행 Opus 모델(2026년 9월 22일 출시). 복잡한 코딩·추론·에이전트 작업용. API에서는
claude-opus-5-5로 호출합니다. 이보다 상위 모델은 Fable 5.1입니다.
비용 줄이기
- 프롬프트 캐싱: 반복되는 긴 프리픽스를 캐시하면 캐시 읽기 단가가 기본 입력 단가의 0.1배(Opus 5.5는 0.05배)로 내려갑니다.
- 배치(Batch) API: 급하지 않은 작업을 일괄 처리하면 50% 할인.
- 작업에 맞는 모델을 쓰세요. 단순 작업까지 Opus로 보내는 건 과지출의 흔한 원인입니다. 캐싱과 배치를 함께 쓰면 효과가 큽니다.
사용량 한도(rate limit)
API에는 분당 요청·토큰 한도가 있으며, 결제·사용 이력에 따라 단계적으로 상향됩니다(티어). 구체 수치는 콘솔의 한도 페이지에서 확인하세요. 한도를 넘으면 429 오류가 반환됩니다.
키 보안 — 꼭 지키세요
- 키는 환경변수로 관리하세요. 예:
export ANTHROPIC_API_KEY="sk-ant-..." - 코드·깃(GitHub)에 키를 커밋하지 마세요. 공개 저장소에 올라가면 즉시 도용될 수 있습니다.
- 키를 주기적으로 교체하고, 노출이 의심되면 콘솔에서 즉시 폐기 후 재발급하세요.
- 프런트엔드(브라우저) 코드에 키를 넣지 마세요. 서버에서만 호출하세요.
다음 단계
키를 발급했다면 API 시작 가이드에서 첫 호출(요청·응답) 방법을 확인하세요. 결제·키 관련 문제는 platform.claude.com 콘솔과 공식 문서에서 해결할 수 있습니다.
관련 글: 요금제·구독 가이드 · 사용량 한도 가이드 · 무료 플랜 가이드
내 사용량 기준 예상 비용이 궁금하다면 API 비용 계산기에서 모델과 토큰 수를 넣어 바로 계산해볼 수 있습니다.