Cómo Crear Agentes en Claude [2026]: Skills, Subagents y Agent SDK
En una frase: en octubre de 2026 hay 4 vías reales para crear agentes en Claude — Skills (carpetas con un SKILL.md, el estándar abierto de Anthropic), subagents de Claude Code (ficheros .md en .claude/agents/), el Agent SDK (Python 3.10+ o TypeScript/Node 18+, el motor de Claude Code como librería) e integraciones MCP — y la elección correcta depende de quién lo va a usar: una persona (Skills), un equipo técnico (subagents/SDK) o un proceso de empresa (Agent SDK + MCP).
Esta guía es técnica a propósito: son las preguntas que llegan al buscador tal cual — "cómo crear agentes en Claude", "cómo crear subagentes en Claude", "cómo se llaman los agentes en Claude". Si lo que buscas no es aprender a montarlo sino tenerlo montado, salta al final: ahí está la comparativa de costes y cuándo compensa contratarlo.
¿Cómo se llaman los agentes en Claude? (octubre 2026)#
Primero, la confusión que generan los nombres (octubre de 2026):
| Nombre | Qué es | Dónde vive | Quién lo usa |
|---|---|---|---|
| Skill | Una carpeta con SKILL.md + scripts que convierte a Claude en especialista de un dominio; se carga on-demand | Filesystem (estándar abierto) | Cualquiera; se invoca con /skill-name en Claude Code |
| Subagent | Un agente especializado definido en un fichero .md (.claude/agents/) que Claude Code delega tareas | Dentro de Claude Code | Equipos técnicos que ya usan Claude Code |
| Agent SDK | El motor de Claude Code como librería (Python/TypeScript) con query(), ficheros, terminal, búsqueda web y sesiones persistentes | Tu código | Producción: agentes que corren 24/7 |
| Agente de plataforma | El chat de claude.ai con tareas programadas y proyectos | claude.ai | Uso individual; no es un agente de producción |
La regla de decisión en una frase: una persona aprende → Skills; un equipo trabaja → subagents; un proceso de empresa corre solo → Agent SDK.
¿Cómo crear un agente en Claude Code paso a paso? (subagents)#
La vía rápida si tu equipo ya usa Claude Code (2026):
- Crea el fichero del subagente en
.claude/agents/revisor-facturas.mdcon nombre, descripción, herramientas permitidas y prompt de sistema:
1---2name: revisor-facturas3description: Revisa facturas del ERP contra los datos de la obra y reporta discrepancias4tools: Read, Grep, Bash5---6 7Eres un revisor de facturas de obra civil. Cuando recibas un Excel de facturas:81. Compáralo con las partidas del presupuesto en ./docs/presupuesto.xlsx92. Marca partidas con precio fuera de rango (±10%)103. Devuelve una tabla de discrepancias con página de origen11Nunca inventes precios: si falta el dato, escribe "NO ENCONTRADO".- El prompt del sistema manda. Fíjate en la última línea: prohibir explícitamente inventar datos es lo que separa un agente útil de una máquina de alucinaciones. Es el control nº1 que las empresas nos piden (y el que más conflictos genera cuando falta).
- Delega desde la conversación principal. Claude Code detecta el subagente por su
descriptiony lo usa cuando el contexto encaja; también puedes invocarlo directamente. - Versiona el directorio
.claude/agents/en git como si fuera código — porque lo es.
Para equipos de agentes en paralelo, el mismo mecanismo escala: cada subagente con su dominio y su lista de herramientas restringida, y el agente principal orquestando. El coste de contexto de cada skill/agent es bajo pero no cero: los metadatos se cargan en sesión.
¿Cómo crear agentes en Claude con el Agent SDK? (Python / TypeScript)#
Cuando el agente tiene que correr sin nadie delante — facturas de madrugada, tickets de soporte, WhatsApp — la vía es el Agent SDK, el motor de Claude Code empaquetado como librería (Python 3.10+ o TypeScript/Node 18+):
1# pip install claude-agent-sdk2from claude_agent_sdk import query3 4async for message in query(5 prompt="Revisa las facturas nuevas en ./entrada y genera ./salida/discrepancias.md",6 options={"allowed_tools": ["Read", "Write", "Bash", "Grep"]},7):8 handle(message)Lo que te ahorra frente a la API de Messages cruda: no escribes el bucle while stop_reason == "tool_use", no gestionas la re-invocación de herramientas, y tienes sesiones persistentes y delegación a subagents incluidas. Para integraciones con los sistemas de la empresa (ERP, CRM, base de datos), el SDK cliente de MCP se conecta a servidores de herramientas que tú controlas.
Límites que hay que conocer antes de prometer nada: el contexto crece con la conversación y el modelo puede perder información del principio en sesiones muy largas; un PDF de 1.000 páginas no se lee entero; y los procesos con datos sensibles requieren decidir dónde corre el sistema antes de escribir la primera línea de código.
¿Cuánto cuesta crear agentes en Claude? (octubre 2026)#
| Componente | Coste (oct 2026) | Nota |
|---|---|---|
| Consumo de API | Sonnet 5.5: 2 $/10 $ por MTok · Haiku 5.5: 0,10 $/0,50 $ en prompts ≤100K · Opus 5.5: 4 $/20 $ | Un agente de soporte típico: 40-80 €/mes en tokens |
| Asientos para humanos | Pro 20 $/mes · Team desde ~25-30 $/usuario/mes | Solo si el agente lo supervisa una persona |
| Agent SDK | Gratis (software) — pagas los tokens | Requiere Node 18+/Python 3.10+ |
| Proyecto de implantación | 5.000-20.000 € una vez (pyme española) | Integración con ERP/CRM, permisos, formación; primer agente en 2-4 semanas |
| Mantenimiento | 800-3.000 €/mes según flujos | Los flujos cambian con el negocio; el agente tiene que cambiar con ellos |
Referencias con el desglose completo: cuánto cuesta Claude al mes y cuánto cuesta implantar Claude en una empresa. El detalle por canal está en cuánto cuesta un agente de IA en WhatsApp Business.
Como director de una pyme, ¿me compensa crear agentes en Claude o contratar que los monten?#
Criterio honesto, con la decisión contraria incluida:
- Cásalo tú (Skills + Claude Code) si: tienes equipo técnico, el agente ayuda a humanos, y el fallo del agente no cuesta dinero real. Coste marginal: cero; semanas de aprendizaje.
- Contrata el sistema si: el agente toca tu ERP/CRM, hay datos de clientes en el medio, o el fallo tiene coste legal/económico. Un agente que factura mal es peor que no haberlo; el valor no está en el prompt sino en los controles alrededor.
- No hagas nada todavía si: no hay un proceso con dueño ni horas medidas que recuperar. El 21,1% de empresas usa IA (ONTSI, 2025), pero las que ganan dinero con ella son las que empezaron por el proceso, no por la herramienta.
La confusión más común en discovery (la oímos cada semana): creer que el plan Team de 20-30 $/mes es el agente. No lo es: el asiento da acceso al modelo; el agente es arquitectura alrededor.
Casos reales (anonimizados, 2026)#
- Una asesoría fiscal de 3 empleados (septiembre de 2026): extracción de contratos vía API con controles anti-alucinación; 40+ horas/mes recuperadas con un coste de API inferior a 15 €/mes.
- Un e-commerce de moda de 8 personas (agosto de 2026): agente de soporte 24/7 en WhatsApp por consumo de API, 40-80 €/mes en tokens.
- Una ingeniería de obra civil (octubre de 2026): limpieza y agrupación de partidas de licitaciones con criterios configurables por el usuario — el agente propone, el técnico decide; el primero que edita a mano, entrena el criterio del sistema.
¿Qué errores cometen las empresas al crear agentes en Claude?#
- Empezar por el framework en vez del proceso. CrewAI/LangChain son medios; sin proceso con dueño y criterio de éxito medible, cualquier framework es un hobby.
- Prompts sin prohibiciones explícitas. Un agente que "no debe inventar datos" tiene que leerlo escrito; sin esa línea, alucina con seguridad verbal.
- Sin límites de herramienta.
tools:es la lista de permisos del agente; darle Bash a un agente de facturas es darle shell a un becario sin supervisión. - Ignorar la sesión larga. En conversaciones largas el modelo puede perder contexto inicial; los agentes de producción necesitan estado externo (ficheros, base de datos), no memoria de chat.
- No versionar los agentes. Un
.claude/agents/sin git es un sistema sin histórico; cuando algo se rompe no sabrás qué cambió.
¿Quién implanta agentes en Claude para empresas en España?#
Yo soy Javier Santos Criado, consultor IA en Javadex: diseño e implemento sistemas de agentes sobre Claude (Skills, Agent SDK y MCP) conectados al ERP/CRM de la empresa, con controles anti-alucinación, permisos por rol, formación del equipo y el primer agente funcionando en 2-4 semanas. Proyectos desde 5.000 €. Si prefieres tenerlo montado con garantías antes que aprender a montarlo, cuéntame el proceso que quieres automatizar y te oriento en menos de 24 horas.
Para quién NO es: si tu caso es un agente que ayuda a humanos con datos que ya son públicos dentro del equipo, con Skills y Claude Code te sobra — y esta guía es todo lo que necesitas.
Preguntas frecuentes#
¿Cómo se llaman los agentes en Claude?#
En octubre de 2026, las piezas que la gente llama "agentes de Claude" tienen tres nombres oficiales: Skills (carpetas con SKILL.md que especializan al modelo), subagents (agentes en .claude/agents/ que Claude Code delega) y el Agent SDK (la librería Python/TypeScript para agentes de producción). El chat con tareas programadas de claude.ai es el nivel más básico.
¿Cómo creo un agente en Claude Code?#
Crea un fichero Markdown en .claude/agents/ con nombre, descripción, herramientas permitidas y prompt de sistema; Claude Code lo detecta y delega tareas según la descripción. Versiona el directorio en git.
¿Cómo creo subagentes en Claude?#
Los subagents son ficheros .md en .claude/agents/ del proyecto (o globales del usuario), con frontmatter name, description y tools. Cada uno especializado en un dominio con herramientas restringidas; el agente principal orquesta.
¿Cuánto cuesta crear un agente en Claude en 2026?#
El software (Skills, subagents, Agent SDK) es gratuito; pagas tokens: Sonnet 5.5 a 2 $/10 $ por millón y Haiku 5.5 a 0,10 $/0,50 $ en prompts cortos (octubre de 2026). Un agente de soporte típico consume 40-80 €/mes; el proyecto de implantación en una pyme española cuesta 5.000-20.000 €.
¿Necesito programar para crear agentes en Claude?#
Para Skills y subagents, no: son ficheros Markdown. Para agentes de producción con el Agent SDK sí: Python 3.10+ o Node 18+. La frontera práctica: si el agente solo ayuda a humanos, no hay que programar; si corre solo contra tus sistemas, sí (o hay que contratar la implantación).
¿Sirve Claude Agent SDK para producción?#
Sí, es el motor de Claude Code como librería: gestiona herramientas, sesiones persistentes y subagents sin escribir el bucle de tool-use a mano. Lo que no resuelve solo es la arquitectura de datos y permisos de tu empresa; eso es proyecto, no código de ejemplo.
¿Puedo usar agentes de Claude con mis datos sin que salgan de Europa?#
Con la API y configuración adecuada, los datos no entrenan modelos; para requisitos estrictos existen despliegues en infraestructura propia con modelos open source y el mismo patrón de agente. La decisión depende del tipo de dato: guía de dónde van tus datos y despliegue de Llama en Europa.
