Crear un agente con Claude en un VPS

Qué implica crear un agente con Claude

Crear un agente con Claude significa usar Claude como núcleo de razonamiento mientras el bucle, las herramientas y los datos residen en tu propio servidor. Claude decide qué hacer; tu VPS lo ejecuta. Envías a Claude la tarea y el estado actual, Claude responde con una respuesta o solicita usar una de tus herramientas, tu código ejecuta la herramienta y envía el resultado de vuelta, y el bucle continúa hasta completar el trabajo. La inteligencia es un servicio al que accedes a través de Internet. Todo lo que lo rodea es tuyo.

Esta separación es la principal ventaja. Obtienes un razonamiento de nivel avanzado sin operar un modelo y mantienes el control total sobre aquello a lo que puede acceder el agente, porque las herramientas se ejecutan en hardware de tu propiedad. Si ya has creado un primer programa con Claude, la guía para crear la primera aplicación de Claude en un VPS cubre los fundamentos sobre los que se basa esta guía.

Claude es el cerebro: la Messages API

Todas las llamadas a Claude pasan por un único endpoint: la Messages API. Envíe la conversación hasta ese momento y la lista de herramientas que el agente puede usar; Claude devuelve su siguiente mensaje. Ese mensaje es una respuesta final o una solicitud para llamar a una herramienta. En la opción de crear el agente manualmente no existe una «agent API» independiente: el uso de herramientas es una función de este único endpoint y el bucle que lo rodea debe ejecutarlo su código.

Claude no conserva estado entre llamadas, por lo que no recuerda nada por sí mismo. Cada solicitud incluye la conversación completa. Su código conserva el historial y lo envía en cada turno, lo que explica que cada turno de una sesión larga consuma más tokens que el anterior. No se trata tanto de una limitación como de una decisión de diseño: como el estado reside en su servidor, usted decide exactamente qué ve Claude y nada relacionado con la tarea se almacena fuera de los sistemas que controla. Esto hace que el prompt siga creciendo. Aunque la ventana de contexto de Claude lo admite sin problemas, un modelo local en el mismo bucle no lo hará. Por eso es necesario aumentar num_ctx en Ollama antes de que deje de truncar los prompts largos.

El uso de herramientas es el bucle del agente

El bucle del agente con Claude es sencillo de describir. Envía una solicitud que incluye sus herramientas. Claude lee la tarea y, si necesita actuar, responde con una solicitud de uso de herramientas que indica una herramienta y completa sus entradas. El código ejecuta esa herramienta y después envía el resultado a Claude en la siguiente solicitud. Claude lee el resultado y solicita otra herramienta o escribe su respuesta final. Cuando deja de solicitar herramientas, la tarea ha terminado.

Puede escribir ese bucle manualmente en unas pocas líneas, y muchas personas lo hacen porque es fácil de ver y controlar. Los SDK oficiales también proporcionan un ejecutor de herramientas que gestiona el bucle por usted: usted proporciona las funciones de las herramientas y el SDK se encarga del intercambio de llamadas a Claude, la ejecución de las herramientas y el envío de los resultados hasta que Claude termina. En ambos casos, la estructura es la misma. El ejecutor sólo evita que tenga que escribir el bucle. Si el bucle todavía parece abstracto, la solución es escribir uno mínimo antes de usar un ejecutor; ese es el paso del que depende todo lo demás en esta ruta gradual para aprender a crear agentes de IA desde cero.

Tres formas de crear un agente y cuáles encajan en un VPS

Hay tres formas de crear un agente de Claude. Se diferencian en la cantidad de componentes que debe ejecutar.

La primera consiste en usar código propio que llame a la API de Claude con sus propias herramientas. Puede escribir el bucle o usar el ejecutor de herramientas del SDK, y alojar todo el sistema en su VPS. Es la opción habitual porque ofrece control completo sobre las herramientas, los datos y la seguridad, y se ejecuta como un programa normal en el servidor. La mayor parte de esta guía presupone este enfoque.

