Dominar Claude Code Parte 2: El Modelo Mental

Hay una verdad que separa a los desarrolladores que aman Claude Code de los que lo encuentran frustrante: entender cómo piensa lo cambia todo.

La mayoría de la gente se acerca a Claude Code como a un motor de búsqueda — escribe una pregunta, obtiene una respuesta. Pero Claude Code no es un motor de búsqueda. Es un agente autónomo ejecutándose en un bucle, tomando decisiones, usando herramientas y ajustándose según los resultados. Una vez que entiendas esta arquitectura, sabrás exactamente por qué ciertos prompts funcionan brillantemente mientras otros fracasan.

El Bucle Agéntico: Cómo Funciona Realmente Claude Code

Bajo el capó, Claude Code ejecuta un patrón engañosamente simple:

Pensar → Actuar → Observar → Corregir → Repetir

Esto es lo que parece en la práctica:

1. Pensar — Claude analiza tu petición y decide qué hacer
2. Actuar — Usa una herramienta (leer un archivo, ejecutar un comando, editar código)
3. Observar — Ve el resultado de esa acción
4. Corregir — Ajusta su enfoque según lo que pasó
5. Repetir — El bucle continúa hasta que Claude decide que la tarea está completa

Esto no es una conversación lineal. Es un bucle recursivo que sigue ejecutándose hasta que Claude decide explícitamente que ha terminado. El comportamiento por defecto es continuar hasta resolver, no responder una vez y parar.

Por qué importa: Cuando le pides a Claude que "añada autenticación a esta app," no solo genera código y te lo entrega. Lee tu código existente, entiende tus patrones, escribe la implementación, ejecuta tests para verificar que funciona, arregla cualquier problema que encuentre, y solo entonces te informa. Eso es el bucle en acción.

La Ventana de Contexto: La Memoria de Trabajo de Claude

Claude tiene una "ventana de contexto" — piensa en ella como memoria de trabajo. Todo lo que Claude necesita saber sobre tu conversación, tu codebase y la tarea actual tiene que caber en esta ventana.

Contexto estándar: 200,000 tokens (aproximadamente 500 páginas de texto)

Contexto extendido: Claude Sonnet 4 ahora soporta hasta 1 millón de tokens en la API — suficiente para codebases enteros con más de 75,000 líneas de código. Esto requiere acceso tier 4 de la API y cuesta 2x para tokens de entrada más allá de 200K.

Aquí está la clave: cada mensaje que envías incluye todo el historial de conversación. Así es como Claude "recuerda" lo que discutiste antes. Pero también significa que las conversaciones largas consumen exponencialmente más tokens.

Qué Llena Tu Contexto

El contexto viene de múltiples fuentes, y todas suman:

Tus prompts — Cada mensaje que has enviado en esta sesión

Las respuestas de Claude — Todo lo que Claude ha dicho

Resultados de herramientas — Contenidos de archivos que Claude ha leído, outputs de comandos, resultados de búsqueda

Contexto del sistema — Contenidos de CLAUDE.md, estado de git, estructura del proyecto

Historial de sesión — Todo el ida y vuelta desde tu último /clear

Cuando le pides a Claude que "lea este archivo," todo el contenido del archivo se añade al contexto. Pídele que lea diez archivos y potencialmente has consumido miles de tokens antes de que Claude empiece a trabajar en tu petición real.

Una Nota sobre los Planes de Suscripción

Cuánto necesitas preocuparte por el contexto depende de tu plan:

Planes Max 5x / Max 20x — Tienes límites de tokens amplios. La gestión de contexto sigue siendo buena práctica para la calidad del output, pero no estás vigilando cada token.

Plan Pro / API de pago por uso — Cada llamada a herramienta, cada lectura de archivo, cada respuesta verbosa te cuesta. La gestión agresiva del contexto impacta directamente tu factura.

Las estrategias a continuación importan más para usuarios conscientes del coste, pero incluso en planes ilimitados, un contexto más limpio produce mejores outputs.

Gestionando el Contexto: Los Comandos Que Importan

/clear — El Estándar Recomendado

/clear

Borra todo. Empezar de cero. Contexto cero.

Un cambio de perspectiva: /clear debería ser tu opción por defecto, no tu último recurso. Los usuarios experimentados de Claude Code limpian agresivamente — no porque algo salió mal, sino como práctica estándar entre tareas.

Cuándo usarlo:

