文档索引

获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后进一步探索。

错误参考

查找 Claude Code 运行时错误消息，了解每个错误的含义及修复方法。

本页列出 Claude Code 显示的运行时错误以及每个错误的恢复方法，还包括在响应异常但无错误时应检查的内容。关于安装错误（如 command not found 或设置过程中的 TLS 失败），请参阅排查安装和登录问题。

这些错误和恢复命令适用于 CLI、桌面应用和 Web 版 Claude Code，因为三者都封装了相同的 Claude Code CLI。关于特定界面的问题，请参阅该界面页面上的故障排除部分。

查找你的错误

将终端中看到的消息与下方章节进行匹配。

自动重试

Claude Code 在显示错误之前会自动重试瞬时故障。服务器错误、过载响应、请求超时、临时 429 限流和断开连接都会被重试最多 10 次，采用指数退避策略。重试期间，加载指示器会显示 Retrying in Ns · attempt x/y 倒计时。

当你看到本页上的某个错误时，这些重试已经全部用尽。你可以通过两个环境变量调整此行为：

服务器错误

这些错误来自推理提供商，而非你的账户或请求。在 Anthropic API 上，这意味着 Anthropic 基础设施。在 Bedrock、Vertex AI、Foundry 或自定义网关上，则意味着该提供商的基础设施。

API Error: 500 Internal server error

Claude Code 对任何 5xx 响应显示状态码和 API 错误消息。以下示例显示 Anthropic API 上的 500 响应：

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check status.claude.com.

末尾句子指出了检查服务状态的位置，因提供商而异。Bedrock、Vertex AI 和 Foundry 配置会显示该提供商的服务状态页面。自定义 ANTHROPIC_BASE_URL 会显示网关主机名。

这表明 API 内部发生了意外故障，不是由你的提示、设置或账户引起的。

处理方法：

• 检查 status.claude.com 或消息中提到的提供商状态页面，查看是否有正在进行的故障
• 等待一分钟，然后重新发送消息。你的原始消息仍在对话中，因此对于长提示，你可以输入 try again 而不是重新粘贴全部内容
• 如果错误持续且无已发布故障，运行 /feedback 让 Anthropic 通过你的请求详情进行调查。如果 /feedback 在你的环境中不可用，请参阅报告错误

API Error: Repeated 529 Overloaded errors

API 暂时达到所有用户的容量上限。Claude Code 在显示此消息之前已经重试了多次：

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check status.claude.com.

末尾句子因提供商而异，与上述 500 错误相同。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 分钟。

处理方法：

• 重试请求
• 对于长时间运行的任务，将工作拆分为更小的提示
• 如果是慢速网络或代理导致的，按自动重试中所述增大 API_TIMEOUT_MS
• 如果超时频繁且网络本身正常，请参阅下方的网络和连接错误

Auto mode cannot determine the safety of an action

自动模式用于对操作进行分类的模型未能做出决定，因此自动模式未自动批准该操作。你看到的消息取决于分类器失败的原因。

工作目录内的读取、搜索和编辑操作会跳过分类器，因此在所有这些情况下仍可正常工作。

当分类器模型过载时：

<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 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)

在交互式会话中，自动模式会回退到正常的权限提示，你可以手动批准或拒绝。在非交互模式下，运行会中止，因为转录内容只会增长，重试无法成功。

处理方法：

• 在出现的提示中批准或拒绝该操作
• 运行 /compact 减少对话大小，使后续操作重新适合分类器窗口

使用限制

这些错误意味着你的账户或计划关联的配额已用尽。它们与影响所有人的服务器错误不同。

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 查看你的计划限制和重置时间
• 运行 /usage-credits 在 Pro 和 Max 上购买额外使用量，或在 Team 和 Enterprise 上向管理员申请。关于计费方式，请参阅付费计划的使用信用
• 要升级计划以获得更高的基础限制，请参阅 claude.com/pricing

要在达到限制前查看剩余配额，可将 rate_limits 字段添加到自定义状态行，或在桌面应用中点击模型选择器旁边的使用量环。

Server is temporarily limiting requests

API 应用了与你的计划配额无关的短期限流。

API Error: Server is temporarily limiting requests (not your usage limit)

在显示之前已被自动重试。