La segunda opción es Claude Agent SDK. Es Claude Code, el agente de programación, empaquetado como una biblioteca sobre la que puede construir. Incluye un bucle de agente completo y herramientas integradas para leer y escribir archivos, ejecutar comandos de shell y realizar búsquedas. Por tanto, no tiene que ensamblar esos componentes desde cero. También se ejecuta en su propio servidor, por lo que encaja bien en un VPS cuando necesita un agente capaz de trabajar con archivos y shell sin crear el arnés por su cuenta. Un agente que lee archivos y ejecuta comandos de shell necesita aislamiento antes de funcionar sin supervisión. Ejecutar Claude Code de forma segura en un servidor explica el sistema de permisos, el sandbox y las opciones de aislamiento.

La tercera opción es Managed Agents, donde Anthropic ejecuta el bucle. De forma predeterminada, las herramientas del agente se ejecutan en un sandbox alojado por Anthropic. Por tanto, el espacio de trabajo del agente reside en la infraestructura de Anthropic y no en su VPS. A fecha de October 11, 2026, una opción de sandbox autohospedado, todavía en beta, permite que un proceso worker en su propio servidor ejecute las llamadas a las herramientas mientras Anthropic mantiene el bucle. Use Managed Agents cuando quiera reducir al mínimo el trabajo operativo y no necesite que el propio bucle se ejecute en su máquina. En las otras dos opciones, su servidor aloja el agente completo. Ese es el enfoque del resto de esta guía.

Conectar herramientas con MCP

Independientemente de la opción que elija, querrá conectar el agente con sistemas reales. Model Context Protocol es una forma ordenada de hacerlo. MCP es un estándar abierto para exponer herramientas y datos a un agente. En lugar de programar manualmente una integración para cada servicio, configura Claude para usar un servidor MCP que ya presenta esas capacidades como herramientas. Puede ejecutar los servidores MCP como servicios pequeños en el mismo VPS, cada uno con sólo los permisos que necesita. Este tema se trata en ejecutar servidores MCP en un VPS.

Elegir un modelo

Claude está disponible en varios modelos, y elegir uno implica encontrar un equilibrio entre capacidad, velocidad y coste. A fecha del 11 de octubre de 2026, la oferta actual incluye Claude Opus 5.5 (claude-opus-5-5), que Anthropic recomienda como punto de partida para la mayoría de las cargas de trabajo y está diseñado para tareas de programación agéntica y trabajo con conocimiento de larga duración; Claude Sonnet 5.5 (claude-sonnet-5-5), una opción equilibrada, más barata y rápida; y Claude Haiku 5.5 (claude-haiku-5-5), el modelo más rápido y barato para pasos sencillos y de gran volumen. Por encima de ellos está Claude Fable 5.1 (claude-fable-5-1), el modelo más capaz disponible para todos los clientes, destinado a razonamientos exigentes y trabajo agéntico de largo horizonte. Los modelos anteriores, como Claude Opus 4.8 y Claude Fable 5, siguen disponibles, pero ahora figuran como heredados. Use el identificador exacto del modelo en el código, sin añadirle la fecha.

Un patrón práctico consiste en combinarlos. Deje que un modelo más barato gestione las llamadas rutinarias a herramientas y que otro más potente tome las decisiones difíciles. Como el modelo es sólo una cadena de texto en la petición, cambiarlo requiere modificar una sola línea. Empiece con un valor predeterminado capaz y reduzca el modelo cuando la velocidad o el coste sean más importantes que el último incremento de calidad.

Ejecútelo como un servicio reforzado en su VPS

Un agente sólo resulta útil si permanece en ejecución, y sólo es seguro si está contenido. En un VPS, ambas condiciones se consiguen ejecutando el agente como un servicio del sistema reforzado, en lugar de iniciarlo manualmente desde una terminal. Como servicio, se inicia durante el arranque, se reinicia si se bloquea y registra los mensajes en el journal. Al estar reforzado, se ejecuta con un usuario sin privilegios y sólo con el acceso que necesita, de modo que un error o una instrucción incorrecta tienen un alcance limitado. Una unidad de servicio puede limitar los recursos que el proceso puede tocar y la cantidad de memoria, CPU y tareas que puede utilizar, pero no puede evaluar qué decide hacer el agente con ese acceso. Esa parte debe gestionarse dentro del propio harness del agente. Es la función que cumplen los plugins de DeepSeek Harness que conviene instalar en otra pila: límites de gasto, reglas de permisos por herramienta y análisis de prompt injection.

