OpenHands frente a Claude Code: flujo de trabajo, sandbox y coste total

Elige Claude Code cuando quieras un agente de programación de terminal compatible que se instale con un comando y facture a una cuenta; elige OpenHands cuando administrar el entorno de ejecución sea en sí mismo el requisito. Ese marco resulta especialmente importante en septiembre de 2026, porque los dos productos ya no tienen la misma forma. Claude Code es un agente de terminal propietario. OpenHands, desde que su monorepo incorporó Agent Canvas, es principalmente un centro de control de navegador autoalojado; y su propia CLI de terminal, la única superficie directamente comparable, está declarada en mantenimiento.

Los dos también se encuentran a medio camino, por lo que plantearlo como una elección estricta entre uno y otro sería engañoso. Agent Canvas puede ejecutar Claude Code como un subproceso mediante el Agent Client Protocol, así que «ambos» es una configuración real, con una consecuencia de facturación que conviene entender antes de comprometerse con uno.

Qué estás comparando realmente

Ambos proyectos se han movido recientemente, hasta el punto de que una revisión de 2025 te dirigirá al repositorio equivocado. El repositorio que antes estaba en All-Hands-AI/OpenHands ahora es OpenHands/OpenHands y la ruta antigua redirige allí; docs.all-hands.dev redirige a docs.openhands.dev, y el repositorio independiente OpenHands/agent-canvas está archivado porque Canvas se incorporó al monorepo. La documentación de Claude Code también cambió: docs.claude.com/en/docs/claude-code/… ahora redirige mediante 301 a code.claude.com/docs/en/….

Fuentes, todas comprobadas de nuevo el 21 de septiembre de 2026: la API del repositorio de OpenHands, su README, el mapa de componentes (que incluye tanto la línea de estado de la CLI como la nota sobre la GUI local que aparece más abajo), la página de la CLI que publica el comando uv tool install, la entrada del registro npm de Claude Code, su LICENSE.md y la documentación de configuración.

Un número resuelve por sí solo la cuestión de la CLI. El propio comando de instalación de la documentación de OpenHands obtiene el paquete PyPI openhands, que está en 1.16.0, subido el 8 de mayo de 2026: 34 versiones y ninguna desde la primavera. Durante el mismo periodo, la biblioteca subyacente se publicó constantemente: openhands-sdk 1.49.2 se subió el 17 de septiembre de 2026. Si llegaste aquí esperando comparar dos agentes de terminal, esa diferencia es la respuesta: la superficie de terminal de OpenHands no es donde se concentra su desarrollo.

Quién debería elegir cuál

Elige Claude Code si tu flujo de trabajo consiste en que un desarrollador dirija cambios en un repositorio que ya tiene clonado y prefieres comprar el agente en lugar de operarlo. La ejecución es local en tu estación de trabajo bajo tu propio usuario; los permisos se gestionan mediante las propias indicaciones de Claude Code, y la configuración consiste en un único comando de instalación más un inicio de sesión. El coste corresponde a un plan de Anthropic, una cuenta de API o un gateway al que lo apuntes. No es necesario eliminar nada para probar otra opción junto a ella: su documentación sobre memoria coloca las instrucciones del proyecto en un archivo CLAUDE.md (o AGENTS.md) dentro del propio repositorio.

Elige OpenHands si lo que realmente necesitas es un plano de control: varias conversaciones y automatizaciones programadas ejecutándose contra los backends que elijas, con el límite del sandbox como una decisión explícita y no como una suposición. La documentación del sandbox ofrece un sandbox Docker (recomendado), un sandbox de procesos descrito como «inseguro, pero rápido» y con «Sin aislamiento de contenedor», y un sandbox remoto seleccionado mediante una variable de entorno RUNTIME. Es una diferencia real de forma, no una carencia de capacidades: Claude Code documenta su propia herramienta Bash en sandbox, integrada y aplicada por el sistema operativo en macOS, Linux y WSL2, pero pone en sandbox los comandos de la máquina en la que ya estás trabajando, mientras que OpenHands te permite elegir el backend sobre el que se ejecuta todo el servidor del agente. La elección es auténtica, y también es trabajo que pasa a ser responsabilidad tuya.

