Skip to main content
Zed is a modern GPU-accelerated code editor with first-class AI support through the Agent Panel. Add ClearMaas as a custom OpenAI-compatible provider to access 570+ models directly in your editor.

Prerequisites

  • Zed installed (zed.dev)
  • A ClearMaas API key starting with sk-

Setup via Agent Panel (UI)

The simplest setup path:
  1. Open Zed settings: Cmd+, (macOS) or Ctrl+, (Linux/Windows)
  2. Navigate to AI > Providers
  3. Find OpenAI API Compatible and expand it
  4. Enter your API key in the input field and press Enter
API keys are stored in your OS’s secure credential storage, not as plain text.

Setup via settings file

For programmatic or repeatable configuration, edit settings.json directly:
  1. Open the settings file: Cmd+Shift+P �?”Open Settings File (JSON)”
  2. Add the language_models section:
Then add your API key via the Agent Panel UI (agent: open settings), or set it as a header in settings:

Selecting a provider and model

After adding the provider:
  1. Open the Agent Panel: Cmd+Shift+A
  2. Click the model selector dropdown
  3. Choose OpenAI API Compatible as the provider
  4. Select your desired model from the list
To set a default provider, add to settings.json:

Available model options

Configure any ClearMaas model by adding it to available_models. Common options:

Verification

  1. Open the Agent Panel (Cmd+Shift+A)
  2. Select OpenAI API Compatible as provider
  3. Select a model (e.g., anthropic/claude-sonnet-4.6)
  4. Ask a question �?verify the response comes through
Check your ClearMaas dashboard to confirm the request was routed.

See also