Referencia de Marketplace

Referencia completa de los campos marketplace.json, entradas de plugins y los objetos de origen de plugin y marketplace, con dónde es válido cada uno.

marketplace.json es el archivo que define un marketplace de plugins. Contiene el nombre del marketplace, su propietario y una entrada por cada plugin. La fuente de plugin de cada entrada indica dónde Claude Code obtiene ese plugin.

Una fuente de marketplace es un objeto separado que indica dónde Claude Code obtiene el archivo marketplace en sí. Usted escribe uno en la configuración, o Claude Code construye uno cuando ejecuta claude plugin marketplace add.

Esta referencia es para los mantenedores de marketplace que necesitan un nombre de campo o valor exacto, y para los administradores que necesitan saber qué valores de source son válidos en extraKnownMarketplaces, strictKnownMarketplaces y blockedMarketplaces.

[!NOTE]

Estos casos se cubren en otras páginas:

• Construir u alojar un marketplace: consulte Crear un marketplace y Alojar y mantener un marketplace
• Recetas de lista de permitidos y lista de bloqueados: consulte Administrar plugins para su organización

Encuentre la sección para lo que está escribiendo o leyendo:

• El archivo marketplace: Campos de nivel superior y Entradas de plugins
• El source de una entrada: Fuentes de plugins
• Un objeto source en la configuración: Fuentes de marketplace
• Salida de claude plugin validate <path>: Mensajes de validación, que asigna cada mensaje al campo que nombra

Archivo marketplace

Guarde el archivo marketplace en .claude-plugin/marketplace.json en el directorio de su marketplace. Si mantiene el archivo en otro lugar del repositorio, los usuarios tienen que declarar el marketplace en extraKnownMarketplaces con path establecido en su fuente, porque claude plugin marketplace add no tiene opción para ello.

El directorio que contiene .claude-plugin/ se llama raíz del marketplace, y cada fuente de plugin relativa se resuelve desde él, no desde .claude-plugin/.

Cada usuario registra un marketplace por name, por lo que un usuario no puede tener dos marketplaces con el mismo nombre registrados a la vez.

Claude Code ignora una clave de nivel superior desconocida o una clave de entrada de plugin en lugar de rechazarla, por lo que un error tipográfico se carga silenciosamente. claude plugin validate reporta cada clave desconocida como una advertencia.

Nombres reservados

No puede dar a su marketplace ninguno de los siguientes nombres:

