Cómo instalar ECC en Claude Code sin duplicar nada: plugin, npx, Windows y perfiles
Al final del artículo tienes el comando, el prompt listo para copiar y un .md para descargar.
Para instalar ECC en Claude Code ejecuta npx ecc-universal@2.2.3 setup, elige el alcance (usuario, proyecto o local) y el perfil de hooks, y confirma; también puedes usar los comandos nativos /plugin marketplace add https://github.com/affaan-m/ECC y /plugin install ecc@ecc. Elige un solo método: instalar ECC dos veces en el mismo agente duplica skills, comandos y hooks.
Esta es la parte 2 de la guía completa de ECC. Aquí tienes los tres caminos de instalación, cuál elegir, cómo instalar solo un perfil pequeño, cómo comprobar que todo quedó bien y cómo desinstalarlo sin dejar restos. Probamos el instalador de la v2.2.3 en un HOME vacío y anotamos lo que hizo de verdad.
Requisitos antes de empezar
- Node.js 18 o superior (el instalador es una CLI de Node).
- Git en el
PATH. - Claude Code 2.1 o superior (
claude --version). Nosotros usamos la 2.1.329.
En Windows abre PowerShell y comprueba los tres:
node --version
git --version
claude --versionSi alguno no aparece, instálalo antes de seguir. El instalador no los repara por ti.
Qué método elegir
| Método | Comando | Para quién |
|---|---|---|
| Asistente guiado (recomendado) | `npx ecc-universal@2.2.3 setup` | La mayoría: instala el plugin `ecc@ecc` y te deja elegir alcance y hooks |
| Plugin nativo | `/plugin install ecc@ecc` dentro de Claude Code | Quien prefiere no ejecutar npx |
| Instalador selectivo | `npx ecc-universal@2.2.3 install --profile minimal --target claude` | Quien quiere controlar qué archivos se copian y cuánto contexto ocupa |
| Varios agentes a la vez | `npx ecc-universal@2.2.3 install --guided` | Claude Code + Codex + Kimi Code en un solo paso |
La regla del README es tajante: no apiles métodos. Plugin + instalación manual completa en Claude Code es la combinación que más problemas da. Instalarlo una vez en Claude Code y otra en Codex sí está bien.
Opción 1: el asistente guiado (setup)
npx ecc-universal@2.2.3 setupEl asistente revisa primero qué hay instalado en cada alcance de Claude Code y luego instala, actualiza o mueve ecc@ecc al alcance que elijas. Para un uso personal típico:
- Elige Global user como alcance.
- Elige Standard como perfil de hooks.
- Confirma.
- Abre una sesión nueva de Claude Code y ejecuta
/plugin list: debe aparecerecc@eccactivado.
Vuelve a ejecutar el mismo comando cuando quieras actualizar ECC o cambiar el alcance. Con pnpm el equivalente es pnpm dlx ecc-universal@2.2.3 setup, y con Bun, bunx ecc-universal@2.2.3 setup.
Fija siempre la versión (@2.2.3). El propio README aclara que fijarla no es una auditoría: si te preocupa la cadena de suministro, revisa el código antes, igual que harías con cualquier skill que instalas.
Opción 2: los comandos nativos del plugin
Dentro de Claude Code:
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@eccEsto instala skills, agentes, comandos y hooks del plugin. Los comandos quedan con prefijo: /ecc:plan, /ecc:code-review, etc. Una vez instalado, /ecc:configure-ecc abre el mismo flujo de configuración que setup.
Lo que el plugin no puede instalar son las reglas: Claude Code no permite que un plugin las distribuya. Cópialas a mano, solo las que uses:
git clone https://github.com/affaan-m/ECC.git
cd ECC
mkdir -p ~/.claude/rules/ecc
cp -R rules/common ~/.claude/rules/ecc/
cp -R rules/typescript ~/.claude/rules/ecc/Cambia typescript por tu stack (python, golang, php, rust…). Copia la carpeta entera, no los archivos sueltos, para que las referencias internas sigan funcionando.
Opción 3: instalar solo un perfil (lo que probamos)
Si te importa el contexto, el instalador selectivo te deja elegir un perfil y ver antes qué va a copiar. Primero el ensayo sin escribir nada:
npx ecc-universal@2.2.3 install --profile minimal --target claude --dry-runEl perfil minimal pidió 5 módulos y el instalador resolvió 7 (añade skill-unified-memory y shared-script-utils como dependencias). Tras instalarlo de verdad en un HOME vacío, esto es lo que quedó en ~/.claude:
| Carpeta | Archivos | Tamaño |
|---|---|---|
| `agents/` | 72 | 624 KB |
| `commands/` | 99 | 604 KB |
| `skills/` | 113 | 1,5 MB |
| `rules/ecc/` | 122 | 664 KB |
Dos cosas que no esperábamos:
- Copia las reglas de todos los lenguajes (Angular, Rust, Swift, PHP…), pero 111 de los 122 archivos llevan
paths:en el frontmatter, así que Claude Code solo los carga cuando tocas un archivo de ese tipo. Las 11 que se cargan siempre son las comunes, unas 2.900 palabras. - Escribe
"includeCoAuthoredBy": falseen~/.claude/settings.json: desactiva la líneaCo-Authored-Byque Claude Code añade a tus commits. Lo hace a propósito (está enscripts/lib/claude-commit-attribution.js) y respeta tu elección si ya tenías ese ajuste. Si quieres conservar la atribución, ponlo entrueantes de instalar.
Para el perfil core sin hooks o para añadir los hooks después:
npx ecc-universal@2.2.3 install --profile core --no-hooks --target claude
npx ecc-universal@2.2.3 install --target claude --modules hooks-runtime --enable-hooksSi el perfil incluye hooks y no pasas ni --enable-hooks ni --no-hooks, el instalador explica qué pueden hacer los hooks y se detiene sin escribir nada. Es una buena barrera: los hooks ejecutan comandos en tu máquina.
Comprobar que quedó bien: list-installed y doctor
npx ecc-universal@2.2.3 list-installed
npx ecc-universal@2.2.3 doctordoctor compara el estado guardado con los archivos reales. Si borraste o cambiaste algo, repair lo restaura. Si se te reinició la configuración de Claude, el README recomienda este orden antes de reinstalar: list-installed, doctor, repair.
Errores frecuentes
"Missing dependency 'sql.js'". Nos salió al ejecutar el instalador desde el repositorio clonado sin npm install. Los archivos se copiaron y doctor dio OK, pero el paso final falló. Solución: npm install en la raíz del repositorio clonado, o usa npx ecc-universal, que ya trae las dependencias. El mismo error aparece si instalaste con el marketplace y luego ejecutas scripts de la CLI desde esa copia.
Skills o comandos duplicados. Instalaste con dos métodos. Desinstala en este orden: quita el plugin de Claude Code, ejecuta uninstall desde la carpeta donde instalaste, borra las carpetas de reglas que copiaste a mano y vuelve a instalar con un solo método.
Hooks que se ejecutan dos veces. Copiaste hooks/hooks.json del repositorio a tu settings.json teniendo el plugin. Claude Code 2.1+ ya carga los hooks del plugin solo; bórralos de settings.json.
Los comandos /multi-* no funcionan. Necesitan un runtime aparte (ccg-workflow) que ECC no incluye.
Windows nativo. El núcleo funciona, pero el observador del aprendizaje continuo v2 tiene errores abiertos en Windows. Si lo vas a usar a fondo, trabaja en WSL.
Desinstalar sin dejar restos
npx ecc-universal@2.2.3 uninstall --dry-run
npx ecc-universal@2.2.3 uninstallECC solo borra lo que tiene apuntado en su estado de instalación. En nuestra prueba el dry-run anunció 436 archivos a eliminar (los 435 copiados más el propio estado) y ningún archivo tuyo. Si usaste el plugin, quítalo desde Claude Code con /plugin y borra a mano las reglas que copiaste.
Preguntas frecuentes
¿Plugin o instalador selectivo? Plugin si quieres actualizar con un comando y no te preocupa el contexto. Selectivo con minimal o developer si quieres saber exactamente qué cargas.
¿Se puede instalar solo en un proyecto? Sí: en el asistente elige el alcance de proyecto, o con el instalador usa el destino claude-project, que copia las skills en .claude/skills/ del repositorio.
¿Funciona con Codex a la vez? Sí. npx ecc-universal@2.2.3 install --guided te deja marcar Claude Code, Codex y Kimi Code, revisa cada destino antes de escribir y pide una confirmación final.
Conclusión
Instalar ECC bien son tres decisiones: un solo método, un perfil pequeño y reglas solo de tu stack. Antes de nada ejecuta el dry-run y, al terminar, doctor. Con ECC instalado, el siguiente paso es usarlo de verdad: la parte 3 recorre el flujo plan, TDD, code review y build-fix en un proyecto de ejemplo.
// recurso · úsalo directamente
ECC instalado y comprobado en Claude Code
Elige un solo método de instalación, ejecútalo y comprueba el resultado con `doctor`. Funciona con Claude Code 2.1 o superior, Node.js 18+ y Git.
Licencia del repositorio: MIT
1. Instala
npx ecc-universal@2.2.3 setupnpx ecc-universal@2.2.3 install --profile minimal --target claude --dry-run
npx ecc-universal@2.2.3 install --profile minimal --target claude
npx ecc-universal@2.2.3 doctor2. Elige tu caso
Acabo de instalar ECC (plugin ecc@ecc) en Claude Code. Antes de usarlo en este proyecto nuevo:
1. Ejecuta /plugin list y confirma que ecc@ecc está activo y que no hay otra copia de ECC instalada a mano en ~/.claude.
2. Dime qué stack usa este proyecto (lenguaje y framework) y qué carpeta de rules/ de ECC le corresponde. Copia solo rules/common y esa carpeta a .claude/rules/ecc/ del proyecto.
3. Crea un CLAUDE.md corto con: comando de tests, comando de build, convención de commits y la regla "usa /ecc:plan antes de cualquier funcionalidad nueva".
4. No instales más skills ni MCP. Enséñame el árbol de .claude/ al terminar.3. Guía de uso
- Pega el prompt como primer mensaje en la carpeta del proyecto.
- Revisa qué reglas copió: solo deben estar
commony las de tu lenguaje. - Empieza a trabajar con
/ecc:plan "lo que quieres construir".
Este proyecto ya tiene CLAUDE.md, skills propias y quizá MCPs. Quiero añadir ECC sin romper nada ni duplicar instrucciones.
1. Lista lo que ya hay en .claude/ (skills, agents, commands, rules, hooks en settings.json) y en ~/.claude/.
2. Ejecuta `npx ecc-universal@2.2.3 consult "<describe el stack y lo que hacemos>" --target claude` y propón el perfil y los componentes mínimos.
3. Señala conflictos: skills con el mismo nombre, hooks que se ejecutarían dos veces, reglas que contradicen nuestro CLAUDE.md.
4. Enséñame el comando de instalación con --dry-run y espera mi OK antes de instalar.
5. Tras instalar, ejecuta doctor y dime si includeCoAuthoredBy cambió en settings.json.3. Guía de uso
- Lanza el prompt en la raíz del repositorio.
- Lee la lista de conflictos antes de aprobar nada.
- Instala con el dry-run aprobado y guarda el resultado de
doctoren el PR.
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