Claude API キーの取得方法 — 公式ルートとゲートウェイルート

Claude API キーを取得する方法は2つあります。 Anthropic コンソールから直接発行する公式の方法と、Anthropic 互換エンドポイントを提供するゲートウェイから取得する方法です。どちらも同じ Claude モデルを呼び出し、コードで異なるのは base URL とキー文字列だけです。

以下では両方の方法を整理し、韓国で特に起こりやすい支払いの問題についても説明します。

方法1 — Anthropic コンソールから直接発行

Anthropic アカウントを作成し、支払い方法を登録してから、コンソールで API キーを生成します。この方法のキーには Anthropic の定価が適用され、公式ドキュメントとサポートをそのまま利用できることが利点です。

韓国でつまずく箇所のほとんどは支払いの段階です。海外決済がブロックされたカードは登録できないため、カード会社のアプリで海外決済を許可してから再試行すれば、ほとんどの場合解決します。

方法2 — ゲートウェイキー

Anthropic アカウントなしで Claude モデルを呼び出す方法です。Kunavo は Anthropic Messages API と OpenAI 互換 API の両方を提供しているため、既存コードでは base URL とキーだけを変更すれば済みます。

この経路なら、決済段階でもブロックされにくくなります。Kunavoのプリペイドチャージでは、決済画面が韓国ウォンで表示される場合、KakaoPay、Naver Pay、PAYCO、Samsung Pay、海外決済が有効でない韓国国内カードを支払い手段として利用できます（Toss Payは提供されていません）。チャージした残高はClaude APIの呼び出しに使われ、Anthropicのサブスクリプション料金の支払い手段ではありません。

# OpenAI SDK를 그대로 쓰면서 base_url만 바꾸는 방식.
# 코드에서 바뀌는 줄은 base_url 한 줄뿐입니다.
from openai import OpenAI

client = OpenAI(
    base_url="https://api.kunavo.com/v1",
    api_key="sk-kn-...",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "안녕하세요"}],
)
print(resp.choices[0].message.content)

Anthropic ネイティブ形式を使用するコードでは、base URL を https://api.kunavo.com に設定します — この場合、/v1 は付けません。2つの形式の違いは ANTHROPIC_BASE_URL ドキュメント にまとめています。

料金

料金はページのレンダリング時にカタログから読み込まれるため、このドキュメントが実際の請求額と食い違うことはありません。支払い方法と韓国のカードに関する内容は、Claude API の価格と支払いで詳しく説明しています。

発行後30秒の確認

キーを取得したら、すぐに1回呼び出してみてください。先にこの確認を行えば、その後のエラーがキーの問題かどうかをすぐに切り分けられます。

# 발급받은 키가 실제로 동작하는지 확인하는 최소 요청.
# 200이 오면 키는 정상입니다.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,
       "messages":[{"role":"user","content":"안녕하세요"}]}'

200 が返ればキーは正常です。401 の場合は認証ヘッダーの種類が一致していないことがほとんどです。429 はレート制限、529 はアップストリームの過負荷を示し、この二つはキーとは無関係です。各エラーへの対処法は Claude Code のエラー整理 にあります。

キーを分けて使う

用途ごとにキーを分ける方が安全です。1つを無効化しても残りには影響せず、キーごとに 月間使用上限 を設定することもできます。上限はリクエストの実行前に確認され、毎月初めにリセットされるため、人が監視していないエージェントにキーを渡す場合に特に便利です。

よくある質問