Inicio

Cree un subagente en Claude Code

Comparar oportunidades de inversión requiere horas de investigación y análisis. Piense en un subagente como contratar a un analista financiero que domina sus herramientas de investigación: usted proporciona nombres de empresas, y él recopila informes, evalúa cada empresa según métricas clave y recomienda la mejor inversión. Una vez que aprenda a construir subagentes, podrá automatizar cualquier flujo de trabajo repetitivo de múltiples pasos. Este tutorial le muestra cómo construir ese analista.

Conceptos clave

Lo que necesitará

Paso 1: Abra su carpeta de proyecto e inicie Claude Code

Su skill stock-report está en la misma carpeta de proyecto que usó en el tutorial de Skills; vuelva a abrir esa carpeta en lugar de crear una nueva.

Windows (PowerShell):

Mac:

Inicie sesión con su suscripción de Claude siguiendo el tutorial de instalación (Windows Mac). Después de iniciar sesión, verá un mensaje de bienvenida y el prompt de Claude Code.

Paso 2: Verifique que existe el skill de informe bursátil

Antes de construir su subagente, confirme que el skill está disponible. Escriba:

Lista todas las skills disponibles

Debería ver stock-report en la salida. Este skill investiga empresas y genera informes que cubren noticias de productos, actualizaciones de gestión, desempeño financiero y perspectivas de analistas.

Si no lo ve, los archivos del skill deberían estar en .claude/skills/stock-report/ (nivel de proyecto). Si la carpeta no existe, vuelva atrás y complete primero el tutorial Cree su primera Claude Skill en esta misma carpeta de proyecto.

Paso 3: Comprenda la arquitectura de subagente vs skill

Así es como los subagentes y skills trabajan juntos:

Componente Propósito Ejemplo
Skill Recopila datos sin procesar sobre una empresa “Generar informe para Apple: productos, finanzas, gestión, analistas”
Subagente Usa datos del skill para lograr un objetivo “Obtener informes para Apple y Microsoft, evaluar ambos, recomendar en cuál invertir”

Diferencia clave:

Su subagente selector de acciones:

  1. Invocará el skill de informe bursátil para cada empresa (2+ veces)
  2. Evaluará empresas según categorías (finanzas, crecimiento, gestión, sentimiento)
  3. Comparará puntuaciones y recomendará la mejor inversión

Paso 4: Cree el subagente selector de acciones

Pídale a Claude que escriba el archivo del subagente por usted. Copie y pegue este prompt:

Crea un subagente de proyecto llamado stock-picker en .claude/agents/:
- Acepta dos o más acciones
- Usa el skill stock-report para investigar
- Crea tarjetas de puntuación basadas en las categorías de datos recopilados
- Proporciona una recomendación final.
Usa el modelo Sonnet.

Claude crea el archivo .claude/agents/stock-picker.md. Si Claude pide permiso para crear el archivo, elija Yes.

Nota: En versiones anteriores de Claude Code, escribir /agents abría un menú para crear subagentes. En las versiones actuales, /agents solo le recuerda que se lo pida a Claude, que es justo lo que acabamos de hacer.

Herramientas: Un subagente puede limitarse solo a las herramientas que necesita, por ejemplo, un agente de solo investigación con únicamente búsqueda web. Si el archivo no tiene una línea tools:, el subagente puede usar todas las herramientas, que es lo que el stock-picker necesita para investigar en línea y escribir archivos.

Paso 5: Revise lo que construyó (punto de reflexión)

Para abrir el archivo en VS Code, haga clic en File > Open File… y navegue hasta .claude/agents/stock-picker.md.

O puede pedirle a Claude:

Muéstrame el archivo del subagente stock-picker.

Claude mostrará el archivo del subagente ubicado en .claude/agents/stock-picker.md. Verá:

Un YAML frontmatter en la parte superior:

---
name: stock-picker
description: Compara múltiples empresas para decisiones de inversión...
skills:
  - stock-report
model: sonnet
---

Este frontmatter (la sección entre marcadores ---) indica a Claude Code cuándo usar este subagente (description), qué skills cargar en él desde el inicio (skills) y con qué modelo de Claude se ejecuta (model).

Un System prompt debajo del frontmatter con su metodología de puntuación.

Confirme estos elementos clave:

Puede editar el archivo directamente o pedirle a Claude que lo actualice.

Paso 6: Pruebe el subagente

Primero salga de Claude Code presionando Ctrl+C dos veces y luego escriba claude para iniciarlo de nuevo. Claude Code solo detecta una carpeta .claude/agents/ completamente nueva después de reiniciar.

Ahora pruebe su subagente con una comparación real. Escriba:

¿Qué es mejor inversión: Apple o Google?

El subagente se activará automáticamente según su descripción.

Paso 7: Observe cómo trabaja el subagente

El subagente se ejecuta en segundo plano, así que verá su nombre en un pequeño panel debajo del prompt en lugar de ver cada paso. Para observarlo, escriba /tasks, use las teclas de flecha para seleccionar stock-picker y presione Enter. Internamente, el subagente:

  1. Invoca el skill dos veces - Llama al skill stock-report una vez para Apple y luego para Google
  2. Recopila datos - Cada llamada al skill busca en la web y genera un informe de empresa
  3. Evalúa empresas - Puntúa cada categoría y las combina en una puntuación general
  4. Genera salida - Crea tabla de comparación y recomendación

Esto puede tomar 2-3 minutos ya que involucra búsqueda web.

Observe que su conversación principal no se llena con todos los resultados de búsqueda y pasos intermedios: eso es el contexto aislado en acción. El subagente investiga en su propio espacio de trabajo separado y solo le informa lo que ve aquí.

Paso 8: Revise la salida

El subagente devuelve un análisis detallado que incluye:

El subagente puede mostrar esto en la terminal o generar un archivo markdown con el informe completo. Puede editar el archivo del subagente para personalizar las ponderaciones de puntuación o el formato de salida.

Próximos pasos

Ahora que tiene un subagente selector de acciones funcional, pruebe estas extensiones:

Solución de problemas

Resumen del flujo de trabajo

Creado por Steven Ge el 14 de diciembre de 2025.