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 comenzo como una herramienta interna para acelerar su propio desarrollo evoluciono rapidamente en un proyecto open source independiente.
Actualmente el proyecto vive bajo la organizacion opencode-ai en GitHub y cuenta con:
- 114K+ estrellas en GitHub
- 454+ contribuidores activos
- Licencia MIT — completamente libre
- Version actual: v1.2.15
- Repositorio: github.com/opencode-ai/opencode
Que Hace OpenCode
OpenCode es un agente AI que trabaja directamente con tu codigo. No es un chatbot: es una herramienta que lee, escribe y modifica archivos, ejecuta comandos, navega tu proyecto y toma decisiones autonomas para completar tareas.
La diferencia clave con otros asistentes es que OpenCode es open source y gratuito. Tu solo pagas por el uso del modelo LLM que elijas — ya sea Claude, GPT, Gemini, o un modelo local con Ollama.
Interfaces Disponibles
OpenCode ofrece multiples formas de interaccion:
| Interfaz | Descripcion | Caso de Uso |
|---|---|---|
| TUI | Terminal User Interface con paneles | Desarrollo diario, flujo principal |
| Desktop | Aplicacion nativa (Electron) | Usuarios que prefieren GUI |
| Web | Interfaz en el navegador | Acceso remoto, compartir sesiones |
| IDE | Extensiones para editores | Integracion directa en tu editor |
| CLI | Modo no interactivo | Scripts, CI/CD, automatizacion |
La TUI es la interfaz principal y la mas madura. Las demas interfaces se conectan al mismo motor de agentes.
Arquitectura
OpenCode se organiza en tres capas principales:
Agentes
Los agentes son los “cerebros” que deciden que hacer. OpenCode incluye dos agentes built-in:
- Build: el agente por defecto. Lee archivos, escribe codigo, ejecuta comandos. Es el que usas para desarrollo activo.
- Plan: agente de solo lectura. Analiza tu proyecto y genera planes sin modificar nada.
Puedes alternar entre ellos con Tab en la TUI.
Herramientas (Tools)
Los agentes usan herramientas para interactuar con el sistema:
- Lectura y escritura de archivos
- Ejecucion de comandos en terminal
- Busqueda en el codebase (grep, glob)
- Navegacion web (fetch)
- Integracion con LSP y formatters
Proveedores LLM
OpenCode soporta 75+ proveedores de modelos de lenguaje:
- Cloud: Anthropic, OpenAI, Google, AWS Bedrock, Azure
- Locales: Ollama, LM Studio, llama.cpp
- Routers: OpenRouter, LiteLLM
- Custom: cualquier API compatible con OpenAI
Comparativa con Otros Agentes
| Caracteristica | OpenCode | Claude Code | Gemini CLI | Aider | Goose |
|---|---|---|---|---|---|
| Open Source | Si (MIT) | No | No | Si | Si |
| Costo base | Gratis | Suscripcion | Gratis | Gratis | Gratis |
| Multi-proveedor | 75+ | Solo Claude | Solo Gemini | Varios | Varios |
| TUI | Si | Si | Si | No | No |
| Desktop/Web | Si | No | No | No | No |
| MCP | Si | Si | Si | No | Si |
| Modelos locales | Si | No | No | Si | Si |
| IDE extensions | Si | Si (VS Code) | No | No | No |
Casos de Uso
Desarrollo Individual
- Generar codigo desde descripciones en lenguaje natural
- Refactorizar bases de codigo existentes
- Debugging asistido por AI
- Escribir y ejecutar tests
Equipos
/initgenera un archivo AGENTS.md con convenciones del proyecto- Todos los miembros comparten el mismo contexto
- Code review asistido
CI/CD
opencode run "prompt"ejecuta tareas sin interaccion- Integracion nativa con GitHub Actions
- Automatizacion de code review, fixes, y releases
Code Review
- Analisis automatico de PRs
- Sugerencias de mejora con contexto del proyecto
- Deteccion de patrones problematicos
Por Que Elegir OpenCode
- Sin vendor lock-in: cambia de proveedor LLM cuando quieras
- Transparencia total: puedes auditar y modificar el codigo fuente
- Costo controlado: pagas solo lo que usas, sin suscripciones
- Comunidad activa: 454+ contribuidores, actualizaciones frecuentes
- Extensible: MCP, custom tools, plugins, skills
Siguiente: Capitulo 2: Instalacion —>