Cómo usar OpenCode: inicio rápido, 7 tips prácticos y cuándo sumar Oh My OpenCode

Name

Soren Atelier

Actualizado el 17/3/2026

OpenCode es un agente de AI coding open source pensado para terminal, con app de escritorio, extensión para IDE y una capa de modelos agnóstica al proveedor. La pregunta útil no es solo "¿puede escribir código?", sino: "¿cuándo me basta OpenCode solo y cuándo conviene sumar una capa de orquestación más fuerte como Oh My OpenCode?"

La versión corta: empieza con OpenCode solo. Aprende el flujo plan / build, genera un AGENTS.md real y acostúmbrate a los permisos y comandos personalizados. Añade Oh My OpenCode solo cuando necesites routing multi-modelo más agresivo, especialistas en background y un harness más directivo para cerrar tareas.

Si quieres ubicarlo primero en el mapa de AI coding, empieza por el hub de AI Coding, How to Use Codex y Parallel Code Agents Explained. Si estás comparando frameworks a nivel más amplio, OpenClaw vs ZeroClaw vs Pi Agent vs Nanobot es la página de comparación correcta.

Respuesta rápida: OpenCode solo o OpenCode + Oh My OpenCode

OpenCode ya cubre el ciclo central que la mayoría necesita: entender el repo, planear el cambio, editar con cuidado y trabajar desde terminal. La combinación con Oh My OpenCode es útil, pero no es el primer paso.

Qué es realmente OpenCode

OpenCode es un agente de coding open source construido alrededor de un flujo terminal-first. La documentación oficial y el README actual lo describen como:

• un coding agent centrado en TUI
• una app de escritorio en beta
• una extensión de IDE
• un sistema agnóstico al proveedor que puede trabajar con OpenAI, Anthropic, Google y otros backends
• una herramienta con agents integrados, permisos, comandos personalizados, reglas, formateo y soporte LSP

El cambio de mentalidad importante es este: OpenCode no es solo una ventana de chat que genera código. Es una superficie de trabajo para agentes. Sirve para:

• inspeccionar repos desconocidos
• planear cambios sin editar todavía
• modificar archivos y ejecutar comandos de shell
• crear reglas de proyecto con AGENTS.md
• definir slash commands repetibles
• endurecer o relajar permisos según el riesgo del repo

Un detalle práctico importa porque muchos tutoriales ya quedaron viejos. A fecha de 17 de marzo de 2026, las releases actuales de OpenCode se publican desde anomalyco/opencode, y la última release de GitHub es v1.2.27, publicada el 16 de marzo de 2026. Si te encuentras con repos archivados o redirigidos, estás viendo contexto histórico, no el destino de instalación actual.

Cómo empezar con OpenCode

1. Instala OpenCode

El inicio rápido oficial es:

curl -fsSL https://opencode.ai/install | bash

También puedes instalarlo con Homebrew, npm, Scoop, Chocolatey, mise o nix, pero el script de instalación sigue siendo el camino más rápido para arrancar.

2. Conecta un provider y abre un proyecto real

Después de abrirlo, la documentación oficial recomienda:

/connect

Luego selecciona opencode en la TUI y completa la auth en opencode.ai/auth, o usa otro provider que ya tengas configurado.

La regla pragmática es simple: no empieces con el repo más grande y la pregunta más vaga. Abre un proyecto que conozcas lo suficiente como para revisar el resultado.

3. Ejecuta /init antes de pedir trabajo serio

OpenCode puede generar un archivo AGENTS.md para el repo:

/init

Eso le da al agente instrucciones permanentes del proyecto. Haz commit del archivo. Es uno de los pasos más rentables del flujo, porque reduce repeticiones en los prompts y estabiliza el comportamiento entre sesiones.

4. Empieza en plan, no en build

OpenCode trae dos agents integrados que puedes cambiar con Tab:

• build para trabajo de desarrollo completo
• plan para análisis y exploración de código

Para tu primer caso, mantente en plan y con alcance pequeño:

Resume el flujo de build, test y release de este repositorio.
Señala los puntos de entrada principales.
No cambies nada por ahora.

Luego pasa a build solo cuando el mapa del repo ya te parezca correcto.

7 tips prácticos para OpenCode

Tip 1: usa plan por defecto en codebases desconocidas

Separar planificación y edición no solo es una medida de seguridad. También mejora la calidad.

Si entras directo en build, el modelo puede empezar a cambiar archivos antes de validar la comprensión. Con plan obtienes una ronda barata para revisar arquitectura, nombres, flujo de tests y radio de impacto.

Usa prompts como:

Explica cómo funciona la auth en @src/auth/index.ts
Luego propone dos opciones de fix mínimas.
Todavía no edites.

La referencia @ a archivos es útil porque OpenCode soporta búsqueda flexible de archivos dentro del prompt.

Tip 2: trata /init y AGENTS.md como multiplicadores, no como papeleo

Muchos infravaloran este paso porque parece documentación.

En realidad, AGENTS.md es el lugar para dejar:

• comandos de build, test y lint
• estructura del repo y fronteras entre paquetes
• reglas de estilo y expectativas de review
• restricciones tipo "no tocar esto"
• definición de done

Si saltas este paso y repites reglas del repo en chat, los resultados se vuelven más ruidosos y más caros.

Si quieres profundizar, Build a Claude-Code-Like AI Agent with Claude Agent SDK es un buen complemento, porque explica la misma idea desde el lado de construir agentes.

Tip 3: ajusta permisos antes de confiar en los defaults

OpenCode es configurable, y la documentación de permisos lo deja claro: las acciones pueden configurarse como allow, ask o deny.

Para un repo nuevo, una política de arranque razonable sería:

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

Eso ralentiza un poco al agente, pero evita sorpresas mientras aprendes cómo se comporta. Cuando ya tengas confianza, puedes relajar de forma selectiva algunos comandos de bajo riesgo.

Tip 4: crea unos cuantos slash commands antes de instalar más tooling

OpenCode ya soporta comandos integrados como /init, /undo, /redo, /share y /help. También permite agregar comandos personalizados con config o archivos markdown dentro de .opencode/commands/.

Eso significa que muchos wins de "workflow avanzado" todavía no necesitan un framework nuevo. Puedes definir comandos como:

• /test
• /review
• /ship-check
• /seo-page

Por ejemplo:

---
description: Ejecuta los tests relacionados con el cambio actual
agent: build
---
 
Ejecuta los tests relevantes para los archivos tocados en esta sesión.
Resume primero los fallos y luego propone el fix más pequeño y creíble.

Así mantienes los prompts comunes cortos y fáciles de revisar.

Tip 5: usa bien un provider antes de perseguirlos todos

La idea agnóstica de OpenCode es una fortaleza, pero también puede empujarte a sobreconfigurar demasiado pronto.

No empieces conectando cinco providers, tres cadenas de fallback y una matriz de modelos custom. Empieza con el provider que ya pagas y entiendes. Amplía solo después de saber cómo se siente OpenCode por sí mismo.

Si eres nuevo en esta categoría, How to Use Codex también vale la pena, porque enseña la misma lección operativa: tareas bien acotadas vencen al exceso de herramientas.

Tip 6: saber cuándo gana terminal, escritorio o IDE

OpenCode ahora es más que un binario de terminal.

Usa el terminal cuando quieras el ciclo prompt-edit-test más rápido.

Usa la app de escritorio cuando la visibilidad del review, el manejo de sesiones y la comodidad de UI importen más que la velocidad pura.

Usa la extensión de IDE cuando tu editor ya sea tu superficie de control.

El error no es elegir "mal para siempre". El error es usar la superficie equivocada para la tarea actual y luego culpar al agente.

Tip 7: deja que OpenCode formatee y estructure el cambio, pero revisa el diff como ingeniero

La documentación de OpenCode indica que puede usar formateadores específicos del lenguaje después de editar archivos. Eso ayuda, pero el formateo no equivale a calidad.

Todavía tienes que revisar:

• si la implementación realmente cumple el requisito
• si los comandos bash propuestos tienen sentido
• si se están siguiendo las reglas de AGENTS.md
• si el patch es demasiado amplio para la tarea

Los AI coding agents reducen tecleo. No reemplazan el juicio de ingeniería.

Cuándo sumar Oh My OpenCode

Oh My OpenCode no es OpenCode. Es una capa de orquestación más opinada construida alrededor de OpenCode.

La documentación actual del proyecto lo describe como un harness multi-modelo que añade:

• un modelo de orquestación más fuerte alrededor de agents especializados
• routing por categorías
• background agents y trabajo paralelo
• workflows centrados en MCP
• un estilo más agresivo de "seguir hasta terminar la tarea"
• comandos como ultrawork / ulw

Eso lo hace atractivo cuando OpenCode solo empieza a quedarse corto para el tipo de trabajo que haces.

La gracia de Oh My OpenCode no es que OpenCode sea débil. Es que algunos usuarios quieren un harness más directivo: más delegación, más orquestación, más especialización de modelos y menos steering manual una vez que la tarea empieza.

