multi-router.aidocs

Routing

Claude Proxy

The router that serves Claude Code and Claude Desktop: its routes, regions, credentials, models, settings and errors.

A Claude Proxy is a router that serves Claude Code, Claude Desktop and other clients of Anthropic's APIs. It receives requests in the native Anthropic, AWS Bedrock or Google Vertex format, forwards the request body to the provider its route names, and returns the provider's response unchanged, so every feature of those APIs is available. A Claude Proxy has a route, which sets the provider and variant, a region, a credential source and the models it serves, and it records usage for each person in Traffic. How Claude Code and Claude Desktop are configured to use a Claude Proxy is described in Agents & Editors.

Endpoints

The endpoints of a Claude Proxy are the API paths that accept requests in each provider's native format. A request selects the proxy with the X-MR-Router header, which names the proxy's id or an alias that points to it and is required on the Bedrock and Vertex endpoints. Each endpoint serves the routes of its own provider:

EndpointFormatServes
POST /v1/messagesAnthropic MessagesThe Anthropic API route.
POST /v1/messages/count_tokensAnthropic token countingThe Anthropic API route.
POST /bedrock/model/{model}/invokeAWS BedrockThe Bedrock routes.
POST /bedrock/model/{model}/invoke-with-response-streamAWS Bedrock streamingThe Bedrock routes.
POST /vertex/projects/{p}/locations/{l}/publishers/anthropic/models/{m}:rawPredictGoogle VertexThe Vertex AI route, including token counting with the model count-tokens.
…:streamRawPredictGoogle Vertex streamingThe Vertex AI route.
GET /v1/modelsAnthropic model listThe models the proxy serves, answered from the catalog.

On the Vertex endpoint, Multi-Router uses the project of the provider key and the region of the route, whatever project and location the client's URL names. The Bedrock endpoint accepts any model name the proxy recognizes in the URL, including a URL-encoded inference profile ARN.

Routes

A route is the provider and variant a Claude Proxy sends requests to. The dashboard lists the following routes:

RouteRoute idProvider and variantDescription
Anthropic APIanthropicAnthropic, standardForwards to api.anthropic.com in the global or us region.
Bedrock (Global)bedrock-globalAWS Bedrock, globalCross-region inference profiles. Inference can run in any AWS region, with no residency guarantee.
Bedrock (Geo)bedrock-geoAWS Bedrock, geoGeography inference profiles. Inference stays inside one geography, such as the US, EU, Japan or Australia.
Bedrock (In-region)bedrock-in-regionAWS Bedrock, in_regionBare foundation-model ids. Inference stays in the single region called, and fewer models are offered.
Vertex AIvertexGoogle Vertex, standardVertex AI in the project of the provider key and the region of the route.
CustomcustomSet for each modelRoutes each model through a model group, whose members name their own provider, variant and region. See Custom route.

Every route except Custom requires a region, chosen from the regions the route serves. A model with no offering in the chosen region is Not Available there, and Multi-Router does not fall back to another region. The dashboard shows how many of the route's models each region serves. See Regions & Variants.

Credentials

The credential source decides whose provider account pays for requests:

Credential sourceDashboard labelRoutesBehavior
organizationOrganization KeyEvery routeMulti-Router removes the client's credential and sends the provider key set on the proxy. Usage is billed to the organization's Anthropic, AWS or Google Cloud account.
developerDeveloper CredentialsAnthropic APIThe client's own Anthropic credential is forwarded unchanged, and usage is billed to that person's account.

The Multi-Router API key travels in the X-MR-Api-Token: Bearer <key> header. With Organization Key, the client can send it in Authorization or x-api-key instead, because Multi-Router replaces that credential with the provider key; with Developer Credentials, a Multi-Router API key in those headers returns 400.

An organization key must be an enabled key of the route's provider. A Bedrock API key must have been created for the proxy's region, while AWS access keys and Vertex keys work in any region. When a proxy's key is later disabled or deleted, its requests return 503 until the proxy uses another key. See Provider Key.

Models

