Claude API 金鑰申請方法 — 官方途徑與閘道途徑

取得 Claude API 金鑰有兩種途徑。一種是直接從 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。這兩種格式的差異整理在 ANTHROPIC_BASE_URL 文件中。

費率

費率會在頁面呈現時從目錄讀取，因此本文不可能與實際計費金額不一致。付款方式與韓國國內信用卡的相關內容，在 Claude API 價格與付款中有更詳細的說明。

取得金鑰後的 30 秒檢查

取得金鑰後，請立即試著呼叫一次。先完成這項檢查，就能立即判斷之後發生的錯誤是否與金鑰有關。

# 발급받은 키가 실제로 동작하는지 확인하는 최소 요청.
# 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 錯誤整理。

分開使用金鑰

依用途分別使用不同金鑰比較安全。即使撤銷其中一把，也不會影響其他金鑰，而且每把金鑰都可以設定每月使用上限。系統會在執行請求前檢查上限，並於每月月初重設，因此將金鑰交給無人監看的代理使用時，這項功能尤其實用。

常見問題