• Nombres de marketplace oficial: claude-code-marketplace, claude-code-plugins, claude-plugins-official, anthropic-marketplace, anthropic-plugins, agent-skills, anthropic-agent-skills, life-sciences, knowledge-work-plugins, claude-for-legal, claude-for-financial-services, financial-services-plugins, first-party-plugins y claude-tag-plugins. Reservado a menos que el marketplace provenga de una fuente de marketplace github o git bajo github.com/anthropics/.
• Nombres de marketplace comunitario: claude-community, claude-plugins-community y healthcare. Reservado bajo la misma regla que los nombres oficiales.
• Nombres de directorio de plugins: anthropic-plugin-directory y claude-plugin-directory. Reservado bajo la misma regla que los nombres oficiales.
• Nombres que suplanten un marketplace oficial: nombres como official-claude-plugins o claude-plugins-v2, y cualquier nombre que contenga un carácter no ASCII. El error es Marketplace name impersonates an official Anthropic/Claude marketplace. Un carácter de control o de formato bidireccional en un nombre también reporta Marketplace name cannot contain control or bidirectional-formatting characters. Un marketplace ya registrado bajo tal nombre deja de cargarse, junto con sus plugins.
• Otra ortografía de un nombre reservado: un nombre que difiere de un nombre reservado solo por un punto final, o por un símbolo distinto de un guion bajo en lugar de un guion, por lo que claude.code.plugins cuenta como claude-code-plugins. Agregar el marketplace falla con is another spelling of "<reserved>", a reserved marketplace name, y un marketplace ya registrado bajo uno deja de cargarse. Esta verificación requiere Claude Code v2.1.280 o posterior.
• Nombres que Claude Code usa para plugins que no provienen de un marketplace: inline para plugins cargados con --plugin-dir, builtin para plugins integrados, skills-dir para plugins cargados automáticamente desde .claude/skills/ y synced para plugins sincronizados desde su cuenta claude.ai. claude-plugin-test también está reservado. skills-dir también aparece como {"source": "skills-dir"} en strictKnownMarketplaces y blockedMarketplaces, descrito bajo Valores de fuente válidos solo en listas de políticas.
• npm, pip, uv, cargo, github y gh: reservado en cualquier mayúscula. Esta verificación requiere Claude Code v2.1.275 o posterior.
• Nombres de miembros que tiene todo objeto de JavaScript: constructor, hasOwnProperty, isPrototypeOf, propertyIsEnumerable, toLocaleString, toString y valueOf. claude plugin marketplace add rechaza un marketplace que use uno con Claude Code reserves this name and cannot register a marketplace under it. Esta verificación requiere Claude Code v2.1.296 o posterior.
• Nombres que comienzan con claudeai-: reservado para marketplaces alojados en claude.ai. claude plugin marketplace add rechaza cualquier otro marketplace que use uno con Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai.
• La carpeta de descarga de un marketplace de GitHub registrado, <owner>-<repo>: Claude Code descarga un marketplace agregado desde una fuente github como acme/x-tools a través de una carpeta llamada acme-x-tools, sea cual sea el name propio de ese marketplace. Mientras ese marketplace esté registrado con un nombre distinto de acme-x-tools, claude plugin marketplace add rechaza un marketplace diferente llamado acme-x-tools después de descargarlo, e informa Can't use the marketplace name "acme-x-tools". Esta verificación requiere Claude Code v2.1.290 o posterior.

Cuando un marketplace registrado deja de cargarse porque su nombre imita uno oficial, claude plugin list y /plugin reportan Claude Code refuses the marketplace name "<name>". El mensaje te indica que elimines el marketplace. Eliminarlo también desinstala sus plugins y elimina sus datos, opciones y secretos. Este mensaje de rechazo nombrado requiere Claude Code v2.1.282 o posterior.

Si un archivo de configuración declara el marketplace en línea, el mensaje te indica que cambies el nombre de su entrada antes de eliminar el nombre anterior. Para ver los pasos, consulta Claude Code refuses the marketplace name. El mensaje los enumera en Claude Code v2.1.292 o posterior.

Campos de nivel superior

La tabla enumera cada clave que Claude Code lee de marketplace.json. name, owner y plugins son obligatorios.

Entradas de plugins

Cada objeto en el array plugins de nivel superior de marketplace.json nombra un plugin e indica dónde obtenerlo. name y source son obligatorios.

Además de los campos de listado del directorio, una entrada también acepta cada campo de plugin.json, como description, version, author, commands y hooks. Para saber cuándo se aplican esos campos, consulta Cómo una entrada se combina con plugin.json.

La tabla enumera los campos propios de la entrada y los campos del manifiesto cuyo significado cambia en una entrada.

Cómo una entrada se combina con plugin.json

Los campos de la entrada se aplican de manera diferente a un plugin obtenido que tiene su propio .claude-plugin/plugin.json y a uno que no:

• Sin plugin.json: la entrada es el manifiesto independientemente de strict. Cada campo de manifiesto que acepta la entrada se aplica, incluidos mcpServers, lspServers, userConfig y channels.
• plugin.json presente: plugin.json es el manifiesto. Modo estricto decide si los seis campos de componente de la entrada, commands, agents, skills, hooks, outputStyles y themes, se combinan con él o se rechazan como un conflicto. Los campos mcpServers, lspServers, userConfig y channels de la entrada no se aplican. Decláralos en plugin.json.

Hooks en una entrada

Escribe los hooks de la entrada como un objeto en línea que asigne nombres de eventos de hook a arrays de matchers. Si escribes una ruta de archivo o un array en su lugar, claude plugin validate lo aprueba. Esos hooks nunca se ejecutan, y Claude Code reporta un error not yet supported in a marketplace entry para el plugin. Coloca los hooks basados en archivos en el propio hooks/hooks.json del plugin o en plugin.json.

