---
title: "Qualquer modelo compatível com OpenAI no agente de código"
description: "Conecte Aider, Cline, Roo Code, opencode, Continue e Codex CLI a qualquer endpoint compatível com a OpenAI: nomes exatos dos campos e as configurações que quebram."
url: https://broadrouter.com/pt/blog/use-open-models-in-coding-agents/
lang: pt-BR
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduzido do inglês com ajuda de IA. [Leia o original em inglês](https://broadrouter.com/blog/use-open-models-in-coding-agents/) (atualizado em 2026-11-16).

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

Pela equipe da BroadNet Inference · 4 min de leitura · Publicado em 2026-11-14 · Atualizado em 2026-11-16

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.

## Pontos principais

-   Três valores conectam qualquer agente: base URL (https://inference.broadnet.ai/v1 na BroadNet), chave de API e o ID exato do modelo.
-   Defina você mesmo o tamanho do contexto e o máximo de tokens de saída. Os agentes não conseguem detectá-los para IDs de modelos personalizados.
-   Agentes guiados por ferramentas precisam de um modelo com tool calling; os formatos de edição em texto do Aider, não.
-   A referência de configuração do Codex CLI lista responses como o único wire\_api suportado, então ele não chama diretamente uma API que só oferece chat completions.
-   O Roo Code foi arquivado em 15 de maio de 2026. O Zoo Code é um fork da comunidade que dá continuidade a ele; o Cline é o projeto upstream.

**Nesta página**

1.  O que você precisa do provedor?
2.  Agente por agente: as configurações exatas
3.  Como testar o endpoint antes do agente?
4.  O que quebra com mais frequência?
5.  Onde a BroadNet Inference se encaixa

_[image: 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://broadrouter.com/pt/glossary/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](https://broadrouter.com/pt/models/).

## 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](https://broadrouter.com/pt/guides/aider-unlimited-deepseek/) |
| Cline | Configurações, API Provider: OpenAI Compatible | Base URL | Model | [Guia do Cline](https://broadrouter.com/pt/guides/cline-openai-compatible/) |
| Roo Code / Zoo Code | Configurações, API Provider: OpenAI Compatible | Base URL | Model | [Guia do Roo Code](https://broadrouter.com/pt/guides/roo-code-openai-compatible/) |
| opencode | `opencode.jsonc`, `providers` | `settings.baseURL` | `models.<key>.modelID` | [Guia do opencode](https://broadrouter.com/pt/guides/opencode-custom-provider/) |
| Continue | `config.yaml`, `provider: openai` | `apiBase` | `model` | [Guia do Continue](https://broadrouter.com/pt/guides/continue-dev-openai-compatible/) |
| Codex CLI | `config.toml`, `[model_providers.<id>]` | `base_url` | `model` | Veja abaixo |

### Aider

```bash
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

```yaml
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](https://broadrouter.com/pt/guides/litellm-proxy-custom-provider/) 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:

```bash
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](https://broadrouter.com/tools/api-request-builder/) 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](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
3.  **Erros em chamadas de ferramenta.** Use um modelo com [tool calling](https://broadrouter.com/pt/glossary/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](https://broadrouter.com/pt/blog/tool-calling-open-models/).
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](https://broadrouter.com/pt/guides/errors-and-retries/).
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](https://broadrouter.com/pt/blog/best-open-model-for-coding-agents/). As diferenças entre os três agentes mais populares estão em [Cline vs Roo Code vs Aider](https://broadrouter.com/pt/blog/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](https://inference.broadnet.ai/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-blog-use-open-models-in-coding-agents&utm_content=body).

Ferramentas gratuitas sobre o tema (em inglês)

-   [Agent run cost estimator](https://broadrouter.com/tools/agent-run-cost-estimator/) Context growth per step, total tokens and cost of one agent run, with a DeepSeek session comparison.
-   [LLM batch job planner](https://broadrouter.com/tools/llm-batch-job-planner/) Run time, binding limit, cost per model and the flat sessions needed to finish a big job by a deadline.
-   [Flat-rate vs per-token LLM cost calculator](https://broadrouter.com/tools/flat-rate-vs-per-token-calculator/) Break-even between an unlimited plan and paying per token, per agent.
-   [LLM rate limit and concurrency calculator](https://broadrouter.com/tools/llm-rate-limit-calculator/) Which limit binds first: RPM, TPM or concurrency, with Little's law.

[Ferramentas gratuitas (em inglês)](https://broadrouter.com/tools/)

## Termos neste artigo

[Tool calling (chamada de ferramentas)](https://broadrouter.com/pt/glossary/tool-calling/)

Tool calling, também chamado de function calling ou chamada de ferramentas, é um recurso de APIs de LLM em que o modelo devolve um pedido estruturado para executar uma função definida pelo desenvolvedor, com argumentos JSON. A aplicação executa a função e devolve o resultado; o modelo nunca executa código sozinho.

[Base URL (URL base)](https://broadrouter.com/pt/glossary/base-url/)

A base URL é o endereço raiz fixo de uma API, como https://api.example.com/v1, que um cliente coloca antes de cada caminho de endpoint, como /chat/completions. Nos SDKs compatíveis com a OpenAI, trocar a base URL, junto com a chave de API e o ID do modelo, aponta o mesmo código para outro provedor.

[Token](https://broadrouter.com/pt/glossary/token/)

Um token é a unidade de texto que um modelo de linguagem lê e escreve: uma palavra, parte de uma palavra, um sinal de pontuação ou uma sequência de bytes gerada pelo tokenizador do modelo. As APIs de LLM contam, limitam e normalmente cobram o uso em tokens.

[Chat Completions API](https://broadrouter.com/pt/glossary/chat-completions-api/)

A Chat Completions API é o endpoint HTTP da OpenAI, POST /v1/chat/completions, que recebe o nome de um modelo e uma lista de mensagens marcadas com papéis e devolve a próxima mensagem do modelo. O formato da requisição e da resposta virou o padrão comum que provedores e SDKs compatíveis com a OpenAI reutilizam.

[Pagamento por uso (pay-as-you-go)](https://broadrouter.com/pt/glossary/pay-as-you-go/)

Pagamento por uso é um modelo de preço em que você paga só pelo que usa, medido por unidade, como tokens, requisições ou minutos de áudio, sem assinatura nem compromisso mínimo. A maioria das APIs de LLM cobra assim, a partir de um saldo pré-pago ou de uma fatura periódica.

[Chave de API (API key)](https://broadrouter.com/pt/glossary/api-key/)

Uma chave de API é uma string secreta que identifica e autoriza um cliente que chama uma API. As APIs de LLM normalmente a esperam em um cabeçalho Authorization: Bearer, e qualquer pessoa que tenha a chave pode fazer requisições cobradas da conta dona dela.

[Concorrência (concurrency)](https://broadrouter.com/pt/glossary/concurrency/)

Concorrência é o número de requisições que um cliente tem em andamento ao mesmo tempo. APIs de LLM muitas vezes a limitam por chave ou por plano, separadamente das requisições por minuto, porque cada requisição aberta ocupa capacidade de GPU até a resposta terminar.

[Janela de contexto (context window)](https://broadrouter.com/pt/glossary/context-window/)

A janela de contexto é o número máximo de tokens com que um modelo de linguagem consegue trabalhar em uma única requisição. Ela abrange o prompt, o histórico da conversa, as definições de ferramentas, as imagens e a saída gerada, incluindo os tokens de raciocínio. O que não couber precisa ser cortado, resumido ou dividido em várias requisições.

## 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.

## Continue lendo

-   [Claude Code com modelos abertos: proxies, endpoints nativos e limites](https://broadrouter.com/pt/blog/claude-code-with-openai-compatible-models/)
-   [Melhor modelo aberto para agentes de código: ferramentas e custo](https://broadrouter.com/pt/blog/best-open-model-for-coding-agents/)
-   [Cline vs Roo Code vs Aider para equipes com modelos abertos (2026)](https://broadrouter.com/pt/blog/cline-vs-roo-code-vs-aider/)
-   [Servidores MCP com modelos compatíveis com OpenAI (qualquer provedor)](https://broadrouter.com/pt/blog/mcp-with-openai-compatible-models/)
-   [Migrar para uma API compatível com a OpenAI: checklist de migração](https://broadrouter.com/pt/blog/openai-compatible-api-migration-checklist/)
-   [Custo de uma execução de agente de código: passos, contexto e cache](https://broadrouter.com/pt/blog/ai-coding-agent-run-cost/)
-   [OpenClaw e Hermes Agent com um modelo barato: setup e custos](https://broadrouter.com/pt/blog/openclaw-hermes-agent-cheap-model/)
-   [Guia: Rode o Aider no DeepSeek V4.1 Flash ilimitado](https://broadrouter.com/pt/guides/aider-unlimited-deepseek/)
-   [Guia: Use o Cline com a BroadNet Inference (provedor OpenAI Compatible)](https://broadrouter.com/pt/guides/cline-openai-compatible/)
-   [Guia: Usar o Roo Code com a BroadNet Inference (OpenAI Compatible)](https://broadrouter.com/pt/guides/roo-code-openai-compatible/)
-   [Guia: Adicionar a BroadNet Inference ao opencode como provedor personalizado](https://broadrouter.com/pt/guides/opencode-custom-provider/)
-   [Guia: Use o Continue com a BroadNet Inference (config.yaml e apiBase)](https://broadrouter.com/pt/guides/continue-dev-openai-compatible/)
-   [Guia: Como rotear o LiteLLM para a BroadNet Inference (SDK e proxy)](https://broadrouter.com/pt/guides/litellm-proxy-custom-provider/)

Teste com a sua carga de trabalho real. Contas novas começam com US$ 5 de crédito para Gemma e transcrição. DeepSeek, GLM e Qwen3.8 exigem uma recarga.

[Começar](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-blog-use-open-models-in-coding-agents&utm_content=page-cta) ·

**Fontes**

-   [Documentação do Aider, APIs compatíveis com a OpenAI](https://aider.chat/docs/llms/openai-compat.html)
-   [Documentação do Aider, referência de opções (--message, --yes-always; conferida em 2026-11-14)](https://aider.chat/docs/config/options.html)
-   [Documentação do Cline, provedor OpenAI Compatible](https://docs.cline.bot/provider-config/openai-compatible)
-   [Repositório do Roo Code, aviso de arquivamento (conferido em 2026-11-14)](https://github.com/RooCodeInc/Roo-Code)
-   [Changelog do Roo Code, tool calling legado em XML removido (conferido em 2026-11-16)](https://github.com/RooCodeInc/Roo-Code/blob/main/CHANGELOG.md)
-   [Repositório do Zoo Code (conferido em 2026-11-14)](https://github.com/Zoo-Code-Org/Zoo-Code)
-   [Documentação do opencode, Providers](https://opencode.ai/docs/providers/)
-   [Documentação do Continue, provedor OpenAI](https://docs.continue.dev/customize/model-providers/top-level/openai)
-   [Documentação do Continue, referência do config.yaml (capabilities, defaultCompletionOptions; conferida em 2026-11-14)](https://docs.continue.dev/reference)
-   [Referência de configuração do Codex, model\_providers e wire\_api (conferida em 2026-11-14)](https://learn.chatgpt.com/docs/config-file/config-reference)
-   [Documentação do LiteLLM, ponte de /v1/responses para chat completions (conferida em 2026-11-14)](https://docs.litellm.ai/docs/response_api)
