Reference
Troubleshooting
Quickly diagnose protocol, key, model, and environment errors.
Match the error below first. Most integration problems can be resolved in a minute.
| Error | Cause | Resolution |
|---|---|---|
| 404 "The current platform does not support this API path" | A Claude plan key is using the OpenAI protocol, or was placed in Codex | Select an Anthropic provider for Claude and use https://api.hop-base.com without /v1 |
| 401 / invalid API key | The key is incomplete, deleted, or contains extra spaces | Copy it again from Key Management, or create a new key |
"Model ... is not supported" / model_not_found | The model is not included in the key's plan group | Call GET /v1/models with that key and use a returned ID, or switch to the matching plan key |
| Insufficient balance | The USD balance is exhausted | Add funds in the console; no configuration change is required |
| "Service busy, try again later" / 502 | Temporary upstream model instability | Retry shortly; contact support if it persists for more than 10 minutes |
| "node / npm is not recognized" | Node.js is missing or not in PATH | Reinstall from nodejs.org, then close and reopen the terminal |
| PowerShell blocks script execution | Windows execution-policy restrictions | Prefer the console's one-click command, or run Set-ExecutionPolicy RemoteSigned as Administrator |
| Configuration looks correct but cannot connect | /v1 is missing or duplicated, or the URL contains whitespace | Compare the Base URL character by character: OpenAI includes /v1; Anthropic does not |
Still stuck? Contact us with an error screenshot, the tool name, and the approximate time. We can locate the request in the gateway logs.