Skip to content

Publicar en Vercel: despliegue con un solo comando mediante un agente de codificación con IA ​

💡 Resumen en una frase: la ruta más corta para poner un sitio online con Vercel — npm i -g vercel instalar una vez, vercel login iniciar sesión una vez, y después cada publicación es cosa de un solo comando; además, estos comandos se pueden entregar completos a un agente de codificación con IA para que los ejecute por ti.

Al buscar «tutorial de despliegue en Vercel», lo que aparece son sobre todo los documentos originales en inglés, que explican desde el registro, la creación del proyecto y la conexión del repositorio; con tantos pasos es fácil quedarse atascado a mitad de camino. Este tutorial en español lo acorta: una carpeta local + unos comandos, y en unos diez minutos publicas en la web la página que hizo la IA — si estás usando un agente de codificación con IA, incluso puedes dejar que el agente ejecute todos estos comandos por ti.

Esta es la lección 4 de la ruta A del escenario práctico (crear sitios web), y también la última de las tres rutas para poner un sitio online: A2 GitHub Pages va por el asistente web, A3 Cloudflare Pages va por la carga con arrastrar y soltar, y el Vercel de esta lección va por la línea de comandos — para quien escribe código con agentes de IA, suele ser la ruta más cómoda.

Qué podrás hacer al terminar ​

  • Instalar e iniciar sesión en Vercel CLI: npm i -g vercel + vercel login (requisito: Node.js 18+)
  • Ejecutar en el directorio del proyecto un solo comando vercel para completar el despliegue, y luego usar vercel --prod para publicar la versión oficial que verá todo el mundo
  • Delegar todo el despliegue a un agente de codificación con IA: envías un prompt y él ejecuta los comandos por ti y te devuelve el enlace online
  • Conocer los límites del plan gratuito Hobby: 100 GB de tráfico al mes, 100 despliegues al día, 200 proyectos, y solo para uso personal no comercial

Tu situación actual ​

  • «La IA ya me escribió todos los archivos de la página, pero al buscar cómo desplegar todo son documentos en inglés: CLI, build, deploy, un montón de términos que dan dolor de cabeza solo de verlos»
  • «GitHub Pages exige crear un repositorio, Cloudflare obliga a entrar en la consola a buscar la opción, ¿no hay una forma más sencilla de publicar?»
  • «Si el agente de IA ya sabe ejecutar comandos de terminal, ¿por qué este paso de publicar online tengo que hacerlo yo manualmente, uno por uno?»

Cuándo usar esta técnica ​

Cuando necesitas:

  • Publicar lo antes posible en la web la página estática de esa carpeta local y obtener un enlace que puedas compartir
  • Que cada futura revisión y republicación sea también cosa de un solo comando
  • Dejar que el agente de codificación con IA se encargue de todo — ejecutar comandos de terminal es precisamente su punto fuerte

Y no quieres:

  • Crear repositorios de Git ni gestionar ramas (el flujo oficial de Vercel CLI no pasa por el repositorio)
  • Rellenar la configuración de compilación campo por campo en formularios de la consola

🎒 Preparativos antes de empezar ​

  • Haber completado A1 Crear un sitio web con IA: tener en local una carpeta con páginas estáticas (el resultado de A1, cuya entrada suele ser index.html)
  • Registrar una cuenta de Vercel (registro gratuito en el sitio oficial; para uso personal, el plan predeterminado es el gratuito Hobby)
  • Tener instalado Node.js 18 o superior en el ordenador (Vercel exige oficialmente Node.js 18+; se puede descargar e instalar desde nodejs.org)

Requisitos del sistema ​

ElementoRequisito
Node.js18 o superior
Gestor de paquetescualquiera de npm / pnpm / yarn / bun
Cuentacuenta de Vercel (plan Hobby gratuito)
Proyectocarpeta local del proyecto (páginas estáticas generadas en A1)

Idea central ​

El flujo de trabajo oficial de Vercel empieza con el CLI: instalar una vez, iniciar sesión una vez, y después cada despliegue es un solo comando. El CLI detecta automáticamente qué framework usa tu proyecto y luego construye y despliega — no tienes que indicar el comando de compilación ni elegir el directorio de salida.

