¡Oh Mi OpenCode! Inicio Rápido para OpenCode: Instalación, Configuración y Ejecución

Instala Oh My Opencode y lanza tus proyectos más rápido.

Índice

Oh My Opencode transforma OpenCode en un andamio de codificación multiagente: un orquestador delega el trabajo a agentes especialistas que se ejecutan en paralelo.

agentes de oh my opencode con portátiles y gpu

El modelo mental más breve que necesitas: instala el complemento y luego usa la palabra clave ultrawork (o ulw) cuando necesites una ejecución multiagente con potencia total.

Esta guía de inicio rápido cubre la instalación y la configuración del primer día. Una vez que esté funcionando:

Para la cadena de herramientas de IA más amplia, consulta el resumen de herramientas para desarrolladores de IA. Si prefieres una alternativa aislada y capaz de navegador a OpenCode, OpenHands adopta un enfoque arquitectónico diferente para la codificación de agentes.

Por qué existe Oh My Opencode

OpenCode es un agente de codificación de IA de código abierto que se ejecuta como una interfaz de terminal y gestiona ejecuciones de CLI no interactivas para scripting y automatización.

Oh My Opencode eleva ese techo mucho más alto. Añade una capa completa de orquestación construida alrededor del agente “Sisyphus”, colaboración multi-especialista e integración de herramientas más estrecha. El resultado es un sistema donde las tareas de ingeniería complejas —el tipo que normalmente requeriría que supervises varios prompts— se planifican, delegan y verifican en un único flujo de trabajo.

Dos conceptos surgen constantemente, así que dominarlos antes de nada:

  • Modo Ultrawork: un cambio de flujo de trabajo activado por palabra clave. Añadir ultrawork o ulw a tu prompt activa la ejecución paralela en segundo plano, integración LSP, gestión de contexto y descomposición automática de tareas: no es solo una elección estilística.
  • Agentes especializados: roles con nombre como @oracle para arquitectura y @librarian para investigación y documentación. Puedes llamarlos explícitamente o dejar que el orquestador los enrute automáticamente.

Este artículo utiliza Oh My Opencode, oh-my-opencode y Oh My OpenCode indistintamente: todos se refieren al mismo complemento en el ecosistema de OpenCode.

Prerrequisitos y terminología

Necesitas OpenCode instalado y funcionando primero. Consulta nuestro Inicio rápido de OpenCode para aprender cómo instalarlo, configurarlo y empezar a usarlo.

Por defecto, opencode inicia la interfaz de terminal cuando se ejecuta sin argumentos, y también puedes usar opencode run ... para la ejecución no interactiva.

Oh My Opencode requiere al menos un proveedor configurado. OpenCode carga proveedores desde credenciales, variables de entorno o un .env del proyecto. La forma más rápida de resolver esto:

opencode auth login
opencode auth list

Las credenciales residen en ~/.local/share/opencode/auth.json.

Un detalle de nomenclatura que vale la pena saber de antemano: el repositorio de GitHub aguas arriba ahora tiene la marca oh-my-openagent (“anteriormente oh-my-opencode”), pero el nombre del complemento y del paquete en las configuraciones sigue siendo oh-my-opencode. Ambos nombres circulan en publicaciones de la comunidad: son lo mismo.

Inicio rápido de instalación

Hay múltiples rutas (instalador de CLI, clonación manual del repositorio o “dejar que un agente lo instale”). La elección correcta depende de si quieres un flujo de instalación repetible o un control manual completo.

Si tienes Bun instalado, bunx es el equivalente de npx de Bun, diseñado para ejecutar paquetes npm rápidamente sin un paso de instalación global separado.

Para instalar bunx en linux:

curl -fsSL https://bun.com/install | bash

Instalación automática con OpenCode

Puedes ejecutar un prompt en OpenCode y este instalará Oh My Opencode automáticamente.

Instala y configura oh-my-opencode siguiendo las instrucciones aquí:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

Te hará algunas preguntas sobre tus suscripciones de LLM y registrará Oh My Opencode en los complementos de OpenCode.

Ruta manual: ejecutar el instalador de Oh My Opencode con bunx o npx

