ECC para Claude Code: qué es, qué trae y si te conviene (guía completa)
ECC (affaan-m/ECC) es un paquete open source con licencia MIT que convierte a Claude Code, Codex, Cursor y otros agentes de programación en un equipo con método: trae 72 subagentes, 328 skills, 99 comandos, reglas por lenguaje, hooks de memoria y el escáner de seguridad AgentShield. Se instala como plugin ecc@ecc y su flujo base es planificar, testear, implementar, revisar, verificar y recordar.
Esta es la primera parte de una guía de ocho. Aquí verás qué hay dentro del repositorio, cómo se reparte, qué perfiles de instalación existen y para quién merece la pena. Las siguientes partes bajan a cada pieza con comandos probados.
Qué es ECC y de dónde sale
ECC empezó como la configuración personal de Claude Code de su autor, Affaan Mustafa, y hoy se presenta como un "sistema operativo de harness para agentes". En la práctica es un repositorio con tres caras públicas que conviene no confundir:
| Identificador | Qué es |
|---|---|
| `affaan-m/ECC` | El repositorio de GitHub (código fuente, MIT) |
| `ecc@ecc` | El plugin para el marketplace de Claude Code |
| `ecc-universal` | El paquete de npm con el instalador guiado y la CLI `ecc` |
Probamos la v2.2.3 (commit 4adeee6, 19 de noviembre de 2026) clonando el repositorio y ejecutando su CLI en un entorno limpio. La licencia es MIT, Copyright (c) 2026 Affaan Mustafa, así que puedes usarlo en proyectos comerciales y modificarlo.
El autor también ofrece ECC Pro, una GitHub App de pago para repositorios privados. Todo lo que cuenta esta guía es la parte gratuita del repositorio.
Qué trae dentro: el inventario real
Contamos las carpetas del commit probado:
| Carpeta | Cantidad | Para qué sirve |
|---|---|---|
| `agents/` | 72 subagentes | Planificar, revisar código por lenguaje, arreglar builds, seguridad, arquitectura |
| `skills/` | 328 skills | TDD, investigación, seguridad, frontend, datos, ML, contenido, operaciones |
| `commands/` | 99 comandos | Atajos como `/plan`, `/code-review`, `/build-fix`, `/save-session` |
| `rules/` | 122 archivos | Normas que se cargan siempre (comunes) o por tipo de archivo (TypeScript, Python, Go…) |
| `hooks/` | `hooks.json` + scripts | Automatismos al iniciar o cerrar sesión, antes de compactar, al editar archivos |
| `mcp-configs/` | 1 conector por defecto | Solo `chrome-devtools`; el resto son skills que envuelven CLIs o APIs |
Además hay adaptadores para otros entornos (.codex/, .opencode/, .cursor/), un panel de escritorio en Python (ecc_dashboard.py), tres guías largas en Markdown (la corta, la larga y la de seguridad) y una carpeta examples/ con CLAUDE.md reales para un SaaS en Next.js, un microservicio en Go, una API en Django, otra en Laravel y otra en Rust.
De los 72 agentes, 62 usan el modelo sonnet, 6 haiku y solo 4 opus (lo leímos en el frontmatter de cada archivo). Es una decisión de coste deliberada: el modelo caro se reserva para planificar y diseñar arquitectura.
El flujo que propone: de la idea a la memoria
El README lo resume en una línea: plan -> test -> implement -> review -> verify -> remember -> improve. Cada paso tiene su pieza:
- Planificar con
/ecc:plan: el agente reformula lo que pides, busca patrones en tu código, divide el trabajo en fases y espera tu confirmación antes de tocar nada. - Testear primero con la skill
tdd-workflowy el agentetdd-guide: test que falla, código mínimo, refactor. - Revisar con
/code-review: un revisor con contexto limpio, que no es el mismo que escribió el código. - Verificar con
/quality-gate,e2e-testingo/build-fixsi algo no compila. - Recordar con
/save-session,/resume-sessiony el aprendizaje continuo, que convierte patrones repetidos en "instincts" y luego en skills.
La parte 3 de esta guía recorre este flujo con un proyecto de ejemplo. Si vienes de otros paquetes de skills, la idea se parece a Superpowers, pero ECC es mucho más grande y añade hooks, reglas y una CLI propia.
Perfiles de instalación: no tienes que instalarlo todo
El error más caro con ECC es instalar las 328 skills y los 72 agentes sin pensar: el catálogo se anuncia al modelo y ocupa contexto. Por eso el instalador trae siete perfiles:
| Perfil | Módulos | Cuándo elegirlo |
|---|---|---|
| `minimal` | 5 | Quieres reglas, agentes y comandos, sin hooks |
| `core` | 6 | Lo mínimo más los hooks |
| `developer` | 9 | El perfil por defecto para trabajar en aplicaciones |
| `security` | 7 | Proyectos donde la revisión de seguridad manda |
| `research` | 9 | Investigación, síntesis y publicación de contenido |
| `full` | 36 | Todo el catálogo; solo si sabes lo que haces |
Y si no sabes qué necesitas, ecc consult "lo que haces" te recomienda componentes en lenguaje natural. Lo probamos en la parte 4 sobre los agentes, con un resultado que conviene revisar a mano.
Con qué agentes funciona
ECC funciona mejor con Claude Code, que es su objetivo principal y el único marcado como "estable". El README publica una tabla de compatibilidad honesta:
| Entorno | Estado |
|---|---|
| Claude Code | Estable (plugin o instalador selectivo) |
| Codex | Plugin nativo soportado |
| Qoder | Plugin nativo soportado |
| Cursor, OpenCode, Copilot CLI | Beta |
| GitHub Copilot Chat | Solo instrucciones, sin hooks |
| Gemini, Zed, Qwen, Kimi y otros | Experimental |
En Windows nativo funciona el núcleo, pero el aprendizaje continuo v2 tiene errores abiertos; con WSL sigue las rutas de Linux.
Para quién merece la pena (y para quién no)
Te conviene si:
- Ya usas Claude Code a diario y quieres un método repetible (planificar, testear, revisar) sin escribirlo tú en cada prompt.
- Trabajas con varios lenguajes: hay revisores y "build resolvers" para TypeScript, Python, Go, Rust, Java, Kotlin, C++, Swift, PHP, Ruby, Dart y más.
- Te preocupa la seguridad de tu propia configuración de agentes (hooks, MCP, permisos): AgentShield la audita.
No te conviene si:
- Estás empezando con Claude Code. Primero aprende qué son las skills y cómo se instalan; ECC tiene tantas piezas que te costará saber qué hace cada una.
- Ya tienes otro paquete grande de skills instalado. Mezclar dos métodos completos (por ejemplo ECC y Superpowers) duplica instrucciones y confunde al agente.
- Tu presupuesto de tokens es justo y no vas a podar el catálogo. Empieza por
minimaly añade lo que eches de menos.
Las 8 partes de esta guía
- Qué es ECC y qué trae (este artículo).
- Instalar ECC en Claude Code sin duplicar nada: plugin, npx, Windows, perfiles, doctor y desinstalar.
- El flujo diario con ECC: plan, TDD, code review y build-fix.
- Los 72 agentes de ECC: cuáles usar y cuándo.
- Skills y reglas: instalar solo lo que necesitas.
- Hooks, memoria y aprendizaje continuo.
- Ahorrar tokens y contexto con ECC.
- Seguridad de tus agentes con AgentShield.
Preguntas frecuentes
¿ECC es gratis? Sí. El repositorio y el paquete ecc-universal son MIT. Lo único de pago es ECC Pro, la GitHub App para repositorios privados.
¿Es lo mismo que "Everything Claude Code"? Es el mismo proyecto. Algunos artículos antiguos usan el identificador largo del marketplace; hoy el plugin se llama ecc@ecc y el autor trata el nombre viejo como alias heredado.
¿Necesito Node.js? Para el instalador guiado sí: Node.js 18 o superior, Git y Claude Code 2.1 o superior en el PATH.
¿Dónde lo instalo de forma segura? Solo desde las fuentes oficiales que lista el README: el repositorio affaan-m/ECC, los paquetes de npm ecc-universal y ecc-agentshield, el plugin ecc@ecc y la web ecc.tools. El propio autor avisa de copias de terceros con malware.
Conclusión
ECC es el paquete más completo que hemos visto para darle método a un agente de programación, y también el que más fácil es de instalar mal. Quédate con tres ideas: elige un perfil pequeño, no mezcles métodos de instalación y usa /ecc:plan antes de pedir código. El siguiente paso es la parte 2: instalar ECC sin duplicar nada.
// código fuente
Nos ayuda a crecer
codigoagente es gratis y sin muros de pago. Si este artículo te sirvió, cualquiera de estas cosas mantiene el blog en marcha.
- Compártelo con alguien a quien le sirvaWhatsAppLinkedInXFacebook
- Llévate el kit para agenciasVer qué incluyeComprar
- Conoce a nuestro patrocinadorSafe Build Labs
Más sobre Agentes de IA

- Skills para tus agentes
- Claude Code

guía · Guía de psicología para marketing con agentes de IA · #3
- Skills para tus agentes
- Claude Code

guía · Guía de psicología para marketing con agentes de IA · #2
- Skills para tus agentes
- Claude Code