multi-router.aidocs

Self-Service Provisioning

The PortalEnterprise

What people see in the Portal, and how they set up and use their tools.

The Portal is the page where people set up the AI tools their organization grants them, separate from the dashboard. It shows the tools each person can set up, the settings to paste into each, their budget and their key. People who only use the Portal sign in there, and are sent there from the dashboard.

Signing in

The Portal sign-in asks for the work email first, then signs the person in with single sign-on or a password. A person invited with Portal access sets a password, or uses SSO, when they accept. A person with access in more than one organization switches between them with Switch organization in the menu.

Your AI agents

The home page, Your AI agents, lists the tools the person has set up, with the period's spend, such as This month, At this pace with when the cap is reached at the current pace, their Status, and a hint of their key. Add an AI agent opens Choose an AI agent, which lists the tools the policy grants, with Set up on each, and the approved models and cap of tools already set up. A person with no policy sees No AI agents are set up for you yet, with a prompt to contact their IT department.

Setting up a tool

A tool is set up from its page in four steps:

  1. On Choose an AI agent, select Set up on Claude Code or Claude Desktop.
  2. Install the tool, following the first step on the page. For Claude Desktop, this includes turning on Developer Mode.
  3. Copy the settings under Point it at your organization's router, and paste them where the page shows.
  4. Check it works: run the tool, quitting and reopening Claude Desktop first, and ask it to say hello.

For Claude Code, the settings come in four forms, one per tab:

TabWhere the settings go
macOS / Linux~/.claude/settings.json
Windows%USERPROFILE%\.claude\settings.json
Environment variables~/.zshrc or ~/.bashrc
Managed by IT/Library/Application Support/ClaudeCode/managed-settings.json

For Claude Desktop, the page lists the fields to fill under Developer, then Configure Third-Party Inference, then Connection: Inference provider, Gateway base URL, Credential kind, Gateway API key, Gateway auth scheme and Custom inference headers, each with a copy button. The settings hide the key; Copy copies the working settings, and Reveal key shows it. See Claude Code and Claude Desktop.

A tool's page

Your AI agents

Claude Code

3 models approved · $200 per month · last used Sep 17
set up

Your budget

on track
Monthly · resets Oct 1, 00:00 UTC (in 14 days)
$64.20of $200
32%
Left
$135.80
Your pace
$4.52/day
average over the last 3 days
Cap reached
beyond reset
at this pace
Resets
in 14 days
Oct 1, 00:00 UTC

Need more room this month?

Ask Engineering for a higher limit until the month resets.
Request more budget

Spend by day

this month
Sep 1Sep 17

Set by Engineering IT

Cap
$200 per month, per person
Models
3 allowed, Opus 5 capped at $120
At 80%
notifies you
At 100%
requests paused until reset

Allowed models

3 models on your policy · 1 with its own cap
Claude Opus 5on track
anthropic/claude-opus-5
$41.30 of $120 this month, your own cap34%
last used Sep 17
Claude Sonnet 4.5
anthropic/claude-sonnet-4.5
$19.85 this month · counts toward the $200 total, no separate cap
last used Sep 16
Claude Haiku 4.5
anthropic/claude-haiku-4.5
$3.05 this month · counts toward the $200 total, no separate cap
last used Sep 9
Asking for any other model is refused. A model with its own cap pauses on its own when it reaches it; the others keep working until the $200 total is reached.
Your key …7Qx2 · issued Sep 2
Shown once when it was issued. Issuing a new key deletes this one immediately.
Issue a new key Remove

Install, set up and troubleshoot Claude Code

Install, point it at Engineering’s router, check it works, and what the error messages mean.
1

Install Claude Code

Install it, then come back here.
Install Claude Code using Anthropic's official installer.
2

Point it at Engineering’s router

Add these values to your settings. The router header is what routes you; without it the key works but nothing answers.
macOS / LinuxWindowsEnvironment variablesManaged by IT
~/.claude/settings.json
Reveal keyCopy
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.multi-router.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-mr-••••••••••••••••",
    "ANTHROPIC_CUSTOM_HEADERS": "X-MR-Router: rt_8Kd2Pq6VnW"
  }
}
The key is hidden. Copy still copies the working settings.
3

Check it works

Run Claude Code and ask it to say hello.
If you get an answer, you are routed through Engineering and the request shows in Spend by day above within a few seconds. If not, see Troubleshooting below.

Troubleshooting

What Claude Code shows, and what it means.
“invalid api key”
The key in your settings is wrong or was replaced. Paste the current one, or issue a new key from Your key above.
“budget … is exhausted for this period”
You reached this period’s cap. It resets on the date shown above; nothing to change on your side.
“model ‘…’ is disabled on this router”
You asked for a model that is not on your policy. Use one under Allowed models.
A person's Claude Code page in the Portal: budget, allowed models, key, and the setup steps. Select to enlarge.

Each tool the person set up has its own page:

SectionShows
Your budgetSpend against the cap, what is left, the pace over the last 3 days, when the cap is reached at that pace, when it resets, and Set by your organization's IT with the cap, model caps and rules.
Allowed modelsEach model's spend, with its own cap or the shared total, and when it was last used.
Your keyA hint of the key and when it was issued, with Issue a new key and Remove.
Install, set up and troubleshootThe setup steps, and fixes for common errors.

When a budget pauses the tool, the page shows Paused until the reset, with the tool receiving 429 budget_exhausted until then; the key and access stay.

Requesting more budget

When the budget has request approvers, a cap and a period other than Lifetime, and no request waiting, Request more budget lets the person ask for a higher limit for the current period, with a New monthly limit above the current one and an optional message of up to 500 characters. The page then shows the request as pending, approved with the new limit, or not approved. See Overrides and Requests.

Keys

Issue a new key replaces the tool's key: the old one stops working at once, and the budget and usage carry over. Remove deletes the key and the tool's router, and Set it up again creates a new agent.

Assigning PoliciesManaging Agents
Was this helpful?