跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

本頁列出 Claude Code 顯示的執行時錯誤及如何從每個錯誤中恢復，以及當回應似乎有問題但沒有錯誤時要檢查的內容。如需安裝錯誤（例如 command not found 或設定期間的 TLS 失敗），請參閱 Troubleshoot installation and login。 這些錯誤和恢復命令適用於 CLI、Desktop app 和 Claude Code on the web，因為這三者都包裝相同的 Claude Code CLI。如需特定表面的問題，請參閱該表面頁面上的疑難排解部分。
Claude Code 呼叫 Claude API 以取得模型回應，因此大多數執行時錯誤對應到基礎 API 錯誤代碼。本頁涵蓋每個錯誤在 Claude Code 中的含義及如何恢復。如需原始 HTTP 狀態代碼定義，請參閱 Claude Platform error reference。

​
尋找您的錯誤

將您在終端中看到的訊息與下方的部分相符。
訊息部分
API Error: 500 ... Internal server errorServer errors
API Error: Repeated 529 Overloaded errorsServer errors
Request timed outServer errors，或如果訊息提及您的網際網路連線，則為 Network
<model> is temporarily unavailable, so auto mode cannot determine the safety of...Server errors
Auto mode could not evaluate this action and is blocking it for safetyServer errors
Auto mode classifier transcript exceeded context windowServer errors
You've hit your session limit / You've hit your weekly limitUsage limits
Server is temporarily limiting requestsUsage limits
Request rejected (429)Usage limits
Credit balance is too lowUsage limits
Not logged in · Please run /loginAuthentication
Invalid API keyAuthentication
This organization has been disabledAuthentication
Routines are disabled by your organization's policyAuthentication
OAuth token revoked / OAuth token has expiredAuthentication
does not meet scope requirement user:profileAuthentication
Unable to connect to APINetwork
SSL certificate verification failedNetwork
403 with x-deny-reason: host_not_allowed in a cloud or routine sessionNetwork
Prompt is too longRequest errors
Error during compaction: Conversation too longRequest errors
Request too largeRequest errors
Image was too largeRequest errors
PDF too large / PDF is password protectedRequest errors
Extra inputs are not permittedRequest errors
There's an issue with the selected modelRequest errors
Claude Opus is not available with the Claude Pro planRequest errors
thinking.type.enabled is not supported for this modelRequest errors
max_tokens must be greater than thinking.budget_tokensRequest errors
API Error: 400 due to tool use concurrency issuesRequest errors
回應品質似乎低於平常Response quality

​
自動重試

Claude Code 在向您顯示錯誤之前會重試暫時性失敗。伺服器錯誤、過載回應、請求逾時、臨時 429 節流和中斷的連線都會以指數退避方式重試最多 10 次。重試時，微調器會顯示 Retrying in Ns · attempt x/y 倒數計時。 當您看到本頁上的其中一個錯誤時，這些重試已經用盡。您可以使用兩個環境變數調整行為：
變數預設值效果
CLAUDE_CODE_MAX_RETRIES10重試次數。降低它以在指令碼中更快地顯示失敗；提高它以等待更長的事件。
API_TIMEOUT_MS600000每個請求的逾時（毫秒）。為慢速網路或代理提高它。

​
伺服器錯誤

這些錯誤來自 Anthropic 基礎設施，而不是您的帳戶或請求。

​
API Error: 500 Internal server error

Claude Code 為任何 5xx 狀態顯示原始 API 回應主體。下面的範例顯示 500 回應： 
API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} · check status.claude.com
這表示 API 內部發生意外失敗。它不是由您的提示、設定或帳戶引起的。 要做什麼：
  • 檢查 status.claude.com 以了解活躍的事件
  • 等待一分鐘，然後再次傳送您的訊息。您的原始訊息仍在對話中，因此對於長提示，您可以輸入 try again 而不是貼上整個內容。
  • 如果錯誤持續存在且沒有發佈的事件，請執行 /feedback 以便 Anthropic 可以使用您的請求詳細資訊進行調查。如果您的提供者上 /feedback 不可用，請參閱 回報錯誤。

​
API Error: Repeated 529 Overloaded errors