Campos de visualización

Tanto la entrada como el propio plugin.json del plugin pueden establecer los campos de visualización displayName, description, author, homepage, repository, license y keywords. Los usuarios ven estos valores en los listados y detalles de plugins, antes y después de instalar:

• Para un campo que establezcas en la entrada, los usuarios ven el valor de la entrada, incluso cuando plugin.json establece uno diferente.
• Para un campo que la entrada deja sin establecer, los usuarios ven el valor de plugin.json.

Antes de instalar, Claude Code solo puede leer plugin.json para entradas con una fuente de ruta relativa, cuyos archivos de plugin están dentro del marketplace en sí. Para una entrada con cualquier otro tipo de fuente, los usuarios ven solo los campos propios de la entrada hasta que instalen el plugin.

Modo estricto

strict decide qué sucede cuando el plugin obtenido tiene su propio plugin.json y la entrada también declara cualquiera de los campos de componente: commands, agents, skills, hooks, outputStyles o themes. Con strict: true, el predeterminado, Claude Code añade los campos de componente de la entrada a plugin.json, excepto hooks, cuyos matchers reemplazan los del manifiesto por evento. Con strict: false, una entrada que declara cualquier campo de componente es un conflicto, y el plugin falla al cargar. La tabla muestra cada combinación de strict, plugin.json y los campos de componente de la entrada.

Orígenes de plugins

El source de una entrada de plugin indica desde dónde Claude Code obtiene ese plugin en particular. Es una cadena de ruta relativa o un objeto cuya propia clave source nombra el tipo, de modo que una entrada se ve así: "source": { "source": "github", "repo": "your-org/formatter" }.

La tabla enumera cada tipo de origen de plugin y sus campos.

Los nombres url y github también son tipos de origen de marketplace, donde url significa un enlace directo a un archivo marketplace.json en lugar de a un repositorio git. git existe solo como origen de marketplace, y npm existe como ambos. git-subdir, archive y command existen solo como orígenes de plugin.

Usa una ruta relativa para un plugin que esté en un subdirectorio del propio repositorio del marketplace. Usa git-subdir para un subdirectorio de algún otro repositorio.

Los orígenes github, url y git-subdir comparten los campos ref y sha:

• ref: una rama o etiqueta. De forma predeterminada es la rama predeterminada del repositorio.
• sha: un SHA de commit completo de 40 caracteres en minúsculas. Cuando estableces tanto ref como sha, Claude Code hace checkout de sha. En la mayoría de los hosts de git, incluidos GitHub, GitLab y Bitbucket, esto significa que la instalación tiene éxito aunque la rama o etiqueta nombrada por ref se haya eliminado desde entonces en el upstream, siempre que el commit siga siendo alcanzable desde el repositorio. Algunos servidores, como AWS CodeCommit, no admiten obtener commits por SHA. En esos servidores, la ref debe seguir existiendo y el commit fijado debe ser alcanzable desde ella.

Para saber cómo se obtiene, almacena en caché y versiona cada tipo, consulta la referencia de carga de plugins.

Origen de plugin de ruta relativa

La ruta se resuelve desde la raíz del marketplace. ./plugins/formatter es <root>/plugins/formatter aunque el archivo del marketplace esté en <root>/.claude-plugin/.

Una ruta que contiene .. no supera la validación. En macOS y Linux, Claude Code rechaza una ruta de entrada que contenga una barra invertida en cualquier lugar después del ./ inicial, así que escribe la ruta con barras diagonales.

{ "name": "formatter", "source": "./plugins/formatter" }

Una ruta relativa solo se resuelve cuando Claude Code tiene los archivos del marketplace, así que revisa el tipo de origen del marketplace:

• github, git, file y directory: Claude Code tiene los archivos del marketplace.
• url: Claude Code obtiene solo marketplace.json, por lo que las rutas relativas no pueden resolverse. En su lugar, dale a cada plugin un origen de tipo objeto, como github o git-subdir.
• settings: las rutas relativas se rechazan directamente.

Submódulos de Git en el repositorio del marketplace

