Claude Desktop Integration Guide

Connect Claude Desktop to WOX models

Connecting Claude Desktop to WOX Models

1. Overview

This guide explains how to connect Claude Desktop to WOX models through CC-Switch. Once configured, Claude Desktop can route requests through CC-Switch to the WOX API gateway and use WOX text models for conversations or multimodal tasks.

2. Prerequisites

Before you begin, make sure you have:

• Claude Desktop installed.
• CC-Switch installed.
• A valid WOX API key.
• A network connection that can access the WOX API gateway.
• The name of the model you want to use.

This guide is based on CC-Switch v3.16.1.

Download Claude Desktop:

https://claude.com/download

Download CC-Switch:

https://github.com/farion1231/cc-switch/releases

3. Install Claude Desktop

Choose the appropriate installer for your operating system:

• Windows: .exe
• macOS: .dmg
• Linux: AppImage

After installation, open Claude Desktop.

4. Open CC-Switch

Launch CC-Switch and select the following option from the top navigation bar:

Claude Desktop

or:

ClaudeCode Desktop

This option configures the model proxy for Claude Desktop.

5. Add a New Provider

Click Add New Provider.

Select:

This indicates that you want to use a custom model provider.

6. Enter the API Key

In the API Key field, enter the API key you obtained from the WOX platform.

Example:

In most cases, you do not need to add the Bearer prefix manually.

7. Enter the Request URL

Enter the following request URL:

This URL forwards Claude Desktop requests to the WOX API gateway.

8. Enable Model Mapping

Enable model mapping.

This feature maps Claude model names in Claude Desktop to WOX models.

9. Select the API Format

For the API format, select:

OpenAI Chat Completions

This format is compatible with the WOX OpenAI-compatible API.

10. Fetch the Model List

Click Fetch Model List to verify that CC-Switch can connect to the WOX API gateway.

After the model list loads, select the models you want to map.

Recommended mapping example:

Sonnet  -> YOUR_MODEL_ID
Opus    -> YOUR_MODEL_ID
Haiku   -> YOUR_MODEL_ID

11. Save the Configuration

After confirming that the API key, request URL, API format, and model mapping are correct, click Save.

Once saved, the WOX configuration will appear in the provider list.

12. Enable CC-Switch Routing

Open the CC-Switch settings page and select:

Route

Enable the local routing switch, then enable Claude routing.

13. Verify the Configuration

Open Claude Desktop and start a test conversation.

If everything is configured correctly, Claude Desktop should return responses through the WOX model.

14. Troubleshooting

1. Claude Desktop Cannot Call the Model

Make sure CC-Switch local routing is enabled and Claude routing is turned on.

2. Unable to Fetch the Model List

Check that the API Base URL is correct:

Also confirm that your API key is valid.

3. Model Mapping Fails

Make sure model mapping is enabled and that the Claude models are mapped to WOX models.

Recommended model:

4. API Requests Fail

Check your network, firewall, proxy, or VPN settings.

5. Authentication Fails

Make sure the API key is correct and that your account has sufficient balance or credits.