The models a Claude Proxy serves are the current Claude models listed in the catalog's Claude Proxy section, such as Claude Opus 5.5, Claude Sonnet 5 and Claude Haiku 4.5. A proxy can turn off individual models, and at least one model must stay served. Each model has one of three states on a proxy:

StateAPI valueMeaning
ServedservedThe route offers the model in the proxy's region, and the proxy serves it.
DisableddisabledThe proxy has turned the model off. The dashboard shows a Disabled badge.
Not availablenot_availableThe route does not offer the model in the proxy's region. The dashboard shows Not available in the region.

Clients name models in their own format, and Multi-Router maps each name to the catalog model and then to the model id of the proxy's route and region. For example, every one of these names resolves to Claude Sonnet 4.6:

Name the client sendsModel id sent to the provider
claude-sonnet-4-6claude-sonnet-4-6 on the Anthropic API and Vertex AI routes
us.anthropic.claude-sonnet-4-6global.anthropic.claude-sonnet-4-6 on Bedrock (Global)
anthropic/claude-sonnet-4.6jp.anthropic.claude-sonnet-4-6 on Bedrock (Geo) in ap-northeast-1
anthropic.claude-sonnet-4-6anthropic.claude-sonnet-4-6 on Bedrock (In-region)

Because the route and region decide where inference runs, a client's Bedrock inference profile prefix or Vertex location does not change it. GET /v1/models with the proxy's X-MR-Router header lists the served models with the model ids of the proxy's route.

Custom route

The Custom route serves the members of a model group, each on the provider, variant and region the member names, so one Claude Proxy can serve one model on Anthropic and another on AWS Bedrock in the EU. Every member must be a Claude model the Claude Proxy serves, appear once, and name a variant and a region. The Custom route uses organization credentials with one provider key for each member, set in routing.model_keys, and has no region of its own. A request for a model outside the group is refused. Each endpoint serves only its own provider, so a client reaches the group members on the provider of the endpoint it calls: a Claude Code client set up for Bedrock reaches the members on AWS Bedrock. The model group is set with routing.model_group when the proxy is created, or with PATCH /v1/routers/{id}. See Model Group.

Request handling

Multi-Router forwards the client's request body unchanged, with two exceptions: it replaces the model name with the model id of the route when they differ, and on the Anthropic API route in the us region it adds "inference_geo": "us" when the request omits it. It forwards the client's headers, and removes cookies, forwarding headers and every x-mr- header; with Organization Key it also replaces the client's credential headers and adds an anthropic-version header when the client sends none. The query string is forwarded as sent, except one that carries a Multi-Router API key or a reserved provider parameter, which returns 400. Requests are sent to the provider once, without retries, and the provider's status and error body are returned to the client.

LimitValue
Request body32 MB
Time to the provider's response headers300 seconds

Settings

A Claude Proxy's settings are its routing configuration (route, region, credential source, provider key and disabled models), its request logging, and its name, description and tags. Request logging records each inference request in Traffic according to the proxy's Request Logging settings; see Router Settings and Observability. Budgets apply to a Claude Proxy and its models. Prompt bindings, parameter defaults and model source apply to static routers and have no effect on a Claude Proxy.

Creating a Claude Proxy

To create a Claude Proxy in the dashboard:

  1. On the Routers page, select New router, and under Proxies choose Claude Proxy.
  2. Under Details, enter a Name, and optionally a Description and Tags.
  3. Under Routing, choose a Route and a Region, turn off any models the proxy should not serve, and choose Developer Credentials or Organization Key with a provider key.
  4. Under Review & create, check the Route, Region (or Model group on the Custom route), Models and Credentials, and create the proxy.

The Routing card shows the models the proxy serves with their model ids and prices, the client endpoint for the route, and the Claude Code setup. To create a Claude Proxy with the API, send POST /v1/routers with kind claude_proxy and its routing: route, region, credential_source, provider_key_id, model_group, model_keys and disabled_models. Static router fields, such as prompt and parameter_defaults, are refused:

Back to Routers

Eng proxy

Route: bedrock-geo

enabledclaude proxy
engAdd tag

Claude Code for the engineering team, served from Bedrock in the US.

rt_5Tc7Hn1GsR·created Aug 18, 2026·updated Oct 1, 2026
Disable
OverviewTrafficActivity

