Saltar al contenido
Lección 11 de 14

Flujos de Trabajo Avanzados

9 min read

Más Allá de la Interacción Básica

Ya conoces las funcionalidades individuales de Claude Code: skills, hooks, servidores MCP, subagentes, plugins y checkpoints. Esta lección se enfoca en los flujos de trabajo avanzados que emergen cuando combinas esas funcionalidades con las opciones de configuración más profundas de Claude Code. Estos flujos de trabajo son lo que separa a los usuarios casuales de los usuarios avanzados que dependen de Claude Code como su herramienta de desarrollo principal.

Modo Planificación

Cuando enfrentas una funcionalidad compleja que toca múltiples archivos, módulos o servicios, saltar directamente al código es arriesgado. El modo planificación permite que Claude explore tu codebase, diseñe un enfoque y obtenga tu aprobación antes de escribir una sola línea de código.

Activa el modo planificación con:

/plan

O úsalo directamente con un prompt:

/plan Agrega un sistema de rate limiting a la API. Debe soportar limites por endpoint,
      usar Redis para estado distribuido e incluir un mecanismo de bypass para tokens admin.

En modo planificación, Claude opera en una fase de exploración de solo lectura. Lee archivos, busca patrones, mapea dependencias y construye un modelo mental de las partes relevantes de tu codebase. Luego presenta un plan estructurado:

Plan: Agregar Sistema de Rate Limiting

1. Crear middleware en src/middleware/rate-limiter.ts
   - Aceptar configuracion por ruta (window, maxRequests)
   - Usar Redis para conteo distribuido
   - Verificar header X-Admin-Token para bypass

2. Agregar cliente Redis en src/lib/redis.ts
   - Pool de conexiones con ioredis
   - Fallback elegante si Redis no esta disponible

