canonical_url: https://yycode.net/docs/en/claude-desktop-configuration
lang: en
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/en/claude-desktop-configuration

# Claude Desktop Third-party Provider Configuration Guide

This tutorial shows you how to configure a third-party API Provider in the Claude Desktop client so it connects to different AI services, such as yycode, Kimi, and others, through a custom gateway.

## Prerequisites

Before you start, make sure:

1. Claude Desktop has been downloaded and installed
2. You have an API Key for the third-party service
3. You know the service's Gateway address (Base URL)

### Download Claude Desktop

Visit the official download page to get the latest version:

[Claude Desktop Download](https://code.claude.com/docs/en/desktop-quickstart)

![Claude Desktop download page](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423195403206.png)

## macOS Configuration Flow

### Step 1: Enable Developer Mode

1. Open the Claude Desktop client

   ![Claude Desktop main interface](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423195504200.png)

2. Click **Help** in the top menu bar, then select **Troubleshooting** -> **Enable Developer Mode**

   ![Enable Developer Mode](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423195705084.png)

3. In the confirmation dialog, click **Enable**. The app will restart automatically

   ![Confirm enabling Developer Mode](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423195751066.png)

### Step 2: Configure the Third-party Interface

1. After restart, enter the welcome screen and **do not log in yet**. Keep the client selected. The top menu bar will now show a **Developer** option

   ![Developer menu](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423200035068.png)

2. Click **Developer** -> **Configure Provider** to open the configuration panel

3. Fill in the third-party interface information. DragonCode is used as an example:

   ![Configure third-party interface](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423200226091.png)

   | Configuration item | Value |
      |--------|-----|
   | **Gateway base URL** | `https://yycode.net` |
   | **Gateway API key** | Your yycode API Key |

4. Click **Apply locally** in the bottom-right corner

5. In the confirmation dialog, choose **Relaunch now** to restart the app

   ![Restart confirmation](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423200724818.png)

6. After restart, click **Continue with gateway** to enter the main interface

   ![Continue with gateway](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423200842725.png)

### Interface Notes

After entering the main interface, you can use the following shortcuts to switch views:

| Shortcut | Function |
|--------|------|
| `Command + 1` | Cowork interface (default) |
| `Command + 2` | Coding interface |

### Functional Verification

After configuration, you can verify that the connection works through a simple conversation, such as asking which model is currently being used:

![Verify model connection](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423201548407.png)

### Plugins and Skills

If you have configured and enabled plugins or skills in Claude Code CLI, the Desktop client will automatically sync these configurations. You can also manually upload skill files in the Desktop client:

![Plugin and skill sync](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423201918419.png)

### Advanced Configuration

#### Configure Maximum Permissions

By default, Claude Desktop prompts for confirmation when performing sensitive actions. To disable confirmation prompts, you can set the highest permission level:

1. Click the **Cowork 3P \| Gateway** status area in the bottom-left corner, or press `Command + ,` to open settings

   ![Open settings](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423202005781.png)

2. Adjust the permission level in the settings panel

   ![Permission settings entry](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423202235722.png)

   ![Permission configuration details](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423202733059.png)

#### Keep Computer Awake

When running long tasks, it is recommended to enable **Keep computer awake** to prevent the computer from sleeping and interrupting the task:

![Keep computer awake](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423202511953.png)

> **Note**: This feature prevents the computer from entering standby. The display may still turn off automatically. However, **closing the laptop lid will still put the device to sleep**.

### Configure Multiple Providers

Claude Desktop supports configuring multiple third-party interfaces so you can switch between services:

1. Repeat the steps to enable Developer Mode
2. Go to **Developer** -> **Configure Provider**
3. Click the dropdown in the top-right corner (showing the current configuration name, such as `default`)
4. Select **New configuration** to create a new configuration

   ![Create new configuration](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423203331381.png)

5. Fill in the new Gateway address and API Key, such as Kimi's configuration information

   ![Configure Kimi](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423203535749.png)

6. After applying and restarting, you can freely switch between configured Providers

   ![Switch Provider](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423203608823.png)

## Windows Configuration Flow

The configuration logic on Windows is basically the same as macOS. Only the Developer Mode entry is different:

### Enable Developer Mode

1. Open Claude Desktop and go to the email input page on the welcome screen
2. Press `Tab` to switch focus until the menu icon in the top-left corner is selected
3. Press `Enter` to open the menu

   ![Windows menu entry](https://virusoss.oss-cn-shanghai.aliyuncs.com/1e3b6e4fdc12d7e76d9b0a7e6205a633a6070ca4.png)

4. Select **Developer** -> **Configure third-party interface**

   ![Windows Developer menu](https://virusoss.oss-cn-shanghai.aliyuncs.com/018a18e47414f8267efc2f166471d9a00744c93d_2_513x500.png)

### Configure Interface Information

Fill in the Gateway address and API Key, then click **Apply locally** and restart for the change to take effect:

![Windows configuration form](https://virusoss.oss-cn-shanghai.aliyuncs.com/image-20260423204249997.png)

## FAQ

| Question | Solution |
|------|---------|
| Cannot connect after configuration | Check whether the Gateway URL starts with `https://`, and whether the API Key is valid |
| Provider becomes invalid after switching | Make sure you clicked **Apply locally** and restarted the app |
| Insufficient permissions to execute commands | Set the permission level to the highest level in settings |

## Related Resources

- [Official Claude Desktop documentation](https://code.claude.com/docs/en/desktop-quickstart)
- [Claude Code CLI Configuration Guide](/docs/backend/ai/claude-code)