settings.json.
Setup
Through the UI
Go to Agent Settings → LLM Providers → Add Provider, and supply the base URLhttps://api.opper.ai/v3/compat along with your Opper API key.
Through settings.json
tools and images live under a capabilities object on each model, not at the top level of the entry. Both default to on when omitted.
Choosing a model
Zed doesn’t fetch the catalog — each model you want has to be listed inavailable_models. Pull the IDs and context windows from the model catalog.
max_tokens is the model’s context window, and Zed uses it to drive the token counter and decide when to truncate. Setting it too low silently costs you usable context, so take the real figure from the catalog rather than assuming a provider’s older limit.
Troubleshooting
The provider doesn't appear in the agent panel
The provider doesn't appear in the agent panel
Zed reloads
settings.json on save. If the provider is still missing, the JSON is likely malformed — check that openai_compatible sits inside language_models.Images are rejected
Images are rejected
Set
"capabilities": { "images": true } on that model’s entry — a bare "images" key at the top level of the entry is ignored. Check the model actually supports vision in the catalog too.Related
Model catalog
Browse the catalog for model IDs and context windows.
All integrations
Every app that runs on Opper.