Qué es oh-my-claudecode
oh-my-claudecode (OMC) es una capa de orquestación multi-agente para Claude Code. Convierte tu CLI en un sistema donde agentes especializados (explorer, executor, architect, verifier...) colaboran para completar tareas complejas.
No es un fork de Claude Code — es un plugin que se activa automáticamente a través del sistema de hooks.
Requisitos previos
Antes de instalar OMC necesitas:
- Node.js 18+ instalado
- Claude Code CLI funcionando (si no lo tienes, ve a la guía Tu primer proyecto con Claude Code)
- Git inicializado en tu proyecto
Verifica con:
node --version # v18+ requerido
claude --version # Claude Code CLI
git --version
Instalación
Desde la raíz de tu proyecto:
npx oh-my-claudecode install
Esto crea la estructura en ~/.claude/:
~/.claude/
├── CLAUDE.md # Instrucciones globales (OMC las gestiona)
├── hooks/ # Hooks que OMC registra
├── .omc-config.json # Configuración de OMC
└── commands/ # Skills personalizados
Si ya tenías un CLAUDE.md, OMC añade su bloque entre marcadores <!-- OMC:START --> y <!-- OMC:END --> sin tocar tu contenido.
Verificar la instalación
Abre una sesión de Claude Code en cualquier proyecto:
claude
Deberías ver en los mensajes del sistema que OMC se ha cargado. Prueba con un skill básico:
/oh-my-claudecode:omc-help
Si ves el menú de ayuda de OMC, la instalación está completa.
Tus primeros skills
Los skills más útiles para empezar:
| Skill | Qué hace | Cuándo usarlo |
|---|---|---|
/autopilot "tarea" | Pipeline completo: explore → plan → execute → verify | Features nuevas |
/ralph "tarea" | Loop persistente que no para hasta que los tests pasan | Tareas que necesitan perfección |
/plan "tarea" | Planificación con Planner + Architect + Critic | Antes de cambios grandes |
Ejemplo real:
/autopilot "añadir sistema de notificaciones por email con Resend"
OMC lanza los agentes en secuencia: explora tu codebase, diseña la implementación, escribe el código y verifica que funciona.
Model routing: controla el coste
OMC enruta tareas a modelos por complejidad:
- Haiku → búsquedas rápidas, exploración (
exploreagent) - Sonnet → implementación, debugging, tests (
executor,verifier) - Opus → arquitectura, análisis profundo (
architect,analyst)
Puedes forzar el modelo en cualquier delegación:
Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="...")
Esto mantiene el coste bajo sin sacrificar calidad donde importa.
Siguiente paso
Ya tienes OMC funcionando. Los patrones más útiles para profundizar:
- Patrones de orquestación de agentes — explore → plan → execute → verify y cuándo usar cada agente
- CLAUDE.md: la guía definitiva — cómo configurar el contexto persistente que hace a OMC más efectivo
- De idea a deploy — el flujo completo de trabajo con Claude Code + OMC
¿Necesitas ayuda implementando esto?
Agenda una llamada gratuita de 15 minutos y te ayudo con tu caso concreto.
Agendar llamada