當你的 AI 編程代理撞牆時，HTTP 429 到底是什麼意思

很少有什麼比 agent 在任務跑到一半、帶著紅色的 429 停下來更打斷節奏的了。它看起來像故障，但其實不是——那是供應商在說現在不行，而確切知道這句話的意思，就能告訴你下一步該怎麼做。速率限制是每一套 AI 編程配置的基礎管線，而 agent 觸發它們的頻率遠高於一般聊天使用者，背後有結構性的原因，值得在你成為那個盯著錯誤訊息看的人之前先搞懂。

429 真正說的是什麼

HTTP 429 Too Many Requests 表示伺服器收到並理解了你的請求，但拒絕處理——配額被超過了。關鍵是，它的設計本身就是暫時性的：回應通常會帶一個 Retry-After 提示，告訴你什麼時候可以再來。這一點把它和錯誤家族裡的鄰居們區分開來。401 或 403 指的是驗證或權限問題，重試不會修好它們；402 指向計費；5xx 是供應商自己出了狀況。429 是你的問題，而且可以解決。

為什麼 agent 比聊天更容易撞上限制

一次聊天往返是一兩個請求。一個 agent 回合是幾十個：讀檔案、搜尋、編輯、跑測試、對輸出做出反應——每一步都是一次全新的 API 呼叫，帶著不斷膨脹的上下文。有三種不同的上限要留意：每分鐘請求數、每分鐘 token 數，以及同時連線數。agent 通常最先耗盡每分鐘 token 數，因為每一次呼叫都隨附幾千個 token 的上下文。訂閱方案還會在上面疊加公平使用上限——每日或每週配額——而這些可能以用量警告、而不是乾淨的 429 回應浮現出來，第一次遇到時會讓人一頭霧水。

第一反應：正確退避

有 Retry-After header 就照它說的做；沒有就用指數退避加重試抖動——等一秒，然後兩秒，然後四秒，然後八秒。狂按重送只會讓事情更糟：重複請求可能把節流視窗拉長，而好幾個開啟面板同時手動重試的風暴，會把一個小問題放大成大問題。也要搞清楚是哪一條限制被觸發了。你自己帳戶的配額和供應商端壅塞的行為非常不同，把兩者分清楚，能省下一個小時把別人尖峰時段怪到自己頭上的時間。

結構性解法：減少需求，把它分散開

持久的解法是縮小需求，而不是閃避需求。精簡上下文：把 agent 指向三個相關檔案，勝過貼上半個 repository。接近上限時，跑一個長任務而不是六個並行工作階段。把相關的編輯批次成單一、規格明確的回合，而不是零零碎碎地下指令。把大量隔夜工作推到離峰時段。把管線拆開，讓較便宜的模型處理例行步驟，把高階額度留給決策。如果你本來就在多家供應商之間切換，編程代理的 token 成本對照 可以兼作粗略的價格與能力地圖，而了解 Claude、GPT 和 Gemini 在編程上的差異，能幫你在急需之前就先選好一家合理的第二供應商。

當 429 一直發生

偶爾在尖峰時段爆發是天氣；每天持續出現的模式是氣候。如果你每天都撞上限制，代表你已經超出這個方案或這家供應商了——提高上限、升到更高階的方案，或把部分工作負載永久轉移到別處。追蹤哪些任務會觸發它：如果永遠都是那些大型重構工作，那其實是穿著速率限制外衣的上下文體積問題，縮小你送出的東西，會比升級方案修掉更多。

meshcode 的角度

因為 meshcode 讓每個面板可以指向自己的後端，某一家供應商的 429 就從停擺變成了一個路由決策：把卡住的任務移到另一個模型，其他一切照常運行，等視窗清空後再切回來。自己帶 API 金鑰，後備計畫就由你來安排，而不是由平台決定。

👉 下載 meshcode — Mac, Windows