language_models.openai_compatible provider mechanism, which routes requests through the Orq.ai AI Gateway and makes the full model catalog available, including Anthropic Claude models.
Prerequisites
- Zed installed
- Active Orq.ai account
- Orq.ai API key
Setup
Two paths produce equivalent results. The GUI writes to the samesettings.json as the manual approach.
- settings.json
- GUI
Open Zed settingsPress , on macOS or Ctrl , on Linux / Windows to open Add as many models as needed. Use the Start a sessionOpen the Agent Panel, pick a model from the dropdown, and send a message.
settings.json.Add the provider blockMerge the following into the top-level object:provider/model_id format for name (e.g. anthropic/claude-opus-4-7, openai/gpt-4o-mini).Add the API keyOpen the Agent Panel → Configure Providers → click Orq → paste the <ORQ_API_KEY>.Alternatively, export it as an environment variable before launching Zed. Zed derives the variable name from the provider name, so a provider named Orq reads ORQ_API_KEY automatically:Caveats
Troubleshooting
Models not appearing in the dropdown
Models not appearing in the dropdown
Verify that
settings.json is valid JSON and that the capabilities object for each model includes all four fields: tools, images, parallel_tool_calls, and prompt_cache_key. Zed silently drops malformed model entries.Authentication errors
Authentication errors
Confirm that
ORQ_API_KEY is set in the environment Zed was launched from, or that the key was pasted directly in the Configure Providers panel. The environment variable name is derived from the provider name: a provider named Orq reads ORQ_API_KEY.Requests not appearing in Orq.ai Traces
Requests not appearing in Orq.ai Traces
Verify the
api_url in settings.json (or the GUI field) is set to https://api.orq.ai/v3/router. Requests sent to the provider’s own endpoint bypass the AI Gateway and produce no traces.Edit Predictions (inline autocomplete) not working
Edit Predictions (inline autocomplete) not working
Edit Predictions is not currently supported through the AI Gateway.