Resposta rápida: Você pode rodar o ERNIE 5.5 Flash gratuitamente no OpenCode e no Claude Code por meio do endpoint baidu/ernie-5.5-flash-preview:free da OpenRouter. No OpenCode, conecte a OpenRouter e defina "model": "openrouter/baidu/ernie-5.5-flash-preview:free". No Claude Code, aponte o ANTHROPIC_BASE_URL para a OpenRouter e fixe o slug do ERNIE como seu modelo. Custa $0 por token, mas, sem créditos comprados, você tem direito a 50 requisições por dia.
Esse limite diário é toda a história quando se trata de agentes de codificação. Um agente não faz uma requisição por tarefa; ele faz uma por etapa. Este guia configura ambos os agentes, mostra uma tarefa de codificação que cabe no orçamento gratuito e indica onde a rota gratuita falha.
Todos os limites abaixo foram verificados nas páginas oficiais da OpenRouter em 12 de novembro de 2026.
O que é o ERNIE 5.5 Flash Preview?
O ERNIE 5.5 Flash Preview é o modelo de chat e agentes da Baidu lançado em 10 de novembro de 2026. É um modelo esparso de mistura de especialistas (mixture-of-experts) com 280 bilhões de parâmetros totais, 14 bilhões ativos por token e uma janela de contexto de 1.024.000 tokens. A Baidu o posiciona para codificação, trabalho com agentes e pesquisa profunda, e a OpenRouter o lista como habilitado para raciocínio com suporte a chamadas de ferramentas.
Também existe um ERNIE 5.5 Flash Base, somente pré-treinamento, no Hugging Face, mas esse é o modelo para você fazer fine-tuning ou servir por conta própria. O Preview é aquele com o qual seu agente de codificação conversa. Para uma análise completa do modelo, leia o que é o ERNIE 5.5 Flash. Se você vem da geração anterior, o panorama do ERNIE 5.1 cobre o que mudou.
Limites do ERNIE 5.5 Flash gratuito na OpenRouter
A página do modelo da OpenRouter mostra a variante :free com $0 de entrada e $0 de saída, servida por um único provedor, a Baidu Qianfan. Os limites de taxa vêm da documentação de limites da OpenRouter e se aplicam a todos os IDs de modelo que terminam em :free.
| Item | Valor (verificado em 12/11/2026) |
|---|---|
| ID do modelo | baidu/ernie-5.5-flash-preview:free |
| Preço | $0 de entrada, $0 de saída |
| Janela de contexto | 1.024.000 tokens |
| Requisições por minuto | 20 |
| Requisições por dia, com menos de 10 créditos já comprados | 50 |
| Requisições por dia, com 10 ou mais créditos já comprados | 1.000 |
| Provedores por trás dele | 1 (Baidu Qianfan) |
Dois detalhes importam para agentes. A página de preços da OpenRouter diz que tentativas com falha contam para o limite diário. E um saldo de crédito negativo bloqueia os modelos gratuitos com um 402 até você recarregar.
O nível de 1.000 por dia depende dos créditos que você comprou, não dos créditos que você gastou.
Configurar o ERNIE 5.5 Flash no OpenCode
O OpenCode oferece suporte nativo à OpenRouter, então esta é a configuração mais simples das duas. Você precisa de uma conta na OpenRouter e de uma chave de API do seu painel da OpenRouter.
- Instale ou atualize o OpenCode e inicie-o na pasta do seu projeto:
cd your-project
opencode
- Conecte a OpenRouter. Dentro do OpenCode, execute
/connect, escolha OpenRouter e cole sua chave. Você também pode exportá-la antes de iniciar:
export OPENROUTER_API_KEY="sk-or-v1-..."
- Fixe o modelo no
opencode.json, na raiz do projeto. A documentação de provedores do OpenCode diz para usar o ID completo do modelo da OpenRouter após o prefixoopenrouter/:
{
"$schema": "https://opencode.ai/config.json",
"model": "openrouter/baidu/ernie-5.5-flash-preview:free"
}
- Confirme a seleção com
/models. Se o ERNIE não aparecer na lista, o valor da configuração ainda prevalece, então verifique a grafia do slug, incluindo:free.
Agora, cada prompt vai para o ERNIE 5.5 Flash Preview por meio da OpenRouter. Se você seguiu nosso guia do GLM-5.3-Flash no OpenCode ou o do DeepSeek V4.1 Flash, o padrão é idêntico: apenas o slug muda.
Configurar o ERNIE 5.5 Flash no Claude Code
O Claude Code pode conversar com a OpenRouter porque a OpenRouter expõe um endpoint de Messages compatível com a Anthropic. A página do modelo ERNIE lista POST https://openrouter.ai/api/v1/messages como uma rota suportada para este modelo.
Primeiro, deixe claro o nível de suporte. O guia de integração do Claude Code da OpenRouter afirma que o Claude Code com OpenRouter "só tem garantia de funcionar com o provedor first-party da Anthropic" e que o Claude Code "pode não funcionar corretamente com outros provedores". Rodar o ERNIE aqui funciona por meio de configurações documentadas, mas não é um par garantido.
- Defina as variáveis de conexão no seu perfil de shell, exatamente como a OpenRouter as documenta:
export OPENROUTER_API_KEY="sk-or-v1-..."
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY="" # must be explicitly empty
- Fixe o ERNIE para todas as classes de modelo que o Claude Code usa, para que nenhuma etapa retorne silenciosamente a um modelo pago da Anthropic:
export ANTHROPIC_DEFAULT_OPUS_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_SONNET_MODEL="baidu/ernie-5.5-flash-preview:free"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="baidu/ernie-5.5-flash-preview:free"
Você pode colocar as mesmas chaves no bloco env do .claude/settings.json se quiser que a configuração fique restrita a um único projeto.
- Recarregue o shell, inicie o
claudee execute/status. Você deve verAuth token: ANTHROPIC_AUTH_TOKENeAnthropic base URL: https://openrouter.ai/api. Se ele indicarANTHROPIC_API_KEYou um login de conta Claude, as variáveis não chegaram à sessão. - Abra o
/modelpara confirmar que as classes resolvem para o ERNIE e, em seguida, verifique a coluna do modelo no seu painel de atividade da OpenRouter após seu primeiro prompt.
Cobrimos a configuração geral do Claude Code com mais profundidade em como usar o Claude Code com a OpenRouter.
Uma tarefa real de codificação que cabe em 50 requisições
Com 50 requisições por dia, você não pode deixar o agente vagando. Dê a ele uma tarefa delimitada, na qual você já sabe como é o "pronto". Aqui está uma que funciona bem em um repositório pequeno:
In src/routes/orders.ts, GET /orders/:id returns 500 when the order
doesn't exist. Make it return 404 with {"error":"order_not_found"}.
Read only the files you need, make the smallest change, then run
the orders tests with npm test and stop. Don't refactor anything else.
Por que esse formato funciona no nível gratuito:
- Ele nomeia o arquivo. O agente pula uma busca em todo o repositório, o que economiza várias requisições.
- Ele define a correção. O código de status e o corpo estão no prompt, então não há idas e voltas.
- Ele limita o escopo. "Parar depois de rodar os testes" encerra o loop em vez de deixar o agente refinar.
Uma tarefa como essa geralmente leva um punhado de chamadas de modelo: ler a rota, ler o manipulador de erros, editar, rodar os testes, relatar. Um prompt vago como "limpe o módulo de pedidos" pode queimar a cota do dia inteiro antes de qualquer coisa ser entregue.
A janela de contexto de 1M é a outra razão pela qual o ERNIE é adequado para agentes. Você pode colar um stack trace longo ou um arquivo OpenAPI inteiro em um único prompt, em vez de espalhá-lo por vários turnos. Uma requisição grande vale mais que cinco pequenas quando cada requisição conta.
Faça o ERNIE rodar seus testes de API com o Apidog CLI
Depois que o agente corrigiu um endpoint, você quer prova de que a API ainda se comporta corretamente, não apenas que um teste de unidade passou. O Apidog CLI permite que o mesmo agente execute os cenários de teste que sua equipe já mantém no Apidog, leia as falhas, corrija o código e os execute novamente. Você escreve um único prompt; o ERNIE executa os comandos.
Instale a CLI, faça login e adicione a skill do agente:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # pick OpenCode or Claude Code when prompted
Em seguida, dê ao seu agente um único prompt:
Run the "Orders API" test scenario in Apidog project <projectId> against
the local environment. If any step fails, find the endpoint in this repo
that causes it, fix it, and rerun the scenario until it passes.
Summarize what you changed.
O agente localiza o cenário, o executa com um relatório em JSON que pode analisar e, depois, executa novamente após a correção:
apidog test-scenario list --project <projectId>
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --out-dir ./apidog-reports
# agent edits the failing route, then:
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json --upload-report
A flag --upload-report envia o resumo da execução para o Apidog, para que sua equipe possa abri-lo no aplicativo. apidog test-report list --project <projectId> recupera execuções anteriores, caso o agente precise comparar.
Mas planeje o orçamento. Cada execução de teste, leitura de relatório e edição de código é uma etapa do agente, então um loop de corrigir e rodar novamente pode facilmente consumir 10 requisições de modelo. No nível de 50 por dia, rode esse loop uma ou duas vezes, não a tarde inteira. O guia do Apidog CLI no Claude Code e a referência do comando apidog run cobrem o restante das flags. O plano gratuito do Apidog cobre equipes de até 4 usuários.
Quando a rota gratuita falha
O endpoint gratuito é um modelo de preview atrás de um único provedor. Veja o que esperar e o que fazer a respeito.
| Sintoma | Causa provável | Solução |
|---|---|---|
429 após uma rajada de etapas |
20 requisições por minuto | Desacelere o agente ou espere um minuto |
429 pelo restante do dia |
50 requisições diárias esgotadas (tentativas com falha contam) | Espere a redefinição em UTC ou compre 10 créditos para 1.000 por dia |
402 em um modelo gratuito |
Saldo negativo na conta | Adicione créditos para trazer o saldo acima de zero |
| Agente falha na saída JSON | Erros de saída estruturada | Peça texto simples e analise você mesmo |
| Recursos do Claude Code se comportam mal | Modelo não-Anthropic atrás do Claude Code | Use o OpenCode para o ERNIE, ou volte o modelo ao original |
A linha de saída estruturada merece um número. Em 12 de novembro de 2026, a página do modelo da OpenRouter mostrava uma taxa de erro de 21,70% em saída estruturada e de 1,01% em chamadas de ferramentas para este endpoint. Chamadas de ferramentas, das quais os agentes de codificação dependem, parecem saudáveis. Schemas JSON estritos, não. Por isso, mantenha os fluxos de trabalho do agente em ferramentas e texto simples.
A velocidade também difere do número de destaque. A descrição da Baidu afirma mais de 200 tokens por segundo, enquanto a OpenRouter mediu um P50 de 79 tokens por segundo no endpoint gratuito naquele dia.
Por fim, "Preview" está no nome por um motivo. O modelo, seus limites e a variante :free podem mudar sem aviso. Se o slug parar de resolver, verifique a página da OpenRouter antes de depurar sua configuração. Para acesso pago ou direto, o guia da API do ERNIE 5.5 Flash cobre a Baidu Qianfan.
FAQ
O ERNIE 5.5 Flash é realmente gratuito no OpenCode? Sim. O endpoint baidu/ernie-5.5-flash-preview:free custa $0 por token de entrada e de saída na OpenRouter. Você está limitado a 20 requisições por minuto e 50 por dia, a menos que tenha comprado pelo menos 10 créditos na OpenRouter.
O Claude Code oferece suporte oficial ao ERNIE 5.5 Flash? Não oficialmente. A OpenRouter documenta como apontar o Claude Code para outros modelos, mas diz que a configuração só tem garantia com o provedor first-party da Anthropic. Funciona, mas espere imperfeições com ferramentas. O OpenCode é a escolha mais segura para o ERNIE.
Qual é o ID do modelo do ERNIE 5.5 Flash na OpenRouter? É baidu/ernie-5.5-flash-preview:free para a variante gratuita. No OpenCode, prefixe-o com openrouter/. No Claude Code, use-o como está nas variáveis ANTHROPIC_DEFAULT_*_MODEL.
Quantas tarefas de codificação posso concluir com 50 requisições por dia? Depende da tarefa. Uma correção bem delimitada pode levar de 5 a 10 etapas do agente, então algumas tarefas cabem. Refatorações sem escopo definido podem usar a cota inteira de uma vez. Nomeie arquivos e defina o "pronto" no seu prompt.
Posso usar todo o contexto de 1M de tokens gratuitamente? A OpenRouter lista uma janela de contexto de 1.024.000 tokens para a variante gratuita, a mesma da janela completa do modelo. Prompts grandes ainda contam como uma requisição cada, o que torna prompts de contexto longo eficientes em relação ao limite diário.
Existe uma opção gratuita sem a OpenRouter? Nosso guia do ERNIE 5.5 Flash gratuito compara todas as rotas de $0. A Baidu também publicou o ERNIE 5.5 Flash Base no Hugging Face, que você pode servir por conta própria, como abordado em executando o ERNIE 5.5 Flash localmente com vLLM.