Crear un sitio web con IA: de una sola frase a una página lista para publicar
💡 Resumen en una frase: crear un sitio web con un agente de codificación de IA — una frase define el requisito, una lista de estructura, un conjunto de archivos de página estática listos para publicar.
Si buscas «crear sitio web con IA», lo que aparece o bien son anuncios de plataformas de creación de sitios, o bien temarios de cursos tipo «aprende HTML en 30 días». Esta lección toma el camino intermedio, que también es el más corto para crear un sitio web sin conocimientos previos: sin estudiar sintaxis ni comprar servidores, usa un agente de codificación de IA para convertir la idea de una frase en una carpeta de páginas estáticas listas para publicar directamente — sirve para páginas personales, portafolios, landing pages de eventos y sitios de contenido.
Esta es la lección 1 de la ruta A (crear un sitio web) de la práctica por escenarios. Esta lección solo se encarga de «producir la página»: una frase → requisito de tres líneas → lista de estructura → archivos estáticos → verificación; «publicarla en la web pública» es materia de las tres lecciones A2–A4.
- ¿No logras escribir los prompts con claridad? Primero vuelve a 3.2 cómo escribir prompts para ver cómo concretar los requisitos
- ¿Aún no has elegido tu ruta? Vuelve a 4.0 Práctica por escenarios: elige tu ruta
Qué podrás hacer al terminar
- Descomponer «ayúdame a hacer un sitio web» en un requisito de tres líneas que la IA pueda manejar: para quién es, qué deben hacer al verlo, qué contenido debe incluir
- Usar el «método de estructura de páginas» para obtener primero una lista de «páginas × bloques», y solo tras confirmarla dejar que la IA actúe — adiós a la típica cara de plantilla genérica
- Dejar que el agente de codificación de IA escriba el conjunto completo de archivos estáticos
index.html,style.css,script.jsen tu carpeta, que se abre en el navegador con doble clic - Saber explicar qué es un sitio web estático y por qué no hace falta comprar un servidor, y elegir tu plataforma de publicación entre GitHub Pages, Cloudflare Pages y Vercel
Por qué usar un agente de codificación de IA y no una IA en versión web
Ambos permiten que la IA escriba páginas web; la diferencia está en quién remata el trabajo después de escribir:
| Capacidad | IA en versión web (copiar y pegar en el chat) | Agente de codificación de IA (las cuatro herramientas de este curso) |
|---|---|---|
| Forma del resultado | ❌ código pegado en el chat, tú creas los archivos y les pones nombre al guardar | ✅ genera directamente en tu carpeta el conjunto completo de archivos index.html, style.css |
| Sitio web de varias páginas | ❌ una página por conversación, con muchos archivos ya no cuadran | ✅ genera varias páginas de una vez según la lista de estructura, con enlaces que se corresponden entre sí |
| Iteración de rediseño | ❌ cada vez hay que volver a pegar todo el bloque de código | ✅ dices «cambia la imagen de cabecera» y él mismo encuentra el archivo correspondiente y lo modifica |
| Conexión con la publicación | ❌ al terminar aún tienes que averiguar tú cómo subirlo | ✅ la carpeta generada ya es un producto desplegable, entra directamente en las lecciones de publicación A2–A4 |
Las cuatro herramientas hacen en esta lección lo mismo: escribir los archivos directamente en la carpeta que tú indiques. Si aún no tienes las herramientas instaladas, vuelve a 1.5 Instalación de Claude Code; si no quieres tocar para nada la línea de comandos, mira la versión de escritorio de WorkBuddy en 1.5b Formas alternativas de instalación.
Tu situación actual
- «Llevo años queriendo hacer una página personal, pero al buscar tutoriales solo encuentro cursos de introducción a HTML/CSS, y solo la configuración del entorno ya me desanima»
- «Pedí a una IA en versión web que escribiera una página, copié el código y lo guardé como archivo, pero al abrirlo o no se mostraban las imágenes o el estilo era un caos, y no sabía dónde estaba el error»
- «La página ya está escrita, ¿y ahora qué? Escuché que hay que comprar un servidor, instalar entornos y pelearse con el dominio, así que lo dejé aparcado»
Cuándo usar esta técnica
Cuando necesitas:
- Una vitrina a la que cualquiera accede con un enlace: página personal, portafolio, landing page de evento, sitio de contenido
- Ver una página accesible este mismo fin de semana, y además publicarla gratis
- Una página principalmente de exhibición: obras, presentación, datos de contacto
Y no quieres:
- Estudiar primero a fondo el trío fundamental del frontend antes de empezar
- Crear archivos a mano, gestionar código, buscar erratas
- Ponerte a investigar servidores, bases de datos y operaciones desde el principio
¿Los visitantes deben dejar comentarios, hacer pedidos o registrarse? Estas funciones dinámicas no se hacen en la primera versión — el motivo y la salida están en el punto 2 de «avisos de errores comunes» más abajo.
🎒 Preparativos antes de empezar
- Haber completado 4.0 Práctica por escenarios: elige tu ruta, confirmando que tomas la ruta A de sitios web
- Al menos una herramienta capaz de completar una ronda de diálogo — si no la tienes instalada, vuelve a 1.5 Instalación de Claude Code; si no quieres tocar para nada la línea de comandos, mira 1.5b Formas alternativas de instalación
- Una idea real en una frase (por ejemplo, «una página personal para exhibir mis fotografías») — un objetivo real dura más que un «proyecto de práctica»
- Una carpeta vacía, donde la IA escribirá los archivos del sitio web
- Un vaso de agua ☕
Hazlo conmigo
En cinco pasos, tu carpeta tendrá un conjunto de páginas listas para publicar. El ejemplo usa uniformemente «página personal de portafolio fotográfico»; cámbialo por tu propio tema y sigue los mismos pasos.
Paso 1: convierte la idea de una frase en un requisito de tres líneas
Por qué: «ayúdame a hacer un sitio web» es el requisito que la IA menos puede manejar — cuanto más concreto el objetivo, más probable es que la IA acierte a la primera; esto se explicó en 3.2 cómo escribir prompts. Primero responde tú tres preguntas, y después hablamos de código.
Toma tu frase y completa las tres líneas (ejemplo del portafolio fotográfico):
Hacer un sitio web de portafolio fotográfico.
Para quién: clientes que quieran contratarme para sesiones de fotos, y conocidos curiosos por lo que fotografío.
Qué hacer al verlo: recorrer las obras, percibir el estilo fotográfico y luego escanear el código para agregarme en WeChat y reservar una sesión.
Debe incluir: imagen de cabecera en la página principal, obras agrupadas en 3 secciones, sobre mí, datos de contacto.Deberías ver: un requisito de tres líneas, una información clara por línea — esta es la «información de entrada» de todos los prompts posteriores y también el criterio de referencia al verificar.
Paso 2: haz que la IA primero entregue una lista de la estructura de páginas
Por qué: planificar antes de actuar es la primera regla del vibe coding (3.1 planifica antes de actuar). Si empiezas a escribir sin confirmar la estructura y la IA se desvía, tendrás que rehacer la página entera; pide primero la lista y el retrabajo será mínimo.
Envía las tres líneas de requisitos a la IA y dile claramente «aún no escribas código»:
Según los requisitos siguientes, planifica la estructura de páginas para un sitio web de portafolio de fotografía. Aún no escribas código.
Requisitos: está pensado para clientes que quieren reservar una sesión de fotos; al verlo deben poder explorar las obras, percibir el estilo y añadirte en WeChat para reservar.
Debe incluir: imagen de cabecera en la página principal, obras agrupadas en 3 secciones, sobre mí, datos de contacto.
Salida:
1. Cuántas páginas se recomienda crear y el nombre de archivo de cada una
2. Qué secciones tiene cada página de arriba abajo y qué contenido va en cada sección
3. Preséntalo en una tablaDeberías ver: la IA entrega una lista de «página × sección», por ejemplo index.html: navegación / imagen de cabecera / zona de obras (dividida en 3 grupos) / sobre mí / contacto. Revísala línea por línea: elimina las secciones sobrantes, añade las que falten y confirma hasta que reconozcas cada sección.
💡 Esto es el «método de estructura de páginas»
Primero pide la estructura, luego el código, en dos preguntas separadas. Esta lista es el plano de obra entre tú y la IA: después la usarás para generar, verificar y revisar, y la IA tampoco irá perdiendo por el camino la sección de «contacto».
Paso 3: haz que la IA genere los archivos del sitio estático
Por qué: lo que vas a publicar es un sitio estático. ¿Qué es un sitio estático? En una frase: un sitio compuesto por archivos HTML, CSS y JavaScript que el navegador carga directamente; la definición oficial de GitHub Pages es «tomar los archivos HTML, CSS y JavaScript directamente del repositorio y publicarlos como sitio web».
No necesita un servidor ejecutando programas, así que los archivos puros que escribe la IA ya se pueden publicar.
Una vez confirmada la lista de estructura sin errores, dile a la IA:
Genera los archivos del sitio según la estructura que acabamos de confirmar y escríbelos en la carpeta actual:
- index.html es la página de inicio; el orden de las secciones sigue la lista de estructura
- los estilos van en style.css y los scripts de interacción en script.js
- para las imágenes de las obras usa primero imágenes de marcador de posición, todas en la carpeta images/
- HTML/CSS/JS puro, sin frameworks que requieran un paso de compilaciónDeberías ver: en la carpeta aparecen los archivos index.html, style.css, script.js y la carpeta images/; si la lista de estructura incluye varias páginas, también aparecerán archivos de página como about.html.
💡 Este es el valor exclusivo de los agentes de código con IA
No es «enseñarte un fragmento de código», sino «escribir los archivos por ti»: cada sección de la lista acaba en un archivo real y tú no tocaste el editor en ningún momento. Las cuatro herramientas lo logran; WorkBuddy también incluye la «operación de archivos locales» como capacidad central.
Paso 4: verifica en el navegador y devuelve tus comentarios
Por qué: las páginas que escribe la IA hay que abrirlas y verlas uno mismo antes de hablar de publicar; la disciplina de la 3.4 verificación de aceptación se aplica igual a un sitio con solo tres archivos.
Haz doble clic en index.html dentro de la carpeta (o arrastra el archivo a la ventana del navegador) y revisa sección por sección contra la lista de estructura.
Deberías ver: el navegador abre tu página con la cabecera, la zona de obras, sobre mí y el contacto de arriba abajo, sin desordenarse al estrechar la ventana.
Lo que no te guste, devuélvelo directamente, hablando como si dieras comentarios de revisión:
La página en general está bien; cambia tres cosas:
1. La cabecera es demasiado alta: en la primera pantalla ya debería verse el título de la zona de obras
2. Cambia las tarjetas de obras a 3 por fila
3. En la sección de contacto añade una imagen de marcador de posición con el código QR de WeChatDeberías ver: la IA modifica solo los archivos correspondientes; al volver al navegador y refrescar, tienes la nueva versión. Repite dos o tres rondas hasta que tú mismo estés dispuesto a enviar ese enlace a otra persona.
Paso 5: elige la plataforma de hosting y completa el último paso de hacer un sitio web con IA
Por qué: con un sitio estático no tienes que comprar un servidor; la plataforma de hosting se encarga de publicar los archivos en la red pública, y las tres ofrecen un plan gratuito. Cuál elegir depende de cómo quieras entregar la carpeta.
| Plataforma | Cómo publicar | Para quién |
|---|---|---|
| A2 GitHub Pages | creas un repositorio en la web, unos clics de configuración y se publica, con la dirección username.github.io | quien quiera además un repositorio de GitHub |
| A3 Cloudflare Pages | arrastras la carpeta o un zip en el navegador y obtienes la dirección 项目名.pages.dev | quien no quiera ni crear un repositorio, solo arrastrar y listo |
| A4 Vercel | un solo comando en la carpeta del proyecto vercel --prod para desplegar | quien use agentes de código con IA y quiera publicar con un solo comando |
Las cuotas, limitaciones y recomendaciones de los planes gratuitos de las tres, de un vistazo en A5 comparación de plataformas de despliegue. Un aviso: la documentación oficial de Cloudflare ya recomienda que los proyectos nuevos empiecen con Workers, pero para un principiante la subida por arrastre de Pages sigue siendo la vía más directa para publicar; se explicará en A3.
Deberías ver: ya elegiste la plataforma. La próxima lección empieza con A2 GitHub Pages: el asistente web no requiere línea de comandos en ningún momento y además te deja tener tu primer repositorio de GitHub.
📋 Prompts mágicos
Las instrucciones de «sígueme paso a paso» son ejemplos; las tres siguientes son plantillas para que uses una y otra vez: cambia el tema, cambia el estilo, solo modifica lo que va entre 【】. Usa los tres Prompts en orden: 1 estructura → 2 archivos → 3 autoverificación antes de publicar.
📋 Prompt 1: una frase → lista de estructura de páginas
Resultado esperado: introduces una idea en una frase y obtienes una tabla de estructura de «página × sección»: primero planificar, sin escribir código.
## Rol
Eres un planificador web senior, experto en descomponer ideas vagas en estructuras de páginas claras.
## Tarea
Convierte mi idea de sitio web en una lista de estructura de páginas. Aún no escribas ningún código.
## Información de entrada
### Campos obligatorios
- Tema del sitio:【una frase, por ejemplo «página personal de portafolio de fotografía」】
- Para quién:【visitantes objetivo, cuanto más concreto mejor】
- Qué hacer al terminar de ver:【la acción que más quieres que complete el visitante】
### Campos opcionales
- Contenido imprescindible:【secciones o información que deben aparecer, ¿sí?】
- Sensación de estilo:【dos palabras, por ejemplo «minimalista, sereno」, ¿vale?】
## Especificaciones de salida
Una tabla: nombre de archivo de la página | secciones (de arriba abajo) | qué contenido va en cada sección. No más de 5 páginas en total.
## Condiciones
- ✅ Cada sección sirve a los objetivos de «para quién / qué hacer al terminar de ver»
- ✅ Nombres de archivo en minúsculas inglesas; la página de inicio siempre index.html
- ❌ No generar ningún código
- ❌ No sugerir funciones que requieran base de datos o servidor📝 Prompt 2: generar archivos del sitio estático según la estructura
Resultado esperado: convertir la lista de estructura confirmada en un conjunto completo de archivos HTML/CSS/JS que se ven con doble clic y se publican arrastrándolos tal cual.
## Rol
Eres un ingeniero front-end, experto en escribir a mano páginas estáticas con semántica clara y cero dependencias.
## Tarea
Genera todos los archivos del sitio según la lista de estructura y escríbelos en la carpeta actual.
## Información de entrada
### Campos obligatorios
- Lista de estructura:【pega aquí la tabla confirmada con el Prompt 1】
- Tema y estilo del sitio:【una frase】
### Campos opcionales
- Paleta de colores:【color principal, por ejemplo «verde oscuro», ¿vale?】
- Sensación tipográfica:【por ejemplo «sin serifa, títulos grandes», ¿vale?】
## Especificaciones de salida
index.html (y las demás páginas), style.css, script.js; las imágenes como marcadores de posición en la carpeta images/; los enlaces entre páginas correspondidos entre sí.
## Condiciones
- ✅ HTML/CSS/JS puro, con doble clic en index.html ya se puede ver
- ✅ index.html va en el nivel más externo de la carpeta: GitHub Pages lo busca como archivo de entrada
- ✅ En pantallas estrechas (ancho de móvil) los bloques se apilan automáticamente, sin desbordamiento horizontal
- ❌ No usar herramientas de compilación, frameworks ni gestores de paquetes
- ❌ No escribir funciones que requieran un servidor para funcionar✅ Prompt 3: autochequeo antes de publicar
Resultado esperado: entregar la carpeta a la IA para un control de calidad y evitar descubrir solo después de subirla que los enlaces están rotos.
## Rol
Eres un inspector de calidad previo a la publicación; solo buscas problemas, no haces rediseños.
## Tarea
Revisa el sitio estático de la carpeta actual e informa de los problemas que deben corregirse antes de publicar.
## Información de entrada
### Campos obligatorios
- Lista de páginas: [por ejemplo index.html, about.html]
## Especificaciones de salida
Enumera los problemas por gravedad: enlaces entre páginas que no coinciden / rutas de imágenes erróneas / archivos referenciados que no existen / index.html no está en el nivel más externo. Para cada problema indica el archivo afectado y una frase con la solución.
## Condiciones
- ✅ Verificar archivo por archivo
- ✅ Informar solo de problemas que existen realmente
- ❌ No rediseñar de paso ni ajustar textos
- ❌ No añadir páginas ni funciones nuevasPuntos de control ✅
- Los tres requisitos en tres líneas están redactados: para quién / qué hacer tras verlo / qué contenido debe incluir
- Has obtenido y confirmado la lista de estructura «página × bloque», sabiendo qué va en cada bloque
- En el nivel más externo de la carpeta está
index.html, y con doble clic se abre en el navegador - Has verificado bloque por bloque contra la lista de estructura y has devuelto todas las correcciones
- Has elegido la plataforma de publicación y sabes a qué capítulo pasar en la próxima lección
Advertencias de errores comunes
❌ Empezar diciendo «hazme un sitio web»
Síntoma: la IA devuelve un bloque entero de HTML con sabor a plantilla, imposible de saber por dónde empezar a modificarlo, y cuanto más lo tocas peor se vuelve.
Causa: sin lista de estructura, la IA solo puede adivinar tus necesidades basándose en «el sitio web más común».
Solución correcta: separar en dos preguntas: primero pedir la estructura con el Prompt 1 y, tras confirmarla, pedir los archivos con el Prompt 2. Los cinco minutos que ahorras con «un sitio web de una sola frase» los devuelves con creces al hacer revisiones.
❌ Querer hacer inicio de sesión, comentarios o pagos en línea en la primera versión
Síntoma: el formulario parece funcionar, pero los datos que envían los visitantes no tienen dónde guardarse; hacer registro o inicio de sesión es aún más impensable.
Causa: un sitio estático no tiene programa de servidor. GitHub Pages oficialmente no admite lenguajes de servidor como PHP, Ruby o Python: es un límite de la plataforma, no un problema de capacidad de la IA.
Solución correcta: hacer la primera versión puramente estática: mostrar obras, indicar claramente los datos de contacto; igualmente se logra el objetivo de «conseguir encargos de fotos». Si de verdad necesitas funciones dinámicas, hay dos caminos: elegir Vercel o Cloudflare Pages y conocer sus funciones de plataforma (A5 comparación de plataformas de despliegue); o consultar la aplicación web de WorkBuddy en «técnicas avanzadas» más abajo.
❌ Usar el plan gratuito como sitio comercial, o creer que un repositorio privado nadie puede verlo
Síntoma: se cuelgan anuncios en la página y se empieza a aceptar encargos, o se sube directamente contenido que no querías hacer público.
Causa: el plan Hobby (gratuito) de Vercel se limita a uso personal no comercial; el plan gratuito de GitHub Pages exige que el repositorio sea público y el contenido del sitio es visible en la red pública, incluso si el repositorio se configura como privado.
Solución correcta: no pongas en el plan gratuito de Vercel páginas que cobren dinero; si te importa que el contenido sea público, piensa bien qué vas a subir antes de publicar. Las condiciones gratuitas de las tres plataformas están listadas punto por punto en A5 comparación de plataformas de despliegue; revísala antes de elegir plataforma.
Técnicas avanzadas (opcional)
🚀 ¿Quieres funciones dinámicas como mensajes o reservas? (opcional)
Estático ≠ solo páginas inertes. Dos caminos avanzados:
- Funciones de plataforma: Cloudflare Pages Functions y Vercel permiten ejecutar código de servidor sin gestionar tú mismo un servidor, ideal para resolver pequeñas necesidades dinámicas dentro de la ruta A; cómo elegir, ver A5
- Publicación de la «aplicación web» de WorkBuddy: la IA genera el sitio web y conecta bajo demanda base de datos en la nube, autenticación de identidad y almacenamiento de archivos; la explicación oficial dice «no es necesario comprar un servidor propio ni configurar despliegue ni operaciones de mantenimiento diarias»; basta con pulsar el botón de compartir o decirle a la IA «publicar / poner en línea», ideal para quien no quiere tocar el despliegue en absoluto; el uso se explica en 2.4 uso de WorkBuddy
🚀 ¿Más de una página, o quieres usar un framework? (opcional)
- Planificar varias páginas en la lista de estructura: pide a la IA que en la salida del Prompt 1 enumere nombres de archivos de página como
about.html,works.html; el Prompt 2 los genera de una vez, con navegación correspondiente entre sí - Querer usar un framework como VitePress: las tres plataformas de alojamiento admiten compilación automática, pero eso es asunto de después de A5; en la primera parada recorre todo el proceso con archivos estáticos escritos a mano y lo entenderás mucho mejor
Resumen de la lección
✅ Has completado la mitad de «hacer» de crear un sitio web con IA:
- Una frase → tres requisitos en tres líneas: para quién / qué hacer tras verlo / qué contenido debe incluir
- Tres requisitos → lista de estructura: primero pedir la estructura y luego el código; nombres de archivo en minúsculas inglesas, página de inicio
index.html - Lista de estructura → archivos estáticos: el agente de codificación de IA escribe directamente
index.html,style.css,script.js - Archivos → verificación: comparar bloque por bloque en el navegador y devolver los comentarios tal cual
- Verificación → elegir plataforma: GitHub Pages / Cloudflare Pages / Vercel, cada plan gratuito tiene sus condiciones
| Etapa | Qué has producido | Punto clave |
|---|---|---|
| Definir requisitos | Tres requisitos en tres líneas | Para quién / qué hacer tras verlo / qué contenido debe incluir |
| Definir estructura | Lista «página × bloque» | Primero planificar y luego escribir código; página de inicio fija en index.html |
| Generación | Una carpeta de archivos estáticos | HTML/CSS/JS puro, con doble clic ya se ve |
| Verificación | Páginas vistas e iteradas | Revisar bloque por bloque contra la lista; no cambiar el diseño, solo dar opiniones |
| Elegir plataforma | Una elección de publicación clara | Las condiciones de los planes gratuitas difieren; A5 tiene la tabla completa |
Hoy has generado con IA todos los archivos del sitio web, sin escribir una sola línea de código ni comprar nada: la parte de «hacer» llega aquí a su fin.
Avance de la próxima lección
En la próxima lección, A2 Publicación en GitHub Pages: alojamiento gratuito de sitios estáticos, convertirás la carpeta en una URL accesible desde la red pública. Aprenderás:
- Crear un repositorio llamado
username.github.ioy publicar con unos clics en la página web - Elegir la rama de publicación en Settings → Pages y por qué el archivo de entrada debe estar en el nivel superior del directorio de publicación
- Tras el push hay que esperar hasta 10 minutos, y dónde buscar la causa si el sitio tarda en actualizarse
- El plan gratuito exige un repositorio público: qué significa esto para tu contenido
Cuando estés listo, ten la carpeta a mano y pasa a A2 →