El despliegue tiene dos niveles, y los comandos solo se diferencian en un parámetro:

  • vercel: despliegue de vista previa, al terminar te da una URL de vista previa para que compruebes primero el resultado
  • vercel --prod: despliegue de producción, la versión oficial que se publica para todo el mundo

Dos formas de publicar online, elige una ​

ComparaciónForma A: un comando del CLI (línea principal de esta lección)Forma B: conectar Git desde la consola
Dónde se operaTerminalConsola del navegador
¿Requiere repositorio?El flujo oficial no pasa por un repositorio Git; se despliega directamente la carpeta localEl código debe estar en un repositorio de GitHub / GitLab / Bitbucket
Primera publicaciónvercel + vercel --prod dos comandosElegir el repositorio en la página New Project y pulsar Deploy
Actualizaciones posterioresVolver a ejecutar vercel --prodCada push dispara automáticamente un nuevo despliegue
Para quién esUsas agentes de codificación con IA y quieres publicar lo antes posibleYa sabes Git y quieres «push y publicado»

Cuánta cuota incluye el plan Hobby gratuito ​

El registro gratuito usa justamente el plan Hobby; la cuota gratuita de Vercel se basa principalmente en estos puntos:

ElementoCuota gratuita Hobby
Número de proyectos200
Número de despliegues100 por día
Tráfico (Fast Data Transfer)100 GB al mes
Dominios personalizados por proyecto50
Invocaciones de funciones (Function Invocations)1,000,000 al mes
Transformaciones de imágenes (Image Transformations)5,000 al mes
Consecuencias de exceder la cuotaLa mayoría de las funciones tardan 30 días en restablecerse (Web Analytics se puede reactivar tras 7 días de pausa)

Para sitios como páginas personales o portafolios, 100 GB/mes sobran.

⚠️ El plan Hobby no se puede usar con fines comerciales

Los términos de uso justo del plan Hobby indican claramente: solo para uso personal y no comercial. Para sitios corporativos o proyectos de clientes, actualiza a Pro ($20/usuario/mes por asiento de desarrollador), o consulta la A5 comparación de plataformas de despliegue para cambiar de plataforma.

Hazlo conmigo ​

Paso 1: instalar Vercel CLI (un solo comando global) ​

Por qué: Vercel dice oficialmente que «cada flujo de trabajo empieza con la CLI»; incluso los agentes de IA despliegan proyectos usándola.

Práctica recomendada (si tienes Node instalado, npm ya viene incluido):

bash
npm i -g vercel

Lectores que ya usan pnpm / yarn / bun, elige uno de los cuatro:

bash
pnpm i -g vercel
yarn global add vercel
bun add -g vercel

Deberías ver: el registro de instalación termina de desplazarse, la terminal vuelve al prompt y no hay errores en rojo.

  • Pequeña verificación: la instalación no arroja errores (si quedó bien instalado o no, se verá de inmediato al iniciar sesión en el siguiente paso)

Paso 2: iniciar sesión en tu cuenta de Vercel (vercel login) ​

Por qué: antes de desplegar hay que vincular la CLI con tu cuenta de Vercel, para que los despliegues posteriores queden registrados en tu proyecto.

bash
vercel login

Deberías ver: la CLI muestra un aviso de autenticación; sigue las indicaciones para completar la autenticación con tu cuenta de Vercel y la terminal mostrará que iniciaste sesión correctamente.

  • Pequeña verificación: la terminal confirma que has iniciado sesión con tu cuenta

Paso 3: ejecutar el comando central del tutorial de despliegue de Vercel (vercel) ​

Por qué: este único comando es el protagonista de todo el tutorial de despliegue de Vercel: la CLI detecta automáticamente el framework, construye el proyecto y completa el despliegue, todo en un solo comando.

Operación: primero entra en la carpeta de tu proyecto (el directorio donde la IA generó la página en A1) y luego ejecuta:

bash
vercel

