Explorar el directorio .claude

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 establece CLAUDE_CONFIG_DIR, cada ruta ~/.claude en esta página vive bajo ese directorio en su lugar. La mayoría de los usuarios solo editan CLAUDE.md y settings.json. Si su repositorio ya tiene un AGENTS.md para otros agentes de codificación, Claude Code puede leerlo por su cuenta o junto con CLAUDE.md. El resto del directorio es opcional: agregue skills, rules o subagents según sea necesario.

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:

Archivo	Ubicación	Propósito
`managed-settings.json`	Nivel del sistema, varía según el SO	Configuración impuesta por la empresa que no puede anular, excepto por excepciones limitadas. Consulte dónde guardar el archivo y qué fuente administrada utiliza Claude Code.
`CLAUDE.local.md`	Raíz del proyecto	Sus preferencias privadas para este proyecto, cargadas junto con CLAUDE.md. Créelo manualmente y agréguelo a `.gitignore`.
`AGENTS.md`	Raíz del proyecto, `.claude/`, o cualquier directorio	Instrucciones del proyecto que usted escribe para agentes de codificación de IA. Claude Code puede cargarlo por su cuenta o junto con `CLAUDE.md`.
Plugins instalados	`~/.claude/plugins`	Mercados clonados, versiones de plugins instalados, el registro de instalación `installed_plugins.json`, y datos por plugin, administrados por comandos `claude plugin`. Los plugins sincronizados desde su cuenta claude.ai se descargan en `~/.claude/plugins/synced/`. Para un plugin instalado desde un mercado con fuente `command` en modo de enlace, Claude Code almacena enlaces aquí en lugar de una copia, y los archivos del plugin permanecen en el directorio que imprime el comando. Una fuente `command` requiere Claude Code v2.1.229 o posterior. Un plugin listado por ruta relativa en un mercado de directorio local también se carga en su lugar desde su directorio de origen en lugar de desde una copia en caché. Consulte almacenamiento en caché de plugins para saber cómo se limpian las versiones huérfanas.

~/.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.

Usted quiere	Editar	Alcance	Referencia
Dar a Claude contexto del proyecto y convenciones	`CLAUDE.md`	proyecto o global	Memory
Permitir o bloquear llamadas de herramientas específicas	`settings.json` `permissions` o `hooks`	proyecto o global	Permissions, Hooks
Ejecutar un script antes o después de llamadas de herramientas	`settings.json` `hooks`	proyecto o global	Hooks
Establecer variables de entorno para la sesión	`settings.json` `env`	proyecto o global	Settings
Mantener anulaciones personales fuera de git	`settings.local.json`	solo proyecto	Settings scopes
Agregar un prompt o capacidad que invoque con `/name`	`skills/<name>/SKILL.md`	proyecto o global	Skills
Definir un subagent especializado con sus propias herramientas	`agents/*.md`	proyecto o global	Subagents
Orquestar muchos subagents desde un script	`workflows/*.js`	proyecto o global	Dynamic workflows
Conectar herramientas externas sobre MCP	`.mcp.json`	solo proyecto	MCP
Cambiar cómo Claude formatea respuestas	`output-styles/*.md`	proyecto o global	Output styles

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.

Varias cosas pueden anular lo que coloque en estos archivos:

Configuración administrada implementada por su organización tiene precedencia sobre todo, 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.

Archivo	Alcance	Confirmar	Qué hace	Referencia
`CLAUDE.md`	Proyecto y global	✓	Instrucciones cargadas cada sesión	Memoria
`rules/*.md`	Proyecto y global	✓	Instrucciones con alcance temático, opcionalmente restringidas por ruta	Reglas
`settings.json`	Proyecto y global	✓	Permisos, hooks, variables de entorno, valores predeterminados de modelo	Configuración
`settings.local.json`	Solo proyecto		Sus anulaciones personales, ignoradas por git cuando Claude Code guarda una configuración en ella	Alcances de configuración
`.mcp.json`	Solo proyecto	✓	Servidores MCP compartidos por el equipo	Alcances de MCP
`.worktreeinclude`	Solo proyecto	✓	Archivos ignorados por git para copiar en nuevos worktrees	Worktrees
`skills/<name>/SKILL.md`	Proyecto y global	✓	Prompts reutilizables invocados con `/name` o invocados automáticamente	Skills
`commands/*.md`	Proyecto y global	✓	Prompts de un solo archivo; mismo mecanismo que skills	Skills
`output-styles/*.md`	Proyecto y global	✓	Conjuntos de instrucciones personalizadas que ajustan cómo funciona Claude	Estilos de salida
`agents/*.md`	Proyecto y global	✓	Definiciones de subagentes con su propio prompt y herramientas	Subagentes
`workflows/*.js`	Proyecto y global	✓	Scripts de flujo de trabajo dinámicos escritos por Claude y guardados desde `/workflows`; cada archivo se convierte en un comando `/<name>`	Flujos de trabajo dinámicos
`agent-memory/<name>/`	Proyecto y global	✓	Memoria persistente para subagentes	Memoria persistente
`~/.claude.json`	Solo global		Estado de la aplicación, OAuth, alternancias de interfaz de usuario, servidores MCP personales	Configuración global
`projects/<project>/memory/`	Solo global		Memoria automática: notas de Claude para sí mismo en todas las sesiones	Memoria automática
`keybindings.json`	Solo global		Atajos de teclado personalizados	Atajos de teclado
`themes/*.json`	Solo global		Temas de color personalizados	Temas personalizados

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.

