Instalar Claude Mods en Claude Code: guía segura

Para instalar claude mods en Claude Code necesitas la versión 2.1.287 o posterior, añadir el repositorio que actúa como marketplace y ejecutar claude plugin install con el formato <mod>@<marketplace>. El paso crítico no es el comando: es validar antes qué permisos pide el mod, porque se ejecuta con tus permisos dentro de Claude Code.

Cómo instalar claude mods en Claude Code paso a paso

Claude Mods se instala como un plugin de Claude Code desde un marketplace publicado normalmente en GitHub. Según Claude Mods, no hay que activar ninguna opción adicional: en Claude Code 2.1.287 o posterior los mods cargan por defecto.

Antes de instalar nada, comprueba tu versión. Si trabajas con Claude Code a diario, este paso evita perder tiempo depurando un mod que nunca iba a cargar.

claude --version

La instalación típica tiene dos comandos. El primero añade el marketplace; el segundo instala el mod concreto desde ese marketplace. Claude Mods muestra estos comandos en cada ficha, porque el nombre del marketplace después de la arroba puede no coincidir con el nombre del mod.

claude plugin marketplace add <owner>/<repo>
claude plugin install <mod>@<marketplace>

Dentro de una sesión abierta de Claude Code, el segundo paso se puede hacer con el comando slash equivalente:

/plugin install <mod>@<marketplace>

Si instalas desde la shell mientras ya tenías una sesión abierta, Claude Mods y Anthropic indican que debes recargar los plugins en esa sesión:

/reload-plugins

Después, ejecuta /plugin. Según Claude Mods, bajo las pestañas aparece una línea tenue con los mods cargados en esa sesión, por ejemplo 1 mod active · cc-arcade. Los mods integrados en Claude Code no se cuentan ahí.

Qué permisos tiene un mod de Claude Code

Un mod de Claude Code no está aislado por sandbox y corre con los permisos del usuario. Esta es la parte que conviene tratar con mentalidad de producción, no como si fuese un tema visual o cosmético.

Según Anthropic, un mod puede leer y escribir archivos, iniciar procesos, hacer solicitudes de red, leer variables de entorno, ver prompts y llamadas a herramientas, modificar la sesión y gastar uso llamando a un modelo del plan del usuario.

Anthropic define los mods como plugins que cambian la apariencia y el comportamiento de Claude Code mediante manejadores de eventos en JavaScript o TypeScript. Esos manejadores pueden observar, modificar o hacerse cargo de eventos como llamadas a herramientas, prompts enviados o partes de la interfaz renderizada.

En la práctica, instalar un mod se parece más a ejecutar código de un repositorio dentro de tu entorno de desarrollo que a activar una extensión decorativa. Si en ese proyecto hay claves, ficheros de clientes, variables de entorno o scripts de despliegue, el riesgo cambia.

• Archivos: un mod puede leer y escribir en el sistema de archivos si declara llamadas como $.fs.read o $.fs.write.
• Procesos: un mod puede arrancar programas mediante llamadas como $.process.run.
• Red: un mod puede hacer peticiones externas si usa $.http.fetch.
• Secretos: un mod puede leer variables de entorno o ajustes con llamadas como $.env.get y $.settings.read.
• Uso del modelo: un mod puede llamar a un modelo de tu plan mediante $.model.complete.

Si ya trabajas con flujos avanzados, conviene aplicar el mismo criterio que explicamos en nuestra guía práctica de Claude Code avanzado: automatiza, pero separa entornos, revisa permisos y no mezcles pruebas con repositorios sensibles.

Cómo revisar y probar un mod sin instalarlo

La forma segura de evaluar un mod es clonarlo, validarlo y cargarlo solo para una sesión antes de instalarlo. Claude Mods recomienda revisar el repositorio sin ejecutarlo y validar el directorio del plugin.

Validar el plugin antes de ejecutarlo

