疑难杂症

遇到异常时，建议按以下方向排查：接口地址、API Key、模型名称、账号余额、网络连接、请求参数和客户端配置。

常见报错

Claude Code CLI 提示模型不可用或无权限

报错示例：

There's an issue with the selected model (claude-opus-4-8). It may not exist or you may not have access to it.
Run /model to pick a different model.

解决方案：请求 URL 只需要填写 https://www.potatoai.cc，不需要在末尾添加 /v1。

Codex 客户端提示 API Key 无效

从 Codex 客户端 0.149 版本起，客户端不再自动读取 auth.json 里的密钥。若在 Codex 中看到 401 或 API Key 无效，请打开 ~/.codex/config.toml，在对应的 [model_providers.xxx] 段加上：

requires_openai_auth = true

保存后完全退出并重启 Codex。

如果使用 CC Switch，请在供应商配置中确认包含 requires_openai_auth = true，然后重新切换一次供应商。

如果排查后仍无法解决，请保留完整错误信息、请求时间、使用工具、模型名称和相关截图，并联系支持人员。