Sesiones paralelas de Claude Code: aislamiento y handoff
Un patrón para dos tareas independientes de Claude Code con worktrees, pruebas enfocadas y handoff seguro.
Índice
Sesiones paralelas de Claude Code: aislamiento y handoff
El paralelismo solo sirve para tareas separadas. Si dos cambios necesitan el mismo archivo, asígnalo a una persona y secuencia el trabajo. Para un flujo API aparte, la guía BetterToken para Claude Code usa tu propia API Key; BetterToken no es suscripción Claude.ai ni cuenta compartida.
Mapea archivos y resultado
| Tarea | Ámbito permitido | Hecho cuando |
|---|---|---|
amount vacío | parser/, tests/import/ | devuelve error de validación |
--dry-run | cmd/, tests/cli/ | muestra plan sin escribir datos |
Un archivo común detiene la ejecución paralela.
Aísla con worktrees
git status --short
git worktree add ../project-fix-empty-amount -b fix/empty-amount
git worktree add ../project-cli-dry-run -b feat/cli-dry-runNo escondas cambios ajenos. Cada worktree separa archivos y ramas; cada sesión separa contexto, pero no resuelve conflictos.
Delimita cada prompt
Indica carpetas permitidas, comportamiento prohibido y prueba: trabaja solo en parser/ y tests/import/, no cambies el formato CSV, reproduce el fallo, aplica el cambio mínimo y ejecuta la prueba. Si aparece un archivo compartido, detén la sesión y registra el bloqueador.
Usa un contrato de handoff
Task: empty amount returns validation error
Worktree / branch: ../project-fix-empty-amount / fix/empty-amount
Changed: parser/amount.ts, tests/import/empty-amount.test.ts
Verified: npm test -- tests/import/empty-amount.test.ts
Not verified: full integration suite
Next: review diff before mergeEntrega estado y comando reproducible, no el chat.
Verifica y revierte
git status --short
git diff --check
npm test -- tests/import/empty-amount.test.tsLa sesión receptora entra al worktree y repite el comando. Si no reproduce, el cambio sigue sin verificar: reviértelo o devuélvelo a su owner.
Riesgos de Git y permisos
Cuando hay solapamiento, un owner lee ambos diffs, integra la conducta y ejecuta ambas pruebas. No concedas permiso general fuera del ámbito. No pongas API keys, cookies, .env, datos personales ni logs sensibles completos en el handoff.
CTA y fuentes
Configura solo tu clave con la guía actual y entrega secretos por el mecanismo habitual.
