¿Qué pasa si abrís Claude Code sin un plan?
Si abrís Claude Code en tu terminal y te ponés a tirar comandos para construir sin un plan previo, ya la cagaste. Es el error más común entre los desarrolladores que recién adoptan agentes de IA: pensar que la herramienta va a adivinar la arquitectura perfecta de tu app sobre la marcha.
Cuando le pedís a Claude que construya de cero sin darle contexto estructurado, empieza a iterar a ciegas. Toca archivos que no debería, elige stacks que no te sirven y, lo peor de todo, gasta una cantidad obscena de tokens en prueba y error. La diferencia entre un proyecto bien hecho y un espagueti de código inmanejable no está en qué modelo uses, sino en qué hacés los 10 minutos antes de empezar a codear.
Por qué importa planificar
Hacer el trabajo previo de arquitectura te garantiza tres cosas fundamentales:
- Ahorro masivo de tokens: No pagás por iteraciones inútiles ni por arrastrar conversaciones larguísimas llenas de ideas descartadas.
- Código coherente: El agente sabe exactamente a dónde va, qué librerías usar y cómo estructurar los componentes desde el minuto cero.
- Menos fricción: Evitás estar corrigiendo a Claude cada dos minutos porque tomó una decisión de diseño que no te gusta.
Los 3 pasos antes de abrir la terminal
Acá tenés el flujo de trabajo exacto para no arruinar tu proyecto desde el inicio. Son tres pasos simples que la mayoría se salta por ansiedad de ver código funcionando.
Paso 1 — Usá la app web como rueditas de práctica
Si apenas estás empezando a integrar inteligencia artificial en tu flujo de desarrollo, no te claves con el hecho de usar la terminal de entrada.
La app web de Claude tiene un diseño excelente y te permite construir bastante bien sin la necesidad de lidiar con permisos de bash, dependencias locales o comandos de CLI. Usar la interfaz gráfica primero es como ponerle rueditas de práctica a la bicicleta. Te da el control total para entender cómo razona el modelo. Cuando ya le agarres la onda y entiendas sus patrones, recién ahí te pasás a la terminal.
Paso 2 — Platicá y armá la estructura con un modelo barato
Antes de ponerte a construir en serio, tenés que "platicar" con Claude.
- Creá un folder nuevo en tu escritorio que se llame
PlaticaroEstructura. - Cambiá el modelo a uno más económico, como Haiku o Sonnet 3.5. No uses Opus para lluvia de ideas; vas a quemar plata sin sentido.
- Usá un prompt de "Arquitecto". Decile exactamente qué querés construir, para quién es, por qué lo hacés y qué funcionalidades core necesita.
- Pedile que actúe como un Tech Lead y te devuelva la estructura de carpetas, el stack tecnológico y el paso a paso.
- Cuando la idea esté sólida, decile: "Exportá este plan a un archivo markdown".
Paso 3 — Abrí una sesión limpia para construir
Ahora sí, es momento de ensuciarse las manos. Pero lo vas a hacer bien.
Abrí un folder completamente nuevo con el nombre definitivo de tu proyecto. Iniciá Claude Code ahí, limpio. Agarrá el plan maestro que exportaste en el paso anterior, dáselo a Claude Code y dejá que se ponga a trabajar siguiendo esa hoja de ruta.
Hacerlo de esta manera te permite empezar sin arrastrar conversaciones larguísimas, llenas de basura y de contexto inútil que solo confunden al modelo y te cuestan dinero.
Comparativa: App Web vs. Terminal (Claude Code)
Saber cuándo usar cada entorno es clave para mantener la cordura y el presupuesto a raya.
| Característica | App Web (Claude.ai) | Terminal (Claude Code) |
|---|---|---|
| Fase ideal | Ideación, planificación, debug aislado | Ejecución, refactors masivos, testing end-to-end |
| Costo de contexto | Bajo (controlás qué pegás) | Alto (lee tu sistema de archivos) |
| Autonomía | Nula (requiere copy-paste manual) | Alta (modifica archivos, corre comandos) |
| Curva de aprendizaje | Muy baja | Media / Alta |
| Riesgo de romper cosas | Inexistente | Moderado (si no configurás límites) |
El secreto no está en el modelo
Al final del día, los proyectos terminan saliendo muy bien por estas prácticas simples de estructuración, no por usar el LLM más caro del mercado. Si le das basura a Opus 4.7, te va a devolver basura muy bien redactada.
Recordá siempre la regla de oro del desarrollo con IA: No es el modelo, es el prompt y el contexto que le armás alrededor. Tomate esos 10 minutos para ser el arquitecto, y dejá que Claude Code sea tu albañil de lujo.
Preguntas frecuentes sobre Claude Code
Claude Code es la herramienta oficial de línea de comandos (CLI) creada por Anthropic que vive directamente en tu terminal y tiene acceso a tu sistema de archivos. A diferencia del chat web tradicional, puede leer tu código, ejecutar comandos bash y modificar archivos de forma autónoma. Precisamente por este nivel de autonomía, es vital planificar antes de usarlo. Si le pedís que construya algo complejo sin una estructura clara, va a empezar a iterar a ciegas, reescribiendo archivos enteros y consumiendo tu cuota de tokens rápidamente. La planificación previa actúa como un mapa de ruta: le dice exactamente qué hacer, qué stack usar y cómo dividir las tareas. Para entender mejor cómo funciona esta herramienta en profundidad, te recomiendo leer el diccionario de Claude Code con 8 conceptos clave. Además, podés complementar tu aprendizaje revisando la documentación oficial de Anthropic sobre cómo gestionar permisos y seguridad en tu entorno local.
La diferencia principal radica en el entorno de ejecución y el nivel de acceso. La app web de Claude (Claude.ai) es una interfaz gráfica excelente para idear, planificar y escribir fragmentos aislados de código. Funciona como "rueditas de práctica" porque te obliga a copiar y pegar el código manualmente, dándote control total sobre qué entra a tu proyecto. Por otro lado, Claude Code opera directamente desde tu terminal. Tiene permisos para explorar tus directorios, leer múltiples archivos a la vez, correr tests y aplicar los cambios sin que tengas que hacer copy-paste. Si bien es mucho más rápido y agéntico, también es más propenso a cometer errores costosos si el prompt inicial es ambiguo. Si querés optimizar tu uso en la terminal, no te pierdas los 6 tips de Boris Cherny para dominar Claude Code. También podés explorar cómo ahorrar tokens con el archivo CLAUDE.md para mantener los costos bajo control.
Para ahorrar tokens durante la fase de planificación, la regla de oro es no usar el modelo más caro (como Opus) para tareas de lluvia de ideas o estructuración básica. Cuando estás peloteando la arquitectura del proyecto, cambiá a modelos más rápidos y económicos como Claude 3.5 Haiku o Sonnet. Estos modelos son excepcionalmente buenos para entender requerimientos, redactar documentos de arquitectura y generar planes paso a paso, pero consumen una fracción de los tokens. Una vez que tenés el plan maestro documentado y exportado, recién ahí abrís una sesión nueva con el modelo más potente para ejecutar el código complejo. Esta separación de fases (planificación barata vs. ejecución potente) es clave para no vaciar tu cuenta. Conocé más sobre las capacidades de cada modelo en la guía de Claude Opus 4.7 o revisá las 5 funciones gratis de Claude en la página oficial de Anthropic.
El prompt del "Arquitecto" es una instrucción preconfigurada diseñada específicamente para forzar a la inteligencia artificial a pensar como un líder técnico (Tech Lead) antes de escribir una sola línea de código. En lugar de escupir funciones al azar, este prompt le exige a Claude que defina el propósito del proyecto, el público objetivo, el stack tecnológico ideal y la estructura de carpetas necesaria. Le explicás qué querés hacer y el Arquitecto te devuelve un plan maestro detallado y profesional. Este documento luego sirve como el "contexto inicial" perfecto cuando pasás a la fase de construcción en la terminal. Usar este tipo de herramientas de estructuración es lo que diferencia a un proyecto caótico de uno escalable. Si querés mejorar la forma en que le das instrucciones a la IA, te sugiero revisar nuestra sección de prompts avanzados para desarrollo y consultar las mejores prácticas de prompting de Anthropic.
Empezar a programar en un folder completamente limpio es fundamental para evitar la contaminación del contexto y el gasto innecesario de tokens. Si usás la misma sesión o carpeta donde estuviste haciendo la lluvia de ideas inicial, Claude Code va a arrastrar todo ese historial de conversación (pruebas, errores, ideas descartadas) en cada nuevo prompt que le des. Esto significa que vas a pagar por miles de tokens de "basura" cada vez que le pidas un cambio. Al crear un directorio nuevo y abrir una sesión limpia de Claude Code pasándole únicamente el plan final exportado, le das un foco láser. El modelo solo procesa lo que realmente importa para la construcción, lo que resulta en respuestas más rápidas, código de mayor calidad y un ahorro drástico en tu facturación mensual. Aprendé a configurar tu entorno base leyendo sobre cómo estructurar tu archivo CLAUDE.md y mantené tus proyectos impecables.
Fuentes e inspiración
Mirá los posts originales donde desarrollamos estas ideas en redes.
