Saltar al contenido
Lección 11 de 14

Flujos de Trabajo Avanzados

9 min read

Mas Alla de la Interaccion Basica

Ya conoces las funcionalidades individuales de Claude Code: skills, hooks, servidores MCP, subagentes, plugins y checkpoints. Esta leccion se enfoca en los flujos de trabajo avanzados que emergen cuando combinas esas funcionalidades con las opciones de configuracion mas 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 Planificacion

Cuando enfrentas una funcionalidad compleja que toca multiples archivos, modulos o servicios, saltar directamente al codigo es arriesgado. El modo planificacion permite que Claude explore tu codebase, disene un enfoque y obtenga tu aprobacion antes de escribir una sola linea de codigo.

Activa el modo planificacion con:

/plan

O usalo 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 planificacion, Claude opera en una fase de exploracion 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

Tu revisas el plan, sugieres cambios o lo apruebas. Solo despues de la aprobacion Claude comienza a escribir codigo. Esto previene el esfuerzo desperdiciado de construir algo que no coincide con tu intencion arquitectonica.

Prueba esto: usa /plan para tu proxima funcionalidad multi-archivo. Nota como el plan captura decisiones arquitectonicas que habrias pasado por alto si hubieras ido directo a codificar.

Modos de Permisos a Fondo

Claude Code ofrece seis modos de permisos que controlan cuanta autonomia tiene Claude. Elegir el modo correcto para cada situacion es una habilidad clave.

default

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

acceptEdits

Claude aprueba automaticamente las ediciones de archivos pero aun pregunta antes de ejecutar comandos de shell. Este es el modo de desarrollo diario para la mayoria de los practicantes. Confias en que Claude escriba codigo 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 ningun archivo ni ejecutar comandos. Perfecto para revisiones de arquitectura y auditorias de codebase.

claude --permission-mode plan

auto

Autonomia 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 dano.

bypassPermissions

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

La progresion para la mayoria de los desarrolladores es: comenzar con default, pasar a acceptEdits despues de unos dias, 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 arquitectonicas, optimizacion de rendimiento -- puedes habilitar el pensamiento extendido, que le da a Claude mas tiempo y presupuesto de tokens para razonar antes de responder:

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

Esto alterna el pensamiento extendido durante tu sesion. Cuando esta habilitado, Claude usa un proceso de cadena de pensamiento que produce un razonamiento mas largo y exhaustivo. El compromiso es que las respuestas tardan mas y consumen mas tokens.

Usa pensamiento extendido cuando:

  • Depures una condicion de carrera sutil o un problema de concurrencia
  • Disenes un modelo de datos complejo con muchas relaciones
  • Revises codigo critico de seguridad donde perder una vulnerabilidad importa
  • Optimices una ruta critica donde necesitas considerar multiples enfoques

No uses pensamiento extendido para tareas rutinarias como formatear codigo, 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 que 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 rapidas o necesites respuestas cortas. Usa /effort high cuando enfrentes un bug complejo o disenes un sistema critico. La configuracion auto permite que Claude calibre su propio esfuerzo basandose 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.

Gestion de Contexto

La ventana de contexto de Claude Code es finita. A medida que tu sesion crece, el contexto mas antiguo se desplaza. La gestion activa del contexto mantiene tu sesion productiva durante periodos largos.

Compacta tu contexto cuando la ventana comience a llenarse:

/compact

Esto resume la conversacion hasta el momento en una forma condensada, liberando espacio de contexto mientras retiene las decisiones clave, el estado del codigo y el progreso de la tarea. Piensa en ello como comprimir la memoria de tu sesion.

Tambien puedes proporcionar una pista de enfoque:

/compact Enfocate en el refactor de autenticacion — descarta detalles sobre los cambios de UI.

Visualiza el uso de contexto para entender que esta consumiendo tu ventana:

/context

Esto muestra un desglose de que esta usando tu contexto: historial de conversacion, contenidos de archivos, salidas de herramientas y system prompts. Si ves que una lectura de archivo grande esta dominando, sabes que debes compactar o enfocar tus consultas.

Canales: Flujos de Trabajo Multi-Sesion

Para proyectos grandes que abarcan multiples lineas de trabajo, los canales proporcionan flujos de trabajo multi-sesion estructurados:

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

Cada canal mantiene su propio historial de conversacion 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 utiles para:

  • Trabajar en multiples funcionalidades simultaneamente
  • Mantener sesiones de correccion de bugs separadas del desarrollo de funcionalidades
  • Mantener una discusion de arquitectura a largo plazo junto con la codificacion diaria

Dictado por Voz

Para sesiones de brainstorming, revisiones de codigo 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 util para:

  • Brainstorming de ideas arquitectonicas mientras estas lejos del teclado
  • Describir bugs que estas viendo en una aplicacion en ejecucion
  • Revisar codigo con las manos libres mientras lees en un segundo monitor

Combinando Funcionalidades Avanzadas

El verdadero poder viene de combinar estos flujos de trabajo. Aqui tienes un patron 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 patron para depuracion 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 confies en las ediciones de Claude, muevete a acceptEdits. Para tareas autonomas, usa auto. El modo correcto reduce la friccion sin sacrificar seguridad.

Usa /plan para cualquier cosa que toque mas de tres archivos. La inversion inicial en planificacion te ahorra retrabajo. Los planes tambien sirven como documentacion de tus decisiones arquitectonicas.

Compacta proactivamente. No esperes hasta que llegues a los limites de contexto. Despues de completar una subtarea importante, ejecuta /compact para liberar espacio para la siguiente fase.

Establece el nivel de esfuerzo intencionalmente. La mayoria de los desarrolladores lo dejan en medium para siempre. Ajustar el esfuerzo por tarea te da respuestas mas rapidas para trabajo simple y analisis mas profundo cuando lo necesitas.

Combina pensamiento extendido con preguntas especificas. "Por que este test es flaky?" con pensamiento extendido produce mejores resultados que un vago "ayudame a depurar esto."

Estos flujos de trabajo avanzados transforman Claude Code de una herramienta de generacion de codigo a un companero de desarrollo completo que se adapta a la complejidad y requisitos de cada tarea.