← Volver a docs
▲Vercel CLI·cli

Vercel CLI — Guía de inicio

Instala, autentica y haz tu primer deploy desde la terminal con Vercel CLI.

Última actualización: 11 de julio de 2026

Instalación

# Con npm (recomendado)
npm i -g vercel

# Con pnpm
pnpm add -g vercel

# Con yarn
yarn global add vercel

# Con bun
bun add -g vercel

Autenticación

vercel login

Esto abre el navegador para que vincules tu cuenta. Si estás en una máquina sin GUI (como un VPS):

vercel login --github  # usa GitHub OAuth sin navegador

Tu primer deploy

Desde la carpeta de tu proyecto:

vercel              # preview deploy
vercel --prod       # producción

La primera vez te hará algunas preguntas:

  • Set up and deploy? → Yes
  • Which scope? → tu cuenta o team
  • Link to existing project? → No (primera vez)
  • Project name? → como quieras llamarlo
  • In which directory is your code located? → ./
  • Override settings? → No

Después te dará una URL tipo https://tu-proyecto-abc123.vercel.app.

Comandos del día a día

vercel                    # deploy a preview
vercel --prod             # deploy a producción
vercel ls                 # lista tus deploys
vercel inspect <url>      # info detallada de un deploy
vercel logs <url>         # logs de functions
vercel env                # gestionar variables de entorno
vercel env add            # añadir variable
vercel env ls             # listar
vercel env rm             # borrar
vercel domains ls         # listar dominios custom
vercel domains add        # añadir dominio

Variables de entorno

# Para development
vercel env add SUPABASE_URL development
# te pregunta el valor

# Para producción
vercel env add SUPABASE_URL production

# Aplicar cambios (re-deploy)
vercel --prod

En el código las lees con process.env.SUPABASE_URL.

Pull de variables de entorno

Para usar las mismas variables en local:

vercel env pull .env.local

Esto crea .env.local con todas las variables de tu proyecto (perfecto para Supabase keys, etc.).

CI/CD: deploy token

Para deployar desde CI (GitHub Actions, etc.):

# Crear token
vercel login --token-only
# o desde el dashboard: Settings → Tokens → Create Token

Workflow típico

# 1. Empezar proyecto nuevo
mkdir mi-app && cd mi-app
echo "<h1>Hola</h1>" > index.html
vercel

# 2. Iterar
echo "<h1>Hola mundo</h1>" > index.html
vercel

# 3. Subir a producción
vercel --prod

# 4. Configurar dominio custom
vercel domains add miproyecto.com
# luego configuras los DNS en tu proveedor

Recursos