CC Switch v3.10.2
CC Switch v3.10.2
Patch Release
This maintenance release adds skill sync options and includes important bug fixes.
Added
- Skills: Add skill sync method setting with symlink/copy options
- Partners: Add RightCode as official partner
Fixed
- Prompts: Clear prompt file when all prompts are disabled
- OpenCode: Preserve extra model fields during serialization
- Provider Form: Backfill model fields when editing Claude provider
CC Switch v3.10.1
Patch Release
This maintenance release includes important bug fixes for Windows platform, UI improvements, and code quality enhancements.
Added
- Provider Icons: Updated RightCode provider icon with improved visual design
Changed
- Proxy Rectifier: Changed rectifier default state to disabled for better stability
- Window Settings: Reordered window settings and updated default values for improved UX
- UI Layout: Increased app icon collapse threshold from 3 to 4 icons
- Code Quality: Simplified
RectifierConfigimplementation using#[derive(Default)]
Fixed
- Windows Platform:
- Fixed terminal window closing immediately after execution on Windows
- Corrected OpenCode config path resolution on Windows
- UI Improvements:
- Fixed ProviderIcon color validation to prevent black icons from appearing
- Unified layout padding across all panels for consistent spacing
- Fixed panel content alignment with header constraints
CC Switch v3.10.0
OpenCode Support, Global Proxy, Claude Rectifier & Multi-App Experience Enhancements
Overview
CC Switch v3.10.0 introduces OpenCode support, becoming the fourth managed CLI application. This release also brings global proxy settings, Claude Rectifier (thinking signature fixer), enhanced health checks, per-provider configuration, and many other important features, along with comprehensive improvements to multi-app workflows and terminal experience.
Release Date: 2026-01-21
Highlights
- OpenCode Support: Full management of providers, MCP servers, and Skills with auto-import on first launch
- Global Proxy: Configure a unified proxy for all outbound network requests
- Claude Rectifier: Thinking signature fixer for better compatibility with third-party APIs
- Enhanced Health Checks: Configurable prompts and CLI-compatible request format
- Per-Provider Config: Persistent provider-specific configuration support
- App Visibility Control: Freely show/hide apps with synchronized tray menu updates
- Terminal Improvements: Provider-specific terminal buttons, fnm path support, cross-platform safe launch
- WSL Tool Detection: Detect tool versions in WSL environment with security hardening
Main Features
OpenCode Support (New Fourth App)
- Complete OpenCode provider management: add, edit, switch, delete
- MCP server management: unified architecture with Claude/Codex/Gemini
- Skills support: OpenCode can also use Skills functionality
- Auto-import on first launch: automatically imports existing OpenCode configuration when detected
- Full internationalization: Chinese/English/Japanese support (#695)
Global Proxy
- Configure a unified proxy for all outbound network requests (#596, thanks @yovinchen)
- Supports HTTP/HTTPS proxy protocols
- Suitable for network environments requiring proxy access to external APIs
Claude Rectifier (Thinking Signature Fixer)
- Automatically fixes Claude API thinking signatures (#595, thanks @yovinchen)
- Resolves incompatible thinking block formats returned by some third-party API gateways
- Can be enabled/disabled in Advanced Settings
Enhanced Health Checks
- Configurable custom prompts for streaming health checks (#623, thanks @yovinchen)
- Supports CLI-compatible request format for better simulation of real usage scenarios
- Improves fault detection accuracy
Per-Provider Config
- Support for saving configuration separately for each provider (#663, thanks @yovinchen)
- Persistent configuration: provider-specific settings retained after restart
- Suitable for scenarios where different providers require different configurations
App Visibility Control
- Freely show/hide any app (Gemini hidden by default)
- Tray menu automatically syncs visibility settings
- Hidden apps won't appear in the main interface or tray menu
Takeover Compact Mode
- Automatically uses compact layout when 3 or more visible apps are displayed
- Optimizes space utilization in multi-app scenarios
Terminal Improvements
- Provider-specific terminal button: one-click to use current provider in terminal (#564, thanks @kkkman22)
fnmpath support: automatically recognizes Node.js paths managed by fnm- Cross-platform safe launch: improved terminal launch logic for Windows/macOS/Linux
WSL Tool Detection
- Detect tool versions in WSL environment (#627, thanks @yovinchen)
- Added security hardening to prevent command injection risks
Skills Preset Enhancements
- Added
baoyu-skillspreset repository - Automatically supplements missing default repositories for out-of-the-box experience
Experience Improvements
- Keyboard shortcuts: Press
ESCto quickly return/close panels (#670, thanks @xxk8) - Simplified proxy logs: cleaner and more readable output (#585, thanks @yovinchen)
- Pricing editor UX: unified
FullScreenPanelstyle - Advanced settings layout: Rectifier section moved below Failover for better logical flow
- OpenRouter compatibility mode: disabled by default, UI toggle hidden (reduces clutter)
Bug Fixes
Proxy & Failover
- Immediately switch to P1 when auto-failover is enabled (instead of waiting for next request)
Provider Management
- Fixed stale data when reopening provider edit dialog after save (#654, thanks @YangYongAn)
- Fixed baseUrl and apiKey state not resetting when switching presets
- Fixed endpoint auto-selection state not persisting (#611, thanks @yovinchen)
- Automatically apply default color when icon color is not set
Deep Links
- Support multi-endpoint import (#597, thanks @yovinchen)
- Prefer
GOOGLE_GEMINI_BASE_URLoverGEMINI_BASE_URL
MCP
- Skip
cmd /cwrapper for WSL target paths (#592, thanks @cxyfer)
Usage Templates
- Added variable hints, fixed validation issues (#628, thanks @YangYongAn)
- Prevent configuration leakage between providers
- Usage block offset automatically adapts to action button width (#613, thanks @yovinchen)
Gemini
- Convert timeout parameters to Gemini CLI format (#580, thanks @cxyfer)
UI
- Fixed Select dropdown rendering issues in
FullScreenPanel
Notes & Considerations
- OpenCode is a newly supported app: OpenCode CLI must be installed first to use related features.
- Global proxy affects all outbound requests: including usage queries, health checks, and other network operations.
- Rectifier is experimental: can be disabled in Advanced Settings if issues occur.
Special Thanks
Thanks to @yovinchen @YangYongAn @cxyfer @xxk8 @kkkman22 @Shuimo03 for their contributions to this release! Thanks to @libukai for designing the elegant failover-related UI!
Download & Installation
Visit Releases to download the appropriate version.
System Requirements
| System | Minimum Version | Architecture | | ------- | ------------------------------ | ----------------------------------- | | Windows | Windows 10 or later | x64 | | macOS | macOS 10.15 (Catalina) or later | Intel (x64) / Apple Silicon (arm64) | | Linux | See table below | x64 |
Windows
| File | Description |
| ---------------------------------------- | ---------------------------------------------------- |
| CC-Switch-v3.10.0-Windows.msi | Recommended - MSI installer with auto-update |
| CC-Switch-v3.10.0-Windows-Portable.zip | Portable version, extract and run, no registry write |
macOS
| File | Description |
| -------------------------------- | ------------------------------------------------------------------ |
| CC-Switch-v3.10.0-macOS.zip | Recommended - Extract and drag to Applications, Universal Binary |
| CC-Switch-v3.10.0-macOS.tar.gz | For Homebrew installation and auto-update |
Note: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" → "Privacy & Security" → click "Open Anyway", and it will open normally afterwards.
Homebrew (macOS)
brew tap farion1231/ccswitch
brew install --cask cc-switch
Update:
brew upgrade --cask cc-switch
Linux
| Distribution | Recommended Format | Installation Method |
| --------------------------------------- | ------------------ | ---------------------------------------------------------------------- |
| Ubuntu / Debian / Linux Mint / Pop!_OS | .deb | sudo dpkg -i CC-Switch-*.deb or sudo apt install ./CC-Switch-*.deb |
| Fedora / RHEL / CentOS / Rocky Linux | .rpm | sudo rpm -i CC-Switch-*.rpm or sudo dnf install ./CC-Switch-*.rpm |
| openSUSE | .rpm | sudo zypper install ./CC-Switch-*.rpm |
| Arch Linux / Manjaro | .AppImage | Add execute permission and run directly, or use AUR |
| Other distributions / Unsure | .AppImage | chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage |