CC Switch v3.12.1
Stability Fixes, StepFun Presets, OpenClaw authHeader, and New Sponsor Partners
Overview
CC Switch v3.12.1 is a patch release focused on stability improvements and bug fixes. It resolves a Common Config modal infinite reopen loop, a WebDAV sync foreign key constraint failure, and several i18n interpolation issues. It also adds StepFun provider presets, OpenClaw input type selection and authHeader support, upgrades the default Gemini model to 3.1-pro, and welcomes four new sponsor partners.
Release Date: 2026-03-12
Update Scale: 19 commits | 56 files changed | +1,429 / -396 lines
Highlights
- Common Config modal fix: Resolved an infinite reopen loop in the Common Config modal and added draft editing support
- WebDAV sync reliability: Fixed a foreign key constraint failure when restoring
provider_healthduring WebDAV sync - StepFun presets: Added StepFun (阶跃星辰) provider presets including the step-3.5-flash model
- OpenClaw enhancements: Added input type selection for model Advanced Options and
authHeaderfield for vendor-specific auth header support - Gemini model upgrade: Upgraded default Gemini model to 3.1-pro in provider presets
- New sponsors: Welcomed Micu API, XCodeAPI, SiliconFlow, and CTok as sponsor partners
New Features
StepFun Provider Presets
Added provider presets for StepFun (阶跃星辰), a leading Chinese AI model provider.
- New preset entries for StepFun across supported applications
- Includes the step-3.5-flash model (#1369, thanks @hengm3467)
OpenClaw Enhancements
Enhanced the OpenClaw configuration with more granular control and better vendor compatibility.
- Added input type selection dropdown for model Advanced Options (#1368, thanks @liuxxxu)
- Added optional
authHeaderboolean toOpenClawProviderConfigfor vendor-specific auth header support (e.g. Longcat), and refactored form state to reuse the shared type
Sponsor Partners
- Micu API: Added Micu API as sponsor partner with affiliate links
- XCodeAPI: Added XCodeAPI as sponsor partner
- SiliconFlow: Added SiliconFlow (硅基流动) as sponsor partner with affiliate links
- CTok: Added CTok as sponsor partner
Changes
- UCloud → Compshare: Renamed UCloud provider to Compshare (优云智算) with full i18n support across all three locales (EN/ZH/JA)
- Compshare Links: Updated Compshare sponsor registration links to coding-plan page
- Gemini Model Upgrade: Upgraded default Gemini model from 2.5-pro to 3.1-pro in provider presets
Bug Fixes
Common Config & UI
- Fixed an infinite reopen loop in the Common Config modal and added draft editing support to prevent data loss during edits
- Fixed toolbar compact mode not triggering on Windows due to left-side overflow (#1375, thanks @zuoliangyu)
- Fixed session search index not syncing with query data, causing stale list display after session deletion
Sync & Data
- Fixed foreign key constraint failure when restoring
provider_healthtable during WebDAV sync
Provider & Preset
- Added missing
authHeader: trueto Longcat provider preset (#1377, thanks @wavever) - Aligned OpenClaw tool permission profiles with upstream schema (#1355, thanks @bigsongeth)
- Corrected X-Code API URL from
www.x-code.cntox-code.cc
i18n & Localization
- Fixed stream check toast i18n interpolation keys not matching translation placeholders
- Fixed proxy startup toast not interpolating address and port values (#1399, thanks @Mason-mengze)
- Renamed OpenCode API format label from "OpenAI" to "OpenAI Responses" for accuracy
Special Thanks
Thanks to all contributors for their contributions to this release!
@hengm3467 @liuxxxu @bigsongeth @zuoliangyu @wavever @Mason-mengze
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.12.1-Windows.msi
| Recommended - MSI installer with auto-update |
CC-Switch-v3.12.1-Windows-Portable.zip
| Portable version, extract and run, no registry write |
macOS
| File | Description |
|---|---|
CC-Switch-v3.12.1-macOS.zip
| Recommended - Extract and drag to Applications, Universal Binary |
CC-Switch-v3.12.1-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-switchUpdate:
brew upgrade --cask cc-switchLinux
| 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
|