保留当前报错原文；改完保存、重启，再测试。
问题排查清单
按顺序检查
地址 → Key → 模型 → 重启 → 使用记录
一次只改一个字段，否则很难判断是哪一项修复了问题。
1. 地址有没有带错 /v1
2. Key 是否完整、分组是否正确
3. 模型名是否存在
4. 保存后是否真正重启
5. 使用记录是否出现本次新请求
1. 保存报错原文
地址、Key、模型、分组一起换，会看不出是哪一项修复了问题。
先记录原始发生时间、客户端、模型、状态码和 Request ID；截图前遮住完整 API Key、账号 和付款信息。随后一次只改一个配置项，保存并按客户端要求完全重启，再新建短对话发送 hi，同时核对使用记录。每次复测都另记时间和结果，升级时同时提供首次与最新一次错误 用于对照；不要把不同请求的截图拼在一起。若同一错误在最短请求中稳定复现，再把这些脱敏证据提交 技术支持，便于区分客户端配置、智维 接入和模型厂商故障。
2. 检查地址
| 客户端 | 正确地址 | 容易填错的地方 |
|---|---|---|
| Codex / CC Switch | https://api.zhiwei.dpdns.org | 填成 https://api.zhiwei.dpdns.org/v1，或末尾多了 /。 |
| OpenAI Compatible 客户端 | https://api.zhiwei.dpdns.org/v1 | 填成 https://api.zhiwei.dpdns.org 后，客户端再拼错路径。 |
| Claude Desktop / Claude Code / OpenClaw（小龙虾） | https://api.zhiwei.dpdns.org | 填成 https://api.zhiwei.dpdns.org/v1/messages、OpenAI 地址，或多加 /v1。 |
| Hermes | 按协议选 https://api.zhiwei.dpdns.org/v1 或 https://api.zhiwei.dpdns.org | api_mode 和地址错配。 |
| Gemini CLI | https://api.zhiwei.dpdns.org | 填成 https://api.zhiwei.dpdns.org/v1beta。 |
| OpenCode Gemini Provider | https://api.zhiwei.dpdns.org/v1beta | 填成根地址后路径缺失。 |
| Antigravity Claude / Gemini CLI | https://api.zhiwei.dpdns.org/antigravity | 填成普通 Claude / Gemini 地址，或漏掉 /antigravity 前缀。 |
| Antigravity OpenAI Compatible | https://api.zhiwei.dpdns.org/antigravity/v1 | 填成普通 https://api.zhiwei.dpdns.org/v1。 |
| Antigravity Gemini 手写 HTTP / OpenCode Gemini | https://api.zhiwei.dpdns.org/antigravity/v1beta | 填成普通 https://api.zhiwei.dpdns.org/v1beta。 |
地址改对后，保存，重开客户端，再测。
判断地址是否填错
Codex 里出现 /v1，优先改回 https://api.zhiwei.dpdns.org。ChatBox / Cherry Studio / Cursor 里没有 /v1，优先改成 https://api.zhiwei.dpdns.org/v1。
3. 检查 Key
- Key 来自 令牌页，客户端里填写完整 Key。
- 余额不足、Key 被删除、Key 分组不可用，都会导致请求失败。
出现 401 时，不要只重新创建 Key。按 常见报错解释 检查请求地址、Key 输入框、配置是否启用以及客户端是否重启。
模型名怎么核对、看不到 GPT-5.6 或最新模型怎么处理，见 看不到最新模型。
4. 检查分组和余额
| 要用什么模型 | Key 分组要支持什么 |
|---|---|
| Codex / GPT 模型 | OpenAI / GPT / Codex 相关分组 |
| Claude 模型 | Claude / Anthropic 相关分组 |
| Gemini 模型 | Gemini 相关分组 |
| Antigravity | Antigravity 相关分组或专用入口 |
余额只说明账户可扣费；分组决定这个 Key 能用哪些模型。换分组后，最新版 CC Switch 会自动刷新映射；手动 API 或其他客户端配置仍需重新核对模型名。
5. 保存并重启
| 软件 | 保存后还要做什么 |
|---|---|
| CC Switch + Codex | 在 CC Switch 启用 智维，完全退出 Codex，再打开。 |
| Claude Desktop | 完全退出 Claude Desktop；Windows 还要检查托盘图标。 |
| Codex CLI / Claude Code / Hermes | 关闭当前终端，重新打开终端再运行。 |
| OpenClaw（小龙虾） | 执行 openclaw gateway restart 重启网关。 |
| ChatBox / Cherry Studio | 保存设置，重新发起一个新对话测试。 |
| VS Code / Cursor / Windsurf 的 OpenAI Codex 扩展 | 保存配置后新建对话；仍读取旧值时，完全退出编辑器再打开。 |
| Cursor / Cline | 保存设置，必要时重启编辑器。 |
| VS Code + Continue | 保存 config.yaml 后会自动重载；选择 智维 模型后重新发起对话测试。 |
6. 发送 hi 并检查使用记录
重启 Codex，新建对话并发送：
text
hiCodex 正常回复后，打开 使用记录 并刷新。只有出现发送 hi 后的本次新请求，才算配置完成；只有回复、没有新记录，不算完成。此时返回 启用 智维，确认当前供应商不是 OpenAI Official，再完全退出并重启 Codex。
7. 对照报错
配置流程检查完仍然报错时，进入 常见报错解释 对照状态码。错误码只在该页面维护。