1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Recomienda tu plugin desde tu CLI

6 

7> Emite un marcador de una línea desde tu CLI para que Claude Code solicite a los usuarios instalar tu plugin oficial.

8 

9Si mantienes una CLI o SDK y tienes un plugin en el marketplace oficial de Anthropic, tu herramienta puede solicitar a los usuarios de Claude Code que instalen ese plugin. Tu CLI escribe un marcador de una línea en stderr cuando detecta que se está ejecutando dentro de Claude Code. Claude Code lee el marcador, lo elimina de la salida y muestra al usuario un mensaje de instalación de una sola vez.

10 

11Claude Code elimina la línea de sugerencia de la salida del comando antes de enviarla al modelo, por lo que el marcador nunca aparece en la conversación y no se cuenta hacia el uso de tokens. El protocolo no requiere comandos adicionales y no cambia lo que tu CLI imprime para usuarios fuera de Claude Code.

12 

13Esta página es para mantenedores de CLI y SDK. Si buscas instalar plugins, consulta [Descubre e instala plugins](/es/discover-plugins).

14 

15<h2 id="how-it-works">

16 Cómo funciona

17</h2>

18 

19Claude Code establece la variable de entorno [`CLAUDECODE`](/es/env-vars) en `1` para cada comando que ejecuta a través de las herramientas Bash y PowerShell, y para comandos de [hook](/es/hooks). Cuando tu CLI ve esa variable, escribe una etiqueta `<claude-code-hint />` que se cierra automáticamente en stderr. En comandos hook la etiqueta de sugerencia se elimina e ignora. Solo la salida de las herramientas Bash y PowerShell activa el mensaje de instalación.

20 

21Cuando Claude Code recibe la salida del comando, hace lo siguiente:

22 

231. Busca líneas de sugerencia y las elimina antes de que la salida llegue al modelo

242. Verifica que la sugerencia apunte a un plugin en un marketplace oficial de Anthropic

253. Verifica que el plugin no esté ya instalado y no haya sido sugerido antes

264. Muestra al usuario un mensaje de instalación que nombra el comando que emitió la sugerencia

27 

28Claude Code nunca instala un plugin automáticamente. El usuario siempre confirma.

29 

30<h2 id="emit-the-hint">

31 Emite la sugerencia

32</h2>

33 

34Condiciona la emisión en la variable de entorno `CLAUDECODE` para que el marcador nunca aparezca en la terminal de un usuario humano. Luego escribe la etiqueta en stderr en su propia línea.

35 

36Los siguientes ejemplos emiten una sugerencia para un plugin llamado `example-cli` en el marketplace oficial:

37 

38<CodeGroup>

39 ```javascript Node.js theme={null}

40 if (process.env.CLAUDECODE) {

41 process.stderr.write(

42 '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',

43 )

44 }

45 ```

46 

47 ```python Python theme={null}

48 import os, sys

49 

50 if os.environ.get("CLAUDECODE"):

51 print(

52 '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />',

53 file=sys.stderr,

54 )

55 ```

56 

57 ```go Go theme={null}

58 if os.Getenv("CLAUDECODE") != "" {

59 fmt.Fprintln(os.Stderr,

60 `<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />`)

61 }

62 ```

63 

64 ```shell Shell theme={null}

65 [ -n "$CLAUDECODE" ] &&

66 printf '%s\n' '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />' >&2

67 ```

68</CodeGroup>

69 

70Reemplaza `example-cli` con el nombre de tu plugin en el marketplace oficial.

71 

72<h2 id="choose-where-to-emit">

73 Elige dónde emitir

74</h2>

75 

76Controlas qué rutas de código emiten la sugerencia. Claude Code deduplica por plugin, por lo que emitir en cada invocación no tiene desventajas. Los puntos de contacto que funcionan bien incluyen:

77 

78| Ubicación | Por qué funciona |

79| :----------------------------------------- | :--------------------------------------------------------------- |

80| Salida de `--help` | Claude a menudo ejecuta help al explorar una CLI desconocida |

81| Errores de subcomando desconocido | Llega al momento en que Claude está confundido sobre tu interfaz |

82| Éxito de inicio de sesión o autenticación | El usuario ya está en una mentalidad de configuración |

83| Mensaje de bienvenida de primera ejecución | Un momento natural de incorporación |

84 

85<h2 id="what-the-user-sees">

86 Lo que ve el usuario

87</h2>

88 

89Cuando la sugerencia pasa todas las verificaciones, Claude Code muestra un mensaje como el siguiente:

90 

