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 條評論

登入 後參與評論

還沒有評論,來搶沙發~