Directorio / Guías / Claude Code
De la idea a la página publicada con Claude Code
Cómo pasar de una idea a la página de tu negocio en internet: el brief, la construcción con Claude Code, la vista previa, GitHub, Vercel o Netlify, el dominio y un checklist antes de publicar.
Una página de una sola sección bien hecha cubre lo que la mayoría de los negocios pequeños necesita en internet: que te encuentren, entiendan qué ofreces y te escriban. Con Claude Code la puedes construir y publicar en una tarde. Esta guía usa HTML y CSS simples, sin frameworks: es lo más fácil de mantener y de publicar.
1. Escribe el brief antes de abrir Claude
La calidad de la página depende de este archivo. Crea una carpeta, por ejemplo mi-negocio-web, y dentro un archivo brief.md. Este es un ejemplo inventado:
# Brief
Negocio: Panadería La Espiga, Arequipa
Qué ofrecemos: pan de masa madre y tortas por encargo
Para quién: familias y cafeterías del distrito
Acción principal: escribir por WhatsApp para hacer un pedido
Secciones: inicio, productos, cómo pedir, ubicación y horario
Datos: WhatsApp +51 900 000 000, Calle Ejemplo 123, lunes a sábado de 7 a 19
Tono: cercano y directo, sin exageraciones
Fotos: carpeta fotos/
No incluir: precios, porque cambian cada semana
Copia las fotos a fotos/. Si un dato no está en el brief, Claude lo va a inventar o va a dejar un texto de relleno.
2. Deja que Claude la construya
Abre Claude Code en esa carpeta y cambia a modo Plan con Shift+Tab, para ver la propuesta antes de que escriba archivos. Pídele:
Lee brief.md y construye una página de una sola sección en index.html
con un archivo styles.css. HTML y CSS simples, sin frameworks ni pasos
de build. Diseña primero para celular. Usa solo los datos del brief; si
falta algo, pregúntame en vez de inventarlo. Usa las fotos de fotos/
con texto alternativo.
Revisa el plan, corrige lo que no te convenza y apruébalo. Después ajusta por partes: «el botón de WhatsApp tiene que verse en el celular sin bajar» se puede verificar; «hazla más bonita» no.
3. Mírala en tu computadora
Abre index.html con doble clic y se verá en tu navegador. Para verla como en un celular, abre las herramientas de desarrollo (en Chrome, clic derecho y Inspeccionar) y activa la vista de dispositivo. La app de escritorio también tiene un panel de vista previa.
4. Súbela a GitHub
Vercel y Netlify publican desde un repositorio de GitHub, y cada cambio que subes se publica solo. Pídele a Claude: «Inicializa git, crea un .gitignore, haz el primer commit y súbelo a un repositorio privado de GitHub». Con la CLI de GitHub instalada y la sesión iniciada con gh auth login, el comando que usará se ve así:
gh repo create mi-negocio-web --private --source=. --push
La guía Git y respaldos con Claude Code explica cada paso.
5. Publícala en Vercel o Netlify
- Vercel: en el panel, New Project, eliges el repositorio y lo despliegas. Cada push a la rama principal, normalmente
main, publica una versión nueva. - Netlify: Add new project, luego Import an existing project. Eliges GitHub, autorizas el acceso al repositorio y confirmas con Publish.
Tu página no tiene paso de build, así que no hace falta comando de build. Al terminar, cada servicio te da una dirección provisional para probarla.
| Servicio | Plan gratis | Lo que tienes que saber |
|---|---|---|
| Vercel | Hobby | Es gratis, pero solo para uso personal y no comercial. La página de un negocio necesita el plan Pro, que es de pago. |
| Netlify | Free | 300 créditos al mes con límite fijo. Cada publicación a producción cuesta 15 créditos y cada GB servido, 20. Si se acaban, tus sitios quedan en pausa hasta que se renueven. En equipos nuevos el proyecto puede empezar privado: hazlo público. |
Las condiciones cambian: confírmalas en las páginas de planes de Vercel y Netlify antes de elegir. En el plan gratis de Netlify conviene juntar varios cambios en un solo push.
6. Conecta tu dominio
- Compra el dominio en un registrador o en el mismo servicio.
- Agrégalo al proyecto. En Vercel: Settings, Domains, Add Existing. En Netlify: Domain management, Production domains, Add a domain you already own.
- Copia los registros DNS que te muestra el servicio en el panel de DNS de tu registrador. Vercel te propone sumar también la versión con
www. - Espera y comprueba. El cambio de DNS puede tardar. El panel te indica cuando el dominio quedó bien configurado.
No borres ni cambies los registros MX: son los de tu correo. Si tu correo usa el mismo dominio, un error ahí hace que dejes de recibirlo.
Checklist antes de publicar
- Nombre, dirección, horario y teléfono coinciden con tu perfil de Google y tus redes.
- El teléfono usa un enlace
tel:con código de país, por ejemplotel:+51900000000. - El botón de WhatsApp apunta a
https://wa.me/51900000000: el número completo en formato internacional, sin+, espacios ni guiones. Para un mensaje inicial, agrega?text=con el texto codificado, por ejemplo?text=Hola%2C%20quiero%20hacer%20un%20pedido. - Probaste la dirección provisional en un celular real: textos legibles, botones fáciles de tocar, nada que se salga de la pantalla.
- La abriste en una ventana de incógnito y se ve sin iniciar sesión.
- Tiene
<title>y descripción con el nombre del negocio y la ciudad. - No hay secretos en el repositorio: ni archivos
.env, ni claves de API, ni datos de clientes. Que el repositorio sea privado no hace privada la página. - Todo archivo que subes queda publicado en tu dominio, incluido
brief.md. Si tiene notas internas, agrégalo al.gitignore. - Las fotos están comprimidas y tienen texto alternativo.
Si todavía no instalaste Claude Code, empieza por Claude Code desde cero. Para que Claude recuerde los datos de tu negocio entre sesiones, escribe el CLAUDE.md de tu proyecto.