Claude Agents como plugins: instalar, empaquetar y la diferencia con Managed Agents

Anthropic acaba de lanzar un sistema de plugins de agentes dentro de Claude Code. Hasta ahora, si querías un agente especializado tenías que escribírtelo a mano como subagent en .claude/agents/. Ahora puedes instalar agentes ya hechos con un comando, empaquetar los tuyos igual y compartirlos, o dejarle a Anthropic que te los hostee en producción (Managed Agents). Lo de “finance” es solo la primera tanda — lo interesante es la capa de distribución que hay debajo.

Qué es un Claude Agent Plugin

Un plugin de agente es un agente de Claude Code empaquetado como unidad distribuible: un directorio con un manifest, las instrucciones del agente, las herramientas que puede usar y, opcionalmente, código auxiliar. En vez de copiar y pegar un .md en .claude/agents/, lo instalas con un comando desde el marketplace de Anthropic (o desde un repo git) y queda registrado en tu Claude Code como cualquier otro agente.

La diferencia con un subagent local de toda la vida: el plugin tiene versionado, manifest y un canal de distribución. No es un archivo suelto, es un paquete.

Instalar un plugin oficial

Anthropic ha publicado 10 agentes pre-built en la primera tanda (la familia “Finance Agents”). Da igual a qué se dediquen — el comando es el mismo para cualquier plugin oficial.

# Listar plugins disponibles en el marketplace
claude plugins search

# Instalar un agente oficial (ejemplo: financial-analyst)
claude plugins install anthropic/financial-analyst

# Verificar que está instalado y disponible como agente
claude agents list

Una vez instalado, lo invocas como cualquier otro subagent dentro de Claude Code:

claude agents run financial-analyst "analiza el P&L de Q3"

Si solo quieres curiosear qué hace cada uno antes de instalarlo:

claude plugins info anthropic/financial-analyst

Empaquetar tu agente como plugin

Si ya tienes un subagent en .claude/agents/ que te funciona (un revisor de PRs, un escritor de release-notes, un analista de logs), convertirlo en plugin son 4 pasos.

1. Estructura mínima del plugin

mi-agente-plugin/
├── plugin.json          # manifest
├── agent.md             # instrucciones del agente
├── README.md            # qué hace, cómo se usa
└── tools/               # (opcional) scripts auxiliares
    └── helpers.py

2. El manifest

{
  "name": "release-notes-writer",
  "version": "0.1.0",
  "description": "Escribe release-notes a partir de commits desde el último tag.",
  "author": "tu-handle",
  "entrypoint": "agent.md",
  "tools": ["bash", "read", "write"],
  "claude_code_min_version": "1.0.0"
}

3. Las instrucciones del agente

agent.md es el mismo archivo que tendrías en .claude/agents/ — frontmatter con name, description, tools y el cuerpo con el prompt del agente. Si ya tienes uno funcionando, lo copias tal cual.

4. Publicar

# Empaquetar (genera un .tar.gz validado contra el schema)
claude plugins pack ./mi-agente-plugin

# Publicar en el marketplace personal (requiere cuenta Anthropic)
claude plugins publish ./mi-agente-plugin.tar.gz

# O compartirlo por git directamente — instalable así:
claude plugins install git+https://github.com/tu-user/mi-agente-plugin

A partir de ahí, cualquiera con tu URL lo instala con un comando.

Plugin local vs Managed Agent (hosted)

La pregunta que te tienes que hacer no es “plugin o subagent” — es “¿lo corro yo o que lo corra Anthropic?”.

	Plugin local	Managed Agent (hosted)
Dónde corre	Tu máquina / tu Claude Code	Infra de Anthropic
Control	Total: ves el prompt, las tools, el código	Caja parcialmente cerrada: configuras inputs y outputs
Coste	Tokens normales de tu plan	Tokens + sobrecoste de hosting por ejecución
Latencia	Depende de tu red y máquina	Optimizada por Anthropic, estable bajo carga
Governance	Tú gestionas logs, permisos, secretos	Logs, audit trail y SOC 2 incluidos
Cuándo usarlo	Workflow personal, prototipos, agentes con secretos tuyos	Producción real, equipos, agentes que tienen que responder 24/7

Regla rápida: si lo vas a invocar tú a mano desde tu terminal, plugin local. Si lo va a invocar un sistema (un webhook, un cron, otro servicio) y necesita uptime, Managed.

La regla de oro

Plugin local es para devs que quieren ver el código. Managed es para devs que quieren olvidarse del código. La mayoría de tus agentes serán locales — los Managed son para cuando un agente deja de ser un experimento y pasa a ser infraestructura.

---

Doc oficial Anthropic → docs.anthropic.com/claude-code/plugins

Anuncio del lanzamiento (@claudeai) → claude.com/news

Sígueme para más trucos con Claude Code e IA → @pabloinpublic

Waitlist de la comunidad → pabloinpublic.com