Capitulo 1: Que es OpenCode
Capitulo 1: Que es OpenCode
< Volver al Indice del Tutorial
Historia y Origen
OpenCode fue creado por el equipo de SST (Serverless Stack), conocidos por el framework de serverless del mismo nombre. Lo que comenzó como una herramienta interna para acelerar su propio desarrollo evolucionó rápidamente en un proyecto open source independiente que hoy es uno de los repositorios más populares de GitHub.
El proyecto originalmente vivía bajo la organización opencode-ai en GitHub, pero fue migrado a la organización anomalyco donde se mantiene activamente. Si encuentras referencias al repositorio antiguo, ten en cuenta que fue archivado y todo el desarrollo continúa en el nuevo.
Actualmente el proyecto cuenta con:
- 137,670+ estrellas en GitHub — uno de los proyectos AI más populares del ecosistema
- 500+ contribuidores activos de todo el mundo
- Licencia MIT — completamente libre para uso personal y comercial
- Versión actual: v1.3.15
- Repositorio: github.com/anomalyco/opencode
El crecimiento ha sido explosivo. En pocos meses pasó de ser una herramienta de nicho a convertirse en la alternativa open source de referencia frente a soluciones propietarias como Claude Code o Cursor. La comunidad contribuye activamente con mejoras, correcciones y nuevas integraciones.
Que Hace OpenCode
OpenCode es un agente AI que trabaja directamente con tu código. No es un chatbot ni un autocompletado glorificado: es una herramienta que lee, escribe y modifica archivos, ejecuta comandos en terminal, navega tu proyecto completo y toma decisiones autónomas para completar tareas de desarrollo de software.
La diferencia fundamental con otros asistentes es que OpenCode es open source y gratuito. Tú solo pagas por el uso del modelo LLM que elijas — ya sea Claude, GPT, Gemini, o un modelo local con Ollama. No hay suscripciones mensuales, no hay vendor lock-in, y puedes auditar cada línea del código fuente.
Que Puede Hacer Concretamente
OpenCode no se limita a generar snippets de código. Sus capacidades incluyen:
- Leer y entender proyectos completos, navegando entre archivos y directorios
- Escribir código nuevo siguiendo las convenciones de tu proyecto
- Refactorizar bases de código existentes con contexto completo
- Ejecutar comandos en terminal (build, test, lint, deploy)
- Debuggear problemas analizando errores, logs y stack traces
- Buscar en el codebase usando grep y glob de forma inteligente
- Navegar la web para consultar documentación o APIs
- Interactuar con herramientas externas a través del protocolo MCP
La clave es que todas estas acciones se coordinan de forma autónoma. Tú describes lo que necesitas en lenguaje natural, y el agente decide qué herramientas usar, en qué orden, y cómo combinarlas para completar la tarea.
Novedades en v1.3.15
La versión 1.3.15 trae mejoras significativas respecto a versiones anteriores. Estas son las más relevantes:
Multi-Sesión
Ahora puedes mantener múltiples sesiones de trabajo simultáneas dentro de la misma instancia. Esto significa que puedes tener una sesión enfocada en implementar una feature, otra sesión para debuggear un problema, y una tercera para hacer code review — todo sin perder el contexto de cada una.
Las sesiones se gestionan desde la TUI con comandos dedicados y cada una mantiene su propio historial de conversación, archivos modificados y estado del agente.
Go Provider
Se agregó soporte nativo para el Go provider, permitiendo integrar modelos de lenguaje que usan el protocolo Go de forma directa sin necesidad de adaptadores intermedios.
Compartir Sesiones
El comando /share genera enlaces para compartir sesiones completas con otros miembros del equipo. La configuración "share": "manual" o "share": "auto" controla si esto requiere acción explícita del usuario o se genera automáticamente.
Integración GitHub Copilot
OpenCode ahora puede usar las credenciales de GitHub Copilot como proveedor LLM. Si ya tienes una suscripción de Copilot, puedes usar esos mismos modelos sin configurar API keys adicionales.
Soporte ChatGPT Plus/Pro
Los usuarios de ChatGPT Plus y Pro pueden conectar sus cuentas para usar los modelos de OpenAI a través de su suscripción existente, sin necesidad de una API key separada.
Interfaces Disponibles
OpenCode ofrece múltiples formas de interacción, todas conectadas al mismo motor de agentes:
| Interfaz | Descripción | Caso de Uso |
|---|---|---|
| TUI | Terminal User Interface con paneles interactivos | Desarrollo diario, flujo principal |
| Desktop | Aplicación nativa (Electron) | Usuarios que prefieren GUI visual |
| Web | Interfaz en el navegador | Acceso remoto, compartir sesiones |
| IDE | Extensiones para editores (VS Code, Zed, Neovim) | Integración directa en tu editor |
| CLI | Modo no interactivo (opencode run) | Scripts, CI/CD, automatización |
TUI: La Interfaz Principal
La TUI es la interfaz más madura y la que la mayoría de desarrolladores usa en su día a día. Funciona directamente en la terminal y ofrece:
- Panel de input con soporte multilinea
- Panel de output con rendering de Markdown y código con syntax highlighting
- Status bar con información de tokens, modelo activo y estado del agente
- Navegación por teclado completa
- Soporte para terminales modernas como WezTerm, Alacritty, Ghostty y Kitty
Desktop y Web
Las interfaces Desktop y Web proporcionan una experiencia visual más rica, con paneles laterales para explorar archivos, un visor de diffs integrado y la posibilidad de compartir sesiones en tiempo real. La interfaz web es especialmente útil para acceso remoto a servidores de desarrollo.
Modo CLI
El modo CLI permite ejecutar tareas sin interacción humana, lo que lo hace ideal para pipelines de CI/CD y automatización:
opencode run "agrega tests unitarios para el módulo de autenticación"Arquitectura
OpenCode se organiza en tres capas principales que trabajan juntas de forma coordinada:
graph TD
A[Usuario] --> B[Interfaces]
B --> C[Motor de Agentes]
C --> D[Herramientas]
C --> E[Proveedores LLM]
B --> B1[TUI]
B --> B2[Desktop]
B --> B3[Web]
B --> B4[IDE]
B --> B5[CLI]
D --> D1[Lectura/Escritura]
D --> D2[Bash]
D --> D3[Búsqueda]
D --> D4[Web/Fetch]
D --> D5[MCP]
E --> E1[Anthropic]
E --> E2[OpenAI]
E --> E3[Google]
E --> E4[Ollama]
E --> E5[75+ más]Agentes
Los agentes son los “cerebros” que deciden qué hacer. OpenCode incluye dos agentes built-in:
- Build: el agente por defecto. Lee archivos, escribe código, ejecuta comandos. Es el que usas para desarrollo activo. Tiene acceso completo a todas las herramientas disponibles.
- Plan: agente de solo lectura. Analiza tu proyecto y genera planes detallados sin modificar nada. Ideal para entender un problema antes de implementar la solución.
Puedes alternar entre ellos con Tab en la TUI. Además, puedes crear agentes custom con configuraciones específicas para diferentes tareas (lo veremos en el Capítulo 6).
Herramientas (Tools)
Los agentes usan herramientas para interactuar con el sistema. Cada herramienta tiene un propósito específico:
- read/write: lectura y escritura de archivos con tracking de cambios
- bash: ejecución de comandos en terminal con captura de stdout/stderr
- glob/grep: búsqueda eficiente en el codebase por nombre y contenido
- fetch: navegación web para consultar documentación y APIs
- LSP: integración con Language Server Protocol para información de tipos
- MCP: protocolo de comunicación con herramientas externas
Proveedores LLM
OpenCode soporta 75+ proveedores de modelos de lenguaje, lo que te da libertad total para elegir el modelo que mejor se adapte a tus necesidades y presupuesto:
- Cloud: Anthropic, OpenAI, Google, AWS Bedrock, Azure, GitHub Copilot, ChatGPT Plus/Pro
- Locales: Ollama, LM Studio, llama.cpp, vLLM
- Routers: OpenRouter, LiteLLM, Together AI
- Custom: cualquier API compatible con el estándar OpenAI
Comparativa con Otros Agentes
El mercado de agentes AI para desarrollo ha crecido significativamente. Esta es una comparativa actualizada:
| Característica | OpenCode | Claude Code | Gemini CLI | Aider | Goose |
|---|---|---|---|---|---|
| Open Source | Sí (MIT) | No | No | Sí | Sí |
| Costo base | Gratis | Suscripción | Gratis | Gratis | Gratis |
| Multi-proveedor | 75+ | Solo Claude | Solo Gemini | Varios | Varios |
| TUI | Sí | Sí | Sí | No | No |
| Desktop/Web | Sí | No | No | No | No |
| Multi-sesión | Sí | No | No | No | No |
| MCP | Sí | Sí | Sí | No | Sí |
| Modelos locales | Sí | No | No | Sí | Sí |
| IDE extensions | Sí | Sí (VS Code) | No | No | No |
| Compartir sesiones | Sí | No | No | No | No |
| GitHub Copilot | Sí | No | No | No | No |
La ventaja principal de OpenCode es la flexibilidad: no estás atado a ningún proveedor, puedes usar modelos locales para trabajo offline o sensible, y la comunidad open source garantiza que el desarrollo continúe independientemente de decisiones empresariales.
Casos de Uso
Desarrollo Individual
- Generar código desde descripciones en lenguaje natural
- Refactorizar bases de código existentes con contexto completo del proyecto
- Debugging asistido por AI: describir el síntoma y dejar que el agente investigue
- Escribir y ejecutar tests unitarios, de integración y end-to-end
- Documentar código existente con comentarios y README actualizados
Equipos de Desarrollo
/initgenera un archivo AGENTS.md con convenciones del proyecto que se comparte via git- Todos los miembros comparten el mismo contexto y reglas del proyecto
- Code review asistido con
/sharepara compartir sesiones de análisis - Multi-sesión permite trabajar en paralelo en diferentes aspectos del mismo proyecto
- Onboarding acelerado: nuevos miembros pueden usar el agente Plan para entender la arquitectura
CI/CD y Automatización
opencode run "prompt"ejecuta tareas sin interacción humana- Integración nativa con GitHub Actions para automatizar code review
- Fix automático de issues y PRs con contexto del proyecto
- Generación de changelogs y release notes a partir del historial de commits
- Validación automática de PRs contra convenciones definidas en AGENTS.md
Code Review Avanzado
- Análisis automático de PRs con comprensión del contexto del proyecto
- Sugerencias de mejora con explicaciones detalladas
- Detección de patrones problemáticos, code smells y vulnerabilidades de seguridad
- Verificación de cumplimiento de convenciones del equipo
Por Que Elegir OpenCode
- Sin vendor lock-in: cambia de proveedor LLM cuando quieras sin modificar tu flujo de trabajo
- Transparencia total: puedes auditar y modificar cada línea del código fuente
- Costo controlado: pagas solo lo que usas, sin suscripciones mensuales obligatorias
- Comunidad masiva: 137,670+ estrellas y 500+ contribuidores garantizan desarrollo activo
- Extensible: MCP servers, custom tools, plugins, skills y agentes custom
- Multi-interfaz: TUI, Desktop, Web, IDE y CLI — elige la que mejor se adapte a tu flujo
- Multi-sesión: trabaja en múltiples tareas simultáneamente sin perder contexto
- Privacidad: con modelos locales via Ollama, tu código nunca sale de tu máquina
Siguiente: Capitulo 2: Instalacion —>