常见报错

排错时不要一次改很多地方。建议按这个顺序检查：

flowchart TD
  A["先看报错码"] --> B{"401?"}
  B -->|是| C["检查 API Key"]
  B -->|否| D{"403?"}
  D -->|是| E["检查分组、余额、权限"]
  D -->|否| F{"404?"}
  F -->|是| G["检查 Base URL"]
  F -->|否| H["检查模型名和网络"]

401 Unauthorized

通常是 API Key 有问题。

检查顺序：

1. Key 是否完整复制。
2. 前后是否多了空格。
3. Key 是否已经被删除或禁用。
4. 你填的是不是别的平台 Key。

403 Forbidden

通常是权限或分组问题。

可能原因：

1. 账号没有可用分组。
2. API Key 绑定的分组不支持当前模型。
3. Key 已过期或额度用完。
4. 管理员限制了某些接口。

处理方法：

1. 回到平台查看这把 Key 绑定的分组。
2. 确认这个分组支持你正在使用的模型。
3. 查看账号余额、套餐或 Key 的额度上限。
4. 如果你不是管理员，把报错截图和 Key 名称发给管理员，不要发送完整 Key。

404 Not Found

通常是 Base URL 填错。

OpenAI 兼容客户端优先检查是否填写：

https://codex.tuyoung.com/v1

Codex 配置优先检查是否填写：

https://codex.tuyoung.com

如果你使用的是 OpenAI 兼容客户端，但填了根地址，就很容易出现 404。反过来，如果 Codex 配置里多写了 /v1，也可能导致路径拼接错误。

模型不存在

模型名称必须和平台支持的名称一致。不要凭印象写模型名。

建议：

1. 在平台密钥页查看使用示例。
2. 联系管理员确认可用模型。
3. 先用推荐模型跑通，再改成其他模型。

余额不足或额度不足

进入平台查看余额、套餐、Key 用量。如果是测试 Key，检查是否设置了额度上限。

看起来配置都对，但还是失败

请按下面信息收集后再排查：

信息	从哪里找
使用的工具	Codex、Claude Code、Cursor、ChatBox 等
Base URL	工具配置页面
模型名	工具配置页面
Key 名称	平台 API Key 列表
报错原文	工具弹窗、终端或日志
发生时间	方便管理员查日志

不要发送完整 API Key

需要别人帮你排查时，只发 Key 名称或最后 4 位即可。完整 Key 一旦发出去，就应该删除并重新创建。