Tu primer proyecto con Claude Code: de carpeta vacía a algo que funciona

Vas a construir tu primera mini aplicación con Claude Code: una lista de pendientes que funciona en tu navegador, sin escribir una sola línea de código. Es para vos si ya instalaste Claude Code pero estás mirando la terminal sin saber qué pedirle.

Antes de empezar

• Claude Code instalado y con sesión iniciada. Si al escribir claude en PowerShell se abre el asistente, estás listo.
• Una idea chica. Para el primer proyecto, la regla de oro: algo que se abra en el navegador, sin cuentas de usuario, sin base de datos, sin pagos. Una lista de pendientes, una calculadora de presupuesto, un generador de ideas de posts. Hoy usamos la lista de pendientes, pero los pasos sirven para cualquiera.
• Media hora tranquila. El proyecto sale en minutos; la media hora es para que juegues con él.

Paso 1 — Creá una carpeta solo para este proyecto

Abrí PowerShell y escribí estas dos líneas (Enter después de cada una):

mkdir mi-primera-app
cd mi-primera-app

La primera crea la carpeta, la segunda te mete adentro. Esto importa más de lo que parece: Claude Code trabaja dentro de la carpeta donde lo abrís. Un proyecto = una carpeta. Siempre.

Paso 2 — Abrí Claude Code adentro

claude

Listo, ya está mirando tu carpeta vacía. Todo lo que cree va a quedar ahí, ordenado.

Paso 3 — Pedile el proyecto como un encargo, no como una orden técnica

No necesitás hablar "en programador". Necesitás hablar como cliente exigente: qué hace, cómo se ve, qué NO necesita. Pegale algo así:

Quiero una lista de pendientes para uso personal. Que pueda agregar
tareas, marcarlas como hechas y borrarlas. Que se guarde solo en mi
navegador para no perder nada al cerrar. Diseño simple y moderno,
fondo oscuro. Todo en UN solo archivo HTML que pueda abrir con
doble clic. No necesita internet ni cuentas de usuario.

El truco del "un solo archivo HTML" es oro para principiantes: sin instalaciones, sin servidores, doble clic y funciona.

Paso 4 — Aprobá permisos y dejalo trabajar

Claude va a pensar, escribir código y pedirte permiso antes de crear cada archivo o correr comandos. Leé qué te pide — es una línea, no un contrato. Para crear archivos dentro de tu propia carpeta de proyecto, aprobá tranquilo. Esa costumbre de leer antes de aprobar te va a salvar más adelante, cuando los proyectos sean más grandes.

Paso 5 — Probalo como usuario, no como dev

Cuando te diga que terminó, no le creas: comprobalo. Andá a la carpeta, doble clic en el archivo HTML, y usalo de verdad: agregá tareas, marcá, borrá, cerrá el navegador y volvé a abrir para ver si guardó. Si algo falla, no necesitás entender el código; describí el problema con palabras:

cuando marco una tarea como hecha y cierro el navegador,
al volver aparece sin marcar. Arreglalo.

Claude investiga y corrige. Este ida y vuelta ES el trabajo. Vos ponés los ojos de usuario; él pone el código.

Paso 6 — Pedile que deje notas para el futuro

Antes de cerrar, un pedido más:

Escribí un archivo de notas explicando qué hace este proyecto,
cómo se usa y qué quedó pendiente, para retomarlo otro día.

Dentro de una semana no te vas a acordar de nada. Las notas escritas convierten un experimento suelto en un proyecto que podés continuar.

Errores comunes

• Abriste claude en cualquier carpeta (Descargas, tu carpeta de usuario) → los archivos quedan mezclados con tu vida. Salí, creá una carpeta para el proyecto y abrilo ahí.
• Pediste un monstruo de entrada ("haceme un Netflix con usuarios y pagos") → el resultado decepciona porque el pedido era humo. Primer pedido: chico, visible, usable hoy.
• Reportás "no funciona" a secas → Claude no puede adivinar. Contale qué hiciste, qué esperabas y qué pasó en cambio. Con eso lo resuelve casi siempre.
• Aceptás el "ya está listo" sin abrirlo vos → la IA a veces canta victoria antes de tiempo. La prueba final siempre la hacés vos, con tus manos.

Siguiente paso

Ya tenés el ciclo completo: carpeta → pedido claro → permisos → prueba real → notas. Lo que sigue es aprender a retomar proyectos en sesiones nuevas, a pedir cambios más ambiciosos por etapas, y — cuando un proyecto se vuelva importante — a guardarlo con control de versiones (un historial de cambios que te deja volver atrás). Con eso pasás de "hice una cosita con IA" a tener un taller propio.