Conoce el límite antes de elegir OpenHands para un equipo. Sus propias preguntas frecuentes dicen: «OpenHands está pensado para que lo ejecute un solo usuario en su estación de trabajo local. No es adecuado para implementaciones multiinquilino en las que varios usuarios comparten la misma instancia. No incluye autenticación, aislamiento ni escalabilidad». La opción multiusuario es el plan Enterprise, cuyo precio no se publica. Además, Canvas no proporciona aislamiento por sí mismo: la página de instalación indica que los agentes y procesos ACP deben tratarse como no confiables, que «Agent Canvas es el cliente y no proporciona aislamiento» y que un backend que se ejecute directamente en tu máquina permite al agente actuar con los permisos de tu cuenta de usuario.

Elige ambos si quieres la superficie operativa de Canvas, pero el comportamiento de agente de Claude Code. Es una configuración documentada y se explica dos secciones más abajo.

Planes y límites de cada uno

Consultado en openhands.dev/pricing y anthropic.com/pricing el 21 de septiembre de 2026. Una nota sobre una cifra que verás en otros lugares: Max 20x suele citarse ampliamente a 200 $ al mes, pero la página de Anthropic solo muestra «Desde 100 $», y los únicos 200 $ de su marcado corresponden al cargo anual de Pro cobrado por adelantado. Confirma el precio de 20x en la pantalla de actualización en lugar de confiar en una tabla de terceros, incluida esta.

Dos fuentes del proveedor discrepan sobre la interfaz de navegador local de OpenHands, y conviene saber cuál estás instalando. La tabla de funcionalidades de la página de precios incluye «GUI basada en la web» en el plan Local gratuito, mientras que el mapa de componentes de la documentación llama a la GUI local «la aplicación de navegador basada en Docker obsoleta del antiguo monorepo de OpenHands» y dice «Usa Agent Canvas para el desarrollo activo del cliente de navegador». Sigue el mapa de componentes.

En cuanto a los modelos, el nivel Individual de OpenHands Cloud ofrece su propio proveedor enrutado «al coste, sin margen». Su tarjeta de tarifas publicada indica que «Los precios indicados reflejan las tarifas del proveedor sin margen», pero no debe leerse como un catálogo actual de Claude: el Sonnet más reciente que incluye es Sonnet 4.5 a 3/15 $ por millón, mientras que la propia página de precios de Anthropic sitúa Sonnet 5 en 2/10 $. El mecanismo —al coste, sin margen— es la afirmación que debe extraerse. Esta página no ha iniciado sesión en OpenHands Cloud, por lo que no puede afirmar qué modelos ofrece realmente esa cuenta hoy.

Canvas puede ejecutar Claude Code, y el inicio de sesión tiene prioridad sobre tu clave

El README del monorepo indica que Agent Canvas puede «Ejecutar OpenHands, Claude Code, Codex, Gemini o cualquier agente compatible con ACP en backends locales, remotos y en la nube». La página de agentes ACP proporciona el comando predeterminado de Claude Code como npx -y @agentclientprotocol/claude-agent-acp, y describe claramente el mecanismo: la CLI propia del proveedor se ejecuta como subproceso, y Agent Server «es el propietario del subproceso y las credenciales; Agent Canvas solo registra qué agente ejecutar y muestra un formulario para los secretos que necesita».

El detalle de facturación aparece en la sección de autenticación y sorprende a muchas personas. El inicio de sesión de una suscripción se detecta automáticamente desde el almacén de credenciales propio de Claude Code — el Llavero de macOS o ~/.claude/.credentials.json en Linux — y la documentación indica que «El inicio de sesión tiene prioridad sobre una clave de API: mientras hayas iniciado sesión, no se utiliza una clave establecida en el entorno». Por tanto, en una máquina en la que alguna vez hayas ejecutado claude y hayas iniciado sesión con Pro o Max, el trabajo que creías que se facturaba contra una clave se está cargando a la suscripción. La misma página señala lo contrario: «En un sandbox de nube limpio no hay ningún inicio de sesión almacenado, por lo que se necesita una clave de API»; esto significa que la misma configuración de Canvas puede facturar de dos maneras distintas según el backend en el que se ejecute. La página de configuración del modelo completa el cuadro: «Los agentes ACP, como Claude Code, Codex y Gemini CLI, gestionan su propio acceso al modelo», por lo que un perfil LLM de OpenHands no redirigirá ese subproceso.

El mismo gateway, dos cadenas de URL diferentes

Si enrutas cualquiera de los dos clientes mediante una única clave de API propia, el fallo más habitual es la forma de la URL, porque las dos convenciones son opuestas. Claude Code utiliza el formato Anthropic Messages y quiere un origen; OpenHands enruta mediante LiteLLM y quiere una URL base que incluya /v1 además de un id de modelo con prefijo de proveedor.