Cuando Claude Code clona un repositorio de marketplace, obtiene solo los submódulos de git que contienen archivos de plugins. Requiere Claude Code v2.1.295 o posterior.

Las versiones anteriores obtienen todos los submódulos, incluidos los anidados. Si el repositorio tiene un submódulo grande, Claude Code puede entonces superar el tiempo de espera de clonación mientras lo obtiene.

Para un plugin en un subdirectorio, como ./plugins/formatter, Claude Code obtiene un submódulo en estos casos:

• El plugin está dentro del submódulo: el submódulo es el directorio del plugin o un directorio por encima de él
• El submódulo está dentro del plugin: el submódulo está en cualquier lugar bajo el directorio del plugin
• Un enlace simbólico apunta dentro del submódulo: un enlace con commit en el repositorio tiene su destino en el submódulo

Un plugin en la raíz del marketplace, con "source": "./", obtiene todos los submódulos del repositorio o ninguno. Claude Code obtiene todos los submódulos cuando alguno de estos apunta dentro de cualquier submódulo:

• Un directorio de componentes: un directorio en la raíz que contiene componentes del plugin, como skills/, hooks/ o bin/
• Una ruta en la configuración del plugin: una ruta en la entrada del marketplace del plugin, en su plugin.json o en un archivo de configuración como .mcp.json o hooks/hooks.json
• Un enlace simbólico: un enlace con commit en el repositorio
• Texto en los archivos del plugin: la ruta de un submódulo, como vendor/tool, escrita en un archivo de configuración o en un archivo bajo un directorio de componentes

Cuando ninguno de ellos apunta dentro de un submódulo, Claude Code no obtiene ningún submódulo para ese plugin. Un repositorio que es a la vez un proyecto y un plugin a menudo tiene submódulos que solo usa la compilación del proyecto, y esta regla los deja fuera.

Claude Code también obtiene todos los submódulos cuando no puede determinar cuáles contienen archivos de plugins, por ejemplo:

• Un SKILL.md en la raíz: en ese caso, todo el repositorio es el directorio de un skill
• Un archivo que Claude Code no puede leer: el archivo del marketplace, uno de los archivos de configuración del plugin o .gitmodules

Si agregas un marketplace con --sparse, o su origen establece sparsePaths, Claude Code hace checkout solo de los directorios nombrados allí y no obtiene ningún submódulo. Las versiones anteriores hacen lo mismo.

Para mantener fuera de la clonación un submódulo que tus plugins no usan, consulta Mantener los submódulos no usados fuera de la clonación.

Nombres simples bajo pluginRoot

Un nombre simple es un único nombre de directorio sin /, como "formatter". Para escribir nombres simples en lugar de rutas ./, establece metadata.pluginRoot en el directorio bajo el cual se resuelven. Con "pluginRoot": "./plugins", "source": "formatter" se resuelve como ./plugins/formatter. Requiere Claude Code v2.1.239 o posterior.

metadata.pluginRoot tiene estos límites:

• Debe ser en sí mismo una ruta relativa dentro del marketplace.
• No tiene efecto sobre un origen que ya comienza con ./.
• Un origen que contiene una /, como team-a/formatter, no es un nombre simple y sigue necesitando el prefijo ./, incluso cuando metadata.pluginRoot está establecido.

Origen de plugin github

repo acepta owner/repo. ref y sha son opcionales.

{
  "name": "formatter",
  "source": {
    "source": "github",
    "repo": "your-org/formatter",
    "ref": "v2.0.0",
    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
  }
}

Origen de plugin url

url es una URL de git completa: https://, http://, file:// o git@. No se requiere el sufijo .git, por lo que las URL de Azure DevOps y AWS CodeCommit funcionan tal como están escritas. Este tipo no acepta la forma abreviada owner/repo.

{
  "name": "formatter",
  "source": {
    "source": "url",
    "url": "https://gitlab.example.com/your-group/formatter.git",
    "ref": "main"
  }
}

Origen de plugin git-subdir