API 在所有使用者中暫時達到容量。Claude Code 在顯示此訊息之前已經重試了多次： 
API Error: Repeated 529 Overloaded errors · check status.claude.com
529 不是您的使用限制，也不會計入您的配額。 要做什麼：
  • 檢查 status.claude.com 以了解容量通知
  • 幾分鐘後再試一次
  • 執行 /model 並切換到不同的模型以繼續工作，因為容量是按模型追蹤的。當一個模型負載特別高時，Claude Code 會提示您執行此操作，例如 Opus is experiencing high load, please use /model to switch to Sonnet。

​
Request timed out

API 在連線截止時間之前沒有回應。 
Request timed out
這可能在高負載期間或生成非常大的回應時發生。預設請求逾時為 10 分鐘。 要做什麼：
  • 重試請求
  • 對於長時間執行的任務，將工作分解為較小的提示
  • 如果原因是慢速網路或代理，請按照 Automatic retries 中的說明提高 API_TIMEOUT_MS
  • 如果逾時頻繁且您的網路在其他方面是健康的，請參閱下面的 Network and connection errors

​
Auto mode cannot determine the safety of an action

用來 auto mode 分類動作的模型無法產生決定，因此 auto mode 沒有自動批准該動作。您看到的訊息取決於分類器失敗的原因。 在您的工作目錄內的讀取、搜尋和編輯會跳過分類器，因此它們在所有這些情況下都能繼續工作。 當分類器模型過載時： 
<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait briefly and then try this action again.
要做什麼：
  • 幾秒鐘後重試；Claude 看到相同的訊息，通常會自動重試
  • 如果重試持續失敗，繼續進行唯讀任務，稍後再回到被阻止的動作
  • 這是暫時的，與 auto mode eligibility 無關；您不需要更改設定
當分類器傳回無法解析的回應時： 
Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details
要做什麼：
  • 重試該動作；這通常在下一次嘗試時成功
  • 執行 claude --debug 並重複該動作以在偵錯日誌中查看基礎分類器回應
當對話已增長到超過分類器的上下文視窗時： 
Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
在互動式工作階段中，auto mode 會針對該動作回退到正常的權限提示，以便您可以手動批准或拒絕它。在 非互動式模式 中，執行會中止，因為文字記錄只會增長，重試無法成功。 要做什麼：
  • 在出現的提示中批准或拒絕該動作
  • 執行 /compact 以減少對話大小，以便後續動作再次適應分類器視窗內

​
使用限制

這些錯誤表示與您的帳戶或計畫相關的配額已達到。它們與影響所有人的 server errors 不同。

​
You’ve hit your session limit

訂閱計畫包括滾動使用額度。當它用完時，您會看到以下訊息之一： 
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
Claude Code 會阻止進一步的請求，直到訊息中顯示的重設時間。 要做什麼：
  • 等待錯誤中顯示的重設時間
  • 執行 /usage 以查看您的計畫限制及其重設時間
  • 執行 /extra-usage 以在 Pro 和 Max 上購買額外使用，或在 Team 和 Enterprise 上向您的管理員請求。請參閱 Extra usage for paid plans 以了解如何計費。
  • 若要升級您的計畫以獲得更高的基本限制，請參閱 claude.com/pricing
若要在達到限制之前監視您的剩餘額度，請將 rate_limits 欄位新增到 custom status line，或在 Desktop app 中按一下模型選擇器旁邊的 usage ring。

​
Server is temporarily limiting requests

API 應用了與您的計畫配額無關的短期節流。 
API Error: Server is temporarily limiting requests (not your usage limit)
這在顯示之前會 retried automatically。 要做什麼：

​
Request rejected (429)

您已達到為您的 API 金鑰、Amazon Bedrock 專案或 Google Vertex AI 專案配置的速率限制。 
API Error: Request rejected (429) · this may be a temporary capacity issue
要做什麼：
  • 執行 /status 並確認活躍的認證是您期望的。環境中的流浪 ANTHROPIC_API_KEY 可能會透過低階金鑰而不是您的訂閱路由請求。
  • 檢查您的提供者主控台以了解活躍的限制，並在需要時請求更高的層級
  • 對於 Anthropic API 金鑰，請參閱 rate limits reference 以了解層級如何運作以及如何設定每個工作區的上限
  • 降低並行性：降低 CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY、避免執行許多平行子代理，或使用 /model 切換到較小的模型以進行高容量指令碼執行

​
Credit balance is too low

您的 Console 組織已用完預付額度。 
Credit balance is too low
要做什麼：
  • 在 platform.claude.com/settings/billing 新增額度，並考慮在那裡啟用自動重新載入，以便在達到零之前重新填充餘額
  • 如果您有 Pro、Max、Team 或 Enterprise 計畫，請使用 /login 切換到訂閱認證
  • 在 Console 中設定每個工作區的支出上限，以防止單個專案耗盡組織餘額。請參閱 Manage costs effectively。

