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

图:本站根据 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 都报错时怎么救回会话

图:本站根据 Claude Code 官方文档:Explore the context window 整理的示意图
当你看到 /compact 执行失败、报出同样的 Prompt is too long 时,按下面三种办法从轻到重脱困:
办法 1:用 /rewind 精准剪掉肇事的那一轮(最推荐)
- 在输入框连按两次
Esc键,或直接输入/rewind打开检查点历史列表; - 往上找到「刚刚读取巨型文件、打印万行日志或粘贴大图」之前的那条用户消息;
- 选中后,如果这期间 Claude 已经帮你改好了部分磁盘代码,务必选 Restore conversation only(仅恢复对话,保留当前代码文件);
- 回到安全水位后,立刻执行
/compact 保留当前排查结论与待改文件清单,把历史压瘦后再继续干活。
办法 2:临时切到 1M 长窗口模型做压缩
如果会话不是被单个巨型文件撑爆,而是几十轮正常修改慢慢顶到了 200K 边缘,且你的账号档位支持 1M 扩展上下文模型:
- 输入
/model,切换到带[1m]标识的同系模型(或默认支持 1M 窗口的模型); - 运行
/compact完成摘要压缩; - 压缩完成后再用
/model切回日常模型以节省后续额度。
高频在大型仓库里跑多轮重构、经常需要长上下文窗口与更高周期额度的开发者,可按需对比升级官方高阶订阅,具体方案见本站 Claude Max 充值页 或 Claude Code 订阅页。
办法 3:导出关键结论后 /clear 重开
如果遇到的是早期轮次就塞进了多张大图触发 413,不方便回退到最开头,可先运行 /export 把当前会话记录导出到本地文本文件,摘出核心改动进展,随后输入 /clear 开启干净会话继续(其他常见工具报错见 Claude Code 常见报错与解决)。
三、防复发配置:拦住大体积文件、大图与冗长输出
要想不再半路卡死,在项目里做好三件事(大仓库目录隔离的完整做法见 Claude Code 处理大仓库:怎么让它只看需要的目录):
- 在
.claude/settings.json用deny屏蔽构建产物与大日志:防止 Claude 搜索或通读代码时误吞打包文件和巨型锁文件:
json
{
"permissions": {
"deny": [
"Read(./dist/**)",
"Read(./build/**)",
"Read(./.next/**)",
"Read(**/*.min.js)",
"Read(**/*.log)",
"Read(./pnpm-lock.yaml)"
]
}
}
- 截图与 PDF 先瘦身再贴:截图只框选报错弹窗或目标组件区域,不要截双屏全图;超过几十页的 PDF 文档先让本地命令行(如
pdftotext或 Python 脚本)按章节提取相关段落,不要整本直传。 - 调回自动压缩开关:检查
/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 上下文满了怎么办:/compact、/clear 与省 token 技巧
- Claude Code 处理大仓库:怎么让它只看需要的目录
- Claude API 报错 400 / 401 / 403 / 413 / 500 怎么排查
- Claude Code 常见报错与解决:403、400、Error editing file
参考资料
- 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
0 条评论
还没有评论,来抢沙发~