Aliases

Add
claude-code

Routing

How the model names Claude Code sends are resolved and where they are served.

Bedrock (Geo) · us-west-2Edit
Route
Bedrock (Geo)bedrock · geo12 of 12 models · 19 regions
Geography inference profiles. Inference stays inside one geography (US, EU, APAC, Japan or Australia).
Region
us-west-2All 12 modelsone of 19 regions on Bedrock (Geo)
Models
11 of 12 models routable · 1 disabledBedrock (Geo) · us-west-2
ModelVersionVendorVariantRegionWire id chat · count tokensPrice / 1M in · out
Claude Fable 5
anthropic/claude-fable-5
5bedrockgeous-west-2
us.anthropic.claude-fable-5
anthropic.claude-fable-5
$11.00 / $55.00
Claude Fable 5.1
anthropic/claude-fable-5.1
5.1bedrockgeous-west-2
us.anthropic.claude-fable-5-1
anthropic.claude-fable-5-1
$11.00 / $55.00
Claude Haiku 4.5
anthropic/claude-haiku-4.5
4.5bedrockgeous-west-2
us.anthropic.claude-haiku-4-5-20251001-v1:0
anthropic.claude-haiku-4-5-20251001-v1:0
$1.10 / $5.50
Claude Opus 4.5
anthropic/claude-opus-4.5
4.5bedrockgeous-west-2
us.anthropic.claude-opus-4-5-20251101-v1:0
anthropic.claude-opus-4-5-20251101-v1:0
$5.50 / $27.50
Claude Opus 4.6
anthropic/claude-opus-4.6
4.6bedrockgeous-west-2
us.anthropic.claude-opus-4-6-v1
anthropic.claude-opus-4-6-v1
$5.50 / $27.50
Claude Opus 4.7
anthropic/claude-opus-4.7
4.7bedrockgeous-west-2
us.anthropic.claude-opus-4-7
anthropic.claude-opus-4-7
$5.50 / $27.50
Claude Opus 4.8
anthropic/claude-opus-4.8
4.8bedrockgeous-west-2
us.anthropic.claude-opus-4-8
anthropic.claude-opus-4-8
$5.50 / $27.50
Claude Opus 5Disabled
anthropic/claude-opus-5
5bedrockgeous-west-2
us.anthropic.claude-opus-5
anthropic.claude-opus-5
$5.50 / $27.50
Claude Opus 5.5
anthropic/claude-opus-5.5
5.5bedrockgeous-west-2
us.anthropic.claude-opus-5-5
anthropic.claude-opus-5-5
$4.40 / $22.00
Claude Sonnet 4.5
anthropic/claude-sonnet-4.5
4.5bedrockgeous-west-2
us.anthropic.claude-sonnet-4-5-20250929-v1:0
anthropic.claude-sonnet-4-5-20250929-v1:0
$3.30 / $16.50
Claude Sonnet 4.6
anthropic/claude-sonnet-4.6
4.6bedrockgeous-west-2
us.anthropic.claude-sonnet-4-6
anthropic.claude-sonnet-4-6
$3.30 / $16.50
Claude Sonnet 5
anthropic/claude-sonnet-5
5bedrockgeous-west-2
us.anthropic.claude-sonnet-5
anthropic.claude-sonnet-5
$2.20 / $11.00
Client endpoint
Anthropic dialecthttps://api.multi-router.airefuses every model on this route
Bedrock dialecthttps://api.multi-router.ai/bedrockserves every model
Vertex dialecthttps://api.multi-router.ai/vertexrefuses every model on this route
What Claude Code is pointed at. A request may arrive on any door; after the model resolves, its vendor is checked against the door.
Forwards to
bedrock · us-west-2 · 11 models
POSThttps://bedrock-runtime.us-west-2.amazonaws.com/model/{chat id}/invokeinvoke-with-response-stream when streaming
model list
GEThttps://api.multi-router.ai/v1/modelsanswered from the catalog, not forwarded · 11 models, each under its chat wire id
Credentials
Organization Key
Bedrock productionAPI keybedrockus-west-2
Carries us-west-2, the region selected above.
Claude Code setup