url acepta una URL de git completa o la forma abreviada owner/repo de GitHub. path es el subdirectorio que contiene el plugin, y Claude Code hace checkout solo de ese subdirectorio. Con una URL https o SSH, Claude Code le pide al servidor una clonación parcial, así que desde un host que admite clonaciones parciales, un plugin en un monorepo grande se instala sin descargar el resto del repositorio.

{
  "name": "formatter",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/your-org/monorepo.git",
    "path": "tools/formatter"
  }
}

Origen de plugin npm

Un origen npm acepta estos campos:

• package: un nombre de paquete del registro como @your-org/formatter, un nombre con una versión añadida como @your-org/formatter@2.0.0, o un enlace https al archivo tarball del paquete
• version: una versión, un rango semver o una dist-tag, que se usa cuando package es un nombre de paquete sin versión añadida. Omítelo para obtener latest
• registry: una URL de registro para un paquete que no está en el registro predeterminado

Claude Code obtiene el paquete con tu cliente de npm. Los scripts de instalación del paquete, como preinstall o postinstall, nunca se ejecutan, y sus dependencias no se instalan durante la obtención. Si el paquete tiene un lockfile compatible junto a su package.json, Claude Code instala esas dependencias de paquetes de Node.js en un paso aparte, también con los scripts deshabilitados.

Claude Code revisa el valor de package antes de obtener nada. Un valor rechazado hace fallar la instalación con un mensaje que nombra el valor y el motivo. Los valores rechazados incluyen:

• Una dirección de git, una carpeta o ruta file:, o un alias npm:: usa un origen github, url o git-subdir para un repositorio git, una ruta relativa para una carpeta del marketplace y el propio nombre del paquete en lugar de un alias
• Un enlace a un tarball en github.com, gist.github.com, gitlab.com, bitbucket.org o git.sr.ht: se rechaza incluso cuando el enlace es una descarga de una release de GitHub, a menos que sea un enlace al registro npm de GitLab bajo gitlab.com/api/v4/
• Un enlace a un tarball a través de http: se rechaza a menos que apunte al registro npm predeterminado del propio usuario que instala

La URL de registry debe usar https a menos que sea el registro npm predeterminado del propio usuario que instala. Con cualquier otro registro http, la instalación falla antes de que npm lo contacte.

{
  "name": "formatter",
  "source": {
    "source": "npm",
    "package": "@your-org/formatter",
    "version": "^2.0.0",
    "registry": "https://npm.example.com"
  }
}

Origen de plugin archive

url debe usar https:// y no puede apuntar a un host de loopback, de enlace local (link-local) o de metadatos de la nube. Para conocer los límites de tamaño, tiempo de espera, redirecciones y extracción de la descarga, consulta Mantenerse dentro de los límites de descarga para archivos alojados.

La raíz del plugin puede estar en el nivel superior del zip o un directorio más abajo.

sha256 es el digest del archivo como 64 caracteres hexadecimales, en mayúsculas o minúsculas. Cuando lo estableces, Claude Code rechaza una descarga que no coincida.

{
  "name": "formatter",
  "source": {
    "source": "archive",
    "url": "https://artifacts.example.com/formatter-2.0.0.zip",
    "sha256": "6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1"
  }
}

Origen de plugin command

Usa un origen command cuando una herramienta instalada en la máquina del usuario produce el directorio del plugin, como un IDE que genera su plugin para la cadena de herramientas que el usuario ha seleccionado. Claude Code ejecuta el comando cuando el usuario instala o actualiza el plugin, y de nuevo una vez por sesión, para que los usuarios reciban la salida modificada de la herramienta sin reinstalar.

Un origen command acepta estos campos:

• command: un comando de shell que imprime la ruta absoluta del directorio del plugin como una sola línea y termina con código 0. Claude Code muestra a los usuarios la cadena completa para que la revisen antes de ejecutarla. Escríbelo en ASCII imprimible, con un máximo de 500 caracteres y sin secuencias de cuatro o más espacios.
• timeout: un número entero de segundos entre 1 y 600. El valor predeterminado es 60.
• mode: copy, el predeterminado, o link. Consulta Modo copy y modo link.

