El arnés de un agente de código: por qué importa tanto como el modelo

Una tienda de recambios de Valladolid encarga corregir el formulario de solicitud de presupuesto de su web. El agente cambia unos archivos y anuncia que ha terminado. ¿Basta con eso para publicarlo? Este ejemplo ilustrativo no corresponde a un cliente real ni a una prueba ejecutada, y no tiene ahorros medidos. La prueba consiste en corregir el formulario sobre una copia, sin pedidos reales ni claves de acceso a la web publicada. La persona responsable prueba el envío desde ordenador y móvil. El proveedor técnico revisa el cambio y decide si se publica.

Un agente de código es un programa que usa IA para decidir pasos y trabajar sobre archivos con herramientas. El modelo interpreta el encargo y propone acciones. El arnés aporta el entorno para ejecutarlas: prepara el contexto, llama a las herramientas y devuelve sus resultados al modelo. Ajustar ese entorno se llama harness engineering. No es volver a entrenar la IA. Usa el caso del formulario para decidir qué pedir a tu equipo técnico.

En Claude Code, CLAUDE.md recoge las instrucciones del proyecto: qué hace la web, qué restricciones tiene y cómo se comprueba un cambio. Una skill reúne un procedimiento reutilizable, con instrucciones y recursos. Por ejemplo, puede reunir la forma de revisar una entrega. Ninguna de esas piezas sustituye al arnés que ejecuta el trabajo. Empieza por la información que el agente no puede deducir del proyecto y que necesita para este encargo. Añadir reglas por si acaso no demuestra que vaya a trabajar mejor.

Comprueba qué se ha cargado. No trates CLAUDE.md y AGENTS.md como archivos intercambiables en cualquier sesión: la lectura del segundo depende de la versión y la configuración. Si el proyecto ya usa el primero, puede necesitar una importación explícita. El equipo puede revisar el contexto con /context all. También debe comprobar los ajustes al pasar a una sesión en la nube: no hereda sin más todos los permisos, procedimientos o ajustes locales. Encontrarás más detalle en el archivo de instrucciones.

El equipo puede gestionar las reglas con /permissions y guardar los ajustes compartidos en .claude/settings.json. El aislamiento de comandos se revisa con /sandbox.

Revisa también el programa que ejecuta cada hook: su nombre no demuestra qué comprueba ni qué acciones puede realizar.

Claude Code guarda normalmente transcripciones de las sesiones y permite obtener una copia legible con /export. Esa transcripción ayuda a entender qué ha ocurrido, pero no equivale por sí sola a un registro empresarial inmutable: existen ajustes de conservación. Para revisar el formulario, pide los cambios, los resultados y las decisiones pendientes, además del historial que resulte útil. Acuerda quién conserva esa entrega y quién revisa los errores. Una respuesta del agente diciendo «todo correcto» no sustituye el criterio de quien recibe el trabajo.

Para saber si un ajuste ayuda, usa un conjunto fijo de encargos. Repite las mismas tareas con el mismo modelo, datos y criterios; anota fallos, consumo y tiempo de revisión. Compara también las variaciones entre repeticiones. Una evaluación oficial muestra que modelo y arnés interactúan, pero no demuestra un porcentaje universal de mejora ni un ahorro para tu negocio. Cuando algo falle, identifica primero si faltaba información, acceso o una comprobación. Añade una regla solo cuando resuelva ese problema. Más piezas también significan más cosas que entender y mantener. Aplica esta comparación a la corrección del formulario antes de añadir más reglas.

Empieza por un encargo concreto: acuerda con tu proveedor qué resultado aceptarás, qué accesos necesita y quién revisará la entrega. Si necesitas aclarar las piezas, consulta qué es un arnés de agentes; para preparar el trabajo con la herramienta, sigue la guía completa de Claude Code o el curso Claude Code a fondo. Antes de ampliar la prueba del formulario, pide que te enseñen el resultado, las comprobaciones y los límites de acceso.