Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
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 |
| 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 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. | 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 |
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 |
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. |
todos/ | Listas de tareas heredadas por sesión. Ya no se escriben en versiones actuales; seguro 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:
- 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
claude project purge ~/work/my-repo
claude project purge ~/work/my-repo --yes
--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/ | Nada. Directorio heredado no escrito por versiones actuales. |
~/.claude.json, ~/.claude/settings.json o ~/.claude/plugins/: esos contienen su autenticación, preferencias y plugins instalados.
Recursos relacionados
