Cómo ejecutar un agente de código en un VPS

Por qué ejecutar un agente de programación en un VPS

Un agente de programación es una herramienta que lee tu base de código, escribe cambios y ejecuta comandos para probarlos, todo desde el terminal. Ejecutarlo en un VPS ofrece tres ventajas frente a tu portátil: sigue trabajando después de que te desconectes, está junto a tu código y tus herramientas de compilación, y puede comunicarse con un modelo que alojes tú mismo. Inícialo dentro de una sesión de tmux para poder cerrar el portátil y retomar el trabajo más tarde, siguiendo el mismo patrón que ejecutar Claude Code en un VPS con tmux.

Conviene conocer dos agentes basados en el terminal. Aider es la opción nativa del terminal y centrada en git: confirma automáticamente cada cambio con un mensaje descriptivo, de modo que el historial se mantiene limpio y cada edición se puede revertir. Es uno de los agentes de programación para terminal con más trayectoria, aunque su ritmo de publicación se ha ralentizado. Goose, de Block, tiene un alcance más amplio: es un agente con licencia Apache-2.0, un ecosistema extenso de extensiones y compatibilidad con muchos proveedores, incluidos los modelos locales de Ollama. Actualmente se desarrolla bajo la Agentic AI Foundation (AAIF) de la Linux Foundation. Aider encaja con un flujo de trabajo disciplinado y centrado en git; Goose encaja mejor como asistente general con un conjunto amplio de plugins.

Qué necesita

Necesita un VPS con git, tmux y una versión reciente de Python para Aider, o el instalador de Goose para Goose. También necesita un modelo: una clave de API de un proveedor como Anthropic u OpenAI, o un modelo local servido mediante Ollama en el mismo VPS. La opción autoalojada mantiene el código en su propio servidor y no tiene coste por token, pero requiere suficiente memoria para ejecutar un modelo con capacidad adecuada.

Instalar y ejecutar Aider

Instale Aider en un entorno aislado con pipx, que se instala mediante apt porque Ubuntu 24.04 bloquea pip install fuera de un entorno virtual (PEP 668). Después, ejecute Aider dentro de su proyecto, en una sesión de tmux para que siga funcionando aunque se interrumpa la conexión:

sudo apt install pipx
pipx ensurepath
pipx install aider-chat
tmux new -s aider
cd ~/my-project
aider

Una nota sobre las versiones: esta instalación funciona como se muestra en Ubuntu 24.04. En Ubuntu 26.04 falla actualmente porque las dependencias fijadas de Aider incluyen una versión antigua de numpy que no se puede compilar con Python 3.14 de 26.04. La solución consiste en asignar a Aider su propio Python 3.12:

pipx install --python 3.12 --fetch-missing-python aider-chat

pipx descarga un intérprete independiente sólo para Aider y la instalación finaliza correctamente. Esto refleja el ritmo de publicación más lento de Aider. Si supone un problema, Goose es la opción con un mantenimiento más activo.

Cuando se esté ejecutando, desconéctese de la sesión con Ctrl-b y después d. El agente seguirá trabajando aunque cierre el portátil. Vuelva a conectarse más tarde con tmux attach -t aider para revisar los cambios. También puede mantener una segunda ventana de tmux abierta para otro agente. Si ambos son Claude Code, las dos sesiones pueden pasarse trabajo entre sí en lugar de que usted lo haga manualmente. Aider lee el repositorio, propone cambios, los aplica y confirma cada uno. También puede incorporar archivos adicionales como contexto cuando un cambio afecta a varios archivos. Como cada cambio es un commit, deshacer el trabajo del agente sólo requiere git revert. Esta es la red de seguridad que permite usarlo con confianza. Goose se instala con su script de una línea documentado y se ejecuta de forma similar desde la terminal, gestionando las tareas mediante sus extensiones:

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

Modelo alojado o modelo autoalojado

Un modelo alojado ofrece la mejor calidad y no requiere hardware local, pero cobra por token y el código se envía al proveedor. Los costes por token se acumulan más rápido de lo que suele esperarse, porque el agente vuelve a enviar toda la conversación en cada turno. El desglose de Claude Code sobre lo que realmente consume en tokens una sesión larga del agente también se aplica aquí, ya que Aider y Goose facturan de la misma forma. Un modelo autoalojado mediante Ollama mantiene todo en el servidor y su ejecución no tiene coste una vez pagado el hardware, pero un modelo de programación suficientemente bueno para resultar útil necesita una cantidad considerable de memoria. Ese es el equilibrio que debe valorar: calidad y comodidad frente a privacidad y coste.

