错误代码

#错误代码导读

在使用 LINDE AI 的过程中，你可能会遇到一些配置、网络或模型调用上的疑问。我们在此整理了最常见的问题分类，你可以点击对应的链接查看详细的排查与解决方法。

#通用网络 / 认证报错（401 / 403）

如果你在启动或调用模型时遇到 401 Unauthorized 或 403 Forbidden 错误，请先按照以下步骤进行排查：

1. 检查 API 地址（Endpoint）是否正确：

   • 绝大多数第三方客户端（如 Codex、OpenAI SDK、Cherry Studio 等）使用 OpenAI Completions 协议时，必须在 API 地址后加上 /v1，例如：https://ai.lindecdn.com/v1 或 https://ais.lindecdn.com/v1。使用 OpenAI Responses 或 Anthropic Messages 协议时则不需要加 /v1。
   • Claude Code CLI 的端点为 https://ai.lindecdn.com（不需要加 /v1）。各客户端的完整端点对照见 端点与协议。

2. 检查 API Key 分组是否匹配：

   • LINDE AI 采用分组计费，分组决定计费模式，也可能限制可用客户端。OpenAI GPT 的 0.9 折分组仅限 Codex CLI / Codex App；1.1 折全客户端分组和 1 折企业分组支持其他兼容客户端。端点地址与协议也必须匹配，请阅读 令牌分组介绍 了解详情。

3. 检查账户余额与额度设置：

   • 随用随付分组会消耗钱包余额，请确认余额充足。余额仅用于 Token 按量计费，不能购买订阅套餐。
   • 订阅套餐不消耗钱包余额，无需充值。
   • 检查你所使用的 API Key 额度是否已耗尽，或被设置了单日上限。

#常见错误代码（400 / 502 / 503 / 429 / 403）

调用模型时如果返回以下 HTTP 状态码，可以按对应说明排查：

#400 Bad Request

报错信息类似为：

Failed to read request body

通常是客户端发送的请求内容存在问题。重新发送一次或新开会话即可解决。

#502 Bad Gateway

变体一：Upstream service temporarily unavailable

上游服务短暂不可用。约 30% 的情况下是模型回复时间过久触发了超时。建议：

1. 重试请求：稍等几秒后重新发送一次。
2. 检查客户端配置：如果重试多次仍失败，换一个干净的客户端配置试一下，排除客户端自身问题。

变体二：All available accounts exhausted

通常是端点与分组不匹配导致的。例如 ClaudeCode 专用 分组的密钥，却使用了 OpenAI 兼容端点（/v1 Completions 或 Responses 协议）。请确认你的端点与分组对应关系，详见 端点与协议。

变体三：Upstream access forbidden, please contact administrator

典型特征：Codex 安装了新插件后所有请求被拒绝，但其他客户端（Claude Code、ZCode、OpenCode 等）正常。

原因：部分 Codex 插件会修改请求体结构，导致服务器拒绝转发。关闭或卸载最近启用的插件后重试即可。

#503 Service temporarily unavailable

503 不一定表示服务故障，先检查客户端、协议与 API Key 分组是否匹配。例如，OpenAI GPT 的 0.9 折分组仅允许 Codex CLI / Codex App 使用；如果把该分组的 Key 配置到 Claude Code 等 Anthropic 客户端，可能返回 503 或 403。

按以下顺序检查：

1. 确认当前客户端受所选分组支持，具体规则见 令牌分组介绍。
2. 确认协议与端点正确：OpenAI Responses 和 Anthropic Messages 使用根地址，OpenAI Completions 使用 /v1。
3. 检查模型名是否写对。智谱官方模型名称中的 GLM 必须为大写，不能写成小写 glm。

• 正确示例：GLM-5.1、GLM-5.2
• 错误示例：glm-5.1、glm-5.2

模型名称请以控制台 模型 页面显示的为准，复制后直接使用，避免手动输入时大小写出错。以上配置都正确时，稍等几秒后重试；持续出现再提交工单排查上游状态。

#429 Too Many Requests

这是智谱官方在高峰时段的限速，并非你的账户或配置问题。稍等几分钟后重试即可，一般无需修改任何设置。若你想从源头减少等待、提升整体响应速度，可以参考 速度优化。

#403 Forbidden

403 常见于当前客户端或协议不在 API Key 分组的允许范围内。先确认没有将 Codex 专用分组用于 Anthropic 客户端，并检查端点与协议是否匹配。

如果报错内容明确包含以下信息：

报错信息类似为：

unexpected status 403 Forbidden: {"error":{"message":"Usage not included in your plan","type":"usage_not_included","param":null,"code":null,"plan_type":"basic"}}

这类包含 Usage not included in your plan 的报错通常来自上游账号池，并非客户端与分组不匹配。处理方法：

• 使用 Ctrl+C 打断当前对话（VS Code 中点击停止按钮）
• 重新发起对话，系统会自动调度到其他账号
• 如果重试 3 次以上仍无效，带上报错截图在群内咨询客服或群友

#分客户端错误排查

我们针对主流客户端整理了专用的故障排查与使用优化指南：