Home → Guide → Base URL di Anthropic per Claude Code: impostare correttamente ANTHROPIC_BASE_URL

Base URL di Anthropic per Claude Code: impostare correttamente ANTHROPIC_BASE_URL

Claude Code si collega all'indirizzo indicato da ANTHROPIC_BASE_URL. L'unica regola su cui si inciampa: vuole solo l'host, senza /v1 — l'opposto di quasi tutti gli strumenti in stile OpenAI.

La risposta breve

Imposta due variabili d'ambiente prima di avviare Claude Code:

ANTHROPIC_BASE_URL=https://apiclan.us
ANTHROPIC_AUTH_TOKEN=sk-your-key

L'indirizzo ufficiale di Anthropic è https://api.anthropic.com; per un relay basta sostituirlo. Claude Code aggiunge da solo /v1/messages, quindi la base URL si ferma all'host. Su questo gateway l'88% di tutto il traffico Claude degli ultimi 30 giorni è arrivato da Claude Code configurato esattamente così.

Dove impostarlo

macOS / Linux — nella shell da cui lo avvii:

export ANTHROPIC_BASE_URL=https://apiclan.us
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

Windows PowerShell — per la finestra corrente:

$env:ANTHROPIC_BASE_URL = "https://apiclan.us"
$env:ANTHROPIC_AUTH_TOKEN = "sk-your-key"
claude

~/.claude/settings.json — perché ogni sessione lo usi, indipendentemente dalla shell:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apiclan.us",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

Il valore viene letto all'avvio di Claude Code. Se lo cambi, esci e apri una nuova sessione; una sessione aperta mantiene il vecchio indirizzo. ANTHROPIC_AUTH_TOKEN viene inviato come Authorization: Bearer, ANTHROPIC_API_KEY come x-api-key. Questo gateway li accetta entrambi: usane uno solo.

Provalo con un comando

Prima di dare la colpa a Claude Code, verifica direttamente indirizzo e chiave:

curl https://apiclan.us/v1/messages \
  -H "Authorization: Bearer sk-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":20,"messages":[{"role":"user","content":"hi"}]}'

Una risposta JSON significa che sono giusti entrambi. text/html o un 404 significa che l'URL è sbagliato; un 401 in JSON significa che l'URL è giusto e la chiave no.

Quando aggiungere /v1 e quando no

Due famiglie di SDK dividono l'URL in punti diversi. I client in stile Anthropic aggiungono /v1/messages da soli; quelli in stile OpenAI si aspettano /v1 nella base URL e aggiungono solo /chat/completions:

Client	Base URL
Claude Code, Anthropic SDK	https://apiclan.us
Codex, OpenAI SDK	https://apiclan.us/v1
Cursor, Cline, Roo Code	https://apiclan.us/v1
Cherry Studio, Chatbox, LobeChat, LM Studio	https://apiclan.us/v1

Con /v1 in Claude Code le richieste vanno a /v1/v1/messages e restituiscono 404. Senza /v1 in Cursor vanno a /chat/completions, anche lì 404. Nessuna raggiunge l'API.

Errore di URL o di chiave?

• Un errore e niente nel registro di utilizzo → il percorso è sbagliato. Un 404 viene risposto al bordo della rete e non arriva mai alla fatturazione. Controlla prima /v1.
• 401 con una voce nel registro → la chiave è sbagliata, revocata, oppure il saldo è esaurito.
• Un modello dà 404 mentre gli altri funzionano con la stessa chiave → quel modello appartiene a un altro gruppo. Ogni chiave è legata a un gruppo; creane una seconda per l'altro.
• Una modifica sembra non avere effetto → la variabile è stata impostata in un'altra shell o la sessione è partita prima.

Scegliere il modello

I nomi dei modelli sono stringhe esatte con trattini, mai punti: claude-fable-5-1, non claude-fable-5.1. Sceglilo all'avvio o con /model dentro una sessione:

claude --model claude-opus-5-5

Nomi e prezzi attuali sono nel listino. La configurazione degli altri client è nella guida rapida, l'app Claude Desktop nella guida alle app desktop.

Inizia a usarlo

Nessun abbonamento, nessun minimo mensile, nessuna telefonata commerciale. Ricarica in USDT e spendi quello che usi — 1 USDT ti dà 2 crediti di saldo API.

Leggi l'avvio rapido da 30 secondi

Lingua: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

I prezzi di questa pagina sono compilati automaticamente dai dati di fatturazione reali. Le condizioni di terzi sono citate dalla loro documentazione.