处理方法：

• 稍等片刻再重试
• 如果持续存在，检查 status.claude.com

Request rejected (429)

你已达到 API 密钥、Amazon Bedrock 项目或 Google Vertex AI 项目配置的速率限制。

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check status.claude.com.

末尾句子指出了检查服务状态的位置，因提供商而异。Bedrock、Vertex AI 和 Foundry 配置会显示该提供商的服务状态页面而非 Anthropic 状态页面。自定义 ANTHROPIC_BASE_URL 会显示网关主机名。

处理方法：

• 运行 /status 确认活动凭据是你期望的。环境中残留的 ANTHROPIC_API_KEY 可能会将请求路由到低级别密钥而非你的订阅
• 在提供商控制台中检查活动限制，必要时请求更高级别
• 关于 Anthropic API 密钥，请参阅速率限制参考了解层级工作方式和按工作区设置上限
• 降低并发：降低 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 中设置按工作区的支出上限，防止单个项目耗尽组织余额。请参阅有效管理成本。

身份验证错误

这些错误意味着 Claude Code 无法向 API 证明你的身份。随时运行 /status 查看当前活动的凭据。

Not logged in

此会话没有可用的有效凭据。

Not logged in · Please run /login

处理方法：

• 运行 /login 使用你的 Claude 订阅或 Console 账户进行身份验证
• 如果你期望通过环境变量进行身份验证，请确认 ANTHROPIC_API_KEY 已在启动 claude 的 shell 中设置并导出
• 对于无法进行交互式登录的 CI 或自动化场景，配置一个 apiKeyHelper 脚本在启动时获取密钥
• 参阅身份验证优先级了解当存在多个凭据时哪个优先

如果你反复被提示登录，请参阅未登录或令牌过期了解系统时钟和 macOS 钥匙串修复方法。

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 脚本，直接运行该脚本确认其在标准输出上打印有效密钥
• 运行 /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 关联的组织。联系支持人员或使用其他账户登录

Your organization has disabled Claude subscription access

你的 Claude 组织不允许使用订阅登录 Claude Code。使用同一账户再次运行 /login 会返回相同的错误。

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

这是服务器端的组织设置，无法从本地设置、环境变量或 CLI 标志覆盖。Agent SDK 和 -p 非交互模式会将其显示为 oauth_org_not_allowed 错误代码。

处理方法：

• 请你的管理员为组织启用 Claude Code 访问权限
• 使用 Console API 密钥而非订阅进行身份验证。关于设置方法，请参阅 Claude Console 身份验证
• 如果你是管理员但看不到启用选项，请联系 Anthropic 支持

Routines are disabled by your organization's policy

你的 Team 或 Enterprise 管理员已在组织级别关闭了例行程序。当你尝试创建或运行例行程序时会出现此错误，包括从 /schedule 和 claude.ai/code 上的例行程序 UI 操作。

Routines are disabled by your organization's policy.

这是服务器端设置，无法从本地设置、环境变量或 CLI 标志覆盖。

处理方法：

• 请你的管理员在 claude.ai/admin-settings/claude-code 启用例行程序开关
• 对于不需要组织级例行程序的一次性计划任务，请参阅计划任务

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
• 对于跨启动反复提示登录的情况，请参阅故障排除中的系统时钟和 macOS 钥匙串检查
• 对于其他失败（包括 403 Forbidden 和 OAuth 浏览器问题），请参阅登录和身份验证

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

常见原因包括无网络访问、VPN 阻止了 api.anthropic.com，或未配置必需的企业代理。

处理方法：

• 在同一 shell 中运行 curl -I https://api.anthropic.com 确认你能访问 API 主机。在 Windows PowerShell 上使用 curl.exe -I https://api.anthropic.com，以避免使用内置的 Invoke-WebRequest 别名
• 如果你在企业代理后面，启动 Claude Code 前设置 HTTPS_PROXY，并参阅网络配置
• 如果你通过 LLM 网关或中继路由，将 ANTHROPIC_BASE_URL 设置为其地址。关于设置方法，请参阅 LLM 网关配置
• 确保你的防火墙允许网络访问要求中列出的主机
• 间歇性故障会被自动重试；持续性故障指向本地网络问题

