OpenCode: cómo funciona el agente de código abierto para desarrolladores

Qué es OpenCode

OpenCode es un agente de programación con licencia MIT que no es un modelo por sí mismo: conecta el modelo que elijan ustedes con el código, la terminal y las herramientas del proyecto. Su propuesta central es la separación entre el “motor” de lenguaje (el modelo) y la capa que gestiona archivos, comandos, historial de sesión y permisos. Gracias a eso, pueden cambiar de proveedor o modelo sin rehacer la integración.

El proyecto ha atraído mucha atención: a mediados de 2026 rondaba los 190,000 estrellas en GitHub, y el sitio del proyecto reporta más de 195,000 estrellas y cerca de 950 contribuidores. Eso indica tracción y posibilidades de mantenimiento comunitario, aunque las estrellas miden interés más que calidad técnica.

Arquitectura y por qué importa

OpenCode funciona como un servidor local al que se conectan distintos clientes: interfaz de terminal, app de escritorio, extensión para IDE y un SDK. Todos son frentes para un mismo proceso servidor que expone una API HTTP (OpenAPI 3.1) y genera oficialmente el paquete @opencode-ai/sdk.

Ventajas prácticas:

• Uso headless: opencode serve inicia el servidor sin UI, útil en CI o en servidores remotos.
• Reanudar sesiones: opencode attach <url> permite retomar trabajo iniciado en otra máquina.
• Cliente web: opencode web ofrece una interfaz gráfica para revisar sesiones cuando no hay terminal disponible.
• API oficial: pueden automatizar sesiones y mensajes desde scripts en vez de intentar “puentear” una interfaz de terminal.

Eso diferencia a OpenCode de agentes que ligan la lógica directamente a una UI: aquí la automatización y la operación remota son funciones nativas.

Cómo se paga lo “gratis”

El software es gratuito y de código abierto, pero operar el agente tiene costos según la opción de modelo que elijan:

• Traer su propia clave API: pagan por token al proveedor que elijan. Es la opción más flexible, pero exige gestionar claves y presupuesto.
• OpenCode Zen (pasarela): cobran por uso y ofrecen una lista curada de modelos; ahorran la gestión directa de proveedores.
• OpenCode Go (suscripción): modelo de suscripción reportado en $5 el primer mes y $10 mensuales luego; limita a modelos de peso abierto seleccionados.
• Iniciar sesión con Copilot o ChatGPT: si ya tienen suscripción con esos servicios, evitan gestionar otra clave (nota: no aplica para planes consumidores de Claude).
• Local via Ollama: sin costo por token, pero con coste en hardware, memoria y calidad del modelo local.

La ruta local es atractiva en teoría, pero tiene limitaciones reales: los modelos pequeños locales tienden a producir llamadas a herramientas inválidas con más frecuencia y pierden contexto entre archivos. Además necesitan suficiente memoria y espacio de contexto para enviar archivos relevantes con cada petición. En resumen: no es un almuerzo gratis.

Si el objetivo principal es controlar costos de modelo, conviene aplicar las mismas buenas prácticas de ahorro de tokens usadas con Claude Code y otros agentes.

Modos, permisos y salvaguardias

OpenCode ofrece dos modos que funcionan como un interruptor de permisos:

• Build (por defecto): permite leer, escribir y ejecutar comandos sin pedir autorización.
• Plan: el agente pregunta antes de editar archivos o ejecutar comandos en la shell; se alterna con Tab.

Sobre eso se superpone un sistema de permisos por herramienta. Para cada proyecto pueden permitir, denegar o pedir confirmación al invocar una herramienta, incluso con reglas por patrón de comando (por ejemplo: permitir npm test pero pedir para otras acciones en la shell).

Importante: el sistema de permisos está pensado como un control de flujo de trabajo para evitar sorpresas, no como un sandbox de seguridad que contenga un actor hostil. Para uso en red es recomendable:

• Establecer OPENCODE_SERVER_PASSWORD.
• Bindear el servidor a localhost cuando sea posible.

Hubo un incidente de exposición no autenticada que ya fue parcheado; aun así, no deberían exponer el servidor públicamente sin autenticación.

Control de cambios y deshacer

OpenCode soporta /undo y /redo mediante snapshots de archivos basados en Git. Combinado con el modo Plan, esto emula el flujo de “probar un cambio arriesgado y revertirlo” que muchos equipos usan con Claude Code. Es una protección práctica para experimentar sobre refactorizaciones o correcciones automáticas.

Límites honestos del sistema

Además de los costes de modelo, hay límites técnicos que conviene considerar antes de adoptarlo en producción:

• Modelos locales pequeños suelen fallar al invocar herramientas correctamente y pueden perder relaciones entre archivos.
• El rendimiento depende del espacio de contexto disponible: proyectos grandes requieren mayor capacidad del modelo para procesar archivos relevantes.
• La capa de permisos no sustituye controles de seguridad más robustos: si ejecutan el servidor en un entorno compartido, aseguren autenticación y red.

Estas limitaciones determinan en qué escenarios OpenCode es adecuado: funciona muy bien para asistentes de codificación interactiva, automatización de tareas en entornos controlados y experimentación, pero requiere cuidado para despliegues públicos o cuando la integridad de ejecución es crítica.

Contexto de proyectos y documentación

OpenCode usa un enfoque de contexto por proyecto basado en AGENTS.md en lugar de un archivo específico de proveedor como CLAUDE.md. Eso sugiere un diseño pensado para múltiples modelos y flujos de trabajo en vez de acoplamientos con una plataforma única.

La API y el SDK permiten integrar OpenCode en pipelines y scripts, lo que facilita casos de uso como revisión automatizada, generación de parches o integración en CI/CD.

Para quién es OpenCode

• Equipos de desarrollo que quieren un agente configurable y no atado a un proveedor concreto.
• Equipos de seguridad y DevOps que necesiten correr agentes en infraestructuras controladas (con las debidas precauciones de red y autenticación).
• Proyectos que valoran la flexibilidad para cambiar de modelos según costo y calidad.

No es la mejor opción si su prioridad es el menor esfuerzo posible para obtener resultados perfectos con modelos locales pequeños o si necesitan un sandbox de seguridad infalible sin trabajo adicional.

Conclusión: qué llevarse a la práctica

OpenCode destaca por su arquitectura cliente-servidor y por delegar la parte de modelado a proveedores seleccionables. Eso lo hace una opción potente y flexible para integrar asistentes de codificación en flujos y herramientas existentes. Sin embargo, “gratuito” solo cubre el software: el costo real aparece en la elección del modelo y la infraestructura.

Si están evaluando OpenCode, prueben primero con la ruta de traer su propia clave o la pasarela del proyecto, activen el modo Plan mientras ajustan reglas de permiso y validen la experiencia de deshacer con Git. Para entornos en América Latina donde el control de costos y la soberanía de datos son importantes, la opción local puede tener sentido, pero exijan pruebas sólidas de calidad y recursos antes de ponerla en producción.