​
認證錯誤

這些錯誤表示 Claude Code 無法向 API 證明您的身份。隨時執行 /status 以查看目前活躍的認證。

​
Not logged in

此工作階段沒有有效的認證可用。 
Not logged in · Please run /login
要做什麼：
  • 執行 /login 以使用您的 Claude 訂閱或 Console 帳戶進行認證
  • 如果您期望環境變數對您進行認證，請確認 ANTHROPIC_API_KEY 已在您啟動 claude 的 shell 中設定並匯出
  • 對於無法進行互動式登入的 CI 或自動化，請配置一個 apiKeyHelper 指令碼，在啟動時擷取金鑰
  • 請參閱 Authentication precedence 以了解當存在多個認證時哪個會獲勝
如果系統提示您重複登入，請參閱 Not logged in or token expired 以了解系統時鐘和 macOS Keychain 修復。

​
Invalid API key

ANTHROPIC_API_KEY 環境變數或 apiKeyHelper 指令碼傳回的金鑰被 API 拒絕。 
Invalid API key · Fix external API key
要做什麼：
  • 檢查拼寫錯誤，並確認金鑰未在 Console 中被撤銷
  • 在同一個 shell 中執行 env | grep ANTHROPIC。direnv、dotenv shell 外掛程式和 IDE 終端等工具可以從您的專案中的 .env 檔案載入過時的金鑰，而無需您明確設定它。
  • 取消設定 ANTHROPIC_API_KEY 並執行 /login 以改用訂閱認證
  • 如果金鑰來自 apiKeyHelper 指令碼，請直接執行指令碼以確認它在 stdout 上列印有效的金鑰
  • 執行 /status 以確認 Claude Code 實際使用的認證來源

​
This organization has been disabled

來自已停用 Console 組織的過時 ANTHROPIC_API_KEY 正在覆蓋您的訂閱登入。 
Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
API Error: 400 ... This organization has been disabled.
環境變數優先於 /login，因此在您的 shell 設定檔中匯出或從 .env 檔案載入的金鑰即使您有有效的 Pro 或 Max 訂閱也會被使用。在非互動式模式 (-p) 中，當存在金鑰時總是使用該金鑰。 要做什麼：
  • 在目前的 shell 中取消設定 ANTHROPIC_API_KEY 並從您的 shell 設定檔中移除它，然後重新啟動 claude
  • 之後執行 /status 以確認活躍的認證是您的訂閱
  • 如果未設定環境變數且錯誤持續存在，則已停用的組織是與您的 /login 相關聯的組織。聯絡支援或使用不同的帳戶登入。

​
Routines are disabled by your organization’s policy

您的 Team 或 Enterprise 管理員已在組織層級關閉了例程。當您嘗試建立或執行例程時會出現此錯誤，包括從 /schedule 和 claude.ai/code 上的 Routines UI。 
Routines are disabled by your organization's policy.
這是一個伺服器端設定，因此無法從本機設定、環境變數或 CLI 旗標覆蓋。 要做什麼：

​
OAuth token revoked or expired

您的已儲存登入不再有效。撤銷的令牌表示您在任何地方登出或管理員移除了存取權；過期的令牌表示自動重新整理在工作階段中途失敗。 
OAuth token revoked · Please run /login
OAuth token has expired · Please run /login
API Error: 401 ... authentication_error
要做什麼：
  • 執行 /login 以再次登入
  • 如果在同一工作階段中重新認證後錯誤返回，請先執行 /logout 以完全清除儲存的令牌，然後執行 /login
  • 對於跨啟動的重複登入提示，請參閱 Troubleshooting 中的系統時鐘和 macOS Keychain 檢查
  • 對於其他失敗（包括 403 Forbidden 和 OAuth 瀏覽器問題），請參閱 Login and authentication

​
OAuth scope requirement

儲存的令牌早於較新功能所需的權限範圍。您最常從 /usage 和狀態行使用指標看到這一點： 
OAuth token does not meet scope requirement: user:profile
要做什麼：
  • 執行 /login 以使用目前的範圍鑄造新令牌。您不需要先登出。

​
網路和連線錯誤

這些錯誤表示 Claude Code 的網路請求無法到達其目的地。它們通常源於您的本地網路、代理或防火牆，或雲端環境的網路政策。