Archivo	Campos de frontmatter	Referencia
`skills/<name>/SKILL.md`	`name`, `description`, `when_to_use`, `argument-hint`, `arguments`, `disable-model-invocation`, `user-invocable`, `allowed-tools`, `disallowed-tools`, `model`, `effort`, `context`, `agent`, `background`, `hooks`, `paths`, `shell`, `metadata`, `license`, `compatibility`	Frontmatter de skill
`commands/*.md`	Los campos de skill excepto `name` y `paths`	Frontmatter de skill
`agents/*.md`	`name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experimental`	Frontmatter de subagente
`output-styles/*.md`	`name`, `description`, `keep-coding-instructions`, `force-for-plugin`	Frontmatter de estilo de salida
`rules/*.md`	`paths`	Frontmatter de regla

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.

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.

Ruta bajo `~/.claude/`	Contenidos
`projects/<project>/<session>.jsonl`	Transcripción de conversación completa: cada mensaje, llamada de herramienta y resultado de herramienta
`projects/<project>/<session>.orphaned-<timestamp>-<suffix>.jsonl`, `projects/<project>/<session>.jsonl.superseded-<timestamp>`	Una transcripción anterior para la sesión que Claude Code apartó en lugar de sobrescribir o eliminar. No aparece en el selector de sesiones
`projects/<project>/<session>/subagents/`	Transcripciones de conversación de subagente, eliminadas con la transcripción de sesión principal cuando vence
`projects/<project>/<session>/tool-results/`	Salidas de herramientas grandes derramadas en archivos separados, y copias de tamaño completo de imágenes que devuelven las herramientas MCP
`file-history/<session>/`	Instantáneas previas a la edición de archivos que Claude cambió, utilizadas para restauración de checkpoint. Contiene instantáneas para los 100 checkpoints más recientes; los archivos de instantánea que ningún checkpoint retenido referencia se eliminan, excepto la primera instantánea de cada archivo
`plans/`	Archivos de plan escritos durante Plan Mode
`debug/`	Registros de depuración por sesión, escritos mientras el registro de depuración está activado, como cuando comienza con `--debug` o ejecuta `/debug`
`paste-cache/`	Contenidos de pastes grandes
`image-cache/<session>/`	Imágenes adjuntas guardadas por Claude Code v2.1.274 y anteriores. Las versiones posteriores guardan imágenes pegadas y adjuntas fuera de `~/.claude`, en un directorio `images/` para cada sesión bajo el directorio temporal que `CLAUDE_CODE_TMPDIR` controla. El barrido elimina los directorios sobrantes de otras sesiones aquí, sin importar su edad.
`uploads/<session>/`	Archivos que adjunta desde la web o aplicación móvil, y fotos que adjunta desde la aplicación móvil, al enviar mensajes a una sesión de Remote Control. Un adjunto a una sesión en la nube se guarda en el propio entorno en la nube de esa sesión, no en su máquina.
`session-env/`	Metadatos de entorno por sesión
`tasks/`	Listas de tareas escritas por las herramientas de tareas, un directorio por lista
`shell-snapshots/`	Alias, funciones y opciones de shell capturadas al inicio y aplicadas por la herramienta Bash a cada comando. Se elimina al salir correctamente. El barrido borra cualquiera dejado después de un bloqueo.
`backups/`	Versiones anteriores de `~/.claude.json`, copiadas cuando Claude Code reescribe el archivo. Claude Code mantiene los cinco más nuevos, más una copia de cualquier versión que no pudiera analizar.
`feedback-bundles/`	Archivos de transcripción redactados escritos por `/feedback` en proveedores de terceros o cuando no hay credenciales de Anthropic configuradas, para enviar a su equipo de cuenta de Anthropic
`feedback/drafts/`	Comentarios redactados por Claude en cola esperando su revisión en `/feedback`. Se barren después de `cleanupPeriodDays` o 30 días, lo que sea más corto. Cuando la cola está en su límite de 10 borradores, Claude Code elimina el borrador más antiguo para hacer espacio.
`usage-data/`	`report.html` y copias de informes con marca de tiempo escritas por `/insights`, más datos de análisis en caché por sesión utilizados para construirlos
`skills/.trash/`, `plugins/.trash/`	Skills y plugins que la sincronización de claude.ai eliminó, como después de desactivar uno en claude.ai o dejar de sincronizar. Los archivos permanecen aquí para que pueda recuperarlos hasta que el barrido los elimine
`todos/`, `statsig/`, `logs/`	Directorios heredados de versiones anteriores. Ya no se escriben. El barrido elimina su contenido y luego el directorio vacío.

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 inició o continuó más recientemente en Claude Desktop o Cowork a cualquier edad. Para dar a estas transcripciones un límite de edad, establezca desktopSessionCleanupPeriodDays. Cuando configuración administrada establece cleanupPeriodDays, Claude Code elimina estas transcripciones después de ese período en su lugar. Requiere Claude Code v2.1.248 o posterior; las versiones anteriores las eliminan después de cleanupPeriodDays.

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.

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 project purge no toca el directorio temporal. Debido a que el directorio se encuentra bajo la ubicación temporal del sistema, su sistema operativo también puede borrarlo, como al reiniciar. Para mantener algo que Claude escribió allí, pida a Claude que lo mueva a su 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

