Despliegue y trucos de oh-my-claudecode: 32 Agentes profesionales trabajando para ti, duplicando la eficiencia

Dificultad: Intermedia | Duración: 30 minutos | Resultados: Dominio de la orquestación multi-agente, despliegue sin configuración, creación de pipelines de equipo

Lectores objetivo: Desarrolladores que ya usan o planean usar Claude Code y equipos que desean mejorar la eficiencia de colaboración de sus Agentes.

Dependencias principales: Node.js ≥18, tmux (opcional multiplataforma), Claude Code CLI

---

1. Introducción al proyecto

Claude Code ya es potente por sí solo, pero un único Agente suele quedarse corto ante proyectos complejos de múltiples módulos: te ves obligado a cambiar repetidamente entre ventanas de chat o coordinar manualmente la revisión de código, el diseño de arquitectura y la validación de pruebas.

oh-my-claudecode (en adelante, OMC) llega para resolver este problema. Es una capa de orquestación multi-agente para Claude Code, cuyo concepto central es:

Don't learn Claude Code. Just use OMC. (No aprendas Claude Code. Simplemente usa OMC).

En pocas palabras, solo necesitas describir lo que quieres en lenguaje natural; OMC programará automáticamente 32 Agentes profesionales, elegirá el modelo adecuado (Haiku / Sonnet / Opus) y procesará las tareas en paralelo hasta que se supere la validación. Todo el proceso no requiere configuración ni memorizar comandos.

Dirección del proyecto: https://github.com/Yeachan-Heo/oh-my-claudecode

---

2. Resumen de características principales

2.1 Listo para usar sin configuración

No necesitas escribir configuraciones YAML o JSON. Tras la instalación, puedes ejecutarlo hablando en lenguaje natural. Los valores predeterminados inteligentes cubren el 90% de los escenarios.

2.2 32 Agentes profesionales

Cada Agente tiene un ámbito de responsabilidad claro. OMC enrutará automáticamente a la tarea al Agente más adecuado:

La lista completa se define en AGENTS.md.

2.3 Enrutamiento inteligente de modelos

OMC selecciona automáticamente el modelo según la complejidad de la tarea:

• Haiku: Búsquedas simples, formateo, cambios menores de texto.
• Sonnet: Implementación estándar, depuración, pruebas (el motor principal diario).
• Opus: Diseño de arquitectura, revisión de seguridad, refactorización compleja.

Esto optimiza los costes; el feedback de la comunidad indica un ahorro promedio del 30-50% en el consumo de tokens.

2.4 Paralelización automática

Las tareas independientes se asignan automáticamente a diferentes Agentes para su ejecución paralela, sin necesidad de desglosarlas manualmente.

2.5 Ejecución persistente (ciclo verify/fix)

En el modo Ralph, una vez que el Agente completa la tarea, entra automáticamente en un ciclo de validación: si la validación falla, se corrige a sí mismo y vuelve a ejecutar hasta que realmente pase.

2.6 Autoaprendizaje de habilidades (Sistema Learner)

La experiencia de depuración obtenida durante la ejecución se extrae automáticamente en archivos de habilidades (Skills) reutilizables en .omc/skills/. La próxima vez que surja un problema similar, se inyectará el contexto automáticamente, sin que tengas que recordarlo.

2.7 Integración con OpenClaw

Soporta el reenvío de eventos de sesión de Claude Code a OpenClaw Gateway para notificaciones automatizadas y activación remota a través de canales como Telegram / Discord.

---

3. Estructura completa del proyecto

oh-my-claudecode/
├── agents/              # Archivos de definición de los 32 Agentes
├── bridge/              # Puentes para OpenClaw / terceros
├── docs/                # Documentación de arquitectura, guías de migración, monitoreo
├── examples/            # Flujos de trabajo de ejemplo
├── hooks/               # Inyección de ganchos (hooks) de Claude Code
├── missions/            # Definición de misiones
├── research/            # Módulo de investigación
├── scripts/             # Scripts de utilidad (Demo de OpenClaw Gateway, etc.)
├── skills/              # Archivos de Skills integrados en OMC
├── src/                 # Código fuente principal
├── tests/               # Suite de pruebas
├── CLAUDE.md            # Configuración principal de ejecución del Agente (OMC la inyecta a Claude Code)
├── AGENTS.md            # Catálogo y descripción de Agentes
└── package.json

Para el usuario común, la interacción diaria se centra en:

• skills/ — Archivos de habilidades personalizados.
• .omc/ — Sesiones, estados y archivos de planificación generados en tiempo de ejecución.

---

4. Instalación y configuración

4.1 Dependencias previas

Instalación obligatoria:

• Claude Code CLI — Requiere suscripción Max/Pro o una API Key de Anthropic.
• Node.js ≥18 — OMC es un proyecto TypeScript/npm.

