Capítulo 6: Background Agents y Sesiones

11 de enero de 2025 Por: Artiko

claude-codebackgroundsesionesteleportproductividad

Capítulo 6: Background Agents y Sesiones

Las sesiones nombradas y background agents permiten trabajar de forma más eficiente, manteniendo contexto y ejecutando tareas en paralelo.

Objetivos del Capítulo

Usar sesiones nombradas para organizar trabajo
Ejecutar background agents para tareas paralelas
Usar teleport entre Web y CLI
Optimizar flujos de trabajo con múltiples sesiones

Sesiones Nombradas

Las sesiones nombradas te permiten guardar y resumir conversaciones por nombre.

Nombrar una Sesión

# Durante una sesión activa
/rename feature-auth

# También puedes nombrar al crear
claude --session-id "bugfix-api"

Resumir una Sesión

# Por nombre
claude --resume feature-auth

# Ver sesiones disponibles
/resume

# Continuar la última sesión
claude -c
claude --continue

Listar Sesiones

# Comando interactivo
/resume
# Muestra lista de sesiones recientes

# Las sesiones nombradas aparecen con su nombre
# Las anónimas muestran timestamp

Organización de Sesiones

# Convención de nombres recomendada
feature-{nombre}     # Para features
bugfix-{ticket}      # Para bugs
refactor-{módulo}    # Para refactoring
experiment-{idea}    # Para experimentos

# Ejemplos
claude --session-id "feature-notifications"
claude --session-id "bugfix-JIRA-1234"
claude --session-id "refactor-database"

Background Agents

Los background agents ejecutan tareas mientras continúas trabajando.

Enviar Tarea a Background

# Durante una sesión
claude
> Ejecuta los tests de integración
# Presiona Ctrl+B para enviar a background

# O con el flag &
claude "Ejecuta todos los tests" &

Ctrl+B Unificado

Desde v2.1.0, Ctrl+B funciona para:

Comandos bash largos
Tareas de agentes
Cualquier operación en progreso

claude
> Refactoriza todo el módulo de auth
# Mientras ejecuta, presiona Ctrl+B
# La tarea continúa en background
# Puedes seguir trabajando

Monitorear Background Tasks

# Ver tareas en background
/tasks

# Las tareas muestran:
# - Estado (running, completed, failed)
# - Tiempo de ejecución
# - Progreso si disponible

Auto-background

Desde v2.0.19, comandos largos se envían automáticamente a background:

# Si un comando tarda más que el timeout
# Se mueve a background automáticamente
# Puedes configurar el timeout:
export BASH_DEFAULT_TIMEOUT_MS="120000"  # 2 minutos

Teleport Web-CLI

Teleport permite cambiar entre claude.ai web y Claude Code CLI.

Web → CLI

# En claude.ai web, usa el comando /teleport
# Esto transfiere la conversación a tu CLI local

# En CLI, acepta la conexión
/remote-env

Requisitos

Suscripción a claude.ai
Claude Code instalado
Misma cuenta en ambos

Casos de Uso

# Empiezas en web (móvil o sin terminal)
# Necesitas acceso a archivos locales
# Usas /teleport para continuar en CLI

# O viceversa:
# Trabajas en CLI
# Necesitas acceso web
# Envías tarea con & a claude.ai

Múltiples Sesiones Paralelas

Workflow con Terminales Múltiples

# Terminal 1: Feature principal
claude --session-id "feature-main"

# Terminal 2: Tests
claude --session-id "testing"

# Terminal 3: Documentación
claude --session-id "docs"

Con tmux/screen

# Crear layout con tmux
tmux new-session -d -s claude-work

# Panel 1: Desarrollo
tmux send-keys 'claude --session-id dev' C-m

# Panel 2: Tests
tmux split-window -h
tmux send-keys 'claude --session-id tests' C-m

# Panel 3: Background tasks
tmux split-window -v
tmux send-keys 'claude --session-id background' C-m

tmux attach -t claude-work

Exportar Conversaciones

# Exportar sesión actual
/export

# Formatos disponibles:
# - Markdown
# - JSON
# - Plain text

# Útil para:
# - Documentación
# - Code reviews
# - Compartir contexto

Rewind (Deshacer Cambios)

# Deshacer cambios de código
/rewind

# Muestra lista de cambios realizados
# Puedes seleccionar qué revertir
# Útil cuando Claude hace cambios incorrectos

Configuración de Sesiones

Limpieza Automática

{
  "cleanupPeriodDays": 30
}

Persistencia

Las sesiones se guardan en:

~/.claude/sessions/

Session ID Personalizado

# Para integraciones y scripts
claude --session-id "ci-build-123"

# El ID debe ser único
# Útil para CI/CD

Uso de Contexto

Ver Uso Actual

/usage

# Muestra:
# - Tokens usados
# - Límite del plan
# - Tiempo restante

Compactar Contexto

# Cuando el contexto es muy largo
/compact

# Claude resume la conversación
# Mantiene información importante
# Libera espacio para más interacción

Limpiar Contexto

/clear

# Borra todo el contexto
# Mantiene la sesión
# Útil para empezar tema nuevo

Integración con SDK

@anthropic-ai/claude-agent-sdk

import { ClaudeAgent } from '@anthropic-ai/claude-agent-sdk';

const agent = new ClaudeAgent({
  sessionId: 'my-session',
  maxBudgetUsd: 1.00
});

// Ejecutar tarea
const result = await agent.run('Refactoriza el módulo auth');

// La sesión puede resumirse después

Variables de Entorno SDK

# Auto-exit después de completar
export CLAUDE_CODE_EXIT_AFTER_STOP_DELAY="5000"

# Límite de presupuesto
claude --max-budget-usd 5.00

Flujos de Trabajo Avanzados

CI/CD con Sesiones

# GitHub Actions
- name: Claude Review
  run: |
    claude --session-id "pr-${{ github.event.pull_request.number }}" \
           "Revisa los cambios de este PR"

Desarrollo Paralelo

# Script para setup de desarrollo
#!/bin/bash

# Sesión principal
tmux new-session -d -s dev -n main
tmux send-keys -t dev:main "claude --session-id main" C-m

# Sesión de tests
tmux new-window -t dev -n tests
tmux send-keys -t dev:tests "claude --session-id tests" C-m

# Sesión de background
tmux new-window -t dev -n bg
tmux send-keys -t dev:bg "claude --session-id background" C-m

tmux attach -t dev

Resumen

En este capítulo aprendiste:

Usar sesiones nombradas con /rename y --resume
Ejecutar background agents con Ctrl+B
Teleport entre Web y CLI
Gestionar múltiples sesiones paralelas
Exportar y compactar conversaciones

Conclusión del Tutorial

Has completado el tutorial de Claude Code. Ahora dominas:

Instalación y configuración
Subagentes y Plan Mode
MCP y herramientas externas
Skills y plugins personalizados
Hooks y automatización
Claude in Chrome
Sesiones y background agents

Recursos Adicionales

← Volver al índice