⏱️ Lectura: 15 min
Cuando comenzás a trabajar en serio con Claude Code, Codex o Cursor, rápidamente descubrís que el problema no es el modelo: es el harness. Los prompts se inflan, la memoria se pierde entre sesiones, los hooks se rompen silenciosamente y cada nuevo proyecto termina siendo un ejercicio de copiar y pegar configuración que funcionó la semana pasada. everything-claude-code (abreviado ECC) nace precisamente de ese dolor: es una colección curada de agentes, skills, hooks, reglas y comandos, construida durante más de diez meses de uso intensivo diario por un ganador del hackathon de Anthropic, y publicada bajo licencia MIT.
📑 En este artículo
En este tutorial vamos a instalarlo paso a paso en Windows, macOS y Linux, entender qué ofrece realmente, ver cómo integrarlo en proyectos reales y analizar honestamente cuándo tiene sentido adoptarlo y cuándo no. Si venís siguiendo el canal, ya cubrimos Superpowers y Skill Seekers; ECC juega en la misma liga, pero apunta a algo más ambicioso: convertirse en el sistema operativo de tu harness de agentes.
Introducción: el problema del harness sin disciplina
Un harness de agente IA es todo lo que rodea al modelo: el prompt del sistema, las herramientas expuestas, los hooks que disparan antes y después de cada acción, la memoria persistente, las reglas de estilo, los subagentes y las políticas de seguridad. Claude Code, Codex, Cursor y OpenCode son harnesses distintos, pero todos sufren los mismos problemas cuando se usan sin un sistema encima: consumo de tokens descontrolado, pérdida de contexto al cambiar de sesión, alucinaciones repetidas porque el agente nunca aprende de sus errores, y vulnerabilidades de seguridad cuando el modelo ejecuta comandos sin supervisión.
La respuesta habitual del ecosistema ha sido publicar dotfiles personales en GitHub: «así configuro yo mi Claude Code». Útil, pero fragmentado. ECC va un paso más allá: en lugar de compartir una configuración, empaqueta un sistema de rendimiento completo con 38 agentes especializados, 156 skills reutilizables, 72 comandos legacy, hooks de memoria persistente, reglas multi-lenguaje y un escáner de seguridad llamado AgentShield que corre como parte del flujo. Todo eso bajo un solo instalador.
El proyecto tiene licencia MIT, topics oficiales ai-agents, anthropic, claude-code, developer-tools, llm, mcp y productivity, y está escrito principalmente en JavaScript con componentes en Shell, TypeScript, Python, Go, Java y Perl. La versión 1.10.0 trae un dashboard GUI en Tkinter, expansión de workflows operativos y la alpha de ECC 2.0, un prototipo de plano de control en Rust.
Qué es everything-claude-code
ECC no es una librería que importás en tu código. Es un conjunto de archivos de configuración, scripts y definiciones declarativas que se instalan en tu directorio ~/.claude/ (o equivalente en cada harness) y que Claude Code consume automáticamente cuando arranca una sesión. La distribución oficial se llama ecc-universal en npm, mientras que el paquete de seguridad se llama ecc-agentshield.
Los componentes principales son los siguientes. Agentes: 38 subagentes con descripciones específicas, cada uno pensado para una tarea concreta (revisión de TypeScript, resolución de builds de PyTorch, auditoría de arquitectura, etc.). Cuando Claude Code detecta que la tarea coincide con la descripción del agente, lo invoca delegando el trabajo. Skills: 156 habilidades que son, en esencia, prompts especializados con instrucciones y ejemplos. Se activan por nombre o por triggers definidos en su frontmatter. Hooks: scripts que se ejecutan en eventos del ciclo de vida de la sesión: SessionStart, Stop, PreToolUse, PostToolUse. Sirven para cargar memoria, guardar resúmenes, bloquear comandos peligrosos o loguear métricas. Reglas: archivos por lenguaje (TypeScript, Python, Go, Java, Kotlin, Swift, Rust, C++, PHP, Perl) con convenciones de estilo, patrones y antipatrones que el agente debe respetar. Comandos: 72 comandos legacy estilo /harness-audit, /quality-gate, /model-route, /pm2, /multi-plan que automatizan flujos complejos.
La filosofía detrás del sistema es lo que sus autores llaman research-first development: antes de escribir código, el agente investiga, valida supuestos y registra lo aprendido como una nueva skill o instinct. Los instincts son reglas de aprendizaje continuo con puntuación de confianza; cada vez que un patrón se confirma, su confianza sube, y cuando un patrón falla, se degrada o se descarta. Es una forma primitiva pero efectiva de memoria procedural.
Instalación multi-OS
ECC soporta dos caminos de instalación: el plugin oficial de Claude Code (más rápido) y el instalador OSS vía git (más confiable cuando el marketplace tiene problemas). Veamos ambos y cubramos las particularidades de cada sistema operativo.
Instalación vía plugin de Claude Code (todas las plataformas)
Este es el método recomendado si tu versión de Claude Code resuelve correctamente los marketplaces autohospedados. Abrís la sesión y ejecutás los siguientes comandos dentro del propio Claude Code:
/plugin marketplace add https://github.com/affaan-m/everything-claude-code
/plugin install everything-claude-code@everything-claude-codeEl identificador everything-claude-code@everything-claude-code no es un error tipográfico: Anthropic indexa los plugins por un identificador canónico y ECC decidió alinear el nombre del listado, el comando de instalación y la documentación del repo a una sola superficie pública. El paquete de npm, en cambio, sigue llamándose ecc-universal por razones históricas.
Instalación OSS en Linux
Si preferís clonar el repo y correr el instalador (o si el plugin tiene problemas), en Linux los pasos son directos. Asumimos bash y git instalados:
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
npm install
./install.sh --profile fullEl flag --profile full instala todo. Si querés afinar por lenguaje, podés pasar los que uses:
./install.sh typescript python golangPara Cursor u OpenCode como harness alternativo, agregá --target cursor o --target opencode. Terminada la instalación, reiniciá tu harness y verificá con ecc doctor.
Instalación OSS en macOS
En macOS los pasos son idénticos a Linux, siempre que tengas Command Line Tools de Xcode y Node.js 18 o superior. Si usás Homebrew:
brew install node git
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
npm install
./install.sh --profile fullUn detalle particular de macOS: si tenés protección de integridad activada y Claude Code corre en modo sandbox, algunos hooks pueden necesitar permisos explícitos de Full Disk Access desde Preferencias del Sistema > Privacidad y Seguridad. Esto es especialmente relevante para los hooks de memory-load y memory-save, que escriben archivos fuera del directorio del proyecto.
Instalación OSS en Windows
Windows es el caso más delicado porque install.sh es un script bash. Tenés tres opciones. La primera, usar WSL2 (recomendada): activás la característica desde PowerShell como administrador y luego instalás desde Ubuntu exactamente como en Linux:
wsl --install -d UbuntuUna vez dentro de WSL:
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code
npm install
./install.sh --profile fullLa segunda opción es usar el instalador de PowerShell nativo que la comunidad contribuyó en la versión 1.9.0. Desde PowerShell:
git clone https://github.com/affaan-m/everything-claude-code.git
Set-Location everything-claude-code
npm install
powershell -ExecutionPolicy Bypass -File .\install.ps1 -Profile fullLa tercera alternativa, la más simple, es ir directo al plugin vía /plugin install y saltarse el instalador local. Para la mayoría de usuarios de Windows que solo quieren Claude Code funcionando con skills y agentes, esto alcanza.
Verificá en cualquier plataforma con:
ecc list-installed
ecc doctorEl comando doctor chequea que los hooks estén activos, que el catálogo esté sincronizado y que los permisos de archivos sean correctos. Si algo falla, ecc repair intenta restaurar archivos gestionados por ECC sin tocar tu configuración personal.
Uso básico: primer ejemplo funcional
Una vez instalado, la forma más rápida de validar que todo está operativo es ejecutar la auditoría del harness. Desde una sesión de Claude Code, tipeá:
/harness-auditEsto corre un análisis determinista que puntúa tu configuración actual: qué agentes están cargados, qué hooks están activos, si hay conflictos entre skills, y qué optimizaciones de tokens podrías aplicar. El resultado es un reporte con puntaje numérico y recomendaciones concretas.
A nivel de configuración, la recomendación oficial para reducir costos sin sacrificar calidad es editar ~/.claude/settings.json con estos valores:
{
"model": "sonnet",
"env": {
"MAX_THINKING_TOKENS": "10000",
"CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
}
}El cambio de Opus a Sonnet reduce aproximadamente 60% del costo y cubre más del 80% de tareas de código. Bajar MAX_THINKING_TOKENS de 31999 a 10000 recorta alrededor del 70% del costo oculto de razonamiento por request. Y forzar la autocompactación al 50% en vez del 95% mejora la calidad en sesiones largas porque evita que el agente trabaje con un contexto degradado por saturación.
Para cambiar de modelo dentro de una sesión cuando necesitás razonamiento profundo:
/model opusY para volver al modelo económico cuando terminás la parte arquitectónica:
/model sonnetUn primer ejemplo funcional real: supongamos que querés que Claude Code audite un repositorio TypeScript antes de hacer cambios. Con ECC instalado, el agente typescript-reviewer se invoca automáticamente cuando detectás archivos .ts y pedís una revisión. También podés forzarlo desde el prompt: revisá este archivo usando el agente typescript-reviewer. El agente aplicará las reglas definidas en rules/typescript/, reportará issues con severidad y sugerirá cambios concretos sin tocar el código sin permiso.
Integración en proyectos reales
Donde ECC realmente brilla es en proyectos de larga duración, donde la memoria persistente y los patrones repetidos de trabajo justifican la capa de configuración. Veamos dos patrones comunes.
Patrón 1: memoria persistente entre sesiones. ECC incluye hooks de SessionStart y Stop que leen y escriben automáticamente un archivo de memoria por proyecto. Al abrir una sesión en un repo ya conocido, el hook carga el resumen de la sesión anterior: qué se estaba trabajando, qué decisiones se tomaron, qué tareas quedaron pendientes. Al cerrar, otro hook extrae el diff de la sesión y lo guarda junto a las lecciones aprendidas. Esto elimina el típico «recordame en qué estábamos» al inicio de cada día. La skill strategic-compact complementa esto sugiriendo cuándo hacer /compact en puntos naturales del trabajo, en vez de esperar a que el harness compacte automáticamente al 95% y degrade la calidad.
Patrón 2: orquestación multi-agente con PM2. Los comandos /multi-plan, /multi-execute, /multi-backend, /multi-frontend y /multi-workflow permiten coordinar varios procesos de Claude Code trabajando en paralelo sobre worktrees de git. Un caso típico: mientras un agente implementa el backend en una rama, otro adapta el frontend en otra rama, y un tercero corre tests de integración en una tercera. El comando /pm2 gestiona los procesos con el supervisor PM2 para que no mueras si uno de los agentes se cuelga. Esto es la cascada que la guía de ECC describe: escalar horizontalmente en vez de vertical cuando la tarea admite paralelismo real.
Un tercer patrón que merece mención es la integración con AgentShield. Con el comando /security-scan podés lanzar el escáner directamente dentro de la sesión; el escáner trae 102 reglas que detectan patrones peligrosos en código generado por IA: credenciales hardcodeadas, inyección de comandos, uso inseguro de eval, etc. Integrarlo como quality gate vía /quality-gate hace que el agente no pueda commitear sin pasar la auditoría de seguridad primero.
Cuándo usarlo y cuándo no
Voy a ser honesto con los trade-offs, porque ECC no es una bala de plata y adoptarlo tiene costo real.
Cuándo adoptarlo. Tiene sentido si trabajás con Claude Code varias horas al día, si tu factura mensual de tokens justifica invertir tiempo en optimización, si manejás varios proyectos en paralelo y la memoria persistente te ahorra reonboarding diario, si tu equipo comparte convenciones de código que podés codificar como reglas por lenguaje, y si estás dispuesto a leer las guías Shorthand y Longform del autor para entender qué hace cada pieza. También es una buena opción si querés uniformidad entre Claude Code, Codex, Cursor y OpenCode, porque ECC apunta explícitamente a paridad cross-harness.
Cuándo no adoptarlo. Si apenas estás empezando con Claude Code, ECC va a ser ruido: demasiadas piezas, demasiados comandos, demasiadas skills que no vas a usar. Es mejor arrancar con la configuración por defecto, identificar tus propios puntos de dolor, y recién entonces traer piezas específicas. Tampoco tiene sentido si tus tareas son muy puntuales y no justifican hooks persistentes: los hooks tienen costo de ejecución y añaden complejidad al debugging. Si trabajás en entornos corporativos con restricciones fuertes sobre qué scripts pueden correr en tu máquina, los hooks de ECC pueden chocar con políticas de seguridad internas y habría que auditar cada uno antes de habilitarlos. Finalmente, si no usás subagentes, las 38 definiciones de agentes van a consumir espacio en tu contexto sin aportar valor.
La curva de aprendizaje también importa. ECC tiene 38 agentes, 156 skills y 72 comandos: nadie memoriza todo eso. En la práctica vas a usar quince o veinte piezas recurrentes y el resto se activará automáticamente por triggers. Pero hasta que llegás a ese estado de confort, conviene leer las guías oficiales y resistir la tentación de instalar todo con --profile full si solo vas a trabajar en un lenguaje.
Alternativas
El ecosistema de configuración para agentes IA está creciendo rápido y ECC no es la única opción. Tres alternativas notables merecen mención.
Superpowers es una metodología más reciente que apunta a disciplinar agentes mediante un conjunto menor pero más opinionado de reglas y patrones. A diferencia de ECC, Superpowers no intenta abarcar tantos harnesses ni tantos lenguajes; su foco está en el flujo de trabajo disciplinado y la trazabilidad de decisiones. Si lo tuyo es calidad antes que cantidad de herramientas, vale la pena compararlo.
Skill Seekers resuelve un problema adyacente: convertir documentación, repos y PDFs en skills reutilizables para Claude. No compite directamente con ECC sino que lo complementa, pero si lo único que necesitás es generar skills personalizadas sin tragar todo el sistema, Skill Seekers es mucho más liviano.
Cursor Rules y dotfiles personales siguen siendo la opción más usada en la práctica. Un archivo .cursorrules o CLAUDE.md bien curado cubre el 80% de los casos para un desarrollador individual. Si no necesitás hooks, subagentes ni memoria persistente compleja, esta ruta minimalista es perfectamente válida y no tiene las dependencias de npm ni los scripts de instalación.
La elección depende del rol que juega el harness en tu flujo. Para uso casual: dotfiles. Para uso intermedio con skills personalizadas: Skill Seekers. Para uso profesional diario con énfasis en disciplina: Superpowers. Para una plataforma completa cross-harness con agentes, hooks, seguridad y memoria: ECC.
Conclusión
everything-claude-code es el sistema de optimización más completo que existe hoy para harnesses de agentes IA. Con 38 agentes, 156 skills, 72 comandos, hooks de memoria, reglas multi-lenguaje y un escáner de seguridad integrado, resuelve problemas reales que aparecen cuando Claude Code deja de ser un experimento y se vuelve parte del flujo diario de trabajo. La contrapartida es la curva de aprendizaje: hay que leer las guías, entender la filosofía research-first, y resistir la tentación de instalar todo sin criterio.
Si venís sufriendo tokens descontrolados, sesiones que empiezan desde cero cada día, agentes que repiten los mismos errores y hooks frágiles que se rompen a la primera, ECC ofrece una respuesta integral. Si apenas estás empezando o tu uso es esporádico, probablemente te convenga quedarte con configuraciones más simples y adoptar ECC más adelante, cuando el dolor justifique el costo de adopción.
El proyecto es open source bajo licencia MIT y está en desarrollo activo; la versión 1.10.0 introdujo un dashboard GUI y el alpha de ECC 2.0 en Rust como plano de control, lo que sugiere que el roadmap apunta a una plataforma aún más robusta en los próximos meses. Podés explorar el código, reportar issues y contribuir en el Repositorio oficial en GitHub.
Referencias
- affaan-m/everything-claude-code en GitHub
- Sitio oficial de ECC Tools
- Paquete ecc-universal en npm
- Paquete ecc-agentshield en npm
- ECC Tools en GitHub Marketplace
- Changelog completo en Releases
📱 ¿Te gusta este contenido? Únete a nuestro canal de Telegram @programacion donde publicamos a diario lo más relevante de tecnología, IA y desarrollo. Resúmenes rápidos, contenido fresco todos los días.
0 Comentarios