​
Unable to connect to API

到 API 的 TCP 連線失敗或從未完成。 
Unable to connect to API. Check your internet connection
Unable to connect to API (ECONNREFUSED)
Unable to connect to API (ECONNRESET)
Unable to connect to API (ETIMEDOUT)
fetch failed
Request timed out. Check your internet connection and proxy settings
常見原因包括沒有網際網路存取、阻止 api.anthropic.com 的 VPN 或未配置的必需公司代理。 要做什麼：
  • 透過從同一個 shell 執行 curl -I https://api.anthropic.com 來確認您可以到達 API 主機。在 Windows PowerShell 上使用 curl.exe -I https://api.anthropic.com 以便不使用內建的 Invoke-WebRequest 別名。
  • 如果您在公司代理後面，請在啟動 Claude Code 之前設定 HTTPS_PROXY 並參閱 Network configuration
  • 如果您透過 LLM 閘道或中繼路由，請將 ANTHROPIC_BASE_URL 設定為其位址。請參閱 LLM gateway configuration 以了解設定。
  • 確保您的防火牆允許 Network access requirements 中列出的主機
  • 間歇性失敗會 自動重試；持續失敗指向本地網路問題
如果 curl 成功但 Claude Code 仍然失敗，原因通常是執行時和網路之間的某些東西，而不是網路本身：
  • 在 Linux 和 WSL 上，檢查 /etc/resolv.conf 是否有無法到達的名稱伺服器。WSL 特別可以從主機繼承損壞的解析器。
  • 在 macOS 上，已斷開連線或卸載的 VPN 用戶端可能會留下隧道介面或路由規則。檢查 ifconfig 以了解過時的 utun 介面，並在系統設定中移除 VPN 的網路擴充功能。
  • Docker Desktop 和類似的容器執行時可以攔截出站流量。退出它們並重試以排除這一點。

​
SSL certificate errors

您網路上的代理或安全設備正在使用其自己的憑證攔截 TLS 流量，而 Claude Code 不信任它。 
Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
Unable to connect to API: Self-signed certificate detected
要做什麼：
  • 匯出您組織的 CA 套件，並使用 NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem 指向 Claude Code
  • 請參閱 Network configuration 以了解完整的設定說明
  • 不要設定 NODE_TLS_REJECT_UNAUTHORIZED=0，這會完全停用憑證驗證

​
Host not allowed in a cloud session

來自雲端工作階段或例行程序的出站 HTTP 請求被環境的網路政策阻止。 
HTTP 403
x-deny-reason: host_not_allowed
您也可能看到與目的地實際憑證不符的 TLS 憑證。雲端環境透過代理路由出站流量以強制執行網路政策，因此不符的憑證表示代理終止了連線，而不是目的地。 這不是用戶端網路問題。雲端工作階段和 routines 在沙箱環境內執行，其出站流量被篩選到環境的允許清單。Default 環境使用 Trusted 存取，允許 預設允許清單 的套件登錄、雲端提供者 API、容器登錄和常見開發網域，但阻止其他所有內容。 要做什麼：
  • 開啟例行程序進行編輯，或啟動雲端工作階段。選擇顯示您環境名稱的雲端圖示，例如 Default，以開啟選擇器。將滑鼠懸停在您的環境上，然後按一下設定圖示。
  • 在 Update cloud environment 對話方塊中，將 Network access 從 Trusted 變更為 Custom，然後將被阻止的網域新增至 Allowed domains。每行輸入一個網域。勾選 Also include default list of common package managers 以在自訂網域旁保留 預設允許清單。如果您想要不受限制的存取，請改為選擇 Full。
  • 按一下 Save changes。下一次執行使用更新的允許清單。
請參閱 Network access 以了解存取層級和預設允許清單。本地 CLI 工作階段不受此政策影響。

​
請求錯誤

這些錯誤表示 API 收到了您的請求但拒絕了其內容。

​
Prompt is too long

