Claude API 키 발급 방법 (2026년 가이드)

빠른 답변: Claude API 키를 받는 세 단계

Anthropic에서 Claude API 키를 받으려면: console.anthropic.com에서 계정을 만들고, Plans and billing에서 선불 크레딧을 구매한 뒤(신용카드 또는 체크카드 필요), Settings로 이동해 API Keys를 열고 Create Key를 클릭하세요. 키는 sk-ant-로 시작하며 정확히 한 번만 표시되므로 즉시 비밀번호 관리자나 환경 변수에 복사해두세요. 두 가지가 사람들을 헷갈리게 합니다. 첫째, Claude Pro나 Max 채팅 구독에는 API 접근이 포함되지 않습니다. Console은 청구가 분리된 별개의 제품입니다. 둘째, 키 생성 자체는 결제 없이도 되지만, 실제로 크레딧을 구매하기 전까지 요청은 크레딧 오류로 실패합니다. 첫 호출에서 잔액 관련 오류가 나온다면 바로 이 이유 때문입니다. 카드를 등록할 수 없거나, Claude와 다른 모델 계열까지 하나의 키로 이용하고 싶다면 선불 게이트웨이가 현실적인 대안입니다. 이 방법은 이 가이드의 마지막에서 트레이드오프와 함께 솔직하게 다룹니다.

1단계: Anthropic Console 계정 만들기

console.anthropic.com의 Console은 Anthropic의 개발자 대시보드이며 claude.ai 채팅 앱과는 별개입니다. 이메일 주소나 Google 계정으로 가입하세요. Anthropic은 온보딩 중 전화번호 인증을 요구하며, API 접근은 지원 국가로 제한되어 있으니 가입 과정에서 이 단계가 막힌다면 Anthropic의 지원 지역 목록을 확인하세요. 설정 중에 조직(organization)을 만들게 됩니다. 키, 크레딧, 레이트 리밋, 사용 로그는 모두 개인 로그인이 아닌 조직에 귀속됩니다. 나중에 팀원을 초대할 때 이 점이 중요해지는데, 모두가 같은 크레딧 풀을 공유하고 관리자는 키별로 나뉜 사용량을 볼 수 있습니다. 이 단계에서는 아직 아무 비용도 발생하지 않습니다. 결제 정보를 등록하기 전에도 모델 목록을 살펴보고, API 레퍼런스를 읽고, Workbench(Claude 모델에 프롬프트를 테스트해볼 수 있는 브라우저 플레이그라운드)를 열어볼 수 있습니다. 통합 코드를 한 줄도 쓰기 전에 프롬프트가 기대한 대로 동작하는지 확인하는 데 Workbench가 유용합니다.

2단계: 첫 요청 전에 결제 설정하기

Anthropic의 API는 선불제입니다. Plans and billing에서 카드를 등록하고 초기 크레딧 묶음을 구매하세요. 최소 구매 금액은 소액이며 역사적으로 5달러였습니다. 모든 API 호출은 토큰당 요금으로 이 잔액에서 차감되므로 월말에 놀랄 만한 청구서가 나오지 않습니다. 잔액이 0이 되면 요청이 중단됩니다. 첫날부터 설정해둘 만한 옵션이 두 가지 있습니다. Auto-reload는 설정한 임계값 아래로 잔액이 떨어지면 자동으로 충전합니다. 프로덕션 워크로드라면 활성화해서 잔액 소진이 장애로 이어지지 않도록 하세요. 실험용이라면 꺼두는 편이 나은데, 폭주하는 루프가 의도적으로 충전한 금액 이상을 쓰지 못하게 막을 수 있습니다. 레이트 리밋은 사용량 티어에 따라 확장됩니다. 신규 조직은 가장 낮은 티어로 시작하며, 분당 요청 수와 분당 토큰 수 리밋은 누적 지출이 늘어날수록 상승합니다. 신생 계정에서 트래픽이 몰릴 때 429 응답을 본다면, 대개 코드 문제가 아니라 티어 체계 때문입니다.

3단계: 키 생성 후 첫 호출하기

Console에서 Settings, 그다음 API Keys, 그다음 Create Key로 이동하세요. 키에는 어떤 앱이나 환경에 속하는지 알 수 있는 이름을 붙이세요. 결국 여러 개를 갖게 될 텐데, 이름 없는 키는 나중에 감사하기가 불가능해집니다. 전체 키 값은 생성 시점에만 표시되며, 다이얼로그를 닫은 뒤에는 Console에 잘린 버전만 나타납니다. 키를 환경 변수로 내보내고 애플리케이션 코드를 건드리기 전에 터미널에서 먼저 테스트하세요. 다른 프로바이더에서 넘어온 사람들이 걸려 넘어지는 Anthropic 특유의 세부 사항이 두 가지 있습니다. 인증은 Authorization: Bearer가 아니라 x-api-key 헤더를 사용하고, 모든 요청에는 anthropic-version 헤더가 반드시 포함되어야 합니다. version 헤더가 없으면 명확한 오류 메시지와 함께 실패하므로, 뭔가 깨졌을 때는 응답 본문을 읽어보세요.

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-4-6",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

