Skip to main content
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. 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 archivos que usted crea y edita. Algunos archivos relacionados viven en otros lugares: ~/.claude también contiene datos que Claude Code escribe mientras trabaja: transcripciones, historial de prompts, instantáneas de archivos, cachés y registros. Consulte datos de 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.
Varias cosas pueden anular lo que pone en estos archivos:
  • Configuración administrada implementada por su organización tiene prioridad sobre todo
  • Las banderas CLI como --permission-mode o --settings anulan settings.json para esa sesión
  • Algunas variables de entorno tienen prioridad 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.

​
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

Los archivos en las rutas a continuación se eliminan al inicio una vez que tienen más de cleanupPeriodDays. El valor predeterminado es 30 días.

​
Mantenidos hasta que los elimine

Las siguientes rutas no están cubiertas por la limpieza automática y persisten indefinidamente. Otros archivos de caché pequeños y archivos de bloqueo aparecen dependiendo de qué características use y son seguros de eliminar.

​
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 se mantienen las transcripciones
  • 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.
  • 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. El comando requiere Claude Code v2.1.124 o posterior. 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
El comando imprime el plan de eliminación completo y solicita confirmación antes de eliminar cualquier cosa. Obtenga una vista previa del plan sin eliminar nada:
Elimine con un único mensaje de confirmación:
Omita la ruta para elegir un proyecto de una lista interactiva. Omita el mensaje de confirmación para usar en scripts:
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. Sale con estado 1 si ningún estado coincide con la ruta dada. También puede eliminar cualquiera de las rutas de datos de aplicación anteriores manualmente. Las nuevas sesiones no se ven afectadas. La tabla a continuación muestra qué pierde para sesiones pasadas. No elimine ~/.claude.json, ~/.claude/settings.json o ~/.claude/plugins/: esos contienen su autenticación, preferencias y plugins instalados.