¿Usas múltiples cuentas en Claude Code? Cómo CLAUDE_CONFIG_DIR da a cada cuenta sus propias sesiones, memoria e inicio de sesión (2026)

La forma más sencilla de cambiar de cuenta es cerrar sesión e iniciarla de nuevo. Anthropic describe /logout de esta manera: "Cerrar sesión también restablece el estado de configuración del primer lanzamiento, por lo que la próxima vez que ejecutes claude, te guiará de nuevo a través del inicio de sesión y la configuración".

También puedes cambiar en medio de una sesión. La documentación del modo interactivo de Anthropic enumera "cambias de cuenta con /login" entre las formas en que una conversación cambia de manos.

Ambas rutas tienen el mismo límite. Cambian la credencial, pero siguen usando el mismo directorio de configuración, ~/.claude por defecto. Tu historial de sesiones, tu memoria automática, tus ajustes a nivel de usuario y tus plugins permanecen donde estaban. La siguiente cuenta retoma los mismos archivos locales.

Para cambios ocasionales, eso puede estar bien. Para mantener la sesión iniciada en ambas a la vez, la documentación de Anthropic describe directorios separados.

La referencia de variables de entorno de Anthropic describe CLAUDE_CONFIG_DIR como la forma de "Anular el directorio de configuración (predeterminado: ~/.claude)" y añade: "Todos los ajustes, el historial de sesiones y los plugins se almacenan bajo esta ruta".

La guía del directorio .claude es más amplia: si estableces la variable, "cada ruta ~/.claude en esta página vive bajo ese directorio en su lugar". Eso incluye .claude.json, que de otro modo se encuentra en tu directorio de inicio.

En la práctica, un directorio de configuración contiene:

• Tu inicio de sesión. Credenciales, como se describe a continuación.
• Historial de sesiones. Transcripciones bajo projects/, que --resume y /resume leen. Nuestra guía para encontrar el historial de sesiones de Claude Code cubre el diseño.
• Memoria automática. La documentación de memoria de Anthropic ubica la memoria automática de cada proyecto bajo <config dir>/projects/<project>/memory/.
• Instrucciones y ajustes a nivel de usuario. Tu CLAUDE.md de usuario, reglas de usuario y settings.json.
• Plugins. Plugins instalados y sus datos.

Los archivos del proyecto son diferentes. El CLAUDE.md, .claude/settings.json y .mcp.json de un repositorio viven en el repositorio, por lo que cada cuenta que lo abre los lee.

El ejemplo de Anthropic utiliza un alias de shell. En Bash o Zsh, añádelo a ~/.bashrc o ~/.zshrc:

alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'

Con ese alias, claude mantiene tu cuenta personal en ~/.claude, y claude-work usa tu cuenta de trabajo en ~/.claude-work. Anthropic dice que después de abrir una nueva terminal y ejecutar claude-work por primera vez, "Claude Code te guía a través del inicio de sesión y la configuración para el nuevo directorio".

Dos detalles de la documentación ayudan a que la configuración funcione:

• Usa una ruta absoluta en los archivos de configuración. "Para una variable que toma una ruta, como CLAUDE_CONFIG_DIR, escribe la ruta absoluta". Claude Code no expande ~ allí.
• No en los ajustes del proyecto. La variable se ignora en los ajustes locales y del proyecto, por lo que un repositorio no puede cambiar tu cuenta por ti.

Lo que el nuevo directorio no trae

Un nuevo directorio no contiene tus archivos existentes. Ese es el punto, pero significa que la cuenta de trabajo no ve tu CLAUDE.md personal a nivel de usuario, tus ajustes de usuario, tus plugins o la memoria automática que construiste bajo la cuenta personal. Si quieres las mismas preferencias personales en ambas, copia los archivos a nivel de usuario que necesites en el segundo directorio. Deja el historial de sesiones y la memoria automática donde están, ya que esas son las partes que querías mantener separadas.

La sección de credenciales de Anthropic explica cómo el directorio separa los inicios de sesión. En Linux y Windows, las credenciales están en .credentials.json en el directorio de configuración. En macOS, están en el Keychain (Llavero), y la variable también cambia eso: Claude Code "indexa la entrada del Keychain de macOS a ese directorio también, por lo que una sesión con un CLAUDE_CONFIG_DIR diferente lee una entrada diferente".

Así que dos directorios significan dos inicios de sesión separados, y ambos permanecen con la sesión iniciada.

El único tipo de inicio de sesión que no separa

Hay una excepción, y Anthropic la nombra. "Los directorios separados no mantienen separados dos inicios de sesión de Claude Console sin una clave API, porque Claude Code almacena ese tipo de inicio de sesión fuera del directorio de configuración".