3. Actualizar src/routes/index.ts
   - Aplicar rate limiter a todas las rutas /api/*
   - Configurar limites por endpoint en config de rutas

4. Agregar tests en tests/middleware/rate-limiter.test.ts
   - Test de respuesta de rate excedido (429)
   - Test de bypass admin
   - Test de fallback por fallo de Redis

Archivos estimados: 4 nuevos, 1 modificado

Tú revisas el plan, sugieres cambios o lo apruebas. Solo después de la aprobación Claude comienza a escribir código. Esto previene el esfuerzo desperdiciado de construir algo que no coincide con tu intención arquitectónica.

Prueba esto: usa /plan para tu próxima funcionalidad multi-archivo. Nota cómo el plan captura decisiones arquitectónicas que habrías pasado por alto si hubieras ido directo a codificar.

Modos de Permisos a Fondo

Claude Code ofrece seis modos de permisos que controlan cuánta autonomía tiene Claude. Elegir el modo correcto para cada situación es una habilidad clave.

default

Claude pide permiso para todo -- lecturas de archivos, escrituras y ejecución de comandos. Este es el modo de aprendizaje. Úsalo cuando eres nuevo en Claude Code o trabajas en un codebase desconocido.

acceptEdits

Claude aprueba automáticamente las ediciones de archivos pero aún pregunta antes de ejecutar comandos de shell. Este es el modo de desarrollo diario para la mayoría de los practicantes. Confías en que Claude escriba código pero quieres revisar cualquier comando que ejecute.

claude --permission-mode acceptEdits

plan

Modo de solo lectura. Claude puede explorar el codebase y crear planes pero no puede modificar ningún archivo ni ejecutar comandos. Perfecto para revisiones de arquitectura y auditorías de codebase.

claude --permission-mode plan

auto

Autonomía completa con un clasificador de seguridad en segundo plano. Claude toma sus propias decisiones sobre lecturas, escrituras y comandos, pero un sistema de seguridad bloquea operaciones potencialmente peligrosas (como rm -rf / o force-push a main). Este es el modo para tareas de confianza donde quieres que Claude trabaje de forma independiente.

claude --permission-mode auto

dontAsk

Acepta todo sin preguntar. Similar a auto pero sin el clasificador de seguridad. Usa esto solo para tareas en entornos sandboxeados donde no hay riesgo de daño.

bypassPermissions

Sin restricciones de ningún tipo. Solo usa esto en entornos completamente aislados y desechables como contenedores temporales o runners de CI donde nada valioso pueda verse afectado.

La progresión para la mayoría de los desarrolladores es: comenzar con default, pasar a acceptEdits después de unos días, usar plan para trabajo de arquitectura y usar auto para tareas bien definidas en entornos de confianza.

Pensamiento Extendido

Para problemas complejos -- bugs intrincados, decisiones arquitectónicas, optimización de rendimiento -- puedes habilitar el pensamiento extendido, que le da a Claude más tiempo y presupuesto de tokens para razonar antes de responder:

Alt+T (Windows/Linux)
Option+T (macOS)

Esto alterna el pensamiento extendido durante tu sesión. Cuando está habilitado, Claude usa un proceso de cadena de pensamiento que produce un razonamiento más largo y exhaustivo. El compromiso es que las respuestas tardan más y consumen más tokens.

Usa pensamiento extendido cuando:

  • Depures una condición de carrera sutil o un problema de concurrencia
  • Diseñes un modelo de datos complejo con muchas relaciones
  • Revises código crítico de seguridad donde perder una vulnerabilidad importa
  • Optimices una ruta crítica donde necesitas considerar múltiples enfoques

No uses pensamiento extendido para tareas rutinarias como formatear código, escribir funciones simples o generar boilerplate. El tiempo extra de razonamiento no agrega valor para trabajo directo.

Niveles de Esfuerzo

Complementario al pensamiento extendido, el comando /effort controla qué tan profundamente se involucra Claude con cada solicitud:

/effort low      # Respuestas rapidas y concisas — bueno para preguntas simples
/effort medium   # Profundidad balanceada (por defecto)
/effort high     # Analisis e implementacion exhaustivos
/effort max      # Profundidad maxima — explora cada caso borde
/effort auto     # Claude decide basandose en la complejidad de cada solicitud

Usa /effort low cuando hagas preguntas rápidas o necesites respuestas cortas. Usa /effort high cuando enfrentes un bug complejo o diseñes un sistema crítico. La configuración auto permite que Claude calibre su propio esfuerzo basándose en la complejidad aparente de tu solicitud.

Prueba esto: configura /effort low y haz una pregunta simple, luego configura /effort high y pregunta sobre un bug complejo. Compara la profundidad y detalle de cada respuesta.

Gestión de Contexto

La ventana de contexto de Claude Code es finita. A medida que tu sesión crece, el contexto más antiguo se desplaza. La gestión activa del contexto mantiene tu sesión productiva durante períodos largos.

Compacta tu contexto cuando la ventana comience a llenarse:

/compact

Esto resume la conversación hasta el momento en una forma condensada, liberando espacio de contexto mientras retiene las decisiones clave, el estado del código y el progreso de la tarea. Piensa en ello como comprimir la memoria de tu sesión.

También puedes proporcionar una pista de enfoque:

/compact Enfócate en el refactor de autenticacion — descarta detalles sobre los cambios de UI.

Visualiza el uso de contexto para entender qué está consumiendo tu ventana:

/context

Esto muestra un desglose de qué está usando tu contexto: historial de conversación, contenidos de archivos, salidas de herramientas y system prompts. Si ves que una lectura de archivo grande está dominando, sabes que debes compactar o enfocar tus consultas.

Canales: Flujos de Trabajo Multi-Sesión

Para proyectos grandes que abarcan múltiples líneas de trabajo, los canales proporcionan flujos de trabajo multi-sesión estructurados:

/channel create auth-refactor
/channel create api-v2
/channel switch auth-refactor

Cada canal mantiene su propio historial de conversación y contexto. Puedes cambiar entre canales para trabajar en diferentes aspectos de un proyecto sin contaminar el contexto de trabajo no relacionado.

Los canales son especialmente útiles para:

  • Trabajar en múltiples funcionalidades simultáneamente
  • Mantener sesiones de corrección de bugs separadas del desarrollo de funcionalidades
  • Mantener una discusión de arquitectura a largo plazo junto con la codificación diaria

Dictado por Voz

Para sesiones de brainstorming, revisiones de código o cuando quieras pensar en voz alta, Claude Code soporta entrada por voz:

Activa el dictado por voz para hablar tus prompts en lugar de escribirlos. Esto es particularmente útil para:

  • Brainstorming de ideas arquitectónicas mientras estás lejos del teclado
  • Describir bugs que estás viendo en una aplicación en ejecución
  • Revisar código con las manos libres mientras lees en un segundo monitor

Combinando Funcionalidades Avanzadas

El verdadero poder viene de combinar estos flujos de trabajo. Aquí tienes un patrón para abordar una funcionalidad importante:

1. /plan — Disenar la funcionalidad (exploracion de solo lectura)
2. Revisar y refinar el plan
3. /effort high — Establecer esfuerzo alto para implementacion
4. --permission-mode acceptEdits — Confiar en ediciones, revisar comandos
5. Implementar modulo por modulo, usando /compact entre secciones mayores
6. /effort low — Cambiar a esfuerzo bajo para ejecuciones rapidas de tests
7. Si te atascas en un bug → Alt+T para pensamiento extendido
8. /checkpoint para guardar estado antes de un paso de integracion arriesgado
9. Revision final con /diff

Otro patrón para depuración compleja:

1. --permission-mode plan — Comenzar en solo lectura para entender el problema
2. Alt+T — Habilitar pensamiento extendido para analisis mas profundo
3. /effort max — Profundidad analitica maxima
4. Una vez identificada la causa raiz → cambiar a modo acceptEdits
5. /effort medium — Esfuerzo estandar para la correccion
6. Implementar correccion, ejecutar tests, verificar

Consejos para Usuarios Avanzados

Ajusta el modo de permisos a la tarea. No te quedes en modo default para siempre. Una vez que confíes en las ediciones de Claude, muévete a acceptEdits. Para tareas autónomas, usa auto. El modo correcto reduce la fricción sin sacrificar seguridad.

Usa /plan para cualquier cosa que toque más de tres archivos. La inversión inicial en planificación te ahorra retrabajo. Los planes también sirven como documentación de tus decisiones arquitectónicas.

Compacta proactivamente. No esperes hasta que llegues a los límites de contexto. Después de completar una subtarea importante, ejecuta /compact para liberar espacio para la siguiente fase.

Establece el nivel de esfuerzo intencionalmente. La mayoría de los desarrolladores lo dejan en medium para siempre. Ajustar el esfuerzo por tarea te da respuestas más rápidas para trabajo simple y análisis más profundo cuando lo necesitas.

Combina pensamiento extendido con preguntas específicas. "¿Por qué este test es flaky?" con pensamiento extendido produce mejores resultados que un vago "ayúdame a depurar esto."

Estos flujos de trabajo avanzados transforman Claude Code de una herramienta de generación de código a un compañero de desarrollo completo que se adapta a la complejidad y requisitos de cada tarea.