코드에서 클로드를 부르려면 API 키가 필요합니다. API는 claude.ai 구독(Pro 등)과 완전히 별개인 종량제로, 쓴 만큼만 토큰 단위로 과금됩니다. 이 글은 키를 어디서 어떻게 발급받고, 요금이 얼마이며, 키를 안전하게 관리하는 법을 정리합니다. (실제 첫 호출 코드는 API 시작 가이드를 참고하세요.)
구독과 API는 다릅니다
가장 헷갈리는 부분입니다. Claude Pro($20/월)는 API 사용량을 포함하지 않습니다. API는 월 구독이 아니라 종량제(pay-as-you-go)로, 보낸 입력 토큰과 받은 출력 토큰만큼 과금됩니다. 아무것도 호출하지 않으면 비용도 0입니다.
API 키 발급 단계
- platform.claude.com에 가입/로그인합니다(개발자용 콘솔). 신규 계정에는 보통 소액의 무료 크레딧이 제공되지만, 금액·조건은 변동될 수 있습니다.
- 결제 수단을 등록하고 크레딧을 충전합니다. 신규 계정은 프리페이드 크레딧으로 시작하며, 자동 충전(auto-reload)을 켤 수 있습니다. 사용량이 많아지면 월 청구 방식으로 전환할 수 있습니다.
- API Keys 메뉴에서 새 키를 생성합니다. 키 값은 생성 시 한 번만 표시되는 경우가 많으니 안전한 곳에 즉시 보관하세요.
모델별 요금
요금은 입력 토큰(보낸 프롬프트·맥락)과 출력 토큰(클로드의 답변)을 따로 계산하며, 모든 현행 모델에서 출력이 입력의 약 5배입니다. 2026년 5월 기준 권장 3종은 위 표와 같습니다.
- Haiku 4.5($1/$5): 가장 저렴. 분류·추출·요약 등 대량·단순 작업에 적합.
- Sonnet 4.6($3/$15): 성능 대비 가격 균형이 좋아 일반 작업에 무난.
- Opus 4.7·4.8($5/$25): 가장 고성능. 복잡한 코딩·추론·에이전트 작업용. (Opus 4.8이 최신)
비용 줄이기
- 프롬프트 캐싱: 반복되는 긴 프리픽스를 캐시하면 캐시된 입력에서 최대 90% 절감.
- 배치(Batch) API: 급하지 않은 작업을 일괄 처리하면 50% 할인.
- 작업에 맞는 모델을 쓰세요. 단순 작업까지 Opus로 보내는 건 과지출의 흔한 원인입니다. 캐싱과 배치를 함께 쓰면 효과가 큽니다.
사용량 한도(rate limit)
API에는 분당 요청·토큰 한도가 있으며, 결제·사용 이력에 따라 단계적으로 상향됩니다(티어). 구체 수치는 콘솔의 한도 페이지에서 확인하세요. 한도를 넘으면 429 오류가 반환됩니다.
키 보안 — 꼭 지키세요
- 키는 환경변수로 관리하세요. 예:
export ANTHROPIC_API_KEY="sk-ant-..." - 코드·깃(GitHub)에 키를 커밋하지 마세요. 공개 저장소에 올라가면 즉시 도용될 수 있습니다.
- 키를 주기적으로 교체하고, 노출이 의심되면 콘솔에서 즉시 폐기 후 재발급하세요.
- 프런트엔드(브라우저) 코드에 키를 넣지 마세요. 서버에서만 호출하세요.
다음 단계
키를 발급했다면 API 시작 가이드에서 첫 호출(요청·응답) 방법을 확인하세요. 결제·키 관련 문제는 platform.claude.com 콘솔과 공식 문서에서 해결할 수 있습니다.