YouTip

With the popularity of AI programming tools like Claude Code, OpenAI Codex, and Gemini CLI, developers often need to frequently switch between multiple API providers—official APIs, domestic mirrors, third-party proxies... Manually modifying configuration files each time is tedious and error-prone. CC Switch is a desktop tool designed to solve this pain point. It provides a unified graphical interface that allows you to: | Feature | Description | | --- | --- | | ? One-Click Provider Switch | Save multiple API configurations and switch with a single click without manually editing JSON | | ?️ Unified Multi-App Management | Manage five tools simultaneously: Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw | | ?️ Local API Proxy | Built-in high-performance HTTP proxy with automatic failover and request monitoring | | ? MCP Server Management | Visual add, edit, and sync MCP server configurations | | ? Usage Statistics | Real-time view of token consumption and API costs | | ? Backup and Restore | Automatic configuration backup to prevent data loss from accidental operations | ### Supported Applications * ? **Claude Code** (Anthropic) * ⚡ **Codex** (OpenAI) * ✨ **Gemini CLI** (Google) * ? **OpenCode** (Open Source) * ? **OpenClaw** (Fifth application, added in v3.11.0) * * * ## Installation Go to [GitHub Releases: https://github.com/farion1231/cc-switch/releases/latest](https://github.com/farion1231/cc-switch/releases/latest) to download the installation package for your platform. Scroll to the bottom of the page, find the resources section, and download the installation package for your platform: !(#) ### System Requirements | System | Minimum Version | Architecture | | --- | --- | --- | | Windows | Windows 10 and above | x64 | | macOS | macOS 10.15 (Catalina) and above | Intel (x64) / Apple Silicon (arm64) | | Linux | See table below | x64 / arm64 | ### Windows | File | Description | | --- | --- | | `CC-Switch-vX.X.X-Windows.msi` | ✅ **Recommended** — MSI installer with automatic update support | | `CC-Switch-vX.X.X-Windows-Portable.zip` | Portable version, extract and use, no registry writes | Double-click the MSI file and follow the wizard to complete the installation. Then search for "CC Switch" in the Start Menu to launch it. > ⚠️ The Windows version has the "One-Click Install" feature disabled to avoid protocol handler side effects. To install tools like Claude Code, please install them manually first, then manage them through CC Switch. ### macOS **Method 1: Direct Download (Recommended)** 1. Download `CC-Switch-vX.X.X-macOS.zip` 2. After extraction, drag `CC Switch.app` into the «Applications» folder 3. On first launch, right-click → Open, or go to «System Settings → Privacy & Security → Still Open» > ⚠️ Since the author doesn't have an Apple Developer account, macOS may display an "Unknown Developer" warning. After closing the prompt, go to «System Settings → Privacy & Security» and click «Still Open», after which it will launch normally every time. **Method 2: Homebrew** # Add tap and install brew tap farion1231/ccswitch brew install --cask cc-switch # Update brew upgrade --cask cc-switch ### Linux Choose the appropriate format based on your distribution: | Distribution | Recommended Format | Installation Command | | --- | --- | --- | | Ubuntu / Debian / Mint | `.deb` | `sudo apt install ./CC-Switch-*.deb` | | Fedora / RHEL / Rocky | `.rpm` | `sudo dnf install ./CC-Switch-*.rpm` | | openSUSE | `.rpm` | `sudo zypper install ./CC-Switch-*.rpm` | | Arch / Manjaro / Others | `.AppImage` | See below | AppImage usage: chmod +x CC-Switch-*.AppImage ./CC-Switch-*.AppImage * * * ## Quick Start After installation, follow these steps to complete the initial configuration: **Step 1: Launch CC Switch** On first launch, CC Switch will automatically detect installed CLI tools and attempt to import existing configurations. The CC Switch icon will appear in the system tray. **Step 2: Select Applications to Manage** The top of the main interface is the application switcher. Click the corresponding icon (Claude Code / Codex / Gemini CLI, etc.) to switch the currently managed application. You can hide applications you don't need in the settings. !(#) **Step 3: Add Your First Provider** Click the + button in the top-right corner, choose from built-in presets (such as official Anthropic API, DeepSeek, Alibaba Bailian, etc.), or manually fill in the following information: !(#) * **Name**: A descriptive remark for easy identification * **API Key**: The key provided by your service provider * **Base URL** (optional): Custom proxy address * **Model**: Specify the default model name to use * **API Format**: Anthropic Messages native format or OpenAI Chat Completions compatible format !(#) **Step 4: Switch Provider** Click the target Provider in the list, then click «Enable». CC Switch will automatically write the configuration to the corresponding CLI tool's configuration file: !(#) When you run the `claude` command directly in the terminal, it will use the new configuration. **Step 5: Verify Configuration (Optional)** Click the «Health Check» button next to the Provider to send a test request and verify the API Key and network connectivity. !(#) > ? Press `Cmd/Ctrl + ,` to quickly open settings; press `ESC` to close the current panel. * * * ## Advanced Features !(#) ### MCP Server Management In the «MCP» panel, you can visually add, edit, and delete MCP (Model Context Protocol) servers. Configurations are automatically synced to the corresponding CLI tools, and you can import existing MCP configurations from installed applications with one click. !(#) ### Skills Management Skills are prompt enhancement features for Claude Code. CC Switch supports: * Installing Skills from GitHub repositories (with built-in preset repositories like `baoyu-skills`) * Installing from local ZIP files * Managing Skills for Claude Code and Codex !(#) ### Session Manager On the «Sessions» page, you can browse historical conversation records for all five applications, with directory navigation and in-session search support, automatically filtered by the current application. !(#) ### Backup Management CC Switch automatically backs up the database periodically and also creates automatic backups before database migrations. In «Settings → Backup Management», you can: view all backups, rename, delete, and manually create backups. ### Usage Statistics and Billing The «Usage» page displays token consumption statistics, with support for auto-refresh, cache hit rate analysis, and cost breakdown by model and Provider to help you manage API expenses. ### Claude Rectifier (Thinking Signature Repair) When using certain third-party API gateways, Claude's thinking block format may be incompatible. After enabling Rectifier, the proxy layer will automatically fix this issue. You can toggle it in «Settings → Advanced». ### WebDAV Auto-Sync Supports syncing the database to WebDAV services (such asJianguoyun/Jianguoyun) to achieve configuration sharing across multiple devices. Built-in large file protection mechanism prevents accidental uploads.