/add-dir
Descripción
¿Qué hace? /add-dir amplía el alcance de la sesión: además de la carpeta donde arrancaste Claude Code, ahora también puede leer y editar archivos del directorio que le indiques.
Caso real: imagina que estás trabajando en una web en ~/proyectos/web-cliente/ y quieres que Claude consulte la documentación que tienes en otra carpeta, ~/proyectos/docs-internas/, para extraer las especificaciones del cliente. Sin /add-dir tendrías que cerrar Claude y abrirlo de nuevo en una carpeta padre que incluya las dos. Con este comando le "prestas" el acceso a la segunda carpeta dentro de la sesión actual, sin perder el contexto que ya tienes.
Importante: la configuración interna de esa segunda carpeta (su .claude/) no se carga automáticamente — se mantiene aislada, así que no se cruzan tus reglas de un proyecto con otro.
Ejemplos de uso
Imagina que estás trabajando en una casa enorme donde cada habitación tiene herramientas distintas. Con /add-dir ../packages/ui le estás diciendo a Claude: "Oye, además de la habitación donde estoy ahora, también quiero que puedas entrar en la habitación donde están los diseños y componentes visuales". Así, Claude entiende mejor cómo están conectadas las diferentes partes del proyecto y puede ayudarte sin perder contexto.
/add-dir ../packages/uiPiensa en una carpeta llena de apuntes, normas e instrucciones importantes del proyecto. Cuando usas /add-dir ~/proyectos/docs-internas/, le das permiso a Claude para mirar esos documentos y entender mejor cómo funciona todo. Es como cuando un profesor te deja usar el libro de instrucciones completo antes de un examen: con más información, las respuestas serán más útiles y precisas.
/add-dir ~/proyectos/docs-internas/A veces un proyecto es tan grande que necesitas trabajar con varias carpetas al mismo tiempo. Por ejemplo, una con la parte del servidor y otra con los tipos de datos compartidos. Con varios comandos /add-dir, Claude puede "recordar" y usar información de distintos lugares a la vez. Es parecido a tener varias pestañas abiertas mientras haces un trabajo del instituto: una con teoría, otra con imágenes y otra con ejemplos, sin tener que cambiar constantemente.
/add-dir ../api
/add-dir ../shared-typesCuándo usarlo
Usa /add-dir cuando Claude necesite entender más partes de tu proyecto para ayudarte correctamente. Si estás creando una web y Claude solo puede ver la carpeta principal, pero el diseño está en otra, los documentos importantes en una tercera y el servidor en una cuarta, no tendrá toda la información y podría darte respuestas incompletas. Al añadir directorios con /add-dir le estás enseñando "más habitaciones de la casa" para que vea cómo encaja todo. Es como pedirle a un amigo que te ayude a montar un LEGO gigante pero solo puede ver una bolsa de piezas: necesita acceso a todas las cajas y al manual para entender de verdad cómo construirlo.