Iniciar sesiónElegir plan
Blog · Guías de configuración

Errores de modelos gratuitos en OpenCode: cierre de v1 y paso a v2

Los avisos de modelos gratuitos bloqueados se dispararon en #59387 tras el lanzamiento de OpenCode v2. Muchos asumen que agotaron su cupo diario y piensan en pagar Go, pero al menos cuatro causas distintas muestran ventanas casi iguales.

A finales de octubre, OpenCode lanzó la rama 2.x y empezó a cortar el acceso a modelos gratuitos en clientes antiguos. Los reportes en GitHub se multiplicaron tan rápido que los mantenedores fijaron anomalyco/opencode#59387 como hilo central y redirigieron allí los duplicados.

La secuencia habitual parece simple: una sesión se detiene a mitad de tarea con un aviso rojo indicando que se superó el uso gratuito. Quien intenta actualizar siguiendo una guía rápida o espera a la hora de reinicio indicada ve cómo la fecha salta un día más hacia adelante. Aunque todo suene a «cupo agotado», detrás hay cuatro problemas independientes.

Revisa el texto exacto antes de tocar ajustes o suscribirte a Go. Un cliente 1.x desactualizado, una sesión heredada de 1.x, un contador bloqueado en el servidor y una llamada fuera de OpenCode requieren soluciones distintas.

Qué mensajes aparecen

Las ventanas emergentes son casi idénticas, así que el texto y los botones dan la pista clave:

1. This version of OpenCode Desktop no longer supports free models.2. Free usage exceeded, subscribe to Go3. You've used today's free messages. They reset at Oct 22, 2026, 8:00 p.m.4. FreeUsageLimitError (HTTP 429)

Si ves el tercer mensaje acompañado de los botones Upgrade to OpenCode Go y Switch model, tu cliente ya pasó la comprobación de versión y el bloqueo está en la cuota. Los otros mensajes no tienen relación con haber gastado los mensajes del día.

Las cuatro causas posibles

1. Sigues en 1.x, donde los modelos gratuitos ya no funcionan

Ver no longer supports free models o Free usage exceeded, subscribe to Go casi siempre indica que sigues en 1.x. El 27 de octubre los mantenedores confirmaron que la versión v1 dejó de admitir modelos gratuitos.

Mucha gente se queda atascada en 1.x creyendo que está al día por dos motivos. Primero, como señala #59482, el actualizador integrado de Desktop v1 te mantiene dentro de la rama 1.x (The v1 Desktop's built-in updater keeps you on 1.x, so updating from inside the app won't get you there.). Segundo, OpenCode tiene dos paquetes en npm: el antiguo opencode-ai se quedó en 1.19.5 bajo latest, mientras que la v2 vive en @opencode/cli (2.2.2+ en latest). Ejecutar npm i -g opencode-ai te deja en 1.x indefinidamente.

Como Desktop y la CLI son binarios distintos, comprueba 2.x en la interfaz que realmente usas: opencode --version en terminal, Settings → About en la app de escritorio o la versión del archivo .exe en tu carpeta de instalación de Windows. Para instalar v2 manualmente, elige la vía de tu sistema:

Métodos de instalación de OpenCode v2 por plataforma
MétodoPlataformaComando o pasos
curlmacOS / Linuxcurl -fsSL https://opencode.ai/v2/install | bash
npmTodas las plataformasnpm install -g @opencode/cli
HomebrewmacOSbrew install anomalyco/tap/opencode-v2
Binario independienteWindowsDescargar el zip oficial x64, descomprimirlo y añadir la carpeta al PATH

La documentación oficial indica que los gestores de paquetes de Windows no están soportados, así que en Windows conviene usar npm o el zip x64. Si tras instalar v2 no ves modelos gratuitos en /models, ejecuta /connect para iniciar sesión en tu cuenta de OpenCode Console; sin sesión iniciada, el proveedor opencode ni siquiera aparece.

2. Ya estás en v2, pero pruebas dentro de una sesión de 1.x

Tras actualizar a v2, muchos reabren un hilo anterior para retomar la tarea y vuelven a recibir no longer supports free models, pensando que la actualización falló.

El issue #60352 documenta este caso: aunque tanto la CLI como el escritorio estén en 2.2.2 y la migración local de base de datos haya funcionado, el servidor sigue rechazando las sesiones creadas en 1.x como si vinieran de un cliente obsoleto. Abre una sesión nueva con la misma cuenta y el mismo modelo gratuito; normalmente funciona al instante. Verifica siempre el salto a v2 en una conversación nueva.

