361* [Un error de acceso a GitHub en claude.ai](/docs/es/github-enterprise-server#marketplace-add-on-claude-ai-fails-with-a-github-access-error) significa que su propia cuenta de GitHub Enterprise aún no está conectada361* [Un error de acceso a GitHub en claude.ai](/docs/es/github-enterprise-server#marketplace-add-on-claude-ai-fails-with-a-github-access-error) significa que su propia cuenta de GitHub Enterprise aún no está conectada

362 362 

363<h2 id="install-a-plugin">363<h2 id="install-a-plugin">

364 Install a plugin364 Instalar un plugin

365</h2>365</h2>

366 366 

367Agregó un mercado y ejecutó una instalación, y la instalación se detuvo con un mensaje en lugar de instalar nada. Estas entradas cubren esos mensajes. También cubren los mensajes relacionados que aparecen más tarde en la pestaña `/plugin` **Errors**, o como una pestaña **Discover** vacía, cuando un plugin o su mercado no se puede encontrar, leer o confiar.367Agregaste un marketplace y ejecutaste una instalación, y la instalación se detuvo con un mensaje en lugar de instalar algo. Estas entradas cubren esos mensajes. También cubren los mensajes relacionados que aparecen más tarde en la pestaña **Errors** de `/plugin`, o como una pestaña **Discover** vacía, cuando no se puede encontrar, leer o confiar en un plugin o en su marketplace.

368 368 

369<h3 id="plugin-not-found-in-marketplace">369<h3 id="plugin-not-found-in-marketplace">

370 `Plugin "<name>" not found in marketplace "<marketplace>"`370 `Plugin "<name>" not found in marketplace "<marketplace>"`

371</h3>371</h3>

372 372 

373Ejecutó `/plugin install <name>@<marketplace>` o `claude plugin install <name>@<marketplace>`, y el nombre del plugin no está en la copia del catálogo de ese mercado en su máquina.373Ejecutaste `/plugin install <name>@<marketplace>` o `claude plugin install <name>@<marketplace>`, y el nombre del plugin no está en la copia del catálogo de ese marketplace que hay en tu máquina.

374 374 

375`claude plugin install` en su shell imprime el mismo mensaje cuando no ha agregado el mercado en absoluto. Si `claude plugin marketplace update <marketplace>` luego responde `Marketplace '<marketplace>' not found`, [agregue el mercado](#add-a-marketplace) primero.375`claude plugin install` en tu shell imprime el mismo mensaje cuando no has agregado el marketplace en absoluto. Si `claude plugin marketplace update <marketplace>` responde entonces `Marketplace '<marketplace>' not found`, primero [agrega el marketplace](#add-a-marketplace).

376 376 

377<h4 id="the-message-ends-with-a-refresh-hint">377<h4 id="the-message-ends-with-a-refresh-hint">

378 `not found in marketplace` with a refresh hint378 `not found in marketplace` con una sugerencia de actualización

379</h4>379</h4>

380 380 

381La sugerencia dice `Your local copy may be out of date — try claude plugin marketplace update <marketplace>` o `The marketplace couldn't be refreshed (...)`. Claude Code no actualizó el mercado antes de la búsqueda, como cuando está sin conexión, por lo que su copia del catálogo puede estar desactualizada. Actualice con el nombre del mercado, luego instale nuevamente:381La sugerencia dice `Your local copy may be out of date — try claude plugin marketplace update <marketplace>` o `The marketplace couldn't be refreshed (...)`. Claude Code no actualizó el marketplace antes de la búsqueda, por ejemplo cuando estás sin conexión, así que tu copia del catálogo puede estar desactualizada. Actualízalo con el nombre del marketplace y luego vuelve a instalar:

382 382 

383```text theme={null}383```text theme={null}

384/plugin marketplace update <marketplace>384/plugin marketplace update <marketplace>

385```385```

386 386 

387`claude plugin marketplace update` imprime `Successfully updated marketplace: <name>`, y `/plugin marketplace update` muestra `✔ Updated 1 marketplace`. Si la instalación reintentada imprime el mismo mensaje, verifique el nombre como [`not found in marketplace` with no hint](#the-message-has-no-hint) describe. [When Claude Code refreshes a marketplace before an install](/docs/es/plugins/loading#when-claude-code-refreshes-a-marketplace-before-an-install) enumera los otros casos donde la actualización no se ejecuta.387`claude plugin marketplace update` imprime `Successfully updated marketplace: <name>`, y `/plugin marketplace update` muestra `✔ Updated 1 marketplace`. Si la instalación reintentada imprime el mismo mensaje, revisa el nombre como se describe en [`not found in marketplace` sin sugerencia](#the-message-has-no-hint). [Cuándo Claude Code actualiza un marketplace antes de una instalación](/docs/es/plugins/loading#when-claude-code-refreshes-a-marketplace-before-an-install) enumera los otros casos en los que la actualización no se ejecuta.

388 388 

389<h4 id="the-message-has-no-hint">389<h4 id="the-message-has-no-hint">

390 `not found in marketplace` with no hint390 `not found in marketplace` sin sugerencia

391</h4>391</h4>

392 392 

393El nombre es el problema más probable. Abra `/plugin`, vaya a **Discover**, y copie el nombre de la lista.393Lo más probable es que el problema sea el nombre. Abre `/plugin`, ve a **Discover** y copia el nombre de la lista.

394 394 

395Antes de v2.1.232, Claude Code actualizaba el mercado nombrado solo después de que la búsqueda fallara, y solo cuando la actualización automática estaba activada para él.395Antes de v2.1.232, Claude Code actualizaba el marketplace indicado solo después de que la búsqueda fallara, y solo cuando tenía la actualización automática activada.

396 396 

397<h3 id="plugin-not-found-in-any-marketplace">397<h3 id="plugin-not-found-in-any-marketplace">

398 `Plugin "<name>" not found in any marketplace`398 `Plugin "<name>" not found in any marketplace`

399</h3>399</h3>

400 400 

401Ejecutó `/plugin install <name>` sin `@marketplace`, y ningún mercado registrado tiene ese plugin. `claude plugin install <name>` informa `Plugin "<name>" not found in any configured marketplace`.401Ejecutaste `/plugin install <name>` sin `@marketplace`, y ningún marketplace registrado tiene ese plugin. `claude plugin install <name>` informa `Plugin "<name>" not found in any configured marketplace`.

402 402 

403Sin un nombre de mercado, `claude plugin install` busca en los catálogos que ya tiene y no los actualiza primero, y `/plugin install` actualiza solo los mercados que tienen la actualización automática activada. Nombre el mercado, y Claude Code lo actualiza antes de buscar el plugin:403Sin un nombre de marketplace, `claude plugin install` busca en los catálogos que ya tiene y no los actualiza antes, y `/plugin install` actualiza solo los marketplaces que tienen la actualización automática activada. Indica el marketplace y Claude Code lo actualizará antes de buscar el plugin:

404 404 

405```text theme={null}405```text theme={null}

406/plugin install <name>@<marketplace>406/plugin install <name>@<marketplace>

407```407```

408 408 

409Cuando la instalación funciona, ve `✓ Installed <plugin>.` en una sesión, o `Successfully installed plugin: <plugin>@<marketplace>` desde `claude plugin install`.409Cuando la instalación funciona, ves `✓ Installed <plugin>.` en una sesión, o `Successfully installed plugin: <plugin>@<marketplace>` desde `claude plugin install`.

410 410 

411Si no sabe qué mercado enumera el plugin, ejecute `/plugin marketplace list` para los mercados que tiene, y navegue por **Discover** en `/plugin` para el nombre del plugin.411Si no sabes qué marketplace incluye el plugin, ejecuta `/plugin marketplace list` para ver los marketplaces que tienes, y busca el nombre del plugin en **Discover** dentro de `/plugin`.

412 412 

413<h3 id="plugin-is-already-installed-globally">413<h3 id="plugin-is-already-installed-globally">

414 `Plugin '<name>@<marketplace>' is already installed globally`414 `Plugin '<name>@<marketplace>' is already installed globally`

415</h3>415</h3>

416 416 

417Ejecutó `/plugin install` para un plugin que ya está instalado en el scope de usuario o por configuración administrada, y Claude Code rechazó con `Use '/plugin' to manage existing plugins.` Si escribió el nombre del plugin sin `@<marketplace>`, el mensaje omite `globally`.417Ejecutaste `/plugin install` para un plugin que ya está instalado en el alcance de usuario o mediante la configuración administrada, y Claude Code lo rechazó con `Use '/plugin' to manage existing plugins.` Si escribiste el nombre del plugin sin `@<marketplace>`, el mensaje omite `globally`.

418 418 

419El plugin ya está disponible en cada proyecto, por lo que no hay nada que agregar. Para cambiar su [scope](/docs/es/plugins/install), habilitarlo o deshabilitarlo, o configurarlo, abra `/plugin` y vaya a **Installed**.419El plugin ya está disponible en todos los proyectos, así que no hay nada que agregar. Para cambiar su [alcance](/docs/es/plugins/install), habilitarlo o deshabilitarlo, o configurarlo, abre `/plugin` y ve a **Installed**.

420 420 

421Un plugin instalado solo en el scope de proyecto o local no activa este mensaje. Claude Code le permite instalarlo también en el scope de usuario, por lo que está disponible en otros proyectos.421Un plugin instalado solo en el alcance de proyecto o local no activa este mensaje. Claude Code te permite instalarlo también en el alcance de usuario, para que esté disponible en otros proyectos.

422 422 

423`claude plugin install` en su shell imprime un mensaje diferente. Para un plugin ya instalado en el scope de destino, imprime `Plugin "<name>@<marketplace>" is already installed (scope: user)` y sale con 0. Si su directorio de caché falta, el mismo comando lo descarga nuevamente.423`claude plugin install` en tu shell imprime un mensaje diferente. Para un plugin ya instalado en el alcance de destino, imprime `Plugin "<name>@<marketplace>" is already installed (scope: user)` y sale con 0. Si falta su directorio de caché, el mismo comando lo vuelve a descargar.

424 424 

425<h3 id="plugin-would-share-its-folder">425<h3 id="plugin-would-share-its-folder">

426 `"<plugin>" was not installed: it would share its folder with "<other>"`426 `"<plugin>" was not installed: it would share its folder with "<other>"`

427</h3>427</h3>

428 428 

429Instaló un plugin a través de `claude plugin install`, `/plugin`, o una sugerencia de instalación en una sesión, y Claude Code lo rechazó con esta línea, o con `would share its saved data with`.429Instalaste un plugin mediante `claude plugin install`, `/plugin` o una sugerencia de instalación en una sesión, y Claude Code lo rechazó con esta línea, o con `would share its saved data with`.

430 430 

431El id del plugin rechazado y el id de un plugin instalado se asignan a la misma carpeta en el disco: son iguales una vez que `.` y `@` se escriben como `-`. En macOS y Windows, los ids que difieren solo en mayúsculas se asignan a la misma carpeta también. Instalar ambos pondría los archivos de un plugin en la carpeta del otro, por lo que Claude Code rechaza y el plugin instalado mantiene sus archivos.431El id del plugin rechazado y el id de un plugin instalado corresponden a la misma carpeta en el disco: son iguales una vez que `.` y `@` se escriben como `-`. En macOS y Windows, los ids que difieren solo en mayúsculas también corresponden a la misma carpeta. Instalar ambos pondría los archivos de un plugin en la carpeta del otro, así que Claude Code lo rechaza y el plugin instalado conserva sus archivos.

432 432 

433El mensaje nombra la salida:433El mensaje indica la salida:

434 434 

435* **El otro plugin está instalado**: el mensaje dice `Only one of the two can be installed.` y nombra el comando `claude plugin uninstall`, o el paso de desinstalación en `/plugin`, que elimina el otro plugin. Ejecútelo, luego instale nuevamente. Para lo que la desinstalación elimina, vea [What an uninstall deletes and keeps](/docs/es/plugins/cli-reference#what-an-uninstall-deletes-and-keeps).435* **El otro plugin está instalado**: el mensaje dice `Only one of the two can be installed.` e indica el comando `claude plugin uninstall`, o el paso de desinstalación en `/plugin`, que elimina el otro plugin. Ejecútalo y luego vuelve a instalar. Para saber qué elimina la desinstalación, consulta [Qué elimina y qué conserva una desinstalación](/docs/es/plugins/cli-reference#what-an-uninstall-deletes-and-keeps).

436* **Ambos ids llegan en una instalación**, como un plugin y una dependencia que necesita: ningún orden de instalación ayuda. Solo un mantenedor del mercado que enumera los dos plugins puede arreglarlo, renombrando uno de ellos. Cuando los dos provienen de diferentes mercados, un mantenedor de cualquiera de ellos puede.436* **Ambos ids llegan en una sola instalación**, como un plugin y una dependencia que necesita: ningún orden de instalación ayuda. Solo un mantenedor del marketplace que incluye los dos plugins puede arreglarlo, cambiando el nombre de uno de ellos. Cuando los dos provienen de marketplaces diferentes, puede hacerlo un mantenedor de cualquiera de ellos.

437 437 

438<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">438<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">

439 `This plugin uses a source type your Claude Code version does not support`439 `This plugin uses a source type your Claude Code version does not support`

440</h3>440</h3>

441 441 

442Instaló un plugin cuya entrada de mercado usa un tipo de fuente que esta versión de Claude Code no puede obtener, y Claude Code se detuvo con este mensaje y `Update Claude Code and try again.`442Instalaste un plugin cuya entrada en el marketplace usa un tipo de fuente que esta versión de Claude Code no puede obtener, y Claude Code se detuvo con este mensaje y `Update Claude Code and try again.`

443 443 

444Actualice Claude Code, luego reintente la instalación. Los tipos de fuente están en la [marketplace reference](/docs/es/plugins/marketplace-reference).444Actualiza Claude Code y luego reintenta la instalación. Los tipos de fuente están en la [referencia de marketplaces](/docs/es/plugins/marketplace-reference).

445 445 

446<h3 id="plugin-archive-integrity-check-failed">446<h3 id="plugin-archive-integrity-check-failed">

447 `Plugin archive integrity check failed`447 `Plugin archive integrity check failed`

448</h3>448</h3>

449 449 

450Instaló un plugin que se distribuye como un archivo zip, y Claude Code lo rechazó con esta línea y `The archive was not installed.` La entrada de mercado del plugin usa una fuente [`archive`](/docs/es/plugins/marketplace-reference) con un pin `sha256`, y el resumen del archivo descargado no coincide con el pin.450Instalaste un plugin que se distribuye como archivo zip, y Claude Code lo rechazó con esta línea y `The archive was not installed.` La entrada del plugin en el marketplace usa una [fuente `archive`](/docs/es/plugins/marketplace-reference) con un `sha256` fijado, y el hash del archivo descargado no coincide con el valor fijado.

451 451 

452El mensaje completo se ve así:452El mensaje completo se ve así:

453 453 

455Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.455Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.

456```456```

457 457 

458La solución difiere para el editor y el instalador:458La solución es distinta para quien publica y para quien instala:

459 459 

460* **Usted publica el plugin**: recompute el resumen del archivo exacto que sirve la URL y actualice el `sha256` en la entrada del mercado. Use `shasum -a 256 my-plugin.zip`, o `Get-FileHash -Algorithm SHA256 my-plugin.zip` en PowerShell460* **Publicas el plugin**: vuelve a calcular el hash del archivo exacto que sirve la URL y actualiza el `sha256` en la entrada del marketplace. Usa `shasum -a 256 my-plugin.zip`, o `Get-FileHash -Algorithm SHA256 my-plugin.zip` en PowerShell

461* **Usted instala el plugin**: ejecute `/plugin marketplace update <name>` en una sesión para actualizar el catálogo en caso de que la entrada haya sido corregida, luego reintente la instalación. Si los resúmenes aún no coinciden después de la actualización, pida al propietario del mercado qué archivo fijaron antes de instalar461* **Instalas el plugin**: ejecuta `/plugin marketplace update <name>` en una sesión para actualizar el catálogo por si la entrada se corrigió, y luego reintenta la instalación. Si los hashes siguen sin coincidir después de la actualización, pregúntale al propietario del marketplace qué archivo fijó antes de instalar

462 

463<h3 id="an-npm-plugin-source-must-name-a-registry-package">

464 `An npm plugin source must name a registry package`

465</h3>

466 

467Un plugin cuya entrada en el marketplace usa una [fuente `npm`](/docs/es/plugins/marketplace-reference#npm-plugin-source) no se pudo instalar, actualizar o cargar, y el mensaje incluye esta oración. Claude Code revisó el valor `package` de la entrada antes de obtener nada y lo rechazó. El mensaje indica el valor y el motivo:

468 

469```text theme={null}

470"github:acme/formatter" was not installed: it is not an http or https link. An npm plugin source must name a registry package (name or name@version) or link to a tarball file. For a plugin in a git repository, use a "github", "url" or "git-subdir" source.

471```

472 

473El propietario del marketplace tiene que cambiar la entrada:

474 

475* **Si eres tú**: cambia `package` a un valor que acepte la [referencia de la fuente de plugins npm](/docs/es/plugins/marketplace-reference#npm-plugin-source), o cambia la entrada a una fuente `github`, `url` o `git-subdir`

476* **Si no eres tú**: informa el mensaje al propietario del marketplace

462 477 

463<h3 id="marketplace-is-registered-from-an-untrusted-source">478<h3 id="marketplace-is-registered-from-an-untrusted-source">

464 `Marketplace "<name>" is registered from an untrusted source`479 `Marketplace "<name>" is registered from an untrusted source`

465</h3>480</h3>

466 481 

467Un mercado que agregó anteriormente dejó de cargarse, y también sus plugins. Esta línea aparece en la pestaña `/plugin` **Errors** o en la siguiente actualización.482Un marketplace que agregaste antes dejó de cargarse, y también sus plugins. Esta línea aparece en la pestaña **Errors** de `/plugin` o en la siguiente actualización.

468 483 

469El mercado está registrado bajo un nombre que está [reservado para mercados oficiales de Anthropic](/docs/es/plugins/marketplace-reference), pero su fuente registrada no es un repositorio de GitHub `anthropics`. Los nombres reservados se re-verifican cada vez que un mercado se carga o se actualiza, por lo que el mercado y los plugins instalados desde él dejan de cargarse.484El marketplace está registrado con un nombre [reservado para los marketplaces oficiales de Anthropic](/docs/es/plugins/marketplace-reference), pero su fuente registrada no es un repositorio de GitHub de `anthropics`. Los nombres reservados se vuelven a comprobar cada vez que un marketplace se carga o se actualiza, por lo que el marketplace y los plugins instalados desde él dejan de cargarse.

470 485 

471El mensaje completo nombra el nombre reservado y la solución:486El mensaje completo indica el nombre reservado y la solución:

472 487 

473```text theme={null}488```text theme={null}

474Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.489Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

475```490```

476 491 

477La solución difiere para usuarios y editores:492La solución es distinta para usuarios y para quienes publican:

493 

494* **Usas el marketplace**: en tu shell, ejecuta `claude plugin marketplace remove <name>` y luego vuelve a agregar el marketplace desde el repositorio oficial de `github.com/anthropics`

495* **Publicas un marketplace de terceros que usaba el nombre antes de que se reservara**: cámbiale el nombre y pide a los usuarios que lo vuelvan a agregar desde tu fuente

496 

497Antes de v2.1.205, Claude Code comprobaba el nombre solo cuando agregabas el marketplace, así que una entrada registrada antes de que su nombre se reservara seguía cargándose.

498 

499<h3 id="marketplace-is-added-but-ignored">

500 `Marketplace "<name>" is added but ignored`

501</h3>

502 

503El marketplace tiene una entrada en `~/.claude/plugins/known_marketplaces.json`, pero la entrada no pasó una comprobación que Claude Code ejecuta cada vez que lee ese archivo, por lo que el marketplace y los plugins instalados desde él dejan de cargarse. En tu shell, `claude plugin list` informa cada plugin afectado con una línea que indica el motivo y la solución:

504 

505```text theme={null}

506Marketplace team-tools is added but ignored. Its location is on a network drive, has "." or ".." in its path, or couldn't be checked. Re-add the marketplace (one added from a folder or file must be re-added from a copy on this computer), or, to trust a folder on a network drive, declare it under extraKnownMarketplaces in user or managed settings.

507```

508 

509En una sesión, la pestaña **Errors** de `/plugin` pone el nombre del marketplace entre comillas, termina la línea después del motivo y muestra la solución en la línea de abajo.

510 

511La oración que sigue a `is added but ignored` indica la comprobación que la entrada no pasó:

512 

513* `Its location is on a network drive, has "." or ".." in its path, or couldn't be checked`, o la misma oración sobre `The folder or file it was added from`: el directorio del marketplace, o la ruta local desde la que se agregó, está en una ubicación de red, tiene un segmento `.` o `..` en su ruta, o no se pudo comprobar

514* `Its git URL can't be used: <reason>` o `Its URL can't be read as an https:// or http:// address`: la URL de origen registrada en la entrada es una desde la que Claude Code se niega a clonar u obtener

515* `Its source doesn't match its extraKnownMarketplaces entry in user or managed settings`: la entrada no coincide con la declaración de [`extraKnownMarketplaces`](/docs/es/settings-reference#extraknownmarketplaces) del mismo nombre

516 

517Cuando `(see the debug log)` sigue a `is added but ignored` en lugar de un motivo, Claude Code rechaza el nombre del marketplace, por ejemplo [otra grafía de un nombre reservado](/docs/es/errors#marketplace-name-is-another-spelling-of-a-reserved-name). El [registro de depuración](/docs/es/debug-your-config) indica la entrada.

478 518 

479* **Usted usa el mercado**: en su shell, ejecute `claude plugin marketplace remove <name>`, luego agregue el mercado nuevamente desde el repositorio oficial `github.com/anthropics`519**Qué hacer:**

480* **Usted publica un mercado de terceros que usó el nombre antes de que se reservara**: cámbielo de nombre y pida a los usuarios que lo vuelvan a agregar desde su fuente

481 520 

482Antes de v2.1.205, Claude Code verificaba el nombre solo cuando agregaba el mercado, por lo que una entrada registrada antes de que su nombre se reservara seguía cargándose.521* Sigue la solución del mensaje. En tu shell, ejecuta `claude plugin marketplace remove <name>`, luego vuelve a agregar el marketplace desde una fuente compatible o una ruta local y reinstala sus plugins, que el comando de eliminación desinstala. El comando de eliminación funciona con una entrada ignorada

522* Para mantener un marketplace en una ubicación de red, decláralo en [`extraKnownMarketplaces`](/docs/es/settings-reference#extraknownmarketplaces) en tu configuración de usuario o en la configuración administrada; una declaración en el `.claude/settings.json` o `.claude/settings.local.json` de un repositorio no cuenta

523* Para una fuente que difiere de su declaración en la configuración, vuelve a agregar el marketplace desde la fuente declarada o cambia la declaración. `claude plugin marketplace add` rechaza la misma discrepancia; consulta [la entrada correspondiente de `Cannot add marketplace`](#cannot-add-marketplace-source-doesnt-match)

524* Para un nombre rechazado, elimina el marketplace usando el comando que aparece después de `Remove it:` cuando la línea lo incluye; volver a agregarlo con el mismo nombre se rechaza de nuevo

525 

526Antes de v2.1.286, fuera cual fuera el motivo, `claude plugin list` informaba un marketplace así como `Marketplace <name> not found`, y la pestaña **Errors** de `/plugin` lo informaba como `Marketplace "<name>" is registered but was refused (see the debug log)`. El motivo solo aparecía en el registro de depuración. En v2.1.286, las oraciones del motivo y de la solución usaban otra redacción, como `Its recorded location is network-shaped or unclassifiable (never probed)`.

483 527 

484<h3 id="plugin-has-a-corrupt-manifest-file-or-has-an-invalid-manifest-file">528<h3 id="plugin-has-a-corrupt-manifest-file-or-has-an-invalid-manifest-file">

485 `Plugin <name> has a corrupt manifest file` or `has an invalid manifest file`529 `Plugin <name> has a corrupt manifest file` o `has an invalid manifest file`

486</h3>530</h3>

487 531 

488Claude Code obtuvo el plugin, luego falló al leer su `.claude-plugin/plugin.json`. En el shell, el `<name>` en esta línea puede ser un nombre de directorio temporal; el prefijo `Failed to install plugin "<name>@<marketplace>"` lleva el nombre real del plugin. La redacción dice qué verificación falló:532Claude Code obtuvo el plugin y luego no pudo leer su `.claude-plugin/plugin.json`. En el shell, el `<name>` de esta línea puede ser un nombre de directorio temporal; el prefijo `Failed to install plugin "<name>@<marketplace>"` lleva el nombre real del plugin. La redacción indica qué comprobación falló:

489 533 

490* **`corrupt manifest file`, seguido de `JSON parse error:`**: el archivo no es JSON válido534* **`corrupt manifest file`, seguido de `JSON parse error:`**: el archivo no es JSON válido

491* **`invalid manifest file`, seguido de `Validation errors:`**: el archivo se analiza pero falla el esquema, como `name: Invalid input` para un campo requerido faltante535* **`invalid manifest file`, seguido de `Validation errors:`**: el archivo se analiza pero no cumple el esquema, por ejemplo `name: Invalid input` cuando falta un campo obligatorio

492 536 

493`claude plugin install` informa cualquiera como `Failed to install plugin "<name>@<marketplace>":` y sale con código 1.537`claude plugin install` informa cualquiera de los dos como `Failed to install plugin "<name>@<marketplace>":` y sale con código 1.

494 538 

495El autor del plugin tiene que corregir el archivo, y el plugin no se puede instalar hasta entonces:539El autor del plugin tiene que corregir el archivo, y el plugin no se puede instalar hasta entonces:

496 540 

497* **Si eso es usted**: ejecute `claude plugin validate <plugin-directory>` en su shell para ver el mismo error con la ruta ofensiva, luego corrija el archivo541* **Si eres tú**: ejecuta `claude plugin validate <plugin-directory>` en tu shell para ver el mismo error con la ruta problemática y luego corrige el archivo

498* **Si no es usted**: informe el mensaje al propietario del mercado542* **Si no eres tú**: informa el mensaje al propietario del marketplace

499 543 

500<h3 id="plugin-directory-not-found-at-path">544<h3 id="plugin-directory-not-found-at-path">

501 `Plugin directory not found at path: <path>`545 `Plugin directory not found at path: <path>`

502</h3>546</h3>

503 547 

504La pestaña **Errors** en `/plugin` muestra esto para un plugin habilitado que su mercado enumera por una ruta relativa, como `./plugins/my-plugin`, cuando no existe ningún directorio en esa ruta dentro del mercado. Si mantiene el mercado, corrija la ruta `source` de la entrada o restaure la carpeta. De lo contrario, informe el mensaje al propietario del mercado.548La pestaña **Errors** de `/plugin` muestra esto para un plugin habilitado que su marketplace incluye mediante una ruta relativa, como `./plugins/my-plugin`, cuando no existe ningún directorio en esa ruta dentro del marketplace. Si mantienes el marketplace, corrige la ruta `source` de la entrada o restaura la carpeta. De lo contrario, informa el mensaje al propietario del marketplace.

505 549 

506`Marketplace directory not found at path: <path>` significa que el directorio del mercado en sí falta. Para un mercado que agregó desde una ruta local, ese directorio se movió o se eliminó. Restáurelo, o elimine el mercado y agréguelo nuevamente desde su nueva ubicación.550`Marketplace directory not found at path: <path>` significa, en cambio, que falta el directorio del propio marketplace. En un marketplace que agregaste desde una ruta local, ese directorio se movió o se eliminó. Restáuralo, o elimina el marketplace y vuelve a agregarlo desde su nueva ubicación.

507 551 

508<h3 id="no-plugins-available-or-no-marketplaces-configured">552<h3 id="no-plugins-available-or-no-marketplaces-configured">

509 `No plugins available` or `No marketplaces configured`553 `No plugins available` o `No marketplaces configured`

510</h3>554</h3>

511 555 

512Abrió `/plugin` y la pestaña **Discover** está vacía, o `claude plugin marketplace list` imprimió `No marketplaces configured`.556Abriste `/plugin` y la pestaña **Discover** está vacía, o `claude plugin marketplace list` imprimió `No marketplaces configured`.

513 557 

514Ningún mercado está registrado, por lo que no hay catálogo para mostrar. En una sesión, agregue el mercado oficial, `anthropics/claude-plugins-official`:558No hay ningún marketplace registrado, así que no hay catálogo que mostrar. En una sesión, agrega el marketplace oficial, `anthropics/claude-plugins-official`:

515 559 

516```text theme={null}560```text theme={null}

517/plugin marketplace add anthropics/claude-plugins-official561/plugin marketplace add anthropics/claude-plugins-official

518```562```

519 563 

520Claude Code imprime `Successfully added marketplace: claude-plugins-official`, y **Discover** enumera sus plugins. La página [Anthropic marketplaces](/docs/es/plugins/anthropic-marketplaces) enumera los otros mercados que puede agregar.564Claude Code imprime `Successfully added marketplace: claude-plugins-official`, y **Discover** muestra sus plugins. La página de [marketplaces de Anthropic](/docs/es/plugins/anthropic-marketplaces) enumera los otros marketplaces que puedes agregar.

521 565 

522<h3 id="marketplace-is-already-added-from-a-different-source">566<h3 id="marketplace-is-already-added-from-a-different-source">

523 `Marketplace "<name>" is already added from a different source`567 `Marketplace "<name>" is already added from a different source`

524</h3>568</h3>

525 569 

526Confirmó agregar un mercado a través de [`/plugin install <plugin> --marketplace <source>`](/docs/es/plugins/install#add-a-marketplace-and-install-in-one-command), y el catálogo que Claude Code obtuvo de esa fuente tiene el mismo nombre que un mercado que ya agregó desde una fuente diferente. Claude Code mantiene el mercado existente en lugar de reemplazarlo, y el plugin no se instala.570Confirmaste agregar un marketplace mediante [`/plugin install <plugin> --marketplace <source>`](/docs/es/plugins/install#add-a-marketplace-and-install-in-one-command), y el catálogo que Claude Code obtuvo de esa fuente tiene el mismo nombre que un marketplace que ya agregaste desde una fuente diferente. Claude Code conserva el marketplace existente en lugar de reemplazarlo, y el plugin no se instala.

527 571 

528El mensaje completo se ve así:572El mensaje completo se ve así:

529 573 

531Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.575Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

532```576```

533 577 

534Elija qué fuente desea:578Elige qué fuente quieres:

535 579 

536* **El mercado que ya agregó**: instale desde él por nombre con `/plugin install <plugin>@<name>`580* **El marketplace que ya agregaste**: instala desde él por nombre con `/plugin install <plugin>@<name>`

537* **La nueva fuente**: ejecute `/plugin marketplace remove <name>`, luego reintente la instalación581* **La nueva fuente**: ejecuta `/plugin marketplace remove <name>` y luego reintenta la instalación

538 582 

539<h3 id="cannot-add-marketplace-its-network-source-differs">583<h3 id="cannot-add-marketplace-source-doesnt-match">

540 `Cannot add marketplace "<name>": its network source differs from the one declared for it in settings`584 `Cannot add marketplace "<name>": its source doesn't match its extraKnownMarketplaces entry in user or managed settings`

541</h3>585</h3>

542 586 

543Ejecutó `marketplace add`, y el catálogo en esa fuente tiene el mismo nombre que un mercado que un archivo de configuración ya declara bajo [`extraKnownMarketplaces`](/docs/es/settings-reference#extraknownmarketplaces) con una fuente diferente. Claude Code rechaza la adición y no registra nada.587Agregaste un marketplace, y el `name` de su `marketplace.json` ya tiene una entrada de [`extraKnownMarketplaces`](/docs/es/settings-reference#extraknownmarketplaces) en tu configuración de usuario o en la configuración administrada. La fuente que indicaste difiere de la que incluye esa entrada, así que Claude Code rechaza la adición y no registra nada.

588 

589Dos fuentes coinciden cuando tienen el mismo tipo y el mismo valor en cada campo. Una entrada que establece un `ref` que no pasaste cuenta como diferente. Una entrada `github` también cuenta como diferente cuando indicaste el repositorio como una URL `https://github.com/`, porque Claude Code registra esa URL como una [fuente `git`](/docs/es/plugins/marketplace-reference#marketplace-sources). Haz una de estas cosas:

590 

591* **Usar la fuente declarada**: Claude Code [registra por sí solo los marketplaces declarados en la configuración](/docs/es/settings-reference#extraknownmarketplaces), así que primero ejecuta `/plugin marketplace list` en una sesión. Si la lista muestra el nombre, el marketplace ya está registrado y no hay nada que agregar.

592 

593 Si la lista no lo muestra, agrégalo con la fuente escrita tal como la escribe la entrada. Para una entrada cuyo objeto `source` es `{ "source": "github", "repo": "acme-corp/claude-plugins", "ref": "v1.2.0" }`, ejecuta esto:

594 

595 ```text theme={null}

596 /plugin marketplace add acme-corp/claude-plugins#v1.2.0

597 ```

544 598 

545El mensaje termina con la solución: la fuente debe coincidir con la que se declara para este nombre en la configuración, o cambia la declaración. Compare la fuente que pasó contra la entrada `extraKnownMarketplaces` para ese nombre, incluida su `ref`, `path`, y `headers`, luego haga uno de estos:599* **Usar la nueva fuente**: edita o elimina la entrada de `extraKnownMarketplaces` y luego vuelve a agregar el marketplace. Si la declara la configuración administrada, pídeselo a tu administrador

546 600 

547* **Use la fuente declarada**: agregue el mercado desde la fuente que la entrada de configuración nombra601Antes de v2.1.287, el mensaje decía `Cannot add marketplace "<name>": its network source differs from the one declared for it in settings (kind, target, or a fetch-shaping field such as headers / ref / path / sparsePaths)`.

548* **Use la nueva fuente**: edite o elimine la entrada `extraKnownMarketplaces`, luego agregue el mercado nuevamente. Si la configuración administrada la declara, pida a su administrador

549 602 

550<h3 id="failed-to-install-from-the-plugin-menu">603<h3 id="failed-to-install-from-the-plugin-menu">

551 `Failed to install: <plugin> (<reason>)`604 `Failed to install: <plugin> (<reason>)`

552</h3>605</h3>

553 606 

554Seleccionó plugins para instalar en el menú `/plugin`, ninguno de ellos se instaló, y el menú se cerró con este resumen de lo que falló.607Seleccionaste plugins para instalar en el menú de `/plugin`, ninguno se instaló y el menú se cerró con este resumen de lo que falló.

555 608 

556Algunas razones, como la salida de git después de un clonado fallido, muestran solo su primera línea. Cuando tal razón fue acortada, el resumen termina con `Installing a plugin from its details (Enter) in /plugin shows its full error.`609Algunos motivos, como la salida de git tras una clonación fallida, muestran solo su primera línea. Cuando un motivo así se acortó, el resumen termina con `Installing a plugin from its details (Enter) in /plugin shows its full error.`

557 610 

558Qué hacer depende de si el resumen acortó la razón:611Qué hacer depende de si el resumen acortó el motivo:

559 612 

560* Corrija lo que la razón entre paréntesis nombra613* Corrige lo que indica el motivo entre paréntesis

561* Cuando la razón fue acortada, ejecute `/plugin`, seleccione el plugin en la pestaña **Discover**, y presione **Enter** para instalarlo desde sus detalles. Si la instalación falla allí, la vista de detalles muestra el error completo614* Cuando el motivo se acortó, ejecuta `/plugin`, selecciona el plugin en la pestaña **Discover** y presiona **Enter** para instalarlo desde sus detalles. Si la instalación falla ahí, la vista de detalles muestra el error completo

562 615 

563<h3 id="could-not-move-the-new-copy-of-this-plugin-version">616<h3 id="could-not-move-the-new-copy-of-this-plugin-version">

564 `Could not move the new copy of this plugin version into <path>`617 `Could not move the new copy of this plugin version into <path>`

565</h3>618</h3>

566 619 

567Cuando instala un plugin, Claude Code descarga una copia fresca de sus archivos y la mueve a la carpeta de esa versión en la [plugin cache](/docs/es/plugins/loading#find-plugins-on-disk). Este mensaje significa que el movimiento falló, generalmente porque otro programa estaba usando la carpeta mientras se ejecutaba la instalación. El código del sistema de archivos aparece entre paréntesis:620Cuando instalas un plugin, Claude Code descarga una copia nueva de sus archivos y la mueve a la carpeta de esa versión en la [caché de plugins](/docs/es/plugins/loading#find-plugins-on-disk). Este mensaje significa que el movimiento falló, normalmente porque otro programa estaba usando la carpeta mientras se ejecutaba la instalación. El código del sistema de archivos aparece entre paréntesis:

568 621 

569```text theme={null}622```text theme={null}

570Could not move the new copy of this plugin version into /home/user/.claude/plugins/cache/acme-tools/formatter/1.2.0: the new copy or the version folder stayed busy while the install ran (ENOTEMPTY) — usually a scanner still reading the freshly downloaded files, another program using that folder, or another process re-creating it. The previously installed copy was moved back. Run the install again once other Claude Code sessions or programs using that folder have finished.623Could not move the new copy of this plugin version into /home/user/.claude/plugins/cache/acme-tools/formatter/1.2.0: the new copy or the version folder stayed busy while the install ran (ENOTEMPTY) — usually a scanner still reading the freshly downloaded files, another program using that folder, or another process re-creating it. The previously installed copy was moved back. Run the install again once other Claude Code sessions or programs using that folder have finished.

571```624```

572 625 

573El mensaje dice qué sucedió con la copia que estaba instalada antes, lo que le dice si el plugin aún funciona:626El mensaje indica qué pasó con la copia que estaba instalada antes, lo que te dice si el plugin sigue funcionando:

574 627 

575* `The previously installed copy was moved back`: la versión que tenía aún está instalada628* `The previously installed copy was moved back`: la versión que tenías sigue instalada

576* `had to be removed first`, `was not moved back`, o `could not be moved back`: esa versión del plugin no está instalada hasta que una instalación tenga éxito629* `had to be removed first`, `was not moved back` o `could not be moved back`: esa versión del plugin no está instalada hasta que una instalación tenga éxito

577* Sin tal oración: no había una copia anterior, por lo que la versión aún no está instalada630* Ninguna oración de ese tipo: no había una copia anterior, así que la versión todavía no está instalada

578 631 

579En Windows, cuando otro programa mantiene la copia instalada en sí, el mensaje en su lugar dice que esa copia `could not be replaced` y que `It was not replaced and the new copy was discarded`, por lo que la versión que tenía aún está instalada.632En Windows, cuando otro programa retiene la propia copia instalada, el mensaje dice en cambio que esa copia `could not be replaced` y que `It was not replaced and the new copy was discarded`, así que la versión que tenías sigue instalada.

580 633 

581Una lista `Left on disk` nombra carpetas apartadas dentro de la caché. Una instalación posterior de esa versión o una limpieza de caché de plugins las elimina, por lo que no necesita eliminarlas.634Una lista `Left on disk` indica carpetas apartadas dentro de la caché. Una instalación posterior de esa versión o una limpieza de la caché de plugins las elimina, así que no necesitas borrarlas.

582 635 

583Para corregir la instalación:636Para corregir la instalación:

584 637 

585* Cierre otras sesiones de Claude Code, editores y terminales que estén usando la carpeta del plugin bajo `~/.claude/plugins/cache`, luego ejecute la instalación nuevamente638* Cierra otras sesiones de Claude Code, editores y terminales que estén usando la carpeta del plugin en `~/.claude/plugins/cache` y luego vuelve a ejecutar la instalación

586* Cuando el mensaje dice verificar los permisos de la carpeta de caché de plugins, restaure su permiso de escritura en la carpeta que nombra y libere espacio en disco, luego ejecute la instalación nuevamente639* Cuando el mensaje indique revisar los permisos de la carpeta de la caché de plugins, restaura tu permiso de escritura en la carpeta que indica y libera espacio en disco, y luego vuelve a ejecutar la instalación

587 640 

588<h3 id="dependency-errors">641<h3 id="dependency-errors">

589 Dependency errors642 Errores de dependencias

590</h3>643</h3>

591 644 

592Un plugin que declara dependencias puede fallar al instalar, o instalar y permanecer deshabilitado, cuando una dependencia no se puede satisfacer. El mensaje lo alcanza en el momento de la instalación o en el momento de la carga:645Un plugin que declara dependencias puede no instalarse, o instalarse y quedar deshabilitado, cuando una dependencia no se puede satisfacer. El mensaje te llega en el momento de la instalación o en el momento de la carga:

593 646 

594* **Durante la instalación**: el rechazo regresa como el mensaje de error de la instalación647* **Durante la instalación**: el rechazo se devuelve como el mensaje de error de la instalación

595* **Cuando el plugin se carga**: el problema aparece en `claude plugin list` y la pestaña `/plugin` **Errors**, y Claude Code mantiene el plugin afectado deshabilitado hasta que lo resuelva648* **Cuando el plugin se carga**: el problema aparece en `claude plugin list` y en la pestaña **Errors** de `/plugin`, y Claude Code mantiene deshabilitado el plugin afectado hasta que lo resuelvas

596 649 

597La tabla enumera cada mensaje y su solución. Para declarar dependencias como autor, vea [Plugin dependencies](/docs/es/plugins/dependencies).650La tabla enumera cada mensaje y su solución. Para declarar dependencias como autor, consulta [Dependencias de plugins](/docs/es/plugins/dependencies).

598 651 

599| Mensaje | Significado | Cómo resolver |652| Mensaje | Significado | Cómo resolverlo |

600| :- | :- | :- |653| :- | :- | :- |

601| `Dependency "<dep>" is not installed` | Una dependencia declarada no está instalada. | Instálela en su shell con `claude plugin install <dep>@<marketplace>`, o desinstale el plugin. Si el mercado de la dependencia aún no está registrado, agréguelo y ejecute `/reload-plugins` en su sesión, que instala las dependencias faltantes que puede resolver. |654| `Dependency "<dep>" is not installed` | Una dependencia declarada no está instalada. | Instálala en tu shell con `claude plugin install <dep>@<marketplace>`, o desinstala el plugin. Si el marketplace de la dependencia aún no está registrado, agrégalo y ejecuta `/reload-plugins` en tu sesión, lo que instala las dependencias faltantes que puede resolver. |

602| `Dependency "<dep>" is disabled` | La dependencia está instalada pero desactivada. | Habilite la dependencia, o desinstale el plugin que la necesita. |655| `Dependency "<dep>" is disabled` | La dependencia está instalada pero desactivada. | Habilita la dependencia, o desinstala el plugin que la necesita. |

603| `Requires "<dep>" <range>, installed <version>` | La versión de la dependencia instalada está fuera del rango declarado del plugin. | Actualice la dependencia a una versión en el rango, o desinstale el plugin. |656| `Requires "<dep>" <range>, installed <version>` | La versión de la dependencia instalada está fuera del rango declarado por el plugin. | Actualiza la dependencia a una versión dentro del rango, o desinstala el plugin. |

604| `<Plugin or Dependency> "<name>" has conflicting version requirements` | Ninguna versión satisface cada rango que la fija. El mensaje enumera los rangos. | Desinstale o actualice uno de los plugins en conflicto, o pida al autor ascendente que amplíe su restricción. |657| `<Plugin or Dependency> "<name>" has conflicting version requirements` | Ninguna versión satisface todos los rangos que la fijan. El mensaje enumera los rangos. | Desinstala o actualiza uno de los plugins en conflicto, o pide al autor original que amplíe su restricción. |

605| `... has version requirements too complex to intersect` o `has an invalid version requirement` | Un rango no es semver válido, o los rangos combinados no se pueden intersectar. | Corrija el rango inválido o simplifique las cadenas `\|\|` largas. |658| `... has version requirements too complex to intersect` o `has an invalid version requirement` | Un rango no es semver válido, o los rangos combinados no se pueden intersecar. | Corrige el rango no válido o simplifica las cadenas `\|\|` largas. |

606| `... has no git tag satisfying <range>` | El repositorio de la dependencia no tiene una etiqueta `<name>--v*` en el rango. | Verifique que las etiquetas ascendentes se lancen con esa convención, o relaje el rango. |659| `... has no git tag satisfying <range>` | El repositorio de la dependencia no tiene ninguna etiqueta `<name>--v*` dentro del rango. | Comprueba que el proyecto original etiquete sus versiones con esa convención, o flexibiliza el rango. |

607| `Dependency "<dep>" (required by <plugin>) is in <marketplace>, which is not in the allowlist` | La dependencia está en un mercado diferente, y la resolución entre mercados está desactivada por defecto. | Instale la dependencia usted mismo en el mismo scope, en su shell con `claude plugin install <dep>@<marketplace>` más el `--scope` en el que está instalando el plugin, luego reintente. |660| `Dependency "<dep>" (required by <plugin>) is in <marketplace>, which is not in the allowlist` | La dependencia está en un marketplace diferente, y la resolución entre marketplaces está desactivada de forma predeterminada. | Instala tú mismo la dependencia en el mismo alcance, en tu shell con `claude plugin install <dep>@<marketplace>` más el `--scope` en el que estás instalando el plugin, y luego reintenta. |

608 661 

609Para ver estos programáticamente, ejecute `claude plugin list --json` en su shell. Los plugins con problemas llevan un campo `errors` con los mensajes y un campo `errorDetails` con un `type` para cada uno: las primeras dos filas son `dependency-unsatisfied` y la tercera es `dependency-version-unsatisfied`.662Para verlos de forma programática, ejecuta `claude plugin list --json` en tu shell. Los plugins con problemas incluyen un campo `errors` con los mensajes y un campo `errorDetails` con un `type` para cada uno: las dos primeras filas son `dependency-unsatisfied` y la tercera es `dependency-version-unsatisfied`.

610 663 

611<h2 id="plugin-installed-but-not-working">664<h2 id="plugin-installed-but-not-working">

612 Plugin installed but not working665 Plugin installed but not working

874Un servidor de lenguaje que no está configurado para el espacio de trabajo puede reportar importaciones no resueltas para paquetes internos. No hay nada que corregir en el lado de Claude Code, y los diagnósticos no impiden que Claude edite código.927Un servidor de lenguaje que no está configurado para el espacio de trabajo puede reportar importaciones no resueltas para paquetes internos. No hay nada que corregir en el lado de Claude Code, y los diagnósticos no impiden que Claude edite código.

875 928 

876<h2 id="build-a-plugin">929<h2 id="build-a-plugin">

877 Build a plugin930 Crear un plugin

878</h2>931</h2>

879 932 

880Está desarrollando un plugin y cargándolo con `--plugin-dir` o instalándolo desde un mercado local. Estas entradas cubren los fallos que encuentra mientras desarrolla un plugin. Para que las verificaciones se ejecuten después de cada cambio, vea [Test and debug](/docs/es/plugins/create#test-and-debug).933Estás desarrollando un plugin y cargándolo con `--plugin-dir` o instalándolo desde un marketplace local. Estas entradas cubren los fallos que encuentras mientras desarrollas un plugin. Para las verificaciones que debes ejecutar después de cada cambio, consulta [Probar y depurar](/docs/es/plugins/create#test-and-debug).

881 934 

882Dos fallos que también alcanzan a los usuarios de un plugin tienen sus entradas bajo [Plugin installed but not working](#plugin-installed-but-not-working):935Dos fallos que también afectan a los usuarios de un plugin tienen sus entradas en [El plugin está instalado pero no funciona](#plugin-installed-but-not-working):

883 936 

884* **Un hook que no se dispara**: vea [hooks that don't fire](#failed-to-load-hooks-from-and-hooks-that-dont-fire)937* **Un hook que no se dispara**: consulta [hooks que no se disparan](#failed-to-load-hooks-from-and-hooks-that-dont-fire)

885* **Un servidor MCP que no se inicia**: vea [MCP servers that don't start](#invalid-mcp-server-config-for-and-mcp-servers-that-dont-start)938* **Un servidor MCP que no se inicia**: consulta [servidores MCP que no se inician](#invalid-mcp-server-config-for-and-mcp-servers-that-dont-start)

886 939 

887<h3 id="commands-path-not-found">940<h3 id="commands-path-not-found">

888 `commands path not found: <path>`941 `commands path not found: <path>`

889</h3>942</h3>

890 943 

891La pestaña **Errors** muestra `commands path not found: <absolute path>` con la orientación `Check that the path in your manifest or marketplace config is correct`. El mismo mensaje aparece para `skills`, `agents`, y `hooks`.944La pestaña **Errors** muestra `commands path not found: <absolute path>` con la indicación `Check that the path in your manifest or marketplace config is correct`. El mismo mensaje aparece para `skills`, `agents` y `hooks`.

892 945 

893Claude Code resolvió una ruta desde su `plugin.json` o entrada de mercado contra la raíz del plugin y no encontró nada allí. La ruta en el mensaje es la ruta absoluta que verificó, así que compárela con lo que está en el disco. Corrija la ruta o cree el directorio, luego ejecute `/reload-plugins`.946Claude Code resolvió una ruta de tu `plugin.json` o de tu entrada del marketplace respecto a la raíz del plugin y no encontró nada allí. La ruta del mensaje es la ruta absoluta que verificó, así que compárala con lo que hay en el disco. Corrige la ruta o crea el directorio y luego ejecuta `/reload-plugins`.

894 947 

895Las rutas en el manifiesto son relativas a la raíz del plugin y comienzan con `./`. Una ruta que se resuelve fuera de la raíz del plugin se informa como `<component> path escapes plugin directory` en su lugar y se descarta.948Las rutas del manifiesto son relativas a la raíz del plugin y comienzan con `./`. Una ruta que se resuelve fuera de la raíz del plugin se informa como `<component> path escapes plugin directory` y se descarta.

896 949 

897<h3 id="plugin-dir-loads-a-plugin-with-no-components">950<h3 id="plugin-dir-loads-a-plugin-with-no-components">

898 `--plugin-dir` at a marketplace root doesn't load the plugins under `plugins/`951 `--plugin-dir` en la raíz de un marketplace no carga los plugins de `plugins/`

899</h3>952</h3>

900 953 

901Inició `claude --plugin-dir <path>` y no ve error, pero las skills, agents, y hooks del plugin no están allí.954Iniciaste `claude --plugin-dir <path>` y no ves ningún error, pero los skills, agentes y hooks del plugin no aparecen.

902 955 

903`--plugin-dir` toma el directorio raíz del plugin, el que contiene `.claude-plugin/plugin.json` y los directorios de componentes como `skills/`. Si lo apunta a una raíz de mercado en su lugar, Claude Code no lee `marketplace.json`, por lo que un plugin bajo `plugins/` no se carga, y no ve error. Antes de v2.1.281, Claude Code cargaba una raíz de mercado como un plugin vacío nombrado después de ese directorio. Apunte el indicador al directorio del plugin en sí:956`--plugin-dir` recibe el directorio raíz del plugin, el que contiene `.claude-plugin/plugin.json` y los directorios de componentes como `skills/`. Si en su lugar lo apuntas a la raíz de un marketplace, Claude Code no lee `marketplace.json`, por lo que un plugin dentro de `plugins/` no se carga y no ves ningún error. Antes de la v2.1.281, Claude Code cargaba la raíz de un marketplace como un único plugin vacío con el nombre de ese directorio. Apunta el flag al directorio del plugin en sí:

904 957 

905```shell theme={null}958```shell theme={null}

906claude --plugin-dir ./my-marketplace/plugins/my-plugin959claude --plugin-dir ./my-marketplace/plugins/my-plugin

907```960```

908 961 

909Luego abra **Installed** en `/plugin`, donde el panel de detalles del plugin enumera sus componentes.962Luego abre **Installed** en `/plugin`, donde el panel de detalles del plugin enumera sus componentes.

910 963 

911<h3 id="files-the-plugin-references-outside-its-directory-arent-found">964<h3 id="files-the-plugin-references-outside-its-directory-arent-found">

912 Files the plugin references outside its directory aren't found965 No se encuentran los archivos que el plugin referencia fuera de su directorio

913</h3>966</h3>

914 967 

915Un plugin funciona desde su directorio de fuente con `--plugin-dir` pero falla después de instalar, con errores sobre una ruta como `../shared-utils`.968Un plugin funciona desde su directorio de origen con `--plugin-dir` pero falla después de instalarlo, con errores sobre una ruta como `../shared-utils`.

916 969 

917Claude Code copia un plugin instalado en su caché y lo carga desde allí, por lo que una ruta que alcanza fuera del directorio propio del plugin no apunta a nada en la caché. Mueva los archivos compartidos dentro del directorio del plugin, o haga referencia a ellos a través de un enlace simbólico dentro de él. Para dónde está la caché y cómo se resuelven las rutas, vea [Find plugins on disk](/docs/es/plugins/loading#find-plugins-on-disk).970Claude Code copia un plugin instalado en su caché y lo carga desde allí, por lo que una ruta que sale del directorio propio del plugin no apunta a nada en la caché. Mueve los archivos compartidos dentro del directorio del plugin o haz referencia a ellos mediante un enlace simbólico dentro de él. Para saber dónde está la caché y cómo se resuelven las rutas, consulta [Encontrar plugins en el disco](/docs/es/plugins/loading#find-plugins-on-disk).

918 971 

919<h3 id="claude-plugin-root-shows-forward-slashes-on-windows">972<h3 id="claude-plugin-root-shows-forward-slashes-on-windows">

920 `${CLAUDE_PLUGIN_ROOT}` shows forward slashes on Windows973 `${CLAUDE_PLUGIN_ROOT}` muestra barras diagonales en Windows

921</h3>974</h3>

922 975 

923En Windows, un hook de plugin recibe `${CLAUDE_PLUGIN_ROOT}` como `C:/Users/you/...` en lugar de `C:\Users\you\...`, y un script que esperaba barras invertidas se rompe.976En Windows, un hook de plugin recibe `${CLAUDE_PLUGIN_ROOT}` como `C:/Users/you/...` en lugar de `C:\Users\you\...`, y un script que esperaba barras invertidas falla.

924 977 

925Claude Code ejecuta hooks de forma de shell a través de Git Bash en Windows y sustituye la raíz del plugin en la forma Win32 de barra inclinada hacia adelante a propósito. Los builtins de Bash, las herramientas MSYS, y los binarios nativos de Windows todos aceptan esa forma.978Claude Code ejecuta los hooks en forma de shell a través de Git Bash en Windows y sustituye a propósito la raíz del plugin en la forma Win32 con barras diagonales. Los builtins de Bash, las herramientas de MSYS y los binarios nativos de Windows aceptan esa forma.

926 979 

927Si su script necesita barras invertidas, cambie el hook a una de las formas que mantienen rutas nativas, descritas bajo [exec form and shell form](/docs/es/hooks#exec-form-and-shell-form):980Si tu script necesita barras invertidas, cambia el hook a una de las formas que conservan las rutas nativas, descritas en [forma exec y forma de shell](/docs/es/hooks#exec-form-and-shell-form):

928 981 

929* Un hook de forma exec, que genera el proceso directamente con una matriz `args`982* Un hook en forma exec, que inicia el proceso directamente con un arreglo `args`

930* Un hook con `"shell": "powershell"`983* Un hook con `"shell": "powershell"`

931 984 

932<h3 id="plugin-loads-but-its-skills-are-missing">985<h3 id="plugin-loads-but-its-skills-are-missing">

933 Plugin loads but its skills are missing986 El plugin se carga pero faltan sus skills

934</h3>987</h3>

935 988 

936Su plugin está listado bajo **Installed** sin errores, pero sus skills no se ofrecen cuando escribe `/`.989Tu plugin aparece en **Installed** sin errores, pero sus skills no se ofrecen cuando escribes `/`.

937 990 

938Las skills se cargan desde `skills/` en la raíz del plugin y los comandos desde `commands/` en la raíz del plugin. Solo `plugin.json` pertenece dentro de `.claude-plugin/`, y un directorio `skills/` dentro de `.claude-plugin/` no se escanea. Mueva los directorios a la raíz del plugin y ejecute `/reload-plugins`. Después, el panel de detalles del plugin en `/plugin` enumera las skills, y escribir `/` las ofrece.991Los skills se cargan desde `skills/` en la raíz del plugin y los comandos desde `commands/` en la raíz del plugin. Solo `plugin.json` va dentro de `.claude-plugin/`, y un directorio `skills/` dentro de `.claude-plugin/` no se escanea. Mueve los directorios a la raíz del plugin y ejecuta `/reload-plugins`. Después, el panel de detalles del plugin en `/plugin` enumera los skills, y al escribir `/` se ofrecen.

939 992 

940Cada skill es un directorio que contiene `SKILL.md`. Una entrada `skills` en el manifiesto que apunta a un archivo `SKILL.md` en lugar de su directorio se informa como `path is a file; skills entries must be directories containing SKILL.md`.993Cada skill es un directorio que contiene `SKILL.md`. Una entrada `skills` en el manifiesto que apunta a un archivo `SKILL.md` en lugar de a su directorio se informa como `path is a file; skills entries must be directories containing SKILL.md`.

941 994 

942<h3 id="skill-loads-but-claude-never-invokes-the-skill">995<h3 id="skill-loads-but-claude-never-invokes-the-skill">

943 Skill loads but Claude never invokes the skill996 El skill se carga pero Claude nunca lo invoca

944</h3>997</h3>

945 998 

946La skill de su plugin se ejecuta cuando escribe su comando `/<plugin>:<skill>`, pero Claude nunca la invoca en respuesta a una solicitud simple.999El skill de tu plugin se ejecuta cuando escribes su comando `/<plugin>:<skill>`, pero Claude nunca lo invoca en respuesta a una solicitud normal.

947 1000 

948Verifique estas causas en orden:1001Revisa estas causas en orden:

949 1002 

950* **La skill establece `disable-model-invocation: true`**: con ese campo establecido, solo usted puede invocar la skill. La skill de plantilla en [Create your first plugin](/docs/es/plugins/create#create-your-first-plugin) lo establece. Elimine la línea de una skill que desea que Claude invoque por su cuenta. [Control who invokes a skill](/docs/es/skills#control-who-invokes-a-skill) cubre el campo1003* **El skill establece `disable-model-invocation: true`**: con ese campo establecido, solo tú puedes invocar el skill. El skill de plantilla de [Crear tu primer plugin](/docs/es/plugins/create#create-your-first-plugin) lo establece. Elimina la línea de un skill que quieras que Claude invoque por su cuenta. [Controlar quién invoca un skill](/docs/es/skills#control-who-invokes-a-skill) explica el campo

951* **La descripción no coincide con cómo la gente pregunta**: trabaje a través de las verificaciones en [Skill not triggering](/docs/es/skills#skill-not-triggering)1004* **La descripción no coincide con la forma en que la gente pregunta**: sigue las verificaciones de [El skill no se activa](/docs/es/skills#skill-not-triggering)

952* **La descripción está truncada**: cuando se instalan muchas skills, Claude Code acorta las descripciones para ajustarse al presupuesto de caracteres del listado, que puede eliminar las palabras clave que Claude necesita para coincidir con una solicitud. Vea [Skill descriptions are cut short](/docs/es/skills#skill-descriptions-are-cut-short)1005* **La descripción está truncada**: cuando hay muchos skills instalados, Claude Code acorta las descripciones para ajustarlas al presupuesto de caracteres del listado, lo que puede eliminar las palabras clave que Claude necesita para relacionarlo con una solicitud. Consulta [Las descripciones de los skills se recortan](/docs/es/skills#skill-descriptions-are-cut-short)

953 1006 

954Para medir con qué frecuencia la skill se dispara en prompts realistas en lugar de verificar uno a la vez, escriba un caso de eval con un [grader `tool_used: Skill`](/docs/es/plugin-evals#create-your-first-eval-suite) y ejecútelo con `claude plugin eval` después de cada cambio de descripción.1007Para medir con qué frecuencia se activa el skill en prompts realistas en lugar de revisarlos uno por uno, escribe un caso de eval con un [grader `tool_used: Skill`](/docs/es/plugin-evals#create-your-first-eval-suite) y ejecútalo con `claude plugin eval` después de cada cambio en la descripción.

955 1008 

956<h3 id="is-not-a-plugin-or-skill-folder">1009<h3 id="is-not-a-plugin-or-skill-folder">

957 `<directory> is not a plugin or skill folder` from `claude plugin eval init`1010 `<directory> is not a plugin or skill folder` al ejecutar `claude plugin eval init`

958</h3>1011</h3>

959 1012 

960Ejecutó `claude plugin eval init` desde un directorio que no es la raíz de un plugin, como su directorio de inicio o la raíz de un repositorio que mantiene el plugin en un subdirectorio. `init` escribe la suite bajo el directorio de trabajo, por lo que se detiene en lugar de crear un directorio `evals/` que el plugin nunca vería.1013Ejecutaste `claude plugin eval init` desde un directorio que no es la raíz de un plugin, como tu directorio home o la raíz de un repositorio que guarda el plugin en un subdirectorio. `init` escribe la suite dentro del directorio de trabajo, por lo que se detiene en lugar de crear un directorio `evals/` que el plugin nunca vería.

961 1014 

962Cambie a la raíz del plugin, el directorio que contiene `.claude-plugin/plugin.json` o el `SKILL.md` de la skill, y ejecute el comando nuevamente. Para armar la suite en otro lugar a propósito, pase `--eval-dir`. Vea [Test plugins with evals](/docs/es/plugin-evals).1015Cambia a la raíz del plugin, el directorio que contiene `.claude-plugin/plugin.json` o el `SKILL.md` del skill, y vuelve a ejecutar el comando. Para generar la suite en otro lugar a propósito, pasa `--eval-dir`. Consulta [Probar plugins con evals](/docs/es/plugin-evals).

963 1016 

964<h3 id="the-userconfig-dialog-never-appears">1017<h3 id="the-userconfig-dialog-never-appears">

965 The `userConfig` dialog never appears1018 El diálogo de `userConfig` nunca aparece

966</h3>1019</h3>

967 1020 

968Su plugin declara opciones `userConfig`, pero no aparece ningún diálogo de configuración cuando lo instala.1021Tu plugin declara opciones `userConfig`, pero no aparece ningún diálogo de configuración cuando lo instalas.

969 1022 

970La instalación interactiva muestra el diálogo, y el comando de shell toma los valores como indicadores en su lugar:1023Que la instalación pida los valores depende de dónde la ejecutes:

971 1024 

972* **`/plugin install` en una sesión, o la pestaña Discover en `/plugin`**: el diálogo es parte de esta instalación interactiva1025* **`/plugin install` en una sesión, o la pestaña Discover en `/plugin`**: el diálogo forma parte de esta instalación interactiva

973* **El diálogo Manage plugins de la extensión VS Code**: solicita opciones sin establecer como un formulario después de la instalación. Antes de v2.1.285, la instalación allí no mostraba ningún formulario de opciones, así que establezca los valores desde una sesión de terminal con `/plugin configure <plugin>@<marketplace>`1026* **El diálogo Manage plugins de la extensión de VS Code**: pide las opciones sin establecer en un formulario después de la instalación. Antes de la v2.1.285, la instalación desde allí no mostraba ningún formulario de opciones, así que establece los valores desde una sesión en la terminal con `/plugin configure <plugin>@<marketplace>`

974* **`claude plugin install` en su shell**: nunca solicita valores `userConfig`. Guarda cualquier valor `--config KEY=VALUE` que pase, y cuando las opciones permanecen sin establecer imprime `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Cuando cualquiera de las opciones sin establecer es requerida, `(M required)` sigue `not yet set`.1027* **`claude plugin install` en tu shell**: nunca pide valores de `userConfig`. Guarda los valores `--config KEY=VALUE` que pases y, cuando quedan opciones sin establecer, imprime `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Cuando alguna de las opciones sin establecer es obligatoria, `(M required)` aparece después de `not yet set`.

975 1028 

976Si instaló desde el shell, pase los valores con `--config`, un indicador por opción:1029Si instalaste desde el shell, pasa los valores con `--config`, un flag por opción:

977 1030 

978```shell theme={null}1031```shell theme={null}

979claude plugin install my-plugin@my-marketplace --config api_url=https://example.com1032claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

980```1033```

981 1034 

982Cuando cada opción está establecida, la salida de instalación no lleva ninguna línea `not yet set`.1035Cuando todas las opciones están establecidas, la salida de la instalación no incluye ninguna línea `not yet set`.

983 1036 

984Para abrir el diálogo después en su lugar, ejecute `/plugin configure my-plugin@my-marketplace` en una sesión. Desde el shell, [`claude plugin configure`](/docs/es/plugins/cli-reference#plugin-configure) muestra qué opciones aún no están establecidas y guarda valores canalizados en stdin. Requiere Claude Code v2.1.285 o posterior.1037Para abrir el diálogo más tarde, ejecuta `/plugin configure my-plugin@my-marketplace` en una sesión. Desde el shell, [`claude plugin configure`](/docs/es/plugins/cli-reference#plugin-configure) muestra qué opciones siguen sin establecer y guarda los valores que le envíes por stdin. Requiere Claude Code v2.1.285 o posterior.

985 1038 

986Si pasa una clave `--config` que el manifiesto no declara, el plugin aún se instala, y el comando imprime `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` seguido de las claves que el plugin sí declara.1039Si pasas una clave `--config` que el manifiesto no declara, el plugin se instala de todos modos y el comando imprime `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` seguido de las claves que el plugin sí declara.

987 1040 

988Para un plugin que envía un [archivo de paquete MCPB](/docs/es/plugins/components#include-a-packaged-mcpb-server) declarando `user_config` propio, el mensaje dice `isn't declared in this plugin's userConfig or by its bundled MCP servers.` en su lugar, y las claves conocidas incluyen las de ese servidor, escritas `<server>.<key>`. Un paquete que el manifiesto referencia por URL no se lee en el tiempo de instalación, por lo que sus claves no se enumeran y el mensaje dice configurarlo en `/plugin`. Establecer claves `<server>.<key>` requiere Claude Code v2.1.285 o posterior.1041Para un plugin que incluye un [archivo de paquete MCPB](/docs/es/plugins/components#include-a-packaged-mcpb-server) que declara su propio `user_config`, el mensaje dice `isn't declared in this plugin's userConfig or by its bundled MCP servers.` en su lugar, y las claves conocidas incluyen las de ese servidor, escritas como `<server>.<key>`. Un paquete que el manifiesto referencia por URL no se lee durante la instalación, por lo que sus claves no se enumeran y el mensaje indica que lo configures en `/plugin`. Establecer claves `<server>.<key>` requiere Claude Code v2.1.285 o posterior.

989 1042 

990<h3 id="claude-plugin-validate-reports-errors">1043<h3 id="claude-plugin-validate-reports-errors">

991 `claude plugin validate` reports errors1044 `claude plugin validate` informa errores

992</h3>1045</h3>

993 1046 

994Ejecutó `claude plugin validate <path>`, o `/plugin validate <path>` en una sesión, e imprimió `Found N errors` y `Validation failed`, luego salió con código 1.1047Ejecutaste `claude plugin validate <path>`, o `/plugin validate <path>` en una sesión, e imprimió `Found N errors` y `Validation failed`, y luego terminó con el código 1.

995 1048 

996El validador lee el manifiesto en la ruta que proporciona: `.claude-plugin/plugin.json` para un directorio de plugin, o `.claude-plugin/marketplace.json` para un directorio de mercado. Para un mercado, prefija problemas en el manifiesto propio de una entrada con el índice de entrada, como `plugins[1] plugin.json → json: ...`.1049El validador lee el manifiesto en la ruta que le indicas: `.claude-plugin/plugin.json` para un directorio de plugin, o `.claude-plugin/marketplace.json` para un directorio de marketplace. Para un marketplace, antepone a los problemas del manifiesto propio de una entrada el índice de la entrada, como en `plugins[1] plugin.json → json: ...`.

997 1050 

998La tabla cubre los mensajes que detienen la validación y dos advertencias, `No frontmatter block found` y `Unknown field '<key>'`, que la detienen solo cuando pasa `--strict`. Otras advertencias, como una descripción faltante, no se enumeran.1051La tabla cubre los mensajes que detienen la validación y dos advertencias, `No frontmatter block found` y `Unknown field '<key>'`, que la detienen solo cuando pasas `--strict`. Otras advertencias, como la falta de una descripción, no se incluyen.

999 1052 

1000| Mensaje | Causa | Solución |1053| Mensaje | Causa | Solución |

1001| :- | :- | :- |1054| :- | :- | :- |

1002| `File not found: <path>` | La ruta no tiene manifiesto, o no existe. | Ejecute el comando contra la raíz del plugin o mercado, el directorio que contiene `.claude-plugin/`. |1055| `File not found: <path>` | La ruta no tiene manifiesto o no existe. | Ejecuta el comando sobre la raíz del plugin o del marketplace, el directorio que contiene `.claude-plugin/`. |

1003| `No manifest found in directory. Expected .claude-plugin/marketplace.json or .claude-plugin/plugin.json` | El directorio no tiene manifiesto `.claude-plugin/`. | Cree el manifiesto, o apunte al directorio correcto. |1056| `No manifest found in directory. Expected .claude-plugin/marketplace.json or .claude-plugin/plugin.json` | El directorio no tiene un manifiesto `.claude-plugin/`. | Crea el manifiesto o apunta al directorio correcto. |

1004| `Invalid JSON syntax: <parse error>` | El manifiesto, o `hooks/hooks.json`, no es JSON válido. | Corrija el JSON. Hasta que corrija `hooks/hooks.json`, una sesión carga el plugin sin los hooks en ese archivo. |1057| `Invalid JSON syntax: <parse error>` | El manifiesto, o `hooks/hooks.json`, no es JSON válido. | Corrige el JSON. Hasta que corrijas `hooks/hooks.json`, una sesión carga el plugin sin los hooks de ese archivo. |

1005| `Path not found: <path>. The runtime loader will report this as a load failure.` | Una ruta de componente en el manifiesto no existe. | Corrija la ruta o cree el directorio. |1058| `Path not found: <path>. The runtime loader will report this as a load failure.` | Una ruta de componente del manifiesto no existe. | Corrige la ruta o crea el directorio. |

1006| `Path contains ".." which could be a path traversal attempt: <path>` | Una ruta de componente escapa del directorio del plugin. | Use rutas dentro de la raíz del plugin. |1059| `Path contains ".." which could be a path traversal attempt: <path>` | Una ruta de componente sale del directorio del plugin. | Usa rutas dentro de la raíz del plugin. |

1007| `Path is a file; skills entries must be directories containing SKILL.md` | Una entrada `skills` apunta a `SKILL.md` en lugar de su directorio. | Apunte al directorio padre, o `.` para un `SKILL.md` a nivel de raíz. |1060| `Path is a file; skills entries must be directories containing SKILL.md` | Una entrada `skills` apunta a `SKILL.md` en lugar de a su directorio. | Apunta al directorio padre, o a `.` para un `SKILL.md` en la raíz. |

1008| `No frontmatter block found` o `YAML frontmatter failed to parse: <error>` | Un archivo de skill, agent, o comando tiene frontmatter YAML faltante o inválido. | Agregue o corrija el frontmatter entre delimitadores `---`. Se informa al validar un directorio de plugin. |1061| `No frontmatter block found` o `YAML frontmatter failed to parse: <error>` | Un archivo de skill, agente o comando tiene frontmatter YAML faltante o no válido. | Agrega o corrige el frontmatter entre delimitadores `---`. Se informa al validar un directorio de plugin. |

1009| `Plugin name "<name>" is reserved: it passes as one of Anthropic's own` | El nombre `name` del plugin es uno de los [nombres reservados](/docs/es/plugins/manifest-reference#name). | Renombre el plugin por lo que hace. |1062| `Plugin name "<name>" is reserved: it passes as one of Anthropic's own` | El `name` del plugin es uno de los [nombres reservados](/docs/es/plugins/manifest-reference#name). | Cambia el nombre del plugin según lo que hace. |

1010| `Unknown field '<key>'` | El manifiesto tiene un campo que el esquema no define. | Elimínelo, o use el nombre que el mensaje sugiere. Claude Code ignora campos desconocidos en el tiempo de carga. |1063| `Unknown field '<key>'` | El manifiesto tiene un campo que el esquema no define. | Elimínalo o usa el nombre que sugiere el mensaje. Claude Code ignora los campos desconocidos al cargar. Para `privacyPolicyUrl` y los demás campos de listado del directorio en `plugin.json`, consulta [Campos de listado del directorio](/docs/es/plugins/manifest-reference#directory-listing-fields). |

1011 1064 

1012Ejecute el comando nuevamente después de cada solución hasta que no imprima errores.1065Vuelve a ejecutar el comando después de cada corrección hasta que no imprima errores.

1013 1066 

1014Los campos `plugin.json` están en la [manifest reference](/docs/es/plugins/manifest-reference), y los mensajes a nivel de mercado están bajo [Marketplace validation errors](#marketplace-validation-errors).1067Los campos de `plugin.json` están en la [referencia del manifiesto](/docs/es/plugins/manifest-reference), y los mensajes a nivel de marketplace están en [Errores de validación del marketplace](#marketplace-validation-errors).

1015 1068 

1016<h3 id="plugin-has-conflicting-manifests">1069<h3 id="plugin-has-conflicting-manifests">

1017 `Plugin <name> has conflicting manifests`1070 `Plugin <name> has conflicting manifests`

1018</h3>1071</h3>

1019 1072 

1020El plugin falla al cargar con `Plugin <name> has conflicting manifests: both plugin.json and marketplace entry specify components.`1073El plugin no se carga y muestra `Plugin <name> has conflicting manifests: both plugin.json and marketplace entry specify components.`

1021 1074 

1022El plugin tiene su propio `plugin.json`, y su entrada de mercado establece `strict: false` mientras también declara cualquiera de `commands`, `agents`, `skills`, `hooks`, `outputStyles`, o `themes`. Elimine esos campos de la entrada, o establezca `strict: true` en la entrada para que Claude Code los agregue a `plugin.json`. Vea [Strict mode](/docs/es/plugins/marketplace-reference#strict-mode).1075El plugin tiene su propio `plugin.json`, y su entrada del marketplace establece `strict: false` y además declara alguno de `commands`, `agents`, `skills`, `hooks`, `outputStyles` o `themes`. Elimina esos campos de la entrada, o establece `strict: true` en la entrada para que Claude Code los agregue a `plugin.json`. Consulta [Modo estricto](/docs/es/plugins/marketplace-reference#strict-mode).

1023 1076 

1024<h3 id="warning-no-commands-found-in-plugin-custom-directory">1077<h3 id="warning-no-commands-found-in-plugin-custom-directory">

1025 `Warning: No commands found in plugin <name> custom directory`1078 `Warning: No commands found in plugin <name> custom directory`

1026</h3>1079</h3>

1027 1080 

1028Cuando el plugin se carga, el registro `claude --debug` en `~/.claude/debug/<session-id>.txt` registra `Warning: No commands found in plugin <name> custom directory: <path>. Expected .md files or SKILL.md in subdirectories.` Nada aparece en la sesión o la pestaña **Errors**.1081Cuando el plugin se carga, el registro de `claude --debug` en `~/.claude/debug/<session-id>.txt` registra `Warning: No commands found in plugin <name> custom directory: <path>. Expected .md files or SKILL.md in subdirectories.` No aparece nada en la sesión ni en la pestaña **Errors**.

1029 1082 

1030La ruta `commands` en el manifiesto existe pero no contiene archivos `.md` y no `SKILL.md` en un subdirectorio. Agregue los archivos de comando, o elimine la ruta del manifiesto.1083La ruta `commands` del manifiesto existe pero no contiene archivos `.md` ni ningún `SKILL.md` en un subdirectorio. Agrega los archivos de comando o elimina la ruta del manifiesto.

1031 1084 

1032<h2 id="host-a-marketplace">1085<h2 id="host-a-marketplace">

1033 Host a marketplace1086 Host a marketplace