Cómo crear tu primer proyecto con inteligencia artificial

Si lo único que has hecho con inteligencia artificial es abrir un chat y hacerle preguntas, esta guía es para ti.

No vas a aprender a programar. No vas a necesitar saber qué es una API. Vas a tomar una idea que tienes en la cabeza, ordenarla, y terminar con algo que funciona y que puedes volver a usar.

Son tres pasos, y en dos de ellos hay un prompt listo para copiar y pegar:

Esos dos prompts son el corazón de todo esto. El resto es acompañamiento.

Una advertencia antes de empezar, porque prefiero decírtela ahora que a mitad de camino: no toda idea sirve como primer proyecto. Lee la sección que sigue antes de arrancar.

Antes de empezar: si tu idea sirve para esto

Este es el filtro que casi nadie te da, y es la razón principal por la que la gente abandona su primer proyecto a mitad de camino.

Tu idea sirve como primer proyecto si cumple estas tres cosas:

1. Los datos ya los tienes. Están en tu computador, en una hoja de cálculo, en un archivo que puedes descargar, o los puedes copiar y pegar. Si hay que conectarse a un sistema que no controlas, como tu banco, una plataforma cerrada o el sistema de tu empresa, eso no es un primer proyecto.
2. Tú lo abres cuando lo necesitas. No corre solo, no se actualiza mientras duermes, no te manda notificaciones. Tú lo ejecutas cuando quieres el resultado. Que algo funcione solo, sin ti, es lo más difícil de todo esto.
3. El resultado es algo que puedes ver. Un archivo, una pantalla, un documento, una carpeta organizada. Algo que abres y dices "ah, ahí está".

Si tu idea no cumple alguna, no la botes: córtala. Casi siempre hay una versión más pequeña de la misma idea que sí cumple, y esa versión te enseña lo suficiente para atacar la grande después.

Un ejemplo, porque siempre lo piden. La idea original: "quiero un dashboard que maneje todas mis finanzas y se actualice solo". Esa idea completa no sirve para empezar. Los datos viven en tu banco, "que se actualice solo" es la parte más difícil que existe, y "todas mis finanzas" en realidad son seis proyectos distintos disfrazados de uno.

La versión que sí sirve: "tengo el archivo que descargué de mi banco este mes, quiero ver mis gastos organizados por categoría y entender en qué se me fue la plata". Eso lo terminas en una tarde, lo abres y lo entiendes, y el mes siguiente lo vuelves a usar con el archivo nuevo. Lo de que se actualice solo queda para después, cuando ya sepas pedirlo bien.

No es conformarse. Es terminar algo.

Paso uno: cuando todavía no sabes qué vas a construir

Este es el paso que la gente se salta y es el que decide si tu proyecto funciona.

Tú tienes una idea en la cabeza. Pero una idea en la cabeza no es un proyecto: le faltan bordes, le faltan decisiones, y sobre todo le falta una respuesta a la pregunta "¿cómo voy a saber que quedó bien?". Si arrancas a construir sin eso, vas a terminar con algo que funciona pero que no era lo que querías.

Así que no vamos a empezar con un prompt que construya. Vamos a empezar con un prompt que te entreviste.

Qué hacer:

1. Abre una conversación nueva en Claude, en claude.ai o en la app.
2. Copia el prompt de abajo y pégalo.
3. Responde las preguntas con calma y con sinceridad. Si te pregunta cuánto tiempo te quita algo, piénsalo de verdad.
4. Al final te va a entregar un bloque de texto. Guárdalo. Ese bloque es lo que vas a usar en el paso 3.

Vas a ayudarme a definir un proyecto que quiero construir con inteligencia artificial. Todavía no vamos a construir nada. En esta conversación solo vamos a dejar clarísimo QUÉ voy a construir y CÓMO voy a saber que funcionó.

Sobre mí: nunca he creado nada con IA. Solo he hablado con un chat y le he preguntado cosas. Nunca he hecho una automatización, un agente, un dashboard, una página, nada. Tengo una idea en la cabeza pero está desordenada y probablemente no sé explicarla bien todavía.

CÓMO QUIERO QUE HABLEMOS

- Una sola pregunta por mensaje. No me mandes listas de preguntas.
- Sin términos técnicos. Si necesitas usar uno, explícamelo en una línea antes de usarlo.
- No me des ejemplos de proyectos que otras personas hacen. Quiero que salga lo mío, no que copie lo tuyo.
- Si te respondo algo vago, no lo dejes pasar. Repregúntame usando MI contexto, no un ejemplo genérico.
- Máximo 8 preguntas en total. Si con menos ya entendiste, para antes.

FASE 1. ENTENDER

Hazme preguntas hasta entender esto:

- Qué hago hoy a mano que quiero que deje de ser a mano
- Cada cuánto lo hago y cuánto tiempo me quita
- Dónde vive hoy la información con la que trabajo
- Cómo se ve el momento en que digo "listo, ya quedó"
- Si alguien más además de mí lo usa o lo recibe
- Qué se rompe hoy cuando esto sale mal

