Claude API 키 구매 가이드: 공식 결제·키 발급·무료 크레딧 확인법

Claude API 키 문자열을 사는 것이 아닙니다. 한국에서 가장 안전한 기본 경로는 자신이 관리하는 Claude Console 조직에 사용 크레딧을 충전하고, 그 조직의 workspace에서 API 키를 직접 만드는 것입니다. 키는 잔액이나 상품권이 아니라 요청자를 인증하는 비밀 credential입니다.

따라서 구매 결정을 세 줄로 정리할 수 있습니다.

1. 공식 Anthropic API가 필요하면: Claude Console에 가입해 Billing을 설정하고 내 키를 만든다. 한국은 2026년 7월 18일 기준 Anthropic의 지원 국가 목록에 포함되어 있어 이 경로가 우선이다.
2. 클라우드나 호환 게이트웨이를 쓰려면: 그 공급자의 계정·청구·지원·base URL을 별도 계약으로 검토한다. 그곳의 token은 Anthropic Console 키가 아니다.
3. 판매자가 미리 생성한 secret이나 공유 계정만 건네면: 결제하지 않는다. 내가 키를 만들고 폐기할 수 없다면 운영 권한도 내 것이 아니다.

아래 절차는 결제 전 → 공식 결제 → 키 발급 → 한 번의 확인 호출 → 운영·중단 순서로 진행됩니다. 고정된 “신규 가입 $5”나 특정 최소 충전액은 약속하지 않습니다. 실제 계정의 Billing 화면과 현재 공식 문서가 최종 기준입니다.

결제 전 60초 계약·소유권 체크

결제 페이지에서 가격보다 먼저 다음 여덟 항목을 확인하세요. 판매자가 답을 흐리면 가격 비교를 멈추는 편이 안전합니다.

핵심 관계는 단순합니다. route를 고르면 base URL, 청구 주체, 지원 주체가 함께 결정되고, 계정을 내가 통제해야 키 생성·폐기와 지출 통제도 가능합니다. 어느 한쪽도 증명되지 않으면 “싸게 샀다”가 아니라 “누가 비용과 접근권을 쥐고 있는지 모른다”는 뜻입니다.

공식 Claude Console에서 구매하고 키 만드는 순서

한국 사용자가 Anthropic과 직접 계약하려면 이 흐름이 기준입니다.

1. Console 조직과 Billing을 먼저 확인한다

Anthropic의 API access 안내는 API 키를 Claude Console에서 만들도록 안내합니다. 여기서 사용하는 조직은 Claude 웹·앱 채팅 구독과 별개입니다. 회사가 비용을 내는 경우에는 개인 조직을 먼저 만들기보다 누가 조직 소유자이고 누가 청구를 관리할지부터 정하세요.

2. API 사용 크레딧을 충전한다

현재 Anthropic의 API 결제 안내에 따르면 self-serve API와 Workbench는 선불 usage credits 방식입니다. Console의 Settings → Billing에서 크레딧을 구매하며, 잔액이 없으면 API 사용을 계속할 수 없습니다.

구매 전에 네 가지 조건을 함께 읽어야 합니다.

• 구매한 크레딧은 1년 후 만료되며 기간을 연장할 수 없습니다.
• 구매한 크레딧은 환불되지 않습니다. 곧 쓸 양만 충전하는 편이 낫습니다.
• auto-reload는 선택 사항입니다. 켠다면 발동 잔액과 충전 금액을 확인하고 예상치 못한 반복 충전을 감시하세요.
• 실패한 요청은 일반적으로 과금되지 않지만, 성공한 요청과 완료된 작업은 사용량에 따라 과금됩니다. 오류를 “항상 무료”라고 가정해서는 안 됩니다.

모델별 토큰 가격과 Console UI는 바뀔 수 있으므로 결제 직전 공식 pricing 문서를 다시 확인하세요. 이 글은 특정 최소 충전액이나 한국 발급 카드의 승인률을 보장하지 않습니다.

3. 용도별 workspace에서 키를 직접 만든다

