幫助

Claude Code 報錯排查

最後更新：2026 年 11 月 1 日

按報錯資訊找原因。每一節先說是什麼，再說怎麼辦。先確認請求走的是哪裡：在 Claude Code 裡執行 /status，Base URL 應當是 https://corecode.live；不是的話，先按 Claude Code 接入改好設定。

Unable to connect to Anthropic services

首次啟動時，引導流程會去連 Anthropic 官方服務，中國大陸網路常常連不上，於是報 Unable to connect to Anthropic services 或 Failed to connect to api.anthropic.com。這一步和中轉無關，跳過引導即可：

用編輯器開啟 ~/.claude.json（Windows 是 %USERPROFILE%\.claude.json）。
在最外層加上 "hasCompletedOnboarding": true，儲存。
重新執行 claude。

之後仍有零星的官方請求（自動更新、遙測、錯誤回報）連不上，可以在 ~/.claude/settings.json 的 env 里加 "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" 關掉它們，見推薦設定。

Claude Code 沒有讀到中轉的金鑰，退回了官方登入。常見原因：

環境變數只在另一個終端機裡設定過。寫進 ~/.claude/settings.json 的 env 最穩，所有終端機和 VS Code 外掛都會讀到。
變數名寫錯。中轉的金鑰用 ANTHROPIC_AUTH_TOKEN，位址用 ANTHROPIC_BASE_URL。
改完設定沒有重開 Claude Code。設定只在啟動時讀取。

不要按提示執行 /login 登入 claude.ai 帳號，那會讓 Claude Code 改用官方帳號。

Auth conflict: Both a token and an API key are set

同時設定了 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY，Claude Code 不確定該用哪個。刪掉 ANTHROPIC_API_KEY，只留 ANTHROPIC_AUTH_TOKEN。用 echo $ANTHROPIC_API_KEY（PowerShell 是 $env:ANTHROPIC_API_KEY）確認它在當前終端機裡也已清空；之前登入過 claude.ai 的，再執行一次 /logout。

401 authentication_error

中轉收到了請求，但不認這個金鑰：複製時少了字元、金鑰已被刪除，或者填的是別家的金鑰。到控制台 API 金鑰頁重新複製一份，確認以 sk- 開頭、前後沒有空格。

403

報錯內容	原因	怎麼辦
額度不足	餘額用完。	到錢包儲值，立即恢復，不用改設定。
僅接受來自 Claude Code 的請求	「僅限CC」分組的金鑰只放行 Claude Code CLI，SDK、curl 和其他客戶端會被拒絕。	在 Claude Code 裡使用；其他客戶端改用「可外接」分組的金鑰。
Request not allowed	請求直接發到了 Anthropic 官方，被地區限制拒絕，說明沒有走中轉。	用 `/status` 檢查 Base URL，見上面。
該對話包含被上游模型以違反使用政策為由拒絕的訊息	Anthropic 的安全分類器拒絕過這個對話裡的一條訊息。同一段對話再發還會被拒，CoreCode 直接攔下，不再轉給上游。分類器有時也會拒絕正常的請求，包括 Claude Code auto 模式單獨發出的檢查請求。	開一個新對話，或改掉被拒的那條訊息再發。經常遇到時，檢查有沒有設定 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS`，見 auto 模式的開銷。

429 rate_limit_error

單個金鑰的請求速率或並行超過了上限。Claude Code 會自動退避重試，偶爾出現可以不管。持續出現時，減少同時執行的 Claude Code 工作階段和子代理；需要更高並行請聯絡我們。

529 overloaded_error

Anthropic 官方暫時過載，和你的設定無關，Claude Code 會自動重試。持續幾分鐘以上時先看服務狀態，也可以臨時用 /model 換一個模型。

500、502、503、504

503，內容是 Service deployment in progress; retry shortly.：CoreCode 正在發布新版本，回應頭帶 Retry-After: 5，幾秒後重試即可，已經在進行的請求不受影響。
其他 5xx：上游或閘道出錯。先看服務狀態；狀態正常但反覆出現時，把使用日誌裡出錯請求的時間發給我們。

400 invalid_request_error

報錯內容	怎麼辦
`prompt is too long`	上下文超過了模型上限。執行 `/compact` 壓縮歷史，或者用 `/clear` 開新工作階段。
模型不存在	用模型價格頁列出的模型名，不要帶廠商前綴。

長時間沒有輸出、請求逾時

開啟深度思考時，模型可能幾分鐘不出字，這是正常的。CoreCode 閘道的讀逾時是 10 分鐘。Claude Code 自己的逾時由 API_TIMEOUT_MS 控制，單位毫秒；調得比 10 分鐘短，長思考會被客戶端提前斷開。

開著代理或 VPN

corecode.live 在中國大陸可以直連。全域代理會讓請求繞一圈，變慢，偶爾還會中斷串流。在代理軟體的規則裡把 corecode.live 設為直連（DIRECT）。付款頁面打不開或一直載入時，也先關掉代理再試。

還是不行

先看服務狀態。狀態正常的話，把三樣東西發給我們：claude --version 的輸出、報錯原文，以及使用日誌裡出錯請求的時間。也可以到微信交流群裡問。其他問題見常見問題。