Módulo 7: Remote Control y CLAUDE.md para Equipos

1. Introducción al Módulo — Remote Control y CLAUDE.md como Constitución de Equipo

Descripción

Hasta este punto, todo lo que has construido con Claude Code requiere que estés frente a tu computador. Creaste subagents especializados, les diste memoria, los coordinaste en paralelo, los organizaste en equipos con task boards, los empaquetaste como plugins, y los automatizaste con hooks y SDK headless. Un stack completo. Pero hay una restricción silenciosa que viene desde el Módulo 1: tu terminal. Siempre estás ahí. Si un Agent Team está corriendo un refactor de 45 minutos y necesita aprobación para un force push — tienes que estar sentado esperando. Si sales a caminar, el agente se queda bloqueado.

Remote control elimina esa restricción. Es la capacidad de conectarte a sesiones activas de Claude Code desde otro dispositivo — tu teléfono, tu tablet, otro computador — para monitorear progreso, aprobar operaciones, o redirigir trabajo. El Agent Team sigue corriendo en tu máquina. Tú supervisas desde cualquier lugar.

Pero remote control resuelve un problema individual. Cuando tres personas en tu equipo usan Claude Code, aparece un problema diferente: consistencia. Tú configuras tu CLAUDE.md con convenciones estrictas de TypeScript. Tu compañero usa Python con tabs. Otro no tiene CLAUDE.md. Cada agente produce código con estilos diferentes, patrones diferentes, calidad diferente. El resultado es un repositorio caótico donde cada archivo parece escrito por una persona distinta — porque lo fue, por agentes con reglas distintas.

CLAUDE.md para equipos resuelve esto. Es un archivo compartido en el repositorio que establece las reglas que todos los agentes siguen: convenciones de código, patrones arquitectónicos, restricciones de seguridad, requisitos de testing. Cuando un nuevo miembro clona el repo, su Claude Code adopta automáticamente las reglas del equipo. No hay onboarding manual. No hay "¿cómo configuraste tu Claude?"

Este módulo abre la Phase 3 (Orquestación) porque es el puente entre automatización individual y operación de equipo. Remote control te libera del terminal. CLAUDE.md unifica a tu equipo. Juntos, convierten Claude Code de "mi herramienta personal" a "la herramienta de mi equipo."

¿Dónde Estamos en la Guía?

Contexto en la Guía

Esta guía tiene 8 módulos organizados en 3 phases:

Phase 1: Subagents Avanzados (Módulos 1-3)           ← COMPLETADA
├── Módulo 1: Custom Subagents                        ✅
├── Módulo 2: Agent Memory y Scopes                   ✅
└── Módulo 3: Parallel Sub-Agent Delegation            ✅

Phase 2: Agent Teams y Plugins (Módulos 4-6)          ← COMPLETADA
├── Módulo 4: Agent Teams                              ✅
├── Módulo 5: Plugins: Crear y Distribuir              ✅
└── Módulo 6: Hooks Avanzados y SDK Headless           ✅

Phase 3: Orquestación (Módulos 7-8)
├── Módulo 7: Remote Control y CLAUDE.md para Equipos  ← ESTÁS AQUÍ
└── Módulo 8: Proyecto: Sistema Multi-Agente Completo

Duración total estimada: 8-10 horas (self-paced).

¿Qué cambia con remote control y CLAUDE.md?

En los módulos anteriores, la automatización era local y personal. Los hooks reaccionan a eventos, el SDK ejecuta Claude Code desde scripts, pero todo corre en tu máquina y con tus reglas. Remote control extiende el alcance operacional — puedes supervisar desde cualquier lugar. CLAUDE.md extiende el alcance organizacional — tus reglas se comparten con todo el equipo.

El cambio mental es: dejas de pensar como developer individual y empiezas a pensar como tech lead que diseña la operación de un equipo de agentes.

De Automatización Individual a Operación de Equipo

Lo que tienes ahora

Después de 6 módulos, tu stack es poderoso pero personal:

