Desplegar desde Claude Code: un flujo de trabajo práctico con Lizard

Claude Code puede desplegar una aplicación usando las herramientas de un proveedor de hosting en tu entorno de desarrollo. Con Lizard, el agente puede inspeccionar el proyecto, usar Lizard CLI para desplegar, configurar dependencias y comprobar el servicio en vivo. El host ejecuta la aplicación cuando termina la sesión de código.

El resultado útil es un flujo de usuario funcionando en una URL real, no solo un comando que sale con éxito. Esta guía verifica Lizard CLI y la documentación enlazada a fecha de 9 de septiembre de 2026.

Dale al agente el contexto correcto

Empieza con un repositorio que compile y tenga un comando de inicio para producción. Identifica el espacio de trabajo y el proyecto que deben ser propietarios, si necesita base de datos o worker, y si el despliegue crea una copia de prueba o cambia un servicio existente.

Instala el CLI y lee sus instrucciones acordes a la versión:

npm install -g @lizard-build/cli
lizard skills get core --json
lizard status --json

Si se necesita autenticación, usa lizard login y completa el inicio de sesión en el navegador. Para las instrucciones reutilizables del agente, sigue el repositorio de Lizard Skill. La propia visión general de Claude Code describe cómo trabaja con una base de código y herramientas.

El agente debe inspeccionar la configuración existente antes de añadir nada. Una versión de runtime, Dockerfile o comando de inicio ya presente en el proyecto es mejor evidencia que uno adivinado por el nombre del framework.

Un prompt que define la tarea de despliegue

Dale al agente una instrucción acotada como:

Despliega este repositorio en el proyecto existente de Lizard my-project como servicio de prueba. Lee la guía actual de Lizard CLI e inspecciona primero los comandos de build e inicio. Usa la fuente de GitHub si el repositorio tiene un remote de GitHub accesible. Configura los servicios que la app realmente necesita. Verifica la URL en vivo, los logs y un flujo real de la aplicación. Reporta la revisión desplegada y cualquier comprobación que falle.

Sustituye el proyecto y el entorno por el objetivo previsto. Indica explícitamente cuándo debe cambiar un servicio o dominio de producción. El agente no debe inferir una migración de base de datos de producción de una petición para publicar una copia de prueba.

Elige despliegue por Git o subida de fuentes

Usa la integración de GitHub del repositorio cuando quieras que commits posteriores disparen despliegues. La guía de despliegue con GitHub cubre la conexión y configuración del servicio. Revisa la rama seguida y el directorio raíz para un monorepo.

Para un proyecto local sin remote de GitHub adecuado, está disponible la subida de fuentes. Tras seleccionar el espacio de trabajo correcto, un nuevo proyecto y servicio de ejemplo pueden usar:

lizard init --name my-project
lizard add --service api
lizard up --service api

Estos nombres son ejemplos. Para un proyecto existente, confirma el enlace actual con lizard status --json y selecciona el servicio existente. No crees otro proyecto ni cambies un servicio respaldado por Git a subida solo para evitar leer su configuración.

Lizard realiza el build alojado. Dependiendo de la configuración del proyecto y servicio, puede usar el Dockerfile del repositorio o generar uno mediante la ruta de build soportada. Lee la documentación de despliegue y mantén repetibles los ajustes en la referencia de configuración.

Conecta la base de datos deliberadamente

Crear Managed Postgres no demuestra que la aplicación pueda alcanzarla. La aplicación debe leer la variable de conexión que configures. Para un proyecto con un servicio llamado api y su primer add-on PostgreSQL llamado postgres, la referencia es:

lizard add postgres
lizard secrets set 'DATABASE_URL=${{postgres.DATABASE_URL}}' --service api

Usa el nombre real del add-on si difiere. Configura cada servicio consumidor, incluidos workers, con las variables que necesita. Ejecuta migraciones como paso controlado de release y confirma una lectura y escritura de la aplicación contra la base de datos prevista. Consulta referencias de variables y Managed Postgres.

Para subidas, elige almacenamiento que sobreviva al ciclo de vida que tu app necesita. Para un worker, comprueba que puede alcanzar el broker y manejar reinicios. Evita tratar la creación exitosa de recursos como una configuración de aplicación completada.

Comprueba el resultado desde fuera

Usa salida estructurada para diagnóstico:

lizard status --json
lizard logs --service api --json
lizard logs --service api --build --json
lizard metrics --service api --json

Luego obtén la URL en vivo y ejerce un flujo real. Para una API pequeña, puede ser autenticación seguida de escritura y lectura. Para un frontend, comprueba una ruta alcanzada directamente por URL así como mediante navegación del lado cliente.

Si el despliegue falla, usa el error reportado para elegir la siguiente comprobación:

Un agente debe reportar un error sin resolver en vez de declarar éxito desde el log de build. La guía de hosting Python da ejemplos de problemas con el comando de inicio.

Entiende el coste del flujo de trabajo

Tu suscripción de código y la factura de hosting pagan partes distintas del trabajo. Lizard usa pay as you go sin suscripción mensual. Su página de precios lista tarifas de recursos y términos de pago. Un servicio de prueba, base de datos o sandbox pueden seguir consumiendo recursos tras terminar la sesión de código.

Establece límites de recursos y revisa el uso. Detén o elimina recursos temporales cuando ya no se necesiten mediante tu proceso de aprobación normal. No asumas que cerrar Claude Code detiene una aplicación que ya se ha desplegado.

FAQ

¿Claude Code hostea la app? El objetivo de despliegue lo hace. Claude Code usa herramientas para preparar y desplegar el código; el proveedor de hosting ejecuta la aplicación resultante.

¿Puedo desplegar un repositorio de GitHub existente? Sí, si Lizard puede acceder a él. Configura el repositorio, rama y servicio mediante el flujo de despliegue con Git, luego verifica la revisión desplegada.

¿Las bases de datos se conectan automáticamente? Aprovisiona la base de datos, configura la variable que lee la aplicación y prueba la conexión. Son comprobaciones separadas.

¿Puede el mismo flujo funcionar con otro agente de código? Un agente que pueda usar las herramientas requeridas puede seguir las mismas comprobaciones de despliegue. Lee su propia configuración de permisos y herramientas en vez de asumir que todo entorno se comporta como Claude Code.

¿Cómo sé que el despliegue está completo? Confirma la URL en vivo, la revisión esperada, proceso sano y comportamiento significativo de la aplicación. Un build exitoso por sí solo no basta.