Skip to main content
Publicar un plugin de Claude Code significa listarlo en un marketplace, un catálogo JSON que enumera plugins y dónde obtener cada uno, para que otras personas puedan instalarlo por nombre y recibir sus actualizaciones. Puede ejecutar su propio marketplace o enviar su plugin al marketplace comunitario de Anthropic. Para compartir un plugin sin publicarlo, envíe a las personas el directorio del plugin o un .zip del mismo para que lo carguen ellos mismos. Esta página es para el autor de un plugin funcional que está listo para compartirlo.
Estos casos se tratan en otras páginas:
Comience con Elegir cómo distribuir para comparar las opciones de distribución. Si ya conoce su ruta, vaya a Preparar su plugin para el lanzamiento, luego siga la sección de su ruta para saber qué decirles a sus usuarios y cómo reciben sus actualizaciones.

​
Elegir cómo distribuir

Elija una opción de distribución según quién necesite instalar el plugin: La actualización automática es una configuración por marketplace en el lado del usuario que obtiene nuevas versiones en segundo plano.

​
Preparar su plugin para el lanzamiento

El nombre, la versión, la validación y una instalación desde un marketplace deciden si un lanzamiento funciona para las personas que lo instalan. Verifíquelos antes del primer lanzamiento y nuevamente antes de cada uno posterior.
1

Elegir un nombre permanente

Los usuarios instalan, habilitan y configuran su plugin por name@marketplace, por lo que un plugin renombrado es un plugin diferente para cada instalación existente. Elija un nombre en kebab-case como deploy-helper, porque claude plugin validate advierte sobre otras formas, y trátelo como permanente. Establezca displayName en plugin.json para la etiqueta que ven los usuarios.
2

Decidir cómo versionará

Si establece version en plugin.json y luego envía commits sin cambiarlo, claude plugin update imprime <name> is already at the latest version (1.0.0). y los usuarios mantienen la copia anterior. Incremente version en cada lanzamiento, u omítalo en un marketplace alojado en git para que Claude Code use el SHA del commit en su lugar. Consulte Versiones y actualizaciones.
3

Validar

En su shell, ejecute claude plugin validate --strict ./your-plugin. Una ejecución limpia imprime ✔ Validation passed.
  • En CI: mantenga --strict, que también falla la ejecución con código de salida 1 en advertencias como un campo de manifiesto desconocido o una version faltante. Elimine --strict si eligió omitir version en el paso anterior.
  • Rutas: la validación informa rutas de componentes que no comienzan con ./. Dentro de comandos hook y configuraciones de servidor MCP, consulte archivos como ${CLAUDE_PLUGIN_ROOT}/.... Consulte reglas de ruta.
4

Instalarlo desde un marketplace local

En su shell, agregue un marketplace local que enumere el plugin con claude plugin marketplace add ./path-to-marketplace, instale el plugin desde él e inicie una sesión para confirmar que se carga.
5

Completar los metadatos que ven los usuarios

Establezca description, author, homepage y repository en plugin.json, y agregue un README.md en la raíz del plugin. homepage debe analizarse como una URL. La referencia de manifiesto enumera todos los campos.
6

Ejecutar su suite de evaluación

Si tiene una suite de evaluación, ejecute claude plugin eval en su shell. Ejecuta los casos de prueba del plugin y califica los resultados, lo que detecta regresiones cuando cambia el plugin. Consulte Probar plugins con evaluaciones.

​
Compartir un plugin sin un marketplace

Si el plugin está en un repositorio git, las personas pueden clonarlo y cargar el checkout, o iniciar Claude Code desde su shell con --plugin-url apuntando a un .zip que adjunte a un lanzamiento. Para obtener su próxima versión, extraen o descargan nuevamente. Si no está en un repositorio, envíeles el directorio o un .zip del mismo. Lo cargan de una de dos formas:
  • Para una sesión: inician Claude Code desde su shell con claude --plugin-dir ./deploy-helper, donde la ruta es el clon, la carpeta descomprimida o el .zip en sí. Consulte Banderas que cargan un plugin para una sesión.
  • Para cada sesión: mueven el directorio del plugin, con su .claude-plugin/plugin.json, bajo ~/.claude/skills/ para que Claude Code lo cargue en cada sesión.
Agregar un .claude-plugin/marketplace.json a ese mismo repositorio es lo que permite a las personas instalar por nombre y actualizar con un comando; consulte Publicar a través de su propio marketplace.

​
Enviar un plugin con su propia herramienta

Si mantiene una CLI o SDK, publique el plugin en un marketplace y haga que su instalador o mensaje posterior a la instalación ejecute o imprima los dos comandos que necesita un usuario: claude plugin marketplace add <source>, luego claude plugin install <name>@<marketplace>. Para descubrimiento en sesión cuando alguien usa su herramienta, consulte Recomendar su plugin desde su CLI.

​
Publicar a través de su propio marketplace

Su propio marketplace es un archivo .claude-plugin/marketplace.json que enumera su plugin, agregado a un repositorio git. Una vez que el archivo está en el repositorio, el plugin se publica, sin formulario de envío. Puede mantener el archivo en el repositorio del plugin o en uno separado.

​
Agregar el archivo de marketplace a su repositorio

Para publicar desde el repositorio del plugin, guarde el archivo de marketplace junto a plugin.json en .claude-plugin/, con una entrada cuya source sea "./", la raíz del repositorio. Dé a la entrada el mismo name que plugin.json, según Mantener el nombre de la entrada y el nombre del manifiesto iguales:
.claude-plugin/marketplace.json
En su shell, ejecute claude plugin validate . en el repositorio para verificar el archivo antes de hacer push. Crear un marketplace cubre el diseño con varios plugins en un repositorio.

