Claude Code en varios proyectos: cómo no trabajar nunca en el proyecto equivocado

Ejecutar Claude Code en varios proyectos solo es seguro cuando cada proyecto tiene una identidad visible propia. Una sesión por directorio es el piso, no la solución. Lo que de verdad impide actuar en el repositorio equivocado es distinguir los proyectos de un vistazo: una apariencia distinta por proyecto, agentes agrupados por proyecto y avisos que nombran el proyecto al que pertenecen. Los hechos y las conversaciones citados aquí fueron verificados el 10 de agosto de 2026.

¿Por qué no bastan las sesiones separadas de Claude Code?

Las sesiones separadas mantienen limpio el contexto del modelo, pero no protegen al operador. En un hilo de r/ClaudeAI del 9 de agosto de 2026 (la discusión, más de 30 respuestas al 10 de agosto de 2026), el autor preguntó cómo usar Claude Code en varios proyectos sin mezclarlos. La primera respuesta de la comunidad fue la obvia: una sesión por directorio de proyecto. El autor entonces corrigió la pregunta en los comentarios: el miedo no era que el modelo mezclara contextos, era escribir un prompt en el repositorio equivocado con varios proyectos parecidos abiertos, y el pedido pasó a ser cómo hacer el arreglo más a prueba de errores. Un comentarista describió haber construido una app propia con git worktrees y tmux solo para administrar ese riesgo. El dolor es tan real que la gente construye herramientas para él.

¿Cómo saber en qué proyecto estás de un vistazo?

Las pestañas de terminal son idénticas: misma fuente, mismos colores, mismo prompt. Cuando tres repositorios comparten stack y convención de nombres, lo único que separa el proyecto correcto del equivocado es la cadena del directorio actual, y nadie lee la ruta completa antes de cada prompt. Lo que funciona es identidad que el ojo capta antes de que el cerebro lea: un color de acento diferente por proyecto, el nombre del proyecto visible junto a cada agente y un espacio de trabajo que ya abre con la cara del proyecto. Si dos proyectos se ven iguales en pantalla, tarde o temprano una instrucción cae en el lugar equivocado.

¿Cómo mantener el contexto correcto al cambiar de proyecto?

Claude Code lee sus instrucciones del directorio en el que se ejecuta: CLAUDE.md, .env, credenciales y configuración de MCP vienen del directorio de trabajo. Exactamente por eso el error de directorio es silencioso: la sesión en el repositorio equivocado no falla, funciona con normalidad, siguiendo las reglas del otro proyecto. Comprobaciones prácticas: confirmar el nombre del repositorio en la primera respuesta de una sesión nueva, mantener cuentas separadas por proyecto (facturación y límites incluidos) y tratar como señal de alerta a cualquier agente que no sepa decir en qué proyecto está. Nuestra guía sobre cómo seguir a varios agentes de IA cubre el seguimiento del trabajo en sí.

¿Las codebases parecidas confunden al propio agente?

Menos de lo que te confunden a ti. El modelo solo ve los archivos del directorio donde corre la sesión; no alcanza otros repositorios por su cuenta. En la práctica, la confusión entra por la puerta humana: un prompt escrito para el proyecto A enviado a la sesión del proyecto B, un archivo arrastrado desde la ventana equivocada, una terminal reutilizada después del almuerzo. Por eso la herramienta para trabajo multiproyecto debe apuntar primero a los ojos del operador, no a la ventana de contexto del modelo.

¿Cuándo ayudan los git worktrees, y cuándo son otro problema?

Los git worktrees aíslan ramas del mismo proyecto para que varios agentes editen código sin pisarse. No resuelven el problema multiproyecto, y lo empeoran un poco: cada worktree es un directorio más, casi idéntico a los otros. Si tu riesgo es que un agente sobrescriba a otro, los worktrees son la respuesta, y nuestra guía de git worktrees para agentes de IA incluye lo que se rompe. Si tu riesgo es actuar en el proyecto equivocado, necesitas identidad visible, no más copias.

¿Qué hace CanvasCode para separar proyectos?

CanvasCode organiza el trabajo como un canvas por proyecto, con los agentes de ese proyecto agrupados en él, y entregó identidad por proyecto en tres versiones: la v1.4.0 (4 de junio de 2026) trajo una cuenta por proyecto, la v1.32.0 (9 de julio de 2026) trajo página de inicio del navegador por proyecto y la v1.37.0 (17 de julio de 2026) trajo un color para cada tema, para que cada canvas sea inconfundible. Las alertas y los anuncios nombran el proyecto del que vienen. Una limitación honesta: CanvasCode protege lo que ocurre dentro de la app; una terminal suelta abierta fuera de ella todavía puede actuar en el repositorio equivocado.