Troubleshooting
Quick cards for common failures—≤3 lines each with links to related docs.
401 Unauthorized
Missing, expired, or revoked API key.
Confirm header Authorization: Bearer <key>.
API overview →404 /v1/v1/…
Claude Code base URL incorrectly includes /v1.
Use the gateway root; only OpenAI clients need a /v1 suffix.
Claude Code setup →MODEL_POLICY_DENIED
The key’s model policy blocks the requested model.
Adjust tag/policy in the console, or use auto routing.
Quickstart →Request timeout
Upstream model or network latency is too high.
Raise API_TIMEOUT_MS in CLI; retry or switch models.
cURL smoke test →