{
  "name": "formatter",
  "source": {
    "source": "command",
    "command": "my-tool claude-plugin-path",
    "timeout": 120
  }
}

Para saber cómo los usuarios aceptan el comando, consulta Instalar desde tu shell. Para saber qué ven los usuarios después de que lo cambias, consulta Cambiar el comando de un origen command. Los administradores desactivan los orígenes command con disableCommandPluginSources.

Qué debe hacer el comando

Escribe el comando de modo que cumpla estos requisitos:

• Shell y directorio de trabajo: Claude Code ejecuta el comando mediante sh, o mediante cmd.exe en Windows, desde el directorio home del usuario. Indica una ruta absoluta o un comando que esté en PATH.
• Salida: imprime exactamente una línea en stdout, la ruta absoluta del directorio del plugin, y termina con código 0 dentro de los timeout segundos.
• Contenido del directorio: el directorio contiene el plugin completo en el momento en que el comando termina. La ruta puede ser distinta de una ejecución a otra.

Salida que hace fallar la instalación o actualización

La instalación o actualización falla cuando el comando termina con un código distinto de cero, se ejecuta durante más de timeout o imprime cualquier cosa que no sea exactamente una única ruta absoluta. También falla cuando el directorio impreso es uno de estos:

• Sin contenido de plugin: el directorio impreso no tiene contenido de plugin en su nivel superior, como un directorio .claude-plugin/ o un directorio skills/, commands/, agents/ o hooks/.
• El propio directorio de la sesión: el directorio impreso es aquel en el que se inició Claude Code, o uno de sus directorios superiores.
• Una ruta de red: en Windows, la ruta impresa es una ruta UNC.
• Demasiado grande para copiar: en modo copy, el directorio ocupa más de 256 MiB o tiene más de 20,000 entradas.

Modo copy y modo link

mode decide si Claude Code copia el directorio impreso o lo usa en su ubicación:

• copy: Claude Code copia el directorio en la caché de plugins y deriva la versión del plugin a partir de un hash de los archivos copiados. Tu herramienta puede eliminar o reescribir el directorio después de que el comando termine. Una nueva ejecución que produce archivos idénticos se considera actualizada.
• link: Claude Code llena la entrada de caché del plugin con un enlace a cada entrada de nivel superior del directorio impreso y carga los archivos en su ubicación. No se copia nada, no se calcula el hash del contenido de los archivos y los límites de tamaño no se aplican. Úsalo para un directorio demasiado grande para copiar, como una exportación de un SDK generada.

Un plugin en modo link tiene estos requisitos:

• Mantén el directorio en su lugar: Claude Code carga el plugin a través de los enlaces en cada inicio, por lo que el directorio impreso debe permanecer donde está mientras el plugin siga instalado.
• Imprime una ruta diferente para indicar contenido nuevo: la versión proviene de la ruta real del directorio impreso y de sus entradas de nivel superior, no de los archivos que contienen.
• Mantén los enlaces simbólicos de nivel superior dentro del directorio: la instalación falla si una entrada de nivel superior es un enlace simbólico que apunta fuera del directorio impreso.
• Incluye node_modules: Claude Code omite la instalación de dependencias de paquetes de Node.js para un plugin en modo link, así que imprime un directorio que ya contenga los paquetes que el plugin necesita.
• Sesiones iniciadas dentro del directorio: una sesión iniciada en el directorio impreso o en cualquier lugar debajo de él no carga el plugin.
• No en Windows: Claude Code se niega a instalar un plugin en modo link en Windows. Declara "mode": "copy" allí.

Fuentes de marketplace

Una fuente de marketplace indica dónde Claude Code obtiene un marketplace.json. La CLI construye uno para usted cuando agrega un marketplace, y usted escribe uno en la configuración:

• claude plugin marketplace add: Claude Code construye la fuente a partir de la cadena que pasa.
• extraKnownMarketplaces: usted escribe la fuente en sí como el objeto source.
• strictKnownMarketplaces y blockedMarketplaces: los administradores escriben fuentes en estas dos listas de políticas. strictKnownMarketplaces es la lista de permitidos y blockedMarketplaces es la lista de bloqueados.

