文章目录
- 一、问题描述
- 1.1 环境信息
- 1.2 报错现象
- 二、根因分析
- 2.1 错误链路追踪
- 2.2 可能原因列举
- 三、解决方案
- 方案一:回退到添加图片前(推荐)
- 方案二:缩小图片尺寸后再附加
- 方案三:拍摄更紧凑的截图
- 方案四:调整图片格式和压缩率
- 四、验证与回归测试
- 五、总结与预防
- 5.1 核心要点
- 5.2 最佳实践建议
- 六、参考资料
一、问题描述
1.1 环境信息
| 项目 | 详情 |
|---|---|
| 工具 | Claude Code (CLI) |
| 触发场景 | 粘贴/拖入高分辨率图片 |
| 单图限制 | 最长边 ≤ 8000px |
| 多图限制 | 每张最长边 ≤ 2000px |
| 错误类型 | API 400 / 客户端预处理失败 |
1.2 报错现象
当你向 Claude Code 粘贴或拖入一张图片(如高分辨率截图、手机拍摄照片)后,可能出现以下两种报错:
Image was too large. Double press esc to go back and try again with a smaller image.或 API 返回的详细错误:
API Error: 400 ... image