Cómo usar ERNIE 5.5 Flash gratis en OpenCode y Claude Code

ERNIE 5.5 Flash Preview es gratis en OpenRouter. Aquí te explicamos cómo integrarlo en OpenCode y Claude Code, una tarea de programación que encaja con el límite diario de 50 solicitudes, y qué falla en la ruta gratuita.

INEZA Felin-Michel

INEZA Felin-Michel

12 November 2026

Cómo usar ERNIE 5.5 Flash gratis en OpenCode y Claude Code

Apidog para empresas

Despliegue local

SSO & RBAC

Conforme con SOC 2

Explorar Apidog Enterprise

Respuesta rápida: Puedes ejecutar ERNIE 5.5 Flash gratis en OpenCode y Claude Code a través del endpoint baidu/ernie-5.5-flash-preview:free de OpenRouter. En OpenCode, conecta OpenRouter y configura "model": "openrouter/baidu/ernie-5.5-flash-preview:free". En Claude Code, apunta ANTHROPIC_BASE_URL a OpenRouter y fija el slug de ERNIE como tu modelo. Cuesta $0 por token, pero sin créditos comprados tienes 50 solicitudes al día.

Ese límite diario es toda la historia para los agentes de programación. Un agente no hace una solicitud por tarea; hace una por paso. Esta guía configura ambos agentes, muestra una tarea de programación que cabe en el presupuesto gratuito y te dice dónde se rompe la ruta gratuita.

Todos los límites indicados a continuación fueron verificados en las páginas oficiales de OpenRouter el 12 de noviembre de 2026.

¿Qué es ERNIE 5.5 Flash Preview?

ERNIE 5.5 Flash Preview es el modelo de chat y agentes de Baidu lanzado el 10 de noviembre de 2026. Es un modelo sparse mixture-of-experts con 280 mil millones de parámetros totales, 14 mil millones activos por token y una ventana de contexto de 1.024.000 tokens. Baidu lo orienta hacia programación, trabajo agéntico e investigación profunda, y OpenRouter lo lista con razonamiento habilitado y llamadas a herramientas.

También existe un ERNIE 5.5 Flash Base en Hugging Face, pero es solo para preentrenamiento: ese es el que ajustas o sirves tú mismo. El Preview es con el que habla tu agente de programación. Para el desglose completo del modelo, lee qué es ERNIE 5.5 Flash. Si vienes de la generación anterior, la descripción general de ERNIE 5.1 cubre qué cambió.

Límites gratuitos de ERNIE 5.5 Flash en OpenRouter

La página del modelo de OpenRouter muestra la variante :free a $0 de entrada y $0 de salida, servida por un solo proveedor, Baidu Qianfan. Los límites de tarifa provienen de la documentación de límites de OpenRouter y se aplican a todos los ID de modelo que terminan en :free.

Elemento Valor (verificado el 12-11-2026)
ID del modelo baidu/ernie-5.5-flash-preview:free
Precio $0 de entrada, $0 de salida
Ventana de contexto 1.024.000 tokens
Solicitudes por minuto 20
Solicitudes por día, con menos de 10 créditos comprados en total 50
Solicitudes por día, con 10 o más créditos comprados en total 1.000
Proveedores detrás del modelo 1 (Baidu Qianfan)

Dos detalles importan para los agentes. La página de precios de OpenRouter indica que los intentos fallidos cuentan hacia el límite diario. Y un saldo de crédito negativo bloquea los modelos gratuitos con un 402 hasta que recargues.

Infografía de los límites de los modelos gratuitos de OpenRouter: 50 solicitudes por día y 20 por minuto con menos de 10 créditos comprados, 1.000 por día y 20 por minuto con 10 o más créditos, y cada llamada al modelo en un bucle de agente cuenta como una solicitud

El nivel de 1.000 al día depende de los créditos que hayas comprado, no de los que gastes.

Configurar ERNIE 5.5 Flash en OpenCode

OpenCode soporta OpenRouter de forma nativa, así que esta es la más corta de las dos configuraciones. Necesitas una cuenta de OpenRouter y una clave API desde tu panel de OpenRouter.

  1. Instala o actualiza OpenCode, luego inícialo en tu carpeta de proyecto:
cd your-project
opencode
  1. Conecta OpenRouter. Dentro de OpenCode, ejecuta /connect, elige OpenRouter y pega tu clave. También puedes exportarla antes de iniciar:
export OPENROUTER_API_KEY="sk-or-v1-..."
  1. Fija el modelo en opencode.json en la raíz del proyecto. La documentación de proveedores de OpenCode indica usar el ID completo del modelo de OpenRouter después del prefijo openrouter/:
{
  "$schema": "https://opencode.ai/config.json",
  "model": "openrouter/baidu/ernie-5.5-flash-preview:free"
}
  1. Confirma la selección con /models. Si ERNIE no aparece en la lista, el valor de la configuración prevalece de todos modos, así que revisa la ortografía del slug, incluido :free.

Cada prompt ahora va a ERNIE 5.5 Flash Preview a través de OpenRouter. Si seguiste nuestra guía de GLM-5.3-Flash para OpenCode o la de DeepSeek V4.1 Flash, el patrón es idéntico: solo cambia el slug.

Configurar ERNIE 5.5 Flash en Claude Code

Claude Code puede comunicarse con OpenRouter porque OpenRouter expone un endpoint de Messages compatible con Anthropic. La página del modelo ERNIE lista POST https://openrouter.ai/api/v1/messages como una ruta soportada para este modelo.

Sé claro primero sobre el nivel de soporte. La guía de integración de Claude Code de OpenRouter dice que Claude Code con OpenRouter "solo está garantizado que funcione con el proveedor de primera parte de Anthropic" y que Claude Code "puede no funcionar correctamente con otros proveedores". Ejecutar ERNIE aquí funciona mediante configuraciones documentadas, pero no es una combinación garantizada.

  1. Configura las variables de conexión en tu perfil de shell, exactamente como las documenta OpenRouter:
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
  1. Fija ERNIE para cada clase de modelo que Claude Code usa, para que ningún paso regrese silenciosamente a un modelo de Anthropic de pago:
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"

Puedes poner las mismas claves en el bloque env de .claude/settings.json si quieres limitar la configuración a un solo proyecto.

  1. Recarga el shell, inicia claude y ejecuta /status. Deberías ver Auth token: ANTHROPIC_AUTH_TOKEN y Anthropic base URL: https://openrouter.ai/api. Si muestra ANTHROPIC_API_KEY o un inicio de sesión de cuenta de Claude, las variables no llegaron a la sesión.
  2. Abre /model para confirmar que las clases resuelven a ERNIE, luego revisa la columna del modelo en tu panel de actividad de OpenRouter después de tu primer prompt.
Diagrama de las dos rutas de agente: OpenCode usa OPENROUTER_API_KEY y Claude Code usa ANTHROPIC_BASE_URL para llegar a OpenRouter, que reenvía baidu/ernie-5.5-flash-preview:free a Baidu Qianfan

Cubrimos la configuración general de Claude Code con más detalle en cómo usar Claude Code con OpenRouter.

Una tarea de programación real que cabe en 50 solicitudes

Con 50 solicitudes al día, no puedes dejar que un agente deambule. Dale una tarea acotada donde ya sabes cómo se ve "terminado". Aquí tienes una que funciona bien en un repositorio pequeño:

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 qué esta forma funciona en el nivel gratuito:

Una tarea como esta normalmente toma un puñado de llamadas al modelo: leer la ruta, leer el manejador de errores, editar, ejecutar pruebas, informar. Un prompt vago como "limpia el módulo de orders" puede quemar la cuota de un día entero antes de que algo se entregue.

La ventana de contexto de 1M es la otra razón por la que ERNIE es adecuado para agentes. Puedes pegar un stack trace largo o un archivo OpenAPI completo en un solo prompt en lugar de repartirlo en varios turnos. Una solicitud grande supera a cinco pequeñas cuando cada solicitud cuenta.

Deja que ERNIE ejecute tus pruebas de API con Apidog CLI

Una vez que el agente ha corregido un endpoint, quieres la prueba de que la API sigue comportándose, no solo que una prueba unitaria pasó. Apidog CLI permite que el mismo agente ejecute los escenarios de prueba que tu equipo ya mantiene en Apidog, lea los fallos, corrija el código y los ejecute de nuevo. Tú escribes un prompt; ERNIE ejecuta los comandos.

Instala el CLI, inicia sesión y añade la skill de 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

Luego dale a tu agente un solo 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.

El agente busca el escenario, lo ejecuta con un informe JSON que puede interpretar, y lo vuelve a ejecutar tras la corrección:

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

La opción --upload-report envía el resumen de la ejecución a Apidog para que tu equipo pueda abrirlo en la app. apidog test-report list --project <projectId> recupera ejecuciones anteriores si el agente necesita comparar.

