Claude Code Custom Base URL and API Routing Guide
Use Anthropic Direct only for models tagged Anthropic Direct; otherwise use an OpenAI-compatible coding model through the documented path.
Last verified: 2026-06-05
Configuration summary
Steps
- Confirm the request uses https://api.metisrouter.com/v1 or the documented direct provider endpoint.
- Copy the exact model ID from /models or /docs/models.
- Set a bounded max_tokens, max_completion_tokens, or max_output_tokens value when the task can grow.
- Send a short test request and check Usage Logs for the request id, latency, usage, and charged amount.
Symptoms
Claude Code needs a compatible route for Claude models, but the model or endpoint protocol is mismatched.
- The tool may show an authentication, model, streaming, timeout, or provider error.
- Usage Logs help separate requests blocked by MetisRouter from requests that reached an upstream provider.
Why it happens
Most setup failures come from mismatched base URLs, display names used as model IDs, missing output limits, unsupported endpoint types, or insufficient balance.
- Use API model IDs, not prettified display names.
- Match text, image, video, audio, and embedding requests to their documented endpoints.
- Keep request IDs for support and retries.
How to verify
After applying the fix, run one short request and confirm the platform recorded the model, endpoint, token or asset usage, latency, and cost.
- Support email: [email protected]
- High-volume/sales email: [email protected]
- Include request id, model id, endpoint, timestamp, and expected behavior when asking for help.
FAQ
Should I retry immediately?
Retry only after checking whether Usage Logs already show a successful upstream request or a billable result.
Which model ID should I use?
Use the exact API model ID from /models or /docs/models. Display titles are not guaranteed to work as request model IDs.