3. El cupo diario se agotó o el contador del servidor está bloqueado

Cuando aparezca You've used today's free messages. They reset at <hora> · <fecha>, fíjate en si la hora de reinicio permanece fija. Si apunta cada día a la misma hora, realmente alcanzaste el tope diario y solo toca esperar al reinicio.

Si la cuenta atrás llega a cero y salta automáticamente al día siguiente (por ejemplo, de Oct 22 a Oct 23), el contador del servidor se ha quedado atascado. Según #60328, las cuotas y ventanas de reinicio se gestionan en el backend de Console por cuenta y red, de modo que el cliente no puede modificarlas. Reinstalar la app o borrar carpetas de configuración y bases de datos rara vez ayuda y destruye tu historial local de sesiones. Dos soluciones temporales comentadas por usuarios son cerrar sesión de Console dentro de OpenCode y volver a entrar (a veces más de una vez), o cambiar de red, como usar un punto de acceso móvil.

4. Estás llamando a modelos gratuitos desde fuera de OpenCode

Si recibes FreeUsageLimitError o HTTP 429 desde otro editor o un script propio, ni la versión ni la red tienen nada que ver. La documentación de OpenCode establece: Free-tier chat models require OpenCode. Las claves del nivel gratuito solo funcionan dentro del cliente oficial de OpenCode; las peticiones externas reciben HTTP 429 sin importar la configuración. Vuelve a OpenCode o usa un modelo de pago.

Dos casos límite que parecen peores de lo que son

  • Errores 402 en registros en segundo plano: ver rechazos 402 para modelos económicos como GPT-6 Luna en los logs locales no significa que OpenCode te esté cobrando en silencio. La documentación de Console explica que OpenCode usa modelos de bajo coste (Haiku, Nano, Flash) en un canal aparte para generar títulos de sesión, independiente de tu cuota gratuita de chat.
  • Illegal instruction en CPUs antiguas: procesadores de más de una década que llegan solo hasta SSE4.1 (sin SSE4.2 ni POPCNT) fallan en v2 con Illegal instruction, mientras que v1 ya no soporta modelos gratuitos. Es un límite de instrucciones de hardware, no un fallo de configuración.

Si tras verificar 2.x, probar una sesión nueva, reautenticarte y cambiar de red sigues bloqueado, comenta en #59387 incluyendo tres datos: tu versión exacta, sistema operativo y el texto completo del error.

Cuándo compensa pagar OpenCode Go

La página de OpenCode Go indica: If you reach the usage limit, you can continue using the free models. Go compra cuota de pago en un grupo aparte; no desbloquea modelos gratuitos.

Suscribirse a Go no resuelve un cliente 1.x, una sesión antigua de 1.x ni un 429 desde otra herramienta. Solo tiene sentido cuando ya estás en una sesión nueva de v2, la hora de reinicio es fija y agotas de forma habitual el límite gratuito a mitad del día (Go cuesta $10/mes, Go Plus $40/mes y Go Teams $20/usuario/mes; OpenCode no publica una cifra exacta de mensajes diarios para el plan gratuito).

Notas sobre el grupo gratuito y regiones: el grupo gratuito actual (limited time) incluye Big Pickle, GLM-5.3-Flash Free, DeepSeek V4.1 Flash Free, Beam Free, Flint 40B Free, MiMo-V2.6-Flash Free, Nemotron 3 Ultra Free, Nemotron 3.5 Lightning Free, Nemotron 3.5 Super VL Free y Jev 1.13 Free. Beam Free no está disponible en China (incluidos Hong Kong y Macao). Para ocultar por completo los modelos gratuitos, define OPENCODE_DISABLE_FREE_MODELS=1.

Embarque

Cambia de proveedor, conserva tu herramienta.

Sigue usando OpenCode 2. Cuando los límites gratuitos o bloqueos regionales te frenen, apunta tu Base URL a CodingPass para usar Claude, GPT y modelos abiertos con pago por uso.

  • ID de solicitud en cada respuesta
  • Reembolso total si has usado el 5% o menos
  • Sin cargos sorpresa
Elegir GoGuía de OpenCode

$10/mes hasta que canceles.