---
title: "opencode: provedor personalizado compatível com a OpenAI"
description: "Adicione a BroadNet Inference ao agente de código opencode como provedor personalizado compatível com a OpenAI no opencode.jsonc, com aliases, capacidades e limites."
url: https://broadrouter.com/pt/guides/opencode-custom-provider/
lang: pt-BR
updated: 2026-11-16
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/guides/opencode-custom-provider/) (atualizado em 2026-11-16).

# Adicionar a BroadNet Inference ao opencode como provedor personalizado

Atualizado em 2026-11-16

No opencode.jsonc, adicione uma entrada broadnet em providers com package @opencode/ai/providers/openai-compatible, settings.baseURL como https://inference.broadnet.ai/v1 e env como BROADNET\_API\_KEY. Mapeie chaves curtas para os IDs da BroadNet com modelID, como broadnet/glm-5.3, e escolha o modelo com /models. Configurações V1 antigas com npm @ai-sdk/openai-compatible e options.baseURL continuam funcionando.

O opencode é um agente de código open source para o terminal. Provedores que não estão no catálogo nativo dele são adicionados como **provedores personalizados** no `opencode.jsonc`. A BroadNet Inference fala o formato chat completions da OpenAI, então usa o pacote de runtime compatível com a OpenAI do opencode. Este guia segue a documentação atual (V2) do opencode.

## Configuração

1.  **Exporte a sua chave** no shell que inicia o opencode:

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **Crie a configuração.** Coloque no seu projeto como `opencode.jsonc`, ou em `~/.config/opencode/opencode.jsonc` para usar em todo lugar.

```jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "broadnet/glm-5.3",
  "providers": {
    "broadnet": {
      "name": "BroadNet Inference",
      "env": ["BROADNET_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "modelID": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "modelID": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          // BroadNet's docs don't list tool calling for this model: test it first
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "modelID": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        }
      }
    }
  }
}
```

3.  **Inicie o opencode e escolha o modelo** com `/models`. A referência é `broadnet/<map key>`, por exemplo `broadnet/glm-5.3`. O opencode envia à BroadNet o valor de `modelID`.

Os arquivos de configuração são mesclados. O opencode aplica primeiro o arquivo global, depois os arquivos de projeto encontrados subindo a partir do diretório atual (os mais distantes primeiro) e, por fim, qualquer configuração em `.opencode/`; assim, um arquivo de projeto pode sobrescrever o provedor global. A configuração de sistema gerenciada, se a sua empresa usar, tem prioridade sobre os dois. Mantenha a chave no ambiente, não no arquivo, para poder colocar a configuração no controle de versão.

## Por que os aliases

Os IDs da BroadNet já têm uma barra (`broadnet/glm-5.3`). A chave do mapa `models` é o que o opencode mostra e seleciona, e `modelID` é o que ele envia. Chaves curtas deixam as referências legíveis.

Defina `capabilities` e `limit` você mesmo. Para um modelo fora do catálogo, o opencode supõe suporte a ferramentas em JSON, entrada de texto e imagem, contexto de 200.000 tokens e 32.000 tokens de saída. A documentação dele chama isso de suposições de fallback, não de valores detectados. O valor `output` de 16000 acima é sugestão nossa, não um limite da BroadNet; ele deixa espaço para o raciocínio.

### Configurações V1 antigas