Opcional pero muy recomendado:

• tmux — Las funciones omc team y la recuperación automática de límites de tasa dependen de tmux.

Instalación de tmux por plataforma:

# macOS
brew install tmux

# Ubuntu / Debian
sudo apt install tmux

# Arch
sudo pacman -S tmux

# Windows nativo (recomendado)
winget install psmux

# Windows WSL2
sudo apt install tmux

4.2 Instalar OMC (Dos métodos)

Método 1: Instalación vía Marketplace (Recomendado)

# Añadir fuente del plugin
/plugin marketplace add https://github.com/Yeachan-Heo/oh-my-claudecode

# Instalar plugin
/plugin install oh-my-claudecode

Método 2: Instalación global vía npm

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

Tras la instalación, OMC se activará automáticamente y todos los comandos / y palabras clave mágicas estarán disponibles.

4.3 Configuración inicial

# Ejecutar en cualquier directorio
/setup
/omc-setup

La primera ejecución te guiará para:

• Confirmar el directorio de configuración de Claude Code.
• Configurar OpenClaw Gateway (opcional).
• Detectar sesiones tmux.

Si encuentras anomalías, ejecuta la herramienta de diagnóstico:

/omc-doctor

4.4 Habilitar el Team Mode (Recomendado)

El Team Mode es el método de orquestación por defecto desde OMC v4.1.7. Requiere activar características experimentales en la configuración de Claude Code:

# Editar ~/.claude/settings.json

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

---

5. Análisis profundo de los modos de ejecución

OMC ofrece varios modos de ejecución según el escenario. Entender sus diferencias es clave para la eficiencia.

5.1 Team Mode (Recomendado) ⭐

Escenario: Tareas complejas multimódulo que requieren colaboración en arquitectura, codificación, revisión y pruebas.

El Team Mode corre sobre un pipeline estricto:

team-plan → team-prd → team-exec → team-verify → team-fix (bucle)

La tarea comienza con la planificación, pasa por el diseño de producto, ejecución de código, validación, y si se detectan problemas en la fase de corrección (fix), vuelve a la ejecución. OMC coordina todo sin intervención humana.

Uso básico:

/team 3:executor "Corregir todos los errores de compilación de TypeScript"

El número 3 indica el uso de 3 Agentes ejecutores trabajando en paralelo.

CLI vía tmux Workers (v4.4.0+):

omc team 2:codex "Revisar seguridad del módulo auth"
omc team 2:gemini "Rediseñar accesibilidad de componentes UI"
omc team 1:claude "Implementar flujo de pago"
omc team status auth-review
omc team shutdown auth-review

Estos son procesos tmux independientes reales que se cierran automáticamente al terminar, sin consumir recursos innecesarios.

5.2 Autopilot

Escenario: Requisitos claros, completar una función de extremo a extremo sin mucha intervención humana.

autopilot: build a REST API for managing tasks

En modo Autopilot, un único Agente líder se encarga de todo el proceso, desde el diseño hasta la implementación, sin depender del pipeline de equipo.

5.3 Ralph (Modo persistente)

Escenario: Tareas que deben completarse totalmente, sin permitir un "salir al terminar parcialmente".

El modo Ralph incluye la capacidad paralela de Ultrawork y añade el ciclo verify/fix:

executor → verify → fix → verify (hasta que pase)

ralph: refactorizar módulo auth, requiere que pasen todos los tests

Si notas que Claude Code suele salir cuando "parece que terminó" pero sin validar realmente, Ralph es la solución.

5.4 Ultrawork (Máximo paralelismo)

Escenario: Correcciones o refactorizaciones masivas que requieren la máxima velocidad.

ulw corregir todos los errores de ESLint
ulw renombrar todos los componentes a PascalCase

Todas las correcciones se ejecutan en paralelo sin esperar a que termine la anterior, ideal para procesar listas de problemas conocidos.

5.5 /ccg Consultor de triple modelo

Escenario: Cuando necesitas perspectivas de Codex y Gemini simultáneamente, sintetizadas por Claude.

/ccg Review this PR — architecture (Codex) and UI components (Gemini)

Llamada a /ask codex + /ask gemini, y Claude se encarga de la salida final combinada. Ideal para revisiones conjuntas de frontend+backend.

5.6 Tabla comparativa de modos

---

6. Demostración práctica

6.1 Escenario 1: Construir una REST API (Team Mode)

Supongamos que queremos construir una API REST de gestión de tareas:

/team 2:executor "Implementar REST API de gestión de tareas con CRUD, usando Express + TypeScript"

OMC desglosará la tarea automáticamente:

1. architect diseña la estructura de la API y modelos de datos.
2. executor implementa los endpoints en paralelo.
3. test-engineer escribe pruebas de integración.
4. code-reviewer revisa el código.
5. verifier ejecuta las pruebas para validar.