Si opta por el autoalojamiento, la cuestión práctica es qué modelo se adapta al servidor. Revise también la ventana de contexto, porque Ollama usa una ventana pequeña de forma predeterminada y trunca silenciosamente todo lo que la supera. En un agente de programación, esto significa que los archivos que acaba de leer desaparecen del prompt: aumentar num_ctx lo corrige, y la caché KV más grande que necesita forma parte de la memoria que debe presupuestar. Calcule los recursos antes de descargar un modelo de ocho gigabytes en un equipo que no puede alojarlo:

Seguridad: edita archivos y ejecuta comandos

Un agente de programación no es pasivo. Reescribe archivos y puede ejecutar comandos de compilación y pruebas, por lo que debe tratarlo con el mismo cuidado que cualquier proceso capaz de modificar el sistema. Tres hábitos cubren la mayor parte del riesgo. Trabaje dentro de un repositorio git para que cada cambio quede registrado y pueda revertirse; Aider lo hace automáticamente. Ejecute el agente como su usuario normal sin privilegios, nunca como root, siguiendo el principio de mínimo privilegio, para que un comando incorrecto no pueda afectar a todo el sistema. Mantenga también el propio servidor protegido, porque un VPS para programación sigue siendo un servidor público: SSH sólo con claves, un firewall con denegación predeterminada y el resto de medidas habituales. La guía de protección de OpenClaw adopta el mismo enfoque para un agente más autónomo, y estos principios también se aplican en otros casos.

Para integrar un agente de programación en su propio flujo de trabajo, crear un agente de IA con Claude muestra cómo un modelo controla sus herramientas; ejecutar la CLI de Gemini de Google en un VPS es otra opción para el terminal, y alojar OpenHands por cuenta propia es la alternativa autónoma más completa. El proyecto de código abierto con más estrellas de este ámbito ya tiene su propia guía: ejecutar OpenCode en un VPS lo configura con el mismo patrón de tmux y un usuario sin privilegios.

FAQ

¿Puedo ejecutar un agente de programación con un modelo local en lugar de una API de pago?

Sí. Tanto Aider como Goose funcionan con modelos locales servidos por Ollama, por lo que puede ejecutar un agente de programación completamente autohospedado, sin coste por token y sin que el código salga de su servidor. La limitación es la memoria: un modelo suficientemente capaz para escribir código útil necesita bastante RAM o VRAM. Dimensione la máquina según el modelo antes de tomar una decisión.

¿Qué debería usar, Aider o Goose?

Elija Aider si su flujo de trabajo se centra en la terminal y git, y quiere la opción más madura y con menor sobrecarga. Aider crea un commit automáticamente con cada cambio, de modo que el historial se puede revertir. Elija Goose si quiere un asistente más amplio, con un ecosistema extenso de extensiones y compatibilidad con muchos proveedores. Ambos se ejecutan desde la terminal y funcionan con Ollama, por lo que cualquiera de los dos es adecuado para un VPS.

¿Cuánta memoria necesito para un modelo de programación autohospedado?

Depende del tamaño del modelo y del nivel de cuantización. Un modelo cuantizado pequeño puede ejecutarse con unos pocos gigabytes, mientras que un modelo más potente necesita mucha más memoria. Las ventanas de contexto largas también aumentan el consumo. Use la herramienta de dimensionamiento anterior para estimar la memoria que necesitan un modelo y una longitud de contexto determinados antes de descargarlos.

¿Es seguro permitir que un agente de IA edite mi código y ejecute comandos?

Es una práctica controlable si sigue las medidas adecuadas. Mantenga el trabajo en un repositorio de git para que cada edición quede registrada en un commit reversible. Ejecute el agente como un usuario sin privilegios en lugar de root y refuerce la seguridad del VPS como lo haría con cualquier servidor público. Revise los cambios que confirme el agente en lugar de aceptarlos a ciegas, especialmente cualquier comando que quiera ejecutar en el sistema.