對話加上附加檔案超過了模型的上下文視窗。 
Prompt is too long
要做什麼：
  • 執行 /compact 以總結較早的轉向並釋放空間，或執行 /clear 以重新開始
  • 執行 /context 以查看消耗視窗的內容的細目：系統提示、工具、記憶檔案和訊息
  • 使用 /mcp disable <name> 停用您未使用的 MCP 伺服器，以從上下文中移除其工具定義
  • 修剪大型 CLAUDE.md 記憶檔案，或將說明移至 path-scoped rules，這些規則僅在相關時載入
  • 子代理從父工作階段繼承每個 MCP 工具定義，這可能會在第一個轉向之前填滿其上下文視窗。在生成子代理之前停用您未使用的 MCP 伺服器。
  • 自動壓縮預設為開啟，通常可防止此錯誤。如果您已設定 DISABLE_AUTO_COMPACT，請重新啟用它或在視窗填滿之前手動執行 /compact。
請參閱 Explore the context window 以取得上下文如何填滿的互動式檢視。

​
Error during compaction: Conversation too long

/compact 本身失敗，因為沒有足夠的可用上下文來保存它產生的摘要。 
Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.
當視窗在自動壓縮觸發時已經滿了，或當您在看到 Prompt is too long 後執行 /compact 時，可能會發生這種情況。 要做什麼：
  • 按 Esc 兩次以開啟訊息清單並回退幾個轉向。這會從上下文中刪除最近的訊息。然後再次執行 /compact。
  • 如果回退沒有釋放足夠的空間，請執行 /clear 以啟動新的工作階段。您之前的對話已保留，可以使用 /resume 重新開啟。

​
Request too large

原始請求主體在標記化之前超過了 API 的位元組限制，通常是因為貼上的大型檔案或附件。 
Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.
這是 HTTP 請求的大小限制，與 context window limit 分開。 要做什麼：
  • 按 Esc 兩次並回退到新增超大內容的轉向之前
  • 按路徑參考大型檔案而不是貼上其內容，以便 Claude 可以分塊讀取它們
  • 對於影像，請參閱下面的 Image was too large

​
Image was too large

貼上或附加的影像超過了 API 的大小或尺寸限制。 
Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size
影像在錯誤後保留在對話歷史記錄中，因此每個後續訊息都會失敗，出現相同的錯誤，直到您移除它。 要做什麼：
  • 按 Esc 兩次並回退到新增影像的轉向之前
  • 在貼上之前調整影像大小。API 接受單個影像最長邊最多 8000 像素的影像，或當許多影像在上下文中時為 2000 像素。
  • 拍攝相關區域的更緊密螢幕截圖，而不是整個螢幕

​
PDF errors

您附加的 PDF 無法處理。 
PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.
PDF is password protected. Try removing protection or extracting text first.
The PDF file was not valid. Try converting to a different format first.
要做什麼：
  • 對於超大 PDF，請要求 Claude 使用 Read 工具讀取頁面範圍，而不是附加整個檔案，或使用 pdftotext 等工具提取文字並按路徑參考輸出檔案
  • 對於受保護或無效的 PDF，移除密碼或從其來源應用程式重新匯出檔案，然後再試一次

​
Extra inputs are not permitted

Claude Code 和 API 之間的代理或 LLM 閘道剝離了 anthropic-beta 請求標頭，因此 API 拒絕了依賴它的欄位。 
API Error: 400 ... Extra inputs are not permitted ... context_management
API Error: 400 ... Extra inputs are not permitted ... tools.0.custom.input_examples
API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header
Claude Code 傳送僅限測試版的欄位（例如 context_management、effort 和工具 input_examples）以及啟用它們的 anthropic-beta 標頭。當閘道轉發主體但刪除標頭時，API 會看到它不識別的欄位。 要做什麼：

​
There’s an issue with the selected model

配置的模型名稱未被識別，或您的帳戶缺乏對其的存取權。 
There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to select a different one.
要做什麼：
  • 執行 /model 以從您帳戶可用的模型中選擇
  • 使用別名（例如 sonnet 或 opus）而不是完整的版本化 ID。別名追蹤最新版本，因此它們不會過時。請參閱 Model configuration。
  • 如果錯誤的模型一直出現，則某處設定了過時的 ID。按 優先順序 檢查：--model 旗標、ANTHROPIC_MODEL 環境變數，然後是 .claude/settings.local.json 中的 model 欄位、您專案的 .claude/settings.json 和 ~/.claude/settings.json。移除過時的值，Claude Code 會回退到您的帳戶預設值。
  • 對於 Vertex AI 部署，請參閱 Vertex AI troubleshooting。

​
Claude Opus is not available with the Claude Pro plan

