oh-my-claudecode: orquestación multi-agente para Claude Code

Introducción: el dolor de coordinar múltiples agentes de IA

⏱️ Lectura: 12 min

Claude Code cambió la forma en que miles de desarrolladores escribimos software. Pero quienes lo usan a diario saben que la experiencia base tiene un techo claro: cuando el trabajo crece, empezás a necesitar varios agentes corriendo en paralelo, planes que se dividan entre ellos, verificación automática de que lo hecho realmente funciona, y una forma de que el sistema aprenda de tus errores y los reutilice en la próxima sesión. Todo eso se puede construir a mano, pero lleva meses y el resultado rara vez sobrevive a una actualización del CLI.

📑 En este artículo

1. Introducción: el dolor de coordinar múltiples agentes de IA
2. Qué es oh-my-claudecode
3. Instalación en Windows, macOS y Linux
   1. Windows
   2. macOS
   3. Linux
4. Uso básico: tu primer autopilot
5. Integración en proyectos reales: Team mode y skills persistentes
6. Cuándo usarlo y cuándo no
7. Alternativas en el ecosistema
8. Conclusión: una capa seria sobre Claude Code
9. Referencias
   1. 📚 Artículos relacionados

Ese es exactamente el nicho que vino a llenar oh-my-claudecode (OMC para los amigos), una capa de orquestación multi-agente que se instala encima de Claude Code y convierte al CLI en un sistema coordinado de ejecución, verificación y aprendizaje. El proyecto pasó de ser un experimento de su creador Yeachan Heo a superar las 30.000 estrellas en GitHub en menos de un año, con contribuciones de una comunidad internacional y un paquete npm bautizado sisyphus porque el sistema está diseñado para no rendirse hasta que la tarea está verificada y completa.

En este tutorial vamos a ver qué resuelve OMC, cómo instalarlo en Windows, macOS y Linux, cómo lanzar tu primer flujo autónomo con autopilot, y en qué casos conviene, o no, sumar esta capa sobre tu setup actual de Claude Code. El enfoque es el de un desarrollador LATAM que quiere productividad real, no magia de feria.

Qué es oh-my-claudecode

oh-my-claudecode es, en palabras simples, un sistema de orquestación multi-agente para Claude Code con cero curva de aprendizaje. La filosofía del proyecto, escrita en el propio README, es provocadora: No aprendas Claude Code, usá OMC. La idea es que el usuario describa en lenguaje natural lo que necesita y el sistema decida cuántos agentes lanzar, en qué orden, con qué modelo (Haiku para tareas simples, Opus para razonamiento complejo) y cómo verificar el resultado.

Bajo el capó, OMC expone dos superficies distintas pero conectadas. Por un lado, una serie de slash commands dentro de la sesión de Claude Code (/team, /autopilot, /ralph, /ultrawork, /deep-interview). Por otro, un CLI de terminal llamado omc que lanza workers reales en paneles de tmux usando los CLIs de Claude, Codex o Gemini. Las dos caras comparten configuración, skills extraídas y artefactos, pero se usan en contextos diferentes.

El modo estrella desde la versión 4.1.7 es Team, un pipeline por etapas que sigue la secuencia team-plan → team-prd → team-exec → team-verify → team-fix. Primero se planifica, después se genera un documento de requisitos (PRD), se ejecuta el trabajo, se verifica que cumple los criterios y, si algo falla, se entra en un bucle de corrección hasta que el resultado pasa la verificación. Esa persistencia, la idea de que un sistema no entrega hasta que realmente funciona, es la que diferencia a OMC de un simple wrapper.

El ecosistema incluye además 19 agentes especializados (arquitectura, investigación, diseño, testing, ciencia de datos), un sistema de skills reutilizables que extrae patrones de tus sesiones pasadas y los vuelve a inyectar cuando detecta contextos similares, una HUD con statusline que muestra en tiempo real qué está pasando en la orquestación, analíticas de costos y ruteo inteligente de modelos que, según el mantenedor, ahorra entre el 30% y el 50% de tokens.

Instalación en Windows, macOS y Linux

OMC se puede instalar por dos caminos distintos: el flujo del marketplace de Claude Code (recomendado para la mayoría de los usuarios) o el paquete global de npm, que sirve para usar el CLI omc desde la terminal. Ambos pueden convivir y muchas veces se combinan.

Antes de empezar, asegurate de tener instalado Node.js 18 o superior y Claude Code en tu sistema. Si todavía no tenés Claude Code, el CLI se instala con npm i -g @anthropic-ai/claude-code. Para usar los workers con Codex o Gemini vas a necesitar además los CLIs de esos proveedores.

Windows

