Prerequisites
- Zed installed (zed.dev)
- A ClearMaas API key starting with
sk-
Setup via Agent Panel (UI)
The simplest setup path:- Open Zed settings:
Cmd+,(macOS) orCtrl+,(Linux/Windows) - Navigate to AI > Providers
- Find OpenAI API Compatible and expand it
- Enter your API key in the input field and press Enter
Setup via settings file
For programmatic or repeatable configuration, editsettings.json directly:
- Open the settings file:
Cmd+Shift+P�?”Open Settings File (JSON)” - Add the
language_modelssection:
agent: open settings), or set it as a header in settings:
Selecting a provider and model
After adding the provider:- Open the Agent Panel:
Cmd+Shift+A - Click the model selector dropdown
- Choose OpenAI API Compatible as the provider
- Select your desired model from the list
settings.json:
Available model options
Configure any ClearMaas model by adding it toavailable_models. Common options:
Verification
- Open the Agent Panel (
Cmd+Shift+A) - Select OpenAI API Compatible as provider
- Select a model (e.g.,
anthropic/claude-sonnet-4.6) - Ask a question �?verify the response comes through