Qué es el scratchpad
La documentación de Anthropic lo define: "El scratchpad es un directorio por sesión que Claude Code le da a Claude para archivos temporales: resultados intermedios, scripts de ayuda y borradores que no pertenecen a tu proyecto".
Dos detalles lo hacen conveniente. Claude lo usa en lugar de la carpeta temporal general, y la documentación dice que Claude "puede crear, editar y leer archivos en él sin un aviso de permiso". Así que cuando Claude necesita probar algo, puede hacerlo sin preguntarte cada vez y sin añadir archivos a tu repositorio.
Cuando Claude dice que guardó algo en el scratchpad, es literal: el archivo está en este directorio.
Debido a que es por sesión, cada sesión de Claude Code tiene su propio scratchpad. Un archivo en el scratchpad de una sesión no está en la siguiente sesión.
Dónde reside
El scratchpad se encuentra fuera tanto de tu proyecto como de la carpeta de configuración de Claude Code. "El scratchpad reside bajo el directorio temporal de Claude Code en lugar de ~/.claude."
Las rutas documentadas:
- macOS:
/private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/ - Linux:
/tmp/claude-<uid>/<project>/<session-id>/scratchpad/, o la misma estructura bajo$TMPDIRcuando tu sistema define uno - Windows:
%TEMP%\claude\<project>\<session-id>\scratchpad\
La parte <project> es la ruta de tu directorio de trabajo con cada carácter que no sea letra o dígito reemplazado por un guion, como -Users-tu-mi-proyecto. En Windows es un hash de 16 caracteres de esa cadena. En una sesión de la aplicación de escritorio (Desktop app), puede ser la propia cadena.
La forma más sencilla de encontrar el actual también está en la documentación: "Para obtener la ruta exacta, pregúntale a Claude".
Dos configuraciones cambian el panorama:
CLAUDE_CODE_TMPDIR. Si lo configuras, todo el árbol se mueve bajo ese directorio en su lugar.- Hooks. "Los hooks reciben la ruta de la sesión actual como
scratchpad_dir". Eso es útil si quieres que un hook copie algo fuera del scratchpad al final de una sesión.
Qué sesiones tienen uno
No todas las sesiones obtienen un scratchpad. La documentación enumera tres condiciones que deben cumplirse simultáneamente:
- Has iniciado sesión con una cuenta de claude.ai, no con una clave API.
- La sesión utiliza la Anthropic API, no Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry.
- El ajuste
enableArtifactno está establecido enfalse.
Si alguna de estas condiciones no se aplica, la sesión no tiene scratchpad y Claude trabaja sin uno. El campo del hook refleja esto: scratchpad_dir está ausente cuando la sesión no tiene scratchpad o el directorio temporal no está disponible.
Cuánto duran sus archivos
Esta es la parte que explica la desaparición del script de ayuda. La documentación es directa: "Los archivos del scratchpad 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".
El barrido de retención se basa en la antigüedad de tus transcripciones. Claude Code elimina los archivos en las rutas barridas una vez que son más antiguos que el ajuste cleanupPeriodDays. El valor predeterminado es 30 días, y el mínimo es 1. Cuando una transcripción desaparece, su scratchpad desaparece con ella.
Hay una segunda forma de perderlo, independiente de Claude Code: "Debido a que el directorio se encuentra bajo la ubicación temporal del sistema, tu sistema operativo también puede borrarlo, por ejemplo, al reiniciar".
Por lo tanto, un archivo del scratchpad puede desaparecer cuando:
- la transcripción de la sesión alcanza el límite de retención y es barrida, o
- tu sistema operativo borra su ubicación temporal, lo cual puede ocurrir al reiniciar.
Lo segundo no depende en absoluto del ajuste de retención de Claude Code. Un archivo que viste ayer puede haber desaparecido después de un reinicio.
Qué elimina y qué no elimina claude purge
claude purge elimina el estado que Claude Code mantiene para un proyecto: transcripciones y auto memory bajo projects/, tareas por sesión, depuración (debug) y entradas del historial de archivos, líneas coincidentes en tu historial de prompts y la entrada del proyecto en ~/.claude.json.
No toca el scratchpad. La documentación explica por qué: las imágenes pegadas y "el scratchpad de cada sesión se almacenan bajo el directorio temporal de Claude Code en lugar de ~/.claude, por lo que la purga no los elimina".
Eso lleva a un detalle que vale la pena conocer si purgas un proyecto por razones de privacidad: "el scratchpad de una sesión purgada permanece hasta que lo elimines o tu sistema operativo borre el directorio temporal".
Si quieres que se elimine todo, borra tú mismo las carpetas del scratchpad del proyecto después de purgar, usando las rutas mencionadas anteriormente.
Qué permanece editable cuando las escrituras están restringidas
Algunos equipos activan permissions.blockWritesOutsideWorkingDirectories, lo que hace que las herramientas de edición de archivos de Claude rechacen rutas fuera de tus directorios de trabajo. El scratchpad es una de las excepciones. La referencia de ajustes de Anthropic enumera los archivos de plan, el scratchpad, el directorio tmp de una sesión en segundo plano y los archivos .md de auto memory como archivos propios de Claude Code que permanecen editables.
Así que Claude puede seguir usando el scratchpad para borradores incluso cuando el bloqueo impide que sus herramientas de archivos escriban en otros lugares fuera del proyecto. Los archivos de plan son otra de esas excepciones, y cubrimos dónde se guardan en nuestra guía sobre dónde guarda Claude Code los archivos de plan.
Qué cambió en 2.1.325
La versión del 13 de noviembre cambió las instrucciones de Claude para que mantenga fuera del scratchpad los archivos que vayas a necesitar. El cambio está en lo que se le dice a Claude: algo que reutilizarás, como un script, un informe o un conjunto de datos, debe ir a otro lugar que no sea una carpeta que pueda ser borrada.
Es una instrucción, no una garantía. El propio consejo de la documentación sigue aplicándose: "Para conservar algo que Claude escribió allí, pídele a Claude que lo mueva a tu proyecto".
Otros detalles que vale la pena conocer
Las sesiones de escritorio siguen una regla de retención diferente. El barrido de retención no aplica el límite de edad habitual a cada transcripción. La documentación de Anthropic dice que 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, a menos que configures desktopSessionCleanupPeriodDays. Dado que los archivos del scratchpad duran tanto como la transcripción de la sesión, para esas sesiones, lo que hay que vigilar es que el sistema operativo borre su ubicación temporal.
Las imágenes pegadas viven cerca. Las imágenes que pegas o adjuntas en las sesiones de un proyecto también se almacenan bajo el directorio temporal de Claude Code en lugar de ~/.claude. El barrido de retención las elimina una vez que son más antiguas que cleanupPeriodDays.
Claude nombra la ruta completa. Una entrada del registro de cambios corrigió que Claude se refiriera a los archivos del scratchpad por un nombre de archivo simple o una ruta relativa, por lo que cuando Claude te diga dónde guardó algo, la ruta debería estar completa. Esa es la ruta que debes copiar.
Los Artifacts pueden recuperarse de un scratchpad borrado. Otra entrada del registro de cambios corrigió que las actualizaciones de Artifacts fallaran después de que una sesión se reanuda en otra máquina o su scratchpad se borra. En ese caso, se restaura la última versión publicada de la página. El trabajo publicado sobrevive; los borradores de trabajo en el scratchpad no tienen esa protección.
Puedes acortar la retención. Si prefieres que los archivos temporales no perduren, reducir cleanupPeriodDays hace que el barrido elimine las transcripciones antiguas, y sus scratchpads, más pronto. Anthropic sugiere reducirlo como una forma de disminuir el tiempo que los valores sensibles permanecen en el disco.
Para qué es bueno el scratchpad
El scratchpad es el lugar adecuado para el trabajo que debe desaparecer:
- Resultados intermedios, como una copia filtrada de un archivo de log.
- Scripts desechables usados una vez para verificar algo.
- Borradores que reescribirás antes de que vayan a cualquier parte.
Es el lugar equivocado para cualquier cosa que quieras la próxima semana: scripts reutilizables, informes que compartirás, datos que procesaste cuidadosamente o notas sobre lo que reveló un script. Esos pertenecen a tu proyecto, o a algún lugar donde los guardes a propósito.
Una prueba rápida antes de terminar una sesión: si te molestaría perder un archivo que Claude creó, no debería quedarse en el scratchpad. Pídele a Claude que enumere lo que guardó allí durante la sesión y mueve cualquier cosa que pase la prueba mientras las rutas aún sean fáciles de encontrar.
Lo que la gente intenta primero
Buscar en la carpeta del proyecto. El scratchpad está fuera de ella.
Buscar en ~/.claude. Está bajo el directorio temporal de Claude Code en su lugar.
Ejecutar claude purge para borrar todo. No elimina los scratchpads.
Esperar que los archivos duren tanto como el proyecto. Duran tanto como la transcripción de la sesión, o menos si el SO borra los archivos temporales.
Buscar un scratchpad en una sesión con clave API. Las sesiones necesitan un inicio de sesión en claude.ai y la Anthropic API.
La solución: Mantén lo importante fuera del scratchpad
Paso 1: Pregunta dónde lo guardó Claude
Si Claude menciona el scratchpad, solicita la ruta completa mientras la sesión aún esté abierta.
Paso 2: Mueve cualquier cosa reutilizable al proyecto
Pídele a Claude que mueva scripts, informes o datos que volverás a necesitar a tu proyecto, tal como recomienda Anthropic.
Paso 3: Copia al final de una sesión con un hook
Si a menudo quieres la salida del scratchpad, un hook puede usar scratchpad_dir para copiar archivos a una carpeta que conserves.
Paso 4: Anota lo que mostró el trabajo
La salida de un script es temporal. Registra lo que te indicó, como qué registros estaban mal formados, en algún lugar que perdure.
Configurando esto en MemoryLake
El scratchpad está diseñado para ser borrado. Las conclusiones del trabajo realizado allí, como lo que encontró un análisis puntual o por qué se necesitó un script de ayuda, son lo que la próxima sesión necesita.
MemoryLake es una capa de memoria para ese tipo de contexto de proyecto, como hallazgos, decisiones y las razones detrás de ellos, mantenidos en un solo lugar que tú controlas y disponibles para los asistentes que conectes, como ChatGPT, Claude Code y Codex.
Tú mismo escribes las entradas, con tus propias palabras. No se lee nada de, ni se escribe en, ni se borra de tu scratchpad, el directorio temporal de Claude Code, tus transcripciones, tu carpeta ~/.claude, los archivos de tu proyecto o el almacén de cualquier proveedor. El scratchpad y su limpieza funcionan de la manera que Anthropic describe.
Paso 1: Crea una clave API
Inicia sesión y genera una clave desde el panel de control. Guárdala fuera de tus repositorios, como cualquier otra credencial.

