Publicar tu web en internet con Vercel y Claude Code

Tu web funciona en tu ordenador. Nadie más puede verla.

Has creado tu proyecto con Claude Code. Tiene diseño profesional, formulario de contacto y hasta una calculadora de precios. Abres el navegador, escribes localhost:3000 y todo funciona perfecto. Pero hay un problema: solo tú puedes verlo.

Publicar tu web en internet para que cualquier persona pueda acceder con un enlace real es el paso que separa un experimento local de un producto de verdad. Y con Vercel, ese paso tarda literalmente 30 segundos.

Qué es Vercel (y por qué lo necesitas)

Imagina que tu proyecto es un producto terminado dentro de un almacén. Está listo para venderse, pero nadie puede comprarlo porque no tiene tienda. Vercel es tu escaparate: toma lo que construiste en tu ordenador y lo coloca en internet con una dirección real que cualquiera puede visitar.

En términos simples, Vercel es un servicio que se encarga de todo lo técnico para que tu web esté disponible las 24 horas del día, desde cualquier parte del mundo. No necesitas contratar un servidor, configurar nada complejo ni entender cómo funciona la infraestructura de internet.

Lo mejor: tiene un plan gratuito que es más que suficiente para lanzar tu primer proyecto.

Paso 1: instalar Vercel en tu ordenador

Antes de publicar, necesitas instalar la herramienta de Vercel. Abre Claude Code y escribe:

Instala la herramienta de línea de comandos de Vercel de forma global

Claude ejecutará el comando necesario para instalar Vercel. Verás un mensaje de confirmación cuando termine.

Paso 2: conectar tu cuenta de Vercel

Ahora necesitas que Vercel sepa quién eres. Pídele a Claude:

Conecta mi cuenta de Vercel

Se abrirá una ventana en tu navegador donde podrás crear una cuenta gratuita (o iniciar sesión si ya tienes una). Una vez que confirmes, Claude recibirá la autorización automáticamente.

Paso 3: publicar con un solo comando

Aquí viene la parte que sorprende a todos los participantes del workshop. Desde la carpeta de tu proyecto, pídele a Claude:

Publica este proyecto en Vercel

Claude ejecutará vercel --yes y en unos 30 segundos verás algo así en tu terminal:

✅ Production: https://mi-proyecto-abc123.vercel.app

Ese enlace es tu web. Funcionando. En internet. Accesible para cualquier persona del mundo.

Copia ese enlace, pégalo en el navegador de tu móvil y compruébalo tú mismo. Lo que hace cinco minutos solo existía en tu ordenador ahora tiene su propia dirección en internet.

Paso 4: actualizaciones automáticas con GitHub

Publicar una vez está bien. Pero lo verdaderamente potente es que cada cambio que hagas se publique automáticamente, sin que tengas que repetir el proceso.

Para eso, conectas tu proyecto con GitHub (el lugar donde se guarda tu código en la nube). Pídele a Claude:

Crea un repositorio en GitHub para este proyecto y conéctalo con Vercel

Claude creará el repositorio, subirá tu código y configurará Vercel para que cada vez que guardes un cambio, la web se actualice sola. Sin volver a ejecutar nada. Sin tocar la terminal.

El flujo queda así:

1. Le pides un cambio a Claude ("Cambia el color del botón a verde")
2. Claude hace el cambio y lo guarda en GitHub
3. Vercel detecta el cambio y actualiza la web automáticamente
4. En 30 segundos, tu web pública ya muestra la nueva versión

Es como tener un equipo de publicación invisible trabajando en segundo plano.

Qué puede salir mal (y cómo solucionarlo)

Los errores más comunes al publicar son sencillos de resolver:

"No estoy en la carpeta correcta." Vercel necesita ejecutarse desde la carpeta raíz de tu proyecto. Si Claude muestra un error, dile: "Asegúrate de estar en la carpeta del proyecto y vuelve a intentar publicar."

"El proyecto no compila." A veces tu proyecto funciona en modo desarrollo pero tiene errores que aparecen al publicar. Pídele a Claude: "Compila el proyecto para producción y arregla los errores que encuentres."

"Necesito variables de entorno." Si tu proyecto usa servicios externos (como Supabase para la base de datos), necesitas configurar las claves en Vercel. Dile a Claude: "Configura las variables de entorno del proyecto en Vercel."

En todos los casos, Claude puede diagnosticar y resolver el problema sin que tú tengas que entender los detalles técnicos.

De proyecto local a producto público

Publicar tu web es el momento en que tu idea se convierte en algo tangible. Ya no es "algo que estoy haciendo". Es una dirección que puedes compartir por correo, por mensaje o en tu tarjeta de visita.

Y lo que antes requería contratar un desarrollador, configurar servidores y esperar días, ahora sucede en menos de un minuto. Con una frase en español.

Si estás empezando con Claude Code y quieres entender todas las posibilidades, consulta la guía completa de Claude Code. Y si quieres aprender a crear el proyecto que vas a publicar, empieza por vibe coding: crear tu web sin programar.

Siguiente lectura: Añadir base de datos a tu proyecto con Supabase | Ver la guía completa