OpenCode 2.0 funciona como un único servidor en segundo plano que comparten la terminal, la web y la app de escritorio, trae una API reconstruida que el propio agente puede llamar, y suma Code Mode, subagentes en segundo plano y un nuevo sistema de plugins. Para actualizar, pasa a la última 1.x y ejecuta opencode upgrade --major. Lo hicimos en una instalación real de macOS y probamos cada novedad con un modelo gratuito, por un costo total de 0,00 dólares.
yoDEV Tested · 14 de octubre de 2026
Actualizamos una instalación real de macOS desde la 1.17.11 hasta OpenCode 2 y repetimos las pruebas en un entorno Linux limpio con@opencode/cli2.0.29. Los resultados que reportamos como nuestros salen de esa prueba.
Anomaly anunció OpenCode 2.0 el 12 de octubre de 2026, pero el paquete es anterior al anuncio: @opencode/cli 2.0.0 apareció en npm el 11 de septiembre, y la versión vigente cuando hicimos las pruebas, el 14 de octubre, era la 2.0.29.
¿Qué es OpenCode?
OpenCode es un agente de programación con IA de código abierto que funciona en tu terminal, en el navegador y como app de escritorio, y se conecta con decenas de proveedores de modelos, entre ellos el suyo propio, OpenCode Zen, que ofrece modelos gratuitos. Si lo estás comparando con otros agentes de terminal, nuestra comparativa OpenCode vs Crush cubre la línea 1.x.
¿Cómo actualizar OpenCode a la versión 2.0?
La actualización tiene dos pasos, porque la opción --major solo existe en las versiones 1.x recientes; el comando upgrade de la versión 2 no la tiene.
Primero, haz una copia de seguridad de tu configuración:
cp -r ~/.config/opencode ~/.config/opencode.v1-backup
Después, pon la 1.x al día y salta a la 2:
opencode upgrade
opencode upgrade --major
opencode --version
En la versión 1.19.0, la ayuda de --major dice que actualiza a OpenCode 2 y elimina OpenCode 1. Es decir, reemplaza la v1: las dos versiones no conviven instaladas. Si instalaste con npm, ten en cuenta que el nombre del paquete cambia: la v1 era opencode-ai y la v2 es @opencode/cli.
Nuestra prueba: 1.17.11 → opencode upgrade → 1.19.0 → opencode upgrade --major → OpenCode 2. Repetimos el segundo paso con --method npm en un entorno Linux limpio, donde eliminó opencode-ai y dejó instalado solo @opencode/cli.
¿Cómo instalar OpenCode 2.0 desde cero?
Si nunca usaste OpenCode, puedes instalar la versión 2 directamente desde npm, con el mismo comando que usa la documentación oficial en su ejemplo de CI:
npm install --global @opencode/cli
Luego entra en la carpeta de un proyecto y ejecuta opencode para abrir la interfaz de terminal.
¿Qué se rompe al actualizar a OpenCode 2.0?
La guía de migración enumera exactamente tres cambios incompatibles, todos intencionales:
- Plugins. Las implementaciones de plugins de la v1 no funcionan en la v2. La clave de configuración también cambia de
pluginaplugins, pero renombrarla no alcanza: cada plugin tiene que portarse con la guía de migración específica para plugins. (No probamos un plugin de la v1; esto es lo que indica la documentación del proveedor). - La API del servidor. Todo lo que llame a la API del servidor de la v1 tiene que pasar a la API de la v2, a través del nuevo paquete
@opencode/client. - La configuración del cliente de terminal. Los archivos
tui.jsonpor capas se reemplazan por un único archivo global,~/.config/opencode/cli.json, que se migra automáticamente la primera vez que arranca la terminal de la v2.
Si dependes de algún plugin de OpenCode, revísalo antes de actualizar. Nuestra lista de 10 plugins y agentes de OpenCode que vale la pena instalar se escribió para la 1.x.
¿Sigue funcionando mi configuración de OpenCode 1.x?
Sí. La v2 lee la configuración desde las mismas ubicaciones que la v1 y normaliza el formato antiguo en memoria, sin reescribir tus archivos. En nuestra máquina de prueba, el opencode.jsonc existente sobrevivió intacto a la actualización y la v2 funcionó con él tal cual. En una prueba aparte, un agente de la v1 definido con prompt se leyó como system en la v2, y un servidor MCP en el formato de la v1 se conectó con normalidad.
Convertir la configuración al formato nativo de la v2 es opcional. La guía de migración recomienda dejar que OpenCode lo haga con este prompt:
Migrate my OpenCode configuration, including file-based definitions, from the V1 format to the native V2 format.
Preserve its behavior and all unrelated settings.
Antes de usar la v2 a diario, conviene conocer dos cambios de comportamiento:
- La v2 solo lee
AGENTS.md. Si tu configuración de la v1 dependía de un archivoCLAUDE.mdcomo respaldo, pasa esas instrucciones aAGENTS.md. - La v2 no ejecuta servidores de lenguaje. Acepta la configuración
lsp, pero no los arranca ni produce diagnósticos LSP; la documentación sugiere usar en su lugar los comandos de lint, typecheck o compilación de tu proyecto.
¿Qué es Code Mode en OpenCode?
Code Mode permite que el agente escriba un script corto en JavaScript que llama a varias herramientas de una vez, en lugar de llamarlas de a una, con un viaje de ida y vuelta por cada llamada. Funciona sobre un intérprete mínimo incluido en el paquete @opencode/codemode, que convierte servidores MCP y endpoints OpenAPI en funciones que el script puede invocar. En la 2.0, todos los servidores MCP vienen con Code Mode activado por defecto.
Nuestra prueba. Agregamos el servidor MCP de Context7 con un solo comando, sin nada más:
opencode mcp add context7 --url https://mcp.context7.com/mcp
Después le pedimos a OpenCode que comparara cómo manejan el estado React y Vue usando Context7. El primer bloque execute envió las dos consultas, la de React y la de Vue, juntas. La de React falló porque Context7 movió el identificador de React de /facebook/react a /react/react; el segundo bloque execute reintentó con el identificador correcto y lanzó dos consultas de React de una sola vez. En total: cuatro llamadas MCP en dos viajes de ida y vuelta, donde llamarlas una por una habría tomado cuatro.
Anomaly afirma además que Code Mode te permite agregar mil servidores MCP con un impacto mínimo en el contexto. Esa es la afirmación del proveedor; nosotros probamos con un solo servidor.
¿Puede OpenCode ejecutar tareas en segundo plano?
Sí, tanto subagentes como comandos de shell. El agente principal puede delegar trabajo en un subagente en segundo plano (de forma automática o cuando se lo pides, incluso con otro modelo) y seguir trabajando. Los comandos de shell largos también pueden correr de forma asíncrona, y cualquier comando o subagente en primer plano se puede mandar al segundo plano con ctrl+b.
Nuestra prueba. Pedimos un subagente en segundo plano para revisar README.md mientras se ejecutaba sleep 45, y el agente respondió un segundo prompt con ambos todavía en marcha. Luego lanzamos un sleep 60 en primer plano y presionamos ctrl+b: pasó al segundo plano al instante. Alrededor de un minuto después, la transcripción mostró ↳ Shell finished · sleep 60 y el agente lo confirmó sin que se lo pidiéramos.
¿Cómo crea OpenCode un git worktree por su cuenta?
OpenCode 2.0 conoce su propia API y la usa. El ejemplo del anuncio es mover la sesión actual a un nuevo git worktree cuando empiezas un trabajo nuevo, y eso es exactamente lo que vimos.
Nuestra prueba. Le pedimos: “Start rate limiting uploads in a new worktree.” El agente ejecutó opencode.worktree_create [name=rate-limit-uploads] dentro de un bloque execute, y después opencode.session_move hacia el nuevo directorio, ~/.local/share/opencode/worktree/<proyecto>/rate-limit-uploads. Dicho de otro modo, manejó su propia API a través de Code Mode. (El rate limiting en sí no avanzó: nuestro repositorio de prueba no tiene ningún endpoint de subida de archivos).
Puedes llamar a la misma API tú mismo con opencode api:
opencode api session.list --param limit=10
opencode api session.create --data '{"title": "New session"}'
¿Qué es el servicio en segundo plano de OpenCode?
En la 2.0, OpenCode arranca un único servidor compartido en segundo plano para tu cuenta de usuario, y todos los clientes locales (terminal, web y escritorio) se conectan a él. Ese servidor es dueño de las sesiones, la configuración, las integraciones, los permisos y la ejecución de herramientas; por eso una sesión que empiezas en la terminal también aparece en la interfaz web.
Lo gestionas con opencode service:
opencode service status
opencode service start
opencode service stop
Si prefieres el comportamiento anterior, con un proceso por terminal, opencode --standalone ejecuta un servidor privado, y opencode service set disabled true lo convierte en el comportamiento por defecto. opencode pair imprime enlaces de un solo uso y un código QR para conectar otro navegador o app al servidor.
¿Qué cambia en los plugins de OpenCode 2?
El sistema de plugins se reconstruyó, y Anomaly implementó casi todas las funciones de la 2.0 como plugins internos para mantener la API en buen estado. Al consultar nuestra instalación a través de la API obtuvimos 88 plugins integrados, entre ellos los de worktrees, los valores por defecto de Code Mode y los subagentes. (Al momento de nuestras pruebas, opencode plugin list --builtin no mostraba ningún plugin en la misma sesión; el listado de la API es el confiable).
Los plugins de la interfaz de terminal pasaron de experimentales a estables, y todo se puede recargar en caliente, así que OpenCode puede escribir un plugin para sí mismo en plena sesión y usarlo de inmediato. Los plugins se gestionan con opencode plugin add, opencode plugin list, opencode plugin check y opencode plugin update.
También hay un nuevo paquete, @opencode/sdk, para usar OpenCode como biblioteca: es el mismo código que impulsa la CLI. Al momento de publicar esta nota, Anomaly lo describía como todavía en desarrollo.
¿OpenCode es gratis?
OpenCode es de código abierto, y su proveedor integrado, OpenCode Zen, incluye modelos gratuitos que funcionan sin clave de API. Todas las pruebas del agente de este artículo se hicieron con Big Pickle (opencode/big-pickle), uno de esos modelos gratuitos, y opencode stats --cost --days 1 reportó 0,00 dólares para el día: unos 120.000 tokens de entrada y 13.000 de salida, con el 90 por ciento de la entrada servida desde caché. La lista de modelos gratuitos cambia; ejecuta opencode models para ver la actual.
¿Cómo lo probamos?
- Actualización y funciones del agente: la instalación de macOS de Greg, actualizada desde la 1.17.11, el 14 de octubre de 2026, con Big Pickle en el agente Build por defecto.
- API, plugins integrados y compatibilidad con la configuración de la v1: un entorno Linux limpio con
@opencode/cli2.0.29.
¿Y tú? ¿Cuál de las novedades de OpenCode 2.0 vas a usar primero en tu flujo de trabajo?
- Sí, ya estoy en la 2.0
- Todavía no: espero a que se actualicen mis plugins
- Uso otro agente de programación
- Prefiero otra opción (cuéntanos cuál)
Comenta abajo o, si este artículo te llegó por correo, responde directamente al email: tu respuesta se publica aquí.
Relacionado: Tu OpenCode Está Vacío: 10 Plugins y Agentes que Vale la Pena Instalar