┌─────────────────────────────────────────────────────┐
│              Tu Stack Actual (Individual)             │
│                                                       │
│  ┌──────────────────────────────────────────────┐    │
│  │  Subagents (M1) + Memory (M2) + Parallel (M3)│    │
│  │  Agent Teams (M4) + Plugins (M5)              │    │
│  │  Hooks + SDK (M6)                             │    │
│  └──────────────────────────────────────────────┘    │
│                                                       │
│  Limitaciones:                                        │
│  ❌ Debes estar en el terminal para supervisar        │
│  ❌ Tus reglas no se comparten con el equipo          │
│  ❌ Cada developer configura diferente                │
│  ❌ Onboarding manual para nuevos miembros            │
└─────────────────────────────────────────────────────┘

Lo que tendrás después de este módulo

┌─────────────────────────────────────────────────────┐
│              Tu Stack + Operación de Equipo           │
│                                                       │
│  ┌──────────────────────────────────────────────┐    │
│  │  Todo lo anterior +                           │    │
│  │  Remote Control (supervisar desde cualquier   │    │
│  │  dispositivo, aprobar operaciones remoto)     │    │
│  │  CLAUDE.md compartido (constitución de equipo)│    │
│  └──────────────────────────────────────────────┘    │
│                                                       │
│  Ganancias:                                           │
│  ✅ Supervisar Agent Teams desde tu teléfono          │
│  ✅ Aprobar operaciones sin estar en el terminal      │
│  ✅ Reglas consistentes para todo el equipo           │
│  ✅ Onboarding automático: clonar = adoptar reglas   │
└─────────────────────────────────────────────────────┘

Remote Control: Supervisar Sin Estar Ahí

El problema real

Imagina este escenario: configuraste un Agent Team para hacer un refactor masivo. El team lead coordina 3 teammates, cada uno trabajando en un módulo diferente. El proceso tomará 30-40 minutos. A los 15 minutos, uno de los teammates necesita aprobar un git push --force a un branch de staging. Sin remote control, tienes dos opciones:

Quedarte sentado 40 minutos mirando la terminal — desperdicio de tiempo
Irte y volver — el agente se quedó bloqueado 25 minutos esperando tu aprobación

Remote control agrega una tercera opción:

Irte y aprobar desde tu teléfono — la notificación llega, revisas, apruebas, el agente continúa

Capacidades de remote control

Desde tu dispositivo móvil o web puedes:

┌────────────────────────────────────────────┐
│  👁️  MONITOREAR                            │
│  Ver qué está haciendo Claude en tiempo    │
│  real — archivos editados, comandos,       │
│  estado del Agent Team                     │
├────────────────────────────────────────────┤
│  ✅ APROBAR / ❌ RECHAZAR                   │
│  Operaciones que requieren permiso —       │
│  force push, database changes, deploys     │
├────────────────────────────────────────────┤
│  🔄 REDIRIGIR                              │
│  Cambiar prioridades, pausar tareas,       │
│  enviar instrucciones adicionales          │
├────────────────────────────────────────────┤
│  🛑 INTERRUMPIR                            │
│  Detener la ejecución si algo sale mal     │
└────────────────────────────────────────────┘

Estado experimental: Remote control es una feature en desarrollo activo. Las capacidades descritas están basadas en la documentación disponible a marzo 2026. Verifica la disponibilidad actual en docs.anthropic.com.

Casos de uso reales

Escenario	Sin remote control	Con remote control
Refactor largo (30+ min)	Esperas sentado	Monitoreas desde el café
Batch job nocturno	Revisas resultados al día siguiente	Apruebas operaciones desde la cama
CI que necesita aprobación	El pipeline se bloquea hasta que abras el laptop	Apruebas desde el teléfono
Agent Team con error	No te enteras hasta volver	Recibes notificación, intervienes

CLAUDE.md: La Constitución del Equipo

Más que un archivo de configuración

Ya conoces CLAUDE.md de guías anteriores. Lo usaste para dar instrucciones a Claude Code sobre tu proyecto: "usa TypeScript estricto", "no modifiques archivos en production/", "los tests van en tests/". Funcionó bien para ti.

