Come ottenere una chiave API Claude — percorso ufficiale e percorso tramite gateway

Esistono due percorsi per ottenere una chiave API Claude. Il percorso ufficiale consiste nel generarla direttamente dalla console Anthropic; l'altro consiste nell'ottenerla da un gateway che fornisce un endpoint compatibile con Anthropic. Entrambi chiamano lo stesso modello Claude e nel codice cambiano soltanto il base URL e la stringa della chiave.

Di seguito illustriamo entrambi i percorsi e trattiamo anche i problemi di pagamento che si verificano più spesso in Corea del Sud.

Percorso 1 — Generazione diretta dalla console Anthropic

Crea un account Anthropic, registra un metodo di pagamento e genera una chiave API dalla console. Le chiavi di questo percorso vengono fatturate ai prezzi ufficiali di Anthropic; il vantaggio è poter utilizzare la documentazione ufficiale e il relativo supporto.

In Corea del Sud, il punto in cui si verificano più spesso problemi è il pagamento. Le carte con i pagamenti internazionali bloccati non possono essere registrate; abilita i pagamenti internazionali nell'app dell'emittente e riprova: nella maggior parte dei casi il problema si risolve.

Percorso 2 — Chiave del gateway

È il modo per chiamare i modelli Claude senza un account Anthropic. Kunavo fornisce sia l'API Anthropic Messages sia un'API compatibile con OpenAI, quindi puoi modificare il codice esistente cambiando soltanto il base URL e la chiave.

Questo percorso presenta meno blocchi anche nella fase di pagamento. La ricarica prepagata di Kunavo offre KakaoPay, Naver Pay, PAYCO, Samsung Pay e carte nazionali con i pagamenti internazionali bloccati quando la schermata di pagamento è visualizzata in won coreani (Toss Pay non è disponibile). Il saldo ricaricato viene usato per le chiamate a Claude API e non per pagare un abbonamento 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 il codice utilizza il formato nativo Anthropic, imposta il base URL su https://api.kunavo.com: in questo caso non aggiungere /v1. Le differenze tra i due formati sono descritte nella documentazione di ANTHROPIC_BASE_URL.

Tariffe

Le tariffe vengono lette dal catalogo quando la pagina viene renderizzata, quindi questo documento non può divergere dagli importi effettivamente addebitati. Le informazioni sui metodi di pagamento e sulle carte nazionali sono spiegate più dettagliatamente in Prezzi e pagamenti dell'API Claude.

Verifica nei 30 secondi successivi alla generazione

Dopo aver ottenuto la chiave, effettua subito una chiamata. Questa verifica iniziale consente di capire immediatamente se eventuali errori successivi riguardano la chiave.

# 발급받은 키가 실제로 동작하는지 확인하는 최소 요청.
# 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 ricevi 200, la chiave funziona correttamente. Se ricevi 401, nella maggior parte dei casi il tipo di intestazione di autenticazione è errato; 429 indica un limite di frequenza e 529 un sovraccarico upstream, entrambi indipendenti dalla chiave. Le procedure per ogni errore sono disponibili in Riepilogo degli errori di Claude Code.

Separare le chiavi

È più sicuro separare le chiavi in base all'utilizzo. Se ne revochi una, le altre non vengono influenzate; puoi inoltre impostare un limite mensile di utilizzo per ciascuna chiave. Il limite viene verificato prima dell'esecuzione della richiesta e si reimposta all'inizio di ogni mese, quindi è particolarmente utile quando assegni una chiave a un agente senza supervisione umana.

Domande frequenti