production, staging, 개인 실험을 한 키로 섞지 마세요. Anthropic의 workspace 문서에 따르면 API 키는 하나의 workspace에 속하고, workspace에는 조직 전체보다 낮은 spend·rate limit을 둘 수 있습니다. 키를 여러 개 만든다고 잔액이나 무료 한도가 복제되는 것은 아닙니다.

공식 인증 문서에 따라 Console에서 키를 생성하고, 용도를 알아볼 수 있는 이름과 필요한 만료 시간을 선택하세요. 현재 선택지는 3시간, 1일, 7일, 30일, 사용자 지정, 만료 없음입니다. 장기 production 키라도 “만료 없음”을 자동 선택하기보다 교체 주기와 장애 대응자를 먼저 정하는 편이 안전합니다.

secret은 생성 직후 비밀 관리자나 안전한 환경 변수에 저장합니다. repo, .env 예제, 스크린샷, 메신저, 티켓에 넣지 마세요. 전체 값을 다시 보여 달라는 판매자나 지원 담당자의 요청에도 응하지 마세요.

무료 크레딧: 검색 결과가 아니라 내 계정에서 확인한다

검색 결과와 제3자 글에는 “신규 가입자는 $5를 받는다”는 문구가 아직 남아 있지만, 이를 한국의 모든 신규 계정에 대한 현재 보장으로 쓰면 안 됩니다. 2026년 7월 18일 다시 확인한 Anthropic의 공개 access, billing, pricing 페이지는 모든 신규 API 사용자에게 starter credit을 지급한다고 약속하지 않습니다. 현재 billing 안내는 API 사용 전에 크레딧을 구매하는 절차를 기본 흐름으로 제시합니다.

특정 조직에 프로모션이나 테스트 잔액이 보일 가능성까지 부정할 필요는 없습니다. 다만 그것은 해당 조직 화면에 금액, 만료일, 용도가 표시될 때만 확인된 account-specific 조건이며, 공개 무료 티어로 일반화할 수 없습니다.

그래서 확인 순서는 하나뿐입니다.

1. 내 Claude Console 조직의 Billing 또는 Credit Balance를 연다.
2. 실제 잔액, 만료일, 프로모션 조건이 표시되는지 확인한다.
3. 잔액이 없으면 무료 credit을 전제로 배포하지 않고 필요한 만큼만 충전한다.
4. 제3자 글의 $5 숫자와 내 계정 화면이 다르면 내 계정과 공식 지원 답변을 따른다.

무료 credit이 보여도 production 예산으로 간주하지 마세요. 테스트 가능 여부와 지속적인 서비스 운영 가능 여부는 다른 질문입니다.

Pro·Max를 결제했는데 API를 또 사야 하나

일반적인 답은 그렇습니다. Anthropic의 구독·API 분리 안내는 Claude Pro, Max, Team, Enterprise 채팅 구독에 Claude Console API credits가 포함되지 않는다고 설명합니다.

Claude Code에는 구독 로그인과 API 키 사용이 모두 보여 더 혼란스러울 수 있습니다. 어떤 인증 경로가 실제로 과금되는지는 Claude Code API 키와 구독 과금 비교에서 확인하세요. 이 글의 범위에서는 채팅 구독료를 냈다 = 일반 Console API 잔액이 생겼다고 판단하지 않으면 됩니다.

구매 후 딱 한 번, 작고 추적 가능한 호출로 확인한다

키를 만든 뒤 바로 큰 애플리케이션에 넣지 마세요. 먼저 별도의 테스트 workspace에서 출력 상한을 작게 둔 한 번의 요청으로 route와 usage 기록을 확인합니다. 아래 예시는 현재 Console에서 발급한 ANTHROPIC_API_KEY를 환경 변수에 넣었다는 전제입니다. 명령 기록이나 화면 공유에 실제 secret을 남기지 마세요.

bash
curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-haiku-4-5-20251001",
    "max_tokens": 8,
    "messages": [{"role": "user", "content": "Reply only with OK"}]
  }'