• Empezando una nueva funcionalidad (siempre)
• Entre tareas no relacionadas (terminaste auth, ahora trabajas en UI)
• Cuando menos del 50% de tu contexto actual es relevante
• Cuando Claude parece confundido o atrapado en bucles
• Después de completar una funcionalidad
• Cuando notas respuestas repetitivas o fuera de rumbo

El patrón /clear + /catchup:

Algunos desarrolladores crean un comando personalizado /catchup que hace que Claude lea todos los archivos modificados en su rama de git. Después de /clear, ejecuta /catchup para restablecer el contexto relevante sin la basura. (Consulta la implementación completa en la Parte 4)

/clear
/catchup
"Continúa implementando el flujo de pagos"

Esto te da contexto fresco con exactamente lo que es relevante.

/compact — Usar con Precaución

Actualización enero 2026: Desde la v2.0.64, /compact ahora es instantáneo — no más esperas. También prueba /context para verificar si los servidores MCP están comiendo espacio antes de compactar.

/compact

En vez de borrar todo, /compact crea un resumen inteligente de tu conversación y empieza de cero con ese resumen como contexto.

La verdad honesta: Muchos usuarios experimentados evitan /compact cuando es posible. La sumarización automática es opaca — no sabes exactamente qué se preserva o se pierde.

Cuándo /compact tiene sentido:

• Estás a mitad de tarea y necesitas preservar decisiones específicas
• Tienes contexto complejo que sería doloroso reconstruir
• Quieres continuar pero el contexto está al 70%+

Cuándo preferir /clear:

• Empezando algo nuevo
• Menos de la mitad de tu contexto es relevante
• Puedes restablecer fácilmente lo que importa

Si usas /compact, guíalo:

/compact Enfócate en preservar nuestra implementación de autenticación
y las decisiones de esquema de base de datos que tomamos

Esto le dice a Claude qué es lo más importante en el resumen.

La Estrategia "Documentar y Limpiar"

Para tareas complejas de múltiples sesiones, hay un patrón mejor que confiar en la compactación:

1. Documentar: Haz que Claude vuelque su plan y progreso en un archivo markdown
2. Limpiar: /clear la sesión completamente
3. Continuar: Empieza de cero diciéndole a Claude que lea el markdown y continúe

"Guarda nuestro progreso actual y los TODOs pendientes en docs/auth-migration-plan.md"
/clear
"Lee docs/auth-migration-plan.md y continúa desde donde lo dejamos"

Esto crea memoria externa duradera que sobrevive a las sesiones perfectamente — sin sumarización con pérdidas.

Actualización enero 2026: Este patrón ahora está integrado en el Modo Plan. Cuando aceptas un plan, Claude automáticamente limpia el contexto y carga el plan en una ventana limpia. Esto mejora significativamente la adherencia al plan. Puedes optar por no hacerlo si prefieres mantener el contexto.

Auto-Compact: La Red de Seguridad en la Que No Deberías Depender

Actualización enero 2026: Auto-compact ahora se activa al 75% de capacidad (no 92-95%), dejando ~50k tokens libres para razonamiento. Esto es una mejora significativa.

Claude Code compacta automáticamente cuando tu contexto alcanza capacidad. Esto previene quedarse sin espacio a mitad de tarea.

Pero no dependas demasiado de ello. La compactación automática sigue siendo comportamiento de emergencia, no una estrategia. Para cuando se activa, puede que ya hayas experimentado degradación en la calidad del output.

Mejor enfoque: limpia proactivamente en puntos de quiebre naturales en vez de dejar que el contexto se infle hasta que el sistema intervenga.

Pensamiento Extendido: Cuando Claude Necesita Pensar Más

Claude Code soporta activadores de modo de pensamiento que asignan más presupuesto de razonamiento:

"think" — ~4,000 tokens de presupuesto de pensamiento

"think hard" — ~10,000 tokens de presupuesto de pensamiento

"ultrathink" — ~31,999 tokens de presupuesto de pensamiento (máximo)

Solo incluye estas palabras en tu prompt:

"ultrathink sobre cómo arquitecturar este sistema de pagos"
"think hard sobre los casos límite en esta lógica de validación"

Cuándo usarlos:

• Decisiones de arquitectura → ultrathink + modo plan
• Atrapado en bucles → ultrathink para romper el bloqueo
• Depuración compleja → think hard
• Tareas rutinarias → no se necesita palabra clave

