farion1231_cc-switch/docs/release-note-v3.10.0-en.md

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)
• fnm path 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-skills preset repository
• Automatically supplements missing default repositories for out-of-the-box experience

---

Experience Improvements

• Keyboard shortcuts: Press ESC to quickly return/close panels (#670, thanks @xxk8)
• Simplified proxy logs: cleaner and more readable output (#585, thanks @yovinchen)
• Pricing editor UX: unified FullScreenPanel style
• 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_URL over GEMINI_BASE_URL

MCP

• Skip cmd /c wrapper 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