​
Controlar quién puede instalar

Cualquiera que pueda clonar el repositorio puede instalar desde él, por lo que si el repositorio es privado, el marketplace también es privado. Para hosts que no sean un repositorio git, consulte Alojar un marketplace. Para llegar a todos en una empresa, incluidas las personas que no usan git, consulte Implementar en toda una empresa.

​
Decirles a los usuarios cómo instalar

Dígales a sus usuarios que agreguen el marketplace e instalen el plugin desde su shell, reemplazando la fuente y los nombres con los suyos:
  • Agregue el marketplace una vez: claude plugin marketplace add your-org/your-marketplace, donde el argumento es un atajo de GitHub owner/repo, una URL o una ruta
  • Instale el plugin: claude plugin install deploy-helper@your-marketplace
  • O haga ambos desde dentro de una sesión: /plugin install deploy-helper --marketplace your-org/your-marketplace. Requiere Claude Code v2.1.275 o posterior. Consulte Agregar un marketplace e instalar en un comando

​
Enviar actualizaciones a los usuarios

Los usuarios reciben un lanzamiento cuando lo solicitan o cuando la actualización automática está activada para su marketplace:
  • Bajo solicitud: claude plugin update deploy-helper@your-marketplace en el shell del usuario actualiza el marketplace e instala la nueva copia cuando la versión de su plugin ha cambiado
  • Actualización automática: desactivada de forma predeterminada para su marketplace. Consulte Activar la actualización automática. Una vez activada, hace lo mismo que claude plugin update con un retraso después de que comienza la sesión
Instalar plugins cubre los comandos del lado del usuario, y cuándo se ejecuta la actualización automática cubre el tiempo.

​
Enviar al marketplace comunitario

El marketplace comunitario de Anthropic, claude-community, es el marketplace público que enumera plugins enviados a través del formulario de envío del directorio de plugins. Los usuarios agregan el marketplace comunitario en una sesión de Claude Code con /plugin marketplace add anthropics/claude-plugins-community e instalan desde él como @claude-community. Para saber cómo el marketplace comunitario difiere del marketplace oficial, consulte Marketplaces de Anthropic. Para enviar su plugin al marketplace comunitario, use uno de los formularios en la aplicación: El formulario de claude.ai requiere una organización Team o Enterprise y el permiso de Directory, que los Owners tienen de forma predeterminada. Los autores individuales que no forman parte de una organización Team o Enterprise pueden usar el formulario de Console en su lugar. En su shell, ejecute claude plugin validate ./your-plugin localmente antes de enviar, reemplazando ./your-plugin con la ruta a su directorio de plugin. Cuando la validación pasa, Claude Code imprime ✔ Validation passed, o ✔ Validation passed with warnings si hay advertencias. Las advertencias no fallan la validación; agregue --strict para tratarlas como errores. Los plugins listados aparecen en el catálogo anthropics/claude-plugins-community, en casi todos los casos fijados a un SHA de commit específico. Puede haber un retraso entre el envío y la aparición de su plugin en marketplace.json. Para verificar si su plugin ya es instalable, busque su nombre en el catálogo comunitario. El marketplace oficial, claude-plugins-official, no acepta envíos a través de estos formularios. Si trabaja con un contacto de socio de Anthropic, pregúnteles sobre un listado en el marketplace oficial.

​
Enviar actualizaciones, cambios de nombre y eliminaciones

​
Lanzar una nueva versión

Si publica a través de su propio marketplace y su plugin.json establece version, increméntelo y haga push. Los usuarios que ejecuten claude plugin update o tengan la actualización automática activada reciben la nueva versión, como se describe en Enviar actualizaciones a los usuarios.

​
Etiquetar un lanzamiento

Etiquete el lanzamiento en git cuando otros plugins declaren un rango de versión en el suyo, porque esos rangos se resuelven contra etiquetas. De lo contrario, no necesita una etiqueta. Para etiquetar, ejecute claude plugin tag en su shell desde el directorio del plugin. Crea una etiqueta {name}--v{version}. Agregue --push para enviar la etiqueta a origin. La referencia de plugin tag enumera sus banderas.

​
Renombrar o eliminar un plugin

Nunca cambie el name de un plugin publicado. Después de un cambio de nombre, los usuarios que ya lo instalaron pierden el plugin, porque su instalación se registra bajo el nombre anterior. Una entrada renames en su archivo de marketplace los migra en su lugar. Cambie displayName cuando desee una etiqueta diferente. Si un cambio de nombre es inevitable, use el mapa renames del archivo de marketplace para que las instalaciones existentes se migren en lugar de fallar con Plugin "<name>" not found in marketplace. Para eliminar un plugin del marketplace, o para los detalles completos de renames, consulte Renombrar o eliminar un plugin en la página de alojamiento. La referencia de marketplace tiene el campo.

​
Declarar dependencias

Si su plugin necesita que otro plugin del mismo marketplace esté habilitado, enumérelo en la matriz dependencies de plugin.json. Cada entrada es un nombre simple o un objeto con un rango de versión semver. Cuando un usuario instala su plugin, Claude Code también instala y habilita la dependencia. Dependencias de plugins cubre la sintaxis de rango, dependencias entre marketplaces y cómo los usuarios eliminan dependencias que ya no necesitan.

​
Próximos pasos