Request Logging

What this router records about its requests. Capped by the administrator's Storage Policy.

Edit
Request metadataFull Metadata
Request payloadsNone
A Claude Proxy's Routing card on Bedrock (Geo) in us-west-2: the models it serves with their model ids and prices, one disabled, and its organization key. Select to enlarge.
Create a Claude Proxy on Bedrock (Geo)bash
curl -X POST https://api.multi-router.ai/v1/routers \
  -H "Authorization: Bearer $MR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "claude_proxy",
    "name": "Eng proxy",
    "routing": {
      "route": "bedrock-geo",
      "region": "us-west-2",
      "credential_source": "organization",
      "provider_key_id": "llpk_4Vd8Qm2RtL",
      "disabled_models": ["anthropic/claude-opus-5"]
    }
  }'

A Claude Proxy created without routing uses the Anthropic API route in the global region with developer credentials. Its routing is read and changed with the following endpoints:

MethodPathDescriptionScope
GET/v1/routers/{id}The proxy, with its routing: route, region, credential source, provider key, model group, model keys and disabled models.routers:read
GET/v1/routers/{id}/routesEvery model the proxy serves, with its provider, variant, region and provider key.routers:read
PATCH/v1/routers/{id}Changes the routing fields sent. A route switch sends the fields the new route needs in the same request.routers:write

Policy-managed Claude Proxies

A policy-managed Claude Proxy is one Multi-Router creates when a person assigned to a tools policy sets up Claude Code or Claude Desktop in the Portal, one for each tool, with routing taken from the policy. These proxies carry the reserved person: and policy: tags and are managed through the policy: changing, enabling, disabling or deleting one directly returns 409 policy_managed. See Self-Service Provisioning.

Traffic and pricing

Traffic records one row for each inference request through a Claude Proxy, with the name the client sent, the model and model id that served it, the provider, variant and region, and the cost. Token counting requests are not recorded. Cost is computed from the catalog price of the route and region; on the Anthropic API route it follows the region Anthropic reports the request ran in.

Errors

Creating or changing a Claude Proxy returns the following errors, each with status 400:

ErrorCause
route_not_foundThe route is not in the catalog, or the routing settings are missing.
region_not_on_routeThe route requires a region, the route does not serve the region, or the Custom route names a region.
credential_not_allowedDeveloper credentials are used on a route other than Anthropic API, or the Custom route names a single key or developer credentials.
key_not_foundOrganization credentials name no key, a key not in the organization, or a disabled key, or a Custom member has no key.
key_vendor_mismatchThe key belongs to a different provider than the route or member.
key_region_mismatchA Bedrock API key was created for a region other than the proxy's region, or a Bedrock or Vertex key has invalid settings.
group_not_foundThe Custom route names no model group or a model group not in the organization, or a model group is set on another route.
group_member_not_servedThe model group has no members, a member is not a served Claude model, appears twice, lacks a variant or region, or is not served at its provider, variant and region, or member keys are set on another route or name a model the proxy does not serve.
all_models_disabledEvery model the route serves in the region, or every group member, is disabled.
disabled_not_in_modelsThe disabled list names a model the proxy does not serve, or names one twice.
catalog_section_missingThe catalog has no Claude Proxy section.

Requests through a Claude Proxy return the following errors, in the format of the endpoint:

StatusCause
404The model is unknown, retired or deprecated, disabled on the proxy, not available on the route in its region, outside the Custom route's model group, or served by another endpoint's provider.
403The Claude Proxy is disabled.
503The proxy's provider key is missing or disabled, its route or the catalog's Claude Proxy section is missing, its model group is missing, a Custom member has no key, or a Vertex access token is not ready.
502The provider could not be reached or timed out.
429The API key's rate limit or a budget refused the request.
413The request body is over 32 MB.
405A method other than POST was used on the Bedrock or Vertex endpoint.
400The X-MR-Router header is missing on the Bedrock or Vertex endpoint, the Multi-Router API key was sent in a forwarded header, the query string carries a Multi-Router API key or reserved parameter, or an inference_geo conflicts with the proxy's region.
Weighted RouterCodex Proxy
Was this helpful?