Directorio / Guías / Claude Code

Subagentes en Claude Code: cuándo sirven y cómo crear uno

Qué es un subagente, en qué tareas conviene delegarle trabajo y en cuáles no, cómo se define y un subagente revisor listo para copiar.

Explicación4 min de lecturaPor Rafael Schwart

Un subagente es un asistente aparte que Claude Code lanza para una tarea concreta. Trabaja en su propia conversación, con sus propias instrucciones y herramientas, y al terminar le entrega a tu sesión solo un resumen.

En una oficina sería encargarle una investigación a un colega. No te sientas a ver cómo busca: recibes el informe.

Por qué existen

Cada conversación con Claude tiene un espacio limitado, el contexto. Cada archivo que lee y cada resultado de búsqueda lo va llenando. Cuando una tarea genera mucho material que no vas a volver a mirar, conviene que lo procese otro y que a tu sesión llegue solo la conclusión.

Cuándo conviene

  • Búsquedas largas. Revisar cincuenta archivos para encontrar dónde se calcula un descuento.
  • Tareas independientes. Dos o tres investigaciones que no dependen entre sí pueden avanzar al mismo tiempo.
  • Revisión con ojos nuevos. Un subagente empieza sin la conversación anterior. Juzga el cambio sin arrastrar las suposiciones de quien lo hizo.
  • Límites claros. Le puedes dar solo herramientas de lectura, para que revise sin poder editar.

Cuándo no

  • La tarea necesita ir y venir contigo para afinar el resultado.
  • Es un cambio rápido y puntual.
  • Las etapas comparten mucho contexto, como planificar, construir y probar lo mismo.

Además, cada subagente consume de los mismos límites de uso que tu sesión. Delegar todo no sale gratis. Y si lo que buscas es una forma fija de hacer un trabajo dentro de tu conversación, eso es un skill, no un subagente.

Los que ya vienen incluidos

Claude Code trae subagentes propios y los usa cuando le conviene: uno de exploración, de solo lectura, para buscar en el proyecto; uno de planificación; y uno de propósito general. No tienes que configurar nada para que funcionen.

Cómo se define uno

Un subagente es un archivo Markdown. Arriba lleva un encabezado entre dos líneas ---, y debajo sus instrucciones. Se guarda en una de estas carpetas:

CarpetaAlcance
.claude/agents/ dentro del proyectoSolo ese proyecto. Se puede compartir con el equipo por git.
~/.claude/agents/Todos tus proyectos en esta computadora.

Los campos obligatorios son name y description. Los dos opcionales que más vas a usar son tools, que limita qué herramientas puede usar, y model, que elige el modelo: sonnet, opus, haiku, o inherit para usar el mismo de la sesión.

La descripción es lo más importante, porque Claude la lee para decidir cuándo delegar. Escríbela como una regla de uso: qué hace y en qué momento llamarlo.

Ejemplo: un revisor antes de publicar

Guárdalo como .claude/agents/revisor.md:

---
name: revisor
description: Revisa los cambios recientes antes de publicarlos. Úsalo cuando el usuario pida una revisión, antes de publicar una página o de enviar un reporte.
tools: Read, Grep, Glob, Bash
model: sonnet
---

Eres un revisor de calidad. No editas archivos: solo informas.

Cuando te llamen:
1. Corre git diff para ver qué cambió. Usa Bash solo para
   git diff y git status.
2. Lee el CLAUDE.md del proyecto y revisa si algún cambio
   rompe una de sus reglas.
3. Revisa los textos que verá el cliente: ortografía, precios,
   teléfonos, horarios y enlaces.
4. Busca datos que no deberían estar ahí: claves, contraseñas,
   correos o teléfonos personales.

Entrega el informe en tres grupos:
- Corregir antes de publicar
- Conviene corregir
- Sugerencias

En cada punto indica el archivo y la línea, y propone el texto corregido.

Por qué está armado así. La descripción dice cuándo usarlo. La lista de tools no incluye Edit ni Write, así que no puede modificar archivos con ellas. Bash le permite correr git; en modo Manual, Claude Code te pide permiso antes de cada comando. Y el informe por prioridad te deja decidir rápido qué arreglar.

Cómo crearlo y usarlo

  1. Pídeselo a Claude o crea el archivo tú. Por ejemplo: «Crea un subagente revisor en .claude/agents/ que revise mis cambios sin editar nada». En las versiones recientes, el comando /agents solo te recuerda estas dos opciones.
  2. Revisa el archivo. Confirma el nombre, la descripción y las herramientas.
  3. Reinicia si hace falta. Si la carpeta agents/ no existía cuando abriste la sesión, cierra y vuelve a abrir Claude Code. Si ya existía, detecta los cambios solo.
  4. Llámalo. Con lenguaje normal, «Usa el subagente revisor para revisar mis cambios», o escribe @ y elígelo de la lista, que garantiza que se use ese.

En la conversación verás una línea con el nombre del subagente y la tarea que recibió. Cuando termina, Claude te trae el informe.

Empieza con un solo subagente para una tarea que ya haces a mano, como revisar antes de publicar. Si en dos semanas no lo usaste, no lo necesitas.

Sigue leyendo

Más guías.

Cada una se lee en menos de cinco minutos.

Todas las guías
Guía paso a paso · 4 min

Claude Code desde cero

Qué es Claude Code, cómo instalarlo en Windows o Mac, tu primer pedido, cómo aprobar lo que hace y los comandos que vas a usar cada día.

Guía paso a paso · 4 min

CLAUDE.md: el manual de tu proyecto

Qué es el archivo CLAUDE.md, dónde va, cómo crearlo con /init y qué escribir para que Claude no te pregunte lo mismo en cada sesión.

  Arqentia

¿Prefieres que lo armemos contigo?

Treinta minutos para ver tu operación: cómo entra el dinero, dónde se pierde tiempo y qué conviene automatizar primero. Gratis para negocios y sin compromiso.

Agendar consulta