Anthropic (Claude) API 키

Anthropic Claude API 키를 발급하려면 platform.claude.com의 Claude Console에 로그인하고 Settings → API keys를 연 다음 Create Key를 클릭하세요. Anthropic API 키는 sk-ant-로 시작하며 생성할 때 한 번만 표시됩니다. Anthropic 콘솔은 console.anthropic.com에서 platform.claude.com으로 이전했으며, 키 페이지는 이제 platform.claude.com/settings/keys에 있습니다. Anthropic API 키는 https://api.anthropic.com에 요청할 때 x-api-key 헤더와 anthropic-version 헤더를 사용해 인증합니다. Authorization: Bearer는 사용하지 않습니다. Anthropic의 가격 FAQ에 따르면 신규 사용자는 API 테스트를 위한 소량의 무료 크레딧을 받습니다. 해당 크레딧 외에 무료 요금제는 없으므로 초기 크레딧을 모두 사용하면 Claude API 사용량에 토큰별 요금이 청구됩니다.

Kunavo는 독립적인 OpenAI 호환 AI API 게이트웨이입니다. 하나의 API 키와 종량제 잔액으로 Claude, GPT, 이미지, 비디오, 오디오 모델을 이용할 수 있으며, 제공자별 계정은 필요하지 않습니다. Kunavo API 키는 sk-kn-로 시작하며 kunavo.com/app/keys에서 생성할 수 있고 Anthropic 계정은 필요하지 않습니다. Kunavo는 OpenAI 호환 엔드포인트 https://api.kunavo.com/v1/chat/completions와 네이티브 Anthropic 엔드포인트 https://api.kunavo.com/v1/messages 모두를 통해 Claude를 제공합니다. 따라서 공식 OpenAI SDK로 Claude를 사용하려면 base_url만 바꾸면 됩니다. Kunavo는 최소 $10 충전부터 종량제로 이용할 수 있으며 신규 계정에는 무료 크레딧이 제공되지 않습니다.

옵션 A — Anthropic에서 직접 발급받는 API 키

Claude만 호출할 프로젝트라면 Anthropic Console 키가 적합합니다. Anthropic은 이 키의 사용량에 토큰별 요금을 부과하며, 출시 당일부터 모든 Claude 기능을 지원합니다.

1. platform.claude.com로 이동해 로그인하세요. 이전 주소인 console.anthropic.com도 이제 같은 콘솔로 연결됩니다.
2. Settings → API keys(직접 링크: platform.claude.com/settings/keys)를 열고 Create Key를 클릭하세요. Anthropic 키는 sk-ant-... 형식이며 한 번만 표시됩니다.
3. 결제에서 결제 수단을 추가하세요. Anthropic은 신규 사용자에게 소량의 무료 크레딧을 제공한 뒤 토큰별로 요금을 청구합니다.
4. x-api-key와 anthropic-version 헤더를 함께 사용해 키를 전송하세요.

# Anthropic direct — x-api-key, not Bearer
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": 256,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

미리 고려할 점이 하나 있습니다. Anthropic 키는 Claude에만 연결됩니다. GPT, 이미지 또는 비디오 모델도 호출하는 프로젝트에는 제공자별로 별도의 계정, 키, SDK, 청구서가 필요합니다.

옵션 B — Claude와 그 밖의 모든 모델에 하나의 Kunavo 키 사용

Kunavo는 OpenAI 호환 API와 네이티브 Anthropic Messages API 모두를 통해 Claude를 제공합니다. sk-kn- 키 하나로 Anthropic 계정 없이 Stripe로 충전한 단일 잔액에서 Claude와 카탈로그의 모든 모델을 이용할 수 있습니다.

1. Kunavo 계정을 만들고 $10을 충전하세요. Kunavo는 종량제 방식이며 잔액은 만료되지 않습니다.
2. /app/keys에서 키를 생성하세요. Kunavo 키는 한 번만 표시되므로 환경 변수에 저장하세요.
3. OpenAI SDK가 https://api.kunavo.com/v1를 가리키도록 설정하고 Claude 슬러그를 호출하세요.

Claude API 키와 Anthropic API 키 비교

“Anthropic API 키”와 “Claude API 키”는 이름만 다른 동일한 인증 정보입니다. Anthropic은 회사이고 Claude는 모델 제품군이며, Claude Console에서 생성한 키로 Claude API 호출을 인증합니다. 아래 두 키의 차이는 각각 어디서 발급되는지, 어떤 서비스에 연결되는지입니다:

• Anthropic Console 키(sk-ant-...) — platform.claude.com/settings/keys에서 생성합니다. Anthropic Console 키는 Claude만 호출하며 Anthropic이 토큰별로 요금을 청구합니다.
• Kunavo 키(sk-kn-...) — kunavo.com/app/keys에서 생성합니다. Kunavo 키를 사용하면 Anthropic 계정 없이 OpenAI SDK 또는 네이티브 Messages API로 동일한 Claude 모델과 GPT, 이미지, 비디오, 오디오 모델을 호출할 수 있으며, 비용은 Stripe로 충전한 단일 잔액에서 차감됩니다.

Python으로 Claude 호출하기

공식 OpenAI SDK를 그대로 사용하세요. base_url와 모델 이름만 바꾸면 마이그레이션이 끝납니다.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # the only line that changes
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Explain quicksort in one paragraph."}],
)
print(resp.choices[0].message.content)

Node.js로 Claude 호출하기

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Explain quicksort in one paragraph." }],
});
console.log(resp.choices[0].message.content);

