1. Introducción a OpenCode

Objetivo del tema

Presentar OpenCode, comprender qué lo diferencia de otros asistentes de programación con IA, conocer sus distintas formas de uso y repasar los escenarios donde un agente local y abierto marca la diferencia en el trabajo diario.

1.1 ¿Qué es OpenCode?

OpenCode es un agente de programación con inteligencia artificial, de código abierto, diseñado para trabajar directamente en tu terminal. A diferencia de un chat web tradicional, OpenCode lee tu proyecto completo, ejecuta comandos, edita archivos y propone cambios bajo tu control. Su desarrollo es público y colaborativo en github.com/anomalyco/opencode, lo que garantiza transparencia y una evolución marcada por la comunidad.

  • Local primero: trabaja sobre tu árbol de archivos real, sin subir el proyecto a la nube.
  • Independiente del proveedor: se conecta con cualquier proveedor de modelos LLM (Anthropic, OpenAI, Google, modelos locales y más).
  • Cliente/servidor: su arquitectura permite usarlo desde la terminal, el escritorio, un IDE o incluso mediante scripts automatizados.
  • Extensible: soporta servidores MCP, plugins personalizados, agentes propios y comandos a medida.

1.2 Formas de uso

OpenCode se adapta a distintos estilos de trabajo:

  • TUI (Text User Interface - interfaz textual): la experiencia principal. Se inicia ejecutando opencode dentro de un proyecto y ofrece una interfaz interactiva con sesiones, temas y atajos de teclado.
  • Aplicación de escritorio: ideal para quien prefiere ventanas y una experiencia gráfica completa.
  • Extensión de IDE: integra el agente dentro de editores como Visual Studio Code o JetBrains.
  • Modo no interactivo (CLI): mediante opencode run es posible ejecutar tareas desde scripts o pipelines de CI/CD.

Estos son los primeros comandos que conviene conocer:

opencode --version
opencode                      # abre la TUI en el directorio actual
opencode run "Explica la estructura del proyecto"
opencode serve                # levanta la interfaz web local
opencode upgrade              # actualiza a la última versión

Dentro de la TUI, los comandos con barra (/help, /init, /models, /undo, /share) permiten controlar la sesión sin salir del flujo de conversación.

1.3 Proveedores de modelos y OpenCode Zen

Una de las mayores fortalezas de OpenCode es que no te ata a un proveedor único. Basta configurar las claves de API de los servicios que quieras usar, o autenticarse con el comando /connect. Para quienes comienzan, OpenCode Zen ofrece una lista curada de modelos probados y verificados por el equipo de OpenCode, lo que simplifica la elección inicial sin renunciar a cambiar de modelo cuando el proyecto lo requiera.

1.4 Diferencias entre las experiencias de uso

Cada forma de usar OpenCode tiene fortalezas según el contexto. Esta comparativa ayuda a elegir la adecuada para cada tarea:

Comparativa de experiencias de OpenCode
Aspecto TUI en terminal App de escritorio Extensión de IDE Modo CLI (run)
Contexto Acceso total al proyecto y sesiones persistentes. Similar a la TUI, con navegación gráfica. Trabaja sobre los archivos abiertos en el editor. Tarea puntual definida en el comando.
Interacción Conversacional, con atajos y comandos slash. Visual, con paneles y vista previa de cambios. Sugerencias integradas al flujo de edición. No interactiva: ideal para scripts y CI/CD.
Automatización Media: orientado a sesiones humanas. Baja: pensado para uso manual. Depende del editor y sus tareas. Alta: salida reproducible y encadenable.
Caso ideal Desarrollo diario, refactors y exploración. Quien prefiere interfaces gráficas. Edición incremental sin salir del editor. Pipelines, revisiones automáticas y lotes.

1.5 Casos de uso destacados

OpenCode acompaña todo el ciclo de desarrollo:

  • Explorar y entender código: pide explicaciones sobre cualquier parte del repositorio y usa @ para referenciar archivos concretos.
  • Agregar funcionalidades: planifica primero con el modo Plan (tecla Tab) y construye después con el modo Build.
  • Corregir errores: describe el bug, deja que ejecute tests y revise resultados antes de aplicar cambios.
  • Deshacer y reintentar: con /undo y /redo puedes volver atrás y ajustar el prompt cuantas veces necesites.
  • Compartir trabajo: el comando /share genera un enlace de la conversación para revisarlo con tu equipo.

Cuanto más específico sea tu pedido (archivos involucrados, objetivo, restricciones), más precisos serán los resultados. Habla con OpenCode como lo harías con un compañero junior de tu equipo: con contexto claro y ejemplos concretos.

En resumen: OpenCode combina lo mejor de un agente autónomo con el control total del desarrollador. Es open source, no depende de un solo proveedor de IA y funciona donde tú trabajas: en la terminal, en el escritorio o dentro de tu editor. En los próximos temas veremos cómo instalarlo y sacarle todo el partido.

Retornar