Configuring the Assistant

Providers {#providers}

The following providers are supported:

• Zed AI (Configured by default when signed in)
• Anthropic
• GitHub Copilot Chat [^1]
• Google AI [^1]
• Ollama
• OpenAI

To configure different providers, run assistant: show configuration in the command palette, or click on the hamburger menu at the top-right of the assistant panel and select "Configure".

[^1]: This provider does not support the /workflow command.

To further customize providers, you can use settings.json to do that as follows:

• Configuring endpoints
• Configuring timeouts
• Configuring default model

Zed AI {#zed-ai}

A hosted service providing convenient and performant support for AI-enabled coding in Zed, powered by Anthropic's Claude 3.5 Sonnet and accessible just by signing in.

Anthropic {#anthropic}

You can use Claude 3.5 Sonnet via Zed AI for free. To use other Anthropic models you will need to configure it by providing your own API key.

1. Sign up for Anthropic and create an API key
2. Make sure that your Anthropic account has credits
3. Open the configuration view (assistant: show configuration) and navigate to the Anthropic section
4. Enter your Anthropic API key

Even if you pay for Claude Pro, you will still have to pay for additional credits to use it via the API.

Zed will also use the ANTHROPIC_API_KEY environment variable if it's defined.

Anthropic Custom Models {#anthropic-custom-models}

You can add custom models to the Anthropic provider by adding the following to your Zed settings.json:

{
  "language_models": {
    "anthropic": {
      "available_models": [
        {
          "name": "some-model",
          "display_name": "some-model",
          "max_tokens": 128000,
          "max_output_tokens": 2560,
          "cache_configuration": {
            "max_cache_anchors": 10,
            "min_total_token": 10000,
            "should_speculate": false
          },
          "tool_override": "some-model-that-supports-toolcalling"
        }
      ]
    }
  }
}

Custom models will be listed in the model dropdown in the assistant panel.

GitHub Copilot Chat {#github-copilot-chat}

You can use GitHub Copilot chat with the Zed assistant by choosing it via the model dropdown in the assistant panel.

Google AI {#google-ai}

You can use Gemini 1.5 Pro/Flash with the Zed assistant by choosing it via the model dropdown in the assistant panel.

1. Go the Google AI Studio site and create an API key.
2. Open the configuration view (assistant: show configuration) and navigate to the Google AI section
3. Enter your Google AI API key

The Google AI API key will be saved in your keychain.

Zed will also use the GOOGLE_AI_API_KEY environment variable if it's defined.

Google AI custom models {#google-ai-custom-models}

You can add custom models to the Google AI provider by adding the following to your Zed settings.json:

{
  "language_models": {
    "google": {
      "available_models": [
        {
          "name": "custom-model",
          "max_tokens": 128000
        }
      ]
    }
  }
}

Custom models will be listed in the model dropdown in the assistant panel.

Ollama {#ollama}

Download and install Ollama from ollama.com/download (Linux or macOS) and ensure it's running with ollama --version.

You can use Ollama with the Zed assistant by making Ollama appear as an OpenAPI endpoint.

1. Download, for example, the mistral model with Ollama:

   ollama pull mistral
   

2. Make sure that the Ollama server is running. You can start it either via running the Ollama app, or launching:

   ollama serve
   

3. In the assistant panel, select one of the Ollama models using the model dropdown.

4. (Optional) If you want to change the default URL that is used to access the Ollama server, you can do so by adding the following settings:

{
  "language_models": {
    "ollama": {
      "api_url": "http://localhost:11434"
    }
  }
}

OpenAI {#openai}

1. Visit the OpenAI platform and create an API key
2. Make sure that your OpenAI account has credits
3. Open the configuration view (assistant: show configuration) and navigate to the OpenAI section
4. Enter your OpenAI API key

The OpenAI API key will be saved in your keychain.

Zed will also use the OPENAI_API_KEY environment variable if it's defined.

OpenAI Custom Models {#openai-custom-models}

You can add custom models to the OpenAI provider, by adding the following to your Zed settings.json:

{
  "language_models": {
    "openai": {
      "version": "1",
      "available_models": [
        {
          "name": "custom-model",
          "max_tokens": 128000
        }
      ]
    }
  }
}

Custom models will be listed in the model dropdown in the assistant panel.

Advanced configuration {#advanced-configuration}

Example Configuration

{
  "assistant": {
    "enabled": true,
    "default_model": {
      "provider": "zed.dev",
      "model": "claude-3-5-sonnet"
    },
    "version": "2",
    "button": true,
    "default_width": 480,
    "dock": "right"
  }
}

Custom endpoints {#custom-endpoint}

You can use a custom API endpoint for different providers, as long as it's compatible with the providers API structure.

To do so, add the following to your Zed settings.json:

{
  "language_models": {
    "some-provider": {
      "api_url": "http://localhost:11434/v1"
    }
  }
}

Where some-provider can be any of the following values: anthropic, google, ollama, openai.

Custom timeout {#provider-timeout}

You can customize the timeout that's used for LLM requests, by adding the following to your Zed settings.json:

{
  "language_models": {
    "some-provider": {
      "low_speed_timeout_in_seconds": 10
    }
  }
}

Where some-provider can be any of the following values: anthropic, copilot_chat, google, ollama, openai.

Configuring the default model {#default-model}

The default model can be set via the model dropdown in the assistant panel's top-right corner. Selecting a model saves it as the default. You can also manually edit the default_model object in your settings:

{
  "assistant": {
    "version": "2",
    "default_model": {
      "provider": "zed.dev",
      "model": "claude-3-5-sonnet"
    }
  }
}

Common Panel Settings