Documentación

Agentes de programación en tu propia máquina

Ejecuta los roles de tu perfil de AI en un agente de programación en la máquina de quien inicie la tarea, con las herramientas de CoRoid y sin nada más de la máquina.

Un rol de tu perfil de AI puede ejecutarse en un agente de codificación en tu propia máquina en lugar de un modelo al que llama CoRoid. El agente realiza el razonamiento del rol allí, signado como tú lo configuraste, en tu propia cuenta con su proveedor. CoRoid le proporciona las herramientas del rol y se encarga de todo lo demás del flujo de trabajo: la tarea, las comprobaciones y controles, y el registro de lo ocurrido.

Qué cubre

  • Todos los roles de un perfil excepto el motor de decisiones: el Arquitecto y el coordinador, el Desarrollador, Control de calidad, el Revisor, el probador web, el traductor y los otros. El motor de decisiones no es un agente en ejecución: solicita a un modelo de decisiones la probabilidad de cada respuesta permitida, algo que un agente de codificación no proporciona.
  • Cuatro agentes: Codex y OpenCode, y para algunas organizaciones solo, por ahora, Claude Code y Cursor. Cada uno se ejecuta bajo tu propio plan con su proveedor (ver El plan de tu agente).
  • Todas las maneras en que se ejecuta una tarea. En modo coordinador, el coordinador y los elementos a los que delega trabajo se ejecutan en el agente como cualquier otro rol.

El plan de tu agente

El agente trabaja bajo tu propio inicio de sesión y en tu propio plan con su proveedor: Anthropic para Claude Code, OpenAI para Codex, Cursor para Cursor y los proveedores que configures en OpenCode. CoRoid nunca ve ese inicio de sesión, ni revende ni comparte el plan de nadie: cada persona conecta su propia máquina y el agente realiza el trabajo que ellos iniciaron.

Si los términos de un plan permiten usarlo a través de otro producto y para qué tipo de trabajo, eso depende de ti y del proveedor. Varía entre proveedores y entre sus planes personales y empresariales, puede depender de la cantidad de trabajo que se realice y puede cambiar. Lee los términos de tu plan y consulta al proveedor cuando no estén claros.

Una organización que asigne roles a los agentes debe verificar lo mismo respecto a los planes de sus empleados. Su política puede permitir solo los agentes cuyos términos haya revisado (ver Qué permite tu organización).

Cómo se conecta

Tu máquina

Conector CoRoid

De código abierto. Inicia el agente para una ronda en un directorio nuevo y vacío, y lo detiene después.

Su agente de programación

El agente que utilizas, con tu sesión iniciada, y con sus propias herramientas desactivadas.

  1. 1Solicita trabajo. Cada solicitud se mantiene hasta 25 segundos; el conector informa lo que dice el agente cada 3 segundos.
  2. 2Utiliza las herramientas del rol. Con un token válido solo para esta ronda, que deja de funcionar cuando termina la ronda.
  3. 3Consulta a su modelo. Tal como ocurriría sin CoRoid. CoRoid nunca ve esa sesión.

CoRoid

Orquestador

Asigna el trabajo del rol a la máquina de la persona que inició la tarea (1).

Las herramientas del rol

Se ejecutan en el entorno aislado de la tarea, donde permanece tu código (2).

El proveedor del agente

Responde a las solicitudes del modelo del agente bajo tu propia sesión, en tu plan (3).

Nada accede a la máquina: el conector no abre puertos, no envía ningún archivo ni ejecuta comandos propios.

En la máquina permanecen tu sesión en el agente y todo lo que el agente guarda de una ronda.

Toda conexión comienza en la máquina y sale mediante HTTPS. El repositorio permanece en el entorno aislado de la tarea en CoRoid; el agente solo trabaja en él a través de las herramientas del rol asignado.

La máquina trabaja para CoRoid a través del conector de CoRoid, un pequeño programa de código abierto que instalas y ejecutas. Cada conexión comienza en la máquina: el conector solicita trabajo a CoRoid, el agente utiliza las herramientas del rol en el entorno aislado de la tarea y el agente pide a su propio proveedor las respuestas del modelo, bajo tu inicio de sesión. El conector no abre puertos ni envía ningún archivo de la máquina. La seguridad del conector explica qué hace y qué no hace, y cómo verificar una versión.

