AI Open Guide
← Claude · Para quienes construyen

1En una frase

Un agente es Claude funcionando en un bucle (pensar, usar una herramienta, mirar el resultado, repetir) hasta terminar un trabajo, y hay tres formas de construir uno, de más a menos trabajo.

2Palabras nuevas

  • Agente (Agent) — Claude con herramientas y un objetivo, avanzando por pasos por su cuenta. Cowork y Claude Code son agentes que construyó Anthropic; tú puedes construir los tuyos.
  • Bucle del agente (Agent loop) — el ciclo: Claude decide, llama a una herramienta, lee el resultado y vuelve a decidir. Termina cuando Claude dice que el trabajo está hecho o cuando se llega a un límite.
  • Agent SDK — una biblioteca (Python o TypeScript) que le da a tu programa el mismo motor que usa Claude Code: herramientas, permisos, sesiones, ayudantes, hooks, MCP, skills.
  • Managed Agents — Anthropic aloja el agente por ti: el bucle, el entorno aislado (un ordenador seguro donde trabaja), la memoria, la programación. Tú envías tareas y lees los resultados.
  • Entorno aislado (Sandbox) — un ordenador separado donde el agente puede ejecutar código y usar archivos sin tocar nada más.

3Para qué te sirve

Un chatbot responde preguntas. Un agente se pone al día con el trabajo pendiente: lee cada ticket de soporte y prepara respuestas, revisa una web cada noche, mantiene un informe actualizado. Las tres opciones te dejan elegir cuánto quieres gestionar tú.

OpciónTú escribesAnthropic poneIdeal para
Tu propio bucle (Client SDK)El bucle, la ejecución de herramientas, la seguridadEl modelo y las funciones de la APIControl total; agentes pequeños y concretos
Agent SDKTus herramientas y reglasTodo el motor de Claude CodeAgentes dentro de tu propio producto o servidores
Managed AgentsUna descripción del agente y sus herramientasAlojamiento, entorno aislado, memoria, programación, coordinación de varios agentesTrabajo largo o sin supervisión, rápido de poner en marcha

4Pruébalo ahora

(cuenta de desarrollador; Claude Code ayuda)

  1. Pídele a Claude Code: Usando el Agent SDK, construye un agente muy pequeño que lea cada archivo de una carpeta y escriba summary.md con una línea por archivo. Limítalo a leer y escribir en esa carpeta.
  2. Ejecútalo en una carpeta con diez archivos. Lee summary.md.
  3. Añade una regla: Pregunta antes de escribir si summary.md ya existe.

5Lo que verás

[Imagen pendiente: el registro de ejecución del agente y el archivo de resumen.] Un programa corto; al ejecutarlo, un registro de cada paso (leyendo el archivo 1, 2, ...) y el resumen terminado. Managed Agents muestra lo mismo como una sesión que puedes seguir en la consola.

6Cuidado

  • Pon límites a cada agente: qué carpeta, qué herramientas, cuánto puede gastar, cuándo debe preguntar. Un agente sin límites es un bucle sin fin.
  • Empieza con agentes que solo lean. Añade escribir, enviar y comprar solo después de haber visto muchas ejecuciones.

7Ve más allá

Dale un horario al agente (Capítulo 6.9) y se convierte en un compañero que trabaja de noche. El Capítulo 6.10 es el capítulo de seguridad y coste que debes leer antes de dejarlo hacerlo.