結論先說
- 先分清是 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 條評論
還沒有評論,來搶沙發~