Empieza por la primera pregunta y espera mi respuesta.

FASE 2. DEVOLVERME LO QUE ENTENDISTE

Cuando termines de preguntar, escríbeme con tus palabras qué entendiste que quiero. Corto. Y pregúntame si está bien o si me falta algo. No sigas hasta que yo te confirme.

FASE 3. REVISAR SI ESTO ES POSIBLE, Y RECORTAR

Antes de proponerme el recorte, revisa si esto es realmente construible por alguien sin experiencia técnica y dime la verdad:

- ¿De dónde van a salir los datos, y puedo obtenerlos yo sin conocimiento técnico? Si tengo que descargarlos a mano cada vez, dímelo claro.
- ¿Esto necesita funcionar solo, sin que yo lo abra? Si sí, adviérteme que eso es lo más difícil de todo y propóneme primero la versión que yo ejecuto cuando quiero.
- ¿Necesito pagar algo o crear cuentas en servicios?

Si de aquí sale que mi idea completa no es viable como primer proyecto, dímelo directo y propóneme el pedazo que sí lo es. No me construyas una versión aguada de algo imposible: mejor algo pequeño y completo.

Luego proponme la versión MÁS PEQUEÑA de esto que de verdad me sirva. Dime explícitamente qué estás dejando por fuera y por qué. Espera a que yo confirme el recorte.

FASE 4. ENTREGABLE

Cuando confirme, dame ÚNICAMENTE esto, con estos títulos exactos:

NOMBRE DEL PROYECTO
QUÉ HACE, una sola frase
OUTCOME, qué cambia en mi día cuando esto exista
CÓMO SÉ QUE FUNCIONÓ, algo concreto que yo pueda verificar
CÓMO LO HAGO HOY, el proceso manual actual, paso a paso
ALCANCE v1, qué sí incluye
FUERA DE ALCANCE, qué no incluye y qué de eso queda para después
QUÉ NECESITO TENER A LA MANO, datos, archivos, cuentas o accesos
MI NIVEL, una línea sobre mi experiencia, para quien lea esto después

Sin introducción y sin cierre. Solo ese bloque, para yo copiarlo y pegarlo después.

Dos advertencias sobre este paso. La primera: no aceleres. Vas a sentir la tentación de decir "sí, sí, ya entendiste, dame el resultado". No lo hagas. Las preguntas incómodas, sobre todo la de cómo sabrías que quedó bien, son justamente las que evitan que construyas la cosa equivocada.

La segunda: si te propone recortar, déjate recortar. Te va a doler que te quiten la mitad de la idea. Pero un proyecto pequeño terminado te enseña infinitamente más que un proyecto grande abandonado. La otra mitad no se pierde: queda escrita en "fuera de alcance" y la retomas después.

Paso dos: cuando ya sabes qué quieres y falta dónde

Mi recomendación es Claude Code. No porque sea la única opción, sino porque es la única que trabaja con archivos reales en tu computador: crea carpetas, escribe documentos, ejecuta lo que hay que ejecutar y te deja algo que existe después de que cierras la conversación. Con un chat normal, todo lo que hagas se queda dentro del chat.

Claude Code está en la aplicación de escritorio de Claude, y también en la terminal si eso te gusta. Si es tu primera vez, usa la app de escritorio. No necesitas terminal ni instalar nada por línea de comandos: descargas la app, entras a la sección de Code y ya estás.

Un paso aburrido pero necesario: antes de pasar al paso 3, crea una carpeta nueva en tu computador para este proyecto y ponle el nombre del proyecto. Ahí es donde va a vivir todo. Cuando abras Claude Code le vas a indicar que trabaje en esa carpeta. Sí, es aburrido, pero es lo que hace que esto sea un proyecto y no una conversación.

Instrucciones actualizadas de instalación: docs.claude.com

Paso tres: cuando ya puedes construir

Qué hacer:

1. Abre Claude Code y apúntalo a la carpeta que creaste.
2. Copia el prompt de abajo.
3. Pega tu definición del paso 1 donde dice que la pegues.
4. Manda todo junto, en un solo mensaje.

Este es mi primer proyecto construido con IA. Nunca he usado Claude Code antes de este momento. No sé programar y no quiero aprender a programar para lograr esto. Quiero entender qué estamos haciendo y por qué.

Abajo está la definición de lo que quiero construir. La hice en otra conversación, así que ya está pensada. Léela completa antes de responder.

--- DEFINICIÓN DEL PROYECTO ---

[PEGA AQUÍ EL BLOQUE COMPLETO QUE TE ENTREGÓ EL PROMPT DEL PASO 1]

--- FIN DE LA DEFINICIÓN ---

LO PRIMERO QUE QUIERO QUE HAGAS

Dime honestamente si Claude Code es la herramienta correcta para esto. Si lo que quiero se resuelve mejor en Claude Cowork o incluso en una conversación normal de chat, dímelo ahora y explícame por qué. Prefiero cambiar de herramienta al minuto 1 que perder dos horas en la equivocada.

Si sí es el lugar correcto, dime en una línea por qué y seguimos.