En Windows se recomienda trabajar desde PowerShell o, mejor aún, desde WSL2, porque OMC lanza procesos en tmux para los workers en modo CLI y tmux es un componente Unix. Si vas por el camino del plugin de Claude Code, no necesitás tmux.

npm i -g oh-my-claude-sisyphus@latest
omc setup

Si preferís el flujo del marketplace, abrí una sesión de Claude Code y ejecutá los comandos uno a la vez (pegar los dos juntos hace que falle la segunda llamada):

/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode
/plugin install oh-my-claudecode

macOS

En macOS la instalación es directa. Si tenés Homebrew, asegurate de tener Node instalado con brew install node y tmux con brew install tmux para habilitar los workers CLI:

brew install node tmux
npm i -g oh-my-claude-sisyphus@latest
omc setup

Para el flujo del marketplace, los mismos comandos /plugin marketplace add y /plugin install funcionan sin cambios dentro de la sesión de Claude Code.

Linux

En Linux (Ubuntu, Debian, Arch, Fedora) la instalación sigue el patrón estándar. Instalá Node.js desde el repositorio oficial de NodeSource o desde nvm, y tmux desde el gestor de paquetes de tu distribución:

# Ubuntu / Debian
sudo apt install -y nodejs npm tmux

# Arch
sudo pacman -S nodejs npm tmux

# Fedora
sudo dnf install nodejs tmux

# Después, igual que en las otras plataformas:
npm i -g oh-my-claude-sisyphus@latest
omc setup

Una vez que omc setup corre sin errores, podés verificar el estado del sistema con /omc-doctor dentro de una sesión de Claude Code. El comando revisa la caché del plugin, la configuración de las skills, y te avisa si hay inconsistencias entre el runtime del marketplace y el paquete npm.

Uso básico: tu primer autopilot

Después de instalar, la forma más rápida de probar OMC es lanzar un autopilot, el modo autónomo más ceremonioso y a la vez más simple del ecosistema. Un solo agente líder toma la tarea completa, planifica, ejecuta y verifica, devolviendo control al usuario sólo cuando terminó o cuando necesita una decisión que no puede tomar.

# Dentro de una sesión de Claude Code
/autopilot "construir una API REST para gestionar tareas"

# O como atajo natural dentro de la sesión
autopilot: construir una API REST para gestionar tareas

Si no tenés claros los requisitos, OMC recomienda empezar con /deep-interview, un modo que aplica cuestionamiento socrático para forzarte a precisar qué querés construir antes de que el sistema gaste tokens generando código. El agente hace preguntas, mide la claridad de tus respuestas en dimensiones ponderadas, y te deja con un documento mucho más sólido del que normalmente empezás.

/deep-interview "quiero construir una app de gestión de tareas"

Integración en proyectos reales: Team mode y skills persistentes

En proyectos reales, donde las tareas son grandes y el código ya tiene historia, el modo más potente es Team. Podés pedirle a OMC que lance, por ejemplo, tres ejecutores trabajando en paralelo sobre una misma base de errores de TypeScript:

/team 3:executor "corregir todos los errores de TypeScript en /src"

Para activar los teams nativos de Claude Code, agregá esta variable de entorno a ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Si tu trabajo combina revisión de arquitectura (fortaleza de Codex) con diseño de UI (fortaleza de Gemini), la pieza clave es el skill /ccg, que consulta a los dos modelos en paralelo y luego pide a Claude que sintetice una respuesta consistente. Para tareas donde necesitás paneles separados con procesos CLI reales, omc team es el camino:

omc team 2:codex "revisar el módulo de autenticación por problemas de seguridad"
omc team 2:gemini "rediseñar los componentes de UI para accesibilidad"
omc team 1:claude "implementar el flujo de pagos"
omc team status auth-review
omc team shutdown auth-review

Otra pieza que brilla en proyectos largos son las skills persistentes. Cada vez que resolvés un bug complejo, podés pedirle al /learner que extraiga el patrón en un archivo Markdown reutilizable, guardado por proyecto en .omc/skills/ (versionable con el repo) o por usuario en ~/.omc/skills/ (compartido entre todos tus proyectos). Cuando OMC detecta un contexto similar en una sesión futura, inyecta la skill automáticamente y ahorra el re-descubrimiento del bug.

---
name: Fix Proxy Crash
description: aiohttp proxy crashes on ClientDisconnectedError
triggers: ["proxy", "aiohttp", "disconnected"]
source: extracted
---
Envolver el handler en server.py:42 en try/except ClientDisconnectedError...

Cuándo usarlo y cuándo no