Nota: Estas palabras clave solo funcionan en la interfaz de terminal de Claude Code, no en el chat web o la API. Para una inmersión más profunda en todas las palabras activadoras y últimas actualizaciones, consulta Parte 9: Secretos de Usuario Avanzado.

Modo Plan: Pensar Antes de Actuar

Aquí es donde la mayoría se equivoca: le piden a Claude que haga cosas sin primero pedirle que las planifique.

El modo plan es un estado de solo lectura donde Claude investiga, analiza y propone enfoques sin tocar ningún archivo. Es invaluable para tareas complejas.

Cómo Entrar en Modo Plan

Pulsa Shift+Tab para ciclar entre modos:

1. Primera pulsación: Modo auto-aceptar (Claude no pide permiso para cada acción)
2. Segunda pulsación: Modo plan (Claude solo puede leer, no escribir)
3. Tercera pulsación: Vuelta al modo normal de edición

Mira el prompt en la parte inferior de tu terminal para ver en qué modo estás.

Qué Puede Hacer Claude en Modo Plan

El modo plan restringe a Claude a herramientas de investigación solamente:

• Read — Ver archivos y contenido
• LS/Glob — Listar directorios y buscar patrones de archivos
• Grep — Buscar contenido entre archivos
• WebSearch/WebFetch — Investigar online
• Task — Crear sub-agentes de investigación
• TodoRead/TodoWrite — Gestionar listas de tareas

Lo que no puede hacer: Editar archivos, ejecutar comandos, hacer cualquier cambio.

Cuándo Usar Modo Plan

Explorando código desconocido:

[Entrar en modo plan con Shift+Tab dos veces]
"Explica cómo funciona la autenticación en este codebase.
¿Qué archivos manejan las sesiones? ¿Dónde se validan los tokens?"

Claude escarba en tu código y lo explica sin riesgo de romper nada.

Planificando una refactorización:

"Quiero migrar de REST a GraphQL.
¿Qué necesitaría cambiar? ¿Cuál es el orden de operaciones?"

Claude analiza dependencias y propone un camino de migración.

Entendiendo la arquitectura:

"¿Cómo abordarías añadir notificaciones en tiempo real a esta app?
¿Cuáles son las compensaciones entre WebSockets y SSE aquí?"

Claude considera tu código existente y propone opciones.

La clave: planificar es barato, deshacer es caro. Cinco minutos en modo plan a menudo ahorra horas de revertir implementaciones malas.

La Analogía del Desarrollador Junior (Refinada)

En la Parte 1, introdujimos el modelo mental del "junior entusiasta." Refinémoslo ahora que entiendes la arquitectura:

Claude Code es como un desarrollador junior altamente cualificado que:

Necesita instrucciones claras — Las peticiones vagas producen resultados vagos porque el bucle agéntico no tiene una condición de parada clara

Se beneficia del contexto — Más información relevante significa mejor selección de herramientas y menos iteraciones desperdiciadas

Trabaja mejor con tareas específicas — "Añade manejo de errores a la función de login" da un estado de completitud claro; "mejora el código" no

Aprende de los patrones de tu proyecto — Claude observa convenciones en los archivos que lee y las aplica a los archivos que escribe

Pregunta antes de hacer cambios grandes — El sistema de permisos existe porque el bucle de otro modo se ejecutaría indefinidamente

Puede quedarse atrapado en bucles — Si una tarea no está bien definida, Claude podría repetir acciones similares sin progreso

Patrones Efectivos de Prompting

Ahora que entiendes el bucle, aquí está cómo escribir prompts que trabajen con él:

Sé Específico sobre la Completitud

El bucle necesita saber cuándo parar.

❌ "Arregla los bugs"
   (¿Qué bugs? ¿Cómo sabrá Claude que terminó?)

✅ "Arregla la excepción de puntero nulo en src/auth.ts línea 42
   donde se accede a user.email antes de la verificación de nulidad"
   (Ubicación específica, problema específico, completitud clara)

Proporciona Contexto por Adelantado

Cada llamada a herramienta consume tokens y tiempo. Ayuda a Claude a encontrar lo que necesita más rápido.

❌ "Añade una página de login"
   (Claude tiene que explorar todo tu codebase para entender patrones)

✅ "Añade una página de login usando el mismo estilo que src/pages/signup.tsx
   y nuestro servicio de auth en src/services/auth.ts"
   (Claude sabe exactamente dónde mirar)

Nota: En los planes Max 5x/20x con límites generosos de tokens, puedes permitirte dejar que Claude explore más libremente. Pero incluso así, las referencias específicas producen resultados más rápidos y consistentes.

