CC Switch Tutorial for Connecting Claude Desktop: Using Local Routing to Integrate OpenRouter and DeepSeek

CC Switch v3.15.0 added support for standalone Claude Desktop management. Its core value is not “just adding another shell,” but putting third-party inference configuration, model mapping, and local routing for Claude Desktop into one graphical control panel, reducing manual editing of config files, endpoint entry, and model ID setup. (If you are not yet familiar with the basic usage of CC Switch and the tools it supports, you can first read “What is CC Switch? A console for unified AI programming tools and model providers management”.)

Claude Desktop itself already provides a third-party inference entry point. The typical enablement path is: Help → Troubleshooting → Enable Developer Mode, then go to Developer → Configure third-party inference. The issue is that manual setup is not very user-friendly for beginners: you need to fill in Gateway URL, API Key, authentication method, model list, and other fields, and any one mistake can cause connection failure.

CC Switch makes these steps centralized in one tool. In particular, when you want to connect Claude Desktop to non-Claude-series models such as OpenRouter and DeepSeek, CC Switch’s “Model Mapping” and “Local Routing” features are very helpful.

1. What problem does it solve?

When connecting Claude Desktop to third-party providers, there are two main pain points:

1. Configuration entry is buried: You must first enable developer mode and then open the third-party inference settings window. 2. Model name compatibility issues: Claude Desktop usually interprets models by Claude roles, such as Sonnet, Opus, Haiku; but third-party platforms use their own model IDs, such as inclusionai/ring-2.6-1t, deepseek-v4-pro, deepseek-v4-flash.

CC Switch adds an adaptation layer in between:

Claude Desktop → CC Switch Local Route → Third-Party Provider

This layer mainly handles three things:

• Forward Claude Desktop requests to third-party providers;
• Map Claude model roles like Sonnet / Opus / Haiku to actual model IDs;
• Automatically write the required third-party inference configuration for Claude Desktop.

2. When must model mapping be enabled?

The rule is simple:

Both examples in this article are non-Claude-series models, so both must be enabled:

• “Model mapping required”
• “Local routing required”

As long as you use non-Claude-series models, local routing must keep running. If you close CC Switch or disable the routing switch, Claude Desktop will lose connection to third-party models.

3. Preparation

Prepare these three items first:

1. CC Switch v3.15.0 or later Official website: https://ccswitch.io

2. Claude Desktop Official download: https://claude.ai/download

3. Third-party provider account and API Key Pick one of the following:

• OpenRouter: https://openrouter.ai
• DeepSeek Platform: https://platform.deepseek.com

4. Install or upgrade CC Switch

If you already installed CC Switch, use auto-update.

For a fresh install, follow this:

## macOS
brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows users should download the .msi installer; Linux users should choose .deb, .rpm, or .AppImage by distribution.

After installation, open CC Switch. If the app switcher shows a standalone “Claude Desktop” entry listed beside “Claude Code,” it means you already have the version that supports Claude Desktop management.

5. Enter the Claude Desktop panel

In the app switcher on the left or top of CC Switch, select:

Claude Desktop

Then click “Add Provider,” select the platform you want to connect, and fill in the API Key and request URL.

Below are two common configuration examples.

6. Example A: OpenRouter + Ring 2.6 1T

OpenRouter is a model aggregation platform that allows access to multiple models through a unified entry point. It offers free models, pay-as-you-go plans, and enterprise options, making it suitable for testing different models or temporarily switching providers.

1. Create an OpenRouter API Key

Open OpenRouter:

https://openrouter.ai

Go to the Keys page to create an API Key:

https://openrouter.ai/keys

2. Add OpenRouter in CC Switch

In “Add Provider,” select the OpenRouter preset and fill in:

Note: It is recommended not to add a trailing / to the request URL.

3. Recommended model mapping setup

Ring 2.6 1T is not a Claude-series model, so map Claude Desktop roles to OpenRouter’s actual model IDs.

You can add three rows:

This means that no matter whether you select Sonnet, Opus, or Haiku in Claude Desktop, it will ultimately request inclusionai/ring-2.6-1t on OpenRouter.

7. Example B: DeepSeek Official V4

The DeepSeek official documentation provides an Anthropic-compatible interface, with base URL:

https://api.deepseek.com/anthropic

This means it can integrate with part of the Anthropic API ecosystem tools. DeepSeek documentation also provides environment-variable configuration examples for Claude Code, including model names such as deepseek-v4-pro[1m] and deepseek-v4-flash.

1. Create a DeepSeek API Key

Open DeepSeek Platform:

https://platform.deepseek.com

