AI-translated from English; not yet reviewed by a fluent editor.

# Mods de Claude Code: crea un indicador del contexto y revisa sus permisos de acceso

> Los mods de Claude Code pueden dibujar dentro de una sesión y cambiar su comportamiento. Esta guía, basada en la documentación, explica cómo solicitar un indicador del contexto y revisar sus permisos.

By BIG CHANGE Editorial

Published: 2026-10-02T04:59:25.238Z
Updated: 2026-10-02T04:59:25.238Z
Canonical: https://bigchange.ai/blog/claude-code-mods-context-display-guide

![Illustrated close-up of a computer display with three mod files, a session usage call, and an orange context strip.](https://bigchange.ai/api/media/file/claude-code-mods-context-hero-v2.png)
AI-generated by OpenAI; BIG CHANGE conceptual editorial illustration.

Quienes usan Claude Code ya pueden cambiar la interfaz y el comportamiento del asistente mediante funciones de JavaScript o TypeScript empaquetadas como plugins. Anthropic [lanzó los mods el 1 de octubre](https://claude.com/blog/claude-code-mods), con compatibilidad en la CLI y en la pestaña Code de Claude Desktop. Los desarrolladores pueden añadir a la conversación un indicador del uso del contexto.

Anthropic afirma que los mods se ejecutan con los permisos del equipo del usuario y no están aislados en un entorno limitado. Un mod también puede leer datos de sesión o hacer llamadas a modelos. Revisa el código y quién lo publica antes de instalarlo.

Esta guía está dirigida a desarrolladores que ya usan Claude Code y quieren una personalización pequeña y visible. El objetivo es crear un indicador del uso de la ventana de contexto, inspeccionar el plugin resultante y decidir si conservarlo. Las instrucciones se basan en la documentación, cotejada el 2 de octubre con Claude Code v2.1.287 y versiones posteriores. BIG CHANGE no ha seguido este procedimiento ni ha probado por su cuenta el código generado.

## El gran cambio

- Qué cambió: los mods de Claude Code añaden funciones que pueden modificar eventos y dibujar dentro de la interfaz del asistente, empaquetadas mediante el sistema de plugins existente.
- Por qué importa: los desarrolladores pueden incorporar a su sesión un indicador o un control del flujo de trabajo, dando a ese código acceso a su equipo y a sus conversaciones.
- Qué conviene observar: si las llamadas y el comportamiento reales del mod coinciden con su propósito, qué controles de la organización se aplican y qué cambios de API surgen entre versiones de Claude Code.

## Comprueba la versión, la cuenta y el espacio de trabajo

Ejecuta `claude --version` en una terminal. La [documentación actual de los mods](https://code.claude.com/docs/en/plugins/mods/overview) exige la versión v2.1.287 o posterior y señala que los mods están habilitados de forma predeterminada. Los ajustes de variables de entorno de la etapa de acceso anticipado no controlan esta versión.

Necesitas acceso a Claude Code y un espacio de trabajo que hayas aceptado como de confianza. La [documentación de configuración](https://code.claude.com/docs/en/setup) enumera las cuentas Pro, Max, Team, Enterprise y Console, además de proveedores de API de terceros compatibles. El plan gratuito de chat de Claude no incluye Claude Code. La configuración de una organización puede impedir que se carguen mods creados por usuarios.

Usa una sesión de terminal interactiva. La CLI y las sesiones compatibles de Desktop muestran las interfaces de los mods. Los hooks también se ejecutan en el panel de chat de VS Code y en sesiones sin interfaz, donde los dibujos no aparecen. Las sesiones de WSL de Desktop no admiten plugins.

## Crea e inspecciona el indicador

El [tutorial del 1 de octubre](https://claude.dev/blog/getting-started-with-claude-code-mods/) de Anthropic presenta Token Weather, un indicador que lee el uso del contexto después de cada turno. Su porcentaje se basa en el contexto usado en la última respuesta y en la ventana de contexto del modelo. Es un indicador de uso, no una medida documentada de la calidad de las respuestas.

1. Inicia `claude` en el espacio de trabajo de confianza. Pídele que cree un mod que muestre, encima del cuadro de entrada, el porcentaje de contexto, los tokens usados y el tamaño de la ventana de contexto, y que se actualice al terminar cada turno del agente principal. Solicita la API documentada de uso de sesión y una implementación que solo muestre datos, sin acceso a archivos, ejecución de procesos, solicitudes de red ni llamadas a modelos. Esta es nuestra especificación más limitada para la ruta de creación documentada; la petición por sí sola no impone esas restricciones.
2. Revisa los archivos que cree Claude. El [manual de creación](https://code.claude.com/docs/en/plugins/mods/create) indica que el plugin se guarda en el directorio de la sesión, dentro de `~/.claude/dev-mods/`. Inspecciona su manifiesto, la configuración de hooks y el código. Claude Code pregunta si quieres habilitar la recarga en caliente; al aceptarla se ejecutan los mods de esta sesión y sus revisiones posteriores.
3. Antes de habilitarlo, ejecuta `claude plugin validate` seguido del directorio real del plugin en la terminal. Lee los hooks de eventos y las llamadas a API que informe. El comportamiento previsto requiere leer el uso, conservar el estado y mostrarlo. Investiga también cualquier acceso a archivos, variables de entorno, procesos, red o modelos, y revisa las reescrituras de eventos en el código fuente. Una validación satisfactoria indica compatibilidad con el cargador, no una garantía de seguridad.
4. Después de aprobar una implementación revisada, ejecuta `/plugin` y comprueba que el mod aparece en la pestaña Installed. Haz una solicitud normal y verifica que el indicador se actualiza al terminar el turno. Para considerar que funciona, el plugin debe estar cargado y mostrar valores de uso que se actualicen; generar un archivo no basta para demostrarlo.

Estos pasos no garantizan que Claude genere la implementación deseada al primer intento. La implementación completa de [Token Weather y su ejemplo de prueba](https://claude.dev/blog/getting-started-with-claude-code-mods/#build-your-first-mod-token-weather) sirven para comparar lo que escriba. El tutorial indica que una lectura normal del uso de sesión es gratuita; solicitar un desglose puede enviar una petición de recuento de tokens. Pedir a Claude que escriba o revise el mod sigue consumiendo el uso habitual de Claude Code.

## Mantén a la vista el código y sus permisos

Un mod creado en una sesión es temporal. El manual de creación indica que, para conservarlo, copies su directorio en una ubicación propia y luego inicies sesiones con `claude --plugin-dir` seguido de esa ubicación. Cada carga escribe declaraciones específicas de la versión en `.claude-plugin/types/`; revísalas al actualizar porque la API puede cambiar.

El [manual de administración](https://code.claude.com/docs/en/plugins/mods/admin) de Anthropic explica un límite que las reglas de permisos de herramientas pueden ocultar. La protección de seguridad integrada se carga para usuarios de Team o Enterprise, o en equipos con ajustes administrados. Con la configuración predeterminada, las reglas de denegación tienen prioridad sobre los mods de usuario que permiten llamadas a herramientas de Claude. Esas reglas no restringen las llamadas del propio mod a las API del sistema de archivos o de procesos. Los administradores pueden bloquear los mods instalados por usuarios o aplicar un mod de políticas a sus llamadas.

La [investigación de Pluto Security del 22 de septiembre](https://pluto.security/blog/claude-code-function-hooks-security/) informó de acceso a credenciales, engaño de interfaz y cambios remotos de código en pruebas de la implementación previa al lanzamiento. Pluto vende software de seguridad para estas extensiones y su informe es explícitamente anterior a la disponibilidad general. Es una referencia útil para revisar el código fuente de un plugin y sus dependencias descargadas; sus hallazgos concretos no demuestran cómo se comporta v2.1.287. La documentación actual de Anthropic aporta los detalles de permisos de la versión publicada.

Desactiva un mod desde los controles de plugins. `--safe-mode` omite los mods instalados y otras personalizaciones durante una sesión.

## Uso y coste

El anuncio de lanzamiento y los manuales de mods de Anthropic no especifican una tarifa aparte para los mods. La [documentación de costes de Claude Code](https://code.claude.com/docs/en/costs) indica que el uso de suscripciones se descuenta de las asignaciones del plan, mientras que Console y los proveedores en la nube cobran por tokens. Un mod que llama a un modelo puede consumir ese uso. Consulta `/usage` y la interfaz de facturación correspondiente a tu método de inicio de sesión; el porcentaje de contexto no es una factura ni un límite de gasto.

Anota la versión de Claude Code junto con el plugin revisado. Añadir aprobaciones de comandos o herramientas auxiliares descargadas exige otra revisión porque cambia lo que puede hacer el código.

## Fuentes y lecturas adicionales

- [Personaliza Claude Code con mods](https://claude.com/blog/claude-code-mods), 1 de octubre de 2026: anuncio de lanzamiento, empaquetado de plugins y advertencia explícita sobre el acceso al equipo. Anthropic desarrolla y vende Claude Code.
- [Descripción general de los mods](https://code.claude.com/docs/en/plugins/mods/overview), consultado el 2 de octubre: versión, superficies de sesión, permisos del host, validación y controles de desactivación.
- [Crea un mod](https://code.claude.com/docs/en/plugins/mods/create), consultado el 2 de octubre: creación, aprobación, recarga en caliente, conservación y declaraciones de tipos específicas de cada versión. Documenta el comportamiento previsto, no una prueba de BIG CHANGE.
- [Primeros pasos con los mods de Claude Code](https://claude.dev/blog/getting-started-with-claude-code-mods/), Addy Osmani, 1 de octubre: métrica, código y ejemplo de prueba de Token Weather. El resultado demostrado es de Anthropic.
- [Administra mods para tu organización](https://code.claude.com/docs/en/plugins/mods/admin), consultado el 2 de octubre: disponibilidad de la protección, alcance de las reglas de denegación y opciones de administración. No afirma que los mods de usuario estén generalmente aislados del equipo.
- [Configuración avanzada](https://code.claude.com/docs/en/setup) y [Gestiona los costes eficazmente](https://code.claude.com/docs/en/costs), consultado el 2 de octubre: requisitos de cuenta, facturación según la autenticación y seguimiento del uso. Las fuentes de lanzamiento revisadas no especifican una tarifa aparte para los mods.
- [Pluto Security, Dentro de los hooks de funciones de Claude Code](https://pluto.security/blog/claude-code-function-hooks-security/), 22 de septiembre: pruebas de seguridad de investigadores sobre la versión previa al lanzamiento y sus límites. Pluto comercializa productos de seguridad para extensiones; no reprodujimos sus pruebas.

## Sources

- [Personaliza Claude Code con mods](https://claude.com/blog/claude-code-mods) — Anuncio de lanzamiento de Anthropic: mods en la CLI y Desktop, empaquetado de plugins y permisos del equipo. El proveedor vende Claude Code.
- [Descripción general de los mods](https://code.claude.com/docs/en/plugins/mods/overview) — Documentación oficial en evolución: v2.1.287 y posteriores, superficies, permisos, validación y desactivación. Son instrucciones del proveedor, no una prueba nuestra.
- [Crea un mod](https://code.claude.com/docs/en/plugins/mods/create) — Creación, aprobación, recarga, conservación y declaraciones de tipos específicas de cada versión. El código solicitado aún debe inspeccionarse.
- [Primeros pasos con los mods de Claude Code](https://claude.dev/blog/getting-started-with-claude-code-mods/) — Tutorial de Anthropic escrito por Addy Osmani: métrica de Token Weather, implementación completa y ejemplo de prueba; lo demuestra el proveedor, no BIG CHANGE.
- [Administra mods para tu organización](https://code.claude.com/docs/en/plugins/mods/admin) — Disponibilidad oficial de la protección, alcance de las reglas de denegación y controles de administración. Las reglas que deniegan herramientas no restringen las llamadas del propio mod al sistema de archivos o a procesos.
- [Configuración avanzada](https://code.claude.com/docs/en/setup) — Requisitos de cuenta y acceso: suscripciones de pago, Console o proveedores compatibles; el chat gratuito no incluye Claude Code.
- [Gestiona los costes eficazmente](https://code.claude.com/docs/en/costs) — Asignaciones del plan, facturación de tokens de API/proveedores y seguimiento del uso. Las fuentes de lanzamiento revisadas no indican una tarifa aparte para los mods.
- [Dentro de los hooks de funciones de Claude Code: el problema de confianza detrás de los mods de Claude](https://pluto.security/blog/claude-code-function-hooks-security/) — Pruebas de seguridad de investigadores de Pluto sobre la versión previa al lanzamiento. No demuestran el comportamiento de v2.1.287; Pluto vende productos de seguridad para extensiones. BIG CHANGE no las reprodujo.