Pero cuando tres developers trabajan en el mismo repo con diferentes CLAUDE.md (o sin CLAUDE.md), el resultado es inconsistencia. CLAUDE.md para equipos no es solo un archivo de configuración — es una constitución: el documento que define las reglas, valores y restricciones que todos los agentes respetan.

La jerarquía de merge

CLAUDE.md funciona en tres niveles, con una jerarquía de precedencia clara:

Nivel 1: Global (~/.claude/CLAUDE.md)
  Preferencias personales que aplican a TODOS tus proyectos.
  Ej: "Siempre responde en español", "Usa vim keybindings"
  
  ▼ (proyecto overrides global)

Nivel 2: Proyecto (./CLAUDE.md en el root del repo)
  Reglas del equipo. Se commitean al repo.
  Ej: "TypeScript strict", "No console.log", "Tests con vitest"
  
  ▼ (subdirectorio overrides proyecto)

Nivel 3: Subdirectorio (./src/api/CLAUDE.md)
  Reglas específicas para un módulo.
  Ej: "Endpoints siguen RESTful naming", "Validación con Zod"

La regla de precedencia: más específico gana. Si tu CLAUDE.md global dice "usa tabs" pero el CLAUDE.md del proyecto dice "usa spaces", el proyecto gana cuando trabajas en ese repo.

Qué poner en un CLAUDE.md de equipo

Un CLAUDE.md efectivo para equipos tiene secciones claras:

# CLAUDE.md — [Nombre del Proyecto]

## Convenciones de Código
- TypeScript strict mode obligatorio
- Funciones puras preferidas sobre clases
- Nombrar archivos en kebab-case

## Arquitectura
- API: FastAPI con routers modulares
- DB: PostgreSQL con SQLAlchemy async
- Cache: Redis para sesiones y rate limiting

## Patrones Prohibidos
- NO usar any en TypeScript
- NO queries SQL raw (usar ORM)
- NO console.log en producción

## Testing
- Cobertura mínima: 80%
- Tests unitarios para toda lógica de negocio
- Integration tests para endpoints

## Git
- Commits en conventional commits format
- PR requiere 1 review mínimo
- No force push a main

El poder del onboarding automático

Cuando un nuevo developer se une al equipo:

Día 1 — Sin CLAUDE.md de equipo:
  1. Clona el repo
  2. Lee documentación de 20 páginas
  3. Pregunta a compañeros cómo configurar Claude
  4. Configura manualmente su CLAUDE.md
  5. Produce código inconsistente las primeras 2 semanas
  6. Recibe feedback en code review
  7. Ajusta su configuración

Día 1 — Con CLAUDE.md de equipo:
  1. Clona el repo
  2. Su Claude Code adopta automáticamente las reglas
  3. Produce código consistente desde el primer commit

Objetivo del Módulo

Al terminar este módulo serás capaz de:

✅ Configurar remote control para acceder a sesiones de Claude Code desde otros dispositivos
✅ Monitorear Agent Teams remotamente — tareas en progreso, completadas, fallidas
✅ Diseñar approval flows: qué operaciones requieren aprobación humana y cómo aprobarlas remotamente
✅ Diseñar un CLAUDE.md estándar de equipo con convenciones, restricciones, quality gates y patrones
✅ Implementar merge de CLAUDE.md: proyecto-level + user-level + subdirectory-level sin conflictos
✅ Configurar enforcement: hooks que validan que el código respete las reglas del CLAUDE.md
✅ Crear un flujo de onboarding donde nuevos miembros adoptan el estándar automáticamente

Objetivo profesional

Remote control + CLAUDE.md de equipo son las features que convierten Claude Code en infraestructura de desarrollo para equipos. Los tech leads que dominan esta combinación no solo automatizan su trabajo — estandarizan el de todo su equipo. Es la diferencia entre "cada quien usa Claude Code como quiere" y "nuestro equipo tiene un estándar de calidad que los agentes respetan automáticamente."

Roadmap del Módulo

Mapa de cápsulas

