Claude Code permite nombrar el directorio del proyecto para centralizar sesiones
Con la variable CLAUDE_CODE_PROJECT_DIR_NAME, los usuarios pueden fijar un nombre fijo al directorio de proyecto, evitando la fragmentación de sesiones por rutas distintas.
Claude Code, la extensión de IA para edición de código, ha introducido la variable de entorno CLAUDE_CODE_PROJECT_DIR_NAME para resolver un problema recurrente: cada vez que el directorio de trabajo cambia, ya sea por usar otra máquina, una rama distinta o un git worktree, la herramienta crea un nuevo directorio de proyecto y las sesiones se dispersan. La solución es simple y poderosa: asignar manualmente un nombre a la carpeta de proyecto.
¿Qué pasa con la ruta por defecto?
Por defecto, los archivos de transcripción se guardan en
<config dir>/projects/<project>/<session-id>.jsonl donde <project> es la ruta absoluta del directorio de trabajo, con los caracteres no alfanuméricos sustituidos por guiones. Si un repositorio tiene varias ramas o worktrees, cada uno generará una carpeta distinta, lo que complica el rastreo de conversaciones. Además, la misma ruta en otra máquina se considera un proyecto diferente.
Cómo fijar un nombre propio
Para usar la nueva variable es necesario:
- Establecer CLAUDE_CONFIG_DIR (por ejemplo
~/.claude). - Definir CLAUDE_CODE_PROJECT_DIR_NAME con un nombre de 1–64 caracteres, que puede contener letras, dígitos, guiones y guiones bajos.
- Exportar la variable en el entorno del shell que lanza Claude Code; no se lee desde
settings.json.
Con esto, Claude escribe tanto las transcripciones como la memoria en:
<config dir>/projects/<name>/<session-id>.jsonl y
<config dir>/projects/<name>/memory/.
Automatización con direnv
El reto es que la variable debe cambiar según el repositorio. Direnv lo resuelve cargando variables al entrar en un directorio y liberándolas al salir. Se crea un .envrc en la raíz del repositorio con:
export CLAUDE_CONFIG_DIR=~/.claude
export CLAUDE_CODE_PROJECT_DIR_NAME=scenee-blog
Direnv bloquea por defecto la ejecución de .envrc, por lo que al guardarlo se debe ejecutar direnv allow. Cada máquina requiere esta aprobación, y los worktrees creados manualmente también.
Resultados
Con la variable configurada, todas las sesiones de Claude dentro de ese repositorio, sin importar la máquina o el worktree, se guardan en el mismo directorio scenee-blog. Esto facilita el compartir sesiones a través de Dropbox y volver a abrir conversaciones antiguas sin tener que buscar entre cientos de carpetas de ruta.
Próximos pasos
Claude Code ya soporta la variable desde la versión 2.1.234, lanzada el 17 de agosto de 2026. Los administradores que usan la herramienta en entornos multimonte o con worktrees deberían considerar adoptar esta configuración para mantener un historial coherente y evitar la fragmentación de datos.
