¿Qué pasa cuando codeás sin un plan?
Abrir Claude Code en la terminal y pedirle que construya una aplicación desde cero sin un plan estructurado es la receta perfecta para quemar tokens y frustrarte. Terminás con código espagueti, un agente confundido y una factura alta a fin de mes.
El problema casi nunca es la capacidad del modelo, sino la falta de dirección. Antes de escribir la primera línea de código o ejecutar el primer comando bash, hay un trabajo de arquitectura que no te podés saltear si querés que el proyecto salga bien.
Por qué importa planificar antes de codear
- Ahorrás tokens (y plata): Evitás forzar a Claude a reescribir archivos enteros por errores de diseño temprano.
- Mantenés el contexto limpio: Prevenís que la memoria del modelo se llene de conversaciones de debugging inútiles.
- Mejorás la precisión: Lográs que el agente actúe como un ejecutor exacto en lugar de un desarrollador junior adivinando qué querés lograr.
Paso 1 — Empezá con las "rueditas" en la app web
Si recién arrancás a integrar IA en tu flujo de trabajo, no te claves de una con la terminal. Usar la interfaz web de Claude es como ponerle rueditas de práctica a la bicicleta.
El nuevo diseño de la aplicación web maduró muchísimo y te permite construir, iterar y previsualizar bastante bien sin los riesgos de romper tu entorno local o marearte con comandos de consola. Quedate en la app hasta que le agarres la onda a cómo razona el modelo; la terminal puede esperar.
Paso 2 — Planificá con modelos más baratos y el Arquitecto
La etapa de ideación requiere mucho ida y vuelta. Si usás el modelo más caro para esto, estás tirando plata.
Abrí un chat nuevo (o un folder temporal en tu máquina solo para "charlar") y cambiá el modelo a uno más rápido y económico, como Claude 3.5 Haiku o Sonnet. Acá es donde entra en juego el rol del Arquitecto:
- Explicále a Claude qué querés construir, para quién es y por qué.
- Pedile que actúe como un líder técnico y te ayude a definir el stack y la estructura.
- Iterá la idea hasta que esté sólida.
- Cuando todo cierre, pedile explícitamente: "Exportá un plan de desarrollo profesional paso a paso".
Ese documento es tu hoja de ruta.
Paso 3 — Arrancá limpio en un folder nuevo
Ahora sí, es momento de construir en serio. Creá un folder completamente nuevo y vacío en tu computadora con el nombre de tu proyecto definitivo. Abrí Claude Code ahí adentro.
Pasale el plan que exportaste en el paso anterior y dejá que se ponga a trabajar. Al empezar en un entorno virgen, el agente no arrastra el peso de la conversación de lluvia de ideas, no lee archivos basura y no se confunde con contexto obsoleto. Tiene un lienzo en blanco y un manual de instrucciones perfecto.
Codear a ciegas vs. Planificar primero
| Métrica | Sin plan en Claude Code | Con plan estructurado |
|---|---|---|
| Consumo de tokens | Alto (reescribe archivos por prueba y error) | Bajo (ejecuta cambios quirúrgicos) |
| Ventana de contexto | Se satura rápido con lluvia de ideas | Se mantiene limpia y enfocada |
| Calidad del código | Propenso a código espagueti y refactors | Arquitectura coherente desde el día 1 |
| Tiempo de desarrollo | Lento (mucho debugging interactivo) | Rápido (el agente sigue la hoja de ruta) |
El takeaway
- La app web es para idear y aprender; la terminal es para ejecutar.
- Los tokens de los modelos top son caros; usá Haiku o Sonnet para pelotear ideas y definir la estructura.
- Un folder limpio equivale a un agente enfocado.
Al final del día, cuando un proyecto falla usando inteligencia artificial, casi nunca es culpa del modelo. Es el prompt y la falta de estructura inicial.
Preguntas frecuentes sobre Claude Code
Claude Code es la herramienta de interfaz de línea de comandos (CLI) oficial de Anthropic que te permite interactuar con los modelos de Claude directamente desde tu terminal. Funciona como un agente autónomo capaz de leer tu código, ejecutar comandos y modificar archivos por su cuenta. Sin embargo, su mayor fortaleza es también su mayor riesgo: si le das instrucciones vagas sin un plan estructurado, Claude Code va a empezar a iterar a ciegas, reescribiendo archivos innecesariamente y consumiendo tu cuota de tokens a una velocidad alarmante. Por eso, antes de ejecutar el primer comando, es fundamental definir la arquitectura del proyecto y los pasos a seguir. Para entender mejor cómo opera esta herramienta y cuáles son sus comandos principales, te recomendamos leer el diccionario de Claude Code con 8 conceptos clave, lo que te va a dar una base sólida antes de empezar a codear.
La etapa de planificación requiere mucha interacción, lluvia de ideas y ajustes constantes, lo que significa que vas a consumir una gran cantidad de tokens de entrada y salida. Si usás el modelo más potente y caro (como Opus) para esta fase de "peloteo", vas a gastar una fortuna en tareas que no requieren un razonamiento lógico profundo. Modelos más rápidos y económicos como Claude 3.5 Haiku o Sonnet son perfectos para estructurar ideas, definir requerimientos y redactar el documento del plan inicial. Una vez que tenés el plan maestro exportado, recién ahí pasás al modelo más capaz dentro de la terminal para que ejecute el código complejo sin equivocarse. Si querés aprender más sobre cómo optimizar el uso de los distintos modelos y no quemar tu presupuesto, revisá nuestra guía sobre cómo ahorrar tokens en Claude Code con el archivo CLAUDE.md.
El Arquitecto es un prompt o rol específico diseñado para que Claude actúe como un líder técnico experto en diseño de sistemas, en lugar de un simple generador de código. Cuando le asignás este rol, Claude deja de intentar escribir funciones sueltas y se enfoca en hacerte las preguntas correctas: para quién es la aplicación, qué problema resuelve, qué stack tecnológico conviene usar y cómo se van a conectar los componentes. El resultado final de esta interacción no es código, sino un documento maestro (un plan paso a paso) que detalla la estructura exacta del proyecto. Este archivo se convierte en la hoja de ruta que luego le vas a pasar a Claude Code en la terminal para que ejecute la construcción. Podés complementar esta estrategia implementando los 6 tips de Boris Cherny para dominar Claude Opus 4.7, asegurando que la ejecución sea impecable.
Arrancar un proyecto en un directorio nuevo y limpio es una de las prácticas más subestimadas al trabajar con agentes de inteligencia artificial en la terminal. Cuando ejecutás Claude Code, la herramienta lee el contexto del directorio actual para entender en qué estás trabajando. Si usás una carpeta donde ya tenés otros experimentos, archivos viejos o conversaciones previas largas, Claude va a procesar toda esa "basura" en su ventana de contexto. Esto no solo te cuesta dinero en tokens desperdiciados, sino que también confunde al modelo, haciéndolo propenso a alucinaciones o a tomar decisiones basadas en código obsoleto. Al crear un folder virgen y pasarle únicamente el plan estructurado, le das a Claude un lienzo en blanco con instrucciones precisas. Para ver ejemplos de cómo las herramientas oficiales manejan el contexto, revisá la documentación de Anthropic sobre Claude Code.
Para los desarrolladores que recién empiezan a integrar inteligencia artificial en su flujo de trabajo, saltar directamente a la terminal puede resultar abrumador. La aplicación web de Claude actúa como las "rueditas de práctica" de una bicicleta: te ofrece una interfaz gráfica amigable, un control visual claro sobre los archivos que estás modificando y un entorno seguro donde los errores no rompen tu entorno local. El nuevo diseño de la plataforma web es lo suficientemente robusto como para construir prototipos funcionales y estructurar proyectos enteros sin tocar la línea de comandos. Una vez que te sentís cómodo con la forma en que Claude razona y estructura el código, la transición a la terminal es mucho más natural y menos propensa a errores destructivos. Podés explorar más sobre las capacidades de la interfaz gráfica leyendo sobre las 5 funciones gratis de Claude que casi nadie usa.
Fuentes e inspiración
Mirá los posts originales donde desarrollamos estas ideas en redes.
