TL;DR Pasa el
jqde abajo por el.jsonlde tus sesiones largas. Si un fichero sale con dos o más lecturas iguales, añade a tuCLAUDE.mdla regla de trabajar con la lectura anterior y pide rangos de líneas cuando solo te hace falta una parte: 9 líneas costaron 309 tokens nuevos, el fichero entero 21.842.
Hasta la v2.1.316, cuando Claude llamaba a Read sobre un fichero sin cambios, con el mismo rango que la vez anterior, Claude Code no se lo volvía a enviar: le devolvía una línea diciendo que esa llamada sobraba. La v2.1.317 quitó esa línea. Cada relectura de un fichero sin cambios entra ahora entera en el contexto, y se queda en el historial que se relee en cada turno posterior.
Qué devuelve ahora una segunda lectura
El changelog de la v2.1.317 lo dice en una línea:
Removed the Read tool's "file unchanged since your last Read" stub: reading an unchanged file again returns its content
Lo que recibía Claude antes, tal como lo envía el binario de la v2.1.316:
Wasted call — file unchanged since your last Read. Refer to that earlier tool_result instead.
Y si leía con Read un CLAUDE.md que ya estaba cargado desde el arranque, otra nota del mismo tipo: This file is already in your context ... and has not changed on disk. En la v2.1.316 aquello estaba activo por defecto, con un interruptor remoto para apagarlo; en la v2.1.325 el tipo de resultado file_unchanged y ese interruptor han desaparecido. Probado en la v2.1.325, la segunda lectura devuelve el fichero entero otra vez, con sus números de línea, y un Read sobre el CLAUDE.md del proyecto devuelve el fichero completo aunque ya estuviera en el contexto.
Lo que cuesta cada relectura
Para medirlo, un run -p con Sonnet 5.5 al que se le pidió leer tres veces seguidas, sin tocarlo, un fichero TypeScript de 44 KB y 1.503 líneas. Cada fila es una petición a la API, sacada del .jsonl de la sesión; tokens nuevos son input_tokens más cache_creation_input_tokens:
petición qué añade tokens nuevos releídos de caché
1 arranque y primera llamada a Read 5.318 28.047
2 1.ª lectura 21.842 33.363
3 2.ª lectura, idéntica 21.842 55.203
4 3.ª lectura, idéntica 21.842 77.043
Dos cosas salen de ahí:
- Una relectura cuesta lo mismo que la primera lectura: 21.840 de esos tokens se escriben en caché, que en la suscripción es una escritura de una hora, al doble del precio de entrada.
- No se paga una vez. La columna de la derecha crece en 21.840 por cada copia, y cada copia viaja en todas las peticiones que le quedan a la sesión, como lectura de caché (0,05 veces el precio de entrada en Opus 5.5 y Sonnet 5.5). Es el mismo mecanismo que encarece repetir un
@sobre el mismo fichero, ahora conRead.
Editar el fichero entre medias no cambia la cuenta. Después de un Edit, el resultado le dice a Claude que el estado del fichero ya está en su contexto y que no hace falta volver a leerlo. En otra sesión de prueba, con un prompt que pedía leer, editar y leer dos veces más, cada lectura entera posterior a la edición añadió 21.849 tokens nuevos.
Por qué no lo ves venir
- La interfaz lo agrupa. Las tres lecturas de la tabla se muestran como una sola línea,
Read 1 file. /contextno lo separa. Todo cae enMessages. Según el binario de la v2.1.325, su sugerenciaFile reads using ..., la de la captura del tip de/context, sale cuando las lecturas pasan del 5% de la ventana y de 10.000 tokens (desde el 15% la sustituye otra,Read results using ...), y el "save ~" que propone es el 30% de todo lo leído: una estimación fija, no las repeticiones contadas. En la sesión de la tabla, abierta en la terminal, no apareció.- Sin pedírselo, no releyó. En una sesión de cuatro turnos sobre el mismo fichero, edición incluida, ni Sonnet 5.5 ni Opus 5.5 lo volvieron a leer. Y en un run aparte que pedía "vuelve a mirar el fichero", Sonnet contestó desde la lectura que ya tenía. Las relecturas de la tabla se pidieron en el prompt; las de tus sesiones solo te las dice tu transcript.
Así que antes de cambiar nada, mira si a ti te pasa.
Cómo encontrarlas y cortarlas
1. Cuenta las lecturas idénticas de una sesión
Claude Code guarda cada resultado de Read en el .jsonl de la sesión, con la ruta, la línea de inicio y el contenido. Este jq agrupa por los tres y lista lo que se leyó igual más de una vez:
jq -s -r '[.[] | .toolUseResult.file? | select(.filePath? and .content?)]
| group_by([.filePath, .startLine, .content])
| map(select(length > 1))[]
| "\(length) lecturas iguales · \(.[0].numLines) líneas · \(.[0].filePath)"' \
~/.claude/projects/<tu-proyecto>/<sesion>.jsonl
Sobre la sesión de prueba que leyó el fichero, lo editó y lo leyó dos veces más:
2 lecturas iguales · 1504 líneas · /root/pagos/src/payments.ts
Read cuenta 1.504 líneas porque el fichero acaba en una línea vacía. La primera lectura no sale porque su contenido es anterior a la edición: solo agrupa copias idénticas. Si entre dos de ellas hubo un /compact, revisa el tamaño: tras compactar, Claude Code devuelve con su contenido hasta cinco ficheros recientes, y uno de más de 5.000 tokens vuelve solo como ruta, así que esa relectura sí hacía falta. Cada subagente tiene su propio .jsonl y su propio contexto.
2. Si salen, dale la regla a Claude
En el CLAUDE.md del proyecto o en ~/.claude/CLAUDE.md:
# Lectura de ficheros
Un fichero que ya leíste en esta sesión sigue en tu contexto. Antes de leerlo otra vez, trabaja con esa lectura; vuelve a leerlo solo si cambió desde entonces (una edición, una herramienta o el usuario), o lee solo las líneas que te faltan con offset y limit.
Es lo que hacía la nota que se quitó, puesto donde Claude lo lee al empezar cada sesión. En las pruebas cortas no cambió nada, porque sin ella tampoco hubo relecturas que cortar: es para las sesiones donde el paso 1 sí las encuentra.
3. Pide la parte, no el fichero
Cuando sepas qué buscas, dilo. "Lee las líneas 1494 a 1502 de src/payments.ts y dime qué devuelve handler150" hizo que Sonnet 5.5 llamara a Read con offset 1494 y limit 9, y la petición añadió 309 tokens nuevos. "Qué devuelve handler42 en src/payments.ts con input 100", sin rango, llevó a Opus 5.5 a un Grep que añadió 382. El fichero entero, 21.842.
Referencia
| Relectura | ¿Hace falta? | Qué cuesta desde la v2.1.317 |
|---|---|---|
| Fichero sin cambios, primera lectura aún en el contexto | No | El fichero entero otra vez |
| Después de que lo cambies tú o una herramienta | Sí | El fichero entero, con lo nuevo |
Después de un /compact o un /clear |
Sí, salvo que el compact lo haya devuelto | El fichero entero |
Solo un rango con offset y limit |
Si te falta esa parte | Las líneas pedidas |
Docs oficiales: Tools reference
Requisitos
- Claude Code v2.1.317 o posterior. Medido en la v2.1.325, en runs
-psobre un proyecto de prueba con Sonnet 5.5 y Opus 5.5, y con la sesión de la tabla abierta en la terminal. jqpara el paso 1.