# ANTHROPIC_BASE_URL takes the ORIGIN. Claude Code appends /v1/messages
# itself, so a trailing /v1 produces /v1/v1/messages, which your gateway
# will not be serving.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-your-kunavo-key

# Pin models Kunavo serves. Claude Code's default and its opus alias are the
# newest Opus — pinned here to Opus 5.5, which needs Claude Code v2.1.280 or
# later (run `claude update`). The sonnet alias asks for Sonnet 5.5, which
# Kunavo does not serve: unpinned, /model sonnet, opusplan's execution phase
# and sonnet subagents 404.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5

# On this path background tasks run on the main model unless this variable
# pins one, so it is worth setting.
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

# OpenHands routes through LiteLLM, so the id carries a provider prefix
# and the base URL INCLUDES /v1 — the opposite convention to the one above.
LLM_MODEL=openai/claude-sonnet-5
LLM_API_KEY=sk-your-kunavo-key
LLM_BASE_URL=https://api.kunavo.com/v1

# In Agent Canvas the same three values are Settings > LLM > Advanced:
#   Custom Model / Base URL / API Key

Las variables de Claude Code están documentadas en su página de variables de entorno: ANTHROPIC_BASE_URL «Anula el endpoint de API para enrutar las solicitudes a través de un proxy o gateway», y ANTHROPIC_AUTH_TOKEN es un «Valor personalizado para el encabezado Authorization (el valor que establezcas aquí tendrá el prefijo Bearer)». La página del protocolo del gateway enumera los endpoints como /v1/messages y un /v1/messages/count_tokens opcional, por lo que la variable solo utiliza el origen. Los campos de OpenHands proceden de su página de configuración de LLM: Custom Model, «Establece tu modelo personalizado con el proveedor como prefijo»; Base URL; API Key; y la página de configuración del modelo prescribe openai/<served-model-id>, tomando el id exacto «normalmente de su endpoint GET /v1/models».

Cuatro problemas prácticos, cada uno extraído de las propias páginas de los proveedores y no de pruebas:

• Aumento silencioso del coste en Claude Code. Si el gateway no reenvía cache_control sin cambios, la página del gateway indica: «No hay ningún error: la conversación se factura como entrada no almacenada en caché en cada turno». Es una diferencia de precio sin ningún mensaje de error asociado.
• Funciones que se desactivan detrás de un host personalizado. Establecer ANTHROPIC_BASE_URL en un host que no sea de primera parte desactiva de forma predeterminada la búsqueda de herramientas MCP (vuelve a activarla con ENABLE_TOOL_SEARCH=true si el proxy reenvía bloques tool_reference), y a partir de v2.1.196 Remote Control está desactivado. El descubrimiento de modelos del gateway también está desactivado de forma predeterminada.
• Los streams no deben almacenarse en búfer. Claude Code cuenta los bytes retransmitidos, incluidos los pings SSE, y «cancela un stream que permanece en silencio durante 300 segundos de forma predeterminada».
• OpenHands valida al guardar, y la accesibilidad depende del backend. Al guardar un perfil local, primero se valida contra el backend y el guardado se bloquea si falla; además, la URL base debe ser accesible desde el backend: si Canvas se ejecuta en Docker y tu endpoint está en el host, 127.0.0.1 corresponde al contenedor. Puedes conservar hasta 10 perfiles LLM por cuenta.

Kunavo publica referencias de configuración para la ruta con formato Anthropic — ANTHROPIC_BASE_URL y la integración de Claude Code — y para la ruta con formato OpenAI en quickstart. Son referencias de configuración publicadas, no pruebas de compatibilidad: ninguno de los dos clientes se instaló ni se ejecutó contra el endpoint para esta página. Aquí no hay una página de configuración específica de OpenHands y la ruta documentada con prefijo Anthropic para OpenHands tampoco está verificada, así que trata el formulario openai/ anterior como la ruta documentada y confírmala en tu propio entorno.

Cuánto cuesta una sesión con una clave con facturación por uso

Estas son operaciones aritméticas ilustrativas de tokens, no costes medidos de tareas ni un límite superior de facturación. Supón una tarea pequeña de 150k tokens de entrada no almacenados en caché y 8k tokens de salida, y una ejecución larga del agente de 800k tokens de entrada no almacenados en caché y 40k tokens de salida; las sesiones de agentes consumen mucha entrada porque los archivos y los resultados de las herramientas se reenvían. Las tarifas son precios actuales del catálogo de Kunavo por millón de tokens, y se aplican las mismas tarifas independientemente del cliente que envíe la solicitud.