Instalador interactivo que te pregunta sobre tus proveedores y genera una configuración “óptima” automáticamente, y también un modo no interactivo para automatización y agentes.

Instalación interactiva:

bunx oh-my-opencode install
# o si prefieres la herramienta npm
npx oh-my-opencode install

Instalación no interactiva (útil para scripts de aprovisionamiento, imágenes de CI o “instalaciones de agentes”):

bunx oh-my-opencode install --no-tui \
  --claude=<yes|no|max20> \
  --openai=<yes|no> \
  --gemini=<yes|no> \
  --copilot=<yes|no>

Lo que hace el instalador, a un nivel alto:

  • registra el complemento en la configuración de OpenCode
  • genera asignaciones de modelos usando la disponibilidad del proveedor y reglas de respaldo
  • escribe la configuración de oh-my-opencode junto a los archivos de configuración de OpenCode

Ruta manual: clonar el repositorio y ejecutar el script de instalación

También hay un flujo manual “humano”: clonar el repositorio, instalar las dependencias y luego ejecutar un script de instalación que detecta la ubicación de tu configuración de OpenCode, hace una copia de seguridad y fusiona la configuración.

git clone https://github.com/code-yeongyu/oh-my-opencode.git ~/.oh-my-opencode
cd ~/.oh-my-opencode
npm install
npm run install

Si el script no puede encontrar tu configuración de OpenCode automáticamente, establece la variable de entorno de la ruta de configuración explícitamente antes de volver a ejecutar el instalador.

Lista de verificación rápida de validación

Después de la instalación, valida tres cosas:

  • tu archivo de configuración de Oh My Opencode existe en una ubicación reconocida
  • los agentes especializados pueden ser invocados
  • el disparador de la palabra clave ultrawork funciona como se espera

Ejemplos para copiar:

# Mostrar el archivo de configuración del complemento (prueba la ubicación que coincida con tu configuración)
cat .opencode/oh-my-opencode.json
cat ~/.config/opencode/oh-my-opencode.json

# Prueba rápida de agente
opencode run "Usar @oracle para analizar la arquitectura del proyecto actual"

# Prueba rápida de disparador ultrawork
opencode run "ulw listar todos los archivos de configuración en este proyecto"

Si los tres pasan, estás genuinamente listo: no solo instalado.

Configuración y ajuste

Dónde vive la configuración y cómo funciona la precedencia

Oh My Opencode busca archivos de configuración en un orden de prioridad, con la configuración a nivel de proyecto teniendo precedencia sobre la configuración a nivel de usuario. El orden de búsqueda documentado es:

  • .opencode/oh-my-opencode.json (nivel de proyecto, mayor prioridad)
  • ~/.config/opencode/oh-my-opencode.json (nivel de usuario en macOS y Linux)
  • %APPDATA%\opencode\oh-my-opencode.json (nivel de usuario en Windows)

OpenCode en sí también soporta múltiples fuentes de configuración y las fusiona en lugar de reemplazarlas, con fuentes posteriores sobrescribiendo las anteriores solo cuando hay conflictos de claves. Esto importa porque típicamente quieres una línea base global estable más sobrescrituras por repositorio.

Soporte JSONC para configuraciones sensatas

Tanto OpenCode como Oh My Opencode soportan JSONC, lo que significa que puedes mantener comentarios y comas finales en los archivos de configuración sin romper el análisis. Esto es especialmente útil para documentar por qué se eligieron ciertos límites o modelos.

La palabra clave “ultrawork” y lo que habilita

ultrawork (o ulw) es el interruptor de modo al que recurrirás más a menudo. Introdúcelo en tu descripción de tarea y el sistema habilitará la ejecución paralela en segundo plano, integración LSP, gestión de contexto y descomposición automática de tareas. No es una pista para el modelo: es un disparador duro que cambia cómo se estructura toda la ejecución.

Concurrencia y tareas en segundo plano

Oh My Opencode expone controles de concurrencia para la ejecución en segundo plano mediante sisyphus.max_concurrent_tasks.

No persigas una alta concurrencia aquí. Cada plan de proveedor tiene un techo: Claude Max20, por ejemplo, se detiene en 3 tareas paralelas, y empujar más allá de eso produce finalizaciones inestables y tiempos de espera difíciles de depurar. Empieza con cautela y solo aumenta después de ejecuciones limpias.

