Como obter uma chave da API do Claude — caminhos oficiais e por gateway

Há duas formas de obter uma chave de API do Claude. A rota oficial é emiti-la diretamente no console da Anthropic; a outra é obtê-la em um gateway que ofereça um endpoint compatível com a Anthropic. Ambas chamam os mesmos modelos Claude, e no código apenas o base URL e a string da chave mudam.

A seguir, apresentamos as duas rotas e também tratamos dos problemas de pagamento que ocorrem com frequência na Coreia do Sul.

Rota 1 — emissão direta no console da Anthropic

Crie uma conta Anthropic, cadastre um método de pagamento e gere uma chave de API no console. As chaves dessa rota são cobradas pelos preços oficiais da Anthropic, e a vantagem é contar diretamente com a documentação e o suporte oficiais.

Na Coreia do Sul, o problema geralmente ocorre na etapa de pagamento. Cartões bloqueados para pagamentos internacionais não podem ser cadastrados; permitir pagamentos internacionais no aplicativo da operadora do cartão e tentar novamente resolve a maioria dos casos.

Rota 2 — chave de gateway

É uma forma de chamar modelos Claude sem uma conta Anthropic. A Kunavo oferece tanto a API Anthropic Messages quanto uma API compatível com OpenAI; portanto, basta alterar o base URL e a chave no código existente.

Esse caminho também apresenta menos bloqueios na etapa de pagamento. Na recarga pré-paga do Kunavo, quando o checkout exibe won sul-coreano, KakaoPay, Naver Pay, PAYCO, Samsung Pay e cartões nacionais sem pagamentos internacionais habilitados são oferecidos como métodos de pagamento (Toss Pay não é oferecido). O saldo recarregado é usado para chamadas à API do Claude e não é um método para pagar a assinatura da 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)

Se o código usa o formato nativo da Anthropic, defina o base URL como https://api.kunavo.com — nesse caso, não acrescente /v1. As diferenças entre os dois formatos estão descritas em ANTHROPIC_BASE_URL documentação.

Tarifas

As tarifas são lidas do catálogo quando a página é renderizada, portanto este documento não pode divergir do valor realmente cobrado. Os detalhes sobre métodos de pagamento e cartões nacionais estão em Preços e pagamentos da API do Claude.

Verificação de 30 segundos após a emissão

Assim que receber a chave, faça uma chamada imediatamente. Essa verificação permite distinguir de imediato se um erro posterior está ou não relacionado à chave.

# 발급받은 키가 실제로 동작하는지 확인하는 최소 요청.
# 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":"안녕하세요"}]}'

Se receber 200, a chave está funcionando. 401 geralmente indica um tipo incorreto de cabeçalho de autenticação; 429 indica limitação de taxa; 529 indica sobrecarga do upstream e não tem relação com a chave. As ações para cada erro estão em Resumo dos erros do Claude Code.

Separação de chaves

É mais seguro separar as chaves por finalidade. Mesmo que uma seja revogada, as demais não serão afetadas, e você também pode definir um limite mensal de uso para cada chave. O limite é verificado antes da execução da solicitação e reiniciado no início de cada mês, sendo especialmente útil ao entregar uma chave a um agente sem supervisão humana.

Perguntas frequentes