Agente de programación (coding agent)
Un agente de programación es un sistema basado en un modelo de lenguaje que, dentro de un bucle con herramientas, explora un repositorio, edita archivos, ejecuta comandos y tests, y corrige su trabajo hasta completar una tarea.
Un agente de programación es un modelo de lenguaje conectado a herramientas reales de desarrollo (sistema de archivos, terminal, git, tests) que trabaja en bucle para completar tareas de software de principio a fin. No se limita a sugerir líneas de código: lee el repositorio, decide qué cambiar, aplica los cambios, comprueba si funcionan y corrige lo que falla. En el ecosistema de Anthropic, el ejemplo de referencia es Claude Code, y la misma arquitectura está disponible para construir agentes propios con el Claude Agent SDK.
Cómo funciona
El núcleo es el bucle agéntico: el modelo recibe una tarea, elige una herramienta, observa el resultado y decide el siguiente paso, hasta que considera la tarea terminada o necesita intervención humana. En una sesión típica:
- Exploración: busca con grep o glob, lee archivos relevantes y entiende la estructura del proyecto.
- Planificación: descompone la tarea, a menudo con una lista de pasos visible para el usuario.
- Edición: modifica archivos mediante herramientas de escritura o de reemplazo de fragmentos.
- Verificación: ejecuta tests, linters, el compilador o el propio programa, y lee la salida.
- Iteración: si algo falla, interpreta el error y vuelve a editar.
Todo esto se apoya en el uso de herramientas (tool use) de la API de Claude. Alrededor del modelo hay piezas que marcan la diferencia en la práctica: un sistema de permisos que define qué puede hacer sin preguntar, archivos de memoria como CLAUDE.md con las convenciones del proyecto, compactación del contexto para sesiones largas, subagentes para delegar subtareas y hooks para ejecutar comprobaciones automáticas.
Por qué importa
Cambia la unidad de trabajo. Con un autocompletado delegas una línea; con un agente delegas una tarea: arreglar un bug, migrar una dependencia, añadir un endpoint con sus tests. Eso tiene consecuencias concretas:
- Los tests pasan a ser la interfaz. Un agente rinde mucho mejor cuando tiene una forma objetiva de saber si acertó. Un repositorio sin tests limita su autonomía real.
- La especificación vale más que el prompt ingenioso. Describir bien el objetivo, las restricciones y el criterio de terminado ahorra iteraciones.
- Tu rol se desplaza hacia la revisión: leer diffs, cuestionar decisiones de diseño y aprobar cambios.
- El coste se mide en tokens y tiempo, no en peticiones. Una tarea compleja puede implicar decenas de llamadas a herramientas y leer mucho código.
- La seguridad importa: el agente ejecuta comandos en tu máquina o en un entorno remoto, así que permisos, sandbox y cuidado con la inyección de prompts desde archivos o webs no son opcionales.
Un caso reconocible
Pides a Claude Code: "El endpoint de exportación devuelve 500 con fechas vacías, arréglalo y añade un test". El agente localiza el controlador, reproduce el fallo escribiendo un test que falla, corrige el parseo, ejecuta la suite completa, detecta que otro test dependía del comportamiento antiguo, lo ajusta y te presenta el diff con un resumen. Tú revisas y haces commit. Las mismas tareas pueden lanzarse en segundo plano desde Claude Code en la web, que trabaja en un entorno en la nube y propone el resultado como rama o pull request. Si quieres aprender a trabajar a diario con Claude Code, el punto de partida es dominar este ciclo de delegar, verificar y revisar.
La calidad de un agente depende tanto del modelo como del arnés: las mismas capacidades de Claude rinden distinto según las herramientas, permisos y contexto que reciba. Por eso las cifras de benchmarks como SWE-bench varían entre versiones de modelo y configuraciones.
Errores comunes
- Confundirlo con un asistente de autocompletado. El autocompletado no ejecuta ni verifica nada; el agente sí actúa sobre el entorno.
- Confundirlo con vibe coding. Vibe coding es una forma de trabajar aceptando código sin revisarlo; un agente de programación es la herramienta, y puede usarse con total rigor.
- Darle máxima autonomía desde el primer día. Conviene empezar con permisos restrictivos y ampliarlos según la confianza y el riesgo del proyecto.
- Asumir que "terminado" significa "correcto". El agente puede declarar éxito con tests débiles o malinterpretar el requisito. La revisión humana sigue siendo necesaria.
Preguntas frecuentes
¿Qué diferencia hay entre un agente de programación y GitHub Copilot o un autocompletado?
El autocompletado sugiere código mientras escribes y tú decides qué aceptar. Un agente de programación recibe una tarea completa, lee el repositorio, edita varios archivos, ejecuta tests y comandos e itera hasta terminarla, pidiendo permiso según la configuración.
¿Puedo construir mi propio agente de programación con Claude?
Sí. El Claude Agent SDK expone el mismo arnés que usa Claude Code (bucle agéntico, herramientas, permisos, gestión de contexto), y también puedes montarlo directamente sobre la API usando tool use, aunque tendrás que implementar tú el bucle y las herramientas.
¿Es seguro dejar que un agente ejecute comandos en mi máquina?
Depende de cómo lo configures. Lo recomendable es usar permisos granulares, aprobar manualmente comandos destructivos, trabajar en ramas o contenedores aislados y desconfiar de instrucciones que el agente lea en archivos o páginas externas, por el riesgo de inyección de prompts.
¿Qué necesita un proyecto para que un agente rinda bien?
Tests que se puedan ejecutar con un comando, instrucciones claras sobre convenciones y comandos en un archivo como CLAUDE.md, y tareas bien acotadas con un criterio de terminado verificable.