Toda conversación sobre agentes de programación con IA acaba topándose con la misma pregunta práctica, normalmente más tarde de lo que debería: ¿dónde se ejecuta realmente el código? No qué modelo, sino qué máquina aloja tu repositorio, tus credenciales, tus cachés y la shell en la que el agente escribe.
Sharkly convierte esa respuesta en un concepto de primer nivel llamado Computer. Un Computer proporciona el host de ejecución para el trabajo de los Agentes. Puede ser un ordenador local, un servidor remoto, un contenedor o un host en la nube compatible. Tu portátil sirve. Y el equipo Linux de tu rack, también. Tú eliges el host, tú lo controlas, y Sharkly coordina el trabajo hacia él en lugar de ejecutar tu código en algún lugar que no puedes ver.
Sharkly no sustituye a Claude Code, Codex ni a otras herramientas de ejecución. Añade la capa compartida de tareas, Computers, contexto, control y revisión alrededor de las herramientas que tu equipo ya utiliza. Esas herramientas siguen instaladas en tus máquinas, y el uso de modelos continúa a través de las suscripciones o claves de API configuradas en ellas.
TL;DR
Un Computer es el host de ejecución del trabajo de los Agentes en Sharkly: un ordenador local, un servidor remoto, un contenedor o un host en la nube compatible que tú controlas. Un pequeño servicio local conecta el Computer con Sharkly, detecta los Runtimes disponibles (las herramientas de agente concretas instaladas allí, como Claude Code o Codex), recibe las ejecuciones en cola, prepara el directorio de la tarea, inicia el Runtime seleccionado y transmite el progreso de vuelta a la Tarea. Conecta una máquina personal con Sharkly Desktop, o un host remoto con el CLI de Sharkly y un token de instalación de un solo uso. El uso de modelos fluye por las suscripciones y claves de API ya configuradas en tus herramientas; los límites de concurrencia determinan cuánto trabajo en paralelo soporta un host.
Qué es un Computer y qué no es
Sharkly divide la ejecución en cuatro roles, y cada uno tiene exactamente una función:
- El Agente define cómo debe gestionarse el trabajo: instrucciones, Skills, repositorios, ajustes de ejecución.
- El Computer aporta el host y los recursos locales: sistema operativo, archivos, credenciales, red, herramientas.
- El Runtime realiza la sesión del agente propiamente dicha: la herramienta de programación detectada en ese Computer.
- La Tarea sigue siendo el registro compartido: objetivo, conversación, estado de ejecución, traza, resultado.
Esa separación explica buena parte de lo que viene a continuación. Un Agente no es el host de ejecución; la misma configuración de Agente puede apuntar a distintos Computers con el tiempo. Un Computer no es un agente; aloja uno o varios Runtimes y no hace nada hasta que se le envía trabajo. Y un único Computer puede dar servicio a varios Agentes a la vez, siempre dentro de su límite de concurrencia.
También explica la propuesta. Las plataformas alojadas empaquetan el modelo, el runner y la infraestructura en un solo producto, lo que significa que tu código se ejecuta en una infraestructura que no operas tú. Sharkly adopta la postura contraria: el host de ejecución es tuyo, y lo que añade por encima es asignación, colas y revisión. Si eres nuevo en este modelo, qué es Sharkly cubre el panorama completo.
El servicio local: la pieza que hace el trabajo real
Un pequeño servicio local conecta cada Computer con Sharkly. Registra el Computer, detecta los Runtimes instalados, envía heartbeats, recibe las ejecuciones en cola, prepara los directorios de tarea, inicia la herramienta de agente seleccionada y reporta el progreso y los resultados de vuelta.
Hay un detalle de diseño con mucho peso operativo: el servicio local es quien inicia la conexión con el servidor, así que una configuración típica no necesita ningún puerto de entrada. Eso es lo que hace que un portátil detrás del router de casa, una estación de trabajo detrás del cortafuegos corporativo y un servidor en una subred privada sean Computers igual de viables.
Los heartbeats son la forma en que Sharkly sabe que un Computer está vivo: Online cuando el servidor los recibe, Offline cuando dejan de llegar. La distinción que te ahorra tiempo de diagnóstico: online solo significa que los heartbeats están llegando. No significa que el Runtime seleccionado pueda ejecutar una Tarea.
Runtimes: qué puede ejecutar realmente tu Computer
Un Runtime es una capacidad de ejecución de agentes compatible detectada en un Computer. El servicio local escanea en busca de herramientas de agente compatibles y reporta cada una que sea utilizable, de modo que un Computer con Claude Code y Codex instalados expone ambos como Runtimes que un Agente puede seleccionar.
La página de detalle del Computer muestra un estado de capacidad para cada Runtime:
- Available: el Runtime está conectado y puede ejecutar trabajo de Agentes.
- Needs configuration: la herramienta se ha detectado, pero falta configuración obligatoria.
- Not installed: la herramienta no está disponible para el servicio local; instálala o elige otro Runtime.
- Unsupported: el Runtime o el entorno queda fuera del conjunto de capacidades compatibles.
La instalación sigue siendo responsabilidad tuya, y así está pensado. Instalas y autenticas cada herramienta igual que lo harías para usarla directamente; la página de detalle del Computer enlaza a la guía de instalación oficial, y un nuevo escaneo confirma que el servicio local puede verla. Si no se detecta una capacidad de la que dependes, puedes añadir un Runtime ACP personalizado con un nombre y un comando de inicio, y después probar la conexión.
De ahí se derivan dos consecuencias. El enfoque de «trae tu propia suscripción» es literal: la cuota de modelo depende de las herramientas de programación con IA, los planes y las cuentas de API que conecte tu equipo, así que un error de cuota apunta a la cuenta configurada en la herramienta, no a un ajuste de Sharkly. Y la selección de modelo vive en la herramienta: un Agente sigue el modelo predeterminado de su Runtime. La configuración de los Agentes se trata en Agentes en Sharkly.
Cómo conectar tu primer Computer
El primer Computer suele ser la máquina en la que estás sentado. Abre Ajustes, ve a Computers, elige Conectar Computer y selecciona la ruta de configuración para tu sistema operativo. Para un ordenador personal compatible, la ruta recomendada es instalar Sharkly Desktop, que incluye el servicio local y te guía paso a paso por el registro. La guía de primeros pasos lo recorre de principio a fin en unos diez minutos.
Una vez conectado, confirma que al menos un Runtime aparece como Available. Este es el paso que la gente se salta: un Computer conectado sin un Runtime utilizable no puede ejecutar trabajo de Agentes.
Hay dos ajustes exclusivos de la versión de escritorio que importan en portátiles. Evitar la suspensión mantiene la máquina despierta para que una ejecución larga no se interrumpa, y Seguir ejecutando con la tapa cerrada es una opción aparte de macOS. Ambos aparecen solo en la máquina local, nunca en un Computer remoto.
Cómo añadir un servidor remoto
Un portátil es un buen primer Computer y un mal Computer permanente. Se suspende, viaja y compite con tu IDE por la memoria. El segundo paso natural es un host remoto que permanezca encendido. Instala en él el CLI de Sharkly y el servicio local directamente:
curl -fsSL https://file-assets.sharkly.ai/download/install.sh | bash
sharkly version
Después, desde la página Computers, genera un token de instalación de un solo uso y ejecuta en el host de destino el comando de registro que te proporcione:
sharkly computer register --install-token sit_...
El registro da de alta el Computer en tu organización, inicia el servicio local y lanza la detección de Runtimes. El token de instalación caduca a los 30 minutos y es de un solo uso, lo que lleva a una norma de higiene que la documentación indica sin rodeos: no lo incluyas en una imagen reutilizable, un script, una Tarea o un comentario.
Las credenciales están separadas aquí a propósito. Un token de acceso personal no registra un ordenador, y un token de instalación no crea un inicio de sesión humano en el CLI. El token de acceso personal shk_ te autentica para comandos de recursos como sharkly task list; el token de instalación sit_ crea la sesión que utiliza el servicio local. La superficie de comandos más amplia es el tema de la guía del CLI y la API de Sharkly.
Tras el registro, ese mismo CLI sirve además como tu kit de diagnóstico: sharkly computer status y sharkly computer logs leen el estado local en el host, mientras que sharkly computer list, show, usage y ping inspeccionan los Computers registrados desde cualquier lugar. El host remoto necesita lo mismo que tenía tu portátil: herramientas de agente instaladas y autenticadas, y acceso a Git para repositorios privados.
Local, remoto o contenedor: una comparación honesta
No existe un único host correcto. La documentación los trata a todos como Computers, y las contrapartidas son las habituales de cualquier infraestructura.
| Host | Ideal para | Ventajas | A tener en cuenta |
|---|---|---|---|
| Ordenador local (Sharkly Desktop) | Primera configuración, trabajo en solitario, ejecuciones en directorio especificado que reutilizan tu checkout y tus cachés existentes | Cero infraestructura adicional; tu entorno y tus credenciales exactos; los directorios de trabajo especificados solo están disponibles en Computers locales | La suspensión y el apagado interrumpen la disponibilidad; las ejecuciones compiten con tu propio trabajo por CPU y memoria |
| Servidor remoto (CLI + servicio local) | Cargas de trabajo en equipo, capacidad siempre activa, mayor concurrencia | Permanece en línea; aísla la carga de los agentes del portátil de cualquiera; un host puede dar servicio a varios Agentes | Los Runtimes y el acceso a Git los instalas y autenticas tú; la planificación de capacidad corre de tu cuenta |
| Contenedor o host en la nube compatible | Entornos de ejecución reproducibles y desechables | Entorno limpio y reconstruible; el mismo flujo de registro mediante token de instalación | El token de un solo uso debe generarse en cada registro, nunca incluirse en una imagen reutilizable |
La decisión que más importa es esta: usa tu Computer local cuando quieras que los Agentes trabajen en el entorno en el que ya confías; usa uno remoto cuando las Tareas deban seguir avanzando con el portátil cerrado. Muchos equipos acaban teniendo ambos, porque redirigir el trabajo a otro host es un cambio de configuración, no un cambio de flujo de trabajo.
Qué ocurre durante una ejecución
Cuando una Tarea asignada a un Agente está lista, Sharkly pone una ejecución en cola y la envía al Computer seleccionado. Antes de que arranque el Runtime, el servicio local puede esperar a tener capacidad de concurrencia, preparar un directorio, obtener los repositorios y proyectar las variables de entorno permitidas.
La preparación del directorio sigue uno de dos modos. En el modo Temporal, cada Tarea recibe un directorio aislado, y las ejecuciones respaldadas por repositorio pueden preparar un worktree de Git nuevo a partir de los datos de repositorio en caché; úsalo para la mayor parte del trabajo con repositorios y siempre que varias Tareas puedan modificar el mismo código en paralelo, como se explora en cómo Sharkly ejecuta Agentes en paralelo sin conflictos de merge. En el modo Especificado, la ejecución reutiliza un directorio absoluto configurado en un Computer local, junto con las dependencias y cachés que ya contiene, y un directorio especificado atiende una ejecución a la vez.
Mientras el Runtime trabaja, el progreso se transmite en tiempo real. El estado de la ejecución pasa por Queued, Dispatched, Waiting for local directory, Running y, después, Completed, Failed o Canceled. Los eventos de traza, las llamadas a herramientas y la respuesta final vuelven todos a la Tarea. El Computer es donde ocurre físicamente la ejecución; la Tarea es donde se acepta el resultado.
Concurrencia: ¿cuánta carga debería soportar un Computer?
Cada Computer tiene un límite de concurrencia de tareas, y cada Agente tiene su propio máximo de Tareas en ejecución simultánea. Los valores predeterminados son conservadores a propósito: un Agente que usa directorios temporales parte del 50 % del límite del Computer, y uno que usa directorios especificados parte de su número de directorios configurado. Si fuerzas un valor manual por encima de ese número, el producto avisa de que las escrituras pueden chocar. Hazle caso al aviso.
La recomendación de la documentación es la que hay que seguir: una mayor concurrencia consume más CPU, memoria, disco, capacidad del proveedor y ancho de banda de repositorio, así que auméntala solo cuando la configuración actual gestione la carga existente de forma fiable. La capacidad del proveedor es el techo que todo el mundo olvida: diez ejecuciones en paralelo con una misma cuenta de modelo alcanzan sus límites de peticiones diez veces más rápido. Para ver patrones de escalado, consulta ejecutar varios agentes de Claude Code en paralelo.
Un Agente en línea puede seguir teniendo trabajo en cola simplemente porque la concurrencia o la capacidad de directorios está al máximo. En cola es un estado saludable, no un estado atascado.
Compartir, propiedad y mantener limpio el host
Cuando un Computer pasa a prestar servicio al equipo, hay tres controles que importan. La visibilidad decide quién puede verlo y usarlo: Personal, Organization o Space. La propiedad es algo aparte: el propietario puede transferir el Computer y es la única persona que puede eliminarlo. Y en un Computer personal local, el propietario controla qué Organizaciones pueden usarlo, de modo que unirte a una nueva organización nunca pone tu portátil a disposición de forma silenciosa.
Las ejecuciones de los Agentes dejan atrás directorios de trabajo, cachés y artefactos, así que la limpieza viene integrada. De forma predeterminada, marca las ejecuciones completadas o canceladas como elegibles pasados unos 7 días, puede exigir un umbral mínimo de espacio libre y nunca toca el trabajo en ejecución o en cola, las ejecuciones fijadas ni las ejecuciones fallidas que aún se están investigando. Para una comprobación inmediata, sharkly daemon disk-usage informa del uso y sharkly daemon cleanup muestra una vista previa de lo que se recuperaría.
Empieza con la máquina que ya tienes
El concepto de Computer responde a una pregunta que las plataformas alojadas prefieren que no hagas: ¿en la infraestructura de quién está el agente? Aquí la respuesta es tuya, desde un solo portátil hasta una flota de servidores compartida. No necesitas la flota el primer día. Conecta un Computer, confirma que un Runtime aparece como Available, crea un Agente y asígnale algo aburrido. Cuando aparezcan los límites del portátil, registra un servidor junto a él. La documentación de Sharkly trata con más profundidad cada uno de estos ajustes.
Preguntas frecuentes
¿Qué es un Computer en Sharkly?
Un Computer es el host de ejecución del trabajo de los Agentes: un dispositivo, servidor o contenedor conectado que aporta el sistema operativo, los archivos, las credenciales, el acceso a la red y las herramientas que necesita un Agente. Un pequeño servicio local lo conecta con Sharkly, detecta los Runtimes, recibe las ejecuciones y transmite el progreso de vuelta a la Tarea.
¿Sharkly ejecuta mi código en su propia nube?
No. El trabajo de los Agentes se ejecuta en los Computers que tú conectas, que son máquinas que tú controlas. Sharkly coordina la asignación, las colas, el progreso y la revisión alrededor de esos hosts. El uso de modelos también es tuyo: fluye por las suscripciones o claves de API configuradas en las herramientas de programación instaladas en cada Computer.
¿Cómo conecto un servidor remoto como Computer?
Instala el CLI de Sharkly en el host, genera un token de instalación de un solo uso desde la página Computers y ejecuta sharkly computer register --install-token sit_... en esa máquina. El token caduca en 30 minutos y funciona una sola vez, así que no lo incluyas nunca en una imagen ni en un script. Después instala y autentica las herramientas de agente que quieras, y confirma que cada Runtime aparece como Available.
¿Por qué mi Computer aparece como Online pero la ejecución no arranca?
Online solo significa que el servicio local está enviando heartbeats; no significa que el Runtime seleccionado pueda ejecutar trabajo. Abre el detalle del Computer y comprueba el estado de capacidad del Runtime: tanto Needs configuration como Not installed bloquean las ejecuciones. sharkly computer ping confirma si un Runtime concreto completa un ciclo de ida y vuelta.
