Lo esencial
- Anthropic recomienda ejecutar 3–5 sesiones de Claude Code en paralelo, cada una dentro de su propio git worktree.
- La verificación es el patrón de mayor impacto: Claude Code mejora cuando puede comprobar su propio resultado con tests, navegador o comandos.
- CLAUDE.md debe vivir en la raíz del repositorio, versionado en git y actualizado cada vez que Claude repita un error.
- El comando /batch sirve para repartir migraciones grandes entre agentes aislados en worktrees.
- Las tareas que repites más de una vez al día son candidatas claras para convertirse en skills de Claude Code.
Claude Code avanzado significa dejar de usar el agente como un chat de programación y convertirlo en un flujo de ingeniería: varias sesiones aisladas, planificación antes de tocar código, memoria compartida en CLAUDE.md, verificación automática y skills para tareas repetidas. La guía oficial de Anthropic lo resume en patrones que su equipo usa a diario para enviar código más rápido.
Claude Code avanzado: qué vas a conseguir y cuándo merece la pena
Claude Code avanzado es útil cuando el coste de coordinar, revisar y corregir al agente ya pesa más que escribir prompts sueltos. Si solo le pides funciones pequeñas, estos patrones pueden parecer excesivos; si mantienes un producto, una librería interna o varias automatizaciones, cambian por completo la forma de trabajar.
Anthropic explica en su guía oficial de Claude Code power user tips que el documento recopila prácticas del equipo de Claude Code en ejecución paralela, planificación, automatización, verificación y personalización. La frase clave no va de modelos ni de magia: va de cerrar el bucle de feedback.
“The single most impactful tip in this guide is verification —giving Claude a way to check its own output.” — Anthropic Help Center
En los proyectos que monto con pymes, el salto de calidad llega cuando dejamos de pedir “haz X” y empezamos a diseñar el entorno donde Claude puede trabajar, equivocarse poco, comprobarse y acumular aprendizaje. Esa es la diferencia entre tener un copiloto brillante y tener un sistema operativo de desarrollo asistido.
Antes de aplicar todo, necesitas tres bases: un repositorio ordenado, una suite mínima de verificación y una política clara de permisos. Si además trabajas con PRs, issues, entornos de staging o automatizaciones CI, estos patrones encajan muy bien con flujos como Claude Code en GitHub Actions.
Cómo usar varios Claude Code en paralelo con worktrees
Anthropic recomienda ejecutar 3–5 sesiones de Claude Code en paralelo, cada una dentro de su propio git worktree. Este patrón reduce bloqueos porque cada agente trabaja en una copia aislada del repositorio, sin pisar los cambios de los demás.
La idea es sencilla: una sesión puede refactorizar autenticación, otra preparar tests, otra revisar logs y otra investigar una regresión. Tú no esperas a que una conversación termine; orquestas varias líneas de trabajo y decides qué entra en main.
Paso 1: crea sesiones aisladas con claude –worktree
Claude Code incluye soporte nativo para worktrees mediante el comando que Anthropic documenta en la guía oficial. Puedes arrancar una sesión aislada desde la CLI y, si usas Tmux, lanzarla en su propia sesión para no mezclar terminales.
claude --worktree
claude --worktree my_worktree
claude --worktree --tmuxEl patrón operativo que mejor funciona no es abrir worktrees sin nombre, sino asignar una intención clara a cada uno: análisis, migración, tests, deuda técnica o PR concreto. Anthropic también sugiere nombrar worktrees, usar alias de shell, colorear pestañas de terminal y activar notificaciones para saber cuándo una sesión necesita intervención.
Si tu equipo no usa Git, la guía indica que para Mercurial, Perforce o SVN puedes definir hooks WorktreeCreate y WorktreeRemove en settings.json. No es un detalle menor: el aislamiento importa más que la herramienta concreta de control de versiones.
Paso 2: usa subagentes de Claude Code con aislamiento
Los subagentes Claude Code pueden ejecutarse en worktrees aislados añadiendo isolation: worktree al frontmatter del agente. Este patrón es especialmente útil cuando una migración grande se puede trocear por carpetas, módulos o tipos de cambio.
# .claude/agents/worktree-worker.md
---
name: worktree-worker
model: haiku
isolation: worktree
---Después puedes pedir una migración de forma natural y especificar que cada agente pruebe sus cambios antes de proponerlos. Anthropic da como ejemplo una migración de IO síncrono a asíncrono con agentes en paralelo, cada uno verificando end to end y subiendo su PR.
Paso 3: reserva /batch para migraciones grandes
El comando /batch entrevista al usuario sobre una migración y reparte el trabajo entre agentes en worktrees. Según Anthropic, puede abrir tantos agentes como sean necesarios para que cada uno trabaje aislado, pruebe su parte y cree una PR independiente.
/batch migrate src/ from JavaScript to TypeScriptMi criterio: no usaría /batch para cambios ambiguos de arquitectura, pero sí para transformaciones repetibles con criterios verificables. Migrar imports, convertir patrones obsoletos, normalizar tests o dividir una conversión por carpetas son buenos candidatos.
Qué es CLAUDE.md y cómo configurarlo en Claude Code
CLAUDE.md es la memoria compartida del repositorio para que Claude Code entienda reglas, decisiones y errores que no debe repetir. Anthropic recomienda mantener un único CLAUDE.md en la raíz del proyecto, versionado en git y alimentado por todo el equipo.
No lo trates como un README para humanos. Trátalo como el contrato operativo del agente: estilo de código, comandos de test, convenciones de naming, decisiones prohibidas, patrones preferidos y lecciones aprendidas después de cada metedura de pata.
# CLAUDE.md
Project rules:
- Run the relevant test suite before proposing a PR.
- Prefer literal unions over TypeScript enums.
- Do not change public APIs without updating tests and docs.
- When a command fails, include the failing command and output in the handoff.La práctica que más me gusta de la guía es muy concreta: cada vez que Claude haga algo mal, añade la corrección a CLAUDE.md para que no lo repita. Anthropic incluso propone terminar la corrección con una instrucción del tipo “Update your CLAUDE.md so you don’t make that mistake again”.
Paso 4: separa memoria de proyecto y memoria personal
Anthropic distingue entre archivos que mantienes a mano y el sistema de memoria integrado de Claude Code. El archivo ./CLAUDE.md vive en el repositorio; la memoria automática se configura con /memory y guarda preferencias, correcciones y patrones entre sesiones.
/memorySegún la guía, las memorias automáticas se escriben en ~/.claude/projects/<project>/memory/, con un directorio por raíz de repositorio git. Yo no mezclaría ahí normas de equipo críticas: lo que afecte a todos debe estar versionado en CLAUDE.md.
Paso 5: lleva las revisiones de PR a CLAUDE.md
Anthropic recomienda instalar la GitHub Action con /install-github-app y mencionar @claude en comentarios de PR para incorporar aprendizajes al archivo CLAUDE.md. Esto convierte cada revisión en memoria reutilizable, no en una corrección perdida en un hilo.
/install-github-appnit: use a string literal, not ts enum @claude add to CLAUDE.md to never use enums, always prefer literal unionsEste enfoque encaja con lo que ya expliqué al analizar qué significa Claude Code en GitHub: el valor no está solo en generar código, sino en meter al agente dentro del flujo real de revisión, CI y aprendizaje del equipo.
Cómo hacer que Claude Code verifique su propio código
La verificación en Claude Code consiste en darle al agente una forma objetiva de comprobar si su resultado funciona. Anthropic la presenta como el consejo de mayor impacto porque permite que Claude cierre el bucle de feedback e itere sin depender de tu intuición en cada paso.
Si el agente no puede verificar, se convierte en un redactor convincente. Si puede ejecutar tests, comparar comportamiento, abrir el navegador o correr simuladores, se acerca más a un ingeniero junior incansable al que has dado una checklist fiable.
| Contexto | Verificación útil | Riesgo si falta |
|---|---|---|
| Backend | Suites de tests, comandos bash y comprobaciones de API | Regresiones silenciosas o cambios que solo compilan |
| Frontend | Extensión de Claude Code para Chrome o Edge y pruebas visuales | Interfaces que parecen correctas en código pero fallan en uso |
| Migraciones | Comparar rama principal y rama de trabajo con casos representativos | Cambios masivos imposibles de revisar manualmente |
| Datos | Consultas de validación, conteos y tests de invariantes | Transformaciones que pasan tests técnicos pero rompen negocio |
Para frontend, Anthropic recomienda instalar la extensión de Claude Code para Chrome o Edge y afirma que el equipo la usa cada vez que trabaja en código web. Tiene sentido: si pides una pantalla, el agente necesita ver y probar la pantalla, no solo editar componentes.
Un patrón práctico: pide primero el plan de verificación, no la implementación. Si Claude no sabe cómo va a comprobar que algo funciona, probablemente tampoco sabe bien qué significa “funciona” en tu sistema.
Prove to me this works.Esa instrucción aparece en los patrones de prompting de Anthropic y obliga a Claude a justificar el resultado con evidencias. En una migración real, yo la combinaría con una comparación explícita entre main y la rama de trabajo, especialmente cuando hay cambios de comportamiento.
Comandos Claude Code para planificar, automatizar y aprender
Los comandos Claude Code más útiles para usuarios avanzados son los que reducen ambigüedad antes de construir y convierten tareas repetidas en sistema. La guía de Anthropic insiste en plan mode, niveles de esfuerzo, preguntas laterales y skills como piezas de un flujo más estable.
Paso 6: empieza tareas complejas en plan mode
Anthropic recomienda entrar en plan mode con Shift+Tab antes de abordar tareas complejas. El flujo típico es planificar, refinar el plan, cambiar a aceptación automática de ediciones y dejar que Claude ejecute.
Un patrón especialmente bueno es pedir a una sesión de Claude que escriba el plan y a otra que lo revise como staff engineer. En sistemas reales, esta doble mirada evita que el agente empiece a tocar veinte archivos con una premisa débil.
Press Shift+Tab to cycle into plan mode.Cuando algo se tuerza, no intentes corregir a base de microinstrucciones. Vuelve a plan mode, reformula restricciones, exige un plan actualizado y solo entonces deja que siga.
Paso 7: ajusta /effort por tipo de tarea
El comando /effort permite elegir low, medium, high, xhigh, max y auto, según la guía de Anthropic. No todos los trabajos merecen el mismo razonamiento: gastar tokens en una sustitución mecánica es tan mala práctica como depurar arquitectura en modo superficial.
/effortAnthropic sugiere xhigh para trabajo complejo de programación y agentes, y max para depuración difícil o decisiones de arquitectura donde quieres que Claude razone durante más tiempo. Si te preocupa el coste o los límites de uso, revisa también los modelos y precios actuales en la documentación de modelos de Anthropic; a 28 de septiembre de 2026, esa tabla muestra precios por millón de tokens para Opus 5.5, Sonnet 5 y Haiku 4.5.
Si estás comparando cuándo merece la pena un modelo más potente para agentes, enlaza esta decisión con criterios de coste como los que traté en Claude Opus para agentes: más capacidad puede salir más barata si reduce iteraciones, revisiones y errores.
Paso 8: convierte repeticiones en skills de Claude Code
Anthropic recomienda convertir en skill cualquier flujo que hagas más de una vez al día. Una skill vive como un archivo SKILL.md bajo .claude/skills/<name>/ y encapsula instrucciones, pasos y criterios para una tarea recurrente.
.claude/skills/<name>/SKILL.mdBuenos candidatos: revisar una PR con tus reglas, generar un informe de deuda técnica, preparar una migración de tests, auditar logs o crear documentación técnica siguiendo tu plantilla. Si quieres bajar a un ejemplo simple antes de llevarlo a Claude Code, tienes una ruta práctica en cómo crear skills de Claude.
Para preguntas laterales mientras Claude trabaja, la guía incluye /btw. Es de un solo turno y sin llamadas a herramientas, pero conserva el contexto de la conversación; sirve para preguntar sin interrumpir la tarea principal.
/btw what does the retry logic do?Checklist, errores habituales y ruta siguiente
Un flujo avanzado de Claude Code debe tener aislamiento, memoria, verificación, planificación y límites de permisos antes de escalar a automatizaciones más agresivas. Si falta una de esas piezas, el agente puede ir rápido en la dirección equivocada.
- Aislamiento: usa worktrees para que varias sesiones no pisen cambios ni mezclen contextos.
- Planificación: entra en plan mode en tareas complejas y revisa el plan antes de aceptar ediciones.
- Memoria: versiona CLAUDE.md en la raíz del repositorio y añade cada corrección importante.
- Verificación: da a Claude tests, comandos o navegador antes de pedir implementación.
- Automatización: convierte tareas diarias en skills y migraciones repetibles en /batch.
El error más común que veo es abrir demasiadas sesiones sin una política de revisión. Tres agentes produciendo PRs malos son peor que uno; tres agentes con tests, reglas de CLAUDE.md y verificación end to end sí empiezan a multiplicar capacidad.
- Worktrees sin propósito: nombra cada sesión por resultado esperado, no por ocurrencia del momento.
- CLAUDE.md inflado: guarda reglas accionables; elimina consejos vagos que el agente no pueda aplicar.
- Verificación tardía: define cómo se probará el cambio antes de permitir que Claude toque archivos.
- Permisos laxos: evita saltarte protecciones por comodidad y revisa el modo automático antes de usarlo.
Sobre permisos, Anthropic publicó el 25 de marzo de 2026 un artículo de ingeniería sobre auto mode donde afirma que los usuarios aprueban el 93% de los prompts de permisos. El enfoque de auto mode intenta reducir fatiga de aprobación sin desactivar todas las protecciones, algo que expliqué con más detalle en modo automático de Claude Code.
La ruta sensata para dominar Claude Code avanzado es esta: primero worktrees manuales, después CLAUDE.md vivo, luego verificación fiable, más tarde skills y subagentes, y solo al final /batch o automatizaciones remotas. Escalar sin esa base suele producir mucho movimiento y poca ingeniería.
Si usas Claude Code con plan Pro o Max, revisa además la documentación oficial sobre disponibilidad y facturación: Anthropic advierte en su página de Claude Code con Pro o Max que, si existe la variable ANTHROPIC_API_KEY, Claude Code usará la API en lugar de la suscripción y puede generar cargos de API. Es el típico detalle operativo que conviene fijar antes de invitar al equipo entero.
Preguntas frecuentes
¿Cómo usar varios Claude Code en paralelo con worktrees?
Anthropic recomienda ejecutar 3–5 sesiones de Claude Code en paralelo, cada una en su propio git worktree. Desde la CLI se usa claude –worktree, o claude –worktree my_worktree para nombrarlo. El objetivo es aislar cambios, repartir tareas y revisar resultados sin que las sesiones se pisen entre sí.
¿Qué es CLAUDE.md y cómo configurarlo en Claude Code?
CLAUDE.md es el archivo de memoria compartida del repositorio para reglas, convenciones y errores que Claude no debe repetir. Anthropic recomienda colocarlo en la raíz del repo, versionarlo en git y actualizarlo cada vez que Claude haga algo incorrecto. Debe contener instrucciones accionables, no documentación genérica.
¿Cómo hacer que Claude Code verifique su propio código?
Claude Code verifica mejor cuando le das pruebas objetivas: comandos bash, suites de tests, simuladores, comprobaciones de API o navegador. Anthropic considera la verificación el consejo de mayor impacto porque permite que Claude cierre el bucle de feedback, detecte fallos e itere antes de entregarte el resultado.
¿Para qué sirve /batch en Claude Code?
/batch sirve para migraciones grandes que pueden dividirse entre varios agentes en worktrees aislados. Según Anthropic, el comando entrevista al usuario sobre la migración y reparte el trabajo entre tantos agentes como sean necesarios. Cada agente trabaja aislado, prueba sus cambios y crea una PR independiente.
¿Cómo crear skills y subagentes en Claude Code?
Las skills se crean añadiendo un archivo SKILL.md bajo .claude/skills/<name>/, según la guía de Anthropic. Para subagentes con aislamiento, puedes añadir isolation: worktree al frontmatter del agente. La regla práctica es convertir en skill cualquier flujo que repitas más de una vez al día.