또는 curl로 Claude 호출하기

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Claude API 키가 작동하지 않을 때

401 authentication_error를 반환하는 Claude API 키 문제는 거의 항상 다음 다섯 가지 중 하나입니다. 해당 엔드포인트에 맞지 않는 헤더, 해당 키를 사용할 수 없는 엔드포인트로 키를 전송한 경우, 환경 변수에 공백이나 따옴표가 섞여 들어간 경우, 키가 폐기된 경우, 또는 해당 키에 맞지 않는 기본 URL을 사용한 경우입니다.

가장 흔한 원인은 헤더 불일치입니다. Anthropic 네이티브 API는 x-api-key와 anthropic-version를 요구합니다. Kunavo를 포함한 OpenAI 호환 엔드포인트는 Authorization: Bearer를 요구합니다. sk-ant- 키는 api.anthropic.com에서만 작동하고, sk-kn- 키는 api.kunavo.com에서만 작동합니다.

아래 각 오류에 대해 정확한 오류 JSON, 알려진 모든 원인, 복사해 사용할 수 있는 해결 방법을 담은 전용 상세 문서가 있습니다: 401 invalid api key, 429 rate_limit_error, credit balance too low / 402, 529 overloaded, model_not_found.

신용카드 없이 Claude API 사용하기

Anthropic은 일반 Claude API 계정에 주요 신용카드를 허용하며 후불 청구는 엔터프라이즈 고객에게만 제공합니다. 따라서 Anthropic을 직접 이용하려면 실질적으로 카드가 필요합니다.

Kunavo 잔액은 카드 없이도 다음 결제 수단으로 충전할 수 있습니다: ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). Kunavo는 충전 금액을 USD로 책정하고 Stripe가 결제 페이지에서 환전하므로 브라질 구매자는 해외 결제가 가능한 카드를 찾는 대신 헤알화 금액의 Pix 코드를 스캔할 수 있습니다. 카드로 충전하는 지갑도 사용할 수 있지만, 카드에 연결된 지갑은 이 질문에 대한 답이 아니므로 의도적으로 목록에서 제외했습니다. 전체 결제 수단 목록은 청구 레퍼런스에서 확인할 수 있습니다.

사용할 Claude 모델

• claude-haiku-4-5 — 대량 분류와 지원 작업에 적합한 가장 저렴하고 빠른 모델입니다. Kunavo의 Claude Haiku 4.5 가격은 입력 1M 토큰당 $0.70, 출력 1M 토큰당 $3.50입니다.
• claude-sonnet-5 — 대부분의 추론, 검색 증강 및 코딩 작업에 적합한 균형 잡힌 기본 모델입니다. 최신 Sonnet으로, 코딩 및 에이전트 작업 성능은 Opus에 가깝습니다. Kunavo의 Claude Sonnet 5 가격은 1M 토큰당 $1.40 / $7.00이며, Anthropic 정가는 $2.00 / $10.00입니다.
• claude-sonnet-4-6 — 이전 Sonnet으로, 이 모델에 맞게 조정된 프롬프트에 적합합니다. Kunavo의 Claude Sonnet 4.6 가격은 1M 토큰당 $2.10 / $10.50입니다.
• claude-opus-5 — 고난도 추론과 긴 컨텍스트에 적합합니다. Kunavo의 Claude Opus 5 가격은 1M 토큰당 $3.50 / $17.50이며, Anthropic 정가는 $5.00 / $25.00입니다.
• claude-fable-5 — 최첨단 추론과 장기 에이전트 작업에 적합한 Anthropic의 가장 강력한 모델로, 2026년 9월 1일 출시되었습니다. Kunavo 가격은 1M 토큰당 $7.00 / $35.00이며, Anthropic 정가는 $10.00 / $50.00입니다. 이전 릴리스인 claude-fable-5도 동일한 요율로 계속 제공됩니다.

API 키 보안 체크리스트

• API 키를 클라이언트 측에 절대 노출하지 마세요. 모든 호출은 개발자가 제어하는 서버를 통해 프록시하세요.
• 프로젝트나 환경마다 API 키를 하나씩 사용하세요. 이렇게 하면 키가 유출되었을 때 다른 모든 서비스의 운영을 중단하지 않고 해당 키만 폐기할 수 있습니다.
• API 키를 분기마다 교체하세요. Kunavo에서는 여러 키를 동시에 활성화할 수 있으므로 키 교체 기간에 원활하게 겹쳐 사용할 수 있습니다.

자주 묻는 질문

Kunavo의 정체와 비정체

Kunavo는 독립적인 OpenAI 호환 AI API 게이트웨이입니다. 하나의 API 키와 종량제 잔액으로 Claude, GPT, 이미지, 비디오, 오디오 모델을 이용할 수 있으며, 제공자별 계정은 필요하지 않습니다.

Kunavo는 이 모델에 대한 액세스를 재판매하는 독립 게이트웨이입니다. Kunavo는 Anthropic, Google 또는 OpenAI가 아니며, 제공하는 모델을 학습하거나 호스팅하지 않습니다.

Anthropic 제품, 가격 및 정책에 관한 공식 정보는 platform.claude.com에 있는 Anthropic 자체 문서가 기준입니다. 이 페이지는 각 내용을 확인한 날짜와 함께 Anthropic이 공개한 절차를 안내하고, 그에 대한 Kunavo의 대안을 함께 설명합니다.

다음 단계

• Messages API 레퍼런스 (네이티브 Anthropic 형식)
• Claude API 가격 2026
• 빠른 시작 — 60초 만에 첫 요청 보내기