Una configuración de concurrencia mínima se ve así:

{
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2,
    "task_timeout": 300
  }
}

Una concurrencia de 2 es un punto de partida seguro para la mayoría de los planes.

Enrutamiento de modelos por agente y por categoría

Oh My Opencode se basa en la idea de que diferentes tareas se benefician de diferentes modelos, por lo que la configuración soporta:

  • selección de modelos por agente, variantes y extensiones de prompt
  • enrutamiento basado en categorías para trabajo “rápido” vs “profundo”
  • modelos de respaldo cuando tu proveedor preferido no está disponible

El análisis en profundidad de agentes especializados cubre el sistema completo de enrutamiento de modelos en detalle, incluyendo por qué ciertos agentes no deben cambiarse a la familia de modelos incorrecta, las cadenas de respaldo completas y cómo sobrescribir modelos de forma segura para configuraciones autoalojadas.

La resolución de modelos es por capas: tu sobrescritura explícita gana, luego el respaldo del proveedor y luego el predeterminado del sistema. La cadena de respaldo comienza con tus proveedores nativos y puede bajar a alternativas como GitHub Copilot si no hay nada más disponible, lo que significa que un agente mal configurado es poco probable que falle en silencio; simplemente usará un modelo más débil.

Una configuración de inicio práctica que puedes adaptar (se recomienda JSONC):

{
  "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json",

  // Mantén la concurrencia conservadora hasta que confíes en los límites de tu proveedor
  "sisyphus": {
    "enabled": true,
    "max_concurrent_tasks": 2,
    "task_timeout": 300
  },

  // Ajuste de agentes
  "agents": {
    "oracle": {
      "enabled": true,
      "model": "openai/gpt-5.2",
      "variant": "high",
      "temperature": 0.7,
      "prompt_append": "Proporciona compensaciones concisas y una recomendación clara"
    },
    "librarian": {
      "enabled": true,
      "model": "google/gemini-3.1-pro"
    }
  },

  // Enrutamiento por categorías para consultas rápidas vs trabajo más profundo
  "categories": {
    "quick": { "model": "opencode/gpt-5-nano" },
    "visual-engineering": { "model": "google/gemini-3.1-pro" }
  }
}

El campo $schema vale la pena mantenerlo: desbloquea la autocompletado en la mayoría de los editores y atrapa errores tipográficos en los nombres de los agentes antes de que desperdicies una ejecución con una configuración rota.

Integración MCP y ganchos

Oh My Opencode soporta servidores MCP (Model Context Protocol) mediante un bloque de configuración donde defines el comando del servidor, argumentos y variables de entorno.

En la práctica, el camino más fácil es gestionar los MCP directamente a través de OpenCode usando el grupo de comandos opencode mcp: maneja la adición, listado y autenticación OAuth sin que tengas que tocar archivos de configuración manualmente.

Ejemplos de flujo de trabajo que puedes copiar

Los dos ejemplos de abajo están intencionalmente modelados como “repositorios reales”: muestran cómo activar la orquestación, cómo apuntar a agentes especializados y cómo mantener los resultados verificables.

Ejemplo: Revisión de arquitectura con Oracle y un mapa de repositorio

Usa esto cuando te unes a una nueva base de código o heredas un servicio y necesitas una vista rápida y accionable de la arquitectura. Oracle es un especialista de solo lectura: no puede hacer cambios, solo aconsejar.

Ejecútalo desde la raíz de tu proyecto:

opencode

OpenCode iniciará su interfaz de terminal por defecto cuando se lance sin argumentos.

Luego, pídele a Oracle que produzca un análisis de arquitectura y un plan concreto de refactorización o modularización:

Usa @oracle para analizar la arquitectura de este repositorio.
Identifica los contextos de límites clave, los bordes de dependencia principales y los componentes de mayor riesgo.
Termina con un plan de refactorización que pueda ejecutarse en pequeñas PR.

Para registro o scripting, salta la TUI por completo y usa opencode run:

opencode run "Usa @oracle para analizar la arquitectura de este repositorio y proponer un plan de refactorización por etapas"

