Skip to main content
Zed is a high-performance code editor from Zed Industries (GPL-3.0, source) with an agent panel built in. It supports OpenAI-compatible providers both through the UI and through settings.json.

Setup

Through the UI

Go to Agent Settings → LLM Providers → Add Provider, and supply the base URL https://api.opper.ai/v3/compat along with your Opper API key.

Through settings.json

Don’t put the API key in settings.json. Zed reads it from the provider settings UI, or from an environment variable derived from the provider name — OPPER_API_KEY for a provider named opper.
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 in available_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

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.
The key isn’t reaching Zed. Set it in the provider settings UI, or export OPPER_API_KEY before launching Zed from the terminal — a Zed started from the Dock won’t see a variable set in your shell rc.
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.

Model catalog

Browse the catalog for model IDs and context windows.

All integrations

Every app that runs on Opper.