Conectar una máquina

  1. Instala el agente en la máquina e inicia sesión en él, como lo harías para usarlo tú mismo.

  2. Instala el conector, con Homebrew en macOS o Linux:

    brew install coroid-ai/tap/coroid-connector

    o con npm, en cualquier lugar con Node.js 20 o superior:

    npm install --global @coroid/connector
  3. Para Codex o Claude Code, agrega el agente: coroid-connector add codex (o add claude). Esto instala el adaptador ACP del agente, que incorpora su propia copia del agente (aproximadamente 350 MB), en ~/.coroid/connector, desde los paquetes que el conector publica con hashes bloqueados. OpenCode y Cursor no necesitan ser agregados: CoRoid usa tu propia instalación.

  4. Abre Configuración → Conexiones → Sus máquinas y ejecuta el comando que se muestra allí (coroid-connector --api …). Tu navegador se abrirá: aprueba la máquina para tu organización. Aprueba solo un conector que hayas iniciado hace un momento.

El conector seguirá ejecutándose hasta que lo detengas, solicitando trabajo a CoRoid. Sus máquinas muestra la máquina como conectada, con los agentes que el conector encontró en ella y la versión de cada uno. Un agente solo aparece como listo en una versión que CoRoid haya probado; en otra versión se muestra pero no se utiliza.

coroid-connector status muestra lo mismo desde la máquina, con el modelo que tiene asignado cada agente.

Solo tú ves tus máquinas. Desconectar finaliza el inicio de sesión de la máquina y su conector se detiene en menos de un minuto.

Asignar un rol a un agente

Un propietario de organización hace esto en un perfil personalizado, en Configuración → Perfil de AI (ver Perfiles de AI).

  1. Abre los detalles del perfil. En el primer campo de un rol, la lista comienza con En tu propia máquina: los agentes que se ofrecen a tu organización, y junto a cada uno si una máquina tuya lo tiene listo.
  2. Elige el agente. Aparecen dos campos más:
    • Modelo en : el modelo que el agente debe usar para este rol, de los modelos que tus máquinas conectadas informan para él. Según lo configurado en la máquina deja al agente en el modelo que su propietario haya configurado en él.
    • Sin una máquina conectada: el modelo que ejecuta la función cuando ninguna máquina asume el trabajo. Es el modelo que tenía la función.
  3. Guardar.

Al seleccionar de nuevo un modelo en el primer campo, se aleja al agente y el modelo asociado con él también.

¿Qué ocurre cuando se ejecuta una tarea?

La asignación corresponde a la organización; la máquina pertenece a la persona. Cuando una función comienza, CoRoid busca una máquina de la persona que inició la tarea:

  • conectada a esta organización en el último minuto,
  • con el agente asignado listo en una versión que CoRoid ya ha probado,
  • y ofreciendo el modelo denominado, si la asignación lo especifica.

Si existe una, el trabajo de la función se envía a esa máquina. Si no, la función se ejecuta en el modelo bajo Sin una máquina conectada, exactamente como habría ocurrido. Nada espera a que una máquina esté disponible. El trabajo que nadie inició (una automatización basada en un evento o un programa) no tiene dicha máquina y se ejecuta en su modelo.

En la máquina, el conector inicia el agente en un directorio nuevo y vacío y le proporciona un conjunto de herramientas para la sesión: las herramientas de CoRoid para esta función, accesibles únicamente para este trabajo. El desarrollador modifica el código a través de ellas, en el espacio de trabajo de la tarea en CoRoid, tal como lo haría un modelo; el equipo de control de calidad y el revisor evalúan esos cambios mediante ellas. Un mensaje agregado a la tarea mientras el agente trabaja le llegará con el siguiente resultado de la herramienta.

Una función en espera vuelve al agente. El coordinador entrega el trabajo al desarrollador, al equipo de control de calidad y al revisor y espera la respuesta de cada uno; un elemento secundario puede esperar la respuesta del coordinador. Cuando la espera termina, la función vuelve al agente, al que se le transmite toda la conversación hasta ese momento. Una máquina puede ejecutar hasta cuatro funciones simultáneamente (conector 0.4.0), por lo que los exploradores que inicia el desarrollador funcionan junto a ella.