O opencode V2 ainda lê o formato V1, então um bloco existente como este continua funcionando:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BroadNet Inference",
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1",
        "apiKey": "{env:BROADNET_API_KEY}"
      },
      "models": {
        "broadnet/glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}
```

Na forma nativa V2, `provider` vira `providers`, `npm` vira `package` (`aisdk:@ai-sdk/openai-compatible` se quiser manter o pacote do AI SDK), e `options.baseURL` e `options.apiKey` passam para dentro de `settings`. O [guia de migração da V1 do opencode](https://opencode.ai/docs/migrate-v1/) mostra a correspondência de cada campo.

## Qual modelo escolher

| Tarefa | Modelo | Observações |
| --- | --- | --- |
| Código com agente e ferramentas | [GLM 5.3](https://broadrouter.com/pt/models/glm-5.3/) | Ferramentas e saída estruturada listadas; contexto de 1M |
| Screenshots, árabe | [Qwen3.8 27B](https://broadrouter.com/pt/models/qwen3.8-27b/) | Ferramentas e imagens; contexto de 262K |
| Sessões o dia inteiro, preço fixo | [DeepSeek V4.1 Flash](https://broadrouter.com/pt/models/deepseek-v4.1-flash/) | Planos ilimitados; ferramentas não listadas pela BroadNet |

O opencode depende de chamadas de ferramentas. A documentação da BroadNet não lista tool calling para o DeepSeek V4.1 Flash, então a configuração marca isso como uma suposição a testar. Rode uma tarefa real com uma hora de Meteor ($1) antes de comprar um mês de Full Moon ($60).

## Solução de problemas

-   **401.** A chave em `BROADNET_API_KEY` está errada, expirou ou ficou sem cota de pagamento por uso. Confirme que a variável está definida no processo que roda o opencode.
-   **Modelo não encontrado ou rejeitado.** Selecione a chave do mapa (`broadnet/glm-5.3`) e confira se `modelID` é exatamente o ID da BroadNet. As referências diferenciam maiúsculas de minúsculas. Os modelos pagos exigem uma recarga; o crédito de $5 cobre só `broadnet/gemma-4-26b-a4b` e os dois modelos Transcribe.
-   **Respostas vazias.** Aumente `limit.output`. [Por que as respostas voltam vazias](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/).
-   **429.** Chaves de pagamento por uso permitem 30 requisições por minuto e 4 em andamento. As novas tentativas também contam. Veja [erros e novas tentativas](https://broadrouter.com/pt/guides/errors-and-retries/).
-   **Subagentes num plano.** Cada [sessão do plano](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/) atende uma requisição por vez, então subagentes em paralelo entram na fila, a menos que cada um tenha a própria sessão.

## Termos neste guia

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

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

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

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

[Rate limit (limite de taxa)](https://broadrouter.com/pt/glossary/rate-limit/)

Um rate limit é um teto que uma API impõe a quanto um cliente pode usá-la em um intervalo de tempo, como requisições por minuto ou tokens por minuto. As requisições acima do limite são recusadas, normalmente com HTTP 429 Too Many Requests, até que o uso volte a ficar abaixo dele.

[Subagente (subagent)](https://broadrouter.com/pt/glossary/subagent/)

Um subagente é um agente separado que um agente principal inicia para cuidar de uma tarefa específica. Ele roda com a própria janela de contexto, o próprio system prompt e acesso próprio a ferramentas, faz o trabalho e devolve ao agente principal só um resultado ou resumo, o que mantém a conversa principal pequena.

[Agente de programação com IA (AI coding agent)](https://broadrouter.com/pt/glossary/coding-agent/)

Um agente de programação com IA é uma ferramenta de software em que um modelo de linguagem trabalha numa codebase em ciclo: lê arquivos, edita, roda comandos como os testes, lê a saída e decide o próximo passo até a tarefa terminar ou um limite ser atingido.

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

## Perguntas frequentes

### Por que o opencode não encontra meu modelo da BroadNet?

O opencode resolve a referência como provedor/chave do mapa, e os IDs diferenciam maiúsculas de minúsculas. Com a configuração abaixo, selecione broadnet/glm-5.3, em que glm-5.3 é a chave do mapa. O valor de modelID é só o que é enviado à BroadNet.

### Minha configuração usa provider e npm com @ai-sdk/openai-compatible. Está errado?

Não. Esse é o formato V1, e o guia de migração do opencode diz que ele continua suportado. A forma nativa V2 renomeia provider para providers, npm para package (aisdk:@ai-sdk/openai-compatible) e options.baseURL para settings.baseURL.

### Por que as respostas do opencode vêm vazias?

O modelo gastou o orçamento de saída com raciocínio. Aumente limit.output desse modelo. Na BroadNet, o raciocínio conta em max\_tokens.

## Guias relacionados

-   [Use o Cline com a BroadNet Inference (provedor OpenAI Compatible)](https://broadrouter.com/pt/guides/cline-openai-compatible/)
-   [Como funcionam os planos de API de LLM ilimitada para agentes](https://broadrouter.com/pt/guides/unlimited-llm-api-sessions/)
-   [Por que um modelo de raciocínio devolve uma resposta vazia](https://broadrouter.com/pt/guides/reasoning-tokens-empty-response/)
-   [Como usar o Vercel AI SDK com a BroadNet Inference](https://broadrouter.com/pt/guides/vercel-ai-sdk-openai-compatible/)
-   [Todas as ferramentas que funcionam com a BroadNet Inference (em inglês)](https://broadrouter.com/integrations/): SDKs, agentes de programação, interfaces de chat e ferramentas de automação, com as configurações exatas de cada uma

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-guides-opencode-custom-provider&utm_content=page-cta) ·

**Fontes**

-   [Documentação do opencode, Providers (provedor personalizado) (conferido em 2026-11-14)](https://opencode.ai/docs/providers/)
-   [Documentação do opencode, Models (aliases, capacidades, limites) (conferido em 2026-11-14)](https://opencode.ai/docs/models/)
-   [Documentação do opencode, locais dos arquivos de configuração (conferido em 2026-11-14)](https://opencode.ai/docs/config/)
-   [Documentação do opencode, migração da V1 (conferido em 2026-11-14)](https://opencode.ai/docs/migrate-v1/)
-   [Referência da API da BroadNet Inference (em inglês)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=pt-guides-opencode-custom-provider&utm_content=sources)