Ese inicio de sesión de Console sin clave se almacena como un perfil de Anthropic, en un directorio de configuración de Anthropic separado. Anthropic añade un efecto secundario que vale la pena conocer antes de usarlo: "Claude Code cierra la sesión de cualquier inicio de sesión de claude.ai almacenado en la máquina". Si mezclas un inicio de sesión de Console sin clave con inicios de sesión de claude.ai, verifica /status después de cada inicio de sesión.

Una clave API puede anular tu suscripción

Las credenciales tienen un orden. Si ANTHROPIC_API_KEY está configurada en tu entorno, tiene prioridad sobre el inicio de sesión de suscripción de /login. Anthropic advierte: "Si tienes una suscripción activa a Claude pero también tienes ANTHROPIC_API_KEY configurada en tu entorno, Claude Code usa la clave API una vez que la apruebas". Ejecuta /status para ver qué credencial está en uso; cuando ambas están configuradas, marca la que no se está usando.

Configurar un segundo directorio no mueve nada. Las sesiones que ejecutaste antes de la división permanecen en el directorio en el que se guardaron, por defecto ~/.claude, junto con su memoria automática.

Por lo tanto, si usaste tu cuenta de trabajo en ~/.claude durante un tiempo y luego creaste ~/.claude-work, las antiguas sesiones de trabajo todavía están bajo el directorio personal. Para reanudar una, inicia Claude Code con el directorio que la contiene. La guía de sesiones de Anthropic señala que dentro de un directorio de configuración, presionar Ctrl+A en el selector de sesiones enumera las sesiones de cada directorio de proyecto bajo él, lo cual ayuda cuando no recuerdas dónde se ejecutó una sesión.

La retención también es por directorio. Claude Code elimina las transcripciones antiguas después del número de días en cleanupPeriodDays, 30 por defecto. Si lo estableces en tus ajustes de usuario, ese archivo pertenece a un directorio. Establécelo de nuevo en los ajustes de usuario del otro directorio, o las sesiones antiguas de la segunda cuenta se limpiarán según el programa predeterminado.

VS Code

Un alias de shell solo cambia el comando que escribes en una terminal, por lo que no llega a la extensión. Puedes establecer la variable en el ajuste environmentVariables de la extensión, con una regla: "Una entrada CLAUDE_CONFIG_DIR se aplica solo cuando su valor es una ruta absoluta; la extensión no expande ~ e ignora un valor relativo". La extensión también tiene una pantalla de Cambiar cuenta; su registro de cambios menciona un botón de Cancelar que regresa a tu sesión como la cuenta actual.

Claude Desktop

Las sesiones locales de Code en Desktop leen los mismos archivos de configuración que la CLI. Para apuntar Desktop a un directorio diferente, Anthropic dice que se debe establecer CLAUDE_CONFIG_DIR en uno de los lugares donde establecerías una variable para servidores de desarrollo, luego cerrar y volver a abrir Desktop. Las versiones recientes corrigieron dos problemas que aparecían cuando la terminal y la aplicación de escritorio tenían sesiones iniciadas en cuentas diferentes, así que mantén ambas actualizadas si las ejecutas de esa manera.

Sesiones en la nube

Las sesiones en la nube pertenecen a tu cuenta de claude.ai. "Las sesiones en la nube siempre usan tus credenciales de suscripción". Moverlas entre la nube y la terminal requiere la misma cuenta en ambos lados; para el teleport, el requisito de Anthropic es: "Debes estar autenticado en la misma cuenta de claude.ai utilizada en la sesión en la nube". Si teletransportas una sesión de trabajo, inicia Claude Code con el directorio de la cuenta de trabajo primero. Nuestra guía sobre por qué Claude Code olvida entre máquinas cubre lo que transportan las sesiones en la nube.

Cerrar e iniciar sesión cada vez. Funciona, pero mantiene un solo directorio de configuración, por lo que ambas cuentas comparten el historial local y la memoria automática.

Esperar que /login borre las sesiones de la cuenta anterior. Cambia la credencial. Las transcripciones permanecen en el mismo directorio.

Usar una ruta relativa. Los archivos de configuración y la extensión de VS Code necesitan una ruta absoluta para CLAUDE_CONFIG_DIR.

Separar dos inicios de sesión de Console sin clave con directorios. Anthropic dice que los directorios no los mantienen separados.

Dejar ANTHROPIC_API_KEY configurada. Una vez aprobada, gana sobre tu inicio de sesión de suscripción.

