撞到 Claude Code 連線逾時,好多人第一件事就係重裝用戶端,跟住換 API Key。兩樣通常都白做。CLI 好地地,model 又喺線,只係你發出去個 request 喺度吊住吊住,過咗成段時間先 fail。真正卡住嘅,係載住回應嗰條 HTTP stream——佢喺預設嘅請求時限入面根本傳唔完。
離 API 伺服器遠嘅人尤其食得苦。封包要行一段又長又塞嘅國際線路,延遲偏高、中途丟包,連住嗰條 TLS 仲隨時俾人斬斷。應用層嗰套老建議——精簡 context、轉個輕啲嘅 model、重啟 session——的確解到一部分,但有個現象佢哋解唔到:同一條指令,喺呢個網絡跑得到,換個網絡就逾時。分別唔喺你個 prompt,喺啲封包行緊嗰條路。呢層先係今次要拆嘅嘢。
邊種人最容易中招
最典型係做跨境長鏈路嘅開發者。流量要先穿過一段塞車國際線先去到 API,於是一做大型重構,個游標就耐耐唔郁,最後彈句「請求逾時」。但係之前嗰啲短指令明明秒回——其實 model 一直喺度生成,只係回傳嘅 token 喺一條丟包路徑上面推唔郁。
公司同校園網絡係另一種。呢度條 connection 成日喺回應講到一半俾人 reset,你會見到最煩嗰句「收到部分回應」。元兇通常係中間個 proxy buffer 住啲 streaming 數據,又或者防火牆太敏感,一覺得條 connection idle 就斬。
仲有 CI 同無介面跑 agent 嗰種。一個 agent 連環發幾十次 tool call,只要其中一次往返卡住,就骨牌咁拖冧成個任務。三種場景表面唔同,底層係同一件事:request 由頭到尾冇乾淨咁行到完,client 唯有放棄。
由網絡層捉佢出嚟
第一步:分清「真逾時」定「淨係慢」
Claude Code 俾每個 request 嘅時限其實好闊,大概喺十分鐘量級。所以「真逾時」嘅意思係——呢十分鐘入面條 stream 一啲有用嘢都冇產出,而唔係 model 純粹行得慢。
確認方法好直接。先 claude --version 睇版本夠唔夠新,再行 /doctor 驗一次身,佢會爆出大部分設定問題。然後發一句最簡單嘅提示。細 request 即刻覆、大型 agent 任務先逾時,結論就清楚:鏈路係通嘅,只係弱鏈路載唔起大流量。
第二步:量延遲同丟包
呢步好多排錯文都跳過,偏偏係命門。ping 量去 API 主機嘅基準往返時間,mtr(或者 traceroute)睇丟包出喺邊一個 hop。
互動式寫 code,往返時間理想係穩定喺 150 毫秒以內、幾乎唔丟包。一過 250 毫秒,中間又間歇丟包,streaming 回應就開始卡,長 call 跟住觸發逾時。
有樣嘢同純延遲一樣致命:jitter。一條喺 80 同 400 毫秒之間彈嚟彈去嘅路徑,會令條 stream 冇規律咁斷,平均值睇落仲幾靚都冇用。如果 mtr 指住某個營辦商 hop 喺度丟包,咁就唔關你本機事,係條路徑本身衰。
第三步:認得中途 reset 嘅樣
「收到部分回應」係 connection 層嘅指紋,唔係 model 報錯。載住答案嗰條 TLS connection,喺最後一個 token 到之前就俾人切咗——多數係識 buffer 嘅 proxy,或者一見 model 停低諗嘢就當 idle 斬咗佢嘅政策。
查三樣就夠:有冇公司 proxy 擋喺流量前面、keep-alive 係咪俾人剝走、同一條提示換個網絡跑唔跑得完。
第四步:本地、鏈路定上游
順住層次逐個踢走。官方 status page 話到你知 API 自己有冇 degrade;綠燈,即係問題喺應用層以下。跟住轉手機熱點或者第二個網絡再試——逾時跟手消失,你主用嗰條線就係兇手。
NasaCode 處理嘅正正係中間呢層。與其等啲封包喺塞車預設路徑上面亂咁行,不如將流量釘喺一條延遲穩、丟包低嘅優化路由,等條 stream 撐得夠耐,大型 agent 任務先至有得跑到底。
幾種接入方式擺埋一齊睇
| 接入方式 | 長任務 stream 表現 | 線路 | 放 API Key 風險 | 合唔合 Claude Code |
|---|---|---|---|---|
| 預設直連 | 跨境長 hop 上面好睇彩數 | 營辦商分配,你冇得揀 | 低 | 近 API 啱用,遠就吃力 |
| 免費公共 proxy | 成日中途 reset | 少而且大家迫 | 高,來源唔透明 | 唔建議,reset 直接斷 agent |
| 通用消費級隧道 | 普通,冇為 streaming 調過 | 通用地區節點 | 中 | 持續 call 時唔夠穩 |
| NasaCode 優化路由 | 為持續 stream 調嘅穩定延遲 | 面向開發者嘅低延遲節點 | 私隱優先,唔記錄流量 | 專為長 IDE / agent session 調校 |
分別主要喺一個位:會唔會為「持續吐 token 嘅長連線」呢種流量去揀路。寫一兩句嘢同跑半個鐘嘅 agent,對網絡嘅要求差好遠。
幾個常見疑問
直接調大個逾時時間得唔得?
多數唔得。時限調長,只係喺條 stream 真係就快傳完嗰陣有用。如果根源係丟包或者俾人 reset,你只係換嚟等耐啲先迎接同一個 fail。先修條路徑。
換部勁啲嘅電腦有冇幫助?
冇。逾時係網絡事件,啲 byte 喺你個 terminal 同 API 之間飛緊。CPU、RAM 決定本地工具跑幾快,但條回應 stream 捱唔捱得過一個丟包 hop,同你部機幾勁完全冇關。
點先知係官方故障定我自己條線?
睇官方 status page。佢顯示健康、而你連最簡單一句提示都 fail 或者卡死,咁問題就喺你條線。換個網絡再試,通常一分鐘內就有答案。
有冇辦法令長時間 agent 任務唔逾時?
每一步嘅負載控制喺合理範圍當然要,但更關鍵係跑喺一條延遲穩、丟包低嘅路由。多步任務由頭撐到尾,靠嘅就係條連線夠穩。
講到尾,Claude Code 連線逾時十居其九係著住應用層外衣嘅路徑問題。當你肯落手測延遲同丟包,而唔係靠估,解法就一句講得完:把路徑穩住。NasaCode 行嘅就係呢條路——低延遲節點,專為 AI 編程工具嗰種持續 streaming 流量調校。下次跑大型重構唔想做到一半斷,可以去 nasacode.com 睇下佢點接入你現有嘅工作流。