El flujo mínimo es clonar el repositorio y lanzar claude plugin validate. Si el plugin está en una subcarpeta, valida esa subcarpeta, no necesariamente la raíz del repositorio.

git clone https://github.com/<owner>/<repo>
claude plugin validate ./<repo>

La salida de validación es útil porque muestra dos líneas críticas. La línea hooks: indica qué eventos maneja el mod; si aparecen tool.call o prompt.submit, el mod puede ver y cambiar llamadas a herramientas o prompts. La línea calls: indica qué pide hacer a Claude Code.

Probar el mod en una sola sesión

Para probar sin instalación persistente, carga el repositorio con --plugin-dir. Según Claude Mods, los cambios en el módulo de hooks se recargan al guardar, lo que también sirve para autores que están desarrollando un mod.

git clone https://github.com/<owner>/<repo>
claude --plugin-dir ./<repo>

En proyectos reales, usamos este patrón para separar evaluación y adopción: primero revisión de permisos, después prueba en un repositorio de descarte y solo al final instalación en el entorno habitual. Si trabajas con ejecución menos supervisada, revisa también los riesgos del modo automático de Claude Code.

Dónde aparecen los Claude Code mods y qué superficies soportan

Los hooks de un mod pueden ejecutarse en varias superficies, pero lo que dibuja el mod solo aparece en algunas. Según Anthropic, los paneles, bandas y filas sustituidas se muestran en la terminal y en la pestaña Code de Claude Desktop, con matices.

Superficie	¿Ejecuta hooks?	¿Muestra dibujo del mod?
claude en terminal	Sí	Sí
Pestaña Code de Claude Desktop	Sí	Sí, excepto elementos solo de terminal
Sesión WSL dentro de Claude Desktop	No	No
Panel de chat de la extensión de VS Code	Sí	No
claude -p y Agent SDK	Sí	No
Remote Control desde claude.ai o móvil	Sí, en tu máquina	En la terminal de tu máquina

Esta diferencia importa mucho. Un mod que solo protege llamadas a herramientas o redacta salida puede ser útil en más superficies. Un mod que dibuja un tablero, botones o un panel necesita terminal o la pestaña Code de Claude Desktop.

Según Claude Mods, su directorio no oficial listaba 188 mods y estaba actualizado el 9 de octubre de 2026. El propio sitio aclara que es independiente, no afiliado ni respaldado por Anthropic, y que enlaza a repositorios públicos de GitHub escritos por cada autor.

Cómo actualizar, eliminar o desactivar mods de Claude Code

Claude Code permite actualizar, desinstalar y desactivar mods desde comandos o desde la pestaña Installed de /plugin. La opción que elijas depende de si quieres quitar un mod concreto, pausar todos una sesión o bloquear hooks en todas las sesiones.

Para mantener un mod al día, Claude Mods documenta este flujo:

claude plugin marketplace update <marketplace>
claude plugin update <mod>@<marketplace>

Para quitarlo, puedes desinstalar el mod y, si ya no necesitas ese origen, eliminar también el marketplace:

claude plugin uninstall <mod>
claude plugin marketplace remove <marketplace>

Si solo quieres arrancar una sesión limpia para comprobar si un comportamiento viene de un mod, usa Claude Code safe mode:

claude --safe-mode

Según Claude Mods, --safe-mode desactiva todos los mods instalados durante una sesión y también desactiva otras personalizaciones. No elimina los plugins.

Para desactivar todos los mods instalados en todas las sesiones, Claude Mods indica que puedes establecer disableAllHooks en ~/.claude/settings.json. También se paran tus hooks de ajustes y tu línea de estado personalizada; los plugins siguen instalados.

{
  "disableAllHooks": true
}

En una organización, Anthropic permite que un administrador use allowManagedModsOnly en ajustes gestionados para cargar solo mods propios de la organización. En equipos con repositorios de clientes, esta política es más sensata que confiar en que cada usuario recuerde revisar cada plugin.

Errores comunes al instalar Claude Mods

