블로그 목록으로
가이드·2026년 5월 24일·5분 분량

한국에서 Claude API 시작하기 — OpenAI SDK 전환, 서울 지연시간, 한국어 토큰

한국 개발자를 위한 Claude API 시작 가이드: OpenAI SDK에서 base_url 한 줄로 전환하는 법, 서울에서 호출할 때 지연시간이 어디서 생기는지, 한국어 토큰 소비와 모델 선택. 모델별 가격과 결제 방법은 Claude API 가격·결제 정리에 따로 모았습니다.

한국에서 Claude API를 사용하는 개발자가 가장 자주 묻는 질문에 한 번에 답합니다. Anthropic 본사 대비 요금, 서울에서의 실측 지연시간, 국내 카드 결제 가능 여부, 그리고 OpenAI SDK에서 한 줄만 바꿔서 마이그레이션하는 방법까지.

5초 안에 첫 호출

Kunavo는 OpenAI 와이어 프로토콜과 100% 호환됩니다. 기존 OpenAI SDK를 쓰고 있다면 마이그레이션 비용은 base_url 한 줄 변경뿐입니다. Python 예시:

quickstart.py
from openai import OpenAI

client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",  # 이 한 줄만 바꾸면 끝
)

resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "한국어로 인사해주세요"}],
)
print(resp.choices[0].message.content)

Node.js / TypeScript도 동일합니다:

quickstart.mjs
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-opus-4-7",
  messages: [{ role: "user", content: "서울 오늘 날씨 알려줘" }],
});
console.log(resp.choices[0].message.content);

가입은 무료이고 $10부터 충전해 쓴 만큼만 내는 종량제(pay-as-you-go)이며 잔액은 소멸되지 않습니다. Claude Opus 4.7, Sonnet 4.6, Haiku 4.5를 충분히 테스트할 수 있습니다. 같은 OpenAI 호환 키 하나로 Claude뿐 아니라 Gemini, GPT, 이미지·비디오 모델까지 호출됩니다.

본사 대비 요금 차이 — 클로드 API 비용

Kunavo의 Claude 모델은 Anthropic 공식 요금보다 30% 저렴합니다. Claude Sonnet 4.6은 본사에서 입력 $3.00, 출력 $15.00 (100만 토큰당)이지만, Kunavo에서는 입력 $2.10, 출력 $10.50로 청구됩니다 (약 30% 할인). 프롬프트 캐싱을 활용하면 캐시 읽기는 입력 요금의 10% — 즉 실질적으로 $0.21/100만 토큰으로 재읽기가 가능합니다. 모델별 전체 단가와 결제 방법은 Claude API 가격·결제 정리와 가격 페이지에서 확인하세요.

서울에서의 지연시간

Kunavo의 입구는 anycast 엣지 네트워크이고, TLS는 가까운 노드에서 종료됩니다. 게이트웨이 자체는 단일 US-East 리전(버지니아주 애슈번)에서 실행됩니다. 엣지가 줄여 주는 것은 TLS 핸드셰이크 왕복이지 태평양을 건너는 구간이 아닙니다 — 서울에서 호출하면 왕복 시간은 서울과 미국 동부 사이의 물리적 거리가 지배하고, 여기에 모델 자체의 추론 시간이 더해집니다. Anthropic의 us-east-1을 직접 호출해도 같은 구간을 지나갑니다. 스트리밍은 SSE 패스스루로 구현되어 Time-to-first-token이 업스트림과 동일합니다.

결제 — 국내 카드, 카카오페이?

결제는 Stripe로 처리됩니다. 한국 고객이 사용할 수 있는 방법:

  • 신용 / 체크 카드: Visa, Mastercard, American Express, JCB
  • Apple Pay, Google Pay (Chrome·Android에서 설정한 경우), Link (원클릭 결제)
  • 체크아웃이 원화로 표시될 때: 카카오페이, 네이버페이, PAYCO, 삼성페이, 국내 카드

가격은 미국 달러($USD)로 책정되어 있으며 Stripe가 체크아웃 시점에 원화로 자동 환산합니다. 이 환율에는 구매자가 내는 2–4% 환전 수수료가 포함되며, 달러로 결제하면 붙지 않습니다 (Stripe Adaptive Pricing 문서, 2026-10-03 확인). 최소 충전 금액은 $10 USD (약 1만 4천원 내외). 구독이 아닌 선불 지갑 방식이므로 미사용 잔액은 만료되지 않습니다.

카카오페이는 Kunavo 충전 수단으로 결제 화면에 나오고, 토스는 지원하지 않습니다. 카카오페이·네이버페이·PAYCO·삼성페이와 국내 카드는 결제 화면이 원화로 표시될 때만 나오며, 국내 카드는 이 경로라면 해외 결제가 열려 있지 않아도 됩니다. 달러로 결제할 때는 해외 결제가 가능한 카드가 필요합니다 (해외 결제 차단 설정이 되어 있다면 카드사 앱에서 해제 필요). 이 수단들은 Kunavo 잔액을 채우는 것이지 Anthropic에 직접 내는 결제가 아닙니다.

한국어 사용 시 토큰 비용

Claude는 한국어 입출력에서 영어와 동등한 품질을 보여줍니다. 다만 한국어는 토큰 소비가 영어보다 약 1.5~2배 많습니다 (글자당 약 0.5~0.7 토큰). 요금 계산 시 이 점을 감안하세요.

존댓말과 반말 구분은 시스템 프롬프트에서 명시하는 것이 가장 확실합니다:

“당신은 한국의 고객 지원 담당자입니다. 모든 답변은 반드시 존댓말 (-습니다/-입니다)로 작성하고, 고객에게 정중하고 친절하게 응답해 주세요.”

모델 선택 가이드

  • Claude Opus 4.7 — 최강의 추론 능력. 한국어 뉘앙스 이해가 필요한 복잡한 작업, 긴 컨텍스트 요약, 코드 생성에 적합.
  • Claude Sonnet 4.6 — 가격과 능력의 균형. 한국 스타트업들이 가장 많이 채택하는 모델. 챗봇, 콘텐츠 생성, 에이전트의 메인 모델로 적합.
  • Claude Haiku 4.5 — 빠르고 저렴. 분류 작업, 필터링, 간단한 요약, 에이전트의 사전 처리용. Sonnet의 약 1/10 비용.

다음 단계

  1. 무료로 가입하기 — $10부터 충전, 종량제, 잔액 만료 없음
  2. OpenAI 호환 API 키 만들기 — base_url만 바꾸면 기존 OpenAI SDK 그대로
  3. Chat completions로 첫 호출 — Claude·Gemini·GPT가 같은 엔드포인트
  4. Claude API 가격 보기 · 결제 방법 정리 · OpenRouter 대안 비교

질문은 contact@kunavo.com 으로 보내주세요. 1영업일 이내에 답변드립니다.

관련 심층 분석