DESPUÉS, EL PLAN

Escríbeme el plan en pasos numerados, en español, sin términos técnicos. Para cada paso quiero saber:

- qué vamos a lograr, no qué archivo vas a tocar
- si necesitas algo de mí en ese paso, y qué exactamente

Si en algún punto voy a necesitar una cuenta, una clave o un permiso, dímelo AHORA en el plan, no cuando ya vayamos a la mitad.

Después de darme el plan, para y espera a que yo lo apruebe.

CÓMO VAMOS A CONSTRUIR

- Un paso a la vez. Terminas un paso, paras, y me muestras algo que yo pueda ver o probar con mis propios ojos. No avances al siguiente sin que yo te confirme.
- No me pidas que lea código ni que me pronuncie sobre decisiones técnicas. Toma tú esas decisiones y cuéntame en una línea qué escogiste y por qué.
- Cuando necesites que yo haga algo por fuera, como crear una cuenta, buscar un archivo o copiar una clave, dime exactamente dónde hago clic y qué escribo. Asume que nunca lo he hecho.
- Cuando algo falle, dime qué falló y qué vas a intentar. Sin drama y sin pegarme el error crudo. Los errores son parte de esto, no una emergencia.
- Si en algún momento crees que lo que pedí en la definición está mal planteado o hay una forma más simple, dímelo. No sigas en silencio.

CUANDO TERMINEMOS

Crea un archivo README.md en la carpeta del proyecto que explique, en español y sin tecnicismos:

- qué es esto y qué hace
- cómo lo uso, paso a paso
- qué hago si deja de funcionar
- qué le podría agregar más adelante

Está escrito para mí dentro de tres meses, cuando ya se me olvidó todo.

No olvides reemplazar el bloque entre corchetes con lo que te entregó Claude en el paso 1. Sin esa definición pegada dentro, el prompt no sirve.

Cuando algo salga mal

Va a salir mal. No es señal de que lo estés haciendo mal, es cómo se construye. Estas cinco frases te sacan de casi cualquier atasco:

• "Copia el error y pégalo tal cual."
• "Para. Explícame en español qué acabas de hacer y por qué, como si yo no supiera nada."
• "Decide tú y dime en una línea qué escogiste y por qué."
• "Llevamos varios intentos en esto. ¿Hay una forma más simple de lograr lo mismo, aunque sea menos elegante?"
• "¿Seguimos alineados con esto?"

Cuando funciona pero no te gusta

Esto es distinto a que algo falle. Es cuando funciona perfectamente y aun así no es lo que querías: se ve feo, está desordenado, le falta algo, sobra algo. Cámbialo, y cámbialo hablando normal. Tú describes lo que quieres, Claude Code se encarga del código.

• "No me gusta cómo se ve. Los colores están muy fuertes, quiero algo más sobrio."
• "Los números están muy pegados, cuesta leerlos."
• "Quiero que lo primero que vea al abrir sea el total, no la lista."
• "Esta parte no la voy a usar nunca. Quítala."
• "¿Se puede agregar que también me muestre el mes pasado, para comparar?"
• "El orden no me sirve. Quiero lo más reciente arriba."
• "Está bien pero se siente complicado. ¿Se puede más simple?"

Ninguna de esas frases tiene una sola palabra técnica y todas funcionan. Mientras más concreta seas, mejor sale. Y hazlo cuantas veces quieras: no hay un número de cambios permitidos.

Los errores que va a cometer todo el mundo

Saltarse el paso 1. Es el más común y el más caro. Sin definición escrita, construyes durante dos horas algo que al final no era lo que querías, y ni siquiera puedes explicar en qué se desvió.

No dejarse recortar. Te van a proponer una versión más pequeña de tu idea y vas a sentir que te están quitando el proyecto. Te están dando el único que vas a terminar.

Tratar los errores como una emergencia. Van a aparecer. Son parte del proceso, no una señal de que esto no es para ti.

Aceptar el primer resultado. Si funciona pero no te gusta, se pide distinto. Mucha gente no lo hace por no saber que se podía.

Por dónde empezar

Cuando termines, haz tres cosas en este orden.

1. Úsalo. No una vez para ver que funciona: úsalo la próxima vez que de verdad lo necesites. Ahí es donde te vas a dar cuenta de lo que le falta, y eso vale más que cualquier revisión teórica.
2. Lee tu README. El archivo que te dejó al final. Si no entiendes algo de lo que dice, pregúntalo ahora, no en tres meses.
3. Abre tu "fuera de alcance". Todo lo que recortaste en el paso 1 sigue ahí escrito. Escoge una sola cosa de esa lista y vuelve a empezar desde el paso 1. Ese es tu segundo proyecto, y ahora sí sabes lo que estás haciendo.

Construiste algo, pero lo importante no es la cosa que construiste. Lo importante es que ahora sabes que la parte difícil nunca fue la tecnología: fue saber exactamente qué querías. Toda la magia de esta guía está en el paso 1, y el paso 1 es puro pensamiento, cero técnica.