Pero calcula el presupuesto. Cada ejecución de prueba, lectura de informe y edición de código es un paso del agente, así que un bucle de corregir y volver a ejecutar puede tomar fácilmente 10 solicitudes al modelo. En el nivel de 50 al día, ejecuta este bucle una o dos veces, no toda la tarde. La guía de Apidog CLI en Claude Code y la referencia del comando apidog run cubren el resto de las opciones. El plan gratuito de Apidog cubre equipos de hasta 4 usuarios.

Cuándo falla la ruta gratuita

El endpoint gratuito es un modelo preview detrás de un único proveedor. Esto es lo que puedes esperar y qué hacer al respecto.

Síntoma Causa probable Solución
429 tras una ráfaga de pasos 20 solicitudes por minuto Ralentiza el agente o espera un minuto
429 durante el resto del día 50 solicitudes diarias usadas (los intentos fallidos cuentan) Espera el reinicio en UTC o compra 10 créditos para 1.000 al día
402 en un modelo gratuito Saldo de cuenta negativo Añade créditos para llevar el saldo por encima de cero
El agente falla con salida JSON Errores de salida estructurada Pide texto plano y analízalo tú mismo
Las funciones de Claude Code fallan Modelo no Anthropic detrás de Claude Code Usa OpenCode para ERNIE, o vuelve a cambiar el modelo

La fila de salida estructurada merece un número. El 12 de noviembre de 2026, la página del modelo de OpenRouter mostraba una tasa de error de salida estructurada del 21,70% y una tasa de error de llamadas a herramientas del 1,01% para este endpoint. Las llamadas a herramientas, de las que dependen los agentes de programación, se ven saludables. Los esquemas JSON estrictos no, así que mantén los flujos de trabajo del agente en herramientas y texto plano.

La velocidad también difiere de la cifra destacada. La descripción de Baidu afirma más de 200 tokens por segundo, mientras que OpenRouter midió un P50 de 79 tokens por segundo en el endpoint gratuito ese día.

Finalmente, "Preview" está en el nombre por algo. El modelo, sus límites y la variante :free pueden cambiar sin previo aviso. Si el slug deja de resolver, revisa la página de OpenRouter antes de depurar tu configuración. Para acceso de pago o directo, la guía de la API de ERNIE 5.5 Flash cubre Baidu Qianfan.

Preguntas frecuentes

¿ERNIE 5.5 Flash es realmente gratis en OpenCode? Sí. El endpoint baidu/ernie-5.5-flash-preview:free cuesta $0 por token de entrada y salida en OpenRouter. Estás limitado a 20 solicitudes por minuto y 50 al día, a menos que hayas comprado al menos 10 créditos de OpenRouter.

¿Claude Code soporta oficialmente ERNIE 5.5 Flash? No oficialmente. OpenRouter documenta cómo apuntar Claude Code a otros modelos, pero dice que la configuración solo está garantizada con el proveedor de primera parte de Anthropic. Funciona, pero espera detalles ásperos con las herramientas. OpenCode es la opción más segura para ERNIE.

¿Cuál es el ID del modelo de ERNIE 5.5 Flash en OpenRouter? Es baidu/ernie-5.5-flash-preview:free para la variante gratuita. En OpenCode, antepón openrouter/. En Claude Code, úsalo tal cual en las variables ANTHROPIC_DEFAULT_*_MODEL.

¿Cuántas tareas de programación puedo completar con 50 solicitudes al día? Depende de la tarea. Una corrección bien acotada puede tomar de 5 a 10 pasos del agente, así que caben varias tareas. Refactorizaciones abiertas pueden consumir toda la cuota de una sola vez. Nombra archivos y define "terminado" en tu prompt.

¿Puedo usar el contexto completo de 1M de tokens gratis? OpenRouter lista una ventana de contexto de 1.024.000 tokens para la variante gratuita, la misma que la ventana completa del modelo. Los prompts grandes siguen contando como una solicitud cada uno, lo que hace que los prompts de contexto largo sean eficientes respecto al límite diario.

¿Hay una opción gratuita sin OpenRouter? Nuestra guía de ERNIE 5.5 Flash gratis compara todas las rutas a $0. Baidu también publicó ERNIE 5.5 Flash Base en Hugging Face, que puedes servir tú mismo, como se cubre en ejecutar ERNIE 5.5 Flash localmente con vLLM.

Practica el diseño de API en Apidog

Descubre una forma más fácil de construir y usar APIs