Claude Code「File content exceeds maximum allowed tokens」エラーの解決方法
Contents
問題の概要
Claude Codeで大きなファイルを読み込もうとすると、以下のエラーが発生することがあります。
|
1 2 3 |
Error: File content (32229 tokens) exceeds maximum allowed tokens (25000). Please use offset and limit parameters to read specific portions of the file, or use the GrepTool to search for specific content. |
これはClaude CodeのReadツールにトークン上限（デフォルト25000トークン）があるために発生します。
解決方法
方法1: 分割して読み込む（推奨）
Readツールのoffsetとlimitパラメータを使用して、ファイルを部分的に読み込むことができます。
offset: 読み込み開始行limit: 読み込む行数
例えば「1行目から500行目まで読んで」のように指示すれば、Claude Codeが自動的にパラメータを設定してくれます。
方法2: Grepツールで検索する
ファイル全体を読む必要がなく、特定のコードや文字列を探したい場合は、Grepツールを使うのが効率的です。
方法3: トークン上限を変更する
環境変数または設定ファイルでトークン上限を引き上げることができます。
環境変数で一時的に設定
|
1 2 |
export CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS=50000 claude |
settings.jsonで永続化
~/.claude/settings.json（ユーザー全体）または.claude/settings.json（プロジェクト単位）に以下を追加します。
|
1 2 3 4 5 |
{ "env": { "CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS": "50000" } } |
方法4: ファイルを分割する
そもそも25000トークンを超えるファイルは大きすぎる可能性があります。リファクタリングでファイルを分割することも検討してみてください。
注意点
トークン上限を引き上げる場合、以下の点に注意してください。
- コンテキストを多く消費するため、長い会話で早く上限に達する
- トークンコストが増加する可能性がある
まとめ
Claude Codeでファイルサイズ上限エラーが出た場合、基本的には分割読み込みで対応できます。頻繁に大きなファイルを扱う場合は、環境変数で上限を引き上げるか、ファイル自体の分割を検討しましょう。