API 错误与网络排查

按顺序排查网络、配置、错误码、服务繁忙和 429 重试问题。

1. 排查网络和配置问题

配好了如果不能用，请先怀疑自己的网络，或者没配好，按如下顺序排查。

第一步：测试账号

去Dogzee网站控制台的操练场，直接做一轮对话测试。

• 操练场能用 → 问题在本地配置或网络
• 操练场也不能用 → 检查账号或API密钥本身 → 记得要选择正确的分组和模型

第二步：排查网络

• 换一个 VPN 节点再测
• 优先使用虚拟网卡模式，不要使用系统代理模式

第三步：排查配置

1. 检查API密钥是否创建在了正确分组
2. 不要修改 CC Switch 里原有配置，应该点击 + 新增
3. Codex 额外检查 base_url = "https://ergouzi.life/v1" 是否写在 [model_providers.custom] 块里
4. 启用配置后无法对话 → 退出 Codex 重新打开；仍失败时先备份 ~/.codex/config.toml，然后删除 ~/.codex/config.toml ，再重新配置。
5. 以上都不通 → 检查 CC Switch 版本，更新到最新版。

2. 遇到报错或不能用时的万能排查清单

遇到各种奇奇怪怪的报错，按这个顺序试一遍，通常能解决大部分问题。

1. 确保开了虚拟网卡模式：不要用系统代理模式，优先用虚拟网卡（TUN 模式）
2. 换一个 VPN 节点：很多玄学问题换个节点就好了
3. 重开会话：退出当前对话，新建一个会话再试，不想丢失对话，可以对当前消息进行分叉，或者复制会话ID，在新会话中继续
4. 重启软件：关掉 Codex / Claude Code，重新打开
5. 安全重建配置：先备份 ~/.codex/config.toml，然后删除 ~/.codex/config.toml，重新打开codex让它自己生成一份新的配置文件。
6. 重新配置：退出 Codex，在官方配置和新增配置之间来回多切换几次，最后再打开 Codex。
7. 重启电脑：走到这一步还没好？重启电脑。

3. 常见错误码和流式报错

unexpected status 401 Unauthorized

• 这是没有配置好，或者配置没生效。
• 使用工具重新配置，或者先备份 先备份 ~/.codex/config.toml，然后删除 ~/.codex/config.toml

client_gone

• 请求链路中断，优先判断网络或代理是否有波动。

503 No available channel for model ... under group ...

• 当前API密钥分组不支持这个模型。去模型广场确认该模型支持哪些分组，然后换个模型或换分组。

5. exceeded retry limit, last status: 429 Too Many Requests

• 429 表示服务提供的api算力不够了