← Claude Code Hub
Nov 15, 2026 · 7 min de lectura ✦ Tip #271

Claude Code vuelve a leer el mismo archivo: corta los tokens repetidos

Claude Code vuelve a leer un archivo que no ha cambiado y, desde la v2.1.317, cada relectura entra entera en el contexto: 21.842 tokens por un fichero de 44 KB, en cada repetición. Un comando sobre el transcript te dice si te pasa.

Comparación en Claude Code v2.1.325: tres lecturas enteras de un fichero sin cambios suman 65.526 tokens nuevos, 21.842 cada una; pedir solo las 9 líneas de la función que hace falta, con offset y limit, cuesta 309

TL;DR Pasa el jq de abajo por el .jsonl de tus sesiones largas. Si un fichero sale con dos o más lecturas iguales, añade a tu CLAUDE.md la 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 con Read.

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.
  • /context no lo separa. Todo cae en Messages. Según el binario de la v2.1.325, su sugerencia File 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 -p sobre un proyecto de prueba con Sonnet 5.5 y Opus 5.5, y con la sesión de la tabla abierta en la terminal.
  • jq para el paso 1.

¿Te ha servido? Haz que wmedia.es te salga antes en Google.

Añadir wmedia.es como fuente preferida en Google
GUÍA GRATUITA

Aprueba menos, pero mejor.

A los diez minutos ya le das a «sí» sin leer. Eso no es revisar, es rezar. La guía de 10 páginas con las cinco palancas, en orden de riesgo.

  • 1. Reglas la primera que coincide gana
  • 2. Modo un dial, no un interruptor
  • 3. Auto mode un clasificador aprueba por ti
  • 4. Sandbox una valla del sistema operativo
  • 5. Bypass solo dentro de un contenedor
¿Eres desarrollador/a Web profesional?

Recibirás la guía por email · Te unes a la newsletter Gravitas · Cancela cuando quieras

de 10
#

Wmedia · 10 páginas
GUÍA GRATUITA · 10 páginas · 5 palancas

Aprueba menos, pero mejor.

A los diez minutos ya le das a «sí» sin leer. Eso no es revisar, es rezar. La guía de 10 páginas con las cinco palancas, en orden de riesgo.

¿Eres desarrollador/a Web profesional? · Cancela cuando quieras
Cómo trabajo con IA

Mi flujo de trabajo con Claude Code.

Las skills, agentes e instrucciones que uso como Software Engineer profesional. Se llama Craft y es un plugin que puedes instalarte.

Ver las skills

¿Harto de aprobar permisos sin leer?