La mayoría de fallos al instalar Claude Mods vienen de versión, recarga, superficie incorrecta o políticas que bloquean hooks. Antes de culpar al mod, revisa estas comprobaciones rápidas.

• Versión antigua: ejecuta claude --version y confirma que estás en Claude Code 2.1.287 o posterior en terminal.
• Sesión sin recargar: si instalaste desde shell con Claude abierto, ejecuta /reload-plugins.
• Superficie equivocada: si el mod dibuja paneles o botones, prueba en terminal o en la pestaña Code de Claude Desktop.
• Hooks bloqueados: ejecuta claude plugin test desde una carpeta sin mod; si aparece que los hooks están desactivados, revisa disableAllHooks o la política de organización.
• Carpeta nueva sin confianza: si no carga ningún mod en una carpeta recién abierta, inicia Claude ahí y acepta el aviso de confianza.
• Terminal sin ratón: si no funcionan los clics, puede que tu terminal no reporte el ratón; los comandos slash del mod deberían seguir funcionando.

El criterio práctico es sencillo: instala menos mods, pero mejor auditados. Para trabajo serio, un mod que evita comandos peligrosos puede aportar más que diez paneles visuales. Anthropic cita como ejemplo blast-radius, que retiene comandos de shell arriesgados como rm -rf o force push y muestra qué cambiarían antes de continuar o cancelar.

Si ya estás llevando Claude Code a pipelines, conviene distinguir entre mods locales y automatizaciones de CI. Para ese segundo caso, tienes otra superficie de riesgo y control en nuestra guía de Claude Code GitHub Actions. Y si comparas el enfoque de Anthropic con otros agentes y plugins, el contexto del DevDay 2026 de OpenAI ayuda a ver hacia dónde van estos entornos extensibles.

Preguntas frecuentes

¿Cómo instalar Claude Mods en Claude Code?

Para instalar Claude Mods en Claude Code, añade primero el marketplace con `claude plugin marketplace add <owner>/<repo>` y después instala el mod con `claude plugin install <mod>@<marketplace>`. Necesitas Claude Code 2.1.287 o posterior en terminal. Si tenías una sesión abierta, ejecuta `/reload-plugins` para cargarlo.

¿Qué permisos tiene un mod de Claude Code?

Un mod de Claude Code se ejecuta con los permisos del usuario y no está aislado por sandbox. Según Anthropic, puede leer y escribir archivos, iniciar procesos, hacer peticiones de red, leer variables de entorno, ver prompts y llamadas a herramientas, modificar la sesión y usar un modelo del plan del usuario.

¿Cómo probar un mod de Claude Code sin instalarlo?

Puedes probar un mod sin instalarlo clonando su repositorio y arrancando Claude Code con `claude –plugin-dir ./<repo>`. Antes conviene ejecutar `claude plugin validate ./<repo>` para ver qué hooks maneja y qué llamadas solicita. Esta prueba carga el mod solo para esa sesión.

¿Cómo desactivar todos los mods en Claude Code?

Para desactivar todos los mods instalados durante una sola sesión, arranca Claude Code con `claude –safe-mode`. Si quieres desactivarlos en todas las sesiones, Claude Mods indica que puedes poner `»disableAllHooks»: true` en `~/.claude/settings.json`. Los plugins siguen instalados, pero sus hooks no cargan.

¿Dónde aparecen los mods de Claude Code?

Los elementos visuales de los mods aparecen principalmente en la terminal y en la pestaña Code de Claude Desktop. Los hooks pueden ejecutarse también en superficies como VS Code chat panel, `claude -p` y Agent SDK, pero ahí el dibujo del mod no aparece. En sesiones WSL dentro de Claude Desktop no cargan plugins.

Fuentes

• Claude Mods — How to install Claude Mods in Claude Code
• Anthropic — Claude Code Docs: Mods overview
• Claude Mods — Directorio no oficial
• Anthropic Help Center — Usar plugins en Claude