幫助
常見問題
按現象找原因。報錯資訊的逐條解釋見 報錯排查。沒找到答案的，先看 服務狀態，再按 回饋與聯絡 把使用日誌裡出錯請求的時間發給我們。
接入與設定
首次啟動報 Unable to connect to Anthropic services
首次啟動的引導流程會去連 Anthropic 官方服務，中國大陸網路常常連不上。用編輯器開啟 ~/.claude.json（Windows 是 %USERPROFILE%\.claude.json），在最外層加上 "hasCompletedOnboarding": true，儲存後重新執行 claude。
還在走官方帳號
執行 /status 看 Base URL。不對的話檢查設定檔案路徑、終端機是否重開，或執行 /logout 退出 claude.ai 登入。
VS Code 外掛沒走 CoreCode
確認 env 寫在 ~/.claude/settings.json，完全退出 VS Code 後重開；外掛裡登入過 claude.ai 帳號的先退出登入。
模型不存在
用 模型價格 頁列出的模型名，不要帶廠商前綴。
長時間無輸出
深度思考可能幾分鐘不出字，這是正常的；閘道讀逾時為 10 分鐘。
報錯
401 金鑰無效
金鑰複製不完整或已刪除。到「API 金鑰」頁重新複製；確認沒有同時設定 ANTHROPIC_API_KEY。
403 額度不足
餘額用完，到「錢包」儲值。
403 僅接受來自 Claude Code 的請求
「Claude 滿血（僅限CC）」分組的金鑰只接受 Claude Code CLI 的請求，Anthropic SDK、curl 和其他客戶端直接呼叫都會被拒絕。要在這些地方呼叫，另建一個「Claude 滿血（可外接）」分組的金鑰。
429
單個金鑰的請求速率或並行超限，稍等重試；需要更高並行請 聯絡我們。
計費與快取
快取命中率低、花費比預期高
最常見的原因是開了 auto 模式，其次是工作階段中途切模型或停頓超過 5 分鐘。排查方法見 快取與計費。
使用日誌裡有很多「非串流」請求
Claude Code 的主對話都是串流的，非串流請求多半是 auto 模式在工具呼叫前發的檢查。見 auto 模式的開銷。
只用 Opus，帳單裡卻有 Haiku 或 Sonnet
背景摘要、子代理和 auto 模式的分類器會用其他模型，見 帳單裡的其他模型。