Deberías ver: la CLI detecta el framework → construye → despliega de una sola vez y, al final, entrega una URL de vista previa; ábrela en el navegador y tu página ya está en línea.

  • Pequeña verificación: la URL de vista previa abre tu página en el navegador

Paso 4: publicar el despliegue de producción (vercel --prod) ​

Por qué: el vercel del paso 3 genera un despliegue de vista previa; para la versión oficial que verán los visitantes hay que ejecutar un comando más.

bash
vercel --prod

Deberías ver: se completa otra construcción y despliegue, y esta vez obtienes la URL de producción: esa es la que debes compartir en redes o imprimir en tarjetas de presentación (la dirección en línea bajo el dominio vercel.app).

  • Pequeña verificación: la URL de producción es accesible y el contenido coincide con la vista previa

Paso 5: delegar todo el despliegue al agente de codificación con IA (recomendado) ​

Por qué: los cuatro pasos anteriores son todos comandos de terminal, y ejecutar comandos de terminal es precisamente el punto fuerte de los agentes de codificación con IA. Vercel incluye directamente en su documentación de Getting started un «Agent prompt»: el agente instala la CLI, inicia sesión, despliega y devuelve el enlace, todo de una vez.

Operación: abre tu agente de codificación con IA en el directorio del proyecto y envíale el siguiente mensaje:

text
Ayúdame a desplegar en Vercel:
1. Instala globalmente Vercel CLI (npm i -g vercel) e inicia sesión con vercel login.
2. Ejecuta vercel en el directorio actual del proyecto para completar el despliegue y envíame el enlace de vista previa.
3. Sugiere el siguiente paso según mi proyecto, por ejemplo vincular un dominio personalizado o configurar variables de entorno.

Deberías ver: el agente ejecuta por ti los comandos de los pasos 1–4 y, al final, pega el enlace en línea de vuelta en la conversación.

¿Todavía no has instalado un agente de codificación con IA? Vuelve a 1.5 instalar Claude Code; si prefieres la versión de escritorio, consulta 1.5b formas alternativas de instalación.

💡 El «trío» oficial

Vercel también ha preparado para los agentes de IA un trío formado por Plugin / Skills / MCP, que permite al agente consultar directamente la documentación oficial y gestionar proyectos y despliegues; esta jugada avanzada se explica en detalle en 5.2 Vercel × cadena de herramientas de IA.

Método B: sin línea de comandos, despliegue desde la consola conectando Git ​

Requisito previo: los archivos de la página ya están subidos a un repositorio de GitHub / GitLab / Bitbucket (si creaste un repositorio en A2 GitHub Pages, reutilízalo directamente).

  1. Abre la página New Project de la consola de Vercel
  2. Conecta tu cuenta de GitHub / GitLab / Bitbucket
  3. Elige un repositorio y haz clic en Deploy

Deberías ver: al terminar el despliegue obtienes la dirección en línea; después, cada push a la rama conectada activa automáticamente un nuevo despliegue.

Puntos de control ✅ ​

  • npm i -g vercel se instala sin errores y vercel login muestra la sesión iniciada
  • Ejecutar vercel en el directorio del proyecto y obtener la URL de vista previa, que se abre en el navegador
  • Tras vercel --prod la URL de producción es accesible
  • Poder nombrar los tres límites del plan Hobby: 100 despliegues por día, 100 GB de tráfico al mes y solo uso personal no comercial
  • Conocer las consecuencias de exceder la cuota: la mayoría de las funciones tardan 30 días en restablecerse

Advertencias de errores comunes ​

❌ Trampa 1: versión de Node.js inferior a 18 ​

Síntoma: errores al instalar o ejecutar la CLI. Causa: Vercel CLI exige oficialmente Node.js 18+. Solución correcta: primero confirma que la versión de Node no sea inferior a 18 (si lo es, instala la nueva versión en nodejs.org) y luego vuelve a ejecutar npm i -g vercel.

❌ Trampa 2: ejecutar vercel y difundir el enlace como si fuera la dirección oficial ​