opencode run pasa el prompt directamente y sale cuando termina: exactamente lo que quieres para pasos de CI o tuberías de automatización.

Ejemplo: Implementación de función completa con orquestación ultrawork

Usa esto cuando necesitas una función que toque múltiples archivos o capas, o cuando quieres tareas en segundo plano y agentes especializados habilitados automáticamente.

Comienza con un prompt ultrawork:

opencode run "ultrawork implementar un nuevo extremo /health con verificaciones de preparación y actividad, añadir pruebas, actualizar documentación y verificar que se ejecuta localmente"

La palabra clave ultrawork activa todos los agentes especializados configurados, paralelismo de tareas en segundo plano y herramientas más profundas de una sola vez. No necesitas prompts separados para planificar, implementar y probar.

Cuando usas ultrawork, aún puedes dirigir explícitamente el comportamiento de los especialistas. Por ejemplo, podrías forzar el diseño de arquitectura primero:

opencode run "ultrawork pedir a @oracle que diseñe el contrato del extremo y las dependencias primero, luego implementar con cambios mínimos y añadir pruebas"

Combinar ultrawork con menciones explícitas de agentes como @oracle es el punto dulce: obtienes la orquestación completa pero sigues controlando qué especialista maneja las decisiones de diseño críticas.

Una cosa que debes hacer bien para tareas ultrawork más grandes: mantén la concurrencia dentro de los límites de tu proveedor. Empieza en 2, ejecuta unas pocas tareas limpiamente y luego decide si aumentar. Empujar más allá del techo de tu plan no hace que las cosas sean más rápidas: las hace poco fiables.

Solución de problemas y mejores prácticas

La palabra clave Ultrawork no se activa

Si ulw o ultrawork se ignoran, trata esto como una señal para verificar la carga del complemento y la compatibilidad de versiones. Ha habido al menos un retroceso reportado donde la detección de palabras clave no inyectó el prompt de modo ultrawork esperado, con la investigación apuntando al gancho dedicado de detección de palabras clave.

En la práctica, las correcciones más rápidas son:

  • confirma que el complemento está registrado y los archivos de configuración están presentes (consulta la lista de verificación de validación anterior)
  • actualiza OpenCode o el complemento si estás en una versión conocida que retrocede en la detección de palabras clave

El script de instalación no puede encontrar tu configuración de OpenCode

Verifica que OpenCode esté instalado (opencode --version), luego establece una variable de entorno de ruta de configuración explícita antes de volver a ejecutar el instalador.

Demasiadas tareas en segundo plano o problemas de limitación

Si encuentras límites de velocidad, tiempos de espera o finalizaciones inestables, la corrección siempre es la misma: reduce la concurrencia y vuelve a ejecutar. Persuadir un mayor paralelismo cuando tu proveedor ya te está limitando es una batalla perdida.

Cuando no deberías usar ultrawork

Ultrawork es potente, pero no es gratis: cada agente paralelo cuesta tokens y cuenta contra tus límites de velocidad. Resérvalo para refactorizaciones grandes, trabajo de características full-stack y tareas complejas de múltiples pasos. Para una pequeña edición de un solo archivo o una pregunta rápida, un prompt plano es más rápido y más barato.

Una regla de oro sólida:

  • usa prompts normales para ediciones pequeñas y preguntas sencillas
  • usa ultrawork cuando quieres que el sistema descomponga, delegue, ejecute y verifique a través del repositorio

Nota de cumplimiento sobre los términos del proveedor

Algunos debates comunitarios alrededor de este ecosistema tocan las restricciones de proveedores y los términos de servicio, particularmente alrededor de OAuth de terceros y capas de compatibilidad. Estas son restricciones reales: revisa los términos de tu proveedor antes de ejecutar flujos de trabajo automatizados o paralelos a gran escala, y no asumas que una integración que funciona significa que está permitida.

¿Listo para profundizar? El análisis en profundidad de agentes especializados explica el rol de cada agente, los requisitos del modelo y las opciones de autoalojamiento. Para datos de rendimiento honestos y riesgos de facturación reportados por la comunidad, consulta el artículo de experiencia con Oh My Opencode.