SpyBara
Go Premium

claude-directory.md 2026-06-09 06:34 UTC to 2026-06-10 23:57 UTC

41 added, 1414 removed.

2026
Tue 30 23:02 Mon 29 23:02 Sat 27 01:01 Fri 26 23:00 Thu 25 23:58 Wed 24 22:02 Tue 23 22:00 Mon 22 23:59 Fri 19 22:58 Thu 18 22:00 Wed 17 17:02 Tue 16 21:57 Mon 15 23:02 Sat 13 21:59 Fri 12 22:00 Thu 11 23:01 Wed 10 23:57 Tue 9 06:34 Mon 8 06:52 Sat 6 06:24 Fri 5 06:45 Thu 4 06:52 Wed 3 06:53 Tue 2 06:51

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 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:

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. Consulte configuración administrada por servidor.
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.
Plugins instalados ~/.claude/plugins Mercados clonados, versiones de plugins instaladas y datos por plugin, administrados por comandos claude plugin. Las versiones huérfanas se eliminan 7 días después de una actualización o desinstalación de plugin. Consulte almacenamiento en caché de plugins.

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

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.

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 Memory
rules/*.md Proyecto y global Instrucciones con alcance de tema, opcionalmente con puerta de ruta Rules
settings.json Proyecto y global Permisos, hooks, variables de entorno, valores predeterminados de modelo Settings
settings.local.json Solo proyecto Sus anulaciones personales, auto-gitignored Settings scopes
.mcp.json Solo proyecto Servidores MCP compartidos por el equipo MCP scopes
.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 auto-invocados Skills
commands/*.md Proyecto y global Prompts de archivo único; mismo mecanismo que skills Skills
output-styles/*.md Proyecto y global Secciones de prompt del sistema personalizadas Output styles
agents/*.md Proyecto y global Definiciones de subagents con su propio prompt y herramientas Subagents
workflows/*.js Proyecto y global Scripts de flujo de trabajo dinámico escritos por Claude y guardados desde /workflows; cada archivo se convierte en un comando /<name> Dynamic workflows
agent-memory/<name>/ Proyecto y global Memoria persistente para subagents Persistent memory
~/.claude.json Solo global Estado de la aplicación, OAuth, alternancias de UI, servidores MCP personales Global config
projects/<project>/memory/ Solo global Auto memory: notas de Claude para sí mismo entre sesiones Auto memory
keybindings.json Solo global Atajos de teclado personalizados Keybindings
themes/*.json Solo global Temas de color personalizados Custom themes

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.

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>/subagents/ Transcripciones de conversación de Subagent, eliminadas con la transcripción de sesión principal cuando vence
projects/<project>/<session>/tool-results/ Salidas de herramientas grandes derramadas en archivos separados
file-history/<session>/ Instantáneas previas a la edición de archivos que Claude cambió, utilizadas para restauración de checkpoint
plans/ Archivos de plan escritos durante plan mode
debug/ Registros de depuración por sesión, escritos solo cuando comienza con --debug o ejecuta /debug
paste-cache/, image-cache/ Contenidos de pastes grandes e imágenes adjuntas
session-env/ Metadatos de entorno por sesión
tasks/ Listas de tareas por sesión escritas por las herramientas de tareas
shell-snapshots/ Entorno de shell capturado utilizado por la herramienta Bash. Se elimina al salir correctamente. El barrido borra cualquiera dejado después de un bloqueo.
backups/ Copias con marca de tiempo de ~/.claude.json tomadas antes de migraciones de configuración
feedback-bundles/ Archivos de transcripción redactados escritos por /feedback en proveedores de terceros, para enviar a su equipo de cuenta de Anthropic
todos/, statsig/, logs/ Directorios heredados de versiones anteriores. Ya no se escriben. El barrido elimina su contenido y luego el directorio vacío.

Mantenidos hasta que los elimine

Las siguientes rutas no están cubiertas por la limpieza automática y persisten indefinidamente.

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.
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. Solo presente cuando su organización las ha configurado. Se actualiza en cada inicio.

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:

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

Elimine con un único mensaje de confirmación:

claude project purge ~/work/my-repo

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

Eliminar Pierde
~/.claude/projects/ Reanudar, continuar y rebobinar para sesiones pasadas
~/.claude/history.jsonl Recuperación de prompt de flecha hacia arriba
~/.claude/file-history/ Restauración de checkpoint para sesiones pasadas
~/.claude/stats-cache.json Totales históricos mostrados por /usage
~/.claude/remote-settings.json Nada. Se vuelve a obtener en el próximo inicio.
~/.claude/debug/, ~/.claude/plans/, ~/.claude/paste-cache/, ~/.claude/image-cache/, ~/.claude/session-env/, ~/.claude/tasks/, ~/.claude/shell-snapshots/, ~/.claude/backups/ Nada orientado al usuario
~/.claude/todos/, ~/.claude/statsig/, ~/.claude/logs/ 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.