Explorar el directorio .claude

Dónde Claude Code lee CLAUDE.md, settings.json, hooks, skills, commands, subagents, workflows, rules y auto memory. Explore el directorio .claude en su proyecto y ~/.claude en su directorio de inicio.

Claude Code lee instrucciones, configuración, skills, subagents y memoria desde su directorio de proyecto y desde ~/.claude en su directorio de inicio. Confirme archivos de proyecto en git para compartirlos con su equipo; los archivos en ~/.claude son configuración personal que se aplica en todos sus proyectos.

En Windows, ~/.claude se resuelve a %USERPROFILE%\.claude. Si estableces CLAUDE_CONFIG_DIR, cada ruta ~/.claude en esta página se ubica en ese directorio en su lugar. Lo mismo se aplica a .claude.json, que de lo contrario se encuentra en ~/.claude.json.

La mayoría de los usuarios solo editan CLAUDE.md y settings.json. Si tu repositorio ya tiene un AGENTS.md para otros agentes de codificación, Claude Code puede leerlo en lugar de un CLAUDE.md. El resto del directorio es opcional: agrega skills, reglas o subagentes según los necesites.

Explorar el directorio

Haga clic en los archivos del árbol para ver qué hace cada uno, cuándo se carga y un ejemplo.

Lo que no se muestra

El explorador cubre los archivos que usted crea y edita. Algunos archivos relacionados se encuentran en otros lugares:

~/.claude también contiene datos que Claude Code escribe mientras usted trabaja: transcripciones, historial de indicaciones, instantáneas de archivos, cachés y registros. Consulte datos de la aplicación a continuación.

Elegir el archivo correcto

Diferentes tipos de personalización viven en diferentes archivos. Use esta tabla para encontrar dónde pertenece un cambio.

Referencia de archivos

Esta tabla enumera todos los archivos que cubre el explorador. Los archivos de alcance de proyecto viven en su repositorio bajo .claude/ (o en la raíz para CLAUDE.md, .mcp.json y .worktreeinclude). Los archivos de alcance global viven en ~/.claude/ y se aplican en todos los proyectos.

[!NOTE]

Varias cosas pueden anular lo que coloque en estos archivos:

• La configuración administrada implementada por tu organización tiene precedencia sobre todos los archivos de configuración y cualquier valor de --settings, aparte de las excepciones bajo Precedencia de configuración
• Las banderas CLI como --permission-mode o --settings anulan settings.json para esa sesión
• Algunas variables de entorno tienen precedencia sobre su configuración equivalente, pero esto varía: consulte la referencia de variables de entorno para cada una

Consulte precedencia de configuración para el orden completo.

Haga clic en un nombre de archivo para abrir ese nodo en el explorador anterior.

Campos de frontmatter por archivo

Las skills, archivos de comandos, subagentes, estilos de salida y reglas leen su configuración desde frontmatter YAML en la parte superior del archivo, y cada uno acepta su propio conjunto de campos. Esta tabla enumera los nombres de los campos para cada archivo y vincula a la referencia que los describe.

Los agentes incluidos en un plugin respetan un subconjunto de los campos de subagente.

Solucionar problemas de configuración

Si una configuración, hook o archivo no está surtiendo efecto, consulte Depurar su configuración para los comandos de inspección y una tabla de búsqueda por síntoma.

Datos de aplicación

Más allá de la configuración que usted crea, ~/.claude contiene datos que Claude Code escribe durante las sesiones. Estos archivos son texto sin formato. Cualquier cosa que pase a través de una herramienta aterriza en una transcripción en disco: contenidos de archivos, salida de comandos, texto pegado.

La transcripción también puede contener lo que Claude Code envía al modelo junto con tus mensajes:

• El prompt del sistema
• Las definiciones de herramientas
• Los parámetros de la solicitud
• Los archivos de instrucciones que cargó, como CLAUDE.md

Limpiados automáticamente

Claude Code elimina los archivos en las rutas a continuación una vez que tienen más de cleanupPeriodDays, siempre que pueda determinar de forma segura el período de retención. El valor predeterminado es 30 días y el mínimo es 1; establecer 0 falla con un error de validación. El mismo límite de edad se aplica a la eliminación automática de worktrees huérfanos.

Los archivos de sesión en sessions/, memoria automática, y transcripciones de Claude Desktop y Cowork cada uno sigue su propia regla de retención:

• sessions/: contiene un archivo pequeño por sesión en ejecución, utilizado para detectar sesiones concurrentes y bloqueos. No es parte del barrido basado en edad: Claude Code elimina cada archivo cuando su sesión sale y borra restos de bloqueos en el próximo lanzamiento.

• Memoria automática: el barrido no elimina los archivos de memoria en el directorio de memoria automática de un proyecto, projects/<project>/memory/. Claude Code elimina ese directorio solo si ha estado vacío durante todo el período de retención. Antes de v2.1.228, el barrido trataba las carpetas dentro del directorio de memoria como datos de sesión y podía eliminar archivos antiguos debajo de él.

• Transcripciones de Claude Desktop y Cowork: Claude Code mantiene la transcripción de una sesión que iniciaste o continuaste más recientemente en Claude Desktop o Cowork a cualquier edad. Para dar a estas transcripciones un límite de edad, establece desktopSessionCleanupPeriodDays. Requiere Claude Code v2.1.248 o posterior; las versiones anteriores las eliminan después de cleanupPeriodDays.

  En cambio, Claude Code elimina estas transcripciones después de cleanupPeriodDays en cualquiera de estos casos:

  • La configuración administrada establece cleanupPeriodDays
  • La configuración HIPAA se aplica a tus sesiones

Claude Code omite el barrido basado en edad en estos casos:

• Bare mode: cuando ejecuta claude -p con --bare, Claude Code no ejecuta el barrido en esa sesión.
• Barrido pausado: si Claude Code no puede determinar de forma segura el período de retención, pausa el barrido de limpieza de retención; el evento retention_sweep enumera cada configuración que lo pausa. Cuando la causa es un archivo de configuración que no se puede leer o analizar, o errores de configuración con cleanupPeriodDays o desktopSessionCleanupPeriodDays explícitamente establecidos, Claude Code también muestra una advertencia en /status hasta que corrija los errores de configuración. Cuando configuración administrada por servidor proporciona cleanupPeriodDays, Claude Code ejecuta el barrido en el valor administrado en cualquier caso.

Para verificar que las máquinas de tu organización ejecutan el barrido con el período de retención que estableciste, consulta Verificar el barrido de retención.

Directorio de bloc de notas de sesión

El bloc de notas es un directorio por sesión que Claude Code proporciona a Claude para archivos temporales: resultados intermedios, scripts auxiliares y borradores que no pertenecen a su proyecto. Cuando Claude dice que guardó algo "en el bloc de notas", el archivo está allí. Claude lo usa en lugar de /tmp, y puede crear, editar y leer archivos en él sin un mensaje de permiso.

El bloc de notas vive bajo el directorio temporal de Claude Code en lugar de ~/.claude. Encuentre la ruta de la sesión actual para su plataforma:

• macOS: /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
• Linux: /tmp/claude-<uid>/<project>/<session-id>/scratchpad/, o la misma forma bajo $TMPDIR cuando su sistema establece uno
• Windows: %TEMP%\claude\<project>\<session-id>\scratchpad\

<project> es la ruta de su directorio de trabajo con cada carácter que no sea letra o dígito reemplazado por -, como -Users-you-my-project. Si establece CLAUDE_CODE_TMPDIR, el árbol se mueve bajo ese directorio en su lugar. Los hooks reciben la ruta de la sesión actual como scratchpad_dir.

Los archivos del bloc de notas duran tanto como la transcripción de la sesión: el barrido de retención elimina el directorio cuando elimina la transcripción, y claude purge no toca el directorio temporal. Debido a que el directorio se encuentra bajo la ubicación temporal del sistema, tu sistema operativo también puede borrarlo, como al reiniciar. Para conservar algo que Claude escribió allí, pide a Claude que lo mueva a tu proyecto.

Una sesión tiene un bloc de notas solo cuando se cumplen todos estos:

• Está conectado con una cuenta de claude.ai en lugar de una clave API
• La sesión usa la API de Anthropic, no Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry
• enableArtifact no está establecido en false

Mantenidos hasta que los elimine

Salvo las filas que indican lo contrario, el barrido de limpieza de retención no elimina las rutas a continuación, y Claude Code las mantiene hasta que las elimines.

Archivos de estado que debes conservar

Según las características que uses, ~/.claude/ también contiene archivos que las tablas en Datos de aplicación no enumeran. De ellos, las cachés y los archivos de bloqueo son seguros de eliminar. Conserva estos archivos de estado:

• .credentials.json: sus credenciales de inicio de sesión
• agent-memory/: memoria de subagente
• jobs/ y daemon/: estado de sesión en segundo plano

Almacenamiento de texto sin formato

Las transcripciones e historial no están encriptados en reposo. Los permisos de archivo del SO son la única protección. Si una herramienta lee un archivo .env o un comando imprime una credencial, ese valor se escribe en projects/<project>/<session>.jsonl. Para reducir la exposición:

• Reduzca cleanupPeriodDays para acortar cuánto tiempo Claude Code mantiene las transcripciones
• Establezca desktopSessionCleanupPeriodDays para dar también un límite de edad a las transcripciones de Claude Desktop y Cowork
• Establezca la variable de entorno CLAUDE_CODE_SKIP_PROMPT_HISTORY para omitir la escritura de transcripciones e historial de prompts en cualquier modo. En modo no interactivo, puede pasar --no-session-persistence junto con -p, o establecer persistSession: false en el Agent SDK de TypeScript; el SDK de Python no tiene opción equivalente.
• Use reglas de permisos para denegar lecturas de archivos de credenciales

Borrar datos locales

Ejecuta claude purge para eliminar el estado que Claude Code mantiene para un proyecto. Elimina:

• Transcripciones y memoria automática bajo projects/
• Entradas por sesión de tasks/, debug/ y file-history/
• Líneas de prompt coincidentes en history.jsonl
• La entrada del proyecto en ~/.claude.json

Las imágenes que pegó o adjuntó en las sesiones del proyecto y el bloc de notas de cada sesión se almacenan bajo el directorio temporal de Claude Code en lugar de ~/.claude, por lo que la purga no las elimina. El barrido de retención aún elimina las imágenes una vez que tienen más de cleanupPeriodDays; el bloc de notas de una sesión purgada permanece hasta que lo elimine o su sistema operativo borra el directorio temporal.

El comando imprime el plan de eliminación completo y solicita confirmación antes de eliminar cualquier cosa.

Antes de v2.1.288, el comando era claude project purge.

Los ejemplos a continuación usan ~/work/my-repo como marcador de posición. Reemplácelo con la ruta a su proyecto. Si ningún estado coincide con la ruta, el comando imprime un error y sale con estado 1.

Obtenga una vista previa del plan sin eliminar nada:

claude purge ~/work/my-repo --dry-run

El plan enumera cada elemento coincidente y por qué se incluye:

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

Elimine con un único mensaje de confirmación:

claude purge ~/work/my-repo

El comando imprime el mismo plan, luego pregunta Delete 3 item(s) for /home/user/work/my-repo? This cannot be undone. [y/N] y elimina solo si responde y.

Omita la ruta para elegir un proyecto de una lista interactiva.

Omita el mensaje de confirmación para usar en scripts:

claude purge ~/work/my-repo --yes

Otras opciones:

• Pasa --all en lugar de una ruta para purgar el estado de cada proyecto a la vez, lo que elimina history.jsonl directamente en lugar de filtrarlo.
• Pasa -i para recorrer el plan de eliminación un elemento a la vez.

El comando deja shell-snapshots/ y backups/ intactos porque no están limitados al proyecto, y advierte sobre ellos en la salida del plan. Si alguien ejecutó /heapdump en la máquina, elimina también los archivos .heapsnapshot que escribió. Una instantánea del heap contiene la conversación completa y cualquier credencial que tuviera el proceso, y ni el barrido de retención ni la purga la tocan.

También puedes eliminar tú mismo cualquiera de las rutas de datos de aplicación anteriores, aparte de los archivos de estado que debes conservar.

No elimines ~/.claude.json, ~/.claude/settings.json ni ~/.claude/plugins/: esos contienen los datos de tu cuenta, tus preferencias y tus plugins instalados.

Recursos relacionados

• Manage Claude's memory: escriba y organice CLAUDE.md, rules y auto memory
• Configure settings: establezca permisos, hooks, variables de entorno y valores predeterminados de modelo
• Create skills: construya prompts y flujos de trabajo reutilizables
• Configure subagents: defina agentes especializados con su propio contexto