#	Cápsula	Qué aprenderás	Tipo
01	Introducción (esta)	Contexto, modelo mental remote control + CLAUDE.md, por qué importa para equipos	Intro
02	Remote Control Setup	Configurar remote control, conectar dispositivos, monitorear sesiones	Técnica
03	Approval Flows Remotos	Diseñar gates de aprobación, aprobar desde móvil, timeouts y seguridad	Técnica
04	CLAUDE.md para Equipos	Estructura, merge hierarchy, enforcement con hooks, templates	Técnica
05	Proyecto: Setup de Equipo	CLAUDE.md completo, remote control, approval flows, onboarding — todo integrado	Proyecto

Flujo de aprendizaje

Primero entenderás remote control — cómo conectar dispositivos, monitorear sesiones activas, y ver el estado de Agent Teams desde tu teléfono (cápsula 02). Luego diseñarás approval flows — qué operaciones necesitan aprobación humana, cómo aprobarlas remotamente, y qué pasa si nadie aprueba a tiempo (cápsula 03). Después aprenderás a diseñar CLAUDE.md como estándar de equipo — estructura, merge hierarchy, enforcement con hooks, y templates production-ready (cápsula 04). Finalmente, construirás un setup completo de equipo que integra CLAUDE.md + remote control + approval flows + onboarding (cápsula 05).

La progresión es: monitorear remotamente → aprobar remotamente → estandarizar el equipo → integrar todo.

Cada cápsula es independiente en concepto pero construye sobre la anterior en el proyecto final. Las cápsulas 02 y 03 cubren remote control. La cápsula 04 cubre CLAUDE.md. La cápsula 05 integra todo.

Duración estimada del módulo: 1-1.25 horas.

Conexión con el Proyecto

Proyecto del módulo: Setup Completo de Equipo

En la cápsula 05 construirás un setup production-ready para un equipo de 3 personas:

CLAUDE.md compartido — Constitución del equipo con convenciones, restricciones, quality gates, y patrones arquitectónicos.
Remote control configurado — Acceso desde dispositivos móviles para monitorear Agent Teams.
Approval flows — Operaciones destructivas (force push, database changes) requieren aprobación humana configurable.
Hooks de enforcement — Scripts que validan que el código respete las reglas del CLAUDE.md.
Onboarding checklist — Proceso documentado para que nuevos miembros adopten el estándar en 5 minutos.

Tu setup de equipo:

CLAUDE.md (constitución)
  ↓
Todos los agentes respetan las reglas
  ↓
Hooks validan compliance
  ↓
Remote control supervisa ejecución
  ↓
Approval flows protegen operaciones críticas
  ↓
Nuevo miembro clona repo → adopta todo automáticamente

Conexión con el proyecto final (Módulo 8)

En el proyecto integrador, este setup de equipo es la base operacional del sistema multi-agente completo. El CLAUDE.md es la constitución que todos los agentes respetan, remote control es la forma en que apruebas operaciones críticas durante la ejecución, y los approval flows son los guardianes que protegen contra operaciones destructivas. Sin este módulo, el proyecto integrador requeriría presencia constante frente al terminal y no tendría estándar compartido.

Prerequisitos

Conocimientos necesarios

✅ Módulos 1-6 completados — Custom subagents, memory, delegación paralela, Agent Teams, plugins, hooks, SDK
✅ Hooks básicos y avanzados — SessionStart, PreToolUse, PostToolUse, exit codes
✅ CLAUDE.md básico — Has creado al menos un CLAUDE.md en guías anteriores
✅ settings.json — Sabes configurar Claude Code a nivel proyecto
✅ Git — Commits, branches, pull requests

Verificación rápida

Si puedes responder "sí" a estas preguntas, estás listo:

¿Sabes qué es un hook PermissionRequest y cuándo se dispara?
¿Has usado CLAUDE.md para dar instrucciones a Claude Code?
¿Puedes configurar hooks en .claude/settings.json?
¿Entiendes la diferencia entre exit code 0, 1, y 2 en hooks?
¿Sabes usar el SDK headless (claude -p) desde scripts?

No necesitas

