목록 · 가이드

클로드 API 사용법, 키 발급부터 첫 호출까지NEW

도도리가 직접 확인하고 정리했습니다 · 2026-09-03 기준으로 확인

Claude API는 내가 만드는 프로그램 안에서 Claude를 부르는 통로입니다. claude.ai 화면에 사람이 앉아서 묻는 것이 아니라, 코드가 대신 묻고 답을 받아 갑니다. 챗봇을 붙이거나, 들어온 문의를 자동으로 분류하거나, 문서 수백 건을 한 번에 요약할 때 씁니다.

구독료와 API 요금은 별개입니다

가장 많이 어긋나는 지점입니다. Pro나 Max를 결제하고 있어도 API는 따로 돈을 냅니다. 반대로 API만 쓰려고 구독을 할 필요도 없습니다. 두 개는 청구서가 아예 다릅니다.

그래서 "구독했는데 왜 키가 없나요"라는 질문이 나옵니다. 키는 구독과 다른 곳에서 발급받습니다.

키를 받는 순서

Anthropic 콘솔에서 받습니다. claude.ai와는 다른 사이트입니다. 계정을 만들고, 결제 수단을 등록하고, API Keys 화면에서 키를 발급합니다. 결제 수단을 넣지 않으면 호출이 막힙니다.

첫 호출

터미널에서 바로 확인해 볼 수 있습니다. 아래 한 덩어리를 붙여 넣으면 답이 돌아옵니다. ANTHROPIC_API_KEY에 발급받은 키를 먼저 넣어 두십시오.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "한 문장으로 자기소개를 해줘"}
    ]
  }'

파이썬이면 공식 라이브러리를 씁니다. pip install anthropic으로 깔고, 키는 환경변수에서 알아서 읽어 갑니다.

import anthropic

client = anthropic.Anthropic()

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "한 문장으로 자기소개를 해줘"}
    ],
)
print(msg.content[0].text)

max_tokens는 빼면 안 됩니다. 답이 길어질 수 있는 작업인데 이 값을 작게 잡으면 문장 중간에서 잘려 나옵니다. 분류처럼 짧은 답만 받는 게 아니라면 넉넉히 잡으십시오.

어떤 모델을 고르나

이름이 아니라 모델 ID를 코드에 적습니다. 값이 비슷하면 싼 쪽부터 시험해 보고, 결과가 모자랄 때 올리는 편이 낫습니다.

100만 토큰당 미국 달러입니다. 2026년 9월 3일에 확인한 값이고, 요금은 예고 없이 바뀝니다. 결제 전에는 반드시 공식 요금 페이지에서 다시 보십시오. Sonnet 5는 도입 가격이 8월 31일에 끝나 오를 예정이었는데, 8월 10일에 그 가격이 그대로 정가가 된다고 발표됐습니다. 값이 이렇게 뒤집히는 항목이라 특히 그렇습니다.

자주 하는 실수가 하나 있습니다. 모델 ID 뒤에 날짜를 붙이지 마십시오. claude-sonnet-5-20260630 같은 형태로 쓰면 오류가 납니다. 위 표의 문자열이 그대로 완성된 값입니다.

요금을 줄이는 세 가지

API는 쓴 만큼 나가기 때문에, 같은 결과를 더 싸게 받는 방법이 곧 돈입니다. 순서대로 효과가 큽니다.

첫째, 프롬프트 캐싱. 매번 똑같이 들어가는 앞부분이 있으면 그걸 캐시로 잡아 둡니다. 긴 지시문이나 참고 문서를 매 요청마다 새로 보내는 구조라면 반복되는 입력 비용을 크게 줄일 수 있습니다. 주의할 점은 앞에서부터 한 글자라도 달라지면 그 뒤가 전부 무효가 된다는 것입니다. 지시문 안에 현재 시각이나 요청 번호를 넣어 두면 캐시가 매번 깨집니다. 바뀌는 값은 뒤로 몰아야 합니다.

둘째, 배치. 지금 당장 답이 필요하지 않은 일이라면 배치로 보냅니다. 요금이 절반입니다. 밤사이 문서 수천 건을 요약하는 작업처럼 기다려도 되는 일이 여기 해당합니다.

셋째, 모델 고르기. 표에서 보듯 Haiku와 Fable은 열 배 차이입니다. 분류나 태그 달기처럼 단순한 일에 가장 비싼 모델을 쓰고 있지 않은지 보십시오. 반대로 판단이 어려운 일을 싼 모델에 맡기면 다시 시키느라 오히려 더 나갑니다.

자주 묻는 질문

이어서 보기