Claude Code 报错速查：400、403、429、529 等常见报错的含义和解决办法

Claude Code 报错总是挑最忙的时候冒出来，而且提示经常只有半句话。这页是我自己用的速查表，每一条都在 2026 年 10 月 21 日对照 Anthropic 官方的错误参考和安装排错页核过；官方没写的，我会直说没写，不瞎猜。

每个坑都有编号：I 是安装，A 是登录，U 是使用。安装阶段的放在安装教程里，登录和使用阶段的就在下面。在表里找到你看到的那句话，点编号跳过去。

Claude Code 报错速查表

你看到的报错	跳到	阶段
command not found: claude	I1	安装
EACCES: permission denied	I3	安装
npm WARN EBADENGINE	I4	安装
curl: (22) ... 403 / App unavailable in region	I8	安装
OAuth error: Invalid code	A1	登录
API Error: 403 Request not allowed	A2	登录
OAuth error: Request failed with status code 403	A2	登录
Your organization has disabled Claude subscription access	A2	登录
Paste code here if prompted（卡住）	A3	登录
Not logged in · Please run /login	A4	登录
Repeated 529 Overloaded errors	U1	使用
Request rejected (429)	U2	使用
You've hit your session limit	U3	使用
You've hit your weekly limit	U3	使用
Usage credits required for 1M context	U4	使用
This organization has been disabled	U5	使用
Credit balance is too low / Invalid API key	U6	使用
thinking.type.enabled is not supported	U7	使用
thinking type should be enabled or disabled	U7	使用
Error editing file / Error writing file	U8	使用
Error loading webview	U9	使用
今天是不是挂了	U10	使用
Your account is on hold	U11	使用

先查这个：Claude Code 现在用的是哪个凭据

说实话，我帮人看过的 Claude Code 报错里，大概三分之一最后都是同一个原因。Claude Code 按顺序用它找到的第一个凭据：云厂商配置、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、apiKeyHelper 脚本、CLAUDE_CODE_OAUTH_TOKEN，最后才是 /login 登录的订阅（官方顺序）。所以 ~/.zshrc 或项目 .env 里一个老 API key，会悄悄压过你花钱买的 Pro。-p 模式下只要有 key 就一定用 key。

输入 /status。里面有你没想到的 API key 那一行，你的 400、401、429、余额不足基本就是它。修好只要十秒钟，一大串 Claude Code 报错会一起消失。

登录阶段 A1–A4

A1. 登录失败：通用重置

官方的重置步骤很无聊但管用：/logout，退出 Claude Code，重新 claude 登录。OAuth error: Invalid code. Please make sure the full code was copied 是登录码过期或没复制全，浏览器打开后尽快完成。Failed to start OAuth callback server 是没法监听 127.0.0.1（沙箱里常见），官方建议在能正常登录的机器上跑 claude setup-token，把结果设成 CLAUDE_CODE_OAUTH_TOKEN（来源）。

A2. API Error: 403 Request not allowed / OAuth 403

登录后 403，官方的检查清单是：Pro/Max 用户去 claude.ai/settings 确认订阅真的有效（免费版本来就不含 Claude Code）；Console 账号要有 “Claude Code” 或 “Developer” 角色，由管理员分配（来源）。

同类的还有 Your organization has disabled Claude subscription access for Claude Code。这是组织在服务端的设置，本地怎么改都没用，只能找管理员开，或者改用 Console API key（来源）。

A3. WSL2、SSH、容器里登录卡住

浏览器开在回调到不了的地方。浏览器页面会显示一串登录码，粘到 Paste code here if prompted 那里；粘贴不管用就改用 claude auth login。WSL2 里浏览器根本没弹出来的话，把 BROWSER 设成 Windows 浏览器的路径再试（来源）。

A4. 反复提示 Not logged in · Please run /login

先 /login。总是复发的话，看看系统时间准不准。macOS 上 Keychain 被锁是已知原因，claude doctor 会提示 macOS Keychain is not writable。另外 v2.1.211 之前有个 bug，电脑睡眠唤醒后所有会话一起掉登录，版本旧的升级就好（来源）。

使用阶段 U1–U11

U1. 529 Overloaded（还有 500）

API Error: Repeated 529 Overloaded errors 是 API 整体容量满了，不是你的额度问题，官方说这不计入额度。弹出来之前 Claude Code 已经自动重试过了。等几分钟，看 status.claude.com，或者 /model 换个模型（容量按模型分开算）。500 Internal server error 同样是对方的问题（来源）。

U2. 429 Request rejected

官方含义：撞上了 API key、Bedrock 项目或 Google Cloud 项目的速率上限，也就是按量计费那条路，不是订阅。所以先 /status，残留的 ANTHROPIC_API_KEY 会让请求走低档 key。不是这个原因就减少并发，或者申请更高档位。长得不一样的 Server is temporarily limiting requests (not your usage limit) 是服务端短暂限流，v2.1.199 起会自动重试（来源）。

U3. You’ve hit your session limit / weekly limit

这才是套餐额度用完了。提示长这样：You've hit your session limit · resets 3:45pm、You've hit your weekly limit · resets Mon 12:00am。会话额度和周额度是所有模型共用的，换模型没用；单独的 Opus 或 Sonnet 额度是例外。/usage 看什么时候重置，Pro/Max 可以用 /usage-credits 买额外用量；v2.1.234 起 Claude Code 可以等重置后自动接着干（在 /config 里设置）（来源）。两个时钟怎么叠在一起算，我写在Claude 额度怎么算。