Cómo combinar OpenCode con Oh My OpenCode

1. Haz que OpenCode funcione solo primero

No montes un harness encima de una herramienta base que ni siquiera has probado.

Antes de añadir nada, asegúrate de poder:

• instalar OpenCode
• autenticar un provider
• ejecutar /init
• completar una tarea en plan
• completar una tarea en build

Si esa base está inestable, añadir Oh My OpenCode solo hará más difícil el debugging.

2. Entiende el naming antes de instalar

Hay un detalle de nombres que confunde:

• el repo de GitHub actualmente es code-yeongyu/oh-my-openagent
• el branding y el paquete siguen refiriéndose a Oh My OpenCode
• el comando de instalación sigue usando oh-my-opencode

A fecha de 17 de marzo de 2026, conviene tratarlos como la misma línea de proyecto.

3. Instala el harness con el installer oficial

La vía manual más simple es:

bunx oh-my-opencode install

El proyecto también recomienda explícitamente dejar que un agente IA obtenga y siga la guía de instalación, lo que encaja con su propia filosofía de orquestación.

4. Empieza por un comando fuerte, no por toda la superficie

La señal principal es:

ultrawork

o el alias corto:

ulw

Pero no lo trates como magia. Primero pruébalo en una tarea mediana con un final claro. Buenos primeros casos:

• arreglar un bug acotado y sumar los tests relacionados
• implementar una feature bien definida
• limpiar varios archivos ruidosos
• hacer research en paralelo mientras implementas en un repo que ya entiendes

Malos primeros casos:

• arquitectura greenfield vaga
• migración de producción sin rollback plan
• repo sensible sin política de permisos revisada

5. El mayor valor aparece cuando de verdad aprovechas la orquestación multi-modelo

Oh My OpenCode resulta más convincente cuando tu trabajo se beneficia de:

• modelos distintos para planning, reasoning y frontend
• especialistas en background
• uso más amplio de MCP
• disciplina más fuerte en subagents

Si tu día a día es más bien "fix pequeño en un archivo, correr tests y seguir", OpenCode solo suele ser suficiente.

OpenCode solo vs OpenCode + Oh My OpenCode

La recomendación pragmática sigue siendo simple:

1. Aprende OpenCode solo.
2. Escribe y haz commit de un AGENTS.md real.
3. Añade 2 o 3 comandos custom.
4. Ajusta permisos con más rigor.
5. Decide después si tu carga de trabajo justifica Oh My OpenCode.

Errores comunes

Confundir OpenCode con OpenClaw

No son el mismo proyecto.

Si buscabas OpenClaw pero quieres el agente de coding open source en terminal con plan, build, /init y compatibilidad con Oh My OpenCode, probablemente te referías a OpenCode.

Usar enlaces viejos de repositorio

Ya hay suficiente churn alrededor de los repos antiguos de OpenCode como para que convenga verificar la ruta de instalación. Empieza por las docs oficiales.

Instalar el harness antes de entender la base

Si no entiendes cómo se comporta OpenCode por sí solo, luego no sabrás si un problema viene del agent base, del harness, del provider o de tus reglas del repo.

Ir demasiado fuerte con las suscripciones desde el día 1

La flexibilidad de providers es útil, pero la mayoría debería empezar con el acceso que ya tiene.

FAQ

¿OpenCode es lo mismo que OpenClaw?

No. Son proyectos distintos. Esta página trata sobre OpenCode, el agente de AI coding open source documentado en opencode.ai.

¿Necesito Oh My OpenCode para usar bien OpenCode?

No. OpenCode ya es útil por sí solo. Oh My OpenCode interesa sobre todo cuando quieres una orquestación más fuerte, más delegación y un workflow multi-modelo más amplio.

¿Qué debería hacer justo después de instalar?

Ejecuta /connect, abre un proyecto real, lanza /init, cambia a plan y pide primero un resumen del repo antes de autorizar cambios.

¿Conviene empezar por terminal, desktop o IDE?

Empieza por terminal, salvo que ya sepas que prefieres un flujo de escritorio centrado en review o una integración nativa en el IDE.

¿Cuándo estoy listo para Oh My OpenCode?

Estás listo cuando OpenCode solo ya te resulta cómodo, tu AGENTS.md está en marcha y necesitas coordinar varias pasadas especializadas con frecuencia.

Guías relacionadas

• Hub de AI Coding
• How to Use Codex
• Parallel Code Agents Explained
• Build a Claude-Code-Like AI Agent with Claude Agent SDK
• OpenClaw vs ZeroClaw vs Pi Agent vs Nanobot