OMC no es una bala de plata. Conviene usarlo cuando el trabajo involucra múltiples archivos, subsistemas o lenguajes; cuando necesitás paralelismo real y no querés coordinar a mano las ventanas de contexto; cuando la tarea requiere verificación estricta (por ejemplo, migraciones, refactors grandes, auditorías de seguridad); o cuando ya venís usando Claude Code pero sentís que la superficie pelada del CLI se queda corta.

En cambio, no conviene para tareas triviales de un solo archivo. Para editar una función de veinte líneas, lanzar un pipeline de cinco etapas con verificación y reintentos es un desperdicio de tokens y una fuente de latencia innecesaria. Tampoco es la herramienta si no sos usuario de Claude Code: OMC es una capa encima, no un reemplazo, y no funciona con Cursor, Continue u otros asistentes. Además, los modos de orquestación agresiva consumen tokens rápidamente; si tu plan de Anthropic es limitado, conviene empezar con autopilot y dejar ultrawork o ralph para las tareas donde realmente se justifica.

Otro trade-off honesto: la complejidad. OMC trae 19 agentes, siete modos de orquestación, dos superficies (CLI y sesión), skills, HUD y analíticas. Es mucha superficie para absorber, y aunque el lema es cero curva de aprendizaje, la verdad es que saber cuándo elegir /team versus /autopilot versus omc team requiere experiencia que sólo se gana usándolo en proyectos reales.

Alternativas en el ecosistema

El espacio de agentes de programación en 2026 está lleno, pero pocas herramientas se parecen realmente a OMC. Vale la pena comparar con tres proyectos cercanos:

• Aider — Probablemente el CLI de AI coding más veterano y estable. Trabaja directamente contra el repo de git, hace commits atómicos y soporta múltiples modelos (Claude, GPT, modelos locales). Es más minimalista que OMC: un solo agente, sin orquestación paralela, sin skills persistentes. Mejor para quien quiere simplicidad y control directo.
• Cline (antes Claude Dev) — Extensión de VS Code con enfoque agentic. Ejecuta tareas en el editor, soporta automatización de navegador y uso de tools. No es multi-agente en el sentido de OMC, pero tiene una integración con el editor que el CLI no puede ofrecer. Para quien vive en VS Code y no quiere salir.
• oh-my-codex — El proyecto hermano del mismo autor de OMC, pero para OpenAI Codex CLI. Si tu stack principal es Codex en lugar de Claude Code, esta es la versión natural. Comparte la filosofía Teams-first y muchos de los modos de ejecución.

No hay un ranking objetivo entre estas herramientas: cada una optimiza para un escenario distinto. OMC gana cuando el proyecto ya está en Claude Code y el cuello de botella es la coordinación de tareas grandes; Aider gana en simplicidad y control; Cline gana en integración con el editor. La decisión depende de tu stack, tu plan de tokens y el tamaño de las tareas que resolvés a diario.

Conclusión: una capa seria sobre Claude Code

oh-my-claudecode es una de las piezas más ambiciosas que se han construido encima de un CLI de IA en los últimos meses. Las 30.000 estrellas en GitHub no son gratuitas: el proyecto resuelve problemas reales de coordinación, persistencia, verificación y aprendizaje que cualquiera que use Claude Code en serio termina encontrando. La apuesta por Teams-first, hacer del trabajo multi-agente la primera opción y no una feature enterrada, acierta con el movimiento general de la industria hacia pipelines de agentes especializados.

Para un desarrollador LATAM que ya paga su suscripción de Claude y siente que le falta un escalón, empezar es tan simple como correr npm i -g oh-my-claude-sisyphus@latest y lanzar un /autopilot para una tarea mediana. Si el primer intento convence, de ahí se crece hacia Team mode, skills persistentes y eventualmente la orquestación CLI con Codex y Gemini en paneles de tmux. Todo el código del proyecto está bajo licencia MIT en el repositorio Yeachan-Heo/oh-my-claudecode, y la documentación completa vive en oh-my-claudecode.dev.

El mensaje final es claro: si estás escribiendo software con IA todos los días y te encontrás reinventando pipelines de coordinación, OMC te ahorra meses. Si todavía estás explorando, arrancá con algo más chico como Aider y volvé a OMC cuando sientas el techo.

Repositorio oficial en GitHub

Referencias

• Repositorio oficial: Yeachan-Heo/oh-my-claudecode
• Sitio oficial: oh-my-claudecode.dev
• Paquete npm: oh-my-claude-sisyphus
• Proyecto hermano: oh-my-codex
• Discord de la comunidad OMC

📱 ¿Te gusta este contenido? Únete a nuestro canal de Telegram @programacion donde publicamos a diario lo más relevante de tecnología, IA y desarrollo. Resúmenes rápidos, contenido fresco todos los días.