Paso 1: Decide qué debe estar separado

Decide qué partes deben estar separadas, como el historial de sesiones, la memoria automática y los inicios de sesión, y cuáles deben coincidir, como tus preferencias personales. Anota qué archivos caen en cada grupo antes de configurar nada.

Paso 2: Crea el segundo directorio y el alias

Añade un alias como el ejemplo de Anthropic, abre una nueva terminal y ejecútalo una vez para iniciar sesión en la segunda cuenta. En VS Code y Desktop, establece la misma ruta absoluta donde cada uno lee las variables de entorno.

Paso 3: Copia las preferencias compartidas, no el historial

Copia el CLAUDE.md de nivel de usuario y los ajustes que quieras en ambos. Mantén la carpeta de proyectos separada, ya que contiene las transcripciones y la memoria automática de cada cuenta. Nuestra guía sobre worktrees y memoria de Claude Code explica cómo la memoria automática se indexa a un repositorio.

Los directorios separados mantienen las sesiones y la memoria automática de cada cuenta aparte. El costo es que parte del contexto que quieres en ambos, como tus convenciones o el estado de un proyecto de larga duración, ahora vive en solo uno de ellos.

MemoryLake es una capa de memoria para mantener esos hechos compartidos en un solo lugar que tú mantienes, disponible para los asistentes que conectes, como ChatGPT, Claude Code y Codex.

Tú mismo escribes las entradas, con tus propias palabras. No se lee nada de, ni se escribe en, ni se elimina de tus directorios de configuración, tus sesiones de Claude Code, tus archivos CLAUDE.md, tu memoria automática, tus credenciales o el almacén de cualquier proveedor. CLAUDE_CONFIG_DIR y los inicios de sesión de Claude Code siguen funcionando de la manera que Anthropic los describe.

Paso 1: Crea una clave API

Inicia sesión y genera una clave desde el panel de control. La clave pertenece a tu espacio de trabajo de MemoryLake y es independiente de tus cuentas de Claude.

Paso 2: Sube tus primeras memorias

Comienza con las preferencias compartidas del Paso 1 de la solución, además de cualquier decisión de proyecto que ambas cuentas necesiten. Un punto por entrada, y verifica el contenido de trabajo con la política de tu empresa primero.

Paso 3: Conecta tu IA y agentes

Conecta Claude Code bajo cada cuenta, y cualquier otro asistente que uses. Las mismas entradas estarán disponibles independientemente del directorio desde el que comiences.

La primera diferencia es que ya no hay que cerrar sesión. Cada cuenta permanece con la sesión iniciada, y el alias que escribes elige la cuenta.

La segunda es una separación real. Las sesiones de trabajo y la memoria automática de trabajo permanecen en el directorio de trabajo, y las personales permanecen en el tuyo.

La tercera es menos duplicación. Los hechos que necesitas bajo ambas cuentas no se copian a mano en dos juegos de archivos. Si también usas Codex, nuestra guía sobre cómo usar Claude Code y Codex juntos cubre el intercambio de contexto entre herramientas.

Un directorio por cuenta. Establece CLAUDE_CONFIG_DIR cuando inicies Claude Code.

Usa rutas absolutas fuera del shell. Los archivos de configuración y VS Code no expanden ~.

Verifica /status después de cambiar. Muestra la cuenta y la credencial en uso.

Elimina claves API extraviadas. Una ANTHROPIC_API_KEY aprobada tiene prioridad sobre tu suscripción.

No confíes en los directorios para inicios de sesión de Console sin clave. Se almacenan fuera del directorio.

Coincide la cuenta para el trabajo en la nube. Teleport necesita la misma cuenta de claude.ai.

Cuidado con las sesiones antiguas. Reanudar una sesión inactiva durante mucho tiempo puede consumir mucho de tu límite; nuestra guía sobre la advertencia de uso al reanudar explica por qué.

Claude Code cambia de cuenta con /logout y /login, pero eso mantiene un solo directorio de configuración, por lo que ambas cuentas comparten el historial local y la memoria automática. Para mantener la sesión iniciada en ambas y mantenerlas separadas, la respuesta de Anthropic es un CLAUDE_CONFIG_DIR separado por cuenta. Cada directorio tiene sus propios ajustes, historial de sesiones e inicio de sesión, y en macOS su propia entrada en el Keychain.

Presta atención a las excepciones: inicios de sesión de Console sin clave, una ANTHROPIC_API_KEY en tu entorno y la regla de ruta absoluta en VS Code y archivos de configuración. Mantén el contexto que necesitas bajo ambas cuentas en algún lugar que ningún directorio posea.