Divide las Tareas Grandes

Un bucle largo es peor que múltiples bucles cortos.

❌ "Construye un dashboard de usuario completo con ajustes,
    notificaciones y gestión de perfil"
   (Alcance masivo, orden poco claro, fácil perderse)

✅ Paso 1: "Crea el componente de layout del dashboard"
   Paso 2: "Añade el panel de ajustes"
   Paso 3: "Implementa notificaciones"
   Paso 4: "Construye la gestión de perfil"
   (Puntos de completitud claros, más fácil corregir el rumbo)

Referencia Archivos por Ruta

No hagas que Claude busque patrones que podría encontrar directamente.

❌ "Usa el mismo patrón que los otros componentes"
   (Claude tiene que leer cada componente para encontrar el patrón)

✅ "Sigue el patrón en src/components/Button.tsx"
   (Una lectura de archivo, consumo mínimo de contexto)

Cuando Claude Se Atasca

Señales de que el bucle agéntico está girando sin progreso:

• Respuestas repetitivas (las mismas sugerencias una y otra vez)
• Lógica circular (intentando el mismo arreglo repetidamente)
• Haciendo preguntas que ya hizo
• Produciendo código incorrecto similar en ciclos

Soluciones, en orden:

1. /clear y empezar de cero — Lo más efectivo. Un contexto limpio a menudo desbloquea inmediatamente.

2. Usa ultrathink — "ultrathink sobre este problema" asigna el presupuesto máximo de razonamiento y a menudo rompe el bloqueo donde los prompts normales fallan.

3. Proporciona contexto más específico — El bucle podría estar buscando ampliamente porque no sabe dónde mirar.

4. Divide la tarea más — La condición de completitud podría ser demasiado vaga.

5. Prueba un enfoque diferente — "En vez de arreglar esta función, reescribámosla desde cero."

6. Cambia a Opus — Si estás en Sonnet (predeterminado del plan Pro), cambiar a Opus vía /model puede ayudar con razonamiento genuinamente complejo. Los usuarios del plan Max ya tienen Opus por defecto.

El Bucle de Retroalimentación

El uso efectivo de Claude Code es iterativo. No esperes perfección al primer intento.

Tú: Petición inicial
Claude: Primer intento
Tú: "Buen comienzo, pero el manejo de errores no cubre fallos de red"
Claude: Intento refinado
Tú: "Mejor. ¿Puedes también añadir logging?"
Claude: Versión final
Tú: Aceptar

Esto no es Claude fallando — es el bucle agéntico funcionando como fue diseñado. Cada iteración añade información que guía el siguiente ciclo.

Calibración de Confianza a lo Largo del Tiempo

Tu relación con Claude Code debería evolucionar:

Semana 1: Revisa cada cambio cuidadosamente. Entiende lo que Claude hace y por qué.

Semana 2: Permite modo auto-aceptar para operaciones seguras (lectura, archivos de test, documentación).

Mes 1: Confía en tareas rutinarias. Verifica refactorizaciones complejas y cualquier cosa que toque rutas críticas.

Continuo: Siempre verifica código crítico de seguridad, operaciones de base de datos y cualquier cosa con efectos externos.

El objetivo no es confianza ciega — es confianza informada. Estás entrenando tu intuición para saber cuándo Claude necesita supervisión.

Anti-Patrones a Evitar

Pegar archivos enteros en tu prompt — Deja que Claude los lea él mismo. "Lee src/auth.ts y explica la gestión de sesiones" es mejor que pegar 500 líneas.

Ignorar las preguntas de Claude — Cuando Claude pide aclaraciones, es porque el bucle no tiene suficiente información para proceder con confianza. Responde completamente.

Apresurar los prompts de permisos — Lee lo que estás aprobando. "Permitir siempre" es conveniente pero elimina una verificación de seguridad.

Mantener contexto obsoleto — /clear no cuesta nada. El contexto obsoleto cuesta tokens y precisión.

Usar Claude para tareas triviales — A veces escribir git status es más rápido que explicar lo que quieres ver.

Qué Viene Después

Ahora entiendes cómo piensa Claude Code. En Parte 3: Configuración del Proyecto, profundizaremos en CLAUDE.md — el archivo que moldea el comportamiento de Claude para tu proyecto específico. Un CLAUDE.md bien elaborado es la diferencia entre un Claude que entiende tu codebase y uno que lucha contra tus patrones.