Para tener una referencia de escala frente a una cifra del proveedor: la propia documentación de costes de Anthropic informa que «En implementaciones empresariales, el coste medio es de unos 13 $ por desarrollador y día activo y de 150-250 $ por desarrollador al mes, y los costes se mantienen por debajo de 30 $ por día activo para el 90 % de los usuarios». Según las suposiciones anteriores, 13 $ equivalen aproximadamente a 9 ejecuciones largas o 49 tareas pequeñas en Claude Sonnet 5 a $1.400 y $0.266, respectivamente. La cifra de Anthropic se limita a sus propias implementaciones empresariales y no es un presupuesto para un gateway; las operaciones aritméticas son una comprobación del orden de magnitud, no una previsión. El almacenamiento en caché cambia materialmente el resultado en ambas direcciones; consulta el almacenamiento en caché de prompts.

El importe del catálogo de Kunavo es un mínimo de facturación, no un límite máximo: cuando el proveedor ascendente comunica su cargo, la factura es el mayor valor entre el coste del catálogo y el coste ascendente multiplicado por el margen aplicable. Los cargos de caché y las herramientas externas quedan fuera de este ejemplo. La recarga mínima es de $10 en crédito prepago, un mínimo de financiación y no una tarifa por tarea ni una suscripción; consulta los detalles de facturación.

Tres líneas de coste, no una

La comparación que suele hacerse mal es «cliente gratuito frente a cliente de pago». Divide el presupuesto en cambio:

1. Tokens del modelo. La misma pregunta para ambos, y la tabla anterior la responde. Esta es la única línea que aparentemente factura el plan Individual de OpenHands, aunque su página de precios tampoco dice explícitamente nada sobre la facturación de la computación o del sandbox.
2. La máquina que ejecuta el sandbox. No se necesita una máquina adicional para Claude Code en su ruta predeterminada documentada, porque el agente y su sandbox Bash integrado se ejecutan en la estación de trabajo que ya tienes. El coste es distinto de cero y no está publicado para OpenHands autoalojado: la documentación describe backends Docker, de VM y remotos, pero no publica ningún modelo de costes; por tanto, calcula las horas de VM, el almacenamiento y el tiempo del contenedor del sandbox según las tarifas de tu propio proveedor. Esta página no inventará una cifra.
3. La cuenta que recibe el cargo. Un plan de Claude, un saldo de API o — en la ruta en la que Canvas ejecuta Claude Code — cualquiera de los dos para los que la máquina tenga un inicio de sesión.

La migración entre ambos es barata en la dirección habitual. Claude Code conserva sus instrucciones de proyecto en archivos del repositorio, por lo que probar OpenHands no exige borrar nada; y como Canvas puede controlar Claude Code mediante ACP, una evaluación ni siquiera tiene que ser un cambio completo. La dirección costosa es estandarizar un equipo en OpenHands autoalojado, porque ahí aparecen los límites de usuario único y la línea de infraestructura que ahora debes administrar.

Empieza con una tarea acotada

Elijas el que elijas, ejecuta el mismo cambio pequeño y verificable en ambos — un error con una prueba que falle — desde el mismo commit, en espacios de trabajo separados, y registra el diff, el esfuerzo de revisión y el cargo que tu cuenta haya registrado realmente. Esa es la única comparación de esta página que te pertenece a ti y no a un proveedor.

Si quieres la ruta con facturación por uso, la guía de integración de Claude Code contiene la configuración con formato Anthropic y crear una cuenta de Kunavo financia la clave; el valor con formato OpenAI de quickstart es el que necesita la pestaña Advanced de OpenHands. ¿Sigues decidiendo entre clientes y no entre proveedores? OpenHands frente a OpenCode compara las dos superficies de código abierto, precios de Claude Code cubre por completo la parte de los planes y Claude Code sin suscripción cubre por sí sola la ruta del gateway.

Preguntas frecuentes

Repositorio, registro de paquetes, precios y fuentes de documentación comprobados de nuevo el 21 de septiembre de 2026; la investigación subyacente se recopiló el 18 de septiembre de 2026. Ninguno de los dos clientes se instaló, configuró ni ejecutó contra el endpoint de Kunavo para esta página: todas las afirmaciones de configuración proceden de la documentación y no se realizó ninguna prueba de compatibilidad ni de rendimiento. No se ofrece ninguna comparación de éxito o velocidad de tareas porque no se encontró una referencia neutral de los dos agentes. Las tarifas de tokens de Kunavo proceden del catálogo actual y todos los ejemplos en dólares son operaciones aritméticas ilustrativas de tokens.