跳转到主要内容
报错原文对照

Claude Code 报错原文对照：每条报错的原因在哪一侧、怎么修

输入或粘贴你看到的报错来筛选。每条都标明原因在本机、账号、服务端还是中间的网关，再链到完整的修复步骤。
  • 72 条报错
  • 17 篇修复文章
  • 2026年11月15日 核对

登录、账号与验证

  • Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh

    这篇文章还覆盖

    • Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh)
      • 原因：本机或配置
      • CLI
    • EPERM: operation not permitted, mkdir

    登录没有被拒，是另一个 Claude Code 进程占着 ~/.claude 里的续期锁。先等一分钟重试，再关其他进程，确认没人持有后删空锁目录，最后 /login。

    查看修复步骤: another Claude Code process is refreshing it：续期锁被占怎么办文章更新于 2026年11月12日

  • Failed to authenticate. API Error: 403 Your account can't receive replies from Claude right now

    • 原因：账号或套餐
    • CLI
    • HTTP 403

    这篇文章还覆盖

    • Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
      • 原因：账号或套餐
      • CLI
    • Replies from Claude are unavailable on your account. You can complete the verification now in the Anthropic Verification Portal
      • 原因：账号或套餐
      • 网页版
    • Complete verification to continue
      • 原因：账号或套餐
      • 桌面应用

    Claude Code 报 403 can't receive replies，是 Anthropic 要求账号做身份验证，重试和重新登录无效；人在支持地区、有证件原件才符合条件。

    查看修复步骤: Claude Code 报 can't receive replies：重试无效，要不要身份验证文章更新于 2026年11月5日

模型不存在或不可用

  • There's an issue with the selected model (claude-fable-5.2)

    • 原因：有多种可能
    • CLI

    这篇文章还覆盖

    • You've reached your Fable limit.
      • 原因：账号或套餐
      • CLI
    • Fable 5.2's safeguards flagged this message
    • Claude Code doesn't recognize the model "claude-fable-5-2", so it assumes a context window of 200k tokens
    • Fable is experiencing high load, please use /model to switch to Sonnet
      • 原因：服务端
      • CLI
    • Invalid signature in thinking block. The block is bound to a different conversation.
      • 原因：本机或配置
      • API
      • HTTP 400

    Claude Fable 5.2 报错：Claude Code 要 2.1.321 以上、ID 用连字符；API 400 多是请求写法，中转会藏起原因。

    查看修复步骤: Fable 5.2 报错怎么办：报错原文对照，旧版 Claude Code 其实跑 5.1文章更新于 2026年11月14日

限流与容量

  • API Error: Rate limit reached

    • 原因：有多种可能
    • CLI
    • HTTP 429

    这篇文章还覆盖

    • You've hit your session limit · resets 3:45pm
      • 原因：账号或套餐
      • CLI
    • You've hit your weekly limit · resets Mon 12:00am
      • 原因：账号或套餐
      • CLI
    • API Error: Server is temporarily limiting requests (not your usage limit)
      • 原因：服务端
      • CLI
    • API Error: Request rejected (429) · this may be a temporary capacity issue
      • 原因：账号或套餐
      • CLI
      • HTTP 429
    • API Error: Usage credits required for 1M context
      • 原因：账号或套餐
      • CLI

    Claude Code 报 Rate limit reached，先看提示原文：会话或每周限额等重置，模型家族限额换模型，429 查凭据；订阅登录可在原会话自动续跑。

    查看修复步骤: Claude Code Rate Limit Reached 怎么办：认出限额类型，原会话续跑文章更新于 2026年11月10日

  • API Error: Repeated 529 Overloaded errors

    • 原因：服务端
    • CLI
    • HTTP 529

    这篇文章还覆盖

    • Opus is experiencing high load, please use /model to switch to Sonnet
      • 原因：服务端
      • CLI
    • Opus is experiencing high load. Switch to Sonnet.
      • 原因：服务端
      • 桌面应用
    • API Error: Server error mid-response. The response above may be incomplete.
      • 原因：服务端
      • CLI

    Claude Code 报 529 过载时已自动重试过，也不扣额度。容量按模型计算：急用就 /model 换模型，常遇到就配备用模型链，无人值守时让它一直等。

    查看修复步骤: Claude Code 报 529 过载怎么办：换模型还是等待文章更新于 2026年9月28日

服务端错误与连接中断

请求被拒绝

  • API Error: 400 thinking type should be enabled or disabled

    这篇文章还覆盖

    • Only 'enabled' and 'disabled' are supported for thinking; 'adaptive' is not supported.
    • 'type' must be in ["enabled", "disabled", "auto"]
      • 原因：网关或中转
    • adaptive thinking is not supported on this model
    • "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive"
      • 原因：本机或配置
      • HTTP 400

    第三方接口不认 Claude Code 发的 thinking: adaptive。GLM 等模型名下设 CLAUDE_CODE_DISABLE_THINKING=1 即可恢复。

    查看修复步骤: Claude Code 400 thinking type should be enabled or disabled 解决文章更新于 2026年10月21日

应用、IDE 与启动

文件、会话与本地状态

  • Error compacting conversation

    • 原因：有多种可能
    • CLI
    • 桌面应用

    这篇文章还覆盖

    • Conversation too long. Press esc twice to go up a few messages and try again.
    • Prompt is too long · automatic compaction failed:
      • 原因：有多种可能
      • CLI
      • 桌面应用
    • Autocompact is thrashing: the context refilled to the limit within 3 turns of the previous compact, 3 times in a row.
      • 原因：本机或配置
      • CLI
      • 桌面应用
      • 2.1.89 起出现
    • Compaction failed · attached media exceeds size limits
      • 原因：本机或配置
      • CLI
      • 桌面应用
    • Compaction failed · conversation could not be reduced below the context limit
      • 原因：本机或配置
      • CLI
      • 桌面应用

    Error compacting conversation 只说明压缩出错，原因在同时出现的那行报错。先升级，再按原文选回退、局部压缩或 /clear 恢复。

    查看修复步骤: Claude Code 压缩失败：Error compacting conversation 原因与恢复文章更新于 2026年10月16日

  • Error writing file

    这篇文章还覆盖

    • File has been modified since read, either by the user or by a linter. Read it again before attempting to write it.
    • EPERM: operation not permitted
      • 原因：本机或配置
    • InputValidationError: Write failed due to the following issues: The required parameter `file_path` is missing
    • Error editing file

    Error writing file 只是标签，按 Ctrl+O 看原文：读后被改要重读，目录不可写改权限，参数被截断改分块写，Error editing file 同理。

    查看修复步骤: Claude Code Error writing file 报错：Ctrl+O 看原文，按原因修复文章更新于 2026年10月16日

这份清单怎么维护

  • 只收录本站已有文章覆盖的报错，原文逐字取自对应文章。
  • 版本号、HTTP 状态码和 GitHub issue 编号都是对应文章引用的；文章没有给出的，这里留空。
  • 原因标签说明先看哪一侧，怎么确认写在文章里。

清单最后核对于 2026年11月15日。