文章目录
- 一、问题描述
- 1.1 环境信息
- 1.2 报错现象
- 二、根因分析
- 2.1 错误链路追踪
- 2.2 可能原因列举
- 三、解决方案
- 方案一：按 Esc 回退并移除大附件（推荐）
- 方案二：拆分大文件
- 方案三：压缩图片或降低分辨率
- 四、验证与回归测试
- 五、总结与预防
- 5.1 核心要点
- 5.2 最佳实践建议
- 六、参考资料
一、问题描述
1.1 环境信息
| 项目 | 详情 |
|---|---|
| 工具 | Claude Code (CLI) |
| 错误码 | HTTP 413 / client-side pre-check |
| 硬限制 | 30 MB（原始请求体字节数） |
| 触发场景 | 粘贴大文件内容、拖入大型二进制文件 |
1.2 报错现象
当你向 Claude Code 粘贴超大文本内容，或拖入超大的文件后，终端立即输出：
Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.此后，当前请求被拦截，无法发送给 API。
注意：这个 30 MB 的限制是 HTTP 请求体字节数限制，与 token 上下文窗口限制是
