BroadRouter
Começar

Modelos abertos em agentes de código: Aider, Cline, opencode, Codex

Pela equipe da BroadNet Inference · 4 min de leitura · Publicado em · Atualizado em

Todo agente de código importante pede três valores para um modelo personalizado: uma base URL, uma chave de API e um ID de modelo. O Aider usa OPENAI_API_BASE, Cline e Roo Code um provedor OpenAI Compatible, o opencode um provedor personalizado e o Continue apiBase. O Codex CLI agora só fala a Responses API, então um endpoint de chat completions precisa de um proxy tradutor como o LiteLLM.

A developer working at a laptop with code on screen, at dusk.

Os agentes de código foram feitos para um ou dois grandes provedores, mas hoje quase todos aceitam um endpoint personalizado compatível com a OpenAI. Isso permite rodá-los com modelos abertos: mais baratos por tarefa, muitas vezes com contexto maior e numa infraestrutura escolhida por você. Esta página é o mapa. Ela traz os nomes exatos das configurações de cada agente e leva a um guia completo passo a passo quando temos um.

O que você precisa do provedor?

Todos os agentes abaixo pedem os mesmos três valores:

Valor BroadNet Inference
Base URL https://inference.broadnet.ai/v1
Chave de API A sua chave de pagamento por uso ou do plano
ID do modelo broadnet/glm-5.3, broadnet/deepseek-v4.1-flash ou broadnet/qwen3.8-27b

Mais duas configurações importam em todo agente: a janela de contexto e o máximo de tokens de saída. Os agentes não conseguem detectá-las para IDs de modelos personalizados, então chutam. Defina-as com os valores da página de modelos.

Agente por agente: as configurações exatas

Agente Onde configurar Campo da base URL Campo do modelo Guia completo
Aider Variáveis de ambiente OPENAI_API_BASE --model openai/<id> Guia do Aider
Cline Configurações, API Provider: OpenAI Compatible Base URL Model Guia do Cline
Roo Code / Zoo Code Configurações, API Provider: OpenAI Compatible Base URL Model Guia do Roo Code
opencode opencode.jsonc, providers settings.baseURL models.<key>.modelID Guia do opencode
Continue config.yaml, provider: openai apiBase model Guia do Continue
Codex CLI config.toml, [model_providers.<id>] base_url model Veja abaixo

Aider

export OPENAI_API_BASE=https://inference.broadnet.ai/v1
export OPENAI_API_KEY=your-key
aider --model openai/broadnet/deepseek-v4.1-flash

O prefixo openai/ diz ao Aider para usar a rota compatível com a OpenAI. O Aider pode avisar que não conhece o tamanho de contexto do modelo; isso é esperado para modelos fora da lista dele.

Cline

Escolha OpenAI Compatible como API Provider e preencha Base URL, API Key e Model. Abra Model Configuration e defina a janela de contexto e o máximo de tokens de saída. O Cline pode usar modelos diferentes nos modos Plan e Act, um jeito barato de reservar o modelo mais caro para o planejamento.

Roo Code e Zoo Code

O repositório do Roo Code foi arquivado em 15 de maio de 2026, e o README diz que a extensão foi encerrada. Ele indica o Zoo Code, um fork iniciado pela comunidade do Roo Code que continua o seu desenvolvimento, e o Cline. Instalações existentes do Roo Code usam os mesmos campos OpenAI Compatible do Cline, e o changelog do Roo mostra que o tool calling legado em XML foi removido, então escolha um modelo com tool calling nativo listado. Para o Zoo Code, siga a documentação dele.

opencode

O opencode adiciona provedores em opencode.jsonc, dentro de providers, com o pacote compatível com a OpenAI e settings.baseURL. Os IDs da BroadNet já têm uma barra, então use uma chave curta como glm-5.3 e coloque o ID completo em modelID. Defina capabilities e limit você mesmo; senão o opencode recorre a suposições.

Continue

models:
  - name: GLM 5.3
    provider: openai
    model: broadnet/glm-5.3
    apiBase: https://inference.broadnet.ai/v1
    apiKey: your-key
    capabilities: [tool_use]
    defaultCompletionOptions:
      contextLength: 1048576
      maxTokens: 8000

O Continue precisa de tool_use para o modo Agent. Deixe de fora em modelos sem tool calling.

Codex CLI

O Codex define provedores em config.toml com base_url e env_key. A referência de configuração atual diz que responses é o único valor suportado de wire_api, e o Codex agora rejeita wire_api = "chat" com um erro. A BroadNet Inference serve /v1/chat/completions, então o Codex não consegue chamá-la diretamente. A saída é um proxy que traduz. A documentação do LiteLLM diz que o proxy dele expõe /v1/responses e pode fazer a ponte por chat completions:

  1. Rode o proxy LiteLLM com a BroadNet como backend compatível com a OpenAI e ative a ponte para chat completions como descreve a página do LiteLLM sobre a Responses API.
  2. Aponte a base_url do Codex para o proxy.
  3. Teste uma tarefa curta. Pontes podem perder recursos exclusivos da Responses API, então confira se as chamadas de ferramenta funcionam de ponta a ponta.