❌ Experiencia con remote control — se cubre completamente aquí
❌ Experiencia gestionando equipos — los patrones se explican paso a paso
❌ Infraestructura de CI/CD — se menciona pero se cubre en otra guía
❌ Dispositivo móvil para empezar — puedes simular remote control desde otro terminal

Límites: Qué NO Se Cubre en Este Módulo

❌ CI/CD completo — Se cubre en la guía de CI/CD Pipelines. Aquí se menciona como integración
❌ Multi-repo CLAUDE.md — Se cubre un solo repo con subdirectorios, no múltiples repos sincronizados
❌ Administración de organizaciones — Policies a nivel enterprise están fuera de scope
❌ Remote control sobre redes privadas/VPN — Se asume conectividad estándar
❌ Desarrollo del SDK de remote control — Se usa la API existente, no se construye una nueva

Evidencia de Éxito

Al terminar este módulo, sabrás que tuviste éxito si:

✅ Puedes conectarte a una sesión activa de Claude Code desde otro dispositivo
✅ Un approval flow bloquea una operación destructiva hasta que la apruebas
✅ Tienes un CLAUDE.md que todo tu equipo usa y que se aplica automáticamente
✅ Hooks validan que el código generado respeta las reglas del CLAUDE.md
✅ Un nuevo "miembro" del equipo puede clonar el repo y tener el estándar completo sin configuración manual
✅ Puedes explicar la jerarquía de merge de CLAUDE.md y cómo se resuelven conflictos

Test rápido de autoevaluación

Si puedes responder estas preguntas al terminar:

¿Cómo conectas un dispositivo móvil a una sesión activa de Claude Code?
¿Qué pasa cuando un approval flow tiene un timeout y nadie aprueba?
¿Cuál es la jerarquía de precedencia de CLAUDE.md (global, proyecto, subdirectorio)?
¿Cómo enforceas las reglas de CLAUDE.md con hooks?
¿Qué archivos necesita clonar un nuevo miembro para adoptar el estándar completo?

Resumen

Este módulo enseña las dos piezas operacionales que convierten Claude Code de herramienta individual a herramienta de equipo: remote control (supervisión remota) y CLAUDE.md (estándar compartido)
Remote control permite monitorear sesiones, aprobar operaciones, y intervenir desde cualquier dispositivo — elimina la necesidad de estar frente al terminal
CLAUDE.md para equipos es una constitución compartida: convenciones, restricciones, quality gates que todos los agentes respetan automáticamente
La jerarquía de merge (global < proyecto < subdirectorio) permite reglas compartidas con espacio para overrides personales
El onboarding automático es clave: clonar el repo = adoptar el estándar del equipo, sin configuración manual
El módulo abre Phase 3 (Orquestación) — el puente entre automatización individual (Phase 2) y el proyecto integrador (Module 8)
El proyecto construye un setup completo de equipo: CLAUDE.md + remote control + approval flows + hooks de enforcement + onboarding

Recursos Adicionales

Claude Code Overview (Anthropic Docs) — Contexto general de Claude Code como sistema
Claude Code Settings — Configuración de CLAUDE.md y settings.json
Claude Code CLAUDE.md Memory — Documentación oficial de CLAUDE.md y sus niveles
Claude Code Hooks — Hooks para enforcement de reglas
Claude Code Best Practices — Buenas prácticas para equipos
Claude Code CLI Reference — Referencia de flags para remote control
Claude Code Tips and Tricks — Tips de productividad y configuración
Claude Code Subagents — Subagents que respetan CLAUDE.md del equipo

Siguiente cápsula: En la cápsula 02 configurarás remote control — cómo habilitar acceso remoto a sesiones de Claude Code, conectar dispositivos, monitorear Agent Teams en tiempo real, y supervisar operaciones largas sin estar frente al terminal. Verás el setup técnico, los protocolos de seguridad, y las diferencias entre operar desde el terminal vs. operar remotamente.

← Anterior6. Proyecto — Workflow Automatizado con Hooks + SDK End-to-End Siguiente →2. Remote Control — Setup, Sesiones y Control desde Dispositivos Móviles