故障排查

401 Unauthorized

检查 API Key 是否完整、是否失效、Codex .env 或 Claude settings.json 是否写入正确。

403 Forbidden

检查 Key 权限、模型开放范围和账户状态。

404 Not Found

Claude Code：https://api.tokemula.com。Codex：https://api.tokemula.com/v1。

/v1/v1/...

说明客户端会拼接 /v1，但 Base URL 又包含 /v1。Claude Code 必须使用根域名。

429 Too Many Requests

请求到达服务端但受速率、并发或额度限制。稍后重试并检查相关限制。

503 No available accounts

请求已进入调度链路，但当前模型暂时没有可调度上游。稍后重试或联系管理员，通常不需要重装客户端。

codex: command not found

关闭并重新打开 Terminal / PowerShell，再执行 codex --version。

claude: command not found

macOS / Linux：

export PATH="$PATH:$HOME/.local/bin"
claude --version

Windows：完全关闭并重新打开 PowerShell。

API Key 泄露

立即停用旧 Key、创建新 Key、更新本地配置并完全重启客户端。