Capítulo 2: Flujos de Trabajo Avanzados

11 de enero de 2025 Por: Artiko

claude-codesubagentesmcpplan-modeworkflows

Capítulo 2: Flujos de Trabajo Avanzados

En este capítulo exploraremos las características más poderosas de Claude Code: subagentes especializados, Plan Mode y Model Context Protocol.

Objetivos del Capítulo

Utilizar subagentes especializados
Dominar Plan Mode para planificación
Configurar y usar MCP servers
Implementar flujos de trabajo complejos

Subagentes Especializados

Claude Code puede delegar tareas a subagentes especializados, cada uno optimizado para un tipo específico de trabajo.

Tipos de Subagentes Built-in

Subagente	Modelo	Propósito
Explore	Haiku	Búsqueda rápida en codebase
Plan	Sonnet	Diseño de planes de implementación
Bash	-	Ejecución de comandos
general-purpose	-	Tareas generales

Usar Subagentes

# Ver agentes disponibles
/agents

# Usar agente específico
claude --agent explore "Busca todos los endpoints de API"

# Crear agente personalizado
/agents create

Explore Subagent

El subagente Explore usa Haiku para búsquedas rápidas y eficientes:

# Búsqueda de código
claude
> Usa el agente Explore para encontrar dónde se maneja la autenticación

# El agente Explore se activa automáticamente para:
# - Buscar archivos por patrones
# - Encontrar definiciones de clases/funciones
# - Explorar estructura del proyecto

Plan Subagent

El subagente Plan diseña estrategias de implementación:

claude
> Planifica cómo implementar un sistema de cache Redis

# El agente Plan:
# - Analiza el codebase existente
# - Identifica archivos a modificar
# - Propone pasos de implementación
# - Considera trade-offs

Crear Subagentes Personalizados

# Estructura de agente personalizado
# ~/.claude/agents/security-reviewer.md

---
name: security-reviewer
description: Revisa código por vulnerabilidades de seguridad
model: sonnet
tools:
  - Read
  - Grep
  - Glob
allowed-tools:
  - Read
  - Grep(OWASP*)
---

Eres un experto en seguridad. Revisa el código buscando:
- Inyección SQL
- XSS
- CSRF
- Secrets expuestos

Reporta cada vulnerabilidad con severidad y solución.

Deshabilitar Subagentes

# Por CLI
claude --disallowed-tools "Task(Explore)"

# En settings.json
{
  "disallowedTools": ["Task(Explore)", "Task(Plan)"]
}

Plan Mode

Plan Mode permite diseñar y aprobar planes antes de ejecutar cambios.

Activar Plan Mode

# Comando directo
/plan

# O pedir planificación
claude "Planifica cómo migrar de Express a Fastify"

Flujo de Plan Mode

Análisis: Claude analiza el codebase
Propuesta: Presenta un plan detallado
Feedback: Puedes dar feedback o pedir cambios
Aprobación: Apruebas o rechazas el plan
Ejecución: Claude implementa si apruebas

Feedback en Planes

# Claude presenta un plan
# Puedes responder:

> Modifica el plan para usar Redis en lugar de Memcached
> Añade tests unitarios a cada paso
> El paso 3 no es necesario, elimínalo

Plan Mode con Thinking

# Para planes complejos, combina con thinking
claude --model opus
/plan
> Diseña la arquitectura para un sistema de microservicios

Model Context Protocol (MCP)

MCP permite conectar Claude Code con fuentes de datos y herramientas externas.

Configuración de MCP

// ~/.claude/mcp.json o .claude/mcp.json
{
  "mcpServers": {
    "postgres": {
      "command": "mcp-server-postgres",
      "args": ["--connection-string", "postgresql://localhost/mydb"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/path/to/allowed/dir"]
    }
  }
}

MCP Servers Populares

Server	Descripción
`@anthropic/mcp-server-github`	Integración con GitHub
`@anthropic/mcp-server-filesystem`	Acceso a sistema de archivos
`mcp-server-postgres`	Consultas PostgreSQL
`mcp-server-sqlite`	Base de datos SQLite
`mcp-server-brave-search`	Búsqueda web

Usar MCP

# Configurar MCP desde CLI
claude --mcp-config ./mcp.json

# Usar herramientas MCP
claude
> Consulta cuántos usuarios activos hay en la base de datos
> Lista los issues abiertos en el repo de GitHub

Headers Dinámicos para MCP

{
  "mcpServers": {
    "api-server": {
      "command": "mcp-server-api",
      "headersHelper": "node ./get-auth-headers.js"
    }
  }
}

Permisos Wildcard para MCP

{
  "permissions": {
    "allow": [
      "mcp__github__*",
      "mcp__postgres__query"
    ],
    "deny": [
      "mcp__postgres__delete"
    ]
  }
}

Extended Thinking

Para problemas complejos que requieren análisis profundo.

Activar Thinking

# Por modelo (Opus activa thinking por defecto)
claude --model opus

# Toggle durante sesión
# Tab en la UI para alternar

# Desactivar en prompt específico
/t Responde sin pensar mucho

Thinking Mode en Config

/config
# Navegar a thinking mode y activar/desactivar

Ultrathink

Para los problemas más complejos, el modo “ultrathink” proporciona análisis aún más profundo con Opus 4.5.

Automatización con Scripts

Integración con Shell

#!/bin/bash
# daily-review.sh

# Análisis de seguridad
claude "Busca vulnerabilidades en los cambios de hoy" > security.md

# Code smells
claude "Encuentra code smells en src/" > smells.md

# Generar resumen
claude "Resume los reportes" < security.md < smells.md

Pipelines de Datos

# JSON a SQL
cat users.json | claude "Genera INSERT statements"

# Logs a métricas
grep ERROR app.log | claude "Agrupa errores por tipo"

# API a Markdown
curl https://api.example.com/stats | claude "Formatea como tabla"

GitHub Actions

name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Claude
        run: |
          curl -fsSL https://console.anthropic.com/claude-code/install.sh | sh

      - name: Review PR
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude "Revisa los cambios de este PR" > review.md

      - name: Post Review
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              ...context.repo,
              issue_number: context.issue.number,
              body: `## Claude Code Review\n\n${review}`
            });

Flujos de Trabajo Complejos

Feature Development

# 1. Planificar
/plan
> Implementa sistema de notificaciones push

# 2. Ejecutar plan aprobado
# Claude implementa paso a paso

# 3. Verificar
claude "Ejecuta los tests del módulo de notificaciones"

# 4. Documentar
claude "Actualiza la documentación del API"

Refactoring

# 1. Analizar
claude "Encuentra código duplicado en src/"

# 2. Planificar refactor
/plan
> Elimina la duplicación encontrada

# 3. Ejecutar con verificación
# Claude ejecuta y verifica tests en cada paso

Migración de Dependencias

# Análisis inicial
claude "¿Qué dependencias están desactualizadas?"

# Planificar migración
/plan
> Actualiza React a la versión 19

# Ejecutar con cuidado
# Claude actualiza, ejecuta tests, corrige breaking changes

Resumen

En este capítulo aprendiste:

Cómo usar subagentes especializados (Explore, Plan)
Crear y configurar agentes personalizados
Dominar Plan Mode para planificación
Configurar MCP servers para integraciones
Automatizar flujos de trabajo complejos

Próximo Capítulo

En el siguiente capítulo exploraremos Skills y Sistema de Plugins:

Crear skills personalizados
Instalar y gestionar plugins
Hot-reload de skills

Siguiente: Capítulo 3 - Skills y Plugins →