이 요청은 무료 보장이 아니라 실제 한 번의 소액 과금 가능 호출입니다. 성공 응답을 받으면 다음 세 가지만 확인하고 반복 실행을 멈추세요.

• 요청 host가 선택한 계약의 host와 같은가? 공식 direct라면 api.anthropic.com이어야 합니다.
• Console의 해당 workspace Usage에 한 건이 기록되는가?
• 응답의 model 값이 요청한 route와 일치하며, 키를 폐기했을 때 다음 요청이 거부되는가?

모델 ID가 더 이상 현재 Console에서 제공되지 않으면 코드를 억지로 유지하지 말고 Models 문서에서 현재 ID를 골라 한 번만 다시 확인하세요. 애플리케이션 연결 단계는 Claude API 키 설정 가이드로 이어가면 됩니다.

공식 direct가 아닌 경로는 언제 선택하나

공식 Console이 기본값이지만, 조직이 이미 클라우드 IAM·통합 청구·조달을 표준화했다면 지원되는 cloud route가 더 맞을 수 있습니다. 이 경우 Anthropic Console 잔액은 cloud 계정으로 이전되지 않으며, 인증·청구·지원은 해당 클라우드 계약을 따릅니다. Anthropic의 AWS 경로 안내처럼 각 route 문서를 따로 확인해야 합니다.

OpenAI 호환 endpoint와 여러 모델 전환이 필요한 개발자는 별도 gateway를 검토할 수 있습니다. 예를 들어 LaoZhang AI는 2026년 7월 18일 확인 기준 자체 balance와 token, https://api.laozhang.ai/v1 base URL을 사용하는 별도 다중 모델 공급자입니다. 시작 문서의 신규 계정 $0.5 테스트 credit은 연결·개발 확인용이지 production 예산이 아니며, Anthropic credit이나 공식 Claude API 키로 바뀌지 않습니다.

같은 문서는 development testing, internal tools, production integration을 구분하고 Console의 credit/billing 상태를 확인한 뒤, production 사용이나 enterprise procurement 전에 support에 연락하라고 안내합니다. 운영 자금을 넣기 전 계정 경로, 결제, 한도, 인보이스/계약, support owner를 확인하고 하나라도 확정할 수 없으면 충전을 중단하세요.

이 선택이 맞는 조건은 OpenAI 호환 형식과 모델 전환이 실제 요구사항이고, 별도 공급자의 데이터·지원·청구 계약을 수용할 때입니다. Anthropic 고유 기능, 원청구서, 원지원, 조직 통제가 필요하면 공식 direct 또는 승인된 cloud에서 멈추세요. 더 깊은 비교는 Claude API 경로 선택 가이드를 참고할 수 있습니다.

결제가 안 되거나 키가 의심스러울 때의 중단 규칙

결제 실패를 이유로 바로 marketplace secret을 사지 마세요. 먼저 문제를 좁힙니다.

1. 가입 국가가 현재 지원 목록에 있고, 로그인한 계정이 올바른 Console 조직인지 확인한다.
2. 채팅 구독 페이지가 아니라 Console Billing인지, 조직에서 결제를 관리할 권한이 있는지 확인한다.
3. balance, 결제 수단 상태, auto-reload 실패 알림을 확인한다.
4. 금액·카드·세금 문제는 추측하지 말고 Anthropic 공식 support에 계정별 상태를 문의한다.

누군가 secret을 이미 보았거나 repo·로그·채팅에 노출됐다면 거래 신뢰도를 평가하는 데 시간을 쓰지 말고 즉시 폐기하세요. Anthropic의 유출 대응 안내에 따라 해당 키를 revoke하고 새 키로 교체한 뒤 Usage에서 비정상 요청을 확인합니다. 단순히 문자열을 바꾸지 않고 같은 키를 계속 쓰는 것은 대응이 아닙니다.

마지막 구매 기준은 가격이 아니라 통제권입니다. 내가 provider 계정, 청구, 키 생성, 폐기, 사용량을 확인할 수 있으면 계약을 진행하고, 그중 하나라도 판매자만 통제하면 결제를 중단하세요.