키 보안: 나쁜 한 주를 막아주는 다섯 가지 습관

이런 습관은 첫날에 들이면 저렴하고, 사고가 난 뒤에 소급 적용하려면 비쌉니다. 실수로 키를 커밋했다면 비공개 저장소라도 유출된 것으로 취급하세요. 폐기하고, 로테이션하고, 커밋 이력을 지우세요. 사전 커밋 훅에 gitleaks 같은 시크릿 스캐너를 걸어두면 실수가 내 컴퓨터를 벗어나기 전에 잡아냅니다.

• 환경 변수나 시크릿 매니저만 사용하세요. 소스 코드에 붙여넣은 키는 결국 커밋되기 마련이고, 스크레이퍼는 공개 저장소에서 sk-ant- 접두사를 구체적으로 감시합니다.
• 앱과 환경마다 별도의 키를 쓰세요. 개발, 스테이징, 프로덕션을 분리한 키는 사용 로그를 읽기 쉽게 만들고, 다른 곳을 깨뜨리지 않고 한 표면만 폐기할 수 있게 해줍니다.
• 브라우저나 모바일 코드에 절대 키를 포함하지 마세요. 클라이언트 사이드 JavaScript에 들어간 것은 정의상 공개됩니다. 호출은 자체 백엔드를 경유시키고 키는 서버 사이드에 두세요.
• 유출이 의심되면 즉시 폐기하세요. Console에서 키를 삭제하면 즉시 무효화됩니다. 로테이션 중에도 앱이 계속 떠 있어야 한다면 교체할 키를 먼저 만들어두세요.
• 지출 알림을 설정하세요. 청구 임계값 알림은 유출되거나 폭주하는 키를 큰 청구서 대신 작은 청구서로 바꿔주며, 설정 비용은 전혀 들지 않습니다.

Claude 호출 비용, 더 저렴한 자리와 나란히

Claude는 토큰 단위로 청구되며 입력과 출력 요금이 분리되어 있고, 장문 생성에서는 출력 토큰이 청구서를 지배합니다. 헤드라인 입력 가격만 볼 게 아니라 두 열을 모두 비교하세요. 규모 감을 잡을 수 있도록 아래 표는 Claude를 다음 섹션에서 설명하는 게이트웨이 카탈로그를 통해 이용 가능한 다른 모델들과 나란히 놓았습니다. DeepSeek는 대량 저가 트래픽에서 커뮤니티가 대체로 선호하는 선택이고, 글쓰기 품질이 우선순위일 때는 여전히 Claude가 픽입니다.

카드가 없다면? 게이트웨이로 작동하는 키 받기

카드 요구 사항, 지역 차단, 혹은 계정 개설 자체가 걸림돌이라면 APIsRouter가 이 사이트에서 다루는 게이트웨이 경로입니다. OpenAI 호환 게이트웨이로, /topup의 결제에는 가입이 필요 없고, 먼저 지불하면 키가 이메일로 도착합니다. 청구는 구독 없는 사용량 기반이며, 글로벌 모델은 공식 정가 대비 20% 저렴하고, 중국 모델은 공식 요금보다 낮게 책정되어 있으며, 첫 충전 시 잔액에 100%가 추가됩니다. 원하는 OpenAI SDK를 https://api.apisrouter.com/v1로 지정하고 카탈로그 모델 ID를 전달하세요. Claude 계열은 claude-sonnet-4-6나 claude-opus-4-7, 같은 키에서 더 저렴한 토큰을 원한다면 deepseek-v4-flash나 glm-5입니다. 같은 키는 최종 사용자용 앱에서도 작동합니다. SillyTavern 사용자는 /v1로 끝나는 base URL을 붙여넣으면 모델 목록이 /v1/models에서 자동으로 채워집니다. JanitorAI는 전체 엔드포인트 https://api.apisrouter.com/v1/chat/completions와 모델 이름, 키가 필요합니다. Anthropic 직접 키와 비교한 트레이드오프는 정직하고 단순합니다. 트래픽을 중개자에게 맡기게 되며, Anthropic 쪽 기능은 게이트웨이의 일정에 맞춰 도착합니다. 대신 얻는 것은 Claude, GPT, Gemini, DeepSeek, GLM에 걸쳐 프로바이더별 청구 계정 대신 하나의 잔액과 하나의 엔드포인트입니다.

from openai import OpenAI

client = OpenAI(
    api_key="sk-...",  # 결제 후 이메일로 도착
    base_url="https://api.apisrouter.com/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Say hello in five words."}],
)
print(response.choices[0].message.content)

자주 묻는 질문