This project provides a lightweight, GUI-based desktop tool for Windows and macOS that simplifies the configuration of third-party API providers within the official Claude Desktop client. It targets regular users seeking to easily integrate and switch between services like DeepSeek, Kimi, and Zhipu GLM, offering a user-friendly alternative to command-line tools and abstracting complex API setup.

How It Works

CC Desktop Switch operates as a local gateway, managing API requests from Claude Desktop and routing them to user-selected third-party LLM providers. It intelligently maps provider-specific model IDs to Claude-compatible route names, ensuring seamless integration. The tool centralizes API key management, protocol compatibility, and custom headers locally, presenting only explicitly mapped, Claude-safe model routes within the Claude Desktop interface for a controlled and predictable user experience.

Quick Start & Requirements

• Installation: Download and run the Windows installer (.exe) or portable package (.zip), or use the macOS installer (.pkg) or drag-and-drop package (.dmg) from the latest releases page.
• Prerequisites: Windows or macOS.
• Resource Footprint: Described as "lightweight."
• Links:
  • Releases: https://github.com/lonr-6/cc-desktop-switch/releases/latest
  • Fallback Local UI: http://127.0.0.1:18081
• Default Ports: Admin UI: 18081, Local Gateway: 18080.

Highlighted Details

• Supports management of DeepSeek, Kimi, Zhipu GLM, Alibaba Cloud Bailian, Xiaomi MiMo, and custom third-party providers.
• Enables one-click application of provider configurations and model mappings to Claude Desktop.
• Features preset setups with recommended API URLs and models, including support for 1M context windows for DeepSeek and Qwen.
• Includes provider connectivity checks, model availability verification, SSE streaming, and custom HTTP proxy support.
• Filters Claude Desktop's model menu to show only explicitly mapped routes, enhancing security and clarity.

Maintenance & Community

No specific details regarding maintainers, community channels (e.g., Discord, Slack), or project roadmap are provided in the README.

Licensing & Compatibility

The specific open-source license is not mentioned in the README. Compatibility for commercial use or linking with closed-source applications is not detailed.

Limitations & Caveats

Windows builds are not Authenticode-signed, potentially causing security warnings during installation. Users must fully restart Claude Desktop after applying configuration changes for them to take effect. Direct integration of GitHub Copilot subscriptions is not supported, requiring users to manage custom endpoints at their own risk.