Si la máquina deja de responder durante el desarrollo de una función, esta continúa en la misma conversación en su modelo en la nube, al que se le informa lo ocurrido. Una tarea interrumpida también detiene al agente. Cuando una función finaliza, su agente se detiene y el directorio se elimina.

Qué permanece en su máquina

El conector elimina el directorio en el que se ejecutó la función. Lo que el agente conserva del trabajo en su propio almacenamiento depende del agente:

AgenteQué conserva
Claude CodeSin transcripción: el conector lo inicia con la persistencia de sesión desactivada
CodexUna transcripción de cada sesión en ~/.codex/sessions, incluidos los archivos que leyó
OpenCodeSus sesiones en su propia base de datos bajo ~/.local/share/opencode
CursorCada sesión en su propia base de datos bajo ~/.cursor/acp-sessions

Codex, OpenCode y Cursor no ofrecen todavía una opción para esto. Si su organización debe mantener el código fuera de los portátiles, permita únicamente Claude Code según su política (ver más abajo).

Qué permite su organización

Un propietario o administrador decide en Configuración → Identidad y acceso → Política de la organización, bajo Agentes de programación en las máquinas de las personas, en todos los planes:

  • Permitir agentes de programación en las máquinas de las personas. Cuando está desactivado, todas las funciones se ejecutan en su modelo, incluida una función que un perfil ya haya asignado a un agente.
  • Un interruptor por agente su organización dispone de esta opción, además de lo que ese agente conserve en la máquina. Con todos los agentes activados, un agente que CoRoid ofrezca posteriormente también estará activado.

El formulario de perfil de AI solo muestra los agentes permitidos por la política, y una función no puede asignarse a otro nuevo. Una función asignada antes de que cambiara la política mantiene su asignación, y el formulario indicará que se ejecuta en su modelo. La política de un proyecto puede restringir la de la organización, pero nunca ampliarla.

Qué puede y qué no puede hacer el agente

  • Solo las herramientas de CoRoid. Las herramientas propias de cada agente (su shell, edición de archivos, búsqueda web, sus propios servidores MCP y conectores) se desactivan para la sesión, según lo establecido por el agente. Cualquier solicitud para usar algo distinto se rechazará.
  • Nada de la máquina. El agente no trabaja en su área de trabajo y no accede a los archivos de la máquina. CoRoid tampoco tiene acceso a la máquina: el conector solo solicita trabajo a CoRoid e informa lo que dice el agente.
  • Las mismas comprobaciones. Los cambios realizados por el agente pasan por las mismas pruebas de control de calidad, revisiones, controles y límites de pasos que el trabajo de un modelo.
  • Qué se envía. Lo que necesita la función (el código que lee, los requisitos, los resultados de sus herramientas, las imágenes de un archivo adjunto) se envía a la máquina y, desde allí, al proveedor del agente mediante el inicio de sesión que este tenga allí. Si su organización debe mantener el código con proveedores específicos, tenga eso en cuenta antes de asignar una función a un agente.

Costos y registros

El razonamiento del agente se atribuye a la persona cuya máquina realizó el trabajo, no al gasto en modelos de CoRoid. La actividad de una tarea muestra dicha ejecución, por ejemplo: Codex (gpt-6-luna) en el portátil de Ada · sin medición de uso, nunca como cero tokens. Si un rol utiliza su modelo en la nube, esa parte se mide como de costumbre.

CoRoid registra cada tarea que asigna a una máquina: qué máquina y agente, el nombre del modelo, cómo finalizó y cuántas llamadas a herramientas realizó.

Exportar e importar

El agente y el modelo de una asignación se incluyen en la exportación de configuraciones junto con el perfil, y la elección de agentes según la política se incluye en la política organizativa. Una organización que no cuente con agentes locales, a los que no se les ofrezca ese agente o cuya política lo prohíba, importará la asignación solo con su modelo en la nube, y la importación lo indicará. Ver Exportar e importar configuraciones.