01 Qué es un agente en la práctica
Un agente no es más que tres cosas juntas: una tarea delimitada (revisar PRs, clasificar correos, vigilar una web), las herramientas que necesita y nada más, y unas instrucciones estables que definen cómo trabaja y qué entrega. Si además se ejecuta por su cuenta en un horario, deja de ser una herramienta que usas y pasa a ser un trabajo que se hace solo.
| Pieza de Claude Code | Para qué sirve en un agente |
|---|---|
| Subagente (.claude/agents/) | Un especialista con sus propias instrucciones, herramientas y modelo, al que Claude delega trabajo |
| Skill | Un procedimiento reutilizable que se invoca con /nombre o que Claude carga cuando hace falta |
| Servidores MCP | El acceso a herramientas externas: GitHub, bases de datos, CRM, documentos |
| /loop, tareas de escritorio y rutinas | La ejecución periódica sin que tengas que lanzarlo |
02 Elegir el primer agente
El mejor primer agente resuelve una tarea que haces a menudo, con criterios claros y donde un error es fácil de detectar. Revisar código, preparar un resumen o clasificar entradas encajan bien. Decidir pagos o responder a clientes sin revisión, no. Si no tienes clara la tarea, deja que Claude te entreviste.
Quiero crear mi primer agente con Claude Code, pero no tengo claro cuál. Entrevístame: hazme preguntas de una en una sobre mi trabajo, las tareas que repito cada semana, las herramientas que uso y dónde pierdo más tiempo. Cuando tengas suficiente información, propón tres agentes posibles. Para cada uno indica: qué haría exactamente, qué herramientas o accesos necesita, qué riesgo tiene si se equivoca y cuánto tiempo calculas que me ahorraría. Recomienda con cuál empezar y por qué.03 Planificar antes de construir
-
1
Abre Claude Code en el proyecto
Ejecuta claude en la carpeta del repositorio o del espacio de trabajo del agente.
-
2
Activa el modo plan
Pulsa Shift+Tab hasta ver «plan mode on», o empieza el mensaje con /plan. Claude investiga sin tocar nada.
-
3
Describe el agente
Qué hace, qué lo dispara, qué entrega y qué no debe hacer nunca.
-
4
Revisa el plan
Comprueba que pide solo los accesos necesarios y que hay un punto de revisión humana antes de cualquier acción irreversible.
-
5
Aprueba y construye
Al aprobar, Claude crea los archivos del agente y te explica cómo probarlo.
/plan Quiero un agente que revise pull requests de este repositorio.
Debe:
1. Leer los cambios de la PR y el contexto de los archivos afectados.
2. Buscar errores probables, problemas de seguridad, código duplicado y desviaciones de las convenciones del proyecto (léelas en CLAUDE.md y en la configuración del linter).
3. Entregar un informe con hallazgos ordenados por gravedad, cada uno con archivo, línea y sugerencia.
Restricciones: solo lectura sobre el código; nunca aprueba ni fusiona PRs; los comentarios en GitHub los publico yo.
Diseña el agente como subagente de Claude Code, indica qué herramientas necesita y cómo lo pruebo con una PR existente.04 Definir el agente como subagente
Un subagente es un archivo Markdown con una cabecera de configuración y unas instrucciones. Si lo guardas en .claude/agents/ del proyecto, lo comparte todo el equipo a través del repositorio; en ~/.claude/agents/ queda disponible en todos tus proyectos. Claude Code detecta los cambios en esos archivos sin reiniciar, salvo cuando la carpeta no existía al empezar la sesión.
---
name: revisor-pr
description: Revisa pull requests de este repositorio y entrega un informe de hallazgos ordenado por gravedad. Úsalo cuando se pida revisar una PR o un conjunto de cambios.
tools: Read, Glob, Grep, Bash
model: sonnet
---
Eres el revisor de código de este proyecto.
1. Obtén el diff de la PR indicada y lee el contexto de cada archivo modificado.
2. Comprueba errores de lógica, seguridad (entradas sin validar, secretos, permisos), rendimiento y duplicación.
3. Contrasta con las convenciones de CLAUDE.md.
4. Devuelve una lista ordenada: crítico, alto, medio, bajo. Para cada hallazgo: archivo, línea, problema y sugerencia concreta.
No modificas archivos, no apruebas ni fusionas PRs y no publicas comentarios.05 Conectar herramientas externas con MCP
Cuando el agente necesita algo fuera del ordenador (las PRs de GitHub, tu CRM, una base de datos), se conecta mediante un servidor MCP. Por ejemplo, el servidor remoto oficial de GitHub se añade con un token personal de acceso con permisos limitados a los repositorios que quieras:
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
--header "Authorization: Bearer TU_TOKEN_DE_GITHUB"
# Comprueba dentro de la sesión que aparece con una marca verde
/mcp06 Ponerlo a trabajar solo
/loop 2h usa el subagente revisor-pr para revisar las PRs abiertas sin revisión y dame el resumen
/schedule cada día laborable a las 8:00, revisa las PRs abiertas del repositorio y deja un informe- ✓/loop sirve mientras tienes la sesión abierta y caduca a los 7 días.
- ✓Las tareas programadas de la app de escritorio corren en tu ordenador con tus archivos, siempre que la app esté abierta.
- ✓Las rutinas en la nube (/schedule) funcionan con el ordenador apagado, sobre un repositorio de GitHub clonado y sin pedir permisos.
- ✓Revisa las primeras ejecuciones a mano antes de confiar en el agente.
- ✓Cada ejecución gasta uso de tu plan: ajusta la frecuencia a lo necesario.
Preguntas frecuentes
No para un agente sencillo: Claude Code escribe el archivo del subagente y la configuración. Sí necesitas saber describir bien la tarea y revisar lo que hace, sobre todo al principio.
El subagente trabaja en su propio contexto, con sus herramientas y su modelo, y devuelve un resultado. El skill es un procedimiento que se carga en la conversación principal. Para tareas autónomas y delimitadas, subagente; para procedimientos que reutilizas a mano, skill.
Depende de los permisos que le des y del modo en que corra. Las rutinas en la nube no piden permiso, así que limita repositorios y conectores. Para acciones irreversibles, diseña siempre un paso de revisión humana.
Sí. Los subagentes en .claude/agents/ viajan con el repositorio. Si quieres distribuirlos en varios proyectos, empaquétalos como plugin.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.