Go to the API Keys page and create a Key. DeepSeek usually requires topping up before calling the API.

2. Add DeepSeek in CC Switch

In “Add Provider,” choose the DeepSeek preset and fill in:

Note: This uses /anthropic, not /v1.

3. Recommended model mapping setup

Map by the principle of “use cheaper models for daily tasks and stronger models for complex tasks”:

So when you choose Sonnet in Claude Desktop, it will call the cheaper deepseek-v4-flash; when you choose Opus, it will call the stronger deepseek-v4-pro.

If you want to use the DeepSeek documentation’s 1M notation, you can try this in the actual request model:

deepseek-v4-pro[1m]

Whether it works depends on DeepSeek official documentation and the support in the current version of CC Switch.

8. Enable local routing

After model mapping is enabled, local routing must also be turned on.

The path is usually:

CC Switch → Settings → Routing

Two options must be turned on:

1. Routing master switch: State should show as running. 2. Claude app routing: Check Claude so Claude Desktop requests go through local routing.

The default service address is usually:

http://127.0.0.1:15721

Usually no modification is needed.

It is recommended to also enable “Show local routing switch on homepage,” so you can quickly confirm routing status on the main panel.

9. Enable the provider and restart Claude Desktop

After configuration is complete, select the provider you just added in the Claude Desktop panel and click “Enable.”

Then restart Claude Desktop.

Note that this must be a true quit, not just closing the window:

• macOS: Use Command + Q to fully exit.
• Windows: Find the Claude icon in the system tray and right-click to exit.

Reopen Claude Desktop and send a test message:

Hello, reply to me in one sentence.

If it responds normally, return to CC Switch and check the proxy traffic logs. If you can see request records, the connection path is working.

10. FAQ

1. How do I switch back to the official Claude account?

In the CC Switch Claude Desktop panel, disable the current third-party provider, or switch back to the official configuration, then restart Claude Desktop.

2. How do I switch between multiple providers?

In the Claude Desktop panel, select another provider, click Enable, and restart Claude Desktop. The local routing does not need to be changed repeatedly.

3. Can Claude Code be connected this way too?

Yes. CC Switch manages Claude Code and Claude Desktop in separate panels. The difference is that Claude Code is usually better for command-line development scenarios, while Claude Desktop is better for daily chat, content refinement, and desktop use.

DeepSeek official documentation also provides environment-variable configuration for Claude Code, such as setting ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, and ANTHROPIC_MODEL.

4. How should I troubleshoot errors?

Check these items first:

1. Whether the request URL has an extra trailing /; 2. Whether the API Key was copied completely; 3. Whether the API format is set to Anthropic Messages; 4. Whether “Requires model mapping” is turned on; 5. Whether the actual model IDs in model mapping are correct; 6. Whether the routing master switch is running; 7. Whether Claude app routing is checked; 8. Whether Claude Desktop is fully quit and restarted.

Most connection failures come down to API Key, endpoint URL, model ID, or local routing not being enabled.

5. Must CC Switch always stay open?

If you use non-Claude-series models and rely on model mapping, CC Switch must run in the background.

You can enable Lightweight Mode so only the tray process remains after closing the main window, while local routing continues to work.

11. When to use this approach?

My recommendation is:

• Daily writing and web content polishing: You can connect to higher cost-performance models on OpenRouter;
• Long-form Chinese writing, coding assistance, complex reasoning: Try DeepSeek V4 Pro;
• Low-cost testing: Prefer cheaper or free models first;
• Critical tasks: It is still recommended to switch back to official Claude, OpenAI, or other stable paid models.

The biggest strengths of third-party providers are flexibility and cost efficiency, but you also need to watch for stability, privacy, latency, and model capability differences. Do not bind all critical workflows to a single low-cost provider; keep fallback options.

12. Conclusion

The significance of CC Switch v3.15.0 is that it turns third-party model integration for Claude Desktop from “manual config entry” into “graphical provider switching.”

The core flow can be summarized in five steps:

Install CC Switch → Enter Claude Desktop panel → Add provider → Configure model mapping → Enable local routing and restart Claude Desktop

As long as you understand the two concepts of “model mapping” and “local routing,” non-Claude-series models like OpenRouter and DeepSeek can be integrated into Claude Desktop relatively smoothly.

References

• CC Switch Official Website
• Claude Desktop Official Download
• Claude Desktop third-party inference configuration documentation
• OpenRouter Official Website
• OpenRouter API Keys
• OpenRouter Pricing
• OpenRouter Models
• DeepSeek Platform
• DeepSeek Anthropic API Documentation
• DeepSeek Integration with Claude Code Documentation