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 vercelinstalar una vez,vercel logininiciar 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.
- ¿Todavía no has creado la página? Vuelve primero a A1 Crear un sitio web con IA
- ¿Quieres comparar las tres opciones antes de empezar? Salta directamente a A5 Comparación de plataformas de despliegue
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
vercelpara completar el despliegue, y luego usarvercel --prodpara 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
| Elemento | Requisito |
|---|---|
| Node.js | 18 o superior |
| Gestor de paquetes | cualquiera de npm / pnpm / yarn / bun |
| Cuenta | cuenta de Vercel (plan Hobby gratuito) |
| Proyecto | carpeta 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 resultadovercel --prod: despliegue de producción, la versión oficial que se publica para todo el mundo
Dos formas de publicar online, elige una
| Comparación | Forma A: un comando del CLI (línea principal de esta lección) | Forma B: conectar Git desde la consola |
|---|---|---|
| Dónde se opera | Terminal | Consola del navegador |
| ¿Requiere repositorio? | El flujo oficial no pasa por un repositorio Git; se despliega directamente la carpeta local | El código debe estar en un repositorio de GitHub / GitLab / Bitbucket |
| Primera publicación | vercel + vercel --prod dos comandos | Elegir el repositorio en la página New Project y pulsar Deploy |
| Actualizaciones posteriores | Volver a ejecutar vercel --prod | Cada push dispara automáticamente un nuevo despliegue |
| Para quién es | Usas agentes de codificación con IA y quieres publicar lo antes posible | Ya 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:
| Elemento | Cuota gratuita Hobby |
|---|---|
| Número de proyectos | 200 |
| Número de despliegues | 100 por día |
| Tráfico (Fast Data Transfer) | 100 GB al mes |
| Dominios personalizados por proyecto | 50 |
| Invocaciones de funciones (Function Invocations) | 1,000,000 al mes |
| Transformaciones de imágenes (Image Transformations) | 5,000 al mes |
| Consecuencias de exceder la cuota | La 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):
npm i -g vercelLectores que ya usan pnpm / yarn / bun, elige uno de los cuatro:
pnpm i -g vercel
yarn global add vercel
bun add -g vercelDeberí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.
vercel loginDeberí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:
vercelDeberí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.
vercel --prodDeberí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:
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).
- Abre la página New Project de la consola de Vercel
- Conecta tu cuenta de GitHub / GitLab / Bitbucket
- 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 vercelse instala sin errores yvercel loginmuestra la sesión iniciada- Ejecutar
vercelen el directorio del proyecto y obtener la URL de vista previa, que se abre en el navegador - Tras
vercel --prodla 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(oupstash,supabase) puede instalar integraciones del Marketplace directamente desde la CLI, y Vercel escribirá automáticamente las credenciales en el.env.localdel 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ónvercelgenera un despliegue de vista previa,vercel --prodgenera 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
| Comando | Función | Cuándo usarlo |
|---|---|---|
npm i -g vercel | Instala Vercel CLI globalmente | Solo una vez |
vercel login | Inicia sesión en tu cuenta de Vercel | Solo una vez (repite al cambiar de cuenta) |
vercel | Despliegue de vista previa, genera una URL de vista previa | Cada vez que quieras ver primero el resultado |
vercel --prod | Despliegue de producción, genera la URL oficial | Para publicar y actualizar la versión oficial |
vercel install neon | Instala integraciones de bases de datos con un clic | Cuando 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