Claude Code: 大きなファイルの読み込み上限（25,000 トークン・256 KB）と allow_large
Read ツールは1回で最大 25,000 トークンしか返さず、256 KB を超えるファイルを丸ごと読むのは拒否する。巨大なログや生成ファイルを読ませると「一部だけ読んで分かったつもり」になりやすいので、上限の動きを知って読ませ方を指示する。
上限の動き
- 既定では Read 1回の出力は 25,000 トークンまで。環境変数
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENSで変えられる - 丸ごと読もうとしたファイルが上限を超えると、最初のページだけ返り「PARTIAL view」と注記される
- 256 KB を超えるファイルの丸ごと読み、または上限を超える offset/limit 指定はエラーになり、offset/limit か Grep を使うよう促される
- v2.1.296 以降は
allow_large: trueで、ファイル全体や長い範囲を1回で読める。量は残りのコンテキストに合わせて決まる。画像・PDF・ノートブックは従来の上限のまま
使い方
- 巨大ログは「まず Grep でエラー行を探し、前後を offset/limit で読む」と指示する
- 全体を一度に見せたい中くらいのファイル（数万行の設定や仕様書）は「allow_large で読んで」と頼む
- 常に大きく読ませたいなら
CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENSを上げる。ただし1回の読み込みで文脈を大きく使い、コンパクトが早まる
注意点
- 「PARTIAL view」が出たのに続きを読まずに結論を出していないか、出力を確認する
- 上限を上げるほど利用枠とコンテキストを使う。1M コンテキストのモデルでも、無関係な部分まで読ませる利点は少ない
出典
- @oswrav 小技 No.20（2026-11-02）: @oswrav · 2026-11-03
- 公式ドキュメント（Tools reference の Large files）: code.claude.com
- 公式ドキュメント（環境変数）: code.claude.com
- Claude Code CHANGELOG: github.com
- 関連: Claude Code: コンパクト後も残るもの・消えるもの（大事な指示は SKILL.md の先頭とルート CLAUDE.md に）