Se isso parece encanamento demais, o opencode e o Aider são agentes de terminal que falam chat completions nativamente.

Como testar o endpoint antes do agente?

Quando um agente falha, é difícil saber se o problema é o agente ou o endpoint. Confira primeiro o endpoint sozinho, com uma requisição que oferece uma ferramenta:

curl -s https://inference.broadnet.ai/v1/chat/completions \
  -H "Authorization: Bearer $BROADNET_API_KEY" -H "Content-Type: application/json" \
  -d '{"model":"broadnet/glm-5.3","max_tokens":2000,
       "messages":[{"role":"user","content":"Read the file README.md"}],
       "tools":[{"type":"function","function":{"name":"read_file",
         "parameters":{"type":"object","properties":{"path":{"type":"string"}},"required":["path"]}}}]}'

Se a resposta tiver finish_reason: "tool_calls" e uma chamada a read_file, o modelo e a chave estão certos, e qualquer problema restante está nas configurações do agente. Se ele responder em texto simples, escolha outro modelo para agentes guiados por ferramentas. O construtor de requisições de API escreve essa requisição para você em curl, Python ou Node.

O que quebra com mais frequência?

  1. ID de modelo errado. Copie exatamente, incluindo o prefixo broadnet/.
  2. Respostas vazias. Os três modelos grandes raciocinam antes de responder, e o raciocínio conta no limite de saída. Aumente-o. Veja por que as respostas voltam vazias.
  3. Erros em chamadas de ferramenta. Use um modelo com tool calling listado. A BroadNet lista ferramentas para GLM 5.3 e Qwen3.8 27B, não para o DeepSeek V4.1 Flash. Mais sobre isso em tool calling com modelos abertos.
  4. Erros 429. Uma chave de pagamento por uso permite 30 requisições por minuto e 4 em andamento. Duas janelas do editor na mesma chave se somam. Veja erros e novas tentativas.
  5. Responses API por padrão. Algumas ferramentas usam por padrão a API mais nova da OpenAI. Mude para chat completions quando elas permitirem.

Qual modelo escolher para cada agente está em melhor modelo aberto para agentes de código. As diferenças entre os três agentes mais populares estão em Cline vs Roo Code vs Aider.

Onde a BroadNet Inference se encaixa

A BroadNet Inference dá a todos os agentes acima um único endpoint compatível com a OpenAI para GLM 5.3, DeepSeek V4.1 Flash e Qwen3.8 27B, com retenção zero de dados. Os planos ilimitados dela deixam o DeepSeek V4.1 Flash a um preço fixo de $60 por mês por sessão, o que combina com o Aider e outros agentes que rodam o dia todo. Ela não funciona direto com o Codex CLI sem um proxy, e não hospeda ferramentas do lado do provedor, como busca na web. Comece com uma chave em inference.broadnet.ai.

Perguntas frequentes

Posso usar o Codex CLI com uma API compatível com a OpenAI?

Só se o endpoint falar a Responses API. A referência de configuração do Codex lista responses como o único valor suportado de wire_api. Para um provedor que só oferece chat completions, coloque um proxy como o LiteLLM na frente; a documentação dele descreve como fazer a ponte de /v1/responses por /v1/chat/completions.

O Roo Code ainda é mantido?

Não. O repositório no GitHub foi arquivado em 15 de maio de 2026, e o README diz que a extensão foi encerrada. Ele indica o Zoo Code, que descreve como um fork iniciado pela comunidade do Roo Code, e o Cline.

Por que o meu agente diz que o modelo não foi encontrado?

O ID do modelo precisa ser exatamente igual ao do provedor. Os IDs da BroadNet têm um prefixo, por exemplo broadnet/glm-5.3. No Aider, você ainda adiciona o prefixo openai/ na frente.

Por que o agente devolve respostas vazias com um modelo aberto?

Modelos de raciocínio gastam parte do orçamento de saída pensando. Se o máximo de tokens de saída for baixo, a resposta visível nunca começa. Aumente para alguns milhares de tokens.

Qual modelo aberto devo colocar no meu agente de código?

Para agentes que trabalham com chamadas de ferramenta, use um modelo com tool calling listado, como o GLM 5.3. Para o Aider, o DeepSeek V4.1 Flash funciona bem e é coberto pelos planos ilimitados da BroadNet.

Ler em MarkdownPerguntar ao ChatGPTPerguntar ao ClaudePerguntar ao Perplexity