Claude Code 出現模型錯誤時：先判斷官方事故，還是自己的環境問題
Claude Code 出現模型錯誤時，很容易直接重裝 CLI、清設定或重設 token。但如果同一時間是服務端事故，這些動作不會讓請求恢復，反而會抹掉最有價值的線索；反過來說，狀態頁正常也不代表你的 proxy、登入方式或本機設定沒有問題。
一個比較省時間的做法是固定順序：先看官方狀態，再保存症狀，最後才縮小自己的環境差異。 這篇用 2026 年 7 月 15 日官方已解決的「multiple models」錯誤事件當背景，但不把那次事件當成每次錯誤的原因。
第一分鐘：把錯誤分成三種訊號
先不要更動設定，記下發生時間（含時區）、原始錯誤訊息、使用的登入方式和指令。接著把症狀放到這三類：
| 訊號 | 較可能的方向 | 第一個檢查 |
|---|---|---|
| 多個模型或多個工作階段在同一時段出錯 | 平台或 API incident | Claude Status 與 incident 更新 |
| OAuth 登入失敗、但 API key 工作流程不同 | 身分驗證或 Claude.ai 相關問題 | Status、帳號與登入方式 |
| 只有一台電腦、一個 repository 或一個網路環境失敗 | 本機安裝、設定、proxy 或網路 | claude doctor、環境差異與網路設定 |
這是排查方向，不是診斷結論。例如多個模型出錯仍可能是公司 proxy 的上游問題；因此下一步要把「同時受影響的人／環境」和「官方是否有 incident」分開確認。
先看 Status，但讀取時間與影響範圍
Claude Status 的歷史紀錄顯示，2026 年 7 月 15 日曾有「Elevated errors on multiple models」事件，官方在同日標示為 resolved。這條紀錄能證明該時間窗確實有服務端異常，卻不能證明今天或你的當下錯誤一定同源。
查看 status page 時，我會記錄：
- incident 是否仍是 Investigating、Identified、Monitoring 或 Resolved；
- 開始與更新時間是否覆蓋自己的錯誤時間；
- 影響的是 Claude Code、API、Claude.ai，還是特定模型；
- 官方描述是否提到登入、OAuth 或特定功能。
若頁面有同時段的未解決事故，先停止破壞性的本機操作，保留請求時間與錯誤文字，等官方更新或以最小測試確認恢復。若頁面沒有相符事件，才把重心轉到本機。
Status 正常後，保留最小可重現證據
本機排查不需要先把整份設定貼給任何工具。先記錄無敏感值的環境資訊：
# 只檢查安裝狀態與版本；執行前確認輸出不含 token。claude doctorclaude --version
# 記下目前 shell 與工作目錄，不要輸出憑證值。printf 'shell=%s\n' "$SHELL"pwd官方入門文件建議安裝後使用 claude doctor 檢查安裝型態與版本。把它的非敏感輸出、錯誤首次發生時間和使用的認證方式放在一起，之後無論是自己比對另一台電腦，或向支援管道回報，都比「剛剛不能用」更有用。
不要把診斷變成憑證外洩不要把
ANTHROPIC_API_KEY、OAuth token、完整設定檔或 terminal history 複製到 issue、聊天室或 agent prompt。診斷只需要錯誤碼、時間、版本與去識別化設定差異。
依認證與網路路徑縮小範圍
如果狀態頁沒有對應事故，下一步問「請求經過哪一條路」。常見差異如下：
| 差異 | 可檢查項目 | 不要直接假設 |
|---|---|---|
| OAuth 與 API key | 哪一種登入方式失敗、帳號權限 | 兩者一定共享同一個故障原因 |
| 公司 proxy | HTTPS_PROXY、憑證、allowlist | CLI 一定支援所有 proxy 設定 |
| 單一 repo | project settings、hooks、MCP 設定 | 問題一定出在模型或帳號 |
| 單一電腦 | CLI 版本、shell、Node 與網路 | 重裝一定能解決 |
Anthropic 的 corporate proxy 文件指出，Claude Code 使用標準 HTTP/HTTPS proxy 環境變數，並列出 API、telemetry 與錯誤回報相關的網路需求；如果只在受管網路失敗，應把 proxy 與憑證鏈列為優先檢查項目。不要為了「試試看」把安全 proxy 暫時關掉後就當成修復，先確認那是否符合組織政策。
何時才該更新或重設
更新是有意義的，但它應該是證據導向的下一步，而不是第一反應。官方文件列出 claude update 可手動更新，claude doctor 可協助確認目前安裝狀態。建議的順序是：
1. 保存錯誤時間、原文與 claude doctor 的非敏感結果2. 對照 Claude Status 的時間與受影響服務3. 比對另一個允許測試的網路或工作目錄4. 確認問題只在本機後，再更新 CLI 或調整設定5. 重跑同一個最小操作，記錄是否恢復這樣即使更新沒有改善，也能知道問題是在更新前已存在，還是被某次設定變更引入。若是工作環境，請把網路與身分驗證變更交由相應管理者處理，不要自行繞過 proxy、組織政策或權限控制。
這次要記住的事
模型錯誤不是單純的「重裝看看」問題。先用 status page 排除同時段的平台事故，再用時間、認證方式、CLI 版本與網路路徑縮小本機差異；每一步都保留非敏感證據，才能讓下一次排查或交接真正變快。
常見問題
Q: Status 顯示 All Systems Operational，是否代表一定是我的問題？
A: 不代表。狀態頁通常反映已知且達到公告門檻的服務事件；單一帳號、特定認證方式、公司 proxy 或 project settings 仍可能造成問題。它只是把「已知平台事故」先排除的一個訊號。
Q: 看到 Resolved 後還要檢查本機嗎？
A: 要。先確認自己的錯誤時間是否落在 incident 範圍內，並以同一個最小操作重新測試。若服務恢復後仍可重現，才有理由繼續查本機設定、網路與認證流程。
Q: 可以把完整錯誤 log 交給 Claude Code 分析嗎？
A: 先清除 token、cookie、私有網址、原始碼與客戶資料。把問題縮成錯誤訊息、時間、版本、已嘗試步驟與不含敏感值的設定差異，通常已足夠開始定位。
參考資料：
回報錯字、失效連結，或告訴我你想看的延伸主題。