~/codigoagente
Agentes de IA

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:

terminalsh
node --version
git --version
claude --version

Si alguno no aparece, instálalo antes de seguir. El instalador no los repara por ti.

Qué método elegir

MétodoComandoPara 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 CodeQuien 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)

terminalsh
npx ecc-universal@2.2.3 setup

El 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:

  1. Elige Global user como alcance.
  2. Elige Standard como perfil de hooks.
  3. Confirma.
  4. Abre una sesión nueva de Claude Code y ejecuta /plugin list: debe aparecer ecc@ecc activado.

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:

snippettext
/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

Esto 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:

terminalsh
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:

terminalsh
npx ecc-universal@2.2.3 install --profile minimal --target claude --dry-run
El dry-run del perfil minimal: 435 archivos a copiar, nada escrito todavía · codigoagente

El 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:

CarpetaArchivosTamaño
`agents/`72624 KB
`commands/`99604 KB
`skills/`1131,5 MB
`rules/ecc/`122664 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": false en ~/.claude/settings.json: desactiva la línea Co-Authored-By que Claude Code añade a tus commits. Lo hace a propósito (está en scripts/lib/claude-commit-attribution.js) y respeta tu elección si ya tenías ese ajuste. Si quieres conservar la atribución, ponlo en true antes de instalar.

Para el perfil core sin hooks o para añadir los hooks después:

terminalsh
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-hooks

Si 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

terminalsh
npx ecc-universal@2.2.3 list-installed
npx ecc-universal@2.2.3 doctor
ECC guarda qué instaló en ~/.claude/ecc/install-state.json y doctor lo compara con el disco · codigoagente

doctor 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

terminalsh
npx ecc-universal@2.2.3 uninstall --dry-run
npx ecc-universal@2.2.3 uninstall

ECC 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

Asistente guiado (recomendado)
npx ecc-universal@2.2.3 setup
Solo el perfil minimal, sin hooks
npx 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 doctor

2. Elige tu caso

Pega este prompt en tu agente
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

  1. Pega el prompt como primer mensaje en la carpeta del proyecto.
  2. Revisa qué reglas copió: solo deben estar common y las de tu lenguaje.
  3. Empieza a trabajar con /ecc:plan "lo que quieres construir".
Prompt y guía corta en un archivoRepositorioaffaan-m/ECC

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.

// newsletter

Un correo a la semana con los repos que valen la pena

Los artículos nuevos de la semana, probados con código real. Sin spam; te das de baja con un clic.

rea-video es una skill Apache-2.0 que desmonta un vídeo plano a plano: si es real, IA o código, voz, música, subtítulos y cómo rehacerlo. Prueba real y costos.
  • Skills para tus agentes
  • Claude Code
leer artículo
Agentes de IA

guía · Guía de psicología para marketing con agentes de IA · #3

Parte 3 de la guía: anclaje, decoy, paradoja de la elección, Hick's Law y activation energy aplicados a la página de precios, con ejemplos reales.
  • Skills para tus agentes
  • Claude Code
leer artículo
Agentes de IA

guía · Guía de psicología para marketing con agentes de IA · #2

Parte 2 de la guía: autoridad, compromiso, escasez real y framing con la skill marketing-psychology, con fragmentos reales reescritos del blog codigoagente.
  • Skills para tus agentes
  • Claude Code
leer artículo