您的活躍訂閱計畫不包括您選擇的模型。 
Claude Opus is not available with the Claude Pro plan · Select a different model in /model
要做什麼：
  • 執行 /model 並選擇您的計畫包括的模型
  • 如果您最近升級了計畫但仍然看到這個，請執行 /logout 然後 /login。儲存的令牌反映您登入時的計畫，因此在現有工作階段中升級網路不會生效，直到您重新認證。
  • 請參閱 claude.com/pricing 以了解每個計畫包括哪些模型

​
thinking.type.enabled is not supported for this model

您的 Claude Code 版本早於 Opus 4.7 的最低版本。CLI 傳送了模型不再接受的思考配置。 
API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
要做什麼：
  • 執行 claude update 以升級到 v2.1.111 或更新版本，然後重新啟動 Claude Code
  • 如果您無法升級，請執行 /model 並選擇 Opus 4.6 或 Sonnet
  • 如果您在 Agent SDK 中遇到這個，請參閱 SDK troubleshooting

​
Thinking budget exceeds output limit

配置的擴展思考預算超過最大回應長度，因此實際答案沒有剩餘空間。 
API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
Claude Code 在 Anthropic API 上自動調整這些值。當 MAX_THINKING_TOKENS 設定高於提供者的輸出限制時，或當計畫模式提高思考預算時，您通常會在 Amazon Bedrock 或 Google Vertex AI 上看到此錯誤。 要做什麼：

​
Tool use or thinking block mismatch

對話歷史記錄以不一致的狀態到達 API，通常是在工具呼叫被中斷或轉向在流中途被編輯後。 
API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified
所有三個變體都表示相同的事情：歷史記錄中 tool_use、tool_result 和 thinking 區塊的序列不再與 API 期望的相符。 要做什麼：
  • 執行 /rewind，或按 Esc 兩次，以回退到損壞轉向之前的檢查點並從那裡繼續。請參閱 Checkpointing 以了解如何建立和恢復檢查點。

​
回應品質似乎低於平常

如果 Claude 的答案似乎不如您預期的那樣有能力，但沒有顯示錯誤，原因通常是對話狀態而不是模型本身。Claude Code 不會無聲地更改模型版本。它可以在特定情況下切換到後備模型，例如達到 Opus 配額或 Bedrock 或 Vertex AI 區域缺乏您的模型；下面的模型選擇檢查會捕獲兩者，Model configuration 解釋何時應用後備。 首先檢查這些：
  • 模型選擇：執行 /model 以確認您在您期望的模型上。之前的 /model 選擇或 ANTHROPIC_MODEL 環境變數可能會讓您使用比您想要的更小的模型。
  • 努力級別：執行 /effort 以檢查目前的推理級別，並為困難的除錯或設計工作提高它。預設值因模型而異，因此在假設您低於最大值之前請檢查。請參閱 Adjust effort level 以了解每個模型的預設值和 ultrathink 快捷方式。
  • 上下文壓力：執行 /context 以查看視窗的滿度。如果接近容量，請在自然斷點執行 /compact 或執行 /clear 以重新開始。請參閱 Explore the context window 以了解自動壓縮如何影響較早的轉向。
  • 過時的說明：大型或過時的 CLAUDE.md 檔案和 MCP 工具定義消耗上下文，可能會引導回應。/doctor 標記超大記憶檔案和子代理定義；/context 顯示 MCP 工具令牌使用。
當回應出錯時，回退通常比用更正回覆效果更好。按 Esc 兩次或執行 /rewind 以回退到不良轉向之前，然後用更多細節重新表述提示。在執行緒中更正會將錯誤的嘗試保留在上下文中，這可能會將後來的答案錨定到它。請參閱 Checkpointing。 如果在檢查上述內容後品質仍然似乎有問題，請執行 /feedback 並描述您期望的內容與您得到的內容。以這種方式提交的反饋包括對話記錄，這是 Anthropic 診斷真實回歸的最快方式。如果您的提供者上 /feedback 不可用，請參閱 Report an error。

​
報告錯誤

本頁涵蓋來自 Claude API 的錯誤。對於來自其他 Claude Code 元件的錯誤，請參閱相關指南： 如果此處未列出錯誤或建議的修復無法幫助：
  • 在 Claude Code 內執行 /feedback 以將記錄和描述傳送給 Anthropic。該命令還提供開啟預填充 GitHub 問題的選項。Bedrock、Vertex AI 和 Foundry 部署上不提供反饋。
  • 執行 /doctor 以檢查本地配置問題
  • 檢查 status.claude.com 以了解活躍的事件
  • 在 GitHub 上搜尋 existing issues