Solo tienes que esperar el resultado final.

6.2 Escenario 2: Autocorrección de errores (Ultrawork)

ulw corregir todos los errores de tipo TypeScript y advertencias de ESLint

Ideal para pipelines de CI/CD o limpiezas rápidas al heredar proyectos antiguos.

6.3 Escenario 3: Cuando los requisitos no están claros (Deep Interview)

Si no estás seguro de qué quieres hacer:

/deep-interview "Quiero hacer un sistema de blog personal"

Deep Interview usará preguntas socráticas para ayudarte a aclarar: público objetivo, stack tecnológico, necesidad de CMS, requisitos de SEO... Aclara todo antes de empezar para evitar retrabajo.

6.4 Escenario 4: Revisión cruzada de modelos (/ccg)

/ccg Revisar la arquitectura backend de este PR con Codex y los componentes UI con Gemini

6.5 Escenario 5: Recuperación automática de límites de tasa

Cuando la API de Claude activa un límite de tasa (rate limit):

omc wait          # Ver estado actual y guía de recuperación
omc wait --start  # Iniciar demonio de recuperación automática
omc wait --stop   # Detener el demonio

---

7. Solución de problemas comunes

Q1: El comando /team no funciona, error "Team Mode no habilitado"

Causa: La variable de entorno CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS no está configurada.

Solución:

# Editar ~/.claude/settings.json y añadir:
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Reinicia la sesión de Claude Code para que surta efecto.

---

Q2: omc team da error relacionado con tmux

Causa: El usuario de Windows no tiene instalado tmux, o tmux no está en el PATH.

Solución:

# Windows nativo
winget install psmux

# macOS
brew install tmux

# Validar instalación
tmux -V

Si está instalado pero sigue fallando, verifica que el directorio bin de psmux esté en el PATH del sistema.

---

Q3: Tras instalar vía Marketplace, los comandos OMC no funcionan

Causa: La caché del plugin no se ha refrescado o la ruta de instalación es incorrecta.

Solución:

# Actualizar clon de marketplace
/plugin marketplace update omc

# Re-inicializar
/setup

# Ejecutar diagnóstico
/omc-doctor

---

Q4: Claude Code indica límite de tasa pero no hay recuperación automática

Causa: No se ejecutó omc wait --start o no se está ejecutando dentro de una sesión tmux.

Solución:

# Asegúrate de estar en una sesión tmux
tmux new -s omc-watch
omc wait --start

El demonio correrá en segundo plano en tmux y reanudará automáticamente la sesión de Claude Code cuando se recupere el límite.

---

8. Lectura extendida / Direcciones avanzadas

8.1 Escritura de Skills personalizados

OMC permite extraer habilidades reutilizables de experiencias de depuración reales:

/learner

Esto genera archivos YAML en .omc/skills/. Se inyectarán automáticamente la próxima vez que surja un problema similar.

8.2 Integración con OpenClaw

OMC puede reenviar eventos de sesión a OpenClaw Gateway para activación y notificaciones remotas:

# Configuración guiada
/oh-my-claudecode:configure-notifications
# → Seleccionar "OpenClaw Gateway"

Configuración manual en ~/.claude/omc_config.openclaw.json.

8.3 Sistema de notificaciones (Telegram / Discord / Slack)

omc config-stop-callback telegram --enable --token <bot_token> --chat <chat_id> --tag-list "@alice,bob"

Envía automáticamente un resumen al grupo al finalizar la sesión.

8.4 Flujo de trabajo coordinado OpenClaw + OMC

Combinando ambos puedes lograr:

• OpenClaw escucha mensajes en Discord/Telegram e inicia una sesión de Claude Code.
• OMC orquesta 32 Agentes dentro de Claude Code para completar la tarea.
• OpenClaw Gateway devuelve los resultados al canal de chat.

Esto te da un asistente multi-agente online las 24 horas controlable desde tus apps de mensajería habituales.

8.5 Monitoreo de rendimiento y depuración

OMC genera varios archivos en .omc/ para seguimiento:

.omc/sessions/*.json        # Resúmenes de sesión
.omc/state/agent-replay-*.jsonl  # Logs de reproducción de ejecución
.omc/plans/                 # Planes de tareas

Ejecuta el HUD para ver el estado de orquestación en tiempo real:

/oh-my-claudecode:hud setup
omc hud

---

Enlaces de referencia

• Página principal: https://github.com/Yeachan-Heo/oh-my-claudecode
• Paquete npm: https://www.npmjs.com/package/oh-my-claude-sisyphus
• Documentación completa: https://yeachan-heo.github.io/oh-my-claudecode-website
• Comunidad Discord: https://discord.gg/PUwSMR9XNk