Claude Code Club · Cuaderno de estudio
Etapa 7 — Agents

👥 Equipos de agentes vs. subagentes (y cuándo usar TeamCreate)

Lo que te llevarás: la distinción honesta entre subagente y equipo — para dejar de construir un enjambre de 12 agentes cuando con uno de cada bastaría.

Ya has usado subagentes (los ayudantes que Claude Code lanza dentro de una sesión para un trabajo lateral y que devuelven un resumen). La siguiente palabra confusa es equipos de agentes. No son lo mismo — y tratarlos como si lo fueran es como la gente acaba con doce archivos solapados y cero flujos funcionando.

La distinción honesta

⚡ Subagente = temporal e invisible
Se lanza a mitad de sesión para la parte sucia de un trabajo (leer 200 archivos, verificar un diff) y desaparece. No le pones nombre. No lo llamas la semana que viene. Existe para esa tarea y solo esa.
🗂️ Miembro de equipo = con nombre, reutilizable, persistente
Una plantilla pequeña de especialistas — cada uno con su archivo .md, su SOUL, su JOB, sus herramientas. Los invocas por nombre. La plantilla aparece igual cada lunes.

🧠 El modelo mental más simple: los subagentes son el contratista que tu asistente ficha para una tarde. Tu equipo es el personal en nómina.

Cuándo un equipo gana a un solo agente grande

Te ganas el derecho a un equipo cuando la voz de un agente no puede serlo todo: el investigador quiere ser exhaustivo, el redactor contundente, el revisor brutal — un solo archivo de personalidad no puede sostener las tres con credibilidad, y la salida se vuelve papilla. También cuando las piezas se van a intercambiar: un redactor afinado a una marca se saca y se sustituye por el de otra marca sin reconstruir el resto de la línea.

TeamCreate en una frase

TeamCreate es el atajo para levantar un equipo en vivo, en la sesión: describes la plantilla que quieres y crea los compañeros como agentes corriendo en sesión, con un config.json y una lista de tareas compartida por la que se coordinan — no una carpeta de archivos que editas a mano. (Editar archivos .md individuales es el flujo aparte de /agents, donde vive el SOUL/JOB/KEYS/parada de cada especialista.) TeamCreate cuando quieres la plantilla trabajando ya; /agents cuando quieres especialistas con nombre, afinados a mano, que reutilizas cada semana.

Lo que los principiantes hacen mal

Hecho cuando: puedes enunciar en una frase la diferencia entre subagente y miembro de equipo — y has levantado un equipo en vivo con TeamCreate o escrito a mano una plantilla de 3 archivos vía /agents.
Fuente: Claude Code Club · Aula · Etapa 7 «Agents» — lección «Equipos de agentes vs. subagentes (y cuándo TeamCreate)».
Nota: lección de texto, sin infografía. · Añadido al cuaderno: 7 de julio de 2026. Traducción al español para estudio personal.