Crear un equipo de subagentes para Claude Code y Codex

Un solo agente puede hacer mucho, pero lo aborda todo desde el mismo punto de vista. Un equipo de subagentes especializados trabaja mejor: uno planifica, otro revisa, otro escribe tests. Claude Code y Codex lo permiten, y la configuración es más sencilla de lo que parece.

Qué es un subagente

Un subagente es un agente independiente con su propia tarea, sus propias instrucciones y, si lo desea, permisos restringidos. El agente principal le encarga una subtarea; el subagente trabaja en su propio contexto y devuelve su resultado. Esto tiene dos ventajas: el agente principal no se dispersa, y un revisor que solo puede leer no puede romper nada.

Subagentes en Claude Code

Claude Code lee los subagentes de archivos Markdown:

~/.claude/agents/ se aplica a todos los proyectos de la máquina.
.claude/agents/ en el repositorio se aplica solo a ese proyecto y viaja con el código.

Un archivo tiene este aspecto:

---
name: reviewer
description: "Revisa los cambios en busca de errores, tests que faltan y problemas de seguridad. Usar de forma proactiva antes de hacer commit."
tools: Read, Grep, Glob, Bash
model: inherit
---

Eres el revisor del equipo. No modificas ningún archivo …

Lo importante es la description: Claude Code elige los subagentes por sí mismo a partir de esta descripción. Ayudan formulaciones como «Usar de forma proactiva cuando …». También puede encargar una tarea a un subagente directamente: «Haz que el reviewer revise los últimos cambios». Con /agents los gestiona en Claude Code.

Subagentes en Codex

Codex usa archivos TOML, con el mismo esquema:

~/.codex/agents/ para todos los proyectos,
.codex/agents/ en el repositorio.

name = "reviewer"
description = "Revisa los cambios en busca de errores, tests que faltan y problemas de seguridad."
sandbox_mode = "read-only"
developer_instructions = '''
Eres el revisor del equipo. No modificas ningún archivo …
'''

Con sandbox_mode = "read-only", el agente solo puede leer. A diferencia de Claude Code, Codex suele recurrir a subagentes solo cuando usted o una instrucción se lo piden. Por eso conviene incluir una breve lista del equipo en AGENTS.md, por ejemplo: «reviewer: pedirle una revisión tras cambios en el código y antes de cada commit». Codex inicia los subagentes en paralelo y resume sus resultados.

Un equipo inicial razonable

planer (planificación): lee el código y, antes de tareas grandes, entrega un plan en pasos pequeños (solo lectura).
reviewer (revisión): revisa los cambios antes del commit (solo lectura).
tester (tests): escribe tests y ejecuta la batería de tests.
sicherheit (seguridad): busca vulnerabilidades en el inicio de sesión, los pagos, las subidas de archivos y las entradas de usuario (solo lectura).
debugger (depuración): busca la causa de los errores y asegura la corrección con un test.
doku (documentación): mantiene el README y las guías al día con el código.

En cada euhost Box este equipo ya viene configurado, para Claude Code y para Codex. Encontrará los archivos en ~/.claude/agents/ y ~/.codex/agents/ y puede adaptarlos o eliminarlos.

Consejos prácticos

Los agentes específicos de un proyecto van en el repositorio (.claude/agents/, .codex/agents/). Así todo su equipo tiene los mismos agentes y los cambios pasan por Git.
Descripciones concretas. «Revisa código» es demasiado vago; «antes de cada commit, con foco en tests que faltan y en el manejo de errores» da en el clavo.
Permisos mínimos. Quien solo debe revisar recibe únicamente acceso de lectura.
Los agentes en paralelo consumen tokens. Cada subagente gasta cuota de su suscripción de Claude u OpenAI. Para cambios pequeños basta con el agente principal.