如果 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 指向它
• 参阅网络配置获取完整设置说明
• 不要设置 NODE_TLS_REJECT_UNAUTHORIZED=0，这会完全禁用证书验证

Host not allowed in a cloud session

来自云端会话或例行程序的出站 HTTP 请求被环境的网络策略阻止。

HTTP 403
x-deny-reason: host_not_allowed

你也可能看到与目标真实证书不匹配的 TLS 证书。云环境通过代理路由出站流量以执行网络策略，因此证书不匹配意味着代理终止了连接，而非目标。

这不是客户端网络问题。云端会话和例行程序运行在沙箱环境中，其出站流量被过滤为环境的允许列表。默认环境使用受信访问，允许默认允许列表中的包注册表、云提供商 API、容器注册表和常见开发域名，但阻止其他所有内容。

处理方法：

• 打开例行程序进行编辑，或启动云端会话。选择显示环境名称的云图标（如 Default）打开选择器。将鼠标悬停在你的环境上并点击设置图标
• 在更新云环境对话框中，将网络访问从受信更改为自定义，然后将被阻止的域名添加到允许的域名。每行输入一个域名。勾选同时包含常用包管理器默认列表以保留默认允许列表。如果你想要不受限制的访问，请选择完全
• 点击保存更改。下次运行将使用更新后的允许列表。

参阅网络访问了解访问级别和默认允许列表。本地 CLI 会话不受此策略影响。

请求错误

这些错误意味着 API 收到了你的请求但拒绝了其内容。

Prompt is too long

对话加上附加文件超出了模型的上下文窗口。

Prompt is too long

处理方法：

• 运行 /compact 总结早期对话并释放空间，或 /clear 全新开始
• 运行 /context 查看上下文窗口消耗的详细信息：系统提示、工具、记忆文件和消息
• 使用 /mcp disable <name> 禁用未使用的 MCP 服务器，以从上下文中移除其工具定义
• 精简大型 CLAUDE.md 记忆文件，或将指令移入仅在相关时加载的路径范围规则
• 子代理从父会话继承每个 MCP 工具定义，这可能在第一轮之前就填满其上下文窗口。在生成子代理之前禁用未使用的 MCP 服务器
• 自动压缩默认开启，通常会防止此错误。如果你设置了 DISABLE_AUTO_COMPACT，请重新启用它或在窗口填满前手动运行 /compact

参阅探索上下文窗口了解上下文如何填满的交互式视图。

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 请求的大小限制，与上下文窗口限制不同。

处理方法：

• 按两次 Esc 并回退到添加超大内容之前的对话轮次
• 通过路径引用大文件而非粘贴其内容，这样 Claude 可以分块读取
• 关于图片，请参阅下方的图片过大

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 像素
• 对相关区域截取更紧凑的截图而非全屏

Unable to resize image

Claude Code 在发送给 API 前无法缩小附加图片。

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

Claude Code 通常会自动调整大图片的大小。这些错误意味着原生图片处理器加载失败或返回错误，因此无法将图片调整到 API 限制范围内。

处理方法：

• 如果消息要求你转换图片，请将其转换为 PNG、JPEG、GIF 或 WebP 格式并重新附加。Claude Code 可以在不使用图片处理器的情况下验证这些格式的尺寸
• 如果消息报告了尺寸或大小限制，请在附加前将图片调整或重新压缩到该限制以下

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 会看到无法识别的字段。

处理方法：

• 配置你的网关转发 anthropic-beta 头。参阅 LLM 网关配置
• 作为备选方案，启动前设置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1。这会禁用需要测试版头的功能，使请求在无法转发该头的网关中也能成功

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。别名跟踪最新版本，不会过期。参阅模型配置
• 如果错误的模型反复出现，说明某处设置了过期的 ID。按优先级顺序检查：--model 标志、ANTHROPIC_MODEL 环境变量、.claude/settings.local.json 中的 model 字段、项目的 .claude/settings.json 和 ~/.claude/settings.json。移除过期值后 Claude Code 会回退到你的账户默认值
• 关于 Vertex AI 部署，请参阅 Vertex AI 故障排除

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 发送了模型不再接受的 thinking 配置。

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 故障排除

Thinking budget exceeds output limit

配置的扩展思考预算超出了最大响应长度，因此没有空间留给实际答案。

