← Claude Code Hub
Nov 20, 2026 · 6 min de lectura ✦ Tip #278

Claude Code no lee un archivo grande entero: haz que lo lea de una vez

Claude Code lee los archivos grandes a trozos: pasados 25.000 tokens o 256 KB, Read devuelve una página o un error y Claude pagina. Puede leerlos de una vez, pero solo si se lo pides y si caben.

Comparación en Claude Code v2.1.329 sobre un log de 128 KB: a trozos son 4 llamadas a Read y 154.635 tokens releídos de caché; en una sola lectura, 1 llamada con allow_large y 6.184; si solo buscas una línea, Grep añade 4.359 tokens nuevos

TL;DR Cuando Claude tenga que ver un archivo entero (un log, un spec, un CSV), pídele "léelo entero en una sola lectura": usa la opción allow_large de Read y lo carga de una vez si cabe, hasta unos 133.000 tokens en una sesión nueva. Si lo que buscas es una línea, pídele que la busque: 4.359 tokens nuevos frente a 80.363.

Read devuelve como mucho 25.000 tokens por llamada y no abre entero un archivo de más de 256 KB. Pasado eso, Claude lo recorre a trozos con offset y limit, una petición a la API por trozo. Desde la v2.1.296 tiene allow_large, que mide la lectura contra el contexto que te queda y no contra esos topes. Pero no la usa por su cuenta: el propio error le dice que solo lo haga si necesita el archivo entero o si se lo has pedido.

Qué recibe Claude cuando el archivo no cabe

Depende del tamaño. Con un log de 128 KB y 1.700 líneas (73.330 tokens), por debajo de los 256 KB, Read no falla: devuelve las primeras 492 líneas con un aviso PARTIAL view que le pide paginar y no contestar solo con esa página.

Con uno de 301 KB y 4.000 líneas, la lectura entera falla con un error, no con una página. Esto es lo que recibió Claude en la v2.1.329:

File content (301.2KB) exceeds maximum allowed size (256KB). Use offset and limit
parameters to read specific portions of the file, or search for specific content
instead of reading the whole file. To read it anyway, up to what still fits in your
context, call Read again with allow_large: true — only if you genuinely need all of
it or the user asked for the whole file.

Tú solo ves Read 1 file · 1 failed. Y Claude, con la pregunta "qué factura falló al cobrarse en app.log", no pasó allow_large: probó 1.000 líneas, chocó otra vez con los 25.000 tokens (File content (43092 tokens) exceeds maximum allowed tokens (25000)) y leyó el archivo en ocho trozos de 550.

Lo que cuesta cada forma de leerlo

Misma pregunta sobre el log de 128 KB, con Sonnet 5.5 en runs -p de la v2.1.329. Tokens nuevos son input_tokens más cache_creation_input_tokens, sumados en todas las peticiones del run:

Cómo lo leyó Llamadas Peticiones Tokens nuevos Releídos de caché
A trozos, sin pedirle nada 4 Read 5 80.978 154.635
"Léelo entero en una sola lectura" 1 Read con allow_large 2 80.363 6.184
Con Grep disponible, sin pedirle nada 2 Grep 3 4.359 15.842
  • allow_large no ahorra el archivo: entra entero igual, 80.000 tokens de una forma o de otra. Lo que ahorra son las vueltas: cada trozo es una petición más que relee todo lo anterior desde la caché, y en el log de 301 KB eso fueron 11 peticiones y 757.629 tokens releídos.
  • Una página no es el archivo. Si Claude contesta con la primera, la factura de la línea 1.650 no existe para él. Una sola lectura no deja ese hueco.
  • Para una línea, buscar gana por 18 a 1. Si la respuesta está en una parte, que no lea nada entero.

Cómo pedirlo

1. Di que lo quieres entero, y en una sola lectura

Lee app.log entero en una sola lectura y dime qué factura falló al cobrarse

Con esa frase, Sonnet 5.5 llamó a Read con allow_large: true a la primera. Con "Lee app.log entero", sin "en una sola lectura", hizo una lectura normal, recibió la página parcial y pidió el resto, desde la línea 493, con allow_large: dos llamadas en vez de cuatro.

2. Comprueba que cabe

El margen no es la ventana entera. Según el binario de la v2.1.329, es el 70% de lo que te falta hasta un techo, que en este contenedor fue de 200.000 tokens aunque Sonnet 5.5 tenía 1M, y lo comparten todas las lecturas grandes del mismo turno. En una sesión nueva fue de 133.436 tokens en la terminal y de 136.813 en un -p. El log de 301 KB pesa 183.377 tokens y no entró:

File content (183377 tokens) exceeds maximum allowed tokens (133436). Use offset and
limit parameters to read specific portions of the file, or search for specific
content instead of reading the whole file. Even with allow_large, this is more than
fits in the context you have left this turn (other large reads in the same turn
share that room).

Si la lectura era del archivo entero, sin rango, no hay error: llega la primera página de siempre, 463 líneas, y el aviso dice cuánto margen tenía (allow_large had room for 136813 tokens this turn). Un log como este sale a unos 600 tokens por KB; el texto corrido pesa menos. Antes de pedir algo grande en una sesión larga, mira lo que te queda con /context o empieza una nueva.

3. Si buscas una parte, pídele que la busque

"Busca en app.log la línea del cobro fallido" lleva a Grep, o pide el rango: "lee las líneas 1600 a 1700". Es lo que separa los 4.359 tokens de los 80.363 de la tabla, y lo mismo que abarata cada relectura de un archivo que no ha cambiado.

4. Sube el tope por llamada solo si lo necesitas siempre

CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS cambia los 25.000 tokens de cada lectura, también las que Claude hace por su cuenta, así que cada página crece y llena antes el contexto. Los 256 KB del archivo entero no se mueven con ella. Para un archivo concreto, el paso 1 basta.

Referencia

Límite Valor por defecto Al pasarlo Con allow_large
Tokens por llamada 25.000, o CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS Archivo entero: primera página con PARTIAL view. Un rango: error Hasta el margen del turno
Tamaño del archivo entero 256 KB Error Hasta lo que quepa en el margen
Margen de contexto El 70% de lo que falta hasta el techo (aquí, 200.000), por turno No aplica Error, o la primera página si leía el archivo entero
Imágenes, PDF y notebooks Sus propios límites Su propio error No cambia nada

Documentación oficial: Tools reference: Large files

Requisitos

  • Claude Code v2.1.296 o posterior para allow_large. Medido en la v2.1.329 con Sonnet 5.5, en runs -p y en una sesión en la terminal, sobre logs de prueba de 128 KB y 301 KB.

¿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?