Curso para Juan Manuel

Cómo armamos plataformas de verdad

Esto es lo mismo que usamos nosotros: Claude Code para escribir el código, GitHub para guardarlo, Supabase para los usuarios y los datos, y Vercel o Cloudflare para publicarlo. Cada módulo se abre por separado — ve avanzando cuando tengas tiempo, no hay que hacerlo todo en un día.

¿Solo necesitas mandar una página simple, sin usuarios ni base de datos? Con eso te alcanza la guía más corta.

El mapa completo, antes de entrar en detalle

Cinco piezas, cada una hace una sola cosa. Ninguna reemplaza a la otra.

Tu ideaClaude Code GitHubSupabase Vercel / CloudflareLink real, en internet
Claude Code

El mismo Claude que ya conoces, pero corriendo en tu computador. Escribe el código directo en tus archivos, no solo te lo muestra en el chat.

GitHub

La caja fuerte donde queda guardada cada versión del código. Si algo se rompe, siempre puedes volver a una versión anterior.

Supabase

La base de datos. Ahí quedan los usuarios que se registran, sus contraseñas (protegidas) y toda la información que la plataforma junta.

Vercel / Cloudflare

Quien publica la plataforma en internet con un link real, y la actualiza sola cada vez que Claude Code sube un cambio a GitHub.

1
Módulo 1

Instalar y usar Claude Code

Es distinto al Claude que usas en el navegador. Claude Code corre en la Terminal de tu computador (una ventana negra de puros comandos) y desde ahí puede crear archivos, escribir código, ejecutarlo y corregirlo — todo en tu carpeta de proyecto.

1Instala Node.js. Entra a nodejs.org, descarga la versión "LTS" y instálala con Siguiente → Siguiente → Finalizar. Esto es lo que permite que tu computador entienda el comando de instalación.
2Abre una Terminal. En Windows, busca "PowerShell" en el menú Inicio y ábrelo.
3Instala Claude Code. Pega el comando de abajo y presiona Enter.
terminal
npm install -g @anthropic-ai/claude-code

Cuando termine, para abrirlo:

  1. Entra a la carpeta de tu proyectoEn la Terminal, escribe cd y arrastra la carpeta a la ventana, o escribe la ruta completa. Si no existe todavía, créala primero en el Explorador de archivos.
  2. Escribe claude y EnterSe abre tu navegador para que inicies sesión con tu cuenta de Claude, la misma que ya usas.
  3. Ya estás dentroAhora le escribes en español lo que quieres, igual que en el chat normal, pero él va a crear los archivos de verdad en esa carpeta.

Prompt para partir un proyecto nuevo, dentro de Claude Code:

primer-prompt.txt
Quiero armar una plataforma simple para [describe en una frase qué hace: ej. "que mis clientes
se registren y vean el estado de su pedido"]. Todavía no tengo base de datos ni nada conectado.
Empecemos por la pantalla principal y el formulario de inicio de sesión, con HTML simple,
sin conectar nada todavía. Ve explicándome qué archivo vas creando y para qué sirve.
Si el comando no funciona: puede que la Terminal necesite reiniciarse después de instalar Node.js, o que tu cuenta de Claude no incluya Claude Code todavía. Avísale a Mario y lo revisan juntos.
2
Módulo 2

GitHub — dónde queda guardado el código

GitHub no es para escribir código a mano. Es la caja fuerte que guarda cada versión de lo que Claude Code va armando, y es lo que Vercel o Cloudflare miran para saber qué publicar. Tú casi no lo tocas directamente — le pides a Claude Code que lo haga por ti.

  1. Crea tu cuentaEntra a github.com → "Sign up". Usa un correo que revises seguido.
  2. Instala GitHub DesktopDescárgalo en desktop.github.com e inicia sesión ahí, una sola vez. Esto le da permiso a tu computador para guardar cosas en tu cuenta — después Claude Code lo usa solo, sin pedirte clave cada vez.
  3. No necesitas aprender los comandos de gitCuando tengas algo listo en Claude Code, simplemente pídeselo: "Sube este proyecto a GitHub, crea un repositorio llamado [nombre]". Él corre los comandos por ti.
Repositorio es solo la palabra para "carpeta de proyecto guardada en GitHub". Cada proyecto nuevo = un repositorio nuevo.
3
Módulo 3

Supabase — usuarios y base de datos

Supabase hace dos cosas: guarda información en tablas (como una planilla en la nube), y maneja el registro/inicio de sesión de los usuarios, con las contraseñas protegidas automáticamente — tú nunca las ves ni las guardas a mano.

  1. Crea tu cuenta y tu proyectoEntra a supabase.com → "Start your project" → regístrate con Google. Luego "New Project": nómbralo, crea una contraseña de base de datos (guárdala) y elige la región más cercana. Espera ~2 minutos.
  2. Copia tus dos clavesVe a Settings → API. Copia la Project URL y la anon public key a un bloc de notas — son las que le vas a pasar a Claude Code.
  3. Activa el registro con correoVe a Authentication → Providers → confirma que "Email" esté activado. Con eso Supabase ya sabe recibir gente que se registra.

Prompt para que Claude Code conecte todo esto:

conectar-supabase.txt
Conecta este proyecto a Supabase. Mi Project URL es [TU PROJECT URL] y mi anon key es
[TU ANON KEY]. Agrega registro e inicio de sesión con correo y contraseña usando supabase-js.
Cuando alguien se registre, crea automáticamente una fila para esa persona en una tabla llamada
perfiles, con su correo y la fecha. Configura los permisos (Row Level Security) para que cada
usuario solo pueda ver y editar su propia fila, nunca la de otro.
Row Level Security (RLS): es la regla que decide quién puede ver o escribir cada fila de una tabla. Sin esa regla, cualquiera podría ver los datos de todos los usuarios. Por eso siempre se lo pides a Claude Code explícitamente, como en el prompt de arriba.
4
Módulo 4

Vercel y Cloudflare — publicarlo en internet

Con el código en GitHub, falta un último paso: conectarlo a un servicio que lo publique y le dé un link real. Usamos principalmente Vercel; Cloudflare es el respaldo cuando Vercel falla o para publicar algo suelto muy rápido.

Vercel (el principal)

  1. Crea tu cuenta con GitHubEntra a vercel.com → "Sign Up" → elige "Continue with GitHub". Así quedan las dos cuentas conectadas de una vez.
  2. "Add New" → "Project"Elige el repositorio que Claude Code creó en GitHub y toca "Deploy". No cambies ninguna otra opción.
  3. Listo, y queda automáticoCada vez que Claude Code suba un cambio nuevo a GitHub, Vercel publica esa versión sola, sin que tengas que hacer nada más.
  4. Las claves de Supabase van aparteEn el proyecto de Vercel: Settings → Environment Variables. Ahí pegas la Project URL y la anon key, para que no queden visibles dentro del código.

Cloudflare (el respaldo)

  1. Crea tu cuentaEntra a cloudflare.com → regístrate gratis.
  2. Workers & Pages → Create → conectar a GitElige el mismo repositorio de GitHub. Funciona igual que Vercel: cada cambio se publica solo.
  3. Para algo suelto, sin cuentaSi solo necesitas publicar una página simple ya (sin usuarios, sin base de datos), sigue usando Netlify Drop como en la guía corta — es más rápido para eso.
5
Módulo 5

La receta completa, de principio a fin

Cuando ya tengas las cuatro cuentas creadas (Claude Code instalado, GitHub, Supabase, Vercel), este es el orden real, cada vez que armes algo nuevo:

No tienes que memorizar nada de esto. La gracia es que Claude Code hace el trabajo técnico; tú describes lo que quieres, revisas el resultado y decides qué se manda. Cuando algo no calce con lo que le pediste a un cliente, pregúntale a Mario antes de mandarlo.
Copiado