El barrido de limpieza de retención no elimina las rutas a continuación. Claude Code los mantiene hasta que los elimine, aparte de los dos cachés que elimina cuando cierra sesión.

Ruta bajo `~/.claude/`	Contenidos
`history.jsonl`	Cada prompt que ha escrito, con marca de tiempo y ruta del proyecto. Utilizado para recuperación de flecha hacia arriba, búsqueda de historial `Ctrl+R` y finalización de comando shell `!`.
`stats-cache.json`	Conteos de tokens y costos agregados mostrados por `/usage`
`remote-settings.json`	Copia en caché de configuración administrada por servidor para su organización, o `{}` cuando su organización no ha configurado ninguna. Solo presente cuando la sesión las obtiene. Claude Code verifica actualizaciones al inicio y cada hora durante una sesión. Claude Code lo elimina cuando cierra sesión.
`cache/changelog.md`	Copia en caché del registro de cambios de Claude Code, mostrada por `/release-notes`. Se actualiza en segundo plano.
`policy-limits.json`	Configuración de política de características en caché para su organización. Solo presente para algunos tipos de cuenta. Se actualiza automáticamente. Un archivo sidecar `policy-limits.json.stamp.json` registra a qué cuenta o clave API pertenece el caché. Claude Code elimina ambos archivos cuando cierra sesión.

Otros archivos aparecen dependiendo de qué características use. Los cachés y archivos de bloqueo son seguros de eliminar. Mantenga 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

Ejecute claude project 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. 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 project 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 project 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 project purge ~/work/my-repo --yes

Pase --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. Pase -i para recorrer el plan de eliminación un elemento a la vez. El comando deja shell-snapshots/ y backups/ solos porque no están limitados al proyecto, y advierte sobre ellos en la salida del plan. También puede eliminar cualquiera de las rutas de datos de aplicación anteriores manualmente, aparte de los archivos de estado a mantener. Las nuevas sesiones no se ven afectadas. La tabla a continuación muestra qué pierde para sesiones pasadas.

Eliminar	Pierde
`~/.claude/projects/`	Reanudar, continuar y rebobinar para sesiones pasadas, y memoria automática para cada proyecto
`~/.claude/history.jsonl`	Recuperación de prompt de flecha hacia arriba, búsqueda de historial `Ctrl+R` y finalización de comando shell `!`
`~/.claude/paste-cache/`	Texto pegado en prompts recordados; vea pegar contenido grande
`~/.claude/uploads/`	Adjuntos a los que sesiones pasadas de Remote Control se refieren por ruta
`~/.claude/file-history/`	Restauración de checkpoint para sesiones pasadas
`~/.claude/stats-cache.json`	Totales históricos mostrados por `/usage`
`~/.claude/usage-data/`	Informes pasados de `/insights` y los datos de análisis en caché utilizados para construirlos
`~/.claude/feedback-bundles/`	Comentarios y archivos de informes de errores que aún no ha enviado a su equipo de cuenta de Anthropic
`~/.claude/feedback/drafts/`	Comentarios redactados por Claude que no ha enviado
`~/.claude/remote-settings.json`	Nada. Se vuelve a obtener en el próximo inicio.
`~/.claude/cache/changelog.md`	Nada. Se actualiza en segundo plano.
`~/.claude/policy-limits.json`	Nada. Se actualiza automáticamente.
`~/.claude/tasks/`	Listas de tareas que una sesión reanudada recogería
`~/.claude/skills/.trash/`, `~/.claude/plugins/.trash/`	La oportunidad de recuperar skills sincronizados y plugins sincronizados que Claude Code eliminó
`~/.claude/debug/`, `~/.claude/plans/`, `~/.claude/session-env/`, `~/.claude/shell-snapshots/`, `~/.claude/backups/`	Nada orientado al usuario
`~/.claude/todos/`, `~/.claude/statsig/`, `~/.claude/logs/`, `~/.claude/image-cache/`	Nada. Directorios heredados no escritos por versiones actuales.

No elimine ~/.claude.json, ~/.claude/settings.json o ~/.claude/plugins/: esos contienen su autenticación, preferencias y plugins instalados.

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

Primeros pasos

Conceptos fundamentales

Usar Claude Code

Plataformas e integraciones

Explorar el directorio .claude