Claude Code 常见报错与解决

按报错原文索引

以下报错原文在 Claude Code 2.1.299 上实测。

400

API Error: 400 {"error":"模型 xxx 不存在或未上线，请前往 https://aicodewith.com/zh/dashboard/pricing 查看可用模型列表 (request_id: …)"}

• •模型名写错或该模型不可用：运行 /model 重新选择，或核对模型页的模型 ID。
• •上下文过长：运行 /compact 压缩对话，或 /clear 开新会话。

401 鉴权

Failed to authenticate. API Error: 401 {"error":"请在请求中提供有效的 API Key。"}

1. 从控制台重新复制 Key，检查首尾空格和换行，确认 Key 没被删除。
2. Key 填在 ANTHROPIC_AUTH_TOKEN，ANTHROPIC_API_KEY 留空。
3. 新终端运行 echo $ANTHROPIC_API_KEY，删掉 ~/.zshrc 或 ~/.bashrc 里的旧值。
4. 关闭所有 Claude Code 会话后重开，运行 /status。

403 Key 已停用

Failed to authenticate. API Error: 403 此 API Key 已被停用，如有疑问请联系我们 https://aicodewith.com/zh/contact

Key 被停用或删除后，几秒内就会出现这个报错。到控制台确认 Key 状态，重新创建一个 Key 并更新配置；有疑问请联系我们。

Not logged in

Not logged in · Please run /login

这表示 Key 为空或没有配置，不是真的要你登录 Claude 账号。在 ~/.claude/settings.json 的 ANTHROPIC_AUTH_TOKEN 里填上 Key 后重开 Claude Code。

429 限流

{"error":"当前并发请求过多，请稍后重试 (request_id: …)"}

（此报错用 curl 并发请求复现，Claude Code 内显示可能不同）

按量计费没有 5 小时或每周额度，但有速率和并发限制。同时发出的请求过多时，超出的请求会返回 429，稍等即可重试。

• •关掉多余的 Claude Code 会话，减少并行子代理；共用同一个 Key 的脚本和 CI 也算在内。
• •给每个人或每条流水线单独建 Key，方便定位。

overloaded

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}

请求和 Key 都没问题，是模型当时太忙。高峰通常很短，并且只影响某个模型。

• •稍等后重新发送，对话不会丢。
• •运行 /model 换一个模型（例如从 Opus 换到 Sonnet）先把活干完。
• •在模型页查看渠道状态，必要时给 Key 换一个渠道。

超时 / 连接断开（ECONNRESET）怎么办

API Error: Connection dropped (ECONNRESET)

接口地址不可达或域名写错时，会出现这个报错。

• •运行 /status 确认接口地址是 api.aicodewith.ai，而不是 Anthropic 默认地址。
• •临时关闭本地代理或 VPN 再试，国内网络可直连。

Key 错误或网络不通时，Claude Code 会自动重试约 3–4 分钟，期间界面空白没有提示。等了很久没反应，先查 Key 和地址。

第三方 API 特有问题（Base URL、配置不生效）

There's an issue with the selected model (...). It may not exist or you may not have access to it. Run --model to pick a different model.

如果 ANTHROPIC_BASE_URL 写成了 https://aicodewith.ai，或带了错误路径（比如 /foo），会出现上面这个报错。它看起来像模型问题，实际是地址写错，请改用 https://api.aicodewith.ai。

环境变量的优先级高于 ~/.claude/settings.json：终端里 export 过的旧值会覆盖配置文件。改完任何配置都要关闭所有 Claude Code 会话（包括 VS Code、JetBrains 插件）后重开。标准配置如下：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的_API_KEY",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai"
  }
}

• •ANTHROPIC_BASE_URL 不要带 /v1，也不要带结尾斜杠。
• •首次运行卡在登录页：在 ~/.claude.json 里加 "hasCompletedOnboarding": true。

Claude Code 接入教程Claude Code 中转站配置Claude Haiku API 报错排查

FAQ