搜「claude code usage limit bug」的：GitHub 上有个很大的未关闭讨论 #16157，Max 用户反映额度掉得异常快，我看的时候有 1,499 条评论。官方没有给出我能找到的正式解释，所以原因我不乱说。

U4. Usage credits required for 1M context

不是额度用完。你选了带 [1m] 的模型，而你的套餐只能通过额外用量使用 1M 上下文。/model 选不带 [1m] 的版本；或者打开 usage credits 后重启。设 CLAUDE_CODE_DISABLE_1M_CONTEXT=1 可以把这些选项彻底藏起来（来源）。

U5. 400 This organization has been disabled

字面很吓人，多数时候没事。官方解释：Claude Code 在用一个属于已停用 Console 组织的旧 ANTHROPIC_API_KEY，常见的是前公司或旧项目留在 shell 配置里的 key。不是你的订阅被封。执行 unset ANTHROPIC_API_KEY（PowerShell：Remove-Item Env:ANTHROPIC_API_KEY），从配置文件里删掉，重开，/status 确认。没设环境变量还报错，就联系官方支持（来源）。这条和真正的封号有什么区别，我在Claude 封号申诉笔记里讲过。

U6. Credit balance is too low / Invalid API key / 401

Credit balance is too low：Console 组织预付余额用完，或者又是 API key 顶掉了订阅。Invalid API key：写错、被吊销，或者带了看不见的字符；env | grep ANTHROPIC 能查出 direnv 或 .env 带进来的旧 key。401 Invalid authentication credentials：先看 /status，再 /login 一次（来源）。

U7. 和 thinking 有关的 400

"thinking.type.enabled" is not supported for this model 是你的 Claude Code 版本比模型要求的旧。claude update 后重启。官方最低版本：Opus 4.7 要 v2.1.111，Opus 4.8 要 v2.1.154，Sonnet 5 要 v2.1.197，Opus 5 要 v2.1.219，Opus 5.5 要 v2.1.280，Sonnet 5.5 要 v2.1.284。stable 通道可能要切到 latest（来源）。

API Error: 400 thinking type should be enabled or disabled 是另一回事。这句话根本不在 Anthropic 的错误参考里。据我能查到的，它来自非 Anthropic 的接口：ANTHROPIC_BASE_URL 指向了某个第三方「兼容」API，对方不认 Claude Code 发的 thinking 参数。跑一下 echo $ANTHROPIC_BASE_URL 看看。用 Anthropic 自己的 API 或订阅不会出现这个 Claude Code 报错。第三方接口的问题本站不展开。

400 due to tool use concurrency issues 是会话历史坏了，按提示 /rewind（来源）。

U8. Error editing file / Error writing file

对话里只显示短短一句 Error editing file，真正原因在转录视图（Ctrl+O）里，一般 Claude 会自己重试。常见的一种是 Found 2 matches of the string to replace，要替换的文本不唯一（#3337）。「Error writing file」官方错误参考里没有单独条目，官方含义我没法告诉你，去转录视图看底下那句原始报错。

U9. VS Code：Error loading webview

这条官方也没写。官方能确定的只有：扩展要求 VS Code 1.94.0 以上。典型的报告像 #24142（service worker 注册失败，已关闭）。先升级 VS Code 和扩展，再重载窗口。再往下就是社区的各种猜测了，我不想把它当成解决办法写。

U10. Claude Code 今天是不是挂了

看 status.claude.com（旧的 status.anthropic.com 会跳过去）。我 10 月 21 日看的时候显示 All Systems Operational，最近一次重大事故是北京时间 10 月 7 日晚上。状态页全绿、只有你一个人报错，就回去看 /status。

U11. Your account is on hold（账号被暂停）

Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted。重新登录没用，因为暂停的是账号本身。我只指官方这条路：打开那个链接看详情，按 Anthropic 的警告与申诉说明走申诉。封号后能不能退款：我没找到专门针对这种情况的官方条款，只有通用退款政策。详细的看Claude 封号怎么申诉。

安装阶段的 Claude Code 报错在安装教程里

第一次登录之前就出的问题（PATH、权限、Node 警告、WSL、Windows 用错终端、安装脚本 403）都在Claude Code 安装教程里，编号 I1 到 I9。可以直接跳到I1 command not found或I8 安装脚本 403。

Claude Code 报错常见问题

Claude Code 报错 400 是什么意思？看后面那句。organization has been disabled 是旧 API key（U5），thinking.type.enabled 是版本太旧（U7），thinking type should be enabled or disabled 是第三方接口（U7）。

Claude Code 报错 403 怎么办？登录时出现，是订阅没生效或缺角色（A2）；安装时出现，是安装地址返回了网页（I8）。

429 和 529 有什么区别？429 是 API key 或云项目的速率上限（U2）；529 是 Anthropic 容量不够，跟你的额度无关（U1）。

额度用完了什么时候恢复？报错里就写着，/usage 也能看到两个窗口。额度规则的变化我记在Claude / Codex 额度与封号追踪。

能把 Codex 的配置导进 Claude Code 吗？能，官方命令是 /import codex（命令参考），加 --dry-run 可以先预览。网上有人提 claude mcp serve，我在 Anthropic 现在的文档里没找到，别当成官方支持的功能。

顺便看：Claude Code 安装教程 · Claude / Codex 额度与封号追踪 · AI 订阅价格对比 · Claude 分类