CC Switch Adds Claude Desktop Support for One-Click Third-Party AI Integration

AI Summary · From the Perspective of a Serial Entrepreneur (The following content is distilled by AI; views belong to the original author; you may skip the full article after reading this)

The CC Switch 3.15.0 release introduces a Claude Desktop panel, allowing non-official users to integrate third-party models such as DeepSeek, Kimi, and OpenAI into the Claude Desktop client. It supports both direct connection and model mapping modes, enabling synchronized import of Claude Code and Desktop configurations.

• Supports one-click import of provider configurations from Claude Code…
• Addresses the pain point of Claude Desktop only supporting official models…
• Provides a model mapping mechanism to disguise non-Claude models as Sonnet/Opus/Haiku interfaces

Key Takeaways

CC Switch 3.15.0 resolves the limitation that Claude Desktop only supports official models, allowing third-party models like DeepSeek, Kimi, OpenAI, and Gemini to be integrated into the official desktop client via either “direct connection” or “model mapping.” The key prerequisite is that model mapping mode requires local routing (127.0.0.1:15721) to be enabled, and the client must be fully restarted after any configuration changes (it does not support hot reloading).

Breakdown of the Two Integration Modes

• Direct Connection Mode (Recommended as the first choice): Suitable for providers natively compatible with the Anthropic Messages API (those exposing /v1/models with standardized model names). CC Switch directly points the Desktop configuration to the provider’s endpoint, eliminating the need for a persistent local gateway and minimizing performance overhead.
• Model Mapping Mode (Compatibility Solution): Suitable for non-Claude models (e.g., DeepSeek, Kimi). CC Switch acts as an intermediary gateway, translating requests for claude-sonnet/opus/haiku from Desktop into upstream models (e.g., kimi-k2) and their corresponding protocols (OpenAI/Gemini format). This mode requires enabling the “local routing” toggle.

Initial Setup Steps

Step 1: One-Click Import (Recommended)
Navigate to the CC Switch “Claude Desktop” panel → Click “Import existing providers from Claude Code.” The system will automatically migrate Claude Code’s configuration, and environment variables such as ANTHROPIC_DEFAULT_SONNET_MODEL will automatically convert into Desktop role mappings. After importing, carefully verify that the mappings for non-Claude models like Kimi and DeepSeek are correct.

Step 2: Configure Local Routing
Go to “Settings → Routing” and enable the “Show local routing toggle on the main page.” In the top-right corner of the Claude Desktop panel, confirm that local routing is turned on (address 127.0.0.1:15721). If another application has occupied the proxy port, free it up first.

Step 3: Restart to Apply Changes
Click “Enable” on the provider card, then fully quitClaude Desktop (exit via the system tray or ensure the process has ended), and relaunch to use third-party models.

Pitfall Avoidance Guide

• Restart, don’t just close the window:Claude Desktop does not hot-reload configurations; simply closing the chat window is ineffective. You must ensure the process terminates completely.
• MCP/Skills Do Not Sync:Claude Desktop manages its 3P profiles independently; MCP tools and services configured in CC Switch will not sync over, so they must be set up separately within Desktop.
• Linux Not Yet Supported:This feature currently only supports macOS and Windows; Linux users cannot write 3P configurations.

Model Mapping Configuration Example

Using Kimi as an example, you need to configure the mapping table as follows:

• Model Role:Sonnet (as the default primary model)
• Display Name in Menu:Kimi K2
• Actual Request Model:kimi-k2
• 1M Token:Check if the provider supports long context

Role Assignment Recommendations:Set Sonnet as the default primary model, use Opus for complex, high-difficulty tasks, and use Haiku for low-cost, fast scenarios. If your provider offers only one model, configuring just the Sonnet mapping is sufficient.

Original Article · ISLAND:Read Full Article →

Related Tool Recommendation (Promoted):GLM Coding Plan — AI Coding Powered by G…