91```text theme={null}

92─────────────────────────────────────────────────────────────

93 Recomendación de Plugin

94 

95 El comando example-cli sugiere instalar un plugin.

96 

97 Plugin: example-cli

98 Marketplace: claude-plugins-official

99 Integración oficial para implementaciones de example-cli

100 

101 ¿Te gustaría instalarlo?

102 ❯ 1. Sí, instalar example-cli

103 2. No

104 3. No, y no mostrar sugerencias de instalación de plugins nuevamente

105 

106─────────────────────────────────────────────────────────────

107```

108 

109El mensaje nombra el comando que produjo la sugerencia para que los usuarios puedan detectar una discrepancia entre la herramienta y el plugin que recomienda. Si el usuario no responde dentro de 30 segundos, el mensaje se descarta como **No**.

110 

111La frecuencia del mensaje está limitada:

112 

113* **Una vez por plugin**: después de que se muestre el mensaje, Claude Code registra el plugin y nunca vuelve a solicitar para él, independientemente de la respuesta del usuario.

114* **Una vez por sesión**: en todas las CLI de la máquina, como máximo aparece un mensaje de sugerencia por sesión de Claude Code.

115 

116Seleccionar **Sí** instala el plugin en el ámbito del usuario. Seleccionar **No, y no mostrar sugerencias de instalación de plugins nuevamente** desactiva todos los mensajes de sugerencia futuros para el usuario.

117 

118<h2 id="hint-format">

119 Formato de sugerencia

120</h2>

121 

122La sugerencia es una etiqueta que se cierra automáticamente con tres atributos requeridos.

123 

124```text theme={null}

125<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />

126```

127 

128| Atributo | Requerido | Descripción |

129| :------- | :-------- | :------------------------------------------------------- |

130| `v` | Sí | Versión del protocolo. `1` es el único valor soportado |

131| `type` | Sí | Tipo de sugerencia. `plugin` es el único valor soportado |

132| `value` | Sí | Identificador del plugin en forma `name@marketplace` |

133 

134Los valores de atributo pueden estar entrecomillados con comillas dobles o dejarse sin comillas. Los valores sin comillas no pueden contener espacios en blanco. Las secuencias de escape no son compatibles.

135 

136<h2 id="requirements">

137 Requisitos

138</h2>

139 

140Claude Code aplica dos condiciones antes de actuar sobre una sugerencia. Las sugerencias que fallan en cualquiera de las verificaciones se descartan:

141 

142* **Línea propia**: la etiqueta debe ocupar su propia línea. Una etiqueta incrustada a mitad de línea, por ejemplo dentro de una declaración de registro, se ignora. Se permite espacios en blanco al principio y al final de la línea.

143* **Marketplace oficial**: el `value` debe hacer referencia a un plugin en un marketplace controlado por Anthropic como `claude-plugins-official`. Las sugerencias que apuntan a otros marketplaces se descartan silenciosamente.

144 

145La línea de sugerencia siempre se elimina de la salida antes de que llegue al modelo, incluso cuando la versión o el tipo no se reconocen, por lo que el marcador nunca se cuenta hacia el uso de tokens.

146 

147La orientación restante se recomienda pero no se aplica. Claude Code no puede observar si tu CLI la sigue:

148 

149* **Escribe en stderr**: stderr mantiene la etiqueta fuera de tuberías de shell como `example-cli deploy | jq`. Claude Code escanea ambas secuencias, por lo que stdout también funciona.

150* **Condiciona en `CLAUDECODE`**: solo emite cuando la variable de entorno `CLAUDECODE` está establecida. Esto evita que el marcador aparezca a los usuarios que ejecutan tu CLI directamente.

151 

152<h2 id="get-your-plugin-into-the-official-marketplace">

153 Obtén tu plugin en el marketplace oficial

154</h2>

155 

156El protocolo de sugerencia solo tiene efecto para plugins que se enumeran en el marketplace oficial de Anthropic, `claude-plugins-official`. Anthropic cura ese marketplace a su discreción, y los formularios de envío en la aplicación agregan plugins al [marketplace de la comunidad](/es/plugins#submit-your-plugin-to-the-community-marketplace) en su lugar, que el protocolo de sugerencia no verifica. Si trabajas con un contacto de socio de Anthropic, comunícate con ellos para coordinar una enumeración en el marketplace oficial.

157 

158<h2 id="see-also">

159 Ver también

160</h2>

161 

162* [Crea plugins](/es/plugins): construye el plugin que tu CLI recomienda

163* [Crea y distribuye un marketplace de plugins](/es/plugin-marketplaces): aloja plugins fuera del marketplace oficial

164* [Variables de entorno](/es/env-vars): referencia completa para `CLAUDECODE` y variables relacionadas