API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

Claude Code 在 Anthropic API 上自动调整这些值。你通常在 Amazon Bedrock 或 Google Vertex AI 上看到此错误，当 MAX_THINKING_TOKENS 设置得高于提供商的输出限制，或计划模式提高了思考预算时。

处理方法：

• 降低 MAX_THINKING_TOKENS，或提高 CLAUDE_CODE_MAX_OUTPUT_TOKENS 使其高于思考预算
• 参阅扩展思考了解预算如何与输出长度交互

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，回退到损坏对话轮次之前的检查点并从那里继续。参阅检查点了解检查点的创建和恢复方式

Usage Policy refusal

API 拒绝响应，因为对话中的内容触发了使用政策检查。消息包含一个请求 ID，如果你认为拒绝不正确，可以向支持人员引用。

API Error: Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

检查评估的是完整对话而非仅你的最新提示，因此在同一会话中发送新消息通常会再次触发相同的拒绝。使用 --continue 或 --resume 退出并重新打开会话后也是如此，因为磁盘上的转录内容仍包含触发内容。

处理方法：

• 按两次 Esc 或运行 /rewind 回退到触发拒绝之前的检查点，然后重新表述或采取不同的方法。参阅检查点
• 如果无法确定是哪一轮导致的，运行 /clear 在同一项目中开始新对话。你的先前对话已保存在磁盘上，可通过 /resume 访问
• 在非交互模式（-p）下，回退不可用，请使用重新表述的提示重试或在不使用 --continue 的情况下启动新会话

响应质量似乎低于平常

如果 Claude 的回答似乎比你预期的能力弱但未显示错误，原因通常是对话状态而非模型本身。Claude Code 不会悄悄更改模型版本。在特定情况下（如 Opus 配额用尽或 Bedrock/Vertex AI 区域缺少你的模型）它可能切换到备用模型；下方的模型选择检查可捕获这两种情况，模型配置解释了何时适用备用模型。

首先检查以下内容：

• 模型选择：运行 /model 确认你使用的是预期的模型。之前的 /model 选择或 ANTHROPIC_MODEL 环境变量可能使你使用了比预期更小的模型
• 努力级别：运行 /effort 检查当前推理级别，对于困难的调试或设计工作可提高它。默认值因模型而异，因此在假设低于最大值之前请先检查。参阅调整努力级别了解各模型默认值和 ultrathink 快捷方式
• 上下文压力：运行 /context 查看窗口的填充程度。如果接近容量，在自然断点运行 /compact 或 /clear 全新开始。参阅探索上下文窗口了解自动压缩如何影响早期对话轮次
• 过期指令：大型或过时的 CLAUDE.md 文件和 MCP 工具定义会消耗上下文并可能引导响应方向。/doctor 会标记超大记忆文件和子代理定义；/context 显示 MCP 工具的 token 使用量

当响应出错时，回退通常比用修正来回复更好。按两次 Esc 或运行 /rewind 回退到错误轮次之前，然后用更多细节重新表述提示。在对话线程中修正会将错误尝试保留在上下文中，这可能使后续答案锚定到它。参阅检查点。

如果检查上述内容后质量仍不理想，运行 /feedback 描述你的预期与实际结果。通过此方式提交的反馈包含对话转录，这是 Anthropic 诊断真正回归的最快方式。如果 /feedback 在你的环境中不可用，请参阅报告错误。

报告错误

本页涵盖 Claude API 的错误。关于其他 Claude Code 组件的错误，请参阅相关指南：

• MCP 服务器连接或认证失败：MCP
• Hook 脚本失败或阻止了工具：调试 hooks
• 安装过程中权限被拒绝或文件系统错误：排查安装和登录问题

如果错误未列在此处或建议的修复方法无效：

• 在 Claude Code 中运行 /feedback 向 Anthropic 发送转录和描述。该命令还提供打开预填 GitHub issue 的选项。在 Bedrock、Vertex AI、Foundry 和其他第三方提供商上，/feedback 会保存本地归档，你可以将其发送给 Anthropic 账户代表
• 运行 /doctor 检查本地配置问题
• 检查 status.claude.com 查看是否有正在进行的故障
• 在 GitHub 上搜索现有 issues