Claude Code 报 Prompt is too long 或 Request too large 怎么办:大图大文件排除与 /compact 失败脱困

Claude Code 报 Prompt is too long 连 /compact 都失败,或报 413 Request too large 怎么救?本文讲清两类超限区别、用 /rewind 回退脱困、大图大 PDF 处理与大文件排除设置。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 Plus 账号

结论先说

  1. 先分清是 Token 超了还是字节体积超了:Prompt is too long(通常对应 400)是上下文总 Token 撑爆了模型窗口;Request too large(HTTP 413)则是整包 HTTP 请求字节数撞上了体积上限(标准 API 为 32 MB)。
  2. /compact 也会报错是因为压缩本身要重发整段历史:一旦某次读大文件或贴大图把上下文直接顶穿 100%,压缩请求照样发不出去。
  3. 不想丢上下文的首选救法是 /rewind(或连按两次 Esc):回退到读入巨型文件或粘贴大图之前的那一轮,选「仅恢复对话、保留代码修改」,腾出余量后再跑 /compact。
  4. 粘贴高分截图和大 PDF 最容易触发 413:对话历史里的图片每轮都会原样重发,截图前先只截局部区域,大 PDF 拆页或转纯文本再喂。
  5. Claude Code 订阅与高配额开通入口:国内无境外卡可通过本站 iOS 免上号自助卡密开通 Claude Pro 会员 或 5 倍以上额度的 Claude Max 会员,完整档位选型见 Claude Code 订阅说明页。

Prompt too long 与 413 报错区别

图:本站根据 Claude Code 官方文档:Error reference 与 Claude API Errors 整理的示意图

本文根据 Claude Code 官方文档《Error reference》《Explore the context window》及 Claude API《Errors》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。

适用于谁

  • 搜「claude code prompt is too long」「claude code 413 request too large」,对话突然卡死发不出任何消息的人;
  • 想敲 /compact 压缩上下文,结果连 /compact 自己也报 Prompt is too long,又舍不得直接 /clear 清空前面半天讨论记录的人;
  • 往终端拖了几张全屏高分截图或一份长 PDF 后,每发一句话都报请求过大的开发者。

日常未超限时的常规压缩与省 Token 技巧,见本站 Claude Code 上下文满了怎么办:/compact、/clear 与省 token 技巧,本文专门解决已经超限卡死后的急救与防复发。

一、两类报错为什么经常一起冒出来

很多开发者以为上下文还剩百分之三十就绝对安全,结果一步操作直接锁死,原因在于两套独立的校验规则(API 错误码底层分类见 Claude API 报错 400 / 401 / 403 / 413 / 500 怎么排查):

  • Prompt is too long(Token 窗口超限):Claude Code 每次发请求都要带上系统提示词、CLAUDE.md、所有已启用 MCP 的工具定义、整段历史消息以及刚刚返回的工具输出。如果某条命令把几万行未过滤的测试报错或一整个打包后的 bundle.js 读进了对话,单轮就会瞬间越过 200K(或 1M)窗口红线。
  • Request too large(HTTP 413 字节体积超限):网关在计算 Token 之前会先检查 HTTP 请求体大小。Anthropic 标准接口单次请求上限为 32 MB(单张图片不超过 5 MB,PDF 不超过 100 页),且图片转成 Base64 编码后体积还会膨胀约三分之一。在 Retina 或 4K 屏幕上连贴三四张全屏原图,后续每一轮对话都会把这些 Base64 图片反复打包上传,很快就会撞上 413。

二、卡死脱困:连 /compact 都报错时怎么救回会话

/compact 也失败时的脱困步骤

图:本站根据 Claude Code 官方文档:Explore the context window 整理的示意图

当你看到 /compact 执行失败、报出同样的 Prompt is too long 时,按下面三种办法从轻到重脱困:

办法 1:用 /rewind 精准剪掉肇事的那一轮(最推荐)

  1. 在输入框连按两次 Esc 键,或直接输入 /rewind 打开检查点历史列表;
  2. 往上找到「刚刚读取巨型文件、打印万行日志或粘贴大图」之前的那条用户消息;
  3. 选中后,如果这期间 Claude 已经帮你改好了部分磁盘代码,务必选 Restore conversation only(仅恢复对话,保留当前代码文件);
  4. 回到安全水位后,立刻执行 /compact 保留当前排查结论与待改文件清单,把历史压瘦后再继续干活。

办法 2:临时切到 1M 长窗口模型做压缩

如果会话不是被单个巨型文件撑爆,而是几十轮正常修改慢慢顶到了 200K 边缘,且你的账号档位支持 1M 扩展上下文模型:

  1. 输入 /model,切换到带 [1m] 标识的同系模型(或默认支持 1M 窗口的模型);
  2. 运行 /compact 完成摘要压缩;
  3. 压缩完成后再用 /model 切回日常模型以节省后续额度。

高频在大型仓库里跑多轮重构、经常需要长上下文窗口与更高周期额度的开发者,可按需对比升级官方高阶订阅,具体方案见本站 Claude Max 充值页 或 Claude Code 订阅页。

