Inicio/Uso avanzado

Uso avanzado

Técnicas avanzadas para sacar el máximo partido a Claude Code: subagentes, worktrees, integración en CI/CD, modo headless y más.

Subagentes

Claude Code puede lanzar subagentes: instancias paralelas de Claude que trabajan de forma independiente en subtareas. Esto es especialmente útil para tareas que se pueden paralelizar.

Ejemplos donde los subagentes brillan:

  • Refactorizar 20 archivos en paralelo.
  • Generar tests para múltiples módulos simultáneamente.
  • Investigar distintas soluciones a la vez y elegir la mejor.

Lanzar subagentes con el SDK de Claude:

# Dentro de Claude Code, Claude decide cuándo paralelizar
> "Genera tests unitarios para cada archivo en src/components. Hazlo en paralelo."

# Claude lanzará un subagente por archivo automáticamente
Los subagentes se gestionan automáticamente. Claude decide cuándo crear uno basándose en la complejidad y paralelizabilidad de la tarea. Puedes ver los activos con /agents.

Git worktrees

Los git worktrees permiten trabajar en múltiples ramas del mismo repositorio simultáneamente, en directorios distintos. Puedes usarlos para aislar cambios grandes antes de abrir Claude Code:

# Crear un worktree para una feature branch
git worktree add ../mi-proyecto-feature feature/nueva-api

# Entrar en ese directorio y abrir Claude Code allí
cd ../mi-proyecto-feature
claude

Así separas los cambios de tu rama principal con una herramienta de Git estable y verificable. Cuando termines, revisa el diff, ejecuta tests y fusiona o elimina el worktree según convenga.

Modo headless / CI-CD

Claude Code puede ejecutarse sin interfaz interactiva, ideal para pipelines de CI/CD, scripts y automatizaciones:

# Modo headless básico
claude -p "revisa el código en busca de vulnerabilidades SQL"

# Con output JSON para parsear
claude -p --output-format json "lista todos los TODO del proyecto" | jq '.result'

# En un Makefile o script CI
claude -p --dangerously-skip-permissions \
  "ejecuta los tests, si hay fallos corrígelos y haz commit"

# En GitHub Actions
- name: Claude Code Review
  run: |
    claude -p "revisa los cambios del PR y comenta problemas de seguridad" \
      --output-format json > review.json
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

Elegir modelo y esfuerzo

En vez de memorizar IDs concretos, usa aliases de modelo. Claude Code resuelve sonnet, opus, haiku o fable según tu proveedor y permisos.

# Modelo equilibrado para el día a día
claude --model sonnet

# Más razonamiento en la sesión actual
claude --model opus --effort high

# Dentro de la sesión puedes abrir el selector
/model

Sesiones largas y compactación

En sesiones largas, el contexto se llena y Claude Code puede volverse más lento o perder coherencia. Soluciones:

Compactar el contexto

# Dentro de Claude Code
/compact

# Claude resume la conversación hasta el momento
# y la reemplaza por un resumen compacto

Reanudar una sesión

# Ver sesiones recientes
claude resume

# Continuar la última sesión
claude resume --last

# El contexto se restaura automáticamente

CLAUDE.md en subdirectorios

Puedes tener archivos CLAUDE.md en subdirectorios de tu proyecto. Claude los leerá automáticamente cuando trabaje en esa carpeta, dándole instrucciones específicas para esa parte del código:

mi-proyecto/
├── CLAUDE.md              ← instrucciones globales
├── frontend/
│   └── CLAUDE.md          ← instrucciones para el frontend
├── backend/
│   └── CLAUDE.md          ← instrucciones para el backend
└── docs/
    └── CLAUDE.md          ← instrucciones para documentación

Flujos de trabajo con git

Crear feature branches automáticamente

> "Implementa el sistema de notificaciones push. Crea una feature branch,
   haz los cambios necesarios y al terminar prepara el PR."

# Claude hará:
# 1. git checkout -b feature/push-notifications
# 2. Implementar los cambios
# 3. git add + git commit con mensaje descriptivo
# 4. Preparar el cuerpo del PR para que lo apruebes

Code review automatizado

# Revisar el diff del último commit
claude -p "revisa este diff en busca de bugs y problemas de rendimiento" \
  <<< "$(git diff HEAD~1)"

# Revisar todo un PR
gh pr diff 123 | claude -p "haz un code review completo"

Integración con tmux / pantallas divididas

Un flujo de trabajo popular es tener Claude Code en un panel y tu editor en otro:

# Crear sesión tmux con dos paneles
tmux new-session -d -s dev
tmux split-window -h
tmux send-keys -t dev:0.0 "claude" Enter  # Claude Code a la izquierda
tmux send-keys -t dev:0.1 "nvim ." Enter  # Editor a la derecha

Tips de productividad

  • Sé específico con el contexto: menciona el archivo, la función y el error exacto. Cuanto más específico, mejor resultado.
  • Un alias útil: alias ai="claude -p"para consultas rápidas sin entrar al modo interactivo.
  • Memoria entre sesiones: mantén tu CLAUDE.md actualizado con las decisiones de arquitectura y convenciones del proyecto.
  • Tareas grandes: divide el trabajo en subtareas menores. Claude trabaja mejor con objetivos acotados y claros.
  • Revisar antes de aceptar: usa siempre el diff view para entender exactamente qué va a cambiar antes de confirmar.

Exportar la sesión

# Guardar el transcript de la sesión actual
claude -p --output-format json "resumen del trabajo de hoy" > sesion-$(date +%Y%m%d).json
← PermisosVolver al inicio →