6. 常见问题

返回 401

401 通常表示认证失败：

1. 从 Sub2API 控制台重新复制 Key。
2. 确认 Key 前后没有空格或换行。
3. 确认该 Key 状态为“活跃”。
4. 在 CCSwitch 编辑供应商，重新粘贴 Key 并保存。
5. 关闭并重新打开 Codex。

返回 404

依次检查：

• API 请求地址是否为 https://aigw.store/v1。
• “完整 URL”是否保持关闭。
• 默认模型是否存在于账号可用模型列表。
• 如果 gpt-5.5 当前不可用，改选列表中其它可用模型后重启 Codex。

点击启用后没有变化

Codex 需要重新读取配置：

1. 完全关闭 Codex。
2. 关闭运行 Codex 的终端窗口。
3. 在 CCSwitch 再次确认目标供应商已经启用。
4. 打开新终端并重新启动 Codex。

CCSwitch 提示环境变量冲突

Windows 中已有的 OPENAI_API_KEY 等环境变量可能覆盖 CCSwitch 写入的配置。处理前先记录变量名称和当前值，再决定是否修改；不要在没有备份的情况下直接删除系统变量。

API Key 泄露

1. 立即登录 Sub2API。
2. 禁用泄露的旧 Key。
3. 创建一个新 Key。
4. 在 CCSwitch 更新供应商的 API Key。
5. 重启 Codex并确认新 Key 可用。
6. 确认旧 Key 已不能使用后，再决定是否删除。

仍无法解决时，反馈错误代码即可，不要发送完整 API Key。