PaPoo
cover

MaxFileReadTokenExceededError: File content (28289 tokens) exceeds maximum allowed tokens (25000). Use offset and limit parameters to read specific portions of を見たときに確認したいこと

この症状でまず目に入るのは、Claude Code が大きなファイルを読み切れずに止まっている、という点です。issue では、MaxFileReadTokenExceededError: File content (...) exceeds maximum allowed tokens (25000). Use offset and limit parameters to read specific portions of the file, or search for specific content という文言が繰り返し出ています。報告されているのは #73486#68927 です。

#73486 では、セッション開始時に Claude Code が「active configuration」を書き換えた、という不満とあわせて、このエラーが出ています。報告文にある出力は次のとおりです。

MaxFileReadTokenExceededError: File content (28289 tokens) exceeds maximum allowed tokens (25000). Use offset and limit parameters to read specific portions of the file, or search for specific content / Error: Request was aborted.
    at makeRequest (/$bunfs/root/src/entrypoints/cli.js:50:3448)
    at processTicksAndRejections (native:7:39)

#68927 でも同系統のエラーが出ています。こちらでは、API 側の「Server is temporarily limiting requests (not your usage limit) · Rate limited」という表示と一緒に、ファイル内容が上限を超えたことが記録されています。

API Error: Server is temporarily limiting requests (not your
usage limit) · Rate limited
報告されたエラー: MaxFileReadTokenExceededError: File content (57517 tokens) exceeds maximum allowed tokens (25000). Use offset and limit parameters to read specific portions of the file, or search for specific content / MaxFileReadTokenExceededError: File content (46125 tokens) exceeds maximum allowed tokens (25000). Use offset and limit parameters to read specific portions of the file, or search for specific content

この時点で言えるのは、少なくとも issue 上は「大きすぎるファイルを一度に読もうとして失敗している」ことです。25000 を超えるとこのエラーになる、というのは報告文から直接読めます。一方で、なぜそのファイルが読まれたのか、Claude Code のどの操作が引き金になったのかは、issue ごとに違い、ここからは断定できません。

関連しているのは、報告者が「session start」や「request」がきっかけだと述べている点です。つまり、ユーザーが明示的に巨大ファイルを開いたとは限らず、開始直後の処理や内部リクエストの流れで触れた可能性があります。ただし、これは issue の記述からの読み取りに留まります。

この症状に遭遇したとき、少なくとも issue から確認できる切り分けは次の2点です。ひとつは、実際に読ませようとしたファイルが 25000 tokens を超えていないか。もうひとつは、Request was abortedRate limited が同時に出ていないかです。後者があると、単なるファイルサイズ問題だけでなく、処理の途中でリクエスト自体が止められている可能性があります。ただし、rate limit と token 超過のどちらが主因かは、提示された issue だけでは分かりません。

現時点で書ける対処は、issue に明記された範囲では「大きなファイルを分割して扱う」「必要な部分だけを読むようにする」ことです。これはエラーメッセージ自体が Use offset and limit parameters to read specific portions of the file, or search for specific content と案内しているためです。逆に、ここで具体的な CLI フラグや設定名を付け足すことはできません。本文中の情報だけでは、どのコマンドや設定が有効かまでは確認できませんでした。

今回の2件はどちらも closed ですが、コメントでは duplicate 扱いになっていることが分かります。#68927 のコメントには、関連しそうな重複 issue が複数挙がり、自動クローズされる旨が書かれていました。つまり、少なくともこの症状は単発の例外ではなく、同種の報告がまとまっていた、と見るのが自然です。

自分のケースかどうかを見るなら、まずエラーメッセージに MaxFileReadTokenExceededError が含まれているかを確認してください。含まれていて、しかも File content (...) exceeds maximum allowed tokens (25000) と続くなら、この issue クラスタとかなり近いです。そこに Request was abortedRate limited が重なっていれば、#73486#68927 のどちらか、あるいは両方に似た状況と考えられます。

[env_summary]
OS          : Linux 3.10.0-1160.76.1.el7.x86_64 (x86_64)
Python      : 3.8.13
検証日時    : 2026-09-10T08:51:08+09:00

検証環境

OS          : Linux 3.10.0-1160.76.1.el7.x86_64 (x86_64)
Python      : 3.8.13
検証日時    : 2026-09-10T08:51:08+09:00

参照した Issue(anthropics/claude-code): #73486, #68927

同じ著者の記事