Agents & Editors
Zed
Connecting Zed's agent to an Adaptive Router through an OpenAI-compatible provider.
Zed is a code editor with a built-in agent. It connects to Multi-Router through an OpenAI-compatible provider in its settings file, which sends Chat Completions requests to an Adaptive Router with the router header.
Creating the router
Zed connects through an Adaptive Router, which accepts OpenAI Chat Completions requests and serves each one with the model it names, using the organization's provider key for that model's provider. Zed holds only the Multi-Router API key. See Adaptive Router. To set it up:
- In Model Groups, create or choose a model group with the models Zed should use. See Model Group.
- In Routers, choose New router, then Adaptive Router. Name it, choose the model group, and switch on the models to serve.
- Choose the organization's provider key for each provider in the group, and create the router. Its id, such as
rt_XXXXXXXX, is on the router's page. - In API Keys, create a key with the
inferencescope. It can be limited to this router. See API Key.
Every request carries the router id in the X-MR-Router header and the API key as a Bearer token, both set in Zed's settings below.
Settings
Add a provider under language_models.openai_compatible in Zed's settings.json, with the router header in custom_headers:
The API key does not go in the settings file. Enter it in the provider's settings in the Agent Panel, which stores it in the system keychain, or set it in an environment variable named after the provider id: MULTI_ROUTER_API_KEY for multi-router. Custom headers on OpenAI-compatible providers need a recent Zed release.
Models
An Adaptive Router names models by their Multi-Router catalog id, provider/model, such as anthropic/claude-sonnet-4.6, openai/gpt-5 or google/gemini-2.5-flash. The model must be switched on in the router's model group; a request for any other model is refused with a message listing the models the router serves. The settings on this page list each model id explicitly.
name is the catalog id sent to Multi-Router, and display_name is the label in Zed's model picker. Set capabilities.tools so the agent can use tools with the model.
Checking the setup
Open the Agent Panel, choose the model, and say hello.
The request then appears in Traffic with the Adaptive Router in the Router column and the model, tokens and cost in the request detail. A reply with the requested model or router was not found means the router id is wrong, or the API key is not allowed to use that router. See Traffic and Troubleshooting.