Los nombres de tipo url, git y github significan algo diferente en una fuente de marketplace que en una fuente de plugin:

La tabla enumera cada tipo de fuente de marketplace con sus campos, la entrada de claude plugin marketplace add que lo produce, y qué hace en cada una de las tres claves de configuración.

Campos por tipo

La tabla enumera cada campo de fuente de marketplace que tiene un predeterminado, una restricción o un significado específico de su tipo.

Valores de fuente válidos solo en listas de políticas

hostPattern, pathPattern, skills-dir y la forma owner/* de repo son válidos solo en las dos listas de políticas, strictKnownMarketplaces y blockedMarketplaces:

• hostPattern y pathPattern: expresiones regulares que Claude Code prueba contra una fuente antes de obtener de ella.
• skills-dir: no es una fuente. Si estableces strictKnownMarketplaces sin una entrada {"source": "skills-dir"}, los plugins del directorio de skills dejan de cargarse. Si bloqueas cualquier tipo de personalización con strictPluginOnlyCustomization, dejan de cargarse independientemente de que la entrada esté presente o no.
• owner/*: como un valor repo de github, coincide con cada repositorio bajo exactamente ese propietario de GitHub. Requiere Claude Code v2.1.223 o posterior.

Para el orden de coincidencia, la semántica exacta de ref y recetas, consulte Administrar plugins para su organización.

Objetos de fuente en la configuración

Un valor extraKnownMarketplaces es un mapa de nombre de marketplace a un objeto con source. Esta entrada registra un marketplace desde un repositorio git en su rama main:

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": {
        "source": "git",
        "url": "https://git.example.com/your-org/your-marketplace.git",
        "ref": "main"
      }
    }
  }
}

strictKnownMarketplaces y blockedMarketplaces son arrays de objetos de fuente. Esta lista de permitidos admite un propietario de GitHub y un host interno:

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "your-org/*" },
    { "source": "hostPattern", "hostPattern": "^git\\.example\\.com$" }
  ]
}

Mensajes de validación

claude plugin validate <path> toma la raíz del marketplace o el archivo marketplace en sí. Imprime errores y advertencias. Para códigos de salida y --strict, consulte plugin validate.

Un mensaje nombra una entrada de plugin por su índice, escrito como plugins.1.source o plugins[1].source.

Un mensaje prefijado con un índice de entrada y plugin.json →, como plugins[2] plugin.json →, es sobre los propios archivos de ese plugin. claude plugin validate reporta errores enumera esos mensajes con sus correcciones.

Las advertencias que mencionan nombres de banderas de Claude Desktop señalan nombres que Claude Desktop rechaza.

La tabla asigna mensajes de nivel de marketplace al campo sobre el que trata cada uno.

Entrada inválida en una fuente

Invalid input en un source significa que el objeto no coincidió con ningún tipo de fuente. Verifique estas causas:

• Un package npm que contiene ..
• Un tipo de source que no es uno de las fuentes de plugins
• Un tipo conocido con un campo obligatorio faltante o de tipo incorrecto, como github sin repo

Una ruta relativa que no comienza con ./, que no sea "." o un nombre desnudo bajo metadata.pluginRoot, falla con Invalid string: must start with "./". Antes de v2.1.285, imprimía Invalid input como las causas anteriores.

Fallos que la validación no detecta

claude plugin validate no reporta cada fallo. Un hooks de entrada escrito como una ruta de archivo o array aprueba la validación, y el error aparece solo cuando el plugin se carga, como describe Hooks en una entrada. Los errores al obtener un source también aparecen solo después de instalar, no en la validación.

claude plugin list muestra un plugin que falló al cargar con su error, y Solucionar problemas de plugins cubre las cadenas de tiempo de carga.

Próximos pasos

• Crear un marketplace: construya un marketplace a partir de estos campos e instale desde él localmente
• Alojar y mantener un marketplace: dónde poner el archivo y cómo los usuarios reciben cambios
• Referencia de manifiesto de plugin: los campos plugin.json que una entrada puede anular
• Administrar plugins para su organización: recetas de lista de permitidos y lista de bloqueados que usan estos valores de fuente