Cómo definir un subagente
# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews a diff for correctness, security and test coverage. Use after any non-trivial change.
tools: Read, Grep, Glob, Bash(git diff *)
model: sonnet
---
You are a senior reviewer. Read the staged diff, list concrete defects with file:line,
flag untested paths, and stop. Do not edit files.name es la forma de llamarlo; description es lo que permite a Claude decidir llamarlo por su cuenta, así que escríbelo como una regla de enrutamiento («usar después de cualquier cambio no trivial») en lugar de un cargo. tools restringe lo que puede hacer: un revisor que no puede editar es un revisor más seguro. model fija un nivel: haiku para exploración y clasificación, sonnet para la mayoría del trabajo, opus para el paso difícil, o inherit para seguir la sesión principal.
Agentes de proyecto frente a agentes de usuario
Los archivos de .claude/agents/ pertenecen al repositorio y se distribuyen con él: inclúyelos en un commit y todos los integrantes del equipo tendrán el mismo revisor, creador de pruebas y agente de migración. Los archivos de ~/.claude/agents/ son tuyos en todos los proyectos. Los agentes de proyecto tienen prioridad si hay un conflicto de nombres. /agents dentro de una sesión permite listar, crear y editar ambos tipos sin modificar los archivos manualmente.
Cuándo delega Claude
De dos formas. Implícita: el agente principal lee la descripción de cada subagente y delega cuando una tarea coincide; no hace falta decir «ejecuta el subagente code-reviewer para esto» si la descripción ya indica cuándo usarlo. Explícita: nómbralo en el prompt. En ambos casos, el subagente se ejecuta en su propio contexto, solo ve lo que se le proporciona y lo que lee, y devuelve un resultado que la sesión principal resume en su propio historial. Los subagentes no crean otros subagentes; la jerarquía tiene un solo nivel de profundidad.
Por qué mantienen bajo el coste de las sesiones
Cada turno de Claude Code vuelve a enviar toda la conversación. Un subagente que lee cuarenta archivos lo hace en su propia ventana de contexto; el agente principal recibe un párrafo. Sin subagentes, esos cuarenta archivos permanecerían en el contexto principal durante el resto de la sesión y se volverían a enviar en cada turno. Por eso, el patrón para bases de código grandes es: explorar con un subagente Haiku, revisar con un subagente Sonnet y reservar el contexto del agente principal para las decisiones. Cada subagente factura sus propios tokens: no es gratuito, pero su consumo queda acotado.
Paralelismo y límites de solicitudes
Pueden ejecutarse varios subagentes a la vez, y cada uno constituye una solicitud de streaming en paralelo. Esa es la forma más rápida de alcanzar el límite de solicitudes simultáneas de cualquier endpoint, así que, en una cuenta nueva de la pasarela, empieza con dos o tres en paralelo y solicita una mayor concurrencia cuando la carga de trabajo sea real. La guía de errores explica los 429 que recibirás de lo contrario.
Equipos de agentes
Las versiones más recientes de Claude Code incorporan equipos de agentes: en lugar de un agente principal que delega en subagentes de corta duración, varias sesiones se coordinan como miembros con nombre propio, con una lista de tareas compartida y mensajes entre ellas, de modo que un responsable puede repartir trabajo, pedir información sobre el estado y detener a un miembro. Es una función experimental que se activa mediante un ajuste y cambia entre versiones; consulta claude --help y el registro de cambios para conocer el parámetro actual, en lugar de una entrada de blog. El modelo conceptual es el mismo que el de los subagentes, con persistencia y comunicación añadidas; el modelo de costes también es el mismo, multiplicado por los miembros del equipo.
En la pasarela
Los subagentes y los equipos usan el mismo endpoint y la misma clave que la sesión principal, por lo que ANTHROPIC_BASE_URL=https://aiprimetech.io los cubre a todos. En un plan ilimitado de tarifa plana, la cuestión del paralelismo pasa a ser una cuestión de uso razonable en lugar de facturación, por eso los usuarios que hacen un uso intensivo de varios agentes suelen acabar eligiéndolo.
| Plan | Duración | Precio |
|---|---|---|
| Uso ilimitado durante 1 hora | 1 hora | $1 |
| Uso ilimitado durante 24 horas | 24 horas | $10 |
| Uso ilimitado durante 1 semana | 1 semana | $49 |
| Uso ilimitado durante 15 días | 15 días | $89 |
Pruébalo gratis primero
Las cuentas nuevas reciben $5 de crédito gratuito para la API con el código CLAUDECODE — suficiente para una tarde de Claude Code con Sonnet — y después créditos por 7.69231× su valor nominal.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyPreguntas frecuentes
¿Qué es un subagente en Claude Code?
Un agente independiente con su propio prompt de sistema, permisos de herramientas, elección de modelo y ventana de contexto, definido como un archivo Markdown en .claude/agents/, al que la sesión principal delega tareas.
¿Dónde está la documentación de subagentes de Claude Code?
La referencia oficial está en la documentación de Claude Code de Anthropic, en la sección de subagentes; esta página es la versión práctica: el formato del archivo, cuándo se produce la delegación y cuánto cuesta.
¿Los subagentes tienen un coste adicional?
Facturan sus propios tokens como cualquier solicitud. Ahorran dinero en sesiones largas al mantener las lecturas extensas fuera del contexto principal, y cuestan más si ejecutas muchos en paralelo con Opus.
¿Qué son los equipos de agentes?
Una extensión experimental en la que varias sesiones de Claude Code se coordinan como miembros con nombre propio, con mensajería y una lista de tareas compartida, en lugar de un agente principal y ayudantes de corta duración.
Ejecuta Claude Code con la pasarela
Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código CLAUDECODE.
Obtener una clave de API Ver planes ilimitadosAI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.