Cómo iniciar cualquier proyecto con Claude Code
El sistema completo para iniciar cualquier proyecto con Claude Code en 8 pasos: desde definir el problema hasta escalar. Prompts listos para usar, archivos a crear y resultado esperado en cada etapa.
Esta es la columna vertebral del método: el sistema que usás para arrancar cualquier cosa con Claude Code sin improvisar.
📌 Nivel 1 de la ruta: Empezar
Paso 0 — Antes de arrancar
Antes del primer prompt necesitás tener esto andando:
• Node instalado → bajalo de nodejs.org (versión LTS). Probá que quedó: abrí la terminal y corré node -v.
• Terminal básica → saber abrirla y moverte entre carpetas con cd. Nada más.
• Cuenta de Claude → plan Pro (~20 USD/mes) o Max. Claude Code se usa con tu suscripción, no con API key suelta.
Instalar Claude Code (flujo 2026)
npm install -g @anthropic-ai/claude-code
Después entrá a la carpeta de tu proyecto y corré:
claude
Se abre el navegador. Iniciás sesión con tu cuenta de Claude (la del plan Pro o Max) y listo.
No generes una API key en console.anthropic.com para esto. La API key factura por token consumido (más caro e impredecible). Para uso normal querés OAuth con tu plan Pro/Max: precio fijo, sin sustos. Si tenés ANTHROPIC_API_KEY seteada en el sistema, Claude Code factura por API — sacala si querés usar tu suscripción.
Windows — si algo falla:
→ 'npm' no se reconoce → no quedó Node en el PATH. Cerrá y reabrí la terminal. Si sigue, reinstalá Node desde nodejs.org y reiniciá la máquina.
→ Error de permisos al instalar -g → abrí PowerShell como administrador (clic derecho → "Ejecutar como administrador") y volvé a correr el comando.
→ Rutas con espacios (C:\Users\Tu Nombre\...) → metelas entre comillas: cd "C:\Users\Tu Nombre\proyecto".
Una vez que claude arranca dentro de la carpeta, ya podés tirar el primer prompt.
1. Definir el proyecto con claridad
Prompt a usar
Quiero que actúes como un arquitecto de software senior.
Antes de escribir código, haceme todas las preguntas necesarias para entender perfectamente el proyecto que quiero construir.
Tenés que profundizar en:
- Objetivo del producto
- Usuario ideal
- Problema que resuelve
- Funcionalidades principales
- Modelo de negocio (si aplica)
- Tecnologías preferidas (si tengo alguna)
No escribas código todavía. Solo hacé preguntas hasta tener claridad total.
Resultado esperado
Claude te hace entre 10 y 20 preguntas bien pensadas para definir el proyecto con precisión.
Responder todas las preguntas en detalle. Este paso define el 80% del resultado final.
2. Crear el archivo CLAUDE.md (el cerebro del proyecto)
Prompt a usar
En base a toda la información que definimos, creá un archivo CLAUDE.md completo para este proyecto, en la raíz de la carpeta.
Debe incluir:
- Descripción del proyecto
- Objetivo principal
- Usuario objetivo
- Stack tecnológico definido
- Arquitectura del sistema
- Reglas claras de desarrollo (qué hacer y qué evitar)
- Convenciones de código
- Cómo correr el proyecto
- Cómo testearlo
El archivo debe estar optimizado para que Claude Code entienda perfectamente el contexto y tome buenas decisiones.
Resultado esperado
Un archivo CLAUDE.md claro, estructurado y accionable.
No lo creás vos a mano. Claude Code escribe el archivo solo en la raíz del proyecto. Vos lo leés y corregís si algo no cierra.
El detalle: CLAUDE.md es el contexto que Claude lee en cada sesión. Si está bien escrito, deja de adivinar cómo es tu proyecto.
3. Generar el plan del proyecto antes de programar
Prompt a usar
Ahora, en base al contexto del proyecto, quiero que generes un plan de desarrollo completo.
Dividilo en features o módulos pequeños y ordenados.
Para cada feature, incluí:
- Qué se va a construir
- Qué archivos están involucrados
- Dependencias necesarias
- Orden recomendado de implementación
No escribas código todavía. Solo el plan estructurado.
Resultado esperado
Un roadmap claro con todas las funcionalidades separadas en pasos ejecutables.
Revisar el plan y asegurarse de que tenga sentido antes de avanzar.
4. Construir por bloques pequeños (feature por feature)
Prompt a usar
Vamos a implementar la siguiente feature:
[PEGAR FEATURE DEL PLAN]
Quiero que:
- Generes el código necesario
- Crees los archivos correspondientes
- Expliques dónde va cada archivo
- Incluyas validaciones básicas
Mantené el código simple, limpio y funcional.
Resultado esperado
Código funcional para una sola feature, bien separado y entendible.
Probar manualmente que la feature funcione antes de continuar.
5. Agregar testing básico en cada bloque
Prompt a usar
Generá tests básicos para esta feature.
Incluí:
- Casos principales de uso
- Casos de error
- Cómo ejecutar los tests
Usá el stack definido en el proyecto.
Resultado esperado
Tests simples que validen que la feature funciona correctamente.
Ejecutar los tests y validar que todo pase correctamente.
6. Iterar y mejorar constantemente
Prompt a usar
Revisá el código actual del proyecto y proponé mejoras.
Buscá:
- Código innecesario o redundante
- Posibles mejoras de arquitectura
- Problemas de escalabilidad
- Mejores prácticas no aplicadas
Luego sugerí cambios concretos.
Resultado esperado
Lista de mejoras accionables para subir el nivel del proyecto.
Aplicar mejoras antes de seguir escalando.
7. Actualizar el CLAUDE.md continuamente
Prompt a usar
En base a los cambios recientes del proyecto, actualizá el archivo CLAUDE.md.
Asegurate de que refleje:
- Nuevas decisiones técnicas
- Cambios en arquitectura
- Nuevas reglas o convenciones
Resultado esperado
Un CLAUDE.md siempre alineado con el estado real del proyecto.
Reemplazar el contenido del archivo con la nueva versión.
8. Escalar el proyecto de forma ordenada
Prompt a usar
Quiero escalar este proyecto.
Proponé:
- Nuevas features alineadas al objetivo
- Mejoras de performance
- Posibles integraciones
- Cómo estructurar el crecimiento sin romper lo existente
Resultado esperado
Ideas claras para crecer sin perder control del sistema.
Volver al paso 4 y seguir construyendo por bloques.
Ejemplo concreto: calculadora de presupuestos para un taller
Para que los 8 pasos no queden abstractos, así se ve aplicado a algo chico y vendible:
→ Paso 1 → "Quiero una calculadora web donde el dueño de un taller carga repuestos y mano de obra, y le tira un presupuesto en PDF para el cliente." → Paso 2 → Claude crea el CLAUDE.md: stack (Next.js + Tailwind), regla "todo en español rioplatense", cómo correrlo. → Paso 3 → Plan: feature 1 = formulario de carga, feature 2 = cálculo, feature 3 = export a PDF. → Pasos 4-6 → Una feature por vez, probás, iterás. → Paso 8 → Escalás: guardar presupuestos, enviarlos por WhatsApp.
Al final tenés una herramienta real que le podés mostrar (y vender) a un taller.
Para qué te sirve esto si vendés
Este método es lo que te deja entregar a un cliente sin romperte. El detalle: el que improvisa con Claude Code reescribe tres veces y entrega tarde. El que usa sistema entrega una vez, bien, y cobra como profesional.
→ CLAUDE.md + plan = alcance cerrado. Menos retrabajo gratis. → Feature por feature = le podés mostrar avances al cliente sin esperar al final. → Cuando lo construido es un producto (una web, un sistema), lo cobrás. Mirá los rangos en las guías de Nivel 5.
Tu turno
Agarrá una idea simple tuya o de un negocio que conozcas (una barbería, un taller, un kiosco) y aplicá los pasos 1 a 3 ahora mismo. Sin código todavía.
Checklist de autoverificación:
• [ ] Claude Code abre con claude dentro de la carpeta de tu proyecto.
• [ ] Respondiste las preguntas del paso 1 con detalle (no a las apuradas).
• [ ] Existe un archivo CLAUDE.md en la raíz, creado por Claude.
• [ ] Tenés un plan con features chicas y ordenadas, leído de punta a punta.
Si los cuatro están tildados, ya tenés base para construir en serio.
Siguiente paso
Ya sabés el sistema de 8 pasos. Ahora afiná el ritual que hacés antes de cada sesión para que el output salga bien de una.
→ Las 3 cosas que siempre hago antes de trabajar con Claude Code
La mejor comunidad de IA
Esto no termina acá. En la comunidad compartimos lo que funciona de verdad: proyectos reales, precios que cierran y los nudos de llevar esto a clientes que pagan.