Installation

• Search for Unify Chat Provider in the VS Code Extension Marketplace and install it.
• Download the latest .vsix file from GitHub Releases, then install it in VS Code via Install from VSIX... or by dragging it into the Extensions view.

Quick Start

If the provider you want to add is in the Provider Support Table, use One-Click Configuration.

Otherwise, you can also manually configure any provider and model.

You might also be looking for:

• One-Click Migration: Migrate from other apps or extensions.
• Manage Providers: Unified management for all providers and models.
• Import and Export: Back up or export configurations to share with others.

⚠️ Avoid VS Code background tasks consuming Copilot quota VS Code currently uses utility models for some background tasks by default. If you use a free Copilot account, this may consume your Copilot quota. You need to set these to other models in settings.json yourself to avoid consuming Copilot quota, or use the quick settings interface provided by this extension. See Quick Set VS Code Default Model for details.

One-Click Configuration

See the Provider Support Table for providers supported by one-click configuration.

If your provider is not in the list, you can add it via Manual Configuration.

Steps:

1. Open the VS Code Command Palette and search for Unify Chat Provider: Add Provider From Well-Known Provider List.

2. Select the provider you want to add. 3. Follow the prompts to configure authentication (usually an API key, or it may require logging in via the browser), then you’ll be taken to the config import screen. - This screen lets you review and edit the config that will be imported. - For details, see the Provider Settings section.

1. Click Save to complete the import and start using the models in Copilot Chat.

Manual Configuration

This section uses DeepSeek as an example, adding the provider and two models.

DeepSeek supports One-Click Configuration. This section shows the manual setup for demonstration purposes.

0. Preparation: get the API information from the provider docs, at least the following: - API Format: The API format (e.g., OpenAI Chat Completions, Anthropic Messages). - API Base URL: The base URL of the API. - Authentication: Usually an API key; obtained from the user center or console after registration.

1. Open the VS Code Command Palette and search for Unify Chat Provider: Add Provider.

2. Fill in the provider name: Name. - The name must be unique and is shown in the model list. Here we use DeepSeek. - You can create multiple configs for the same provider with different names, e.g., DeepSeek-Person, DeepSeek-Team.

3. Choose the API format: API Format. - DeepSeek uses the OpenAI Chat Completion format, so select that. - To see all supported formats, refer to the API Format Support Table.

4. Set the base URL: API Base URL. - DeepSeek’s base URL is https://api.deepseek.com.

5. Configure authentication: Authentication. - DeepSeek uses API Key for authentication, so select API Key. - Enter the API key generated from the DeepSeek console.

1. Click Models to go to the model management screen.

7. Enable Auto-Fetch Official Models. - This example uses auto-fetch to reduce configuration steps; see Auto-Fetch Official Models for details. - For model fields and other ways to add models, see Manage Models.

1. Click Save to finish. You can now use the models in Copilot Chat.

Provider Settings

• Models: This button only appears while adding or importing a config; click it to enter the Model List screen.

This screen shows all configuration fields for the provider. For field details, see Provider Parameters.

Model Settings

• Export: Export this model config. See Import and Export.
• Duplicate: Clone this model config to create a new one.
• Delete: Delete this model config.

This screen shows all configuration fields for the model. For field details, see Model Parameters.

Sync Built-in Parameters to All Configs

Run Unify Chat Provider: Sync Built-in Parameters to All Configs to sync local model parameters with the built-in model parameters.

This is typically used after a new version updates or optimizes built-in model parameters, allowing you to sync existing configs in one click.

Global Settings

• Most unifyChatProvider.* settings are application-scoped and shared across profiles on the same device.
• Commit message generation settings are window-scoped and can be configured per workspace.

<details>

</details>

Proxy Configuration

Proxy settings can be configured globally through unifyChatProvider.networkSettings.proxy or per provider through unifyChatProvider.endpoints[].proxy. The effective order is:

1. Provider proxy
2. Global networkSettings.proxy
3. VS Code HTTP proxy settings

proxy.type supports:

• vscode (default): Use VS Code http.proxy, http.proxyAuthorization, http.proxyStrictSSL, and http.noProxy.
• direct: Connect directly and bypass VS Code/global proxy settings.
• custom: Use proxy.url; optional fields are authorization, strictSSL, and noProxy.

Supported custom proxy URL protocols are http, https, socks, socks4, socks4a, socks5, and socks5h. Proxy settings apply to provider HTTP requests, including chat requests, balance refreshes, and official model fetching.

Example global proxy:

{
  "unifyChatProvider.networkSettings": {
    "proxy": {
      "type": "custom",
      "url": "http://127.0.0.1:7890",
      "noProxy": ["localhost", "127.0.0.1", ".example.com"]
    }
  }
}

Example provider override:

{
  "unifyChatProvider.endpoints": [
    {
      "type": "openai",
      "name": "OpenAI Direct",
      "baseUrl": "https://api.openai.com",
      "proxy": {
        "type": "direct"
      },
      "models": ["gpt-5"]
    }
  ]
}

Override Config Fields

You can add query parameters to override certain fields in the imported config.

Example:

vscode://SmallMain.vscode-unify-chat-provider/import-config?config=<input>&auth={"method":"api-key","apiKey":"my-api-key"}

The import will override the auth field before importing.

API Format Support Table

<details>

</details>

Model List

• Add Model: Go to Add Model Manually.
• Add From Well-Known Model List: Go to One-Click Add Models.
• Add From Official Model List: Fetch the latest official model list via API. See One-Click Add Models.
• Import From Config: Import an existing model config (or an array of model configs). See Import and Export.
• Auto-Fetch Official Models: Enable or disable Auto-Fetch Official Models.
• Provider Settings: Go to Provider Settings.
• Export: Export this provider config or the model array config. See Import and Export.
• Duplicate: Clone this provider config to create a new one.
• Delete: Delete this provider config.

Quick Set VS Code Default Model

You can open the quick settings interface with the VS Code command Unify Chat Provider: Change VS Code Default Model.

The following settings can be changed quickly:

• ★ chat.utilityModel
• ★ chat.utilitySmallModel
• ★ chat.exploreAgent.defaultModel
• ★ github.copilot.chat.exploreAgent.model
• inlineChat.defaultModel
• chat.planAgent.defaultModel
• github.copilot.chat.askAgent.model
• github.copilot.chat.implementAgent.model

Items marked with ★ mean:

• By default, VS Code uses Copilot built-in models for these settings. These models do not consume premium quota on paid plans, but may consume free quota on free plans.
• It is recommended to set them to fast, inexpensive models.

You can select the Change All Built-in Utility Models button to update all ★ items at once.