Paso 2: Sube tus primeras memorias
Comienza con lo que escribiste en el Paso 4 de la solución: qué mostraron los análisis recientes, qué problemas de datos encontraste y qué decidiste debido a ellos. Un hallazgo por entrada.

Paso 3: Conecta tu IA y agentes
Conecta Claude Code y los otros asistentes que utilices. Una nueva sesión, después de que el antiguo scratchpad haya desaparecido, puede recurrir a los mismos hallazgos.

Qué cambia esto en la práctica
La primera diferencia es que la limpieza deja de costarte algo importante. El scratchpad puede borrarse y los hallazgos ya están anotados.
La segunda es menos trabajo repetido. No vuelves a ejecutar un análisis para redescubrir lo que mostró.
La tercera es la continuidad entre herramientas. Codex u otro asistente en el mismo proyecto pueden usar los mismos hallazgos.
Mejores prácticas para el scratchpad de Claude Code
Trátalo como temporal. Los archivos duran como máximo lo que dure la transcripción de la sesión.
Espera que los reinicios lo borren. Se encuentra bajo la ubicación temporal del sistema.
Mueve lo que quieras conservar al proyecto. Pídele a Claude que lo haga mientras la sesión esté abierta.
No confíes en purge para la privacidad. Borra tú mismo las carpetas del scratchpad después de claude purge.
Usa scratchpad_dir en los hooks. Te da la ruta de la sesión actual.
Verifica tu inicio de sesión. Las sesiones con una clave API o proveedores externos no obtienen un scratchpad.
Registra las conclusiones por separado. La salida es temporal; lo que significó no debería serlo.
Conclusión
El scratchpad de Claude Code es una carpeta por sesión para archivos temporales, bajo el directorio temporal de Claude Code en lugar de ~/.claude o tu proyecto. Claude puede escribir allí sin preguntar, y solo las sesiones iniciadas con una cuenta de claude.ai en la Anthropic API tienen uno.
Sus archivos duran tanto como la transcripción de la sesión, que el barrido de retención elimina después de cleanupPeriodDays, y tu sistema operativo puede borrarlos antes, como al reiniciar. claude purge no elimina los scratchpads. Desde la versión 2.1.325, Claude tiene instrucciones de mantener fuera del scratchpad los archivos que desees conservar, y el consejo de Anthropic es el mismo: mueve cualquier cosa que valga la pena conservar a tu proyecto.