La regla más importante es mantener la clave de API de Claude en el servidor. La clave paga y autoriza cada llamada. Por eso debe estar en un archivo que sólo pueda leer el usuario del agente, cargarse en el servicio como una variable de entorno y no incluirse nunca en el código, en un repositorio ni en ningún lugar al que pueda acceder un navegador. Genere aquí una unidad de servicio completa y reforzada para su agente:

A continuación, termine de configurar el propio servidor. Configure SSH para aceptar únicamente claves y restrinja la cuenta desde la que administra el sistema, como se explica en Reforzar SSH en un VPS. Si prefiere controlar el agente desde una sesión interactiva mientras lo configura, ejecutar Claude Code en un VPS con tmux es un buen complemento. Cuando tenga una segunda sesión abierta en el mismo equipo, ambas pueden intercambiar trabajo en lugar de obligarlo a trasladar cada instrucción de un panel al otro. Si quiere conocer los conceptos en los que se basa todo esto sin vincularlos a un modelo concreto, la guía relacionada sobre crear su propio agente de IA en un VPS explica los fundamentos.

Si busca un asistente de programación en la terminal, ejecutar un agente de IA para programación en un VPS cubre Aider y Goose.

FAQ

¿Qué modelo de Claude debería usar para crear un agente?

Empiece con Claude Opus 5.5 (claude-opus-5-5), que Anthropic recomienda para la mayoría de las cargas de trabajo, y ajústelo según sea necesario. Claude Sonnet 5.5 (claude-sonnet-5-5) es más barato y rápido para la mayoría de las tareas, Claude Haiku 5.5 (claude-haiku-5-5) es la mejor opción para pasos sencillos de gran volumen y Claude Fable 5.1 (claude-fable-5-1) ofrece la mayor capacidad para las tareas más difíciles. Un patrón habitual consiste en usar un modelo más barato para los pasos rutinarios y otro más potente para las decisiones complejas, ya que cambiar de modelo requiere modificar una sola línea.

¿Ejecuto todo el agente en mi VPS o lo hace Anthropic?

Depende del enfoque. Si escribe su propio bucle contra la Claude API o usa el Claude Agent SDK, el agente se ejecuta completamente en su VPS y sólo las llamadas al modelo se envían a Anthropic. Si usa Managed Agents, Anthropic ejecuta el bucle y, de forma predeterminada, aloja el sandbox donde se ejecutan las herramientas, por lo que una parte menor del agente reside en su servidor; una opción de sandbox autohospedado, en beta a fecha de October 11, 2026, traslada la ejecución de las herramientas a su propia máquina mientras el bucle permanece en Anthropic. Para un agente que se ejecute completamente en su propia máquina, use una de las dos primeras opciones.

¿Cuál es la diferencia entre la Claude API y el Claude Agent SDK?

La Claude API es el endpoint de Messages sin abstracciones: envía una conversación y las herramientas, y escribe el bucle del agente alrededor de ella, o usa el ejecutor de herramientas del SDK para controlarlo. El Claude Agent SDK es una biblioteca de nivel superior, Claude Code empaquetado para crear aplicaciones, que incluye un bucle completo y herramientas integradas para archivos, shell y búsqueda. Use la API si quiere definirlo todo por su cuenta y el Agent SDK si quiere un agente capaz sin montar usted mismo toda la infraestructura de ejecución.

¿Cómo mantengo segura mi clave de la Claude API en un servidor?

Manténgala en el servidor y fuera del código. Guárdela en un archivo que sólo pueda leer la cuenta con la que se ejecuta el agente, cárguela en el servicio como una variable de entorno y no la confirme nunca en un repositorio ni la exponga a un navegador. Como todas las solicitudes a Claude se originan en su servidor, la clave nunca necesita llegar al dispositivo del usuario. Esto facilita proteger un agente ejecutado en el servidor frente a uno integrado en una aplicación cliente.

¿Necesito autohospedar un modelo para crear un agente con Claude?

No. Con Claude, el modelo es un servicio alojado al que se accede mediante la API, por lo que no hay ningún componente que deba ejecutar en una GPU. Su VPS ejecuta el bucle del agente, las herramientas y los datos, mientras el razonamiento se realiza en la infraestructura de Anthropic. Esto permite que un servidor modesto ejecute un agente capaz. Si quiere usar en su lugar un modelo completamente local, debe seguir el enfoque autohospedado descrito en la guía complementaria sobre cómo crear su propio agente de IA.