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 错误汇总。

拆分使用密钥

按用途拆分密钥更安全。即使废弃其中一个，其余密钥也不会受到影响；还可以为每把密钥设置月度使用上限。上限会在请求执行前检查，并在每月初重置，因此在把密钥交给无人监管的代理时尤其有用。

常见问题