Claude Code invia ogni richiesta nel formato Messages API di Anthropic, a /v1/messages su qualunque indirizzo indichi ANTHROPIC_BASE_URL. Quasi tutti i provider di modelli open-weight, BroadNet Inference compreso, parlano invece il formato OpenAI. Quindi ti serve un proxy che traduca tra i due, oppure un provider che pubblichi un proprio endpoint in formato Anthropic. Questo articolo copre entrambe le strade, più i limiti che decidono se ne vale la pena.
Perché Claude Code non può chiamare direttamente un’API compatibile con OpenAI?
La guida alla compatibilità dei gateway di Claude Code elenca i formati che un gateway deve esporre. Per una base URL semplice è Anthropic Messages: /v1/messages, con /v1/messages/count_tokens facoltativo, e l’inoltro degli header anthropic-beta e anthropic-version. Un’API compatibile con OpenAI serve /v1/chat/completions, con richieste e risposte di forma diversa. Se punti Claude Code direttamente su una di queste API, le richieste falliscono.
Un’altra cosa da sapere prima di iniziare. La documentazione di Claude Code dice che Anthropic «doesn’t support routing Claude Code to non-Claude models through any gateway» (traduzione: non supporta l’instradamento di Claude Code verso modelli non Claude tramite alcun gateway). Molti lo fanno comunque, ma nessuno in Anthropic lo debuggherà per te.
Quali sono le tre opzioni?
| Strada | Come funziona | Ideale per | Compromesso |
|---|---|---|---|
| Proxy di traduzione (LiteLLM) | Claude Code parla in formato Anthropic con un proxy locale; il proxy chiama il provider compatibile con OpenAI | Usare un provider compatibile con OpenAI specifico, come BroadNet | Un processo in più da far girare e aggiornare; lacune di traduzione |
| Endpoint nativo in formato Anthropic | Il provider accetta direttamente /v1/messages |
Modelli DeepSeek o GLM dai loro produttori | Ognuno mappa o ignora alcuni campi |
| Un altro agente | Usa un agente che accetta una base URL compatibile con OpenAI | Chi non ha bisogno proprio di Claude Code | Rinunci all’interfaccia e alle funzioni di Claude Code |
Come si fa girare Claude Code tramite LiteLLM?
Il tutorial di LiteLLM per i modelli non Anthropic funziona così: installi il proxy, definisci i modelli in config.yaml, lo avvii, poi imposti due variabili in Claude Code. LiteLLM traduce tra i formati, quindi Claude Code continua a inviare richieste Anthropic.
Definisci i modelli BroadNet come nella guida a LiteLLM, con il prefisso openai/ e api_base:
model_list:
- model_name: glm
litellm_params:
model: openai/broadnet/glm-5.3
api_base: https://inference.broadnet.ai/v1
api_key: os.environ/BROADNET_API_KEY
rpm: 30
- model_name: qwen
litellm_params:
model: openai/broadnet/qwen3.8-27b
api_base: https://inference.broadnet.ai/v1
api_key: os.environ/BROADNET_API_KEY
rpm: 30
general_settings:
master_key: os.environ/LITELLM_MASTER_KEY
Avvia il proxy:
uv tool install 'litellm[proxy]'
export BROADNET_API_KEY='your-broadnet-key'
export LITELLM_MASTER_KEY='sk-any-local-secret'
litellm --config config.yaml # listens on http://0.0.0.0:4000
Poi punta Claude Code sul proxy. ANTHROPIC_AUTH_TOKEN viene inviato come header Authorization: Bearer, che è quello che legge LiteLLM:
export ANTHROPIC_BASE_URL=http://0.0.0.0:4000
export ANTHROPIC_AUTH_TOKEN="$LITELLM_MASTER_KEY"
export ANTHROPIC_MODEL=glm # main model
export ANTHROPIC_DEFAULT_HAIKU_MODEL=qwen # background tasks
export ANTHROPIC_DEFAULT_SONNET_MODEL=glm # the sonnet alias
export ANTHROPIC_DEFAULT_OPUS_MODEL=glm # the opus alias
export CLAUDE_CODE_SUBAGENT_MODEL=glm # subagents
claude
Esegui /status in Claude Code. La riga Anthropic base URL deve mostrare l’indirizzo del proxy.
Le variabili dei modelli contano. La pagina di LiteLLM su Claude Code avverte che scegliere un nome Claude predefinito che la tua configurazione non definisce fallisce con «Invalid model name passed in» (traduzione: nome di modello non valido). Il riferimento delle variabili d’ambiente di Claude Code dice che ANTHROPIC_DEFAULT_HAIKU_MODEL è usato anche per le funzioni in background, quindi mappa anche questa, altrimenti le richieste in background chiedono un nome Haiku che il proxy non conosce. CLAUDE_CODE_SUBAGENT_MODEL imposta il modello predefinito dei subagent, ma ha la precedenza il modello che Claude passa quando ne avvia uno, spesso un alias come sonnet o haiku. Mappare anche gli alias sonnet e opus fa sì che anche quelle richieste finiscano su un modello che il proxy conosce. Tieni la chiave BroadNet nell’ambiente del proxy, mai in un .claude/settings.json di progetto messo sotto commit.
Quali endpoint DeepSeek e GLM funzionano senza proxy?
Due produttori di modelli pubblicano base URL in formato Anthropic:
| Provider | Base URL | Gestione dei modelli (dalla loro documentazione, verificata il 2026-11-15) |
|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
I nomi claude-sonnet* e claude-haiku* vengono mappati su deepseek-flash; claude-opus* su deepseek-v4-pro; i nomi che non iniziano con claude restituiscono 400 |
| Z.ai (GLM Coding Plan) | https://api.z.ai/api/anthropic |
Chiave in ANTHROPIC_AUTH_TOKEN; l’esempio della configurazione manuale mappa Opus e Sonnet su glm-5.3[1m] e Haiku su glm-5.3-flash[1m] |
La nota di rilascio di DeepSeek del 10 settembre 2026 dice che deepseek-flash serve DeepSeek-V4.1-Flash. La sua pagina sulla Anthropic API elenca anche cosa ignora: tra gli altri, cache_control, budget_tokens, disable_parallel_tool_use e l’header anthropic-version. Su deepseek-flash, le immagini nei messaggi dell’assistente restituiscono 400, e deepseek-v4-pro sostituisce le immagini con “[Unsupported Image]”.
Se in Claude Code vuoi solo DeepSeek o GLM, questi endpoint nativi sono la strada più breve. Prezzi e limiti dei piani di entrambi sono confrontati nella pagina sulle alternative all’API di Claude.
Cosa si rompe o cambia con un modello non Claude?
La traduzione fa arrivare le richieste, ma diverse funzioni di Claude Code dipendono da cose che un proxy o un altro modello potrebbero non far passare. La documentazione di Claude Code cita queste:
- Prompt caching. Claude Code marca i blocchi
systeme quelli dei messaggi concache_control. Se il gateway o il servizio a monte lo scartano, non c’è errore, ma ogni turno si paga come input non in cache. Con un servizio a monte compatibile con OpenAI, la cache segue invece le regole di quel provider. BroadNet fattura l’input in cache a un prezzo più basso quando il suo blocco usage riporta un cache hit; controllacached_tokensnei tuoi log. - Conteggio dei token. Senza
/v1/messages/count_tokens, Claude Code ricade su una stima basata sui caratteri, quindi/contextè approssimativo. - Finestra di contesto. Claude Code applica la sua finestra predefinita ai nomi di modello che non riconosce. Imposta
CLAUDE_CODE_AUTO_COMPACT_WINDOW(da 100.000 a 1.000.000 di token) in base al modello. Per Qwen3.8 27B, con un contesto di 262.144 token, impostala ben al di sotto. - Campi sconosciuti. Un
400che citaExtra inputs are not permittedo un valoreanthropic-betasignifica che qualcosa a monte ha rifiutato un campo in anteprima. La documentazione suggerisceCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1. - Ragionamento.
MAX_THINKING_TOKENSe l’adaptive thinking sono funzioni di Claude. Su BroadNet, DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B ragionano prima di rispondere, e quei token di ragionamento contano inmax_tokens. Se le risposte arrivano vuote, alza il limite di output o inviareasoning_effortbasso. Vedi perché i modelli di ragionamento restituiscono risposte vuote. - Immagini. Su BroadNet GLM 5.3 accetta solo testo. Usa Qwen3.8 27B se incolli screenshot.
Prima di farci affidamento, prova un compito reale da capo a fondo, con modifiche ai file, comandi di shell e una sessione lunga.
Quale modello BroadNet mettere dietro Claude Code?
Claude Code legge e modifica file ed esegue comandi tramite chiamate ai tool. Il riferimento API di BroadNet documenta tool, output strutturato e ragionamento per due modelli:
| Modello | Input / output per 1M di token | Contesto | Immagini | Tool documentati |
|---|---|---|---|---|
| GLM 5.3 | $0.78 / $3.46 | 1.048.576 | No | Sì |
| Qwen3.8 27B | $0.175 / $2.17 | 262.144 | Sì | Sì |
| DeepSeek V4.1 Flash | $0.175 / $0.52 | 1.048.576 | Sì | Non documentati |
GLM 5.3 è il modello principale naturale per i repository grandi. Qwen3.8 27B costa meno per token di input e va bene per le immagini e per le chiamate in background più leggere. Entrambi richiedono una ricarica; non sono coperti dal credito iniziale di $5. Il confronto tra GLM 5.3 e Qwen3.8 27B li mette fianco a fianco.
Puoi usare il piano flat di BroadNet con Claude Code?
Non è una combinazione documentata, ed è meglio saperlo prima di acquistare. I piani Full Moon, Orbit e Meteor coprono solo DeepSeek V4.1 Flash, e BroadNet non documenta il tool calling per quel modello. Ogni sessione del piano esegue inoltre una richiesta alla volta. Claude Code può far girare subagent e attività in background accanto al ciclo principale, e quelle richieste finirebbero in coda su un’unica sessione.
Se vuoi un prezzo flat, usa un agente che BroadNet documenta con il piano, come Aider. Per Claude Code, usa GLM 5.3 o Qwen3.8 27B a consumo, che consentono 30 richieste al minuto e 4 in corso per chiave. Sui 429 applica il backoff come in errori e retry.
Quando conviene un altro agente?
Se non ti serve proprio Claude Code, salta il proxy. opencode, Cline, Roo Code, Continue e Aider accettano tutti direttamente una base URL compatibile con OpenAI, una chiave e un ID modello. I nomi dei campi per ciascuno sono in modelli open-weight negli agenti di coding, con guide di configurazione per opencode e Cline. Meno pezzi in movimento significa meno bug di traduzione. Per confrontare i modelli per questo lavoro, vedi il miglior modello open-weight per gli agenti di coding.
Resta sui modelli Claude se il tuo lavoro dipende da funzioni specifiche di Claude come extended thinking, il prompt caching di Anthropic o le beta più recenti di Claude Code. In quel caso, riduci i costi dentro Claude Code invece di cambiare modello.
Dove si colloca BroadNet Inference
BroadNet Inference è un’API compatibile con OpenAI, quindi arriva a Claude Code solo tramite un proxy come LiteLLM. Dietro un proxy, GLM 5.3 e Qwen3.8 27B sono i due modelli con tool calling documentato, fatturati per token e senza contenuti conservati dopo la richiesta. Se vuoi un endpoint nativo in formato Anthropic, DeepSeek e Z.ai sono più semplici. Se vuoi il piano flat di BroadNet, abbinalo a un agente che parla il formato OpenAI.