Síntoma: el enlace compartido corresponde a un despliegue de vista previa, no a la versión oficial. Causa: vercel genera un despliegue de vista previa; para publicar al público hay que usar el despliegue de producción de vercel --prod. Solución correcta: usa la URL de vista previa para tu propia verificación y la URL de producción de vercel --prod para compartir al público.

❌ Trampa 3: desplegar un proyecto comercial con el plan gratuito Hobby ​

Síntoma: el sitio corporativo o los trabajos por encargo se publican con el plan Hobby, lo que infringe las reglas de la plataforma. Causa: los términos de uso justo del plan Hobby indican claramente «solo para uso personal y no comercial». Lo correcto: para proyectos comerciales, pasa a Pro (asiento de desarrollador $20/usuario/mes), o consulta la comparativa de plataformas de despliegue A5 para cambiar de plataforma.

❌ Trampa 4: creer que al superar el límite se recupera al día siguiente ​

Síntoma: se supera el tráfico o el número de despliegues, y las funciones relacionadas quedan suspendidas. Causa: tras superar el límite del plan Hobby, la mayoría de las funciones tardan 30 días en volver a estar disponibles (Web Analytics es la excepción: se recupera tras 7 días de suspensión). Lo correcto: vigila el uso tras publicar; los sitios personales normalmente no alcanzan los límites, y los proyectos con mucho tráfico deberían considerar Pro u otra plataforma de antemano.

Técnicas avanzadas ​

  • Añadir una base de datos con un clic: ¿tu proyecto necesita guardar datos? vercel install neon (o upstash, supabase) puede instalar integraciones del Marketplace directamente desde la CLI, y Vercel escribirá automáticamente las credenciales en el .env.local del proyecto.
  • Vincular tu propio dominio: ¿no quieres el sufijo vercel.app? La documentación oficial de Vercel tiene una guía "Add a custom domain"; para el método general, consulta 5.3 Dominio personalizado.
  • Dejar que el agente tome el control a fondo: instala los Plugin / Skills / MCP de Vercel y el agente de IA podrá consultar la documentación oficial, gestionar proyectos y despliegues; consulta 5.2 Vercel × cadena de herramientas de IA.

Resumen de esta lección ​

✅ La ruta más corta de este tutorial de despliegue en Vercel:

  • npm i -g vercel → vercel login → vercel → vercel --prod, cuatro comandos desde la instalación hasta la publicación
  • vercel genera un despliegue de vista previa, vercel --prod genera producción; usa este último para compartir con el exterior
  • También se puede sin tocar la línea de comandos: conecta el repositorio de Git en la página New Project de la consola, y a partir de entonces cada push se despliega automáticamente
  • Plan gratuito Hobby: 200 proyectos / 100 despliegues al día / 100 GB de tráfico al mes / 50 dominios por proyecto, solo para uso personal no comercial
  • Todo el flujo se puede empaquetar en un solo prompt y entregarlo a un agente de codificación de IA para que lo ejecute
ComandoFunciónCuándo usarlo
npm i -g vercelInstala Vercel CLI globalmenteSolo una vez
vercel loginInicia sesión en tu cuenta de VercelSolo una vez (repite al cambiar de cuenta)
vercelDespliegue de vista previa, genera una URL de vista previaCada vez que quieras ver primero el resultado
vercel --prodDespliegue de producción, genera la URL oficialPara publicar y actualizar la versión oficial
vercel install neonInstala integraciones de bases de datos con un clicCuando el proyecto necesita almacenamiento

Avance de la próxima lección ​

Ya has recorrido las tres rutas de publicación: GitHub Pages, Cloudflare Pages y Vercel, cada una con su cuota gratuita y su carácter propios. La próxima lección A5 Comparativa de plataformas de despliegue: cuotas gratuitas, límites y cómo elegir reúne a las tres en una sola tabla.

Aprenderás:

  • Cuánta cuota gratuita ofrece cada una y qué ocurre al superar el límite
  • Qué plataforma elegir según el tipo de usuario (sin línea de comandos / con Git / con agente de IA)
  • En qué orden decidir cuando tienes dudas
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.