O Claude Code envia toda requisição no formato Messages API da Anthropic, para /v1/messages no endereço que ANTHROPIC_BASE_URL indicar. A maioria dos provedores de modelos abertos, inclusive a BroadNet Inference, fala o formato OpenAI. Então você precisa de um proxy que traduza entre os dois ou de um provedor que publique um endpoint próprio no formato Anthropic. Este post cobre os dois caminhos, além dos limites que decidem se vale a pena.
Por que o Claude Code não chama uma API compatível com a OpenAI diretamente?
O guia de compatibilidade de gateways do Claude Code lista os formatos que um gateway precisa expor. Para uma base URL simples, é o Anthropic Messages: /v1/messages, com /v1/messages/count_tokens opcional, e os headers anthropic-beta e anthropic-version repassados. Uma API compatível com a OpenAI serve /v1/chat/completions, com formato de requisição e resposta diferente. Aponte o Claude Code direto para ela e as requisições falham.
Mais uma coisa antes de começar. A própria documentação do Claude Code diz que a Anthropic “doesn’t support routing Claude Code to non-Claude models through any gateway” (tradução: não dá suporte a rotear o Claude Code para modelos não Claude por nenhum gateway). Muita gente faz mesmo assim, mas ninguém na Anthropic vai depurar isso para você.
Quais são as suas três opções?
| Caminho | Como funciona | Melhor para | Contrapartida |
|---|---|---|---|
| Proxy tradutor (LiteLLM) | O Claude Code fala formato Anthropic com um proxy local; o proxy chama o provedor compatível com a OpenAI | Usar um provedor compatível com a OpenAI específico, como a BroadNet | Mais um processo para rodar e atualizar; lacunas de tradução |
| Endpoint nativo no formato Anthropic | O próprio provedor aceita /v1/messages |
Modelos DeepSeek ou GLM direto dos criadores | Cada um mapeia ou ignora alguns campos |
| Outro agente | Use um agente que aceite uma base URL compatível com a OpenAI | Quem não precisa especificamente do Claude Code | Você abre mão da interface e dos recursos do Claude Code |
Como rodar o Claude Code pelo LiteLLM?
O tutorial do LiteLLM para modelos que não são da Anthropic funciona assim: instale o proxy, defina os modelos em config.yaml, inicie-o e depois defina duas variáveis no Claude Code. O LiteLLM traduz entre os formatos, então o Claude Code continua enviando requisições Anthropic.
Defina os modelos da BroadNet do mesmo jeito que no guia do LiteLLM, com o prefixo 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
Inicie o 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
Depois aponte o Claude Code para ele. O ANTHROPIC_AUTH_TOKEN sai como header Authorization: Bearer, que é o que o LiteLLM lê:
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
Rode /status no Claude Code. A linha Anthropic base URL deve mostrar o endereço do proxy.
As variáveis de modelo importam. A página do LiteLLM sobre o Claude Code avisa que escolher um nome interno do Claude que a sua configuração não define falha com “Invalid model name passed in” (tradução: nome de modelo inválido). A referência de variáveis de ambiente do Claude Code diz que ANTHROPIC_DEFAULT_HAIKU_MODEL também é usado em funções de segundo plano, então mapeie-o também, senão as requisições de segundo plano pedem um nome Haiku que o proxy não conhece. CLAUDE_CODE_SUBAGENT_MODEL define o modelo padrão dos subagentes, mas o modelo que o Claude passa ao criar um, muitas vezes um alias como sonnet ou haiku, tem precedência. Mapear também os aliases sonnet e opus faz essas requisições caírem num modelo que o proxy conhece. Guarde a sua chave da BroadNet no ambiente do proxy, nunca num .claude/settings.json de projeto que vai para o repositório.
Quais endpoints da DeepSeek e do GLM funcionam sem proxy?
Dois criadores de modelos publicam base URLs no formato Anthropic:
| Provedor | Base URL | Tratamento dos modelos (pela documentação deles, conferida em 2026-11-15) |
|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic |
Nomes claude-sonnet* e claude-haiku* são mapeados para deepseek-flash; claude-opus* para deepseek-v4-pro; nomes que não começam com claude retornam 400 |
| Z.ai (GLM Coding Plan) | https://api.z.ai/api/anthropic |
Chave em ANTHROPIC_AUTH_TOKEN; o exemplo de configuração manual mapeia Opus e Sonnet para glm-5.3[1m] e Haiku para glm-5.3-flash[1m] |
A nota de lançamento da DeepSeek de 10 de setembro de 2026 diz que deepseek-flash serve o DeepSeek-V4.1-Flash. A página da Anthropic API dela também lista o que é ignorado: cache_control, budget_tokens, disable_parallel_tool_use e o header anthropic-version, entre outros. No deepseek-flash, imagens em mensagens do assistente retornam 400, e o deepseek-v4-pro troca as imagens por “[Unsupported Image]”.
Se você só quer DeepSeek ou GLM no Claude Code, esses endpoints nativos são o caminho mais curto. Preços e limites de plano dos dois estão comparados na página de alternativas à API do Claude.
O que quebra ou muda com um modelo não Claude?
A tradução mantém as requisições fluindo, mas vários recursos do Claude Code dependem de coisas que um proxy ou outro modelo podem não repassar. A documentação do Claude Code cita estes:
- Prompt caching. O Claude Code marca os blocos
systeme de mensagens comcache_control. Se o gateway ou o serviço upstream descartar isso, não há erro, mas cada turno é cobrado como entrada sem cache. Num upstream compatível com a OpenAI, o cache segue as regras daquele provedor. A BroadNet cobra a entrada em cache por um preço menor quando o bloco usage dela informa um cache hit; confiracached_tokensnos seus logs. - Contagem de tokens. Sem
/v1/messages/count_tokens, o Claude Code recorre a uma estimativa por caracteres, então o/contexté aproximado. - Janela de contexto. O Claude Code aplica a própria janela padrão a nomes de modelo que não reconhece. Defina
CLAUDE_CODE_AUTO_COMPACT_WINDOW(de 100.000 a 1.000.000 de tokens) de acordo com o modelo. Para o Qwen3.8 27B, com contexto de 262.144 tokens, defina bem abaixo disso. - Campos desconhecidos. Um
400citandoExtra inputs are not permittedou um valor deanthropic-betasignifica que algo no upstream rejeitou um campo de pré-lançamento. A documentação sugereCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1. - Raciocínio.
MAX_THINKING_TOKENSe o adaptive thinking são recursos do Claude. Na BroadNet, DeepSeek V4.1 Flash, GLM 5.3 e Qwen3.8 27B raciocinam antes de responder, e esses tokens de raciocínio contam nomax_tokens. Se as respostas voltarem vazias, aumente o limite de saída ou enviereasoning_effortbaixo. Veja por que modelos de raciocínio devolvem respostas vazias. - Imagens. Na BroadNet, o GLM 5.3 aceita só texto. Use o Qwen3.8 27B se você cola capturas de tela.
Teste uma tarefa real de ponta a ponta, com edição de arquivos, comandos de shell e uma sessão longa, antes de depender disso.
Qual modelo da BroadNet colocar por trás do Claude Code?
O Claude Code lê arquivos, edita e roda comandos por meio de chamadas de ferramenta. A referência da API da BroadNet documenta ferramentas, saída estruturada e raciocínio para dois modelos:
| Modelo | Entrada / saída por 1M de tokens | Contexto | Imagens | Ferramentas documentadas |
|---|---|---|---|---|
| GLM 5.3 | $0.78 / $3.46 | 1.048.576 | Não | Sim |
| Qwen3.8 27B | $0.175 / $2.17 | 262.144 | Sim | Sim |
| DeepSeek V4.1 Flash | $0.175 / $0.52 | 1.048.576 | Sim | Não documentadas |
O GLM 5.3 é o modelo principal natural para repositórios grandes. O Qwen3.8 27B custa menos por token de entrada e serve para imagens e chamadas de segundo plano mais leves. Os dois exigem uma recarga; não são cobertos pelo crédito inicial de $5. A comparação entre GLM 5.3 e Qwen3.8 27B mostra os dois lado a lado.
Dá para usar o plano de preço fixo da BroadNet com o Claude Code?
Não como uso documentado, e é melhor saber disso antes de comprar. Os planos Full Moon, Orbit e Meteor cobrem só o DeepSeek V4.1 Flash, e a BroadNet não documenta tool calling para ele. Cada sessão do plano também roda uma requisição por vez. O Claude Code pode rodar subagentes e tarefas de segundo plano junto com o loop principal, e essas requisições ficariam na fila de uma única sessão.
Se o que você quer é preço fixo, use um agente que a BroadNet documenta com o plano, como o Aider. Para o Claude Code, use GLM 5.3 ou Qwen3.8 27B com pagamento por uso, que permitem 30 requisições por minuto e 4 em andamento por chave. Faça backoff nos 429 como em erros e novas tentativas.
Quando outro agente é a melhor escolha?
Se você não precisa do Claude Code em si, pule o proxy. opencode, Cline, Roo Code, Continue e Aider aceitam diretamente uma base URL compatível com a OpenAI, uma chave e um ID de modelo. Os nomes dos campos de cada um estão em modelos abertos em agentes de código, com guias de configuração para o opencode e o Cline. Menos peças móveis significa menos bugs de tradução. Para comparar modelos para esse trabalho, veja melhor modelo aberto para agentes de código.
Fique nos modelos Claude se o seu trabalho depende de recursos específicos do Claude, como extended thinking, o prompt caching da Anthropic ou as betas mais novas do Claude Code. Nesse caso, reduza os custos dentro do Claude Code em vez de trocar o modelo.
Onde a BroadNet Inference se encaixa
A BroadNet Inference é uma API compatível com a OpenAI, então só chega ao Claude Code por meio de um proxy como o LiteLLM. Por trás de um proxy, GLM 5.3 e Qwen3.8 27B são os dois modelos com tool calling documentado, cobrados por token e sem conteúdo retido depois da requisição. Se você quer um endpoint nativo no formato Anthropic, DeepSeek e Z.ai são mais simples. Se você quer o plano de preço fixo da BroadNet, combine-o com um agente que fale o formato OpenAI.
