Qué es un agent harness y cómo funciona
Un agent harness rodea al modelo con bucles, herramientas, permisos, estado de sesión y directorio de trabajo. Conozca en qué se diferencia de un modelo y un framework.
Qué es un agent harness
Un agent harness es el programa que se ejecuta alrededor de un modelo de lenguaje y lo convierte en un agente. Contiene el bucle que sigue llamando al modelo, las definiciones de las herramientas que el modelo puede usar, las reglas de permisos que determinan cuáles de esas llamadas se ejecutan realmente, el estado de la sesión que se conserva entre turnos y el directorio de trabajo donde se realizan las tareas. El modelo se puede sustituir dentro del harness.
La última frase es la que debe recordar. Un modelo por sí solo responde a una pregunta y se olvida de usted. Un harness pregunta al modelo qué debe hacer a continuación, ejecuta el comando que el modelo solicita, le devuelve el resultado y vuelve a preguntar. Esa repetición es lo que se quiere decir con «agente». Si la terminología relacionada aún no está clara, la diferencia entre un agente de IA, un LLM y un asistente aclara los términos antes de elegir una herramienta.
El arnés no es el modelo
Se confunden porque los proveedores los distribuyen con una misma marca.
dsh y DeepSeek son productos distintos. DeepSeek Harness, publicado en github.com/deepseek-ai/deepseek-harness el 13 August 2026 con licencia MIT, es un programa de Node que se instala en una máquina. Los modelos de DeepSeek son pesos servidos mediante una API (interfaz de programación de aplicaciones). Apunte dsh a un modelo de otro proveedor y seguirá funcionando, porque el arnés sólo necesita algo que acepte mensajes y devuelva llamadas a herramientas.
Claude Code y Claude forman el mismo par. Claude Code es un arnés: un programa de terminal con un bucle, un sistema de permisos y herramientas para archivos y shell. Claude es la familia de modelos que utiliza de forma predeterminada. Codex y Gemini CLI se dividen de la misma manera.
Esta es la prueba que lo resuelve siempre. Instale un arnés. Llame a un modelo. Si el elemento tiene una versión en el disco y un archivo de configuración en el directorio personal, es un arnés. Si es una cadena dentro de ese archivo de configuración, como deepseek-flash, es el modelo.
Qué hace realmente el bucle
Una iteración de un entorno de ejecución tiene este aspecto. Léala despacio, porque casi todas las diferencias entre entornos de ejecución se encuentran dentro de estos cinco pasos.
- El entorno de ejecución envía al modelo la conversación hasta ese momento, junto con una lista de definiciones de herramientas.
- El modelo responde con texto o solicita llamar a una de esas herramientas.
- El entorno de ejecución comprueba esa solicitud según sus reglas de permisos y la ejecuta o se detiene para pedirle confirmación.
- El entorno de ejecución ejecuta la herramienta, captura la salida y el código de salida, y trunca la salida si es muy larga.
- El entorno de ejecución añade el resultado a la conversación y vuelve al paso 1.
El paso 3 es donde más se diferencian los entornos de ejecución en el uso diario. Un entorno que pide confirmación antes de cada comando es seguro y agotador. Uno que nunca pide confirmación acabará ejecutando un comando destructivo sobre una ruta que el modelo interpretó mal. Claude Code admite una configuración intermedia: una lista de permitidos de comandos que se ejecutan sin pedir confirmación y un aviso para los demás comandos.
El paso 1 es donde se encuentra el resto de la diferencia. El entorno de ejecución también escribe el mensaje del sistema que acompaña a cada una de esas solicitudes, y Claude Code le proporciona directamente ese control, porque un estilo de salida modifica el mensaje del sistema que envía y, por tanto, cambia cada respuesta que recibe. La conversación crece en cada iteración y el modelo tiene una ventana de contexto fija, así que el entorno de ejecución debe decidir qué descartar, qué resumir y qué escribir en un archivo para leerlo más adelante. Esa decisión explica en gran medida por qué dos entornos de ejecución que usan el mismo modelo producen trabajos de distinta calidad. Si esos cinco pasos todavía parecen abstractos, la solución es escribir una vez su propio bucle sencillo. Eso es exactamente lo que una ruta gradual para aprender sobre agentes de IA le hace construir al principio.
Actualmente, la mayoría de los entornos de ejecución conectan herramientas externas mediante MCP (model context protocol), una forma estándar de exponer una herramienta a cualquier entorno de ejecución compatible, de modo que una sola integración funciona con varios entornos. Ejecutar servidores MCP en un VPS explica esa parte. La búsqueda web suele ser la primera herramienta que se añade, y dirigir el agente a su propia instancia de SearXNG mantiene las consultas fuera de terceros y deja claro que cada página que el agente lee después es una entrada no confiable que llega dentro del bucle.
Entorno de ejecución de agentes frente a framework de agentes
Esta pregunta surge cada vez que aparece un entorno de ejecución nuevo, y las respuestas no coinciden, en parte porque los proveedores tampoco coinciden. Esta es la versión que se sostiene.
Un framework es una biblioteca que se importa. El agente se ensambla en código mediante el bucle del framework o mediante uno propio. LangChain es el ejemplo conocido: proporciona bloques de construcción y el agente se ensambla en código.
Un entorno de ejecución es un programa que se ejecuta. El bucle ya está escrito, las herramientas ya existen y el modelo de permisos ya tiene una configuración predeterminada. Se obtiene un agente funcional con el primer comando y, a partir de ahí, se configura.
La prueba de instalación suele resolver la cuestión. Si se instala y después se escribe código, es un framework. Si se instala y después se interactúa con él, es un entorno de ejecución.
La frontera es objeto de un debate real, y las pruebas más claras están en la propia documentación de LangChain. A fecha de octubre de 2026, denomina a Deep Agents «un entorno de ejecución de agentes» y también «una biblioteca independiente construida sobre los bloques de construcción principales de LangChain para agentes», mientras que el repositorio langchain-ai/deepagents se denomina «el entorno de ejecución de agentes con todo incluido». Ambas descripciones son válidas. Deep Agents es un SDK de Python (kit de desarrollo de software) que se importa, por lo que la prueba de instalación lo clasifica como una biblioteca, y ofrece suficiente comportamiento predeterminado para que se utilice como un entorno de ejecución. Microsoft anunció la disponibilidad general de Hosted Agents en Foundry Agent Service el 9 July 2026, y su publicación del 22 July 2026 anuncia el lanzamiento de Microsoft Agent Framework Harness, lo que demuestra que la expresión ya es una categoría de producto y no sólo jerga.
Por tanto, haga la pregunta que permite prever mejor la carga de trabajo. Si escribe el bucle, el bucle queda bajo su responsabilidad: los reintentos, el recorte del contexto, las solicitudes de permisos y el registro de lo ocurrido. Si el bucle ya viene incluido, se adopta la solución de otra persona para todos esos aspectos. Es mucho más rápido para empezar y más difícil de cambiar después.
Diferencias entre un harness y una ventana de chat
Una ventana de chat y un harness muestran la salida del modelo. La diferencia es en qué equipo se realiza el trabajo. En una ventana de chat, cualquier código que ejecuta el modelo se ejecuta dentro del sandbox del proveedor y sobre los archivos que usted ha cargado. Un harness ejecuta herramientas en el equipo donde lo inició, con la cuenta del usuario que lo inició, sobre sus archivos reales y con sus credenciales reales disponibles en el entorno.
Ese es todo el beneficio y todo el riesgo, resumidos en dos frases. El agente por fin puede realizar el trabajo. El agente también puede eliminarlo.
Los harnesses que realmente se están ejecutando
Esta lista está fechada el 19 de agosto de 2026 a propósito. La categoría cambia cada semana y cualquier recopilación queda desactualizada rápidamente.
- Claude Code y Codex son harnesses de proveedores. Terminal primero, vinculados de forma predeterminada a los modelos propios de sus proveedores y con la gestión de permisos más pulida. Comparativa de Claude Code, Cursor, Codex y Copilot los analiza en detalle.
- DeepSeek Harness (
dsh) tiene licencia MIT y se basa en una idea: todo es un plugin, por lo que los modelos, las herramientas, las sesiones, los sandboxes y la interfaz de usuario son piezas intercambiables. Cada plugin que se instala se ejecuta con los permisos propios del agente, así que comprobar a qué puede acceder un plugin de dsh antes de añadirlo importa más aquí que en un harness con un conjunto de herramientas fijo. - Hermes, de Nous Research, es un agente autónomo general y no una herramienta de programación. Se publicó con licencia MIT en febrero de 2026 y su almacenamiento integrado es local: sus memorias y habilidades se guardan como archivos bajo
~/.hermes, y el historial de sesiones se almacena en una base de datos SQLite local. Esto deja de ser todo el panorama cuando se activa uno de sus proveedores externos opcionales de memoria, como Mem0 o Hindsight. A fecha de octubre de 2026, la documentación de Hermes indica que un proveedor activo recibe cada turno de la conversación después de cada respuesta y una copia de cada escritura de memoria integrada, por lo que los datos también pasan a residir con ese proveedor. Comparativa de Hindsight y Mem0 merece una lectura antes de activar uno, y Alojamiento propio de Hermes en un VPS explica el resto. - Omnigent es un meta-harness: controla otros harnesses, incluidos Claude Code y Codex, mediante una única API con sesiones compartidas, límites de gasto y un sandbox a nivel del sistema operativo. Omnigent como harness multiagente explica qué aporta esto.
- OneCLI es un harness aislado en un sandbox y orientado a equipos. Se basa en una pasarela que inyecta credenciales en las solicitudes salientes del agente, de modo que el propio agente nunca ve las claves reales.
Tres de ellos aparecen con tanta frecuencia en la misma lista corta que merece la pena leer DeepSeek Harness, Claude Code y Omnigent, comparados directamente sobre el acoplamiento al modelo, la licencia, la madurez y lo que necesita cada uno para ejecutarse en un servidor.
El inicio rápido de dsh es un único comando, y ejecutarlo una vez es la forma más rápida de ver qué es un harness. Necesita Node.js en la máquina.
npx @deepseek-ai/dsh webEsto inicia la interfaz web en http://127.0.0.1:3080. Lea el README antes de confiar en él, porque dsh se describe como una versión preliminar para desarrolladores y afirma claramente que habrá cambios que romperán la compatibilidad. Si ese primer comando falla por completo o descarga una compilación que no esperaba, fijar una versión exacta de dsh y vaciar la caché de npx suele permitir continuar. Ejecución de DeepSeek Harness en un VPS explica la instalación en el servidor, y por qué esa dirección empieza por 127.0.0.1 explica el valor predeterminado de loopback.
Los routers se sitúan por encima del harness
Un router de modelos es un proxy local entre el harness y la API del proveedor. Claude Code Router es el ejemplo habitual: se enlaza a 127.0.0.1:3456 de forma predeterminada, acepta las solicitudes que Claude Code habría enviado a su propio proveedor y las reenvía al proveedor que haya configurado. El harness no sabe que se ha producido ningún cambio.
Los routers existen porque el modelo se puede sustituir, por lo que demuestran bien el punto principal de este artículo. También concentran el riesgo, porque el proxy ve todos los prompts y almacena todas las claves de los proveedores. Trátelo como infraestructura, no como una comodidad. Dónde guarda un harness sus claves de API y la configuración de modelos es el mismo problema, pero en la capa inferior.
Qué cambia cuando el entorno se ejecuta en un VPS
Cambian cuatro cosas cuando el entorno pasa de tu portátil a un servidor que alquilas.
Sigue ejecutándose cuando cierras la tapa. Una tarea larga sobrevive al trayecto y a la batería. Iníciala dentro de tmux y sepárate de ella:
tmux new -s agent
# start the harness, then press Ctrl-b and then d to detach
tmux attach -t agentPara cualquier tarea que deba volver a ejecutarse después de un reinicio, un servicio de usuario es mejor que una sesión de terminal:
loginctl enable-linger $USER
systemctl --user status my-agent.serviceloginctl enable-linger es la parte que suele pasarse por alto. Sin ella, el comportamiento predeterminado de systemd es detener el gestor de servicios de tu usuario 10 segundos después de que se cierre tu última sesión, por lo que un servicio de usuario no mantiene el agente en ejecución después del cierre de sesión. Ejecutar dsh sin interfaz bajo systemd contiene el archivo de unidad. Cuando una sesión ya está activa en ese servidor, puedes iniciar una segunda y dos sesiones de Claude Code en el mismo equipo pueden enviarse mensajes, de modo que la que iniciaste esta mañana puede asignar una tarea a la otra sin que tengas que transmitirla manualmente.
Almacena tus claves. La clave del proveedor ahora reside en un archivo de configuración de ese servidor. Comprueba quién puede leerlo:
ls -l ~/.configCualquier proceso que se ejecute con tu usuario puede leer ese archivo. Esto incluye al agente y a todo lo que el agente decida ejecutar.
Puede llegar a tus otras máquinas. Un VPS en la misma red privada que tus otros equipos proporciona al agente una ruta hacia ellos. Ese es precisamente el objetivo, y también el alcance de un posible incidente.
Es accesible desde cualquier lugar. La mayoría de los entornos exponen una interfaz web y la mayoría la enlazan a loopback por una razón. Comprueba la tuya:
ss -tlnp | grep 3080127.0.0.1:3080 significa que sólo el propio servidor puede conectarse. 0.0.0.0:3080 significa que la interfaz escucha en todas las interfaces, por lo que cualquiera que pueda llegar a la dirección pública del servidor puede conectarse, salvo que un firewall situado delante bloquee el puerto. En octubre de 2026, dsh rechaza al iniciar una dirección comodín como esa, pero muchas otras interfaces web aceptan una. Accede a una interfaz enlazada a loopback mediante un túnel SSH en lugar de cambiar la dirección de enlace:
ssh -N -L 3080:127.0.0.1:3080 you@your-serverDespués, abre http://127.0.0.1:3080 en el navegador de tu portátil. El tráfico viaja dentro de la sesión SSH, por lo que no se expone nada nuevo a Internet.
Todas esas propiedades también constituyen el argumento de seguridad
Vuelva a leer las cuatro propiedades desde la perspectiva de un atacante.
Se ejecuta sin supervisión, por lo que nadie observa el momento en que el modelo interpreta mal una ruta. Contiene sus claves, por lo que un solo archivo de configuración legible equivale a tener acceso a toda su cuenta del proveedor. Puede acceder a sus otras máquinas, por lo que una inyección de instrucciones, es decir, instrucciones ocultas en una página web o en un archivo que el agente lee, ahora tiene una ruta hasta el host de su base de datos. Es accesible desde cualquier lugar, por lo que una interfaz web que escucha en una dirección pública, sin un firewall delante y sin autenticación propia, es un shell para cualquiera que la encuentre. dsh incluye un token de proceso en la URL que muestra al arrancar, lo que ayuda, pero esa URL ahora es una credencial, así que compártala con el mismo cuidado que una contraseña.
La solución en todos los casos es poco llamativa y siempre es la misma. Asigne al agente su propia cuenta de usuario sin privilegios en lugar de utilizar la suya:
sudo adduser --disabled-password --gecos "" agentMantenga la interfaz web en loopback y acceda a ella mediante SSH. Asigne al agente las credenciales más restringidas que aún le permitan completar el trabajo; mantener los secretos fuera de los agentes de IA explica este punto correctamente. Para cualquier proceso que se ejecute mientras usted no lo supervisa, una máquina desechable es mejor que una configurada con cuidado: ejecutar agentes de programación en una VM desechable y ejecutar Claude Code de forma segura en un VPS siguen ese enfoque.
¿Necesita un arnés para agentes?
Si su trabajo consiste en una pregunta cada vez, una ventana de chat es suficiente y un arnés sólo añade un bucle que debe supervisar. Un arnés empieza a compensar cuando una tarea requiere muchos pasos sobre archivos reales o cuando debe seguir funcionando mientras usted duerme.
La mayor parte de esta categoría es reciente. dsh indica «developer preview» en su propio README a fecha de octubre de 2026, y el resto avanza con suficiente rapidez como para que un archivo de configuración que escriba hoy necesite cambios el mes que viene. Esto es un motivo para mantener una configuración pequeña y reproducible, y para documentar los cambios realizados. La misma prudencia resulta útil dentro del bucle: una habilidad que dirija al agente hacia el cambio mínimo que funcione le deja un diff que realmente puede leer al final de una ejecución sin supervisión. Empiece con un arnés en un servidor, asígnele un trabajo y una clave con permisos limitados, y amplíe su acceso sólo después de que ese primer trabajo haya sido rutinario durante una semana. Los agentes autoalojados que merece la pena ejecutar hoy son un punto de partida razonable para elegir el primero.
FAQ
¿Qué es un agent harness en términos sencillos?
Es el programa que rodea al modelo. El modelo genera texto y solicita usar herramientas. El harness ejecuta el bucle que sigue preguntando, ejecuta las herramientas que solicita el modelo, aplica las reglas sobre qué herramientas pueden ejecutarse sin permiso y conserva el estado de la sesión y los archivos entre turnos. Si cambia el modelo, el harness sigue funcionando. Esa es la señal más clara de que son componentes separados.
¿Claude Code es un modelo o un harness?
Claude Code es un harness. Es un programa de terminal con un bucle, un sistema de permisos y herramientas integradas para archivos y shell. Claude es la familia de modelos que utiliza de forma predeterminada. La misma separación se aplica a DeepSeek Harness (dsh), que es un programa Node que se instala, y a los modelos DeepSeek, que se sirven mediante una API. Se instala un harness en una máquina. Se llama a un modelo a través de la red.
¿Cuál es la diferencia entre un agent harness y un agent framework?
Un framework es una biblioteca que se importa y contra la que se escribe código, usando su bucle o escribiendo uno propio. Un harness es un programa que se ejecuta. Por eso, el bucle, los reintentos y la gestión del contexto vienen con valores predeterminados que se configuran en lugar de escribirlos. En la práctica, la diferencia no siempre está clara: LangChain's Deep Agents es un SDK que se puede importar y cuyo propio repositorio denomina agent harness con todas las funciones integradas, a fecha de octubre de 2026. Pregúntese si tendrá que escribir el bucle. Esa respuesta determina qué término encaja en su situación.
¿Necesito un VPS para ejecutar un agent harness?
No. Todos los harness mencionados aquí se ejecutan en un portátil. Un servidor cambia cuatro aspectos: el agente sigue ejecutándose cuando cierra la tapa, conserva sus claves en una máquina que siempre está encendida, puede acceder a sus otros servidores y puede volver a la misma sesión desde cualquier dispositivo. Cada uno de esos aspectos también implica una consideración de seguridad. Por tanto, asigne al agente su propia cuenta de usuario y mantenga cualquier interfaz web vinculada a 127.0.0.1.
¿Puedo usar un modelo diferente dentro del mismo harness?
Normalmente sí. Esa es la propiedad que define a un harness. La mayoría acepta un nombre de modelo y una URL base en su configuración. Apuntarlo a otro proveedor requiere editar la configuración, no reescribirla. Cuando un harness no lo permite, un router local como Claude Code Router se sitúa entre el harness y el proveedor y traduce las solicitudes. De forma predeterminada, se vincula a 127.0.0.1:3456. Tenga cuidado con ese proxy, porque ve cada solicitud y conserva cada clave.