办法 3:导出关键结论后 /clear 重开

如果遇到的是早期轮次就塞进了多张大图触发 413,不方便回退到最开头,可先运行 /export 把当前会话记录导出到本地文本文件,摘出核心改动进展,随后输入 /clear 开启干净会话继续(其他常见工具报错见 Claude Code 常见报错与解决)。

三、防复发配置:拦住大体积文件、大图与冗长输出

要想不再半路卡死,在项目里做好三件事(大仓库目录隔离的完整做法见 Claude Code 处理大仓库:怎么让它只看需要的目录):

  1. 在 .claude/settings.json 用 deny 屏蔽构建产物与大日志:防止 Claude 搜索或通读代码时误吞打包文件和巨型锁文件:
json
{
  "permissions": {
    "deny": [
      "Read(./dist/**)",
      "Read(./build/**)",
      "Read(./.next/**)",
      "Read(**/*.min.js)",
      "Read(**/*.log)",
      "Read(./pnpm-lock.yaml)"
    ]
  }
}
  1. 截图与 PDF 先瘦身再贴:截图只框选报错弹窗或目标组件区域,不要截双屏全图;超过几十页的 PDF 文档先让本地命令行(如 pdftotext 或 Python 脚本)按章节提取相关段落,不要整本直传。
  2. 调回自动压缩开关:检查 /config 里是否曾手动关掉了自动压缩(Auto-compact),保持默认开启能让客户端在接近窗口上限前提前自动摘要。

常见问题

问:明明只贴了一张 2 MB 的图,为什么走公司内部接口还是报 413 Request too large?

答:检查环境变量里是否配置了企业反向代理或内部网关(ANTHROPIC_BASE_URL)。很多默认配置的 Nginx 网关把 client_max_body_size 限制在 1 MB,图片经 Base64 编码加上历史对话很容易超过 1 MB,需联系运维调大网关请求体上限。

问:为什么不建议直接让 Claude cat 大日志文件排错?

答:cat 会把整份文件原样塞进对话上下文且每轮重复计费。正确做法是让它用 Grep 工具按错误关键词检索,或跑 tail -n 100 只看末尾关键堆栈。

问:关掉不用的 MCP 服务器也能缓解 Prompt is too long 吗?

答:能。输入 /context 可以查看各类开销占比,若挂载了十几个 MCP 服务器,工具描述本身就会吃掉可观的固定窗口,用 /mcp 停用当前项目用不上的服务器能直接腾出余量。

问:国内没有海外银行卡,怎么给 Claude Code 开通 Pro 或 Max 订阅?

答:可在 Claude Code 订阅页 选择走 iOS 订阅链路的 Claude Pro 自助卡密 或 Claude Max 充值,支持支付宝、微信支付与 AlipayHK,无需交出账号密码;若账号弹出身份核验也可查看 Claude KYC 认证人工协助(失败不收费,封号不在质保范围)。

相关教程

参考资料

  • Claude Code 官方文档:Error reference — https://code.claude.com/docs/en/errors
  • Claude Code 官方文档:Explore the context window — https://code.claude.com/docs/en/context-window
  • Claude API 官方文档:Errors(HTTP 413 request_too_large 说明) — https://docs.claude.com/en/api/errors

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  2. 02

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0
  3. 03

    Langfuse 开源本地部署(Docker Compose)与提示词版本管理(Prompt Management)从零上手教程

    企业内网严禁业务日志出境,又想免费拥有大模型调用链追踪与不发版热更新提示词的能力?本文按 Langfuse 官方文档整理 Docker Compose 本地一键启动(含 ClickHouse 架构注意事项)、密钥配置与 Prompt Management 标签化版本管理全流程。

    Claude其他 AI 工具0
  4. 04

    LangSmith 入门教程:给 LangGraph 与原生 OpenAI / Claude 接口加调用链追踪、Token 成本统计与免费层限额

    智能体多步调用总是找不到哪一轮提示词跑偏、单次请求到底烧了多少 Token?本文按 LangSmith 官方文档讲清环境变量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 与 @traceable 追踪原生接口,以及 Developer 免费层额度与留存规则。

    Claude其他 AI 工具0
  5. 05

    Zotero 搭配 Claude / ChatGPT 高效读英文文献:PDF 翻译插件、批注导出精读与防捏造参考文献流程

    在 Zotero 里读英文顶会论文怎么无缝联动 Claude 与 ChatGPT?本文整理 Translate for Zotero 划词翻译配置、高亮批注导出精读提示词,以及杜绝 AI 捏造假 DOI 参考文献的核验闭环。

    Claude其他 AI 工具0
  6. 06

    Obsidian 接入 Claude、ChatGPT 与本地 Ollama 做个人双链笔记问答:主流插件配置与隐私脱敏边界

    想在 Obsidian 里基于自己的双链笔记库做 AI 问答又担心隐私外泄?本文对比 Copilot 与 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 与本地 Ollama 的步骤及敏感目录隔离规则。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~